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

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

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 (41) hide show

package/dist/golden/verify.mjs ADDED Viewed

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+/**
+ * 下游用的 golden 校验。随包发布到 `dist/golden/verify.mjs`。
+ *
+ *   node node_modules/@ptengine/lp-editor-core/dist/golden/verify.mjs
+ *
+ * 它做的事：拿包里发的 fixture 输入，用**你这一侧的 DOM 实现**跑一遍
+ * parse / apply / serialize，算 sha256，与清单里的期望值比。
+ *
+ * 为什么要这一步：core 的核心不变量是「浏览器 apply == Node apply」。core 自己的
+ * CI 已经在两个引擎里各验过一遍；但下游装的是**你环境里的** jsdom、你的 Node 版本。
+ * 这个脚本确认那套组合产出的字节与发布时一致 —— 不一致的话，你的页面缓存会和
+ * 编辑器逐轮分叉，而且不报错。
+ *
+ * 校验脚本随包发而不是让下游自己写，是因为「同一个判断两份实现」正是这套设计
+ * 一路在防的东西。
+ *
+ * 需要 jsdom 在场（core 自己不依赖它 —— DOM 由宿主注入）。
+ */
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const here = dirname(fileURLToPath(import.meta.url));
+let JSDOM;
+try {
+    ({ JSDOM } = await import('jsdom'));
+} catch {
+    console.error(
+        'golden-verify: 需要 jsdom。core 自己不依赖它（DOM 由宿主注入），\n' +
+            '请在你的项目里安装：pnpm add -D jsdom'
+    );
+    process.exit(2);
+}
+const core = await import(join(here, '..', 'index.js'));
+const manifest = JSON.parse(readFileSync(join(here, 'manifest.json'), 'utf8'));
+const opsData = JSON.parse(readFileSync(join(here, 'ops-cases.json'), 'utf8'));
+const opsByName = new Map(opsData.cases.map(c => [c.name, c]));
+const DOMParser = new JSDOM('').window.DOMParser;
+const { parse } = core.createCore({ DOMParser });
+const hostDoc = parse('<!DOCTYPE html><body>');
+const sha = s => createHash('sha256').update(s, 'utf8').digest('hex');
+function compute(entry) {
+    if (entry.kind === 'document') {
+        return core.serialize(parse(readFileSync(join(here, entry.input), 'utf8')));
+    }
+    if (entry.kind === 'fragment') {
+        return core.serialize(
+            core.parseFragment(hostDoc, readFileSync(join(here, entry.input), 'utf8'))
+        );
+    }
+    if (entry.kind === 'apply') {
+        const name = entry.input.split('#')[1];
+        const c = opsByName.get(name);
+        if (!c) throw new Error(`ops-cases.json 里找不到用例 ${name}`);
+        const html = opsData.wrapper.replace('{{HEAD_EXTRA}}', '').replace('{{BODY}}', c.body);
+        const doc = parse(html);
+        const r = core.apply(doc, c.ops, { profile: core.KIND_PROFILES.page });
+        if (!r.ok) throw new Error(`apply 失败 ${r.error.code} @${r.failedIndex}`);
+        return core.serialize(doc);
+    }
+    throw new Error(`未知的 kind: ${entry.kind}`);
+}
+let failed = 0;
+for (const entry of manifest.fixtures) {
+    let actual;
+    try {
+        actual = sha(compute(entry));
+    } catch (e) {
+        console.error(`✗ ${entry.fixture} — ${e.message}`);
+        failed++;
+        continue;
+    }
+    if (actual !== entry.sha256) {
+        console.error(`✗ ${entry.fixture}\n    期望 ${entry.sha256}\n    实际 ${actual}`);
+        failed++;
+    }
+}
+const total = manifest.fixtures.length;
+if (failed > 0) {
+    console.error(
+        `\ngolden-verify: ${failed}/${total} 不一致（core ${core.VERSION}, ` +
+            `COMPILER_VERSION ${manifest.COMPILER_VERSION}）\n` +
+            '这一侧的产出与发布时不同 —— 先别接上去，它会让两端的文档逐轮分叉。\n' +
+            '常见原因：DOM 实现不是 HTML5 规范解析器（如 node-html-parser）、\n' +
+            '或 core 版本与清单不匹配。'
+    );
+    process.exit(1);
+}
+console.log(
+    `golden-verify: ${total}/${total} 一致 ` +
+        `(core ${core.VERSION}, COMPILER_VERSION ${manifest.COMPILER_VERSION})`
+);

package/dist/index.d.ts CHANGED Viewed

@@ -564,7 +564,7 @@ declare function checkVariants(className: string): VariantCheck;
  * 护栏：export golden 断言「输出变了而 COMPILER_VERSION 没变就红」。
  * 递增它是一次显式动作，不要顺手跟着包版本一起改。
  */
-declare const VERSION = "1.0.0-alpha.0";
+declare const VERSION = "1.0.0-alpha.1";
 declare const COMPILER_VERSION = "1";
 /**

package/dist/index.js CHANGED Viewed

@@ -398,7 +398,7 @@ var KIND_PROFILES = {
 };
 // src/version.ts
-var VERSION = "1.0.0-alpha.0";
+var VERSION = "1.0.0-alpha.1";
 var COMPILER_VERSION = "1";
 // src/validate/tree.ts