@bspk/ui 1.1.34 → 1.3.0

package/dist/types/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;;AA8IH,sDAAsD"}

package/{meta-types.ts → dist/types/meta.d.ts}

@@ -2,21 +2,24 @@
  * This file is used to build the meta types for the project. It's used in the build-meta.ts file and also copied in to
  * the meta output file.
  */
-
+export declare const COMPONENT_PHASE_ORDER: ComponentPhase[];
+export declare const COMPONENT_PHASES: Record<ComponentPhase, {
+    title: string;
+    id: ComponentPhase;
+    description: string;
+}>;
 export type BaseMeta = {
     name: string;
     description?: string;
     file: string;
     example?: string;
 };
-
 export type TypeMeta = BaseMeta & {
     id: string;
     references?: string[];
     properties?: TypeProperty[];
     components?: string[];
 };
-
 export type TypeProperty = {
     name: string;
     description?: string;
@@ -31,7 +34,6 @@ export type TypeProperty = {
     maximum?: number;
     example?: string;
 };
-
 export type ComponentMeta = BaseMeta & {
     slug: string;
     dependencies: string[];
@@ -43,18 +45,9 @@ export type ComponentMeta = BaseMeta & {
     };
     phase: ComponentPhase;
 };
-
 export type UtilityMeta = BaseMeta & {
     param?: string;
     returns?: string;
 };
-
-export type ComponentPhase =
-    | 'AccessibilityReview'
-    | 'Backlog'
-    | 'DesignReview'
-    | 'ProductionReady'
-    | 'Utility'
-    | 'WorkInProgress';
-
+export type ComponentPhase = 'Backlog' | 'Dev' | 'Stable' | 'Utility' | 'UXReview';
 /** Copyright 2025 Anywhere Real Estate - CC BY 4.0 */

package/dist/types/meta.js

@@ -0,0 +1,40 @@
+/**
+ * This file is used to build the meta types for the project. It's used in the build-meta.ts file and also copied in to
+ * the meta output file.
+ */
+export const COMPONENT_PHASE_ORDER = [
+    'Utility', // Utility components are not tracked in the progress
+    'Backlog', // components that are not actively being worked on
+    'Dev', // components that are actively being developed
+    'UXReview', // components that are in UX Review
+    'Stable', // production ready
+];
+export const COMPONENT_PHASES = {
+    Backlog: {
+        title: 'Backlog',
+        id: 'Backlog',
+        description: 'The component has been initiated but is currently on hold. It awaits further development and is not actively being worked on at this time.',
+    },
+    Dev: {
+        title: 'Development',
+        id: 'Dev',
+        description: 'The component is actively under development. This phase includes the creation of visual elements and integration tests to ensure comprehensive functionality.',
+    },
+    UXReview: {
+        title: 'UX Review',
+        id: 'UXReview',
+        description: 'The component is being carefully evaluated by our Bespoke UX team. They are ensuring that it aligns with our high standards of aesthetics and user experience and is accessible to all users.',
+    },
+    Stable: {
+        title: 'Stable',
+        id: 'Stable',
+        description: 'The component has successfully passed all reviews and is ready for use. It is now officially released and ready for use in a production environment.',
+    },
+    Utility: {
+        title: 'Utility',
+        id: 'Utility',
+        description: "The component progress isn't tracked as it's a utility component.",
+    },
+};
+/** Copyright 2025 Anywhere Real Estate - CC BY 4.0 */
+//# sourceMappingURL=meta.js.map

package/dist/types/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/types/meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAqB;IACnD,SAAS,EAAE,qDAAqD;IAChE,SAAS,EAAE,mDAAmD;IAC9D,KAAK,EAAE,+CAA+C;IACtD,UAAU,EAAE,mCAAmC;IAC/C,QAAQ,EAAE,mBAAmB;CAChC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAOzB;IACA,OAAO,EAAE;QACL,KAAK,EAAE,SAAS;QAChB,EAAE,EAAE,SAAS;QACb,WAAW,EACP,4IAA4I;KACnJ;IACD,GAAG,EAAE;QACD,KAAK,EAAE,aAAa;QACpB,EAAE,EAAE,KAAK;QACT,WAAW,EACP,+JAA+J;KACtK;IACD,QAAQ,EAAE;QACN,KAAK,EAAE,WAAW;QAClB,EAAE,EAAE,UAAU;QACd,WAAW,EACP,+LAA+L;KACtM;IACD,MAAM,EAAE;QACJ,KAAK,EAAE,QAAQ;QACf,EAAE,EAAE,QAAQ;QACZ,WAAW,EACP,sJAAsJ;KAC7J;IACD,OAAO,EAAE;QACL,KAAK,EAAE,SAAS;QAChB,EAAE,EAAE,SAAS;QACb,WAAW,EAAE,mEAAmE;KACnF;CACJ,CAAC;AAkDF,sDAAsD"}

package/dist/utils/bound.d.ts

@@ -0,0 +1,18 @@
+/**
+ * A utility function to bound a number within a specified range. Allows for rollover behavior.
+ *
+ * @param params
+ * @param params.num The number to bound, can be a number, string, or undefined
+ * @param params.max The maximum value the number can be
+ * @param params.min The minimum value the number can be
+ * @param params.rollover If true, the number will wrap around when it exceeds the bounds
+ * @param params.defaultValue The default value to return if the input is invalid or undefined
+ * @returns The bounded number
+ */
+export declare function bound({ num, max, min, rollover, defaultValue, }: {
+    num: number | string | undefined;
+    max: number;
+    min: number;
+    rollover?: boolean;
+    defaultValue?: number;
+}): number;

package/dist/utils/bound.js

@@ -0,0 +1,22 @@
+/**
+ * A utility function to bound a number within a specified range. Allows for rollover behavior.
+ *
+ * @param params
+ * @param params.num The number to bound, can be a number, string, or undefined
+ * @param params.max The maximum value the number can be
+ * @param params.min The minimum value the number can be
+ * @param params.rollover If true, the number will wrap around when it exceeds the bounds
+ * @param params.defaultValue The default value to return if the input is invalid or undefined
+ * @returns The bounded number
+ */
+export function bound({ num, max, min, rollover = false, defaultValue = min, }) {
+    const parsedNum = typeof num === 'number' ? num : parseInt(num, 10);
+    if (isNaN(parsedNum))
+        return defaultValue ?? min;
+    if (parsedNum > max)
+        return rollover ? min : max;
+    if (parsedNum < min)
+        return rollover ? max : min;
+    return parsedNum;
+}
+//# sourceMappingURL=bound.js.map

package/dist/utils/bound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bound.js","sourceRoot":"","sources":["../../src/utils/bound.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,KAAK,CAAC,EAClB,GAAG,EACH,GAAG,EACH,GAAG,EACH,QAAQ,GAAG,KAAK,EAChB,YAAY,GAAG,GAAG,GAOrB;IACG,MAAM,SAAS,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAa,EAAE,EAAE,CAAC,CAAC;IAC9E,IAAI,KAAK,CAAC,SAAS,CAAC;QAAE,OAAO,YAAY,IAAI,GAAG,CAAC;IACjD,IAAI,SAAS,GAAG,GAAG;QAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACjD,IAAI,SAAS,GAAG,GAAG;QAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACjD,OAAO,SAAS,CAAC;AACrB,CAAC"}

package/dist/utils/createExampleChildElement.d.ts

@@ -0,0 +1,17 @@
+import { DemoAction, DemoSetState } from './demo';
+type ExampleChildElementProps = {
+    exampleState: Record<string, any>;
+    name: string;
+    setState: DemoSetState;
+    action: DemoAction;
+    id?: string;
+};
+/**
+ * Returns example leading and trailing components for use in component examples. Allows which type of element is
+ * rendered to be determined by the example state.
+ */
+export declare function createExampleChildElement({ exampleState, name, setState, action, id }: ExampleChildElementProps): {
+    element: JSX.Element | null;
+    componentName?: string;
+};
+export {};

package/dist/utils/createExampleChildElement.js

@@ -0,0 +1,50 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/* eslint-disable @typescript-eslint/no-explicit-any */ import { SvgContentCopy } from '@bspk/icons/ContentCopy';
+import { SvgDiamond } from '@bspk/icons/Diamond';
+import { Avatar } from '../components/Avatar';
+import { Checkbox } from '../components/Checkbox';
+import { Img } from '../components/Img';
+import { ListItem } from '../components/ListItem';
+import { Radio } from '../components/Radio';
+import { Switch } from '../components/Switch';
+import { Tag } from '../components/Tag';
+import { Txt } from '../components/Txt';
+/**
+ * Returns example leading and trailing components for use in component examples. Allows which type of element is
+ * rendered to be determined by the example state.
+ */
+export function createExampleChildElement({ exampleState, name, setState, action, id }) {
+    const componentName = exampleState[name];
+    if (componentName === 'Checkbox' || componentName === 'Radio' || componentName === 'Switch') {
+        let As = Checkbox;
+        if (componentName === 'Radio')
+            As = Radio;
+        else if (componentName === 'Switch')
+            As = Switch;
+        const toggleName = `data-${name}-toggle-${id}`;
+        return {
+            element: (_jsx(As, { "aria-label": `${componentName} demo`, checked: exampleState[toggleName], disabled: exampleState.disabled, name: `${name}-toggle`, onChange: (checked) => {
+                    setState({ [toggleName]: checked });
+                }, onClick: () => action(`${name} ${componentName} clicked`), readOnly: exampleState.readOnly, value: `${name}-${componentName}` })),
+            componentName,
+        };
+    }
+    if (componentName === 'ListItemButton')
+        return {
+            element: (_jsx(ListItem.Button, { icon: _jsx(SvgContentCopy, {}), label: "LI Button", onClick: () => action('ListItem button clicked') })),
+            componentName,
+        };
+    if (componentName === 'Img')
+        return { element: _jsx(Img, { alt: "placeholder", src: "/placeholder.svg" }) };
+    if (componentName === 'Avatar')
+        return { element: _jsx(Avatar, { hideTooltip: false, name: "List Item" }) };
+    if (componentName === 'Tag') {
+        return { element: _jsx(Tag, { label: "Tag" }) };
+    }
+    if (componentName === 'Txt')
+        return { element: _jsx(Txt, { children: "Text" }) };
+    if (componentName === 'Icon')
+        return { element: _jsx(SvgDiamond, {}) };
+    return { element: null };
+}
+//# sourceMappingURL=createExampleChildElement.js.map

package/dist/utils/createExampleChildElement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createExampleChildElement.js","sourceRoot":"","sources":["../../src/utils/createExampleChildElement.tsx"],"names":[],"mappings":"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"}

package/dist/utils/demo.d.ts

@@ -1,4 +1,6 @@
-import { AlertVariant } from '../index.js';
+import { CSSProperties, ReactNode } from 'react';
+import { AlertVariant, DataProps } from '-/types/common';
+import { ComponentMeta } from '-/types/meta';
 export type TypeProperty = {
     name: string;
     description?: string;
@@ -15,7 +17,6 @@ export type TypeProperty = {
 };
 export type DemoAction = (message: string, variant?: AlertVariant) => void;
 export type DemoSetState<Props = Record<string, unknown>> = (next: Partial<Props> | ((prev: Props) => Partial<Props>)) => void;
-export type ComponentPhase = 'AccessibilityReview' | 'Backlog' | 'DesignReview' | 'ProductionReady' | 'Utility' | 'WorkInProgress';
 export type TypePropertyDemo = Omit<TypeProperty, 'example'> & {
     libraryDefault?: TypeProperty['default'];
     label?: string;
@@ -32,26 +33,35 @@ export type ComponentExampleRenderProps<Props = Record<string, unknown>> = {
     preset?: DemoPreset;
     setState: DemoSetState<Props>;
     Component: React.ComponentType<Props>;
-    context?: {
-        [key: string]: unknown;
-        preset?: DemoPreset;
+    variant?: {
+        name: string;
+        value: unknown;
     };
     id: string;
 };
 export type ComponentExampleRender<Props = Record<string, unknown>> = (params: ComponentExampleRenderProps<Props>) => React.ReactNode;
-export type ComponentExample<Props = Record<string, unknown>, PropName = keyof Props> = {
+type ComponentVariantOverride<Props> = {
+    [K in keyof Props]?: Props[K] | {
+        options: Props[K][];
+    };
+};
+export type ComponentVariantOverrides<Props = Record<string, unknown>, PropName extends keyof Props = keyof Props> = {
+    [Key in PropName]?: ComponentVariantOverride<Props> | false | ((props: Props) => ComponentVariantOverride<Props>);
+};
+export type ComponentExample<Props = Record<string, unknown>, PropName extends keyof Props = keyof Props> = {
     /**
      * The style of the wrapping component.
      *
-     * //
+     * @example
+     *     { width: '100%' },
      */
     containerStyle?: React.CSSProperties | ((propState: Props) => React.CSSProperties);
     /**
-     * True to hide all or a list of variants to hide.
+     * False to hide all or a record of variants to hide or modify props.
      *
-     * Helpful for hiding variants that can have unexpected collisions with the other examples.
+     * Helpful for hiding or setting static default props for specific variants
      */
-    hideVariants?: PropName[] | true;
+    variants?: ComponentVariantOverrides<Props> | boolean;
     /**
      * This is used to set the initial propState of the component.
      *
@@ -72,22 +82,56 @@ export type ComponentExample<Props = Record<string, unknown>, PropName = keyof P
      * If you only need to update the props of the component, you can use renderProps.
      */
     render?: ComponentExampleRender<Props>;
-    /** We may not want certain props editable in the props table. */
-    disableProps?: PropName[];
+    /**
+     * We may not want certain props editable in the props table.
+     *
+     * Setting this to true will disable all props.
+     *
+     * Or you can pass an array of prop names to disable specific props.
+     */
+    disableProps?: PropName[] | true;
+    /** The sections of the example. */
+    sections?: {
+        title: string;
+        content: (params: {
+            Component: React.ComponentType<Props>;
+            props: Props;
+            CodeExample: CodeExample;
+            Syntax: Syntax;
+        }) => React.ReactNode;
+    }[];
 };
+export type Syntax = (params: {
+    code: string;
+    language?: PrettyParser;
+    style?: CSSProperties;
+    pretty?: boolean;
+}) => React.ReactNode;
+export type CodeExample = (params: DataProps & {
+    containerStyle?: CSSProperties;
+    children: ReactNode;
+    accessibility?: boolean;
+    code?: {
+        language?: PrettyParser | undefined;
+        str: string;
+    };
+}) => React.ReactNode;
+export type PrettyParser = 'css' | 'estree' | 'html' | 'scss' | 'typescript';
 export type ComponentExampleFn<Props = Record<string, unknown>> = (params: {
     setState: DemoSetState<Props>;
     action: DemoAction;
+    componentsMeta: ComponentMeta[];
 }) => ComponentExample<Props>;
+export type OnHandlers = `on${string}`;
 export type Preset<Props> = {
     /** The name of the preset. This is used to display the preset in the UI. */
     label: string;
     /** The props of the component. This is used to set props of the component. These values can't be changed in the UI. */
-    propState?: Partial<Props>;
-    /** Determines if the preset is the default preset. This is used to set the initial propState of the component. */
-    isDefault?: boolean;
+    propState: Omit<Props, OnHandlers> & Record<OnHandlers, unknown>;
+    otherState?: Record<string, Record<string, unknown> | unknown> & Record<string, unknown>;
 };
 export type DemoPreset<P = Record<string, unknown>> = Preset<P> & {
     value: string;
 };
 export declare function createUid(prefix?: string): string;
+export {};

package/dist/utils/demo.js.map

@@ -1 +1 @@
-{"version":3,"file":"demo.js","sourceRoot":"","sources":["../../src/utils/demo.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAsHvD,MAAM,UAAU,SAAS,CAAC,SAAiB,KAAK;IAC5C,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACrE,CAAC"}
+{"version":3,"file":"demo.js","sourceRoot":"","sources":["../../src/utils/demo.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAgKvD,MAAM,UAAU,SAAS,CAAC,SAAiB,KAAK;IAC5C,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACrE,CAAC"}

package/dist/utils/dom.d.ts

@@ -0,0 +1,2 @@
+/** A safe way to get an element by ID that works in SSR environments or when the ID value is not considered valid. */
+export declare function getElementById<T extends HTMLElement = HTMLElement>(id?: string | null): T | null;

package/dist/utils/dom.js

@@ -0,0 +1,9 @@
+/** A safe way to get an element by ID that works in SSR environments or when the ID value is not considered valid. */
+export function getElementById(id) {
+    if (typeof document === 'undefined')
+        return null;
+    if (!id)
+        return null;
+    return document.querySelector(`[id="${id}"]`);
+}
+//# sourceMappingURL=dom.js.map

package/dist/utils/dom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.js","sourceRoot":"","sources":["../../src/utils/dom.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,MAAM,UAAU,cAAc,CAAsC,EAAkB;IAClF,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IACjD,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IACrB,OAAO,QAAQ,CAAC,aAAa,CAAI,QAAQ,EAAE,IAAI,CAAC,CAAC;AACrD,CAAC"}

package/dist/utils/fileUploads.d.ts

@@ -0,0 +1,51 @@
+export declare const DEFAULT_ERROR_MESSAGE = "There was an error uploading the file. Please try again.";
+export type FileUploadStatus = 'complete' | 'error' | 'failed' | 'idle' | 'uploading';
+export type FileEntry = {
+    /**
+     * The unique identifier for the file entry.
+     *
+     * This is generated client-side and should be unique for each file.
+     *
+     * This is useful for tracking the file during upload and handling cancellation.
+     *
+     * @required
+     */
+    id: string;
+    /** The name of the file. */
+    fileName: string;
+    /**
+     * The status of the uploading file.
+     *
+     * @default idle
+     */
+    status?: FileUploadStatus;
+    /**
+     * The size of the file being uploaded in MB.
+     *
+     * @required
+     */
+    fileSize: number;
+    /**
+     * A number between 0 and 100 representing the percentage of the upload completed.
+     *
+     * @default 0
+     * @minimum 0
+     * @maximum 100
+     */
+    progress?: number;
+    /**
+     * The error message to display when the upload fails.
+     *
+     * If status is 'error', this message will be displayed by default: "There was an error uploading the file. Please
+     * try again."
+     */
+    errorMessage?: string;
+};
+/**
+ * Common MIME types
+ *
+ * This list includes commonly used MIME types for various file formats.
+ *
+ * This is not an exhaustive list, but it covers many of the most frequently used types and can be extended as needed.
+ */
+export type MimeType = 'application/json' | 'application/octet-stream' | 'application/pdf' | 'application/x-www-form-urlencoded' | 'application/xml' | 'application/zip' | 'audio/mpeg' | 'audio/wav' | 'image/gif' | 'image/jpeg' | 'image/png' | 'image/svg+xml' | 'image/webp' | 'text/css' | 'text/html' | 'text/javascript' | 'text/plain' | 'video/mp4' | 'video/webm';

package/dist/utils/fileUploads.js

@@ -0,0 +1,2 @@
+export const DEFAULT_ERROR_MESSAGE = 'There was an error uploading the file. Please try again.';
+//# sourceMappingURL=fileUploads.js.map

package/dist/utils/fileUploads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileUploads.js","sourceRoot":"","sources":["../../src/utils/fileUploads.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,0DAA0D,CAAC"}

package/dist/utils/handleKeyDown.d.ts

@@ -0,0 +1,13 @@
+import { KeyboardEvent } from 'react';
+import { KeyboardEventCode } from './keyboard';
+export type KeysCallback = Partial<Record<KeyboardEventCode, ((event: KeyboardEvent) => void) | null>>;
+/**
+ * Handles multiple keydown events with specific callbacks for each key.
+ *
+ * @param keysCallback - An object where keys are keyboard event codes and values are callback functions.
+ * @returns A function that can be used as an event handler for keydown events.
+ */
+export declare function handleKeyDown(keysCallback?: KeysCallback, { stopPropagation, preventDefault }?: {
+    stopPropagation?: boolean;
+    preventDefault?: boolean;
+}): (event: KeyboardEvent) => KeyboardEventCode | null;

package/dist/utils/handleKeyDown.js

@@ -0,0 +1,23 @@
+/**
+ * Handles multiple keydown events with specific callbacks for each key.
+ *
+ * @param keysCallback - An object where keys are keyboard event codes and values are callback functions.
+ * @returns A function that can be used as an event handler for keydown events.
+ */
+export function handleKeyDown(keysCallback = {}, { stopPropagation = false, preventDefault = false } = {}) {
+    return (event) => {
+        let eventCode = event.code;
+        if (event.ctrlKey && event.altKey && event.code === 'Space')
+            eventCode = 'Ctrl+Option+Space';
+        const callback = keysCallback[eventCode];
+        if (callback) {
+            callback(event);
+            if (stopPropagation)
+                event.stopPropagation();
+            if (preventDefault)
+                event.preventDefault();
+        }
+        return callback ? eventCode : null;
+    };
+}
+//# sourceMappingURL=handleKeyDown.js.map

package/dist/utils/handleKeyDown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleKeyDown.js","sourceRoot":"","sources":["../../src/utils/handleKeyDown.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CACzB,eAA6B,EAAE,EAC/B,EAAE,eAAe,GAAG,KAAK,EAAE,cAAc,GAAG,KAAK,KAA8D,EAAE;IAEjH,OAAO,CAAC,KAAoB,EAAE,EAAE;QAC5B,IAAI,SAAS,GAAG,KAAK,CAAC,IAAyB,CAAC;QAChD,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;YAAE,SAAS,GAAG,mBAAmB,CAAC;QAE7F,MAAM,QAAQ,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;QAEzC,IAAI,QAAQ,EAAE,CAAC;YACX,QAAQ,CAAC,KAAK,CAAC,CAAC;YAChB,IAAI,eAAe;gBAAE,KAAK,CAAC,eAAe,EAAE,CAAC;YAC7C,IAAI,cAAc;gBAAE,KAAK,CAAC,cAAc,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC,CAAC;AACN,CAAC"}

package/dist/utils/keyboard.d.ts

@@ -1,4 +1,5 @@
 export type KeyboardEventKey = ' ' | '_' | '-' | ';' | ':' | '!' | '?' | '.' | '' | '"' | '(' | ')' | '[' | ']' | '{' | '}' | '@' | '*' | '/' | '\\' | '&' | '#' | '%' | '`' | '^' | '+' | '<' | '=' | '>' | '|' | '~' | '$' | '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | 'A' | 'a' | 'Alt' | 'ArrowDown' | 'ArrowLeft' | 'ArrowRight' | 'ArrowUp' | 'AudioVolumeDown' | 'AudioVolumeMute' | 'AudioVolumeUp' | 'B' | 'b' | 'Backspace' | 'C' | 'c' | 'CapsLock' | 'ContextMenu' | 'Control' | 'D' | 'd' | 'Delete' | 'E' | 'e' | 'End' | 'Enter' | 'Escape' | 'F' | 'f' | 'F1' | 'F2' | 'F3' | 'F4' | 'F5' | 'F6' | 'F7' | 'F8' | 'F9' | 'F10' | 'F11' | 'F12' | 'G' | 'g' | 'H' | 'h' | 'Home' | 'I' | 'i' | 'Insert' | 'J' | 'j' | 'K' | 'k' | 'L' | 'l' | 'M' | 'm' | 'Meta' | 'N' | 'n' | 'NumLock' | 'O' | 'o' | 'P' | 'p' | 'PageDown' | 'PageUp' | 'Pause' | 'PrintScreen' | 'Q' | 'q' | 'R' | 'r' | 'S' | 's' | 'ScrollLock' | 'Shift' | 'T' | 't' | 'Tab' | 'U' | 'u' | 'V' | 'v' | 'W' | 'w' | 'X' | 'x' | 'Y' | 'y' | 'Z' | 'z' | "'";
-export type KeyboardEventCode = 'AltLeft' | 'AltRight' | 'ArrowDown' | 'ArrowLeft' | 'ArrowRight' | 'ArrowUp' | 'AudioVolumeDown' | 'AudioVolumeMute' | 'AudioVolumeUp' | 'Backquote' | 'Backslash' | 'Backspace' | 'BracketLeft' | 'BracketRight' | 'CapsLock' | 'Comma' | 'ContextMenu' | 'ControlLeft' | 'ControlRight' | 'Delete' | 'Digit0' | 'Digit1' | 'Digit2' | 'Digit3' | 'Digit4' | 'Digit5' | 'Digit6' | 'Digit7' | 'Digit8' | 'Digit9' | 'End' | 'Enter' | 'Equal' | 'Escape' | 'F1' | 'F2' | 'F3' | 'F4' | 'F5' | 'F6' | 'F7' | 'F8' | 'F9' | 'F10' | 'F11' | 'F12' | 'Home' | 'Insert' | 'KeyA' | 'KeyB' | 'KeyC' | 'KeyD' | 'KeyE' | 'KeyF' | 'KeyG' | 'KeyH' | 'KeyI' | 'KeyJ' | 'KeyK' | 'KeyL' | 'KeyM' | 'KeyN' | 'KeyO' | 'KeyP' | 'KeyQ' | 'KeyR' | 'KeyS' | 'KeyT' | 'KeyU' | 'KeyV' | 'KeyW' | 'KeyX' | 'KeyY' | 'KeyZ' | 'MetaLeft' | 'MetaRight' | 'Minus' | 'NumLock' | 'Numpad0' | 'Numpad1' | 'Numpad2' | 'Numpad3' | 'Numpad4' | 'Numpad5' | 'Numpad6' | 'Numpad7' | 'Numpad8' | 'Numpad9' | 'NumpadAdd' | 'NumpadDecimal' | 'NumpadDivide' | 'NumpadMultiply' | 'NumpadSubtract' | 'PageDown' | 'PageUp' | 'Pause' | 'Period' | 'PrintScreen' | 'Quote' | 'ScrollLock' | 'Semicolon' | 'ShiftLeft' | 'ShiftRight' | 'Slash' | 'Space' | 'Tab';
+export type KeyboardEventCodeCustom = 'Ctrl+Option+Space';
+export type KeyboardEventCode = KeyboardEventCodeCustom | 'AltLeft' | 'AltRight' | 'ArrowDown' | 'ArrowLeft' | 'ArrowRight' | 'ArrowUp' | 'AudioVolumeDown' | 'AudioVolumeMute' | 'AudioVolumeUp' | 'Backquote' | 'Backslash' | 'Backspace' | 'BracketLeft' | 'BracketRight' | 'CapsLock' | 'Comma' | 'ContextMenu' | 'ControlLeft' | 'ControlRight' | 'Delete' | 'Digit0' | 'Digit1' | 'Digit2' | 'Digit3' | 'Digit4' | 'Digit5' | 'Digit6' | 'Digit7' | 'Digit8' | 'Digit9' | 'End' | 'Enter' | 'Equal' | 'Escape' | 'F1' | 'F2' | 'F3' | 'F4' | 'F5' | 'F6' | 'F7' | 'F8' | 'F9' | 'F10' | 'F11' | 'F12' | 'Home' | 'Insert' | 'KeyA' | 'KeyB' | 'KeyC' | 'KeyD' | 'KeyE' | 'KeyF' | 'KeyG' | 'KeyH' | 'KeyI' | 'KeyJ' | 'KeyK' | 'KeyL' | 'KeyM' | 'KeyN' | 'KeyO' | 'KeyP' | 'KeyQ' | 'KeyR' | 'KeyS' | 'KeyT' | 'KeyU' | 'KeyV' | 'KeyW' | 'KeyX' | 'KeyY' | 'KeyZ' | 'MetaLeft' | 'MetaRight' | 'Minus' | 'NumLock' | 'Numpad0' | 'Numpad1' | 'Numpad2' | 'Numpad3' | 'Numpad4' | 'Numpad5' | 'Numpad6' | 'Numpad7' | 'Numpad8' | 'Numpad9' | 'NumpadAdd' | 'NumpadDecimal' | 'NumpadDivide' | 'NumpadMultiply' | 'NumpadSubtract' | 'PageDown' | 'PageUp' | 'Pause' | 'Period' | 'PrintScreen' | 'Quote' | 'ScrollLock' | 'Semicolon' | 'ShiftLeft' | 'ShiftRight' | 'Slash' | 'Space' | 'Tab';
 export declare const EVENT_KEY: Record<KeyboardEventKey, KeyboardEventKey>;
 /** Copyright 2025 Anywhere Real Estate - CC BY 4.0 */

package/dist/utils/keyboard.js

@@ -1,4 +1,4 @@
-export const EVENT_KEY = Object.freeze({
+export const EVENT_KEY = {
     Backspace: 'Backspace',
     Tab: 'Tab',
     Enter: 'Enter',
@@ -133,6 +133,6 @@ export const EVENT_KEY = Object.freeze({
     '<': '<',
     '>': '>',
     '?': '?',
-});
+};
 /** Copyright 2025 Anywhere Real Estate - CC BY 4.0 */
 //# sourceMappingURL=keyboard.js.map

package/dist/utils/keyboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"keyboard.js","sourceRoot":"","sources":["../../src/utils/keyboard.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"keyboard.js","sourceRoot":"","sources":["../../src/utils/keyboard.ts"],"names":[],"mappings":"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"}

package/dist/utils/random.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Returns a random integer between min and max (inclusive).
+ *
+ * @param min - The minimum value (inclusive).
+ * @param max - The maximum value (inclusive).
+ * @returns A random integer between min and max.
+ */
+export declare function randomNumber(min?: number, max?: number): number;
+/**
+ * Returns a random string of alphanumeric characters.
+ *
+ * @param length - The length of the random ID to generate.
+ * @returns A random string of the specified length containing alphanumeric characters.
+ */
+export declare function randomString(length?: number): string;

package/dist/utils/random.js

@@ -0,0 +1,26 @@
+/**
+ * Returns a random integer between min and max (inclusive).
+ *
+ * @param min - The minimum value (inclusive).
+ * @param max - The maximum value (inclusive).
+ * @returns A random integer between min and max.
+ */
+export function randomNumber(min = 0, max = 100) {
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+/**
+ * Returns a random string of alphanumeric characters.
+ *
+ * @param length - The length of the random ID to generate.
+ * @returns A random string of the specified length containing alphanumeric characters.
+ */
+export function randomString(length = 8) {
+    const chars = 'abcdefghijklmnopqrstuvwxyz0123456789';
+    let result = '';
+    const rand = new Uint32Array(length);
+    window.crypto.getRandomValues(rand);
+    for (let i = 0; i < length; i++)
+        result += chars[rand[i] % chars.length];
+    return result;
+}
+//# sourceMappingURL=random.js.map

package/dist/utils/random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.js","sourceRoot":"","sources":["../../src/utils/random.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,GAAG;IAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AAC7D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB,CAAC;IAC3C,MAAM,KAAK,GAAG,sCAAsC,CAAC;IACrD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/utils/scrollElementIntoView.d.ts

@@ -4,5 +4,5 @@
  * @param element -- The element to scroll into view.
  * @param container -- The container to scroll.
  */
-export declare function scrollElementIntoView(element: HTMLElement, container: HTMLElement): void;
+export declare function scrollElementIntoView(element?: Element | null, container?: Element | null): void;
 /** Copyright 2025 Anywhere Real Estate - CC BY 4.0 */

package/dist/utils/scrollElementIntoView.js

@@ -5,6 +5,8 @@
  * @param container -- The container to scroll.
  */
 export function scrollElementIntoView(element, container) {
+    if (!element || !container)
+        return;
     const elementRect = element.getBoundingClientRect();
     const containerRect = container.getBoundingClientRect();
     if (elementRect.top < containerRect.top) {

package/dist/utils/scrollElementIntoView.js.map

@@ -1 +1 @@
-{"version":3,"file":"scrollElementIntoView.js","sourceRoot":"","sources":["../../src/utils/scrollElementIntoView.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAoB,EAAE,SAAsB;IAC9E,MAAM,WAAW,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAEpD,MAAM,aAAa,GAAG,SAAS,CAAC,qBAAqB,EAAE,CAAC;IAExD,IAAI,WAAW,CAAC,GAAG,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC;QACtC,oCAAoC;QACpC,SAAS,CAAC,SAAS,IAAI,aAAa,CAAC,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC;IAC/D,CAAC;SAAM,IAAI,WAAW,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC;QACnD,oCAAoC;QACpC,SAAS,CAAC,SAAS,IAAI,WAAW,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;IACrE,CAAC;IAED,IAAI,WAAW,CAAC,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;QACxC,6CAA6C;QAC7C,SAAS,CAAC,UAAU,IAAI,aAAa,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;IAClE,CAAC;SAAM,IAAI,WAAW,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,EAAE,CAAC;QACjD,8CAA8C;QAC9C,SAAS,CAAC,UAAU,IAAI,WAAW,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;IACpE,CAAC;AACL,CAAC;AAED,sDAAsD"}
+{"version":3,"file":"scrollElementIntoView.js","sourceRoot":"","sources":["../../src/utils/scrollElementIntoView.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAwB,EAAE,SAA0B;IACtF,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS;QAAE,OAAO;IAEnC,MAAM,WAAW,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAEpD,MAAM,aAAa,GAAG,SAAS,CAAC,qBAAqB,EAAE,CAAC;IAExD,IAAI,WAAW,CAAC,GAAG,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC;QACtC,oCAAoC;QACpC,SAAS,CAAC,SAAS,IAAI,aAAa,CAAC,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC;IAC/D,CAAC;SAAM,IAAI,WAAW,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC;QACnD,oCAAoC;QACpC,SAAS,CAAC,SAAS,IAAI,WAAW,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;IACrE,CAAC;IAED,IAAI,WAAW,CAAC,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;QACxC,6CAA6C;QAC7C,SAAS,CAAC,UAAU,IAAI,aAAa,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;IAClE,CAAC;SAAM,IAAI,WAAW,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,EAAE,CAAC;QACjD,8CAA8C;QAC9C,SAAS,CAAC,UAAU,IAAI,WAAW,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;IACpE,CAAC;AACL,CAAC;AAED,sDAAsD"}

package/dist/utils/scrollListItemsStyle.d.ts

@@ -0,0 +1,10 @@
+import { CSSProperties } from 'react';
+export type ScrollListItemsStyleProps = {
+    /**
+     * The maximum number of ListItems to show before scrolling is enabled.
+     *
+     * Used in conjunction with scrollListItemsStyle utility.
+     */
+    scrollLimit?: number;
+};
+export declare function scrollListItemsStyle(scrollLimitProp: unknown, itemCount: unknown): CSSProperties;

package/dist/utils/scrollListItemsStyle.js

@@ -0,0 +1,17 @@
+export function scrollListItemsStyle(scrollLimitProp, itemCount) {
+    const scrollLimit = Number(scrollLimitProp);
+    // Check:
+    // 1. scrollLimit is valid
+    // 2. itemCount is a number
+    // 3. scrollLimit is less than itemCount
+    // If any of these fail, return undefined (no scrolling)
+    if (Number.isNaN(scrollLimit) || scrollLimit <= 0 || typeof itemCount !== 'number' || scrollLimit > itemCount)
+        return {};
+    return {
+        display: 'flex',
+        flexDirection: 'column',
+        maxHeight: `calc(var(--list-item-height) * ${scrollLimit})`,
+        overflow: 'hidden auto',
+    };
+}
+//# sourceMappingURL=scrollListItemsStyle.js.map

package/dist/utils/scrollListItemsStyle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrollListItemsStyle.js","sourceRoot":"","sources":["../../src/utils/scrollListItemsStyle.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,oBAAoB,CAAC,eAAwB,EAAE,SAAkB;IAC7E,MAAM,WAAW,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;IAE5C,SAAS;IACT,0BAA0B;IAC1B,2BAA2B;IAC3B,wCAAwC;IACxC,wDAAwD;IACxD,IAAI,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,WAAW,IAAI,CAAC,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,WAAW,GAAG,SAAS;QACzG,OAAO,EAAE,CAAC;IAEd,OAAO;QACH,OAAO,EAAE,MAAM;QACf,aAAa,EAAE,QAAQ;QACvB,SAAS,EAAE,kCAAkC,WAAW,GAAG;QAC3D,QAAQ,EAAE,aAAa;KAC1B,CAAC;AACN,CAAC"}