@dashforge/tw 0.10.0-beta → 1.0.0

package/dist/components/Tabs/Tabs.d.ts

@@ -0,0 +1,19 @@
+import type { TabsProps } from './tabs.types.js';
+/**
+ * Dashforge TW `<Tabs>` — declarative tab navigation.
+ *
+ * Custom clean-room implementation on the headless `useTabs` engine — no
+ * runtime UI dependency. Implements the WAI-ARIA APG tabs pattern: arrow-key
+ * navigation, automatic activation, roving tabindex, `role="tablist"` +
+ * `role="tab"` + `role="tabpanel"`.
+ *
+ * Two variant axes:
+ *  - `variant` — `underline` (default) | `pill`
+ *  - `orientation` — `horizontal` (default) | `vertical`
+ *
+ * Controlled (`value` + `onValueChange`) or uncontrolled (`defaultValue`).
+ * `keepMounted` keeps inactive panels in the DOM (default: only the active
+ * panel is mounted).
+ */
+export declare function Tabs(props: TabsProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Tabs.d.ts.map

package/dist/components/Tabs/Tabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tabs.d.ts","sourceRoot":"","sources":["../../../src/components/Tabs/Tabs.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,2CAuDpC"}

package/dist/components/Tabs/tabs.types.d.ts

@@ -0,0 +1,61 @@
+import type { ReactNode } from 'react';
+import type { TabsVariants } from './tabs.variants.js';
+export interface TabsSlotProps {
+    root?: {
+        className?: string;
+    };
+    list?: {
+        className?: string;
+    };
+    trigger?: {
+        className?: string;
+    };
+    content?: {
+        className?: string;
+    };
+}
+/**
+ * Single tab item — paired `{ value, label, content }`. The `value`
+ * is the canonical id (selected via the `value` / `defaultValue`
+ * props on the root); the `label` is the trigger button text, and
+ * `content` is what renders in the panel when this tab is active.
+ */
+export interface TabItem {
+    value: string;
+    label: ReactNode;
+    /** Tab panel content. */
+    content: ReactNode;
+    /** Per-tab disabled flag. */
+    disabled?: boolean;
+}
+/**
+ * Props for `<Tabs>`.
+ *
+ * Custom clean-room implementation — the headless `useTabs` engine, no Radix.
+ * Two variant axes:
+ *  - `variant` — `underline` (default) | `pill`
+ *  - `orientation` — `horizontal` (default) | `vertical`
+ *
+ * Supports controlled (`value` + `onValueChange`) and uncontrolled
+ * (`defaultValue`) modes — the `value` prop wins when both are set.
+ */
+export interface TabsProps extends TabsVariants {
+    /** Tab items array. */
+    items: TabItem[];
+    /** Controlled active value. */
+    value?: string;
+    /** Default active value (uncontrolled). Defaults to first item's value. */
+    defaultValue?: string;
+    /** Fires when the active tab changes. */
+    onValueChange?: (value: string) => void;
+    /**
+     * Keep inactive panels mounted (hidden via the `hidden` attribute).
+     * Default `false` — only the active panel is in the DOM.
+     */
+    keepMounted?: boolean;
+    /** Root className shortcut. */
+    sx?: string;
+    /** Per-slot overrides. */
+    slotProps?: TabsSlotProps;
+}
+//# sourceMappingURL=tabs.types.d.ts.map

package/dist/components/Tabs/tabs.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.types.d.ts","sourceRoot":"","sources":["../../../src/components/Tabs/tabs.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,yBAAyB;IACzB,OAAO,EAAE,SAAS,CAAC;IACnB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,SAAU,SAAQ,YAAY;IAC7C,uBAAuB;IACvB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+BAA+B;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B"}

package/dist/components/Tabs/tabs.variants.d.ts

@@ -0,0 +1,82 @@
+import { type VariantProps } from 'tailwind-variants';
+export declare const tabsVariants: import("tailwind-variants").TVReturnType<{
+    variant: {
+        underline: {
+            list: string;
+            trigger: string[];
+        };
+        pill: {
+            list: string;
+            trigger: string[];
+        };
+    };
+    orientation: {
+        horizontal: {
+            root: string;
+            list: string;
+        };
+        vertical: {
+            root: string;
+            list: string;
+        };
+    };
+}, {
+    root: string;
+    list: string;
+    trigger: string[];
+    content: string[];
+}, undefined, {
+    variant: {
+        underline: {
+            list: string;
+            trigger: string[];
+        };
+        pill: {
+            list: string;
+            trigger: string[];
+        };
+    };
+    orientation: {
+        horizontal: {
+            root: string;
+            list: string;
+        };
+        vertical: {
+            root: string;
+            list: string;
+        };
+    };
+}, {
+    root: string;
+    list: string;
+    trigger: string[];
+    content: string[];
+}, import("tailwind-variants").TVReturnType<{
+    variant: {
+        underline: {
+            list: string;
+            trigger: string[];
+        };
+        pill: {
+            list: string;
+            trigger: string[];
+        };
+    };
+    orientation: {
+        horizontal: {
+            root: string;
+            list: string;
+        };
+        vertical: {
+            root: string;
+            list: string;
+        };
+    };
+}, {
+    root: string;
+    list: string;
+    trigger: string[];
+    content: string[];
+}, undefined, unknown, unknown, undefined>>;
+export type TabsVariants = VariantProps<typeof tabsVariants>;
+//# sourceMappingURL=tabs.variants.d.ts.map

package/dist/components/Tabs/tabs.variants.d.ts.map

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

package/dist/components/Tabs/useTabs.d.ts

@@ -0,0 +1,55 @@
+import type { KeyboardEvent } from 'react';
+import type { TabItem } from './tabs.types.js';
+/**
+ * `useTabs` — the headless tab engine for the Tailwind `<Tabs>`.
+ *
+ * Pure logic, zero UI: active-value state (controlled / uncontrolled) plus
+ * the WAI-ARIA APG keyboard model (arrow keys, Home/End, roving tabindex,
+ * automatic activation, disabled-skip, edge wrap). Returns attribute bundles
+ * for the `tablist` / `tab` / `tabpanel` roles.
+ *
+ * Deliberately NOT a shared package: the tab logic is ~90 lines — too thin
+ * to justify a published `tabs-core`. The MUI skin keeps its own near-identical
+ * copy. Only the public API contract is shared.
+ */
+interface UseTabsOptions {
+    items: TabItem[];
+    value: string | undefined;
+    defaultValue: string | undefined;
+    onValueChange: ((value: string) => void) | undefined;
+    orientation: 'horizontal' | 'vertical';
+}
+interface TabListAttributes {
+    role: 'tablist';
+    'aria-orientation': 'horizontal' | 'vertical';
+    onKeyDown: (event: KeyboardEvent<HTMLDivElement>) => void;
+}
+interface TabAttributes {
+    role: 'tab';
+    id: string;
+    'aria-selected': boolean;
+    'aria-controls': string;
+    tabIndex: number;
+    disabled: boolean | undefined;
+    'data-state': 'active' | 'inactive';
+    onClick: () => void;
+    ref: (el: HTMLButtonElement | null) => void;
+}
+interface PanelAttributes {
+    role: 'tabpanel';
+    id: string;
+    'aria-labelledby': string;
+    tabIndex: number;
+    hidden: boolean;
+    'data-state': 'active' | 'inactive';
+}
+export interface UseTabsResult {
+    /** The currently active tab value. */
+    activeValue: string;
+    getTabListProps: () => TabListAttributes;
+    getTabProps: (item: TabItem) => TabAttributes;
+    getPanelProps: (item: TabItem) => PanelAttributes;
+}
+export declare function useTabs(options: UseTabsOptions): UseTabsResult;
+export {};
+//# sourceMappingURL=useTabs.d.ts.map

package/dist/components/Tabs/useTabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTabs.d.ts","sourceRoot":"","sources":["../../../src/components/Tabs/useTabs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;;;;;;;GAWG;AACH,UAAU,cAAc;IACtB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,aAAa,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACrD,WAAW,EAAE,YAAY,GAAG,UAAU,CAAC;CACxC;AAED,UAAU,iBAAiB;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,kBAAkB,EAAE,YAAY,GAAG,UAAU,CAAC;IAC9C,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;CAC3D;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,YAAY,EAAE,QAAQ,GAAG,UAAU,CAAC;IACpC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,GAAG,EAAE,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI,KAAK,IAAI,CAAC;CAC7C;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,QAAQ,GAAG,UAAU,CAAC;CACrC;AAED,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,iBAAiB,CAAC;IACzC,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,aAAa,CAAC;IAC9C,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,eAAe,CAAC;CACnD;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CA2G9D"}

package/dist/components/TextField/TextField.d.ts

@@ -0,0 +1,25 @@
+import type { TextFieldProps } from './textField.types.js';
+/**
+ * Dashforge TW TextField — bridge-integrated text input.
+ *
+ * Implementation mirrors `@dashforge/ui/TextField` (MUI) at the bridge
+ * level — same `name` / `rules` / `visibleWhen` / `access` semantics,
+ * same validation gating, same StrictMode-safe unregister pattern.
+ * Renderer differences:
+ *
+ *  - Native `<input>` element wrapped in a TV-styled
+ *    `<div role-less wrapper>` so the focus ring extends to the entire
+ *    field (consistent with shadcn-style inputs).
+ *  - Layout modes: `stacked` (default — label above) and `inline`
+ *    (label left of input). MUI's `floating` mode is deferred to a
+ *    follow-up sprint; consumers needing the visual can layer it via
+ *    `slotProps`.
+ *  - No Select-integration hook (Select lands in F4 as its own component).
+ *
+ * **A11y**:
+ *   - `aria-invalid` is set from the resolved validation state.
+ *   - `aria-describedby` links the input to the helper/error text node.
+ *   - Required fields get the native `required` attribute + a visual `*`.
+ */
+export declare function TextField(props: TextFieldProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=TextField.d.ts.map

package/dist/components/TextField/TextField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextField.d.ts","sourceRoot":"","sources":["../../../src/components/TextField/TextField.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,kDAoN9C"}

package/dist/components/TextField/textField.types.d.ts

@@ -0,0 +1,98 @@
+import type { InputHTMLAttributes, ReactNode } from 'react';
+import type { AccessRequirement } from '@dashforge/rbac';
+import type { Engine } from '@dashforge/ui-core';
+import type { TextFieldVariants } from './textField.variants.js';
+/**
+ * Per-slot overrides for `<TextField>`.
+ *
+ * Each slot accepts `{ className: string }` (and, for `prefix` /
+ * `suffix`, a `children` node) so the override path is extensible —
+ * extra fields like `style`, `aria-*`, `data-*` can be added without
+ * a breaking change. Mirrors the MUI-side `slotProps` shape.
+ *
+ * **`prefix` / `suffix`** are inline adornments rendered INSIDE the
+ * `inputWrapper`, before / after the `<input>` element. Typical use:
+ * currency symbols, units, status icons. Passing only `className`
+ * (no `children`) is allowed but renders an empty slot — usually
+ * you'll always pair the two.
+ *
+ *   ```tsx
+ *   <TextField
+ *     name="price"
+ *     type="number"
+ *     slotProps={{
+ *       prefix: { children: '$' },
+ *       suffix: { children: 'USD' },
+ *     }}
+ *   />
+ *   ```
+ */
+export interface TextFieldSlotProps {
+    root?: {
+        className?: string;
+    };
+    label?: {
+        className?: string;
+    };
+    requiredMark?: {
+        className?: string;
+    };
+    inputWrapper?: {
+        className?: string;
+    };
+    input?: {
+        className?: string;
+    };
+    helperText?: {
+        className?: string;
+    };
+    errorText?: {
+        className?: string;
+    };
+    prefix?: {
+        children?: ReactNode;
+        className?: string;
+    };
+    suffix?: {
+        children?: ReactNode;
+        className?: string;
+    };
+}
+/**
+ * Props for the Dashforge TW `<TextField>`.
+ *
+ * Extends the native `<input>` attributes (so `placeholder`, `type`,
+ * `autoComplete`, `aria-*` etc. all flow through), narrowed in two
+ * places:
+ *
+ *   - `size` is omitted because HTML's legacy `size` attribute (number)
+ *     collides with our variant axis (`'sm' | 'md' | 'lg'`).
+ *   - `className` is omitted — use `sx` instead (the canonical override
+ *     path that wins over variant classes via `tailwind-merge`).
+ *
+ * Plus the variant axes and Dashforge form-bridge wiring (`name`,
+ * `rules`, `visibleWhen`, `access`).
+ */
+export interface TextFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'className'>, Pick<TextFieldVariants, 'size' | 'layout' | 'fullWidth'> {
+    /** Bridge field name (required when used inside `DashFormProvider`). */
+    name: string;
+    /** Visible label. */
+    label?: ReactNode;
+    /** Forwarded to the bridge as RHF rules — opaque to this component. */
+    rules?: unknown;
+    /** Engine predicate. Component returns null when false. */
+    visibleWhen?: (engine: Engine) => boolean;
+    /** Helper line below the input. */
+    helperText?: ReactNode;
+    /** Explicit error semaphore. Overrides bridge auto-error. */
+    error?: boolean;
+    /** Render the asterisk + set the native `required` attribute. */
+    required?: boolean;
+    /** RBAC requirement. */
+    access?: AccessRequirement;
+    /** Root-level Tailwind override — wins over variant classes via `cn()`. */
+    sx?: string;
+    /** Per-slot overrides — see `TextFieldSlotProps`. */
+    slotProps?: TextFieldSlotProps;
+}
+//# sourceMappingURL=textField.types.d.ts.map

package/dist/components/TextField/textField.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textField.types.d.ts","sourceRoot":"","sources":["../../../src/components/TextField/textField.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,kBAAkB;IACjC,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,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACvD;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,cACf,SAAQ,IAAI,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC,EACvE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC1D,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IAEb,qBAAqB;IACrB,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB,uEAAuE;IACvE,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAE1C,mCAAmC;IACnC,UAAU,CAAC,EAAE,SAAS,CAAC;IAEvB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,wBAAwB;IACxB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAE3B,2EAA2E;IAC3E,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,qDAAqD;IACrD,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC"}

package/dist/components/TextField/textField.variants.d.ts

@@ -0,0 +1,166 @@
+import { type VariantProps } from 'tailwind-variants';
+/**
+ * Tailwind-variants recipe for `<TextField>` with 7 slots.
+ *
+ * The MUI-side `TextField` supports three layout modes (floating /
+ * stacked / inline) plus a Select-integration hook. The TW-side
+ * port covers **stacked** + **inline** in F3 (label outside the
+ * input wrapper) and ships a CSS-only floating label using
+ * Tailwind's `peer` modifier.
+ *
+ * The Select integration (`__selectAvailableValues` etc.) is
+ * deferred to F4 when the dedicated `<Select>` component arrives.
+ */
+export declare const textFieldVariants: import("tailwind-variants").TVReturnType<{
+    size: {
+        sm: {
+            inputWrapper: string;
+            input: string;
+        };
+        md: {
+            inputWrapper: string;
+            input: string;
+        };
+        lg: {
+            inputWrapper: string;
+            input: 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[];
+    helperText: string;
+    errorText: string;
+    prefix: string[];
+    suffix: string[];
+}, undefined, {
+    size: {
+        sm: {
+            inputWrapper: string;
+            input: string;
+        };
+        md: {
+            inputWrapper: string;
+            input: string;
+        };
+        lg: {
+            inputWrapper: string;
+            input: 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[];
+    helperText: string;
+    errorText: string;
+    prefix: string[];
+    suffix: string[];
+}, import("tailwind-variants").TVReturnType<{
+    size: {
+        sm: {
+            inputWrapper: string;
+            input: string;
+        };
+        md: {
+            inputWrapper: string;
+            input: string;
+        };
+        lg: {
+            inputWrapper: string;
+            input: 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[];
+    helperText: string;
+    errorText: string;
+    prefix: string[];
+    suffix: string[];
+}, undefined, unknown, unknown, undefined>>;
+export type TextFieldVariants = VariantProps<typeof textFieldVariants>;
+//# sourceMappingURL=textField.variants.d.ts.map

package/dist/components/TextField/textField.variants.d.ts.map

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

package/dist/components/Textarea/Textarea.d.ts

@@ -0,0 +1,16 @@
+import type { TextareaProps } from './textarea.types.js';
+/**
+ * Dashforge TW Textarea — bridge-integrated multi-line input.
+ *
+ * Sibling of `<TextField>` (same slot taxonomy, same bridge wiring) but
+ * renders a `<textarea>` element instead of a single-line `<input>`.
+ *
+ * Defaults to `rows={3}` and `resize="vertical"` — both overridable via
+ * variant prop or per-instance `rows` attribute.
+ *
+ * **A11y**: `aria-invalid` from the resolved validation state,
+ * `aria-describedby` links to the helper/error text node, required
+ * fields get the native `required` attribute + a visual `*`.
+ */
+export declare function Textarea(props: TextareaProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=Textarea.d.ts.map

package/dist/components/Textarea/Textarea.d.ts.map

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

package/dist/components/Textarea/textarea.types.d.ts

@@ -0,0 +1,63 @@
+import type { ChangeEventHandler, FocusEventHandler, ReactNode, TextareaHTMLAttributes } from 'react';
+import type { Engine } from '@dashforge/ui-core';
+import type { AccessRequirement } from '@dashforge/rbac';
+import type { TextareaVariants } from './textarea.variants.js';
+export interface TextareaSlotProps {
+    root?: {
+        className?: string;
+    };
+    label?: {
+        className?: string;
+    };
+    requiredMark?: {
+        className?: string;
+    };
+    inputWrapper?: {
+        className?: string;
+    };
+    input?: {
+        className?: string;
+    };
+    helperText?: {
+        className?: string;
+    };
+    errorText?: {
+        className?: string;
+    };
+}
+/**
+ * Props for `<Textarea>`.
+ *
+ * Mirrors `<TextField>` semantics (bridge integration, RBAC, gating)
+ * but renders a multi-line `<textarea>` and exposes a `resize` variant
+ * (default `'vertical'`). Inherits standard HTMLTextarea attributes
+ * (`rows`, `cols`, `maxLength`, etc.) via `TextareaHTMLAttributes`.
+ */
+export interface TextareaProps extends Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, 'name' | 'size' | 'onChange' | 'onBlur' | 'value' | 'defaultValue'>, TextareaVariants {
+    name: string;
+    rules?: unknown;
+    label?: ReactNode;
+    helperText?: ReactNode;
+    required?: boolean;
+    error?: boolean;
+    disabled?: boolean;
+    /** Engine predicate — textarea 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?: TextareaSlotProps;
+    /** Controlled value (form mode reads from the bridge if omitted). */
+    value?: string;
+    /** Default value (uncontrolled, standalone mode only). */
+    defaultValue?: string;
+    /** User-supplied change handler — fires *after* bridge update. */
+    onChange?: ChangeEventHandler<HTMLTextAreaElement>;
+    /** User-supplied blur handler — fires *after* bridge `onBlur`. */
+    onBlur?: FocusEventHandler<HTMLTextAreaElement>;
+    /** Minimum visible row count for the textarea. Default: 3. */
+    rows?: number;
+}
+//# sourceMappingURL=textarea.types.d.ts.map

package/dist/components/Textarea/textarea.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textarea.types.d.ts","sourceRoot":"","sources":["../../../src/components/Textarea/textarea.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,sBAAsB,EACvB,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,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,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,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,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;;;;;;;GAOG;AACH,MAAM,WAAW,aACf,SAAQ,IAAI,CACR,sBAAsB,CAAC,mBAAmB,CAAC,EAC3C,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,cAAc,CACnE,EACD,gBAAgB;IAClB,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,wEAAwE;IACxE,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,iBAAiB,CAAC;IAC9B,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,CAAC;IACnD,kEAAkE;IAClE,MAAM,CAAC,EAAE,iBAAiB,CAAC,mBAAmB,CAAC,CAAC;IAChD,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}