@edv4h/usketch-plugin-dashboard 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EdV4H
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,52 @@
+# @edv4h/usketch-plugin-dashboard
+
+適用した Canvas 全体を **sortable なフロー・グリッド**にするプラグイン。トップレベルの
+Shape（付箋・画像・カード等、任意の既存 Shape）がグリッドのアイテムになる。各アイテムは
+**自身のサイズに応じて整数セル分を占有**（大きいものは複数セルをまたぐ = ダッシュボードの
+タイル）し、後続は first-fit でその周りに流し込まれる。アイテムはリサイズせず top-left だけ
+スナップする。1つをドラッグして差し込むと、他のアイテムがライブでリフローする。
+
+配置先のセル（グリッド領域）は**オーバーレイ**で可視化され、HUD の「グリッド表示」で
+トグルできる。
+
+専用のウィジェット Shape は追加しない。設定（列数・セルサイズ・間隔・余白・原点）は
+**データのみの `dashboard-config` シングルトン Shape**（描画なし・locked・非 hit-test）に
+保存され、Yjs 同期と Undo に自然に乗る。並び順は **幾何から導出**（row-major の reading
+order）するので、`order[]` を別途持たず、位置が同期されれば順序も同期・リロード安定になる。
+
+## 使い方
+
+```ts
+import { createDashboardPlugin } from "@edv4h/usketch-plugin-dashboard";
+
+createApp({
+  plugins: [
+    // container / free-position の後に登録する（during-drag reflow を最後の writer に）
+    createDashboardPlugin({ columns: 4, cellW: 200, cellH: 140, gap: 16, padding: 24 }),
+  ],
+});
+```
+
+`autoCreate: false` を渡すと、config シングルトンの作成（＝ボードのダッシュボード化）を
+ホスト側に委ねられる。
+
+## サービス API（`ctx.services` / `app.services`）
+
+```ts
+import { getDashboardApi } from "@edv4h/usketch-plugin-dashboard";
+
+const api = getDashboardApi(app.services);
+api?.repack();                 // 全アイテムを reading order のセルへ再スナップ（1 command）
+api?.setColumns(6);            // 列数変更（Undo 可・再レイアウト）
+api?.setCellSize(240, 160);
+api?.getGridSpec();            // 現在の GridSpec（非ダッシュボードなら null）
+api?.isDashboardBoard();
+```
+
+HUD の「ダッシュボード」設定グループと「整列」アクションからも同じ操作を呼べる。
+
+## 純関数
+
+`grid.ts`（`cellTopLeft` / `packGrid` / `packGridWithGap` / `indexFromPoint`）と
+`order.ts`（`readingOrder`）は副作用のない純関数として公開しており、runtime とサービスの
+両方が同じ経路を通る。

package/dist/config-ops.d.ts

@@ -0,0 +1,48 @@
+import type { BoardStore } from "@edv4h/usketch-shared";
+import { type DashboardConfigData, type DashboardDefaults, type DashboardMode, type ViewportLock } from "./dashboard-config-shape.js";
+import type { GridSpec } from "./grid.js";
+/** Grid settings a caller may change (identity/geometry-only subset of config). */
+export type DashboardConfigPatch = Partial<Pick<DashboardConfigData, "columns" | "cellW" | "cellH" | "gap" | "padding" | "originX" | "originY" | "mode" | "fitToGrid" | "freeOutOfRange" | "viewportLock" | "cellWAuto" | "swap" | "swapThreshold" | "swapDelay">>;
+/** The board's placement mode (defaults to `flow` when not a dashboard/unset). */
+export declare function modeOf(store: BoardStore): DashboardMode;
+/** Whether resizing snaps items to whole-cell sizes (defaults to `false`). */
+export declare function fitToGridOf(store: BoardStore): boolean;
+/** Whether out-of-range shapes are left free (defaults to `true`). */
+export declare function freeOutOfRangeOf(store: BoardStore): boolean;
+/** Whether the scroll-limit is on (defaults to off). Strict `=== true` so a config
+ *  persisted with the old `"off"|"vertical"|"both"` string coerces to OFF. */
+export declare function viewportLockOf(store: BoardStore): ViewportLock;
+/** Whether the cell width is "auto" (fit to screen) rather than a fixed number. */
+export declare function cellWAutoOf(store: BoardStore): boolean;
+/** Whether drop-onto-occupied swaps the two items (absolute mode). Defaults off. */
+export declare function swapOf(store: BoardStore): boolean;
+/** Minimum overlap ratio (0–1) for a swap to fire (absolute mode). Defaults 0.25. */
+export declare function swapThresholdOf(store: BoardStore): number;
+/** Dwell (ms) before the live avoid fires. Defaults 200 when unset; an explicit 0
+ *  (immediate) is honored. */
+export declare function swapDelayOf(store: BoardStore): number;
+/**
+ * The board's config singleton, or `undefined` if this board isn't a dashboard.
+ * If two clients happen to `enable()` at the same time, the board can briefly
+ * hold more than one config; pick the one with the smallest `id` so every client
+ * converges on the SAME config (rather than depending on Map insertion order,
+ * which can differ per client) — the grid then can't diverge across peers.
+ */
+export declare function getDashboardConfig(store: BoardStore): DashboardConfigData | undefined;
+/**
+ * Return the board's config singleton, creating it first if absent. Creating it
+ * is what turns a plain board INTO a dashboard (requirement: the applied Canvas
+ * becomes dashboard-only). Call after the store has hydrated so a synced config
+ * isn't duplicated.
+ */
+export declare function ensureDashboardConfig(store: BoardStore, defaults?: DashboardDefaults): DashboardConfigData;
+/** Every `dashboard-config` shape on the board. Normally 0 or 1, but a concurrent
+ *  `enable()` across clients can briefly leave more than one — {@link disable}
+ *  removes them all so the board reliably becomes a non-dashboard again. */
+export declare function getAllDashboardConfigs(store: BoardStore): DashboardConfigData[];
+/** Project the config singleton onto the pure {@link GridSpec} the grid math uses. */
+export declare function gridSpecFromConfig(config: DashboardConfigData): GridSpec;
+/** Direct (non-undoable) config write. The service wraps this in a command when
+ *  the change should be undoable; programmatic callers can use it as-is. */
+export declare function setConfig(store: BoardStore, patch: DashboardConfigPatch): void;
+//# sourceMappingURL=config-ops.d.ts.map

package/dist/config-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-ops.d.ts","sourceRoot":"","sources":["../src/config-ops.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,uBAAuB,CAAC;AACnE,OAAO,EACN,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAGlB,KAAK,YAAY,EACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,mFAAmF;AACnF,MAAM,MAAM,oBAAoB,GAAG,OAAO,CACzC,IAAI,CACH,mBAAmB,EACjB,SAAS,GACT,OAAO,GACP,OAAO,GACP,KAAK,GACL,SAAS,GACT,SAAS,GACT,SAAS,GACT,MAAM,GACN,WAAW,GACX,gBAAgB,GAChB,cAAc,GACd,WAAW,GACX,MAAM,GACN,eAAe,GACf,WAAW,CACb,CACD,CAAC;AAEF,kFAAkF;AAClF,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,CAEvD;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAEtD;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAE3D;AAED;8EAC8E;AAC9E,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CAE9D;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAEtD;AAED,oFAAoF;AACpF,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAEjD;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAGzD;AAED;8BAC8B;AAC9B,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAGrD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB,GAAG,SAAS,CAQrF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,UAAU,EACjB,QAAQ,GAAE,iBAAsB,GAC9B,mBAAmB,CAMrB;AAED;;4EAE4E;AAC5E,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB,EAAE,CAM/E;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,QAAQ,CAUxE;AAED;4EAC4E;AAC5E,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAM9E"}

package/dist/config-ops.js

@@ -0,0 +1,101 @@
+import { isDashboardConfig, makeDashboardConfig, } from "./dashboard-config-shape.js";
+/** The board's placement mode (defaults to `flow` when not a dashboard/unset). */
+export function modeOf(store) {
+    return getDashboardConfig(store)?.mode ?? "flow";
+}
+/** Whether resizing snaps items to whole-cell sizes (defaults to `false`). */
+export function fitToGridOf(store) {
+    return getDashboardConfig(store)?.fitToGrid ?? false;
+}
+/** Whether out-of-range shapes are left free (defaults to `true`). */
+export function freeOutOfRangeOf(store) {
+    return getDashboardConfig(store)?.freeOutOfRange ?? true;
+}
+/** Whether the scroll-limit is on (defaults to off). Strict `=== true` so a config
+ *  persisted with the old `"off"|"vertical"|"both"` string coerces to OFF. */
+export function viewportLockOf(store) {
+    return getDashboardConfig(store)?.viewportLock === true;
+}
+/** Whether the cell width is "auto" (fit to screen) rather than a fixed number. */
+export function cellWAutoOf(store) {
+    return getDashboardConfig(store)?.cellWAuto === true;
+}
+/** Whether drop-onto-occupied swaps the two items (absolute mode). Defaults off. */
+export function swapOf(store) {
+    return getDashboardConfig(store)?.swap === true;
+}
+/** Minimum overlap ratio (0–1) for a swap to fire (absolute mode). Defaults 0.25. */
+export function swapThresholdOf(store) {
+    const t = getDashboardConfig(store)?.swapThreshold;
+    return typeof t === "number" && Number.isFinite(t) ? Math.min(Math.max(t, 0), 1) : 0.25;
+}
+/** Dwell (ms) before the live avoid fires. Defaults 200 when unset; an explicit 0
+ *  (immediate) is honored. */
+export function swapDelayOf(store) {
+    const d = getDashboardConfig(store)?.swapDelay;
+    return typeof d === "number" && Number.isFinite(d) && d >= 0 ? d : 200;
+}
+/**
+ * The board's config singleton, or `undefined` if this board isn't a dashboard.
+ * If two clients happen to `enable()` at the same time, the board can briefly
+ * hold more than one config; pick the one with the smallest `id` so every client
+ * converges on the SAME config (rather than depending on Map insertion order,
+ * which can differ per client) — the grid then can't diverge across peers.
+ */
+export function getDashboardConfig(store) {
+    let chosen;
+    for (const [, shape] of store.getShapes()) {
+        if (isDashboardConfig(shape) && (chosen === undefined || shape.id < chosen.id)) {
+            chosen = shape;
+        }
+    }
+    return chosen;
+}
+/**
+ * Return the board's config singleton, creating it first if absent. Creating it
+ * is what turns a plain board INTO a dashboard (requirement: the applied Canvas
+ * becomes dashboard-only). Call after the store has hydrated so a synced config
+ * isn't duplicated.
+ */
+export function ensureDashboardConfig(store, defaults = {}) {
+    const existing = getDashboardConfig(store);
+    if (existing)
+        return existing;
+    const config = makeDashboardConfig(defaults);
+    store.addShape(config);
+    return config;
+}
+/** Every `dashboard-config` shape on the board. Normally 0 or 1, but a concurrent
+ *  `enable()` across clients can briefly leave more than one — {@link disable}
+ *  removes them all so the board reliably becomes a non-dashboard again. */
+export function getAllDashboardConfigs(store) {
+    const configs = [];
+    for (const [, shape] of store.getShapes()) {
+        if (isDashboardConfig(shape))
+            configs.push(shape);
+    }
+    return configs;
+}
+/** Project the config singleton onto the pure {@link GridSpec} the grid math uses. */
+export function gridSpecFromConfig(config) {
+    return {
+        columns: config.columns,
+        cellW: config.cellW,
+        cellH: config.cellH,
+        gap: config.gap,
+        padding: config.padding,
+        originX: config.originX,
+        originY: config.originY,
+    };
+}
+/** Direct (non-undoable) config write. The service wraps this in a command when
+ *  the change should be undoable; programmatic callers can use it as-is. */
+export function setConfig(store, patch) {
+    const config = getDashboardConfig(store);
+    if (!config)
+        return;
+    // Config carries custom fields on top of ShapeData; the store merges them
+    // verbatim (same pattern as the map plugin's shape-field writes).
+    store.updateShape(config.id, patch);
+}
+//# sourceMappingURL=config-ops.js.map

package/dist/config-ops.js.map

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

package/dist/dashboard-config-shape-def.d.ts

@@ -0,0 +1,4 @@
+import type { ShapeDefinition } from "@edv4h/usketch-shared";
+import { type DashboardDefaults } from "./dashboard-config-shape.js";
+export declare function createDashboardConfigShapeDefinition(defaults?: DashboardDefaults): ShapeDefinition;
+//# sourceMappingURL=dashboard-config-shape-def.d.ts.map

package/dist/dashboard-config-shape-def.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-config-shape-def.d.ts","sourceRoot":"","sources":["../src/dashboard-config-shape-def.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAA0B,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAEN,KAAK,iBAAiB,EAEtB,MAAM,6BAA6B,CAAC;AAErC,wBAAgB,oCAAoC,CACnD,QAAQ,GAAE,iBAAsB,GAC9B,eAAe,CA6BjB"}

package/dist/dashboard-config-shape-def.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { makeDashboardConfig, } from "./dashboard-config-shape.js";
+export function createDashboardConfigShapeDefinition(defaults = {}) {
+    return {
+        render: () => _jsx("g", {}),
+        renderTarget: "svg",
+        getBounds: () => ({ x: 0, y: 0, width: 0, height: 0 }),
+        hitTest: () => false,
+        resizable: false,
+        resize: (data) => data,
+        createDefault: (params) => ({ ...makeDashboardConfig(defaults), id: params.id }),
+        serializeForAi: (data) => {
+            const d = data;
+            return {
+                kind: "dashboard-config",
+                columns: d.columns,
+                cell: [d.cellW, d.cellH],
+                gap: d.gap,
+            };
+        },
+        debugFields: (data) => {
+            const d = data;
+            return {
+                columns: d.columns,
+                cell: `${d.cellW}×${d.cellH}`,
+                gap: d.gap,
+                padding: d.padding,
+                origin: `${d.originX},${d.originY}`,
+            };
+        },
+    };
+}
+//# sourceMappingURL=dashboard-config-shape-def.js.map

package/dist/dashboard-config-shape-def.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-config-shape-def.js","sourceRoot":"","sources":["../src/dashboard-config-shape-def.tsx"],"names":[],"mappings":";AAIA,OAAO,EAGN,mBAAmB,GACnB,MAAM,6BAA6B,CAAC;AAErC,MAAM,UAAU,oCAAoC,CACnD,QAAQ,GAAsB,EAAE;IAEhC,OAAO;QACN,MAAM,EAAE,GAAG,EAAE,CAAC,aAAK;QACnB,YAAY,EAAE,KAAK;QACnB,SAAS,EAAE,GAAgB,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QACnE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK;QACpB,SAAS,EAAE,KAAK;QAChB,MAAM,EAAE,CAAC,IAAI,EAAa,EAAE,CAAC,IAAI;QACjC,aAAa,EAAE,CAAC,MAAM,EAAa,EAAE,CAAC,CAAC,EAAE,GAAG,mBAAmB,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;QAC3F,cAAc,EAAE,CAAC,IAAI,EAA2B,EAAE;YACjD,MAAM,CAAC,GAAG,IAA2B,CAAC;YACtC,OAAO;gBACN,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC;gBACxB,GAAG,EAAE,CAAC,CAAC,GAAG;aACV,CAAC;QACH,CAAC;QACD,WAAW,EAAE,CAAC,IAAI,EAA2B,EAAE;YAC9C,MAAM,CAAC,GAAG,IAA2B,CAAC;YACtC,OAAO;gBACN,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE;gBAC7B,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,EAAE;aACnC,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/dashboard-config-shape.d.ts

@@ -0,0 +1,71 @@
+import type { ShapeData } from "@edv4h/usketch-shared";
+export declare const DASHBOARD_CONFIG_TYPE = "dashboard-config";
+/**
+ * Placement mode:
+ * - `flow` — items pack compactly in reading order (sortable; no gaps).
+ * - `absolute` — each item stays in the cell it's dropped on (gaps allowed).
+ */
+export type DashboardMode = "flow" | "absolute";
+/**
+ * Scroll-limit toggle. When ON, the viewport is locked to 100% zoom and the cell
+ * width auto-fits so the grid exactly fills the screen width — so there's no
+ * horizontal room and you scroll vertically only, bounded to the content. When OFF,
+ * pan/zoom are free. (Was a `"off"|"vertical"|"both"` mode; now a simple on/off.)
+ */
+export type ViewportLock = boolean;
+/** Grid settings persisted on the singleton. Geometry (`originX`/`originY`) lives
+ *  here too so the grid anchor is stable across reflows and reloads. */
+export interface DashboardConfigData extends ShapeData {
+    type: "dashboard-config";
+    columns: number;
+    cellW: number;
+    cellH: number;
+    gap: number;
+    padding: number;
+    originX: number;
+    originY: number;
+    mode: DashboardMode;
+    /** When true, resizing an item snaps its size to the nearest whole-cell span. */
+    fitToGrid: boolean;
+    /** When true, a shape dragged OUT of the grid's column range is left free
+     *  (unmanaged). When false, every top-level shape is managed regardless of
+     *  position. */
+    freeOutOfRange: boolean;
+    /** Scroll-limit toggle. See {@link ViewportLock}. */
+    viewportLock: ViewportLock;
+    /** Whether the cell WIDTH is "auto" (fit to the screen width). Drives the
+     *  scroll-limit mode: fixed numeric width → vertical-only; auto → both axes. */
+    cellWAuto: boolean;
+    /** In `absolute` mode, whether dropping an item onto an occupied cell makes that
+     *  occupant AVOID it — stepping to the nearest empty cell — instead of the drop
+     *  colliding. (Named `swap` historically.) No effect in `flow` (always reorders). */
+    swap: boolean;
+    /** Avoid trigger sensitivity (0–1): the minimum overlap ratio between the dropped
+     *  item and an occupant for the occupant to move aside. Lower = easier. */
+    swapThreshold: number;
+    /** Dwell before the LIVE avoid fires (ms): how long the dragged item must hover an
+     *  occupant before it steps aside. 0 = immediate. Only gates the drag-time preview;
+     *  a drop always resolves immediately. */
+    swapDelay: number;
+}
+export interface DashboardDefaults {
+    columns?: number;
+    cellW?: number;
+    cellH?: number;
+    gap?: number;
+    padding?: number;
+    originX?: number;
+    originY?: number;
+    mode?: DashboardMode;
+    fitToGrid?: boolean;
+    freeOutOfRange?: boolean;
+    viewportLock?: ViewportLock;
+    cellWAuto?: boolean;
+    swap?: boolean;
+    swapThreshold?: number;
+    swapDelay?: number;
+}
+export declare const DASHBOARD_DEFAULTS: Required<DashboardDefaults>;
+export declare function isDashboardConfig(shape: ShapeData): shape is DashboardConfigData;
+export declare function makeDashboardConfig(defaults?: DashboardDefaults): DashboardConfigData;
+//# sourceMappingURL=dashboard-config-shape.d.ts.map

package/dist/dashboard-config-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-config-shape.d.ts","sourceRoot":"","sources":["../src/dashboard-config-shape.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC;AAEnC;wEACwE;AACxE,MAAM,WAAW,mBAAoB,SAAQ,SAAS;IACrD,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC;IACpB,iFAAiF;IACjF,SAAS,EAAE,OAAO,CAAC;IACnB;;oBAEgB;IAChB,cAAc,EAAE,OAAO,CAAC;IACxB,qDAAqD;IACrD,YAAY,EAAE,YAAY,CAAC;IAC3B;oFACgF;IAChF,SAAS,EAAE,OAAO,CAAC;IACnB;;yFAEqF;IACrF,IAAI,EAAE,OAAO,CAAC;IACd;+EAC2E;IAC3E,aAAa,EAAE,MAAM,CAAC;IACtB;;8CAE0C;IAC1C,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,iBAAiB,CAgB1D,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,IAAI,mBAAmB,CAEhF;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,GAAE,iBAAsB,GAAG,mBAAmB,CA2BzF"}

package/dist/dashboard-config-shape.js

@@ -0,0 +1,51 @@
+import { generateId } from "@edv4h/usketch-shared";
+export const DASHBOARD_CONFIG_TYPE = "dashboard-config";
+export const DASHBOARD_DEFAULTS = {
+    columns: 4,
+    cellW: 200,
+    cellH: 140,
+    gap: 16,
+    padding: 24,
+    originX: 0,
+    originY: 0,
+    mode: "absolute",
+    fitToGrid: true,
+    freeOutOfRange: false,
+    viewportLock: true,
+    cellWAuto: true,
+    swap: true,
+    swapThreshold: 0.25,
+    swapDelay: 200,
+};
+export function isDashboardConfig(shape) {
+    return shape.type === DASHBOARD_CONFIG_TYPE;
+}
+export function makeDashboardConfig(defaults = {}) {
+    const d = { ...DASHBOARD_DEFAULTS, ...defaults };
+    return {
+        id: generateId(),
+        type: DASHBOARD_CONFIG_TYPE,
+        x: 0,
+        y: 0,
+        width: 0,
+        height: 0,
+        style: { fill: "transparent", stroke: "transparent", strokeWidth: 0, opacity: 1 },
+        columns: d.columns,
+        cellW: d.cellW,
+        cellH: d.cellH,
+        gap: d.gap,
+        padding: d.padding,
+        originX: d.originX,
+        originY: d.originY,
+        mode: d.mode,
+        fitToGrid: d.fitToGrid,
+        freeOutOfRange: d.freeOutOfRange,
+        viewportLock: d.viewportLock,
+        cellWAuto: d.cellWAuto,
+        swap: d.swap,
+        swapThreshold: d.swapThreshold,
+        swapDelay: d.swapDelay,
+        locked: true,
+    };
+}
+//# sourceMappingURL=dashboard-config-shape.js.map

package/dist/dashboard-config-shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-config-shape.js","sourceRoot":"","sources":["../src/dashboard-config-shape.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AAuExD,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC9D,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,GAAG;IACV,KAAK,EAAE,GAAG;IACV,GAAG,EAAE,EAAE;IACP,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,IAAI,EAAE,UAAU;IAChB,SAAS,EAAE,IAAI;IACf,cAAc,EAAE,KAAK;IACrB,YAAY,EAAE,IAAI;IAClB,SAAS,EAAE,IAAI;IACf,IAAI,EAAE,IAAI;IACV,aAAa,EAAE,IAAI;IACnB,SAAS,EAAE,GAAG;CACd,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,KAAgB;IACjD,OAAO,KAAK,CAAC,IAAI,KAAK,qBAAqB,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAQ,GAAsB,EAAE;IACnE,MAAM,CAAC,GAAG,EAAE,GAAG,kBAAkB,EAAE,GAAG,QAAQ,EAAE,CAAC;IACjD,OAAO;QACN,EAAE,EAAE,UAAU,EAAE;QAChB,IAAI,EAAE,qBAAqB;QAC3B,CAAC,EAAE,CAAC;QACJ,CAAC,EAAE,CAAC;QACJ,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,CAAC;QACT,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;QACjF,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,cAAc,EAAE,CAAC,CAAC,cAAc;QAChC,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,aAAa,EAAE,CAAC,CAAC,aAAa;QAC9B,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,MAAM,EAAE,IAAI;KACZ,CAAC;AACH,CAAC"}

package/dist/dashboard-runtime.d.ts

@@ -0,0 +1,23 @@
+import type { PluginContext } from "@edv4h/usketch-shared";
+/** Run `fn` with the dashboard-write guard raised so the reflow runtime ignores
+ *  the store mutations it produces. Exported so the service can guard its own
+ *  config command's execute/undo the same way. */
+export declare function runGuarded(fn: () => void): void;
+/**
+ * Snap every item to its reading-order cell, span-aware, in ONE guarded+undoable
+ * command. Used for non-drag changes (add/remove) and the "整列" action / service
+ * `repack()`. No-op writes are dropped, so it's safe to call speculatively.
+ */
+export declare function repackBoard(ctx: PluginContext, includeAll?: boolean): void;
+/**
+ * Repack every item to its reading-order cell WITHOUT a command (guarded, no undo
+ * entry). For automatic layout the user didn't ask for — e.g. the scroll-lock's
+ * auto cell-width refit on resize — where polluting the undo stack would be wrong.
+ */
+export declare function repackBoardTransient(ctx: PluginContext): void;
+/**
+ * Wire the live-reflow runtime. Returns a teardown that removes every listener
+ * and cancels any pending frame.
+ */
+export declare function setupDashboard(ctx: PluginContext): () => void;
+//# sourceMappingURL=dashboard-runtime.d.ts.map

package/dist/dashboard-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-runtime.d.ts","sourceRoot":"","sources":["../src/dashboard-runtime.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAuB,aAAa,EAAa,MAAM,uBAAuB,CAAC;AAiC3F;;kDAEkD;AAClD,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAO/C;AAyJD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,UAAU,UAAQ,GAAG,IAAI,CAwBxE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAiB7D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,IAAI,CAmhB7D"}