@accelint/design-toolkit 9.1.1 → 9.3.0

package/dist/components/date-field/index.js

@@ -81,7 +81,7 @@ const months = [
 *   onChange={setSelectedDate}
 * />
 */
-function DateField({ classNames, description: descriptionProp, errorMessage: errorMessageProp, inputProps, label: labelProp, size = "medium", shortMonth = true, shouldForceLeadingZeros = true, isDisabled, isInvalid: isInvalidProp, isRequired, ...rest }) {
+function DateField({ classNames, description: descriptionProp, errorMessage: errorMessageProp, inputProps, label: labelProp, size = "medium", shortMonth = true, shouldForceLeadingZeros = true, isDisabled, isInvalid: isInvalidProp, isRequired, isReadOnly = false, ...rest }) {
 	const errorMessage = errorMessageProp || null;
 	const isSmall = size === "small";
 	return /* @__PURE__ */ jsx(DateField$1, {
@@ -91,6 +91,7 @@ function DateField({ classNames, description: descriptionProp, errorMessage: err
 		isDisabled,
 		isInvalid: isInvalidProp || (errorMessage ? true : void 0),
 		isRequired,
+		isReadOnly,
 		"aria-label": labelProp,
 		"data-size": size,
 		children: ({ isDisabled: isDisabled$1 }) => /* @__PURE__ */ jsxs(Fragment, { children: [
@@ -102,7 +103,8 @@ function DateField({ classNames, description: descriptionProp, errorMessage: err
 			}),
 			/* @__PURE__ */ jsxs("div", {
 				className: clsx(styles.control, classNames?.control),
-				children: [size === "medium" && /* @__PURE__ */ jsx(Icon, { children: /* @__PURE__ */ jsx(Calendar, {}) }), /* @__PURE__ */ jsx(DateInput, {
+				"data-readonly": isReadOnly || null,
+				children: [!isReadOnly && size === "medium" && /* @__PURE__ */ jsx(Icon, { children: /* @__PURE__ */ jsx(Calendar, {}) }), /* @__PURE__ */ jsx(DateInput, {
 					...inputProps,
 					className: composeRenderProps(classNames?.input, (className) => clsx(styles.input, className)),
 					children: (segmentProp) => {

package/dist/components/date-field/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["AriaDateField","Label","isDisabled","AriaDateInput","AriaText"],"sources":["../../../src/components/date-field/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport Calendar from '@accelint/icons/calendar';\nimport {\n  DateField as AriaDateField,\n  DateInput as AriaDateInput,\n  Text as AriaText,\n  composeRenderProps,\n  DateSegment,\n  FieldError,\n} from 'react-aria-components';\nimport { Icon } from '../icon';\nimport { Label } from '../label';\nimport styles from './styles.module.css';\nimport type { DateValue } from '@internationalized/date';\nimport type { DateFieldProps } from './types';\n\nconst months = [\n  'JAN',\n  'FEB',\n  'MAR',\n  'APR',\n  'MAY',\n  'JUN',\n  'JUL',\n  'AUG',\n  'SEP',\n  'OCT',\n  'NOV',\n  'DEC',\n];\n\n/**\n * DateField - A comprehensive date input component with segmented editing\n *\n * Provides accessible date input functionality with separate segments for day,\n * month, and year. Includes calendar icon, validation states, and international\n * date format support with keyboard navigation between segments.\n *\n * @example\n * // Basic date field\n * <DateField label=\"Birth Date\" />\n *\n * @example\n * // Date field with validation\n * <DateField\n *   label=\"Event Date\"\n *   isRequired\n *   isInvalid={hasError}\n *   errorMessage=\"Please select a valid date\"\n * />\n *\n * @example\n * // Date field with custom formatting\n * <DateField\n *   label=\"Meeting Date\"\n *   shortMonth={false}\n *   placeholder=\"Select meeting date\"\n * />\n *\n * @example\n * // Compact date field\n * <DateField\n *   label=\"Due Date\"\n *   size=\"small\"\n *   description=\"When is this task due?\"\n * />\n *\n * @example\n * // Controlled date field\n * <DateField\n *   label=\"Selected Date\"\n *   value={selectedDate}\n *   onChange={setSelectedDate}\n * />\n */\nexport function DateField<T extends DateValue>({\n  classNames,\n  description: descriptionProp,\n  errorMessage: errorMessageProp,\n  inputProps,\n  label: labelProp,\n  size = 'medium',\n  shortMonth = true,\n  shouldForceLeadingZeros = true,\n  isDisabled,\n  isInvalid: isInvalidProp,\n  isRequired,\n  ...rest\n}: DateFieldProps<T>) {\n  const errorMessage = errorMessageProp || null; // Protect against empty string\n  const isSmall = size === 'small';\n\n  return (\n    <AriaDateField<T>\n      {...rest}\n      className={composeRenderProps(classNames?.field, (className) =>\n        clsx('group/date-field', styles.field, className),\n      )}\n      shouldForceLeadingZeros={shouldForceLeadingZeros}\n      isDisabled={isDisabled}\n      isInvalid={isInvalidProp || (errorMessage ? true : undefined)} // Leave uncontrolled if possible to fallback to validation state\n      isRequired={isRequired}\n      aria-label={labelProp}\n      data-size={size}\n    >\n      {(\n        { isDisabled }, // Rely on internal state, not props, since state could differ from props\n      ) => (\n        <>\n          {!isSmall && labelProp && (\n            <Label\n              className={clsx(styles.label, classNames?.label)}\n              isDisabled={isDisabled}\n              isRequired={isRequired}\n            >\n              {labelProp}\n            </Label>\n          )}\n          <div className={clsx(styles.control, classNames?.control)}>\n            {size === 'medium' && (\n              <Icon>\n                <Calendar />\n              </Icon>\n            )}\n            <AriaDateInput\n              {...inputProps}\n              className={composeRenderProps(classNames?.input, (className) =>\n                clsx(styles.input, className),\n              )}\n            >\n              {(segmentProp) => {\n                // Remove extra space and punctuation from input display\n                if (segmentProp.type === 'literal') {\n                  return <>{segmentProp.text === ':' ? ':' : null}</>;\n                }\n\n                return (\n                  <DateSegment\n                    className={composeRenderProps(\n                      classNames?.segment,\n                      (className) =>\n                        clsx(\n                          styles.segment,\n                          segmentProp.type === 'month' &&\n                            shortMonth &&\n                            styles.shortMonth,\n                          className,\n                        ),\n                    )}\n                    segment={segmentProp}\n                  >\n                    {({\n                      placeholder,\n                      text,\n                      value,\n                      isFocused,\n                      isPlaceholder,\n                    }) => {\n                      if (isPlaceholder) {\n                        return placeholder;\n                      }\n\n                      return segmentProp.type === 'month' &&\n                        shortMonth &&\n                        !isFocused\n                        ? months[(value ?? 0) - 1]\n                        : text;\n                    }}\n                  </DateSegment>\n                );\n              }}\n            </AriaDateInput>\n          </div>\n          {descriptionProp && (!(isSmall || isInvalidProp) || isDisabled) && (\n            <AriaText\n              className={clsx(styles.description, classNames?.description)}\n              slot='description'\n            >\n              {descriptionProp}\n            </AriaText>\n          )}\n          <FieldError\n            className={composeRenderProps(classNames?.error, (className) =>\n              clsx(styles.error, className),\n            )}\n          >\n            {errorMessage}\n          </FieldError>\n        </>\n      )}\n    </AriaDateField>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAM,SAAS;CACb;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CD,SAAgB,UAA+B,EAC7C,YACA,aAAa,iBACb,cAAc,kBACd,YACA,OAAO,WACP,OAAO,UACP,aAAa,MACb,0BAA0B,MAC1B,YACA,WAAW,eACX,YACA,GAAG,QACiB;CACpB,MAAM,eAAe,oBAAoB;CACzC,MAAM,UAAU,SAAS;AAEzB,QACE,oBAACA;EACC,GAAI;EACJ,WAAW,mBAAmB,YAAY,QAAQ,cAChD,KAAK,oBAAoB,OAAO,OAAO,UAAU,CAClD;EACwB;EACb;EACZ,WAAW,kBAAkB,eAAe,OAAO;EACvC;EACZ,cAAY;EACZ,aAAW;aAGT,EAAE,+BAEF;GACG,CAAC,WAAW,aACX,oBAACC;IACC,WAAW,KAAK,OAAO,OAAO,YAAY,MAAM;IAChD,YAAYC;IACA;cAEX;KACK;GAEV,qBAAC;IAAI,WAAW,KAAK,OAAO,SAAS,YAAY,QAAQ;eACtD,SAAS,YACR,oBAAC,kBACC,oBAAC,aAAW,GACP,EAET,oBAACC;KACC,GAAI;KACJ,WAAW,mBAAmB,YAAY,QAAQ,cAChD,KAAK,OAAO,OAAO,UAAU,CAC9B;gBAEC,gBAAgB;AAEhB,UAAI,YAAY,SAAS,UACvB,QAAO,0CAAG,YAAY,SAAS,MAAM,MAAM,OAAQ;AAGrD,aACE,oBAAC;OACC,WAAW,mBACT,YAAY,UACX,cACC,KACE,OAAO,SACP,YAAY,SAAS,WACnB,cACA,OAAO,YACT,UACD,CACJ;OACD,SAAS;kBAEP,EACA,aACA,MACA,OACA,WACA,oBACI;AACJ,YAAI,cACF,QAAO;AAGT,eAAO,YAAY,SAAS,WAC1B,cACA,CAAC,YACC,QAAQ,SAAS,KAAK,KACtB;;QAEM;;MAGJ;KACZ;GACL,oBAAoB,EAAE,WAAW,kBAAkBD,iBAClD,oBAACE;IACC,WAAW,KAAK,OAAO,aAAa,YAAY,YAAY;IAC5D,MAAK;cAEJ;KACQ;GAEb,oBAAC;IACC,WAAW,mBAAmB,YAAY,QAAQ,cAChD,KAAK,OAAO,OAAO,UAAU,CAC9B;cAEA;KACU;MACZ;GAES"}
+{"version":3,"file":"index.js","names":["AriaDateField","Label","isDisabled","AriaDateInput","AriaText"],"sources":["../../../src/components/date-field/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport Calendar from '@accelint/icons/calendar';\nimport {\n  DateField as AriaDateField,\n  DateInput as AriaDateInput,\n  Text as AriaText,\n  composeRenderProps,\n  DateSegment,\n  FieldError,\n} from 'react-aria-components';\nimport { Icon } from '../icon';\nimport { Label } from '../label';\nimport styles from './styles.module.css';\nimport type { DateValue } from '@internationalized/date';\nimport type { DateFieldProps } from './types';\n\nconst months = [\n  'JAN',\n  'FEB',\n  'MAR',\n  'APR',\n  'MAY',\n  'JUN',\n  'JUL',\n  'AUG',\n  'SEP',\n  'OCT',\n  'NOV',\n  'DEC',\n];\n\n/**\n * DateField - A comprehensive date input component with segmented editing\n *\n * Provides accessible date input functionality with separate segments for day,\n * month, and year. Includes calendar icon, validation states, and international\n * date format support with keyboard navigation between segments.\n *\n * @example\n * // Basic date field\n * <DateField label=\"Birth Date\" />\n *\n * @example\n * // Date field with validation\n * <DateField\n *   label=\"Event Date\"\n *   isRequired\n *   isInvalid={hasError}\n *   errorMessage=\"Please select a valid date\"\n * />\n *\n * @example\n * // Date field with custom formatting\n * <DateField\n *   label=\"Meeting Date\"\n *   shortMonth={false}\n *   placeholder=\"Select meeting date\"\n * />\n *\n * @example\n * // Compact date field\n * <DateField\n *   label=\"Due Date\"\n *   size=\"small\"\n *   description=\"When is this task due?\"\n * />\n *\n * @example\n * // Controlled date field\n * <DateField\n *   label=\"Selected Date\"\n *   value={selectedDate}\n *   onChange={setSelectedDate}\n * />\n */\nexport function DateField<T extends DateValue>({\n  classNames,\n  description: descriptionProp,\n  errorMessage: errorMessageProp,\n  inputProps,\n  label: labelProp,\n  size = 'medium',\n  shortMonth = true,\n  shouldForceLeadingZeros = true,\n  isDisabled,\n  isInvalid: isInvalidProp,\n  isRequired,\n  isReadOnly = false,\n  ...rest\n}: DateFieldProps<T>) {\n  const errorMessage = errorMessageProp || null; // Protect against empty string\n  const isSmall = size === 'small';\n\n  return (\n    <AriaDateField<T>\n      {...rest}\n      className={composeRenderProps(classNames?.field, (className) =>\n        clsx('group/date-field', styles.field, className),\n      )}\n      shouldForceLeadingZeros={shouldForceLeadingZeros}\n      isDisabled={isDisabled}\n      isInvalid={isInvalidProp || (errorMessage ? true : undefined)} // Leave uncontrolled if possible to fallback to validation state\n      isRequired={isRequired}\n      isReadOnly={isReadOnly}\n      aria-label={labelProp}\n      data-size={size}\n    >\n      {(\n        { isDisabled }, // Rely on internal state, not props, since state could differ from props\n      ) => (\n        <>\n          {!isSmall && labelProp && (\n            <Label\n              className={clsx(styles.label, classNames?.label)}\n              isDisabled={isDisabled}\n              isRequired={isRequired}\n            >\n              {labelProp}\n            </Label>\n          )}\n          <div\n            className={clsx(styles.control, classNames?.control)}\n            data-readonly={isReadOnly || null}\n          >\n            {!isReadOnly && size === 'medium' && (\n              <Icon>\n                <Calendar />\n              </Icon>\n            )}\n            <AriaDateInput\n              {...inputProps}\n              className={composeRenderProps(classNames?.input, (className) =>\n                clsx(styles.input, className),\n              )}\n            >\n              {(segmentProp) => {\n                // Remove extra space and punctuation from input display\n                if (segmentProp.type === 'literal') {\n                  return <>{segmentProp.text === ':' ? ':' : null}</>;\n                }\n\n                return (\n                  <DateSegment\n                    className={composeRenderProps(\n                      classNames?.segment,\n                      (className) =>\n                        clsx(\n                          styles.segment,\n                          segmentProp.type === 'month' &&\n                            shortMonth &&\n                            styles.shortMonth,\n                          className,\n                        ),\n                    )}\n                    segment={segmentProp}\n                  >\n                    {({\n                      placeholder,\n                      text,\n                      value,\n                      isFocused,\n                      isPlaceholder,\n                    }) => {\n                      if (isPlaceholder) {\n                        return placeholder;\n                      }\n\n                      return segmentProp.type === 'month' &&\n                        shortMonth &&\n                        !isFocused\n                        ? months[(value ?? 0) - 1]\n                        : text;\n                    }}\n                  </DateSegment>\n                );\n              }}\n            </AriaDateInput>\n          </div>\n          {descriptionProp && (!(isSmall || isInvalidProp) || isDisabled) && (\n            <AriaText\n              className={clsx(styles.description, classNames?.description)}\n              slot='description'\n            >\n              {descriptionProp}\n            </AriaText>\n          )}\n          <FieldError\n            className={composeRenderProps(classNames?.error, (className) =>\n              clsx(styles.error, className),\n            )}\n          >\n            {errorMessage}\n          </FieldError>\n        </>\n      )}\n    </AriaDateField>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAM,SAAS;CACb;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CD,SAAgB,UAA+B,EAC7C,YACA,aAAa,iBACb,cAAc,kBACd,YACA,OAAO,WACP,OAAO,UACP,aAAa,MACb,0BAA0B,MAC1B,YACA,WAAW,eACX,YACA,aAAa,OACb,GAAG,QACiB;CACpB,MAAM,eAAe,oBAAoB;CACzC,MAAM,UAAU,SAAS;AAEzB,QACE,oBAACA;EACC,GAAI;EACJ,WAAW,mBAAmB,YAAY,QAAQ,cAChD,KAAK,oBAAoB,OAAO,OAAO,UAAU,CAClD;EACwB;EACb;EACZ,WAAW,kBAAkB,eAAe,OAAO;EACvC;EACA;EACZ,cAAY;EACZ,aAAW;aAGT,EAAE,+BAEF;GACG,CAAC,WAAW,aACX,oBAACC;IACC,WAAW,KAAK,OAAO,OAAO,YAAY,MAAM;IAChD,YAAYC;IACA;cAEX;KACK;GAEV,qBAAC;IACC,WAAW,KAAK,OAAO,SAAS,YAAY,QAAQ;IACpD,iBAAe,cAAc;eAE5B,CAAC,cAAc,SAAS,YACvB,oBAAC,kBACC,oBAAC,aAAW,GACP,EAET,oBAACC;KACC,GAAI;KACJ,WAAW,mBAAmB,YAAY,QAAQ,cAChD,KAAK,OAAO,OAAO,UAAU,CAC9B;gBAEC,gBAAgB;AAEhB,UAAI,YAAY,SAAS,UACvB,QAAO,0CAAG,YAAY,SAAS,MAAM,MAAM,OAAQ;AAGrD,aACE,oBAAC;OACC,WAAW,mBACT,YAAY,UACX,cACC,KACE,OAAO,SACP,YAAY,SAAS,WACnB,cACA,OAAO,YACT,UACD,CACJ;OACD,SAAS;kBAEP,EACA,aACA,MACA,OACA,WACA,oBACI;AACJ,YAAI,cACF,QAAO;AAGT,eAAO,YAAY,SAAS,WAC1B,cACA,CAAC,YACC,QAAQ,SAAS,KAAK,KACtB;;QAEM;;MAGJ;KACZ;GACL,oBAAoB,EAAE,WAAW,kBAAkBD,iBAClD,oBAACE;IACC,WAAW,KAAK,OAAO,aAAa,YAAY,YAAY;IAC5D,MAAK;cAEJ;KACQ;GAEb,oBAAC;IACC,WAAW,mBAAmB,YAAY,QAAQ,cAChD,KAAK,OAAO,OAAO,UAAU,CAC9B;cAEA;KACU;MACZ;GAES"}

package/dist/components/date-field/styles.module.css

@@ -43,6 +43,10 @@
     @variant group-disabled/date-field {
       @apply fg-disabled outline-interactive-disabled;
     }
+
+    @variant read-only {
+      @apply px-0 outline-none;
+    }
   }
 
   .input {

package/dist/components/deferred-collection/index.d.ts

@@ -0,0 +1,43 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import { DeferredCollectionProps } from "./types.js";
+import * as react_jsx_runtime74 from "react/jsx-runtime";
+
+//#region src/components/deferred-collection/index.d.ts
+
+/**
+ * DeferredCollection - Defers rendering of large collections to prevent UI freezes.
+ *
+ * React Aria's collection system processes ALL items synchronously before
+ * virtualization begins. This component defers the collection render by a few
+ * animation frames, allowing a fallback to display first.
+ *
+ * @example
+ * <DeferredCollection fallback={<LoadingState />}>
+ *   {() => (
+ *     <Virtualizer>
+ *       <ListBox items={items}>
+ *         {(item) => <ListBoxItem>{item.name}</ListBoxItem>}
+ *       </ListBox>
+ *     </Virtualizer>
+ *   )}
+ * </DeferredCollection>
+ */
+declare function DeferredCollection({
+  children,
+  fallback,
+  deferFrames
+}: DeferredCollectionProps): react_jsx_runtime74.JSX.Element;
+//#endregion
+export { DeferredCollection, type DeferredCollectionProps };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/deferred-collection/index.js

@@ -0,0 +1,44 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+import { useFrameDelay } from "../../hooks/use-frame-delay/index.js";
+import { Fragment, jsx } from "react/jsx-runtime";
+
+//#region src/components/deferred-collection/index.tsx
+/**
+* DeferredCollection - Defers rendering of large collections to prevent UI freezes.
+*
+* React Aria's collection system processes ALL items synchronously before
+* virtualization begins. This component defers the collection render by a few
+* animation frames, allowing a fallback to display first.
+*
+* @example
+* <DeferredCollection fallback={<LoadingState />}>
+*   {() => (
+*     <Virtualizer>
+*       <ListBox items={items}>
+*         {(item) => <ListBoxItem>{item.name}</ListBoxItem>}
+*       </ListBox>
+*     </Virtualizer>
+*   )}
+* </DeferredCollection>
+*/
+function DeferredCollection({ children, fallback, deferFrames }) {
+	const { isReady } = useFrameDelay({ frames: deferFrames });
+	if (isReady) return /* @__PURE__ */ jsx(Fragment, { children: typeof children === "function" ? children() : children });
+	return /* @__PURE__ */ jsx(Fragment, { children: fallback });
+}
+
+//#endregion
+export { DeferredCollection };
+//# sourceMappingURL=index.js.map

package/dist/components/deferred-collection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/deferred-collection/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { useFrameDelay } from '../../hooks/use-frame-delay';\nimport type { DeferredCollectionProps } from './types';\n\n/**\n * DeferredCollection - Defers rendering of large collections to prevent UI freezes.\n *\n * React Aria's collection system processes ALL items synchronously before\n * virtualization begins. This component defers the collection render by a few\n * animation frames, allowing a fallback to display first.\n *\n * @example\n * <DeferredCollection fallback={<LoadingState />}>\n *   {() => (\n *     <Virtualizer>\n *       <ListBox items={items}>\n *         {(item) => <ListBoxItem>{item.name}</ListBoxItem>}\n *       </ListBox>\n *     </Virtualizer>\n *   )}\n * </DeferredCollection>\n */\nexport function DeferredCollection({\n  children,\n  fallback,\n  deferFrames,\n}: DeferredCollectionProps) {\n  const { isReady } = useFrameDelay({ frames: deferFrames });\n\n  if (isReady) {\n    return <>{typeof children === 'function' ? children() : children}</>;\n  }\n\n  return <>{fallback}</>;\n}\n\nexport type { DeferredCollectionProps } from './types';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,mBAAmB,EACjC,UACA,UACA,eAC0B;CAC1B,MAAM,EAAE,YAAY,cAAc,EAAE,QAAQ,aAAa,CAAC;AAE1D,KAAI,QACF,QAAO,0CAAG,OAAO,aAAa,aAAa,UAAU,GAAG,WAAY;AAGtE,QAAO,0CAAG,WAAY"}

package/dist/components/deferred-collection/types.d.ts

@@ -0,0 +1,26 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import { ReactNode } from "react";
+
+//#region src/components/deferred-collection/types.d.ts
+interface DeferredCollectionProps {
+  /** The content to render once ready - can be ReactNode or a function returning ReactNode for deferred creation */
+  children: ReactNode | (() => ReactNode);
+  /** Fallback element to show while deferring render */
+  fallback?: ReactNode;
+  /** Number of animation frames to defer before rendering (default: 2) */
+  deferFrames?: number;
+}
+//#endregion
+export { DeferredCollectionProps };
+//# sourceMappingURL=types.d.ts.map

package/dist/components/deferred-collection/types.js

@@ -0,0 +1,12 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+

package/dist/components/details-list/context.d.ts

@@ -13,16 +13,16 @@
 import { ProviderProps } from "../../lib/types.js";
 import { DetailsListProps } from "./types.js";
 import "client-only";
-import * as react14 from "react";
+import * as react26 from "react";
 import { ContextValue } from "react-aria-components";
-import * as react_jsx_runtime36 from "react/jsx-runtime";
+import * as react_jsx_runtime77 from "react/jsx-runtime";
 
 //#region src/components/details-list/context.d.ts
-declare const DetailsListContext: react14.Context<ContextValue<DetailsListProps, HTMLDListElement>>;
+declare const DetailsListContext: react26.Context<ContextValue<DetailsListProps, HTMLDListElement>>;
 declare function DetailsListProvider({
   children,
   ...props
-}: ProviderProps<DetailsListProps>): react_jsx_runtime36.JSX.Element;
+}: ProviderProps<DetailsListProps>): react_jsx_runtime77.JSX.Element;
 //#endregion
 export { DetailsListContext, DetailsListProvider };
 //# sourceMappingURL=context.d.ts.map

package/dist/components/details-list/index.d.ts

@@ -12,7 +12,7 @@
 
 import { DetailsListProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime38 from "react/jsx-runtime";
+import * as react_jsx_runtime79 from "react/jsx-runtime";
 
 //#region src/components/details-list/index.d.ts
 
@@ -48,7 +48,7 @@ import * as react_jsx_runtime38 from "react/jsx-runtime";
 declare function DetailsList({
   ref,
   ...props
-}: DetailsListProps): react_jsx_runtime38.JSX.Element;
+}: DetailsListProps): react_jsx_runtime79.JSX.Element;
 //#endregion
 export { DetailsList };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/details-list/label.d.ts

@@ -12,10 +12,10 @@
 
 import { DetailsListLabelProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime37 from "react/jsx-runtime";
+import * as react_jsx_runtime81 from "react/jsx-runtime";
 
 //#region src/components/details-list/label.d.ts
-declare function DetailsListLabel(props: DetailsListLabelProps): react_jsx_runtime37.JSX.Element;
+declare function DetailsListLabel(props: DetailsListLabelProps): react_jsx_runtime81.JSX.Element;
 //#endregion
 export { DetailsListLabel };
 //# sourceMappingURL=label.d.ts.map

package/dist/components/details-list/value.d.ts

@@ -12,10 +12,10 @@
 
 import { DetailsListValueProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime39 from "react/jsx-runtime";
+import * as react_jsx_runtime33 from "react/jsx-runtime";
 
 //#region src/components/details-list/value.d.ts
-declare function DetailsListValue(props: DetailsListValueProps): react_jsx_runtime39.JSX.Element;
+declare function DetailsListValue(props: DetailsListValueProps): react_jsx_runtime33.JSX.Element;
 //#endregion
 export { DetailsListValue };
 //# sourceMappingURL=value.d.ts.map

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

@@ -12,13 +12,13 @@
 
 import "client-only";
 import { ComponentProps } from "react";
-import * as react_jsx_runtime40 from "react/jsx-runtime";
+import * as react_jsx_runtime35 from "react/jsx-runtime";
 
 //#region src/components/dialog/content.d.ts
 declare function DialogContent({
   children,
   className
-}: ComponentProps<'div'>): react_jsx_runtime40.JSX.Element;
+}: ComponentProps<'div'>): react_jsx_runtime35.JSX.Element;
 //#endregion
 export { DialogContent };
 //# sourceMappingURL=content.d.ts.map

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

@@ -12,11 +12,11 @@
 
 import { DialogProps as DialogProps$1 } from "./types.js";
 import "client-only";
-import * as react15 from "react";
+import * as react13 from "react";
 import { ContextValue } from "react-aria-components";
 
 //#region src/components/dialog/context.d.ts
-declare const DialogContext: react15.Context<ContextValue<DialogProps$1, HTMLDivElement>>;
+declare const DialogContext: react13.Context<ContextValue<DialogProps$1, HTMLDivElement>>;
 //#endregion
 export { DialogContext };
 //# sourceMappingURL=context.d.ts.map

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

@@ -12,13 +12,13 @@
 
 import "client-only";
 import { ComponentProps } from "react";
-import * as react_jsx_runtime42 from "react/jsx-runtime";
+import * as react_jsx_runtime37 from "react/jsx-runtime";
 
 //#region src/components/dialog/footer.d.ts
 declare function DialogFooter({
   children,
   className
-}: ComponentProps<'footer'>): react_jsx_runtime42.JSX.Element;
+}: ComponentProps<'footer'>): react_jsx_runtime37.JSX.Element;
 //#endregion
 export { DialogFooter };
 //# sourceMappingURL=footer.d.ts.map

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

@@ -12,7 +12,7 @@
 
 import { DialogProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime41 from "react/jsx-runtime";
+import * as react_jsx_runtime44 from "react/jsx-runtime";
 
 //#region src/components/dialog/index.d.ts
 
@@ -43,7 +43,7 @@ import * as react_jsx_runtime41 from "react/jsx-runtime";
 declare function Dialog({
   ref,
   ...props
-}: DialogProps): react_jsx_runtime41.JSX.Element;
+}: DialogProps): react_jsx_runtime44.JSX.Element;
 //#endregion
 export { Dialog };
 //# sourceMappingURL=index.d.ts.map

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

@@ -12,13 +12,13 @@
 
 import "client-only";
 import { HeadingProps } from "react-aria-components";
-import * as react_jsx_runtime43 from "react/jsx-runtime";
+import * as react_jsx_runtime47 from "react/jsx-runtime";
 
 //#region src/components/dialog/title.d.ts
 declare function DialogTitle({
   children,
   className
-}: HeadingProps): react_jsx_runtime43.JSX.Element;
+}: HeadingProps): react_jsx_runtime47.JSX.Element;
 //#endregion
 export { DialogTitle };
 //# sourceMappingURL=title.d.ts.map

package/dist/components/divider/context.d.ts

@@ -13,16 +13,16 @@
 import { ProviderProps } from "../../lib/types.js";
 import { DividerProps } from "./types.js";
 import "client-only";
-import * as react16 from "react";
+import * as react15 from "react";
 import { ContextValue } from "react-aria-components";
-import * as react_jsx_runtime44 from "react/jsx-runtime";
+import * as react_jsx_runtime45 from "react/jsx-runtime";
 
 //#region src/components/divider/context.d.ts
-declare const DividerContext: react16.Context<ContextValue<DividerProps, HTMLHRElement>>;
+declare const DividerContext: react15.Context<ContextValue<DividerProps, HTMLHRElement>>;
 declare function DividerProvider({
   children,
   ...props
-}: ProviderProps<DividerProps>): react_jsx_runtime44.JSX.Element;
+}: ProviderProps<DividerProps>): react_jsx_runtime45.JSX.Element;
 //#endregion
 export { DividerContext, DividerProvider };
 //# sourceMappingURL=context.d.ts.map

package/dist/components/drawer/back.d.ts

@@ -11,10 +11,10 @@
  */
 
 import "client-only";
-import * as react_jsx_runtime48 from "react/jsx-runtime";
+import * as react_jsx_runtime49 from "react/jsx-runtime";
 
 //#region src/components/drawer/back.d.ts
-declare function DrawerBack(): react_jsx_runtime48.JSX.Element | null;
+declare function DrawerBack(): react_jsx_runtime49.JSX.Element | null;
 //#endregion
 export { DrawerBack };
 //# sourceMappingURL=back.d.ts.map

package/dist/components/drawer/close.d.ts

@@ -11,10 +11,10 @@
  */
 
 import "client-only";
-import * as react_jsx_runtime50 from "react/jsx-runtime";
+import * as react_jsx_runtime67 from "react/jsx-runtime";
 
 //#region src/components/drawer/close.d.ts
-declare function DrawerClose(): react_jsx_runtime50.JSX.Element;
+declare function DrawerClose(): react_jsx_runtime67.JSX.Element;
 //#endregion
 export { DrawerClose };
 //# sourceMappingURL=close.d.ts.map

package/dist/components/drawer/content.d.ts

@@ -11,13 +11,13 @@
  */
 
 import { ComponentPropsWithRef } from "react";
-import * as react_jsx_runtime120 from "react/jsx-runtime";
+import * as react_jsx_runtime68 from "react/jsx-runtime";
 
 //#region src/components/drawer/content.d.ts
 declare function DrawerContent({
   className,
   ...rest
-}: ComponentPropsWithRef<'div'>): react_jsx_runtime120.JSX.Element;
+}: ComponentPropsWithRef<'div'>): react_jsx_runtime68.JSX.Element;
 //#endregion
 export { DrawerContent };
 //# sourceMappingURL=content.d.ts.map

package/dist/components/drawer/context.d.ts

@@ -12,12 +12,12 @@
 
 import { DrawerContextValue, DrawerEvent } from "./types.js";
 import "client-only";
-import * as react36 from "react";
+import * as react25 from "react";
 import { Broadcast } from "@accelint/bus";
 import { UniqueId } from "@accelint/core";
 
 //#region src/components/drawer/context.d.ts
-declare const DrawerContext: react36.Context<DrawerContextValue>;
+declare const DrawerContext: react25.Context<DrawerContextValue>;
 declare const bus: Broadcast<DrawerEvent>;
 declare const DrawerEventHandlers: {
   readonly close: (stack: UniqueId) => void;

package/dist/components/drawer/footer.d.ts

@@ -11,13 +11,13 @@
  */
 
 import { ComponentPropsWithRef } from "react";
-import * as react_jsx_runtime143 from "react/jsx-runtime";
+import * as react_jsx_runtime70 from "react/jsx-runtime";
 
 //#region src/components/drawer/footer.d.ts
 declare function DrawerFooter({
   className,
   ...rest
-}: ComponentPropsWithRef<'footer'>): react_jsx_runtime143.JSX.Element;
+}: ComponentPropsWithRef<'footer'>): react_jsx_runtime70.JSX.Element;
 //#endregion
 export { DrawerFooter };
 //# sourceMappingURL=footer.d.ts.map

package/dist/components/drawer/header-title.d.ts

@@ -11,7 +11,7 @@
  */
 
 import { DrawerTitleProps } from "./types.js";
-import * as react_jsx_runtime144 from "react/jsx-runtime";
+import * as react_jsx_runtime72 from "react/jsx-runtime";
 
 //#region src/components/drawer/header-title.d.ts
 /**
@@ -23,7 +23,7 @@ declare function DrawerHeaderTitle({
   className,
   level,
   ...rest
-}: DrawerTitleProps): react_jsx_runtime144.JSX.Element;
+}: DrawerTitleProps): react_jsx_runtime72.JSX.Element;
 //#endregion
 export { DrawerHeaderTitle };
 //# sourceMappingURL=header-title.d.ts.map

package/dist/components/drawer/header.d.ts

@@ -12,7 +12,7 @@
 
 import "client-only";
 import { ComponentPropsWithRef } from "react";
-import * as react_jsx_runtime164 from "react/jsx-runtime";
+import * as react_jsx_runtime73 from "react/jsx-runtime";
 
 //#region src/components/drawer/header.d.ts
 declare function DrawerHeader({
@@ -20,7 +20,7 @@ declare function DrawerHeader({
   title,
   children,
   ...rest
-}: ComponentPropsWithRef<'header'>): react_jsx_runtime164.JSX.Element;
+}: ComponentPropsWithRef<'header'>): react_jsx_runtime73.JSX.Element;
 //#endregion
 export { DrawerHeader };
 //# sourceMappingURL=header.d.ts.map

package/dist/components/drawer/index.d.ts

@@ -12,7 +12,7 @@
 
 import { DrawerProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime52 from "react/jsx-runtime";
+import * as react_jsx_runtime75 from "react/jsx-runtime";
 
 //#region src/components/drawer/index.d.ts
 
@@ -51,7 +51,7 @@ declare function Drawer({
   size,
   onChange,
   ...rest
-}: DrawerProps): react_jsx_runtime52.JSX.Element;
+}: DrawerProps): react_jsx_runtime75.JSX.Element;
 //#endregion
 export { Drawer };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/drawer/layout-main.d.ts

@@ -11,13 +11,13 @@
  */
 
 import { ComponentPropsWithRef } from "react";
-import * as react_jsx_runtime81 from "react/jsx-runtime";
+import * as react_jsx_runtime76 from "react/jsx-runtime";
 
 //#region src/components/drawer/layout-main.d.ts
 declare function DrawerLayoutMain({
   className,
   ...rest
-}: ComponentPropsWithRef<'main'>): react_jsx_runtime81.JSX.Element;
+}: ComponentPropsWithRef<'main'>): react_jsx_runtime76.JSX.Element;
 //#endregion
 export { DrawerLayoutMain };
 //# sourceMappingURL=layout-main.d.ts.map

package/dist/components/drawer/layout.d.ts

@@ -11,7 +11,7 @@
  */
 
 import { DrawerLayoutProps } from "./types.js";
-import * as react_jsx_runtime59 from "react/jsx-runtime";
+import * as react_jsx_runtime78 from "react/jsx-runtime";
 
 //#region src/components/drawer/layout.d.ts
 declare function DrawerLayout({
@@ -19,7 +19,7 @@ declare function DrawerLayout({
   extend,
   push,
   ...rest
-}: DrawerLayoutProps): react_jsx_runtime59.JSX.Element;
+}: DrawerLayoutProps): react_jsx_runtime78.JSX.Element;
 //#endregion
 export { DrawerLayout };
 //# sourceMappingURL=layout.d.ts.map

package/dist/components/drawer/menu-item.d.ts

@@ -12,7 +12,7 @@
 
 import { DrawerMenuItemProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime60 from "react/jsx-runtime";
+import * as react_jsx_runtime80 from "react/jsx-runtime";
 
 //#region src/components/drawer/menu-item.d.ts
 declare function DrawerMenuItem({
@@ -22,7 +22,7 @@ declare function DrawerMenuItem({
   toggle,
   textValue,
   ...rest
-}: DrawerMenuItemProps): react_jsx_runtime60.JSX.Element | null;
+}: DrawerMenuItemProps): react_jsx_runtime80.JSX.Element | null;
 //#endregion
 export { DrawerMenuItem };
 //# sourceMappingURL=menu-item.d.ts.map

package/dist/components/drawer/menu.d.ts

@@ -11,7 +11,7 @@
  */
 
 import { DrawerMenuProps } from "./types.js";
-import * as react_jsx_runtime61 from "react/jsx-runtime";
+import * as react_jsx_runtime83 from "react/jsx-runtime";
 
 //#region src/components/drawer/menu.d.ts
 declare function DrawerMenu({
@@ -19,7 +19,7 @@ declare function DrawerMenu({
   position,
   children,
   ...rest
-}: DrawerMenuProps): react_jsx_runtime61.JSX.Element;
+}: DrawerMenuProps): react_jsx_runtime83.JSX.Element;
 //#endregion
 export { DrawerMenu };
 //# sourceMappingURL=menu.d.ts.map

package/dist/components/drawer/panel.d.ts

@@ -11,13 +11,13 @@
  */
 
 import { ComponentPropsWithRef } from "react";
-import * as react_jsx_runtime47 from "react/jsx-runtime";
+import * as react_jsx_runtime32 from "react/jsx-runtime";
 
 //#region src/components/drawer/panel.d.ts
 declare function DrawerPanel({
   className,
   ...rest
-}: ComponentPropsWithRef<'div'>): react_jsx_runtime47.JSX.Element;
+}: ComponentPropsWithRef<'div'>): react_jsx_runtime32.JSX.Element;
 //#endregion
 export { DrawerPanel };
 //# sourceMappingURL=panel.d.ts.map

package/dist/components/drawer/styles.module.css

@@ -187,7 +187,7 @@
 
     &.end {
       @variant group-placement-top/drawer {
-        @apply right-xl;
+        @apply right-xl left-auto;
       }
 
       @variant group-placement-right/drawer {
@@ -195,7 +195,7 @@
       }
 
       @variant group-placement-bottom/drawer {
-        @apply right-xl;
+        @apply right-xl left-auto;
       }
 
       @variant group-placement-left/drawer {