@caltra/react 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Caltra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,29 @@
+# `@caltra/react`
+
+React adapter that exposes a durable Caltra session as an assistant-ui external-store runtime. It supplies the runtime integration, not presentation components.
+
+## Install
+
+```bash
+npm install @caltra/client @caltra/react @assistant-ui/react react react-dom
+```
+
+## Use
+
+```tsx
+import { AssistantRuntimeProvider } from "@assistant-ui/react";
+import { useCaltraRuntime } from "@caltra/react";
+import type { CaltraClient } from "@caltra/client";
+
+export function CaltraSession(props: { client: CaltraClient; sessionId: string }) {
+  const { runtime } = useCaltraRuntime(props);
+
+  return (
+    <AssistantRuntimeProvider runtime={runtime}>
+      {/* Render assistant-ui thread components here. */}
+    </AssistantRuntimeProvider>
+  );
+}
+```
+
+The package is ESM-only and requires `@caltra/client`. See the [Caltra SDK repository](https://github.com/caltra-dev/caltra-sdk) for a complete local integration application.

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { CaltraSessionStore } from "./session_store.js";
+export type { CaltraConnectionState, CaltraSessionSnapshot, CaltraSessionStoreOptions, } from "./session_store.js";
+export { useCaltraRuntime } from "./use_caltra_runtime.js";
+export type { UseCaltraRuntimeOptions, UseCaltraRuntimeResult, } from "./use_caltra_runtime.js";
+//# 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,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EACV,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { CaltraSessionStore } from "./session_store.js";
+export { useCaltraRuntime } from "./use_caltra_runtime.js";
+//# 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,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAMxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/session_store.d.ts

@@ -0,0 +1,38 @@
+import { type CaltraClient, type CaltraSessionMessage } from "@caltra/client";
+export type CaltraConnectionState = "connecting" | "connected" | "recovering" | "failed";
+export interface CaltraSessionSnapshot {
+    connection: CaltraConnectionState;
+    error: Error | null;
+    isRunning: boolean;
+    messages: readonly CaltraSessionMessage[];
+}
+export interface CaltraSessionStoreOptions {
+    retryDelay?: (attempt: number) => Promise<void>;
+}
+/** Owns reconnectable session state while keeping React and assistant-ui as presentation layers. */
+export declare class CaltraSessionStore {
+    private readonly client;
+    private readonly sessionId;
+    private readonly options;
+    private abortController?;
+    private connection?;
+    private readonly listeners;
+    private readyPromise?;
+    private rejectReady?;
+    private resolveReady?;
+    private snapshot;
+    constructor(client: CaltraClient, sessionId: string, options?: CaltraSessionStoreOptions);
+    readonly subscribe: (listener: () => void) => (() => void);
+    readonly getSnapshot: () => CaltraSessionSnapshot;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    refresh(): Promise<void>;
+    send(text: string): Promise<void>;
+    private run;
+    private consume;
+    private apply;
+    private update;
+    private toError;
+    private readonly delay;
+}
+//# sourceMappingURL=session_store.d.ts.map

package/dist/session_store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session_store.d.ts","sourceRoot":"","sources":["../src/session_store.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,oBAAoB,EAC1B,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEzF,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,qBAAqB,CAAC;IAClC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED,oGAAoG;AACpG,qBAAa,kBAAkB;IAe3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAhB1B,OAAO,CAAC,eAAe,CAAC,CAAkB;IAC1C,OAAO,CAAC,UAAU,CAAC,CAAyD;IAC5E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,YAAY,CAAC,CAAgB;IACrC,OAAO,CAAC,WAAW,CAAC,CAA4B;IAChD,OAAO,CAAC,YAAY,CAAC,CAAa;IAClC,OAAO,CAAC,QAAQ,CAKd;gBAGiB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,yBAA8B;IAG1D,QAAQ,CAAC,SAAS,GAAI,UAAU,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAGvD;IAEF,QAAQ,CAAC,WAAW,QAAO,qBAAqB,CAAkB;IAE5D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAYrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAKxB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YA2BzB,GAAG;YA+BH,OAAO;YAUP,KAAK;IA2CnB,OAAO,CAAC,MAAM;IAKd,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,QAAQ,CAAC,KAAK,CAEpB;CACH"}

package/dist/session_store.js

@@ -0,0 +1,178 @@
+import { CaltraApiError, } from "@caltra/client";
+/** Owns reconnectable session state while keeping React and assistant-ui as presentation layers. */
+export class CaltraSessionStore {
+    client;
+    sessionId;
+    options;
+    abortController;
+    connection;
+    listeners = new Set();
+    readyPromise;
+    rejectReady;
+    resolveReady;
+    snapshot = {
+        connection: "connecting",
+        error: null,
+        isRunning: false,
+        messages: [],
+    };
+    constructor(client, sessionId, options = {}) {
+        this.client = client;
+        this.sessionId = sessionId;
+        this.options = options;
+    }
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    };
+    getSnapshot = () => this.snapshot;
+    async start() {
+        if (this.readyPromise)
+            return await this.readyPromise;
+        this.abortController = new AbortController();
+        this.readyPromise = new Promise((resolve, reject) => {
+            this.resolveReady = resolve;
+            this.rejectReady = reject;
+        });
+        void this.run(this.abortController.signal);
+        return await this.readyPromise;
+    }
+    async stop() {
+        const connection = this.connection;
+        this.abortController?.abort();
+        this.abortController = undefined;
+        this.connection = undefined;
+        this.readyPromise = undefined;
+        this.rejectReady?.(new Error("The Caltra session connection was stopped."));
+        this.rejectReady = undefined;
+        this.resolveReady = undefined;
+        await connection?.close().catch(() => undefined);
+    }
+    async refresh() {
+        const page = await this.client.listSessionMessages(this.sessionId, { limit: 100 });
+        this.update({ messages: page.data });
+    }
+    async send(text) {
+        await this.start();
+        const temporaryId = `pending-${crypto.randomUUID()}`;
+        const optimistic = {
+            created_at: new Date().toISOString(),
+            id: temporaryId,
+            role: "user",
+            status: "completed",
+            text,
+        };
+        this.update({ messages: [...this.snapshot.messages, optimistic] });
+        try {
+            const submitted = await this.client.sendMessage(this.sessionId, { text });
+            this.update({
+                messages: this.snapshot.messages.map((message) => message.id === temporaryId
+                    ? { ...message, id: submitted.message_id }
+                    : message),
+            });
+        }
+        catch (error) {
+            this.update({
+                error: this.toError(error),
+                messages: this.snapshot.messages.filter((message) => message.id !== temporaryId),
+            });
+            throw error;
+        }
+    }
+    async run(signal) {
+        let attempt = 0;
+        while (!signal.aborted) {
+            try {
+                this.update({ connection: attempt === 0 ? "connecting" : "recovering", error: null });
+                this.connection = await this.client.openSessionEvents(this.sessionId, { signal });
+                await this.refresh();
+                this.update({ connection: "connected", error: null });
+                this.resolveReady?.();
+                this.resolveReady = undefined;
+                this.rejectReady = undefined;
+                attempt = 0;
+                await this.consume(this.connection, signal);
+                if (!signal.aborted)
+                    throw new Error("The Caltra event stream closed.");
+            }
+            catch (error) {
+                if (signal.aborted)
+                    return;
+                const currentError = this.toError(error);
+                if (error instanceof CaltraApiError && error.status === 401) {
+                    await this.client.invalidateToken();
+                }
+                else if (error instanceof CaltraApiError && !error.retryable) {
+                    this.update({ connection: "failed", error: currentError });
+                    this.rejectReady?.(error);
+                    return;
+                }
+                attempt += 1;
+                this.update({ connection: "recovering", error: currentError });
+                await (this.options.retryDelay ?? this.delay)(attempt);
+            }
+        }
+    }
+    async consume(connection, signal) {
+        for await (const event of connection) {
+            if (signal.aborted)
+                return;
+            await this.apply(event);
+        }
+    }
+    async apply(event) {
+        if (event.event === "message.started") {
+            if (!this.snapshot.messages.some((message) => message.id === event.data.message_id)) {
+                this.update({
+                    isRunning: true,
+                    messages: [...this.snapshot.messages, {
+                            created_at: new Date().toISOString(),
+                            id: event.data.message_id,
+                            role: "assistant",
+                            status: "streaming",
+                            text: "",
+                        }],
+                });
+            }
+            else {
+                this.update({ isRunning: true });
+            }
+            return;
+        }
+        if (event.event === "message.delta") {
+            const existing = this.snapshot.messages.some((message) => message.id === event.data.message_id);
+            const messages = existing
+                ? this.snapshot.messages.map((message) => message.id === event.data.message_id
+                    ? { ...message, status: "streaming", text: message.text + event.data.delta }
+                    : message)
+                : [...this.snapshot.messages, {
+                        created_at: new Date().toISOString(),
+                        id: event.data.message_id,
+                        role: "assistant",
+                        status: "streaming",
+                        text: event.data.delta,
+                    }];
+            this.update({ isRunning: true, messages });
+            return;
+        }
+        this.update({
+            isRunning: false,
+            messages: this.snapshot.messages.map((message) => message.id === event.data.message_id
+                ? { ...message, status: "completed" }
+                : message),
+        });
+        await this.refresh();
+    }
+    update(update) {
+        this.snapshot = { ...this.snapshot, ...update };
+        for (const listener of this.listeners)
+            listener();
+    }
+    toError(error) {
+        return error instanceof Error ? error : new Error("Unknown Caltra session error.");
+    }
+    delay = async (attempt) => {
+        await new Promise((resolve) => setTimeout(resolve, Math.min(250 * 2 ** (attempt - 1), 5_000)));
+    };
+}
+//# sourceMappingURL=session_store.js.map

package/dist/session_store.js.map

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

package/dist/use_caltra_runtime.d.ts

@@ -0,0 +1,16 @@
+import { type AssistantRuntime } from "@assistant-ui/react";
+import type { CaltraClient } from "@caltra/client";
+import { type CaltraConnectionState } from "./session_store.js";
+export interface UseCaltraRuntimeOptions {
+    client: CaltraClient;
+    sessionId: string;
+}
+export interface UseCaltraRuntimeResult {
+    connection: CaltraConnectionState;
+    error: Error | null;
+    refresh: () => Promise<void>;
+    runtime: AssistantRuntime;
+}
+/** Adapts one durable Caltra session to assistant-ui without supplying presentation components. */
+export declare function useCaltraRuntime(options: UseCaltraRuntimeOptions): UseCaltraRuntimeResult;
+//# sourceMappingURL=use_caltra_runtime.d.ts.map

package/dist/use_caltra_runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_caltra_runtime.d.ts","sourceRoot":"","sources":["../src/use_caltra_runtime.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EAGtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAsB,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEpF,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,qBAAqB,CAAC;IAClC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,mGAAmG;AACnG,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CA0CzF"}

package/dist/use_caltra_runtime.js

@@ -0,0 +1,41 @@
+import { useExternalStoreRuntime, } from "@assistant-ui/react";
+import { useCallback, useEffect, useMemo, useSyncExternalStore } from "react";
+import { CaltraSessionStore } from "./session_store.js";
+/** Adapts one durable Caltra session to assistant-ui without supplying presentation components. */
+export function useCaltraRuntime(options) {
+    const store = useMemo(() => new CaltraSessionStore(options.client, options.sessionId), [options.client, options.sessionId]);
+    const snapshot = useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
+    useEffect(() => {
+        void store.start().catch(() => undefined);
+        return () => void store.stop();
+    }, [store]);
+    const onNew = useCallback(async (message) => {
+        const text = message.content
+            .filter((part) => part.type === "text")
+            .map((part) => part.text)
+            .join("\n");
+        if (text === "")
+            throw new Error("Caltra currently accepts text messages only.");
+        await store.send(text);
+    }, [store]);
+    const messages = useMemo(() => snapshot.messages.map((message) => ({
+        content: [{ type: "text", text: message.text }],
+        createdAt: new Date(message.created_at),
+        id: message.id,
+        role: message.role,
+    })), [snapshot.messages]);
+    const runtime = useExternalStoreRuntime({
+        convertMessage: (message) => message,
+        isRunning: snapshot.isRunning,
+        isSendDisabled: snapshot.connection !== "connected",
+        messages,
+        onNew,
+    });
+    return {
+        connection: snapshot.connection,
+        error: snapshot.error,
+        refresh: async () => await store.refresh(),
+        runtime,
+    };
+}
+//# sourceMappingURL=use_caltra_runtime.js.map

package/dist/use_caltra_runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_caltra_runtime.js","sourceRoot":"","sources":["../src/use_caltra_runtime.tsx"],"names":[],"mappings":"AAAA,OAAO,EAIL,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAA8B,MAAM,oBAAoB,CAAC;AAcpF,mGAAmG;AACnG,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAC/D,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,IAAI,kBAAkB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,EAC/D,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CACpC,CAAC;IACF,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAE7F,SAAS,CAAC,GAAG,EAAE;QACb,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC1C,OAAO,GAAG,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,OAAsB,EAAE,EAAE;QACzD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO;aACzB,MAAM,CAAC,CAAC,IAAI,EAAkD,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;aACtF,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;aACxB,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,IAAI,IAAI,KAAK,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QACjF,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,MAAM,QAAQ,GAAG,OAAO,CAAsB,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACtF,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/C,SAAS,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;QACvC,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE1B,MAAM,OAAO,GAAG,uBAAuB,CAAC;QACtC,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO;QACpC,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,cAAc,EAAE,QAAQ,CAAC,UAAU,KAAK,WAAW;QACnD,QAAQ;QACR,KAAK;KACN,CAAC,CAAC;IAEH,OAAO;QACL,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,OAAO,EAAE;QAC1C,OAAO;KACR,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@caltra/react",
+  "version": "0.1.0",
+  "description": "assistant-ui runtime adapter for Caltra sessions",
+  "type": "module",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/caltra-dev/caltra-sdk.git",
+    "directory": "packages/react"
+  },
+  "homepage": "https://github.com/caltra-dev/caltra-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/caltra-dev/caltra-sdk/issues"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prebuild": "npm run build --workspace=@caltra/client",
+    "pretest": "npm run build --workspace=@caltra/client",
+    "pretypecheck": "npm run build --workspace=@caltra/client",
+    "test": "vitest run tests",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@caltra/client": "0.1.0"
+  },
+  "peerDependencies": {
+    "@assistant-ui/react": "^0.15.16",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@assistant-ui/react": "0.15.16",
+    "@testing-library/react": "16.3.2",
+    "@types/react": "19.2.17",
+    "@types/react-dom": "19.2.3",
+    "jsdom": "30.0.1",
+    "react": "19.2.8",
+    "react-dom": "19.2.8",
+    "typescript": "5.9.3",
+    "vitest": "4.1.11"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  }
+}