@shape-digital-env/shape-ui 0.0.2 → 0.0.3

package/components/Modal/Modal.d.ts

@@ -1,39 +1,52 @@
 import * as React from "react";
+/** Width preset of the dialog panel. `full` spans the whole viewport width. */
 export type ModalSize = "sm" | "md" | "lg" | "xl" | "full";
 export interface ModalProps {
-    /** Controls dialog open state. */
+    /**
+     * Whether the dialog is shown. The modal never closes itself: keep this in state and set it
+     * to `false` from `onClose`.
+     * @default true
+     */
     open?: boolean;
-    /** Content rendered as the dialog title. */
+    /** Content rendered as the dialog title. It is also the dialog's accessible name. */
     title: React.ReactNode;
-    /** Called when the dialog requests to be closed (X button, Escape key, overlay click). */
+    /**
+     * Called when the dialog requests to be closed (X button, Escape key, overlay click). Set
+     * `open` to `false` in response.
+     */
     onClose: () => void;
-    /** Called when the user clicks the Cancel button. */
+    /** Called when the user clicks the Cancel button. The button only renders when this is set. */
     onCancel?: () => void;
-    /** Called when the user clicks the Confirm button. */
+    /** Called when the user clicks the Confirm button. The button only renders when this is set. */
     onConfirm?: () => void;
-    /** Content rendered inside the body slot. */
+    /** Content rendered inside the body slot, which scrolls when it is taller than the viewport. */
     children: React.ReactNode;
-    /** Controls the width of the dialog. Defaults to "md". */
+    /** Controls the width of the dialog. @default "md" */
     size?: ModalSize;
-    /** Extra classes forwarded to the dialog panel. */
+    /** Extra classes forwarded to the dialog panel. Applied after `contentClassName`. */
     className?: string;
-    /** Extra classes forwarded to the dialog panel. */
+    /** Extra classes forwarded to the dialog panel. Same element as `className`, applied before it. */
     contentClassName?: string;
     /** Extra classes forwarded to the scrollable body container. */
     bodyClassName?: string;
-    /** Label for the Cancel button. Defaults to "Cancel". */
+    /** Label for the Cancel button, translated through `shape_ui` by default. @default "Cancel" */
     cancelLabel?: string;
-    /** Label for the Confirm button. Defaults to "Confirm". */
+    /** Label for the Confirm button, translated through `shape_ui` by default. @default "Confirm" */
     confirmLabel?: string;
     /**
      * Whether this dialog traps focus and blocks outside interaction. Set to `false` when this
      * dialog is expected to host another dialog on top of it (e.g. a confirmation modal opened
      * from within this one) — otherwise the two focus traps fight over `document.activeElement`
-     * and the nested dialog becomes unusable. Defaults to `true`.
+     * and the nested dialog becomes unusable.
+     * @default true
      */
     modal?: boolean;
 }
-/** `ref` points at the dialog panel (`DialogPrimitive.Content`), which renders in a portal. */
+/**
+ * Dialog with a title, a close button, a scrollable body and an optional Cancel / Confirm footer.
+ *
+ * `ref` points at the dialog panel (`DialogPrimitive.Content`), which renders in a portal.
+ */
 declare const Modal: React.ForwardRefExoticComponent<ModalProps & React.RefAttributes<HTMLDivElement>>;
 export { Modal };
 //# sourceMappingURL=Modal.d.ts.map

package/components/Modal/Modal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../../src/components/Modal/Modal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAU3D,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4CAA4C;IAC5C,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,0FAA0F;IAC1F,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,0DAA0D;IAC1D,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,+FAA+F;AAC/F,QAAA,MAAM,KAAK,mFAqHV,CAAC;AAIF,OAAO,EAAE,KAAK,EAAE,CAAC"}
+{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../../src/components/Modal/Modal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,+EAA+E;AAC/E,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAU3D,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,qFAAqF;IACrF,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB;;;OAGG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,gGAAgG;IAChG,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,sDAAsD;IACtD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mGAAmG;IACnG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+FAA+F;IAC/F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iGAAiG;IACjG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,QAAA,MAAM,KAAK,mFAsHV,CAAC;AAIF,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/components/Modal/Modal.stories.d.ts

@@ -1,9 +1,44 @@
-import { Meta, StoryObj } from '@storybook/react-vite';
-import { Modal } from './Modal';
-declare const meta: Meta<typeof Modal>;
+import { StoryObj } from '@storybook/react-vite';
+import { ModalProps, ModalSize } from './Modal';
+import * as React from "react";
+declare const meta: {
+    title: string;
+    component: React.ForwardRefExoticComponent<ModalProps & React.RefAttributes<HTMLDivElement>>;
+    parameters: {
+        layout: string;
+        docs: {
+            story: {
+                inline: boolean;
+                height: string;
+            };
+            description: {
+                component: string;
+            };
+        };
+    };
+    argTypes: {
+        size: {
+            control: "select";
+            options: ModalSize[];
+        };
+    };
+    args: {
+        open: true;
+        title: string;
+        children: import("react/jsx-runtime").JSX.Element;
+        onClose: import('storybook/test').Mock<(...args: any[]) => any>;
+        onCancel: import('storybook/test').Mock<(...args: any[]) => any>;
+        onConfirm: import('storybook/test').Mock<(...args: any[]) => any>;
+    };
+};
 export default meta;
-type Story = StoryObj<typeof Modal>;
+type Story = StoryObj<typeof meta>;
 export declare const Default: Story;
-export declare const WithForm: Story;
-export declare const WithSubtitle: Story;
+export declare const CancelAndConfirm: Story;
+export declare const CustomLabels: Story;
+export declare const WithoutFooter: Story;
+export declare const Controlled: Story;
+export declare const Sizes: Story;
+export declare const LongContent: Story;
+export declare const NonModal: Story;
 //# sourceMappingURL=Modal.stories.d.ts.map

package/components/Modal/Modal.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Modal.stories.d.ts","sourceRoot":"","sources":["../../../src/components/Modal/Modal.stories.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAQhC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,KAAK,CAc5B,CAAC;AAEF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,KAAK,CAAC,CAAC;AAKpC,eAAO,MAAM,OAAO,EAAE,KASrB,CAAC;AAKF,eAAO,MAAM,QAAQ,EAAE,KAyCtB,CAAC;AAKF,eAAO,MAAM,YAAY,EAAE,KAY1B,CAAC"}
+{"version":3,"file":"Modal.stories.d.ts","sourceRoot":"","sources":["../../../src/components/Modal/Modal.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAS,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAWjE,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwBoB,CAAC;AAE/B,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAKnC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC;AAEjC,eAAO,MAAM,gBAAgB,EAAE,KAc9B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAW1B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,KAY3B,CAAC;AAuBF,eAAO,MAAM,UAAU,EAAE,KA4BxB,CAAC;AAiCF,eAAO,MAAM,KAAK,EAAE,KASnB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAezB,CAAC;AA+BF,eAAO,MAAM,QAAQ,EAAE,KAmBtB,CAAC"}

package/components/MultiSelect/MultiSelect.d.ts

@@ -1,10 +1,20 @@
 import * as React from "react";
 import * as PopoverPrimitive from "@radix-ui/react-popover";
 export interface MultiSelectTriggerProps extends React.ComponentPropsWithoutRef<"button"> {
+    /** Shown in the trigger while nothing is selected (no `children`). */
     placeholder?: string;
+    /**
+     * Open state, when the consumer controls it. Radix already reports the
+     * trigger's state, so this is only needed to override it.
+     */
     isOpen?: boolean;
 }
 export interface MultiSelectItemProps extends React.ComponentPropsWithoutRef<"div"> {
+    /**
+     * Whether the option is selected. The item keeps no state: toggle it from
+     * `onClick` and `onKeyDown`.
+     * @default false
+     */
     checked?: boolean;
 }
 export declare const MultiSelect: {

package/components/MultiSelect/MultiSelect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MultiSelect.d.ts","sourceRoot":"","sources":["../../../src/components/MultiSelect/MultiSelect.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,gBAAgB,MAAM,yBAAyB,CAAC;AAmB5D,MAAM,WAAW,uBACf,SAAQ,KAAK,CAAC,wBAAwB,CAAC,QAAQ,CAAC;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAgGD,MAAM,WAAW,oBACf,SAAQ,KAAK,CAAC,wBAAwB,CAAC,KAAK,CAAC;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAyCD,eAAO,MAAM,WAAW;YAvJf,KAAK,CAAC,wBAAwB,CAAC,OAAO,gBAAgB,CAAC,IAAI,CAAC;;;;;;CA2JnE,CAAC"}
+{"version":3,"file":"MultiSelect.d.ts","sourceRoot":"","sources":["../../../src/components/MultiSelect/MultiSelect.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,gBAAgB,MAAM,yBAAyB,CAAC;AA8B5D,MAAM,WAAW,uBACf,SAAQ,KAAK,CAAC,wBAAwB,CAAC,QAAQ,CAAC;IAChD,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA2GD,MAAM,WAAW,oBACf,SAAQ,KAAK,CAAC,wBAAwB,CAAC,KAAK,CAAC;IAC7C;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA8CD,eAAO,MAAM,WAAW;YAxLf,KAAK,CAAC,wBAAwB,CAAC,OAAO,gBAAgB,CAAC,IAAI,CAAC;;;;;;CA4LnE,CAAC"}

package/components/MultiSelect/MultiSelect.stories.d.ts

@@ -1,9 +1,70 @@
-import { Meta, StoryObj } from '@storybook/react-vite';
+import { ComponentProps } from 'react';
+import { StoryObj } from '@storybook/react-vite';
 import { MultiSelect } from './MultiSelect';
-declare const meta: Meta<typeof MultiSelect>;
+interface MultiSelectOption {
+    value: string;
+    label: string;
+}
+type MultiSelectStoryArgs = ComponentProps<typeof MultiSelect> & {
+    options: MultiSelectOption[];
+    value: string[];
+    onValueChange: (value: string[]) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    "aria-label"?: string;
+};
+declare const meta: {
+    title: string;
+    component: {
+        (props: React.ComponentPropsWithoutRef<import('react').FC<import('@radix-ui/react-popover').PopoverProps>>): import("react/jsx-runtime").JSX.Element;
+        displayName: string;
+    } & {
+        Trigger: import('react').ForwardRefExoticComponent<import('./MultiSelect').MultiSelectTriggerProps & import('react').RefAttributes<HTMLButtonElement>>;
+        Content: import('react').ForwardRefExoticComponent<Omit<import('@radix-ui/react-popover').PopoverContentProps & import('react').RefAttributes<HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+        Item: import('react').ForwardRefExoticComponent<import('./MultiSelect').MultiSelectItemProps & import('react').RefAttributes<HTMLDivElement>>;
+    };
+    subcomponents: {
+        "MultiSelect.Trigger": import('react').ForwardRefExoticComponent<import('./MultiSelect').MultiSelectTriggerProps & import('react').RefAttributes<HTMLButtonElement>>;
+        "MultiSelect.Item": import('react').ForwardRefExoticComponent<import('./MultiSelect').MultiSelectItemProps & import('react').RefAttributes<HTMLDivElement>>;
+    };
+    parameters: {
+        layout: string;
+        docs: {
+            description: {
+                component: string;
+            };
+        };
+    };
+    decorators: ((Story: import('storybook/internal/csf').PartialStoryFn<import('@storybook/react').ReactRenderer, {
+        children?: import('react').ReactNode;
+        open?: boolean | undefined;
+        defaultOpen?: boolean | undefined;
+        onOpenChange?: ((open: boolean) => void) | undefined;
+        modal?: boolean | undefined;
+        options: MultiSelectOption[];
+        value: string[];
+        onValueChange: (value: string[]) => void;
+        placeholder?: string | undefined;
+        disabled?: boolean | undefined;
+        "aria-label"?: string | undefined;
+    }>) => import("react/jsx-runtime").JSX.Element)[];
+    args: {
+        options: MultiSelectOption[];
+        value: never[];
+        placeholder: string;
+        disabled: false;
+        "aria-label": string;
+        onValueChange: import('storybook/test').Mock<(...args: any[]) => any>;
+        onOpenChange: import('storybook/test').Mock<(...args: any[]) => any>;
+    };
+    render: (args: MultiSelectStoryArgs) => import("react/jsx-runtime").JSX.Element;
+};
 export default meta;
-type Story = StoryObj<typeof MultiSelect>;
+type Story = StoryObj<typeof meta>;
 export declare const Default: Story;
-export declare const WithSelection: Story;
-export declare const AllSelected: Story;
+export declare const States: Story;
+export declare const LongContent: Story;
+export declare const Empty: Story;
+export declare const Controlled: Story;
+export declare const InsideField: Story;
 //# sourceMappingURL=MultiSelect.stories.d.ts.map

package/components/MultiSelect/MultiSelect.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MultiSelect.stories.d.ts","sourceRoot":"","sources":["../../../src/components/MultiSelect/MultiSelect.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAU5C,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,WAAW,CAmBlC,CAAC;AAEF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,WAAW,CAAC,CAAC;AAE1C,eAAO,MAAM,OAAO,EAAE,KAyCrB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,KAyC3B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAyCzB,CAAC"}
+{"version":3,"file":"MultiSelect.stories.d.ts","sourceRoot":"","sources":["../../../src/components/MultiSelect/MultiSelect.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,UAAU,iBAAiB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AASD,KAAK,oBAAoB,GAAG,cAAc,CAAC,OAAO,WAAW,CAAC,GAAG;IAC/D,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AA4DF,QAAA,MAAM,IAAI;;;gBAhEyB,MAAM,wBACpB;;;;;;;;;;;;;;;;;;;;;;;;;iBAHV,iBAAiB,EAAE;eACrB,MAAM,EAAE;uBACA,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI;sBAC1B,MAAM;mBACT,OAAO;uBACH,MAAM;;;;;;;;;;;;CA8Fe,CAAC;AAEvC,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KA0BrB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,KAiBpB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAQzB,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAEnB,CAAC;AAsBF,eAAO,MAAM,UAAU,EAAE,KAGxB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAkBzB,CAAC"}

package/components/PageHeader/PageHeader.d.ts

@@ -1,6 +1,8 @@
 import * as React from "react";
 export interface PageHeaderProps extends React.HTMLAttributes<HTMLElement> {
+    /** Text of the back button. The button is rendered only when this is set. */
     backText?: string;
+    /** Called when the back button is clicked. */
     onBack?: () => void;
 }
 declare const PageHeader: React.ForwardRefExoticComponent<PageHeaderProps & React.RefAttributes<HTMLElement>>;

package/components/PageHeader/PageHeader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PageHeader.d.ts","sourceRoot":"","sources":["../../../src/components/PageHeader/PageHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,MAAM,WAAW,eAAgB,SAAQ,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,QAAA,MAAM,UAAU,qFAwBf,CAAC;AAGF,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"PageHeader.d.ts","sourceRoot":"","sources":["../../../src/components/PageHeader/PageHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,MAAM,WAAW,eAAgB,SAAQ,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC;IACxE,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,QAAA,MAAM,UAAU,qFAwBf,CAAC;AAGF,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/components/PageHeader/PageHeader.stories.d.ts

@@ -1,9 +1,31 @@
-import { Meta, StoryObj } from '@storybook/react-vite';
-import { PageHeader } from './PageHeader';
-declare const meta: Meta<typeof PageHeader>;
+import { StoryObj } from '@storybook/react-vite';
+declare const meta: {
+    title: string;
+    component: import('react').ForwardRefExoticComponent<import('./PageHeader').PageHeaderProps & import('react').RefAttributes<HTMLElement>>;
+    parameters: {
+        layout: string;
+        docs: {
+            description: {
+                component: string;
+            };
+        };
+    };
+    argTypes: {
+        children: {
+            control: false;
+        };
+    };
+    args: {
+        backText: string;
+        onBack: import('storybook/test').Mock<(...args: any[]) => any>;
+        children: import("react/jsx-runtime").JSX.Element;
+    };
+};
 export default meta;
-type Story = StoryObj<typeof PageHeader>;
-export declare const WithActions: Story;
-export declare const WithBackButton: Story;
+type Story = StoryObj<typeof meta>;
+export declare const Default: Story;
+export declare const ActionsOnly: Story;
 export declare const BackButtonOnly: Story;
+export declare const LongContent: Story;
+export declare const GoesBack: Story;
 //# sourceMappingURL=PageHeader.stories.d.ts.map

package/components/PageHeader/PageHeader.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PageHeader.stories.d.ts","sourceRoot":"","sources":["../../../src/components/PageHeader/PageHeader.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,UAAU,CAOjC,CAAC;AAEF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,UAAU,CAAC,CAAC;AAEzC,eAAO,MAAM,WAAW,EAAE,KAMzB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,KAM5B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,KAI5B,CAAC"}
+{"version":3,"file":"PageHeader.stories.d.ts","sourceRoot":"","sources":["../../../src/components/PageHeader/PageHeader.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAK5D,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;CA2ByB,CAAC;AAEpC,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC;AAEjC,eAAO,MAAM,WAAW,EAAE,KAEzB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,KAE5B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAezB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAQtB,CAAC"}

package/components/Pagination/Pagination.d.ts

@@ -4,14 +4,23 @@ declare const Pagination: React.ForwardRefExoticComponent<Omit<React.DetailedHTM
 declare const PaginationContent: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLUListElement>, HTMLUListElement>, "ref"> & React.RefAttributes<HTMLUListElement>>;
 declare const PaginationItem: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.LiHTMLAttributes<HTMLLIElement>, HTMLLIElement>, "ref"> & React.RefAttributes<HTMLLIElement>>;
 interface PaginationLinkProps extends React.ComponentProps<typeof Button> {
+    /** Marks the current page: highlighted and announced with `aria-current="page"`. @default false */
     isActive?: boolean;
 }
 declare const PaginationLink: React.ForwardRefExoticComponent<Omit<PaginationLinkProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
 interface PaginationPreviousProps extends Omit<PaginationLinkProps, "children"> {
+    /**
+     * Visible text next to the arrow. When omitted, only the arrow shows and
+     * "Previous" (translated through `shape_ui`) is kept as screen-reader text.
+     */
     prevText?: string;
 }
 declare const PaginationPrevious: React.ForwardRefExoticComponent<Omit<PaginationPreviousProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
 interface PaginationNextProps extends Omit<PaginationLinkProps, "children"> {
+    /**
+     * Visible text next to the arrow. When omitted, only the arrow shows and
+     * "Next" (translated through `shape_ui`) is kept as screen-reader text.
+     */
     nextText?: string;
 }
 declare const PaginationNext: React.ForwardRefExoticComponent<Omit<PaginationNextProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

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

@@ -1 +1 @@
-{"version":3,"file":"Pagination.d.ts","sourceRoot":"","sources":["../../../src/components/Pagination/Pagination.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAKnC,QAAA,MAAM,UAAU,0JAIf,CAAC;AAGF,QAAA,MAAM,iBAAiB,yKASrB,CAAC;AAGH,QAAA,MAAM,cAAc,kKAGiC,CAAC;AAGtD,UAAU,mBAAoB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC;IACvE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,QAAA,MAAM,cAAc,4GAmBnB,CAAC;AAGF,UAAU,uBACR,SAAQ,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,QAAA,MAAM,kBAAkB,gHAgBtB,CAAC;AAGH,UAAU,mBAAoB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,QAAA,MAAM,cAAc,4GAenB,CAAC;AAGF,QAAA,MAAM,kBAAkB,sKAetB,CAAC;AAGH,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,kBAAkB,GACnB,CAAC;AACF,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,GACpB,CAAC"}
+{"version":3,"file":"Pagination.d.ts","sourceRoot":"","sources":["../../../src/components/Pagination/Pagination.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAKnC,QAAA,MAAM,UAAU,0JAYf,CAAC;AAGF,QAAA,MAAM,iBAAiB,yKASrB,CAAC;AAGH,QAAA,MAAM,cAAc,kKAGiC,CAAC;AAGtD,UAAU,mBAAoB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC;IACvE,mGAAmG;IACnG,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,QAAA,MAAM,cAAc,4GAmBnB,CAAC;AAGF,UAAU,uBACR,SAAQ,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC;IAC7C;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,QAAA,MAAM,kBAAkB,gHAmBtB,CAAC;AAGH,UAAU,mBAAoB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC;IACzE;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,QAAA,MAAM,cAAc,4GAkBnB,CAAC;AAGF,QAAA,MAAM,kBAAkB,sKAetB,CAAC;AAGH,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,kBAAkB,GACnB,CAAC;AACF,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,GACpB,CAAC"}

package/components/Pagination/Pagination.stories.d.ts

@@ -1,11 +1,67 @@
-import { Meta, StoryObj } from '@storybook/react-vite';
+import { StoryObj } from '@storybook/react-vite';
+import { ComponentProps } from 'react';
 import { Pagination } from './Pagination';
-declare const meta: Meta<typeof Pagination>;
+interface PaginationStoryArgs extends ComponentProps<typeof Pagination> {
+    /** Story-only: current page, 1-based. */
+    page: number;
+    /** Story-only: number of pages. */
+    totalPages: number;
+    /** Story-only: pages shown on each side of the current one. */
+    siblingCount: number;
+    /** Visible text of the previous button (`PaginationPrevious`). */
+    prevText?: string;
+    /** Visible text of the next button (`PaginationNext`). */
+    nextText?: string;
+    /** Story-only: called with the page the user asks for. */
+    onPageChange: (page: number) => void;
+}
+declare const meta: {
+    title: string;
+    component: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & import('react').RefAttributes<HTMLElement>>;
+    parameters: {
+        layout: string;
+        docs: {
+            description: {
+                component: string;
+            };
+        };
+    };
+    argTypes: {
+        page: {
+            control: {
+                type: "number";
+                min: number;
+            };
+        };
+        totalPages: {
+            control: {
+                type: "number";
+                min: number;
+            };
+        };
+        siblingCount: {
+            control: {
+                type: "number";
+                min: number;
+            };
+        };
+    };
+    args: {
+        page: number;
+        totalPages: number;
+        siblingCount: number;
+        onPageChange: import('storybook/test').Mock<(...args: any[]) => any>;
+    };
+    render: (args: PaginationStoryArgs) => import("react/jsx-runtime").JSX.Element;
+};
 export default meta;
-type Story = StoryObj<typeof Pagination>;
+type Story = StoryObj<typeof meta>;
 export declare const Default: Story;
 export declare const WithEllipsis: Story;
-export declare const Interactive: Story;
 export declare const WithText: Story;
+export declare const LongContent: Story;
+export declare const SinglePage: Story;
 export declare const States: Story;
+export declare const Controlled: Story;
+export declare const EdgesAreDisabled: Story;
 //# sourceMappingURL=Pagination.stories.d.ts.map

package/components/Pagination/Pagination.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Pagination.stories.d.ts","sourceRoot":"","sources":["../../../src/components/Pagination/Pagination.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EACL,UAAU,EAOX,MAAM,cAAc,CAAC;AAEtB,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,UAAU,CAMjC,CAAC;AAEF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,UAAU,CAAC,CAAC;AAEzC,eAAO,MAAM,OAAO,EAAE,KAkBrB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KA4B1B,CAAC;AAmDF,eAAO,MAAM,WAAW,EAAE,KAEzB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KA4BtB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,KAqCpB,CAAC"}
+{"version":3,"file":"Pagination.stories.d.ts","sourceRoot":"","sources":["../../../src/components/Pagination/Pagination.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAEjE,OAAO,EACL,UAAU,EAOX,MAAM,cAAc,CAAC;AAEtB,UAAU,mBAAoB,SAAQ,cAAc,CAAC,OAAO,UAAU,CAAC;IACrE,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAqFD,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4B2B,CAAC;AAEtC,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC;AAEjC,eAAO,MAAM,YAAY,EAAE,KAE1B,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAEtB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAEzB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KAExB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,KA8BpB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KAmBxB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,KAY9B,CAAC"}

package/components/RadioGroup/RadioGroup.d.ts

@@ -1,9 +1,11 @@
 import * as React from "react";
 import * as RadioGroupPrimitive from "@radix-ui/react-radio-group";
 export interface RadioGroupItemProps extends React.ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Item> {
+    /** Text beside the radio; clicking it selects the item and names it for screen readers. */
     label?: React.ReactNode;
 }
 export declare const RadioGroup: React.ForwardRefExoticComponent<Omit<RadioGroupPrimitive.RadioGroupProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
+    /** Lays the items out in a row instead of a column. @default false */
     row?: boolean;
 } & React.RefAttributes<HTMLDivElement>> & {
     Item: React.ForwardRefExoticComponent<RadioGroupItemProps & React.RefAttributes<HTMLButtonElement>>;

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

@@ -1 +1 @@
-{"version":3,"file":"RadioGroup.d.ts","sourceRoot":"","sources":["../../../src/components/RadioGroup/RadioGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,mBAAmB,MAAM,6BAA6B,CAAC;AA0CnE,MAAM,WAAW,mBACf,SAAQ,KAAK,CAAC,wBAAwB,CAAC,OAAO,mBAAmB,CAAC,IAAI,CAAC;IACvE,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACzB;AAiCD,eAAO,MAAM,UAAU;UApEb,OAAO;;;CAsEf,CAAC"}
+{"version":3,"file":"RadioGroup.d.ts","sourceRoot":"","sources":["../../../src/components/RadioGroup/RadioGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,mBAAmB,MAAM,6BAA6B,CAAC;AA+CnE,MAAM,WAAW,mBACf,SAAQ,KAAK,CAAC,wBAAwB,CAAC,OAAO,mBAAmB,CAAC,IAAI,CAAC;IACvE,2FAA2F;IAC3F,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACzB;AAiCD,eAAO,MAAM,UAAU;IA1EnB,sEAAsE;UAChE,OAAO;;;CA2Ef,CAAC"}

package/components/RadioGroup/RadioGroup.stories.d.ts

@@ -1,10 +1,48 @@
-import { Meta, StoryObj } from '@storybook/react-vite';
+import { ComponentProps } from 'react';
+import { StoryObj } from '@storybook/react-vite';
 import { RadioGroup } from './RadioGroup';
-declare const meta: Meta<typeof RadioGroup>;
+interface RadioOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+type RadioGroupStoryArgs = ComponentProps<typeof RadioGroup> & {
+    options: RadioOption[];
+};
+declare const meta: {
+    title: string;
+    component: import('react').ForwardRefExoticComponent<Omit<import('@radix-ui/react-radio-group').RadioGroupProps & import('react').RefAttributes<HTMLDivElement>, "ref"> & {
+        row?: boolean;
+    } & import('react').RefAttributes<HTMLDivElement>> & {
+        Item: import('react').ForwardRefExoticComponent<import('./RadioGroup').RadioGroupItemProps & import('react').RefAttributes<HTMLButtonElement>>;
+    };
+    subcomponents: {
+        "RadioGroup.Item": import('react').ForwardRefExoticComponent<import('./RadioGroup').RadioGroupItemProps & import('react').RefAttributes<HTMLButtonElement>>;
+    };
+    parameters: {
+        layout: string;
+        docs: {
+            description: {
+                component: string;
+            };
+        };
+    };
+    args: {
+        options: RadioOption[];
+        defaultValue: string;
+        row: false;
+        disabled: false;
+        "aria-label": string;
+        onValueChange: import('storybook/test').Mock<(...args: any[]) => any>;
+    };
+    render: (args: RadioGroupStoryArgs) => import("react/jsx-runtime").JSX.Element;
+};
 export default meta;
-type Story = StoryObj<typeof RadioGroup>;
+type Story = StoryObj<typeof meta>;
 export declare const Default: Story;
-export declare const Column: Story;
-export declare const Disabled: Story;
-export declare const DisabledGroup: Story;
+export declare const Row: Story;
+export declare const States: Story;
+export declare const LongContent: Story;
+export declare const Controlled: Story;
+export declare const InsideField: Story;
 //# sourceMappingURL=RadioGroup.stories.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"RadioGroup.stories.d.ts","sourceRoot":"","sources":["../../../src/components/RadioGroup/RadioGroup.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAQ1C,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,UAAU,CAoBjC,CAAC;AAEF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,UAAU,CAAC,CAAC;AAEzC,eAAO,MAAM,OAAO,EAAE,KAuBrB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,KAuBpB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAwBtB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,KAoB3B,CAAC"}
+{"version":3,"file":"RadioGroup.stories.d.ts","sourceRoot":"","sources":["../../../src/components/RadioGroup/RadioGroup.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAQD,KAAK,mBAAmB,GAAG,cAAc,CAAC,OAAO,UAAU,CAAC,GAAG;IAC7D,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB,CAAC;AAiBF,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsB2B,CAAC;AAEtC,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAkBrB,CAAC;AAEF,eAAO,MAAM,GAAG,EAAE,KAEjB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,KAepB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAsBzB,CAAC;AAsBF,eAAO,MAAM,UAAU,EAAE,KAGxB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAkBzB,CAAC"}

package/components/Select/Select.d.ts

@@ -5,38 +5,59 @@ declare const SelectRoot: React.FC<SelectPrimitive.SelectProps>;
 declare const SelectGroup: React.ForwardRefExoticComponent<SelectPrimitive.SelectGroupProps & React.RefAttributes<HTMLDivElement>>;
 declare const SelectValue: React.ForwardRefExoticComponent<SelectPrimitive.SelectValueProps & React.RefAttributes<HTMLSpanElement>>;
 export type SelectTriggerProps = React.ComponentPropsWithoutRef<typeof SelectPrimitive.Trigger> & {
-    /** "icon": square icon-only trigger (no chevron, no value text) — sidebar collapsed state. */
+    /**
+     * Look of the trigger: `ghost` is large text with a chevron, `outlined` a
+     * bordered form control, `icon` a square icon-only button (no chevron, no
+     * value text) that renders only its `children`.
+     * @default "ghost"
+     */
     variant?: "ghost" | "outlined" | "icon";
     /** Leading icon from `@shape/shape-ui/icons/<name>`. outlined only. */
     leadingIcon?: IconDefinition;
-    /** Show severity bars indicator before value text. outlined only. */
+    /** Shows the severity bars before the value text. outlined only. @default false */
     severity?: boolean;
     /** Trailing icon from `@shape/shape-ui/icons/<name>`. outlined only. */
     trailingIcon?: IconDefinition;
-    /** When true, hides the chevron and shows trailingIcon in its place. outlined only. */
+    /** Hides the chevron, so `trailingIcon` takes its place. outlined only. @default false */
     replaceChevron?: boolean;
-    /** Error state — applies red border. outlined only. */
+    /**
+     * Paints the red border. outlined only. Inside a `Field` it defaults to the
+     * field's invalid state; pass it to override that.
+     */
     error?: boolean;
 };
 declare const SelectTrigger: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectTriggerProps & React.RefAttributes<HTMLButtonElement>, "ref"> & {
-    /** "icon": square icon-only trigger (no chevron, no value text) — sidebar collapsed state. */
+    /**
+     * Look of the trigger: `ghost` is large text with a chevron, `outlined` a
+     * bordered form control, `icon` a square icon-only button (no chevron, no
+     * value text) that renders only its `children`.
+     * @default "ghost"
+     */
     variant?: "ghost" | "outlined" | "icon";
     /** Leading icon from `@shape/shape-ui/icons/<name>`. outlined only. */
     leadingIcon?: IconDefinition;
-    /** Show severity bars indicator before value text. outlined only. */
+    /** Shows the severity bars before the value text. outlined only. @default false */
     severity?: boolean;
     /** Trailing icon from `@shape/shape-ui/icons/<name>`. outlined only. */
     trailingIcon?: IconDefinition;
-    /** When true, hides the chevron and shows trailingIcon in its place. outlined only. */
+    /** Hides the chevron, so `trailingIcon` takes its place. outlined only. @default false */
     replaceChevron?: boolean;
-    /** Error state — applies red border. outlined only. */
+    /**
+     * Paints the red border. outlined only. Inside a `Field` it defaults to the
+     * field's invalid state; pass it to override that.
+     */
     error?: boolean;
 } & React.RefAttributes<HTMLButtonElement>>;
 declare const SelectContent: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
-    /** Optional z-index applied to Radix popper wrapper (`data-radix-popper-content-wrapper`). */
+    /**
+     * z-index applied to the Radix popper wrapper
+     * (`data-radix-popper-content-wrapper`), for a list opened above a modal or
+     * another layer. Only with `position="popper"`, the default here.
+     */
     wrapperZIndex?: number | string;
 } & React.RefAttributes<HTMLDivElement>>;
 export interface SelectItemProps extends React.ComponentPropsWithoutRef<typeof SelectPrimitive.Item> {
+    /** Content after the label (a badge, a count). Not copied into the trigger. */
     suffix?: React.ReactNode;
 }
 declare const SelectItem: React.ForwardRefExoticComponent<SelectItemProps & React.RefAttributes<HTMLDivElement>>;
@@ -47,21 +68,33 @@ declare const Select: ((props: React.ComponentPropsWithoutRef<typeof SelectPrimi
     Group: React.ForwardRefExoticComponent<SelectPrimitive.SelectGroupProps & React.RefAttributes<HTMLDivElement>>;
     Value: React.ForwardRefExoticComponent<SelectPrimitive.SelectValueProps & React.RefAttributes<HTMLSpanElement>>;
     Trigger: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectTriggerProps & React.RefAttributes<HTMLButtonElement>, "ref"> & {
-        /** "icon": square icon-only trigger (no chevron, no value text) — sidebar collapsed state. */
+        /**
+         * Look of the trigger: `ghost` is large text with a chevron, `outlined` a
+         * bordered form control, `icon` a square icon-only button (no chevron, no
+         * value text) that renders only its `children`.
+         * @default "ghost"
+         */
         variant?: "ghost" | "outlined" | "icon";
         /** Leading icon from `@shape/shape-ui/icons/<name>`. outlined only. */
         leadingIcon?: IconDefinition;
-        /** Show severity bars indicator before value text. outlined only. */
+        /** Shows the severity bars before the value text. outlined only. @default false */
         severity?: boolean;
         /** Trailing icon from `@shape/shape-ui/icons/<name>`. outlined only. */
         trailingIcon?: IconDefinition;
-        /** When true, hides the chevron and shows trailingIcon in its place. outlined only. */
+        /** Hides the chevron, so `trailingIcon` takes its place. outlined only. @default false */
         replaceChevron?: boolean;
-        /** Error state — applies red border. outlined only. */
+        /**
+         * Paints the red border. outlined only. Inside a `Field` it defaults to the
+         * field's invalid state; pass it to override that.
+         */
         error?: boolean;
     } & React.RefAttributes<HTMLButtonElement>>;
     Content: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
-        /** Optional z-index applied to Radix popper wrapper (`data-radix-popper-content-wrapper`). */
+        /**
+         * z-index applied to the Radix popper wrapper
+         * (`data-radix-popper-content-wrapper`), for a list opened above a modal or
+         * another layer. Only with `position="popper"`, the default here.
+         */
         wrapperZIndex?: number | string;
     } & React.RefAttributes<HTMLDivElement>>;
     Item: React.ForwardRefExoticComponent<SelectItemProps & React.RefAttributes<HTMLDivElement>>;

package/components/Select/Select.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../../../src/components/Select/Select.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,eAAe,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAsBzD,QAAA,MAAM,UAAU,uCAAuB,CAAC;AACxC,QAAA,MAAM,WAAW,yGAAwB,CAAC;AAC1C,QAAA,MAAM,WAAW,0GAAwB,CAAC;AAmB1C,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,wBAAwB,CAC7D,OAAO,eAAe,CAAC,OAAO,CAC/B,GAAG;IACF,8FAA8F;IAC9F,OAAO,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IACxC,uEAAuE;IACvE,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,uFAAuF;IACvF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,uDAAuD;IACvD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,QAAA,MAAM,aAAa;IAdjB,8FAA8F;cACpF,OAAO,GAAG,UAAU,GAAG,MAAM;IACvC,uEAAuE;kBACzD,cAAc;IAC5B,qEAAqE;eAC1D,OAAO;IAClB,wEAAwE;mBACzD,cAAc;IAC7B,uFAAuF;qBACtE,OAAO;IACxB,uDAAuD;YAC/C,OAAO;2CAsHhB,CAAC;AAaF,QAAA,MAAM,aAAa;IAJjB,8FAA8F;oBAC9E,MAAM,GAAG,MAAM;wCA+FhC,CAAC;AAMF,MAAM,WAAW,eACf,SAAQ,KAAK,CAAC,wBAAwB,CAAC,OAAO,eAAe,CAAC,IAAI,CAAC;IACnE,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B;AAED,QAAA,MAAM,UAAU,wFAyBd,CAAC;AAMH,QAAA,MAAM,WAAW,4JAYf,CAAC;AAMH,QAAA,MAAM,eAAe,gKASnB,CAAC;AAGH,QAAA,MAAM,MAAM,WACF,KAAK,CAAC,wBAAwB,CAAC,OAAO,eAAe,CAAC,IAAI,CAAC;;;;;QAnTnE,8FAA8F;kBACpF,OAAO,GAAG,UAAU,GAAG,MAAM;QACvC,uEAAuE;sBACzD,cAAc;QAC5B,qEAAqE;mBAC1D,OAAO;QAClB,wEAAwE;uBACzD,cAAc;QAC7B,uFAAuF;yBACtE,OAAO;QACxB,uDAAuD;gBAC/C,OAAO;;;QA+Hf,8FAA8F;wBAC9E,MAAM,GAAG,MAAM;;;;;CAqLhC,CAAC;AAEF,OAAO,EACL,MAAM,EACN,UAAU,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACb,aAAa,EACb,UAAU,EACV,WAAW,EACX,eAAe,GAChB,CAAC"}
+{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../../../src/components/Select/Select.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,eAAe,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAsBzD,QAAA,MAAM,UAAU,uCAAuB,CAAC;AACxC,QAAA,MAAM,WAAW,yGAAwB,CAAC;AAC1C,QAAA,MAAM,WAAW,0GAAwB,CAAC;AAmB1C,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,wBAAwB,CAC7D,OAAO,eAAe,CAAC,OAAO,CAC/B,GAAG;IACF;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IACxC,uEAAuE;IACvE,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,mFAAmF;IACnF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,0FAA0F;IAC1F,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,QAAA,MAAM,aAAa;IAtBjB;;;;;OAKG;cACO,OAAO,GAAG,UAAU,GAAG,MAAM;IACvC,uEAAuE;kBACzD,cAAc;IAC5B,mFAAmF;eACxE,OAAO;IAClB,wEAAwE;mBACzD,cAAc;IAC7B,0FAA0F;qBACzE,OAAO;IACxB;;;OAGG;YACK,OAAO;2CAwHhB,CAAC;AAiBF,QAAA,MAAM,aAAa;IARjB;;;;OAIG;oBACa,MAAM,GAAG,MAAM;wCA+FhC,CAAC;AAMF,MAAM,WAAW,eACf,SAAQ,KAAK,CAAC,wBAAwB,CAAC,OAAO,eAAe,CAAC,IAAI,CAAC;IACnE,+EAA+E;IAC/E,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B;AAED,QAAA,MAAM,UAAU,wFAuBd,CAAC;AAMH,QAAA,MAAM,WAAW,4JAYf,CAAC;AAMH,QAAA,MAAM,eAAe,gKASnB,CAAC;AAGH,QAAA,MAAM,MAAM,WACF,KAAK,CAAC,wBAAwB,CAAC,OAAO,eAAe,CAAC,IAAI,CAAC;;;;;QAhUnE;;;;;WAKG;kBACO,OAAO,GAAG,UAAU,GAAG,MAAM;QACvC,uEAAuE;sBACzD,cAAc;QAC5B,mFAAmF;mBACxE,OAAO;QAClB,wEAAwE;uBACzD,cAAc;QAC7B,0FAA0F;yBACzE,OAAO;QACxB;;;WAGG;gBACK,OAAO;;;QAiIf;;;;WAIG;wBACa,MAAM,GAAG,MAAM;;;;;CAoLhC,CAAC;AAEF,OAAO,EACL,MAAM,EACN,UAAU,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACb,aAAa,EACb,UAAU,EACV,WAAW,EACX,eAAe,GAChB,CAAC"}