@bitmagic/animation-forger 0.1.0

package/dist/authored-spec.d.ts.map

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

package/dist/authored-spec.js

@@ -0,0 +1,219 @@
+/**
+ * The authored-clip parameter spec — what a caller sends to have an animation
+ * built.
+ *
+ * This is the PUBLISHED half of the animation forger: the dials and their
+ * ranges, and nothing that knows how to turn them into motion. The solver, the
+ * tuned preset tables and the pose vocabulary live in the private half and never
+ * reach a creator's machine.
+ *
+ * Two properties this shape exists to guarantee:
+ *
+ *  1. SAFETY. The obvious design has an agent write a clip module which the
+ *     builder then imports — arbitrary code execution driven by end-user
+ *     prompts. Here the caller emits DATA, this schema validates it, and only
+ *     code that already shipped ever runs.
+ *
+ *  2. QUALITY. Every range below is the range the built-in clips were tuned
+ *     within. Outside them the IK starts clamping and the feet skate, so a spec
+ *     that falls outside is REFUSED with the failing field named rather than
+ *     approximated — a clip that measures fine and looks wrong is worse than no
+ *     clip.
+ *
+ * ── Keeping this in step with the private half ──────────────────────────────
+ *
+ * Three of the enums and defaults below are literal copies of private tables:
+ * `BLADE_DIRECTIONS` (the blade aim vocabulary), `GAIT_PRESETS` (the preset
+ * names) and `STANDING_HIP_Y`. They are inlined because this package must not
+ * depend on the private one. A `schema-sync` test in the private package asserts
+ * each of them still matches its table — without it, adding an eleventh blade
+ * direction would leave it silently unreachable, with no error anywhere.
+ */
+import { z } from 'zod';
+// ─── Shared pieces ──────────────────────────────────────────────────────────
+/**
+ * The blade aim vocabulary. MUST equal `Object.keys(BLADE)` in the private half
+ * — pinned by its schema-sync test.
+ */
+export const BLADE_DIRECTIONS = [
+    'forward', 'forwardHigh', 'forwardLow', 'up', 'upBack',
+    'down', 'downForward', 'outRight', 'outLeft', 'rest',
+];
+/** MUST equal `Object.keys(GAIT_PRESETS)` in the private half. */
+export const GAIT_PRESET_NAMES = ['walk', 'slowRun', 'fastRun'];
+/** MUST equal `STANDING_HIP_Y` in the private half. Hip height in cm, standing. */
+export const STANDING_HIP_Y = 97.5;
+const blade = z.enum(BLADE_DIRECTIONS);
+const ease = z.enum(['linear', 'in', 'out', 'inOut']);
+/**
+ * CamelCase, and NOT containing idle/walk/run/jump.
+ *
+ * The reserved-word rule used to be a post-parse throw inside the builder, so a
+ * bad name cost a full round trip (and, in the CLI lane, an upload) before
+ * anything complained. It belongs in the schema: `AnimationOverrideSystem`
+ * routes clips to engine states by SUBSTRING, so such a name seizes that
+ * locomotion state for every character the moment the clip loads.
+ */
+const clipName = z.string().min(3).max(40)
+    .regex(/^[A-Za-z][A-Za-z0-9]*$/, 'Use a CamelCase identifier, letters and digits only')
+    .refine((n) => !/idle|walk|run|jump/i.test(n), 'Name must not contain idle/walk/run/jump — AnimationOverrideSystem routes clips to engine '
+    + 'states by substring, so such a name seizes that locomotion state for every character. '
+    + 'Use e.g. "LimpStride" rather than "LimpWalk".');
+/**
+ * The clip's OWN engine motion id, baked into the GLB meta — the same convention
+ * the built-in Mixamo clips use (mWalkDefault01). NOT the minted `asset_…` id:
+ * that is passed alongside the spec and is what `playCustomAnimation` resolves.
+ *
+ * The regex mirrors the private half's `validateMeta`, which used to be the only
+ * place it was enforced — so a spec reusing the asset id here passed input
+ * validation and then died at build time, costing a round.
+ */
+const motionId = z.string().max(64)
+    .regex(/^m[A-Za-z0-9]{4,}$/, 'motionId must be the engine convention "m" followed by 4+ letters/digits (e.g. mBoatSeatedHold01). '
+    + "This is the clip's internal id, NOT the minted asset id — pass that as `assetId` alongside the spec.");
+const baseSchema = {
+    name: clipName,
+    motionId,
+    duration: z.number().min(0.2).max(12),
+};
+/** A held arm pose. Shared by the gait family's `dials.arms` and oneShot keys. */
+const armPoseSchema = z.object({
+    pitch: z.number().min(-1.2).max(3),
+    splay: z.number().min(-0.4).max(1.4).optional(),
+    elbow: z.number().min(0).max(2.2).optional(),
+    yaw: z.number().min(-1).max(1).optional(),
+});
+// ─── Family 1: gait ─────────────────────────────────────────────────────────
+//
+// A whole biped from a preset plus dial overrides.
+export const gaitSpecSchema = z.object({
+    family: z.literal('gait'),
+    ...baseSchema,
+    basedOn: z.enum(GAIT_PRESET_NAMES),
+    designSpeed: z.number().min(0.3).max(9)
+        .describe('Metres/second the cycle is built for; feet slide if this disagrees with how fast the character actually moves.'),
+    loop: z.literal(true).default(true),
+    dials: z.object({
+        stance: z.number().min(0.22).max(0.72).optional()
+            .describe('Fraction of the cycle each foot is on the ground. >0.5 walks, <0.5 runs.'),
+        bob: z.number().min(0).max(16).optional(),
+        footLift: z.number().min(2).max(38).optional(),
+        lean: z.number().min(-0.25).max(0.55).optional(),
+        // Capped by where the HAND ends up, not by how vigorous the angle looks:
+        // above this the hands crest over the shoulder and read as flailing.
+        armSwing: z.number().min(0).max(0.95).optional()
+            .describe('Above ~0.8 the hands crest over the shoulder and read as flailing.'),
+        armSplay: z.number().min(0).max(0.6).optional(),
+        elbow: z.number().min(0).max(1.8).optional(),
+        hipYaw: z.number().min(0).max(0.25).optional(),
+        chestYaw: z.number().min(0).max(0.35).optional(),
+        // Asymmetry dials — this is what makes a limp, a swagger, a trudge.
+        limpSide: z.enum(['left', 'right']).optional(),
+        limpDepth: z.number().min(0).max(1).optional()
+            .describe('0 = even gait, 1 = pronounced limp on limpSide.'),
+        // HELD arm pose replacing the swing entirely — zombie reach, sleepwalker,
+        // carrying something. Both arms take the identical pose; per-side asymmetry
+        // is what the oneShot family is for.
+        arms: armPoseSchema.optional()
+            .describe('HELD arm pose replacing the swing. pitch is the angle from hanging: ~1.43 = hands at SHOULDER '
+            + 'height (zombie reach, sleepwalker), below 0.85 = low carry. The dead zone between (0.85-1.3) lands '
+            + 'hands at waist height and the build REJECTS it for a reach. Both arms take the same pose.'),
+    }).default({}),
+});
+// ─── Family 2: melee ────────────────────────────────────────────────────────
+//
+// A weapon strike as a short sequence of key poses.
+const meleeKeySchema = z.object({
+    at: z.number().min(0).max(1),
+    ease: ease.default('inOut')
+        .describe("Use 'out' settling into the wind-up, 'in' for the strike, 'linear' between two identical keys to HOLD."),
+    pow: z.number().min(1).max(4).default(2.2),
+    grip: z.enum(['one', 'two']),
+    hipDrop: z.number().min(-6).max(24).default(9),
+    twist: z.number().min(-1.2).max(1.2).default(0),
+    fold: z.number().min(-0.6).max(1).default(0),
+    blade,
+    arm: z.object({
+        pitch: z.number().min(-1).max(2.8),
+        yaw: z.number().min(-1).max(1).default(0),
+        elbow: z.number().min(0).max(2).default(0.6),
+    }),
+    stance: z.object({
+        front: z.number().min(-40).max(50).default(0),
+        back: z.number().min(-40).max(20).default(0),
+    }).optional(),
+});
+export const meleeSpecSchema = z.object({
+    family: z.literal('melee'),
+    ...baseSchema,
+    loop: z.literal(false).default(false),
+    impactPhase: z.number().min(0.15).max(0.85)
+        .describe('Where in the clip the blow lands, 0..1.'),
+    twoHanded: z.boolean().default(false)
+        .describe('True puts the off hand on the shaft (solved by IK, not posed).'),
+    keys: z.array(meleeKeySchema).min(3).max(6)
+        .describe('Key poses. First must be at 0 and last at 1. A strike reads best as: '
+        + 'guard → wind-up → contact → follow-through → guard.'),
+});
+// ─── Family 3: oneShot ──────────────────────────────────────────────────────
+//
+// An arbitrary whole-body pose sequence — waves, salutes, crouches,
+// celebrations, flinches.
+const jointSchema = z.object({
+    pitch: z.number().min(-2.5).max(2.5).optional(),
+    yaw: z.number().min(-2).max(2).optional(),
+    roll: z.number().min(-2).max(2).optional(),
+}).strict();
+const oneShotKeySchema = z.object({
+    at: z.number().min(0).max(1),
+    ease: ease.default('inOut'),
+    hipY: z.number().min(55).max(105).default(STANDING_HIP_Y)
+        .describe('Hip height in cm; ~97 standing, lower to crouch.'),
+    stance: z.object({
+        front: z.number().min(-35).max(45).default(8),
+        back: z.number().min(-35).max(45).default(-8),
+    }).default({ front: 8, back: -8 }),
+    arms: z.object({
+        left: armPoseSchema.extend({
+            splay: z.number().min(-0.4).max(1.4).default(0.2),
+            elbow: z.number().min(0).max(2.2).default(0.4),
+            yaw: z.number().min(-1).max(1).default(0),
+        }).optional(),
+        right: armPoseSchema.extend({
+            splay: z.number().min(-0.4).max(1.4).default(0.2),
+            elbow: z.number().min(0).max(2.2).default(0.4),
+            yaw: z.number().min(-1).max(1).default(0),
+        }).optional(),
+    }).default({}),
+    torso: z.object({
+        spine: jointSchema.optional(),
+        chest: jointSchema.optional(),
+        neck: jointSchema.optional(),
+        head: jointSchema.optional(),
+        hips: jointSchema.optional(),
+    }).default({}),
+});
+export const oneShotSpecSchema = z.object({
+    family: z.literal('oneShot'),
+    ...baseSchema,
+    loop: z.boolean().default(false),
+    keys: z.array(oneShotKeySchema).min(2).max(8),
+});
+// ─── Entry point ────────────────────────────────────────────────────────────
+export const authoredClipSpecSchema = z.discriminatedUnion('family', [
+    gaitSpecSchema, meleeSpecSchema, oneShotSpecSchema,
+]);
+/**
+ * Render a spec rejection as one line naming each offending field.
+ *
+ * Exported because naming the field is the whole point of validating client-side:
+ * `bitmagic generate animation` parses the spec before it sends anything, so a bad
+ * dial costs a message rather than a round trip. Mirrors the shape api-server's
+ * route returns, so the same mistake reads the same either way.
+ */
+export function formatSpecIssues(error) {
+    return error.issues
+        .map((issue) => `${issue.path.join('.') || '(root)'}: ${issue.message}`)
+        .join('; ');
+}
+//# sourceMappingURL=authored-spec.js.map

package/dist/authored-spec.js.map

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

package/dist/deps.d.ts

@@ -0,0 +1,56 @@
+/**
+ * What the animation forger needs from its host, so the SAME builder runs
+ * behind game-play-agent's in-process web lane and api-server's CLI lane.
+ *
+ * Modeled on `@bitmagic/world-forger`'s `ForgeDeps` and `@bitmagic/asset-core`'s
+ * `GenerateDeps` — a pipeline takes its host's capabilities as a parameter and
+ * owns no framework, filesystem or tenant of its own.
+ *
+ * Only two seams, because building a clip is pure compute plus one upload:
+ *  - `storage` — where the finished GLB goes, and what URL it is reachable at.
+ *  - `logger`  — diagnostics.
+ */
+/**
+ * The logging surface the builder needs. Structurally satisfied by a pino logger
+ * (game-play-agent passes its own `createLogger(...)` result directly), same
+ * pattern as `world-forger`'s `ForgeLogger`. The object-first overload matters
+ * for errors: `warn({ err }, msg)` serializes the Error with its stack as a
+ * structured field, where `warn(\`${err.message}\`)` throws the stack away.
+ */
+export interface AnimationLogger {
+    info(message: string, ...rest: unknown[]): void;
+    info(context: Record<string, unknown>, message: string): void;
+    warn(message: string, ...rest: unknown[]): void;
+    warn(context: Record<string, unknown>, message: string): void;
+    error(message: string, ...rest: unknown[]): void;
+    error(context: Record<string, unknown>, message: string): void;
+}
+/** One object write. A field-for-field subset of the hosts' real storage clients. */
+export interface AnimationPutObjectParams {
+    bucket: string;
+    key: string;
+    body: Uint8Array;
+    contentType: string;
+    cacheControl?: string;
+}
+export interface AnimationStorageClient {
+    putObject(params: AnimationPutObjectParams): Promise<unknown>;
+}
+/**
+ * Where clips are written and what URL they are then reachable at.
+ *
+ * A host whose `publicUrl` is absent or a `file://` path must REFUSE rather than
+ * build: a clip the game's browser cannot fetch is worse than a clear failure,
+ * and reporting success for an animation that never plays is the specific
+ * outcome this guard exists to prevent.
+ */
+export interface AnimationStorageEnv {
+    storageClient: AnimationStorageClient;
+    bucket: string;
+    publicUrl: string;
+}
+export interface AnimationForgerDeps {
+    storage: AnimationStorageEnv;
+    logger: AnimationLogger;
+}
+//# sourceMappingURL=deps.d.ts.map

package/dist/deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../src/deps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAChE;AAED,qFAAqF;AACrF,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/D;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,sBAAsB,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,eAAe,CAAC;CACzB"}

package/dist/deps.js

@@ -0,0 +1,14 @@
+/**
+ * What the animation forger needs from its host, so the SAME builder runs
+ * behind game-play-agent's in-process web lane and api-server's CLI lane.
+ *
+ * Modeled on `@bitmagic/world-forger`'s `ForgeDeps` and `@bitmagic/asset-core`'s
+ * `GenerateDeps` — a pipeline takes its host's capabilities as a parameter and
+ * owns no framework, filesystem or tenant of its own.
+ *
+ * Only two seams, because building a clip is pure compute plus one upload:
+ *  - `storage` — where the finished GLB goes, and what URL it is reachable at.
+ *  - `logger`  — diagnostics.
+ */
+export {};
+//# sourceMappingURL=deps.js.map

package/dist/deps.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `@bitmagic/animation-forger` — the client half of the Bitmagic animation
+ * forger.
+ *
+ * The forger turns a validated parameter spec into an animation GLB built
+ * against the canonical rig. It is split in two along an IP line, and THIS is
+ * the half that ships:
+ *
+ *   - here:      the spec a caller writes, the wire body, the result types and
+ *                the host seams. Depends on zod and nothing else — no three.js,
+ *                no `node:*` — so it runs in a browser and its `.d.ts` costs a
+ *                consumer no extra `@types`.
+ *   - elsewhere: the solver. The footstep-target IK, the tuned gait presets, the
+ *                blade aim vocabulary, the grounding and loop-seam gates and the
+ *                GLB writer. That half is private, is never published, and runs
+ *                only on our own servers.
+ *
+ * A caller that wants a clip BUILT sends a spec to an endpoint. A caller that
+ * only wants to construct or validate one needs nothing beyond this package.
+ *
+ * (The private half is deliberately not named anywhere in this package's
+ * sources: `scripts/check-packed-tarball.mjs` proves the name appears nowhere in
+ * what gets published, and that check has no false positives to argue with only
+ * so long as this stays true.)
+ */
+export { authoredClipSpecSchema, gaitSpecSchema, meleeSpecSchema, oneShotSpecSchema, BLADE_DIRECTIONS, GAIT_PRESET_NAMES, STANDING_HIP_Y, formatSpecIssues, } from './authored-spec.js';
+export type { AuthoredClipSpec, AuthoredClipSpecInput, AuthoredClipFamily, BladeDirection, GaitPresetName, } from './authored-spec.js';
+export { authoredAnimationParamsSchema } from './params.js';
+export type { AuthoredAnimationParams, AuthoredAnimationParamsInput } from './params.js';
+export type { AuthoredClipMeta, AuthoredClipResult, AuthoredAnimationOutcome, } from './result-types.js';
+export type { AnimationForgerDeps, AnimationLogger, AnimationStorageClient, AnimationStorageEnv, AnimationPutObjectParams, } from './deps.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAEzF,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+/**
+ * `@bitmagic/animation-forger` — the client half of the Bitmagic animation
+ * forger.
+ *
+ * The forger turns a validated parameter spec into an animation GLB built
+ * against the canonical rig. It is split in two along an IP line, and THIS is
+ * the half that ships:
+ *
+ *   - here:      the spec a caller writes, the wire body, the result types and
+ *                the host seams. Depends on zod and nothing else — no three.js,
+ *                no `node:*` — so it runs in a browser and its `.d.ts` costs a
+ *                consumer no extra `@types`.
+ *   - elsewhere: the solver. The footstep-target IK, the tuned gait presets, the
+ *                blade aim vocabulary, the grounding and loop-seam gates and the
+ *                GLB writer. That half is private, is never published, and runs
+ *                only on our own servers.
+ *
+ * A caller that wants a clip BUILT sends a spec to an endpoint. A caller that
+ * only wants to construct or validate one needs nothing beyond this package.
+ *
+ * (The private half is deliberately not named anywhere in this package's
+ * sources: `scripts/check-packed-tarball.mjs` proves the name appears nowhere in
+ * what gets published, and that check has no false positives to argue with only
+ * so long as this stays true.)
+ */
+export { authoredClipSpecSchema, gaitSpecSchema, meleeSpecSchema, oneShotSpecSchema, BLADE_DIRECTIONS, GAIT_PRESET_NAMES, STANDING_HIP_Y, formatSpecIssues, } from './authored-spec.js';
+export { authoredAnimationParamsSchema } from './params.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAS5B,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC"}