@flowsterix/react 0.8.1 → 0.9.0

package/dist/adapters/radixDialogHelpers.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Helper utilities for programmatically controlling Radix Dialog components
+ * in tour lifecycle hooks (onEnter, onResume, onExit).
+ */
+/**
+ * Wait for next animation frame + microtask flush.
+ * Use this to ensure DOM updates have completed after triggering UI changes.
+ */
+export declare const waitForDom: () => Promise<void>;
+export interface CreateRadixDialogHelpersParams {
+    /** Selector for the dialog content element (visible when open) */
+    contentSelector: string;
+    /** Selector for the trigger button that opens the dialog */
+    triggerSelector: string;
+}
+export interface RadixDialogHelpers {
+    /** Check if the dialog is currently open */
+    isOpen: () => boolean;
+    /** Open the dialog if not already open */
+    open: () => Promise<void>;
+    /** Close the dialog if currently open */
+    close: () => Promise<void>;
+}
+/**
+ * Create helpers for programmatically controlling a Radix Dialog.
+ *
+ * @example
+ * ```tsx
+ * const settingsDialog = createRadixDialogHelpers({
+ *   contentSelector: '[data-tour-target="settings-dialog"]',
+ *   triggerSelector: '[data-tour-target="settings-trigger"]',
+ * })
+ *
+ * // In flow step:
+ * {
+ *   id: 'settings-panel',
+ *   target: { selector: '[data-tour-target="settings-dialog"]' },
+ *   onEnter: settingsDialog.open,
+ *   onResume: settingsDialog.open,
+ *   onExit: settingsDialog.close,
+ *   content: <p>Configure your settings here</p>,
+ * }
+ * ```
+ */
+export declare const createRadixDialogHelpers: (params: CreateRadixDialogHelpersParams) => RadixDialogHelpers;
+//# sourceMappingURL=radixDialogHelpers.d.ts.map

package/dist/adapters/radixDialogHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radixDialogHelpers.d.ts","sourceRoot":"","sources":["../../src/adapters/radixDialogHelpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,UAAU,QAAO,OAAO,CAAC,IAAI,CAGvC,CAAA;AAEH,MAAM,WAAW,8BAA8B;IAC7C,kEAAkE;IAClE,eAAe,EAAE,MAAM,CAAA;IACvB,4DAA4D;IAC5D,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,MAAM,EAAE,MAAM,OAAO,CAAA;IACrB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,yCAAyC;IACzC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,wBAAwB,GACnC,QAAQ,8BAA8B,KACrC,kBA+BF,CAAA"}

package/dist/index.cjs

@@ -26,6 +26,7 @@ __export(index_exports, {
   TourPopoverPortal: () => TourPopoverPortal,
   TourProvider: () => TourProvider,
   createPathString: () => createPathString,
+  createRadixDialogHelpers: () => createRadixDialogHelpers,
   createWaitForPredicateController: () => createWaitForPredicateController,
   defaultAnimationAdapter: () => defaultAnimationAdapter,
   defaultLabels: () => defaultLabels,
@@ -53,7 +54,8 @@ __export(index_exports, {
   useTourLabels: () => useTourLabels,
   useTourOverlay: () => useTourOverlay,
   useTourTarget: () => useTourTarget,
-  useViewportRect: () => useViewportRect
+  useViewportRect: () => useViewportRect,
+  waitForDom: () => waitForDom
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -2872,6 +2874,34 @@ var useRadixDialogAdapter = (options = {}) => {
   };
 };
 
+// src/adapters/radixDialogHelpers.ts
+var waitForDom = () => new Promise(
+  (resolve) => requestAnimationFrame(() => setTimeout(resolve, 0))
+);
+var createRadixDialogHelpers = (params) => {
+  const { contentSelector, triggerSelector } = params;
+  const isOpen = () => {
+    if (typeof document === "undefined") return false;
+    return document.querySelector(contentSelector) !== null;
+  };
+  const open = async () => {
+    if (typeof document === "undefined") return;
+    if (isOpen()) return;
+    await waitForDom();
+    if (isOpen()) return;
+    const trigger = document.querySelector(triggerSelector);
+    trigger?.click();
+    await waitForDom();
+  };
+  const close = async () => {
+    if (typeof document === "undefined") return;
+    if (!isOpen()) return;
+    document.dispatchEvent(new KeyboardEvent("keydown", { key: "Escape" }));
+    await waitForDom();
+  };
+  return { isOpen, open, close };
+};
+
 // src/hooks/useDelayAdvance.ts
 var import_react18 = require("react");
 var getTimestamp = () => typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
@@ -4286,6 +4316,7 @@ var useHudMotion = () => {
   TourPopoverPortal,
   TourProvider,
   createPathString,
+  createRadixDialogHelpers,
   createWaitForPredicateController,
   defaultAnimationAdapter,
   defaultLabels,
@@ -4313,5 +4344,6 @@ var useHudMotion = () => {
   useTourLabels,
   useTourOverlay,
   useTourTarget,
-  useViewportRect
+  useViewportRect,
+  waitForDom
 });

package/dist/index.d.ts

@@ -18,6 +18,8 @@ export { useHudTargetIssue } from './hooks/useHudTargetIssue';
 export type { HudTargetIssue, UseHudTargetIssueOptions, UseHudTargetIssueResult, } from './hooks/useHudTargetIssue';
 export { useRadixDialogAdapter } from './adapters/radixDialog';
 export type { RadixDialogAdapterResult, UseRadixDialogAdapterOptions, } from './adapters/radixDialog';
+export { createRadixDialogHelpers, waitForDom } from './adapters/radixDialogHelpers';
+export type { CreateRadixDialogHelpersParams, RadixDialogHelpers, } from './adapters/radixDialogHelpers';
 export { useTourFocusDominance } from './hooks/useTourFocusDominance';
 export type { UseTourFocusDominanceOptions, UseTourFocusDominanceResult, } from './hooks/useTourFocusDominance';
 export { useTourControls } from './hooks/useTourControls';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"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"}

package/dist/index.mjs

@@ -2569,6 +2569,34 @@ var useRadixDialogAdapter = (options = {}) => {
   };
 };
 
+// src/adapters/radixDialogHelpers.ts
+var waitForDom = () => new Promise(
+  (resolve) => requestAnimationFrame(() => setTimeout(resolve, 0))
+);
+var createRadixDialogHelpers = (params) => {
+  const { contentSelector, triggerSelector } = params;
+  const isOpen = () => {
+    if (typeof document === "undefined") return false;
+    return document.querySelector(contentSelector) !== null;
+  };
+  const open = async () => {
+    if (typeof document === "undefined") return;
+    if (isOpen()) return;
+    await waitForDom();
+    if (isOpen()) return;
+    const trigger = document.querySelector(triggerSelector);
+    trigger?.click();
+    await waitForDom();
+  };
+  const close = async () => {
+    if (typeof document === "undefined") return;
+    if (!isOpen()) return;
+    document.dispatchEvent(new KeyboardEvent("keydown", { key: "Escape" }));
+    await waitForDom();
+  };
+  return { isOpen, open, close };
+};
+
 // src/hooks/useDelayAdvance.ts
 import { useEffect as useEffect13, useMemo as useMemo10, useState as useState10 } from "react";
 var getTimestamp = () => typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
@@ -3988,6 +4016,7 @@ export {
   TourPopoverPortal,
   TourProvider,
   createPathString,
+  createRadixDialogHelpers,
   createWaitForPredicateController,
   defaultAnimationAdapter,
   defaultLabels,
@@ -4015,5 +4044,6 @@ export {
   useTourLabels,
   useTourOverlay,
   useTourTarget,
-  useViewportRect
+  useViewportRect,
+  waitForDom
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowsterix/react",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "description": "React bindings for Flowsterix - guided tours and onboarding flows",
   "license": "MIT",
   "repository": {