@dashforge/tw 0.10.0-beta → 1.0.0

package/dist/components/Pagination/pagination.helpers.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Compute the array of page indices (or `'ellipsis'` sentinels) to
+ * render for a `<Pagination>`.
+ *
+ * Algorithm (standard "siblings + boundaries + ellipsis fill"):
+ *  1. Always show `boundaryCount` pages at the start and `boundaryCount`
+ *     at the end.
+ *  2. Show `siblingCount` pages on each side of the current page.
+ *  3. Fill gaps wider than 1 with `'ellipsis'`.
+ *  4. If a gap is exactly 1 page wide, include that page directly
+ *     (no ellipsis for a single hidden number).
+ *
+ * Output is 1-indexed page numbers OR the literal string `'ellipsis'`.
+ *
+ * @example
+ * ```ts
+ * range(1, 10, 1, 1)  // [1, 'ellipsis', 5, 'ellipsis', 10] when current=5
+ * range(1, 5, 1, 1)   // [1, 2, 3, 4, 5]
+ * range(1, 100, 1, 1) // edges varying with current
+ * ```
+ */
+export declare function computePageRange(currentPage: number, totalPages: number, siblingCount: number, boundaryCount: number): (number | 'ellipsis')[];
+//# sourceMappingURL=pagination.helpers.d.ts.map

package/dist/components/Pagination/pagination.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.helpers.d.ts","sourceRoot":"","sources":["../../../src/components/Pagination/pagination.helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,CAAC,MAAM,GAAG,UAAU,CAAC,EAAE,CAsEzB"}

package/dist/components/Pagination/pagination.types.d.ts

@@ -0,0 +1,120 @@
+import type { PaginationVariants } from './pagination.variants.js';
+export interface PaginationSlotProps {
+    root?: {
+        className?: string;
+    };
+    summary?: {
+        className?: string;
+    };
+    list?: {
+        className?: string;
+    };
+    pageButton?: {
+        className?: string;
+    };
+    activeButton?: {
+        className?: string;
+    };
+    navButton?: {
+        className?: string;
+    };
+    ellipsis?: {
+        className?: string;
+    };
+    pageSizeSelector?: {
+        className?: string;
+    };
+    jumpInput?: {
+        className?: string;
+    };
+}
+/**
+ * I18n strings for `<Pagination>`. Default = English. Override the
+ * subset you need to translate; the rest fall back to defaults.
+ */
+export interface PaginationLabels {
+    first?: string;
+    prev?: string;
+    next?: string;
+    last?: string;
+    page?: string;
+    of?: string;
+    showing?: string;
+    perPage?: string;
+    goToPage?: string;
+}
+/**
+ * Props for `<Pagination>`.
+ *
+ * Controlled component: the consumer owns `page` + `pageSize`. The
+ * component emits `onPageChange` / `onPageSizeChange` and recomputes
+ * the visible page range from `totalCount`.
+ *
+ * @example
+ * ```tsx
+ * const [page, setPage] = useState(1);
+ * const [pageSize, setPageSize] = useState(20);
+ *
+ * <Pagination
+ *   page={page}
+ *   pageSize={pageSize}
+ *   totalCount={1437}
+ *   onPageChange={setPage}
+ *   onPageSizeChange={setPageSize}
+ *   pageSizeOptions={[10, 20, 50, 100]}
+ * />
+ * ```
+ */
+export interface PaginationProps extends Pick<PaginationVariants, 'variant' | 'size'> {
+    /** Current page, **1-indexed**. */
+    page: number;
+    /** Items per page. */
+    pageSize: number;
+    /** Total items in the underlying data set (NOT total pages — we compute that). */
+    totalCount: number;
+    /** Fired when the user picks a different page. */
+    onPageChange: (page: number) => void;
+    /**
+     * Fired when the user picks a different page size. Omit (or pass
+     * undefined) to hide the page-size selector.
+     */
+    onPageSizeChange?: (pageSize: number) => void;
+    /**
+     * Options shown in the page-size selector.
+     * @default [10, 20, 50, 100]
+     */
+    pageSizeOptions?: number[];
+    /**
+     * How many page buttons to show on each side of the current page.
+     * @default 1
+     */
+    siblingCount?: number;
+    /**
+     * How many page buttons to always show at the start/end of the
+     * sequence (acts as "boundary"). @default 1
+     */
+    boundaryCount?: number;
+    /**
+     * Show first/last buttons (`«` / `»`). @default true
+     */
+    showFirstLast?: boolean;
+    /**
+     * Show the direct page-jump input (variant=`default` only).
+     * @default true
+     */
+    showJumpInput?: boolean;
+    /**
+     * Disable all interactive elements (kept rendered but inert).
+     */
+    disabled?: boolean;
+    /**
+     * I18n strings. Defaults are English; pass the subset you need
+     * to translate.
+     */
+    labels?: PaginationLabels;
+    /** Root-level Tailwind override. */
+    sx?: string;
+    /** Per-slot overrides. */
+    slotProps?: PaginationSlotProps;
+}
+//# sourceMappingURL=pagination.types.d.ts.map

package/dist/components/Pagination/pagination.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.types.d.ts","sourceRoot":"","sources":["../../../src/components/Pagination/pagination.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,YAAY,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,QAAQ,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,gBAAgB,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,MAAM,CAAC;IACnF,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IAEb,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IAEjB,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IAEnB,kDAAkD;IAClD,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAErC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAE9C;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAE1B,oCAAoC;IACpC,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,0BAA0B;IAC1B,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC"}

package/dist/components/Pagination/pagination.variants.d.ts

@@ -0,0 +1,150 @@
+import { type VariantProps } from 'tailwind-variants';
+/**
+ * `<Pagination>` variant recipe.
+ *
+ * Slots:
+ *  - `root`             — outer `<nav>` container
+ *  - `summary`          — "Showing X-Y of Z" text
+ *  - `list`             — `<ul>` of page buttons
+ *  - `pageButton`       — individual page number button
+ *  - `activeButton`     — modifier applied to the current page
+ *  - `navButton`        — first/prev/next/last buttons
+ *  - `ellipsis`         — `…` rendered when range gap
+ *  - `pageSizeSelector` — native `<select>` for page size
+ *  - `jumpInput`        — direct page jump `<input>`
+ *
+ * Variant axes:
+ *  - `variant` — `default` (full kit) | `compact` (number buttons +
+ *    prev/next only) | `minimal` ("X / Y pages" + prev/next only).
+ *  - `size` — `sm` | `md` (default) | `lg`. Drives padding + text
+ *    size on the buttons.
+ */
+export declare const paginationVariants: import("tailwind-variants").TVReturnType<{
+    variant: {
+        default: {};
+        compact: {};
+        minimal: {};
+    };
+    size: {
+        sm: {
+            summary: string;
+            pageButton: string;
+            navButton: string;
+            ellipsis: string;
+            pageSizeSelector: string;
+            jumpInput: string;
+        };
+        md: {
+            summary: string;
+            pageButton: string;
+            navButton: string;
+            ellipsis: string;
+            pageSizeSelector: string;
+            jumpInput: string;
+        };
+        lg: {
+            summary: string;
+            pageButton: string;
+            navButton: string;
+            ellipsis: string;
+            pageSizeSelector: string;
+            jumpInput: string;
+        };
+    };
+}, {
+    root: string;
+    summary: string;
+    list: string;
+    pageButton: string[];
+    activeButton: string[];
+    navButton: string[];
+    ellipsis: string;
+    pageSizeSelector: string[];
+    jumpInput: string[];
+}, undefined, {
+    variant: {
+        default: {};
+        compact: {};
+        minimal: {};
+    };
+    size: {
+        sm: {
+            summary: string;
+            pageButton: string;
+            navButton: string;
+            ellipsis: string;
+            pageSizeSelector: string;
+            jumpInput: string;
+        };
+        md: {
+            summary: string;
+            pageButton: string;
+            navButton: string;
+            ellipsis: string;
+            pageSizeSelector: string;
+            jumpInput: string;
+        };
+        lg: {
+            summary: string;
+            pageButton: string;
+            navButton: string;
+            ellipsis: string;
+            pageSizeSelector: string;
+            jumpInput: string;
+        };
+    };
+}, {
+    root: string;
+    summary: string;
+    list: string;
+    pageButton: string[];
+    activeButton: string[];
+    navButton: string[];
+    ellipsis: string;
+    pageSizeSelector: string[];
+    jumpInput: string[];
+}, import("tailwind-variants").TVReturnType<{
+    variant: {
+        default: {};
+        compact: {};
+        minimal: {};
+    };
+    size: {
+        sm: {
+            summary: string;
+            pageButton: string;
+            navButton: string;
+            ellipsis: string;
+            pageSizeSelector: string;
+            jumpInput: string;
+        };
+        md: {
+            summary: string;
+            pageButton: string;
+            navButton: string;
+            ellipsis: string;
+            pageSizeSelector: string;
+            jumpInput: string;
+        };
+        lg: {
+            summary: string;
+            pageButton: string;
+            navButton: string;
+            ellipsis: string;
+            pageSizeSelector: string;
+            jumpInput: string;
+        };
+    };
+}, {
+    root: string;
+    summary: string;
+    list: string;
+    pageButton: string[];
+    activeButton: string[];
+    navButton: string[];
+    ellipsis: string;
+    pageSizeSelector: string[];
+    jumpInput: string[];
+}, undefined, unknown, unknown, undefined>>;
+export type PaginationVariants = VariantProps<typeof paginationVariants>;
+//# sourceMappingURL=pagination.variants.d.ts.map

package/dist/components/Pagination/pagination.variants.d.ts.map

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

package/dist/components/Popover/Popover.d.ts

@@ -0,0 +1,15 @@
+import type { PopoverProps } from './popover.types.js';
+/**
+ * Dashforge TW `<Popover>` — clickable floating content panel.
+ *
+ * Built on `@radix-ui/react-popover`:
+ *  - Focus trap inside the popover (Tab cycles within).
+ *  - Outside-click + Escape dismiss.
+ *  - APG dialog-like semantics (`role="dialog"` on content).
+ *  - Portal-rendered.
+ *
+ * Use `<Popover>` for menus / pickers / settings panels with
+ * interactive children. Use `<Tooltip>` for read-only hints.
+ */
+export declare function Popover(props: PopoverProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Popover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Popover.d.ts","sourceRoot":"","sources":["../../../src/components/Popover/Popover.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,2CAqC1C"}

package/dist/components/Popover/popover.types.d.ts

@@ -0,0 +1,45 @@
+import type { ReactNode } from 'react';
+export interface PopoverSlotProps {
+    content?: {
+        className?: string;
+    };
+    arrow?: {
+        className?: string;
+    };
+}
+/**
+ * Props for `<Popover>`.
+ *
+ * Built on `@radix-ui/react-popover`. Use for richer floating UI
+ * than a tooltip — e.g. action menus, color pickers, settings
+ * panels.
+ *
+ * Differences vs `<Tooltip>`:
+ *  - Popover is **clickable** and captures focus inside (focus trap).
+ *  - Popover supports arbitrary interactive content (forms, buttons).
+ *  - Popover dismisses on outside-click / Escape (Radix-managed).
+ *  - No `role="tooltip"` — popovers are conceptually mini-dialogs.
+ */
+export interface PopoverProps {
+    /** The trigger element (wrapped in Radix's `asChild` slot). */
+    children: ReactNode;
+    /** Popover body content. */
+    content: ReactNode;
+    /** Side of the trigger to render on. @default 'bottom' */
+    side?: 'top' | 'right' | 'bottom' | 'left';
+    /** Alignment along the perpendicular axis. @default 'center' */
+    align?: 'start' | 'center' | 'end';
+    /** Show an arrow indicator. @default false */
+    showArrow?: boolean;
+    /** Controlled open state. */
+    open?: boolean;
+    /** Called when open state changes. */
+    onOpenChange?: (open: boolean) => void;
+    /** Side offset in pixels. @default 8 */
+    sideOffset?: number;
+    /** Width of the popover content. CSS value. */
+    width?: string;
+    /** Per-slot overrides. */
+    slotProps?: PopoverSlotProps;
+}
+//# sourceMappingURL=popover.types.d.ts.map

package/dist/components/Popover/popover.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"popover.types.d.ts","sourceRoot":"","sources":["../../../src/components/Popover/popover.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,QAAQ,EAAE,SAAS,CAAC;IACpB,4BAA4B;IAC5B,OAAO,EAAE,SAAS,CAAC;IACnB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC3C,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IACnC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sCAAsC;IACtC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B"}

package/dist/components/Popover/popover.variants.d.ts

@@ -0,0 +1,34 @@
+import { type VariantProps } from 'tailwind-variants';
+export declare const popoverVariants: import("tailwind-variants").TVReturnType<{
+    [key: string]: {
+        [key: string]: import("tailwind-merge").ClassNameValue | {
+            content?: import("tailwind-merge").ClassNameValue;
+            arrow?: import("tailwind-merge").ClassNameValue;
+        };
+    };
+} | {
+    [x: string]: {
+        [x: string]: import("tailwind-merge").ClassNameValue | {
+            content?: import("tailwind-merge").ClassNameValue;
+            arrow?: import("tailwind-merge").ClassNameValue;
+        };
+    };
+} | {}, {
+    content: string[];
+    arrow: string;
+}, undefined, {
+    [key: string]: {
+        [key: string]: import("tailwind-merge").ClassNameValue | {
+            content?: import("tailwind-merge").ClassNameValue;
+            arrow?: import("tailwind-merge").ClassNameValue;
+        };
+    };
+} | {}, {
+    content: string[];
+    arrow: string;
+}, import("tailwind-variants").TVReturnType<unknown, {
+    content: string[];
+    arrow: string;
+}, undefined, unknown, unknown, undefined>>;
+export type PopoverVariants = VariantProps<typeof popoverVariants>;
+//# sourceMappingURL=popover.variants.d.ts.map

package/dist/components/Popover/popover.variants.d.ts.map

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

package/dist/components/RadioGroup/RadioGroup.d.ts

@@ -0,0 +1,35 @@
+import type { RadioGroupProps } from './radioGroup.types.js';
+/**
+ * Dashforge TW RadioGroup — bridge-integrated single-choice group.
+ *
+ * Renders through Radix `RadioGroup.Root` + `Item` + `Indicator`, styled
+ * with the `radioGroupVariants` TV recipe. Behaviour at the bridge level
+ * is a 1:1 port of `@dashforge/ui/RadioGroup` (MUI):
+ *
+ *  - Inside `DashFormProvider`: registers with the bridge, reads
+ *    `useDashFieldMeta` for the selected value (reactive snapshot),
+ *    writes through `bridge.setValue` on change, fires
+ *    `registration.onChange` / `onBlur` for RHF.
+ *  - Outside: behaves as a plain Radix RadioGroup (controlled by `value`
+ *    + `onValueChange`, or uncontrolled via `defaultValue`).
+ *  - `visibleWhen` predicates the engine state.
+ *  - `useAccessState(access)` resolves group-level RBAC; per-option RBAC
+ *    is resolved by calling `useAccessState` for every entry of the
+ *    `options` array (Rules of Hooks: stable as long as `options.length`
+ *    is stable, which is the documented contract — mutating the array
+ *    between renders breaks).
+ *  - Group-level RBAC has precedence over option-level (hide-the-group
+ *    wins even if some options would be visible).
+ *  - Error gating: bridge error shows only after `touched` or after the
+ *    form has been submitted at least once (Form Closure v1).
+ *  - StrictMode-safe unregister-on-unmount, mirrors Checkbox/Switch.
+ *
+ * **A11y**:
+ *   - The group root is a `<div role="radiogroup">` (Radix default).
+ *   - A `<label id="...">` is associated with the group via `aria-labelledby`.
+ *   - The helper/error text is linked via `aria-describedby`.
+ *   - Each option is a Radix `<RadioGroup.Item>` (`<button role="radio">`)
+ *     keyboard-accessible by default (arrow keys move selection).
+ */
+export declare function RadioGroup(props: RadioGroupProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=RadioGroup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RadioGroup.d.ts","sourceRoot":"","sources":["../../../src/components/RadioGroup/RadioGroup.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,kDA+OhD"}

package/dist/components/RadioGroup/radioGroup.types.d.ts

@@ -0,0 +1,103 @@
+import type { ReactNode } from 'react';
+import type { Engine } from '@dashforge/ui-core';
+import type { AccessRequirement } from '@dashforge/rbac';
+import type { RadioGroupVariants } from './radioGroup.variants.js';
+/**
+ * A single selectable option in a `<RadioGroup>`.
+ */
+export interface RadioGroupOption {
+    /** The string value persisted on the form for this option. */
+    value: string;
+    /** Display label (string or any React node — e.g. with an icon). */
+    label: ReactNode;
+    /** Per-option explicit disable. ORed with group-level disable + RBAC. */
+    disabled?: boolean;
+    /**
+     * RBAC access requirement for this specific option:
+     *  - `onUnauthorized: 'hide'`     → option not rendered (unless it's the currently selected value, kept disabled to expose the choice)
+     *  - `onUnauthorized: 'disable'`  → option visible but not selectable
+     *  - `onUnauthorized: 'readonly'` → falls back to disabled (radios have no true readonly semantics)
+     *
+     * Group-level access has **precedence** over option-level access — if the
+     * whole group is hidden/disabled, that wins for all options regardless of
+     * their own access.
+     */
+    access?: AccessRequirement;
+}
+/**
+ * Optional className override for each slot. Use to extend specific parts
+ * of the recipe without losing the default classes. Override semantics
+ * follow the `tailwind-merge` last-wins rule.
+ */
+export interface RadioGroupSlotProps {
+    root?: {
+        className?: string;
+    };
+    label?: {
+        className?: string;
+    };
+    requiredMark?: {
+        className?: string;
+    };
+    optionList?: {
+        className?: string;
+    };
+    option?: {
+        className?: string;
+    };
+    control?: {
+        className?: string;
+    };
+    indicator?: {
+        className?: string;
+    };
+    optionLabel?: {
+        className?: string;
+    };
+    helperText?: {
+        className?: string;
+    };
+    errorText?: {
+        className?: string;
+    };
+}
+/**
+ * Props for `<RadioGroup>`.
+ *
+ * Mirrors the MUI-side `@dashforge/ui/RadioGroup` at the bridge level —
+ * same `name` / `rules` / `visibleWhen` / `access` semantics, same
+ * Form Closure v1 error gating, same option-level RBAC.
+ */
+export interface RadioGroupProps extends RadioGroupVariants {
+    /** Field name registered with the bridge. */
+    name: string;
+    /** Array of selectable options. Order is render order. */
+    options: RadioGroupOption[];
+    /** Group-level label (rendered above the option list). */
+    label?: ReactNode;
+    /** React Hook Form validation rules — forwarded to `bridge.register`. */
+    rules?: unknown;
+    /** Helper text shown below the option list when not in error state. */
+    helperText?: ReactNode;
+    /** Marks the group as required (renders red `*` after the label). */
+    required?: boolean;
+    /** Explicit error override (otherwise resolved from bridge). */
+    error?: boolean;
+    /** Explicit disable override (ORed with RBAC). */
+    disabled?: boolean;
+    /** Engine predicate — group not rendered when it returns `false`. */
+    visibleWhen?: (engine: Engine) => boolean;
+    /** Group-level RBAC requirement (precedes option-level access). */
+    access?: AccessRequirement;
+    /** Root className shortcut (`cn`'d with the variant root class). */
+    sx?: string;
+    /** Per-slot className overrides. */
+    slotProps?: RadioGroupSlotProps;
+    /** Controlled value (for standalone mode without a form bridge). */
+    value?: string;
+    /** Default value for uncontrolled mode (no-op in form mode — bridge wins). */
+    defaultValue?: string;
+    /** Change handler (called *after* bridge update in form mode). */
+    onValueChange?: (value: string) => void;
+}
+//# sourceMappingURL=radioGroup.types.d.ts.map

package/dist/components/RadioGroup/radioGroup.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radioGroup.types.d.ts","sourceRoot":"","sources":["../../../src/components/RadioGroup/radioGroup.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,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,KAAK,EAAE,SAAS,CAAC;IACjB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,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,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,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;;;;;;GAMG;AACH,MAAM,WAAW,eAAgB,SAAQ,kBAAkB;IACzD,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,0DAA0D;IAC1D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,yEAAyE;IACzE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,uEAAuE;IACvE,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,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,mBAAmB,CAAC;IAChC,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC"}