allyhub 0.4.0 → 0.6.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.6.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.6.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/exports.d.ts

@@ -0,0 +1,67 @@
+import { type CaptionCueOptions, type Part, type Timeline } from "@allyhub-next/video-core";
+import type { ExportPage, ProjectMedia, RenderTarget, VideoLook } from "./page.js";
+import type { Tools } from "./tools.js";
+export interface ExportOptions extends Tools {
+    /** A page holding the output, drawing its graphics plane; the caller opens and closes it. */
+    page: ExportPage;
+    target: RenderTarget;
+    look: VideoLook;
+    media: ProjectMedia;
+    out: string;
+    /** A deck's pages: a PDF page, a PNG or a slide per step, not only each page's last; default false. */
+    steps?: boolean;
+}
+/** A moment an export draws: a part's (or a step's) still. */
+interface Still {
+    part: Part;
+    at: number;
+    /** Its title: the part's, numbered by step when it has several. */
+    title: string;
+}
+/**
+ * The stills a deck's (or a video's handout's) pages are: every part's
+ * still in order, a deck's hidden pages left out; with `steps`, each step's.
+ */
+export declare function stillsOf(timeline: Timeline, steps?: boolean): Still[];
+export interface ExportResult {
+    out: string;
+    /** Pages for pdf / pptx / png, cues for subtitles, 1 for a cover. */
+    units: number;
+    bytes: number;
+    /** Every file written, when there are several (one PNG per page). */
+    files?: string[];
+}
+/** SRT or WebVTT from what each part says, timed by its words. */
+export declare function renderCaptions(opts: ExportOptions & {
+    type: "srt" | "vtt";
+    /**
+     * How cues are cut and timed, over what the piece asks; without them
+     * the piece's own captions' options (subtitleCues).
+     */
+    captions?: CaptionCueOptions;
+}): Promise<ExportResult>;
+/** The cover as JPEG: the output's first cover, else the first part's still. */
+export declare function renderCover(opts: ExportOptions): Promise<ExportResult>;
+/**
+ * One PDF page per part (a video's handout) or slide (a deck), each
+ * at its still; the text stays text. The page is the output's paper: the
+ * frame's pixels, or A4 and Letter at their real size with the frame
+ * scaled onto it. A page without headings of its own starts with an
+ * invisible heading, its title, so the PDF's outline lists every page
+ * (tagged PDF, outline on).
+ */
+export declare function renderPdf(opts: ExportOptions): Promise<ExportResult>;
+/**
+ * Each page's still as PNG. One page: the file asked for; more: one file
+ * per page next to it, numbered from 1 (`<name>.01.png`, `<name>.02.png`…),
+ * so they sort in order.
+ */
+export declare function renderPng(opts: ExportOptions): Promise<ExportResult>;
+/**
+ * One slide per part or page (per step with `steps`), each the still as a
+ * full-bleed picture; the speaker notes are a page's notes, else what a
+ * part says, else the text it shows.
+ */
+export declare function renderPptx(opts: ExportOptions): Promise<ExportResult>;
+export {};
+//# sourceMappingURL=exports.d.ts.map

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

@@ -0,0 +1,3 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{writeFile as b}from"node:fs/promises";import{createRequire as k}from"node:module";import{captionCues as $,paperOf as j,subtitleCues as L,toSrt as v,toVtt as C}from"@allyhub-next/video-core";import{RenderError as O}from"./errors.js";import{backgroundStill as P,finalStill as p,footageStill as E}from"./stills.js";export function stillsOf(t,e=!1){const i=[];for(const[o,n]of t.parts.entries()){if(n.hidden===!0)continue;const a=n.title??String(o+1),r=e&&n.steps!==void 0?n.steps:[n.still];r.forEach((c,s)=>{i.push({part:n,at:c,title:r.length>1?`${a} (${String(s+1)})`:a})})}return i}async function g(t,e,i){return await b(t,e),{out:t,units:i,bytes:e.byteLength}}const u=t=>({target:t.target,look:t.look,media:t.media,...t.ffmpeg===void 0?{}:{ffmpeg:t.ffmpeg},...t.ffprobe===void 0?{}:{ffprobe:t.ffprobe}});export async function renderCaptions(t){const{timeline:e}=t.page,i=await t.page.lines();if(i.length===0)throw new O("no-speech",`${t.target.output} of ${t.target.piece} (${t.target.combo.lang??"this combo"}) says nothing with word times, so there are no subtitles to export.`,{hint:'Give parts speech: speech: take("./take.mp4") with its .words.json beside it, or say(s("…")) and allyhub voice.'});const o={lines:i,fps:e.fps},n=t.captions?$(o,t.captions):L(o,await t.page.captionOptions()),a=t.type==="srt"?v(n):C(n);return g(t.out,new TextEncoder().encode(a),n.length)}export async function renderCover(t){const{page:e}=t,i=await e.covers()>0?await P(e.timeline,await e.cover(0),"jpeg",t):await p(e,e.timeline.parts[0]?.still??0,{...u(t),format:"jpeg"});return g(t.out,i,1)}export async function renderPdf(t){const{timeline:e}=t.page,i=e.background,o=[];for(const a of stillsOf(e,t.steps)){const r=await E(t.media,e,a.at,"jpeg",t);o.push({still:a.at,title:a.title,background:r?`url(data:image/jpeg;base64,${r.toString("base64")}) 0 0 / 100% 100% no-repeat`:i})}const n=await t.page.print(o,e.paper??j(t.target.format));return g(t.out,n,o.length)}export async function renderPng(t){const e=stillsOf(t.page.timeline,t.steps),i=Math.max(2,String(e.length).length),o=t.out.replace(/\.png$/i,""),n=[];let a=0;for(const[r,c]of e.entries()){const s=e.length===1?t.out:`${o}.${String(r+1).padStart(i,"0")}.png`,l=await p(t.page,c.at,u(t));await b(s,l),n.push(s),a+=l.byteLength}return{out:n[0]??t.out,units:n.length,bytes:a,files:n}}const N=k(import.meta.url)("pptxgenjs");export async function renderPptx(t){const{timeline:e}=t.page,{width:i,height:o}=e,n=/^([\d.]+)in ([\d.]+)in$/u.exec(e.paper??""),a=13.333/Math.max(i,o),r=n?Number(n[1]):i*a,c=n?Number(n[2]):o*a,s=new N;s.defineLayout({name:"ALLYHUB",width:r,height:c}),s.layout="ALLYHUB";const l=await t.page.text(),d=stillsOf(e,t.steps);for(const m of d){const x=await p(t.page,m.at,u(t)),h=s.addSlide();h.addImage({data:`image/png;base64,${x.toString("base64")}`,x:0,y:0,w:r,h:c});const f=l.find(S=>S.key===m.part.key),w=f?.notes??f?.spoken??f?.onScreen.join(`
+`)??"";w&&h.addNotes(w)}const y=await s.write({outputType:"nodebuffer"});return g(t.out,y,d.length)}

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";