@commercetools/nimbus 0.0.0-canary-20251010175720 → 0.0.0-canary-20251013071647

package/dist/index.es.js

@@ -32,7 +32,7 @@ import { V as Ut } from "./chunks/visually-hidden-CVUszTlg.es.js";
 import { T as Gt } from "./chunks/text-input-DWJ-CPVR.es.js";
 import { N as Vt } from "./chunks/number-input-Cq95vVse.es.js";
 import { G as Wt } from "./chunks/grid-De8qjf98.es.js";
-import { S as Xt, c as Jt, d as Qt, b as Yt, a as Zt } from "./chunks/select-CWttUH5b.es.js";
+import { S as Xt, c as Jt, d as Qt, b as Yt, a as Zt } from "./chunks/select-D5QaNAMe.es.js";
 import { S as tr } from "./chunks/separator-D7elp8bN.es.js";
 import { A as or, d as nr, c as ar, e as sr, b as ir, a as ur } from "./chunks/accordion-C4MjwWsC.es.js";
 import { A as cr, d as fr, c as dr, e as pr, a as mr, b as yr } from "./chunks/alert-C_eKOpkm.es.js";
@@ -47,7 +47,7 @@ import { S as Nr } from "./chunks/search-input-DkFkEdiE.es.js";
 import { S as jr } from "./chunks/split-button-Bczcosj2.es.js";
 import { T as qr } from "./chunks/time-input-CwfMLg_y.es.js";
 import { M as zr } from "./chunks/multiline-text-input-BrE5zqv5.es.js";
-import { M as $r } from "./chunks/money-input-CavdTx-o.es.js";
+import { M as $r } from "./chunks/money-input-DvR9Nnz5.es.js";
 import { R as Jr, b as Qr, a as Yr } from "./chunks/radio-input-8sawPicQ.es.js";
 import { S as eo } from "./chunks/switch-D_NMKG3Q.es.js";
 import { T as ro } from "./chunks/tag-group-uIKmx4eU.es.js";
@@ -62,10 +62,10 @@ import { M as ho, c as _o, d as To, a as wo, e as So, g as Eo, f as ko, b as Do
 import { D as Io } from "./chunks/date-range-picker-BICRnCsn.es.js";
 import { T as Lo } from "./chunks/toolbar-DXDZ5G0Q.es.js";
 import { D as Po, e as Bo, g as Fo, d as Ho, i as Ko, h as Oo, c as No, j as Uo, a as jo, f as Go, k as qo, b as Vo } from "./chunks/data-table-0hNRYKT3.es.js";
-import { P as Wo } from "./chunks/pagination-CBrMi7gy.es.js";
+import { P as Wo } from "./chunks/pagination-2Zl9bHfw.es.js";
 import { D as Xo } from "./chunks/drawer-wpiy6Y4h.es.js";
 import { T as Qo, c as Yo, b as Zo, e as en, d as tn, a as rn } from "./chunks/tabs-UlU9sGFI.es.js";
-import { L as nn } from "./chunks/localized-field-CV69UdIU.es.js";
+import { L as nn } from "./chunks/localized-field-COJ9aoma.es.js";
 import "react/jsx-runtime";
 function L() {
   return L = Object.assign ? Object.assign.bind() : function(e) {

package/dist/select.d.ts

@@ -12,23 +12,124 @@ import { SelectProps } from 'react-aria-components';
 import { SelectRootProps as SelectRootProps_2 } from './select.types';
 import { SlotRecipeDefinition } from '@chakra-ui/react';
 
+/**
+ * Select
+ * ============================================================
+ * A versatile select component for choosing one or more options from a list.
+ * Features full keyboard accessibility and WCAG 2.1 AA compliance.
+ *
+ * @example
+ * ```tsx
+ * <Select.Root>
+ *   <Select.Options placeholder="Select an option">
+ *     <Select.Option id="1">Option 1</Select.Option>
+ *     <Select.Option id="2">Option 2</Select.Option>
+ *     <Select.Option id="3">Option 3</Select.Option>
+ *   </Select.Options>
+ * </Select.Root>
+ * ```
+ *
+ * @see https://nimbus-documentation.vercel.app/components/inputs/select
+ */
 export declare const Select: {
+    /**
+     * # Select.Root
+     *
+     * The root component that provides context and state management for the select.
+     * This component must wrap all select parts (Options, Option, etc.) and provides
+     * the select state, variant styling context, and selection management.
+     *
+     * @example
+     * ```tsx
+     * <Select.Root>
+     *   <Select.Options placeholder="Choose...">
+     *     <Select.Option id="apple">Apple</Select.Option>
+     *     <Select.Option id="orange">Orange</Select.Option>
+     *   </Select.Options>
+     * </Select.Root>
+     * ```
+     */
     Root: {
         ({ ref: forwardedRef, children, leadingElement, isLoading, isDisabled, isClearable, ...props }: SelectRootProps_2): JSX.Element;
         displayName: string;
     };
+    /**
+     * # Select.Options
+     *
+     * The trigger button and dropdown container for select options.
+     * Displays the selected value and opens the options list when activated.
+     *
+     * This component handles the visual presentation of the select, including
+     * the trigger button, selected value display, dropdown icon, and the
+     * popover containing options.
+     *
+     * @example
+     * ```tsx
+     * <Select.Root>
+     *   <Select.Options
+     *     placeholder="Select fruit"
+     *     label="Favorite Fruit"
+     *   >
+     *     <Select.Option id="apple">Apple</Select.Option>
+     *     <Select.Option id="banana">Banana</Select.Option>
+     *   </Select.Options>
+     * </Select.Root>
+     * ```
+     */
     Options: {
         <T extends object>(props: SelectOptionsProps_2<T> & {
             ref?: React.Ref<HTMLDivElement>;
         }): JSX.Element;
         displayName: string;
     };
+    /**
+     * # Select.Option
+     *
+     * An individual selectable option within the select dropdown.
+     * Represents a single choice that can be selected by the user.
+     *
+     * Options automatically handle selection state, keyboard navigation,
+     * and visual feedback for hover and selection states.
+     *
+     * @example
+     * ```tsx
+     * <Select.Options>
+     *   <Select.Option id="red" textValue="Red">
+     *     🔴 Red
+     *   </Select.Option>
+     *   <Select.Option id="blue" textValue="Blue">
+     *     🔵 Blue
+     *   </Select.Option>
+     * </Select.Options>
+     * ```
+     */
     Option: {
-        <T extends object>({ ref, ...restProps }: SelectOptionProps_2<T> & {
-            ref?: React.Ref<HTMLDivElement>;
-        }): JSX.Element;
+        (props: SelectOptionProps_2): JSX.Element;
         displayName: string;
     };
+    /**
+     * # Select.OptionGroup
+     *
+     * A container for grouping related options with an optional label.
+     * Provides visual separation and semantic grouping of options.
+     *
+     * Option groups help organize large lists of options into logical
+     * categories with proper accessibility support.
+     *
+     * @example
+     * ```tsx
+     * <Select.Options>
+     *   <Select.OptionGroup label="Fruits">
+     *     <Select.Option id="apple">Apple</Select.Option>
+     *     <Select.Option id="banana">Banana</Select.Option>
+     *   </Select.OptionGroup>
+     *   <Select.OptionGroup label="Vegetables">
+     *     <Select.Option id="carrot">Carrot</Select.Option>
+     *     <Select.Option id="broccoli">Broccoli</Select.Option>
+     *   </Select.OptionGroup>
+     * </Select.Options>
+     * ```
+     */
     OptionGroup: {
         <T extends object>(props: SelectOptionGroupProps_2<T> & {
             ref?: React.Ref<HTMLDivElement>;
@@ -38,9 +139,7 @@ export declare const Select: {
 };
 
 export declare const _SelectOption: {
-    <T extends object>({ ref, ...restProps }: SelectOptionProps<T> & {
-        ref?: React.Ref<HTMLDivElement>;
-    }): JSX.Element;
+    (props: SelectOptionProps): JSX.Element;
     displayName: string;
 };
 
@@ -59,7 +158,11 @@ export declare interface SelectOptionGroupProps<T> extends ListBoxSectionProps<T
 declare interface SelectOptionGroupSlotProps extends HTMLChakraProps<"div"> {
 }
 
-export declare interface SelectOptionProps<T> extends Omit<ListBoxItemProps<T>, "onClick" | "translate" | "onBlur" | "onFocus" | "onKeyDown" | "onKeyUp" | "onMouseDown" | "onMouseUp">, Omit<SelectOptionSlotProps, keyof ListBoxItemProps<T>> {
+export declare interface SelectOptionProps extends Omit<ListBoxItemProps, "onClick" | "translate" | "onBlur" | "onFocus" | "onKeyDown" | "onKeyUp" | "onMouseDown" | "onMouseUp">, Omit<SelectOptionSlotProps, keyof ListBoxItemProps> {
+    /**
+     * React ref to be forwarded to the option element
+     */
+    ref?: React.Ref<HTMLDivElement>;
 }
 
 export declare const _SelectOptions: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commercetools/nimbus",
-  "version": "0.0.0-canary-20251010175720",
+  "version": "0.0.0-canary-20251013071647",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "type": "module",
@@ -94,15 +94,15 @@
     "vite-plugin-dts": "^4.5.4",
     "vite-tsconfig-paths": "^5.1.4",
     "vitest": "^3.2.4",
-    "@commercetools/nimbus-icons": "^0.0.0-canary-20251010175720",
-    "@commercetools/nimbus-tokens": "^0.0.0-canary-20251010175720"
+    "@commercetools/nimbus-icons": "^0.0.0-canary-20251013071647",
+    "@commercetools/nimbus-tokens": "^0.0.0-canary-20251013071647"
   },
   "peerDependencies": {
     "@chakra-ui/react": "^3.27.1",
     "react": "19.x",
     "react-intl": "7.x",
-    "@commercetools/nimbus-icons": "^0.0.0-canary-20251010175720",
-    "@commercetools/nimbus-tokens": "^0.0.0-canary-20251010175720"
+    "@commercetools/nimbus-icons": "^0.0.0-canary-20251013071647",
+    "@commercetools/nimbus-tokens": "^0.0.0-canary-20251013071647"
   },
   "scripts": {
     "build": "pnpm run build-theme-typings && pnpm run build:lib",