@work-rjkashyap/unified-ui 0.3.3 → 0.3.5

package/dist/tokens/z-index.d.cts

@@ -0,0 +1,24 @@
+declare const zIndex: {
+    /** Default document flow — no explicit stacking */
+    readonly base: "0";
+    /** Sticky headers, floating action bars, pinned columns */
+    readonly sticky: "10";
+    /** Backdrop overlays behind modals and drawers */
+    readonly overlay: "40";
+    /** Modals, dialogs, sheets, drawers */
+    readonly modal: "50";
+    /** Dropdowns, select menus, context menus — renders above modals */
+    readonly dropdown: "60";
+    /** Popovers, comboboxes, date pickers — renders above modals */
+    readonly popover: "70";
+    /** Toast notifications — always visible above all content */
+    readonly toast: "80";
+    /** Tooltips — highest interactive z-layer */
+    readonly tooltip: "90";
+    /** Emergency escape hatch — use sparingly and document why */
+    readonly max: "9999";
+};
+type ZIndex = keyof typeof zIndex;
+type ZIndexValue = (typeof zIndex)[ZIndex];
+
+export { type ZIndex, type ZIndexValue, zIndex };

package/dist/tokens/z-index.d.ts

@@ -0,0 +1,24 @@
+declare const zIndex: {
+    /** Default document flow — no explicit stacking */
+    readonly base: "0";
+    /** Sticky headers, floating action bars, pinned columns */
+    readonly sticky: "10";
+    /** Backdrop overlays behind modals and drawers */
+    readonly overlay: "40";
+    /** Modals, dialogs, sheets, drawers */
+    readonly modal: "50";
+    /** Dropdowns, select menus, context menus — renders above modals */
+    readonly dropdown: "60";
+    /** Popovers, comboboxes, date pickers — renders above modals */
+    readonly popover: "70";
+    /** Toast notifications — always visible above all content */
+    readonly toast: "80";
+    /** Tooltips — highest interactive z-layer */
+    readonly tooltip: "90";
+    /** Emergency escape hatch — use sparingly and document why */
+    readonly max: "9999";
+};
+type ZIndex = keyof typeof zIndex;
+type ZIndexValue = (typeof zIndex)[ZIndex];
+
+export { type ZIndex, type ZIndexValue, zIndex };

package/dist/tokens/z-index.mjs

@@ -0,0 +1,23 @@
+const zIndex = {
+  /** Default document flow — no explicit stacking */
+  base: "0",
+  /** Sticky headers, floating action bars, pinned columns */
+  sticky: "10",
+  /** Backdrop overlays behind modals and drawers */
+  overlay: "40",
+  /** Modals, dialogs, sheets, drawers */
+  modal: "50",
+  /** Dropdowns, select menus, context menus — renders above modals */
+  dropdown: "60",
+  /** Popovers, comboboxes, date pickers — renders above modals */
+  popover: "70",
+  /** Toast notifications — always visible above all content */
+  toast: "80",
+  /** Tooltips — highest interactive z-layer */
+  tooltip: "90",
+  /** Emergency escape hatch — use sparingly and document why */
+  max: "9999"
+};
+export {
+  zIndex
+};

package/dist/utils/cn.cjs

@@ -0,0 +1,102 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var cn_exports = {};
+__export(cn_exports, {
+  cn: () => cn,
+  composeRefs: () => composeRefs,
+  dsAttr: () => dsAttr,
+  dsColorVar: () => dsColorVar,
+  dsStateAttr: () => dsStateAttr,
+  dsVar: () => dsVar,
+  mergeSlots: () => mergeSlots,
+  noop: () => noop,
+  typedKeys: () => typedKeys
+});
+module.exports = __toCommonJS(cn_exports);
+var import_clsx = require("clsx");
+var import_tailwind_merge = require("tailwind-merge");
+function cn(...inputs) {
+  return (0, import_tailwind_merge.twMerge)((0, import_clsx.clsx)(inputs));
+}
+function mergeSlots(defaults, overrides) {
+  if (!overrides) {
+    return defaults;
+  }
+  const allKeys = /* @__PURE__ */ new Set([
+    ...Object.keys(defaults),
+    ...Object.keys(overrides)
+  ]);
+  const result = {};
+  for (const key of allKeys) {
+    result[key] = cn(defaults[key] ?? "", overrides[key] ?? "");
+  }
+  return result;
+}
+function dsAttr(componentName) {
+  return {
+    "data-ds": "",
+    "data-ds-component": componentName
+  };
+}
+function dsStateAttr(state, active) {
+  if (!active) return {};
+  return { [`data-ds-${state}`]: "" };
+}
+function dsVar(category, name, fallback) {
+  const varName = `--${category}-${name}`;
+  return fallback ? `var(${varName}, ${fallback})` : `var(${varName})`;
+}
+function dsColorVar(name, alpha) {
+  const varRef = `var(--${name})`;
+  if (alpha !== void 0) {
+    return `color-mix(in oklch, ${varRef} ${Math.round(alpha * 100)}%, transparent)`;
+  }
+  return varRef;
+}
+function setRef(ref, value) {
+  if (typeof ref === "function") {
+    ref(value);
+  } else if (ref !== null && ref !== void 0) {
+    ref.current = value;
+  }
+}
+function composeRefs(...refs) {
+  return (node) => {
+    for (const ref of refs) {
+      setRef(ref, node);
+    }
+  };
+}
+function typedKeys(obj) {
+  return Object.keys(obj);
+}
+const noop = () => {
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  cn,
+  composeRefs,
+  dsAttr,
+  dsColorVar,
+  dsStateAttr,
+  dsVar,
+  mergeSlots,
+  noop,
+  typedKeys
+});

package/dist/utils/cn.d.cts

@@ -0,0 +1,84 @@
+import { ClassValue } from 'clsx';
+
+declare function cn(...inputs: ClassValue[]): string;
+type SlotClasses<S extends string = string> = Partial<Record<S, string>>;
+/**
+ * Merge default slot classes with user-provided overrides.
+ * Each slot is merged independently using `cn()`.
+ */
+declare function mergeSlots<S extends string>(defaults: SlotClasses<S>, overrides?: SlotClasses<S>): Record<S, string>;
+/**
+ * The `as` prop type — constrains to valid React element types.
+ */
+type AsProp<C extends React.ElementType = React.ElementType> = {
+    as?: C;
+};
+/**
+ * Extracts the props of the given element type, omitting keys that
+ * the component itself defines (to prevent collisions).
+ */
+type PolymorphicProps<C extends React.ElementType, OwnProps = object> = OwnProps & AsProp<C> & Omit<React.ComponentPropsWithoutRef<C>, keyof OwnProps | "as">;
+/**
+ * Ref type for a polymorphic component.
+ */
+type PolymorphicRef<C extends React.ElementType> = React.ComponentPropsWithRef<C>["ref"];
+/**
+ * Full polymorphic component props including the ref.
+ */
+type PolymorphicPropsWithRef<C extends React.ElementType, OwnProps = object> = PolymorphicProps<C, OwnProps> & {
+    ref?: PolymorphicRef<C>;
+};
+/**
+ * Returns the data attribute object for a design system component.
+ *
+ * @example
+ *   dsAttr("button") → { "data-ds": "", "data-ds-component": "button" }
+ */
+declare function dsAttr(componentName: string): Record<string, string>;
+/**
+ * Returns a data attribute object for a specific component state.
+ *
+ * @example
+ *   dsStateAttr("loading", true) → { "data-ds-loading": "" }
+ *   dsStateAttr("loading", false) → {}
+ */
+declare function dsStateAttr(state: string, active: boolean): Record<string, string>;
+/**
+ * Returns a CSS `var()` reference to a design system custom property.
+ *
+ * @param category - The token category (e.g. "color", "radius", "z")
+ * @param name - The token name within that category
+ * @param fallback - Optional CSS fallback value
+ */
+declare function dsVar(category: string, name: string, fallback?: string): string;
+/**
+ * Returns a `var(...)` reference for color tokens. Colors are stored as
+ * complete oklch() values in CSS custom properties with no prefix.
+ *
+ * For alpha-modified colors, uses `color-mix(in oklch, ...)` for broad
+ * browser support.
+ *
+ * @example
+ *   dsColorVar("primary")       → "var(--primary)"
+ *   dsColorVar("primary", 0.5)  → "color-mix(in oklch, var(--primary) 50%, transparent)"
+ */
+declare function dsColorVar(name: string, alpha?: number): string;
+type PossibleRef<T> = React.Ref<T> | undefined;
+/**
+ * Compose multiple refs into a single ref callback.
+ *
+ * @example
+ *   const Component = forwardRef<HTMLDivElement, Props>((props, ref) => {
+ *     const internalRef = useRef<HTMLDivElement>(null);
+ *     return <div ref={composeRefs(ref, internalRef)} />;
+ *   });
+ */
+declare function composeRefs<T>(...refs: PossibleRef<T>[]): (node: T | null) => void;
+/**
+ * Type-safe Object.keys that preserves key literal types.
+ */
+declare function typedKeys<T extends Record<string, unknown>>(obj: T): (keyof T)[];
+/** A no-operation function. Useful as a default callback. */
+declare const noop: () => void;
+
+export { type AsProp, type PolymorphicProps, type PolymorphicPropsWithRef, type PolymorphicRef, type SlotClasses, cn, composeRefs, dsAttr, dsColorVar, dsStateAttr, dsVar, mergeSlots, noop, typedKeys };

package/dist/utils/cn.d.ts

@@ -0,0 +1,84 @@
+import { ClassValue } from 'clsx';
+
+declare function cn(...inputs: ClassValue[]): string;
+type SlotClasses<S extends string = string> = Partial<Record<S, string>>;
+/**
+ * Merge default slot classes with user-provided overrides.
+ * Each slot is merged independently using `cn()`.
+ */
+declare function mergeSlots<S extends string>(defaults: SlotClasses<S>, overrides?: SlotClasses<S>): Record<S, string>;
+/**
+ * The `as` prop type — constrains to valid React element types.
+ */
+type AsProp<C extends React.ElementType = React.ElementType> = {
+    as?: C;
+};
+/**
+ * Extracts the props of the given element type, omitting keys that
+ * the component itself defines (to prevent collisions).
+ */
+type PolymorphicProps<C extends React.ElementType, OwnProps = object> = OwnProps & AsProp<C> & Omit<React.ComponentPropsWithoutRef<C>, keyof OwnProps | "as">;
+/**
+ * Ref type for a polymorphic component.
+ */
+type PolymorphicRef<C extends React.ElementType> = React.ComponentPropsWithRef<C>["ref"];
+/**
+ * Full polymorphic component props including the ref.
+ */
+type PolymorphicPropsWithRef<C extends React.ElementType, OwnProps = object> = PolymorphicProps<C, OwnProps> & {
+    ref?: PolymorphicRef<C>;
+};
+/**
+ * Returns the data attribute object for a design system component.
+ *
+ * @example
+ *   dsAttr("button") → { "data-ds": "", "data-ds-component": "button" }
+ */
+declare function dsAttr(componentName: string): Record<string, string>;
+/**
+ * Returns a data attribute object for a specific component state.
+ *
+ * @example
+ *   dsStateAttr("loading", true) → { "data-ds-loading": "" }
+ *   dsStateAttr("loading", false) → {}
+ */
+declare function dsStateAttr(state: string, active: boolean): Record<string, string>;
+/**
+ * Returns a CSS `var()` reference to a design system custom property.
+ *
+ * @param category - The token category (e.g. "color", "radius", "z")
+ * @param name - The token name within that category
+ * @param fallback - Optional CSS fallback value
+ */
+declare function dsVar(category: string, name: string, fallback?: string): string;
+/**
+ * Returns a `var(...)` reference for color tokens. Colors are stored as
+ * complete oklch() values in CSS custom properties with no prefix.
+ *
+ * For alpha-modified colors, uses `color-mix(in oklch, ...)` for broad
+ * browser support.
+ *
+ * @example
+ *   dsColorVar("primary")       → "var(--primary)"
+ *   dsColorVar("primary", 0.5)  → "color-mix(in oklch, var(--primary) 50%, transparent)"
+ */
+declare function dsColorVar(name: string, alpha?: number): string;
+type PossibleRef<T> = React.Ref<T> | undefined;
+/**
+ * Compose multiple refs into a single ref callback.
+ *
+ * @example
+ *   const Component = forwardRef<HTMLDivElement, Props>((props, ref) => {
+ *     const internalRef = useRef<HTMLDivElement>(null);
+ *     return <div ref={composeRefs(ref, internalRef)} />;
+ *   });
+ */
+declare function composeRefs<T>(...refs: PossibleRef<T>[]): (node: T | null) => void;
+/**
+ * Type-safe Object.keys that preserves key literal types.
+ */
+declare function typedKeys<T extends Record<string, unknown>>(obj: T): (keyof T)[];
+/** A no-operation function. Useful as a default callback. */
+declare const noop: () => void;
+
+export { type AsProp, type PolymorphicProps, type PolymorphicPropsWithRef, type PolymorphicRef, type SlotClasses, cn, composeRefs, dsAttr, dsColorVar, dsStateAttr, dsVar, mergeSlots, noop, typedKeys };

package/dist/{chunk-ZT3PCXDF.mjs → utils/cn.mjs}

@@ -1,7 +1,5 @@
-import { clsx } from 'clsx';
-import { twMerge } from 'tailwind-merge';
-
-// src/utils/cn.ts
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
 function cn(...inputs) {
   return twMerge(clsx(inputs));
 }
@@ -57,7 +55,16 @@ function composeRefs(...refs) {
 function typedKeys(obj) {
   return Object.keys(obj);
 }
-var noop = () => {
+const noop = () => {
+};
+export {
+  cn,
+  composeRefs,
+  dsAttr,
+  dsColorVar,
+  dsStateAttr,
+  dsVar,
+  mergeSlots,
+  noop,
+  typedKeys
 };
-
-export { cn, composeRefs, dsAttr, dsColorVar, dsStateAttr, dsVar, mergeSlots, noop, typedKeys };

package/dist/{chunk-33QEKXRQ.cjs → utils/contrast.cjs}

@@ -1,11 +1,48 @@
-'use strict';
-
-// src/utils/contrast.ts
-var WCAG_AA_NORMAL = 4.5;
-var WCAG_AA_LARGE = 3;
-var WCAG_AAA_NORMAL = 7;
-var WCAG_AAA_LARGE = 4.5;
-var WCAG_NON_TEXT_AA = 3;
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var contrast_exports = {};
+__export(contrast_exports, {
+  DS_DARK_CRITICAL_PAIRS: () => DS_DARK_CRITICAL_PAIRS,
+  DS_LIGHT_CRITICAL_PAIRS: () => DS_LIGHT_CRITICAL_PAIRS,
+  WCAG_AAA_LARGE: () => WCAG_AAA_LARGE,
+  WCAG_AAA_NORMAL: () => WCAG_AAA_NORMAL,
+  WCAG_AA_LARGE: () => WCAG_AA_LARGE,
+  WCAG_AA_NORMAL: () => WCAG_AA_NORMAL,
+  WCAG_NON_TEXT_AA: () => WCAG_NON_TEXT_AA,
+  auditContrast: () => auditContrast,
+  checkDSContrast: () => checkDSContrast,
+  checkHexContrast: () => checkHexContrast,
+  contrastRatio: () => contrastRatio,
+  meetsAA: () => meetsAA,
+  meetsAAA: () => meetsAAA,
+  meetsNonTextAA: () => meetsNonTextAA,
+  parseHex: () => parseHex,
+  parseRGBString: () => parseRGBString,
+  relativeLuminance: () => relativeLuminance,
+  toRGBString: () => toRGBString
+});
+module.exports = __toCommonJS(contrast_exports);
+const WCAG_AA_NORMAL = 4.5;
+const WCAG_AA_LARGE = 3;
+const WCAG_AAA_NORMAL = 7;
+const WCAG_AAA_LARGE = 4.5;
+const WCAG_NON_TEXT_AA = 3;
 function linearize(channel) {
   const normalized = channel / 255;
   if (normalized <= 0.04045) {
@@ -98,7 +135,7 @@ function auditContrast(pairs) {
     };
   });
 }
-var DS_LIGHT_CRITICAL_PAIRS = [
+const DS_LIGHT_CRITICAL_PAIRS = [
   // Primary text on backgrounds
   { label: "foreground on background", fg: "9 9 11", bg: "255 255 255" },
   { label: "primary on background", fg: "79 70 229", bg: "255 255 255" },
@@ -171,7 +208,7 @@ var DS_LIGHT_CRITICAL_PAIRS = [
     bg: "255 255 255"
   }
 ];
-var DS_DARK_CRITICAL_PAIRS = [
+const DS_DARK_CRITICAL_PAIRS = [
   // Primary text on backgrounds
   { label: "foreground on background", fg: "250 250 250", bg: "9 9 11" },
   // Primary shifted to brand.400 (129 140 248) for AA on dark bg (6.67:1)
@@ -238,31 +275,24 @@ var DS_DARK_CRITICAL_PAIRS = [
     bg: "9 9 11"
   }
 ];
-
-// src/utils/types.ts
-function dsDataAttrs(name) {
-  return {
-    "data-ds": true,
-    "data-ds-component": name
-  };
-}
-
-exports.DS_DARK_CRITICAL_PAIRS = DS_DARK_CRITICAL_PAIRS;
-exports.DS_LIGHT_CRITICAL_PAIRS = DS_LIGHT_CRITICAL_PAIRS;
-exports.WCAG_AAA_LARGE = WCAG_AAA_LARGE;
-exports.WCAG_AAA_NORMAL = WCAG_AAA_NORMAL;
-exports.WCAG_AA_LARGE = WCAG_AA_LARGE;
-exports.WCAG_AA_NORMAL = WCAG_AA_NORMAL;
-exports.WCAG_NON_TEXT_AA = WCAG_NON_TEXT_AA;
-exports.auditContrast = auditContrast;
-exports.checkDSContrast = checkDSContrast;
-exports.checkHexContrast = checkHexContrast;
-exports.contrastRatio = contrastRatio;
-exports.dsDataAttrs = dsDataAttrs;
-exports.meetsAA = meetsAA;
-exports.meetsAAA = meetsAAA;
-exports.meetsNonTextAA = meetsNonTextAA;
-exports.parseHex = parseHex;
-exports.parseRGBString = parseRGBString;
-exports.relativeLuminance = relativeLuminance;
-exports.toRGBString = toRGBString;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DS_DARK_CRITICAL_PAIRS,
+  DS_LIGHT_CRITICAL_PAIRS,
+  WCAG_AAA_LARGE,
+  WCAG_AAA_NORMAL,
+  WCAG_AA_LARGE,
+  WCAG_AA_NORMAL,
+  WCAG_NON_TEXT_AA,
+  auditContrast,
+  checkDSContrast,
+  checkHexContrast,
+  contrastRatio,
+  meetsAA,
+  meetsAAA,
+  meetsNonTextAA,
+  parseHex,
+  parseRGBString,
+  relativeLuminance,
+  toRGBString
+});