@adatechnology/game-characters-three 0.8.0 → 0.8.1

package/dist/{testing-DyQw8dCw.d.ts → testing-CsC-BhNN.d.ts}

@@ -1,6 +1,7 @@
 import { Vec3, DestructionEvent, SoundRequest, TestableModule, HandTargets } from '@adatechnology/game-contracts';
 import * as THREE_NS from 'three';
-import { CascadeJoint, RestPose, StrideParams, GaitSample, lerpPose, GaitProfile, CharacterKit, CharacterPack, CharacterSpec, DamageCharacter, BodyHit, PoseClipEvent, PoseClip, PoseClipRegistry } from '@adatechnology/game-characters';
+import { CascadeJoint, RestPose, StrideParams, GaitSample, lerpPose, GaitProfile, HairStyle, MoveBlend, CharacterKit, CharacterPack, CharacterSpec, DamageCharacter, BodyHit, PoseClipEvent, PoseClip, PoseClipRegistry } from '@adatechnology/game-characters';
+import { SourceHandle } from '@adatechnology/game-render-three';
 
 /** The three.js namespace the host passes in: the package never imports three itself, so one script tag works. */
 type Three = typeof THREE_NS;
@@ -85,6 +86,207 @@ type RigAnimator = {
  */
 declare const createRigAnimator: (options?: RigAnimatorOptions) => RigAnimator;
 
+/** A clothing or gear entry: its id and, for the ones that take it, a colour. */
+type PersonExtra = readonly [id: string, color?: number, ...more: number[]];
+/** A survivor as the page describes one (`sp`): colours are hex numbers, the short names are the page's. */
+type PersonSpec = {
+    /** Height scale (default 1). */
+    readonly h?: number;
+    /** Width scale (default 1). */
+    readonly bulk?: number;
+    /** Female body. */
+    readonly fem?: boolean | number;
+    readonly skin: number;
+    readonly hair: {
+        readonly s: string;
+        readonly c: number;
+    };
+    /** Top: colour, plaid colour (a checked shirt) and sleeve (`tank`, `short`, `long`). */
+    readonly top: {
+        readonly c: number;
+        readonly plaid?: number;
+        readonly sl?: string;
+    };
+    readonly pants: {
+        readonly c: number;
+        readonly skirt?: boolean;
+    };
+    readonly shoes: number;
+    readonly ex?: readonly PersonExtra[];
+    /** Face features by id (beard, glasses, scar...). */
+    readonly face?: readonly string[];
+    /** Hat kind and colour; a helmet can carry tape (its colour), a photo and night vision goggles. */
+    readonly hat?: {
+        readonly k: string;
+        readonly c: number;
+        readonly tape?: number;
+        readonly photo?: boolean | number;
+        readonly nvg?: boolean | number;
+    };
+    /** Weapon on the back (`shotgun`). */
+    readonly back?: string;
+    /** Item in the right and in the left hand. */
+    readonly hand?: string;
+    readonly lhand?: string;
+    /** A dog at the person's side. */
+    readonly dog?: boolean | number;
+    /** Resting forward lean (radians). */
+    readonly hunch?: number;
+};
+/** A household as the page lists it: the adult (`b`) and the children, each at its `x`. */
+type PersonGroupSpec = {
+    readonly b?: PersonSpec;
+    readonly kid?: boolean | number;
+    /** Zombie category (eye colour). */
+    readonly zcat?: string;
+    readonly kids?: ReadonlyArray<PersonSpec & {
+        readonly x: number;
+    }>;
+};
+type ArmRig = {
+    g: THREE_NS.Group;
+    el: THREE_NS.Group;
+    hg: THREE_NS.Group;
+    mount: THREE_NS.Group;
+    /** Side: 1 right, -1 left. */
+    s: number;
+    fingers: THREE_NS.Group[];
+    th: THREE_NS.Group | null;
+    /** Holds an item. */
+    hold?: boolean;
+    /** Two-handed grip. */
+    grip?: boolean;
+};
+type LegRig = {
+    g: THREE_NS.Group;
+    kn: THREE_NS.Group;
+    s: number;
+};
+/** One body segment a hit or a cut can reach. */
+type BodySegment = {
+    node?: THREE_NS.Object3D;
+    label: string;
+    hp: number;
+    max?: number;
+    state?: string;
+    r?: number;
+    flip?: number;
+    arm?: number;
+    leg?: number;
+    kind?: string;
+};
+/** A built survivor: the scene graph and the rig `pose` moves. */
+type PersonCharacter = {
+    /** Lights the person's items took from the host's LightBudget (the flare); whoever removes the person releases them. */
+    lightSources: SourceHandle[];
+    mv: MoveBlend;
+    phase: number;
+    turnA: number;
+    segs: Record<string, BodySegment>;
+    dmg: {
+        leg: number;
+        dead: number;
+    };
+    pends: unknown[];
+    limp: [number, number];
+    skirt: boolean;
+    root: THREE_NS.Group;
+    fig: THREE_NS.Group;
+    upper: THREE_NS.Group;
+    headG: THREE_NS.Group;
+    arms: ArmRig[];
+    legs: LegRig[];
+    skinM: THREE_NS.MeshStandardMaterial;
+    base: THREE_NS.Color;
+    eyeM: THREE_NS.MeshBasicMaterial;
+    bags: THREE_NS.Mesh<THREE_NS.BufferGeometry, THREE_NS.MeshBasicMaterial>;
+    zb: THREE_NS.Object3D[];
+    mouth: THREE_NS.Mesh;
+    dog: THREE_NS.Group | null;
+    hunch: number;
+    ph: number;
+    /** Drawn as a zombie. */
+    z?: boolean;
+};
+/** Where a Bestiário body is cut or torn (each flag draws a stump, a hole or a hanging part). */
+type BestCuts = {
+    readonly legs?: boolean;
+    readonly gut?: boolean;
+    readonly flaps?: boolean;
+    readonly head?: boolean;
+    readonly blown?: boolean;
+    readonly jaw?: boolean;
+    readonly armR?: boolean;
+    readonly armL?: boolean;
+    readonly dangleR?: boolean;
+    readonly dangleL?: boolean;
+    readonly shoulderR?: boolean;
+    readonly shoulderL?: boolean;
+};
+/** The pose and the look switches of a Bestiário type: the base pose (`BEST` `BASE`) and what a type changes. Angles in radians. */
+type BestPose = {
+    s?: number;
+    bulk?: number;
+    lean?: number;
+    armL?: number;
+    armR?: number;
+    elbL?: number;
+    elbR?: number;
+    legL?: number;
+    legR?: number;
+    kneeL?: number;
+    kneeR?: number;
+    headX?: number;
+    headZ?: number;
+    headFwd?: number;
+    drop?: number;
+    neck?: number;
+    armOut?: number;
+    noLegs?: boolean;
+    mouth?: boolean;
+    bloat?: boolean;
+    dim?: boolean;
+    nose?: boolean;
+    blind?: boolean;
+    wet?: boolean;
+    char?: boolean;
+    gore?: boolean;
+};
+/** A body of the Bestiário (`BEST.build(spec)`): the type by name and what varies. */
+type BestSpec = {
+    /** Type name (`Lento`, `Corredor`, ...); unknown names draw the first card. */
+    readonly type?: string;
+    readonly pose?: BestPose;
+    /** 0 fresh to 3 rotten. */
+    readonly decay?: number;
+    /** 0 fresh-dead, 1 normal, 2 old. */
+    readonly life?: number;
+    readonly cut?: BestCuts;
+    readonly h?: number;
+    readonly bulk?: number;
+    readonly lying?: boolean;
+    readonly opacity?: number;
+    /** Outfit id (`policial`, `militar`, ...). */
+    readonly outfit?: string;
+    readonly seed?: number;
+    /** A baked crowd variant (see `drawAppearance`). */
+    readonly uniform?: boolean;
+    readonly clothIdx?: number;
+    readonly fem?: boolean;
+    readonly tone?: number;
+    readonly hs?: HairStyle;
+    readonly hair?: number;
+    /** A living person: human eyes and mouth, no blood. */
+    readonly human?: boolean;
+    readonly skin?: number;
+    readonly wounds?: number;
+    readonly eyeDim?: boolean;
+    readonly eye?: number;
+    readonly eyesOff?: boolean;
+    readonly bandage?: boolean;
+    readonly phase?: number;
+};
+
 /** The part of a fluid world the bridge needs; `FluidWorld` from `@adatechnology/game-fluids` has it. The package does not import the fluids packages. */
 type BloodSink = {
     splash(liquid: string, point: Vec3, liters: number, velocity?: Vec3): void;
@@ -422,7 +624,7 @@ declare const registerBodyMaterial: (world: {
 }) => void;
 
 /** The person builder's spec for a profession of the people pack (look and gear as numbers; the builder draws the rest). */
-declare const personSpecOf: (profession: ProfessionCard) => Record<string, any>;
+declare const personSpecOf: (profession: ProfessionCard) => PersonSpec;
 
 /**
  * The eye the hands are seen from, given per call to `apply` (null or none is the body seen from outside: nothing changes). `reachBend` keeps the elbow bent where a hand is out of reach, the hand stopping
@@ -603,4 +805,4 @@ declare function createAvatarTestModule(options: AvatarTestOptions): TestableMod
     };
 };
 
-export { createPlayerAvatar as $, type AvatarItemUsePose as A, type BloodLook as B, type CharacterSound as C, type PlayerAvatarSpec as D, type PoseTargets as E, type FluidsBridge as F, type ProfessionCard as G, HIT_PRESETS as H, type RigAnimator as I, type RigAnimatorOptions as J, UNDEAD_VOICE_SOURCES as K, type UndeadCard as L, type UndeadLike as M, type UndeadVoice as N, type VoiceStep as O, type PlayerAvatar as P, bloodLookOfAge as Q, type RichRig as R, createAvatarTestModule as S, type Three as T, UNDEAD_VOICES as U, type VoiceMoment as V, type WoundSpray as W, createCharacterSound as X, createCharactersTestModule as Y, ZOMBIE_ITEM_PREFIX as Z, createFluidsBridge as _, type AvatarViewMode as a, createRigAnimator as a0, personSpecOf as a1, registerBodyMaterial as a2, type ReachView as b, AVATAR_AREA_ID as c, type AreaContext as d, type AvatarEvent as e, type AvatarTestOptions as f, type AvatarUpdate as g, BODY_MATERIAL_DEF as h, BODY_SOUNDS as i, type BloodAge as j, type BloodLookOptions as k, type BloodSink as l, type BodySoundRule as m, CHARACTERS_AREA_ID as n, type CharacterSoundOptions as o, type CharacterSoundSink as p, type CharacterSoundStyle as q, type CharactersTestOptions as r, type FilmSink as s, type FluidsBridgeOptions as t, type HitPreset as u, PERSON_ITEM_PREFIX as v, PLAYER_SOUNDS as w, type PlayPoseOptions as x, type PlayerAvatarColors as y, type PlayerAvatarOptions as z };
+export { type VoiceMoment as $, type ArmRig as A, type BestSpec as B, type CharacterSound as C, type FilmSink as D, type FluidsBridgeOptions as E, type FluidsBridge as F, type HitPreset as G, HIT_PRESETS as H, PERSON_ITEM_PREFIX as I, PLAYER_SOUNDS as J, type PlayPoseOptions as K, type LegRig as L, type PlayerAvatarColors as M, type PlayerAvatarOptions as N, type PlayerAvatarSpec as O, type PersonSpec as P, type PoseTargets as Q, type RichRig as R, type ProfessionCard as S, type Three as T, type RigAnimator as U, type RigAnimatorOptions as V, UNDEAD_VOICES as W, UNDEAD_VOICE_SOURCES as X, type UndeadCard as Y, type UndeadLike as Z, type UndeadVoice as _, type BestPose as a, type VoiceStep as a0, type WoundSpray as a1, ZOMBIE_ITEM_PREFIX as a2, bloodLookOfAge as a3, createAvatarTestModule as a4, createCharacterSound as a5, createCharactersTestModule as a6, createFluidsBridge as a7, createPlayerAvatar as a8, createRigAnimator as a9, personSpecOf as aa, registerBodyMaterial as ab, type PersonCharacter as b, type PersonGroupSpec as c, type PersonExtra as d, type BloodLook as e, type AvatarItemUsePose as f, type AvatarViewMode as g, type ReachView as h, type PlayerAvatar as i, AVATAR_AREA_ID as j, type AreaContext as k, type AvatarEvent as l, type AvatarTestOptions as m, type AvatarUpdate as n, BODY_MATERIAL_DEF as o, BODY_SOUNDS as p, type BloodAge as q, type BloodLookOptions as r, type BloodSink as s, type BodySegment as t, type BodySoundRule as u, CHARACTERS_AREA_ID as v, type CharacterSoundOptions as w, type CharacterSoundSink as x, type CharacterSoundStyle as y, type CharactersTestOptions as z };

package/dist/testing.d.ts

@@ -1,4 +1,5 @@
-export { c as AVATAR_AREA_ID, d as AreaContext, f as AvatarTestOptions, h as BODY_MATERIAL_DEF, n as CHARACTERS_AREA_ID, r as CharactersTestOptions, H as HIT_PRESETS, u as HitPreset, v as PERSON_ITEM_PREFIX, G as ProfessionCard, L as UndeadCard, M as UndeadLike, Z as ZOMBIE_ITEM_PREFIX, S as createAvatarTestModule, Y as createCharactersTestModule, a1 as personSpecOf, a2 as registerBodyMaterial } from './testing-DyQw8dCw.js';
+export { j as AVATAR_AREA_ID, k as AreaContext, m as AvatarTestOptions, o as BODY_MATERIAL_DEF, v as CHARACTERS_AREA_ID, z as CharactersTestOptions, H as HIT_PRESETS, G as HitPreset, I as PERSON_ITEM_PREFIX, S as ProfessionCard, Y as UndeadCard, Z as UndeadLike, a2 as ZOMBIE_ITEM_PREFIX, a4 as createAvatarTestModule, a6 as createCharactersTestModule, aa as personSpecOf, ab as registerBodyMaterial } from './testing-CsC-BhNN.js';
 import '@adatechnology/game-contracts';
 import 'three';
 import '@adatechnology/game-characters';
+import '@adatechnology/game-render-three';

package/dist/testing.js

@@ -9,7 +9,7 @@ import {
   createCharactersTestModule,
   personSpecOf,
   registerBodyMaterial
-} from "./chunk-3CHBEUHW.js";
+} from "./chunk-XSMP7T6O.js";
 export {
   AVATAR_AREA_ID,
   BODY_MATERIAL_DEF,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adatechnology/game-characters-three",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "license": "MIT",
   "description": "three.js presentation for @adatechnology/game-characters: the instanced crowd body (GPU animation, LOD, baking, variants, flying limbs) and the rich bodies (the Bestiário v17 builder, survivors with accessories and hands, the animator, wounds, eyes).",
   "keywords": [
@@ -42,12 +42,12 @@
     "dist"
   ],
   "dependencies": {
-    "@adatechnology/game-audio": "^0.4.0",
-    "@adatechnology/game-characters": "^0.2.8",
+    "@adatechnology/game-audio": "^0.5.0",
+    "@adatechnology/game-characters": "^0.2.9",
     "@adatechnology/game-characters-people": "^0.4.1",
-    "@adatechnology/game-contracts": "^0.22.0",
+    "@adatechnology/game-contracts": "^0.23.0",
     "@adatechnology/game-render-three": "^0.1.0",
-    "@adatechnology/game-shapes-three": "^0.3.0"
+    "@adatechnology/game-shapes-three": "^0.3.1"
   },
   "peerDependencies": {
     "three": "^0.160.0"
@@ -62,7 +62,7 @@
     "vitest": "^3.2.4",
     "@adatechnology/game-characters-undead": "^0.3.0",
     "@adatechnology/game-kit-defaults": "^0.2.0",
-    "@adatechnology/game-test-room": "^0.21.0",
+    "@adatechnology/game-test-room": "^0.22.0",
     "@adatechnology/golden-tool": "^0.0.0"
   },
   "scripts": {