allyhub 0.7.1 → 0.8.0

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

@@ -0,0 +1,13 @@
+{
+  "name": "@allyhub/cloud",
+  "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/components/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@allyhub/components",
+  "version": "0.8.0",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./registry.json": "./registry.json",
+    "./r/*": "./r/*"
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

package/dist/node_modules/@allyhub/dev-server/dist/background.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{runCheck as l}from"@allyhub/check";import{indexNeeds as d,makeIndex as c}from"@allyhub/project";import{loose as o}from"./paths.js";export const SETTLE_MS=1500;export class Checker{state;reads=new Map;timer;active;again=!1;closed=!1;live;emit;needs;settle;constructor(e){this.live=e.live,this.emit=e.emit,this.needs=e.needs,this.settle=e.settle??SETTLE_MS,this.state={status:"waiting",revision:0,problems:[],facts:[]}}schedule(e=!1){this.closed||(clearTimeout(this.timer),this.state.status!=="running"&&this.publish({...this.state,status:"waiting"}),this.timer=setTimeout(()=>{if(!this.closed){if(this.active){this.again=!0;return}this.active=this.run().finally(()=>{this.active=void 0})}},e?0:this.settle))}async run(){const e=this.live.revision;this.publish({...this.state,status:"running",revision:e});let s;try{const t=await this.live.withSession(i=>l({dir:this.live.root,session:i}));s={status:"done",revision:e,problems:t.problems.map(o),facts:t.facts.map(o),versions:{total:t.targets.length,loaded:t.stats.loaded.length,reused:t.stats.reused}},this.needs?.(d(t.results));const a=new Map;for(const i of t.results){const r=a.get(i.piece)??{media:new Set,data:new Set};a.set(i.piece,r);for(const n of i.reads?.media??[])r.media.add(n.path);for(const n of i.reads?.data??[])r.data.add(n.path)}this.reads=new Map([...a].map(([i,{media:r,data:n}])=>[i,{media:[...r],data:[...n]}]))}catch(t){s={status:"failed",revision:e,problems:[],facts:[],error:t instanceof Error?t.message:String(t)}}this.closed||(e===this.live.revision&&!this.again?this.publish(s):(this.again=!1,this.schedule(!0)))}publish(e){this.state=e,this.emit(e)}async close(){this.closed=!0,clearTimeout(this.timer),await this.active}}export class Indexer{jobs=[];root;emit;made;wanted=[];tried=new Set;running;abort=new AbortController;constructor(e){this.root=e.root,this.emit=e.emit,this.made=e.made}want(e){const s=e.filter(t=>!this.tried.has(`${t.file}:${String(t.faces)}:${String(t.matte)}`));if(s.length!==0){for(const t of s)this.tried.add(`${t.file}:${String(t.faces)}:${String(t.matte)}`);this.wanted.push(...s),this.running??=this.loop().finally(()=>{this.running=void 0})}}async loop(){for(;this.wanted.length>0&&!this.abort.signal.aborted;){const e=this.wanted.splice(0),{done:s}=await c(this.root,e,t=>{this.jobs=[...this.jobs.filter(a=>a.file!==t.file),{file:t.file,status:t.status,message:t.message,...t.share===void 0?{}:{share:t.share}}],this.emit(this.jobs)},this.abort.signal);s.length>0&&this.made()}}async close(){this.abort.abort(),await this.running}}

package/dist/node_modules/@allyhub/dev-server/dist/card.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readFile as p}from"node:fs/promises";import{basename as f,join as w}from"node:path";import{parseDoc as y,splitTitle as b}from"@allyhub/doc";import{readSheetSource as g,workbookFiles as k}from"@allyhub/build";import{Calc as j,readWorkbook as x,shownValue as A}from"@allyhub/sheet";export const CARD_DEFAULTS={lines:4,chars:240,rows:5,columns:6},projectName=t=>f(t);function v(t){if(!("content"in t)||!Array.isArray(t.content))return;const e=t.content.map(r=>r.text).join("").trim();return e===""?void 0:e}const D=(t,e)=>t.length<=e?t:`${t.slice(0,e-1).trimEnd()}…`;function F(t){const{body:e}=b(y(t).blocks),r=[];for(const o of e){const i=v(o);if(i!==void 0&&r.push(D(i,CARD_DEFAULTS.chars)),r.length===CARD_DEFAULTS.lines)break}return{type:"text",lines:r}}async function P(t,e){const r=await g(t,e.dir),{workbook:o}=x(k(t,r)),i=o?.sheets[0];if(!o||!i)return{type:"table",columns:[],rows:[],count:0};const u=new j(o).calculate(),n=i.tables[0]?.area??i.used;if(!n)return{type:"table",columns:[],rows:[],count:0};const d=(s,c)=>A(u.value(i,s,c),i.lookAt(s,c).format),h=Math.min(n.right-n.left+1,CARD_DEFAULTS.columns),a=s=>Array.from({length:h},(c,m)=>d(s,n.left+m)),l=[];for(let s=n.top+1;s<=Math.min(n.bottom,n.top+CARD_DEFAULTS.rows);s++)l.push(a(s));return{type:"table",columns:a(n.top),rows:l,count:n.bottom-n.top}}export async function itemPreview(t,e){const r=t.project.root;switch(e.kind){case"doc":return F(await p(w(r,e.entry),"utf8"));case"sheet":return await P(r,e);case"video":{const o=await t.project.tool("video/still",{item:e.dir});return{type:"picture",image:o.image,width:o.width,height:o.height,duration:o.duration}}case"slides":{const o=await t.project.tool("video/still",{item:e.dir});return{type:"picture",image:o.image,width:o.width,height:o.height}}default:return}}

package/dist/node_modules/@allyhub/dev-server/dist/exports.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{randomBytes as f}from"node:crypto";import{basename as u,join as h}from"node:path";import{exportProject as m}from"@allyhub/export";import{JobFailure as p}from"@allyhub/jobs";import{OUT_DIR as w}from"@allyhub/formats";import{parseCombo as g}from"@allyhub/project";import{projectPathOf as y}from"./paths.js";function x(n){const t=n?.pptx;return{...n?.steps===!0?{steps:!0}:{},...t==="picture"?{pptx:t}:{}}}export class Exports{root;changed;jobs=[];aborts=new Map;queue=Promise.resolve();asJobs;constructor(t,r,s){this.root=t,this.changed=r,this.asJobs=s}list(){return this.jobs.map(t=>({...t}))}start(t,r,s,a){const e={id:`x${f(4).toString("hex")}`,item:t,versions:r,types:s,...a?{options:a}:{},state:"queued",progress:0,files:[]};this.jobs.push(e);const o=new AbortController;return this.aborts.set(e.id,o),this.changed({...e}),this.queue=this.queue.then(()=>this.run(e,o.signal)),{...e}}cancel(t){const r=this.jobs.find(s=>s.id===t);return!r||r.state==="done"||r.state==="failed"?!1:(this.aborts.get(t)?.abort(),this.set(r,{state:"cancelled"}),!0)}idle(){return this.queue}async close(){for(const t of this.aborts.values())t.abort();await this.queue}watchers=new Set;set(t,r){Object.assign(t,r),this.changed({...t});for(const s of this.watchers)s(t)}async run(t,r){if(t.state==="cancelled")return;const s=this.asJobs;if(s===void 0)return this.make(t,r);const a=await s.nameOf(t.item).catch(()=>u(t.item));let e=0;const o=async()=>{await this.queue;const i=new AbortController;return this.aborts.set(t.id,i),delete t.error,this.set(t,{state:"queued",progress:0,files:[]}),i.signal};await s.jobs.run({about:{kind:"piece",id:h(this.root,t.item)},what:"export",name:a,unit:"share",total:1},async i=>{i.signal.addEventListener("abort",()=>{this.cancel(t.id)});const c=d=>{d.id===t.id&&i.report(d.progress,1)};this.watchers.add(c);try{await this.make(t,e++===0?r:await o())}finally{this.watchers.delete(c)}if(t.state==="cancelled")throw new DOMException("The export was cancelled.","AbortError");if(t.state==="failed")throw new p("other",t.error??"The export failed.");const[l]=t.files;l!==void 0&&i.made(h(this.root,l))}).catch(()=>{})}async make(t,r){this.set(t,{state:"running"});try{const s=await m({root:this.root,items:[t.item],...t.versions.length?{combos:t.versions.map(e=>g(e))}:{},...t.types.length?{types:t.types}:{},...x(t.options),out:h(this.root,w),signal:r,onProgress:e=>{r.aborted||this.set(t,{progress:Math.max(t.progress,Math.min(1,e))})}}),a=s.files.flatMap(e=>e.files).map(e=>y(this.root,e)).filter(e=>e!==void 0);r.aborted?this.set(t,{state:"cancelled",files:a}):s.failed.length>0&&a.length===0?this.set(t,{state:"failed",error:s.failed.map(e=>e.message).join(" ")}):this.set(t,{state:"done",progress:1,files:a,...s.failed.length>0?{error:[...new Map(s.failed.map(e=>[e.code,e.message])).values()].join(" ")}:{}})}catch(s){this.set(t,{state:r.aborted?"cancelled":"failed",...r.aborted?{}:{error:s instanceof Error?s.message:String(s)}})}finally{this.aborts.delete(t.id)}}}

package/dist/node_modules/@allyhub/dev-server/dist/index.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export{PING_MS,RAW_PATH,RPC_PATH,forwardedHost,startDevServer}from"./server.js";export{ProjectServer,SERVER_METHODS}from"./project.js";export{Writer,LIST_LIMIT,UPLOAD_MAX_BYTES}from"./writer.js";export{Watcher}from"./watcher.js";export{writeProblems,dataFileOf}from"./validate.js";export{pathProblem,versionOf}from"./paths.js";export{SETTLE_MS}from"./background.js";export{recordTree}from"./record.js";export{CARD_DEFAULTS,itemPreview,projectName}from"./card.js";export{hasFileManager,revealFile}from"./reveal.js";

package/dist/node_modules/@allyhub/dev-server/dist/live.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{rm as w}from"node:fs/promises";import{join as c}from"node:path";import{fileLoudness as b}from"@allyhub/audio/node";import{startBrowser as v}from"@allyhub/browser";import{hasSheetCode as g,mediaHref as y,readSheetSource as S,sourceOf as D,stageItem as C}from"@allyhub/build";import{CACHE_DIR as E}from"@allyhub/formats";import{CheckSession as $,ProjectError as k,pickTarget as R,parseCombo as O}from"@allyhub/project";import{RPC_ERROR as h,RpcError as p,SNAPSHOT_TREE as m,SOUND_FOLDER as P}from"@allyhub/protocol";import{SCENERY_STAGE as H,sceneryHref as l}from"@allyhub/scenery-host/bundle";import{bakesOnDisk as _,bundleSceneryStage as F,prepareStage as N,serveDecoders as T}from"@allyhub/stage";export function rpcErrorOf(n){return n instanceof k?new p(n.kind==="not-found"?h.notFound:h.invalid,n.hint?`${n.message} ${n.hint}`:n.message):n}export class Live{root;buildDir;revision=0;prep;last;lease;old=new Set;browserStarted;gpu;sceneries=new Map;building=Promise.resolve();closed=!1;sheetCodes=new Map;constructor(e,s={}){this.root=e,this.buildDir=c(e,E,"build",`dev-${String(process.pid)}`),this.gpu=s.gpu}moved(e){this.revision=e,this.lease&&this.lease.revision!==e&&this.retire(this.lease)}prepared(){const e=this.revision;if(this.prep?.revision===e)return this.prep.promise;const s=this.building.then(()=>e===this.revision?this.build():void 0);this.building=s.catch(()=>{});const t=s.then(i=>i??this.prepared());return this.prep={revision:e,promise:t},t.catch(()=>{this.prep?.promise===t&&(this.prep=void 0)}),t}async build(){const e=await N(this.root,this.pieceDir);return e.bundle&&await T(e.bundle.dir),this.last=e,e}async sheetCode(e){if(!g(this.root,e))return{failed:!1};const s=this.sheetCodes.get(e),t=s?.revision===this.revision?s.promise:S(this.root,e).catch(()=>{});this.sheetCodes.set(e,{revision:this.revision,promise:t});const i=await t;return{failed:i?.failed??!0,...i?.generated?{generated:i.generated}:{}}}get pieceDir(){return c(this.buildDir,"stage")}get sceneryDir(){return c(this.buildDir,"scenery",H)}latest(){return this.last}async target(e,s){const t=await this.prepared();try{const{piece:i,target:o}=R(t,e,s===void 0?void 0:[O(s)]);return{prepared:t,piece:i,combo:o.combo}}catch(i){throw rpcErrorOf(i)}}async componentHost(e,s){const t=await this.prepared(),i=e.replace(/\/doc\.mdx$/u,"").replace(/^\.?\/?/u,""),o=t.docs.find(r=>r.place===i);if(o){if(o.components.length===0)throw new p(h.notFound,`${o.place} shows no component.`);const r=t.messages.locales[0];return{prepared:t,host:o,combo:r===void 0?{}:{lang:r}}}const{piece:u,combo:a}=await this.target(e,s);return{prepared:t,host:u,combo:a}}async source(e){const s=await this.prepared(),t=C(s,e);if(!t)throw new p(h.notFound,`No piece ${e}.`);const i=D(s,t),o={...i.media},u=(a,r)=>`${a}${y(r).slice(m.media.length)}`;return await Promise.all(Object.entries(o).map(async([a,r])=>{let d=r;if(r.kind==="video"&&r.matte===!0&&(d={...d,matteUrl:u(m.matte,a)}),r.kind==="audio"||r.kind==="video"&&r.audio===!0){d={...d,denoisedUrl:u(P,a)};const f=await b(c(this.root,a)).catch(()=>{});f!==void 0&&(d={...d,loudness:f.lufs,...f.by==="level"?{loudnessBy:"level"}:{}})}o[a]=d})),{...i,media:o}}browser(){return this.browserStarted??=v(this.gpu===void 0?{}:{gpu:this.gpu}),this.browserStarted}async withSession(e){this.refuseStopped();let s=this.lease;if(s?.revision!==this.revision){s&&this.retire(s);const t=await this.browser();if(this.refuseStopped(),s=this.lease,s?.revision!==this.revision){s&&this.retire(s);const i={revision:this.revision,session:this.prepared().then(o=>$.open({root:this.root,browser:t,prepared:o})),users:0,retired:!1};s=i,this.lease=i,i.session.catch(()=>{this.lease===i&&(this.lease=void 0)})}}s.users++;try{return await e(await s.session)}finally{s.users--,s.retired&&s.users===0&&this.end(s)}}refuseStopped(){if(this.closed)throw new p(h.unavailable,"allyhub dev is stopping.")}retire(e){e.retired=!0,this.lease===e&&(this.lease=void 0),this.old.add(e),e.users===0&&this.end(e)}end(e){return e.ended??=(async()=>{this.old.delete(e),await e.session.then(s=>s.close()).catch(()=>{})})(),e.ended}scenery(e){const s=this.sceneries.get(e);if(s?.revision===this.revision)return s.promise;const t=this.bundleScenery(e);return this.sceneries.set(e,{revision:this.revision,promise:t}),t.catch(()=>{this.sceneries.get(e)?.promise===t&&this.sceneries.delete(e)}),t}async scenerySource(e){const s=await this.scenery(e),t=i=>`${m.scenery}${i}`;return{module:t(s.module),decoders:t(s.decoders),manifoldWasm:t(s.manifoldWasm),bakes:[...await _(this.root)]}}async bundleScenery(e){const{bundle:s,media:t}=await F(this.root,e,c(this.buildDir,"scenery"));return{module:l(s.module),decoders:l(s.decoders),manifoldWasm:l(s.manifoldWasm),output:s.output.map(l),media:t}}async close(){this.closed=!0;const e=[...this.old,...this.lease?[this.lease]:[]];this.lease&&this.retire(this.lease),await Promise.all(e.map(s=>this.end(s))),await this.browserStarted?.then(s=>s.close()).catch(()=>{}),await w(this.buildDir,{recursive:!0,force:!0})}}

package/dist/node_modules/@allyhub/dev-server/dist/paths.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{createHash as w}from"node:crypto";import{readFile as b,realpath as l}from"node:fs/promises";import{dirname as a,isAbsolute as i,join as R,relative as p,sep as E}from"node:path";import{LOCAL_DIR as m}from"@allyhub/formats";import{RPC_ERROR as s,RpcError as c}from"@allyhub/protocol";const j=new Set(["node_modules",".git"]);export const versionOf=e=>w("sha256").update(e).digest("hex");export function pathProblem(e,t={}){if(e.includes("\\")||e.includes("\0")||i(e))return`${e} is not a path inside the project.`;const r=e.split("/");if(r.some(n=>n===""||n==="."||n===".."))return`${e} is not a path inside the project.`;if(r.some(n=>j.has(n)))return`${e} is in a folder allyhub dev does not open.`;if(t.write&&(r[0]===m||e===m))return`${e} is AllyHub's own: allyhub dev does not write there.`}export async function fileIn(e,t,r={}){const n=pathProblem(t,r);if(n!==void 0)throw new c(s.forbidden,n);const d=R(e,...t.split("/")),h=await l(e).catch(()=>e);for(let o=d;;o=a(o)){const f=await l(o).catch(()=>{});if(f!==void 0){const u=p(h,f);if(u.startsWith("..")||i(u))throw new c(s.forbidden,`${t} points outside the project.`);return d}if(a(o)===o)throw new c(s.forbidden,`${t} is not inside the project.`)}}export function projectPathOf(e,t){const r=p(e,t);if(!(r===""||r.startsWith("..")||i(r)))return r.split(E).join("/")}export async function current(e){try{const t=await b(e);return{bytes:t,version:versionOf(t)}}catch(t){const r=t.code;if(r==="ENOENT"||r==="ENOTDIR"||r==="EISDIR")return null;throw t}}export const loose=e=>e;

package/dist/node_modules/@allyhub/dev-server/dist/project.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{randomBytes as m}from"node:crypto";import{resolve as v}from"node:path";import{FILE_METHODS as y,HOST_METHODS as w,JSONRPC as c,PROJECT_TOOLS as h,RPC_ERROR as l,RequestSchema as g,RpcError as d,answer as f}from"@allyhub/protocol";import{Checker as O,Indexer as x}from"./background.js";import{Exports as S}from"./exports.js";import{hasFileManager as k,revealFile as b}from"./reveal.js";import{Live as j}from"./live.js";import{fileIn as u}from"./paths.js";import{toolHandlers as p}from"./tools.js";import{Watcher as R}from"./watcher.js";import{Writer as E}from"./writer.js";export const SERVER_METHODS={...y,"tools/call":w["tools/call"]};export class ProjectServer{root;writer;watcher;live;exports;reveal;checker;serving;indexer;clients=new Map;constructor(t){this.root=v(t.root),this.live=new j(this.root,t.gpu===void 0?{}:{gpu:t.gpu}),this.watcher=new R(this.root,(e,r)=>{this.sendTo(this.watchOwner(e),"files/changed",{watch:e,changes:r})},e=>{this.live.moved(e),this.notify("project/changed",{revision:e}),this.checker?.schedule()}),this.writer=new E(this.root,(e,r)=>{this.watcher.wrote(e,r)},t.writable),this.reveal=t.reveal===!1?void 0:t.reveal??(k()?b:void 0),this.exports=new S(this.root,e=>{this.notify("export/changed",{job:e})},t.jobs===void 0?void 0:{jobs:t.jobs,nameOf:async e=>{const{items:r}=await this.tool("project/items",{});return r.find(o=>o.dir===e)?.title??e.split("/").pop()??e}});const i=t.index??process.env.ALLYHUB_NO_INDEX!=="1";if(t.check!==!1){const e=i?new x({root:this.root,emit:r=>{this.notify("index/changed",{jobs:r})},made:()=>{this.checker?.schedule(!0)}}):void 0;this.indexer=e,this.checker=new O({live:this.live,emit:r=>{this.notify("check/changed",r)},...e?{needs:r=>{e.want(r)}}:{},...t.settle===void 0?{}:{settle:t.settle}})}}static open(t){const i=new ProjectServer(t);return i.watcher.start(),i.checker?.schedule(),Promise.resolve(i)}owners=new Map;watchOwner(t){return this.owners.get(t)}connect(t,i={}){const e=`c${m(6).toString("hex")}`;this.clients.set(e,t);const r=this.handlersFor(e,i.origin);return{id:e,receive:async o=>{const s=await this.answerOne(r,o);s&&t(s)},close:()=>{this.clients.delete(e),this.watcher.forget(e);for(const[o,s]of this.owners)s===e&&this.owners.delete(o)}}}channel(){const t=new Set,i=this.connect(e=>{const r=JSON.parse(JSON.stringify(e));queueMicrotask(()=>{for(const o of t)o(r)})});return{send:e=>{i.receive(JSON.parse(JSON.stringify(e)))},listen:e=>(t.add(e),()=>t.delete(e)),close:()=>{i.close()}}}notify(t,i){for(const e of this.clients.values())e({jsonrpc:c,method:t,params:i})}sendTo(t,i,e){t!==void 0&&this.clients.get(t)?.({jsonrpc:c,method:i,params:e})}async answerOne(t,i){const e=g.safeParse(i);if(!e.success){const o=i?.id;return typeof o!="string"&&typeof o!="number"?void 0:{jsonrpc:c,id:o,error:{code:l.invalidRequest,message:"Not a JSON-RPC request."}}}const r=e.data;return Object.hasOwn(w,r.method)&&r.method!=="tools/call"?{jsonrpc:c,id:r.id,error:{code:l.methodNotFound,message:`${r.method} is answered by the page that hosts the editor, not by allyhub dev's server.`}}:f(SERVER_METHODS,t,r)}handlersFor(t,i){const{writer:e,watcher:r}=this,o=p({live:this.live,checker:this.checker,exports:this.exports,reveal:this.reveal,tree:()=>this.serving?.tree(i)});return{"files/read":({path:s})=>e.read(s),"files/write":async({path:s,text:a,over:n})=>({version:await e.write(s,a,n,t)}),"files/upload":async({dir:s,name:a,data:n})=>({path:await e.upload(s,a,Buffer.from(n,"base64"),t)}),"files/url":async({path:s})=>{if(await u(this.root,s),!this.serving)throw new d(l.unavailable,"This server serves no files over HTTP: only allyhub dev's does.");return{url:this.serving.file(i,s)}},"files/list":({dir:s})=>e.list(s),"files/move":async({from:s,to:a})=>({rewritten:await e.move(s,a,t)}),"files/remove":async({path:s})=>({trash:await e.remove(s,t)}),"files/trash":async()=>({entries:await e.trash()}),"files/restore":async({id:s})=>({path:await e.restore(s,t)}),"files/watch":async({paths:s})=>{for(const n of s)await u(this.root,n);const a=await r.watch(t,s);return this.owners.set(a,t),{watch:a}},"files/unwatch":({watch:s})=>(this.owners.get(s)===t&&(r.unwatch(s),this.owners.delete(s)),Promise.resolve({})),"tools/call":async({name:s,arguments:a})=>{const n=await f(h,o,{jsonrpc:c,id:0,method:s,params:a});if("error"in n)throw new d(n.error.code,n.error.message,n.error.data);return{result:n.result}}}}async tool(t,i,e={}){const r=await f(h,p({live:this.live,checker:this.checker,exports:this.exports,reveal:this.reveal,tree:()=>e.tree??this.serving?.tree(void 0)}),{jsonrpc:c,id:0,method:t,params:i});if("error"in r)throw new d(r.error.code,r.error.message,r.error.data);return h[t].result.parse(r.result)}async close(){this.watcher.close(),this.clients.clear(),await this.checker?.close(),await this.indexer?.close(),await this.exports.close(),await this.live.close()}}

package/dist/node_modules/@allyhub/dev-server/dist/reach.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{isAbsolute as h,relative as p,sep as m}from"node:path";import{within as l}from"@allyhub/formats";import{SHARED_KINDS as u,SNAPSHOT_TREE as d}from"@allyhub/protocol";import{THREE_LIBS as w}from"@allyhub/scenery-host/bundle";export const REACH_SHARED=[d.editor,d.runtime,`${d.build}${w}/`];const O="comments.json",S=t=>u.includes(t);export class Reach{reaching=new Map;dirs;files;constructor(r,n){this.files=n,this.dirs=r.map(s=>s.dir).sort((s,i)=>i.split("/").length-s.split("/").length);for(const s of r)S(s.kind)&&this.reaching.set(s.dir,{tree:new Set,files:new Set,own:[]})}get items(){return[...this.reaching.keys()]}itemOf(r){return this.dirs.find(n=>n!==""&&l(r,n))??(this.dirs.includes("")?"":void 0)}of(r){return this.reaching.get(r)}done(r){for(const s of this.files)if(s.split("/").pop()!==O){const i=this.itemOf(s);i!==void 0&&this.reaching.get(i)?.files.add(s)}const n={};for(const[s,i]of this.reaching)n[s]={tree:[...i.tree].filter(a=>r.has(a)).sort(),files:[...i.files].sort(),own:i.own};return{shared:[...REACH_SHARED],items:n}}}export function pieceBundle(t,r){const n=new Set,s=new Set,i=new Set,a=c=>{if(i.has(c))return;i.add(c);const e=t?.chunks[c];if(e){n.add(e.file);for(const f of[...e.css,...e.assets])n.add(f);for(const f of e.modules)s.add(f);for(const f of[...e.imports,...e.dynamicImports])a(f)}},o=t?.entries[r.replaceAll("/","__")];return o&&a(o.file),{files:n,modules:s}}export function projectPathOf(t,r){const n=t.replace(/[?#].*$/u,"");if(h(n))for(const s of r){const i=p(s,n);if(i!==""&&!i.startsWith("..")&&!h(i))return i.split(m).join("/")}}export function pieceNames(t){const{prepared:r,piece:n,reach:s}=t,i=e=>s.itemOf(e)===n.dir,a=new Set,o=new Set,c=e=>Object.hasOwn(r.media,e);for(const e of t.modules){const f=projectPathOf(e,t.roots);f!==void 0&&c(f)&&a.add(f)}for(const e of Object.keys(r.media))(i(e)||e.startsWith(".allyhub/"))&&a.add(e);for(const e of[...t.reads?.media??[],...t.shows?.media??[]])c(e)&&a.add(e);for(const e of Object.keys(r.data))i(e.split("#")[0]??e)&&o.add(e);for(const e of[...t.reads?.data??[],...t.shows?.data??[]])Object.hasOwn(r.data,e)&&o.add(e);return{media:a,data:o}}export function reachedSource(t,r,n){const s=(o,c)=>Object.fromEntries(Object.entries(o).filter(([e])=>c(e))),i=o=>!n.some(c=>o.startsWith(`${c}.`)),a=o=>Object.fromEntries(Object.entries(o).map(([c,e])=>[c,s(e,i)]));return{...t,media:s(t.media,o=>r.media.has(o)),...t.data?{data:s(t.data,o=>r.data.has(o))}:{},messages:a(t.messages),...t.anchors?{anchors:a(t.anchors)}:{}}}export function reachedCheck(t,r,n){const s=i=>{const a=i.where?.file;return typeof i.piece=="string"&&r.has(i.piece)||typeof a=="string"&&n(a)};return{...t,problems:t.problems.filter(s),facts:t.facts.filter(s)}}

package/dist/node_modules/@allyhub/dev-server/dist/record.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readFile as J,readdir as Q,realpath as U,stat as V}from"node:fs/promises";import{join as d,sep as Y}from"node:path";import{THREE_LIBS as x}from"@allyhub/scenery-host/bundle";import{BAKE_DIR as Z}from"@allyhub/scenery-host";import{KeyedStore as ee}from"@allyhub/project";import{componentAt as te,everyBlock as ie,parseDoc as se}from"@allyhub/doc";import{COMPONENT_STILLS_MAX as H,RpcError as oe,SNAPSHOT_TREE as m,pieceSourcePath as ne,scenerySourcePath as re,snapshotAnswerPath as E,snapshotPreviewPath as ce,stillPath as K,stillsIndexKey as ae,stillsIndexPath as de}from"@allyhub/protocol";import{deckComponents as fe,isDeckCode as le,readScript as pe,readSlidesFile as me,resolveDeck as ue,scriptWords as he}from"@allyhub/slides-core";import{bakesOnDisk as we}from"@allyhub/stage";import{runtimeFiles as ye}from"@allyhub/stage-page";import{itemPreview as ke}from"./card.js";import{mediaTypeOf as z}from"@allyhub/formats";import{Reach as $e,pieceBundle as be,pieceNames as ge,reachedCheck as Se,reachedSource as je}from"./reach.js";import{matteFile as ve}from"./tree.js";const P="https://tree.invalid/";function _(o){return typeof o=="string"?o.startsWith(P)?o.slice(P.length):o:Array.isArray(o)?o.map(_):o!==null&&typeof o=="object"?Object.fromEntries(Object.entries(o).map(([$,f])=>[$,_(f)])):o}const g=o=>new TextEncoder().encode(JSON.stringify(o));async function A(o){return(await Q(o,{recursive:!0,withFileTypes:!0}).catch(()=>[])).filter(f=>f.isFile()).map(f=>d(f.parentPath,f.name).slice(o.length+1).split(Y).join("/"))}const Oe=o=>V(o).then($=>$.isFile(),()=>!1);export async function recordTree(o,$={}){const{project:f}=o,{live:l,root:y}=f;await f.watcher.settled();const O=new Map,u=(e,t,i=z(e))=>{O.set(e,{path:e,type:i,file:t})},S=(e,t,i=z(e))=>{O.set(e,{path:e,type:i,bytes:t})},X=l.revision,p=await l.prepared(),T=new Map;if(o.ui!==void 0)for(const e of await A(o.ui))u(`${m.editor}${e}`,d(o.ui,e));for(const[e,t]of await ye())u(`${m.runtime}${e}`,t);const k=async(e,t)=>{let i;try{i={result:_(await f.tool(e,t,{tree:P}))}}catch(a){i={error:a instanceof oe?{code:a.code,message:a.message}:{code:-32603,message:a instanceof Error?a.message:""}}}const n=E(e,t);S(n,g(i));const s=t.item;return typeof s=="string"&&T.set(s,[...T.get(s)??[],n]),i.result},q=async(e,t,i)=>{if(!le(i.code))return;const n=w=>J(d(y,w),"utf8").catch(()=>{}),s=await n(i.file),a=s===void 0?void 0:me(s).file;if(!a)return;const c=t.lang??Object.keys(i.scripts)[0],r=c===void 0?void 0:await n(i.scripts[c]??`${e}/script.${c}.yaml`),v=(r===void 0?void 0:pe(r))??{parts:[],slides:[]};return ue({code:i.code,file:a,words:he(v,i.prefix),prefix:i.prefix,base:i.file.split("/").slice(0,-1).join("/"),theme:i.theme,data:w=>i.data?.[w]}).deck},R=async(e,t,i)=>{const n=new Map;for(const w of i)n.set(ae(w),w);if(n.size===0)return;const s=ee.of(y,"stills"),a={stills:{}},c=h.of(e),r=[...n];for(let w=0;w<r.length;w+=H){const L=r.slice(w,w+H);(await f.tool("components/stills",{item:e,...t===""?{}:{version:t},components:L.map(([,b])=>b)},{tree:P}).catch(()=>{}))?.stills.forEach((b,G)=>{const W=L[G]?.[0];!b||W===void 0||(a.stills[W]=b.key,u(K(b.key),s.path(`${b.key}.webp`),"image/webp"),c?.tree.add(K(b.key)))})}const v=de(e,t);S(v,g(a),"application/json"),c?.tree.add(v)},F=await k("project/items",{}),D=F?.items??[],h=new $e(D,p.files),j=f.checker?.state,M=j===void 0||j.status==="waiting"||j.status==="running"?{status:"off",revision:l.revision,problems:j?.problems??[],facts:j?.facts??[]}:j;S(E("check/results",{}),g({result:M}));for(const e of h.items){const t=h.of(e),i=new Set(p.pieces.filter(s=>s.dir===e).map(s=>s.id)),n=s=>h.itemOf(s)===e;t?.own.push({path:E("project/items",{}),type:"application/json",bytes:g({result:{...F,items:D.filter(s=>s.dir===e)}})},{path:E("check/results",{}),type:"application/json",bytes:g({result:Se(M,i,n)})})}for(const e of p.bundle?.chunks.files??[])u(`${m.build}${e}`,d(l.pieceDir,e));for(const e of await A(d(l.pieceDir,x)))u(`${m.build}${x}/${e}`,d(l.pieceDir,x,e));const N=new Set(Object.keys(p.media));for(const e of Object.keys(p.media)){const t=ve(y,p.media[e]);t!==void 0&&await Oe(t)&&u(`${m.matte}${e}`,t,"video/mp4")}const B=new Map;for(const e of D)if(e.kind==="video"||e.kind==="slides"){const t=await k("video/versions",{item:e.dir});await k("video/stage",{item:e.dir});for(const i of t?.versions??[])await k("video/stage",{item:e.dir,version:i.key});if(e.kind==="slides"){const i=await k("slides/deck",{item:e.dir});await k("slides/fonts",{item:e.dir});const n={media:new Set,data:new Set};if(B.set(e.dir,n),i&&t)for(const s of t.versions){const a=await q(e.dir,s,i);if(a){for(const c of a.slides){c.background_picture!==void 0&&n.media.add(c.background_picture);for(const r of c.shapes)r.media&&n.media.add(r.media.path),r.chart?.source!==void 0&&n.data.add(r.chart.source)}await R(e.dir,s.key,fe(a,t.width).map(c=>c.at))}}}}else if(e.kind==="sheet")await k("sheet/generated",{item:e.dir});else if(e.kind==="doc"){await k("doc/data",{item:e.dir});const t=p.docs.find(i=>i.place===e.dir);if(t&&t.components.length>0){const i=se(await J(d(y,t.file),"utf8")).blocks,n=[];for(const s of ie(i))s.type==="component"&&n.push(te(s));await R(e.dir,"",n)}}else if(e.kind==="scenery"||e.kind==="model"){const t=await l.scenery(e.entry).catch(()=>{});if(!t)continue;for(const i of t.output)u(`${m.scenery}${i}`,d(l.sceneryDir,i));for(const i of await A(d(l.sceneryDir,t.decoders)))u(`${m.scenery}${t.decoders}${i}`,d(l.sceneryDir,t.decoders,i));u(`${m.scenery}${t.manifoldWasm}`,d(l.sceneryDir,t.manifoldWasm)),S(re(e.entry),g(await l.scenerySource(e.entry)));for(const i of t.media)N.add(i)}for(const e of N)u(`${m.media}${e}`,d(y,e));for(const e of await we(y))u(`${m.bakes}${e}.bin`,d(y,Z,`${e}.bin`));const C=[y,await U(y).catch(()=>y)];for(const e of p.pieces){const t=await l.source(e.id).catch(()=>{});if(!t)continue;const i=be(p.bundle?.chunks,e.id),n=ge({prepared:p,piece:e,reach:h,modules:i.modules,roots:C,reads:f.checker?.reads.get(e.id),shows:B.get(e.dir)}),s=p.pieces.filter(r=>r.id!==e.id&&!C.some(v=>i.modules.has(d(v,r.file)))).map(r=>r.id),a=ne(e.id);S(a,g(je(t,n,s)));const c=h.of(e.dir);if(c){c.tree.add(a);for(const r of i.files)c.tree.add(`${m.build}${r}`);for(const r of n.media)c.tree.add(`${m.media}${r}`),c.tree.add(`${m.matte}${r}`),c.files.add(r)}}for(const[e,t]of T)for(const i of t)h.of(e)?.tree.add(i);for(const e of p.docs)for(const t of e.shows)h.of(e.dir)?.files.add(t);for(const e of p.sheets)for(const t of e.files)h.of(e.dir)?.files.add(t);const I=$.preview===!1?void 0:$.preview??(e=>ke(o,e));if(I)for(const e of D){const t=await I(e).catch(()=>{});if(t===void 0)continue;const i=ce(e.dir);S(i,Buffer.from(JSON.stringify(t)),"application/json"),h.of(e.dir)?.tree.add(i)}return{revision:X,files:[...O.values()],reach:h.done(new Set(O.keys()))}}

package/dist/node_modules/@allyhub/dev-server/dist/server.js

@@ -0,0 +1,6 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{randomBytes as E}from"node:crypto";import{createReadStream as B}from"node:fs";import{readFile as z,stat as W}from"node:fs/promises";import{createServer as J}from"node:http";import{Readable as G}from"node:stream";import{join as P,normalize as K,resolve as j,sep as _}from"node:path";import{getRequestListener as Y}from"@hono/node-server";import{Hono as Q}from"hono";import{WebSocketServer as V}from"ws";import{KeyedStore as X}from"@allyhub/project";import{SNAPSHOT_TREE as S,SOUND_FOLDER as Z,TREE_PAGES as ee,stageCsp as te}from"@allyhub/protocol";import{BAKE_DIR as ne}from"@allyhub/scenery-host";import{runtimeFile as re}from"@allyhub/stage-page";import{mediaTypeOf as oe}from"@allyhub/formats";import{pathProblem as q}from"./paths.js";import{ProjectServer as se}from"./project.js";import{MadeSounds as ie,decodeAsOf as ae}from"./sound.js";import{BAKE_NAME as ce,STILL_NAME as de,matteFile as ue,sourceName as C}from"./tree.js";export const RPC_PATH="/rpc",RAW_PATH="/files/raw/";const d={"access-control-allow-origin":"*"};function w(t,a){const f=K(P(t,a));return f.startsWith(t.endsWith(_)?t:`${t}${_}`)?f:void 0}async function h(t,a,f){const $=await W(t).catch(()=>{});if(!$?.isFile())return new Response("not found",{status:404,headers:f});const l={"content-type":oe(t),"cache-control":"no-cache","accept-ranges":"bytes",...f},o=$.size,c=a?/^bytes=(\d*)-(\d*)$/u.exec(a.trim()):null,R=(F,A)=>G.toWeb(B(t,{start:F,end:A}));if(!c||c[1]===""&&c[2]===""||o===0)return new Response(o===0?null:R(0,o-1),{status:200,headers:{...l,"content-length":String(o)}});let p,g;return c[1]===""?(p=Math.max(0,o-Number(c[2])),g=o-1):(p=Number(c[1]),g=c[2]===""?o-1:Math.min(Number(c[2]),o-1)),p>=o||p>g?new Response(null,{status:416,headers:{...l,"content-range":`bytes */${String(o)}`}}):new Response(R(p,g),{status:206,headers:{...l,"content-length":String(g-p+1),"content-range":`bytes ${String(p)}-${String(g)}/${String(o)}`}})}const U=/^[a-z][a-z0-9+.-]*:\/\/[a-z0-9.-]+(:\d{1,5})?$/u;export const PING_MS=3e4,ALLYHUB_FORWARDED="allyhub-forwarded";export function forwardedHost(t){const a=t[ALLYHUB_FORWARDED],$=(t.forwarded??(Array.isArray(a)?a[0]:a))?.split(",")[0]?.split(";").map(o=>o.trim().split("=")).find(([o])=>o?.toLowerCase()==="host")?.[1];if($!==void 0)return $.replace(/^"(.*)"$/u,"$1");const l=t["x-forwarded-host"];return(Array.isArray(l)?l[0]:l)?.split(",")[0]?.trim()}export async function startDevServer(t){const a=j(t.root);if(t.embedder!==void 0&&!U.test(t.embedder))throw new Error(`Not an origin: ${t.embedder}`);if(t.publicOrigin!==void 0&&!U.test(t.publicOrigin.replace("{port}","1")))throw new Error(`Not an origin: ${t.publicOrigin}`);const f=t.token??E(18).toString("base64url"),l=`/s/${E(18).toString("base64url")}/`,o=await se.open({...t,root:a,...t.publicOrigin===void 0?{}:{reveal:!1}});let c=0;const R=()=>c===0?void 0:t.publicOrigin?.replace("{port}",String(c)),p=()=>{const e=R();return e===void 0?void 0:new URL(e).host},g=()=>{const e=p();return new Set([`127.0.0.1:${String(c)}`,`localhost:${String(c)}`,...e===void 0?[]:[e]])},F=e=>e===p()?R()??"":`http://${e}`,A=e=>F(e.req.header("host")??""),k=e=>{const n=p();n!==void 0&&forwardedHost(e.headers)===n&&(e.headers.host=n)},I=e=>e??`http://127.0.0.1:${String(c)}`;o.serving={file:(e,n)=>`${I(e)}${RAW_PATH}${n.split("/").map(encodeURIComponent).join("/")}?token=${encodeURIComponent(f)}`,tree:e=>`${I(e)}${l}`};const T=new Set,H=new ie(a),O=new Q,L=async e=>{if(!t.ui)return e.text("allyhub dev serves its editors here.",200);const n=await z(P(t.ui,"index.html"),"utf8").catch(()=>{});if(n===void 0)return e.text("The page's files are missing: build them first (pnpm --filter @allyhub/editor-web build).",500);const u=E(16).toString("base64");return e.html(n.replace(/<script/gu,`<script nonce="${u}"`).replace("</head>",`<meta name="allyhub-token" content="${f}"></head>`),200,{"content-security-policy":["default-src 'self'",`script-src 'self' 'nonce-${u}'`,"style-src 'self' 'unsafe-inline'","img-src 'self' data: blob:","media-src 'self' blob:","font-src 'self' data:",`connect-src 'self' ws://${e.req.header("host")??""}`,"frame-src 'self'",`frame-ancestors ${t.embedder??"'none'"}`].join("; "),"cache-control":"no-store"})};O.get("/",L),O.get(`${RAW_PATH}*`,async e=>{if(e.req.query("token")!==f)return e.text("forbidden",403);const n=decodeURIComponent(e.req.path.slice(RAW_PATH.length));if(q(n)!==void 0)return e.text("forbidden",403);const u=w(a,n);return u?h(u,e.req.header("range"),{"x-content-type-options":"nosniff","content-security-policy":"sandbox; default-src 'none'; img-src 'self'; media-src 'self'; style-src 'unsafe-inline'"}):e.text("forbidden",403)}),O.get(`${l}*`,async e=>{let n;try{n=decodeURIComponent(e.req.path.slice(l.length))}catch{return e.notFound()}const u=e.req.header("range"),b=A(e),m=n.slice(0,n.indexOf("/")+1),i=n.slice(m.length);switch(m){case S.runtime:{const r=re(i);if(!r)return e.notFound();const s=Object.values(ee).includes(n);return h(r,void 0,{...d,...s?{"content-security-policy":te(`${b}${l}`,[b,...t.embedder?[t.embedder]:[]])}:{}})}case S.build:{const r=C(i);if(r===void 0){const s=w(o.live.pieceDir,i);return s?h(s,void 0,d):e.notFound()}try{return e.json(await o.live.source(r),200,{...d,"cache-control":"no-store"})}catch(s){return e.json({error:{message:s instanceof Error?s.message:String(s)}},404,d)}}case S.scenery:{const r=C(i);if(r===void 0){const s=w(o.live.sceneryDir,i);return s?h(s,void 0,d):e.notFound()}if(q(r)!==void 0||!w(a,r))return e.text("No such scenery.",404,d);try{const s=await o.live.scenery(r);for(const y of s.media)T.add(y);return e.json(await o.live.scenerySource(r),200,{...d,"cache-control":"no-store"})}catch(s){return e.text(s instanceof Error?s.message:String(s),500,d)}}case S.media:{const s=Object.hasOwn(o.live.latest()?.media??{},i)||T.has(i)?w(a,i):void 0;return s?h(s,u,d):e.notFound()}case Z:{const r=o.live.latest()?.media[i],s=r?w(a,i):void 0;if(!r||!s)return e.notFound();const y=ae({db:e.req.query("db"),speed:e.req.query("speed"),filter:e.req.query("filter")});if(typeof y=="string")return e.text(y,400,d);try{const x=await H.made(s,r.sha256,y,e.req.query("wait")!=="0");return x===void 0?e.body(null,202,d):await h(x,u,{...d,"content-type":"audio/flac"})}catch(x){return e.text(x instanceof Error?x.message:String(x),500,d)}}case S.matte:{const r=ue(a,o.live.latest()?.media[i]);return r?h(r,u,{...d,"content-type":"video/mp4"}):e.notFound()}case S.bakes:{if(!ce.test(i))return e.notFound();const r=w(P(a,ne),i);return r?h(r,void 0,d):e.notFound()}case S.stills:return de.test(i)?h(X.of(a,"stills").path(i),void 0,{...d,"cache-control":"public, max-age=31536000, immutable"}):e.notFound();default:return e.notFound()}}),O.get("/*",async e=>{if(!t.ui)return e.notFound();const n=w(j(t.ui),decodeURIComponent(e.req.path.slice(1)));return n?h(n,void 0,{"cache-control":"public, max-age=3600"}):e.notFound()});const N=new V({noServer:!0,maxPayload:512*1024*1024});N.on("connection",(e,n)=>{const u=o.connect(r=>{e.readyState===e.OPEN&&e.send(JSON.stringify(r))},{origin:F(n.headers.host??"")});e.on("message",(r,s)=>{if(s||!Buffer.isBuffer(r))return;let y;try{y=JSON.parse(r.toString("utf8"))}catch{e.send(JSON.stringify({jsonrpc:"2.0",id:null,error:{code:-32700,message:"Not JSON."}}));return}u.receive(y)});const b=t.pingMs??PING_MS;let m=!0;e.on("pong",()=>{m=!0});const i=b>0?setInterval(()=>{if(!m){e.terminate();return}m=!1,e.ping()},b):void 0;i?.unref(),e.on("close",()=>{clearInterval(i),u.close()})});const M=Y(O.fetch),D=(e,n)=>{e.writeHead(403,{"content-type":"text/plain; charset=utf-8"}),e.end(n)},v=J((e,n)=>{if(k(e),!g().has(e.headers.host??"")){D(n,"forbidden host");return}M(e,n)});v.on("upgrade",(e,n,u)=>{const b=new URL(e.url??"/","http://x"),m=(r,s)=>{n.end(`HTTP/1.1 ${String(r)} ${s}\r
+connection: close\r
+content-length: 0\r
+\r
+`)};k(e);const i=e.headers.host??"";if(!g().has(i)){m(403,"Forbidden");return}if(b.pathname!==RPC_PATH){m(404,"Not Found");return}if(e.headers.origin!==F(i)){m(403,"Forbidden");return}if(b.searchParams.get("token")!==f){m(403,"Forbidden");return}N.handleUpgrade(e,n,u,r=>{N.emit("connection",r,e)})});try{await new Promise((e,n)=>{v.once("error",n),v.listen(t.port??0,"127.0.0.1",()=>{e()})})}catch(e){throw await o.close(),e}return c=v.address().port,{url:`http://127.0.0.1:${String(c)}/`,port:c,token:f,tree:`http://127.0.0.1:${String(c)}${l}`,ui:t.ui,project:o,async close(){for(const e of N.clients)e.terminate();N.close(),await new Promise(e=>{v.closeAllConnections(),v.close(()=>{e()})}),await o.close()}}}

package/dist/node_modules/@allyhub/dev-server/dist/sound.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{createHash as u}from"node:crypto";import{mkdir as m,rename as c,stat as p}from"node:fs/promises";import{join as f}from"node:path";import{soundFilterProblem as l}from"@allyhub/audio";import{speechFile as b}from"@allyhub/audio/node";import{CACHE_DIR as h}from"@allyhub/formats";export function decodeAsOf(i){const t={};if(i.db!==void 0){const e=Number(i.db);if(!Number.isFinite(e)||e<.01||e>97)return"db is the noise reduction, from 0.01 to 97 dB";t.denoise=e}if(i.speed!==void 0){const e=Number(i.speed);if(!Number.isFinite(e)||e<.5||e>2)return"speed is from 0.5 to 2";t.speed=e}if(i.filter!==void 0){const e=l(i.filter);if(e!==void 0)return e;t.filter=i.filter}return t}export class MadeSounds{dir;making=new Map;constructor(t){this.dir=f(t,h,"sound")}async made(t,e,s,a){const d=u("sha256").update(JSON.stringify([e,s.denoise,s.speed,s.filter])).digest("hex").slice(0,32),r=f(this.dir,`${d}.flac`);if((await p(r).catch(()=>{}))?.isFile())return r;let n=this.making.get(d);return n||(n=(async()=>{await m(this.dir,{recursive:!0});const o=`${r}.${String(process.pid)}.part`;return await b(t,o,s),await c(o,r),r})().finally(()=>{this.making.delete(d)}),this.making.set(d,n),n.catch(()=>{})),a?n:void 0}}

package/dist/node_modules/@allyhub/dev-server/dist/tools.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{createHash as R}from"node:crypto";import{access as D,readFile as F}from"node:fs/promises";import{basename as L,join as y,posix as _}from"node:path";import{listFiles as b,sourceOf as I,stageId as N}from"@allyhub/build";import{splitTitle as j,parseDoc as C,titleText as H}from"@allyhub/doc";import{ITEM_KINDS as S,OUT_DIR as U,scanItems as v,scriptFileFor as A,slidesFileFor as K}from"@allyhub/formats";import{OpenedVersion as M,componentStills as q,deckDigests as W,parseCombo as z}from"@allyhub/project";import{runtimeFile as G,stageFiles as J}from"@allyhub/stage-page";import{RPC_ERROR as p,RpcError as m,SNAPSHOT_TREE as $,TREE_PAGES as g,stillPath as V}from"@allyhub/protocol";import{readSheetFile as B}from"@allyhub/sheet";import{themeOfLook as Q}from"@allyhub/slides-core";import{CLEAN_LOOK as X,comboKey as k,componentRefText as Y,formatInfo as E,looksOf as Z,messagePrefix as ee}from"@allyhub/video-core";import{fontFaces as te}from"./fonts.js";import{rpcErrorOf as P}from"./live.js";import{loose as oe}from"./paths.js";const ne=a=>R("sha256").update(a).digest("base64url").slice(0,16),w=(a,r)=>{const l=a.tree();if(l===void 0)throw new m(p.unavailable,"This server serves no pages: only allyhub dev's does.");return new URL(r,l).href},x=(a,r,l)=>({url:w(a,`${r}?${l.toString()}`),probe:w(a,g.probe)}),O=a=>({mime:"image/webp",data:a.toString("base64")});async function se(a,r,l){try{if(r.kind==="doc"){const u=await F(y(a,r.entry),"utf8");return H(j(C(u).blocks).title)||void 0}if(r.kind==="sheet"){const u=await F(y(a,r.entry),"utf8");return B(u).file?.title}}catch{return}return l.get(r.dir)}const re=512;export function toolHandlers(a){const{live:r}=a,l=new Map,u=async(e,t,n,o)=>{try{return await r.withSession(async s=>{const i=await M.open({root:r.root,item:e,...t===void 0?{}:{combos:[z(t)]},purpose:n,session:s});try{return await o(i)}finally{await i.close()}})}catch(s){throw P(s)}};return{"project/items":async()=>{const e=await b(r.root),t=v(e),o=t.items.some(i=>i.kind==="video"||i.kind==="slides")?await r.prepared().catch(()=>r.latest()):void 0,s=new Map;for(const i of o?.pieces??[]){const c=typeof i.title=="string"?i.title:void 0;c&&s.set(i.dir,c)}return{items:await Promise.all(t.items.map(async i=>{const c=await se(r.root,i,s);return{...i,...c?{title:c}:{}}})),name:L(r.root),scope:ne(r.root),revision:r.revision}},"sheet/generated":async({item:e})=>{const t=await r.sheetCode(e);return{failed:t.failed,...t.generated?{generated:t.generated}:{}}},"video/versions":async({item:e})=>{const{piece:t}=await r.target(e),n=[...new Set(t.combos.map(o=>o.lang))];return{piece:t.id,kind:t.kind,...typeof t.title=="string"?{title:t.title}:{},width:E(t.formatEntry)?.width??0,height:E(t.formatEntry)?.height??0,versions:n.map(o=>o===void 0?{key:k({})}:{key:k({lang:o}),lang:o})}},"slides/deck":async({item:e})=>{const{prepared:t,piece:n}=await r.target(e);if(n.kind!=="slides"||!n.deck)throw new Error(`${e} is a video, not a deck.`);const o=Z(t.config).looks;return{piece:n.id,file:K(n.dir),prefix:ee(n.id),layouts:n.deck.layouts,components:n.deck.components,generators:n.deck.generators,code:n.deck.code,data:n.deck.data,theme:Q(o?.clean??X),scripts:Object.fromEntries(t.messages.locales.map(s=>[s,A(n.dir,s)]))}},"video/stage":async({item:e,version:t,start:n,play:o,chrome:s,mode:i})=>{const{piece:c,combo:f}=await r.target(e,t),d=new URLSearchParams({piece:c.id,combo:k(f)});for(const[h,T]of Object.entries(n??{}))d.set(h,String(T));return o&&d.set("play","1"),s===!1&&d.set("chrome","0"),i!==void 0&&d.set("mode",i),x(a,g.stage,d)},"video/timeline":async({item:e,version:t})=>u(e,t,"play",n=>Promise.resolve({timeline:oe(n.timeline),text:n.version.summary?.text??[]})),"video/still":async({item:e,version:t,t:n})=>u(e,t,"render",async o=>{const s=n??o.timeline.parts[0]?.still??0;return{t:s,image:O(await o.still(s,{format:"webp"})),width:o.timeline.width,height:o.timeline.height,duration:o.timeline.duration}}),"video/stills":async({item:e,version:t,moments:n})=>u(e,t,"render",async o=>{const s=[];for(const i of n){const c=await o.version.sign(i),f=`${e}\0${t??""}\0${c??""}`,d=c===void 0?void 0:l.get(f),h=d??O(await o.still(i,{format:"webp"}));c!==void 0&&!d&&(l.size>=re&&l.clear(),l.set(f,h)),s.push({t:i,image:h})}return{stills:s}}),"slides/fonts":async({item:e})=>{const{prepared:t,piece:n}=await r.target(e);if(n.kind!=="slides")throw new Error(`${e} is a video, not a deck.`);const o=J().fontCss.flatMap(c=>{const f=G(c);return f===void 0?[]:[{file:f,url:w(a,`${$.runtime}${c}`)}]}),s=I(t,n).styles??[],i=[...o,...s.map(c=>({file:y(r.pieceDir,c.slice($.build.length)),url:w(a,c)}))];return{faces:(await Promise.all(i.map(c=>te(c)))).flat()}},"components/list":async({item:e})=>{const t=await r.prepared(),n=e.replace(/\/doc\.mdx$/u,"").replace(/^\.?\/?/u,"");return{components:t.components.map(o=>{const s=_.relative(n,o.file);return{of:Y({path:s.startsWith(".")?s:`./${s}`,name:o.export}),name:o.name,...o.label===void 0?{}:{label:o.label}}})}},"doc/data":async({item:e})=>{const t=await r.prepared(),n=e.replace(/\/doc\.mdx$/u,"").replace(/^\.?\/?/u,""),o=t.docs.find(s=>s.place===n);if(!o)throw new m(p.notFound,`${e} is not a doc.`);return{data:o.data}},"components/stage":async({item:e,version:t})=>{const{prepared:n,host:o,combo:s}=await r.componentHost(e,t);if(!("components"in o)&&o.kind!=="slides")throw new m(p.notFound,`${e} has no components to draw alone: a deck's or a doc's are.`);const{code:i}=await W(n,o),c=new URLSearchParams({piece:N(o),combo:k(s),mode:"component",code:i.slice(0,16)});return x(a,g.stage,c)},"components/stills":async({item:e,version:t,components:n})=>{w(a,$.stills);try{const{prepared:o,host:s,combo:i}=await r.componentHost(e,t);if(!("components"in s)&&s.kind!=="slides")throw new m(p.notFound,`${e} has no components to draw alone: a deck's or a doc's are.`);const{gpu:c}=await r.browser();return{stills:(await q(n,{prepared:o,item:s,combo:i,gpu:c,withSession:d=>r.withSession(d)})).map(({key:d})=>({key:d,url:w(a,V(d))}))}}catch(o){throw P(o)}},"check/results":()=>Promise.resolve(a.checker?.state??{status:"off",revision:r.revision,problems:[],facts:[]}),"check/run":()=>{if(!a.checker)throw new m(p.unavailable,"This server runs no check.");return a.checker.schedule(!0),Promise.resolve({})},"export/start":async({item:e,versions:t,types:n,options:o})=>{const s=await b(r.root);if(!v(s).items.some(i=>i.dir===e))throw new m(p.notFound,`There is no item ${e}.`);return{job:a.exports.start(e,t??[],n??[],o)}},"export/cancel":({job:e})=>{if(!a.exports.cancel(e))throw new m(p.notFound,`No export ${e} is under way.`);return Promise.resolve({})},"export/list":()=>Promise.resolve({jobs:a.exports.list(),reveal:a.reveal!==void 0}),"export/reveal":async({path:e})=>{if(!a.reveal)throw new m(p.unavailable,"This server is not on the person's computer: download the file.");if(!e.startsWith(`${U}/`))throw new m(p.notFound,`${e} is no exported file.`);const t=y(r.root,e);return await D(t).catch(()=>{throw new m(p.notFound,`There is no file ${e}.`)}),await a.reveal(t),{}},"scenery/viewer":async({item:e,camera:t})=>{const n=await b(r.root),o=v(n).items.find(i=>i.dir===e&&(i.kind==="scenery"||i.kind==="model"));if(!o)throw new m(p.notFound,`There is no scenery or 3D model ${e}: a scenery is a folder with a ${S.scenery.entries[0]??"scenery.ts"}, a model one with a ${S.model.entries[0]??"model.ts"}.`);const s=new URLSearchParams({file:o.entry});return t&&s.set("camera",JSON.stringify(t)),x(a,g.viewer,s)}}}

package/dist/node_modules/@allyhub/dev-server/dist/tree.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{join as n}from"node:path";import{indexPath as o}from"@allyhub/video-core";export const BAKE_NAME=/^[0-9a-f]+\.[a-z0-9-]+\.bin$/u,STILL_NAME=/^[0-9a-f]{64}\.webp$/u;export function sourceName(t){const e=/^sources\/([^/]+)\.json$/u.exec(t);if(e?.[1])try{return decodeURIComponent(e[1])}catch{return}}export function matteFile(t,e){return e?.matte===!0?n(t,o(e.sha256,"matte.mp4")):void 0}

package/dist/node_modules/@allyhub/dev-server/dist/validate.js

@@ -0,0 +1,3 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{parse as c}from"yaml";import{parseDoc as p}from"@allyhub/doc";import{DATA_FILES as m,ITEM_KINDS as l,baseOf as f}from"@allyhub/formats";import{readSheetFile as u}from"@allyhub/sheet";const $=r=>new RegExp(`^${r.split("**/").map(s=>s.replace(/[.+?^${}()|[\]\\]/gu,"\\$&").replaceAll("*","[^/]*")).join("(?:.*/)?")}$`,"u"),d=Object.entries(m).flatMap(([r,s])=>s.files.map(t=>({name:r,re:$(t)})));export function dataFileOf(r){return d.find(s=>s.re.test(r))?.name}const g=l.doc.entries[0],b=l.sheet.entries[0];export function writeProblems(r,s){const t=f(r);if(t===g){const e=p(s),n=e.blocks.length===0?e.problems[0]:void 0;return n&&s.trim()!==""?[`not MDX${n.line===void 0?"":` (line ${String(n.line)})`}: ${n.message}`]:[]}if(t===b)return u(s).problems.filter(e=>e.message.startsWith("not YAML")).map(e=>e.message);const a=dataFileOf(r);if(a===void 0)return[];let o;try{o=/\.ya?ml$/u.test(t)?c(s):JSON.parse(s)}catch(e){return[`not ${/\.ya?ml$/u.test(t)?"YAML":"JSON"}: ${e.message.split(`
+`)[0]??""}`]}const i=m[a].schema.safeParse(o);return i.success?[]:i.error.issues.map(e=>`${e.path.length?`${e.path.join(".")}: `:""}${e.message}`)}

package/dist/node_modules/@allyhub/dev-server/dist/watcher.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{watch as v}from"node:fs";import{readdir as g,stat as k}from"node:fs/promises";import{join as a,posix as l}from"node:path";import{LOCAL_DIR as w,within as u}from"@allyhub/formats";import{current as d,pathProblem as y}from"./paths.js";const m=40,T=["node_modules",".git"],p=f=>f===w||f.startsWith(`${w}/`)||f.split("/").some(t=>T.includes(t));export class Watcher{revision=0;root;tell;moved;watches=new Map;known=new Map;written=new Map;fs;pending=new Set;timer;next=1;running=Promise.resolve();constructor(t,s,e=()=>{}){this.root=t,this.tell=s,this.moved=e}start(){this.fs=v(this.root,{recursive:!0},(t,s)=>{if(s===null)return;const e=s.split("\\").join("/");this.pending.add(e),clearTimeout(this.timer),this.timer=setTimeout(()=>{this.flush()},m)}),this.fs.on("error",()=>{})}async watch(t,s){const e=`w${String(this.next++)}`;this.watches.set(e,{client:t,paths:[...s]});for(const o of s)await this.hash(o,!0);return e}unwatch(t){this.watches.delete(t)}forget(t){for(const[s,e]of this.watches)e.client===t&&this.watches.delete(s)}wrote(t,s){for(const e of t)this.known.set(e.path,e.version),this.written.set(e.path,e.version);this.fanOut(t,s),this.bump()}async settled(){await new Promise(t=>setTimeout(t,m*2)),await this.running}close(){clearTimeout(this.timer),this.fs?.close(),this.watches.clear()}bump(){this.revision++,this.moved(this.revision)}covered(t){for(const s of this.watches.values())if(s.paths.some(e=>u(t,e)||u(e,t)))return!0;return!1}flush(){const t=[...this.pending];this.pending=new Set,this.running=this.running.then(async()=>{const s=t.filter(i=>!p(i));let e=!1;for(const i of s){if(!this.written.has(i)){e=!0;continue}((await d(a(this.root,i)))?.version??null)!==this.written.get(i)&&(e=!0),this.written.delete(i)}e&&this.bump();const o=[];for(const i of s)this.covered(i)&&o.push(...await this.hash(i,!1));o.length>0&&this.fanOut(o,void 0)})}async hash(t,s){const e=[],o=async n=>{const r=(await d(a(this.root,n)))?.version??null,c=this.known.get(n);c===r&&this.known.has(n)||(this.known.set(n,r),!s&&!(c===void 0&&r===null)&&e.push({path:n,version:r}))},i=await k(a(this.root,t)).catch(()=>{}),h=new Set;if(i?.isDirectory()){const n=await g(a(this.root,t),{recursive:!0,withFileTypes:!0}).catch(()=>[]);for(const r of n){if(!r.isFile())continue;const c=l.join(t,l.relative(a(this.root,t).split("\\").join("/"),a(r.parentPath,r.name).split("\\").join("/")));y(c)===void 0&&!p(c)&&h.add(c)}}else h.add(t);for(const n of this.known.keys())u(n,t)&&h.add(n);for(const n of h)await o(n);return e}fanOut(t,s){for(const[e,o]of this.watches){if(o.client===s)continue;const i=t.filter(h=>o.paths.some(n=>u(h.path,n)));i.length>0&&this.tell(e,i)}}}

package/dist/node_modules/@allyhub/dev-server/dist/writer.js

@@ -0,0 +1,3 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{randomBytes as A}from"node:crypto";import{mkdir as v,readFile as E,readdir as b,rename as x,rm as T,stat as S,writeFile as k}from"node:fs/promises";import{dirname as g,extname as _,join as w,posix as D}from"node:path";import R from"write-file-atomic";import{moveEdits as C,movedPath as F}from"@allyhub/build";import{CACHE_DIR as N,TRASH_DIR as d}from"@allyhub/formats";import{RPC_ERROR as l,RpcError as f}from"@allyhub/protocol";import{current as y,fileIn as p,pathProblem as I,versionOf as j}from"./paths.js";import{writeProblems as O}from"./validate.js";export const UPLOAD_MAX_BYTES=200*1024*1024,LIST_LIMIT=5e3;const L=[N,d];function M(m){const e=(m.split(/[/\\]/u).pop()??"").replace(/\p{Cc}/gu,"").replace(/^\.+/u,"").trim();return e===""?"file":e}export class Writer{root;wrote;writable;queue=Promise.resolve();constructor(t,e=()=>{},i=()=>Promise.resolve()){this.root=t,this.wrote=e,this.writable=i}serial(t){const e=async()=>(await this.writable(),t()),i=this.queue.then(e,e);return this.queue=i.catch(()=>{}),i}async read(t){const e=await y(await p(this.root,t));return e?{text:e.bytes.toString("utf8"),version:e.version}:{text:"",version:null}}write(t,e,i,o){return this.serial(async()=>{const r=await p(this.root,t,{write:!0}),s=await y(r),c=s?.version??null;if(c!==i)throw new f(l.conflict,`${t} changed since it was read.`,{text:s?.bytes.toString("utf8")??"",version:c});const a=O(t,e);if(a.length>0)throw new f(l.invalid,`${t} would not be a file AllyHub can read: ${a[0]??""}`,{problems:a});const u=j(e);return u===c||(await v(g(r),{recursive:!0}),await R(r,e),this.wrote([{path:t,version:u}],o)),u})}upload(t,e,i,o){return i.length>UPLOAD_MAX_BYTES?Promise.reject(new f(l.invalid,`${e} is larger than ${String(UPLOAD_MAX_BYTES/1024/1024)} MB.`)):this.serial(async()=>{const r=M(e),s=_(r),c=r.slice(0,r.length-s.length);for(let a=1;;a++){const u=a===1?r:`${c}-${String(a)}${s}`,n=t===""?u:`${t}/${u}`,h=await p(this.root,n,{write:!0});if(!await $(h))return await v(g(h),{recursive:!0}),await k(h,i,{flag:"wx"}),this.wrote([{path:n,version:j(i)}],o),n}})}move(t,e,i){return this.serial(async()=>{const o=await p(this.root,t,{write:!0}),r=await p(this.root,e,{write:!0});if(e===t||e.startsWith(`${t}/`))throw new f(l.invalid,`${t} cannot move into itself.`);if(!await $(o))throw new f(l.notFound,`There is no ${t}.`);if(await $(r))throw new f(l.conflict,`${e} is taken.`,{text:"",version:null});const s=await C(this.root,t,e);for(const n of s)await R(w(this.root,n.path),n.text);const c=await P(t,o);await v(g(r),{recursive:!0}),await x(o,r);const a=c.map(n=>({path:n,version:null}));for(const n of c){const h=F(n,t,e);a.push({path:h,version:(await y(w(this.root,h)))?.version??null})}const u=s.map(n=>F(n.path,t,e));for(const n of s)F(n.path,t,e)===n.path&&a.push({path:n.path,version:j(n.text)});return this.wrote(a,i),u})}remove(t,e){return this.serial(async()=>{const i=await p(this.root,t,{write:!0});if(!await $(i))throw new f(l.notFound,`There is no ${t}.`);const o=await P(t,i),r=`${String(Date.now())}-${A(4).toString("hex")}`,s=w(this.root,d,r,...t.split("/"));await v(g(s),{recursive:!0}),await x(i,s);const c={path:t,removed:Date.now()};return await k(w(this.root,d,`${r}.json`),`${JSON.stringify(c)}
+`),this.wrote(o.map(a=>({path:a,version:null})),e),r})}async trash(){const t=w(this.root,d),e=await b(t).catch(()=>[]),i=[];for(const o of e){if(!o.endsWith(".json"))continue;const r=await E(w(t,o),"utf8").then(s=>JSON.parse(s)).catch(()=>{});typeof r?.path!="string"||typeof r.removed!="number"||I(r.path)!==void 0||i.push({id:o.slice(0,-5),path:r.path,removed:r.removed})}return i.sort((o,r)=>r.removed-o.removed)}restore(t,e){return this.serial(async()=>{const i=(await this.trash()).find(a=>a.id===t);if(!i)throw new f(l.notFound,`Nothing in the bin is ${t}.`);const o=await p(this.root,i.path,{write:!0});if(await $(o))throw new f(l.conflict,`${i.path} is there again: move it before putting this back.`,{text:"",version:null});const r=w(this.root,d,t,...i.path.split("/"));await v(g(o),{recursive:!0}),await x(r,o),await T(w(this.root,d,t),{recursive:!0,force:!0}),await T(w(this.root,d,`${t}.json`),{force:!0});const s=await P(i.path,o),c=[];for(const a of s)c.push({path:a,version:(await y(w(this.root,a)))?.version??null});return this.wrote(c,e),i.path})}async list(t){const e=t===""?this.root:await p(this.root,t),i=[],o=[],r=async(s,c)=>{const a=await b(s,{withFileTypes:!0}).catch(()=>[]);for(const u of a.sort((n,h)=>n.name.localeCompare(h.name))){if(i.length>=LIST_LIMIT)return;const n=c===""?u.name:`${c}/${u.name}`;if(I(n)===void 0&&!(L.some(h=>n===h)&&!(t===n||t.startsWith(`${n}/`)))){if(u.isDirectory())o.push(n),await r(w(s,u.name),n);else if(u.isFile()){const h=await S(w(s,u.name)).catch(()=>{});h&&i.push({path:n,size:h.size,modified:h.mtimeMs})}}}};return await r(e,t),{files:i,dirs:o}}}const $=m=>S(m).then(()=>!0,()=>!1);async function P(m,t){const e=await S(t).catch(()=>{});if(!e)return[];if(!e.isDirectory())return[m];const i=[],o=await b(t,{recursive:!0,withFileTypes:!0});for(const r of o)r.isFile()&&i.push(D.join(m,D.relative(t.split("\\").join("/"),w(r.parentPath,r.name).split("\\").join("/"))));return i}

package/dist/node_modules/@allyhub/dev-server/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@allyhub/dev-server",
+  "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/doc/dist/chart.d.ts

@@ -0,0 +1,65 @@
+import { type ChartDef } from "@allyhub/chart";
+import type { ThemeColor } from "@allyhub/formats";
+import type { ChartBlock, PageLook } from "./model.js";
+export { CHART_PALETTE } from "./paper.js";
+/** Bars: their groups' gap (% of a bar, Office's 150 is thin) and, within a group, a sliver apart (overlap %). */
+export declare const CHART_BARS: {
+    readonly gap: 80;
+    readonly overlap: -8;
+};
+/** Its text's size and its title's, points, in a frame of the column's width. */
+export declare const CHART_TEXT: {
+    readonly size: 10;
+    readonly title: 13;
+};
+/** A colour a doc writes for a chart or an accent, as `#RRGGBB`; undefined when it cannot be read. */
+export declare const chartColor: (value: string) => string | undefined;
+/** The theme a doc's charts are drawn in: the palette, the page's accent first, then the chart's own colours. */
+export declare function chartTheme(page?: PageLook, colors?: readonly string[]): Record<ThemeColor, string>;
+/** A pie's frame where it sets none: at most this wide, px at 1×, and this high over its width, so its legend stays beside it. */
+export declare const ROUND_FRAME: {
+    readonly width: 560;
+    readonly aspect: 0.6;
+};
+/**
+ * Its frame, px at 1×: as written, else as wide as where it stands (`room`,
+ * default the page's column) at 16:9; a pie or a doughnut no wider than
+ * ROUND_FRAME, a little flatter.
+ */
+export declare function chartFrame(block: Pick<ChartBlock, "width" | "height"> & {
+    kind?: ChartBlock["kind"];
+}, room?: number): {
+    width: number;
+    height: number;
+};
+/** What gives a doc's charts their numbers, and their colours. */
+export interface DocChartOptions {
+    /** How the page looks: its accent is a chart's first colour. */
+    page?: PageLook;
+    /** The doc's folder, a project path: what `data` is read from. */
+    base?: string;
+    /** A data file's rows, by the path a chart writes (`../sales#Revenue`); undefined when there is none. */
+    data?: (path: string) => unknown;
+}
+/** A doc's chart as the chart it is, or what keeps it from being drawn. */
+export declare function docChart(block: ChartBlock, o?: DocChartOptions): {
+    chart?: ChartDef;
+    problems: string[];
+};
+/** What a chart shows, in words: its `alt`, else its title and what it plots. */
+export declare function chartWords(block: ChartBlock, chart?: ChartDef): string;
+/** How a doc's chart is drawn: its face, and the ground it is on. */
+export interface DocChartSvgOptions extends DocChartOptions {
+    /** Its text's face, as CSS names it. */
+    font?: string;
+    /** Drawn on a dark ground (an editor in a dark theme): light text and rules. Paper is always light. */
+    dark?: boolean;
+    /** How wide where it stands is, px at 1× (a column's: `columnWidths`); default the page's column. */
+    room?: number;
+}
+/** A doc's chart as SVG, its frame's size; undefined, with why, when it cannot be drawn. */
+export declare function docChartSvg(block: ChartBlock, o?: DocChartSvgOptions): {
+    svg?: string;
+    problems: string[];
+};
+//# sourceMappingURL=chart.d.ts.map

package/dist/node_modules/@allyhub/doc/dist/chart.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{chartOfFile as T,chartSvg as y,isBar as O,isRound as x,isScatter as C,variesOf as R}from"@allyhub/chart";import{hex as S}from"./color.js";import{PAPER as A,accentPalette as D}from"./paper.js";import{COMPONENT_ASPECT as B,COMPONENT_WIDTH as N}from"./component.js";export{CHART_PALETTE}from"./paper.js";const H={gray:"#8B8A85",brown:"#9A6B4B",red:"#D6403A",orange:"#EB6834",yellow:"#EDA100",green:"#1BAF7A",blue:"#2A78D6",purple:"#8A5CD6",pink:"#E87BA4"},E=A.lead,F={grid:A.rule,axis:A.ruleMid};export const CHART_BARS={gap:80,overlap:-8},CHART_TEXT={size:10,title:13},chartColor=e=>{const n=S(e,H);return n===void 0?void 0:`#${n}`};export function chartTheme(e={},n=[]){const t=D(e.accent===void 0?void 0:chartColor(e.accent));n.slice(0,t.length).forEach((o,h)=>{const f=chartColor(o);f!==void 0&&(t[h]=f)});const[i,r,d,s,c,g]=t;return{dk1:E,lt1:"#FFFFFF",dk2:"#37352F",lt2:"#EFEFED",accent1:i,accent2:r,accent3:d,accent4:s,accent5:c,accent6:g,hlink:i,folHlink:i}}export const ROUND_FRAME={width:560,aspect:.6};export function chartFrame(e,n=N){const t=e.kind!==void 0&&x(e.kind),i=e.width??(t?Math.min(n,ROUND_FRAME.width):n);return{width:i,height:e.height??Math.round(i*(t?ROUND_FRAME.aspect:B))}}function M(e){const n=e.trim().replace(/,/gu,"");if(n==="")return null;const t=Number(n);return Number.isFinite(t)?t:void 0}function P(e,n){const t=C(e.kind),i=e.labels,r=e.min!==void 0||e.max!==void 0||e.format!==void 0?{...e.min===void 0?{}:{min:e.min},...e.max===void 0?{}:{max:e.max},...e.format===void 0?{}:{format:e.format}}:void 0,d={...i===void 0?{}:{labels:{...i.includes("value")?{value:!0}:{},...i.includes("percentage")?{percentage:!0}:{},...i.includes("category")?{category:!0}:{},...i.includes("series")?{series:!0}:{},...e.format===void 0?{}:{format:e.format}}},...r===void 0?{}:{value_axis:r},...x(e.kind)?{vary_by_categories:!0}:{}};if(e.table===void 0)return e.data===void 0||e.categories===void 0?void 0:{type:e.kind,data:e.data,categories:e.categories,series:e.series??[],...d};const[s=[],...c]=e.table,g=Math.max(0,...e.table.map(a=>a.length)),o=(a,l)=>a[l]??"",h=a=>c.map((l,m)=>{const _=M(o(l,a));return _===void 0?(n.push(`row ${String(m+1)} of its table: "${o(l,a)}" under ${o(s,a)||`column ${String(a+1)}`} is not a number`),null):_}),f=Array.from({length:Math.max(0,g-1)},(a,l)=>{const m=l+1;return{name:o(s,m)||`Series ${String(m)}`,values:h(m),...t?{x:h(0)}:{}}});if(f.length!==0)return{type:e.kind,...t?{}:{categories:c.map(a=>o(a,0))},series:f,...d}}function $(e,n){if(e.legend!=="none")return e.legend!==void 0?e.legend:x(e.kind)?"right":n.series.length>1?"bottom":void 0}export function docChart(e,n={}){const t=[],i=P(e,t);if(!i)return{problems:[...t,"it has no numbers to draw"]};const r=T(i,{title:e.title,base:n.base??"",rows:u=>{const p=n.data?.(u);if(p===void 0)throw new Error("there is no such file or table");return p},problem:u=>t.push(u)});if(!r)return{problems:t};const d=$(e,r),s=chartTheme(n.page,e.colors),c=[s.accent1,s.accent2,s.accent3,s.accent4,s.accent5,s.accent6],g=u=>({rgb:c[u%c.length]??"#000000"}),o=R(r),h=C(e.kind),f=e.table===void 0?e.categories:e.table[0]?.[0],a=r.series.length===1?r.series[0]?.name:void 0,l={gridline_color:{rgb:F.grid},line_color:{rgb:F.axis}},m=O(e.kind),_=e.kind.endsWith("-clustered"),w={...r,category_axis:{...l,...r.category_axis,...h&&f!==void 0&&f!==""?{title:f}:{}},value_axis:{...l,...r.value_axis,...h&&a!==void 0&&a!==""?{title:a}:{}},...m&&r.gap_width===void 0?{gap_width:CHART_BARS.gap}:{},..._&&r.series.length>1&&r.overlap===void 0?{overlap:CHART_BARS.overlap}:{},series:r.series.map((u,p)=>o||u.color!==void 0?u:{...u,color:g(p)}),...o?{category_colors:r.categories.map((u,p)=>g(p))}:{},...d===void 0?{}:{legend:d},font_size:CHART_TEXT.size,title_size:CHART_TEXT.title,font_color:{rgb:E}};return d===void 0&&delete w.legend,{chart:w,problems:t}}export function chartWords(e,n){if(e.alt!==void 0)return e.alt;const t=n?.series.map(r=>r.name).join(", ")??"",i=[e.title,t].filter(r=>r!==void 0&&r!=="");return i.length>0?i.join(": "):"Chart"}const v={ink:"#D4D3CF",grid:"#3A3936",axis:"#5C5B57"};export function docChartSvg(e,n={}){const t=docChart(e,n),{problems:i}=t;if(!t.chart)return{problems:i};const r=g=>({...g,gridline_color:{rgb:v.grid},line_color:{rgb:v.axis}}),d=n.dark===!0?{...t.chart,font_color:{rgb:v.ink},value_axis:r(t.chart.value_axis),category_axis:r(t.chart.category_axis)}:t.chart,{width:s,height:c}=chartFrame(e,n.room);return{svg:y(d,s,c,{colors:chartTheme(n.page,e.colors),paper:"none",edge:"none",...n.font===void 0?{}:{font:n.font},label:chartWords(e,d)}),problems:i}}

package/dist/node_modules/@allyhub/doc/dist/color.d.ts

@@ -0,0 +1,6 @@
+/** The colours a doc names, as the editor shows them. */
+export declare const TEXT_COLORS: Record<string, string>;
+export declare const BACKGROUNDS: Record<string, string>;
+/** A colour as six hex digits, upper case (Word's, DrawingML's): a name the table knows, or a CSS colour; none for what cannot be read. */
+export declare function hex(value: string | undefined, table: Record<string, string>): string | undefined;
+//# sourceMappingURL=color.d.ts.map

package/dist/node_modules/@allyhub/doc/dist/color.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const TEXT_COLORS={gray:"#9b9a97",brown:"#64473a",red:"#e03e3e",orange:"#d9730d",yellow:"#dfab01",green:"#4d6461",blue:"#0b6e99",purple:"#6940a5",pink:"#ad1a72"},BACKGROUNDS={gray:"#ebeced",brown:"#e9e5e3",red:"#fbe4e4",orange:"#f6e9d9",yellow:"#fbf3db",green:"#ddedea",blue:"#ddebf1",purple:"#eae4f2",pink:"#f4dfeb"};function p(r,f,e){const o=f*Math.min(e,1-e),n=t=>{const a=(t+r/30)%12;return 255*(e-o*Math.max(-1,Math.min(a-3,9-a,1)))};return[n(0),n(8),n(4)]}export function hex(r,f){if(r===void 0)return;const e=(f[r]??r).trim().toLowerCase(),o=/^#([0-9a-f])([0-9a-f])([0-9a-f])f?$/.exec(e);if(o)return o.slice(1).map(s=>s+s).join("").toUpperCase();const n=/^#([0-9a-f]{6})([0-9a-f]{2})?$/.exec(e);if(n?.[1]!==void 0)return n[1].toUpperCase();const t=/^(rgb|hsl)a?\(([^)]*)\)$/.exec(e),[a=NaN,d=NaN,i=NaN]=(t?.[2]??"").split(/[\s,/]+/).filter(Boolean).map(Number.parseFloat);return!t||[a,d,i].some(Number.isNaN)?void 0:(t[1]==="rgb"?[a,d,i]:p(a,d/100,i/100)).map(s=>Math.round(Math.min(255,Math.max(0,s))).toString(16).padStart(2,"0")).join("").toUpperCase()}

package/dist/node_modules/@allyhub/doc/dist/columns.d.ts

@@ -0,0 +1,6 @@
+import type { ColumnsBlock } from "./model.js";
+/** The space between two columns, px at 1×. */
+export declare const COLUMN_GAP = 32;
+/** Each column's width, px at 1×, in `room` (default the page's column, COMPONENT_WIDTH): its share of what the gaps leave. */
+export declare function columnWidths(block: Pick<ColumnsBlock, "columns">, room?: number): number[];
+//# sourceMappingURL=columns.d.ts.map

package/dist/node_modules/@allyhub/doc/dist/columns.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{COMPONENT_WIDTH as c}from"./component.js";export const COLUMN_GAP=32;export function columnWidths(n,r=c){const o=n.columns.map(t=>t.width??1),s=o.reduce((t,m)=>t+m,0)||1,e=Math.max(0,r-COLUMN_GAP*(n.columns.length-1));return o.map(t=>Math.round(e*t/s))}

package/dist/node_modules/@allyhub/doc/dist/component.d.ts

@@ -0,0 +1,27 @@
+import type { Block } from "./model.js";
+export type ComponentBlock = Extract<Block, {
+    type: "component";
+}>;
+/** The component's name as a person reads it: its export, else its module's file name. */
+export declare function componentName(block: Pick<ComponentBlock, "of">): string;
+/** What draws a block's still: the same for two blocks that draw the same picture. */
+export declare function componentDrawing(block: ComponentBlock): Pick<ComponentBlock, "of" | "width" | "height" | "at" | "props">;
+/** A block's drawing as one string, to find its still by. */
+export declare const componentDrawingKey: (block: ComponentBlock) => string;
+/** A component's frame where its block sets no size: px at 1×, about the page's column. */
+export declare const COMPONENT_WIDTH = 720;
+/** Its height where the block sets only a width, or neither: 16:9. */
+export declare const COMPONENT_ASPECT: number;
+/**
+ * What draws a block: the stage's ask (`components/stage`, `components/stills`),
+ * its component by the reference it writes, its props as text (the stage
+ * reads them by the component's types), its frame and its moment.
+ */
+export declare function componentAt(block: ComponentBlock): {
+    name: string;
+    props: Record<string, string>;
+    width: number;
+    height: number;
+    t: number;
+};
+//# sourceMappingURL=component.d.ts.map

package/dist/node_modules/@allyhub/doc/dist/component.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export function componentName(t){const e=t.of.lastIndexOf("#"),n=e<0?"":t.of.slice(e+1);return n!==""&&n!=="default"?n:((e<0?t.of:t.of.slice(0,e)).split("/").pop()??"").replace(/\.[^.]+$/u,"")}export function componentDrawing(t){return{of:t.of,...t.width===void 0?{}:{width:t.width},...t.height===void 0?{}:{height:t.height},...t.at===void 0?{}:{at:t.at},props:Object.fromEntries(Object.entries(t.props).sort(([e],[n])=>e<n?-1:e>n?1:0))}}export const componentDrawingKey=t=>JSON.stringify(componentDrawing(t)),COMPONENT_WIDTH=720,COMPONENT_ASPECT=9/16;export function componentAt(t){const e=t.width??COMPONENT_WIDTH;return{name:t.of,props:{...t.props},width:e,height:t.height??Math.round(e*COMPONENT_ASPECT),t:t.at??0}}

package/dist/node_modules/@allyhub/doc/dist/docx.d.ts

@@ -0,0 +1,39 @@
+import type * as Docx from "docx";
+import { type DocChartOptions } from "./chart.js";
+import { type ComponentBlock } from "./component.js";
+import { type Block } from "./model.js";
+/** The docx module, as `import("docx")` gives it. */
+export type DocxModule = typeof Docx;
+/** What the file passes through: fflate's. */
+export interface DocxZip {
+    unzipSync(data: Uint8Array): Record<string, Uint8Array>;
+    zipSync(files: Record<string, Uint8Array>, options: {
+        mtime: Date;
+    }): Uint8Array;
+}
+/** A picture ready for Word, in a type Word shows. */
+export interface DocxPicture {
+    data: Uint8Array;
+    type: "png" | "jpg" | "gif";
+    /** Its size in px. */
+    width: number;
+    height: number;
+}
+/** `page` sets its faces and its accent; `data` and `base` give its charts their numbers. */
+export interface DocxOptions extends DocChartOptions {
+    /** The document's title. */
+    title?: string;
+    /** The page's cover, cut to its band (COVER_ASPECT, at its cover-y) by the host; without it the page has none. */
+    cover?: DocxPicture | undefined;
+    /** An equation's or a diagram's picture (a ```math or ```mermaid block), as the host drew it; without one its code stands. */
+    drawn?: (block: Extract<Block, {
+        type: "code";
+    }>) => DocxPicture | undefined;
+    /** A picture by how the doc names it; without one its words stand in. */
+    picture?: (src: string) => DocxPicture | undefined;
+    /** A component's still; without one a box with its name stands in. */
+    component?: (block: ComponentBlock) => DocxPicture | undefined;
+}
+/** A doc's blocks as a Word document's bytes. */
+export declare function docxOf(docx: DocxModule, zip: DocxZip, blocks: readonly Block[], options?: DocxOptions): Promise<Uint8Array>;
+//# sourceMappingURL=docx.d.ts.map

package/dist/node_modules/@allyhub/doc/dist/docx.js

@@ -0,0 +1,5 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{chartBook as De,embeddedChartXml as Ne}from"@allyhub/chart";import{chartFrame as Ce,chartWords as Se,docChart as Le}from"./chart.js";import{BACKGROUNDS as k,TEXT_COLORS as Y,hex as v}from"./color.js";import{columnWidths as $e}from"./columns.js";import{COMPONENT_WIDTH as Oe,componentName as ze}from"./component.js";import{pageAccent as Ie}from"./html.js";import{markdownOf as Me}from"./markdown.js";import{DRAWN_CODE as ee}from"./math.js";import{PAPER as F}from"./paper.js";import{COVER_ASPECT as Pe,everyBlock as _e,noteNumbers as ve}from"./model.js";const V=15,z={width:11906,height:16838,top:1020,side:1134},le=z.width-2*z.side,q=360,Fe={sans:"Calibri",serif:"Georgia",mono:"Consolas"},te="Courier New",H=r=>r.slice(1).toUpperCase(),ne=H(F.ink),he=H(F.lead),me=H(F.rule),re=H(F.ruleStrong),oe=H(F.ruleMid),ie=H(F.stone),b=H(F.leadSoft),ue="ALLYHUB-CHART-",He=[48,36,28,24,24,24];function Ge(r){return/[\u3040-\u30ff]/u.test(r)?"Yu Gothic":/[\uac00-\ud7af]/u.test(r)?"Malgun Gothic":"Microsoft YaHei"}const Xe=/^(https?:|mailto:)/i,se={indent:0,level:0,room:le,frame:Oe},pe=r=>({...r,indent:r.indent+q,level:Math.min(r.level+1,8)}),be=400,Ue=r=>r.type==="bullet"||r.type==="numbered"||r.type==="check";function We(r,f,w){const i=w/V,p=Math.floor(Math.min(f??r.width,i));return{width:p,height:Math.round(p*r.height/r.width)}}function Be(r,f,w,i,p){const{AlignmentType:a,BorderStyle:m,ExternalHyperlink:g,ImageRun:D,Paragraph:o,ShadingType:N,Table:S,TableCell:I,TableLayoutType:O,TableRow:M,TextRun:E,WidthType:T}=r,A={ascii:te,hAnsi:te,cs:te,eastAsia:w},R=new Set([1]);let B=0;const Z=[],U=e=>({type:N.CLEAR,color:"auto",fill:e}),W=(e,t,n=4)=>({style:e,color:t,size:n,space:4}),J=()=>new o({spacing:{after:0,line:160},run:{size:8}}),ae=e=>e==="center"?a.CENTER:e==="right"?a.RIGHT:e==="justify"?a.JUSTIFIED:void 0,ce=(e,t,n,l={})=>{const s=v(t.color,Y)??n.color,c=v(t.background,k),d={...l,...t.bold||n.bold?{bold:!0}:{},...t.italic?{italics:!0}:{},...t.underline?{underline:{}}:{},...t.strike?{strike:!0}:{},...s===void 0?{}:{color:s},...n.size===void 0?{}:{size:n.size},...t.code?{font:A,shading:U(c??ie)}:c===void 0?{}:{shading:U(c)}};return e.split(`
+`).map((h,C)=>new E({...d,text:h,...C>0?{break:1}:{}}))},P=(e,t={})=>e.flatMap(n=>n.note!==void 0?p.has(n.note.toLowerCase())?[new r.FootnoteReferenceRun(p.get(n.note.toLowerCase())??1)]:[]:n.href!==void 0&&Xe.test(n.href)?[new g({link:n.href,children:ce(n.text,n.styles,t,{style:"Hyperlink"})})]:ce(n.text,n.styles,t)),de=e=>{const t=ae(e?.align),n=v(e?.background,k);return{...t===void 0?{}:{alignment:t},...n===void 0?{}:{shading:U(n)}}},$=e=>e.indent===0?{}:{indent:{left:e.indent}},we=e=>{const t={style:m.SINGLE,color:e,size:4};return{top:t,bottom:t,left:t,right:t}},ye=(e,t)=>{const n=v(e.look?.background,k)??ie,l=v(e.look?.color,Y),s=t.room-t.indent;return new S({width:{size:s,type:T.DXA},columnWidths:[s],...t.indent===0?{}:{indent:{size:t.indent,type:T.DXA}},rows:[new M({children:[new I({shading:U(n),borders:we(n),margins:{top:100,bottom:100,left:140,right:140,marginUnitType:T.DXA},children:[new o({children:[new E({text:`${e.icon??"💡"} `}),...P(e.content,{color:l})]}),...G(e.children??[],se)]})]})]})},Ee=(e,t)=>{const n=t.room-t.indent,l=Math.max(1,...e.rows.map(u=>u.length)),s=Array.from({length:l},(u,y)=>e.widths?.[y]?(e.widths[y]??0)*V:void 0),c=s.reduce((u,y)=>u+(y??0),0),d=s.filter(u=>u===void 0).length,h=d===0?0:Math.max(n-c,0)/d,C=s.map(u=>u??h),_=C.reduce((u,y)=>u+y,0)||1,L=Math.min(1,n/_),x=C.map(u=>Math.round(u*L)),X=e.head===void 0||e.head==="both",j=e.head==="column"||e.head==="both";return new S({layout:O.FIXED,width:{size:x.reduce((u,y)=>u+y,0),type:T.DXA},columnWidths:x,...t.indent===0?{}:{indent:{size:t.indent,type:T.DXA}},rows:e.rows.map((u,y)=>new M({tableHeader:X&&y===0,children:Array.from({length:l},(Ze,K)=>{const xe=X&&y===0||j&&K===0;return new I({width:{size:x[K]??0,type:T.DXA},borders:{top:{style:m.NONE,size:0,color:"auto"},left:{style:m.NONE,size:0,color:"auto"},right:{style:m.NONE,size:0,color:"auto"},bottom:{style:m.SINGLE,size:4,color:X&&y===0?re:me}},margins:{top:80,bottom:80,left:K===0?0:140,right:140,marginUnitType:T.DXA},children:[new o({spacing:{after:0},children:P(u[K]??[],{bold:xe})})]})})}))})},Q=(e,t,n,l)=>{const s=ae(e.align),c={...$(t),...s===void 0?{}:{alignment:s}},d=[new o({...c,keepNext:e.caption!==void 0,children:n?[new D({type:n.type,data:n.data,transformation:We(n,e.width,t.room-t.indent),altText:{name:e.alt??"",title:e.caption??e.alt??"",description:e.alt??""}})]:[new E({text:l,color:b})]})];return e.caption!==void 0&&n&&d.push(new o({...c,children:[new E({text:e.caption,color:b,size:20})]})),d},Te=(e,t)=>{const n=t.room-t.indent,l=e.columns.map(L=>L.width??1),s=l.reduce((L,x)=>L+x,0)||1,c=l.map(L=>Math.round(n*L/s)),d=$e(e,t.frame),h={style:m.NONE,size:0,color:"auto"},C={top:h,bottom:h,left:h,right:h,insideHorizontal:h,insideVertical:h},_=be/2;return new S({layout:O.FIXED,width:{size:n,type:T.DXA},columnWidths:c,borders:C,...t.indent===0?{}:{indent:{size:t.indent,type:T.DXA}},rows:[new M({children:e.columns.map((L,x)=>{const X=c[x]??0,j=x===0?0:_,u=x===e.columns.length-1?0:_,y=G(L.blocks,{indent:0,level:0,room:X-j-u,frame:d[x]??t.frame});return new I({width:{size:X,type:T.DXA},borders:C,margins:{top:0,bottom:0,left:j,right:u,marginUnitType:T.DXA},children:y.at(-1)instanceof o?y:[...y,new o({})]})})})]})},Ae=(e,t,n)=>{const l=v(e.look?.color,Y),s=G(e.children??[],pe(t)),c=de(e.look);return e.type==="check"?[new o({...c,...$(t),children:[new E({text:e.checked?"☑ ":"☐ "}),...P(e.content,{color:l})]}),...s]:[new o({...c,...e.type==="bullet"?{bullet:{level:t.level}}:{numbering:{reference:`start-${String(n.start)}`,level:t.level,instance:n.id}},children:P(e.content,{color:l})}),...s]},Re=(e,t)=>{const n="look"in e?e.look:void 0,l=v(n?.color,Y),s=de(n),c=()=>"children"in e?G(e.children??[],pe(t)):[];switch(e.type){case"paragraph":case"toggle":return[new o({...s,...$(t),children:P(e.content,{color:l})}),...c()];case"heading":return[new o({...s,...$(t),heading:r.HeadingLevel[`HEADING_${String(e.level)}`],children:P(e.content,{color:l})}),...c()];case"quote":return[new o({...s,indent:{left:t.indent+q},border:{left:W(m.SINGLE,i??re,i?12:6)},children:P(e.content,{color:l??he})}),...c()];case"callout":return[ye(e,t),J()];case"code":{if(e.language===ee.math||e.language===ee.mermaid){const d=f.drawn?.(e);if(d)return Q({...e.language===ee.math?{}:{align:"center"}},t,d,"")}return[new o({...$(t),shading:U(ie),keepLines:!0,children:e.code.split(`
+`).map((d,h)=>new E({text:d,font:A,size:19,...h>0?{break:1}:{}}))})]}case"columns":return[Te(e,t),J()];case"chart":{const{chart:d,problems:h}=Le(e,f),C=W(m.DASHED,oe);if(!d)return[new o({...$(t),alignment:a.CENTER,border:{top:C,bottom:C,left:C,right:C},children:[new E({text:[e.title??"Chart",...h].join(": "),color:b})]})];const _=Ce(e,t.frame),L=(t.room-t.indent)/V,x=Math.min(1,L/_.width);return Z.push({chart:d,width:Math.round(_.width*x),height:Math.round(_.height*x),words:Se(e,d)}),[new o({...$(t),alignment:a.CENTER,children:[new E({text:`${ue}${String(Z.length)}`})]})]}case"image":return Q(e,t,f.picture?.(e.src),e.alt??e.caption??e.src);case"component":{const d=f.component?.(e);if(d)return Q(e,t,d,"");const h=W(m.DASHED,oe);return[new o({...$(t),alignment:a.CENTER,border:{top:h,bottom:h,left:h,right:h},children:[new E({text:ze(e),color:b})]})]}case"table":return[Ee(e,t),J()];case"pagebreak":return[new o({children:[new r.PageBreak]})];case"note":return[];case"divider":return[new o({...$(t),border:{bottom:W(m.SINGLE,me)}})];case"embed":{const d=/^<\s*([A-Za-z][\w.]*)/.exec(e.source.trim())?.[1],h=W(m.DASHED,oe);return[new o({...$(t),alignment:a.CENTER,border:{top:h,bottom:h,left:h,right:h},children:[new E({text:d??"",color:b})]})]}case"source":return[];case"bullet":case"numbered":case"check":return[]}};function G(e,t){const n=[];let l,s;for(const c of e){if(!Ue(c)){l=void 0,s=void 0,n.push(...Re(c,t));continue}if(l===void 0||s===void 0||s.type==="numbered"!=(c.type==="numbered")){const d=c.type==="numbered"?c.start??1:1;R.add(d),l={id:++B,start:d}}s=c,n.push(...Ae(c,t,l))}return n}return{charts:Z,body:e=>G(e,se),footnotes:e=>Object.fromEntries([..._e(e)].flatMap(t=>{if(t.type!=="note")return[];const n=p.get(t.label.toLowerCase());if(n===void 0)return[];const l=G(t.children??[],se).filter(s=>s instanceof o);return[[String(n),{children:[new o({spacing:{after:40},children:P(t.content,{size:18,color:he})}),...l]}]]})),numbering:()=>[...R].sort((e,t)=>e-t).map(e=>({reference:`start-${String(e)}`,levels:Array.from({length:9},(t,n)=>({level:n,format:[r.LevelFormat.DECIMAL,r.LevelFormat.LOWER_LETTER,r.LevelFormat.LOWER_ROMAN][n%3]??r.LevelFormat.DECIMAL,text:`%${String(n+1)}.`,alignment:a.LEFT,...n===0?{start:e}:{},style:{paragraph:{indent:{left:(n+1)*q,hanging:q}}}}))}))}}const je="1980-01-01T00:00:00Z",fe=9525,ge="http://schemas.openxmlformats.org/officeDocument/2006/relationships",Ke=r=>r.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;");function Ye(r,f,w,i,p){return r.forEach((a,m)=>{const g=String(m+1),D=`rIdChart${g}`,o=`Microsoft_Excel_Worksheet${g}.xlsx`;p(`word/charts/chart${g}.xml`,Ne(a.chart,{width:a.width*.75,height:a.height*.75},"rId1",{frameless:!0})),p(`word/charts/_rels/chart${g}.xml.rels`,`<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Id="rId1" Type="${ge}/package" Target="../embeddings/${o}"/></Relationships>`),p(`word/embeddings/${o}`,De(a.chart)),w=w.replace("</Relationships>",`<Relationship Id="${D}" Type="${ge}/chart" Target="charts/chart${g}.xml"/></Relationships>`),i=i.replace("</Types>",`<Override ContentType="application/vnd.openxmlformats-officedocument.drawingml.chart+xml" PartName="/word/charts/chart${g}.xml"/></Types>`);const N=String(a.width*fe),S=String(a.height*fe),I=`<w:r><w:drawing><wp:inline distT="0" distB="0" distL="0" distR="0"><wp:extent cx="${N}" cy="${S}"/><wp:effectExtent l="0" t="0" r="0" b="0"/><wp:docPr id="0" name="Chart ${g}" descr="${Ke(a.words)}"/><wp:cNvGraphicFramePr/><a:graphic xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"><a:graphicData uri="http://schemas.openxmlformats.org/drawingml/2006/chart"><c:chart xmlns:c="http://schemas.openxmlformats.org/drawingml/2006/chart" r:id="${D}"/></a:graphicData></a:graphic></wp:inline></w:drawing></w:r>`;f=f.replace(new RegExp(`<w:r>(?:(?!<w:r>).)*?<w:t[^>]*>${ue}${g}</w:t></w:r>`,"su"),I)}),r.length>0&&!i.includes('Extension="xlsx"')&&(i=i.replace("</Types>",'<Default ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" Extension="xlsx"/></Types>')),{document:f,rels:w,types:i}}function Ve(r,f,w){const i=f.unzipSync(r),p=A=>{const R=i[A];return R&&new TextDecoder().decode(R)},a=(A,R)=>{i[A]=typeof R=="string"?new TextEncoder().encode(R):R},m="word/document.xml",g="word/_rels/document.xml.rels",D="[Content_Types].xml",o=Ye(w,p(m)??"",p(g)??"",p(D)??"",a);a(D,o.types);let N=o.document,S=o.rels;[...new Set([...N.matchAll(/w:hyperlink [^>]*r:id="([^"]+)"/g)].map(A=>A[1]??""))].forEach((A,R)=>{const B=`rIdLink${String(R+1)}`;N=N.split(`"${A}"`).join(`"${B}"`),S=S.split(`"${A}"`).join(`"${B}"`)});let O=0;N=N.replace(/<wp:docPr id="\d+"/g,()=>`<wp:docPr id="${String(++O)}"`),a(m,N),a(g,S);const M="docProps/core.xml",E=p(M);E!==void 0&&a(M,E.replace(/(<dcterms:(?:created|modified)[^>]*>)[^<]*/g,`$1${je}`));const T=Object.fromEntries(Object.entries(i).sort(([A],[R])=>A<R?-1:1));return f.zipSync(T,{mtime:new Date(1980,0,1)})}function qe(r,f,w){const i={size:16,color:b,font:w};return new r.Footer({children:[new r.Paragraph({tabStops:[{type:r.TabStopType.RIGHT,position:le}],children:[new r.TextRun({...i,text:f??""}),new r.TextRun({...i,children:[new r.Tab,r.PageNumber.CURRENT," / ",r.PageNumber.TOTAL_PAGES]})]})]})}export async function docxOf(r,f,w,i={}){const p=Ge(Me(w)),a=Fe[i.page?.font??"sans"],m={ascii:a,hAnsi:a,cs:a,eastAsia:p},g=v(Ie(i.page),{}),D=Be(r,i,p,g,ve(w)),o=D.body(w);if(i.cover){const O=Math.round(z.width/V);o.unshift(new r.Paragraph({spacing:{before:0,after:0},children:[new r.ImageRun({type:i.cover.type,data:i.cover.data,transformation:{width:O,height:Math.round(O*Pe)},floating:{horizontalPosition:{relative:r.HorizontalPositionRelativeFrom.PAGE,offset:0},verticalPosition:{relative:r.VerticalPositionRelativeFrom.PAGE,offset:0},allowOverlap:!1,margins:{bottom:324e3},wrap:{type:r.TextWrappingType.TOP_AND_BOTTOM}},altText:{name:"Cover",title:"Cover",description:""}})]}))}const N={spacing:{after:160,line:276}},S=new r.Document({creator:"AllyHub",lastModifiedBy:"AllyHub",...i.title===void 0?{}:{title:i.title},numbering:{config:D.numbering()},styles:{default:{document:{run:{font:m,size:22,color:ne},paragraph:N},hyperlink:{run:{color:g??ne,underline:{color:g??re}}},...Object.fromEntries(He.map((O,M)=>[`heading${String(M+1)}`,{run:{size:O,bold:!0,font:m,color:ne},paragraph:{spacing:{before:280,after:120}}}]))}},sections:[{properties:{page:{size:{width:z.width,height:z.height},margin:{top:z.top,bottom:z.top,left:z.side,right:z.side}}},...i.page?.pageNumbers===!1?{}:{footers:{default:qe(r,i.title,a)}},children:o}],footnotes:D.footnotes(w)}),I=await r.Packer.toBuffer(S);return Ve(new Uint8Array(I),f,D.charts)}

package/dist/node_modules/@allyhub/doc/dist/html.d.ts

@@ -0,0 +1,49 @@
+import { type DocChartOptions } from "./chart.js";
+import { type ComponentBlock } from "./component.js";
+import { type Block, type PageLook } from "./model.js";
+/** The faces a page is set in, as CSS names them: its text, and its first-level headings. */
+export declare const PAGE_FACES: {
+    readonly sans: "\"Commissioner Variable\", Commissioner, \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", system-ui, sans-serif";
+    readonly serif: "\"Piazzolla Variable\", Piazzolla, \"Noto Serif SC\", \"Songti SC\", Georgia, serif";
+    readonly mono: "\"JetBrains Mono Variable\", \"JetBrains Mono\", \"SF Mono\", Menlo, Consolas, \"Noto Sans SC\", monospace";
+};
+/** A page's faces by its look: sans text under serif titles and sections (the default), or one face all through. */
+export declare function pageFaces(look?: PageLook): {
+    text: string;
+    heading: string;
+};
+/** A page's accent as CSS, else the default's. */
+export declare const pageAccent: (look?: PageLook) => string | undefined;
+/** `page`: how the page looks, its front matter (`parseDoc(…).page`). */
+export interface DocHtmlOptions extends DocChartOptions {
+    /** How wide the blocks are laid out, px at 1× (a column's inside columns); default the page's column. */
+    room?: number;
+    /** A diagram (a ```mermaid block) as the host drew it: its SVG, or why it could not be; without it its code stands. */
+    diagram?: (code: string) => {
+        svg?: string;
+        error?: string;
+    } | undefined;
+    /** The page's title (the browser's, and the PDF's). */
+    title?: string;
+    /** An address the page can load a picture from, by how the doc names it. */
+    image?: (src: string) => string | undefined;
+    /** What stands in for an embed: its picture as HTML, when the host drew one. */
+    embed?: (source: string, index: number) => string | undefined;
+    /** A component's still, an address the page can load it from, when the host drew it; without it a box with its name stands in. */
+    component?: (block: ComponentBlock) => string | undefined;
+    /**
+     * The @font-face rules of the faces DOC_CSS names (Commissioner, Piazzolla,
+     * JetBrains Mono), and KaTeX's style sheet with its faces for an equation,
+     * when the host has their files; without them the page is set in what this
+     * computer has.
+     */
+    fonts?: string;
+}
+export { BACKGROUNDS, TEXT_COLORS } from "./color.js";
+/** The page's own styles: type that reads on paper, and where a page may break. */
+export declare const DOC_CSS: string;
+/** What the page's look changes of DOC_CSS: its faces, its accent. */
+export declare function pageCss(look?: PageLook): string;
+/** A doc's blocks as one HTML page. */
+export declare function docHtml(list: readonly Block[], opts?: DocHtmlOptions): string;
+//# sourceMappingURL=html.d.ts.map