@stewmore/expo-ai-react 0.1.0

package/build/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @stewmore/expo-ai-react
+ *
+ * React hooks for the Expo AI Runtime — `ai/react`-style ergonomics over the
+ * provider-agnostic {@link @stewmore/expo-ai-core} package. All hooks own an
+ * AbortController so `stop()` and unmount cancel cleanly, guard state updates
+ * after unmount, and treat cancellation as intentional (never an `error`).
+ */
+export { useCapabilities, type UseCapabilitiesResult } from './useCapabilities.js';
+export { useGenerate, type UseGenerateResult } from './useGenerate.js';
+export { useObject, type UseObjectResult } from './useObject.js';
+export { useChat, type UseChatResult, type ChatMessage, type ChatRole, } from './useChat.js';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EACL,OAAO,EACP,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,QAAQ,GACd,MAAM,cAAc,CAAC"}

package/build/index.js

@@ -0,0 +1,13 @@
+/**
+ * @stewmore/expo-ai-react
+ *
+ * React hooks for the Expo AI Runtime — `ai/react`-style ergonomics over the
+ * provider-agnostic {@link @stewmore/expo-ai-core} package. All hooks own an
+ * AbortController so `stop()` and unmount cancel cleanly, guard state updates
+ * after unmount, and treat cancellation as intentional (never an `error`).
+ */
+export { useCapabilities } from './useCapabilities.js';
+export { useGenerate } from './useGenerate.js';
+export { useObject } from './useObject.js';
+export { useChat, } from './useChat.js';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAA8B,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,WAAW,EAA0B,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAwB,MAAM,gBAAgB,CAAC;AACjE,OAAO,EACL,OAAO,GAIR,MAAM,cAAc,CAAC"}

package/build/internal.d.ts

@@ -0,0 +1,10 @@
+import { ExpoAIError } from '@stewmore/expo-ai-core';
+/** A ref that is `true` while the component is mounted, for post-await guards. */
+export declare function useIsMounted(): {
+    readonly current: boolean;
+};
+/** Normalize any thrown value to an ExpoAIError (provider unknown at this layer). */
+export declare function toError(value: unknown): ExpoAIError;
+/** Stopping a request is intentional, not an error to surface to the UI. */
+export declare function isCancelled(error: ExpoAIError): boolean;
+//# sourceMappingURL=internal.d.ts.map

package/build/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,kFAAkF;AAClF,wBAAgB,YAAY,IAAI;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAS5D;AAED,qFAAqF;AACrF,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAEnD;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAEvD"}

package/build/internal.js

@@ -0,0 +1,26 @@
+/**
+ * Small internals shared by the hooks. Kept dependency-free (react only) so the
+ * package stays testable under jsdom and usable on web.
+ */
+import { useEffect, useRef } from 'react';
+import { ExpoAIError } from '@stewmore/expo-ai-core';
+/** A ref that is `true` while the component is mounted, for post-await guards. */
+export function useIsMounted() {
+    const mounted = useRef(true);
+    useEffect(() => {
+        mounted.current = true;
+        return () => {
+            mounted.current = false;
+        };
+    }, []);
+    return mounted;
+}
+/** Normalize any thrown value to an ExpoAIError (provider unknown at this layer). */
+export function toError(value) {
+    return ExpoAIError.from(value, 'none');
+}
+/** Stopping a request is intentional, not an error to surface to the UI. */
+export function isCancelled(error) {
+    return error.code === 'CANCELLED';
+}
+//# sourceMappingURL=internal.js.map

package/build/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,kFAAkF;AAClF,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;QACvB,OAAO,GAAG,EAAE;YACV,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC;QAC1B,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,KAAkB;IAC5C,OAAO,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC;AACpC,CAAC"}

package/build/useCapabilities.d.ts

@@ -0,0 +1,21 @@
+import { type ExpoAIAvailability, type ExpoAICapabilities, type ExpoAIError, type ExpoAIProviderInfo } from '@stewmore/expo-ai-core';
+export type UseCapabilitiesResult = {
+    /** Capabilities of the best currently-available provider, or null while loading. */
+    capabilities: ExpoAICapabilities | null;
+    /** Availability of the best currently-available provider. */
+    availability: ExpoAIAvailability | null;
+    /** Every registered provider and its capabilities. */
+    providers: ExpoAIProviderInfo[] | null;
+    loading: boolean;
+    error: ExpoAIError | null;
+    /** Re-query availability/capabilities (e.g. after the user enables a model). */
+    refresh: () => void;
+};
+/**
+ * Query what the runtime can do on this device. Resolves capabilities,
+ * availability, and the full provider list on mount; call `refresh()` to re-query
+ * (capabilities can change when the user toggles Apple Intelligence, finishes a
+ * model download, etc.).
+ */
+export declare function useCapabilities(): UseCapabilitiesResult;
+//# sourceMappingURL=useCapabilities.d.ts.map

package/build/useCapabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCapabilities.d.ts","sourceRoot":"","sources":["../src/useCapabilities.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACxB,MAAM,wBAAwB,CAAC;AAIhC,MAAM,MAAM,qBAAqB,GAAG;IAClC,oFAAoF;IACpF,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACxC,6DAA6D;IAC7D,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACxC,sDAAsD;IACtD,SAAS,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,gFAAgF;IAChF,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAYF;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,qBAAqB,CAyBvD"}

package/build/useCapabilities.js

@@ -0,0 +1,42 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { ExpoAI, } from '@stewmore/expo-ai-core';
+import { toError, useIsMounted } from './internal.js';
+const INITIAL = {
+    capabilities: null,
+    availability: null,
+    providers: null,
+    loading: true,
+    error: null,
+};
+/**
+ * Query what the runtime can do on this device. Resolves capabilities,
+ * availability, and the full provider list on mount; call `refresh()` to re-query
+ * (capabilities can change when the user toggles Apple Intelligence, finishes a
+ * model download, etc.).
+ */
+export function useCapabilities() {
+    const [state, setState] = useState(INITIAL);
+    const mounted = useIsMounted();
+    const requestId = useRef(0);
+    const refresh = useCallback(() => {
+        const id = ++requestId.current;
+        setState((prev) => ({ ...prev, loading: true, error: null }));
+        Promise.all([ExpoAI.getCapabilities(), ExpoAI.getAvailability(), ExpoAI.listProviders()])
+            .then(([capabilities, availability, providers]) => {
+            // Ignore a resolution superseded by a newer refresh, or after unmount.
+            if (!mounted.current || id !== requestId.current)
+                return;
+            setState({ capabilities, availability, providers, loading: false, error: null });
+        })
+            .catch((caught) => {
+            if (!mounted.current || id !== requestId.current)
+                return;
+            setState((prev) => ({ ...prev, loading: false, error: toError(caught) }));
+        });
+    }, [mounted]);
+    useEffect(() => {
+        refresh();
+    }, [refresh]);
+    return { ...state, refresh };
+}
+//# sourceMappingURL=useCapabilities.js.map

package/build/useCapabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCapabilities.js","sourceRoot":"","sources":["../src/useCapabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjE,OAAO,EACL,MAAM,GAKP,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAiBtD,MAAM,OAAO,GAAU;IACrB,YAAY,EAAE,IAAI;IAClB,YAAY,EAAE,IAAI;IAClB,SAAS,EAAE,IAAI;IACf,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,IAAI;CACZ,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAQ,OAAO,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAE5B,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;QAC/B,MAAM,EAAE,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC;QAC/B,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,MAAM,CAAC,eAAe,EAAE,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;aACtF,IAAI,CAAC,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,EAAE;YAChD,uEAAuE;YACvE,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,KAAK,SAAS,CAAC,OAAO;gBAAE,OAAO;YACzD,QAAQ,CAAC,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnF,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE;YAChB,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,KAAK,SAAS,CAAC,OAAO;gBAAE,OAAO;YACzD,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5E,CAAC,CAAC,CAAC;IACP,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,EAAE,CAAC;IACZ,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC"}

package/build/useChat.d.ts

@@ -0,0 +1,27 @@
+import { type CreateSessionOptions, type ExpoAIError } from '@stewmore/expo-ai-core';
+export type ChatRole = 'user' | 'assistant';
+export type ChatMessage = {
+    id: string;
+    role: ChatRole;
+    content: string;
+};
+export type UseChatResult = {
+    messages: ChatMessage[];
+    input: string;
+    setInput: (value: string) => void;
+    /** Send a turn (defaults to the current `input`) and stream the assistant reply. */
+    append: (content?: string) => Promise<void>;
+    isLoading: boolean;
+    error: ExpoAIError | null;
+    /** Abort the in-flight reply. Cancellation is not surfaced as an error. */
+    stop: () => void;
+    /** Dispose the session and clear the transcript. */
+    reset: () => Promise<void>;
+};
+/**
+ * A streaming chat transcript over a cross-platform {@link ExpoAISession}. The
+ * session is created lazily on the first `append` and disposed on unmount.
+ * `options` is captured on first use; later changes are ignored.
+ */
+export declare function useChat(options?: CreateSessionOptions): UseChatResult;
+//# sourceMappingURL=useChat.d.ts.map

package/build/useChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChat.d.ts","sourceRoot":"","sources":["../src/useChat.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAEjB,MAAM,wBAAwB,CAAC;AAIhC,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE5C,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,oFAAoF;IACpF,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,oDAAoD;IACpD,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,aAAa,CA+GrE"}

package/build/useChat.js

@@ -0,0 +1,108 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { ExpoAI, } from '@stewmore/expo-ai-core';
+import { isCancelled, toError, useIsMounted } from './internal.js';
+/**
+ * A streaming chat transcript over a cross-platform {@link ExpoAISession}. The
+ * session is created lazily on the first `append` and disposed on unmount.
+ * `options` is captured on first use; later changes are ignored.
+ */
+export function useChat(options) {
+    const [messages, setMessages] = useState([]);
+    const [input, setInput] = useState('');
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const sessionRef = useRef(null);
+    const controllerRef = useRef(null);
+    const idRef = useRef(0);
+    const optionsRef = useRef(options);
+    const mounted = useIsMounted();
+    const nextId = useCallback((role) => `${role}-${++idRef.current}`, []);
+    const disposeSession = useCallback(() => {
+        const session = sessionRef.current;
+        sessionRef.current = null;
+        void session?.dispose().catch(() => { });
+    }, []);
+    // Abort the in-flight reply and dispose the session on unmount.
+    useEffect(() => () => {
+        controllerRef.current?.abort();
+        disposeSession();
+    }, [disposeSession]);
+    const stop = useCallback(() => {
+        controllerRef.current?.abort();
+    }, []);
+    const append = useCallback(async (content) => {
+        const text = (content ?? input).trim();
+        if (text.length === 0)
+            return;
+        controllerRef.current?.abort();
+        const controller = new AbortController();
+        controllerRef.current = controller;
+        const isCurrent = () => controllerRef.current === controller;
+        const assistantId = nextId('assistant');
+        setMessages((prev) => [
+            ...prev,
+            { id: nextId('user'), role: 'user', content: text },
+            { id: assistantId, role: 'assistant', content: '' },
+        ]);
+        if (content === undefined)
+            setInput('');
+        setError(null);
+        setIsLoading(true);
+        try {
+            if (!sessionRef.current) {
+                // createSession is not abortable; if we unmounted (or another append
+                // already created one) while it was pending, dispose this one.
+                const created = await ExpoAI.createSession(optionsRef.current);
+                if (!mounted.current || sessionRef.current) {
+                    void created.dispose().catch(() => { });
+                    if (!mounted.current)
+                        return;
+                }
+                else {
+                    sessionRef.current = created;
+                }
+            }
+            const session = sessionRef.current;
+            if (!session)
+                return;
+            for await (const chunk of session.stream({ prompt: text, signal: controller.signal })) {
+                if (!isCurrent())
+                    break;
+                if (chunk.type === 'delta' && mounted.current) {
+                    setMessages((prev) => prev.map((message) => message.id === assistantId
+                        ? { ...message, content: message.content + chunk.text }
+                        : message));
+                }
+            }
+        }
+        catch (caught) {
+            const normalized = toError(caught);
+            if (mounted.current && isCurrent()) {
+                // Drop the still-empty assistant placeholder; surface the error instead.
+                setMessages((prev) => prev.filter((message) => !(message.id === assistantId && message.content === '')));
+                if (!isCancelled(normalized))
+                    setError(normalized);
+            }
+        }
+        finally {
+            if (isCurrent()) {
+                controllerRef.current = null;
+                if (mounted.current)
+                    setIsLoading(false);
+            }
+        }
+    }, [input, mounted, nextId]);
+    const reset = useCallback(async () => {
+        controllerRef.current?.abort();
+        const session = sessionRef.current;
+        sessionRef.current = null;
+        if (mounted.current) {
+            setMessages([]);
+            setError(null);
+            setIsLoading(false);
+        }
+        await session?.dispose().catch(() => { });
+    }, [mounted]);
+    return { messages, input, setInput, append, isLoading, error, stop, reset };
+}
+//# sourceMappingURL=useChat.js.map

package/build/useChat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChat.js","sourceRoot":"","sources":["../src/useChat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjE,OAAO,EACL,MAAM,GAIP,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAwBnE;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,OAA8B;IACpD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAgB,EAAE,CAAC,CAAC;IAC5D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAqB,IAAI,CAAC,CAAC;IAE7D,MAAM,UAAU,GAAG,MAAM,CAAuB,IAAI,CAAC,CAAC;IACtD,MAAM,aAAa,GAAG,MAAM,CAAyB,IAAI,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;IAE/B,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,IAAc,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IAEjF,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;QACtC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;QACnC,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,KAAK,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC1C,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,gEAAgE;IAChE,SAAS,CACP,GAAG,EAAE,CAAC,GAAG,EAAE;QACT,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QAC/B,cAAc,EAAE,CAAC;IACnB,CAAC,EACD,CAAC,cAAc,CAAC,CACjB,CAAC;IAEF,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5B,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;IACjC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,MAAM,GAAG,WAAW,CACxB,KAAK,EAAE,OAAgB,EAAiB,EAAE;QACxC,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAE9B,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,aAAa,CAAC,OAAO,GAAG,UAAU,CAAC;QACnC,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,aAAa,CAAC,OAAO,KAAK,UAAU,CAAC;QAE7D,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACxC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACpB,GAAG,IAAI;YACP,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE;YACnD,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE;SACpD,CAAC,CAAC;QACH,IAAI,OAAO,KAAK,SAAS;YAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QACxC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,YAAY,CAAC,IAAI,CAAC,CAAC;QAEnB,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;gBACxB,qEAAqE;gBACrE,+DAA+D;gBAC/D,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;gBAC/D,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;oBAC3C,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;oBACvC,IAAI,CAAC,OAAO,CAAC,OAAO;wBAAE,OAAO;gBAC/B,CAAC;qBAAM,CAAC;oBACN,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;gBAC/B,CAAC;YACH,CAAC;YACD,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;YACnC,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;gBACtF,IAAI,CAAC,SAAS,EAAE;oBAAE,MAAM;gBACxB,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBAC9C,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CACnB,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACnB,OAAO,CAAC,EAAE,KAAK,WAAW;wBACxB,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE;wBACvD,CAAC,CAAC,OAAO,CACZ,CACF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YACnC,IAAI,OAAO,CAAC,OAAO,IAAI,SAAS,EAAE,EAAE,CAAC;gBACnC,yEAAyE;gBACzE,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CACnB,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,WAAW,IAAI,OAAO,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAClF,CAAC;gBACF,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC;oBAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,SAAS,EAAE,EAAE,CAAC;gBAChB,aAAa,CAAC,OAAO,GAAG,IAAI,CAAC;gBAC7B,IAAI,OAAO,CAAC,OAAO;oBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC,EACD,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CACzB,CAAC;IAEF,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,IAAmB,EAAE;QAClD,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;QACnC,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,WAAW,CAAC,EAAE,CAAC,CAAC;YAChB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,MAAM,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC3C,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC9E,CAAC"}

package/build/useGenerate.d.ts

@@ -0,0 +1,23 @@
+import { type ExpoAIError, type GenerateOptions, type GenerateResult } from '@stewmore/expo-ai-core';
+export type UseGenerateResult = {
+    /** One-shot generation. Resolves the result, or undefined on error/cancel. */
+    generate: (options: GenerateOptions) => Promise<GenerateResult | undefined>;
+    /** Streamed generation. `text` accumulates as tokens arrive. */
+    stream: (options: GenerateOptions) => Promise<GenerateResult | undefined>;
+    /** Generated text (accumulates during `stream`, set whole by `generate`). */
+    text: string;
+    /** Final result with provider + privacy metadata, once complete. */
+    result: GenerateResult | null;
+    isLoading: boolean;
+    error: ExpoAIError | null;
+    /** Abort the in-flight request. Cancellation is not surfaced as an error. */
+    stop: () => void;
+    /** Clear text/result/error back to the initial state. */
+    reset: () => void;
+};
+/**
+ * Imperatively generate text — one-shot via `generate` or token-streamed via
+ * `stream`. Owns an AbortController so `stop()` (and unmount) cancel cleanly.
+ */
+export declare function useGenerate(): UseGenerateResult;
+//# sourceMappingURL=useGenerate.d.ts.map

package/build/useGenerate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGenerate.d.ts","sourceRoot":"","sources":["../src/useGenerate.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAIhC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,8EAA8E;IAC9E,QAAQ,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAC5E,gEAAgE;IAChE,MAAM,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAC1E,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,yDAAyD;IACzD,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,WAAW,IAAI,iBAAiB,CAmG/C"}

package/build/useGenerate.js

@@ -0,0 +1,100 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { ExpoAI, } from '@stewmore/expo-ai-core';
+import { isCancelled, toError, useIsMounted } from './internal.js';
+/**
+ * Imperatively generate text — one-shot via `generate` or token-streamed via
+ * `stream`. Owns an AbortController so `stop()` (and unmount) cancel cleanly.
+ */
+export function useGenerate() {
+    const [text, setText] = useState('');
+    const [result, setResult] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const controllerRef = useRef(null);
+    const mounted = useIsMounted();
+    // Abort any in-flight request when the component unmounts.
+    useEffect(() => () => controllerRef.current?.abort(), []);
+    const stop = useCallback(() => {
+        controllerRef.current?.abort();
+    }, []);
+    const reset = useCallback(() => {
+        setText('');
+        setResult(null);
+        setError(null);
+    }, []);
+    const begin = useCallback(() => {
+        controllerRef.current?.abort();
+        const controller = new AbortController();
+        controllerRef.current = controller;
+        setText('');
+        setResult(null);
+        setError(null);
+        setIsLoading(true);
+        return controller;
+    }, []);
+    // Only the controller still owning the ref may write state — a superseded
+    // call (aborted by a newer begin()) must not clobber the live request.
+    const isCurrent = useCallback((controller) => {
+        return controllerRef.current === controller;
+    }, []);
+    const finish = useCallback((controller) => {
+        if (!isCurrent(controller))
+            return;
+        controllerRef.current = null;
+        if (mounted.current)
+            setIsLoading(false);
+    }, [isCurrent, mounted]);
+    const generate = useCallback(async (options) => {
+        const controller = begin();
+        try {
+            const generated = await ExpoAI.generate({ ...options, signal: controller.signal });
+            if (mounted.current && isCurrent(controller)) {
+                setResult(generated);
+                setText(generated.text);
+            }
+            return generated;
+        }
+        catch (caught) {
+            const normalized = toError(caught);
+            if (mounted.current && isCurrent(controller) && !isCancelled(normalized)) {
+                setError(normalized);
+            }
+            return undefined;
+        }
+        finally {
+            finish(controller);
+        }
+    }, [begin, finish, isCurrent, mounted]);
+    const stream = useCallback(async (options) => {
+        const controller = begin();
+        let final;
+        try {
+            for await (const chunk of ExpoAI.stream({ ...options, signal: controller.signal })) {
+                if (!isCurrent(controller))
+                    break;
+                if (chunk.type === 'delta') {
+                    if (mounted.current)
+                        setText((current) => current + chunk.text);
+                }
+                else if (chunk.type === 'done') {
+                    final = chunk.result;
+                    if (mounted.current)
+                        setResult(chunk.result);
+                }
+            }
+            return final;
+        }
+        catch (caught) {
+            const normalized = toError(caught);
+            if (mounted.current && isCurrent(controller) && !isCancelled(normalized)) {
+                setError(normalized);
+            }
+            return undefined;
+        }
+        finally {
+            finish(controller);
+        }
+    }, [begin, finish, isCurrent, mounted]);
+    return { generate, stream, text, result, isLoading, error, stop, reset };
+}
+//# sourceMappingURL=useGenerate.js.map

package/build/useGenerate.js.map

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

package/build/useObject.d.ts

@@ -0,0 +1,20 @@
+import { type DeepPartial, type ExpoAIError, type StreamObjectOptions } from '@stewmore/expo-ai-core';
+export type UseObjectResult<T> = {
+    /** Start streaming a structured object. Resolves the validated value, or undefined. */
+    submit: (options: StreamObjectOptions) => Promise<T | undefined>;
+    /** Best-effort partial snapshot, growing as tokens arrive; the final validated value last. */
+    object: DeepPartial<T> | null;
+    isLoading: boolean;
+    error: ExpoAIError | null;
+    /** Abort the in-flight stream. Cancellation is not surfaced as an error. */
+    stop: () => void;
+    /** Clear object/error back to the initial state. */
+    reset: () => void;
+};
+/**
+ * Stream a structured object into React state. `object` updates with each partial
+ * snapshot as tokens arrive, then becomes the validated (repaired) final value.
+ * Built on {@link ExpoAI.streamObject}.
+ */
+export declare function useObject<T = unknown>(): UseObjectResult<T>;
+//# sourceMappingURL=useObject.d.ts.map

package/build/useObject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useObject.d.ts","sourceRoot":"","sources":["../src/useObject.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AAIhC,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;IAC/B,uFAAuF;IACvF,MAAM,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACjE,8FAA8F;IAC9F,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,4EAA4E;IAC5E,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,oDAAoD;IACpD,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,KAAK,eAAe,CAAC,CAAC,CAAC,CAqD3D"}

package/build/useObject.js

@@ -0,0 +1,61 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { ExpoAI, } from '@stewmore/expo-ai-core';
+import { isCancelled, toError, useIsMounted } from './internal.js';
+/**
+ * Stream a structured object into React state. `object` updates with each partial
+ * snapshot as tokens arrive, then becomes the validated (repaired) final value.
+ * Built on {@link ExpoAI.streamObject}.
+ */
+export function useObject() {
+    const [object, setObject] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const controllerRef = useRef(null);
+    const mounted = useIsMounted();
+    useEffect(() => () => controllerRef.current?.abort(), []);
+    const stop = useCallback(() => {
+        controllerRef.current?.abort();
+    }, []);
+    const reset = useCallback(() => {
+        setObject(null);
+        setError(null);
+    }, []);
+    const submit = useCallback(async (options) => {
+        controllerRef.current?.abort();
+        const controller = new AbortController();
+        controllerRef.current = controller;
+        setObject(null);
+        setError(null);
+        setIsLoading(true);
+        const isCurrent = () => controllerRef.current === controller;
+        const handle = ExpoAI.streamObject({ ...options, signal: controller.signal });
+        try {
+            for await (const partial of handle.partialObjectStream) {
+                if (!isCurrent())
+                    break;
+                if (mounted.current)
+                    setObject(partial);
+            }
+            const final = await handle.object;
+            if (mounted.current && isCurrent())
+                setObject(final);
+            return final;
+        }
+        catch (caught) {
+            const normalized = toError(caught);
+            // Only the live submit may write state — a superseded one must not clobber it.
+            if (mounted.current && isCurrent() && !isCancelled(normalized))
+                setError(normalized);
+            return undefined;
+        }
+        finally {
+            if (isCurrent()) {
+                controllerRef.current = null;
+                if (mounted.current)
+                    setIsLoading(false);
+            }
+        }
+    }, [mounted]);
+    return { submit, object, isLoading, error, stop, reset };
+}
+//# sourceMappingURL=useObject.js.map

package/build/useObject.js.map

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

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@stewmore/expo-ai-react",
+  "version": "0.1.0",
+  "description": "React hooks for the Expo AI Runtime: useGenerate, useChat, useObject, useCapabilities — ai/react-style ergonomics over the on-device, privacy-first core.",
+  "license": "MIT",
+  "author": "Stewart Moreland <stewart.moreland@gmail.com>",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./build/index.js",
+  "module": "./build/index.js",
+  "types": "./build/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/index.d.ts",
+      "default": "./build/index.js"
+    }
+  },
+  "files": [
+    "build",
+    "src"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "expo",
+    "react-native",
+    "react",
+    "hooks",
+    "ai",
+    "on-device",
+    "streaming"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepack": "npm run build",
+    "clean": "rm -rf build",
+    "typecheck": "tsc --noEmit -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "@stewmore/expo-ai-core": "^0.1.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "~19.2.0",
+    "@vitest/coverage-v8": "^4.1.9",
+    "jsdom": "^26.0.0",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "typescript": "~6.0.3",
+    "vitest": "^4.1.9"
+  }
+}