@cdx-ui/primitives 0.0.1-beta.17 → 0.0.1-beta.171

package/lib/module/month-picker/MonthPickerRoot.js

@@ -0,0 +1,114 @@
+"use strict";
+
+import { forwardRef, useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { View } from 'react-native';
+import { resolveDateComponentLabels } from '@cdx-ui/formatters';
+import { mergeRefs, useControllableState } from '@cdx-ui/utils';
+import { DateFieldRoot } from '../date-field/DateFieldRoot';
+import { Slot } from '../slot';
+import { dataAttributes, mergeDataAttributes } from '../utils/dataAttributes';
+import { MonthPickerContext } from './context';
+import { jsx as _jsx } from "react/jsx-runtime";
+export const MonthPickerRoot = /*#__PURE__*/forwardRef(({
+  asChild,
+  children,
+  value: valueProp,
+  defaultValue,
+  onValueChange,
+  isOpen: openProp,
+  defaultOpen = false,
+  onOpenChange,
+  isDisabled: disabled = false,
+  isReadOnly,
+  isInvalid,
+  isRequired,
+  minValue,
+  maxValue,
+  locale = 'en-US',
+  labels: labelsProp,
+  ...props
+}, ref) => {
+  const labels = useMemo(() => resolveDateComponentLabels(labelsProp), [labelsProp]);
+  const [value, setValue] = useControllableState({
+    prop: valueProp,
+    defaultProp: defaultValue,
+    onChange: onValueChange
+  });
+  const [open, setOpenState] = useControllableState({
+    prop: openProp,
+    defaultProp: defaultOpen,
+    onChange: onOpenChange
+  });
+  const [draftValue, setDraftValue] = useState(value);
+  const surfacesRef = useRef(new Set());
+  const anchorRef = useRef(null);
+  const triggerRef = useRef(null);
+  const setOpen = useCallback(next => {
+    if (disabled && next) {
+      return;
+    }
+    if (next) {
+      setDraftValue(value);
+    }
+    setOpenState(next);
+  }, [disabled, setOpenState, value]);
+  const registerSurface = useCallback(type => {
+    if (surfacesRef.current.has(type)) {
+      return;
+    }
+    surfacesRef.current.add(type);
+    if (surfacesRef.current.size > 1) {
+      console.warn('[Forge UI] MonthPicker: multiple presentation surfaces detected. Use only one of Popover, Dialog, or BottomSheet.');
+    }
+  }, []);
+  useEffect(() => {
+    setDraftValue(value);
+  }, [value]);
+  useEffect(() => {
+    if (!open) {
+      surfacesRef.current.clear();
+    }
+  }, [open]);
+  const contextValue = useMemo(() => ({
+    value,
+    onValueChange: setValue,
+    draftValue,
+    setDraftValue,
+    open: open ?? false,
+    setOpen,
+    disabled,
+    minValue,
+    maxValue,
+    locale,
+    labels,
+    registerSurface,
+    anchorRef,
+    triggerRef
+  }), [value, setValue, draftValue, open, setOpen, disabled, minValue, maxValue, locale, labels, registerSurface]);
+  const Comp = asChild ? Slot : View;
+  return /*#__PURE__*/_jsx(MonthPickerContext.Provider, {
+    value: contextValue,
+    children: /*#__PURE__*/_jsx(Comp, {
+      ref: mergeRefs(ref, anchorRef),
+      ...props,
+      ...mergeDataAttributes(props, dataAttributes({
+        disabled,
+        open
+      })),
+      children: /*#__PURE__*/_jsx(DateFieldRoot, {
+        value: value,
+        onValueChange: next => setValue(next),
+        mode: "month",
+        locale: locale,
+        labels: labelsProp,
+        isDisabled: disabled,
+        isReadOnly: isReadOnly,
+        isInvalid: isInvalid,
+        isRequired: isRequired,
+        children: children
+      })
+    })
+  });
+});
+MonthPickerRoot.displayName = 'MonthPickerRoot';
+//# sourceMappingURL=MonthPickerRoot.js.map

package/lib/module/month-picker/MonthPickerRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["forwardRef","useCallback","useEffect","useMemo","useRef","useState","View","resolveDateComponentLabels","mergeRefs","useControllableState","DateFieldRoot","Slot","dataAttributes","mergeDataAttributes","MonthPickerContext","jsx","_jsx","MonthPickerRoot","asChild","children","value","valueProp","defaultValue","onValueChange","isOpen","openProp","defaultOpen","onOpenChange","isDisabled","disabled","isReadOnly","isInvalid","isRequired","minValue","maxValue","locale","labels","labelsProp","props","ref","setValue","prop","defaultProp","onChange","open","setOpenState","draftValue","setDraftValue","surfacesRef","Set","anchorRef","triggerRef","setOpen","next","registerSurface","type","current","has","add","size","console","warn","clear","contextValue","Comp","Provider","mode","displayName"],"sourceRoot":"../../../src","sources":["month-picker/MonthPickerRoot.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/month-picker/context.js

@@ -0,0 +1,12 @@
+"use strict";
+
+import { createContext, useContext } from 'react';
+export const MonthPickerContext = /*#__PURE__*/createContext(null);
+export function useMonthPickerContext() {
+  const ctx = useContext(MonthPickerContext);
+  if (!ctx) {
+    throw new Error('MonthPicker compound components must be used within MonthPickerRoot');
+  }
+  return ctx;
+}
+//# sourceMappingURL=context.js.map

package/lib/module/month-picker/context.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createContext","useContext","MonthPickerContext","useMonthPickerContext","ctx","Error"],"sourceRoot":"../../../src","sources":["month-picker/context.tsx"],"mappings":";;AAAA,SAASA,aAAa,EAAEC,UAAU,QAAwB,OAAO;AAsBjE,OAAO,MAAMC,kBAAkB,gBAAGF,aAAa,CAAiC,IAAI,CAAC;AAErF,OAAO,SAASG,qBAAqBA,CAAA,EAA4B;EAC/D,MAAMC,GAAG,GAAGH,UAAU,CAACC,kBAAkB,CAAC;EAC1C,IAAI,CAACE,GAAG,EAAE;IACR,MAAM,IAAIC,KAAK,CAAC,qEAAqE,CAAC;EACxF;EACA,OAAOD,GAAG;AACZ","ignoreList":[]}

package/lib/module/month-picker/index.js

@@ -0,0 +1,5 @@
+"use strict";
+
+export { MonthPickerRoot } from './MonthPickerRoot';
+export { MonthPickerContext, useMonthPickerContext } from './context';
+//# sourceMappingURL=index.js.map

package/lib/module/month-picker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MonthPickerRoot","MonthPickerContext","useMonthPickerContext"],"sourceRoot":"../../../src","sources":["month-picker/index.ts"],"mappings":";;AAAA,SAASA,eAAe,QAAQ,mBAAmB;AAEnD,SAASC,kBAAkB,EAAEC,qBAAqB,QAAsC,WAAW","ignoreList":[]}

package/lib/module/otp-input/OtpInputField.js

@@ -0,0 +1,116 @@
+"use strict";
+
+import { forwardRef, useMemo } from 'react';
+import { Platform, TextInput } from 'react-native';
+import { mergeRefs } from '@cdx-ui/utils';
+import { Slot } from '../slot';
+import { useOtpCellIndexContext, useOtpInputContext } from './context';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Concrete per-cell TextInput primitive for OTP input.
+ *
+ * Reads OtpInput context (state machine) and OtpCellIndex context (position) to
+ * wire ref registration, accessibility labels, autofill hints, and key-press/
+ * change-text handlers. Renders a `TextInput` by default; supports `asChild` via
+ * `Slot` for element substitution (Standard 2).
+ *
+ * Standards mapping:
+ *   - Standard 3 #1 — behavioral state (ref registration, focus, change handling).
+ *   - Standard 3 #2 — non-host a11y (computed accessibilityLabel, SMS autofill).
+ */
+export const OtpInputField = /*#__PURE__*/forwardRef((props, ref) => {
+  const {
+    asChild,
+    ...restProps
+  } = props;
+  const {
+    cellIndex
+  } = useOtpCellIndexContext();
+  const {
+    value,
+    cellCount,
+    isDisabled,
+    isReadOnly,
+    smsOtpAutofill,
+    getCellProps,
+    cellTestIdPrefix,
+    rootAccessibilityLabel,
+    setFieldRef,
+    handleFieldChange,
+    handleFieldKeyPress
+  } = useOtpInputContext();
+  const char = cellIndex < value.length ? value[cellIndex] ?? '' : '';
+  const extra = getCellProps?.(cellIndex) ?? {};
+  const accessibilityLabel = useMemo(() => {
+    const fromExtra = extra.accessibilityLabel;
+    if (typeof fromExtra === 'string' && fromExtra !== '') {
+      return fromExtra;
+    }
+    if (rootAccessibilityLabel) {
+      return `${rootAccessibilityLabel}, ${String(cellIndex + 1)} of ${String(cellCount)}`;
+    }
+    return `OTP digit ${String(cellIndex + 1)} of ${String(cellCount)}`;
+  }, [cellCount, cellIndex, extra.accessibilityLabel, rootAccessibilityLabel]);
+  const autofillProps = useMemo(() => {
+    if (!smsOtpAutofill || cellIndex !== 0) {
+      return {};
+    }
+    return Platform.select({
+      web: {
+        autoComplete: 'one-time-code'
+      },
+      ios: {
+        textContentType: 'oneTimeCode'
+      },
+      android: {
+        autoComplete: 'sms-otp'
+      },
+      default: {}
+    });
+  }, [cellIndex, smsOtpAutofill]);
+  const editable = !(isDisabled || isReadOnly);
+  const {
+    style: extraStyle,
+    accessibilityLabel: _omitExtraA11y,
+    ...extraRest
+  } = extra;
+  void _omitExtraA11y;
+  const {
+    style: incomingStyle,
+    value: _omitValue,
+    defaultValue: _omitDefault,
+    onChangeText: _omitOnChange,
+    ...incomingRest
+  } = restProps;
+  void _omitValue;
+  void _omitDefault;
+  void _omitOnChange;
+  const Comp = asChild ? Slot : TextInput;
+  return /*#__PURE__*/_jsx(Comp, {
+    ref: mergeRefs(ref, el => {
+      setFieldRef(cellIndex, el);
+    }),
+    accessibilityLabel: accessibilityLabel,
+    "aria-label": accessibilityLabel,
+    accessible: true,
+    autoFocus: cellIndex === 0 && editable && value.length === 0,
+    editable: editable,
+    keyboardType: "number-pad",
+    returnKeyType: "done",
+    selectTextOnFocus: true,
+    testID: cellTestIdPrefix ? `${cellTestIdPrefix}:${String(cellIndex)}:textField:changeText` : undefined,
+    value: char,
+    onChangeText: text => {
+      handleFieldChange(cellIndex, text);
+    },
+    onKeyPress: e => {
+      handleFieldKeyPress(cellIndex, e.nativeEvent.key);
+    },
+    ...autofillProps,
+    ...extraRest,
+    ...incomingRest,
+    style: [extraStyle, incomingStyle]
+  });
+});
+OtpInputField.displayName = 'OtpInputField';
+//# sourceMappingURL=OtpInputField.js.map

package/lib/module/otp-input/OtpInputField.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["forwardRef","useMemo","Platform","TextInput","mergeRefs","Slot","useOtpCellIndexContext","useOtpInputContext","jsx","_jsx","OtpInputField","props","ref","asChild","restProps","cellIndex","value","cellCount","isDisabled","isReadOnly","smsOtpAutofill","getCellProps","cellTestIdPrefix","rootAccessibilityLabel","setFieldRef","handleFieldChange","handleFieldKeyPress","char","length","extra","accessibilityLabel","fromExtra","String","autofillProps","select","web","autoComplete","ios","textContentType","android","default","editable","style","extraStyle","_omitExtraA11y","extraRest","incomingStyle","_omitValue","defaultValue","_omitDefault","onChangeText","_omitOnChange","incomingRest","Comp","el","accessible","autoFocus","keyboardType","returnKeyType","selectTextOnFocus","testID","undefined","text","onKeyPress","e","nativeEvent","key","displayName"],"sourceRoot":"../../../src","sources":["otp-input/OtpInputField.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/otp-input/index.js

@@ -1,20 +1,8 @@
 "use strict";
 
-import { createOtpInputCell } from './createOtpInputCell';
-import { createOtpInputField } from './createOtpInputField';
-import { createOtpInputRoot } from './createOtpInputRoot';
 export { applyOtpInputChange } from './utils/applyValueChange';
 export { filterAllowedCharacters, filterByRegExp, filterDigits } from './utils/filterValue';
-export function createOtpInput(BaseComponents) {
-  const Cell = createOtpInputCell(BaseComponents.Cell);
-  const Field = createOtpInputField(BaseComponents.Field);
-  const Root = createOtpInputRoot(BaseComponents.Root, Cell, Field);
-  Root.displayName = 'OtpInputPrimitive';
-  Cell.displayName = 'OtpInputPrimitive.Cell';
-  Field.displayName = 'OtpInputPrimitive.Field';
-  return Object.assign(Root, {
-    Cell,
-    Field
-  });
-}
+export { OtpInputField } from './OtpInputField';
+export { useOtpInput } from './useOtpInput';
+export { OtpInputProvider, useOtpInputContext, OtpCellIndexProvider, useOtpCellIndexContext } from './context';
 //# sourceMappingURL=index.js.map

package/lib/module/otp-input/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["createOtpInputCell","createOtpInputField","createOtpInputRoot","applyOtpInputChange","filterAllowedCharacters","filterByRegExp","filterDigits","createOtpInput","BaseComponents","Cell","Field","Root","displayName","Object","assign"],"sourceRoot":"../../../src","sources":["otp-input/index.tsx"],"mappings":";;AACA,SAASA,kBAAkB,QAAQ,sBAAsB;AACzD,SAASC,mBAAmB,QAAQ,uBAAuB;AAC3D,SAASC,kBAAkB,QAAQ,sBAAsB;AAGzD,SAASC,mBAAmB,QAAQ,0BAA0B;AAC9D,SAASC,uBAAuB,EAAEC,cAAc,EAAEC,YAAY,QAAQ,qBAAqB;AAG3F,OAAO,SAASC,cAAcA,CAM5BC,cAID,EAAE;EACD,MAAMC,IAAI,GAAGT,kBAAkB,CAACQ,cAAc,CAACC,IAAI,CAAC;EACpD,MAAMC,KAAK,GAAGT,mBAAmB,CAACO,cAAc,CAACE,KAAK,CAAC;EACvD,MAAMC,IAAI,GAAGT,kBAAkB,CAACM,cAAc,CAACG,IAAI,EAAEF,IAAI,EAAEC,KAAK,CAAC;EAEjEC,IAAI,CAACC,WAAW,GAAG,mBAAmB;EACtCH,IAAI,CAACG,WAAW,GAAG,wBAAwB;EAC3CF,KAAK,CAACE,WAAW,GAAG,yBAAyB;EAE7C,OAAOC,MAAM,CAACC,MAAM,CAACH,IAAI,EAAE;IACzBF,IAAI;IACJC;EACF,CAAC,CAAC;AACJ","ignoreList":[]}
+{"version":3,"names":["applyOtpInputChange","filterAllowedCharacters","filterByRegExp","filterDigits","OtpInputField","useOtpInput","OtpInputProvider","useOtpInputContext","OtpCellIndexProvider","useOtpCellIndexContext"],"sourceRoot":"../../../src","sources":["otp-input/index.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAAQ,0BAA0B;AAC9D,SAASC,uBAAuB,EAAEC,cAAc,EAAEC,YAAY,QAAQ,qBAAqB;AAC3F,SAASC,aAAa,QAAiC,iBAAiB;AACxE,SAASC,WAAW,QAAuD,eAAe;AAC1F,SACEC,gBAAgB,EAChBC,kBAAkB,EAClBC,oBAAoB,EACpBC,sBAAsB,QACjB,WAAW","ignoreList":[]}

package/lib/module/otp-input/useOtpInput.js

@@ -0,0 +1,116 @@
+"use strict";
+
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef } from 'react';
+import { useFormControlContext } from '@cdx-ui/utils';
+import { applyOtpInputChange } from './utils/applyValueChange';
+import { filterAllowedCharacters, filterByRegExp, filterDigits } from './utils/filterValue';
+/**
+ * Headless behavioral primitive for OTP input.
+ *
+ * Owns the controlled value, focus management, masked-input handling, and the
+ * `onComplete` lifecycle. Exposes the context value the styled layer must provide
+ * to `OtpInputField` primitives via `OtpInputProvider`.
+ *
+ * Standards mapping:
+ *   - Standard 3 #1 — controlled state + focus management state machine.
+ *   - Standard 3 #4 — compound contract ownership (context value for Fields).
+ */
+export function useOtpInput(props) {
+  const {
+    cellCount,
+    value,
+    onChangeText,
+    onComplete,
+    isDisabled: isDisabledProp,
+    isInvalid: isInvalidProp,
+    isReadOnly: isReadOnlyProp,
+    smsOtpAutofill = true,
+    filterInput,
+    allowedCharacters,
+    characterPattern,
+    getCellProps,
+    cellTestIdPrefix,
+    accessibilityLabel: rootAccessibilityLabel
+  } = props;
+  const form = useFormControlContext();
+  const isDisabled = isDisabledProp ?? form.isDisabled ?? false;
+  const isInvalid = isInvalidProp ?? form.isInvalid ?? false;
+  const isReadOnly = isReadOnlyProp ?? form.isReadOnly ?? false;
+  const fieldRefs = useRef([]);
+  const focusAfterApply = useRef(null);
+  const prevLenRef = useRef(value.length);
+  const prevValueRef = useRef(value);
+  const filter = useMemo(() => {
+    if (filterInput) {
+      return filterInput;
+    }
+    if (allowedCharacters !== undefined) {
+      return filterAllowedCharacters(allowedCharacters);
+    }
+    if (characterPattern !== undefined) {
+      return filterByRegExp(characterPattern);
+    }
+    return filterDigits;
+  }, [filterInput, allowedCharacters, characterPattern]);
+  const setFieldRef = useCallback((index, el) => {
+    fieldRefs.current[index] = el;
+  }, []);
+  const focusCell = useCallback(index => {
+    const safe = Math.max(0, Math.min(index, cellCount - 1));
+    fieldRefs.current[safe]?.focus();
+  }, [cellCount]);
+  const handleFieldChange = useCallback((index, text) => {
+    const {
+      nextValue,
+      focusIndex
+    } = applyOtpInputChange(value, index, text, cellCount, filter);
+    if (nextValue !== value) {
+      onChangeText(nextValue);
+    }
+    focusAfterApply.current = focusIndex;
+  }, [cellCount, filter, onChangeText, value]);
+  const handleFieldKeyPress = useCallback((index, key) => {
+    if (key !== 'Backspace') {
+      return;
+    }
+    const char = index < value.length ? value[index] : '';
+    if (!char && index > 0) {
+      focusCell(index - 1);
+    }
+  }, [focusCell, value]);
+  useLayoutEffect(() => {
+    if (focusAfterApply.current !== null) {
+      const i = focusAfterApply.current;
+      focusAfterApply.current = null;
+      fieldRefs.current[i]?.focus();
+    }
+  });
+  useEffect(() => {
+    const prevLen = prevLenRef.current;
+    const prevVal = prevValueRef.current;
+    const isFull = value.length === cellCount;
+    const becameFullByLength = isFull && prevLen < cellCount;
+    const correctedWhileFull = isFull && prevLen === cellCount && prevVal !== value;
+    if (becameFullByLength || correctedWhileFull) {
+      onComplete?.();
+    }
+    prevLenRef.current = value.length;
+    prevValueRef.current = value;
+  }, [cellCount, onComplete, value]);
+  return useMemo(() => ({
+    cellCount,
+    value,
+    isDisabled,
+    isInvalid,
+    isReadOnly,
+    smsOtpAutofill,
+    filter,
+    getCellProps: getCellProps,
+    cellTestIdPrefix,
+    rootAccessibilityLabel,
+    setFieldRef,
+    handleFieldChange,
+    handleFieldKeyPress
+  }), [cellCount, value, isDisabled, isInvalid, isReadOnly, smsOtpAutofill, filter, getCellProps, cellTestIdPrefix, rootAccessibilityLabel, setFieldRef, handleFieldChange, handleFieldKeyPress]);
+}
+//# sourceMappingURL=useOtpInput.js.map

package/lib/module/otp-input/useOtpInput.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useEffect","useLayoutEffect","useMemo","useRef","useFormControlContext","applyOtpInputChange","filterAllowedCharacters","filterByRegExp","filterDigits","useOtpInput","props","cellCount","value","onChangeText","onComplete","isDisabled","isDisabledProp","isInvalid","isInvalidProp","isReadOnly","isReadOnlyProp","smsOtpAutofill","filterInput","allowedCharacters","characterPattern","getCellProps","cellTestIdPrefix","accessibilityLabel","rootAccessibilityLabel","form","fieldRefs","focusAfterApply","prevLenRef","length","prevValueRef","filter","undefined","setFieldRef","index","el","current","focusCell","safe","Math","max","min","focus","handleFieldChange","text","nextValue","focusIndex","handleFieldKeyPress","key","char","i","prevLen","prevVal","isFull","becameFullByLength","correctedWhileFull"],"sourceRoot":"../../../src","sources":["otp-input/useOtpInput.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,SAAS,EAAEC,eAAe,EAAEC,OAAO,EAAEC,MAAM,QAAQ,OAAO;AAEhF,SAASC,qBAAqB,QAAQ,eAAe;AACrD,SAASC,mBAAmB,QAAQ,0BAA0B;AAC9D,SAASC,uBAAuB,EAAEC,cAAc,EAAEC,YAAY,QAAQ,qBAAqB;AAS3F;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CAACC,KAAuB,EAAqB;EACtE,MAAM;IACJC,SAAS;IACTC,KAAK;IACLC,YAAY;IACZC,UAAU;IACVC,UAAU,EAAEC,cAAc;IAC1BC,SAAS,EAAEC,aAAa;IACxBC,UAAU,EAAEC,cAAc;IAC1BC,cAAc,GAAG,IAAI;IACrBC,WAAW;IACXC,iBAAiB;IACjBC,gBAAgB;IAChBC,YAAY;IACZC,gBAAgB;IAChBC,kBAAkB,EAAEC;EACtB,CAAC,GAAGlB,KAAK;EAET,MAAMmB,IAAI,GAAGzB,qBAAqB,CAAC,CAAC;EACpC,MAAMW,UAAU,GAAGC,cAAc,IAAIa,IAAI,CAACd,UAAU,IAAI,KAAK;EAC7D,MAAME,SAAS,GAAGC,aAAa,IAAIW,IAAI,CAACZ,SAAS,IAAI,KAAK;EAC1D,MAAME,UAAU,GAAGC,cAAc,IAAIS,IAAI,CAACV,UAAU,IAAI,KAAK;EAE7D,MAAMW,SAAS,GAAG3B,MAAM,CAAuB,EAAE,CAAC;EAClD,MAAM4B,eAAe,GAAG5B,MAAM,CAAgB,IAAI,CAAC;EACnD,MAAM6B,UAAU,GAAG7B,MAAM,CAACS,KAAK,CAACqB,MAAM,CAAC;EACvC,MAAMC,YAAY,GAAG/B,MAAM,CAACS,KAAK,CAAC;EAElC,MAAMuB,MAAM,GAAGjC,OAAO,CAAC,MAAM;IAC3B,IAAIoB,WAAW,EAAE;MACf,OAAOA,WAAW;IACpB;IACA,IAAIC,iBAAiB,KAAKa,SAAS,EAAE;MACnC,OAAO9B,uBAAuB,CAACiB,iBAAiB,CAAC;IACnD;IACA,IAAIC,gBAAgB,KAAKY,SAAS,EAAE;MAClC,OAAO7B,cAAc,CAACiB,gBAAgB,CAAC;IACzC;IACA,OAAOhB,YAAY;EACrB,CAAC,EAAE,CAACc,WAAW,EAAEC,iBAAiB,EAAEC,gBAAgB,CAAC,CAAC;EAEtD,MAAMa,WAAW,GAAGtC,WAAW,CAAC,CAACuC,KAAa,EAAEC,EAAoB,KAAK;IACvET,SAAS,CAACU,OAAO,CAACF,KAAK,CAAC,GAAGC,EAAE;EAC/B,CAAC,EAAE,EAAE,CAAC;EAEN,MAAME,SAAS,GAAG1C,WAAW,CAC1BuC,KAAa,IAAK;IACjB,MAAMI,IAAI,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC,EAAED,IAAI,CAACE,GAAG,CAACP,KAAK,EAAE3B,SAAS,GAAG,CAAC,CAAC,CAAC;IACxDmB,SAAS,CAACU,OAAO,CAACE,IAAI,CAAC,EAAEI,KAAK,CAAC,CAAC;EAClC,CAAC,EACD,CAACnC,SAAS,CACZ,CAAC;EAED,MAAMoC,iBAAiB,GAAGhD,WAAW,CACnC,CAACuC,KAAa,EAAEU,IAAY,KAAK;IAC/B,MAAM;MAAEC,SAAS;MAAEC;IAAW,CAAC,GAAG7C,mBAAmB,CAACO,KAAK,EAAE0B,KAAK,EAAEU,IAAI,EAAErC,SAAS,EAAEwB,MAAM,CAAC;IAC5F,IAAIc,SAAS,KAAKrC,KAAK,EAAE;MACvBC,YAAY,CAACoC,SAAS,CAAC;IACzB;IACAlB,eAAe,CAACS,OAAO,GAAGU,UAAU;EACtC,CAAC,EACD,CAACvC,SAAS,EAAEwB,MAAM,EAAEtB,YAAY,EAAED,KAAK,CACzC,CAAC;EAED,MAAMuC,mBAAmB,GAAGpD,WAAW,CACrC,CAACuC,KAAa,EAAEc,GAAW,KAAK;IAC9B,IAAIA,GAAG,KAAK,WAAW,EAAE;MACvB;IACF;IACA,MAAMC,IAAI,GAAGf,KAAK,GAAG1B,KAAK,CAACqB,MAAM,GAAGrB,KAAK,CAAC0B,KAAK,CAAC,GAAG,EAAE;IACrD,IAAI,CAACe,IAAI,IAAIf,KAAK,GAAG,CAAC,EAAE;MACtBG,SAAS,CAACH,KAAK,GAAG,CAAC,CAAC;IACtB;EACF,CAAC,EACD,CAACG,SAAS,EAAE7B,KAAK,CACnB,CAAC;EAEDX,eAAe,CAAC,MAAM;IACpB,IAAI8B,eAAe,CAACS,OAAO,KAAK,IAAI,EAAE;MACpC,MAAMc,CAAC,GAAGvB,eAAe,CAACS,OAAO;MACjCT,eAAe,CAACS,OAAO,GAAG,IAAI;MAC9BV,SAAS,CAACU,OAAO,CAACc,CAAC,CAAC,EAAER,KAAK,CAAC,CAAC;IAC/B;EACF,CAAC,CAAC;EAEF9C,SAAS,CAAC,MAAM;IACd,MAAMuD,OAAO,GAAGvB,UAAU,CAACQ,OAAO;IAClC,MAAMgB,OAAO,GAAGtB,YAAY,CAACM,OAAO;IACpC,MAAMiB,MAAM,GAAG7C,KAAK,CAACqB,MAAM,KAAKtB,SAAS;IACzC,MAAM+C,kBAAkB,GAAGD,MAAM,IAAIF,OAAO,GAAG5C,SAAS;IACxD,MAAMgD,kBAAkB,GAAGF,MAAM,IAAIF,OAAO,KAAK5C,SAAS,IAAI6C,OAAO,KAAK5C,KAAK;IAE/E,IAAI8C,kBAAkB,IAAIC,kBAAkB,EAAE;MAC5C7C,UAAU,GAAG,CAAC;IAChB;IACAkB,UAAU,CAACQ,OAAO,GAAG5B,KAAK,CAACqB,MAAM;IACjCC,YAAY,CAACM,OAAO,GAAG5B,KAAK;EAC9B,CAAC,EAAE,CAACD,SAAS,EAAEG,UAAU,EAAEF,KAAK,CAAC,CAAC;EAElC,OAAOV,OAAO,CACZ,OAAO;IACLS,SAAS;IACTC,KAAK;IACLG,UAAU;IACVE,SAAS;IACTE,UAAU;IACVE,cAAc;IACdc,MAAM;IACNV,YAAY,EAAEA,YAAwE;IACtFC,gBAAgB;IAChBE,sBAAsB;IACtBS,WAAW;IACXU,iBAAiB;IACjBI;EACF,CAAC,CAAC,EACF,CACExC,SAAS,EACTC,KAAK,EACLG,UAAU,EACVE,SAAS,EACTE,UAAU,EACVE,cAAc,EACdc,MAAM,EACNV,YAAY,EACZC,gBAAgB,EAChBE,sBAAsB,EACtBS,WAAW,EACXU,iBAAiB,EACjBI,mBAAmB,CAEvB,CAAC;AACH","ignoreList":[]}

package/lib/module/overlay/OverlayContainer.js

@@ -3,12 +3,13 @@
 import { Modal, Platform, Pressable, StyleSheet, View } from 'react-native';
 import Animated from 'react-native-reanimated';
 import { createPortalFn } from '../utils/createPortal';
+import { MODAL_OVERLAY_Z_INDEX } from './constants';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
  * Cross-platform overlay container.
  *
  * - Web: renders children into a `createPortal` at `document.body` with
- *   `position: fixed` and `zIndex: 50`. Uses a plain `View` rather than
+ *   `position: fixed` and `MODAL_OVERLAY_Z_INDEX`. Uses a plain `View` rather than
  *   Reanimated's `Animated.View` because Reanimated's layout animations
  *   (`entering`/`exiting`) rely on `require()` calls that break silently
  *   in Vite production bundles, leaving elements stuck at opacity 0.
@@ -30,7 +31,7 @@ export function OverlayContainer({
     return createPortalFn(/*#__PURE__*/_jsx(View, {
       style: [{
         position: 'fixed',
-        zIndex: 50
+        zIndex: MODAL_OVERLAY_Z_INDEX
       }, style],
       children: children
     }), document.body);
@@ -49,9 +50,8 @@ export function OverlayContainer({
     }), /*#__PURE__*/_jsx(Animated.View, {
       entering: entering,
       exiting: exiting,
-      style: [{
-        position: 'absolute'
-      }, style],
+      pointerEvents: "box-none",
+      style: [StyleSheet.absoluteFill, style],
       children: children
     })]
   });

package/lib/module/overlay/OverlayContainer.js.map

@@ -1 +1 @@
-{"version":3,"names":["Modal","Platform","Pressable","StyleSheet","View","Animated","createPortalFn","jsx","_jsx","jsxs","_jsxs","OverlayContainer","onDismiss","entering","exiting","style","children","OS","position","zIndex","document","body","visible","transparent","animationType","statusBarTranslucent","onRequestClose","absoluteFill","onPress","accessible","importantForAccessibility"],"sourceRoot":"../../../src","sources":["overlay/OverlayContainer.tsx"],"mappings":";;AACA,SACEA,KAAK,EACLC,QAAQ,EACRC,SAAS,EACTC,UAAU,EACVC,IAAI,QAGC,cAAc;AACrB,OAAOC,QAAQ,MAAsC,yBAAyB;AAC9E,SAASC,cAAc,QAAQ,uBAAuB;AAAC,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAUvD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAC;EAC/BC,SAAS;EACTC,QAAQ;EACRC,OAAO;EACPC,KAAK;EACLC;AAC+B,CAAC,EAAE;EAClC,IAAIf,QAAQ,CAACgB,EAAE,KAAK,KAAK,IAAIX,cAAc,EAAE;IAC3C,OAAOA,cAAc,cACnBE,IAAA,CAACJ,IAAI;MAACW,KAAK,EAAE,CAAC;QAAEG,QAAQ,EAAE,OAAc;QAAEC,MAAM,EAAE;MAAG,CAAC,EAAEJ,KAAK,CAAE;MAAAC,QAAA,EAAEA;IAAQ,CAAO,CAAC,EACjFI,QAAQ,CAACC,IACX,CAAC;EACH;EAEA,oBACEX,KAAA,CAACV,KAAK;IAACsB,OAAO;IAACC,WAAW;IAACC,aAAa,EAAC,MAAM;IAACC,oBAAoB;IAACC,cAAc,EAAEd,SAAU;IAAAI,QAAA,gBAC7FR,IAAA,CAACN,SAAS;MACRa,KAAK,EAAEZ,UAAU,CAACwB,YAAa;MAC/BC,OAAO,EAAEhB,SAAU;MACnBiB,UAAU,EAAE,KAAM;MAClBC,yBAAyB,EAAC;IAAqB,CAChD,CAAC,eACFtB,IAAA,CAACH,QAAQ,CAACD,IAAI;MACZS,QAAQ,EAAEA,QAAS;MACnBC,OAAO,EAAEA,OAAQ;MACjBC,KAAK,EAAE,CAAC;QAAEG,QAAQ,EAAE;MAAW,CAAC,EAAEH,KAAK,CAAE;MAAAC,QAAA,EAExCA;IAAQ,CACI,CAAC;EAAA,CACX,CAAC;AAEZ","ignoreList":[]}
+{"version":3,"names":["Modal","Platform","Pressable","StyleSheet","View","Animated","createPortalFn","MODAL_OVERLAY_Z_INDEX","jsx","_jsx","jsxs","_jsxs","OverlayContainer","onDismiss","entering","exiting","style","children","OS","position","zIndex","document","body","visible","transparent","animationType","statusBarTranslucent","onRequestClose","absoluteFill","onPress","accessible","importantForAccessibility","pointerEvents"],"sourceRoot":"../../../src","sources":["overlay/OverlayContainer.tsx"],"mappings":";;AACA,SACEA,KAAK,EACLC,QAAQ,EACRC,SAAS,EACTC,UAAU,EACVC,IAAI,QAGC,cAAc;AACrB,OAAOC,QAAQ,MAAsC,yBAAyB;AAC9E,SAASC,cAAc,QAAQ,uBAAuB;AACtD,SAASC,qBAAqB,QAAQ,aAAa;AAAC,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAUpD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAC;EAC/BC,SAAS;EACTC,QAAQ;EACRC,OAAO;EACPC,KAAK;EACLC;AAC+B,CAAC,EAAE;EAClC,IAAIhB,QAAQ,CAACiB,EAAE,KAAK,KAAK,IAAIZ,cAAc,EAAE;IAC3C,OAAOA,cAAc,cACnBG,IAAA,CAACL,IAAI;MAACY,KAAK,EAAE,CAAC;QAAEG,QAAQ,EAAE,OAAc;QAAEC,MAAM,EAAEb;MAAsB,CAAC,EAAES,KAAK,CAAE;MAAAC,QAAA,EAC/EA;IAAQ,CACL,CAAC,EACPI,QAAQ,CAACC,IACX,CAAC;EACH;EAEA,oBACEX,KAAA,CAACX,KAAK;IAACuB,OAAO;IAACC,WAAW;IAACC,aAAa,EAAC,MAAM;IAACC,oBAAoB;IAACC,cAAc,EAAEd,SAAU;IAAAI,QAAA,gBAC7FR,IAAA,CAACP,SAAS;MACRc,KAAK,EAAEb,UAAU,CAACyB,YAAa;MAC/BC,OAAO,EAAEhB,SAAU;MACnBiB,UAAU,EAAE,KAAM;MAClBC,yBAAyB,EAAC;IAAqB,CAChD,CAAC,eAEFtB,IAAA,CAACJ,QAAQ,CAACD,IAAI;MACZU,QAAQ,EAAEA,QAAS;MACnBC,OAAO,EAAEA,OAAQ;MACjBiB,aAAa,EAAC,UAAU;MACxBhB,KAAK,EAAE,CAACb,UAAU,CAACyB,YAAY,EAAEZ,KAAK,CAAE;MAAAC,QAAA,EAEvCA;IAAQ,CACI,CAAC;EAAA,CACX,CAAC;AAEZ","ignoreList":[]}

package/lib/module/overlay/OverlayStack.js

@@ -0,0 +1,119 @@
+"use strict";
+
+import React, { createContext, useCallback, useContext, useEffect, useId, useRef, useSyncExternalStore } from 'react';
+import { jsx as _jsx } from "react/jsx-runtime";
+function createOverlayStackRegistry() {
+  const entries = new Map();
+  const listeners = new Set();
+  let activationOrder = 0;
+  let version = 0;
+  const emit = () => {
+    version += 1;
+    for (const listener of listeners) listener();
+  };
+  return {
+    register(token, entry) {
+      activationOrder += 1;
+      entries.set(token, {
+        ...entry,
+        token,
+        activationOrder
+      });
+      emit();
+    },
+    unregister(token) {
+      if (entries.delete(token)) emit();
+    },
+    isTopmost(token, capability) {
+      const current = entries.get(token);
+      if (!current?.capabilities.has(capability)) return false;
+      let topmost = current;
+      for (const candidate of entries.values()) {
+        if (!candidate.capabilities.has(capability)) continue;
+        if (candidate.activationOrder > topmost.activationOrder) {
+          topmost = candidate;
+        }
+      }
+      return topmost.token === token;
+    },
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    getSnapshot() {
+      return version;
+    }
+  };
+}
+const OverlayStackContext = /*#__PURE__*/createContext(null);
+const subscribeNoop = () => {
+  return () => undefined;
+};
+const getZeroSnapshot = () => 0;
+
+/**
+ * Scopes overlay ordering and dismissal coordination to a provider subtree.
+ * Hooks retain their standalone behavior when no provider is present.
+ */
+export function OverlayStackProvider({
+  children
+}) {
+  const [registry] = React.useState(createOverlayStackRegistry);
+  return /*#__PURE__*/_jsx(OverlayStackContext.Provider, {
+    value: registry,
+    children: children
+  });
+}
+
+/**
+ * Registers one active overlay and reports whether it is topmost for a specific
+ * dismissal capability. Capabilities are resolved independently so a
+ * notification without dismissal capabilities never blocks a modal.
+ */
+export function useOverlayStackRegistration({
+  active,
+  capabilities = [],
+  layer = 'nonmodal',
+  id,
+  parentId,
+  groupId
+}) {
+  const registry = useContext(OverlayStackContext);
+  const token = useRef(Symbol('forge-ui-overlay')).current;
+  const generatedId = `forge-ui-overlay-${useId()}`;
+  const resolvedId = id ?? generatedId;
+  const handlesEscape = capabilities.includes('escape');
+  const handlesOutside = capabilities.includes('outside');
+  const handlesBack = capabilities.includes('back');
+  useEffect(() => {
+    if (!registry || !active) return;
+    const resolvedCapabilities = new Set();
+    if (handlesEscape) resolvedCapabilities.add('escape');
+    if (handlesOutside) resolvedCapabilities.add('outside');
+    if (handlesBack) resolvedCapabilities.add('back');
+    registry.register(token, {
+      id: resolvedId,
+      layer,
+      parentId,
+      groupId,
+      capabilities: resolvedCapabilities
+    });
+    return () => {
+      registry.unregister(token);
+    };
+  }, [active, groupId, handlesBack, handlesEscape, handlesOutside, layer, parentId, registry, resolvedId, token]);
+  useSyncExternalStore(registry?.subscribe ?? subscribeNoop, registry?.getSnapshot ?? getZeroSnapshot, getZeroSnapshot);
+  const isTopmost = useCallback(capability => {
+    if (!active) return false;
+    const handlesCapability = capability === 'escape' && handlesEscape || capability === 'outside' && handlesOutside || capability === 'back' && handlesBack;
+    if (!handlesCapability) return false;
+    return !registry || registry.isTopmost(token, capability);
+  }, [active, handlesBack, handlesEscape, handlesOutside, registry, token]);
+  return {
+    id: resolvedId,
+    isTopmost
+  };
+}
+//# sourceMappingURL=OverlayStack.js.map

package/lib/module/overlay/OverlayStack.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","createContext","useCallback","useContext","useEffect","useId","useRef","useSyncExternalStore","jsx","_jsx","createOverlayStackRegistry","entries","Map","listeners","Set","activationOrder","version","emit","listener","register","token","entry","set","unregister","delete","isTopmost","capability","current","get","capabilities","has","topmost","candidate","values","subscribe","add","getSnapshot","OverlayStackContext","subscribeNoop","undefined","getZeroSnapshot","OverlayStackProvider","children","registry","useState","Provider","value","useOverlayStackRegistration","active","layer","id","parentId","groupId","Symbol","generatedId","resolvedId","handlesEscape","includes","handlesOutside","handlesBack","resolvedCapabilities","handlesCapability"],"sourceRoot":"../../../src","sources":["overlay/OverlayStack.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/overlay/constants.js

@@ -0,0 +1,14 @@
+"use strict";
+
+/**
+ * Modal overlay z-index — above @gorhom/bottom-sheet internal layers (footer uses 9999)
+ * so Dialog / AlertDialog stack on top when opened from a bottom sheet.
+ */
+export const MODAL_OVERLAY_Z_INDEX = 10000;
+
+/**
+ * Notification overlay z-index — above modal surfaces while remaining
+ * nonmodal and pointer-transparent outside the notification content.
+ */
+export const NOTIFICATION_OVERLAY_Z_INDEX = 11000;
+//# sourceMappingURL=constants.js.map

package/lib/module/overlay/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MODAL_OVERLAY_Z_INDEX","NOTIFICATION_OVERLAY_Z_INDEX"],"sourceRoot":"../../../src","sources":["overlay/constants.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA,OAAO,MAAMA,qBAAqB,GAAG,KAAK;;AAE1C;AACA;AACA;AACA;AACA,OAAO,MAAMC,4BAA4B,GAAG,KAAK","ignoreList":[]}