@vellira-ui/core 2.56.0 → 2.58.0

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

@@ -1,2 +1,4 @@
-export type { OverlayDismissOptions, OverlayStackOptions, ScrollLockOptions, } from './types.js';
+export type { OverlayDiagnostics, OverlayStackEntry, OverlayZIndexPolicy, } from './policy.js';
+export { createConsoleOverlayDiagnostics, createOverlayStack, createOverlayZIndexPolicy, getTopOverlay, OVERLAY_STACK_ORDER_STEP, resolveOverlayZIndex, } from './policy.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,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,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/behavior/overlay/index.js

@@ -1 +1 @@
-export {};
+export { createConsoleOverlayDiagnostics, createOverlayStack, createOverlayZIndexPolicy, getTopOverlay, OVERLAY_STACK_ORDER_STEP, resolveOverlayZIndex, } from './policy.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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellira-ui/core",
-  "version": "2.56.0",
+  "version": "2.58.0",
   "description": "Shared logic and hooks for Vellira Design System",
   "keywords": [
     "vellira",