allyhub 0.2.0-next.1 → 0.2.0-next.2

package/client.d.ts

@@ -0,0 +1,13 @@
+// Types of the packages AllyHub's build lends a project by name
+// (packages/video/sdk/docs/scenery.md, modeling.md), from this install. Add
+// "allyhub/client" to `types` in tsconfig.json, beside "@allyhub/sdk/client".
+// Each points at `allyhub/lent/*`, the bundled package's own declarations,
+// written into the npm package when it is packed
+// (apps/create-allyhub/scripts/npm-packages.ts).
+
+declare module "@allyhub-next/scenery-host/layer" {
+  export * from "allyhub/lent/scenery-host/layer";
+}
+declare module "@allyhub-next/model" {
+  export * from "allyhub/lent/model";
+}

package/dist/commands/add.js

@@ -1,6 +1,6 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{readFile as j}from"node:fs/promises";import{join as w,posix as L,relative as O}from"node:path";import{fileURLToPath as T}from"node:url";import{z as l}from"zod";import{modelInfo as k}from"@allyhub-next/build";import{COMPONENTS_DIR as S}from"@allyhub-next/formats";import{EXIT as u}from"@allyhub-next/protocol";import{ASSET_DEFAULTS as C,ASSET_TYPES as _,PolyHaven as N,PolyHavenError as z,RegistryError as F,applyAdd as D,folderRegistry as x,planAdd as U,searchIndex as M}from"@allyhub-next/registry";import{cacheHome as Y}from"@allyhub-next/runtimes";import{CommandError as A,defineCommand as H}from"../command.js";import{projectRoot as V}from"../project.js";import{dir as B}from"../fields.js";const W=JSON.parse(await j(new URL("../../package.json",import.meta.url),"utf8")).version,P=T(new URL(".",import.meta.resolve("@allyhub-next/components/registry.json"))),b=Object.keys(_),E=20,q=e=>e.replace(/\.(?:ts|js)$/u,"").replaceAll(/[A-Z]/gu,t=>`-${t.toLowerCase()}`).replace(/^-/u,"");function I(e){return e instanceof F?new A(e.code,e.message,{exit:e.code==="conflict"?u.conflict:e.code==="no-item"?u.notFound:u.failed,...e.hint===void 0?{}:{hint:e.hint}}):e instanceof z?new A(e.code,e.message,{exit:e.code==="network"?u.platform:e.code==="not-found"?u.notFound:e.code==="bad-choice"?u.usage:u.failed,...e.hint===void 0?{}:{hint:e.hint}}):e}const R=e=>new N({userAgent:`AllyHub/${W} (+https://allyhub.com)`,cacheDir:w(Y(e.env),"polyhaven"),...e.env.ALLYHUB_POLYHAVEN_API?{api:e.env.ALLYHUB_POLYHAVEN_API}:{}}),g=e=>`${e.toFixed(3)} m`;function J(e){const t=[e.type,e.category,e.size?`${g(e.size.width)} wide, ${g(e.size.depth)} deep, ${g(e.size.height)} tall`:void 0,e.covers?`one tile covers ${e.covers.map(g).join(" × ")}`:void 0,e.polycount!==void 0?`${e.polycount.toLocaleString("en")} polygons`:void 0,e.maxResolution?`up to ${String(e.maxResolution[0])} px`:void 0,e.authors.length>0?`by ${e.authors.join(", ")}`:void 0].filter(n=>n!==void 0);return`  ${e.id}: ${e.name} (${t.join("; ")})
-    found in ${e.matchedIn.join(", ")||"everything"}; tags ${e.tags.join(", ")}`}async function K(e,t){const n=[`${t.name} from Poly Haven (CC0, by ${t.source.authors.join(", ")||"its authors"}): ${String(t.files.length)} files in ${t.dir}/, ${t.fetched>0?`${String(t.fetched)} fetched`:"all already there"}. Records: ${t.records.join(", ")}.`];if(t.type==="model"){const a=t.main[0]??"",d=await k(e,a,await j(w(e,a))),i=d.bounds;return n.push(i?`Measured: ${i.size.map(c=>c.toFixed(3)).join(" × ")} m along x, y (up), z; from ${i.min.map(c=>c.toFixed(3)).join(", ")} to ${i.max.map(c=>c.toFixed(3)).join(", ")}.`:`Not measured: ${d.contentsMissing??"no contents"}.`,...d.missing.length>0?[`Missing: ${d.missing.join(", ")}.`]:[],`In a scenery: const m = await w.load("${a}");`),{lines:n,model:d}}if(t.type==="hdri")return n.push(`In a scenery: await w.environment("${t.main[0]??""}", { background: true });`),{lines:n};const o=t.covers;return n.push(o&&o.length>=2?`One tile covers ${g(o[0]??0)} × ${g(o[1]??0)} (Poly Haven's dimensions): a surface's repeat is its size over that.`:"Poly Haven gives no size for one tile.",...t.main.map((a,d)=>{const i=t.maps?.[d]??"";return`  ${i}: await w.texture("${a}"${i==="diffuse"?"":', { colorSpace: "linear" }'})`})),{lines:n}}export const add=H({name:"add",summary:"Adds what the registry has to the project: a starter component, or a CC0 model, HDRI or texture from Poly Haven; alone it lists the components",input:l.strictObject({name:l.array(l.string()).optional().describe("What to add: a starter component (caption-line, or captionLine), or a Poly Haven asset's id (as allyhub add search prints it)"),to:l.string().optional().describe(`The folder the files go in, from the project (default ${S} for a component; for an asset, its kind's folder under assets/media/ and its id)`),force:l.boolean().default(!1).describe("Replace a component's copy the project changed (its changes are lost)"),res:l.string().optional().describe(`An asset's resolution, of its textures or of the HDRI (default ${C.resolution})`),dir:B}),positional:["name"],output:l.looseObject({}),examples:["allyhub add","allyhub add caption-line","allyhub add metal_office_desk --res 2k"]},async(e,t)=>{const n=x(P);try{const o=await n.index();if(!e.name||e.name.length===0){const h=Math.max(...o.items.map(s=>s.name.length));return{value:{components:o.items},text:["Starter components (allyhub add <name> copies one into components/; allyhub add search <words> finds Poly Haven's models, HDRIs and textures too):",...o.items.map(s=>`  ${s.name.padEnd(h)}  ${s.description}`)].join(`
-`)}}const a=await V(t.cwd,e.dir),d=new Set(o.items.map(h=>h.name)),i=e.name.map(q),c=i.filter(h=>d.has(h)),p=e.name.filter((h,s)=>!d.has(i[s]??"")),m=[],$={};if(c.length>0){const h=e.to??S,s=await U(n,c,{root:a,dir:h,force:e.force});await D(a,s);const v=r=>r==="up to date"?"Up to date":r==="added"?"Added":"Replaced";m.push(...s.files.map(r=>`${v(r.status)} ${r.path}`));const f=s.items.find(r=>r.name===c[0]),y=f?.files[0]?.target.replaceAll("{dir}",h);if(f&&y){const r=O(w(a,"name"),w(a,y)).split("\\").join("/").replace(/\.ts$/u,".js");m.push(`Import it from an item's entry file (<name>/video.ts): import { ${f.title} } from "${r.startsWith(".")?r:`./${r}`}"; one "../" more for each folder the item is deeper.`,"The file is the project's: change it as you like. allyhub add <name> --force puts the registry's back.")}s.missing.length>0&&m.push(`It needs packages the project does not declare: ${s.missing.join(", ")}.`),$.components=s.files.map(r=>({item:r.item,path:r.path,status:r.status})),$.missing=s.missing}if(p.length>0){const h=R(t),s=[];for(const v of p){const f=await h.add(v,{root:a,...e.to===void 0||c.length>0?{}:{to:L.normalize(e.to)},...e.res===void 0?{}:{resolution:e.res}}),y=await K(a,f);m.length>0&&m.push(""),m.push(...y.lines),s.push({...f,...y.model===void 0?{}:{model:y.model}})}$.assets=s}return{value:$,text:m.join(`
-`)}}catch(o){throw I(o)}}),addSearch=H({name:"add search",summary:"Finds the starter components and Poly Haven's CC0 models, HDRIs and textures whose names, tags, categories or descriptions hold every word, each with where its words were found",input:l.strictObject({words:l.array(l.string()).min(1).describe("The words to find (a word may start one of theirs)"),type:l.array(l.enum(["component",...b])).optional().describe("Only these kinds (default all)"),all:l.boolean().default(!1).describe(`Every match, not only the first ${String(E)} Poly Haven assets`)}),positional:["words"],output:l.looseObject({}),examples:['allyhub add search "office desk" --type model',"allyhub add search caption"]},async(e,t)=>{const n=e.words.join(" ").trim();try{const o=e.type??["component",...b],a=o.includes("component")?M(await x(P).index(),n):[],d=b.filter(m=>o.includes(m)),{found:i,total:c}=d.length>0?await R(t).search(n,d):{found:[],total:0},p=e.all?i:i.slice(0,E);return{value:{query:n,components:a,assets:{total:c,matches:i.length,found:p}},text:[...o.includes("component")?[`Starter components: ${String(a.length)} hold "${n}".`,...a.map(m=>`  ${m.name} (${m.title}): ${m.description}`)]:[],...d.length>0?[`From Poly Haven (CC0): ${String(i.length)} of ${String(c)} assets hold "${n}"${p.length<i.length?`; the first ${String(p.length)} (--all for every one)`:""}.`,...p.map(J)]:[],"","Add one: allyhub add <name or id>"].join(`
-`)}}catch(o){throw I(o)}});
+import{createHash as z}from"node:crypto";import{mkdir as M,readFile as x,writeFile as Y}from"node:fs/promises";import{join as S,posix as B,relative as J}from"node:path";import{fileURLToPath as V}from"node:url";import{z as u}from"zod";import{modelInfo as W}from"@allyhub-next/build";import{COMPONENTS_DIR as E}from"@allyhub-next/formats";import{EXIT as b,RegistryIndexSchema as X}from"@allyhub-next/protocol";import{ASSET_DEFAULTS as q,ASSET_TYPES as G,PolyHaven as K,PolyHavenError as Z,RegistryError as Q,applyAdd as R,fetchBakes as ee,folderRegistry as I,planAdd as P,registryAt as te,searchIndex as L}from"@allyhub-next/registry";import{cacheHome as O}from"@allyhub-next/runtimes";import{CommandError as T,defineCommand as _}from"../command.js";import{projectRoot as se}from"../project.js";import{dir as ne}from"../fields.js";const oe=JSON.parse(await x(new URL("../../package.json",import.meta.url),"utf8")).version,C=V(new URL(".",import.meta.resolve("@allyhub-next/components/registry.json"))),j=Object.keys(G),ae="https://allyhub.com/r",ie=3600*1e3;async function H(e){const t=e.env.ALLYHUB_REGISTRY??ae,s=te(t),i=S(O(e.env),"registry",`${z("sha256").update(t).digest("hex").slice(0,16)}.json`),n=await x(i,"utf8").then(o=>{const d=JSON.parse(o),l=X.parse(d.index);return{read:d.read,index:l}}).catch(()=>{});if(n&&Date.now()-n.read<ie)return{source:s,index:n.index,from:"kept"};try{const o=await s.index();return await M(S(i,".."),{recursive:!0}),await Y(i,JSON.stringify({read:Date.now(),index:o})),{source:s,index:o,from:"read"}}catch{return n?{source:s,index:n.index,from:"stale"}:{source:s,from:"none"}}}async function re(e){const{source:t,index:s}=await H(e);return{source:t,names:new Set(s?.items.map(i=>i.name))}}const de={"allyhub:scenery":"Sceneries and settings","allyhub:model":"Models","allyhub:component":"Components","allyhub:template":"Templates","allyhub:skill":"Skills"};function N(e,t){if(e.from==="none")return["AllyHub's resources (models, sceneries) could not be read: check the connection."];const s=t??e.index?.items??[],i=Math.max(0,...s.map(o=>o.name.length)),n=[`AllyHub's resources (allyhub add <name> copies one with what it needs, its Poly Haven assets and its baked light)${e.from==="stale"?", as last read (the registry cannot be read now)":""}:`];for(const[o,d]of Object.entries(de)){const l=s.filter(h=>h.type===o);l.length!==0&&n.push(`  ${d}:`,...l.map(h=>`    ${h.name.padEnd(i)}  ${h.description}`))}return n}const D=20,le=e=>e.replace(/\.(?:ts|js)$/u,"").replaceAll(/[A-Z]/gu,t=>`-${t.toLowerCase()}`).replace(/^-/u,"");function F(e){return e instanceof Q?new T(e.code,e.message,{exit:e.code==="conflict"?b.conflict:e.code==="no-item"?b.notFound:b.failed,...e.hint===void 0?{}:{hint:e.hint}}):e instanceof Z?new T(e.code,e.message,{exit:e.code==="network"?b.platform:e.code==="not-found"?b.notFound:e.code==="bad-choice"?b.usage:b.failed,...e.hint===void 0?{}:{hint:e.hint}}):e}const A=e=>new K({userAgent:`AllyHub/${oe} (+https://allyhub.com)`,cacheDir:S(O(e.env),"polyhaven"),...e.env.ALLYHUB_POLYHAVEN_API?{api:e.env.ALLYHUB_POLYHAVEN_API}:{}}),v=e=>`${e.toFixed(3)} m`;function ce(e){const t=[e.type,e.category,e.size?`${v(e.size.width)} wide, ${v(e.size.depth)} deep, ${v(e.size.height)} tall`:void 0,e.covers?`one tile covers ${e.covers.map(v).join(" × ")}`:void 0,e.polycount!==void 0?`${e.polycount.toLocaleString("en")} polygons`:void 0,e.maxResolution?`up to ${String(e.maxResolution[0])} px`:void 0,e.authors.length>0?`by ${e.authors.join(", ")}`:void 0].filter(s=>s!==void 0);return`  ${e.id}: ${e.name} (${t.join("; ")})
+    found in ${e.matchedIn.join(", ")||"everything"}; tags ${e.tags.join(", ")}`}async function U(e,t){const s=[`${t.name} from Poly Haven (CC0, by ${t.source.authors.join(", ")||"its authors"}): ${String(t.files.length)} files in ${t.dir}/, ${t.fetched>0?`${String(t.fetched)} fetched`:"all already there"}. Records: ${t.records.join(", ")}.`];if(t.type==="model"){const n=t.main[0]??"",o=await W(e,n,await x(S(e,n))),d=o.bounds;return s.push(d?`Measured: ${d.size.map(l=>l.toFixed(3)).join(" × ")} m along x, y (up), z; from ${d.min.map(l=>l.toFixed(3)).join(", ")} to ${d.max.map(l=>l.toFixed(3)).join(", ")}.`:`Not measured: ${o.contentsMissing??"no contents"}.`,...o.missing.length>0?[`Missing: ${o.missing.join(", ")}.`]:[],`In a scenery: const m = await w.load("${n}");`),{lines:s,model:o}}if(t.type==="hdri")return s.push(`In a scenery: await w.environment("${t.main[0]??""}", { background: true });`),{lines:s};const i=t.covers;return s.push(i&&i.length>=2?`One tile covers ${v(i[0]??0)} × ${v(i[1]??0)} (Poly Haven's dimensions): a surface's repeat is its size over that.`:"Poly Haven gives no size for one tile.",...t.main.map((n,o)=>{const d=t.maps?.[o]??"";return`  ${d}: await w.texture("${n}"${d==="diffuse"?"":', { colorSpace: "linear" }'})`})),{lines:s}}export const add=_({name:"add",summary:"Adds what the registry has to the project: a starter component, a resource from AllyHub's registry (a model, a scenery, a skill), or a CC0 model, HDRI or texture from Poly Haven; alone it lists the components",input:u.strictObject({name:u.array(u.string()).optional().describe("What to add: a starter component (caption-line, or captionLine), a resource from AllyHub's registry (a model, a scenery or a skill: home-desk-demo-day, product-demos; a skill goes in .agents/skills, linked from .claude/skills), or a Poly Haven asset's id (as allyhub add search prints it)"),to:u.string().optional().describe(`The folder the files go in, from the project (default ${E} for a component; for an asset, its kind's folder under assets/media/ and its id)`),force:u.boolean().default(!1).describe("Replace a component's copy the project changed (its changes are lost)"),res:u.string().optional().describe(`An asset's resolution, of its textures or of the HDRI (default ${q.resolution})`),dir:ne}),positional:["name"],output:u.looseObject({}),examples:["allyhub add","allyhub add caption-line","allyhub add metal_office_desk --res 2k"]},async(e,t)=>{const s=I(C);try{const i=await s.index();if(!e.name||e.name.length===0){const r=Math.max(...i.items.map(y=>y.name.length)),c=await H(t);return{value:{components:i.items,resources:c.index?.items??[]},text:["Starter components (allyhub add <name> copies one into components/; allyhub add search <words> finds resources and Poly Haven's models, HDRIs and textures too):",...i.items.map(y=>`  ${y.name.padEnd(r)}  ${y.description}`),"",...N(c,void 0)].join(`
+`)}}const n=await se(t.cwd,e.dir),o=new Set(i.items.map(r=>r.name)),d=e.name.map(le),l=d.filter(r=>o.has(r)),h=d.filter(r=>!o.has(r)),$=h.length>0?await re(t):void 0,w=h.filter(r=>$?.names.has(r)),p=e.name.filter((r,c)=>!o.has(d[c]??"")&&!($?.names.has(d[c]??"")??!1)),f=[],k={};if(l.length>0){const r=e.to??E,c=await P(s,l,{root:n,dir:r,force:e.force});await R(n,c);const y=m=>m==="up to date"?"Up to date":m==="added"?"Added":"Replaced";f.push(...c.files.map(m=>`${y(m.status)} ${m.path}`));const a=c.items.find(m=>m.name===l[0]),g=a?.files[0]?.target.replaceAll("{dir}",r);if(a&&g){const m=J(S(n,"name"),S(n,g)).split("\\").join("/").replace(/\.ts$/u,".js");f.push(`Import it from an item's entry file (<name>/video.ts): import { ${a.title} } from "${m.startsWith(".")?m:`./${m}`}"; one "../" more for each folder the item is deeper.`,"The file is the project's: change it as you like. allyhub add <name> --force puts the registry's back.")}c.missing.length>0&&f.push(`It needs packages the project does not declare: ${c.missing.join(", ")}.`),k.components=c.files.map(m=>({item:m.item,path:m.path,status:m.status})),k.missing=c.missing}if($&&w.length>0){const r=await P($.source,w,{root:n,dir:".",force:e.force});await R(n,r),f.length>0&&f.push(""),f.push(...r.files.map(a=>`${a.status==="up to date"?"Up to date":a.status==="added"?"Added":"Replaced"} ${a.path}`));const c=A(t);for(const a of r.assets){const g=await c.add(a.id,{root:n,...a.resolution===void 0?{}:{resolution:a.resolution},...a.maps===void 0?{}:{maps:a.maps}});f.push(...(await U(n,g)).lines)}const y=await ee(n,r.bakes);f.push(...y.map(a=>`${a.status==="added"?"Downloaded":"Up to date"} the baked light for ${a.bake.scenery}: ${a.path}`),"The files are the project's: change them as you like (a changed scenery is drawn unbaked until allyhub scenery bake bakes it again). allyhub add <name> --force puts the registry's back."),k.resources={files:r.files.map(a=>({item:a.item,path:a.path,status:a.status})),assets:r.assets,bakes:y.map(a=>({path:a.path,status:a.status}))}}if(p.length>0){const r=A(t),c=[];for(const y of p){const a=await r.add(y,{root:n,...e.to===void 0||l.length>0?{}:{to:B.normalize(e.to)},...e.res===void 0?{}:{resolution:e.res}}),g=await U(n,a);f.length>0&&f.push(""),f.push(...g.lines),c.push({...a,...g.model===void 0?{}:{model:g.model}})}k.assets=c}return{value:k,text:f.join(`
+`)}}catch(i){throw F(i)}}),addSearch=_({name:"add search",summary:"Finds the starter components, AllyHub's resources (models, sceneries) and Poly Haven's CC0 models, HDRIs and textures whose names, tags, categories or descriptions hold every word, each with where its words were found",input:u.strictObject({words:u.array(u.string()).min(1).describe("The words to find (a word may start one of theirs)"),type:u.array(u.enum(["component","resource",...j])).optional().describe("Only these kinds (default all): component, resource (AllyHub's models and sceneries), or a Poly Haven kind"),all:u.boolean().default(!1).describe(`Every match, not only the first ${String(D)} Poly Haven assets`)}),positional:["words"],output:u.looseObject({}),examples:['allyhub add search "office desk" --type model',"allyhub add search caption"]},async(e,t)=>{const s=e.words.join(" ").trim();try{const i=e.type??["component","resource",...j],n=i.includes("component")?L(await I(C).index(),s):[],o=i.includes("resource")?await H(t):void 0,d=o?.index?L(o.index,s):[],l=j.filter(p=>i.includes(p)),{found:h,total:$}=l.length>0?await A(t).search(s,l):{found:[],total:0},w=e.all?h:h.slice(0,D);return{value:{query:s,components:n,resources:d,assets:{total:$,matches:h.length,found:w}},text:[...i.includes("component")?[`Starter components: ${String(n.length)} hold "${s}".`,...n.map(p=>`  ${p.name} (${p.title}): ${p.description}`)]:[],...o?o.from==="none"?N(o,[]):[`AllyHub's resources: ${String(d.length)} hold "${s}"${o.from==="stale"?" (as last read)":""}.`,...d.map(p=>`  ${p.name} (${p.title}): ${p.description}`)]:[],...l.length>0?[`From Poly Haven (CC0): ${String(h.length)} of ${String($)} assets hold "${s}"${w.length<h.length?`; the first ${String(w.length)} (--all for every one)`:""}.`,...w.map(ce)]:[],"","Add one: allyhub add <name or id>"].join(`
+`)}}catch(i){throw F(i)}});

package/dist/lent/model.d.ts

@@ -0,0 +1,2 @@
+// The types of @allyhub-next/model, which allyhub's build lends a project by that name.
+export * from "../../node_modules/@allyhub-next/model/dist/index.js";

package/dist/lent/scenery-host-layer.d.ts

@@ -0,0 +1,2 @@
+// The types of @allyhub-next/scenery-host/layer, which allyhub's build lends a project by that name.
+export * from "../../node_modules/@allyhub-next/scenery-host/dist/layer/index.js";