@cloudflare/kumo 1.2.0 → 1.4.0

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

@@ -1,9 +1,10 @@
 import { CSSProperties, FC, ReactNode } from 'react';
 import { Dialog as DialogBase } from '@base-ui/react/dialog';
+/** Dialog size variant definitions mapping sizes to their minimum widths. */
 export declare const KUMO_DIALOG_VARIANTS: {
     readonly size: {
         readonly base: {
-            readonly classes: "min-w-96";
+            readonly classes: "sm:min-w-96";
             readonly description: "Default dialog width";
         };
         readonly sm: {
@@ -96,12 +97,38 @@ export declare const KUMO_DIALOG_STYLING: {
 };
 export type KumoDialogSize = keyof typeof KUMO_DIALOG_VARIANTS.size;
 export interface KumoDialogVariantsProps {
+    /**
+     * Dialog width.
+     * - `"sm"` — Small (min 288px) for simple confirmations
+     * - `"base"` — Default (min 384px)
+     * - `"lg"` — Large (min 512px) for complex content
+     * - `"xl"` — Extra large (min 768px) for detailed views
+     * @default "base"
+     */
     size?: KumoDialogSize;
 }
 export declare function dialogVariants({ size, }?: KumoDialogVariantsProps): string;
+/**
+ * Dialog component props — the modal content panel.
+ *
+ * @example
+ * ```tsx
+ * <Dialog.Root>
+ *   <Dialog.Trigger render={(p) => <Button {...p}>Open</Button>} />
+ *   <Dialog className="p-8">
+ *     <Dialog.Title>Confirm Action</Dialog.Title>
+ *     <Dialog.Description>Are you sure?</Dialog.Description>
+ *     <Dialog.Close render={(p) => <Button {...p}>Cancel</Button>} />
+ *   </Dialog>
+ * </Dialog.Root>
+ * ```
+ */
 export type DialogProps = KumoDialogVariantsProps & {
+    /** Additional CSS classes merged via `cn()`. */
     className?: string;
+    /** Dialog content (typically Title, Description, Close, and action buttons). */
     children: ReactNode;
+    /** Inline styles. */
     style?: CSSProperties;
 };
 type DialogComponent = FC<DialogProps> & {

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

@@ -1 +1 @@
-{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../../../src/components/dialog/dialog.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC1D,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAI7D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;CAmBvB,CAAC;AAEX,eAAO,MAAM,4BAA4B;;CAE/B,CAAC;AAEX,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDtB,CAAC;AAGX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,oBAAoB,CAAC,IAAI,CAAC;AAEpE,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAED,wBAAgB,cAAc,CAAC,EAC7B,IAAwC,GACzC,GAAE,uBAA4B,UAO9B;AAED,MAAM,MAAM,WAAW,GAAG,uBAAuB,GAAG;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,CAAC;AA+BF,KAAK,eAAe,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG;IACvC,IAAI,EAAE,OAAO,UAAU,CAAC,IAAI,CAAC;IAC7B,OAAO,EAAE,OAAO,UAAU,CAAC,OAAO,CAAC;IACnC,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAC/B,WAAW,EAAE,OAAO,UAAU,CAAC,WAAW,CAAC;IAC3C,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAChC,CAAC;AAEF,QAAA,MAAM,MAAM,EAMN,eAAe,CAAC;AAEtB,QAAA,MAAM,UAAU,wBAAc,CAAC;AAC/B,QAAA,MAAM,aAAa,oBAAiB,CAAC;AACrC,QAAA,MAAM,WAAW,mJAAe,CAAC;AACjC,QAAA,MAAM,iBAAiB,yJAAqB,CAAC;AAC7C,QAAA,MAAM,WAAW,gJAAe,CAAC;AAEjC,OAAO,EACL,MAAM,EACN,UAAU,EACV,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,WAAW,GACZ,CAAC"}
+{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../../../src/components/dialog/dialog.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC1D,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAI7D,6EAA6E;AAC7E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;CAmBvB,CAAC;AAEX,eAAO,MAAM,4BAA4B;;CAE/B,CAAC;AAEX,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDtB,CAAC;AAGX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,oBAAoB,CAAC,IAAI,CAAC;AAEpE,MAAM,WAAW,uBAAuB;IACtC;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAED,wBAAgB,cAAc,CAAC,EAC7B,IAAwC,GACzC,GAAE,uBAA4B,UAO9B;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,WAAW,GAAG,uBAAuB,GAAG;IAClD,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,QAAQ,EAAE,SAAS,CAAC;IACpB,qBAAqB;IACrB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,CAAC;AA+CF,KAAK,eAAe,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG;IACvC,IAAI,EAAE,OAAO,UAAU,CAAC,IAAI,CAAC;IAC7B,OAAO,EAAE,OAAO,UAAU,CAAC,OAAO,CAAC;IACnC,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAC/B,WAAW,EAAE,OAAO,UAAU,CAAC,WAAW,CAAC;IAC3C,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAChC,CAAC;AAEF,QAAA,MAAM,MAAM,EAMN,eAAe,CAAC;AAEtB,QAAA,MAAM,UAAU,wBAAc,CAAC;AAC/B,QAAA,MAAM,aAAa,oBAAiB,CAAC;AACrC,QAAA,MAAM,WAAW,mJAAe,CAAC;AACjC,QAAA,MAAM,iBAAiB,yJAAqB,CAAC;AAC7C,QAAA,MAAM,WAAW,gJAAe,CAAC;AAEjC,OAAO,EACL,MAAM,EACN,UAAU,EACV,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,WAAW,GACZ,CAAC"}

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

@@ -1,6 +1,7 @@
 import { Menu as DropdownMenuPrimitive } from '@base-ui/react/menu';
 import { Icon } from '@phosphor-icons/react';
 import * as React from "react";
+/** Dropdown item variant definitions (default and danger styles). */
 export declare const KUMO_DROPDOWN_VARIANTS: {
     readonly variant: {
         readonly default: {
@@ -18,9 +19,41 @@ export declare const KUMO_DROPDOWN_DEFAULT_VARIANTS: {
 };
 export type KumoDropdownVariant = keyof typeof KUMO_DROPDOWN_VARIANTS.variant;
 export interface KumoDropdownVariantsProps {
+    /**
+     * Visual style of the dropdown item.
+     * - `"default"` — Standard item appearance
+     * - `"danger"` — Destructive action with red text
+     * @default "default"
+     */
     variant?: KumoDropdownVariant;
 }
 export declare function dropdownVariants({ variant, }?: KumoDropdownVariantsProps): string;
+/**
+ * DropdownMenu — accessible dropdown menu anchored to a trigger.
+ *
+ * Compound component: `DropdownMenu` (Root), `.Trigger`, `.Content`, `.Item`,
+ * `.CheckboxItem`, `.RadioGroup`, `.RadioItem`, `.RadioItemIndicator`,
+ * `.Sub`, `.SubTrigger`, `.SubContent`, `.Label`, `.Separator`, `.Shortcut`, `.Group`.
+ *
+ * Built on `@base-ui/react/menu`.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenu>
+ *   <DropdownMenu.Trigger>
+ *     <Button>Actions</Button>
+ *   </DropdownMenu.Trigger>
+ *   <DropdownMenu.Content>
+ *     <DropdownMenu.Item>Edit</DropdownMenu.Item>
+ *     <DropdownMenu.Item icon={CopyIcon}>Duplicate</DropdownMenu.Item>
+ *     <DropdownMenu.Separator />
+ *     <DropdownMenu.Item variant="danger">Delete</DropdownMenu.Item>
+ *   </DropdownMenu.Content>
+ * </DropdownMenu>
+ * ```
+ *
+ * @see https://base-ui.com/react/components/menu
+ */
 export declare const DropdownMenu: typeof DropdownMenuPrimitive.Root & {
     Trigger: React.ForwardRefExoticComponent<Omit<import('@base-ui/react/menu').MenuTriggerProps<unknown> & React.RefAttributes<HTMLElement>, "ref"> & React.RefAttributes<HTMLElement>>;
     Portal: React.ForwardRefExoticComponent<import('@base-ui/react/menu').MenuPortalProps & React.RefAttributes<HTMLDivElement>>;

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

@@ -1 +1 @@
-{"version":3,"file":"dropdown.d.ts","sourceRoot":"","sources":["../../../../src/components/dropdown/dropdown.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAGL,KAAK,IAAI,EACV,MAAM,uBAAuB,CAAC;AAE/B,eAAO,MAAM,sBAAsB;;;;;;;;;;;CAYzB,CAAC;AAEX,eAAO,MAAM,8BAA8B;;CAEjC,CAAC;AAGX,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,sBAAsB,CAAC,OAAO,CAAC;AAE9E,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,OAAgD,GACjD,GAAE,yBAA8B,UAEhC;AAmTD,eAAO,MAAM,YAAY;;;;;gBA5Sb,OAAO;eACR,IAAI;;;;;gBAgEH,OAAO;eACR,IAAI,GAAG,KAAK,CAAC,SAAS;mBAClB,OAAO;eACX,MAAM;kBACH,SAAS,GAAG,QAAQ;;;;;gBAuKtB,OAAO;eACR,IAAI,GAAG,KAAK,CAAC,SAAS;;;;gBA5CrB,OAAO;;;;kCA8BhB,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC;;;;CA6FtC,CAAC"}
+{"version":3,"file":"dropdown.d.ts","sourceRoot":"","sources":["../../../../src/components/dropdown/dropdown.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAGL,KAAK,IAAI,EACV,MAAM,uBAAuB,CAAC;AAE/B,qEAAqE;AACrE,eAAO,MAAM,sBAAsB;;;;;;;;;;;CAYzB,CAAC;AAEX,eAAO,MAAM,8BAA8B;;CAEjC,CAAC;AAGX,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,sBAAsB,CAAC,OAAO,CAAC;AAE9E,MAAM,WAAW,yBAAyB;IACxC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,OAAgD,GACjD,GAAE,yBAA8B,UAEhC;AAmTD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,YAAY;;;;;gBAtUb,OAAO;eACR,IAAI;;;;;gBAgEH,OAAO;eACR,IAAI,GAAG,KAAK,CAAC,SAAS;mBAClB,OAAO;eACX,MAAM;kBACH,SAAS,GAAG,QAAQ;;;;;gBAuKtB,OAAO;eACR,IAAI,GAAG,KAAK,CAAC,SAAS;;;;gBA5CrB,OAAO;;;;kCA8BhB,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC;;;;CAuHtC,CAAC"}

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

@@ -1,3 +1,4 @@
+/** Empty state size variant definitions mapping sizes to their Tailwind classes. */
 export declare const KUMO_EMPTY_VARIANTS: {
     readonly size: {
         readonly sm: {
@@ -19,16 +20,50 @@ export declare const KUMO_EMPTY_DEFAULT_VARIANTS: {
 };
 export type KumoEmptySize = keyof typeof KUMO_EMPTY_VARIANTS.size;
 export interface KumoEmptyVariantsProps {
+    /**
+     * Size of the empty state container.
+     * - `"sm"` — Compact empty state for smaller containers
+     * - `"base"` — Default empty state size
+     * - `"lg"` — Large empty state for prominent placement
+     * @default "base"
+     */
     size?: KumoEmptySize;
 }
 export declare function emptyVariants({ size, }?: KumoEmptyVariantsProps): string;
+/**
+ * Empty state component props.
+ *
+ * @example
+ * ```tsx
+ * <Empty
+ *   icon={<PackageIcon size={48} />}
+ *   title="No packages found"
+ *   description="Get started by installing your first package."
+ *   commandLine="npm install @cloudflare/kumo"
+ * />
+ * ```
+ */
 export interface EmptyProps extends KumoEmptyVariantsProps {
+    /** Decorative icon displayed above the title (e.g. from `@phosphor-icons/react`). */
     icon?: React.ReactNode;
+    /** Primary heading text for the empty state. */
     title: string;
+    /** Secondary description text displayed below the title. */
     description?: string;
+    /** Shell command displayed in a copyable code block. */
     commandLine?: string;
+    /** Additional content (buttons, links) rendered below the description. */
     contents?: React.ReactNode;
+    /** Additional CSS classes merged via `cn()`. */
     className?: string;
 }
+/**
+ * Placeholder shown when a list, table, or page has no content to display.
+ *
+ * @example
+ * ```tsx
+ * <Empty title="No results found" description="Try adjusting your search." />
+ * ```
+ */
 export declare function Empty({ icon, title, description, commandLine, contents, size, className, }: EmptyProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=empty.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"empty.d.ts","sourceRoot":"","sources":["../../../../src/components/empty/empty.tsx"],"names":[],"mappings":"AAKA,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;CAetB,CAAC;AAEX,eAAO,MAAM,2BAA2B;;CAE9B,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,mBAAmB,CAAC,IAAI,CAAC;AAElE,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAED,wBAAgB,aAAa,CAAC,EAC5B,IAAuC,GACxC,GAAE,sBAA2B,UAK7B;AAED,MAAM,WAAW,UAAW,SAAQ,sBAAsB;IACxD,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,KAAK,CAAC,EACpB,IAAI,EACJ,KAAK,EACL,WAAW,EACX,WAAW,EACX,QAAQ,EACR,IAAa,EACb,SAAS,GACV,EAAE,UAAU,2CAsDZ"}
+{"version":3,"file":"empty.d.ts","sourceRoot":"","sources":["../../../../src/components/empty/empty.tsx"],"names":[],"mappings":"AAKA,oFAAoF;AACpF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;CAetB,CAAC;AAEX,eAAO,MAAM,2BAA2B;;CAE9B,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,mBAAmB,CAAC,IAAI,CAAC;AAElE,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAED,wBAAgB,aAAa,CAAC,EAC5B,IAAuC,GACxC,GAAE,sBAA2B,UAK7B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,UAAW,SAAQ,sBAAsB;IACxD,qFAAqF;IACrF,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,EACpB,IAAI,EACJ,KAAK,EACL,WAAW,EACX,WAAW,EACX,QAAQ,EACR,IAAa,EACb,SAAS,GACV,EAAE,UAAU,2CAsDZ"}

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

@@ -1,4 +1,5 @@
 import { ReactNode } from 'react';
+/** Field variant definitions (currently empty, reserved for future additions). */
 export declare const KUMO_FIELD_VARIANTS: {};
 export declare const KUMO_FIELD_DEFAULT_VARIANTS: {};
 export interface KumoFieldVariantsProps {
@@ -16,23 +17,52 @@ export declare function fieldVariants({ controlFirst, }?: KumoFieldVariantsProps
  * Source: BaseErrorProps["match"] (ComponentPropsWithoutRef<typeof FieldBase.Error>)
  */
 export type FieldErrorMatch = boolean | "badInput" | "customError" | "patternMismatch" | "rangeOverflow" | "rangeUnderflow" | "stepMismatch" | "tooLong" | "tooShort" | "typeMismatch" | "valid" | "valueMissing";
+/**
+ * Field component props — wraps a form control with label, description, and error message.
+ *
+ * @example
+ * ```tsx
+ * <Field label="Email" required>
+ *   <Input placeholder="you@example.com" />
+ * </Field>
+ *
+ * <Field label="Phone" required={false} description="We'll only use this for account recovery.">
+ *   <Input placeholder="+1 555-0000" />
+ * </Field>
+ * ```
+ */
 export interface FieldProps extends KumoFieldVariantsProps {
+    /** The form control element(s) to wrap (Input, Select, Checkbox, etc.). */
     children: ReactNode;
-    /** The label content - can be a string or any React node */
+    /** The label content — can be a string or any React node. */
     label: ReactNode;
     /**
-     * When explicitly false, shows gray "(optional)" text after the label.
-     * When true or undefined, no indicator is shown.
+     * When explicitly `false`, shows gray "(optional)" text after the label.
+     * When `true` or `undefined`, no indicator is shown.
      */
     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;
+    /** Validation error with a message and a browser `ValidityState` match key. */
     error?: {
         message: ReactNode;
         match: FieldErrorMatch;
     };
+    /** Helper text displayed below the control (hidden when `error` is present). */
     description?: ReactNode;
+    /** When `true`, places the control before the label (for checkbox/switch layouts). */
     controlFirst?: boolean;
 }
+/**
+ * Form field wrapper that provides a label, optional description, and error display
+ * around any form control. Built on Base UI Field primitives.
+ *
+ * @example
+ * ```tsx
+ * <Field label="Username">
+ *   <Input placeholder="Choose a username" />
+ * </Field>
+ * ```
+ */
 export declare function Field({ children, label, required, labelTooltip, error, description, controlFirst, }: FieldProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=field.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../../../src/components/field/field.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,eAAO,MAAM,mBAAmB,IAEtB,CAAC;AAEX,eAAO,MAAM,2BAA2B,IAAc,CAAC;AAGvD,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,aAAa,CAAC,EAC5B,YAAoB,GACrB,GAAE,sBAA2B,UAkB7B;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,UAAU,GACV,aAAa,GACb,iBAAiB,GACjB,eAAe,GACf,gBAAgB,GAChB,cAAc,GACd,SAAS,GACT,UAAU,GACV,cAAc,GACd,OAAO,GACP,cAAc,CAAC;AAEnB,MAAM,WAAW,UAAW,SAAQ,sBAAsB;IACxD,QAAQ,EAAE,SAAS,CAAC;IACpB,4DAA4D;IAC5D,KAAK,EAAE,SAAS,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oEAAoE;IACpE,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,SAAS,CAAC;QACnB,KAAK,EAAE,eAAe,CAAC;KACxB,CAAC;IACF,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,KAAK,CAAC,EACpB,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,KAAK,EACL,WAAW,EACX,YAAoB,GACrB,EAAE,UAAU,2CAsCZ"}
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../../../src/components/field/field.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,IAEtB,CAAC;AAEX,eAAO,MAAM,2BAA2B,IAAc,CAAC;AAGvD,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,aAAa,CAAC,EAC5B,YAAoB,GACrB,GAAE,sBAA2B,UAkB7B;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,UAAU,GACV,aAAa,GACb,iBAAiB,GACjB,eAAe,GACf,gBAAgB,GAChB,cAAc,GACd,SAAS,GACT,UAAU,GACV,cAAc,GACd,OAAO,GACP,cAAc,CAAC;AAEnB;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,UAAW,SAAQ,sBAAsB;IACxD,2EAA2E;IAC3E,QAAQ,EAAE,SAAS,CAAC;IACpB,6DAA6D;IAC7D,KAAK,EAAE,SAAS,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oEAAoE;IACpE,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,+EAA+E;IAC/E,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,SAAS,CAAC;QACnB,KAAK,EAAE,eAAe,CAAC;KACxB,CAAC;IACF,gFAAgF;IAChF,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,sFAAsF;IACtF,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,EACpB,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,KAAK,EACL,WAAW,EACX,YAAoB,GACrB,EAAE,UAAU,2CAsCZ"}

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

@@ -1,4 +1,5 @@
 import { default as React } from 'react';
+/** Grid variant and gap definitions mapping layout names to their responsive Tailwind classes. */
 export declare const KUMO_GRID_VARIANTS: {
     readonly variant: {
         readonly "2up": {
@@ -62,36 +63,52 @@ export declare const KUMO_GRID_DEFAULT_VARIANTS: {
 };
 export type KumoGridVariant = keyof typeof KUMO_GRID_VARIANTS.variant;
 export type KumoGridGap = keyof typeof KUMO_GRID_VARIANTS.gap;
+/**
+ * Grid component props.
+ *
+ * @example
+ * ```tsx
+ * <Grid variant="3up" gap="sm">
+ *   <GridItem><Surface className="p-4">1</Surface></GridItem>
+ *   <GridItem><Surface className="p-4">2</Surface></GridItem>
+ *   <GridItem><Surface className="p-4">3</Surface></GridItem>
+ * </Grid>
+ * ```
+ */
 export interface GridProps extends React.HTMLAttributes<HTMLDivElement> {
-    /**
-     * Child node(s) that can be nested inside component
-     */
+    /** Grid items to render. */
     children?: React.ReactNode;
-    /**
-     * CSS class names that can be appended to the component
-     */
+    /** Additional CSS classes merged via `cn()`. */
     className?: string;
-    /**
-     * Show dividers between grid items on mobile (only works with 4up variant)
-     */
+    /** Show dividers between grid items on mobile (only works with `"4up"` variant). */
     mobileDivider?: boolean;
     /**
-     * Gap size between grid items
+     * Gap size between grid items.
+     * - `"none"` — No gap
+     * - `"sm"` — 12px gap
+     * - `"base"` — Responsive gap (8px → 24px → 32px)
+     * - `"lg"` — 32px gap
+     * @default "base"
      */
     gap?: KumoGridGap;
     /**
-     * Stylistic variations of the Grid layout
+     * Responsive column layout variant.
+     * - `"2up"` — 1 col → 2 cols at md
+     * - `"side-by-side"` — Always 2 cols
+     * - `"2-1"` — 66%/33% split at md
+     * - `"1-2"` — 33%/66% split at md
+     * - `"3up"` — 1 → 2 → 3 cols
+     * - `"4up"` — 1 → 2 → 3 → 4 cols
+     * - `"6up"` — 2 → 3 → 4 → 6 cols
+     * - `"1-2-4up"` — 1 → 2 → 4 cols
      */
     variant?: KumoGridVariant;
 }
+/** GridItem component props — a single cell within a Grid. */
 export interface GridItemProps extends React.HTMLAttributes<HTMLDivElement> {
-    /**
-     * Child node(s) that can be nested inside component
-     */
+    /** Content for this grid cell. */
     children?: React.ReactNode;
-    /**
-     * CSS class names that can be appended to the component
-     */
+    /** Additional CSS classes merged via `cn()`. */
     className?: string;
 }
 export declare function gridVariants({ variant, gap, }?: {
@@ -102,6 +119,17 @@ export declare function gridItemVariants({ variant, mobileDivider, }?: {
     variant?: KumoGridVariant;
     mobileDivider?: boolean;
 }): string;
+/**
+ * Responsive CSS grid layout container with preset column configurations.
+ *
+ * @example
+ * ```tsx
+ * <Grid variant="2up" gap="base">
+ *   <GridItem>Left</GridItem>
+ *   <GridItem>Right</GridItem>
+ * </Grid>
+ * ```
+ */
 export declare const Grid: React.ForwardRefExoticComponent<GridProps & React.RefAttributes<HTMLDivElement>>;
 export declare const GridItem: React.ForwardRefExoticComponent<GridItemProps & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=grid.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"grid.d.ts","sourceRoot":"","sources":["../../../../src/components/grid/grid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgErB,CAAC;AAEX,eAAO,MAAM,0BAA0B;;CAE7B,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,kBAAkB,CAAC,OAAO,CAAC;AACtE,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,kBAAkB,CAAC,GAAG,CAAC;AAE9D,MAAM,WAAW,SAAU,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACrE;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB;;OAEG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED,MAAM,WAAW,aAAc,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACzE;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAYD,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EACP,GAAoC,GACrC,GAAE;IACD,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,GAAG,CAAC,EAAE,WAAW,CAAC;CACd,UAML;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,OAAO,EACP,aAAa,GACd,GAAE;IACD,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;CACpB,UAML;AAED,eAAO,MAAM,IAAI,kFAwBhB,CAAC;AAIF,eAAO,MAAM,QAAQ,sFAcpB,CAAC"}
+{"version":3,"file":"grid.d.ts","sourceRoot":"","sources":["../../../../src/components/grid/grid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,kGAAkG;AAClG,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgErB,CAAC;AAEX,eAAO,MAAM,0BAA0B;;CAE7B,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,kBAAkB,CAAC,OAAO,CAAC;AACtE,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,kBAAkB,CAAC,GAAG,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,SAAU,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACrE,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED,8DAA8D;AAC9D,MAAM,WAAW,aAAc,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACzE,kCAAkC;IAClC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAYD,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EACP,GAAoC,GACrC,GAAE;IACD,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,GAAG,CAAC,EAAE,WAAW,CAAC;CACd,UAML;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,OAAO,EACP,aAAa,GACd,GAAE;IACD,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;CACpB,UAML;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,IAAI,kFAwBhB,CAAC;AAIF,eAAO,MAAM,QAAQ,sFAcpB,CAAC"}

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

@@ -1,6 +1,7 @@
 import { ComponentPropsWithoutRef, ReactNode } from 'react';
 import { Input as BaseInput } from '@base-ui/react/input';
 import { FieldErrorMatch } from '../field/field';
+/** Input size and variant definitions mapping names to their Tailwind classes. */
 export declare const KUMO_INPUT_VARIANTS: {
     readonly size: {
         readonly xs: {
@@ -88,7 +89,21 @@ export declare const KUMO_INPUT_STYLING: {
 export type KumoInputSize = keyof typeof KUMO_INPUT_VARIANTS.size;
 export type KumoInputVariant = keyof typeof KUMO_INPUT_VARIANTS.variant;
 export interface KumoInputVariantsProps {
+    /**
+     * Input size.
+     * - `"xs"` — Extra small for compact UIs
+     * - `"sm"` — Small for secondary fields
+     * - `"base"` — Default size
+     * - `"lg"` — Large for prominent fields
+     * @default "base"
+     */
     size?: KumoInputSize;
+    /**
+     * Visual variant.
+     * - `"default"` — Standard input
+     * - `"error"` — Error state for validation failures
+     * @default "default"
+     */
     variant?: KumoInputVariant;
     parentFocusIndicator?: boolean;
     focusIndicator?: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../../src/components/input/input.tsx"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAS,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE7D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BtB,CAAC;AAEX,eAAO,MAAM,2BAA2B;;;CAG9B,CAAC;AAEX,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwBrB,CAAC;AAGX,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,mBAAmB,CAAC,IAAI,CAAC;AAClE,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,mBAAmB,CAAC,OAAO,CAAC;AAExE,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAGD,KAAK,cAAc,GAAG,IAAI,CAAC,wBAAwB,CAAC,OAAO,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;AAE/E,wBAAgB,aAAa,CAAC,EAC5B,OAA6C,EAC7C,IAAuC,EACvC,oBAA4B,EAC5B,cAAsB,GACvB,GAAE,sBAA2B,UAc7B;AAED,eAAO,MAAM,KAAK;IAyGd,8FAA8F;YACtF,SAAS;IACjB,oEAAoE;mBACrD,SAAS;IACxB,4CAA4C;kBAC9B,SAAS;IACvB,+CAA+C;YACvC,MAAM,GAAG;QAAE,OAAO,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,eAAe,CAAA;KAAE;oDA7CjE,CAAC;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,SAAS,CAAC,GACvE,cAAc,GAAG;IACf,8FAA8F;IAC9F,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,CAAC"}
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../../src/components/input/input.tsx"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAS,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE7D,kFAAkF;AAClF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BtB,CAAC;AAEX,eAAO,MAAM,2BAA2B;;;CAG9B,CAAC;AAEX,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwBrB,CAAC;AAGX,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,mBAAmB,CAAC,IAAI,CAAC;AAClE,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,mBAAmB,CAAC,OAAO,CAAC;AAExE,MAAM,WAAW,sBAAsB;IACrC;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAGD,KAAK,cAAc,GAAG,IAAI,CAAC,wBAAwB,CAAC,OAAO,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;AAE/E,wBAAgB,aAAa,CAAC,EAC5B,OAA6C,EAC7C,IAAuC,EACvC,oBAA4B,EAC5B,cAAsB,GACvB,GAAE,sBAA2B,UAc7B;AAED,eAAO,MAAM,KAAK;IAyGd,8FAA8F;YACtF,SAAS;IACjB,oEAAoE;mBACrD,SAAS;IACxB,4CAA4C;kBAC9B,SAAS;IACvB,+CAA+C;YACvC,MAAM,GAAG;QAAE,OAAO,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,eAAe,CAAA;KAAE;oDA7CjE,CAAC;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,SAAS,CAAC,GACvE,cAAc,GAAG;IACf,8FAA8F;IAC9F,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,CAAC"}

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

@@ -1,21 +1,32 @@
 import { ReactNode } from 'react';
+/** Label variant definitions (currently empty, reserved for future additions). */
 export declare const KUMO_LABEL_VARIANTS: {};
 export declare const KUMO_LABEL_DEFAULT_VARIANTS: {};
 export interface KumoLabelVariantsProps {
 }
 export declare function labelVariants(_props?: KumoLabelVariantsProps): string;
 export declare function labelContentVariants(): string;
+/**
+ * Label component props.
+ *
+ * @example
+ * ```tsx
+ * <Label>Email</Label>
+ * <Label showOptional>Middle Name</Label>
+ * <Label tooltip="We'll use this to send you updates">Email</Label>
+ * ```
+ */
 export interface LabelProps extends KumoLabelVariantsProps {
-    /** The label content - can be a string or any React node */
+    /** The label content — can be a string or any React node. */
     children: ReactNode;
-    /** When true (and required is false), shows gray "(optional)" text after the label */
+    /** When `true`, shows gray "(optional)" text after the label. */
     showOptional?: boolean;
-    /** Tooltip content to display next to the label via an info icon */
+    /** Tooltip content displayed next to the label via an info icon. */
     tooltip?: ReactNode;
-    /** Additional CSS classes */
+    /** Additional CSS classes merged via `cn()`. */
     className?: string;
     /**
-     * When true, only renders the inline content (indicators, tooltip) without
+     * When `true`, only renders the inline content (indicators, tooltip) without
      * the outer span with font styling. Useful when composed inside another
      * label element that already provides the text styling.
      * @default false

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

@@ -1 +1 @@
-{"version":3,"file":"label.d.ts","sourceRoot":"","sources":["../../../../src/components/label/label.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,eAAO,MAAM,mBAAmB,IAEtB,CAAC;AAEX,eAAO,MAAM,2BAA2B,IAAc,CAAC;AAGvD,MAAM,WAAW,sBAAsB;CAAG;AAE1C,wBAAgB,aAAa,CAAC,MAAM,GAAE,sBAA2B,UAMhE;AAED,wBAAgB,oBAAoB,WAKnC;AAED,MAAM,WAAW,UAAW,SAAQ,sBAAsB;IACxD,4DAA4D;IAC5D,QAAQ,EAAE,SAAS,CAAC;IACpB,sFAAsF;IACtF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oEAAoE;IACpE,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,KAAK,CAAC,EACpB,QAAQ,EACR,YAAoB,EACpB,OAAO,EACP,SAAS,EACT,SAAiB,GAClB,EAAE,UAAU,2CA+BZ;yBArCe,KAAK"}
+{"version":3,"file":"label.d.ts","sourceRoot":"","sources":["../../../../src/components/label/label.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,IAEtB,CAAC;AAEX,eAAO,MAAM,2BAA2B,IAAc,CAAC;AAGvD,MAAM,WAAW,sBAAsB;CAAG;AAE1C,wBAAgB,aAAa,CAAC,MAAM,GAAE,sBAA2B,UAMhE;AAED,wBAAgB,oBAAoB,WAKnC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAW,SAAQ,sBAAsB;IACxD,6DAA6D;IAC7D,QAAQ,EAAE,SAAS,CAAC;IACpB,iEAAiE;IACjE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oEAAoE;IACpE,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,KAAK,CAAC,EACpB,QAAQ,EACR,YAAoB,EACpB,OAAO,EACP,SAAS,EACT,SAAiB,GAClB,EAAE,UAAU,2CA+BZ;yBArCe,KAAK"}

package/dist/src/components/layer-card/layer-card.d.ts

@@ -1,10 +1,23 @@
 import { FC, PropsWithChildren } from 'react';
+/** LayerCard variant definitions (currently empty, reserved for future additions). */
 export declare const KUMO_LAYER_CARD_VARIANTS: {};
 export declare const KUMO_LAYER_CARD_DEFAULT_VARIANTS: {};
 export interface KumoLayerCardVariantsProps {
 }
 export declare function layerCardVariants(_props?: KumoLayerCardVariantsProps): string;
+/**
+ * LayerCard component props.
+ *
+ * @example
+ * ```tsx
+ * <LayerCard>
+ *   <LayerCard.Secondary>Next Steps</LayerCard.Secondary>
+ *   <LayerCard.Primary>Get started with Kumo</LayerCard.Primary>
+ * </LayerCard>
+ * ```
+ */
 export type LayerCardProps = PropsWithChildren<KumoLayerCardVariantsProps & {
+    /** Additional CSS classes merged via `cn()`. */
     className?: string;
 }>;
 type LayerCardComponent = FC<LayerCardProps> & {

package/dist/src/components/layer-card/layer-card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layer-card.d.ts","sourceRoot":"","sources":["../../../../src/components/layer-card/layer-card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAGnD,eAAO,MAAM,wBAAwB,IAE3B,CAAC;AAEX,eAAO,MAAM,gCAAgC,IAAc,CAAC;AAG5D,MAAM,WAAW,0BAA0B;CAAG;AAE9C,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,0BAA+B,UAKxE;AAED,MAAM,MAAM,cAAc,GAAG,iBAAiB,CAC5C,0BAA0B,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CACpD,CAAC;AAgCF,KAAK,kBAAkB,GAAG,EAAE,CAAC,cAAc,CAAC,GAAG;IAC7C,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC;IAC5B,SAAS,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC;CAC/B,CAAC;AAEF,QAAA,MAAM,SAAS,EAGT,kBAAkB,CAAC;AAEzB,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"layer-card.d.ts","sourceRoot":"","sources":["../../../../src/components/layer-card/layer-card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAGnD,sFAAsF;AACtF,eAAO,MAAM,wBAAwB,IAE3B,CAAC;AAEX,eAAO,MAAM,gCAAgC,IAAc,CAAC;AAG5D,MAAM,WAAW,0BAA0B;CAAG;AAE9C,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,0BAA+B,UAKxE;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG,iBAAiB,CAC5C,0BAA0B,GAAG;IAC3B,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CACF,CAAC;AA2CF,KAAK,kBAAkB,GAAG,EAAE,CAAC,cAAc,CAAC,GAAG;IAC7C,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC;IAC5B,SAAS,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC;CAC/B,CAAC;AAEF,QAAA,MAAM,SAAS,EAGT,kBAAkB,CAAC;AAEzB,OAAO,EAAE,SAAS,EAAE,CAAC"}

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

@@ -1,6 +1,7 @@
 import { SVGProps } from 'react';
 import { useRender } from '@base-ui/react/use-render';
 import { LinkComponentProps } from '../../utils/link-provider';
+/** Link variant definitions mapping variant names to their Tailwind classes. */
 export declare const KUMO_LINK_VARIANTS: {
     readonly variant: {
         readonly inline: {
@@ -22,9 +23,28 @@ export declare const KUMO_LINK_DEFAULT_VARIANTS: {
 };
 export type KumoLinkVariant = keyof typeof KUMO_LINK_VARIANTS.variant;
 export interface KumoLinkVariantsProps {
+    /**
+     * Visual style of the link.
+     * - `"inline"` — Inline text link that flows with content
+     * - `"current"` — Link that inherits color from parent text
+     * - `"plain"` — Link without underline decoration
+     * @default "inline"
+     */
     variant?: KumoLinkVariant;
 }
 export declare function linkVariants({ variant, }?: KumoLinkVariantsProps): string;
+/**
+ * Link component props.
+ *
+ * @example
+ * ```tsx
+ * <Link href="/docs">Learn more</Link>
+ * <Link href="https://cloudflare.com" target="_blank" rel="noopener noreferrer">
+ *   Visit Cloudflare <Link.ExternalIcon />
+ * </Link>
+ * <Link render={<RouterLink to="/dashboard" />}>Dashboard</Link>
+ * ```
+ */
 export type LinkProps = useRender.ComponentProps<"a"> & LinkComponentProps & KumoLinkVariantsProps;
 export declare const Link: import('react').ForwardRefExoticComponent<Omit<LinkProps, "ref"> & import('react').RefAttributes<HTMLAnchorElement>> & {
     ExternalIcon: {

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

@@ -1 +1 @@
-{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../../../src/components/link/link.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAGtD,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,2BAA2B,CAAC;AAgCnC,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;CAiBrB,CAAC;AAEX,eAAO,MAAM,0BAA0B;;CAE7B,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,kBAAkB,CAAC,OAAO,CAAC;AAEtE,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED,wBAAgB,YAAY,CAAC,EAC3B,OAA4C,GAC7C,GAAE,qBAA0B,UAE5B;AAED,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,cAAc,CAAC,GAAG,CAAC,GACnD,kBAAkB,GAClB,qBAAqB,CAAC;AAqDxB,eAAO,MAAM,IAAI;;gBA9GY,QAAQ,CAAC,aAAa,CAAC;;;CAgHlD,CAAC"}
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../../../src/components/link/link.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAGtD,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,2BAA2B,CAAC;AAgCnC,gFAAgF;AAChF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;CAiBrB,CAAC;AAEX,eAAO,MAAM,0BAA0B;;CAE7B,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,kBAAkB,CAAC,OAAO,CAAC;AAEtE,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED,wBAAgB,YAAY,CAAC,EAC3B,OAA4C,GAC7C,GAAE,qBAA0B,UAE5B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,cAAc,CAAC,GAAG,CAAC,GACnD,kBAAkB,GAClB,qBAAqB,CAAC;AAqDxB,eAAO,MAAM,IAAI;;gBAlIY,QAAQ,CAAC,aAAa,CAAC;;;CAoIlD,CAAC"}

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

@@ -1,3 +1,4 @@
+/** Loader size variant definitions mapping sizes to their pixel values. */
 export declare const KUMO_LOADER_VARIANTS: {
     readonly size: {
         readonly sm: {
@@ -19,12 +20,45 @@ export declare const KUMO_LOADER_DEFAULT_VARIANTS: {
 };
 export type KumoLoaderSize = keyof typeof KUMO_LOADER_VARIANTS.size;
 export interface KumoLoaderVariantsProps {
+    /**
+     * Size of the loader. Use a preset name or a custom pixel number.
+     * - `"sm"` — 16px, small loader for inline use
+     * - `"base"` — 24px, default loader size
+     * - `"lg"` — 32px, large loader for prominent loading states
+     * @default "base"
+     */
     size?: KumoLoaderSize | number;
 }
 export declare function loaderVariants({ size, }?: KumoLoaderVariantsProps): number;
+/**
+ * Loader component props.
+ *
+ * @example
+ * ```tsx
+ * <Loader />
+ * <Loader size="sm" />
+ * <Loader size={24} />
+ * ```
+ */
 export interface LoaderProps {
+    /** Additional CSS classes merged via `cn()`. */
     className?: string;
+    /**
+     * Size of the spinner. Use a preset name or a custom pixel number.
+     * - `"sm"` — 16px, for inline use
+     * - `"base"` — 24px, default size
+     * - `"lg"` — 32px, for prominent loading states
+     * @default "base"
+     */
     size?: KumoLoaderSize | number;
 }
+/**
+ * Animated circular spinner for indicating loading states.
+ *
+ * @example
+ * ```tsx
+ * <Loader />
+ * ```
+ */
 export declare const Loader: ({ className, size, }: LoaderProps) => import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=loader.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../src/components/loader/loader.tsx"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;CAevB,CAAC;AAEX,eAAO,MAAM,4BAA4B;;CAE/B,CAAC;AAGX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,oBAAoB,CAAC,IAAI,CAAC;AAEpE,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC;CAChC;AAED,wBAAgB,cAAc,CAAC,EAC7B,IAAwC,GACzC,GAAE,uBAA4B,GAAG,MAAM,CAGvC;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC;CAChC;AAED,eAAO,MAAM,MAAM,GAAI,sBAGpB,WAAW,4CAsDb,CAAC"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../src/components/loader/loader.tsx"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;CAevB,CAAC;AAEX,eAAO,MAAM,4BAA4B;;CAE/B,CAAC;AAGX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,oBAAoB,CAAC,IAAI,CAAC;AAEpE,MAAM,WAAW,uBAAuB;IACtC;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC;CAChC;AAED,wBAAgB,cAAc,CAAC,EAC7B,IAAwC,GACzC,GAAE,uBAA4B,GAAG,MAAM,CAGvC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,GAAI,sBAGpB,WAAW,4CAsDb,CAAC"}

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

@@ -1,22 +1,66 @@
 import { default as React } from 'react';
+/** MenuBar variant definitions (currently empty, reserved for future additions). */
 export declare const KUMO_MENUBAR_VARIANTS: {};
 export declare const KUMO_MENUBAR_DEFAULT_VARIANTS: {};
 export interface KumoMenuBarVariantsProps {
 }
 export declare function menuBarVariants(_props?: KumoMenuBarVariantsProps): string;
+/** Props for an individual menu option within a MenuBar. */
 type MenuOptionProps = {
+    /** Icon element (typically from `@phosphor-icons/react`) rendered at 18px */
     icon: React.ReactNode;
+    /** Unique identifier for the option (used when `optionIds` is true) */
     id?: number | string;
+    /** Currently active value from the parent MenuBar */
     isActive?: number | boolean | string | undefined;
+    /** Callback when this option is clicked */
     onClick: () => void;
+    /** Tooltip text shown on hover */
     tooltip: string;
 };
+/**
+ * MenuBar component props.
+ *
+ * Horizontal icon-button toolbar with keyboard navigation and tooltip labels.
+ *
+ * @example
+ * ```tsx
+ * <MenuBar
+ *   isActive={activeIndex}
+ *   options={[
+ *     { icon: <ListIcon />, tooltip: "List view", onClick: () => setView("list") },
+ *     { icon: <GridFourIcon />, tooltip: "Grid view", onClick: () => setView("grid") },
+ *   ]}
+ * />
+ * ```
+ */
 type MenuBarProps = {
+    /** Additional CSS classes merged via `cn()`. */
     className?: string;
+    /** The currently active option value — matched against option index or `id`. */
     isActive: number | boolean | string | undefined;
+    /** Array of menu option configurations. */
     options: MenuOptionProps[];
+    /** When true, each option's `id` field is used for matching instead of its array index. */
     optionIds?: boolean;
 };
+/**
+ * MenuBar — horizontal icon-button toolbar with keyboard arrow-key navigation.
+ *
+ * Each option renders as a `<button>` with a Tooltip. The active option is
+ * visually highlighted with an elevated background.
+ *
+ * @example
+ * ```tsx
+ * <MenuBar
+ *   isActive={0}
+ *   options={[
+ *     { icon: <ListIcon />, tooltip: "List", onClick: () => {} },
+ *     { icon: <GridFourIcon />, tooltip: "Grid", onClick: () => {} },
+ *   ]}
+ * />
+ * ```
+ */
 export declare const MenuBar: ({ className, isActive, options, optionIds, }: MenuBarProps) => import("react/jsx-runtime").JSX.Element;
 export {};
 //# sourceMappingURL=menubar.d.ts.map