@chai-ui/react 0.6.0 → 0.6.1

package/dist/useMediaAnalyzer.js

@@ -1,114 +1,17 @@
-import { useCallback, useRef, useState } from "react";
-import { createMockEngine, DEFAULT_MEDIA_ANALYSIS_PROMPT_LENGTH, isAbortError, MEDIA_ANALYSIS_PROMPTS, normalizeGenerationError, routeModel, } from "@chai-ui/core";
-import { reasoningModelFor, useReasoning } from "./ChaiProvider.js";
+import { useState, useSyncExternalStore } from "react";
+import { createMediaAnalyzerStore } from "@chai-ui/core";
+import { useReasoning } from "./ChaiProvider.js";
 import { useLatest } from "./use-latest.js";
-const mockTextEngine = createMockEngine({ outputKind: "text" });
 /**
- * The binding behind `MediaAnalyzer`'s `onSubmit`: sends the attached
- * media and the instruction for its kind and prompt length
- * (`MEDIA_ANALYSIS_PROMPTS`) to the reasoning engine, and returns the
- * generated prompt. `prompt` fills in as the text streams.
+ * The React binding for `createMediaAnalyzerStore` in `@chai-ui/core`, behind
+ * `MediaAnalyzer`'s `onSubmit`: returns the generated prompt, which fills in
+ * as the text streams.
  */
 export function useMediaAnalyzer(options = {}) {
-    const [analyzing, setAnalyzing] = useState(false);
-    const [error, setError] = useState(null);
-    const [prompt, setPrompt] = useState(null);
     const provided = useReasoning();
     const latest = useLatest({ options, provided });
-    // Each submit gets an id; a late reply from an earlier submit is dropped,
-    // and its call aborted.
-    const callId = useRef(0);
-    const controller = useRef(null);
-    const submit = useCallback((payload) => {
-        const { options: opts, provided: reasoning } = latest.current;
-        const id = ++callId.current;
-        controller.current?.abort();
-        const { signal } = (controller.current = new AbortController());
-        setError(null);
-        setPrompt(null);
-        const kind = payload.attachments[0]?.kind;
-        if (kind !== "image" && kind !== "video" && kind !== "audio") {
-            const message = "Attach an image, video, or audio file to analyze.";
-            setError(message);
-            opts.onError?.(message);
-            return;
-        }
-        const engine = opts.engine ?? reasoning?.engine ?? mockTextEngine;
-        const defaultModel = opts.model ?? (reasoning ? reasoningModelFor(reasoning, payload.attachments) : undefined);
-        const instruction = MEDIA_ANALYSIS_PROMPTS[kind][payload.promptLength ?? DEFAULT_MEDIA_ANALYSIS_PROMPT_LENGTH];
-        const current = () => id === callId.current;
-        const autoSelect = payload.autoSelectModel && payload.models.length > 0;
-        const analyze = (modelId) => engine
-            .generate({
-            modelId,
-            prompt: instruction,
-            attachments: payload.attachments,
-            onText: (text) => current() && setPrompt(text),
-            signal,
-        })
-            .then(({ src }) => {
-            if (!current())
-                return;
-            setPrompt(src);
-            latest.current.options.onResult?.(src);
-        }, (err) => {
-            if (!current() || isAbortError(err))
-                return;
-            const { message } = normalizeGenerationError(err);
-            setError(message);
-            latest.current.options.onError?.(message);
-        })
-            .finally(() => current() && setAnalyzing(false));
-        setAnalyzing(true);
-        if (!autoSelect) {
-            void analyze(payload.modelId ?? defaultModel);
-            return;
-        }
-        // Auto-select: the reasoning model looks at the media and picks the
-        // analysis model first. A routing problem falls back, never blocks.
-        void routeModel({
-            prompt: "",
-            outputKind: "text",
-            attachmentKinds: payload.attachments.map((a) => a.kind),
-            attachments: payload.attachments,
-            models: payload.models,
-            engine: opts.engine ?? reasoning?.engine,
-            model: defaultModel,
-            routingPrompt: opts.routingPrompt,
-            signal,
-        }).then((routed) => {
-            if (!current() || signal.aborted)
-                return;
-            const latestOpts = latest.current.options;
-            if (routed.status === "fallback") {
-                if (routed.reason === "no-reasoning")
-                    warnNoReasoningOnce();
-                latestOpts.onRoutingFallback?.(routed);
-            }
-            latestOpts.onModelChange?.(routed.modelId);
-            return analyze(routed.modelId);
-        });
-    }, [latest]);
-    /** Stops the analysis in flight (cancelling at the provider where it can), keeping any text that already streamed in. */
-    const cancel = useCallback(() => {
-        callId.current += 1;
-        controller.current?.abort();
-        controller.current = null;
-        setAnalyzing(false);
-    }, []);
-    /** Stops anything in flight and clears the prompt and error, e.g. when the person changes their media. */
-    const reset = useCallback(() => {
-        cancel();
-        setError(null);
-        setPrompt(null);
-    }, [cancel]);
-    return { submit, analyzing, error, prompt, cancel, reset };
-}
-let warnedNoReasoning = false;
-function warnNoReasoningOnce() {
-    if (warnedNoReasoning)
-        return;
-    warnedNoReasoning = true;
-    console.warn("[chai-ui] Auto-select model is on, but there's no reasoning model, so analysis runs on the first listed model. Wrap your app in <ChaiProvider> to route with one.");
+    const [store] = useState(() => createMediaAnalyzerStore(() => latest.current.options, () => latest.current.provided));
+    const state = useSyncExternalStore(store.subscribe, store.getState, store.getState);
+    return { ...state, submit: store.submit, cancel: store.cancel, reset: store.reset };
 }
 //# sourceMappingURL=useMediaAnalyzer.js.map

package/dist/useMediaAnalyzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"useMediaAnalyzer.js","sourceRoot":"","sources":["../src/useMediaAnalyzer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useMediaAnalyzer.js","sourceRoot":"","sources":["../src/useMediaAnalyzer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAA6B,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAmC,EAAE;IACpE,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAC5B,wBAAwB,CACtB,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAC5B,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAC9B,CACF,CAAC;IACF,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpF,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;AACtF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chai-ui/react",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "CHAI UI React components — smart, drop-in UI for AI apps: Composer, Media Analyzer, Result Card, and the useComposer hook.",
   "license": "MIT",
   "author": "kazarazat",
@@ -48,8 +48,8 @@
     "@fontsource/roboto": "^5.3.0",
     "@lit/react": "^1.0.8",
     "@material/web": "^2.5.0",
-    "@chai-ui/core": "0.6.0",
-    "@chai-ui/tokens": "0.6.0"
+    "@chai-ui/core": "0.6.1",
+    "@chai-ui/tokens": "0.6.1"
   },
   "devDependencies": {
     "@material-symbols/svg-400": "^0.47.5",

package/src/ChaiProvider.tsx

@@ -1,88 +1,30 @@
 import { createContext, useContext, useMemo, type ReactNode } from "react";
-import { createOpenRouterEngine, type DroppedMedia, type GenerationEngine, type MediaKind } from "@chai-ui/core";
+import { createReasoning, reasoningEngineFor, type Reasoning, type ReasoningConfig } from "@chai-ui/core";
 
-/**
- * The suggested reasoning model for text and images: prompt enhancement,
- * auto-select routing and image analysis. A default, not a requirement —
- * pass any model id `reasoningEngine` can run.
- */
-export const DEFAULT_REASONING_MODEL = "anthropic/claude-opus-5";
-
-/**
- * Suggested per-kind overrides for media Claude can't read. Gemini takes
- * video and audio directly. For a cheaper option, swap in
- * `"qwen/qwen3.8-omni-flash"`, which takes both too.
- */
-export const DEFAULT_REASONING_MODEL_BY_KIND: Partial<Record<MediaKind, string>> = {
-  video: "google/gemini-3.8-flash",
-  audio: "google/gemini-3.8-flash",
-};
-
-/** The reasoning engine and models every CHAI component shares. */
-export interface Reasoning {
-  engine: GenerationEngine;
-  /** The model for text and any attachment kind without its own entry in `modelByKind`. */
-  model: string;
-  modelByKind: Partial<Record<MediaKind, string>>;
-}
+export {
+  DEFAULT_REASONING_MODEL,
+  DEFAULT_REASONING_MODEL_BY_KIND,
+  reasoningModelFor,
+  type Reasoning,
+} from "@chai-ui/core";
 
 const ReasoningContext = createContext<Reasoning | undefined>(undefined);
 
-export interface ChaiProviderProps {
-  /** Text, image and routing model. Defaults to `DEFAULT_REASONING_MODEL`. */
-  reasoningModel?: string;
-  /**
-   * Per-attachment-kind models, merged over `DEFAULT_REASONING_MODEL_BY_KIND`
-   * one kind at a time, e.g. `{ video: "qwen/qwen3.8-omni-flash" }` keeps
-   * the default for audio. Map a kind to `reasoningModel`'s value to use
-   * one model for everything.
-   */
-  reasoningModelByKind?: Partial<Record<MediaKind, string>>;
-  /**
-   * The engine the reasoning models run on. Defaults to OpenRouter,
-   * independent of the generation engine: Fal's own LLM access is an
-   * OpenRouter proxy, so defaulting to it would double-proxy.
-   */
-  reasoningEngine?: GenerationEngine;
+export interface ChaiProviderProps extends ReasoningConfig {
   children?: ReactNode;
 }
 
 export function ChaiProvider({ reasoningModel, reasoningModelByKind, reasoningEngine, children }: ChaiProviderProps) {
-  const engine = useMemo(() => reasoningEngine ?? createOpenRouterEngine(), [reasoningEngine]);
-  const model = reasoningModel ?? DEFAULT_REASONING_MODEL;
-  const video = reasoningModelByKind?.video;
-  const audio = reasoningModelByKind?.audio;
-  const image = reasoningModelByKind?.image;
-  const text = reasoningModelByKind?.text;
+  const engine = useMemo(() => reasoningEngineFor({ reasoningEngine }), [reasoningEngine]);
+  const { video, audio, image, text } = reasoningModelByKind ?? {};
   const value = useMemo(
-    () => ({
-      engine,
-      model,
-      modelByKind: { ...DEFAULT_REASONING_MODEL_BY_KIND, ...dropUndefined({ video, audio, image, text }) },
-    }),
-    [engine, model, video, audio, image, text]
+    () => createReasoning({ reasoningModel, reasoningModelByKind: { video, audio, image, text } }, engine),
+    [engine, reasoningModel, video, audio, image, text]
   );
   return <ReasoningContext.Provider value={value}>{children}</ReasoningContext.Provider>;
 }
 
-function dropUndefined<T extends object>(obj: T): Partial<T> {
-  return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined)) as Partial<T>;
-}
-
 /** The nearest `ChaiProvider`'s reasoning engine and models, or `undefined` outside one. */
 export function useReasoning(): Reasoning | undefined {
   return useContext(ReasoningContext);
 }
-
-/**
- * The reasoning model for a call with these attachments: the first
- * attachment whose kind has its own model wins (a clip plus a still goes
- * to the model that can read the clip), else `reasoning.model`.
- */
-export function reasoningModelFor(reasoning: Reasoning, attachments: DroppedMedia[] = []): string {
-  for (const { kind } of attachments) {
-    const model = reasoning.modelByKind[kind];
-    if (model) return model;
-  }
-  return reasoning.model;
-}

package/src/Composer.tsx

@@ -3,10 +3,20 @@ import { useEffect, useRef, useState, type ChangeEvent } from "react";
 import { createComponent } from "@lit/react";
 import * as React from "react";
 import { MdFab } from "@material/web/fab/fab.js";
-import { deriveGenerationUseCase, suggestedModels } from "@chai-ui/core";
+import { deriveGenerationUseCase, suggestedModels, TEXT_USE_CASE } from "@chai-ui/core";
 import type { DroppedMedia, EditRegion, ModelOption, ParameterOption, MediaKind } from "@chai-ui/core";
 import { SearchMenu } from "./primitives/SearchMenu.js";
 import { regionColor } from "./regions.js";
+import type { ComposerAttachment, ComposerSelection, ComposerSubmitPayload, ComposerUseCase } from "@chai-ui/core";
+
+export {
+  EDIT_IMAGE_USE_CASE,
+  TEXT_USE_CASE,
+  type ComposerAttachment,
+  type ComposerSelection,
+  type ComposerSubmitPayload,
+  type ComposerUseCase,
+} from "@chai-ui/core";
 
 /** See primitives/Toggle.tsx for why `createComponent` is used instead of raw JSX on custom-element tags. */
 const MdFabElement = createComponent({
@@ -46,71 +56,8 @@ function nextAttachmentId(): string {
     : `attachment-${Date.now()}-${Math.random().toString(36).slice(2)}`;
 }
 
-export interface ComposerAttachment extends DroppedMedia {
-  id: string;
-}
-
 export type ComposerAttachMenuAction = "add-media" | "create-image" | "create-video" | "edit-media";
 
-/**
- * The selected generation use case, shown as a removable chip (reference:
- * the mock's "Video"/"Image" chip) — deliberately independent of
- * `attachments`: a use case can be picked from the attach menu with nothing
- * attached yet (e.g. "Create video"). Composer never derives this from
- * `attachments` itself (that's app-level policy, not a Composer opinion —
- * the design). With none picked, `defaultUseCase` applies.
- */
-export interface ComposerUseCase {
-  kind: MediaKind;
-  label: string;
-  /**
-   * An edit of the attached image rather than a new one: no aspect ratio,
-   * region chips when `regions` is set, and a submit needs only an image and
-   * either a prompt or a region. Images only for now.
-   */
-  edit?: boolean;
-}
-
-/** A plain text request — what a submit means when no use case is picked, unless the builder sets `defaultUseCase`. */
-export const TEXT_USE_CASE: ComposerUseCase = { kind: "text", label: "Text" };
-
-/** Editing the attached image, the attach menu's "Edit image". Pair it with `useComposer`'s `editImage` and an `EditCard`. */
-export const EDIT_IMAGE_USE_CASE: ComposerUseCase = { kind: "image", label: "Edit image", edit: true };
-
-/** One use case to run and the models picked for it. Empty `modelIds` means the engine's default model. */
-export interface ComposerSelection {
-  useCase: ComposerUseCase;
-  modelIds: string[];
-  /** The models offered for this use case: what auto-select routes among. */
-  models: ModelOption[];
-}
-
-/**
- * Everything Composer itself tracks, assembled into one object at submit
- * time — not the the design `Request` shape (no `mode`/`params`/
- * `presetId`; those belong to the run store this package doesn't have yet,
- * see the package README), just an honest snapshot of this component's own
- * state. Handed to `onSubmit` so a builder doesn't have to re-derive it
- * from five separately-controlled props they already hold — mainly a
- * correctness/ergonomics win for a coding agent wiring this up from the
- * type signature alone.
- */
-export interface ComposerSubmitPayload {
-  value: string;
-  attachments: ComposerAttachment[];
-  /** The use case to run — the picked one, or `defaultUseCase` when none is picked. The first one with `multiSelectUseCases`. */
-  useCase: ComposerUseCase;
-  /** The first picked model, or null for the engine's default. */
-  modelId: string | null;
-  aspectRatio: string | null;
-  /** Everything to run: one entry per use case with its picked models. A single entry unless `multiSelectUseCases` is on. */
-  selections: ComposerSelection[];
-  /** When true, the model is chosen at submit (`useComposer` routes among each selection's `models`), not by the picks. */
-  autoSelectModel: boolean;
-  /** An edit's marked regions, each with its own instruction. Empty unless the use case is an edit. */
-  regions?: EditRegion[];
-}
-
 export interface ComposerProps {
   /** The prompt text. Controlled — Composer owns no text state of its own. */
   value: string;

package/src/EditCard.tsx

@@ -1,5 +1,7 @@
 import { useEffect, useRef, useState, type CSSProperties, type KeyboardEvent, type PointerEvent } from "react";
-import { DEFAULT_MAX_REGIONS, type EditRegion, type RegionBox, type ResultStatus } from "@chai-ui/core";
+import { DEFAULT_MAX_REGIONS, type EditRegion, type EditVersion, type RegionBox } from "@chai-ui/core";
+
+export type { EditVersion } from "@chai-ui/core";
 import { Pagination } from "./primitives/Pagination.js";
 import {
   AddIcon,
@@ -18,22 +20,6 @@ import { downloadFilename, downloadMedia, shareMedia } from "./media-actions.js"
 import { PageSlide, usePageSlide } from "./page-slide.js";
 import { regionColor } from "./regions.js";
 
-/**
- * One version of the image being edited: the original, or the result of an
- * edit. `useComposer`'s `edit.versions` builds these from its runs.
- */
-export interface EditVersion {
-  id: string;
-  /** The image, once there is one. */
-  src?: string;
-  /** The image this version was edited from, shown under the progress spinner until `src` arrives. */
-  from?: string;
-  status: ResultStatus;
-  /** The regions this version was made with (none for the original). Shown faintly, for reference. */
-  regions: EditRegion[];
-  error?: string;
-}
-
 export interface EditCardProps {
   /** The original image first, then each edit. Paged with the dots in the card's bottom row. */
   versions: EditVersion[];

package/src/MediaAnalyzer.tsx

@@ -7,6 +7,9 @@ import type { DroppedMedia, ModelOption, MediaKind } from "@chai-ui/core";
 import type { MediaAnalysisPromptLength } from "@chai-ui/core";
 import { SearchMenu, type SearchMenuSection } from "./primitives/SearchMenu.js";
 import { StopIcon } from "./icons.js";
+import type { MediaAnalyzerAttachment, MediaAnalyzerSubmitPayload } from "@chai-ui/core";
+
+export type { MediaAnalyzerAttachment, MediaAnalyzerSubmitPayload } from "@chai-ui/core";
 
 /** See primitives/Toggle.tsx for why `createComponent` is used instead of raw JSX on custom-element tags. */
 const MdFabElement = createComponent({
@@ -29,10 +32,6 @@ function nextAttachmentId(): string {
     : `attachment-${Date.now()}-${Math.random().toString(36).slice(2)}`;
 }
 
-export interface MediaAnalyzerAttachment extends DroppedMedia {
-  id: string;
-}
-
 /**
  * How many attachments of each kind an analysis can hold at once. Image
  * defaults to 5 (a sequence/series reads as one analysis); video and audio
@@ -99,17 +98,6 @@ export function isMediaAnalyzerAtCap(
   return current.length >= (maxByKind.image ?? DEFAULT_MAX_ATTACHMENTS_BY_KIND.image);
 }
 
-export interface MediaAnalyzerSubmitPayload {
-  attachments: MediaAnalyzerAttachment[];
-  modelId: string | null;
-  /** When true, `useMediaAnalyzer` routes among `models` at submit instead of using `modelId`. */
-  autoSelectModel: boolean;
-  /** The models offered for the attached media's kind. */
-  models: ModelOption[];
-  /** `null` until a person actually picks one — see the `promptLength` prop's own doc comment for why this doesn't default to "concise". */
-  promptLength: MediaAnalysisPromptLength | null;
-}
-
 export interface MediaAnalyzerProps {
   attachments: MediaAnalyzerAttachment[];
   onAttachmentsChange: (next: MediaAnalyzerAttachment[]) => void;