base-paint 0.3.13 → 0.3.15

package/dist/components/status-row/style.d.ts

@@ -0,0 +1,15 @@
+/** 本件的内容容器名（`@container` 按它命中，不会跟别件的容器串味）。 */
+export declare const STATUS_ROW_CONTAINER = "ilife-status-row";
+/** 窄档断点（px）：容器窄于它就换排法（**不是**视口断点）。 */
+export declare const STATUS_ROW_NARROW_MAX_PX = 460;
+/** 轨道点直径（px）。 */
+export declare const STATUS_ROW_NODE_SIZE_PX = 13;
+/** 左轨列宽（px）：点居中在它里面，连线走它的中线。 */
+export declare const STATUS_ROW_RAIL_WIDTH_PX = 24;
+/** 行高下限（px）：44 是全仓的触控地板；本件没有可点元素，行高先钉在这里。 */
+export declare const STATUS_ROW_ITEM_MIN_HEIGHT_PX = 44;
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export declare function statusRowCss(input?: {
+    readonly prefix?: string;
+}): string;
+//# sourceMappingURL=style.d.ts.map

package/dist/components/status-row/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/components/status-row/style.ts"],"names":[],"mappings":"AAuBA,8CAA8C;AAC9C,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AACvD,sCAAsC;AACtC,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,iBAAiB;AACjB,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,gCAAgC;AAChC,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,6CAA6C;AAC7C,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAIhD,4BAA4B;AAC5B,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA8PzE"}

package/dist/components/status-row/style.js

@@ -0,0 +1,289 @@
+/** status-row · **样式段**（本件唯一的样式来源）。
+ *
+ *  三条纪律（与组件层其余件同一份）：
+ *   1. 颜色／圆角／阴影／字面／字号**一律经 `skinVar()` 读**（产出带兜底链的 `var()` 串，
+ *      老页面没挂皮肤时落到那 11 个冻结 token）——本件源码里**不出现**手写的 `var(--ilife-…)`；
+ *   2. 全部规则 scope 在 `.<prefix>page-ui` 之下（不开 pageUi 的页零命中 ⇒ 加法式）；
+ *   3. **状态靠「字 ＋ 形 ＋ 色」三样一起**给：徽标与轨道点的形状差异逐档写在下面
+ *      （空心圆／双环实心／实心圆／空心方／双线菱；无框底线／空心框／实底色块／框＋底块／双线框），
+ *      所以「大字报刊」（强调色＝墨黑）那档也分得开。
+ *
+ *  几何契约（钉在判据里）：
+ *   · 行高 ≥ `STATUS_ROW_ITEM_MIN_HEIGHT_PX`（44）：本件没有可点元素，但行高先钉在这个地板上，
+ *     页面把整行接成入口时不会掉到 44 以下；
+ *   · 金额与到期日**永不 `…` 截断**（`white-space:nowrap`，不写 `overflow:hidden`）；
+ *   · 窄宽由**容器**决定（`container-type:inline-size` ＋ `@container`），不看视口：
+ *     本件会被嵌进侧栏／面板／卡片，视口宽 ≠ 组件宽。本件**零动效**（没有可卡住的中间态）。
+ */
+import { skinVar } from '../skin/contract.js';
+import { statusRowClass, statusRowSlot } from './attrs.js';
+/** 换行（仓库口径：不写字面换行转义）。 */
+const LF = String.fromCharCode(10);
+/** 本件的内容容器名（`@container` 按它命中，不会跟别件的容器串味）。 */
+export const STATUS_ROW_CONTAINER = 'ilife-status-row';
+/** 窄档断点（px）：容器窄于它就换排法（**不是**视口断点）。 */
+export const STATUS_ROW_NARROW_MAX_PX = 460;
+/** 轨道点直径（px）。 */
+export const STATUS_ROW_NODE_SIZE_PX = 13;
+/** 左轨列宽（px）：点居中在它里面，连线走它的中线。 */
+export const STATUS_ROW_RAIL_WIDTH_PX = 24;
+/** 行高下限（px）：44 是全仓的触控地板；本件没有可点元素，行高先钉在这里。 */
+export const STATUS_ROW_ITEM_MIN_HEIGHT_PX = 44;
+/** 行内上下内距（px）：换算连线与点的位置时用它（别处不许再写这个数）。 */
+const ROW_PAD_Y = 9;
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export function statusRowCss(input) {
+    const p = input !== undefined && input !== null
+        && typeof input.prefix === 'string' && input.prefix !== '' ? input.prefix : 'ilife-';
+    const root = '.' + p + 'page-ui';
+    /** 槽类的**裸**选择器（不带 `.page-ui` 前缀）：只用在"祖先已经由 `sc()` 给过"的嵌套选择器里——
+     *  否则会拼成 `.page-ui .a .page-ui .b`（那要求 `.page-ui` 出现在件内部），永远匹配不上（实拍踩过）。 */
+    const n = (slot) => '.' + statusRowSlot(slot, p);
+    /** 槽类的完整选择器（唯一的拼法：槽名只来自 `attrs.ts` 的闭集）。 */
+    const sc = (slot) => root + ' ' + n(slot);
+    const v = skinVar;
+    return [
+        '/* status-row（状态台账行）：一笔一行 —— 轨道点（形）＋ 阶段徽标（字）＋ 金额；第二行补充与到期日。 */',
+        root + ' .' + statusRowClass(p) + ' {',
+        '  display: flex;',
+        '  flex-direction: column;',
+        '  min-width: 0;',
+        '  container: ' + STATUS_ROW_CONTAINER + ' / inline-size;',
+        '}',
+        sc('head') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: baseline;',
+        '  gap: 4px 10px;',
+        '  padding-bottom: 6px;',
+        '  border-bottom: 1px solid ' + v('line') + ';',
+        '}',
+        sc('heading') + ' {',
+        '  color: ' + v('ink-3') + ';',
+        '  font-size: 11.5px;',
+        '  font-weight: 700;',
+        '  letter-spacing: .22em;',
+        '}',
+        sc('count') + ' {',
+        '  margin-left: auto;',
+        '  color: ' + v('ink-2') + ';',
+        '  font-family: ' + v('font-num') + ';',
+        '  font-size: ' + v('fs-xs') + ';',
+        '  font-variant-numeric: tabular-nums;',
+        '  white-space: nowrap;',
+        '}',
+        sc('list') + ' {',
+        '  display: flex;',
+        '  flex-direction: column;',
+        '  min-width: 0;',
+        '}',
+        sc('item') + ' {',
+        '  position: relative;',
+        '  display: grid;',
+        '  grid-template-columns: auto minmax(0, 1fr);',
+        '  gap: 0 10px;',
+        '  box-sizing: border-box;',
+        '  min-width: 0;',
+        '  min-height: ' + STATUS_ROW_ITEM_MIN_HEIGHT_PX + 'px;',
+        '  padding: ' + ROW_PAD_Y + 'px 0;',
+        '}',
+        '/* 从左轨中点往下连到下一行（最后一行不画）："走到哪了"的位置感由这条线承担。 */',
+        sc('item') + ':not(:last-child)::after {',
+        '  content: "";',
+        '  position: absolute;',
+        '  left: ' + (STATUS_ROW_RAIL_WIDTH_PX / 2 - 0.5) + 'px;',
+        '  top: ' + (ROW_PAD_Y + 3 + STATUS_ROW_NODE_SIZE_PX + 3) + 'px;',
+        '  bottom: -2px;',
+        '  width: 1px;',
+        '  background: ' + v('line') + ';',
+        '}',
+        '/* 走完的那一段连线变实（不是靠变色：线型之分自己就是第二样信息）。色走**主色实底**——它是"无文字的条"，',
+        '   `docs/base/base-render/选中态与皮肤语言.md` 第三节法则表把"已完成连接线"逐字点在这一档；',
+        '   旧写法 `background: ink` 是拿正文墨色当面，纸面语言里没有对应语汇，`ink` 皮肤下只读成一道近黑印痕。 */',
+        sc('item') + '.is-ok + ' + n('item') + '::after { background: ' + v('accent') + '; }',
+        sc('rail') + ' {',
+        '  display: flex;',
+        '  justify-content: center;',
+        '  flex: 0 0 auto;',
+        '  width: ' + STATUS_ROW_RAIL_WIDTH_PX + 'px;',
+        '}',
+        sc('node') + ' {',
+        '  position: relative;',
+        '  display: block;',
+        '  box-sizing: border-box;',
+        '  width: ' + STATUS_ROW_NODE_SIZE_PX + 'px;',
+        '  height: ' + STATUS_ROW_NODE_SIZE_PX + 'px;',
+        '  margin-top: 3px;',
+        '  border: 1.5px solid ' + v('line') + ';',
+        '  border-radius: 50%;',
+        '  background: ' + v('surface') + ';',
+        '}',
+        '/* 五档形状（色只是第三样）：空心圆／双环实心／实心圆／空心方／双线菱。 */',
+        sc('item') + '.is-active ' + n('node') + ' { border-color: ' + v('accent') + '; }',
+        sc('item') + '.is-active ' + n('node') + '::after {',
+        '  content: "";',
+        '  position: absolute;',
+        '  inset: 2.5px;',
+        '  border-radius: 50%;',
+        '  background: ' + v('accent') + ';',
+        '}',
+        '/* 「走完了」那一档：实心圆＝**无文字的点** ⇒ 主色实底（法则表第三节：无文字的点／格／条走 `accent`）；',
+        '   旧写法 `border-color: ink; background: ink` 是拿正文墨色当面，属第四节禁止项 1／4。 */',
+        sc('item') + '.is-ok ' + n('node') + ' {',
+        '  border-color: ' + v('accent') + ';',
+        '  background: ' + v('accent') + ';',
+        '}',
+        sc('item') + '.is-warn ' + n('node') + ' {',
+        '  border-color: ' + v('warn') + ';',
+        '  border-radius: 2px;',
+        '  background: ' + v('warn-soft') + ';',
+        '}',
+        sc('item') + '.is-danger ' + n('node') + ' {',
+        '  border: 3px double ' + v('danger') + ';',
+        '  border-radius: 0;',
+        '  background: ' + v('danger-soft') + ';',
+        '  transform: rotate(45deg);',
+        '}',
+        sc('body') + ' {',
+        '  display: flex;',
+        '  flex-direction: column;',
+        '  min-width: 0;',
+        '}',
+        sc('line1') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: baseline;',
+        '  gap: 4px 10px;',
+        '  min-width: 0;',
+        '}',
+        sc('name') + ' {',
+        '  min-width: 0;',
+        '  color: ' + v('ink') + ';',
+        '  font-size: ' + v('fs-sm') + ';',
+        '  font-weight: 700;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        sc('badge') + ' {',
+        '  display: inline-flex;',
+        '  align-items: center;',
+        '  box-sizing: border-box;',
+        '  flex: 0 0 auto;',
+        '  padding: 1px 8px;',
+        '  border: 1px solid transparent;',
+        '  border-radius: ' + v('radius-pill') + ';',
+        '  background: none;',
+        '  color: ' + v('ink-2') + ';',
+        '  font-size: ' + v('fs-xs') + ';',
+        '  font-weight: 700;',
+        '  line-height: 1.5;',
+        '  white-space: nowrap;',
+        '}',
+        '/* 徽标五档形状：无框底线／空心框／实底色块／框＋底块／双线框。 */',
+        sc('badge') + '.is-neutral {',
+        '  padding: 0 0 1px;',
+        '  border: 0;',
+        '  border-bottom: 2px solid ' + v('line') + ';',
+        '  border-radius: 0;',
+        '}',
+        sc('badge') + '.is-active {',
+        '  border: 1px solid ' + v('accent') + ';',
+        '  background: ' + v('accent-soft') + ';',
+        '  color: ' + v('accent-text') + ';',
+        '}',
+        sc('badge') + '.is-ok {',
+        '  border: 0;',
+        '  background: ' + v('ok-soft') + ';',
+        '  color: ' + v('ok') + ';',
+        '}',
+        sc('badge') + '.is-warn {',
+        '  border: 1px solid ' + v('warn') + ';',
+        '  background: ' + v('warn-soft') + ';',
+        '  color: ' + v('warn') + ';',
+        '}',
+        sc('badge') + '.is-danger {',
+        '  border: 3px double ' + v('danger') + ';',
+        '  border-radius: 0;',
+        '  background: none;',
+        '  color: ' + v('danger') + ';',
+        '}',
+        sc('amount') + ' {',
+        '  margin-left: auto;',
+        '  flex: 0 0 auto;',
+        '  color: ' + v('ink') + ';',
+        '  font-family: ' + v('font-num') + ';',
+        '  font-size: ' + v('fs-sm') + ';',
+        '  font-variant-numeric: tabular-nums;',
+        '  font-weight: 700;',
+        '  text-align: right;',
+        '  white-space: nowrap;',
+        '}',
+        sc('amount') + ' small {',
+        '  margin-left: 2px;',
+        '  color: ' + v('ink-2') + ';',
+        '  font-size: ' + v('fs-xs') + ';',
+        '  font-weight: 600;',
+        '}',
+        sc('line2') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: baseline;',
+        '  gap: 2px 10px;',
+        '  min-width: 0;',
+        '  margin-top: 3px;',
+        '  color: ' + v('ink-3') + ';',
+        '  font-size: ' + v('fs-xs') + ';',
+        '}',
+        sc('meta') + ' {',
+        '  min-width: 0;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        sc('due') + ' {',
+        '  display: inline-flex;',
+        '  align-items: baseline;',
+        '  gap: 4px;',
+        '  margin-left: auto;',
+        '  padding-bottom: 1px;',
+        '  border-bottom: 2px solid transparent;',
+        '  color: ' + v('ink-2') + ';',
+        '  font-family: ' + v('font-num') + ';',
+        '  font-size: ' + v('fs-xs') + ';',
+        '  font-variant-numeric: tabular-nums;',
+        '  white-space: nowrap;',
+        '}',
+        '/* 到期日五档形状：无线／双线／细实线／点线／粗实线＋加粗。 */',
+        sc('due') + '.is-active { border-bottom: 3px double ' + v('accent') + '; color: ' + v('accent-text') + '; }',
+        sc('due') + '.is-ok { border-bottom: 2px solid ' + v('ok') + '; }',
+        sc('due') + '.is-warn { border-bottom: 2px dotted ' + v('warn') + '; color: ' + v('warn') + '; }',
+        sc('due') + '.is-danger {',
+        '  border-bottom: 2px solid ' + v('danger') + ';',
+        '  color: ' + v('danger') + ';',
+        '  font-weight: 700;',
+        '}',
+        sc('due') + ' em {',
+        '  color: ' + v('ink-3') + ';',
+        '  font-family: ' + v('font') + ';',
+        '  font-style: normal;',
+        '}',
+        sc('absent') + ' {',
+        '  padding: 10px 0 2px;',
+        '  color: ' + v('ink-3') + ';',
+        '  font-size: ' + v('fs-sm') + ';',
+        '}',
+        sc('foot') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: baseline;',
+        '  gap: 4px 12px;',
+        '  margin-top: 8px;',
+        '  padding-top: 8px;',
+        '  border-top: 1px solid ' + v('line') + ';',
+        '  color: ' + v('ink-2') + ';',
+        '  font-size: ' + v('fs-xs') + ';',
+        '}',
+        '/* 窄档：金额与到期日不再往右顶，各占一整行（右对齐）——听容器，不听视口。 */',
+        '@container ' + STATUS_ROW_CONTAINER + ' (max-width: ' + STATUS_ROW_NARROW_MAX_PX + 'px) {',
+        '  ' + sc('amount') + ' { margin-left: 0; flex: 1 1 100%; }',
+        '  ' + sc('due') + ' { margin-left: 0; }',
+        '}',
+    ].join(LF);
+}

package/dist/components/status-row/style.js.map

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

package/dist/components/step-flow/attrs.d.ts

@@ -0,0 +1,65 @@
+/** step-flow · **标记契约**（渲染与调用方共用的唯一事实：类名／槽名／形态闭集／状态闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-06-状态与台账.mjs`，2026-09 用户裁定）
+ *  里的**形态 A「竖排带说明」**——做到第几步了：已完成／当前／未开始三态，
+ *  每一步带估时与实耗，当前那一步带说明。做菜步骤（私家大厨）与落地训练（卡路里）都用它。
+ *
+ *  **三态靠「字 ＋ 形 ＋ 色」三样一起给**：节点是实心圆带 ✓ ／ 双环带内点 ／ 虚线空圈带序号，
+ *  状态字是底线／实底块／虚线框，连线是实线／虚线。色只是第三样。
+ */
+export declare const STEP_FLOW_CLASS = "ilife-block-step-flow";
+/** 槽位闭集（数组里带注释 ⇒ 不会被当成"形态闭集"）。 */
+export declare const STEP_FLOW_SLOTS: readonly ["head", "title", "count", "list", "step", "node", "body", "title-row", "name", "state", "time", "estimate", "actual", "desc", "note", "foot", "absent"];
+export type StepFlowSlot = (typeof STEP_FLOW_SLOTS)[number];
+/** 类名根。 */
+export declare function stepFlowClass(prefix?: string): string;
+/** 槽类的唯一拼法。 */
+export declare function stepFlowSlot(slot: StepFlowSlot, prefix?: string): string;
+/** 形态闭集：本件只落地形态 A「竖排带说明」。 */
+export declare const STEP_FLOW_FORMS: readonly ["vertical"];
+export type StepFlowForm = (typeof STEP_FLOW_FORMS)[number];
+/** 状态闭集（三步态；闭集外的值一律 `badInput`——不静默当成"未开始"）。 */
+export declare const STEP_STATES: readonly ["done", "now", "todo"];
+export type StepState = (typeof STEP_STATES)[number];
+/** 状态字（三态各有自己的形状，见 `style.ts`；要换说法就在 `steps[].stateWord` 上覆盖）。 */
+export declare const STEP_STATE_WORDS: Readonly<Record<StepState, string>>;
+/** 已完成那一步节点里的记号（字：它让"实心圆"这一形状带上了可读的语意）。 */
+export declare const STEP_FLOW_MARK_DONE = "\u2713";
+/** 缺值的写法：**缺值写成 `—`，不许写 0、不许留空**（全仓同一条地板）。 */
+export declare const STEP_FLOW_MISSING = "\u2014";
+/** 一步一步。 */
+export interface StepFlowStep {
+    /** 这一步做什么（`备料`／`下肉煸炒`）。必填非空。 */
+    readonly title: string;
+    /** 三态之一。**必填**——状态是这一件的主轴，缺了它画出来就是一团没有主次的清单。 */
+    readonly state: StepState;
+    /** 覆盖默认状态字（`STEP_STATE_WORDS`）；不给＝用默认那三个词。 */
+    readonly stateWord?: string;
+    /** 估时（`估 6 分`）。 */
+    readonly estimate?: string;
+    /** 实耗（`实 7 分`）：已完成／当前的步才有。 */
+    readonly actual?: string;
+    /** 说明（可以很长；当前那一步尤其要有）。 */
+    readonly description?: string;
+    /** 一句强调（`比预计多用了 2 分钟`）。 */
+    readonly note?: string;
+    /** 强调的语气：`plain`（缺省，弱文字）／`warn`（提醒档）。 */
+    readonly noteTone?: 'plain' | 'warn';
+}
+export interface StepFlowInput {
+    /** 逐步；空数组且无 `absentLine` ⇒ 空串（与"没内容不留空块"同口径）。 */
+    readonly steps: readonly StepFlowStep[];
+    /** 小标题（`辣椒炒肉 · 第 3 / 5 步`）。 */
+    readonly title?: string;
+    /** 右侧读数（`预计还要 6 分钟`）。 */
+    readonly count?: string;
+    /** 脚注（`总估时 16 分`／`已用 9 分`）：串＝一句；数组＝逐段一枚。 */
+    readonly foot?: string | readonly string[];
+    /** 空态那一句（`这道菜还没有步骤`）——**这是"没什么"，不是一步**，所以住独立槽位、不进 `steps`。 */
+    readonly absentLine?: string;
+    /** 形态键（闭集，缺省 `vertical`）。 */
+    readonly form?: StepFlowForm;
+    /** 附加类名（空格分隔；逐个过类名正则）。 */
+    readonly extraClass?: string;
+}
+//# sourceMappingURL=attrs.d.ts.map

package/dist/components/step-flow/attrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.d.ts","sourceRoot":"","sources":["../../../src/components/step-flow/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,0BAA0B,CAAC;AAEvD,kCAAkC;AAClC,eAAO,MAAM,eAAe,mKAkBlB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,WAAW;AACX,wBAAgB,aAAa,CAAC,MAAM,SAAW,GAAG,MAAM,CAEvD;AAED,eAAe;AACf,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,SAAW,GAAG,MAAM,CAE1E;AAED,6BAA6B;AAC7B,eAAO,MAAM,eAAe,uBAAwB,CAAC;AACrD,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,gDAAgD;AAChD,eAAO,MAAM,WAAW,kCAAmC,CAAC;AAC5D,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAI/D,CAAC;AAEH,2CAA2C;AAC3C,eAAO,MAAM,mBAAmB,WAAM,CAAC;AAEvC,8CAA8C;AAC9C,eAAO,MAAM,iBAAiB,WAAM,CAAC;AAErC,YAAY;AACZ,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB;IACnB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,0BAA0B;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,yBAAyB;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAC3C,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,0BAA0B;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B"}

package/dist/components/step-flow/attrs.js

@@ -0,0 +1,52 @@
+/** step-flow · **标记契约**（渲染与调用方共用的唯一事实：类名／槽名／形态闭集／状态闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-06-状态与台账.mjs`，2026-09 用户裁定）
+ *  里的**形态 A「竖排带说明」**——做到第几步了：已完成／当前／未开始三态，
+ *  每一步带估时与实耗，当前那一步带说明。做菜步骤（私家大厨）与落地训练（卡路里）都用它。
+ *
+ *  **三态靠「字 ＋ 形 ＋ 色」三样一起给**：节点是实心圆带 ✓ ／ 双环带内点 ／ 虚线空圈带序号，
+ *  状态字是底线／实底块／虚线框，连线是实线／虚线。色只是第三样。
+ */
+export const STEP_FLOW_CLASS = 'ilife-block-step-flow';
+/** 槽位闭集（数组里带注释 ⇒ 不会被当成"形态闭集"）。 */
+export const STEP_FLOW_SLOTS = [
+    'head',
+    'title',
+    'count',
+    'list',
+    'step',
+    'node',
+    'body',
+    'title-row',
+    'name',
+    'state',
+    'time',
+    'estimate',
+    'actual',
+    'desc',
+    'note',
+    'foot',
+    'absent',
+];
+/** 类名根。 */
+export function stepFlowClass(prefix = 'ilife-') {
+    return prefix + 'block-step-flow';
+}
+/** 槽类的唯一拼法。 */
+export function stepFlowSlot(slot, prefix = 'ilife-') {
+    return stepFlowClass(prefix) + '-' + slot;
+}
+/** 形态闭集：本件只落地形态 A「竖排带说明」。 */
+export const STEP_FLOW_FORMS = ['vertical'];
+/** 状态闭集（三步态；闭集外的值一律 `badInput`——不静默当成"未开始"）。 */
+export const STEP_STATES = ['done', 'now', 'todo'];
+/** 状态字（三态各有自己的形状，见 `style.ts`；要换说法就在 `steps[].stateWord` 上覆盖）。 */
+export const STEP_STATE_WORDS = Object.freeze({
+    done: '已完成',
+    now: '正在做',
+    todo: '未开始',
+});
+/** 已完成那一步节点里的记号（字：它让"实心圆"这一形状带上了可读的语意）。 */
+export const STEP_FLOW_MARK_DONE = '✓';
+/** 缺值的写法：**缺值写成 `—`，不许写 0、不许留空**（全仓同一条地板）。 */
+export const STEP_FLOW_MISSING = '—';

package/dist/components/step-flow/attrs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.js","sourceRoot":"","sources":["../../../src/components/step-flow/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAEvD,kCAAkC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM;IACN,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,WAAW;IACX,MAAM;IACN,OAAO;IACP,MAAM;IACN,UAAU;IACV,QAAQ;IACR,MAAM;IACN,MAAM;IACN,MAAM;IACN,QAAQ;CACA,CAAC;AAGX,WAAW;AACX,MAAM,UAAU,aAAa,CAAC,MAAM,GAAG,QAAQ;IAC7C,OAAO,MAAM,GAAG,iBAAiB,CAAC;AACpC,CAAC;AAED,eAAe;AACf,MAAM,UAAU,YAAY,CAAC,IAAkB,EAAE,MAAM,GAAG,QAAQ;IAChE,OAAO,aAAa,CAAC,MAAM,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC;AAC5C,CAAC;AAED,6BAA6B;AAC7B,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,UAAU,CAAU,CAAC;AAGrD,gDAAgD;AAChD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAU,CAAC;AAG5D,kEAAkE;AAClE,MAAM,CAAC,MAAM,gBAAgB,GAAwC,MAAM,CAAC,MAAM,CAAC;IACjF,IAAI,EAAE,KAAK;IACX,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,KAAK;CACZ,CAAC,CAAC;AAEH,2CAA2C;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEvC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC"}

package/dist/components/step-flow/index.d.ts

@@ -0,0 +1,23 @@
+/** step-flow · **组件出口**（本件对外的唯一名字面）。
+ *
+ *  —— 步骤条 ——
+ *
+ *  一句话：**做到第几步了**——竖排逐步，节点给三态（✓／双环内点／虚线空圈 ＋ 序号），
+ *  状态字给说法（已完成／正在做／未开始），每一步带估时与实耗，当前那一步带说明。
+ *
+ *  什么时候用它（对照既有件想清楚再选）：
+ *   · 一步一步走、要看出"现在该做哪一步" ⇒ 用本件；
+ *   · 一行一条、可勾选（买菜清单／盘点）⇒ 用 `task-list`；
+ *   · 一笔在途的事走到哪个阶段（分期／保修）⇒ 用 `status-row`；
+ *   · 还有几天到期、每行一个动作 ⇒ 用 `due-row`。
+ *
+ *  两件出口：`renderStepFlow(input)`（产标记，零 DOM）／`stepFlowCss()`（样式段）。
+ *  本件**零 DOM、零动效、零可点元素**（静态件；"可回看行程"那类折叠形态不在本件落地范围）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { STEP_FLOW_CLASS, STEP_FLOW_FORMS, STEP_FLOW_MARK_DONE, STEP_FLOW_MISSING, STEP_FLOW_SLOTS, STEP_STATES, STEP_STATE_WORDS, stepFlowClass, stepFlowSlot, } from './attrs.js';
+export type { StepFlowForm, StepFlowInput, StepFlowSlot, StepFlowStep, StepState, } from './attrs.js';
+export { renderStepFlow } from './render.js';
+export { STEP_FLOW_CONTAINER, STEP_FLOW_NARROW_MAX_PX, STEP_FLOW_NODE_COLUMN_PX, STEP_FLOW_NODE_SIZE_PX, stepFlowCss, } from './style.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/step-flow/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/step-flow/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EACL,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/components/step-flow/index.js

@@ -0,0 +1,21 @@
+/** step-flow · **组件出口**（本件对外的唯一名字面）。
+ *
+ *  —— 步骤条 ——
+ *
+ *  一句话：**做到第几步了**——竖排逐步，节点给三态（✓／双环内点／虚线空圈 ＋ 序号），
+ *  状态字给说法（已完成／正在做／未开始），每一步带估时与实耗，当前那一步带说明。
+ *
+ *  什么时候用它（对照既有件想清楚再选）：
+ *   · 一步一步走、要看出"现在该做哪一步" ⇒ 用本件；
+ *   · 一行一条、可勾选（买菜清单／盘点）⇒ 用 `task-list`；
+ *   · 一笔在途的事走到哪个阶段（分期／保修）⇒ 用 `status-row`；
+ *   · 还有几天到期、每行一个动作 ⇒ 用 `due-row`。
+ *
+ *  两件出口：`renderStepFlow(input)`（产标记，零 DOM）／`stepFlowCss()`（样式段）。
+ *  本件**零 DOM、零动效、零可点元素**（静态件；"可回看行程"那类折叠形态不在本件落地范围）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { STEP_FLOW_CLASS, STEP_FLOW_FORMS, STEP_FLOW_MARK_DONE, STEP_FLOW_MISSING, STEP_FLOW_SLOTS, STEP_STATES, STEP_STATE_WORDS, stepFlowClass, stepFlowSlot, } from './attrs.js';
+export { renderStepFlow } from './render.js';
+export { STEP_FLOW_CONTAINER, STEP_FLOW_NARROW_MAX_PX, STEP_FLOW_NODE_COLUMN_PX, STEP_FLOW_NODE_SIZE_PX, stepFlowCss, } from './style.js';

package/dist/components/step-flow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/step-flow/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EACL,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC;AAQpB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/components/step-flow/model.d.ts

@@ -0,0 +1,24 @@
+import { type StepFlowForm, type StepState } from './attrs.js';
+/** 内部类型：每个字段都已校验、已归一。 */
+export interface StepFlowModel {
+    readonly form: StepFlowForm;
+    readonly title?: string;
+    readonly count?: string;
+    readonly steps: readonly NormalizedStep[];
+    readonly foot: readonly string[];
+    readonly absentLine?: string;
+    readonly extraClass?: string;
+}
+export interface NormalizedStep {
+    readonly title: string;
+    readonly state: StepState;
+    readonly stateWord?: string;
+    readonly estimate?: string;
+    readonly actual?: string;
+    readonly description?: string;
+    readonly note?: string;
+    readonly noteTone: 'plain' | 'warn';
+}
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `StepFlowModel`。 */
+export declare function normalizeStepFlow(input: unknown): StepFlowModel;
+//# sourceMappingURL=model.d.ts.map

package/dist/components/step-flow/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/components/step-flow/model.ts"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,YAAY,EAEjB,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AAEpB,yBAAyB;AACzB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;CACrC;AAqCD,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CA2B/D"}

package/dist/components/step-flow/model.js

@@ -0,0 +1,77 @@
+/** step-flow · **入参归一化与校验**（把 `any` 与说不出的 `unknown` 挡在门外，产出内部类型）。
+ *
+ *  三条口径：
+ *   1. **非法入参一律 `badInput()`**（抛 `BlocksError`）——不静默降级：状态给错若不报，
+ *      "正在做的那一步"会被画成"未开始"，整条步骤条就废了；
+ *   2. **同一条步骤条里同时只能有一个"当前步"**（两个 `now` 会让读者不知道现在该做哪一步）；
+ *   3. 归一化只做**形状**：估时／实耗／时分换算**归调用方**（本件只收"已经是给人看的样子"的串）。
+ */
+import { assertPlainObject, badInput, optExtraClass, optText, reqText } from '../shared/validate.js';
+import { STEP_FLOW_FORMS, STEP_STATES, } from './attrs.js';
+/** 串或串数组 → 段数组（`''` 与 `[]` 都按"不出这一段"处理）。 */
+function textList(value, field) {
+    if (value === undefined)
+        return [];
+    if (typeof value === 'string') {
+        const one = optText(value, field);
+        return one === undefined ? [] : [one];
+    }
+    if (!Array.isArray(value))
+        badInput(field + ' 必须是字符串，或字符串数组（逐段一枚）');
+    const out = [];
+    for (let i = 0; i < value.length; i += 1)
+        out.push(reqText(value[i], field + '[' + i + ']'));
+    return out;
+}
+function stepOf(raw, field) {
+    assertPlainObject(raw, field);
+    const step = raw;
+    if (!STEP_STATES.includes(step.state)) {
+        badInput(field + '.state 必须是 ' + STEP_STATES.join('／') + ' 之一，收到：' + String(step.state));
+    }
+    const tone = step.noteTone;
+    if (tone !== undefined && tone !== 'plain' && tone !== 'warn') {
+        badInput(field + '.noteTone 只许 plain／warn：' + String(tone));
+    }
+    return {
+        title: reqText(step.title, field + '.title'),
+        state: step.state,
+        stateWord: optText(step.stateWord, field + '.stateWord'),
+        estimate: optText(step.estimate, field + '.estimate'),
+        actual: optText(step.actual, field + '.actual'),
+        description: optText(step.description, field + '.description'),
+        note: optText(step.note, field + '.note'),
+        noteTone: tone === undefined ? 'plain' : tone,
+    };
+}
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `StepFlowModel`。 */
+export function normalizeStepFlow(input) {
+    assertPlainObject(input, 'renderStepFlow: input');
+    const raw = input;
+    const form = raw.form === undefined ? STEP_FLOW_FORMS[0] : raw.form;
+    if (!STEP_FLOW_FORMS.includes(form)) {
+        badInput('step-flow: input.form 必须是 ' + STEP_FLOW_FORMS.join('／') + ' 之一（本件只落地形态 A「竖排带说明」）');
+    }
+    if (!Array.isArray(raw.steps))
+        badInput('step-flow: input.steps 必须是数组');
+    const steps = [];
+    let now = -1;
+    for (let i = 0; i < raw.steps.length; i += 1) {
+        const step = stepOf(raw.steps[i], 'step-flow: input.steps[' + i + ']');
+        if (step.state === 'now') {
+            if (now >= 0)
+                badInput('step-flow: 同时只能有一个"当前步"（第 ' + now + ' 步与第 ' + i + ' 步都标了 now）');
+            now = i;
+        }
+        steps.push(step);
+    }
+    return {
+        form: form,
+        title: optText(raw.title, 'step-flow: input.title'),
+        count: optText(raw.count, 'step-flow: input.count'),
+        steps,
+        foot: textList(raw.foot, 'step-flow: input.foot'),
+        absentLine: optText(raw.absentLine, 'step-flow: input.absentLine'),
+        extraClass: optExtraClass(raw.extraClass, 'step-flow: input.extraClass'),
+    };
+}

package/dist/components/step-flow/model.js.map

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

package/dist/components/step-flow/render.d.ts

@@ -0,0 +1,6 @@
+import { type StepFlowSlot, type StepState } from './attrs.js';
+import type { StepFlowForm, StepFlowInput, StepFlowStep } from './attrs.js';
+export type { StepFlowForm, StepFlowInput, StepFlowSlot, StepFlowStep, StepState };
+/** 步骤条：竖排带说明。空步骤且没有空态那一句 ⇒ 出不了一个字。 */
+export declare function renderStepFlow(input: StepFlowInput): string;
+//# sourceMappingURL=render.d.ts.map