allyhub 0.7.0 → 0.8.0

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

@@ -0,0 +1,477 @@
+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<{
+        failed: "failed";
+        running: "running";
+        off: "off";
+        waiting: "waiting";
+        done: "done";
+    }>;
+    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<{
+        failed: "failed";
+        running: "running";
+        done: "done";
+        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<{
+        failed: "failed";
+        running: "running";
+        done: "done";
+    }>;
+    message: z.ZodString;
+    share: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type IndexJob = z.infer<typeof IndexJobSchema>;
+/** Most components `components/stills` draws in one call. */
+export declare const COMPONENT_STILLS_MAX = 64;
+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>>;
+        name: z.ZodString;
+        scope: 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>;
+        code: z.ZodUnknown;
+        data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        theme: z.ZodObject<{
+            name: z.ZodString;
+            colors: z.ZodRecord<z.ZodString, z.ZodString>;
+            fonts: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    readonly "doc/data": MethodSpec<z.ZodObject<{
+        item: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, 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>;
+        mode: z.ZodOptional<z.ZodEnum<{
+            code: "code";
+        }>>;
+        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 "slides/fonts": MethodSpec<z.ZodObject<{
+        item: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        faces: z.ZodArray<z.ZodObject<{
+            family: z.ZodString;
+            url: z.ZodURL;
+            weight: z.ZodOptional<z.ZodString>;
+            style: z.ZodOptional<z.ZodString>;
+            stretch: z.ZodOptional<z.ZodString>;
+            unicodeRange: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    readonly "components/list": MethodSpec<z.ZodObject<{
+        item: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        components: z.ZodArray<z.ZodObject<{
+            of: z.ZodString;
+            name: z.ZodString;
+            label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    readonly "components/stage": MethodSpec<z.ZodObject<{
+        item: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        url: z.ZodString;
+        probe: z.ZodString;
+    }, z.core.$strict>>;
+    readonly "components/stills": MethodSpec<z.ZodObject<{
+        components: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            t: z.ZodNumber;
+        }, z.core.$strict>>;
+        item: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        stills: z.ZodArray<z.ZodNullable<z.ZodObject<{
+            key: z.ZodString;
+            url: z.ZodURL;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    readonly "check/results": MethodSpec<z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
+        status: z.ZodEnum<{
+            failed: "failed";
+            running: "running";
+            off: "off";
+            waiting: "waiting";
+            done: "done";
+        }>;
+        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<{
+                failed: "failed";
+                running: "running";
+                done: "done";
+                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<{
+                failed: "failed";
+                running: "running";
+                done: "done";
+                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;
+/**
+ * Where each project tool is answered when no machine runs (sources.ts):
+ * from the project's snapshot, as nothing (what a render draws each time,
+ * never recorded), or by the machine, which a host reading a snapshot asks
+ * the window to wake.
+ */
+export declare const PROJECT_TOOL_SOURCES: {
+    readonly "project/items": "project";
+    readonly "sheet/generated": "project";
+    readonly "video/versions": "project";
+    readonly "slides/deck": "project";
+    readonly "doc/data": "project";
+    readonly "video/stage": "project";
+    readonly "video/timeline": "asleep";
+    readonly "video/still": "asleep";
+    readonly "video/stills": "asleep";
+    readonly "slides/fonts": "project";
+    readonly "components/list": "asleep";
+    readonly "components/stage": "asleep";
+    readonly "components/stills": "project";
+    readonly "check/results": "project";
+    readonly "check/run": "machine";
+    readonly "export/start": "machine";
+    readonly "export/cancel": "machine";
+    readonly "export/list": "asleep";
+    readonly "export/reveal": "machine";
+    readonly "scenery/viewer": "project";
+};
+/**
+ * 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<{
+            failed: "failed";
+            running: "running";
+            off: "off";
+            waiting: "waiting";
+            done: "done";
+        }>;
+        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<{
+                failed: "failed";
+                running: "running";
+                done: "done";
+                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<{
+                failed: "failed";
+                running: "running";
+                done: "done";
+            }>;
+            message: z.ZodString;
+            share: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+};
+//# sourceMappingURL=tools.d.ts.map

package/dist/node_modules/@allyhub/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/formats";import{PathSchema as s}from"./files.js";import{method as t,notification as r}from"./jsonrpc.js";const n={item:s,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:s,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(s),error:e.string().optional()}),IndexJobSchema=e.strictObject({file:s,status:e.enum(["running","done","failed"]),message:e.string(),share:e.number().min(0).max(1).optional()});const a=e.tuple([e.number(),e.number(),e.number()]),o=e.strictObject({url:e.string(),probe:e.string()});export const COMPONENT_STILLS_MAX=64,PROJECT_TOOLS={"project/items":t(e.strictObject({}),e.strictObject({items:e.array(e.strictObject({kind:e.enum(c),dir:s,entry:s,title:e.string().optional()})),name:e.string(),scope:e.string(),revision:e.int().nonnegative()}),"The project's items, as the build finds them."),"sheet/generated":t(e.strictObject({item:s}),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:s}),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:s}),e.strictObject({piece:e.string(),file:s,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(),s),code:e.unknown(),data:e.record(e.string(),e.unknown()).optional(),theme:e.strictObject({name:e.string(),colors:e.record(e.string(),e.string()),fonts:e.record(e.string(),e.string())})}),"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."),"doc/data":t(e.strictObject({item:s}),e.strictObject({data:e.record(e.string(),e.unknown())}),"The numbers a doc's charts read from the project's files (a sheet's table, a CSV, a data file of rows): what its editor draws them with."),"video/stage":t(e.strictObject({...n,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(),mode:e.enum(["code"]).optional()}),o,"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(n),e.strictObject({timeline:TimelineSchema,text:e.array(e.unknown())}),"A version's timeline, drawn nowhere."),"video/still":t(e.strictObject({...n,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({...n,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."),"slides/fonts":t(e.strictObject({item:s}),e.strictObject({faces:e.array(e.strictObject({family:e.string(),url:e.url(),weight:e.string().optional(),style:e.string().optional(),stretch:e.string().optional(),unicodeRange:e.string().optional()}))}),"The font faces a deck's slides draw with: the stage's own (the theme's standard fonts), allyhub.config.ts's fonts and what the deck's code imports, for a document that draws its slides without the project's stylesheets."),"components/list":t(e.strictObject({item:s}),e.strictObject({components:e.array(e.strictObject({of:e.string(),name:e.string(),label:e.union([e.string(),e.record(e.string(),e.string())]).optional()}))}),"The components an item may place: every one the project's files define, by the reference it would write."),"components/stage":t(e.strictObject(n),o,"The address of a page that draws an item's components one at a time, for a sandboxed frame (docs/design/components-everywhere.md): a deck's by the name slides.ts gives it, a doc's by the reference its block writes. Its parent posts `{ type: \"component\", name, props, width, height, t }` and hears `component-ready`, or `error` with what went wrong."),"components/stills":t(e.strictObject({...n,components:e.array(e.strictObject({name:e.string(),props:e.record(e.string(),e.unknown()),width:e.number().positive(),height:e.number().positive(),t:e.number().nonnegative()})).min(1).max(COMPONENT_STILLS_MAX)}),e.strictObject({stills:e.array(e.strictObject({key:e.string(),url:e.url()}).nullable())}),"An item's components (a deck's, a doc's) drawn alone, transparent, as the render draws them: pictures kept by what they show, given as addresses."),"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:s,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:s}),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:s,camera:e.strictObject({position:a,target:a}).optional()}),o,"The address of a scenery's viewer page, for a sandboxed frame: it tells what the person does by postMessage.")},PROJECT_TOOL_SOURCES={"project/items":"project","sheet/generated":"project","video/versions":"project","slides/deck":"project","doc/data":"project","video/stage":"project","video/timeline":"asleep","video/still":"asleep","video/stills":"asleep","slides/fonts":"project","components/list":"asleep","components/stage":"asleep","components/stills":"project","check/results":"project","check/run":"machine","export/start":"machine","export/cancel":"machine","export/list":"asleep","export/reveal":"machine","scenery/viewer":"project"},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"},"doc/data":{files:"the files the doc's charts name in data"},"video/stage":{command:"frames"},"video/timeline":{command:"inspect timeline"},"video/still":{command:"frames"},"video/stills":{command:"frames"},"slides/fonts":{files:"allyhub.config.ts's fonts and the stylesheets slides.ts imports"},"components/list":{files:"the project's components (defineComponent)"},"components/stage":{command:"frames"},"components/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(i){return Object.hasOwn(PROJECT_TOOLS,i)?PROJECT_TOOLS[i]:void 0}export const TOOL_NOTIFICATIONS={"project/changed":r(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":r(CheckStateSchema,"The check started, ended or failed."),"export/changed":r(e.strictObject({job:ExportJobSchema}),"An export moved on."),"index/changed":r(e.strictObject({jobs:e.array(IndexJobSchema)}),"Making what the media index lacks moved on.")};

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

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

package/dist/node_modules/@allyhub/registry/dist/polyhaven-client.js

@@ -0,0 +1,3 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{createHash as _}from"node:crypto";import{mkdir as C,readFile as $,rename as R,stat as T,writeFile as F}from"node:fs/promises";import{dirname as x,join as w,relative as L,resolve as S,sep as j}from"node:path";import{ENVIRONMENTS_DIR as J,GenFileSchema as M,MODELS_DIR as U,TEXTURES_DIR as V,genFileFor as Y}from"@allyhub/formats";import{ASSET_TYPES as v,Catalog as N,CatalogEntry as G,Listing as W,PlanError as B,POLYHAVEN_API as K,POLYHAVEN_LICENSE as X,assetPage as q,choicesOf as z,planAsset as Q,searchCatalog as Z}from"./polyhaven.js";export class PolyHavenError extends Error{code;hint;constructor(t,a,s){super(a),this.name="PolyHavenError",this.code=t,this.hint=s}}const g="Check the connection and run the same command again: files already fetched and checked are kept.",tt=3600*1e3,u=(r,t)=>_(r).update(t).digest("hex");async function E(r,t){await C(x(r),{recursive:!0}),await F(`${r}.part`,t),await R(`${r}.part`,r)}export const assetFolder=r=>r==="model"?U:r==="hdri"?J:V;export class PolyHaven{api;userAgent;cacheDir;constructor(t){this.api=t.api??K,this.userAgent=t.userAgent,this.cacheDir=t.cacheDir}async get(t){try{return await fetch(t,{headers:{"User-Agent":this.userAgent}})}catch(a){throw new PolyHavenError("network",`Cannot reach ${t}: ${a.message}`,g)}}async json(t,a){const s=await this.get(t);if(s.status===404)throw new PolyHavenError("not-found",`Poly Haven has no ${a}.`,"An asset is named by its id, the end of its address on polyhaven.com.");if(!s.ok)throw new PolyHavenError("network",`${t} answered ${String(s.status)}.`,g);return s.json()}async catalog(t){const a=w(this.cacheDir,`${u("sha256",this.api).slice(0,12)}-${t}.json`),s=await T(a).then(c=>Date.now()-c.mtimeMs,()=>1/0),n=async()=>N.parse(JSON.parse(await $(a,"utf8")));if(s<tt)return n();try{const c=N.parse(await this.json(`${this.api}/assets?t=${v[t].api}`,`${t} catalog`));return await E(a,JSON.stringify(c)),c}catch(c){if(s<1/0)return n();throw c}}async search(t,a){const s=[];let n=0;for(const c of a){const i=await this.catalog(c);n+=Object.keys(i).length,s.push(...Z(i,t))}return{found:s,total:n}}async add(t,a){const s=G.parse(await this.json(`${this.api}/info/${encodeURIComponent(t)}`,`asset ${t}`)),n=Object.keys(v).find(e=>v[e].code===s.type);if(!n)throw new PolyHavenError("bad-listing",`Poly Haven lists ${t} as a kind AllyHub does not fetch (${String(s.type)}).`);const c=W.parse(await this.json(`${this.api}/files/${encodeURIComponent(t)}`,`file list for ${t}`));let i;try{i=Q(t,n,c,{...a.resolution===void 0?{}:{resolution:a.resolution},...a.format===void 0?{}:{format:a.format},...a.maps===void 0?{}:{maps:a.maps}})}catch(e){if(!(e instanceof B))throw e;const o=z(n,c);throw new PolyHavenError("bad-choice",e.message,o.resolutions.length>0?`${t} (${n}) has resolutions ${o.resolutions.join(", ")}; formats ${o.formats.join(", ")}${o.maps?`; maps ${o.maps.join(", ")}`:""}.`:void 0)}const H=S(a.root),d=S(H,a.to??w(assetFolder(n),t)),m=e=>L(H,e).split(j).join("/"),I=e=>{const o=S(d,e);if(!o.startsWith(d+j))throw new PolyHavenError("bad-listing",`Poly Haven's listing names a file outside the asset's folder: ${e}.`);return o},p=[];let b=0;for(const e of i.files){const o=I(e.path),l=await $(o).catch(()=>{});let h;if(l&&u("md5",l)===e.md5)h=l;else{const f=await this.get(e.url);if(!f.ok)throw new PolyHavenError("network",`Downloading ${e.url} answered ${String(f.status)}.`,g);if(h=new Uint8Array(await f.arrayBuffer()),u("md5",h)!==e.md5)throw new PolyHavenError("network",`${e.url} is not the file Poly Haven lists (its md5 differs; ${String(h.length)} bytes, listed ${String(e.bytes)}).`,g);await E(o,h),b++}p.push({path:m(o),bytes:h.length,sha256:u("sha256",h)})}const O={id:t,type:n,resolution:i.resolution,format:i.format,...i.maps?{maps:i.maps}:{}},P=u("sha256",JSON.stringify({tool:"polyhaven",input:O})),k={library:"Poly Haven",page:q(t),authors:Object.keys(s.authors),license:X},A=[];for(const e of i.main){const o=w(d,e),l=p.find(y=>y.path===m(o));if(!l)continue;const h=Y(o);A.push(m(h));const f=M.safeParse(await $(h,"utf8").then(y=>JSON.parse(y)).catch(()=>{}));if(f.success&&f.data.sha256===l.sha256&&f.data.inputHash===P)continue;const D={version:1,ai:!1,tool:"polyhaven",input:O,inputHash:P,output:{name:s.name,...s.files_hash?{filesHash:s.files_hash}:{},...n==="model"?{files:p}:{}},at:new Date().toISOString(),sha256:l.sha256,bytes:l.bytes,source:k};await E(h,`${JSON.stringify(D,null,2)}
+`)}return{id:t,name:s.name,type:n,dir:m(d),main:i.main.map(e=>m(w(d,e))),files:p,fetched:b,records:A,source:k,...i.maps?{maps:i.maps}:{},...n==="texture"&&s.dimensions?{covers:s.dimensions.map(e=>Math.round(e)/1e3)}:{}}}}

package/dist/node_modules/@allyhub/registry/dist/registry.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{createHash as O}from"node:crypto";import{lstat as T,mkdir as b,readFile as p,rename as v,symlink as B,writeFile as A}from"node:fs/promises";import{dirname as g,isAbsolute as W,join as w,relative as $,resolve as x,sep as S}from"node:path";import{BAKE_DIR as C,PACKAGE_FILE as D}from"@allyhub/formats";import{RegistryIndexSchema as E,RegistryItemSchema as I}from"@allyhub/protocol";import{z as R}from"zod";export class RegistryError extends Error{code;hint;constructor(o,i,s={}){super(i,s.cause===void 0?void 0:{cause:s.cause}),this.name="RegistryError",this.code=o,this.hint=s.hint}}export const itemFile=e=>`r/${e}.json`;async function M(e,o,i){let s;try{s=await p(e,"utf8")}catch(n){throw new RegistryError("no-registry",`There is no ${i} at ${e}.`,{cause:n})}let t;try{t=JSON.parse(s)}catch(n){throw new RegistryError("bad-registry",`${e} is not JSON.`,{cause:n})}const c=o.safeParse(t);if(!c.success)throw new RegistryError("bad-registry",`${e} is not a ${i}: ${R.prettifyError(c.error)}`);return c.data}export function folderRegistry(e){let o;const i=s=>{const t=x(e,s);if($(e,t).startsWith("..")||W($(e,t)))throw new RegistryError("bad-registry",`The registry names a file outside it: ${s}.`);return t};return{name:e,index:()=>o??=M(w(e,"registry.json"),E,"registry index"),async item(s){if((await this.index()).items.some(c=>c.name===s))return M(w(e,itemFile(s)),I,"registry item")},async file(s){return new Uint8Array(await p(i(s)))}}}export function urlRegistry(e,o=fetch){const i=e.endsWith("/")?e:`${e}/`;let s;const t=async n=>{let d;try{d=await o(new URL(n,i))}catch(f){throw new RegistryError("no-registry",`${i}${n} could not be read.`,{cause:f,hint:"Check the connection and run the same command again."})}if(!d.ok)throw new RegistryError("no-registry",`${i}${n} answered ${String(d.status)}.`);return d},c=async(n,d,f)=>{const u=d.safeParse(await(await t(n)).json());if(!u.success)throw new RegistryError("bad-registry",`${i}${n} is not a ${f}: ${R.prettifyError(u.error)}`);return u.data};return{name:i,index:()=>s??=c("registry.json",E,"registry index"),async item(n){if((await this.index()).items.some(f=>f.name===n))return c(itemFile(n),I,"registry item")},async file(n){return new Uint8Array(await(await t(n)).arrayBuffer())}}}export const registryAt=e=>/^https?:\/\//u.test(e)?urlRegistry(e):folderRegistry(e),sha256=e=>O("sha256").update(e).digest("hex");const F=e=>{const o=e.indexOf("@",e.startsWith("@")?1:0);return o<0?e:e.slice(0,o)};export async function planAdd(e,o,i){const s=[],t=new Set,c=async(r,a)=>{if(t.has(r))return;t.add(r);const l=await e.item(r);if(!l)throw new RegistryError("no-item",a===void 0?`The registry has no ${r}.`:`${a} needs ${r}, which the registry does not have.`,{hint:`It has ${(await e.index()).items.map(h=>h.name).join(", ")}.`});for(const h of l.registryDependencies)await c(h,r);s.push(l)};for(const r of o)await c(r);const n=x(i.root),d=[];for(const r of s)for(const a of r.files){const l=a.target.replaceAll("{dir}",i.dir).replaceAll("\\","/"),h=x(n,l);if(!h.startsWith(n+S))throw new RegistryError("outside",`${r.name}'s file ${a.path} would go outside the project (${l}).`);const m=a.content===void 0?await e.file(a.path):new TextEncoder().encode(a.content);if(sha256(m)!==a.sha256)throw new RegistryError("bad-file",`${r.name}'s file ${a.path} is not the one the registry lists (its sha256 differs).`);const j=await p(h).catch(()=>{}),N=j===void 0?"added":sha256(j)===a.sha256?"up to date":i.force?"replaced":"differs";d.push({item:r.name,path:$(n,h).split(S).join("/"),bytes:m,status:N})}let f=new Set;try{const r=JSON.parse(await p(w(n,D),"utf8"));f=new Set(["dependencies","devDependencies","peerDependencies"].flatMap(a=>Object.keys(r[a]??{})))}catch{}const u=[...new Set(s.flatMap(r=>r.dependencies.map(F)))].filter(r=>!f.has(r)&&r!=="@allyhub/sdk"),y=new Map;for(const r of s.flatMap(a=>a.assets)){const a=y.get(r.id);if(!a){y.set(r.id,r);continue}const l=[a.resolution,r.resolution].filter(h=>h!==void 0).sort((h,m)=>Number.parseInt(m,10)-Number.parseInt(h,10))[0];y.set(r.id,{source:a.source,id:a.id,...l===void 0?{}:{resolution:l},...a.maps&&r.maps?{maps:[...new Set([...a.maps,...r.maps])]}:{}})}const k=new Map;for(const r of s.flatMap(a=>a.bakes))k.set(`${r.digest}.${r.renderer}`,r);return{items:s,files:d,missing:u,assets:[...y.values()],bakes:[...k.values()]}}export const bakePath=e=>`${C}/${e.digest}.${e.renderer}.bin`;export async function fetchBakes(e,o,i=fetch){const s=[];for(const t of o){const c=bakePath(t),n=w(e,c),d=await p(n).catch(()=>{});if(d&&sha256(d)===t.sha256){s.push({bake:t,path:c,status:"up to date"});continue}let f;try{const u=await i(t.url);if(!u.ok)throw new Error(`${t.url} answered ${String(u.status)}`);f=new Uint8Array(await u.arrayBuffer())}catch(u){throw new RegistryError("no-registry",`The baked light for ${t.scenery} could not be downloaded.`,{cause:u,hint:"Check the connection and run the same command again; without it the scenery is drawn unbaked until allyhub scenery bake makes one."})}if(sha256(f)!==t.sha256)throw new RegistryError("bad-file",`The baked light for ${t.scenery} is not the one the registry lists (its sha256 differs).`);await b(g(n),{recursive:!0}),await A(`${n}.part`,f),await v(`${n}.part`,n),s.push({bake:t,path:c,status:"added"})}return s}export async function applyAdd(e,o){const i=o.files.filter(s=>s.status==="differs");if(i.length>0)throw new RegistryError("conflict",`${i.map(s=>s.path).join(", ")} ${i.length===1?"differs":"differ"} from the registry's: the project's copy has changes.`,{hint:"Keep the project's copy, or replace it with the registry's with --force (its changes are lost)."});for(const s of o.files){if(s.status==="up to date")continue;const t=w(e,s.path);await b(g(t),{recursive:!0}),await A(`${t}.part`,s.bytes),await v(`${t}.part`,t)}for(const s of o.items.filter(t=>t.type==="allyhub:skill")){const t=w(e,".claude","skills",s.name);await T(t).catch(()=>{})||(await b(g(t),{recursive:!0}),await B($(g(t),w(e,".agents","skills",s.name)),t))}}export function searchIndex(e,o){const i=t=>t.toLowerCase().split(/[^\p{L}\p{N}]+/u).filter(Boolean),s=i(o);return e.items.filter(t=>{const c=i([t.name,t.title,t.description,...t.categories].join(" "));return s.every(n=>c.some(d=>d.startsWith(n)))})}

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

@@ -0,0 +1,13 @@
+{
+  "name": "@allyhub/registry",
+  "version": "0.8.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/render/dist/composite.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readFile as G,stat as N}from"node:fs/promises";import{join as b}from"node:path";import{fpsRational as x,indexPath as M}from"@allyhub/video-core";import{PNG as w}from"pngjs";import{captureGraph as q,capturesAnything as j}from"./capture.js";import{footagePlane as z,layersIn as B,probeSource as E}from"./footage.js";import{rgbaPng as F}from"./png.js";import{postGraph as P}from"./post.js";import{runFfmpegWith as I,write as T}from"./tools.js";const O=new Map;export function transparentPng(t,a){const n=`${String(t)}x${String(a)}`;let r=O.get(n);if(!r){const e=new w({width:t,height:a});e.data.fill(0),r=w.sync.write(e,{deflateLevel:9}),O.set(n,r)}return r}export function partAt(t,a){return t.parts.find(n=>a>=n.start&&a<n.end)??t.parts.at(-1)}export async function planSources(t,a,n){const r=new Map;for(const e of a.footage??[]){const p=e.background?.image;if(p!==void 0&&!r.has(p)){const h=t.path(p);h&&r.set(p,{path:h,info:{alpha:!1}})}const o=e.cutout===!0||e.background!==void 0,i=r.get(e.file);if(i){o&&!i.matte&&Object.assign(i,await k(t,e.file));continue}const u=t.path(e.file);if(!u)continue;const c=t.media[e.file];r.set(e.file,{path:u,info:await E(u,n),...c?.duration===void 0?{}:{duration:c.duration},...c?.width!==void 0&&c.height!==void 0?{width:c.width,height:c.height}:{},...o?await k(t,e.file):{}})}return r}async function k(t,a){const n=t.media[a]?.sha256;if(!n)return{};const r=t.root,e=b(r,M(n,"matte.mp4"));if(!(await N(e).catch(()=>{}))?.isFile())return{};let p={};try{p=JSON.parse(await G(b(r,M(n,"matte.json")),"utf8"))}catch{}const{width:o,height:i}=p;return{matte:e,...typeof o=="number"&&typeof i=="number"&&o>0&&i>0?{matteSize:{width:o,height:i}}:{}}}export const partPost=t=>t?.post?.filter;export function filterPath(t){return t.includes("'")?void 0:`'${t}'`}export function finishGraph(t,a,n,r=[]){let e=a;if(j(n.capture)&&n.capture){const i=q(n.capture,{input:e,first:n.first,frames:n.frames,fps:n.timeline.fps,rate:x(n.timeline.fps).text,size:[n.timeline.width,n.timeline.height],alpha:n.alpha});t.push(...i.filters),e=i.out}n.post&&(e=P(t,e,n.post,{first:n.first,fps:n.timeline.fps,alpha:n.alpha,prefix:"vpost"}));const p=[];if(n.lut){const i=filterPath(n.lut);i&&p.push(`lut3d=file=${i}`)}if(r.length>0){p.length>0&&(t.push(`[${e}]${p.join(",")}[fin]`),e="fin"),r.forEach((i,u)=>{const c=`fov${String(u)}`;t.push(`[${e}][${i}]overlay=format=auto[${c}]`),e=c}),t.push(`[${e}]${n.tail.length?n.tail.join(","):"null"}[v]`);return}const o=[...p,...n.tail];t.push(`[${e}]${o.length?o.join(","):"null"}[v]`)}export const imagesOf=(t,a,n)=>n?.includes(t)?1:a;export function compositeArgs(t){const a=x(t.timeline.fps),n=t.planes.length>0,r=[],e=[],p=t.planes.filter(l=>t.overlays?.includes(l));if(n){const l=[],s=t.samples;s>1&&l.push("format=gbrap","premultiply=inplace=1",`tmix=frames=${String(s)}`,`select='eq(mod(n,${String(s)}),${String(s-1)})'`,`setpts=N*${String(a.den)}/(${String(a.num)}*TB)`,"unpremultiply=inplace=1");const f=m=>`gp${String(m)}`,[g]=t.planes;if(t.planes.length===1&&g!==void 0){const m=p.includes(g)?[]:l;r.push(`[0:v]${m.length?m.join(","):"null"}[${f(g)}]`),e[g]=f(g)}else{const m=t.planes.map(d=>imagesOf(d,s,t.overlays)),S=m.reduce((d,$)=>d+$,0);r.push(`[0:v]split=${String(t.planes.length)}${t.planes.map((d,$)=>`[gi${String($)}]`).join("")}`);let y=0;t.planes.forEach((d,$)=>{const v=m[$]??s,_=`setpts=N*${String(a.den)}/(${String(a.num*v)}*TB)`,A=p.includes(d)?[]:l;r.push(`[gi${String($)}]select='gte(mod(n,${String(S)}),${String(y)})*lt(mod(n,${String(S)}),${String(y+v)})',${[_,...A].join(",")}[${f(d)}]`),e[d]=f(d),y+=v})}}const o=p.flatMap(l=>{const s=e[l];return e[l]=void 0,s===void 0?[]:[s]}),i=z({timeline:t.timeline,first:t.first,frames:t.frames,sources:t.sources,alpha:t.alpha,firstInput:n?1:0,...n?{graphics:e}:{}});r.push(...i.filters);const u=partPost(t.part),c=u?P(r,i.out,u,{first:t.first,fps:t.timeline.fps,alpha:t.alpha,prefix:"ppost"}):i.out;finishGraph(r,c,t,o);const h=t.planes.reduce((l,s)=>l+imagesOf(s,t.samples,t.overlays),0);return[...n?["-f","image2pipe","-c:v","png","-framerate",`${String(a.num*h)}/${String(a.den)}`,"-i","-"]:[],...i.inputs,"-filter_complex",r.join(";"),"-map","[v]","-frames:v",String(t.frames)]}export function frameAt(t,a){const n=Math.max(1,Math.round(t.duration*t.fps));return Math.min(Math.max(0,Math.floor(a*t.fps+1e-9)),n-1)}export const stillOutput=(t="png")=>t==="jpeg"?["-f","image2pipe","-c:v","mjpeg","-q:v","2"]:t==="webp"?["-c:v","libwebp","-quality","90","-f","webp"]:["-f","image2pipe","-c:v","png"];export async function compositeStill(t){const a=t.frame===void 0?{...t.timeline,footage:[]}:t.timeline,n=t.graphics.length>0?t.planes??[0]:[],r=n.filter(c=>t.overlays?.includes(c)).length,e=Math.max(1,(t.graphics.length-r)/Math.max(1,n.length-r)),p=t.format==="jpeg",o=partAt(t.timeline,(t.frame??0)/t.timeline.fps);if((t.format??"png")==="png"&&n.length<=1&&r===0&&e===1&&!t.post&&!partPost(o)&&!t.lut&&!j(t.capture)&&B(a,t.frame??0,1).length===0)return L(a,t.graphics[0],t.alpha);const i=compositeArgs({timeline:a,first:t.frame??0,frames:1,sources:t.sources,alpha:t.alpha&&!p,planes:n,...t.overlays?{overlays:t.overlays}:{},samples:e,...t.capture?{capture:t.capture}:{},...t.post?{post:t.post}:{},...t.lut?{lut:t.lut}:{},...o?{part:o}:{},tail:[p?"scale=out_color_matrix=bt601:out_range=pc,format=yuvj444p":`format=${t.alpha?"rgba":"rgb24"}`]}),{out:u}=await I(t.ffmpeg,["-v","error",...i,...stillOutput(t.format),"-"],t.graphics.length>0?async c=>{for(const h of t.graphics)await T(c,F(h))}:void 0,!0);if(u.length===0)throw new Error("ffmpeg drew no frame.");return u}function J(t){const a=/^#([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})?$/i.exec(t);if(!a)return[0,0,0,0];const n=(r,e)=>r===void 0?e:parseInt(r,16);return[n(a[1],0),n(a[2],0),n(a[3],0),n(a[4],255)]}function L(t,a,n){const{width:r,height:e}=t,p=n&&t.background==="transparent",[o,i,u]=J(t.background),c=a?w.sync.read(a):void 0,h=new w({width:r,height:e}),l=h.data,s=c?.width===r&&c.height===e?c.data:void 0;for(let f=0;f<l.length;f+=4){const g=s?s[f+3]??0:0;if(p){l[f]=s?s[f]??0:0,l[f+1]=s?s[f+1]??0:0,l[f+2]=s?s[f+2]??0:0,l[f+3]=g;continue}const m=255-g;l[f]=Math.round(((s?.[f]??0)*g+o*m)/255),l[f+1]=Math.round(((s?.[f+1]??0)*g+i*m)/255),l[f+2]=Math.round(((s?.[f+2]??0)*g+u*m)/255),l[f+3]=255}return w.sync.write(h,p?{}:{colorType:2})}

package/dist/node_modules/@allyhub/render/dist/doc/drawn.js

@@ -0,0 +1,27 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readFile as d}from"node:fs/promises";import{createRequire as g}from"node:module";import{dirname as p,join as y}from"node:path";import{openPage as l}from"@allyhub/browser";import{diagramConfig as v}from"@allyhub/doc";const h=g(import.meta.url);let m;export function katexCss(){return m??=(async()=>{const i=h.resolve("katex/dist/katex.min.css"),n=await d(i,"utf8"),o=[...n.matchAll(/src:url\((fonts\/[^)]+\.woff2)\) format\("woff2"\)[^;}]*/gu)];let a=n;for(const[t,e]of o){if(e===void 0)continue;const r=await d(y(p(i),e));a=a.replace(t,`src:url(data:font/woff2;base64,${r.toString("base64")}) format("woff2")`)}return a})(),m}let u;const x=()=>(u??=d(h.resolve("mermaid/dist/mermaid.min.js"),"utf8"),u);export async function drawDiagrams(i,n,o){const a=v(o),t=new Map,e=[...new Set(n)];if(e.length===0)return t;const r=await l(i,{width:900,height:1200,allow:()=>!1});try{await f(r,`<!doctype html><html><head><meta charset="utf-8"></head><body><script>${(await x()).replace(/<\/script/giu,"<\\/script")}<\/script></body></html>`);const s=await r.evaluate(`(async () => {
+      const codes = ${JSON.stringify(e)};
+      window.mermaid.initialize(${JSON.stringify(a)});
+      const out = [];
+      for (let i = 0; i < codes.length; i++) {
+        try {
+          const { svg } = await window.mermaid.render("diagram" + i, codes[i]);
+          // Its own size, from its viewBox: Mermaid sizes it to its container.
+          const holder = document.createElement("div");
+          holder.innerHTML = svg;
+          // A Gantt chart's line at today would make the page differ by the day it is drawn.
+          holder.querySelectorAll(".today").forEach((e) => e.remove());
+          const el = holder.querySelector("svg");
+          const box = el && el.viewBox && el.viewBox.baseVal;
+          if (el && box && box.width > 0) {
+            el.setAttribute("width", String(Math.ceil(box.width)));
+            el.setAttribute("height", String(Math.ceil(box.height)));
+            el.style.removeProperty("max-width");
+          }
+          out.push({ svg: el ? el.outerHTML : svg });
+        } catch (e) {
+          out.push({ error: String(e && e.message ? e.message : e) });
+        }
+      }
+      return out;
+    })()`);e.forEach((c,w)=>{t.set(c,s[w]??{error:"Mermaid drew nothing"})})}finally{await r.close()}return t}async function f(i,n){const{frameTree:o}=await i.session.send("Page.getFrameTree");await i.session.send("Page.setDocumentContent",{frameId:o.frame.id,html:n}),await i.evaluate("new Promise((r) => (document.readyState === 'complete' ? r(true) : addEventListener('load', () => r(true), { once: true })))")}const b=2;export async function mathPictures(i,n){const o=new Map,a=[...new Set(n)];if(a.length===0)return o;const t=await l(i,{width:900,height:1200,scale:b,allow:()=>!1});try{await f(t,`<!doctype html><html><head><meta charset="utf-8"><style>${await katexCss()} body{margin:0;background:#fff} .eq{display:inline-block;padding:2px 4px} .katex-display{margin:0}</style></head><body>${a.map((e,r)=>`<div><div class="eq" id="eq${String(r)}">${e}</div></div>`).join("")}</body></html>`),await t.evaluate("document.fonts.ready.then(() => true)");for(let e=0;e<a.length;e++){const r=a[e];if(r===void 0)continue;const s=await t.evaluate(`(() => { const r = document.getElementById("eq${String(e)}")?.getBoundingClientRect(); return r ? { x: r.x, y: r.y + scrollY, width: r.width, height: r.height } : null; })()`);if(!s||s.width===0||s.height===0)continue;const c=await t.session.send("Page.captureScreenshot",{format:"png",clip:{...s,scale:1},captureBeyondViewport:!0});o.set(r,{data:Buffer.from(c.data,"base64"),width:Math.ceil(s.width),height:Math.ceil(s.height)})}}finally{await t.close()}return o}

package/dist/node_modules/@allyhub/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,printPdf,renderDoc,renderWord}from"./print.js";export{docFontsCss,SHEET_FONT,sheetFontsCss}from"./fonts.js";export{docPages,DocPageError}from"./pages.js";export{PdfJoiner}from"./pdf.js";

package/dist/node_modules/@allyhub/render/dist/doc/pages.js

@@ -0,0 +1,32 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{mkdtemp as x,readFile as c,rm as b}from"node:fs/promises";import{createRequire as j}from"node:module";import{tmpdir as S}from"node:os";import{dirname as k,join as n}from"node:path";import{drawHtml as P,startBrowser as $}from"@allyhub/browser";import{createPackages as M}from"@allyhub/runtimes";import{PDFDocument as E}from"pdf-lib";import{docFooter as C,docPage as I,printPdf as D}from"./print.js";export class DocPageError extends Error{page;count;constructor(a,e){super(`The doc has ${String(e)} page${e===1?"":"s"}: there is no page ${String(a)}.`),this.page=a,this.count=e}}const y=25.4/72,g=16,F=22;function N(t,a,e,i){return`<!doctype html><meta charset="utf-8">
+<style>
+body{margin:0;background:#e7e5e0;font:12px/1 system-ui,sans-serif;color:#57534e}
+.grid{display:grid;grid-template-columns:repeat(${String(i)},${String(e)}px);gap:${String(g)}px;padding:${String(g)}px;width:max-content}
+figure{margin:0}
+canvas{display:block;width:${String(e)}px;background:#fff;box-shadow:0 1px 3px rgba(0,0,0,.2)}
+figcaption{height:${String(F-6)}px;padding-top:6px;text-align:center}
+</style>
+<div class="grid" id="grid"></div>
+<script type="module">
+import * as pdfjs from "/pdf.mjs";
+pdfjs.GlobalWorkerOptions.workerSrc = "/pdf.worker.mjs";
+window.allyhubReady = (async () => {
+  const pdf = await pdfjs.getDocument({ url: "/doc.pdf", isEvalSupported: false }).promise;
+  const grid = document.getElementById("grid");
+  for (const n of ${JSON.stringify(t)}) {
+    const page = await pdf.getPage(n);
+    const scale = ${String(e)} / page.getViewport({ scale: 1 }).width;
+    const viewport = page.getViewport({ scale });
+    const canvas = document.createElement("canvas");
+    canvas.width = Math.round(viewport.width);
+    canvas.height = Math.round(viewport.height);
+    await page.render({ canvasContext: canvas.getContext("2d"), canvas, viewport }).promise;
+    const figure = document.createElement("figure");
+    const caption = document.createElement("figcaption");
+    caption.textContent = n + " / ${String(a)}";
+    figure.append(canvas, caption);
+    grid.append(figure);
+  }
+})();
+<\/script>`}async function O(t){try{return k(j(import.meta.url).resolve("pdfjs-dist/package.json"))}catch{}const{dir:a}=await M().ensure("pdfjs-dist",{...t===void 0?{}:{onFetch:t}});return n(a,"node_modules","pdfjs-dist")}export async function docPages(t){const a=await x(n(S(),"allyhub-doc-pages-"));try{const e=n(a,"doc.pdf"),i=await I(t.root,t.doc,t.stills);await D({parts:{count:1,html:()=>i},file:e,title:t.doc.title??t.doc.path,footer:await C(t.root,t.doc)});const m=await c(e),f=await E.load(m,{updateMetadata:!1}),o=f.getPageCount(),l=f.getPage(0).getSize(),s=t.pages!==void 0&&t.pages.length>0;for(const r of t.pages??[])if(!Number.isInteger(r)||r<1||r>o)throw new DocPageError(r,o);const d=s?[...new Set(t.pages)]:Array.from({length:o},(r,v)=>v+1),u=t.pageWidth??(s?760:360),p=Math.max(1,Math.min(t.columns??(s?2:4),d.length)),w=await O(t.onFetch),h=await $({gpu:!1,htmlInCanvas:!1});try{const r=await P(h,{html:N(d,o,u,p),width:p*u+(p+1)*g,format:t.format??"png",...t.format==="webp"?{quality:90}:{},mounts:[{at:"/pdf.mjs",body:await c(n(w,"build","pdf.min.mjs")),type:"text/javascript"},{at:"/pdf.worker.mjs",body:await c(n(w,"build","pdf.worker.min.mjs")),type:"text/javascript"},{at:"/doc.pdf",body:m,type:"application/pdf"}]});return{count:o,paper:{width:Math.round(l.width*y),height:Math.round(l.height*y)},drawn:d,picture:r}}finally{await h.close()}}finally{await b(a,{recursive:!0,force:!0})}}