@planningcenter/tapestry 3.2.2-rc.8 → 3.2.2

package/dist/components/NumberStepper/NumberStepper.d.ts

@@ -1,6 +1,8 @@
 import "../button/btn.css";
 import "./index.css";
-import React, { type AriaAttributes } from "react";
+import type { CombineAriaPropsWithCustomProps } from "../../utilities/reactAriaProps";
+import React from "react";
+import { type NumberFieldProps as AriaNumberFieldProps } from "react-aria-components";
 export type NumberStepperSize = "md" | "lg";
 export interface NumberStepperProps {
     /** The default uncontrolled value. */
@@ -9,8 +11,6 @@ export interface NumberStepperProps {
     description?: string;
     /** Disables the input and stepper buttons. */
     disabled?: boolean;
-    /** Formatting options for the displayed value. Uses `Intl.NumberFormat`. */
-    formatOptions?: Intl.NumberFormatOptions;
     /** If `true`, renders the label visually hidden. */
     hideLabel?: boolean;
     /** If `true`, applies error styling to the field and description. */
@@ -21,24 +21,16 @@ export interface NumberStepperProps {
     max?: number;
     /** Minimum allowed value. */
     min?: number;
-    /** Field name for form submission. */
-    name?: string;
-    /** Called when the value changes. */
-    onChange?: (value: number) => void;
     /** Allows the value to be read but not changed. */
     readOnly?: boolean;
     /** If `true`, appends an asterisk after the label text. */
     required?: boolean;
     /** The size of the number stepper. */
     size?: NumberStepperSize;
-    /** Amount to increment or decrement by. Defaults to `1`. */
-    step?: number;
-    /** The controlled value. */
-    value?: number;
 }
-export type NumberStepperElementProps = NumberStepperProps & Omit<AriaAttributes, keyof NumberStepperProps> & {
-    className?: string;
-    id?: string;
-};
-export declare function NumberStepper({ className, defaultValue, description, disabled, formatOptions, hideLabel, id, invalid, label, max, min, name, onChange, readOnly, required, size, step, value, ...restProps }: NumberStepperElementProps): React.JSX.Element;
+type AriaNumberFieldPropsToOmit = "children" | "render" | "slot" | "validate" | "validationBehavior";
+type AriaNumberFieldPropsToInclude = "formatOptions" | "name" | "onChange" | "step" | "value";
+export type NumberStepperElementProps = CombineAriaPropsWithCustomProps<AriaNumberFieldProps, NumberStepperProps, AriaNumberFieldPropsToOmit, AriaNumberFieldPropsToInclude>;
+export declare function NumberStepper({ className, defaultValue, description, disabled, hideLabel, invalid, label, max, min, readOnly, required, size, ...restProps }: NumberStepperElementProps): React.JSX.Element;
+export {};
 //# sourceMappingURL=NumberStepper.d.ts.map

package/dist/components/NumberStepper/NumberStepper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NumberStepper.d.ts","sourceRoot":"","sources":["../../../src/components/NumberStepper/NumberStepper.tsx"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,CAAA;AAC1B,OAAO,aAAa,CAAA;AAIpB,OAAO,KAAK,EAAE,EAAE,KAAK,cAAc,EAAE,MAAM,OAAO,CAAA;AAUlD,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAAA;AAE3C,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gGAAgG;IAChG,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAA;IACxC,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,qCAAqC;IACrC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,sCAAsC;IACtC,IAAI,CAAC,EAAE,iBAAiB,CAAA;IACxB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,GACxD,IAAI,CAAC,cAAc,EAAE,MAAM,kBAAkB,CAAC,GAAG;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ,CAAA;AAEH,wBAAgB,aAAa,CAAC,EAC5B,SAAS,EACT,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,aAAa,EACb,SAAS,EACT,EAAE,EACF,OAAO,EACP,KAAK,EACL,GAAG,EACH,GAAG,EACH,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,IAAW,EACX,IAAI,EACJ,KAAK,EACL,GAAG,SAAS,EACb,EAAE,yBAAyB,qBAwD3B"}
+{"version":3,"file":"NumberStepper.d.ts","sourceRoot":"","sources":["../../../src/components/NumberStepper/NumberStepper.tsx"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,CAAA;AAC1B,OAAO,aAAa,CAAA;AAGpB,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAA;AAEhF,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAML,KAAK,gBAAgB,IAAI,oBAAoB,EAE9C,MAAM,uBAAuB,CAAA;AAE9B,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAAA;AAE3C,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gGAAgG;IAChG,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,sCAAsC;IACtC,IAAI,CAAC,EAAE,iBAAiB,CAAA;CACzB;AAED,KAAK,0BAA0B,GAC3B,UAAU,GACV,QAAQ,GACR,MAAM,GACN,UAAU,GACV,oBAAoB,CAAA;AAExB,KAAK,6BAA6B,GAC9B,eAAe,GACf,MAAM,GACN,UAAU,GACV,MAAM,GACN,OAAO,CAAA;AAEX,MAAM,MAAM,yBAAyB,GAAG,+BAA+B,CACrE,oBAAoB,EACpB,kBAAkB,EAClB,0BAA0B,EAC1B,6BAA6B,CAC9B,CAAA;AAED,wBAAgB,aAAa,CAAC,EAC5B,SAAS,EACT,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,SAAS,EACT,OAAO,EACP,KAAK,EACL,GAAG,EACH,GAAG,EACH,QAAQ,EACR,QAAQ,EACR,IAAW,EACX,GAAG,SAAS,EACb,EAAE,yBAAyB,qBAkD3B"}

package/dist/components/NumberStepper/NumberStepper.js

@@ -3,9 +3,9 @@ import classNames from 'classnames';
 import React__default from 'react';
 import { NumberField, Label, Group, Input, Button, Text } from 'react-aria-components';
 
-function NumberStepper({ className, defaultValue, description, disabled, formatOptions, hideLabel, id, invalid, label, max, min, name, onChange, readOnly, required, size = "md", step, value, ...restProps }) {
+function NumberStepper({ className, defaultValue, description, disabled, hideLabel, invalid, label, max, min, readOnly, required, size = "md", ...restProps }) {
     const combinedClassName = classNames("tds-number-stepper", { "tds-number-stepper--lg": size === "lg" }, className);
-    return (React__default.createElement(NumberField, { ...restProps, "aria-label": hideLabel ? label : undefined, className: combinedClassName, defaultValue: defaultValue, formatOptions: formatOptions, id: id, isDisabled: disabled, isInvalid: invalid, isReadOnly: readOnly, isRequired: required, maxValue: max, minValue: min, name: name, onChange: onChange ?? undefined, step: step, value: value },
+    return (React__default.createElement(NumberField, { ...restProps, "aria-label": hideLabel ? label : undefined, className: combinedClassName, defaultValue: defaultValue, isDisabled: disabled, isInvalid: invalid, isReadOnly: readOnly, isRequired: required, maxValue: max, minValue: min },
         !hideLabel && (React__default.createElement(Label, { className: "tds-number-stepper-label" }, label)),
         React__default.createElement(Group, { className: "tds-number-stepper-field" },
             React__default.createElement(Input, { className: "tds-number-stepper-input" }),

package/dist/components/NumberStepper/NumberStepper.js.map

@@ -1 +1 @@
-{"version":3,"file":"NumberStepper.js","sources":["../../../src/components/NumberStepper/NumberStepper.tsx"],"sourcesContent":["import \"../button/btn.css\"\nimport \"./index.css\"\n\nimport Icon from \"@utilities/Icon\"\nimport classNames from \"classnames\"\nimport React, { type AriaAttributes } from \"react\"\nimport {\n  Button,\n  Group,\n  Input,\n  Label,\n  NumberField as AriaNumberField,\n  Text,\n} from \"react-aria-components\"\n\nexport type NumberStepperSize = \"md\" | \"lg\"\n\nexport interface NumberStepperProps {\n  /** The default uncontrolled value. */\n  defaultValue?: number\n  /** Helper text displayed below the component. Styled as error text when `invalid` is `true`. */\n  description?: string\n  /** Disables the input and stepper buttons. */\n  disabled?: boolean\n  /** Formatting options for the displayed value. Uses `Intl.NumberFormat`. */\n  formatOptions?: Intl.NumberFormatOptions\n  /** If `true`, renders the label visually hidden. */\n  hideLabel?: boolean\n  /** If `true`, applies error styling to the field and description. */\n  invalid?: boolean\n  /** Accessible label for the field. */\n  label: string\n  /** Maximum allowed value. */\n  max?: number\n  /** Minimum allowed value. */\n  min?: number\n  /** Field name for form submission. */\n  name?: string\n  /** Called when the value changes. */\n  onChange?: (value: number) => void\n  /** Allows the value to be read but not changed. */\n  readOnly?: boolean\n  /** If `true`, appends an asterisk after the label text. */\n  required?: boolean\n  /** The size of the number stepper. */\n  size?: NumberStepperSize\n  /** Amount to increment or decrement by. Defaults to `1`. */\n  step?: number\n  /** The controlled value. */\n  value?: number\n}\n\nexport type NumberStepperElementProps = NumberStepperProps &\n  Omit<AriaAttributes, keyof NumberStepperProps> & {\n    className?: string\n    id?: string\n  }\n\nexport function NumberStepper({\n  className,\n  defaultValue,\n  description,\n  disabled,\n  formatOptions,\n  hideLabel,\n  id,\n  invalid,\n  label,\n  max,\n  min,\n  name,\n  onChange,\n  readOnly,\n  required,\n  size = \"md\",\n  step,\n  value,\n  ...restProps\n}: NumberStepperElementProps) {\n  const combinedClassName = classNames(\n    \"tds-number-stepper\",\n    { \"tds-number-stepper--lg\": size === \"lg\" },\n    className\n  )\n\n  return (\n    <AriaNumberField\n      {...restProps}\n      aria-label={hideLabel ? label : undefined}\n      className={combinedClassName}\n      defaultValue={defaultValue}\n      formatOptions={formatOptions}\n      id={id}\n      isDisabled={disabled}\n      isInvalid={invalid}\n      isReadOnly={readOnly}\n      isRequired={required}\n      maxValue={max}\n      minValue={min}\n      name={name}\n      onChange={onChange ?? undefined}\n      step={step}\n      value={value}\n    >\n      {!hideLabel && (\n        <Label className=\"tds-number-stepper-label\">{label}</Label>\n      )}\n      <Group className=\"tds-number-stepper-field\">\n        <Input className=\"tds-number-stepper-input\" />\n        <Button\n          className=\"tds-btn tds-btn--infield tds-number-stepper-button\"\n          slot=\"decrement\"\n        >\n          <Icon aria-hidden symbol=\"general#minus\" />\n        </Button>\n        <Button\n          className=\"tds-btn tds-btn--infield tds-number-stepper-button\"\n          slot=\"increment\"\n        >\n          <Icon aria-hidden symbol=\"general#plus\" />\n        </Button>\n      </Group>\n      {description && (\n        <Text className=\"tds-number-stepper-description\" slot=\"description\">\n          <Icon\n            aria-hidden\n            className=\"tds-number-stepper-description-invalid-icon\"\n            symbol=\"general#exclamation-triangle\"\n          />\n          {description}\n        </Text>\n      )}\n    </AriaNumberField>\n  )\n}\n"],"names":["React","AriaNumberField"],"mappings":";;;;;AA0DM,SAAU,aAAa,CAAC,EAC5B,SAAS,EACT,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,aAAa,EACb,SAAS,EACT,EAAE,EACF,OAAO,EACP,KAAK,EACL,GAAG,EACH,GAAG,EACH,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,IAAI,GAAG,IAAI,EACX,IAAI,EACJ,KAAK,EACL,GAAG,SAAS,EACc,EAAA;AAC1B,IAAA,MAAM,iBAAiB,GAAG,UAAU,CAClC,oBAAoB,EACpB,EAAE,wBAAwB,EAAE,IAAI,KAAK,IAAI,EAAE,EAC3C,SAAS,CACV;AAED,IAAA,QACEA,cAAA,CAAA,aAAA,CAACC,WAAe,EAAA,EAAA,GACV,SAAS,EAAA,YAAA,EACD,SAAS,GAAG,KAAK,GAAG,SAAS,EACzC,SAAS,EAAE,iBAAiB,EAC5B,YAAY,EAAE,YAAY,EAC1B,aAAa,EAAE,aAAa,EAC5B,EAAE,EAAE,EAAE,EACN,UAAU,EAAE,QAAQ,EACpB,SAAS,EAAE,OAAO,EAClB,UAAU,EAAE,QAAQ,EACpB,UAAU,EAAE,QAAQ,EACpB,QAAQ,EAAE,GAAG,EACb,QAAQ,EAAE,GAAG,EACb,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,QAAQ,IAAI,SAAS,EAC/B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,EAAA;AAEX,QAAA,CAAC,SAAS,KACTD,cAAA,CAAA,aAAA,CAAC,KAAK,EAAA,EAAC,SAAS,EAAC,0BAA0B,EAAA,EAAE,KAAK,CAAS,CAC5D;AACD,QAAAA,cAAA,CAAA,aAAA,CAAC,KAAK,EAAA,EAAC,SAAS,EAAC,0BAA0B,EAAA;AACzC,YAAAA,cAAA,CAAA,aAAA,CAAC,KAAK,EAAA,EAAC,SAAS,EAAC,0BAA0B,EAAA,CAAG;YAC9CA,cAAA,CAAA,aAAA,CAAC,MAAM,IACL,SAAS,EAAC,oDAAoD,EAC9D,IAAI,EAAC,WAAW,EAAA;AAEhB,gBAAAA,cAAA,CAAA,aAAA,CAAC,IAAI,EAAA,EAAA,aAAA,EAAA,IAAA,EAAa,MAAM,EAAC,eAAe,GAAG,CACpC;YACTA,cAAA,CAAA,aAAA,CAAC,MAAM,IACL,SAAS,EAAC,oDAAoD,EAC9D,IAAI,EAAC,WAAW,EAAA;AAEhB,gBAAAA,cAAA,CAAA,aAAA,CAAC,IAAI,EAAA,EAAA,aAAA,EAAA,IAAA,EAAa,MAAM,EAAC,cAAc,EAAA,CAAG,CACnC,CACH;QACP,WAAW,KACVA,cAAA,CAAA,aAAA,CAAC,IAAI,EAAA,EAAC,SAAS,EAAC,gCAAgC,EAAC,IAAI,EAAC,aAAa,EAAA;YACjEA,cAAA,CAAA,aAAA,CAAC,IAAI,yBAEH,SAAS,EAAC,6CAA6C,EACvD,MAAM,EAAC,8BAA8B,EAAA,CACrC;AACD,YAAA,WAAW,CACP,CACR,CACe;AAEtB;;;;"}
+{"version":3,"file":"NumberStepper.js","sources":["../../../src/components/NumberStepper/NumberStepper.tsx"],"sourcesContent":["import \"../button/btn.css\"\nimport \"./index.css\"\n\nimport Icon from \"@utilities/Icon\"\nimport type { CombineAriaPropsWithCustomProps } from \"@utilities/reactAriaProps\"\nimport classNames from \"classnames\"\nimport React from \"react\"\nimport {\n  Button,\n  Group,\n  Input,\n  Label,\n  NumberField as AriaNumberField,\n  type NumberFieldProps as AriaNumberFieldProps,\n  Text,\n} from \"react-aria-components\"\n\nexport type NumberStepperSize = \"md\" | \"lg\"\n\nexport interface NumberStepperProps {\n  /** The default uncontrolled value. */\n  defaultValue?: number\n  /** Helper text displayed below the component. Styled as error text when `invalid` is `true`. */\n  description?: string\n  /** Disables the input and stepper buttons. */\n  disabled?: boolean\n  /** If `true`, renders the label visually hidden. */\n  hideLabel?: boolean\n  /** If `true`, applies error styling to the field and description. */\n  invalid?: boolean\n  /** Accessible label for the field. */\n  label: string\n  /** Maximum allowed value. */\n  max?: number\n  /** Minimum allowed value. */\n  min?: number\n  /** Allows the value to be read but not changed. */\n  readOnly?: boolean\n  /** If `true`, appends an asterisk after the label text. */\n  required?: boolean\n  /** The size of the number stepper. */\n  size?: NumberStepperSize\n}\n\ntype AriaNumberFieldPropsToOmit =\n  | \"children\"\n  | \"render\"\n  | \"slot\"\n  | \"validate\"\n  | \"validationBehavior\"\n\ntype AriaNumberFieldPropsToInclude =\n  | \"formatOptions\"\n  | \"name\"\n  | \"onChange\"\n  | \"step\"\n  | \"value\"\n\nexport type NumberStepperElementProps = CombineAriaPropsWithCustomProps<\n  AriaNumberFieldProps,\n  NumberStepperProps,\n  AriaNumberFieldPropsToOmit,\n  AriaNumberFieldPropsToInclude\n>\n\nexport function NumberStepper({\n  className,\n  defaultValue,\n  description,\n  disabled,\n  hideLabel,\n  invalid,\n  label,\n  max,\n  min,\n  readOnly,\n  required,\n  size = \"md\",\n  ...restProps\n}: NumberStepperElementProps) {\n  const combinedClassName = classNames(\n    \"tds-number-stepper\",\n    { \"tds-number-stepper--lg\": size === \"lg\" },\n    className\n  )\n\n  return (\n    <AriaNumberField\n      {...restProps}\n      aria-label={hideLabel ? label : undefined}\n      className={combinedClassName}\n      defaultValue={defaultValue}\n      isDisabled={disabled}\n      isInvalid={invalid}\n      isReadOnly={readOnly}\n      isRequired={required}\n      maxValue={max}\n      minValue={min}\n    >\n      {!hideLabel && (\n        <Label className=\"tds-number-stepper-label\">{label}</Label>\n      )}\n      <Group className=\"tds-number-stepper-field\">\n        <Input className=\"tds-number-stepper-input\" />\n        <Button\n          className=\"tds-btn tds-btn--infield tds-number-stepper-button\"\n          slot=\"decrement\"\n        >\n          <Icon aria-hidden symbol=\"general#minus\" />\n        </Button>\n        <Button\n          className=\"tds-btn tds-btn--infield tds-number-stepper-button\"\n          slot=\"increment\"\n        >\n          <Icon aria-hidden symbol=\"general#plus\" />\n        </Button>\n      </Group>\n      {description && (\n        <Text className=\"tds-number-stepper-description\" slot=\"description\">\n          <Icon\n            aria-hidden\n            className=\"tds-number-stepper-description-invalid-icon\"\n            symbol=\"general#exclamation-triangle\"\n          />\n          {description}\n        </Text>\n      )}\n    </AriaNumberField>\n  )\n}\n"],"names":["React","AriaNumberField"],"mappings":";;;;;AAiEM,SAAU,aAAa,CAAC,EAC5B,SAAS,EACT,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,SAAS,EACT,OAAO,EACP,KAAK,EACL,GAAG,EACH,GAAG,EACH,QAAQ,EACR,QAAQ,EACR,IAAI,GAAG,IAAI,EACX,GAAG,SAAS,EACc,EAAA;AAC1B,IAAA,MAAM,iBAAiB,GAAG,UAAU,CAClC,oBAAoB,EACpB,EAAE,wBAAwB,EAAE,IAAI,KAAK,IAAI,EAAE,EAC3C,SAAS,CACV;IAED,QACEA,6BAACC,WAAe,EAAA,EAAA,GACV,SAAS,EAAA,YAAA,EACD,SAAS,GAAG,KAAK,GAAG,SAAS,EACzC,SAAS,EAAE,iBAAiB,EAC5B,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,QAAQ,EACpB,SAAS,EAAE,OAAO,EAClB,UAAU,EAAE,QAAQ,EACpB,UAAU,EAAE,QAAQ,EACpB,QAAQ,EAAE,GAAG,EACb,QAAQ,EAAE,GAAG,EAAA;AAEZ,QAAA,CAAC,SAAS,KACTD,cAAA,CAAA,aAAA,CAAC,KAAK,EAAA,EAAC,SAAS,EAAC,0BAA0B,EAAA,EAAE,KAAK,CAAS,CAC5D;AACD,QAAAA,cAAA,CAAA,aAAA,CAAC,KAAK,EAAA,EAAC,SAAS,EAAC,0BAA0B,EAAA;AACzC,YAAAA,cAAA,CAAA,aAAA,CAAC,KAAK,EAAA,EAAC,SAAS,EAAC,0BAA0B,EAAA,CAAG;YAC9CA,cAAA,CAAA,aAAA,CAAC,MAAM,IACL,SAAS,EAAC,oDAAoD,EAC9D,IAAI,EAAC,WAAW,EAAA;AAEhB,gBAAAA,cAAA,CAAA,aAAA,CAAC,IAAI,EAAA,EAAA,aAAA,EAAA,IAAA,EAAa,MAAM,EAAC,eAAe,GAAG,CACpC;YACTA,cAAA,CAAA,aAAA,CAAC,MAAM,IACL,SAAS,EAAC,oDAAoD,EAC9D,IAAI,EAAC,WAAW,EAAA;AAEhB,gBAAAA,cAAA,CAAA,aAAA,CAAC,IAAI,EAAA,EAAA,aAAA,EAAA,IAAA,EAAa,MAAM,EAAC,cAAc,EAAA,CAAG,CACnC,CACH;QACP,WAAW,KACVA,cAAA,CAAA,aAAA,CAAC,IAAI,EAAA,EAAC,SAAS,EAAC,gCAAgC,EAAC,IAAI,EAAC,aAAa,EAAA;YACjEA,cAAA,CAAA,aAAA,CAAC,IAAI,yBAEH,SAAS,EAAC,6CAA6C,EACvD,MAAM,EAAC,8BAA8B,EAAA,CACrC;AACD,YAAA,WAAW,CACP,CACR,CACe;AAEtB;;;;"}

package/dist/components/date-picker/DatePicker.d.ts

@@ -1,7 +1,9 @@
 import "../button/btn.css";
 import "./index.css";
 import { type DateValue } from "@internationalized/date";
-import React, { type AriaAttributes } from "react";
+import type { CombineAriaPropsWithCustomProps } from "../../utilities/reactAriaProps";
+import React from "react";
+import { type DatePickerProps as AriaDatePickerProps } from "react-aria-components";
 export type DatePickerSize = "md" | "lg";
 export type DatePickerDateValue = DateValue | string;
 export interface DatePickerProps {
@@ -34,12 +36,12 @@ export interface DatePickerProps {
     /** The controlled value. Accepts a DateValue or ISO date string. */
     value?: DatePickerDateValue | null;
 }
-export type DatePickerElementProps = DatePickerProps & Omit<AriaAttributes, keyof DatePickerProps> & {
-    className?: string;
-    id?: string;
-};
+type AriaDatePickerPropsToOmit = "children" | "defaultOpen" | "defaultValue" | "granularity" | "hideTimeZone" | "hourCycle" | "pageBehavior" | "placeholderValue" | "shouldCloseOnSelect" | "shouldForceLeadingZeros" | "slot";
+type AriaDatePickerPropsToInclude = "isOpen" | "name" | "onOpenChange";
+export type DatePickerElementProps = CombineAriaPropsWithCustomProps<AriaDatePickerProps<DateValue>, DatePickerProps, AriaDatePickerPropsToOmit, AriaDatePickerPropsToInclude>;
 export declare function DatePicker({ className, description, disabled, firstDayOfWeek, hideLabel, invalid, isDateUnavailable, label, max, min, onChange, readOnly, required, size, value, ...restProps }: DatePickerElementProps): React.JSX.Element;
 export declare namespace DatePicker {
     var displayName: string;
 }
+export {};
 //# sourceMappingURL=DatePicker.d.ts.map

package/dist/components/date-picker/DatePicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DatePicker.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/DatePicker.tsx"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,CAAA;AAC1B,OAAO,aAAa,CAAA;AAEpB,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,yBAAyB,CAAA;AAGnE,OAAO,KAAK,EAAE,EAAE,KAAK,cAAc,EAAE,MAAM,OAAO,CAAA;AAmBlD,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,CAAA;AAExC,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,MAAM,CAAA;AAepD,MAAM,WAAW,eAAe;IAC9B,gGAAgG;IAChG,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,4FAA4F;IAC5F,cAAc,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAA;IACtE,qGAAqG;IACrG,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,wFAAwF;IACxF,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAA;IAChD,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,uEAAuE;IACvE,GAAG,CAAC,EAAE,mBAAmB,CAAA;IACzB,uEAAuE;IACvE,GAAG,CAAC,EAAE,mBAAmB,CAAA;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,CAAA;IAC5C,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,mCAAmC;IACnC,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB,oEAAoE;IACpE,KAAK,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAA;CACnC;AAED,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAClD,IAAI,CAAC,cAAc,EAAE,MAAM,eAAe,CAAC,GAAG;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ,CAAA;AAEH,wBAAgB,UAAU,CAAC,EACzB,SAAS,EACT,WAAW,EACX,QAAQ,EACR,cAAc,EACd,SAAS,EACT,OAAO,EACP,iBAAiB,EACjB,KAAK,EACL,GAAG,EACH,GAAG,EACH,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,IAAW,EACX,KAAK,EACL,GAAG,SAAS,EACb,EAAE,sBAAsB,qBA6FxB;yBA9Ge,UAAU"}
+{"version":3,"file":"DatePicker.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/DatePicker.tsx"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,CAAA;AAC1B,OAAO,aAAa,CAAA;AAEpB,OAAO,EAEL,KAAK,SAAS,EAIf,MAAM,yBAAyB,CAAA;AAGhC,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAA;AAEhF,OAAO,KAON,MAAM,OAAO,CAAA;AACd,OAAO,EAUL,KAAK,eAAe,IAAI,mBAAmB,EAO5C,MAAM,uBAAuB,CAAA;AA4B9B,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,CAAA;AAExC,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,MAAM,CAAA;AAepD,MAAM,WAAW,eAAe;IAC9B,gGAAgG;IAChG,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,4FAA4F;IAC5F,cAAc,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAA;IACtE,qGAAqG;IACrG,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,wFAAwF;IACxF,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAA;IAChD,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,uEAAuE;IACvE,GAAG,CAAC,EAAE,mBAAmB,CAAA;IACzB,uEAAuE;IACvE,GAAG,CAAC,EAAE,mBAAmB,CAAA;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,CAAA;IAC5C,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,mCAAmC;IACnC,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB,oEAAoE;IACpE,KAAK,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAA;CACnC;AAED,KAAK,yBAAyB,GAC1B,UAAU,GACV,aAAa,GACb,cAAc,GACd,aAAa,GACb,cAAc,GACd,WAAW,GACX,cAAc,GACd,kBAAkB,GAClB,qBAAqB,GACrB,yBAAyB,GACzB,MAAM,CAAA;AAEV,KAAK,4BAA4B,GAAG,QAAQ,GAAG,MAAM,GAAG,cAAc,CAAA;AAEtE,MAAM,MAAM,sBAAsB,GAAG,+BAA+B,CAClE,mBAAmB,CAAC,SAAS,CAAC,EAC9B,eAAe,EACf,yBAAyB,EACzB,4BAA4B,CAC7B,CAAA;AA6DD,wBAAgB,UAAU,CAAC,EACzB,SAAS,EACT,WAAW,EACX,QAAQ,EACR,cAAc,EACd,SAAS,EACT,OAAO,EACP,iBAAiB,EACjB,KAAK,EACL,GAAG,EACH,GAAG,EACH,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,IAAW,EACX,KAAK,EACL,GAAG,SAAS,EACb,EAAE,sBAAsB,qBA0SxB;yBA3Te,UAAU"}

package/dist/components/date-picker/DatePicker.js

@@ -1,9 +1,36 @@
+import { CalendarDate as $35ea8db9cb2ccb90$export$99faa760c7908e4f } from './../../ext/@internationalized/date/dist/CalendarDate.js';
+import { today as $14e0f24ef4ac5c92$export$d0bdf45af03a6ea3, getLocalTimeZone as $14e0f24ef4ac5c92$export$aa8b41735afcabd2 } from './../../ext/@internationalized/date/dist/queries.js';
 import { parseDate as $fae977aafc393c5c$export$6b862160d295c8e } from './../../ext/@internationalized/date/dist/string.js';
+import { FocusScope as $9bf71ea28793e738$export$20e40289641fbbb6 } from './../../ext/@react-aria/focus/dist/FocusScope.js';
 import Icon from '../../utilities/Icon.js';
 import classNames from 'classnames';
-import React__default from 'react';
+import React__default, { useState, useRef, useEffect, useLayoutEffect } from 'react';
 import { DatePicker as DatePicker$1, Label, Group, DateInput, DateSegment, Button, Popover, Calendar, Heading, CalendarGrid, CalendarGridHeader, CalendarHeaderCell, CalendarGridBody, CalendarCell, Text } from 'react-aria-components';
 
+const _today = $14e0f24ef4ac5c92$export$d0bdf45af03a6ea3($14e0f24ef4ac5c92$export$aa8b41735afcabd2());
+const MONTHS = Array.from({ length: 12 }, (_, i) => i);
+const YEARS = Array.from({ length: 131 }, (_, i) => _today.year - 100 + i);
+const shortMonthFormatter = new Intl.DateTimeFormat(undefined, {
+    month: "short",
+});
+const longMonthFormatter = new Intl.DateTimeFormat(undefined, { month: "long" });
+function gridKeyDownHandler(cols, maxIndex, index, setIndex) {
+    return (e) => {
+        let next = index;
+        if (e.key === "ArrowLeft")
+            next = Math.max(0, index - 1);
+        else if (e.key === "ArrowRight")
+            next = Math.min(maxIndex, index + 1);
+        else if (e.key === "ArrowUp")
+            next = Math.max(0, index - cols);
+        else if (e.key === "ArrowDown")
+            next = Math.min(maxIndex, index + cols);
+        else
+            return;
+        e.preventDefault();
+        setIndex(next);
+    };
+}
 function toCalendarDate(input) {
     if (input === null)
         return null;
@@ -14,12 +41,78 @@ function toCalendarDate(input) {
     }
     return $fae977aafc393c5c$export$6b862160d295c8e(input);
 }
+const DATE_PICKER_OVERLAY_MAP = {
+    month: {
+        ariaLabel: "Months",
+        className: "tds-date-picker-overlay--month",
+    },
+    year: { ariaLabel: "Years", className: "tds-date-picker-overlay--year" },
+};
+function DatePickerOverlay({ children, gridRef, onClose, onKeyDown, title, variant, }) {
+    return (React__default.createElement($9bf71ea28793e738$export$20e40289641fbbb6, { contain: true, restoreFocus: true },
+        React__default.createElement("div", { "aria-label": `Select ${variant}`, "aria-modal": "true", className: classNames("tds-date-picker-overlay", DATE_PICKER_OVERLAY_MAP[variant].className), role: "dialog" },
+            React__default.createElement("div", { className: "tds-date-picker-overlay-header" },
+                React__default.createElement("span", { className: "tds-date-picker-calendar-title" }, title),
+                React__default.createElement(Button, { "aria-label": `Close ${variant} picker`, className: "tds-date-picker-overlay-close", onPress: onClose }, "\u00D7")),
+            React__default.createElement("div", { "aria-label": DATE_PICKER_OVERLAY_MAP[variant].ariaLabel, className: "tds-date-picker-overlay-grid", onKeyDown: onKeyDown, ref: gridRef, role: "listbox", tabIndex: -1 }, children))));
+}
 function DatePicker({ className, description, disabled, firstDayOfWeek, hideLabel, invalid, isDateUnavailable, label, max, min, onChange, readOnly, required, size = "md", value, ...restProps }) {
     const convertedValue = toCalendarDate(value);
     const convertedMin = toCalendarDate(min) ?? undefined;
     const convertedMax = toCalendarDate(max) ?? undefined;
     const combinedClassName = classNames("tds-date-picker", { "tds-date-picker--lg": size === "lg" }, className);
-    return (React__default.createElement(DatePicker$1, { ...restProps, "aria-label": hideLabel ? label : undefined, className: combinedClassName, isDateUnavailable: isDateUnavailable, isDisabled: disabled, isInvalid: invalid, isReadOnly: readOnly, isRequired: required, maxValue: convertedMax, minValue: convertedMin, onChange: onChange ?? undefined, value: convertedValue },
+    const [focusedDate, setFocusedDate] = useState(() => {
+        return (toCalendarDate(value) ??
+            $14e0f24ef4ac5c92$export$d0bdf45af03a6ea3($14e0f24ef4ac5c92$export$aa8b41735afcabd2()));
+    });
+    const [activeOverlay, setActiveOverlay] = useState(null);
+    const overlayTitle = `${longMonthFormatter.format(new Date(2000, focusedDate.month - 1, 1))} ${focusedDate.year}`;
+    const [focusedMonthIndex, setFocusedMonthIndex] = useState(() => focusedDate.month - 1);
+    const [focusedYearIndex, setFocusedYearIndex] = useState(() => Math.max(0, YEARS.indexOf(focusedDate.year)));
+    const calendarRef = useRef(null);
+    const monthGridRef = useRef(null);
+    const yearGridRef = useRef(null);
+    // Close on Escape. FocusScope handles trapping and focus restoration.
+    useEffect(() => {
+        if (!activeOverlay)
+            return;
+        function handleKeyDown(e) {
+            if (e.key === "Escape")
+                setActiveOverlay(null);
+        }
+        document.addEventListener("keydown", handleKeyDown);
+        return () => document.removeEventListener("keydown", handleKeyDown);
+    }, [activeOverlay]);
+    function handleMonthSelect(monthIndex) {
+        setFocusedDate(new $35ea8db9cb2ccb90$export$99faa760c7908e4f(focusedDate.year, monthIndex + 1, 1));
+        setActiveOverlay(null);
+    }
+    useLayoutEffect(() => {
+        if (activeOverlay !== "month")
+            return;
+        const buttons = monthGridRef.current?.querySelectorAll("button");
+        buttons?.[focusedMonthIndex]?.focus();
+    }, [focusedMonthIndex, activeOverlay]);
+    function handleYearSelect(year) {
+        setFocusedDate(new $35ea8db9cb2ccb90$export$99faa760c7908e4f(year, focusedDate.month, 1));
+        setActiveOverlay(null);
+    }
+    useLayoutEffect(() => {
+        if (activeOverlay !== "year")
+            return;
+        const cell = yearGridRef.current?.querySelectorAll("button")[focusedYearIndex];
+        cell?.scrollIntoView({ block: "nearest" });
+        cell?.focus();
+    }, [focusedYearIndex, activeOverlay]);
+    const handleMonthKeyDown = gridKeyDownHandler(3, 11, focusedMonthIndex, setFocusedMonthIndex);
+    const handleYearKeyDown = gridKeyDownHandler(4, YEARS.length - 1, focusedYearIndex, setFocusedYearIndex);
+    return (React__default.createElement(DatePicker$1, { ...restProps, "aria-label": hideLabel ? label : undefined, className: combinedClassName, isDateUnavailable: isDateUnavailable, isDisabled: disabled, isInvalid: invalid, isReadOnly: readOnly, isRequired: required, maxValue: convertedMax, minValue: convertedMin, onChange: onChange ?? undefined, onOpenChange: (isOpen) => {
+            if (!isOpen) {
+                setActiveOverlay(null);
+                setFocusedDate(toCalendarDate(value) ??
+                    $14e0f24ef4ac5c92$export$d0bdf45af03a6ea3($14e0f24ef4ac5c92$export$aa8b41735afcabd2()));
+            }
+        }, value: convertedValue },
         !hideLabel && React__default.createElement(Label, { className: "tds-date-picker-label" }, label),
         React__default.createElement(Group, { className: "tds-date-picker-field" },
             React__default.createElement(DateInput, { className: "tds-date-picker-input" }, (segment) => (React__default.createElement(DateSegment, { className: segment.type === "literal"
@@ -28,12 +121,43 @@ function DatePicker({ className, description, disabled, firstDayOfWeek, hideLabe
             React__default.createElement(Button, { className: "tds-btn tds-btn--infield tds-date-picker-button" },
                 React__default.createElement(Icon, { "aria-hidden": true, symbol: "general#calendar" }))),
         React__default.createElement(Popover, { className: "tds-date-picker-popover" },
-            React__default.createElement(Calendar, { className: "tds-date-picker-calendar", firstDayOfWeek: firstDayOfWeek },
+            activeOverlay === "month" && (React__default.createElement(DatePickerOverlay, { gridRef: monthGridRef, onClose: () => setActiveOverlay(null), onKeyDown: handleMonthKeyDown, title: overlayTitle, variant: "month" }, MONTHS.map((i) => {
+                const monthLabel = shortMonthFormatter.format(new Date(2000, i, 1));
+                return (React__default.createElement("button", { "aria-selected": focusedDate.month === i + 1, className: "tds-date-picker-overlay-cell", key: monthLabel, onClick: () => handleMonthSelect(i), role: "option", tabIndex: focusedMonthIndex === i ? 0 : -1, type: "button" }, monthLabel));
+            }))),
+            activeOverlay === "year" && (React__default.createElement(DatePickerOverlay, { gridRef: yearGridRef, onClose: () => setActiveOverlay(null), onKeyDown: handleYearKeyDown, title: overlayTitle, variant: "year" }, YEARS.map((year, i) => (React__default.createElement("button", { "aria-selected": focusedDate.year === year, className: "tds-date-picker-overlay-cell", key: year, onClick: () => handleYearSelect(year), role: "option", tabIndex: focusedYearIndex === i ? 0 : -1, type: "button" }, year))))),
+            React__default.createElement(Calendar, { className: "tds-date-picker-calendar", firstDayOfWeek: firstDayOfWeek, focusedValue: focusedDate, onFocusChange: (date) => setFocusedDate(date), ref: calendarRef },
                 React__default.createElement("header", { className: "tds-date-picker-calendar-header" },
-                    React__default.createElement(Button, { className: "tds-date-picker-calendar-nav", slot: "previous" },
+                    React__default.createElement(Heading, { className: "tds-date-picker-calendar-title tds-date-picker-calendar-title--visually-hidden" }),
+                    React__default.createElement("div", { className: "tds-date-picker-calendar-heading" },
+                        React__default.createElement(Button, { "aria-expanded": activeOverlay === "month", "aria-haspopup": "dialog", className: "tds-date-picker-calendar-overlay-trigger", onPress: () => {
+                                setFocusedMonthIndex(focusedDate.month - 1);
+                                setActiveOverlay("month");
+                            }, slot: null }, longMonthFormatter.format(new Date(2000, focusedDate.month - 1, 1))),
+                        React__default.createElement(Button, { "aria-expanded": activeOverlay === "year", "aria-haspopup": "dialog", className: "tds-date-picker-calendar-overlay-trigger", onPress: () => {
+                                setFocusedYearIndex(Math.max(0, YEARS.indexOf(focusedDate.year)));
+                                setActiveOverlay("year");
+                            }, slot: null }, focusedDate.year)),
+                    React__default.createElement(Button, { "aria-label": "Go to today", className: "tds-date-picker-calendar-nav", style: {
+                            visibility: focusedDate.month === _today.month &&
+                                focusedDate.year === _today.year
+                                ? "hidden"
+                                : undefined,
+                        }, onPress: () => {
+                            const today = $14e0f24ef4ac5c92$export$d0bdf45af03a6ea3($14e0f24ef4ac5c92$export$aa8b41735afcabd2());
+                            setFocusedDate(today);
+                            requestAnimationFrame(() => {
+                                calendarRef.current
+                                    ?.querySelector("[data-today]")
+                                    ?.focus();
+                            });
+                        }, slot: null },
+                        React__default.createElement("svg", { "aria-hidden": true, fill: "currentColor", viewBox: "0 0 16 16", height: "14", width: "16", xmlns: "http://www.w3.org/2000/svg" },
+                            React__default.createElement("path", { d: "M13.444 14.222H2.556V5.667H13.444V14.222ZM13.444 1.778H12.667V0.222H11.111V1.778H4.889V0.222H3.333V1.778H2.556C2.35212 1.778 2.15025 1.81827 1.96199 1.8965C1.77372 1.97473 1.60275 2.08938 1.45892 2.23387C1.31508 2.37836 1.2012 2.54984 1.12382 2.73846C1.04644 2.92708 1.00708 3.12913 1.008 3.333L1 14.222C0.999869 14.4264 1.04003 14.6288 1.11818 14.8176C1.19633 15.0065 1.31093 15.178 1.45545 15.3226C1.59996 15.4671 1.77155 15.5817 1.96039 15.6598C2.14923 15.738 2.35163 15.7781 2.556 15.778H13.444C13.8564 15.7769 14.2515 15.6127 14.5431 15.3211C14.8347 15.0295 14.9989 14.6344 15 14.222V3.333C14.9987 2.92082 14.8343 2.52592 14.5427 2.23455C14.2512 1.94319 13.8562 1.77905 13.444 1.778Z" }),
+                            React__default.createElement("circle", { cx: "8", cy: "9.75", r: "2.25" }))),
+                    React__default.createElement(Button, { "aria-label": "Previous month", className: "tds-date-picker-calendar-nav", slot: "previous" },
                         React__default.createElement(Icon, { "aria-hidden": true, symbol: "general#left-chevron" })),
-                    React__default.createElement(Heading, { className: "tds-date-picker-calendar-title" }),
-                    React__default.createElement(Button, { className: "tds-date-picker-calendar-nav", slot: "next" },
+                    React__default.createElement(Button, { "aria-label": "Next month", className: "tds-date-picker-calendar-nav", slot: "next" },
                         React__default.createElement(Icon, { "aria-hidden": true, symbol: "general#right-chevron" }))),
                 React__default.createElement(CalendarGrid, { className: "tds-date-picker-calendar-grid" },
                     React__default.createElement(CalendarGridHeader, { className: "tds-date-picker-calendar-grid-header" }, (day) => (React__default.createElement(CalendarHeaderCell, { className: "tds-date-picker-calendar-header-cell" }, day))),

package/dist/components/date-picker/DatePicker.js.map

@@ -1 +1 @@
-{"version":3,"file":"DatePicker.js","sources":["../../../src/components/date-picker/DatePicker.tsx"],"sourcesContent":["import \"../button/btn.css\"\nimport \"./index.css\"\n\nimport { type DateValue, parseDate } from \"@internationalized/date\"\nimport Icon from \"@utilities/Icon\"\nimport classNames from \"classnames\"\nimport React, { type AriaAttributes } from \"react\"\nimport {\n  Button,\n  Calendar,\n  CalendarCell,\n  CalendarGrid,\n  CalendarGridBody,\n  CalendarGridHeader,\n  CalendarHeaderCell,\n  DateInput,\n  DatePicker as AriaDatePicker,\n  DateSegment,\n  Group,\n  Heading,\n  Label,\n  Popover,\n  Text,\n} from \"react-aria-components\"\n\nexport type DatePickerSize = \"md\" | \"lg\"\n\nexport type DatePickerDateValue = DateValue | string\n\nfunction toCalendarDate(\n  input: DatePickerDateValue | null | undefined\n): DateValue | null | undefined {\n  if (input === null) return null\n  if (input === undefined) return undefined\n\n  if (typeof input === \"object\" && \"calendar\" in input) {\n    return input\n  }\n\n  return parseDate(input)\n}\n\nexport interface DatePickerProps {\n  /** Helper text displayed below the component. Styled as error text when `invalid` is `true`. */\n  description?: string\n  /** Disables the input and calendar button. */\n  disabled?: boolean\n  /** Sets the first day of the week in the calendar. Defaults to locale-appropriate value. */\n  firstDayOfWeek?: \"fri\" | \"mon\" | \"sat\" | \"sun\" | \"thu\" | \"tue\" | \"wed\"\n  /** If `true`, the `label` text is rendered as an `aria-label` instead of a visible label element. */\n  hideLabel?: boolean\n  /** Whether the input is in an invalid state. */\n  invalid?: boolean\n  /** Callback that returns `true` for dates that should be visible but not selectable. */\n  isDateUnavailable?: (date: DateValue) => boolean\n  /** Accessible label for the field. */\n  label: string\n  /** Maximum selectable date. Accepts a DateValue or ISO date string. */\n  max?: DatePickerDateValue\n  /** Minimum selectable date. Accepts a DateValue or ISO date string. */\n  min?: DatePickerDateValue\n  /** Called when the selected date changes. */\n  onChange?: (value: DateValue | null) => void\n  /** If `true`, allows the value to be read but not changed. */\n  readOnly?: boolean\n  /** If `true`, appends an asterisk at the end of the label text. */\n  required?: boolean\n  /** The size of the date picker. */\n  size?: DatePickerSize\n  /** The controlled value. Accepts a DateValue or ISO date string. */\n  value?: DatePickerDateValue | null\n}\n\nexport type DatePickerElementProps = DatePickerProps &\n  Omit<AriaAttributes, keyof DatePickerProps> & {\n    className?: string\n    id?: string\n  }\n\nexport function DatePicker({\n  className,\n  description,\n  disabled,\n  firstDayOfWeek,\n  hideLabel,\n  invalid,\n  isDateUnavailable,\n  label,\n  max,\n  min,\n  onChange,\n  readOnly,\n  required,\n  size = \"md\",\n  value,\n  ...restProps\n}: DatePickerElementProps) {\n  const convertedValue = toCalendarDate(value)\n  const convertedMin = toCalendarDate(min) ?? undefined\n  const convertedMax = toCalendarDate(max) ?? undefined\n\n  const combinedClassName = classNames(\n    \"tds-date-picker\",\n    { \"tds-date-picker--lg\": size === \"lg\" },\n    className\n  )\n\n  return (\n    <AriaDatePicker\n      {...restProps}\n      aria-label={hideLabel ? label : undefined}\n      className={combinedClassName}\n      isDateUnavailable={isDateUnavailable}\n      isDisabled={disabled}\n      isInvalid={invalid}\n      isReadOnly={readOnly}\n      isRequired={required}\n      maxValue={convertedMax}\n      minValue={convertedMin}\n      onChange={onChange ?? undefined}\n      value={convertedValue}\n    >\n      {!hideLabel && <Label className=\"tds-date-picker-label\">{label}</Label>}\n      <Group className=\"tds-date-picker-field\">\n        <DateInput className=\"tds-date-picker-input\">\n          {(segment) => (\n            <DateSegment\n              className={\n                segment.type === \"literal\"\n                  ? \"tds-date-picker-segment-separator\"\n                  : \"tds-date-picker-segment\"\n              }\n              segment={segment}\n            />\n          )}\n        </DateInput>\n        <Button className=\"tds-btn tds-btn--infield tds-date-picker-button\">\n          <Icon aria-hidden symbol=\"general#calendar\" />\n        </Button>\n      </Group>\n      <Popover className=\"tds-date-picker-popover\">\n        <Calendar\n          className=\"tds-date-picker-calendar\"\n          firstDayOfWeek={firstDayOfWeek}\n        >\n          <header className=\"tds-date-picker-calendar-header\">\n            <Button className=\"tds-date-picker-calendar-nav\" slot=\"previous\">\n              <Icon aria-hidden symbol=\"general#left-chevron\" />\n            </Button>\n            <Heading className=\"tds-date-picker-calendar-title\" />\n            <Button className=\"tds-date-picker-calendar-nav\" slot=\"next\">\n              <Icon aria-hidden symbol=\"general#right-chevron\" />\n            </Button>\n          </header>\n          <CalendarGrid className=\"tds-date-picker-calendar-grid\">\n            <CalendarGridHeader className=\"tds-date-picker-calendar-grid-header\">\n              {(day) => (\n                <CalendarHeaderCell className=\"tds-date-picker-calendar-header-cell\">\n                  {day}\n                </CalendarHeaderCell>\n              )}\n            </CalendarGridHeader>\n            <CalendarGridBody className=\"tds-date-picker-calendar-grid-body\">\n              {(date) => (\n                <CalendarCell\n                  className=\"tds-date-picker-calendar-cell\"\n                  date={date}\n                />\n              )}\n            </CalendarGridBody>\n          </CalendarGrid>\n        </Calendar>\n      </Popover>\n      {description && (\n        <Text\n          elementType=\"p\"\n          className=\"tds-date-picker-description\"\n          slot=\"description\"\n        >\n          <Icon\n            aria-hidden\n            className=\"tds-date-picker-description-invalid-icon\"\n            symbol=\"general#exclamation-triangle\"\n          />\n          {description}\n        </Text>\n      )}\n    </AriaDatePicker>\n  )\n}\n\nDatePicker.displayName = \"DatePicker\"\n"],"names":["parseDate","React","AriaDatePicker"],"mappings":"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"}
+{"version":3,"file":"DatePicker.js","sources":["../../../src/components/date-picker/DatePicker.tsx"],"sourcesContent":["import \"../button/btn.css\"\nimport \"./index.css\"\n\nimport {\n  CalendarDate,\n  type DateValue,\n  getLocalTimeZone,\n  parseDate,\n  today as todayCalendar,\n} from \"@internationalized/date\"\nimport { FocusScope } from \"@react-aria/focus\"\nimport Icon from \"@utilities/Icon\"\nimport type { CombineAriaPropsWithCustomProps } from \"@utilities/reactAriaProps\"\nimport classNames from \"classnames\"\nimport React, {\n  type ReactNode,\n  type RefObject,\n  useEffect,\n  useLayoutEffect,\n  useRef,\n  useState,\n} from \"react\"\nimport {\n  Button,\n  Calendar,\n  CalendarCell,\n  CalendarGrid,\n  CalendarGridBody,\n  CalendarGridHeader,\n  CalendarHeaderCell,\n  DateInput,\n  DatePicker as AriaDatePicker,\n  type DatePickerProps as AriaDatePickerProps,\n  DateSegment,\n  Group,\n  Heading,\n  Label,\n  Popover,\n  Text,\n} from \"react-aria-components\"\n\nconst _today = todayCalendar(getLocalTimeZone())\nconst MONTHS = Array.from({ length: 12 }, (_, i) => i)\nconst YEARS = Array.from({ length: 131 }, (_, i) => _today.year - 100 + i)\nconst shortMonthFormatter = new Intl.DateTimeFormat(undefined, {\n  month: \"short\",\n})\nconst longMonthFormatter = new Intl.DateTimeFormat(undefined, { month: \"long\" })\n\nfunction gridKeyDownHandler(\n  cols: number,\n  maxIndex: number,\n  index: number,\n  setIndex: (n: number) => void\n) {\n  return (e: React.KeyboardEvent) => {\n    let next = index\n    if (e.key === \"ArrowLeft\") next = Math.max(0, index - 1)\n    else if (e.key === \"ArrowRight\") next = Math.min(maxIndex, index + 1)\n    else if (e.key === \"ArrowUp\") next = Math.max(0, index - cols)\n    else if (e.key === \"ArrowDown\") next = Math.min(maxIndex, index + cols)\n    else return\n    e.preventDefault()\n    setIndex(next)\n  }\n}\n\nexport type DatePickerSize = \"md\" | \"lg\"\n\nexport type DatePickerDateValue = DateValue | string\n\nfunction toCalendarDate(\n  input: DatePickerDateValue | null | undefined\n): DateValue | null | undefined {\n  if (input === null) return null\n  if (input === undefined) return undefined\n\n  if (typeof input === \"object\" && \"calendar\" in input) {\n    return input\n  }\n\n  return parseDate(input)\n}\n\nexport interface DatePickerProps {\n  /** Helper text displayed below the component. Styled as error text when `invalid` is `true`. */\n  description?: string\n  /** Disables the input and calendar button. */\n  disabled?: boolean\n  /** Sets the first day of the week in the calendar. Defaults to locale-appropriate value. */\n  firstDayOfWeek?: \"fri\" | \"mon\" | \"sat\" | \"sun\" | \"thu\" | \"tue\" | \"wed\"\n  /** If `true`, the `label` text is rendered as an `aria-label` instead of a visible label element. */\n  hideLabel?: boolean\n  /** Whether the input is in an invalid state. */\n  invalid?: boolean\n  /** Callback that returns `true` for dates that should be visible but not selectable. */\n  isDateUnavailable?: (date: DateValue) => boolean\n  /** Accessible label for the field. */\n  label: string\n  /** Maximum selectable date. Accepts a DateValue or ISO date string. */\n  max?: DatePickerDateValue\n  /** Minimum selectable date. Accepts a DateValue or ISO date string. */\n  min?: DatePickerDateValue\n  /** Called when the selected date changes. */\n  onChange?: (value: DateValue | null) => void\n  /** If `true`, allows the value to be read but not changed. */\n  readOnly?: boolean\n  /** If `true`, appends an asterisk at the end of the label text. */\n  required?: boolean\n  /** The size of the date picker. */\n  size?: DatePickerSize\n  /** The controlled value. Accepts a DateValue or ISO date string. */\n  value?: DatePickerDateValue | null\n}\n\ntype AriaDatePickerPropsToOmit =\n  | \"children\"\n  | \"defaultOpen\"\n  | \"defaultValue\"\n  | \"granularity\"\n  | \"hideTimeZone\"\n  | \"hourCycle\"\n  | \"pageBehavior\"\n  | \"placeholderValue\"\n  | \"shouldCloseOnSelect\"\n  | \"shouldForceLeadingZeros\"\n  | \"slot\"\n\ntype AriaDatePickerPropsToInclude = \"isOpen\" | \"name\" | \"onOpenChange\"\n\nexport type DatePickerElementProps = CombineAriaPropsWithCustomProps<\n  AriaDatePickerProps<DateValue>,\n  DatePickerProps,\n  AriaDatePickerPropsToOmit,\n  AriaDatePickerPropsToInclude\n>\n\nconst DATE_PICKER_OVERLAY_MAP = {\n  month: {\n    ariaLabel: \"Months\",\n    className: \"tds-date-picker-overlay--month\",\n  },\n  year: { ariaLabel: \"Years\", className: \"tds-date-picker-overlay--year\" },\n}\n\nfunction DatePickerOverlay({\n  children,\n  gridRef,\n  onClose,\n  onKeyDown,\n  title,\n  variant,\n}: {\n  children: ReactNode\n  gridRef?: RefObject<HTMLDivElement>\n  onClose: () => void\n  onKeyDown: React.KeyboardEventHandler\n  title: string\n  variant: \"month\" | \"year\"\n}) {\n  return (\n    <FocusScope contain restoreFocus>\n      <div\n        aria-label={`Select ${variant}`}\n        aria-modal=\"true\"\n        className={classNames(\n          \"tds-date-picker-overlay\",\n          DATE_PICKER_OVERLAY_MAP[variant].className\n        )}\n        role=\"dialog\"\n      >\n        <div className=\"tds-date-picker-overlay-header\">\n          <span className=\"tds-date-picker-calendar-title\">{title}</span>\n          <Button\n            aria-label={`Close ${variant} picker`}\n            className=\"tds-date-picker-overlay-close\"\n            onPress={onClose}\n          >\n            ×\n          </Button>\n        </div>\n        <div\n          aria-label={DATE_PICKER_OVERLAY_MAP[variant].ariaLabel}\n          className=\"tds-date-picker-overlay-grid\"\n          onKeyDown={onKeyDown}\n          ref={gridRef}\n          role=\"listbox\"\n          tabIndex={-1}\n        >\n          {children}\n        </div>\n      </div>\n    </FocusScope>\n  )\n}\n\nexport function DatePicker({\n  className,\n  description,\n  disabled,\n  firstDayOfWeek,\n  hideLabel,\n  invalid,\n  isDateUnavailable,\n  label,\n  max,\n  min,\n  onChange,\n  readOnly,\n  required,\n  size = \"md\",\n  value,\n  ...restProps\n}: DatePickerElementProps) {\n  const convertedValue = toCalendarDate(value)\n  const convertedMin = toCalendarDate(min) ?? undefined\n  const convertedMax = toCalendarDate(max) ?? undefined\n\n  const combinedClassName = classNames(\n    \"tds-date-picker\",\n    { \"tds-date-picker--lg\": size === \"lg\" },\n    className\n  )\n\n  const [focusedDate, setFocusedDate] = useState<CalendarDate>(() => {\n    return (\n      (toCalendarDate(value) as CalendarDate) ??\n      todayCalendar(getLocalTimeZone())\n    )\n  })\n  const [activeOverlay, setActiveOverlay] = useState<\"month\" | \"year\" | null>(\n    null\n  )\n  const overlayTitle = `${longMonthFormatter.format(new Date(2000, focusedDate.month - 1, 1))} ${focusedDate.year}`\n  const [focusedMonthIndex, setFocusedMonthIndex] = useState(\n    () => focusedDate.month - 1\n  )\n  const [focusedYearIndex, setFocusedYearIndex] = useState(() =>\n    Math.max(0, YEARS.indexOf(focusedDate.year))\n  )\n  const calendarRef = useRef<HTMLDivElement>(null)\n  const monthGridRef = useRef<HTMLDivElement>(null)\n  const yearGridRef = useRef<HTMLDivElement>(null)\n\n  // Close on Escape. FocusScope handles trapping and focus restoration.\n  useEffect(() => {\n    if (!activeOverlay) return\n    function handleKeyDown(e: KeyboardEvent) {\n      if (e.key === \"Escape\") setActiveOverlay(null)\n    }\n    document.addEventListener(\"keydown\", handleKeyDown)\n    return () => document.removeEventListener(\"keydown\", handleKeyDown)\n  }, [activeOverlay])\n\n  function handleMonthSelect(monthIndex: number) {\n    setFocusedDate(new CalendarDate(focusedDate.year, monthIndex + 1, 1))\n    setActiveOverlay(null)\n  }\n\n  useLayoutEffect(() => {\n    if (activeOverlay !== \"month\") return\n    const buttons =\n      monthGridRef.current?.querySelectorAll<HTMLElement>(\"button\")\n    buttons?.[focusedMonthIndex]?.focus()\n  }, [focusedMonthIndex, activeOverlay])\n\n  function handleYearSelect(year: number) {\n    setFocusedDate(new CalendarDate(year, focusedDate.month, 1))\n    setActiveOverlay(null)\n  }\n\n  useLayoutEffect(() => {\n    if (activeOverlay !== \"year\") return\n    const cell =\n      yearGridRef.current?.querySelectorAll<HTMLElement>(\"button\")[\n        focusedYearIndex\n      ]\n    cell?.scrollIntoView({ block: \"nearest\" })\n    cell?.focus()\n  }, [focusedYearIndex, activeOverlay])\n\n  const handleMonthKeyDown = gridKeyDownHandler(\n    3,\n    11,\n    focusedMonthIndex,\n    setFocusedMonthIndex\n  )\n  const handleYearKeyDown = gridKeyDownHandler(\n    4,\n    YEARS.length - 1,\n    focusedYearIndex,\n    setFocusedYearIndex\n  )\n\n  return (\n    <AriaDatePicker\n      {...restProps}\n      aria-label={hideLabel ? label : undefined}\n      className={combinedClassName}\n      isDateUnavailable={isDateUnavailable}\n      isDisabled={disabled}\n      isInvalid={invalid}\n      isReadOnly={readOnly}\n      isRequired={required}\n      maxValue={convertedMax}\n      minValue={convertedMin}\n      onChange={onChange ?? undefined}\n      onOpenChange={(isOpen) => {\n        if (!isOpen) {\n          setActiveOverlay(null)\n          setFocusedDate(\n            (toCalendarDate(value) as CalendarDate) ??\n              todayCalendar(getLocalTimeZone())\n          )\n        }\n      }}\n      value={convertedValue}\n    >\n      {!hideLabel && <Label className=\"tds-date-picker-label\">{label}</Label>}\n      <Group className=\"tds-date-picker-field\">\n        <DateInput className=\"tds-date-picker-input\">\n          {(segment) => (\n            <DateSegment\n              className={\n                segment.type === \"literal\"\n                  ? \"tds-date-picker-segment-separator\"\n                  : \"tds-date-picker-segment\"\n              }\n              segment={segment}\n            />\n          )}\n        </DateInput>\n        <Button className=\"tds-btn tds-btn--infield tds-date-picker-button\">\n          <Icon aria-hidden symbol=\"general#calendar\" />\n        </Button>\n      </Group>\n      <Popover className=\"tds-date-picker-popover\">\n        {activeOverlay === \"month\" && (\n          <DatePickerOverlay\n            gridRef={monthGridRef}\n            onClose={() => setActiveOverlay(null)}\n            onKeyDown={handleMonthKeyDown}\n            title={overlayTitle}\n            variant=\"month\"\n          >\n            {MONTHS.map((i) => {\n              const monthLabel = shortMonthFormatter.format(\n                new Date(2000, i, 1)\n              )\n              return (\n                <button\n                  aria-selected={focusedDate.month === i + 1}\n                  className=\"tds-date-picker-overlay-cell\"\n                  key={monthLabel}\n                  onClick={() => handleMonthSelect(i)}\n                  role=\"option\"\n                  tabIndex={focusedMonthIndex === i ? 0 : -1}\n                  type=\"button\"\n                >\n                  {monthLabel}\n                </button>\n              )\n            })}\n          </DatePickerOverlay>\n        )}\n        {activeOverlay === \"year\" && (\n          <DatePickerOverlay\n            gridRef={yearGridRef}\n            onClose={() => setActiveOverlay(null)}\n            onKeyDown={handleYearKeyDown}\n            title={overlayTitle}\n            variant=\"year\"\n          >\n            {YEARS.map((year, i) => (\n              <button\n                aria-selected={focusedDate.year === year}\n                className=\"tds-date-picker-overlay-cell\"\n                key={year}\n                onClick={() => handleYearSelect(year)}\n                role=\"option\"\n                tabIndex={focusedYearIndex === i ? 0 : -1}\n                type=\"button\"\n              >\n                {year}\n              </button>\n            ))}\n          </DatePickerOverlay>\n        )}\n        <Calendar\n          className=\"tds-date-picker-calendar\"\n          firstDayOfWeek={firstDayOfWeek}\n          focusedValue={focusedDate}\n          onFocusChange={(date) => setFocusedDate(date)}\n          ref={calendarRef}\n        >\n          <header className=\"tds-date-picker-calendar-header\">\n            <Heading className=\"tds-date-picker-calendar-title tds-date-picker-calendar-title--visually-hidden\" />\n            <div className=\"tds-date-picker-calendar-heading\">\n              <Button\n                aria-expanded={activeOverlay === \"month\"}\n                aria-haspopup=\"dialog\"\n                className=\"tds-date-picker-calendar-overlay-trigger\"\n                onPress={() => {\n                  setFocusedMonthIndex(focusedDate.month - 1)\n                  setActiveOverlay(\"month\")\n                }}\n                slot={null}\n              >\n                {longMonthFormatter.format(\n                  new Date(2000, focusedDate.month - 1, 1)\n                )}\n              </Button>\n              <Button\n                aria-expanded={activeOverlay === \"year\"}\n                aria-haspopup=\"dialog\"\n                className=\"tds-date-picker-calendar-overlay-trigger\"\n                onPress={() => {\n                  setFocusedYearIndex(\n                    Math.max(0, YEARS.indexOf(focusedDate.year))\n                  )\n                  setActiveOverlay(\"year\")\n                }}\n                slot={null}\n              >\n                {focusedDate.year}\n              </Button>\n            </div>\n            <Button\n              aria-label=\"Go to today\"\n              className=\"tds-date-picker-calendar-nav\"\n              style={{\n                visibility:\n                  focusedDate.month === _today.month &&\n                  focusedDate.year === _today.year\n                    ? \"hidden\"\n                    : undefined,\n              }}\n              onPress={() => {\n                const today = todayCalendar(getLocalTimeZone())\n                setFocusedDate(today)\n                requestAnimationFrame(() => {\n                  calendarRef.current\n                    ?.querySelector<HTMLElement>(\"[data-today]\")\n                    ?.focus()\n                })\n              }}\n              slot={null}\n            >\n              {/* TODO: Add to icon library and use Icon once icon is decided on */}\n              <svg\n                aria-hidden\n                fill=\"currentColor\"\n                viewBox=\"0 0 16 16\"\n                height=\"14\"\n                width=\"16\"\n                xmlns=\"http://www.w3.org/2000/svg\"\n              >\n                <path d=\"M13.444 14.222H2.556V5.667H13.444V14.222ZM13.444 1.778H12.667V0.222H11.111V1.778H4.889V0.222H3.333V1.778H2.556C2.35212 1.778 2.15025 1.81827 1.96199 1.8965C1.77372 1.97473 1.60275 2.08938 1.45892 2.23387C1.31508 2.37836 1.2012 2.54984 1.12382 2.73846C1.04644 2.92708 1.00708 3.12913 1.008 3.333L1 14.222C0.999869 14.4264 1.04003 14.6288 1.11818 14.8176C1.19633 15.0065 1.31093 15.178 1.45545 15.3226C1.59996 15.4671 1.77155 15.5817 1.96039 15.6598C2.14923 15.738 2.35163 15.7781 2.556 15.778H13.444C13.8564 15.7769 14.2515 15.6127 14.5431 15.3211C14.8347 15.0295 14.9989 14.6344 15 14.222V3.333C14.9987 2.92082 14.8343 2.52592 14.5427 2.23455C14.2512 1.94319 13.8562 1.77905 13.444 1.778Z\" />\n                <circle cx=\"8\" cy=\"9.75\" r=\"2.25\" />\n              </svg>\n            </Button>\n            <Button\n              aria-label=\"Previous month\"\n              className=\"tds-date-picker-calendar-nav\"\n              slot=\"previous\"\n            >\n              <Icon aria-hidden symbol=\"general#left-chevron\" />\n            </Button>\n            <Button\n              aria-label=\"Next month\"\n              className=\"tds-date-picker-calendar-nav\"\n              slot=\"next\"\n            >\n              <Icon aria-hidden symbol=\"general#right-chevron\" />\n            </Button>\n          </header>\n          <CalendarGrid className=\"tds-date-picker-calendar-grid\">\n            <CalendarGridHeader className=\"tds-date-picker-calendar-grid-header\">\n              {(day) => (\n                <CalendarHeaderCell className=\"tds-date-picker-calendar-header-cell\">\n                  {day}\n                </CalendarHeaderCell>\n              )}\n            </CalendarGridHeader>\n            <CalendarGridBody className=\"tds-date-picker-calendar-grid-body\">\n              {(date) => (\n                <CalendarCell\n                  className=\"tds-date-picker-calendar-cell\"\n                  date={date}\n                />\n              )}\n            </CalendarGridBody>\n          </CalendarGrid>\n        </Calendar>\n      </Popover>\n      {description && (\n        <Text\n          elementType=\"p\"\n          className=\"tds-date-picker-description\"\n          slot=\"description\"\n        >\n          <Icon\n            aria-hidden\n            className=\"tds-date-picker-description-invalid-icon\"\n            symbol=\"general#exclamation-triangle\"\n          />\n          {description}\n        </Text>\n      )}\n    </AriaDatePicker>\n  )\n}\n\nDatePicker.displayName = \"DatePicker\"\n"],"names":["todayCalendar","getLocalTimeZone","parseDate","React","FocusScope","CalendarDate","AriaDatePicker"],"mappings":"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"}

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

@@ -49,8 +49,8 @@ interface SelectBaseProps {
     invalid?: boolean;
     /** A flat or mixed array of options and option groups. */
     options: SelectItem[];
-    /** Placeholder text shown when no option is selected. */
-    placeholder: string;
+    /** Placeholder text shown when no option is selected. Defaults to `"Select an option"`. */
+    placeholder?: string;
     /** The size of the select. */
     size?: SelectSize;
 }

package/dist/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,aAAa,CAAA;AAKpB,OAAO,KAAK,EAAE,EAAc,KAAK,oBAAoB,EAAU,MAAM,OAAO,CAAA;AAS5E,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,CAAA;AAEpC,MAAM,WAAW,yBAAyB;IACxC,CAAC,GAAG,EAAE,QAAQ,MAAM,EAAE,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAC9D,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,KAAK,CAAA;IACf,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,KAAK,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,yBAAyB;IACxC,CAAC,GAAG,EAAE,QAAQ,MAAM,EAAE,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAC9D,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,KAAK,CAAA;IACf,4EAA4E;IAC5E,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,KAAK,CAAA;IAChB,kDAAkD;IAClD,OAAO,EAAE,IAAI,CAAA;IACb,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,SAAS,CAAC,EAAE,KAAK,CAAA;IACjB,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED,MAAM,MAAM,YAAY,GACpB,mBAAmB,GACnB,yBAAyB,GACzB,yBAAyB,CAAA;AAE7B,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAA;IACb,gDAAgD;IAChD,OAAO,EAAE,YAAY,EAAE,CAAA;CACxB;AAED,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,kBAAkB,CAAA;AAM1D,UAAU,eAAe;IACvB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,0DAA0D;IAC1D,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAA;IACnB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,UAAU,CAAA;CAClB;AAED,UAAU,sBAAuB,SAAQ,eAAe;IACtD,mEAAmE;IACnE,SAAS,CAAC,EAAE,KAAK,CAAA;IACjB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAA;CACd;AAED,UAAU,qBAAsB,SAAQ,eAAe;IACrD,mEAAmE;IACnE,SAAS,EAAE,IAAI,CAAA;IACf,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAA;CACd;AAED,UAAU,mBAAoB,SAAQ,eAAe;IACnD,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,KAAK,CAAA;IACjB,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED,UAAU,wBAAyB,SAAQ,eAAe;IACxD,+DAA+D;IAC/D,iBAAiB,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,KAAK,CAAA;IACjB,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED,MAAM,MAAM,WAAW,GACnB,mBAAmB,GACnB,wBAAwB,GACxB,qBAAqB,GACrB,sBAAsB,CAAA;AAE1B,KAAK,sBAAsB,GAAG,IAAI,CAChC,oBAAoB,CAAC,iBAAiB,CAAC,EACvC,MAAM,WAAW,GAAG,UAAU,GAAG,MAAM,CACxC,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG,sBAAsB,GAC3D,WAAW,GAAG;IACZ,OAAO,CAAC,EAAE,KAAK,CAAA;CAChB,CAAA;AAEH,MAAM,MAAM,yBAAyB,GAAG,sBAAsB,GAC5D,WAAW,GAAG;IACZ,OAAO,EAAE,IAAI,CAAA;CACd,CAAA;AAEH,MAAM,MAAM,kBAAkB,GAC1B,wBAAwB,GACxB,yBAAyB,CAAA;AAkB7B,eAAO,MAAM,MAAM,8FA4GlB,CAAA"}
+{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../../../src/components/select/Select.tsx"],"names":[],"mappings":"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"}

package/dist/components/select/Select.js

@@ -35,6 +35,9 @@ const Select = forwardRef(function Select(props, ref) {
     const computedDefaultValue = normalizedDefaultValue === undefined && normalizedValue === undefined
         ? ""
         : normalizedDefaultValue;
+    const effectivePlaceholder = normalizedDefaultValue !== undefined && normalizedDefaultValue !== ""
+        ? null
+        : placeholder || "Select an option";
     const showLabel = !!label && !hideLabel;
     const computedAriaLabel = userAriaLabel ?? (hideLabel ? label : undefined);
     const computedAriaLabelledBy = userAriaLabelledBy ??
@@ -47,7 +50,7 @@ const Select = forwardRef(function Select(props, ref) {
         defaultValue: computedDefaultValue,
         invalid,
         options,
-        placeholder,
+        placeholder: effectivePlaceholder,
         required,
         value: normalizedValue,
     };

package/dist/components/select/Select.js.map

@@ -1 +1 @@
-{"version":3,"file":"Select.js","sources":["../../../src/components/select/Select.tsx"],"sourcesContent":["import \"./index.css\"\n\nimport Icon from \"@utilities/Icon\"\nimport { useId } from \"@utilities/useId\"\nimport classNames from \"classnames\"\nimport React, { forwardRef, type SelectHTMLAttributes, useRef } from \"react\"\n\nimport { SelectNative } from \"./SelectNative\"\nimport { SelectPopover } from \"./SelectPopover\"\n\n// ---------------------------------------------------------------------------\n// Shared types\n// ---------------------------------------------------------------------------\n\nexport type SelectSize = \"lg\" | \"md\"\n\nexport interface SelectOptionWithTextLabel {\n  [key: `data-${string}`]: boolean | number | string | undefined\n  /** Whether this option is non-interactive. */\n  disabled?: boolean\n  divider?: never\n  /** Displayed as the option content and used for type-ahead matching. */\n  label: string\n  textValue?: never\n  value: string\n}\n\nexport interface SelectOptionWithNodeLabel {\n  [key: `data-${string}`]: boolean | number | string | undefined\n  /** Whether this option is non-interactive. */\n  disabled?: boolean\n  divider?: never\n  /** Displayed as the option content. Accepts React nodes in complex mode. */\n  label: React.ReactNode\n  /** Plain-text fallback for type-ahead matching when `label` is a React node. */\n  textValue: string\n  value: string\n}\n\nexport interface SelectOptionDivider {\n  disabled?: never\n  /** Renders a visual separator between options. */\n  divider: true\n  label?: never\n  textValue?: never\n  value?: never\n}\n\nexport type SelectOption =\n  | SelectOptionDivider\n  | SelectOptionWithNodeLabel\n  | SelectOptionWithTextLabel\n\nexport interface SelectOptionsGroup {\n  /** Whether all options in this group are non-interactive. */\n  disabled?: boolean\n  /** Visible heading displayed above the group's options. */\n  label: string\n  /** The selectable options within this group. */\n  options: SelectOption[]\n}\n\nexport type SelectItem = SelectOption | SelectOptionsGroup\n\n// ---------------------------------------------------------------------------\n// Select component props\n// ---------------------------------------------------------------------------\n\ninterface SelectBaseProps {\n  /** When true, renders as a popover listbox instead of a native `<select>`. */\n  complex?: boolean\n  /** Helper text displayed below the select. Styled as error text when `invalid`. */\n  description?: string\n  /** Whether the select is in an invalid state. */\n  invalid?: boolean\n  /** A flat or mixed array of options and option groups. */\n  options: SelectItem[]\n  /** Placeholder text shown when no option is selected. */\n  placeholder: string\n  /** The size of the select. */\n  size?: SelectSize\n}\n\ninterface SelectWithVisibleLabel extends SelectBaseProps {\n  /** If true, the label is visually hidden and set as aria-label. */\n  hideLabel?: false\n  /** The label text for the select. */\n  label: string\n}\n\ninterface SelectWithHiddenLabel extends SelectBaseProps {\n  /** If true, the label is visually hidden and set as aria-label. */\n  hideLabel: true\n  /** The label text for the select. Must be a string when hidden. */\n  label: string\n}\n\ninterface SelectWithAriaLabel extends SelectBaseProps {\n  /** Accessible label for the select. Use when no visible label exists. */\n  \"aria-label\": string\n  hideLabel?: never\n  label?: never\n}\n\ninterface SelectWithAriaLabelledBy extends SelectBaseProps {\n  /** ID of an external label element. Use instead of `label`. */\n  \"aria-labelledby\": string\n  hideLabel?: never\n  label?: never\n}\n\nexport type SelectProps =\n  | SelectWithAriaLabel\n  | SelectWithAriaLabelledBy\n  | SelectWithHiddenLabel\n  | SelectWithVisibleLabel\n\ntype BaseSelectElementProps = Omit<\n  SelectHTMLAttributes<HTMLSelectElement>,\n  keyof SelectProps | \"multiple\" | \"size\"\n>\n\nexport type NativeSelectElementProps = BaseSelectElementProps &\n  SelectProps & {\n    complex?: false\n  }\n\nexport type ComplexSelectElementProps = BaseSelectElementProps &\n  SelectProps & {\n    complex: true\n  }\n\nexport type SelectElementProps =\n  | NativeSelectElementProps\n  | ComplexSelectElementProps\n\nfunction normalizeSelectValue(\n  value:\n    | NativeSelectElementProps[\"defaultValue\"]\n    | NativeSelectElementProps[\"value\"]\n    | ComplexSelectElementProps[\"defaultValue\"]\n    | ComplexSelectElementProps[\"value\"]\n) {\n  if (value === undefined || value === null) return undefined\n  if (Array.isArray(value)) return value[0]\n  return String(value)\n}\n\n// ---------------------------------------------------------------------------\n// Select (public)\n// ---------------------------------------------------------------------------\n\nexport const Select = forwardRef<HTMLSelectElement, SelectElementProps>(\n  function Select(props: SelectElementProps, ref) {\n    const {\n      \"aria-label\": userAriaLabel,\n      \"aria-labelledby\": userAriaLabelledBy,\n      className,\n      complex,\n      defaultValue,\n      description,\n      hideLabel,\n      id,\n      invalid,\n      label,\n      onChange,\n      options,\n      placeholder,\n      required,\n      size,\n      value,\n      ...restProps\n    } = props\n\n    const triggerRef = useRef<HTMLButtonElement>(null)\n    const stableId = useId()\n    const controlId = id || `tds-select-${stableId}`\n    const labelId = `${controlId}-label`\n    const resolvedDescription =\n      description || (invalid ? \"Please select an option\" : undefined)\n    const descriptionId = resolvedDescription\n      ? `${controlId}-description`\n      : undefined\n    const computedClassName = classNames(\n      \"tds-select\",\n      {\n        \"tds-select--invalid\": invalid,\n        \"tds-select--lg\": size === \"lg\",\n        \"tds-select--required\": required,\n      },\n      className\n    )\n\n    const normalizedDefaultValue = normalizeSelectValue(defaultValue)\n    const normalizedValue = normalizeSelectValue(value)\n\n    const computedDefaultValue =\n      normalizedDefaultValue === undefined && normalizedValue === undefined\n        ? \"\"\n        : normalizedDefaultValue\n    const showLabel = !!label && !hideLabel\n    const computedAriaLabel = userAriaLabel ?? (hideLabel ? label : undefined)\n    const computedAriaLabelledBy =\n      userAriaLabelledBy ??\n      (computedAriaLabel || !showLabel ? undefined : labelId)\n\n    const sharedControlProps = {\n      ...restProps,\n      \"aria-describedby\": descriptionId,\n      \"aria-label\": computedAriaLabel,\n      \"aria-labelledby\": computedAriaLabelledBy,\n      defaultValue: computedDefaultValue,\n      invalid,\n      options,\n      placeholder,\n      required,\n      value: normalizedValue,\n    }\n\n    const handleComplexLabelClick = () => triggerRef.current?.focus()\n\n    const SelectComponent = complex ? SelectPopover : SelectNative\n\n    return (\n      <div className={computedClassName}>\n        {showLabel &&\n          (complex ? (\n            // eslint-disable-next-line jsx-a11y/click-events-have-key-events, jsx-a11y/no-static-element-interactions -- mirrors native label click-to-focus; keyboard users interact with the combobox directly\n            <div\n              className=\"tds-select-label\"\n              id={labelId}\n              onClick={handleComplexLabelClick}\n            >\n              {label}\n            </div>\n          ) : (\n            <label htmlFor={controlId} id={labelId}>\n              {label}\n            </label>\n          ))}\n        <SelectComponent\n          {...sharedControlProps}\n          ref={ref}\n          id={controlId}\n          onChange={onChange}\n          {...(complex && { triggerRef })}\n        />\n        {resolvedDescription && descriptionId && (\n          <p className=\"tds-select-description\" id={descriptionId}>\n            <Icon\n              aria-hidden\n              className=\"tds-select-description-invalid-icon\"\n              symbol=\"general#exclamation-triangle\"\n            />\n            {resolvedDescription}\n          </p>\n        )}\n      </div>\n    )\n  }\n)\n\nSelect.displayName = \"Select\"\n"],"names":["React"],"mappings":"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"}
+{"version":3,"file":"Select.js","sources":["../../../src/components/select/Select.tsx"],"sourcesContent":["import \"./index.css\"\n\nimport Icon from \"@utilities/Icon\"\nimport { useId } from \"@utilities/useId\"\nimport classNames from \"classnames\"\nimport React, { forwardRef, type SelectHTMLAttributes, useRef } from \"react\"\n\nimport { SelectNative } from \"./SelectNative\"\nimport { SelectPopover } from \"./SelectPopover\"\n\n// ---------------------------------------------------------------------------\n// Shared types\n// ---------------------------------------------------------------------------\n\nexport type SelectSize = \"lg\" | \"md\"\n\nexport interface SelectOptionWithTextLabel {\n  [key: `data-${string}`]: boolean | number | string | undefined\n  /** Whether this option is non-interactive. */\n  disabled?: boolean\n  divider?: never\n  /** Displayed as the option content and used for type-ahead matching. */\n  label: string\n  textValue?: never\n  value: string\n}\n\nexport interface SelectOptionWithNodeLabel {\n  [key: `data-${string}`]: boolean | number | string | undefined\n  /** Whether this option is non-interactive. */\n  disabled?: boolean\n  divider?: never\n  /** Displayed as the option content. Accepts React nodes in complex mode. */\n  label: React.ReactNode\n  /** Plain-text fallback for type-ahead matching when `label` is a React node. */\n  textValue: string\n  value: string\n}\n\nexport interface SelectOptionDivider {\n  disabled?: never\n  /** Renders a visual separator between options. */\n  divider: true\n  label?: never\n  textValue?: never\n  value?: never\n}\n\nexport type SelectOption =\n  | SelectOptionDivider\n  | SelectOptionWithNodeLabel\n  | SelectOptionWithTextLabel\n\nexport interface SelectOptionsGroup {\n  /** Whether all options in this group are non-interactive. */\n  disabled?: boolean\n  /** Visible heading displayed above the group's options. */\n  label: string\n  /** The selectable options within this group. */\n  options: SelectOption[]\n}\n\nexport type SelectItem = SelectOption | SelectOptionsGroup\n\n// ---------------------------------------------------------------------------\n// Select component props\n// ---------------------------------------------------------------------------\n\ninterface SelectBaseProps {\n  /** When true, renders as a popover listbox instead of a native `<select>`. */\n  complex?: boolean\n  /** Helper text displayed below the select. Styled as error text when `invalid`. */\n  description?: string\n  /** Whether the select is in an invalid state. */\n  invalid?: boolean\n  /** A flat or mixed array of options and option groups. */\n  options: SelectItem[]\n  /** Placeholder text shown when no option is selected. Defaults to `\"Select an option\"`. */\n  placeholder?: string\n  /** The size of the select. */\n  size?: SelectSize\n}\n\ninterface SelectWithVisibleLabel extends SelectBaseProps {\n  /** If true, the label is visually hidden and set as aria-label. */\n  hideLabel?: false\n  /** The label text for the select. */\n  label: string\n}\n\ninterface SelectWithHiddenLabel extends SelectBaseProps {\n  /** If true, the label is visually hidden and set as aria-label. */\n  hideLabel: true\n  /** The label text for the select. Must be a string when hidden. */\n  label: string\n}\n\ninterface SelectWithAriaLabel extends SelectBaseProps {\n  /** Accessible label for the select. Use when no visible label exists. */\n  \"aria-label\": string\n  hideLabel?: never\n  label?: never\n}\n\ninterface SelectWithAriaLabelledBy extends SelectBaseProps {\n  /** ID of an external label element. Use instead of `label`. */\n  \"aria-labelledby\": string\n  hideLabel?: never\n  label?: never\n}\n\nexport type SelectProps =\n  | SelectWithAriaLabel\n  | SelectWithAriaLabelledBy\n  | SelectWithHiddenLabel\n  | SelectWithVisibleLabel\n\ntype BaseSelectElementProps = Omit<\n  SelectHTMLAttributes<HTMLSelectElement>,\n  keyof SelectProps | \"multiple\" | \"size\"\n>\n\nexport type NativeSelectElementProps = BaseSelectElementProps &\n  SelectProps & {\n    complex?: false\n  }\n\nexport type ComplexSelectElementProps = BaseSelectElementProps &\n  SelectProps & {\n    complex: true\n  }\n\nexport type SelectElementProps =\n  | NativeSelectElementProps\n  | ComplexSelectElementProps\n\nfunction normalizeSelectValue(\n  value:\n    | NativeSelectElementProps[\"defaultValue\"]\n    | NativeSelectElementProps[\"value\"]\n    | ComplexSelectElementProps[\"defaultValue\"]\n    | ComplexSelectElementProps[\"value\"]\n) {\n  if (value === undefined || value === null) return undefined\n  if (Array.isArray(value)) return value[0]\n  return String(value)\n}\n\n// ---------------------------------------------------------------------------\n// Select (public)\n// ---------------------------------------------------------------------------\n\nexport const Select = forwardRef<HTMLSelectElement, SelectElementProps>(\n  function Select(props: SelectElementProps, ref) {\n    const {\n      \"aria-label\": userAriaLabel,\n      \"aria-labelledby\": userAriaLabelledBy,\n      className,\n      complex,\n      defaultValue,\n      description,\n      hideLabel,\n      id,\n      invalid,\n      label,\n      onChange,\n      options,\n      placeholder,\n      required,\n      size,\n      value,\n      ...restProps\n    } = props\n\n    const triggerRef = useRef<HTMLButtonElement>(null)\n    const stableId = useId()\n    const controlId = id || `tds-select-${stableId}`\n    const labelId = `${controlId}-label`\n    const resolvedDescription =\n      description || (invalid ? \"Please select an option\" : undefined)\n    const descriptionId = resolvedDescription\n      ? `${controlId}-description`\n      : undefined\n    const computedClassName = classNames(\n      \"tds-select\",\n      {\n        \"tds-select--invalid\": invalid,\n        \"tds-select--lg\": size === \"lg\",\n        \"tds-select--required\": required,\n      },\n      className\n    )\n\n    const normalizedDefaultValue = normalizeSelectValue(defaultValue)\n    const normalizedValue = normalizeSelectValue(value)\n\n    const computedDefaultValue =\n      normalizedDefaultValue === undefined && normalizedValue === undefined\n        ? \"\"\n        : normalizedDefaultValue\n    const effectivePlaceholder =\n      normalizedDefaultValue !== undefined && normalizedDefaultValue !== \"\"\n        ? null\n        : placeholder || \"Select an option\"\n    const showLabel = !!label && !hideLabel\n    const computedAriaLabel = userAriaLabel ?? (hideLabel ? label : undefined)\n    const computedAriaLabelledBy =\n      userAriaLabelledBy ??\n      (computedAriaLabel || !showLabel ? undefined : labelId)\n\n    const sharedControlProps = {\n      ...restProps,\n      \"aria-describedby\": descriptionId,\n      \"aria-label\": computedAriaLabel,\n      \"aria-labelledby\": computedAriaLabelledBy,\n      defaultValue: computedDefaultValue,\n      invalid,\n      options,\n      placeholder: effectivePlaceholder,\n      required,\n      value: normalizedValue,\n    }\n\n    const handleComplexLabelClick = () => triggerRef.current?.focus()\n\n    const SelectComponent = complex ? SelectPopover : SelectNative\n\n    return (\n      <div className={computedClassName}>\n        {showLabel &&\n          (complex ? (\n            // eslint-disable-next-line jsx-a11y/click-events-have-key-events, jsx-a11y/no-static-element-interactions -- mirrors native label click-to-focus; keyboard users interact with the combobox directly\n            <div\n              className=\"tds-select-label\"\n              id={labelId}\n              onClick={handleComplexLabelClick}\n            >\n              {label}\n            </div>\n          ) : (\n            <label htmlFor={controlId} id={labelId}>\n              {label}\n            </label>\n          ))}\n        <SelectComponent\n          {...sharedControlProps}\n          ref={ref}\n          id={controlId}\n          onChange={onChange}\n          {...(complex && { triggerRef })}\n        />\n        {resolvedDescription && descriptionId && (\n          <p className=\"tds-select-description\" id={descriptionId}>\n            <Icon\n              aria-hidden\n              className=\"tds-select-description-invalid-icon\"\n              symbol=\"general#exclamation-triangle\"\n            />\n            {resolvedDescription}\n          </p>\n        )}\n      </div>\n    )\n  }\n)\n\nSelect.displayName = \"Select\"\n"],"names":["React"],"mappings":";;;;;;;AAwIA,SAAS,oBAAoB,CAC3B,KAIsC,EAAA;AAEtC,IAAA,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;AAAE,QAAA,OAAO,SAAS;AAC3D,IAAA,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;AAAE,QAAA,OAAO,KAAK,CAAC,CAAC,CAAC;AACzC,IAAA,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB;AAEA;AACA;AACA;AAEO,MAAM,MAAM,GAAG,UAAU,CAC9B,SAAS,MAAM,CAAC,KAAyB,EAAE,GAAG,EAAA;AAC5C,IAAA,MAAM,EACJ,YAAY,EAAE,aAAa,EAC3B,iBAAiB,EAAE,kBAAkB,EACrC,SAAS,EACT,OAAO,EACP,YAAY,EACZ,WAAW,EACX,SAAS,EACT,EAAE,EACF,OAAO,EACP,KAAK,EACL,QAAQ,EACR,OAAO,EACP,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,GAAG,SAAS,EACb,GAAG,KAAK;AAET,IAAA,MAAM,UAAU,GAAG,MAAM,CAAoB,IAAI,CAAC;AAClD,IAAA,MAAM,QAAQ,GAAG,KAAK,EAAE;AACxB,IAAA,MAAM,SAAS,GAAG,EAAE,IAAI,CAAA,WAAA,EAAc,QAAQ,EAAE;AAChD,IAAA,MAAM,OAAO,GAAG,CAAA,EAAG,SAAS,QAAQ;AACpC,IAAA,MAAM,mBAAmB,GACvB,WAAW,KAAK,OAAO,GAAG,yBAAyB,GAAG,SAAS,CAAC;IAClE,MAAM,aAAa,GAAG;UAClB,CAAA,EAAG,SAAS,CAAA,YAAA;UACZ,SAAS;AACb,IAAA,MAAM,iBAAiB,GAAG,UAAU,CAClC,YAAY,EACZ;AACE,QAAA,qBAAqB,EAAE,OAAO;QAC9B,gBAAgB,EAAE,IAAI,KAAK,IAAI;AAC/B,QAAA,sBAAsB,EAAE,QAAQ;KACjC,EACD,SAAS,CACV;AAED,IAAA,MAAM,sBAAsB,GAAG,oBAAoB,CAAC,YAAY,CAAC;AACjE,IAAA,MAAM,eAAe,GAAG,oBAAoB,CAAC,KAAK,CAAC;IAEnD,MAAM,oBAAoB,GACxB,sBAAsB,KAAK,SAAS,IAAI,eAAe,KAAK;AAC1D,UAAE;UACA,sBAAsB;IAC5B,MAAM,oBAAoB,GACxB,sBAAsB,KAAK,SAAS,IAAI,sBAAsB,KAAK;AACjE,UAAE;AACF,UAAE,WAAW,IAAI,kBAAkB;IACvC,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS;AACvC,IAAA,MAAM,iBAAiB,GAAG,aAAa,KAAK,SAAS,GAAG,KAAK,GAAG,SAAS,CAAC;IAC1E,MAAM,sBAAsB,GAC1B,kBAAkB;AAClB,SAAC,iBAAiB,IAAI,CAAC,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEzD,IAAA,MAAM,kBAAkB,GAAG;AACzB,QAAA,GAAG,SAAS;AACZ,QAAA,kBAAkB,EAAE,aAAa;AACjC,QAAA,YAAY,EAAE,iBAAiB;AAC/B,QAAA,iBAAiB,EAAE,sBAAsB;AACzC,QAAA,YAAY,EAAE,oBAAoB;QAClC,OAAO;QACP,OAAO;AACP,QAAA,WAAW,EAAE,oBAAoB;QACjC,QAAQ;AACR,QAAA,KAAK,EAAE,eAAe;KACvB;IAED,MAAM,uBAAuB,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE;IAEjE,MAAM,eAAe,GAAG,OAAO,GAAG,aAAa,GAAG,YAAY;AAE9D,IAAA,QACEA,cAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,SAAS,EAAE,iBAAiB,EAAA;QAC9B,SAAS;aACP,OAAO;;AAEN,YAAAA,cAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EACE,SAAS,EAAC,kBAAkB,EAC5B,EAAE,EAAE,OAAO,EACX,OAAO,EAAE,uBAAuB,EAAA,EAE/B,KAAK,CACF,KAENA,cAAA,CAAA,aAAA,CAAA,OAAA,EAAA,EAAO,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAA,EACnC,KAAK,CACA,CACT,CAAC;QACJA,cAAA,CAAA,aAAA,CAAC,eAAe,OACV,kBAAkB,EACtB,GAAG,EAAE,GAAG,EACR,EAAE,EAAE,SAAS,EACb,QAAQ,EAAE,QAAQ,EAAA,IACb,OAAO,IAAI,EAAE,UAAU,EAAE,CAAC,EAAA,CAC/B;QACD,mBAAmB,IAAI,aAAa,KACnCA,cAAA,CAAA,aAAA,CAAA,GAAA,EAAA,EAAG,SAAS,EAAC,wBAAwB,EAAC,EAAE,EAAE,aAAa,EAAA;YACrDA,cAAA,CAAA,aAAA,CAAC,IAAI,yBAEH,SAAS,EAAC,qCAAqC,EAC/C,MAAM,EAAC,8BAA8B,EAAA,CACrC;AACD,YAAA,mBAAmB,CAClB,CACL,CACG;AAEV,CAAC;AAGH,MAAM,CAAC,WAAW,GAAG,QAAQ;;;;"}

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

@@ -12,8 +12,8 @@ export interface SelectNativeProps {
     invalid?: boolean;
     /** Options to render inside the select. */
     options: SelectItem[];
-    /** Placeholder text rendered as a disabled hidden option. */
-    placeholder: string;
+    /** Placeholder text rendered as a disabled hidden option. `null` suppresses the option. */
+    placeholder: string | null;
 }
 export type SelectNativeElementProps = Omit<SelectHTMLAttributes<HTMLSelectElement>, keyof SelectNativeProps | "multiple"> & SelectNativeProps;
 export declare const SelectNative: React.ForwardRefExoticComponent<Omit<React.SelectHTMLAttributes<HTMLSelectElement>, "multiple" | keyof SelectNativeProps> & SelectNativeProps & React.RefAttributes<HTMLSelectElement>>;

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

@@ -1 +1 @@
-{"version":3,"file":"SelectNative.d.ts","sourceRoot":"","sources":["../../../src/components/select/SelectNative.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAEZ,KAAK,oBAAoB,EAG1B,MAAM,OAAO,CAAA;AAEd,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAuB1C,OAAO,CAAC,MAAM,CAAC;IAEb,UAAU,GAAG,CAAC;QACZ,UAAU,iBAAiB;YACzB,eAAe,EAAE,KAAK,CAAC,iBAAiB,CACtC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,EACjC,WAAW,CACZ,CAAA;SACF;KACF;CACF;AAMD,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,2CAA2C;IAC3C,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACzC,oBAAoB,CAAC,iBAAiB,CAAC,EACvC,MAAM,iBAAiB,GAAG,UAAU,CACrC,GACC,iBAAiB,CAAA;AAEnB,eAAO,MAAM,YAAY,yLAmCvB,CAAA"}
+{"version":3,"file":"SelectNative.d.ts","sourceRoot":"","sources":["../../../src/components/select/SelectNative.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAEZ,KAAK,oBAAoB,EAG1B,MAAM,OAAO,CAAA;AAEd,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAuB1C,OAAO,CAAC,MAAM,CAAC;IAEb,UAAU,GAAG,CAAC;QACZ,UAAU,iBAAiB;YACzB,eAAe,EAAE,KAAK,CAAC,iBAAiB,CACtC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,EACjC,WAAW,CACZ,CAAA;SACF;KACF;CACF;AAMD,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,2CAA2C;IAC3C,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,2FAA2F;IAC3F,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACzC,oBAAoB,CAAC,iBAAiB,CAAC,EACvC,MAAM,iBAAiB,GAAG,UAAU,CACrC,GACC,iBAAiB,CAAA;AAEnB,eAAO,MAAM,YAAY,yLAmCvB,CAAA"}

package/dist/components/select/SelectNative.js.map

@@ -1 +1 @@
-{"version":3,"file":"SelectNative.js","sources":["../../../src/components/select/SelectNative.tsx"],"sourcesContent":["import React, {\n  forwardRef,\n  type SelectHTMLAttributes,\n  useEffect,\n  useState,\n} from \"react\"\n\nimport type { SelectItem } from \"./Select\"\nimport { SelectOptions } from \"./SelectOptions\"\n\n// ---------------------------------------------------------------------------\n// base-select feature detection (cached)\n// ---------------------------------------------------------------------------\n\nlet _supportsBaseSelect: boolean | null = null\n\nfunction supportsBaseSelect(): boolean {\n  if (_supportsBaseSelect === null) {\n    _supportsBaseSelect =\n      typeof CSS !== \"undefined\" &&\n      typeof CSS.supports === \"function\" &&\n      CSS.supports(\"appearance\", \"base-select\")\n  }\n  return _supportsBaseSelect\n}\n\n// ---------------------------------------------------------------------------\n// JSX augmentation for <selectedcontent>\n// ---------------------------------------------------------------------------\n\ndeclare global {\n  // eslint-disable-next-line @typescript-eslint/no-namespace\n  namespace JSX {\n    interface IntrinsicElements {\n      selectedcontent: React.DetailedHTMLProps<\n        React.HTMLAttributes<HTMLElement>,\n        HTMLElement\n      >\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// SelectNative\n// ---------------------------------------------------------------------------\n\nexport interface SelectNativeProps {\n  /** Triggers invalid state (maps to aria-invalid). */\n  invalid?: boolean\n  /** Options to render inside the select. */\n  options: SelectItem[]\n  /** Placeholder text rendered as a disabled hidden option. */\n  placeholder: string\n}\n\nexport type SelectNativeElementProps = Omit<\n  SelectHTMLAttributes<HTMLSelectElement>,\n  keyof SelectNativeProps | \"multiple\"\n> &\n  SelectNativeProps\n\nexport const SelectNative = forwardRef<\n  HTMLSelectElement,\n  SelectNativeElementProps\n>(function SelectNative(\n  { invalid, options, placeholder, ...restProps }: SelectNativeElementProps,\n  ref\n) {\n  // Keep first render deterministic for SSR/hydration, then detect support on mount.\n  const [isCustom, setIsCustom] = useState(false)\n\n  useEffect(() => {\n    if (supportsBaseSelect()) {\n      setIsCustom(true)\n    }\n  }, [])\n\n  return (\n    <select\n      {...restProps}\n      aria-invalid={invalid ? \"true\" : undefined}\n      ref={ref}\n    >\n      {isCustom && (\n        <button>\n          <selectedcontent />\n        </button>\n      )}\n      {placeholder && (\n        <option disabled hidden value=\"\">\n          {placeholder}\n        </option>\n      )}\n      <SelectOptions items={options} supportsBaseSelect={isCustom} />\n    </select>\n  )\n})\n\nSelectNative.displayName = \"SelectNative\"\n"],"names":["React"],"mappings":";;;AAUA;AACA;AACA;AAEA,IAAI,mBAAmB,GAAmB,IAAI;AAE9C,SAAS,kBAAkB,GAAA;AACzB,IAAA,IAAI,mBAAmB,KAAK,IAAI,EAAE;QAChC,mBAAmB;YACjB,OAAO,GAAG,KAAK,WAAW;AAC1B,gBAAA,OAAO,GAAG,CAAC,QAAQ,KAAK,UAAU;AAClC,gBAAA,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC;IAC7C;AACA,IAAA,OAAO,mBAAmB;AAC5B;MAqCa,YAAY,GAAG,UAAU,CAGpC,SAAS,YAAY,CACrB,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,SAAS,EAA4B,EACzE,GAAG,EAAA;;IAGH,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;IAE/C,SAAS,CAAC,MAAK;QACb,IAAI,kBAAkB,EAAE,EAAE;YACxB,WAAW,CAAC,IAAI,CAAC;QACnB;IACF,CAAC,EAAE,EAAE,CAAC;AAEN,IAAA,QACEA,cAAA,CAAA,aAAA,CAAA,QAAA,EAAA,EAAA,GACM,SAAS,EAAA,cAAA,EACC,OAAO,GAAG,MAAM,GAAG,SAAS,EAC1C,GAAG,EAAE,GAAG,EAAA;AAEP,QAAA,QAAQ,KACPA,cAAA,CAAA,aAAA,CAAA,QAAA,EAAA,IAAA;AACE,YAAAA,cAAA,CAAA,aAAA,CAAA,iBAAA,EAAA,IAAA,CAAmB,CACZ,CACV;AACA,QAAA,WAAW,KACVA,cAAA,CAAA,aAAA,CAAA,QAAA,EAAA,EAAQ,QAAQ,EAAA,IAAA,EAAC,MAAM,EAAA,IAAA,EAAC,KAAK,EAAC,EAAE,EAAA,EAC7B,WAAW,CACL,CACV;AACD,QAAAA,cAAA,CAAA,aAAA,CAAC,aAAa,EAAA,EAAC,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAA,CAAI,CACxD;AAEb,CAAC;AAED,YAAY,CAAC,WAAW,GAAG,cAAc;;;;"}
+{"version":3,"file":"SelectNative.js","sources":["../../../src/components/select/SelectNative.tsx"],"sourcesContent":["import React, {\n  forwardRef,\n  type SelectHTMLAttributes,\n  useEffect,\n  useState,\n} from \"react\"\n\nimport type { SelectItem } from \"./Select\"\nimport { SelectOptions } from \"./SelectOptions\"\n\n// ---------------------------------------------------------------------------\n// base-select feature detection (cached)\n// ---------------------------------------------------------------------------\n\nlet _supportsBaseSelect: boolean | null = null\n\nfunction supportsBaseSelect(): boolean {\n  if (_supportsBaseSelect === null) {\n    _supportsBaseSelect =\n      typeof CSS !== \"undefined\" &&\n      typeof CSS.supports === \"function\" &&\n      CSS.supports(\"appearance\", \"base-select\")\n  }\n  return _supportsBaseSelect\n}\n\n// ---------------------------------------------------------------------------\n// JSX augmentation for <selectedcontent>\n// ---------------------------------------------------------------------------\n\ndeclare global {\n  // eslint-disable-next-line @typescript-eslint/no-namespace\n  namespace JSX {\n    interface IntrinsicElements {\n      selectedcontent: React.DetailedHTMLProps<\n        React.HTMLAttributes<HTMLElement>,\n        HTMLElement\n      >\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// SelectNative\n// ---------------------------------------------------------------------------\n\nexport interface SelectNativeProps {\n  /** Triggers invalid state (maps to aria-invalid). */\n  invalid?: boolean\n  /** Options to render inside the select. */\n  options: SelectItem[]\n  /** Placeholder text rendered as a disabled hidden option. `null` suppresses the option. */\n  placeholder: string | null\n}\n\nexport type SelectNativeElementProps = Omit<\n  SelectHTMLAttributes<HTMLSelectElement>,\n  keyof SelectNativeProps | \"multiple\"\n> &\n  SelectNativeProps\n\nexport const SelectNative = forwardRef<\n  HTMLSelectElement,\n  SelectNativeElementProps\n>(function SelectNative(\n  { invalid, options, placeholder, ...restProps }: SelectNativeElementProps,\n  ref\n) {\n  // Keep first render deterministic for SSR/hydration, then detect support on mount.\n  const [isCustom, setIsCustom] = useState(false)\n\n  useEffect(() => {\n    if (supportsBaseSelect()) {\n      setIsCustom(true)\n    }\n  }, [])\n\n  return (\n    <select\n      {...restProps}\n      aria-invalid={invalid ? \"true\" : undefined}\n      ref={ref}\n    >\n      {isCustom && (\n        <button>\n          <selectedcontent />\n        </button>\n      )}\n      {placeholder && (\n        <option disabled hidden value=\"\">\n          {placeholder}\n        </option>\n      )}\n      <SelectOptions items={options} supportsBaseSelect={isCustom} />\n    </select>\n  )\n})\n\nSelectNative.displayName = \"SelectNative\"\n"],"names":["React"],"mappings":";;;AAUA;AACA;AACA;AAEA,IAAI,mBAAmB,GAAmB,IAAI;AAE9C,SAAS,kBAAkB,GAAA;AACzB,IAAA,IAAI,mBAAmB,KAAK,IAAI,EAAE;QAChC,mBAAmB;YACjB,OAAO,GAAG,KAAK,WAAW;AAC1B,gBAAA,OAAO,GAAG,CAAC,QAAQ,KAAK,UAAU;AAClC,gBAAA,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC;IAC7C;AACA,IAAA,OAAO,mBAAmB;AAC5B;MAqCa,YAAY,GAAG,UAAU,CAGpC,SAAS,YAAY,CACrB,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,SAAS,EAA4B,EACzE,GAAG,EAAA;;IAGH,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;IAE/C,SAAS,CAAC,MAAK;QACb,IAAI,kBAAkB,EAAE,EAAE;YACxB,WAAW,CAAC,IAAI,CAAC;QACnB;IACF,CAAC,EAAE,EAAE,CAAC;AAEN,IAAA,QACEA,cAAA,CAAA,aAAA,CAAA,QAAA,EAAA,EAAA,GACM,SAAS,EAAA,cAAA,EACC,OAAO,GAAG,MAAM,GAAG,SAAS,EAC1C,GAAG,EAAE,GAAG,EAAA;AAEP,QAAA,QAAQ,KACPA,cAAA,CAAA,aAAA,CAAA,QAAA,EAAA,IAAA;AACE,YAAAA,cAAA,CAAA,aAAA,CAAA,iBAAA,EAAA,IAAA,CAAmB,CACZ,CACV;AACA,QAAA,WAAW,KACVA,cAAA,CAAA,aAAA,CAAA,QAAA,EAAA,EAAQ,QAAQ,EAAA,IAAA,EAAC,MAAM,EAAA,IAAA,EAAC,KAAK,EAAC,EAAE,EAAA,EAC7B,WAAW,CACL,CACV;AACD,QAAAA,cAAA,CAAA,aAAA,CAAC,aAAa,EAAA,EAAC,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAA,CAAI,CACxD;AAEb,CAAC;AAED,YAAY,CAAC,WAAW,GAAG,cAAc;;;;"}

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

@@ -10,7 +10,8 @@ export interface SelectPopoverProps {
     invalid?: boolean;
     /** A flat or mixed array of options and option groups. */
     options: SelectItem[];
-    placeholder: string;
+    /** Placeholder text shown in the trigger button when no option is selected. `null` suppresses the placeholder. */
+    placeholder: string | null;
     required?: boolean;
     triggerRef?: React.RefObject<HTMLButtonElement>;
     value?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"SelectPopover.d.ts","sourceRoot":"","sources":["../../../src/components/select/SelectPopover.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,EAEZ,KAAK,oBAAoB,EAM1B,MAAM,OAAO,CAAA;AAEd,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,UAAU,CAAA;AAQxD,MAAM,WAAW,kBAAkB;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,0DAA0D;IAC1D,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAA;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,oBAAoB,CAAC,iBAAiB,CAAC,EACvC,MAAM,kBAAkB,GAAG,UAAU,CACtC,GACC,kBAAkB,CAAA;AAqDpB,eAAO,MAAM,aAAa,2LA2ZzB,CAAA"}
+{"version":3,"file":"SelectPopover.d.ts","sourceRoot":"","sources":["../../../src/components/select/SelectPopover.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,EAEZ,KAAK,oBAAoB,EAM1B,MAAM,OAAO,CAAA;AAEd,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,UAAU,CAAA;AAQxD,MAAM,WAAW,kBAAkB;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,0DAA0D;IAC1D,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,kHAAkH;IAClH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAA;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,oBAAoB,CAAC,iBAAiB,CAAC,EACvC,MAAM,kBAAkB,GAAG,UAAU,CACtC,GACC,kBAAkB,CAAA;AAqDpB,eAAO,MAAM,aAAa,2LA2ZzB,CAAA"}