@felbrasil/dreamy 0.0.0-stage → 0.1.1

package/dist/types/api/src/events/palette-events.d.ts

@@ -0,0 +1,8 @@
+import type { PaletteSlot, Rgb } from "../model/palette.js";
+import type { EventOf } from "./event-of.js";
+export type PaletteColorSet = EventOf<"PaletteColorSet", {
+    readonly slot: PaletteSlot;
+    readonly color: Rgb;
+}>;
+export type PaletteReset = EventOf<"PaletteReset", Record<string, never>>;
+export type PaletteEvent = PaletteColorSet | PaletteReset;

package/dist/types/api/src/events/rig-events.d.ts

@@ -0,0 +1,161 @@
+import type { Id } from "../id.js";
+import type { Transform } from "../model/math.js";
+import type { Bone, BodyPart, BodyRegion, BoneSize, GraftSlot, PartSlot, PosePreset, Rig, RigMode } from "../model/rig.js";
+import type { RigObject } from "../model/scene-object.js";
+import type { FlatWing } from "../model/wing.js";
+import type { EventOf } from "./event-of.js";
+export type RigCreated = EventOf<"RigCreated", {
+    readonly object: RigObject;
+}>;
+/**
+ * The full result of applying a premade (templates may change later; old logs keep what was made):
+ * a new rig object, or the replacement rig of an existing object.
+ */
+export type PremadeApplied = EventOf<"PremadeApplied", {
+    readonly kind: "new";
+    readonly object: RigObject;
+} | {
+    readonly kind: "object";
+    readonly objectId: Id;
+    readonly rig: Rig;
+}>;
+/** The bone and, with mirror on, its partner. */
+export type BonesAdded = EventOf<"BonesAdded", {
+    readonly rigId: Id;
+    readonly bones: readonly Bone[];
+}>;
+/** Children move to the removed bone's parent, keeping their bind and pose placement. */
+export type BoneRemoved = EventOf<"BoneRemoved", {
+    readonly rigId: Id;
+    readonly boneId: Id;
+}>;
+export type BoneReparented = EventOf<"BoneReparented", {
+    readonly rigId: Id;
+    readonly boneId: Id;
+    readonly parentId: Id | null;
+    readonly bind: Transform;
+    readonly pose: Transform;
+}>;
+export type BoneRenamed = EventOf<"BoneRenamed", {
+    readonly rigId: Id;
+    readonly boneId: Id;
+    readonly name: string;
+}>;
+export type BoneTagsSet = EventOf<"BoneTagsSet", {
+    readonly rigId: Id;
+    readonly changes: readonly {
+        readonly boneId: Id;
+        readonly tags: readonly string[];
+    }[];
+}>;
+/**
+ * Resolved writes (mirror partners included) to the bind (rig mode) or the pose (pose mode). A pose write on a
+ * premade rig also keeps the result as its Custom pose and selects it.
+ */
+export type BoneTransformsSet = EventOf<"BoneTransformsSet", {
+    readonly rigId: Id;
+    readonly target: "bind" | "pose";
+    readonly changes: readonly {
+        readonly boneId: Id;
+        readonly transform: Transform;
+    }[];
+}>;
+/** Also selects the Front preset. */
+export type PoseReset = EventOf<"PoseReset", {
+    readonly rigId: Id;
+}>;
+/** The resolved bone poses of a pose preset choice (rules may change later; old logs keep their poses). */
+export type PosePresetApplied = EventOf<"PosePresetApplied", {
+    readonly rigId: Id;
+    readonly preset: PosePreset;
+    readonly changes: readonly {
+        readonly boneId: Id;
+        readonly transform: Transform;
+    }[];
+}>;
+export type RigModeSet = EventOf<"RigModeSet", {
+    readonly rigId: Id;
+    readonly mode: RigMode;
+}>;
+export type RigMirrorSet = EventOf<"RigMirrorSet", {
+    readonly rigId: Id;
+    readonly mirror: boolean;
+}>;
+/** Also sets the blend of every sculpt part in that region. */
+export type RegionBlendSet = EventOf<"RegionBlendSet", {
+    readonly rigId: Id;
+    readonly region: BodyRegion;
+    readonly blend: number;
+}>;
+export type BodyPartAdded = EventOf<"BodyPartAdded", {
+    readonly rigId: Id;
+    readonly part: BodyPart;
+}>;
+export type BodyPartRemoved = EventOf<"BodyPartRemoved", {
+    readonly rigId: Id;
+    readonly boneId: Id;
+}>;
+export type FlatWingsSet = EventOf<"FlatWingsSet", {
+    readonly rigId: Id;
+    readonly changes: readonly {
+        readonly boneId: Id;
+        readonly wing: Partial<Omit<FlatWing, "frame">>;
+    }[];
+}>;
+/**
+ * Resolved bone sizes (mirror partners included), the child joints that moved with a length change, and the parts
+ * below them, carried along with their joints.
+ */
+export type BoneSizesSet = EventOf<"BoneSizesSet", {
+    readonly rigId: Id;
+    readonly sizes: readonly {
+        readonly boneId: Id;
+        readonly size: BoneSize;
+    }[];
+    readonly moved: readonly {
+        readonly boneId: Id;
+        readonly bind: Transform;
+        readonly pose: Transform;
+    }[];
+    readonly parts: readonly BodyPart[];
+}>;
+/**
+ * A slot's resolved parts: `parts` replace the parts of their bones, `removed` bones lose theirs. A new head also
+ * re-seats the chains on it (ears, horns, antennae…): their roots' new bind and pose are in `moved`. A kit that
+ * brings its own bones (a variant's trunk or ears) removes the slot's earlier ones (`removedBones`, with their
+ * parts) and adds its own (`bones`; their parts are in `parts`).
+ */
+export type PartSlotSwapped = EventOf<"PartSlotSwapped", {
+    readonly rigId: Id;
+    readonly slot: PartSlot;
+    readonly kit: string;
+    readonly parts: readonly BodyPart[];
+    readonly removed: readonly Id[];
+    readonly moved?: readonly {
+        readonly boneId: Id;
+        readonly bind: Transform;
+        readonly pose: Transform;
+    }[];
+    readonly bones?: readonly Bone[];
+    readonly removedBones?: readonly Id[];
+}>;
+/** A slot's grafted chains: `removed` bones (an earlier graft) go with their parts; `bones` and their `parts` are added. */
+export type PartGrafted = EventOf<"PartGrafted", {
+    readonly rigId: Id;
+    readonly slot: GraftSlot;
+    readonly kit?: string;
+    readonly bones: readonly Bone[];
+    readonly parts: readonly BodyPart[];
+    readonly removed: readonly Id[];
+}>;
+/** The full result of generating a creature: a new rig object, or the regenerated rig of an existing object. */
+export type CreatureGenerated = EventOf<"CreatureGenerated", {
+    readonly kind: "new";
+    readonly object: RigObject;
+} | {
+    readonly kind: "rig";
+    readonly objectId: Id;
+    readonly rig: Rig;
+    readonly transform: Transform;
+}>;
+export type RigEvent = RigCreated | PremadeApplied | BonesAdded | BoneRemoved | BoneReparented | BoneRenamed | BoneTagsSet | BoneTransformsSet | PoseReset | PosePresetApplied | BoneSizesSet | PartSlotSwapped | PartGrafted | CreatureGenerated | RigModeSet | RigMirrorSet | RegionBlendSet | BodyPartAdded | BodyPartRemoved | FlatWingsSet;

package/dist/types/api/src/events/scene-events.d.ts

@@ -0,0 +1,34 @@
+import type { Id } from "../id.js";
+import type { Transform } from "../model/math.js";
+import type { SceneObject, SculptObject } from "../model/scene-object.js";
+import type { EventOf } from "./event-of.js";
+export type SculptCreated = EventOf<"SculptCreated", {
+    readonly object: SculptObject;
+}>;
+/** The resolved set: every listed object and its whole subtree. */
+export type ObjectsDeleted = EventOf<"ObjectsDeleted", {
+    readonly objectIds: readonly Id[];
+}>;
+export type ObjectRenamed = EventOf<"ObjectRenamed", {
+    readonly objectId: Id;
+    readonly name: string;
+}>;
+/** `transform` is the new local transform that keeps the object's world placement. */
+export type ObjectReparented = EventOf<"ObjectReparented", {
+    readonly objectId: Id;
+    readonly parentId: Id | null;
+    readonly index: number;
+    readonly transform: Transform;
+}>;
+/** Gizmo drags, Properties edits and object mirroring. */
+export type ObjectTransformsSet = EventOf<"ObjectTransformsSet", {
+    readonly changes: readonly {
+        readonly objectId: Id;
+        readonly transform: Transform;
+    }[];
+}>;
+/** Full copies with new ids, appended after the originals' subtrees. */
+export type ObjectsDuplicated = EventOf<"ObjectsDuplicated", {
+    readonly objects: readonly SceneObject[];
+}>;
+export type SceneEvent = SculptCreated | ObjectsDeleted | ObjectRenamed | ObjectReparented | ObjectTransformsSet | ObjectsDuplicated;

package/dist/types/api/src/events/sculpt-events.d.ts

@@ -0,0 +1,53 @@
+import type { SculptLookPatch, StampPropsPatch } from "../commands/sculpt-commands.js";
+import type { SculptTarget } from "../commands/target.js";
+import type { Id } from "../id.js";
+import type { Pivot } from "../model/look.js";
+import type { Quaternion, Vec3 } from "../model/math.js";
+import type { SmearGroup, Stamp, Symmetry } from "../model/stamp.js";
+import type { EventOf } from "./event-of.js";
+export type StampsAdded = EventOf<"StampsAdded", {
+    readonly target: SculptTarget;
+    readonly stamps: readonly Stamp[];
+    readonly smearGroup?: SmearGroup;
+}>;
+/** Includes the smear groups the removal left empty. */
+export type StampsRemoved = EventOf<"StampsRemoved", {
+    readonly target: SculptTarget;
+    readonly stampIds: readonly Id[];
+    readonly smearGroupIds: readonly Id[];
+}>;
+export type StampPlacementsSet = EventOf<"StampPlacementsSet", {
+    readonly target: SculptTarget;
+    readonly changes: readonly {
+        readonly stampId: Id;
+        readonly position: Vec3;
+        readonly rotation: Quaternion;
+        readonly scale: Vec3;
+    }[];
+}>;
+export type StampPropsSet = EventOf<"StampPropsSet", {
+    readonly target: SculptTarget;
+    readonly stampIds: readonly Id[];
+    readonly props: StampPropsPatch;
+}>;
+export type SmearGroupSet = EventOf<"SmearGroupSet", {
+    readonly target: SculptTarget;
+    readonly groupId: Id;
+    readonly props: StampPropsPatch & {
+        readonly unlocked?: boolean;
+        readonly name?: string;
+    };
+}>;
+export type SculptLookSet = EventOf<"SculptLookSet", {
+    readonly targets: readonly SculptTarget[];
+    readonly look: SculptLookPatch;
+}>;
+export type PivotSet = EventOf<"PivotSet", {
+    readonly target: SculptTarget;
+    readonly pivot: Pivot;
+}>;
+export type SymmetrySetForAll = EventOf<"SymmetrySetForAll", {
+    readonly target: SculptTarget;
+    readonly symmetry: Symmetry | null;
+}>;
+export type SculptEvent = StampsAdded | StampsRemoved | StampPlacementsSet | StampPropsSet | SmearGroupSet | SculptLookSet | PivotSet | SymmetrySetForAll;

package/dist/types/api/src/id.d.ts

@@ -0,0 +1 @@
+export type Id = string;

package/dist/types/api/src/index.d.ts

@@ -0,0 +1,31 @@
+export type { Id } from "./id.js";
+export type { Quaternion, Transform, Vec3 } from "./model/math.js";
+export type { ColorRef, FixedColor, Palette, PaletteSlot, Rgb } from "./model/palette.js";
+export type { MaterialOverrides, SmearGroup, Stamp, StampMode, StampShape, Symmetry, SymmetryAxis, } from "./model/stamp.js";
+export type { FleckShape, FleckStyle, Material, Pattern, PatternKind, Pivot, SculptLook, } from "./model/look.js";
+export type { BuiltinDecalCategory, Decal, DecalArt, Design, DesignPaint, DesignShape, } from "./model/decal.js";
+export type { FlatWing, WingFrame, WingOutline, WingPatternStyle } from "./model/wing.js";
+export type { Sculpt } from "./model/sculpt.js";
+export type { BodyPart, BodyRegion, Bone, BoneSize, CreatureFamily, CreatureRecipe, CreatureTheme, GraftSlot, PartSlot, SizeGroup, PosePreset, PosePresetId, RegionBlends, Rig, RigMode } from "./model/rig.js";
+export type { RigObject, SceneObject, SculptObject } from "./model/scene-object.js";
+export type { Creation, CreationLog, LogFormat, SchemaVersion } from "./model/creation.js";
+export type { SculptTarget } from "./commands/target.js";
+export type { StampSpec } from "./commands/stamp-spec.js";
+export type * from "./commands/scene-commands.js";
+export type * from "./commands/sculpt-commands.js";
+export type * from "./commands/decal-commands.js";
+export type * from "./commands/palette-commands.js";
+export type * from "./commands/rig-commands.js";
+export type { Command } from "./commands/command.js";
+export type { EventOf } from "./events/event-of.js";
+export type * from "./events/scene-events.js";
+export type * from "./events/sculpt-events.js";
+export type * from "./events/decal-events.js";
+export type * from "./events/palette-events.js";
+export type * from "./events/rig-events.js";
+export type { CreationEvent } from "./events/creation-event.js";
+export type { CreationApi, DispatchResult, PartVariantInfo, PremadeInfo } from "./creation-api.js";
+export type { Clock, IdGenerator } from "./ports/basic-ports.js";
+export type { GitProvider, GitSettings, LibraryEntry, LibrarySync, Persistence, PreferencesStore, SyncStatus, SyncSummary, ViewPreferences, } from "./ports/persistence.js";
+export type { Evaluator, MeshRequest, MeshResult, SkinRequest, SkinResult } from "./ports/evaluator.js";
+export type { BoneTool, DecalBrush, DecalCatalogEntry, FrameOptions, Selection, StampBrush, Tool, ViewSession, Viewport, ViewportCallbacks, } from "./ports/viewport.js";

package/dist/types/api/src/model/creation.d.ts

@@ -0,0 +1,22 @@
+import type { CreationEvent } from "../events/creation-event.js";
+import type { Design } from "./decal.js";
+import type { Palette } from "./palette.js";
+import type { SceneObject } from "./scene-object.js";
+/** Marks logs of this model, so logs of the retired model (schemas 1–8) are rejected, not misread. */
+export type LogFormat = "dreamy-studio";
+export type SchemaVersion = 1;
+/** The fold of the log. */
+export type Creation = {
+    readonly format: LogFormat;
+    readonly schemaVersion: SchemaVersion;
+    readonly palette: Palette;
+    /** Every object, in scene order; children follow the order of this list under their parent. */
+    readonly objects: readonly SceneObject[];
+    readonly designs: readonly Design[];
+};
+/** The saved document. The undo cursor lives on the API instance, not here. */
+export type CreationLog = {
+    readonly format: LogFormat;
+    readonly schemaVersion: SchemaVersion;
+    readonly events: readonly CreationEvent[];
+};

package/dist/types/api/src/model/decal.d.ts

@@ -0,0 +1,48 @@
+import type { Id } from "../id.js";
+import type { Quaternion, Vec3 } from "./math.js";
+import type { ColorRef } from "./palette.js";
+export type BuiltinDecalCategory = "eye" | "mouth" | "mark" | "door" | "emoji" | "interior";
+/** Which art a decal shows: a built-in by category and name, or one of the creation's designs. */
+export type DecalArt = {
+    readonly kind: "builtin";
+    readonly category: BuiltinDecalCategory;
+    readonly name: string;
+} | {
+    readonly kind: "design";
+    readonly designId: Id;
+};
+export type Decal = {
+    readonly id: Id;
+    readonly art: DecalArt;
+    /** In the owner's bind-pose local space; z of `rotation` is the surface normal. */
+    readonly position: Vec3;
+    readonly rotation: Quaternion;
+    readonly size: number;
+    readonly flip: boolean;
+    /** Used by tintable art only. */
+    readonly tint?: ColorRef;
+    readonly opacity: number;
+    /** Interior rooms: depth in decal sizes (0.5–2) and a layout seed. */
+    readonly depth?: number;
+    readonly seed?: number;
+};
+/** A paint color in a design: a palette reference, or a light / shadow modifier over what lies beneath. */
+export type DesignPaint = ColorRef | "light" | "shadow" | "none";
+export type DesignShape = {
+    /** SVG path data in a 128 × 128 space. */
+    readonly d: string;
+    readonly fill: DesignPaint;
+    readonly stroke: DesignPaint;
+    readonly width: number;
+    readonly cap: "butt" | "round" | "square";
+    readonly join: "miter" | "round" | "bevel";
+    readonly rule: "nonzero" | "evenodd";
+    /** A reflected copy of the previous shape, kept in step by the editor. */
+    readonly twin?: boolean;
+};
+/** A vector decal design owned by the creation. */
+export type Design = {
+    readonly id: Id;
+    readonly name: string;
+    readonly shapes: readonly DesignShape[];
+};

package/dist/types/api/src/model/look.d.ts

@@ -0,0 +1,56 @@
+import type { Quaternion, Vec3 } from "./math.js";
+import type { ColorRef } from "./palette.js";
+/** The POC's fleck shapes; the order is the shader's index. */
+export type FleckShape = "pill" | "circle" | "square" | "diamond" | "triangle" | "hexagon" | "star" | "cross" | "ring" | "streak" | "leaf" | "sand" | "gravel" | "cement" | "grass" | "terrazzo" | "scales" | "plates" | "none";
+export type FleckStyle = {
+    readonly shape: FleckShape;
+    /** 0.2–3. */
+    readonly size: number;
+    /** Per-fleck color / size jitter, 0–1. */
+    readonly variation: number;
+    /** Share of cells that get a fleck, 0.1–1. */
+    readonly coverage: number;
+    /** Grid order, 0–1. */
+    readonly regularity: number;
+    /** Fleck movement, 0–3. */
+    readonly boil: number;
+    /** Shading of the bed between flecks, 0–0.6. */
+    readonly foundationDarkness: number;
+    /** Fleck bump strength, 0–3. */
+    readonly normalStrength: number;
+};
+export type Material = {
+    readonly roughness: number;
+    readonly metalness: number;
+    /** 0–3. */
+    readonly glow: number;
+    /** 0–1, dithered. */
+    readonly opacity: number;
+};
+export type PatternKind = "none" | "stripes" | "tiger" | "leopard" | "cow" | "thunder" | "dots" | "scales" | "camouflage";
+export type Pattern = {
+    readonly kind: PatternKind;
+    /** 0.2–5. */
+    readonly scale: number;
+    /** 0–1. */
+    readonly strength: number;
+    /** Degrees about x, y, z. */
+    readonly rotation: Vec3;
+    readonly color: ColorRef;
+    readonly color2: ColorRef;
+};
+/** The look shared by a sculpt's stamps unless a stamp overrides it. */
+export type SculptLook = {
+    readonly color: ColorRef;
+    readonly foundationColor: ColorRef;
+    readonly fleck: FleckStyle;
+    readonly material: Material;
+    /** Default smooth-blend radius between stamps, 0–0.8. */
+    readonly blend: number;
+    readonly pattern: Pattern;
+};
+/** Kaleidoscope pivot in the sculpt's local space. */
+export type Pivot = {
+    readonly position: Vec3;
+    readonly rotation: Quaternion;
+};

package/dist/types/api/src/model/math.d.ts

@@ -0,0 +1,18 @@
+export type Vec3 = {
+    readonly x: number;
+    readonly y: number;
+    readonly z: number;
+};
+/** Rotation quaternion (x, y, z, w). Identity is (0, 0, 0, 1). */
+export type Quaternion = {
+    readonly x: number;
+    readonly y: number;
+    readonly z: number;
+    readonly w: number;
+};
+/** Position, rotation and per-axis scale, relative to a parent space. */
+export type Transform = {
+    readonly position: Vec3;
+    readonly rotation: Quaternion;
+    readonly scale: Vec3;
+};

package/dist/types/api/src/model/palette.d.ts

@@ -0,0 +1,11 @@
+/** The seven editable palette slots. */
+export type PaletteSlot = "primary" | "secondary" | "detail" | "highlight" | "eye" | "pupil" | "custom";
+/** Fixed colors: always available, never edited. */
+export type FixedColor = "tongue" | "teeth" | "black";
+/** Every stored color is a reference, never a raw value (constitution: slots, not RGB). */
+export type ColorRef = PaletteSlot | FixedColor;
+/** 0xRRGGBB. */
+export type Rgb = number;
+export type Palette = {
+    readonly [Slot in PaletteSlot]: Rgb;
+};

package/dist/types/api/src/model/rig.d.ts

@@ -0,0 +1,125 @@
+import type { Id } from "../id.js";
+import type { Material } from "./look.js";
+import type { Transform } from "./math.js";
+import type { Sculpt } from "./sculpt.js";
+import type { FlatWing } from "./wing.js";
+/**
+ * A bone of a rig's skeleton (a tree, at most 64 bones).
+ * Tags carry the side (`side:L` / `side:R`), the mirror pairing key (`mirror:<key>`) and the role
+ * (`role:<role>`) that picks the generated body part's style.
+ */
+export type Bone = {
+    readonly id: Id;
+    readonly name: string;
+    /** Absent for a root bone. */
+    readonly parentId?: Id;
+    readonly tags: readonly string[];
+    /** Rest transform relative to the parent bone (or the rig). */
+    readonly bind: Transform;
+    /** Posed transform relative to the parent bone (or the rig). Equal to `bind` until posed. */
+    readonly pose: Transform;
+    /** Proportions (absent = 1, 1). `length` stretches the bone (its child joints sit that much farther) and its part
+     *  along it; `thickness` scales its part across it. A head is never smaller than it was made (both ≥ 1). */
+    readonly size?: BoneSize;
+};
+export type BoneSize = {
+    readonly length: number;
+    readonly thickness: number;
+};
+/** Rig mode edits the bind pose; pose mode edits the pose. */
+export type RigMode = "rig" | "pose";
+export type BodyRegion = "torso" | "limb" | "wing" | "tail" | "head";
+export type RegionBlends = {
+    readonly [Region in BodyRegion]: number;
+};
+/** A bone's body part: a sculpt in the rig's bind space, or a flat wing. Rigid to its bone. */
+export type BodyPart = {
+    readonly boneId: Id;
+    readonly kind: "sculpt";
+    readonly sculpt: Sculpt;
+} | {
+    readonly boneId: Id;
+    readonly kind: "wing";
+    readonly wing: FlatWing;
+    readonly material: Material;
+};
+/**
+ * A premade pose: Front (rest), Howl, Menace, Shy, Hover (static flying; a leap without wings), Dive (attacking
+ * flying; a pounce without wings), Funny, or Custom (the rig's own hand-posed pose).
+ */
+export type PosePresetId = "front" | "howl" | "menace" | "shy" | "hover" | "dive" | "funny" | "custom";
+/** The pose(s) a premade rig shows: `a`, or `a` blended toward `b` by `t` (0 = a, 1 = b). */
+export type PosePreset = {
+    readonly a: PosePresetId;
+    readonly b?: PosePresetId;
+    readonly t: number;
+};
+/**
+ * A swappable body-part slot of a premade rig: a chain of bones by role (head, ears, horns, tail, wings, legs, arms,
+ * antennae, fins, tentacles), or the coat (the skin's fleck, pattern and material).
+ */
+export type PartSlot = "head" | "ears" | "horns" | "tail" | "wings" | "legs" | "arms" | "antennae" | "fins" | "tentacles" | "coat";
+/** The slots a premade rig can gain when its skeleton lacks them: new bone chains grafted with another premade's parts. */
+export type GraftSlot = "wings" | "horns" | "tail";
+/**
+ * Creature families: parts swap within a family unless the user asks for a chimera. The last five are made-up kinds
+ * of parts (mushrooms, leaves, stone and crystal, metal and circuits, fire, ice and slime): no premade belongs to
+ * them, so their parts come with Chimera.
+ */
+export type CreatureFamily = "mammal" | "reptile" | "bird" | "bug" | "aquatic" | "plant" | "fungus" | "mineral" | "machine" | "elemental";
+/** A made-up kind a whole generated creature can be built from: its parts come from that family wherever it has one. */
+export type CreatureTheme = Extract<CreatureFamily, "plant" | "fungus" | "mineral" | "machine" | "elemental">;
+/** The proportion groups a generated creature varies (head, neck, torso, tail, front / hind legs, arms, ears…). */
+export type SizeGroup = "head" | "neck" | "torso" | "tail" | "front-legs" | "hind-legs" | "arms" | "ears" | "horns" | "wings" | "antennae" | "fins" | "tentacles";
+/**
+ * How a generated creature was made: its seed, base premade, the premade each slot's parts came from, the size of
+ * each proportion group, its eye and mouth art, whether families may mix (chimera) and how far sizes stray (variety).
+ */
+export type CreatureRecipe = {
+    readonly seed: number;
+    readonly base: string;
+    readonly chimera: boolean;
+    /** 0–1. */
+    readonly variety: number;
+    /** Per slot; a slot the base skeleton lacks was grafted from that premade. */
+    readonly kits: {
+        readonly [Slot in PartSlot]?: string;
+    };
+    /** A made-up kind the creature was built from (a robot, a plant…), when it was. */
+    readonly theme?: CreatureTheme;
+    readonly sizes: {
+        readonly [Group in SizeGroup]?: BoneSize;
+    };
+    readonly eyes?: string;
+    readonly mouth?: string;
+};
+export type Rig = {
+    readonly bones: readonly Bone[];
+    readonly mode: RigMode;
+    /** Mirror edits onto partner bones and parts. */
+    readonly mirror: boolean;
+    /** The mirror plane is x = mirrorX in the rig's space. */
+    readonly mirrorX: number;
+    readonly regionBlends: RegionBlends;
+    /** At most one part per bone. */
+    readonly parts: readonly BodyPart[];
+    /**
+     * The rig's own skinned body: a sculpt that a premade was applied to keeps its stamps here and
+     * deforms with auto weights. Sculpt commands with `{ objectId }` on a rig edit this body.
+     */
+    readonly body?: Sculpt;
+    /** The premade it was made from, if any. */
+    readonly templateId?: string;
+    /** Premade rigs: the chosen pose preset(s) and blend. */
+    readonly posePreset?: PosePreset;
+    /** Premade rigs: the last hand-posed pose (bone id → pose transform), offered as the Custom preset. */
+    readonly customPose?: {
+        readonly [boneId: Id]: Transform;
+    };
+    /** Generated creatures: their recipe, to re-roll or keep parts of it. */
+    readonly recipe?: CreatureRecipe;
+    /** Premade rigs: the premade each swapped slot's parts came from (slots not listed are the rig's own). */
+    readonly slotKits?: {
+        readonly [Slot in PartSlot]?: string;
+    };
+};

package/dist/types/api/src/model/scene-object.d.ts

@@ -0,0 +1,22 @@
+import type { Id } from "../id.js";
+import type { Transform } from "./math.js";
+import type { Rig } from "./rig.js";
+import type { Sculpt } from "./sculpt.js";
+type ObjectBase = {
+    readonly id: Id;
+    readonly name: string;
+    /** Absent: the object sits at the scene root. Otherwise it moves with that object. */
+    readonly parentId?: Id;
+    /** Relative to the parent. */
+    readonly transform: Transform;
+};
+export type SculptObject = ObjectBase & {
+    readonly kind: "sculpt";
+    readonly sculpt: Sculpt;
+};
+export type RigObject = ObjectBase & {
+    readonly kind: "rig";
+    readonly rig: Rig;
+};
+export type SceneObject = SculptObject | RigObject;
+export {};

package/dist/types/api/src/model/sculpt.d.ts

@@ -0,0 +1,13 @@
+import type { Decal } from "./decal.js";
+import type { Pivot, SculptLook } from "./look.js";
+import type { SmearGroup, Stamp } from "./stamp.js";
+/** A voxel solid built from stamps: the body of a sculpt object or of a rig's body part. */
+export type Sculpt = {
+    /** Never empty: the first stamp is the base solid. */
+    readonly stamps: readonly Stamp[];
+    readonly smearGroups: readonly SmearGroup[];
+    readonly look: SculptLook;
+    readonly pivot: Pivot;
+    /** At most 64, of which at most 8 interior rooms. */
+    readonly decals: readonly Decal[];
+};