allyhub 0.2.0 → 0.4.0

package/node_modules/@allyhub-next/video-core/dist/problem.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-export const RULES={"AK-M001":{level:"error",rule:"The fields of video(), slides() or defineComponent do not match the format"},"AK-M002":{level:"error",rule:"A piece is not the entry file of an item folder"},"AK-M003":{level:"error",rule:"An item's entry file does not match its folder or its kind"},"AK-M004":{level:"error",rule:"The project has no pieces"},"AK-M006":{level:"error",rule:"A messages file does not match the format"},"AK-M007":{level:"error",rule:"A script file does not match the format"},"AK-M008":{level:"error",rule:"A doc's file is not MDX, holds what a doc does not draw, or is not an item of its own"},"AK-M009":{level:"error",rule:"A sheet cannot be read as it says: its file is not CSV a sheet can read, a value is not its column's type, or its spec does not match the format"},"AK-M010":{level:"error",rule:"A video item reaches itself through the videos it shows (a screen, a video take, a footage of a video item)"},"AK-B001":{level:"error",rule:"Two pieces have the same id"},"AK-B003":{level:"error",rule:"The build made a network request"},"AK-B004":{level:"error",rule:"The build timed out, or its result is over the size limit"},"AK-B005":{level:"error",rule:"An import of a file outside the project, or of a package not declared in package.json"},"AK-B006":{level:"error",rule:"An import of an @allyhub/sdk entry point that does not exist"},"AK-B008":{level:"error",rule:"The project's @allyhub/sdk is another version than the allyhub that builds it"},"AK-B009":{level:"error",rule:"The project's package.json declares AllyHub, but its packages are not installed"},"AK-K001":{level:"error",rule:"Two parts have the same key"},"AK-K003":{level:"error",rule:"The output has no parts"},"AK-D002":{level:"error",rule:"The same frame has different pixels when drawn in order and out of order"},"AK-N003":{level:"error",rule:"The sandbox blocked a request at run time"},"AK-S001":{level:"error",rule:"The code reads a key that is missing in the default language too"},"AK-T001":{level:"error",rule:"A take has no word times beside it (<name>.words.json)"},"AK-T002":{level:"error",rule:"A say part has no generated file for its text, voice and tool"},"AK-T003":{level:"error",rule:"A take's range phrase, or the line a part is saying, is not found in the take"},"AK-T004":{level:"error",rule:"A word reference is not in its part's words, or an anchor is not in its line"},"AK-T005":{level:"error",rule:"A take's edits file is missing or does not match the format, or an edit's words are no longer in the take"},"AK-T006":{level:"error",rule:"A take's range phrase, or the line a part is saying, is said in words the take's edits remove"},"AK-T007":{level:"error",rule:"A part says a line its generated voice was not made from"},"AK-F001":{level:"error",rule:"The video is longer than its platform profile takes"},"AK-A001":{level:"error",rule:"A referenced media or data file does not exist"},"AK-A003":{level:"error",rule:"Wrong media type"},"AK-A005":{level:"error",rule:"A layer draws a picture that does not load: its source is not a file the stage serves, or not a picture"},"AK-P002":{level:"error",rule:"Loading took longer than the piece's loadLimit (default 10 seconds)"},"AK-P003":{level:"error",rule:"A moment did not finish drawing within the piece's seekLimit (default 30 seconds): work a layer waits for (ctx.wait) or a picture it shows never settled"},"AK-R001":{level:"error",rule:"An unhandled exception was thrown at run time"},"AK-R003":{level:"error",rule:"The page was changed outside the stage"},"AK-R004":{level:"error",rule:"The code sets a style value the browser does not accept, so the style does not apply"},"AK-G001":{level:"error",rule:"Unknown format: not one of the four presets or WIDTHxHEIGHT (a4 and letter for paged outputs only, and even sides for video)"},"AK-X001":{level:"error",rule:"The matrix's slots, structures, rules or combos name something that does not exist, or a combo lacks a slot of its structure"},"AK-X002":{level:"error",rule:"The matrix's rules leave no combination to make, or rule out a combo matrix.combos names"},"AK-X004":{level:"error",rule:"Two chosen combos are the same, or more alike than the matrix's differ allows"},"AK-X005":{level:"error",rule:"A part reads another slot's pick, so one render of it cannot serve every combo"},"AK-X006":{level:"error",rule:"A combo is longer than its output's maxDuration"},"AK-W001":{level:"error",rule:"A scenery does not build: its module's export is not a scenery, its build throws or does not finish, or its update throws"},"AK-W002":{level:"error",rule:"WebGL cannot be made or is lost, or draws on something other than SwiftShader where the CPU was asked for (--cpu, ALLYHUB_GPU=0, or the default off macOS)"},"AK-W003":{level:"error",rule:"A model, texture, environment or splat file does not load, names a file that is not there, or needs a decoder AllyHub does not lend"},"AK-W004":{level:"error",rule:"A camera cannot be drawn: a number that is not finite, a target at its position, a view along its up, a field of view outside (0°, 180°), or near and far planes out of order"},"AK-W005":{level:"error",rule:"A name a camera, a move or a measurement refers to names no object in the scenery, or names two"},"AK-W006":{level:"error",rule:"A material's shader does not compile or link on this renderer, or needs more texture units than the renderer has, so what uses it draws nothing (warn: more than the 16 a GPU may have)"},"AK-W008":{level:"error",rule:"A screen drawn in the scenery cannot show its element as it is: an element of it is in the browser's top layer (a modal dialog, a popover), planes of a preserve-3d context overlap, its element is larger than the largest texture, or its picture could not be copied"},"AK-S002":{level:"warn",rule:"Missing translation"},"AK-L002":{level:"warn",rule:"Text overflows the frame or is clipped"},"AK-L003":{level:"warn",rule:"Missing glyphs"},"AK-L006":{level:"warn",rule:"Text is drawn in a fallback font, or in a bold or italic the font does not have"},"AK-W007":{level:"warn",rule:"A screen asked to be drawn in the scenery is drawn over it, unlit and untoned: this browser cannot draw an element into a canvas (Chrome's HTML-in-Canvas), or ALLYHUB_HTML_IN_CANVAS=0"}};export function problem(e,r,o={}){const{level:t,...l}=o;return{code:e,level:t??RULES[e].level,message:r,...l}}export function countLevels(e){let r=0,o=0;for(const t of e)t.level==="error"?r++:o++;return{errors:r,warnings:o}}
+export const RULES={"AK-M001":{level:"error",rule:"The fields of video(), slides() or defineComponent do not match the format"},"AK-M002":{level:"error",rule:"A piece is not the entry file of an item folder"},"AK-M003":{level:"error",rule:"An item's entry file does not match its folder or its kind"},"AK-M004":{level:"error",rule:"The project has no pieces"},"AK-M006":{level:"error",rule:"A messages file does not match the format"},"AK-M007":{level:"error",rule:"A script file does not match the format"},"AK-M008":{level:"error",rule:"A doc's file is not MDX, holds what a doc does not draw, or is not an item of its own"},"AK-M009":{level:"error",rule:"A sheet cannot be read as it says: its file is not CSV a sheet can read, a value is not its column's type, or its spec does not match the format"},"AK-M010":{level:"error",rule:"A video item reaches itself through the videos it shows (a screen, a video take, a footage of a video item)"},"AK-M011":{level:"error",rule:"A deck's slides.yaml does not match the format, or names a layout, a prop, a file or a video item the deck does not have"},"AK-B001":{level:"error",rule:"Two pieces have the same id"},"AK-B003":{level:"error",rule:"The build made a network request"},"AK-B004":{level:"error",rule:"The build timed out, or its result is over the size limit"},"AK-B005":{level:"error",rule:"An import of a file outside the project, or of a package not declared in package.json"},"AK-B006":{level:"error",rule:"An import of an @allyhub/sdk entry point that does not exist"},"AK-B008":{level:"error",rule:"The project's @allyhub/sdk is another version than the allyhub that builds it"},"AK-B009":{level:"error",rule:"The project's package.json declares AllyHub, but its packages are not installed"},"AK-B010":{level:"error",rule:"A 3D model does not build"},"AK-K001":{level:"error",rule:"Two parts have the same key"},"AK-K003":{level:"error",rule:"The output has no parts"},"AK-D002":{level:"error",rule:"The same frame has different pixels when drawn in order and out of order"},"AK-N003":{level:"error",rule:"The sandbox blocked a request at run time"},"AK-S001":{level:"error",rule:"The code reads a key that is missing in the default language too"},"AK-T001":{level:"error",rule:"A take has no word times beside it (<name>.words.json)"},"AK-T002":{level:"error",rule:"A say part has no generated file for its text, voice and tool"},"AK-T003":{level:"error",rule:"A take's range phrase, or the line a part is saying, is not found in the take"},"AK-T004":{level:"error",rule:"A word reference is not in its part's words, or an anchor is not in its line"},"AK-T005":{level:"error",rule:"A take's edits file is missing or does not match the format, or an edit's words are no longer in the take"},"AK-T006":{level:"error",rule:"A take's range phrase, or the line a part is saying, is said in words the take's edits remove"},"AK-T007":{level:"error",rule:"A part says a line its generated voice was not made from"},"AK-F001":{level:"error",rule:"The video is longer than its platform profile takes"},"AK-A001":{level:"error",rule:"A referenced media or data file does not exist"},"AK-A003":{level:"error",rule:"Wrong media type"},"AK-A005":{level:"error",rule:"A layer draws a picture that does not load: its source is not a file the stage serves, or not a picture"},"AK-P002":{level:"error",rule:"Loading took longer than the piece's loadLimit (default 10 seconds)"},"AK-P003":{level:"error",rule:"A moment did not finish drawing within the piece's seekLimit (default 30 seconds): work a layer waits for (ctx.wait) or a picture it shows never settled"},"AK-R001":{level:"error",rule:"An unhandled exception was thrown at run time"},"AK-R003":{level:"error",rule:"The page was changed outside the stage"},"AK-R004":{level:"error",rule:"The code sets a style value the browser does not accept, so the style does not apply"},"AK-G001":{level:"error",rule:"Unknown format: not one of the four presets, a platform profile or WIDTHxHEIGHT with even sides"},"AK-X001":{level:"error",rule:"The matrix's slots, structures, rules or combos name something that does not exist, or a combo lacks a slot of its structure"},"AK-X002":{level:"error",rule:"The matrix's rules leave no combination to make, or rule out a combo matrix.combos names"},"AK-X004":{level:"error",rule:"Two chosen combos are the same, or more alike than the matrix's differ allows"},"AK-X005":{level:"error",rule:"A part reads another slot's pick, so one render of it cannot serve every combo"},"AK-X006":{level:"error",rule:"A combo is longer than its output's maxDuration"},"AK-W001":{level:"error",rule:"A scenery does not build: its module's export is not a scenery, its build throws or does not finish, or its update throws"},"AK-W002":{level:"error",rule:"WebGL cannot be made or is lost, or draws on something other than SwiftShader where the CPU was asked for (--cpu, ALLYHUB_GPU=0, or the default off macOS)"},"AK-W003":{level:"error",rule:"A model, texture, environment or splat file does not load, names a file that is not there, or needs a decoder AllyHub does not lend"},"AK-W004":{level:"error",rule:"A camera cannot be drawn: a number that is not finite, a target at its position, a view along its up, a field of view outside (0°, 180°), or near and far planes out of order"},"AK-W005":{level:"error",rule:"A name a camera, a move or a measurement refers to names no object in the scenery, or names two"},"AK-W006":{level:"error",rule:"A material's shader does not compile or link on this renderer, or needs more texture units than the renderer has, so what uses it draws nothing (warn: more than the 16 a GPU may have)"},"AK-W008":{level:"error",rule:"A screen drawn in the scenery cannot show its element as it is: an element of it is in the browser's top layer (a modal dialog, a popover), planes of a preserve-3d context overlap, its element is larger than the largest texture, or its picture could not be copied"},"AK-S002":{level:"warn",rule:"Missing translation"},"AK-L002":{level:"warn",rule:"Text overflows the frame or is clipped"},"AK-L003":{level:"warn",rule:"Missing glyphs"},"AK-L006":{level:"warn",rule:"Text is drawn in a fallback font, or in a bold or italic the font does not have"},"AK-W007":{level:"warn",rule:"A screen asked to be drawn in the scenery is drawn over it, unlit and untoned: this browser cannot draw an element into a canvas (Chrome's HTML-in-Canvas), or ALLYHUB_HTML_IN_CANVAS=0"}};export function problem(e,r,o={}){const{level:t,...l}=o;return{code:e,level:t??RULES[e].level,message:r,...l}}export function countLevels(e){let r=0,o=0;for(const t of e)t.level==="error"?r++:o++;return{errors:r,warnings:o}}

package/node_modules/@allyhub-next/video-core/dist/schema.d.ts

@@ -206,7 +206,6 @@ export type VideoOptionsMeta = z.infer<typeof VideoOptionsMeta>;
 export declare const OutputMeta: z.ZodObject<{
     kind: z.ZodEnum<{
         video: "video";
-        paged: "paged";
     }>;
     options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 }, z.core.$strict>;
@@ -252,7 +251,6 @@ export declare const PieceMeta: z.ZodObject<{
     outputs: z.ZodRecord<z.ZodString, z.ZodObject<{
         kind: z.ZodEnum<{
             video: "video";
-            paged: "paged";
         }>;
         options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, z.core.$strict>>;

package/node_modules/@allyhub-next/video-core/dist/script-edit.d.ts

@@ -62,6 +62,7 @@ export declare const draftEdit: {
             parts: ScriptPart[];
             title?: string;
             text?: Record<string, ScriptText>;
+            slides?: import("./script.js").ScriptSlide[];
         };
         id: string;
     };
@@ -84,6 +85,7 @@ export declare const draftEdit: {
             parts: ScriptPart[];
             title?: string;
             text?: Record<string, ScriptText>;
+            slides?: import("./script.js").ScriptSlide[];
         };
         caret: undefined;
     };
@@ -99,6 +101,7 @@ export declare const draftEdit: {
             parts: ScriptPart[];
             title?: string;
             text?: Record<string, ScriptText>;
+            slides?: import("./script.js").ScriptSlide[];
         };
         caret: {
             id: string;
@@ -119,6 +122,7 @@ export declare const draftEdit: {
             parts: ScriptPart[];
             title?: string;
             text?: Record<string, ScriptText>;
+            slides?: import("./script.js").ScriptSlide[];
         };
         id: string;
     };

package/node_modules/@allyhub-next/video-core/dist/script.d.ts

@@ -15,12 +15,20 @@ export interface ScriptPart {
     /** What it shows, by name. */
     screen?: Record<string, ScriptText>;
 }
+/** A deck's slide in its script: its shapes' words by name, and its notes. */
+export interface ScriptSlide {
+    id: string;
+    text?: Record<string, ScriptText>;
+    notes?: string | VariantsMessage;
+}
 export interface ScriptFile {
     title?: string;
     /** The item's words that belong to no part, by name. */
     text?: Record<string, ScriptText>;
     /** In the order they are told; the piece's code decides the video's. */
     parts: ScriptPart[];
+    /** A deck's slides; its slides.yaml decides their order. */
+    slides?: ScriptSlide[];
 }
 /** Where a value sits in the script's document: ["parts", 0, "screen", "line1"]. */
 export type ScriptPath = (string | number)[];

package/node_modules/@allyhub-next/video-core/dist/script.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{hasAnchors as $,hasSpans as A,readAnchors as b,spokenLine as k}from"./anchors.js";import{isSpoken as h}from"./messages.js";export const SCRIPT_FILE=/^script\.([a-z]{2,3}(?:-[a-z0-9]{2,8})?)\.ya?ml$/;const g=/^[A-Za-z0-9_-]+$/,m=e=>typeof e=="object"&&e!==null&&!Array.isArray(e),j=e=>e.length===0?"(root)":e.map((i,n)=>typeof i=="number"?`[${String(i)}]`:`${n?".":""}${i}`).join("");function O(e){const i=c=>Array.isArray(c)&&c.every(o=>typeof o=="string"),n=e.match;if(!m(n)||!Object.values(n).every(c=>typeof c=="string"))return"match must map each case to its text";const f=e.declarations??[],l=e.selectors??[];if(!i(f)||!i(l))return"declarations and selectors must be lists of strings";const p=Object.keys(e).filter(c=>!["declarations","selectors","match"].includes(c));return p.length>0?`unknown key ${p.join(", ")}`:{declarations:f,selectors:l,match:n}}function S(e){if(typeof e=="string")return e;if(h(e))return Object.keys(e).length===2?e:"has more than display and speak";if(m(e)&&"match"in e)return O(e)}export function parseScript(e){const i=[],n=(t,s)=>{i.push(`${j(t)}: ${s}`)},f=(t,s)=>{const r=S(t);if(r===void 0||typeof r=="string"&&r!==t){n(s,typeof r=="string"?r:typeof t=="number"||typeof t=="boolean"?`${String(t)} is not text: put it in quotes`:"must be text, { display, speak }, or a plural or selection");return}return r},l=(t,s)=>{if(!m(t)){n(s,"must be names with their text");return}const r={};for(const[a,u]of Object.entries(t)){const y=p(u,[...s,a]);g.test(a)?y!==void 0&&(r[a]=y):n([...s,a],"a name has only letters, digits, _ and -")}return r},p=(t,s)=>{if(Array.isArray(t)){const r=t.map((a,u)=>p(a,[...s,u]));return r.every(a=>a!==void 0)?r:void 0}return m(t)&&!h(t)&&!("match"in t)?l(t,s):f(t,s)};if(e==null)return{script:{parts:[]}};if(!m(e))return{problems:["(root): must be title, text and parts"]};const c={parts:[]};for(const t of Object.keys(e))["title","text","parts"].includes(t)||n([t],"unknown key: a script has title, text and parts");if(e.title!==void 0&&(typeof e.title=="string"?c.title=e.title:n(["title"],"must be text")),e.text!==void 0){const t=l(e.text,["text"]);t&&(c.text=t)}const o=e.parts??[];if(!Array.isArray(o))n(["parts"],"must be a list of parts");else{const t=new Set;o.forEach((s,r)=>{const a=["parts",r];if(!m(s)){n(a,"must be a part: id, say, screen");return}for(const d of Object.keys(s))["id","say","screen"].includes(d)||n([...a,d],"unknown key: a part has id, say and screen");const u=s.id;if(typeof u!="string"||!g.test(u)){n([...a,"id"],"a part needs an id of letters, digits, _ and -");return}if(t.has(u)){n([...a,"id"],`two parts have the id ${u}`);return}t.add(u);const y={id:u};if(s.say!==void 0){const d=f(s.say,[...a,"say"]);if(h(d))n([...a,"say"],"is one line: write a piece that is shown one way and said another inside it, as <shown|said>");else if(d!==void 0){y.say=d;for(const x of E(d))n([...a,"say"],x)}}if(s.screen!==void 0){const d=l(s.screen,[...a,"screen"]);d&&(y.screen=d)}c.parts.push(y)})}return i.length>0?{problems:i}:{script:c}}function E(e){return typeof e=="string"?b(e).problems:h(e)?[]:Object.values(e.match).some(i=>$(i)||A(i))?["a plural or a selection cannot have anchors or <shown|said>"]:[]}export function saidOf(e){if(typeof e!="string")return{value:e,anchors:[]};const i=b(e);if(i.spans.length===0)return{value:i.text,anchors:i.anchors};const n=k(i);return{value:{display:i.text,speak:n.text},anchors:i.anchors.map(f=>({name:f.name,at:n.at(f.at,!1),...f.end===void 0?{}:{end:n.at(f.end,!0)}}))}}const w=e=>typeof e=="string"||!Array.isArray(e)&&(h(e)||"match"in e);export function scriptKeys(e,i){const n=[],f=new Set,l=[],p=(o,t,s,r=[])=>{f.has(o)?l.push(o):(f.add(o),n.push({key:o,value:t,path:s,...r.length>0?{anchors:r}:{}}))},c=(o,t,s)=>{if(w(t))p(o,t,s);else if(Array.isArray(t))t.forEach((r,a)=>{c(`${o}.${String(a)}`,r,[...s,a])});else for(const[r,a]of Object.entries(t))c(`${o}.${r}`,a,[...s,r])};i.title!==void 0&&p(`${e}.title`,i.title,["title"]);for(const[o,t]of Object.entries(i.text??{}))c(`${e}.${o}`,t,["text",o]);return i.parts.forEach((o,t)=>{const s=`${e}.${o.id}`;if(o.say!==void 0){const r=saidOf(o.say);p(`${s}.say`,r.value,["parts",t,"say"],r.anchors)}for(const[r,a]of Object.entries(o.screen??{}))c(`${s}.${r}`,a,["parts",t,"screen",r])}),{keys:n,twice:l}}export function scriptMessages(e,i){return Object.fromEntries(scriptKeys(e,i).keys.map(n=>[n.key,n.value]))}
+import{hasAnchors as k,hasSpans as A,readAnchors as $,spokenLine as j}from"./anchors.js";import{isSpoken as x}from"./messages.js";export const SCRIPT_FILE=/^script\.([a-z]{2,3}(?:-[a-z0-9]{2,8})?)\.ya?ml$/;const g=/^[A-Za-z0-9_-]+$/,b=e=>typeof e=="object"&&e!==null&&!Array.isArray(e),O=e=>e.length===0?"(root)":e.map((r,s)=>typeof r=="number"?`[${String(r)}]`:`${s?".":""}${r}`).join("");function S(e){const r=c=>Array.isArray(c)&&c.every(o=>typeof o=="string"),s=e.match;if(!b(s)||!Object.values(s).every(c=>typeof c=="string"))return"match must map each case to its text";const u=e.declarations??[],h=e.selectors??[];if(!r(u)||!r(h))return"declarations and selectors must be lists of strings";const m=Object.keys(e).filter(c=>!["declarations","selectors","match"].includes(c));return m.length>0?`unknown key ${m.join(", ")}`:{declarations:u,selectors:h,match:s}}function E(e){if(typeof e=="string")return e;if(x(e))return Object.keys(e).length===2?e:"has more than display and speak";if(b(e)&&"match"in e)return S(e)}export function parseScript(e){const r=[],s=(t,n)=>{r.push(`${O(t)}: ${n}`)},u=(t,n)=>{const i=E(t);if(i===void 0||typeof i=="string"&&i!==t){s(n,typeof i=="string"?i:typeof t=="number"||typeof t=="boolean"?`${String(t)} is not text: put it in quotes`:"must be text, { display, speak }, or a plural or selection");return}return i},h=(t,n)=>{if(!b(t)){s(n,"must be names with their text");return}const i={};for(const[a,d]of Object.entries(t)){const y=m(d,[...n,a]);g.test(a)?y!==void 0&&(i[a]=y):s([...n,a],"a name has only letters, digits, _ and -")}return i},m=(t,n)=>{if(Array.isArray(t)){const i=t.map((a,d)=>m(a,[...n,d]));return i.every(a=>a!==void 0)?i:void 0}return b(t)&&!x(t)&&!("match"in t)?h(t,n):u(t,n)};if(e==null)return{script:{parts:[]}};if(!b(e))return{problems:["(root): must be title, text and parts"]};const c={parts:[]};for(const t of Object.keys(e))["title","text","parts","slides"].includes(t)||s([t],"unknown key: a script has title, text, parts and slides");if(e.title!==void 0&&(typeof e.title=="string"?c.title=e.title:s(["title"],"must be text")),e.text!==void 0){const t=h(e.text,["text"]);t&&(c.text=t)}const o=e.parts??[];if(!Array.isArray(o))s(["parts"],"must be a list of parts");else{const t=new Set;o.forEach((n,i)=>{const a=["parts",i];if(!b(n)){s(a,"must be a part: id, say, screen");return}for(const l of Object.keys(n))["id","say","screen"].includes(l)||s([...a,l],"unknown key: a part has id, say and screen");const d=n.id;if(typeof d!="string"||!g.test(d)){s([...a,"id"],"a part needs an id of letters, digits, _ and -");return}if(t.has(d)){s([...a,"id"],`two parts have the id ${d}`);return}t.add(d);const y={id:d};if(n.say!==void 0){const l=u(n.say,[...a,"say"]);if(x(l))s([...a,"say"],"is one line: write a piece that is shown one way and said another inside it, as <shown|said>");else if(l!==void 0){y.say=l;for(const p of w(l))s([...a,"say"],p)}}if(n.screen!==void 0){const l=h(n.screen,[...a,"screen"]);l&&(y.screen=l)}c.parts.push(y)})}const f=e.slides??[];if(!Array.isArray(f))s(["slides"],"must be a list of slides");else{const t=new Set,n=[];f.forEach((i,a)=>{const d=["slides",a];if(!b(i)){s(d,"must be a slide: id, text, notes");return}for(const p of Object.keys(i))["id","text","notes"].includes(p)||s([...d,p],"unknown key: a slide has id, text and notes");const y=i.id;if(typeof y!="string"||!g.test(y)){s([...d,"id"],"a slide needs an id of letters, digits, _ and -");return}if(t.has(y)){s([...d,"id"],`two slides have the id ${y}`);return}t.add(y);const l={id:y};if(i.text!==void 0){const p=h(i.text,[...d,"text"]);p&&(l.text=p)}if(i.notes!==void 0){const p=u(i.notes,[...d,"notes"]);typeof p=="string"||p!==void 0&&!x(p)?l.notes=p:p!==void 0&&s([...d,"notes"],"is text")}n.push(l)}),n.length>0&&(c.slides=n)}return r.length>0?{problems:r}:{script:c}}function w(e){return typeof e=="string"?$(e).problems:x(e)?[]:Object.values(e.match).some(r=>k(r)||A(r))?["a plural or a selection cannot have anchors or <shown|said>"]:[]}export function saidOf(e){if(typeof e!="string")return{value:e,anchors:[]};const r=$(e);if(r.spans.length===0)return{value:r.text,anchors:r.anchors};const s=j(r);return{value:{display:r.text,speak:s.text},anchors:r.anchors.map(u=>({name:u.name,at:s.at(u.at,!1),...u.end===void 0?{}:{end:s.at(u.end,!0)}}))}}const _=e=>typeof e=="string"||!Array.isArray(e)&&(x(e)||"match"in e);export function scriptKeys(e,r){const s=[],u=new Set,h=[],m=(o,f,t,n=[])=>{u.has(o)?h.push(o):(u.add(o),s.push({key:o,value:f,path:t,...n.length>0?{anchors:n}:{}}))},c=(o,f,t)=>{if(_(f))m(o,f,t);else if(Array.isArray(f))f.forEach((n,i)=>{c(`${o}.${String(i)}`,n,[...t,i])});else for(const[n,i]of Object.entries(f))c(`${o}.${n}`,i,[...t,n])};r.title!==void 0&&m(`${e}.title`,r.title,["title"]);for(const[o,f]of Object.entries(r.text??{}))c(`${e}.${o}`,f,["text",o]);return r.parts.forEach((o,f)=>{const t=`${e}.${o.id}`;if(o.say!==void 0){const n=saidOf(o.say);m(`${t}.say`,n.value,["parts",f,"say"],n.anchors)}for(const[n,i]of Object.entries(o.screen??{}))c(`${t}.${n}`,i,["parts",f,"screen",n])}),(r.slides??[]).forEach((o,f)=>{const t=`${e}.${o.id}`;for(const[n,i]of Object.entries(o.text??{}))c(`${t}.${n}`,i,["slides",f,"text",n]);o.notes!==void 0&&m(`${t}.notes`,o.notes,["slides",f,"notes"])}),{keys:s,twice:h}}export function scriptMessages(e,r){return Object.fromEntries(scriptKeys(e,r).keys.map(s=>[s.key,s.value]))}

package/node_modules/@allyhub-next/video-core/dist/timeline.d.ts

@@ -1,3 +1,4 @@
+import type { SlidesFile } from "@allyhub-next/formats";
 import { type TextAnchor } from "./anchors.js";
 import type { PlatformProfile } from "./formats.js";
 import type { Look } from "./look.js";
@@ -14,6 +15,8 @@ export interface LoadOptions {
     /** The combo: one value per dimension, e.g. { lang: "zh-cn" }. */
     combo: Combo;
     purpose: "play" | "render" | "check";
+    /** A deck drawn for its editor: an empty placeholder is drawn, to type into. */
+    editing?: boolean;
     /**
      * The most different console messages kept from piece code (see
      * console.ts); default CONSOLE_LIMIT.
@@ -28,6 +31,8 @@ export interface DataFile {
 }
 /** What the host hands load(): one piece, as the build made it. */
 export interface BuildSource {
+    /** What it is: a video (the default) or a deck, which the stage loads with the deck's runtime. */
+    kind?: "video" | "slides";
     /** The piece's id: seeds and problems use it. */
     piece: string;
     /**
@@ -71,6 +76,8 @@ export interface BuildSource {
     looks?: Record<string, Look>;
     /** The project's part defaults (allyhub.config.ts `defaults.part`). */
     partDefaults?: PartDefaults;
+    /** A deck's pages: its slides.yaml as the build read it (none when it has none, or it does not match the format). */
+    slides?: SlidesFile;
     /**
      * Every piece of the build by id, for a piece that shows another inside
      * it (a scenery's screen): its file, dimensions, format and matrix.
@@ -225,6 +232,10 @@ export interface Part {
     planes: PartPlane[];
     /** The part's still moment, absolute. */
     still: number;
+    /** A deck's page: each of its steps' still moments, absolute, step 0 first (the last is `still`). */
+    steps?: number[];
+    /** A deck's page left out when the deck is presented or exported (slides.yaml's `hidden`). */
+    hidden?: boolean;
     /** A name for people: part({ title }), else its largest text at its still that not every part shows. */
     title?: string;
     /** Voiced parts: where the speech plays. */
@@ -531,6 +542,8 @@ export interface Timeline {
      * loudness).
      */
     profile?: PlatformProfile;
+    /** A deck's paper (CSS `@page size`): its slide size, as PowerPoint prints it. */
+    paper?: string;
     duration: number;
     /**
      * What the footage plane draws under everything: the look's background
@@ -571,7 +584,7 @@ export interface PartText {
     speak?: string;
     /** The message key the spoken text came from (say(s(key)), saying(s(key))). */
     speechKey?: string;
-    /** A paged output's speaker notes for this page (`<prefix>.<page>.notes`). */
+    /** A deck's speaker notes for this slide (the script's `notes`). */
     notes?: string;
 }
 export interface MessageRead {
@@ -613,4 +626,24 @@ export declare function momentOf(tl: {
         readonly anchors?: readonly PartAnchor[] | undefined;
     }[];
 }, ref: string): number;
+/**
+ * What a moment shows that an editor lets a person point at
+ * (LoadedOutput.objects): what was placed on a deck's page (by its
+ * element's id) and every text block, with the message keys its words are
+ * (none: words written in code), each box in the frame's pixels.
+ */
+export interface PageObjects {
+    t: number;
+    elements: {
+        id: string;
+        box: [number, number, number, number];
+    }[];
+    texts: {
+        text: string;
+        box: [number, number, number, number];
+        /** Its font size as drawn, in the frame's pixels. */
+        size: number;
+        keys: string[];
+    }[];
+}
 //# sourceMappingURL=timeline.d.ts.map

package/node_modules/@allyhub-next/video-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allyhub-next/video-core",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "type": "module",
   "exports": {
     ".": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "allyhub",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "allyhub: what an agent runs to check, render, measure and look at a project's content, in any agent app.",
   "license": "SEE LICENSE IN LICENSE.md",
   "homepage": "https://allyhub.com",
@@ -41,7 +41,6 @@
     "dist",
     "bin",
     "editor-web",
-    "editor-app",
     "LICENSE.md",
     "NOTICE"
   ],
@@ -49,78 +48,74 @@
     "node": ">=22.19"
   },
   "dependencies": {
-    "@allyhub-next/audio": "0.2.0",
-    "@allyhub-next/browser": "0.2.0",
-    "@allyhub-next/build": "0.2.0",
-    "@allyhub-next/check": "0.2.0",
-    "@allyhub-next/cloud": "0.2.0",
-    "@allyhub-next/components": "0.2.0",
-    "@allyhub-next/dev-server": "0.2.0",
-    "@allyhub-next/doc": "0.2.0",
-    "@allyhub-next/export": "0.2.0",
-    "@allyhub-next/formats": "0.2.0",
-    "@allyhub-next/measure": "0.2.0",
-    "@allyhub-next/media": "0.2.0",
-    "@allyhub-next/model": "0.2.0",
-    "@allyhub-next/project": "0.2.0",
-    "@allyhub-next/protocol": "0.2.0",
-    "@allyhub-next/registry": "0.2.0",
-    "@allyhub-next/render": "0.2.0",
-    "@allyhub-next/runtime": "0.2.0",
-    "@allyhub-next/runtimes": "0.2.0",
-    "@allyhub-next/scaffold": "0.2.0",
-    "@allyhub-next/scenery": "0.2.0",
-    "@allyhub-next/scenery-host": "0.2.0",
-    "@allyhub-next/sheet": "0.2.0",
-    "@allyhub-next/site": "0.2.0",
-    "@allyhub-next/stage": "0.2.0",
-    "@allyhub-next/video-core": "0.2.0",
-    "@allyhub/sdk": "0.2.0",
+    "@allyhub-next/audio": "0.4.0",
+    "@allyhub-next/browser": "0.4.0",
+    "@allyhub-next/build": "0.4.0",
+    "@allyhub-next/check": "0.4.0",
+    "@allyhub-next/cloud": "0.4.0",
+    "@allyhub-next/components": "0.4.0",
+    "@allyhub-next/dev-server": "0.4.0",
+    "@allyhub-next/doc": "0.4.0",
+    "@allyhub-next/export": "0.4.0",
+    "@allyhub-next/formats": "0.4.0",
+    "@allyhub-next/measure": "0.4.0",
+    "@allyhub-next/media": "0.4.0",
+    "@allyhub-next/model": "0.4.0",
+    "@allyhub-next/project": "0.4.0",
+    "@allyhub-next/protocol": "0.4.0",
+    "@allyhub-next/registry": "0.4.0",
+    "@allyhub-next/render": "0.4.0",
+    "@allyhub-next/runtime": "0.4.0",
+    "@allyhub-next/runtimes": "0.4.0",
+    "@allyhub-next/scaffold": "0.4.0",
+    "@allyhub-next/scenery": "0.4.0",
+    "@allyhub-next/scenery-host": "0.4.0",
+    "@allyhub-next/sheet": "0.4.0",
+    "@allyhub-next/site": "0.4.0",
+    "@allyhub-next/slides-core": "0.4.0",
+    "@allyhub-next/slides-pptx": "0.4.0",
+    "@allyhub-next/slides-runtime": "0.4.0",
+    "@allyhub-next/stage": "0.4.0",
+    "@allyhub-next/stage-page": "0.4.0",
+    "@allyhub-next/video-core": "0.4.0",
+    "@allyhub/sdk": "0.4.0",
     "@fontsource-variable/commissioner": "^5.3.0",
     "@fontsource-variable/inter": "^5.3.0",
     "@fontsource-variable/jetbrains-mono": "^5.3.0",
     "@fontsource-variable/piazzolla": "^5.3.0",
     "@gltf-transform/core": "4.5.1",
     "@gltf-transform/extensions": "4.5.1",
-    "@gltf-transform/functions": "4.5.1",
     "@hono/node-server": "1.19.17",
     "@jridgewell/trace-mapping": "0.3.31",
-    "@modelcontextprotocol/sdk": "^1.32.1",
     "dequal": "2.0.3",
     "devtools-protocol": "0.0.1724436",
-    "draco3dgltf": "1.5.7",
     "env-paths": "4.0.0",
-    "exceljs": "4.4.0",
-    "gltf-validator": "2.0.0-dev.3.10",
+    "fast-xml-parser": "^5.11.2",
+    "fflate": "^0.8.3",
     "hono": "4.13.13",
     "ignore": "^7.0.5",
     "image-size": "^2.0.4",
     "jsonc-parser": "^3.3.1",
-    "manifold-3d": "3.5.4",
     "mdast-util-from-markdown": "^2.0.2",
     "mdast-util-gfm-strikethrough": "^2.0.0",
     "mdast-util-gfm-table": "^2.0.0",
     "mdast-util-gfm-task-list-item": "^2.0.0",
     "mdast-util-mdx": "^3.0.0",
-    "meshoptimizer": "1.3.0",
     "micromark-extension-gfm-strikethrough": "^2.1.0",
     "micromark-extension-gfm-table": "^2.1.1",
     "micromark-extension-gfm-task-list-item": "^2.1.0",
     "micromark-extension-mdxjs": "^3.0.0",
-    "onnxruntime-node": "1.30.0",
     "oxc-parser": "0.152.0",
     "pngjs": "^7.0.0",
     "pptxgenjs": "^4.0.1",
     "proper-lockfile": "4.1.2",
     "pure-rand": "8.4.2",
-    "sherpa-onnx-node": "1.13.8",
     "sirv": "^3.0.2",
     "tar": "^7.5.2",
-    "tesseract.js": "7.0.0",
-    "tesseract.js-core": "7.0.0",
     "three": "0.186.1",
     "three-mesh-bvh": "0.9.15",
     "vite": "8.3.5",
+    "wawoff2": "2.0.1",
     "write-file-atomic": "7.0.1",
     "ws": "8.22.0",
     "xatlas-web": "0.1.0",
@@ -130,7 +125,9 @@
   },
   "peerDependencies": {
     "@types/three": "0.186.0",
-    "astro": ">=7.3.8 <8"
+    "astro": ">=7.3.8 <8",
+    "docx": "9.15.1",
+    "exceljs": "4.4.0"
   },
   "peerDependenciesMeta": {
     "@types/three": {
@@ -138,6 +135,12 @@
     },
     "astro": {
       "optional": true
+    },
+    "docx": {
+      "optional": true
+    },
+    "exceljs": {
+      "optional": true
     }
   },
   "bundleDependencies": [
@@ -165,7 +168,11 @@
     "@allyhub-next/scenery-host",
     "@allyhub-next/sheet",
     "@allyhub-next/site",
+    "@allyhub-next/slides-core",
+    "@allyhub-next/slides-pptx",
+    "@allyhub-next/slides-runtime",
     "@allyhub-next/stage",
+    "@allyhub-next/stage-page",
     "@allyhub-next/video-core"
   ]
 }

package/dist/commands/mcp-app.js

@@ -1,3 +0,0 @@
-/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{readFile as b}from"node:fs/promises";import{dirname as v,join as x,relative as $,resolve as A,sep as u}from"node:path";import{fileURLToPath as O}from"node:url";import{z as S}from"zod";import{cardOf as T}from"@allyhub-next/dev-server";import{ITEM_KINDS as C}from"@allyhub-next/formats";import{CARD_META as E,CARD_RESOURCE as c,OPEN_TOOL as f,OpenInputSchema as w}from"@allyhub-next/protocol";import{CommandError as a}from"../command.js";import{indexing as N}from"../fields.js";import{projectAt as _,projectRoot as y}from"../project.js";import{start as I}from"./dev.js";const M=x(v(O(import.meta.url)),"../../editor-app/view.html"),j="text/html;profile=mcp-app",R=o=>{const e=S.toJSONSchema(o);return delete e.$schema,{...e,type:"object"}},g=(o,e,t=!1,r)=>({content:[{type:"text",text:e??JSON.stringify(o)}],structuredContent:o,...t?{isError:t}:{},...r===void 0?{}:{_meta:r}});export class CardApp{context;projects=new Map;constructor(e){this.context=e}tools(){return[{name:f,title:"AllyHub",description:"Shows the person an item of an AllyHub project (a video, a doc, a sheet, a 3D scenery): starts allyhub dev and gives the item's page, to open where your app shows web pages (your browser pane), else in the person's browser; the person sees and edits it there. With no path, the project's items. An app that draws MCP Apps also shows a card for it in the conversation.",inputSchema:R(w),_meta:{ui:{resourceUri:c},"ui/resourceUri":c}}]}resources(){return[{uri:c,name:"AllyHub card",description:"An item of an AllyHub project: its name, a preview and Open.",mimeType:j}]}async resource(){const e=await b(M,"utf8").catch(()=>{throw new a("missing","The card is missing from this allyhub: build the CLI again.")});return{uri:c,mimeType:j,text:e,_meta:{ui:{prefersBorder:!1}}}}has(e){return e===f}async call(e){try{return await this.open(e)}catch(t){const r=t instanceof a?t:new a("failed",t instanceof Error?t.message:String(t)),s={error:{code:r.code,message:r.message,...r.hint===void 0?{}:{hint:r.hint}}};return g(s,JSON.stringify(s,null,2),!0)}}async close(){const e=[...this.projects.values()];this.projects.clear();for(const t of e)await(await t.catch(()=>{}))?.close()}project(e){let t=this.projects.get(e);return t||(t=I(e,void 0,N(this.context.env)),t.catch(()=>this.projects.delete(e)),this.projects.set(e,t)),t}async place(e){if(e===void 0)return{root:await y(this.context.cwd),path:void 0};const t=A(this.context.cwd,e),r=await _(t)??await y(this.context.cwd),s=$(r,t),p=s!==""&&!s.startsWith("..")&&!s.startsWith(u);return{root:r,path:p?s.split(u).join("/"):e}}async open(e){const t=w.safeParse(e??{});if(!t.success)throw new a("usage",`${t.error.issues[0]?.path.join(".")??"input"}: ${t.error.issues[0]?.message??"not valid"}.`);const{root:r,path:s}=await this.place(t.data.path),p=await this.project(r),{card:n,missing:h,failed:d}=await T(p,s);if(h!==void 0)throw new a("not-found",`There is no item at ${h} in the project at ${r}.`,{hint:"Name an item's folder or its entry file (launch/plan, launch/plan/doc.mdx)."});const{item:i}=n,m=[i?`The ${C[i.kind].name} ${i.dir}${i.title===void 0?"":` ("${i.title}")`} is at ${n.url}.`:`The project's items (${n.project.name}) are at ${n.url}.`,"Open it where your app shows web pages (your browser pane), else in the person's browser: the person sees and edits it there."];d!==void 0&&m.push(`No preview: ${d}`);const l={...n};return delete l.preview,g(l,m.join(`
-`),!1,{[E]:n})}}

package/dist/commands/mcp-docs.js

@@ -1,2 +0,0 @@
-/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{readdir as f,readFile as a}from"node:fs/promises";import{join as s}from"node:path";import{SDK as p}from"@allyhub-next/build";import{sdkDocs as h}from"../sdk-docs.js";const c="allyhub-docs://",u="text/markdown";async function m(n){return(await h(n))?.dir}function w(n){return new Map([...n.matchAll(/^- \[([\w-]+\.md)\]\(\1\): (.+)$/gmu)].map(t=>[t[1]??"",t[2]??""]))}export async function docResources(n){const t=await m(n);if(t===void 0)return[];const d=await f(t).catch(()=>[]),i=await a(s(t,"README.md"),"utf8").catch(()=>""),o=w(i);return d.filter(e=>e.endsWith(".md")).sort((e,r)=>e==="README.md"?-1:r==="README.md"?1:e.localeCompare(r)).map(e=>{const r=e==="README.md"?"The index of the SDK's docs: what each file covers.":o.get(e);return{uri:`${c}${e}`,name:e,title:`${p} docs: ${e}`,...r===void 0?{}:{description:r},mimeType:u}})}export async function readDoc(n,t){if(!t.startsWith(c))return;const d=t.slice(c.length);if(!/^[\w-]+\.md$/u.test(d))return;const i=await m(n);if(i===void 0)return;const o=await a(s(i,d),"utf8").catch(()=>{});return o===void 0?void 0:{uri:t,mimeType:u,text:o}}

package/dist/commands/mcp.js

@@ -1,2 +0,0 @@
-/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{McpServer as y}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as b}from"@modelcontextprotocol/sdk/server/stdio.js";import{CallToolRequestSchema as S,ListResourcesRequestSchema as g,ListToolsRequestSchema as k,ReadResourceRequestSchema as v}from"@modelcontextprotocol/sdk/types.js";import{z as f}from"zod";import{describeCommand as R,toolName as d}from"@allyhub-next/protocol";import{CommandError as m,defineCommand as C}from"../command.js";import{CardApp as j}from"./mcp-app.js";import{docResources as M,readDoc as O}from"./mcp-docs.js";const A="0.0.0";export const MCP_INSTRUCTIONS=["AllyHub makes videos, decks, docs, sheets and 3D sceneries as code in a project folder, checks, previews and renders them on this computer, and runs AI models and research tools in its cloud, which cost the person's credits.","Each tool here is one of its commands: `allyhub help` on the command line (`npx -y allyhub help`) is their reference and says where the SDK's docs are.",`\`allyhub skills\` (${d("skills")}) lists AllyHub's work skills, each how to make one kind of work; \`allyhub skills show <name>\` (${d("skills show")}) prints one, and \`allyhub add <name>\` puts it in the project.`].join(" ");async function N(i,t,u){const c=(e,o=!1)=>({content:[{type:"text",text:JSON.stringify(e,null,2)}],...o?{isError:o}:{}}),a=i.spec.input.safeParse(t??{});if(!a.success){const e=a.error.issues[0];return c({error:{code:"usage",message:`${e?.path.join(".")??i.spec.name}: ${e?.message??"not valid"}.`}},!0)}try{const e=await i.run(a.data,u);return c(e.value)}catch(e){const o=e instanceof m?e:new m("failed",e instanceof Error?e.message:String(e));return c({error:{code:o.code,message:o.message,...o.hint===void 0?{}:{hint:o.hint}}},!0)}}export const mcp=C({name:"mcp",summary:"The commands as MCP tools, over stdio",input:f.strictObject({}),output:f.looseObject({}),examples:["claude mcp add allyhub -- allyhub mcp"],mcp:!1},async(i,t)=>{const{COMMANDS:u,MCP_COMMANDS:c}=await import("./index.js"),a=new Map([...u,...c].filter(s=>s.spec.mcp!==!1).map(s=>[d(s.spec.name),s]));console.log=console.error,console.info=console.error;const e=new y({name:"allyhub",version:A},{capabilities:{tools:{},resources:{}},instructions:MCP_INSTRUCTIONS}),o=new j(t),l=e.server;l.setRequestHandler(k,()=>({tools:[...o.tools(),...[...a].map(([s,n])=>{const r=Object.fromEntries(Object.entries(R(n.spec).input).filter(([p])=>p!=="$schema"));return{name:s,description:n.spec.summary,inputSchema:{type:"object",...r}}})]})),l.setRequestHandler(g,async()=>({resources:[...o.resources(),...await M(t.cwd)]})),l.setRequestHandler(v,async s=>{const{uri:n}=s.params;if(n===o.resources()[0]?.uri)return{contents:[await o.resource()]};const r=await O(t.cwd,n);if(r===void 0)throw new m("not-found",`allyhub has no resource ${n}.`);return{contents:[r]}}),l.setRequestHandler(S,(s,n)=>{if(o.has(s.params.name))return o.call(s.params.arguments);const r=a.get(s.params.name);if(!r)throw new m("unknown-tool",`allyhub has no tool ${s.params.name}.`);const p=AbortSignal.any([t.signal,n.signal]);return N(r,s.params.arguments,{...t,signal:p})});const h=new b,w=new Promise(s=>{h.onclose=s});return await e.connect(h),process.stdin.once("end",()=>{e.close()}),t.signal.addEventListener("abort",()=>{e.close()}),await w,await o.close(),{value:{},text:""}});