origam 2.5.0 → 2.6.2

package/dist/src/utils/Bracket/bracket-surface.util.cjs

@@ -0,0 +1,106 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.bracketDashArray = bracketDashArray;
+exports.bracketSurfaceVars = bracketSurfaceVars;
+exports.resolveBracketBorderColor = resolveBracketBorderColor;
+exports.resolveBracketBorderWidth = resolveBracketBorderWidth;
+exports.resolveBracketForeground = resolveBracketForeground;
+exports.resolveBracketRadius = resolveBracketRadius;
+exports.resolveBracketShadow = resolveBracketShadow;
+exports.resolveBracketSurface = resolveBracketSurface;
+var _commons = require("../Commons/commons.util.cjs");
+var _color = require("../Commons/color.util.cjs");
+const ROUNDED_RUNGS = ["none", "xs", "sm", "md", "lg", "xl", "full"];
+const SHADOW_RUNGS = ["none", "xs", "sm", "md", "lg", "xl"];
+const NAMED_RADIUS_VARS = {
+  "x-small": "var(--origam-radius---xs)",
+  "small": "var(--origam-radius---sm)",
+  "default": "var(--origam-radius---md)",
+  "medium": "var(--origam-radius---lg)",
+  "large": "var(--origam-radius---xl)",
+  "x-large": "var(--origam-radius---2xl)"
+};
+const BORDER_WIDTH_VARS = {
+  none: "var(--origam-border__width---0)",
+  thin: "var(--origam-border__width---thin)",
+  thick: "var(--origam-border__width---2)"
+};
+function resolveBracketSurface(value) {
+  if (!value) return null;
+  if ((0, _color.isIntent)(value)) return (0, _color.tokenStylesForIntent)(value, "default")["background-color"];
+  if (value === "transparent") return "transparent";
+  if (typeof value === "string" && (0, _color.isCssColor)(value)) return value;
+  return null;
+}
+function resolveBracketForeground(value) {
+  if (!value) return null;
+  if ((0, _color.isIntent)(value)) return (0, _color.tokenForegroundForIntent)(value);
+  if (value === "transparent") return "transparent";
+  if (typeof value === "string" && (0, _color.isCssColor)(value)) return value;
+  return null;
+}
+function resolveBracketRadius(value) {
+  if (value == null || value === false) return null;
+  if (typeof value === "string") {
+    if (value in NAMED_RADIUS_VARS) return NAMED_RADIUS_VARS[value];
+    if (ROUNDED_RUNGS.includes(value)) return `var(--origam-radius---${value})`;
+    if (value === "") return "var(--origam-radius---md)";
+    return value.includes(" ") ? value : (0, _commons.convertToUnit)(value) ?? value;
+  }
+  if (value === true) return "var(--origam-radius---md)";
+  return (0, _commons.convertToUnit)(value) ?? null;
+}
+function resolveBracketShadow(value) {
+  if (value == null || value === false) return null;
+  if (typeof value === "number") {
+    const rung = value <= 0 ? "none" : value <= 2 ? "xs" : value <= 4 ? "sm" : value <= 8 ? "md" : value <= 16 ? "lg" : "xl";
+    return `var(--origam-shadow---${rung})`;
+  }
+  if (typeof value === "string" && SHADOW_RUNGS.includes(value)) return `var(--origam-shadow---${value})`;
+  if (value === true) return "var(--origam-shadow---md)";
+  return typeof value === "string" ? value : null;
+}
+function resolveBracketBorderWidth(value) {
+  if (value == null || value === false) return null;
+  if (typeof value === "string" && value in BORDER_WIDTH_VARS) return BORDER_WIDTH_VARS[value];
+  if (value === true || value === "") return "var(--origam-border__width---thin)";
+  if (typeof value === "number") return (0, _commons.convertToUnit)(value) ?? null;
+  return null;
+}
+function resolveBracketBorderColor(value) {
+  if (!value) return null;
+  if ((0, _color.isIntent)(value)) return (0, _color.tokenForegroundForIntent)(value);
+  if (typeof value === "string" && (0, _color.isCssColor)(value)) return value;
+  return null;
+}
+function bracketDashArray(borderStyle) {
+  if (borderStyle === "dashed") return {
+    dasharray: "8 5"
+  };
+  if (borderStyle === "dotted") return {
+    dasharray: "1 5",
+    linecap: "round"
+  };
+  return {};
+}
+function bracketSurfaceVars(input) {
+  const vars = {};
+  const surface = resolveBracketSurface(input.bgColor);
+  if (surface) {
+    vars["--origam-bracket-match---background-color"] = surface;
+    vars["--origam-bracket-match--hover---background-color"] = surface;
+  }
+  const radius = resolveBracketRadius(input.rounded);
+  if (radius) vars["--origam-bracket-match---border-radius"] = radius;
+  const shadow = resolveBracketShadow(input.elevation);
+  if (shadow) vars["--origam-bracket-match---box-shadow"] = shadow;
+  const borderWidth = resolveBracketBorderWidth(input.border);
+  if (borderWidth) vars["--origam-bracket-match---border-width"] = borderWidth;
+  if (input.borderStyle) vars["--origam-bracket-match---border-style"] = input.borderStyle;
+  const borderColor = resolveBracketBorderColor(input.borderColor);
+  if (borderColor) vars["--origam-bracket-match---border-color"] = borderColor;
+  return vars;
+}

package/dist/src/utils/Bracket/bracket-surface.util.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Shared resolvers for the Bracket family surface. The match card's
+ * background / radius / shadow / border are driven through
+ * `--origam-bracket-match---*` CSS custom properties; both `OrigamBracket`
+ * (which paints every match from the tree root) and `OrigamBracketMatch`
+ * (standalone) resolve their props the same way through here — single
+ * source of truth, no per-component duplication.
+ *
+ * Tokenised intents / rungs resolve to the generated theme vars; custom
+ * numbers and CSS values pass through `convertToUnit` (or verbatim).
+ */
+type TBracketColor = string | null | undefined;
+type TBracketRounded = string | number | boolean | null | undefined;
+type TBracketElevation = string | number | boolean | null | undefined;
+type TBracketBorder = string | number | boolean | null | undefined;
+/** `bgColor` → the match surface fill. */
+export declare function resolveBracketSurface(value: TBracketColor): string | null;
+/** `color` → text colour on the neutral surface (no auto-contrast). */
+export declare function resolveBracketForeground(value: TBracketColor): string | null;
+/** `rounded` → `border-radius` (named variant / utility rung / free-form). */
+export declare function resolveBracketRadius(value: TBracketRounded): string | null;
+/** `elevation` → `box-shadow` (numeric ladder bucketised to a shadow rung). */
+export declare function resolveBracketShadow(value: TBracketElevation): string | null;
+/** `border` → `border-width` (utility keyword / number / boolean). */
+export declare function resolveBracketBorderWidth(value: TBracketBorder): string | null;
+/** `borderColor` → a colour value (intent → its token, else the CSS value). */
+export declare function resolveBracketBorderColor(value: TBracketColor): string | null;
+/** SVG dash pattern for a connector matching a `border-style`. */
+export declare function bracketDashArray(borderStyle: string | null | undefined): {
+    dasharray?: string;
+    linecap?: string;
+};
+export interface IBracketSurfaceInput {
+    bgColor?: TBracketColor;
+    rounded?: TBracketRounded;
+    elevation?: TBracketElevation;
+    border?: TBracketBorder;
+    borderColor?: TBracketColor;
+    borderStyle?: string | null;
+}
+/**
+ * Assemble the `--origam-bracket-match---*` custom properties for a match
+ * surface from a prop bag. Used by both `OrigamBracket` (root, all matches)
+ * and `OrigamBracketMatch` (standalone).
+ */
+export declare function bracketSurfaceVars(input: IBracketSurfaceInput): Record<string, string>;
+export {};

package/dist/src/utils/Bracket/bracket-surface.util.js

@@ -0,0 +1,88 @@
+import { convertToUnit } from "../Commons/commons.util.js";
+import { isCssColor, isIntent, tokenForegroundForIntent, tokenStylesForIntent } from "../Commons/color.util.js";
+const ROUNDED_RUNGS = ["none", "xs", "sm", "md", "lg", "xl", "full"];
+const SHADOW_RUNGS = ["none", "xs", "sm", "md", "lg", "xl"];
+const NAMED_RADIUS_VARS = {
+  "x-small": "var(--origam-radius---xs)",
+  "small": "var(--origam-radius---sm)",
+  "default": "var(--origam-radius---md)",
+  "medium": "var(--origam-radius---lg)",
+  "large": "var(--origam-radius---xl)",
+  "x-large": "var(--origam-radius---2xl)"
+};
+const BORDER_WIDTH_VARS = {
+  none: "var(--origam-border__width---0)",
+  thin: "var(--origam-border__width---thin)",
+  thick: "var(--origam-border__width---2)"
+};
+export function resolveBracketSurface(value) {
+  if (!value) return null;
+  if (isIntent(value)) return tokenStylesForIntent(value, "default")["background-color"];
+  if (value === "transparent") return "transparent";
+  if (typeof value === "string" && isCssColor(value)) return value;
+  return null;
+}
+export function resolveBracketForeground(value) {
+  if (!value) return null;
+  if (isIntent(value)) return tokenForegroundForIntent(value);
+  if (value === "transparent") return "transparent";
+  if (typeof value === "string" && isCssColor(value)) return value;
+  return null;
+}
+export function resolveBracketRadius(value) {
+  if (value == null || value === false) return null;
+  if (typeof value === "string") {
+    if (value in NAMED_RADIUS_VARS) return NAMED_RADIUS_VARS[value];
+    if (ROUNDED_RUNGS.includes(value)) return `var(--origam-radius---${value})`;
+    if (value === "") return "var(--origam-radius---md)";
+    return value.includes(" ") ? value : convertToUnit(value) ?? value;
+  }
+  if (value === true) return "var(--origam-radius---md)";
+  return convertToUnit(value) ?? null;
+}
+export function resolveBracketShadow(value) {
+  if (value == null || value === false) return null;
+  if (typeof value === "number") {
+    const rung = value <= 0 ? "none" : value <= 2 ? "xs" : value <= 4 ? "sm" : value <= 8 ? "md" : value <= 16 ? "lg" : "xl";
+    return `var(--origam-shadow---${rung})`;
+  }
+  if (typeof value === "string" && SHADOW_RUNGS.includes(value)) return `var(--origam-shadow---${value})`;
+  if (value === true) return "var(--origam-shadow---md)";
+  return typeof value === "string" ? value : null;
+}
+export function resolveBracketBorderWidth(value) {
+  if (value == null || value === false) return null;
+  if (typeof value === "string" && value in BORDER_WIDTH_VARS) return BORDER_WIDTH_VARS[value];
+  if (value === true || value === "") return "var(--origam-border__width---thin)";
+  if (typeof value === "number") return convertToUnit(value) ?? null;
+  return null;
+}
+export function resolveBracketBorderColor(value) {
+  if (!value) return null;
+  if (isIntent(value)) return tokenForegroundForIntent(value);
+  if (typeof value === "string" && isCssColor(value)) return value;
+  return null;
+}
+export function bracketDashArray(borderStyle) {
+  if (borderStyle === "dashed") return { dasharray: "8 5" };
+  if (borderStyle === "dotted") return { dasharray: "1 5", linecap: "round" };
+  return {};
+}
+export function bracketSurfaceVars(input) {
+  const vars = {};
+  const surface = resolveBracketSurface(input.bgColor);
+  if (surface) {
+    vars["--origam-bracket-match---background-color"] = surface;
+    vars["--origam-bracket-match--hover---background-color"] = surface;
+  }
+  const radius = resolveBracketRadius(input.rounded);
+  if (radius) vars["--origam-bracket-match---border-radius"] = radius;
+  const shadow = resolveBracketShadow(input.elevation);
+  if (shadow) vars["--origam-bracket-match---box-shadow"] = shadow;
+  const borderWidth = resolveBracketBorderWidth(input.border);
+  if (borderWidth) vars["--origam-bracket-match---border-width"] = borderWidth;
+  if (input.borderStyle) vars["--origam-bracket-match---border-style"] = input.borderStyle;
+  const borderColor = resolveBracketBorderColor(input.borderColor);
+  if (borderColor) vars["--origam-bracket-match---border-color"] = borderColor;
+  return vars;
+}

package/dist/src/utils/Commons/border.util.d.ts

@@ -4,4 +4,4 @@
  * @param values …
  * @param type   …
  */
-export declare function formatBorderStylesVar(values: Array<string>, type: string): never[];
+export declare function formatBorderStylesVar(values: Array<string>, type: string): string[];

package/dist/src/utils/Commons/color.util.cjs

@@ -184,7 +184,7 @@ function HSVtoCSS(hsva) {
 }
 function toHex(v) {
   const h = Math.round(v).toString(16);
-  return ("00".substr(0, 2 - h.length) + h).toUpperCase();
+  return ("00".slice(0, 2 - h.length) + h).toUpperCase();
 }
 function RGBtoHex({
   r,
@@ -273,7 +273,9 @@ function parseGradient(gradient, colors) {
   });
 }
 function classToHex(color, colors) {
-  const [colorName, colorModifier] = color.toString().trim().replace("-", "").split(" ", 2);
+  const parts = color.toString().trim().split(" ", 2);
+  const colorName = parts[0];
+  const colorModifier = parts[1]?.replace(/-/g, "");
   let hexColor = "";
   if (colorName && colorName in colors) {
     if (colorModifier && colorModifier in colors[colorName]) {

package/dist/src/utils/Commons/color.util.js

@@ -133,7 +133,7 @@ export function HSVtoCSS(hsva) {
 }
 export function toHex(v) {
   const h = Math.round(v).toString(16);
-  return ("00".substr(0, 2 - h.length) + h).toUpperCase();
+  return ("00".slice(0, 2 - h.length) + h).toUpperCase();
 }
 export function RGBtoHex({ r, g, b, a }) {
   return `#${[
@@ -207,7 +207,9 @@ export function parseGradient(gradient, colors) {
   });
 }
 export function classToHex(color, colors) {
-  const [colorName, colorModifier] = color.toString().trim().replace("-", "").split(" ", 2);
+  const parts = color.toString().trim().split(" ", 2);
+  const colorName = parts[0];
+  const colorModifier = parts[1]?.replace(/-/g, "");
   let hexColor = "";
   if (colorName && colorName in colors) {
     if (colorModifier && colorModifier in colors[colorName]) {

package/dist/src/utils/Commons/commons.util.cjs

@@ -89,7 +89,8 @@ function findChildrenWithProvide(key, vnode) {
   } else if (Array.isArray(vnode.children)) {
     return vnode.children.map(child => findChildrenWithProvide(key, child)).flat(1);
   } else if (vnode.component) {
-    if (Object.getOwnPropertySymbols(vnode.component.provides).includes(key)) {
+    const componentProvides = vnode.component.provides ?? {};
+    if (Object.getOwnPropertySymbols(componentProvides).includes(key)) {
       return [vnode.component];
     } else if (vnode.component.subTree) {
       return findChildrenWithProvide(key, vnode.component.subTree).flat(1);
@@ -132,7 +133,7 @@ function chunk(str, size = 1) {
   const chunked = [];
   let index = 0;
   while (index < str.length) {
-    chunked.push(str.substr(index, size));
+    chunked.push(str.slice(index, index + size));
     index += size;
   }
   return chunked;

package/dist/src/utils/Commons/commons.util.d.ts

@@ -215,7 +215,7 @@ export declare function focusableChildren(el: Element, filterByTabIndex?: boolea
  * @param location  …
  * @param condition …
  */
-export declare function getNextElement(elements: Array<HTMLElement>, location?: 'next' | 'prev', condition?: (el: HTMLElement) => boolean): any;
+export declare function getNextElement(elements: Array<HTMLElement>, location?: 'next' | 'prev', condition?: (el: HTMLElement) => boolean): HTMLElement;
 /**
  * Human readable file size.
  *

package/dist/src/utils/Commons/commons.util.js

@@ -50,7 +50,8 @@ export function findChildrenWithProvide(key, vnode) {
   } else if (Array.isArray(vnode.children)) {
     return vnode.children.map((child) => findChildrenWithProvide(key, child)).flat(1);
   } else if (vnode.component) {
-    if (Object.getOwnPropertySymbols(vnode.component.provides).includes(key)) {
+    const componentProvides = vnode.component.provides ?? {};
+    if (Object.getOwnPropertySymbols(componentProvides).includes(key)) {
       return [vnode.component];
     } else if (vnode.component.subTree) {
       return findChildrenWithProvide(key, vnode.component.subTree).flat(1);
@@ -91,7 +92,7 @@ export function chunk(str, size = 1) {
   const chunked = [];
   let index = 0;
   while (index < str.length) {
-    chunked.push(str.substr(index, size));
+    chunked.push(str.slice(index, index + size));
     index += size;
   }
   return chunked;

package/dist/src/utils/Commons/date.util.d.ts

@@ -293,7 +293,7 @@ export declare function endOfDay(date: Date): Date;
  * @param locale         …
  * @param firstDayOfWeek …
  */
-export declare function getWeekArray(date: Date, locale: string, firstDayOfWeek?: number): never[];
+export declare function getWeekArray(date: Date, locale: string, firstDayOfWeek?: number): Date[][];
 /**
  * Start of week.
  *

package/dist/src/utils/Commons/dom.util.d.ts

@@ -3,4 +3,4 @@
  *  - 'null' if the node is not attached to the DOM
  *  - the root node (HTMLDocument | ShadowRoot) otherwise
  */
-export declare function attachedRoot(node: Node): null | HTMLDocument | ShadowRoot;
+export declare function attachedRoot(node: Node): null | Document | ShadowRoot;

package/dist/src/utils/Commons/elevation.util.cjs

@@ -15,7 +15,7 @@ function formatElevationStyle(elevation = 0, bgColor) {
     s: 0,
     l: 0
   };
-  if (bgColor && (0, _utils.isParsableColor)(bgColor)) {
+  if (typeof bgColor === "string" && (0, _utils.isParsableColor)(bgColor)) {
     color = (0, _utils.HSVtoHSL)((0, _utils.RGBtoHSV)((0, _utils.parseColor)(bgColor)));
   }
   return `box-shadow: ${(0, _utils.convertToUnit)(offsetX)} ${(0, _utils.convertToUnit)(offsetY)} ${(0, _utils.convertToUnit)(blurRadius)} hsl(${(0, _utils.convertToUnit)(color.h, "deg")} ${(0, _utils.convertToUnit)(color.s * 100, "%")} ${(0, _utils.convertToUnit)(color.l * 100, "%")} / ${opacity.toFixed(2)})`;

package/dist/src/utils/Commons/elevation.util.js

@@ -5,7 +5,7 @@ export function formatElevationStyle(elevation = 0, bgColor) {
   const offsetY = roundTo(normalize(elevation * 0.04, 0, 1, 0, 16), 1);
   const opacity = roundTo(normalize(elevation * 0.04, 0, 1, 0.5, 0.25), 2);
   let color = { h: 0, s: 0, l: 0 };
-  if (bgColor && isParsableColor(bgColor)) {
+  if (typeof bgColor === "string" && isParsableColor(bgColor)) {
     color = HSVtoHSL(RGBtoHSV(parseColor(bgColor)));
   }
   return `box-shadow: ${convertToUnit(offsetX)} ${convertToUnit(offsetY)} ${convertToUnit(blurRadius)} hsl(${convertToUnit(color.h, "deg")} ${convertToUnit(color.s * 100, "%")} ${convertToUnit(color.l * 100, "%")} / ${opacity.toFixed(2)})`;

package/dist/src/utils/Commons/forwardRefs.util.cjs

@@ -62,7 +62,7 @@ function forwardRefs(target, ...refs) {
           const ref2 = queue.shift();
           const descriptor2 = getDescriptor(ref2.value, key);
           if (descriptor2) return descriptor2;
-          const childRefs2 = ref2.value && ref2.value[_consts.FORWARD_REFS];
+          const childRefs2 = ref2.value?.[_consts.FORWARD_REFS];
           if (childRefs2) queue.push(...childRefs2);
         }
       }

package/dist/src/utils/Commons/forwardRefs.util.js

@@ -55,7 +55,7 @@ export function forwardRefs(target, ...refs) {
           const ref2 = queue.shift();
           const descriptor2 = getDescriptor(ref2.value, key);
           if (descriptor2) return descriptor2;
-          const childRefs2 = ref2.value && ref2.value[FORWARD_REFS];
+          const childRefs2 = ref2.value?.[FORWARD_REFS];
           if (childRefs2) queue.push(...childRefs2);
         }
       }

package/dist/src/utils/Commons/gradient.util.cjs

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.gradientFromObject = gradientFromObject;
 exports.isGradient = isGradient;
 exports.resolveGradient = resolveGradient;
-var _colorUtil = require("./color.util.ts");
+var _color = require("./color.util.cjs");
 const GRADIENT_FN_RE = /^\s*(repeating-)?(linear|radial|conic)-gradient\s*\(/i;
 const PRESET_PREFIX = "gradient-";
 function isGradientString(value) {
@@ -29,8 +29,8 @@ function isGradient(value) {
   return isGradientObject(value);
 }
 function resolveStopColor(color) {
-  if ((0, _colorUtil.isIntent)(color)) {
-    return `var(--origam-color__${(0, _colorUtil.intentTokenBase)(color)}---bg)`;
+  if ((0, _color.isIntent)(color)) {
+    return `var(--origam-color__${(0, _color.intentTokenBase)(color)}---bg)`;
   }
   return color;
 }

package/dist/src/utils/Commons/gradient.util.js

@@ -1,4 +1,4 @@
-import { intentTokenBase, isIntent } from "./color.util.ts";
+import { intentTokenBase, isIntent } from "./color.util.js";
 const GRADIENT_FN_RE = /^\s*(repeating-)?(linear|radial|conic)-gradient\s*\(/i;
 const PRESET_PREFIX = "gradient-";
 function isGradientString(value) {

package/dist/src/utils/Commons/hover.util.cjs

@@ -20,12 +20,14 @@ function updateHover(el, binding, wasEnabled, name) {
   const options = {
     class: `${name}--hover`
   };
-  if ((0, _utils.isObject)(value) && value.class) {
+  if ((0, _utils.isObject)(value) && typeof value.class === "string") {
     options.class = value.class;
   }
   el._hover = el._hover ?? {};
   el._hover.enabled = enabled;
   el._hover.class = options.class;
+  el._hover.mouseenter = (0, _utils.isObject)(value) ? value.mouseenter : void 0;
+  el._hover.mouseleave = (0, _utils.isObject)(value) ? value.mouseleave : void 0;
   if (!enabled) {
     _consts.HOVER.hide(el, options);
   }
@@ -70,6 +72,7 @@ function hoverShow(e) {
     value.class = element._hover.class;
   }
   _consts.HOVER.show(e, element, value);
+  element._hover.mouseenter?.(element, e);
 }
 function hoverStop(e) {
   e[_consts.ORIGAM_HOVER_STOP_KEY] = true;
@@ -84,6 +87,7 @@ function hoverHide(e) {
     value.class = element._hover.class;
   }
   _consts.HOVER.hide(element, value);
+  element._hover.mouseleave?.(element, e);
 }
 function hoverRemoveListeners(el) {
   el.removeEventListener("mouseenter", hoverShow);

package/dist/src/utils/Commons/hover.util.js

@@ -4,12 +4,14 @@ export function updateHover(el, binding, wasEnabled, name) {
   const { value, modifiers } = binding;
   const enabled = isHoverEnabled(value);
   const options = { class: `${name}--hover` };
-  if (isObject(value) && value.class) {
+  if (isObject(value) && typeof value.class === "string") {
     options.class = value.class;
   }
   el._hover = el._hover ?? {};
   el._hover.enabled = enabled;
   el._hover.class = options.class;
+  el._hover.mouseenter = isObject(value) ? value.mouseenter : void 0;
+  el._hover.mouseleave = isObject(value) ? value.mouseleave : void 0;
   if (!enabled) {
     HOVER.hide(el, options);
   }
@@ -46,6 +48,7 @@ export function hoverShow(e) {
     value.class = element._hover.class;
   }
   HOVER.show(e, element, value);
+  element._hover.mouseenter?.(element, e);
 }
 export function hoverStop(e) {
   e[ORIGAM_HOVER_STOP_KEY] = true;
@@ -58,6 +61,7 @@ export function hoverHide(e) {
     value.class = element._hover.class;
   }
   HOVER.hide(element, value);
+  element._hover.mouseleave?.(element, e);
 }
 export function hoverRemoveListeners(el) {
   el.removeEventListener("mouseenter", hoverShow);

package/dist/src/utils/Commons/margin.util.d.ts

@@ -3,4 +3,4 @@
  *
  * @param values …
  */
-export declare function formatMarginStylesVar(values: Array<string>): never[];
+export declare function formatMarginStylesVar(values: Array<string>): string[];

package/dist/src/utils/Commons/padding.util.d.ts

@@ -3,4 +3,4 @@
  *
  * @param values …
  */
-export declare function formatPaddingStylesVar(values: Array<string>): never[];
+export declare function formatPaddingStylesVar(values: Array<string>): string[];

package/dist/src/utils/Commons/ripple.util.cjs

@@ -179,11 +179,10 @@ function rippleRemoveListeners(el) {
 }
 function rippleTransform(el, value) {
   el.style.transform = value;
-  el.style.webkitTransform = value;
 }
 let keyboardRipple = false;
 function keyboardRippleShow(e) {
-  if (!keyboardRipple && (e.keyCode === _consts.KEYCODES.enter || e.keyCode === _consts.KEYCODES.space || e.code === _consts.KEYCODES.enter.toString() || e.code === _consts.KEYCODES.space.toString())) {
+  if (!keyboardRipple && (e.key === "Enter" || e.key === " ")) {
     keyboardRipple = true;
     rippleShow(e);
   }

package/dist/src/utils/Commons/ripple.util.js

@@ -1,4 +1,4 @@
-import { DELAY_RIPPLE, KEYCODES, ORIGAM_RIPPLE_STOP_KEY, RIPPLES } from "../../consts/index.js";
+import { DELAY_RIPPLE, ORIGAM_RIPPLE_STOP_KEY, RIPPLES } from "../../consts/index.js";
 import { isObject } from "../../utils/index.js";
 export function updateRipple(el, binding, wasEnabled) {
   const { value, modifiers } = binding;
@@ -140,11 +140,10 @@ export function rippleRemoveListeners(el) {
 }
 export function rippleTransform(el, value) {
   el.style.transform = value;
-  el.style.webkitTransform = value;
 }
 let keyboardRipple = false;
 export function keyboardRippleShow(e) {
-  if (!keyboardRipple && (e.keyCode === KEYCODES.enter || e.keyCode === KEYCODES.space || (e.code === KEYCODES.enter.toString() || e.code === KEYCODES.space.toString()))) {
+  if (!keyboardRipple && (e.key === "Enter" || e.key === " ")) {
     keyboardRipple = true;
     rippleShow(e);
   }

package/dist/src/utils/Commons/rounded.util.cjs

@@ -4,6 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.formatRoundedStylesVar = formatRoundedStylesVar;
+exports.isCustomBorderRadius = isCustomBorderRadius;
+var _consts = require("../../consts/index.cjs");
+function isCustomBorderRadius(value) {
+  return _consts.CUSTOM_BORDER_RADIUS_REGEX.test(value.trim());
+}
 function formatRoundedStylesVar(values) {
   const styles = [];
   switch (values.length) {

package/dist/src/utils/Commons/rounded.util.d.ts

@@ -1,6 +1,15 @@
+/**
+ * Whether a string is a free-form custom `border-radius` value (a
+ * `var(...)` / `calc(...)` reference or a single CSS length outside the
+ * literal `BORDER_RADIUS_REGEX` whitelist) that should be emitted verbatim
+ * as an inline `border-radius` declaration.
+ *
+ * @param value …
+ */
+export declare function isCustomBorderRadius(value: string): boolean;
 /**
  * Format rounded styles var.
  *
  * @param values …
  */
-export declare function formatRoundedStylesVar(values: Array<string>): never[];
+export declare function formatRoundedStylesVar(values: Array<string>): string[];

package/dist/src/utils/Commons/rounded.util.js

@@ -1,3 +1,7 @@
+import { CUSTOM_BORDER_RADIUS_REGEX } from "../../consts/index.js";
+export function isCustomBorderRadius(value) {
+  return CUSTOM_BORDER_RADIUS_REGEX.test(value.trim());
+}
 export function formatRoundedStylesVar(values) {
   const styles = [];
   switch (values.length) {

package/dist/src/utils/DataTable/headers.util.cjs

@@ -41,7 +41,7 @@ function convertToInternalHeaders(items) {
       ...defaultItem,
       key,
       value,
-      sortable: defaultItem.sortable ?? (defaultItem.key != null || !!defaultItem.sort),
+      sortable: defaultItem.sortable ?? (key != null || !!defaultItem.sort),
       children: defaultItem.children ? convertToInternalHeaders(defaultItem.children) : void 0
     };
     internalHeaders.push(internalItem);

package/dist/src/utils/DataTable/headers.util.js

@@ -25,7 +25,7 @@ export function convertToInternalHeaders(items) {
       ...defaultItem,
       key,
       value,
-      sortable: defaultItem.sortable ?? (defaultItem.key != null || !!defaultItem.sort),
+      sortable: defaultItem.sortable ?? (key != null || !!defaultItem.sort),
       children: defaultItem.children ? convertToInternalHeaders(defaultItem.children) : void 0
     };
     internalHeaders.push(internalItem);

package/dist/src/utils/DataTable/sort.util.cjs

@@ -32,13 +32,13 @@ function sortItems(items, sortByItems, options) {
         const customResult = options.sortRawFunctions[sortKey](sortARaw, sortBRaw);
         if (customResult == null) continue;
         hasCustomResult = true;
-        if (customResult) return customResult;
+        if (customResult !== 0) return customResult;
       }
       if (options?.sortFunctions?.[sortKey]) {
         const customResult = options.sortFunctions[sortKey](sortA, sortB);
         if (customResult == null) continue;
         hasCustomResult = true;
-        if (customResult) return customResult;
+        if (customResult !== 0) return customResult;
       }
       if (hasCustomResult) continue;
       if (sortA instanceof Date && sortB instanceof Date) {

package/dist/src/utils/DataTable/sort.util.js

@@ -28,13 +28,13 @@ export function sortItems(items, sortByItems, options) {
         const customResult = options.sortRawFunctions[sortKey](sortARaw, sortBRaw);
         if (customResult == null) continue;
         hasCustomResult = true;
-        if (customResult) return customResult;
+        if (customResult !== 0) return customResult;
       }
       if (options?.sortFunctions?.[sortKey]) {
         const customResult = options.sortFunctions[sortKey](sortA, sortB);
         if (customResult == null) continue;
         hasCustomResult = true;
-        if (customResult) return customResult;
+        if (customResult !== 0) return customResult;
       }
       if (hasCustomResult) continue;
       if (sortA instanceof Date && sortB instanceof Date) {

package/dist/src/utils/List/list-item.util.d.ts

@@ -14,5 +14,12 @@ export declare function transformListItems(props: IItemProps & {
  * @param props …
  * @param item  …
  * @returns …
+ *
+ * @note When `props.itemValue` is `undefined`, `getPropertyFromItem` returns
+ * its fallback, which is `title` (the resolved title value). This is the
+ * intentional Vuetify-like behaviour: without an explicit `itemValue` mapping,
+ * the item's resolved title becomes both its display label and its selection
+ * value. This is NOT a bug — it enables string arrays to work without any
+ * additional configuration (e.g. `items: ['Alice', 'Bob']`).
  */
 export declare function transformListItem(props: Omit<IItemProps, 'items'>, item: any): IInternalListItem;