@botharness/pixel-avatar 0.3.0 → 0.5.0

package/dist/index.js

@@ -1,5 +1,191 @@
 import { escapeAttribute } from "@botharness/pixel-morph";
 
+//#region src/part.ts
+/**
+* Custom Part slots. A headpiece covers the top of the tile, around the hair: its back layer is
+* drawn behind the hair and its front layer over it. Cells are in tile coordinates, so the
+* Avatar centerline sits between x = 15 and x = 16.
+*/
+const PART_SLOTS = { headpiece: {
+	width: 32,
+	height: 16
+} };
+/** Tone steps on the rig's shade ramp: two darker, the color itself, two lighter. */
+const PART_TONES = [
+	-2,
+	-1,
+	0,
+	1,
+	2
+];
+const PART_LAYERS = ["front", "back"];
+/** Most fixed colors one part may use. */
+const MAX_PART_FIXED_COLORS = 16;
+const FIXED = /^#[\da-f]{6}$/iu;
+const isColor = (value) => typeof value === "string" && (AVATAR_COLORS.includes(value) || FIXED.test(value));
+function isPixelCustomPart(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+	const r = value;
+	if (Object.keys(r).length !== 3 || !Object.hasOwn(PART_SLOTS, r["slot"])) return false;
+	const { width, height } = PART_SLOTS[r["slot"]];
+	const fixed = /* @__PURE__ */ new Set();
+	for (const name of PART_LAYERS) {
+		const cells = r[name];
+		if (!Array.isArray(cells) || cells.length > width * height) return false;
+		const seen = /* @__PURE__ */ new Set();
+		for (const cell of cells) {
+			if (!Array.isArray(cell) || cell.length !== 4) return false;
+			const [x, y, color, tone] = cell;
+			if (!Number.isInteger(x) || !Number.isInteger(y) || x < 0 || x >= width || y < 0 || y >= height || !isColor(color) || !PART_TONES.includes(tone)) return false;
+			const key = y * width + x;
+			if (seen.has(key)) return false;
+			seen.add(key);
+			if (color.startsWith("#")) fixed.add(color.toLowerCase());
+		}
+	}
+	return fixed.size <= MAX_PART_FIXED_COLORS;
+}
+const canonicalCells = (cells) => cells.map(([x, y, color, tone]) => [
+	x,
+	y,
+	color.startsWith("#") ? color.toLowerCase() : color,
+	tone
+]).sort((a, b) => a[1] - b[1] || a[0] - b[0]);
+/** The part with cells in row order and fixed colors in lowercase. */
+function canonicalCustomPart(part) {
+	return {
+		slot: part.slot,
+		front: canonicalCells(part.front),
+		back: canonicalCells(part.back)
+	};
+}
+/** Content identity: a SHA-256 of the canonical slot, cells and color references. */
+function customPartId(part) {
+	return sha256(JSON.stringify(canonicalCustomPart(part)));
+}
+function emptyPartLayer(slot) {
+	const { width, height } = PART_SLOTS[slot];
+	return Array.from({ length: height }, () => Array(width).fill(null));
+}
+function partLayer(slot, cells) {
+	const layer = emptyPartLayer(slot);
+	for (const [x, y, color, tone] of cells) layer[y][x] = {
+		color,
+		tone
+	};
+	return layer;
+}
+function partCells(layer) {
+	return layer.flatMap((row, y) => row.flatMap((ink, x) => ink ? [[
+		x,
+		y,
+		ink.color,
+		ink.tone
+	]] : []));
+}
+/** Builds a canonical part from two drawn layers. */
+function createCustomPart(slot, layers) {
+	return canonicalCustomPart({
+		slot,
+		front: partCells(layers.front),
+		back: partCells(layers.back)
+	});
+}
+/** The column mirrored across the Avatar centerline. */
+function mirrorPartX(slot, x) {
+	return PART_SLOTS[slot].width - 1 - x;
+}
+const same = (a, b) => a === b || a !== null && b !== null && a.color === b.color && a.tone === b.tone;
+/** Sets cells (pencil with ink, eraser with `null`), optionally mirrored across the centerline. */
+function paintPartLayer(slot, layer, points, ink, mirror = false) {
+	const out = layer.map((row) => [...row]);
+	const { width, height } = PART_SLOTS[slot];
+	for (const [x, y] of points) for (const px of mirror ? [x, mirrorPartX(slot, x)] : [x]) if (px >= 0 && px < width && y >= 0 && y < height) out[y][px] = ink;
+	return out;
+}
+/**
+* 4-connected flood fill from a cell: every cell reachable through cells equal to the start
+* becomes `ink`. With `mirror`, the mirrored start is filled too.
+*/
+function fillPartLayer(slot, layer, x, y, ink, mirror = false) {
+	const { width, height } = PART_SLOTS[slot];
+	let out = layer.map((row) => [...row]);
+	for (const sx of mirror ? [x, mirrorPartX(slot, x)] : [x]) {
+		if (sx < 0 || sx >= width || y < 0 || y >= height) continue;
+		const target = out[y][sx];
+		if (same(target, ink)) continue;
+		const next = out.map((row) => [...row]);
+		const stack = [[sx, y]];
+		while (stack.length) {
+			const [cx, cy] = stack.pop();
+			if (cx < 0 || cx >= width || cy < 0 || cy >= height) continue;
+			if (!same(next[cy][cx], target)) continue;
+			next[cy][cx] = ink;
+			stack.push([cx + 1, cy], [cx - 1, cy], [cx, cy + 1], [cx, cy - 1]);
+		}
+		out = next;
+	}
+	return out;
+}
+const K = Uint32Array.from("428a2f98 71374491 b5c0fbcf e9b5dba5 3956c25b 59f111f1 923f82a4 ab1c5ed5 d807aa98 12835b01 243185be 550c7dc3 72be5d74 80deb1fe 9bdc06a7 c19bf174 e49b69c1 efbe4786 0fc19dc6 240ca1cc 2de92c6f 4a7484aa 5cb0a9dc 76f988da 983e5152 a831c66d b00327c8 bf597fc7 c6e00bf3 d5a79147 06ca6351 14292967 27b70a85 2e1b2138 4d2c6dfc 53380d13 650a7354 766a0abb 81c2c92e 92722c85 a2bfe8a1 a81a664b c24b8b70 c76c51a3 d192e819 d6990624 f40e3585 106aa070 19a4c116 1e376c08 2748774c 34b0bcb5 391c0cb3 4ed8aa4a 5b9cca4f 682e6ff3 748f82ee 78a5636f 84c87814 8cc70208 90befffa a4506ceb bef9a3f7 c67178f2".split(" ").map((h) => Number.parseInt(h, 16)));
+function sha256(text) {
+	const bytes = new TextEncoder().encode(text);
+	const length = Math.ceil((bytes.length + 9) / 64) * 64;
+	const data = new Uint8Array(length);
+	data.set(bytes);
+	data[bytes.length] = 128;
+	const view = new DataView(data.buffer);
+	view.setUint32(length - 8, Math.floor(bytes.length * 8 / 2 ** 32));
+	view.setUint32(length - 4, bytes.length * 8 >>> 0);
+	const h = Uint32Array.from([
+		1779033703,
+		3144134277,
+		1013904242,
+		2773480762,
+		1359893119,
+		2600822924,
+		528734635,
+		1541459225
+	]);
+	const w = new Uint32Array(64);
+	const rotr = (v, n) => v >>> n | v << 32 - n;
+	for (let offset = 0; offset < length; offset += 64) {
+		for (let i = 0; i < 16; i++) w[i] = view.getUint32(offset + i * 4);
+		for (let i = 16; i < 64; i++) {
+			const a = w[i - 15];
+			const b = w[i - 2];
+			const s0 = rotr(a, 7) ^ rotr(a, 18) ^ a >>> 3;
+			const s1 = rotr(b, 17) ^ rotr(b, 19) ^ b >>> 10;
+			w[i] = w[i - 16] + s0 + w[i - 7] + s1 >>> 0;
+		}
+		let [a, b, c, d, e, f, g, k] = h;
+		for (let i = 0; i < 64; i++) {
+			const t1 = k + (rotr(e, 6) ^ rotr(e, 11) ^ rotr(e, 25)) + (e & f ^ ~e & g) + K[i] + w[i] >>> 0;
+			const t2 = (rotr(a, 2) ^ rotr(a, 13) ^ rotr(a, 22)) + (a & b ^ a & c ^ b & c) >>> 0;
+			k = g;
+			g = f;
+			f = e;
+			e = d + t1 >>> 0;
+			d = c;
+			c = b;
+			b = a;
+			a = t1 + t2 >>> 0;
+		}
+		[
+			a,
+			b,
+			c,
+			d,
+			e,
+			f,
+			g,
+			k
+		].forEach((v, i) => h[i] = h[i] + v >>> 0);
+	}
+	return [...h].map((v) => v.toString(16).padStart(8, "0")).join("");
+}
+
+//#endregion
 //#region src/random.ts
 function seededRandom(seed) {
 	let h = 2166136261;
@@ -323,9 +509,48 @@ const AVATAR_COLORS = [
 * Avatar Species: a base on the pixel bust rig. Species share motion and anchors; each sets its
 * own ears, face details and suggested body colors. A recipe with a species is asset version 2.
 */
-const AVATAR_SPECIES = ["human", "goblin"];
+const AVATAR_SPECIES = [
+	"human",
+	"goblin",
+	"elf",
+	"dwarf",
+	"orc",
+	"flower"
+];
 /** Optional per-piece hair colors (asset version 2); an absent piece uses `hairColor`. */
 const AVATAR_PIECE_COLORS = ["leftSideHairColor", "rightSideHairColor"];
+/** Part choices that exist only in asset version 2, added after every version 1 choice. */
+const AVATAR_PARTS_V2 = {
+	...AVATAR_PARTS,
+	outfit: [
+		...AVATAR_PARTS.outfit,
+		"armor",
+		"robe",
+		"tunic",
+		"cloak"
+	],
+	accessory: [
+		...AVATAR_PARTS.accessory,
+		"helmet",
+		"hood"
+	]
+};
+/** Optional asset version 2 parts; an absent part is not drawn (or uses the first choice). */
+const AVATAR_EXTRA_PARTS = {
+	beard: [
+		"short",
+		"full",
+		"braided"
+	],
+	petals: [
+		"trumpet",
+		"daisy",
+		"sunflower",
+		"tulip",
+		"sakura"
+	],
+	flowerBase: ["leaves", "pot"]
+};
 const DEFAULT_RECIPE = {
 	schemaVersion: 1,
 	family: "illustrated",
@@ -354,16 +579,20 @@ function isPixelAvatarRecipe(value) {
 	const r = value;
 	const detailed = DETAIL_KEYS.filter((key) => Object.hasOwn(r, key)).length;
 	if (detailed !== 0 && detailed !== DETAIL_KEYS.length) return false;
-	const v2 = r["assetVersion"] === 2;
+	const v3 = r["assetVersion"] === 3;
+	const v2 = r["assetVersion"] === 2 || v3;
+	if (v3 ? !isPixelCustomPart(r["headpiece"]) : Object.hasOwn(r, "headpiece")) return false;
 	const pieces = AVATAR_PIECE_COLORS.filter((key) => Object.hasOwn(r, key));
-	const v2Keys = v2 ? 2 + pieces.length : 0;
+	const extras = Object.keys(AVATAR_EXTRA_PARTS).filter((key) => Object.hasOwn(r, key));
+	const v2Keys = v2 ? 2 + pieces.length + extras.length + (v3 ? 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])))) 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;
+	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];
 		const [min, max] = AVATAR_RANGES[key];
 		return typeof v === "number" && Number.isInteger(v) && v >= min && v <= max;
-	})) && r["schemaVersion"] === 1 && r["family"] === "illustrated" && (r["assetVersion"] === 1 || v2) && r["rigVersion"] === 1 && PART_KEYS.every((key) => typeof r[key] === "string" && AVATAR_PARTS[key].includes(r[key])) && AVATAR_COLORS.every((key) => typeof r[key] === "string" && /^#[\da-f]{6}$/iu.test(r[key]));
+	})) && r["schemaVersion"] === 1 && r["family"] === "illustrated" && (r["assetVersion"] === 1 || v2) && r["rigVersion"] === 1 && PART_KEYS.every((key) => typeof r[key] === "string" && catalog[key].includes(r[key])) && AVATAR_COLORS.every((key) => typeof r[key] === "string" && /^#[\da-f]{6}$/iu.test(r[key]));
 }
 function canonicalRecipe(recipe) {
 	const canonical = {
@@ -375,31 +604,71 @@ function canonicalRecipe(recipe) {
 	for (const key of PART_KEYS) canonical[key] = recipe[key];
 	for (const key of AVATAR_COLORS) canonical[key] = recipe[key].toLowerCase();
 	if (recipe.bangs !== void 0) for (const key of DETAIL_KEYS) canonical[key] = recipe[key];
-	if (recipe.assetVersion === 2) {
+	if (recipe.assetVersion !== 1) {
 		canonical["species"] = recipe.species;
 		canonical["rightSideHair"] = recipe.rightSideHair;
 		for (const key of AVATAR_PIECE_COLORS) if (recipe[key] !== void 0) canonical[key] = recipe[key].toLowerCase();
+		for (const key of Object.keys(AVATAR_EXTRA_PARTS)) if (recipe[key] !== void 0) canonical[key] = recipe[key];
+		if (recipe.assetVersion === 3) canonical["headpiece"] = canonicalCustomPart(recipe.headpiece);
 	}
 	return canonical;
 }
+const HAIR_PIECES = [
+	"bangs",
+	"sideHair",
+	"rightSideHair",
+	"backHair"
+];
 /**
-* Returns the recipe as asset version 2 with the given species, keeping every other choice.
-* Side hair splits into left (`sideHair`) and right (`rightSideHair`) pieces that start equal.
-* 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.
+* 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
+* the species or headwear changes back.
 */
+function hiddenChoices(recipe) {
+	if (recipe.species === "flower") return [
+		...HAIR_PIECES,
+		"outfit",
+		"accessory",
+		"eyes",
+		"brows",
+		"nose",
+		"cheeks",
+		"glasses",
+		...recipe.beard ? ["beard"] : []
+	];
+	const hidden = [];
+	if (recipe.accessory === "helmet" || recipe.accessory === "hood") hidden.push(...HAIR_PIECES);
+	if (recipe.species === "dwarf") hidden.push("nose");
+	return hidden;
+}
 function withSpecies(recipe, species) {
 	const detailed = detailedRecipe(recipe);
 	const previous = recipe.species ?? "human";
 	const suggested = AVATAR_SPECIES_SWATCHES[previous].includes(recipe.skinColor.toLowerCase());
 	return {
 		...detailed,
-		assetVersion: 2,
+		assetVersion: recipe.assetVersion === 3 ? 3 : 2,
 		species,
 		rightSideHair: detailed.rightSideHair ?? detailed.sideHair,
 		skinColor: suggested && previous !== species ? AVATAR_SPECIES_SWATCHES[species][0] : recipe.skinColor
 	};
 }
+/**
+* Returns the recipe wearing a Custom Part in the headpiece slot (asset version 3), or without
+* one (asset version 2). The recipe embeds its own copy of the part.
+*/
+function withHeadpiece(recipe, part) {
+	const { headpiece: _, ...rest } = recipe.assetVersion === 1 ? withSpecies(recipe, "human") : recipe;
+	if (part === void 0) return {
+		...rest,
+		assetVersion: 2
+	};
+	return {
+		...rest,
+		assetVersion: 3,
+		headpiece: canonicalCustomPart(part)
+	};
+}
 function detailedRecipe(recipe) {
 	if (recipe.bangs !== void 0) return recipe;
 	const pick = (part) => AVATAR_HAIR_PARTS[part].includes(recipe.hair) ? recipe.hair : HAIR_SPLIT[recipe.hair][part];
@@ -551,6 +820,38 @@ function createSeededRecipe(namespace) {
 		return recipe;
 	};
 }
+/**
+* A version 2 name-seeded recipe factory over every species. Species are equally likely; a
+* person may get a beard or a version 2 outfit, and a flower gets petals and a base. Version 1
+* factories (`createSeededRecipe`) keep their faces, so a consumer chooses per identity which
+* seed version it was created with.
+*/
+function createSeededRecipeV2(namespace) {
+	const base = createSeededRecipe(`${namespace}:base`);
+	return (seed) => {
+		const random = seededRandom(`${namespace}:${seed.trim().toLowerCase()}`);
+		const pick = (values) => values[Math.floor(random() * values.length)];
+		const species = pick(AVATAR_SPECIES);
+		const recipe = {
+			...withSpecies(base(seed), species),
+			skinColor: pick(AVATAR_SPECIES_SWATCHES[species])
+		};
+		if (species === "flower") return {
+			...recipe,
+			petals: pick(AVATAR_EXTRA_PARTS.petals),
+			flowerBase: pick(AVATAR_EXTRA_PARTS.flowerBase)
+		};
+		const beard = random() < .3 ? pick(AVATAR_EXTRA_PARTS.beard) : void 0;
+		const outfit = random() < .25 ? pick(AVATAR_PARTS_V2.outfit.slice(-4)) : recipe.outfit;
+		return {
+			...recipe,
+			outfit,
+			...beard ? { beard } : {}
+		};
+	};
+}
+/** Version 2 counterpart of `seededRecipe` (BotHarness's namespace). */
+const seededRecipeV2 = createSeededRecipeV2("botharness-avatar-v2");
 /** The same name always gives the same face (BotHarness's namespace). */
 const seededRecipe = createSeededRecipe("botharness-avatar");
 /** Suggested body colors per species; any color remains allowed. */
@@ -563,6 +864,38 @@ const AVATAR_SPECIES_SWATCHES = {
 		"#b3cf7a",
 		"#5c8a4a",
 		"#8fa86a"
+	],
+	elf: [
+		"#fbe7d6",
+		"#f2d3c0",
+		"#e2c9b0",
+		"#d9c7e8",
+		"#b9c6dd",
+		"#8f7fa8"
+	],
+	dwarf: [
+		"#f2c4a0",
+		"#e9b08a",
+		"#e0a87e",
+		"#c68863",
+		"#f0b8a0",
+		"#9a6142"
+	],
+	orc: [
+		"#8a9a5b",
+		"#6f8a4e",
+		"#7d8c6a",
+		"#5f6f4a",
+		"#9aa070",
+		"#6a7a7a"
+	],
+	flower: [
+		"#f6d36b",
+		"#f2b84b",
+		"#ffe3cf",
+		"#e8a85a",
+		"#c98b4a",
+		"#f4f1ec"
 	]
 };
 const preset = (parts) => ({
@@ -722,6 +1055,17 @@ const mix$1 = (base, tint, k) => {
 	const t = channels$1(tint);
 	return hex(channels$1(base).map((v, i) => v * (1 - k) + t[i] * k));
 };
+const TONES = {
+	[-2]: (c) => shade(c, .62),
+	[-1]: (c) => shade(c, .8),
+	0: (c) => c,
+	1: (c) => mix$1(c, WHITE, .25),
+	2: (c) => mix$1(c, WHITE, .5)
+};
+/** The color a Custom Part cell shows at a tone step on the rig's shade ramp. */
+function partToneColor(color, tone) {
+	return TONES[tone](color.toLowerCase());
+}
 function paint(grid, test, color) {
 	for (let y = 0; y < N; y++) for (let x = 0; x < N; x++) if (test(x, y)) grid[y][x] = color;
 }
@@ -1121,6 +1465,34 @@ function outfit(recipe, g, s) {
 			paint(g, (x, y) => y === 24 && Math.abs(dx(x)) <= 4.5, WHITE);
 			sprite(g, ["RR.RR", ".RRR."], Math.round(C + s * .5) - 2, 24, { R: shirt });
 			break;
+		case "armor": {
+			const metal = "#9aa3ad";
+			paint(g, torso, metal);
+			paint(g, (x, y) => torso(x, y) && y >= 26 && Math.abs(dx(x)) <= 2.5, shirt);
+			paint(g, (x, y) => torso(x, y) && y <= 26 && Math.abs(dx(x)) >= half(y) - 3.5, mix$1(metal, WHITE, .35));
+			paint(g, (x, y) => torso(x, y) && y === 27 && Math.abs(dx(x)) >= half(y) - 3.5, shade(metal, .7));
+			paint(g, (x, y) => y === 24 && Math.abs(dx(x)) <= 3.5, shade(metal, .8));
+			sprite(g, ["G"], Math.round(C + s * .5), 28, { G: GOLD });
+			break;
+		}
+		case "robe":
+			paint(g, v(5, 4), mix$1(shirt, WHITE, .7));
+			paint(g, (x, y) => torso(x, y) && y <= 29 && Math.abs(Math.abs(dx(x)) - (4 - (y - 24) * .8)) <= .5, GOLD);
+			paint(g, (x, y) => torso(x, y) && y >= 28 && Math.abs(dx(x)) >= half(y) - 1.5, dark);
+			break;
+		case "tunic":
+			paint(g, v(2, 2), shade(skin, .85));
+			sprite(g, ["L.L", ".L."], Math.round(C + s * .5) - 1, 25, { L: "#6b4a2b" });
+			paint(g, (x, y) => torso(x, y) && y === 29, "#6b4a2b");
+			sprite(g, ["G"], Math.round(C + s * .5), 29, { G: GOLD });
+			break;
+		case "cloak": {
+			const cloak = mix$1(shirt, "#2f3a4a", .55);
+			paint(g, (x, y) => torso(x, y) && Math.abs(dx(x)) >= 2.5, cloak);
+			paint(g, (x, y) => torso(x, y) && y === 24, shade(cloak, .8));
+			sprite(g, ["G...G"], Math.round(C + s * .5) - 2, 25, { G: GOLD });
+			break;
+		}
 		case "jacket":
 			paint(g, v(6, 4.5), WHITE);
 			paint(g, (x, y) => torso(x, y) && Math.abs(Math.abs(dx(x)) - (4.5 - (y - 24) * .6)) <= .6, dark);
@@ -1239,6 +1611,22 @@ function accessory(recipe, g, s, face) {
 			}, true);
 			return;
 		}
+		case "helmet": {
+			const metal = "#9aa3ad";
+			paint(g, (x, y) => cap(x, y) && y <= 11, metal);
+			paint(g, (x, y) => cap(x, y) && y === 11, shade(metal, .75));
+			paint(g, (x, y) => cap(x, y) && y >= 12 && y <= 19 && Math.abs(x + .5 - C - s) >= 7.5, metal);
+			paint(g, (x, y) => Math.abs(x + .5 - C - s) <= .5 && y >= 11 && y <= 16, shade(metal, .7));
+			paint(g, (x, y) => cap(x, y) && y >= 2 && y <= 5 && x + .5 < C + s - 2, mix$1(metal, WHITE, .4));
+			for (let x = Math.round(C + s) - 9; x <= Math.round(C + s) + 9; x += 3) sprite(g, ["G"], x, 10, { G: GOLD });
+			return;
+		}
+		case "hood": {
+			const outer = ellipse(C + s, 15, 12.6, 12.4);
+			paint(g, (x, y) => outer(x, y) && y <= 25 && !(face(x, y) && y >= 10), shirt);
+			paint(g, (x, y) => outer(x, y) && !face(x, y) && y >= 9 && (face(x + 1, y) || face(x - 1, y) || face(x, y + 1)), shade(shirt, .7));
+			return;
+		}
 		case "beret":
 			paint(g, (x, y) => ellipse(C + s + 1.5, 4.6, 10.5, 3.6)(x, y), shirt);
 			paint(g, (x, y) => ellipse(C + s + 1.5, 4.6, 10.5, 3.6)(x, y) && y >= 6, shade(shirt, .78));
@@ -1334,6 +1722,75 @@ function accessory(recipe, g, s, face) {
 			return;
 	}
 }
+const POINTED_EARS = {
+	goblin: {
+		rows: [
+			"E...",
+			"EE..",
+			".EiE",
+			"..Ee"
+		],
+		rise: 2
+	},
+	elf: {
+		rows: [
+			"E....",
+			"EE...",
+			".EE..",
+			"..EiE",
+			"...Ee"
+		],
+		rise: 3
+	},
+	orc: {
+		rows: [
+			"E..",
+			"EE.",
+			".Ee"
+		],
+		rise: 1
+	}
+};
+const leafShape = (cx, cy, long, wide, angle) => (x, y) => {
+	const px = x + .5 - cx;
+	const py = y + .5 - cy;
+	const u = px * Math.cos(angle) + py * Math.sin(angle);
+	const v = -px * Math.sin(angle) + py * Math.cos(angle);
+	return (u / long) ** 2 + (v / wide) ** 2 <= 1;
+};
+function petals(style, s) {
+	const cx = C + s;
+	const cy = 16.6;
+	const ring = (n, radius, long, wide, phase = 0) => (x, y) => Array.from({ length: n }, (_, k) => phase + 2 * Math.PI * k / n).some((a) => leafShape(cx + radius * Math.cos(a), cy + radius * Math.sin(a), long, wide, a)(x, y));
+	switch (style) {
+		case "daisy": return ring(14, 10.4, 3.4, 1.7, Math.PI / 14);
+		case "sunflower": return (x, y) => ring(16, 11.2, 2.6, 1.5)(x, y) || ellipse(cx, cy, 10.6, 10.2)(x, y);
+		case "tulip": return (x, y) => y <= cy + 6 && (ellipse(cx - 6.5, cy - 3, 4.5, 7.5)(x, y) || ellipse(cx + 6.5, cy - 3, 4.5, 7.5)(x, y) || ellipse(cx, cy - 6, 5, 8)(x, y));
+		case "trumpet": return (x, y) => ellipse(cx, cy - .5, 11.6, 10.4)(x, y) || y <= cy - 6 && ellipse(cx, cy - 3, 13, 8.6)(x, y);
+		case "sakura": return (x, y) => ring(5, 8.6, 4.6, 3.8, -Math.PI / 2)(x, y) && !ring(5, 13.4, 1.4, 1.4, -Math.PI / 2)(x, y);
+	}
+}
+function flowerBase(recipe, g, s) {
+	const leaf = "#5f9e4a";
+	const stem = C + s * .5;
+	paint(g, (x, y) => y >= 22 && Math.abs(x + .5 - stem) <= 1, shade(leaf, .82));
+	if (recipe.flowerBase === "pot") {
+		const pot = recipe.shirtColor;
+		const body = (x, y) => y >= 27 && Math.abs(x + .5 - stem) <= 6.5 - (y - 27) * .45;
+		paint(g, leafShape(stem - 3, 25, 2.8, 1.2, -.5), leaf);
+		paint(g, leafShape(stem + 3, 24.5, 2.8, 1.2, .5), shade(leaf, .9));
+		paint(g, body, pot);
+		paint(g, (x, y) => body(x, y) && y === 27, mix$1(pot, WHITE, .3));
+		paint(g, (x, y) => body(x, y) && y >= 28 && x + .5 > stem + 3, shade(pot, .8));
+		return;
+	}
+	const left = leafShape(stem - 4.5, 27, 4.4, 1.9, -.55);
+	const right = leafShape(stem + 4.5, 25.5, 4.4, 1.9, .55);
+	paint(g, left, leaf);
+	paint(g, right, shade(leaf, .92));
+	paint(g, leafShape(stem - 4.5, 27, 3.6, .5, -.55), shade(leaf, .75));
+	paint(g, leafShape(stem + 4.5, 25.5, 3.6, .5, .55), shade(leaf, .7));
+}
 function pixelTileColor(hair) {
 	const [r, g, b] = channels$1(hair).map((v) => v / 255);
 	const max = Math.max(r, g, b);
@@ -1371,34 +1828,72 @@ function pixelFigure(recipe, yawDeg, options = {}) {
 		const tuck = y >= 17 && d * dx > 4 ? Math.min(2, (y - 16) * .35) : 0;
 		return front(x - Math.round(d * (1 + Math.max(0, y - 20) * .4) - d * tuck), y);
 	} : front;
-	const masks = recipe.bangs === void 0 ? hair(recipe, s, b) : detailedHair(recipe, s, b);
+	const flower = recipe.species === "flower";
+	const covered = recipe.accessory === "helmet" || recipe.accessory === "hood";
+	const bare = () => false;
+	const petalRing = flower ? petals(recipe.petals ?? "trumpet", s) : bare;
+	const masks = flower ? {
+		back: petalRing,
+		front: bare,
+		sides: [(x, y) => petalRing(x, y) && x + .5 < C + s, (x, y) => petalRing(x, y) && x + .5 >= C + s]
+	} : covered ? {
+		back: bare,
+		front: bare
+	} : recipe.bangs === void 0 ? hair(recipe, s, b) : detailedHair(recipe, s, b);
 	const body = blank();
-	outfit(recipe, body, s);
+	if (flower) flowerBase(recipe, body, s);
+	else outfit(recipe, body, s);
 	const back = blank();
-	paint(back, masks.back, shade(hairColor, .82));
+	if (flower) {
+		paint(back, petalRing, hairColor);
+		paint(back, (x, y) => petalRing(x, y) && (x + .5 - C - s) ** 2 + (y + .5 - 16.6) ** 2 < 90, shade(hairColor, .84));
+		paint(back, (x, y) => petalRing(x, y) && x + .5 < C + s - 3 && y < 10, mix$1(hairColor, WHITE, .3));
+	} else paint(back, masks.back, shade(hairColor, .82));
 	if (masks.bands) paint(back, (x, y) => masks.back(x, y) && (y + Math.floor(x / 2)) % 4 === 0, shade(hairColor, .68));
+	const headpiece = recipe.assetVersion === 3 ? recipe.headpiece : void 0;
+	const placeCells = (grid, cells) => {
+		const placed = cells.map(([x, y, color, tone]) => {
+			const dx = x + .5 - C;
+			const far = turned && d * dx < 0 && Math.abs(dx) >= 5;
+			const base = color.startsWith("#") ? color.toLowerCase() : recipe[color];
+			return {
+				x: x + s + (far ? d : 0),
+				y,
+				c: TONES[tone](base),
+				far
+			};
+		});
+		for (const cell of [...placed.filter((p) => p.far), ...placed.filter((p) => !p.far)]) if (cell.x >= 0 && cell.x < N) grid[cell.y][cell.x] = cell.c;
+	};
+	if (headpiece) placeCells(back, headpiece.back);
 	const head = blank();
 	paint(head, face, skin);
+	const h = recipe.height ?? 0;
+	if (recipe.beard && !flower) {
+		const centre = C + fs * .6;
+		const mouthX = Math.round(C - .5 + fs * .6);
+		const chin = (x, y) => face(x, y) || face(x, y - 2);
+		const open = (x, y) => y >= 20 + h && y <= 22 + h && Math.abs(x - mouthX) <= 3;
+		const full = (x, y) => chin(x, y) && (y >= 22 + h || Math.abs(x + .5 - centre) >= 4 && y >= 17 + h);
+		const shape = recipe.beard === "short" ? (x, y) => chin(x, y) && y >= 22 + h : recipe.beard === "full" ? full : (x, y) => full(x, y) || Math.abs(x + .5 - centre) <= 1 && y >= 24 && y <= 30;
+		paint(head, (x, y) => shape(x, y) && !open(x, y), shade(hairColor, .9));
+		paint(head, (x, y) => shape(x, y) && !open(x, y) && (x + y * 2) % 5 === 0, shade(hairColor, .72));
+	}
 	const earY = 15;
 	const edge = (side) => {
 		const xs = [...Array(N).keys()].filter((x) => face(x, earY));
 		return side < 0 ? xs[0] - 1 : xs.at(-1) + 1;
 	};
-	const goblin = recipe.species === "goblin";
-	if (goblin) {
-		const ear = [
-			"E...",
-			"EE..",
-			".EiE",
-			"..Ee"
-		];
+	const pointed = recipe.species ? POINTED_EARS[recipe.species] : void 0;
+	if (flower) {} else if (pointed) {
 		const pal = {
 			E: skin,
 			e: shade(skin, .86),
 			i: shade(skin, .74)
 		};
+		const width = pointed.rows[0].length;
 		paint(head, masks.front, hairColor);
-		for (const ex of turned ? [-d] : [-1, 1]) sprite(head, ear, ex < 0 ? edge(ex) - 3 : edge(ex), earY - 2, pal, ex > 0);
+		for (const ex of turned ? [-d] : [-1, 1]) sprite(head, pointed.rows, ex < 0 ? edge(ex) - (width - 1) : edge(ex), earY - pointed.rise, pal, ex > 0);
 	} else if (!turned) for (const ex of [-1, 1]) sprite(head, [
 		"E",
 		"E",
@@ -1416,9 +1911,9 @@ function pixelFigure(recipe, yawDeg, options = {}) {
 		E: skin,
 		e: shade(skin, .8)
 	});
-	if (!goblin) paint(head, masks.front, hairColor);
+	if (!pointed && !flower) paint(head, masks.front, hairColor);
 	for (const [x, y] of masks.ties ?? []) sprite(back, ["T"], Math.round(x), y, { T: shade(recipe.shirtColor, .8) });
-	accessory(recipe, head, s, face);
+	if (!flower) 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]] : []));
@@ -1459,18 +1954,20 @@ function pixelFigure(recipe, yawDeg, options = {}) {
 		}
 		return out;
 	};
+	const crown = blank();
+	if (headpiece) placeCells(crown, headpiece.front);
 	const figure = blank();
 	for (const layer of [
 		back,
 		body,
-		shadeHair(head)
+		shadeHair(head),
+		crown
 	]) for (let y = 0; y < N; y++) for (let x = 0; x < N; x++) if (layer[y][x]) figure[y][x] = layer[y][x];
 	const features = blank();
 	const eyes = blank();
 	const closed = blank();
 	const glasses = blank();
 	const sp = recipe.spacing ?? 0;
-	const h = recipe.height ?? 0;
 	const eyeTop = 15 + h;
 	const eyeW = (side) => turned && Math.sign(fs) === side ? 3 : 4;
 	const eyeX = (side) => {
@@ -1493,21 +1990,47 @@ function pixelFigure(recipe, yawDeg, options = {}) {
 		I: recipe.eyeColor,
 		L: mix$1(recipe.eyeColor, WHITE, .45)
 	};
-	const style = EYES[recipe.eyes];
-	const extra = style[0].length - 4;
-	sprite(eyes, fit(style, left.w + extra), left.x - extra, eyeTop, pal);
-	sprite(eyes, recipe.eyes === "wink" ? fit(CLOSED, right.w) : fit(style, right.w + extra), right.x, eyeTop, pal, true);
-	sprite(closed, fit(CLOSED, left.w), left.x, eyeTop, pal);
-	sprite(closed, fit(CLOSED, right.w), right.x, eyeTop, pal, true);
-	const browRows = BROWS[recipe.brows];
+	if (flower) {
+		const centre = Math.round(C + fs * .6);
+		const bead = {
+			K: "#1d1b22",
+			W: WHITE
+		};
+		for (const ex of [centre - 3, centre + 1]) {
+			sprite(eyes, [
+				"KK",
+				"KW",
+				"KK",
+				"KK"
+			], ex, eyeTop - 1, bead);
+			sprite(closed, [
+				"..",
+				"..",
+				"KK",
+				".."
+			], ex, eyeTop - 1, bead);
+		}
+	} else {
+		const style = EYES[recipe.eyes];
+		const extra = style[0].length - 4;
+		sprite(eyes, fit(style, left.w + extra), left.x - extra, eyeTop, pal);
+		sprite(eyes, recipe.eyes === "wink" ? fit(CLOSED, right.w) : fit(style, right.w + extra), right.x, eyeTop, pal, true);
+		sprite(closed, fit(CLOSED, left.w), left.x, eyeTop, pal);
+		sprite(closed, fit(CLOSED, right.w), right.x, eyeTop, pal, true);
+	}
+	const browRows = flower ? [] : BROWS[recipe.brows];
 	if (browRows.length) {
 		sprite(features, fit(browRows, left.w), left.x, eyeTop - 2, { B: shade(hairColor, .55) });
 		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 (recipe.nose === "dot") sprite(features, ["N"], cx, 18 + h, { N: shade(skin, .78) });
-	if (recipe.nose === "button") sprite(features, ["N"], cx, 18 + h, { N: shade(skin, .88) });
-	if (recipe.nose === "line") sprite(features, ["N", "N"], cx, 17 + h, { N: shade(skin, .82) });
+	if (flower) {} else if (recipe.species === "dwarf") sprite(features, [".N.", "NnN"], cx - 1, 17 + h, {
+		N: shade(skin, .84),
+		n: shade(skin, .72)
+	});
+	else if (recipe.nose === "dot") sprite(features, ["N"], cx, 18 + h, { N: shade(skin, .78) });
+	else if (recipe.nose === "button") sprite(features, ["N"], cx, 18 + h, { N: shade(skin, .88) });
+	else if (recipe.nose === "line") sprite(features, ["N", "N"], cx, 17 + h, { N: shade(skin, .82) });
 	const mx = C - .5 + fs * .6;
 	const withMouth = (mouth) => {
 		const layer = features.map((row) => [...row]);
@@ -1518,11 +2041,12 @@ function pixelFigure(recipe, yawDeg, options = {}) {
 			W: WHITE
 		});
 		if (recipe.species === "goblin") for (const tx of [Math.round(mx - 2.5), Math.round(mx + 2.5)]) sprite(layer, ["T"], tx, 21 + h, { T: TUSK });
-		if (recipe.cheeks === "blush") {
+		if (recipe.species === "orc") for (const tx of [Math.round(mx - 2.5), Math.round(mx + 2.5)]) sprite(layer, ["T", "T"], tx, 20 + h, { T: TUSK });
+		if (recipe.cheeks === "blush" && !flower) {
 			sprite(layer, ["PP"], left.x - 1, 19 + h, { P: mix$1(BLUSH, skin, .25) });
 			sprite(layer, ["PP"], right.x + right.w - 1, 19 + h, { P: mix$1(BLUSH, skin, .25) });
 		}
-		if (recipe.cheeks === "freckles") {
+		if (recipe.cheeks === "freckles" && !flower) {
 			sprite(layer, ["F.F"], left.x, 19 + h, { F: shade(skin, .7) });
 			sprite(layer, ["F.F"], right.x + 1, 19 + h, { F: shade(skin, .7) });
 		}
@@ -1545,17 +2069,18 @@ function pixelFigure(recipe, yawDeg, options = {}) {
 		const corner = (x === fx - 1 || x === fx + w) && (y === eyeTop - 1 || y === eyeTop + 4);
 		return box && !inside && !(round && corner);
 	}, INK$1);
-	if (recipe.glasses === "round" || recipe.glasses === "square") {
-		frame(left.x, left.w, recipe.glasses === "round");
-		frame(right.x, right.w, recipe.glasses === "round");
+	const lenses = flower ? "none" : recipe.glasses;
+	if (lenses === "round" || lenses === "square") {
+		frame(left.x, left.w, lenses === "round");
+		frame(right.x, right.w, lenses === "round");
 		paint(glasses, (x, y) => y === eyeTop + 1 && x > left.x + left.w && x < right.x - 1, INK$1);
 	}
-	if (recipe.glasses === "shades") {
+	if (lenses === "shades") {
 		for (const e of [left, right]) paint(glasses, (x, y) => x >= e.x - 1 && x <= e.x + e.w && y >= eyeTop && y <= eyeTop + 2, INK$1);
 		paint(glasses, (x, y) => y === eyeTop && x > left.x + left.w && x < right.x - 1, INK$1);
 		for (const e of [left, right]) sprite(glasses, ["W"], e.x, eyeTop, { W: "#7d7b88" });
 	}
-	if (recipe.glasses === "monocle") {
+	if (lenses === "monocle") {
 		frame(right.x, right.w, true);
 		sprite(glasses, [
 			"G",
@@ -1583,7 +2108,7 @@ function pixelFigure(recipe, yawDeg, options = {}) {
 	for (let y = 0; y < N; y++) for (let x = 0; x < N; x++) {
 		const c = full[y][x];
 		if (!c) continue;
-		if (y >= 22 && !head[y][x] && !back[y][x]) bodyCells[y][x] = c;
+		if (y >= 22 && !head[y][x] && !back[y][x] && !crown[y][x]) bodyCells[y][x] = c;
 		else headCells[y][x] = c;
 	}
 	const cells = [];
@@ -2131,5 +2656,5 @@ function symbolArtCells(rows, color) {
 }
 
 //#endregion
-export { AVATAR_COLORS, AVATAR_HAIR_PARTS, AVATAR_PARTS, AVATAR_PIECE_COLORS, AVATAR_PRESETS, AVATAR_RANGES, AVATAR_SPECIES, AVATAR_SPECIES_SWATCHES, AVATAR_SWATCHES, AVATAR_TURNS, DEFAULT_RECIPE, PIXEL_SYMBOLS, canonicalRecipe, createSeededRecipe, detailedRecipe, faceCells, isPixelAvatarRecipe, pixelAvatarSvg, pixelFigure, pixelSymbolCells, pixelTileColor, seededRandom, seededRecipe, symbolArtCells, withSpecies };
+export { AVATAR_COLORS, AVATAR_EXTRA_PARTS, AVATAR_HAIR_PARTS, AVATAR_PARTS, AVATAR_PARTS_V2, AVATAR_PIECE_COLORS, AVATAR_PRESETS, AVATAR_RANGES, AVATAR_SPECIES, AVATAR_SPECIES_SWATCHES, AVATAR_SWATCHES, AVATAR_TURNS, DEFAULT_RECIPE, MAX_PART_FIXED_COLORS, PART_LAYERS, PART_SLOTS, PART_TONES, PIXEL_SYMBOLS, canonicalCustomPart, canonicalRecipe, createCustomPart, createSeededRecipe, createSeededRecipeV2, customPartId, detailedRecipe, emptyPartLayer, faceCells, fillPartLayer, hiddenChoices, isPixelAvatarRecipe, isPixelCustomPart, mirrorPartX, paintPartLayer, partCells, partLayer, partToneColor, pixelAvatarSvg, pixelFigure, pixelSymbolCells, pixelTileColor, seededRandom, seededRecipe, seededRecipeV2, symbolArtCells, withHeadpiece, withSpecies };
 //# sourceMappingURL=index.js.map