@oxyhq/bloom 0.45.0 → 0.46.0

package/lib/commonjs/surfaces/index.js

@@ -0,0 +1,82 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.SurfaceProvider = exports.SurfaceHost = void 0;
+Object.defineProperty(exports, "confirm", {
+  enumerable: true,
+  get: function () {
+    return _api.confirm;
+  }
+});
+Object.defineProperty(exports, "dismiss", {
+  enumerable: true,
+  get: function () {
+    return _api.dismiss;
+  }
+});
+Object.defineProperty(exports, "dismissAll", {
+  enumerable: true,
+  get: function () {
+    return _api.dismissAll;
+  }
+});
+Object.defineProperty(exports, "dismissById", {
+  enumerable: true,
+  get: function () {
+    return _api.dismissById;
+  }
+});
+Object.defineProperty(exports, "dismissToRoot", {
+  enumerable: true,
+  get: function () {
+    return _api.dismissToRoot;
+  }
+});
+Object.defineProperty(exports, "present", {
+  enumerable: true,
+  get: function () {
+    return _api.present;
+  }
+});
+Object.defineProperty(exports, "prompt", {
+  enumerable: true,
+  get: function () {
+    return _api.prompt;
+  }
+});
+Object.defineProperty(exports, "surfaces", {
+  enumerable: true,
+  get: function () {
+    return _api.surfaces;
+  }
+});
+Object.defineProperty(exports, "useSurface", {
+  enumerable: true,
+  get: function () {
+    return _useSurface.useSurface;
+  }
+});
+var _dialog = require("../dialog");
+var _SurfaceHost = require("./SurfaceHost.js");
+var _api = require("./api.js");
+var _useSurface = require("./useSurface.js");
+/**
+ * The shared, content-agnostic SURFACE STACK.
+ *
+ * `<SurfaceProvider>`/`<SurfaceHost>` render the coordinated stack; the
+ * imperative `surfaces` API (+ its named functions) present into it from
+ * anywhere; `useSurface()` gives a presented surface its own controls.
+ *
+ * `SurfaceHost`/`SurfaceProvider` are bound to the NATIVE `Dialog` here; the web
+ * fork (`./index.web`) binds the web `Dialog`. The store, imperative API, hook,
+ * and types are platform-agnostic and shared by both.
+ */
+const {
+  SurfaceHost,
+  SurfaceProvider
+} = (0, _SurfaceHost.createSurfaceHost)(_dialog.Dialog);
+exports.SurfaceProvider = SurfaceProvider;
+exports.SurfaceHost = SurfaceHost;
+//# sourceMappingURL=index.js.map

package/lib/commonjs/surfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_dialog","require","_SurfaceHost","_api","_useSurface","SurfaceHost","SurfaceProvider","createSurfaceHost","Dialog","exports"],"sourceRoot":"../../../src","sources":["surfaces/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AAgBA,IAAAE,IAAA,GAAAF,OAAA;AAUA,IAAAG,WAAA,GAAAH,OAAA;AAxBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM;EAAEI,WAAW;EAAEC;AAAgB,CAAC,GAAG,IAAAC,8BAAiB,EAACC,cAAM,CAAC;AAACC,OAAA,CAAAH,eAAA,GAAAA,eAAA;AAAAG,OAAA,CAAAJ,WAAA,GAAAA,WAAA","ignoreList":[]}

package/lib/commonjs/surfaces/index.web.js

@@ -0,0 +1,77 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.SurfaceProvider = exports.SurfaceHost = void 0;
+Object.defineProperty(exports, "confirm", {
+  enumerable: true,
+  get: function () {
+    return _api.confirm;
+  }
+});
+Object.defineProperty(exports, "dismiss", {
+  enumerable: true,
+  get: function () {
+    return _api.dismiss;
+  }
+});
+Object.defineProperty(exports, "dismissAll", {
+  enumerable: true,
+  get: function () {
+    return _api.dismissAll;
+  }
+});
+Object.defineProperty(exports, "dismissById", {
+  enumerable: true,
+  get: function () {
+    return _api.dismissById;
+  }
+});
+Object.defineProperty(exports, "dismissToRoot", {
+  enumerable: true,
+  get: function () {
+    return _api.dismissToRoot;
+  }
+});
+Object.defineProperty(exports, "present", {
+  enumerable: true,
+  get: function () {
+    return _api.present;
+  }
+});
+Object.defineProperty(exports, "prompt", {
+  enumerable: true,
+  get: function () {
+    return _api.prompt;
+  }
+});
+Object.defineProperty(exports, "surfaces", {
+  enumerable: true,
+  get: function () {
+    return _api.surfaces;
+  }
+});
+Object.defineProperty(exports, "useSurface", {
+  enumerable: true,
+  get: function () {
+    return _useSurface.useSurface;
+  }
+});
+var _indexWeb = require("../dialog/index.web.js");
+var _SurfaceHost = require("./SurfaceHost.js");
+var _api = require("./api.js");
+var _useSurface = require("./useSurface.js");
+/**
+ * Web variant of the surface stack barrel. Identical surface area to the native
+ * `./index.ts` — it just binds the web-fork `Dialog` (`Dialog.web.tsx`, a
+ * pure-DOM overlay) instead of the native `BottomSheet`-backed one. The store,
+ * imperative API, hook, and types are shared, platform-agnostic modules.
+ */
+const {
+  SurfaceHost,
+  SurfaceProvider
+} = (0, _SurfaceHost.createSurfaceHost)(_indexWeb.Dialog);
+exports.SurfaceProvider = SurfaceProvider;
+exports.SurfaceHost = SurfaceHost;
+//# sourceMappingURL=index.web.js.map

package/lib/commonjs/surfaces/index.web.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_indexWeb","require","_SurfaceHost","_api","_useSurface","SurfaceHost","SurfaceProvider","createSurfaceHost","Dialog","exports"],"sourceRoot":"../../../src","sources":["surfaces/index.web.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,SAAA,GAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AAWA,IAAAE,IAAA,GAAAF,OAAA;AAUA,IAAAG,WAAA,GAAAH,OAAA;AAnBA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM;EAAEI,WAAW;EAAEC;AAAgB,CAAC,GAAG,IAAAC,8BAAiB,EAACC,gBAAM,CAAC;AAACC,OAAA,CAAAH,eAAA,GAAAA,eAAA;AAAAG,OAAA,CAAAJ,WAAA,GAAAA,WAAA","ignoreList":[]}

package/lib/commonjs/surfaces/prompts.js

@@ -0,0 +1,154 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.confirm = confirm;
+exports.prompt = prompt;
+var _react = _interopRequireWildcard(require("react"));
+var _reactNative = require("react-native");
+var _button = require("../button");
+var _index = require("../text-field/index.js");
+var _useTheme = require("../theme/use-theme.js");
+var _surfaceStore = require("./surfaceStore.js");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * Built-in `confirm` / `prompt` surfaces.
+ *
+ * They are implemented AS surfaces — each calls `present(...)` so it STACKS
+ * correctly above any open surface with the right layer/z (unlike Bloom's
+ * one-at-a-time `alert()` FIFO queue, which cannot layer over another surface).
+ * Their buttons resolve through the surface's own `dismiss(result)` (NOT the
+ * underlying `Dialog`'s close), so the value flows back through the `present()`
+ * promise.
+ */
+
+const TITLE_STYLE = {
+  fontSize: 22,
+  fontWeight: '600',
+  lineHeight: 30
+};
+const MESSAGE_STYLE = {
+  fontSize: 16,
+  lineHeight: 22
+};
+function ConfirmSurface({
+  options,
+  surface
+}) {
+  const theme = (0, _useTheme.useTheme)();
+  const onConfirm = (0, _react.useCallback)(() => surface.dismiss(true), [surface]);
+  const onCancel = (0, _react.useCallback)(() => surface.dismiss(false), [surface]);
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+      style: [TITLE_STYLE, {
+        color: theme.colors.text,
+        paddingBottom: options.message ? 4 : 16
+      }],
+      children: options.title
+    }), options.message ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+      style: [MESSAGE_STYLE, {
+        color: theme.colors.textSecondary,
+        paddingBottom: 16
+      }],
+      children: options.message
+    }) : null, /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+      style: {
+        gap: 8
+      },
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_button.Button, {
+        variant: options.destructive ? 'destructive' : 'primary',
+        onPress: onConfirm,
+        testID: "bloom-surface-confirm-confirm",
+        children: options.confirmLabel ?? 'Confirm'
+      }), options.hideCancel ? null : /*#__PURE__*/(0, _jsxRuntime.jsx)(_button.Button, {
+        variant: "secondary",
+        onPress: onCancel,
+        testID: "bloom-surface-confirm-cancel",
+        children: options.cancelLabel ?? 'Cancel'
+      })]
+    })]
+  });
+}
+function PromptSurface({
+  options,
+  surface
+}) {
+  const theme = (0, _useTheme.useTheme)();
+  const [value, setValue] = (0, _react.useState)(options.defaultValue ?? '');
+  const onSubmit = (0, _react.useCallback)(() => surface.dismiss(value), [surface, value]);
+  const onCancel = (0, _react.useCallback)(() => surface.dismiss(null), [surface]);
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+      style: [TITLE_STYLE, {
+        color: theme.colors.text,
+        paddingBottom: options.message ? 4 : 16
+      }],
+      children: options.title
+    }), options.message ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+      style: [MESSAGE_STYLE, {
+        color: theme.colors.textSecondary,
+        paddingBottom: 16
+      }],
+      children: options.message
+    }) : null, /*#__PURE__*/(0, _jsxRuntime.jsx)(_index.TextFieldInput, {
+      label: options.inputLabel ?? options.title,
+      placeholder: options.placeholder,
+      value: value,
+      onChangeText: setValue,
+      autoFocus: true,
+      returnKeyType: "done",
+      onSubmitEditing: onSubmit,
+      testID: "bloom-surface-prompt-input"
+    }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+      style: {
+        gap: 8,
+        paddingTop: 16
+      },
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_button.Button, {
+        variant: "primary",
+        onPress: onSubmit,
+        testID: "bloom-surface-prompt-confirm",
+        children: options.confirmLabel ?? 'OK'
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_button.Button, {
+        variant: "secondary",
+        onPress: onCancel,
+        testID: "bloom-surface-prompt-cancel",
+        children: options.cancelLabel ?? 'Cancel'
+      })]
+    })]
+  });
+}
+
+/**
+ * Present a confirm surface stacked on top of anything currently open. Resolves
+ * `true` on confirm, `false` on cancel OR on backdrop/Escape/back dismissal.
+ */
+function confirm(options) {
+  return (0, _surfaceStore.present)(surface => /*#__PURE__*/(0, _jsxRuntime.jsx)(ConfirmSurface, {
+    options: options,
+    surface: surface
+  }), {
+    placement: options.placement ?? 'center',
+    dismissOnBackdrop: options.dismissible ?? true,
+    label: options.title
+  }).then(result => result === true);
+}
+
+/**
+ * Present a prompt surface stacked on top of anything currently open. Resolves
+ * the entered string on submit, or `null` on cancel OR backdrop/Escape/back
+ * dismissal.
+ */
+function prompt(options) {
+  return (0, _surfaceStore.present)(surface => /*#__PURE__*/(0, _jsxRuntime.jsx)(PromptSurface, {
+    options: options,
+    surface: surface
+  }), {
+    placement: options.placement ?? 'center',
+    dismissOnBackdrop: options.dismissible ?? true,
+    label: options.title
+  }).then(result => typeof result === 'string' ? result : null);
+}
+//# sourceMappingURL=prompts.js.map

package/lib/commonjs/surfaces/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_button","_index","_useTheme","_surfaceStore","_jsxRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","TITLE_STYLE","fontSize","fontWeight","lineHeight","MESSAGE_STYLE","ConfirmSurface","options","surface","theme","useTheme","onConfirm","useCallback","dismiss","onCancel","jsxs","View","children","jsx","Text","style","color","colors","text","paddingBottom","message","title","textSecondary","gap","Button","variant","destructive","onPress","testID","confirmLabel","hideCancel","cancelLabel","PromptSurface","value","setValue","useState","defaultValue","onSubmit","TextFieldInput","label","inputLabel","placeholder","onChangeText","autoFocus","returnKeyType","onSubmitEditing","paddingTop","confirm","present","placement","dismissOnBackdrop","dismissible","then","result","prompt"],"sourceRoot":"../../../src","sources":["surfaces/prompts.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/surfaces/surfaceStore.js

@@ -0,0 +1,172 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.__resetSurfacesForTests = __resetSurfacesForTests;
+exports.dismissAll = dismissAll;
+exports.dismissToRoot = dismissToRoot;
+exports.dismissTop = dismissTop;
+exports.finalizeClose = finalizeClose;
+exports.getSnapshot = getSnapshot;
+exports.present = present;
+exports.requestDismiss = requestDismiss;
+exports.resetSurfaces = resetSurfaces;
+exports.subscribe = subscribe;
+/**
+ * The shared, content-agnostic SURFACE STACK.
+ *
+ * A module-singleton store (same pattern as `theme/ambient-store.ts` and
+ * `dialog/alert-store.ts`) holding an ordered stack of surfaces presented ON TOP
+ * of each other — bottom→top, the last entry is the top. One coordinated stack
+ * that the whole ecosystem (the SDK AND consumer apps) presents into, so
+ * overlays never clash: per-layer z, top-only interactivity, backdrop/Escape/
+ * back routed to the TOP surface, lower layers dimmed.
+ *
+ * It is CONTENT-AGNOSTIC: `present` takes a render function, not a route name.
+ * Bloom must never know about routes; the SDK layers its route registry on top.
+ *
+ * `getSnapshot` returns a STABLE reference while unchanged (the array identity
+ * only changes on a real mutation), so `useSyncExternalStore` — and the React
+ * Compiler — never see a silently-stale value.
+ */
+
+let idCounter = 0;
+function genId() {
+  idCounter += 1;
+  return `bloom-surface-${idCounter}`;
+}
+
+/** A single frozen "empty stack" snapshot returned by `getSnapshot` when idle. */
+const EMPTY = Object.freeze([]);
+let surfaces = EMPTY;
+const listeners = new Set();
+function emit() {
+  for (const listener of listeners) listener();
+}
+
+/** Subscribe to stack changes. Returns an unsubscribe fn. */
+function subscribe(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+
+/** Current stack snapshot (stable ref while unchanged). Bottom→top. */
+function getSnapshot() {
+  return surfaces;
+}
+
+/**
+ * Present a new surface on TOP of the stack. Returns a promise that resolves
+ * with the value passed to `dismiss(result)` (or `undefined` when the surface is
+ * dismissed without a result / by a stack-wide clear).
+ */
+function present(render, opts) {
+  return new Promise(resolve => {
+    const entry = {
+      id: genId(),
+      render,
+      presentation: opts ?? {},
+      status: 'open',
+      resolve: resolve,
+      settled: false,
+      generation: 0
+    };
+    surfaces = [...surfaces, entry];
+    emit();
+  });
+}
+
+/**
+ * Request dismissal of a surface. RESOLVES THE PROMISE IMMEDIATELY (the exit
+ * animation that follows is cosmetic) and flips the entry to `'closing'` so the
+ * host runs its exit animation. Resolution is resolve-once via the `settled`
+ * guard — a second request (or the host's post-exit `onClose`) never re-resolves
+ * with a different value. Bumps the entry `generation` so a completion callback
+ * from a superseded cycle is inert.
+ */
+function requestDismiss(id, result) {
+  const entry = surfaces.find(e => e.id === id);
+  if (!entry) return;
+
+  // Resolve-once. The mapped replacement below carries `settled: true`, so a
+  // later `requestDismiss(id)` reads the settled entry and skips this branch —
+  // no in-place mutation of the live entry is needed.
+  if (!entry.settled) {
+    entry.resolve(result);
+  }
+  if (entry.status === 'closing') return;
+  surfaces = surfaces.map(e => e.id === id ? {
+    ...e,
+    settled: true,
+    status: 'closing',
+    generation: e.generation + 1
+  } : e);
+  emit();
+}
+
+/**
+ * Splice a surface out of the stack once its exit animation has settled. Called
+ * by the host from the `Dialog`'s post-exit `onClose`. Idempotent and gated on
+ * `'closing'` status: a stale/duplicate call — or one for an entry that is not
+ * actually closing — is a no-op, which (together with unique entry ids) is the
+ * stale-callback hygiene `BottomSheetBase`'s generation guard provides for its
+ * reused instance.
+ */
+function finalizeClose(id) {
+  const entry = surfaces.find(e => e.id === id);
+  if (!entry || entry.status !== 'closing') return;
+  const next = surfaces.filter(e => e.id !== id);
+  surfaces = next.length === 0 ? EMPTY : next;
+  emit();
+}
+
+/** Dismiss the TOP surface, resolving its promise with `result`. */
+function dismissTop(result) {
+  const top = surfaces[surfaces.length - 1];
+  if (top) requestDismiss(top.id, result);
+}
+
+/**
+ * Dismiss every surface ABOVE the bottom-most one, keeping the root surface
+ * open. Pending awaiters of the dismissed surfaces resolve with `undefined` so
+ * they never hang. No-op with 0 or 1 surfaces.
+ */
+function dismissToRoot() {
+  if (surfaces.length <= 1) return;
+  const above = surfaces.slice(1).map(e => e.id);
+  for (const id of above) requestDismiss(id, undefined);
+}
+
+/**
+ * Dismiss the ENTIRE stack. Every pending awaiter resolves with `undefined` so
+ * none hang.
+ */
+function dismissAll() {
+  const ids = surfaces.map(e => e.id);
+  for (const id of ids) requestDismiss(id, undefined);
+}
+
+/**
+ * Hard-reset the stack synchronously (no exit animation), resolving all pending
+ * awaiters with `undefined`. Used when the host provider unmounts so no
+ * `present()` promise is stranded.
+ */
+function resetSurfaces() {
+  if (surfaces.length === 0) return;
+  const pending = surfaces;
+  surfaces = EMPTY;
+  for (const entry of pending) {
+    if (!entry.settled) entry.resolve(undefined);
+  }
+  emit();
+}
+
+/** Test-only: hard-reset without notifying (drops listeners' work). */
+function __resetSurfacesForTests() {
+  surfaces = EMPTY;
+  idCounter = 0;
+}
+//# sourceMappingURL=surfaceStore.js.map

package/lib/commonjs/surfaces/surfaceStore.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["idCounter","genId","EMPTY","Object","freeze","surfaces","listeners","Set","emit","listener","subscribe","add","delete","getSnapshot","present","render","opts","Promise","resolve","entry","id","presentation","status","settled","generation","requestDismiss","result","find","e","map","finalizeClose","next","filter","length","dismissTop","top","dismissToRoot","above","slice","undefined","dismissAll","ids","resetSurfaces","pending","__resetSurfacesForTests"],"sourceRoot":"../../../src","sources":["surfaces/surfaceStore.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/surfaces/types.js

@@ -0,0 +1,6 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=types.js.map

package/lib/commonjs/surfaces/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["surfaces/types.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/surfaces/useSurface.js

@@ -0,0 +1,36 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.SurfaceContext = void 0;
+exports.useSurface = useSurface;
+var _react = require("react");
+/**
+ * Context carrying the CURRENT surface's controls. The host wraps each presented
+ * surface's content in a provider bound to that entry's id, so a nested surface
+ * reads its OWN controls — `dismiss` targets this surface, `present` stacks a
+ * child above it.
+ */
+const SurfaceContext = exports.SurfaceContext = /*#__PURE__*/(0, _react.createContext)(null);
+SurfaceContext.displayName = 'BloomSurfaceContext';
+
+/**
+ * Read the current surface's {@link SurfaceControls} from inside a presented
+ * surface. Equivalent to the `surface` argument the render function receives —
+ * use whichever is convenient (props vs. context).
+ *
+ * DEPTH only: `dismiss` (resolve this surface's promise + close) and `present`
+ * (stack a child). Navigation within a surface is the SDK's route layer, not
+ * this hook.
+ *
+ * @throws if called outside a presented surface.
+ */
+function useSurface() {
+  const controls = (0, _react.useContext)(SurfaceContext);
+  if (!controls) {
+    throw new Error('useSurface must be called from within a presented surface (rendered by <SurfaceProvider>/<SurfaceHost>).');
+  }
+  return controls;
+}
+//# sourceMappingURL=useSurface.js.map

package/lib/commonjs/surfaces/useSurface.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","SurfaceContext","exports","createContext","displayName","useSurface","controls","useContext","Error"],"sourceRoot":"../../../src","sources":["surfaces/useSurface.ts"],"mappings":";;;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAIA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,cAAc,GAAAC,OAAA,CAAAD,cAAA,gBAAG,IAAAE,oBAAa,EAAyB,IAAI,CAAC;AACzEF,cAAc,CAACG,WAAW,GAAG,qBAAqB;;AAElD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,UAAUA,CAAA,EAAoB;EAC5C,MAAMC,QAAQ,GAAG,IAAAC,iBAAU,EAACN,cAAc,CAAC;EAC3C,IAAI,CAACK,QAAQ,EAAE;IACb,MAAM,IAAIE,KAAK,CACb,0GACF,CAAC;EACH;EACA,OAAOF,QAAQ;AACjB","ignoreList":[]}

package/lib/module/dialog/Dialog.js

@@ -4,7 +4,7 @@ import React, { useCallback, useEffect, useId, useImperativeHandle, useMemo, use
 import { Pressable, StyleSheet, useWindowDimensions, View } from 'react-native';
 import Animated, { cancelAnimation, Easing, runOnJS, useAnimatedStyle, useSharedValue, withTiming } from 'react-native-reanimated';
 import { BottomSheet } from '../bottom-sheet';
-import { Z_INDEX } from "../styles/z-index.js";
+import { Z_INDEX, Z_INDEX_LAYER_STEP } from "../styles/z-index.js";
 import { useTheme } from "../theme/use-theme.js";
 import { Context, useDialogControl } from "./context.js";
 import { DialogBody } from "./DialogContent.js";
@@ -73,6 +73,7 @@ function CenteredOrSideDialog({
   description,
   actions,
   placement,
+  layer,
   width = DEFAULT_SIDE_WIDTH,
   inset,
   dismissOnBackdrop = true,
@@ -196,6 +197,7 @@ function CenteredOrSideDialog({
         open: sideOpen,
         onDismiss: handleDismiss,
         side: placement,
+        layer: layer,
         width: width,
         inset: inset,
         dismissOnBackdrop: dismissOnBackdrop,
@@ -263,6 +265,7 @@ function SideSheet({
   open,
   onDismiss,
   side,
+  layer,
   width,
   inset,
   dismissOnBackdrop,
@@ -352,7 +355,12 @@ function SideSheet({
   }), [insetTop, insetBottom, side, anchorInset, sideWidth]);
   if (!mounted) return null;
   return /*#__PURE__*/_jsxs(View, {
-    style: [sideStyles.root, containerStyle],
+    style: [sideStyles.root,
+    // Per-layer offset so a side dialog stacked on top of another (surface
+    // stack) paints above it. Layer 0 → offset 0 → unchanged.
+    {
+      zIndex: Z_INDEX.fullscreen + Z_INDEX_LAYER_STEP * (layer ?? 0)
+    }, containerStyle],
     ...(containerClassName ? {
       className: containerClassName
     } : {}),
@@ -393,9 +401,10 @@ function SideSheet({
   });
 }
 const sideStyles = StyleSheet.create({
+  // `zIndex` is applied inline (`Z_INDEX.fullscreen + layer offset`) so a side
+  // dialog stacked on top of another paints above it in the surface stack.
   root: {
-    ...StyleSheet.absoluteFill,
-    zIndex: Z_INDEX.fullscreen
+    ...StyleSheet.absoluteFill
   },
   backdrop: {
     ...StyleSheet.absoluteFill,