@idosgames/characters 0.0.0-stage → 0.1.0

package/dist/voxel/index.d.cts

@@ -0,0 +1,972 @@
+import * as THREE from 'three';
+import { V as Viseme, E as Emotion, d as ActorPose, A as ActorSocket } from '../contract-DhZuKNIf.cjs';
+export { e as EMOTIONS, i as isEmotion } from '../contract-DhZuKNIf.cjs';
+import { R as RGBAImage } from '../image-D5NaQeFz.cjs';
+
+type V3 = [number, number, number];
+/**
+ * Роль кости — то, к чему обращаются анимации. Анимация «шаг» двигает legL/legR у любого
+ * персонажа, в каком бы файле ни был описан его скелет; свои кости персонажа (хвост, уши, плащ)
+ * получают вторичную анимацию по роли.
+ */
+declare const BONE_ROLES: readonly ["root", "body", "head", "armL", "armR", "legL", "legR", "legFL", "legFR", "legBL", "legBR", "tail", "wingL", "wingR", "ear", "hair", "cape", "antenna", "static"];
+type BoneRole = (typeof BONE_ROLES)[number];
+/** Роли, которые можно дать СВОЕЙ кости рецепта (основные задаёт шаблон). */
+declare const EXTRA_BONE_ROLES: readonly ["tail", "wingL", "wingR", "ear", "hair", "cape", "antenna", "static"];
+type ExtraBoneRole = (typeof EXTRA_BONE_ROLES)[number];
+/**
+ * Сокет — точка, к которой крепится предмет или одежда: рука, макушка, спина… Пояс, плечи и лицо
+ * — для надеваемого (character/items).
+ */
+declare const SOCKETS: readonly ["handR", "handL", "headTop", "face", "back", "waist", "shoulders"];
+type SocketName = (typeof SOCKETS)[number];
+interface RigBone {
+    name: string;
+    role: BoneRole;
+    /** Родитель; null — корень модели (ступни). */
+    parent: string | null;
+    /** Точка вращения в пикселях модели. */
+    pivot: V3;
+}
+interface RigSocket {
+    name: SocketName;
+    bone: string;
+    /** Где в пикселях модели (поворачивается вместе с костью). */
+    at: V3;
+}
+declare const RIG_IDS: readonly ["humanoid", "quadruped", "flyer", "blob"];
+type RigId = (typeof RIG_IDS)[number];
+interface RigTemplate {
+    id: RigId;
+    /** Подпись в студии. */
+    label: string;
+    /** Подсказка модели: кто подходит под шаблон. */
+    hint: string;
+    bones: RigBone[];
+    sockets: RigSocket[];
+    /** Хитбокс NPC/моба в блоках (игрок — всегда 0.6×1.8). */
+    hitbox: {
+        w: number;
+        h: number;
+    };
+    /** Высота глаз в пикселях — куда смотрит камера от третьего лица и откуда «говорит» NPC. */
+    eye: number;
+    /** Пределы роста модели в пикселях (рецепт за ними масштабируется). */
+    height: {
+        min: number;
+        max: number;
+    };
+    /** Тело по умолчанию: персонаж без деталей и путь без ИИ. */
+    defaultParts: CharPart[];
+    /** Кость с лицом. */
+    faceBone: string;
+}
+
+declare const RIGS: Record<RigId, RigTemplate>;
+
+declare const CHARACTER_SPEC_VERSION: 1;
+/** Грани коробки: front смотрит туда же, куда лицо (−z), left — на левую руку персонажа (−x). */
+declare const FACE_NAMES: readonly ["front", "back", "left", "right", "top", "bottom"];
+type FaceName = (typeof FACE_NAMES)[number];
+/**
+ * Выражения лица. Обязательно только neutral — остальные, если их нет, берутся по цепочке замен
+ * (anim/emotions.ts): «испуган» без своей картинки — «удивлён», без неё — обычное лицо.
+ */
+declare const EXPRESSIONS: readonly ["neutral", "blink", "happy", "sad", "angry", "surprised", "scared", "tired", "hurt", "talk"];
+type Expression = (typeof EXPRESSIONS)[number];
+declare const WALK_STYLES: readonly ["normal", "bouncy", "heavy", "sneaky", "robotic"];
+type WalkStyle = (typeof WALK_STYLES)[number];
+declare const IDLE_STYLES: readonly ["calm", "fidgety", "proud"];
+type IdleStyle = (typeof IDLE_STYLES)[number];
+declare const CHARACTER_LIMITS: {
+    readonly parts: 64;
+    readonly bones: 16;
+    readonly palette: 32;
+    readonly textures: 48;
+    /** Всего пикселей во всех текстурах. */
+    readonly texturePixels: 32768;
+    /** Сторона одной текстуры. */
+    readonly textureSide: 32;
+    /** Сторона коробки и координаты — в пикселях модели. */
+    readonly partSide: 32;
+    readonly coord: 64;
+};
+/** Картинка из символов палитры; "." и пробел — прозрачно. rows[0] — верхняя строка. */
+interface PixelTex {
+    w: number;
+    h: number;
+    rows: string[];
+}
+interface CharPart {
+    /** Кость, вместе с которой двигается коробка. */
+    bone: string;
+    /** [ширина x, высота y, глубина z] в пикселях. */
+    size: V3;
+    /** Центр коробки в пикселях модели. */
+    pos: V3;
+    /** Символ палитры — цвет граней без своей текстуры. */
+    color: string;
+    /** Грань → id текстуры или символ палитры. */
+    faces?: Partial<Record<FaceName, string>>;
+    /** Поворот коробки вокруг её центра, градусы [x, y, z]. */
+    rot?: V3;
+    /** Ещё одна такая же коробка зеркально по x (на парную кость: armL ↔ armR). */
+    mirror?: boolean;
+    name?: string;
+}
+/** Своя кость рецепта: хвост, уши, плащ… Или новая точка вращения кости шаблона (то же имя). */
+interface ExtraBone {
+    name: string;
+    parent: string;
+    pivot: V3;
+    role: ExtraBoneRole;
+}
+interface FaceSpec {
+    /** Кость с лицом (по умолчанию — голова шаблона). */
+    bone: string;
+    /**
+     * Где на передней грани главной коробки кости: [x, y, w, h] в пикселях, от левого верхнего угла
+     * так, как лицо видит смотрящий на персонажа.
+     */
+    rect: [number, number, number, number];
+    /** Выражение → id текстуры размером w×h. */
+    expressions: Partial<Record<Expression, string>>;
+}
+interface CharStyle {
+    walk: WalkStyle;
+    idle: IdleStyle;
+    /** 0 — вялый, 1 — заводной: темп и размах движений. */
+    energy: number;
+}
+/**
+ * Отделка граней — то, что превращает плоские цвета в «ткань» (как на референсе владельца
+ * 11.10.2026): мелкий шум и пятна, тёмный контур по краю каждой грани, светотень сверху вниз.
+ * Применяется к каждой грани при сборке (character/layout); модель ИИ задаёт только силу.
+ */
+interface CharFinish {
+    /** Шум ткани 0..1. */
+    noise: number;
+    /** Тёмный контур по краю грани 0..1. */
+    outline: number;
+    /** Светотень: верх светлее, низ темнее 0..1. */
+    shade: number;
+    /** Текселей на пиксель модели у граней без своей картинки (1..4). */
+    density: number;
+}
+declare const DEFAULT_FINISH: CharFinish;
+interface CharacterSpec {
+    version: typeof CHARACTER_SPEC_VERSION;
+    name: string;
+    description: string;
+    rig: RigId;
+    /** Масштаб модели (рост NPC и мобов; игроку — в пределах 0.8–1.15). */
+    scale: number;
+    /** Символ → "#rrggbb". */
+    palette: Record<string, string>;
+    textures: Record<string, PixelTex>;
+    parts: CharPart[];
+    bones: ExtraBone[];
+    face: FaceSpec | null;
+    style: CharStyle;
+    /** Высота голоса (звуки, будущая речь NPC). */
+    voice: {
+        pitch: number;
+    };
+    /** Метки для поиска и будущего поведения NPC ("friendly", "merchant"…). */
+    tags: string[];
+    finish: CharFinish;
+}
+type CharacterParseResult = {
+    ok: true;
+    spec: CharacterSpec;
+    warnings: string[];
+} | {
+    ok: false;
+    error: string;
+    truncated?: boolean;
+};
+type Obj = Record<string, unknown>;
+declare const isObj: (v: unknown) => v is Obj;
+declare function num(v: unknown, def: number, min: number, max: number): number;
+declare function pick<T extends string>(v: unknown, allowed: readonly T[], def: T): T;
+declare function vec3(v: unknown, lim: number, def?: V3 | null): V3 | null;
+/** "#abc", "#aabbcc", "aabbcc", имя цвета → "#aabbcc"; иначе null. */
+declare function normColor(v: unknown): string | null;
+/** Прозрачные символы пиксель-арта. */
+declare const CLEAR: Set<string>;
+/** Парная кость: armL ↔ armR, legFL ↔ legFR, earL ↔ earR; нет пары — та же. */
+declare function mirrorBone(name: string, exists: (n: string) => boolean): string;
+/**
+ * Единственная дверь в игру для рецепта персонажа: объект или текст ответа модели → нормализованный
+ * рецепт. Отказ — только если это не объект или оборванный JSON.
+ */
+declare function parseCharacterSpec(input: unknown): CharacterParseResult;
+/** Цвета тела шаблона по умолчанию: s — кожа/голова, t — туловище, p — ноги. */
+declare const DEFAULT_COLORS: Record<string, string>;
+/** JSON с отсортированными ключами: одинаковый рецепт → одинаковая строка (и хэш). */
+declare function stableStringify(v: unknown): string;
+/** Хэш рецепта (16 hex): ключ кэша модели, сетевой «облик», id своего моба. */
+declare function specHash(spec: unknown): string;
+/** Шаблон рецепта. */
+declare function rigOfSpec(spec: CharacterSpec): RigTemplate;
+/** Все кости рецепта (шаблон + свои) с итоговыми точками вращения и ролями. */
+declare function bonesOf(spec: CharacterSpec): {
+    name: string;
+    role: string;
+    parent: string | null;
+    pivot: V3;
+}[];
+/** Имя персонажа без имени — на языке игры; Мастерская узнаёт его на обоих языках. */
+declare function defaultCharacterName(): string;
+/** Это имя по умолчанию (на любом языке)? */
+declare const isDefaultCharacterName: (n: string) => boolean;
+
+interface BoneGeo {
+    name: string;
+    role: string;
+    parent: string | null;
+    /** Точка вращения в пикселях модели. */
+    pivot: V3;
+    /** Вершины относительно pivot, пиксели. */
+    positions: Float32Array;
+    normals: Float32Array;
+    uvs: Float32Array;
+    indices: Uint16Array;
+}
+interface FaceDecal {
+    bone: string;
+    /** 4 угла квада (TL, TR, BR, BL снаружи) относительно pivot кости, пиксели. */
+    corners: Float32Array;
+    /** Выражение → [u0, v0, u1, v1] в атласе. */
+    uv: Partial<Record<Expression, [number, number, number, number]>>;
+}
+interface CharacterLayout {
+    hash: string;
+    rig: CharacterSpec["rig"];
+    bones: BoneGeo[];
+    atlas: {
+        w: number;
+        h: number;
+        data: Uint8Array;
+    };
+    face: FaceDecal | null;
+    /** Сокеты относительно pivot своей кости, пиксели. */
+    sockets: {
+        name: SocketName;
+        bone: string;
+        at: V3;
+    }[];
+    /** Рост модели (верх самой высокой коробки), пиксели. */
+    height: number;
+    /** Множитель пикселей модели: масштаб рецепта × подгонка роста под пределы шаблона. */
+    scale: number;
+    /** Высота глаз, пиксели модели. */
+    eye: number;
+}
+declare function layoutCharacter(spec: CharacterSpec): CharacterLayout;
+
+interface CharacterAsset {
+    readonly layout: CharacterLayout;
+    /** Кость → геометрия (у кости без коробок — null). */
+    readonly geometries: Map<string, THREE.BufferGeometry | null>;
+    readonly texture: THREE.DataTexture;
+    refs: number;
+}
+/** Ресурсы рецепта (общие для всех персонажей с тем же рецептом). Отдать — releaseCharacter. */
+declare function acquireCharacter(spec: CharacterSpec): CharacterAsset;
+declare function releaseCharacter(a: CharacterAsset): void;
+
+declare const CH: {
+    readonly rx: 0;
+    readonly ry: 1;
+    readonly rz: 2;
+    readonly px: 3;
+    readonly py: 4;
+    readonly pz: 5;
+    readonly sx: 6;
+    readonly sy: 7;
+    readonly sz: 8;
+};
+type Channel = keyof typeof CH;
+declare const CHANNELS: Channel[];
+/** Значения покоя каналов (масштаб — 1). */
+declare const REST: readonly [0, 0, 0, 0, 0, 0, 1, 1, 1];
+/** Поза: роль → 9 каналов. Нет роли — кость в покое. */
+type Pose = Map<string, Float64Array>;
+declare function bone(pose: Pose, role: string): Float64Array;
+/** Прибавить к каналу (масштаб — умножить). */
+declare function add(pose: Pose, role: string, ch: Channel, v: number): void;
+declare function setCh(pose: Pose, role: string, ch: Channel, v: number): void;
+declare function clearPose(pose: Pose): void;
+/** out = a + (b − a)·w по всем ролям обеих поз (нет роли — покой). */
+declare function lerpPose(out: Pose, a: Pose, b: Pose, w: number): void;
+declare function copyPose(out: Pose, src: Pose): void;
+/** Что персонаж держит — от этого поза руки и действия (лук натягивают, щит держат). */
+declare const HELD_KINDS: readonly ["none", "block", "tool", "sword", "bow", "shield", "food", "staff", "item"];
+type HeldKind = (typeof HELD_KINDS)[number];
+/** Действие «держать ПКМ». */
+type UseAction = "eat" | "drink" | "draw" | "block";
+/**
+ * Всё, что анимация знает о персонаже за кадр. Заполняют: свой игрок (Player), сетевой
+ * (RemotePlayer по позе), NPC и моб. Новое состояние игры — новое поле здесь, потребители не
+ * меняются: у кого поля нет, у того оно в значении по умолчанию (newAnimInput).
+ */
+interface AnimInput {
+    /** Горизонтальная скорость, блоков/с. */
+    speed: number;
+    /** Вертикальная скорость, блоков/с. */
+    vy: number;
+    onGround: boolean;
+    inWater: boolean;
+    flying: boolean;
+    gliding: boolean;
+    sneaking: boolean;
+    sprinting: boolean;
+    riding: boolean;
+    sitting: boolean;
+    sleeping: boolean;
+    dead: boolean;
+    /** Голова относительно тела: поворот (влево +) и наклон (вверх +), радианы. */
+    lookYaw: number;
+    lookPitch: number;
+    /** Скорость поворота тела, рад/с (вторичное качание хвоста и плаща). */
+    yawRate: number;
+    held: HeldKind;
+    use: UseAction | null;
+    /** Говорит — рот открывается (речь ИИ-NPC, чат). */
+    talk: boolean;
+    /** Форма рта по тексту реплики (ролик, lipsync); задана — вместо `talk`. */
+    viseme?: Viseme;
+}
+declare function newAnimInput(): AnimInput;
+/** Разовые события кадра: замах, удар по персонажу, приземление… */
+declare const ANIM_EVENTS: readonly ["swing", "hurt", "place", "land", "jump", "throw"];
+type AnimEvent = (typeof ANIM_EVENTS)[number];
+
+interface CharacterViewOptions {
+    /** Табличка с именем над головой (сетевые игроки, NPC). */
+    name?: string | null;
+    /** Отбрасывает тень (дальние персонажи — нет). */
+    shadows?: boolean;
+    /** Слой рендера (кукла в инвентаре рисуется отдельной сценой — не нужен). */
+    layer?: number;
+}
+declare class CharacterView {
+    readonly group: THREE.Group<THREE.Object3DEventMap>;
+    private readonly root;
+    private asset;
+    spec: CharacterSpec;
+    private bones;
+    /** Кости по ролям (у одной роли может быть несколько костей: два уха). */
+    private byRole;
+    private meshes;
+    private readonly material;
+    private readonly decalMat;
+    private decal;
+    private expression;
+    private readonly sockets;
+    /** То, что висит на сокетах — переживает смену рецепта. */
+    private readonly attached;
+    private label;
+    private shadows;
+    private readonly layer;
+    private brightness;
+    constructor(spec?: CharacterSpec, opts?: CharacterViewOptions);
+    /** Рост модели в блоках. */
+    get height(): number;
+    /** Высота глаз в блоках. */
+    get eye(): number;
+    /** Какие выражения нарисованы в рецепте (для аниматора). */
+    get expressions(): Expression[];
+    get hash(): string;
+    /** Подменить рецепт (облик пришёл по сети, игрок сменил персонажа). Одежда и предметы остаются. */
+    setSpec(spec: CharacterSpec): void;
+    private build;
+    /** Снять всё, кроме того, что висит на сокетах (его переносит build). */
+    private clear;
+    applyPose(pose: Pose): void;
+    setExpression(e: Expression): void;
+    /** Свет места (как у мобов: пещера темнее). */
+    setBrightness(b: number): void;
+    /** Вспышка урона и прочие подсветки: 0 — без подсветки. */
+    setEmissive(hex: number): void;
+    setShadows(on: boolean): void;
+    /** Повесить предмет/одежду на сокет (координаты объекта — в блоках). null — снять. */
+    attach(socket: SocketName, obj: THREE.Object3D | null): void;
+    attachedAt(socket: SocketName): THREE.Object3D | null;
+    setName(name: string | null): void;
+    setLabelVisible(on: boolean): void;
+    private placeLabel;
+    /** Все меши модели (кукла инвентаря красит их в свой слой). */
+    forEachMesh(fn: (m: THREE.Mesh) => void): void;
+    dispose(): void;
+}
+
+/** Основные цвета «Путника» — остальные оттенки выводятся из них. */
+interface LookColors {
+    skin?: string;
+    hair?: string;
+    shirt?: string;
+    pants?: string;
+    boots?: string;
+    eyes?: string;
+}
+/** Перекрасить палитру «Путника»: базовый цвет и согласованные с ним оттенки. */
+declare function recolor(palette: Record<string, string>, c: LookColors): Record<string, string>;
+declare const HUMAN_TOPS: readonly ["shirt", "tee", "sweater"];
+declare const HUMAN_BOTTOMS: readonly ["pants", "shorts"];
+declare const HUMAN_SHOES: readonly ["boots", "sneakers"];
+declare const HUMAN_HAIR: readonly ["short", "long", "curly", "none"];
+/** Наряд человека из набора частей — разнообразие NPC и основа пути без ИИ. */
+interface HumanLook {
+    top?: (typeof HUMAN_TOPS)[number];
+    bottom?: (typeof HUMAN_BOTTOMS)[number];
+    shoes?: (typeof HUMAN_SHOES)[number];
+    hair?: (typeof HUMAN_HAIR)[number];
+    hat?: boolean;
+    colors?: LookColors & {
+        hat?: string;
+    };
+    name?: string;
+    description?: string;
+    tags?: string[];
+}
+/** Рецепт человека в детальном стиле: голова, волосы, нос, наряд, обувь, по желанию шляпа. */
+declare function humanSource(look?: HumanLook): {
+    version: number;
+    name: string;
+    description: string;
+    rig: string;
+    palette: Record<string, string>;
+    textures: Record<string, PixelTex>;
+    parts: Record<string, unknown>[];
+    face: {
+        bone: string;
+        rect: number[];
+        expressions: {
+            neutral: string;
+            blink: string;
+            happy: string;
+            sad: string;
+            angry: string;
+            surprised: string;
+            scared: string;
+            tired: string;
+            hurt: string;
+            talk: string;
+        };
+    };
+    style: {
+        walk: string;
+        idle: string;
+        energy: number;
+    };
+    finish: {
+        noise: number;
+        outline: number;
+        shade: number;
+        density: number;
+    };
+    tags: string[];
+};
+/**
+ * Лицо «Путника» для любого рецепта: текстуры всех выражений (16×10, тот же рисунок глаз, бровей и
+ * рта) и FaceSpec на прямоугольник `rect` передней грани кости `bone`. Цвета лица — символы палитры
+ * k (брови), w (белки), b (радужка), m (губы), o (открытый рот).
+ */
+declare function standardFace(bone: string, rect: [number, number, number, number]): {
+    textures: {
+        [k: string]: PixelTex;
+    };
+    face: {
+        bone: string;
+        rect: [number, number, number, number];
+        expressions: {
+            neutral: string;
+            blink: string;
+            happy: string;
+            sad: string;
+            angry: string;
+            surprised: string;
+            scared: string;
+            tired: string;
+            hurt: string;
+            talk: string;
+        };
+    };
+};
+declare const DEFAULT_CHARACTER_SOURCE: {
+    version: number;
+    name: string;
+    description: string;
+    rig: string;
+    palette: Record<string, string>;
+    textures: Record<string, PixelTex>;
+    parts: Record<string, unknown>[];
+    face: {
+        bone: string;
+        rect: number[];
+        expressions: {
+            neutral: string;
+            blink: string;
+            happy: string;
+            sad: string;
+            angry: string;
+            surprised: string;
+            scared: string;
+            tired: string;
+            hurt: string;
+            talk: string;
+        };
+    };
+    style: {
+        walk: string;
+        idle: string;
+        energy: number;
+    };
+    finish: {
+        noise: number;
+        outline: number;
+        shade: number;
+        density: number;
+    };
+    tags: string[];
+};
+/** Рецепт «Путника» (разобран один раз; не менять — отдавайте копию, если надо править). */
+declare function defaultCharacter(): CharacterSpec;
+
+declare class Art {
+    readonly w: number;
+    readonly h: number;
+    private readonly g;
+    constructor(w: number, h: number, fill?: string);
+    px(x: number, y: number, c: string): this;
+    rect(x: number, y: number, w: number, h: number, c: string): this;
+    /** Горизонтальная линия от x0 до x1 включительно. */
+    row(y: number, x0: number, x1: number, c: string): this;
+    /** Вертикальная линия от y0 до y1 включительно. */
+    col(x: number, y0: number, y1: number, c: string): this;
+    /** Каждая клетка, где f(x, y) — правда, получает цвет c (штриховка, пряди, блики). */
+    where(f: (x: number, y: number) => boolean, c: string): this;
+    /** Зеркальная копия по горизонтали (левая и правая грань одной коробки). */
+    flipped(): Art;
+    tex(): PixelTex;
+}
+
+declare function nameplate(text: string): THREE.Sprite;
+declare function disposeNameplate(s: THREE.Sprite): void;
+
+declare function registerCharacter(spec: CharacterSpec): string;
+declare function characterOf(hash: unknown): CharacterSpec | undefined;
+declare function characterSpecs(hashes: Iterable<string>): Record<string, CharacterSpec>;
+/** Подписка: рецепт стал известен (дошёл по сети). Возвращает отписку. */
+declare function onCharacterKnown(fn: (hash: string) => void): () => void;
+
+declare function npcCharacter(name: string, role?: string, persona?: string): CharacterSpec;
+
+type RGB = [number, number, number];
+/** Цвета полос фигуры сверху вниз (доли высоты фигуры). */
+declare function bandColors(img: RGBAImage, bands: readonly [number, number][]): (RGB | null)[];
+/**
+ * Персонаж по картинке: человек — «Путник» в цветах картинки; другие шаблоны — их тело по
+ * умолчанию в цветах полос (верх — голова, середина — тело, низ — лапы).
+ */
+declare function characterFromImage(img: RGBAImage, rig?: RigId, name?: string): CharacterSpec;
+
+/** Параметры походки из стиля рецепта. */
+interface StyleParams {
+    /** Размах ног и рук. */
+    amp: number;
+    arm: number;
+    /** Подпрыгивание при шаге, пиксели. */
+    bob: number;
+    /** Темп шага. */
+    tempo: number;
+    /** Раскачка корпуса. */
+    sway: number;
+    /** Шаг рывками (робот). */
+    quant: boolean;
+    /** Дыхание, переминание, грудь колесом. */
+    breath: number;
+    fidget: number;
+    chest: number;
+}
+declare function styleParams(s: CharStyle): StyleParams;
+interface ClipCtx {
+    /** Секунд в состоянии / с начала действия. */
+    t: number;
+    /** Доля действия 0..1 (у бесконечных — 0). */
+    k: number;
+    /** Фаза шага, радианы (растёт с пройденным путём). */
+    phase: number;
+    input: AnimInput;
+    style: StyleParams;
+    /** Время с создания аниматора — для дыхания и колыханий, которые не сбрасываются. */
+    clock: number;
+}
+type ClipFn = (out: Pose, c: ClipCtx) => void;
+declare const CLIPS: {
+    idle: ClipFn;
+    walk: ClipFn;
+    run: ClipFn;
+    sneak: ClipFn;
+    swim: ClipFn;
+    fly: ClipFn;
+    glide: ClipFn;
+    fall: ClipFn;
+    sit: ClipFn;
+    ride: ClipFn;
+    sleep: ClipFn;
+    dead: ClipFn;
+    hop: ClipFn;
+    swing: ClipFn;
+    place: ClipFn;
+    throw: ClipFn;
+    hurt: ClipFn;
+    land: ClipFn;
+    eat: ClipFn;
+    drink: ClipFn;
+    draw: ClipFn;
+    block: ClipFn;
+};
+type ClipId = keyof typeof CLIPS;
+/** Подмена клипа состояния для шаблона: у капли ходьба и бег — прыжки. */
+declare const RIG_CLIPS: Partial<Record<RigId, Partial<Record<ClipId, ClipId>>>>;
+/** Длительность разовых действий, с. */
+declare const ACTION_TIME: Partial<Record<ClipId, number>>;
+
+/** Какое выражение лица искать для эмоции — первое, что есть в рецепте. */
+declare const EXPRESSION_CHAIN: Record<Emotion, Expression[]>;
+interface Posture {
+    /** "роль.канал" → добавка. */
+    add: Partial<Record<string, number>>;
+    /** Множитель темпа движений. */
+    tempo: number;
+}
+declare const POSTURE: Record<Emotion, Posture>;
+/** Добавить осанку эмоции к позе с весом w (переход между эмоциями плавный). */
+declare function applyPosture(out: Pose, e: Emotion, w: number): void;
+/**
+ * Игровые события → эмоция. seconds — вспышка на время; без seconds — фоновое настроение, пока
+ * условие держится. Таблица — данные: новое событие игры — строка здесь и emit в game/wire.
+ */
+declare const EMOTION_EVENTS: {
+    damaged: {
+        emotion: "hurt";
+        seconds: number;
+    };
+    lowHealth: {
+        emotion: "tired";
+    };
+    nearDeath: {
+        emotion: "scared";
+    };
+    achievement: {
+        emotion: "happy";
+        seconds: number;
+    };
+    bossKilled: {
+        emotion: "happy";
+        seconds: number;
+    };
+    tamed: {
+        emotion: "happy";
+        seconds: number;
+    };
+    traded: {
+        emotion: "happy";
+        seconds: number;
+    };
+    petDied: {
+        emotion: "sad";
+        seconds: number;
+    };
+    explosion: {
+        emotion: "surprised";
+        seconds: number;
+    };
+};
+type EmotionEvent = keyof typeof EMOTION_EVENTS;
+/** Смайлик в сообщении чата → эмоция (последний найденный); null — нет смайликов. */
+declare function emotionFromText(text: string): Emotion | null;
+
+type Track = [number, number][];
+interface EmoteDef {
+    label: string;
+    /** Длительность цикла, с. */
+    duration: number;
+    /** Повторяется, пока персонаж не двинется. */
+    loop?: boolean;
+    /** Лицо на время жеста. */
+    emotion?: Emotion;
+    /** "роль.канал" → ключи. */
+    tracks: Record<string, Track>;
+}
+declare const EMOTES: {
+    wave: {
+        label: string;
+        duration: number;
+        emotion: "happy";
+        tracks: {
+            "armR.rz": [number, number][];
+            "armR.rx": [number, number][];
+            "head.rz": [number, number][];
+        };
+    };
+    cheer: {
+        label: string;
+        duration: number;
+        emotion: "happy";
+        tracks: {
+            "armL.rz": [number, number][];
+            "armR.rz": [number, number][];
+            "root.py": [number, number][];
+        };
+    };
+    dance: {
+        label: string;
+        duration: number;
+        loop: true;
+        emotion: "happy";
+        tracks: {
+            "root.ry": [number, number][];
+            "armL.rz": [number, number][];
+            "armR.rz": [number, number][];
+            "legL.rx": [number, number][];
+            "legR.rx": [number, number][];
+            "root.py": [number, number][];
+            "tail.ry": [number, number][];
+        };
+    };
+    point: {
+        label: string;
+        duration: number;
+        tracks: {
+            "armR.rx": [number, number][];
+        };
+    };
+    laugh: {
+        label: string;
+        duration: number;
+        emotion: "happy";
+        tracks: {
+            "body.rx": [number, number][];
+            "head.rx": [number, number][];
+            "armL.rx": [number, number][];
+            "armR.rx": [number, number][];
+        };
+    };
+    cry: {
+        label: string;
+        duration: number;
+        emotion: "sad";
+        tracks: {
+            "head.rx": [number, number][];
+            "head.rz": [number, number][];
+            "armR.rx": [number, number][];
+            "armR.ry": [number, number][];
+            "armL.rx": [number, number][];
+            "armL.ry": [number, number][];
+        };
+    };
+    bow: {
+        label: string;
+        duration: number;
+        tracks: {
+            "body.rx": [number, number][];
+            "armR.rx": [number, number][];
+        };
+    };
+    shrug: {
+        label: string;
+        duration: number;
+        tracks: {
+            "armL.rz": [number, number][];
+            "armR.rz": [number, number][];
+            "armL.rx": [number, number][];
+            "armR.rx": [number, number][];
+            "head.rz": [number, number][];
+        };
+    };
+    facepalm: {
+        label: string;
+        duration: number;
+        emotion: "tired";
+        tracks: {
+            "armR.rx": [number, number][];
+            "armR.rz": [number, number][];
+            "head.rx": [number, number][];
+        };
+    };
+    sit: {
+        label: string;
+        duration: number;
+        loop: true;
+        tracks: {
+            "legL.rx": [number, number][];
+            "legR.rx": [number, number][];
+            "root.py": [number, number][];
+        };
+    };
+};
+type EmoteId = keyof typeof EMOTES;
+declare const EMOTE_IDS: EmoteId[];
+declare function isEmote(v: unknown): v is EmoteId;
+/** Значение дорожки в момент t (между ключами — smoothstep). */
+declare function sampleTrack(track: Track, t: number): number;
+/** Поза жеста в момент t (у повторяющегося — по модулю длительности). */
+declare function sampleEmote(out: Pose, def: EmoteDef, t: number): void;
+
+type LocoState = "idle" | "walk" | "run" | "sneak" | "swim" | "fly" | "glide" | "fall" | "ride" | "sit" | "sleep" | "dead";
+interface LocoRule {
+    state: LocoState;
+    when: (i: AnimInput, a: Animator) => boolean;
+    clip: ClipId;
+    /** Время перехода В это состояние, с. */
+    blend: number;
+}
+/** Граф передвижения: первое подходящее правило сверху. */
+declare const LOCOMOTION: LocoRule[];
+declare class Animator {
+    readonly rig: RigId;
+    private style;
+    /** Какие выражения нарисованы в рецепте. */
+    private readonly faces;
+    /** Итоговая поза кадра (роль → каналы). */
+    readonly pose: Pose;
+    /** Выражение лица кадра. */
+    expression: Expression;
+    state: LocoState;
+    private stateT;
+    private clock;
+    private phase;
+    airTime: number;
+    private wasOnGround;
+    private readonly loco;
+    private readonly from;
+    private readonly lastLoco;
+    private blendT;
+    private blendDur;
+    private readonly tmp;
+    private actions;
+    private useClip;
+    private useW;
+    private emote;
+    /** Фоновое настроение и вспышка поверх него. */
+    private mood;
+    private flash;
+    private readonly postureW;
+    private blinkT;
+    private blinking;
+    private talkT;
+    private readonly springs;
+    constructor(rig: RigId, style: CharStyle, faces?: Iterable<Expression>);
+    /** Источник случая для моргания (по умолчанию Math.random); ролик даёт сидированный — кадр
+     *  одинаков при каждом рендере. */
+    setRandom(random: () => number): void;
+    private random;
+    setStyle(style: CharStyle): void;
+    /** Эмоция: с seconds — вспышка на время, без — настроение до следующей смены. */
+    setEmotion(e: Emotion, seconds?: number): void;
+    /** Эмоция, которую сейчас показывает персонаж. */
+    get emotion(): Emotion;
+    get emoting(): EmoteId | null;
+    playEmote(id: EmoteId): void;
+    stopEmote(): void;
+    /** Разовое событие: замах, удар по персонажу, приземление… */
+    trigger(ev: AnimEvent): void;
+    update(dt: number, input?: AnimInput): Pose;
+    /** Наложить позу: перекрыть роли с весом w или прибавить отклонения от покоя. */
+    private overlay;
+    /** Выражение лица: эмоция по цепочке замен, моргание, рот при разговоре. */
+    private face;
+}
+
+interface VoxelActorOptions extends CharacterViewOptions {
+    /** Сид случая (моргание). */
+    seed?: number;
+}
+declare class VoxelActor {
+    readonly view: CharacterView;
+    private animator;
+    private readonly input;
+    private readonly seed;
+    private pose;
+    private jumpT;
+    constructor(spec?: CharacterSpec, opts?: VoxelActorOptions);
+    get group(): THREE.Group;
+    /** Рост в единицах сцены (блоках). */
+    get height(): number;
+    setSpec(spec: CharacterSpec): void;
+    setEmotion(e: Emotion): void;
+    /** Форма рта по тексту реплики; "rest" — рот закрыт. */
+    setViseme(v: Viseme): void;
+    /** Поза контракта: состояние движения держится, жест играется один раз. */
+    setPose(pose: ActorPose): void;
+    playEmote(id: EmoteId): void;
+    /** Повесить пропс на сокет; null — снять. */
+    attach(socket: ActorSocket, obj: THREE.Object3D | null): void;
+    update(dt: number): void;
+    dispose(): void;
+    private newAnimator;
+}
+
+declare const VOXEL_CHARACTER_SYSTEM_PROMPT: string;
+
+declare const CREATURE_KINDS: readonly ["cat", "dog", "fox", "bear", "rabbit", "bird", "dragon", "slime", "ghost", "robot"];
+type CreatureKind = (typeof CREATURE_KINDS)[number];
+interface CreatureLook {
+    kind: CreatureKind;
+    name: string;
+    description?: string;
+    /** Основной цвет, светлый (морда, живот) и акцент (уши, нос, лапы). */
+    body: string;
+    light?: string;
+    accent?: string;
+    eyes?: string;
+    tags?: string[];
+}
+type Part = Record<string, unknown>;
+declare function creatureSource(look: CreatureLook): {
+    version: number;
+    name: string;
+    description: string;
+    rig: string;
+    palette: Record<string, string>;
+    textures: {
+        [k: string]: PixelTex;
+    };
+    parts: Part[];
+    face: {
+        bone: string;
+        rect: [number, number, number, number];
+        expressions: {
+            neutral: string;
+            blink: string;
+            happy: string;
+            sad: string;
+            angry: string;
+            surprised: string;
+            scared: string;
+            tired: string;
+            hurt: string;
+            talk: string;
+        };
+    };
+    style: {
+        walk: string;
+        idle: string;
+        energy: number;
+    };
+    finish: {
+        noise: number;
+        outline: number;
+        shade: number;
+        density: number;
+    };
+    tags: string[];
+};
+/** Разобранный рецепт существа; сломанный (не должно быть) — ошибка сразу, а не тихий «Путник». */
+declare function creatureCharacter(look: CreatureLook): CharacterSpec;
+
+export { ACTION_TIME, ANIM_EVENTS, type AnimEvent, type AnimInput, Animator, Art, BONE_ROLES, type BoneGeo, type BoneRole, CH, CHANNELS, CHARACTER_LIMITS, CHARACTER_SPEC_VERSION, CLEAR, CLIPS, CREATURE_KINDS, type Channel, type CharFinish, type CharPart, type CharStyle, type CharacterAsset, type CharacterLayout, type CharacterParseResult, type CharacterSpec, CharacterView, type CharacterViewOptions, type ClipCtx, type ClipFn, type ClipId, type CreatureKind, type CreatureLook, DEFAULT_CHARACTER_SOURCE, DEFAULT_COLORS, DEFAULT_FINISH, EMOTES, EMOTE_IDS, EMOTION_EVENTS, EXPRESSIONS, EXPRESSION_CHAIN, EXTRA_BONE_ROLES, type EmoteDef, type EmoteId, Emotion, type EmotionEvent, type Expression, type ExtraBone, type ExtraBoneRole, FACE_NAMES, type FaceDecal, type FaceName, type FaceSpec, HELD_KINDS, HUMAN_BOTTOMS, HUMAN_HAIR, HUMAN_SHOES, HUMAN_TOPS, type HeldKind, type HumanLook, IDLE_STYLES, type IdleStyle, LOCOMOTION, type LocoState, type LookColors, POSTURE, type PixelTex, type Pose, type Posture, REST, RIGS, RIG_CLIPS, RIG_IDS, type RigBone, type RigId, type RigSocket, type RigTemplate, SOCKETS, type SocketName, type StyleParams, type Track, type UseAction, type V3, VOXEL_CHARACTER_SYSTEM_PROMPT, VoxelActor, type VoxelActorOptions, WALK_STYLES, type WalkStyle, acquireCharacter, add, applyPosture, bandColors, bone, bonesOf, characterFromImage, characterOf, characterSpecs, clearPose, copyPose, creatureCharacter, creatureSource, defaultCharacter, defaultCharacterName, disposeNameplate, emotionFromText, humanSource, isDefaultCharacterName, isEmote, isObj, layoutCharacter, lerpPose, mirrorBone, nameplate, newAnimInput, normColor, npcCharacter, num, onCharacterKnown, parseCharacterSpec, pick, recolor, registerCharacter, releaseCharacter, rigOfSpec, sampleEmote, sampleTrack, setCh, specHash, stableStringify, standardFace, styleParams, vec3 };