静态表面
服务端发出的是一份完整文档：页面标记、按宿主限定作用域的样式表，以及每个组件的内容——装在 Declarative Shadow DOM 模板（<template shadowrootmode="open">）里，或在组件声明 light root 时直接落在 DOM 中。浏览器原生解析这一切，因此在任何框架模块被拉取之前，页面已经可读、已样式化、可被抓取。
每个组件会被归入四个层级之一，层级决定服务端写入什么、客户端模块之后接管什么：
dsd-static——序列化为 DSD；永远不会有客户端模块加载它。dsd-interactive——序列化为 DSD；upgrade 时由编译后的 claim 绑定行为。light-dom——编译为 light root；没有 shadow 边界，文档样式直接生效。pure-island——浏览器专用；服务端只写宿主标签与序列化 props，渲染归客户端所有。
同一套分类也在构建期准入第三方元素（标准 Custom Elements、Lit、FAST、Stencil），并给出可操作的诊断，而不是放行一个渲染不出来的组件。
Hydration 边界
边界是声明的，不是被发现的。island 模块在所导出的组件旁用 defineIslandConfig({ hydrate, ssr, dsd }) 选择进入，构建会把结果逐页记录进 island manifest：每个页面一份 JSON 产物，包含路由以及每个 island 的标签、chunk URL、层级与策略。生成的客户端入口只 import 该页面声明的模块，因此页面的客户端图谱是其自身 metadata 的直接结果。
因为 manifest 与 HTML 一同产出，构建产物无需打开客户端 bundle 就能回答「这个页面加载哪些 JavaScript，什么时候加载」。
渐进式行为
claim 对已经存在的 DOM 重放编译后的 Part Program：模板声明过的处理器被绑定，@property 字段由宿主 attribute 填充，pure-island 首次渲染。未被触及的节点从不重渲染，没有按字符串查找的绑定发现，也不会从 data-* attribute 合成事件。
策略决定 chunk 何时被拉取——load、idle、visible 或 only。在它到达之前，元素保留服务端标记与样式：页面从不依赖任何 island 已经加载，而永远到不了的 island 除了自己的 chunk 之外不付出任何代价。
升级模型
island 是 openElement 中唯一的客户端 JavaScript 单元。公开模型是编译后的元素类：服务端序列化、新建 DOM 与已有 DOM 的 claim 共享同一份 Part Program。
openElement 使用浏览器的 Custom Element upgrade 机制。SSG 先写出 HTML，然后生成的客户端入口只导入当前页面用到的 island 模块并注册其编译类。
四个层次
第 1 层 — dsd-static — 无客户端 JavaScript
静态 Web Components 在 SSG 期间渲染为 DSD。即使没有任何客户端模块运行，它们也保持可见且样式完整。
第 2 层 — dsd-interactive — DSD 加编译 claim
服务端把 island 的编译 Part Program 序列化为 DSD。upgrade 时，生成的 claim 构件按同一份程序对照既有 DOM，并绑定模板声明的事件处理器——没有 binding 发现遍历，没有字符串方法查找，也没有 data-on-* 事件属性。
第 3 层 — pure-island — 客户端拥有的 shadow root
纯浏览器组件可以用 only 策略退出 SSR。服务端只输出宿主标签和序列化 props；渲染由客户端全权负责。
第 4 层 — light-dom — 无 shadow 边界
声明了 light root 的组件把内容渲染进 light DOM，没有 DSD 封装，因此文档级样式直接生效。编译默认值保持 shadow-open；light DOM 按组件选择进入。这类 island 仍适用 hydration 策略。
策略
load— 为首屏控件（如导航与主题）立即导入。idle— 在浏览器空闲时间为非关键交互组件导入。visible— 当 island 接近视口时导入。only— 对无法产出可靠 DSD 的纯浏览器组件跳过 SSR。
Props 不是事件
宿主属性与序列化 props 在 upgrade 时恢复到 island 的编译 @property 字段；claim 不会从中发明事件。事件只存在于编译模板显式声明处理器的位置。
动态内容
动态 island 内容来自编译模板内由 signal 驱动的 @property 状态。HTML 注入只保留在显式的 trustedHtml 边界之内，且仅用于已消毒、非交互的内容。
另见
- DSD 渲染——静态表面所依赖的平台契约。
- Islands 与 SSR——在应用中声明 island。