@bitmagic/asset-core 0.1.0 → 0.1.2

package/dist/cover-prompt.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Cover-art prompt composition, shared by every lane that generates a game's
+ * cover image: Creator's Planning Mode and the per-game cover endpoint in
+ * game-play-agent, the offline template-cover script, and `bitmagic cover` in
+ * the CLI lane. It lives here rather than in any one of them because the style
+ * direction is what makes covers from all of them read as the same product —
+ * a copy that drifts produces art that visibly does not match.
+ *
+ * No network, no credentials: this module composes strings. Each lane calls its
+ * own image generator with the result.
+ */
+/**
+ * Shared style direction for every Bitmagic cover image: the polished voxel
+ * craft of "if Pixar made a voxel game," kept mood-neutral so the per-scene
+ * description sets the tone (cheerful adventure vs. dark horror). Do NOT bake
+ * mood/lighting words (golden-hour, cheerful, scary) in here — those belong in
+ * the scene description.
+ */
+export declare const PIXAR_VOXEL_STYLE: string;
+/** How much of the design text reaches the image model; the rest is dropped. */
+export declare const MAX_COVER_DESIGN_CHARS = 1500;
+/**
+ * Compose the image prompt for a cover image from a game's design text
+ * (GAME-DESIGN.md content or, during planning, the pitch/plan doc). Falls back
+ * to a generic voxel scene when none is present.
+ *
+ * The game name is deliberately NEVER injected — naming the game makes image
+ * models render the title as on-image text. We describe a wordless scene and
+ * append a strong no-text directive.
+ */
+export declare function buildCoverArtPrompt(gameDesign: string): string;
+//# sourceMappingURL=cover-prompt.d.ts.map

package/dist/cover-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cover-prompt.d.ts","sourceRoot":"","sources":["../src/cover-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,QAIsD,CAAC;AAErF,gFAAgF;AAChF,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAQ9D"}

package/dist/cover-prompt.js

@@ -0,0 +1,41 @@
+/**
+ * Cover-art prompt composition, shared by every lane that generates a game's
+ * cover image: Creator's Planning Mode and the per-game cover endpoint in
+ * game-play-agent, the offline template-cover script, and `bitmagic cover` in
+ * the CLI lane. It lives here rather than in any one of them because the style
+ * direction is what makes covers from all of them read as the same product —
+ * a copy that drifts produces art that visibly does not match.
+ *
+ * No network, no credentials: this module composes strings. Each lane calls its
+ * own image generator with the result.
+ */
+/**
+ * Shared style direction for every Bitmagic cover image: the polished voxel
+ * craft of "if Pixar made a voxel game," kept mood-neutral so the per-scene
+ * description sets the tone (cheerful adventure vs. dark horror). Do NOT bake
+ * mood/lighting words (golden-hour, cheerful, scary) in here — those belong in
+ * the scene description.
+ */
+export const PIXAR_VOXEL_STYLE = 'highly polished 3D render in the voxel craft of a Pixar-quality animated film, ' +
+    'cinematic lighting that fits the scene, soft ambient occlusion, subtle subsurface scattering, ' +
+    'rich detail and expressive composition. ' +
+    'Wordless illustration, no text, no title, no words, no letters, no logos, no UI.';
+/** How much of the design text reaches the image model; the rest is dropped. */
+export const MAX_COVER_DESIGN_CHARS = 1500;
+/**
+ * Compose the image prompt for a cover image from a game's design text
+ * (GAME-DESIGN.md content or, during planning, the pitch/plan doc). Falls back
+ * to a generic voxel scene when none is present.
+ *
+ * The game name is deliberately NEVER injected — naming the game makes image
+ * models render the title as on-image text. We describe a wordless scene and
+ * append a strong no-text directive.
+ */
+export function buildCoverArtPrompt(gameDesign) {
+    const excerpt = gameDesign.trim().slice(0, MAX_COVER_DESIGN_CHARS);
+    if (!excerpt) {
+        return `A charming, inviting voxel adventure game scene, colorful and full of character. ${PIXAR_VOXEL_STYLE}`;
+    }
+    return `A voxel game scene based on this game design:\n${excerpt}\n\nDepict the world and atmosphere as a single illustrated scene. ${PIXAR_VOXEL_STYLE}`;
+}
+//# sourceMappingURL=cover-prompt.js.map

package/dist/cover-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cover-prompt.js","sourceRoot":"","sources":["../src/cover-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAC5B,iFAAiF;IACjF,gGAAgG;IAChG,0CAA0C;IAC1C,kFAAkF,CAAC;AAErF,gFAAgF;AAChF,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAAC;IAEnE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,oFAAoF,iBAAiB,EAAE,CAAC;IACjH,CAAC;IAED,OAAO,kDAAkD,OAAO,sEAAsE,iBAAiB,EAAE,CAAC;AAC5J,CAAC"}

package/dist/favicon.d.ts

@@ -0,0 +1,74 @@
+/**
+ * The published game's browser-tab icon: the one `<link>` element, the one storage-key
+ * derivation, and the one function that swaps the default out for a game's own.
+ *
+ * Import path matters: this module is published as the `@bitmagic/asset-core/favicon`
+ * subpath so its consumers do not drag in the root barrel's zod / three / forger client.
+ * It is node-only (`node:crypto`) — the three consumers are game-play-agent (web publish
+ * lane), api-server (CLI publish lane) and the CLI itself. The Creator never imports it;
+ * it uploads a source image and lets publish do the deriving.
+ *
+ * Why this lives in a shared package rather than being duplicated per lane: the two
+ * publish lanes must agree on the marker id and on the exact `<link>` they emit, or a
+ * game's icon silently reverts to the Bitmagic mark in whichever lane drifted. The pieces
+ * where drift breaks correctness are shared here; the sharp resize is NOT (it would drag
+ * a heavy native dep into a package the browser-facing subpaths live beside), and is
+ * deliberately mirrored in each lane instead.
+ */
+/**
+ * The id on the default `<link rel="icon">` baked into every game bundle — `game/index.html`
+ * for the web lane, `renderIndexHtml()` for CLI projects. Publish finds the element by this
+ * id and replaces it wholesale.
+ *
+ * Replacing rather than appending a second link is deliberate. Two `sizes`-less `rel="icon"`
+ * links is ambiguous input: "the last one wins" is browser convention, not spec, and Safari
+ * has historically picked differently from Chrome. After `applyFaviconLink` the document
+ * carries exactly one icon link, which is something a test can assert.
+ */
+export declare const FAVICON_LINK_ID = "bm-favicon";
+/**
+ * Edge length of the derived icon. A retina browser tab renders a 32 CSS px icon at 2x, so
+ * 64 is the real ceiling that matters; it also covers bookmark and taskbar use at 48.
+ * Browsers downscale cleanly, so a single size beats emitting several `sizes=` variants.
+ */
+export declare const FAVICON_PX = 64;
+/**
+ * 32 hex chars of sha256 over the SOURCE URL — not over the source bytes.
+ *
+ * Hashing the URL is what makes the cache free: the storage key is computable without
+ * fetching anything, so a cache hit costs one existence probe and no download. It is sound
+ * because every cover/upload URL in both lanes is already timestamp-unique per upload, so
+ * new art always produces a new URL and therefore a new key.
+ */
+export declare function faviconContentHash(sourceUrl: string): string;
+/**
+ * Where the web lane stores an icon derived from `sourceUrl`, relative to the storage
+ * prefix (`worlds/v3`). The CLI lane composes its own game-scoped key from
+ * `faviconContentHash` instead, because its bucket layout is per-game rather than shared.
+ *
+ * The `v1` segment and the `-64` suffix are load-bearing: changing the crop or the size
+ * must produce a NEW key rather than silently serving the old bytes from an immutable
+ * `max-age=31536000` object. Same reasoning as the hand-rolled `-v2` on the watermark logo.
+ */
+export declare function faviconStorageKey(sourceUrl: string): string;
+/** The exact element every lane emits. One definition so the lanes cannot disagree. */
+export declare function renderFaviconLink(href: string): string;
+/**
+ * Point the document's icon at `href`.
+ *
+ * Replaces the element carrying `id="bm-favicon"`. When that marker is absent — an older
+ * cached bundle, or a CLI project that has not run `bitmagic upgrade` since the marker
+ * shipped — falls back to inserting before `</head>`, which is best-effort but never worse
+ * than the un-marked status quo.
+ *
+ * Returns `html` unchanged when `href` is missing or not an allowed scheme, and never
+ * throws: a tab icon must not be able to fail a publish.
+ *
+ * `indexOf` rather than a regex on purpose. The default href is a ~700-char base64 data URI
+ * sitting inside a bundle that reaches 20 MB, and the surrounding code (`injectIntoHtml`)
+ * is string-insertion for the same reason. Anchored `indexOf` scans are O(n) with tiny
+ * constants and have obvious failure semantics; a backtracking regex over that string does
+ * not.
+ */
+export declare function applyFaviconLink(html: string, href: string | null | undefined): string;
+//# sourceMappingURL=favicon.d.ts.map

package/dist/favicon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"favicon.d.ts","sourceRoot":"","sources":["../src/favicon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,eAAe,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,UAAU,KAAK,CAAC;AAqB7B;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAuBtF"}

package/dist/favicon.js

@@ -0,0 +1,130 @@
+/**
+ * The published game's browser-tab icon: the one `<link>` element, the one storage-key
+ * derivation, and the one function that swaps the default out for a game's own.
+ *
+ * Import path matters: this module is published as the `@bitmagic/asset-core/favicon`
+ * subpath so its consumers do not drag in the root barrel's zod / three / forger client.
+ * It is node-only (`node:crypto`) — the three consumers are game-play-agent (web publish
+ * lane), api-server (CLI publish lane) and the CLI itself. The Creator never imports it;
+ * it uploads a source image and lets publish do the deriving.
+ *
+ * Why this lives in a shared package rather than being duplicated per lane: the two
+ * publish lanes must agree on the marker id and on the exact `<link>` they emit, or a
+ * game's icon silently reverts to the Bitmagic mark in whichever lane drifted. The pieces
+ * where drift breaks correctness are shared here; the sharp resize is NOT (it would drag
+ * a heavy native dep into a package the browser-facing subpaths live beside), and is
+ * deliberately mirrored in each lane instead.
+ */
+import { createHash } from 'node:crypto';
+/**
+ * The id on the default `<link rel="icon">` baked into every game bundle — `game/index.html`
+ * for the web lane, `renderIndexHtml()` for CLI projects. Publish finds the element by this
+ * id and replaces it wholesale.
+ *
+ * Replacing rather than appending a second link is deliberate. Two `sizes`-less `rel="icon"`
+ * links is ambiguous input: "the last one wins" is browser convention, not spec, and Safari
+ * has historically picked differently from Chrome. After `applyFaviconLink` the document
+ * carries exactly one icon link, which is something a test can assert.
+ */
+export const FAVICON_LINK_ID = 'bm-favicon';
+/**
+ * Edge length of the derived icon. A retina browser tab renders a 32 CSS px icon at 2x, so
+ * 64 is the real ceiling that matters; it also covers bookmark and taskbar use at 48.
+ * Browsers downscale cleanly, so a single size beats emitting several `sizes=` variants.
+ */
+export const FAVICON_PX = 64;
+/** Attribute-safe. The href reaches a public page's `<head>` and may be creator-supplied. */
+function escapeAttr(value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/"/g, '&quot;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+}
+/**
+ * Only these two forms may become an icon href. Escaping alone is not the whole guard — a
+ * `javascript:` URL in a `<link href>` is inert in modern browsers, but this string is
+ * assembled from creator-controlled data and baked into a public page, so the allowlist is
+ * the guard and the escaping is defence in depth.
+ */
+function isAllowedHref(href) {
+    return /^https:\/\//i.test(href) || /^data:image\//i.test(href);
+}
+/**
+ * 32 hex chars of sha256 over the SOURCE URL — not over the source bytes.
+ *
+ * Hashing the URL is what makes the cache free: the storage key is computable without
+ * fetching anything, so a cache hit costs one existence probe and no download. It is sound
+ * because every cover/upload URL in both lanes is already timestamp-unique per upload, so
+ * new art always produces a new URL and therefore a new key.
+ */
+export function faviconContentHash(sourceUrl) {
+    return createHash('sha256').update(sourceUrl).digest('hex').slice(0, 32);
+}
+/**
+ * Where the web lane stores an icon derived from `sourceUrl`, relative to the storage
+ * prefix (`worlds/v3`). The CLI lane composes its own game-scoped key from
+ * `faviconContentHash` instead, because its bucket layout is per-game rather than shared.
+ *
+ * The `v1` segment and the `-64` suffix are load-bearing: changing the crop or the size
+ * must produce a NEW key rather than silently serving the old bytes from an immutable
+ * `max-age=31536000` object. Same reasoning as the hand-rolled `-v2` on the watermark logo.
+ */
+export function faviconStorageKey(sourceUrl) {
+    return `assets/favicons/v1/${faviconContentHash(sourceUrl)}-${FAVICON_PX}.png`;
+}
+/** The exact element every lane emits. One definition so the lanes cannot disagree. */
+export function renderFaviconLink(href) {
+    return `<link id="${FAVICON_LINK_ID}" rel="icon" type="image/png" href="${escapeAttr(href)}">`;
+}
+/**
+ * Point the document's icon at `href`.
+ *
+ * Replaces the element carrying `id="bm-favicon"`. When that marker is absent — an older
+ * cached bundle, or a CLI project that has not run `bitmagic upgrade` since the marker
+ * shipped — falls back to inserting before `</head>`, which is best-effort but never worse
+ * than the un-marked status quo.
+ *
+ * Returns `html` unchanged when `href` is missing or not an allowed scheme, and never
+ * throws: a tab icon must not be able to fail a publish.
+ *
+ * `indexOf` rather than a regex on purpose. The default href is a ~700-char base64 data URI
+ * sitting inside a bundle that reaches 20 MB, and the surrounding code (`injectIntoHtml`)
+ * is string-insertion for the same reason. Anchored `indexOf` scans are O(n) with tiny
+ * constants and have obvious failure semantics; a backtracking regex over that string does
+ * not.
+ */
+export function applyFaviconLink(html, href) {
+    if (!href || !isAllowedHref(href))
+        return html;
+    const link = renderFaviconLink(href);
+    const needle = `id="${FAVICON_LINK_ID}"`;
+    for (let at = html.indexOf(needle); at !== -1; at = html.indexOf(needle, at + needle.length)) {
+        const open = html.lastIndexOf('<', at);
+        const close = html.indexOf('>', at);
+        // A marker with no enclosing element is malformed input, not something to guess at.
+        if (open === -1 || close === -1)
+            continue;
+        // It has to be an actual <link> element. The id is also NAMED in prose — the explanatory
+        // comment above the default link in game/index.html, this doc block, docs — and matching the
+        // first occurrence anywhere replaced a comment instead of the link, which left the real
+        // default in place and shipped a page with two icon links. Verified the hard way.
+        if (!/^<link[\s/>]/i.test(html.slice(open, open + 6)))
+            continue;
+        if (isInsideComment(html, open))
+            continue;
+        return html.slice(0, open) + link + html.slice(close + 1);
+    }
+    const headClose = html.indexOf('</head>');
+    if (headClose === -1)
+        return html;
+    return html.slice(0, headClose) + link + '\n' + html.slice(headClose);
+}
+/** Is `at` inside an HTML comment? True when the nearest `<!--` behind it is not yet closed. */
+function isInsideComment(html, at) {
+    const open = html.lastIndexOf('<!--', at);
+    if (open === -1)
+        return false;
+    return html.lastIndexOf('-->', at) < open;
+}
+//# sourceMappingURL=favicon.js.map

package/dist/favicon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"favicon.js","sourceRoot":"","sources":["../src/favicon.ts"],"names":[],"mappings":"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"}

package/dist/generators/prop.d.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import type { AssetResultBase, GenerateDeps } from '../types.js';
+/**
+ * A 3D prop mesh, from a prompt.
+ *
+ * The odd one out among the generators: it returns NO world.json patches. Every other generator
+ * produces a finished asset the host can write straight away, but a prop is only half made when
+ * the Asset Forger hands back a GLB — the engine still has to voxelize it, and voxelizing happens
+ * in a browser with the game loaded, which is the caller's side of the seam in both lanes. So this
+ * returns the GLB URL and stops, and the host decides what to do with it.
+ *
+ * That is what makes the same code serve the CLI's `bitmagic generate prop` (voxelize in a
+ * headless Chrome, upsert the asset locally) and, in principle, the web lane's HQ job — which
+ * today reimplements this call inline in `hq-asset-jobs.ts`.
+ *
+ * The generation is billable the moment the Forger accepts the job: the vendor charges on
+ * acceptance, so a downstream failure to produce a URL still costs.
+ */
+export declare const propParamsSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    /**
+     * `prop` matches what the HQ path has always sent. Named rather than hardcoded because the
+     * Forger distinguishes props from characters, and a mis-typed model produces a rigged humanoid
+     * where a rock was wanted.
+     */
+    modelType: z.ZodDefault<z.ZodOptional<z.ZodEnum<["prop"]>>>;
+}, "strict", z.ZodTypeAny, {
+    prompt: string;
+    modelType: "prop";
+}, {
+    prompt: string;
+    modelType?: "prop" | undefined;
+}>;
+export type PropParams = z.input<typeof propParamsSchema>;
+export type PropResult = AssetResultBase & {
+    /** Where the generated mesh landed. The host voxelizes this. */
+    glbUrl?: string;
+    billable?: boolean;
+};
+export declare function generateProp(params: PropParams, deps: GenerateDeps & {
+    imageToMeshModel?: string;
+}): Promise<PropResult>;
+//# sourceMappingURL=prop.d.ts.map

package/dist/generators/prop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prop.d.ts","sourceRoot":"","sources":["../../src/generators/prop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIjE;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,gBAAgB;;IAI3B;;;;OAIG;;;;;;;;EAEM,CAAC;AAEZ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG;IACzC,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAcF,wBAAsB,YAAY,CAChC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,YAAY,GAAG;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD,OAAO,CAAC,UAAU,CAAC,CAsDrB"}

package/dist/generators/prop.js

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+import { fail, ok } from '../result.js';
+import { formatZodIssues } from '../validation.js';
+/**
+ * A 3D prop mesh, from a prompt.
+ *
+ * The odd one out among the generators: it returns NO world.json patches. Every other generator
+ * produces a finished asset the host can write straight away, but a prop is only half made when
+ * the Asset Forger hands back a GLB — the engine still has to voxelize it, and voxelizing happens
+ * in a browser with the game loaded, which is the caller's side of the seam in both lanes. So this
+ * returns the GLB URL and stops, and the host decides what to do with it.
+ *
+ * That is what makes the same code serve the CLI's `bitmagic generate prop` (voxelize in a
+ * headless Chrome, upsert the asset locally) and, in principle, the web lane's HQ job — which
+ * today reimplements this call inline in `hq-asset-jobs.ts`.
+ *
+ * The generation is billable the moment the Forger accepts the job: the vendor charges on
+ * acceptance, so a downstream failure to produce a URL still costs.
+ */
+export const propParamsSchema = z.object({
+    prompt: z.string()
+        .min(1)
+        .describe('What the object should be (e.g. "a weathered stone archway covered in moss")'),
+    /**
+     * `prop` matches what the HQ path has always sent. Named rather than hardcoded because the
+     * Forger distinguishes props from characters, and a mis-typed model produces a rigged humanoid
+     * where a rock was wanted.
+     */
+    modelType: z.enum(['prop']).optional().default('prop'),
+}).strict();
+const ENDPOINT = '/ai/v1/forge3d/jobs';
+/**
+ * Kept in step with `hq-asset-jobs.ts`, which is the proven configuration for this endpoint.
+ * `rigging: 'false'` is a STRING because that is what the Forger's API accepts.
+ */
+const DEFAULT_IMAGE_TO_MESH_MODEL = 'unified-trellis';
+export async function generateProp(params, deps) {
+    const { forger, logger, onProgress } = deps;
+    const parsed = propParamsSchema.safeParse(params);
+    if (!parsed.success) {
+        logger.warn({ err: parsed.error }, '[prop] Invalid parameters');
+        return fail(formatZodIssues(parsed.error));
+    }
+    const input = parsed.data;
+    if (!forger.hasCredentials()) {
+        logger.error('[prop] Missing Asset Forger credentials');
+        return fail(forger.getMissingCredentialsMessage());
+    }
+    onProgress(`Generating a mesh for: ${input.prompt}`);
+    logger.info(`[prop] Starting forge3d for "${input.prompt}"`);
+    let response;
+    try {
+        response = await forger.postJobAndWait(ENDPOINT, {
+            model: 'lab',
+            prompt: input.prompt,
+            parameters: {
+                imageToMeshModel: deps.imageToMeshModel ?? DEFAULT_IMAGE_TO_MESH_MODEL,
+                modelType: input.modelType,
+                rigging: 'false',
+            },
+        }, 'prop');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error occurred';
+        logger.error({ err: error }, '[prop] Error during generation');
+        return fail(message);
+    }
+    const glbUrl = response.data?.fileUrl;
+    if (!glbUrl) {
+        // Billable: the Forger accepted and ran the job, and was paid for it, whatever it answered.
+        return { ...fail('Asset Forger returned no file URL for the generated mesh'), billable: true };
+    }
+    logger.info(`[prop] Generated ${glbUrl}`);
+    return ok(`Mesh generated: ${glbUrl}`, 
+    // Deliberately empty — see the file header. The asset does not exist until the host has
+    // voxelized this, and writing a half-made entry would leave world.json describing an asset the
+    // engine cannot load.
+    [], { glbUrl, billable: true });
+}
+//# sourceMappingURL=prop.js.map

package/dist/generators/prop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prop.js","sourceRoot":"","sources":["../../src/generators/prop.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -11,9 +11,12 @@ export { generateImageAsset, imageAssetParamsSchema } from './generators/image.j
 export type { ImageAssetParams, ImageAssetResult } from './generators/image.js';
 export { generateCharacter, characterParamsSchema } from './generators/character.js';
 export type { CharacterParams, CharacterResult } from './generators/character.js';
+export { generateProp, propParamsSchema } from './generators/prop.js';
+export type { PropParams, PropResult } from './generators/prop.js';
 export { generateAnimationAsset, animationParamsSchema, getConfiguredAnimationModel, ANIMATION_MODEL_TEXT_TO_MOTION_3, ANIMATION_MODEL_TEXT_TO_MOTION_2, ANIMATION_MODEL_OLDER, } from './generators/animation.js';
 export type { AnimationParams, AnimationResult } from './generators/animation.js';
 export { fetchContentLength } from './http.js';
+export { PIXAR_VOXEL_STYLE, MAX_COVER_DESIGN_CHARS, buildCoverArtPrompt } from './cover-prompt.js';
 export { TERMINAL_FAILURE_CODES, TERMINAL_FAILURE_VERSION, buildTerminalFailure, isTerminalFailureCode, legacyErrorTypeFor, parseTerminalFailure, } from './terminal-failure.js';
 export type { BuildTerminalFailureInput, LegacyErrorType, TerminalFailure, TerminalFailureCode, TerminalFailureDetail, } from './terminal-failure.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,UAAU,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5F,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACnF,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACrF,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,EAC3B,gCAAgC,EAChC,gCAAgC,EAChC,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAM/C,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,yBAAyB,EACzB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,UAAU,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5F,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACnF,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACrF,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACtE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,EAC3B,gCAAgC,EAChC,gCAAgC,EAChC,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAMnG,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,yBAAyB,EACzB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -5,8 +5,10 @@ export { generateSkybox, skyboxParamsSchema } from './generators/skybox.js';
 export { generateSoundEffect, soundEffectParamsSchema } from './generators/sound-effect.js';
 export { generateImageAsset, imageAssetParamsSchema } from './generators/image.js';
 export { generateCharacter, characterParamsSchema } from './generators/character.js';
+export { generateProp, propParamsSchema } from './generators/prop.js';
 export { generateAnimationAsset, animationParamsSchema, getConfiguredAnimationModel, ANIMATION_MODEL_TEXT_TO_MOTION_3, ANIMATION_MODEL_TEXT_TO_MOTION_2, ANIMATION_MODEL_OLDER, } from './generators/animation.js';
 export { fetchContentLength } from './http.js';
+export { PIXAR_VOXEL_STYLE, MAX_COVER_DESIGN_CHARS, buildCoverArtPrompt } from './cover-prompt.js';
 // The agent↔client terminal-failure contract. Also published as the
 // `@bitmagic/asset-core/terminal-failure` subpath: this barrel eagerly pulls in
 // the generators (and therefore zod, the forger client, and node http helpers),

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5E,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE5F,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAErF,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,EAC3B,gCAAgC,EAChC,gCAAgC,EAChC,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,oEAAoE;AACpE,gFAAgF;AAChF,gFAAgF;AAChF,oEAAoE;AACpE,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5E,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE5F,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAErF,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEtE,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,EAC3B,gCAAgC,EAChC,gCAAgC,EAChC,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEnG,oEAAoE;AACpE,gFAAgF;AAChF,gFAAgF;AAChF,oEAAoE;AACpE,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitmagic/asset-core",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -12,6 +12,17 @@
     "./terminal-failure": {
       "types": "./dist/terminal-failure.d.ts",
       "default": "./dist/terminal-failure.js"
+    },
+    "./favicon": {
+      "types": "./dist/favicon.d.ts",
+      "default": "./dist/favicon.js"
+    },
+    "./animation/*": {
+      "default": "./src/animation/*"
+    },
+    "./animation/authored.mjs": {
+      "types": "./src/animation/authored.d.mts",
+      "default": "./src/animation/authored.mjs"
     }
   },
   "files": [
@@ -21,7 +32,8 @@
     "access": "public"
   },
   "dependencies": {
-    "zod": "^3.25.76"
+    "zod": "^3.25.76",
+    "three": "^0.185.1"
   },
   "devDependencies": {
     "@eslint/js": "^9.38.0",
@@ -65,7 +77,7 @@
   "scripts": {
     "build": "tsc",
     "check": "pnpm run lint && pnpm run build",
-    "lint": "eslint src",
+    "lint": "eslint src --cache",
     "test": "NODE_OPTIONS=--experimental-vm-modules jest"
   }
 }