@idosgames/characters 0.0.0-stage → 0.1.0

package/dist/rig2d/index.d.cts

@@ -0,0 +1,190 @@
+import { S as Skeleton, d as Slot, e as Attachment, R as RigDef, f as ArtPack, g as ArtDef, h as ArtStyle, P as PartsManager, a as Animator, A as ArtCatalog, C as CharacterLook, b as PlayOptions, c as AnimationEvent } from '../PartsManager-Cn3MU-VS.cjs';
+export { i as Animation, j as ArtId, B as BlinkOptions, k as Bone, l as BoneId, m as Color, n as ColorTargetDef, o as ColorTargetId, E as EditorGroup, p as ExpressionsDef, H as Hex, L as LOOK_VERSION, q as PartTypeDef, r as PartTypeId, s as PartsChange, t as PartsRule, u as Rng, v as RuleView, w as SkeletonData, x as Skin, W as WHITE, y as bothHands, z as colorOf, D as defineRig, F as hexToNumber, G as imageSizes, I as mergeLooks, J as numberToHex, K as parseLook, M as pick, N as readSkeletonData, O as seedOf, Q as seededRandom, T as skinImages, U as swapUnder } from '../PartsManager-Cn3MU-VS.cjs';
+export { H as HERO_PRESETS, L as LookPreset, P as PictureArt, T as ThumbnailBackdrop, a as ThumbnailRequest, b as Thumbnailer, c as createThumbnailer, v as vectorPictures } from '../thumbnail-BhGEEXux.cjs';
+import '../contract-DhZuKNIf.cjs';
+
+interface Geometry {
+    /** x, y per vertex, world space. */
+    positions: Float32Array;
+    uvs: Float32Array;
+    triangles: Uint16Array;
+}
+/** Writes the attachment's world vertices into `out` (resized as needed); returns the geometry. */
+declare function worldGeometry(sk: Skeleton, slot: Slot, attachment: Attachment, out: Float32Array | null): Geometry;
+
+declare const RANGED_ANIMATIONS: {
+    /** A staff: raised high, then thrust at the enemy — the spell leaves at its point. */
+    readonly cast: "Cast";
+    readonly bow: "ShootBow";
+    readonly crossbow: "ShootCrossbow";
+    readonly pistol: "ShootPistol";
+    readonly musket: "ShootMusket";
+    /** A burst: three kicks of the gun (one shot event — the game shoots once per attack). */
+    readonly burst: "ShootBurst";
+};
+/** What a hero's shot looks like in flight: an arrow, a crossbow bolt, a bullet; for a melee weapon
+ *  (the idle fight is ranged) the wave of its blow — a crescent from a swing, a spike from a stab; the
+ *  game's own glowing orb for magic and bare hands. */
+type ShotKind = "arrow" | "bolt" | "bullet" | "slash" | "thrust" | "orb";
+
+declare const HERO_ANIMATIONS: {
+    readonly idle: "Idle";
+    /** Idle now and then: a look up and around. */
+    readonly look: "Look";
+    readonly walk: "Walk";
+    readonly run: "Run";
+    /** A run with a weapon held ready. */
+    readonly runArmed: "RunArmed";
+    /** Bare hands. */
+    readonly punch: "Punch";
+    /** Spears, daggers. */
+    readonly stab: "Stab";
+    /** Swords, axes, maces, clubs. */
+    readonly swing: "Swing";
+    readonly hit: "Hit";
+    readonly die: "Die";
+    /** Talking: the near hand gestures, the head nods. */
+    readonly talk: "Talk";
+    /** A start back with the hands up (once, then held). */
+    readonly surprised: "Surprised";
+    /** Pointing forward with the far hand (once, then held). */
+    readonly point: "Point";
+    /** Waving with the near hand. */
+    readonly wave: "Wave";
+    readonly jump: "Jump";
+    readonly dance: "Dance";
+    /** Sitting down (once, then held). */
+    readonly sit: "Sit";
+    /** Falling over (once, then lying) — Die without its event and its face. */
+    readonly fall: "Fall";
+};
+/**
+ * How fast the ground passes under a planted foot at speed 1, skeleton units a second: the foot is on
+ * the ground for half a stride and slides back 2 × stride (`foot`). A world scrolling at exactly this
+ * speed × the character's scale × the animation's speed keeps the feet put — no skating.
+ */
+declare const GAIT_GROUND_SPEED: Readonly<Record<string, number>>;
+
+/** The attack for what the weapon hand holds: a ranged weapon or a staff has its own (ranged.ts — a bow
+ *  drawn and loosed, a crossbow, a pistol, a musket, a burst, a cast); otherwise bare hands punch, a
+ *  thrusting weapon stabs, anything else — swords, axes, maces, clubs — swings. */
+declare function heroAttack(weapon: string | null): string;
+/** Does the hero fight face to face with this in hand — bare hands, a sword, an axe, a spear (not a
+ *  bow, a gun or a staff)? The fight then hits only at the monster, with no shot in flight. */
+declare function heroIsMelee(weapon: string | null): boolean;
+/** What the hero's shot looks like in flight with this in hand: a bow's arrow, a gun's bullet; a swung
+ *  weapon sends the crescent wave of its swing, a stabbing one a spike; a staff and bare hands — the
+ *  game's orb. */
+declare function heroShot(weapon: string | null): ShotKind;
+declare const heroRig: RigDef;
+
+declare const allPacks: readonly ArtPack[];
+
+declare const basePack: ArtPack;
+
+/** A whole SVG document of the art on its canvas, ×scale (rasterized once per image), drawn in a
+ *  style: the colour of its painted part, the light on it. */
+declare function svgDocument(art: ArtDef, size: {
+    w: number;
+    h: number;
+}, scale?: number, style?: ArtStyle): string;
+
+interface CharacterCanvasOptions {
+    rig: RigDef;
+    catalog: ArtCatalog;
+    look?: CharacterLook;
+    /** 1 — the rig's own facing, -1 — mirrored. */
+    facing?: 1 | -1;
+    /** "live" (default) — moving; "still" — one frame of the rig's default animation. */
+    mode?: "live" | "still";
+    /** The animation to start with (default the rig's). */
+    animation?: string;
+    /**
+     * How far the canvas reaches past its host, as shares of the host's size: the standing body fills
+     * the host, while what sticks out — a long weapon, a sword raised — is drawn over the space around
+     * (the canvas lets clicks through). Default: live on WebGL { side: 0.7, top: 0.5 }, still — none.
+     */
+    overflow?: {
+        side: number;
+        top: number;
+    };
+}
+declare class CharacterCanvas {
+    private readonly options;
+    readonly canvas: HTMLCanvasElement;
+    readonly parts: PartsManager;
+    readonly animator: Animator;
+    private readonly skeleton;
+    private readonly rig;
+    private readonly facing;
+    private readonly gl;
+    private readonly overflow;
+    private readonly offs;
+    private asked;
+    private skinsDirty;
+    private frame;
+    private last;
+    private visible;
+    private dead;
+    private stillDrawing;
+    private stillAgain;
+    constructor(host: HTMLElement, options: CharacterCanvasOptions);
+    /** Plays an animation — or the rig's stance of it for what is worn (a walk with a rifle). */
+    play(animation: string, options?: PlayOptions): boolean;
+    /** An animation event, "end", or "*". Returns the unsubscribe. */
+    on(event: string, listener: (e: AnimationEvent) => void): () => void;
+    setLook(look: CharacterLook): void;
+    destroy(): void;
+    private stanceOf;
+    private resize;
+    /** Where the rig's px land on the canvas: x → a·x + b, y (up) → c − a·y. */
+    private view;
+    private update;
+    /** One frame on a 2D canvas (still, or no WebGL); a change while drawing draws again after. */
+    private drawStill;
+}
+
+declare const RIG2D_RECIPE_LIMITS: {
+    /** Своих картинок на героя. */
+    readonly art: 16;
+    /** Символов SVG в одной картинке. */
+    readonly svgChars: 12000;
+    readonly name: 40;
+    readonly description: 300;
+};
+interface Rig2dRecipe {
+    name: string;
+    description: string;
+    look: CharacterLook;
+    /** Путь картинки → свой рисунок. */
+    art: Record<string, ArtDef>;
+}
+type Rig2dRecipeResult = {
+    ok: true;
+    recipe: Rig2dRecipe;
+    warnings: string[];
+} | {
+    ok: false;
+    error: string;
+};
+/** Оставить в SVG только рисование: без скриптов, ссылок, событий, внешних ресурсов. */
+declare function sanitizeSvg(svg: string): string | null;
+/**
+ * Рецепт из ответа модели (строка или уже разобранный объект). Детали, которых нет у рига, и
+ * картинки чужих путей отбрасываются с предупреждением — герой всё равно собирается.
+ */
+declare function parseRig2dRecipe(input: unknown, rig: RigDef): Rig2dRecipeResult;
+/** Каталог героя: стандартные пакеты + его свои картинки поверх. */
+declare function catalogFor(recipe: Rig2dRecipe, base: readonly ArtPack[]): ArtCatalog;
+/**
+ * Что знает модель, когда пишет рецепт: типы деталей, их имена, цели цвета и холсты картинок
+ * (для своих рисунков). Сжато — уходит переменной шаблона промпта фичи.
+ */
+declare function rig2dRecipeBrief(rig: RigDef): string;
+/** Картинки, которые надевает деталь (для подсказки модели, какой путь перерисовать). */
+declare function picturesOf(rig: RigDef, skin: string): string[];
+
+/** Каталог всех пакетов рисунка; `extra` — пакеты игры или проекта поверх стандартных. */
+declare function createCatalog(extra?: readonly ArtPack[]): ArtCatalog;
+
+export { AnimationEvent, Animator, ArtCatalog, ArtDef, ArtPack, Attachment, CharacterCanvas, type CharacterCanvasOptions, CharacterLook, GAIT_GROUND_SPEED, HERO_ANIMATIONS, PartsManager, PlayOptions, RANGED_ANIMATIONS, RIG2D_RECIPE_LIMITS, type Rig2dRecipe, type Rig2dRecipeResult, RigDef, type ShotKind, Skeleton, Slot, allPacks, basePack, catalogFor, createCatalog, heroAttack, heroIsMelee, heroRig, heroShot, parseRig2dRecipe, picturesOf, rig2dRecipeBrief, sanitizeSvg, svgDocument, worldGeometry };

package/dist/rig2d/index.d.ts

@@ -0,0 +1,190 @@
+import { S as Skeleton, d as Slot, e as Attachment, R as RigDef, f as ArtPack, g as ArtDef, h as ArtStyle, P as PartsManager, a as Animator, A as ArtCatalog, C as CharacterLook, b as PlayOptions, c as AnimationEvent } from '../PartsManager-CAVBKvp6.js';
+export { i as Animation, j as ArtId, B as BlinkOptions, k as Bone, l as BoneId, m as Color, n as ColorTargetDef, o as ColorTargetId, E as EditorGroup, p as ExpressionsDef, H as Hex, L as LOOK_VERSION, q as PartTypeDef, r as PartTypeId, s as PartsChange, t as PartsRule, u as Rng, v as RuleView, w as SkeletonData, x as Skin, W as WHITE, y as bothHands, z as colorOf, D as defineRig, F as hexToNumber, G as imageSizes, I as mergeLooks, J as numberToHex, K as parseLook, M as pick, N as readSkeletonData, O as seedOf, Q as seededRandom, T as skinImages, U as swapUnder } from '../PartsManager-CAVBKvp6.js';
+export { H as HERO_PRESETS, L as LookPreset, P as PictureArt, T as ThumbnailBackdrop, a as ThumbnailRequest, b as Thumbnailer, c as createThumbnailer, v as vectorPictures } from '../thumbnail-Bp-jK70T.js';
+import '../contract-DhZuKNIf.js';
+
+interface Geometry {
+    /** x, y per vertex, world space. */
+    positions: Float32Array;
+    uvs: Float32Array;
+    triangles: Uint16Array;
+}
+/** Writes the attachment's world vertices into `out` (resized as needed); returns the geometry. */
+declare function worldGeometry(sk: Skeleton, slot: Slot, attachment: Attachment, out: Float32Array | null): Geometry;
+
+declare const RANGED_ANIMATIONS: {
+    /** A staff: raised high, then thrust at the enemy — the spell leaves at its point. */
+    readonly cast: "Cast";
+    readonly bow: "ShootBow";
+    readonly crossbow: "ShootCrossbow";
+    readonly pistol: "ShootPistol";
+    readonly musket: "ShootMusket";
+    /** A burst: three kicks of the gun (one shot event — the game shoots once per attack). */
+    readonly burst: "ShootBurst";
+};
+/** What a hero's shot looks like in flight: an arrow, a crossbow bolt, a bullet; for a melee weapon
+ *  (the idle fight is ranged) the wave of its blow — a crescent from a swing, a spike from a stab; the
+ *  game's own glowing orb for magic and bare hands. */
+type ShotKind = "arrow" | "bolt" | "bullet" | "slash" | "thrust" | "orb";
+
+declare const HERO_ANIMATIONS: {
+    readonly idle: "Idle";
+    /** Idle now and then: a look up and around. */
+    readonly look: "Look";
+    readonly walk: "Walk";
+    readonly run: "Run";
+    /** A run with a weapon held ready. */
+    readonly runArmed: "RunArmed";
+    /** Bare hands. */
+    readonly punch: "Punch";
+    /** Spears, daggers. */
+    readonly stab: "Stab";
+    /** Swords, axes, maces, clubs. */
+    readonly swing: "Swing";
+    readonly hit: "Hit";
+    readonly die: "Die";
+    /** Talking: the near hand gestures, the head nods. */
+    readonly talk: "Talk";
+    /** A start back with the hands up (once, then held). */
+    readonly surprised: "Surprised";
+    /** Pointing forward with the far hand (once, then held). */
+    readonly point: "Point";
+    /** Waving with the near hand. */
+    readonly wave: "Wave";
+    readonly jump: "Jump";
+    readonly dance: "Dance";
+    /** Sitting down (once, then held). */
+    readonly sit: "Sit";
+    /** Falling over (once, then lying) — Die without its event and its face. */
+    readonly fall: "Fall";
+};
+/**
+ * How fast the ground passes under a planted foot at speed 1, skeleton units a second: the foot is on
+ * the ground for half a stride and slides back 2 × stride (`foot`). A world scrolling at exactly this
+ * speed × the character's scale × the animation's speed keeps the feet put — no skating.
+ */
+declare const GAIT_GROUND_SPEED: Readonly<Record<string, number>>;
+
+/** The attack for what the weapon hand holds: a ranged weapon or a staff has its own (ranged.ts — a bow
+ *  drawn and loosed, a crossbow, a pistol, a musket, a burst, a cast); otherwise bare hands punch, a
+ *  thrusting weapon stabs, anything else — swords, axes, maces, clubs — swings. */
+declare function heroAttack(weapon: string | null): string;
+/** Does the hero fight face to face with this in hand — bare hands, a sword, an axe, a spear (not a
+ *  bow, a gun or a staff)? The fight then hits only at the monster, with no shot in flight. */
+declare function heroIsMelee(weapon: string | null): boolean;
+/** What the hero's shot looks like in flight with this in hand: a bow's arrow, a gun's bullet; a swung
+ *  weapon sends the crescent wave of its swing, a stabbing one a spike; a staff and bare hands — the
+ *  game's orb. */
+declare function heroShot(weapon: string | null): ShotKind;
+declare const heroRig: RigDef;
+
+declare const allPacks: readonly ArtPack[];
+
+declare const basePack: ArtPack;
+
+/** A whole SVG document of the art on its canvas, ×scale (rasterized once per image), drawn in a
+ *  style: the colour of its painted part, the light on it. */
+declare function svgDocument(art: ArtDef, size: {
+    w: number;
+    h: number;
+}, scale?: number, style?: ArtStyle): string;
+
+interface CharacterCanvasOptions {
+    rig: RigDef;
+    catalog: ArtCatalog;
+    look?: CharacterLook;
+    /** 1 — the rig's own facing, -1 — mirrored. */
+    facing?: 1 | -1;
+    /** "live" (default) — moving; "still" — one frame of the rig's default animation. */
+    mode?: "live" | "still";
+    /** The animation to start with (default the rig's). */
+    animation?: string;
+    /**
+     * How far the canvas reaches past its host, as shares of the host's size: the standing body fills
+     * the host, while what sticks out — a long weapon, a sword raised — is drawn over the space around
+     * (the canvas lets clicks through). Default: live on WebGL { side: 0.7, top: 0.5 }, still — none.
+     */
+    overflow?: {
+        side: number;
+        top: number;
+    };
+}
+declare class CharacterCanvas {
+    private readonly options;
+    readonly canvas: HTMLCanvasElement;
+    readonly parts: PartsManager;
+    readonly animator: Animator;
+    private readonly skeleton;
+    private readonly rig;
+    private readonly facing;
+    private readonly gl;
+    private readonly overflow;
+    private readonly offs;
+    private asked;
+    private skinsDirty;
+    private frame;
+    private last;
+    private visible;
+    private dead;
+    private stillDrawing;
+    private stillAgain;
+    constructor(host: HTMLElement, options: CharacterCanvasOptions);
+    /** Plays an animation — or the rig's stance of it for what is worn (a walk with a rifle). */
+    play(animation: string, options?: PlayOptions): boolean;
+    /** An animation event, "end", or "*". Returns the unsubscribe. */
+    on(event: string, listener: (e: AnimationEvent) => void): () => void;
+    setLook(look: CharacterLook): void;
+    destroy(): void;
+    private stanceOf;
+    private resize;
+    /** Where the rig's px land on the canvas: x → a·x + b, y (up) → c − a·y. */
+    private view;
+    private update;
+    /** One frame on a 2D canvas (still, or no WebGL); a change while drawing draws again after. */
+    private drawStill;
+}
+
+declare const RIG2D_RECIPE_LIMITS: {
+    /** Своих картинок на героя. */
+    readonly art: 16;
+    /** Символов SVG в одной картинке. */
+    readonly svgChars: 12000;
+    readonly name: 40;
+    readonly description: 300;
+};
+interface Rig2dRecipe {
+    name: string;
+    description: string;
+    look: CharacterLook;
+    /** Путь картинки → свой рисунок. */
+    art: Record<string, ArtDef>;
+}
+type Rig2dRecipeResult = {
+    ok: true;
+    recipe: Rig2dRecipe;
+    warnings: string[];
+} | {
+    ok: false;
+    error: string;
+};
+/** Оставить в SVG только рисование: без скриптов, ссылок, событий, внешних ресурсов. */
+declare function sanitizeSvg(svg: string): string | null;
+/**
+ * Рецепт из ответа модели (строка или уже разобранный объект). Детали, которых нет у рига, и
+ * картинки чужих путей отбрасываются с предупреждением — герой всё равно собирается.
+ */
+declare function parseRig2dRecipe(input: unknown, rig: RigDef): Rig2dRecipeResult;
+/** Каталог героя: стандартные пакеты + его свои картинки поверх. */
+declare function catalogFor(recipe: Rig2dRecipe, base: readonly ArtPack[]): ArtCatalog;
+/**
+ * Что знает модель, когда пишет рецепт: типы деталей, их имена, цели цвета и холсты картинок
+ * (для своих рисунков). Сжато — уходит переменной шаблона промпта фичи.
+ */
+declare function rig2dRecipeBrief(rig: RigDef): string;
+/** Картинки, которые надевает деталь (для подсказки модели, какой путь перерисовать). */
+declare function picturesOf(rig: RigDef, skin: string): string[];
+
+/** Каталог всех пакетов рисунка; `extra` — пакеты игры или проекта поверх стандартных. */
+declare function createCatalog(extra?: readonly ArtPack[]): ArtCatalog;
+
+export { AnimationEvent, Animator, ArtCatalog, ArtDef, ArtPack, Attachment, CharacterCanvas, type CharacterCanvasOptions, CharacterLook, GAIT_GROUND_SPEED, HERO_ANIMATIONS, PartsManager, PlayOptions, RANGED_ANIMATIONS, RIG2D_RECIPE_LIMITS, type Rig2dRecipe, type Rig2dRecipeResult, RigDef, type ShotKind, Skeleton, Slot, allPacks, basePack, catalogFor, createCatalog, heroAttack, heroIsMelee, heroRig, heroShot, parseRig2dRecipe, picturesOf, rig2dRecipeBrief, sanitizeSvg, svgDocument, worldGeometry };