Skip to content

Commit e20b011

Browse files
committed
docs(changeset): C5 收敛的 changeset 补上与 #4664 placement 的区分说明 (#4653)
PR #4662 合并时,这段说明还在未提交状态(worktree 被清理时一并丢失), 故补一个 changeset-only 的跟进。无代码改动。 同窗口的 #4664 退休了 `app.contextSelectors[].placement`,而它的退休说明 里写着「`location` 曾是 `placement` 的别名」。Studio 插件的面板贡献点恰好 也有一个 `location` 键(`studio/PanelContribution.location`),两者在不同 schema 上、取值域不同、互不相关 —— 但对着 v17 release notes 逐条读的作者 很容易把两件事连起来,以为 `contributes.panels[].location` 也要改。 changeset 里主动写清这个区分,挡掉误解;同时记下另外四个退休键与 #4668 与 `activationEvents` 均无语义交叉。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01M9uWvoEp9CoLzYjNExj9sL
1 parent 65ca83a commit e20b011

1 file changed

Lines changed: 14 additions & 0 deletions

File tree

.changeset/converge-activation-event-schema.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,20 @@ enum 取**两侧 v17 前词表的并集**,共 9 个值:
7070

7171
手工迁移步骤:按上表把每个字符串改写成 `{ type, pattern }`**漏改会在 parse 处响亮失败** —— `StudioPluginManifestSchema``strictObject`,字符串遇到对象 schema 直接抛错,不存在静默吞掉或强制转换。
7272

73+
## 不要与同窗口的 #4509 / #4664 退休项混淆
74+
75+
v17 同窗口的 #4664 退休了五个键。其中 **`app.contextSelectors[].placement`** 与本条变更**毫无关系**,但很容易被读成有关系 —— 那条退休说明里写着「`location` 曾是 `placement` 的别名」,而 Studio 插件的面板贡献点**恰好也有一个 `location`**:
76+
77+
| |#4664 退休的 | 本次变更**未动**|
78+
|:--|:--|:--|
79+
|| `ui/App.contextSelectors[].placement`(`location` 是它的别名) | `studio/PanelContribution.location` |
80+
| 语义 | app 的上下文选择器渲染在哪(`sidebar_header` / `topbar`) | Studio 插件的辅助面板停靠在哪(`bottom` / `right` / `modal`) |
81+
| 状态 | 已删除 | **原样保留**,仍是可作者化键 |
82+
83+
两者在不同 schema 上、取值域不同、互不相关。写 Studio 插件的作者**不需要**因为 #4664 去动 `contributes.panels[].location`
84+
85+
其余四个退休键(`mapping.extractQuery` / `mapping.errorPolicy` / `mapping.batchSize` / `app.contextSelectors[].includeAll`)与 `activationEvents` 无任何语义交叉;同窗口的 #4668(ADR-0119 D2 migration journal)亦然。
86+
7387
## 其它影响
7488

7589
- `@objectstack/spec/studio` 现在**额外导出** `ActivationEvent` 类型(此前只有 schema),与 `./kernel` 指向同一份声明。

0 commit comments

Comments
 (0)