@vellira-ui/core 2.57.0 → 2.59.0

package/dist/behavior/overlay/focusRestore.d.ts

@@ -0,0 +1,9 @@
+import type { OverlayAutoFocusEvent } from '../utils/types.js';
+export type RunOverlayCloseAutoFocusOptions = {
+    enabled: boolean;
+    event?: OverlayAutoFocusEvent;
+    onCloseAutoFocus?: (event: OverlayAutoFocusEvent) => void;
+};
+export declare function runOverlayCloseAutoFocus({ enabled, event, onCloseAutoFocus, }: RunOverlayCloseAutoFocusOptions): boolean;
+export declare function deferOverlayFocusRestore(restoreFocus: () => void, schedule?: (callback: () => void) => void): void;
+//# sourceMappingURL=focusRestore.d.ts.map

package/dist/behavior/overlay/focusRestore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focusRestore.d.ts","sourceRoot":"","sources":["../../../src/behavior/overlay/focusRestore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,MAAM,MAAM,+BAA+B,GAAG;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;CAC3D,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,EACvC,OAAO,EACP,KAAK,EACL,gBAAgB,GACjB,EAAE,+BAA+B,WAQjC;AAED,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,IAAI,EACxB,QAAQ,GAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAqB,QAG1D"}

package/dist/behavior/overlay/focusRestore.js

@@ -0,0 +1,11 @@
+import { createAutoFocusEvent } from '../utils/events.js';
+export function runOverlayCloseAutoFocus({ enabled, event, onCloseAutoFocus, }) {
+    if (!enabled)
+        return false;
+    const closeEvent = event ?? createAutoFocusEvent();
+    onCloseAutoFocus?.(closeEvent);
+    return !closeEvent.defaultPrevented;
+}
+export function deferOverlayFocusRestore(restoreFocus, schedule = queueMicrotask) {
+    schedule(restoreFocus);
+}

package/dist/behavior/overlay/index.d.ts

@@ -1,2 +1,10 @@
-export type { OverlayDismissOptions, OverlayStackOptions, ScrollLockOptions, } from './types.js';
+export type { RunOverlayCloseAutoFocusOptions } from './focusRestore.js';
+export { deferOverlayFocusRestore, runOverlayCloseAutoFocus, } from './focusRestore.js';
+export type { OverlayDiagnostics, OverlayStackEntry, OverlayZIndexPolicy, } from './policy.js';
+export { createConsoleOverlayDiagnostics, createOverlayStack, createOverlayZIndexPolicy, getTopOverlay, OVERLAY_STACK_ORDER_STEP, resolveOverlayZIndex, } from './policy.js';
+export type { ResolveOverlayPresentationOptions } from './presentation.js';
+export { resolveOverlayPresentation } from './presentation.js';
+export type { CreateOverlayManagerStoreOptions, OverlayManagerStore, OverlayManagerStoreEntry, OverlayManagerStoreRegistration, OverlayManagerStoreSnapshot, } from './store.js';
+export { createOverlayManagerStore } from './store.js';
+export type { OverlayDismissOptions, ScrollLockOptions } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/behavior/overlay/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/behavior/overlay/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/behavior/overlay/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,+BAA+B,EAC/B,kBAAkB,EAClB,yBAAyB,EACzB,aAAa,EACb,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,iCAAiC,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC/D,YAAY,EACV,gCAAgC,EAChC,mBAAmB,EACnB,wBAAwB,EACxB,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AACvD,YAAY,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/behavior/overlay/index.js

@@ -1 +1,4 @@
-export {};
+export { deferOverlayFocusRestore, runOverlayCloseAutoFocus, } from './focusRestore.js';
+export { createConsoleOverlayDiagnostics, createOverlayStack, createOverlayZIndexPolicy, getTopOverlay, OVERLAY_STACK_ORDER_STEP, resolveOverlayZIndex, } from './policy.js';
+export { resolveOverlayPresentation } from './presentation.js';
+export { createOverlayManagerStore } from './store.js';

package/dist/behavior/overlay/policy.d.ts

@@ -0,0 +1,29 @@
+export declare const OVERLAY_STACK_ORDER_STEP = 10;
+export type OverlayZIndexPolicy<TLevel extends string = string> = {
+    defaultLevel: TLevel;
+    levels: Record<TLevel, number>;
+    orderStep: number;
+};
+export type OverlayStackEntry = {
+    id: string;
+    order: number;
+};
+export type OverlayDiagnostics = {
+    duplicateRegistration?: (id: string) => void;
+    unknownUnregister?: (id: string) => void;
+};
+export declare const createOverlayZIndexPolicy: <TLevel extends string>({ defaultLevel, levels, orderStep, }: {
+    defaultLevel: TLevel;
+    levels: Record<TLevel, number>;
+    orderStep?: number;
+}) => OverlayZIndexPolicy<TLevel>;
+export declare const resolveOverlayZIndex: <TLevel extends string>({ explicitZIndex, level, order, policy, }: {
+    explicitZIndex?: number;
+    level: TLevel;
+    order: number;
+    policy: OverlayZIndexPolicy<TLevel>;
+}) => number;
+export declare const createOverlayStack: <TEntry extends OverlayStackEntry>(entries: Iterable<TEntry>) => TEntry[];
+export declare const getTopOverlay: <TEntry extends OverlayStackEntry>(stack: readonly TEntry[]) => TEntry;
+export declare const createConsoleOverlayDiagnostics: (scope: string) => OverlayDiagnostics;
+//# sourceMappingURL=policy.d.ts.map

package/dist/behavior/overlay/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../src/behavior/overlay/policy.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,MAAM,MAAM,mBAAmB,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,IAAI;IAChE,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,qBAAqB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,iBAAiB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,MAAM,SAAS,MAAM,EAAE,sCAI9D;IACD,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,KAAG,mBAAmB,CAAC,MAAM,CAI5B,CAAC;AAEH,eAAO,MAAM,oBAAoB,GAAI,MAAM,SAAS,MAAM,EAAE,2CAKzD;IACD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;CACrC,WAAsE,CAAC;AAExE,eAAO,MAAM,kBAAkB,GAAI,MAAM,SAAS,iBAAiB,EACjE,SAAS,QAAQ,CAAC,MAAM,CAAC,aAIQ,CAAC;AAEpC,eAAO,MAAM,aAAa,GAAI,MAAM,SAAS,iBAAiB,EAC5D,OAAO,SAAS,MAAM,EAAE,WACU,CAAC;AAcrC,eAAO,MAAM,+BAA+B,GAC1C,OAAO,MAAM,KACZ,kBAYD,CAAC"}

package/dist/behavior/overlay/policy.js

@@ -0,0 +1,27 @@
+export const OVERLAY_STACK_ORDER_STEP = 10;
+export const createOverlayZIndexPolicy = ({ defaultLevel, levels, orderStep = OVERLAY_STACK_ORDER_STEP, }) => ({
+    defaultLevel,
+    levels,
+    orderStep,
+});
+export const resolveOverlayZIndex = ({ explicitZIndex, level, order, policy, }) => explicitZIndex ?? policy.levels[level] + order * policy.orderStep;
+export const createOverlayStack = (entries) => Array.from(entries)
+    .sort((left, right) => left.order - right.order)
+    .map((entry) => ({ ...entry }));
+export const getTopOverlay = (stack) => stack[stack.length - 1] ?? null;
+const isProductionEnvironment = () => {
+    const processLike = globalThis;
+    return processLike.process?.env?.NODE_ENV === 'production';
+};
+export const createConsoleOverlayDiagnostics = (scope) => ({
+    duplicateRegistration(id) {
+        if (isProductionEnvironment())
+            return;
+        console.warn(`${scope}: duplicate overlay registration for "${id}".`);
+    },
+    unknownUnregister(id) {
+        if (isProductionEnvironment())
+            return;
+        console.warn(`${scope}: attempted to unregister unknown overlay "${id}".`);
+    },
+});

package/dist/behavior/overlay/presentation.d.ts

@@ -0,0 +1,7 @@
+export type ResolveOverlayPresentationOptions<TPresentation extends string, TAuto extends TPresentation = TPresentation> = {
+    presentation?: TPresentation | 'auto';
+    defaultPresentation: TPresentation;
+    autoPresentation?: TAuto;
+};
+export declare function resolveOverlayPresentation<TPresentation extends string, TAuto extends TPresentation = TPresentation>({ autoPresentation, defaultPresentation, presentation, }: ResolveOverlayPresentationOptions<TPresentation, TAuto>): TPresentation;
+//# sourceMappingURL=presentation.d.ts.map

package/dist/behavior/overlay/presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../../../src/behavior/overlay/presentation.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iCAAiC,CAC3C,aAAa,SAAS,MAAM,EAC5B,KAAK,SAAS,aAAa,GAAG,aAAa,IACzC;IACF,YAAY,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;IACtC,mBAAmB,EAAE,aAAa,CAAC;IACnC,gBAAgB,CAAC,EAAE,KAAK,CAAC;CAC1B,CAAC;AAEF,wBAAgB,0BAA0B,CACxC,aAAa,SAAS,MAAM,EAC5B,KAAK,SAAS,aAAa,GAAG,aAAa,EAC3C,EACA,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,GACb,EAAE,iCAAiC,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,aAAa,CAMzE"}

package/dist/behavior/overlay/presentation.js

@@ -0,0 +1,6 @@
+export function resolveOverlayPresentation({ autoPresentation, defaultPresentation, presentation, }) {
+    if (presentation === 'auto') {
+        return autoPresentation ?? defaultPresentation;
+    }
+    return presentation ?? defaultPresentation;
+}

package/dist/behavior/overlay/store.d.ts

@@ -0,0 +1,34 @@
+import { type OverlayDiagnostics, type OverlayStackEntry, type OverlayZIndexPolicy } from './policy.js';
+export type OverlayManagerStoreEntry<TLevel extends string = string> = OverlayStackEntry & {
+    zIndexLevel: TLevel;
+    zIndex?: number;
+};
+export type OverlayManagerStoreRegistration<TLevel extends string = string> = {
+    id: string;
+    zIndexLevel?: TLevel;
+    zIndex?: number;
+};
+export type OverlayManagerStoreSnapshot<TLevel extends string = string> = {
+    registry: ReadonlyMap<string, OverlayManagerStoreEntry<TLevel>>;
+    stack: readonly OverlayManagerStoreEntry<TLevel>[];
+    topmost: OverlayManagerStoreEntry<TLevel> | null;
+};
+export type OverlayManagerStore<TLevel extends string = string> = {
+    register: (registration: OverlayManagerStoreRegistration<TLevel>) => OverlayManagerStoreEntry<TLevel>;
+    unregister: (id: string) => void;
+    update: (registration: OverlayManagerStoreRegistration<TLevel>) => OverlayManagerStoreEntry<TLevel> | null;
+    getSnapshot: () => OverlayManagerStoreSnapshot<TLevel>;
+    getEntry: (id: string) => OverlayManagerStoreEntry<TLevel> | null;
+    getStack: () => readonly OverlayManagerStoreEntry<TLevel>[];
+    getTopmost: () => OverlayManagerStoreEntry<TLevel> | null;
+    isTopmost: (id: string) => boolean;
+    getZIndex: (id: string) => number | undefined;
+    subscribe: (listener: () => void) => () => void;
+    clear: () => void;
+};
+export type CreateOverlayManagerStoreOptions<TLevel extends string = string> = {
+    policy: OverlayZIndexPolicy<TLevel>;
+    diagnostics?: OverlayDiagnostics;
+};
+export declare function createOverlayManagerStore<TLevel extends string>({ diagnostics, policy, }: CreateOverlayManagerStoreOptions<TLevel>): OverlayManagerStore<TLevel>;
+//# sourceMappingURL=store.d.ts.map

package/dist/behavior/overlay/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/behavior/overlay/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EAEzB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,wBAAwB,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,IACjE,iBAAiB,GAAG;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEJ,MAAM,MAAM,+BAA+B,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,IAAI;IAC5E,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,2BAA2B,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,IAAI;IACxE,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,wBAAwB,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,KAAK,EAAE,SAAS,wBAAwB,CAAC,MAAM,CAAC,EAAE,CAAC;IACnD,OAAO,EAAE,wBAAwB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,IAAI;IAChE,QAAQ,EAAE,CACR,YAAY,EAAE,+BAA+B,CAAC,MAAM,CAAC,KAClD,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACtC,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,MAAM,EAAE,CACN,YAAY,EAAE,+BAA+B,CAAC,MAAM,CAAC,KAClD,wBAAwB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC7C,WAAW,EAAE,MAAM,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACvD,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,wBAAwB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAClE,QAAQ,EAAE,MAAM,SAAS,wBAAwB,CAAC,MAAM,CAAC,EAAE,CAAC;IAC5D,UAAU,EAAE,MAAM,wBAAwB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC1D,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC9C,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAChD,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,gCAAgC,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,IAAI;IAC7E,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC,CAAC;AAsBF,wBAAgB,yBAAyB,CAAC,MAAM,SAAS,MAAM,EAAE,EAC/D,WAAW,EACX,MAAM,GACP,EAAE,gCAAgC,CAAC,MAAM,CAAC,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAgHxE"}

package/dist/behavior/overlay/store.js

@@ -0,0 +1,100 @@
+import { createOverlayStack, getTopOverlay, resolveOverlayZIndex, } from './policy.js';
+function cloneRegistry(registry) {
+    return new Map(Array.from(registry.entries()).map(([id, entry]) => [id, { ...entry }]));
+}
+function createSnapshot(registry) {
+    const stack = createOverlayStack(registry.values());
+    return {
+        registry: cloneRegistry(registry),
+        stack,
+        topmost: getTopOverlay(stack),
+    };
+}
+export function createOverlayManagerStore({ diagnostics, policy, }) {
+    const registry = new Map();
+    const listeners = new Set();
+    let orderSeed = 0;
+    let snapshot = createSnapshot(registry);
+    const emit = () => {
+        snapshot = createSnapshot(registry);
+        listeners.forEach((listener) => listener());
+    };
+    const resolveZIndex = (entry) => resolveOverlayZIndex({
+        explicitZIndex: entry.zIndex,
+        level: entry.zIndexLevel,
+        order: entry.order,
+        policy,
+    });
+    return {
+        register(registration) {
+            if (registry.has(registration.id)) {
+                diagnostics?.duplicateRegistration?.(registration.id);
+            }
+            registry.delete(registration.id);
+            const entry = {
+                id: registration.id,
+                zIndexLevel: registration.zIndexLevel ?? policy.defaultLevel,
+                order: orderSeed++,
+                zIndex: registration.zIndex,
+            };
+            registry.set(registration.id, entry);
+            emit();
+            return entry;
+        },
+        unregister(id) {
+            if (!registry.delete(id)) {
+                diagnostics?.unknownUnregister?.(id);
+                return;
+            }
+            if (registry.size === 0) {
+                orderSeed = 0;
+            }
+            emit();
+        },
+        update(registration) {
+            const current = registry.get(registration.id);
+            if (!current)
+                return null;
+            const next = {
+                ...current,
+                zIndexLevel: registration.zIndexLevel ?? current.zIndexLevel,
+                zIndex: registration.zIndex,
+            };
+            registry.set(registration.id, next);
+            emit();
+            return next;
+        },
+        getSnapshot() {
+            return snapshot;
+        },
+        getEntry(id) {
+            return registry.get(id) ?? null;
+        },
+        getStack() {
+            return snapshot.stack;
+        },
+        getTopmost() {
+            return snapshot.topmost;
+        },
+        isTopmost(id) {
+            return snapshot.topmost?.id === id;
+        },
+        getZIndex(id) {
+            const entry = registry.get(id);
+            return entry ? resolveZIndex(entry) : undefined;
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        clear() {
+            if (registry.size === 0)
+                return;
+            registry.clear();
+            orderSeed = 0;
+            emit();
+        },
+    };
+}

package/dist/behavior/overlay/types.d.ts

@@ -12,10 +12,6 @@ export type OverlayDismissOptions = {
     onInteractOutside?: (event: OverlayOutsideEvent) => void;
     requestClose: () => void;
 };
-export type OverlayStackOptions = {
-    active: boolean;
-    id: string;
-};
 export type ScrollLockOptions = {
     active: boolean;
     enabled?: boolean;

package/dist/behavior/overlay/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/behavior/overlay/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,aAAa,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC9C,UAAU,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC;IACtD,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,YAAY,EAAE,MAAM,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACjD,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC5D,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACzD,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/behavior/overlay/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,aAAa,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC9C,UAAU,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC;IACtD,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,YAAY,EAAE,MAAM,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACjD,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC5D,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACzD,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC"}

package/dist/behavior/utils/index.d.ts

@@ -1,3 +1,5 @@
 export { createAutoFocusEvent, createOutsideEvent } from './events.js';
+export type { RetainedResourceDetach, RetainedResourceRegistry, } from './retainedResource.js';
+export { createRetainedResourceRegistry } from './retainedResource.js';
 export type { OverlayAutoFocusEvent, OverlayOutsideEvent } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/behavior/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/behavior/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACvE,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/behavior/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACvE,YAAY,EACV,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/behavior/utils/index.js

@@ -1 +1,2 @@
 export { createAutoFocusEvent, createOutsideEvent } from './events.js';
+export { createRetainedResourceRegistry } from './retainedResource.js';

package/dist/behavior/utils/retainedResource.d.ts

@@ -0,0 +1,8 @@
+export type RetainedResourceDetach = () => void;
+export type RetainedResourceRegistry<TTarget extends object> = {
+    retain: (target: TTarget) => RetainedResourceDetach;
+    release: (target: TTarget) => void;
+    clear: () => void;
+};
+export declare function createRetainedResourceRegistry<TTarget extends object>(attach: (target: TTarget) => RetainedResourceDetach | undefined): RetainedResourceRegistry<TTarget>;
+//# sourceMappingURL=retainedResource.d.ts.map

package/dist/behavior/utils/retainedResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retainedResource.d.ts","sourceRoot":"","sources":["../../../src/behavior/utils/retainedResource.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAAG,MAAM,IAAI,CAAC;AAEhD,MAAM,MAAM,wBAAwB,CAAC,OAAO,SAAS,MAAM,IAAI;IAC7D,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,sBAAsB,CAAC;IACpD,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AASF,wBAAgB,8BAA8B,CAAC,OAAO,SAAS,MAAM,EACnE,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,sBAAsB,GAAG,SAAS,GAC9D,wBAAwB,CAAC,OAAO,CAAC,CA8CnC"}

package/dist/behavior/utils/retainedResource.js

@@ -0,0 +1,39 @@
+const noop = () => undefined;
+export function createRetainedResourceRegistry(attach) {
+    const resources = new Map();
+    return {
+        retain(target) {
+            let resource = resources.get(target);
+            if (!resource) {
+                const detach = attach(target);
+                if (!detach)
+                    return noop;
+                resource = {
+                    count: 0,
+                    detach,
+                };
+                resources.set(target, resource);
+            }
+            resource.count += 1;
+            return () => {
+                this.release(target);
+            };
+        },
+        release(target) {
+            const resource = resources.get(target);
+            if (!resource)
+                return;
+            resource.count = Math.max(0, resource.count - 1);
+            if (resource.count > 0)
+                return;
+            resource.detach();
+            resources.delete(target);
+        },
+        clear() {
+            resources.forEach((resource) => {
+                resource.detach();
+            });
+            resources.clear();
+        },
+    };
+}

package/dist/compound/compoundSlot.d.ts

@@ -0,0 +1,9 @@
+export declare const compoundSlotSymbol: unique symbol;
+export type CompoundSlotKey = string | symbol;
+export type CompoundSlotComponent<TComponent, TSlot extends CompoundSlotKey = CompoundSlotKey> = TComponent & {
+    [compoundSlotSymbol]?: TSlot;
+};
+export declare const markCompoundSlot: <TComponent, TSlot extends CompoundSlotKey>(component: TComponent, slot: TSlot) => CompoundSlotComponent<TComponent, TSlot>;
+export declare const getCompoundSlot: <TSlot extends CompoundSlotKey = CompoundSlotKey>(component: unknown) => TSlot | undefined;
+export declare const copyCompoundSlotMetadata: <TSource, TTarget, TSlot extends CompoundSlotKey = CompoundSlotKey>(source: TSource, target: TTarget) => TTarget;
+//# sourceMappingURL=compoundSlot.d.ts.map

package/dist/compound/compoundSlot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compoundSlot.d.ts","sourceRoot":"","sources":["../../src/compound/compoundSlot.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,eAA0C,CAAC;AAE1E,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9C,MAAM,MAAM,qBAAqB,CAC/B,UAAU,EACV,KAAK,SAAS,eAAe,GAAG,eAAe,IAC7C,UAAU,GAAG;IACf,CAAC,kBAAkB,CAAC,CAAC,EAAE,KAAK,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,UAAU,EAAE,KAAK,SAAS,eAAe,EACxE,WAAW,UAAU,EACrB,MAAM,KAAK,KACV,qBAAqB,CAAC,UAAU,EAAE,KAAK,CAMzC,CAAC;AASF,eAAO,MAAM,eAAe,GAC1B,KAAK,SAAS,eAAe,GAAG,eAAe,EAE/C,WAAW,OAAO,KACjB,KAAK,GAAG,SAQV,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,OAAO,EACP,OAAO,EACP,KAAK,SAAS,eAAe,GAAG,eAAe,EAE/C,QAAQ,OAAO,EACf,QAAQ,OAAO,KACd,OASF,CAAC"}

package/dist/compound/compoundSlot.js

@@ -0,0 +1,20 @@
+export const compoundSlotSymbol = Symbol.for('@vellira-ui/compound-slot');
+export const markCompoundSlot = (component, slot) => {
+    const marked = component;
+    marked[compoundSlotSymbol] = slot;
+    return marked;
+};
+export const getCompoundSlot = (component) => {
+    const slotComponent = component;
+    return (slotComponent?.[compoundSlotSymbol] ??
+        slotComponent?.type?.[compoundSlotSymbol] ??
+        slotComponent?.render?.[compoundSlotSymbol]);
+};
+export const copyCompoundSlotMetadata = (source, target) => {
+    const slot = getCompoundSlot(source);
+    if (slot !== undefined) {
+        target[compoundSlotSymbol] =
+            slot;
+    }
+    return target;
+};

package/dist/compound/index.d.ts

@@ -0,0 +1,3 @@
+export type { CompoundSlotComponent, CompoundSlotKey } from './compoundSlot.js';
+export { compoundSlotSymbol, copyCompoundSlotMetadata, getCompoundSlot, markCompoundSlot, } from './compoundSlot.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/compound/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compound/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC"}

package/dist/compound/index.js

@@ -0,0 +1 @@
+export { compoundSlotSymbol, copyCompoundSlotMetadata, getCompoundSlot, markCompoundSlot, } from './compoundSlot.js';

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export * from './behavior/index.js';
+export * from './compound/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -1 +1,2 @@
 export * from './behavior/index.js';
+export * from './compound/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellira-ui/core",
-  "version": "2.57.0",
+  "version": "2.59.0",
   "description": "Shared logic and hooks for Vellira Design System",
   "keywords": [
     "vellira",
@@ -41,7 +41,11 @@
   "scripts": {
     "clean": "node --input-type=module -e \"import fs from 'node:fs'; fs.rmSync('dist', { recursive: true, force: true })\"",
     "build": "pnpm run clean && tsc -p tsconfig.build.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.10"
   },
   "publishConfig": {
     "access": "public"