allyhub 0.7.1 → 0.8.0

package/dist/node_modules/@allyhub/build/dist/content.d.ts

@@ -0,0 +1,69 @@
+import { type Item } from "@allyhub/formats";
+import { type GeneratedSheets } from "@allyhub/sheet";
+import { type DataFile, type Problem, type PropType } from "@allyhub/video-core";
+import type { MetaLoader } from "./meta.js";
+export interface DocInfo {
+    /** Its folder: launch/plan. */
+    dir: string;
+    /** Its place, the same: launch/plan. */
+    place: string;
+    file: string;
+    /** The first-level heading it opens with. */
+    title?: string;
+    /** The first paragraph under it, as plain text, for a glimpse in a list. */
+    glimpse?: string;
+    /** The project's files it shows (its pictures), there or not. */
+    shows: string[];
+    /** The components it shows, each once: as its blocks name it, its module's project path and its export. */
+    components: DocComponent[];
+    /** The rows its charts read (`data="../sales#Revenue"`), by the path as written, as the build read them. */
+    data: Record<string, unknown>;
+}
+/** A component a doc shows, by the reference its blocks write. */
+export interface DocComponent {
+    /** The reference as written: `../ui.ts#Dialog`. */
+    of: string;
+    /** Its module's project path. */
+    module: string;
+    /** The export. */
+    name: string;
+    /** Its props' types, when it could be read. */
+    props?: Readonly<Record<string, PropType>>;
+}
+export interface SheetInfo {
+    dir: string;
+    place: string;
+    file: string;
+    /** What sheet.yaml calls it. */
+    title?: string;
+    /** Its sheets' names. */
+    sheets: string[];
+    /** Its tables' names, each with how many rows it has. */
+    tables: {
+        name: string;
+        rows: number;
+    }[];
+    /** sheet.yaml and the CSV files it names that are there. */
+    files: string[];
+    /** What its sheet.ts makes. */
+    generated?: GeneratedSheets;
+    /** It has a sheet.ts that did not run: what the sheet holds is not all of it. */
+    codeFailed?: true;
+}
+/**
+ * The project's docs: what is wrong in each (AK-M008) and what a list
+ * shows of it. `data` is the project's data, as readData and readSheets
+ * read it, by project path and by <sheet>#<table>: what a doc's charts read.
+ */
+export declare function readDocs(root: string, items: readonly Item[], files: readonly string[], meta?: MetaLoader, data?: Readonly<Record<string, DataFile>>): Promise<{
+    docs: DocInfo[];
+    problems: Problem[];
+}>;
+/** Each website's entry file checked against its format (AK-M013): what Studio runs to preview it. */
+export declare function readWebsites(root: string, items: readonly Item[]): Promise<Problem[]>;
+export declare function readSheets(root: string, items: readonly Item[], meta?: MetaLoader): Promise<{
+    sheets: SheetInfo[];
+    problems: Problem[];
+    data: Record<string, DataFile>;
+}>;
+//# sourceMappingURL=content.d.ts.map

package/dist/node_modules/@allyhub/build/dist/content.js

@@ -0,0 +1,3 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readFile as E}from"node:fs/promises";import{join as S,posix as y}from"node:path";import{DRAWN_CODE as C,docChart as N,everyBlock as D,mathHtml as F,parseDoc as H,shownBlocks as q,splitTitle as B,titleText as G}from"@allyhub/doc";import{createHash as R}from"node:crypto";import{SHEET_CODE as O,parseWebsite as I}from"@allyhub/formats";import{GENERATED as J,checkWorkbook as L,seededRandom as P,tableRows as _}from"@allyhub/sheet";import{parseComponentRef as U,problem as m,readPropsText as Q}from"@allyhub/video-core";import{readSheetSource as V,workbookFiles as X}from"./sheet-code.js";const T=180,Y=/^([a-z][a-z0-9+.-]*:|\/\/)/iu;function Z(p){for(const f of p){if(f.type!=="paragraph")continue;const r=f.content.map(c=>c.text).join("").replace(/\s+/gu," ").trim();if(r!=="")return r.length>T?`${r.slice(0,T-1)}…`:r}}function*W(p){let f=0,r=1;for(const c of p.segments){for(;f<c.start;f++)p.source[f]===`
+`&&r++;for(const d of c.blocks)for(const a of D([d]))yield{block:a,line:r}}}export async function readDocs(p,f,r,c,d={}){const a=[],o=[],$=new Set(r),l=new Map,j=(n,t)=>{const u=`${n}#${t}`;let b=l.get(u);return b||(b=(async()=>{if(!c)return{};const h=await c.request({type:"component",file:n,name:t});if(o.push(...h.problems),!h.ok)return{not:h.error??`${n} could not be read`};const k=h.value;return k.not===void 0?{props:k.props??{}}:{not:k.not}})(),l.set(u,b)),b};for(const n of f){if(n.kind!=="doc")continue;const t=n.entry,u=H(await E(S(p,t),"utf8"));for(const e of u.problems)o.push(m("AK-M008",`${t}: ${e.message}.`,{where:{file:t,...e.line===void 0?{}:{line:e.line}}}));const b=B(q(u.blocks)),h=G(b.title).trim()||void 0,k=Z(b.body),x=new Set,s=[...u.page.cover===void 0?[]:[u.page.cover],...[...D(u.blocks)].flatMap(e=>e.type==="image"?[e.src]:[])];for(const e of s){if(Y.test(e))continue;const M=y.normalize(y.join(n.dir,decodeURIComponent(e)));x.add(M),$.has(M)||o.push(m("AK-M008",`${t} shows the picture ${e}, which is not in the project (${M}).`,{where:{file:t}}))}const K=new Map;for(const{block:e,line:M}of W(u)){if(e.type!=="component")continue;const g={where:{file:t,line:M}},A=U(e.of);if(!A){o.push(m("AK-M008",`${t}: of="${e.of}" names no component: write the module's path from the doc's folder and its export (../../components/ui.ts#Dialog).`,g));continue}const i=y.normalize(y.join(n.dir,A.path));if(!$.has(i)){o.push(m("AK-M008",`${t} shows the component ${e.of}, whose module is not in the project (${i}).`,g));continue}const w=await j(i,A.name);if(w.not!==void 0){o.push(m("AK-M008",`${t}: ${w.not}.`,g));continue}if(w.props)for(const z of Q({name:A.name,props:w.props},e.props).problems)o.push(m("AK-M008",`${t}: ${z}.`,g));K.set(e.of,{of:e.of,module:i,name:A.name,...w.props?{props:w.props}:{}})}const v={};for(const{block:e,line:M}of W(u)){const g={where:{file:t,line:M}};if(e.type==="code"&&e.language===C.math){const{error:i}=F(e.code);i!==void 0&&o.push(m("AK-M008",`${t}: an equation: ${i}.`,g));continue}if(e.type!=="chart")continue;if(e.data!==void 0){const i=y.normalize(y.join(n.dir,e.data)),w=d[i];if(w===void 0){o.push(m("AK-M008",`${t}: a chart reads ${e.data}, which is not a data file or a sheet's table of the project (${i}).`,g));continue}if(w.error!==void 0){o.push(m("AK-M008",`${t}: a chart reads ${e.data}, which cannot be read: ${w.error}.`,g));continue}v[e.data]=w.value,$.has(i)&&x.add(i)}const A=N(e,{base:n.dir,data:i=>v[i]});for(const i of A.problems)o.push(m("AK-M008",`${t}: the chart${e.title===void 0?"":` "${e.title}"`}: ${i}.`,g))}a.push({dir:n.dir,place:n.dir,file:t,...h?{title:h}:{},...k?{glimpse:k}:{},shows:[...x],components:[...K.values()],data:v})}return{docs:a,problems:o}}function ee(p,f,r,c,d){const a={};for(const o of r.tables){const $=_(c,o),l=R("sha256").update(d).update(JSON.stringify($)).digest("hex");a[`${p}#${o.name}`]={sha256:l,value:$},a[`${f}#${o.name}`]={sha256:l,value:$}}return a}export async function readWebsites(p,f){const r=[];for(const c of f){if(c.kind!=="website")continue;const d=c.entry,a=I(await E(S(p,d),"utf8"));if(!a.ok)for(const o of a.problems)r.push(m("AK-M013",`${d}: ${o}.`,{where:{file:d}}))}return r}export async function readSheets(p,f,r){const c=[],d=[];let a={};for(const o of f){if(o.kind!=="sheet")continue;const $=o.entry,l=await V(p,o.dir,r?{meta:r}:{}).catch(()=>{});if(!l)continue;d.push(...l.problems);const{csv:j,generated:n}=l,t=R("sha256").update(l.text);for(const s of j.values())t.update(s);n&&t.update(JSON.stringify(n));const u=t.digest("hex"),b=L(X(p,l),{random:P(u)});for(const s of b.problems){const K=y.join(o.dir,s.file.startsWith(J)?O:s.file);d.push(m("AK-M009",`${K}${s.line===void 0?"":`:${String(s.line)}`}: ${s.message}.`,{where:{file:K,...s.line===void 0?{}:{line:s.line}}}))}const{workbook:h,calc:k}=b,x=h?.title?.trim();c.push({dir:o.dir,place:o.dir,file:$,...x?{title:x}:{},sheets:h?.sheets.map(s=>s.name)??[],tables:h?.tables.map(s=>({name:s.name,rows:s.rows}))??[],files:[$,...[...j.keys()].map(s=>y.join(o.dir,s)),...n||l.failed?[y.join(o.dir,O)]:[]],...n?{generated:n}:{},...l.failed?{codeFailed:!0}:{}}),h&&k&&(a={...a,...ee(o.dir,$,h,k,u)})}return{sheets:c,problems:d,data:a}}

package/dist/node_modules/@allyhub/build/dist/data.d.ts

@@ -0,0 +1,13 @@
+import type { DataFile } from "@allyhub/video-core";
+/** One object per row, keyed by the header; a column whose every value is a number becomes numbers. */
+export declare function parseCsv(text: string): Record<string, string | number>[];
+/** Whether a project path is the project's data; not the shared words in `text`, not a workbook. */
+export declare function isDataFile(path: string, text?: string): boolean;
+/** A sheet's table's computed rows, by <sheet>#<table> from the project's root, for code that runs before the project is read. */
+export declare function readTable(root: string, at: string): unknown;
+/** Larger data files are not read by ctx.data: imported instead. */
+export declare const MAX_DATA_BYTES: number;
+export declare function parseData(path: string, text: string): unknown;
+/** Every data file, parsed; one that does not parse keeps its error, reported when a piece reads it. */
+export declare function readData(root: string, files: readonly string[], text?: string): Promise<Record<string, DataFile>>;
+//# sourceMappingURL=data.d.ts.map

package/dist/node_modules/@allyhub/build/dist/data.js

@@ -0,0 +1,3 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{createHash as w}from"node:crypto";import{readFileSync as l}from"node:fs";import{readFile as h}from"node:fs/promises";import{join as m}from"node:path";import{parse as y}from"yaml";import{SHEET_FILE as u,TEXT_DIR as p,baseOf as d,within as b}from"@allyhub/formats";import{Calc as g,csvRows as T,readWorkbook as j,tableRows as k}from"@allyhub/sheet";const v=/^-?(\d+\.?\d*|\.\d+)(e[+-]?\d+)?$/iu;export function parseCsv(t){const[r,...s]=T(t);if(!r)return[];const a=r.map(e=>e.trim()),n=a.map((e,o)=>s.every(i=>{const c=(i[o]??"").trim();return c===""||v.test(c)})&&s.some(i=>(i[o]??"").trim()!==""));return s.map(e=>{const o={};return a.forEach((i,c)=>{const f=(e[c]??"").trim();o[i]=n[c]&&f!==""?Number(f):f}),o})}const E=/\.(csv|ya?ml|json)$/iu,A=/(^|\/)(package(-lock)?\.json|tsconfig(\.[\w-]+)?\.json|jsconfig\.json|pnpm-(lock|workspace)\.yaml|[^/]+\.(words|elements|gen)\.json|script\.[\w-]+\.ya?ml|slides\.yaml|comments\.json)$/u;export function isDataFile(t,r=p){return E.test(t)&&!A.test(t)&&d(t)!==u&&!b(t,r)}export function readTable(t,r){const[s="",a=""]=r.split("#"),n=m(t,d(s)===u?s.slice(0,-u.length):s),{workbook:e}=j({text:l(m(n,u),"utf8"),read:i=>{try{return l(m(n,i),"utf8")}catch{return}}}),o=e?.table(a);if(!e||!o)throw new Error(`${r} is not a table of a sheet.`);return k(new g(e).calculate(),o)}export const MAX_DATA_BYTES=5*1024*1024;export function parseData(t,r){return/\.csv$/iu.test(t)?parseCsv(r):/\.ya?ml$/iu.test(t)?y(r)??null:JSON.parse(r)}export async function readData(t,r,s=p){const a={};for(const n of r){if(!isDataFile(n,s))continue;const e=await h(m(t,n)).catch(()=>{});if(!e)continue;const o=w("sha256").update(e).digest("hex");if(e.byteLength>MAX_DATA_BYTES){a[n]={sha256:o,error:`larger than ${String(MAX_DATA_BYTES/1024/1024)} MB; import it instead`};continue}try{a[n]={sha256:o,value:parseData(n,e.toString("utf8"))}}catch(i){a[n]={sha256:o,error:i.message.split(`
+`)[0]??""}}}return a}

package/dist/node_modules/@allyhub/build/dist/files.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readdir as m,readFile as p}from"node:fs/promises";import{join as l}from"node:path";import d from"ignore";import{ITEM_KINDS as w,PACKAGE_FILE as g,unscanned as y}from"@allyhub/formats";const E=w.website.entries;export async function listFiles(i){const t=[],o=async(e,c)=>{const u=await m(l(i,e),{withFileTypes:!0}).catch(()=>[]),a=await p(l(i,e,".gitignore"),"utf8").then(n=>[...c,{dir:e,rules:d().add(n)}],()=>c),f=e===""?void 0:u.find(n=>n.isFile()&&E.includes(n.name));if(f){t.push(`${e}/${f.name}`);return}for(const n of u.sort((s,r)=>s.name<r.name?-1:s.name>r.name?1:0)){const s=e===""?n.name:`${e}/${n.name}`;if(y(s))continue;const r=n.isDirectory();!r&&!n.isFile()||h(a,s,r)||(r?await o(s,a):t.push(s))}};return await o("",[]),t.sort()}function h(i,t,o){let e=!1;for(const{dir:c,rules:u}of i){const a=c===""?t:t.slice(c.length+1),f=u.test(o?`${a}/`:a);f.ignored?e=!0:f.unignored&&(e=!1)}return e}export async function dependenciesOf(i){try{const t=JSON.parse(await p(l(i,g),"utf8"));return new Set(["dependencies","devDependencies","peerDependencies","optionalDependencies"].flatMap(o=>Object.keys(t[o]??{})))}catch{return new Set}}

package/dist/node_modules/@allyhub/build/dist/fonts.d.ts

@@ -0,0 +1,26 @@
+import { type Config } from "@allyhub/formats";
+/** The module every piece's stage bundle imports: the project's font stylesheets. */
+export declare const FONTS_MODULE = "allyhub:fonts";
+/**
+ * The stylesheets every stage loads, in the config's order: each a path
+ * from the project's root when it is in the project and not in a package
+ * (assets/brand/brand.css), else absolute; and the entries that name no
+ * file.
+ */
+export declare function fontStyles(root: string, config: {
+    fonts?: Config["fonts"] | undefined;
+}): {
+    styles: string[];
+    missing: string[];
+};
+/**
+ * sha256 of the project's fonts as the stage loads them: each stylesheet
+ * by its bytes, with a package's name and version for one in a package (a
+ * version's files do not change), or the font files beside it (in its
+ * folder or below) for one of the project's. Undefined when there is
+ * none, so a project without fonts keeps the digests it had.
+ */
+export declare function fontsDigest(root: string, files: readonly string[], styles: readonly string[]): Promise<string | undefined>;
+/** The `allyhub:fonts` module: an import per stylesheet (absolute paths, from the project's root). */
+export declare function fontsModule(root: string, styles: readonly string[]): string;
+//# sourceMappingURL=fonts.d.ts.map

package/dist/node_modules/@allyhub/build/dist/fonts.js

@@ -0,0 +1,4 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{createHash as h}from"node:crypto";import{existsSync as m,readFileSync as S}from"node:fs";import{readFile as O}from"node:fs/promises";import{createRequire as w}from"node:module";import{dirname as u,isAbsolute as c,join as g,relative as F,resolve as l,sep as x}from"node:path";import{PACKAGE_FILE as y,within as $}from"@allyhub/formats";export const FONTS_MODULE="allyhub:fonts";const j=/\.(woff2?|ttf|otf)$/i,v=e=>e.startsWith("./")||e.startsWith("../")||c(e);export function fontStyles(e,n){const o=[],r=[],a=w(g(e,y));for(const s of n.fonts??[]){let i;if(v(s)){const d=l(e,s);m(d)&&(i=d)}else try{i=a.resolve(s)}catch{i=void 0}if(i===void 0){r.push(s);continue}const t=F(e,i),p=!t.startsWith("..")&&!c(t)&&!t.split(x).includes("node_modules")?t.split(x).join("/"):i;o.includes(p)||o.push(p)}return{styles:o,missing:r}}function E(e){for(let n=u(e);n!==u(n);n=u(n)){const o=g(n,y);if(m(o))try{const r=JSON.parse(S(o,"utf8"));if(typeof r.name=="string")return`${r.name}@${String(r.version)}`}catch{return""}}return""}export async function fontsDigest(e,n,o){if(o.length===0)return;const r=o.filter(t=>!c(t)),a=[...new Set(r.map(t=>t.slice(0,t.lastIndexOf("/"))))],s=n.filter(t=>j.test(t)&&a.some(f=>$(t,f))),i=h("sha256");for(const t of[...new Set([...o,...s])].sort()){const f=await O(l(e,t)).catch(()=>Buffer.alloc(0));i.update(`${c(t)?E(t):t}\0`).update(h("sha256").update(f).digest("hex")).update("\0")}return`sha256:${i.digest("hex")}`}export function fontsModule(e,n){return n.length===0?`export {};
+`:n.map(o=>`import ${JSON.stringify(l(e,o))};
+`).join("")}

package/dist/node_modules/@allyhub/build/dist/index.d.ts

@@ -0,0 +1,21 @@
+export { dependenciesOf, listFiles } from "./files.js";
+export { hasSheetCode, readSheetSource, runSheetCode, sheetRoot, workbookFiles, type SheetSource, } from "./sheet-code.js";
+export { moveEdits, movedPath, referencesOf, referringFiles, } from "./move-refs.js";
+export { bundleForStage, compileErrorOf, createModuleLoader, createStageDevServer, loadUserVite, type CompileError, type Handler, type Inline, type ModuleLoader, type Plugin, type StageBundle, type StageChunk, type StageDevServer, type UserVite, } from "./vite.js";
+export { placeFinder, type PlaceFinder, type PlaceOptions, type SourcePlace, } from "./places.js";
+export { mergeScripts, readMessages, type ProjectMessages, type ScriptInfo, type ScriptSource, } from "./messages.js";
+export { MAX_DATA_BYTES, isDataFile, parseCsv, parseData, readData, readTable, } from "./data.js";
+export { readDocs, readSheets, type DocComponent, type DocInfo, type SheetInfo, } from "./content.js";
+export { readMedia, type MediaOptions, type MediaTable } from "./media.js";
+export { modelInfo } from "./model-info.js";
+export { makeWords, takeVoice, type MadeWords, type MakeWordsOptions, type TakeVoice, } from "./takes.js";
+export { resolveMatrix, type ResolvedMatrix } from "./matrix.js";
+export { FONTS_MODULE, fontStyles, fontsDigest, fontsModule } from "./fonts.js";
+export { LENT, SDK, SDK_ENTRIES, checkImports, discover, lineAt, packageName, parse, walk, type Discovered, type Node, type Parsed, } from "./scan.js";
+export { allyhubPlugin, boundSdk, lentSdk, mediaHref, type PluginOptions, } from "./plugin.js";
+export { MetaLoader, type MetaResult } from "./meta.js";
+export type { WorkerInit as MetaInit } from "./meta-worker.js";
+export { MESSAGE_TYPES, messageTypes, writeMessageTypes } from "./types.js";
+export { BUILD_FOLDER, prepare, sourceOf, stageId, stageItem, stageName, type PieceInfo, type ProjectComponent, type StageItem, type Prepared, type PrepareOptions, } from "./prepare.js";
+export { codeOf, type PieceCode } from "./code.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/node_modules/@allyhub/build/dist/index.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export{dependenciesOf,listFiles}from"./files.js";export{hasSheetCode,readSheetSource,runSheetCode,sheetRoot,workbookFiles}from"./sheet-code.js";export{moveEdits,movedPath,referencesOf,referringFiles}from"./move-refs.js";export{bundleForStage,compileErrorOf,createModuleLoader,createStageDevServer,loadUserVite}from"./vite.js";export{placeFinder}from"./places.js";export{mergeScripts,readMessages}from"./messages.js";export{MAX_DATA_BYTES,isDataFile,parseCsv,parseData,readData,readTable}from"./data.js";export{readDocs,readSheets}from"./content.js";export{readMedia}from"./media.js";export{modelInfo}from"./model-info.js";export{makeWords,takeVoice}from"./takes.js";export{resolveMatrix}from"./matrix.js";export{FONTS_MODULE,fontStyles,fontsDigest,fontsModule}from"./fonts.js";export{LENT,SDK,SDK_ENTRIES,checkImports,discover,lineAt,packageName,parse,walk}from"./scan.js";export{allyhubPlugin,boundSdk,lentSdk,mediaHref}from"./plugin.js";export{MetaLoader}from"./meta.js";export{MESSAGE_TYPES,messageTypes,writeMessageTypes}from"./types.js";export{BUILD_FOLDER,prepare,sourceOf,stageId,stageItem,stageName}from"./prepare.js";export{codeOf}from"./code.js";

package/dist/node_modules/@allyhub/build/dist/matrix.d.ts

@@ -0,0 +1,18 @@
+import { type Combo, type Dims, type Matrix, type MatrixPlan, type Problem } from "@allyhub/video-core";
+export interface ResolvedMatrix {
+    /** Every combo the piece makes, in order. */
+    combos: Combo[];
+    plan?: MatrixPlan;
+    problems: Problem[];
+}
+/** A piece's slots, structures and combos; problems say what is wrong. */
+export declare function resolveMatrix(opts: {
+    root: string;
+    piece: string;
+    file: string;
+    dims: Dims;
+    matrix: Matrix | undefined;
+    /** The project's files, relative to the root. */
+    files: readonly string[];
+}): Promise<ResolvedMatrix>;
+//# sourceMappingURL=matrix.d.ts.map

package/dist/node_modules/@allyhub/build/dist/matrix.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readFile as X}from"node:fs/promises";import{join as T,posix as k}from"node:path";import{chosenPicks as z,combosProblems as M,crossPicks as v,expandCombos as P,hasSlots as R,matrixProblems as _,mediaKindOf as L,problem as m,ruleText as N,sampleMatrix as W,slotsOf as Z,structuresOf as q}from"@allyhub/video-core";const B=/^[A-Za-z0-9][A-Za-z0-9._-]*$/,E=o=>k.basename(o).replace(/\.[^.]+$/,"");async function F(o,i){const a=i.replace(/\.[^./]+$/,".meta.json");try{const r=JSON.parse(await X(T(o,a),"utf8"));return Array.isArray(r.tags)?r.tags.filter(l=>typeof l=="string"):[]}catch{return[]}}function I(o,i){const a=i.startsWith("/")?i.slice(1):k.join(k.dirname(o),i),r=k.normalize(a).replace(/\/+$/,"");return r.startsWith("..")?void 0:r==="."?"":r}export async function resolveMatrix(o){const{root:i,piece:a,file:r,dims:l}=o,t=o.matrix??{},s={piece:a,where:{file:r}},n=[],y=t.slots??{};if(Object.keys(y).length===0)return{combos:P(l),problems:n};const p={};for(const[c,f]of Object.entries(y)){if(Array.isArray(f)){p[c]=f.map(d=>typeof d=="string"?{name:d,tags:[]}:{name:d.name,tags:[...d.tags??[]]});continue}const S=f,g=I(r,S.pool);if(g===void 0){n.push(m("AK-X001",`The pool of slot ${c} (${S.pool}) is outside the project. Name a folder relative to ${r}.`,s)),p[c]=[];continue}const K=o.files.filter(d=>k.dirname(d)===(g===""?".":g)&&L(d)!==void 0).sort(),A=[];for(const d of K){const j=E(d);if(!B.test(j)){n.push(m("AK-X001",`The pool file ${d} cannot name a candidate: a name has letters, digits, . _ and -. Rename the file.`,s));continue}if(A.some(O=>O.name===j)){n.push(m("AK-X001",`The pool ${g} has two files named ${j}: a candidate is named by the file's stem. Rename one.`,s));continue}A.push({name:j,tags:[...new Set([...S.tags??[],...await F(i,d)])],file:d})}A.length===0&&n.push(m("AK-X001",`The pool of slot ${c} (${g||"."}) has no media files. Add video, audio or image files to it.`,s)),p[c]=A}const u={slots:p,structures:q(Object.keys(p),t.structures),declared:Object.keys(t.structures??{}).length>0},$=[..._(u,l,t),...t.combos?M(u,l,t.combos):[]];for(const c of $)n.some(f=>f.message===c)||n.push(m("AK-X001",`matrix: ${c}`,s));if(n.some(c=>c.level==="error"))return{combos:[],problems:n};if(t.combos)return D(u,l,t,s,n);const h=[...t.rules??[]],e=W(u,l,t),{combos:b,dropped:C}=v(u,l,h,e.picks),w={space:u,rules:h,choice:"sampling",...t.pick===void 0?{}:{pick:t.pick},...t.seed===void 0?{}:{seed:t.seed},...t.differ===void 0?{}:{differ:t.differ},picks:e.picks,combos:b,total:e.total,valid:e.valid,dropped:C,tooClose:e.tooClose,unused:e.unused};if(e.valid===0&&n.push(m("AK-X002",e.total>1e5?`matrix: the slots make ${String(e.total)} combinations, more than sampling looks at (100000). Add rules, split the piece, or use fewer candidates.`:`matrix: the rules leave none of the ${String(e.total)} slot combinations. Loosen a rule's require or exclude.`,s)),e.tooClose.length>0){const c=x(t.differ??{});n.push(m("AK-X004",`matrix: differ asks that any two combos ${c}, and only ${String(e.picks.length-new Set(e.tooClose.map(f=>f.b)).size)} of the ${String(e.picks.length)} picks can: ${e.tooClose.slice(0,6).map(f=>`${f.a} and ${f.b} ${f.opening?"open the same":`differ in ${String(f.slots)}`}`).join("; ")}${e.tooClose.length>6?"…":""}. Lower pick, add candidates, or relax differ.`,s))}return{combos:b.map(c=>c.combo),...R(u)?{plan:w}:{},problems:n}}const J=(o,i)=>[...o.declared&&i.structure!==void 0?[`[${i.structure}]`]:[],...Z(o,i).map(a=>`${a}=${i[a]??""}`)].join(" ");function D(o,i,a,r,l){const t=[...a.rules??[]],s=z(o,i,a),{combos:n,dropped:y}=v(o,i,t,s.picks),p={space:o,rules:t,choice:"combos",...a.differ===void 0?{}:{differ:a.differ},picks:s.picks,combos:n,total:s.total,...s.valid===void 0?{}:{valid:s.valid},dropped:y,tooClose:s.tooClose,unused:s.unused},u=new Map(s.picks.map(e=>[e.id,e.combo]));for(const e of s.broken)l.push(m("AK-X002",`matrix: combos ${e.id} (${J(o,u.get(e.id)??{})}) breaks ${e.rules.map(b=>`rule ${String(b)} (${N(t[b-1]??{})})`).join(", ")}. Change the combo, or the rule.`,r));const $=s.tooClose.filter(e=>e.slots===0);$.length>0&&l.push(m("AK-X004",`matrix: combos names the same combo more than once: ${$.map(e=>`${e.a} and ${e.b}`).join("; ")}. Remove the repeats.`,r));const h=s.tooClose.filter(e=>!$.includes(e));return h.length>0&&l.push(m("AK-X004",`matrix: differ asks that any two combos ${x(a.differ??{})}, and the combos chosen in matrix.combos do not: ${h.slice(0,6).map(e=>`${e.a} and ${e.b} ${e.opening?"open the same":`differ in ${String(e.slots)}`}`).join("; ")}${h.length>6?"…":""}. Change a combo, or relax differ.`,r)),{combos:n.map(e=>e.combo),plan:p,problems:l}}function x(o){return[o.slots!==void 0?`differ in at least ${String(o.slots)} slots`:"",o.first!==void 0?`open differently (${typeof o.first=="number"?`the first ${String(o.first)} slot${o.first===1?"":"s"}`:o.first.join(", ")})`:""].filter(Boolean).join(" and ")}

package/dist/node_modules/@allyhub/build/dist/media.d.ts

@@ -0,0 +1,10 @@
+import { type ToolOptions } from "@allyhub/media";
+import { type MediaInfo } from "@allyhub/video-core";
+export type MediaTable = Record<string, MediaInfo>;
+export interface MediaOptions extends ToolOptions {
+    /** Called for each file measured, for a long first build. */
+    onFile?: (path: string) => void;
+}
+/** Measures every media file among `files` (project paths). */
+export declare function readMedia(root: string, files: readonly string[], options?: MediaOptions): Promise<MediaTable>;
+//# sourceMappingURL=media.d.ts.map

package/dist/node_modules/@allyhub/build/dist/media.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readFile as y}from"node:fs/promises";import{missingFiles as F,modelInfo as O}from"./model-info.js";import{takeVoice as $}from"./takes.js";import{join as h}from"node:path";import{readDataFile as S}from"@allyhub/formats";import{ONSET_RATE as j,cached as k,decodeMono as N,estimateTempo as M,hasMatte as T,mediaKindOf as D,onsetNovelty as E,probeMedia as I,readFaceTrack as J}from"@allyhub/media";import{mediaGen as K,unheardSounds as x}from"@allyhub/video-core";const A=new Set(["image","audio","video","font","model","environment"]),w=e=>e.replace(/\.[^./]+$/u,"");async function g(e){try{return JSON.parse(await y(e,"utf8"))}catch{return}}async function G(e){const d=S("words",await g(e));if(d.ok)return d.value.words.map(({confidence:s,...r})=>s===void 0?r:{...r,confidence:s})}async function R(e,d,s){return await k(e,"tempo",{version:1},{root:d},async()=>{const c=M(E(await N(e,j,s),j));return c?{bpm:c.bpm,confidence:c.confidence,beat:c.beats[0]??0}:null}).catch(()=>null)??void 0}export async function readMedia(e,d,s={}){const r=new Set(d),c={},p=s.runtimes?{runtimes:s.runtimes}:{};for(const a of d){const o=D(a);if(!o||!A.has(o))continue;const f=h(e,a);s.onFile?.(a);const t=await I(f,{root:e,...p}),i={path:a,sha256:t.sha256,kind:o,url:"",bytes:t.bytes,...t.width===void 0?{}:{width:t.width},...t.height===void 0?{}:{height:t.height},...t.duration===void 0?{}:{duration:t.duration},...t.rotation===void 0?{}:{rotation:t.rotation},...o==="video"?{audio:(t.audio??[]).length>0}:{}},v=`${w(a)}.words.json`;if((o==="audio"||o==="video")&&r.has(v)){const n=await G(h(e,v));if(n){i.words=n;const u=n.at(-1);i.duration===void 0&&u&&(i.duration=u.end);const m=n.length>0?await $(f,e,p):void 0;if(m){const b=x(n,{hop:m.hop,db:m.db,voicing:m.voicing});i.envelope=m.base64,i.speechDb=b.speech,i.sounds=b.sounds}}}else if(o==="audio"){const n=await R(f,e,p);n&&(i.tempo=n)}const l=`${a}.gen.json`;if(r.has(l)){const n=await g(h(e,l)),u=n===void 0?{error:"not JSON"}:K(l,n,t.sha256);"gen"in u?i.gen=u.gen:i.genUnread={record:l,error:u.error}}if(o==="video"){const n=await J(e,t.sha256);n&&(i.faces=n),await T(e,t.sha256)&&(i.matte=!0)}if(o==="model"&&/\.(glb|gltf)$/iu.test(a)){const n=await k(f,"model",{version:1},{root:e},async()=>O(e,a,await y(f)));i.model=n.container==="gltf"?{...n,missing:await F(e,a)}:n}if(o==="image"&&r.has(`${w(a)}.elements.json`)){const n=S("elements",await g(h(e,`${w(a)}.elements.json`)));n.ok&&(i.elements=n.value)}c[a]=i}return c}

package/dist/node_modules/@allyhub/build/dist/messages.d.ts

@@ -0,0 +1,48 @@
+import { type MessagesFile, type Problem, type ScriptFile, type ScriptPath, type TextAnchor } from "@allyhub/video-core";
+/** An item's script file, as read. */
+export interface ScriptInfo {
+    /** launch/film/script.en.yaml */
+    file: string;
+    /** Its folder: its item's. */
+    dir: string;
+    locale: string;
+    /** Absent when the file could not be read (AK-M007 says why). */
+    script?: ScriptFile;
+    /** The piece whose words it is, once merged. */
+    piece?: string;
+}
+/** Where a message that came from a script sits in its file. */
+export interface ScriptSource {
+    file: string;
+    path: ScriptPath;
+}
+export interface ProjectMessages {
+    /** Locales, the default first. */
+    locales: string[];
+    /** locale → its messages file. */
+    files: Record<string, string>;
+    /** Every message by locale: the messages files', and the merged scripts'. */
+    messages: Record<string, MessagesFile>;
+    /** Every script file in the project. */
+    scripts: ScriptInfo[];
+    /** locale → key → where in a script it came from. */
+    sources: Record<string, Record<string, ScriptSource>>;
+    /** locale → key → the anchors a script wrote in what a part says. */
+    anchors: Record<string, Record<string, TextAnchor[]>>;
+    problems: Problem[];
+}
+export declare function readMessages(root: string, files: readonly string[], options?: {
+    locales?: readonly string[];
+    text?: string;
+}): Promise<ProjectMessages>;
+/**
+ * Makes each piece's scripts its messages: the script files in the piece's
+ * folder, under its prefix. A key a messages file or another script
+ * already has is reported and left as it was. A script already merged is
+ * skipped, so pieces can be merged one at a time.
+ */
+export declare function mergeScripts(messages: ProjectMessages, pieces: readonly {
+    id: string;
+    dir: string;
+}[]): Problem[];
+//# sourceMappingURL=messages.d.ts.map

package/dist/node_modules/@allyhub/build/dist/messages.js

@@ -0,0 +1,3 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readFile as y}from"node:fs/promises";import{join as w}from"node:path";import{parse as k}from"yaml";import{MessagesFileSchema as j,TEXT_DIR as b,dirOf as O}from"@allyhub/formats";import{LOCALE as g,SCRIPT_FILE as x,messagePrefix as v,orderLocales as A,parseScript as S,problem as $,scriptKeys as M}from"@allyhub/video-core";const K=o=>Array.isArray(o)?o[0]:o;export async function readMessages(o,h,l={}){const t=l.text??b,r=[],c={},d={};for(const s of h){if(O(s)!==t||!s.endsWith(".json"))continue;const i=s.slice(t.length+1,-5),e=n=>r.push($("AK-M006",n,{where:{file:s}}));if(!g.test(i)){e(`The file name of ${s} is not a language. Use a lower-case language name, such as ${t}/en.json or ${t}/zh-cn.json.`);continue}let f;try{f=JSON.parse(await y(w(o,s),"utf8"))}catch(n){e(`${s} is not valid JSON: ${n.message}`);continue}const a=j.safeParse(f);if(!a.success){e(`${s} is not valid: ${a.error.issues.map(n=>`${n.path.join(".")||"(root)"}: ${n.message}`).join("; ")}.`);continue}c[i]=Object.fromEntries(Object.entries(a.data).map(([n,p])=>[n,K(p)])),d[i]=s}const u=[];for(const s of h){const i=s.lastIndexOf("/"),e=x.exec(s.slice(i+1))?.[1];if(e===void 0||i<0)continue;const f={file:s,dir:s.slice(0,i),locale:e};u.push(f);const a=m=>r.push($("AK-M007",m,{where:{file:s}}));let n;try{n=k(await y(w(o,s),"utf8"))}catch(m){a(`${s} is not valid YAML: ${m.message.split(`
+`)[0]??""}`);continue}const p=S(n);if("problems"in p){a(`${s} is not a script: ${p.problems.join("; ")}.`);continue}f.script=p.script,c[e]??={}}return{locales:A(Object.keys(c),[...l.locales??[]]),files:d,messages:c,scripts:u,sources:{},anchors:{},problems:r}}export function mergeScripts(o,h){const l=[];for(const t of o.scripts){const r=h.find(e=>e.dir===t.dir);if(!r||!t.script||t.piece!==void 0)continue;t.piece=r.id;const c=e=>l.push($("AK-M007",e,{piece:r.id,where:{file:t.file}})),{keys:d,twice:u}=M(v(r.id),t.script);for(const e of new Set(u))c(`${t.file} makes the key ${e} twice: a screen text named "say", or a text named like a part's own. Rename one.`);const s=o.messages[t.locale]??={},i=o.sources[t.locale]??={};for(const e of d){if(Object.hasOwn(s,e.key)){c(`${t.file} and ${i[e.key]?.file??o.files[t.locale]??"a messages file"} both have the text ${e.key}. Keep an item's words in its script, and only what several items share in ${b}/.`);continue}s[e.key]=e.value,i[e.key]={file:t.file,path:e.path},e.anchors&&((o.anchors[t.locale]??={})[e.key]=e.anchors)}}return l}

package/dist/node_modules/@allyhub/build/dist/meta-worker.d.ts

@@ -0,0 +1,62 @@
+import { type SlidesFile } from "@allyhub/formats";
+import { type MediaInfo, type Problem } from "@allyhub/video-core";
+export interface WorkerInit {
+    root: string;
+    /** Read the project's vite.config.ts (here: its plugins cannot cross threads). */
+    user?: boolean;
+    media: Record<string, MediaInfo>;
+    dependencies: string[];
+    /** Packages a host lends, by name, with a file each resolves from (PluginOptions.lent). */
+    lent?: Record<string, string>;
+}
+export type WorkerRequest = {
+    id: number;
+    type: "piece";
+    file: string;
+} | {
+    id: number;
+    type: "deck";
+    file: string;
+    /** Its slides.yaml as read; none when it has none or it is not the format. */
+    slides: SlidesFile | undefined;
+    /** Each language's messages, by key (the script's words), the default first. */
+    words: Record<string, Record<string, unknown>>;
+    prefix: string;
+    /** The project's sheets' tables as they compute, by <sheet>#<table>. */
+    tables: Record<string, unknown>;
+} | {
+    id: number;
+    type: "sheet";
+    file: string;
+} | {
+    id: number;
+    type: "components";
+    file: string;
+}
+/** One export of a module read as a component: its name, label and props' types, or why it is not one. */
+ | {
+    id: number;
+    type: "component";
+    file: string;
+    name: string;
+} | {
+    id: number;
+    type: "config";
+    file: string;
+};
+export interface WorkerResponse {
+    id: number;
+    ok: boolean;
+    value?: unknown;
+    error?: string;
+    /** The error's stack: where in the project it was thrown. */
+    stack?: string;
+    problems: Problem[];
+}
+/** The facts a host needs of a component a doc or a deck names by its module. */
+export interface ComponentFacts {
+    name: string;
+    label?: unknown;
+    props: Record<string, unknown>;
+}
+//# sourceMappingURL=meta-worker.d.ts.map

package/dist/node_modules/@allyhub/build/dist/meta-worker.js

@@ -0,0 +1,5 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readFileSync as N}from"node:fs";import v from"node:net";import{join as g}from"node:path";import{format as V}from"node:util";import{parentPort as E,workerData as H}from"node:worker_threads";import{posix as O}from"node:path";import{projectPath as W}from"@allyhub/formats";import{isSheetCode as z}from"@allyhub/sheet/api";import{deckCode as L,evaluateDeck as Y,isDeck as G,joinPath as C,resolveDeck as Q}from"@allyhub/slides-core";import{MEDIA_BRAND as A,framedComponent as _,isPieceDefinition as X,parseComponentRef as Z,outputName as q,outputOf as tt,problem as x}from"@allyhub/video-core";import{typedNumbers as et}from"@allyhub/sheet";import{parseCsv as ot,parseData as K,readTable as nt}from"./data.js";import{deckReferences as st}from"./references.js";import{nodeStackPlace as rt}from"./places.js";import{allyhubPlugin as it}from"./plugin.js";import{SDK as at}from"./scan.js";import{createModuleLoader as ct,loadUserVite as dt}from"./vite.js";const l=H,k=[];let T=!1;for(const t of["log","info","warn","error","debug"])console[t]=(...e)=>{T||process.stderr.write(`${V(...e)}
+`)};const J=Date.UTC(2026,0,1),U=Date,ut=Math.random,ft=globalThis.fetch,lt=Reflect.get(v.Socket.prototype,"connect");function mt(t){let e=t>>>0;return()=>{e=e+1831565813|0;let o=Math.imul(e^e>>>15,1|e);return o=o+Math.imul(o^o>>>7,61|o)^o,((o^o>>>14)>>>0)/4294967296}}function pt(t){let e=2166136261;for(let o=0;o<t.length;o++)e^=t.charCodeAt(o),e=Math.imul(e,16777619);return e>>>0}function ht(){const{stack:t}=new Error,e=t?.split(`
+`)[4];return rt(e,l.root)}function wt(){return t=>{const e=ht();e&&k.push(x("AK-M012",`${e.file}:${String(e.line)} uses ${t}. sheet.ts makes the same workbook from the same files: a date or a random number is the data's, or a formula's (TODAY, RAND).`,{where:{file:e.file,line:e.line}}))}}async function j(t,e,o,r=`reading the metadata of ${e}`,s=!0,a){const c=globalThis;class i extends U{constructor(...p){p.length===0?(super(J),a?.("the clock (new Date())")):super(...p)}static now(){return a?.("the clock (Date.now)"),J}}const w=u=>{k.push(x("AK-B003",`A network request was made while ${r}: ${u}. The build has no network: put the data in the project and import it.`,{where:{file:e}}))};c.Date=i;const m=mt(pt(t));Math.random=a?()=>(a("a random number (Math.random)"),m()):m;const y=[];if(a){const u=(d,f,b,$)=>{const S=d[f];typeof S=="function"&&(d[f]=function(...F){return a(b),$===void 0?S.apply(this,F):$},y.push(()=>{d[f]=S}))};u(performance,"now","the clock (performance.now)",0);const{crypto:p}=globalThis,n=p;u(n,"randomUUID","a random number (crypto.randomUUID)",void 0),u(n,"getRandomValues","a random number (crypto.getRandomValues)",void 0),u(process,"getBuiltinModule","Node's own modules, which reach outside the project",void 0)}c.fetch=u=>(w(typeof u=="string"?u:u.url??"a request"),Promise.reject(new TypeError("network blocked by AllyHub"))),Reflect.set(v.Socket.prototype,"connect",function(...u){const[p]=u;return w(typeof p=="object"&&p!==null?`${p.host??""}:${String(p.port??"")}`:String(p)),this.destroy(new Error("network blocked by AllyHub")),this}),T=s;try{return await o()}finally{T=!1;for(const u of y)u();c.Date=U,Math.random=ut,c.fetch=ft,Reflect.set(v.Socket.prototype,"connect",lt)}}function h(t,e,o){if(typeof t=="function"){o.push(e);return}if(t===null||typeof t!="object")return typeof t=="bigint"||typeof t=="symbol"?String(t):t;if(A in t)return t.path;if(Array.isArray(t))return t.map((s,a)=>h(s,`${e}[${String(a)}]`,o));const r={};for(const[s,a]of Object.entries(t)){const c=h(a,e?`${e}.${s}`:s,o);c!==void 0&&(r[s]=c)}return r}function P(t,e){const o=O.normalize(e.startsWith("/")?e.slice(1):O.join(t,e));return o.startsWith("..")?void 0:W(o)}function I(t,e){return typeof t=="string"?P(e,t)??t:typeof t=="object"&&t!==null&&A in t?t.path:t}const D=(t,e)=>t===""?e:`${t}.${e}`;function yt(t,e,o,r,s={}){const a={};for(const[c,i]of Object.entries(t)){if(c==="covers"){typeof i=="function"?a.covers=!0:i!==void 0&&(a.covers=h(i,D(r,"covers"),o));continue}if(c==="post"&&typeof i=="object"&&i!==null){const m=h(i,D(r,"post"),o),y=i.lut;a.post={...m,...typeof y=="string"?{lut:P(s.post??O.dirname(e),y)??y}:{}};continue}if(c==="music"&&i!==void 0){const m=typeof i=="string"||typeof i=="object"&&i!==null&&A in i?{file:i}:i,y=h({...m,file:void 0},D(r,"music"),o),u=m.file;a.music={...y,...u===void 0?{}:typeof u=="object"&&u!==null&&!(A in u)?{file:Object.fromEntries(Object.entries(u).map(([p,n])=>[p,I(n,s.music??O.dirname(e))]))}:{file:I(u,s.music??O.dirname(e))}};continue}const w=h(i,D(r,c),o);w!==void 0&&(a[c]=w)}return a}process.env.NODE_ENV="production";const M=(async()=>{const t=l.user?await dt(l.root):void 0;return ct(l.root,[it({root:l.root,media:l.media,dependencies:new Set(l.dependencies),inNode:!0,...l.lent?{lent:l.lent}:{}})],{mode:"production",inline:[at,...Object.keys(l.lent??{})],...t?{user:t}:{}})})();function B(t,e,o){const r=t.written?.file;return t.written?.paths?.[e]?.[1]??O.dirname(r!==void 0&&r!==""?r:o)}async function bt(t){const o=(await j(t,t,async()=>(await M).import(g(l.root,t)))).default;if(!X(o))throw new Error("The default export is not a video: an item's video.ts exports video({ … })");const r=[],s=tt(o),a={[q(s.kind)]:{kind:s.kind,options:yt(s.options,t,r,"",{music:B(o,"music",t),post:B(o,"post",t)})}},c={written:o.written?.file??t,...o.id===void 0?{}:{id:h(o.id,"id",r)},...o.title===void 0?{}:{title:h(o.title,"title",r)},...o.format===void 0?{}:{format:h(o.format,"format",r)},...o.matrix===void 0?{}:{matrix:h(o.matrix,"matrix",r)},...o.meta===void 0?{}:{meta:h(o.meta,"meta",r)},outputs:a};return r.length>0&&k.push(x("AK-M001",`These places of the piece in ${t} are functions and cannot be read as metadata: ${r.join(", ")}. Make them plain data (text, numbers, lists, objects).`,{where:{file:t}})),c}async function gt(t){const e=await j(t,t,async()=>(await M).import(g(l.root,t))),o=[];for(const[r,s]of Object.entries(e)){if(typeof s!="function")continue;const a=s.info;if(a===void 0||typeof s.componentName!="string")continue;const c=[],i=h(a,"",c);c.length>0&&k.push(x("AK-M001",`These places in the component declaration in ${t} are functions and cannot be read as metadata: ${c.join(", ")}. The types and examples of props must be plain data.`,{where:{file:t}})),o.push({...i,file:t,export:r})}return o}async function kt(t,e){const o=await j(t,t,async()=>(await M).import(g(l.root,t)));if(!Object.hasOwn(o,e)){const c=Object.keys(o).filter(i=>i!=="__esModule");return{not:`${t} has no export ${e} (it has ${c.join(", ")||"none"})`}}const r=_(e,o[e]);if(!r)return{not:`${t}'s ${e} is not a component: make it with defineComponent`};const s=[],a=h(r.props,"",s);return s.length>0?{not:`${t}'s ${e} has functions in its props' types (${s.join(", ")}): they must be plain data`}:{name:e,...r.label===void 0?{}:{label:r.label},props:a}}async function jt(t){const e=await j(t,t,async()=>(await M).import(g(l.root,t)),void 0,!1);return h(e.default,"",[])}function $t(t){const e=Object.keys(t),o=r=>{const s=t[r];if(typeof s=="string")return s;if(typeof s=="object"&&s!==null&&"display"in s)return String(s.display);const a=`${r}.`,c=[...new Set(e.filter(i=>i.startsWith(a)).map(i=>i.slice(a.length).split(".")[0]).filter(i=>i!==void 0&&/^\d+$/u.test(i)))].sort((i,w)=>Number(i)-Number(w));if(c.length!==0)return c.map(i=>o(`${r}.${i}`)).filter(i=>i!==void 0)};return o}async function Ot(t){const{file:e}=t,r=(await j(e,e,async()=>(await M).import(g(l.root,e)))).default;if(!G(r))throw new Error("The default export is not a deck: an item's slides.ts exports presentation((prs) => { … }) from @allyhub/sdk/slides");const s=await j(e,e,()=>Promise.resolve(Y(r))),a=O.dirname(e);for(const n of st(t.slides)){if(Object.hasOwn(s.components,n))continue;const d=Z(n);if(!d)continue;const f=C(a,d.path);let b;try{b=await(await M).import(g(l.root,f))}catch(S){k.push(x("AK-M011",`${n}: ${f} could not be loaded: ${(S instanceof Error?S.message:String(S)).split(`
+`)[0]??""}`,{where:{file:f}}));continue}const $=Object.hasOwn(b,d.name)?_(n,b[d.name]):void 0;$&&(s.components[n]=$)}const c={},i=n=>{if(Object.hasOwn(c,n))return c[n];const d=C(a,n);let f;if(d.includes("#"))f=Object.hasOwn(t.tables,d)?t.tables[d]:nt(l.root,d);else{const b=N(g(l.root,d),"utf8");f=/\.csv$/iu.test(d)?ot(b):K(d,b)}return c[n]=f,f},w=await j(e,e,()=>Promise.resolve(L(s,i))),m=Object.keys(t.words);let y;const u=new Map;for(const n of m.length>0?m:[""]){const d=Q({code:w,file:t.slides??{slides:[]},words:$t(t.words[n]??{}),prefix:t.prefix,base:a,data:i});y??=d.deck;for(const f of d.problems){const b=JSON.stringify([f.path,f.slide,f.shape,f.message]),$=u.get(b);$?$.langs.push(n):u.set(b,{...f,langs:[n]})}}const p=[...u.values()].map(({langs:n,...d})=>n.length===m.length||m.length<=1?d:{...d,message:`${d.message} (in ${n.join(", ")})`});return{...r.options.title===void 0?{}:{title:r.options.title},size:[s.slide_width,s.slide_height],layouts:s.masters.flatMap(n=>n.layouts.map(d=>d.name)),components:Object.fromEntries(Object.entries(s.components).map(([n,d])=>[n,h(d.props,n,[])])),generators:Object.keys(s.generators),code:w,data:JSON.parse(JSON.stringify(c)),resolved:JSON.parse(JSON.stringify(y)),problems:p}}function R(t,e){if(typeof t=="number")e.add(t);else if(Array.isArray(t))for(const o of t)R(o,e);else if(typeof t=="object"&&t!==null)for(const o of Object.values(t))R(o,e)}async function Mt(t){const e=wt(),o=`running ${t}`,s=(await j(t,t,async()=>(await M).import(g(l.root,t)),o,!0,e)).default;if(!z(s))throw new Error("The default export is not a workbook: an item's sheet.ts exports workbook((wb, { data }) => { … }) from @allyhub/sdk/sheets");const a=O.dirname(t),c=new Set,i=n=>{const d=P(a,n);if(d===void 0||n.includes("#"))throw k.push(x("AK-M012",`${t} reads ${n}: data() reads a file of the project, from the sheet's folder.`,{where:{file:t}})),new Error(`${n} is not a file of the project.`);const f=K(d,N(g(l.root,d),"utf8"));return R(f,c),f},w=()=>j(t,t,()=>Promise.resolve(s.generate({data:i})),o,!0,e),m=await w(),y=await w();JSON.stringify(m)!==JSON.stringify(y)&&k.push(x("AK-M012",`${t} made other sheets the second time it ran: what it keeps between runs is not the project's files.`,{where:{file:t}}));const u=N(g(l.root,t),"utf8");for(const n of u.matchAll(/(?<![\w.])-?\d[\d_]*(?:\.\d+)?(?:e[+-]?\d+)?/giu))c.add(Number(n[0].replaceAll("_","")));const p=et(m.sheets,m.csv).filter(n=>!c.has(n.value)).flatMap(n=>n.cell===void 0?[{sheet:n.sheet,cell:n.file??"",value:n.value}]:[{sheet:n.sheet,cell:n.cell,value:n.value}]);return{...m,...p.length>0?{typed:p}:{}}}E?.on("message",t=>{(async()=>{k.length=0;try{await M;const e=t.type==="piece"?await bt(t.file):t.type==="deck"?await Ot(t):t.type==="sheet"?await Mt(t.file):t.type==="components"?await gt(t.file):t.type==="component"?await kt(t.file,t.name):await jt(t.file),o={id:t.id,ok:!0,value:e,problems:[...k]};E?.postMessage(o)}catch(e){const o={id:t.id,ok:!1,error:e instanceof Error?e.message:String(e),...e instanceof Error&&e.stack?{stack:e.stack}:{},problems:[...k]};E?.postMessage(o)}})()});

package/dist/node_modules/@allyhub/build/dist/meta.d.ts

@@ -0,0 +1,24 @@
+import { type Problem } from "@allyhub/video-core";
+import type { WorkerInit, WorkerRequest } from "./meta-worker.js";
+export interface MetaResult {
+    ok: boolean;
+    value?: unknown;
+    error?: string;
+    /** The error's stack: where in the project it was thrown. */
+    stack?: string;
+    problems: Problem[];
+}
+export declare class MetaLoader {
+    private worker;
+    /** A new worker starts Vite first: its first request gets more time. */
+    private fresh;
+    private next;
+    private readonly init;
+    /** Deadline of one request, in ms. */
+    readonly timeout: number;
+    constructor(init: WorkerInit, timeout?: number);
+    private start;
+    request(req: WorkerRequest extends infer R ? R extends WorkerRequest ? Omit<R, "id"> : never : never, timeout?: number): Promise<MetaResult>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=meta.d.ts.map

package/dist/node_modules/@allyhub/build/dist/meta.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{Worker as d}from"node:worker_threads";import{problem as f}from"@allyhub/video-core";const l=new URL(import.meta.url.endsWith(".ts")?"./meta-worker.ts":"./meta-worker.js",import.meta.url);export class MetaLoader{worker;fresh=!1;next=1;init;timeout;constructor(t,o=15e3){this.init=t,this.timeout=o}start(){return this.worker?this.worker:(this.worker=new d(l,{workerData:this.init}),this.worker.unref(),this.fresh=!0,this.worker)}async request(t,o=this.timeout){const r=this.start(),i=this.next++,m=o+(this.fresh?3e4:0);return this.fresh=!1,new Promise(h=>{const s=e=>{clearTimeout(u),r.off("message",n),r.off("error",a),h(e)},n=e=>{e.id===i&&s({ok:e.ok,problems:e.problems,...e.value===void 0?{}:{value:e.value},...e.error===void 0?{}:{error:e.error},...e.stack===void 0?{}:{stack:e.stack}})},a=e=>{this.worker=void 0,s({ok:!1,error:e.message,problems:[]})},u=setTimeout(()=>{r.terminate(),this.worker=void 0,s({ok:!1,error:"timeout",problems:[f("AK-B004",`Reading the metadata of ${t.file} took more than ${String(Math.round(o/1e3))} seconds and was stopped. The top level of the module must not loop or wait: draw inside the output's function.`,{where:{file:t.file}})]})},m);r.on("message",n),r.on("error",a),r.postMessage({...t,id:i})})}async close(){const t=this.worker;this.worker=void 0,await t?.terminate()}}

package/dist/node_modules/@allyhub/build/dist/model-info.d.ts

@@ -0,0 +1,6 @@
+import type { ModelInfo } from "@allyhub/video-core";
+/** The files a glTF (or GLB) names that are not in the project. */
+export declare function missingFiles(root: string, path: string): Promise<string[]>;
+/** What a glTF or GLB holds. Never throws: what it cannot read is said in it. */
+export declare function modelInfo(root: string, path: string, bytes: Buffer): Promise<ModelInfo>;
+//# sourceMappingURL=model-info.d.ts.map

package/dist/node_modules/@allyhub/build/dist/model-info.js

@@ -0,0 +1,4 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readFile as T,stat as M}from"node:fs/promises";import{join as x,posix as f}from"node:path";import{createPackages as U}from"@allyhub/runtimes";const I=new Set(["KHR_draco_mesh_compression","EXT_meshopt_compression","KHR_meshopt_compression","KHR_texture_basisu","KHR_mesh_quantization","KHR_texture_transform","KHR_materials_unlit","KHR_materials_emissive_strength","KHR_materials_clearcoat","KHR_materials_transmission","KHR_materials_volume","KHR_materials_ior","KHR_materials_specular","KHR_materials_sheen","KHR_materials_iridescence","KHR_materials_anisotropy","KHR_materials_dispersion","KHR_lights_punctual","EXT_mesh_gpu_instancing","EXT_texture_webp","EXT_texture_avif"]),F=20,p=t=>U().load("gltf-tools",{module:t,onFetch:()=>{process.stderr.write(`Getting the glTF tools, once, to read 3D models…
+`)}});function N(t,n){if(!n)return JSON.parse(t.toString("utf8"));if(t.readUInt32LE(0)!==1179937895)throw new Error("not a GLB (no glTF magic)");const a=t.readUInt32LE(12);if(t.readUInt32LE(16)!==1313821514)throw new Error("its first chunk is not JSON");return JSON.parse(t.subarray(20,20+a).toString("utf8"))}function $(t,n){const a=f.dirname(t);return[...n.buffers??[],...n.images??[]].map(s=>s.uri).filter(s=>typeof s=="string"&&!s.startsWith("data:")).map(s=>f.normalize(f.join(a,decodeURIComponent(s))))}export async function missingFiles(t,n){try{const a=await T(x(t,n)),m=N(a,/\.glb$/i.test(n)),s=[];for(const c of $(n,m))await M(x(t,c)).then(i=>i.isFile()).catch(()=>!1)||s.push(c);return s}catch{return[]}}function A(t){const n=t.nodes??[],a=[],m=new Set,s=(i,r)=>{if(m.has(i))return;m.add(i);const d=n[i];if(!d)return;const l=d.name!==void 0&&d.name!==""?d.name:`Node[${String(i)}]`,g=r===""?l:`${r}/${l}`;d.name&&a.push({name:d.name,path:g});for(const w of d.children??[])s(w,g)},c=t.scenes?.[t.scene??0];for(const i of c?.nodes??[])s(i,"");return a}async function L(t,n,a){try{const{validateBytes:m}=await p("gltf-validator"),c=(await m(new Uint8Array(a),{uri:f.basename(n),maxIssues:200,externalResourceFunction:async i=>new Uint8Array(await T(x(t,f.dirname(n),decodeURIComponent(i))))})).issues;return{errors:c.numErrors,warnings:c.numWarnings,infos:c.numInfos,hints:c.numHints,messages:c.messages.slice(0,F).map(i=>({code:i.code,severity:i.severity,message:i.message,...i.pointer?{pointer:i.pointer}:{}}))}}catch{return}}const u=t=>Math.round(t*1e6)/1e6;export async function modelInfo(t,n,a){const m=/\.glb$/i.test(n);let s;try{s=N(a,m)}catch(l){return{container:m?"glb":"gltf",extensionsUsed:[],extensionsRequired:[],unsupported:[],missing:[],nodes:[],skins:0,morphTargets:0,cameras:0,lights:0,contentsMissing:`its description could not be read: ${l.message}`}}const c=s.extensionsRequired??[],i=s.extensions?.KHR_lights_punctual?.lights?.length??0,r={container:m?"glb":"gltf",...s.asset?.generator?{generator:s.asset.generator}:{},...s.asset?.copyright?{copyright:s.asset.copyright}:{},...(s.extensionsUsed??[]).includes("KHR_xmp_json_ld")?{rights:!0}:{},extensionsUsed:s.extensionsUsed??[],extensionsRequired:c,unsupported:c.filter(l=>!I.has(l)),missing:await missingFiles(t,n),nodes:A(s),skins:s.skins?.length??0,morphTargets:(s.meshes??[]).filter(l=>(l.primitives??[]).some(g=>(g.targets?.length??0)>0)).length,cameras:s.cameras?.length??0,lights:i},d=await L(t,n,a);if(d&&(r.validator=d),r.missing.length>0)return r.contentsMissing=`it names files that are not there (${r.missing.join(", ")})`,r;try{const[{NodeIO:l},{ALL_EXTENSIONS:g},{inspect:w},v,{MeshoptDecoder:E}]=await Promise.all([p("@gltf-transform/core"),p("@gltf-transform/extensions"),p("@gltf-transform/functions"),p("draco3dgltf"),p("meshoptimizer")]),b=new Set(g.map(e=>e.EXTENSION_NAME)),H=c.filter(e=>!b.has(e));if(H.length>0)return r.contentsMissing=`glTF-Transform does not read ${H.join(", ")}`,r;await E.ready;const K=new l().registerExtensions(g).registerDependencies({"draco3d.decoder":await v.createDecoderModule(),"meshopt.decoder":E}),R=m?await K.readBinary(new Uint8Array(a)):await K.read(x(t,n)),h=w(R),y=h.scenes.properties[0];if(y){const e=y.bboxMin,o=y.bboxMax,S=[u(o[0]-e[0]),u(o[1]-e[1]),u(o[2]-e[2])];r.bounds={min:[u(e[0]),u(e[1]),u(e[2])],max:[u(o[0]),u(o[1]),u(o[2])],size:S,largest:Math.max(...S)}}const _=h.meshes.properties;r.counts={nodes:R.getRoot().listNodes().length,meshes:_.length,primitives:_.reduce((e,o)=>e+o.meshPrimitives,0),triangles:_.reduce((e,o)=>e+o.glPrimitives*Math.max(1,o.instances),0),instances:_.reduce((e,o)=>e+o.instances,0)},r.materials=R.getRoot().listMaterials().map(e=>({name:e.getName(),extensions:e.listExtensions().map(o=>o.extensionName)})),r.textures=h.textures.properties.map(e=>({name:e.name,mimeType:e.mimeType,...e.resolution?{width:Number(e.resolution.split("x")[0]),height:Number(e.resolution.split("x")[1])}:{},bytes:e.size,...e.gpuSize!==null?{gpuBytes:e.gpuSize}:{}})),r.animations=h.animations.properties.map(e=>({name:e.name,duration:u(e.duration),channels:e.channels}))}catch(l){r.contentsMissing=`glTF-Transform could not read it: ${l.message.split(`
+`)[0]??""}`}return r}

package/dist/node_modules/@allyhub/build/dist/plugin.d.ts

@@ -0,0 +1,42 @@
+import { type MediaInfo } from "@allyhub/video-core";
+import type { Plugin } from "./vite.js";
+export interface PluginOptions {
+    root: string;
+    /** Project path → media. */
+    media: Readonly<Record<string, MediaInfo>>;
+    /**
+     * The modules run in Node (the metadata worker), not bundled for the
+     * stage: a media value's url is its tree path (`media/<path>`), which
+     * nothing in Node loads.
+     */
+    inNode?: boolean;
+    /** Package names package.json declares. */
+    dependencies: ReadonlySet<string>;
+    /** The project's font stylesheets (fontStyles), read each time `allyhub:fonts` is made. */
+    fonts?: () => readonly string[];
+    /** The stage's entry files (absolute): each imports `allyhub:fonts` at its end. */
+    stageEntries?: ReadonlySet<string>;
+    /**
+     * Packages a host lends a project that does not declare them (a scenery
+     * host: its layer, the scenery maths, its three.js): each by name, with a
+     * file it is resolved from (the host's package.json), so every importer
+     * gets that one copy.
+     */
+    lent?: Readonly<Record<string, string>>;
+}
+/**
+ * A project file's address in the tree a build is served in (`media/`
+ * and its path), relative to the tree's root: what a source names.
+ */
+export declare const mediaHref: (path: string) => string;
+/**
+ * The folder of the SDK the build lends a project that declares none: the
+ * one this toolchain carries, with its docs/ beside its code.
+ */
+export declare function lentSdk(): string | undefined;
+/** The module a project file imports as the SDK: the SDK bound to that file. */
+export declare function boundSdk(file: string): string;
+/** The module a project file imports as @allyhub/sdk/slides: presentation() bound to that file. */
+export declare function boundSlides(file: string): string;
+export declare function allyhubPlugin(options: PluginOptions): Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/node_modules/@allyhub/build/dist/plugin.js

@@ -0,0 +1,13 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{realpathSync as j}from"node:fs";import{readFile as J}from"node:fs/promises";import{builtinModules as w}from"node:module";import{dirname as L,isAbsolute as u,relative as v,sep as W}from"node:path";import{fileURLToPath as D}from"node:url";import{manifoldFiles as U}from"@allyhub/model/build";import{mediaKindOf as _}from"@allyhub/video-core";import{parseCsv as E,parseData as I}from"./data.js";import{FONTS_MODULE as S,fontsModule as B}from"./fonts.js";import{LENT as T,SDK as i,currentName as H,packageName as M}from"./scan.js";const f="\0allyhub-blocked:",P="manifold-3d/manifold",m="\0allyhub-sdk:",p="\0allyhub-sdk-slides:",F=`\0${S}`,A=new Set([...w,...w.map(n=>`node:${n}`)]),N=n=>n.replace(/[?#].*$/u,"");export const mediaHref=n=>`media/${n.split("/").map(encodeURIComponent).join("/")}`;const C=n=>`new URL(${JSON.stringify(`../../${mediaHref(n)}`)}, __allyhubHere).href`;export function lentSdk(){try{return L(D(import.meta.resolve(`${i}/package.json`)))}catch{return}}export function boundSdk(n){return[`export * from ${JSON.stringify(i)};`,`import { sdkFor } from ${JSON.stringify(i)};`,`export const { video, part, take, footage } = sdkFor({ file: ${JSON.stringify(n)} });`,""].join(`
+`)}export function boundSlides(n){return[`export * from ${JSON.stringify(`${i}/slides`)};`,`import { presentationFor } from ${JSON.stringify(`${i}/slides`)};`,`export const presentation = presentationFor(${JSON.stringify(n)});`,""].join(`
+`)}export function allyhubPlugin(n){const{root:o}=n,g=[o];try{const t=j.native(o);t!==o&&g.push(t)}catch{}const O=t=>{for(const e of g){const r=v(e,t);if(!r.startsWith("..")&&!u(r))return r}},c=t=>(O(t)??v(o,t)).split(W).join("/"),h=t=>O(t)!==void 0,$=t=>t.split(W).includes("node_modules"),b=t=>{try{return D(import.meta.resolve(t))}catch{return`${f}${t}`}};return{name:"allyhub",enforce:"pre",async resolveId(t,e,r){if(t===S)return F;if(t===P&&!n.dependencies.has("manifold-3d"))return(await U()).js;if(t.startsWith(m)||t.startsWith(p))return t;if(t.startsWith("\0"))return null;const s=e?N(e):void 0,y=s!==void 0&&u(s)&&h(s)&&!$(s);if(/^(https?:)?\/\//iu.test(t))return`${f}${t}`;const k=H(t);if(k!==t)return this.resolve(k,e,{...r,skipSelf:!1});const a=M(t);if(a===i){if(t===i&&y)return`${m}${c(s)}`;if(t===`${i}/slides`&&y)return`${p}${c(s)}`;const l=await this.resolve(t,e,{...r,skipSelf:!0});return l||(n.dependencies.has(i)?`${f}${t}`:b(t))}const x=n.lent?.[a];if(x!==void 0&&!n.dependencies.has(a))return await this.resolve(t,x,{...r,skipSelf:!0})??`${f}${t}`;if(T.has(a))return n.dependencies.has(a)?null:b(t);if(!y)return null;if(!t.startsWith(".")&&!t.startsWith("/")&&!u(t)&&!A.has(t))return n.dependencies.has(a)?null:`${f}${t}`;const d=await this.resolve(t,e,{...r,skipSelf:!0});if(d&&!d.external){const l=N(d.id);if(u(l)&&!h(l)&&!$(l))return`${f}${t}`}return d},async load(t){if(t===F)return B(o,n.fonts?.()??[]);if(t.startsWith(p))return boundSlides(t.slice(p.length));if(t.startsWith(m))return boundSdk(t.slice(m.length));if(t.startsWith(f)){const r=`AllyHub blocked the import of ${t.slice(f.length)}`;return`throw new Error(${JSON.stringify(r)});
+export default undefined;
+`}if(t.startsWith("\0")||/[?#]/u.test(t)||!u(t)||!h(t)||$(t))return null;const e=c(t);if(_(e)){const r=n.media[e];if(!r)return null;const s=n.inNode?JSON.stringify(mediaHref(e)):C(e);return`import { media } from ${JSON.stringify(`${i}/media`)};
+const __allyhubHere = import.meta.url;
+export default media({ ...${JSON.stringify(r)}, url: ${s} });
+`}return/\.csv$/iu.test(e)?`export default ${JSON.stringify(E(await J(t,"utf8")))};
+`:/\.ya?ml$/iu.test(e)?`export default ${JSON.stringify(I(e,await J(t,"utf8")))};
+`:null},transform(t,e){const r=N(e);return n.stageEntries?.has(r)?{code:`${t}
+import ${JSON.stringify(S)};
+`,map:null}:null}}}