@accelint/design-toolkit 9.1.1 → 9.3.0

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

@@ -12,7 +12,7 @@
 
 import { ClockProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime27 from "react/jsx-runtime";
+import * as react_jsx_runtime31 from "react/jsx-runtime";
 
 //#region src/components/clock/index.d.ts
 
@@ -48,7 +48,7 @@ import * as react_jsx_runtime27 from "react/jsx-runtime";
 declare function Clock({
   formatter,
   ...rest
-}: ClockProps): react_jsx_runtime27.JSX.Element;
+}: ClockProps): react_jsx_runtime31.JSX.Element;
 //#endregion
 export { Clock };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/color-picker/index.d.ts

@@ -12,7 +12,7 @@
 
 import { ColorPickerProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime29 from "react/jsx-runtime";
+import * as react_jsx_runtime25 from "react/jsx-runtime";
 
 //#region src/components/color-picker/index.d.ts
 
@@ -60,7 +60,7 @@ declare function ColorPicker({
   classNames,
   items,
   ...rest
-}: ColorPickerProps): react_jsx_runtime29.JSX.Element;
+}: ColorPickerProps): react_jsx_runtime25.JSX.Element;
 //#endregion
 export { ColorPicker };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/combobox-field/context.d.ts

@@ -14,16 +14,16 @@ import { ProviderProps } from "../../lib/types.js";
 import { OptionsDataItem } from "../options/types.js";
 import { ComboBoxFieldProps } from "./types.js";
 import "client-only";
-import * as react11 from "react";
+import * as react7 from "react";
 import { ContextValue } from "react-aria-components";
-import * as react_jsx_runtime28 from "react/jsx-runtime";
+import * as react_jsx_runtime20 from "react/jsx-runtime";
 
 //#region src/components/combobox-field/context.d.ts
-declare const ComboBoxFieldContext: react11.Context<ContextValue<ComboBoxFieldProps<any>, HTMLDivElement>>;
+declare const ComboBoxFieldContext: react7.Context<ContextValue<ComboBoxFieldProps<any>, HTMLDivElement>>;
 declare function ComboBoxFieldProvider<T extends OptionsDataItem>({
   children,
   ...props
-}: ProviderProps<ComboBoxFieldProps<T>>): react_jsx_runtime28.JSX.Element;
+}: ProviderProps<ComboBoxFieldProps<T>>): react_jsx_runtime20.JSX.Element;
 //#endregion
 export { ComboBoxFieldContext, ComboBoxFieldProvider };
 //# sourceMappingURL=context.d.ts.map

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

@@ -38,7 +38,7 @@ import styles from "./styles.module.css";
 */
 function ComboBoxField({ ref, ...props }) {
 	[props, ref] = useContextProps(props, ref ?? null, ComboBoxFieldContext);
-	const { children, classNames, description: descriptionProp, errorMessage: errorMessageProp, inputProps, label: labelProp, layoutOptions, menuTrigger = "focus", size = "medium", isInvalid: isInvalidProp, ...rest } = props;
+	const { children, classNames, description: descriptionProp, errorMessage: errorMessageProp, inputProps, label: labelProp, layoutOptions, menuTrigger = "focus", size = "medium", isInvalid: isInvalidProp, isReadOnly = false, ...rest } = props;
 	const errorMessage = errorMessageProp || null;
 	const isSmall = size === "small";
 	return /* @__PURE__ */ jsx(ComboBox, {
@@ -47,45 +47,52 @@ function ComboBoxField({ ref, ...props }) {
 		className: composeRenderProps(classNames?.field, (className) => clsx("group/combobox-field", styles.field, className)),
 		menuTrigger,
 		isInvalid: isInvalidProp || (errorMessage ? true : void 0),
+		isReadOnly,
 		"data-size": size,
-		children: ({ isDisabled, isInvalid, isRequired }) => /* @__PURE__ */ jsxs(Fragment, { children: [
-			!!labelProp && !isSmall && /* @__PURE__ */ jsx(Label$1, {
-				className: clsx(styles.label, classNames?.label),
-				isDisabled,
-				isRequired,
-				children: labelProp
-			}),
-			/* @__PURE__ */ jsxs("div", {
-				className: clsx(styles.control, classNames?.control),
-				children: [/* @__PURE__ */ jsx(Input, {
-					...inputProps,
-					className: composeRenderProps(classNames?.input, (className) => clsx(styles.input, className))
-				}), /* @__PURE__ */ jsx(Button, {
-					className: composeRenderProps(classNames?.trigger, (className) => clsx(styles.trigger, className)),
-					children: /* @__PURE__ */ jsx(Icon, {
-						size: "small",
-						children: /* @__PURE__ */ jsx(ChevronDown, {})
+		children: ({ isDisabled, isInvalid, isRequired }) => {
+			const shouldShowDescription = !isReadOnly && !!descriptionProp && !(isSmall || isInvalid);
+			return /* @__PURE__ */ jsxs(Fragment, { children: [
+				!!labelProp && !isSmall && /* @__PURE__ */ jsx(Label$1, {
+					className: clsx(styles.label, classNames?.label),
+					isDisabled,
+					isRequired,
+					children: labelProp
+				}),
+				/* @__PURE__ */ jsxs("div", {
+					className: clsx(styles.control, classNames?.control),
+					"data-readonly": isReadOnly || null,
+					children: [/* @__PURE__ */ jsx(Input, {
+						...inputProps,
+						tabIndex: isReadOnly ? -1 : 0,
+						className: composeRenderProps(classNames?.input, (className) => clsx(styles.input, className)),
+						title: inputProps?.value ? String(inputProps?.value) : ""
+					}), !isReadOnly && /* @__PURE__ */ jsx(Button, {
+						className: composeRenderProps(classNames?.trigger, (className) => clsx(styles.trigger, className)),
+						children: /* @__PURE__ */ jsx(Icon, {
+							size: "small",
+							children: /* @__PURE__ */ jsx(ChevronDown, {})
+						})
+					})]
+				}),
+				shouldShowDescription && /* @__PURE__ */ jsx(Text, {
+					className: clsx(styles.description, classNames?.description),
+					slot: "description",
+					children: descriptionProp
+				}),
+				/* @__PURE__ */ jsx(FieldError, {
+					className: composeRenderProps(classNames?.error, (className) => clsx(styles.error, className)),
+					children: errorMessage
+				}),
+				/* @__PURE__ */ jsx(Popover, {
+					className: composeRenderProps(classNames?.popover, (className) => clsx(styles.popover, className)),
+					children: /* @__PURE__ */ jsx(Virtualizer, {
+						layout: ListLayout,
+						layoutOptions,
+						children: /* @__PURE__ */ jsx(Options, { children })
 					})
-				})]
-			}),
-			!!descriptionProp && !(isSmall || isInvalid) && /* @__PURE__ */ jsx(Text, {
-				className: clsx(styles.description, classNames?.description),
-				slot: "description",
-				children: descriptionProp
-			}),
-			/* @__PURE__ */ jsx(FieldError, {
-				className: composeRenderProps(classNames?.error, (className) => clsx(styles.error, className)),
-				children: errorMessage
-			}),
-			/* @__PURE__ */ jsx(Popover, {
-				className: composeRenderProps(classNames?.popover, (className) => clsx(styles.popover, className)),
-				children: /* @__PURE__ */ jsx(Virtualizer, {
-					layout: ListLayout,
-					layoutOptions,
-					children: /* @__PURE__ */ jsx(Options, { children })
 				})
-			})
-		] })
+			] });
+		}
 	});
 }
 

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["Label"],"sources":["../../../src/components/combobox-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'use client';\n\nimport { ChevronDown } from '@accelint/icons';\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport {\n  Button,\n  ComboBox,\n  composeRenderProps,\n  FieldError,\n  Input,\n  ListLayout,\n  Popover,\n  Text,\n  useContextProps,\n  Virtualizer,\n} from 'react-aria-components';\nimport { Icon } from '../icon';\nimport { Label } from '../label';\nimport { Options } from '../options';\nimport { ComboBoxFieldContext } from './context';\nimport styles from './styles.module.css';\nimport type { OptionsDataItem } from '../options/types';\nimport type { ComboBoxFieldProps } from './types';\n\n/**\n * ComboBoxField - Accessible searchable combobox with dropdown options\n *\n * A combobox field that provides a searchable input with virtualized dropdown\n * options and support for sections, icons, and rich content.\n *\n * @example\n * <ComboBoxField defaultItems={items}>\n *   {(item) => <OptionsItem key={item.id} textValue={item.name}>{item.name}</OptionsItem>}\n * </ComboBoxField>\n */\nexport function ComboBoxField<T extends OptionsDataItem>({\n  ref,\n  ...props\n}: ComboBoxFieldProps<T>) {\n  [props, ref] = useContextProps(props, ref ?? null, ComboBoxFieldContext);\n\n  const {\n    children,\n    classNames,\n    description: descriptionProp,\n    errorMessage: errorMessageProp,\n    inputProps,\n    label: labelProp,\n    layoutOptions,\n    menuTrigger = 'focus',\n    size = 'medium',\n    isInvalid: isInvalidProp,\n    ...rest\n  } = props;\n  const errorMessage = errorMessageProp || null; // Protect against empty string\n  const isSmall = size === 'small';\n\n  return (\n    <ComboBox<T>\n      {...rest}\n      ref={ref}\n      className={composeRenderProps(classNames?.field, (className) =>\n        clsx('group/combobox-field', styles.field, className),\n      )}\n      menuTrigger={menuTrigger}\n      isInvalid={isInvalidProp || (errorMessage ? true : undefined)} // Leave uncontrolled if possible to fallback to validation state\n      data-size={size}\n    >\n      {(\n        { isDisabled, isInvalid, isRequired }, // Rely on internal state, not props, since state could differ from props\n      ) => (\n        <>\n          {!!labelProp && !isSmall && (\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            <Input\n              {...inputProps}\n              className={composeRenderProps(classNames?.input, (className) =>\n                clsx(styles.input, className),\n              )}\n            />\n            <Button\n              className={composeRenderProps(classNames?.trigger, (className) =>\n                clsx(styles.trigger, className),\n              )}\n            >\n              <Icon size='small'>\n                <ChevronDown />\n              </Icon>\n            </Button>\n          </div>\n          {!!descriptionProp && !(isSmall || isInvalid) && (\n            <Text\n              className={clsx(styles.description, classNames?.description)}\n              slot='description'\n            >\n              {descriptionProp}\n            </Text>\n          )}\n          <FieldError\n            className={composeRenderProps(classNames?.error, (className) =>\n              clsx(styles.error, className),\n            )}\n          >\n            {errorMessage}\n          </FieldError>\n          <Popover\n            className={composeRenderProps(classNames?.popover, (className) =>\n              clsx(styles.popover, className),\n            )}\n          >\n            <Virtualizer layout={ListLayout} layoutOptions={layoutOptions}>\n              <Options>{children}</Options>\n            </Virtualizer>\n          </Popover>\n        </>\n      )}\n    </ComboBox>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,SAAgB,cAAyC,EACvD,KACA,GAAG,SACqB;AACxB,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,qBAAqB;CAExE,MAAM,EACJ,UACA,YACA,aAAa,iBACb,cAAc,kBACd,YACA,OAAO,WACP,eACA,cAAc,SACd,OAAO,UACP,WAAW,eACX,GAAG,SACD;CACJ,MAAM,eAAe,oBAAoB;CACzC,MAAM,UAAU,SAAS;AAEzB,QACE,oBAAC;EACC,GAAI;EACC;EACL,WAAW,mBAAmB,YAAY,QAAQ,cAChD,KAAK,wBAAwB,OAAO,OAAO,UAAU,CACtD;EACY;EACb,WAAW,kBAAkB,eAAe,OAAO;EACnD,aAAW;aAGT,EAAE,YAAY,WAAW,iBAEzB;GACG,CAAC,CAAC,aAAa,CAAC,WACf,oBAACA;IACC,WAAW,KAAK,OAAO,OAAO,YAAY,MAAM;IACpC;IACA;cAEX;KACK;GAEV,qBAAC;IAAI,WAAW,KAAK,OAAO,SAAS,YAAY,QAAQ;eACvD,oBAAC;KACC,GAAI;KACJ,WAAW,mBAAmB,YAAY,QAAQ,cAChD,KAAK,OAAO,OAAO,UAAU,CAC9B;MACD,EACF,oBAAC;KACC,WAAW,mBAAmB,YAAY,UAAU,cAClD,KAAK,OAAO,SAAS,UAAU,CAChC;eAED,oBAAC;MAAK,MAAK;gBACT,oBAAC,gBAAc;OACV;MACA;KACL;GACL,CAAC,CAAC,mBAAmB,EAAE,WAAW,cACjC,oBAAC;IACC,WAAW,KAAK,OAAO,aAAa,YAAY,YAAY;IAC5D,MAAK;cAEJ;KACI;GAET,oBAAC;IACC,WAAW,mBAAmB,YAAY,QAAQ,cAChD,KAAK,OAAO,OAAO,UAAU,CAC9B;cAEA;KACU;GACb,oBAAC;IACC,WAAW,mBAAmB,YAAY,UAAU,cAClD,KAAK,OAAO,SAAS,UAAU,CAChC;cAED,oBAAC;KAAY,QAAQ;KAA2B;eAC9C,oBAAC,WAAS,WAAmB;MACjB;KACN;MACT;GAEI"}
+{"version":3,"file":"index.js","names":["Label"],"sources":["../../../src/components/combobox-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'use client';\n\nimport { ChevronDown } from '@accelint/icons';\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport {\n  Button,\n  ComboBox,\n  composeRenderProps,\n  FieldError,\n  Input,\n  ListLayout,\n  Popover,\n  Text,\n  useContextProps,\n  Virtualizer,\n} from 'react-aria-components';\nimport { Icon } from '../icon';\nimport { Label } from '../label';\nimport { Options } from '../options';\nimport { ComboBoxFieldContext } from './context';\nimport styles from './styles.module.css';\nimport type { OptionsDataItem } from '../options/types';\nimport type { ComboBoxFieldProps } from './types';\n\n/**\n * ComboBoxField - Accessible searchable combobox with dropdown options\n *\n * A combobox field that provides a searchable input with virtualized dropdown\n * options and support for sections, icons, and rich content.\n *\n * @example\n * <ComboBoxField defaultItems={items}>\n *   {(item) => <OptionsItem key={item.id} textValue={item.name}>{item.name}</OptionsItem>}\n * </ComboBoxField>\n */\nexport function ComboBoxField<T extends OptionsDataItem>({\n  ref,\n  ...props\n}: ComboBoxFieldProps<T>) {\n  [props, ref] = useContextProps(props, ref ?? null, ComboBoxFieldContext);\n\n  const {\n    children,\n    classNames,\n    description: descriptionProp,\n    errorMessage: errorMessageProp,\n    inputProps,\n    label: labelProp,\n    layoutOptions,\n    menuTrigger = 'focus',\n    size = 'medium',\n    isInvalid: isInvalidProp,\n    isReadOnly = false,\n    ...rest\n  } = props;\n  const errorMessage = errorMessageProp || null; // Protect against empty string\n  const isSmall = size === 'small';\n\n  return (\n    <ComboBox<T>\n      {...rest}\n      ref={ref}\n      className={composeRenderProps(classNames?.field, (className) =>\n        clsx('group/combobox-field', styles.field, className),\n      )}\n      menuTrigger={menuTrigger}\n      isInvalid={isInvalidProp || (errorMessage ? true : undefined)} // Leave uncontrolled if possible to fallback to validation state\n      isReadOnly={isReadOnly}\n      data-size={size}\n    >\n      {(\n        { isDisabled, isInvalid, isRequired }, // Rely on internal state, not props, since state could differ from props\n      ) => {\n        const shouldShowDescription =\n          !isReadOnly && !!descriptionProp && !(isSmall || isInvalid);\n\n        return (\n          <>\n            {!!labelProp && !isSmall && (\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              <Input\n                {...inputProps}\n                tabIndex={isReadOnly ? -1 : 0}\n                className={composeRenderProps(classNames?.input, (className) =>\n                  clsx(styles.input, className),\n                )}\n                title={inputProps?.value ? String(inputProps?.value) : ''}\n              />\n              {!isReadOnly && (\n                <Button\n                  className={composeRenderProps(\n                    classNames?.trigger,\n                    (className) => clsx(styles.trigger, className),\n                  )}\n                >\n                  <Icon size='small'>\n                    <ChevronDown />\n                  </Icon>\n                </Button>\n              )}\n            </div>\n            {shouldShowDescription && (\n              <Text\n                className={clsx(styles.description, classNames?.description)}\n                slot='description'\n              >\n                {descriptionProp}\n              </Text>\n            )}\n            <FieldError\n              className={composeRenderProps(classNames?.error, (className) =>\n                clsx(styles.error, className),\n              )}\n            >\n              {errorMessage}\n            </FieldError>\n            <Popover\n              className={composeRenderProps(classNames?.popover, (className) =>\n                clsx(styles.popover, className),\n              )}\n            >\n              <Virtualizer layout={ListLayout} layoutOptions={layoutOptions}>\n                <Options>{children}</Options>\n              </Virtualizer>\n            </Popover>\n          </>\n        );\n      }}\n    </ComboBox>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,SAAgB,cAAyC,EACvD,KACA,GAAG,SACqB;AACxB,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,qBAAqB;CAExE,MAAM,EACJ,UACA,YACA,aAAa,iBACb,cAAc,kBACd,YACA,OAAO,WACP,eACA,cAAc,SACd,OAAO,UACP,WAAW,eACX,aAAa,OACb,GAAG,SACD;CACJ,MAAM,eAAe,oBAAoB;CACzC,MAAM,UAAU,SAAS;AAEzB,QACE,oBAAC;EACC,GAAI;EACC;EACL,WAAW,mBAAmB,YAAY,QAAQ,cAChD,KAAK,wBAAwB,OAAO,OAAO,UAAU,CACtD;EACY;EACb,WAAW,kBAAkB,eAAe,OAAO;EACvC;EACZ,aAAW;aAGT,EAAE,YAAY,WAAW,iBACtB;GACH,MAAM,wBACJ,CAAC,cAAc,CAAC,CAAC,mBAAmB,EAAE,WAAW;AAEnD,UACE;IACG,CAAC,CAAC,aAAa,CAAC,WACf,oBAACA;KACC,WAAW,KAAK,OAAO,OAAO,YAAY,MAAM;KACpC;KACA;eAEX;MACK;IAEV,qBAAC;KACC,WAAW,KAAK,OAAO,SAAS,YAAY,QAAQ;KACpD,iBAAe,cAAc;gBAE7B,oBAAC;MACC,GAAI;MACJ,UAAU,aAAa,KAAK;MAC5B,WAAW,mBAAmB,YAAY,QAAQ,cAChD,KAAK,OAAO,OAAO,UAAU,CAC9B;MACD,OAAO,YAAY,QAAQ,OAAO,YAAY,MAAM,GAAG;OACvD,EACD,CAAC,cACA,oBAAC;MACC,WAAW,mBACT,YAAY,UACX,cAAc,KAAK,OAAO,SAAS,UAAU,CAC/C;gBAED,oBAAC;OAAK,MAAK;iBACT,oBAAC,gBAAc;QACV;OACA;MAEP;IACL,yBACC,oBAAC;KACC,WAAW,KAAK,OAAO,aAAa,YAAY,YAAY;KAC5D,MAAK;eAEJ;MACI;IAET,oBAAC;KACC,WAAW,mBAAmB,YAAY,QAAQ,cAChD,KAAK,OAAO,OAAO,UAAU,CAC9B;eAEA;MACU;IACb,oBAAC;KACC,WAAW,mBAAmB,YAAY,UAAU,cAClD,KAAK,OAAO,SAAS,UAAU,CAChC;eAED,oBAAC;MAAY,QAAQ;MAA2B;gBAC9C,oBAAC,WAAS,WAAmB;OACjB;MACN;OACT;;GAGE"}

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

@@ -55,10 +55,14 @@
     @variant group-disabled/combobox-field {
       @apply fg-disabled outline-interactive-disabled;
     }
+
+    @variant read-only {
+      @apply px-0 outline-none;
+    }
   }
 
   .input {
-    @apply font-display grow outline-none;
+    @apply font-display grow overflow-hidden text-ellipsis whitespace-nowrap outline-none;
 
     @variant group-size-medium/combobox-field {
       @apply text-body-s;

package/dist/components/coordinate-field/context.d.ts

@@ -12,9 +12,9 @@
 
 import { ProviderProps } from "../../lib/types.js";
 import { CoordinateFieldProps, CoordinateFieldState } from "./types.js";
-import * as react12 from "react";
+import * as react10 from "react";
 import { ContextValue } from "react-aria-components";
-import * as react_jsx_runtime31 from "react/jsx-runtime";
+import * as react_jsx_runtime26 from "react/jsx-runtime";
 
 //#region src/components/coordinate-field/context.d.ts
 
@@ -48,7 +48,7 @@ import * as react_jsx_runtime31 from "react/jsx-runtime";
  *
  * @see CoordinateFieldStateContext for internal runtime state
  */
-declare const CoordinateFieldContext: react12.Context<ContextValue<CoordinateFieldProps, HTMLDivElement>>;
+declare const CoordinateFieldContext: react10.Context<ContextValue<CoordinateFieldProps, HTMLDivElement>>;
 /**
  * State Context for CoordinateField component.
  *
@@ -66,7 +66,7 @@ declare const CoordinateFieldContext: react12.Context<ContextValue<CoordinateFie
  * const state = useCoordinateFieldStateContext();
  * const { segmentValues, isDisabled, registerTimeout } = state;
  */
-declare const CoordinateFieldStateContext: react12.Context<CoordinateFieldState | null>;
+declare const CoordinateFieldStateContext: react10.Context<CoordinateFieldState | null>;
 /**
  * Provider component for CoordinateField context
  * Wraps children with CoordinateFieldContext
@@ -74,7 +74,7 @@ declare const CoordinateFieldStateContext: react12.Context<CoordinateFieldState
 declare function CoordinateFieldProvider({
   children,
   ...props
-}: ProviderProps<CoordinateFieldProps>): react_jsx_runtime31.JSX.Element;
+}: ProviderProps<CoordinateFieldProps>): react_jsx_runtime26.JSX.Element;
 /**
  * Provider component for CoordinateField state context
  * Wraps children with CoordinateFieldStateContext
@@ -85,7 +85,7 @@ declare function CoordinateFieldStateProvider({
 }: {
   children: React.ReactNode;
   value: CoordinateFieldState;
-}): react_jsx_runtime31.JSX.Element;
+}): react_jsx_runtime26.JSX.Element;
 /**
  * Hook to access CoordinateField state context
  * Must be used within a CoordinateField component

package/dist/components/coordinate-field/index.d.ts

@@ -12,7 +12,7 @@
 
 import { CoordinateFieldProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime33 from "react/jsx-runtime";
+import * as react_jsx_runtime82 from "react/jsx-runtime";
 
 //#region src/components/coordinate-field/index.d.ts
 
@@ -77,7 +77,7 @@ import * as react_jsx_runtime33 from "react/jsx-runtime";
 declare function CoordinateField({
   ref,
   ...props
-}: CoordinateFieldProps): react_jsx_runtime33.JSX.Element;
+}: CoordinateFieldProps): react_jsx_runtime82.JSX.Element;
 //#endregion
 export { CoordinateField };
 //# sourceMappingURL=index.d.ts.map

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

@@ -107,7 +107,7 @@ import styles from "./styles.module.css";
 */
 function CoordinateField({ ref, ...props }) {
 	[props, ref] = useContextProps(props, ref, CoordinateFieldContext);
-	const { classNames, description: descriptionProp, label: labelProp, format = "dd", size = "medium", variant = "inline", showFormatButton = true, isDisabled = false, isInvalid: isInvalidProp = false, isRequired = false, ...rest } = props;
+	const { classNames, description: descriptionProp, label: labelProp, format = "dd", size = "medium", variant = "inline", showFormatButton = true, isDisabled = false, isInvalid: isInvalidProp = false, isRequired = false, isReadOnly = false, ...rest } = props;
 	const isSmall = size === "small";
 	const DOMProps = filterDOMProps(rest, { global: true });
 	const ariaLabelForSmallSize = isSmall && labelProp ? labelProp : rest["aria-label"];
@@ -163,6 +163,7 @@ function CoordinateField({ ref, ...props }) {
 				/* @__PURE__ */ jsxs("div", {
 					style: { "--min-width": variant === "stacked" ? "unset" : minControlWidth },
 					className: clsx(styles.control, classNames?.control),
+					"data-readonly": isReadOnly || null,
 					children: [/* @__PURE__ */ jsx("div", {
 						className: clsx(styles.input, styles[variant], classNames?.input),
 						onPasteCapture: paste.handleInputPaste,
@@ -197,6 +198,7 @@ function CoordinateField({ ref, ...props }) {
 								pad: config.pad,
 								className: clsx(styles.segment, classNames?.segment),
 								isDisabled,
+								isReadOnly,
 								allowedChars: config.allowedChars,
 								segmentRef: focus.segmentRefs[editableIndex],
 								segmentIndex: editableIndex,

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["Label","Button","Popover","AriaText","DialogTrigger","Dialog","RadioGroup","Radio"],"sources":["../../../src/components/coordinate-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 { clsx } from '@accelint/design-foundation/lib/utils';\nimport Check from '@accelint/icons/check';\nimport CopyToClipboard from '@accelint/icons/copy-to-clipboard';\nimport GlobalShare from '@accelint/icons/global-share';\nimport { filterDOMProps } from '@react-aria/utils';\nimport 'client-only';\nimport {\n  type CSSProperties,\n  type ReactNode,\n  useCallback,\n  useMemo,\n  useState,\n} from 'react';\nimport {\n  Text as AriaText,\n  composeRenderProps,\n  FieldError,\n  FieldErrorContext,\n  GroupContext,\n  LabelContext,\n  Provider,\n  TextContext,\n  useContextProps,\n} from 'react-aria-components';\nimport { useCoordinateField } from '../../hooks/coordinate-field';\nimport { Button } from '../button';\nimport { Dialog } from '../dialog';\nimport { DialogContent } from '../dialog/content';\nimport { DialogFooter } from '../dialog/footer';\nimport { DialogTitle } from '../dialog/title';\nimport { DialogTrigger } from '../dialog/trigger';\nimport { Icon } from '../icon';\nimport { Label } from '../label';\nimport { Popover } from '../popover';\nimport { PopoverContent } from '../popover/content';\nimport { PopoverTitle } from '../popover/title';\nimport { PopoverTrigger } from '../popover/trigger';\nimport { Radio } from '../radio';\nimport { RadioGroup } from '../radio/group';\nimport { CoordinateFieldContext, CoordinateFieldStateContext } from './context';\nimport {\n  type CoordinateFormatResult,\n  getAllCoordinateFormats,\n} from './coordinate-utils';\nimport { CoordinateSegment } from './segment';\nimport { getSegmentLabel, GROUP_SEPARATOR } from './segment-configs';\nimport styles from './styles.module.css';\nimport type { CoordinateFieldProps } from './types';\nimport {\n  COORDINATE_FORMAT_LABELS,\n  COORDINATE_FORMAT_NAMES,\n  COORDINATE_SYSTEMS,\n  type CoordinateSystem,\n} from './types';\nimport { calculateMinControlWidth } from './width-utils';\n\n/**\n * CoordinateField - A comprehensive coordinate input component with multiple format support\n *\n * Provides accessible coordinate input functionality with support for multiple coordinate\n * systems (DD, DDM, DMS, MGRS, UTM). All values are normalized to Decimal Degrees internally\n * for consistency.\n *\n * @example\n * // Basic coordinate field\n * <CoordinateField label=\"Location\" />\n *\n * @example\n * // Coordinate field with validation\n * <CoordinateField\n *   label=\"Target Coordinates\"\n *   isRequired\n *   isInvalid={hasError}\n *   errorMessage=\"Please enter a valid coordinate\"\n * />\n *\n * @example\n * // Coordinate field with specific format\n * <CoordinateField\n *   label=\"Position\"\n *   format=\"dms\"\n *   description=\"Enter coordinates in Degrees Minutes Seconds format\"\n * />\n *\n * @example\n * // Compact coordinate field\n * <CoordinateField\n *   label=\"Coordinates\"\n *   size=\"small\"\n *   format=\"dd\"\n * />\n *\n * @example\n * // Controlled coordinate field\n * <CoordinateField\n *   label=\"Selected Location\"\n *   value={coordinates}\n *   onChange={setCoordinates}\n * />\n *\n * @example\n * // Coordinate field with error handling\n * <CoordinateField\n *   label=\"Target Coordinates\"\n *   onError={(message, context) => {\n *     // message will be \"Invalid coordinate value\" for validation errors\n *     // or \"Invalid coordinate format\" for paste errors\n *     setErrorMessage(message);\n *     console.error(message, context);\n *   }}\n *   isInvalid={!!errorMessage}\n *   errorMessage={errorMessage}\n * />\n */\nexport function CoordinateField({ ref, ...props }: CoordinateFieldProps) {\n  [props, ref] = useContextProps(props, ref, CoordinateFieldContext);\n\n  const {\n    classNames,\n    description: descriptionProp,\n    label: labelProp,\n    format = 'dd',\n    size = 'medium',\n    variant = 'inline',\n    showFormatButton = true,\n    isDisabled = false,\n    isInvalid: isInvalidProp = false,\n    isRequired = false,\n    ...rest\n  } = props;\n\n  const isSmall = size === 'small';\n\n  const DOMProps = filterDOMProps(rest, { global: true });\n\n  // When size is small and label is hidden, use aria-label instead of aria-labelledby\n  // to ensure screen readers have an accessible name\n  const ariaLabelForSmallSize =\n    isSmall && labelProp ? labelProp : rest['aria-label'];\n\n  const {\n    state,\n    focus,\n    paste,\n    copy,\n    registerTimeout,\n    fieldProps,\n    labelProps,\n    descriptionProps,\n    errorProps,\n    validation,\n    effectiveErrorMessage,\n    isInvalid,\n  } = useCoordinateField(\n    props,\n    ariaLabelForSmallSize,\n    rest['aria-describedby'],\n    rest['aria-details'],\n  );\n\n  const componentState = {\n    segmentValues: state.segmentValues,\n    format,\n    currentValue: state.currentValue,\n    validationErrors: state.validationErrors,\n    isDisabled,\n    isInvalid,\n    isRequired,\n    size,\n    variant,\n    registerTimeout,\n  };\n\n  // Store all coordinate formats, calculated only when popover opens\n  const [allCoordinateFormats, setAllCoordinateFormats] = useState<Record<\n    CoordinateSystem,\n    CoordinateFormatResult\n  > | null>(null);\n\n  const handlePopoverOpenChange = useCallback(\n    (isOpen: boolean) => {\n      if (isOpen) {\n        setAllCoordinateFormats(getAllCoordinateFormats(state.currentValue));\n      }\n    },\n    [state.currentValue],\n  );\n\n  // Calculate the minimum width needed for the control container\n  // This keeps the outlined container at a fixed width while segments animate\n  const minControlWidth = useMemo(\n    () =>\n      calculateMinControlWidth(\n        state.editableSegmentConfigs,\n        state.segmentConfigs,\n        showFormatButton,\n      ),\n    [state.editableSegmentConfigs, state.segmentConfigs, showFormatButton],\n  );\n\n  return (\n    <Provider\n      values={[\n        [CoordinateFieldContext, props],\n        [CoordinateFieldStateContext, componentState],\n        [GroupContext, fieldProps],\n        [LabelContext, labelProps],\n        [\n          TextContext,\n          {\n            slots: {\n              description: descriptionProps,\n              errorMessage: errorProps,\n            },\n          },\n        ],\n        [FieldErrorContext, validation],\n      ]}\n    >\n      <div\n        {...DOMProps}\n        {...fieldProps}\n        ref={ref}\n        className={clsx(\n          'group/coordinate-field',\n          styles.field,\n          classNames?.field,\n        )}\n        data-size={size}\n        data-disabled={isDisabled || null}\n        data-invalid={isInvalid || null}\n      >\n        {!isSmall && labelProp && (\n          <Label\n            className={classNames?.label}\n            isDisabled={isDisabled}\n            isRequired={isRequired}\n          >\n            {labelProp}\n          </Label>\n        )}\n\n        <div\n          style={\n            {\n              '--min-width': variant === 'stacked' ? 'unset' : minControlWidth,\n            } as CSSProperties\n          }\n          className={clsx(styles.control, classNames?.control)}\n        >\n          <div\n            className={clsx(styles.input, styles[variant], classNames?.input)}\n            onPasteCapture={paste.handleInputPaste}\n            data-input-container\n          >\n            {state.segmentConfigs\n              .reduce<ReactNode[][]>(\n                (acc, config, configIndex) => {\n                  const currentGroupIndex = acc.length - 1;\n\n                  if (\n                    config.value === GROUP_SEPARATOR &&\n                    variant === 'stacked'\n                  ) {\n                    acc.push([]);\n\n                    return acc;\n                  }\n\n                  if (config.type === 'literal') {\n                    acc[currentGroupIndex]?.push(\n                      <span\n                        key={`${format}-literal-${configIndex}-${config.value}`}\n                        className={styles.literal}\n                      >\n                        {config.value}\n                      </span>,\n                    );\n\n                    return acc;\n                  }\n\n                  const editableIndex = state.segmentConfigs\n                    .slice(0, configIndex)\n                    .filter((c) => c.type !== 'literal').length;\n\n                  acc[currentGroupIndex]?.push(\n                    <CoordinateSegment\n                      key={`${format}-segment-${editableIndex}`}\n                      value={state.segmentValues[editableIndex] || ''}\n                      onChange={(newValue) =>\n                        state.handleSegmentChange(editableIndex, newValue)\n                      }\n                      onFocus={() =>\n                        focus.setFocusedSegmentIndex(editableIndex)\n                      }\n                      onBlur={() => {\n                        focus.setFocusedSegmentIndex(-1);\n                        state.flushPendingValidation();\n                      }}\n                      onKeyDown={(e) =>\n                        focus.handleSegmentKeyDown(editableIndex, e)\n                      }\n                      onAutoAdvance={() =>\n                        focus.focusNextSegment(editableIndex)\n                      }\n                      onAutoRetreat={() =>\n                        focus.focusPreviousSegment(editableIndex)\n                      }\n                      placeholder={config.placeholder}\n                      maxLength={config.maxLength}\n                      pad={config.pad}\n                      className={clsx(styles.segment, classNames?.segment)}\n                      isDisabled={isDisabled}\n                      allowedChars={config.allowedChars}\n                      segmentRef={focus.segmentRefs[editableIndex]}\n                      segmentIndex={editableIndex}\n                      totalSegments={state.editableSegmentConfigs.length}\n                      ariaLabel={getSegmentLabel(format, editableIndex)}\n                    />,\n                  );\n\n                  return acc;\n                },\n                [[]],\n              )\n              .map((group, groupIndex) => (\n                <div\n                  className={clsx(styles.segmentGroup, styles[variant])}\n                  key={`${format}-group-${\n                    // biome-ignore lint/suspicious/noArrayIndexKey: intentional\n                    groupIndex\n                  }`}\n                >\n                  {group}\n                </div>\n              ))}\n          </div>\n\n          {showFormatButton && (\n            <PopoverTrigger onOpenChange={handlePopoverOpenChange}>\n              <Button\n                variant='icon'\n                size={size}\n                color='mono-bold'\n                className={classNames?.formatButton}\n                aria-label='View coordinate in all formats'\n                isDisabled={!copy.isFormatButtonEnabled}\n              >\n                <Icon>\n                  <GlobalShare />\n                </Icon>\n              </Button>\n              <Popover classNames={{ popover: styles.popover }}>\n                <PopoverTitle className={styles.popoverTitle}>\n                  Copy Coordinates\n                </PopoverTitle>\n                <PopoverContent>\n                  {allCoordinateFormats &&\n                    COORDINATE_SYSTEMS.map((formatKey) => {\n                      const formatResult = allCoordinateFormats[formatKey];\n                      const isCopied = copy.copiedFormat === formatKey;\n\n                      return (\n                        <div key={formatKey} className={styles.formatRow}>\n                          <div className={styles.formatLabels}>\n                            <span className={styles.formatLabel}>\n                              {COORDINATE_FORMAT_LABELS[formatKey]}\n                            </span>\n                            <span\n                              className={styles.formatValue}\n                              title={formatResult.value}\n                            >\n                              {formatResult.value}\n                            </span>\n                          </div>\n                          <Button\n                            variant='icon'\n                            color='mono-bold'\n                            aria-label={`Copy ${COORDINATE_FORMAT_LABELS[formatKey]} format`}\n                            onClick={() => copy.handleCopyFormat(formatKey)}\n                            isDisabled={!formatResult.isValid}\n                          >\n                            <Icon>\n                              {isCopied ? <Check /> : <CopyToClipboard />}\n                            </Icon>\n                          </Button>\n                        </div>\n                      );\n                    })}\n                </PopoverContent>\n              </Popover>\n            </PopoverTrigger>\n          )}\n        </div>\n\n        {/* Description is hidden when field is invalid (unless disabled) to make room for error message */}\n        {descriptionProp && !isSmall && (!isInvalid || isDisabled) && (\n          <AriaText\n            className={clsx(styles.description, classNames?.description)}\n            slot='description'\n          >\n            {descriptionProp}\n          </AriaText>\n        )}\n\n        <FieldError\n          className={composeRenderProps(classNames?.error, (className) =>\n            clsx(styles.error, className),\n          )}\n        >\n          {effectiveErrorMessage}\n        </FieldError>\n\n        <DialogTrigger\n          isOpen={paste.showDisambiguationModal}\n          onOpenChange={paste.setShowDisambiguationModal}\n        >\n          <Button className='hidden'>Hidden Trigger</Button>\n          <Dialog size='small'>\n            <DialogTitle className={styles.modalTitle}>\n              Select Coordinate Format\n            </DialogTitle>\n            <DialogContent>\n              <p className={styles.modalDescription}>\n                The pasted value matches multiple coordinate formats. Please\n                select the correct interpretation:\n              </p>\n\n              <RadioGroup\n                classNames={{ group: styles.formatOptions }}\n                value={paste.selectedDisambiguationFormat}\n                onChange={(value) =>\n                  paste.setSelectedDisambiguationFormat(\n                    value as CoordinateSystem,\n                  )\n                }\n              >\n                {paste.disambiguationMatches.map((match) => (\n                  <Radio key={match.format} value={match.format}>\n                    <div className={styles.modalOptionContent}>\n                      <span className={styles.formatOptionLabel}>\n                        {COORDINATE_FORMAT_NAMES[match.format]}\n                      </span>\n                      <span className={styles.formatOptionValue}>\n                        {match.displayString}\n                      </span>\n                    </div>\n                  </Radio>\n                ))}\n              </RadioGroup>\n            </DialogContent>\n            <DialogFooter className={styles.modalActions}>\n              <Button\n                variant='flat'\n                onPress={() => paste.setShowDisambiguationModal(false)}\n              >\n                Cancel\n              </Button>\n              <Button onPress={paste.handleDisambiguationSelect}>\n                Apply Selected\n              </Button>\n            </DialogFooter>\n          </Dialog>\n        </DialogTrigger>\n      </div>\n    </Provider>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["Label","Button","Popover","AriaText","DialogTrigger","Dialog","RadioGroup","Radio"],"sources":["../../../src/components/coordinate-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 { clsx } from '@accelint/design-foundation/lib/utils';\nimport Check from '@accelint/icons/check';\nimport CopyToClipboard from '@accelint/icons/copy-to-clipboard';\nimport GlobalShare from '@accelint/icons/global-share';\nimport { filterDOMProps } from '@react-aria/utils';\nimport 'client-only';\nimport {\n  type CSSProperties,\n  type ReactNode,\n  useCallback,\n  useMemo,\n  useState,\n} from 'react';\nimport {\n  Text as AriaText,\n  composeRenderProps,\n  FieldError,\n  FieldErrorContext,\n  GroupContext,\n  LabelContext,\n  Provider,\n  TextContext,\n  useContextProps,\n} from 'react-aria-components';\nimport { useCoordinateField } from '../../hooks/coordinate-field';\nimport { Button } from '../button';\nimport { Dialog } from '../dialog';\nimport { DialogContent } from '../dialog/content';\nimport { DialogFooter } from '../dialog/footer';\nimport { DialogTitle } from '../dialog/title';\nimport { DialogTrigger } from '../dialog/trigger';\nimport { Icon } from '../icon';\nimport { Label } from '../label';\nimport { Popover } from '../popover';\nimport { PopoverContent } from '../popover/content';\nimport { PopoverTitle } from '../popover/title';\nimport { PopoverTrigger } from '../popover/trigger';\nimport { Radio } from '../radio';\nimport { RadioGroup } from '../radio/group';\nimport { CoordinateFieldContext, CoordinateFieldStateContext } from './context';\nimport {\n  type CoordinateFormatResult,\n  getAllCoordinateFormats,\n} from './coordinate-utils';\nimport { CoordinateSegment } from './segment';\nimport { GROUP_SEPARATOR, getSegmentLabel } from './segment-configs';\nimport styles from './styles.module.css';\nimport {\n  COORDINATE_FORMAT_LABELS,\n  COORDINATE_FORMAT_NAMES,\n  COORDINATE_SYSTEMS,\n  type CoordinateSystem,\n} from './types';\nimport { calculateMinControlWidth } from './width-utils';\nimport type { CoordinateFieldProps } from './types';\n\n/**\n * CoordinateField - A comprehensive coordinate input component with multiple format support\n *\n * Provides accessible coordinate input functionality with support for multiple coordinate\n * systems (DD, DDM, DMS, MGRS, UTM). All values are normalized to Decimal Degrees internally\n * for consistency.\n *\n * @example\n * // Basic coordinate field\n * <CoordinateField label=\"Location\" />\n *\n * @example\n * // Coordinate field with validation\n * <CoordinateField\n *   label=\"Target Coordinates\"\n *   isRequired\n *   isInvalid={hasError}\n *   errorMessage=\"Please enter a valid coordinate\"\n * />\n *\n * @example\n * // Coordinate field with specific format\n * <CoordinateField\n *   label=\"Position\"\n *   format=\"dms\"\n *   description=\"Enter coordinates in Degrees Minutes Seconds format\"\n * />\n *\n * @example\n * // Compact coordinate field\n * <CoordinateField\n *   label=\"Coordinates\"\n *   size=\"small\"\n *   format=\"dd\"\n * />\n *\n * @example\n * // Controlled coordinate field\n * <CoordinateField\n *   label=\"Selected Location\"\n *   value={coordinates}\n *   onChange={setCoordinates}\n * />\n *\n * @example\n * // Coordinate field with error handling\n * <CoordinateField\n *   label=\"Target Coordinates\"\n *   onError={(message, context) => {\n *     // message will be \"Invalid coordinate value\" for validation errors\n *     // or \"Invalid coordinate format\" for paste errors\n *     setErrorMessage(message);\n *     console.error(message, context);\n *   }}\n *   isInvalid={!!errorMessage}\n *   errorMessage={errorMessage}\n * />\n */\nexport function CoordinateField({ ref, ...props }: CoordinateFieldProps) {\n  [props, ref] = useContextProps(props, ref, CoordinateFieldContext);\n\n  const {\n    classNames,\n    description: descriptionProp,\n    label: labelProp,\n    format = 'dd',\n    size = 'medium',\n    variant = 'inline',\n    showFormatButton = true,\n    isDisabled = false,\n    isInvalid: isInvalidProp = false,\n    isRequired = false,\n    isReadOnly = false,\n    ...rest\n  } = props;\n\n  const isSmall = size === 'small';\n\n  const DOMProps = filterDOMProps(rest, { global: true });\n\n  // When size is small and label is hidden, use aria-label instead of aria-labelledby\n  // to ensure screen readers have an accessible name\n  const ariaLabelForSmallSize =\n    isSmall && labelProp ? labelProp : rest['aria-label'];\n\n  const {\n    state,\n    focus,\n    paste,\n    copy,\n    registerTimeout,\n    fieldProps,\n    labelProps,\n    descriptionProps,\n    errorProps,\n    validation,\n    effectiveErrorMessage,\n    isInvalid,\n  } = useCoordinateField(\n    props,\n    ariaLabelForSmallSize,\n    rest['aria-describedby'],\n    rest['aria-details'],\n  );\n\n  const componentState = {\n    segmentValues: state.segmentValues,\n    format,\n    currentValue: state.currentValue,\n    validationErrors: state.validationErrors,\n    isDisabled,\n    isInvalid,\n    isRequired,\n    size,\n    variant,\n    registerTimeout,\n  };\n\n  // Store all coordinate formats, calculated only when popover opens\n  const [allCoordinateFormats, setAllCoordinateFormats] = useState<Record<\n    CoordinateSystem,\n    CoordinateFormatResult\n  > | null>(null);\n\n  const handlePopoverOpenChange = useCallback(\n    (isOpen: boolean) => {\n      if (isOpen) {\n        setAllCoordinateFormats(getAllCoordinateFormats(state.currentValue));\n      }\n    },\n    [state.currentValue],\n  );\n\n  // Calculate the minimum width needed for the control container\n  // This keeps the outlined container at a fixed width while segments animate\n  const minControlWidth = useMemo(\n    () =>\n      calculateMinControlWidth(\n        state.editableSegmentConfigs,\n        state.segmentConfigs,\n        showFormatButton,\n      ),\n    [state.editableSegmentConfigs, state.segmentConfigs, showFormatButton],\n  );\n\n  return (\n    <Provider\n      values={[\n        [CoordinateFieldContext, props],\n        [CoordinateFieldStateContext, componentState],\n        [GroupContext, fieldProps],\n        [LabelContext, labelProps],\n        [\n          TextContext,\n          {\n            slots: {\n              description: descriptionProps,\n              errorMessage: errorProps,\n            },\n          },\n        ],\n        [FieldErrorContext, validation],\n      ]}\n    >\n      <div\n        {...DOMProps}\n        {...fieldProps}\n        ref={ref}\n        className={clsx(\n          'group/coordinate-field',\n          styles.field,\n          classNames?.field,\n        )}\n        data-size={size}\n        data-disabled={isDisabled || null}\n        data-invalid={isInvalid || null}\n      >\n        {!isSmall && labelProp && (\n          <Label\n            className={classNames?.label}\n            isDisabled={isDisabled}\n            isRequired={isRequired}\n          >\n            {labelProp}\n          </Label>\n        )}\n\n        <div\n          style={\n            {\n              '--min-width': variant === 'stacked' ? 'unset' : minControlWidth,\n            } as CSSProperties\n          }\n          className={clsx(styles.control, classNames?.control)}\n          data-readonly={isReadOnly || null}\n        >\n          <div\n            className={clsx(styles.input, styles[variant], classNames?.input)}\n            onPasteCapture={paste.handleInputPaste}\n            data-input-container\n          >\n            {state.segmentConfigs\n              .reduce<ReactNode[][]>(\n                (acc, config, configIndex) => {\n                  const currentGroupIndex = acc.length - 1;\n\n                  if (\n                    config.value === GROUP_SEPARATOR &&\n                    variant === 'stacked'\n                  ) {\n                    acc.push([]);\n\n                    return acc;\n                  }\n\n                  if (config.type === 'literal') {\n                    acc[currentGroupIndex]?.push(\n                      <span\n                        key={`${format}-literal-${configIndex}-${config.value}`}\n                        className={styles.literal}\n                      >\n                        {config.value}\n                      </span>,\n                    );\n\n                    return acc;\n                  }\n\n                  const editableIndex = state.segmentConfigs\n                    .slice(0, configIndex)\n                    .filter((c) => c.type !== 'literal').length;\n\n                  acc[currentGroupIndex]?.push(\n                    <CoordinateSegment\n                      key={`${format}-segment-${editableIndex}`}\n                      value={state.segmentValues[editableIndex] || ''}\n                      onChange={(newValue) =>\n                        state.handleSegmentChange(editableIndex, newValue)\n                      }\n                      onFocus={() =>\n                        focus.setFocusedSegmentIndex(editableIndex)\n                      }\n                      onBlur={() => {\n                        focus.setFocusedSegmentIndex(-1);\n                        state.flushPendingValidation();\n                      }}\n                      onKeyDown={(e) =>\n                        focus.handleSegmentKeyDown(editableIndex, e)\n                      }\n                      onAutoAdvance={() =>\n                        focus.focusNextSegment(editableIndex)\n                      }\n                      onAutoRetreat={() =>\n                        focus.focusPreviousSegment(editableIndex)\n                      }\n                      placeholder={config.placeholder}\n                      maxLength={config.maxLength}\n                      pad={config.pad}\n                      className={clsx(styles.segment, classNames?.segment)}\n                      isDisabled={isDisabled}\n                      isReadOnly={isReadOnly}\n                      allowedChars={config.allowedChars}\n                      segmentRef={focus.segmentRefs[editableIndex]}\n                      segmentIndex={editableIndex}\n                      totalSegments={state.editableSegmentConfigs.length}\n                      ariaLabel={getSegmentLabel(format, editableIndex)}\n                    />,\n                  );\n\n                  return acc;\n                },\n                [[]],\n              )\n              .map((group, groupIndex) => (\n                <div\n                  className={clsx(styles.segmentGroup, styles[variant])}\n                  key={`${format}-group-${\n                    // biome-ignore lint/suspicious/noArrayIndexKey: intentional\n                    groupIndex\n                  }`}\n                >\n                  {group}\n                </div>\n              ))}\n          </div>\n\n          {showFormatButton && (\n            <PopoverTrigger onOpenChange={handlePopoverOpenChange}>\n              <Button\n                variant='icon'\n                size={size}\n                color='mono-bold'\n                className={classNames?.formatButton}\n                aria-label='View coordinate in all formats'\n                isDisabled={!copy.isFormatButtonEnabled}\n              >\n                <Icon>\n                  <GlobalShare />\n                </Icon>\n              </Button>\n              <Popover classNames={{ popover: styles.popover }}>\n                <PopoverTitle className={styles.popoverTitle}>\n                  Copy Coordinates\n                </PopoverTitle>\n                <PopoverContent>\n                  {allCoordinateFormats &&\n                    COORDINATE_SYSTEMS.map((formatKey) => {\n                      const formatResult = allCoordinateFormats[formatKey];\n                      const isCopied = copy.copiedFormat === formatKey;\n\n                      return (\n                        <div key={formatKey} className={styles.formatRow}>\n                          <div className={styles.formatLabels}>\n                            <span className={styles.formatLabel}>\n                              {COORDINATE_FORMAT_LABELS[formatKey]}\n                            </span>\n                            <span\n                              className={styles.formatValue}\n                              title={formatResult.value}\n                            >\n                              {formatResult.value}\n                            </span>\n                          </div>\n                          <Button\n                            variant='icon'\n                            color='mono-bold'\n                            aria-label={`Copy ${COORDINATE_FORMAT_LABELS[formatKey]} format`}\n                            onClick={() => copy.handleCopyFormat(formatKey)}\n                            isDisabled={!formatResult.isValid}\n                          >\n                            <Icon>\n                              {isCopied ? <Check /> : <CopyToClipboard />}\n                            </Icon>\n                          </Button>\n                        </div>\n                      );\n                    })}\n                </PopoverContent>\n              </Popover>\n            </PopoverTrigger>\n          )}\n        </div>\n\n        {/* Description is hidden when field is invalid (unless disabled) to make room for error message */}\n        {descriptionProp && !isSmall && (!isInvalid || isDisabled) && (\n          <AriaText\n            className={clsx(styles.description, classNames?.description)}\n            slot='description'\n          >\n            {descriptionProp}\n          </AriaText>\n        )}\n\n        <FieldError\n          className={composeRenderProps(classNames?.error, (className) =>\n            clsx(styles.error, className),\n          )}\n        >\n          {effectiveErrorMessage}\n        </FieldError>\n\n        <DialogTrigger\n          isOpen={paste.showDisambiguationModal}\n          onOpenChange={paste.setShowDisambiguationModal}\n        >\n          <Button className='hidden'>Hidden Trigger</Button>\n          <Dialog size='small'>\n            <DialogTitle className={styles.modalTitle}>\n              Select Coordinate Format\n            </DialogTitle>\n            <DialogContent>\n              <p className={styles.modalDescription}>\n                The pasted value matches multiple coordinate formats. Please\n                select the correct interpretation:\n              </p>\n\n              <RadioGroup\n                classNames={{ group: styles.formatOptions }}\n                value={paste.selectedDisambiguationFormat}\n                onChange={(value) =>\n                  paste.setSelectedDisambiguationFormat(\n                    value as CoordinateSystem,\n                  )\n                }\n              >\n                {paste.disambiguationMatches.map((match) => (\n                  <Radio key={match.format} value={match.format}>\n                    <div className={styles.modalOptionContent}>\n                      <span className={styles.formatOptionLabel}>\n                        {COORDINATE_FORMAT_NAMES[match.format]}\n                      </span>\n                      <span className={styles.formatOptionValue}>\n                        {match.displayString}\n                      </span>\n                    </div>\n                  </Radio>\n                ))}\n              </RadioGroup>\n            </DialogContent>\n            <DialogFooter className={styles.modalActions}>\n              <Button\n                variant='flat'\n                onPress={() => paste.setShowDisambiguationModal(false)}\n              >\n                Cancel\n              </Button>\n              <Button onPress={paste.handleDisambiguationSelect}>\n                Apply Selected\n              </Button>\n            </DialogFooter>\n          </Dialog>\n        </DialogTrigger>\n      </div>\n    </Provider>\n  );\n}\n"],"mappings":"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"}

package/dist/components/coordinate-field/segment.d.ts

@@ -12,7 +12,7 @@
 
 import { CoordinateSegmentProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime45 from "react/jsx-runtime";
+import * as react_jsx_runtime69 from "react/jsx-runtime";
 
 //#region src/components/coordinate-field/segment.d.ts
 
@@ -57,6 +57,7 @@ declare function CoordinateSegment({
   maxLength,
   className,
   isDisabled,
+  isReadOnly,
   allowedChars,
   segmentRef,
   segmentIndex,
@@ -65,7 +66,7 @@ declare function CoordinateSegment({
   onAutoRetreat,
   pad,
   ariaLabel
-}: CoordinateSegmentProps): react_jsx_runtime45.JSX.Element;
+}: CoordinateSegmentProps): react_jsx_runtime69.JSX.Element;
 //#endregion
 export { CoordinateSegment };
 //# sourceMappingURL=segment.d.ts.map

package/dist/components/coordinate-field/segment.js

@@ -50,7 +50,7 @@ import { jsx } from "react/jsx-runtime";
 *   placeholder="N"
 * />
 */
-function CoordinateSegment({ value, onChange, onFocus, onBlur, onKeyDown, placeholder, maxLength, className, isDisabled, allowedChars, segmentRef, segmentIndex, totalSegments: _totalSegments, onAutoAdvance, onAutoRetreat, pad, ariaLabel }) {
+function CoordinateSegment({ value, onChange, onFocus, onBlur, onKeyDown, placeholder, maxLength, className, isDisabled, isReadOnly, allowedChars, segmentRef, segmentIndex, totalSegments: _totalSegments, onAutoAdvance, onAutoRetreat, pad, ariaLabel }) {
 	const contextState = useCoordinateFieldStateContext();
 	const effectiveIsDisabled = contextState.isDisabled ?? isDisabled;
 	const dynamicWidth = useMemo(() => {
@@ -120,7 +120,9 @@ function CoordinateSegment({ value, onChange, onFocus, onBlur, onKeyDown, placeh
 		onBlur?.();
 	};
 	return /* @__PURE__ */ jsx("input", {
+		readOnly: isReadOnly,
 		ref: segmentRef,
+		tabIndex: isReadOnly ? -1 : 0,
 		type: "text",
 		value,
 		onChange: handleChange,

package/dist/components/coordinate-field/segment.js.map

@@ -1 +1 @@
-{"version":3,"file":"segment.js","names":[],"sources":["../../../src/components/coordinate-field/segment.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 { useMemo } from 'react';\nimport { useCoordinateFieldStateContext } from './context';\nimport type { ChangeEvent, FocusEvent, KeyboardEvent } from 'react';\nimport type { CoordinateSegmentProps } from './types';\n\n/**\n * CoordinateSegment - A controlled input component for a single coordinate segment\n *\n * This component represents one editable part of a coordinate (e.g., degrees, minutes, direction).\n * It handles character filtering, focus management, and keyboard navigation.\n *\n * Segment Types (determined by allowedChars):\n * - Numeric: \"[0-9\\\\-\\\\.]\" - for DD degrees, DDM/DMS degrees/minutes/seconds\n * - Directional: \"[NSEW]\" - for DDM/DMS direction indicators\n * - Alphanumeric: \"[0-9A-Z]\" - for MGRS/UTM zone identifiers\n *\n * @example\n * // Numeric segment (latitude degrees)\n * <CoordinateSegment\n *   value={latDegrees}\n *   onChange={setLatDegrees}\n *   allowedChars=\"[0-9\\\\-\\\\.]\"\n *   maxLength={10}\n *   placeholder=\"00.00000\"\n * />\n *\n * @example\n * // Directional segment (latitude direction)\n * <CoordinateSegment\n *   value={latDir}\n *   onChange={setLatDir}\n *   allowedChars=\"[NS]\"\n *   maxLength={1}\n *   placeholder=\"N\"\n * />\n */\nexport function CoordinateSegment({\n  value,\n  onChange,\n  onFocus,\n  onBlur,\n  onKeyDown,\n  placeholder,\n  maxLength,\n  className,\n  isDisabled,\n  allowedChars,\n  segmentRef,\n  segmentIndex,\n  totalSegments: _totalSegments,\n  onAutoAdvance,\n  onAutoRetreat,\n  pad,\n  ariaLabel,\n}: CoordinateSegmentProps) {\n  const contextState = useCoordinateFieldStateContext();\n\n  const effectiveIsDisabled = contextState.isDisabled ?? isDisabled;\n\n  // Calculate dynamic width based on focus state\n  const dynamicWidth = useMemo(() => {\n    if (maxLength === undefined) {\n      return undefined;\n    }\n\n    // Default padding to 0.5 if not specified\n    const padding = pad ?? 0.5;\n\n    // When blurred, use value length (or maxLength if empty) + padding\n    const contentLength = value.length > 0 ? value.length : maxLength;\n    return contentLength + padding;\n  }, [maxLength, pad, value.length]);\n\n  const handleChange = (e: ChangeEvent<HTMLInputElement>) => {\n    const newValue = e.target.value;\n\n    if (allowedChars) {\n      const regex = new RegExp(`^${allowedChars}*$`);\n      if (!regex.test(newValue)) {\n        return;\n      }\n    }\n\n    if (maxLength && newValue.length > maxLength) {\n      return;\n    }\n\n    onChange(newValue);\n\n    if (maxLength && newValue.length === maxLength && onAutoAdvance) {\n      const timeoutId = setTimeout(() => {\n        onAutoAdvance();\n      }, 0);\n      contextState.registerTimeout(timeoutId);\n    }\n  };\n\n  const handlePaste = (e: React.ClipboardEvent<HTMLInputElement>) => {\n    const pastedText = e.clipboardData.getData('text');\n\n    if (allowedChars) {\n      const regex = new RegExp(`^${allowedChars}*$`);\n      if (!regex.test(pastedText)) {\n        e.preventDefault();\n        return;\n      }\n    }\n\n    if (maxLength && pastedText.length > maxLength) {\n      e.preventDefault();\n      onChange(pastedText.slice(0, maxLength));\n      return;\n    }\n  };\n\n  const handleKeyDown = (e: KeyboardEvent<HTMLInputElement>) => {\n    const input = e.currentTarget;\n    const cursorAtStart = input.selectionStart === 0;\n    const cursorAtEnd = input.selectionStart === value.length;\n    const isEmpty = value.length === 0;\n\n    if (e.key === 'Backspace' && isEmpty && onAutoRetreat) {\n      e.preventDefault();\n      onAutoRetreat();\n      return;\n    }\n\n    if (e.key === 'ArrowLeft' && cursorAtStart && onAutoRetreat) {\n      e.preventDefault();\n      onAutoRetreat();\n      return;\n    }\n\n    if (e.key === 'ArrowRight' && cursorAtEnd && onAutoAdvance) {\n      e.preventDefault();\n      onAutoAdvance();\n      return;\n    }\n\n    onKeyDown?.(e);\n  };\n\n  const handleFocus = (e: FocusEvent<HTMLInputElement>) => {\n    e.target.select();\n    onFocus?.();\n  };\n\n  const handleBlur = () => {\n    onBlur?.();\n  };\n\n  return (\n    <input\n      ref={segmentRef}\n      type='text'\n      value={value}\n      onChange={handleChange}\n      onPaste={handlePaste}\n      onKeyDown={handleKeyDown}\n      onFocus={handleFocus}\n      onBlur={handleBlur}\n      placeholder={placeholder}\n      maxLength={maxLength}\n      className={className}\n      disabled={effectiveIsDisabled}\n      style={dynamicWidth ? { width: `${dynamicWidth}ch` } : undefined}\n      aria-label={\n        ariaLabel ||\n        `Coordinate segment ${segmentIndex !== undefined ? segmentIndex + 1 : ''}`\n      }\n      aria-disabled={effectiveIsDisabled}\n      autoComplete='off'\n      inputMode={\n        allowedChars?.includes('0-9')\n          ? allowedChars.includes('\\\\-\\\\.')\n            ? 'decimal'\n            : 'numeric'\n          : 'text'\n      }\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,SAAgB,kBAAkB,EAChC,OACA,UACA,SACA,QACA,WACA,aACA,WACA,WACA,YACA,cACA,YACA,cACA,eAAe,gBACf,eACA,eACA,KACA,aACyB;CACzB,MAAM,eAAe,gCAAgC;CAErD,MAAM,sBAAsB,aAAa,cAAc;CAGvD,MAAM,eAAe,cAAc;AACjC,MAAI,cAAc,OAChB;EAIF,MAAM,UAAU,OAAO;AAIvB,UADsB,MAAM,SAAS,IAAI,MAAM,SAAS,aACjC;IACtB;EAAC;EAAW;EAAK,MAAM;EAAO,CAAC;CAElC,MAAM,gBAAgB,MAAqC;EACzD,MAAM,WAAW,EAAE,OAAO;AAE1B,MAAI,cAEF;OAAI,kBADU,IAAI,OAAO,IAAI,aAAa,IAAI,EACnC,KAAK,SAAS,CACvB;;AAIJ,MAAI,aAAa,SAAS,SAAS,UACjC;AAGF,WAAS,SAAS;AAElB,MAAI,aAAa,SAAS,WAAW,aAAa,eAAe;GAC/D,MAAM,YAAY,iBAAiB;AACjC,mBAAe;MACd,EAAE;AACL,gBAAa,gBAAgB,UAAU;;;CAI3C,MAAM,eAAe,MAA8C;EACjE,MAAM,aAAa,EAAE,cAAc,QAAQ,OAAO;AAElD,MAAI,cAEF;OAAI,kBADU,IAAI,OAAO,IAAI,aAAa,IAAI,EACnC,KAAK,WAAW,EAAE;AAC3B,MAAE,gBAAgB;AAClB;;;AAIJ,MAAI,aAAa,WAAW,SAAS,WAAW;AAC9C,KAAE,gBAAgB;AAClB,YAAS,WAAW,MAAM,GAAG,UAAU,CAAC;AACxC;;;CAIJ,MAAM,iBAAiB,MAAuC;EAC5D,MAAM,QAAQ,EAAE;EAChB,MAAM,gBAAgB,MAAM,mBAAmB;EAC/C,MAAM,cAAc,MAAM,mBAAmB,MAAM;EACnD,MAAM,UAAU,MAAM,WAAW;AAEjC,MAAI,EAAE,QAAQ,eAAe,WAAW,eAAe;AACrD,KAAE,gBAAgB;AAClB,kBAAe;AACf;;AAGF,MAAI,EAAE,QAAQ,eAAe,iBAAiB,eAAe;AAC3D,KAAE,gBAAgB;AAClB,kBAAe;AACf;;AAGF,MAAI,EAAE,QAAQ,gBAAgB,eAAe,eAAe;AAC1D,KAAE,gBAAgB;AAClB,kBAAe;AACf;;AAGF,cAAY,EAAE;;CAGhB,MAAM,eAAe,MAAoC;AACvD,IAAE,OAAO,QAAQ;AACjB,aAAW;;CAGb,MAAM,mBAAmB;AACvB,YAAU;;AAGZ,QACE,oBAAC;EACC,KAAK;EACL,MAAK;EACE;EACP,UAAU;EACV,SAAS;EACT,WAAW;EACX,SAAS;EACT,QAAQ;EACK;EACF;EACA;EACX,UAAU;EACV,OAAO,eAAe,EAAE,OAAO,GAAG,aAAa,KAAK,GAAG;EACvD,cACE,aACA,sBAAsB,iBAAiB,SAAY,eAAe,IAAI;EAExE,iBAAe;EACf,cAAa;EACb,WACE,cAAc,SAAS,MAAM,GACzB,aAAa,SAAS,SAAS,GAC7B,YACA,YACF;GAEN"}
+{"version":3,"file":"segment.js","names":[],"sources":["../../../src/components/coordinate-field/segment.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 { useMemo } from 'react';\nimport { useCoordinateFieldStateContext } from './context';\nimport type { ChangeEvent, FocusEvent, KeyboardEvent } from 'react';\nimport type { CoordinateSegmentProps } from './types';\n\n/**\n * CoordinateSegment - A controlled input component for a single coordinate segment\n *\n * This component represents one editable part of a coordinate (e.g., degrees, minutes, direction).\n * It handles character filtering, focus management, and keyboard navigation.\n *\n * Segment Types (determined by allowedChars):\n * - Numeric: \"[0-9\\\\-\\\\.]\" - for DD degrees, DDM/DMS degrees/minutes/seconds\n * - Directional: \"[NSEW]\" - for DDM/DMS direction indicators\n * - Alphanumeric: \"[0-9A-Z]\" - for MGRS/UTM zone identifiers\n *\n * @example\n * // Numeric segment (latitude degrees)\n * <CoordinateSegment\n *   value={latDegrees}\n *   onChange={setLatDegrees}\n *   allowedChars=\"[0-9\\\\-\\\\.]\"\n *   maxLength={10}\n *   placeholder=\"00.00000\"\n * />\n *\n * @example\n * // Directional segment (latitude direction)\n * <CoordinateSegment\n *   value={latDir}\n *   onChange={setLatDir}\n *   allowedChars=\"[NS]\"\n *   maxLength={1}\n *   placeholder=\"N\"\n * />\n */\nexport function CoordinateSegment({\n  value,\n  onChange,\n  onFocus,\n  onBlur,\n  onKeyDown,\n  placeholder,\n  maxLength,\n  className,\n  isDisabled,\n  isReadOnly,\n  allowedChars,\n  segmentRef,\n  segmentIndex,\n  totalSegments: _totalSegments,\n  onAutoAdvance,\n  onAutoRetreat,\n  pad,\n  ariaLabel,\n}: CoordinateSegmentProps) {\n  const contextState = useCoordinateFieldStateContext();\n\n  const effectiveIsDisabled = contextState.isDisabled ?? isDisabled;\n\n  // Calculate dynamic width based on focus state\n  const dynamicWidth = useMemo(() => {\n    if (maxLength === undefined) {\n      return undefined;\n    }\n\n    // Default padding to 0.5 if not specified\n    const padding = pad ?? 0.5;\n\n    // When blurred, use value length (or maxLength if empty) + padding\n    const contentLength = value.length > 0 ? value.length : maxLength;\n    return contentLength + padding;\n  }, [maxLength, pad, value.length]);\n\n  const handleChange = (e: ChangeEvent<HTMLInputElement>) => {\n    const newValue = e.target.value;\n\n    if (allowedChars) {\n      const regex = new RegExp(`^${allowedChars}*$`);\n      if (!regex.test(newValue)) {\n        return;\n      }\n    }\n\n    if (maxLength && newValue.length > maxLength) {\n      return;\n    }\n\n    onChange(newValue);\n\n    if (maxLength && newValue.length === maxLength && onAutoAdvance) {\n      const timeoutId = setTimeout(() => {\n        onAutoAdvance();\n      }, 0);\n      contextState.registerTimeout(timeoutId);\n    }\n  };\n\n  const handlePaste = (e: React.ClipboardEvent<HTMLInputElement>) => {\n    const pastedText = e.clipboardData.getData('text');\n\n    if (allowedChars) {\n      const regex = new RegExp(`^${allowedChars}*$`);\n      if (!regex.test(pastedText)) {\n        e.preventDefault();\n        return;\n      }\n    }\n\n    if (maxLength && pastedText.length > maxLength) {\n      e.preventDefault();\n      onChange(pastedText.slice(0, maxLength));\n      return;\n    }\n  };\n\n  const handleKeyDown = (e: KeyboardEvent<HTMLInputElement>) => {\n    const input = e.currentTarget;\n    const cursorAtStart = input.selectionStart === 0;\n    const cursorAtEnd = input.selectionStart === value.length;\n    const isEmpty = value.length === 0;\n\n    if (e.key === 'Backspace' && isEmpty && onAutoRetreat) {\n      e.preventDefault();\n      onAutoRetreat();\n      return;\n    }\n\n    if (e.key === 'ArrowLeft' && cursorAtStart && onAutoRetreat) {\n      e.preventDefault();\n      onAutoRetreat();\n      return;\n    }\n\n    if (e.key === 'ArrowRight' && cursorAtEnd && onAutoAdvance) {\n      e.preventDefault();\n      onAutoAdvance();\n      return;\n    }\n\n    onKeyDown?.(e);\n  };\n\n  const handleFocus = (e: FocusEvent<HTMLInputElement>) => {\n    e.target.select();\n    onFocus?.();\n  };\n\n  const handleBlur = () => {\n    onBlur?.();\n  };\n\n  return (\n    <input\n      readOnly={isReadOnly}\n      ref={segmentRef}\n      tabIndex={isReadOnly ? -1 : 0}\n      type='text'\n      value={value}\n      onChange={handleChange}\n      onPaste={handlePaste}\n      onKeyDown={handleKeyDown}\n      onFocus={handleFocus}\n      onBlur={handleBlur}\n      placeholder={placeholder}\n      maxLength={maxLength}\n      className={className}\n      disabled={effectiveIsDisabled}\n      style={dynamicWidth ? { width: `${dynamicWidth}ch` } : undefined}\n      aria-label={\n        ariaLabel ||\n        `Coordinate segment ${segmentIndex !== undefined ? segmentIndex + 1 : ''}`\n      }\n      aria-disabled={effectiveIsDisabled}\n      autoComplete='off'\n      inputMode={\n        allowedChars?.includes('0-9')\n          ? allowedChars.includes('\\\\-\\\\.')\n            ? 'decimal'\n            : 'numeric'\n          : 'text'\n      }\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,SAAgB,kBAAkB,EAChC,OACA,UACA,SACA,QACA,WACA,aACA,WACA,WACA,YACA,YACA,cACA,YACA,cACA,eAAe,gBACf,eACA,eACA,KACA,aACyB;CACzB,MAAM,eAAe,gCAAgC;CAErD,MAAM,sBAAsB,aAAa,cAAc;CAGvD,MAAM,eAAe,cAAc;AACjC,MAAI,cAAc,OAChB;EAIF,MAAM,UAAU,OAAO;AAIvB,UADsB,MAAM,SAAS,IAAI,MAAM,SAAS,aACjC;IACtB;EAAC;EAAW;EAAK,MAAM;EAAO,CAAC;CAElC,MAAM,gBAAgB,MAAqC;EACzD,MAAM,WAAW,EAAE,OAAO;AAE1B,MAAI,cAEF;OAAI,kBADU,IAAI,OAAO,IAAI,aAAa,IAAI,EACnC,KAAK,SAAS,CACvB;;AAIJ,MAAI,aAAa,SAAS,SAAS,UACjC;AAGF,WAAS,SAAS;AAElB,MAAI,aAAa,SAAS,WAAW,aAAa,eAAe;GAC/D,MAAM,YAAY,iBAAiB;AACjC,mBAAe;MACd,EAAE;AACL,gBAAa,gBAAgB,UAAU;;;CAI3C,MAAM,eAAe,MAA8C;EACjE,MAAM,aAAa,EAAE,cAAc,QAAQ,OAAO;AAElD,MAAI,cAEF;OAAI,kBADU,IAAI,OAAO,IAAI,aAAa,IAAI,EACnC,KAAK,WAAW,EAAE;AAC3B,MAAE,gBAAgB;AAClB;;;AAIJ,MAAI,aAAa,WAAW,SAAS,WAAW;AAC9C,KAAE,gBAAgB;AAClB,YAAS,WAAW,MAAM,GAAG,UAAU,CAAC;AACxC;;;CAIJ,MAAM,iBAAiB,MAAuC;EAC5D,MAAM,QAAQ,EAAE;EAChB,MAAM,gBAAgB,MAAM,mBAAmB;EAC/C,MAAM,cAAc,MAAM,mBAAmB,MAAM;EACnD,MAAM,UAAU,MAAM,WAAW;AAEjC,MAAI,EAAE,QAAQ,eAAe,WAAW,eAAe;AACrD,KAAE,gBAAgB;AAClB,kBAAe;AACf;;AAGF,MAAI,EAAE,QAAQ,eAAe,iBAAiB,eAAe;AAC3D,KAAE,gBAAgB;AAClB,kBAAe;AACf;;AAGF,MAAI,EAAE,QAAQ,gBAAgB,eAAe,eAAe;AAC1D,KAAE,gBAAgB;AAClB,kBAAe;AACf;;AAGF,cAAY,EAAE;;CAGhB,MAAM,eAAe,MAAoC;AACvD,IAAE,OAAO,QAAQ;AACjB,aAAW;;CAGb,MAAM,mBAAmB;AACvB,YAAU;;AAGZ,QACE,oBAAC;EACC,UAAU;EACV,KAAK;EACL,UAAU,aAAa,KAAK;EAC5B,MAAK;EACE;EACP,UAAU;EACV,SAAS;EACT,WAAW;EACX,SAAS;EACT,QAAQ;EACK;EACF;EACA;EACX,UAAU;EACV,OAAO,eAAe,EAAE,OAAO,GAAG,aAAa,KAAK,GAAG;EACvD,cACE,aACA,sBAAsB,iBAAiB,SAAY,eAAe,IAAI;EAExE,iBAAe;EACf,cAAa;EACb,WACE,cAAc,SAAS,MAAM,GACzB,aAAa,SAAS,SAAS,GAC7B,YACA,YACF;GAEN"}

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

@@ -41,6 +41,10 @@
     @variant hover {
       @apply outline-interactive-hover;
     }
+
+    @variant read-only {
+      @apply px-0 outline-none;
+    }
   }
 
   .input {
@@ -73,6 +77,16 @@
     @variant selection {
       @apply fg-a11y-on-accent bg-accent-primary-bold;
     }
+
+    @variant read-only {
+      @variant focus-visible {
+        @apply bg-surface-default;
+      }
+
+      @variant selection {
+        @apply bg-surface-default;
+      }
+    }
   }
 
   .segmentGroup {

package/dist/components/coordinate-field/types.d.ts

@@ -117,6 +117,8 @@ type CoordinateSegmentProps = {
   className?: string;
   /** Whether the segment is disabled */
   isDisabled?: boolean;
+  /** Whether the segment is read-only */
+  isReadOnly?: boolean;
   /** Regex pattern for allowed characters (e.g., "[0-9\\-\\.]" for numeric, "[NSEW]" for directional) */
   allowedChars?: string;
   /** Ref to the input element for programmatic focus management */

package/dist/components/coordinate-field/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":["COORDINATE_FORMAT_LABELS: Record<CoordinateSystem, string>","COORDINATE_FORMAT_NAMES: Record<CoordinateSystem, string>","COORDINATE_SYSTEMS: readonly CoordinateSystem[]"],"sources":["../../../src/components/coordinate-field/types.ts"],"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 type {\n  Dispatch,\n  KeyboardEvent,\n  RefAttributes,\n  SetStateAction,\n} from 'react';\nimport type {\n  TextFieldProps as AriaTextFieldProps,\n  FieldErrorProps,\n  LabelProps,\n} from 'react-aria-components';\n\n/**\n * Supported coordinate systems for display and input\n */\nexport type CoordinateSystem = 'dd' | 'ddm' | 'dms' | 'mgrs' | 'utm';\n\n/**\n * Short labels for coordinate formats (used in popover)\n */\nexport const COORDINATE_FORMAT_LABELS: Record<CoordinateSystem, string> = {\n  dd: 'DD',\n  ddm: 'DDM',\n  dms: 'DMS',\n  mgrs: 'MGRS',\n  utm: 'UTM',\n};\n\n/**\n * Full names for coordinate formats (used in popover titles/descriptions)\n */\nexport const COORDINATE_FORMAT_NAMES: Record<CoordinateSystem, string> = {\n  dd: 'Decimal Degrees',\n  ddm: 'Degrees Decimal Minutes',\n  dms: 'Degrees Minutes Seconds',\n  mgrs: 'Military Grid Reference System',\n  utm: 'Universal Transverse Mercator',\n};\n\n/**\n * All supported coordinate systems\n * Use this constant instead of hardcoding the array in multiple places\n */\nexport const COORDINATE_SYSTEMS: readonly CoordinateSystem[] = [\n  'dd',\n  'dms',\n  'ddm',\n  'mgrs',\n  'utm',\n] as const;\n\n/**\n * Coordinate value in Decimal Degrees format (internal representation)\n * All coordinate values are normalized to this format internally\n */\nexport type CoordinateValue = {\n  lat: number; // Latitude in decimal degrees (-90 to 90)\n  lon: number; // Longitude in decimal degrees (-180 to 180)\n};\n\n/**\n * Types of segments in a coordinate input\n */\nexport type SegmentType =\n  | 'numeric'\n  | 'directional'\n  | 'literal'\n  | 'alphanumeric';\n\n/**\n * Configuration for a single coordinate segment\n */\nexport type SegmentConfig = {\n  type: SegmentType;\n  /** Placeholder text shown when segment is empty */\n  placeholder?: string;\n  /** Maximum character length for the segment */\n  maxLength?: number;\n  /** Regex pattern for allowed characters */\n  allowedChars?: string;\n  /** Fixed value for literal segments (e.g., \", \" or \"º\") */\n  value?: string;\n  /** Padding in CSS 'ch' units to add to the segment width (defaults to 0.5 if not specified) */\n  pad?: number;\n};\n\n/**\n * Result of parsing a pasted coordinate string\n */\nexport type ParsedCoordinateMatch = {\n  /** The coordinate system format that matched */\n  format: CoordinateSystem;\n  /** The coordinate value in DD format */\n  value: CoordinateValue;\n  /** Display string in the matched format */\n  displayString: string;\n};\n\n/**\n * State shared with child components through context\n */\nexport type CoordinateFieldState = {\n  segmentValues: string[];\n  format: CoordinateFieldProps['format'];\n  /**\n   * Current coordinate value in DD format\n   * - undefined: uncontrolled mode with no default value\n   * - null: controlled mode with empty/invalid value\n   * - CoordinateValue: valid coordinate\n   */\n  currentValue?: CoordinateValue | null;\n  /** Validation errors from @accelint/geo */\n  validationErrors: string[];\n  isDisabled: boolean;\n  isInvalid: boolean;\n  isRequired: boolean;\n  /** Size variant of the field */\n  size: CoordinateFieldProps['size'];\n  /** Whether or not the logical coordinate fields are inlined or stacked */\n  variant: CoordinateFieldProps['variant'];\n  /** Function to register timeouts for cleanup on unmount */\n  registerTimeout: (timeoutId: NodeJS.Timeout) => void;\n};\n\n/**\n * Props for the CoordinateSegment component\n */\nexport type CoordinateSegmentProps = {\n  /** Current value of the segment */\n  value: string;\n  /** Callback when the segment value changes */\n  onChange: (value: string) => void;\n  /** Callback when the segment receives focus */\n  onFocus?: () => void;\n  /** Callback when the segment loses focus */\n  onBlur?: () => void;\n  /** Callback for keyboard events (used for navigation between segments) */\n  onKeyDown?: (e: KeyboardEvent<HTMLInputElement>) => void;\n  /** Placeholder text to display when segment is empty */\n  placeholder?: string;\n  /** Maximum character length for the segment */\n  maxLength?: number;\n  /** Custom className for styling */\n  className?: string;\n  /** Whether the segment is disabled */\n  isDisabled?: boolean;\n  /** Regex pattern for allowed characters (e.g., \"[0-9\\\\-\\\\.]\" for numeric, \"[NSEW]\" for directional) */\n  allowedChars?: string;\n  /** Ref to the input element for programmatic focus management */\n  segmentRef?: React.RefObject<HTMLInputElement>;\n  /** Index of this segment in the parent field (for accessibility) */\n  segmentIndex?: number;\n  /** Total number of segments (for accessibility) */\n  totalSegments?: number;\n  /** Callback to trigger auto-advance to next segment */\n  onAutoAdvance?: () => void;\n  /** Callback to trigger auto-retreat to previous segment */\n  onAutoRetreat?: () => void;\n  /** Padding in CSS 'ch' units to add to the segment width (defaults to 0.5 if not specified) */\n  pad?: number;\n  /** Semantic accessibility label for the segment (e.g., \"Latitude degrees\") */\n  ariaLabel?: string;\n};\n\n/**\n * Props for the CoordinateField component\n *\n * Extends AriaTextFieldProps to inherit standard form field props (id, isDisabled, isRequired, etc.)\n */\nexport type CoordinateFieldProps = Omit<\n  AriaTextFieldProps,\n  | 'children'\n  | 'className'\n  | 'placeholder'\n  | 'type'\n  | 'pattern'\n  | 'value'\n  | 'defaultValue'\n  | 'onChange'\n  | 'name' // Not applicable to multi-segment fields\n> &\n  RefAttributes<HTMLDivElement> & {\n    /**\n     * Custom class names for component slots\n     */\n    classNames?: {\n      field?: string;\n      label?: LabelProps['className'];\n      control?: string;\n      input?: string;\n      segment?: string;\n      description?: string;\n      error?: FieldErrorProps['className'];\n      formatButton?: string;\n    };\n\n    /**\n     * Label text displayed above the input (medium size only)\n     */\n    label?: string;\n\n    /**\n     * Helper text displayed below the input\n     */\n    description?: string;\n\n    /**\n     * Error message to display when the field is invalid\n     */\n    errorMessage?: string;\n\n    /**\n     * Display format for coordinate input\n     * @default 'dd' (Decimal Degrees)\n     */\n    format?: CoordinateSystem;\n\n    /**\n     * Size variant of the field\n     * @default 'medium'\n     */\n    size?: 'small' | 'medium';\n\n    /**\n     * Whether to show the format button for copying coordinates in different formats\n     * @default true\n     */\n    showFormatButton?: boolean;\n\n    /**\n     * Controlled value in Decimal Degrees format\n     * - undefined: uncontrolled mode\n     * - null: controlled mode with no/invalid value\n     * - CoordinateValue: controlled mode with valid value\n     */\n    value?: CoordinateValue | null;\n\n    /**\n     * Whether or not the input is stacked or inline\n     * @default 'inline'\n     */\n    variant?: 'inline' | 'stacked';\n\n    /**\n     * Default uncontrolled value in Decimal Degrees format\n     */\n    defaultValue?: CoordinateValue;\n\n    /**\n     * Callback fired when the coordinate value changes\n     * @param value - The new coordinate value in DD format, or null if invalid\n     */\n    onChange?:\n      | Dispatch<SetStateAction<CoordinateValue | null>>\n      | ((value: CoordinateValue | null) => void);\n\n    /**\n     * Callback fired when validation or paste errors occur\n     * @param message - Error message (\"Invalid coordinate value\" for validation errors, \"Invalid coordinate format\" for paste errors)\n     * @param context - Additional context about the error:\n     *   - Validation errors: `{ errors: string[], format: string, segments: string[] }`\n     *   - Paste errors: `{ pastedText: string }`\n     */\n    onError?: (message: string, context?: Record<string, unknown>) => void;\n  };\n"],"mappings":";;;;;;;;;;;;;;;;;AAgCA,MAAaA,2BAA6D;CACxE,IAAI;CACJ,KAAK;CACL,KAAK;CACL,MAAM;CACN,KAAK;CACN;;;;AAKD,MAAaC,0BAA4D;CACvE,IAAI;CACJ,KAAK;CACL,KAAK;CACL,MAAM;CACN,KAAK;CACN;;;;;AAMD,MAAaC,qBAAkD;CAC7D;CACA;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"types.js","names":["COORDINATE_FORMAT_LABELS: Record<CoordinateSystem, string>","COORDINATE_FORMAT_NAMES: Record<CoordinateSystem, string>","COORDINATE_SYSTEMS: readonly CoordinateSystem[]"],"sources":["../../../src/components/coordinate-field/types.ts"],"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 type {\n  Dispatch,\n  KeyboardEvent,\n  RefAttributes,\n  SetStateAction,\n} from 'react';\nimport type {\n  TextFieldProps as AriaTextFieldProps,\n  FieldErrorProps,\n  LabelProps,\n} from 'react-aria-components';\n\n/**\n * Supported coordinate systems for display and input\n */\nexport type CoordinateSystem = 'dd' | 'ddm' | 'dms' | 'mgrs' | 'utm';\n\n/**\n * Short labels for coordinate formats (used in popover)\n */\nexport const COORDINATE_FORMAT_LABELS: Record<CoordinateSystem, string> = {\n  dd: 'DD',\n  ddm: 'DDM',\n  dms: 'DMS',\n  mgrs: 'MGRS',\n  utm: 'UTM',\n};\n\n/**\n * Full names for coordinate formats (used in popover titles/descriptions)\n */\nexport const COORDINATE_FORMAT_NAMES: Record<CoordinateSystem, string> = {\n  dd: 'Decimal Degrees',\n  ddm: 'Degrees Decimal Minutes',\n  dms: 'Degrees Minutes Seconds',\n  mgrs: 'Military Grid Reference System',\n  utm: 'Universal Transverse Mercator',\n};\n\n/**\n * All supported coordinate systems\n * Use this constant instead of hardcoding the array in multiple places\n */\nexport const COORDINATE_SYSTEMS: readonly CoordinateSystem[] = [\n  'dd',\n  'dms',\n  'ddm',\n  'mgrs',\n  'utm',\n] as const;\n\n/**\n * Coordinate value in Decimal Degrees format (internal representation)\n * All coordinate values are normalized to this format internally\n */\nexport type CoordinateValue = {\n  lat: number; // Latitude in decimal degrees (-90 to 90)\n  lon: number; // Longitude in decimal degrees (-180 to 180)\n};\n\n/**\n * Types of segments in a coordinate input\n */\nexport type SegmentType =\n  | 'numeric'\n  | 'directional'\n  | 'literal'\n  | 'alphanumeric';\n\n/**\n * Configuration for a single coordinate segment\n */\nexport type SegmentConfig = {\n  type: SegmentType;\n  /** Placeholder text shown when segment is empty */\n  placeholder?: string;\n  /** Maximum character length for the segment */\n  maxLength?: number;\n  /** Regex pattern for allowed characters */\n  allowedChars?: string;\n  /** Fixed value for literal segments (e.g., \", \" or \"º\") */\n  value?: string;\n  /** Padding in CSS 'ch' units to add to the segment width (defaults to 0.5 if not specified) */\n  pad?: number;\n};\n\n/**\n * Result of parsing a pasted coordinate string\n */\nexport type ParsedCoordinateMatch = {\n  /** The coordinate system format that matched */\n  format: CoordinateSystem;\n  /** The coordinate value in DD format */\n  value: CoordinateValue;\n  /** Display string in the matched format */\n  displayString: string;\n};\n\n/**\n * State shared with child components through context\n */\nexport type CoordinateFieldState = {\n  segmentValues: string[];\n  format: CoordinateFieldProps['format'];\n  /**\n   * Current coordinate value in DD format\n   * - undefined: uncontrolled mode with no default value\n   * - null: controlled mode with empty/invalid value\n   * - CoordinateValue: valid coordinate\n   */\n  currentValue?: CoordinateValue | null;\n  /** Validation errors from @accelint/geo */\n  validationErrors: string[];\n  isDisabled: boolean;\n  isInvalid: boolean;\n  isRequired: boolean;\n  /** Size variant of the field */\n  size: CoordinateFieldProps['size'];\n  /** Whether or not the logical coordinate fields are inlined or stacked */\n  variant: CoordinateFieldProps['variant'];\n  /** Function to register timeouts for cleanup on unmount */\n  registerTimeout: (timeoutId: NodeJS.Timeout) => void;\n};\n\n/**\n * Props for the CoordinateSegment component\n */\nexport type CoordinateSegmentProps = {\n  /** Current value of the segment */\n  value: string;\n  /** Callback when the segment value changes */\n  onChange: (value: string) => void;\n  /** Callback when the segment receives focus */\n  onFocus?: () => void;\n  /** Callback when the segment loses focus */\n  onBlur?: () => void;\n  /** Callback for keyboard events (used for navigation between segments) */\n  onKeyDown?: (e: KeyboardEvent<HTMLInputElement>) => void;\n  /** Placeholder text to display when segment is empty */\n  placeholder?: string;\n  /** Maximum character length for the segment */\n  maxLength?: number;\n  /** Custom className for styling */\n  className?: string;\n  /** Whether the segment is disabled */\n  isDisabled?: boolean;\n  /** Whether the segment is read-only */\n  isReadOnly?: boolean;\n  /** Regex pattern for allowed characters (e.g., \"[0-9\\\\-\\\\.]\" for numeric, \"[NSEW]\" for directional) */\n  allowedChars?: string;\n  /** Ref to the input element for programmatic focus management */\n  segmentRef?: React.RefObject<HTMLInputElement>;\n  /** Index of this segment in the parent field (for accessibility) */\n  segmentIndex?: number;\n  /** Total number of segments (for accessibility) */\n  totalSegments?: number;\n  /** Callback to trigger auto-advance to next segment */\n  onAutoAdvance?: () => void;\n  /** Callback to trigger auto-retreat to previous segment */\n  onAutoRetreat?: () => void;\n  /** Padding in CSS 'ch' units to add to the segment width (defaults to 0.5 if not specified) */\n  pad?: number;\n  /** Semantic accessibility label for the segment (e.g., \"Latitude degrees\") */\n  ariaLabel?: string;\n};\n\n/**\n * Props for the CoordinateField component\n *\n * Extends AriaTextFieldProps to inherit standard form field props (id, isDisabled, isRequired, etc.)\n */\nexport type CoordinateFieldProps = Omit<\n  AriaTextFieldProps,\n  | 'children'\n  | 'className'\n  | 'placeholder'\n  | 'type'\n  | 'pattern'\n  | 'value'\n  | 'defaultValue'\n  | 'onChange'\n  | 'name' // Not applicable to multi-segment fields\n> &\n  RefAttributes<HTMLDivElement> & {\n    /**\n     * Custom class names for component slots\n     */\n    classNames?: {\n      field?: string;\n      label?: LabelProps['className'];\n      control?: string;\n      input?: string;\n      segment?: string;\n      description?: string;\n      error?: FieldErrorProps['className'];\n      formatButton?: string;\n    };\n\n    /**\n     * Label text displayed above the input (medium size only)\n     */\n    label?: string;\n\n    /**\n     * Helper text displayed below the input\n     */\n    description?: string;\n\n    /**\n     * Error message to display when the field is invalid\n     */\n    errorMessage?: string;\n\n    /**\n     * Display format for coordinate input\n     * @default 'dd' (Decimal Degrees)\n     */\n    format?: CoordinateSystem;\n\n    /**\n     * Size variant of the field\n     * @default 'medium'\n     */\n    size?: 'small' | 'medium';\n\n    /**\n     * Whether to show the format button for copying coordinates in different formats\n     * @default true\n     */\n    showFormatButton?: boolean;\n\n    /**\n     * Controlled value in Decimal Degrees format\n     * - undefined: uncontrolled mode\n     * - null: controlled mode with no/invalid value\n     * - CoordinateValue: controlled mode with valid value\n     */\n    value?: CoordinateValue | null;\n\n    /**\n     * Whether or not the input is stacked or inline\n     * @default 'inline'\n     */\n    variant?: 'inline' | 'stacked';\n\n    /**\n     * Default uncontrolled value in Decimal Degrees format\n     */\n    defaultValue?: CoordinateValue;\n\n    /**\n     * Callback fired when the coordinate value changes\n     * @param value - The new coordinate value in DD format, or null if invalid\n     */\n    onChange?:\n      | Dispatch<SetStateAction<CoordinateValue | null>>\n      | ((value: CoordinateValue | null) => void);\n\n    /**\n     * Callback fired when validation or paste errors occur\n     * @param message - Error message (\"Invalid coordinate value\" for validation errors, \"Invalid coordinate format\" for paste errors)\n     * @param context - Additional context about the error:\n     *   - Validation errors: `{ errors: string[], format: string, segments: string[] }`\n     *   - Paste errors: `{ pastedText: string }`\n     */\n    onError?: (message: string, context?: Record<string, unknown>) => void;\n  };\n"],"mappings":";;;;;;;;;;;;;;;;;AAgCA,MAAaA,2BAA6D;CACxE,IAAI;CACJ,KAAK;CACL,KAAK;CACL,MAAM;CACN,KAAK;CACN;;;;AAKD,MAAaC,0BAA4D;CACvE,IAAI;CACJ,KAAK;CACL,KAAK;CACL,MAAM;CACN,KAAK;CACN;;;;;AAMD,MAAaC,qBAAkD;CAC7D;CACA;CACA;CACA;CACA;CACD"}

package/dist/components/date-field/index.d.ts

@@ -12,7 +12,7 @@
 
 import { DateFieldProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime35 from "react/jsx-runtime";
+import * as react_jsx_runtime71 from "react/jsx-runtime";
 import { DateValue } from "@internationalized/date";
 
 //#region src/components/date-field/index.d.ts
@@ -73,8 +73,9 @@ declare function DateField<T extends DateValue>({
   isDisabled,
   isInvalid: isInvalidProp,
   isRequired,
+  isReadOnly,
   ...rest
-}: DateFieldProps<T>): react_jsx_runtime35.JSX.Element;
+}: DateFieldProps<T>): react_jsx_runtime71.JSX.Element;
 //#endregion
 export { DateField };
 //# sourceMappingURL=index.d.ts.map