@aceshooting/lyra-ui 4.0.0 → 4.1.0

package/dist/components/context-inspector/context-inspector.js

@@ -0,0 +1,10 @@
+export * from './context-inspector.class.js';
+import { LyraContextInspector } from './context-inspector.class.js';
+import { defineElement } from '../../internal/prefix.js';
+import '../context-meter/context-meter.js';
+import '../copy-button/copy-button.js';
+import '../export-button/export-button.js';
+import '../citation-badge/citation-badge.js';
+import '../empty/empty.js';
+defineElement('context-inspector', LyraContextInspector);
+//# sourceMappingURL=context-inspector.js.map

package/dist/components/context-inspector/context-inspector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-inspector.js","sourceRoot":"","sources":["../../../src/components/context-inspector/context-inspector.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,mCAAmC,CAAC;AAC3C,OAAO,+BAA+B,CAAC;AACvC,OAAO,mCAAmC,CAAC;AAC3C,OAAO,qCAAqC,CAAC;AAC7C,OAAO,mBAAmB,CAAC;AAC3B,aAAa,CAAC,mBAAmB,EAAE,oBAAoB,CAAC,CAAC"}

package/dist/components/context-inspector/context-inspector.styles.d.ts

@@ -0,0 +1,2 @@
+export declare const styles: import("lit").CSSResult;
+//# sourceMappingURL=context-inspector.styles.d.ts.map

package/dist/components/context-inspector/context-inspector.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-inspector.styles.d.ts","sourceRoot":"","sources":["../../../src/components/context-inspector/context-inspector.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,yBA+FlB,CAAC"}

package/dist/components/context-inspector/context-inspector.styles.js

@@ -0,0 +1,98 @@
+import { css } from 'lit';
+export const styles = css `
+  :host {
+    display: block;
+    inline-size: 100%;
+    min-inline-size: 0;
+    box-sizing: border-box;
+    font-family: var(--lr-font);
+    color: var(--lr-color-text);
+  }
+
+  [part='base'] {
+    display: flex;
+    flex-direction: column;
+    gap: var(--lr-space-m);
+    min-inline-size: 0;
+  }
+
+  [part='meter'] {
+    min-inline-size: 0;
+  }
+
+  [part='toolbar'] {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    justify-content: flex-end;
+    gap: var(--lr-space-xs);
+  }
+
+  [part='segments'] {
+    display: flex;
+    flex-direction: column;
+    gap: var(--lr-space-s);
+    min-inline-size: 0;
+  }
+
+  [part='segment'] {
+    display: flex;
+    flex-direction: column;
+    gap: var(--lr-space-xs);
+    min-inline-size: 0;
+    padding: var(--lr-space-s);
+    border: var(--lr-border-width-thin) solid var(--lr-color-border);
+    border-radius: var(--lr-radius);
+    background: var(--lr-color-surface);
+  }
+
+  [part='segment-header'] {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: var(--lr-space-xs);
+    min-inline-size: 0;
+  }
+
+  [part='segment-label'] {
+    font-weight: var(--lr-font-weight-semibold);
+    overflow-wrap: anywhere;
+    min-inline-size: 0;
+  }
+
+  [part='segment-tokens'] {
+    color: var(--lr-color-text-quiet);
+    font-size: var(--lr-font-size-xs);
+    white-space: nowrap;
+  }
+
+  [part='citation'] {
+    margin-inline-start: auto;
+  }
+
+  [part='segment-text'] {
+    min-inline-size: 0;
+    overflow-wrap: anywhere;
+    white-space: pre-wrap;
+    font-size: var(--lr-font-size-sm);
+    line-height: var(--lr-line-height-normal);
+  }
+
+  [part='redaction'] {
+    background: var(--lr-color-warning-quiet);
+    color: var(--lr-color-warning);
+    border-radius: var(--lr-radius-xs);
+    padding-inline: var(--lr-size-0-125rem);
+    font-family: var(--lr-font-mono);
+  }
+
+  [part='truncation-boundary'] {
+    margin-block-start: var(--lr-space-xs);
+    padding-block-start: var(--lr-space-2xs);
+    border-block-start: var(--lr-border-width-thin) dashed var(--lr-color-border);
+    color: var(--lr-color-text-quiet);
+    font-size: var(--lr-font-size-xs);
+    text-align: start;
+  }
+`;
+//# sourceMappingURL=context-inspector.styles.js.map

package/dist/components/context-inspector/context-inspector.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-inspector.styles.js","sourceRoot":"","sources":["../../../src/components/context-inspector/context-inspector.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+FxB,CAAC"}

package/dist/components/dashboard-grid/dashboard-grid.class.d.ts

@@ -0,0 +1,162 @@
+import { type TemplateResult, type PropertyValues } from 'lit';
+import { LyraElement } from '../../internal/lyra-element.js';
+import { type DashboardCell, type DashboardCollisionPolicy } from './layout.js';
+export interface LyraDashboardGridEventMap {
+    'lr-cell-move': CustomEvent<{
+        id: string;
+        position: {
+            x: number;
+            y: number;
+        };
+        previous: {
+            x: number;
+            y: number;
+        };
+    }>;
+    'lr-cell-resize': CustomEvent<{
+        id: string;
+        size: {
+            w: number;
+            h: number;
+        };
+        previous: {
+            w: number;
+            h: number;
+        };
+    }>;
+    'lr-collision': CustomEvent<{
+        id: string;
+        collidedWith: string[];
+        policy: DashboardCollisionPolicy;
+        accepted: boolean;
+    }>;
+    'lr-layout-change': CustomEvent<{
+        layout: DashboardCell[];
+    }>;
+}
+/**
+ * `<lr-dashboard-grid>` — a responsive, keyboard-accessible widget grid: positions `layout`
+ * entries (`DashboardCell`: `x`/`y`/`w`/`h` grid units + a widget descriptor) on a CSS Grid,
+ * composing `<lr-widget>` + `<lr-widget-renderer>` for each cell's default content, and owns all
+ * drag/resize/collision interaction as controlled events -- it never mutates `layout` itself, nor
+ * ever touches `localStorage`/network; the host applies (or ignores) every emitted event and owns
+ * persistence entirely, mirroring `lr-flow-canvas`/`lr-table`'s own controlled-component
+ * convention. Readonly (viewer) by default; opt into editor gestures individually via
+ * `cells-draggable`/`cells-resizable`, or lock the whole grid via `locked`.
+ *
+ * Cell content: a `layout` entry with no matching light-DOM child (matched by `cell-id`) gets a
+ * default `<lr-widget label="...">` wrapping an `<lr-widget-renderer .tree=${cell.widget}>`
+ * auto-created and adopted into `slot="cell-{id}"` -- this component's own job is the grid
+ * layout/drag/resize/collision/persistence-event mechanics *around* that content, not widget
+ * rendering itself (see `lr-widget-renderer`'s own doc for its declarative-tree contract). A
+ * consumer wanting full control over one cell's markup can instead author
+ * `<div cell-id="...">...</div>` as a direct child; it is adopted in place of the default cell.
+ *
+ * Keyboard: cells share one roving tabindex, in row-major (`sortSpatial`) order. Arrow
+ * keys/Home/End move the roving focus (RTL-aware: physical Left/Right always match what the
+ * cursor visually does, matching `lr-flow-canvas`'s own convention). While a cell has focus,
+ * Ctrl/Cmd+Arrow moves it by one grid unit and Ctrl/Cmd+Shift+Arrow resizes it by one grid unit
+ * (Right/Down grow, Left/Up shrink) -- the full keyboard-operable equivalent of the pointer
+ * drag/resize gestures below, per this library's accessibility bar (no pointer-only interaction).
+ *
+ * Collision: every move/resize request -- pointer or keyboard -- is resolved through `collision`
+ * (`'reject'` the default, `'push'`, or `'overlap'`; see `resolvePlacement()` in `layout.ts` for
+ * the exact rule). A rejected request leaves `layout` untouched and only announces; an accepted
+ * one emits `lr-cell-move`/`lr-cell-resize` plus a `lr-layout-change` snapshot of the full
+ * proposed layout (including any `'push'` cascade) -- the host's one persistence hook: listen for
+ * it and persist `event.detail.layout` however it likes (`localStorage`, a network call, neither).
+ *
+ * Responsive: below a ~40rem container allocation (`@container`, not the viewport -- a dashboard
+ * grid is commonly embedded in a panel of varying width), cells stack into a single flowing
+ * column in the same row-major order the grid itself renders them in, instead of overflowing or
+ * shrinking columns unreadably.
+ *
+ * @customElement lr-dashboard-grid
+ * @slot cell-{id} - A `layout` entry's cell content; auto-populated by a default composed
+ *   `<lr-widget>`/`<lr-widget-renderer>` pair unless a light-DOM `[cell-id="{id}"]` child is
+ *   authored instead.
+ * @event lr-cell-move - `detail: { id, position, previous }` — an accepted move committed.
+ * @event lr-cell-resize - `detail: { id, size, previous }` — an accepted resize committed.
+ * @event lr-collision - `detail: { id, collidedWith, policy, accepted }` — a move/resize request
+ *   overlapped at least one other cell, regardless of whether `policy` ultimately accepted it.
+ * @event lr-layout-change - `detail: { layout } }` — the full proposed layout after any accepted
+ *   move/resize (including a `'push'` cascade); the host's persistence hook.
+ * @csspart base - The grid root.
+ * @csspart empty - The `lr-empty` shown when `layout` is empty.
+ * @csspart cell - A single cell's positioned wrapper.
+ * @csspart resize-handle - The pointer resize grip in a cell's trailing/bottom corner (only
+ *   rendered while `cells-resizable`); the Ctrl/Cmd+Shift+Arrow keyboard path is the resize
+ *   handle's full accessible equivalent, so the handle itself is `aria-hidden`.
+ * @csspart live-region - The current move/resize/collision announcement.
+ */
+export declare class LyraDashboardGrid extends LyraElement<LyraDashboardGridEventMap> {
+    static styles: import("lit").CSSResultGroup[];
+    /** The grid's cells: position/size (grid units) + a widget descriptor per entry. Never mutated
+     *  by this component -- every move/resize is an event the host applies (or ignores). */
+    layout: DashboardCell[];
+    /** Column count of the underlying CSS Grid. */
+    columns: number;
+    /** Row track height, in px (also the pointer-resize/drag row snap pitch, together with `gap`). */
+    rowHeight: number;
+    /** Gap between cells, in px, on both axes. */
+    gap: number;
+    /** How a move/resize that would overlap another cell is resolved -- see the class doc. */
+    collision: DashboardCollisionPolicy;
+    /** Opts into pointer-drag + Ctrl/Cmd+Arrow keyboard move for unlocked cells. */
+    cellsDraggable: boolean;
+    /** Opts into the pointer resize handle + Ctrl/Cmd+Shift+Arrow keyboard resize for unlocked cells. */
+    cellsResizable: boolean;
+    /** Disables every drag/resize gesture grid-wide, regardless of `cells-draggable`/
+     *  `cells-resizable` or a cell's own `locked`. */
+    locked: boolean;
+    /** Overrides the grid region's accessible name; falls back to a generic localized label. Fed
+     *  only by a host `aria-label`, matching `lr-flow-canvas`'s own host-override pattern. */
+    accessibleLabel: string | null;
+    private get safeColumns();
+    private get safeRowHeight();
+    private get safeGap();
+    private get sortedLayout();
+    private readonly announcer;
+    private liveText;
+    private activeCellIndex;
+    private cellDrag?;
+    private cellResize?;
+    disconnectedCallback(): void;
+    protected willUpdate(changed: PropertyValues): void;
+    private cellLabel;
+    /** By-`cell-id` reconciliation of light-DOM children: a user-authored child gets
+     *  `slot="cell-{id}"` set on it and is left otherwise untouched; a `layout` entry with no
+     *  matching light-DOM child gets a default `<lr-widget>`/`<lr-widget-renderer>` pair created
+     *  and appended (marked `data-dashboard-grid-default-cell` so it -- and only it -- is removed
+     *  again once its cell id disappears, and kept in sync on every `layout` change). A light-DOM
+     *  child whose `cell-id` matches no current entry is left in place with no `slot` (renders
+     *  nowhere) and a console warning, exactly like `lr-flow-canvas`'s equivalent case. */
+    private syncDefaultCells;
+    private createDefaultCell;
+    private updateDefaultCell;
+    private onCellFocus;
+    private focusCellAt;
+    private onCellKeyDown;
+    private keyboardMove;
+    private keyboardResize;
+    private commitPlacement;
+    private cellStyle;
+    /** Column/row pixel pitch, measured once per gesture (not re-measured on every pointermove --
+     *  matches `lr-flow-canvas`'s own once-per-gesture rect-measurement convention). */
+    private measurePitch;
+    private resetCellInlineStyle;
+    private onCellPointerDown;
+    private onCellPointerMove;
+    private onCellPointerUp;
+    private onResizeHandlePointerDown;
+    private onResizeHandlePointerMove;
+    private onResizeHandlePointerUp;
+    private renderCell;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lr-dashboard-grid': LyraDashboardGrid;
+    }
+}
+//# sourceMappingURL=dashboard-grid.class.d.ts.map

package/dist/components/dashboard-grid/dashboard-grid.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-grid.class.d.ts","sourceRoot":"","sources":["../../../src/components/dashboard-grid/dashboard-grid.class.ts"],"names":[],"mappings":"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"}