@jini-ai/ui 0.1.0

package/dist/features/asset-grid/react/components/DeleteConfirmDialog.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useId, useRef } from 'react';
+import { useT } from '../../../i18n/index.js';
+import { useDismissOnOutsideOrEscape } from '../../../../browser/index.js';
+/**
+ * Generic bulk-delete confirmation dialog. Keeps its own body-scroll-lock
+ * behavior inline (a standard modal a11y idiom) — matching the same
+ * disclosed deviation `ConnectorDetailDrawer` documents in
+ * `packages/ui/source-map.md`. Escape-to-close is shared plumbing (see
+ * `useDismissOnOutsideOrEscape` below); the backdrop's own `onMouseDown`
+ * already handles outside-click, so no `containerRef` is passed.
+ */
+export function DeleteConfirmDialog({ count, onCancel, onConfirm }) {
+    const t = useT();
+    const titleId = useId();
+    const confirmBtnRef = useRef(null);
+    useDismissOnOutsideOrEscape(onCancel);
+    useEffect(() => {
+        confirmBtnRef.current?.focus();
+        const previousOverflow = document.body.style.overflow;
+        document.body.style.overflow = 'hidden';
+        return () => {
+            document.body.style.overflow = previousOverflow;
+        };
+    }, []);
+    return (_jsx("div", { className: "asset-grid-confirm-backdrop", role: "presentation", onMouseDown: (e) => {
+            if (e.target === e.currentTarget)
+                onCancel();
+        }, children: _jsxs("div", { className: "asset-grid-confirm-dialog", role: "alertdialog", "aria-modal": "true", "aria-labelledby": titleId, children: [_jsx("h2", { id: titleId, className: "asset-grid-confirm-title", children: count === 1 ? t('Delete 1 asset?') : t('Delete {count} assets?', { count }) }), _jsx("p", { className: "asset-grid-confirm-description", children: count === 1
+                        ? t('This permanently removes it. This can’t be undone.')
+                        : t('This permanently removes them. This can’t be undone.') }), _jsxs("div", { className: "asset-grid-confirm-footer", children: [_jsx("button", { type: "button", onClick: onCancel, children: t('Cancel') }), _jsx("button", { ref: confirmBtnRef, type: "button", className: "asset-grid-confirm-danger", onClick: onConfirm, children: t('Delete {count}', { count }) })] })] }) }));
+}
+//# sourceMappingURL=DeleteConfirmDialog.js.map

package/dist/features/asset-grid/react/components/DeleteConfirmDialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeleteConfirmDialog.js","sourceRoot":"","sources":["../../../../../src/features/asset-grid/react/components/DeleteConfirmDialog.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAQ3E;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAA4B;IAC1F,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,MAAM,OAAO,GAAG,KAAK,EAAE,CAAC;IACxB,MAAM,aAAa,GAAG,MAAM,CAA2B,IAAI,CAAC,CAAC;IAE7D,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IAEtC,SAAS,CAAC,GAAG,EAAE;QACb,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QAC/B,MAAM,gBAAgB,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;QACtD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACxC,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,gBAAgB,CAAC;QAClD,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,CACL,cACE,SAAS,EAAC,6BAA6B,EACvC,IAAI,EAAC,cAAc,EACnB,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE;YACjB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,aAAa;gBAAE,QAAQ,EAAE,CAAC;QAC/C,CAAC,YAED,eAAK,SAAS,EAAC,2BAA2B,EAAC,IAAI,EAAC,aAAa,gBAAY,MAAM,qBAAkB,OAAO,aACtG,aAAI,EAAE,EAAE,OAAO,EAAE,SAAS,EAAC,0BAA0B,YAClD,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,CAAC,GACzE,EACL,YAAG,SAAS,EAAC,gCAAgC,YAC1C,KAAK,KAAK,CAAC;wBACV,CAAC,CAAC,CAAC,CAAC,oDAAoD,CAAC;wBACzD,CAAC,CAAC,CAAC,CAAC,sDAAsD,CAAC,GAC3D,EACJ,eAAK,SAAS,EAAC,2BAA2B,aACxC,iBAAQ,IAAI,EAAC,QAAQ,EAAC,OAAO,EAAE,QAAQ,YACpC,CAAC,CAAC,QAAQ,CAAC,GACL,EACT,iBAAQ,GAAG,EAAE,aAAa,EAAE,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAC,2BAA2B,EAAC,OAAO,EAAE,SAAS,YAC/F,CAAC,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,CAAC,GACxB,IACL,IACF,GACF,CACP,CAAC;AACJ,CAAC"}

package/dist/features/asset-grid/react/components/SelectionActionBar.d.ts

@@ -0,0 +1,11 @@
+import type { ReactNode } from 'react';
+export interface SelectionActionBarProps {
+    selectedIds: string[];
+    onSelectAll: () => void;
+    onClear: () => void;
+    onRequestDelete: () => void;
+    /** Host-specific bulk actions (e.g. "add to design system"), rendered before the built-in Delete action. */
+    renderBulkActions?: ((selectedIds: string[]) => ReactNode) | undefined;
+}
+export declare function SelectionActionBar({ selectedIds, onSelectAll, onClear, onRequestDelete, renderBulkActions, }: SelectionActionBarProps): import("react").JSX.Element;
+//# sourceMappingURL=SelectionActionBar.d.ts.map

package/dist/features/asset-grid/react/components/SelectionActionBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectionActionBar.d.ts","sourceRoot":"","sources":["../../../../../src/features/asset-grid/react/components/SelectionActionBar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,4GAA4G;IAC5G,iBAAiB,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,SAAS,CAAC,GAAG,SAAS,CAAC;CACxE;AAED,wBAAgB,kBAAkB,CAAC,EACjC,WAAW,EACX,WAAW,EACX,OAAO,EACP,eAAe,EACf,iBAAiB,GAClB,EAAE,uBAAuB,+BAoBzB"}

package/dist/features/asset-grid/react/components/SelectionActionBar.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useT } from '../../../i18n/index.js';
+export function SelectionActionBar({ selectedIds, onSelectAll, onClear, onRequestDelete, renderBulkActions, }) {
+    const t = useT();
+    const count = selectedIds.length;
+    return (_jsxs("div", { className: "asset-grid-selection-bar", children: [_jsx("span", { className: "asset-grid-selection-count", children: t('{count} selected', { count }) }), _jsx("button", { type: "button", className: "asset-grid-selection-link", onClick: onSelectAll, children: t('Select all') }), _jsx("button", { type: "button", className: "asset-grid-selection-link", onClick: onClear, children: t('Clear') }), _jsx("span", { className: "asset-grid-selection-spacer" }), renderBulkActions ? renderBulkActions(selectedIds) : null, _jsx("button", { type: "button", className: "asset-grid-selection-delete", onClick: onRequestDelete, children: t('Delete {count}', { count }) })] }));
+}
+//# sourceMappingURL=SelectionActionBar.js.map

package/dist/features/asset-grid/react/components/SelectionActionBar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectionActionBar.js","sourceRoot":"","sources":["../../../../../src/features/asset-grid/react/components/SelectionActionBar.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAW9C,MAAM,UAAU,kBAAkB,CAAC,EACjC,WAAW,EACX,WAAW,EACX,OAAO,EACP,eAAe,EACf,iBAAiB,GACO;IACxB,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC;IAEjC,OAAO,CACL,eAAK,SAAS,EAAC,0BAA0B,aACvC,eAAM,SAAS,EAAC,4BAA4B,YAAE,CAAC,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,CAAC,GAAQ,EACtF,iBAAQ,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAC,2BAA2B,EAAC,OAAO,EAAE,WAAW,YAC7E,CAAC,CAAC,YAAY,CAAC,GACT,EACT,iBAAQ,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAC,2BAA2B,EAAC,OAAO,EAAE,OAAO,YACzE,CAAC,CAAC,OAAO,CAAC,GACJ,EACT,eAAM,SAAS,EAAC,6BAA6B,GAAG,EAC/C,iBAAiB,CAAC,CAAC,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAC1D,iBAAQ,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAC,6BAA6B,EAAC,OAAO,EAAE,eAAe,YACnF,CAAC,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,CAAC,GACxB,IACL,CACP,CAAC;AACJ,CAAC"}

package/dist/features/asset-grid/react/components/SelectionBand.d.ts

@@ -0,0 +1,7 @@
+import type { Band } from '../../types.js';
+export interface SelectionBandProps {
+    band: Band | null;
+}
+/** The visual rubber-band rectangle. `position: fixed` is structural (the band tracks viewport coordinates, matching `snapshotCardRects`'s coordinate space) — everything else about its look is left to the host's CSS via the `asset-grid-band` class. */
+export declare function SelectionBand({ band }: SelectionBandProps): import("react").JSX.Element | null;
+//# sourceMappingURL=SelectionBand.d.ts.map

package/dist/features/asset-grid/react/components/SelectionBand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectionBand.d.ts","sourceRoot":"","sources":["../../../../../src/features/asset-grid/react/components/SelectionBand.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;CACnB;AAED,4PAA4P;AAC5P,wBAAgB,aAAa,CAAC,EAAE,IAAI,EAAE,EAAE,kBAAkB,sCASzD"}

package/dist/features/asset-grid/react/components/SelectionBand.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/** The visual rubber-band rectangle. `position: fixed` is structural (the band tracks viewport coordinates, matching `snapshotCardRects`'s coordinate space) — everything else about its look is left to the host's CSS via the `asset-grid-band` class. */
+export function SelectionBand({ band }) {
+    if (!band)
+        return null;
+    return (_jsx("div", { className: "asset-grid-band", "aria-hidden": true, style: { position: 'fixed', left: band.x, top: band.y, width: band.w, height: band.h } }));
+}
+//# sourceMappingURL=SelectionBand.js.map

package/dist/features/asset-grid/react/components/SelectionBand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectionBand.js","sourceRoot":"","sources":["../../../../../src/features/asset-grid/react/components/SelectionBand.tsx"],"names":[],"mappings":";AAMA,4PAA4P;AAC5P,MAAM,UAAU,aAAa,CAAC,EAAE,IAAI,EAAsB;IACxD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,CACL,cACE,SAAS,EAAC,iBAAiB,uBAE3B,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,EAAE,GACtF,CACH,CAAC;AACJ,CAAC"}

package/dist/features/asset-grid/react/hooks/useAssetGridData.d.ts

@@ -0,0 +1,38 @@
+import type { AssetGridDataPort, AssetGridDependencies } from '../../ports.js';
+import type { AssetGridItem, AssetGridQuery } from '../../types.js';
+export interface UseAssetGridDataParams<TAsset extends AssetGridItem> {
+    active: boolean;
+    data: AssetGridDataPort<TAsset>;
+    kind: string;
+    source: string;
+    debouncedSearch: string;
+    getKind: (asset: TAsset) => string;
+    matchesKindFilter?: ((asset: TAsset, filterValue: string) => boolean) | undefined;
+    mapKindToQuery?: ((kind: string) => string | undefined) | undefined;
+}
+export interface UseAssetGridDataResult<TAsset> {
+    assets: TAsset[];
+    setAssets: React.Dispatch<React.SetStateAction<TAsset[]>>;
+    loading: boolean;
+    query: AssetGridQuery;
+    reload: () => Promise<void>;
+}
+/** Fetches assets when `active` or the derived query changes, applying an optional client-side kind narrowing pass after each fetch. */
+export declare function useAssetGridData<TAsset extends AssetGridItem>(params: UseAssetGridDataParams<TAsset>): UseAssetGridDataResult<TAsset>;
+export type UseWiredAssetGridDataParams<TAsset extends AssetGridItem> = Omit<UseAssetGridDataParams<TAsset>, 'data'> & {
+    /**
+     * Optional host-supplied dependencies (only the `data` port is read here).
+     * Omit to fall back to the package's in-memory fake — the same default
+     * `AssetGrid` itself uses.
+     */
+    dependencies?: AssetGridDependencies<TAsset> | undefined;
+};
+/**
+ * Wirer: binds `data` from `dependencies.ts` (a host-supplied port via
+ * `dependencies`, or the package's in-memory fake) so production callers
+ * don't need to import `dependencies.ts` themselves. `useAssetGridData`
+ * itself stays fake-able in tests — this is the only export in the file
+ * that touches a concrete adapter.
+ */
+export declare function useWiredAssetGridData<TAsset extends AssetGridItem>(params: UseWiredAssetGridDataParams<TAsset>): UseAssetGridDataResult<TAsset>;
+//# sourceMappingURL=useAssetGridData.d.ts.map

package/dist/features/asset-grid/react/hooks/useAssetGridData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAssetGridData.d.ts","sourceRoot":"","sources":["../../../../../src/features/asset-grid/react/hooks/useAssetGridData.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEpE,MAAM,WAAW,sBAAsB,CAAC,MAAM,SAAS,aAAa;IAClE,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,iBAAiB,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;IAClF,cAAc,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;CACrE;AAED,MAAM,WAAW,sBAAsB,CAAC,MAAM;IAC5C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1D,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED,wIAAwI;AACxI,wBAAgB,gBAAgB,CAAC,MAAM,SAAS,aAAa,EAC3D,MAAM,EAAE,sBAAsB,CAAC,MAAM,CAAC,GACrC,sBAAsB,CAAC,MAAM,CAAC,CA6ChC;AAED,MAAM,MAAM,2BAA2B,CAAC,MAAM,SAAS,aAAa,IAAI,IAAI,CAC1E,sBAAsB,CAAC,MAAM,CAAC,EAC9B,MAAM,CACP,GAAG;IACF;;;;OAIG;IACH,YAAY,CAAC,EAAE,qBAAqB,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;CAC1D,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,SAAS,aAAa,EAChE,MAAM,EAAE,2BAA2B,CAAC,MAAM,CAAC,GAC1C,sBAAsB,CAAC,MAAM,CAAC,CAIhC"}

package/dist/features/asset-grid/react/hooks/useAssetGridData.js

@@ -0,0 +1,55 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { buildAssetGridQuery, defaultMatchesKindFilter, filterByKind } from '../../rules.js';
+import { createFakeAssetGridDependencies } from '../../dependencies.js';
+/** Fetches assets when `active` or the derived query changes, applying an optional client-side kind narrowing pass after each fetch. */
+export function useAssetGridData(params) {
+    const { active, data, kind, source, debouncedSearch, getKind, matchesKindFilter, mapKindToQuery } = params;
+    const [assets, setAssets] = useState([]);
+    const [loading, setLoading] = useState(false);
+    // Selector functions are host-supplied and not guaranteed to be
+    // referentially stable across renders (e.g. an inline arrow in JSX). Ref
+    // them so `reload`'s identity depends only on primitives — otherwise an
+    // unstable selector would recreate `reload` every render, which would
+    // retrigger the fetch effect below on every render in turn.
+    const getKindRef = useRef(getKind);
+    useEffect(() => {
+        getKindRef.current = getKind;
+    }, [getKind]);
+    const matchesKindFilterRef = useRef(matchesKindFilter);
+    useEffect(() => {
+        matchesKindFilterRef.current = matchesKindFilter;
+    }, [matchesKindFilter]);
+    const mapKindToQueryRef = useRef(mapKindToQuery);
+    useEffect(() => {
+        mapKindToQueryRef.current = mapKindToQuery;
+    }, [mapKindToQuery]);
+    const query = useMemo(() => buildAssetGridQuery(kind, source, debouncedSearch, mapKindToQuery), [kind, source, debouncedSearch, mapKindToQuery]);
+    const reload = useCallback(async () => {
+        setLoading(true);
+        const liveQuery = buildAssetGridQuery(kind, source, debouncedSearch, mapKindToQueryRef.current);
+        const fetched = await data.fetchAssets(liveQuery);
+        const matches = matchesKindFilterRef.current ??
+            ((asset, filterValue) => defaultMatchesKindFilter(asset, filterValue, getKindRef.current));
+        setAssets(filterByKind(fetched, kind, matches));
+        setLoading(false);
+    }, [data, kind, source, debouncedSearch]);
+    useEffect(() => {
+        if (!active)
+            return;
+        void reload();
+    }, [active, reload]);
+    return { assets, setAssets, loading, query, reload };
+}
+/**
+ * Wirer: binds `data` from `dependencies.ts` (a host-supplied port via
+ * `dependencies`, or the package's in-memory fake) so production callers
+ * don't need to import `dependencies.ts` themselves. `useAssetGridData`
+ * itself stays fake-able in tests — this is the only export in the file
+ * that touches a concrete adapter.
+ */
+export function useWiredAssetGridData(params) {
+    const { dependencies, ...rest } = params;
+    const deps = useMemo(() => dependencies ?? createFakeAssetGridDependencies(), [dependencies]);
+    return useAssetGridData({ ...rest, data: deps.data });
+}
+//# sourceMappingURL=useAssetGridData.js.map

package/dist/features/asset-grid/react/hooks/useAssetGridData.js.map

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

package/dist/features/asset-grid/react/hooks/useAssetGridKeyboardShortcuts.d.ts

@@ -0,0 +1,15 @@
+export interface UseAssetGridKeyboardShortcutsParams {
+    active: boolean;
+    /** False while a modal/menu the grid doesn't own (upload dialog, a host menu) should own keyboard shortcuts instead. */
+    enabled: boolean;
+    hasAssets: boolean;
+    hasSelection: boolean;
+    /** True while a host-owned preview surface is open and should own Escape/Delete instead. */
+    isPreviewOpen: boolean;
+    onSelectAll: () => void;
+    onClearSelection: () => void;
+    onRequestDeleteSelected: () => void;
+}
+/** Cmd/Ctrl+A select-all, Escape clear-selection, Delete/Backspace triggers the bulk-delete confirm flow. */
+export declare function useAssetGridKeyboardShortcuts(params: UseAssetGridKeyboardShortcutsParams): void;
+//# sourceMappingURL=useAssetGridKeyboardShortcuts.d.ts.map

package/dist/features/asset-grid/react/hooks/useAssetGridKeyboardShortcuts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAssetGridKeyboardShortcuts.d.ts","sourceRoot":"","sources":["../../../../../src/features/asset-grid/react/hooks/useAssetGridKeyboardShortcuts.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mCAAmC;IAClD,MAAM,EAAE,OAAO,CAAC;IAChB,wHAAwH;IACxH,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,4FAA4F;IAC5F,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,uBAAuB,EAAE,MAAM,IAAI,CAAC;CACrC;AAED,6GAA6G;AAC7G,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,mCAAmC,GAAG,IAAI,CA+B/F"}

package/dist/features/asset-grid/react/hooks/useAssetGridKeyboardShortcuts.js

@@ -0,0 +1,30 @@
+import { useGlobalKeydown } from '../../../../browser/index.js';
+import { isTypingTarget } from '../../rules.js';
+/** Cmd/Ctrl+A select-all, Escape clear-selection, Delete/Backspace triggers the bulk-delete confirm flow. */
+export function useAssetGridKeyboardShortcuts(params) {
+    const { active, enabled, hasAssets, hasSelection, isPreviewOpen, onSelectAll, onClearSelection, onRequestDeleteSelected, } = params;
+    useGlobalKeydown((e) => {
+        if (!enabled)
+            return;
+        const typing = isTypingTarget(document.activeElement);
+        if ((e.metaKey || e.ctrlKey) && (e.key === 'a' || e.key === 'A')) {
+            if (typing || !hasAssets)
+                return;
+            e.preventDefault();
+            onSelectAll();
+        }
+        else if (e.key === 'Escape') {
+            if (isPreviewOpen)
+                return; // the preview surface owns Escape while it's open
+            if (hasSelection)
+                onClearSelection();
+        }
+        else if (e.key === 'Delete' || e.key === 'Backspace') {
+            if (typing || isPreviewOpen || !hasSelection)
+                return;
+            e.preventDefault();
+            onRequestDeleteSelected();
+        }
+    }, { enabled: active });
+}
+//# sourceMappingURL=useAssetGridKeyboardShortcuts.js.map

package/dist/features/asset-grid/react/hooks/useAssetGridKeyboardShortcuts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAssetGridKeyboardShortcuts.js","sourceRoot":"","sources":["../../../../../src/features/asset-grid/react/hooks/useAssetGridKeyboardShortcuts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAehD,6GAA6G;AAC7G,MAAM,UAAU,6BAA6B,CAAC,MAA2C;IACvF,MAAM,EACJ,MAAM,EACN,OAAO,EACP,SAAS,EACT,YAAY,EACZ,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,uBAAuB,GACxB,GAAG,MAAM,CAAC;IAEX,gBAAgB,CACd,CAAC,CAAC,EAAE,EAAE;QACJ,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QACtD,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC;YACjE,IAAI,MAAM,IAAI,CAAC,SAAS;gBAAE,OAAO;YACjC,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,WAAW,EAAE,CAAC;QAChB,CAAC;aAAM,IAAI,CAAC,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,aAAa;gBAAE,OAAO,CAAC,kDAAkD;YAC7E,IAAI,YAAY;gBAAE,gBAAgB,EAAE,CAAC;QACvC,CAAC;aAAM,IAAI,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,KAAK,WAAW,EAAE,CAAC;YACvD,IAAI,MAAM,IAAI,aAAa,IAAI,CAAC,YAAY;gBAAE,OAAO;YACrD,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,uBAAuB,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC,EACD,EAAE,OAAO,EAAE,MAAM,EAAE,CACpB,CAAC;AACJ,CAAC"}

package/dist/features/asset-grid/react/hooks/useAssetGridLiveUpdates.d.ts

@@ -0,0 +1,40 @@
+import type { AssetGridDependencies, AssetGridLiveUpdatesPort } from '../../ports.js';
+import type { AssetGridItem } from '../../types.js';
+export interface UseAssetGridLiveUpdatesParams<TAsset extends AssetGridItem> {
+    active: boolean;
+    liveUpdates: AssetGridLiveUpdatesPort | undefined;
+    /** When true, incremental membership can't be predicted client-side (an active kind/source/search filter) — every event falls back to a full reload. */
+    filtersActive: boolean;
+    fetchAssetById?: ((id: string) => Promise<TAsset | null>) | undefined;
+    setAssets: React.Dispatch<React.SetStateAction<TAsset[]>>;
+    reload: () => Promise<void>;
+    coalesceMs?: number | undefined;
+}
+/**
+ * Subscribes to a live-update transport and reconciles incremental
+ * ingest/delete events into the current asset list. Events are coalesced
+ * over a short window and applied as one targeted merge (fetch the new/
+ * changed ids, drop the deleted ids) instead of one full reload per event.
+ * A burst of many events, a filtered view, or an event with no resolvable
+ * id all fall back to a single full reload for that window — see
+ * `packages/ui/source-map.md` for why (the original OD comment: "a filtered
+ * view can't predict membership client-side").
+ */
+export declare function useAssetGridLiveUpdates<TAsset extends AssetGridItem>(params: UseAssetGridLiveUpdatesParams<TAsset>): void;
+export type UseWiredAssetGridLiveUpdatesParams<TAsset extends AssetGridItem> = Omit<UseAssetGridLiveUpdatesParams<TAsset>, 'liveUpdates' | 'fetchAssetById'> & {
+    /**
+     * Optional host-supplied dependencies (`liveUpdates` and `data.fetchAssetById`
+     * are read here). Omit to fall back to the package's in-memory fake, which
+     * carries no `liveUpdates` port — matching `AssetGrid`'s own default of
+     * disabling live-merge reconciliation when no dependencies are supplied.
+     */
+    dependencies?: AssetGridDependencies<TAsset> | undefined;
+};
+/**
+ * Wirer: binds `liveUpdates` and `fetchAssetById` from `dependencies.ts` so
+ * production callers don't need to import `dependencies.ts` themselves.
+ * `useAssetGridLiveUpdates` itself stays fake-able in tests — this is the
+ * only export in the file that touches a concrete adapter.
+ */
+export declare function useWiredAssetGridLiveUpdates<TAsset extends AssetGridItem>(params: UseWiredAssetGridLiveUpdatesParams<TAsset>): void;
+//# sourceMappingURL=useAssetGridLiveUpdates.d.ts.map

package/dist/features/asset-grid/react/hooks/useAssetGridLiveUpdates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAssetGridLiveUpdates.d.ts","sourceRoot":"","sources":["../../../../../src/features/asset-grid/react/hooks/useAssetGridLiveUpdates.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,6BAA6B,CAAC,MAAM,SAAS,aAAa;IACzE,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAClD,wJAAwJ;IACxJ,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IACtE,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1D,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,SAAS,aAAa,EAClE,MAAM,EAAE,6BAA6B,CAAC,MAAM,CAAC,GAC5C,IAAI,CA2FN;AAED,MAAM,MAAM,kCAAkC,CAAC,MAAM,SAAS,aAAa,IAAI,IAAI,CACjF,6BAA6B,CAAC,MAAM,CAAC,EACrC,aAAa,GAAG,gBAAgB,CACjC,GAAG;IACF;;;;;OAKG;IACH,YAAY,CAAC,EAAE,qBAAqB,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;CAC1D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,SAAS,aAAa,EACvE,MAAM,EAAE,kCAAkC,CAAC,MAAM,CAAC,GACjD,IAAI,CAQN"}

package/dist/features/asset-grid/react/hooks/useAssetGridLiveUpdates.js

@@ -0,0 +1,119 @@
+import { useEffect, useMemo, useRef } from 'react';
+import { DEFAULT_LIVE_UPDATE_COALESCE_MS } from '../../constants.js';
+import { mergeIngestedAssets } from '../../rules.js';
+import { createFakeAssetGridDependencies } from '../../dependencies.js';
+/**
+ * Subscribes to a live-update transport and reconciles incremental
+ * ingest/delete events into the current asset list. Events are coalesced
+ * over a short window and applied as one targeted merge (fetch the new/
+ * changed ids, drop the deleted ids) instead of one full reload per event.
+ * A burst of many events, a filtered view, or an event with no resolvable
+ * id all fall back to a single full reload for that window — see
+ * `packages/ui/source-map.md` for why (the original OD comment: "a filtered
+ * view can't predict membership client-side").
+ */
+export function useAssetGridLiveUpdates(params) {
+    const { active, liveUpdates, filtersActive, fetchAssetById, setAssets, reload, coalesceMs = DEFAULT_LIVE_UPDATE_COALESCE_MS } = params;
+    // Refs so the long-lived subscription (set up once per active/liveUpdates
+    // change) always reads the LATEST filtersActive/reload/fetchAssetById
+    // without resubscribing — resubscribing would drop and recreate the
+    // transport on every keystroke/filter change.
+    const filtersActiveRef = useRef(filtersActive);
+    useEffect(() => {
+        filtersActiveRef.current = filtersActive;
+    }, [filtersActive]);
+    const reloadRef = useRef(reload);
+    useEffect(() => {
+        reloadRef.current = reload;
+    }, [reload]);
+    const fetchAssetByIdRef = useRef(fetchAssetById);
+    useEffect(() => {
+        fetchAssetByIdRef.current = fetchAssetById;
+    }, [fetchAssetById]);
+    useEffect(() => {
+        if (!active || !liveUpdates)
+            return;
+        let timer = null;
+        const pendingIngest = new Set();
+        const pendingDelete = new Set();
+        let pendingFull = false;
+        const flush = async () => {
+            timer = null;
+            // Deletes are free (no fetch); apply them first.
+            if (pendingDelete.size) {
+                const del = new Set(pendingDelete);
+                pendingDelete.clear();
+                for (const id of del)
+                    pendingIngest.delete(id);
+                setAssets((prev) => prev.filter((a) => !del.has(a.id)));
+            }
+            if (pendingFull || filtersActiveRef.current) {
+                pendingFull = false;
+                pendingIngest.clear();
+                await reloadRef.current();
+                return;
+            }
+            if (pendingIngest.size) {
+                const ids = [...pendingIngest];
+                pendingIngest.clear();
+                const fetchById = fetchAssetByIdRef.current;
+                if (!fetchById) {
+                    await reloadRef.current();
+                    return;
+                }
+                const fetched = await Promise.all(ids.map((id) => fetchById(id)));
+                // A missing fetch is ambiguous (filtered out? race?) — reload instead.
+                if (fetched.some((a) => a === null)) {
+                    await reloadRef.current();
+                    return;
+                }
+                // `Promise.all` types its result through `Awaited<TAsset>`, which TS
+                // cannot prove is identical to the generic `TAsset` itself — safe
+                // here since the `some(a => a === null)` check above already
+                // guarantees every element is non-null.
+                const resolved = fetched;
+                setAssets((prev) => mergeIngestedAssets(prev, resolved));
+            }
+        };
+        const schedule = () => {
+            if (timer)
+                return;
+            timer = setTimeout(() => void flush(), coalesceMs);
+        };
+        const unsubscribe = liveUpdates.subscribe({
+            onIngest(id) {
+                pendingIngest.add(id);
+                schedule();
+            },
+            onDelete(id) {
+                pendingDelete.add(id);
+                schedule();
+            },
+            onFullReload() {
+                pendingFull = true;
+                schedule();
+            },
+        });
+        return () => {
+            if (timer)
+                clearTimeout(timer);
+            unsubscribe();
+        };
+    }, [active, liveUpdates, coalesceMs, setAssets]);
+}
+/**
+ * Wirer: binds `liveUpdates` and `fetchAssetById` from `dependencies.ts` so
+ * production callers don't need to import `dependencies.ts` themselves.
+ * `useAssetGridLiveUpdates` itself stays fake-able in tests — this is the
+ * only export in the file that touches a concrete adapter.
+ */
+export function useWiredAssetGridLiveUpdates(params) {
+    const { dependencies, ...rest } = params;
+    const deps = useMemo(() => dependencies ?? createFakeAssetGridDependencies(), [dependencies]);
+    useAssetGridLiveUpdates({
+        ...rest,
+        liveUpdates: deps.liveUpdates,
+        fetchAssetById: deps.data.fetchAssetById?.bind(deps.data),
+    });
+}
+//# sourceMappingURL=useAssetGridLiveUpdates.js.map

package/dist/features/asset-grid/react/hooks/useAssetGridLiveUpdates.js.map

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

package/dist/features/asset-grid/react/hooks/useAssetGridSelection.d.ts

@@ -0,0 +1,12 @@
+import type { AssetGridItem } from '../../types.js';
+export interface UseAssetGridSelectionResult {
+    selectedIds: Set<string>;
+    setSelectedIds: React.Dispatch<React.SetStateAction<Set<string>>>;
+    toggleOne: (id: string, index: number) => void;
+    rangeTo: (index: number) => void;
+    selectAll: () => void;
+    clearSelection: () => void;
+}
+/** Id-based selection state: toggle/shift-range/select-all/clear, plus the shift-range anchor. */
+export declare function useAssetGridSelection<TAsset extends AssetGridItem>(items: readonly TAsset[]): UseAssetGridSelectionResult;
+//# sourceMappingURL=useAssetGridSelection.d.ts.map

package/dist/features/asset-grid/react/hooks/useAssetGridSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAssetGridSelection.d.ts","sourceRoot":"","sources":["../../../../../src/features/asset-grid/react/hooks/useAssetGridSelection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,cAAc,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAClE,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,cAAc,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED,kGAAkG;AAClG,wBAAgB,qBAAqB,CAAC,MAAM,SAAS,aAAa,EAChE,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,2BAA2B,CA0B7B"}

package/dist/features/asset-grid/react/hooks/useAssetGridSelection.js

@@ -0,0 +1,23 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { pruneMissingSelection, rangeSelection, selectAllIds, toggleSelection } from '../../rules.js';
+/** Id-based selection state: toggle/shift-range/select-all/clear, plus the shift-range anchor. */
+export function useAssetGridSelection(items) {
+    const [selectedIds, setSelectedIds] = useState(() => new Set());
+    const anchorRef = useRef(null);
+    // Drop selected ids that no longer exist after a reload/delete.
+    useEffect(() => {
+        setSelectedIds((prev) => pruneMissingSelection(prev, items));
+    }, [items]);
+    const toggleOne = useCallback((id, index) => {
+        setSelectedIds((prev) => toggleSelection(prev, id));
+        anchorRef.current = index;
+    }, []);
+    const rangeTo = useCallback((index) => {
+        const anchor = anchorRef.current ?? index;
+        setSelectedIds((prev) => rangeSelection(prev, items, anchor, index));
+    }, [items]);
+    const selectAll = useCallback(() => setSelectedIds(selectAllIds(items)), [items]);
+    const clearSelection = useCallback(() => setSelectedIds(new Set()), []);
+    return { selectedIds, setSelectedIds, toggleOne, rangeTo, selectAll, clearSelection };
+}
+//# sourceMappingURL=useAssetGridSelection.js.map

package/dist/features/asset-grid/react/hooks/useAssetGridSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAssetGridSelection.js","sourceRoot":"","sources":["../../../../../src/features/asset-grid/react/hooks/useAssetGridSelection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAYtG,kGAAkG;AAClG,MAAM,UAAU,qBAAqB,CACnC,KAAwB;IAExB,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAc,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAC7E,MAAM,SAAS,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IAE9C,gEAAgE;IAChE,SAAS,CAAC,GAAG,EAAE;QACb,cAAc,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAC/D,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,EAAU,EAAE,KAAa,EAAE,EAAE;QAC1D,cAAc,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QACpD,SAAS,CAAC,OAAO,GAAG,KAAK,CAAC;IAC5B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,OAAO,GAAG,WAAW,CACzB,CAAC,KAAa,EAAE,EAAE;QAChB,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,IAAI,KAAK,CAAC;QAC1C,cAAc,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IACvE,CAAC,EACD,CAAC,KAAK,CAAC,CACR,CAAC;IAEF,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAClF,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,IAAI,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAExE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC;AACxF,CAAC"}

package/dist/features/asset-grid/react/hooks/useRubberBandDrag.d.ts

@@ -0,0 +1,19 @@
+import type { Band } from '../../types.js';
+export interface UseRubberBandDragParams {
+    containerRef: React.RefObject<HTMLElement | null>;
+    selectedIds: ReadonlySet<string>;
+    setSelectedIds: React.Dispatch<React.SetStateAction<Set<string>>>;
+}
+export interface UseRubberBandDragResult {
+    band: Band | null;
+    dragging: boolean;
+    onMouseDown: (e: React.MouseEvent) => void;
+}
+/**
+ * Mouse-driven rubber-band multi-select over the cards rendered under
+ * `containerRef`. Operates purely on `HTMLElement` rects and `Set<string>`
+ * ids (`snapshotCardRects`/`cardIdsInBand` in `rules.ts`) — the single
+ * cleanest generic core ported from `LibrarySection.tsx`.
+ */
+export declare function useRubberBandDrag({ containerRef, selectedIds, setSelectedIds, }: UseRubberBandDragParams): UseRubberBandDragResult;
+//# sourceMappingURL=useRubberBandDrag.d.ts.map

package/dist/features/asset-grid/react/hooks/useRubberBandDrag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRubberBandDrag.d.ts","sourceRoot":"","sources":["../../../../../src/features/asset-grid/react/hooks/useRubberBandDrag.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAY,MAAM,gBAAgB,CAAC;AAErD,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAClD,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,cAAc,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;CAC5C;AAWD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,YAAY,EACZ,WAAW,EACX,cAAc,GACf,EAAE,uBAAuB,GAAG,uBAAuB,CAkGnD"}

package/dist/features/asset-grid/react/hooks/useRubberBandDrag.js

@@ -0,0 +1,112 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { ASSET_ID_SELECTOR } from '../../constants.js';
+import { cardIdsInBand, snapshotCardRects } from '../../rules.js';
+/**
+ * Mouse-driven rubber-band multi-select over the cards rendered under
+ * `containerRef`. Operates purely on `HTMLElement` rects and `Set<string>`
+ * ids (`snapshotCardRects`/`cardIdsInBand` in `rules.ts`) — the single
+ * cleanest generic core ported from `LibrarySection.tsx`.
+ */
+export function useRubberBandDrag({ containerRef, selectedIds, setSelectedIds, }) {
+    const [band, setBand] = useState(null);
+    const [dragging, setDragging] = useState(false);
+    const dragRef = useRef(null);
+    const onMouseDown = useCallback((e) => {
+        if (e.button !== 0)
+            return;
+        const target = e.target;
+        // Starting on a card is a click / preview gesture, not a box select.
+        if (target.closest(ASSET_ID_SELECTOR))
+            return;
+        const additive = e.metaKey || e.ctrlKey || e.shiftKey;
+        dragRef.current = {
+            startX: e.clientX,
+            startY: e.clientY,
+            additive,
+            base: new Set(additive ? selectedIds : []),
+            moved: false,
+            // Snapshot every card's box ONCE here, while the whole grid is laid
+            // out. The move handler then hit-tests these cached rects instead of
+            // forcing a querySelectorAll + getBoundingClientRect reflow on every
+            // mouse move.
+            rects: snapshotCardRects(containerRef.current),
+        };
+        setBand({ x: e.clientX, y: e.clientY, w: 0, h: 0 });
+        setDragging(true);
+    }, [selectedIds, containerRef]);
+    useEffect(() => {
+        if (!dragging)
+            return;
+        let raf = 0;
+        // `dragging` only ever flips true inside `onMouseDown` above, which sets
+        // `dragRef.current` synchronously in that same callback before calling
+        // `setDragging(true)` — so by the time this effect runs for
+        // `dragging === true`, `dragRef.current` is guaranteed non-null. The `!`
+        // below satisfies the type checker for a case that cannot occur at
+        // runtime, not a defensive fallback.
+        let lastX = dragRef.current.startX;
+        let lastY = dragRef.current.startY;
+        const apply = () => {
+            raf = 0;
+            const d = dragRef.current;
+            if (!d)
+                return;
+            const nextBand = {
+                x: Math.min(d.startX, lastX),
+                y: Math.min(d.startY, lastY),
+                w: Math.abs(lastX - d.startX),
+                h: Math.abs(lastY - d.startY),
+            };
+            setBand(nextBand);
+            const next = new Set(d.base);
+            for (const id of cardIdsInBand(d.rects, nextBand))
+                next.add(id);
+            setSelectedIds(next);
+        };
+        const schedule = () => {
+            if (!raf)
+                raf = requestAnimationFrame(apply);
+        };
+        const move = (e) => {
+            const d = dragRef.current;
+            if (!d)
+                return;
+            d.moved = true;
+            lastX = e.clientX;
+            lastY = e.clientY;
+            schedule();
+        };
+        const onScroll = () => {
+            const d = dragRef.current;
+            if (!d)
+                return;
+            d.rects = snapshotCardRects(containerRef.current);
+            schedule();
+        };
+        const up = () => {
+            const d = dragRef.current;
+            // A click on empty space (no drag) clears the selection.
+            if (d && !d.moved && !d.additive)
+                setSelectedIds(new Set());
+            dragRef.current = null;
+            setDragging(false);
+            setBand(null);
+        };
+        window.addEventListener('mousemove', move);
+        window.addEventListener('mouseup', up);
+        // Capture so a scrolling inner pane (not just the window) re-snapshots.
+        window.addEventListener('scroll', onScroll, true);
+        const prevUserSelect = document.body.style.userSelect;
+        document.body.style.userSelect = 'none';
+        return () => {
+            if (raf)
+                cancelAnimationFrame(raf);
+            window.removeEventListener('mousemove', move);
+            window.removeEventListener('mouseup', up);
+            window.removeEventListener('scroll', onScroll, true);
+            document.body.style.userSelect = prevUserSelect;
+        };
+    }, [dragging, containerRef, setSelectedIds]);
+    return { band, dragging, onMouseDown };
+}
+//# sourceMappingURL=useRubberBandDrag.js.map