base-paint 0.3.13 → 0.3.15

package/dist/components/template/markers.js

@@ -0,0 +1,130 @@
+/** template · markers
+ *
+ *  自 `src/template.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑥把 `src/template.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（见 `docs/base/base-render/组件目录架构.md` 本批读数）。
+ */
+import { ASSET_MARKER_KEYS, ASSET_WRAPPERS, CONTAINER_CHECK_RULE, STRICT_ENVELOPE_FIELDS, STRICT_ENVELOPE_SHAPES, TEMPLATE_KINDS, TEMPLATE_KIND_RULE, TEMPLATE_MARKERS, WRAP_PREDICATES } from '../../spec/template.js';
+export const MARKER_KEYS = Object.keys(TEMPLATE_MARKERS);
+/** 包裹标签（唯一真相源 `ASSET_WRAPPERS`；本文件不写 `<style>`／`<script>` 字面量）。 */
+export const WRAP_OPEN_TAGS = Object.values(ASSET_WRAPPERS).map((w) => w.openTag);
+export const WRAP_CLOSE_TAGS = Object.values(ASSET_WRAPPERS).map((w) => w.closeTag);
+/** 标签名形式（`<style>` → `style`），供不变量②的 `enclosing-open-tag` 判定使用。 */
+const WRAP_TAG_NAMES = [...new Set(WRAP_OPEN_TAGS.map((tag) => tag.slice(1, -1)))];
+/** 资产键 → 标记键（查 `ASSET_MARKER_KEYS`，不自立第二份映射表）。 */
+export function assetKeyForMarker(marker) {
+    const keys = Object.keys(ASSET_MARKER_KEYS);
+    for (const key of keys) {
+        if (ASSET_MARKER_KEYS[key] === marker)
+            return key;
+    }
+    return null;
+}
+/** 逐字出现次数（区分大小写；契约标记为逐字匹配）。 */
+function countOccurrences(text, literal) {
+    let count = 0;
+    let index = text.indexOf(literal);
+    while (index >= 0) {
+        count += 1;
+        index = text.indexOf(literal, index + literal.length);
+    }
+    return count;
+}
+/** 替换**首个**出现处。
+ *
+ * 用 `indexOf` + 拼接而**不用** `String.prototype.replace`：后者会把替换文本里的
+ * `$&`／`$'`／`$\`` 当替换模式，资产文本或 JSON 载荷含这些字符时会被改写。
+ */
+export function replaceFirst(text, literal, replacement) {
+    const index = text.indexOf(literal);
+    if (index < 0)
+        return text;
+    return text.slice(0, index) + replacement + text.slice(index + literal.length);
+}
+/** 六标记计数（键序恒 `TEMPLATE_MARKERS`）。 */
+export function countMarkers(template) {
+    const counts = {};
+    for (const key of MARKER_KEYS)
+        counts[key] = countOccurrences(template, TEMPLATE_MARKERS[key]);
+    return counts;
+}
+/** 分型判定（恒读 `TEMPLATE_KIND_RULE`）：`required` 各恰 1 次且 `forbidden` 各 0 次。
+ *
+ * 计数 > 1 的模板**不属分型判定面**（规则只对 0／1 次计数试配）→ 返回 `null`，
+ * 由 `TEMPLATE_CHECK_ORDER` 的首个命中码报错（计数 > 1 → `marker-duplicate`）。
+ */
+export function kindOf(counts) {
+    const hits = TEMPLATE_KINDS.filter((kind) => {
+        const rule = TEMPLATE_KIND_RULE[kind];
+        return rule.required.every((m) => counts[m] === 1) && rule.forbidden.every((m) => counts[m] === 0);
+    });
+    return hits.length === 1 ? hits[0] : null;
+}
+/** 不变量②判定（`WRAP_PREDICATES.forbidPreWrappedMarker`，方式 `enclosing-open-tag`）。
+ *
+ * 作用域 = `ASSET_MARKER_KEYS` 的值集（三个共享资产标记），**排除 `injectData`**
+ * （payload 容器是必需项、不是预包裹）；对**每一个**标记出现处扫描其**左侧全部前缀文本**
+ * （不限同行），最近的未闭合包裹开标签存在即违反。返回首个违反的标记键。
+ */
+export function preWrappedMarker(template) {
+    const predicate = WRAP_PREDICATES.forbidPreWrappedMarker;
+    const excluded = predicate.excludes;
+    for (const marker of predicate.scope) {
+        if (excluded.includes(marker))
+            continue;
+        const literal = TEMPLATE_MARKERS[marker];
+        for (let index = template.indexOf(literal); index >= 0; index = template.indexOf(literal, index + literal.length)) {
+            const before = template.slice(0, index);
+            const enclosed = WRAP_TAG_NAMES.some((name) => before.lastIndexOf('<' + name) > before.lastIndexOf('</' + name));
+            if (enclosed)
+                return marker;
+        }
+    }
+    return null;
+}
+/** 容器定位（契约 §3.1 第 2 条 ＋ FX-118-11 的 F-2 处置）：取标记**左侧最近的未闭合开标签**，
+ *  标签名恒取 `CONTAINER_CHECK_RULE.openTag`（页内已闭合的业务 `<script>` 不算容器）。
+ *  返回该标签的 `id`／`type`（双引号口径）；无容器返回 `null`。
+ */
+export function locateContainer(template, markerIndex) {
+    const tagName = CONTAINER_CHECK_RULE.openTag.slice(1, -1);
+    const before = template.slice(0, markerIndex);
+    const openIndex = before.lastIndexOf('<' + tagName);
+    if (openIndex < 0)
+        return null;
+    if (before.lastIndexOf(CONTAINER_CHECK_RULE.closeTag) > openIndex)
+        return null;
+    const end = template.indexOf('>', openIndex);
+    const tag = end < 0 ? template.slice(openIndex) : template.slice(openIndex, end + 1);
+    const attribute = (name) => {
+        const hit = new RegExp('(?:^|\\s)' + name + '\\s*=\\s*"([^"]*)"').exec(tag);
+        return hit ? hit[1] : null;
+    };
+    return { id: attribute('id'), type: attribute('type') };
+}
+/** 零依赖信封校验（`strict: true` 时追加）：`data` 是对象且含五字段、`shape` ∈ 六形状。
+ *  **不调用** base-link-core 的 `parseEnvelope`（AC-13）。 */
+export function isEnvelopeLike(data) {
+    if (data === null || typeof data !== 'object' || Array.isArray(data))
+        return false;
+    const record = data;
+    for (const field of STRICT_ENVELOPE_FIELDS) {
+        if (!Object.prototype.hasOwnProperty.call(record, field))
+            return false;
+    }
+    const shape = record.shape;
+    return typeof shape === 'string' && STRICT_ENVELOPE_SHAPES.includes(shape);
+}
+/** 输出 HTML 的 UTF-8 字节数（对齐旧 CLI 结果 JSON 的 `bytes` 口径）。
+ *  用 `TextEncoder` 而非 `Buffer`：base-paint 是浏览器侧共享层，不依赖 Node 内建全局。 */
+export function utf8Bytes(text) {
+    return new TextEncoder().encode(text).length;
+}
+/** 统一占位符填充器（冻结签名 `(input: FillTemplateInput): FillTemplateOutput`）。
+ *
+ * 判定按 `TEMPLATE_CHECK_ORDER` 逐阶段进行，**首个命中即抛、不聚合**；全部通过后按
+ * `INJECTION_ORDER` 依次替换四个注入步（资产由本填充器按 `ASSET_WRAPPERS` 包裹），
+ * 最后替换正文槽位（`content` 不占 `INJECTION_ORDER` 的位置，载荷槽两成员互斥，
+ * 故与四个注入步**无先后语义**，契约 §3.1.2①）。
+ */

package/dist/components/template/markers.js.map

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

package/dist/components/template/shared.d.ts

@@ -0,0 +1,20 @@
+/** template · shared
+ *
+ *  自 `src/template.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑥把 `src/template.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（见 `docs/base/base-render/组件目录架构.md` 本批读数）。
+ */
+import { TemplateErrorCode, TemplateMarkerKey } from '../../spec/template.js';
+export declare class TemplateError extends Error {
+    /** 逐字对齐 `TemplateErrorShape.name`。 */
+    readonly name = "TemplateError";
+    readonly code: TemplateErrorCode;
+    /** 归因标记（能唯一定位时给出；载荷槽／信封级失败不给）。 */
+    readonly marker?: TemplateMarkerKey;
+    constructor(code: TemplateErrorCode, message: string, marker?: TemplateMarkerKey);
+}
+/** 抛错并收窄控制流（`never` 返回，便于 TS 在断言后收窄）。 */
+export declare function fail(code: TemplateErrorCode, message: string, marker?: TemplateMarkerKey): never;
+/** 六个标记的规范序（恒取 `TEMPLATE_MARKERS` 键序，不自立第二份顺序）。 */
+//# sourceMappingURL=shared.d.ts.map

package/dist/components/template/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/components/template/shared.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE9E,qBAAa,aAAc,SAAQ,KAAK;IACtC,sCAAsC;IACtC,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,kCAAkC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;gBAExB,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB;CAKjF;AAED,yCAAyC;AACzC,wBAAgB,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,KAAK,CAEhG;AAED,mDAAmD"}

package/dist/components/template/shared.js

@@ -0,0 +1,25 @@
+/** template · shared
+ *
+ *  自 `src/template.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑥把 `src/template.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（见 `docs/base/base-render/组件目录架构.md` 本批读数）。
+ */
+export class TemplateError extends Error {
+    /** 逐字对齐 `TemplateErrorShape.name`。 */
+    name = 'TemplateError';
+    code;
+    /** 归因标记（能唯一定位时给出；载荷槽／信封级失败不给）。 */
+    marker;
+    constructor(code, message, marker) {
+        super(message);
+        this.code = code;
+        if (marker !== undefined)
+            this.marker = marker;
+    }
+}
+/** 抛错并收窄控制流（`never` 返回，便于 TS 在断言后收窄）。 */
+export function fail(code, message, marker) {
+    throw new TemplateError(code, message, marker);
+}
+/** 六个标记的规范序（恒取 `TEMPLATE_MARKERS` 键序，不自立第二份顺序）。 */

package/dist/components/template/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/components/template/shared.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,sCAAsC;IAC7B,IAAI,GAAG,eAAe,CAAC;IACvB,IAAI,CAAoB;IACjC,kCAAkC;IACzB,MAAM,CAAqB;IAEpC,YAAY,IAAuB,EAAE,OAAe,EAAE,MAA0B;QAC9E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACjD,CAAC;CACF;AAED,yCAAyC;AACzC,MAAM,UAAU,IAAI,CAAC,IAAuB,EAAE,OAAe,EAAE,MAA0B;IACvF,MAAM,IAAI,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC;AAED,mDAAmD"}

package/dist/components/text/api.d.ts

@@ -0,0 +1,14 @@
+/** text · api
+ *
+ *  自 `src/text.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑥把 `src/text.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（见 `docs/base/base-render/组件目录架构.md` 本批读数）。
+ */
+import { DataTextInput, LogTextInput } from '../../spec/text.js';
+/** 数据文本：envelope 逐 shape 投影 → `text`／`json`／`csv`。失败抛 `TextError`（不返空、不降级）。 */
+export declare function buildDataText(input: DataTextInput): string;
+/** 日志文本：6 段（1 段 envelope 派生 ＋ 5 段 `CopyLogFields`）→ `text`／`json`／`csv`。
+ *  结构校验与 `buildDataText` **同口径**（U14 定案：`data` 不符 shape 同样抛 `structure-invalid`）。 */
+export declare function buildLogText(input: LogTextInput): string;
+//# sourceMappingURL=api.d.ts.map

package/dist/components/text/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/components/text/api.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EAAyB,aAAa,EAA6D,YAAY,EAA8C,MAAM,oBAAoB,CAAC;AAI/L,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAgC1D;AAED;qFACqF;AACrF,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAsBxD"}

package/dist/components/text/api.js

@@ -0,0 +1,76 @@
+/** text · api
+ *
+ *  自 `src/text.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑥把 `src/text.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（见 `docs/base/base-render/组件目录架构.md` 本批读数）。
+ */
+import { csvText, dataCsvRows, jsonText, maskData } from './formats.js';
+import { asRecord, describeValue, optionalString, requireShapeData, resolveCopyLog, resolveFormat, resolveShape } from './input.js';
+import { logTexts } from './log.js';
+import { dataRows, headerLine, sanitizeLine } from './rows.js';
+import { CSV_EMPTY, LF, TIME_LABEL, fail } from './shared.js';
+import { DATA_TEXT_PROJECTIONS, LOG_SECTIONS, LOG_SECTION_TITLES, LOG_UNKNOWN_PLACEHOLDER, SENSITIVE_ROW_RULE, TEXT_EMPTY_PLACEHOLDER } from '../../spec/text.js';
+/* ── 出口 ───────────────────────────────────────────────────── */
+/** 数据文本：envelope 逐 shape 投影 → `text`／`json`／`csv`。失败抛 `TextError`（不返空、不降级）。 */
+export function buildDataText(input) {
+    const record = asRecord(input);
+    if (record === null)
+        fail('structure-invalid', '入参必须是对象（DataTextInput），实为 ' + describeValue(input));
+    const format = resolveFormat(record.format);
+    const envelope = asRecord(record.envelope);
+    if (envelope === null)
+        fail('structure-invalid', 'envelope 必须是对象，实为 ' + describeValue(record.envelope));
+    const shape = resolveShape(envelope.shape);
+    const title = optionalString(record.title, 'title');
+    const occurredAt = optionalString(record.occurredAt, 'occurredAt');
+    const data = requireShapeData(shape, envelope.data);
+    const projection = DATA_TEXT_PROJECTIONS[shape];
+    if (format === 'json') {
+        return jsonText({
+            version: envelope.version,
+            skill: envelope.skill,
+            shape,
+            key: envelope.key,
+            data: maskData(projection, data),
+        });
+    }
+    const rows = dataRows(projection, data, format === 'csv' ? CSV_EMPTY : TEXT_EMPTY_PLACEHOLDER);
+    if (format === 'csv')
+        return csvText(dataCsvRows(projection, rows));
+    const lines = [sanitizeLine(headerLine(envelope, title))];
+    if (occurredAt !== undefined)
+        lines.push(sanitizeLine(TIME_LABEL + occurredAt));
+    for (const row of rows.tail === null ? rows.body : [...rows.body, rows.tail]) {
+        lines.push(sanitizeLine(row.text));
+        if (row.sensitive)
+            lines.push(SENSITIVE_ROW_RULE.textNotice);
+    }
+    return lines.join(LF);
+}
+/** 日志文本：6 段（1 段 envelope 派生 ＋ 5 段 `CopyLogFields`）→ `text`／`json`／`csv`。
+ *  结构校验与 `buildDataText` **同口径**（U14 定案：`data` 不符 shape 同样抛 `structure-invalid`）。 */
+export function buildLogText(input) {
+    const record = asRecord(input);
+    if (record === null)
+        fail('structure-invalid', '入参必须是对象（LogTextInput），实为 ' + describeValue(input));
+    const format = resolveFormat(record.format);
+    const envelope = asRecord(record.envelope);
+    if (envelope === null)
+        fail('structure-invalid', 'envelope 必须是对象，实为 ' + describeValue(record.envelope));
+    const shape = resolveShape(envelope.shape);
+    const copyLog = resolveCopyLog(record.copyLog);
+    requireShapeData(shape, envelope.data);
+    const texts = logTexts(envelope, shape, copyLog);
+    if (format === 'json')
+        return jsonText(texts);
+    if (format === 'csv') {
+        return csvText(LOG_SECTIONS.map((section) => [section, texts[section] ?? '']));
+    }
+    const lines = [];
+    for (const section of LOG_SECTIONS) {
+        lines.push(sanitizeLine(LOG_SECTION_TITLES[section]));
+        lines.push(sanitizeLine(texts[section] ?? LOG_UNKNOWN_PLACEHOLDER));
+    }
+    return lines.join(LF);
+}

package/dist/components/text/api.js.map

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

package/dist/components/text/formats.d.ts

@@ -0,0 +1,30 @@
+/** text · formats
+ *
+ *  自 `src/text.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑥把 `src/text.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（见 `docs/base/base-render/组件目录架构.md` 本批读数）。
+ */
+import { DataRows } from './shared.js';
+import { DataProjectionSpec } from '../../spec/text.js';
+/** `JSON.stringify` 的统一包装（**三 format 共用**；`prefix` 只用于辨因文案）：
+ *
+ *  - **`undefined` → `null`（保留键）**：JSON 无 `undefined` 值，`JSON.stringify` 默认**丢键**，
+ *    与 `contract:609`「空值保留 `null`、键不省略」冲突（FX-77-1）。`json` 口径的整串与
+ *    `text`／`csv` 口径的对象值（§3.4.1「对象／数组 → `JSON.stringify`」）同口径归一，
+ *    故**同一输入的三 format 键集一一对应**（含嵌套对象）。
+ *  - **`BigInt` 显式判因**：不依赖运行时文案（`typeof item === 'bigint'` 直接判），仍抛
+ *    `structure-invalid`（不静默写 `null`）。
+ *  - 其余不可序列化（循环引用等）→ `structure-invalid`，`message` 按因区分。
+ */
+export declare function stringifyJson(value: unknown, prefix: string, indent?: number): string | undefined;
+/** `json` 口径：缩进恒取 `TEXT_JSON_INDENT`，`<` 一律写成反斜杠 + `TEXT_JSON_LT_RULE`。 */
+export declare function jsonText(value: unknown): string;
+/** `json` 口径的 `data`：按投影值位置把敏感行换成 `mask`，其余原样透传（空值保留 `null`）。
+ *  收尾字段**缺省**（`undefined`）时**删键**（U1：缺省 ≠ 空值；`json` 省略该键，与 `text`／`csv` 省略该行一致）。 */
+export declare function maskData(projection: DataProjectionSpec, data: Record<string, unknown>): Record<string, unknown>;
+/** `csv` 口径：表头恒为 `CSV_DIALECT.header`，行尾恒取 `CSV_DIALECT.lineEnding`。 */
+export declare function csvText(rows: readonly (readonly [string, string])[]): string;
+/** `csv` 行序 = 主体行 → 收尾行；`section` 列逐行取投影表 `csvSections`（`contract:619`）。 */
+export declare function dataCsvRows(projection: DataProjectionSpec, rows: DataRows): [string, string][];
+//# sourceMappingURL=formats.d.ts.map

package/dist/components/text/formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../../src/components/text/formats.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAM,QAAQ,EAAuB,MAAM,aAAa,CAAC;AAChE,OAAO,EAAe,kBAAkB,EAA2D,MAAM,oBAAoB,CAAC;AAa9H;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYjG;AAED,2EAA2E;AAC3E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI/C;AAOD;oFACoF;AACpF,wBAAgB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgB/G;AAuBD,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,GAAG,MAAM,CAM5E;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,UAAU,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAM9F"}

package/dist/components/text/formats.js

@@ -0,0 +1,120 @@
+/** text · formats
+ *
+ *  自 `src/text.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑥把 `src/text.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（见 `docs/base/base-render/组件目录架构.md` 本批读数）。
+ */
+import { asRecord } from './input.js';
+import { isSensitive } from './rows.js';
+import { CR, LF, TextError, fail } from './shared.js';
+import { CSV_DIALECT, SENSITIVE_ROW_RULE, TEXT_JSON_INDENT, TEXT_JSON_LT_RULE } from '../../spec/text.js';
+/* ── 三种 format 的编码器 ───────────────────────────────────── */
+/** 不可 JSON 序列化的**原因文案**（一码多义由 `message` 辨因，§3.1.2⑤ 同口径）：
+ *  `BigInt` 与循环引用**不同因不同文**（FX-77-8：不得把 `BigInt` 误写成「循环引用」）。 */
+function jsonFailReason(error) {
+    const text = error instanceof Error ? error.message : String(error);
+    if (text.indexOf('circular') >= 0)
+        return '循环引用';
+    if (text.indexOf('BigInt') >= 0)
+        return 'BigInt 等非 JSON 值';
+    return '含非 JSON 值';
+}
+/** `JSON.stringify` 的统一包装（**三 format 共用**；`prefix` 只用于辨因文案）：
+ *
+ *  - **`undefined` → `null`（保留键）**：JSON 无 `undefined` 值，`JSON.stringify` 默认**丢键**，
+ *    与 `contract:609`「空值保留 `null`、键不省略」冲突（FX-77-1）。`json` 口径的整串与
+ *    `text`／`csv` 口径的对象值（§3.4.1「对象／数组 → `JSON.stringify`」）同口径归一，
+ *    故**同一输入的三 format 键集一一对应**（含嵌套对象）。
+ *  - **`BigInt` 显式判因**：不依赖运行时文案（`typeof item === 'bigint'` 直接判），仍抛
+ *    `structure-invalid`（不静默写 `null`）。
+ *  - 其余不可序列化（循环引用等）→ `structure-invalid`，`message` 按因区分。
+ */
+export function stringifyJson(value, prefix, indent) {
+    try {
+        return JSON.stringify(value, (_key, item) => {
+            if (typeof item === 'bigint') {
+                fail('structure-invalid', prefix + '不可 JSON 序列化（BigInt 等非 JSON 值）');
+            }
+            return item === undefined ? null : item;
+        }, indent);
+    }
+    catch (error) {
+        if (error instanceof TextError)
+            throw error;
+        fail('structure-invalid', prefix + '不可 JSON 序列化（' + jsonFailReason(error) + '）');
+    }
+}
+/** `json` 口径：缩进恒取 `TEXT_JSON_INDENT`，`<` 一律写成反斜杠 + `TEXT_JSON_LT_RULE`。 */
+export function jsonText(value) {
+    const text = stringifyJson(value, '载荷', TEXT_JSON_INDENT);
+    if (text === undefined)
+        fail('structure-invalid', '载荷不可 JSON 序列化');
+    return text.split('<').join(String.fromCharCode(92) + TEXT_JSON_LT_RULE);
+}
+/** 敏感行在 `json` 口径写 `mask`（不写 `null`、不进第二套键名）。 */
+function maskValue(value) {
+    return isSensitive(value) ? SENSITIVE_ROW_RULE.mask : value;
+}
+/** `json` 口径的 `data`：按投影值位置把敏感行换成 `mask`，其余原样透传（空值保留 `null`）。
+ *  收尾字段**缺省**（`undefined`）时**删键**（U1：缺省 ≠ 空值；`json` 省略该键，与 `text`／`csv` 省略该行一致）。 */
+export function maskData(projection, data) {
+    const out = { ...data };
+    const body = data[projection.body];
+    if (Array.isArray(body)) {
+        out[projection.body] = body.map(maskValue);
+    }
+    else {
+        const map = asRecord(body);
+        out[projection.body] = map === null
+            ? maskValue(body)
+            : Object.fromEntries(Object.entries(map).map(([key, item]) => [key, maskValue(item)]));
+    }
+    if (projection.tail !== null) {
+        if (data[projection.tail] === undefined)
+            delete out[projection.tail];
+        else
+            out[projection.tail] = maskValue(data[projection.tail]);
+    }
+    return out;
+}
+/** `csv` 字段编码：RFC4180——含分隔符／引号／换行（CR 或 LF）时用引号包裹，内部引号写成双写。 */
+function csvField(value) {
+    const needsQuote = value.includes(CSV_DIALECT.delimiter)
+        || value.includes(CSV_DIALECT.quote)
+        || value.includes(CR)
+        || value.includes(LF);
+    if (!needsQuote)
+        return value;
+    return CSV_DIALECT.quote
+        + value.split(CSV_DIALECT.quote).join(CSV_DIALECT.quoteEscape)
+        + CSV_DIALECT.quote;
+}
+/** `csv` 行尾：恒读冻结常量 `CSV_DIALECT.lineEnding`（机读名 → 实际字符，不留未消费常量）。
+ *  未知取值 → `structure-invalid`（显式失败，不静默退回某个行尾）。 */
+function csvLineEnding() {
+    const name = CSV_DIALECT.lineEnding;
+    if (name === 'LF')
+        return LF;
+    if (name === 'CRLF')
+        return CR + LF;
+    fail('structure-invalid', 'CSV_DIALECT.lineEnding 取值未定义：' + name);
+}
+/** `csv` 口径：表头恒为 `CSV_DIALECT.header`，行尾恒取 `CSV_DIALECT.lineEnding`。 */
+export function csvText(rows) {
+    const lines = [CSV_DIALECT.header.map(csvField).join(CSV_DIALECT.delimiter)];
+    for (const [section, row] of rows) {
+        lines.push([section, row].map(csvField).join(CSV_DIALECT.delimiter));
+    }
+    return lines.join(csvLineEnding());
+}
+/** `csv` 行序 = 主体行 → 收尾行；`section` 列逐行取投影表 `csvSections`（`contract:619`）。 */
+export function dataCsvRows(projection, rows) {
+    const out = [];
+    const bodySection = projection.csvSections[0];
+    for (const row of rows.body)
+        out.push([bodySection, row.text]);
+    if (rows.tail !== null)
+        out.push([projection.csvSections[1], rows.tail.text]);
+    return out;
+}

package/dist/components/text/formats.js.map

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

package/dist/components/text/index.d.ts

@@ -0,0 +1,8 @@
+/** text 组件族出口：由 `src/text.ts` 的 export 行**自动生成**（3 个名字）。
+ *
+ *  **为什么逐名列**：跨件共用的小件在搬家里必须补 `export`，`export *` 会把它们带出去、
+ *  改变 `dist/text.js` 的出口集合。
+ */
+export { buildDataText, buildLogText } from './api.js';
+export { TextError } from './shared.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/text/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/text/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/components/text/index.js

@@ -0,0 +1,7 @@
+/** text 组件族出口：由 `src/text.ts` 的 export 行**自动生成**（3 个名字）。
+ *
+ *  **为什么逐名列**：跨件共用的小件在搬家里必须补 `export`，`export *` 会把它们带出去、
+ *  改变 `dist/text.js` 的出口集合。
+ */
+export { buildDataText, buildLogText } from './api.js';
+export { TextError } from './shared.js';

package/dist/components/text/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/text/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/components/text/input.d.ts

@@ -0,0 +1,27 @@
+/** text · input
+ *
+ *  自 `src/text.ts` 原样切出。
+ *
+ *  **住址**：目录化批次⑥把 `src/text.ts` 按段切成「族内一件一文件」，正文原样搬来；
+ *  搬迁判据＝产物逐字节相同（见 `docs/base/base-render/组件目录架构.md` 本批读数）。
+ */
+import { CopyFormat, SerializableShape } from '../../spec/text.js';
+/** 纯对象收窄（数组与 `null` 不算对象）。 */
+export declare function asRecord(value: unknown): Record<string, unknown> | null;
+/** 错误文案里的值描述（一码多义由 `message` 辨因，§3.1.2⑤ 同口径）。 */
+export declare function describeValue(value: unknown): string;
+/** `format` 闭集判定（缺省 `text`）；不在 `COPY_FORMATS` 内 → `format-unknown`。 */
+export declare function resolveFormat(value: unknown): CopyFormat;
+/** `shape` 闭集判定：不在 `SERIALIZABLE_SHAPES`（含 `fallback`）→ `shape-unsupported`。 */
+export declare function resolveShape(value: unknown): SerializableShape;
+/** `title`／`occurredAt` 类型校验（非字符串 → `structure-invalid`；缺省放行）。 */
+export declare function optionalString(value: unknown, field: string): string | undefined;
+/** 逐 shape 结构校验（判据逐条对齐 `contract:624`，恒以 `EnvelopeDataByShape[shape]` 为准）。
+ *
+ * **不校验** `stat.metrics` 的逐值类型：敏感行包装 `{ text, sensitive: true }` 必须放行
+ * （`contract:612`／`:615`，FX-23），故只判容器形态。
+ */
+export declare function requireShapeData(shape: SerializableShape, value: unknown): Record<string, unknown>;
+/** `copyLog` 形态校验：整体非对象／字段非字符串 → `structure-invalid`（`null`／`undefined` 视同缺失）。 */
+export declare function resolveCopyLog(value: unknown): Record<string, unknown> | null;
+//# sourceMappingURL=input.d.ts.map

package/dist/components/text/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../src/components/text/input.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAgB,UAAU,EAAuB,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAItG,8BAA8B;AAC9B,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAIvE;AAED,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKpD;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAOxD;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAM9D;AAED,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMhF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsClG;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAa7E"}