origam 2.16.0 → 2.17.0

package/dist/src/consts/Commons/elevation.const.cjs

@@ -3,7 +3,29 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.UTILITY_SHADOW_RUNGS = exports.ORIGAM_SHADOW_RUNGS = exports.CUSTOM_BOX_SHADOW_REGEX = void 0;
+exports.UTILITY_SHADOW_RUNGS = exports.SHADOW_UTILITY_CLASS_PREFIX = exports.SHADOW_TOKEN_PREFIX = exports.ORIGAM_SHADOW_RUNGS = exports.MATERIAL_ELEVATION_TOP_RUNG = exports.MATERIAL_ELEVATION_LADDER = exports.ELEVATION_LEGACY_BG_COLOR = exports.ELEVATION_BG_COLOR_DEPRECATION_WARNING = exports.ELEVATED_CLASS_SUFFIX = exports.CUSTOM_BOX_SHADOW_REGEX = void 0;
 const ORIGAM_SHADOW_RUNGS = exports.ORIGAM_SHADOW_RUNGS = /* @__PURE__ */new Set(["none", "xs", "sm", "md", "lg", "xl", "2xl", "3xl"]);
 const UTILITY_SHADOW_RUNGS = exports.UTILITY_SHADOW_RUNGS = /* @__PURE__ */new Set(["none", "xs", "sm", "md", "lg", "xl"]);
+const MATERIAL_ELEVATION_LADDER = exports.MATERIAL_ELEVATION_LADDER = [{
+  maxLevel: 0,
+  rung: "none"
+}, {
+  maxLevel: 1,
+  rung: "xs"
+}, {
+  maxLevel: 3,
+  rung: "sm"
+}, {
+  maxLevel: 8,
+  rung: "md"
+}, {
+  maxLevel: 16,
+  rung: "lg"
+}];
+const MATERIAL_ELEVATION_TOP_RUNG = exports.MATERIAL_ELEVATION_TOP_RUNG = "xl";
+const ELEVATION_LEGACY_BG_COLOR = exports.ELEVATION_LEGACY_BG_COLOR = "rgb(0,0,0)";
+const ELEVATED_CLASS_SUFFIX = exports.ELEVATED_CLASS_SUFFIX = "--elevated";
+const SHADOW_UTILITY_CLASS_PREFIX = exports.SHADOW_UTILITY_CLASS_PREFIX = "origam--shadow-";
+const SHADOW_TOKEN_PREFIX = exports.SHADOW_TOKEN_PREFIX = "--origam-shadow---";
+const ELEVATION_BG_COLOR_DEPRECATION_WARNING = exports.ELEVATION_BG_COLOR_DEPRECATION_WARNING = "[origam] useElevation: the `bgColor` parameter is deprecated and ignored. Shadows now resolve from the design tokens (`--origam-shadow-*`) and switch with the active theme. The parameter will be removed in v3.0.0.";
 const CUSTOM_BOX_SHADOW_REGEX = exports.CUSTOM_BOX_SHADOW_REGEX = /(?:var|calc|clamp|min|max|env|rgb|rgba|hsl|hsla|hwb|lab|lch|oklab|oklch|color-mix)\(|#[0-9a-f]{3,8}\b|[\d.]+(?:px|pt|pc|in|cm|mm|q|em|rem|ex|ch|cap|ic|lh|rlh|vw|vh|vi|vb|vmin|vmax|%)|\binset\b/i;

package/dist/src/consts/Commons/elevation.const.d.ts

@@ -1,27 +1,103 @@
-/**
+/*********************************************************
+ * ORIGAM_SHADOW_RUNGS
+ *
+ * @description
  * Origam-native shadow rungs accepted as a string `elevation` prop
  * on every component that consumes the `useElevation` composable.
  * Matches the token rungs under `--origam-shadow-{rung}` in
  * `src/assets/css/tokens/origam-utilities.css`.
  *
+ * @description
  * Lookup is identity (rung name == token suffix). Numeric inputs
  * still flow through `elevationToToken` separately.
- */
+ ********************************************************/
 export declare const ORIGAM_SHADOW_RUNGS: ReadonlySet<string>;
-/**
+/*********************************************************
+ * UTILITY_SHADOW_RUNGS
+ *
+ * @description
  * Subset of shadow rungs for which a global utility class exists in
  * `src/assets/css/tokens/origam-utilities.css` (Phase 1 manifest).
  * `2xl` and `3xl` are not yet emitted as utilities — they fall back
  * to the inline-style path.
- */
+ ********************************************************/
 export declare const UTILITY_SHADOW_RUNGS: ReadonlySet<string>;
-/**
+/*********************************************************
+ * MATERIAL_ELEVATION_LADDER
+ *
+ * @description
+ * Bucketisation of a numeric Material-style elevation (`0..24`) onto the
+ * 6-token origam shadow ladder. Read in order: the first entry whose
+ * `maxLevel` is `>=` the requested level wins; anything above the last
+ * entry falls through to `MATERIAL_ELEVATION_TOP_RUNG`.
+ *
+ * @description
+ * Buckets are intentionally chunky — the Material 25-step ladder
+ * collapses into a 6-token visual ladder. Tuned against the existing
+ * usage in OrigamCard / OrigamBadge / OrigamChip.
+ ********************************************************/
+export declare const MATERIAL_ELEVATION_LADDER: ReadonlyArray<{
+    maxLevel: number;
+    rung: string;
+}>;
+/*********************************************************
+ * MATERIAL_ELEVATION_TOP_RUNG
+ *
+ * @description
+ * Rung used for any level above the last `MATERIAL_ELEVATION_LADDER` bucket.
+ ********************************************************/
+export declare const MATERIAL_ELEVATION_TOP_RUNG = "xl";
+/*********************************************************
+ * ELEVATION_LEGACY_BG_COLOR
+ *
+ * @description
+ * Historical default of the (deprecated, ignored) `bgColor` parameter of
+ * `useElevation`. Any other value triggers the deprecation warning.
+ ********************************************************/
+export declare const ELEVATION_LEGACY_BG_COLOR = "rgb(0,0,0)";
+/*********************************************************
+ * ELEVATED_CLASS_SUFFIX
+ *
+ * @description
+ * BEM modifier appended to the component name when an elevation is set.
+ ********************************************************/
+export declare const ELEVATED_CLASS_SUFFIX = "--elevated";
+/*********************************************************
+ * SHADOW_UTILITY_CLASS_PREFIX
+ *
+ * @description
+ * Root of the global shadow utility classes emitted by `useElevation`
+ * (`.origam--shadow-md`, …). Declared in
+ * `src/assets/css/tokens/origam-utilities.css`.
+ ********************************************************/
+export declare const SHADOW_UTILITY_CLASS_PREFIX = "origam--shadow-";
+/*********************************************************
+ * SHADOW_TOKEN_PREFIX
+ *
+ * @description
+ * Root of the shadow design tokens (`--origam-shadow---md`, …) read by
+ * the inline-style path of `useElevation`.
+ ********************************************************/
+export declare const SHADOW_TOKEN_PREFIX = "--origam-shadow---";
+/*********************************************************
+ * ELEVATION_BG_COLOR_DEPRECATION_WARNING
+ *
+ * @description
+ * Emitted once when a consumer still passes the deprecated `bgColor`
+ * parameter to `useElevation`.
+ ********************************************************/
+export declare const ELEVATION_BG_COLOR_DEPRECATION_WARNING: string;
+/*********************************************************
+ * CUSTOM_BOX_SHADOW_REGEX
+ *
+ * @description
  * Detects a free-form custom `box-shadow` value that is neither an
  * origam-native rung name (`ORIGAM_SHADOW_RUNGS`) nor a Material 0..24
  * number — e.g. `'0 4px 12px rgba(0,0,0,.24)'`, a `var(--origam-shadow---card)`
  * / `calc(...)` reference, multiple comma-separated shadow layers, or an
  * `inset` shadow.
  *
+ * @description
  * Mirrors `CUSTOM_BORDER_RADIUS_REGEX` (`rounded.const.ts`): deliberately
  * permissive, not a full box-shadow grammar validator. It only checks that
  * the string carries at least one signal a real `box-shadow` value would
@@ -31,7 +107,8 @@ export declare const UTILITY_SHADOW_RUNGS: ReadonlySet<string>;
  * treated as not-a-shadow and falls through to the existing (silent-drop)
  * behaviour — no regression for genuinely invalid input.
  *
+ * @description
  * Example matches: `'0 4px 12px rgba(0,0,0,.24)'`, `'var(--origam-shadow---card)'`,
  * `'inset 0 0 0 2px #fff'`, `'0 1px 2px #000, 0 2px 8px #000'`.
- */
+ ********************************************************/
 export declare const CUSTOM_BOX_SHADOW_REGEX: RegExp;

package/dist/src/consts/Commons/elevation.const.js

@@ -16,4 +16,17 @@ export const UTILITY_SHADOW_RUNGS = /* @__PURE__ */ new Set([
   "lg",
   "xl"
 ]);
+export const MATERIAL_ELEVATION_LADDER = [
+  { maxLevel: 0, rung: "none" },
+  { maxLevel: 1, rung: "xs" },
+  { maxLevel: 3, rung: "sm" },
+  { maxLevel: 8, rung: "md" },
+  { maxLevel: 16, rung: "lg" }
+];
+export const MATERIAL_ELEVATION_TOP_RUNG = "xl";
+export const ELEVATION_LEGACY_BG_COLOR = "rgb(0,0,0)";
+export const ELEVATED_CLASS_SUFFIX = "--elevated";
+export const SHADOW_UTILITY_CLASS_PREFIX = "origam--shadow-";
+export const SHADOW_TOKEN_PREFIX = "--origam-shadow---";
+export const ELEVATION_BG_COLOR_DEPRECATION_WARNING = "[origam] useElevation: the `bgColor` parameter is deprecated and ignored. Shadows now resolve from the design tokens (`--origam-shadow-*`) and switch with the active theme. The parameter will be removed in v3.0.0.";
 export const CUSTOM_BOX_SHADOW_REGEX = /(?:var|calc|clamp|min|max|env|rgb|rgba|hsl|hsla|hwb|lab|lch|oklab|oklch|color-mix)\(|#[0-9a-f]{3,8}\b|[\d.]+(?:px|pt|pc|in|cm|mm|q|em|rem|ex|ch|cap|ic|lh|rlh|vw|vh|vi|vb|vmin|vmax|%)|\binset\b/i;

package/dist/src/consts/Commons/goTo.const.d.ts

@@ -1,3 +1,3 @@
 import type { InjectionKey } from "vue";
-import type { IGoToInstance } from "../../interfaces";
+import type { IGoToInstance } from '../../interfaces/Commons/goTo.interface';
 export declare const ORIGAM_GO_TO_KEY: InjectionKey<IGoToInstance>;

package/dist/src/consts/Commons/hotkey.const.cjs

@@ -3,20 +3,20 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.KEYBOARD_MODIFIERS = exports.KEYBOARD_ALIASES = void 0;
+exports.MACINTOSH_UA_TOKEN = exports.KEYBOARD_MODIFIERS = exports.KEYBOARD_ALIASES = exports.HOTKEY_SEQUENCE_TIMEOUT = exports.HOTKEY_NO_AUTO_CLEANUP_WARNING = void 0;
 var _enums = require("../../enums/index.cjs");
 const KEYBOARD_MODIFIERS = exports.KEYBOARD_MODIFIERS = [_enums.KEYBOARD_MODIFIERS_KEY.CONTROL, _enums.KEYBOARD_MODIFIERS_KEY.SHIFT, _enums.KEYBOARD_MODIFIERS_KEY.ALT, _enums.KEYBOARD_MODIFIERS_KEY.META, _enums.KEYBOARD_MODIFIERS_KEY.COMMAND];
+const HOTKEY_SEQUENCE_TIMEOUT = exports.HOTKEY_SEQUENCE_TIMEOUT = 1e3;
+const MACINTOSH_UA_TOKEN = exports.MACINTOSH_UA_TOKEN = "Macintosh";
+const HOTKEY_NO_AUTO_CLEANUP_WARNING = exports.HOTKEY_NO_AUTO_CLEANUP_WARNING = "Can't cleanup";
 const KEYBOARD_ALIASES = exports.KEYBOARD_ALIASES = {
-  // Modifier aliases (from vue-use, other libraries, and current implementation)
   control: "ctrl",
   command: "cmd",
   option: "alt",
-  // Arrow key aliases (common abbreviations)
   up: "arrowup",
   down: "arrowdown",
   left: "arrowleft",
   right: "arrowright",
-  // Other common key aliases
   esc: "escape",
   spacebar: " ",
   space: " ",

package/dist/src/consts/Commons/hotkey.const.d.ts

@@ -1,9 +1,47 @@
-import { TKeyboardModifiers } from "../../types";
+import { TKeyboardModifiers } from '../../types/Commons/hotkey.type';
 export declare const KEYBOARD_MODIFIERS: TKeyboardModifiers[];
-/**
+/*********************************************************
+ * HOTKEY_SEQUENCE_TIMEOUT
+ *
+ * @description
+ * Default window (ms) a multi-group hotkey SEQUENCE (`'g-then-i'`) waits
+ * for the next group before resetting to its first group. Overridable per
+ * call via `IHotkeyOptions.sequenceTimeout`.
+ ********************************************************/
+export declare const HOTKEY_SEQUENCE_TIMEOUT = 1000;
+/*********************************************************
+ * MACINTOSH_UA_TOKEN
+ *
+ * @description
+ * `navigator.userAgent` marker used to decide whether `cmd` / `meta`
+ * should map onto `metaKey` (macOS) or fall back to `ctrlKey`
+ * (everything else).
+ ********************************************************/
+export declare const MACINTOSH_UA_TOKEN = "Macintosh";
+/*********************************************************
+ * HOTKEY_NO_AUTO_CLEANUP_WARNING
+ *
+ * @description
+ * Emitted when `useHotkey` is called outside a Vue `setup()` context: no
+ * `onBeforeUnmount` hook can be registered, so the caller owns the
+ * returned cleanup function.
+ ********************************************************/
+export declare const HOTKEY_NO_AUTO_CLEANUP_WARNING = "Can't cleanup";
+/*********************************************************
+ * KEYBOARD_ALIASES
+ *
+ * @description
  * Centralized key alias mapping for consistent key normalization across the hotkey system.
  *
+ * @description
  * This maps various user-friendly aliases to canonical key names that match
  * KeyboardEvent.key values (in lowercase) where possible.
- */
+ *
+ * @description
+ * Modifier aliases (`control`, `command`, `option`) come from vue-use,
+ * other libraries, and the current implementation. Arrow key aliases
+ * (`up`, `down`, `left`, `right`) are common abbreviations. The rest
+ * (`esc`, `spacebar`, `space`, `return`, `del`, `minus`, `hyphen`) are
+ * other common key aliases.
+ ********************************************************/
 export declare const KEYBOARD_ALIASES: Record<string, string>;

package/dist/src/consts/Commons/hotkey.const.js

@@ -1,16 +1,16 @@
 import { KEYBOARD_MODIFIERS_KEY } from "../../enums/index.js";
 export const KEYBOARD_MODIFIERS = [KEYBOARD_MODIFIERS_KEY.CONTROL, KEYBOARD_MODIFIERS_KEY.SHIFT, KEYBOARD_MODIFIERS_KEY.ALT, KEYBOARD_MODIFIERS_KEY.META, KEYBOARD_MODIFIERS_KEY.COMMAND];
+export const HOTKEY_SEQUENCE_TIMEOUT = 1e3;
+export const MACINTOSH_UA_TOKEN = "Macintosh";
+export const HOTKEY_NO_AUTO_CLEANUP_WARNING = "Can't cleanup";
 export const KEYBOARD_ALIASES = {
-  // Modifier aliases (from vue-use, other libraries, and current implementation)
   control: "ctrl",
   command: "cmd",
   option: "alt",
-  // Arrow key aliases (common abbreviations)
   up: "arrowup",
   down: "arrowdown",
   left: "arrowleft",
   right: "arrowright",
-  // Other common key aliases
   esc: "escape",
   spacebar: " ",
   space: " ",

package/dist/src/consts/Commons/hover.const.d.ts

@@ -1,5 +1,5 @@
-import type { IHoverHtmlElement, IHoverOptions } from '../../interfaces';
-import type { THoverEvent } from '../../types';
+import type { IHoverHtmlElement, IHoverOptions } from '../../interfaces/Commons/hover.interface';
+import type { THoverEvent } from '../../types/Commons/hover.type';
 export declare const ORIGAM_HOVER_STOP_KEY: unique symbol;
 export declare const HOVER: {
     show(_e: THoverEvent, el: IHoverHtmlElement, value: IHoverOptions): void;

package/dist/src/consts/Commons/layout.const.cjs

@@ -3,7 +3,22 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.ROOT_ZINDEX = exports.ORIGAM_LAYOUT_KEY = exports.ORIGAM_LAYOUT_ITEM_KEY = void 0;
+exports.ROOT_ZINDEX = exports.ORIGAM_LAYOUT_KEY = exports.ORIGAM_LAYOUT_ITEM_KEY = exports.NESTED_LAYOUT_ZINDEX_STEP = exports.LAYOUT_SCRIM_ZINDEX_OFFSET = exports.LAYOUT_POSITION_VARS = exports.LAYOUT_OVERLAP_SEPARATOR = exports.LAYOUT_ITEM_ZINDEX_STEP = exports.LAYOUT_ITEM_HIDDEN_OFFSET = exports.LAYOUT_ID_PREFIX = exports.LAYOUT_FULL_HEIGHT_CLASS = exports.LAYOUT_DEFAULT_OFFSET = exports.LAYOUT_CLASS = void 0;
 const ORIGAM_LAYOUT_KEY = exports.ORIGAM_LAYOUT_KEY = /* @__PURE__ */Symbol.for("origam:layout");
 const ORIGAM_LAYOUT_ITEM_KEY = exports.ORIGAM_LAYOUT_ITEM_KEY = /* @__PURE__ */Symbol.for("origam:layout-item");
-const ROOT_ZINDEX = exports.ROOT_ZINDEX = 1e3;
+const ROOT_ZINDEX = exports.ROOT_ZINDEX = 1e3;
+const LAYOUT_ID_PREFIX = exports.LAYOUT_ID_PREFIX = "layout-";
+const NESTED_LAYOUT_ZINDEX_STEP = exports.NESTED_LAYOUT_ZINDEX_STEP = 100;
+const LAYOUT_ITEM_ZINDEX_STEP = exports.LAYOUT_ITEM_ZINDEX_STEP = 2;
+const LAYOUT_SCRIM_ZINDEX_OFFSET = exports.LAYOUT_SCRIM_ZINDEX_OFFSET = 1;
+const LAYOUT_ITEM_HIDDEN_OFFSET = exports.LAYOUT_ITEM_HIDDEN_OFFSET = -110;
+const LAYOUT_OVERLAP_SEPARATOR = exports.LAYOUT_OVERLAP_SEPARATOR = ":";
+const LAYOUT_DEFAULT_OFFSET = exports.LAYOUT_DEFAULT_OFFSET = "0px";
+const LAYOUT_CLASS = exports.LAYOUT_CLASS = "origam-layout";
+const LAYOUT_FULL_HEIGHT_CLASS = exports.LAYOUT_FULL_HEIGHT_CLASS = "origam-layout--full-height";
+const LAYOUT_POSITION_VARS = exports.LAYOUT_POSITION_VARS = {
+  left: "--origam-layout---position-left",
+  right: "--origam-layout---position-right",
+  top: "--origam-layout---position-top",
+  bottom: "--origam-layout---position-bottom"
+};

package/dist/src/consts/Commons/layout.const.d.ts

@@ -1,7 +1,91 @@
 import type { InjectionKey, ShallowRef } from 'vue';
-import type { ILayoutProvide } from '../../interfaces';
+import type { ILayoutProvide } from '../../interfaces/Commons/layout.interface';
 export declare const ORIGAM_LAYOUT_KEY: InjectionKey<ILayoutProvide>;
 export declare const ORIGAM_LAYOUT_ITEM_KEY: InjectionKey<ShallowRef<{
     id: string;
 }>>;
 export declare const ROOT_ZINDEX = 1000;
+/*********************************************************
+ * LAYOUT_ID_PREFIX
+ *
+ * @description
+ * Prefix of the auto-generated layout id when the consumer does not pass
+ * an explicit `id` prop — the uid produced by `getUid()` is appended
+ * (`layout-42`). Drawer / Toolbar target it as a CSS selector, so the
+ * value is part of the rendered DOM contract.
+ ********************************************************/
+export declare const LAYOUT_ID_PREFIX = "layout-";
+/*********************************************************
+ * NESTED_LAYOUT_ZINDEX_STEP
+ *
+ * @description
+ * Z-index decrement applied to each NESTED layout relative to its parent
+ * layout, so a sub-layout and everything it registers always stack below
+ * the items of the layout hosting it.
+ ********************************************************/
+export declare const NESTED_LAYOUT_ZINDEX_STEP = 100;
+/*********************************************************
+ * LAYOUT_ITEM_ZINDEX_STEP
+ *
+ * @description
+ * Z-index slots reserved per registered layout item. Two, because each
+ * item owns a surface AND the scrim painted directly underneath it
+ * (see `LAYOUT_SCRIM_ZINDEX_OFFSET`).
+ ********************************************************/
+export declare const LAYOUT_ITEM_ZINDEX_STEP = 2;
+/*********************************************************
+ * LAYOUT_SCRIM_ZINDEX_OFFSET
+ *
+ * @description
+ * Offset between a layout item and its own scrim — the scrim always sits
+ * exactly one z-index below the surface it dims.
+ ********************************************************/
+export declare const LAYOUT_SCRIM_ZINDEX_OFFSET = 1;
+/*********************************************************
+ * LAYOUT_ITEM_HIDDEN_OFFSET
+ *
+ * @description
+ * Translate percentage applied to an INACTIVE layout item to push it off
+ * screen. 110 rather than 100 so a drawer's box-shadow / border is moved
+ * out of the viewport too instead of bleeding along the edge.
+ ********************************************************/
+export declare const LAYOUT_ITEM_HIDDEN_OFFSET = -110;
+/*********************************************************
+ * LAYOUT_OVERLAP_SEPARATOR
+ *
+ * @description
+ * Separator of an `overlaps` entry — `"<top-id>:<bottom-id>"` declares
+ * that the first item is allowed to overlap the second.
+ ********************************************************/
+export declare const LAYOUT_OVERLAP_SEPARATOR = ":";
+/*********************************************************
+ * LAYOUT_DEFAULT_OFFSET
+ *
+ * @description
+ * Fallback reserved-space value emitted when `convertToUnit` cannot
+ * resolve a side of the main rect (no item registered on that side).
+ ********************************************************/
+export declare const LAYOUT_DEFAULT_OFFSET = "0px";
+export declare const LAYOUT_CLASS = "origam-layout";
+export declare const LAYOUT_FULL_HEIGHT_CLASS = "origam-layout--full-height";
+/*********************************************************
+ * LAYOUT_POSITION_VARS
+ *
+ * @description
+ * CSS custom properties carrying the reserved space (drawer width,
+ * toolbar height, …) per side. Emitted BOTH on the layout root (so every
+ * descendant inherits them) and on the main rect, and consumed by
+ * `OrigamMain` / `OrigamSnackbar` / `OrigamToolbar` via
+ * `var(--origam-layout---position-*)`.
+ *
+ * @description
+ * `as const` on purpose: the literal value types keep the computed keys
+ * of the style objects exact instead of collapsing them into a string
+ * index signature.
+ ********************************************************/
+export declare const LAYOUT_POSITION_VARS: {
+    readonly left: "--origam-layout---position-left";
+    readonly right: "--origam-layout---position-right";
+    readonly top: "--origam-layout---position-top";
+    readonly bottom: "--origam-layout---position-bottom";
+};

package/dist/src/consts/Commons/layout.const.js

@@ -1,3 +1,18 @@
 export const ORIGAM_LAYOUT_KEY = /* @__PURE__ */ Symbol.for("origam:layout");
 export const ORIGAM_LAYOUT_ITEM_KEY = /* @__PURE__ */ Symbol.for("origam:layout-item");
 export const ROOT_ZINDEX = 1e3;
+export const LAYOUT_ID_PREFIX = "layout-";
+export const NESTED_LAYOUT_ZINDEX_STEP = 100;
+export const LAYOUT_ITEM_ZINDEX_STEP = 2;
+export const LAYOUT_SCRIM_ZINDEX_OFFSET = 1;
+export const LAYOUT_ITEM_HIDDEN_OFFSET = -110;
+export const LAYOUT_OVERLAP_SEPARATOR = ":";
+export const LAYOUT_DEFAULT_OFFSET = "0px";
+export const LAYOUT_CLASS = "origam-layout";
+export const LAYOUT_FULL_HEIGHT_CLASS = "origam-layout--full-height";
+export const LAYOUT_POSITION_VARS = {
+  left: "--origam-layout---position-left",
+  right: "--origam-layout---position-right",
+  top: "--origam-layout---position-top",
+  bottom: "--origam-layout---position-bottom"
+};

package/dist/src/consts/Commons/locale.const.d.ts

@@ -1,5 +1,5 @@
 import type { InjectionKey } from "vue";
-import type { ILocaleInstance, IRtlInstance } from "../../interfaces";
+import type { ILocaleInstance, IRtlInstance } from '../../interfaces/Commons/locale.interface';
 export declare const ORIGAM_LOCALE_KEY: InjectionKey<ILocaleInstance & IRtlInstance>;
 export declare const LOCALE_RTL_DEFAULT: Readonly<{
     af: false;

package/dist/src/consts/Commons/location.const.cjs

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.OPPOSITE_MAP = exports.LOCATION_STRATEGIES = void 0;
-var _utils = require("../../utils/index.cjs");
+var _location = require("../../utils/Commons/location.util.cjs");
 const OPPOSITE_MAP = exports.OPPOSITE_MAP = {
   center: "center",
   top: "bottom",
@@ -15,8 +15,8 @@ const OPPOSITE_MAP = exports.OPPOSITE_MAP = {
   end: "left"
 };
 const LOCATION_STRATEGIES = exports.LOCATION_STRATEGIES = {
-  static: _utils.staticLocationStrategy,
+  static: _location.staticLocationStrategy,
   // specific viewport position, usually centered
-  connected: _utils.connectedLocationStrategy
+  connected: _location.connectedLocationStrategy
   // connected to a certain element
 };

package/dist/src/consts/Commons/location.const.d.ts

@@ -1,4 +1,4 @@
-import { connectedLocationStrategy, staticLocationStrategy } from '../../utils';
+import { connectedLocationStrategy, staticLocationStrategy } from '../../utils/Commons/location.util';
 export declare const OPPOSITE_MAP: {
     center: string;
     top: string;

package/dist/src/consts/Commons/location.const.js

@@ -1,4 +1,4 @@
-import { connectedLocationStrategy, staticLocationStrategy } from "../../utils/index.js";
+import { connectedLocationStrategy, staticLocationStrategy } from "../../utils/Commons/location.util.js";
 export const OPPOSITE_MAP = {
   center: "center",
   top: "bottom",

package/dist/src/consts/Commons/mdi.const.cjs

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.MDI_ALIASES = exports.MDI = void 0;
 var _vue = require("vue");
-var _components = require("../../components/index.cjs");
+var _index = require("../../components/Icon/index.cjs");
 var _enums = require("../../enums/index.cjs");
 const MDI = exports.MDI = {
   // The MDI font CSS exposes each glyph as `.mdi-<name>` (e.g. `.mdi-magnify`).
@@ -13,7 +13,7 @@ const MDI = exports.MDI = {
   // an `mdi:` prefix has been stripped by the icon resolver — or the already-
   // prefixed form (`mdi-magnify`, as found in MDI_ALIASES below). We
   // normalise to always emit the `mdi-` class so the font renders.
-  component: props => (0, _vue.h)(_components.OrigamClassIcon, {
+  component: props => (0, _vue.h)(_index.OrigamClassIcon, {
     ...props,
     icon: typeof props.icon === "string" && !props.icon.startsWith("mdi-") ? `mdi-${props.icon}` : props.icon,
     class: "mdi"

package/dist/src/consts/Commons/mdi.const.d.ts

@@ -1,3 +1,3 @@
-import type { IIconAliases, IIconSet } from '../../interfaces';
+import type { IIconAliases, IIconSet } from '../../interfaces/Icon/icon.interface';
 export declare const MDI: IIconSet;
 export declare const MDI_ALIASES: IIconAliases;

package/dist/src/consts/Commons/mdi.const.js

@@ -1,5 +1,5 @@
 import { h } from "vue";
-import { OrigamClassIcon } from "../../components/index.js";
+import { OrigamClassIcon } from "../../components/Icon/index.js";
 import { MDI_ICONS } from "../../enums/index.js";
 export const MDI = {
   // The MDI font CSS exposes each glyph as `.mdi-<name>` (e.g. `.mdi-magnify`).

package/dist/src/consts/Commons/nested.const.d.ts

@@ -1,4 +1,4 @@
-import type { TNestedProvide, TStrategyOpen } from '../../types';
+import type { TNestedProvide, TStrategyOpen } from '../../types/Commons/nested.type';
 import type { InjectionKey } from 'vue';
 export declare const SINGLE_OPEN_STRATEGY: TStrategyOpen;
 export declare const MULTIPLE_OPEN_STRATEGY: TStrategyOpen;

package/dist/src/consts/Commons/ripple.const.cjs

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.RIPPLE_OPTIONS = exports.RIPPLES = exports.ORIGAM_RIPPLE_STOP_KEY = exports.KEYCODES = exports.DELAY_RIPPLE = void 0;
-var _utils = require("../../utils/index.cjs");
+var _ripple = require("../../utils/Commons/ripple.util.cjs");
 const ORIGAM_RIPPLE_STOP_KEY = exports.ORIGAM_RIPPLE_STOP_KEY = /* @__PURE__ */Symbol("origam:rippleStop");
 const DELAY_RIPPLE = exports.DELAY_RIPPLE = 80;
 const KEYCODES = exports.KEYCODES = Object.freeze({
@@ -55,7 +55,7 @@ const RIPPLES = exports.RIPPLES = {
       y,
       centerX,
       centerY
-    } = (0, _utils.calculate)(e, el, value);
+    } = (0, _ripple.calculate)(e, el, value);
     const size = `${radius * 2}px`;
     animation.className = "origam-ripple__animation";
     animation.style.width = size;
@@ -68,12 +68,12 @@ const RIPPLES = exports.RIPPLES = {
     }
     animation.classList.add("origam-ripple__animation--enter");
     animation.classList.add("origam-ripple__animation--visible");
-    (0, _utils.rippleTransform)(animation, `translate(${x}, ${y}) scale3d(${scale},${scale},${scale})`);
+    (0, _ripple.rippleTransform)(animation, `translate(${x}, ${y}) scale3d(${scale},${scale},${scale})`);
     animation.dataset.activated = String(performance.now());
     setTimeout(() => {
       animation.classList.remove("origam-ripple__animation--enter");
       animation.classList.add("origam-ripple__animation--in");
-      (0, _utils.rippleTransform)(animation, `translate(${centerX}, ${centerY}) scale3d(1,1,1)`);
+      (0, _ripple.rippleTransform)(animation, `translate(${centerX}, ${centerY}) scale3d(1,1,1)`);
     }, 0);
   },
   hide(el) {

package/dist/src/consts/Commons/ripple.const.d.ts

@@ -1,5 +1,5 @@
-import type { IRippleHtmlElement, IRippleOptions } from '../../interfaces';
-import type { TRippleEvent } from '../../types';
+import type { IRippleHtmlElement, IRippleOptions } from '../../interfaces/Commons/ripple.interface';
+import type { TRippleEvent } from '../../types/Commons/ripple.type';
 export declare const ORIGAM_RIPPLE_STOP_KEY: unique symbol;
 export declare const DELAY_RIPPLE = 80;
 export declare const KEYCODES: Readonly<{

package/dist/src/consts/Commons/ripple.const.js

@@ -1,4 +1,4 @@
-import { calculate, rippleTransform } from "../../utils/index.js";
+import { calculate, rippleTransform } from "../../utils/Commons/ripple.util.js";
 export const ORIGAM_RIPPLE_STOP_KEY = /* @__PURE__ */ Symbol("origam:rippleStop");
 export const DELAY_RIPPLE = 80;
 export const KEYCODES = Object.freeze({

package/dist/src/consts/Commons/rounded.const.d.ts

@@ -1,4 +1,4 @@
-import type { TRounded } from '../../types';
+import type { TRounded } from '../../types/Commons/rounded.type';
 /**
  * Regex used to detect a free-form CSS border-radius string the consumer
  * can pass via `rounded="4px"` / `"4px 0 4px 0"` / etc. Each value can

package/dist/src/consts/Commons/scroll.const.cjs

@@ -4,10 +4,10 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.SCROLL_STRATEGIES = void 0;
-var _utils = require("../../utils/index.cjs");
+var _scroll = require("../../utils/Commons/scroll.util.cjs");
 const SCROLL_STRATEGIES = exports.SCROLL_STRATEGIES = {
   none: null,
-  close: _utils.closeScrollStrategy,
-  block: _utils.blockScrollStrategy,
-  reposition: _utils.repositionScrollStrategy
+  close: _scroll.closeScrollStrategy,
+  block: _scroll.blockScrollStrategy,
+  reposition: _scroll.repositionScrollStrategy
 };

package/dist/src/consts/Commons/scroll.const.d.ts

@@ -1,4 +1,4 @@
-import { blockScrollStrategy, closeScrollStrategy, repositionScrollStrategy } from '../../utils';
+import { blockScrollStrategy, closeScrollStrategy, repositionScrollStrategy } from '../../utils/Commons/scroll.util';
 export declare const SCROLL_STRATEGIES: {
     none: null;
     close: typeof closeScrollStrategy;

package/dist/src/consts/Commons/scroll.const.js

@@ -1,4 +1,4 @@
-import { blockScrollStrategy, closeScrollStrategy, repositionScrollStrategy } from "../../utils/index.js";
+import { blockScrollStrategy, closeScrollStrategy, repositionScrollStrategy } from "../../utils/Commons/scroll.util.js";
 export const SCROLL_STRATEGIES = {
   none: null,
   close: closeScrollStrategy,

package/dist/src/consts/Commons/size.const.d.ts

@@ -1,2 +1,2 @@
-import type { TSize } from '../../types';
+import type { TSize } from '../../types/Commons/size.type';
 export declare const SIZES_ARRAY: Array<TSize>;

package/dist/src/consts/Commons/spacing.const.d.ts

@@ -1,4 +1,5 @@
-import type { TBorderLogicalAxis, TDirectionBoth } from '../../types';
+import type { TDirectionBoth } from '../../types/Commons/anchor.type';
+import type { TBorderLogicalAxis } from '../../types/Commons/border.type';
 /**
  * Spacing scale steps mirrored by the global utility classes emitted from
  * the Phase 1 manifest (`.origam--p-0` … `.origam--p-12`,

package/dist/src/consts/Commons/stack.const.cjs

@@ -3,7 +3,8 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.ORIGAM_STACK_KEY = exports.GLOBAL_STACK = void 0;
+exports.STACK_Z_INDEX_STEP = exports.ORIGAM_STACK_KEY = exports.GLOBAL_STACK = void 0;
 var _vue = require("vue");
 const ORIGAM_STACK_KEY = exports.ORIGAM_STACK_KEY = /* @__PURE__ */Symbol.for("origam:stack");
-const GLOBAL_STACK = exports.GLOBAL_STACK = (0, _vue.reactive)([]);
+const GLOBAL_STACK = exports.GLOBAL_STACK = (0, _vue.reactive)([]);
+const STACK_Z_INDEX_STEP = exports.STACK_Z_INDEX_STEP = 10;

package/dist/src/consts/Commons/stack.const.d.ts

@@ -1,4 +1,17 @@
-import type { IStackProvide } from '../../interfaces';
+import type { IStackProvide } from '../../interfaces/Commons/stack.interface';
 import type { InjectionKey } from 'vue';
 export declare const ORIGAM_STACK_KEY: InjectionKey<IStackProvide>;
 export declare const GLOBAL_STACK: import("vue").Reactive<[uid: number, zIndex: number][]>;
+/*********************************************************
+ * STACK_Z_INDEX_STEP
+ *
+ * @description
+ * Gap inserted between two consecutive entries of `GLOBAL_STACK`.
+ *
+ * @description
+ * A newly activated overlay takes the previous top entry's z-index plus
+ * this step, leaving room for a component to layer its own internals
+ * (scrim, content, close affordance) between two stack rungs without
+ * escaping its own band.
+ ********************************************************/
+export declare const STACK_Z_INDEX_STEP = 10;