@veracity/vui 3.0.0-beta.5 → 3.0.0-beta.6

package/dist/utils/react.d.ts

@@ -0,0 +1,43 @@
+import { AnyFunction, CreateContextOptions, CreateContextReturn } from "./types.js";
+import React, { DependencyList, Dispatch, RefObject, SetStateAction } from "react";
+
+//#region src/utils/react.d.ts
+type ReactRef<T> = React.Ref<T> | React.RefObject<T> | React.MutableRefObject<T>;
+/**
+ * Assigns given value to the provided ref.
+ * Supports ref as function (e.g. useState) and classic ref (e.g. useRef).
+ */
+declare function assignRef<T = any>(ref: ReactRef<T> | undefined, value: T): void;
+/** Generic function to create new Context and context access hook. */
+declare function createContext$1<ContextType>(options?: CreateContextOptions): CreateContextReturn<ContextType>;
+/** Assigns a node to all provided refs. */
+declare function mergeRefs<T>(...refs: (ReactRef<T> | undefined)[]): (node: T | null) => void;
+/** Returns given callback with a stable reference, but keeps it updated internally. */
+declare function useCallbackRef<T extends AnyFunction>(callback?: T, deps?: DependencyList): T;
+/**
+ * Triggers given callback when an event happens outside of a given element.
+ * Event listeners are attached to the window object.
+ * @param ref - element to check click position for
+ * @param callback - function triggered on outside click
+ * @param events - array of events listened for (default: ['mousedown', 'touchstart'])
+ */
+declare function useClickOutside(ref: RefObject<HTMLElement | null> | RefObject<HTMLElement | null>[], callback?: (event: Event) => void, events?: string[]): void;
+type UseControlledProps<T> = {
+  defaultValue?: T;
+  onChange?: (value: T) => void;
+  value?: T;
+};
+/** Supports state management in components that can be controlled or uncontrolled. */
+declare function useControlled<T>(props: UseControlledProps<T>): [T, Dispatch<SetStateAction<T>>, {
+  isControlled: boolean;
+  reset: () => void;
+}];
+/** Returns an array with each prefix added to the id. Useful for aria attributes in compound components. */
+declare function useIds(id: string, prefixes: string[]): string[];
+/**
+ * Provides a function, which can be called to check if component using the hook is mounted or unmounted.
+ */
+declare function useIsMounted(): () => boolean;
+//#endregion
+export { UseControlledProps, assignRef, createContext$1 as createContext, mergeRefs, useCallbackRef, useClickOutside, useControlled, useIds, useIsMounted };
+//# sourceMappingURL=react.d.ts.map

package/dist/utils/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","names":[],"sources":["../../src/utils/react.ts"],"sourcesContent":[],"mappings":";;;;KAOK,cAAc,KAAA,CAAM,IAAI,KAAK,KAAA,CAAM,UAAU,KAAK,KAAA,CAAM,iBAAiB;AAFO;;;;AAEnC,iBAMlC,SANkC,CAAA,IAAA,GAAA,CAAA,CAAA,GAAA,EAMV,QANU,CAMD,CANC,CAAA,GAAA,SAAA,EAAA,KAAA,EAMsB,CANtB,CAAA,EAAA,IAAA;;AAA4B,iBAuB9D,eAvB8D,CAAA,WAAA,CAAA,CAAA,OAAA,CAAA,EAuB1B,oBAvB0B,CAAA,EA0CnC,mBA1CmC,CA0Cf,WA1Ce,CAAA;;AAAD,iBA8C7D,SA9C6D,CAAA,CAAA,CAAA,CAAA,GAAA,IAAA,EAAA,CA8CtC,QA9CsC,CA8C7B,CA9C6B,CAAA,GAAA,SAAA,CAAA,EAAA,CAAA,EAAA,CAAA,IAAA,EA+C7D,CA/C6D,GAAA,IAAA,EAAA,GAAA,IAAA;AAM7E;AAAyB,iBAgDT,cAhDS,CAAA,UAgDgB,WAhDhB,CAAA,CAAA,QAAA,CAAA,EAgDwC,CAhDxC,EAAA,IAAA,CAAA,EAgDiD,cAhDjD,CAAA,EAgDoE,CAhDpE;;;;;AAiBzB;;;AAmB+D,iBA8B/C,eAAA,CA9B+C,GAAA,EA+BxD,SA/BwD,CA+B9C,WA/B8C,GAAA,IAAA,CAAA,GA+BxB,SA/BwB,CA+Bd,WA/Bc,GAAA,IAAA,CAAA,EAAA,EAAA,QAAA,CAAA,EAAA,CAAA,KAAA,EAgC1C,KAhC0C,EAAA,GAAA,IAAA,EAAA,MAAA,CAAA,EAAA,MAAA,EAAA,CAAA,EAAA,IAAA;AAApB,KAoD/B,kBApD+B,CAAA,CAAA,CAAA,GAAA;EAAmB,YAAA,CAAA,EAqD7C,CArD6C;EAI9C,QAAA,CAAA,EAAA,CAAS,KAAA,EAkDJ,CAlDI,EAAA,GAAA,IAAA;EAAA,KAAA,CAAA,EAmDf,CAnDe;;;AACT,iBAuDA,aAvDA,CAAA,CAAA,CAAA,CAAA,KAAA,EAuDwB,kBAvDxB,CAuD2C,CAvD3C,CAAA,CAAA,EAAA,CA6EZ,CA7EY,EA8EZ,QA9EY,CA8EH,cA9EG,CA8EY,CA9EZ,CAAA,CAAA,EAAA;EAAC,YAAA,EAAA,OAAA;EAOD,KAAA,EAAA,GAAA,GAAA,IAAc;CAAA,CAAA;;AAAmC,iBA6EjD,MAAA,CA7EiD,EAAA,EAAA,MAAA,EAAA,QAAA,EAAA,MAAA,EAAA,CAAA,EAAA,MAAA,EAAA;;;;AAkBjD,iBAmEA,YAAA,CAAA,CAnEe,EAAA,GAAA,GAAA,OAAA"}

package/dist/utils/react.js

@@ -0,0 +1,2 @@
+import{isArray as e,isFunction as t}from"./assertion.js";import{runIfFn as n}from"./function.js";import r,{useCallback as i,useEffect as a,useRef as o,useState as s}from"react";function c(e,n){if(e!=null){if(t(e)){e(n);return}try{e.current=n}catch{throw Error(`Cannot assign value '${n}' to ref '${e}'`)}}}function l(e={}){let{errorMessage:t=`Context can only be accessed by components wrapped with the Provider.`,isOptional:n,name:i}=e,a=r.createContext(void 0);a.displayName=i;function o(){let e=r.useContext(a);if(!n&&e===void 0)throw Error(t);return e}return[a.Provider,o]}function u(...e){return t=>{e.forEach(e=>c(e,t))}}function d(e,t=[]){let n=o(e);return n.current=e,i(((...e)=>n.current?.(...e)),t)}const f=[`mousedown`,`touchstart`];function p(t,n,r=f){let i=JSON.stringify(r),o=d(r=>{let i=e(t)?t:[t],a=r.target;i.every(e=>e.current&&!e.current.contains(a))&&n?.(r)});a(()=>{let e=JSON.parse(i);return e.forEach(e=>window.addEventListener(e,o)),()=>{e.forEach(e=>window.removeEventListener(e,o))}},[i,t])}function m(e){let{defaultValue:t,onChange:r,value:i}=e,[a,o]=s(t),c=i!==void 0,l=c?i:a,u=d(e=>{let t=n(e);c||o(t),r?.(t)}),f=d(()=>{!c&&t&&u(t)});return[l,u,{isControlled:c,reset:f}]}function h(e,t){return t.map(t=>`${t}-${e}`)}function g(){let e=o(!1);return a(()=>(e.current=!0,()=>{e.current=!1}),[]),i(()=>e.current,[])}export{c as assignRef,l as createContext,u as mergeRefs,d as useCallbackRef,p as useClickOutside,m as useControlled,h as useIds,g as useIsMounted};globalThis.__vuiVersion__=`3.0.0-beta.6`;
+//# sourceMappingURL=react.js.map

package/dist/utils/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","names":["createContext","useContext","ref","events: string[]"],"sources":["../../src/utils/react.ts"],"sourcesContent":["import type { DependencyList, Dispatch, RefObject, SetStateAction } from 'react'\nimport React, { useCallback, useEffect, useRef, useState } from 'react'\n\nimport { isArray, isFunction } from './assertion'\nimport { runIfFn } from './function'\nimport type { AnyFunction, CreateContextOptions, CreateContextReturn } from './types'\n\ntype ReactRef<T> = React.Ref<T> | React.RefObject<T> | React.MutableRefObject<T>\n\n/**\n * Assigns given value to the provided ref.\n * Supports ref as function (e.g. useState) and classic ref (e.g. useRef).\n */\nexport function assignRef<T = any>(ref: ReactRef<T> | undefined, value: T) {\n  if (ref === null || ref === undefined) return\n\n  if (isFunction(ref)) {\n    ref(value)\n    return\n  }\n\n  try {\n    // @ts-expect-error TS complains about 'current' being read-only\n    ref.current = value\n  } catch (error) {\n    throw new Error(`Cannot assign value '${value}' to ref '${ref}'`)\n  }\n}\n\n/** Generic function to create new Context and context access hook. */\nexport function createContext<ContextType>(options: CreateContextOptions = {}) {\n  const {\n    errorMessage = 'Context can only be accessed by components wrapped with the Provider.',\n    isOptional,\n    name,\n  } = options\n\n  const Context = React.createContext<ContextType | undefined>(undefined)\n\n  Context.displayName = name\n\n  function useContext() {\n    const context = React.useContext(Context)\n\n    if (!isOptional && context === undefined) throw new Error(errorMessage)\n\n    return context\n  }\n\n  return [Context.Provider, useContext] as CreateContextReturn<ContextType>\n}\n\n/** Assigns a node to all provided refs. */\nexport function mergeRefs<T>(...refs: (ReactRef<T> | undefined)[]) {\n  return (node: T | null) => {\n    refs.forEach(ref => assignRef(ref, node))\n  }\n}\n\n// TODO: Bring it from UI-Utils\n/** Returns given callback with a stable reference, but keeps it updated internally. */\nexport function useCallbackRef<T extends AnyFunction>(callback?: T, deps: DependencyList = []) {\n  const ref = useRef(callback)\n\n  ref.current = callback\n\n  return useCallback(((...args) => ref.current?.(...args)) as T, deps)\n}\n\nconst defaultEvents = ['mousedown', 'touchstart']\n\n// TODO: Bring it from UI-Utils\n/**\n * Triggers given callback when an event happens outside of a given element.\n * Event listeners are attached to the window object.\n * @param ref - element to check click position for\n * @param callback - function triggered on outside click\n * @param events - array of events listened for (default: ['mousedown', 'touchstart'])\n */\nexport function useClickOutside(\n  ref: RefObject<HTMLElement | null> | RefObject<HTMLElement | null>[],\n  callback?: (event: Event) => void,\n  events: string[] = defaultEvents,\n) {\n  const eventsString = JSON.stringify(events)\n  const listener = useCallbackRef((ev: Event) => {\n    const refs = isArray(ref) ? ref : [ref]\n    const target = ev.target as HTMLElement\n    const isClickOutside = refs.every(ref => ref.current && !ref.current.contains(target))\n    isClickOutside && callback?.(ev)\n  })\n\n  useEffect(() => {\n    const events: string[] = JSON.parse(eventsString)\n    events.forEach(event => window.addEventListener(event, listener))\n    return () => {\n      events.forEach(event => window.removeEventListener(event, listener))\n    }\n  }, [eventsString, ref])\n}\n\nexport type UseControlledProps<T> = {\n  defaultValue?: T\n  onChange?: (value: T) => void\n  value?: T\n}\n\n// TODO: Move to ui-utils\n/** Supports state management in components that can be controlled or uncontrolled. */\nexport function useControlled<T>(props: UseControlledProps<T>) {\n  const { defaultValue, onChange: onChangeProp, value: valueProp } = props\n  const [valueState, setValue] = useState(defaultValue)\n\n  const isControlled = valueProp !== undefined\n  const value = isControlled ? valueProp : valueState\n\n  /** Triggers the external callback with the new value. In uncontrolled mode, updates state. */\n  const onChange = useCallbackRef((next: SetStateAction<T>) => {\n    const newValue = runIfFn(next)\n\n    if (!isControlled) setValue(newValue)\n\n    onChangeProp?.(newValue)\n  })\n\n  /** In uncontrolled mode, sets the state to the default value. */\n  const reset = useCallbackRef(() => {\n    !isControlled && defaultValue && onChange(defaultValue)\n  })\n\n  return [value, onChange, { isControlled, reset }] as [\n    T,\n    Dispatch<SetStateAction<T>>,\n    { isControlled: boolean; reset: () => void },\n  ]\n}\n\n/** Returns an array with each prefix added to the id. Useful for aria attributes in compound components. */\nexport function useIds(id: string, prefixes: string[]) {\n  return prefixes.map(prefix => `${prefix}-${id}`)\n}\n\n// TODO: Bring it from ui-utils\n/**\n * Provides a function, which can be called to check if component using the hook is mounted or unmounted.\n */\nexport function useIsMounted() {\n  const isMounted = useRef(false)\n\n  useEffect(() => {\n    isMounted.current = true\n\n    return () => {\n      isMounted.current = false\n    }\n  }, [])\n\n  return useCallback(() => isMounted.current, [])\n}\n"],"mappings":"iLAaA,SAAgB,EAAmB,EAA8B,EAAU,CACrE,MAAQ,KAEZ,IAAI,EAAW,EAAI,CAAE,CACnB,EAAI,EAAM,CACV,OAGF,GAAI,CAEF,EAAI,QAAU,OACA,CACd,MAAU,MAAM,wBAAwB,EAAM,YAAY,EAAI,GAAG,GAKrE,SAAgBA,EAA2B,EAAgC,EAAE,CAAE,CAC7E,GAAM,CACJ,eAAe,wEACf,aACA,QACE,EAEE,EAAU,EAAM,cAAuC,IAAA,GAAU,CAEvE,EAAQ,YAAc,EAEtB,SAASC,GAAa,CACpB,IAAM,EAAU,EAAM,WAAW,EAAQ,CAEzC,GAAI,CAAC,GAAc,IAAY,IAAA,GAAW,MAAU,MAAM,EAAa,CAEvE,OAAO,EAGT,MAAO,CAAC,EAAQ,SAAUA,EAAW,CAIvC,SAAgB,EAAa,GAAG,EAAmC,CACjE,MAAQ,IAAmB,CACzB,EAAK,QAAQ,GAAO,EAAU,EAAK,EAAK,CAAC,EAM7C,SAAgB,EAAsC,EAAc,EAAuB,EAAE,CAAE,CAC7F,IAAM,EAAM,EAAO,EAAS,CAI5B,MAFA,GAAI,QAAU,EAEP,IAAc,GAAG,IAAS,EAAI,UAAU,GAAG,EAAK,EAAQ,EAAK,CAGtE,MAAM,EAAgB,CAAC,YAAa,aAAa,CAUjD,SAAgB,EACd,EACA,EACA,EAAmB,EACnB,CACA,IAAM,EAAe,KAAK,UAAU,EAAO,CACrC,EAAW,EAAgB,GAAc,CAC7C,IAAM,EAAO,EAAQ,EAAI,CAAG,EAAM,CAAC,EAAI,CACjC,EAAS,EAAG,OACK,EAAK,MAAM,GAAOC,EAAI,SAAW,CAACA,EAAI,QAAQ,SAAS,EAAO,CAAC,EACpE,IAAW,EAAG,EAChC,CAEF,MAAgB,CACd,IAAMC,EAAmB,KAAK,MAAM,EAAa,CAEjD,OADA,EAAO,QAAQ,GAAS,OAAO,iBAAiB,EAAO,EAAS,CAAC,KACpD,CACX,EAAO,QAAQ,GAAS,OAAO,oBAAoB,EAAO,EAAS,CAAC,GAErE,CAAC,EAAc,EAAI,CAAC,CAWzB,SAAgB,EAAiB,EAA8B,CAC7D,GAAM,CAAE,eAAc,SAAU,EAAc,MAAO,GAAc,EAC7D,CAAC,EAAY,GAAY,EAAS,EAAa,CAE/C,EAAe,IAAc,IAAA,GAC7B,EAAQ,EAAe,EAAY,EAGnC,EAAW,EAAgB,GAA4B,CAC3D,IAAM,EAAW,EAAQ,EAAK,CAEzB,GAAc,EAAS,EAAS,CAErC,IAAe,EAAS,EACxB,CAGI,EAAQ,MAAqB,CACjC,CAAC,GAAgB,GAAgB,EAAS,EAAa,EACvD,CAEF,MAAO,CAAC,EAAO,EAAU,CAAE,eAAc,QAAO,CAAC,CAQnD,SAAgB,EAAO,EAAY,EAAoB,CACrD,OAAO,EAAS,IAAI,GAAU,GAAG,EAAO,GAAG,IAAK,CAOlD,SAAgB,GAAe,CAC7B,IAAM,EAAY,EAAO,GAAM,CAU/B,OARA,OACE,EAAU,QAAU,OAEP,CACX,EAAU,QAAU,KAErB,EAAE,CAAC,CAEC,MAAkB,EAAU,QAAS,EAAE,CAAC"}

package/dist/utils/string.d.ts

@@ -0,0 +1,16 @@
+//#region src/utils/string.d.ts
+/**
+ * Normalizes a string to be used as an identifier
+ * - Converts to lowercase
+ * - Replaces spaces and special characters with hyphens
+ * - Removes consecutive hyphens
+ * - Trims leading/trailing hyphens
+ */
+declare const normalizeToId: (str: string) => string;
+/**
+ * Generates a menu item ID from title and level
+ */
+declare const generateMenuItemId: (title: string, level?: number) => string;
+//#endregion
+export { generateMenuItemId, normalizeToId };
+//# sourceMappingURL=string.d.ts.map

package/dist/utils/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","names":[],"sources":["../../src/utils/string.ts"],"sourcesContent":[],"mappings":";;AAOA;AAYA;;;;;cAZa;;;;cAYA"}

package/dist/utils/string.js

@@ -0,0 +1,2 @@
+const e=e=>e.toLowerCase().replace(/\s+/g,`-`).replace(/[^a-z0-9-]/g,`-`).replace(/-+/g,`-`).replace(/^-+|-+$/g,``),t=(t,n=0)=>{let r=e(t);return r?`${r}-${n}`:`item-${n}`};export{t as generateMenuItemId,e as normalizeToId};globalThis.__vuiVersion__=`3.0.0-beta.6`;
+//# sourceMappingURL=string.js.map

package/dist/utils/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","names":[],"sources":["../../src/utils/string.ts"],"sourcesContent":["/**\n * Normalizes a string to be used as an identifier\n * - Converts to lowercase\n * - Replaces spaces and special characters with hyphens\n * - Removes consecutive hyphens\n * - Trims leading/trailing hyphens\n */\nexport const normalizeToId = (str: string): string => {\n  return str\n    .toLowerCase()\n    .replace(/\\s+/g, '-') // Replace spaces with hyphens\n    .replace(/[^a-z0-9-]/g, '-') // Replace special characters with hyphens\n    .replace(/-+/g, '-') // Replace consecutive hyphens with single hyphen\n    .replace(/^-+|-+$/g, '') // Remove leading and trailing hyphens\n}\n\n/**\n * Generates a menu item ID from title and level\n */\nexport const generateMenuItemId = (title: string, level: number = 0): string => {\n  const normalizedTitle = normalizeToId(title)\n  return normalizedTitle ? `${normalizedTitle}-${level}` : `item-${level}`\n}\n"],"mappings":"AAOA,MAAa,EAAiB,GACrB,EACJ,aAAa,CACb,QAAQ,OAAQ,IAAI,CACpB,QAAQ,cAAe,IAAI,CAC3B,QAAQ,MAAO,IAAI,CACnB,QAAQ,WAAY,GAAG,CAMf,GAAsB,EAAe,EAAgB,IAAc,CAC9E,IAAM,EAAkB,EAAc,EAAM,CAC5C,OAAO,EAAkB,GAAG,EAAgB,GAAG,IAAU,QAAQ"}

package/dist/utils/styles.d.ts

@@ -0,0 +1,25 @@
+import { Property } from "csstype";
+
+//#region src/utils/styles.d.ts
+/** Concatenates individual className arguments and returns a single string. */
+declare function cs(...classNames: any[]): string;
+/** Parses HSL color code. */
+declare function parseHSL(color: string): {
+  h: number;
+  s: number;
+  l: number;
+};
+/** Converts hex color value to rgb with optional alpha property. */
+declare function hexToRGBA(hex: string, alpha?: number): string;
+declare function vuiColorToRGBA(color: string, alpha?: number): string;
+/** Converts hsl color value to rgb with optional alpha property. */
+declare function HSLToRGBA(h: number, s: number, l: number, alpha?: number): string;
+/** Styling to add ellipsis for long texts. */
+declare const ellipsisOverflow: {
+  overflow: string;
+  textOverflow: string;
+  whiteSpace: Property.WhiteSpace;
+};
+//#endregion
+export { HSLToRGBA, cs, ellipsisOverflow, hexToRGBA, parseHSL, vuiColorToRGBA };
+//# sourceMappingURL=styles.d.ts.map

package/dist/utils/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","names":[],"sources":["../../src/utils/styles.ts"],"sourcesContent":[],"mappings":";;;;iBAKgB,EAAA;AAAhB;AAKgB,iBAAA,QAAA,CAAQ,KAAA,EAAA,MAAA,CAAA,EAAA;EAWR,CAAA,EAAA,MAAA;EAkBA,CAAA,EAAA,MAAA;EAUA,CAAA,EAAA,MAAA;AA6ChB,CAAA;;iBAzEgB,SAAA;iBAkBA,cAAA;;iBAUA,SAAA;;cA6CH;;;cAGa,QAAA,CAAS"}

package/dist/utils/styles.js

@@ -0,0 +1,2 @@
+import e from"../theme/foundations/colors.js";function t(...e){return e.filter(Boolean).join(` `)}function n(e){let t=/hsl\((\d+),\s*([\d.]+)%,\s*([\d.]+)%\)/g?.exec?.(e)?.slice?.(1);return{h:Number(t?.[0])||0,s:Number(t?.[1])||0,l:Number(t?.[2])||0}}function r(e,t){let n=e;n.charAt(0)===`#`&&(n=n.slice(1)),n.length<4&&(n=n.split(``).map(e=>e+e).join(``));let r=parseInt(n.slice(0,2),16),i=parseInt(n.slice(2,4),16),a=parseInt(n.slice(4,6),16);return t===void 0?`rgb(${r}, ${i}, ${a})`:`rgba(${r}, ${i}, ${a}, ${t})`}function i(t,r){if(!t.includes(`.`))return`transparent`;let[i,o]=t.split(`.`),s=n(e[i][o]);return a(s.h,s.s,s.l,r||o===`main`?1:parseInt(o))}function a(e,t,n,r){t/=100,n/=100;let i=(1-Math.abs(2*n-1))*t,a=i*(1-Math.abs(e/60%2-1)),o=n-i/2,s=0,c=0,l=0;return 0<=e&&e<60?(s=i,c=a,l=0):60<=e&&e<120?(s=a,c=i,l=0):120<=e&&e<180?(s=0,c=i,l=a):180<=e&&e<240?(s=0,c=a,l=i):240<=e&&e<300?(s=a,c=0,l=i):300<=e&&e<360&&(s=i,c=0,l=a),s=Math.round((s+o)*255),c=Math.round((c+o)*255),l=Math.round((l+o)*255),r===void 0?`rgb(${s}, ${c}, ${l})`:`rgba(${s}, ${c}, ${l}, ${r})`}const o={overflow:`hidden`,textOverflow:`ellipsis`,whiteSpace:`nowrap`};export{a as HSLToRGBA,t as cs,o as ellipsisOverflow,r as hexToRGBA,n as parseHSL,i as vuiColorToRGBA};globalThis.__vuiVersion__=`3.0.0-beta.6`;
+//# sourceMappingURL=styles.js.map

package/dist/utils/styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.js","names":["colors"],"sources":["../../src/utils/styles.ts"],"sourcesContent":["import type { Property } from 'csstype'\n\nimport colors from '../theme/foundations/colors'\n\n/** Concatenates individual className arguments and returns a single string. */\nexport function cs(...classNames: any[]) {\n  return classNames.filter(Boolean).join(' ')\n}\n\n/** Parses HSL color code. */\nexport function parseHSL(color: string) {\n  const regexp = /hsl\\((\\d+),\\s*([\\d.]+)%,\\s*([\\d.]+)%\\)/g\n  const res = regexp?.exec?.(color)?.slice?.(1)\n  return {\n    h: Number(res?.[0]) || 0,\n    s: Number(res?.[1]) || 0,\n    l: Number(res?.[2]) || 0,\n  }\n}\n\n/** Converts hex color value to rgb with optional alpha property. */\nexport function hexToRGBA(hex: string, alpha?: number) {\n  let hexStr = hex\n\n  if (hexStr.charAt(0) === '#') hexStr = hexStr.slice(1)\n\n  if (hexStr.length < 4)\n    hexStr = hexStr\n      .split('')\n      .map(char => char + char)\n      .join('')\n\n  const r = parseInt(hexStr.slice(0, 2), 16)\n  const g = parseInt(hexStr.slice(2, 4), 16)\n  const b = parseInt(hexStr.slice(4, 6), 16)\n\n  return alpha !== undefined ? `rgba(${r}, ${g}, ${b}, ${alpha})` : `rgb(${r}, ${g}, ${b})`\n}\n\nexport function vuiColorToRGBA(color: string, alpha?: number) {\n  if (!color.includes('.')) return 'transparent'\n\n  const [colorName, shade] = color.split('.')\n\n  const x = parseHSL((colors as Record<string, any>)[colorName][shade])\n  return HSLToRGBA(x.h, x.s, x.l, alpha || shade === 'main' ? 1 : parseInt(shade))\n}\n\n/** Converts hsl color value to rgb with optional alpha property. */\nexport function HSLToRGBA(h: number, s: number, l: number, alpha?: number) {\n  s /= 100\n  l /= 100\n\n  const c = (1 - Math.abs(2 * l - 1)) * s,\n    x = c * (1 - Math.abs(((h / 60) % 2) - 1)),\n    m = l - c / 2\n\n  let r = 0,\n    g = 0,\n    b = 0\n\n  if (0 <= h && h < 60) {\n    r = c\n    g = x\n    b = 0\n  } else if (60 <= h && h < 120) {\n    r = x\n    g = c\n    b = 0\n  } else if (120 <= h && h < 180) {\n    r = 0\n    g = c\n    b = x\n  } else if (180 <= h && h < 240) {\n    r = 0\n    g = x\n    b = c\n  } else if (240 <= h && h < 300) {\n    r = x\n    g = 0\n    b = c\n  } else if (300 <= h && h < 360) {\n    r = c\n    g = 0\n    b = x\n  }\n  r = Math.round((r + m) * 255)\n  g = Math.round((g + m) * 255)\n  b = Math.round((b + m) * 255)\n\n  return alpha !== undefined ? `rgba(${r}, ${g}, ${b}, ${alpha})` : `rgb(${r}, ${g}, ${b})`\n}\n\n/** Styling to add ellipsis for long texts. */\nexport const ellipsisOverflow = {\n  overflow: 'hidden',\n  textOverflow: 'ellipsis',\n  whiteSpace: 'nowrap' as Property.WhiteSpace,\n}\n"],"mappings":"8CAKA,SAAgB,EAAG,GAAG,EAAmB,CACvC,OAAO,EAAW,OAAO,QAAQ,CAAC,KAAK,IAAI,CAI7C,SAAgB,EAAS,EAAe,CAEtC,IAAM,EADS,2CACK,OAAO,EAAM,EAAE,QAAQ,EAAE,CAC7C,MAAO,CACL,EAAG,OAAO,IAAM,GAAG,EAAI,EACvB,EAAG,OAAO,IAAM,GAAG,EAAI,EACvB,EAAG,OAAO,IAAM,GAAG,EAAI,EACxB,CAIH,SAAgB,EAAU,EAAa,EAAgB,CACrD,IAAI,EAAS,EAET,EAAO,OAAO,EAAE,GAAK,MAAK,EAAS,EAAO,MAAM,EAAE,EAElD,EAAO,OAAS,IAClB,EAAS,EACN,MAAM,GAAG,CACT,IAAI,GAAQ,EAAO,EAAK,CACxB,KAAK,GAAG,EAEb,IAAM,EAAI,SAAS,EAAO,MAAM,EAAG,EAAE,CAAE,GAAG,CACpC,EAAI,SAAS,EAAO,MAAM,EAAG,EAAE,CAAE,GAAG,CACpC,EAAI,SAAS,EAAO,MAAM,EAAG,EAAE,CAAE,GAAG,CAE1C,OAAO,IAAU,IAAA,GAAiD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAA1D,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAM,GAG/D,SAAgB,EAAe,EAAe,EAAgB,CAC5D,GAAI,CAAC,EAAM,SAAS,IAAI,CAAE,MAAO,cAEjC,GAAM,CAAC,EAAW,GAAS,EAAM,MAAM,IAAI,CAErC,EAAI,EAAUA,EAA+B,GAAW,GAAO,CACrE,OAAO,EAAU,EAAE,EAAG,EAAE,EAAG,EAAE,EAAG,GAAS,IAAU,OAAS,EAAI,SAAS,EAAM,CAAC,CAIlF,SAAgB,EAAU,EAAW,EAAW,EAAW,EAAgB,CACzE,GAAK,IACL,GAAK,IAEL,IAAM,GAAK,EAAI,KAAK,IAAI,EAAI,EAAI,EAAE,EAAI,EACpC,EAAI,GAAK,EAAI,KAAK,IAAM,EAAI,GAAM,EAAK,EAAE,EACzC,EAAI,EAAI,EAAI,EAEV,EAAI,EACN,EAAI,EACJ,EAAI,EA+BN,MA7BI,IAAK,GAAK,EAAI,IAChB,EAAI,EACJ,EAAI,EACJ,EAAI,GACK,IAAM,GAAK,EAAI,KACxB,EAAI,EACJ,EAAI,EACJ,EAAI,GACK,KAAO,GAAK,EAAI,KACzB,EAAI,EACJ,EAAI,EACJ,EAAI,GACK,KAAO,GAAK,EAAI,KACzB,EAAI,EACJ,EAAI,EACJ,EAAI,GACK,KAAO,GAAK,EAAI,KACzB,EAAI,EACJ,EAAI,EACJ,EAAI,GACK,KAAO,GAAK,EAAI,MACzB,EAAI,EACJ,EAAI,EACJ,EAAI,GAEN,EAAI,KAAK,OAAO,EAAI,GAAK,IAAI,CAC7B,EAAI,KAAK,OAAO,EAAI,GAAK,IAAI,CAC7B,EAAI,KAAK,OAAO,EAAI,GAAK,IAAI,CAEtB,IAAU,IAAA,GAAiD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAA1D,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAM,GAI/D,MAAa,EAAmB,CAC9B,SAAU,SACV,aAAc,WACd,WAAY,SACb"}

package/dist/utils/types.d.ts

@@ -0,0 +1,55 @@
+import { ComponentPropsWithRef, ComponentPropsWithoutRef, ElementType } from "react";
+
+//#region src/utils/types.d.ts
+/** Type for a a no-op function stub. */
+type AnyFunction = (...args: any[]) => any;
+/** Type for any number without breaking autocompletion. */
+type AnyNumber = number & {};
+/** Type for any string without breaking autocompletion. */
+type AnyString = string & {};
+/** Type of change event defaulted to input element */
+type ChangeEvent<T = HTMLInputElement> = React.ChangeEvent<T>;
+/** Type of change event handler defaulted to input element */
+type ChangeEventHandler<T = HTMLInputElement> = React.ChangeEventHandler<T>;
+type CreateContextOptions = {
+  /** Message displayed when context is used outside of the provider */
+  errorMessage?: string;
+  /** Accessing context outside of provider won't throw error */
+  isOptional?: boolean;
+  /** Name of the context */
+  name?: string;
+};
+/** Return value of the createContext function. */
+type CreateContextReturn<T> = [React.Provider<T>, () => T];
+/** Basic dictionary typing. */
+type Dict<T = any> = Record<string, T>;
+/** Classic application's environment names. */
+type Environment = 'Prod' | 'Stag' | 'Test';
+/** Type of blur/focus event defaulted to any html element */
+type FocusEvent<T = HTMLElement> = React.FocusEvent<T>;
+/** Type of blur/focus event handler defaulted to any html element */
+type FocusEventHandler<T = HTMLElement> = React.FocusEventHandler<T>;
+/** Type of keyboard event defaulted to any html element */
+type KeyboardEvent<T = HTMLElement> = React.KeyboardEvent<T>;
+/** Type of keyboard event handler defaulted to any html element */
+type KeyboardEventHandler<T = HTMLElement> = React.KeyboardEventHandler<T>;
+/** Type of mouse event defaulted to any html element */
+type MouseEvent<T = HTMLElement> = React.MouseEvent<T>;
+/** Type of mouse event handler defaulted to any html element */
+type MouseEventHandler<T = HTMLElement> = React.MouseEventHandler<T>;
+/** Merges component/element base props and custom props */
+type PropsOf<C extends ElementType, Props = object> = RightJoinProps<ComponentPropsWithoutRef<C>, Props>;
+/** Merges component/element base props and custom props including ref */
+type RefPropsOf<C extends ElementType, Props = object> = RightJoinProps<ComponentPropsWithRef<C>, Props>;
+/** Render props of component's children. */
+type RenderProps<P> = React.ReactNode | ((props: P) => React.ReactNode);
+/** Merges props definitions, overriding source keys */
+type RightJoinProps<SourceProps, OverrideProps> = Omit<SourceProps, keyof OverrideProps> & OverrideProps;
+type SortOrder = 'asc' | 'desc' | null;
+type Sort<T = string> = {
+  key: T;
+  order: SortOrder;
+};
+//#endregion
+export { AnyFunction, AnyNumber, AnyString, ChangeEvent, ChangeEventHandler, CreateContextOptions, CreateContextReturn, Dict, Environment, FocusEvent, FocusEventHandler, KeyboardEvent, KeyboardEventHandler, MouseEvent, MouseEventHandler, PropsOf, RefPropsOf, RenderProps, RightJoinProps, Sort, SortOrder };
+//# sourceMappingURL=types.d.ts.map

package/dist/utils/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/utils/types.ts"],"sourcesContent":[],"mappings":";;;;KAGY,WAAA;AAAZ;AAGY,KAAA,SAAA,GAAS,MAAA,GAAA,CAAA,CAAA;AAGrB;AAGY,KAHA,SAAA,GAGW,MAAA,GAAA,CAAA,CAAA;;AAAK,KAAhB,WAAgB,CAAA,IAAA,gBAAA,CAAA,GAAoB,KAAA,CAAM,WAA1B,CAAsC,CAAtC,CAAA;;AAAoB,KAGpC,kBAH0C,CAAA,IAGnB,gBAHmB,CAAA,GAGC,KAAA,CAAM,kBAHP,CAG0B,CAH1B,CAAA;AAAW,KAKrD,oBAAA,GALqD;EAGrD;EAAkB,YAAA,CAAA,EAAA,MAAA;;YAAkD,CAAA,EAAA,OAAA;;EAAD,IAAA,CAAA,EAAA,MAAA;AAE/E,CAAA;AAUA;AAA+B,KAAnB,mBAAmB,CAAA,CAAA,CAAA,GAAA,CAAO,KAAA,CAAM,QAAb,CAAsB,CAAtB,CAAA,EAAA,GAAA,GAAgC,CAAhC,CAAA;;AAAO,KAG1B,IAHgC,CAAA,IAAA,GAAA,CAAA,GAGhB,MAHgB,CAAA,MAAA,EAGD,CAHC,CAAA;;AAAoB,KAMpD,WAAA,GANoD,MAAA,GAAA,MAAA,GAAA,MAAA;AAGhE;AAAgB,KAMJ,UANI,CAAA,IAMW,WANX,CAAA,GAM0B,KAAA,CAAM,UANhC,CAM2C,CAN3C,CAAA;;AAAY,KAShB,iBATgB,CAAA,IASM,WATN,CAAA,GASqB,KAAA,CAAM,iBAT3B,CAS6C,CAT7C,CAAA;;AAGhB,KASA,aATW,CAAA,IASO,WATP,CAAA,GASsB,KAAA,CAAM,aAT5B,CAS0C,CAT1C,CAAA;AAGvB;AAAsB,KASV,oBATU,CAAA,IASe,WATf,CAAA,GAS8B,KAAA,CAAM,oBATpC,CASyD,CATzD,CAAA;;AAAqC,KAY/C,UAZ+C,CAAA,IAYhC,WAZgC,CAAA,GAYjB,KAAA,CAAM,UAZW,CAYA,CAZA,CAAA;;AAAD,KAe9C,iBAf8C,CAAA,IAexB,WAfwB,CAAA,GAeT,KAAA,CAAM,iBAfG,CAee,CAff,CAAA;AAG1D;AAA6B,KAejB,OAfiB,CAAA,UAeC,WAfD,EAAA,QAAA,MAAA,CAAA,GAegC,cAfhC,CAe+C,wBAf/C,CAewE,CAfxE,CAAA,EAe4E,KAf5E,CAAA;;AAA4C,KAkB7D,UAlB6D,CAAA,UAkBxC,WAlBwC,EAAA,QAAA,MAAA,CAAA,GAkBT,cAlBS,CAkBM,qBAlBN,CAkB4B,CAlB5B,CAAA,EAkBgC,KAlBhC,CAAA;;AAAD,KAqB5D,WArB4D,CAAA,CAAA,CAAA,GAqB3C,KAAA,CAAM,SArBqC,GAAA,CAAA,CAAA,KAAA,EAqBhB,CArBgB,EAAA,GAqBV,KAAA,CAAM,SArBI,CAAA;AAGxE;AAAyB,KAqBb,cArBa,CAAA,WAAA,EAAA,aAAA,CAAA,GAqBgC,IArBhC,CAqBqC,WArBrC,EAAA,MAqBwD,aArBxD,CAAA,GAqByE,aArBzE;AAAK,KAuBlB,SAAA,GAvBkB,KAAA,GAAA,MAAA,GAAA,IAAA;AAAmC,KAyBrD,IAzBqD,CAAA,IAAA,MAAA,CAAA,GAAA;KAApB,EA0BtC,CA1BsC;EAAmB,KAAA,EA2BvD,SA3BuD;AAGhE,CAAA"}

package/dist/utils/uid.d.ts

@@ -0,0 +1,5 @@
+//#region src/utils/uid.d.ts
+declare const uid: (prefix?: string) => string;
+//#endregion
+export { uid };
+//# sourceMappingURL=uid.d.ts.map

package/dist/utils/uid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uid.d.ts","names":[],"sources":["../../src/utils/uid.ts"],"sourcesContent":[],"mappings":";cAAa"}

package/dist/utils/uid.js

@@ -0,0 +1,2 @@
+const e=e=>`${e?`${e}_`:``}${Date.now().toString(36)+Math.random().toString(36).substr(2)}`;export{e as uid};globalThis.__vuiVersion__=`3.0.0-beta.6`;
+//# sourceMappingURL=uid.js.map

package/dist/utils/uid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uid.js","names":[],"sources":["../../src/utils/uid.ts"],"sourcesContent":["export const uid = (prefix?: string) =>\n  `${prefix ? `${prefix}_` : ''}${Date.now().toString(36) + Math.random().toString(36).substr(2)}`\n"],"mappings":"AAAA,MAAa,EAAO,GAClB,GAAG,EAAS,GAAG,EAAO,GAAK,KAAK,KAAK,KAAK,CAAC,SAAS,GAAG,CAAG,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,OAAO,EAAE"}

package/dist/utils/window.d.ts

@@ -0,0 +1,5 @@
+//#region src/utils/window.d.ts
+declare const isActivePath: (path?: string) => boolean;
+//#endregion
+export { isActivePath };
+//# sourceMappingURL=window.d.ts.map

package/dist/utils/window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.d.ts","names":[],"sources":["../../src/utils/window.ts"],"sourcesContent":[],"mappings":";cAAa"}

package/dist/utils/window.js

@@ -0,0 +1,2 @@
+const e=e=>!!e&&window.location.pathname.includes(e);export{e as isActivePath};globalThis.__vuiVersion__=`3.0.0-beta.6`;
+//# sourceMappingURL=window.js.map

package/dist/utils/window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.js","names":[],"sources":["../../src/utils/window.ts"],"sourcesContent":["export const isActivePath = (path?: string): boolean => !!path && window.location.pathname.includes(path)\n"],"mappings":"AAAA,MAAa,EAAgB,GAA2B,CAAC,CAAC,GAAQ,OAAO,SAAS,SAAS,SAAS,EAAK"}

package/package.json

@@ -1,25 +1,29 @@
 {
   "type": "module",
   "name": "@veracity/vui",
-  "version": "3.0.0-beta.5",
+  "version": "3.0.0-beta.6",
   "description": "Veracity UI is a React component library crafted for use within Veracity applications and pages. Based on Styled Components and @xstyled.",
   "exports": {
-    ".": "./dist/index.js",
+    ".": {
+      "development": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
     "./package.json": "./package.json"
   },
   "sideEffects": false,
   "author": "Veracity",
   "license": "SEE LICENSE IN LICENSE.md",
   "scripts": {
-    "clean": "premove .turbo dist node_modules",
     "build": "tsdown",
-    "eslint": "eslint .",
+    "clean": "premove .turbo dist node_modules",
+    "dev": "tsdown --watch",
     "eslint:fix": "eslint . --fix",
+    "eslint": "eslint .",
     "fix": "npm run eslint:fix && npm run prettier",
-    "prettier": "prettier . --write",
-    "lint:package": "publint",
-    "lint:attw": "attw --pack . --profile esm-only",
     "lint": "npm run eslint && npm run tslint",
+    "lint:attw": "attw --pack . --profile esm-only",
+    "lint:package": "publint",
+    "prettier": "prettier . --write",
     "tslint": "tsc --noEmit"
   },
   "dependencies": {
@@ -36,14 +40,14 @@
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.2",
-    "@types/node": "^22.18.0",
+    "@types/node": "^22.18.1",
     "@types/react": "^18.3.24",
     "@types/react-dom": "^18.3.7",
     "@types/react-slider": "^1.3.6",
     "@veracity/eslint-config": "*",
     "@veracity/prettier-config": "*",
     "@veracity/tsconfig": "*",
-    "eslint": "^9.34.0",
+    "eslint": "^9.35.0",
     "eslint-plugin-perfectionist": "^4.15.0",
     "premove": "^4.0.0",
     "prettier": "^3.6.2",
@@ -59,5 +63,11 @@
   ],
   "main": "./dist/index.js",
   "module": "./dist/index.js",
-  "types": "./dist/index.d.ts"
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "exports": {
+      ".": "./dist/index.js",
+      "./package.json": "./package.json"
+    }
+  }
 }

package/dist/chunk-DoKpMbZm.js

@@ -1,12 +0,0 @@
-//#region rolldown:runtime
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-};
-
-//#endregion
-export { __export };
-globalThis.__vuiVersion__ = "3.0.0-beta.5"