allyhub 0.4.0 → 0.5.0

package/dist/node_modules/@allyhub-next/protocol/dist/tools.d.ts

@@ -0,0 +1,389 @@
+import { z } from "zod";
+import { type ClientOf, type MethodSpec } from "./jsonrpc.js";
+/** A picture: WebP unless said. */
+export declare const ImageSchema: z.ZodObject<{
+    mime: z.ZodString;
+    data: z.ZodBase64;
+}, z.core.$strict>;
+export type Image = z.infer<typeof ImageSchema>;
+/** A problem of the check (video-core's `Problem`): an objective error, by rule. */
+export declare const ProblemSchema: z.ZodObject<{
+    code: z.ZodString;
+    level: z.ZodEnum<{
+        error: "error";
+        warn: "warn";
+    }>;
+    message: z.ZodString;
+    piece: z.ZodOptional<z.ZodString>;
+    part: z.ZodOptional<z.ZodString>;
+    t: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+/** A fact of the check (video-core's `Fact`): a measurement for the agent to judge. */
+export declare const FactSchema: z.ZodObject<{
+    kind: z.ZodString;
+    data: z.ZodUnknown;
+}, z.core.$loose>;
+/** A version's film plan (video-core's `Timeline`). */
+export declare const TimelineSchema: z.ZodObject<{
+    fps: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    duration: z.ZodNumber;
+    parts: z.ZodArray<z.ZodUnknown>;
+}, z.core.$loose>;
+export declare const CHECK_STATES: readonly ["off", "waiting", "running", "done", "failed"];
+/** The check the server runs after edits, as it stands. */
+export declare const CheckStateSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        off: "off";
+        waiting: "waiting";
+        running: "running";
+        done: "done";
+        failed: "failed";
+    }>;
+    revision: z.ZodInt;
+    problems: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        level: z.ZodEnum<{
+            error: "error";
+            warn: "warn";
+        }>;
+        message: z.ZodString;
+        piece: z.ZodOptional<z.ZodString>;
+        part: z.ZodOptional<z.ZodString>;
+        t: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+    facts: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        data: z.ZodUnknown;
+    }, z.core.$loose>>;
+    versions: z.ZodOptional<z.ZodObject<{
+        total: z.ZodInt;
+        loaded: z.ZodInt;
+        reused: z.ZodInt;
+    }, z.core.$strict>>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type CheckState = z.infer<typeof CheckStateSchema>;
+export declare const EXPORT_STATES: readonly ["queued", "running", "done", "failed", "cancelled"];
+/** An export the person asked for, one at a time. */
+/** The choices an export is made with (`EXPORT_OFFER`). */
+export declare const ExportOptionsSchema: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>;
+export type ExportOptions = z.infer<typeof ExportOptionsSchema>;
+export declare const ExportJobSchema: z.ZodObject<{
+    id: z.ZodString;
+    item: z.ZodString;
+    versions: z.ZodArray<z.ZodString>;
+    types: z.ZodArray<z.ZodString>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>>;
+    state: z.ZodEnum<{
+        running: "running";
+        done: "done";
+        failed: "failed";
+        queued: "queued";
+        cancelled: "cancelled";
+    }>;
+    progress: z.ZodNumber;
+    files: z.ZodArray<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ExportJob = z.infer<typeof ExportJobSchema>;
+/** Where indexing a video the project uses is (a face track, a person matte). */
+export declare const IndexJobSchema: z.ZodObject<{
+    file: z.ZodString;
+    status: z.ZodEnum<{
+        running: "running";
+        done: "done";
+        failed: "failed";
+    }>;
+    message: z.ZodString;
+    share: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type IndexJob = z.infer<typeof IndexJobSchema>;
+export declare const PROJECT_TOOLS: {
+    readonly "project/items": MethodSpec<z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                video: "video";
+                slides: "slides";
+                doc: "doc";
+                sheet: "sheet";
+                scenery: "scenery";
+                model: "model";
+                website: "website";
+            }>;
+            dir: z.ZodString;
+            entry: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        folder: z.ZodString;
+        name: z.ZodString;
+        revision: z.ZodInt;
+    }, z.core.$strict>>;
+    readonly "sheet/generated": MethodSpec<z.ZodObject<{
+        item: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        generated: z.ZodOptional<z.ZodUnknown>;
+        failed: z.ZodBoolean;
+    }, z.core.$strict>>;
+    readonly "video/versions": MethodSpec<z.ZodObject<{
+        item: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        piece: z.ZodString;
+        kind: z.ZodEnum<{
+            video: "video";
+            slides: "slides";
+        }>;
+        title: z.ZodOptional<z.ZodString>;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        versions: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            lang: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    readonly "slides/deck": MethodSpec<z.ZodObject<{
+        item: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        piece: z.ZodString;
+        file: z.ZodString;
+        prefix: z.ZodString;
+        layouts: z.ZodArray<z.ZodString>;
+        components: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        generators: z.ZodArray<z.ZodString>;
+        scripts: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>>;
+    readonly "video/stage": MethodSpec<z.ZodObject<{
+        start: z.ZodOptional<z.ZodObject<{
+            t: z.ZodOptional<z.ZodNumber>;
+            part: z.ZodOptional<z.ZodString>;
+            offset: z.ZodOptional<z.ZodNumber>;
+            dur: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        play: z.ZodOptional<z.ZodBoolean>;
+        chrome: z.ZodOptional<z.ZodBoolean>;
+        edit: z.ZodOptional<z.ZodBoolean>;
+        item: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        url: z.ZodString;
+        probe: z.ZodString;
+    }, z.core.$strict>>;
+    readonly "video/timeline": MethodSpec<z.ZodObject<{
+        item: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        timeline: z.ZodObject<{
+            fps: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            duration: z.ZodNumber;
+            parts: z.ZodArray<z.ZodUnknown>;
+        }, z.core.$loose>;
+        text: z.ZodArray<z.ZodUnknown>;
+    }, z.core.$strict>>;
+    readonly "video/still": MethodSpec<z.ZodObject<{
+        t: z.ZodOptional<z.ZodNumber>;
+        item: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        t: z.ZodNumber;
+        image: z.ZodObject<{
+            mime: z.ZodString;
+            data: z.ZodBase64;
+        }, z.core.$strict>;
+        width: z.ZodInt;
+        height: z.ZodInt;
+        duration: z.ZodNumber;
+    }, z.core.$strict>>;
+    readonly "video/stills": MethodSpec<z.ZodObject<{
+        moments: z.ZodArray<z.ZodNumber>;
+        item: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        stills: z.ZodArray<z.ZodObject<{
+            t: z.ZodNumber;
+            image: z.ZodObject<{
+                mime: z.ZodString;
+                data: z.ZodBase64;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    readonly "check/results": MethodSpec<z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
+        status: z.ZodEnum<{
+            off: "off";
+            waiting: "waiting";
+            running: "running";
+            done: "done";
+            failed: "failed";
+        }>;
+        revision: z.ZodInt;
+        problems: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            level: z.ZodEnum<{
+                error: "error";
+                warn: "warn";
+            }>;
+            message: z.ZodString;
+            piece: z.ZodOptional<z.ZodString>;
+            part: z.ZodOptional<z.ZodString>;
+            t: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        facts: z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            data: z.ZodUnknown;
+        }, z.core.$loose>>;
+        versions: z.ZodOptional<z.ZodObject<{
+            total: z.ZodInt;
+            loaded: z.ZodInt;
+            reused: z.ZodInt;
+        }, z.core.$strict>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    readonly "check/run": MethodSpec<z.ZodObject<{}, z.core.$strict>, z.ZodObject<{}, z.core.$strict>>;
+    readonly "export/start": MethodSpec<z.ZodObject<{
+        item: z.ZodString;
+        versions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        job: z.ZodObject<{
+            id: z.ZodString;
+            item: z.ZodString;
+            versions: z.ZodArray<z.ZodString>;
+            types: z.ZodArray<z.ZodString>;
+            options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>>;
+            state: z.ZodEnum<{
+                running: "running";
+                done: "done";
+                failed: "failed";
+                queued: "queued";
+                cancelled: "cancelled";
+            }>;
+            progress: z.ZodNumber;
+            files: z.ZodArray<z.ZodString>;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    readonly "export/cancel": MethodSpec<z.ZodObject<{
+        job: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{}, z.core.$strict>>;
+    readonly "export/list": MethodSpec<z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
+        jobs: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            item: z.ZodString;
+            versions: z.ZodArray<z.ZodString>;
+            types: z.ZodArray<z.ZodString>;
+            options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>>;
+            state: z.ZodEnum<{
+                running: "running";
+                done: "done";
+                failed: "failed";
+                queued: "queued";
+                cancelled: "cancelled";
+            }>;
+            progress: z.ZodNumber;
+            files: z.ZodArray<z.ZodString>;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        reveal: z.ZodBoolean;
+    }, z.core.$strict>>;
+    readonly "export/reveal": MethodSpec<z.ZodObject<{
+        path: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{}, z.core.$strict>>;
+    readonly "scenery/viewer": MethodSpec<z.ZodObject<{
+        item: z.ZodString;
+        camera: z.ZodOptional<z.ZodObject<{
+            position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+            target: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        url: z.ZodString;
+        probe: z.ZodString;
+    }, z.core.$strict>>;
+};
+export type ProjectToolName = keyof typeof PROJECT_TOOLS;
+/**
+ * What a person can do in an editor, an agent can do too
+ * (docs/editors.md): for each tool, the CLI command that does the same
+ * through the same package function, or the files an agent reads or
+ * writes instead. Every tool has its line; the CLI's tests check that
+ * each command named is one.
+ */
+export declare const AGENT_DOES: Record<ProjectToolName, {
+    command: string;
+} | {
+    files: string;
+}>;
+/** The project's tools, as typed calls. */
+export type ToolsClient = ClientOf<typeof PROJECT_TOOLS>;
+/** A tool's spec, by name. */
+export declare function toolSpec(name: string): MethodSpec | undefined;
+export declare const TOOL_NOTIFICATIONS: {
+    readonly "project/changed": import("./jsonrpc.js").NotificationSpec<z.ZodObject<{
+        revision: z.ZodInt;
+    }, z.core.$strict>>;
+    readonly "check/changed": import("./jsonrpc.js").NotificationSpec<z.ZodObject<{
+        status: z.ZodEnum<{
+            off: "off";
+            waiting: "waiting";
+            running: "running";
+            done: "done";
+            failed: "failed";
+        }>;
+        revision: z.ZodInt;
+        problems: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            level: z.ZodEnum<{
+                error: "error";
+                warn: "warn";
+            }>;
+            message: z.ZodString;
+            piece: z.ZodOptional<z.ZodString>;
+            part: z.ZodOptional<z.ZodString>;
+            t: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        facts: z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            data: z.ZodUnknown;
+        }, z.core.$loose>>;
+        versions: z.ZodOptional<z.ZodObject<{
+            total: z.ZodInt;
+            loaded: z.ZodInt;
+            reused: z.ZodInt;
+        }, z.core.$strict>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    readonly "export/changed": import("./jsonrpc.js").NotificationSpec<z.ZodObject<{
+        job: z.ZodObject<{
+            id: z.ZodString;
+            item: z.ZodString;
+            versions: z.ZodArray<z.ZodString>;
+            types: z.ZodArray<z.ZodString>;
+            options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>>;
+            state: z.ZodEnum<{
+                running: "running";
+                done: "done";
+                failed: "failed";
+                queued: "queued";
+                cancelled: "cancelled";
+            }>;
+            progress: z.ZodNumber;
+            files: z.ZodArray<z.ZodString>;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    readonly "index/changed": import("./jsonrpc.js").NotificationSpec<z.ZodObject<{
+        jobs: z.ZodArray<z.ZodObject<{
+            file: z.ZodString;
+            status: z.ZodEnum<{
+                running: "running";
+                done: "done";
+                failed: "failed";
+            }>;
+            message: z.ZodString;
+            share: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+};
+//# sourceMappingURL=tools.d.ts.map

package/dist/node_modules/@allyhub-next/protocol/dist/tools.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{z as e}from"zod";import{KINDS as c}from"@allyhub-next/formats";import{PathSchema as r}from"./files.js";import{method as t,notification as s}from"./jsonrpc.js";const i={item:r,version:e.string().optional()};export const ImageSchema=e.strictObject({mime:e.string().regex(/^image\//u),data:e.base64()}),ProblemSchema=e.looseObject({code:e.string(),level:e.enum(["error","warn"]),message:e.string(),piece:e.string().optional(),part:e.string().optional(),t:e.number().optional()}),FactSchema=e.looseObject({kind:e.string(),data:e.unknown()}),TimelineSchema=e.looseObject({fps:e.number(),width:e.number(),height:e.number(),duration:e.number(),parts:e.array(e.unknown())}),CHECK_STATES=["off","waiting","running","done","failed"],CheckStateSchema=e.strictObject({status:e.enum(CHECK_STATES),revision:e.int().nonnegative(),problems:e.array(ProblemSchema),facts:e.array(FactSchema),versions:e.strictObject({total:e.int(),loaded:e.int(),reused:e.int()}).optional(),error:e.string().optional()}),EXPORT_STATES=["queued","running","done","failed","cancelled"],ExportOptionsSchema=e.record(e.string(),e.union([e.string(),e.boolean()])),ExportJobSchema=e.strictObject({id:e.string(),item:r,versions:e.array(e.string()),types:e.array(e.string()),options:ExportOptionsSchema.optional(),state:e.enum(EXPORT_STATES),progress:e.number().min(0).max(1),files:e.array(r),error:e.string().optional()}),IndexJobSchema=e.strictObject({file:r,status:e.enum(["running","done","failed"]),message:e.string(),share:e.number().min(0).max(1).optional()});const o=e.tuple([e.number(),e.number(),e.number()]),a=e.strictObject({url:e.string(),probe:e.string()});export const PROJECT_TOOLS={"project/items":t(e.strictObject({}),e.strictObject({items:e.array(e.strictObject({kind:e.enum(c),dir:r,entry:r,title:e.string().optional()})),folder:e.string(),name:e.string(),revision:e.int().nonnegative()}),"The project's items, as the build finds them."),"sheet/generated":t(e.strictObject({item:r}),e.strictObject({generated:e.unknown().optional(),failed:e.boolean()}),"What a sheet's sheet.ts makes now: sheets as sheet.yaml would hold them. Never written to a file."),"video/versions":t(e.strictObject({item:r}),e.strictObject({piece:e.string(),kind:e.enum(["video","slides"]),title:e.string().optional(),width:e.number(),height:e.number(),versions:e.array(e.strictObject({key:e.string(),lang:e.string().optional()}))}),"A video's or a deck's versions, one per language: what its stage, its timeline and its exports are asked for."),"slides/deck":t(e.strictObject({item:r}),e.strictObject({piece:e.string(),file:r,prefix:e.string(),layouts:e.array(e.string()),components:e.record(e.string(),e.unknown()),generators:e.array(e.string()),scripts:e.record(e.string(),r)}),"A deck's layouts, components and generators, and its files: slides.yaml (its slides) and its script in each language (their words and notes), which the deck's editor edits."),"video/stage":t(e.strictObject({...i,start:e.strictObject({t:e.number().nonnegative().optional(),part:e.string().optional(),offset:e.number().nonnegative().optional(),dur:e.number().positive().optional()}).optional(),play:e.boolean().optional(),chrome:e.boolean().optional(),edit:e.boolean().optional()}),a,"The address of a version's stage page, for a sandboxed frame: it plays the piece and talks to its parent by postMessage."),"video/timeline":t(e.strictObject(i),e.strictObject({timeline:TimelineSchema,text:e.array(e.unknown())}),"A version's timeline, drawn nowhere."),"video/still":t(e.strictObject({...i,t:e.number().nonnegative().optional()}),e.strictObject({t:e.number(),image:ImageSchema,width:e.int().positive(),height:e.int().positive(),duration:e.number().nonnegative()}),"A moment of a version as the render draws it, as a picture."),"video/stills":t(e.strictObject({...i,moments:e.array(e.number().nonnegative()).min(1).max(32)}),e.strictObject({stills:e.array(e.strictObject({t:e.number(),image:ImageSchema}))}),"Several moments of a version as the render draws them: what `video/still` gives, on one page."),"check/results":t(e.strictObject({}),CheckStateSchema,"The check run after edits, as it stands."),"check/run":t(e.strictObject({}),e.strictObject({}),"Runs the check again now."),"export/start":t(e.strictObject({item:r,versions:e.array(e.string()).optional(),types:e.array(e.string().min(1)).max(10).optional(),options:ExportOptionsSchema.optional()}),e.strictObject({job:ExportJobSchema}),"Exports an item (its versions, as file types) into .allyhub/out/; `export/changed` says how it goes."),"export/cancel":t(e.strictObject({job:e.string()}),e.strictObject({}),"Stops an export."),"export/list":t(e.strictObject({}),e.strictObject({jobs:e.array(ExportJobSchema),reveal:e.boolean()}),"The exports asked for since the server started."),"export/reveal":t(e.strictObject({path:r}),e.strictObject({}),"Shows an exported file in the person's file manager, where the server runs on their computer (`export/list`'s `reveal`)."),"scenery/viewer":t(e.strictObject({item:r,camera:e.strictObject({position:o,target:o}).optional()}),a,"The address of a scenery's viewer page, for a sandboxed frame: it tells what the person does by postMessage.")},AGENT_DOES={"project/items":{files:"the project's folder"},"sheet/generated":{files:"the item's sheet.ts and sheet.yaml"},"video/versions":{command:"inspect combos"},"slides/deck":{files:"slides.ts, slides.yaml and the item's script.<locale>.yaml"},"video/stage":{command:"frames"},"video/timeline":{command:"inspect timeline"},"video/still":{command:"frames"},"video/stills":{command:"frames"},"check/results":{command:"inspect"},"check/run":{command:"check"},"export/start":{command:"render"},"export/cancel":{command:"render"},"export/list":{files:".allyhub/out/"},"export/reveal":{files:".allyhub/out/"},"scenery/viewer":{command:"scenery view"}};export function toolSpec(n){return Object.hasOwn(PROJECT_TOOLS,n)?PROJECT_TOOLS[n]:void 0}export const TOOL_NOTIFICATIONS={"project/changed":s(e.strictObject({revision:e.int().nonnegative()}),"The build saw a change: a stage or a timeline asked for now is the new one's."),"check/changed":s(CheckStateSchema,"The check started, ended or failed."),"export/changed":s(e.strictObject({job:ExportJobSchema}),"An export moved on."),"index/changed":s(e.strictObject({jobs:e.array(IndexJobSchema)}),"Making what the media index lacks moved on.")};

package/dist/node_modules/@allyhub-next/protocol/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@allyhub-next/protocol",
+  "version": "0.5.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

package/dist/node_modules/@allyhub-next/registry/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@allyhub-next/registry",
+  "version": "0.5.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

package/dist/node_modules/@allyhub-next/render/dist/doc/index.d.ts

@@ -0,0 +1,3 @@
+export { docPage, printPage, renderDoc, renderWord, type DocFile, type DocFileType, type PrintOptions, type RenderDocOptions, type RenderWordOptions, } from "./print.js";
+export { docFontsCss } from "./fonts.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/node_modules/@allyhub-next/render/dist/doc/index.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export{docPage,printPage,renderDoc,renderWord}from"./print.js";export{docFontsCss}from"./fonts.js";

package/dist/node_modules/@allyhub-next/render/dist/doc/print.d.ts

@@ -0,0 +1,51 @@
+import { type DocxModule, type DocxZip } from "@allyhub-next/doc/docx";
+export type DocFileType = "pdf" | "png";
+/** Which doc: its file and folder (project paths), and its title. */
+export interface DocFile {
+    /** The doc's file, `<place>/doc.mdx`. */
+    file: string;
+    /** Its folder, which its pictures are named from. */
+    dir: string;
+    /** Its place, the page's title when it has none. */
+    path: string;
+    title?: string | undefined;
+}
+/** A doc's page as HTML, with the project's pictures it shows inside it. */
+export declare function docPage(root: string, doc: DocFile): Promise<string>;
+export interface RenderWordOptions {
+    root: string;
+    doc: DocFile;
+    /** The file written. */
+    out: string;
+    docx: DocxModule;
+    zip: DocxZip;
+}
+/** Writes a doc as a Word document, its text editable. */
+export declare function renderWord(opts: RenderWordOptions): Promise<void>;
+export interface RenderDocOptions {
+    root: string;
+    doc: DocFile;
+    /** The folder the files go in. */
+    out: string;
+    /** The files' base name; default "doc". */
+    name?: string;
+    types?: readonly DocFileType[];
+}
+export interface PrintOptions {
+    /** The page, whole: its fonts and pictures inside it. */
+    html: string;
+    /** The folder the files go in. */
+    out: string;
+    /** The files' base name. */
+    name: string;
+    types: readonly DocFileType[];
+    /** Added to the page before a picture of it is taken. */
+    pictureCss?: string;
+    /** The width of the window the page is laid out in, px. */
+    width?: number;
+}
+/** Writes a page of HTML as a PDF, a picture of all of it, or both: the files' names. */
+export declare function printPage(opts: PrintOptions): Promise<string[]>;
+/** Writes a doc as a PDF (and a picture of the whole page, when asked): the files' names. */
+export declare function renderDoc(opts: RenderDocOptions): Promise<string[]>;
+//# sourceMappingURL=print.d.ts.map

package/dist/node_modules/@allyhub-next/render/dist/doc/print.js

@@ -0,0 +1,18 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{mkdir as m,readFile as g,writeFile as u}from"node:fs/promises";import{dirname as w,extname as P,join as d,posix as h}from"node:path";import{openPage as p,startBrowser as y}from"@allyhub-next/browser";import{docHtml as S,parseDoc as v}from"@allyhub-next/doc";import{docxOf as j}from"@allyhub-next/doc/docx";import{docFontsCss as $}from"./fonts.js";const E={".png":"image/png",".jpg":"image/jpeg",".jpeg":"image/jpeg",".gif":"image/gif",".webp":"image/webp",".avif":"image/avif",".svg":"image/svg+xml"},I=/^([a-z][a-z0-9+.-]*:|\/\/)/i;async function x(e,t,a){const n=new Map,i=async s=>{for(const r of s){if("children"in r&&await i(r.children??[]),r.type!=="image"||I.test(r.src))continue;const c=h.normalize(h.join(t.dir,decodeURIComponent(r.src))),o=E[P(c).toLowerCase()];if(o===void 0||c.startsWith(".."))continue;const f=await g(d(e,c)).catch(()=>{});f&&n.set(r.src,{type:o,bytes:f})}};return await i(a),n}const b=({type:e,bytes:t})=>`data:${e};base64,${t.toString("base64")}`;export async function docPage(e,t){const a=v(await g(d(e,t.file),"utf8")),n=await x(e,t,a.blocks);return S(a.blocks,{title:t.title??t.path,image:i=>{const s=n.get(i);return s&&b(s)},fonts:await $()})}const O={"image/png":"png","image/jpeg":"jpg","image/gif":"gif"},k=2,z=.92;async function M(e,t){const a=O[t.type],n=await e.evaluate(`(async () => {
+    const image = new Image();
+    image.src = ${JSON.stringify(b(t))};
+    try { await image.decode(); } catch { return null; }
+    const width = image.naturalWidth || 1024;
+    const height = image.naturalHeight || 768;
+    if (${JSON.stringify(a!==void 0)}) return { width, height };
+    const scale = ${JSON.stringify(t.type==="image/svg+xml"?k:1)};
+    const canvas = document.createElement("canvas");
+    canvas.width = width * scale;
+    canvas.height = height * scale;
+    const context = canvas.getContext("2d");
+    context.fillStyle = "#fff";
+    context.fillRect(0, 0, canvas.width, canvas.height);
+    context.drawImage(image, 0, 0, canvas.width, canvas.height);
+    return { width, height, jpeg: canvas.toDataURL("image/jpeg", ${String(z)}) };
+  })()`);if(!n)return;const{width:i,height:s,jpeg:r}=n;if(a!==void 0)return{data:t.bytes,type:a,width:i,height:s};if(r!==void 0)return{data:Buffer.from(r.slice(r.indexOf(",")+1),"base64"),type:"jpg",width:i,height:s}}export async function renderWord(e){const{root:t,doc:a}=e,{blocks:n}=v(await g(d(t,a.file),"utf8")),i=await x(t,a,n),s=new Map;if(i.size>0){const c=await y({gpu:!1,htmlInCanvas:!1});try{const o=await p(c,{width:900,height:1200,allow:()=>!1});for(const[f,C]of i){const l=await M(o,C);l&&s.set(f,l)}}finally{await c.close()}}const r=await j(e.docx,e.zip,n,{title:a.title??a.path,picture:c=>s.get(c)});await m(w(e.out),{recursive:!0}),await u(e.out,r)}async function R(e,t){const{frameTree:a}=await e.session.send("Page.getFrameTree");await e.session.send("Page.setDocumentContent",{frameId:a.frame.id,html:t}),await e.evaluate("new Promise((r) => (document.readyState === 'complete' ? r() : addEventListener('load', () => r(), { once: true }))).then(() => document.fonts.ready).then(() => true)")}async function T(e){const{cssContentSize:t}=await e.session.send("Page.getLayoutMetrics"),a=await e.session.send("Page.captureScreenshot",{format:"png",clip:{x:0,y:0,width:Math.ceil(t.width),height:Math.ceil(t.height),scale:1},captureBeyondViewport:!0});return Buffer.from(a.data,"base64")}export async function printPage(e){const t=[],a=await y({gpu:!1,htmlInCanvas:!1});try{const n=await p(a,{width:e.width??900,height:1200,scale:2,allow:()=>!1});await R(n,e.html);for(const i of e.types){const s=d(e.out,`${e.name}.${i}`);if(await m(w(s),{recursive:!0}),i==="pdf"){const{data:r}=await n.session.send("Page.printToPDF",{preferCSSPageSize:!0,printBackground:!0});await u(s,Buffer.from(r,"base64"))}else e.pictureCss!==void 0&&await n.evaluate(`(() => { const s = document.createElement('style'); s.textContent = ${JSON.stringify(e.pictureCss)}; document.head.append(s); return true; })()`),await u(s,await T(n));t.push(`${e.name}.${i}`)}}finally{await a.close()}return t}export async function renderDoc(e){return printPage({html:await docPage(e.root,e.doc),out:e.out,name:e.name??"doc",types:e.types?.length?e.types:["pdf"],pictureCss:"body{padding:48px 0;background:#fff}"})}

package/dist/node_modules/@allyhub-next/render/dist/index.d.ts

@@ -0,0 +1,26 @@
+export type { ExportPage, FrameOptions, GraphicsPage, OutputReads, PartSignature, PartText, PrintPage, ProjectMedia, RenderTarget, VideoLook, } from "./page.js";
+export { RenderError } from "./errors.js";
+export { ffmpegOf, ffprobeOf, runFfmpegWith, toolsOf, write, type Tools, } from "./tools.js";
+export { ENCODERS, FFMPEG_MINIMUM, FFMPEG_PINNED, compareReleases, ffmpegEncoders, ffmpegHint, ffmpegRelease, ffmpegVersion, findFfmpeg, judgeFfmpeg, requireEncoder, requireFfmpeg, versionIn, type FfmpegFound, type FfmpegRelease, } from "./ffmpeg.js";
+export { renderVideo, type PartTimings, type RenderOptions, type RenderResult, type RenderTimings, } from "./render.js";
+export { MAX_WORKERS, SHARE_ENCODE, VIDEO_TYPES, autoWorkers, encodeFor, shareKbps, type EncodeOptions, type Picture, type VideoType, } from "./encode.js";
+export { segmentsOf, type Segment } from "./segments.js";
+export { masterOf, mixSound, type SoundInput } from "./sound.js";
+export { backgroundStill, finalStill, footageStill, videoFrame, type StillOptions, } from "./stills.js";
+export { hasFinalLook, lutFile } from "./look.js";
+export { compositeArgs, compositeStill, finishGraph, frameAt, partAt, planSources, stillOutput, transparentPng, type CompositeOptions, type StillFormat, } from "./composite.js";
+export { ffmpegColor, footagePlane, insetEllipse, keyedGeometry, layersIn, linearExpr, probeSource, roundedBox, type FootagePlane, type KeyedGeometry, type PlaneOptions, type PlaneSource, type SourceInfo, } from "./footage.js";
+export { junctionArgs, junctionGroups, junctionStill, type JunctionGroup, type JunctionOptions, type JunctionPicture, } from "./junction.js";
+export { PipeFormat, pngColorType, rgbaPng } from "./png.js";
+export { CAPTURE_DEFAULTS, GRAIN_MOST, blurredNoise, captureGraph, captureProblem, capturesAnything, exposureStops, grainAt, grainSize, grainWeight, type CaptureOptions, type Grain as CaptureGrain, } from "./capture.js";
+export { postFilterProblem, postGraph, postReadsTime } from "./post.js";
+export { ffmpegRuns, postPlaces, postProblems, tryPost, type PostPlace, type PostTrial, } from "./post-probe.js";
+export { CAP_START, breaksCap, capOf, capRun, overCap, packetSizes, type Cap, } from "./cap.js";
+export { PartCache, closedPart, drawnKey, junctionDigest, partCacheLimit, partDigest, type JunctionInputs, type PartInputs, type PieceCode, } from "./parts.js";
+export { MAX_PARTS, PagePool, Slots, drawInOrder, encoderSlots, partsAtOnce, renderSerial, type Rank, type Waits, } from "./pool.js";
+export { renderCaptions, renderCover, renderPdf, renderPng, renderPptx, type ExportOptions, type ExportResult, } from "./exports.js";
+export { lookFormat, webp, webpPath, type WebpQuality } from "./webp.js";
+export { blankImage, cropImage, pasteImage, readPng, resizeImage, writePng, type Img, } from "./image.js";
+export { CLIP_TYPES, clipTypeOf, writeClip, type ClipOptions, type ClipType, } from "./clip.js";
+export { DELIVERY_LEAD, parseEncode, throughEncode, type DeliveryEncode, } from "./delivery.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/node_modules/@allyhub-next/render/dist/index.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export{RenderError}from"./errors.js";export{ffmpegOf,ffprobeOf,runFfmpegWith,toolsOf,write}from"./tools.js";export{ENCODERS,FFMPEG_MINIMUM,FFMPEG_PINNED,compareReleases,ffmpegEncoders,ffmpegHint,ffmpegRelease,ffmpegVersion,findFfmpeg,judgeFfmpeg,requireEncoder,requireFfmpeg,versionIn}from"./ffmpeg.js";export{renderVideo}from"./render.js";export{MAX_WORKERS,SHARE_ENCODE,VIDEO_TYPES,autoWorkers,encodeFor,shareKbps}from"./encode.js";export{segmentsOf}from"./segments.js";export{masterOf,mixSound}from"./sound.js";export{backgroundStill,finalStill,footageStill,videoFrame}from"./stills.js";export{hasFinalLook,lutFile}from"./look.js";export{compositeArgs,compositeStill,finishGraph,frameAt,partAt,planSources,stillOutput,transparentPng}from"./composite.js";export{ffmpegColor,footagePlane,insetEllipse,keyedGeometry,layersIn,linearExpr,probeSource,roundedBox}from"./footage.js";export{junctionArgs,junctionGroups,junctionStill}from"./junction.js";export{PipeFormat,pngColorType,rgbaPng}from"./png.js";export{CAPTURE_DEFAULTS,GRAIN_MOST,blurredNoise,captureGraph,captureProblem,capturesAnything,exposureStops,grainAt,grainSize,grainWeight}from"./capture.js";export{postFilterProblem,postGraph,postReadsTime}from"./post.js";export{ffmpegRuns,postPlaces,postProblems,tryPost}from"./post-probe.js";export{CAP_START,breaksCap,capOf,capRun,overCap,packetSizes}from"./cap.js";export{PartCache,closedPart,drawnKey,junctionDigest,partCacheLimit,partDigest}from"./parts.js";export{MAX_PARTS,PagePool,Slots,drawInOrder,encoderSlots,partsAtOnce,renderSerial}from"./pool.js";export{renderCaptions,renderCover,renderPdf,renderPng,renderPptx}from"./exports.js";export{lookFormat,webp,webpPath}from"./webp.js";export{blankImage,cropImage,pasteImage,readPng,resizeImage,writePng}from"./image.js";export{CLIP_TYPES,clipTypeOf,writeClip}from"./clip.js";export{DELIVERY_LEAD,parseEncode,throughEncode}from"./delivery.js";

package/dist/node_modules/@allyhub-next/render/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@allyhub-next/render",
+  "version": "0.5.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./doc": {
+      "types": "./dist/doc/index.d.ts",
+      "default": "./dist/doc/index.js"
+    }
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

package/dist/node_modules/@allyhub-next/runtime/dist/compose.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{contentEdges as Se,fact as ge,intersect as ze,problem as be,RULES as Ne,STRUCTURE as we,toFrame as Re,showLayer as ke}from"@allyhub-next/video-core";import{realTimers as Ce}from"./guards.js";export const isFootage=t=>t.__allyhubLayer==="footage",zOf=t=>t.z==="behind-person"||t.z==="overlay"?t.z:"front",layerNames=t=>t.map(u=>isFootage(u)?"footage":u.component);export function resolveTimes(t,u,b){if(Array.isArray(t))return t.map(c=>resolveTimes(c,u,b));if(u===!0)return typeof t=="string"||typeof t=="number"?b(t):t;if(typeof t!="object"||t===null)return t;const p={...t};for(const[c,h]of Object.entries(u))c in p&&p[c]!==void 0&&(p[c]=resolveTimes(p[c],h,b));return p}export function windowOf(t,u,b){const p=x=>Math.min(Math.max(x,0),u),c=p(t.at===void 0?0:b(t.at)),h=t.until!==void 0?p(b(t.until)):t.dur!==void 0?p(c+t.dur):u;return[c,h]}export function planStack(t){const u=t.some(n=>!isFootage(n)&&zOf(n)==="behind-person"),b=u?t.findIndex(n=>isFootage(n)&&n.file===void 0):-1,p=n=>b>=0&&!isFootage(n)&&zOf(n)==="behind-person",c=n=>n!==void 0&&!isFootage(n)&&zOf(n)==="overlay",h=[];t.forEach((n,r)=>{isFootage(n)?(h.push(r),r===b&&t.forEach((v,E)=>{p(v)&&h.push(E)})):!p(n)&&!c(n)&&h.push(r)}),t.forEach((n,r)=>{c(n)&&h.push(r)});const x=[],y=new Map,j=new Map;let S;for(const n of h){const r=t[n];if(!r)continue;if(isFootage(r)){S=void 0,j.set(n,x.length);continue}const v=p(r)?"behind":c(r)?"overlay":"front";S!==v&&(x.push({layers:[],...v==="behind"?{behindPerson:!0}:{},...v==="overlay"?{overlay:!0}:{}}),S=v),y.set(n,x.length-1)}return{takeAt:b,hasBehind:u,order:h,planes:x,planeOf:y,overOf:j,overlaid:n=>c(t[n])}}const Le={captions:()=>[],face:()=>{},faces:()=>[],texts:()=>[]};export function layerContexts(t,u,b,p,c){const{log:h,ledger:x,embed:y,combo:j}=t,{look:S,format:n,dims:r}=u,v=[[0,0,r.width,r.safe.top],[0,r.height-r.safe.bottom,r.width,r.safe.bottom],[0,0,r.safe.left,r.height],[r.width-r.safe.right,0,r.safe.right,r.height]].filter(i=>i[2]>0&&i[3]>0),E=Se(r),P=[E.left,E.top,E.right-E.left,E.bottom-E.top],ee=i=>{if(!c)throw new Error(`"${i}": a page has no film to find it in.`);return c.filmAt(i)};return i=>{const B=i.reads??Le,U=i.record??(()=>{}),z=i.place,H=i.answers,I={look:S,format:n,dims:r,combo:i.combo??j,dur:i.dur,asset:a=>h.asset(a),optionalAsset:a=>h.optionalAsset(a),words:i.words,at:i.at,layer:{start:i.start,end:i.end},wait:a=>{x.wait(a)},report:a=>{const A=x.running,W=a.code in Ne?a.code:"AK-R001",_=A?.part??z?.part;x.ran(be(W,a.message,{...a.level?{level:a.level}:{},..._?{part:_}:{},...A?.t===void 0?{}:{t:A.t}}))},captions:a=>B.captions(a),face:(a,A)=>B.face(a,A),faces:a=>B.faces(a),texts:a=>B.texts(a),covered:v,content:P,video:(a,A)=>b.video(a,A,U),cameraFor:a=>y?.cameras?.[a]??y?.cameras?.["*"],...y?.sceneryScale===void 0?{}:{sceneryScale:y.sceneryScale},embedded:y!==void 0,get layoutOnly(){return p.mode==="layout"},realTimers:Ce,...H?{answer:(a,A)=>{H.set(a,A)}}:{}};return z&&Object.defineProperty(I,"film",{enumerable:!0,get:()=>(U("film",String(z.start)),{start:z.start,part:z.part,at:ee,...y?.shown?{outer:y.shown}:{}})}),I}}const Te=t=>Math.max(0,t-.4),ae=t=>Math.round(t*1e3)/1e3,xe=t=>Math.round(t*1e6)/1e6;export function compose(t){const{env:u,piece:b,stage:p,takes:c,film:h,captions:x,footage:y,sound:j}=t,{source:S,options:n,combo:r,picked:v,ledger:E}=u,{fps:P,format:ee,dims:i}=b,{specs:B}=c,{timing:U,windows:z}=h,H=[],I=[],a=[],A=n.purpose==="play",W=new Set,_=(w,o)=>{const d={};for(const[g,M]of Object.entries(r)){if(!v.has(g)||g===o){d[g]=M;continue}Object.defineProperty(d,g,{enumerable:!0,get:()=>(W.has(`${w}:${g}`)||(W.add(`${w}:${g}`),E.problems.push(be("AK-X005",`A layer of part ${w} reads ctx.combo.${g}, ${g===we?"the combo's structure":`the pick of the slot ${g}`}. A part is rendered once and reused in every combo that has it, so it may read only the dimensions${o===void 0?"":` and its own slot (${o})`}. Choose in the output's function instead, and pass the result as a prop.`,{part:w,where:{file:S.file}}))),M)})}return d};for(const[w,o]of B.entries()){const d=U.parts[w];if(!d)continue;const g=d.end-d.start,M=e=>U.at(w,e),ve=x.partWords(o.key),Ee=c.results[w]?.speech,ce=c.inputs[w],ie=ce?.placed??[],de=[...ie,...(ce?.anchors??[]).filter(e=>!ie.some(s=>s.name===e.name))],X=c.speechFor(w,d);let D;if(typeof o.still=="function")D=o.still(g);else if(o.still===void 0){D=Te(g);const e=z.get(w),s=z.get(w+1);if(e||s){const l=(e?.after??0)/P,k=g-((s?.before??0)+1)/P;D=Math.max(l,Math.min(D,k))}}else D=M(o.still);let q=Re(d.start+D,P);(q<d.start||q>=d.end)&&(q=d.start);const te=o.slot??(v.has(o.key)&&o.key!==we?o.key:void 0),Ae=v.size>0?_(o.key,te):r,se={reads:new Map,captioned:!1},oe=planStack(o.layers),{takeAt:ne,planes:K,planeOf:re,overOf:fe,order:pe}=oe,J=o.layers,le=o.post??J.map(e=>"props"in e?e.props.sensor?.grade:void 0).find(Boolean),N=c.videoTakes[w],m={key:o.key,...o.title===void 0?{}:{title:o.title},...te===void 0?{}:{slot:te},layers:layerNames(J),start:d.start,end:d.end,planes:K,still:q,...X.speech?{speech:X.speech}:{},...de.length>0?{anchors:de.map(e=>({name:e.name,at:ae(d.start+M(`@${e.name}`)),...e.end===void 0?{}:{end:ae(d.start+M(`@/${e.name}`))}}))}:{},...o.tags?.length?{tags:[...o.tags]}:{},...le?{post:{filter:le.filter}}:{},...o.speechGainDb!==void 0&&o.speechGainDb!==0?{speechGainDb:o.speechGainDb}:{},...N?{plays:{video:N.id,from:N.from,to:N.to}}:{}};H.push(m),j.addSpeech(X.clips,X.room);const $=document.createElement("section");$.className="ak-part",$.dataset.key=o.key,$.dataset.format=ee,Object.assign($.style,{position:"absolute",inset:"0",overflow:"hidden"}),ke($,!1),p.el.append($);const Q=new Map;A&&J.forEach((e,s)=>{if(!isFootage(e))return;const l=document.createElement("div");l.className="ak-footage-plane",Object.assign(l.style,{position:"absolute",inset:"0",...(fe.get(s)??0)>0?{pointerEvents:"none"}:{}}),Q.set(s,l)});let R;Q.size>0&&ne>=0&&(R=document.createElement("div"),R.className="ak-cutout-plane",Object.assign(R.style,{position:"absolute",inset:"0",pointerEvents:"none"}));const Oe={captions:e=>(se.captioned=!0,x.partCues(d.start,d.end,e)),face:(e,s)=>y.faceAt(o.key,d.start+e,s),faces:e=>y.facesAt(o.key,d.start+e)},V=[],ue=new Map;for(const[e,s]of J.entries()){const[l,k]=windowOf(s,g,M);if(isFootage(s)){const G=e===ne,Z=y.plan(s,m,Ee,d.speechAt,l,k,{at:M,cutout:G,over:fe.get(e)??0,person:G&&R!==void 0});if(Z&&A){const he=Q.get(e)??$,{matteUrl:ye,personOver:$e,...je}=Z;a.push({...je,host:he,...ye===void 0?{}:{cutoutIn:{host:$e&&R?R:he,matte:ye}}})}continue}const f=zOf(s),C=re.get(e)??0;K[C]?.layers.push({component:s.component,start:xe(m.start+l),end:xe(m.start+Math.max(l,k))});const O=document.createElement("div");O.className="ak-layer",O.dataset.component=s.component,Object.assign(O.style,{position:"absolute",inset:"0"}),ke(O,!1),ue.set(e,O);const T=s.times?resolveTimes(s.props,s.times,M):s.props,Y=V.slice(),me=new Map,Me=t.contexts({dur:g,words:()=>ve,at:M,start:l,end:k,combo:Ae,reads:{...Oe,texts:G=>t.texts({part:m,el:$},Y,G)},record:(G,Z)=>se.reads.set(G,Z),place:{start:m.start,part:o.key},answers:me});V.push({spec:s,index:e,props:T,el:O,ctx:Me,start:l,end:k,z:f,plane:C,answers:me})}let F=$,L;if(K.some(e=>e.overlay===!0)){F=document.createElement("div"),L=document.createElement("div"),F.className="ak-picture",L.className="ak-overlays";for(const e of[F,L])Object.assign(e.style,{position:"absolute",inset:"0",overflow:"hidden"}),$.append(e)}pe.forEach((e,s)=>{const l=Q.get(e)??ue.get(e);l&&(L&&oe.overlaid(e)?L:F).append(l);const k=re.get(e),f=pe[s+1];R&&k!==void 0&&K[k]?.behindPerson===!0&&(f===void 0||re.get(f)!==k)&&F.append(R)}),j.sfx(o,m,M),N&&j.carry(N.inner,N.from,N.to,m.start,m.key,0);for(const e of V){const s=c.shownBy.get(e.spec);s&&(s.shown.start=m.start+e.start,s.shown.partStart=m.start,s.shown.from=s.from,s.shown.to=s.from+(e.end-e.start)*s.speed,s.shown.speed=s.speed,s.audio!==void 0&&s.speed===1&&j.carry(s.inner,s.from,s.shown.to,m.start+e.start,m.key,s.audio))}K.forEach((e,s)=>{const l=e.layers.filter(f=>f.end>f.start),k=y.placed.flatMap(f=>{if(f.part!==m.key||(f.over??0)<=s)return[];if(!l.some(O=>O.end>f.start&&O.start<f.end))return[];let C;for(const O of f.boxes?f.boxes.map(T=>T.box):[f.box]){const T=ze(O,[0,0,i.width,i.height]),Y=T?ae(T[2]*T[3]/(i.width*i.height)):0;(!C||Y>C.frame)&&(C={box:O,frame:Y})}return C?[{file:f.file,start:f.start,end:f.end,...C}]:[]});k.length!==0&&E.facts.push(ge("graphics-under-footage",{piece:S.piece,part:o.key,t:m.start},{layers:l,footage:k,covered:Math.max(...k.map(f=>f.frame))}))}),oe.hasBehind&&ne<0&&E.facts.push(ge("fallback",{piece:S.piece,part:o.key},{missing:"own-footage",for:"behind-person",fallback:"in-front"})),I.push({part:m,spec:o,n:w,el:$,picture:F,...L?{overlays:L}:{},layers:V,record:se})}return{parts:H,mounted:I,clips:a}}

package/dist/node_modules/@allyhub-next/runtime/dist/footage.d.ts

@@ -0,0 +1,52 @@
+import { type FaceOnFrame, type FootageLayer, type IndexNeed, type Part, type PixelRect, type TimelineFootage } from "@allyhub-next/video-core";
+import type { CaptionTrack } from "./captions.js";
+import type { Env } from "./env.js";
+import type { ResolvedPiece } from "./piece.js";
+import type { ResolvedSpeech } from "./speech.js";
+/** A footage layer as planned: the timeline's entry and what the player needs to draw it. */
+export interface FootagePlan extends TimelineFootage {
+    /** Where the stage loads the video. */
+    url: string;
+    /** The video's length, seconds, if known. */
+    duration?: number;
+    /** The video's pixels, if known. */
+    source?: {
+        width: number;
+        height: number;
+    };
+    /** Where the stage loads the background's image. */
+    imageUrl?: string;
+    /** The file's person matte, when the player draws the person cut out (over graphics behind them, or over a treated background). */
+    matteUrl?: string;
+    /** The person is drawn over the part's graphics behind them, not over the layer's own background. */
+    personOver?: boolean;
+}
+export interface FootageLayerPlace {
+    /** A word reference of the part, in seconds from its start. */
+    at: (ref: unknown) => number;
+    /** The part's own take, whose speaker is drawn again over the behind-person graphics. */
+    cutout: boolean;
+    /** How many of the part's graphics planes are under it. */
+    over: number;
+    /** The player draws the speaker cut out over the behind-person graphics. */
+    person: boolean;
+}
+export interface FootagePlanner {
+    /** Plans a footage layer of a part; undefined, with its problem, when it shows nothing. */
+    plan(l: FootageLayer, part: Part, sp: ResolvedSpeech | undefined, speechAt: number | undefined, start: number, end: number, more: FootageLayerPlace): FootagePlan | undefined;
+    /** Every footage layer planned, in film order. */
+    readonly placed: readonly FootagePlan[];
+    /** What the media index lacks for this output (Timeline.index). */
+    needs(): IndexNeed[];
+    /** Whether a part shows footage whose speaker moves: a face track or a person matte. */
+    speakerIn(partKey: string): boolean;
+    /** A face on the frame at film time t, from the topmost footage showing then: face `id`, by default that layer's speaker. */
+    faceAt(partKey: string, t: number, id?: number): PixelRect | undefined;
+    /** Every face on the frame at film time t, from the topmost footage showing then with any. */
+    facesAt(partKey: string, t: number): FaceOnFrame[];
+}
+/** The footage planner; `cssColor` resolves a colour as the stage draws it. */
+export declare function footagePlanner(env: Env, piece: ResolvedPiece, captions: CaptionTrack, cssColor: (color: string) => string): FootagePlanner;
+/** The footage plan as the timeline holds it: without what only the player reads. */
+export declare function timelineFootage(p: FootagePlan): TimelineFootage;
+//# sourceMappingURL=footage.d.ts.map