@bitmagic/animation-forger 0.1.0

package/dist/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../src/params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU/B,CAAC;AAEZ,6EAA6E;AAC7E,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEzF,kDAAkD;AAClD,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,6BAA6B,CAAC,CAAC"}

package/dist/params.js

@@ -0,0 +1,25 @@
+/**
+ * The wire body for a CLI-lane animation generation.
+ *
+ * `gameId` is deliberately absent: the route strips it and checks ownership
+ * before a generator ever sees the params, exactly as every other
+ * `POST /api/cli/v1/assets/:type/stream` generator is shaped.
+ *
+ * Named `authoredAnimationParamsSchema`, not `animationParamsSchema`, because
+ * `@bitmagic/asset-core` already exports the latter for the dormant
+ * text-to-motion client and both are importable in the same file.
+ */
+import { z } from 'zod';
+import { authoredClipSpecSchema } from './authored-spec.js';
+export const authoredAnimationParamsSchema = z.object({
+    description: z.string().min(1)
+        .describe('What the animation is, for the asset record (e.g. "zombie shuffle with arms extended forward").'),
+    assetId: z.string().optional()
+        .describe('Pre-generated `asset_…` id from a manifest. When provided the animation is stored under this '
+        + 'exact id and THAT is what playCustomAnimation resolves. Distinct from `spec.motionId`, which is the '
+        + "clip's own internal id. If omitted, the spec motionId is used."),
+    spec: authoredClipSpecSchema
+        .describe('Authored-clip parameter spec. `gait` (walk/run variations incl. limps and held arm poses), '
+        + '`melee` (weapon strikes as key poses), `oneShot` (waves, salutes, crouches, celebrations).'),
+}).strict();
+//# sourceMappingURL=params.js.map

package/dist/params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../src/params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;SAC3B,QAAQ,CAAC,iGAAiG,CAAC;IAC9G,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC3B,QAAQ,CAAC,+FAA+F;UACrG,sGAAsG;UACtG,gEAAgE,CAAC;IACvE,IAAI,EAAE,sBAAsB;SACzB,QAAQ,CAAC,6FAA6F;UACnG,4FAA4F,CAAC;CACpG,CAAC,CAAC,MAAM,EAAE,CAAC"}

package/dist/result-types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * What a built clip is, and what a host that stored one reports back.
+ *
+ * Bytes are a `Uint8Array` rather than a `Buffer` for the reason
+ * `world-forger`'s storage seam gives: a published `.d.ts` must not force
+ * `@types/node` on a consumer that only wants the types.
+ */
+/** The clip identity the compiler bakes into the GLB. */
+export interface AuthoredClipMeta {
+    name: string;
+    motionId: string;
+    duration: number;
+    loop: boolean;
+    /** Gait clips only: m/s the stride was built for — drives engine stride sync. */
+    designSpeed?: number;
+}
+/** What the builder returns. */
+export interface AuthoredClipResult {
+    /** The compiled animation-only GLB. */
+    bytes: Uint8Array;
+    meta: AuthoredClipMeta;
+    /**
+     * Non-fatal build findings (loop seam, grounding, size budget).
+     *
+     * A warning is publishable; a hard gate failure THROWS instead of landing
+     * here, because a clip that fails one is not worth shipping.
+     */
+    warnings: string[];
+}
+/** What a host reports after building AND storing a clip. */
+export interface AuthoredAnimationOutcome extends AuthoredClipMeta {
+    /** Public URL the game loads the clip from. */
+    url: string;
+    warnings: string[];
+    sizeBytes: number;
+}
+//# sourceMappingURL=result-types.d.ts.map

package/dist/result-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-types.d.ts","sourceRoot":"","sources":["../src/result-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,gCAAgC;AAChC,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,gBAAgB,CAAC;IACvB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,6DAA6D;AAC7D,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAChE,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/result-types.js

@@ -0,0 +1,9 @@
+/**
+ * What a built clip is, and what a host that stored one reports back.
+ *
+ * Bytes are a `Uint8Array` rather than a `Buffer` for the reason
+ * `world-forger`'s storage seam gives: a published `.d.ts` must not force
+ * `@types/node` on a consumer that only wants the types.
+ */
+export {};
+//# sourceMappingURL=result-types.js.map

package/dist/result-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-types.js","sourceRoot":"","sources":["../src/result-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@bitmagic/animation-forger",
+  "version": "0.1.0",
+  "description": "Client half of the Bitmagic animation forger: the authored-clip parameter spec, the wire body, the result types and the host seams.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./*.js": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.38.0",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^24.9.1",
+    "@typescript-eslint/eslint-plugin": "^8.46.2",
+    "@typescript-eslint/parser": "^8.46.2",
+    "eslint": "^9.38.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.4.5",
+    "typescript": "^5.9.3"
+  },
+  "jest": {
+    "preset": "ts-jest/presets/default-esm",
+    "extensionsToTreatAsEsm": [
+      ".ts"
+    ],
+    "transform": {
+      "^.+\\.ts$": [
+        "ts-jest",
+        {
+          "useESM": true,
+          "tsconfig": {
+            "target": "ES2020",
+            "module": "ES2020",
+            "moduleResolution": "node",
+            "verbatimModuleSyntax": false,
+            "esModuleInterop": true
+          }
+        }
+      ]
+    },
+    "moduleNameMapper": {
+      "^(\\.{1,2}/.*)\\.js$": "$1"
+    },
+    "testEnvironment": "node",
+    "testMatch": [
+      "**/__tests__/**/*.test.ts"
+    ],
+    "maxWorkers": "50%"
+  },
+  "dependencies": {
+    "zod": "^3.25.76"
+  },
+  "scripts": {
+    "clean": "node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "pnpm run clean && tsc",
+    "check": "pnpm run lint && pnpm run build",
+    "lint": "eslint src --cache",
+    "test": "jest"
+  }
+}