@dashforge/tw 0.3.0-beta → 0.5.0-beta

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

@@ -0,0 +1,21 @@
+import type { AccordionProps } from './accordion.types.js';
+/**
+ * Dashforge TW `<Accordion>` — collapsible section list.
+ *
+ * Built on `@radix-ui/react-accordion`:
+ *  - APG accordion pattern: `role="region"` on content, header
+ *    button with `aria-expanded` and `aria-controls` linked to
+ *    the panel.
+ *  - Keyboard support: Space / Enter toggle, ArrowDown / ArrowUp
+ *    move focus between triggers, Home / End to extremes.
+ *  - Two modes:
+ *    - `type="single"` — at most one section open at a time;
+ *      `collapsible` allows clicking the open section to close it
+ *      (default true).
+ *    - `type="multiple"` — multiple sections open simultaneously.
+ *
+ * The trigger renders a chevron that flips 180° via CSS
+ * (`data-state=open` selector) — no React state, no JS animation.
+ */
+export declare function Accordion(props: AccordionProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Accordion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Accordion.d.ts","sourceRoot":"","sources":["../../../../src/components/Accordion/Accordion.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,2CAqE9C"}

package/dist/src/components/Accordion/accordion.types.d.ts

@@ -0,0 +1,74 @@
+import type { ReactNode } from 'react';
+export interface AccordionSlotProps {
+    root?: {
+        className?: string;
+    };
+    item?: {
+        className?: string;
+    };
+    header?: {
+        className?: string;
+    };
+    trigger?: {
+        className?: string;
+    };
+    content?: {
+        className?: string;
+    };
+    chevron?: {
+        className?: string;
+    };
+}
+/**
+ * Single accordion section — paired `{ value, header, content }`.
+ * The `value` is the canonical id (used in `value` / `defaultValue`
+ * to control which sections are expanded).
+ */
+export interface AccordionItem {
+    value: string;
+    /** Trigger label (clickable to expand / collapse). */
+    header: ReactNode;
+    /** Section body, revealed when this item is expanded. */
+    content: ReactNode;
+    /** Per-item disabled flag. */
+    disabled?: boolean;
+}
+interface AccordionBaseProps {
+    items: AccordionItem[];
+    /** Root className shortcut. */
+    sx?: string;
+    /** Per-slot overrides. */
+    slotProps?: AccordionSlotProps;
+}
+/**
+ * Single-mode props — at most one section open at a time.
+ * `collapsible: true` (default) lets the user close the open
+ * section by clicking it again.
+ */
+export interface AccordionSingleProps extends AccordionBaseProps {
+    type?: 'single';
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    /** @default true */
+    collapsible?: boolean;
+}
+/**
+ * Multiple-mode props — any number of sections open simultaneously.
+ */
+export interface AccordionMultipleProps extends AccordionBaseProps {
+    type: 'multiple';
+    value?: string[];
+    defaultValue?: string[];
+    onValueChange?: (value: string[]) => void;
+}
+/**
+ * Props for `<Accordion>`.
+ *
+ * Built on `@radix-ui/react-accordion`. Discriminated by `type`:
+ *  - `type="single"` (default) — `value` is `string`.
+ *  - `type="multiple"` — `value` is `string[]`.
+ */
+export type AccordionProps = AccordionSingleProps | AccordionMultipleProps;
+export {};
+//# sourceMappingURL=accordion.types.d.ts.map

package/dist/src/components/Accordion/accordion.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accordion.types.d.ts","sourceRoot":"","sources":["../../../../src/components/Accordion/accordion.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,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;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,MAAM,EAAE,SAAS,CAAC;IAClB,yDAAyD;IACzD,OAAO,EAAE,SAAS,CAAC;IACnB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,kBAAkB;IAC1B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,+BAA+B;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,oBAAoB;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,kBAAkB;IAChE,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,oBAAoB,GAAG,sBAAsB,CAAC"}

package/dist/src/components/Accordion/accordion.variants.d.ts

@@ -0,0 +1,58 @@
+import { type VariantProps } from 'tailwind-variants';
+export declare const accordionVariants: import("tailwind-variants").TVReturnType<{
+    [key: string]: {
+        [key: string]: import("tailwind-merge").ClassNameValue | {
+            content?: import("tailwind-merge").ClassNameValue;
+            root?: import("tailwind-merge").ClassNameValue;
+            trigger?: import("tailwind-merge").ClassNameValue;
+            item?: import("tailwind-merge").ClassNameValue;
+            header?: import("tailwind-merge").ClassNameValue;
+            chevron?: import("tailwind-merge").ClassNameValue;
+        };
+    };
+} | {
+    [x: string]: {
+        [x: string]: import("tailwind-merge").ClassNameValue | {
+            content?: import("tailwind-merge").ClassNameValue;
+            root?: import("tailwind-merge").ClassNameValue;
+            trigger?: import("tailwind-merge").ClassNameValue;
+            item?: import("tailwind-merge").ClassNameValue;
+            header?: import("tailwind-merge").ClassNameValue;
+            chevron?: import("tailwind-merge").ClassNameValue;
+        };
+    };
+} | {}, {
+    root: string;
+    item: string;
+    header: string;
+    trigger: string[];
+    content: string[];
+    chevron: string[];
+}, undefined, {
+    [key: string]: {
+        [key: string]: import("tailwind-merge").ClassNameValue | {
+            content?: import("tailwind-merge").ClassNameValue;
+            root?: import("tailwind-merge").ClassNameValue;
+            trigger?: import("tailwind-merge").ClassNameValue;
+            item?: import("tailwind-merge").ClassNameValue;
+            header?: import("tailwind-merge").ClassNameValue;
+            chevron?: import("tailwind-merge").ClassNameValue;
+        };
+    };
+} | {}, {
+    root: string;
+    item: string;
+    header: string;
+    trigger: string[];
+    content: string[];
+    chevron: string[];
+}, import("tailwind-variants").TVReturnType<unknown, {
+    root: string;
+    item: string;
+    header: string;
+    trigger: string[];
+    content: string[];
+    chevron: string[];
+}, undefined, unknown, unknown, undefined>>;
+export type AccordionVariants = VariantProps<typeof accordionVariants>;
+//# sourceMappingURL=accordion.variants.d.ts.map

package/dist/src/components/Accordion/accordion.variants.d.ts.map

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

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

@@ -0,0 +1,17 @@
+import type { DialogProps } from './dialog.types.js';
+/**
+ * Dashforge TW `<Dialog>` — declarative modal dialog.
+ *
+ * Built on `@radix-ui/react-dialog`:
+ *  - APG dialog pattern out of the box (focus trap, restore focus on
+ *    close, Esc-to-close, `aria-modal`, `aria-labelledby`).
+ *  - Renders into a portal (no z-index hell).
+ *  - Scroll lock on `<body>` while open.
+ *
+ * Use the imperative `useDialog()` (export from this same module) if
+ * you want a `confirm()`-style return value pattern (similar to
+ * `useConfirm()` from `ConfirmDialog`). Use `<Dialog>` when you want
+ * the control flow living in your component tree.
+ */
+export declare function Dialog(props: DialogProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Dialog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Dialog.d.ts","sourceRoot":"","sources":["../../../../src/components/Dialog/Dialog.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,2CAyExC"}

package/dist/src/components/Dialog/dialog.types.d.ts

@@ -0,0 +1,75 @@
+import type { ReactNode } from 'react';
+import type { DialogVariants } from './dialog.variants.js';
+/**
+ * Per-slot className overrides for `<Dialog>`. Mirrors the
+ * canonical TW slotProps shape: `{ slot?: { className?: string } }`.
+ */
+export interface DialogSlotProps {
+    overlay?: {
+        className?: string;
+    };
+    content?: {
+        className?: string;
+    };
+    title?: {
+        className?: string;
+    };
+    description?: {
+        className?: string;
+    };
+    closeButton?: {
+        className?: string;
+    };
+    body?: {
+        className?: string;
+    };
+    actions?: {
+        className?: string;
+    };
+}
+/**
+ * Props for the declarative `<Dialog>` component.
+ *
+ * Built on `@radix-ui/react-dialog`. Use this when:
+ *  - You want full control over the dialog's open state (controlled
+ *    from a parent component).
+ *  - You want to mount a custom-styled dialog body / trigger that
+ *    composes with the rest of your component tree.
+ *  - You don't need an imperative `confirm()`-style return value
+ *    (use `useDialog()` or `useConfirm()` for those).
+ *
+ * Three size variants (`sm` / `md` / `lg`) with sensible defaults.
+ * Backdrop + content animations respect `prefers-reduced-motion`.
+ */
+export interface DialogProps extends Pick<DialogVariants, 'size'> {
+    /** Controlled open state. */
+    open: boolean;
+    /** Called when the dialog requests to change open state. */
+    onOpenChange: (open: boolean) => void;
+    /** Dialog body — usually a `<DialogContent>` subtree. */
+    children: ReactNode;
+    /** Dialog title (screen-reader announced via `aria-labelledby`). */
+    title?: ReactNode;
+    /** Dialog description (announced via `aria-describedby`). */
+    description?: ReactNode;
+    /**
+     * Show the `×` close button in the top-right corner.
+     * @default true
+     */
+    showCloseButton?: boolean;
+    /**
+     * Disable closing on backdrop click.
+     * @default false
+     */
+    disableBackdropClose?: boolean;
+    /**
+     * Disable closing on Escape key.
+     * @default false
+     */
+    disableEscapeClose?: boolean;
+    /** Root className shortcut on the content element. */
+    sx?: string;
+    /** Per-slot overrides. */
+    slotProps?: DialogSlotProps;
+}
+//# sourceMappingURL=dialog.types.d.ts.map

package/dist/src/components/Dialog/dialog.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.types.d.ts","sourceRoot":"","sources":["../../../../src/components/Dialog/dialog.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,WAAW,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,WAAW,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAClC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC;IAC/D,6BAA6B;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,4DAA4D;IAC5D,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,yDAAyD;IACzD,QAAQ,EAAE,SAAS,CAAC;IACpB,oEAAoE;IACpE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,sDAAsD;IACtD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B"}

package/dist/src/components/Dialog/dialog.variants.d.ts

@@ -0,0 +1,80 @@
+import { type VariantProps } from 'tailwind-variants';
+/**
+ * `<Dialog>` variant recipe.
+ *
+ * Slots:
+ *  - `overlay`  — backdrop (Radix's `DialogOverlay`)
+ *  - `content`  — the dialog box itself
+ *  - `title`    — heading at the top
+ *  - `description` — secondary text under the title
+ *  - `closeButton` — top-right `×` button
+ *  - `body`     — main scrollable area
+ *  - `actions`  — footer action bar
+ *
+ * Three sizes (`sm` / `md` / `lg`) drive the content max-width.
+ * Motion is gated by `prefers-reduced-motion` so the slide-in
+ * animation collapses to an instant appear on users that opt out.
+ */
+export declare const dialogVariants: import("tailwind-variants").TVReturnType<{
+    size: {
+        sm: {
+            content: string;
+        };
+        md: {
+            content: string;
+        };
+        lg: {
+            content: string;
+        };
+    };
+}, {
+    overlay: string[];
+    content: string[];
+    title: string;
+    description: string;
+    closeButton: string[];
+    body: string;
+    actions: string;
+}, undefined, {
+    size: {
+        sm: {
+            content: string;
+        };
+        md: {
+            content: string;
+        };
+        lg: {
+            content: string;
+        };
+    };
+}, {
+    overlay: string[];
+    content: string[];
+    title: string;
+    description: string;
+    closeButton: string[];
+    body: string;
+    actions: string;
+}, import("tailwind-variants").TVReturnType<{
+    size: {
+        sm: {
+            content: string;
+        };
+        md: {
+            content: string;
+        };
+        lg: {
+            content: string;
+        };
+    };
+}, {
+    overlay: string[];
+    content: string[];
+    title: string;
+    description: string;
+    closeButton: string[];
+    body: string;
+    actions: string;
+}, undefined, unknown, unknown, undefined>>;
+export type DialogVariants = VariantProps<typeof dialogVariants>;
+//# sourceMappingURL=dialog.variants.d.ts.map

package/dist/src/components/Dialog/dialog.variants.d.ts.map

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

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

@@ -0,0 +1,32 @@
+import type { PaginationProps } from './pagination.types.js';
+/**
+ * Dashforge TW `<Pagination>` — controlled pagination primitive.
+ *
+ * Three variants:
+ *  - `default`  — page-size selector + summary + page numbers + nav buttons + jump input
+ *  - `compact`  — page numbers + nav buttons only (no summary, no selector, no jump)
+ *  - `minimal`  — "Page X of Y" + prev/next only
+ *
+ * Always controlled (no internal state besides the jump-input draft).
+ *
+ * A11Y:
+ *  - `<nav aria-label="Pagination">` root
+ *  - `aria-current="page"` on the active page button
+ *  - `aria-label` on every interactive element
+ *
+ * @example
+ * ```tsx
+ * const [page, setPage] = useState(1);
+ * const [pageSize, setPageSize] = useState(20);
+ *
+ * <Pagination
+ *   page={page}
+ *   pageSize={pageSize}
+ *   totalCount={1437}
+ *   onPageChange={setPage}
+ *   onPageSizeChange={setPageSize}
+ * />
+ * ```
+ */
+export declare function Pagination(props: PaginationProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Pagination.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Pagination.d.ts","sourceRoot":"","sources":["../../../../src/components/Pagination/Pagination.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,uBAAuB,CAAC;AAgB/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,2CAiOhD"}

package/dist/src/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/src/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/src/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/src/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"}