@cloudflare/kumo 1.3.0 → 1.4.0

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

@@ -1,3 +1,4 @@
+/** Pagination controls variant definitions. */
 export declare const KUMO_PAGINATION_VARIANTS: {
     readonly controls: {
         readonly full: {
@@ -18,11 +19,35 @@ export interface KumoPaginationVariantsProps {
     controls?: KumoPaginationControls;
 }
 export declare function paginationVariants({ controls, }?: KumoPaginationVariantsProps): string;
+/**
+ * Pagination component props.
+ *
+ * @example
+ * ```tsx
+ * <Pagination page={page} setPage={setPage} perPage={10} totalCount={100} />
+ * <Pagination page={page} setPage={setPage} perPage={10} totalCount={100} controls="simple" />
+ * ```
+ */
 export interface PaginationProps extends KumoPaginationVariantsProps {
+    /** Callback fired when the current page changes. */
     setPage: (page: number) => void;
+    /**
+     * Current page number (1-indexed).
+     * @default 1
+     */
     page?: number;
+    /** Number of items displayed per page. */
     perPage?: number;
+    /** Total number of items across all pages. */
     totalCount?: number;
 }
+/**
+ * Page navigation controls with page count display.
+ *
+ * @example
+ * ```tsx
+ * <Pagination page={page} setPage={setPage} perPage={10} totalCount={100} />
+ * ```
+ */
 export declare function Pagination({ page, perPage, totalCount, setPage, controls, }: PaginationProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=pagination.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../../src/components/pagination/pagination.tsx"],"names":[],"mappings":"AAUA,eAAO,MAAM,wBAAwB;;;;;;;;;;;CAa3B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAChC,MAAM,OAAO,wBAAwB,CAAC,QAAQ,CAAC;AAEjD,eAAO,MAAM,gCAAgC;;CAEnC,CAAC;AAEX,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACnC;AAED,wBAAgB,kBAAkB,CAAC,EACjC,QAAoD,GACrD,GAAE,2BAAgC,UAKlC;AAED,MAAM,WAAW,eAAgB,SAAQ,2BAA2B;IAClE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,UAAU,CAAC,EACzB,IAAQ,EACR,OAAO,EACP,UAAU,EACV,OAAO,EACP,QAAoD,GACrD,EAAE,eAAe,2CAsGjB"}
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../../src/components/pagination/pagination.tsx"],"names":[],"mappings":"AAUA,+CAA+C;AAC/C,eAAO,MAAM,wBAAwB;;;;;;;;;;;CAa3B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAChC,MAAM,OAAO,wBAAwB,CAAC,QAAQ,CAAC;AAEjD,eAAO,MAAM,gCAAgC;;CAEnC,CAAC;AAEX,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACnC;AAED,wBAAgB,kBAAkB,CAAC,EACjC,QAAoD,GACrD,GAAE,2BAAgC,UAKlC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAgB,SAAQ,2BAA2B;IAClE,oDAAoD;IACpD,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EACzB,IAAQ,EACR,OAAO,EACP,UAAU,EACV,OAAO,EACP,QAAoD,GACrD,EAAE,eAAe,2CAsGjB"}

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

@@ -1,5 +1,6 @@
 import { Popover as PopoverBase } from '@base-ui/react/popover';
 import { ComponentPropsWithoutRef, ReactNode } from 'react';
+/** Popover side variant definitions mapping positions to their Tailwind classes. */
 export declare const KUMO_POPOVER_VARIANTS: {
     readonly side: {
         readonly top: {
@@ -25,6 +26,14 @@ export declare const KUMO_POPOVER_DEFAULT_VARIANTS: {
 };
 export type KumoPopoverSide = keyof typeof KUMO_POPOVER_VARIANTS.side;
 export interface KumoPopoverVariantsProps {
+    /**
+     * Which side of the trigger the popover appears on.
+     * - `"top"` — Above the trigger
+     * - `"bottom"` — Below the trigger
+     * - `"left"` — Left of the trigger
+     * - `"right"` — Right of the trigger
+     * @default "bottom"
+     */
     side?: KumoPopoverSide;
 }
 type BasePopoverRootProps = ComponentPropsWithoutRef<typeof PopoverBase.Root>;
@@ -44,16 +53,35 @@ declare namespace PopoverTrigger {
 }
 /** Alignment options for popover positioning */
 type PopoverAlign = "start" | "center" | "end";
+/**
+ * Popover content panel props.
+ *
+ * @example
+ * ```tsx
+ * <Popover.Content side="top" align="start" sideOffset={12}>
+ *   <p>Popover body</p>
+ * </Popover.Content>
+ * ```
+ */
 export type PopoverContentProps = KumoPopoverVariantsProps & {
-    /** How to align the popover relative to the trigger */
+    /**
+     * How to align the popover relative to the trigger.
+     * @default "center"
+     */
     align?: PopoverAlign;
-    /** Distance between the trigger and the popover in pixels */
+    /**
+     * Distance between the trigger and the popover in pixels.
+     * @default 8
+     */
     sideOffset?: number;
-    /** Additional offset along the alignment axis in pixels */
+    /**
+     * Additional offset along the alignment axis in pixels.
+     * @default 0
+     */
     alignOffset?: number;
-    /** Additional class name for the popup */
+    /** Additional CSS classes merged via `cn()`. */
     className?: string;
-    /** Content to render inside the popover */
+    /** Content to render inside the popover. */
     children?: ReactNode;
 };
 declare function PopoverContent({ children, side, align, sideOffset, alignOffset, className, }: PopoverContentProps): import("react/jsx-runtime").JSX.Element;

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

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

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

@@ -1,4 +1,5 @@
 import { ReactNode } from 'react';
+/** Radio variant definitions mapping variant names to their Tailwind classes. */
 export declare const KUMO_RADIO_VARIANTS: {
     readonly variant: {
         readonly default: {
@@ -16,6 +17,12 @@ export declare const KUMO_RADIO_DEFAULT_VARIANTS: {
 };
 export type KumoRadioVariant = keyof typeof KUMO_RADIO_VARIANTS.variant;
 export interface KumoRadioVariantsProps {
+    /**
+     * Visual variant.
+     * - `"default"` — Standard radio appearance
+     * - `"error"` — Error state for validation failures
+     * @default "default"
+     */
     variant?: KumoRadioVariant;
 }
 export declare function radioVariants({ variant, }?: KumoRadioVariantsProps): string;
@@ -134,6 +141,21 @@ declare namespace RadioGroup {
     var displayName: string;
 }
 export { RadioGroup };
+/**
+ * Radio — radio button group for single-select choices.
+ *
+ * Compound component: `Radio.Group` (with built-in Fieldset) and `Radio.Item`.
+ * Built on `@base-ui/react/radio-group` + `@base-ui/react/radio`.
+ *
+ * @example
+ * ```tsx
+ * <Radio.Group legend="Notification preference" defaultValue="email">
+ *   <Radio.Item label="Email" value="email" />
+ *   <Radio.Item label="SMS" value="sms" />
+ *   <Radio.Item label="Push" value="push" />
+ * </Radio.Group>
+ * ```
+ */
 export declare const Radio: {
     Item: import('react').ForwardRefExoticComponent<RadioItemProps & import('react').RefAttributes<HTMLButtonElement>>;
     Group: typeof RadioGroup;

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

@@ -1 +1 @@
-{"version":3,"file":"radio.d.ts","sourceRoot":"","sources":["../../../../src/components/radio/radio.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAM9E,eAAO,MAAM,mBAAmB;;;;;;;;;;;CAWtB,CAAC;AAEX,eAAO,MAAM,2BAA2B;;CAE9B,CAAC;AAGX,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,mBAAmB,CAAC,OAAO,CAAC;AAExE,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED,wBAAgB,aAAa,CAAC,EAC5B,OAA6C,GAC9C,GAAE,sBAA2B,UAE7B;AAGD,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAE5C,0DAA0D;AAC1D,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,KAAK,CAAC;AASnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,QAAQ,EAAE,SAAS,CAAC;IACpB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;IACxC,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4HAA4H;IAC5H,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,mEAAmE;IACnE,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AA2CF,iBAAS,UAAU,CAAC,EAClB,MAAM,EACN,QAAQ,EACR,WAAwB,EACxB,KAAK,EACL,WAAW,EACX,YAAY,EACZ,KAAK,EACL,aAAa,EACb,QAAQ,EACR,eAAyB,EACzB,IAAI,EACJ,SAAS,GACV,EAAE,eAAe,2CAiCjB;kBA9CQ,UAAU;;;AAmDnB,OAAO,EAAE,UAAU,EAAE,CAAC;AAGtB,eAAO,MAAM,KAAK;;;CAGjB,CAAC"}
+{"version":3,"file":"radio.d.ts","sourceRoot":"","sources":["../../../../src/components/radio/radio.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAM9E,iFAAiF;AACjF,eAAO,MAAM,mBAAmB;;;;;;;;;;;CAWtB,CAAC;AAEX,eAAO,MAAM,2BAA2B;;CAE9B,CAAC;AAGX,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,mBAAmB,CAAC,OAAO,CAAC;AAExE,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED,wBAAgB,aAAa,CAAC,EAC5B,OAA6C,GAC9C,GAAE,sBAA2B,UAE7B;AAGD,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAE5C,0DAA0D;AAC1D,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,KAAK,CAAC;AASnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,QAAQ,EAAE,SAAS,CAAC;IACpB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;IACxC,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4HAA4H;IAC5H,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,mEAAmE;IACnE,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AA2CF,iBAAS,UAAU,CAAC,EAClB,MAAM,EACN,QAAQ,EACR,WAAwB,EACxB,KAAK,EACL,WAAW,EACX,YAAY,EACZ,KAAK,EACL,aAAa,EACb,QAAQ,EACR,eAAyB,EACzB,IAAI,EACJ,SAAS,GACV,EAAE,eAAe,2CAiCjB;kBA9CQ,UAAU;;;AAmDnB,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,KAAK;;;CAGjB,CAAC"}

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

@@ -1,6 +1,7 @@
 import { Select as SelectBase } from '@base-ui/react/select';
 import { ReactNode } from 'react';
 import { FieldErrorMatch } from '../field/field';
+/** Select variant definitions (currently empty, reserved for future additions). */
 export declare const KUMO_SELECT_VARIANTS: {};
 export declare const KUMO_SELECT_DEFAULT_VARIANTS: {};
 /**
@@ -59,6 +60,7 @@ type SelectPropsGeneric<T, Multiple extends boolean | undefined = false> = Selec
     className?: string;
     /** Label content for the select (enables Field wrapper) - can be a string or any React node */
     label?: ReactNode;
+    /** Visually hide the label (sr-only). Set to `false` for a visible label. @default true */
     hideLabel?: boolean;
     placeholder?: string;
     loading?: boolean;
@@ -73,47 +75,67 @@ type SelectPropsGeneric<T, Multiple extends boolean | undefined = false> = Selec
     };
 };
 /**
- * Props for the Select component.
- * @description A dropdown select component for choosing from a list of options.
- * @property {ReactNode} [label] - Label content for the select (enables Field wrapper)
- * @property {ReactNode} [description] - Helper text displayed below the select
- * @property {string | { message: ReactNode, match: FieldErrorMatch }} [error] - Error message or validation error object
+ * Select component props.
+ *
+ * @example
+ * ```tsx
+ * <Select label="Country" onValueChange={setValue}>
+ *   <Select.Option value="us">United States</Select.Option>
+ *   <Select.Option value="uk">United Kingdom</Select.Option>
+ * </Select>
+ * ```
  */
 export interface SelectProps {
-    /** Additional CSS classes */
+    /** Additional CSS classes merged via `cn()`. */
     className?: string;
-    /** Label content for the select (enables Field wrapper) - can be a string or any React node */
+    /** Label content for the select (enables Field wrapper) — can be a string or any React node. */
     label?: ReactNode;
-    /** Whether to visually hide the label (still accessible to screen readers) */
+    /**
+     * Visually hide the label while keeping it accessible to screen readers.
+     * Set to `false` to show a visible label above the select via the Field wrapper.
+     * @default true
+     */
     hideLabel?: boolean;
-    /** Placeholder text when no value is selected */
+    /** Placeholder text shown when no value is selected. */
     placeholder?: string;
-    /** Whether the select is in a loading state */
+    /** When `true`, shows a skeleton loader in place of the selected value. */
     loading?: boolean;
-    /** Whether the select is disabled */
+    /** Whether the select is disabled. */
     disabled?: boolean;
-    /** Whether the select is required */
+    /** Whether the select is required. When `false`, shows "(optional)" text. */
     required?: boolean;
-    /** Tooltip content to display next to the label via an info icon */
+    /** Tooltip content displayed next to the label via an info icon. */
     labelTooltip?: ReactNode;
-    /** The currently selected value */
+    /** Currently selected value (controlled mode). */
     value?: unknown;
-    /** Default value for uncontrolled usage */
+    /** Initial value for uncontrolled mode. */
     defaultValue?: unknown;
-    /** Callback when the value changes */
+    /** Callback fired when the selected value changes. */
     onValueChange?: (value: unknown) => void;
-    /** Whether multiple selection is enabled */
+    /** Enable multi-select mode. */
     multiple?: boolean;
-    /** Child elements (Select.Option components) */
+    /** `Select.Option` elements to render in the dropdown. */
     children?: ReactNode;
-    /** Helper text displayed below the select */
+    /** Helper text displayed below the select. */
     description?: ReactNode;
-    /** Error message or validation error object */
+    /** Error message string or validation error object with `match` key. */
     error?: string | {
         message: ReactNode;
         match: FieldErrorMatch;
     };
 }
+/**
+ * Dropdown for selecting a value from a list of options.
+ * Wraps Base UI Select with Kumo styling and optional Field integration.
+ *
+ * @example
+ * ```tsx
+ * <Select label="Fruit" onValueChange={setFruit}>
+ *   <Select.Option value="apple">Apple</Select.Option>
+ *   <Select.Option value="banana">Banana</Select.Option>
+ * </Select>
+ * ```
+ */
 export declare function Select<T, Multiple extends boolean | undefined = false>({ children, className, renderValue, label, hideLabel, placeholder, loading, labelTooltip, description, error, required, ...props }: SelectPropsGeneric<T, Multiple> & {
     required?: boolean;
 }): import("react/jsx-runtime").JSX.Element;

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

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

package/dist/src/components/sensitive-input/sensitive-input.d.ts

@@ -36,10 +36,13 @@ export declare const KUMO_SENSITIVE_INPUT_DEFAULT_VARIANTS: {
     readonly variant: "default";
 };
 /**
- * SensitiveInput component props
- * @property {ReactNode} [label] - Label content for the input (enables Field wrapper)
- * @property {ReactNode} [description] - Helper text displayed below the input
- * @property {string | { message: ReactNode, match: FieldErrorMatch }} [error] - Error message or validation error object
+ * SensitiveInput component props.
+ *
+ * @example
+ * ```tsx
+ * <SensitiveInput label="API Key" defaultValue="sk_live_abc123xyz789" />
+ * <SensitiveInput label="Secret" value={secret} onValueChange={setSecret} />
+ * ```
  */
 export interface SensitiveInputProps extends Omit<ComponentPropsWithoutRef<"input">, "size" | "type" | "value" | "defaultValue"> {
     /** Controlled value */
@@ -50,9 +53,21 @@ export interface SensitiveInputProps extends Omit<ComponentPropsWithoutRef<"inpu
     onValueChange?: (value: string) => void;
     /** Callback fired after value is copied to clipboard */
     onCopy?: () => void;
-    /** Size variant */
+    /**
+     * Size of the input.
+     * - `"xs"` — Extra small for compact UIs
+     * - `"sm"` — Small for secondary fields
+     * - `"base"` — Default input size
+     * - `"lg"` — Large for prominent fields
+     * @default "base"
+     */
     size?: KumoInputSize;
-    /** Style variant */
+    /**
+     * Style variant of the input.
+     * - `"default"` — Default input appearance
+     * - `"error"` — Error state for validation failures
+     * @default "default"
+     */
     variant?: KumoInputVariant;
     /** Label content for the input (enables Field wrapper and sets masked state label) - can be a string or any React node */
     label?: ReactNode;
@@ -66,5 +81,14 @@ export interface SensitiveInputProps extends Omit<ComponentPropsWithoutRef<"inpu
         match: FieldErrorMatch;
     };
 }
+/**
+ * Password/secret input that masks its value by default and reveals on click.
+ * Includes a built-in copy-to-clipboard button on hover.
+ *
+ * @example
+ * ```tsx
+ * <SensitiveInput label="API Key" defaultValue="sk_live_abc123xyz789" />
+ * ```
+ */
 export declare const SensitiveInput: import('react').ForwardRefExoticComponent<SensitiveInputProps & import('react').RefAttributes<HTMLInputElement>>;
 //# sourceMappingURL=sensitive-input.d.ts.map

package/dist/src/components/sensitive-input/sensitive-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sensitive-input.d.ts","sourceRoot":"","sources":["../../../../src/components/sensitive-input/sensitive-input.tsx"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,wBAAwB,EAC7B,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAS,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE7D,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAsB,CAAC;AAEjE,eAAO,MAAM,qCAAqC;;;CAGxC,CAAC;AAIX;;;;;GAKG;AACH,MAAM,WAAW,mBACf,SAAQ,IAAI,CACV,wBAAwB,CAAC,OAAO,CAAC,EACjC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,cAAc,CAC3C;IACD,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,mBAAmB;IACnB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,oBAAoB;IACpB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,0HAA0H;IAC1H,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,oEAAoE;IACpE,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,eAAe,CAAA;KAAE,CAAC;CACjE;AAED,eAAO,MAAM,cAAc,kHAkZ1B,CAAC"}
+{"version":3,"file":"sensitive-input.d.ts","sourceRoot":"","sources":["../../../../src/components/sensitive-input/sensitive-input.tsx"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,wBAAwB,EAC7B,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAS,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE7D,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAsB,CAAC;AAEjE,eAAO,MAAM,qCAAqC;;;CAGxC,CAAC;AAIX;;;;;;;;GAQG;AACH,MAAM,WAAW,mBACf,SAAQ,IAAI,CACV,wBAAwB,CAAC,OAAO,CAAC,EACjC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,cAAc,CAC3C;IACD,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,0HAA0H;IAC1H,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,oEAAoE;IACpE,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,eAAe,CAAA;KAAE,CAAC;CACjE;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,kHAkZ1B,CAAC"}

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

@@ -1,4 +1,5 @@
 import { default as React, ComponentPropsWithoutRef, ComponentPropsWithRef, ElementType, PropsWithChildren } from 'react';
+/** Surface color variant definitions. */
 export declare const KUMO_SURFACE_VARIANTS: {
     readonly color: {
         readonly primary: {
@@ -16,6 +17,12 @@ export declare const KUMO_SURFACE_DEFAULT_VARIANTS: {
 };
 export type KumoSurfaceColor = keyof typeof KUMO_SURFACE_VARIANTS.color;
 export interface KumoSurfaceVariantsProps {
+    /**
+     * Surface color variant.
+     * - `"primary"` — Primary surface color
+     * - `"secondary"` — Secondary surface color
+     * @default "primary"
+     */
     color?: KumoSurfaceColor;
 }
 export declare function surfaceVariants({ color, }?: KumoSurfaceVariantsProps): string;
@@ -27,17 +34,22 @@ type PolymorphicRef<E extends ElementType> = ComponentPropsWithRef<E>["ref"];
 declare const defaultElement = "div";
 type SurfacePropsGeneric<E extends ElementType = typeof defaultElement> = PolymorphicProps<E> & KumoSurfaceVariantsProps;
 /**
- * Props for the Surface component.
- * @description A polymorphic container component for creating elevated surfaces with consistent styling.
+ * Surface component props.
+ *
+ * @example
+ * ```tsx
+ * <Surface className="rounded-lg p-4">Card content</Surface>
+ * <Surface as="section" className="rounded-lg p-6">Section content</Surface>
+ * ```
  */
 export interface SurfaceProps {
-    /** The element type to render as (default: "div") */
+    /** The HTML element type to render as (e.g. `"div"`, `"section"`, `"article"`). @default "div" */
     as?: ElementType;
-    /** Surface color variant */
+    /** Surface color variant. @default "primary" */
     color?: KumoSurfaceColor;
-    /** Additional CSS classes */
+    /** Additional CSS classes merged via `cn()`. */
     className?: string;
-    /** Child elements */
+    /** Content rendered inside the surface. */
     children?: React.ReactNode;
 }
 type SurfaceComponent = <E extends ElementType = typeof defaultElement>(props: SurfacePropsGeneric<E> & {

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

@@ -1 +1 @@
-{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../../../../src/components/surface/surface.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAEZ,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACvB,MAAM,OAAO,CAAC;AAGf,eAAO,MAAM,qBAAqB;;;;;;;;;;;CAWxB,CAAC;AAEX,eAAO,MAAM,6BAA6B;;CAEhC,CAAC;AAGX,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,qBAAqB,CAAC,KAAK,CAAC;AAExE,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED,wBAAgB,eAAe,CAAC,EAC9B,KAA2C,GAC5C,GAAE,wBAA6B,UAO/B;AAED,KAAK,iBAAiB,CAAC,CAAC,SAAS,WAAW,IAAI;IAC9C,EAAE,CAAC,EAAE,CAAC,CAAC;CACR,CAAC;AAEF,KAAK,gBAAgB,CAAC,CAAC,SAAS,WAAW,IAAI,iBAAiB,CAC9D,wBAAwB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CACnD,CAAC;AAEF,KAAK,cAAc,CAAC,CAAC,SAAS,WAAW,IAAI,qBAAqB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAE7E,QAAA,MAAM,cAAc,QAAQ,CAAC;AAE7B,KAAK,mBAAmB,CAAC,CAAC,SAAS,WAAW,GAAG,OAAO,cAAc,IACpE,gBAAgB,CAAC,CAAC,CAAC,GAAG,wBAAwB,CAAC;AAEjD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,EAAE,CAAC,EAAE,WAAW,CAAC;IACjB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,KAAK,gBAAgB,GAAG,CAAC,CAAC,SAAS,WAAW,GAAG,OAAO,cAAc,EACpE,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;CAAE,KACxD,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC;AAoBvB,eAAO,MAAM,OAAO,EAEJ,gBAAgB,CAAC"}
+{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../../../../src/components/surface/surface.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAEZ,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACvB,MAAM,OAAO,CAAC;AAGf,yCAAyC;AACzC,eAAO,MAAM,qBAAqB;;;;;;;;;;;CAWxB,CAAC;AAEX,eAAO,MAAM,6BAA6B;;CAEhC,CAAC;AAGX,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,qBAAqB,CAAC,KAAK,CAAC;AAExE,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED,wBAAgB,eAAe,CAAC,EAC9B,KAA2C,GAC5C,GAAE,wBAA6B,UAO/B;AAED,KAAK,iBAAiB,CAAC,CAAC,SAAS,WAAW,IAAI;IAC9C,EAAE,CAAC,EAAE,CAAC,CAAC;CACR,CAAC;AAEF,KAAK,gBAAgB,CAAC,CAAC,SAAS,WAAW,IAAI,iBAAiB,CAC9D,wBAAwB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CACnD,CAAC;AAEF,KAAK,cAAc,CAAC,CAAC,SAAS,WAAW,IAAI,qBAAqB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAE7E,QAAA,MAAM,cAAc,QAAQ,CAAC;AAE7B,KAAK,mBAAmB,CAAC,CAAC,SAAS,WAAW,GAAG,OAAO,cAAc,IACpE,gBAAgB,CAAC,CAAC,CAAC,GAAG,wBAAwB,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,kGAAkG;IAClG,EAAE,CAAC,EAAE,WAAW,CAAC;IACjB,gDAAgD;IAChD,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,KAAK,gBAAgB,GAAG,CAAC,CAAC,SAAS,WAAW,GAAG,OAAO,cAAc,EACpE,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;CAAE,KACxD,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC;AA4BvB,eAAO,MAAM,OAAO,EAEJ,gBAAgB,CAAC"}

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

@@ -1,4 +1,5 @@
 import { ButtonHTMLAttributes, ReactNode } from 'react';
+/** Switch size and variant definitions mapping names to their Tailwind classes. */
 export declare const KUMO_SWITCH_VARIANTS: {
     readonly size: {
         readonly sm: {
@@ -32,7 +33,20 @@ export declare const KUMO_SWITCH_DEFAULT_VARIANTS: {
 export type KumoSwitchSize = keyof typeof KUMO_SWITCH_VARIANTS.size;
 export type KumoSwitchVariant = keyof typeof KUMO_SWITCH_VARIANTS.variant;
 export interface KumoSwitchVariantsProps {
+    /**
+     * Switch size.
+     * - `"sm"` — Small for compact UIs
+     * - `"base"` — Default size
+     * - `"lg"` — Large for prominent toggles
+     * @default "base"
+     */
     size?: KumoSwitchSize;
+    /**
+     * Visual variant.
+     * - `"default"` — Standard switch appearance
+     * - `"error"` — Error state for validation failures
+     * @default "default"
+     */
     variant?: KumoSwitchVariant;
 }
 export declare function switchVariants({ size, variant, }?: KumoSwitchVariantsProps): string;

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

@@ -1 +1 @@
-{"version":3,"file":"switch.d.ts","sourceRoot":"","sources":["../../../../src/components/switch/switch.tsx"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,oBAAoB,EAEzB,KAAK,SAAS,EAGf,MAAM,OAAO,CAAC;AAKf,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;CAyBvB,CAAC;AAEX,eAAO,MAAM,4BAA4B;;;CAG/B,CAAC;AAGX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,oBAAoB,CAAC,IAAI,CAAC;AACpE,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,oBAAoB,CAAC,OAAO,CAAC;AAE1E,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED,wBAAgB,cAAc,CAAC,EAC7B,IAAwC,EACxC,OAA8C,GAC/C,GAAE,uBAA4B,UAK9B;AAGD,MAAM,MAAM,UAAU,GAAG,cAAc,CAAC;AACxC,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAO9C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAC5B,oBAAoB,CAAC,iBAAiB,CAAC,EACvC,UAAU,CACX,GAAG;IACF,gGAAgG;IAChG,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,4JAA4J;IAC5J,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,oEAAoE;IACpE,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iGAAiG;IACjG,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,QAAQ,EAAE,SAAS,CAAC;IACpB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iGAAiG;IACjG,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,mEAAmE;IACnE,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AA0OF,iBAAS,WAAW,CAAC,EACnB,MAAM,EACN,QAAQ,EACR,KAAK,EACL,WAAW,EACX,QAAQ,EACR,YAAmB,EACnB,SAAS,GACV,EAAE,gBAAgB,2CAmBlB;AAGD,eAAO,MAAM,MAAM;IA1UjB,gGAAgG;cACtF,aAAa;IACvB,4JAA4J;YACpJ,SAAS;IACjB,oEAAoE;mBACrD,SAAS;IACxB;;;OAGG;eACQ,OAAO;IAClB,iGAAiG;mBAClF,OAAO;WACf,cAAc;cACX,OAAO;eACN,OAAO;sBACA,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI;oBAC5B,OAAO;;;;CA4TvB,CAAC"}
+{"version":3,"file":"switch.d.ts","sourceRoot":"","sources":["../../../../src/components/switch/switch.tsx"],"names":[],"mappings":"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"}

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

@@ -1,3 +1,4 @@
+/** Table layout and row variant definitions mapping names to their Tailwind classes. */
 export declare const KUMO_TABLE_VARIANTS: {
     readonly layout: {
         readonly auto: {
@@ -26,7 +27,39 @@ export declare const KUMO_TABLE_DEFAULT_VARIANTS: {
 };
 export type KumoTableRowVariant = keyof typeof KUMO_TABLE_VARIANTS.variant;
 export type KumoTableLayout = keyof typeof KUMO_TABLE_VARIANTS.layout;
+/**
+ * Table — semantic HTML table with styled rows, cells, and selection support.
+ *
+ * Compound component: `Table` (Root), `.Header`, `.Head`, `.Body`, `.Row`,
+ * `.Cell`, `.Footer`, `.CheckCell`, `.CheckHead`, `.ResizeHandle`.
+ *
+ * @example
+ * ```tsx
+ * <Table>
+ *   <Table.Header>
+ *     <Table.Row>
+ *       <Table.CheckHead checked={allSelected} onValueChange={toggleAll} />
+ *       <Table.Head>Name</Table.Head>
+ *     </Table.Row>
+ *   </Table.Header>
+ *   <Table.Body>
+ *     {rows.map((row) => (
+ *       <Table.Row key={row.id} variant={selected.has(row.id) ? "selected" : "default"}>
+ *         <Table.CheckCell checked={selected.has(row.id)} onValueChange={() => toggle(row.id)} />
+ *         <Table.Cell>{row.name}</Table.Cell>
+ *       </Table.Row>
+ *     ))}
+ *   </Table.Body>
+ * </Table>
+ * ```
+ */
 export declare const Table: import('react').ForwardRefExoticComponent<import('react').HTMLAttributes<HTMLTableElement> & {
+    /**
+     * Table layout algorithm.
+     * - `"auto"` — columns resize based on content
+     * - `"fixed"` — equal-width columns, controlled via `<colgroup>`
+     * @default "auto"
+     */
     layout?: KumoTableLayout;
 } & import('react').RefAttributes<HTMLTableElement>> & {
     Header: import('react').ForwardRefExoticComponent<import('react').HTMLAttributes<HTMLTableSectionElement> & import('react').RefAttributes<HTMLTableSectionElement>>;

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

@@ -1 +1 @@
-{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../../src/components/table/table.tsx"],"names":[],"mappings":"AAIA,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;CAsBtB,CAAC;AAEX,eAAO,MAAM,2BAA2B;;;CAG9B,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,mBAAmB,CAAC,OAAO,CAAC;AAC3E,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,mBAAmB,CAAC,MAAM,CAAC;AAuLtE,eAAO,MAAM,KAAK;aAlLL,eAAe;;;;;kBAmCd,mBAAmB;;;;;kBA+DnB,OAAO;wBACD,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI;gBAClC,MAAM;mBACH,OAAO;;;kBAiCR,OAAO;wBACD,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI;gBAClC,MAAM;mBACH,OAAO;;;;CAmDpB,CAAC"}
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../../src/components/table/table.tsx"],"names":[],"mappings":"AAIA,wFAAwF;AACxF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;CAsBtB,CAAC;AAEX,eAAO,MAAM,2BAA2B;;;CAG9B,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,mBAAmB,CAAC,OAAO,CAAC;AAC3E,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,mBAAmB,CAAC,MAAM,CAAC;AAkNtE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,KAAK;IAlNd;;;;;OAKG;aACM,eAAe;;;;;kBAmCd,mBAAmB;;;;;kBA+DnB,OAAO;wBACD,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI;gBAClC,MAAM;mBACH,OAAO;;;kBAiCR,OAAO;wBACD,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI;gBAClC,MAAM;mBACH,OAAO;;;;CA6EpB,CAAC"}

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

@@ -1,4 +1,5 @@
 import { ReactNode } from 'react';
+/** Tabs variant definitions. */
 export declare const KUMO_TABS_VARIANTS: {
     readonly variant: readonly ["segmented", "underline"];
 };
@@ -29,36 +30,74 @@ export declare const KUMO_TABS_STYLING: {
     };
 };
 export interface KumoTabsVariantsProps {
+    /**
+     * Tab style.
+     * - `"segmented"` — Pill-shaped indicator on a filled track
+     * - `"underline"` — Underline indicator below tab text
+     * @default "segmented"
+     */
     variant?: (typeof KUMO_TABS_VARIANTS.variant)[number];
 }
+/** Configuration for a single tab within the Tabs component. */
 export type TabsItem = {
+    /** Unique identifier for the tab, used as the controlled value. */
     value: string;
+    /** Display content for the tab trigger. */
     label: ReactNode;
+    /** Additional CSS classes for this tab trigger. */
     className?: string;
-    /** Optional render function to customize the tab element (e.g., for links) */
+    /** Custom render function to replace the tab element (e.g. for link-based tabs). */
     render?: (props: Record<string, unknown>) => React.ReactElement;
 };
+/**
+ * Tabs component props.
+ *
+ * @example
+ * ```tsx
+ * <Tabs
+ *   tabs={[
+ *     { value: "overview", label: "Overview" },
+ *     { value: "settings", label: "Settings" },
+ *   ]}
+ *   value={activeTab}
+ *   onValueChange={setActiveTab}
+ * />
+ * ```
+ */
 export type TabsProps = KumoTabsVariantsProps & {
-    /** Array of tab items to render */
+    /** Array of tab items to render. */
     tabs?: TabsItem[];
     /** Controlled value. When set, component becomes controlled. */
     value?: string;
     /** Default selected value for uncontrolled mode. Ignored when `value` is set. */
     selectedValue?: string;
-    /** Callback fired when the active tab changes */
+    /** Callback fired when the active tab changes. */
     onValueChange?: (value: string) => void;
     /**
-     * When true, tabs are activated immediately upon receiving focus via arrow keys.
-     * When false (default), tabs receive focus but require Enter/Space to activate.
-     * Set to true for better keyboard UX in most cases.
+     * When `true`, tabs are activated immediately upon receiving focus via arrow keys.
+     * When `false` (default), tabs receive focus but require Enter/Space to activate.
      */
     activateOnFocus?: boolean;
-    /** Additional class name for the root element */
+    /** Additional CSS classes for the root element. */
     className?: string;
-    /** Additional class name for the tab list element */
+    /** Additional CSS classes for the tab list element. */
     listClassName?: string;
-    /** Additional class name for the indicator element */
+    /** Additional CSS classes for the indicator element. */
     indicatorClassName?: string;
 };
+/**
+ * Tab navigation component with segmented or underline style.
+ * Built on Base UI Tabs with animated active indicator.
+ *
+ * @example
+ * ```tsx
+ * <Tabs
+ *   variant="segmented"
+ *   tabs={[{ value: "tab1", label: "Tab 1" }, { value: "tab2", label: "Tab 2" }]}
+ *   value={active}
+ *   onValueChange={setActive}
+ * />
+ * ```
+ */
 export declare function Tabs({ tabs, value, selectedValue, onValueChange, activateOnFocus, className, listClassName, indicatorClassName, variant, }: TabsProps): import("react/jsx-runtime").JSX.Element | null;
 //# sourceMappingURL=tabs.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../../../src/components/tabs/tabs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,eAAO,MAAM,kBAAkB;;CAErB,CAAC;AAEX,eAAO,MAAM,0BAA0B;;CAE7B,CAAC;AAEX,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;CAsBpB,CAAC;AAGX,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,CAAC,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;CACvD;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,KAAK,CAAC,YAAY,CAAC;CACjE,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,qBAAqB,GAAG;IAC9C,mCAAmC;IACnC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;IAClB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,wBAAgB,IAAI,CAAC,EACnB,IAAI,EACJ,KAAK,EACL,aAAa,EACb,aAAa,EACb,eAAe,EACf,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,OAA4C,GAC7C,EAAE,SAAS,kDAqEX"}
+{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../../../src/components/tabs/tabs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,gCAAgC;AAChC,eAAO,MAAM,kBAAkB;;CAErB,CAAC;AAEX,eAAO,MAAM,0BAA0B;;CAE7B,CAAC;AAEX,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;CAsBpB,CAAC;AAGX,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;CACvD;AAED,gEAAgE;AAChE,MAAM,MAAM,QAAQ,GAAG;IACrB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,KAAK,EAAE,SAAS,CAAC;IACjB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,KAAK,CAAC,YAAY,CAAC;CACjE,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,SAAS,GAAG,qBAAqB,GAAG;IAC9C,oCAAoC;IACpC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;IAClB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,EACnB,IAAI,EACJ,KAAK,EACL,aAAa,EACb,aAAa,EACb,eAAe,EACf,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,OAA4C,GAC7C,EAAE,SAAS,kDAqEX"}