allyhub 0.7.0 → 0.8.0

package/dist/node_modules/@allyhub/runtimes/pins/pdfjs-dist/package-lock.json

@@ -0,0 +1,275 @@
+{
+  "name": "allyhub-pin-pdfjs-dist",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "allyhub-pin-pdfjs-dist",
+      "dependencies": {
+        "pdfjs-dist": "6.4.299"
+      }
+    },
+    "node_modules/@napi-rs/canvas": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas/-/canvas-1.1.0.tgz",
+      "integrity": "sha512-k+ph/D8H9GS8ZZ48okvHrKeJynkqAA1kMUZRuzRWNlQUDHXngq7oRaWMZBdmSfd9ZhVy9bwNKei/7wMboI/uMg==",
+      "license": "MIT",
+      "optional": true,
+      "workspaces": [
+        "e2e/*"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      },
+      "optionalDependencies": {
+        "@napi-rs/canvas-android-arm64": "1.1.0",
+        "@napi-rs/canvas-darwin-arm64": "1.1.0",
+        "@napi-rs/canvas-darwin-x64": "1.1.0",
+        "@napi-rs/canvas-linux-arm-gnueabihf": "1.1.0",
+        "@napi-rs/canvas-linux-arm64-gnu": "1.1.0",
+        "@napi-rs/canvas-linux-arm64-musl": "1.1.0",
+        "@napi-rs/canvas-linux-riscv64-gnu": "1.1.0",
+        "@napi-rs/canvas-linux-x64-gnu": "1.1.0",
+        "@napi-rs/canvas-linux-x64-musl": "1.1.0",
+        "@napi-rs/canvas-win32-arm64-msvc": "1.1.0",
+        "@napi-rs/canvas-win32-x64-msvc": "1.1.0"
+      }
+    },
+    "node_modules/@napi-rs/canvas-android-arm64": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-android-arm64/-/canvas-android-arm64-1.1.0.tgz",
+      "integrity": "sha512-mKrSmRyhWK4q699Q1xthbZIZi7JBvLtsRNnOZAeFaLPOFT1yo8y82aRC2nNZbXTGJXU7fVDONgGQPr0vo3kerw==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/@napi-rs/canvas-darwin-arm64": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-darwin-arm64/-/canvas-darwin-arm64-1.1.0.tgz",
+      "integrity": "sha512-iqwST4g0oH+x8VCpBIYh+MYokv/mVvkM+v9oJGB0d9A3P2qBh42ogJlVyWq9SpPCrAjS7tplMb1D3OIfxl+utw==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/@napi-rs/canvas-darwin-x64": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-darwin-x64/-/canvas-darwin-x64-1.1.0.tgz",
+      "integrity": "sha512-jkeA8eVTxDum03LTvc32YJ28F6KB1U0gYwnWMfOAUQZvWWEh/kvONby4iWGJx3+Tw45UqMGMXjtw2GKNVZDhVg==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/@napi-rs/canvas-linux-arm-gnueabihf": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-linux-arm-gnueabihf/-/canvas-linux-arm-gnueabihf-1.1.0.tgz",
+      "integrity": "sha512-Y4YkKG1ijoqkgUdTEEBNG4k+2BK5bR5jGL6S56YxCXYPwGfUd5nED8/74xyc7z+bpixPasCjSYoP3xYPOIGNxw==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/@napi-rs/canvas-linux-arm64-gnu": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-linux-arm64-gnu/-/canvas-linux-arm64-gnu-1.1.0.tgz",
+      "integrity": "sha512-dE/XthqYkiWcBVtKFlZbUXwAYfDuQGqDWixznipJNmevLGpprNnTVQZyftm1RZJudkIOn2EkzYZDMMETM08Row==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/@napi-rs/canvas-linux-arm64-musl": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-linux-arm64-musl/-/canvas-linux-arm64-musl-1.1.0.tgz",
+      "integrity": "sha512-DqZ/CMcHlhU56pPjv9AP0h3U7MFQ5LzC1HzMyRMotL+PFsJmZJA/ziApPYVyyz78DaVLhI8t3So3ztqtijbYpg==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/@napi-rs/canvas-linux-riscv64-gnu": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-linux-riscv64-gnu/-/canvas-linux-riscv64-gnu-1.1.0.tgz",
+      "integrity": "sha512-kJ7m5n2VffxWXM5QGa5lfq8ZN4LdOJEoz3aAJAmIqYvKiZw1gRdXqpucnRXsF6D9nLYiiIlevaAtAclR7c5ilg==",
+      "cpu": [
+        "riscv64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/@napi-rs/canvas-linux-x64-gnu": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-linux-x64-gnu/-/canvas-linux-x64-gnu-1.1.0.tgz",
+      "integrity": "sha512-uQ9JuJlRhQdHyttcMWOiwLkfIqkqaB0YFUVe835LUe12THt2b51HXkTItq0fxWT1jdhUPX2ylWZ1walkJyD6GQ==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/@napi-rs/canvas-linux-x64-musl": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-linux-x64-musl/-/canvas-linux-x64-musl-1.1.0.tgz",
+      "integrity": "sha512-has4CPPAkkCac/LZ13VAw5p+MJLdaKVoyrhumN/A7uJd6960xYkJNDZgUebyxiha82AFzXx6RV+QJg5qGG079g==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/@napi-rs/canvas-win32-arm64-msvc": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-win32-arm64-msvc/-/canvas-win32-arm64-msvc-1.1.0.tgz",
+      "integrity": "sha512-MJnktLKNijmXqdjTughHDZ9TDLZ9uUm2hvFXqaOqn0+w7lphXFnft6bpSgQAc9U1exc20UGIBlzGu9+kiCj9Ag==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/@napi-rs/canvas-win32-x64-msvc": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-win32-x64-msvc/-/canvas-win32-x64-msvc-1.1.0.tgz",
+      "integrity": "sha512-08575bFk7iiadxap4h+JxgGut9xDCHAGum6wh0eInN53zEMImkmEHi5MushX2FOmNO7qRNX7BPiDC5ZYBwHeEg==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/pdfjs-dist": {
+      "version": "6.4.299",
+      "resolved": "https://registry.npmjs.org/pdfjs-dist/-/pdfjs-dist-6.4.299.tgz",
+      "integrity": "sha512-AVl138zALtfaAPvADulE0PZThbYzCBS79nL4pOSL/6Sm/4AH5A21BD9VHt97OlCuzJuCpmeZtAtkinisF4Vb1g==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=22.13.0 || >=24"
+      },
+      "optionalDependencies": {
+        "@napi-rs/canvas": "^1.0.10"
+      }
+    }
+  }
+}

package/dist/node_modules/@allyhub/runtimes/pins/pdfjs-dist/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "allyhub-pin-pdfjs-dist",
+  "private": true,
+  "dependencies": {
+    "pdfjs-dist": "6.4.299"
+  },
+  "allyhubSize": 35000000,
+  "allyhubOmit": [
+    "optional"
+  ]
+}

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

@@ -0,0 +1,16 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{mkdir as c,readFile as y,writeFile as d}from"node:fs/promises";import{basename as f,join as a,resolve as h}from"node:path";export const PROJECT_PACKAGES={cli:"allyhub",sdk:"@allyhub/sdk"},PROJECT_TYPESCRIPT="~5.9.3",PROJECT_GITIGNORE=`node_modules/
+.allyhub/
+.playwright-cli/
+`,SDK_DOCS=[["project.md","folders, items and entry files, imports, scripts and shared text, allyhub.config.ts, fonts"],["contract.md","a frame drawn from its time alone, drawn offline, problems and their rules"],["video.md","video(), formats, part(), layers and stacking, transitions, the look, capture, post"],["layers.md","defineComponent(), custom(), the layer's ctx, DOM, animation, path, noise and input helpers, starter components"],["speech.md","take(), say(), word references, anchors, shown and said, captions, edits files"],["sound.md","music, sound effects, the mix, the master, mic"],["footage.md","footage(): placing, cropping, reframing, faces and mattes, a video item inside another"],["slides.md","presentation(), layouts, slides.yaml's pages and what is placed on them, steps, speaker notes"],["batches.md","the matrix: dimensions, slots, pools, rules, combos"],["scenery.md","3D sceneries: defineScenery(), cameras and moves, the scenery() layer, screens"],["modeling.md","props modelled in code with @allyhub/model"],["docs.md","a doc (doc.mdx): its title, the Markdown and tags it reads, pictures and links, comments"],["sheets.md","a sheet (sheet.yaml and CSV): Excel's model as text, the openpyxl API, formulas, tables, names, checks, sheet.ts, scenarios, calc, trace, render"],["websites.md","a website, any web project with website.json: how Studio serves it ($PORT, $HOST, the preview hosts), videos in its pages, its build"],["defaults.md","every default of the piece API and the option that changes it"]],REGISTRY="https://allyhub.com/r",MASTER_SKILL="allyhub";export function workSkills(t){return t.filter(e=>e.type==="allyhub:skill"&&e.name!==MASTER_SKILL).map(e=>({name:e.name,description:e.description.replaceAll(/\s+/gu," ").trim()}))}export const AGENT_RULES_BEGIN="<!-- BEGIN:allyhub-agent-rules -->",AGENT_RULES_END="<!-- END:allyhub-agent-rules -->";export function agentRules(){return[AGENT_RULES_BEGIN,"",`Before writing or changing a video, a deck, a doc, a sheet, a 3D scenery or a 3D model, read the files it needs in the SDK's docs, for the version this project builds with: \`node_modules/${PROJECT_PACKAGES.sdk}/docs/\` once the project has installed it; without it, \`allyhub help\` says where they are (the SDK the CLI lends). The API has changed from what you may know; the docs and the SDK's types are right.`,"",...SDK_DOCS.map(([t,e])=>`- ${t}: ${e}`),"","`allyhub help` lists AllyHub's commands (`npx allyhub help` once the project has installed it); `allyhub help <command>` says what one does.","","`allyhub skills` lists AllyHub's work skills, each how to make one kind of work; `allyhub skills show <name>` prints one, `allyhub add skill/<name>` adds it to this project.","",AGENT_RULES_END].join(`
+`)}export function projectAgents(){return`# AllyHub project
+
+This folder is an AllyHub project. Videos, 3D sceneries and 3D models are TypeScript, docs MDX, sheets YAML and CSV, and a website any web project: each is a folder with its entry file (\`video.ts\`, \`scenery.ts\`, \`model.ts\`, \`doc.mdx\`, \`sheet.yaml\`, a website's \`website.json\`), wherever it suits the project; a model is made once and put in any scenery that imports it.
+
+- A video or a scenery is code: where the project has no package.json yet, \`npm create allyhub@latest .\` then \`npm install\`.
+
+${agentRules()}
+`}export const PROJECT_CLAUDE=`@AGENTS.md
+`,PROJECT_TSCONFIG=`${JSON.stringify({compilerOptions:{target:"ES2022",module:"ESNext",moduleResolution:"Bundler",lib:["ES2022","DOM","DOM.Iterable"],types:[`${PROJECT_PACKAGES.sdk}/client`,`${PROJECT_PACKAGES.cli}/client`],strict:!0,noEmit:!0,skipLibCheck:!0,verbatimModuleSyntax:!0,allowImportingTsExtensions:!0},include:["**/*.ts",".allyhub/cache/types"],exclude:["node_modules"]},null,2)}
+`;export function packageName(t){const e=t.toLowerCase().normalize("NFKD").replace(/\p{M}/gu,"").replace(/[^\w.-]+/gu,"-").replace(/^[-._]+|[-._]+$/gu,"").slice(0,214);return e===""?"allyhub-project":e}const l=t=>y(t).then(()=>!0,()=>!1);export async function writeAgentFiles(t){const e=h(t);await c(e,{recursive:!0});const s=[];for(const[n,i]of[["AGENTS.md",projectAgents()],["CLAUDE.md",PROJECT_CLAUDE]])await l(a(e,n))||(await d(a(e,n),i,{flag:"wx"}),s.push(n));return s}export async function startProject(t,e){const s=h(t);if(await l(a(s,"package.json")))throw new Error(`${s} already has a package.json: add AllyHub to it with npm install ${PROJECT_PACKAGES.cli} ${PROJECT_PACKAGES.sdk}.`);const n=packageName(f(s)),i=o=>e.packages?.[o]??e.version,p={name:n,version:"0.0.0",private:!0,type:"module",scripts:{dev:"allyhub dev",check:"allyhub check",render:"allyhub render",typecheck:"tsc --noEmit"},dependencies:{[PROJECT_PACKAGES.cli]:i(PROJECT_PACKAGES.cli),[PROJECT_PACKAGES.sdk]:i(PROJECT_PACKAGES.sdk)},devDependencies:{typescript:PROJECT_TYPESCRIPT}},m=[["package.json",`${JSON.stringify(p,null,2)}
+`],["tsconfig.json",PROJECT_TSCONFIG],[".gitignore",PROJECT_GITIGNORE]];await c(s,{recursive:!0});const r=[];for(const[o,u]of m)await l(a(s,o))||(await d(a(s,o),u,{flag:"wx"}),r.push(o));return r.push(...await writeAgentFiles(s)),{folder:s,name:n,files:r}}

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

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

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

@@ -0,0 +1,21 @@
+import { BAKE_DIR } from "@allyhub/formats";
+import type { RuleCode } from "@allyhub/video-core";
+import type { SceneryFailure, SceneryProblem } from "./errors.js";
+/** The rule each failure and problem of a scenery page is said under. */
+export declare const SCENERY_RULES: {
+    readonly build: "AK-W001";
+    readonly renderer: "AK-W002";
+    readonly file: "AK-W003";
+    readonly camera: "AK-W004";
+    readonly name: "AK-W005";
+    readonly shader: "AK-W006";
+    readonly screen: "AK-W008";
+};
+/** A screen asked to be drawn in the scenery and drawn over it (the scenery() layer says it). */
+export declare const DRAWN_OVER_RULE = "AK-W007";
+/** The rule a failure or a problem's kind is said under. */
+export declare const ruleOf: (kind: SceneryFailure | SceneryProblem["kind"]) => RuleCode;
+export { BAKE_DIR };
+/** A scenery bake's file, by its scene's digest and its renderer (`cpu`, or `gpu-` and a hash of the GPU's name). */
+export declare const bakeFile: (digest: string, renderer: string) => string;
+//# sourceMappingURL=allyhub.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{BAKE_DIR as r}from"@allyhub/formats";export const SCENERY_RULES={build:"AK-W001",renderer:"AK-W002",file:"AK-W003",camera:"AK-W004",name:"AK-W005",shader:"AK-W006",screen:"AK-W008"},DRAWN_OVER_RULE="AK-W007",ruleOf=e=>SCENERY_RULES[e];export{r as BAKE_DIR};export const bakeFile=(e,o)=>`${r}/${e}.${o}.bin`;

package/dist/node_modules/@allyhub/scenery-host/dist/bake/apply.d.ts

@@ -0,0 +1,59 @@
+import { BufferGeometry, DataTexture, Mesh, MeshStandardMaterial, type Material, type Scene, type Texture, type WebGLRenderer } from "three";
+import type { ResolvedBake } from "@allyhub/scenery";
+import { type BakeFile } from "./format.js";
+/** What a laid bake did, for the page's info. */
+export interface LaidBake {
+    digest: string;
+    /** The renderer the bake was made on (bakeRenderer), and its name as WebGL gives it. */
+    renderer: string;
+    gl: string;
+    size: number;
+    meshes: number;
+    probe: boolean;
+}
+/** The scene's meshes in traversal order: a bake names its meshes by their place here. */
+export declare function meshesOf(scene: Scene): Mesh[];
+/**
+ * A material that takes its light from the lightmap: the lights' direct
+ * light, the ambient and hemisphere lights and (when the bake holds it)
+ * the environment's diffuse light are left out, since the lightmap holds
+ * them, occluded and bounced. The lightmap goes where three puts an
+ * environment's irradiance (iblIrradiance), not with the lights'
+ * (irradiance): there it lights the diffuse layer less what the specular
+ * lobe reflects, and gives a rough metal the light its lobe scatters more
+ * than once, which irradiance alone never reaches. The environment's
+ * reflections stay.
+ */
+export declare function bakedMaterial(base: MeshStandardMaterial, lightMap: Texture, environmentBaked: boolean): MeshStandardMaterial;
+/** A geometry's attributes copied onto the unwrap's vertices, with uv1 and its triangles. */
+export declare function unwrapped(g: BufferGeometry, original: ArrayLike<number>, index: ArrayLike<number>, uv1: ArrayLike<number>, uvScale: number): BufferGeometry;
+/** The name a bake's lightmap texture has. */
+export declare const BAKE_LIGHTMAP = "allyhub-bake";
+/** The name of a probe's picture with the rectangle lights drawn in as panes. */
+export declare const BAKE_PROBE = "allyhub-bake-probe";
+/** Whether a material is one a bake made (bakedMaterial): its light is its lightmap's. */
+export declare function isBaked(material: Material): boolean;
+/**
+ * Whether a material reflects the scene's rectangle lights once: three's
+ * own highlight of each (what is not baked), or a probe's pane of each in
+ * its environment (a baked material laid with a probe). A baked material
+ * without that probe reflects none of them: its bake takes the lights'
+ * highlights away and its environment never saw a pane.
+ */
+export declare function reflectsAreaLights(material: Material): boolean;
+/** The lightmap's RGB half floats as a texture (alpha 1). */
+export declare function lightMapTexture(rgb: Uint16Array, size: number): DataTexture;
+/** A probe's two pictures of the lit scene, each prefiltered for an environment. */
+export interface Probe {
+    /** With each rectangle light drawn in as a pane of its radiance (named BAKE_PROBE). */
+    panes: Texture;
+    /** Without them: the same texture as `panes` when the scene has none. */
+    room: Texture;
+}
+/** The lit scene seen all round from a point: with its rectangle lights as panes, and without. */
+export declare function renderProbe(scene: Scene, renderer: WebGLRenderer, probe: NonNullable<ResolvedBake["probe"]>): Probe;
+/** Lays a bake file's light on the scene. Throws when it does not fit it. */
+export declare function layBake(scene: Scene, renderer: WebGLRenderer, file: BakeFile): Promise<LaidBake>;
+/** Fetches a bake file and lays it on the scene. */
+export declare function fetchAndLay(url: string, scene: Scene, renderer: WebGLRenderer, digest: string, bakedOn: string, version: number): Promise<LaidBake>;
+//# sourceMappingURL=apply.d.ts.map

package/dist/node_modules/@allyhub/scenery-host/dist/bake/digest.d.ts

@@ -0,0 +1,14 @@
+import { type Scene } from "three";
+import type { ResolvedBake } from "@allyhub/scenery";
+/** Changes when what a bake holds or how it is made changes: older bakes are then not laid on. */
+export declare const BAKE_VERSION = 2;
+/**
+ * What a picture's URL says about its file, the same in every page and
+ * run: its project path when the page knows it, the path of its URL
+ * without the server's origin, nothing for a blob (made afresh each time,
+ * such as a model's own pictures), and a data URL whole.
+ */
+export declare function stableSource(url: string, known?: (url: string) => string | undefined): string;
+/** The digest of a scene as built and posed, with a bake's settings. */
+export declare function sceneDigest(scene: Scene, settings: ResolvedBake, known?: (url: string) => string | undefined): string;
+//# sourceMappingURL=digest.d.ts.map

package/dist/node_modules/@allyhub/scenery-host/dist/bake/format.d.ts

@@ -0,0 +1,63 @@
+import type { ResolvedBake } from "@allyhub/scenery";
+/** A stretch of the data after the header. */
+export interface Section {
+    offset: number;
+    bytes: number;
+    gzip?: boolean;
+}
+/** A mesh with a lightmap: found again by its place in the scene's traversal and its name. */
+export interface BakedMesh {
+    /** Its place among the scene's meshes, in traversal order. */
+    key: number;
+    name: string;
+    /** Its vertices as built. */
+    vertices: number;
+    /** Its vertices after the unwrap (some split at the atlas's seams). */
+    count: number;
+    /** For each new vertex, the vertex it copies (u16 or u32 by `wide`). */
+    original: Section;
+    /** Its triangles over the new vertices (u16 or u32 by `wide`). */
+    index: Section;
+    /** Its places in the atlas, u16 pairs of 0..65535. */
+    uv1: Section;
+    /** Whether original and index are u32. */
+    wide: boolean;
+}
+export interface BakeHeader {
+    version: number;
+    digest: string;
+    /** The renderer it was made on (bakeRenderer), and its name as WebGL gives it. */
+    renderer: string;
+    gl: string;
+    /** The atlas's side, texels. */
+    size: number;
+    settings: ResolvedBake;
+    /** Whether the environment's diffuse light is in the lightmap (else the environment still lights baked surfaces). */
+    environment: boolean;
+    meshes: BakedMesh[];
+    /** size × size × RGB half floats, rows from the atlas's v = 0. */
+    lightmap: Section;
+}
+export interface BakeFile {
+    header: BakeHeader;
+    /** The data after the header. */
+    data: Uint8Array;
+}
+/** Gathers sections, then writes the file. */
+export declare class BakeWriter {
+    private readonly parts;
+    private length;
+    /** Adds bytes as a section, gzipped when asked. */
+    add(view: ArrayBufferView, opts?: {
+        gzip?: boolean;
+    }): Promise<Section>;
+    /** The file: magic, version, the header's length, the header, the sections. */
+    write(header: BakeHeader): Uint8Array;
+}
+/** Reads a bake file's header; throws for bytes that are not one. */
+export declare function readBake(bytes: Uint8Array): BakeFile;
+/** A section's bytes, ungzipped. */
+export declare function sectionOf(file: BakeFile, s: Section): Promise<Uint8Array>;
+/** A section's bytes as a typed array of its own (aligned copy). */
+export declare function typed<T extends Uint16Array | Uint32Array>(bytes: Uint8Array, make: new (b: ArrayBuffer) => T): T;
+//# sourceMappingURL=format.d.ts.map

package/dist/node_modules/@allyhub/scenery-host/dist/bake/run.d.ts

@@ -0,0 +1,63 @@
+import { BufferGeometry, Matrix4, Mesh, Scene, Vector3, type WebGLRenderer } from "three";
+import { MeshBVH } from "three-mesh-bvh";
+import { type BakeReport, type ResolvedBake } from "@allyhub/scenery";
+export interface BakeRunOptions {
+    scene: Scene;
+    renderer: WebGLRenderer;
+    settings: ResolvedBake;
+    digest: string;
+    /** xatlas-web's wasm file in this page. */
+    xatlasWasm: string;
+    /** Poses the scenery at a moment (an update that needs references leaves it as it is). */
+    poseAt(t: number): void;
+    gl: string;
+}
+export interface BakeRun {
+    bytes: Uint8Array;
+    report: BakeReport;
+}
+/**
+ * The share of light a surface's specular lobe gives back over the hemisphere, at a reflectance at normal incidence f0
+ * and a roughness: Karis's fit of the split-sum BRDF, averaged over the cosine-weighted directions it is lit from.
+ */
+export declare function specularAlbedo(f0: number, roughness: number): number;
+/**
+ * A mesh's islands (its pieces that share no vertex, a vertex being its
+ * place, so seams in the uv or the normals do not split a piece), and the
+ * area of the island at the median of the mesh's area: half the area is in
+ * islands this size or smaller. Scenery square metres.
+ */
+export declare function medianIsland(g: BufferGeometry, m: Matrix4): number;
+export declare function ownUv(g: BufferGeometry, slack?: number): {
+    uv: Float32Array;
+    index: Uint32Array;
+    texels: number;
+} | undefined;
+/**
+ * Each mesh's atlas as a rectangle of the scene's, scaled so the mesh gets
+ * `density` texels per weighted metre, packed in shelves into the smallest
+ * square side that holds them (at most maxSize: denser bakes are scaled down
+ * to fit). Returns the side, the density reached, and each mesh's scale and
+ * place (texels).
+ */
+export declare function packAtlas(rects: {
+    texels: number;
+    area: number;
+    extent: [number, number];
+}[], density: number, maxSize: number, minSize: number): {
+    size: number;
+    density: number;
+    places: {
+        scale: number;
+        x: number;
+        y: number;
+    }[];
+};
+/** Rays from a point light's place in every direction: the meshes they meet first within `far`, by the share of rays each stops. */
+export declare function aroundLight(bvh: MeshBVH, ownerOf: (vertex: number) => Mesh | undefined, at: Vector3, rays?: number, far?: number): {
+    name: string;
+    share: number;
+}[];
+/** Bakes the scene's light: the bake file's bytes and the report. */
+export declare function runBake(o: BakeRunOptions): Promise<BakeRun>;
+//# sourceMappingURL=run.d.ts.map