@grafloria/element 0.3.17 → 0.3.19

package/src/libs/element/src/index.js.map

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

package/src/libs/element/src/lib/dashboard-kit/dashboard.d.ts

@@ -0,0 +1,345 @@
+/**
+ * `dashboard({ views, widgets })` — the DATA-FIRST dashboard authoring API.
+ *
+ * The exact shape `erDiagram()` / `umlDiagram()` have for ER and UML: you
+ * describe WHAT the dashboard is, `render()` runs the returned `finalize(api)`
+ * automatically, and every interactive part (the pack grid, drag/resize with
+ * live push and a truthful placeholder, fit/grow, float, pin, undoable
+ * commands) wires itself.
+ *
+ * Before this, a developer got `bindDashboardGrid()` — a gesture BINDER one
+ * layer down — and had to hand-assemble everything above it: a GroupModel per
+ * view, a NodeModel per widget, `useHTMLLayer` / `widgetKind` metadata, grid
+ * cells, membership, then the bind. The demo page needed ~143 lines just to
+ * build its boards. That was the missing authoring layer; this is it:
+ *
+ * ```js
+ * const SPEC = dashboard({
+ *   columns: 12,
+ *   sizing: 'fit',
+ *   views: [{
+ *     id: 'overview', name: 'Overview',
+ *     widgets: [
+ *       { id: 'rev',   kind: 'kpi',   span: 3, rows: 1, data: {…} },
+ *       { id: 'trend', kind: 'line',  span: 8, rows: 2, data: {…} },
+ *       { id: 'mix',   kind: 'donut', span: 4, rows: 2, pinned: true },
+ *     ],
+ *   }],
+ *   renderWidget: (widget, host) => { … },   // optional: your charts
+ * });
+ * render(SPEC, host);
+ * ```
+ *
+ * WHAT IT DELIBERATELY DOES NOT DO: pick a charting library. `renderWidget` is
+ * the seam — the kit hands you the widget and a raw HTML host (the renderer's
+ * custom-node path, which unlike `metadata.html` is not sanitised, so real
+ * `<svg>`/`<canvas>` is fine). Omit it and `defaultWidgetRenderer` (widgets.ts)
+ * draws the declared `kind` from your own `data` with hand-rolled inline SVG —
+ * kpi / line / bar / donut / funnel / table, no dependency, no sample dataset —
+ * falling back to a titled frame for kinds it does not know, so a layout is
+ * testable before any chart exists.
+ *
+ * Cells are the truth and live in the existing `GridItemConfig`, so save/load
+ * round-trips with no extra work — same as every other kit.
+ */
+import { GroupModel, NodeModel, type GridColumnLayout } from '@grafloria/engine';
+import { type DashboardGridHandle, type DashboardGridOptions, type DashboardResponsiveOptions } from './grid-binder';
+/** A widget, declared as data. */
+export interface DashboardWidgetSpec {
+    id: string;
+    /** Free-form kind string handed back to `renderWidget` (e.g. 'kpi', 'line'). */
+    kind?: string;
+    /** Column span (default 3) and row span (default 1). */
+    span?: number;
+    rows?: number;
+    /**
+     * Explicit cell. Omit and widgets flow in declaration order, wrapping at
+     * the column count — the common case needs no coordinates at all.
+     */
+    x?: number;
+    y?: number;
+    /** Pinned: never pushed, refuses the mover, survives every reflow. */
+    pinned?: boolean;
+    /** Your payload — passed straight back to `renderWidget`. */
+    data?: Record<string, unknown>;
+    /** Optional title used by the built-in fallback renderer. */
+    title?: string;
+}
+/** One board. Multiple views are the tab pattern: only one is on-camera. */
+export interface DashboardViewSpec {
+    id: string;
+    name?: string;
+    widgets: DashboardWidgetSpec[];
+    /** Per-view overrides of the dashboard-level geometry. */
+    columns?: number;
+    width?: number;
+    height?: number;
+}
+export interface DashboardOptions {
+    /** Column count for every view (default 12). */
+    columns?: number;
+    /** Gap between widgets AND the board padding, px (default 8). */
+    gap?: number;
+    /** Sizing mode (default 'fit' — squeeze rows; 'grow' extends the board). */
+    sizing?: 'fit' | 'grow';
+    /** Row height in 'grow' mode, px (default 130). */
+    rowHeight?: number;
+    /** Board size, px (default 1180 × 660). */
+    width?: number;
+    height?: number;
+    /** Engine float mode (default false → gravity packs upward). */
+    float?: boolean;
+    /**
+     * RIGHT-TO-LEFT boards: column x=0 renders at the RIGHT edge and columns run
+     * leftwards. Cells are untouched — the same `widgets` array describes the
+     * same layout in both directions, and a layout saved in one renders mirrored
+     * in the other with identical cells.
+     */
+    rtl?: boolean;
+    /**
+     * RESPONSIVE COLUMN COUNT: derive the live count from each board's width.
+     * `{ columnWidth: 100 }` gives one column per ~100px (capped by `columns`);
+     * `{ breakpoints: [{ w: 480, c: 1 }, { w: 900, c: 6 }] }` names the steps.
+     * The count changes through the engine's per-column layout CACHE, so
+     * narrowing and widening again restores the wide layout exactly, and
+     * `toJSON()` keeps serialising the widest layout however narrow the board is.
+     */
+    responsive?: DashboardResponsiveOptions;
+    /** One view, or many (the tab pattern). Mutually exclusive with `widgets`. */
+    views?: DashboardViewSpec[];
+    /** Shorthand for a single unnamed view. */
+    widgets?: DashboardWidgetSpec[];
+    /**
+     * Paint a widget into its host element. Called once per widget when it
+     * mounts (the host is reused across re-renders, so this is not a per-frame
+     * hook). Omit for a titled placeholder frame.
+     */
+    renderWidget?: (widget: DashboardWidgetSpec, host: HTMLElement) => void;
+    /** Fires after any committed gesture, with the view whose layout changed. */
+    onLayoutChange?: (viewId: string, widgets: DashboardWidgetSpec[]) => void;
+    /** Extra binder options, merged last (escape hatch to the layer below). */
+    binder?: Partial<DashboardGridOptions>;
+}
+/** What `dashboard()` returns — a render spec plus the runtime handle. */
+export interface DashboardSpec {
+    nodes: Array<Record<string, unknown>>;
+    edges: Array<Record<string, unknown>>;
+    renderCustomNode: (node: unknown, host: HTMLElement) => void;
+    finalize: (api: unknown) => void;
+    /** Live handle, populated by finalize(). */
+    readonly handle: DashboardHandle;
+}
+/**
+ * A whole board as plain data: every `DashboardOptions` field except the
+ * function seams. `dashboard({ ...snapshot, renderWidget })` rebuilds it.
+ *
+ * Typed as an Omit rather than a hand-written twin on purpose — a field added
+ * to `DashboardOptions` then joins the snapshot automatically instead of being
+ * silently dropped, which is the exact failure this type exists to end.
+ */
+export type DashboardSnapshot = Omit<DashboardOptions, 'renderWidget' | 'onLayoutChange' | 'views'> & {
+    views: DashboardViewSpec[];
+};
+/** The typed façade — the `erTable`/`umlClass` equivalent for dashboards. */
+export interface DashboardHandle {
+    /** The view ids, in declaration order. */
+    readonly views: string[];
+    /** Show a view (the others park off-camera) and frame it. */
+    showView(id: string): void;
+    /** The currently shown view id. */
+    readonly activeView: string;
+    /** A widget handle by id (undefined when unknown). */
+    widget(id: string): WidgetHandle | undefined;
+    /** Every widget handle of a view (default: the active one). */
+    widgetsOf(viewId?: string): WidgetHandle[];
+    /** Live sizing/float switches — the two prototype toggles. */
+    setSizing(mode: 'fit' | 'grow'): void;
+    getSizing(): 'fit' | 'grow';
+    setFloat(on: boolean): void;
+    getFloat(): boolean;
+    /**
+     * Set the COLUMN COUNT of every board (or one view), live. Goes through the
+     * engine's per-column layout cache, so shrinking then growing back restores
+     * the wide layout rather than re-deriving it. An explicit call PINS the
+     * count — the width-driven `responsive` evaluator stops overriding it.
+     */
+    setColumns(n: number, layout?: GridColumnLayout, viewId?: string): void;
+    /** The LIVE column count of a view (default: the active one). */
+    getColumns(viewId?: string): number;
+    /** RTL mirroring, live — pixels only, cells never change. */
+    setRtl(on: boolean): void;
+    getRtl(): boolean;
+    /**
+     * Add a widget to a view. CREATES the node (you do not pre-build one), wires
+     * its metadata, and commits node + membership as ONE undoable step.
+     * Auto-positions when the spec names no cell.
+     */
+    addWidget(spec: DashboardWidgetSpec, viewId?: string): WidgetHandle | undefined;
+    /**
+     * Re-read every board from the model — call after undo/redo, or any
+     * out-of-band mutation, so the grid and the projection agree again.
+     */
+    refresh(): void;
+    /** Re-frame the camera on a view (default: the active one). */
+    fit(viewId?: string): void;
+    /** Live geometry of a view's board (columns, gap, rows, rowHeight, frame…). */
+    metrics(viewId?: string): ReturnType<DashboardGridHandle['metrics']> | undefined;
+    /**
+     * The whole board as plain data — feed it straight back to `dashboard()`:
+     *
+     * ```ts
+     * dashboard({ ...handle.toJSON(), renderWidget });   // a true round trip
+     * ```
+     *
+     * Everything `DashboardOptions` takes EXCEPT the function seams
+     * (`renderWidget`, `onLayoutChange`), which cannot be written to a file and
+     * must be supplied again on the way back in.
+     *
+     * Values are read from the LIVE board, not from the authored literal, so a
+     * mode or column count the user changed after mount is what you get back.
+     *
+     * This used to return only `views`, which made the round-trip claim true of
+     * the layout and false of the board: a board authored `grow` at a 10-column,
+     * 6px-gap geometry reloaded as a 12-column `fit` one. It is also what
+     * `JSON.stringify(handle)` calls, so the partial answer was a permanent
+     * footgun in a save API rather than merely an omission.
+     */
+    toJSON(): DashboardSnapshot;
+    /**
+     * The node ids ONE view occupies — pass straight to `includeIds` to export
+     * just that board:
+     *
+     * ```ts
+     * api.export('pdf', { includeIds: handle.exportIds() });
+     * ```
+     *
+     * WHY THIS EXISTS. Tabs park the inactive views far off-camera, which is
+     * invisible on screen and ruinous on export: `export()` frames the whole
+     * MODEL, so a two-view board writes a ~21,000px document that is almost
+     * entirely empty — with no warning, because nothing is technically wrong.
+     * Scoping was always possible; knowing WHAT to scope to was not.
+     *
+     * The set includes the view's GROUP as well as its widgets. Rolling this by
+     * hand from `toJSON()` looks equivalent and is not — it drops the group, and
+     * the widgets export without the frame they sit in.
+     */
+    exportIds(viewId?: string): Set<string>;
+    /**
+     * THE DOCUMENTED ESCAPE HATCH: the view's own `bindDashboardGrid` handle
+     * (default: the active view). Reach for it only for what this façade does
+     * not cover yet — palette drag-in (`beginPaletteDrag`), board `metrics()`,
+     * `cellRectOf`, `planRemoval`, and re-`sync()` after an external undo. Every
+     * call site is a named gap in this API, not a normal way to drive a board.
+     */
+    binderOf(viewId?: string): DashboardGridHandle | undefined;
+    dispose(): void;
+}
+/** One widget's OO surface (mirrors ErTable/UmlClass). */
+export interface WidgetHandle {
+    readonly id: string;
+    readonly viewId: string;
+    readonly node: NodeModel | undefined;
+    /** The DECLARED spec — read it back (title/kind/data) without a side map. */
+    readonly spec: DashboardWidgetSpec;
+    /** Current cell, as data. */
+    readonly cell: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    } | undefined;
+    /** The world rect the current cell projects to. */
+    readonly rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | undefined;
+    /** Resize in CELLS. Resolves TRUE when the board accepted it. */
+    resize(span: number, rows: number): Promise<boolean>;
+    /** Move to a cell. Resolves TRUE when the board accepted it. */
+    moveTo(x: number, y: number): Promise<boolean>;
+    /** Pin / unpin (a pinned widget refuses the mover and never gets pushed). */
+    pin(on?: boolean): void;
+    readonly pinned: boolean;
+    /** Raise / lower — one undoable step each (mirrors the toolbar commands). */
+    bringToFront(): void;
+    sendToBack(): void;
+    /**
+     * Remove it — ONE undoable step including the survivors' re-pack.
+     * `displaced` accepts the commands a drag-out gesture already computed;
+     * omit it and the handle plans them itself.
+     */
+    remove(displaced?: unknown[]): void;
+    /** Replace the widget's `data` (and optionally title) and repaint. */
+    update(patch: Partial<Pick<DashboardWidgetSpec, 'data' | 'title' | 'kind'>>): void;
+    /** Repaint through `renderWidget` (after your data changed). */
+    repaint(): void;
+}
+/**
+ * The API surface the handle drives — the slice of a DiagramInstance both
+ * `dashboard().finalize` and `fromDocument().finalize` hand in. Named (was an
+ * inline type on the old `apiRef` local) because two call sites now share it.
+ */
+export interface DashboardApiRef {
+    getModel(): {
+        getNode(id: string): NodeModel | undefined;
+        addGroup(g: GroupModel): void;
+        getGroup(id: string): GroupModel | undefined;
+        removeGroup?(id: string): unknown;
+    };
+    getEngine?: () => {
+        commandManager: {
+            execute(c: unknown): unknown;
+        };
+    };
+    renderNow(): void;
+    viewport?: {
+        fitToBounds(r: unknown, pad: number, o?: unknown): void;
+    };
+}
+/**
+ * Everything one `DashboardHandle` closes over, gathered into ONE object so a
+ * single builder can serve both `dashboard()` (context built from the authored
+ * literal) and `fromDocument()` (context reconstructed from the loaded model).
+ *
+ * `active` and `apiRef` are the two MUTABLE cells: the handle READS them on
+ * every call and the builder WRITES them (showView reassigns `active`, the
+ * caller's finalize sets `apiRef`). They live here rather than as free `let`s
+ * precisely because there are now two call sites — a boxed cell one builder
+ * reads and writes is the whole reason a second handle implementation, which
+ * would silently drift, is not needed.
+ */
+export interface DashboardHandleContext {
+    /** The views — MUTATED in place by addWidget (push) and remove (filter). */
+    views: DashboardViewSpec[];
+    groups: Map<string, GroupModel>;
+    binders: Map<string, DashboardGridHandle>;
+    specById: Map<string, DashboardWidgetSpec>;
+    viewOfWidget: Map<string, string>;
+    hosts: Map<string, HTMLElement>;
+    renderWidget: (widget: DashboardWidgetSpec, host: HTMLElement) => void;
+    columns: number;
+    gap: number;
+    rowHeight: number;
+    boardW: number;
+    boardH: number;
+    /**
+     * Spread verbatim into `toJSON()` output — carries width/height/responsive
+     * and any other authored option so a new `DashboardOptions` field round-trips
+     * for free (dashboard() passes the whole `options`; fromDocument() passes the
+     * geometry it can recover from the persisted board metadata).
+     */
+    optionsBase: Partial<DashboardOptions>;
+    /** MUTABLE — reassigned by showView(). */
+    active: string;
+    /** MUTABLE — set by the caller's finalize once the render API exists. */
+    apiRef: DashboardApiRef | null;
+}
+/**
+ * Build THE `DashboardHandle` — the one and only implementation, shared by
+ * `dashboard()` and `fromDocument()`. Reads/writes the mutable `ctx.active` /
+ * `ctx.apiRef` cells so the caller's finalize can wire the API in afterwards.
+ */
+export declare function createDashboardHandle(ctx: DashboardHandleContext): DashboardHandle;
+export declare function dashboard(options: DashboardOptions): DashboardSpec;