@chai-ui/core 0.13.0 → 0.14.0

package/README.md

@@ -16,7 +16,7 @@ The headless core behind Chai UI's components: the data types, the
 Request → Run → Result model a submitted prompt flows through, and the
 pluggable generation engines that actually call models, and the components'
 behavior as small framework-free stores. No framework, no rendering:
-`@chai-ui/react` wraps the stores in hooks, and a Vue binding will wrap the
+`@chai-ui/react` wraps the stores in hooks, and `@chai-ui/vue` wraps the
 same stores.
 
 ## Layout
@@ -26,14 +26,25 @@ same stores.
 - `engine.ts` — the `GenerationEngine` interface every provider implements, `GenerationError`, and `mockEngine`/`createMockEngine` (placeholder output, no network call, no API key).
 - `engines/fal.ts` — `createFalEngine`, media generation through Fal.ai (the default).
 - `engines/openrouter.ts` — `createOpenRouterEngine`, text/reasoning through OpenRouter (prompt enhancement, media analysis).
+- `engines/vercel.ts` — `createVercelEngine`, text and image models through Vercel AI Gateway.
 - `media-analysis-prompts.ts` — the instruction text `MediaAnalyzer` sends, per media kind × prompt length.
 - `suggested-models.ts` — the suggested model lists per use case (Fal for generation, OpenRouter for analysis), each model with its verified aspect ratios and Fal input format; `suggestedModels(useCase)`.
 - `check-suggested-models.ts` — `checkSuggestedModels()`: checks those lists against Fal's and OpenRouter's catalogs as they are today. No key, no model run.
 - `model-routing.ts` — auto-select: `buildModelRoutingPrompt`, `parseModelRoutingReply`, and `routeModel`, which falls back to the first listed model instead of throwing.
 - `reasoning.ts` — the reasoning engine and models a `ChaiProvider` shares: `createReasoning`, `pickReasoning`, `reasoningModelFor` and the suggested defaults.
-- `composer.ts` — `createComposerStore`, what `useComposer` wraps: submit payload → runs, auto-select routing, Enhance, cancel, and image edit versions. Plus the Composer's shared types (`ComposerSubmitPayload`, `EditVersion`, …).
+- `composer.ts` — `createComposerStore`, what `useComposer` wraps: submit payload → runs, auto-select routing, Enhance, cancel, image edit versions and the evaluation judge. Plus the Composer's shared types (`ComposerSubmitPayload`, `EditVersion`, …).
+- `composer-view.ts` — what the `Composer` shows and submits, worked out from its props, for every binding: model menus, aspect ratios, use-case rules (`nextUseCases`).
+- `analytics-events.ts` — front-end analytics: the `ChaiEvent` type and the `composerEvents` and `resultCardEvents` the components report through `onEvent`.
+- `evaluation-judge.ts` — the opt-in judge: `EvaluationCheck`, `DEFAULT_EVALUATION_CHECKS`, `buildJudgePrompt`, `parseJudgeReply`.
+- `image-fit.ts` — `fitImageToRatio`: crops or pads a video's start image to the picked ratio (`startImageFit`).
+- `region-edit.ts` — region editing: the region shape, the models that read regions as boxes, and `buildRegionEditPrompt`.
+- `edit-card.ts` — `EditCard`'s geometry: region boxes, zoom and pan, and where the instruction field goes.
+- `voice-input.ts` — the Composer's voice input: record, send to a speech-to-text model, return the transcript.
+- `result-format.ts` — how `ResultCard` shows a result's details.
+- `media-actions.ts` — download and share for generated media.
+- `menu-placement.ts` — which way a component's menus open from their trigger.
 - `media-analyzer.ts` — `createMediaAnalyzerStore`, what `useMediaAnalyzer` wraps.
-- `server/` — `createChaiHandler` and `toNodeHandler`, exported from `@chai-ui/core/server` (server-only).
+- `server/` — `createChaiHandler` (`chai-handler.ts`) and `toNodeHandler` (`node.ts`), exported from `@chai-ui/core/server` (server-only).
 
 ## Suggested models, and checking them
 

package/dist/analytics-events.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Front-end analytics: what the person did in Chai's components and what
+ * the components showed them, reported through each component's `onEvent`.
+ * Defined once here so every framework binding sends the same events.
+ *
+ * Front end only: model calls, latency, cost and storage belong to the
+ * builder's back end. No prompt text, file names, URLs or outputs are ever
+ * sent: only lengths, counts and Chai's own ids. Properties are flat, so any
+ * analytics tool takes them as they are: `onEvent={(e) => posthog.capture(e.name, e.properties)}`.
+ */
+import type { ComposerAttachMenuAction, ComposerPromptField } from "./composer-view.js";
+import type { ComposerSubmitPayload, ComposerUseCase } from "./composer.js";
+import type { MediaKind } from "./types.js";
+export type ChaiEvent = {
+    name: "chai_composer_submitted";
+    properties: {
+        use_cases: string;
+        model_count: number;
+        auto_select: boolean;
+        aspect_ratio?: string;
+        attachment_count: number;
+        prompt_length: number;
+        retry: boolean;
+    };
+} | {
+    name: "chai_composer_stopped";
+    properties: Record<string, never>;
+} | {
+    name: "chai_composer_use_case_picked";
+    properties: {
+        action: ComposerAttachMenuAction;
+    };
+} | {
+    name: "chai_composer_use_case_removed";
+    properties: {
+        use_case: string;
+    };
+} | {
+    name: "chai_composer_media_attached";
+    properties: {
+        count: number;
+        unsupported_count: number;
+    };
+} | {
+    name: "chai_composer_model_picked";
+    properties: {
+        use_case: string;
+        model_id: string;
+    };
+} | {
+    name: "chai_composer_auto_select_toggled";
+    properties: {
+        on: boolean;
+    };
+} | {
+    name: "chai_composer_option_picked";
+    properties: {
+        option: "aspect_ratio" | "voice" | "genre" | "frame_rate";
+        value: string;
+    };
+} | {
+    name: "chai_composer_enhance_clicked";
+    properties: {
+        field: ComposerPromptField;
+        prompt_length: number;
+    };
+} | {
+    name: "chai_composer_enhance_reverted";
+    properties: {
+        field: ComposerPromptField;
+    };
+} | {
+    name: "chai_composer_voice_started";
+    properties: Record<string, never>;
+} | {
+    name: "chai_result_shown";
+    properties: {
+        status: "done" | "error";
+        output_kind?: MediaKind;
+        result_count: number;
+    };
+} | {
+    name: "chai_result_action";
+    properties: {
+        action: string;
+    };
+} | {
+    name: "chai_result_paged";
+    properties: {
+        index: number;
+        count: number;
+    };
+} | {
+    name: "chai_result_info_opened";
+    properties: Record<string, never>;
+};
+export type ChaiEventName = ChaiEvent["name"];
+/** A use case as one short id, e.g. `"image"`, `"image:edit"` or `"audio:music"`. */
+export declare function useCaseId(useCase: ComposerUseCase): string;
+/** The events `Composer` reports. */
+export declare const composerEvents: {
+    submitted: (payload: ComposerSubmitPayload, retry: boolean) => ChaiEvent;
+    stopped: () => ChaiEvent;
+    useCasePicked: (action: ComposerAttachMenuAction) => ChaiEvent;
+    useCaseRemoved: (useCase: ComposerUseCase) => ChaiEvent;
+    mediaAttached: (count: number, unsupportedCount: number) => ChaiEvent;
+    modelPicked: (useCase: string, modelId: string) => ChaiEvent;
+    autoSelectToggled: (on: boolean) => ChaiEvent;
+    optionPicked: (option: "aspect_ratio" | "voice" | "genre" | "frame_rate", value: string | number) => ChaiEvent;
+    enhanceClicked: (field: ComposerPromptField, promptLength: number) => ChaiEvent;
+    enhanceReverted: (field: ComposerPromptField) => ChaiEvent;
+    voiceStarted: () => ChaiEvent;
+};
+/** The events `ResultCard` reports. */
+export declare const resultCardEvents: {
+    shown: (status: "done" | "error", outputKind: MediaKind | undefined, resultCount: number) => ChaiEvent;
+    action: (action: string) => ChaiEvent;
+    paged: (index: number, count: number) => ChaiEvent;
+    infoOpened: () => ChaiEvent;
+};
+//# sourceMappingURL=analytics-events.d.ts.map

package/dist/analytics-events.d.ts.map

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

package/dist/analytics-events.js

@@ -0,0 +1,55 @@
+/** A use case as one short id, e.g. `"image"`, `"image:edit"` or `"audio:music"`. */
+export function useCaseId(useCase) {
+    return `${useCase.kind}${useCase.edit ? ":edit" : ""}${useCase.audio ? `:${useCase.audio}` : ""}`;
+}
+/** The events `Composer` reports. */
+export const composerEvents = {
+    submitted: (payload, retry) => ({
+        name: "chai_composer_submitted",
+        properties: {
+            use_cases: payload.selections.map((s) => useCaseId(s.useCase)).join(","),
+            model_count: payload.selections.reduce((n, s) => n + s.modelIds.length, 0),
+            auto_select: payload.autoSelectModel,
+            ...(payload.aspectRatio && { aspect_ratio: payload.aspectRatio }),
+            attachment_count: payload.attachments.length,
+            prompt_length: payload.value.length,
+            retry,
+        },
+    }),
+    stopped: () => ({ name: "chai_composer_stopped", properties: {} }),
+    useCasePicked: (action) => ({ name: "chai_composer_use_case_picked", properties: { action } }),
+    useCaseRemoved: (useCase) => ({
+        name: "chai_composer_use_case_removed",
+        properties: { use_case: useCaseId(useCase) },
+    }),
+    mediaAttached: (count, unsupportedCount) => ({
+        name: "chai_composer_media_attached",
+        properties: { count, unsupported_count: unsupportedCount },
+    }),
+    modelPicked: (useCase, modelId) => ({
+        name: "chai_composer_model_picked",
+        properties: { use_case: useCase, model_id: modelId },
+    }),
+    autoSelectToggled: (on) => ({ name: "chai_composer_auto_select_toggled", properties: { on } }),
+    optionPicked: (option, value) => ({
+        name: "chai_composer_option_picked",
+        properties: { option, value: String(value) },
+    }),
+    enhanceClicked: (field, promptLength) => ({
+        name: "chai_composer_enhance_clicked",
+        properties: { field, prompt_length: promptLength },
+    }),
+    enhanceReverted: (field) => ({ name: "chai_composer_enhance_reverted", properties: { field } }),
+    voiceStarted: () => ({ name: "chai_composer_voice_started", properties: {} }),
+};
+/** The events `ResultCard` reports. */
+export const resultCardEvents = {
+    shown: (status, outputKind, resultCount) => ({
+        name: "chai_result_shown",
+        properties: { status, ...(outputKind && { output_kind: outputKind }), result_count: resultCount },
+    }),
+    action: (action) => ({ name: "chai_result_action", properties: { action } }),
+    paged: (index, count) => ({ name: "chai_result_paged", properties: { index, count } }),
+    infoOpened: () => ({ name: "chai_result_info_opened", properties: {} }),
+};
+//# sourceMappingURL=analytics-events.js.map

package/dist/analytics-events.js.map

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

package/dist/index.d.ts

@@ -20,4 +20,5 @@ export * from "./voice-input.js";
 export * from "./menu-placement.js";
 export * from "./image-fit.js";
 export * from "./evaluation-judge.js";
+export * from "./analytics-events.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -20,4 +20,5 @@ export * from "./voice-input.js";
 export * from "./menu-placement.js";
 export * from "./image-fit.js";
 export * from "./evaluation-judge.js";
+export * from "./analytics-events.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chai-ui/core",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Chai UI headless core — the Request/Run/Result data model and pluggable generation engines (Fal.ai, OpenRouter, Vercel AI Gateway, mock). No framework, no rendering.",
   "license": "MIT",
   "author": "kazarazat",

package/src/analytics-events.ts

@@ -0,0 +1,106 @@
+/**
+ * Front-end analytics: what the person did in Chai's components and what
+ * the components showed them, reported through each component's `onEvent`.
+ * Defined once here so every framework binding sends the same events.
+ *
+ * Front end only: model calls, latency, cost and storage belong to the
+ * builder's back end. No prompt text, file names, URLs or outputs are ever
+ * sent: only lengths, counts and Chai's own ids. Properties are flat, so any
+ * analytics tool takes them as they are: `onEvent={(e) => posthog.capture(e.name, e.properties)}`.
+ */
+import type { ComposerAttachMenuAction, ComposerPromptField } from "./composer-view.js";
+import type { ComposerSubmitPayload, ComposerUseCase } from "./composer.js";
+import type { MediaKind } from "./types.js";
+
+export type ChaiEvent =
+  | {
+      name: "chai_composer_submitted";
+      properties: {
+        use_cases: string;
+        model_count: number;
+        auto_select: boolean;
+        aspect_ratio?: string;
+        attachment_count: number;
+        prompt_length: number;
+        retry: boolean;
+      };
+    }
+  | { name: "chai_composer_stopped"; properties: Record<string, never> }
+  | { name: "chai_composer_use_case_picked"; properties: { action: ComposerAttachMenuAction } }
+  | { name: "chai_composer_use_case_removed"; properties: { use_case: string } }
+  | { name: "chai_composer_media_attached"; properties: { count: number; unsupported_count: number } }
+  | { name: "chai_composer_model_picked"; properties: { use_case: string; model_id: string } }
+  | { name: "chai_composer_auto_select_toggled"; properties: { on: boolean } }
+  | {
+      name: "chai_composer_option_picked";
+      properties: { option: "aspect_ratio" | "voice" | "genre" | "frame_rate"; value: string };
+    }
+  | { name: "chai_composer_enhance_clicked"; properties: { field: ComposerPromptField; prompt_length: number } }
+  | { name: "chai_composer_enhance_reverted"; properties: { field: ComposerPromptField } }
+  | { name: "chai_composer_voice_started"; properties: Record<string, never> }
+  | {
+      name: "chai_result_shown";
+      properties: { status: "done" | "error"; output_kind?: MediaKind; result_count: number };
+    }
+  | { name: "chai_result_action"; properties: { action: string } }
+  | { name: "chai_result_paged"; properties: { index: number; count: number } }
+  | { name: "chai_result_info_opened"; properties: Record<string, never> };
+
+export type ChaiEventName = ChaiEvent["name"];
+
+/** A use case as one short id, e.g. `"image"`, `"image:edit"` or `"audio:music"`. */
+export function useCaseId(useCase: ComposerUseCase): string {
+  return `${useCase.kind}${useCase.edit ? ":edit" : ""}${useCase.audio ? `:${useCase.audio}` : ""}`;
+}
+
+/** The events `Composer` reports. */
+export const composerEvents = {
+  submitted: (payload: ComposerSubmitPayload, retry: boolean): ChaiEvent => ({
+    name: "chai_composer_submitted",
+    properties: {
+      use_cases: payload.selections.map((s) => useCaseId(s.useCase)).join(","),
+      model_count: payload.selections.reduce((n, s) => n + s.modelIds.length, 0),
+      auto_select: payload.autoSelectModel,
+      ...(payload.aspectRatio && { aspect_ratio: payload.aspectRatio }),
+      attachment_count: payload.attachments.length,
+      prompt_length: payload.value.length,
+      retry,
+    },
+  }),
+  stopped: (): ChaiEvent => ({ name: "chai_composer_stopped", properties: {} }),
+  useCasePicked: (action: ComposerAttachMenuAction): ChaiEvent => ({ name: "chai_composer_use_case_picked", properties: { action } }),
+  useCaseRemoved: (useCase: ComposerUseCase): ChaiEvent => ({
+    name: "chai_composer_use_case_removed",
+    properties: { use_case: useCaseId(useCase) },
+  }),
+  mediaAttached: (count: number, unsupportedCount: number): ChaiEvent => ({
+    name: "chai_composer_media_attached",
+    properties: { count, unsupported_count: unsupportedCount },
+  }),
+  modelPicked: (useCase: string, modelId: string): ChaiEvent => ({
+    name: "chai_composer_model_picked",
+    properties: { use_case: useCase, model_id: modelId },
+  }),
+  autoSelectToggled: (on: boolean): ChaiEvent => ({ name: "chai_composer_auto_select_toggled", properties: { on } }),
+  optionPicked: (option: "aspect_ratio" | "voice" | "genre" | "frame_rate", value: string | number): ChaiEvent => ({
+    name: "chai_composer_option_picked",
+    properties: { option, value: String(value) },
+  }),
+  enhanceClicked: (field: ComposerPromptField, promptLength: number): ChaiEvent => ({
+    name: "chai_composer_enhance_clicked",
+    properties: { field, prompt_length: promptLength },
+  }),
+  enhanceReverted: (field: ComposerPromptField): ChaiEvent => ({ name: "chai_composer_enhance_reverted", properties: { field } }),
+  voiceStarted: (): ChaiEvent => ({ name: "chai_composer_voice_started", properties: {} }),
+};
+
+/** The events `ResultCard` reports. */
+export const resultCardEvents = {
+  shown: (status: "done" | "error", outputKind: MediaKind | undefined, resultCount: number): ChaiEvent => ({
+    name: "chai_result_shown",
+    properties: { status, ...(outputKind && { output_kind: outputKind }), result_count: resultCount },
+  }),
+  action: (action: string): ChaiEvent => ({ name: "chai_result_action", properties: { action } }),
+  paged: (index: number, count: number): ChaiEvent => ({ name: "chai_result_paged", properties: { index, count } }),
+  infoOpened: (): ChaiEvent => ({ name: "chai_result_info_opened", properties: {} }),
+};

package/src/index.ts

@@ -20,3 +20,4 @@ export * from "./voice-input.js";
 export * from "./menu-placement.js";
 export * from "./image-fit.js";
 export * from "./evaluation-judge.js";
+export * from "./analytics-events.js";