跳到主要内容

ARC 2.0.0-beta.28 · AUP Web-only widget

blocklet-embed

AUP Web-only widget `blocklet-embed`：用途、边界、表面、fallback 与证据。

这是 AUP Web-only widget，不是 cross-device primitive，也不是 Web Device layout component。

该名称登记在 AUP_WIDGETS（packages/aup/src/aup-types.ts）。结构校验可以接受它，Web runtime（或注明的原生目标）可以实现它。它不是 18 个跨设备 AUP_PRIMITIVES 之一，不会经 fillPrimitives 进入 DeviceCaps.primitives，也不是 Web Device 主题/站点 layout component（例如 content-card 或 page-breadcrumb）。

用途

将另一个 blocklet 的页面树嵌入宿主树。由 portal-setup / expandTree 在服务端展开；失败必须可见（禁止空白）。

边界

  • 不要把该类型写成可移植 primitive。
  • 不要与 Web Device layout-component 参考页混装在 widgets/ 下。
  • parser 接受名称 ≠ 可移植性或产品就绪声明。

作者入口

AUP tree type: "blocklet-embed"，带目标 blocklet 标识。不是 layout-component。

表面

服务端展开后的交互 Web session。未展开时客户端看到 unknown type。

Fallback

展开错误节点（可见）。无共享 degradation chain。

证据

SourcePath
Registrationpackages/aup/src/aup-types.ts
Expansionproviders/runtime/ui/src/portal-setup.ts (blocklet-embed expand path)
Path safetyproviders/runtime/ui/src/path-safety.ts
Testsproviders/runtime/ui/test/blocklet-embed*.test.ts

路径相对于本文档基线所用的 Arc 仓库 checkout。

Sample

不适合作为 docs sample。 副作用、写入路径、仅原生表面或信任敏感 endpoint 使公开 sample 不合适。本页仅作边界与证据索引。

相关