allyhub 0.4.0 → 0.6.0

package/dist/node_modules/@allyhub-next/scenery/dist/phone.d.ts

@@ -0,0 +1,36 @@
+import type { HandheldOptions } from "./handheld.js";
+import type { LensFrame } from "./lens.js";
+import type { SensorOptions } from "./moire.js";
+/** What a phone's camera is, as the options of each mechanism. */
+export interface PhoneCamera {
+    /** A camera state's lens: 35 mm-equivalent focal length on the phone's 4:3 frame, and its aperture in the same terms. */
+    lens: {
+        lens: number;
+        lensFrame: LensFrame;
+        aperture: number;
+    };
+    /** The sensor filming a screen: its photosites, the lens's own blur on them, its moiré and false colour, its distortion. */
+    sensor: SensorOptions;
+    /** handheld(camera, hand): the hand, its stabiliser, its autofocus and auto-exposure. */
+    hand: HandheldOptions;
+}
+/**
+ * A phone's main camera filming a screen or a room indoors, held in a
+ * hand: a 26 mm lens on its 4:3 frame at f/8 equivalent (f/1.8 on its
+ * small sensor), a 12 MP sensor, a hand whose tremor its stabiliser mostly
+ * takes out, focus that hunts after a cut, a reframe or a jolt, exposure
+ * that follows a new framing late, and a grade that takes a render's flat,
+ * pale, cool picture to the contrast and colour of a phone filming a screen:
+ * a screen's white stays near white, and what is dark goes darker.
+ */
+export declare const PHONE_CAMERA: PhoneCamera;
+/** Something with every field optional, all the way down. */
+export type Deeper<T> = {
+    [K in keyof T]?: T[K] extends readonly unknown[] ? T[K] : T[K] extends object ? Deeper<T[K]> : T[K];
+};
+/**
+ * PHONE_CAMERA with any of its values changed (`{ hand: { tremor: { angle:
+ * 0.2 } } }` changes that one and keeps the rest).
+ */
+export declare function phoneCamera(over?: Deeper<PhoneCamera>): PhoneCamera;
+//# sourceMappingURL=phone.d.ts.map

package/dist/node_modules/@allyhub-next/scenery/dist/phone.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const PHONE_CAMERA={lens:{lens:26,lensFrame:"phone",aperture:8},sensor:{photosites:4032,lens:.35,moire:1,chroma:.3,distortion:-.03,grade:{filter:"curves=all='0/0 0.2/0.07 0.5/0.38 0.78/0.82 1/1',eq=saturation=1.5,colortemperature=temperature=6000"}},hand:{angle:.25,roll:.6,shift:.001,sway:.65,tremor:{angle:.1,frequency:8.5},drift:{angle:.15,shift:.001,period:8},stabilizer:{strength:.7,cutoff:1.5},autofocus:{},exposure:{}}};const s=e=>typeof e=="object"&&e!==null&&!Array.isArray(e);function i(e,r){if(!s(e)||!s(r))return r===void 0?e:r;const n={...e};for(const[t,o]of Object.entries(r))n[t]=o===void 0?e[t]:i(e[t],o);return n}export function phoneCamera(e={}){return i(PHONE_CAMERA,e)}

package/dist/node_modules/@allyhub-next/scenery/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@allyhub-next/scenery",
+  "version": "0.6.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/scenery-host/dist/bundle.d.ts

@@ -0,0 +1,75 @@
+import { type Plugin, type UserVite } from "@allyhub-next/build";
+/** Where a stage serves three.js's decoders (draco/, basis/): this folder beside its pieces/ and chunks/. */
+export { stageCameras, writeModelStage } from "./model-stage.js";
+export declare const THREE_LIBS = "three-libs";
+/** Where a stage serves the wasm files a scenery page loads. */
+export declare const WASM_DIR = "wasm";
+/** three.js's examples/jsm/libs folder (draco/, basis/), of the copy this package depends on. */
+export declare function threeLibsDir(): string;
+/** manifold-3d's wasm, of the copy AllyHub has. */
+export declare function manifoldWasmFile(): Promise<string>;
+/** xatlas-web's wasm, of the copy this package depends on. */
+export declare function xatlasWasmFile(): string;
+/** Copies three's decoders into a stage's folder, as `three-libs/draco/` and `three-libs/basis/`. */
+export declare function copyDecoders(stageDir: string): Promise<void>;
+/**
+ * Lends three.js to a project that does not declare it: "three" and
+ * "three/…" resolve to this package's pinned copy, from anywhere (three's
+ * addons import "three" too, and must get the same copy). A project that
+ * declares its own builds with it.
+ */
+export declare function lendThree(opts: {
+    /** Package names the project's package.json declares. */
+    dependencies: ReadonlySet<string>;
+}): Plugin;
+/**
+ * Resolves manifold-3d to the copy AllyHub has: it does not install with
+ * AllyHub, so nothing beside the layer or the modelling library that import it
+ * holds it. Every build a scenery can be in needs this: a stage's as well.
+ */
+export declare function lendManifold(): Plugin;
+/** Resolves this package's own entry points, which the entries the build writes import: never the project's. */
+export declare function hostResolve(): Plugin;
+/**
+ * Ends each scenery item's entry module (…/scenery.ts) with a call
+ * that records which file its scenery came from (module.ts's markScenery),
+ * so a scenery() layer that draws it finds the paths it names from its own
+ * module. A module whose default export is not written `export default …`
+ * is left as it is.
+ */
+export declare function sceneryModules(opts: {
+    root: string;
+}): Plugin;
+export interface SceneryBundle {
+    /** The bundle's file, relative to the build folder. */
+    module: string;
+    /** Where three's decoders are, relative to the build folder (a folder, ending in "/"). */
+    decoders: string;
+    /** manifold-3d's wasm, relative to the build folder, for overlap volumes. */
+    manifoldWasm: string;
+    /** xatlas-web's wasm, relative to the build folder, for a bake. */
+    xatlasWasm: string;
+    /** The project's files bundled into it (project paths). */
+    files: string[];
+}
+/**
+ * Bundles a scenery module (a project path) with this package's page half
+ * into the build folder's stage, as `stage/pieces/scenery__<name>.<hash>.js`,
+ * which exports the scenery as `scenery` and everything of this package's
+ * page half (openScenery, startViewer…): the page that loads it calls them
+ * with its own adapter. `plugins` are the stage's own (AllyHub's, which
+ * read media and refuse what a project may not import), run after this
+ * package's.
+ */
+export declare function bundleScenery(opts: {
+    root: string;
+    /** The scenery module, a project path. */
+    file: string;
+    /** The build folder. */
+    outDir: string;
+    /** Package names the project's package.json declares. */
+    dependencies: ReadonlySet<string>;
+    plugins: Plugin[];
+    user?: UserVite;
+}): Promise<SceneryBundle>;
+//# sourceMappingURL=bundle.d.ts.map

package/dist/node_modules/@allyhub-next/scenery-host/dist/bundle.js

@@ -0,0 +1,6 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{realpathSync as _}from"node:fs";import{cp as S,copyFile as d,mkdir as y,writeFile as v}from"node:fs/promises";import{createRequire as W}from"node:module";import{dirname as l,join as o,relative as j,sep as p}from"node:path";import{fileURLToPath as c}from"node:url";import{bundleForStage as D}from"@allyhub-next/build";import{entryKind as F}from"@allyhub-next/formats";import{manifoldFiles as h}from"@allyhub-next/model/build";export{stageCameras,writeModelStage}from"./model-stage.js";export const THREE_LIBS="three-libs",WASM_DIR="wasm";const i="@allyhub-next/scenery-host",O="manifold-3d/manifold",k=new Set(["three"]),E=W(import.meta.url);export function threeLibsDir(){return l(l(c(import.meta.resolve("three/addons/libs/draco/draco_decoder.wasm"))))}export async function manifoldWasmFile(){return(await h()).wasm}export function xatlasWasmFile(){return E.resolve("xatlas-web/dist/xatlas-web.wasm")}export async function copyDecoders(e){const r=threeLibsDir();for(const t of["draco","basis"])await S(o(r,t),o(e,THREE_LIBS,t),{recursive:!0})}function M(e){const r=e.split("/");return e.startsWith("@")?r.slice(0,2).join("/"):r[0]??e}export function lendThree(e){return{name:"allyhub-scenery-three",enforce:"pre",resolveId(r){const t=M(r);if(!k.has(t)||e.dependencies.has(t))return null;try{return c(import.meta.resolve(r))}catch{return null}}}}export function lendManifold(){return{name:"allyhub-scenery-manifold",enforce:"pre",async resolveId(e){return e===O?(await h()).js:null}}}export function hostResolve(){return{name:"allyhub-scenery-host",enforce:"pre",resolveId(e){return e!==i&&!e.startsWith(`${i}/`)?null:c(import.meta.resolve(e))}}}const w=/(^|\n)export default\s+/;function b(e){let r=e;try{r=_(e)}catch{}return t=>{for(const a of[r,e]){const n=j(a,t).split(p).join("/");if(!n.startsWith("..")&&!n.startsWith("/"))return n}}}export function sceneryModules(e){const r=b(e.root);return{name:"allyhub-scenery-modules",enforce:"post",transform(t,a){const n=r(a.replace(/[?#].*$/,""));return n===void 0||F(n)!=="scenery"||!w.test(t)?null:{code:`${t.replace(w,"$1const __allyhubScenery = ")}
+import { markScenery as __allyhubMark } from ${JSON.stringify(`${i}/module`)};
+export default __allyhubMark(__allyhubScenery, ${JSON.stringify(n)});
+`,map:null}}}}const N=e=>e.replace(/\.[^.]+$/,"").replace(/[^A-Za-z0-9]+/g,"_").replace(/^_+|_+$/g,"");export async function bundleScenery(e){const r=`scenery__${N(e.file)}`,t=o(e.outDir,"sceneries",`${r}.entry.js`);await y(l(t),{recursive:!0});const a=o(e.root,e.file).split(p).join("/");await v(t,["// Written by allyhub for a scenery page: the scenery and its host, one bundle.",`export { default as scenery } from ${JSON.stringify(a)};`,`export * from ${JSON.stringify(i)};`,""].join(`
+`));const n=o(e.outDir,"stage"),u=await D({root:e.root,entries:{[r]:t},outDir:n,plugins:[hostResolve(),lendManifold(),lendThree({dependencies:e.dependencies}),sceneryModules({root:e.root}),...e.plugins],...e.user?{user:e.user}:{}}),f=u.entries[r];if(!f)throw new Error(`The scenery ${e.file} did not bundle.`);const x=b(e.root),m=new Set;for(const g of Object.values(u.chunks))for(const $ of g.modules){const s=x($.replace(/[?#].*$/,""));s!==void 0&&!s.includes("node_modules")&&!s.startsWith(".allyhub/")&&m.add(s)}return await y(o(n,WASM_DIR),{recursive:!0}),await d(await manifoldWasmFile(),o(n,WASM_DIR,"manifold.wasm")),await d(xatlasWasmFile(),o(n,WASM_DIR,"xatlas.wasm")),await copyDecoders(n),{module:`stage/${f.file}`,decoders:`stage/${THREE_LIBS}/`,manifoldWasm:`stage/${WASM_DIR}/manifold.wasm`,xatlasWasm:`stage/${WASM_DIR}/xatlas.wasm`,files:[...m].sort()}}

package/dist/node_modules/@allyhub-next/scenery-host/dist/layer/index.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{glassProblems as _,moireCamera as D,moireProblems as A,PANEL_DEFAULTS as C,project as R,resolveCamera as M,SCREEN_FOCUS_DEFAULTS as j,SCREEN_LIGHT_DEFAULTS as x,screenLightBaseProblem as P}from"@allyhub-next/scenery";import{isPieceDefinition as z,LAYER_BRAND as L}from"@allyhub-next/video-core";import{bakeFile as B,DRAWN_OVER_RULE as I,ruleOf as J,SCENERY_RULES as H}from"../allyhub.js";import{sceneryFileOf as W}from"../module.js";import{drawMoire as G}from"./moire.js";import{answerFor as q}from"./queries.js";import{blurScreen as V,drawScreen as Y,mountScreen as K,placeInScenery as X,screenEdge as Z,screenFocusOf as Q,screenTo as ee,stackByDepth as ne}from"./screens.js";import{cameraOf as re,coded as O,refScenery as $,registry as v,ruled as k,sceneryAtFilm as se,sceneryTime as F}from"./state.js";import{SCREEN as te}from"./types.js";export{stackByDepth}from"./screens.js";export{markScenery,sceneryFileOf}from"../module.js";export{PHONE_CAMERA,phoneCamera,aimAt,aimed,AIM_DEFAULTS,AUTO_EXPOSURE_DEFAULTS,AUTOFOCUS_DEFAULTS,BAKE_DEFAULTS,blend,CAMERA_DEFAULTS,cameraProblems,cutsOf,defineScenery,diagonalLens,directionOf,easeValue,exposureOf,fieldOfView,FIT_DEFAULTS,fitCamera,focusScreen,GLASS_DEFAULTS,handheld,HANDHELD_DEFAULTS,keys,lensForVertical,mixCameras,orbit,PANEL_DEFAULTS,path,PATH_DEFAULTS,project,resolveCamera,rise,SCREEN_LIGHT_DEFAULTS,SENSOR_DEFAULTS,shots,STABILIZER_DEFAULTS,withCuts,SCENERY_RENDERER_DEFAULTS,yawPitchOf}from"@allyhub-next/scenery";export const SCREEN_DEFAULTS={size:[1920,1080],background:"#000000"};function ie(t){if(t===!1)return!1;const n=typeof t=="object"?t:{},e=n.brightness??1;if(!(Number.isFinite(e)&&e>=0))throw new Error(`screen()'s inScenery brightness ${String(e)} is not a number of 0 or more.`);const o=n.light??!0;if(o===!1)return{brightness:e,light:!1};const s=(typeof o=="object"?o.cells:void 0)??[...x.cells];if(s.length!==2||!s.every(a=>Number.isInteger(a)&&a>=1&&a<=32))throw new Error(`screen()'s inScenery light cells ${JSON.stringify(s)} are not two whole numbers from 1 to 32 (across, down).`);const c=(typeof o=="object"?o.specular:void 0)??x.specular;if(typeof c!="boolean")throw new Error(`screen()'s inScenery light specular ${JSON.stringify(c)} is not true or false.`);const i=(typeof o=="object"?o.base:void 0)??x.base;if(i!==null){const a=P(i);if(a!==void 0)throw new Error(`screen()'s inScenery light base: ${a}.`)}const l=i;return{brightness:e,light:{cells:[s[0]??1,s[1]??1],specular:c,base:l?{brightness:l.brightness??e,color:typeof l.color=="string"?l.color:l.color?[...l.color]:"#ffffff"}:null}}}export function screen(t,n={}){if((n.start!==void 0||n.cue!==void 0)&&n.time!==void 0)throw new Error("screen() takes start and cue, or time, not both.");if(n.cues!==void 0){if(n.start!==void 0||n.cue!==void 0||n.time!==void 0)throw new Error("screen() takes cues, or start and cue, or time: one way to time it.");if(Object.keys(n.cues).length===0)throw new Error(`screen()'s cues is empty: give the screen's moments and where each plays, { "@click": "@press" }.`);for(const[a,h]of Object.entries(n.cues)){if(!(a.trim().startsWith("@")?!0:Number.isFinite(Number(a)))||Array.isArray(t)&&a.trim().startsWith("@"))throw new Error(`screen()'s cue key ${JSON.stringify(a)}: ${Array.isArray(t)?`layers' moments are seconds of the screen's time, as a string ("2.5")`:`a video's own reference ("@click") or seconds of its time as a string ("2.5")`}.`);if(!(typeof h=="number"&&Number.isFinite(h))&&!(typeof h=="string"&&h.trim()!==""))throw new Error(`screen()'s cue ${JSON.stringify(a)} plays at ${JSON.stringify(h)}: a reference of the film ("@press") or a scenery time in seconds.`)}}if(typeof n.cue=="number"&&!Number.isFinite(n.cue))throw new Error(`screen()'s cue ${String(n.cue)} is not a number of seconds.`);if(typeof n.cue=="string"&&Array.isArray(t))throw new Error(`screen()'s cue "${n.cue}" is a reference: only a video has references of its own. Give layers' cue in seconds of the screen's time.`);const e=n.background??SCREEN_DEFAULTS.background,o={[te]:!0,time:n.time??{},...n.start!==void 0?{start:n.start}:{},...n.cue!==void 0?{cue:n.cue}:{},...n.cues!==void 0?{cues:{...n.cues}}:{},background:e==="transparent"?null:e,...n.pixels?{pixels:{...n.pixels}}:{},...n.glass?{glass:{...n.glass}}:{},inScenery:ie(n.inScenery)},s=A(void 0,n.pixels);if(s.length>0)throw new Error(`screen()'s ${s.join(" ")}`);const c=_(n.glass);if(c.length>0)throw new Error(`screen()'s ${c.join(" ")}`);if(!Array.isArray(t)){if(!z(t))throw new Error('screen() shows a video item (its piece, imported: import demo from "../demo/video") or graphic layers.');if(n.size!==void 0||n.dur!==void 0)throw new Error("screen() with a video takes its size and length from the video: its own format, and its length.");return{...o,video:t,layers:[],size:SCREEN_DEFAULTS.size}}const i=t;for(const a of i)if(a[L]!=="graphic")throw new Error("screen() takes graphic layers (components, custom()), or a video item whose own layers include footage.");const l=n.size??SCREEN_DEFAULTS.size;if(!(l[0]>0&&l[1]>0))throw new Error(`screen()'s size ${JSON.stringify(l)} is not two sizes in px.`);return{...o,layers:i,size:l,...n.dur!==void 0?{dur:n.dur}:{}}}export const SCENERY_LAYER_DEFAULTS={scale:.5,name:"scenery",focusLevels:j.levels};const N=new WeakMap,T=new WeakMap,U=new WeakMap,oe=()=>{const t=import.meta.url;return new URL("../three-libs/",t).href};function ae(t,n,e){const o=W(t);return{assetUrl:s=>n.asset(`/${s.replace(/^\/+/,"")}`).url,...o===void 0?{}:{module:o},decoders:oe(),seed:e,onProblem:s=>{n.report?.({code:J(s.kind),level:s.level,message:s.message})},bakeUrl:(s,c)=>n.optionalAsset?.(`/${B(s,c)}`)?.url,...n.realTimers?{timers:n.realTimers}:{}}}function ce(t,n,e){let o=T.get(t);return o||(o=Promise.all([import("../page/page.js"),import("../signature.js")]).then(async([{SceneryPage:s},{signatureOf:c}])=>{const i={page:await s.open(t,ae(t,n,e)),sign:c};return U.set(t,i),i}),T.set(t,o)),o}function le(t,n){const e=n.canvas;e.parentNode!==t.el&&t.el.insertBefore(e,t.canvas),e.dataset.akSign="the scenery's renderer",Object.assign(e.style,{position:"absolute",left:t.canvas.style.left,top:t.canvas.style.top,width:t.canvas.style.width,height:t.canvas.style.height,clipPath:"inset(0 calc(100% - 1px) calc(100% - 1px) 0)",pointerEvents:"none"})}export function scenery(t,n){const{at:e,until:o,dur:s,z:c,...i}=n,l={...e===void 0?{}:{at:e},...o===void 0?{}:{until:o},...s===void 0?{}:{dur:s},...c===void 0?{}:{z:c}},a=i.box===void 0||i.box==="full"?[0,0,1,1]:i.box;if(a.some(p=>!Number.isFinite(p))||a[2]<=0||a[3]<=0||a[0]+a[2]>1+1e-9||a[1]+a[3]>1+1e-9)throw new Error(`scenery()'s box ${JSON.stringify(a)} is not inside the frame: [x, y, width, height] as fractions, x + width and y + height at most 1.`);const h=i.quality?.scale??SCENERY_LAYER_DEFAULTS.scale;if(!(h>0&&h<=4))throw new Error(`scenery()'s quality.scale ${String(h)} is outside (0, 4].`);const u=i.quality?.focusLevels??SCENERY_LAYER_DEFAULTS.focusLevels;if(!(Number.isInteger(u)&&u>=1&&u<=16))throw new Error(`scenery()'s quality.focusLevels ${String(u)} is not a whole number from 1 to 16.`);const d=A(i.sensor,void 0);if(d.length>0)throw new Error(`scenery()'s ${d.join(" ")}`);const f=i.background;return{[L]:"graphic",...l,component:"scenery",props:{scenery:t,camera:i.camera,box:a,...f===void 0?{}:{background:f==="transparent"?null:f},time:i.time??{},scale:h,focusLevels:u,...i.sensor?{sensor:{...i.sensor}}:{},name:i.name??SCENERY_LAYER_DEFAULTS.name,screens:i.screens??{},props:i.props??[]},mount(p,y,w){k(()=>{de(p,y,w)})},render(p,y){k(()=>{fe(p,y)})}}}function de(t,n,e){const{width:o,height:s}=e.dims,c={x:Math.round(n.box[0]*o),y:Math.round(n.box[1]*s),w:Math.max(1,Math.round(n.box[2]*o)),h:Math.max(1,Math.round(n.box[3]*s))},i=document.createElement("canvas"),l=e.sceneryScale??n.scale;i.width=Math.max(1,Math.round(c.w*l)),i.height=Math.max(1,Math.round(c.h*l)),Object.assign(i.style,{position:"absolute",left:`${String(c.x)}px`,top:`${String(c.y)}px`,width:`${String(c.w)}px`,height:`${String(c.h)}px`});const a=document.createElement("div");Object.assign(a.style,{position:"absolute",left:i.style.left,top:i.style.top,width:i.style.width,height:i.style.height,overflow:"hidden",isolation:"isolate"});const h=g=>se(n,(e.film?.start??0)+g);t.appendChild(a);const u=Object.entries(n.screens).map(([g,r])=>K(a,g,r,e,h,m=>$(n,e,m)));let d;n.sensor&&u.length>0&&(d=document.createElement("canvas"),d.width=c.w,d.height=c.h,d.dataset.akSign="the scenery's moiré",Object.assign(d.style,{position:"absolute",left:"0px",top:"0px",width:`${String(c.w)}px`,height:`${String(c.h)}px`,zIndex:"100000",mixBlendMode:"multiply",pointerEvents:"none"}),a.appendChild(d)),u.length===0&&a.remove(),t.appendChild(i);const f={props:n,ctx:e,el:t,canvas:i,px:c,screens:u,time:g=>$(n,e,g),...d?{moire:d}:{}};N.set(t,f),q(f);const p=v.get(n.name)??[];p.push(f),v.set(n.name,p);const y=g=>Promise.all(n.props.map(r=>g.props.add(r))),w=g=>{throw O(g)},E=U.get(n.scenery);if(E){f.page=E.page,f.sign=E.sign,n.props.length>0&&e.wait(y(E.page).catch(w));return}e.wait(ce(n.scenery,e,n.name).then(async({page:g,sign:r})=>{await y(g),f.page=g,f.sign=r}).catch(w))}function fe(t,n){const e=N.get(t);if(!e?.page)return;const o=e.page,s=F(e,n),c=e.px.w/e.px.h,i=o.stateFrom(re(e),s,c,e.time);o.props.show(e.props.props,s);const l=o.aim(i,c),{width:a,height:h}=e.canvas,u=o.screens.drawsElements,d=u?e.screens.filter(r=>r.spec.inScenery!==!1):[];if(!u&&!e.fellBack){const r=e.screens.filter(m=>m.spec.inScenery!==!1);r.length>0&&(e.fellBack=!0,e.ctx.report?.({code:I,level:"warn",message:`The screens ${r.map(m=>`"${m.mesh}"`).join(", ")} of the scenery layer "${e.props.name}" are drawn over the scenery, unlit and untoned, not in it: this page cannot draw an element into the scenery's canvas (Chrome's HTML-in-Canvas is missing or turned off, or the scenery draws with WebGPU). AllyHub's own Chrome, which allyhub frames, check and exports use, has it: when allyhub check does not report this, only this page's preview is affected, so change nothing. screen(…, { inScenery: false }) would take the scenery's light and a sensor's moiré out of the export too.`}))}const f=e.screens.filter(r=>!d.includes(r)).map(r=>r.mesh),p=e.screens.map(r=>o.screens.quad(r.mesh,l.resolved,[e.px.w,e.px.h])),y=Math.ceil(2/(e.canvas.height/e.px.h))+1;d.length>0&&le(e,o);const w=[];if(e.screens.forEach((r,m)=>{if(d.includes(r)){const b=r.spec.pixels?.density??C.density,S=r.spec.inScenery;o.screens.show(r.mesh,r.el,{brightness:S===!1?1:S.brightness,light:S===!1?!1:S.light,...e.moire&&e.props.sensor?{factor:e.moire}:{}}),X(r,p[m],b),w.push(ee(r,s));return}Y(r,s,p[m]),Z(r,p[m],y),V(r,Q(e,r,p[m],l.resolved))}),ne(e.screens.map((r,m)=>({el:r.el,depth:p[m]?.depth}))),e.sign&&(e.canvas.dataset.akSign=e.sign(o.scene,l.camera,[a,h],`${e.props.background===void 0?"the scenery's":e.props.background??"none"}|${f.join(",")}${l.resolved.dof?`|f/${String(l.resolved.dof.aperture)}@${String(l.resolved.dof.focus)}:${String(l.resolved.dof.lens)}`:""}${e.props.sensor?`|sensor ${JSON.stringify(e.props.sensor)} ${JSON.stringify(e.screens.map(r=>r.spec.pixels??null))}`:""}${e.screens.some(r=>r.spec.glass)?`|glass ${JSON.stringify(e.screens.map(r=>r.spec.glass??null))}`:""}${d.length>0?`|in scenery ${JSON.stringify(d.map(r=>[r.mesh,r.spec.inScenery]))}`:""}`)),e.ctx.layoutOnly===!0)return;e.moire&&e.props.sensor&&G(e,p,l.resolved,D(l.resolved,[e.ctx.dims.width,e.ctx.dims.height],e.px.h,e.props.sensor,[e.px.x,e.px.y]));const E=new Map(e.screens.flatMap(r=>r.spec.glass?[[r.mesh,r.spec.glass]]:[])),g=()=>{const r=o.drawer.inPlace(l.camera,a,h,e.props.background,f,l.resolved.dof,E.size>0?E:void 0,d.map(b=>b.mesh)),m=e.canvas.getContext("2d");if(m&&(m.clearRect(0,0,a,h),m.drawImage(r,0,0,a,h),o.lost))throw Object.assign(new Error(`The scenery's WebGL context was lost (the browser's GPU process failed): its picture at ${n.toFixed(3)} s is empty.`),{code:H.renderer})};if(d.length===0){g();return}e.ctx.wait(Promise.all(w).then(()=>o.screens.paint([a,h])).then(g).catch(r=>{throw O(r)}))}export function projectScenery(t,n,e,o){const s=v.get(t)?.find(f=>f.el.parentElement===o.parentElement&&f.ctx.layer.start<=e&&e<f.ctx.layer.end&&f.page),c=s?.page;if(!s||!c)return;const i=F(s,e),l=s.px.w/s.px.h,a=c.stateFrom(s.props.camera,i,l,s.time);c.props.show(s.props.props,i);const h=M(a,l,f=>c.pointOf(f)),u=typeof n=="string"?c.pointOf(n):n,d=R(h,u);return{x:s.px.x+(d.x+1)/2*s.px.w,y:s.px.y+(1-d.y)/2*s.px.h,inView:d.inView,depth:d.depth}}

package/dist/node_modules/@allyhub-next/scenery-host/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@allyhub-next/scenery-host",
+  "version": "0.6.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./layer": {
+      "types": "./dist/layer/index.d.ts",
+      "default": "./dist/layer/index.js"
+    },
+    "./module": {
+      "types": "./dist/module.d.ts",
+      "default": "./dist/module.js"
+    },
+    "./fidelity": {
+      "types": "./dist/fidelity.d.ts",
+      "default": "./dist/fidelity.js"
+    },
+    "./bundle": {
+      "types": "./dist/bundle.d.ts",
+      "default": "./dist/bundle.js"
+    }
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

package/dist/node_modules/@allyhub-next/sheet/dist/address.d.ts

@@ -0,0 +1,32 @@
+/** Excel's grid. */
+export declare const MAX_ROWS = 1048576;
+export declare const MAX_COLUMNS = 16384;
+/** A place, from 0. */
+export interface Place {
+    row: number;
+    col: number;
+}
+/** A rectangle, ends included, from 0. */
+export interface Area {
+    top: number;
+    left: number;
+    bottom: number;
+    right: number;
+}
+/** A column's letters: 0 is A, 26 is AA. */
+export declare function columnLetter(col: number): string;
+/** A column's index from its letters, in either case; undefined when it is not a column of the grid. */
+export declare function columnIndex(letters: string): number | undefined;
+/** A1: a place's name. */
+export declare const cellName: (p: Place) => string;
+/** A1:B2, or A1 for one cell. */
+export declare function rangeName(a: Area): string;
+/** The place an address names, `$` allowed; undefined when it is not one. */
+export declare function readAddress(text: string): Place | undefined;
+/** The area `A1:B2` or `A1` names, whichever way round; undefined when it is neither. */
+export declare function readArea(text: string): Area | undefined;
+/** Ranges apart by spaces, as Excel's `sqref`; undefined when any of them is not a range. */
+export declare function readAreas(text: string): Area[] | undefined;
+export declare const contains: (a: Area, row: number, col: number) => boolean;
+export declare const overlaps: (a: Area, b: Area) => boolean;
+//# sourceMappingURL=address.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/address.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const MAX_ROWS=1048576,MAX_COLUMNS=16384;export function columnLetter(t){let o="";for(let e=t+1;e>0;e=Math.floor((e-1)/26))o=String.fromCharCode(65+(e-1)%26)+o;return o}export function columnIndex(t){if(!/^[A-Za-z]{1,3}$/u.test(t))return;let o=0;for(const e of t.toUpperCase())o=o*26+e.charCodeAt(0)-64;return o<=16384?o-1:void 0}export const cellName=t=>`${columnLetter(t.col)}${String(t.row+1)}`;export function rangeName(t){const o=cellName({row:t.top,col:t.left});return t.top===t.bottom&&t.left===t.right?o:`${o}:${cellName({row:t.bottom,col:t.right})}`}export function readAddress(t){const o=/^\$?([A-Za-z]{1,3})\$?([1-9]\d*)$/u.exec(t.trim());if(!o)return;const e=columnIndex(o[1]??""),n=Number(o[2])-1;return e===void 0||n>=1048576?void 0:{row:n,col:e}}export function readArea(t){const[o="",e,n]=t.split(":");if(n!==void 0)return;const r=readAddress(o),i=e===void 0?r:readAddress(e);if(!(!r||!i))return{top:Math.min(r.row,i.row),left:Math.min(r.col,i.col),bottom:Math.max(r.row,i.row),right:Math.max(r.col,i.col)}}export function readAreas(t){const o=[];for(const e of t.trim().split(/\s+/u)){const n=readArea(e);if(!n)return;o.push(n)}return o}export const contains=(t,o,e)=>o>=t.top&&o<=t.bottom&&e>=t.left&&e<=t.right,overlaps=(t,o)=>t.top<=o.bottom&&o.top<=t.bottom&&t.left<=o.right&&o.left<=t.right;

package/dist/node_modules/@allyhub-next/sheet/dist/api/capabilities.d.ts

@@ -0,0 +1,23 @@
+export interface Capabilities {
+    reference: {
+        library: string;
+        version: string;
+        docs: string;
+    };
+    /** openpyxl's classes, each with the names of it the API holds. */
+    holds: Record<string, string[]>;
+    /** openpyxl's helpers the API holds. */
+    functions: string[];
+    /** Where a held name behaves differently from openpyxl's. */
+    differs: string[];
+    /** What the API adds, by class and name, and what each is. */
+    adds: Record<string, Record<string, string>>;
+    /** The worksheet functions, by where each comes from. */
+    formulas: {
+        own: string[];
+        formulajs: string[];
+    };
+}
+export declare const HELPERS: string[];
+export declare const CAPABILITIES: Capabilities;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/api/capabilities.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{publicNames as n}from"@allyhub-next/formats";import{FUNCTIONS as h}from"../calc/functions/index.js";import{AreaChart as d,BarChart as p,DataLabelList as m,DoughnutChart as c,GraphicalProperties as w,Legend as f,LineChart as u,LineProperties as y,Marker as g,NumericAxis as b,PieChart as k,Reference as _,ScatterChart as x,Scaling as C,Series as A,TextAxis as S}from"./charts.js";import{AutoFilter as v,ConditionalFormattingList as D,DataValidation as P,DataValidationList as F,DifferentialStyle as L,Rule as T}from"./rules.js";import{Alignment as R,Border as I,Color as N,Font as E,PatternFill as V,Side as B}from"./styles.js";import{Cell as W,ColumnDimension as j,DefinedName as G,DefinedNameDict as H,RowDimension as M,Table as O,TableList as U,Workbook as z,Worksheet as q}from"./workbook.js";import{Comment as X,HeaderFooter as J,HeaderFooterPart as K,Image as Q,PageMargins as Y,PageSetup as Z,SheetProtection as $}from"./page.js";const a={Series:{title:"A series' name in words, openpyxl's SeriesFactory argument, kept here as a field."},Workbook:{open:"Workbook.open(dir): a workbook's folder read (load_workbook(dir) is the same).",block_cells:"How many typed cells together go in a CSV file of their own: 100 unless set.",title:"The workbook's title, sheet.yaml's.",check:"wb.check(): what allyhub check would say of the workbook as it stands: a list of { file, line, message }."},Cell:{computed:"What the cell computes to, the workbook as it stands, saved or not."},Table:{key:"The column that lines rows up when two hands' changes merge."},DataValidation:{multiple:"A list's cell may hold several of its values, joined by separator: an .xlsx keeps them as text.",separator:"What joins a cell's choices: a comma and a space unless set."},PageSetup:{fitToWidth:"Pages wide; setting it or fitToHeight fits the sheet, with no pageSetUpPr to set."},ColumnDimension:{files:"Its cells name files, from the sheet's folder: true, or { separator, height }."}},ee=["add_data","set_categories","append","title","legend","width","height","style","anchor","series","dataLabels","x_axis","y_axis"],te={BarChart:["type","grouping","overlap","gapWidth","varyColors"],LineChart:["grouping"],AreaChart:["grouping"],PieChart:["varyColors"],DoughnutChart:["holeSize"],ScatterChart:[]},oe={Workbook:z.prototype,Worksheet:q.prototype,Cell:W.prototype,Font:E.prototype,PatternFill:V.prototype,Border:I.prototype,Side:B.prototype,Alignment:R.prototype,Color:N.prototype,Table:O.prototype,TableList:U.prototype,DefinedName:G.prototype,DefinedNameDict:H.prototype,ColumnDimension:j.prototype,RowDimension:M.prototype,ConditionalFormattingList:D.prototype,Rule:T.prototype,DifferentialStyle:L.prototype,DataValidation:P.prototype,DataValidationList:F.prototype,AutoFilter:v.prototype,BarChart:p.prototype,LineChart:u.prototype,AreaChart:d.prototype,PieChart:k.prototype,DoughnutChart:c.prototype,ScatterChart:x.prototype,Reference:_.prototype,Series:A.prototype,Legend:f.prototype,Scaling:C.prototype,TextAxis:S.prototype,NumericAxis:b.prototype,DataLabelList:m.prototype,Marker:g.prototype,GraphicalProperties:w.prototype,LineProperties:y.prototype,PageSetup:Z.prototype,PageMargins:Y.prototype,_HeaderFooterItem:J.prototype,_HeaderFooterPart:K.prototype,SheetProtection:$.prototype,Comment:X.prototype,Image:Q.prototype},r=["title","scaling","majorUnit","number_format","delete","majorGridlines"],ae={_HeaderFooterItem:["left","center","right"],Comment:["text","author"],Image:["path","width","height","anchor"],Workbook:["worksheets","defined_names","data_only","path","title","block_cells"],Cell:["row","column"],Worksheet:["min_row","min_column"],Font:["name","size","bold","italic","underline","strike","color"],PatternFill:["fill_type","fgColor","bgColor"],Border:["left","right","top","bottom"],Side:["style","color"],Alignment:["horizontal","vertical","wrap_text","shrink_to_fit","indent","text_rotation"],Color:["rgb"],Table:["displayName","ref","key","autoFilter"],DefinedName:["name","attr_text"],ColumnDimension:["index"],RowDimension:["index"],Rule:["type","operator","formula","stopIfTrue","rank","percent","bottom","aboveAverage","equalAverage","text","dxf"],DifferentialStyle:["font","fill","border"],DataValidation:["type","formula1","formula2","operator","allow_blank","showDropDown","showErrorMessage","showInputMessage","errorStyle","errorTitle","error","promptTitle","prompt","sqref"],DataValidationList:["dataValidation"],AutoFilter:["ref"],...Object.fromEntries(Object.entries(te).map(([e,t])=>[e,[...ee.filter(o=>!(/^(?:Pie|Doughnut)/u.test(e)&&o.endsWith("_axis"))),...t]])),Reference:["worksheet","min_col","min_row","max_col","max_row"],Series:["val","xVal","title","smooth","marker","graphicalProperties"],Legend:["position"],Scaling:["min","max","orientation"],TextAxis:r.filter(e=>e!=="majorUnit"),NumericAxis:r,DataLabelList:["showVal","showPercent","showCatName","showSerName","dLblPos"],Marker:["symbol","size"],GraphicalProperties:["solidFill","noFill","line"],LineProperties:["width","solidFill","noFill"]};export const HELPERS=["CellIsRule","ColorScaleRule","DataBarRule","FormulaRule","IconSetRule","column_index_from_string","coordinate_to_tuple","get_column_letter","range_boundaries"];const re=()=>{const e={};for(const[t,o]of Object.entries(oe)){const i=a[t]??{};e[t]=[...n(o),...ae[t]??[]].filter(l=>!Object.hasOwn(i,l)).sort()}return e},s=e=>[...h.values()].filter(t=>t.from===e).map(t=>t.name).sort();export const CAPABILITIES={reference:{library:"openpyxl",version:"3.1.5",docs:"https://openpyxl.readthedocs.io/"},holds:re(),functions:HELPERS,differs:["A workbook is a folder, not a file: load_workbook(dir) reads sheet.yaml and its CSV files, wb.save(dir) writes them, and only what changed is written. This API does not read or write .xlsx: allyhub sheet import and allyhub render --type xlsx do.","A keyword argument of openpyxl's is a field of an object: new Font({ bold: true }), new Table({ displayName, ref }), new DefinedName(name, { attr_text }). Classes are made with new.","A name openpyxl has that is not held throws where it is used, naming what the class holds. ws['A1'], ws['A1:B2'], ws['A'], ws[1], wb['Sheet'], ws.tables['t'], wb.defined_names['n'], ws.column_dimensions['A'] and ws.row_dimensions[1] are held; in TypeScript ws['A1'] is typed as a Cell, so write ws['A1'].value = v (ws['A1'] = v works at run time), and wb.get_sheet_by_name(name) is typed where wb[name] is not.","Rows and columns count from 1, as openpyxl's. iter_rows, rows, columns and values give arrays, not generators.","A colour is #RRGGBB; RRGGBB and AARRGGBB are taken, the alpha left out. Theme colours are not held.","cell.value of a date is a Date (read in UTC), a formula's its text, and with load_workbook(dir, { data_only: true }) what it computes to, which openpyxl reads from a file's cache and this computes.","column_dimensions' width is Excel's unit and row_dimensions' height points, as openpyxl's; the file holds pixels.","ws.merged_cells is an array of each merged range's text.","A table's rows are its CSV file, so ws.add_table(new Table({ displayName, ref })) moves the cells of ref there; its header row names its columns. A column whose every row has one formula, moved, is written as a calculated column.","A run of cells with one formula, moved, is written as one range key, and at least wb.block_cells typed cells together in a CSV file of their own (a block).","ws.title = 'New' renames the sheet in every formula, which openpyxl leaves to you.","ws.insert_rows, delete_rows, insert_cols and delete_cols rewrite every formula of the workbook as Excel does (a reference moves, a range grows or shrinks, one to what went is #REF!), move tables, blocks, merges and looks, and take rows and columns in or out of a table's CSV file. openpyxl moves cells and leaves formulas as they were. A table's header row is not deleted unless all of the table is.","A string that reads as another value (=, 12%, 2026-01-01) stays text, as openpyxl's does: its cell is written with a leading ' unless it starts with =, which makes it a formula.","A DataValidation refuses what breaks it and shows its prompt unless showErrorMessage or showInputMessage is false, as Excel's dialog starts: openpyxl's leave both off. A list's cell keeps its blank unless allow_blank is false.","ws.auto_filter.ref and add_filter_column say what a filter keeps, and the rows it leaves out are worked out from that, never written: a file made by openpyxl hides nothing until Excel reapplies it. A table has its own, table.autoFilter. add_sort_condition is not held: sorting is the rows of the files in order.","A chart reads its cells live, whatever else is in the file: there is no cache to refresh. chart.add_data and set_categories, and Series, take a Reference or a formula's text for a table's column or a spill, as add_data('orders[total]', { title: 'Total' }) or set_categories('orders[month]'), since a Reference cannot name one.","Series is made with new Series(values, { xvalues, title, title_from_data }); openpyxl's is the SeriesFactory function.","A chart's width and height are centimetres, as openpyxl's; the file holds pixels, and anchor a cell: ws.add_chart(chart, 'E2').","A LineChart's grouping is standard; a stacked area is an AreaChart. Chart styles are kept but draw nothing, as sheet.yaml has no place for them: chart.style is only read.","ws._charts lists a sheet's charts, those read from sheet.yaml among them, as the classes above.","In a rule, a fill's bgColor paints, or its fgColor where it has none. A rule's font holds bold, italic, underline, strike and a colour; alignment and number formats in a rule are not held.","workbook((wb, { data }) => { … }), the default export of an item's sheet.ts, makes sheets with these classes, on a workbook of its own that starts with none. They are made again from the code wherever the workbook is read, never saved: wb.save throws there."],adds:a,formulas:{own:s("allyhub"),formulajs:s("formulajs")}};

package/dist/node_modules/@allyhub-next/sheet/dist/api/charts.d.ts

@@ -0,0 +1,204 @@
+import { type SheetChart, type SheetChartAxis, type SheetChartType } from "@allyhub-next/formats";
+/** What a worksheet is to a reference. */
+interface HasTitle {
+    title: string;
+}
+export interface ReferenceOptions {
+    min_col?: number;
+    min_row?: number;
+    max_col?: number;
+    max_row?: number;
+    /** A range, Sheet!A1:B2 or A1:B2. */
+    range_string?: string;
+}
+/** A range of a worksheet, from 1 as openpyxl's. */
+export declare class Reference {
+    worksheet: HasTitle | undefined;
+    min_col: number;
+    min_row: number;
+    max_col: number;
+    max_row: number;
+    constructor(worksheet: HasTitle | undefined, o: ReferenceOptions);
+    /** Its text, from a sheet: short on its own. */
+    _text(own?: string): string;
+    /** Its columns, each a Reference. */
+    cols(): Reference[];
+    /** Its rows, each a Reference. */
+    rows(): Reference[];
+    pop(): Reference;
+}
+/** Where a chart's numbers are: a Reference, or a formula's text such as orders[total]. */
+export type ChartData = Reference | string;
+/** A line's look (`a:ln`). */
+export declare class LineProperties {
+    /** In EMU, 12,700 to the point, as openpyxl's. */
+    width: number | undefined;
+    solidFill: string | undefined;
+    noFill: boolean | undefined;
+    constructor();
+}
+/** A series' look (`c:spPr`). */
+export declare class GraphicalProperties {
+    solidFill: string | undefined;
+    noFill: boolean | undefined;
+    line: LineProperties;
+    constructor();
+}
+/** A line's points. */
+export declare class Marker {
+    symbol: string | undefined;
+    size: number | undefined;
+    constructor(o?: {
+        symbol?: string;
+        size?: number;
+    });
+}
+export interface SeriesOptions {
+    xvalues?: ChartData;
+    title?: string;
+    /** Its values' first cell is its name. */
+    title_from_data?: boolean;
+}
+export declare class Series {
+    val: ChartData;
+    xVal: ChartData | undefined;
+    /** Its name in words. */
+    title: string | undefined;
+    /** The cell that names it. */
+    _titleRef: ChartData | undefined;
+    smooth: boolean | undefined;
+    marker: Marker;
+    graphicalProperties: GraphicalProperties;
+    /** Its number format. */
+    _format: string | undefined;
+    constructor(values: ChartData, o?: SeriesOptions);
+}
+export declare class Legend {
+    /** r, l, t or b, as openpyxl's. */
+    position: string;
+    constructor();
+}
+export declare class Scaling {
+    min: number | undefined;
+    max: number | undefined;
+    /** minMax or maxMin. */
+    orientation: string;
+    constructor();
+}
+declare class Axis {
+    title: string | undefined;
+    scaling: Scaling;
+    majorUnit: number | undefined;
+    number_format: string | undefined;
+    delete: boolean | undefined;
+    /** null leaves its gridlines out. */
+    majorGridlines: object | null | undefined;
+    _spec(): SheetChartAxis | undefined;
+    _hold(a: SheetChartAxis | undefined): void;
+}
+export declare class TextAxis extends Axis {
+    constructor();
+}
+export declare class NumericAxis extends Axis {
+    constructor();
+}
+export declare class DataLabelList {
+    showVal: boolean | undefined;
+    showPercent: boolean | undefined;
+    showCatName: boolean | undefined;
+    showSerName: boolean | undefined;
+    /** Excel's dLblPos: outEnd, inEnd, ctr, inBase, t, b, l, r, bestFit. */
+    dLblPos: string | undefined;
+    constructor();
+}
+/** What openpyxl's chart classes share. */
+export declare abstract class ChartBase {
+    title: string | undefined;
+    /** null: no legend, as openpyxl's None. */
+    legend: Legend | null;
+    /** Centimetres, as openpyxl's. */
+    width: number;
+    height: number;
+    /** Excel's chart style; kept for openpyxl's sake, drawn by none. */
+    style: number | undefined;
+    anchor: string | undefined;
+    series: Series[];
+    dataLabels: DataLabelList | undefined;
+    x_axis: Axis;
+    y_axis: Axis;
+    /** Its categories. */
+    _labels: ChartData | undefined;
+    /** What of its entry in sheet.yaml nothing here says. */
+    _held: Partial<SheetChart>;
+    /** Its entry says no size of its own: it stays so while it keeps the one it had. */
+    _plainSize: {
+        width: number;
+        height: number;
+    } | undefined;
+    abstract _type(): SheetChartType;
+    /** Each column, or row, of a range as a series. */
+    add_data(data: ChartData, o?: {
+        titles_from_data?: boolean;
+        from_rows?: boolean;
+        title?: string;
+    }): void;
+    /** Names the categories of every series. */
+    set_categories(labels: ChartData): void;
+    append(series: Series): void;
+    /** Its entry in sheet.yaml, on a sheet. */
+    _spec(own: string): SheetChart;
+}
+export interface BarChartOptions {
+    /** col or bar. */
+    type?: "col" | "bar";
+    grouping?: "clustered" | "stacked" | "percentStacked";
+}
+export declare class BarChart extends ChartBase {
+    /** col for columns, bar for bars. */
+    type: "col" | "bar";
+    grouping: "clustered" | "stacked" | "percentStacked";
+    overlap: number | undefined;
+    gapWidth: number | undefined;
+    varyColors: boolean | undefined;
+    constructor(o?: BarChartOptions);
+    _type(): SheetChartType;
+    _spec(own: string): SheetChart;
+}
+export declare class LineChart extends ChartBase {
+    /** standard: a line chart has no other here. */
+    grouping: string;
+    constructor();
+    _type(): SheetChartType;
+}
+export declare class AreaChart extends ChartBase {
+    grouping: "standard" | "stacked" | "percentStacked";
+    constructor(o?: {
+        grouping?: AreaChart["grouping"];
+    });
+    _type(): SheetChartType;
+}
+export declare class PieChart extends ChartBase {
+    varyColors: boolean;
+    constructor();
+    _type(): SheetChartType;
+    _spec(own: string): SheetChart;
+}
+export declare class DoughnutChart extends ChartBase {
+    holeSize: number;
+    constructor();
+    _type(): SheetChartType;
+    _spec(own: string): SheetChart;
+}
+export declare class ScatterChart extends ChartBase {
+    x_axis: Axis;
+    constructor();
+    _type(): SheetChartType;
+    /** A smooth scatter's type says so of its series. */
+    _spec(own: string): SheetChart;
+}
+/** The entry sheet.yaml holds, as the class a script works with. */
+export declare function chartOfSpec(spec: SheetChart): ChartBase;
+/** A place a chart goes: a cell, as add_chart takes it. */
+export declare function anchorOf(anchor: string | undefined): string | undefined;
+export {};
+//# sourceMappingURL=charts.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/api/charts.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{strict as a}from"@allyhub-next/formats";import{cellName as S,rangeName as P,readAddress as L,readArea as N}from"../address.js";import{SHEET_CHART_DEFAULTS as w}from"../chart.js";import{sheetPrefix as z}from"../formula/print.js";import{HINT as o}from"./hint.js";import{colorText as E}from"./styles.js";const x=96/2.54,y=r=>Math.round(r*x),b=r=>Number((r/x).toFixed(3));function u(r,e,t){for(const s of Object.keys(e))if(!t.includes(s))throw new TypeError(`${r} takes ${t.join(", ")}; it has no ${s}. ${o}`)}export class Reference{worksheet;min_col;min_row;max_col;max_row;constructor(e,t){u("Reference",t,["min_col","min_row","max_col","max_row","range_string"]),this.worksheet=e;let s;if(t.range_string!==void 0){const c=t.range_string.lastIndexOf("!");if(s=N(t.range_string.slice(c+1).replaceAll("$","")),!s)throw new TypeError(`${t.range_string} is not a range. ${o}`)}return this.min_col=s?s.left+1:t.min_col??1,this.min_row=s?s.top+1:t.min_row??1,this.max_col=s?s.right+1:t.max_col??this.min_col,this.max_row=s?s.bottom+1:t.max_row??this.min_row,a(this,"Reference",o)}_text(e){const t={top:this.min_row-1,left:this.min_col-1,bottom:this.max_row-1,right:this.max_col-1},s=this.worksheet?.title;return`${s===void 0||s===e?"":z(s)}${P(t)}`}cols(){return Array.from({length:this.max_col-this.min_col+1},(e,t)=>new Reference(this.worksheet,{min_col:this.min_col+t,max_col:this.min_col+t,min_row:this.min_row,max_row:this.max_row}))}rows(){return Array.from({length:this.max_row-this.min_row+1},(e,t)=>new Reference(this.worksheet,{min_col:this.min_col,max_col:this.max_col,min_row:this.min_row+t,max_row:this.min_row+t}))}pop(){const e=new Reference(this.worksheet,{min_col:this.min_col,max_col:this.min_col,min_row:this.min_row,max_row:this.min_row});return this.min_row<this.max_row?this.min_row+=1:this.min_col+=1,e}}const g=(r,e)=>r===void 0?void 0:typeof r=="string"?r:r._text(e);export class LineProperties{width;solidFill;noFill;constructor(){return a(this,"LineProperties",o)}}export class GraphicalProperties{solidFill;noFill;line=new LineProperties;constructor(){return a(this,"GraphicalProperties",o)}}export class Marker{symbol;size;constructor(e={}){return u("Marker",e,["symbol","size"]),this.symbol=e.symbol,this.size=e.size,a(this,"Marker",o)}}export class Series{val;xVal;title;_titleRef;smooth;marker=new Marker;graphicalProperties=new GraphicalProperties;_format;constructor(e,t={}){if(u("Series",t,["xvalues","title","title_from_data"]),this.val=e,this.xVal=t.xvalues,this.title=t.title,t.title_from_data===!0){if(!(e instanceof Reference))throw new TypeError("title_from_data takes a Reference: a table's column names itself.");this._titleRef=e.pop()}return a(this,"Series",o)}}export class Legend{position="r";constructor(){return a(this,"Legend",o)}}export class Scaling{min;max;orientation="minMax";constructor(){return a(this,"Scaling",o)}}class k{title;scaling=new Scaling;majorUnit;number_format;delete;majorGridlines;_spec(){const e=this.scaling,t={...this.title===void 0?{}:{title:this.title},...e.min===void 0?{}:{min:e.min},...e.max===void 0?{}:{max:e.max},...this.majorUnit===void 0?{}:{major:this.majorUnit},...this.majorGridlines===null?{gridlines:!1}:{},...this.delete===!0?{visible:!1}:{},...this.number_format===void 0?{}:{format:this.number_format},...e.orientation==="maxMin"?{reverse:!0}:{}};return Object.keys(t).length===0?void 0:t}_hold(e){e&&(this.title=e.title,this.scaling.min=e.min,this.scaling.max=e.max,this.majorUnit=e.major,this.number_format=e.format,e.visible===!1&&(this.delete=!0),e.gridlines===!1&&(this.majorGridlines=null),e.reverse===!0&&(this.scaling.orientation="maxMin"))}}export class TextAxis extends k{constructor(){return super(),a(this,"TextAxis",o)}}export class NumericAxis extends k{constructor(){return super(),a(this,"NumericAxis",o)}}export class DataLabelList{showVal;showPercent;showCatName;showSerName;dLblPos;constructor(){return a(this,"DataLabelList",o)}}const A={r:"right",l:"left",t:"top",b:"bottom"},$={right:"r",left:"l",top:"t",bottom:"b"};export class ChartBase{title;legend=new Legend;width=15;height=7.5;style;anchor;series=[];dataLabels;x_axis=new TextAxis;y_axis=new NumericAxis;_labels;_held={};_plainSize;add_data(e,t={}){if(u("add_data",t,["titles_from_data","from_rows","title"]),typeof e=="string"){this.series.push(new Series(e,t.title===void 0?{}:{title:t.title}));return}for(const s of t.from_rows===!0?e.rows():e.cols())this.series.push(new Series(s,{title_from_data:t.titles_from_data===!0}))}set_categories(e){this._labels=e}append(e){this.series.push(e)}_spec(e){const t=this.dataLabels,s={category:this.x_axis._spec(),value:this.y_axis._spec()},c=this.series.map(l=>{const d=l.graphicalProperties,_=d.solidFill??d.line.solidFill,h=g(l._titleRef,e),f=g(l.xVal,e);return{values:g(l.val,e)??"",...f===void 0?{}:{x:f},...h!==void 0?{name:`=${h}`}:l.title===void 0?{}:{name:l.title},..._===void 0?{}:{color:E(_)},...l._format===void 0?{}:{format:l._format},...l.smooth===void 0?{}:{smooth:l.smooth},...d.line.width===void 0?{}:{line_width:d.line.width/12700},...l.marker.size===void 0?{}:{marker_size:l.marker.size}}}),m=g(this._labels,e),p=this.legend?A[this.legend.position]:void 0;return{...this._held,type:this._type(),at:this.anchor??"E15",...this.width===this._plainSize?.width?{}:{width:y(this.width)},...this.height===this._plainSize?.height?{}:{height:y(this.height)},...this.title===void 0?{}:{title:this.title},...m===void 0?{}:{categories:m},series:c,...p===void 0?{}:{legend:p},...t?{labels:{...t.showVal===void 0?{}:{value:t.showVal},...t.showPercent===void 0?{}:{percentage:t.showPercent},...t.showCatName===void 0?{}:{category:t.showCatName},...t.showSerName===void 0?{}:{series:t.showSerName},...t.dLblPos===void 0?{}:{position:t.dLblPos}}}:{},...s.value?{value_axis:s.value}:{},...s.category?{category_axis:s.category}:{}}}}export class BarChart extends ChartBase{type="col";grouping="clustered";overlap;gapWidth;varyColors;constructor(e={}){return super(),u("BarChart",e,["type","grouping"]),e.type&&(this.type=e.type),e.grouping&&(this.grouping=e.grouping),a(this,"BarChart",o)}_type(){const e=this.type==="bar"?"bar":"column";return this.grouping==="stacked"?`${e}-stacked`:this.grouping==="percentStacked"?`${e}-stacked-100`:`${e}-clustered`}_spec(e){return{...super._spec(e),...this.overlap===void 0?{}:{overlap:this.overlap},...this.gapWidth===void 0?{}:{gap_width:this.gapWidth},...this.varyColors===void 0?{}:{vary_by_categories:this.varyColors}}}}export class LineChart extends ChartBase{grouping="standard";constructor(){return super(),a(this,"LineChart",o)}_type(){if(this.grouping!=="standard")throw new TypeError(`A line chart here is standard, not ${this.grouping}: an AreaChart stacks. ${o}`);return this.series.some(e=>e.marker.symbol!==void 0&&e.marker.symbol!=="none")?"line-markers":"line"}}export class AreaChart extends ChartBase{grouping="standard";constructor(e={}){return super(),u("AreaChart",e,["grouping"]),e.grouping&&(this.grouping=e.grouping),a(this,"AreaChart",o)}_type(){return this.grouping==="stacked"?"area-stacked":this.grouping==="percentStacked"?"area-stacked-100":"area"}}export class PieChart extends ChartBase{varyColors=!0;constructor(){return super(),a(this,"PieChart",o)}_type(){return"pie"}_spec(e){return{...super._spec(e),...this.varyColors?{}:{vary_by_categories:!1}}}}export class DoughnutChart extends ChartBase{holeSize=50;constructor(){return super(),a(this,"DoughnutChart",o)}_type(){return"doughnut"}_spec(e){return{...super._spec(e),...this.holeSize===50?{}:{hole_size:this.holeSize}}}}export class ScatterChart extends ChartBase{x_axis=new NumericAxis;constructor(){return super(),a(this,"ScatterChart",o)}_type(){return this.series.some(e=>e.smooth===!0)?"scatter-smooth":this.series.every(e=>e.graphicalProperties.line.noFill===!0)?"scatter":"scatter-lines"}_spec(e){const t=super._spec(e);return t.type==="scatter-smooth"?{...t,series:t.series.map(s=>Object.fromEntries(Object.entries(s).filter(([c])=>c!=="smooth")))}:t}}const j=new Set(["type","at","width","height","title","categories","series","legend","labels","value_axis","category_axis","overlap","gap_width","vary_by_categories","hole_size"]);export function chartOfSpec(r){const t=(()=>{const i=r.type;if(i.startsWith("column")||i.startsWith("bar")){const n=new BarChart({type:i.startsWith("bar")?"bar":"col",grouping:i.endsWith("-100")?"percentStacked":i.endsWith("-stacked")?"stacked":"clustered"});return n.overlap=r.overlap,n.gapWidth=r.gap_width,n.varyColors=r.vary_by_categories,n}if(i==="line"||i==="line-markers")return new LineChart;if(i.startsWith("area"))return new AreaChart({grouping:i.endsWith("-100")?"percentStacked":i.endsWith("-stacked")?"stacked":"standard"});if(i==="pie"){const n=new PieChart;return r.vary_by_categories===!1&&(n.varyColors=!1),n}if(i==="doughnut"){const n=new DoughnutChart;return r.hole_size!==void 0&&(n.holeSize=r.hole_size),n}return new ScatterChart})(),{at:s,width:c,height:m,title:p,categories:l,series:d,legend:_,labels:h,value_axis:f,category_axis:v}=r,C=Object.fromEntries(Object.entries(r).filter(([i])=>!j.has(i)));if(t._held=C,t.anchor=s,t.width=b(c??w.width),t.height=b(m??w.height),t._plainSize={width:c===void 0?t.width:Number.NaN,height:m===void 0?t.height:Number.NaN},t.title=p,t._labels=l,_===void 0)t.legend=null;else{const i=new Legend;i.position=$[_],t.legend=i}if(h!==void 0&&h!==!1){const i=new DataLabelList;h===!0?i.showVal=!0:(i.showVal=h.value,i.showPercent=h.percentage,i.showCatName=h.category,i.showSerName=h.series,i.dLblPos=h.position),t.dataLabels=i}return t.x_axis._hold(v),t.y_axis._hold(f),t.series=d.map(i=>{const n=new Series(i.values,{...i.x===void 0?{}:{xvalues:i.x}});return i.name?.startsWith("=")===!0?n._titleRef=i.name.slice(1):n.title=i.name,i.color!==void 0&&(n.graphicalProperties.solidFill=i.color),i.line_width!==void 0&&(n.graphicalProperties.line.width=i.line_width*12700),n.smooth=r.type==="scatter-smooth"?!0:i.smooth,n.marker.size=i.marker_size,n._format=i.format,(r.type==="line-markers"||r.type==="scatter")&&(n.marker.symbol="circle"),r.type==="scatter"&&(n.graphicalProperties.line.noFill=!0),n}),t}export function anchorOf(r){if(r===void 0)return;const e=L(r);if(!e)throw new TypeError(`${r} is not a cell. ${o}`);return S(e)}

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

@@ -0,0 +1,19 @@
+import { Workbook } from "./workbook.js";
+import type { GeneratedSheets } from "../generated.js";
+/** Marks what workbook() makes. */
+export declare const WORKBOOK_BRAND = "__allyhubWorkbook";
+export interface SheetCodeContext {
+    /** A project file, from the sheet's folder: CSV as a row object each, YAML and JSON as they are. */
+    data: (path: string) => unknown;
+}
+export type SheetCodeBuild = (wb: Workbook, ctx: SheetCodeContext) => unknown;
+/** The default export of an item's sheet.ts. */
+export interface SheetCode {
+    readonly [WORKBOOK_BRAND]: true;
+    /** Runs it. Here, in the module its classes are from, whoever calls. */
+    readonly generate: (ctx: SheetCodeContext) => GeneratedSheets;
+}
+export declare function isSheetCode(v: unknown): v is SheetCode;
+/** What an item's sheet.ts exports: export default workbook((wb, { data }) => { … }). */
+export declare function workbook(build: SheetCodeBuild): SheetCode;
+//# sourceMappingURL=code.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/api/code.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{Workbook as n}from"./workbook.js";export const WORKBOOK_BRAND="__allyhubWorkbook";export function isSheetCode(o){return typeof o=="object"&&o!==null&&WORKBOOK_BRAND in o}export function workbook(o){if(typeof o!="function")throw new TypeError("An item's sheet.ts exports one function: export default workbook((wb, { data }) => { … }).");return{[WORKBOOK_BRAND]:!0,generate:e=>{const t=new n;if(t.worksheets=[],t._making=!0,o(t,e)instanceof Promise)throw new TypeError("sheet.ts's function waits for nothing: it is not async, as it has no network and reads with data().");return t._generated()}}}

package/dist/node_modules/@allyhub-next/sheet/dist/api/hint.d.ts

@@ -0,0 +1,3 @@
+/** Where an API error sends the reader. */
+export declare const HINT = "allyhub sheet capabilities lists what of openpyxl the API holds and where it differs.";
+//# sourceMappingURL=hint.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/api/hint.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const HINT="allyhub sheet capabilities lists what of openpyxl the API holds and where it differs.";

package/dist/node_modules/@allyhub-next/sheet/dist/api/index.d.ts

@@ -0,0 +1,8 @@
+export { Alignment, Border, Color, Font, PatternFill, Side, type AlignmentOptions, type BorderOptions, type FontOptions, type PatternFillOptions, type SideOptions, } from "./styles.js";
+export { BLOCK_CELLS, Cell, ColumnDimension, DefinedName, DefinedNameDict, RowDimension, Table, TableList, Workbook, Worksheet, column_index_from_string, coordinate_to_tuple, get_column_letter, load_workbook, range_boundaries, type CellValue, type LoadOptions, type TableInput, type TableOptions, } from "./workbook.js";
+export { AutoFilter, CellIsRule, ColorScaleRule, ConditionalFormattingList, DataBarRule, DataValidation, DataValidationList, DifferentialStyle, FormulaRule, IconSetRule, Rule, type CellIsRuleOptions, type ColorScaleRuleOptions, type DataBarRuleOptions, type DataValidationOptions, type DifferentialStyleOptions, type FormulaRuleOptions, type RuleOptions, } from "./rules.js";
+export { AreaChart, BarChart, ChartBase, DataLabelList, DoughnutChart, GraphicalProperties, Legend, LineChart, LineProperties, Marker, NumericAxis, PieChart, Reference, ScatterChart, Scaling, Series, TextAxis, type BarChartOptions, type ChartData, type ReferenceOptions, type SeriesOptions, } from "./charts.js";
+export { CAPABILITIES, HELPERS, type Capabilities } from "./capabilities.js";
+export { WORKBOOK_BRAND, isSheetCode, workbook, type SheetCode, type SheetCodeBuild, type SheetCodeContext, } from "./code.js";
+export { Comment, HeaderFooter, Image, PageMargins, PageSetup, SheetProtection, } from "./page.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/api/index.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export{Alignment,Border,Color,Font,PatternFill,Side}from"./styles.js";export{BLOCK_CELLS,Cell,ColumnDimension,DefinedName,DefinedNameDict,RowDimension,Table,TableList,Workbook,Worksheet,column_index_from_string,coordinate_to_tuple,get_column_letter,load_workbook,range_boundaries}from"./workbook.js";export{AutoFilter,CellIsRule,ColorScaleRule,ConditionalFormattingList,DataBarRule,DataValidation,DataValidationList,DifferentialStyle,FormulaRule,IconSetRule,Rule}from"./rules.js";export{AreaChart,BarChart,ChartBase,DataLabelList,DoughnutChart,GraphicalProperties,Legend,LineChart,LineProperties,Marker,NumericAxis,PieChart,Reference,ScatterChart,Scaling,Series,TextAxis}from"./charts.js";export{CAPABILITIES,HELPERS}from"./capabilities.js";export{WORKBOOK_BRAND,isSheetCode,workbook}from"./code.js";export{Comment,HeaderFooter,Image,PageMargins,PageSetup,SheetProtection}from"./page.js";