base-paint 0.1.0 → 0.2.0

package/dist/charts.d.ts

@@ -0,0 +1,62 @@
+/** base-paint/charts：#78 图表层运行时（契约 §3.5／§6.5）。
+ *
+ * 落地冻结面里 #78 的三条运行时出口：`charts`（8 方法）／`buildChartsHelpersJs`；
+ * `ChartError` 与本文件**不**从 `src/index.ts` 导出（冻结面 44 条内无该运行时条目，
+ * 与 `TemplateError`／`ControlsError` 同口径：调用方按 `name === 'ChartError'` ＋ `code` 判定）。
+ *
+ * 三条硬边界（逐条对齐 §3.5／§6.5，违反即红）：
+ *  1. **纯 CSS + SVG 字符串**（§3.5.1「工程约束」）：无 `<canvas>`、无产出内联 `<script>`／`onclick=`、
+ *     无 `node:`、零第三方；交互一律走 `actionId`（渲染期写入 `ACTION_ID_ATTR`）。
+ *  2. **模块自身零 DOM**（R8）：本文件代码里不出现 `document.`／`window.`／`globalThis.`——
+ *     DOM 只允许出现在 `buildChartsHelpersJs` **产出的 JS 文本**里（`SHARED_HELPERS_JS_RULE.domAllowed`）。
+ *  3. **坐标唯一**（`CHART_COORD_RULE = 'viewBox-only'`）：容器零 padding（CSS 里 `.…-charts{padding:0}`），
+ *     留白全部进 viewBox；描边元素带 `vector-effect="non-scaling-stroke"`。
+ *     旧版「SVG viewBox ＋ HTML 百分比覆盖层」双层体系（`charts.js:560,572,583,604,618,645,649,870`）
+ *     与 DOM 校准（`charts.js:779-795`）**不复刻**（R19）——新实现把数据点／数值／刻度／标注
+ *     全部放进同一 viewBox，物理对齐由同一映射函数保证。
+ *
+ * 选项级语义（契约登记为「不冻结也不排除」，owner = #78）以 `docs/research/t92-old-v130-signatures.md:162-178`
+ * 与 `.scratch/t78/old-baseline.md` §2 旧行为为准，逐字段在 `.scratch/t78/a1-evidence.md` 对照。
+ *
+ * 文档未规定处的取值（本文显式记账，不留暗猜）：
+ *  - 各 kind 缺省 viewBox 尺寸（旧版桌面缺省高度：柱／组合 170、折线 210、donut 150、gauge 170×105、
+ *    sparkline 90×30；`old-baseline.md` §3.2）与折线点直径 7、scatter 点直径 9（旧 `dotSize||9`）；
+ *  - 空态默认文案 = 冻结 `STATUS_DEFAULT_TEXT.empty`（旧版「暂无数据」；不新造第二份文案常量），
+ *    图标 📊 与提示「有记录后自动生成图表」沿用旧基线（纯 UI 文案，非契约常量）；
+ *  - `dotStyle`／`line.dotSize`／`combo.tooltip` 旧版是死参数，按 R21 实现为**新能力**：
+ *    `dotStyle` = 数据点内联 `style` 文本（逐点样式覆盖），`dotSize` = 点直径，`tooltip` = `data-tip` 数据属性；
+ *  - `avgLine(n)` = 旧语义的**均线序列**（窗口收敛 `3..items.length`，`old-baseline.md` §2.2），
+ *    不是水平线；`emptyText`／`compact`／`bar.grid` 旧版是死参数，按冻结类型补齐为有效选项；
+ *  - `prefix` 覆盖只影响 `buildChartsHelpersJs` **产出的 CSS 文本**；`charts.*` 产出的 HTML 恒用
+ *    `STYLE_PREFIX` 命名空间（与 `SharedHelpersInput.dataAttr` 覆盖口径同构，不一致由调用方自负）。
+ */
+import type { BuildChartsHelpersJs, ChartErrorCode, ChartsApi } from './spec/index.js';
+/** 图表层错误。**不**从 `src/index.ts` 导出：调用方按 `name === 'ChartError'` ＋ `code` 判定。 */
+export declare class ChartError extends Error {
+    readonly code: ChartErrorCode;
+    constructor(code: ChartErrorCode, message: string);
+}
+/** 冻结签名：`ChartsApi`（8 方法，去掉旧 `el` 参数，DOM 由调用方挂载）。
+ *  派表按 `ChartKind` 键入（`satisfies ChartDispatch` 已在编译期校验 8 个键与签名）；
+ *  **JS 调用方**访问表外 key（如 `charts['pie']`）→ 调用即抛 `ChartError` code `kind-unknown`
+ *  （类型层不可达，R15）。导出类型 = 冻结 `ChartsApi`，**不用 `as` 断言**（FX-78-A1b-15）。 */
+export declare const charts: ChartsApi;
+/** 图表样式文本（**唯一一份**）：类名走 `prefix` 命名空间；容器零 padding；
+ *  断点数值逐值取 `CHART_BREAKPOINTS`（`mobileMaxPx`／`dotSizeMobilePx`／`lineHeightMobilePx`）。
+ *
+ *  **#75 复用点**：`buildStyleSheet()` 的 `charts` 样式区直接引用本函数产出，
+ *  **不得**在别处重述图表 CSS 文本（#78 结论，违反即 S1）。
+ *  本函数**不从 `src/index.ts` 导出**——冻结面无该条目，导出会打破
+ *  「新增运行时出口恰好等于清单 implemented 的运行时项」出口面锁（同 `ChartError` 口径）。 */
+export declare function chartsCss(prefix: string): string;
+/** 冻结签名：`buildChartsHelpersJs(input?: ChartsHelpersInput): string`。
+ *
+ *  产出恒为**非空**、**经典 script** 作用域可跑的 IIFE（无 `import`／`export`／顶层 `await`），
+ *  逐项满足 `SHARED_HELPERS_JS_RULE`：自包含（不依赖其它脚本或既有全局）／幂等（判据**只落 DOM**：
+ *  `getElementById(styleId)` 早退，**不**用全局哨兵）／允许页面侧 DOM（`document.*`）／
+ *  不向 `window.<id>`／`globalThis.<id>` 赋值／不引 `node:`。
+ *
+ *  首步即幂等自注入 `<style id="{styleId ?? CHARTS_STYLE_ID}">`（R3／R12）；图表 CSS 文本
+ *  **只此一处产出**（`chartsCss`），#75 落地时复用同一份文本，不得重述。 */
+export declare const buildChartsHelpersJs: BuildChartsHelpersJs;
+//# sourceMappingURL=charts.d.ts.map

package/dist/charts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"charts.d.ts","sourceRoot":"","sources":["../src/charts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAMH,OAAO,KAAK,EAGV,oBAAoB,EAGpB,cAAc,EAOd,SAAS,EAkBV,MAAM,iBAAiB,CAAC;AAMzB,+EAA+E;AAC/E,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;gBAElB,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM;CAKlD;AAokDD;;;uEAGuE;AACvE,eAAO,MAAM,MAAM,EAAE,SAQnB,CAAC;AAIH;;;;;;gEAMgE;AAChE,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA0DhD;AAcD;;;;;;;;mDAQmD;AACnD,eAAO,MAAM,oBAAoB,EAAE,oBAyBlC,CAAC"}