@bitmagic/asset-core 0.1.0 → 0.1.1

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/index.d.ts

@@ -14,6 +14,7 @@ export type { CharacterParams, CharacterResult } from './generators/character.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,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

@@ -7,6 +7,7 @@ export { generateImageAsset, imageAssetParamsSchema } from './generators/image.j
 export { generateCharacter, characterParamsSchema } from './generators/character.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,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.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -12,6 +12,13 @@
     "./terminal-failure": {
       "types": "./dist/terminal-failure.d.ts",
       "default": "./dist/terminal-failure.js"
+    },
+    "./animation/*": {
+      "default": "./src/animation/*"
+    },
+    "./animation/authored.mjs": {
+      "types": "./src/animation/authored.d.mts",
+      "default": "./src/animation/authored.mjs"
     }
   },
   "files": [
@@ -21,7 +28,8 @@
     "access": "public"
   },
   "dependencies": {
-    "zod": "^3.25.76"
+    "zod": "^3.25.76",
+    "three": "^0.185.1"
   },
   "devDependencies": {
     "@eslint/js": "^9.38.0",
@@ -65,7 +73,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"
   }
 }