docs(canvas): explain registry contracts and editor publication flow

This commit is contained in:
2026-11-11 23:41:13 +08:00
parent aaeb5acf6e
commit afa30d4b35
8 changed files with 188 additions and 3 deletions
+8
View File
@@ -1,3 +1,9 @@
/**
* headless core 的公共入口,供宿主装配模型、registry、editor、gesture、查询及复制规划。
* 这里只重导出 API,不创建 editor 实例,不读取浏览器状态,也不启动网络任务。
* runtime/browser/service/React bindings 各有独立入口,避免纯内核消费方被迫加载框架。
*/
// 共享合同与通用值操作是基础层;后续导出在同一组 ID/Change/Document 类型上组合。
export * from './types.ts';
export {fault,reject,freeze,clone,equal,readMap,readSet,validJson} from './values.ts';
export * from './document.ts';
@@ -9,11 +15,13 @@ export * from './coordinates.ts';
export * from './structure.ts';
export * from './units.ts';
export * from './history-transition.ts';
// 同步/分片复制和可恢复 planner 共用产品规则;检查点只保存规划进度,不是第二份业务文档。
export {planDuplicate,planDuplicateSteps,remapCopyData} from './duplicate.ts';
export type {DuplicatePlan,DuplicateOptions} from './duplicate.ts';
export {createDuplicatePlanner,validateDuplicateCheckpoint} from './duplicate-checkpoint.ts';
export type {DuplicateCheckpoint} from './duplicate-checkpoint.ts';
// 查询按不可变文档快照绑定;更新 API 用于沿发布变化推进关系与空间索引。
export {createDocumentQueries,advanceDocumentQueries} from './queries.ts';
export type {DocumentQueries,Bounds,QueryBudget,QueryCoverage,ElementLookup,IdQueryResult} from './queries.ts';