@pieai/swimmer-avatar-kit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PieAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE.md

@@ -0,0 +1,23 @@
+# Third-Party Notice
+
+SwimmerAvatarKit includes an unmodified dependency closure from
+[kindergrimm](https://github.com/albertobeiz/kindergrimm):
+
+- Source repository: `https://github.com/albertobeiz/kindergrimm.git`
+- Pinned commit: `811214c6dd5de18cc20335cd3d4ab0a06e45ffd4`
+- Commit date: 2026-08-21
+- Imported: 2026-08-22
+- Upstream license: Unlicense (public domain)
+
+The imported files live under `vendor/kindergrimm/`. The original license is
+preserved at `vendor/kindergrimm/LICENSE`. It expressly permits copying,
+modification, publication, commercial use, sale, and distribution.
+
+`upstream-lock.json` records every imported file's Git blob hash. The two
+upstream browser demo entry points, `src/gloss/gloss.js` and
+`src/gloss/gcrowd.js`, are intentionally excluded; they are applications, not
+part of the reusable generator dependency closure.
+
+PieAI's TypeScript adapters, tests, automation, and documentation are licensed
+under the root MIT license. The imported Kindergrimm files remain under the
+Unlicense.

package/README.md

@@ -0,0 +1,125 @@
+# SwimmerAvatarKit
+
+SwimmerAvatarKit is PieAI's shared procedural 3D avatar package. It turns a
+small, reproducible JSON recipe into a glossy chibi Three.js character and
+provides an optional React Three Fiber component.
+
+The GLOSS art generator is vendored unchanged from Kindergrimm under the
+Unlicense. SwimmerAvatarKit owns the stable TypeScript API, recipe persistence,
+resource lifecycle, tests, and release process around it.
+
+## Install
+
+```bash
+pnpm add @pieai/swimmer-avatar-kit three
+```
+
+React Three Fiber consumers also install compatible React and R3F versions:
+
+```bash
+pnpm add react @react-three/fiber
+```
+
+## React Three Fiber
+
+```tsx
+import { Canvas } from "@react-three/fiber";
+import { randomRecipe } from "@pieai/swimmer-avatar-kit";
+import { Avatar } from "@pieai/swimmer-avatar-kit/react-three-fiber";
+
+const recipe = randomRecipe("user-42");
+
+export function ProfileAvatar() {
+  return (
+    <Canvas camera={{ position: [0, 1, 5] }}>
+      <ambientLight intensity={1.2} />
+      <Avatar recipe={recipe} gaze scale={0.8} position={[0, -1, 0]} />
+    </Canvas>
+  );
+}
+```
+
+`Avatar` acquires a renderer-scoped material-library lease by default. Many
+avatars on one canvas therefore share materials and one studio environment;
+the last unmount releases them.
+
+## Framework-neutral Three.js
+
+```ts
+import {
+  buildAvatar,
+  randomRecipe,
+} from "@pieai/swimmer-avatar-kit";
+import {
+  createStudioMaterialLibrary,
+} from "@pieai/swimmer-avatar-kit/materials";
+
+const materials = createStudioMaterialLibrary(renderer);
+const avatar = buildAvatar(randomRecipe("user-42"), {
+  materialFor: materials.materialFor,
+});
+
+scene.add(avatar.object);
+
+function frame(deltaSeconds: number) {
+  avatar.update(deltaSeconds);
+  renderer.render(scene, camera);
+}
+
+// Avatar geometry and shared materials have separate owners.
+avatar.dispose();
+materials.dispose();
+```
+
+Never dispose mesh materials while another avatar can still share them.
+`avatar.dispose()` intentionally disposes geometry only. The material library
+owns and disposes its cache.
+
+## Reproducible and persistable recipes
+
+```ts
+import {
+  deserializeAvatarRecipe,
+  randomRecipe,
+  serializeAvatarRecipe,
+} from "@pieai/swimmer-avatar-kit";
+
+const recipe = randomRecipe("account:42");
+const stored = serializeAvatarRecipe(recipe);
+const restored = deserializeAvatarRecipe(stored);
+```
+
+The serialized form uses a versioned SwimmerAvatarKit envelope. Where that
+string is stored is a product decision: v0.1 supports local or product-owned
+storage and does not couple avatars to SwimmerBackend or declare a cross-product
+identity policy.
+
+## Entry points
+
+| Entry point | Purpose | Runtime |
+| --- | --- | --- |
+| `@pieai/swimmer-avatar-kit` | Recipes, metadata, build/update/dispose | Three.js |
+| `@pieai/swimmer-avatar-kit/materials` | Gloss materials and studio environment | Browser/WebGL |
+| `@pieai/swimmer-avatar-kit/react-three-fiber` | `<Avatar />` adapter | React + R3F |
+
+## Current boundary
+
+v0.1 supports GLOSS avatars with autonomous blinking, gaze, expressions, and
+breathing. It does not yet promise walking/running poses. Kindergrimm's DRAWN
+poses target a different rig, while the GLOSS biped is currently a static set
+of meshes rather than an articulated locomotion skeleton. That work requires a
+separate rig/retargeting spike before OwnMySpace should depend on it.
+
+DRAWN, VOXEL, and OBJECT are also outside this package version. In particular,
+procedural OBJECT plants may become another shared capability, but they should
+not be hidden inside the avatar API.
+
+## Upstream and release
+
+- Provenance: [NOTICE.md](NOTICE.md)
+- Update process: [UPSTREAM.md](UPSTREAM.md)
+- Local gate: `pnpm verify`
+- Network update check: `pnpm upstream:check`
+
+npm publication is intentionally absent from local scripts. Releases run only
+through the manually triggered Trusted Publishing workflow on `main`.

package/UPSTREAM.md

@@ -0,0 +1,47 @@
+# Kindergrimm Upstream Maintenance
+
+SwimmerAvatarKit owns the stable product contract; Kindergrimm remains the art
+generator upstream. An upstream change is never merged automatically.
+
+## Check for updates
+
+```bash
+pnpm upstream:check
+```
+
+The command compares the pinned commit in `upstream-lock.json` with the current
+tip of Kindergrimm's `main` branch. It exits successfully when they match and
+fails with both commit IDs when review is needed. The scheduled GitHub workflow
+runs the same read-only check weekly.
+
+## Review and import an update
+
+1. Clone Kindergrimm into a temporary directory and check out the candidate
+   commit. Do not add it as a mutable Git submodule.
+2. Review the full range from the pinned commit to the candidate, especially
+   `src/gloss/**`, `src/rng.js`, recipe shape, material callback arguments,
+   returned rig fields, and browser-only API use.
+3. Replace only the imported dependency closure under
+   `vendor/kindergrimm/`. Keep `src/gloss/gloss.js` and
+   `src/gloss/gcrowd.js` excluded unless the package contract deliberately
+   changes.
+4. Do not repair compatibility inside vendored JavaScript. Adapt the typed
+   boundary under `src/**` and add regression tests.
+5. Update the commit metadata and Git blob hashes in `upstream-lock.json`, then
+   run `pnpm vendor:verify` before any other test.
+6. Run `pnpm verify`, `pnpm docs:check`, and inspect `pnpm pack --dry-run`.
+7. Choose semver from the public package impact, not from the upstream commit
+   label. A compatible art/bug refresh is normally a patch; changed recipes or
+   APIs may require a minor or major release.
+8. Merge the reviewed package change, then publish only through the trusted
+   GitHub Actions workflow. Products upgrade to that released version in their
+   own PRs.
+
+This creates a deliberate two-step buffer:
+
+```text
+Kindergrimm update -> reviewed SwimmerAvatarKit release -> product dependency update
+```
+
+An upstream bug fix can therefore be adopted quickly without giving an
+unreviewed external commit authority over every PieAI product.

package/dist/avatar.d.ts

@@ -0,0 +1,2 @@
+import type { AvatarBuildOptions, AvatarHandle, AvatarRecipe } from "./types.js";
+export declare function buildAvatar(recipe: AvatarRecipe, options: AvatarBuildOptions): AvatarHandle;

package/dist/avatar.js

@@ -0,0 +1,69 @@
+import { createGlossFace } from "../vendor/kindergrimm/src/gloss/gface.js";
+import { buildGloss } from "../vendor/kindergrimm/src/gloss/grig.js";
+import { completeRecipe, EXPRESSIONS } from "./recipe.js";
+const expressionIds = new Set(EXPRESSIONS);
+function disposeGeometries(root) {
+    const geometries = new Set();
+    root.traverse((child) => {
+        const mesh = child;
+        if (mesh.isMesh)
+            geometries.add(mesh.geometry);
+    });
+    for (const geometry of geometries)
+        geometry.dispose();
+}
+export function buildAvatar(recipe, options) {
+    if (typeof options?.materialFor !== "function") {
+        throw new TypeError("buildAvatar requires a materialFor function.");
+    }
+    const completedRecipe = completeRecipe(recipe);
+    const built = buildGloss(completedRecipe, {
+        materialFor: options.materialFor,
+    });
+    const life = createGlossFace(built, { gaze: options.gaze ?? true });
+    const restY = Number(built.head.userData.restY ?? built.L.cy);
+    let elapsedSeconds = 0;
+    let disposed = false;
+    return {
+        object: built.group,
+        recipe: completedRecipe,
+        stats: { ...built.stats },
+        bounds: { ...built.bounds },
+        update(deltaSeconds) {
+            if (disposed)
+                return;
+            if (!Number.isFinite(deltaSeconds) || deltaSeconds < 0) {
+                throw new RangeError("Avatar deltaSeconds must be a finite non-negative number.");
+            }
+            elapsedSeconds += deltaSeconds;
+            const head = life.update(elapsedSeconds, deltaSeconds);
+            const breath = 1 + Math.sin(elapsedSeconds * 1.8) * 0.007;
+            built.group.scale.set(1 / Math.sqrt(breath), breath, 1 / Math.sqrt(breath));
+            built.head.position.set(head.x, restY + head.y, 0);
+            built.head.rotation.set(head.pitch, head.yaw, head.rot);
+        },
+        getExpression() {
+            return life.face();
+        },
+        setExpression(expression) {
+            if (disposed)
+                return;
+            if (!expressionIds.has(expression)) {
+                throw new RangeError(`Unknown avatar expression: ${expression}`);
+            }
+            life.setFace(expression);
+        },
+        isDisposed() {
+            return disposed;
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            built.group.removeFromParent();
+            disposeGeometries(built.group);
+            built.group.clear();
+        },
+    };
+}
+//# sourceMappingURL=avatar.js.map

package/dist/avatar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar.js","sourceRoot":"","sources":["../src/avatar.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { buildAvatar } from "./avatar.js";
+export { assertAvatarRecipe, AVATAR_RECIPE_SCHEMA, AVATAR_RECIPE_VERSION, cloneAvatarRecipe, completeRecipe, createAvatarRecipe, createAvatarRecipeDocument, deserializeAvatarRecipe, EXPRESSIONS, fillRecipe, PALETTES, parseAvatarRecipeDocument, PARTS, randomRecipe, rerollPart, serializeAvatarRecipe, SPECIES, } from "./recipe.js";
+export type { AvatarBounds, AvatarBuildOptions, AvatarBuildStats, AvatarExpression, AvatarHandle, AvatarMaterialFor, AvatarOption, AvatarPaletteOption, AvatarPartRecipe, AvatarRecipe, AvatarRecipeDocument, AvatarRecipeDocumentV1, AvatarSeed, } from "./types.js";

package/dist/index.js

@@ -0,0 +1,3 @@
+export { buildAvatar } from "./avatar.js";
+export { assertAvatarRecipe, AVATAR_RECIPE_SCHEMA, AVATAR_RECIPE_VERSION, cloneAvatarRecipe, completeRecipe, createAvatarRecipe, createAvatarRecipeDocument, deserializeAvatarRecipe, EXPRESSIONS, fillRecipe, PALETTES, parseAvatarRecipeDocument, PARTS, randomRecipe, rerollPart, serializeAvatarRecipe, SPECIES, } from "./recipe.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,0BAA0B,EAC1B,uBAAuB,EACvB,WAAW,EACX,UAAU,EACV,QAAQ,EACR,yBAAyB,EACzB,KAAK,EACL,YAAY,EACZ,UAAU,EACV,qBAAqB,EACrB,OAAO,GACR,MAAM,aAAa,CAAC"}

package/dist/materials.d.ts

@@ -0,0 +1,20 @@
+import type { Texture, WebGLRenderer } from "three";
+import type { AvatarMaterialFor, AvatarOption } from "./types.js";
+export interface AvatarMaterialLibrary {
+    readonly environment: Texture;
+    readonly materialFor: AvatarMaterialFor;
+    readonly disposed: boolean;
+    dispose(): void;
+}
+export interface AvatarMaterialLibraryOptions {
+    disposeEnvironment?: boolean;
+}
+export interface AvatarMaterialLibraryLease {
+    readonly library: AvatarMaterialLibrary;
+    readonly released: boolean;
+    release(): void;
+}
+export declare const FINISHES: readonly AvatarOption[];
+export declare function createGlossMaterialLibrary(environment: Texture, options?: AvatarMaterialLibraryOptions): AvatarMaterialLibrary;
+export declare function createStudioMaterialLibrary(renderer: WebGLRenderer): AvatarMaterialLibrary;
+export declare function acquireStudioMaterialLibrary(renderer: WebGLRenderer): AvatarMaterialLibraryLease;

package/dist/materials.js

@@ -0,0 +1,61 @@
+import { makeMaterialFactory, MATERIALS, studioEnv, } from "../vendor/kindergrimm/src/gloss/gmedia.js";
+export const FINISHES = Object.freeze(MATERIALS.map((material) => ({ id: material.id, label: material.label })));
+export function createGlossMaterialLibrary(environment, options = {}) {
+    const materialForUpstream = makeMaterialFactory(environment);
+    const materials = new Set();
+    let disposed = false;
+    const materialFor = (finish, color, shell, print) => {
+        if (disposed)
+            throw new Error("Avatar material library has been disposed.");
+        const material = materialForUpstream(finish, color, shell, print);
+        materials.add(material);
+        return material;
+    };
+    return {
+        environment,
+        materialFor,
+        get disposed() {
+            return disposed;
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            for (const material of materials)
+                material.dispose();
+            materials.clear();
+            if (options.disposeEnvironment === true)
+                environment.dispose();
+        },
+    };
+}
+export function createStudioMaterialLibrary(renderer) {
+    return createGlossMaterialLibrary(studioEnv(renderer), { disposeEnvironment: true });
+}
+const rendererPool = new WeakMap();
+export function acquireStudioMaterialLibrary(renderer) {
+    let entry = rendererPool.get(renderer);
+    if (!entry || entry.library.disposed) {
+        entry = { library: createStudioMaterialLibrary(renderer), references: 0 };
+        rendererPool.set(renderer, entry);
+    }
+    entry.references += 1;
+    let released = false;
+    return {
+        library: entry.library,
+        get released() {
+            return released;
+        },
+        release() {
+            if (released)
+                return;
+            released = true;
+            entry.references -= 1;
+            if (entry.references === 0) {
+                entry.library.dispose();
+                rendererPool.delete(renderer);
+            }
+        },
+    };
+}
+//# sourceMappingURL=materials.js.map

package/dist/materials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materials.js","sourceRoot":"","sources":["../src/materials.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,SAAS,GACV,MAAM,2CAA2C,CAAC;AAqBnD,MAAM,CAAC,MAAM,QAAQ,GAA4B,MAAM,CAAC,MAAM,CAC5D,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAC1E,CAAC;AAEF,MAAM,UAAU,0BAA0B,CACxC,WAAoB,EACpB,UAAwC,EAAE;IAE1C,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAY,CAAC;IACtC,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,MAAM,WAAW,GAAsB,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACrE,IAAI,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC5E,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAClE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO;QACL,WAAW;QACX,WAAW;QACX,IAAI,QAAQ;YACV,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO;YACL,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,KAAK,MAAM,QAAQ,IAAI,SAAS;gBAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrD,SAAS,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,OAAO,CAAC,kBAAkB,KAAK,IAAI;gBAAE,WAAW,CAAC,OAAO,EAAE,CAAC;QACjE,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,QAAuB;IACjE,OAAO,0BAA0B,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC;AACvF,CAAC;AAOD,MAAM,YAAY,GAAG,IAAI,OAAO,EAAoC,CAAC;AAErE,MAAM,UAAU,4BAA4B,CAAC,QAAuB;IAClE,IAAI,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrC,KAAK,GAAG,EAAE,OAAO,EAAE,2BAA2B,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QAC1E,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IACD,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;IACtB,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,QAAQ;YACV,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO;YACL,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;YACtB,IAAI,KAAK,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;gBAC3B,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBACxB,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/react-three-fiber.d.ts

@@ -0,0 +1,16 @@
+import { type ThreeElements } from "@react-three/fiber";
+import type { Group } from "three";
+import { type AvatarMaterialLibrary } from "./materials.js";
+import type { AvatarHandle, AvatarRecipe } from "./types.js";
+export type AvatarProps = Omit<ThreeElements["group"], "children" | "ref"> & {
+    recipe: AvatarRecipe;
+    gaze?: boolean;
+    materialLibrary?: AvatarMaterialLibrary;
+    onBuilt?: (avatar: AvatarHandle) => void;
+};
+export declare const Avatar: import("react").ForwardRefExoticComponent<Omit<import("@react-three/fiber/dist/declarations/src/core/utils.js").Mutable<import("@react-three/fiber/dist/declarations/src/core/utils.js").Overwrite<Partial<import("@react-three/fiber/dist/declarations/src/core/utils.js").Overwrite<Group<import("three").Object3DEventMap>, import("@react-three/fiber").MathProps<Group<import("three").Object3DEventMap>> & import("@react-three/fiber").ReactProps<Group<import("three").Object3DEventMap>> & Partial<import("@react-three/fiber").EventHandlers>>>, Omit<import("@react-three/fiber").InstanceProps<Group<import("three").Object3DEventMap>, typeof Group>, "object">>>, "children" | "ref"> & {
+    recipe: AvatarRecipe;
+    gaze?: boolean;
+    materialLibrary?: AvatarMaterialLibrary;
+    onBuilt?: (avatar: AvatarHandle) => void;
+} & import("react").RefAttributes<AvatarHandle>>;

package/dist/react-three-fiber.js

@@ -0,0 +1,52 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef, useEffect, useImperativeHandle, useLayoutEffect, useRef, useState, } from "react";
+import { useFrame, useThree } from "@react-three/fiber";
+import { buildAvatar } from "./avatar.js";
+import { acquireStudioMaterialLibrary } from "./materials.js";
+export const Avatar = forwardRef(function Avatar({ recipe, gaze = true, materialLibrary, onBuilt, ...groupProps }, forwardedRef) {
+    const { gl } = useThree();
+    const [ownedLibrary, setOwnedLibrary] = useState(null);
+    const [avatar, setAvatar] = useState(null);
+    const [object, setObject] = useState(null);
+    const avatarRef = useRef(null);
+    const onBuiltRef = useRef(onBuilt);
+    onBuiltRef.current = onBuilt;
+    useEffect(() => {
+        if (materialLibrary) {
+            setOwnedLibrary(null);
+            return;
+        }
+        const lease = acquireStudioMaterialLibrary(gl);
+        setOwnedLibrary(lease.library);
+        return () => {
+            setOwnedLibrary(null);
+            lease.release();
+        };
+    }, [gl, materialLibrary]);
+    const activeLibrary = materialLibrary ?? ownedLibrary;
+    useLayoutEffect(() => {
+        if (!activeLibrary)
+            return;
+        const next = buildAvatar(recipe, {
+            gaze,
+            materialFor: activeLibrary.materialFor,
+        });
+        avatarRef.current = next;
+        setAvatar(next);
+        setObject(next.object);
+        onBuiltRef.current?.(next);
+        return () => {
+            if (avatarRef.current === next)
+                avatarRef.current = null;
+            setAvatar(null);
+            setObject(null);
+            next.dispose();
+        };
+    }, [activeLibrary, gaze, recipe]);
+    useFrame((_, deltaSeconds) => {
+        avatarRef.current?.update(deltaSeconds);
+    });
+    useImperativeHandle(forwardedRef, () => avatar, [avatar]);
+    return (_jsx("group", { ...groupProps, children: object ? _jsx("primitive", { object: object, dispose: null }) : null }));
+});
+//# sourceMappingURL=react-three-fiber.js.map

package/dist/react-three-fiber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-three-fiber.js","sourceRoot":"","sources":["../src/react-three-fiber.tsx"],"names":[],"mappings":"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"}

package/dist/recipe.d.ts

@@ -0,0 +1,18 @@
+import type { AvatarExpression, AvatarOption, AvatarPaletteOption, AvatarRecipe, AvatarRecipeDocument, AvatarSeed } from "./types.js";
+export declare const AVATAR_RECIPE_SCHEMA: "@pieai/swimmer-avatar-kit/recipe";
+export declare const AVATAR_RECIPE_VERSION: 1;
+export declare const SPECIES: readonly AvatarOption[];
+export declare const PALETTES: readonly AvatarPaletteOption[];
+export declare const PARTS: readonly AvatarOption[];
+export declare const EXPRESSIONS: readonly AvatarExpression[];
+export declare function cloneAvatarRecipe(recipe: AvatarRecipe): AvatarRecipe;
+export declare function assertAvatarRecipe(value: unknown): asserts value is AvatarRecipe;
+export declare function completeRecipe(recipe: AvatarRecipe): AvatarRecipe;
+export declare const fillRecipe: typeof completeRecipe;
+export declare function randomRecipe(seed?: AvatarSeed): AvatarRecipe;
+export declare const createAvatarRecipe: typeof randomRecipe;
+export declare function rerollPart(recipe: AvatarRecipe, partId: string): AvatarRecipe;
+export declare function createAvatarRecipeDocument(recipe: AvatarRecipe): AvatarRecipeDocument;
+export declare function parseAvatarRecipeDocument(value: unknown): AvatarRecipeDocument;
+export declare function serializeAvatarRecipe(recipe: AvatarRecipe): string;
+export declare function deserializeAvatarRecipe(serialized: string): AvatarRecipe;

package/dist/recipe.js

@@ -0,0 +1,118 @@
+import { GLOSS_FACES } from "../vendor/kindergrimm/src/gloss/gface.js";
+import { ensureGParams, GPARTS, newGRecipe, rerollGPart, } from "../vendor/kindergrimm/src/gloss/grig.js";
+import { PALETTES as GLOSS_PALETTES } from "../vendor/kindergrimm/src/gloss/gpalette.js";
+import { GSPECIES, GSPECIES_IDS } from "../vendor/kindergrimm/src/gloss/gspecies.js";
+import { hashStr } from "../vendor/kindergrimm/src/rng.js";
+export const AVATAR_RECIPE_SCHEMA = "@pieai/swimmer-avatar-kit/recipe";
+export const AVATAR_RECIPE_VERSION = 1;
+export const SPECIES = Object.freeze(GSPECIES_IDS.map((id) => ({ id, label: GSPECIES[id]?.label ?? id })));
+export const PALETTES = Object.freeze(GLOSS_PALETTES.map((palette) => ({
+    id: palette.id,
+    label: palette.label,
+    colors: Object.freeze([...palette.colors]),
+})));
+export const PARTS = Object.freeze(GPARTS.map((part) => ({ id: part.id, label: part.label })));
+export const EXPRESSIONS = Object.freeze([...GLOSS_FACES]);
+const partIds = new Set(PARTS.map((part) => part.id));
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNullableString(value) {
+    return typeof value === "string" || value === null;
+}
+function seedToNumber(seed) {
+    if (seed === undefined)
+        return (Math.random() * 1_000_000_000) | 0;
+    if (typeof seed === "number") {
+        if (!Number.isFinite(seed))
+            throw new TypeError("Avatar seed must be a finite number.");
+        return Math.trunc(seed) >>> 0;
+    }
+    if (/^\d+$/.test(seed))
+        return Number(BigInt(seed) & 0xffffffffn);
+    return hashStr(seed);
+}
+export function cloneAvatarRecipe(recipe) {
+    return structuredClone(recipe);
+}
+export function assertAvatarRecipe(value) {
+    if (!isRecord(value))
+        throw new TypeError("Avatar recipe must be an object.");
+    if (!Number.isInteger(value.seed) || Number(value.seed) < 0 || Number(value.seed) > 0xffff_ffff) {
+        throw new TypeError("Avatar recipe seed must be an unsigned 32-bit integer.");
+    }
+    for (const field of ["species", "body", "stance", "palette", "material"]) {
+        if (!isNullableString(value[field])) {
+            throw new TypeError(`Avatar recipe ${field} must be a string or null.`);
+        }
+    }
+    if (value.colorIx !== null && (!Number.isInteger(value.colorIx) || Number(value.colorIx) < 0)) {
+        throw new TypeError("Avatar recipe colorIx must be a non-negative integer or null.");
+    }
+    if (!isRecord(value.parts))
+        throw new TypeError("Avatar recipe parts must be an object.");
+    for (const [partId, part] of Object.entries(value.parts)) {
+        if (!isRecord(part))
+            throw new TypeError(`Avatar recipe part ${partId} must be an object.`);
+        if (part.rr !== undefined && (!Number.isInteger(part.rr) || Number(part.rr) < 0)) {
+            throw new TypeError(`Avatar recipe part ${partId}.rr must be a non-negative integer.`);
+        }
+    }
+}
+export function completeRecipe(recipe) {
+    assertAvatarRecipe(recipe);
+    const next = cloneAvatarRecipe(recipe);
+    ensureGParams(next);
+    return next;
+}
+export const fillRecipe = completeRecipe;
+export function randomRecipe(seed) {
+    const recipe = newGRecipe(seedToNumber(seed));
+    ensureGParams(recipe);
+    return cloneAvatarRecipe(recipe);
+}
+export const createAvatarRecipe = randomRecipe;
+export function rerollPart(recipe, partId) {
+    if (!partIds.has(partId))
+        throw new RangeError(`Unknown avatar part: ${partId}`);
+    const next = completeRecipe(recipe);
+    rerollGPart(next, partId);
+    return next;
+}
+export function createAvatarRecipeDocument(recipe) {
+    return {
+        schema: AVATAR_RECIPE_SCHEMA,
+        version: AVATAR_RECIPE_VERSION,
+        renderer: "gloss",
+        recipe: completeRecipe(recipe),
+    };
+}
+export function parseAvatarRecipeDocument(value) {
+    if (!isRecord(value))
+        throw new TypeError("Avatar recipe document must be an object.");
+    if (value.schema !== AVATAR_RECIPE_SCHEMA) {
+        throw new TypeError(`Unsupported avatar recipe schema: ${String(value.schema)}`);
+    }
+    if (value.version !== AVATAR_RECIPE_VERSION) {
+        throw new TypeError(`Unsupported avatar recipe version: ${String(value.version)}`);
+    }
+    if (value.renderer !== "gloss") {
+        throw new TypeError(`Unsupported avatar renderer: ${String(value.renderer)}`);
+    }
+    assertAvatarRecipe(value.recipe);
+    return createAvatarRecipeDocument(value.recipe);
+}
+export function serializeAvatarRecipe(recipe) {
+    return JSON.stringify(createAvatarRecipeDocument(recipe));
+}
+export function deserializeAvatarRecipe(serialized) {
+    let value;
+    try {
+        value = JSON.parse(serialized);
+    }
+    catch (error) {
+        throw new TypeError(`Avatar recipe document is not valid JSON: ${String(error)}`);
+    }
+    return parseAvatarRecipeDocument(value).recipe;
+}
+//# sourceMappingURL=recipe.js.map

package/dist/recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.js","sourceRoot":"","sources":["../src/recipe.ts"],"names":[],"mappings":"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"}