@jini-ai/ui 0.1.0

package/dist/features/tab-strip/react/hooks/useTabStripDragReorder.d.ts

@@ -0,0 +1,59 @@
+import type { DragEvent, MouseEvent, RefObject } from 'react';
+import type { TabStripHapticsPort } from '../../ports.js';
+import type { TabStripDragTarget, TabStripDropEdge, TabStripReorderTiming, TabStripTab } from '../../types.js';
+export interface UseTabStripDragReorderOptions {
+    tabs: TabStripTab[];
+    /**
+     * Called with the semantic reorder instruction (move `sourceId` to just
+     * before/after `targetId`) whenever the drag gesture reports one. The
+     * hook never mutates `tabs` itself — tab order is host-owned state (the
+     * host applies `reorderTabIds` from `rules.ts`, or its own equivalent,
+     * and re-renders with the new `tabs` order), mirroring how neither source
+     * component's tab-item-level drag code owned the order array directly.
+     */
+    onReorder: (sourceId: string, targetId: string, edge: TabStripDropEdge) => void;
+    /**
+     * `'onDrop'` (default) fires `onReorder` only when the drag is released —
+     * `FileWorkspace.tsx`'s `Tab`/`reorderPersistedTab` behavior. `'live'`
+     * fires it continuously during `dragover` as the pointer crosses tab
+     * boundaries, live-shuffling the strip while dragging —
+     * `WorkspaceTabsBar.tsx`'s `handleStripDragOver` behavior. `onReorder`
+     * should be cheap/idempotent either way (both source implementations'
+     * own reorder functions already are, via the same-order no-op check).
+     */
+    reorderTiming?: TabStripReorderTiming | undefined;
+    /** Defaults to a no-op — opt in with `createBrowserTabStripHaptics()`. */
+    haptics?: TabStripHapticsPort | undefined;
+}
+export interface TabStripItemDragProps {
+    draggable: boolean;
+    onDragStart: (event: DragEvent<HTMLElement>) => void;
+    onDragEnd: () => void;
+    /** Wire onto the item's `onClick` (or call before invoking `onActivate`)
+     *  to suppress the spurious click a drag-and-drop gesture can produce —
+     *  ported from `WorkspaceTabsBar.tsx`'s `dragSuppressClickRef`. */
+    onClickCapture: (event: MouseEvent<HTMLElement>) => void;
+}
+export interface UseTabStripDragReorderResult {
+    draggingTabId: string | null;
+    dragOverTarget: TabStripDragTarget | null;
+    stripRef: RefObject<HTMLDivElement | null>;
+    stripDragProps: {
+        onDragOver: (event: DragEvent<HTMLElement>) => void;
+        onDrop: (event: DragEvent<HTMLElement>) => void;
+        onDragLeave: (event: DragEvent<HTMLElement>) => void;
+    };
+    getItemDragProps: (tabId: string) => TabStripItemDragProps;
+}
+/**
+ * Owns the drag-to-reorder gesture for a `TabStrip`. Hit-testing is
+ * centralized on the strip container (one `onDragOver`/`onDrop`, scanning
+ * `[data-tab-strip-item-id]` descendants) rather than wired per-item —
+ * `WorkspaceTabsBar.tsx`'s approach, adopted here as the single mechanism
+ * because it strictly generalizes `FileWorkspace.tsx`'s per-item
+ * `onDragOver` (which only ever fires while directly over a tab element and
+ * misses the gap after the last tab); every source-shape drag interaction
+ * still verified working through this one path in the dual-shape test.
+ */
+export declare function useTabStripDragReorder({ tabs, onReorder, reorderTiming, haptics, }: UseTabStripDragReorderOptions): UseTabStripDragReorderResult;
+//# sourceMappingURL=useTabStripDragReorder.d.ts.map

package/dist/features/tab-strip/react/hooks/useTabStripDragReorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTabStripDragReorder.d.ts","sourceRoot":"","sources":["../../../../../src/features/tab-strip/react/hooks/useTabStripDragReorder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAG9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAS1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE/G,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB;;;;;;;OAOG;IACH,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAChF;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAClD,0EAA0E;IAC1E,OAAO,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IACrD,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB;;uEAEmE;IACnE,cAAc,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,4BAA4B;IAC3C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC1C,QAAQ,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC3C,cAAc,EAAE;QACd,UAAU,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;QACpD,MAAM,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;QAChD,WAAW,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;KACtD,CAAC;IACF,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,qBAAqB,CAAC;CAC5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,IAAI,EACJ,SAAS,EACT,aAAwB,EACxB,OAA6B,GAC9B,EAAE,6BAA6B,GAAG,4BAA4B,CAkI9D"}

package/dist/features/tab-strip/react/hooks/useTabStripDragReorder.js

@@ -0,0 +1,130 @@
+import { useCallback, useRef, useState } from 'react';
+import { TAB_STRIP_DRAG_HAPTIC_MS, TAB_STRIP_DROP_HAPTIC_MS, TAB_STRIP_ITEM_ID_ATTRIBUTE } from '../../constants.js';
+import { noopTabStripHaptics } from '../../ports.js';
+import { coercePinnedDropTarget, dragTargetKey, dropEdgeFromPointerX, findNearestDropTarget, isTabDraggable, pinnedTabIdSet, } from '../../rules.js';
+/**
+ * Owns the drag-to-reorder gesture for a `TabStrip`. Hit-testing is
+ * centralized on the strip container (one `onDragOver`/`onDrop`, scanning
+ * `[data-tab-strip-item-id]` descendants) rather than wired per-item —
+ * `WorkspaceTabsBar.tsx`'s approach, adopted here as the single mechanism
+ * because it strictly generalizes `FileWorkspace.tsx`'s per-item
+ * `onDragOver` (which only ever fires while directly over a tab element and
+ * misses the gap after the last tab); every source-shape drag interaction
+ * still verified working through this one path in the dual-shape test.
+ */
+export function useTabStripDragReorder({ tabs, onReorder, reorderTiming = 'onDrop', haptics = noopTabStripHaptics, }) {
+    const stripRef = useRef(null);
+    const draggingTabIdRef = useRef(null);
+    const dragHapticTargetRef = useRef(null);
+    const suppressClickRef = useRef(false);
+    const [draggingTabId, setDraggingTabId] = useState(null);
+    const [dragOverTarget, setDragOverTarget] = useState(null);
+    const findDropTarget = useCallback((event, sourceId) => {
+        const strip = stripRef.current;
+        if (!strip)
+            return null;
+        const pinnedIds = pinnedTabIdSet(tabs);
+        const eventTarget = event.target;
+        if (eventTarget instanceof HTMLElement) {
+            const itemElement = eventTarget.closest(`[${TAB_STRIP_ITEM_ID_ATTRIBUTE}]`);
+            if (itemElement && strip.contains(itemElement)) {
+                const tabId = itemElement.getAttribute(TAB_STRIP_ITEM_ID_ATTRIBUTE);
+                if (tabId && tabId !== sourceId) {
+                    const rect = itemElement.getBoundingClientRect();
+                    const edge = dropEdgeFromPointerX(event.clientX, rect);
+                    return coercePinnedDropTarget({ tabId, edge }, pinnedIds);
+                }
+            }
+        }
+        const elements = Array.from(strip.querySelectorAll(`[${TAB_STRIP_ITEM_ID_ATTRIBUTE}]`)).map((element) => ({
+            // Non-null: every scanned element was matched BY this exact
+            // attribute selector, so it's always present — not a speculative
+            // fallback.
+            id: element.getAttribute(TAB_STRIP_ITEM_ID_ATTRIBUTE),
+            rect: element.getBoundingClientRect(),
+        }));
+        const fallback = findNearestDropTarget(event.clientX, elements, sourceId);
+        return fallback ? coercePinnedDropTarget(fallback, pinnedIds) : null;
+    }, [tabs]);
+    const pulseIfNewTarget = useCallback((target) => {
+        const key = dragTargetKey(target);
+        if (dragHapticTargetRef.current !== key) {
+            dragHapticTargetRef.current = key;
+            haptics.pulse(TAB_STRIP_DRAG_HAPTIC_MS);
+        }
+    }, [haptics]);
+    const clearDragState = useCallback(() => {
+        draggingTabIdRef.current = null;
+        dragHapticTargetRef.current = null;
+        setDragOverTarget(null);
+        setDraggingTabId(null);
+        window.setTimeout(() => {
+            suppressClickRef.current = false;
+        }, 0);
+    }, []);
+    const getItemDragProps = useCallback((tabId) => {
+        const tab = tabs.find((candidate) => candidate.id === tabId);
+        const draggable = tab ? isTabDraggable(tab, tabs) : false;
+        return {
+            draggable,
+            onDragStart: (event) => {
+                if (!draggable) {
+                    event.preventDefault();
+                    return;
+                }
+                suppressClickRef.current = true;
+                draggingTabIdRef.current = tabId;
+                dragHapticTargetRef.current = `${tabId}:self`;
+                setDragOverTarget(null);
+                setDraggingTabId(tabId);
+                event.dataTransfer.effectAllowed = 'move';
+                event.dataTransfer.setData('text/plain', tabId);
+                haptics.pulse(TAB_STRIP_DRAG_HAPTIC_MS);
+            },
+            onDragEnd: clearDragState,
+            onClickCapture: (event) => {
+                if (suppressClickRef.current) {
+                    suppressClickRef.current = false;
+                    event.preventDefault();
+                    event.stopPropagation();
+                }
+            },
+        };
+    }, [tabs, clearDragState, haptics]);
+    const stripDragProps = {
+        onDragOver: (event) => {
+            const sourceId = draggingTabIdRef.current ?? event.dataTransfer.getData('text/plain');
+            if (!sourceId)
+                return;
+            const target = findDropTarget(event, sourceId);
+            if (!target)
+                return;
+            event.preventDefault();
+            event.dataTransfer.dropEffect = 'move';
+            setDragOverTarget((current) => current && dragTargetKey(current) === dragTargetKey(target) ? current : target);
+            pulseIfNewTarget(target);
+            if (reorderTiming === 'live') {
+                onReorder(sourceId, target.tabId, target.edge);
+            }
+        },
+        onDrop: (event) => {
+            const sourceId = draggingTabIdRef.current ?? event.dataTransfer.getData('text/plain');
+            if (sourceId)
+                event.preventDefault();
+            const target = sourceId ? findDropTarget(event, sourceId) : null;
+            if (sourceId && target) {
+                onReorder(sourceId, target.tabId, target.edge);
+                haptics.pulse(TAB_STRIP_DROP_HAPTIC_MS);
+            }
+            clearDragState();
+        },
+        onDragLeave: (event) => {
+            const nextTarget = event.relatedTarget;
+            if (nextTarget instanceof Node && event.currentTarget.contains(nextTarget))
+                return;
+            setDragOverTarget(null);
+        },
+    };
+    return { draggingTabId, dragOverTarget, stripRef, stripDragProps, getItemDragProps };
+}
+//# sourceMappingURL=useTabStripDragReorder.js.map

package/dist/features/tab-strip/react/hooks/useTabStripDragReorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTabStripDragReorder.js","sourceRoot":"","sources":["../../../../../src/features/tab-strip/react/hooks/useTabStripDragReorder.ts"],"names":[],"mappings":"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"}

package/dist/features/tab-strip/rules.d.ts

@@ -0,0 +1,64 @@
+import type { TabStripDragTarget, TabStripDropEdge, TabStripElementRect, TabStripTab } from './types.js';
+/**
+ * Which edge of `rect` a pointer at `pointerX` lands on. Ported from
+ * `WorkspaceTabsBar.tsx`'s `tabDropEdgeFromElement` and
+ * `FileWorkspace.tsx`'s `tabDropEdgeFromEvent` — both compute this exact
+ * "left half vs right half of the target's bounding rect" split, just
+ * against a `DragEvent` directly rather than a plain `clientX` number. The
+ * pure form here takes the already-extracted `clientX`/rect so it needs no
+ * DOM/event types.
+ */
+export declare function dropEdgeFromPointerX(pointerX: number, rect: Pick<TabStripElementRect, 'left' | 'width'>): TabStripDropEdge;
+/**
+ * Coerces a drop target that would place a tab before a pinned tab into
+ * landing after it instead — pinned tabs always stay leftmost. Generalizes
+ * `WorkspaceTabsBar.tsx`'s `findTabDropTarget`'s `resolveTarget` closure
+ * (there hardcoded to the single entry tab; here driven by the host-
+ * supplied `pinned` field on any number of tabs).
+ */
+export declare function coercePinnedDropTarget(target: TabStripDragTarget, pinnedTabIds: ReadonlySet<string>): TabStripDragTarget;
+/**
+ * Moves `sourceId` to just before/after `targetId` in `tabIds`, preserving
+ * every other tab's relative order. Returns the same array reference when
+ * the move is a no-op (source/target equal, either id missing, or the
+ * resulting order is unchanged) so callers can skip a state update — same
+ * behavior as `WorkspaceTabsBar.tsx`'s `reorderTabsById` and
+ * `FileWorkspace.tsx`'s inline `reorderPersistedTab` splice, which is the
+ * exact same "filter the source out, find the target's new index, splice
+ * back in at index (+1 for 'after')" algorithm in both files.
+ */
+export declare function reorderTabIds(tabIds: readonly string[], sourceId: string, targetId: string, edge: TabStripDropEdge): string[];
+/** Ported verbatim (both files have an identical helper under this name). */
+export declare function arraysEqual(a: readonly string[], b: readonly string[]): boolean;
+/** A stable string key for a drag target, used to detect "did the hovered
+ *  target actually change" without a deep-equal check (ported from
+ *  `WorkspaceTabsBar.tsx`'s `tabDragTargetKey`). */
+export declare function dragTargetKey(target: TabStripDragTarget): string;
+/**
+ * Scans a list of candidate tab elements (by id + bounding rect) and picks
+ * the nearest valid drop target for `pointerX`, skipping `sourceId`. This is
+ * the fallback path of `WorkspaceTabsBar.tsx`'s `findTabDropTarget` — used
+ * when the pointer isn't directly over a tab element (e.g. hovering the gap
+ * after the last tab). Mirrors its "before the first candidate whose left
+ * half we're past, after the last candidate otherwise" loop exactly.
+ */
+export declare function findNearestDropTarget(pointerX: number, elements: ReadonlyArray<{
+    id: string;
+    rect: TabStripElementRect;
+}>, sourceId: string): TabStripDragTarget | null;
+/** The set of pinned tab ids in `tabs` — a small helper so callers don't
+ *  re-derive this `Set` construction inline in multiple places. */
+export declare function pinnedTabIdSet(tabs: readonly TabStripTab[]): Set<string>;
+/**
+ * Whether `tab` should be draggable given the full tab list. Combines the
+ * host's explicit `draggable` (falling back to `!pinned`) with the
+ * `WorkspaceTabsBar.tsx`-sourced rule that dragging is pointless (and
+ * disabled) when there's nothing to reorder against
+ * (`draggable={!isPinned && state.tabs.length > 1}`).
+ */
+export declare function isTabDraggable(tab: TabStripTab, tabs: readonly TabStripTab[]): boolean;
+/** Whether `tab` should render a close button, given an `onClose` handler
+ *  is supplied. Pinned tabs are never closable, matching both source
+ *  shapes (`WorkspaceTabsBar.tsx`'s entry tab, gated the same way). */
+export declare function isTabClosable(tab: TabStripTab, hasCloseHandler: boolean): boolean;
+//# sourceMappingURL=rules.d.ts.map

package/dist/features/tab-strip/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/features/tab-strip/rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,gBAAgB,CAE1H;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,kBAAkB,EAC1B,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,GAChC,kBAAkB,CAKpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,gBAAgB,GACrB,MAAM,EAAE,CAWV;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAG/E;AAED;;oDAEoD;AACpD,wBAAgB,aAAa,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAEhE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,aAAa,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,mBAAmB,CAAA;CAAE,CAAC,EAClE,QAAQ,EAAE,MAAM,GACf,kBAAkB,GAAG,IAAI,CAa3B;AAED;mEACmE;AACnE,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAExE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CAGtF;AAED;;uEAEuE;AACvE,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,GAAG,OAAO,CAIjF"}

package/dist/features/tab-strip/rules.js

@@ -0,0 +1,111 @@
+/**
+ * Which edge of `rect` a pointer at `pointerX` lands on. Ported from
+ * `WorkspaceTabsBar.tsx`'s `tabDropEdgeFromElement` and
+ * `FileWorkspace.tsx`'s `tabDropEdgeFromEvent` — both compute this exact
+ * "left half vs right half of the target's bounding rect" split, just
+ * against a `DragEvent` directly rather than a plain `clientX` number. The
+ * pure form here takes the already-extracted `clientX`/rect so it needs no
+ * DOM/event types.
+ */
+export function dropEdgeFromPointerX(pointerX, rect) {
+    return pointerX > rect.left + rect.width / 2 ? 'after' : 'before';
+}
+/**
+ * Coerces a drop target that would place a tab before a pinned tab into
+ * landing after it instead — pinned tabs always stay leftmost. Generalizes
+ * `WorkspaceTabsBar.tsx`'s `findTabDropTarget`'s `resolveTarget` closure
+ * (there hardcoded to the single entry tab; here driven by the host-
+ * supplied `pinned` field on any number of tabs).
+ */
+export function coercePinnedDropTarget(target, pinnedTabIds) {
+    if (target.edge === 'before' && pinnedTabIds.has(target.tabId)) {
+        return { tabId: target.tabId, edge: 'after' };
+    }
+    return target;
+}
+/**
+ * Moves `sourceId` to just before/after `targetId` in `tabIds`, preserving
+ * every other tab's relative order. Returns the same array reference when
+ * the move is a no-op (source/target equal, either id missing, or the
+ * resulting order is unchanged) so callers can skip a state update — same
+ * behavior as `WorkspaceTabsBar.tsx`'s `reorderTabsById` and
+ * `FileWorkspace.tsx`'s inline `reorderPersistedTab` splice, which is the
+ * exact same "filter the source out, find the target's new index, splice
+ * back in at index (+1 for 'after')" algorithm in both files.
+ */
+export function reorderTabIds(tabIds, sourceId, targetId, edge) {
+    const original = tabIds;
+    if (sourceId === targetId)
+        return original;
+    if (!tabIds.includes(sourceId))
+        return original;
+    const nextIds = tabIds.filter((id) => id !== sourceId);
+    const targetIndex = nextIds.indexOf(targetId);
+    if (targetIndex < 0)
+        return original;
+    nextIds.splice(edge === 'after' ? targetIndex + 1 : targetIndex, 0, sourceId);
+    return arraysEqual(nextIds, tabIds) ? original : nextIds;
+}
+/** Ported verbatim (both files have an identical helper under this name). */
+export function arraysEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    return a.every((value, index) => value === b[index]);
+}
+/** A stable string key for a drag target, used to detect "did the hovered
+ *  target actually change" without a deep-equal check (ported from
+ *  `WorkspaceTabsBar.tsx`'s `tabDragTargetKey`). */
+export function dragTargetKey(target) {
+    return `${target.tabId}:${target.edge}`;
+}
+/**
+ * Scans a list of candidate tab elements (by id + bounding rect) and picks
+ * the nearest valid drop target for `pointerX`, skipping `sourceId`. This is
+ * the fallback path of `WorkspaceTabsBar.tsx`'s `findTabDropTarget` — used
+ * when the pointer isn't directly over a tab element (e.g. hovering the gap
+ * after the last tab). Mirrors its "before the first candidate whose left
+ * half we're past, after the last candidate otherwise" loop exactly.
+ */
+export function findNearestDropTarget(pointerX, elements, sourceId) {
+    let lastTarget = null;
+    for (const element of elements) {
+        if (element.id === sourceId)
+            continue;
+        if (pointerX <= element.rect.left + element.rect.width / 2) {
+            return { tabId: element.id, edge: 'before' };
+        }
+        if (pointerX <= element.rect.right) {
+            return { tabId: element.id, edge: 'after' };
+        }
+        lastTarget = { tabId: element.id, edge: 'after' };
+    }
+    return lastTarget;
+}
+/** The set of pinned tab ids in `tabs` — a small helper so callers don't
+ *  re-derive this `Set` construction inline in multiple places. */
+export function pinnedTabIdSet(tabs) {
+    return new Set(tabs.filter((tab) => tab.pinned).map((tab) => tab.id));
+}
+/**
+ * Whether `tab` should be draggable given the full tab list. Combines the
+ * host's explicit `draggable` (falling back to `!pinned`) with the
+ * `WorkspaceTabsBar.tsx`-sourced rule that dragging is pointless (and
+ * disabled) when there's nothing to reorder against
+ * (`draggable={!isPinned && state.tabs.length > 1}`).
+ */
+export function isTabDraggable(tab, tabs) {
+    if (tabs.length <= 1)
+        return false;
+    return tab.draggable ?? !tab.pinned;
+}
+/** Whether `tab` should render a close button, given an `onClose` handler
+ *  is supplied. Pinned tabs are never closable, matching both source
+ *  shapes (`WorkspaceTabsBar.tsx`'s entry tab, gated the same way). */
+export function isTabClosable(tab, hasCloseHandler) {
+    if (tab.pinned)
+        return false;
+    if (!hasCloseHandler)
+        return false;
+    return tab.closable ?? true;
+}
+//# sourceMappingURL=rules.js.map

package/dist/features/tab-strip/rules.js.map

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

package/dist/features/tab-strip/types.d.ts

@@ -0,0 +1,55 @@
+import type { ReactNode } from 'react';
+/**
+ * Which side of the drop-target tab the dragged tab lands on. Shared
+ * concept across both source shapes this feature consolidates
+ * (`WorkspaceTabsBar.tsx`'s `TabDropEdge`, `FileWorkspace.tsx`'s
+ * `TabDropEdge`) — identical meaning in both.
+ */
+export type TabStripDropEdge = 'before' | 'after';
+export interface TabStripDragTarget {
+    tabId: string;
+    edge: TabStripDropEdge;
+}
+/**
+ * One tab-strip item. `content` is host-injected — the primitive never
+ * renders an icon or label itself, it just lays out whatever the host gives
+ * it (see `foundry/docs/jini-port/god-components-extraction-plan.md`'s consolidation
+ * map: "the specific parts become host-injected config, not part of the
+ * primitive").
+ */
+export interface TabStripTab {
+    id: string;
+    /** Icon + label + meta + badges — anything the host wants inside the tab. */
+    content: ReactNode;
+    /** Native `title`/tooltip text for the tab element. */
+    title?: string;
+    /**
+     * Whether this tab shows a close button, when an `onClose` handler is
+     * also supplied to `TabStrip`/`TabStripItem`. Defaults to `true`. Ignored
+     * (forced closed) when `pinned` is true.
+     */
+    closable?: boolean;
+    /**
+     * Whether this tab can be dragged to reorder. Defaults to `!pinned`. A
+     * host can still opt an unpinned tab out of dragging (e.g.
+     * `FileWorkspace.tsx`'s browser-kind tabs, which are never draggable
+     * regardless of pin state).
+     */
+    draggable?: boolean;
+    /**
+     * A pinned tab can never be dragged or closed and always sorts to the
+     * leftmost position: a drop edge that would place another tab before it
+     * is coerced to `'after'` instead. Generalizes
+     * `WorkspaceTabsBar.tsx`'s single permanent "entry" tab — no source shape
+     * in `FileWorkspace.tsx` uses this (all of its tab-strip items are
+     * unpinned), so it defaults to `false`/`undefined`.
+     */
+    pinned?: boolean;
+}
+export type TabStripReorderTiming = 'live' | 'onDrop';
+export interface TabStripElementRect {
+    left: number;
+    right: number;
+    width: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/features/tab-strip/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/tab-strip/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,6EAA6E;IAC7E,OAAO,EAAE,SAAS,CAAC;IACnB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/features/tab-strip/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/features/tab-strip/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/features/tab-strip/types.ts"],"names":[],"mappings":""}

package/dist/features/version-manager/constants.d.ts

@@ -0,0 +1,17 @@
+/** Once the version list is at least this long, show the search box —
+ *  matches the source's own threshold for when filtering starts earning
+ *  its screen space. */
+export declare const SEARCH_VISIBLE_THRESHOLD = 3;
+/** Auto-dismiss delay (ms) for the transient "Copied" state after copying
+ *  the generating prompt. Matches `features/viewer-shell/`'s
+ *  `COPY_FEEDBACK_RESET_MS`; kept as an independent constant here rather
+ *  than a cross-feature import of a numeric literal. */
+export declare const PROMPT_COPY_FEEDBACK_RESET_MS = 1600;
+/** If the iframe's `load` event is ever missed, clear the loading overlay
+ *  after this grace period so it can never get stuck over a rendered
+ *  document. */
+export declare const PREVIEW_LOAD_FALLBACK_MS = 6000;
+/** Default padding (px) subtracted from the measured canvas before fitting
+ *  a non-"no fixed frame" viewport preset to it. */
+export declare const DEFAULT_PREVIEW_CANVAS_PADDING = 48;
+//# sourceMappingURL=constants.d.ts.map

package/dist/features/version-manager/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/features/version-manager/constants.ts"],"names":[],"mappings":"AAAA;;wBAEwB;AACxB,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C;;;wDAGwD;AACxD,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAElD;;gBAEgB;AAChB,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C;oDACoD;AACpD,eAAO,MAAM,8BAA8B,KAAK,CAAC"}

package/dist/features/version-manager/constants.js

@@ -0,0 +1,17 @@
+/** Once the version list is at least this long, show the search box —
+ *  matches the source's own threshold for when filtering starts earning
+ *  its screen space. */
+export const SEARCH_VISIBLE_THRESHOLD = 3;
+/** Auto-dismiss delay (ms) for the transient "Copied" state after copying
+ *  the generating prompt. Matches `features/viewer-shell/`'s
+ *  `COPY_FEEDBACK_RESET_MS`; kept as an independent constant here rather
+ *  than a cross-feature import of a numeric literal. */
+export const PROMPT_COPY_FEEDBACK_RESET_MS = 1600;
+/** If the iframe's `load` event is ever missed, clear the loading overlay
+ *  after this grace period so it can never get stuck over a rendered
+ *  document. */
+export const PREVIEW_LOAD_FALLBACK_MS = 6000;
+/** Default padding (px) subtracted from the measured canvas before fitting
+ *  a non-"no fixed frame" viewport preset to it. */
+export const DEFAULT_PREVIEW_CANVAS_PADDING = 48;
+//# sourceMappingURL=constants.js.map

package/dist/features/version-manager/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/features/version-manager/constants.ts"],"names":[],"mappings":"AAAA;;wBAEwB;AACxB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAE1C;;;wDAGwD;AACxD,MAAM,CAAC,MAAM,6BAA6B,GAAG,IAAI,CAAC;AAElD;;gBAEgB;AAChB,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C;oDACoD;AACpD,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,CAAC"}

package/dist/features/version-manager/dependencies.d.ts

@@ -0,0 +1,17 @@
+import type { VersionRecord } from './types.js';
+import type { VersionManagerClipboardPort, VersionManagerDependencies, VersionManagerPort } from './ports.js';
+/**
+ * An in-memory test/demo double, keyed by `fileRef.scopeId + ':' + fileRef.name`
+ * so multiple file refs don't collide. Ships as the default (per the
+ * `features/connectors/` canary's own precedent: "ship a fake, not a real
+ * transport call") — a real host binds its own REST/daemon calls to
+ * `VersionManagerPort` instead.
+ */
+export declare function createFakeVersionManagerPort<TVersion extends VersionRecord = VersionRecord>(seed?: ReadonlyMap<string, TVersion[]>): VersionManagerPort<TVersion>;
+/** Reuses `features/viewer-shell/`'s real browser clipboard implementation
+ *  — clipboard access is a generic browser API with no backend shape to
+ *  fake, same reasoning that feature's own `dependencies.ts` documents. */
+export declare function createBrowserVersionManagerClipboard(): VersionManagerClipboardPort;
+export declare function createDefaultVersionManagerDependencies<TVersion extends VersionRecord = VersionRecord>(): VersionManagerDependencies<TVersion>;
+export declare const defaultVersionManagerDependencies: VersionManagerDependencies;
+//# sourceMappingURL=dependencies.d.ts.map

package/dist/features/version-manager/dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../../src/features/version-manager/dependencies.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAyB,aAAa,EAAwB,MAAM,YAAY,CAAC;AAC7F,OAAO,KAAK,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE9G;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,SAAS,aAAa,GAAG,aAAa,EACzF,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,GACrC,kBAAkB,CAAC,QAAQ,CAAC,CAuB9B;AAED;;2EAE2E;AAC3E,wBAAgB,oCAAoC,IAAI,2BAA2B,CAElF;AAED,wBAAgB,uCAAuC,CACrD,QAAQ,SAAS,aAAa,GAAG,aAAa,KAC3C,0BAA0B,CAAC,QAAQ,CAAC,CAKxC;AAOD,eAAO,MAAM,iCAAiC,EAAE,0BACL,CAAC"}

package/dist/features/version-manager/dependencies.js

@@ -0,0 +1,49 @@
+import { createBrowserViewerClipboard } from '../viewer-shell/index.js';
+/**
+ * An in-memory test/demo double, keyed by `fileRef.scopeId + ':' + fileRef.name`
+ * so multiple file refs don't collide. Ships as the default (per the
+ * `features/connectors/` canary's own precedent: "ship a fake, not a real
+ * transport call") — a real host binds its own REST/daemon calls to
+ * `VersionManagerPort` instead.
+ */
+export function createFakeVersionManagerPort(seed) {
+    const store = new Map(seed ? [...seed.entries()].map(([k, v]) => [k, [...v]]) : []);
+    const content = new Map();
+    const key = (fileRef) => `${fileRef.scopeId}:${fileRef.name}`;
+    return {
+        async listVersions(fileRef) {
+            return store.get(key(fileRef)) ?? [];
+        },
+        async fetchVersionContent(fileRef, versionId) {
+            return content.get(`${key(fileRef)}:${versionId}`) ?? null;
+        },
+        async restoreVersion(fileRef, version) {
+            const list = store.get(key(fileRef)) ?? [];
+            const restored = list.map((entry) => ({ ...entry, current: entry.id === version.id }));
+            store.set(key(fileRef), restored);
+            return { version };
+        },
+        resolvePreviewDocument(_fileRef, content) {
+            return content;
+        },
+    };
+}
+/** Reuses `features/viewer-shell/`'s real browser clipboard implementation
+ *  — clipboard access is a generic browser API with no backend shape to
+ *  fake, same reasoning that feature's own `dependencies.ts` documents. */
+export function createBrowserVersionManagerClipboard() {
+    return createBrowserViewerClipboard();
+}
+export function createDefaultVersionManagerDependencies() {
+    return {
+        versions: createFakeVersionManagerPort(),
+        clipboard: createBrowserVersionManagerClipboard(),
+    };
+}
+// Module-level singleton default — both the hook (`useWiredVersionManager`)
+// and the orchestrator component (`VersionManagerModal`'s default
+// `dependencies` prop) bind to this SAME instance, not independent calls to
+// the factory above, so a caller that omits `dependencies` from both never
+// ends up with two different fake ports fighting over one modal's state.
+export const defaultVersionManagerDependencies = createDefaultVersionManagerDependencies();
+//# sourceMappingURL=dependencies.js.map

package/dist/features/version-manager/dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../../../src/features/version-manager/dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAIxE;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAC1C,IAAsC;IAEtC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAqB,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxG,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE1C,MAAM,GAAG,GAAG,CAAC,OAA8B,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAErF,OAAO;QACL,KAAK,CAAC,YAAY,CAAC,OAAO;YACxB,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACvC,CAAC;QACD,KAAK,CAAC,mBAAmB,CAAC,OAAO,EAAE,SAAS;YAC1C,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,SAAS,EAAE,CAAC,IAAI,IAAI,CAAC;QAC7D,CAAC;QACD,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO;YACnC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACvF,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;YAClC,OAAO,EAAE,OAAO,EAAE,CAAC;QACrB,CAAC;QACD,sBAAsB,CAAC,QAAQ,EAAE,OAAO;YACtC,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;2EAE2E;AAC3E,MAAM,UAAU,oCAAoC;IAClD,OAAO,4BAA4B,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,uCAAuC;IAGrD,OAAO;QACL,QAAQ,EAAE,4BAA4B,EAAY;QAClD,SAAS,EAAE,oCAAoC,EAAE;KAClD,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,kEAAkE;AAClE,4EAA4E;AAC5E,2EAA2E;AAC3E,yEAAyE;AACzE,MAAM,CAAC,MAAM,iCAAiC,GAC5C,uCAAuC,EAAE,CAAC"}

package/dist/features/version-manager/index.d.ts

@@ -0,0 +1,19 @@
+export type { VersionSource, VersionRecord, VersionManagerFileRef, VersionRestoreWarning, VersionRestoreResult, PreviewCanvasSize, } from './types.js';
+export { SEARCH_VISIBLE_THRESHOLD, PROMPT_COPY_FEEDBACK_RESET_MS, PREVIEW_LOAD_FALLBACK_MS, DEFAULT_PREVIEW_CANVAS_PADDING, } from './constants.js';
+export * from './rules.js';
+export type { VersionManagerPort, VersionManagerClipboardPort, VersionManagerDependencies } from './ports.js';
+export { createFakeVersionManagerPort, createBrowserVersionManagerClipboard, createDefaultVersionManagerDependencies, defaultVersionManagerDependencies, } from './dependencies.js';
+export { usePreviewCanvasSize } from './react/hooks/usePreviewCanvasSize.js';
+export { useVersionManager, useWiredVersionManager } from './react/hooks/useVersionManager.js';
+export type { UseVersionManagerOptions, VersionManagerController, } from './react/hooks/useVersionManager.js';
+export { VersionSidebar } from './react/components/VersionSidebar.js';
+export type { VersionSidebarProps } from './react/components/VersionSidebar.js';
+export { VersionPromptPopover } from './react/components/VersionPromptPopover.js';
+export type { VersionPromptPopoverProps } from './react/components/VersionPromptPopover.js';
+export { VersionRestoreControl } from './react/components/VersionRestoreControl.js';
+export type { VersionRestoreControlProps } from './react/components/VersionRestoreControl.js';
+export { VersionPreviewFrame } from './react/components/VersionPreviewFrame.js';
+export type { VersionPreviewFrameProps } from './react/components/VersionPreviewFrame.js';
+export { VersionManagerModal } from './react/components/VersionManagerModal.js';
+export type { VersionManagerModalProps } from './react/components/VersionManagerModal.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/version-manager/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/version-manager/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,wBAAwB,EACxB,6BAA6B,EAC7B,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,gBAAgB,CAAC;AAExB,cAAc,YAAY,CAAC;AAE3B,YAAY,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAC9G,OAAO,EACL,4BAA4B,EAC5B,oCAAoC,EACpC,uCAAuC,EACvC,iCAAiC,GAClC,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC/F,YAAY,EACV,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,YAAY,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAClF,YAAY,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AAC5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACpF,YAAY,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,YAAY,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,YAAY,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC"}

package/dist/features/version-manager/index.js

@@ -0,0 +1,11 @@
+export { SEARCH_VISIBLE_THRESHOLD, PROMPT_COPY_FEEDBACK_RESET_MS, PREVIEW_LOAD_FALLBACK_MS, DEFAULT_PREVIEW_CANVAS_PADDING, } from './constants.js';
+export * from './rules.js';
+export { createFakeVersionManagerPort, createBrowserVersionManagerClipboard, createDefaultVersionManagerDependencies, defaultVersionManagerDependencies, } from './dependencies.js';
+export { usePreviewCanvasSize } from './react/hooks/usePreviewCanvasSize.js';
+export { useVersionManager, useWiredVersionManager } from './react/hooks/useVersionManager.js';
+export { VersionSidebar } from './react/components/VersionSidebar.js';
+export { VersionPromptPopover } from './react/components/VersionPromptPopover.js';
+export { VersionRestoreControl } from './react/components/VersionRestoreControl.js';
+export { VersionPreviewFrame } from './react/components/VersionPreviewFrame.js';
+export { VersionManagerModal } from './react/components/VersionManagerModal.js';
+//# sourceMappingURL=index.js.map

package/dist/features/version-manager/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/version-manager/index.ts"],"names":[],"mappings":"AASA,OAAO,EACL,wBAAwB,EACxB,6BAA6B,EAC7B,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,gBAAgB,CAAC;AAExB,cAAc,YAAY,CAAC;AAG3B,OAAO,EACL,4BAA4B,EAC5B,oCAAoC,EACpC,uCAAuC,EACvC,iCAAiC,GAClC,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAM/F,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAEtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAElF,OAAO,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AAEpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAEhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC"}