allyhub 0.3.0 → 0.4.0

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

@@ -67,11 +67,15 @@ export declare const CheckStateSchema: z.ZodObject<{
 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";
@@ -132,6 +136,17 @@ export declare const PROJECT_TOOLS: {
             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>;
@@ -141,6 +156,7 @@ export declare const PROJECT_TOOLS: {
         }, 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<{
@@ -174,6 +190,19 @@ export declare const PROJECT_TOOLS: {
         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";
@@ -210,12 +239,14 @@ export declare const PROJECT_TOOLS: {
         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";
@@ -237,6 +268,7 @@ export declare const PROJECT_TOOLS: {
             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";
@@ -248,7 +280,11 @@ export declare const PROJECT_TOOLS: {
             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<{
@@ -318,6 +354,7 @@ export declare const TOOL_NOTIFICATIONS: {
             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";

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

@@ -1,2 +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 n}from"./files.js";import{method as t,notification as r}from"./jsonrpc.js";const i={item:n,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"],ExportJobSchema=e.strictObject({id:e.string(),item:n,versions:e.array(e.string()),types:e.array(e.string()),state:e.enum(EXPORT_STATES),progress:e.number().min(0).max(1),files:e.array(n),error:e.string().optional()}),IndexJobSchema=e.strictObject({file:n,status:e.enum(["running","done","failed"]),message:e.string(),share:e.number().min(0).max(1).optional()});const s=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:n,entry:n,title:e.string().optional()})),folder:e.string(),name:e.string(),revision:e.int().nonnegative()}),"The project's items, as the build finds them."),"video/versions":t(e.strictObject({item:n}),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."),"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()}),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."),"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:n,versions:e.array(e.string()).optional(),types:e.array(e.string().min(1)).max(10).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)}),"The exports asked for since the server started."),"scenery/viewer":t(e.strictObject({item:n,camera:e.strictObject({position:s,target:s}).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"},"video/versions":{command:"inspect combos"},"video/stage":{command:"frames"},"video/timeline":{command:"inspect timeline"},"video/still":{command:"frames"},"check/results":{command:"inspect"},"check/run":{command:"check"},"export/start":{command:"render"},"export/cancel":{command:"render"},"export/list":{files:".allyhub/out/"},"scenery/viewer":{command:"scenery view"}};export function toolSpec(o){return Object.hasOwn(PROJECT_TOOLS,o)?PROJECT_TOOLS[o]: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.")};
+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 i}from"./jsonrpc.js";const n={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."),"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({...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(),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(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."),"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"},"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(s){return Object.hasOwn(PROJECT_TOOLS,s)?PROJECT_TOOLS[s]:void 0}export const TOOL_NOTIFICATIONS={"project/changed":i(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":i(CheckStateSchema,"The check started, ended or failed."),"export/changed":i(e.strictObject({job:ExportJobSchema}),"An export moved on."),"index/changed":i(e.strictObject({jobs:e.array(IndexJobSchema)}),"Making what the media index lacks moved on.")};

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

@@ -1,6 +1,6 @@
 {
   "name": "@allyhub-next/protocol",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "exports": {
     ".": {

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

@@ -1,2 +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-next/formats";import{RegistryIndexSchema as E,RegistryItemSchema as I}from"@allyhub-next/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)),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)))})}
+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-next/formats";import{RegistryIndexSchema as E,RegistryItemSchema as I}from"@allyhub-next/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/node_modules/@allyhub-next/registry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allyhub-next/registry",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "exports": {
     ".": {

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

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

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

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

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

@@ -1,3 +1,4 @@
+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 {
@@ -11,6 +12,16 @@ export interface DocFile {
 }
 /** 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;

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

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

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

@@ -1,4 +1,4 @@
-import { type CaptionCueOptions } from "@allyhub-next/video-core";
+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 {
@@ -8,7 +8,29 @@ export interface ExportOptions extends Tools {
     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 PPTX's slides: "picture", each a full-bleed picture (the default),
+     * or "editable", each the picture with its text hidden under a text box
+     * per block of text, as measured on the page (its box, size, weight,
+     * colour and font), so the words can be edited in PowerPoint, Keynote or
+     * Google Slides.
+     */
+    pptx?: "picture" | "editable";
+}
+/** 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. */
@@ -29,7 +51,7 @@ export declare function renderCaptions(opts: ExportOptions & {
 /** 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 page (a paged output), each
+ * 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
@@ -44,8 +66,11 @@ export declare function renderPdf(opts: ExportOptions): Promise<ExportResult>;
  */
 export declare function renderPng(opts: ExportOptions): Promise<ExportResult>;
 /**
- * One full-bleed still per part or page; the speaker notes are a page's
- * notes, else what a part says, else the text it shows.
+ * One slide per part or page (per step with `steps`), each the still as a
+ * full-bleed picture, or, `editable`, the still without its text under a
+ * text box per block of text; 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/node_modules/@allyhub-next/render/dist/exports.js

@@ -1,3 +1,3 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{writeFile as w}from"node:fs/promises";import{createRequire as x}from"node:module";import{captionCues as S,paperOf as k,subtitleCues as j,toSrt as $,toVtt as L}from"@allyhub-next/video-core";import{RenderError as v}from"./errors.js";import{backgroundStill as C,finalStill as p,footageStill as P}from"./stills.js";async function l(t,e,n){return await w(t,e),{out:t,units:n,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,n=await t.page.lines();if(n.length===0)throw new v("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 i={lines:n,fps:e.fps},a=t.captions?S(i,t.captions):j(i,await t.page.captionOptions()),o=t.type==="srt"?$(a):L(a);return l(t.out,new TextEncoder().encode(o),a.length)}export async function renderCover(t){const{page:e}=t,n=await e.covers()>0?await C(e.timeline,await e.cover(0),"jpeg",t):await p(e,e.timeline.parts[0]?.still??0,{...u(t),format:"jpeg"});return l(t.out,n,1)}export async function renderPdf(t){const{timeline:e}=t.page,n=e.background,i=[];for(const[o,s]of e.parts.entries()){const r=await P(t.media,e,s.still,"jpeg",t);i.push({still:s.still,title:s.title??String(o+1),background:r?`url(data:image/jpeg;base64,${r.toString("base64")}) 0 0 / 100% 100% no-repeat`:n})}const a=await t.page.print(i,k(t.target.format));return l(t.out,a,i.length)}export async function renderPng(t){const e=t.page.timeline.parts,n=Math.max(2,String(e.length).length),i=t.out.replace(/\.png$/i,""),a=[];let o=0;for(const[s,r]of e.entries()){const c=e.length===1?t.out:`${i}.${String(s+1).padStart(n,"0")}.png`,g=await p(t.page,r.still,u(t));await w(c,g),a.push(c),o+=g.byteLength}return{out:a[0]??t.out,units:a.length,bytes:o,files:a}}const O=x(import.meta.url)("pptxgenjs");export async function renderPptx(t){const{timeline:e}=t.page,{width:n,height:i}=e,a=13.333/Math.max(n,i),o=n*a,s=i*a,r=new O;r.defineLayout({name:"ALLYHUB",width:o,height:s}),r.layout="ALLYHUB";const c=await t.page.text();for(const d of e.parts){const b=await p(t.page,d.still,u(t)),m=r.addSlide();m.addImage({data:`image/png;base64,${b.toString("base64")}`,x:0,y:0,w:o,h:s});const f=c.find(y=>y.key===d.key),h=f?.notes??f?.spoken??f?.onScreen.join(`
-`)??"";h&&m.addNotes(h)}const g=await r.write({outputType:"nodebuffer"});return l(t.out,g,e.parts.length)}
+import{writeFile as S}from"node:fs/promises";import{createRequire as $}from"node:module";import{captionCues as M,paperOf as j,subtitleCues as v,toSrt as L,toVtt as T}from"@allyhub-next/video-core";import{RenderError as O}from"./errors.js";import{backgroundStill as z,finalStill as w,footageStill as C}from"./stills.js";export function stillsOf(t,e=!1){const a=[];for(const[o,i]of t.parts.entries()){if(i.hidden===!0)continue;const n=i.title??String(o+1),r=e&&i.steps!==void 0?i.steps:[i.still];r.forEach((c,s)=>{a.push({part:i,at:c,title:r.length>1?`${n} (${String(s+1)})`:n})})}return a}async function h(t,e,a){return await S(t,e),{out:t,units:a,bytes:e.byteLength}}const b=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,a=await t.page.lines();if(a.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:a,fps:e.fps},i=t.captions?M(o,t.captions):v(o,await t.page.captionOptions()),n=t.type==="srt"?L(i):T(i);return h(t.out,new TextEncoder().encode(n),i.length)}export async function renderCover(t){const{page:e}=t,a=await e.covers()>0?await z(e.timeline,await e.cover(0),"jpeg",t):await w(e,e.timeline.parts[0]?.still??0,{...b(t),format:"jpeg"});return h(t.out,a,1)}export async function renderPdf(t){const{timeline:e}=t.page,a=e.background,o=[];for(const n of stillsOf(e,t.steps)){const r=await C(t.media,e,n.at,"jpeg",t);o.push({still:n.at,title:n.title,background:r?`url(data:image/jpeg;base64,${r.toString("base64")}) 0 0 / 100% 100% no-repeat`:a})}const i=await t.page.print(o,e.paper??j(t.target.format));return h(t.out,i,o.length)}export async function renderPng(t){const e=stillsOf(t.page.timeline,t.steps),a=Math.max(2,String(e.length).length),o=t.out.replace(/\.png$/i,""),i=[];let n=0;for(const[r,c]of e.entries()){const s=e.length===1?t.out:`${o}.${String(r+1).padStart(a,"0")}.png`,l=await w(t.page,c.at,b(t));await S(s,l),i.push(s),n+=l.byteLength}return{out:i[0]??t.out,units:i.length,bytes:n,files:i}}const P=$(import.meta.url)("pptxgenjs"),E=t=>({color:t.slice(0,3).map(e=>Math.round(e).toString(16).padStart(2,"0")).join(""),transparency:Math.round((1-t[3])*100)}),N=t=>t?.[0]?.replace(/^["']|["']$/gu,"").replace(/ Variable$/u,"");async function A(t,e,a,o){const i=await t.inks?.(a)??[];for(const n of i){if(n.text.text.trim()==="")continue;const[r,c,s,l]=n.text.box,g=n.lines.find(p=>p.fill!==void 0)?.fill,f=g?E(g):void 0,u=Math.max(1,n.lines.length),d=N(n.text.fonts);e.addText(n.text.text,{x:r*o,y:c*o,w:Math.max(s,1)*o,h:Math.max(l,1)*o,fontSize:Math.max(1,Math.round(n.size*o*72*10)/10),...d===void 0?{}:{fontFace:d},...f===void 0?{}:{color:f.color,...f.transparency>0?{transparency:f.transparency}:{}},bold:n.weight>=600,margin:0,valign:"top",fit:"none",...u===1?{wrap:!1}:{},...u>1&&n.size>0?{lineSpacingMultiple:l/u/n.size/1.2}:{}})}}export async function renderPptx(t){const{timeline:e}=t.page,{width:a,height:o}=e,i=/^([\d.]+)in ([\d.]+)in$/u.exec(e.paper??""),n=13.333/Math.max(a,o),r=i?Number(i[1]):a*n,c=i?Number(i[2]):o*n,s=new P;s.defineLayout({name:"ALLYHUB",width:r,height:c}),s.layout="ALLYHUB";const l=await t.page.text(),g=t.pptx==="editable"&&t.page.inks!==void 0&&t.page.hideText!==void 0,f=stillsOf(e,t.steps);for(const d of f){g&&await t.page.hideText?.(!0);let p;try{p=await w(t.page,d.at,b(t))}finally{g&&await t.page.hideText?.(!1)}const m=s.addSlide();m.addImage({data:`image/png;base64,${p.toString("base64")}`,x:0,y:0,w:r,h:c}),g&&await A(t.page,m,d.at,r/a);const x=l.find(k=>k.key===d.part.key),y=x?.notes??x?.spoken??x?.onScreen.join(`
+`)??"";y&&m.addNotes(y)}const u=await s.write({outputType:"nodebuffer"});return h(t.out,u,f.length)}

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

@@ -1,4 +1,4 @@
-import type { CaptionLine, CaptionOptions, CaptureOptions, Combo, MediaInfo, Problem, Timeline } from "@allyhub-next/video-core";
+import type { TextInk, CaptionLine, CaptionOptions, CaptureOptions, Combo, MediaInfo, Problem, Timeline } from "@allyhub-next/video-core";
 /** Which output a render is of: a piece's output in one combo and format. */
 export interface RenderTarget {
     piece: string;
@@ -129,6 +129,16 @@ export interface ExportPage extends GraphicsPage {
     captionOptions(): Promise<CaptionOptions | undefined>;
     /** Each part's notes and text, for a deck's speaker notes. */
     text(): Promise<readonly PartText[]>;
+    /**
+     * Each text block drawn at film time t, with its lines' glyph boxes and
+     * fills, its size and weight (LoadedOutput.inks): an editable PPTX's
+     * text boxes. Absent where the page cannot measure.
+     */
+    inks?(t: number): Promise<TextInk[]>;
+    /** A deck as it was drawn (slides-core's DrawnDeck): its PowerPoint file's model. Absent on a video. */
+    deck?(): Promise<unknown>;
+    /** Hides every text's fill while on (HIDE_TEXT_CSS): the picture behind an editable PPTX's text boxes. */
+    hideText?(on: boolean): Promise<void>;
     /** How many covers the output has (video(…, { covers })). */
     covers(): Promise<number>;
     /**

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

@@ -44,6 +44,8 @@ export interface RenderOptions extends Tools {
      * renders every part again and keeps nothing.
      */
     partCache?: PartCache | false;
+    /** Aborting it stops the render: its pages and ffmpeg runs, and no part of its file stays. */
+    signal?: AbortSignal;
 }
 /** Where one part's time went (RenderTimings.part), in seconds. */
 export interface PartTimings {

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

@@ -1,3 +1,3 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{copyFile as Xe,mkdir as ht,mkdtemp as gt,readdir as yt,readFile as kt,rename as bt,rm as ce,stat as vt,writeFile as Pt}from"node:fs/promises";import{createHash as xt}from"node:crypto";import{tmpdir as Mt}from"node:os";import{join as S}from"node:path";import{EXIT as $t}from"@allyhub-next/protocol";import{ALPHA_TYPES as jt,comboKey as St,fpsRational as At,heldTime as _t,planeAt as Ft}from"@allyhub-next/video-core";import{CAP_START as Ot,capOf as Tt,capRun as Ye,overCap as Bt,packetSizes as Ne}from"./cap.js";import{capturesAnything as Et}from"./capture.js";import{compositeArgs as Ct,planSources as Dt,transparentPng as Rt}from"./composite.js";import{MAX_WORKERS as Ht,autoWorkers as Kt,encodeFor as zt,encoderOf as qe,gopArgs as It,HELD_OUT as Wt,twoOutputs as Lt}from"./encode.js";import{RenderError as Vt}from"./errors.js";import{ffmpegVersion as Jt}from"./ffmpeg.js";import{junctionArgs as Ut}from"./junction.js";import{lutFile as Xt,pagePlane as Yt}from"./look.js";import{PartCache as Nt,closedPart as qt,drawnKey as Gt,junctionDigest as Qt,partDigest as Zt,place as en}from"./parts.js";import{PipeFormat as Ge}from"./png.js";import{PagePool as tn,drawInOrder as nn,encoderSlots as rn,renderSerial as on}from"./pool.js";import{postReadsTime as Qe}from"./post.js";import{segmentsOf as an}from"./segments.js";import{mixSound as sn}from"./sound.js";import{runFfmpegWith as Ze,toolsOf as cn,write as fn}from"./tools.js";const A=s=>Math.round(performance.now()-s)/1e3,fe=async(s,y,w)=>{await Ze(s,y,w)};function un(s){const y=new Set;return s.filter(w=>{const I=[w.code,w.message,w.piece,w.output,w.combo?St(w.combo):"",w.format,w.part,w.where?.file,w.where?.line].join("|");return y.has(I)?!1:(y.add(I),!0)})}const et=s=>xt("sha256").update(s).digest("hex");export async function renderVideo(s){const{ffmpeg:y,ffprobe:w}=await cn(s),I={ffmpeg:y,ffprobe:w},{target:$e,media:J}=s,[O]=s.pages;if(!O)throw new Error("renderVideo draws with at least one page.");const d=s.type??"mp4",D=zt(d,$e.format,s.encode??{},O.timeline),M=s.look,U=M.transparent===!0&&jt.includes(d),je=qe(d,D,U),te=await Xt(J.root,M.post?.lut),R=await gt(S(Mt(),"allyhub-render-")),W=[...s.pages],Se=[],tt=()=>Promise.all(Se.splice(0).map(le=>le.close?.()??Promise.resolve())),ue=[];let X;const de=performance.now(),h={pages:0,workers:1,concurrency:1,plan:0,parts:0,mix:0,mux:0,total:0,part:[]};try{const le=performance.now(),b=O.timeline,l=b.fps,me=At(l),Ae=Math.round(b.duration*l),pe=M.motionBlur,_=pe?pe.samples:1,we=pe?.shutter??.5,_e=await Dt(J,b,w),P=d==="gif"||d==="png"?"png":d,he=d==="webm"?["-fflags","+bitexact"]:[],nt=P!=="png"&&!(d==="mp4"&&D.codec==="h265"),T=an(b,nt),ne=[];je.rgb?ne.push(`format=${je.pixFmt}`):ne.push("scale=out_color_matrix=bt709:out_range=tv:flags=neighbor");const Y=(e,t=!1,n)=>["-r",me.text,...qe(d,D,U,e,t,n).args,...It(d,D.codec,e),...d==="mp4"||d==="mov"?["-video_track_timescale","90000"]:[],...he],B=d==="mp4"&&D.maxBitrate!==void 0&&D.maxBitrate>0?Tt(D.maxBitrate):void 0,rt=e=>[...Y(e),...B?["over the cap",...Y(e,!0)]:[],...ne],N=s.code,H=P!=="png"&&N!==void 0&&s.partCache!==!1&&process.env.ALLYHUB_PART_CACHE!=="off"?s.partCache??Nt.of(J.root):void 0,q=[],Fe=new Map;if(H&&N){const e=await Jt(y),t=te?et(await kt(te)):null,n=O.reads,o={alpha:U,samples:_,shutter:we,capture:Et(M.capture)?M.capture??null:null,post:M.post?.filter??null,lut:t},i=r=>{const u=r.post?.filter,g=o.capture!==null||o.post!==null&&Qe(o.post)||u!==void 0&&Qe(u);return{...o,...u===void 0?{}:{partPost:u},...g?{at:Math.round(r.start*l)}:{}}},a=Math.round(b.duration*l),k=b.parts.at(-1)?.key,m=new Map,F=r=>{const u=O.signs[r.key];if(u===void 0||qt(N,u))return Promise.resolve(void 0);let g=m.get(r.key);if(!g){const j=Math.round(r.start*l),c=r.key===k?a:Math.min(a,Math.round(r.end*l)),f=[];for(let K=j;K<c;K++)for(let C=0;C<_;C++)f.push(K/l+(C>0?C*we/(l*_):0));const Pe=performance.now();g=O.partSign(r.key,f).then(K=>(h.signs=Math.round(((h.signs??0)+A(Pe))*1e3)/1e3,K)),m.set(r.key,g)}return g},x=async(r,u,g,j)=>{const c=O.signs[r.key];if(c===void 0)return;const f=await F(r);return f&&Fe.set(r.key,Gt(N,f)?"frames":`bundle: ${f.unknown??`a canvas drawn by ${f.owners.join(", ")}, in the piece's own file`}`),Zt({root:J.root,code:N,combo:$e.combo,timeline:b,part:r,sign:c,...f?{drawn:f}:{},media:J.media,reads:n,frames:u,encode:g,look:i(r),ffmpeg:e,...j?{trim:j}:{},...O.gpu===!0?{gpu:!0}:{}})},p=new Map,v=r=>{let u=p.get(r.key);return u||(u=x(r,Math.round(r.end*l)-Math.round(r.start*l),[]),p.set(r.key,u)),u};for(const r of T){const u=rt(r.frames);if(!r.junction){q.push(await x(r.part,r.frames,u,r.trim));continue}const[g,j]=[await v(r.junction.from),await v(r.part)];q.push(g===void 0||j===void 0?void 0:await Qt({out:g,in:j,transition:r.junction.transition,fps:l,frames:r.frames,encode:u,ffmpeg:e}))}}const Oe=await Promise.all(T.map((e,t)=>{const n=q[t];return H&&n?H.get(n,P):Promise.resolve(void 0)})),Te=e=>e>0?e*we/(l*_):0,ot=(e,t,n)=>e.junction?_t(t,n/l,l):n/l,Be=(e,t,n,o)=>Ft(t.part,t.plane,ot(e,t.part,n)+Te(o)),ge=T.map(e=>{const t=(e.junction?[e.junction.from,e.part]:[e.part]).map(i=>{const a=[];let k=0;return i.planes.forEach((m,F)=>{const x={part:i,plane:F,images:m.overlay===!0?1:_};let p=0;for(let v=e.first;v<e.first+e.frames;v++)for(let r=0;r<x.images;r++)Be(e,x,v,r)&&p++;p!==0&&(a.push(x),k+=p)}),{part:i,planes:a.map(m=>m.plane),overlays:a.flatMap(m=>i.planes[m.plane]?.overlay===!0?[m.plane]:[]),groups:a,drawn:k,graphics:k>0}}),n=t.flatMap(i=>i.groups),o=n.length===0?_:n.reduce((i,a)=>i+a.images,0);return{pictures:t,groups:n,per:o,graphics:t.some(i=>i.graphics),drawn:t.reduce((i,a)=>i+a.drawn,0),images:e.frames*o}}),Ee=(e,t,n)=>{let o=n%e.per,i={part:t.part,plane:0,images:_};for(const a of e.groups){if(o<a.images){i=a;break}o-=a.images}return{f:t.first+Math.floor(n/e.per),k:o,group:i}},at=(e,t,n)=>{const o=Ee(e,t,n);return Be(t,o.group,o.f,o.k)};let ye=0;ge.forEach((e,t)=>{Oe[t]===void 0&&(ye+=e.drawn)}),h.plan=A(le);const Ce=s.openPage===void 0?W.length:Math.max(W.length,ye===0?1:Math.min(s.workers??Kt(ye),Ht));h.workers=Ce;const re=new tn;for(const e of W)re.add(e);const st=async e=>{const t=[];for(const n of W)for(const o of await n.problems())o.level!=="error"||o.code==="AK-P002"||o.part!==void 0&&!e.has(o.part)||t.push(o);return un(t)},it=performance.now(),De=s.openPage;for(let e=W.length;De&&e<Ce;e++){const t=De().then(n=>{Se.push(n),W.push(n),re.add(n),h.pages=A(it)});t.catch(()=>{}),ue.push(t)}const ct=on(),ke=s.sound,E=d==="gif"||ke===void 0?void 0:S(R,"audio.wav"),Re=async()=>{if(E===void 0||ke===void 0)return;const e=performance.now(),t=await sn({timeline:b,sound:ke,out:E,ffmpeg:y});return h.mix=A(e),t};ct||(X=Re(),X.catch(()=>{}));const ft=Rt(b.width,b.height),He=ge.reduce((e,t)=>e+t.images,0);let L=0,Ke=-1;const be=()=>{const e=Math.floor(90*L/He);e<=Ke||(Ke=e,s.onProgress?.(.9*L/He))},G=S(R,"frames");P==="png"&&await ht(G,{recursive:!0});const oe=T.map((e,t)=>S(R,`segment.${String(t).padStart(4,"0")}.${P}`));let ze=0,Ie=0;const Q=new AbortController,We=rn();h.concurrency=Math.max(1,Math.min(We.limit,Oe.filter(e=>e===void 0).length));const ut=performance.now(),Le=(e,t,n)=>fe(y,["-v","error","-y","-i",e,"-map","0:v","-c","copy","-frames:v",String(n),...he,t]),dt=async(e,t)=>{const n=ge[e];if(!n)return;const o=n.graphics,i=n.images,a={key:t.junction?`${t.junction.from.key}>${t.part.key}`:t.part.key,...t.junction?{junction:!0}:{},frames:t.frames,cached:!1,images:o?i:0,captured:0,reused:0,clear:0,capture:0,ffmpeg:0,waitFrames:0,waitPipe:0,start:0,end:0},k=t.junction?void 0:Fe.get(t.part.key);k!==void 0&&(a.keyed=k),h.part[e]=a;const m={captured:0,reused:0},F=new Map,x=c=>{let f=F.get(c);return f||(f=new Map,F.set(c,f)),f},p=P==="png"?S(G,"frame.%05d.png"):oe[e]??"",v={...M.capture?{capture:M.capture}:{},...M.post?.filter?{post:M.post.filter}:{},...te?{lut:te}:{},tail:ne},r=c=>({planes:n.pictures[c]?.planes??[],overlays:n.pictures[c]?.overlays??[]}),u=c=>We.run(async()=>{Q.signal.throwIfAborted(),a.start=A(de);const f=B?`${c}.held.${P}`:void 0,Pe=()=>["-v","error","-y",...Lt(t.junction?Ut({timeline:b,transition:t.junction.transition,first:t.first,frames:t.frames,sources:_e,alpha:U,out:r(0),in:r(1),samples:_,...v}):Ct({timeline:b,first:t.first,frames:t.frames,sources:_e,alpha:U,planes:n.pictures[0]?.planes??[],overlays:n.pictures[0]?.overlays??[],samples:_,part:t.part,...v}),f!==void 0),...Y(t.frames),...P==="png"?["-start_number",String(t.first+1)]:[],c,...f===void 0?[]:["-map",`[${Wt}]`,"-frames:v",String(t.frames),...Y(t.frames,!0),f]],K=performance.now();let C=n.drawn<i||n.groups.length>1;for(;;){const xe=new Ge(C);let Z=0,z=0;try{await Ze(y,Pe(),o?async ae=>{await nn({count:i,ahead:Math.max(8,re.size*4),draw:ee=>{if(!at(n,t,ee))return a.clear++,z++,Promise.resolve(ft);const{f:Me,k:se,group:ie}=Ee(n,t,ee);return re.use([e,ee],async mt=>{Q.signal.throwIfAborted();const pt=performance.now(),wt=await mt.frame(Me/l,{format:"png",alpha:!0,...Yt(ie.part,ie.plane),...t.junction?{part:ie.part.key}:{},reuse:x(ie.part.key),stats:m,...se>0?{offset:Te(se)}:{}});return a.capture+=(performance.now()-pt)/1e3,wt})},emit:async ee=>{const Me=xe.next(ee),se=performance.now();await fn(ae,Me),a.waitPipe+=(performance.now()-se)/1e3,L++,Z++,be()},waits:a,signal:Q.signal})}:void 0,!1,Q.signal);break}catch(ae){if(!(ae instanceof Ge.Mixed)||C)throw f!==void 0&&await ce(f,{force:!0}),ae;C=!0}L-=Z,a.clear-=z}if(B&&f!==void 0&&(await Bt(c,B,l,I)?(await bt(f,c),a.held=!0):await ce(f,{force:!0})),a.ffmpeg=A(K),o||(L+=i,be()),o){const xe=new Set(t.junction?[t.junction.from.key,t.part.key]:[t.part.key]),Z=await st(xe);if(Z.length>0)throw new Vt("draw-failed",`Drawing ${a.key} failed, so it is not rendered: ${Z.map(z=>`${z.code} ${z.message}${z.t===void 0?"":` (at ${z.t.toFixed(2)} s)`}`).join("; ")}`,{exit:$t.failed,hint:"allyhub frames --at and allyhub inspect layout --at draw that moment; fix what failed and render again."})}}),g=t.keep<t.frames,j=q[e];if(H&&j){const c=await H.segment(j,P,u);g?await Le(c.file,p,t.keep):await en(c.file,p),c.cached&&(t.junction?Ie++:ze++,a.cached=!0,L+=i,be())}else if(g){const c=S(R,`whole.${String(e).padStart(4,"0")}.${P}`);await u(c),await Le(c,p,t.keep),await ce(c,{force:!0})}else await u(p);a.captured=m.captured,a.reused=m.reused,a.end=A(de)},Ve=(await Promise.allSettled(T.map((e,t)=>dt(t,e).catch(n=>{throw Q.abort(n),n})))).find(e=>e.status==="rejected");if(Ve)throw Ve.reason;await Promise.all(ue),h.parts=A(ut);const $=await(X??Re()),ve=$?.loudness;s.onProgress?.(.95);const lt=performance.now();let V;if(d==="png"){const e=s.out.replace(/\.png$/,"");V=[];const t=(await yt(G)).filter(n=>/^frame\.\d+\.png$/.test(n)).sort();for(const n of t){const o=`${e}.${n.slice(6)}`;await Xe(S(G,n),o),V.push(o)}E&&ve&&(await Xe(E,`${e}.wav`),V.push(`${e}.wav`))}else if(d==="gif")await fe(y,["-v","error","-y","-framerate",me.text,"-start_number","1","-i",S(G,"frame.%05d.png"),"-filter_complex","split[a][b];[a]palettegen=stats_mode=diff[p];[b][p]paletteuse=dither=sierra2_4a","-r",me.text,"-loop","0",s.out]);else{if(B){const n=B.bufferKbps*1e3;let o=Ot*n;for(const[i,a]of oe.entries()){const k=await Ne(a,I);if(!k)continue;const m=Ye(k,B,l,o);if(!m.breaks){o=m.end;continue}const F=Y(k.length,!0,o/n),x=r=>fe(y,["-v","error","-y","-i",a,"-an",...F,r]);let p=S(R,`held.${String(i)}.mp4`);const v=q[i];H&&v?p=(await H.segment(et(Buffer.from(JSON.stringify(["held across the join",v,F]))),P,x)).file:await x(p),oe[i]=p,h.capped=(h.capped??0)+1,o=Ye(await Ne(p,I)??k,B,l,o).end}}const e=S(R,"segments.txt");await Pt(e,oe.map(n=>`file '${n.replace(/'/g,"'\\''")}'
-`).join(""));const t=d==="mov"?["-c:a","pcm_s24le"]:d==="webm"?["-c:a","libopus","-b:a",`${String(s.encode?.audioBitrate??160)}k`]:["-c:a","aac","-b:a",`${String(s.encode?.audioBitrate??192)}k`];await fe(y,["-v","error","-y","-f","concat","-safe","0","-i",e,...E===void 0?[]:["-i",E],"-map","0:v",...E===void 0?[]:["-map","1:a"],"-c:v","copy",...E===void 0?[]:t,...d==="mp4"||d==="mov"?["-movflags","+faststart"]:[],...he,s.out])}h.mux=A(lt),s.onProgress?.(1);const Je=V??[s.out];let Ue=0;for(const e of Je)Ue+=(await vt(e)).size;return{out:Je[0]??s.out,frames:Ae,duration:Ae/l,bytes:Ue,...ve?{loudness:ve}:{},...$?.gainDb!==void 0?{master:{...$.before?{before:$.before}:{},gainDb:$.gainDb,...$.limited===void 0?{}:{limited:$.limited},target:$.target,...$.rounds===void 0?{}:{rounds:$.rounds}}}:{},...V?{files:V}:{},parts:{total:T.filter(e=>!e.junction).length,cached:ze},...T.some(e=>e.junction)?{junctions:{total:T.filter(e=>e.junction).length,cached:Ie}}:{},timings:{...h,total:A(de),part:h.part.map(e=>({...e,capture:Math.round(e.capture*1e3)/1e3,waitFrames:Math.round(e.waitFrames*1e3)/1e3,waitPipe:Math.round(e.waitPipe*1e3)/1e3}))}}}finally{await Promise.allSettled([...ue,...X?[X]:[]]),await tt(),await ce(R,{recursive:!0,force:!0})}}
+import{copyFile as Ne,mkdir as yt,mkdtemp as kt,readdir as bt,readFile as vt,rename as Pt,rm as re,stat as xt,writeFile as Mt}from"node:fs/promises";import{createHash as $t}from"node:crypto";import{tmpdir as jt}from"node:os";import{join as S}from"node:path";import{EXIT as St}from"@allyhub-next/protocol";import{ALPHA_TYPES as At,comboKey as _t,fpsRational as Ft,heldTime as Ot,planeAt as Tt}from"@allyhub-next/video-core";import{CAP_START as Bt,capOf as Et,capRun as qe,overCap as Ct,packetSizes as Ge}from"./cap.js";import{capturesAnything as Dt}from"./capture.js";import{compositeArgs as Rt,planSources as It,transparentPng as Ht}from"./composite.js";import{MAX_WORKERS as Kt,autoWorkers as zt,encodeFor as Wt,encoderOf as Qe,gopArgs as Lt,HELD_OUT as Vt,twoOutputs as Jt}from"./encode.js";import{RenderError as Ut}from"./errors.js";import{ffmpegVersion as Xt}from"./ffmpeg.js";import{junctionArgs as Yt}from"./junction.js";import{lutFile as Nt,pagePlane as qt}from"./look.js";import{PartCache as Gt,closedPart as Qt,drawnKey as Zt,junctionDigest as en,partDigest as tn,place as nn}from"./parts.js";import{PipeFormat as Ze}from"./png.js";import{PagePool as rn,drawInOrder as on,encoderSlots as an,renderSerial as sn}from"./pool.js";import{postReadsTime as et}from"./post.js";import{segmentsOf as cn}from"./segments.js";import{mixSound as fn}from"./sound.js";import{runFfmpegWith as tt,toolsOf as un,write as dn}from"./tools.js";const A=a=>Math.round(performance.now()-a)/1e3,de=async(a,y,w,T)=>{await tt(a,y,w,!1,T)};function ln(a){const y=new Set;return a.filter(w=>{const T=[w.code,w.message,w.piece,w.output,w.combo?_t(w.combo):"",w.format,w.part,w.where?.file,w.where?.line].join("|");return y.has(T)?!1:(y.add(T),!0)})}const nt=a=>$t("sha256").update(a).digest("hex");export async function renderVideo(a){const{ffmpeg:y,ffprobe:w}=await un(a),T={ffmpeg:y,ffprobe:w},{target:Se,media:X}=a,[B]=a.pages;if(!B)throw new Error("renderVideo draws with at least one page.");const d=a.type??"mp4",I=Wt(d,Se.format,a.encode??{},B.timeline),M=a.look,Y=M.transparent===!0&&At.includes(d),Ae=Qe(d,I,Y),oe=await Nt(X.root,M.post?.lut),H=await kt(S(jt(),"allyhub-render-")),L=[...a.pages],_e=[],rt=()=>Promise.all(_e.splice(0).map(q=>q.close?.()??Promise.resolve())),le=[];let N;const V=[],me=performance.now(),h={pages:0,workers:1,concurrency:1,plan:0,parts:0,mix:0,mux:0,total:0,part:[]};try{const q=performance.now(),b=B.timeline,l=b.fps,pe=Ft(l),Fe=Math.round(b.duration*l),we=M.motionBlur,_=we?we.samples:1,he=we?.shutter??.5,Oe=await It(X,b,w),P=d==="gif"||d==="png"?"png":d,ge=d==="webm"?["-fflags","+bitexact"]:[],ot=P!=="png"&&!(d==="mp4"&&I.codec==="h265"),E=cn(b,ot),ae=[];Ae.rgb?ae.push(`format=${Ae.pixFmt}`):ae.push("scale=out_color_matrix=bt709:out_range=tv:flags=neighbor");const G=(e,t=!1,n)=>["-r",pe.text,...Qe(d,I,Y,e,t,n).args,...Lt(d,I.codec,e),...d==="mp4"||d==="mov"?["-video_track_timescale","90000"]:[],...ge],C=d==="mp4"&&I.maxBitrate!==void 0&&I.maxBitrate>0?Et(I.maxBitrate):void 0,at=e=>[...G(e),...C?["over the cap",...G(e,!0)]:[],...ae],Q=a.code,K=P!=="png"&&Q!==void 0&&a.partCache!==!1&&process.env.ALLYHUB_PART_CACHE!=="off"?a.partCache??Gt.of(X.root):void 0,Z=[],Te=new Map;if(K&&Q){const e=await Xt(y),t=oe?nt(await vt(oe)):null,n=B.reads,o={alpha:Y,samples:_,shutter:he,capture:Dt(M.capture)?M.capture??null:null,post:M.post?.filter??null,lut:t},i=r=>{const u=r.post?.filter,g=o.capture!==null||o.post!==null&&et(o.post)||u!==void 0&&et(u);return{...o,...u===void 0?{}:{partPost:u},...g?{at:Math.round(r.start*l)}:{}}},s=Math.round(b.duration*l),k=b.parts.at(-1)?.key,m=new Map,O=r=>{const u=B.signs[r.key];if(u===void 0||Qt(Q,u))return Promise.resolve(void 0);let g=m.get(r.key);if(!g){const j=Math.round(r.start*l),c=r.key===k?s:Math.min(s,Math.round(r.end*l)),f=[];for(let z=j;z<c;z++)for(let R=0;R<_;R++)f.push(z/l+(R>0?R*he/(l*_):0));const Me=performance.now();g=B.partSign(r.key,f).then(z=>(h.signs=Math.round(((h.signs??0)+A(Me))*1e3)/1e3,z)),m.set(r.key,g)}return g},x=async(r,u,g,j)=>{const c=B.signs[r.key];if(c===void 0)return;const f=await O(r);return f&&Te.set(r.key,Zt(Q,f)?"frames":`bundle: ${f.unknown??`a canvas drawn by ${f.owners.join(", ")}, in the piece's own file`}`),tn({root:X.root,code:Q,combo:Se.combo,timeline:b,part:r,sign:c,...f?{drawn:f}:{},media:X.media,reads:n,frames:u,encode:g,look:i(r),ffmpeg:e,...j?{trim:j}:{},...B.gpu===!0?{gpu:!0}:{}})},p=new Map,v=r=>{let u=p.get(r.key);return u||(u=x(r,Math.round(r.end*l)-Math.round(r.start*l),[]),p.set(r.key,u)),u};for(const r of E){const u=at(r.frames);if(!r.junction){Z.push(await x(r.part,r.frames,u,r.trim));continue}const[g,j]=[await v(r.junction.from),await v(r.part)];Z.push(g===void 0||j===void 0?void 0:await en({out:g,in:j,transition:r.junction.transition,fps:l,frames:r.frames,encode:u,ffmpeg:e}))}}const Be=await Promise.all(E.map((e,t)=>{const n=Z[t];return K&&n?K.get(n,P):Promise.resolve(void 0)})),Ee=e=>e>0?e*he/(l*_):0,st=(e,t,n)=>e.junction?Ot(t,n/l,l):n/l,Ce=(e,t,n,o)=>Tt(t.part,t.plane,st(e,t.part,n)+Ee(o)),ye=E.map(e=>{const t=(e.junction?[e.junction.from,e.part]:[e.part]).map(i=>{const s=[];let k=0;return i.planes.forEach((m,O)=>{const x={part:i,plane:O,images:m.overlay===!0?1:_};let p=0;for(let v=e.first;v<e.first+e.frames;v++)for(let r=0;r<x.images;r++)Ce(e,x,v,r)&&p++;p!==0&&(s.push(x),k+=p)}),{part:i,planes:s.map(m=>m.plane),overlays:s.flatMap(m=>i.planes[m.plane]?.overlay===!0?[m.plane]:[]),groups:s,drawn:k,graphics:k>0}}),n=t.flatMap(i=>i.groups),o=n.length===0?_:n.reduce((i,s)=>i+s.images,0);return{pictures:t,groups:n,per:o,graphics:t.some(i=>i.graphics),drawn:t.reduce((i,s)=>i+s.drawn,0),images:e.frames*o}}),De=(e,t,n)=>{let o=n%e.per,i={part:t.part,plane:0,images:_};for(const s of e.groups){if(o<s.images){i=s;break}o-=s.images}return{f:t.first+Math.floor(n/e.per),k:o,group:i}},it=(e,t,n)=>{const o=De(e,t,n);return Ce(t,o.group,o.f,o.k)};let ke=0;ye.forEach((e,t)=>{Be[t]===void 0&&(ke+=e.drawn)}),h.plan=A(q);const Re=a.openPage===void 0?L.length:Math.max(L.length,ke===0?1:Math.min(a.workers??zt(ke),Kt));h.workers=Re;const se=new rn;for(const e of L)se.add(e);const ct=async e=>{const t=[];for(const n of L)for(const o of await n.problems())o.level!=="error"||o.code==="AK-P002"||o.part!==void 0&&!e.has(o.part)||t.push(o);return ln(t)},ft=performance.now(),Ie=a.openPage;for(let e=L.length;Ie&&e<Re;e++){const t=Ie().then(n=>{_e.push(n),L.push(n),se.add(n),h.pages=A(ft)});t.catch(()=>{}),le.push(t)}const ut=sn(),be=a.sound,D=d==="gif"||be===void 0?void 0:S(H,"audio.wav"),He=async()=>{if(D===void 0||be===void 0)return;const e=performance.now(),t=await fn({timeline:b,sound:be,out:D,ffmpeg:y});return h.mix=A(e),t};ut||(N=He(),N.catch(()=>{}));const dt=Ht(b.width,b.height),Ke=ye.reduce((e,t)=>e+t.images,0);let J=0,ze=-1;const ve=()=>{const e=Math.floor(90*J/Ke);e<=ze||(ze=e,a.onProgress?.(.9*J/Ke))},ee=S(H,"frames");P==="png"&&await yt(ee,{recursive:!0});const ie=E.map((e,t)=>S(H,`segment.${String(t).padStart(4,"0")}.${P}`));let We=0,Le=0;const Pe=new AbortController,F=a.signal?AbortSignal.any([Pe.signal,a.signal]):Pe.signal,Ve=an();h.concurrency=Math.max(1,Math.min(Ve.limit,Be.filter(e=>e===void 0).length));const lt=performance.now(),Je=(e,t,n)=>de(y,["-v","error","-y","-i",e,"-map","0:v","-c","copy","-frames:v",String(n),...ge,t]),mt=async(e,t)=>{const n=ye[e];if(!n)return;const o=n.graphics,i=n.images,s={key:t.junction?`${t.junction.from.key}>${t.part.key}`:t.part.key,...t.junction?{junction:!0}:{},frames:t.frames,cached:!1,images:o?i:0,captured:0,reused:0,clear:0,capture:0,ffmpeg:0,waitFrames:0,waitPipe:0,start:0,end:0},k=t.junction?void 0:Te.get(t.part.key);k!==void 0&&(s.keyed=k),h.part[e]=s;const m={captured:0,reused:0},O=new Map,x=c=>{let f=O.get(c);return f||(f=new Map,O.set(c,f)),f},p=P==="png"?S(ee,"frame.%05d.png"):ie[e]??"",v={...M.capture?{capture:M.capture}:{},...M.post?.filter?{post:M.post.filter}:{},...oe?{lut:oe}:{},tail:ae},r=c=>({planes:n.pictures[c]?.planes??[],overlays:n.pictures[c]?.overlays??[]}),u=c=>Ve.run(async()=>{F.throwIfAborted(),s.start=A(me);const f=C?`${c}.held.${P}`:void 0,Me=()=>["-v","error","-y",...Jt(t.junction?Yt({timeline:b,transition:t.junction.transition,first:t.first,frames:t.frames,sources:Oe,alpha:Y,out:r(0),in:r(1),samples:_,...v}):Rt({timeline:b,first:t.first,frames:t.frames,sources:Oe,alpha:Y,planes:n.pictures[0]?.planes??[],overlays:n.pictures[0]?.overlays??[],samples:_,part:t.part,...v}),f!==void 0),...G(t.frames),...P==="png"?["-start_number",String(t.first+1)]:[],c,...f===void 0?[]:["-map",`[${Vt}]`,"-frames:v",String(t.frames),...G(t.frames,!0),f]],z=performance.now();let R=n.drawn<i||n.groups.length>1;for(;;){const $e=new Ze(R);let te=0,W=0;try{await tt(y,Me(),o?async ce=>{await on({count:i,ahead:Math.max(8,se.size*4),draw:ne=>{if(!it(n,t,ne))return s.clear++,W++,Promise.resolve(dt);const{f:je,k:fe,group:ue}=De(n,t,ne);return se.use([e,ne],async wt=>{F.throwIfAborted();const ht=performance.now(),gt=await wt.frame(je/l,{format:"png",alpha:!0,...qt(ue.part,ue.plane),...t.junction?{part:ue.part.key}:{},reuse:x(ue.part.key),stats:m,...fe>0?{offset:Ee(fe)}:{}});return s.capture+=(performance.now()-ht)/1e3,gt})},emit:async ne=>{const je=$e.next(ne),fe=performance.now();await dn(ce,je),s.waitPipe+=(performance.now()-fe)/1e3,J++,te++,ve()},waits:s,signal:F})}:void 0,!1,F);break}catch(ce){if(!(ce instanceof Ze.Mixed)||R)throw f!==void 0&&await re(f,{force:!0}),ce;R=!0}J-=te,s.clear-=W}if(C&&f!==void 0&&(await Ct(c,C,l,T)?(await Pt(f,c),s.held=!0):await re(f,{force:!0})),s.ffmpeg=A(z),o||(J+=i,ve()),o){const $e=new Set(t.junction?[t.junction.from.key,t.part.key]:[t.part.key]),te=await ct($e);if(te.length>0)throw new Ut("draw-failed",`Drawing ${s.key} failed, so it is not rendered: ${te.map(W=>`${W.code} ${W.message}${W.t===void 0?"":` (at ${W.t.toFixed(2)} s)`}`).join("; ")}`,{exit:St.failed,hint:"allyhub frames --at and allyhub inspect layout --at draw that moment; fix what failed and render again."})}}),g=t.keep<t.frames,j=Z[e];if(K&&j){const c=await K.segment(j,P,u);g?await Je(c.file,p,t.keep):await nn(c.file,p),c.cached&&(t.junction?Le++:We++,s.cached=!0,J+=i,ve())}else if(g){const c=S(H,`whole.${String(e).padStart(4,"0")}.${P}`);await u(c),await Je(c,p,t.keep),await re(c,{force:!0})}else await u(p);s.captured=m.captured,s.reused=m.reused,s.end=A(me)},Ue=(await Promise.allSettled(E.map((e,t)=>mt(t,e).catch(n=>{throw Pe.abort(n),n})))).find(e=>e.status==="rejected");if(Ue)throw Ue.reason;await Promise.all(le),h.parts=A(lt);const $=await(N??He()),xe=$?.loudness;a.onProgress?.(.95),F.throwIfAborted();const pt=performance.now();let U;if(d==="png"){const e=a.out.replace(/\.png$/,"");U=[];const t=(await bt(ee)).filter(n=>/^frame\.\d+\.png$/.test(n)).sort();for(const n of t){F.throwIfAborted();const o=`${e}.${n.slice(6)}`;V.push(o),await Ne(S(ee,n),o),U.push(o)}D&&xe&&(V.push(`${e}.wav`),await Ne(D,`${e}.wav`),U.push(`${e}.wav`))}else if(d==="gif")V.push(a.out),await de(y,["-v","error","-y","-framerate",pe.text,"-start_number","1","-i",S(ee,"frame.%05d.png"),"-filter_complex","split[a][b];[a]palettegen=stats_mode=diff[p];[b][p]paletteuse=dither=sierra2_4a","-r",pe.text,"-loop","0",a.out],void 0,F);else{if(C){const n=C.bufferKbps*1e3;let o=Bt*n;for(const[i,s]of ie.entries()){const k=await Ge(s,T);if(!k)continue;const m=qe(k,C,l,o);if(!m.breaks){o=m.end;continue}const O=G(k.length,!0,o/n),x=r=>de(y,["-v","error","-y","-i",s,"-an",...O,r],void 0,F);let p=S(H,`held.${String(i)}.mp4`);const v=Z[i];K&&v?p=(await K.segment(nt(Buffer.from(JSON.stringify(["held across the join",v,O]))),P,x)).file:await x(p),ie[i]=p,h.capped=(h.capped??0)+1,o=qe(await Ge(p,T)??k,C,l,o).end}}const e=S(H,"segments.txt");await Mt(e,ie.map(n=>`file '${n.replace(/'/g,"'\\''")}'
+`).join(""));const t=d==="mov"?["-c:a","pcm_s24le"]:d==="webm"?["-c:a","libopus","-b:a",`${String(a.encode?.audioBitrate??160)}k`]:["-c:a","aac","-b:a",`${String(a.encode?.audioBitrate??192)}k`];V.push(a.out),await de(y,["-v","error","-y","-f","concat","-safe","0","-i",e,...D===void 0?[]:["-i",D],"-map","0:v",...D===void 0?[]:["-map","1:a"],"-c:v","copy",...D===void 0?[]:t,...d==="mp4"||d==="mov"?["-movflags","+faststart"]:[],...ge,a.out],void 0,F)}V.length=0,h.mux=A(pt),a.onProgress?.(1);const Xe=U??[a.out];let Ye=0;for(const e of Xe)Ye+=(await xt(e)).size;return{out:Xe[0]??a.out,frames:Fe,duration:Fe/l,bytes:Ye,...xe?{loudness:xe}:{},...$?.gainDb!==void 0?{master:{...$.before?{before:$.before}:{},gainDb:$.gainDb,...$.limited===void 0?{}:{limited:$.limited},target:$.target,...$.rounds===void 0?{}:{rounds:$.rounds}}}:{},...U?{files:U}:{},parts:{total:E.filter(e=>!e.junction).length,cached:We},...E.some(e=>e.junction)?{junctions:{total:E.filter(e=>e.junction).length,cached:Le}}:{},timings:{...h,total:A(me),part:h.part.map(e=>({...e,capture:Math.round(e.capture*1e3)/1e3,waitFrames:Math.round(e.waitFrames*1e3)/1e3,waitPipe:Math.round(e.waitPipe*1e3)/1e3}))}}}finally{await Promise.allSettled([...le,...N?[N]:[]]),await rt(),await Promise.all(V.map(q=>re(q,{force:!0}))),await re(H,{recursive:!0,force:!0})}}

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

@@ -1,6 +1,6 @@
 {
   "name": "@allyhub-next/render",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "exports": {
     ".": {