@botharness/pixel-avatar 0.9.0 → 0.10.0

package/README.md

@@ -26,5 +26,6 @@ const svg = pixelAvatarSvg(recipe); // 32×32 viewBox, crisp edges, no ids or sc
 - `emptyPartLayer`, `paintPartLayer`, `fillPartLayer`, `mirrorPartX`, `partLayer`, `partCells`, `createCustomPart`: drawing on dense layers, with pencil and eraser strokes, 4-connected flood fill and mirroring across the Avatar centerline.
 - `partLinePoints`, `partRectPoints`, `gradientPartLayer`, `ditherThreshold`, `noisePartLayer`, `shadePartLayer`: line (with 0°/45°/90° snap), rectangle (with square), tone gradient with 4×4 or 2×2 ordered dithering inside the start region, seeded ±1 tone noise, and a shade stroke that moves each colored cell one tone. All mirror, and all produce ordinary cells: the seed and the tool are not part of the part.
 - `AVATAR_PIECE_COLORS_V4`, `AVATAR_STRANDS`, `AVATAR_HEADPIECES`, `withPieces`, `withBuiltInHeadpiece`, `builtInHeadpiece`, `headpieceStart`: asset version 4. Bangs, back hair and a single `strand` each take an optional color (`bangsColor`, `backHairColor`, `strandColor`) that defaults to `hairColor`, like the side hair colors. The headpiece slot holds a built-in headpiece (ears, horns, halo or small head wings) or a Custom Part, worn together with any accessory. The base sits behind the hair and the rest in front, and the far side hides when the head turns. `withPieces` upgrades a recipe when the Human edits and moves an accessory that is now a headpiece into the empty headpiece slot. Saved recipes are never migrated on their own, so they keep rendering as before. `headpieceStart` flattens the worn headpiece into a Custom Part to start drawing from.
+- `AVATAR_ANIMAL_SPECIES`, `AVATAR_PATTERNS`, `isAnimalSpecies`: animal species in asset version 4. Each has a muzzle, an animal nose and its own ears, uses the skin color as fur, and takes an optional fur `pattern` drawn in fur tones. A drawn `pattern` Custom Part replaces the built-in one. Ear headpieces and ear accessories are kept but hidden on an animal.
 - `faceCells`, `pixelSymbolCells`, `symbolArtCells`: pixels for [`@botharness/pixel-morph`](../morph).
 - `pixelAvatarSvg(recipe, { turns, classPrefix })`: optional pre-rendered head turns, and rig layer classes (`<prefix>-body`, `-head`, `-face`, `-gaze`, `-blink`) for CSS animation.

package/dist/index.d.ts

@@ -36,6 +36,17 @@ type AvatarColor = (typeof AVATAR_COLORS)[number];
  */
 declare const AVATAR_SPECIES: readonly ["human", "goblin", "elf", "dwarf", "orc", "flower"];
 type AvatarSpecies = (typeof AVATAR_SPECIES)[number];
+/**
+ * Anthropomorphic animal species (asset version 4): a muzzle, animal ears and fur colors. The
+ * skin color is the fur color, and an optional `pattern` is drawn in its tones.
+ */
+declare const AVATAR_ANIMAL_SPECIES: readonly ["cat", "dog", "fox", "rabbit", "bear"];
+type AvatarAnimalSpecies = (typeof AVATAR_ANIMAL_SPECIES)[number];
+type AvatarSpeciesV4 = AvatarSpecies | AvatarAnimalSpecies;
+declare const isAnimalSpecies: (species: unknown) => species is AvatarAnimalSpecies;
+/** Fur patterns for animal species, drawn in skin-color tones so they survive recoloring. */
+declare const AVATAR_PATTERNS: readonly ["solid", "tabby", "spots", "patches", "colorpoint"];
+type AvatarPattern = (typeof AVATAR_PATTERNS)[number];
 /** Optional per-piece hair colors (asset version 2); an absent piece uses `hairColor`. */
 declare const AVATAR_PIECE_COLORS: readonly ["leftSideHairColor", "rightSideHairColor"];
 type AvatarPieceColor = (typeof AVATAR_PIECE_COLORS)[number];
@@ -54,7 +65,7 @@ type AvatarStrand = (typeof AVATAR_STRANDS)[number];
  */
 declare const AVATAR_HEADPIECES: readonly ["catears", "bunnyears", "horseears", "horns", "halo", "wings"];
 type AvatarHeadpiece = (typeof AVATAR_HEADPIECES)[number];
-type V4Key = AvatarPieceColorV4 | 'strand';
+type V4Key = AvatarPieceColorV4 | 'strand' | 'pattern';
 /** Part choices that exist only in asset version 2, added after every version 1 choice. */
 declare const AVATAR_PARTS_V2: {
   readonly outfit: readonly ["tee", "shirttie", "hoodie", "turtleneck", "sailor", "blazer", "overalls", "dress", "kimono", "cardigan", "maid", "jacket", "armor", "robe", "tunic", "cloak"];
@@ -114,6 +125,7 @@ declare const CUSTOM_PART_KEYS: {
   readonly cheeks: "cheeksPart";
   readonly petals: "petalsPart";
   readonly flowerBase: "flowerBasePart";
+  readonly pattern: "patternPart";
 };
 type CustomPartKey = (typeof CUSTOM_PART_KEYS)[PartSlot];
 /**
@@ -122,17 +134,21 @@ type CustomPartKey = (typeof CUSTOM_PART_KEYS)[PartSlot];
  */
 type PixelAvatarRecipeV3 = Omit<PixelAvatarRecipeV2, 'assetVersion' | CustomPartKey> & {
   assetVersion: 3;
-} & { [P in CustomPartKey]?: PixelCustomPart };
+} & { [P in Exclude<CustomPartKey, 'patternPart'>]?: PixelCustomPart } & {
+  patternPart?: never;
+};
 /**
  * Asset version 4: version 2 with a color for every hair piece, a single `strand`, and the
  * headpiece slot holding either a built-in headpiece or a Custom Part, with any number of
  * Custom Parts worn (none included).
  */
-type PixelAvatarRecipeV4 = Omit<PixelAvatarRecipeV2, 'assetVersion' | CustomPartKey | V4Key> & {
+type PixelAvatarRecipeV4 = Omit<PixelAvatarRecipeV2, 'assetVersion' | 'species' | CustomPartKey | V4Key> & {
   assetVersion: 4;
 } & { [P in Exclude<CustomPartKey, 'headpiece'>]?: PixelCustomPart } & {
   headpiece?: PixelCustomPart | AvatarHeadpiece;
   strand?: AvatarStrand;
+  species: AvatarSpeciesV4;
+  pattern?: AvatarPattern;
 } & { [P in AvatarPieceColorV4]?: string };
 type PixelAvatarRecipe = PixelAvatarRecipeV1 | PixelAvatarRecipeV2 | PixelAvatarRecipeV3 | PixelAvatarRecipeV4;
 declare const DEFAULT_RECIPE: PixelAvatarRecipeV1;
@@ -150,10 +166,11 @@ declare function hiddenChoices(recipe: PixelAvatarRecipe): readonly string[];
  * When the skin color is one of the previous species' suggested colors, it moves to the new
  * species' first suggestion; a custom color is kept.
  */
-declare function withSpecies(recipe: PixelAvatarRecipeV4, species: AvatarSpecies): PixelAvatarRecipeV4;
+declare function withSpecies(recipe: PixelAvatarRecipe, species: AvatarAnimalSpecies): PixelAvatarRecipeV4;
+declare function withSpecies(recipe: PixelAvatarRecipeV4, species: AvatarSpeciesV4): PixelAvatarRecipeV4;
 declare function withSpecies(recipe: PixelAvatarRecipeV3, species: AvatarSpecies): PixelAvatarRecipeV3;
 declare function withSpecies(recipe: PixelAvatarRecipeV1 | PixelAvatarRecipeV2, species: AvatarSpecies): PixelAvatarRecipeV2;
-declare function withSpecies(recipe: PixelAvatarRecipe, species: AvatarSpecies): PixelAvatarRecipeV2 | PixelAvatarRecipeV3 | PixelAvatarRecipeV4;
+declare function withSpecies(recipe: PixelAvatarRecipe, species: AvatarSpeciesV4): PixelAvatarRecipeV2 | PixelAvatarRecipeV3 | PixelAvatarRecipeV4;
 /**
  * Returns the recipe wearing `part` in `slot`, or with that slot's part taken off. The recipe
  * embeds its own copy; it is asset version 3 while it wears any part and version 2 otherwise,
@@ -194,7 +211,7 @@ declare const seededRecipeV2: (seed: string) => PixelAvatarRecipeV2;
 /** The same name always gives the same face (BotHarness's namespace). */
 declare const seededRecipe: (seed: string) => PixelAvatarRecipe;
 /** Suggested body colors per species; any color remains allowed. */
-declare const AVATAR_SPECIES_SWATCHES: Record<AvatarSpecies, readonly string[]>;
+declare const AVATAR_SPECIES_SWATCHES: Record<AvatarSpeciesV4, readonly string[]>;
 declare const AVATAR_PRESETS: readonly PixelAvatarRecipe[];
 //#endregion
 //#region src/part.d.ts
@@ -257,6 +274,10 @@ declare const PART_SLOTS: {
     readonly width: 32;
     readonly height: 32;
   };
+  readonly pattern: {
+    readonly width: 32;
+    readonly height: 32;
+  };
 };
 type PartSlot = keyof typeof PART_SLOTS;
 /**
@@ -270,7 +291,7 @@ declare const isHairPartSlot: (slot: PartSlot) => slot is HairPartSlot;
  * Slots whose drawn part replaces a built-in part pixel for pixel: the part's cells are painted
  * where the built-in part would be, and every cell shows its own color and tone.
  */
-declare const REPLACE_PART_SLOTS: readonly ["outfit", "accessory", "beard", "glasses", "nose", "cheeks", "petals", "flowerBase"];
+declare const REPLACE_PART_SLOTS: readonly ["outfit", "accessory", "beard", "glasses", "nose", "cheeks", "petals", "flowerBase", "pattern"];
 type ReplacePartSlot = (typeof REPLACE_PART_SLOTS)[number];
 declare const isReplacePartSlot: (slot: PartSlot) => slot is ReplacePartSlot;
 /** Tone steps on the rig's shade ramp: two darker, the color itself, two lighter. */
@@ -441,5 +462,5 @@ declare function pixelSymbolCells(symbol: PixelSymbol, color: string): PixelCell
  */
 declare function symbolArtCells(rows: readonly string[], color: string): PixelCell$1[];
 //#endregion
-export { AVATAR_COLORS, AVATAR_EXTRA_PARTS, AVATAR_HAIR_PARTS, AVATAR_HEADPIECES, AVATAR_PARTS, AVATAR_PARTS_V2, AVATAR_PIECE_COLORS, AVATAR_PIECE_COLORS_V4, AVATAR_PRESETS, AVATAR_RANGES, AVATAR_SPECIES, AVATAR_SPECIES_SWATCHES, AVATAR_STRANDS, AVATAR_SWATCHES, AVATAR_TURNS, type AvatarColor, type AvatarExtraPart, type AvatarHairPart, type AvatarHeadpiece, type AvatarPart, type AvatarPieceColor, type AvatarPieceColorV4, type AvatarRange, type AvatarSpecies, type AvatarStrand, CUSTOM_PART_KEYS, type CustomPartKey, DEFAULT_RECIPE, HAIR_PART_SLOTS, type HairPartSlot, MAX_PART_FIXED_COLORS, PART_LAYERS, PART_SLOTS, PART_TONES, PIXEL_SYMBOLS, type PartCell, type PartColor, type PartInk, type PartLayer, type PartLayerName, type PartSlot, type PartTone, type PixelAvatarRecipe, type PixelAvatarRecipeV1, type PixelAvatarRecipeV2, type PixelAvatarRecipeV3, type PixelAvatarRecipeV4, type PixelAvatarSvgOptions, type PixelCell, type PixelCustomPart, type PixelFigureOptions, type PixelGrid, type PixelMouthState, type PixelSymbol, REPLACE_PART_SLOTS, type ReplacePartSlot, builtInHeadpiece, canonicalCustomPart, canonicalRecipe, createCustomPart, createSeededRecipe, createSeededRecipeV2, customPartId, detailedRecipe, ditherThreshold, emptyPartLayer, faceCells, fillPartLayer, gradientPartLayer, hairPieceStart, headpieceStart, hiddenChoices, isHairPartSlot, isPixelAvatarRecipe, isPixelCustomPart, isReplacePartSlot, mirrorPartX, noisePartLayer, paintPartLayer, partCells, partLayer, partLinePoints, partRectPoints, partToneColor, pixelAvatarSvg, pixelFigure, pixelSymbolCells, pixelTileColor, replacePartStart, seededRandom, seededRecipe, seededRecipeV2, shadePartLayer, symbolArtCells, withBuiltInHeadpiece, withCustomPart, withHeadpiece, withPieces, withSpecies, wornPart };
+export { AVATAR_ANIMAL_SPECIES, AVATAR_COLORS, AVATAR_EXTRA_PARTS, AVATAR_HAIR_PARTS, AVATAR_HEADPIECES, AVATAR_PARTS, AVATAR_PARTS_V2, AVATAR_PATTERNS, AVATAR_PIECE_COLORS, AVATAR_PIECE_COLORS_V4, AVATAR_PRESETS, AVATAR_RANGES, AVATAR_SPECIES, AVATAR_SPECIES_SWATCHES, AVATAR_STRANDS, AVATAR_SWATCHES, AVATAR_TURNS, type AvatarAnimalSpecies, type AvatarColor, type AvatarExtraPart, type AvatarHairPart, type AvatarHeadpiece, type AvatarPart, type AvatarPattern, type AvatarPieceColor, type AvatarPieceColorV4, type AvatarRange, type AvatarSpecies, type AvatarSpeciesV4, type AvatarStrand, CUSTOM_PART_KEYS, type CustomPartKey, DEFAULT_RECIPE, HAIR_PART_SLOTS, type HairPartSlot, MAX_PART_FIXED_COLORS, PART_LAYERS, PART_SLOTS, PART_TONES, PIXEL_SYMBOLS, type PartCell, type PartColor, type PartInk, type PartLayer, type PartLayerName, type PartSlot, type PartTone, type PixelAvatarRecipe, type PixelAvatarRecipeV1, type PixelAvatarRecipeV2, type PixelAvatarRecipeV3, type PixelAvatarRecipeV4, type PixelAvatarSvgOptions, type PixelCell, type PixelCustomPart, type PixelFigureOptions, type PixelGrid, type PixelMouthState, type PixelSymbol, REPLACE_PART_SLOTS, type ReplacePartSlot, builtInHeadpiece, canonicalCustomPart, canonicalRecipe, createCustomPart, createSeededRecipe, createSeededRecipeV2, customPartId, detailedRecipe, ditherThreshold, emptyPartLayer, faceCells, fillPartLayer, gradientPartLayer, hairPieceStart, headpieceStart, hiddenChoices, isAnimalSpecies, isHairPartSlot, isPixelAvatarRecipe, isPixelCustomPart, isReplacePartSlot, mirrorPartX, noisePartLayer, paintPartLayer, partCells, partLayer, partLinePoints, partRectPoints, partToneColor, pixelAvatarSvg, pixelFigure, pixelSymbolCells, pixelTileColor, replacePartStart, seededRandom, seededRecipe, seededRecipeV2, shadePartLayer, symbolArtCells, withBuiltInHeadpiece, withCustomPart, withHeadpiece, withPieces, withSpecies, wornPart };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -331,6 +331,26 @@ const AVATAR_SPECIES = [
 	"orc",
 	"flower"
 ];
+/**
+* Anthropomorphic animal species (asset version 4): a muzzle, animal ears and fur colors. The
+* skin color is the fur color, and an optional `pattern` is drawn in its tones.
+*/
+const AVATAR_ANIMAL_SPECIES = [
+	"cat",
+	"dog",
+	"fox",
+	"rabbit",
+	"bear"
+];
+const isAnimalSpecies = (species) => AVATAR_ANIMAL_SPECIES.includes(species);
+/** Fur patterns for animal species, drawn in skin-color tones so they survive recoloring. */
+const AVATAR_PATTERNS = [
+	"solid",
+	"tabby",
+	"spots",
+	"patches",
+	"colorpoint"
+];
 /** Optional per-piece hair colors (asset version 2); an absent piece uses `hairColor`. */
 const AVATAR_PIECE_COLORS = ["leftSideHairColor", "rightSideHairColor"];
 /**
@@ -406,7 +426,8 @@ const CUSTOM_PART_KEYS = {
 	nose: "nosePart",
 	cheeks: "cheeksPart",
 	petals: "petalsPart",
-	flowerBase: "flowerBasePart"
+	flowerBase: "flowerBasePart",
+	pattern: "patternPart"
 };
 const PART_KEY_ENTRIES = Object.entries(CUSTOM_PART_KEYS);
 const DEFAULT_RECIPE = {
@@ -444,8 +465,13 @@ function isPixelAvatarRecipe(value) {
 	if (builtInHead && !AVATAR_HEADPIECES.includes(r["headpiece"])) return false;
 	const worn = PART_KEY_ENTRIES.filter(([slot, key]) => Object.hasOwn(r, key) && !(slot === "headpiece" && builtInHead));
 	if (v3 ? worn.length === 0 : !v4 && worn.length !== 0) return false;
-	const newer = [...AVATAR_PIECE_COLORS_V4, "strand"].filter((key) => Object.hasOwn(r, key));
-	if (newer.length !== 0 && (!v4 || !AVATAR_PIECE_COLORS_V4.every((key) => !Object.hasOwn(r, key) || typeof r[key] === "string" && /^#[\da-f]{6}$/iu.test(r[key])) || Object.hasOwn(r, "strand") && !AVATAR_STRANDS.includes(r["strand"]))) return false;
+	if (!v4 && Object.hasOwn(r, CUSTOM_PART_KEYS.pattern)) return false;
+	const newer = [
+		...AVATAR_PIECE_COLORS_V4,
+		"strand",
+		"pattern"
+	].filter((key) => Object.hasOwn(r, key));
+	if (newer.length !== 0 && (!v4 || !AVATAR_PIECE_COLORS_V4.every((key) => !Object.hasOwn(r, key) || typeof r[key] === "string" && /^#[\da-f]{6}$/iu.test(r[key])) || Object.hasOwn(r, "strand") && !AVATAR_STRANDS.includes(r["strand"]) || Object.hasOwn(r, "pattern") && !AVATAR_PATTERNS.includes(r["pattern"]))) return false;
 	for (const [slot, key] of worn) {
 		const part = r[key];
 		if (!isPixelCustomPart(part) || part.slot !== slot) return false;
@@ -454,7 +480,7 @@ function isPixelAvatarRecipe(value) {
 	const extras = Object.keys(AVATAR_EXTRA_PARTS).filter((key) => Object.hasOwn(r, key));
 	const v2Keys = v2 ? 2 + pieces.length + extras.length + worn.length + newer.length + (builtInHead ? 1 : 0) : 0;
 	if (Object.keys(r).length !== Object.keys(DEFAULT_RECIPE).length + detailed + v2Keys) return false;
-	if (v2 && (detailed === 0 || !AVATAR_SPECIES.includes(r["species"]) || !AVATAR_HAIR_PARTS.sideHair.includes(r["rightSideHair"]) || !pieces.every((key) => typeof r[key] === "string" && /^#[\da-f]{6}$/iu.test(r[key])) || !extras.every((key) => AVATAR_EXTRA_PARTS[key].includes(r[key])))) return false;
+	if (v2 && (detailed === 0 || !(AVATAR_SPECIES.includes(r["species"]) || v4 && isAnimalSpecies(r["species"])) || !AVATAR_HAIR_PARTS.sideHair.includes(r["rightSideHair"]) || !pieces.every((key) => typeof r[key] === "string" && /^#[\da-f]{6}$/iu.test(r[key])) || !extras.every((key) => AVATAR_EXTRA_PARTS[key].includes(r[key])))) return false;
 	const catalog = v2 ? AVATAR_PARTS_V2 : AVATAR_PARTS;
 	return (detailed === 0 || Object.keys(AVATAR_HAIR_PARTS).every((key) => typeof r[key] === "string" && AVATAR_HAIR_PARTS[key].includes(r[key])) && Object.keys(AVATAR_RANGES).every((key) => {
 		const v = r[key];
@@ -483,6 +509,7 @@ function canonicalRecipe(recipe) {
 		}
 		if (recipe.assetVersion === 4) {
 			if (recipe.strand !== void 0) canonical["strand"] = recipe.strand;
+			if (recipe.pattern !== void 0 && recipe.pattern !== "solid") canonical["pattern"] = recipe.pattern;
 			for (const key of AVATAR_PIECE_COLORS_V4) if (recipe[key] !== void 0) canonical[key] = recipe[key].toLowerCase();
 		}
 	}
@@ -494,6 +521,11 @@ const HAIR_PIECES = [
 	"rightSideHair",
 	"backHair"
 ];
+const EAR_PIECES = [
+	"catears",
+	"bunnyears",
+	"horseears"
+];
 /**
 * Saved choices the recipe keeps but does not draw: a flower shows petals and a stem instead of
 * hair, outfit, beard and headwear, and a helmet or hood covers the hair. The choices return when
@@ -513,15 +545,22 @@ function hiddenChoices(recipe) {
 		"nose",
 		"cheeks",
 		"glasses",
-		...recipe.beard || wornPart(recipe, "beard") ? ["beard"] : []
+		...recipe.beard || wornPart(recipe, "beard") ? ["beard"] : [],
+		...recipe.pattern || wornPart(recipe, "pattern") ? ["pattern"] : []
 	];
 	const hidden = [];
 	if ((recipe.accessory === "helmet" || recipe.accessory === "hood") && !wornPart(recipe, "accessory")) hidden.push(...HAIR_PIECES, ...strand);
 	if (recipe.species === "dwarf") hidden.push("nose");
 	if (!hidden.includes("strand")) hidden.push(...bald);
+	if (isAnimalSpecies(recipe.species)) {
+		hidden.push("nose");
+		if (EAR_PIECES.includes(builtInHeadpiece(recipe) ?? "")) hidden.push("headpiece");
+		if (EAR_PIECES.includes(recipe.accessory) && !wornPart(recipe, "accessory")) hidden.push("accessory");
+	} else if (recipe.pattern || wornPart(recipe, "pattern")) hidden.push("pattern");
 	return hidden;
 }
-function withSpecies(recipe, species) {
+function withSpecies(source, species) {
+	const recipe = isAnimalSpecies(species) && source.assetVersion !== 4 ? withPieces(source) : source;
 	const detailed = detailedRecipe(recipe);
 	const previous = recipe.species ?? "human";
 	const suggested = AVATAR_SPECIES_SWATCHES[previous].includes(recipe.skinColor.toLowerCase());
@@ -534,14 +573,14 @@ function withSpecies(recipe, species) {
 	};
 }
 function withCustomPart(recipe, slot, part) {
-	const base = { ...recipe.assetVersion === 1 ? withSpecies(recipe, "human") : recipe };
+	const base = { ...slot === "pattern" && part !== void 0 ? withPieces(recipe) : recipe.assetVersion === 1 ? withSpecies(recipe, "human") : recipe };
 	const key = CUSTOM_PART_KEYS[slot];
 	delete base[key];
 	if (part !== void 0) base[key] = canonicalCustomPart({
 		...part,
 		slot
 	});
-	if (recipe.assetVersion === 4) return base;
+	if (base["assetVersion"] === 4) return base;
 	const wearing = PART_KEY_ENTRIES.some(([, k]) => base[k] !== void 0);
 	return {
 		...base,
@@ -814,6 +853,46 @@ const AVATAR_SPECIES_SWATCHES = {
 		"#e8a85a",
 		"#c98b4a",
 		"#f4f1ec"
+	],
+	cat: [
+		"#f2a65a",
+		"#9aa3ad",
+		"#3a3438",
+		"#f4f1ec",
+		"#c98b4a",
+		"#e8d2b0"
+	],
+	dog: [
+		"#c98b4a",
+		"#e8d2b0",
+		"#8a5a36",
+		"#f4f1ec",
+		"#3a3438",
+		"#d9a066"
+	],
+	fox: [
+		"#e0763a",
+		"#c4452f",
+		"#f2a65a",
+		"#f4f1ec",
+		"#8a5a36",
+		"#9aa3ad"
+	],
+	rabbit: [
+		"#f4f1ec",
+		"#d9c7b8",
+		"#9aa3ad",
+		"#8a5a36",
+		"#e8d2b0",
+		"#3a3438"
+	],
+	bear: [
+		"#8a5a36",
+		"#5a3a2a",
+		"#c98b4a",
+		"#3a3438",
+		"#f4f1ec",
+		"#d9a066"
 	]
 };
 const preset = (parts) => ({
@@ -1003,6 +1082,10 @@ const PART_SLOTS = {
 	flowerBase: {
 		width: 32,
 		height: 32
+	},
+	pattern: {
+		width: 32,
+		height: 32
 	}
 };
 /**
@@ -1028,7 +1111,8 @@ const REPLACE_PART_SLOTS = [
 	"nose",
 	"cheeks",
 	"petals",
-	"flowerBase"
+	"flowerBase",
+	"pattern"
 ];
 const isReplacePartSlot = (slot) => REPLACE_PART_SLOTS.includes(slot);
 /** Tone steps on the rig's shade ramp: two darker, the color itself, two lighter. */
@@ -2205,6 +2289,91 @@ function drawHeadpiece(style, recipe, behind, front, s, far) {
 			return;
 	}
 }
+const ANIMALS = {
+	cat: {
+		ears: [
+			"E...",
+			"EE..",
+			"EiE.",
+			"EEEE"
+		],
+		x: -9,
+		y: 2,
+		inner: "pink"
+	},
+	fox: {
+		ears: [
+			"D....",
+			"EE...",
+			"EiE..",
+			"EiiE.",
+			"EEEEE"
+		],
+		x: -10,
+		y: 1,
+		inner: "fur"
+	},
+	rabbit: {
+		ears: [
+			"EE",
+			"Ei",
+			"Ei",
+			"Ei",
+			"Ei",
+			"EE"
+		],
+		x: -6,
+		y: 0,
+		inner: "pink"
+	},
+	bear: {
+		ears: [
+			".EE.",
+			"EiiE",
+			"EEEE"
+		],
+		x: -10,
+		y: 3,
+		inner: "fur"
+	},
+	dog: {
+		ears: [
+			"EEE.",
+			"EEEE",
+			"EEEE",
+			".EEE",
+			"..EE"
+		],
+		x: -13,
+		y: 7,
+		inner: "fur",
+		side: true
+	}
+};
+function patternMask(recipe, s, fs, face) {
+	const cx = C + s;
+	const mid = C + fs * .6;
+	switch (recipe.pattern) {
+		case "tabby": {
+			let top = 0;
+			while (top < N && !face(Math.round(cx), top)) top++;
+			return (x, y) => y >= top && y <= top + 3 && Math.abs(x + .5 - cx) <= 3 && (x + 40 - Math.round(cx)) % 2 === 0 || (y === 17 || y === 19) && Math.abs(x + .5 - mid) >= 6.5;
+		}
+		case "spots": return (x, y) => [
+			[-7, 21],
+			[-6, 22],
+			[-5, 21],
+			[5, 21],
+			[6, 22],
+			[7, 21],
+			[-2, 23],
+			[2, 23]
+		].some(([dx, dy]) => x === Math.round(cx) + dx && y === dy);
+		case "patches": return (x, y) => ellipse(cx - 4, 14, 3.6, 3.2)(x, y) || ellipse(cx + 5, 9, 2.6, 2)(x, y);
+		case "colorpoint": return (x, y) => (x + .5 - cx) ** 2 / 64 + (y + .5 - 16.6) ** 2 / 49 > .62;
+		default: return () => false;
+	}
+}
 const POINTED_EARS = {
 	goblin: {
 		rows: [
@@ -2321,10 +2490,11 @@ function renderFigure(recipe, yawDeg, options, omit) {
 		return front(x - Math.round(d * (1 + Math.max(0, y - 20) * .4) - d * tuck), y);
 	} : front;
 	const flower = recipe.species === "flower";
+	const animal = isAnimalSpecies(recipe.species) ? ANIMALS[recipe.species] : void 0;
 	const hiddenNow = hiddenChoices(recipe);
 	const drawnParts = new Map(REPLACE_PART_SLOTS.flatMap((slot) => {
 		const part = wornPart(recipe, slot);
-		const shown = slot === "petals" || slot === "flowerBase" ? flower : !hiddenNow.includes(slot);
+		const shown = slot === "petals" || slot === "flowerBase" ? flower : slot === "pattern" ? animal !== void 0 : !hiddenNow.includes(slot);
 		return part && shown ? [[slot, part.front]] : [];
 	}));
 	const skip = (slot) => omit.has(slot) || drawnParts.has(slot);
@@ -2430,11 +2600,18 @@ function renderFigure(recipe, yawDeg, options, omit) {
 	placeCells(back, inked("backHair"), false);
 	overlay(back, "petals");
 	if (headpiece) placeCells(back, headpiece.back);
-	const wornHead = flower ? void 0 : builtInHeadpiece(recipe);
+	const wornHead = flower || hiddenNow.includes("headpiece") ? void 0 : builtInHeadpiece(recipe);
 	const headFront = blank();
 	if (wornHead) drawHeadpiece(wornHead, recipe, back, headFront, s, turned ? d : 0);
 	const head = blank();
 	paint(head, face, skin);
+	if (animal) {
+		const pattern = patternMask(recipe, s, fs, face);
+		if (!skip("pattern")) paint(head, (x, y) => face(x, y) && pattern(x, y), TONES[recipe.pattern === "patches" ? -2 : -1](skin));
+		overlay(head, "pattern");
+		const muzzle = ellipse(C + fs * .6, 20.6 + (recipe.height ?? 0), 3.9, 2.6);
+		paint(head, (x, y) => face(x, y) && muzzle(x, y), TONES[2](skin));
+	}
 	const h = recipe.height ?? 0;
 	if (recipe.beard && !flower && !skip("beard")) {
 		const centre = C + fs * .6;
@@ -2452,7 +2629,17 @@ function renderFigure(recipe, yawDeg, options, omit) {
 		return side < 0 ? xs[0] - 1 : xs.at(-1) + 1;
 	};
 	const pointed = recipe.species ? POINTED_EARS[recipe.species] : void 0;
-	if (flower) {} else if (pointed) {
+	if (flower) {} else if (animal) {
+		paint(head, masks.front, hairColor);
+		const pal = {
+			E: recipe.pattern === "colorpoint" || animal.side ? shade(skin, .72) : skin,
+			i: animal.inner === "pink" ? "#f4a3b5" : shade(skin, .72),
+			D: shade(skin, .45)
+		};
+		const cx = Math.round(C + s);
+		const sides = animal.side && turned ? [-d] : [-1, 1];
+		for (const side of sides) sprite(head, animal.ears, side < 0 ? cx + animal.x : cx - animal.x - animal.ears[0].length, animal.y, pal, side > 0);
+	} else if (pointed) {
 		const pal = {
 			E: skin,
 			e: shade(skin, .86),
@@ -2478,9 +2665,9 @@ function renderFigure(recipe, yawDeg, options, omit) {
 		E: skin,
 		e: shade(skin, .8)
 	});
-	if (!pointed && !flower) paint(head, masks.front, hairColor);
+	if (!pointed && !flower && !animal) paint(head, masks.front, hairColor);
 	for (const [x, y] of masks.ties ?? []) sprite(back, ["T"], Math.round(x), y, { T: shade(recipe.shirtColor, .8) });
-	if (!flower && !skip("accessory")) accessory(recipe, head, s, face);
+	if (!flower && !skip("accessory") && !hiddenNow.includes("accessory")) accessory(recipe, head, s, face);
 	const shadeHair = (g) => {
 		const out = g.map((r) => [...r]);
 		const cells = g.flatMap((row, y) => row.flatMap((c, x) => c === hairColor ? [[x, y]] : []));
@@ -2599,7 +2786,8 @@ function renderFigure(recipe, yawDeg, options, omit) {
 		sprite(features, fit(browRows, right.w), right.x, eyeTop - 2, { B: shade(hairColor, .55) }, true);
 	}
 	const cx = Math.round(C + fs * (turned ? .85 : .6));
-	if (flower) {} else if (recipe.species === "dwarf") sprite(features, [".N.", "NnN"], cx - 1, 17 + h, {
+	if (flower) {} else if (animal) sprite(features, ["NNN", ".N."], Math.round(C + fs * .6) - 1, 18 + h, { N: mix$1(INK$1, skin, .2) });
+	else if (recipe.species === "dwarf") sprite(features, [".N.", "NnN"], cx - 1, 17 + h, {
 		N: shade(skin, .84),
 		n: shade(skin, .72)
 	});
@@ -3384,5 +3572,5 @@ function symbolArtCells(rows, color) {
 }
 
 //#endregion
-export { AVATAR_COLORS, AVATAR_EXTRA_PARTS, AVATAR_HAIR_PARTS, AVATAR_HEADPIECES, AVATAR_PARTS, AVATAR_PARTS_V2, AVATAR_PIECE_COLORS, AVATAR_PIECE_COLORS_V4, AVATAR_PRESETS, AVATAR_RANGES, AVATAR_SPECIES, AVATAR_SPECIES_SWATCHES, AVATAR_STRANDS, AVATAR_SWATCHES, AVATAR_TURNS, CUSTOM_PART_KEYS, DEFAULT_RECIPE, HAIR_PART_SLOTS, MAX_PART_FIXED_COLORS, PART_LAYERS, PART_SLOTS, PART_TONES, PIXEL_SYMBOLS, REPLACE_PART_SLOTS, builtInHeadpiece, canonicalCustomPart, canonicalRecipe, createCustomPart, createSeededRecipe, createSeededRecipeV2, customPartId, detailedRecipe, ditherThreshold, emptyPartLayer, faceCells, fillPartLayer, gradientPartLayer, hairPieceStart, headpieceStart, hiddenChoices, isHairPartSlot, isPixelAvatarRecipe, isPixelCustomPart, isReplacePartSlot, mirrorPartX, noisePartLayer, paintPartLayer, partCells, partLayer, partLinePoints, partRectPoints, partToneColor, pixelAvatarSvg, pixelFigure, pixelSymbolCells, pixelTileColor, replacePartStart, seededRandom, seededRecipe, seededRecipeV2, shadePartLayer, symbolArtCells, withBuiltInHeadpiece, withCustomPart, withHeadpiece, withPieces, withSpecies, wornPart };
+export { AVATAR_ANIMAL_SPECIES, AVATAR_COLORS, AVATAR_EXTRA_PARTS, AVATAR_HAIR_PARTS, AVATAR_HEADPIECES, AVATAR_PARTS, AVATAR_PARTS_V2, AVATAR_PATTERNS, AVATAR_PIECE_COLORS, AVATAR_PIECE_COLORS_V4, AVATAR_PRESETS, AVATAR_RANGES, AVATAR_SPECIES, AVATAR_SPECIES_SWATCHES, AVATAR_STRANDS, AVATAR_SWATCHES, AVATAR_TURNS, CUSTOM_PART_KEYS, DEFAULT_RECIPE, HAIR_PART_SLOTS, MAX_PART_FIXED_COLORS, PART_LAYERS, PART_SLOTS, PART_TONES, PIXEL_SYMBOLS, REPLACE_PART_SLOTS, builtInHeadpiece, canonicalCustomPart, canonicalRecipe, createCustomPart, createSeededRecipe, createSeededRecipeV2, customPartId, detailedRecipe, ditherThreshold, emptyPartLayer, faceCells, fillPartLayer, gradientPartLayer, hairPieceStart, headpieceStart, hiddenChoices, isAnimalSpecies, isHairPartSlot, isPixelAvatarRecipe, isPixelCustomPart, isReplacePartSlot, mirrorPartX, noisePartLayer, paintPartLayer, partCells, partLayer, partLinePoints, partRectPoints, partToneColor, pixelAvatarSvg, pixelFigure, pixelSymbolCells, pixelTileColor, replacePartStart, seededRandom, seededRecipe, seededRecipeV2, shadePartLayer, symbolArtCells, withBuiltInHeadpiece, withCustomPart, withHeadpiece, withPieces, withSpecies, wornPart };
 //# sourceMappingURL=index.js.map