@roost2d/chikn-rigs 0.5.0 → 0.6.0

package/README.md

@@ -40,11 +40,15 @@ Trait-aware brawler actions are resolved from the same recipe:
 
 ```ts
 const choices = listAvailableChiknActions(recipe, definition);
-const action = resolveChiknAction(recipe, definition, choices[0].id);
+const action = resolveChiknAction(recipe, definition, choices[0].id, {
+  targetOffset: { x: 210, y: -24 }, // fighter-local; positive X is current forward
+});
 const playback = new RigActionController(rig).play(action.clip, { controlled: true });
 playback.advance(frameMs);
 ```
 
-Every attachment group receives an immutable motion profile with its supported actions, attachment targets, amplitude, and speed. Weapons can replace the punch motion, feet select the paired or combined flying spin kick, combat-capable tails use a tail-strike foundation, and `listChiknSpecials` returns only specials granted by equipped traits.
+Every attachment group receives one checked-in immutable profile with its supported actions, driver attachments, calibrated offsets and timing, functional preset, and explicit rigid/soft/dangling/cloth/feather/bulky/elastic secondary motion. Weapons replace Punch with their own draw, slash, thrust, golf, pickaxe, shot, swing, or casting motion. Feet select tailored paired or combined kicks, and `listChiknSpecials` returns only specials granted by equipped traits.
+
+Golden Egg and Very Fresh Egg use a dedicated 1,000 ms action: the inner `pose` bone turns away while game-owned root facing stays untouched, the bird bends, the displayed egg releases at 400 ms, and a texture-identical detached clone follows an aimed arc until presentation contact at 800 ms. The equipped egg regrows and the setup pose returns at 1,000 ms. Floppy Disk and Omelette also launch exact equipped art; Omelette uses its pan motion and is never classified as an egg.
 
 Resolve each `definition.attachments[].texture.assetId` through a separately hosted Chikn runtime manifest before creating the display factory. [Chikn integration tutorial](https://github.com/Roost2D/roost2d/blob/main/docs/chikn-assets.md).

package/dist/actions.d.ts

@@ -1,5 +1,6 @@
 import type { AnimationClipV1, RigDefinitionV1 } from '@roost2d/contracts';
-import type { ProceduralEffectDescriptor } from '@roost2d/effects';
+import type { EffectOrigin, EffectPoint, ProceduralEffectDescriptor } from '@roost2d/effects';
+import { type ChiknKickPreset, type ChiknPunchPreset, type ChiknSecondaryMotion, type ChiknSpecialPreset } from './trait-profiles.js';
 export type ChiknMotionFamily = 'accent' | 'footwear' | 'blade' | 'blunt' | 'ranged' | 'casting' | 'tail';
 export type ChiknActionInput = 'punch' | 'kick' | 'special';
 export interface ChiknTraitAnimationProfile {
@@ -9,13 +10,25 @@ export interface ChiknTraitAnimationProfile {
     motionFamily: ChiknMotionFamily;
     readonly attachmentTargets: readonly string[];
     readonly supportedActions: readonly ChiknActionInput[];
+    secondaryMotion: ChiknSecondaryMotion;
     amplitude: number;
     speed: number;
+    gripOffset: EffectPoint;
+    tipOffset: EffectPoint;
+    originOffset: EffectPoint;
+    timing: {
+        anticipationMs: number;
+        releaseMs: number;
+        recoveryMs: number;
+    };
+    punchPreset?: ChiknPunchPreset;
+    kickPreset?: ChiknKickPreset;
     special?: {
         id: string;
         label: string;
         family: 'beam' | 'projectile' | 'cast' | 'burst' | 'tail';
-        socketId: string;
+        preset: ChiknSpecialPreset;
+        origin: EffectOrigin;
     };
 }
 export interface ChiknActionChoice {
@@ -24,25 +37,32 @@ export interface ChiknActionChoice {
     label: string;
     sourceTraitGroupId?: string;
 }
+export interface ChiknActionContext {
+    targetOffset?: EffectPoint;
+}
 export interface ResolvedChiknEffect extends ProceduralEffectDescriptor {
     cueId: string;
+    /** @deprecated Prefer origin. Kept for v0.5 consumers. */
     socketId: string;
 }
 export interface ResolvedChiknAction extends ChiknActionChoice {
     motionFamily: string;
     clip: AnimationClipV1;
     effects: ResolvedChiknEffect[];
+    targetOffset: EffectPoint;
 }
 export interface ChiknActionRecipe {
     species: 'chikn' | 'roostr';
     traitGroupIds: readonly string[];
+    /** Informational only. Facing remains owned by the consuming game. */
+    mirrored?: boolean;
 }
-/** Returns one immutable motion profile for every attachment group in a rig. */
+/** Returns one checked-in, immutable motion profile for every attachment group in a rig. */
 export declare function createChiknTraitAnimationProfiles(definition: RigDefinitionV1): readonly ChiknTraitAnimationProfile[];
 export declare function validateChiknTraitAnimationProfiles(definition: RigDefinitionV1, profiles: readonly ChiknTraitAnimationProfile[]): string[];
 export declare function listChiknSpecials(recipe: ChiknActionRecipe, definition: RigDefinitionV1): ChiknActionChoice[];
 export declare function listAvailableChiknActions(recipe: ChiknActionRecipe, definition: RigDefinitionV1): ChiknActionChoice[];
-export declare function resolveChiknAction(recipe: ChiknActionRecipe, definition: RigDefinitionV1, actionId: string): ResolvedChiknAction;
+export declare function resolveChiknAction(recipe: ChiknActionRecipe, definition: RigDefinitionV1, actionId: string, context?: ChiknActionContext): ResolvedChiknAction;
 /** Species-specific brawler and attack foundations generated from the rig setup pose. */
 export declare function createChiknActionClips(definition: RigDefinitionV1): readonly AnimationClipV1[];
 //# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAoC,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC7G,OAAO,KAAK,EAAE,0BAA0B,EAAwB,MAAM,kBAAkB,CAAC;AAEzF,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAC1G,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5D,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,iBAAiB,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACtH;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAoB,SAAQ,0BAA0B;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC5B,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAUD,gFAAgF;AAChF,wBAAgB,iCAAiC,CAAC,UAAU,EAAE,eAAe,GAAG,SAAS,0BAA0B,EAAE,CA+BpH;AAED,wBAAgB,mCAAmC,CAAC,UAAU,EAAE,eAAe,EAAE,QAAQ,EAAE,SAAS,0BAA0B,EAAE,GAAG,MAAM,EAAE,CAkB1I;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,eAAe,GAAG,iBAAiB,EAAE,CAO7G;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,eAAe,GAAG,iBAAiB,EAAE,CAMrH;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAgChI;AAED,yFAAyF;AACzF,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,eAAe,GAAG,SAAS,eAAe,EAAE,CAkC9F"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"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"}