base-paint 0.3.13 → 0.3.15

package/dist/components/sync-status/attrs.js

@@ -0,0 +1,90 @@
+/** sync-status · **标记契约**（渲染与运行时共用的唯一事实：类名／形态闭集／结果闭集／事件名／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-11-加量池.mjs`，2026-09 用户裁定）
+ *  里的**形态 B「带『同步一次』动作」**：一页里跟外面那套东西对上没有——
+ *  每个目标一行（名字 ／ 方向 · 最近一次时间 · 这次跑了多久 ／ 结果），
+ *  **失败那一行必须能读出「原因」与「怎么修」**，底下带一枚「同步一次」。
+ *
+ *  交互契约（真运行时，见 `runtime.ts`）：
+ *   · 按「同步一次」→ 按钮进 `running`（原地换字、**宽度锁住不跳版**）＋ 派发 `SYNC_STATUS_EVENT_RUN`；
+ *   · 调用方跑完回来派发 `SYNC_STATUS_EVENT_DONE`（`detail = { ok, message? }`）→ 按钮出 `running`；
+ *     `ok === false` ⇒ **错误行写在控件旁边** ＋ `aria-describedby` 指过去（不只染色）；
+ *   · 到点还没消息（`SYNC_STATUS_RUN_TIMEOUT_MS`）也出错误行——**不许卡在「同步中…」**。
+ */
+/** 本件的类名根：全部槽位类名都是 `<前缀>block-sync-status-<槽名>`。 */
+export const SYNC_STATUS_CLASS = 'ilife-block-sync-status';
+/** 槽位闭集。 */
+export const SYNC_STATUS_SLOTS = [
+    /** 顶上那行汇总（最后检查 ／ 共几个目标 ／ 几个失败）。 */
+    'meta',
+    /** 目标行的容器。 */
+    'list',
+    /** 一个目标一行；带 `is-<结果>` 与 `data-ilife-sync-result` 两样结果标记。 */
+    'target',
+    /** 目标名（「飞书多维表」）；**非关键长名**，允许换行。 */
+    'name',
+    /** 那一行的时间线（方向 ／ 最近一次 ／ 这一趟的读数）：逐段一枚 `<span>`，**标记里不写分隔符**。 */
+    'detail',
+    /** 结果徽标：**记号 ＋ 字**（✓ 已同步 ／ ✗ 失败 ／ ○ 待运行）——色只是第三样。 */
+    'badge',
+    /** 失败行的两句话：原因 ＋ 怎么修（只有 `failed` 才出）。 */
+    'why',
+    /** 按钮那一排（说明 ＋ 按钮）。 */
+    'tool',
+    /** 按钮旁那句说明（按下去会发生什么）。 */
+    'hint',
+    /** 那枚按钮（两枚字占同一格，宽度取宽者）。 */
+    'button',
+    /** 按钮静止时的字（「同步一次」）。 */
+    'btn-rest',
+    /** 按钮跑起来时的字（「同步中…」）——两枚字**占同一格**，宽度取宽者 ⇒ 换字不跳版。 */
+    'btn-busy',
+    /** 错误行（写在控件旁边；`aria-describedby` 指过来）。 */
+    'error',
+    /** 一个目标都没有时的空态。 */
+    'empty',
+];
+/** 槽类的类名（唯一拼法）。 */
+export function syncStatusSlot(slot, prefix = 'ilife-') {
+    return prefix + 'block-sync-status-' + slot;
+}
+/** 形态闭集：本件只落地了形态 B「带『同步一次』动作」。 */
+export const SYNC_STATUS_FORMS = ['run'];
+/** 结果闭集（**机器键**）：`ok` 已同步 ／ `failed` 失败 ／ `pending` 还没跑过。 */
+export const SYNC_STATUS_RESULTS = ['ok', 'failed', 'pending'];
+/** 结果 → 屏上那句话（**记号在前、字在后**：色之外还有两样）。唯一出处，判据从这里取。 */
+export const SYNC_STATUS_RESULT_WORDS = Object.freeze({
+    ok: '✓ 已同步',
+    failed: '✗ 失败',
+    pending: '○ 待运行',
+});
+/** 失败行两句的左端标签（「原因」／「怎么修」）：**只要出失败行就带它们**。 */
+export const SYNC_STATUS_REASON_LABEL = '原因';
+export const SYNC_STATUS_FIX_LABEL = '怎么修';
+/** 按钮缺省的字（两枚：静止 / 跑起来）。 */
+export const SYNC_STATUS_ACTION_LABEL = '同步一次';
+export const SYNC_STATUS_RUNNING_LABEL = '同步中…';
+/** 到点没消息时错误行那句话（**不许卡在「同步中…」**）。 */
+export const SYNC_STATUS_TIMEOUT_TEXT = '没有收到回应：这一趟同步没跑完；可以再按一次「同步一次」，或者先看上面失败那一行的「怎么修」。';
+/** 调用方回了失败但没带话时的兜底错误句。 */
+export const SYNC_STATUS_FAILED_TEXT = '这一趟同步没有成功；上面失败那一行的「怎么修」写了下一步。';
+/** 按钮进入「跑起来了」的等待上限（毫秒）。 */
+export const SYNC_STATUS_RUN_TIMEOUT_MS = 15000;
+/** 发现锚：根元素上的 `data-*`（运行时按它找件）。 */
+export const SYNC_STATUS_ATTR = 'data-ilife-sync-status';
+/** 动作锚：按钮上的 `data-*`（`value` ＝ 动作名）。 */
+export const SYNC_STATUS_ACTION_ATTR = 'data-ilife-sync-action';
+/** 状态锚：根元素上的 `data-*`（`idle` ／ `running` ／ `failed`）。 */
+export const SYNC_STATUS_STATE_ATTR = 'data-ilife-sync-state';
+/** 绑定过的记号（重复注入只绑一次）。 */
+export const SYNC_STATUS_BOUND_ATTR = 'data-ilife-sync-bound';
+/** 错误行上的 `data-*`（运行时找它）。 */
+export const SYNC_STATUS_ERROR_ATTR = 'data-ilife-sync-error';
+/** 动作名（按钮 `data-*` 的取值；闭集，运行时只认它）。 */
+export const SYNC_STATUS_ACTIONS = ['run'];
+/** 运行时状态闭集（根元素 `data-*` 的取值）。 */
+export const SYNC_STATUS_STATES = ['idle', 'running', 'failed'];
+/** 按钮派发的事件名（调用方按它去真的同步）。 */
+export const SYNC_STATUS_EVENT_RUN = 'ilife:sync-run';
+/** 调用方跑完后派发的事件名（`detail = { ok, message? }`），冒泡到 `document` 即被接住。 */
+export const SYNC_STATUS_EVENT_DONE = 'ilife:sync-done';

package/dist/components/sync-status/attrs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.js","sourceRoot":"","sources":["../../../src/components/sync-status/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,oDAAoD;AACpD,MAAM,CAAC,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AAE3D,YAAY;AACZ,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,mCAAmC;IACnC,MAAM;IACN,cAAc;IACd,MAAM;IACN,4DAA4D;IAC5D,QAAQ;IACR,mCAAmC;IACnC,MAAM;IACN,8DAA8D;IAC9D,QAAQ;IACR,qDAAqD;IACrD,OAAO;IACP,wCAAwC;IACxC,KAAK;IACL,sBAAsB;IACtB,MAAM;IACN,yBAAyB;IACzB,MAAM;IACN,2BAA2B;IAC3B,QAAQ;IACR,uBAAuB;IACvB,UAAU;IACV,mDAAmD;IACnD,UAAU;IACV,0CAA0C;IAC1C,OAAO;IACP,mBAAmB;IACnB,OAAO;CACC,CAAC;AAGX,mBAAmB;AACnB,MAAM,UAAU,cAAc,CAAC,IAAoB,EAAE,MAAM,GAAG,QAAQ;IACpE,OAAO,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAAC;AAC9C,CAAC;AAED,kCAAkC;AAClC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAK,CAAU,CAAC;AAGlD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAGxE,oDAAoD;AACpD,MAAM,CAAC,MAAM,wBAAwB,GAA+C,MAAM,CAAC,MAAM,CAAC;IAChG,EAAE,EAAE,OAAO;IACX,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,6CAA6C;AAC7C,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAE3C,2BAA2B;AAC3B,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAC/C,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAEhD,oCAAoC;AACpC,MAAM,CAAC,MAAM,wBAAwB,GAAG,iDAAiD,CAAC;AAC1F,0BAA0B;AAC1B,MAAM,CAAC,MAAM,uBAAuB,GAAG,+BAA+B,CAAC;AAEvE,2BAA2B;AAC3B,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AAEhD,mCAAmC;AACnC,MAAM,CAAC,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AACzD,wCAAwC;AACxC,MAAM,CAAC,MAAM,uBAAuB,GAAG,wBAAwB,CAAC;AAChE,yDAAyD;AACzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,uBAAuB,CAAC;AAC9D,wBAAwB;AACxB,MAAM,CAAC,MAAM,sBAAsB,GAAG,uBAAuB,CAAC;AAC9D,6BAA6B;AAC7B,MAAM,CAAC,MAAM,sBAAsB,GAAG,uBAAuB,CAAC;AAE9D,sCAAsC;AACtC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAK,CAAU,CAAC;AAGpD,iCAAiC;AACjC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAGzE,4BAA4B;AAC5B,MAAM,CAAC,MAAM,qBAAqB,GAAG,gBAAgB,CAAC;AACtD,qEAAqE;AACrE,MAAM,CAAC,MAAM,sBAAsB,GAAG,iBAAiB,CAAC"}

package/dist/components/sync-status/index.d.ts

@@ -0,0 +1,19 @@
+/** sync-status · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  七个运行名：`renderSyncStatus(input)`（产标记，零 DOM）／`buildSyncStatusJs()`（运行时段，产 JS 文本）／
+ *  `syncStatusCss()`（样式段）／形态闭集 `SYNC_STATUS_FORMS`／结果闭集 `SYNC_STATUS_RESULTS`
+ *  与结果字表 `SYNC_STATUS_RESULT_WORDS`／两个事件名（`SYNC_STATUS_EVENT_RUN`／`_DONE`）／
+ *  类名根 `SYNC_STATUS_CLASS`。另出两个几何事实与四个类型名（入参面）。
+ *
+ *  调用时序：页面挂 `syncStatusCss()` ＋ 把 `buildSyncStatusJs()` 拼进共享 helpers 槽；
+ *  调用方监听 `SYNC_STATUS_EVENT_RUN` 去真的同步，跑完在**同一个根元素**上派发 `SYNC_STATUS_EVENT_DONE`
+ *  （`detail = { ok, message? }`）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { SYNC_STATUS_ACTION_ATTR, SYNC_STATUS_ACTIONS, SYNC_STATUS_ATTR, SYNC_STATUS_BOUND_ATTR, SYNC_STATUS_CLASS, SYNC_STATUS_ERROR_ATTR, SYNC_STATUS_EVENT_DONE, SYNC_STATUS_EVENT_RUN, SYNC_STATUS_FAILED_TEXT, SYNC_STATUS_FORMS, SYNC_STATUS_RESULTS, SYNC_STATUS_RESULT_WORDS, SYNC_STATUS_RUNNING_LABEL, SYNC_STATUS_RUN_TIMEOUT_MS, SYNC_STATUS_STATES, SYNC_STATUS_STATE_ATTR, SYNC_STATUS_TIMEOUT_TEXT, } from './attrs.js';
+export type { SyncStatusForm, SyncStatusInput, SyncStatusResult, SyncStatusState, SyncStatusTarget, } from './attrs.js';
+export { renderSyncStatus } from './render.js';
+export { buildSyncStatusJs } from './runtime.js';
+export { SYNC_STATUS_NARROW_PX, SYNC_STATUS_TOUCH_PX, syncStatusCss } from './style.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/sync-status/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/sync-status/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/sync-status/index.js

@@ -0,0 +1,17 @@
+/** sync-status · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  七个运行名：`renderSyncStatus(input)`（产标记，零 DOM）／`buildSyncStatusJs()`（运行时段，产 JS 文本）／
+ *  `syncStatusCss()`（样式段）／形态闭集 `SYNC_STATUS_FORMS`／结果闭集 `SYNC_STATUS_RESULTS`
+ *  与结果字表 `SYNC_STATUS_RESULT_WORDS`／两个事件名（`SYNC_STATUS_EVENT_RUN`／`_DONE`）／
+ *  类名根 `SYNC_STATUS_CLASS`。另出两个几何事实与四个类型名（入参面）。
+ *
+ *  调用时序：页面挂 `syncStatusCss()` ＋ 把 `buildSyncStatusJs()` 拼进共享 helpers 槽；
+ *  调用方监听 `SYNC_STATUS_EVENT_RUN` 去真的同步，跑完在**同一个根元素**上派发 `SYNC_STATUS_EVENT_DONE`
+ *  （`detail = { ok, message? }`）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { SYNC_STATUS_ACTION_ATTR, SYNC_STATUS_ACTIONS, SYNC_STATUS_ATTR, SYNC_STATUS_BOUND_ATTR, SYNC_STATUS_CLASS, SYNC_STATUS_ERROR_ATTR, SYNC_STATUS_EVENT_DONE, SYNC_STATUS_EVENT_RUN, SYNC_STATUS_FAILED_TEXT, SYNC_STATUS_FORMS, SYNC_STATUS_RESULTS, SYNC_STATUS_RESULT_WORDS, SYNC_STATUS_RUNNING_LABEL, SYNC_STATUS_RUN_TIMEOUT_MS, SYNC_STATUS_STATES, SYNC_STATUS_STATE_ATTR, SYNC_STATUS_TIMEOUT_TEXT, } from './attrs.js';
+export { renderSyncStatus } from './render.js';
+export { buildSyncStatusJs } from './runtime.js';
+export { SYNC_STATUS_NARROW_PX, SYNC_STATUS_TOUCH_PX, syncStatusCss } from './style.js';

package/dist/components/sync-status/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/sync-status/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAQpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/sync-status/model.d.ts

@@ -0,0 +1,29 @@
+import { type SyncStatusForm, type SyncStatusResult } from './attrs.js';
+/** 归一化后的一个目标。 */
+export interface SyncStatusTargetModel {
+    readonly name: string;
+    readonly direction?: string;
+    readonly lastAt?: string;
+    readonly detail?: string;
+    readonly result: SyncStatusResult;
+    /** 徽标那句（记号 ＋ 字）：闭集给的字，或调用方给的短话。 */
+    readonly badgeText: string;
+    readonly reason?: string;
+    readonly fix?: string;
+}
+/** 归一化后的入参。 */
+export interface SyncStatusModel {
+    readonly form: SyncStatusForm;
+    readonly targets: readonly SyncStatusTargetModel[];
+    readonly checkedAt?: string;
+    readonly hint?: string;
+    readonly actionLabel: string;
+    readonly id?: string;
+    /** 错误行的 id（`aria-describedby` 指过来）：给了 `id` 就用它加后缀，没给走件内缺省。 */
+    readonly errorId: string;
+    readonly failedCount: number;
+    readonly extraClass?: string;
+}
+/** 入参归一化。**唯一入口**：`render.ts` 与 `runtime.ts` 都只吃它产出的 `SyncStatusModel`。 */
+export declare function normalizeSyncStatus(input: unknown): SyncStatusModel;
+//# sourceMappingURL=model.d.ts.map

package/dist/components/sync-status/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/components/sync-status/model.ts"],"names":[],"mappings":"AAQA,OAAO,EAKL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EAEtB,MAAM,YAAY,CAAC;AAEpB,iBAAiB;AACjB,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,mCAAmC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,eAAe;AACf,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAqCD,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CA8BnE"}

package/dist/components/sync-status/model.js

@@ -0,0 +1,73 @@
+/** sync-status · **入参归一化与校验**（把 `any` 与说不出的 `unknown` 挡在门外，产出内部类型）。
+ *
+ *  三条口径：
+ *   1. **非法入参一律 `badInput()`**（抛 `BlocksError`）——不静默降级；
+ *   2. **失败行说不出「原因」与「怎么修」就是错的**（这一件存在的理由就是这两句）；
+ *   3. **算得出来的都不许调用方再给**：共几个目标、几个失败、徽标那句、错误行的 id 都是本件算的。
+ */
+import { assertPlainObject, badInput, optExtraClass, optText, reqText } from '../shared/validate.js';
+import { SYNC_STATUS_ACTION_LABEL, SYNC_STATUS_FORMS, SYNC_STATUS_RESULTS, SYNC_STATUS_RESULT_WORDS, } from './attrs.js';
+/** 一页多个时 `id` 不许撞车，所以它只能是「像 id 的样子」；别的写法一律拒。 */
+const ID_RE = /^[A-Za-z][A-Za-z0-9_:.-]*$/;
+/** 一个目标：校验 ＋ 算徽标那句。 */
+function targetModel(value, index) {
+    assertPlainObject(value, 'sync-status: input.targets[' + index + ']');
+    const raw = value;
+    const name = reqText(raw.name, 'sync-status: input.targets[' + index + '].name');
+    const resultGiven = raw.result;
+    if (!SYNC_STATUS_RESULTS.includes(resultGiven)) {
+        badInput('sync-status: input.targets[' + index + '].result 必须是 '
+            + SYNC_STATUS_RESULTS.join('／') + ' 之一');
+    }
+    const result = resultGiven;
+    const reason = optText(raw.reason, 'sync-status: input.targets[' + index + '].reason');
+    const fix = optText(raw.fix, 'sync-status: input.targets[' + index + '].fix');
+    if (result === 'failed') {
+        if (reason === undefined)
+            badInput('sync-status: input.targets[' + index + '] 结果是 failed ⇒ reason 必填（说不出原因的失败行等于没说）');
+        if (fix === undefined)
+            badInput('sync-status: input.targets[' + index + '] 结果是 failed ⇒ fix 必填（说不清怎么修的失败行等于没说）');
+    }
+    const status = optText(raw.status, 'sync-status: input.targets[' + index + '].status');
+    const mark = SYNC_STATUS_RESULT_WORDS[result].slice(0, 1);
+    return {
+        name,
+        direction: optText(raw.direction, 'sync-status: input.targets[' + index + '].direction'),
+        lastAt: optText(raw.lastAt, 'sync-status: input.targets[' + index + '].lastAt'),
+        detail: optText(raw.detail, 'sync-status: input.targets[' + index + '].detail'),
+        result,
+        /* 调用方给短话时**只换字、不换记号**：徽标永远「记号 ＋ 字」两样，色只是第三样。 */
+        badgeText: mark + ' ' + (status ?? SYNC_STATUS_RESULT_WORDS[result].slice(2)),
+        reason,
+        fix,
+    };
+}
+/** 入参归一化。**唯一入口**：`render.ts` 与 `runtime.ts` 都只吃它产出的 `SyncStatusModel`。 */
+export function normalizeSyncStatus(input) {
+    assertPlainObject(input, 'renderSyncStatus: input');
+    const raw = input;
+    const form = raw.form === undefined ? SYNC_STATUS_FORMS[0] : raw.form;
+    if (!SYNC_STATUS_FORMS.includes(form)) {
+        badInput('sync-status: input.form 必须是 ' + SYNC_STATUS_FORMS.join('／') + ' 之一（本件只落地形态 B「带同步一次动作」）');
+    }
+    const given = raw.targets;
+    if (!Array.isArray(given))
+        badInput('sync-status: input.targets 必须是数组');
+    const targets = given.map((t, i) => targetModel(t, i));
+    const id = optText(raw.id, 'sync-status: input.id');
+    if (id !== undefined && !ID_RE.test(id)) {
+        badInput('sync-status: input.id 只许字母开头的 id（字母／数字／下划线／点／横线／冒号）：' + id
+            + '——它要当错误行 id 的前缀（aria-describedby 指过来）');
+    }
+    return {
+        form: form,
+        targets,
+        checkedAt: optText(raw.checkedAt, 'sync-status: input.checkedAt'),
+        hint: optText(raw.hint, 'sync-status: input.hint'),
+        actionLabel: optText(raw.actionLabel, 'sync-status: input.actionLabel') ?? SYNC_STATUS_ACTION_LABEL,
+        id,
+        errorId: id === undefined ? 'ilife-block-sync-status-error' : id + '-error',
+        failedCount: targets.filter((t) => t.result === 'failed').length,
+        extraClass: optExtraClass(raw.extraClass, 'sync-status: input.extraClass'),
+    };
+}

package/dist/components/sync-status/model.js.map

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

package/dist/components/sync-status/render.d.ts

@@ -0,0 +1,3 @@
+/** 渲染同步状态（纯函数：同样的入参恒产同样的字节；转义只经 `shared/escape.ts`）。 */
+export declare function renderSyncStatus(input: unknown): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/components/sync-status/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/components/sync-status/render.ts"],"names":[],"mappings":"AAgGA,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOvD"}

package/dist/components/sync-status/render.js

@@ -0,0 +1,95 @@
+/** sync-status · **渲染**（纯函数产 HTML；本件只有形态 B「带『同步一次』动作」一种骨架）。
+ *
+ *  —— 形态 B：带「同步一次」动作 ——
+ *
+ *  顶上汇总一行（最后检查 ／ 共几个目标 ／ 几个失败）→ 逐目标一行（名字 ／ 方向 · 时间 · 读数 ／ 徽标）
+ *  → 失败那一行下面紧跟**原因 ＋ 怎么修** → 底下按钮那一排（说明 ＋ 「同步一次」）。
+ *
+ *  它替掉的两种错法：
+ *   · 失败只染一个红点 —— 读者知道坏了，不知道坏在哪、下一步敲什么；
+ *   · 「同步中…」把按钮换成一个更宽／更窄的字 —— 版面跟着跳，读者以为页面重排了。
+ *
+ *  三条硬口径（判据断的就是它们）：
+ *   · 徽标**永远是「记号 ＋ 字」**（✓／✗／○），色只是第三样；
+ *   · `failed` 那一行**必带**「原因」与「怎么修」两句（校验在 `model.ts` 就拦住了）；
+ *   · 按钮里两枚字（静止／跑起来）**占同一格**，宽度取宽者 ⇒ 换字不跳版。
+ */
+import { esc } from '../shared/escape.js';
+import { SYNC_STATUS_ACTION_ATTR, SYNC_STATUS_ACTIONS, SYNC_STATUS_ATTR, SYNC_STATUS_CLASS, SYNC_STATUS_ERROR_ATTR, SYNC_STATUS_FIX_LABEL, SYNC_STATUS_REASON_LABEL, SYNC_STATUS_RUNNING_LABEL, SYNC_STATUS_STATES, SYNC_STATUS_STATE_ATTR, syncStatusSlot, } from './attrs.js';
+import { normalizeSyncStatus } from './model.js';
+/** 一个目标一行。 */
+function targetHtml(t) {
+    const parts = ['<li class="' + syncStatusSlot('target') + ' is-' + t.result
+            + '" data-ilife-sync-result="' + esc(t.result) + '">'];
+    parts.push('<span class="' + syncStatusSlot('name') + '">' + esc(t.name) + '</span>');
+    /* 时间线：逐段一枚 `span`、段间只靠列距——**标记里不写分隔符**（分隔由样式承担）。 */
+    const segs = [];
+    if (t.direction !== undefined)
+        segs.push('<span>' + esc(t.direction) + '</span>');
+    if (t.lastAt !== undefined)
+        segs.push('<span>' + esc(t.lastAt) + '</span>');
+    if (t.detail !== undefined)
+        segs.push('<span>' + esc(t.detail) + '</span>');
+    parts.push('<span class="' + syncStatusSlot('detail') + '">' + segs.join('') + '</span>');
+    parts.push('<span class="' + syncStatusSlot('badge') + ' is-' + t.result + '">' + esc(t.badgeText) + '</span>');
+    if (t.result === 'failed' && t.reason !== undefined && t.fix !== undefined) {
+        parts.push('<p class="' + syncStatusSlot('why') + '">'
+            + '<b>' + esc(SYNC_STATUS_REASON_LABEL) + '</b>' + esc(t.reason)
+            + '<span><b>' + esc(SYNC_STATUS_FIX_LABEL) + '</b>' + esc(t.fix) + '</span></p>');
+    }
+    parts.push('</li>');
+    return parts.join('');
+}
+/** 按钮那一排：说明 ＋ 一枚按钮（两枚字占同一格，宽度取宽者）。 */
+function toolHtml(m) {
+    const parts = ['<div class="' + syncStatusSlot('tool') + '">'];
+    if (m.hint !== undefined) {
+        parts.push('<p class="' + syncStatusSlot('hint') + '">' + esc(m.hint) + '</p>');
+    }
+    parts.push('<button class="' + syncStatusSlot('button') + '" type="button" '
+        + SYNC_STATUS_ACTION_ATTR + '="' + esc(SYNC_STATUS_ACTIONS[0]) + '">');
+    parts.push('<span class="' + syncStatusSlot('btn-rest') + '">' + esc(m.actionLabel) + '</span>');
+    parts.push('<span class="' + syncStatusSlot('btn-busy') + '" aria-hidden="true">' + esc(SYNC_STATUS_RUNNING_LABEL) + '</span>');
+    parts.push('</button>');
+    parts.push('</div>');
+    return parts.join('');
+}
+/** 形态 B 的骨架。 */
+function renderRun(m) {
+    const parts = [];
+    if (m.targets.length === 0) {
+        /* 设计过的空态：说清「这里本来会写什么」，不留一个空壳。 */
+        parts.push('<p class="' + syncStatusSlot('empty') + '">还没有接过任何同步目标。</p>');
+        if (m.hint !== undefined)
+            parts.push('<p class="' + syncStatusSlot('hint') + '">' + esc(m.hint) + '</p>');
+        return parts.join('');
+    }
+    const meta = [];
+    if (m.checkedAt !== undefined)
+        meta.push('<span>最后检查 ' + esc(m.checkedAt) + '</span>');
+    meta.push('<span>共 ' + esc(String(m.targets.length)) + ' 个目标</span>');
+    if (m.failedCount > 0)
+        meta.push('<span>' + esc(String(m.failedCount)) + ' 个失败</span>');
+    parts.push('<p class="' + syncStatusSlot('meta') + '">' + meta.join('') + '</p>');
+    parts.push('<ul class="' + syncStatusSlot('list') + '">');
+    for (const t of m.targets)
+        parts.push(targetHtml(t));
+    parts.push('</ul>');
+    parts.push(toolHtml(m));
+    parts.push('<p class="' + syncStatusSlot('error') + '" id="' + esc(m.errorId) + '" '
+        + SYNC_STATUS_ERROR_ATTR + '="1" role="status" aria-live="polite" hidden></p>');
+    return parts.join('');
+}
+/** 形态 → 骨架（本件只有一格；分派写在这里，加第二形态就是加一支）。 */
+const SKELETONS = {
+    run: renderRun,
+};
+/** 渲染同步状态（纯函数：同样的入参恒产同样的字节；转义只经 `shared/escape.ts`）。 */
+export function renderSyncStatus(input) {
+    const m = normalizeSyncStatus(input);
+    const extra = m.extraClass === undefined ? '' : ' ' + m.extraClass;
+    return '<div class="' + SYNC_STATUS_CLASS + ' is-' + m.form + extra + '"'
+        + (m.id === undefined ? '' : ' id="' + esc(m.id) + '"')
+        + ' ' + SYNC_STATUS_ATTR + '="" ' + SYNC_STATUS_STATE_ATTR + '="' + SYNC_STATUS_STATES[0] + '">'
+        + SKELETONS[m.form](m) + '</div>';
+}

package/dist/components/sync-status/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/components/sync-status/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAoD,MAAM,YAAY,CAAC;AAEnG,cAAc;AACd,SAAS,UAAU,CAAC,CAAwB;IAC1C,MAAM,KAAK,GAAa,CAAC,aAAa,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,MAAM;cACjF,4BAA4B,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IACtF,oDAAoD;IACpD,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,CAAC;IAClF,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC;IAC5E,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC;IAC5E,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC;IAC1F,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,MAAM,GAAG,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,CAAC;IAChH,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI;cAClD,KAAK,GAAG,GAAG,CAAC,wBAAwB,CAAC,GAAG,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;cAC9D,WAAW,GAAG,GAAG,CAAC,qBAAqB,CAAC,GAAG,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,CAAC;IACtF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,sCAAsC;AACtC,SAAS,QAAQ,CAAC,CAAkB;IAClC,MAAM,KAAK,GAAa,CAAC,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IACzE,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;IAClF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,iBAAiB,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,kBAAkB;UACxE,uBAAuB,GAAG,IAAI,GAAG,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACzE,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC,CAAC;IACjG,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC,UAAU,CAAC,GAAG,uBAAuB,GAAG,GAAG,CAAC,yBAAyB,CAAC,GAAG,SAAS,CAAC,CAAC;IAChI,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,gBAAgB;AAChB,SAAS,SAAS,CAAC,CAAkB;IACnC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,iCAAiC;QACjC,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,oBAAoB,CAAC,CAAC;QAC1E,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QAC1G,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;IACD,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,CAAC;IACvF,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC;IACtE,IAAI,CAAC,CAAC,WAAW,GAAG,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC;IACxF,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC;IAClF,KAAK,CAAC,IAAI,CAAC,aAAa,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1D,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,IAAI;UAChF,sBAAsB,GAAG,mDAAmD,CAAC,CAAC;IAClF,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,yCAAyC;AACzC,MAAM,SAAS,GAA8E;IAC3F,GAAG,EAAE,SAAS;CACf,CAAC;AAEF,wDAAwD;AACxD,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,MAAM,CAAC,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,UAAU,CAAC;IACnE,OAAO,cAAc,GAAG,iBAAiB,GAAG,MAAM,GAAG,CAAC,CAAC,IAAI,GAAG,KAAK,GAAG,GAAG;UACrE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;UACrD,GAAG,GAAG,gBAAgB,GAAG,MAAM,GAAG,sBAAsB,GAAG,IAAI,GAAG,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI;UAC9F,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC;AACtC,CAAC"}

package/dist/components/sync-status/runtime.d.ts

@@ -0,0 +1,3 @@
+/** 产出运行时的 JS 文本（经典 script 作用域可跑的 IIFE；由页面拼进共享 helpers 槽）。 */
+export declare function buildSyncStatusJs(): string;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/components/sync-status/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/components/sync-status/runtime.ts"],"names":[],"mappings":"AA+BA,6DAA6D;AAC7D,wBAAgB,iBAAiB,IAAI,MAAM,CAgE1C"}

package/dist/components/sync-status/runtime.js

@@ -0,0 +1,83 @@
+/** sync-status · **运行时**（产出 JS 文本；DOM 只允许出现在这段文本里）。
+ *
+ *  与 `editable-value`／`controls.buildSharedHelpersJs()` 同一处分工：模块代码零 DOM，
+ *  DOM 只出现在本文件产出的**字符串**里。
+ *
+ *  行为契约（逐条对应判据）：
+ *   · **委派 ＋ 幂等**：`document` 上一枚 `click` 委派；重复注入只绑一次（`documentElement` 上的记号）。
+ *   · **按下**：按钮进 `running` —— `data-ilife-sync-state="running"` ＋ `disabled` ＋ `aria-busy="true"`；
+ *     按钮里那枚「同步中…」上屏（两枚字占同一格 ⇒ **宽度不跳**）；派发 `SYNC_STATUS_EVENT_RUN`
+ *     （冒泡，`detail = { action, targets }` —— `targets` 是这份清单里各目标的名字）。
+ *   · **跑完**：调用方派发 `SYNC_STATUS_EVENT_DONE`（`detail = { ok, message? }`）→ 出 `running`；
+ *     `ok === false` ⇒ 错误行写在**控件旁边** ＋ `aria-describedby` 指过去（不只染色）。
+ *   · **不许卡住**：`SYNC_STATUS_RUN_TIMEOUT_MS` 到点还没消息 ⇒ 出 `running` ＋ 错误行说「没收到回应」。
+ *   · **无脚本降级**：这段不跑时清单照常可读，只是按不动（按钮是原生 `button`，键盘仍能聚焦）。
+ *   · **只动 class／属性／一段文本**：不动版面尺寸（按钮宽度由两枚字中最宽的那枚决定）。
+ */
+import { SYNC_STATUS_ACTION_ATTR, SYNC_STATUS_ATTR, SYNC_STATUS_BOUND_ATTR, SYNC_STATUS_CLASS, SYNC_STATUS_ERROR_ATTR, SYNC_STATUS_EVENT_DONE, SYNC_STATUS_EVENT_RUN, SYNC_STATUS_FAILED_TEXT, SYNC_STATUS_RUN_TIMEOUT_MS, SYNC_STATUS_STATES, SYNC_STATUS_STATE_ATTR, SYNC_STATUS_TIMEOUT_TEXT, } from './attrs.js';
+/** 产出运行时的 JS 文本（经典 script 作用域可跑的 IIFE；由页面拼进共享 helpers 槽）。 */
+export function buildSyncStatusJs() {
+    const q = (s) => JSON.stringify(s);
+    return '(function(){' + '\n'
+        + '  var ATTR=' + q(SYNC_STATUS_ATTR) + ', ATTR_ACTION=' + q(SYNC_STATUS_ACTION_ATTR) + ';' + '\n'
+        + '  var ATTR_STATE=' + q(SYNC_STATUS_STATE_ATTR) + ', ATTR_BOUND=' + q(SYNC_STATUS_BOUND_ATTR) + ';' + '\n'
+        + '  var ATTR_ERROR=' + q(SYNC_STATUS_ERROR_ATTR) + ', CLASS_ROOT=' + q(SYNC_STATUS_CLASS) + ';' + '\n'
+        + '  var EV_RUN=' + q(SYNC_STATUS_EVENT_RUN) + ', EV_DONE=' + q(SYNC_STATUS_EVENT_DONE) + ';' + '\n'
+        + '  var ST_RUNNING=' + q(SYNC_STATUS_STATES[1]) + ', ST_IDLE=' + q(SYNC_STATUS_STATES[0]) + ';' + '\n'
+        + '  var ST_FAILED=' + q(SYNC_STATUS_STATES[2]) + ', TIMEOUT=' + String(SYNC_STATUS_RUN_TIMEOUT_MS) + ';' + '\n'
+        + '  var TX_TIMEOUT=' + q(SYNC_STATUS_TIMEOUT_TEXT) + ', TX_FAILED=' + q(SYNC_STATUS_FAILED_TEXT) + ';' + '\n'
+        + '  var doc=document;' + '\n'
+        + '  if (doc.documentElement.getAttribute("data-ilife-sync-runtime")==="1") return;' + '\n'
+        + '  doc.documentElement.setAttribute("data-ilife-sync-runtime","1");' + '\n'
+        + '  function rootOf(el){ return el && el.closest ? el.closest("["+ATTR+"]") : null; }' + '\n'
+        + '  function buttonOf(root){ return root.querySelector("["+ATTR_ACTION+"]"); }' + '\n'
+        + '  function errorOf(root){ return root.querySelector("["+ATTR_ERROR+"]"); }' + '\n'
+        + '  function namesOf(root){' + '\n'
+        + '    var out=[], cells=root.querySelectorAll("."+CLASS_ROOT+"-name");' + '\n'
+        + '    for (var i=0;i<cells.length;i+=1) out.push(cells[i].textContent);' + '\n'
+        + '    return out;' + '\n'
+        + '  }' + '\n'
+        /* 错误行：写在控件旁边 ＋ 把 aria-describedby 指过去（没话说时把指向收回来）。 */
+        + '  function fail(root, message){' + '\n'
+        + '    var box=errorOf(root), btn=buttonOf(root);' + '\n'
+        + '    root.setAttribute(ATTR_STATE, ST_FAILED);' + '\n'
+        + '    if (box){ box.textContent=message; box.hidden=false;'
+        + ' if (btn && box.id) btn.setAttribute("aria-describedby", box.id); }' + '\n'
+        + '  }' + '\n'
+        + '  function clearError(root){' + '\n'
+        + '    var box=errorOf(root), btn=buttonOf(root);' + '\n'
+        + '    if (box){ box.textContent=""; box.hidden=true; }' + '\n'
+        + '    if (btn) btn.removeAttribute("aria-describedby");' + '\n'
+        + '  }' + '\n'
+        + '  function settle(root, state){' + '\n'
+        + '    if (root.__ilifeSyncTimer){ clearTimeout(root.__ilifeSyncTimer); root.__ilifeSyncTimer=null; }' + '\n'
+        + '    var btn=buttonOf(root);' + '\n'
+        + '    root.setAttribute(ATTR_STATE, state);' + '\n'
+        + '    if (btn){ btn.disabled=false; btn.removeAttribute("aria-busy"); }' + '\n'
+        + '  }' + '\n'
+        + '  function start(root){' + '\n'
+        + '    var btn=buttonOf(root); if (!btn || btn.disabled) return;' + '\n'
+        + '    clearError(root);' + '\n'
+        + '    root.setAttribute(ATTR_STATE, ST_RUNNING);' + '\n'
+        + '    btn.disabled=true; btn.setAttribute("aria-busy","true");' + '\n'
+        + '    if (root.__ilifeSyncTimer) clearTimeout(root.__ilifeSyncTimer);' + '\n'
+        + '    root.__ilifeSyncTimer=setTimeout(function(){ settle(root, ST_FAILED); fail(root, TX_TIMEOUT); }, TIMEOUT);' + '\n'
+        + '    root.dispatchEvent(new CustomEvent(EV_RUN,{bubbles:true,detail:{'
+        + 'action:btn.getAttribute(ATTR_ACTION),targets:namesOf(root)}}));' + '\n'
+        + '  }' + '\n'
+        + '  doc.addEventListener("click", function(e){' + '\n'
+        + '    var t=e.target; if (!t || !t.closest) return;' + '\n'
+        + '    var btn=t.closest("["+ATTR_ACTION+"]"); if (!btn || btn.disabled) return;' + '\n'
+        + '    var root=rootOf(btn); if (!root) return;' + '\n'
+        + '    e.preventDefault(); start(root);' + '\n'
+        + '  });' + '\n'
+        + '  doc.addEventListener(EV_DONE, function(e){' + '\n'
+        + '    var node=e.target; var root=rootOf(node); if (!root) return;' + '\n'
+        + '    var d=(e.detail||{});' + '\n'
+        + '    settle(root, ST_IDLE);' + '\n'
+        + '    if (d.ok===false){ fail(root, d.message ? String(d.message) : TX_FAILED); } else { clearError(root); }' + '\n'
+        + '  });' + '\n'
+        + '  var all=doc.querySelectorAll("["+ATTR+"]");' + '\n'
+        + '  for (var j=0;j<all.length;j+=1) all[j].setAttribute(ATTR_BOUND,"1");' + '\n'
+        + '}());';
+}

package/dist/components/sync-status/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/components/sync-status/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAEpB,6DAA6D;AAC7D,MAAM,UAAU,iBAAiB;IAC/B,MAAM,CAAC,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACnD,OAAO,cAAc,GAAG,IAAI;UACxB,aAAa,GAAG,CAAC,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,GAAG,CAAC,CAAC,uBAAuB,CAAC,GAAG,GAAG,GAAG,IAAI;UAChG,mBAAmB,GAAG,CAAC,CAAC,sBAAsB,CAAC,GAAG,eAAe,GAAG,CAAC,CAAC,sBAAsB,CAAC,GAAG,GAAG,GAAG,IAAI;UAC1G,mBAAmB,GAAG,CAAC,CAAC,sBAAsB,CAAC,GAAG,eAAe,GAAG,CAAC,CAAC,iBAAiB,CAAC,GAAG,GAAG,GAAG,IAAI;UACrG,eAAe,GAAG,CAAC,CAAC,qBAAqB,CAAC,GAAG,YAAY,GAAG,CAAC,CAAC,sBAAsB,CAAC,GAAG,GAAG,GAAG,IAAI;UAClG,mBAAmB,GAAG,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,GAAG,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI;UACrG,kBAAkB,GAAG,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,GAAG,MAAM,CAAC,0BAA0B,CAAC,GAAG,GAAG,GAAG,IAAI;UAC9G,mBAAmB,GAAG,CAAC,CAAC,wBAAwB,CAAC,GAAG,cAAc,GAAG,CAAC,CAAC,uBAAuB,CAAC,GAAG,GAAG,GAAG,IAAI;UAC5G,qBAAqB,GAAG,IAAI;UAC5B,kFAAkF,GAAG,IAAI;UACzF,oEAAoE,GAAG,IAAI;UAC3E,qFAAqF,GAAG,IAAI;UAC5F,8EAA8E,GAAG,IAAI;UACrF,4EAA4E,GAAG,IAAI;UACnF,2BAA2B,GAAG,IAAI;UAClC,sEAAsE,GAAG,IAAI;UAC7E,uEAAuE,GAAG,IAAI;UAC9E,iBAAiB,GAAG,IAAI;UACxB,KAAK,GAAG,IAAI;QACd,sDAAsD;UACpD,iCAAiC,GAAG,IAAI;UACxC,gDAAgD,GAAG,IAAI;UACvD,+CAA+C,GAAG,IAAI;UACtD,0DAA0D;UAC1D,qEAAqE,GAAG,IAAI;UAC5E,KAAK,GAAG,IAAI;UACZ,8BAA8B,GAAG,IAAI;UACrC,gDAAgD,GAAG,IAAI;UACvD,sDAAsD,GAAG,IAAI;UAC7D,uDAAuD,GAAG,IAAI;UAC9D,KAAK,GAAG,IAAI;UACZ,iCAAiC,GAAG,IAAI;UACxC,oGAAoG,GAAG,IAAI;UAC3G,6BAA6B,GAAG,IAAI;UACpC,2CAA2C,GAAG,IAAI;UAClD,uEAAuE,GAAG,IAAI;UAC9E,KAAK,GAAG,IAAI;UACZ,yBAAyB,GAAG,IAAI;UAChC,+DAA+D,GAAG,IAAI;UACtE,uBAAuB,GAAG,IAAI;UAC9B,gDAAgD,GAAG,IAAI;UACvD,8DAA8D,GAAG,IAAI;UACrE,qEAAqE,GAAG,IAAI;UAC5E,gHAAgH,GAAG,IAAI;UACvH,sEAAsE;UACtE,iEAAiE,GAAG,IAAI;UACxE,KAAK,GAAG,IAAI;UACZ,8CAA8C,GAAG,IAAI;UACrD,mDAAmD,GAAG,IAAI;UAC1D,+EAA+E,GAAG,IAAI;UACtF,8CAA8C,GAAG,IAAI;UACrD,sCAAsC,GAAG,IAAI;UAC7C,OAAO,GAAG,IAAI;UACd,8CAA8C,GAAG,IAAI;UACrD,kEAAkE,GAAG,IAAI;UACzE,2BAA2B,GAAG,IAAI;UAClC,4BAA4B,GAAG,IAAI;UACnC,4GAA4G,GAAG,IAAI;UACnH,OAAO,GAAG,IAAI;UACd,+CAA+C,GAAG,IAAI;UACtD,wEAAwE,GAAG,IAAI;UAC/E,OAAO,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,10 @@
+/** 触控目标下限（px）：按钮的**命中盒**不得小于它（视觉盒可以小，命中盒必须够）。 */
+export declare const SYNC_STATUS_TOUCH_PX = 44;
+/** 窄容器阈值（px）：名字／时间／徽标由「一行三列」改走「上下两行」。
+ *  **这是本件自己的宽度**（`@container` 判的），不是视口宽度。 */
+export declare const SYNC_STATUS_NARROW_PX = 520;
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export declare function syncStatusCss(input?: {
+    readonly prefix?: string;
+}): string;
+//# sourceMappingURL=style.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/components/sync-status/style.ts"],"names":[],"mappings":"AAqBA,iDAAiD;AACjD,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;6CAC6C;AAC7C,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,4BAA4B;AAC5B,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAuO1E"}