@xihe-lab/tapd-core 2.0.0-rc.1 → 2.0.0-rc.2

package/dist/richtext/attachment-anchor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-anchor.js","sourceRoot":"","sources":["../../src/richtext/attachment-anchor.ts"],"names":[],"mappings":"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"}

package/dist/richtext/attachment-anchor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=attachment-anchor.test.d.ts.map

package/dist/richtext/attachment-anchor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-anchor.test.d.ts","sourceRoot":"","sources":["../../src/richtext/attachment-anchor.test.ts"],"names":[],"mappings":""}

package/dist/richtext/attachment-anchor.test.js

@@ -0,0 +1,149 @@
+// attachment-anchor 语义单测：fileTypeFor 映射 / md 扩展语法 / R6 五件套模板 / 解析容错 / 不认识锚点原样保留。
+import assert from 'node:assert/strict';
+import { ATTACH_SCHEME, DEFAULT_ATTACHMENT_SLUG, FILE_TYPE_BY_EXTENSION, attachmentAnchorHtml, attachmentAnchorMd, attachmentHtmlToMd, attachmentMdToHtml, fileTypeFor, findAttachmentAnchors, isAttachmentAnchorNode, attachmentAnchorNodeToMd, parseAttachmentAnchorHtml, parseAttachmentAnchorMd, } from './attachment-anchor.js';
+const WS = '39814312';
+const ID = '1139814312001000001';
+// 完整编辑器模板（含 inner spans / type / class，e2e 金样 poc-rc2-file-embed.mjs 同构）
+const EDITOR_STYLE_ANCHOR = `<a data-is-tapd-attachment="true" contenteditable="false" target="_blank" rel="noopener" ` +
+    `data-can-preview="true" data-file-type="text" type="text" data-name="comment-embed.txt" data-size="54" ` +
+    `href="/${WS}/attachments/preview_attachments/1139814312001000004/story_description_attachment" ` +
+    `class="tapd-editor__attachment-item"><span class="tapd-editor__attachment-item__left">` +
+    `<span class="tapd-editor__attachment-item__text-wrapper">` +
+    `<span class="tapd-editor__attachment-item__title">comment-embed.txt</span>` +
+    `<span class="tapd-editor__attachment-item__size">0.00MB</span></span></span></a>`;
+const checks = [
+    ['fileTypeFor: txt→text、png/jpg/jpeg→image、pdf→pdf、其他→other（大小写不敏感）', () => {
+            assert.equal(fileTypeFor('说明.txt'), 'text');
+            assert.equal(fileTypeFor('pic.PNG'), 'image');
+            assert.equal(fileTypeFor('a.jpg'), 'image');
+            assert.equal(fileTypeFor('a.jpeg'), 'image');
+            assert.equal(fileTypeFor('doc.pdf'), 'pdf');
+            assert.equal(fileTypeFor('app.log'), 'other');
+            assert.equal(fileTypeFor('noext'), 'other');
+            assert.equal(fileTypeFor('报表@v2.pdf'), 'pdf');
+        }],
+    ['FILE_TYPE_BY_EXTENSION: 映射表导出供 Wave 2 复用', () => {
+            assert.equal(FILE_TYPE_BY_EXTENSION.txt, 'text');
+            assert.equal(FILE_TYPE_BY_EXTENSION.png, 'image');
+            assert.equal(FILE_TYPE_BY_EXTENSION.pdf, 'pdf');
+            assert.equal(ATTACH_SCHEME, 'attach:');
+            assert.equal(DEFAULT_ATTACHMENT_SLUG, 'story_description_attachment');
+        }],
+    ['attachmentAnchorMd: md 扩展语法生成', () => {
+            assert.equal(attachmentAnchorMd({ workspaceId: WS, id: ID, name: '需求说明.txt' }), `[📎 需求说明.txt](attach:${WS}/${ID})`);
+        }],
+    ['attachmentAnchorMd: 文件名中 []\\ 转义可逆；非法 ws/id 抛错', () => {
+            const md = attachmentAnchorMd({ workspaceId: WS, id: ID, name: 'a]b[ c\\d.txt' });
+            assert.equal(md, `[📎 a\\]b\\[ c\\\\d.txt](attach:${WS}/${ID})`);
+            const parsed = parseAttachmentAnchorMd(md);
+            assert.equal(parsed?.name, 'a]b[ c\\d.txt');
+            assert.throws(() => attachmentAnchorMd({ workspaceId: 'ws x', id: ID, name: 'f' }), TypeError);
+            assert.throws(() => attachmentAnchorMd({ workspaceId: WS, id: '', name: 'f' }), TypeError);
+        }],
+    ['parseAttachmentAnchorMd: 非 attach: 链接与普通链接 → null', () => {
+            assert.equal(parseAttachmentAnchorMd('[标题](https://www.tapd.cn/x)'), null);
+            assert.equal(parseAttachmentAnchorMd('[📎 x](https://a/b)'), null);
+            assert.equal(parseAttachmentAnchorMd('plain text'), null);
+        }],
+    ['parseAttachmentAnchorMd: 完整解析 ws/id/name', () => {
+            const ref = parseAttachmentAnchorMd(`前缀 [📎 需求说明.txt](attach:${WS}/${ID}) 后缀`);
+            assert.deepEqual(ref, { workspaceId: WS, id: ID, name: '需求说明.txt' });
+        }],
+    ['attachmentAnchorHtml: R6 定稿最小模板逐字段（含 size）', () => {
+            assert.equal(attachmentAnchorHtml({ workspaceId: WS, id: ID, name: '接口设计.pdf', size: 2048 }), `<a data-is-tapd-attachment="true" data-can-preview="true" data-file-type="pdf" ` +
+                `data-name="接口设计.pdf" data-size="2048" target="_blank" rel="noopener" ` +
+                `href="/${WS}/attachments/preview_attachments/${ID}/story_description_attachment">接口设计.pdf</a>`);
+        }],
+    ['attachmentAnchorHtml: size 省略不输出 data-size；fileType 按扩展名默认映射；slug 可覆盖', () => {
+            const html = attachmentAnchorHtml({ workspaceId: WS, id: ID, name: 'app.log' });
+            assert.ok(html.includes('data-file-type="other"'));
+            assert.ok(!html.includes('data-size'));
+            assert.ok(html.includes(`href="/${WS}/attachments/preview_attachments/${ID}/story_description_attachment"`));
+            const custom = attachmentAnchorHtml({ workspaceId: WS, id: ID, name: 'a.txt', fileType: 'text' }, { slug: 'bug_description_attachment' });
+            assert.ok(custom.includes('/bug_description_attachment">'));
+            assert.ok(custom.endsWith('>a.txt</a>'));
+        }],
+    ['attachmentAnchorHtml: 文件名 HTML 特殊字符转义', () => {
+            const html = attachmentAnchorHtml({ workspaceId: WS, id: ID, name: 'a"b&c.txt' });
+            assert.ok(html.includes('data-name="a&quot;b&amp;c.txt"'));
+            assert.ok(html.endsWith('>a&quot;b&amp;c.txt</a>') === false);
+            assert.ok(html.endsWith('>a"b&amp;c.txt</a>'));
+        }],
+    ['parseAttachmentAnchorHtml: 生成结果可逆解析', () => {
+            const html = attachmentAnchorHtml({ workspaceId: WS, id: ID, name: '接口设计.pdf', size: 2048 });
+            assert.deepEqual(parseAttachmentAnchorHtml(html), {
+                workspaceId: WS, id: ID, name: '接口设计.pdf', size: 2048, fileType: 'pdf',
+            });
+        }],
+    ['parseAttachmentAnchorHtml: 完整编辑器模板（inner spans/type/class）可识别', () => {
+            assert.deepEqual(parseAttachmentAnchorHtml(EDITOR_STYLE_ANCHOR), {
+                workspaceId: WS, id: '1139814312001000004', name: 'comment-embed.txt', size: 54, fileType: 'text',
+            });
+            assert.deepEqual(findAttachmentAnchors(`<p>前</p>${EDITOR_STYLE_ANCHOR}<p>后</p>`).length, 1);
+        }],
+    ['parseAttachmentAnchorHtml: 不认识的锚点 → null（裸 <a>/缺 data-name/缺 flag）', () => {
+            assert.equal(parseAttachmentAnchorHtml(`<a href="/${WS}/attachments/preview_attachments/${ID}/story_description_attachment">x.txt</a>`), null);
+            assert.equal(parseAttachmentAnchorHtml(`<a data-is-tapd-attachment="true" href="/${WS}/attachments/preview_attachments/${ID}/story_description_attachment">残缺</a>`), null);
+            assert.equal(parseAttachmentAnchorHtml(`<a data-can-preview="true" data-name="x.txt" href="/${WS}/attachments/preview_attachments/${ID}/story_description_attachment">无flag</a>`), null);
+            assert.equal(parseAttachmentAnchorHtml(`<a data-is-tapd-attachment="true" data-name="x.txt" href="https://elsewhere/x">外部链接</a>`), null);
+        }],
+    ['attachmentHtmlToMd: 锚点 → md 扩展语法；不认识锚点原样保留', () => {
+            const md = attachmentHtmlToMd(`<p>材料</p>${EDITOR_STYLE_ANCHOR}`);
+            assert.equal(md, `<p>材料</p>[📎 comment-embed.txt](attach:${WS}/1139814312001000004)`);
+            const bare = `<a href="/${WS}/attachments/preview_attachments/${ID}/story_description_attachment">残缺</a>`;
+            assert.equal(attachmentHtmlToMd(`<p>x</p>${bare}`), `<p>x</p>${bare}`);
+            const plain = '<p>普通 <a href="https://e.com">链接</a></p>';
+            assert.equal(attachmentHtmlToMd(plain), plain);
+        }],
+    ['attachmentMdToHtml: md → 锚点；非 attach 链接透传', () => {
+            const html = attachmentMdToHtml(`见 [📎 需求说明.txt](attach:${WS}/${ID})`);
+            assert.ok(html.startsWith('见 <a data-is-tapd-attachment="true"'));
+            assert.ok(html.includes('data-name="需求说明.txt"'));
+            assert.ok(html.endsWith(`>需求说明.txt</a>`));
+            const link = '参考 [标题](https://e.com/a)';
+            assert.equal(attachmentMdToHtml(link), link);
+        }],
+    ['attachmentMdToHtml: 多锚点与转义名可逆', () => {
+            const md = `[📎 a.txt](attach:${WS}/1139814312001000002) 中间 [📎 b.pdf](attach:${WS}/${ID})`;
+            const html = attachmentMdToHtml(md);
+            assert.equal(findAttachmentAnchors(html).length, 2);
+            assert.equal(attachmentHtmlToMd(html), md);
+        }],
+    ['节点辅助: isAttachmentAnchorNode / attachmentAnchorNodeToMd', () => {
+            const node = {
+                nodeName: 'A',
+                getAttribute: (name) => ({
+                    'data-is-tapd-attachment': 'true',
+                    'data-name': 'comment-embed.txt',
+                    'data-size': '54',
+                    'data-file-type': 'text',
+                    href: `/${WS}/attachments/preview_attachments/1139814312001000004/story_description_attachment`,
+                })[name] ?? null,
+            };
+            assert.equal(isAttachmentAnchorNode(node), true);
+            assert.equal(attachmentAnchorNodeToMd(node), `[📎 comment-embed.txt](attach:${WS}/1139814312001000004)`);
+            const bare = { nodeName: 'A', getAttribute: () => null };
+            assert.equal(isAttachmentAnchorNode(bare), false);
+            assert.equal(attachmentAnchorNodeToMd(bare), null);
+        }],
+];
+let failed = 0;
+for (const [name, check] of checks) {
+    try {
+        check();
+        console.log(`PASS ${name}`);
+    }
+    catch (error) {
+        failed += 1;
+        console.error(`FAIL ${name}`);
+        console.error(`  ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+if (failed > 0) {
+    console.error(`\n${failed}/${checks.length} failed`);
+    process.exitCode = 1;
+}
+else {
+    console.log(`\n${checks.length}/${checks.length} passed`);
+}
+//# sourceMappingURL=attachment-anchor.test.js.map

package/dist/richtext/attachment-anchor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-anchor.test.js","sourceRoot":"","sources":["../../src/richtext/attachment-anchor.test.ts"],"names":[],"mappings":"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"}

package/dist/richtext/escape.d.ts

@@ -0,0 +1,7 @@
+/** HTML 文本节点转义（& < >）。 */
+export declare function escapeHtmlText(value: string): string;
+/** HTML 属性值转义（& < > " '）。 */
+export declare function escapeHtmlAttr(value: string): string;
+/** 反解 TAPD 富文本属性值中可能出现的实体（常用命名实体 + 十进制/十六进制数字实体）。未识别的实体原样保留。 */
+export declare function decodeHtmlEntities(value: string): string;
+//# sourceMappingURL=escape.d.ts.map

package/dist/richtext/escape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.d.ts","sourceRoot":"","sources":["../../src/richtext/escape.ts"],"names":[],"mappings":"AAeA,0BAA0B;AAC1B,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,6BAA6B;AAC7B,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAWD,gEAAgE;AAChE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOxD"}

package/dist/richtext/escape.js

@@ -0,0 +1,60 @@
+// richtext 语义库内部工具：最小 HTML 转义/反解（零依赖、纯函数）。
+// 只覆盖 TAPD 富文本锚点/at-who 生成与解析所需的最小集合，不做完整 HTML 实体表。
+const TEXT_ESCAPES = {
+    '&': '&',
+    '<': '&lt;',
+    '>': '&gt;',
+};
+const ATTR_ESCAPES = {
+    ...TEXT_ESCAPES,
+    '"': '&quot;',
+    "'": '&#39;',
+};
+/** HTML 文本节点转义（& < >）。 */
+export function escapeHtmlText(value) {
+    return value.replace(/[&<>]/g, (ch) => TEXT_ESCAPES[ch] ?? ch);
+}
+/** HTML 属性值转义（& < > " '）。 */
+export function escapeHtmlAttr(value) {
+    return value.replace(/[&<>"']/g, (ch) => ATTR_ESCAPES[ch] ?? ch);
+}
+const NAMED_ENTITIES = {
+    amp: '&',
+    lt: '<',
+    gt: '>',
+    quot: '"',
+    apos: "'",
+    nbsp: ' ',
+};
+/** 反解 TAPD 富文本属性值中可能出现的实体（常用命名实体 + 十进制/十六进制数字实体）。未识别的实体原样保留。 */
+export function decodeHtmlEntities(value) {
+    return value.replace(/&(#x?[0-9a-fA-F]+|[a-zA-Z]+);/g, (whole, body) => {
+        const codePoint = numericEntityCodePoint(body);
+        if (codePoint !== null)
+            return safeFromCodePoint(codePoint, whole);
+        const named = NAMED_ENTITIES[body.toLowerCase()];
+        return named ?? whole;
+    });
+}
+function numericEntityCodePoint(body) {
+    if (body.startsWith('#x') || body.startsWith('#X')) {
+        const code = Number.parseInt(body.slice(2), 16);
+        return Number.isFinite(code) ? code : null;
+    }
+    if (body.startsWith('#')) {
+        const code = Number.parseInt(body.slice(1), 10);
+        return Number.isFinite(code) ? code : null;
+    }
+    return null;
+}
+function safeFromCodePoint(code, fallback) {
+    if (!Number.isInteger(code) || code < 0 || code > 0x10ffff)
+        return fallback;
+    try {
+        return String.fromCodePoint(code);
+    }
+    catch {
+        return fallback;
+    }
+}
+//# sourceMappingURL=escape.js.map

package/dist/richtext/escape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.js","sourceRoot":"","sources":["../../src/richtext/escape.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,oDAAoD;AAEpD,MAAM,YAAY,GAAqC;IACrD,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;CACZ,CAAC;AAEF,MAAM,YAAY,GAAqC;IACrD,GAAG,YAAY;IACf,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,OAAO;CACb,CAAC;AAEF,0BAA0B;AAC1B,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,6BAA6B;AAC7B,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,cAAc,GAAqC;IACvD,GAAG,EAAE,GAAG;IACR,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;CACV,CAAC;AAEF,gEAAgE;AAChE,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,KAAK,CAAC,OAAO,CAAC,gCAAgC,EAAE,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE;QAC7E,MAAM,SAAS,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,SAAS,KAAK,IAAI;YAAE,OAAO,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACnE,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACjD,OAAO,KAAK,IAAI,KAAK,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAY;IAC1C,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChD,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChD,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY,EAAE,QAAgB;IACvD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC5E,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/richtext/index.d.ts

@@ -0,0 +1,15 @@
+export * from './escape.js';
+export * from './mention.js';
+export * from './attachment-anchor.js';
+/**
+ * md 语义片段 → html 语义片段（round-trip 参考实现）：
+ * 先替换附件引用（其 link-text 可能含 @），再做 @ 语义替换（at-who/@@ 转义），
+ * 两步均对其余内容原样透传。注意 fragment 层不感知 md 代码段/链接 URL（见 mention.ts 分层约定）。
+ */
+export declare function mdToHtmlFragment(md: string): string;
+/**
+ * html 语义片段 → md 语义片段（round-trip 参考实现）：
+ * 先还原 at-who 并保护字面 @（此时附件锚点仍是标签、不会被误转义），再把可识别附件锚点还原为 md 扩展语法。
+ */
+export declare function htmlToMdFragment(html: string): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/richtext/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/richtext/index.ts"],"names":[],"mappings":"AAeA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AAKvC;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/richtext/index.js

@@ -0,0 +1,35 @@
+// TAPD 2.0 rc.2 richtext 语义库公共出口（纯函数层，零 IO / 零 SDK 依赖）。
+// FSD §3.5：保真转换库与工具接线分离——本目录只提供语义原语，md_to_html/html_to_md
+// 工具集成、写工具 raw_html 旁路、文档属 Wave 2。
+//
+// Wave 2 接线指引（与现有转换器风格对齐）：
+//   md→html（markdown-it 侧，text/inline token 级）：
+//     - findMentions(text) + renderMentionHtml(name) —— @昵称 → at-who 标记（@@ 转义由 findMentions 语义内建）
+//     - parseAttachmentAnchorMd(md) + attachmentAnchorHtml(ref) —— attach: 链接 → data 五件套锚点
+//     - 或直接用 fragment 级 mdToHtmlFragment / 各模块 fragment 函数做参考实现
+//   html→md（turndown 侧，规则注册）：
+//     - at-who：<b> 规则，filter=isAtWhoNode、replacement=atWhoNodeToMd（永不产出 **粗体**）
+//     - 附件锚点：<a> 规则，filter=isAttachmentAnchorNode、replacement=attachmentAnchorNodeToMd
+//     - 文本节点 @ 字面量保护：escapeAtLiteralsForMd（turndown text escape 钩子内调用）
+//   保真规则须先于 GFM 通用规则注册（FSD §8 规则优先级要求）。
+export * from './escape.js';
+export * from './mention.js';
+export * from './attachment-anchor.js';
+import { mentionMdToHtml, mentionHtmlToMd } from './mention.js';
+import { attachmentMdToHtml, attachmentHtmlToMd } from './attachment-anchor.js';
+/**
+ * md 语义片段 → html 语义片段（round-trip 参考实现）：
+ * 先替换附件引用（其 link-text 可能含 @），再做 @ 语义替换（at-who/@@ 转义），
+ * 两步均对其余内容原样透传。注意 fragment 层不感知 md 代码段/链接 URL（见 mention.ts 分层约定）。
+ */
+export function mdToHtmlFragment(md) {
+    return mentionMdToHtml(attachmentMdToHtml(md));
+}
+/**
+ * html 语义片段 → md 语义片段（round-trip 参考实现）：
+ * 先还原 at-who 并保护字面 @（此时附件锚点仍是标签、不会被误转义），再把可识别附件锚点还原为 md 扩展语法。
+ */
+export function htmlToMdFragment(html) {
+    return attachmentHtmlToMd(mentionHtmlToMd(html));
+}
+//# sourceMappingURL=index.js.map

package/dist/richtext/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/richtext/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,0DAA0D;AAC1D,mCAAmC;AACnC,EAAE;AACF,2BAA2B;AAC3B,gDAAgD;AAChD,kGAAkG;AAClG,2FAA2F;AAC3F,gEAAgE;AAChE,8BAA8B;AAC9B,gFAAgF;AAChF,uFAAuF;AACvF,uEAAuE;AACvE,wCAAwC;AAExC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AAEvC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEhF;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAU;IACzC,OAAO,eAAe,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,kBAAkB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/richtext/mention.d.ts

@@ -0,0 +1,49 @@
+/** at-who 标记里命中的一次提及。`[start, end)` 覆盖含 `@` 在内的整个原始标记区间。 */
+export interface Mention {
+    name: string;
+    start: number;
+    end: number;
+}
+/**
+ * 最小结构 DOM 节点视图（duck typing）——真实 turndown/DOM 节点天然满足，
+ * 测试可直接传字面量对象，保持本库零 DOM 依赖。
+ */
+export interface HtmlNodeLike {
+    nodeName: string;
+    getAttribute(name: string): string | null;
+    readonly textContent?: string | null;
+}
+/** 生成 at-who 标记（昵称含 HTML 特殊字符时按属性/文本位分别转义）。 */
+export declare function renderMentionHtml(name: string): string;
+/** 扫描文本中全部合法 mention（跳过 @@ 转义）。 */
+export declare function findMentions(text: string): Mention[];
+/**
+ * md 文本 → html 语义片段：`@@` → 字面 `@`，合法 `@昵称` → at-who 标记；
+ * 其余内容（含疑似 html 标签区域）原样透传，交给基础转换器（markdown-it）完成。
+ * 注意：本函数不做代码段/链接 URL 等 md 语法识别（见文件头分层约定）。
+ */
+export declare function mentionMdToHtml(md: string): string;
+/**
+ * html 文本 → md 文本：会把命中 mention 规则的字面 `@名字` 加倍为 `@@名字`、
+ * `@@` 字面对加倍为 `@@@@`，使 md→html 重转换后语义不变（round-trip 稳定）；
+ * 不命中规则的 `@`（如邮箱、工单号）原样保留，避免无谓转义噪音。
+ * 与 md→html 的 scanAtTokens 共用同一套规则，双向严格镜像。
+ */
+export declare function escapeAtLiteralsForMd(text: string): string;
+/** 判断一个标签串是否为 at-who 标记（`<b>` 且 class 含 at-who）。 */
+export declare function isAtWhoTag(tagHtml: string): boolean;
+/**
+ * html 片段 → md 语义片段：
+ *   - at-who 标记 → `@昵称`（data-userid 缺失时回退锚点内文本；禁止降级为 `**粗体**`）
+ *   - 其余标签原样透传（非 at-who 的 `<b>` 不动，交给基础转换器 turndown 处理）
+ *   - 标签之间的文本按 escapeAtLiteralsForMd 规则保护字面 @
+ */
+export declare function mentionHtmlToMd(html: string): string;
+/** turndown 规则 filter 用：节点是否为 at-who 标记。 */
+export declare function isAtWhoNode(node: HtmlNodeLike): boolean;
+/**
+ * turndown 规则 replacement 用：at-who 节点 → `@昵称`。
+ * data-userid 优先；缺失时回退节点文本（去首 @）。永不产出 `**`。
+ */
+export declare function atWhoNodeToMd(node: HtmlNodeLike): string;
+//# sourceMappingURL=mention.d.ts.map

package/dist/richtext/mention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention.d.ts","sourceRoot":"","sources":["../../src/richtext/mention.ts"],"names":[],"mappings":"AAyBA,4DAA4D;AAC5D,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAQD,+CAA+C;AAC/C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMtD;AAsCD,mCAAmC;AACnC,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAIpD;AAgBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAalD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS1D;AAYD,oDAAoD;AACpD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGnD;AASD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAcpD;AAED,4CAA4C;AAC5C,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAGvD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAKxD"}

package/dist/richtext/mention.js

@@ -0,0 +1,179 @@
+// TAPD 2.0 rc.2 P3（需求 1139814312001001548）—— @昵称 ↔ at-who 标记双向语义（纯函数层）。
+// 设计依据：FSD §3.5 / §8；e2e 金样 test/e2e-rc2/poc-rc2-mention.mjs（保真实证）。
+//
+// HTML 形态（逐字段定稿，属性顺序勿改——data-userid 存昵称而非数字 uid）：
+//   <b class="at-who" contenteditable="false" data-userid="徐昭" data-type="user">@徐昭</b>
+//
+// md 形态：`@昵称`；转义语法：`@@` → 字面 `@`（不触发 mention）。
+//
+// 昵称文法（FSD §8 误伤对策：仅匹配「@ + 中文名/英文名 + 边界」）：
+//   name-char   ::= Han 字符 | [A-Za-z0-9_]
+//   mention     ::= left-boundary '@' name-char{1,}
+//   left-boundary ::= 文本起始 | 非 name-char
+//   名字 greedily 吃满 name-char，天然获得右边界（空白/标点/行尾）。
+//   左边界要求 @ 前不能紧跟 name-char —— 邮箱 user@example.com、工单号 T-100@QA 因此不命中；
+//   代价是中文紧贴写法（联系@徐昭）不生成 at-who，但 R4 实证服务端对纯文本 @昵称 仍智能识别，欠标记无害，
+//   过标记（把邮箱拆成 at-who）才有害，故取保守侧。
+//
+// 分层约定（Wave 2 接线必读）：
+//   - 本文件是纯函数语义层，零 IO、零 SDK 依赖，不感知 md 代码段/链接 URL 等 md 语法；
+//     `@` 出现在代码段或 URL 内的场景必须在 markdown-it/turndown 的 token 级接线时规避
+//     （本层提供的 fragment 级函数只做语义 token 替换，其余内容原样透传）。
+//   - html→md 方向：at-who 一律还原为 `@昵称`，禁止降级为 `**粗体**`（R7 实测破坏点）。
+import { decodeHtmlEntities, escapeHtmlAttr, escapeHtmlText } from './escape.js';
+const NAME_CHAR_RE = /[\p{Script=Han}A-Za-z0-9_]/u;
+function isNameChar(ch) {
+    return ch !== undefined && NAME_CHAR_RE.test(ch);
+}
+/** 生成 at-who 标记（昵称含 HTML 特殊字符时按属性/文本位分别转义）。 */
+export function renderMentionHtml(name) {
+    if (!name)
+        throw new TypeError('mention name must be a non-empty string');
+    return (`<b class="at-who" contenteditable="false" data-userid="${escapeHtmlAttr(name)}" data-type="user">` +
+        `@${escapeHtmlText(name)}</b>`);
+}
+/**
+ * 单遍扫描文本中的 @ 语义 token：
+ *   - `@@` 相邻对 → escape（md 侧表示一个字面 @）
+ *   - 通过左边界 + 名字规则的 `@名字` → mention
+ *   - 其余 `@` 不产出 token（由调用方原样处理）
+ * 供 md→html 与 html→md 两个方向共用，保证双向规则严格镜像。
+ */
+function scanAtTokens(text) {
+    const tokens = [];
+    let i = 0;
+    while (i < text.length) {
+        if (text[i] !== '@') {
+            i += 1;
+            continue;
+        }
+        if (text[i + 1] === '@') {
+            tokens.push({ kind: 'escape', start: i, end: i + 2 });
+            i += 2;
+            continue;
+        }
+        if (i > 0 && isNameChar(text[i - 1])) {
+            i += 1;
+            continue;
+        }
+        let j = i + 1;
+        while (j < text.length && isNameChar(text[j]))
+            j += 1;
+        if (j > i + 1)
+            tokens.push({ kind: 'mention', name: text.slice(i + 1, j), start: i, end: j });
+        i = Math.max(j, i + 1);
+    }
+    return tokens;
+}
+/** 扫描文本中全部合法 mention（跳过 @@ 转义）。 */
+export function findMentions(text) {
+    return scanAtTokens(text).flatMap((token) => token.kind === 'mention' ? [{ name: token.name, start: token.start, end: token.end }] : []);
+}
+/** md 文本片段中「疑似 html 标签」的区域：@ 语义跳过、原样透传（fragment 层不做 md 语法解析的边界）。 */
+const TAG_RE = /<\/?[a-zA-Z][^>]*>/g;
+function replaceAtSemantics(segment) {
+    let out = '';
+    let pos = 0;
+    for (const token of scanAtTokens(segment)) {
+        out += segment.slice(pos, token.start);
+        out += token.kind === 'escape' ? '@' : renderMentionHtml(token.name);
+        pos = token.end;
+    }
+    return out + segment.slice(pos);
+}
+/**
+ * md 文本 → html 语义片段：`@@` → 字面 `@`，合法 `@昵称` → at-who 标记；
+ * 其余内容（含疑似 html 标签区域）原样透传，交给基础转换器（markdown-it）完成。
+ * 注意：本函数不做代码段/链接 URL 等 md 语法识别（见文件头分层约定）。
+ */
+export function mentionMdToHtml(md) {
+    let out = '';
+    let pos = 0;
+    TAG_RE.lastIndex = 0;
+    for (;;) {
+        const match = TAG_RE.exec(md);
+        const segmentEnd = match ? match.index : md.length;
+        out += replaceAtSemantics(md.slice(pos, segmentEnd));
+        if (!match)
+            break;
+        out += match[0];
+        pos = segmentEnd + match[0].length;
+    }
+    return out;
+}
+/**
+ * html 文本 → md 文本：会把命中 mention 规则的字面 `@名字` 加倍为 `@@名字`、
+ * `@@` 字面对加倍为 `@@@@`，使 md→html 重转换后语义不变（round-trip 稳定）；
+ * 不命中规则的 `@`（如邮箱、工单号）原样保留，避免无谓转义噪音。
+ * 与 md→html 的 scanAtTokens 共用同一套规则，双向严格镜像。
+ */
+export function escapeAtLiteralsForMd(text) {
+    let out = '';
+    let pos = 0;
+    for (const token of scanAtTokens(text)) {
+        out += text.slice(pos, token.start);
+        out += token.kind === 'escape' ? '@@@@' : `@@${token.name}`;
+        pos = token.end;
+    }
+    return out + text.slice(pos);
+}
+const B_TAG_RE = /<b\b[^>]*>([\s\S]*?)<\/b\s*>|<\/?[a-zA-Z][^>]*>/gi;
+const CLASS_ATTR_RE = /\bclass\s*=\s*(?:"([^"]*)"|'([^']*)')/i;
+const USERID_ATTR_RE = /\bdata-userid\s*=\s*(?:"([^"]*)"|'([^']*)')/i;
+function classListOf(openTag) {
+    const match = CLASS_ATTR_RE.exec(openTag);
+    if (!match)
+        return [];
+    return (match[1] ?? match[2] ?? '').split(/\s+/);
+}
+/** 判断一个标签串是否为 at-who 标记（`<b>` 且 class 含 at-who）。 */
+export function isAtWhoTag(tagHtml) {
+    const openMatch = /^<b\b[^>]*>/i.exec(tagHtml);
+    return openMatch !== null && classListOf(openMatch[0]).includes('at-who');
+}
+function nicknameFromTag(tagHtml, innerHtml) {
+    const useridMatch = USERID_ATTR_RE.exec(tagHtml);
+    if (useridMatch)
+        return decodeHtmlEntities(useridMatch[1] ?? useridMatch[2] ?? '');
+    const text = decodeHtmlEntities((innerHtml ?? '').replace(/<[^>]+>/g, '')).trim();
+    return text.startsWith('@') ? text.slice(1) : text;
+}
+/**
+ * html 片段 → md 语义片段：
+ *   - at-who 标记 → `@昵称`（data-userid 缺失时回退锚点内文本；禁止降级为 `**粗体**`）
+ *   - 其余标签原样透传（非 at-who 的 `<b>` 不动，交给基础转换器 turndown 处理）
+ *   - 标签之间的文本按 escapeAtLiteralsForMd 规则保护字面 @
+ */
+export function mentionHtmlToMd(html) {
+    let out = '';
+    let pos = 0;
+    let match;
+    B_TAG_RE.lastIndex = 0;
+    while ((match = B_TAG_RE.exec(html)) !== null) {
+        out += escapeAtLiteralsForMd(html.slice(pos, match.index));
+        const isAtWho = isAtWhoTag(match[0]);
+        const nickname = isAtWho ? nicknameFromTag(match[0], match[1]) : '';
+        out += nickname ? `@${nickname}` : match[0];
+        pos = match.index + match[0].length;
+    }
+    out += escapeAtLiteralsForMd(html.slice(pos));
+    return out;
+}
+/** turndown 规则 filter 用：节点是否为 at-who 标记。 */
+export function isAtWhoNode(node) {
+    if (node.nodeName.toUpperCase() !== 'B')
+        return false;
+    return (node.getAttribute('class') ?? '').split(/\s+/).includes('at-who');
+}
+/**
+ * turndown 规则 replacement 用：at-who 节点 → `@昵称`。
+ * data-userid 优先；缺失时回退节点文本（去首 @）。永不产出 `**`。
+ */
+export function atWhoNodeToMd(node) {
+    const userid = node.getAttribute('data-userid');
+    if (userid)
+        return `@${userid}`;
+    const text = (node.textContent ?? '').trim();
+    return text.startsWith('@') ? text : `@${text}`;
+}
+//# sourceMappingURL=mention.js.map

package/dist/richtext/mention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention.js","sourceRoot":"","sources":["../../src/richtext/mention.ts"],"names":[],"mappings":"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"}

package/dist/richtext/mention.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mention.test.d.ts.map

package/dist/richtext/mention.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention.test.d.ts","sourceRoot":"","sources":["../../src/richtext/mention.test.ts"],"names":[],"mappings":""}