npm - @ptengine/lp-editor-core - Versions diffs - 1.0.0-alpha.0 - Mend

@ptengine/lp-editor-core 1.0.0-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/LICENSE +3 -0
package/README.md +84 -0
package/dist/golden/manifest.json +173 -0
package/dist/index.d.ts +678 -0
package/dist/index.js +1426 -0
package/dist/index.js.map +1 -0
package/package.json +62 -0

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,678 @@
+/**
+ * 片段解析：EditOp 的 `insert.html` / `replace.html` 从字符串变成节点的唯一入口。
+ *
+ * 不需要注入解析器 —— 用目标文档自己的 `<template>` 就够，而且这是**唯一**能
+ * 正确处理上下文相关元素的通用做法：HTML5 的 "in template" 插入模式对
+ * `<tr>` / `<td>` / `<col>` / `<li>` / `<option>` 会各自切到正确的表格 / 列表模式，
+ * 元素不会被丢弃。所以不需要额外的 contextEl 参数，一个容器覆盖全部上下文。
+ *
+ * ⚠️ `template.content` 里的节点属于**模板内容所有者文档**，不是 `doc`。
+ * 插入时由 DOM 的 pre-insert 自动 adopt，所以最终没问题；但在插入**之前**
+ * `node.ownerDocument !== doc`，任何「同文档」断言都会误判。
+ *
+ * 这里是全包唯一允许写 innerHTML 的地方（见 eslint.config.js）：写是解析，
+ * 与「禁读 outerHTML」要防的事情无关。
+ */
+declare function parseFragment(doc: Document, html: string): DocumentFragment;
+/** 片段里的元素子节点（跳过纯空白文本），供单根校验使用。 */
+declare function fragmentElementRoots(fragment: DocumentFragment): Element[];
+/**
+ * 规范序列化（canonical serializer）。
+ *
+ * 目标：同一棵 DOM 树（由任何符合 HTML5 规范的树构造器产出），无论宿主是浏览器
+ * 原生 DOM 还是 jsdom，都序列化成**逐字节相同**的字符串。这是「编辑器 apply ==
+ * mastra apply」那条不变量的落点。
+ *
+ * 约束：
+ *   - 纯函数，无副作用、无 I/O
+ *   - 只依赖标准 DOM 读 API，同一份实现在浏览器与 Node 两侧跑
+ *   - 绝不使用 innerHTML / outerHTML —— 它们本身就是分歧的来源
+ *
+ * 规范规则（全部写死，不提供选项）：
+ *   R1  标签名        HTML 命名空间元素小写；外来元素（SVG / MathML）保留
+ *                     解析器调整后的 localName（foreignObject、clipPath…）
+ *   R2  属性顺序      按限定名排序，UTF-16 码元序
+ *   R3  属性引号      一律 name="value"，双引号，永远带引号
+ *   R4  文本转义      & < >   -> &amp; &lt; &gt;
+ *   R5  属性值转义    & < > " -> &amp; &lt; &gt; &quot;
+ *   R6  空元素        <br> —— 不带结尾斜杠、不带闭合标签
+ *   R7  pre/textarea/listing 空白原样保留；紧随起始标签的换行重新发出
+ *                     （解析器会吃掉一个），保证再解析回同一棵树
+ *   R8  注释          原样 <!--data-->
+ *   R9  doctype       规范化；无 id 的 html -> <!DOCTYPE html>
+ *   R10 布尔/空属性   统一一种形态：disabled=""、alt=""
+ *   R11 raw text      script/style/xmp/iframe/noembed/noframes/plaintext
+ *                     的字符数据原样输出，不转义
+ *   R12 template      经其 .content 片段序列化
+ *   R13 回车          U+000D 在文本与属性值里输出为 &#13;，使输出可往返
+ *   R14 class 值      按空白切分后**去重**、单空格拼接，**不重排顺序**
+ *
+ * R13 与 R14 是相对 WHATWG 序列化器的**增补**，不是放宽：
+ *   - R13：词法分析器在建树前把 CR / CRLF 归一成 LF，不转义的 CR 会在下一次解析时
+ *     静默变成 LF。原生 outerHTML 在所有引擎上都有这个毛病。
+ *   - R14：两侧按同一组 op 应用会得到同样的插入顺序，所以顺序天然确定、不需要排序；
+ *     但源数据里的 `class="a  b a"` 这类写法会让字节不同。去重 + 折叠空白把它收敛掉。
+ *     **有意不排序** —— 排序会把作者写的顺序变成非作者的，而 `md:` 与基线的相对位置
+ *     在读源码时是有意义的。
+ */
+/**
+ * R14：class 值去重 + 折叠空白，保持首次出现的顺序。
+ * 导出是因为 EditOp 的 class 增删也要用同一份规则，否则「写进去的」与
+ * 「序列化出来的」会是两套。
+ */
+declare function normalizeClassValue(value: string): string;
+/**
+ * 把 Document、DocumentFragment、Element 或 DocumentType 序列化成规范 HTML。
+ *
+ * 片段（DocumentFragment）与元素都走同一条路径 —— 片段序列化其全部子节点，
+ * 所以 `serialize(parseFragment(doc, html))` 是幂等可比对的。
+ */
+declare function serialize(node: Node): string;
+interface NormalizeOptions {
+    /**
+     * id 前缀。默认 `e`。
+     * 有意不暴露「随机」开关：同一份输入必须得到同一份输出，否则 normalize 自己
+     * 就成了两侧分叉的来源。
+     */
+    prefix?: string;
+}
+/**
+ * 按文档序补齐缺失的 id。返回被修改的元素个数（0 表示本来就规范）。
+ */
+declare function normalize(root: Document | DocumentFragment | Element, options?: NormalizeOptions): number;
+/**
+ * 错误码与校验条目的形状。
+ *
+ * core **只出结构，不出文案**。文案由各消费端渲染：编辑器用 lp-editor 的三语字典，
+ * iam 发布拒绝按 `rule` 出后端文案，mastra 回给模型的结构化报错复用同一枚举。
+ * 三处各一份措辞，但没有两份真源 —— 这也是 core 能作为公开包发布的前提之一。
+ */
+declare const ERROR_CODES: readonly ["FORMAT_MISSING", "ID_DUPLICATE", "ID_CONFLICT", "ID_FORMAT", "ID_NOT_FOUND", "SCRIPT_FORBIDDEN", "INLINE_STYLE", "NATIVE_PALETTE", "CLASS_UNCOMPILABLE", "VARIANT_FORBIDDEN", "STRUCTURE", "MULTI_ROOT", "REPLACE_ID_CHANGED", "STALE_BASE_VERSION", "FRAGMENT_NOT_CANONICAL", "PLACEHOLDER_UNRESOLVED"];
+type ErrorCode = (typeof ERROR_CODES)[number];
+declare function isErrorCode(value: unknown): value is ErrorCode;
+/** 校验条目。**不带 message** —— 文案归消费端。 */
+interface Issue {
+    /** 相关元素的 data-pt-id；文档级问题（如缺格式标记）没有。 */
+    ptId?: string;
+    rule: ErrorCode;
+    /** 供消费端拼文案的结构化参数，如 { className: 'bg-red-500' }。 */
+    params?: Readonly<Record<string, string | number>>;
+}
+interface ValidateResult$1 {
+    ok: boolean;
+    issues: Issue[];
+}
+/** 阻塞发布的规则。预览放行，发布必须拦。 */
+declare const PUBLISH_BLOCKING_RULES: ReadonlySet<ErrorCode>;
+declare function isPublishBlocking(issue: Issue): boolean;
+/** 编辑器 / mastra 抛出的错误。同样不带文案。 */
+interface EditorError {
+    code: ErrorCode;
+    rule?: ErrorCode;
+    ptId?: string;
+    params?: Readonly<Record<string, string | number>>;
+}
+declare function editorError(code: ErrorCode, extra?: Omit<EditorError, 'code'>): EditorError;
+/**
+ * 规则**数据表**。
+ *
+ * 这里只有数据，没有一句提示词措辞 —— 措辞在 mastra 的
+ * `page-designer/segments/v4.ts`，从这张表渲染。core 因此可以作为公开包发布，
+ * 措辞微调也不需要 core 发版。
+ *
+ * 代价是语义变更要两仓配对改。mastra 侧靠**双向**覆盖测试兜住：
+ *   正向：规则段必须提到这里的每一项（防 core 新增、mastra 没跟）
+ *   反向：规则段提到的每一项都能在这里找到（防 core 删除、mastra 还在讲）
+ * 只做正向的话，删一个开关后测试仍是绿的。
+ */
+/** 设备变体。`md:` 是 PC 覆盖，`max-md:` 是手机独占（两者无缝无重叠）。 */
+declare const DEVICE_VARIANTS: readonly ["md", "max-md"];
+/**
+ * 状态变体。
+ *
+ * 有意不含 `focus:` —— 统一用 `focus-visible:`。
+ * 有意不含 `group-*` / `peer-*`：它们把样式绑到**别的元素**的状态上，
+ * 面板表达不了、属性回显放不进（基线 / md / max-md）三槽。
+ * 这两类 Tailwind 都能编译，拒绝它们是产品决定，不是能力限制。
+ */
+declare const STATE_VARIANTS: readonly ["hover", "focus-visible", "active", "disabled"];
+type DeviceVariant = (typeof DEVICE_VARIANTS)[number];
+type StateVariant = (typeof STATE_VARIANTS)[number];
+/** 属性回显的三个槽位。 */
+declare const PROPERTY_SLOTS: readonly ["base", "md", "max-md"];
+type PropertySlot = (typeof PROPERTY_SLOTS)[number];
+/** 结构层级。弹窗没有 section 层。 */
+declare const LAYER_NAMES: readonly ["section", "container", "leaf"];
+type LayerName = (typeof LAYER_NAMES)[number];
+/** leaf 的类型。 */
+declare const LEAF_TYPES: readonly ["text", "media", "button", "shape"];
+type LeafType = (typeof LEAF_TYPES)[number];
+/** 不透明子树的两档。 */
+declare const OPAQUE_MODES: readonly ["strict", "text"];
+type OpaqueMode = (typeof OPAQUE_MODES)[number];
+/**
+ * 整张表。mastra 的规则段渲染它，双向覆盖测试也比对它。
+ * 加一项就要同步 mastra —— 这正是双向断言要暴露的事。
+ */
+declare const rules: {
+    readonly deviceVariants: readonly ["md", "max-md"];
+    readonly stateVariants: readonly ["hover", "focus-visible", "active", "disabled"];
+    readonly propertySlots: readonly ["base", "md", "max-md"];
+    readonly layers: readonly ["section", "container", "leaf"];
+    readonly leafTypes: readonly ["text", "media", "button", "shape"];
+    readonly idPattern: "[a-z][a-z0-9_-]{1,31}";
+    readonly themePtId: "theme";
+    readonly rootPtId: "root";
+    readonly formatMetaName: "lpx-format";
+    readonly formatVersion: "4";
+    readonly switches: readonly [{
+        readonly key: "hide";
+        readonly attr: "data-pt-hide";
+        readonly values: readonly ["mobile", "pc"];
+        readonly summary: "一端隐藏";
+    }, {
+        readonly key: "layout-mobile";
+        readonly attr: "data-pt-layout-mobile";
+        readonly values: readonly ["stack", "scroll"];
+        readonly summary: "PC 轮播→手机纵向平铺 / PC 网格→手机横滑";
+    }, {
+        readonly key: "swap-image";
+        readonly attr: null;
+        readonly values: readonly [];
+        readonly summary: "<picture> 双 source，(min-width:768px) 分界";
+    }, {
+        readonly key: "direction";
+        readonly attr: null;
+        readonly values: readonly [];
+        readonly summary: "flex-col md:flex-row";
+    }, {
+        readonly key: "columns";
+        readonly attr: null;
+        readonly values: readonly [];
+        readonly summary: "grid-cols-1 md:grid-cols-{n}";
+    }, {
+        readonly key: "placeholder";
+        readonly attr: "data-pt-placeholder";
+        readonly values: readonly [];
+        readonly summary: "未落图占位；必带 aspect-*，src 为空";
+    }];
+    readonly crossDeviceConsistentProperties: readonly ["color", "font-weight", "border", "box-shadow", "font-family"];
+    readonly opaqueModes: readonly ["strict", "text"];
+    readonly opaqueTextEditableTags: readonly ["td", "th"];
+    readonly inlineNoIdTags: readonly ["a", "abbr", "b", "bdi", "bdo", "br", "cite", "code", "data", "dfn", "em", "i", "kbd", "mark", "q", "rp", "rt", "ruby", "s", "samp", "small", "span", "strong", "sub", "sup", "time", "u", "var", "wbr"];
+    readonly inlineStyleAllowedPrefix: "--pt-";
+    readonly editOpKinds: readonly ["set", "insert", "delete", "move", "replace"];
+    readonly arbitraryValueAllowedProperties: readonly ["width", "height", "aspect-ratio", "background-image", "max-width", "min-height"];
+};
+type Rules = typeof rules;
+/**
+ * 两种文档类型的能力档。宿主把其中一档作为 `capabilities` 传给编辑器，
+ * mastra 也读同一份来判断结构规则。
+ */
+/** 组件运行时由谁提供。 */
+type ComponentRuntime =
+/** 渲染器自带脚本（落地页）。 */
+'self'
+/**
+ * 只出声明式标记、零脚本，行为归 Engage SDK（弹窗的表单与倒计时）。
+ * core 给弹窗表单出脚本会和 SDK 抢同一张表单。
+ */
+ | 'engage-sdk';
+interface KindProfile {
+    /** 文档形态：完整文档（落地页）还是片段（弹窗）。 */
+    root: 'document' | 'fragment';
+    /** 结构层级。弹窗没有 section 层。 */
+    layers: readonly LayerName[];
+    /** 编译目标：完整文档 CSS，还是 Shadow DOM 内的 px 化 CSS。 */
+    compile: 'document' | 'shadow-px';
+    leafTypes: readonly LeafType[];
+    /** 允许的内置组件 → 其运行时策略。 */
+    components: Readonly<Record<string, ComponentRuntime>>;
+    units: {
+        vh: boolean;
+    };
+    customCode: boolean;
+}
+declare const KIND_PROFILES: {
+    readonly page: {
+        readonly root: "document";
+        readonly layers: readonly ["section", "container", "leaf"];
+        readonly compile: "document";
+        readonly leafTypes: readonly ["text", "media", "button", "shape"];
+        readonly components: {
+            readonly carousel: "self";
+            readonly faq: "self";
+            readonly tabs: "self";
+            readonly 'sticky-cta': "self";
+            readonly form: "self";
+        };
+        readonly units: {
+            readonly vh: true;
+        };
+        readonly customCode: true;
+    };
+    readonly popup: {
+        readonly root: "fragment";
+        readonly layers: readonly ["container", "leaf"];
+        readonly compile: "shadow-px";
+        readonly leafTypes: readonly ["text", "media", "button", "shape"];
+        readonly components: {
+            readonly form: "engage-sdk";
+            readonly countdown: "engage-sdk";
+            readonly carousel: "self";
+            readonly faq: "self";
+            readonly tabs: "self";
+        };
+        readonly units: {
+            readonly vh: false;
+        };
+        readonly customCode: false;
+    };
+};
+type KindName = keyof typeof KIND_PROFILES;
+declare function isNativePaletteClass(className: string): boolean;
+interface ValidateOptions {
+    profile: KindProfile;
+    /**
+     * 判定单个 class 在当前 @theme 下是否能编译出 CSS。
+     * 由调用方注入（编译器在另一个模块，validate 不直接依赖它）。
+     * 不传则跳过这条规则 —— 用于只想跑结构 / 格式检查的场合。
+     */
+    canCompileClass?: (className: string) => boolean;
+}
+interface ValidateResult {
+    ok: boolean;
+    issues: Issue[];
+}
+declare function validate(root: Document | DocumentFragment | Element, options: ValidateOptions): ValidateResult;
+/**
+ * EditOp：人的面板操作、拖拽、富文本、AI 指令，最终都变成这五种操作之一，
+ * 作用在唯一的 Document 上。撤销、AI、序列化因此只面对一个对象。
+ */
+interface SetOp {
+    op: 'set';
+    id: string;
+    /** 值为 null 表示删除该属性。 */
+    attrs?: Record<string, string | null>;
+    classes?: {
+        add?: string[];
+        remove?: string[];
+    };
+    /** 元素的内容片段（富文本标记 / @theme 内容）。同样要过脚本护栏。 */
+    text?: string;
+}
+interface InsertOp {
+    op: 'insert';
+    parentId: string;
+    /** 在父元素的**元素子节点**中的下标。 */
+    index: number;
+    /** 必须是单根元素，且片段内结构节点自带 data-pt-id。 */
+    html: string;
+    /**
+     * 精确的 childNodes 下标。**只由 core 生成逆操作时填写**，构造方不要用。
+     *
+     * 为什么需要它：元素下标对人和 AI 才是可理解的，但删除一个元素后，
+     * 它前后的空白文本节点还在原地；只按元素下标插回去，空白会跑到另一侧，
+     * 往返就不再逐字节相同。逆操作记下精确偏移，往返才稳。
+     */
+    nodeIndex?: number;
+}
+interface DeleteOp {
+    op: 'delete';
+    id: string;
+}
+interface MoveOp {
+    op: 'move';
+    id: string;
+    parentId: string;
+    index: number;
+    /** 同 InsertOp.nodeIndex，只由 core 生成逆操作时填写。 */
+    nodeIndex?: number;
+}
+interface ReplaceOp {
+    op: 'replace';
+    id: string;
+    /** 单根，且根元素 id 必须等于被替换元素的 id（埋点锚点不能断）。 */
+    html: string;
+}
+type EditOp = SetOp | InsertOp | DeleteOp | MoveOp | ReplaceOp;
+interface Transaction {
+    /** 一次意图 = 一次撤销。进历史栏的那句话。 */
+    label: string;
+    ops: EditOp[];
+    source: 'user' | 'ai';
+}
+interface ApplyOptions {
+    profile: KindProfile;
+}
+type ApplyResult = {
+    ok: true;
+    inverse: EditOp[];
+} | {
+    ok: false;
+    error: EditorError;
+    failedIndex: number;
+};
+/**
+ * 应用一组 EditOp，并产出逆操作。
+ *
+ * **事务语义**：一组 op 顺序应用，每条的下标基于**前一条应用之后**的状态。
+ * 任何一条失败 → 整个事务不生效，文档一个字节都不变。
+ *
+ * 原子性的实现方式是「先在克隆体上试跑一遍，通过了再在真文档上跑」，而不是
+ * 「边跑边记逆操作、失败了回滚」。后者的正确性取决于逆操作自身没有 bug，
+ * 而失败时恰恰是最容易触发边角情况的时刻 —— 把原子性压在最脆弱的那条路径上
+ * 不是好交易。克隆一次的代价（原生 cloneNode）远小于一次编译。
+ */
+declare function apply(doc: Document, ops: EditOp[], options: ApplyOptions): ApplyResult;
+/** 操作引用的 id 必须在文档里。用得最多的一条。 */
+declare function requireIdHit(doc: Document | DocumentFragment, id: string): EditorError | null;
+declare function findById(root: Document | DocumentFragment | Element, id: string): Element | null;
+/** 片段与富文本里都不许有脚本与事件属性。 */
+declare function rejectScriptsAndHandlers(node: Node): EditorError | null;
+/**
+ * 片段内每个结构节点都要自带 id，格式合规，且不与目标文档冲突。
+ *
+ * apply **永不生成 id** —— id 在构造 op 时就要写进 payload。两侧各自生成必然分叉，
+ * 所以这里宁可整个事务拒绝，也不就地补一个。
+ */
+declare function requireFragmentIds(fragment: DocumentFragment, existing: ReadonlySet<string>): EditorError | null;
+/** 片段必须是单根元素。 */
+declare function requireSingleRoot(fragment: DocumentFragment): EditorError | null;
+/**
+ * 片段 canonical 往返一致：`serialize(parse(html))` 再解析一次仍相同。
+ * 拦的是畸形 HTML —— 它在两侧的纠错结果可能不同。
+ */
+declare function requireCanonicalFragment(doc: Document, html: string): EditorError | null;
+declare const guards_findById: typeof findById;
+declare const guards_rejectScriptsAndHandlers: typeof rejectScriptsAndHandlers;
+declare const guards_requireCanonicalFragment: typeof requireCanonicalFragment;
+declare const guards_requireFragmentIds: typeof requireFragmentIds;
+declare const guards_requireIdHit: typeof requireIdHit;
+declare const guards_requireSingleRoot: typeof requireSingleRoot;
+declare namespace guards {
+  export { guards_findById as findById, guards_rejectScriptsAndHandlers as rejectScriptsAndHandlers, guards_requireCanonicalFragment as requireCanonicalFragment, guards_requireFragmentIds as requireFragmentIds, guards_requireIdHit as requireIdHit, guards_requireSingleRoot as requireSingleRoot };
+}
+/**
+ * 主题：`<style type="text/tailwindcss" data-pt-id="theme">` 里的 @theme 块内容。
+ *
+ * 它是缓存的键：一个 class 成不成立、tailwind-merge 认不认得某个 token，
+ * 都取决于当前主题。
+ */
+interface Theme {
+    /** @theme 块的原文（含 `@theme { … }` 外壳）。 */
+    source: string;
+    /** 内容 hash，作为缓存键。 */
+    hash: string;
+}
+declare const EMPTY_THEME: Theme;
+/** 从文档里取出主题块。取不到就是空主题。 */
+declare function themeOf(root: Document | DocumentFragment | Element): Theme;
+declare function themeFromSource(source: string): Theme;
+/**
+ * 从 @theme 原文里抽出各命名空间的 token 名。
+ * 供 tailwind-merge 的 class group 派生 —— token 名是每页自定义的，
+ * 模块级单例配置认不出它们。
+ */
+interface ThemeTokens {
+    color: string[];
+    text: string[];
+    spacing: string[];
+    radius: string[];
+    shadow: string[];
+    font: string[];
+}
+declare function themeTokens(theme: Theme): ThemeTokens;
+/** 累积编译：返回迄今见过的所有候选的完整 CSS。画布用。 */
+declare function incremental(candidates: Iterable<string>, theme?: Theme): Promise<string>;
+/**
+ * 全新编译：每次新建引擎，候选**排序后**编译。
+ * 排序是为了让同一组 class 无论以什么顺序收集到，都产出同一串字节。
+ */
+declare function fresh(candidates: Iterable<string>, theme?: Theme): Promise<string>;
+/** 把该主题的缓存条目建齐。`fresh` 按定义不受益。 */
+declare function warm(theme?: Theme): Promise<void>;
+/**
+ * 「class 可编译」判定。
+ *
+ * 用 Tailwind 自己的 design system：`candidatesToCss` 对解析不出的候选直接返回
+ * null。这是 Tailwind IntelliSense 与 prettier 插件用的同一个口子 —— 精确判定，
+ * 不是在 CSS 字串里找转义选择器的启发式。
+ *
+ * 一个 ops 块一次调用，不是逐 class 建引擎（逐个建引擎每次约 3ms，
+ * 20 个 class 的块冷缓存就要多花 60ms，加在每轮 AI 往返上）。
+ *
+ * ⚠️ 它挂着 `__unstable__` 前缀。我们本来就锁精确版本，所以现在是安全的；
+ * 万一哪个版本拿掉它，退回「在 fresh 输出里查转义后的选择器」那条路，
+ * 判定器同样只在这一处。
+ */
+declare function canCompile(classes: readonly string[], theme?: Theme): Promise<Map<string, boolean>>;
+/** 同属性互斥：按当前主题派生的冲突表合并 class 列表。 */
+declare function mergeClasses(classes: readonly string[], theme?: Theme): string;
+/** 测试与宿主重载主题时用。 */
+declare function clearCompileCache(): void;
+declare const compile_EMPTY_THEME: typeof EMPTY_THEME;
+type compile_Theme = Theme;
+type compile_ThemeTokens = ThemeTokens;
+declare const compile_canCompile: typeof canCompile;
+declare const compile_clearCompileCache: typeof clearCompileCache;
+declare const compile_fresh: typeof fresh;
+declare const compile_incremental: typeof incremental;
+declare const compile_mergeClasses: typeof mergeClasses;
+declare const compile_themeFromSource: typeof themeFromSource;
+declare const compile_themeOf: typeof themeOf;
+declare const compile_themeTokens: typeof themeTokens;
+declare const compile_warm: typeof warm;
+declare namespace compile {
+  export { compile_EMPTY_THEME as EMPTY_THEME, type compile_Theme as Theme, type compile_ThemeTokens as ThemeTokens, compile_canCompile as canCompile, compile_clearCompileCache as clearCompileCache, compile_fresh as fresh, compile_incremental as incremental, compile_mergeClasses as mergeClasses, compile_themeFromSource as themeFromSource, compile_themeOf as themeOf, compile_themeTokens as themeTokens, compile_warm as warm };
+}
+/**
+ * 收集文档里用到的全部 class。
+ *
+ * 接 `Document` 而不是 HTML 字串 —— 与其余 API 一致，也免得调用方为了收集 class
+ * 再解析一遍（浏览器侧先 parse 即可）。
+ *
+ * 注意它扫的是**源文档**：内置组件在源里只是一个空壳，展开后才出现的类名不在
+ * 这里。这正是「渲染器产出的 markup 不使用 Tailwind class」那条规则存在的原因 ——
+ * 组件自带 CSS，不走这条编译管线。
+ */
+declare function collectClasses(root: Document | DocumentFragment | Element): Set<string>;
+/**
+ * 宿主注入的 DOM 契约。
+ *
+ * core 不读任何浏览器全局 —— 它要在 Node 里跑出与浏览器逐字节相同的结果，
+ * 任何隐式依赖都会让两侧漂掉。整文档解析所需的 DOMParser 由宿主在
+ * `createCore({ DOMParser })` 时注入一次：
+ *
+ *   浏览器  createCore({ DOMParser: window.DOMParser })
+ *   Node    createCore({ DOMParser: new JSDOM('').window.DOMParser })
+ *
+ * Node 侧用 jsdom window 上的构造器、而不是 `new JSDOM(html)`：两侧对称，
+ * 也避开 runScripts 选项对 <noscript> 解析模式的影响。
+ */
+interface DOMParserLike {
+    parseFromString(html: string, type: 'text/html'): Document;
+}
+interface DOMParserCtor {
+    new (): DOMParserLike;
+}
+interface CoreOptions {
+    /** 整文档解析用。片段解析不需要它（见 parseFragment）。 */
+    DOMParser: DOMParserCtor;
+}
+declare function layerOf(el: Element, profile: KindProfile): LayerName | null;
+type StructureRejection = 'section-not-body-child' | 'container-too-deep' | 'leaf-cannot-contain' | 'opaque-subtree' | 'unknown-layer';
+/** 某个父节点能否接纳某一层的子节点。 */
+declare function canContain(parent: Element, childLayer: LayerName, profile: KindProfile): StructureRejection | null;
+/**
+ * 删除的级联语义。
+ *
+ * 删掉 container 的最后一个 leaf —— container 保留（用户还要往里放东西）。
+ * 删掉 section 的最后一个 container —— 连 section 一起删（空区块没有意义）。
+ *
+ * 返回**真正要从树上摘掉的那个节点**。
+ */
+declare function deleteTarget(el: Element, profile: KindProfile): Element;
+interface VariantCheck {
+    ok: boolean;
+    /** 不合规时给出第一个出问题的前缀，供消费端拼文案。 */
+    offending?: string;
+    reason?: 'not-allowed' | 'order';
+}
+/**
+ * 变体前缀允许集与顺序。
+ *
+ * 允许：设备 md: / max-md:，状态 hover: / focus-visible: / active: / disabled:，
+ * 组合只允许**设备在前、状态在后**（md:hover:），不允许 hover:md:。
+ *
+ * 为什么固定顺序：属性回显要把值放进（基线 / md / max-md）三槽，
+ * 两种写法语义相同但会被当成两个不同的 class，同属性互斥就失效了。
+ *
+ * 注意 `group-*` / `peer-*` 与 `hover:md:` 这类 Tailwind **都能编译** ——
+ * 拒绝它们是产品决定，所以必须由这条独立规则拦，「class 可编译」判定拦不住。
+ */
+declare function checkVariants(className: string): VariantCheck;
+/**
+ * 两个版本号，有意分家。
+ *
+ * `VERSION`           包版本，按 semver 走。改规则数据、改护栏逻辑、改注释都会动它。
+ * `COMPILER_VERSION`  **只在编译 / 导出 / 组件渲染 / 规范序列化的输出可能变时**
+ *                     手动递增。
+ *
+ * 为什么必须分开：iam 的 `compiler_version` 列存后者，保存去重也按后者。若用包版本，
+ * 改一条 rules 数据就会让全租户的去重失效、把字节完全相同的成品重算一遍。
+ *
+ * 护栏：export golden 断言「输出变了而 COMPILER_VERSION 没变就红」。
+ * 递增它是一次显式动作，不要顺手跟着包版本一起改。
+ */
+declare const VERSION = "1.0.0-alpha.0";
+declare const COMPILER_VERSION = "1";
+/**
+ * core 的入口。宿主注入 DOM 之后拿到一组行为。
+ *
+ * 只有 `parse` 真的需要注入（整文档解析）。其余能力都是纯函数，挂在这里只是给宿主
+ * 一个单一入口；它们同时也是具名导出 —— golden 测试直接对着纯函数比对最省事，
+ * 也省得两份设计文档里所有签名都写成 core.x(...)。
+ */
+declare function createCore(options: CoreOptions): {
+    parse: (html: string) => Document;
+    parseFragment: typeof parseFragment;
+    serialize: typeof serialize;
+    normalize: typeof normalize;
+    validate: typeof validate;
+    apply: typeof apply;
+    guards: typeof guards;
+    compile: typeof compile;
+    collectClasses: typeof collectClasses;
+    rules: {
+        readonly deviceVariants: readonly ["md", "max-md"];
+        readonly stateVariants: readonly ["hover", "focus-visible", "active", "disabled"];
+        readonly propertySlots: readonly ["base", "md", "max-md"];
+        readonly layers: readonly ["section", "container", "leaf"];
+        readonly leafTypes: readonly ["text", "media", "button", "shape"];
+        readonly idPattern: "[a-z][a-z0-9_-]{1,31}";
+        readonly themePtId: "theme";
+        readonly rootPtId: "root";
+        readonly formatMetaName: "lpx-format";
+        readonly formatVersion: "4";
+        readonly switches: readonly [{
+            readonly key: "hide";
+            readonly attr: "data-pt-hide";
+            readonly values: readonly ["mobile", "pc"];
+            readonly summary: "一端隐藏";
+        }, {
+            readonly key: "layout-mobile";
+            readonly attr: "data-pt-layout-mobile";
+            readonly values: readonly ["stack", "scroll"];
+            readonly summary: "PC 轮播→手机纵向平铺 / PC 网格→手机横滑";
+        }, {
+            readonly key: "swap-image";
+            readonly attr: null;
+            readonly values: readonly [];
+            readonly summary: "<picture> 双 source，(min-width:768px) 分界";
+        }, {
+            readonly key: "direction";
+            readonly attr: null;
+            readonly values: readonly [];
+            readonly summary: "flex-col md:flex-row";
+        }, {
+            readonly key: "columns";
+            readonly attr: null;
+            readonly values: readonly [];
+            readonly summary: "grid-cols-1 md:grid-cols-{n}";
+        }, {
+            readonly key: "placeholder";
+            readonly attr: "data-pt-placeholder";
+            readonly values: readonly [];
+            readonly summary: "未落图占位；必带 aspect-*，src 为空";
+        }];
+        readonly crossDeviceConsistentProperties: readonly ["color", "font-weight", "border", "box-shadow", "font-family"];
+        readonly opaqueModes: readonly ["strict", "text"];
+        readonly opaqueTextEditableTags: readonly ["td", "th"];
+        readonly inlineNoIdTags: readonly ["a", "abbr", "b", "bdi", "bdo", "br", "cite", "code", "data", "dfn", "em", "i", "kbd", "mark", "q", "rp", "rt", "ruby", "s", "samp", "small", "span", "strong", "sub", "sup", "time", "u", "var", "wbr"];
+        readonly inlineStyleAllowedPrefix: "--pt-";
+        readonly editOpKinds: readonly ["set", "insert", "delete", "move", "replace"];
+        readonly arbitraryValueAllowedProperties: readonly ["width", "height", "aspect-ratio", "background-image", "max-width", "min-height"];
+    };
+    KIND_PROFILES: {
+        readonly page: {
+            readonly root: "document";
+            readonly layers: readonly ["section", "container", "leaf"];
+            readonly compile: "document";
+            readonly leafTypes: readonly ["text", "media", "button", "shape"];
+            readonly components: {
+                readonly carousel: "self";
+                readonly faq: "self";
+                readonly tabs: "self";
+                readonly 'sticky-cta': "self";
+                readonly form: "self";
+            };
+            readonly units: {
+                readonly vh: true;
+            };
+            readonly customCode: true;
+        };
+        readonly popup: {
+            readonly root: "fragment";
+            readonly layers: readonly ["container", "leaf"];
+            readonly compile: "shadow-px";
+            readonly leafTypes: readonly ["text", "media", "button", "shape"];
+            readonly components: {
+                readonly form: "engage-sdk";
+                readonly countdown: "engage-sdk";
+                readonly carousel: "self";
+                readonly faq: "self";
+                readonly tabs: "self";
+            };
+            readonly units: {
+                readonly vh: false;
+            };
+            readonly customCode: false;
+        };
+    };
+    VERSION: string;
+    COMPILER_VERSION: string;
+};
+type Core = ReturnType<typeof createCore>;
+export { type ApplyOptions, type ApplyResult, COMPILER_VERSION, type ComponentRuntime, type Core, type CoreOptions, type DOMParserCtor, type DOMParserLike, type DeleteOp, type DeviceVariant, EMPTY_THEME, ERROR_CODES, type EditOp, type EditorError, type ErrorCode, type InsertOp, type Issue, KIND_PROFILES, type KindName, type KindProfile, type LayerName, type LeafType, type MoveOp, type NormalizeOptions, type OpaqueMode, PUBLISH_BLOCKING_RULES, type PropertySlot, type ReplaceOp, type Rules, type SetOp, type StateVariant, type Theme, type ThemeTokens, type Transaction, VERSION, type ValidateOptions, type ValidateResult$1 as ValidateResult, apply, canContain, checkVariants, collectClasses, compile, createCore, deleteTarget, editorError, fragmentElementRoots, guards, isErrorCode, isNativePaletteClass, isPublishBlocking, layerOf, normalize, normalizeClassValue, parseFragment, rules, serialize, themeFromSource, themeOf, themeTokens, validate };