@dashforge/tw 0.1.0-beta

package/dist/src/components/LeftNav/leftNav.types.d.ts

@@ -0,0 +1,136 @@
+import type { ReactNode, ComponentType, AnchorHTMLAttributes, Ref } from 'react';
+import type { AccessRequirement } from '@dashforge/rbac';
+import type { LeftNavVariants } from './leftNav.variants.js';
+/**
+ * One row in the LeftNav. May be either a clickable item OR a group
+ * (a header that owns nested children, optionally collapsible).
+ */
+export type LeftNavNode = LeftNavItem | LeftNavGroup;
+export interface LeftNavItem {
+    kind?: 'item';
+    /** Stable id used for `activeId` matching + React keys. */
+    id: string;
+    label: ReactNode;
+    icon?: ReactNode;
+    /**
+     * Destination for navigation. Omit for a pure-callback item (use
+     * `onSelect`).
+     */
+    href?: string;
+    /** Fired when the row is clicked (in addition to navigation). */
+    onSelect?: () => void;
+    /** Optional pill / counter rendered to the right of the label. */
+    badge?: ReactNode;
+    /** Per-item disabled flag. */
+    disabled?: boolean;
+    /** RBAC access requirement — hides / disables the row. */
+    access?: AccessRequirement;
+}
+export interface LeftNavGroup {
+    kind: 'group';
+    id: string;
+    label: ReactNode;
+    icon?: ReactNode;
+    children: LeftNavItem[];
+    /**
+     * Initial expanded state when used in uncontrolled mode. Default
+     * `true` (groups open by default — most app navs want immediate
+     * visibility).
+     */
+    defaultExpanded?: boolean;
+    /** Controlled expanded state. Provide `onExpandedChange` to update. */
+    expanded?: boolean;
+    /** RBAC access requirement — hides / disables the whole group. */
+    access?: AccessRequirement;
+}
+/**
+ * Polymorphic link component prop. Defaults to `<a>`. Pass a
+ * router-aware component (react-router `Link`, Next `Link`) for SPA
+ * navigation.
+ */
+export type LeftNavLinkComponent = ComponentType<AnchorHTMLAttributes<HTMLAnchorElement> & {
+    ref?: Ref<HTMLAnchorElement>;
+}>;
+export interface LeftNavSlotProps {
+    root?: {
+        className?: string;
+    };
+    brand?: {
+        className?: string;
+    };
+    list?: {
+        className?: string;
+    };
+    item?: {
+        className?: string;
+    };
+    itemLink?: {
+        className?: string;
+    };
+    itemActive?: {
+        className?: string;
+    };
+    itemIcon?: {
+        className?: string;
+    };
+    itemLabel?: {
+        className?: string;
+    };
+    itemBadge?: {
+        className?: string;
+    };
+    group?: {
+        className?: string;
+    };
+    groupHeader?: {
+        className?: string;
+    };
+    groupChildren?: {
+        className?: string;
+    };
+    footer?: {
+        className?: string;
+    };
+    collapseToggle?: {
+        className?: string;
+    };
+}
+/**
+ * Props for `<LeftNav>`.
+ *
+ * Router-agnostic sidebar navigation. The consumer drives the active
+ * item via `activeId` (typically derived from the current route).
+ *
+ * Rail / drawer responsive behaviour is handled by `<AppShell>`; this
+ * component renders the actual nav content and exposes a `collapsed`
+ * prop for the icon-only "rail" rendering.
+ */
+export interface LeftNavProps extends LeftNavVariants {
+    items: LeftNavNode[];
+    /** Currently-active item id (highlight + `aria-current="page"`). */
+    activeId?: string;
+    /**
+     * Icon-only rail mode. When `true`, labels and group children are
+     * visually hidden (kept for screen readers via `sr-only`).
+     */
+    collapsed?: boolean;
+    /** Fired when the user clicks the collapse-toggle button. */
+    onCollapseChange?: (collapsed: boolean) => void;
+    /** Fired when a group's expanded state changes (controlled or not). */
+    onGroupExpandedChange?: (groupId: string, expanded: boolean) => void;
+    /** Brand / logo node rendered at the top. */
+    brand?: ReactNode;
+    /** Footer node (e.g., user badge). */
+    footer?: ReactNode;
+    /** Override the link component. @default 'a' */
+    linkComponent?: LeftNavLinkComponent;
+    /** Visible label of the nav landmark. @default 'Main navigation' */
+    ariaLabel?: string;
+    /** Root className shortcut. */
+    sx?: string;
+    /** Per-slot className overrides. */
+    slotProps?: LeftNavSlotProps;
+    /** Show / hide the collapse toggle button. @default true */
+    showCollapseToggle?: boolean;
+}
+//# sourceMappingURL=leftNav.types.d.ts.map

package/dist/src/components/LeftNav/leftNav.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leftNav.types.d.ts","sourceRoot":"","sources":["../../../../src/components/LeftNav/leftNav.types.ts"],"names":[],"mappings":"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"}

package/dist/src/components/LeftNav/leftNav.variants.d.ts

@@ -0,0 +1,143 @@
+import { type VariantProps } from 'tailwind-variants';
+/**
+ * Tailwind-variants recipe for `<LeftNav>`.
+ *
+ * Slots:
+ *   - `root`           — `<nav>` landmark
+ *   - `brand`          — top brand/logo wrapper
+ *   - `list`           — `<ul>` containing items & groups
+ *   - `item`           — `<li>` wrapper
+ *   - `itemLink`       — clickable row (`<a>` or `<button>`)
+ *   - `itemActive`     — active state on the row
+ *   - `itemIcon`       — icon slot inside a row
+ *   - `itemLabel`      — text label slot
+ *   - `itemBadge`      — right-aligned pill
+ *   - `group`          — wrapper around a group header + children
+ *   - `groupHeader`    — clickable header row (`<button>`)
+ *   - `groupChildren`  — `<ul>` containing the group's items
+ *   - `footer`         — bottom slot (user badge, etc.)
+ *   - `collapseToggle` — rail-mode toggle button
+ */
+export declare const leftNavVariants: import("tailwind-variants").TVReturnType<{
+    width: {
+        sm: {
+            root: string;
+        };
+        md: {
+            root: string;
+        };
+        lg: {
+            root: string;
+        };
+    };
+    collapsed: {
+        true: {
+            root: string;
+            brand: string;
+            list: string;
+            itemLink: string;
+            itemLabel: string;
+            itemBadge: string;
+            groupHeader: string;
+            groupChildren: string;
+            footer: string;
+        };
+    };
+}, {
+    root: string[];
+    brand: string[];
+    list: string;
+    item: string;
+    itemLink: string[];
+    itemActive: string;
+    itemIcon: string;
+    itemLabel: string;
+    itemBadge: string[];
+    group: string;
+    groupHeader: string[];
+    groupChildren: string;
+    footer: string[];
+    collapseToggle: string[];
+}, undefined, {
+    width: {
+        sm: {
+            root: string;
+        };
+        md: {
+            root: string;
+        };
+        lg: {
+            root: string;
+        };
+    };
+    collapsed: {
+        true: {
+            root: string;
+            brand: string;
+            list: string;
+            itemLink: string;
+            itemLabel: string;
+            itemBadge: string;
+            groupHeader: string;
+            groupChildren: string;
+            footer: string;
+        };
+    };
+}, {
+    root: string[];
+    brand: string[];
+    list: string;
+    item: string;
+    itemLink: string[];
+    itemActive: string;
+    itemIcon: string;
+    itemLabel: string;
+    itemBadge: string[];
+    group: string;
+    groupHeader: string[];
+    groupChildren: string;
+    footer: string[];
+    collapseToggle: string[];
+}, import("tailwind-variants").TVReturnType<{
+    width: {
+        sm: {
+            root: string;
+        };
+        md: {
+            root: string;
+        };
+        lg: {
+            root: string;
+        };
+    };
+    collapsed: {
+        true: {
+            root: string;
+            brand: string;
+            list: string;
+            itemLink: string;
+            itemLabel: string;
+            itemBadge: string;
+            groupHeader: string;
+            groupChildren: string;
+            footer: string;
+        };
+    };
+}, {
+    root: string[];
+    brand: string[];
+    list: string;
+    item: string;
+    itemLink: string[];
+    itemActive: string;
+    itemIcon: string;
+    itemLabel: string;
+    itemBadge: string[];
+    group: string;
+    groupHeader: string[];
+    groupChildren: string;
+    footer: string[];
+    collapseToggle: string[];
+}, undefined, unknown, unknown, undefined>>;
+export type LeftNavVariants = VariantProps<typeof leftNavVariants>;
+//# sourceMappingURL=leftNav.variants.d.ts.map

package/dist/src/components/LeftNav/leftNav.variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leftNav.variants.d.ts","sourceRoot":"","sources":["../../../../src/components/LeftNav/leftNav.variants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAwE1B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/src/components/NumberField/NumberField.d.ts

@@ -0,0 +1,18 @@
+import type { NumberFieldProps } from './numberField.types.js';
+/**
+ * Dashforge TW NumberField — bridge-integrated numeric input.
+ *
+ * Mirrors `@dashforge/ui/NumberField` semantics: storage type is
+ * `number | null`, NaN is never written, `Number.isFinite` is the guard.
+ * Renders a native `<input type="number">` with an OPTIONAL +/− stepper
+ * (opt-in via `showStepper`). The native browser spinner is suppressed
+ * in CSS so visual consistency is preserved cross-browser.
+ *
+ * **A11y**:
+ *  - `aria-invalid` from resolved validation state
+ *  - `aria-describedby` links the input to the helper/error text
+ *  - `min` / `max` / `step` forwarded to the native input (which exposes
+ *    `aria-valuemin` / `aria-valuemax` automatically)
+ */
+export declare function NumberField(props: NumberFieldProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=NumberField.d.ts.map

package/dist/src/components/NumberField/NumberField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumberField.d.ts","sourceRoot":"","sources":["../../../../src/components/NumberField/NumberField.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAuC/D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,kDAsOlD"}

package/dist/src/components/NumberField/numberField.types.d.ts

@@ -0,0 +1,79 @@
+import type { ChangeEventHandler, FocusEventHandler, InputHTMLAttributes, ReactNode } from 'react';
+import type { Engine } from '@dashforge/ui-core';
+import type { AccessRequirement } from '@dashforge/rbac';
+import type { NumberFieldVariants } from './numberField.variants.js';
+export interface NumberFieldSlotProps {
+    root?: {
+        className?: string;
+    };
+    label?: {
+        className?: string;
+    };
+    requiredMark?: {
+        className?: string;
+    };
+    inputWrapper?: {
+        className?: string;
+    };
+    input?: {
+        className?: string;
+    };
+    stepper?: {
+        className?: string;
+    };
+    stepperButton?: {
+        className?: string;
+    };
+    helperText?: {
+        className?: string;
+    };
+    errorText?: {
+        className?: string;
+    };
+}
+/**
+ * Props for `<NumberField>`.
+ *
+ * Value contract (mirrors `@dashforge/ui/NumberField`):
+ *  - Bridge storage type: `number | null` (NEVER `NaN`).
+ *  - UI display: `number → String(number)`, `null/undefined → ""`.
+ *  - On user input:
+ *      - empty string → `setValue(name, null)`
+ *      - parseable number → `setValue(name, parsed)`
+ *      - non-numeric input → no bridge write (UI string is kept as-is for UX,
+ *        but the bridge stays at the last valid value)
+ *  - Parsing uses `Number(...)` + `Number.isFinite(...)`. No locale parsing.
+ */
+export interface NumberFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'name' | 'type' | 'size' | 'onChange' | 'onBlur' | 'value' | 'defaultValue'>, NumberFieldVariants {
+    name: string;
+    rules?: unknown;
+    label?: ReactNode;
+    helperText?: ReactNode;
+    required?: boolean;
+    error?: boolean;
+    disabled?: boolean;
+    /** Engine predicate — field not rendered when it returns `false`. */
+    visibleWhen?: (engine: Engine) => boolean;
+    /** RBAC access requirement (combines with explicit `disabled`). */
+    access?: AccessRequirement;
+    /** Root className shortcut (`cn`'d with the variant root class). */
+    sx?: string;
+    /** Per-slot className overrides. */
+    slotProps?: NumberFieldSlotProps;
+    /** Controlled value (form mode reads from the bridge if omitted). */
+    value?: number | string | null;
+    /** Default value (uncontrolled, standalone mode only). */
+    defaultValue?: number | string | null;
+    /** Min allowed value (passed to the input + clamps stepper). */
+    min?: number;
+    /** Max allowed value (passed to the input + clamps stepper). */
+    max?: number;
+    /** Stepper step size. Default 1. */
+    step?: number;
+    /** Show inline +/− stepper buttons inside the input wrapper. Default false. */
+    showStepper?: boolean;
+    /** Change handler — receives the native event; consume value via bridge. */
+    onChange?: ChangeEventHandler<HTMLInputElement>;
+    onBlur?: FocusEventHandler<HTMLInputElement>;
+}
+//# sourceMappingURL=numberField.types.d.ts.map

package/dist/src/components/NumberField/numberField.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numberField.types.d.ts","sourceRoot":"","sources":["../../../../src/components/NumberField/numberField.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,SAAS,EACV,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,YAAY,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,YAAY,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,aAAa,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,gBACf,SAAQ,IAAI,CACR,mBAAmB,CAAC,gBAAgB,CAAC,EACrC,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,cAAc,CAC5E,EACD,mBAAmB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,mEAAmE;IACnE,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,oEAAoE;IACpE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/B,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACtC,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;IAChD,MAAM,CAAC,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;CAC9C"}

package/dist/src/components/NumberField/numberField.variants.d.ts

@@ -0,0 +1,169 @@
+import { type VariantProps } from 'tailwind-variants';
+/**
+ * Tailwind-variants recipe for `<NumberField>`.
+ *
+ * Same 7-slot taxonomy as `<TextField>` for visual/override parity, plus
+ * a dedicated `stepper` slot for the optional +/- increment buttons.
+ */
+export declare const numberFieldVariants: import("tailwind-variants").TVReturnType<{
+    size: {
+        sm: {
+            inputWrapper: string;
+            input: string;
+            stepperButton: string;
+        };
+        md: {
+            inputWrapper: string;
+            input: string;
+            stepperButton: string;
+        };
+        lg: {
+            inputWrapper: string;
+            input: string;
+            stepperButton: string;
+        };
+    };
+    layout: {
+        stacked: {
+            root: string;
+        };
+        inline: {
+            root: string;
+            label: string;
+        };
+    };
+    error: {
+        true: {
+            inputWrapper: string;
+        };
+    };
+    fullWidth: {
+        true: {
+            root: string;
+            inputWrapper: string;
+        };
+    };
+    disabled: {
+        true: {
+            inputWrapper: string;
+        };
+    };
+}, {
+    root: string;
+    label: string;
+    requiredMark: string;
+    inputWrapper: string[];
+    input: string[];
+    stepper: string[];
+    stepperButton: string[];
+    helperText: string;
+    errorText: string;
+}, undefined, {
+    size: {
+        sm: {
+            inputWrapper: string;
+            input: string;
+            stepperButton: string;
+        };
+        md: {
+            inputWrapper: string;
+            input: string;
+            stepperButton: string;
+        };
+        lg: {
+            inputWrapper: string;
+            input: string;
+            stepperButton: string;
+        };
+    };
+    layout: {
+        stacked: {
+            root: string;
+        };
+        inline: {
+            root: string;
+            label: string;
+        };
+    };
+    error: {
+        true: {
+            inputWrapper: string;
+        };
+    };
+    fullWidth: {
+        true: {
+            root: string;
+            inputWrapper: string;
+        };
+    };
+    disabled: {
+        true: {
+            inputWrapper: string;
+        };
+    };
+}, {
+    root: string;
+    label: string;
+    requiredMark: string;
+    inputWrapper: string[];
+    input: string[];
+    stepper: string[];
+    stepperButton: string[];
+    helperText: string;
+    errorText: string;
+}, import("tailwind-variants").TVReturnType<{
+    size: {
+        sm: {
+            inputWrapper: string;
+            input: string;
+            stepperButton: string;
+        };
+        md: {
+            inputWrapper: string;
+            input: string;
+            stepperButton: string;
+        };
+        lg: {
+            inputWrapper: string;
+            input: string;
+            stepperButton: string;
+        };
+    };
+    layout: {
+        stacked: {
+            root: string;
+        };
+        inline: {
+            root: string;
+            label: string;
+        };
+    };
+    error: {
+        true: {
+            inputWrapper: string;
+        };
+    };
+    fullWidth: {
+        true: {
+            root: string;
+            inputWrapper: string;
+        };
+    };
+    disabled: {
+        true: {
+            inputWrapper: string;
+        };
+    };
+}, {
+    root: string;
+    label: string;
+    requiredMark: string;
+    inputWrapper: string[];
+    input: string[];
+    stepper: string[];
+    stepperButton: string[];
+    helperText: string;
+    errorText: string;
+}, undefined, unknown, unknown, undefined>>;
+export type NumberFieldVariants = VariantProps<typeof numberFieldVariants>;
+//# sourceMappingURL=numberField.variants.d.ts.map

package/dist/src/components/NumberField/numberField.variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numberField.variants.d.ts","sourceRoot":"","sources":["../../../../src/components/NumberField/numberField.variants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAmF9B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/src/components/OTPField/OTPField.d.ts

@@ -0,0 +1,25 @@
+import type { OTPFieldProps } from './otpField.types.js';
+/**
+ * Dashforge TW OTPField — segmented input for one-time codes.
+ *
+ * Renders N visible "slot" cells over a hidden text input that absorbs
+ * all keystrokes. The visible cells are read-only display surfaces; only
+ * the hidden input takes focus. This pattern works correctly with
+ * password managers + autofill (the hidden input has
+ * `autoComplete="one-time-code"`).
+ *
+ * Bridge contract: the joined string (length ≤ `length`) is what gets
+ * written to the bridge. Use `<DashForm rules={{ minLength: length }} />`
+ * to require a complete code.
+ *
+ * Out of scope for F4-B (deferred to a follow-up sprint):
+ *  - Per-slot click to jump caret
+ *  - Arrow-key navigation between slots
+ *  - Right-to-left input direction
+ *
+ * **A11y**: the hidden `<input>` exposes
+ * `inputMode="numeric" | "text"` per mode + `autoComplete="one-time-code"`
+ * so iOS Safari + Android Chrome trigger SMS autofill correctly.
+ */
+export declare function OTPField(props: OTPFieldProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=OTPField.d.ts.map

package/dist/src/components/OTPField/OTPField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OTPField.d.ts","sourceRoot":"","sources":["../../../../src/components/OTPField/OTPField.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAgBvE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,kDA2M5C"}

package/dist/src/components/OTPField/otpField.types.d.ts

@@ -0,0 +1,74 @@
+import type { ReactNode } from 'react';
+import type { Engine } from '@dashforge/ui-core';
+import type { AccessRequirement } from '@dashforge/rbac';
+import type { OTPFieldVariants } from './otpField.variants.js';
+export type OTPFieldMode = 'numeric' | 'alphanumeric';
+export interface OTPFieldSlotProps {
+    root?: {
+        className?: string;
+    };
+    label?: {
+        className?: string;
+    };
+    requiredMark?: {
+        className?: string;
+    };
+    slotsRow?: {
+        className?: string;
+    };
+    slot?: {
+        className?: string;
+    };
+    slotChar?: {
+        className?: string;
+    };
+    hiddenInput?: {
+        className?: string;
+    };
+    helperText?: {
+        className?: string;
+    };
+    errorText?: {
+        className?: string;
+    };
+}
+/**
+ * Props for `<OTPField>`.
+ *
+ * Storage contract: bridge value is a single string (e.g. `"123456"`).
+ * The user types characters that the component sanitises per `mode`:
+ *  - `'numeric'`      → `[0-9]`
+ *  - `'alphanumeric'` → `[A-Za-z0-9]`
+ * Anything else is dropped. Paste content is sanitised the same way and
+ * fills slots sequentially.
+ */
+export interface OTPFieldProps extends OTPFieldVariants {
+    name: string;
+    rules?: unknown;
+    label?: ReactNode;
+    helperText?: ReactNode;
+    required?: boolean;
+    error?: boolean;
+    disabled?: boolean;
+    /** Engine predicate — field not rendered when it returns `false`. */
+    visibleWhen?: (engine: Engine) => boolean;
+    /** RBAC access requirement (combines with explicit `disabled`). */
+    access?: AccessRequirement;
+    /** Root className shortcut. */
+    sx?: string;
+    /** Per-slot className overrides. */
+    slotProps?: OTPFieldSlotProps;
+    /** Number of slots (default 6 — the SMS code convention). */
+    length?: number;
+    /** Character set allowed. Default `'numeric'`. */
+    mode?: OTPFieldMode;
+    /** Controlled value (form mode reads from the bridge if omitted). */
+    value?: string;
+    /** Default value (uncontrolled, standalone mode only). */
+    defaultValue?: string;
+    /** Fires every time the joined value changes (sanitised, ≤ length). */
+    onChange?: (value: string) => void;
+    /** Fires when the user has filled all slots. */
+    onComplete?: (value: string) => void;
+}
+//# sourceMappingURL=otpField.types.d.ts.map

package/dist/src/components/OTPField/otpField.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otpField.types.d.ts","sourceRoot":"","sources":["../../../../src/components/OTPField/otpField.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,cAAc,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,YAAY,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,QAAQ,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,WAAW,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,mEAAmE;IACnE,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,+BAA+B;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,gDAAgD;IAChD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC"}