Skip to content

Commit 25875b5

Browse files
xuefei1313xuefei1313
committed
chore: lock browser alpha release readiness
Docs now point at the actual alpha branch head. The VChart follow-up stays on app-provider-first ownership. Rush change descriptions cover the changed alpha packages. Constraint: Browser alpha must not be called node-complete alpha. Rejected: Keep external-stage-first as VChart source target | wrong user model. Confidence: high Scope-risk: narrow Directive: Reopen browser gate only with fresh browser regression evidence. Tested: git diff --cached --check Not-tested: rush change --verify after commit; run next.
1 parent 4d17988 commit 25875b5

15 files changed

Lines changed: 130 additions & 29 deletions

‎common/changes/@visactor/react-vrender-utils/remerge-d3_2026-04-24-07-37.json‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
{
2+
"changes": [
3+
{
4+
"comment": "Prepare browser alpha app-scoped runtime verification.",
5+
"type": "none",
6+
"packageName": "@visactor/react-vrender-utils"
7+
}
8+
],
9+
"packageName": "@visactor/react-vrender-utils",
10+
"email": "lixuef1313@163.com"
11+
}

‎common/changes/@visactor/react-vrender/remerge-d3_2026-04-24-07-37.json‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
{
2+
"changes": [
3+
{
4+
"comment": "Prepare browser alpha app-scoped runtime verification.",
5+
"type": "none",
6+
"packageName": "@visactor/react-vrender"
7+
}
8+
],
9+
"packageName": "@visactor/react-vrender",
10+
"email": "lixuef1313@163.com"
11+
}

‎common/changes/@visactor/vrender-animate/remerge-d3_2026-04-24-07-37.json‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
{
2+
"changes": [
3+
{
4+
"comment": "Prepare browser alpha app-scoped runtime verification.",
5+
"type": "none",
6+
"packageName": "@visactor/vrender-animate"
7+
}
8+
],
9+
"packageName": "@visactor/vrender-animate",
10+
"email": "lixuef1313@163.com"
11+
}

‎common/changes/@visactor/vrender-components/remerge-d3_2026-04-24-07-37.json‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
{
2+
"changes": [
3+
{
4+
"comment": "Prepare browser alpha app-scoped runtime verification.",
5+
"type": "none",
6+
"packageName": "@visactor/vrender-components"
7+
}
8+
],
9+
"packageName": "@visactor/vrender-components",
10+
"email": "lixuef1313@163.com"
11+
}

‎common/changes/@visactor/vrender-core/remerge-d3_2026-04-24-07-37.json‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
{
2+
"changes": [
3+
{
4+
"comment": "Prepare browser alpha app-scoped runtime verification.",
5+
"type": "none",
6+
"packageName": "@visactor/vrender-core"
7+
}
8+
],
9+
"packageName": "@visactor/vrender-core",
10+
"email": "lixuef1313@163.com"
11+
}

‎common/changes/@visactor/vrender-kits/remerge-d3_2026-04-24-07-37.json‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
{
2+
"changes": [
3+
{
4+
"comment": "Prepare browser alpha app-scoped runtime verification.",
5+
"type": "none",
6+
"packageName": "@visactor/vrender-kits"
7+
}
8+
],
9+
"packageName": "@visactor/vrender-kits",
10+
"email": "lixuef1313@163.com"
11+
}

‎common/changes/@visactor/vrender/remerge-d3_2026-04-24-07-37.json‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
{
2+
"changes": [
3+
{
4+
"comment": "Prepare browser alpha app-scoped runtime verification.",
5+
"type": "none",
6+
"packageName": "@visactor/vrender"
7+
}
8+
],
9+
"packageName": "@visactor/vrender",
10+
"email": "lixuef1313@163.com"
11+
}

‎docs/refactor/state-engine/D3_ALPHA_COORDINATION.md‎

Lines changed: 31 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -26,8 +26,9 @@
2626
1. browser binding / installer root-cause 已完成 consumer-side re-check
2727
2. full-link browser 功能回归已通过
2828
3. `textHeavy` mixed scene recreate 性能回归已完成双边验证并从 browser alpha gate 中移除
29-
4. 推荐 app-scoped 入口的真实上层接入验证已在 `external-stage-first` 路径完成 fresh rerun
29+
4. app-scoped 入口的真实上层接入验证已在 external-stage 路径完成 fresh rerun
3030
5. 上层接入体验审查与“多环境一等支持”治理任务已完成，当前推荐接入契约已足够支撑 browser alpha 验证
31+
6. root app creator public typing 已修正为返回 `IApp`，可被上层 TypeScript 代码直接消费
3132

3233
---
3334

@@ -109,7 +110,7 @@ first round snapshot：
109110

110111
### 3.5 Latest VRender delivery
111112

112-
`VRender agent` 最新有效提交：
113+
`VRender agent` 最新 runtime 修复提交：
113114

114115
- `9b6508ea70ac223be87a2e86608ebcb3db49d1cf`
115116

@@ -129,9 +130,20 @@ first round snapshot：
129130
- perf recreate longTasks: `1 -> 0`
130131
- `basicBar / basicLine / textHeavy` 仍均为 `firstFrame: true`
131132

132-
### 3.6 App-scoped external-stage-first validation
133+
当前待发布分支最新提交：
133134

134-
当前 fresh 证据表明，`external-stage-first` 的推荐 app-scoped 接入路径已经在 consumer 侧完成 rerun：
135+
- `4d1798865`
136+
137+
该提交在 `9b6508...` 的 runtime 修复之后补齐 root app creator 的 public typing：
138+
139+
- `createBrowserVRenderApp(options?): IApp`
140+
- `createNodeVRenderApp(options?): IApp`
141+
- 新增 source-level type test 与 build artifact typing check
142+
- 不改变 browser runtime gate 判断，只收口上层 TypeScript 接入面
143+
144+
### 3.6 App-scoped external-stage validation
145+
146+
当前 fresh 证据表明，external-stage app-scoped 接入路径已经在 consumer 侧完成 rerun：
135147

136148
- `createBrowserVRenderApp()`: 可用
137149
- `app.createStage()`: 可用
@@ -146,7 +158,9 @@ first round snapshot：
146158

147159
结论边界：
148160

149-
- 推荐 app-scoped 入口在 `external-stage-first` 路径上已经具备真实上层验证证据
161+
- external-stage 路径已经具备真实上层验证证据
162+
- 这条路径是 advanced borrowed-stage path，不是最终普通用户推荐主链
163+
- 最终普通用户推荐主链应是 app-provider-first / VChart-created-stage
150164
- 这不等于已经完成 full internal migration
151165

152166
### 3.7 Root-only browser smoke
@@ -175,7 +189,8 @@ first round snapshot：
175189
| 默认 browser env / picker 安装链过宽 | `VRender-side` | 已完成 consumer-side re-check，canonical rerun 中不再出现 `installNodeEnvToApp` / `Arc3dRender` / `Pyramid3dRender` / `StarRender`，且 `basicBar / basicLine / textHeavy` 已拿到 `firstFrame: true` |
176190
| `VChart` full-link browser 功能回归 | `cross-repo integration` | 已通过，三个场景 `init / update / recreate / interaction` 正常 |
177191
| `textHeavy` mixed scene recreate 性能回归 | `VRender-side` | 已完成 consumer-side perf re-check，`functional recreate` 回到 `57.71ms`，`perf recreate median` 回到 `45.96ms`，且 `recreate longTasks` 消失 |
178-
| 推荐 app-scoped external-stage-first 接入验证 | `cross-repo integration` | 已完成 consumer-side fresh rerun，`createBrowserVRenderApp() + app.createStage() + { stage }` 路径稳定成立 |
192+
| app-scoped external-stage 接入验证 | `cross-repo integration` | 已完成 consumer-side fresh rerun，`createBrowserVRenderApp() + app.createStage() + { stage }` 路径稳定成立 |
193+
| root app creator public typing | `VRender-side` | 已补齐，`createBrowserVRenderApp()` / `createNodeVRenderApp()` 的 public typing 已返回 `IApp` |
179194

180195
---
181196

@@ -186,10 +201,10 @@ first round snapshot：
186201
| Item | Owner | 当前状态 | 说明 |
187202
| --- | --- | --- | --- |
188203
| `createNodeVRenderApp().createStage()` node runtime 未转绿 | `VRender-side` | open | `createWindow` 为空导致 node runtime 失败；这是 node lane，不属于当前 browser gate |
189-
| `VChart` source-level external-stage-first 对齐尚未正式落仓 | `cross-repo integration` | follow-up | 当前已有 consumer harness 证据；下一步应按 `D3_VCHART_APP_SCOPED_ALIGNMENT_PLAN.md` 推进源码对齐 |
190-
| 是否继续做 full internal migration | `cross-repo integration` | follow-up | 当前不作为 alpha 先决条件，应在 external-stage-first 稳定后再决定 |
204+
| `VChart` app-provider-first / VChart-created-stage 源码级对齐尚未正式落仓 | `cross-repo integration` | follow-up | 当前已有 external-stage consumer harness 证据；下一步应按 `D3_VCHART_APP_SCOPED_ALIGNMENT_PLAN.md` 推进源码对齐 |
205+
| 是否继续做 full internal migration | `cross-repo integration` | follow-up | 当前不作为 alpha 先决条件，应在 app-provider-first 源码级路径稳定后再决定 |
191206
| 真实上层 `text stateProxy` 路径未覆盖 | `cross-repo integration` | follow-up | 当前只覆盖到非 text `stateProxy` |
192-
| 外部传入 stage 的更完整 ownership 约束与治理沉淀 | `VChart-side` | follow-up | 当前 external-stage-first 路径已可用，但源码侧契约治理仍建议继续落档 |
207+
| 外部传入 stage 的更完整 ownership 约束与治理沉淀 | `VChart-side` | follow-up | 当前 external-stage 路径已可用，但源码侧契约治理仍建议继续落档 |
193208

194209
---
195210

@@ -198,7 +213,8 @@ first round snapshot：
198213
### 6.1 Latest from VRender agent
199214

200215
- 仓库：`/Users/bytedance/Documents/GitHub/VRender2`
201-
- 最新有效提交：`9b6508ea70ac223be87a2e86608ebcb3db49d1cf`
216+
- 最新 runtime 修复提交：`9b6508ea70ac223be87a2e86608ebcb3db49d1cf`
217+
- 当前待发布分支最新提交：`4d1798865`
202218
- 最新交付内容：
203219
- 将 `AbstractComponent` 的 `onSetStage` 收成 attach-only
204220
- detach 路径不再触发组件 `render() + bindEvents()`
@@ -213,7 +229,8 @@ first round snapshot：
213229
- browser binding / installer 根因已通过
214230
- browser functional lane 已通过
215231
- browser perf lane 已通过
216-
- `external-stage-first` app-scoped fresh rerun 已通过
232+
- external-stage app-scoped fresh rerun 已通过
233+
- app-provider-first / VChart-created-stage 源码级对齐仍是 post-alpha P0
217234
- 当前 browser alpha gate 已无新的 blocker
218235
- 当前下一步：
219236
- 如需要继续推进，按 `D3_VCHART_APP_SCOPED_ALIGNMENT_PLAN.md` 做 source-level alignment，而不是重新验证 gate
@@ -237,7 +254,7 @@ first round snapshot：
237254

238255
当前最短路径只有 2 步：
239256

240-
1. 按 `D3_VCHART_APP_SCOPED_ALIGNMENT_PLAN.md` 推进 `VChart` 的 source-level external-stage-first 对齐
257+
1. 按 `D3_VCHART_APP_SCOPED_ALIGNMENT_PLAN.md` 推进 `VChart` 的 app-provider-first / VChart-created-stage 源码级对齐
241258
2. 如对齐过程中再次出现 `VRender-side` 问题，再由 `VRender agent` 接手收口
242259

243260
browser alpha 发布后的完整收尾优先级看：
@@ -262,7 +279,8 @@ browser alpha 发布后的完整收尾优先级看：
262279
- 默认 browser env / picker 安装链过宽这条 root cause，已经在 consumer-side re-check 中通过
263280
- `VChart` full-link browser 功能回归已通过
264281
- `textHeavy` recreate perf blocker 已完成 consumer-side re-check，可从 browser alpha gate 中移除
265-
- 推荐 app-scoped `external-stage-first` 真实上层接入验证已完成 fresh rerun
282+
- app-scoped external-stage 真实上层接入验证已完成 fresh rerun
283+
- root app creator public typing 已补齐，上层 TypeScript 调用方不需要退回 `any/cast`
266284
- 因此当前 **browser alpha gate 已关闭**
267285

268286
当前协调口径：

‎docs/refactor/state-engine/D3_FOLLOWUPS.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -123,17 +123,17 @@
123123
- 当前状态：open
124124
- 说明：`createNodeVRenderApp().createStage()` 仍未转绿。这是 node lane，不属于当前 browser alpha gate。
125125

126-
### F-Alpha-02 VChart source-level external-stage-first alignment
126+
### F-Alpha-02 VChart app-provider-first source-level alignment
127127

128128
- Owner: `cross-repo integration`
129129
- 当前状态：follow-up
130-
- 说明：`createBrowserVRenderApp() + app.createStage() + { stage }` 的 consumer-side 路径已完成 fresh rerun 并成立；下一步应按 `D3_VCHART_APP_SCOPED_ALIGNMENT_PLAN.md` 推进源码级 external-stage-first 对齐。
130+
- 说明：`createBrowserVRenderApp() + app.createStage() + { stage }` 的 consumer-side external-stage 路径已完成 fresh rerun 并成立；下一步应按 `D3_VCHART_APP_SCOPED_ALIGNMENT_PLAN.md` 推进 app-provider-first / VChart-created-stage 源码级对齐。
131131

132132
### F-Alpha-03 full internal migration decision
133133

134134
- Owner: `cross-repo integration`
135135
- 当前状态：follow-up
136-
- 说明：当前不作为 alpha 先决条件。应在 external-stage-first 稳定后，再决定是否继续做 full internal migration。
136+
- 说明：当前不作为 alpha 先决条件。应在 app-provider-first 源码级路径稳定后，再决定是否继续做 full internal migration。
137137

138138
### F-Alpha-04 text stateProxy real-path coverage
139139

@@ -145,4 +145,4 @@
145145

146146
- Owner: `VChart-side`
147147
- 当前状态：follow-up
148-
- 说明：external-stage-first 路径已可用，但源码侧 ownership 契约与治理沉淀仍建议继续收口，不再作为当前 browser alpha gate blocker。
148+
- 说明：external-stage 路径已可用，但源码侧 ownership 契约与治理沉淀仍建议继续收口，不再作为当前 browser alpha gate blocker。

‎docs/refactor/state-engine/D3_MULTI_ENV_ON_DEMAND_GOVERNANCE.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@
1818
3. 非 browser/node 环境能力仍在，但不再默认描述成已经进入对等 app-scoped 一等契约
1919
4. fine-grained on-demand 能力仍在，但不再描述成已由 root app creator 等价承接
2020
5. root app creator 的 public typing 已修正为返回 `IApp`
21-
6. `external-stage-first` 的 consumer-side app-scoped 验证已通过
21+
6. external-stage consumer-side app-scoped 验证已通过；普通用户主链仍应推进 app-provider-first / VChart-created-stage
2222

2323
后续如果继续治理，应按 [D3_POST_ALPHA_WRAPUP_PLAN.md](/Users/bytedance/Documents/GitHub/VRender2/docs/refactor/state-engine/D3_POST_ALPHA_WRAPUP_PLAN.md) 中的 P1 support matrix 项推进，不再把它作为 browser alpha gate blocker。
2424

0 commit comments

Comments
 (0)