base-paint 0.1.0 → 0.2.0

package/dist/spec/text.d.ts

@@ -0,0 +1,157 @@
+/** base-paint/spec/text：复制文本序列化契约（#77 冻结面）。
+ *
+ * B2／AC-5：snapshot 结构化接口不移植，输入对齐 envelope `shape`；
+ * `buildDataText`／`buildLogText` 保留（复制文本来源），并补全旧侧未定义的
+ * `format` 语义（text／json／csv 的转义与空值口径，见文档 §3.4）。
+ *
+ * 依赖红线：只许 `import type`（AC-13）。
+ */
+import type { Envelope } from 'base-link-core';
+export declare const COPY_FORMATS: readonly ["text", "json", "csv"];
+export type CopyFormat = (typeof COPY_FORMATS)[number];
+/** 可序列化形状：envelope 六形状去掉 `fallback`（降级载荷不进复制文本）。
+ *  成员**顺序无语义**（不决定 CSV 行序／遍历序），只有成员集有效。 */
+export declare const SERIALIZABLE_SHAPES: readonly ["stat", "list", "detail", "analysis", "receipt"];
+export type SerializableShape = (typeof SERIALIZABLE_SHAPES)[number];
+export type SerializableEnvelope = Envelope<SerializableShape>;
+/** 6 段日志段序（逐字对齐旧 §6.1：①场景标识②AI思考链③数据结构④调用链⑤时间戳版本⑥异常）。 */
+export declare const LOG_SECTIONS: readonly ["scene", "thinking", "dataStructure", "callChain", "timestampVersion", "exception"];
+export type LogSection = (typeof LOG_SECTIONS)[number];
+export declare const LOG_SECTION_TITLES: Readonly<{
+    readonly scene: "场景标识";
+    readonly thinking: "AI 思考链";
+    readonly dataStructure: "数据结构";
+    readonly callChain: "调用链";
+    readonly timestampVersion: "时间戳版本";
+    readonly exception: "异常";
+}>;
+/** 旧 `data.copy_log` 的五字段（新架构 camelCase，由技能包显式传入）。 */
+export interface CopyLogFields {
+    readonly thinking?: string;
+    readonly dataStructure?: string;
+    readonly callChain?: string;
+    readonly timestamp?: string;
+    readonly exception?: string;
+}
+/** 6 段日志 → 数据源（FX-1③）：`scene` 由 **envelope 派生**（`skill`／`key`／`shape`），
+ *  其余 5 段取 `CopyLogFields`；`timestampVersion` ← `copyLog.timestamp`（不是 `timestampVersion` 字段）。 */
+export declare const LOG_SECTION_SOURCES: Readonly<{
+    readonly scene: "envelope";
+    readonly thinking: "copyLog.thinking";
+    readonly dataStructure: "copyLog.dataStructure";
+    readonly callChain: "copyLog.callChain";
+    readonly timestampVersion: "copyLog.timestamp";
+    readonly exception: "copyLog.exception";
+}>;
+export interface DataTextInput {
+    readonly envelope: SerializableEnvelope;
+    /** 缺省 `text`。 */
+    readonly format?: CopyFormat;
+    /** 覆盖输出头；缺省 `TEXT_HEADER_TEMPLATE`（`'【{skill} · {key}】'`）。 */
+    readonly title?: string;
+    /** 时间行；缺省不输出该行。 */
+    readonly occurredAt?: string;
+}
+export interface LogTextInput {
+    readonly envelope: SerializableEnvelope;
+    /** 缺省 `text`。 */
+    readonly format?: CopyFormat;
+    readonly copyLog?: CopyLogFields;
+}
+/** 日志缺省占位（FX-1④）：**只作用于 `text` 口径**；`json` 写 `null`，`csv` 写空串。 */
+export declare const LOG_UNKNOWN_PLACEHOLDER = "(\u672A\u77E5)";
+/** `text` 口径的数据空值占位：**只作用于 `text` 口径**；`json` 保留 `null`，`csv` 写空串。 */
+export declare const TEXT_EMPTY_PLACEHOLDER = "\u672A\u586B\u5199";
+export declare const TEXT_SENSITIVE_MASK = "****";
+/** text 口径输出头（`{skill}`／`{key}` 为替换位，非 HTML 占位符）。 */
+export declare const TEXT_HEADER_TEMPLATE = "\u3010{skill} \u00B7 {key}\u3011";
+/** **敏感行判定口径（FX-23，机读）**：投影行（`metrics`／`item` 的值、`items` 的元素）取值为
+ *  `{ text: string, sensitive: true }` 形态时判为**敏感行**——该形态的**字段名**与旧侧 `_rowText` 一致
+ *  （`base.js:218-221`：`:219` 函数、`:221` 合并掩码行），但**判定语义不同**（FX-30）：
+ *  旧侧是真值判定（`if (r.sensitive)`），本契约只认**字面 `true`**（`flagValue`）。
+ *
+ *  - 判定只看源值的 `flagField` 是否为字面 `flagValue`（`true`），**不看文本内容**；`text` 字段是原文。
+ *  - `EnvelopeDataByShape` 不含该形态 → 它是 **text 层的行值包装**（`data.metrics`／`data.item` 的值、
+ *    `data.items` 的元素），**不改变** envelope 契约，也不进 json 键名（json 口径该键值写 `mask`）。
+ *  - 三种 format 一律输出 `mask`（= `TEXT_SENSITIVE_MASK`）；`text` 口径在该行之后**紧跟一行**
+ *    `textNotice`。
+ *  - **与旧侧的偏离（显式声明）**：旧侧把掩码与提示合成一行 `'****（敏感字段已脱敏）'`（`base.js:221`）；
+ *    新契约拆成「掩码行 ＋ 提示行」，理由是掩码值须能被 `TEXT_SENSITIVE_MASK` 逐值断言、
+ *    且 `json`／`csv` 口径下不得夹中文提示（json 值必须是纯掩码字符串、csv 单元格同）。语义等价：原文一律不出现。
+ */
+export declare const SENSITIVE_ROW_RULE: Readonly<{
+    readonly textField: "text";
+    readonly flagField: "sensitive";
+    readonly flagValue: true;
+    readonly mask: "****";
+    readonly textNotice: "（敏感字段已脱敏）";
+}>;
+/** 逐 shape 投影规格（FX-1①）：envelope `data` → 复制文本结构。 */
+export interface DataProjectionSpec {
+    /** 标题行（`text` 口径输出头；`json`／`csv` 无输出头）。 */
+    readonly header: string;
+    /** 主体行来源：`data` 上的字段名（`stat` 的 metrics 逐键展开、`list` 的 items 逐项展开）。 */
+    readonly body: string;
+    /** 收尾行来源：`data` 上的字段名；无收尾行为 null。 */
+    readonly tail: string | null;
+    /** `csv` 口径下这些行写入 `section` 列的分组名（行序 = body 行 → tail 行）。 */
+    readonly csvSections: readonly string[];
+}
+/** 逐 shape 投影表（FX-1①；数据形态对齐 `EnvelopeDataByShape`）：
+ *  `stat`→metrics 键值行；`list`→逐项行 + `total` 收尾；`detail`→item 字段行；
+ *  `receipt`→状态行 + `message` 行；`analysis`→`summary` 文本行。 */
+export declare const DATA_TEXT_PROJECTIONS: Readonly<{
+    readonly stat: {
+        readonly header: "【{skill} · {key}】";
+        readonly body: "metrics";
+        readonly tail: null;
+        readonly csvSections: readonly ["metrics"];
+    };
+    readonly list: {
+        readonly header: "【{skill} · {key}】";
+        readonly body: "items";
+        readonly tail: "total";
+        readonly csvSections: readonly ["items", "total"];
+    };
+    readonly detail: {
+        readonly header: "【{skill} · {key}】";
+        readonly body: "item";
+        readonly tail: null;
+        readonly csvSections: readonly ["item"];
+    };
+    readonly receipt: {
+        readonly header: "【{skill} · {key}】";
+        readonly body: "ok";
+        readonly tail: "message";
+        readonly csvSections: readonly ["status", "message"];
+    };
+    readonly analysis: {
+        readonly header: "【{skill} · {key}】";
+        readonly body: "summary";
+        readonly tail: null;
+        readonly csvSections: readonly ["summary"];
+    };
+}>;
+export declare const TEXT_JSON_INDENT = 2;
+/** json 口径：文本中 `<` 一律写成反斜杠 + u003c，防 `</script>` 断标签。 */
+export declare const TEXT_JSON_LT_RULE: "u003c";
+/** csv 口径：RFC4180 引号规则 + LF 行尾。 */
+export declare const CSV_DIALECT: Readonly<{
+    readonly delimiter: ",";
+    readonly quote: "\"";
+    readonly quoteEscape: "\"\"";
+    readonly lineEnding: "LF";
+    readonly header: readonly ["section", "row"];
+}>;
+export declare const TEXT_ERROR_CODES: readonly ["shape-unsupported", "structure-invalid", "format-unknown"];
+export type TextErrorCode = (typeof TEXT_ERROR_CODES)[number];
+export interface TextErrorShape {
+    readonly name: 'TextError';
+    readonly code: TextErrorCode;
+    readonly message: string;
+}
+/** 冻结签名：`buildDataText(input: DataTextInput): string`。 */
+export type BuildDataText = (input: DataTextInput) => string;
+/** 冻结签名：`buildLogText(input: LogTextInput): string`。 */
+export type BuildLogText = (input: LogTextInput) => string;
+//# sourceMappingURL=text.d.ts.map

package/dist/spec/text.d.ts.map

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

package/dist/spec/text.js

@@ -0,0 +1,83 @@
+/** base-paint/spec/text：复制文本序列化契约（#77 冻结面）。
+ *
+ * B2／AC-5：snapshot 结构化接口不移植，输入对齐 envelope `shape`；
+ * `buildDataText`／`buildLogText` 保留（复制文本来源），并补全旧侧未定义的
+ * `format` 语义（text／json／csv 的转义与空值口径，见文档 §3.4）。
+ *
+ * 依赖红线：只许 `import type`（AC-13）。
+ */
+export const COPY_FORMATS = ['text', 'json', 'csv'];
+/** 可序列化形状：envelope 六形状去掉 `fallback`（降级载荷不进复制文本）。
+ *  成员**顺序无语义**（不决定 CSV 行序／遍历序），只有成员集有效。 */
+export const SERIALIZABLE_SHAPES = ['stat', 'list', 'detail', 'analysis', 'receipt'];
+/** 6 段日志段序（逐字对齐旧 §6.1：①场景标识②AI思考链③数据结构④调用链⑤时间戳版本⑥异常）。 */
+export const LOG_SECTIONS = ['scene', 'thinking', 'dataStructure', 'callChain', 'timestampVersion', 'exception'];
+export const LOG_SECTION_TITLES = Object.freeze({
+    scene: '场景标识',
+    thinking: 'AI 思考链',
+    dataStructure: '数据结构',
+    callChain: '调用链',
+    timestampVersion: '时间戳版本',
+    exception: '异常',
+});
+/** 6 段日志 → 数据源（FX-1③）：`scene` 由 **envelope 派生**（`skill`／`key`／`shape`），
+ *  其余 5 段取 `CopyLogFields`；`timestampVersion` ← `copyLog.timestamp`（不是 `timestampVersion` 字段）。 */
+export const LOG_SECTION_SOURCES = Object.freeze({
+    scene: 'envelope',
+    thinking: 'copyLog.thinking',
+    dataStructure: 'copyLog.dataStructure',
+    callChain: 'copyLog.callChain',
+    timestampVersion: 'copyLog.timestamp',
+    exception: 'copyLog.exception',
+});
+/** 日志缺省占位（FX-1④）：**只作用于 `text` 口径**；`json` 写 `null`，`csv` 写空串。 */
+export const LOG_UNKNOWN_PLACEHOLDER = '(未知)';
+/** `text` 口径的数据空值占位：**只作用于 `text` 口径**；`json` 保留 `null`，`csv` 写空串。 */
+export const TEXT_EMPTY_PLACEHOLDER = '未填写';
+export const TEXT_SENSITIVE_MASK = '****';
+/** text 口径输出头（`{skill}`／`{key}` 为替换位，非 HTML 占位符）。 */
+export const TEXT_HEADER_TEMPLATE = '【{skill} · {key}】';
+/** **敏感行判定口径（FX-23，机读）**：投影行（`metrics`／`item` 的值、`items` 的元素）取值为
+ *  `{ text: string, sensitive: true }` 形态时判为**敏感行**——该形态的**字段名**与旧侧 `_rowText` 一致
+ *  （`base.js:218-221`：`:219` 函数、`:221` 合并掩码行），但**判定语义不同**（FX-30）：
+ *  旧侧是真值判定（`if (r.sensitive)`），本契约只认**字面 `true`**（`flagValue`）。
+ *
+ *  - 判定只看源值的 `flagField` 是否为字面 `flagValue`（`true`），**不看文本内容**；`text` 字段是原文。
+ *  - `EnvelopeDataByShape` 不含该形态 → 它是 **text 层的行值包装**（`data.metrics`／`data.item` 的值、
+ *    `data.items` 的元素），**不改变** envelope 契约，也不进 json 键名（json 口径该键值写 `mask`）。
+ *  - 三种 format 一律输出 `mask`（= `TEXT_SENSITIVE_MASK`）；`text` 口径在该行之后**紧跟一行**
+ *    `textNotice`。
+ *  - **与旧侧的偏离（显式声明）**：旧侧把掩码与提示合成一行 `'****（敏感字段已脱敏）'`（`base.js:221`）；
+ *    新契约拆成「掩码行 ＋ 提示行」，理由是掩码值须能被 `TEXT_SENSITIVE_MASK` 逐值断言、
+ *    且 `json`／`csv` 口径下不得夹中文提示（json 值必须是纯掩码字符串、csv 单元格同）。语义等价：原文一律不出现。
+ */
+export const SENSITIVE_ROW_RULE = Object.freeze({
+    textField: 'text',
+    flagField: 'sensitive',
+    flagValue: true,
+    mask: TEXT_SENSITIVE_MASK,
+    textNotice: '（敏感字段已脱敏）',
+});
+/** 逐 shape 投影表（FX-1①；数据形态对齐 `EnvelopeDataByShape`）：
+ *  `stat`→metrics 键值行；`list`→逐项行 + `total` 收尾；`detail`→item 字段行；
+ *  `receipt`→状态行 + `message` 行；`analysis`→`summary` 文本行。 */
+export const DATA_TEXT_PROJECTIONS = Object.freeze({
+    stat: { header: TEXT_HEADER_TEMPLATE, body: 'metrics', tail: null, csvSections: ['metrics'] },
+    list: { header: TEXT_HEADER_TEMPLATE, body: 'items', tail: 'total', csvSections: ['items', 'total'] },
+    detail: { header: TEXT_HEADER_TEMPLATE, body: 'item', tail: null, csvSections: ['item'] },
+    receipt: { header: TEXT_HEADER_TEMPLATE, body: 'ok', tail: 'message', csvSections: ['status', 'message'] },
+    analysis: { header: TEXT_HEADER_TEMPLATE, body: 'summary', tail: null, csvSections: ['summary'] },
+});
+export const TEXT_JSON_INDENT = 2;
+/** json 口径：文本中 `<` 一律写成反斜杠 + u003c，防 `</script>` 断标签。 */
+export const TEXT_JSON_LT_RULE = 'u003c';
+/** csv 口径：RFC4180 引号规则 + LF 行尾。 */
+export const CSV_DIALECT = Object.freeze({
+    delimiter: ',',
+    quote: '"',
+    quoteEscape: '""',
+    lineEnding: 'LF',
+    header: ['section', 'row'],
+});
+export const TEXT_ERROR_CODES = ['shape-unsupported', 'structure-invalid', 'format-unknown'];
+//# sourceMappingURL=text.js.map

package/dist/spec/text.js.map

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

package/dist/style.d.ts

@@ -2,7 +2,20 @@
  *
  * 红线：样式只抖 render——改样式只改本文件，link-core/combos/单品包
  * 禁止自带样式常量。类名前缀统一 STYLE_PREFIX，token 表冻结。
+ *
+ * 本文件同时是 **#75 共享样式资产的唯一产出者**（契约 §3.2／§6.2）：
+ * `buildStyleSheet()` 产出的 `css` 即 `<!--SHARED-CSS-->` 的填充物
+ * （`input.assets.sharedCssText`，契约 `docs/base-paint-contract.md:163`）。
+ * 逐条纪律（契约行号）：
+ * - `:root` 的 11 个 token 逐值取 `CSS_VAR_TOKENS`（doc:273-289），**不自造第二份表**（doc:303）；
+ * - 8 个样式区取 `CONTROL_STYLE_SECTIONS` 闭集（doc:295），类名自动加 `prefix`；
+ * - 产出**不含** `STYLE_FORBIDDEN_TOKENS`（Q14）、**不含**深色区（doc:292）；
+ * - `charts` 区文本**复用** `charts.ts` 的唯一产出者 `chartsCss`，**不得重述**（#78 结论）；
+ * - 与既有 `STYLE_TOKENS`（9 个深色 JS token）**并存**、语义互不覆盖（doc:293）；
+ * - `extraCss` 末尾**原样追加**、**不按技能名分支**（doc:299-300），并执行**三禁强制**
+ *   （`:root` 改写／Q14 禁入项／深色区 → 抛不导出的 `StyleSheetError`；D3 修订见 §8.11）。
  */
+import type { BuildStyleSheet } from './spec/style.js';
 export declare const STYLE_PREFIX = "ilife-";
 export declare const STYLE_VERSION = "0.1.0";
 export declare const STYLE_TOKENS: Readonly<{
@@ -21,4 +34,10 @@ export type StyleTokenName = keyof typeof STYLE_TOKENS;
 export declare function cx(...names: Array<string | false | null | undefined>): string;
 /** 取 token（样式消费唯一入口，换肤时单点改）。 */
 export declare function token(name: StyleTokenName): string;
+/** 冻结签名：`buildStyleSheet(input?: StyleSheetInput): StyleSheetOutput`。
+ *
+ *  **同源**：不按技能名分支；任何技能主题差异只能来自调用方显式传入的 `extraCss`（doc:300）。
+ *  `extraCss` **末尾原样追加**（不加工、不转义）；并执行**三禁强制**（D3 修订，见 `assertExtraCss`）：
+ *  命中 `:root`／`STYLE_FORBIDDEN_TOKENS`／深色区任一 → 抛不导出的 `StyleSheetError`（带 `code`）。 */
+export declare const buildStyleSheet: BuildStyleSheet;
 //# sourceMappingURL=style.d.ts.map

package/dist/style.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../src/style.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,YAAY,WAAW,CAAC;AACrC,eAAO,MAAM,aAAa,UAAU,CAAC;AAErC,eAAO,MAAM,YAAY;;;;;;;;;;EAUvB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,YAAY,CAAC;AAEvD,4BAA4B;AAC5B,wBAAgB,EAAE,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,CAE7E;AAED,gCAAgC;AAChC,wBAAgB,KAAK,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAElD"}
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../src/style.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EACV,eAAe,EAKhB,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,YAAY,WAAW,CAAC;AACrC,eAAO,MAAM,aAAa,UAAU,CAAC;AAErC,eAAO,MAAM,YAAY;;;;;;;;;;EAUvB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,YAAY,CAAC;AAEvD,4BAA4B;AAC5B,wBAAgB,EAAE,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,CAE7E;AAED,gCAAgC;AAChC,wBAAgB,KAAK,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAElD;AA44BD;;;;qFAIqF;AACrF,eAAO,MAAM,eAAe,EAAE,eAmB7B,CAAC"}