base-paint 0.3.15 → 0.3.16

package/dist/components/kanban-columns/attrs.js

@@ -0,0 +1,242 @@
+/** kanban-columns · **标记契约**（渲染与运行时共用的唯一事实：类名／槽位／`data-*`／事件名／闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/新件/parts-交互与流程.mjs` 第 88 件，2026-09 用户裁定）
+ *  里的**两档骨架**：
+ *   · **`status`「按状态分列」**（原型 A 档）——列＝状态（想做／在做／做过了），多列并排、列头带计数与「＋」，
+ *     卡片能在列之间移动（4/4/4）；
+ *   · **`grouped`「按位置分列 ＋ 列内二级组」**（原型 B 档，优化后 4/4/4 补落）——列＝位置
+ *     （玄关／厨房／卧室），列里再挂一层二级组（出门要带／调料柜），最小单位是一行物件
+ *     （`雨伞` ／ `1 把`）。
+ *
+ *  形态键写在 `KANBAN_COLUMNS_FORMS` 闭集里：档键取**骨架的名字**（`status`＝按状态分列／
+ *  `grouped`＝列内二级组），原型墙上的格号（A／B）不是接口名（同批 `drag-sort` 的 `lift` 同此口径）。
+ *  闭集外的值一律 `badInput`（不静默降级：降级会让调用方以为自己拿到了另一种骨架）。
+ *
+ *  **触屏地板**（触屏优先法条）：整张卡／整个物件行就是那颗按钮（点它＝选中）；挪动**不走拖拽**——
+ *  选中一行、再点目标列那枚看得见的收纳按钮，手机上同一套标记走得通；
+ *  取消也在状态句旁边（看得见、点得到）；`:focus-visible` 留给真实键盘用户。
+ *  列名与计数**永不截断**（样式段里没有省略手段），状态靠「形 ＋ 字 ＋ 色」三样。
+ *
+ *  **一屏只留一层话**（用户 2026-09-26 的硬口径：原型里那些旁白／口径句一句都别上屏）：
+ *  两档骨架上屏的都只有读数——列名＋列计数、组名＋组计数、行名＋行值、状态句、脚注。
+ *  原型 B 档那一段 `c-kan-cap` 长口径、以及列头第二级字（「进门这一块」那类旁白）**一个字节都不搬**：
+ *  `grouped` 档的列头根本没有 `purpose` 那一格（给了就 `badInput`，不静默吞掉）。
+ */
+/** 本件的类名根：全部槽位类名都是 `KANBAN_COLUMNS_CLASS + '-' + 槽名`。 */
+export const KANBAN_COLUMNS_CLASS = 'ilife-block-kanban-columns';
+/** 槽位闭集（标记契约的一部分：`render.ts`／`style.ts`／`runtime.ts` 与判据都用这里的名字拼类名）。 */
+export const KANBAN_COLUMNS_SLOTS = [
+    /** 宿主（分段切换 ＋ 列区 ＋ 状态句住这里；它自己就是容器）。 */
+    'host',
+    /** 窄档的分段切换（N 枚真按钮；宽档整条 `hidden`）。 */
+    'switch',
+    /** 分段里的一段（一列对应一段；当前列挂 `aria-pressed="true"`）。 */
+    'seg',
+    /** 列区（宽档并排 N 列；窄档一次只留一列）。 */
+    'cols',
+    /** 一列（列头 ＋ 列身；空列也一直在，不消失）。 */
+    'col',
+    /** 列头（两级字 ＋ 收纳键并成的那一块）。 */
+    'head',
+    /** 列名（如「想做」；**永不截断**，长了换行）。 */
+    'name',
+    /** 计数（如「2 道」；**永不截断**）。 */
+    'count',
+    /** 这一列是干什么的（如「待做的菜」；列头的第二级字）。 */
+    'purpose',
+    /** 往这一列加一张的键（44×44；只派发事件，不写库）。 */
+    'add',
+    /** 列身（卡 ＋ 收纳键 ＋ 空槽住这里；空列撑到同高）。 */
+    'body',
+    /* ── `grouped` 档的**二级组**与**物件行**（只有这一档画它们；`status` 档一个字节都不出） ── */
+    /** 二级组（组名行 ＋ 组里的物件行；这一列里的一「格」）。 */
+    'group',
+    /** 组名行（组名 ＋ 组计数；组名底下压一道发丝线，把这一层与物件行分开）。 */
+    'ghead',
+    /** 组名（如「出门要带」；**永不截断**）。 */
+    'gname',
+    /** 组计数（如「2 件」；**永不截断**，同一列里几个组各报各的数）。 */
+    'gcount',
+    /** 一行物件（**整行就是那颗按钮**：点它＝选中／再点＝取消；行上**没有**自己的竖边）。 */
+    'row',
+    /** 物件的名字（如「雨伞」；**永不截断**）。 */
+    'label',
+    /** 物件的量（如「1 把」「30 g」；不给就不出这一格）。 */
+    'value',
+    /** 一张卡（**整卡就是那颗按钮**：点它＝选中／再点＝取消）。 */
+    'card',
+    /** 卡标题（如「葱油饼」；**永不截断**）。 */
+    'title',
+    /** 卡副语（一行一句人话，如「30 分钟 · 面点」）。 */
+    'meta',
+    /** 卡上那枚状态（形 ＋ 字：记号 ＋ 它在哪一列，不只靠列位置）。 */
+    'badge',
+    /** 状态里的记号（每列一形：●／▸／✓／◆）。 */
+    'mark',
+    /** 落点线（选中态才出：3px 实线 ＋ 写出放这里＝标记为哪一列）。 */
+    'drop',
+    /** 收纳键（每列一枚：选中后点它＝把卡收到这一列；没选中时 `disabled`）。 */
+    'receive',
+    /** 空槽（这一列空时出来：虚线框 ＋ 写出空着也保留列头与计数）。 */
+    'slot',
+    /** 状态句（现在选中了谁／点收纳按钮挪过去；`role="status"`）。 */
+    'status',
+    /** 取消选中（选中态才露出来：看得见、点得到的按钮）。 */
+    'cancel',
+    /** 脚注（这一件的拿法，一句话）。 */
+    'hint',
+];
+/** 槽类的类名（唯一拼法：别处不许再写 `KANBAN_COLUMNS_CLASS + '-' + …`）。 */
+export function kanbanColumnsSlot(slot, prefix = 'ilife-') {
+    return prefix + 'block-kanban-columns-' + slot;
+}
+/** 形态闭集：本件落地**两档骨架**——
+ *   `status`＝列按状态分列（列里的最小单位是一张卡）；
+ *   `grouped`＝列按位置分列 ＋ **列里再挂一层二级组**（列里的最小单位是一行物件）。
+ *  两档共用同一套交互（点一行拿起 ＋ 点目标列的收纳键挪过去）与同一段运行时段。 */
+export const KANBAN_COLUMNS_FORMS = ['status', 'grouped'];
+/** 形态类名（挂在本件类名根上）：`status` → `is-status`、`grouped` → `is-grouped`。
+ *  **渲染期与运行时段读同一个助手**：运行时段靠它认「这一块是哪一档」（落点线／空槽／组计数／
+ *  状态句四处都按形态走）；两处各写一个字面量就会走散——`style-grouped.ts` 里每一条也钉在它上面。 */
+export function kanbanColumnsFormClass(form) {
+    return 'is-' + form;
+}
+/* ── `data-*` 名（渲染与运行时共用的发现锚） ───────────────────────── */
+/** 根（值＝看板 `id`）。 */
+export const KANBAN_COLUMNS_ATTR = 'data-ilife-kanban';
+/** 一列（值＝这一列的机器键）。 */
+export const KANBAN_COLUMNS_COL_ATTR = 'data-ilife-kanban-col';
+/** 一张卡（值＝这一张卡的机器键）。 */
+export const KANBAN_COLUMNS_CARD_ATTR = 'data-ilife-kanban-card';
+/** 卡现在在哪一列（值＝列的机器键；挪动时运行时段改这一位 ＋ 计数 ＋ 卡上那枚状态）。 */
+export const KANBAN_COLUMNS_STATE_ATTR = 'data-ilife-kanban-state';
+/** 选中态（挂在根上；值＝被选中那一张卡的机器键；没选中时整条属性不在）。 */
+export const KANBAN_COLUMNS_PICK_ATTR = 'data-ilife-kanban-pick';
+/** 窄档当前列（挂在根上；值＝第几列，1 起）。 */
+export const KANBAN_COLUMNS_SHOW_ATTR = 'data-ilife-kanban-show';
+/** 分段里的一段（值＝第几列，1 起；运行时按它认「点的是哪一段」）。 */
+export const KANBAN_COLUMNS_SEG_ATTR = 'data-ilife-kanban-seg';
+/** 收纳键（值＝这一列的机器键；运行时按它认「收到哪一列」）。 */
+export const KANBAN_COLUMNS_RECEIVE_ATTR = 'data-ilife-kanban-receive';
+/** 往这一列加一张的键（值＝这一列的机器键）。 */
+export const KANBAN_COLUMNS_ADD_ATTR = 'data-ilife-kanban-add';
+/** 状态句（值＝看板 `id`）。 */
+export const KANBAN_COLUMNS_STATUS_ATTR = 'data-ilife-kanban-status';
+/** 取消键（值＝看板 `id`）。 */
+export const KANBAN_COLUMNS_CANCEL_ATTR = 'data-ilife-kanban-cancel';
+/** 记账：这份看板已被运行时段接管（幂等读数，不是开关）。 */
+export const KANBAN_COLUMNS_BOUND_ATTR = 'data-ilife-kanban-bound';
+/** 幂等开关：挂在 `<html>` 上（重复注入只绑一次）。 */
+export const KANBAN_COLUMNS_RUNTIME_ATTR = 'data-ilife-kanban-runtime';
+/* ── 事件（冒泡 `CustomEvent`；`detail` 见 README 的「交互契约」） ────── */
+/** 选中一张卡：`detail={id,key,from}`（from＝它现在在哪一列）。 */
+export const KANBAN_COLUMNS_EVENT_PICK = 'ilife:kanban-pick';
+/** 卡被收到另一列：`detail={id,key,from,to}`（from／to 都是列的机器键）。 */
+export const KANBAN_COLUMNS_EVENT_MOVE = 'ilife:kanban-move';
+/** 取消选中：`detail={id,key}`（卡原样不动）。 */
+export const KANBAN_COLUMNS_EVENT_CANCEL = 'ilife:kanban-cancel';
+/** 往一列加一张：`detail={id,column}`（本件不写库，只报「往哪一列加」）。 */
+export const KANBAN_COLUMNS_EVENT_ADD = 'ilife:kanban-add';
+/* ── 几何与能力（判据与样式段读同一份常量） ─────────────────────── */
+/** 触控地板：卡／收纳键／加键／分段的命中盒不小于这个数（px）。 */
+export const KANBAN_COLUMNS_TOUCH_PX = 44;
+/** 卡高下限（px）：卡里三行字，比地板再宽裕一档。 */
+export const KANBAN_COLUMNS_CARD_MIN_PX = 56;
+/** 相邻触控目标的缝（px）：卡与卡之间、卡与收纳键之间。**地板口径**见后一枚常量。 */
+export const KANBAN_COLUMNS_GAP_PX = 8;
+/** 拿起的卡「站起来」往上挪多少（px）。**这是全件唯一允许压掉卡间缝的量**。
+ *
+ *  **地板口径（三条，判据按这两枚常量算，不写死数字）**：
+ *   1. 拿起的卡与它上一张之间那道缝＝`KANBAN_COLUMNS_GAP_PX − KANBAN_COLUMNS_LIFT_PX`（8−2＝6）——
+ *      那是这道形自己占的，**全件只此一处**；
+ *   2. 其余每一道缝（含拿起的卡与它下一张之间）一律 ≥ `KANBAN_COLUMNS_GAP_PX`；
+ *   3. `KANBAN_COLUMNS_LIFT_PX` 只许大于 0 且小于 `KANBAN_COLUMNS_GAP_PX`（否则两道缝会叠在一起）。
+ *
+ *  样式段只读这里，不另写 2。 */
+export const KANBAN_COLUMNS_LIFT_PX = 2;
+/** `grouped` 档**二级组**那道竖边的宽度（px）。**全档唯一一道层次边**：物件行自己不带竖边
+ *  （原型那里一根组边里再嵌五根行边，左沿六条边在读，层次反而糊）。
+ *  组名行底下那一道发丝线（1px）是这一层的另一半——「边准」＝一道 3px 的组边 ＋ 一道 1px 的发丝线。 */
+export const KANBAN_COLUMNS_GROUP_EDGE_PX = 3;
+/** 本件自己的**容器**名（`@container` 按它命中，不会跟别件的容器串味）。 */
+export const KANBAN_COLUMNS_CONTAINER = 'ilife-kanban-columns';
+/** 窄档断点（px）：**本件自己**窄于它就一列一屏 ＋ 分段切换。这是容器断点，不是视口断点。 */
+export const KANBAN_COLUMNS_NARROW_PX = 600;
+/** 悬停只许是增强：这一段能力查询**样式段读它**（运行时不抢焦点，不读它）。 */
+export const KANBAN_COLUMNS_HOVER_QUERY = '(hover: hover) and (pointer: fine)';
+/** 列数下限（列）：1 列谈不上看板。 */
+export const KANBAN_COLUMNS_MIN_COLS = 2;
+/** 列数上限（列）：再多请调用方先分组（那是调用方的活，不是本件的活）。 */
+export const KANBAN_COLUMNS_MAX_COLS = 4;
+/** 一列的卡数上限（张）：`status` 档按卡数、`grouped` 档按**全列行数**算（再多请调用方先分组）。 */
+export const KANBAN_COLUMNS_MAX_CARDS = 20;
+/** 每列的记号（形：列名之外的另一重状态——色 ＋ 字 ＋ 形至少两样才算数）。 */
+export const KANBAN_COLUMNS_MARKS = ['●', '▸', '✓', '◆'];
+/* ── 文案（缺省的那几句；调用方换列名与卡名，状态句的语义别换） ───────── */
+export const KANBAN_COLUMNS_TEXT = Object.freeze({
+    /** 脚注：这一件的拿法（只说看得见的通路，不提拖拽那一路）。`status` 档：最小单位是一张卡。 */
+    hint: '点一张卡选中，再点目标列的收纳按钮挪过去。',
+    /** `grouped` 档的脚注：那一档的最小单位是**一行物件**，字面照实写「一行物件」——
+     *  同一句话在两档里指的不是同一样东西，术语不许含糊。 */
+    rowHint: '点一行物件选中，再点目标列的收纳按钮挪过去。',
+    /** 取消键上的字。 */
+    cancel: '取消选中',
+    /** 空槽两句：空着也保留列头与计数（空列不许消失）。 */
+    emptyTitle: '这一列现在是空的',
+    /* 两句话之间不写 `；`：那枚分隔符会撞仓库那把尺子（`test/separator-probe.mjs` 的 R2：
+       可见文本里出现 `；` 就是「用符号简化了 UI 展示」的设计债）。 */
+    emptyNote: '卡片挪过来就有内容。空着也保留列头与计数',
+    /** 没选中时状态句写的那一句（真读数，不是占位）。 */
+    idle: '还没选中卡片。',
+    /** `grouped` 档没选中那一句（同样是读数：那一档的最小单位是行）。 */
+    rowIdle: '还没选中物件。',
+    /** 收纳键的字（中间夹列名）：`放到「做过了」`。 */
+    receivePre: '放到「',
+    receivePost: '」',
+    /** 落点线上的字：`放这里＝标记为「做过了」`。 */
+    dropPre: '放这里＝标记为「',
+    dropPost: '」',
+    /** 加键的字（`＋`，无障碍名另拼）。 */
+    add: '＋',
+    /** 加键无障碍名的两半：`往「想做」里加一张`。 */
+    addPre: '往「',
+    addPost: '」里加一张',
+    /** 计数单位（列不给 `unit` 时的缺省）。 */
+    unit: '件',
+});
+/** 收纳键上的字（`放到「做过了」`）。 */
+export function kanbanReceiveText(name) {
+    return KANBAN_COLUMNS_TEXT.receivePre + name + KANBAN_COLUMNS_TEXT.receivePost;
+}
+/** 落点线上的字（`放这里＝标记为「做过了」`）。 */
+export function kanbanDropText(name) {
+    return KANBAN_COLUMNS_TEXT.dropPre + name + KANBAN_COLUMNS_TEXT.dropPost;
+}
+/** 加键的无障碍名（`往「想做」里加一张`）。 */
+export function kanbanAddLabel(name) {
+    return KANBAN_COLUMNS_TEXT.addPre + name + KANBAN_COLUMNS_TEXT.addPost;
+}
+/** 计数那一句（`2 道`：数 ＋ 单位，两样都写，不只染色）。 */
+export function kanbanCountText(count, unit) {
+    return String(count) + ' ' + unit;
+}
+/** 选中那一句的**模板**（两档同一句语义，只住这一处）：`已选中「X」，点目标列的收纳按钮挪过去。` */
+function pickedText(name) {
+    return '已选中「' + name + '」，点目标列的收纳按钮挪过去。';
+}
+/** 状态句（真读数：没选中写一句，选中了写清选的是谁、下一步点哪儿）。
+ *  **没选中那一句不再接脚注**：脚注（`hint`）本来就写在同一块看板底下，
+ *  两句一模一样的话连着出现两遍是看得到的重复（2026-09-25 看图读出来的）。 */
+export function kanbanStatusText(pickedTitle) {
+    if (pickedTitle === null)
+        return KANBAN_COLUMNS_TEXT.idle;
+    return pickedText(pickedTitle);
+}
+/** 形态 `grouped` 的状态句：选中那一句与 `status` 档**逐字节同一句**（模板只住上面一处）；
+ *  差别只在没拿起的那一句与脚注——那一档的最小单位是**一行物件**，字面照实写。 */
+export function kanbanRowStatusText(pickedLabel) {
+    if (pickedLabel === null)
+        return KANBAN_COLUMNS_TEXT.rowIdle;
+    return pickedText(pickedLabel);
+}
+//# sourceMappingURL=attrs.js.map

package/dist/components/kanban-columns/attrs.js.map

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

package/dist/components/kanban-columns/index.d.ts

@@ -0,0 +1,21 @@
+/** kanban-columns · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  三件运行名：`renderKanbanColumns(input)`（产标记，零 DOM）／`kanbanColumnsCss()`（样式段）／
+ *  `buildKanbanColumnsJs()`（运行时段：点卡选中 → 点目标列的收纳键挪过去 → 取消）。
+ *  标记契约（别的件／页面要按名字找元素时读它）：`KANBAN_COLUMNS_CLASS`／`KANBAN_COLUMNS_SLOTS`／
+ *  `kanbanColumnsSlot()`／`KANBAN_COLUMNS_ATTR`／`KANBAN_COLUMNS_COL_ATTR`／`KANBAN_COLUMNS_CARD_ATTR`。
+ *  闭集与几何：`KANBAN_COLUMNS_FORMS`（**两档英文键**：`status` 按状态分列／`grouped` 按位置分列 ＋
+ *  列内二级组；格号 A／B 不是接口名）／`KANBAN_COLUMNS_TOUCH_PX`／`KANBAN_COLUMNS_CARD_MIN_PX`／
+ *  `KANBAN_COLUMNS_GAP_PX`／`KANBAN_COLUMNS_LIFT_PX`（拿起的行站起来那一段位移；卡间缝的地板口径
+ *  写在它上面）／`KANBAN_COLUMNS_GROUP_EDGE_PX`（`grouped` 档二级组那道竖边）。
+ *  四条事件：`KANBAN_COLUMNS_EVENT_PICK`（选中）／`KANBAN_COLUMNS_EVENT_MOVE`（挪到另一列）／
+ *  `KANBAN_COLUMNS_EVENT_CANCEL`（取消选中）／`KANBAN_COLUMNS_EVENT_ADD`（往一列加一张）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { KANBAN_COLUMNS_ADD_ATTR, KANBAN_COLUMNS_ATTR, KANBAN_COLUMNS_BOUND_ATTR, KANBAN_COLUMNS_CANCEL_ATTR, KANBAN_COLUMNS_CARD_ATTR, KANBAN_COLUMNS_CARD_MIN_PX, KANBAN_COLUMNS_CLASS, KANBAN_COLUMNS_COL_ATTR, KANBAN_COLUMNS_CONTAINER, KANBAN_COLUMNS_EVENT_ADD, KANBAN_COLUMNS_EVENT_CANCEL, KANBAN_COLUMNS_EVENT_MOVE, KANBAN_COLUMNS_EVENT_PICK, KANBAN_COLUMNS_FORMS, KANBAN_COLUMNS_GAP_PX, KANBAN_COLUMNS_GROUP_EDGE_PX, KANBAN_COLUMNS_HOVER_QUERY, KANBAN_COLUMNS_LIFT_PX, KANBAN_COLUMNS_MARKS, KANBAN_COLUMNS_MAX_CARDS, KANBAN_COLUMNS_MAX_COLS, KANBAN_COLUMNS_MIN_COLS, KANBAN_COLUMNS_NARROW_PX, KANBAN_COLUMNS_PICK_ATTR, KANBAN_COLUMNS_RECEIVE_ATTR, KANBAN_COLUMNS_RUNTIME_ATTR, KANBAN_COLUMNS_SEG_ATTR, KANBAN_COLUMNS_SHOW_ATTR, KANBAN_COLUMNS_SLOTS, KANBAN_COLUMNS_STATE_ATTR, KANBAN_COLUMNS_STATUS_ATTR, KANBAN_COLUMNS_TEXT, KANBAN_COLUMNS_TOUCH_PX, kanbanAddLabel, kanbanColumnsFormClass, kanbanColumnsSlot, kanbanCountText, kanbanDropText, kanbanReceiveText, kanbanRowStatusText, kanbanStatusText, } from './attrs.js';
+export type { KanbanCard, KanbanColumn, KanbanColumnsForm, KanbanColumnsInput, KanbanColumnsSlot, KanbanGroup, KanbanGroupItem, } from './attrs.js';
+export { renderKanbanColumns } from './render.js';
+export { kanbanColumnsCss } from './style.js';
+export { buildKanbanColumnsJs } from './runtime.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/kanban-columns/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/kanban-columns/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,4BAA4B,EAC5B,0BAA0B,EAC1B,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,EAC1B,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/dist/components/kanban-columns/index.js

@@ -0,0 +1,20 @@
+/** kanban-columns · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  三件运行名：`renderKanbanColumns(input)`（产标记，零 DOM）／`kanbanColumnsCss()`（样式段）／
+ *  `buildKanbanColumnsJs()`（运行时段：点卡选中 → 点目标列的收纳键挪过去 → 取消）。
+ *  标记契约（别的件／页面要按名字找元素时读它）：`KANBAN_COLUMNS_CLASS`／`KANBAN_COLUMNS_SLOTS`／
+ *  `kanbanColumnsSlot()`／`KANBAN_COLUMNS_ATTR`／`KANBAN_COLUMNS_COL_ATTR`／`KANBAN_COLUMNS_CARD_ATTR`。
+ *  闭集与几何：`KANBAN_COLUMNS_FORMS`（**两档英文键**：`status` 按状态分列／`grouped` 按位置分列 ＋
+ *  列内二级组；格号 A／B 不是接口名）／`KANBAN_COLUMNS_TOUCH_PX`／`KANBAN_COLUMNS_CARD_MIN_PX`／
+ *  `KANBAN_COLUMNS_GAP_PX`／`KANBAN_COLUMNS_LIFT_PX`（拿起的行站起来那一段位移；卡间缝的地板口径
+ *  写在它上面）／`KANBAN_COLUMNS_GROUP_EDGE_PX`（`grouped` 档二级组那道竖边）。
+ *  四条事件：`KANBAN_COLUMNS_EVENT_PICK`（选中）／`KANBAN_COLUMNS_EVENT_MOVE`（挪到另一列）／
+ *  `KANBAN_COLUMNS_EVENT_CANCEL`（取消选中）／`KANBAN_COLUMNS_EVENT_ADD`（往一列加一张）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { KANBAN_COLUMNS_ADD_ATTR, KANBAN_COLUMNS_ATTR, KANBAN_COLUMNS_BOUND_ATTR, KANBAN_COLUMNS_CANCEL_ATTR, KANBAN_COLUMNS_CARD_ATTR, KANBAN_COLUMNS_CARD_MIN_PX, KANBAN_COLUMNS_CLASS, KANBAN_COLUMNS_COL_ATTR, KANBAN_COLUMNS_CONTAINER, KANBAN_COLUMNS_EVENT_ADD, KANBAN_COLUMNS_EVENT_CANCEL, KANBAN_COLUMNS_EVENT_MOVE, KANBAN_COLUMNS_EVENT_PICK, KANBAN_COLUMNS_FORMS, KANBAN_COLUMNS_GAP_PX, KANBAN_COLUMNS_GROUP_EDGE_PX, KANBAN_COLUMNS_HOVER_QUERY, KANBAN_COLUMNS_LIFT_PX, KANBAN_COLUMNS_MARKS, KANBAN_COLUMNS_MAX_CARDS, KANBAN_COLUMNS_MAX_COLS, KANBAN_COLUMNS_MIN_COLS, KANBAN_COLUMNS_NARROW_PX, KANBAN_COLUMNS_PICK_ATTR, KANBAN_COLUMNS_RECEIVE_ATTR, KANBAN_COLUMNS_RUNTIME_ATTR, KANBAN_COLUMNS_SEG_ATTR, KANBAN_COLUMNS_SHOW_ATTR, KANBAN_COLUMNS_SLOTS, KANBAN_COLUMNS_STATE_ATTR, KANBAN_COLUMNS_STATUS_ATTR, KANBAN_COLUMNS_TEXT, KANBAN_COLUMNS_TOUCH_PX, kanbanAddLabel, kanbanColumnsFormClass, kanbanColumnsSlot, kanbanCountText, kanbanDropText, kanbanReceiveText, kanbanRowStatusText, kanbanStatusText, } from './attrs.js';
+export { renderKanbanColumns } from './render.js';
+export { kanbanColumnsCss } from './style.js';
+export { buildKanbanColumnsJs } from './runtime.js';
+//# sourceMappingURL=index.js.map

package/dist/components/kanban-columns/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/kanban-columns/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,4BAA4B,EAC5B,0BAA0B,EAC1B,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,EAC1B,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAUpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/dist/components/kanban-columns/model.d.ts

@@ -0,0 +1,63 @@
+import { type KanbanColumnsForm } from './attrs.js';
+/** 归一化后的一张卡（`colKey` 是它现在住在哪一列；`badge` 是卡上那枚状态的字）。 */
+export interface KanbanCardRow {
+    readonly key: string;
+    readonly title: string;
+    readonly meta?: string;
+    /** 住在哪一列（列的机器键）。 */
+    readonly colKey: string;
+    /** 卡上那枚状态的字（它在哪一列：字，不只靠列位置）。 */
+    readonly badge: string;
+}
+/** 归一化后的一行物件（`grouped` 档的最小单位：整行就是那颗按钮）。 */
+export interface KanbanItemRow {
+    readonly key: string;
+    readonly label: string;
+    readonly value?: string;
+    /** 住在哪一列（列的机器键）——它就是事件 `detail.from`。 */
+    readonly colKey: string;
+}
+/** 归一化后的一个二级组（`count` 是屏上那一句「2 件」，与列计数同一个单位）。 */
+export interface KanbanGroupRow {
+    readonly name: string;
+    readonly items: readonly KanbanItemRow[];
+    /** 屏上那一句组计数（`2 件`）。 */
+    readonly count: string;
+}
+/** 归一化后的一列（`count` 是屏上那一句「2 道」；`mark` 是这一列的形）。
+ *  两档各自用 `cards`／`groups`——另一支照实留空（`status` 档的 `groups` 恒为 `[]`）。 */
+export interface KanbanColumnRow {
+    readonly key: string;
+    readonly name: string;
+    readonly purpose?: string;
+    readonly unit: string;
+    readonly cards: readonly KanbanCardRow[];
+    readonly groups: readonly KanbanGroupRow[];
+    /** 屏上那一句计数（`2 道`）。 */
+    readonly count: string;
+    /** 这一列的记号（●／▸／✓／◆，按列序取）。 */
+    readonly mark: string;
+}
+/** 被拿起的那一行（两档共用的最小读数：机器键 ＋ 它在哪一列 ＋ **屏上那个名字**）。
+ *  `status` 档取卡的标题、`grouped` 档取物件的名字——状态句念的就是它。 */
+export interface KanbanPickedRow {
+    readonly key: string;
+    readonly colKey: string;
+    readonly name: string;
+}
+/** 内部类型：`render.ts` 只吃它，不再自己碰 `any`。 */
+export interface KanbanColumnsModel {
+    readonly form: KanbanColumnsForm;
+    readonly id: string;
+    readonly columns: readonly KanbanColumnRow[];
+    /** 被拿起的那一行（没拿起＝`undefined`）。 */
+    readonly picked?: KanbanPickedRow;
+    /** 窄档当前列（1 起）。 */
+    readonly activeCol: number;
+    /** 状态句（真读数）。 */
+    readonly status: string;
+    readonly extraClass?: string;
+}
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `KanbanColumnsModel`。 */
+export declare function normalizeKanbanColumns(input: unknown): KanbanColumnsModel;
+//# sourceMappingURL=model.d.ts.map

package/dist/components/kanban-columns/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/components/kanban-columns/model.ts"],"names":[],"mappings":"AAiBA,OAAO,EAUL,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAEpB,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,uBAAuB;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;qEACqE;AACrE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,sBAAsB;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;mDACmD;AACnD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,gCAAgC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAClC,kBAAkB;IAClB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gBAAgB;IAChB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAiLD,8DAA8D;AAC9D,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAgEzE"}

package/dist/components/kanban-columns/model.js

@@ -0,0 +1,251 @@
+/** kanban-columns · **入参归一化与校验**（把 `any` 与说不出的 `unknown` 挡在门外，产出内部类型）。
+ *
+ *  三条口径（与 `command-palette/model.ts`／`drag-sort/model.ts` 同一条）：
+ *   1. **非法入参一律 `badInput()`**（抛 `BlocksError`）——不静默降级、不「尽量猜」：
+ *      猜出来的看板会让调用方以为自己拿到的是「卡在哪一列、选中了谁」的那块面。
+ *      · **全空白串＝拒**（`'   '` 会在屏上留一块空白：无字列名、无字卡、无字计数单位；
+ *        **零宽字符那类不可见字符同样算空白**——`trim()` 剥不掉它们，得先剥再判）；
+ *      · **入参表以外的键＝拒**（写错一个键名，调用方以为自己设上了，屏上却没有；
+ *        自有的不可枚举键与原型链上继承来的键**同样算**——只走 `Object.keys` 会漏掉这两类）；
+ *      · **键表按形态分**：`status` 档的列拿 `cards` 装东西、`grouped` 档拿 `groups` 装东西，
+ *        给错那一档的键＝拒（静默吞掉的话，调用方会把「一个组都没画出来」当成件坏了）。
+ *   2. **能算的都算出来**：每列的计数那一句、每组自己的计数那一句、状态句、收纳键的字——都在这里算好；
+ *      `render.ts` 只拼标记，一个字都不算。
+ *   3. **空是合法态**：`cards: []`（`status` 档）＝设计过的空槽；
+ *      `items: []`（`grouped` 档）＝设计过的空格（组名与计数照常在，**屏上不写一句旁白**——读数自己说清）。
+ */
+import { assertDenseArray, assertPlainObject, badInput, optExtraClass, optText, reqText } from '../shared/validate.js';
+import { KANBAN_COLUMNS_FORMS, KANBAN_COLUMNS_MARKS, KANBAN_COLUMNS_MAX_CARDS, KANBAN_COLUMNS_MAX_COLS, KANBAN_COLUMNS_MIN_COLS, KANBAN_COLUMNS_TEXT, kanbanCountText, kanbanRowStatusText, kanbanStatusText, } from './attrs.js';
+/** 不可见字符：零宽与格式那一类（`\u200b` 零宽空格、`\u200c/\u200d` 连接符、`\u200e/\u200f` 方向标记、
+ *  `\u2060` 词连接符、`\ufeff` 零宽不换行空格、`\u00ad` 软连字符）。**`String.prototype.trim()` 不管它们**
+ *  ——它按 Unicode WhiteSpace 剥，这几个是格式类（Cf）——所以「全空白」的判定得先把它们剥掉。 */
+const INVISIBLE_RE = /[\u00ad\u200b-\u200f\u2060\ufeff]/g;
+/** 「在屏上就是一块空白」：剥掉不可见字符再 `trim()`，剩下的还是空。 */
+function isBlank(text) {
+    return text.replace(INVISIBLE_RE, '').trim() === '';
+}
+/** 机器值：非空、**只许标识符字符**（它要当 `data-*` 的值使）。 */
+function reqIdentifier(value, field) {
+    const text = reqText(value, field);
+    if (!/^[A-Za-z_][A-Za-z0-9_-]*$/.test(text)) {
+        badInput(field + ' 只许标识符字符（字母、数字、下划线、连字符），它还要当 data-* 的值用');
+    }
+    return text;
+}
+/** 必填文本：非空串**且不是全空白**（全空白——含零宽那类不可见字符——会在屏上留一块空白，那是看得到的错）。 */
+function reqRealText(value, field) {
+    const text = reqText(value, field);
+    if (isBlank(text))
+        badInput(field + ' 必须是真正的文本（全空白不算，零宽字符这类不可见字符也不算）');
+    return text;
+}
+/** 可选文本：空串＝未给（与全层 `optText` 同口径）；**全空白＝拒**（那会在屏上留一块空白）。 */
+function optRealText(value, field) {
+    const text = optText(value, field);
+    if (text !== undefined && isBlank(text)) {
+        badInput(field + ' 必须是真正的文本（全空白不算，零宽字符这类不可见字符也不算）');
+    }
+    return text;
+}
+/** 只许入参表里写着的键：多给一个键（多半是打错名）＝拒，不静默吞掉。
+ *
+ *  **两条都会被查到**（只走 `Object.keys` 会漏一半）：
+ *   · `Object.getOwnPropertyNames` —— 自有的**全部**键，含**不可枚举**的（`Object.keys` 看不见它）；
+ *   · `for…in` —— 走**整条原型链**（`Object.create({bogus:1})` 那种继承来的键就是这一路）。
+ */
+function assertKeys(raw, allowed, field, hint) {
+    const bad = [];
+    const note = (key) => {
+        if (!allowed.includes(key) && !bad.includes(key))
+            bad.push(key);
+    };
+    for (const key of Object.getOwnPropertyNames(raw))
+        note(key);
+    for (const key in raw)
+        note(key);
+    if (bad.length > 0) {
+        badInput(field + ' 里没有 `' + bad.join('`／`') + '` 这个键（入参表以外的键一律拒：'
+            + '写错的键静默吞掉会让调用方以为自己设上了；继承来的与不可枚举的键同样算）'
+            + (hint === undefined ? '' : hint));
+    }
+}
+/** `KanbanColumnsInput` 的键（顶层入参表）。 */
+const INPUT_KEYS = ['id', 'columns', 'pickedKey', 'activeCol', 'form', 'extraClass'];
+/** `status` 档的列的键（一列的入参表）。 */
+const STATUS_COLUMN_KEYS = ['key', 'name', 'purpose', 'unit', 'cards'];
+/** `grouped` 档的列的键（一列的入参表）：这一档拿 `groups` 装东西，`cards`／`purpose` 不在表里。 */
+const GROUPED_COLUMN_KEYS = ['key', 'name', 'unit', 'groups'];
+/** `KanbanCard` 的键（一张卡的入参表）。 */
+const CARD_KEYS = ['key', 'title', 'meta'];
+/** `KanbanGroup` 的键（一个二级组的入参表）。 */
+const GROUP_KEYS = ['name', 'items'];
+/** `KanbanGroupItem` 的键（一行物件的入参表）。 */
+const ITEM_KEYS = ['key', 'label', 'value'];
+/** 给错形态的键时补的那半句：说清本档拿哪个键装东西。 */
+const STATUS_KEY_HINT = '｜本形态 `status` 的列拿 `cards` 装东西（`groups` 是 `grouped` 那一档的键）';
+const GROUPED_KEY_HINT = '｜本形态 `grouped` 的列拿 `groups` 装东西（`cards`／`purpose` 是 `status` 那一档的键）';
+/** 一张卡 → 一行（逐字段校验；机器键整份看板内唯一）。 */
+function reqCard(value, at, colKey, colName, seen) {
+    assertPlainObject(value, at);
+    const raw = value;
+    assertKeys(raw, CARD_KEYS, at);
+    const key = reqIdentifier(raw.key, at + '.key');
+    if (seen.has(key))
+        badInput(at + '.key 与看板里前面某一张卡的 key 重了（每张卡的 key 整份看板内唯一）');
+    seen.add(key);
+    const title = reqRealText(raw.title, at + '.title');
+    return {
+        key,
+        title,
+        meta: optRealText(raw.meta, at + '.meta'),
+        colKey,
+        badge: colName,
+    };
+}
+/** 一行物件 → 一行（逐字段校验；机器键整份看板内唯一，与列键也不许撞）。 */
+function reqItem(value, at, colKey, seen) {
+    assertPlainObject(value, at);
+    const raw = value;
+    assertKeys(raw, ITEM_KEYS, at);
+    const key = reqIdentifier(raw.key, at + '.key');
+    if (seen.has(key))
+        badInput(at + '.key 与看板里前面某一行／某一列的 key 重了（每个 key 整份看板内唯一）');
+    seen.add(key);
+    return {
+        key,
+        label: reqRealText(raw.label, at + '.label'),
+        value: optRealText(raw.value, at + '.value'),
+        colKey,
+    };
+}
+/** 一个二级组 → 一行（组名 ＋ 组计数；组里的行数上限与一列的卡数同一个数）。
+ *  组**没有机器键**：本件不拿它当数据（落点由结构定：收进来的行走这一列最后一组的末尾），
+ *  所以「组名重名的两个组」不是错——它们的区别是位置。 */
+function reqGroup(value, at, colKey, unit, seen) {
+    assertPlainObject(value, at);
+    const raw = value;
+    assertKeys(raw, GROUP_KEYS, at);
+    const name = reqRealText(raw.name, at + '.name');
+    const items = raw.items;
+    if (!Array.isArray(items))
+        badInput(at + '.items 必须是数组（空格请显式给 []：空格是合法态，不是缺席）');
+    assertDenseArray(items, at + '.items');
+    if (items.length > KANBAN_COLUMNS_MAX_CARDS) {
+        badInput(at + '.items 至多 ' + String(KANBAN_COLUMNS_MAX_CARDS) + ' 行（再多请调用方先分组）');
+    }
+    const rows = items.map((one, i) => reqItem(one, at + '.items[' + String(i) + ']', colKey, seen));
+    return { name, items: rows, count: kanbanCountText(rows.length, unit) };
+}
+/** 一列 → 一行（**键表按形态分**：`status` 档读 `cards`、`grouped` 档读 `groups`；空数组＝设计过的空态）。 */
+function reqColumn(value, at, index, seen, form) {
+    assertPlainObject(value, at);
+    const raw = value;
+    const grouped = form === 'grouped';
+    assertKeys(raw, grouped ? GROUPED_COLUMN_KEYS : STATUS_COLUMN_KEYS, at, grouped ? GROUPED_KEY_HINT : STATUS_KEY_HINT);
+    const key = reqIdentifier(raw.key, at + '.key');
+    if (seen.has(key))
+        badInput(at + '.key 与看板里前面某一列的 key 重了（每列的 key 看板内唯一）');
+    seen.add(key);
+    const name = reqRealText(raw.name, at + '.name');
+    const unitRaw = optRealText(raw.unit, at + '.unit');
+    const unit = unitRaw === undefined ? KANBAN_COLUMNS_TEXT.unit : unitRaw;
+    const mark = KANBAN_COLUMNS_MARKS[index % KANBAN_COLUMNS_MARKS.length];
+    if (grouped) {
+        const groups = raw.groups;
+        if (!Array.isArray(groups)) {
+            badInput(at + '.groups 必须是数组（`grouped` 档的列至少要有一组：那是这一列的格子）');
+        }
+        assertDenseArray(groups, at + '.groups');
+        if (groups.length === 0)
+            badInput(at + '.groups 至少一组（一组都没有的列请用 `status` 那一档）');
+        const rows = groups.map((one, i) => reqGroup(one, at + '.groups[' + String(i) + ']', key, unit, seen));
+        const total = rows.reduce((n, g) => n + g.items.length, 0);
+        if (total > KANBAN_COLUMNS_MAX_CARDS) {
+            badInput(at + '.groups 这一列合计至多 ' + String(KANBAN_COLUMNS_MAX_CARDS) + ' 行（再多请调用方先分列）');
+        }
+        return { key, name, unit, mark, cards: [], groups: rows, count: kanbanCountText(total, unit) };
+    }
+    const cards = raw.cards;
+    if (!Array.isArray(cards))
+        badInput(at + '.cards 必须是数组（空列请显式给 []：空列是合法态，不是缺席）');
+    assertDenseArray(cards, at + '.cards');
+    if (cards.length > KANBAN_COLUMNS_MAX_CARDS) {
+        badInput(at + '.cards 至多 ' + String(KANBAN_COLUMNS_MAX_CARDS) + ' 张（再多请调用方先分组）');
+    }
+    const rows = cards.map((one, i) => reqCard(one, at + '.cards[' + String(i) + ']', key, name, seen));
+    return {
+        key,
+        name,
+        purpose: optRealText(raw.purpose, at + '.purpose'),
+        unit,
+        mark,
+        cards: rows,
+        groups: [],
+        count: kanbanCountText(rows.length, unit),
+    };
+}
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `KanbanColumnsModel`。 */
+export function normalizeKanbanColumns(input) {
+    assertPlainObject(input, 'renderKanbanColumns: input');
+    const raw = input;
+    assertKeys(raw, INPUT_KEYS, 'renderKanbanColumns: input');
+    const form = raw.form === undefined ? KANBAN_COLUMNS_FORMS[0] : raw.form;
+    if (!KANBAN_COLUMNS_FORMS.includes(form)) {
+        badInput('kanban-columns: input.form 必须是 ' + KANBAN_COLUMNS_FORMS.join('／')
+            + ' 之一（本件落地两档骨架：`status` 按状态分列／`grouped` 按位置分列 ＋ 列内二级组）');
+    }
+    const id = reqIdentifier(raw.id, 'kanban-columns: input.id');
+    const list = raw.columns;
+    if (!Array.isArray(list))
+        badInput('kanban-columns: input.columns 必须是数组（1 列谈不上看板）');
+    assertDenseArray(list, 'kanban-columns: input.columns');
+    if (list.length < KANBAN_COLUMNS_MIN_COLS || list.length > KANBAN_COLUMNS_MAX_COLS) {
+        badInput('kanban-columns: input.columns 要 ' + String(KANBAN_COLUMNS_MIN_COLS)
+            + '–' + String(KANBAN_COLUMNS_MAX_COLS) + ' 列（再多请调用方先分组）');
+    }
+    const one = form;
+    const seen = new Set();
+    const columns = list.map((value, i) => reqColumn(value, 'kanban-columns: input.columns[' + String(i) + ']', i, seen, one));
+    const activeRaw = raw.activeCol;
+    let activeCol = 1;
+    if (activeRaw !== undefined) {
+        if (typeof activeRaw !== 'number' || !Number.isInteger(activeRaw)) {
+            badInput('kanban-columns: input.activeCol 必须是整数（第几列，1 起）');
+        }
+        if (activeRaw < 1 || activeRaw > columns.length) {
+            badInput('kanban-columns: input.activeCol 越界（看板只有 ' + String(columns.length) + ' 列）');
+        }
+        activeCol = activeRaw;
+    }
+    let picked;
+    const pickedRaw = raw.pickedKey;
+    if (pickedRaw !== undefined) {
+        if (typeof pickedRaw !== 'string' || pickedRaw === '') {
+            badInput('kanban-columns: input.pickedKey 必须是非空字符串（被拿起那一行的机器键）');
+        }
+        for (const col of columns) {
+            const hit = col.cards.find((c) => c.key === pickedRaw);
+            if (hit !== undefined)
+                picked = { key: hit.key, colKey: hit.colKey, name: hit.title };
+            for (const g of col.groups) {
+                const item = g.items.find((it) => it.key === pickedRaw);
+                if (item !== undefined)
+                    picked = { key: item.key, colKey: item.colKey, name: item.label };
+            }
+        }
+        if (picked === undefined)
+            badInput('kanban-columns: input.pickedKey 没有命中任何一张卡／一行物件（拿起的那一行必须真的在看板里）');
+    }
+    return {
+        form: one,
+        id,
+        columns,
+        picked,
+        activeCol,
+        /* 状态句按形态取：两档同一句语义，只有「拿起了什么」那一样东西的名字照实写
+           （`status` 档＝卡、`grouped` 档＝一行物件）。运行时段读的是同一对函数。 */
+        status: (one === 'grouped' ? kanbanRowStatusText : kanbanStatusText)(picked === undefined ? null : picked.name),
+        extraClass: optExtraClass(raw.extraClass, 'kanban-columns: input.extraClass'),
+    };
+}
+//# sourceMappingURL=model.js.map