@viveksinghind/narrative-form-native 1.0.2

package/dist/components/WelcomeScreen.d.ts

@@ -0,0 +1,9 @@
+import React from "react";
+import type { NarrativeWelcome, NarrativeTypewriter } from "@viveksinghind/narrative-form-core";
+export interface WelcomeScreenProps {
+    welcome: NarrativeWelcome;
+    typewriter: NarrativeTypewriter;
+    onStart: () => void;
+}
+export declare const WelcomeScreen: React.FC<WelcomeScreenProps>;
+//# sourceMappingURL=WelcomeScreen.d.ts.map

package/dist/components/WelcomeScreen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WelcomeScreen.d.ts","sourceRoot":"","sources":["../../src/components/WelcomeScreen.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAE3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAGhG,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,UAAU,EAAE,mBAAmB,CAAC;IAChC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAiDtD,CAAC"}

package/dist/components/WelcomeScreen.js

@@ -0,0 +1,63 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+import { Animated, Text, TouchableOpacity, StyleSheet } from "react-native";
+import { useTheme } from "./ThemeProvider";
+export const WelcomeScreen = ({ welcome, typewriter, onStart }) => {
+    const { theme, isDark } = useTheme();
+    const opacity = useRef(new Animated.Value(0)).current;
+    const [typedTitle, setTypedTitle] = useState("");
+    useEffect(() => {
+        Animated.timing(opacity, {
+            toValue: 1,
+            duration: 500,
+            useNativeDriver: true,
+        }).start();
+    }, [opacity]);
+    useEffect(() => {
+        var _a;
+        if (!typewriter.enabled) {
+            setTypedTitle(welcome.heading || "");
+            return;
+        }
+        let i = 0;
+        const interval = setInterval(() => {
+            setTypedTitle((welcome.heading || "").slice(0, i + 1));
+            i++;
+            if (i >= (welcome.heading || "").length) {
+                clearInterval(interval);
+            }
+        }, (_a = typewriter.speed) !== null && _a !== void 0 ? _a : 30);
+        return () => clearInterval(interval);
+    }, [welcome.heading, typewriter]);
+    const textColor = (theme === null || theme === void 0 ? void 0 : theme.textColor) || (isDark ? "#fff" : "#000");
+    const primaryColor = (theme === null || theme === void 0 ? void 0 : theme.buttonBackground) || "#007bff";
+    return (_jsxs(Animated.View, { style: [styles.container, { opacity }], children: [_jsx(Text, { style: [styles.title, { color: textColor }], children: typedTitle }), welcome.subtext && (_jsx(Text, { style: [styles.subtitle, { color: textColor, opacity: 0.7 }], children: welcome.subtext })), _jsx(TouchableOpacity, { style: [styles.button, { backgroundColor: primaryColor }], onPress: onStart, accessibilityRole: "button", children: _jsx(Text, { style: styles.buttonText, children: welcome.ctaLabel || "Start" }) })] }));
+};
+const styles = StyleSheet.create({
+    container: {
+        flex: 1,
+        justifyContent: "center",
+        alignItems: "flex-start",
+        padding: 20,
+    },
+    title: {
+        fontSize: 28,
+        fontWeight: "bold",
+        marginBottom: 8,
+    },
+    subtitle: {
+        fontSize: 16,
+        marginBottom: 24,
+    },
+    button: {
+        paddingHorizontal: 24,
+        paddingVertical: 12,
+        borderRadius: 8,
+    },
+    buttonText: {
+        color: "#fff",
+        fontSize: 16,
+        fontWeight: "600",
+    }
+});
+//# sourceMappingURL=WelcomeScreen.js.map

package/dist/components/WelcomeScreen.js.map

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

package/dist/hooks/useDynamicForm.d.ts

@@ -0,0 +1,18 @@
+import type { NarrativeFormConfig } from "@viveksinghind/narrative-form-core";
+export interface UseDynamicFormProps {
+    fieldsUrl?: string;
+    fieldsUrlHeaders?: Record<string, string>;
+    formConfig?: NarrativeFormConfig;
+    onFetchError?: (error: Error) => void;
+}
+export interface UseDynamicFormResult {
+    config: NarrativeFormConfig | null;
+    loading: boolean;
+    error: Error | null;
+    retry: () => void;
+}
+/**
+ * Hook to manage fetching and parsing server-driven form configuration.
+ */
+export declare function useDynamicForm({ fieldsUrl, fieldsUrlHeaders, formConfig, onFetchError, }: UseDynamicFormProps): UseDynamicFormResult;
+//# sourceMappingURL=useDynamicForm.d.ts.map

package/dist/hooks/useDynamicForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDynamicForm.d.ts","sourceRoot":"","sources":["../../src/hooks/useDynamicForm.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAG9E,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAC7B,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,YAAY,GACb,EAAE,mBAAmB,GAAG,oBAAoB,CAkD5C"}

package/dist/hooks/useDynamicForm.js

@@ -0,0 +1,50 @@
+import { useState, useEffect, useCallback } from "react";
+import { fetchFormConfig } from "@viveksinghind/narrative-form-core";
+/**
+ * Hook to manage fetching and parsing server-driven form configuration.
+ */
+export function useDynamicForm({ fieldsUrl, fieldsUrlHeaders, formConfig, onFetchError, }) {
+    const [config, setConfig] = useState(formConfig !== null && formConfig !== void 0 ? formConfig : null);
+    const [loading, setLoading] = useState(!!fieldsUrl && !formConfig);
+    const [error, setError] = useState(null);
+    const [retryCount, setRetryCount] = useState(0);
+    useEffect(() => {
+        // If a complete config is passed via props, use it immediately
+        if (formConfig) {
+            setConfig(formConfig);
+            setLoading(false);
+            setError(null);
+            return;
+        }
+        if (!fieldsUrl) {
+            return;
+        }
+        let isMounted = true;
+        setLoading(true);
+        setError(null);
+        fetchFormConfig(fieldsUrl, { headers: fieldsUrlHeaders })
+            .then((data) => {
+            if (isMounted) {
+                setConfig(data);
+                setLoading(false);
+            }
+        })
+            .catch((err) => {
+            if (isMounted) {
+                setError(err);
+                setLoading(false);
+                onFetchError === null || onFetchError === void 0 ? void 0 : onFetchError(err);
+            }
+        });
+        return () => {
+            isMounted = false;
+        };
+    }, [fieldsUrl, fieldsUrlHeaders, formConfig, retryCount, onFetchError]);
+    const retry = useCallback(() => {
+        if (fieldsUrl && !formConfig) {
+            setRetryCount((c) => c + 1);
+        }
+    }, [fieldsUrl, formConfig]);
+    return { config, loading, error, retry };
+}
+//# sourceMappingURL=useDynamicForm.js.map

package/dist/hooks/useDynamicForm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDynamicForm.js","sourceRoot":"","sources":["../../src/hooks/useDynamicForm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAoB,MAAM,oCAAoC,CAAC;AAgBvF;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,YAAY,GACQ;IACpB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAA6B,UAAU,aAAV,UAAU,cAAV,UAAU,GAAI,IAAI,CAAC,CAAC;IACrF,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAU,CAAC,CAAC,SAAS,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5E,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEhD,SAAS,CAAC,GAAG,EAAE;QACb,+DAA+D;QAC/D,IAAI,UAAU,EAAE,CAAC;YACf,SAAS,CAAC,UAAU,CAAC,CAAC;YACtB,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,IAAI,SAAS,GAAG,IAAI,CAAC;QACrB,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,eAAe,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC;aACtD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACb,IAAI,SAAS,EAAE,CAAC;gBACd,SAAS,CAAC,IAAI,CAAC,CAAC;gBAChB,UAAU,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;YACpB,IAAI,SAAS,EAAE,CAAC;gBACd,QAAQ,CAAC,GAAG,CAAC,CAAC;gBACd,UAAU,CAAC,KAAK,CAAC,CAAC;gBAClB,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAG,GAAG,CAAC,CAAC;YACtB,CAAC;QACH,CAAC,CAAC,CAAC;QAEL,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;IAExE,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,IAAI,SAAS,IAAI,CAAC,UAAU,EAAE,CAAC;YAC7B,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;IAE5B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC3C,CAAC"}

package/dist/hooks/useFormState.d.ts

@@ -0,0 +1,43 @@
+/**
+ * React hook wrapping the core FormStateEngine.
+ *
+ * @remarks
+ * Bridges the framework-agnostic FormStateEngine with React's
+ * state management. Each state mutation in the engine triggers
+ * a React re-render via `useSyncExternalStore`-like pattern.
+ */
+import type { NarrativeField, NarrativeFieldValues, NarrativeMeta } from "@viveksinghind/narrative-form-core";
+import type { FormStateSnapshot } from "@viveksinghind/narrative-form-core";
+/** Return value of the useFormState hook. */
+export interface UseFormStateResult {
+    /** Current snapshot of the form state. */
+    snapshot: FormStateSnapshot;
+    /** Start the typewriter animation for a field. */
+    startTyping: (key: string) => void;
+    /** Mark a field as active (typewriter done, input visible). */
+    activateField: (key: string) => void;
+    /** Confirm a field with a value. */
+    confirmField: (key: string, value: string | string[]) => void;
+    /** Reopen a confirmed field for editing. */
+    editField: (key: string) => void;
+    /** Re-confirm a field after editing. */
+    reconfirmField: (key: string, value: string | string[]) => void;
+    /** Move to the next field. */
+    next: () => void;
+    /** Focus a specific field by key. */
+    focusField: (key: string) => void;
+    /** Reset all form state. */
+    reset: () => void;
+    /** Get all confirmed values. */
+    getValues: () => NarrativeFieldValues;
+    /** Get analytics metadata. */
+    getMeta: (formId?: string, formVersion?: number) => NarrativeMeta;
+}
+/**
+ * React hook that manages the narrative form state.
+ *
+ * @param fields - Ordered array of field configurations
+ * @returns Form state and mutation methods
+ */
+export declare function useFormState(fields: readonly NarrativeField[]): UseFormStateResult;
+//# sourceMappingURL=useFormState.d.ts.map

package/dist/hooks/useFormState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormState.d.ts","sourceRoot":"","sources":["../../src/hooks/useFormState.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAE9G,OAAO,KAAK,EAAe,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAEzF,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,kDAAkD;IAClD,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,+DAA+D;IAC/D,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,oCAAoC;IACpC,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC;IAC9D,4CAA4C;IAC5C,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,wCAAwC;IACxC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC;IAChE,8BAA8B;IAC9B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,qCAAqC;IACrC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,4BAA4B;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,gCAAgC;IAChC,SAAS,EAAE,MAAM,oBAAoB,CAAC;IACtC,8BAA8B;IAC9B,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,aAAa,CAAC;CACnE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,GAAG,kBAAkB,CAwDlF"}

package/dist/hooks/useFormState.js

@@ -0,0 +1,57 @@
+/**
+ * React hook wrapping the core FormStateEngine.
+ *
+ * @remarks
+ * Bridges the framework-agnostic FormStateEngine with React's
+ * state management. Each state mutation in the engine triggers
+ * a React re-render via `useSyncExternalStore`-like pattern.
+ */
+import { useState, useRef, useCallback, useMemo } from "react";
+import { FormStateEngine } from "@viveksinghind/narrative-form-core";
+/**
+ * React hook that manages the narrative form state.
+ *
+ * @param fields - Ordered array of field configurations
+ * @returns Form state and mutation methods
+ */
+export function useFormState(fields) {
+    // Use a counter to force re-renders when the engine mutates
+    const [, setTick] = useState(0);
+    const engineRef = useRef(null);
+    // Lazily initialise the engine
+    if (engineRef.current === null) {
+        engineRef.current = new FormStateEngine(fields, () => {
+            setTick((t) => t + 1);
+        });
+    }
+    const engine = engineRef.current;
+    // Stable method references
+    const startTyping = useCallback((key) => engine.startTyping(key), [engine]);
+    const activateField = useCallback((key) => engine.activateField(key), [engine]);
+    const confirmField = useCallback((key, value) => engine.confirmField(key, value), [engine]);
+    const editField = useCallback((key) => engine.editField(key), [engine]);
+    const reconfirmField = useCallback((key, value) => engine.reconfirmField(key, value), [engine]);
+    const next = useCallback(() => engine.next(), [engine]);
+    const focusField = useCallback((key) => engine.focusField(key), [engine]);
+    const reset = useCallback(() => engine.reset(), [engine]);
+    const getValues = useCallback(() => engine.getValues(), [engine]);
+    const getMeta = useCallback((formId, formVersion) => engine.getMeta(formId, formVersion), [engine]);
+    const snapshot = engine.getSnapshot();
+    return useMemo(() => ({
+        snapshot,
+        startTyping,
+        activateField,
+        confirmField,
+        editField,
+        reconfirmField,
+        next,
+        focusField,
+        reset,
+        getValues,
+        getMeta,
+    }), 
+    // snapshot changes every tick, which is what we want
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [snapshot]);
+}
+//# sourceMappingURL=useFormState.js.map

package/dist/hooks/useFormState.js.map

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

package/dist/hooks/useTypewriter.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Core typewriter animation hook for narrative-form.
+ *
+ * @remarks
+ * Animates a string character by character to create the "letter being written"
+ * effect. Cleans up the interval on unmount to prevent memory leaks.
+ * Respects `prefers-reduced-motion` — skips animation entirely if set.
+ *
+ * @example
+ * ```tsx
+ * const { displayedText, isTyping, isComplete } = useTypewriter({
+ *   text: "My name is",
+ *   speed: 38,
+ * });
+ * ```
+ */
+/** Configuration options for the useTypewriter hook. */
+export interface UseTypewriterOptions {
+    /** The full text to type out. */
+    text: string;
+    /** Milliseconds per character. Default: 38 */
+    speed?: number;
+    /** Whether animation is enabled. Default: true */
+    enabled?: boolean;
+    /** Milliseconds to pause after typing completes before signalling done. Default: 100 */
+    pauseAfter?: number;
+    /** Callback fired when typing is fully complete (after pause). */
+    onComplete?: () => void;
+}
+/** Return value of the useTypewriter hook. */
+export interface UseTypewriterResult {
+    /** The currently visible portion of the text. */
+    displayedText: string;
+    /** Whether the typewriter is actively typing characters. */
+    isTyping: boolean;
+    /** Whether typing is fully complete (including the post-typing pause). */
+    isComplete: boolean;
+}
+/**
+ * React hook that animates text character by character.
+ *
+ * @param options - Typewriter configuration
+ * @returns Object with displayedText, isTyping, and isComplete
+ */
+export declare function useTypewriter(options: UseTypewriterOptions): UseTypewriterResult;
+//# sourceMappingURL=useTypewriter.d.ts.map

package/dist/hooks/useTypewriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTypewriter.d.ts","sourceRoot":"","sources":["../../src/hooks/useTypewriter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACnC,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,8CAA8C;AAC9C,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,EAAE,OAAO,CAAC;IAClB,0EAA0E;IAC1E,UAAU,EAAE,OAAO,CAAC;CACrB;AAWD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CAoEhF"}

package/dist/hooks/useTypewriter.js

@@ -0,0 +1,94 @@
+/**
+ * Core typewriter animation hook for narrative-form.
+ *
+ * @remarks
+ * Animates a string character by character to create the "letter being written"
+ * effect. Cleans up the interval on unmount to prevent memory leaks.
+ * Respects `prefers-reduced-motion` — skips animation entirely if set.
+ *
+ * @example
+ * ```tsx
+ * const { displayedText, isTyping, isComplete } = useTypewriter({
+ *   text: "My name is",
+ *   speed: 38,
+ * });
+ * ```
+ */
+import { useState, useEffect, useRef, useCallback } from "react";
+/**
+ * Check if the user prefers reduced motion.
+ * Guarded for SSR — returns false if `window` is not available.
+ */
+function prefersReducedMotion() {
+    if (typeof window === "undefined")
+        return false;
+    return window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+}
+/**
+ * React hook that animates text character by character.
+ *
+ * @param options - Typewriter configuration
+ * @returns Object with displayedText, isTyping, and isComplete
+ */
+export function useTypewriter(options) {
+    const { text, speed = 38, enabled = true, pauseAfter = 100, onComplete } = options;
+    const [charIndex, setCharIndex] = useState(0);
+    const [isComplete, setIsComplete] = useState(false);
+    const intervalRef = useRef(null);
+    const pauseTimeoutRef = useRef(null);
+    const onCompleteRef = useRef(onComplete);
+    // Keep onComplete ref fresh without triggering effect re-runs
+    onCompleteRef.current = onComplete;
+    // Clean up helper
+    const cleanup = useCallback(() => {
+        if (intervalRef.current !== null) {
+            clearInterval(intervalRef.current);
+            intervalRef.current = null;
+        }
+        if (pauseTimeoutRef.current !== null) {
+            clearTimeout(pauseTimeoutRef.current);
+            pauseTimeoutRef.current = null;
+        }
+    }, []);
+    useEffect(() => {
+        var _a;
+        // If animation is disabled or user prefers reduced motion, show everything instantly
+        if (!enabled || prefersReducedMotion() || text.length === 0) {
+            setCharIndex(text.length);
+            setIsComplete(true);
+            (_a = onCompleteRef.current) === null || _a === void 0 ? void 0 : _a.call(onCompleteRef);
+            return;
+        }
+        // Reset for new text
+        setCharIndex(0);
+        setIsComplete(false);
+        intervalRef.current = setInterval(() => {
+            setCharIndex((prev) => {
+                const next = prev + 1;
+                if (next >= text.length) {
+                    // All characters typed — clear interval, start pause
+                    if (intervalRef.current !== null) {
+                        clearInterval(intervalRef.current);
+                        intervalRef.current = null;
+                    }
+                    // Pause before signalling completion
+                    pauseTimeoutRef.current = setTimeout(() => {
+                        var _a;
+                        setIsComplete(true);
+                        (_a = onCompleteRef.current) === null || _a === void 0 ? void 0 : _a.call(onCompleteRef);
+                    }, pauseAfter);
+                    return text.length;
+                }
+                return next;
+            });
+        }, speed);
+        // Cleanup on unmount or text/speed/enabled change
+        return cleanup;
+    }, [text, speed, enabled, pauseAfter, cleanup]);
+    return {
+        displayedText: text.slice(0, charIndex),
+        isTyping: charIndex < text.length && !isComplete,
+        isComplete,
+    };
+}
+//# sourceMappingURL=useTypewriter.js.map

package/dist/hooks/useTypewriter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./components/NarrativeForm";
+export * from "./components/ThemeProvider";
+export * from "./components/ToastProvider";
+export * from "./components/WelcomeScreen";
+export * from "./components/DoneScreen";
+export * from "./components/Line";
+export * from "./components/ErrorMessage";
+export * from "./hooks/useFormState";
+export * from "./hooks/useDynamicForm";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export * from "./components/NarrativeForm";
+export * from "./components/ThemeProvider";
+export * from "./components/ToastProvider";
+export * from "./components/WelcomeScreen";
+export * from "./components/DoneScreen";
+export * from "./components/Line";
+export * from "./components/ErrorMessage";
+export * from "./hooks/useFormState";
+export * from "./hooks/useDynamicForm";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC"}