allyhub 0.7.1 → 0.8.0

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

@@ -0,0 +1,115 @@
+import { type SlidesFile, type Config, type Item } from "@allyhub/formats";
+import { type BuildSource, type Combo, type Dims, type FormatEntry, type MatrixPlan, type Problem, type VideoConfig } from "@allyhub/video-core";
+import { type DeckCode } from "@allyhub/slides-core";
+import { type DocInfo, type SheetInfo } from "./content.js";
+import { readData } from "./data.js";
+import { type MediaTable } from "./media.js";
+import { type ProjectMessages } from "./messages.js";
+import { type Plugin, type StageBundle } from "./vite.js";
+/** A piece as the build knows it. */
+export interface PieceInfo {
+    id: string;
+    /** Its id came from its code (video({ id })), or is its folder. */
+    idFrom: "code" | "path";
+    kind: "video" | "slides";
+    /** Its folder and its entry file. */
+    dir: string;
+    file: string;
+    /** Its folder, from the project's root. */
+    place: string;
+    title?: string | Record<string, string>;
+    /** Its one format: as written, or the project's default. */
+    format: string;
+    formatEntry: FormatEntry;
+    /** Dimensions, `lang` filled in from the project's languages. */
+    dims: Dims;
+    /** Every combo it makes, in order. */
+    combos: Combo[];
+    matrix?: MatrixPlan;
+    /** Its output's options, as read in Node. */
+    options: Record<string, unknown>;
+    meta: Record<string, unknown>;
+    /** A deck's: its slides.yaml as read (none when it has none or it is not the format), its size in EMU, and its layouts', components' and generators' names. */
+    deck?: {
+        file?: SlidesFile;
+        size: [width: number, height: number];
+        layouts: string[];
+        components: Record<string, unknown>;
+        generators: string[];
+        /** What its code made, as data (slides-core's DeckCode), run here in Node: what its stage and its editor resolve its slides from. */
+        code: DeckCode;
+        /** The data files its charts and generators read, by the path as written: what an editor resolves its charts with. */
+        data: Record<string, unknown>;
+    };
+}
+/** A component a project's file defines (`defineComponent`), as the build found it. */
+export interface ProjectComponent {
+    name: string;
+    /** Its name for people, as `info.label` gives it. */
+    label?: string | Readonly<Record<string, string>>;
+    /** Its file, from the project's folder. */
+    file: string;
+    /** The export it is. */
+    export: string;
+}
+export interface Prepared {
+    root: string;
+    files: string[];
+    items: Item[];
+    config: Config & VideoConfig;
+    /** The format a piece that names none renders in. */
+    defaultFormat: string;
+    dependencies: string[];
+    messages: ProjectMessages;
+    media: MediaTable;
+    data: Awaited<ReturnType<typeof readData>>;
+    docs: DocInfo[];
+    sheets: SheetInfo[];
+    pieces: PieceInfo[];
+    /** The project's components (defineComponent): each one's name and file. */
+    /** The components the project's files define: each its name, its name for people, its file and the export it is. */
+    components: ProjectComponent[];
+    fonts: string[];
+    /** The stage's bundles, when they were made. */
+    bundle?: {
+        dir: string;
+        chunks: StageBundle;
+    };
+    problems: Problem[];
+}
+export interface PrepareOptions {
+    /** Bundle every piece for the stage into this folder; without it nothing is bundled. */
+    buildDir?: string;
+    /** Deadline of one module's metadata, ms. */
+    metaTimeout?: number;
+    /**
+     * What a host adds to the stage's bundles: its plugins (after AllyHub's)
+     * and the packages they lend, which a project need not declare.
+     */
+    host?: {
+        plugins: readonly Plugin[];
+        lent: Readonly<Record<string, string>>;
+    };
+}
+export declare function prepare(root: string, options?: PrepareOptions): Promise<Prepared>;
+/** Where a build's bundles are in the tree the stage is served in. */
+export declare const BUILD_FOLDER = "build/";
+/** An item's name in a build: its bundle's entry and its `sources/<name>.json`. */
+export declare const stageName: (id: string) => string;
+/** What the stage loads: a piece, or a doc that shows components. */
+export type StageItem = PieceInfo | DocInfo;
+/** A stage item's id: a piece's, or a doc's place. */
+export declare const stageId: (item: StageItem) => string;
+/** The item an id names that the stage loads: a piece, or a doc that shows components. */
+export declare function stageItem(prepared: Pick<Prepared, "pieces" | "docs">, id: string): StageItem | undefined;
+/**
+ * One piece as the runtime loads it, its addresses relative to the root
+ * of the tree the stage is served in: its bundles under `build/`, the
+ * project's files under `media/` (mediaHref). The stage resolves them.
+ */
+export declare function sourceOf(prepared: Prepared, item: PieceInfo | DocInfo): BuildSource;
+/** A deck's pixels: its size at 144 dots an inch (a 16:9 deck is 1920 × 1080). */
+export declare const DECK_DPI = 144;
+/** The stage's size of a deck, as a WxH format. */
+export declare const deckFormat: ([w, h]: readonly [number, number]) => string;
+//# sourceMappingURL=prepare.d.ts.map

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

@@ -0,0 +1,4 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{mkdir as ae,readFile as z,readdir as ce,writeFile as le}from"node:fs/promises";import{join as x,posix as de}from"node:path";import{BAKE_DIR as G,CACHE_DIR as fe,CONFIG_FILES as me,ConfigSchema as W,SLIDES_FILE as j,TEXT_DIR as D,scanItems as ue,slidesFileFor as X}from"@allyhub/formats";import{PieceMeta as he,VIDEO_FORMAT_HELP as pe,VideoConfigSchema as ge,VideoOptionsMeta as be,formatName as we,isVideoFormat as ye,looksOf as Q,messagePrefix as $e,parseComponentRef as ke,problem as p,resolveDims as C}from"@allyhub/video-core";import{checkDeck as xe,readSlidesFile as ve}from"@allyhub/slides-core";import{readDocs as Se,readSheets as Oe,readWebsites as Me}from"./content.js";import{readData as Ee}from"./data.js";import{dependenciesOf as je,listFiles as Ae}from"./files.js";import{fontStyles as Fe}from"./fonts.js";import{resolveMatrix as Y}from"./matrix.js";import{readMedia as Ke}from"./media.js";import{deckReferences as De,referenceModule as Te}from"./references.js";import{mergeScripts as Z,readMessages as Ie}from"./messages.js";import{MetaLoader as _e}from"./meta.js";import{allyhubPlugin as Pe,mediaHref as ee}from"./plugin.js";import{checkImports as Re,discover as te,parse as Ce}from"./scan.js";import{writeMessageTypes as Ne}from"./types.js";import{bundleForStage as Le,loadUserVite as He}from"./vite.js";import{nodeStackPlace as T}from"./places.js";function Ve(e){switch(e.code){case"two-entries":return p("AK-M003",`${e.dir} has more than one entry file (${e.entries.join(", ")}): an item has one. Remove all but one.`,{where:{file:e.entries[0]??e.dir}});case"nested":return p("AK-M003",`${e.dir} is an item inside the item ${e.inside}: items do not nest. Move it out.`,{where:{file:e.dir}});case"at-root":return p("AK-M002",`${e.entry} is at the project's root: an item is a folder of its own. Move it into one.`,{where:{file:e.entry}})}}function N(e,s,t){const o=t?`${s} (at ${t.file}:${String(t.line)}:${String(t.column)})`:s,c=/\b(window|document|navigator|self|HTMLElement|customElements) is not defined/u.test(s);return p("AK-R001",c?`${e} uses something at its top level that only exists in the browser (${o}). The top level of a piece module must load in Node: move it into the output's function, or import it inside a component.`:`Failed to load ${e}: ${o}`,{where:t?{file:t.file,line:t.line}:{file:e}})}const L=e=>e.issues.map(s=>`${s.path.map(String).join(".")||"(root)"}: ${s.message}`).join("; ");async function qe(e){return(await ce(x(e,G)).catch(()=>[])).filter(t=>/^[0-9a-f]+\.[\w-]+\.bin$/u.test(t)).map(t=>`${G}/${t}`)}export async function prepare(e,s={}){const t=[],o=await Ae(e),c=ue(o);for(const i of c.problems)t.push(Ve(i));const m=await je(e),l=await Ke(e,[...o,...await qe(e)]),r=new _e({root:e,media:l,dependencies:[...m],user:!0,...s.host?{lent:{...s.host.lent}}:{}},s.metaTimeout);try{let i=W.parse({});const d=me.find(n=>o.includes(n));if(d){const n=await r.request({type:"config",file:d});if(t.push(...n.problems),!n.ok)t.push(N(d,n.error??"",T(n.stack,e)));else{const h=W.safeParse(n.value??{}),a=ge.safeParse(n.value??{});h.success&&a.success?i={...h.data,...a.data}:t.push(p("AK-M001",`${d} is not valid: ${[h.error,a.error].flatMap(b=>b?[L(b)]:[]).join("; ")}.`,{where:{file:d}}))}}const y=i.defaults?.format??"16x9",g=Fe(e,i);for(const n of g.missing)t.push(p("AK-A001",`allyhub.config's fonts name ${n}, which is not in the project or its packages.`,{where:{file:d??"allyhub.config.ts"}}));const u=await Ie(e,o,{...i.locales?{locales:i.locales}:{},text:i.text??D});t.push(...u.problems);const v=await Oe(e,c.items,r),O={...await Ee(e,o,i.text??D),...v.data},M=await Se(e,c.items,o,r,O);t.push(...M.problems,...v.problems,...await Me(e,c.items));const A=o.filter(n=>/\.(ts|tsx|js|jsx|mts|mjs)$/u.test(n)&&!n.endsWith(".d.ts")),f=new Map;for(const n of A){const h=Ce(n,await z(x(e,n),"utf8"));f.set(n,h),t.push(...Re(n,h,m,new Set(Object.keys(s.host?.lent??{}))))}const $=[];for(const[n,h]of f){if(!te(n,h).components)continue;const a=await r.request({type:"components",file:n});if(t.push(...a.problems),!!a.ok)for(const b of a.value??[])typeof b.name=="string"&&typeof b.export=="string"&&$.push({name:b.name,file:n,export:b.export,...typeof b.label=="string"||typeof b.label=="object"&&b.label!==null?{label:b.label}:{}})}const E=[],I=new Map;for(const n of c.items){if(n.kind==="slides"){const S=await ze(n,{root:e,meta:r,messages:u,media:l,ids:I,problems:t,tables:Object.fromEntries(Object.entries(v.data).map(([oe,re])=>[oe,re.value]))});S&&E.push(S);continue}if(n.kind!=="video")continue;const h=f.get(n.entry);if(h){const S=te(n.entry,h);if(t.push(...S.problems),!S.piece&&S.problems.length>0)continue}const a=await r.request({type:"piece",file:n.entry});if(t.push(...a.problems),!a.ok){a.error!=="timeout"&&t.push(N(n.entry,a.error??"",T(a.stack,e)));continue}const b={...a.value};delete b.written;const w=he.safeParse(b);if(!w.success){t.push(p("AK-M001",`The piece in ${n.entry} is not valid: ${L(w.error)}.`,{where:{file:n.entry}}));continue}const k=w.data.id??n.dir,q=I.get(k);if(q!==void 0){t.push(p("AK-B001",`${n.entry} and ${q} both have the piece id ${k}. Give one of them another (video({ id, … })).`,{where:{file:n.entry}}));continue}I.set(k,n.entry),t.push(...Z(u,[{id:k,dir:n.dir}]));const[B]=Object.values(w.data.outputs);if(!B)continue;const ie=n.kind,J=w.data.format??y,P=we(J);if(!ye(P)){t.push(p("AK-G001",`${n.entry} cannot render in the format "${P}". Use ${pe}.`,{piece:k,where:{file:n.entry}}));continue}const R=be.safeParse(B.options);if(!R.success){t.push(p("AK-M001",`The video of ${n.entry} is not valid: ${L(R.error)}.`,{piece:k,where:{file:n.entry}}));continue}const U=C(w.data.matrix?.dims,{locales:u.locales}),K=await Y({root:e,piece:k,file:n.entry,dims:U,matrix:w.data.matrix,files:o});t.push(...K.problems),E.push({id:k,idFrom:w.data.id===void 0?"path":"code",kind:ie,dir:n.dir,file:n.entry,place:n.dir,...w.data.title===void 0?{}:{title:w.data.title},format:P,formatEntry:J,dims:U,combos:K.combos,...K.plan?{matrix:K.plan}:{},options:R.data,meta:w.data.meta??{}})}const F=u.locales[0];await Ne(e,F===void 0?{}:u.messages[F]??{},F===void 0?void 0:u.files[F]);let _;const H=M.docs.filter(n=>n.components.length>0);if(s.buildDir&&(E.length>0||H.length>0)){const n=Object.fromEntries(await Promise.all([...E.map(async a=>[stageName(a.id),await Be(e,a)]),...H.map(async a=>[stageName(a.place),await se(e,stageName(a.place),{of:a.file,components:a.components})])])),h=await He(e);try{const a=await Le({root:e,entries:n,outDir:s.buildDir,plugins:[Pe({root:e,media:l,dependencies:m,fonts:()=>g.styles,stageEntries:new Set(Object.values(n)),...s.host?{lent:s.host.lent}:{}}),...s.host?.plugins??[]],...h?{user:h}:{}});_={dir:s.buildDir,chunks:a}}catch(a){t.push(p("AK-R001",`The pieces could not be bundled for the stage: ${a.message.split(`
+`).slice(0,3).join(" ")}`,{}))}}const V=new Set;return{root:e,files:o,items:c.items,config:i,defaultFormat:y,dependencies:[...m].sort(),messages:u,media:l,data:O,docs:M.docs,sheets:v.sheets,pieces:E,components:$,fonts:g.styles,..._?{bundle:_}:{},problems:t.filter(n=>{const h=`${n.code}|${n.message}|${n.where?.file??""}|${String(n.where?.line??"")}`;return V.has(h)?!1:(V.add(h),!0)})}}finally{await r.close()}}export const BUILD_FOLDER="build/",stageName=e=>e.replaceAll("/","__"),stageId=e=>"components"in e?e.place:e.id;export function stageItem(e,s){return e.pieces.find(t=>t.id===s)??e.docs.find(t=>t.place===s&&t.components.length>0)}async function se(e,s,t){const o=x(e,fe,"stage-entries");await ae(o,{recursive:!0});const c=x(o,`${s}.ts`),m=[...new Set(t.components.map(r=>r.module))],l=[`// The components ${t.of} shows by their module (generated by the build).`,...t.deck===void 0?[]:[`export { default } from ${JSON.stringify(x(e,t.deck))};`],...m.map((r,i)=>`import * as m${String(i)} from ${JSON.stringify(x(e,r))};`),"export const components = {",...t.components.map(r=>`  ${JSON.stringify(r.of)}: m${String(m.indexOf(r.module))}[${JSON.stringify(r.name)}],`),"};",""];return await le(c,l.join(`
+`)),c}async function Be(e,s){const t=de.dirname(s.file),o=De(s.deck?.file).flatMap(c=>{const m=Te(t,c),l=ke(c);return m!==void 0&&l?[{of:c,module:m,name:l.name}]:[]});return o.length===0?x(e,s.file):se(e,stageName(s.id),{of:X(s.dir),components:o,deck:s.file})}export function sourceOf(e,s){if("components"in s)return Ue(e,s);const t=s,o=BUILD_FOLDER,c=stageName(t.id),m=e.bundle?.chunks.entries[c];if(!m)throw new Error(`${t.id} was not bundled for the stage.`);const l=new Set,r=(i,d)=>{if(d.has(i))return;d.add(i);const y=e.bundle?.chunks.chunks[i];if(y){for(const g of y.css)l.add(`${o}${g}`);for(const g of y.imports)r(g,d)}};return r(m.file,new Set),{piece:t.id,file:t.file,module:`${o}${m.file}`,styles:[...l],dims:t.dims,...t.matrix?{matrix:{space:t.matrix.space,rules:t.matrix.rules}}:{},format:t.format,locales:e.messages.locales,messages:e.messages.messages,anchors:e.messages.anchors,text:e.config.text??D,media:Object.fromEntries(Object.entries(e.media).map(([i,d])=>[i,{...d,url:ee(i)}])),data:e.data,...t.kind==="slides"?{kind:"slides",slides:t.deck?.file??{slides:[]},...t.deck?{code:t.deck.code}:{}}:{},...Q(e.config),pieces:Object.fromEntries(e.pieces.map(i=>[i.id,{file:i.file,dims:i.dims,format:i.format,...i.matrix?{matrix:{space:i.matrix.space,rules:i.matrix.rules}}:{}}]))}}const Je="1920x1080";function Ue(e,s){const t=stageName(s.place),o=e.bundle?.chunks.entries[t];if(!o)throw new Error(`${s.place} shows no component: it has no stage bundle.`);const c=new Set,m=(l,r)=>{if(r.has(l))return;r.add(l);const i=e.bundle?.chunks.chunks[l];if(i){for(const d of i.css)c.add(`${BUILD_FOLDER}${d}`);for(const d of i.imports)m(d,r)}};return m(o.file,new Set),{kind:"doc",piece:s.place,file:s.file,module:`${BUILD_FOLDER}${o.file}`,styles:[...c],dims:C(void 0,{locales:e.messages.locales}),format:Je,locales:e.messages.locales,messages:e.messages.messages,anchors:e.messages.anchors,text:e.config.text??D,media:Object.fromEntries(Object.entries(e.media).map(([l,r])=>[l,{...r,url:ee(l)}])),data:e.data,...Q(e.config)}}export const DECK_DPI=144;const ne=914400;export const deckFormat=([e,s])=>`${String(Math.round(e/ne*DECK_DPI))}x${String(Math.round(s/ne*DECK_DPI))}`;async function ze(e,s){const t=e.dir,o=s.ids.get(t);if(o!==void 0){s.problems.push(p("AK-B001",`${e.entry} and ${o} both have the piece id ${t}.`,{where:{file:e.entry}}));return}s.ids.set(t,e.entry),s.problems.push(...Z(s.messages,[{id:t,dir:e.dir}]));const c=X(e.dir),m=f=>({file:c,...f===void 0?{}:{line:f}});let l,r=()=>{},i;try{i=await z(x(s.root,c),"utf8")}catch{s.problems.push(p("AK-M011",`The deck ${e.dir} has no ${j}: its slides are listed there, each on one of slides.ts's layouts (slides: [{ id: cover, layout: Title Slide }]).`,{piece:t,where:{file:c}}))}const d=i===void 0?void 0:ve(i);if(d){r=d.readable?.lineOf??d.lineOf;for(const f of d.problems)s.problems.push(p("AK-M011",`${j}: ${f.message}`,{piece:t,where:m(f.line)}));l=d.readable?.file}const y=s.problems.length,g=await s.meta.request({type:"deck",file:e.entry,slides:l,words:Object.fromEntries(s.messages.locales.map(f=>[f,s.messages.messages[f]??{}])),prefix:$e(t),tables:s.tables});if(s.problems.push(...g.problems),!g.ok){g.error!=="timeout"&&s.problems.push(N(e.entry,g.error??"",T(g.stack,s.root)));return}const u=g.value,v=f=>{const $=T(f.stack,s.root);return $?{file:$.file,line:$.line}:m(f.path===void 0?void 0:r(f.path))};for(const f of[...u.problems,...xe(u.resolved,{mediaKind:$=>s.media[$]?.kind})])s.problems.push(p("AK-M011",f.stack===void 0?`${j}: ${f.message}`:f.message,{piece:t,...f.slide===void 0?{}:{part:f.slide},where:v(f)}));if(u.resolved.slides.length===0){s.problems.length===y&&d?.file&&s.problems.push(p("AK-K003",d.file.slides.length===0?`The deck has no slides: its ${j} lists none (slides: [{ id: cover, layout: Title Slide }]).`:`The deck has no slides: its ${j} lists only generators, and they made none.`,{piece:t,where:m(r("slides"))}));return}const O=C(void 0,{locales:s.messages.locales}),M=await Y({root:s.root,piece:t,file:e.entry,dims:O,matrix:void 0,files:[]}),A=deckFormat(u.size);return{id:t,idFrom:"path",kind:"slides",dir:e.dir,file:e.entry,place:t,...u.title===void 0?{}:{title:u.title},format:A,formatEntry:A,dims:O,combos:M.combos,options:{},meta:{},deck:{...l?{file:l}:{},size:u.size,layouts:u.layouts,components:u.components,generators:u.generators,code:u.code,data:u.data}}}

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

@@ -0,0 +1,6 @@
+import type { SlidesFile } from "@allyhub/formats";
+/** The components a deck's slides.yaml names by their module, each once. */
+export declare function deckReferences(file: SlidesFile | undefined): string[];
+/** A component reference's module, from the project's folder; undefined when it names none. */
+export declare function referenceModule(base: string, of: string): string | undefined;
+//# sourceMappingURL=references.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{posix as r}from"node:path";import{parseComponentRef as f}from"@allyhub/video-core";export function deckReferences(o){const e=new Set;for(const n of o?.slides??[])for(const t of Object.values(n.shapes??{}))t.component!==void 0&&f(t.component)!==void 0&&e.add(t.component);return[...e]}export function referenceModule(o,e){const n=f(e);return n?r.normalize(r.join(o,n.path)):void 0}

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

@@ -0,0 +1,50 @@
+import { type Problem } from "@allyhub/video-core";
+/** An ESTree node as oxc gives it. */
+export interface Node {
+    type: string;
+    start: number;
+    end: number;
+    [key: string]: unknown;
+}
+export interface Parsed {
+    program: Node;
+    errors: {
+        message: string;
+        start?: number;
+    }[];
+    source: string;
+}
+export declare function parse(file: string, source: string): Parsed;
+export declare function lineAt(source: string, offset: number): number;
+/** Visits every node that is code (not a type), with its ancestors. */
+export declare function walk(root: Node, visit: (node: Node, parents: readonly Node[]) => void): void;
+/** The SDK an agent writes with. */
+export declare const SDK = "@allyhub/sdk";
+/** What a project may import from the SDK (its package.json "exports"). */
+export declare const SDK_ENTRIES: ReadonlySet<string>;
+/**
+ * Packages the CLI lends by name, pinned, as it lends the SDK: a scenery
+ * imports three.js ("three", "three/addons/…", "three/webgpu") with no
+ * package.json. A project that declares one uses its own.
+ */
+export declare const LENT: ReadonlySet<string>;
+export interface Discovered {
+    /** The file default-exports video(…) or presentation(…) (directly or through a binding). */
+    piece: boolean;
+    /** The file imports defineComponent from @allyhub/sdk. */
+    components: boolean;
+    problems: Problem[];
+}
+export declare function discover(file: string, parsed: Parsed): Discovered;
+/** An import of a lent package by its former name, by its name today. */
+export declare function currentName(spec: string): string;
+/** "lodash/chunk.js" → "lodash"; "@scope/pkg/x" → "@scope/pkg". */
+export declare function packageName(spec: string): string;
+/**
+ * Imports the build may not follow (AK-B005): packages package.json does
+ * not declare, and files outside the project. Type-only imports are fine.
+ */
+export declare function checkImports(file: string, parsed: Parsed, dependencies: ReadonlySet<string>, 
+/** Packages a host lends besides LENT (a scenery host's). */
+lent?: ReadonlySet<string>): Problem[];
+//# sourceMappingURL=scan.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{builtinModules as S}from"node:module";import{parseSync as g,visitorKeys as K}from"oxc-parser";import{problem as f,repoPath as k}from"@allyhub/video-core";export function parse(t,s){const e=g(t,s,{sourceType:"module"});return{program:e.program,errors:e.errors.map(o=>({message:o.message,...o.labels[0]?{start:o.labels[0].start}:{}})),source:s}}export function lineAt(t,s){let e=1;for(let o=0;o<s&&o<t.length;o++)t.charCodeAt(o)===10&&e++;return e}const h=t=>typeof t=="object"&&t!==null&&typeof t.type=="string",I=new Set(["typeAnnotation","typeParameters","typeArguments","returnType","superTypeArguments","implements"]);export function walk(t,s){const e=[],o=n=>{if(n.type.startsWith("TS")){const i=n.expression;h(i)&&(e.push(n),o(i),e.pop());return}if(!((n.type==="ImportDeclaration"||n.type==="ExportNamedDeclaration")&&n.importKind==="type")){s(n,e),e.push(n);for(const i of K[n.type]??Object.keys(n)){if(I.has(i))continue;const a=n[i];if(Array.isArray(a))for(const p of a)h(p)&&o(p);else h(a)&&o(a)}e.pop()}};o(t)}export const SDK="@allyhub/sdk",SDK_ENTRIES=new Set([SDK,`${SDK}/dom`,`${SDK}/media`,`${SDK}/scenery`,`${SDK}/sheets`,`${SDK}/slides`]),LENT=new Set(["three","@allyhub/model"]);function A(t,s,e=SDK){const o=new Set;for(const n of t.body)if(!(n.type!=="ImportDeclaration"||n.source.value!==e))for(const a of n.specifiers??[]){if(a.type!=="ImportSpecifier")continue;const p=a.imported;(p.name??p.value)===s&&o.add(a.local.name)}return o}function y(t){let s=t;for(;["TSAsExpression","TSSatisfiesExpression","ParenthesizedExpression","TSNonNullExpression"].includes(s.type)&&h(s.expression);)s=s.expression;return s}const $=(t,s)=>{if(!t)return!1;const e=y(t);if(e.type!=="CallExpression")return!1;const o=e.callee;return o.type==="Identifier"&&s.has(o.name)},w=[["video",SDK],["presentation",`${SDK}/slides`]];export function discover(t,s){const e=[],{program:o,source:n}=s,i=new Set(w.flatMap(([l,d])=>[...A(o,l,d)])),a=A(o,"defineComponent").size>0,p=o.body,u=p.find(l=>l.type==="ExportDefaultDeclaration"),r=l=>({file:t,line:lineAt(n,l.start)});if(!u)return i.size>0&&/\bexport\s+\{[^}]*\bdefault\b/.test(n)&&e.push(f("AK-M001",`${t} imports ${[...i].join(" and ")}, but its default export is a re-export. An item's entry file writes export default video({ … }) (or presentation(…)) itself: AllyHub does not look in other files.`,{where:{file:t}})),{piece:!1,components:a,problems:e};const c=u.declaration;if($(c,i))return{piece:!0,components:a,problems:e};const m=y(c);if(m.type==="Identifier"){const l=m.name;for(const d of p)if(d.type==="VariableDeclaration")for(const x of d.declarations){const b=x.id;if(b.type==="Identifier"&&b.name===l&&$(x.init,i))return{piece:!0,components:a,problems:e}}}return i.size>0?e.push(f("AK-M001",`${t} imports ${[...i].join(" and ")}, but its default export is not a video(…) or presentation(…) call. Write export default video({ … }) (presentation(…) for a deck), or const film = video({ … }); export default film. AllyHub does not follow factory functions or conditional expressions.`,{where:r(u)})):$(c,new Set(w.map(([l])=>l)))&&e.push(f("AK-M001",`The ${String(y(c).callee.name)} that ${t} calls is not imported from ${SDK}. Write import { video } from "${SDK}" (import { presentation } from "${SDK}/slides" for a deck).`,{where:r(u)})),{piece:!1,components:a,problems:e}}const T=new Set([...S,...S.map(t=>`node:${t}`)]),E="@allyhub-next/";export function currentName(t){return t.startsWith(E)?`@allyhub/${t.slice(E.length)}`:t}export function packageName(t){const s=t.split("/");return t.startsWith("@")?s.slice(0,2).join("/"):s[0]??t}export function checkImports(t,s,e,o=new Set){const n=[],{program:i,source:a}=s;for(const p of i.body){if(!/^(Import|ExportNamed|ExportAll)Declaration$/.test(p.type)||p.importKind==="type"||p.exportKind==="type")continue;const r=p.source?.value;if(typeof r!="string")continue;const c={file:t,line:lineAt(a,p.start)};if(/^(https?:)?\/\//i.test(r)){n.push(f("AK-B005",`${t} imports the remote address ${r}. The build has no network: install it as an npm package, or put it in the project.`,{where:c}));continue}if(r.startsWith(".")||r.startsWith("/")){k(t,r)===void 0&&n.push(f("AK-B005",`${t} imports ${r}, a file outside the project. Put it in the project.`,{where:c}));continue}if(packageName(r)===SDK){SDK_ENTRIES.has(r)||n.push(f("AK-B006",r===`${SDK}/components`?`${t} imports ${r}: the components are not part of the SDK. A project has its own copies: allyhub add lists the starter components and copies one in (allyhub add component/screen-demo).`:`${t} imports ${r}, which ${SDK} does not have. Its entry points: ${[...SDK_ENTRIES].join(", ")}.`,{where:c}));continue}if(T.has(r))continue;const m=packageName(currentName(r));LENT.has(m)||o.has(m)||e.has(packageName(r))||n.push(f("AK-B005",`${t} imports ${r}, but package.json does not declare ${packageName(r)}. Add it with npm install ${packageName(r)}${r.startsWith("@fontsource/")?", or keep the font and a .css of @font-face rules under assets/fonts/":""}.`,{where:c}))}return n}

package/dist/node_modules/@allyhub/build/dist/sheet-code.d.ts

@@ -0,0 +1,34 @@
+import { type GeneratedSheets, type WorkbookFiles } from "@allyhub/sheet";
+import { type Problem } from "@allyhub/video-core";
+import { MetaLoader } from "./meta.js";
+export interface SheetSource {
+    /** Its folder, from the project's root. */
+    dir: string;
+    text: string;
+    /** The CSV files sheet.yaml names that are there, by their paths from its folder. */
+    csv: Map<string, string>;
+    generated?: GeneratedSheets;
+    /** It has a sheet.ts and that did not run: what it makes is missing. */
+    failed: boolean;
+    problems: Problem[];
+}
+/** Whether a sheet's folder has a sheet.ts. */
+export declare const hasSheetCode: (root: string, dir: string) => boolean;
+/** What a sheet's sheet.ts makes, run in `meta`. */
+export declare function runSheetCode(root: string, dir: string, meta: MetaLoader): Promise<{
+    generated?: GeneratedSheets;
+    failed: boolean;
+    problems: Problem[];
+}>;
+/** A sheet's files read, with what its sheet.ts makes. */
+export declare function readSheetSource(root: string, dir: string, o?: {
+    meta?: MetaLoader;
+}): Promise<SheetSource>;
+/** A sheet's folder wherever it is: its project's root and its place in it, or by itself outside `root`. */
+export declare function sheetRoot(root: string, folder: string): {
+    root: string;
+    dir: string;
+};
+/** What a reader of a workbook gives the engine for a sheet's source. */
+export declare function workbookFiles(root: string, source: SheetSource): WorkbookFiles;
+//# sourceMappingURL=sheet-code.d.ts.map

package/dist/node_modules/@allyhub/build/dist/sheet-code.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{builtinModules as h}from"node:module";import{existsSync as w,realpathSync as x}from"node:fs";import{readFile as m}from"node:fs/promises";import{dirname as b,isAbsolute as g,join as p,posix as l,relative as E}from"node:path";import{SHEET_CODE as y,SHEET_FILE as $}from"@allyhub/formats";import{dataFilesOf as v}from"@allyhub/sheet";import{problem as S,repoPath as j}from"@allyhub/video-core";import{dependenciesOf as k}from"./files.js";import{MetaLoader as A}from"./meta.js";import{nodeStackPlace as F}from"./places.js";import{lineAt as I,parse as D,walk as M}from"./scan.js";const C=new Set([...h,...h.map(e=>`node:${e}`)]);export const hasSheetCode=(e,t)=>w(p(e,t,y));async function L(e,t){const a=[],s=new Set,i=async r=>{if(s.has(r))return;s.add(r);const n=await m(p(e,r),"utf8").catch(()=>{});if(n===void 0)return;const f=D(r,n),c=[];M(f.program,o=>{if(o.type!=="ImportDeclaration"&&o.type!=="ImportExpression"&&o.type!=="ExportNamedDeclaration"&&o.type!=="ExportAllDeclaration")return;const u=o.source?.value;typeof u=="string"&&c.push({spec:u,node:o})});for(const{spec:o,node:u}of c){if(C.has(o)){a.push(S("AK-M012",`${r} imports ${o}. sheet.ts reads the project's files with data(), and reaches nothing else.`,{where:{file:r,line:I(n,u.start)}}));continue}if(o.startsWith(".")){const d=j(r,o);d!==void 0&&await i(d)}}};return await i(t),a}export async function runSheetCode(e,t,a){const s=l.join(t,y),i=await L(e,s),r=await a.request({type:"sheet",file:s});if(i.push(...r.problems),!r.ok){if(r.error!=="timeout"){const n=F(r.stack,e);i.push(S("AK-R001",`Failed to run ${s}: ${r.error??""}${n?` (at ${n.file}:${String(n.line)})`:""}`,{where:n?{file:n.file,line:n.line}:{file:s}}))}return{failed:!0,problems:i}}return{generated:r.value,failed:!1,problems:i}}export async function readSheetSource(e,t,a={}){const s=p(e,t),i=await m(p(s,$),"utf8"),r=new Map;for(const c of v(i)){const o=await m(p(s,c),"utf8").catch(()=>{});o!==void 0&&r.set(c,o)}const n={dir:t,text:i,csv:r,failed:!1,problems:[]};if(!hasSheetCode(e,t))return n;const f=a.meta??new A({root:e,media:{},dependencies:[...await k(e)],user:!0});try{const c=await runSheetCode(e,t,f);n.failed=c.failed,n.problems=c.problems,c.generated&&(n.generated=c.generated)}finally{a.meta||await f.close()}return n}export function sheetRoot(e,t){const a=E(x(e),x(t));return a.startsWith("..")||g(a)?{root:b(t),dir:l.basename(t)}:{root:e,dir:a.split("\\").join("/")}}export function workbookFiles(e,t){return{text:t.text,read:a=>t.csv.get(a),generated:t.generated,exists:a=>{const s=l.normalize(l.join(t.dir,a));return!s.startsWith("..")&&w(p(e,s))}}}

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

@@ -0,0 +1,33 @@
+import { type WordsFile } from "@allyhub/formats";
+import { type TranscribeOptions, type ToolOptions } from "@allyhub/media";
+import { type VoiceFrames } from "@allyhub/video-core";
+/** A take's sound every 10 ms, and its level frames as base64 (the media value's envelope). */
+export interface TakeVoice extends VoiceFrames {
+    base64: string;
+}
+/** A take's level and voicing every 10 ms, kept in the media index; undefined when its sound cannot be read. */
+export declare function takeVoice(file: string, root: string, tools?: ToolOptions): Promise<TakeVoice | undefined>;
+export interface MakeWordsOptions extends Omit<TranscribeOptions, "stretch"> {
+    /** The project whose media index keeps the take's sound. */
+    root: string;
+    /** Where to write the words file (default `<name>.words.json` beside the file). */
+    out?: string;
+    /**
+     * Move each word's bounds inward past frames quieter than the take's
+     * speech threshold, so the silence a recognizer puts inside words goes
+     * back between them and cuts land in it (default true).
+     */
+    tighten?: boolean;
+}
+export interface MadeWords {
+    /** The words file written. */
+    path: string;
+    file: WordsFile;
+    /** How many words tightening moved. */
+    tightened: number;
+    /** Every word has a confidence. */
+    confidence: boolean;
+}
+/** A recording's words heard on this computer and written as its words file. */
+export declare function makeWords(file: string, options: MakeWordsOptions): Promise<MadeWords>;
+//# sourceMappingURL=takes.d.ts.map

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

@@ -0,0 +1,3 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{rename as p,writeFile as g}from"node:fs/promises";import{WordsFileSchema as h,wordsFileFor as b}from"@allyhub/formats";import{VOICE_RATE as u,cached as l,decodeMono as w,transcribe as v}from"@allyhub/media";import{measureVoice as y,tightenWords as B}from"@allyhub/video-core";export async function takeVoice(o,c,s={}){const e=await l(o,"voice",{version:1},{root:c},async()=>{const r=y(await w(o,u,s),u);return{hop:r.hop,db:Buffer.from(r.db).toString("base64"),voicing:Buffer.from(r.voicing).toString("base64")}}).catch(()=>{});if(e)return{hop:e.hop,db:Buffer.from(e.db,"base64"),voicing:Buffer.from(e.voicing,"base64"),base64:e.db}}export async function makeWords(o,c){const{root:s,out:e=b(o),tighten:r=!0,...i}=c,a=await v(o,i);let d=a.words.map(({confidence:t,...n})=>t===void 0?n:{...n,confidence:t}),f=0;if(r&&d.length>0){const t=await takeVoice(o,s,i);if(t){const n=B(d,t);d=n.words,f=n.moved}}const m=h.parse({version:1,...i.lang===void 0?{}:{language:i.lang},duration:a.duration,model:a.model,words:d});return await g(`${e}.part`,`${JSON.stringify(m,null,1)}
+`),await p(`${e}.part`,e),{path:e,file:m,tightened:f,confidence:a.confidence}}

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

@@ -0,0 +1,11 @@
+import { type MessagesFile } from "@allyhub/video-core";
+/** Where the generated types go, relative to the project root. */
+export declare const MESSAGE_TYPES = ".allyhub/cache/types/messages.d.ts";
+/** The .d.ts text for a messages file. */
+export declare function messageTypes(messages: MessagesFile, file: string | undefined): string;
+/**
+ * Writes the types into the project when they changed (an unchanged file
+ * keeps its time, so editors and `tsc --watch` stay quiet).
+ */
+export declare function writeMessageTypes(root: string, messages: MessagesFile, file: string | undefined): Promise<void>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1,6 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{randomUUID as y}from"node:crypto";import{mkdir as w,readFile as b,rename as j,writeFile as S}from"node:fs/promises";import{dirname as k,join as M}from"node:path";import{CACHE_DIR as T,TEXT_DIR as v}from"@allyhub/formats";import{messageInputs as x}from"@allyhub/video-core";import{SDK as d}from"./scan.js";export const MESSAGE_TYPES=`${T}/types/messages.d.ts`;const f=n=>JSON.stringify(n);function D(n){const i={leaf:!1,children:new Map};for(const r of n){let t=i;for(const e of r.split(".")){let s=t.children.get(e);s||(s={leaf:!1,children:new Map},t.children.set(e,s)),t=s}t.leaf=!0}return i}function m(n){const i=[...n.children.keys()];if(i.length===0||!i.every(t=>/^\d+$/.test(t)))return;const r=[];for(let t=0;;t++){const e=n.children.get(String(t));if(!e)break;r.push(e)}return r}function E(n,i){if(n.children.size===0)return"string";const r=m(n);return r?`${p(r,i)}[]`:g([...n.children.entries()].map(([t,e])=>[t,[e],!1]),i)}function g(n,i){const r=`${i}  `;return`{
+${[...n].sort((e,s)=>e[0]<s[0]?-1:e[0]>s[0]?1:0).map(([e,s,o])=>`${r}${f(e)}${o?"?":""}: ${p(s,r)};`).join(`
+`)}
+${i}}`}function p(n,i){if(n.length===0)return"never";const r=n.filter(e=>e.children.size>0&&!m(e));if(r.length===n.length&&r.length>0){const e=new Set(r.flatMap(s=>[...s.children.keys()]));return g([...e].map(s=>{const o=r.map(c=>c.children.get(s)).filter(c=>c!==void 0);return[s,o,o.length<r.length]}),i)}const t=[...new Set(n.map(e=>E(e,i)))];return t.length===1?t[0]??"string":t.join(" | ")}export function messageTypes(n,i){const r=Object.keys(n).sort(),t=r.map(o=>{const c=[...x(n[o]).entries()].sort((l,u)=>l[0]<u[0]?-1:1),a=c.length===0?"{}":`{ ${c.map(([l,u])=>`${f(l)}: ${u==="number"?"number":"string | number"}`).join("; ")} }`;return`    ${f(o)}: ${a};`}),e=[],s=(o,c)=>{const a=c?m(o):void 0;a&&a.length>0&&e.push(`    ${f(c)}: ${p(a,"    ")};`);for(const[l,u]of[...o.children.entries()].sort((h,$)=>h[0]<$[0]?-1:1))s(u,c?`${c}.${l}`:l)};return s(D(r),""),[`// Generated by allyhub from ${i??`${v}/ (none yet)`}, the default language.`,"// Do not edit: allyhub check, build and dev write it again.",'// Include it in tsconfig.json: "include": ["**/*.ts", ".allyhub/cache/types"].',`import ${f(d)};`,"",`declare module ${f(d)} {`,"  interface Messages {",...t,"  }","  interface MessageLists {",...e,"  }","}",""].join(`
+`)}export async function writeMessageTypes(n,i,r){const t=M(n,MESSAGE_TYPES),e=messageTypes(i,r);if(await b(t,"utf8").catch(()=>{})===e)return;await w(k(t),{recursive:!0});const o=`${t}.${y()}.tmp`;await S(o,e),await j(o,t)}

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

@@ -0,0 +1,3 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{join as f}from"node:path";import{build as d,createServer as u,createServerModuleRunner as m,loadConfigFromFile as p,mergeConfig as h}from"vite";import{CACHE_DIR as g}from"@allyhub/formats";const y=["plugins","resolve","css","define","json","assetsInclude","oxc"];export async function loadUserVite(e,r="production"){const s=await p({command:r==="production"?"build":"serve",mode:r},void 0,e,"silent",void 0,"runner");if(!s)return;const t={};for(const n of y)s.config[n]!==void 0&&Object.assign(t,{[n]:s.config[n]});return{file:s.path.startsWith(e)?s.path.slice(e.length+1):s.path,config:t}}const l=(e,r,s,t=[])=>{const n={ssr:{noExternal:[...t]}},{plugins:o,...i}=s?.config??{},a=h(n,i),c=o?[o]:[];return{...a,root:e,configFile:!1,envDir:!1,publicDir:!1,logLevel:"silent",clearScreen:!1,plugins:[...r,...c]}};export async function createModuleLoader(e,r,s={}){const t=await u({...l(e,r,s.user,s.inline),mode:s.mode??"production",appType:"custom",server:{middlewareMode:!0,hmr:!1,ws:!1,watch:null},optimizeDeps:{noDiscovery:!0,include:[]}}),n=t.environments.ssr,o=m(n,{hmr:!1});return{async import(i){return o.import(i)},async close(){await o.close(),await t.close()}}}export function compileErrorOf(e){const r=e,s=r.loc?.file??r.id;return{message:(r.message??String(e)).split(`
+`)[0]??"",...s?{file:s.replace(/[?#].*$/,"")}:{},...r.loc?.line===void 0?{}:{line:r.loc.line},...r.loc?.column===void 0?{}:{column:r.loc.column},...r.frame?{frame:r.frame}:{}}}export async function createStageDevServer(e){const r=await u({...l(e.root,e.plugins,e.user),base:e.base,appType:"custom",mode:"development",cacheDir:f(e.root,g,"vite"),server:{middlewareMode:!0,hmr:!1,ws:!1,watch:null,fs:{strict:!0,allow:[e.root,...e.allow]}},optimizeDeps:{noDiscovery:!0,include:[]},build:{target:"es2022"}}),s=r.environments.client.moduleGraph;return{handle(t,n,o){r.middlewares(t,n,o)},changed(t){const n=new Set,o=i=>{const a=i.id??"";if(!n.has(a)){n.add(a);for(const c of i.importers)o(c)}};for(const i of t){for(const a of s.getModulesByFile(i)??[])o(a);s.onFileChange(i)}return n},invalidate(t){for(const n of t){const o=s.getModuleById(n);o&&s.invalidateModule(o)}},async close(){await r.close()}}}function v(e){const r=Array.isArray(e)?e:[e],s={entries:{},chunks:{},files:[]};for(const t of r)if("output"in t)for(const n of t.output){if(n.fileName.endsWith(".map")||s.files.push(n.fileName),n.type!=="chunk")continue;const o=n.viteMetadata,i={file:n.fileName,imports:[...n.imports],dynamicImports:[...n.dynamicImports],css:[...o?.importedCss??[]],assets:[...o?.importedAssets??[]],modules:[...n.moduleIds]};s.chunks[n.fileName]=i,n.isEntry&&(s.entries[n.name]=i)}return s}export async function bundleForStage(e){const r=await d({...l(e.root,e.plugins,e.user),base:"./",mode:"production",build:{outDir:e.outDir,emptyOutDir:!1,write:!0,copyPublicDir:!1,minify:!1,sourcemap:"hidden",target:"es2022",modulePreload:!1,reportCompressedSize:!1,cssCodeSplit:!0,assetsDir:"assets",rolldownOptions:{input:e.entries,preserveEntrySignatures:"exports-only",output:{format:"es",entryFileNames:"pieces/[name].[hash].js",chunkFileNames:"chunks/[name].[hash].js",assetFileNames:"assets/[name].[hash][extname]"}}}});return v(r)}

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

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

package/dist/node_modules/@allyhub/chart/dist/chart-file.d.ts

@@ -0,0 +1,11 @@
+import { type ChartFile } from "@allyhub/formats";
+import { type ChartDef } from "./chart.js";
+export declare function chartOfFile(f: ChartFile, o: {
+    title: string | undefined;
+    /** The folder of the file that writes it (a deck's, a doc's). */
+    base: string;
+    /** A data file's content, by its path from that folder. */
+    rows: (path: string) => unknown;
+    problem: (message: string) => void;
+}): ChartDef | undefined;
+//# sourceMappingURL=chart-file.d.ts.map

package/dist/node_modules/@allyhub/chart/dist/chart-file.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{colorOfFile as j}from"@allyhub/formats";import{isScatter as O,labelPositionsOf as v}from"./chart.js";const l=e=>j(e)??"dk1";function S(e,n){if(n.startsWith("/"))return n.slice(1);const o=e===""?[]:e.split("/");for(const s of n.split("/"))s===""||s==="."||(s===".."?o.pop():o.push(s));return o.join("/")}const w=e=>e&&{...e.min===void 0?{}:{minimum_scale:e.min},...e.max===void 0?{}:{maximum_scale:e.max},...e.major===void 0?{}:{major_unit:e.major},...e.gridlines===void 0?{}:{has_major_gridlines:e.gridlines},...e.visible===void 0?{}:{visible:e.visible},...e.format===void 0?{}:{number_format:e.format},...e.reverse===void 0?{}:{reverse_order:e.reverse},...e.gridline_color===void 0?{}:{gridline_color:l(e.gridline_color)},...e.line_color===void 0?{}:{line_color:l(e.line_color)}},F=e=>{if(!(e===void 0||e===!1))return e===!0?{show_value:!0}:{...e.value===void 0?{}:{show_value:e.value},...e.percentage===void 0?{}:{show_percentage:e.percentage},...e.category===void 0?{}:{show_category_name:e.category},...e.series===void 0?{}:{show_series_name:e.series},...e.format===void 0?{}:{number_format:e.format},...e.position===void 0?{}:{position:e.position},...e.size===void 0?{}:{size:e.size},...e.color===void 0?{}:{color:l(e.color)}}};function $(e){if(typeof e=="number")return Number.isFinite(e)?e:void 0;if(e==null)return null;if(typeof e!="string")return;const n=e.trim();if(n==="")return null;const o=Number(n);return Number.isFinite(o)?o:void 0}export function chartOfFile(e,n){const o=F(e.labels),s=O(e.type);let u,m;const g=r=>({...r.color===void 0?{}:{color:l(r.color)},...r.format===void 0?{}:{number_format:r.format},...r.smooth===void 0?{}:{smooth:r.smooth},...r.line_width===void 0?{}:{line_width:r.line_width},...r.marker_size===void 0?{}:{marker_size:r.marker_size}});if(e.data!==void 0){let r;try{r=n.rows(e.data)}catch(t){n.problem(`${e.data} cannot be read: ${t instanceof Error?t.message:String(t)}`);return}if(!Array.isArray(r)||r.length===0){n.problem(`${e.data} holds no rows.`);return}const i=r,a=e.categories;if(typeof a!="string"){n.problem("with data, categories names its column.");return}const _=Object.keys(i[0]??{}),y=[a,...e.series.map(t=>typeof t=="string"?t:t.name)].filter(t=>!_.includes(t));if(y.length>0){n.problem(`${e.data} has no column ${y.join(", ")} (it has ${_.join(", ")}).`);return}u=i.map(t=>{const d=t[a];return typeof d=="string"||typeof d=="number"?String(d):""}),m=e.series.map(t=>{const d=typeof t=="string"?t:t.name,x=i.map((c,z)=>{const b=$(c[d]);return b===void 0?(n.problem(`${String(e.data)} row ${String(z+1)}: ${JSON.stringify(c[d])} in ${d} is not a number.`),null):b});return{name:d,values:x,...s?{x:i.map(c=>$(c[a])??null)}:{},...typeof t=="string"?{}:g(t)}})}else{if(typeof e.categories=="string"){n.problem("categories names a column, and there is no data to read.");return}if(e.categories===void 0&&!s){n.problem(`a ${e.type} chart has categories.`);return}u=e.categories??[];const r=[];for(const i of e.series){if(typeof i=="string"||!i.values){const a=typeof i=="string"?i:i.name;n.problem(`series ${a} has no values, and there is no data to read.`);return}if(s){if(i.x?.length!==i.values.length){n.problem(`series ${i.name} has an x for each of its values.`);return}}else i.values.length!==u.length&&n.problem(`series ${i.name} has ${String(i.values.length)} values for ${String(u.length)} categories.`);r.push({name:i.name,values:i.values,...s&&i.x?{x:i.x}:{},...g(i)})}m=r}const f=o?.position;f!==void 0&&!v(e.type).includes(f)&&n.problem(`a ${e.type} chart has no label position ${f}, which PowerPoint would repair (it has ${v(e.type).join(", ")||"none"}).`);const p=w(e.value_axis),h=w(e.category_axis);return{type:e.type,categories:u,series:m,...n.title===void 0?{}:{title:n.title},...e.legend===void 0?{}:{legend:e.legend},...o?{labels:o}:{},...e.gap_width===void 0?{}:{gap_width:e.gap_width},...e.overlap===void 0?{}:{overlap:e.overlap},...e.vary_by_categories===void 0?{}:{vary_by_categories:e.vary_by_categories},...e.hole_size===void 0?{}:{hole_size:e.hole_size},...p?{value_axis:p}:{},...h?{category_axis:h}:{},...e.size===void 0?{}:{font_size:e.size},...e.title_size===void 0?{}:{title_size:e.title_size},...e.color===void 0?{}:{font_color:l(e.color)},...e.data===void 0?{}:{source:S(n.base,e.data)}}}

package/dist/node_modules/@allyhub/chart/dist/chart-xml.d.ts

@@ -0,0 +1,33 @@
+import { type ChartDef } from "./chart.js";
+/** The cells a chart's numbers are read through, in its file's spelling. */
+export interface ChartRefs {
+    /** A series' name, or undefined when it is its own text. */
+    name: (series: number) => string | undefined;
+    /** Its categories, or undefined when it has none to name. */
+    categories: string | undefined;
+    /** Whether its categories are numbers (dates, years): a numRef. */
+    numeric?: boolean;
+    /** A series' values. */
+    values: (series: number) => string;
+    /** A scatter series' places across. */
+    x?: (series: number) => string | undefined;
+}
+export interface ChartPart {
+    refs: ChartRefs;
+    /** The plot's place, from the frame in points; absent: the app's own automatic layout. */
+    frame?: {
+        width: number;
+        height: number;
+    };
+    /** The title's cell: it reads the title from there. */
+    titleRef?: string;
+    /** What ends the part: a deck's workbook. */
+    tail?: string;
+    /** Rows a filter or a person hides are left out, as a chart's own option. */
+    plotVisible?: boolean;
+    /** No fill and no line round the chart's own area: it lies on the page, as a doc's does. */
+    frameless?: boolean;
+}
+/** A chart's part. */
+export declare function chartSpaceXml(c: ChartDef, part: ChartPart): string;
+//# sourceMappingURL=chart-xml.d.ts.map

package/dist/node_modules/@allyhub/chart/dist/chart-xml.js

@@ -0,0 +1,3 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{lumOf as X}from"@allyhub/ooxml/brightness";import{accentOf as j,CHART_DEFAULTS as d,chartDrawing as D,groupingOf as z,hasLines as E,hasMarkers as N,isArea as R,isBar as C,isHorizontal as T,isLine as P,isRound as h,isScatter as k,labelPositionOf as U,variesOf as w}from"./chart.js";const V="http://schemas.openxmlformats.org/drawingml/2006/chart",B="http://schemas.openxmlformats.org/drawingml/2006/main",W="http://schemas.openxmlformats.org/officeDocument/2006/relationships",H=`<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+`,y="2118791784",x="2140495176",Z={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;"},q=e=>{const n=e.charCodeAt(0);return n<32&&n!==9&&n!==10&&n!==13||n===65534||n===65535},l=e=>Array.from(e,n=>q(n)?"":Z[n]??n).join("");function r(e,n={},...c){const o=Object.entries(n).filter(([,s])=>s!==void 0).map(([s,i])=>` ${s}="${l(typeof i=="boolean"?i?"1":"0":String(i))}"`).join(""),a=c.join("");return a===""?`<${e}${o}/>`:`<${e}${o}>${a}</${e}>`}const K=e=>{if(typeof e=="string")return r("a:schemeClr",{val:e});if("rgb"in e)return r("a:srgbClr",{val:e.rgb.replace("#","").toUpperCase()});const{lumMod:n,lumOff:c}=X(e.brightness);return r("a:schemeClr",{val:e.theme_color},t("a:lumMod",n),...c===void 0?[]:[t("a:lumOff",c)])},p=e=>e===null?r("a:noFill"):r("a:solidFill",{},K(e)),t=(e,n)=>r(e,{val:typeof n=="boolean"?n?1:0:n}),m=(e,n)=>r("a:ln",n===void 0?{}:{w:Math.round(n*12700)},p(e)),F=(e,n)=>r("c:txPr",{},r("a:bodyPr"),r("a:lstStyle"),r("a:p",{},r("a:pPr",{},r("a:defRPr",e===void 0?{}:{sz:Math.round(e*100)},n===void 0?"":p(n))),r("a:endParaRPr",{lang:"en-US"}))),S=e=>r("c:strCache",{},t("c:ptCount",e.length),...e.map((n,c)=>r("c:pt",{idx:c},`<c:v>${l(n)}</c:v>`))),A=(e,n)=>r("c:numCache",{},`<c:formatCode>${l(e??"General")}</c:formatCode>`,t("c:ptCount",n.length),...n.flatMap((c,o)=>c===null?[]:[r("c:pt",{idx:o},`<c:v>${String(c)}</c:v>`)])),Y=(e,n)=>r("c:tx",{},n===void 0?`<c:v>${l(e.name)}</c:v>`:r("c:strRef",{},`<c:f>${l(n)}</c:f>`,S([e.name]))),J=(e,n)=>n===void 0?"":r("c:xVal",{},r("c:numRef",{},`<c:f>${l(n)}</c:f>`,A("General",e.x??[])));function Q(e,n,c,o){const a=n.color??j(c),s=h(e.type),i=k(e.type),u=P(e.type)||i,g=N(e.type),I=u?r("c:spPr",{},E(e.type)?m(a,n.line_width??d.lineWidth):r("a:ln",{w:19050},p(null))):r("c:spPr",{},p(a),s?m("lt1",1):""),_=o.categories;return r("c:ser",{},t("c:idx",c),t("c:order",c),Y(n,o.name(c)),I,C(e.type)?t("c:invertIfNegative",!1):"",u?r("c:marker",{},t("c:symbol",g?"circle":"none"),g?t("c:size",n.marker_size??d.marker):"",g?r("c:spPr",{},p(a),m(a)):""):"",...w(e)&&!u&&!R(e.type)?e.categories.map((v,f)=>r("c:dPt",{},t("c:idx",f),C(e.type)?t("c:invertIfNegative",!1):"",t("c:bubble3D",!1),r("c:spPr",{},p(e.category_colors?.[f]??j(f)),s?m("lt1",1):""))):[],i?J(n,o.x?.(c)):_===void 0?"":r("c:cat",{},o.numeric===!0?r("c:numRef",{},`<c:f>${l(_)}</c:f>`,A("General",e.categories.map(v=>{const f=Number(v);return v===""||!Number.isFinite(f)?null:f}))):r("c:strRef",{},`<c:f>${l(_)}</c:f>`,S(e.categories))),r(i?"c:yVal":"c:val",{},r("c:numRef",{},`<c:f>${l(o.values(c))}</c:f>`,A(n.number_format,n.values))),u?t("c:smooth",n.smooth===!0||e.type==="scatter-smooth"):"")}function b(e){const n=e.labels;if(!n)return"";const c=n.show_percentage===!0,o=U(e);return r("c:dLbls",{},n.number_format===void 0?"":r("c:numFmt",{formatCode:n.number_format,sourceLinked:0}),n.size===void 0&&n.color===void 0&&!h(e.type)?"":F(n.size,n.color??(h(e.type)?"lt1":void 0)),o===void 0?"":t("c:dLblPos",o),t("c:showLegendKey",!1),t("c:showVal",n.show_value??!c),t("c:showCatName",n.show_category_name===!0),t("c:showSerName",n.show_series_name===!0),t("c:showPercent",c),t("c:showBubbleSize",!1))}function ee(e,n){const c=e.series.map((s,i)=>Q(e,s,i,n)).join(""),o=z(e.type),a=t("c:axId",y)+t("c:axId",x);if(h(e.type)){const s=e.type==="pie";return r(s?"c:pieChart":"c:doughnutChart",{},t("c:varyColors",w(e)),c,b(e),t("c:firstSliceAng",0),s?"":t("c:holeSize",e.hole_size??50))}if(k(e.type))return r("c:scatterChart",{},t("c:scatterStyle","lineMarker"),t("c:varyColors",!1),c,b(e),a);if(C(e.type)){const s=o!=="clustered";return r("c:barChart",{},t("c:barDir",T(e.type)?"bar":"col"),t("c:grouping",o),t("c:varyColors",w(e)),c,b(e),t("c:gapWidth",e.gap_width??150),e.overlap!==void 0||s?t("c:overlap",e.overlap??100):"",a)}return r(P(e.type)?"c:lineChart":"c:areaChart",{},t("c:grouping",o),t("c:varyColors",!1),c,b(e),P(e.type)?t("c:marker",!0):"",a)}const L=e=>r("c:scaling",{},t("c:orientation",e.reverse_order===!0?"maxMin":"minMax"),e.maximum_scale===void 0?"":t("c:max",e.maximum_scale),e.minimum_scale===void 0?"":t("c:min",e.minimum_scale)),O=e=>r("c:spPr",{},m(e.line_color??{rgb:d.axisLine},d.gridWidth)),M=e=>e.has_major_gridlines===!0?r("c:majorGridlines",{},r("c:spPr",{},m(e.gridline_color??{rgb:d.gridline},d.gridWidth))):"",G=(e,n)=>r("c:rich",{},r("a:bodyPr"),r("a:lstStyle"),r("a:p",{},r("a:pPr",{},r("a:defRPr",{sz:n,b:0})),r("a:r",{},r("a:rPr",{lang:"en-US",sz:n,b:0}),`<a:t>${l(e)}</a:t>`))),$=(e,n)=>e===void 0||e===""?"":r("c:title",{},r("c:tx",{},G(e,n)),t("c:overlay",!1));function te(e){if(h(e.type))return"";const n=k(e.type),c=T(e.type),o=e.category_axis??{},a={has_major_gridlines:!0,...e.value_axis},s=z(e.type)==="percentStacked",i=a.number_format??(s?"0%":e.series[0]?.number_format??"General"),u=Math.round((e.font_size??d.fontSize)*100);return(n?r("c:valAx",{},t("c:axId",y),L(o),t("c:delete",o.visible===!1),t("c:axPos","b"),M(o),$(o.title,u),r("c:numFmt",{formatCode:o.number_format??"General",sourceLinked:o.number_format===void 0?1:0}),t("c:majorTickMark","none"),t("c:minorTickMark","none"),t("c:tickLblPos","nextTo"),O(o),t("c:crossAx",x),t("c:crosses","autoZero"),t("c:crossBetween","midCat"),o.major_unit===void 0?"":t("c:majorUnit",o.major_unit)):r("c:catAx",{},t("c:axId",y),L(o),t("c:delete",o.visible===!1),t("c:axPos",c?"l":"b"),M(o),$(o.title,u),r("c:numFmt",{formatCode:"General",sourceLinked:0}),t("c:majorTickMark","none"),t("c:minorTickMark","none"),t("c:tickLblPos","nextTo"),O(o),t("c:crossAx",x),t("c:crosses","autoZero"),t("c:auto",!0),t("c:lblAlgn","ctr"),t("c:lblOffset",100),t("c:noMultiLvlLbl",!1)))+r("c:valAx",{},t("c:axId",x),L(a),t("c:delete",a.visible===!1),t("c:axPos",c?"b":"l"),M(a),$(a.title,u),r("c:numFmt",{formatCode:i,sourceLinked:a.number_format===void 0&&!s?1:0}),t("c:majorTickMark","none"),t("c:minorTickMark","none"),t("c:tickLblPos","nextTo"),r("c:spPr",{},m(null)),t("c:crossAx",y),t("c:crosses","autoZero"),t("c:crossBetween",R(e.type)||n?"midCat":"between"),a.major_unit===void 0?"":t("c:majorUnit",a.major_unit))}const ne={bottom:"b",top:"t",left:"l",right:"r"};function re(e,n){const c=n.width,o=n.height,{plot:a}=D(e,c,o),s=i=>Number(i.toFixed(5));return r("c:layout",{},r("c:manualLayout",{},t("c:layoutTarget","inner"),t("c:xMode","edge"),t("c:yMode","edge"),t("c:x",s(a.x/c)),t("c:y",s(a.y/o)),t("c:w",s(a.width/c)),t("c:h",s(a.height/o))))}export function chartSpaceXml(e,n){const c=e.title!==void 0&&e.title!==""?e.title:void 0,o=e.font_size??d.fontSize,a=Math.round((e.title_size??o*d.titleScale)*100);return H+r("c:chartSpace",{"xmlns:c":V,"xmlns:a":B,"xmlns:r":W},t("c:date1904",!1),t("c:roundedCorners",!1),r("c:chart",{},c===void 0?"":r("c:title",{},r("c:tx",{},n.titleRef===void 0?G(c,a):r("c:strRef",{},`<c:f>${l(n.titleRef)}</c:f>`,S([c]))),t("c:overlay",!1)),t("c:autoTitleDeleted",c===void 0),r("c:plotArea",{},n.frame?re(e,n.frame):r("c:layout"),ee(e,n.refs),te(e)),e.legend===void 0?"":r("c:legend",{},t("c:legendPos",ne[e.legend]),t("c:overlay",e.legend_overlay===!0)),t("c:plotVisOnly",n.plotVisible??!0),t("c:dispBlanksAs","gap")),n.frameless===!0?r("c:spPr",{},r("a:noFill"),r("a:ln",{},r("a:noFill"))):"",F(o,e.font_color??"dk1"),n.tail??"")}