@chai-ui/core 0.6.1 → 0.7.1

package/README.md

@@ -77,8 +77,8 @@ Set `FAL_KEY` and `OPENROUTER_API_KEY` in the server's environment (never
 with a `VITE_` or `NEXT_PUBLIC_` prefix). A missing key comes back as a
 clear error, e.g. "FAL_KEY isn't set on the server."
 
-**Where it runs.** Chai's components are React-only, so the route lives in
-your React app's framework or on the API server behind it. Mount it at
+**Where it runs.** The route lives in your app's framework (React or Vue)
+or on the API server behind it. Mount it at
 `/api/chai`, where the components send their requests. `handle(request)`
 takes a standard web `Request` and returns a `Response`; `GET`, `POST` and
 `PUT` (Fal's cancel call) are the same function. When the browser
@@ -88,6 +88,7 @@ disconnects, the provider call is aborted too.
 |---|---|
 | Next.js (App Router) | `export const { GET, POST, PUT } = createChaiHandler();` in `app/api/chai/[...path]/route.ts` |
 | Remix / React Router | `export const loader = ({ request }) => chai.handle(request); export const action = loader;` in `app/routes/api.chai.$.ts` |
+| Nuxt | `export default defineEventHandler((event) => chai.handle(toWebRequest(event)));` in `server/api/chai/[...path].ts` |
 | Hono | `app.all("/api/chai/*", (c) => chai.handle(c.req.raw))` |
 | Bun, Deno | route `/api/chai/*` to `chai.handle` in `Bun.serve` / `Deno.serve` |
 | Cloudflare Workers | `createChaiHandler({ falKey: env.FAL_KEY, openRouterKey: env.OPENROUTER_API_KEY }).handle(request)` |

package/dist/composer-view.d.ts

@@ -0,0 +1,100 @@
+/**
+ * What the Composer component shows and submits, worked out from its props:
+ * the same in every framework binding. Pure; nothing here renders.
+ */
+import type { ComposerAttachment, ComposerSubmitPayload, ComposerUseCase } from "./composer.js";
+import type { EditRegion } from "./region-edit.js";
+import type { MediaKind, ModelOption, ParameterOption } from "./types.js";
+export type ComposerAttachMenuAction = "add-media" | "create-image" | "create-video" | "edit-media";
+/** The `+` menu, in order. "Add media" is the only item with a divider after it. */
+export declare const COMPOSER_ATTACH_MENU_ITEMS: {
+    action: ComposerAttachMenuAction;
+    label: string;
+    divider?: boolean;
+}[];
+/**
+ * Past this length a rewritten prompt appears at once: a long reveal reads
+ * as sluggish, and a long prompt is when a person wants the result now.
+ */
+export declare const MAX_ANIMATE_ENHANCE_LENGTH = 260;
+/** How long the Enhance reveal takes: time-driven, between 300ms and 900ms. */
+export declare function enhanceRevealDurationMs(charCount: number): number;
+/** The Composer props `composerView` reads. Callbacks only matter by being there. */
+export interface ComposerViewInput {
+    value: string;
+    placeholder?: string;
+    attachments?: ComposerAttachment[];
+    useCase?: ComposerUseCase | null;
+    defaultUseCase?: ComposerUseCase;
+    multiSelectUseCases?: boolean;
+    useCases?: ComposerUseCase[];
+    modelsByKind?: Partial<Record<MediaKind, ModelOption[]>>;
+    multiSelectModels?: boolean;
+    modelIds?: string[];
+    models?: ModelOption[];
+    modelId?: string | null;
+    onModelChange?: unknown;
+    onModelIdsChange?: unknown;
+    autoSelectModel?: boolean;
+    aspectRatios?: ParameterOption<string>[];
+    aspectRatio?: string | null;
+    submitError?: string | null;
+    submitDisabled?: boolean;
+    submitting?: boolean;
+    onAbort?: unknown;
+    regions?: EditRegion[];
+    disabled?: boolean;
+}
+export declare function composerView(props: ComposerViewInput): {
+    pickedUseCases: ComposerUseCase[];
+    /**
+     * Which use cases are picked, as one string. When it changes, a Composer
+     * whose end user owns the auto-select switch turns auto-select off: it
+     * belongs to the Model menu it was turned on in, so a new use case
+     * starts with its model picked by hand.
+     */
+    useCaseKey: string;
+    activeUseCases: ComposerUseCase[];
+    editing: boolean;
+    isSubmitDisabled: boolean;
+    placeholder: string;
+    showStop: boolean;
+    multiModel: boolean;
+    modelSections: {
+        options: ModelOption[];
+        suggested: boolean;
+        label: string;
+        kind: MediaKind;
+    }[];
+    pickedModelIds: string[];
+    canPickModel: boolean;
+    modelTriggerLabel: string;
+    showAspectRatio: boolean;
+    aspectOptions: ParameterOption<string>[];
+    offeredAspect: string | null;
+    selectedAspect: ParameterOption<string> | null;
+    /** The model ids after a row click: the one picked, or with multi-select that one toggled. */
+    toggledModelIds: (id: string) => string[];
+    /** Everything a submit sends. */
+    payload: () => ComposerSubmitPayload;
+};
+export type ComposerView = ReturnType<typeof composerView>;
+/** The `+` menu items that can work: "Add media" needs somewhere to put files, the use-case items a handler. */
+export declare function composerAttachMenuItems(actions: ComposerAttachMenuAction[] | undefined, { canAddMedia, canSelect }: {
+    canAddMedia: boolean;
+    canSelect: boolean;
+}): {
+    action: ComposerAttachMenuAction;
+    label: string;
+    divider?: boolean;
+}[];
+/**
+ * The attachments after picking files: each image, video or audio file
+ * added in the order picked. Editing works on one image, so its first image
+ * replaces what's there (and with none, every file is unsupported).
+ */
+export declare function composerAttachmentsFromFiles(files: Iterable<File>, current: ComposerAttachment[], editing: boolean): Promise<{
+    attachments: ComposerAttachment[] | null;
+    unsupported: string[];
+}>;
+//# sourceMappingURL=composer-view.d.ts.map

package/dist/composer-view.d.ts.map

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

package/dist/composer-view.js

@@ -0,0 +1,155 @@
+import { uniqueId } from "./unique-id.js";
+import { TEXT_USE_CASE } from "./composer.js";
+import { readMediaFiles } from "./media-analyzer.js";
+import { deriveGenerationUseCase } from "./run.js";
+import { suggestedModels } from "./suggested-models.js";
+/** The `+` menu, in order. "Add media" is the only item with a divider after it. */
+export const COMPOSER_ATTACH_MENU_ITEMS = [
+    { action: "add-media", label: "Add media", divider: true },
+    { action: "create-image", label: "Create image" },
+    { action: "create-video", label: "Create video" },
+    { action: "edit-media", label: "Edit image" },
+];
+/**
+ * Past this length a rewritten prompt appears at once: a long reveal reads
+ * as sluggish, and a long prompt is when a person wants the result now.
+ */
+export const MAX_ANIMATE_ENHANCE_LENGTH = 260;
+/** How long the Enhance reveal takes: time-driven, between 300ms and 900ms. */
+export function enhanceRevealDurationMs(charCount) {
+    return Math.min(900, Math.max(300, charCount * 6));
+}
+export function composerView(props) {
+    const { value, attachments = [], useCase = null, defaultUseCase = TEXT_USE_CASE, multiSelectUseCases = false, useCases = [], modelsByKind, multiSelectModels = false, modelIds = [], models, modelId = null, autoSelectModel = false, aspectRatios, aspectRatio = null, submitError = null, submitting = false, regions = [], disabled = false, } = props;
+    // What the person picked, and what actually runs: with nothing picked, the
+    // builder's default use case (a text request unless they chose otherwise).
+    const pickedUseCases = multiSelectUseCases ? useCases : useCase ? [useCase] : [];
+    const activeUseCases = pickedUseCases.length > 0 ? pickedUseCases : [defaultUseCase];
+    // An edit needs an image, then a change: a prompt for the whole image, a
+    // region with its own instruction, or both.
+    const editing = activeUseCases.some((u) => u.edit);
+    const hasImage = attachments.some((a) => a.kind === "image");
+    const hasContent = editing
+        ? hasImage && (value.trim().length > 0 || regions.length > 0)
+        : value.trim().length > 0 || attachments.length > 0;
+    const placeholder = props.placeholder ??
+        (editing
+            ? hasImage
+                ? "Describe a change across the whole image, or leave this empty"
+                : "Attach an image to edit"
+            : "Describe media to create");
+    // The stop icon only appears with somewhere for its click to go.
+    const showStop = submitting && Boolean(props.onAbort);
+    const multiModel = multiSelectModels || multiSelectUseCases;
+    const rawPickedIds = multiModel ? modelIds : modelId ? [modelId] : [];
+    // The app's list for a use case, or Chai's suggested models when it gave none.
+    const rosterFor = (u) => {
+        const given = multiSelectUseCases ? modelsByKind?.[u.kind] : models;
+        if (given)
+            return { options: given, suggested: false };
+        return { options: suggestedModels(u.edit ? "image-edit" : deriveGenerationUseCase(u, attachments)), suggested: true };
+    };
+    // One menu section per use case with multi-use-case select; otherwise one flat roster.
+    const modelSections = (multiSelectUseCases ? activeUseCases : activeUseCases.slice(0, 1))
+        .map((u) => ({ label: multiSelectUseCases ? u.label : "", kind: u.kind, ...rosterFor(u) }))
+        .filter((s) => s.options.length > 0);
+    const allModels = modelSections.flatMap((s) => s.options);
+    // No menu that can't change anything: without its handler, the Model menu hides.
+    const canPickModel = Boolean(multiModel ? props.onModelIdsChange : props.onModelChange);
+    // A pick that isn't in the current list (e.g. the edit model after leaving
+    // edit mode) is shown as unpicked and never submitted. With no list at
+    // all, the app's pick is passed through as given. The Composer never picks
+    // for the person: with a Model menu, nothing is picked until they pick or
+    // turn on auto-select. Only with no menu (nothing the person could pick
+    // with) does a suggested list's first model run.
+    const validPicks = allModels.length > 0 ? rawPickedIds.filter((id) => allModels.some((m) => m.id === id)) : rawPickedIds;
+    const pickedModelIds = validPicks.length > 0 || autoSelectModel || canPickModel
+        ? validPicks
+        : modelSections.filter((s) => s.suggested).map((s) => s.options[0].id);
+    const pickedModels = allModels.filter((m) => pickedModelIds.includes(m.id));
+    const modelTriggerLabel = pickedModels.length > 1
+        ? `${pickedModels.length} models`
+        : (pickedModels[0]?.label ?? (autoSelectModel ? "Auto-select" : multiModel ? "Select models" : "Select model"));
+    // With a Model menu, a submit needs a model: one picked, or auto-select to pick it.
+    const needsModel = canPickModel && modelSections.length > 0 && !autoSelectModel && pickedModelIds.length === 0;
+    const isSubmitDisabled = submitError ? disabled : (props.submitDisabled ?? (disabled || !hasContent || needsModel));
+    // An edit keeps the source image's shape.
+    const showAspectRatio = activeUseCases.some((u) => !u.edit && (u.kind === "image" || u.kind === "video"));
+    // Only ratios every model that might run takes: the picked ones, or with
+    // none picked (or auto-select on) the whole list, so whichever runs can
+    // honor it. A model with no `aspectRatios` sets its own shape: no menu.
+    const ratioModels = pickedModels.length > 0 && !autoSelectModel ? pickedModels : allModels;
+    const sharedRatios = ratioModels.reduce((shared, m) => (shared ?? m.aspectRatios ?? []).filter((r) => m.aspectRatios?.includes(r)), null) ??
+        [];
+    const aspectOptions = aspectRatios
+        ? aspectRatios.filter((o) => sharedRatios.includes(o.value))
+        : sharedRatios.map((r) => ({ value: r, label: r }));
+    // A pick the current models don't take is shown as unpicked and never sent.
+    const offeredAspect = showAspectRatio && aspectOptions.some((o) => o.value === aspectRatio) ? aspectRatio : null;
+    const selectedAspect = aspectOptions.find((o) => o.value === offeredAspect) ?? null;
+    const selections = () => activeUseCases.map((u) => ({
+        useCase: u,
+        models: rosterFor(u).options,
+        modelIds: multiSelectUseCases ? pickedModelIds.filter((id) => rosterFor(u).options.some((m) => m.id === id)) : pickedModelIds,
+    }));
+    return {
+        pickedUseCases,
+        /**
+         * Which use cases are picked, as one string. When it changes, a Composer
+         * whose end user owns the auto-select switch turns auto-select off: it
+         * belongs to the Model menu it was turned on in, so a new use case
+         * starts with its model picked by hand.
+         */
+        useCaseKey: pickedUseCases.map((u) => `${u.kind}${u.edit ? ":edit" : ""}`).join(","),
+        activeUseCases,
+        editing,
+        isSubmitDisabled,
+        placeholder,
+        showStop,
+        multiModel,
+        modelSections,
+        pickedModelIds,
+        canPickModel,
+        modelTriggerLabel,
+        showAspectRatio,
+        aspectOptions,
+        offeredAspect,
+        selectedAspect,
+        /** The model ids after a row click: the one picked, or with multi-select that one toggled. */
+        toggledModelIds: (id) => (modelIds.includes(id) ? modelIds.filter((m) => m !== id) : [...modelIds, id]),
+        /** Everything a submit sends. */
+        payload: () => ({
+            value,
+            attachments,
+            useCase: activeUseCases[0],
+            modelId: pickedModelIds[0] ?? null,
+            aspectRatio: offeredAspect,
+            selections: selections(),
+            autoSelectModel,
+            regions: editing ? regions : [],
+        }),
+    };
+}
+/** The `+` menu items that can work: "Add media" needs somewhere to put files, the use-case items a handler. */
+export function composerAttachMenuItems(actions, { canAddMedia, canSelect }) {
+    return COMPOSER_ATTACH_MENU_ITEMS.filter((item) => (actions ?? COMPOSER_ATTACH_MENU_ITEMS.map((i) => i.action)).includes(item.action) &&
+        (item.action === "add-media" ? canAddMedia : canSelect));
+}
+/**
+ * The attachments after picking files: each image, video or audio file
+ * added in the order picked. Editing works on one image, so its first image
+ * replaces what's there (and with none, every file is unsupported).
+ */
+export async function composerAttachmentsFromFiles(files, current, editing) {
+    const list = [...files];
+    if (editing) {
+        const image = list.find((f) => f.type.startsWith("image/"));
+        if (!image)
+            return { attachments: null, unsupported: list.map((f) => f.name) };
+        const { media, unsupported } = await readMediaFiles([image]);
+        return { attachments: media.length > 0 ? media.map((m) => ({ ...m, id: uniqueId() })) : null, unsupported };
+    }
+    const { media, unsupported } = await readMediaFiles(list);
+    return { attachments: [...current, ...media.map((m) => ({ ...m, id: uniqueId() }))], unsupported };
+}
+//# sourceMappingURL=composer-view.js.map

package/dist/composer-view.js.map

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

package/dist/edit-card.d.ts

@@ -0,0 +1,53 @@
+import { type EditRegion, type RegionBox } from "./region-edit.js";
+export declare const EDIT_ZOOM_STEPS: number[];
+export type RegionCorner = "nw" | "ne" | "sw" | "se";
+export declare const REGION_CORNERS: RegionCorner[];
+export interface Size {
+    width: number;
+    height: number;
+}
+export interface Pan {
+    x: number;
+    y: number;
+}
+/** Keeps a box inside the image and at least the minimum size. */
+export declare function fitBox(box: RegionBox): RegionBox;
+/** A box resized by dragging one corner; the opposite corner stays put. */
+export declare function resizeBox(box: RegionBox, corner: RegionCorner, dx: number, dy: number): RegionBox;
+/** A region's box after a key: arrows move it (Shift resizes, Alt takes bigger steps). `null` for any other key. */
+export declare function regionBoxForKey(box: RegionBox, key: string, { shift, alt }?: {
+    shift?: boolean | undefined;
+    alt?: boolean | undefined;
+}): RegionBox | null;
+/** Pan limits at a zoom level: the image always covers the viewport. */
+export declare function clampPan(pan: Pan, zoom: number, size: Size): Pan;
+/** The pan that zooms around the middle of the view, so what's centered stays centered. */
+export declare function panForZoom(pan: Pan, zoom: number, next: number, size: Size): Pan;
+/** The pan after an arrow key on the zoomed image, or `null` for any other key. */
+export declare function panForKey(pan: Pan, key: string, zoom: number, size: Size): Pan | null;
+/** The lowest number no current region uses, so freed numbers (and colors) come back first. */
+export declare function freeRegionNumber(regions: EditRegion[]): number;
+/** A new region, centered in the part of the image in view, so it's visible when zoomed in. */
+export declare function newRegion(regions: EditRegion[], zoom: number, pan: Pan, size: Size): EditRegion;
+/**
+ * Where the instruction field goes: above its region, or below it when
+ * there isn't room above and it clears the controls along the bottom edge.
+ */
+export declare function regionPopoverPosition(box: RegionBox, zoom: number, pan: Pan, size: Size, paginated: boolean): {
+    left: number;
+    top: number;
+    above: boolean;
+};
+/**
+ * The card's width: from `scale` (of the image's own width), else `width`,
+ * else `maxWidth`, then fitted inside `maxWidth` × `maxHeight` keeping the image's shape.
+ */
+export declare function editCardWidth(natural: Size | null, { width, scale, maxWidth, maxHeight }: {
+    width?: number;
+    scale?: number;
+    maxWidth: number;
+    maxHeight: number;
+}): number;
+/** A region's place on the image, as percentages, and its color. */
+export declare function regionBoxStyle(r: EditRegion): Record<string, string>;
+//# sourceMappingURL=edit-card.d.ts.map

package/dist/edit-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-card.d.ts","sourceRoot":"","sources":["../src/edit-card.ts"],"names":[],"mappings":"AAMA,OAAO,EAAe,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEhF,eAAO,MAAM,eAAe,UAA0B,CAAC;AAQvD,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AACrD,eAAO,MAAM,cAAc,EAAE,YAAY,EAA6B,CAAC;AACvE,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,GAAG;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAID,kEAAkE;AAClE,wBAAgB,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,CAIhD;AAED,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAUjG;AAED,oHAAoH;AACpH,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,KAAa,EAAE,GAAW,EAAE;;;CAAK,GAAG,SAAS,GAAG,IAAI,CAMlH;AAED,wEAAwE;AACxE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,GAAG,CAKhE;AAED,2FAA2F;AAC3F,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,GAAG,CAKhF;AAED,mFAAmF;AACnF,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,GAAG,GAAG,IAAI,CAIrF;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAI9D;AAED,+FAA+F;AAC/F,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,UAAU,CAM/F;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO;;;;EAY3G;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,IAAI,GAAG,IAAI,EACpB,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC7G,MAAM,CAIR;AAED,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQpE"}

package/dist/edit-card.js

@@ -0,0 +1,119 @@
+/**
+ * The EditCard's geometry, the same in every framework binding: region
+ * boxes, zoom and pan, where the instruction field goes, and the card's
+ * width. Boxes are fractions of the image (0 to 1); pan and sizes are px.
+ */
+import { uniqueId } from "./unique-id.js";
+import { regionColor } from "./region-edit.js";
+export const EDIT_ZOOM_STEPS = [1, 1.25, 1.5, 2, 3, 4];
+const MIN_SIZE = 0.03;
+const KEY_STEP = 0.01;
+const KEY_STEP_LARGE = 0.05;
+/** The instruction field's width, and a typical height (title row and a two-line field), for placing it. */
+const POPOVER_WIDTH = 220;
+const POPOVER_HEIGHT = 96;
+export const REGION_CORNERS = ["nw", "ne", "sw", "se"];
+const clamp = (v, min, max) => Math.min(max, Math.max(min, v));
+/** Keeps a box inside the image and at least the minimum size. */
+export function fitBox(box) {
+    const width = clamp(box.width, MIN_SIZE, 1);
+    const height = clamp(box.height, MIN_SIZE, 1);
+    return { x: clamp(box.x, 0, 1 - width), y: clamp(box.y, 0, 1 - height), width, height };
+}
+/** A box resized by dragging one corner; the opposite corner stays put. */
+export function resizeBox(box, corner, dx, dy) {
+    let left = box.x;
+    let top = box.y;
+    let right = box.x + box.width;
+    let bottom = box.y + box.height;
+    if (corner === "nw" || corner === "sw")
+        left = clamp(left + dx, 0, right - MIN_SIZE);
+    else
+        right = clamp(right + dx, left + MIN_SIZE, 1);
+    if (corner === "nw" || corner === "ne")
+        top = clamp(top + dy, 0, bottom - MIN_SIZE);
+    else
+        bottom = clamp(bottom + dy, top + MIN_SIZE, 1);
+    return { x: left, y: top, width: right - left, height: bottom - top };
+}
+/** A region's box after a key: arrows move it (Shift resizes, Alt takes bigger steps). `null` for any other key. */
+export function regionBoxForKey(box, key, { shift = false, alt = false } = {}) {
+    const step = alt ? KEY_STEP_LARGE : KEY_STEP;
+    const delta = { ArrowLeft: [-step, 0], ArrowRight: [step, 0], ArrowUp: [0, -step], ArrowDown: [0, step] }[key];
+    if (!delta)
+        return null;
+    const [dx, dy] = delta;
+    return shift ? resizeBox(box, "se", dx, dy) : fitBox({ ...box, x: box.x + dx, y: box.y + dy });
+}
+/** Pan limits at a zoom level: the image always covers the viewport. */
+export function clampPan(pan, zoom, size) {
+    return {
+        x: clamp(pan.x, size.width - size.width * zoom, 0),
+        y: clamp(pan.y, size.height - size.height * zoom, 0),
+    };
+}
+/** The pan that zooms around the middle of the view, so what's centered stays centered. */
+export function panForZoom(pan, zoom, next, size) {
+    const cx = size.width / 2;
+    const cy = size.height / 2;
+    const ratio = next / zoom;
+    return clampPan({ x: cx - (cx - pan.x) * ratio, y: cy - (cy - pan.y) * ratio }, next, size);
+}
+/** The pan after an arrow key on the zoomed image, or `null` for any other key. */
+export function panForKey(pan, key, zoom, size) {
+    const step = 40;
+    const delta = { ArrowLeft: [step, 0], ArrowRight: [-step, 0], ArrowUp: [0, step], ArrowDown: [0, -step] }[key];
+    return delta ? clampPan({ x: pan.x + delta[0], y: pan.y + delta[1] }, zoom, size) : null;
+}
+/** The lowest number no current region uses, so freed numbers (and colors) come back first. */
+export function freeRegionNumber(regions) {
+    let n = 1;
+    while (regions.some((r) => r.number === n))
+        n += 1;
+    return n;
+}
+/** A new region, centered in the part of the image in view, so it's visible when zoomed in. */
+export function newRegion(regions, zoom, pan, size) {
+    const view = 1 / zoom;
+    const centerX = size.width ? -pan.x / (size.width * zoom) + view / 2 : 0.5;
+    const centerY = size.height ? -pan.y / (size.height * zoom) + view / 2 : 0.5;
+    const box = fitBox({ x: centerX - (0.3 * view) / 2, y: centerY - (0.2 * view) / 2, width: 0.3 * view, height: 0.2 * view });
+    return { id: uniqueId(), number: freeRegionNumber(regions), box, prompt: "" };
+}
+/**
+ * Where the instruction field goes: above its region, or below it when
+ * there isn't room above and it clears the controls along the bottom edge.
+ */
+export function regionPopoverPosition(box, zoom, pan, size, paginated) {
+    const left = box.x * size.width * zoom + pan.x;
+    const top = box.y * size.height * zoom + pan.y;
+    const bottom = (box.y + box.height) * size.height * zoom + pan.y;
+    const reserved = paginated ? 100 : 56;
+    const fitsBelow = bottom + 8 + POPOVER_HEIGHT <= size.height - reserved;
+    const above = top > POPOVER_HEIGHT + 16 || !fitsBelow;
+    return {
+        left: clamp(left, 8, Math.max(8, size.width - POPOVER_WIDTH - 8)),
+        top: above ? Math.max(top - 8, POPOVER_HEIGHT + 8) : bottom + 8,
+        above,
+    };
+}
+/**
+ * The card's width: from `scale` (of the image's own width), else `width`,
+ * else `maxWidth`, then fitted inside `maxWidth` × `maxHeight` keeping the image's shape.
+ */
+export function editCardWidth(natural, { width, scale, maxWidth, maxHeight }) {
+    const base = scale != null && natural ? natural.width * scale : (width ?? maxWidth);
+    const heightCap = natural && natural.height > 0 ? (maxHeight * natural.width) / natural.height : Infinity;
+    return Math.round(Math.min(base, maxWidth, heightCap));
+}
+/** A region's place on the image, as percentages, and its color. */
+export function regionBoxStyle(r) {
+    return {
+        left: `${r.box.x * 100}%`,
+        top: `${r.box.y * 100}%`,
+        width: `${r.box.width * 100}%`,
+        height: `${r.box.height * 100}%`,
+        "--chai-region-color": regionColor(r.number),
+    };
+}
+//# sourceMappingURL=edit-card.js.map

package/dist/edit-card.js.map

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

package/dist/index.d.ts

@@ -11,4 +11,8 @@ export * from "./check-suggested-models.js";
 export * from "./reasoning.js";
 export * from "./composer.js";
 export * from "./media-analyzer.js";
+export * from "./media-actions.js";
+export * from "./result-format.js";
+export * from "./composer-view.js";
+export * from "./edit-card.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,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"}
+{"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,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"}

package/dist/index.js

@@ -11,4 +11,8 @@ export * from "./check-suggested-models.js";
 export * from "./reasoning.js";
 export * from "./composer.js";
 export * from "./media-analyzer.js";
+export * from "./media-actions.js";
+export * from "./result-format.js";
+export * from "./composer-view.js";
+export * from "./edit-card.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,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"}
+{"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,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"}

package/dist/media-actions.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Download and share for a piece of generated media, shared by the cards in
+ * every framework binding.
+ *
+ * A plain `<a download href={remoteUrl}>` only forces a download for a
+ * same-origin or `blob:`/`data:` URL; for a cross-origin CDN URL (what a
+ * generated result usually is) browsers ignore `download` and open it
+ * instead. Fetching it into a blob first works wherever the source allows
+ * cross-origin fetches. When it doesn't, opening the media is the fallback.
+ */
+export declare function downloadMedia(src: string, filename: string): Promise<void>;
+/**
+ * The native share sheet where there is one, otherwise the media's URL
+ * copied to the clipboard. Says which, so the button can confirm a copy.
+ */
+export declare function shareMedia(src: string): Promise<"shared" | "copied" | "none">;
+/** A file name for a download: the URL's own extension when it has one, otherwise a guess by kind. */
+export declare function downloadFilename(id: string, kind: string, src: string): string;
+//# sourceMappingURL=media-actions.d.ts.map

package/dist/media-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-actions.d.ts","sourceRoot":"","sources":["../src/media-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAehF;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC,CAgBnF;AAED,sGAAsG;AACtG,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAI9E"}

package/dist/media-actions.js

@@ -0,0 +1,57 @@
+/**
+ * Download and share for a piece of generated media, shared by the cards in
+ * every framework binding.
+ *
+ * A plain `<a download href={remoteUrl}>` only forces a download for a
+ * same-origin or `blob:`/`data:` URL; for a cross-origin CDN URL (what a
+ * generated result usually is) browsers ignore `download` and open it
+ * instead. Fetching it into a blob first works wherever the source allows
+ * cross-origin fetches. When it doesn't, opening the media is the fallback.
+ */
+export async function downloadMedia(src, filename) {
+    try {
+        const response = await fetch(src);
+        const blob = await response.blob();
+        const blobUrl = URL.createObjectURL(blob);
+        const a = document.createElement("a");
+        a.href = blobUrl;
+        a.download = filename;
+        document.body.appendChild(a);
+        a.click();
+        a.remove();
+        URL.revokeObjectURL(blobUrl);
+    }
+    catch {
+        window.open(src, "_blank", "noopener");
+    }
+}
+/**
+ * The native share sheet where there is one, otherwise the media's URL
+ * copied to the clipboard. Says which, so the button can confirm a copy.
+ */
+export async function shareMedia(src) {
+    if (navigator.share) {
+        try {
+            await navigator.share({ url: src });
+            return "shared";
+        }
+        catch {
+            // Dismissed, or not shareable: same as closing a native share sheet.
+            return "none";
+        }
+    }
+    try {
+        await navigator.clipboard.writeText(src);
+        return "copied";
+    }
+    catch {
+        return "none";
+    }
+}
+/** A file name for a download: the URL's own extension when it has one, otherwise a guess by kind. */
+export function downloadFilename(id, kind, src) {
+    const match = /\.([a-zA-Z0-9]{2,5})(?:[?#]|$)/.exec(src);
+    const ext = match?.[1] ?? (kind === "video" ? "mp4" : kind === "audio" ? "mp3" : kind === "text" ? "txt" : "png");
+    return `${kind}-${id}.${ext}`;
+}
+//# sourceMappingURL=media-actions.js.map

package/dist/media-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-actions.js","sourceRoot":"","sources":["../src/media-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,QAAgB;IAC/D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC,CAAC,IAAI,GAAG,OAAO,CAAC;QACjB,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC,CAAC,KAAK,EAAE,CAAC;QACV,CAAC,CAAC,MAAM,EAAE,CAAC;QACX,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW;IAC1C,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;YACpC,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,qEAAqE;YACrE,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACzC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,gBAAgB,CAAC,EAAU,EAAE,IAAY,EAAE,GAAW;IACpE,MAAM,KAAK,GAAG,gCAAgC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzD,MAAM,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAClH,OAAO,GAAG,IAAI,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC;AAChC,CAAC"}