allyhub 0.3.0 → 0.5.0

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

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

package/dist/node_modules/@allyhub-next/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-next/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-next/build/dist/plugin.d.ts

@@ -0,0 +1,33 @@
+import { type MediaInfo } from "@allyhub-next/video-core";
+import type { Plugin } from "./vite.js";
+export interface PluginOptions {
+    root: string;
+    /** Project path → media (its url is made by `mediaUrl`). */
+    media: Readonly<Record<string, MediaInfo>>;
+    /** Where the stage loads a project file from: default `/media/<path>`. */
+    mediaUrl?: (path: string) => string;
+    /** 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>>;
+}
+/**
+ * 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-next/build/dist/plugin.js

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

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

@@ -0,0 +1,93 @@
+import { type SlidesFile, type Config, type Item } from "@allyhub-next/formats";
+import { type BuildSource, type Combo, type Dims, type FormatEntry, type MatrixPlan, type Problem, type VideoConfig } from "@allyhub-next/video-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[];
+    };
+}
+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. */
+    components: {
+        name: string;
+        file: string;
+    }[];
+    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;
+    /** Where the stage loads a project file from (the media values' URLs). */
+    mediaUrl?: (path: string) => 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>;
+/**
+ * One piece as the runtime loads it. `served` names where the stage gets
+ * the build's bundles (an URL ending in "/"), `mediaUrl` a project file.
+ */
+export declare function sourceOf(prepared: Prepared, piece: PieceInfo, served: string, mediaUrl: (path: string) => string): 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-next/build/dist/prepare.js

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

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

@@ -0,0 +1,48 @@
+import { type Problem } from "@allyhub-next/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;
+/** "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-next/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 A}from"node:module";import{parseSync as g,visitorKeys as E}from"oxc-parser";import{problem as f,repoPath as K}from"@allyhub-next/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 d=t=>typeof t=="object"&&t!==null&&typeof t.type=="string",k=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;d(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 E[n.type]??Object.keys(n)){if(k.has(i))continue;const p=n[i];if(Array.isArray(p))for(const a of p)d(a)&&o(a);else d(p)&&o(p)}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-next/model"]);function S(t,s,e=SDK){const o=new Set;for(const n of t.body)if(!(n.type!=="ImportDeclaration"||n.source.value!==e))for(const p of n.specifiers??[]){if(p.type!=="ImportSpecifier")continue;const a=p.imported;(a.name??a.value)===s&&o.add(p.local.name)}return o}function h(t){let s=t;for(;["TSAsExpression","TSSatisfiesExpression","ParenthesizedExpression","TSNonNullExpression"].includes(s.type)&&d(s.expression);)s=s.expression;return s}const y=(t,s)=>{if(!t)return!1;const e=h(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,m])=>[...S(o,l,m)])),p=S(o,"defineComponent").size>0,a=o.body,u=a.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:p,problems:e};const c=u.declaration;if(y(c,i))return{piece:!0,components:p,problems:e};const $=h(c);if($.type==="Identifier"){const l=$.name;for(const m of a)if(m.type==="VariableDeclaration")for(const x of m.declarations){const b=x.id;if(b.type==="Identifier"&&b.name===l&&y(x.init,i))return{piece:!0,components:p,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)})):y(c,new Set(w.map(([l])=>l)))&&e.push(f("AK-M001",`The ${String(h(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:p,problems:e}}const I=new Set([...A,...A.map(t=>`node:${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:p}=s;for(const a of i.body){if(!/^(Import|ExportNamed|ExportAll)Declaration$/.test(a.type)||a.importKind==="type"||a.exportKind==="type")continue;const r=a.source?.value;if(typeof r!="string")continue;const c={file:t,line:lineAt(p,a.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}I.has(r)||LENT.has(packageName(r))||o.has(packageName(r))||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-next/build/dist/sheet-code.d.ts

@@ -0,0 +1,34 @@
+import { type GeneratedSheets, type WorkbookFiles } from "@allyhub-next/sheet";
+import { type Problem } from "@allyhub-next/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-next/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-next/formats";import{dataFilesOf as v}from"@allyhub-next/sheet";import{problem as S,repoPath as j}from"@allyhub-next/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-next/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-next/formats";import{messageInputs as x}from"@allyhub-next/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-next/build/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@allyhub-next/build",
+  "version": "0.5.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-next/chart/dist/chart-xml.d.ts

@@ -0,0 +1,31 @@
+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;
+}
+/** A chart's part. */
+export declare function chartSpaceXml(c: ChartDef, part: ChartPart): string;
+//# sourceMappingURL=chart-xml.d.ts.map

package/dist/node_modules/@allyhub-next/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{accentOf as j,CHART_DEFAULTS as d,chartDrawing as D,groupingOf as z,hasLines as E,hasMarkers as N,isArea as R,isBar as v,isHorizontal as T,isLine as k,isRound as h,isScatter as P,labelPositionOf as O,variesOf as w}from"./chart.js";const U="http://schemas.openxmlformats.org/drawingml/2006/chart",V="http://schemas.openxmlformats.org/drawingml/2006/main",B="http://schemas.openxmlformats.org/officeDocument/2006/relationships",W=`<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+`,x="2118791784",y="2140495176",H={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;"},Z=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=>Z(n)?"":H[n]??n).join("");function o(e,n={},...c){const r=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}${r}/>`:`<${e}${r}>${a}</${e}>`}const q=e=>typeof e=="string"?o("a:schemeClr",{val:e}):o("a:srgbClr",{val:e.rgb.replace("#","").toUpperCase()}),f=e=>e===null?o("a:noFill"):o("a:solidFill",{},q(e)),t=(e,n)=>o(e,{val:typeof n=="boolean"?n?1:0:n}),m=(e,n)=>o("a:ln",n===void 0?{}:{w:Math.round(n*12700)},f(e)),F=(e,n)=>o("c:txPr",{},o("a:bodyPr"),o("a:lstStyle"),o("a:p",{},o("a:pPr",{},o("a:defRPr",e===void 0?{}:{sz:Math.round(e*100)},n===void 0?"":f(n))),o("a:endParaRPr",{lang:"en-US"}))),S=e=>o("c:strCache",{},t("c:ptCount",e.length),...e.map((n,c)=>o("c:pt",{idx:c},`<c:v>${l(n)}</c:v>`))),A=(e,n)=>o("c:numCache",{},`<c:formatCode>${l(e??"General")}</c:formatCode>`,t("c:ptCount",n.length),...n.flatMap((c,r)=>c===null?[]:[o("c:pt",{idx:r},`<c:v>${String(c)}</c:v>`)])),K=(e,n)=>o("c:tx",{},n===void 0?`<c:v>${l(e.name)}</c:v>`:o("c:strRef",{},`<c:f>${l(n)}</c:f>`,S([e.name]))),Y=(e,n)=>n===void 0?"":o("c:xVal",{},o("c:numRef",{},`<c:f>${l(n)}</c:f>`,A("General",e.x??[])));function J(e,n,c,r){const a=n.color??j(c),s=h(e.type),i=P(e.type),u=k(e.type)||i,g=N(e.type),X=u?o("c:spPr",{},E(e.type)?m(a,n.line_width??d.lineWidth):o("a:ln",{w:19050},f(null))):o("c:spPr",{},f(a),s?m("lt1",1):""),_=r.categories;return o("c:ser",{},t("c:idx",c),t("c:order",c),K(n,r.name(c)),X,v(e.type)?t("c:invertIfNegative",!1):"",u?o("c:marker",{},t("c:symbol",g?"circle":"none"),g?t("c:size",n.marker_size??d.marker):"",g?o("c:spPr",{},f(a),m(a)):""):"",...w(e)&&!u&&!R(e.type)?e.categories.map((C,p)=>o("c:dPt",{},t("c:idx",p),v(e.type)?t("c:invertIfNegative",!1):"",t("c:bubble3D",!1),o("c:spPr",{},f(j(p)),s?m("lt1",1):""))):[],i?Y(n,r.x?.(c)):_===void 0?"":o("c:cat",{},r.numeric===!0?o("c:numRef",{},`<c:f>${l(_)}</c:f>`,A("General",e.categories.map(C=>{const p=Number(C);return C===""||!Number.isFinite(p)?null:p}))):o("c:strRef",{},`<c:f>${l(_)}</c:f>`,S(e.categories))),o(i?"c:yVal":"c:val",{},o("c:numRef",{},`<c:f>${l(r.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,r=O(e);return o("c:dLbls",{},n.number_format===void 0?"":o("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)),r===void 0?"":t("c:dLblPos",r),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 Q(e,n){const c=e.series.map((s,i)=>J(e,s,i,n)).join(""),r=z(e.type),a=t("c:axId",x)+t("c:axId",y);if(h(e.type)){const s=e.type==="pie";return o(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(P(e.type))return o("c:scatterChart",{},t("c:scatterStyle","lineMarker"),t("c:varyColors",!1),c,b(e),a);if(v(e.type)){const s=r!=="clustered";return o("c:barChart",{},t("c:barDir",T(e.type)?"bar":"col"),t("c:grouping",r),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 o(k(e.type)?"c:lineChart":"c:areaChart",{},t("c:grouping",r),t("c:varyColors",!1),c,b(e),k(e.type)?t("c:marker",!0):"",a)}const L=e=>o("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)),G=e=>o("c:spPr",{},m(e.line_color??{rgb:d.axisLine},d.gridWidth)),$=e=>e.has_major_gridlines===!0?o("c:majorGridlines",{},o("c:spPr",{},m(e.gridline_color??{rgb:d.gridline},d.gridWidth))):"",I=(e,n)=>o("c:rich",{},o("a:bodyPr"),o("a:lstStyle"),o("a:p",{},o("a:pPr",{},o("a:defRPr",{sz:n,b:0})),o("a:r",{},o("a:rPr",{lang:"en-US",sz:n,b:0}),`<a:t>${l(e)}</a:t>`))),M=(e,n)=>e===void 0||e===""?"":o("c:title",{},o("c:tx",{},I(e,n)),t("c:overlay",!1));function ee(e){if(h(e.type))return"";const n=P(e.type),c=T(e.type),r=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?o("c:valAx",{},t("c:axId",x),L(r),t("c:delete",r.visible===!1),t("c:axPos","b"),$(r),M(r.title,u),o("c:numFmt",{formatCode:r.number_format??"General",sourceLinked:r.number_format===void 0?1:0}),t("c:majorTickMark","none"),t("c:minorTickMark","none"),t("c:tickLblPos","nextTo"),G(r),t("c:crossAx",y),t("c:crosses","autoZero"),t("c:crossBetween","midCat"),r.major_unit===void 0?"":t("c:majorUnit",r.major_unit)):o("c:catAx",{},t("c:axId",x),L(r),t("c:delete",r.visible===!1),t("c:axPos",c?"l":"b"),$(r),M(r.title,u),o("c:numFmt",{formatCode:"General",sourceLinked:0}),t("c:majorTickMark","none"),t("c:minorTickMark","none"),t("c:tickLblPos","nextTo"),G(r),t("c:crossAx",y),t("c:crosses","autoZero"),t("c:auto",!0),t("c:lblAlgn","ctr"),t("c:lblOffset",100),t("c:noMultiLvlLbl",!1)))+o("c:valAx",{},t("c:axId",y),L(a),t("c:delete",a.visible===!1),t("c:axPos",c?"b":"l"),$(a),M(a.title,u),o("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"),o("c:spPr",{},m(null)),t("c:crossAx",x),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 te={bottom:"b",top:"t",left:"l",right:"r"};function ne(e,n){const c=n.width,r=n.height,{plot:a}=D(e,c,r),s=i=>Number(i.toFixed(5));return o("c:layout",{},o("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/r)),t("c:w",s(a.width/c)),t("c:h",s(a.height/r))))}export function chartSpaceXml(e,n){const c=e.title!==void 0&&e.title!==""?e.title:void 0,r=e.font_size??d.fontSize,a=Math.round((e.title_size??r*d.titleScale)*100);return W+o("c:chartSpace",{"xmlns:c":U,"xmlns:a":V,"xmlns:r":B},t("c:date1904",!1),t("c:roundedCorners",!1),o("c:chart",{},c===void 0?"":o("c:title",{},o("c:tx",{},n.titleRef===void 0?I(c,a):o("c:strRef",{},`<c:f>${l(n.titleRef)}</c:f>`,S([c]))),t("c:overlay",!1)),t("c:autoTitleDeleted",c===void 0),o("c:plotArea",{},n.frame?ne(e,n.frame):o("c:layout"),Q(e,n.refs),ee(e)),e.legend===void 0?"":o("c:legend",{},t("c:legendPos",te[e.legend]),t("c:overlay",!1)),t("c:plotVisOnly",n.plotVisible??!0),t("c:dispBlanksAs","gap")),F(r,e.font_color??"dk1"),n.tail??"")}

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

@@ -0,0 +1,195 @@
+import type { ChartLegendPosition, SheetChartType, ThemeColor } from "@allyhub-next/formats";
+/** A colour: the theme's, or `#RRGGBB`. */
+export type Color = ThemeColor | {
+    rgb: string;
+};
+/** The kinds a chart is drawn as: a slide's and a sheet's (which adds scatter). */
+export type ChartKind = SheetChartType;
+/** Where a data label sits (`c:dLblPos`). */
+export type ChartLabelPosition = "outEnd" | "inEnd" | "ctr" | "inBase" | "t" | "b" | "l" | "r" | "bestFit";
+export interface ChartSeriesDef {
+    name: string;
+    /** One per category; null where there is none. */
+    values: (number | null)[];
+    /** A scatter's: each point's place across, beside `values`. */
+    x?: (number | null)[];
+    /** Its values' format in the workbook (Excel's). */
+    number_format?: string;
+    /** Its colour; default the theme's accents, in turn. */
+    color?: Color;
+    /** A line's curve. */
+    smooth?: boolean;
+    /** A line's width in points. */
+    line_width?: number;
+    /** A marker's size in points. */
+    marker_size?: number;
+}
+export interface ChartAxisDef {
+    minimum_scale?: number;
+    maximum_scale?: number;
+    major_unit?: number;
+    has_major_gridlines?: boolean;
+    visible?: boolean;
+    /** Its tick labels' format (Excel's). */
+    number_format?: string;
+    /** Last category first. */
+    reverse_order?: boolean;
+    /** Its gridlines' colour. */
+    gridline_color?: Color;
+    /** Its line's colour. */
+    line_color?: Color;
+    /** Its title (`c:title`). */
+    title?: string;
+}
+export interface ChartLabelsDef {
+    show_value?: boolean;
+    show_percentage?: boolean;
+    show_category_name?: boolean;
+    show_series_name?: boolean;
+    number_format?: string;
+    position?: ChartLabelPosition;
+    /** Points. */
+    size?: number;
+    color?: Color;
+}
+/** A chart (`c:chartSpace`). */
+export interface ChartDef {
+    type: ChartKind;
+    categories: string[];
+    series: ChartSeriesDef[];
+    title?: string;
+    /** Where its legend is; absent: it has none. */
+    legend?: ChartLegendPosition;
+    /** Its data labels; absent: it has none. */
+    labels?: ChartLabelsDef;
+    /** Between bars' groups, as a share of a bar's width, in %. */
+    gap_width?: number;
+    /** Of one bar over the next, in %, from -100 to 100. */
+    overlap?: number;
+    /** A colour per category, as a pie has by default. */
+    vary_by_categories?: boolean;
+    /** A doughnut's hole, in % of its size. */
+    hole_size?: number;
+    value_axis?: ChartAxisDef;
+    category_axis?: ChartAxisDef;
+    /** Its text's size in points. */
+    font_size?: number;
+    /** Its title's size in points. */
+    title_size?: number;
+    font_color?: Color;
+    /** The project file its numbers came from. */
+    source?: string;
+}
+/** What a chart is drawn with unless it says otherwise. */
+export declare const CHART_DEFAULTS: {
+    /** Points. */
+    readonly fontSize: 12;
+    /** A title's size over the chart's text. */
+    readonly titleScale: 1.2;
+    readonly gapWidth: 150;
+    readonly holeSize: 50;
+    /** Space round the chart, points. */
+    readonly margin: 6;
+    readonly gridline: "#D9D9D9";
+    readonly axisLine: "#BFBFBF";
+    /** A share of a letter's size: how wide a letter is taken to be. */
+    readonly letter: 0.55;
+    /** Line widths, points. */
+    readonly lineWidth: 2.25;
+    readonly gridWidth: 0.75;
+    /** A marker's size, points. */
+    readonly marker: 5;
+};
+export declare const accentOf: (i: number) => Color;
+export declare const isBar: (t: ChartKind) => boolean;
+export declare const isHorizontal: (t: ChartKind) => boolean;
+export declare const isLine: (t: ChartKind) => boolean;
+export declare const isArea: (t: ChartKind) => boolean;
+export declare const isRound: (t: ChartKind) => t is "pie" | "doughnut";
+export declare const isScatter: (t: ChartKind) => boolean;
+/** Whether its points are joined. */
+export declare const hasLines: (t: ChartKind) => boolean;
+export declare const hasMarkers: (t: ChartKind) => t is "line-markers" | "scatter" | "scatter-lines";
+export declare const groupingOf: (t: ChartKind) => "clustered" | "stacked" | "percentStacked" | "standard";
+/**
+ * Where each kind of chart can have its labels: PowerPoint repairs a file
+ * that names any other (a stacked bar's outside end), and an area or a
+ * doughnut names none.
+ */
+export declare function labelPositionsOf(t: ChartKind): readonly ChartLabelPosition[];
+/** Where a chart's labels are: where it says if its kind can, else where this one draws them. */
+export declare function labelPositionOf(c: Pick<ChartDef, "type" | "labels">): ChartLabelPosition | undefined;
+/** Whether each category has its own colour. */
+export declare const variesOf: (c: Pick<ChartDef, "type" | "vary_by_categories">) => boolean;
+/** A number as an Excel format shows it. */
+export declare function formatValue(value: number, code?: string): string;
+export interface ChartScale {
+    min: number;
+    max: number;
+    major: number;
+    ticks: number[];
+}
+/**
+ * A value axis from the values it shows, as Excel's automatic one: zero is on
+ * it unless the values are close together, a step of 1, 2 or 5 of a power of
+ * ten that gives its length at least `room` per step, and 5 % of head room.
+ */
+export declare function chartScale(low: number, high: number, length: number, room: number, axis?: ChartAxisDef): ChartScale;
+export interface ChartBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    color: Color;
+    series: number;
+    category: number;
+}
+export interface ChartStroke {
+    /** An SVG path. */
+    d: string;
+    color: Color;
+    width: number;
+    fill?: Color;
+    series?: number;
+    category?: number;
+}
+export interface ChartDot {
+    x: number;
+    y: number;
+    r: number;
+    color: Color;
+}
+export interface ChartWord {
+    /** Where it is anchored: its left, middle or right, at its vertical middle. */
+    x: number;
+    y: number;
+    text: string;
+    size: number;
+    anchor: "start" | "middle" | "end";
+    color: Color;
+    /** Turned, in degrees: an axis's title beside it. */
+    rotate?: number;
+}
+/** A chart as drawn, in points in its frame, back to front. */
+export interface ChartDrawing {
+    grid: ChartStroke[];
+    /** Filled areas, bars and slices. */
+    shapes: ChartStroke[];
+    boxes: ChartBox[];
+    lines: ChartStroke[];
+    axes: ChartStroke[];
+    dots: ChartDot[];
+    /** Swatches of the legend. */
+    keys: ChartBox[];
+    words: ChartWord[];
+    /** Where the plot is. */
+    plot: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+/** A chart laid out in a frame of `width` × `height` points. */
+export declare function chartDrawing(c: ChartDef, width: number, height: number): ChartDrawing;
+//# sourceMappingURL=chart.d.ts.map