@viasat/beam-react 2.0.0

package/lib/Select/Select.es.js

@@ -0,0 +1,259 @@
+import { jsxs as x, jsx as i } from "react/jsx-runtime";
+import ke, { useCallback as k, useMemo as C, createElement as Fe } from "react";
+import { g as Le } from "../../chunks/classNames.DNsS4J__.js";
+import { t as Re } from "../../chunks/constants.BBi77pmH.js";
+import { s as r } from "../../chunks/combobox.module.DNJ3sGlK.js";
+import F from "clsx";
+import { b as qe, H as Ae } from "../../chunks/form.context.CNWjF5qA.js";
+import { LabelProvider as He } from "../Form/contexts/label.context.es.js";
+import { HelperTextProvider as je } from "../Form/contexts/helperText.context.es.js";
+import { ActionList as L } from "../ActionList/ActionList.es.js";
+import { useSelectDropdown as Ke } from "./useSelectDropdown.es.js";
+import { SelectDropdown as Te } from "./SelectDropdown.es.js";
+import { useSelectChips as Ge } from "./useSelectChips.es.js";
+import { useSelectKeyboardManager as We } from "./useSelectKeyboardManager.es.js";
+import { useClearSelection as ze } from "./useClearSelection.es.js";
+import { OptionChips as Je } from "../_Options/OptionChips.es.js";
+import { SelectField as Qe } from "./SelectField.es.js";
+import { useSelectA11y as Ue } from "./useSelectA11y.es.js";
+import { useCreateOptionsContext as Xe, OptionsProvider as Ye } from "../_Options/Option.context.es.js";
+import { Option as Ze } from "../_Options/Option.es.js";
+import { useSelectValue as _e } from "../_Options/useSelectValue.es.js";
+import { createSelectionStrategy as et } from "../_Options/strategies/SelectionStrategy.es.js";
+const { baseClassNamePrefix: tt, subElementClassPrefix: O, classModifierPrefix: a } = Le("combobox"), lt = ke.forwardRef(
+  ({
+    theme: v,
+    width: q,
+    error: d,
+    children: A,
+    label: P = null,
+    contentBefore: H,
+    contentAfter: j,
+    fluid: K = !1,
+    helperText: g = null,
+    validationRules: T = [],
+    className: G,
+    hideRequiredMarker: W = !1,
+    disabled: z = !1,
+    readOnly: J = !1,
+    required: Q = !1,
+    placeholder: U = "",
+    onChange: m,
+    ...u
+  }, X) => {
+    const {
+      id: I,
+      name: Y,
+      "aria-describedby": Z,
+      multiple: e = !1,
+      clearable: _ = e,
+      ...ee
+    } = u, { showErrors: te, isInvalid: le, errorShown: re, disabled: l, readOnly: s, required: $ } = qe({
+      name: Y,
+      validationRules: T,
+      disabledProp: z,
+      readOnlyProp: J,
+      requiredProp: Q
+    }), { aria: f, ids: oe } = Ue({
+      helperText: g,
+      externalDescribedBy: Z,
+      error: d,
+      errorShown: re,
+      invalid: !!d || le
+    }), { helperTextId: se, errorId: ie, validationErrorsId: ae, labelId: N } = oe, de = !!(d != null && d.length), ne = k(
+      (o) => {
+        m == null || m(o);
+      },
+      [m]
+    ), {
+      value: n,
+      setValue: B,
+      selectProps: ce,
+      handleBlur: w,
+      singleValue: b
+    } = _e({ onChange: ne, ...u }, X), y = !n || Array.isArray(n) && !n.length, {
+      optionsContext: pe,
+      optionIds: c,
+      optionsProps: p,
+      selectedOptionsProps: M,
+      deselectOptionValue: D
+    } = Xe(n, B, e), h = C(() => {
+      if (!b) return;
+      const o = c.map((t) => p.get(t)).findIndex((t) => (t == null ? void 0 : t.value) === b);
+      return o !== -1 ? o : void 0;
+    }, [c, p, b]), me = C(() => {
+      if (h === void 0) return;
+      const o = p.get(c[h]);
+      return o == null ? void 0 : o.label;
+    }, [h, c, p]), { getFieldProps: ue, dropdownProps: fe, refs: be, open: E, setOpen: S, status: he } = Ke({
+      disabled: l,
+      readOnly: s,
+      lastSelectedOptionIndex: h
+    }), xe = F(
+      r[tt],
+      v && Re(v),
+      K && r[`${a}fluid`],
+      f.invalid && r[`${a}error`],
+      l && r[`${a}disabled`],
+      s && r[`${a}read-only`],
+      y && r[`${a}empty`],
+      e && r[`${a}multiple`],
+      r[`${a}dropdown-${he}`],
+      G
+    ), { canClear: ve, handleClear: ye } = ze({
+      multiple: e,
+      clearable: _,
+      isEmpty: y,
+      disabled: l,
+      readOnly: s,
+      setValue: B,
+      setOpen: S
+    }), {
+      chipGroupProps: Se,
+      handleBlur: V,
+      selectedChip: Ce,
+      setSelectedChip: Oe,
+      enabled: Pe,
+      selectPreviousChip: ge,
+      selectNextChip: Ie,
+      options: $e,
+      deselectOptionValue: Ne
+    } = Ge({
+      multiple: e,
+      disabled: l,
+      readOnly: s,
+      open: E,
+      setOpen: S,
+      options: M,
+      deselectOptionValue: D,
+      fieldRef: be.domReference
+    }), { getKeyboardProps: Be } = We({
+      multiple: e,
+      disabled: l,
+      readOnly: s,
+      open: E,
+      setOpen: S,
+      chips: {
+        enabled: Pe,
+        selectedChip: Ce,
+        setSelectedChip: Oe,
+        selectPreviousChip: ge,
+        selectNextChip: Ie,
+        options: $e,
+        deselectOptionValue: Ne
+      }
+    }), we = C(
+      () => et(e),
+      [e]
+    ), Me = k(() => {
+      w(), V();
+    }, [w, V]), { ref: De, ...Ee } = Be(ue());
+    return /* @__PURE__ */ x(Ye, { value: pe, children: [
+      /* @__PURE__ */ x("div", { className: xe, style: { maxWidth: q }, children: [
+        /* @__PURE__ */ i(
+          He,
+          {
+            ctxHtmlFor: I,
+            ctxDisabled: l,
+            ctxRequired: $ && !W,
+            ctxId: N,
+            children: P
+          }
+        ),
+        /* @__PURE__ */ i(
+          Qe,
+          {
+            id: I,
+            disabled: l,
+            readOnly: s,
+            required: $,
+            invalid: f.invalid,
+            errorMessage: f.errorMessage,
+            labelId: !u.ariaLabel && P ? N : void 0,
+            ariaLabel: u.ariaLabel,
+            describedBy: f.describedBy,
+            contentBefore: H,
+            contentAfter: j,
+            chips: /* @__PURE__ */ i(
+              Je,
+              {
+                multiple: e,
+                disabled: l,
+                readOnly: s,
+                selectedOptions: M,
+                deselectOptionValue: D,
+                chipGroupProps: Se,
+                input: /* @__PURE__ */ i(
+                  "input",
+                  {
+                    className: r[`${O}field__input`],
+                    placeholder: e && !y ? "" : U,
+                    disabled: l,
+                    readOnly: !0,
+                    autoComplete: "off",
+                    tabIndex: -1,
+                    autoFocus: !1,
+                    value: e ? "" : me ?? b
+                  }
+                )
+              }
+            ),
+            hasClearButton: ve,
+            onClear: ye,
+            onBlur: Me,
+            ...Ee,
+            ref: De
+          }
+        ),
+        /* @__PURE__ */ x(je, { ctxId: se, ctxDisabled: l, children: [
+          g,
+          de && /* @__PURE__ */ i(Ae, { id: ie, appearance: "negative", children: d })
+        ] }),
+        te(ae)
+      ] }),
+      /* @__PURE__ */ x("select", { ...ee, ...ce, hidden: !0, multiple: e, children: [
+        /* @__PURE__ */ i("option", { value: "", children: "empty" }),
+        A
+      ] }),
+      /* @__PURE__ */ i(
+        Te,
+        {
+          ...fe,
+          className: r[`${O}dropdown`],
+          disabled: l,
+          readOnly: s,
+          theme: v,
+          multiple: e,
+          children: /* @__PURE__ */ i(L, { role: "listbox", children: c.map((o) => {
+            const t = p.get(o);
+            if (!t) return null;
+            const Ve = we.isSelected(
+              t.value,
+              n
+            );
+            return /* @__PURE__ */ Fe(
+              L.Item,
+              {
+                ...t,
+                className: F(
+                  r[`${O}option`],
+                  t.className
+                ),
+                defaultSelected: Ve,
+                key: `opt-${t.value ?? t.label}`,
+                kind: e ? "checkbox" : "singleCheckMark",
+                role: "option"
+              }
+            );
+          }) })
+        }
+      )
+    ] });
+  }
+), R = lt;
+R.Option = Ze;
+R.displayName = "Select";
+export {
+  R as Select,
+  R as default
+};

package/lib/Select/Select.types.cjs.js

@@ -0,0 +1 @@
+"use strict";

package/lib/Select/Select.types.d.ts

@@ -0,0 +1,24 @@
+import { FloatingContext, UseInteractionsReturn } from '@floating-ui/react';
+import { CSSProperties, MutableRefObject } from 'react';
+import { ThemeTypes } from '@viasat/beam-shared/utils';
+export interface SelectDropdownProps {
+    isMounted: boolean;
+    status: string;
+    nodeId: string;
+    context: FloatingContext;
+    getFloatingProps: UseInteractionsReturn['getFloatingProps'];
+    floatingStyles: CSSProperties;
+    labelsRef: MutableRefObject<string[]>;
+    elementsRef: MutableRefObject<HTMLElement[]>;
+    getItemProps: UseInteractionsReturn['getItemProps'];
+    setOpen: (open: boolean) => void;
+    setFloating: (node: HTMLElement | null) => void;
+    activeIndex: number | null;
+    onItemClick?: (index: number) => void;
+    disabled?: boolean;
+    readOnly?: boolean;
+    theme?: ThemeTypes;
+    className?: string;
+    children?: React.ReactNode;
+    multiple?: boolean;
+}

package/lib/Select/Select.types.es.js

@@ -0,0 +1 @@
+

package/lib/Select/SelectDropdown.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),r=require("@floating-ui/react"),B=require("../Box/Box.cjs.js"),C=require("clsx"),a=require("../../chunks/classNames.DAeKwerT.js"),P=require("../../chunks/constants.hwjHOsvT.js");require("../_Options/Option.context.cjs.js");const v=require("../_Options/Option.cjs.js"),y=require("react");require("../../chunks/form.context.B1PXIJNq.js");require("../Form/contexts/label.context.cjs.js");require("../Form/contexts/helperText.context.cjs.js");const S=require("../ActionList/ActionList.context.cjs.js"),O=require("../../chunks/floatingui.module.D3Aw_aYe.js"),M=require("../../chunks/popover.module.Dum8SaSU.js"),{baseClassNamePrefix:w}=a.getBEMClassNames("floatingui"),{baseClassNamePrefix:A}=a.getBEMClassNames("popover"),L=[v.Option],T=({setOpen:t,isMounted:n,status:l,nodeId:c,context:u,getFloatingProps:d,floatingStyles:x,labelsRef:f,elementsRef:q,getItemProps:g,setFloating:p,disabled:m,readOnly:N,theme:o,className:b,children:F,multiple:i,activeIndex:_,onItemClick:s})=>{const j=y.useCallback(h=>{s==null||s(h),!i&&t(!1)},[i,s,t]);return n?e.jsx(r.FloatingTree,{children:e.jsx(r.FloatingNode,{id:c,children:e.jsx(r.FloatingPortal,{children:e.jsx(r.FloatingFocusManager,{context:u,modal:!1,initialFocus:0,disabled:m||N,closeOnFocusOut:!0,restoreFocus:!0,returnFocus:!0,guards:!0,order:["content","reference"],children:e.jsx(B.Box,{"data-status":l,className:C(o&&P.themeClassName(o),O.floatinguiStyles[w],M.popoverStyles[A],b),...d(),style:x,ref:p,children:e.jsx(S.ActionListContextProvider,{allowChildrenTypes:L,getItemProps:g,itemsFocusable:!1,onItemClick:j,labelsRef:f,elementsRef:q,activeIndex:_,children:F})})})})})}):null};exports.SelectDropdown=T;

package/lib/Select/SelectDropdown.d.ts

@@ -0,0 +1,2 @@
+import { SelectDropdownProps } from './Select.types';
+export declare const SelectDropdown: ({ setOpen, isMounted, status, nodeId, context, getFloatingProps, floatingStyles, labelsRef, elementsRef, getItemProps, setFloating, disabled, readOnly, theme, className: _className, children, multiple, activeIndex, onItemClick, }: SelectDropdownProps) => import("react/jsx-runtime").JSX.Element | null;

package/lib/Select/SelectDropdown.es.js

@@ -0,0 +1,88 @@
+import { jsx as r } from "react/jsx-runtime";
+import { FloatingTree as v, FloatingNode as y, FloatingPortal as B, FloatingFocusManager as S } from "@floating-ui/react";
+import { Box as w } from "../Box/Box.es.js";
+import M from "clsx";
+import { g as a } from "../../chunks/classNames.DNsS4J__.js";
+import { t as O } from "../../chunks/constants.BBi77pmH.js";
+import "../_Options/Option.context.es.js";
+import { Option as T } from "../_Options/Option.es.js";
+import { useCallback as j } from "react";
+import "../../chunks/form.context.CNWjF5qA.js";
+import "../Form/contexts/label.context.es.js";
+import "../Form/contexts/helperText.context.es.js";
+import { ActionListContextProvider as A } from "../ActionList/ActionList.context.es.js";
+import { f as D } from "../../chunks/floatingui.module.BcBFebz0.js";
+import { p as E } from "../../chunks/popover.module.C6KFea25.js";
+const { baseClassNamePrefix: L } = a("floatingui"), { baseClassNamePrefix: q } = a("popover"), z = [T], I = ({
+  setOpen: e,
+  isMounted: i,
+  status: l,
+  nodeId: m,
+  context: n,
+  getFloatingProps: f,
+  floatingStyles: p,
+  labelsRef: c,
+  elementsRef: u,
+  getItemProps: d,
+  setFloating: g,
+  disabled: F,
+  readOnly: x,
+  theme: s,
+  className: N,
+  children: h,
+  multiple: t,
+  activeIndex: C,
+  onItemClick: o
+}) => {
+  const P = j(
+    (b) => {
+      o == null || o(b), !t && e(!1);
+    },
+    [t, o, e]
+  );
+  return i ? /* @__PURE__ */ r(v, { children: /* @__PURE__ */ r(y, { id: m, children: /* @__PURE__ */ r(B, { children: /* @__PURE__ */ r(
+    S,
+    {
+      context: n,
+      modal: !1,
+      initialFocus: 0,
+      disabled: F || x,
+      closeOnFocusOut: !0,
+      restoreFocus: !0,
+      returnFocus: !0,
+      guards: !0,
+      order: ["content", "reference"],
+      children: /* @__PURE__ */ r(
+        w,
+        {
+          "data-status": l,
+          className: M(
+            s && O(s),
+            D[L],
+            E[q],
+            N
+          ),
+          ...f(),
+          style: p,
+          ref: g,
+          children: /* @__PURE__ */ r(
+            A,
+            {
+              allowChildrenTypes: z,
+              getItemProps: d,
+              itemsFocusable: !1,
+              onItemClick: P,
+              labelsRef: c,
+              elementsRef: u,
+              activeIndex: C,
+              children: h
+            }
+          )
+        }
+      )
+    }
+  ) }) }) }) : null;
+};
+export {
+  I as SelectDropdown
+};

package/lib/Select/SelectField.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("react/jsx-runtime"),C=require("react"),q=require("../CloseButton/CloseButton.cjs.js"),s=require("../../chunks/combobox.module.XIDBRMf_.js"),$=require("../../chunks/classNames.DAeKwerT.js");require("../../chunks/constants.hwjHOsvT.js");const{subElementClassPrefix:l}=$.getBEMClassNames("combobox"),a=C.forwardRef(({id:c,disabled:i,readOnly:n,required:u,invalid:m,errorMessage:b,labelId:r,ariaLabel:t,describedBy:_,contentBefore:o,contentAfter:d,chips:f,hasClearButton:x,onClear:v,...y},N)=>{const j=i?void 0:0;return e.jsxs("div",{className:s.styles[`${l}field`],tabIndex:j,"aria-readonly":n,"aria-disabled":i,"aria-required":u,"aria-invalid":m,"aria-errormessage":b||void 0,"aria-labelledby":!t&&r?r:void 0,"aria-label":t,"aria-describedby":_,id:c,ref:N,...y,children:[o&&e.jsx("div",{className:s.styles[`${l}field__before`],children:e.jsx("div",{className:s.styles[`${l}field__content-before`],children:o})}),f,e.jsxs("div",{className:s.styles[`${l}field__after`],children:[d&&e.jsx("div",{className:s.styles[`${l}field__content-after`],children:d}),x&&e.jsx(q.CloseButton,{className:s.styles[`${l}field__clear`],"aria-label":"Clear selection",onClickCapture:v,tabIndex:-1,size:"sm"}),e.jsx("div",{className:s.styles[`${l}field__chevron`]})]})]})});a.displayName="ComboboxField";exports.SelectField=a;exports.default=a;

package/lib/Select/SelectField.d.ts

@@ -0,0 +1,26 @@
+import { default as React } from 'react';
+export interface SelectFieldProps {
+    id?: string;
+    disabled: boolean;
+    readOnly: boolean;
+    required: boolean;
+    invalid: boolean;
+    errorMessage?: string;
+    labelId?: string;
+    ariaLabel?: string;
+    describedBy?: string;
+    contentBefore?: React.ReactNode;
+    contentAfter?: React.ReactNode;
+    chips: React.ReactNode;
+    hasClearButton: boolean;
+    onClear?: (e: React.MouseEvent<HTMLButtonElement>) => void;
+    onKeyDownCapture?: React.KeyboardEventHandler<HTMLDivElement>;
+    onKeyDown?: React.KeyboardEventHandler<HTMLDivElement>;
+    onBlur?: React.FocusEventHandler<HTMLDivElement>;
+}
+/**
+ * Structural field container for Select. Handles ARIA attributes and layout chrome.
+ * Pure presentational logic; all state is provided via props.
+ */
+export declare const SelectField: React.ForwardRefExoticComponent<SelectFieldProps & React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+export default SelectField;

package/lib/Select/SelectField.es.js

@@ -0,0 +1,68 @@
+import { jsxs as m, jsx as i } from "react/jsx-runtime";
+import $ from "react";
+import { CloseButton as h } from "../CloseButton/CloseButton.es.js";
+import { s as e } from "../../chunks/combobox.module.DNJ3sGlK.js";
+import { g as y } from "../../chunks/classNames.DNsS4J__.js";
+import "../../chunks/constants.BBi77pmH.js";
+const { subElementClassPrefix: a } = y("combobox"), g = $.forwardRef(
+  ({
+    id: t,
+    disabled: r,
+    readOnly: c,
+    required: f,
+    invalid: n,
+    errorMessage: _,
+    labelId: l,
+    ariaLabel: s,
+    describedBy: b,
+    contentBefore: d,
+    contentAfter: o,
+    chips: v,
+    hasClearButton: p,
+    onClear: N,
+    ...x
+  }, u) => {
+    const C = r ? void 0 : 0;
+    return /* @__PURE__ */ m(
+      "div",
+      {
+        className: e[`${a}field`],
+        tabIndex: C,
+        "aria-readonly": c,
+        "aria-disabled": r,
+        "aria-required": f,
+        "aria-invalid": n,
+        "aria-errormessage": _ || void 0,
+        "aria-labelledby": !s && l ? l : void 0,
+        "aria-label": s,
+        "aria-describedby": b,
+        id: t,
+        ref: u,
+        ...x,
+        children: [
+          d && /* @__PURE__ */ i("div", { className: e[`${a}field__before`], children: /* @__PURE__ */ i("div", { className: e[`${a}field__content-before`], children: d }) }),
+          v,
+          /* @__PURE__ */ m("div", { className: e[`${a}field__after`], children: [
+            o && /* @__PURE__ */ i("div", { className: e[`${a}field__content-after`], children: o }),
+            p && /* @__PURE__ */ i(
+              h,
+              {
+                className: e[`${a}field__clear`],
+                "aria-label": "Clear selection",
+                onClickCapture: N,
+                tabIndex: -1,
+                size: "sm"
+              }
+            ),
+            /* @__PURE__ */ i("div", { className: e[`${a}field__chevron`] })
+          ] })
+        ]
+      }
+    );
+  }
+);
+g.displayName = "ComboboxField";
+export {
+  g as SelectField,
+  g as default
+};

package/lib/Select/index.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("./Select.cjs.js");exports.Select=e.Select;exports.default=e.Select;

package/lib/Select/index.d.ts

@@ -0,0 +1,3 @@
+import { Select } from './Select';
+export * from './Select';
+export default Select;

package/lib/Select/index.es.js

@@ -0,0 +1,5 @@
+import { Select as t } from "./Select.es.js";
+export {
+  t as Select,
+  t as default
+};

package/lib/Select/useClearSelection.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const d=require("react");function a({multiple:r,clearable:l,isEmpty:n,disabled:o,readOnly:c,setValue:t,setOpen:u}){const e=!!l&&!n&&!o&&!c,i=d.useCallback(s=>{e&&(s.preventDefault(),t(r?[]:void 0),u(!0))},[e,t,r,u]);return{canClear:e,handleClear:i}}exports.default=a;exports.useClearSelection=a;

package/lib/Select/useClearSelection.d.ts

@@ -0,0 +1,19 @@
+interface UseClearSelectionArgs<ValueType> {
+    multiple: boolean;
+    clearable: boolean | undefined;
+    isEmpty: boolean;
+    disabled: boolean;
+    readOnly: boolean;
+    setValue: (value: ValueType) => void;
+    setOpen: (open: boolean) => void;
+}
+interface UseClearSelectionResult {
+    canClear: boolean;
+    handleClear: (e: React.MouseEvent<HTMLButtonElement>) => void;
+}
+/**
+ * Provides clear button availability + handler logic for Combobox.
+ * Separates decision (canClear) from effect (handleClear) for easier testing.
+ */
+export declare function useClearSelection<ValueType = unknown>({ multiple, clearable, isEmpty, disabled, readOnly, setValue, setOpen, }: UseClearSelectionArgs<ValueType>): UseClearSelectionResult;
+export default useClearSelection;

package/lib/Select/useClearSelection.es.js

@@ -0,0 +1,22 @@
+import { useCallback as i } from "react";
+function d({
+  multiple: e,
+  clearable: t,
+  isEmpty: o,
+  disabled: c,
+  readOnly: l,
+  setValue: a,
+  setOpen: n
+}) {
+  const r = !!t && !o && !c && !l, u = i(
+    (f) => {
+      r && (f.preventDefault(), a(e ? [] : void 0), n(!0));
+    },
+    [r, a, e, n]
+  );
+  return { canClear: r, handleClear: u };
+}
+export {
+  d as default,
+  d as useClearSelection
+};

package/lib/Select/useSelectA11y.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const _=require("react"),e=require("../Form/hooks/useAccessibleId.hook.cjs.js");require("react/jsx-runtime");require("../../chunks/form.context.B1PXIJNq.js");const l=require("clsx");function n({helperText:a,externalDescribedBy:b,error:s,errorShown:I,invalid:t}){const{id:c}=e.useAccessibleId(),{id:i}=e.useAccessibleId(),{id:o}=e.useAccessibleId(),{id:d}=e.useAccessibleId(),A=!!(s!=null&&s.length),r=l(a&&i,b)||void 0,u=l(A&&c,I&&o)||void 0;return _.useMemo(()=>({ids:{helperTextId:i,errorId:c,validationErrorsId:o,labelId:d},aria:{describedBy:r,errorMessage:u,invalid:t}}),[i,c,o,d,r,u,t])}exports.default=n;exports.useSelectA11y=n;

package/lib/Select/useSelectA11y.d.ts

@@ -0,0 +1,26 @@
+import { ReactNode } from 'react';
+export interface UseSelectA11yParams {
+    helperText: ReactNode;
+    externalDescribedBy?: string;
+    error?: boolean | string;
+    errorShown: boolean;
+    invalid: boolean;
+}
+export interface UseSelectA11yResult {
+    ids: {
+        helperTextId: string;
+        errorId: string;
+        validationErrorsId: string;
+        labelId: string;
+    };
+    aria: {
+        describedBy?: string;
+        errorMessage?: string;
+        invalid: boolean;
+    };
+}
+/**
+ * Consolidates accessible ID generation and aria-* attribute composition for Select.
+ */
+export declare function useSelectA11y({ helperText, externalDescribedBy, error, errorShown, invalid, }: UseSelectA11yParams): UseSelectA11yResult;
+export default useSelectA11y;

package/lib/Select/useSelectA11y.es.js

@@ -0,0 +1,28 @@
+import { useMemo as f } from "react";
+import { useAccessibleId as e } from "../Form/hooks/useAccessibleId.hook.es.js";
+import "react/jsx-runtime";
+import "../../chunks/form.context.CNWjF5qA.js";
+import m from "clsx";
+function M({
+  helperText: a,
+  externalDescribedBy: l,
+  error: o,
+  errorShown: p,
+  invalid: i
+}) {
+  const { id: s } = e(), { id: t } = e(), { id: d } = e(), { id: r } = e(), u = !!(o != null && o.length), c = m(a && t, l) || void 0, n = m(
+    u && s,
+    p && d
+  ) || void 0;
+  return f(
+    () => ({
+      ids: { helperTextId: t, errorId: s, validationErrorsId: d, labelId: r },
+      aria: { describedBy: c, errorMessage: n, invalid: i }
+    }),
+    [t, s, d, r, c, n, i]
+  );
+}
+export {
+  M as default,
+  M as useSelectA11y
+};

package/lib/Select/useSelectChipKeyboard.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("react");function D(p){const{multiple:h,open:t,setOpen:a,chips:{enabled:C,selectedChip:l,setSelectedChip:n,selectPreviousChip:i,selectNextChip:o,options:u,deselectOptionValue:f}}=p,r=h&&C&&u.length>0,d=c.useCallback(e=>r?e.key==="ArrowLeft"?(e.preventDefault(),t&&a(!1),i(l),!0):e.key==="ArrowRight"?(e.preventDefault(),t&&a(!1),o(l),!0):!1:!1,[r,t,a,i,l,o]),k=c.useCallback(e=>{if(!r)return!1;if(e.key==="Enter"&&l!==null&&!t){e.preventDefault();const s=u[l];return s&&f(s.value),n(null),!0}return!1},[r,l,t,u,f,n]),y=c.useCallback(e=>r&&e.key==="Escape"&&l!==null&&!t?(e.preventDefault(),n(null),!0):!1,[r,l,t,n]),b=c.useCallback(e=>{if(!r||e.key!=="Backspace"&&e.key!=="Delete")return!1;if(e.preventDefault(),t&&a(!1),l===null)i(null);else{const s=u[l];s&&(f(s.value),e.key==="Backspace"?l===0?n(null):i(l):e.key==="Delete"&&l>=u.length-1&&n(null))}return!0},[r,t,a,l,i,u,f,n]);return{isChipMode:r,handleHorizontalChipNav:d,handleChipEnter:k,handleChipEscape:y,handleChipRemoval:b}}exports.useSelectChipKeyboard=D;

package/lib/Select/useSelectChipKeyboard.d.ts

@@ -0,0 +1,32 @@
+import { OptionProps } from '../_Options';
+export interface ChipKeyboardParams {
+    multiple: boolean;
+    open: boolean;
+    setOpen: (open: boolean) => void;
+    chips: {
+        enabled: boolean;
+        selectedChip: number | null;
+        setSelectedChip: (index: number | null) => void;
+        selectPreviousChip: (prev: number | null) => void;
+        selectNextChip: (prev: number | null) => void;
+        options: OptionProps[];
+        deselectOptionValue: (value: string | undefined) => void;
+    };
+}
+/**
+ * Chip-specific keyboard behaviors extracted from the general keyboard manager.
+ * Responsibilities:
+ *  - Horizontal arrow navigation between chips (ArrowLeft/ArrowRight)
+ *  - Chip removal (Backspace/Delete) with focus shifting rules
+ *  - Enter on a focused chip to remove it (when dropdown closed)
+ *  - Determining whether we are in "chip mode" (multi + chips enabled + options present)
+ *
+ * Returns specific handler functions and an `isChipMode` flag consumed by the parent keyboard manager.
+ */
+export declare function useSelectChipKeyboard(params: ChipKeyboardParams): {
+    isChipMode: boolean;
+    handleHorizontalChipNav: (event: React.KeyboardEvent) => boolean;
+    handleChipEnter: (event: React.KeyboardEvent) => boolean;
+    handleChipEscape: (event: React.KeyboardEvent) => boolean;
+    handleChipRemoval: (event: React.KeyboardEvent) => boolean;
+};