@call-me-sensei/toonlab 0.4.20 → 0.4.21

package/NPM-LIBRARY.md

@@ -1,7 +1,7 @@
 # ToonLab npm library guide
 
 This guide is included in `@call-me-sensei/toonlab`. It is the package-first
-reference for version 0.4.20 and does not require access to the source
+reference for version 0.4.21 and does not require access to the source
 repository.
 
 ## Install
@@ -45,7 +45,7 @@ them:
 - `@call-me-sensei/toonlab/styles` for portable bundles, strict labels,
   auditing, and coordinated application;
 - `@call-me-sensei/toonlab/assetlib`, `/asset-policy`, and
-  `/official-catalog` for policy-aware Library and Gallery discovery;
+  `/official-catalog` for policy-aware local/released-catalog integration;
 - `@call-me-sensei/toonlab/character` and `/loaders` for supported preview and
   host-model integration;
 - `@call-me-sensei/toonlab/runtime`, `/renderer`, `/lighting`, and
@@ -76,7 +76,9 @@ The npm artifact contains four supported layers:
 It does not contain the ToonLab website, Lab application UIs, examples,
 screenshots, models, textures, or other binary media. Optional public fixtures
 are identified by immutable `https://assets.toonlab.io` metadata rather than
-being bundled.
+being bundled. Authored tree recipes are assets too: the reviewed public tree
+collection remains in the Gallery and is discovered through MCP instead of
+being hard-coded into the JavaScript runtime.
 
 ## Use a focused runtime
 
@@ -167,7 +169,7 @@ it uses the disk workspace passed through `--workspace`; no account is needed.
       "command": "npx",
       "args": [
         "-y",
-        "@call-me-sensei/toonlab@0.4.20",
+        "@call-me-sensei/toonlab@0.4.21",
         "--workspace",
         "/absolute/path/to/your-game/.toonlab"
       ],
@@ -181,8 +183,11 @@ it uses the disk workspace passed through `--workspace`; no account is needed.
 
 This server provides the anime-game profile, runtime guide, live-Lab
 contracts, deterministic document creation and mutation, policy validation,
-public asset discovery, local Library operations, and optional provider-backed
-generation when the developer supplies server-side provider keys.
+public Gallery search/retrieval, local Library operations, and optional
+provider-backed generation when the developer supplies server-side provider
+keys. Authored tree recipes are not bundled. Call `search_public_gallery` with
+`{ query: "tree", type: "tree-recipe" }`, then use
+`get_public_gallery_asset` to retrieve the reviewed portable recipe.
 
 ### ToonLab Pro MCP
 

package/README.md

@@ -19,7 +19,7 @@ Use ToonLab as a focused runtime library (`@call-me-sensei/toonlab` on npm), as
 an asset/preset authoring workspace, or as an asset-discovery service—not as a
 one-shot world generator.
 
-## Versioned expectation: 0.4.20
+## Versioned expectation: 0.4.21
 
 For a correctly constructed and semantically labeled scene, one strict Call Me
 Sensei bundle application is expected to establish the supported visual
@@ -310,10 +310,13 @@ npm run dev
 # In an MCP client, use the command/config shown at /settings/.
 ```
 
-The local server can search the built-in procedural catalog and public CC0
-sources, read your saved presets and exported files, generate seeded recipes,
-and import assets into the project. It uses stdio, requires no account or
-OAuth, and keeps work local. See [Local MCP and workspace](https://github.com/call-me-sensei/toonlab/blob/main/docs/mcp.md) and
+The local server can search your workspace, the public ToonLab Gallery, the
+released official catalog, and public CC0 sources; read saved presets and
+exported files; generate approved seeded recipes; and import assets into the
+project. Authored Gallery recipes are fetched with their public license and
+provenance instead of being copied into the npm package. The server uses stdio,
+requires no account or OAuth for public discovery, and keeps local work local.
+See [Local MCP and workspace](https://github.com/call-me-sensei/toonlab/blob/main/docs/mcp.md) and
 [Local database and public asset releases](https://github.com/call-me-sensei/toonlab/blob/main/docs/local-database-and-public-assets.md).
 
 ## The labs
@@ -375,7 +378,7 @@ camera behavior, and game feel remain host-owned or pre-beta.
 | Toon character shading | `@call-me-sensei/toonlab/toon` | Modern anime character shader: cel bands with art-directed face lighting, skin-tone shadow management, shadow-color HSV control, scene/self/contact shadows, average-shadow smoothing, rim light (fresnel or screen-space depth), stylized + anisotropic hair highlights, eye catchlights, role-aware specular, source map routing (normal/AO/emissive/MatCap/ramp/detail), inverted-hull outlines, glitter, stickers, perspective removal, shell fur, dither fades — 23 settings groups, all preset-serializable. [Docs](https://github.com/call-me-sensei/toonlab/blob/main/docs/toon-shading.md) |
 | Environment shading | `@call-me-sensei/toonlab/environment` | Modern anime-style scene shader for texture packs, standard glTF, and untextured scenes: material-role classification, wrapped lighting, packed-map hints, window cutouts, sun/lamp rigs, time-of-day, six-direction ambient probe, planar floor reflections, BVH vertex-AO baking, height fog, cloud shadows. [Docs](https://github.com/call-me-sensei/toonlab/blob/main/docs/environment.md) |
 | Water | `@call-me-sensei/toonlab/water` | Focused water treatment for a host-authored water footprint, continuous shore, and closed seabed: Gerstner waves, absorption color, refraction/caustics/foam, ripples, splashes, wakes, kelp, underwater treatment, and CPU buoyancy sampling. It does not design the coast or underwater habitat. [Docs](https://github.com/call-me-sensei/toonlab/blob/main/docs/water.md) |
-| Vegetation | `@call-me-sensei/toonlab/vegetation` | Instanced grass and flower fields; the 12 named pre-species legacy trees; and a focused procedural broadleaf `BranchTree` with deterministic branching, five leaf silhouettes, caller-supplied leaf/bark textures, and a portable recipe. Package-generated Call Me Sensei trees preserve authored bark first and otherwise select a registered deterministic bark surface instead of a bare trunk. The 165-species research roster remains repository-only experimental work. Independent Tree, Grass, and Flower shader profiles share one semantic-role renderer family. [Docs](https://github.com/call-me-sensei/toonlab/blob/main/docs/vegetation-sky.md) |
+| Vegetation | `@call-me-sensei/toonlab/vegetation` | Tree/grass/flower construction and shader runtimes, including the focused procedural broadleaf `BranchTree` with deterministic branching, five leaf silhouettes, caller-supplied leaf/bark textures, and a portable recipe. No authored tree asset collection is bundled or exported: reviewed tree recipes remain searchable Gallery assets delivered through MCP with their CC0 metadata. Package-generated trees preserve authored bark first and otherwise select a registered deterministic bark surface instead of a bare trunk. The experimental species roster remains repository-only. [Docs](https://github.com/call-me-sensei/toonlab/blob/main/docs/vegetation-sky.md) |
 | Rock shader | `@call-me-sensei/toonlab/rock-shader` | Detailed, versioned rock-material profiles with projected detail, distance tint, normal fading, striping, moss and optional top layers, plus explicit source-albedo and vertex-color/AO integration. Call Me Sensei is the default. Geometry generation remains separate in `rockgen`. [Docs](https://github.com/call-me-sensei/toonlab/blob/main/docs/rock-shader.md) |
 | Ground shader | `@call-me-sensei/toonlab/ground-shader` | Splat-weighted anime terrain with slope/cliff detail, shoreline and weather response, HDR sun/shade controls, safe shadow defaults, and flat-albedo ground-field output for vegetation adoption. [Docs](https://github.com/call-me-sensei/toonlab/blob/main/docs/ground-shader.md) |
 | Sky | `@call-me-sensei/toonlab/sky` | Reusable atmosphere, palette, sun, moon, stars, and god-ray settings authored by Sky Lab and Sky & Cloud Lab. Your application coordinates final lighting and scene state. [Docs](https://github.com/call-me-sensei/toonlab/blob/main/docs/sky.md) |
@@ -460,21 +463,21 @@ profile parameters for other authored styles. Its recipe-v3 LOD0/1/2 topology
 uses 40/14/6 primary blades and compensates retained stroke width so zooming
 does not make the underlying terrain appear to change color.
 
-The supported tree set is intentionally the proven pre-species surface.
-Use a named legacy silhouette directly:
+ToonLab does not ship predefined tree assets in npm. Search reviewed public
+tree recipes through MCP, then pass the retrieved portable recipe options to
+the runtime:
 
 ```js
-import {
-  LEGACY_TREE_IDS,
-  createLegacyTree,
-} from '@call-me-sensei/toonlab/vegetation';
+import { StylizedTree } from '@call-me-sensei/toonlab/vegetation';
 
-console.log(LEGACY_TREE_IDS); // straight, leaning, see-through, ...
-const legacyTree = createLegacyTree('golden-gingko', {
+// treeRecipe is the document returned by get_public_gallery_asset after
+// search_public_gallery({ query: 'tree', type: 'tree-recipe' }).
+const tree = new StylizedTree({
+  ...treeRecipe.options,
   trunkMap: barkTexture,
   vegetationShader: { preset: 'call_me_sensei' },
 });
-scene.add(legacyTree);
+scene.add(tree);
 ```
 
 For a configurable recursive branch-type broadleaf, use the focused wrapper:
@@ -495,7 +498,8 @@ scene.add(tree);
 shapes. Botanical species generation is not a public package claim.
 
 Water, sky, flowers, trees, grass, and splashes keep procedural defaults, while
-legacy trees and BranchTree may use caller-owned leaf and bark textures. The
+Gallery tree recipes, `StylizedTree`, and `BranchTree` may use caller-owned
+leaf and bark textures. The
 Call Me Sensei tree path resolves bark in this order: explicit
 `trunkSurfaceProfile`, authored `trunkMap`, then the registered
 `call-me-sensei-bark-v1` fallback. Use `getTreeSurfaceProfileOptions()` when a
@@ -698,9 +702,11 @@ Ready-to-paste supported prompts are included in
 Two servers, and they compose:
 
 **Local (free, no account).** The stdio server included in this package
-searches the built-in procedural catalog and public CC0 sources, reads your
-saved presets and lab exports, generates seeded recipes, and imports assets
-into a disk-backed `.toonlab/` workspace:
+searches local/project content, reviewed public Gallery recipes, the released
+official catalog, and public CC0 sources; reads saved presets and Lab exports;
+generates approved seeded recipes; and imports assets into a disk-backed
+`.toonlab/` workspace. Use `search_public_gallery` for authored assets such as
+the public tree collection—those recipes are not npm built-ins:
 
 ```json
 {

package/agents/PROMPTS.md

@@ -1,7 +1,7 @@
 # ToonLab agent prompts
 
 These prompts are included with the npm package. They use only the supported
-0.4.20 runtime, agent skills, and MCP workflows.
+0.4.21 runtime, agent skills, and MCP workflows.
 
 ## Existing-scene integration
 
@@ -55,11 +55,15 @@ document.
 
 ```text
 Using the ToonLab vegetation-sky skill, create the requested tree, shrub,
-grass, or groundcover with the public vegetation runtime. Keep species/recipe,
-seed, geometry, palette, and placement separate from the Tree/Grass/Flower
-shader profile. Emit stable modeled-part and material-role labels, preserve
-the recipe for regeneration, and verify LOD and shadow behavior. Do not use the
-repository-only experimental species engine.
+grass, or groundcover. For an existing authored tree, search the public Gallery
+through MCP first and retrieve its portable recipe; the npm package contains
+tree construction/shader capability but no predefined tree asset collection.
+Author a new `StylizedTree` or `BranchTree` only when requested or when accepted
+discovery does not close the role. Keep recipe, seed, geometry, palette, and
+placement separate from the Tree/Grass/Flower shader profile. Emit stable
+modeled-part and material-role labels, preserve the recipe for regeneration,
+and verify LOD and shadow behavior. Do not use the repository-only experimental
+species engine.
 ```
 
 ## Rock generation and shader separation

package/agents/codex/AGENTS.md

@@ -82,10 +82,12 @@ or environment with ToonLab's runtime library in their own Three.js app.
   system preset with embedded shader controls. Sky, Cloud, and Sky & Cloud are
   live focused authoring surfaces. Vegetation is one shared
   implementation family with separate Tree, Grass, and Flower shader profiles;
-  their Generation Labs own geometry/material data. The stable public package
-  trees are the 12 named pre-species legacy presets plus the generic
-  `BranchTree`; repository species work is experimental and must not be
-  presented as supported. Ground is a separate shader domain. Scene weather,
+  their Generation Labs own geometry/material data. The public package ships
+  tree construction and shader capability, not predefined tree assets. Search
+  reviewed authored tree recipes through MCP; use `StylizedTree` or
+  `BranchTree` to instantiate or deliberately author them. Repository species
+  work is experimental and must not be presented as supported. Ground is a
+  separate shader domain. Scene weather,
   lighting, camera, interactions, and complete Sky/Cloud composition stay
   host-owned or experimental.
 - For style-bundle, multi-shader, or arbitrary-asset work, read

package/agents/references/mcp-asset-discovery.md

@@ -10,11 +10,12 @@ Inspect the connected server's tool names before calling anything. Do not
 assume the developer has ToonLab Pro, and do not assume a local OSS checkout.
 
 - **ToonLab OSS local MCP** exposes `get_workspace_info`,
-  `search_cc0_assets`, `get_cc0_asset`, and `import_cc0_asset`. Its
-  `search_assets` searches built-in procedural entries, the complete official
-  R2-backed Gallery catalog, and the disk-backed project/library/workspace.
-  Use `source: 'official'` for released assets and follow `nextOffset` until
-  null.
+  `search_public_gallery`, `get_public_gallery_asset`, `search_cc0_assets`,
+  `get_cc0_asset`, and `import_cc0_asset`. Its `search_assets` searches
+  approved built-in generator/settings entries, the local released official
+  catalog, and the disk-backed project/library/workspace. Authored assets such
+  as reviewed tree recipes are searched through `search_public_gallery` rather
+  than copied into npm.
 - **ToonLab Pro remote MCP** exposes `get_runtime_guide`,
   `search_public_gallery`, and `get_toonlab_asset`. Its `search_assets`
   searches indexed external open assets; first-party rocks/trees and community
@@ -41,10 +42,12 @@ the surface the developer actually has and report which surface was used.
 1. Call `list_my_creations` with the task's text and exact tag filters, then
    `search_assets` with `source: 'library'`,
    `'workspace'`, `'workspace-storage'`, or `'builtin'` as appropriate. If no
-   accepted local entry closes the role, call it with `source: 'official'` to
-   search the released Gallery through the local database. Follow
-   `nextOffset` until null so all matching official assets remain reachable.
-2. Call local `get_asset` for the complete recipe/file descriptor.
+   accepted local entry closes the role, call `search_public_gallery` for
+   authored public assets and follow `nextOffset` until null. Use
+   `type: 'tree-recipe'` for reviewed trees. Use `search_assets` with
+   `source: 'official'` only for the installed released catalog.
+2. Call local `get_public_gallery_asset` for a selected Gallery document or
+   `get_asset` for a local/released-catalog record.
 3. When policy permits external CC0, call `search_cc0_assets`, then
    `get_cc0_asset`; call `import_cc0_asset` only after selection to download
    bytes plus their provenance manifest into `.toonlab/imports/`.

package/agents/skills/claude/asset-sourcing/SKILL.md

@@ -50,9 +50,11 @@ scene-kit role.
 2. **Reuse what exists.** In OSS, earlier imports, saved presets, and exports
    live in `.toonlab/`; call local `list_my_creations` and `search_assets` with
    `source: 'workspace'`, `'workspace-storage'`, `'library'`, or `'builtin'`.
-   If those do not close the role, use local `search_assets` with
-   `source: 'official'` for the complete released Gallery catalog and follow
-   `nextOffset` until null.
+   If those do not close the role, use local `search_public_gallery` and follow
+   `nextOffset` until null; use `type: 'tree-recipe'` for authored trees and
+   retrieve a finalist with `get_public_gallery_asset`. Use local
+   `search_assets({ source: 'official' })` only for the installed released
+   catalog.
    In Pro, call cloud `list_my_creations`, then `search_public_gallery`; use
    `source: 'toonlab'` plus the appropriate catalog for first-party assets and
    follow `nextOffset`. For rocks on either surface, shortlist from positive
@@ -195,9 +197,10 @@ table, as the source of truth):
 
 - Seamless PBR material sets (brick, wood, ground …) → ambientCG.
 - Photoscanned props, HDRIs, high-end texture sets → Poly Haven.
-- Stylized/toon-ready models, vegetation, buildings → the built-in
-  procedural catalog first only for families that passed the base-set
-  reliability gate; otherwise compare curated external candidates.
+- Authored stylized/toon-ready models and vegetation → the public Gallery
+  first; retrieve their portable document and provenance through MCP. Use a
+  built-in procedural family only when it passed the base-set reliability gate
+  and the task calls for new generation rather than an existing asset.
 - Stylized *seamless textures* → `@call-me-sensei/toonlab/texgen` in code
   (60+ presets); the catalog has no texture entries, so this route is a
   package import, not an MCP call.

package/agents/skills/claude/vegetation-sky/SKILL.md

@@ -80,8 +80,11 @@ User guidance:
   create the pass after all writer meshes exist, call its `update()` every frame before grass, require
   `writerCount > 0` and `ready`, and call `invalidate()` after repainting a
   writer without a transform change.
-- In the public package, use `LEGACY_TREE_PRESETS` and `createLegacyTree()` for the 12
-  supported pre-species silhouettes. Use `BranchTree` when the developer wants
+- The public package contains tree construction and shader capability, not a
+  predefined tree asset collection. For an authored tree, use the connected
+  MCP's `search_public_gallery` and `get_public_gallery_asset` tools, then
+  instantiate its portable recipe with `StylizedTree`. Use `BranchTree` when
+  the developer explicitly wants
   recursive branching, five broadleaf silhouettes, leaf color/texture plus a
   portable lit/shadow/crown palette, independent leaf `coverageScale`, bark
   color/texture, authored trunk bend/twist/taper, roots, portable documents,
@@ -108,11 +111,11 @@ User guidance:
   `GRASS_SHADER_PROFILE`, and `FLOWER_SHADER_PROFILE` through the bundle's
   `treeShader`, `grassShader`, and `flowerShader` slots. They share a renderer
   family and semantic material contract, but serialize and apply independently.
-  Keep asset albedo and legacy/BranchTree geometry/material inputs separate from all
+  Keep asset albedo and Gallery-recipe/BranchTree geometry/material inputs separate from all
   three shader treatments.
 - Grass palettes update base, tip, and shadow tint together; they do not change
   shadow strength, wind, or current weather.
-- Use the public versioned Grass, vegetation-shader, legacy/BranchTree/flower recipe, and Sky
+- Use the public versioned Grass, vegetation-shader, BranchTree/flower recipe, and Sky
   preset document APIs for portable data; do not copy lab-local validators.
 - Treat Sky as one integrated World System, not a separate Shader Lab. Its
   shader, sun, clouds, stars, and procedural motion form one system preset with

package/agents/skills/codex/asset-sourcing/SKILL.md

@@ -50,9 +50,11 @@ scene-kit role.
 2. **Reuse what exists.** In OSS, earlier imports, saved presets, and exports
    live in `.toonlab/`; call local `list_my_creations` and `search_assets` with
    `source: 'workspace'`, `'workspace-storage'`, `'library'`, or `'builtin'`.
-   If those do not close the role, use local `search_assets` with
-   `source: 'official'` for the complete released Gallery catalog and follow
-   `nextOffset` until null.
+   If those do not close the role, use local `search_public_gallery` and follow
+   `nextOffset` until null; use `type: 'tree-recipe'` for authored trees and
+   retrieve a finalist with `get_public_gallery_asset`. Use local
+   `search_assets({ source: 'official' })` only for the installed released
+   catalog.
    In Pro, call cloud `list_my_creations`, then `search_public_gallery`; use
    `source: 'toonlab'` plus the appropriate catalog for first-party assets and
    follow `nextOffset`. For rocks on either surface, shortlist from positive
@@ -195,9 +197,10 @@ table, as the source of truth):
 
 - Seamless PBR material sets (brick, wood, ground …) → ambientCG.
 - Photoscanned props, HDRIs, high-end texture sets → Poly Haven.
-- Stylized/toon-ready models, vegetation, buildings → the built-in
-  procedural catalog first only for families that passed the base-set
-  reliability gate; otherwise compare curated external candidates.
+- Authored stylized/toon-ready models and vegetation → the public Gallery
+  first; retrieve their portable document and provenance through MCP. Use a
+  built-in procedural family only when it passed the base-set reliability gate
+  and the task calls for new generation rather than an existing asset.
 - Stylized *seamless textures* → `@call-me-sensei/toonlab/texgen` in code
   (60+ presets); the catalog has no texture entries, so this route is a
   package import, not an MCP call.

package/agents/skills/codex/vegetation-sky/SKILL.md

@@ -80,8 +80,11 @@ User guidance:
   create the pass after all writer meshes exist, call its `update()` every frame before grass, require
   `writerCount > 0` and `ready`, and call `invalidate()` after repainting a
   writer without a transform change.
-- In the public package, use `LEGACY_TREE_PRESETS` and `createLegacyTree()` for the 12
-  supported pre-species silhouettes. Use `BranchTree` when the developer wants
+- The public package contains tree construction and shader capability, not a
+  predefined tree asset collection. For an authored tree, use the connected
+  MCP's `search_public_gallery` and `get_public_gallery_asset` tools, then
+  instantiate its portable recipe with `StylizedTree`. Use `BranchTree` when
+  the developer explicitly wants
   recursive branching, five broadleaf silhouettes, leaf color/texture plus a
   portable lit/shadow/crown palette, independent leaf `coverageScale`, bark
   color/texture, authored trunk bend/twist/taper, roots, portable documents,
@@ -108,11 +111,11 @@ User guidance:
   `GRASS_SHADER_PROFILE`, and `FLOWER_SHADER_PROFILE` through the bundle's
   `treeShader`, `grassShader`, and `flowerShader` slots. They share a renderer
   family and semantic material contract, but serialize and apply independently.
-  Keep asset albedo and legacy/BranchTree geometry/material inputs separate from all
+  Keep asset albedo and Gallery-recipe/BranchTree geometry/material inputs separate from all
   three shader treatments.
 - Grass palettes update base, tip, and shadow tint together; they do not change
   shadow strength, wind, or current weather.
-- Use the public versioned Grass, vegetation-shader, legacy/BranchTree/flower recipe, and Sky
+- Use the public versioned Grass, vegetation-shader, BranchTree/flower recipe, and Sky
   preset document APIs for portable data; do not copy lab-local validators.
 - Treat Sky as one integrated World System, not a separate Shader Lab. Its
   shader, sun, clouds, stars, and procedural motion form one system preset with

package/mcp/public-catalog.mjs

@@ -25,62 +25,14 @@ function entry(input) {
   });
 }
 
-const CURATED_PLANT_RECIPES = Object.freeze([
-  entry({
-    cluster: 'vegetation',
-    description: 'Mid-size broadleaf starting recipe for anime environments.',
-    id: 'tree/broadleaf/sensei',
-    kind: 'recipe',
-    label: 'Sensei broadleaf',
-    recipe: {
-      options: { seed: 3, size: 3.2 },
-      schema: 'treeRecipe',
-      type: 'tree',
-      version: 1,
-    },
-    spawn: 'createPlantFromRecipe(entry.recipe)',
-    tags: ['tree', 'vegetation', 'anime'],
-    thumbnail: thumbnailFor('tree/broadleaf/sensei'),
-  }),
-  entry({
-    cluster: 'vegetation',
-    description: 'Ground-hugging foliage mass for yards and path edges.',
-    id: 'tree/bush/hedge',
-    kind: 'recipe',
-    label: 'Hedge bush',
-    recipe: {
-      options: { seed: 5, size: 1.2 },
-      schema: 'treeRecipe',
-      type: 'bush',
-      version: 1,
-    },
-    spawn: 'createPlantFromRecipe(entry.recipe)',
-    tags: ['bush', 'vegetation', 'anime'],
-    thumbnail: thumbnailFor('tree/bush/hedge'),
-  }),
-  entry({
-    cluster: 'vegetation',
-    description: 'Flowering plant with daisy heads.',
-    id: 'tree/flower/daisy',
-    kind: 'recipe',
-    label: 'Daisy flower',
-    recipe: {
-      options: { seed: 9, size: 0.5, species: 'daisy' },
-      schema: 'treeRecipe',
-      type: 'flower',
-      version: 1,
-    },
-    spawn: 'createPlantFromRecipe(entry.recipe)',
-    tags: ['flower', 'vegetation', 'anime'],
-    thumbnail: thumbnailFor('tree/flower/daisy'),
-  }),
-]);
-
 let cached = null;
 
 export function publicMcpCatalogEntries() {
   if (cached) return cached;
-  const entries = [...CURATED_PLANT_RECIPES];
+  // Authored vegetation recipes are Gallery assets, not package built-ins.
+  // The packaged MCP discovers them from the public Gallery so provenance,
+  // license, review state, and immutable documents stay attached.
+  const entries = [];
 
   for (const option of getRockgenPresetOptions()) {
     const id = `rock/${slug(option.value)}`;

package/mcp/server.mjs

@@ -82,6 +82,8 @@ const SERVER_NAME = 'toonlab-oss';
 const SERVER_VERSION = JSON.parse(
   readFileSync(new URL('../package.json', import.meta.url), 'utf8'),
 ).version;
+const PUBLIC_GALLERY_ENDPOINT = process.env.TOONLAB_PUBLIC_GALLERY_URL
+  ?? 'https://toonlab.io/api/v1/creations';
 const LATEST_PROTOCOL_VERSION = '2025-11-25';
 const SUPPORTED_PROTOCOL_VERSIONS = new Set([
   LATEST_PROTOCOL_VERSION,
@@ -289,6 +291,112 @@ function normalizeDiscovery(entry, summary, { domain = '', policy = null } = {})
   };
 }
 
+function publicGalleryUrl(path = '') {
+  let endpoint;
+  try {
+    endpoint = new URL(PUBLIC_GALLERY_ENDPOINT);
+  } catch {
+    throw new Error('TOONLAB_PUBLIC_GALLERY_URL must be an absolute HTTP(S) URL.');
+  }
+  if (!['http:', 'https:'].includes(endpoint.protocol)) {
+    throw new Error('TOONLAB_PUBLIC_GALLERY_URL must use HTTP(S).');
+  }
+  endpoint.search = '';
+  endpoint.hash = '';
+  if (!path) return endpoint;
+  endpoint.pathname = `${endpoint.pathname.replace(/\/$/u, '')}/${encodeURIComponent(path)}`;
+  return endpoint;
+}
+
+function absoluteGalleryReference(reference) {
+  if (typeof reference !== 'string' || !reference.trim()) return null;
+  return new URL(reference, publicGalleryUrl()).href;
+}
+
+async function fetchPublicGalleryJson(url) {
+  let response;
+  try {
+    response = await fetch(url, {
+      headers: { accept: 'application/json' },
+      signal: AbortSignal.timeout(15_000),
+    });
+  } catch (cause) {
+    throw new Error(`ToonLab public Gallery request failed: ${cause?.message ?? String(cause)}`);
+  }
+  if (!response.ok) {
+    throw new Error(`ToonLab public Gallery returned HTTP ${response.status}.`);
+  }
+  try {
+    return await response.json();
+  } catch {
+    throw new Error('ToonLab public Gallery returned invalid JSON.');
+  }
+}
+
+function normalizePublicGalleryItem(item, args = {}) {
+  const id = String(item?.id ?? '').trim();
+  if (!id) throw new Error('ToonLab public Gallery returned an item without an id.');
+  const type = String(item.type ?? 'creation');
+  const entry = {
+    attribution: item.attribution ?? null,
+    author: item.author ?? null,
+    cluster: type,
+    description: item.description ?? null,
+    documentUrl: absoluteGalleryReference(item.download ?? item.documentUrl),
+    id,
+    kind: type,
+    label: String(item.label ?? id),
+    license: item.license ?? null,
+    source: 'gallery',
+    sourceClass: 'toonlab-gallery',
+    tags: Array.isArray(item.tags) ? item.tags.map(String) : [],
+    thumbnail: absoluteGalleryReference(item.thumbnail),
+    updatedAt: item.updated_at ?? null,
+    url: absoluteGalleryReference(item.url ?? `/c/${item.slug ?? id}`),
+  };
+  return normalizeDiscovery(entry, entry, args);
+}
+
+async function searchPublicGallery(args = {}) {
+  const limit = limitValue(args.limit, 20, 60);
+  const offset = Math.max(0, Math.floor(Number(args.offset) || 0));
+  const endpoint = publicGalleryUrl();
+  endpoint.searchParams.set('limit', String(limit));
+  endpoint.searchParams.set('offset', String(offset));
+  if (String(args.query ?? '').trim()) endpoint.searchParams.set('q', String(args.query).trim());
+  if (String(args.type ?? '').trim()) endpoint.searchParams.set('type', String(args.type).trim());
+  const response = await fetchPublicGalleryJson(endpoint);
+  if (!Array.isArray(response?.items)) {
+    throw new Error('ToonLab public Gallery response is missing items.');
+  }
+  const items = response.items.map((item) => normalizePublicGalleryItem(item, args));
+  return {
+    count: items.length,
+    items,
+    limit,
+    nextOffset: items.length === limit ? offset + items.length : null,
+    offset,
+    source: 'toonlab-public-gallery',
+  };
+}
+
+async function getPublicGalleryAsset(args = {}) {
+  const id = String(args.id ?? '').trim();
+  if (!id) throw new Error('A public Gallery asset id or slug is required.');
+  const item = await fetchPublicGalleryJson(publicGalleryUrl(id));
+  const normalized = normalizePublicGalleryItem({
+    ...item,
+    download: item.documentUrl ?? null,
+    thumbnail: item.thumbnail ?? null,
+    url: item.url ?? `/c/${item.slug ?? id}`,
+  }, args);
+  return {
+    ...normalized,
+    document: item.document ?? null,
+    files: Array.isArray(item.files) ? item.files : [],
+  };
+}
+
 function summarizeCatalogEntry(entry) {
   const metadata = entry.metadata && typeof entry.metadata === 'object' && !Array.isArray(entry.metadata)
     ? entry.metadata
@@ -989,7 +1097,7 @@ const TOOLS = [
   },
   {
     annotations: { readOnlyHint: true },
-    description: 'Search built-in procedural assets, the paginated complete official Gallery catalog, saved library entries, lab presets, and files on disk. Official rock summaries include compact dimensions and taxonomy metadata; follow nextOffset until null.',
+    description: 'Search approved built-in generator/settings entries, the local released official catalog, saved library entries, lab presets, and files on disk. Official rock summaries include compact dimensions and taxonomy metadata; follow nextOffset until null.',
     inputSchema: {
       additionalProperties: false,
       properties: {
@@ -1008,6 +1116,40 @@ const TOOLS = [
     name: 'search_assets',
     title: 'Search ToonLab assets',
   },
+  {
+    annotations: { openWorldHint: true, readOnlyHint: true },
+    description: 'Search public ToonLab Gallery creations with their license, attribution, tags, thumbnail, and immutable portable-document URL. Authored tree recipes live here rather than in npm; use type="tree-recipe" and follow nextOffset until null.',
+    inputSchema: {
+      additionalProperties: false,
+      properties: {
+        domain: { type: 'string' },
+        limit: { maximum: 60, minimum: 1, type: 'integer' },
+        offset: { minimum: 0, type: 'integer' },
+        policy: { type: 'object' },
+        query: { type: 'string' },
+        type: { type: 'string' },
+      },
+      type: 'object',
+    },
+    name: 'search_public_gallery',
+    title: 'Search the ToonLab public Gallery',
+  },
+  {
+    annotations: { openWorldHint: true, readOnlyHint: true },
+    description: 'Get one public ToonLab Gallery creation by publication id or slug, including its complete portable document and immutable public files.',
+    inputSchema: {
+      additionalProperties: false,
+      properties: {
+        domain: { type: 'string' },
+        id: { type: 'string' },
+        policy: { type: 'object' },
+      },
+      required: ['id'],
+      type: 'object',
+    },
+    name: 'get_public_gallery_asset',
+    title: 'Get a ToonLab public Gallery asset',
+  },
   {
     annotations: { readOnlyHint: true },
     description: 'Get a complete asset, recipe, preset, library entry, or workspace file descriptor by id.',
@@ -1415,6 +1557,8 @@ async function callTool(name, args = {}) {
     case 'get_lab_features': return getLabFeatures(args.lab);
     case 'create_lab_document': return createLabDocumentTool(args);
     case 'search_assets': return searchAssets(args);
+    case 'search_public_gallery': return searchPublicGallery(args);
+    case 'get_public_gallery_asset': return getPublicGalleryAsset(args);
     case 'get_asset': return getAsset(args);
     case 'list_my_creations': return listMyCreations(args);
     case 'get_my_creation': return getMyCreation(args);
@@ -1486,6 +1630,7 @@ async function callTool(name, args = {}) {
       available: [
         'Generate deterministic recipes from the stable public ToonLab catalog entries.',
         'Save and retrieve editable lab documents through the shared .toonlab workspace.',
+        'Search and retrieve authored public Gallery recipes with license and provenance.',
         'Search and import CC0 assets from Poly Haven and ambientCG.',
         'Use each recipe\'s spawn snippet to integrate it into a Three.js project.',
       ],
@@ -1536,7 +1681,7 @@ async function handleRequest(message) {
       jsonrpc: '2.0',
       result: {
         capabilities: { resources: {}, tools: {} },
-        instructions: 'ToonLab builds anime-style games, characters, and environments for Three.js. Call list_live_labs and get_lab_features when authoring a Lab artifact, use create_lab_document for a valid starter, and prefer mutate_lab_creation over hand-editing structural arrays. Official Rock details include a source-GLB starter. This OSS server may edit any non-secret creation or lab-state entry in its local workspace; deletions require explicit confirmation. Load the selected style bundle first. If no asset-sourcing policy exists, ask the developer, then continue with library-first advisory discovery while recording the unresolved decision. Search the project and ToonLab libraries before public sources; generate or hand-author only when policy permits. Validate every candidate, preserve provenance, evaluate anime-fit in scene, and record a gap before adding a custom shader, texture, model, or adapter. When local provider keys are configured, generate_ai_asset exposes image generation, Meshy 7 image/multiview-to-3D, and Text -> selected image model -> Meshy 7 through MCP.',
+        instructions: 'ToonLab builds anime-style games, characters, and environments for Three.js. Call list_live_labs and get_lab_features when authoring a Lab artifact, use create_lab_document for a valid starter, and prefer mutate_lab_creation over hand-editing structural arrays. Official Rock details include a source-GLB starter. This OSS server may edit any non-secret creation or lab-state entry in its local workspace; deletions require explicit confirmation. Load the selected style bundle first. If no asset-sourcing policy exists, ask the developer, then continue with library-first advisory discovery while recording the unresolved decision. Search the project and local library first, then search_public_gallery for reviewed authored assets such as tree recipes, before external sources. Generate or hand-author only when policy permits. Validate every candidate, preserve provenance, evaluate anime-fit in scene, and record a gap before adding a custom shader, texture, model, or adapter. When local provider keys are configured, generate_ai_asset exposes image generation, Meshy 7 image/multiview-to-3D, and Text -> selected image model -> Meshy 7 through MCP.',
         protocolVersion: SUPPORTED_PROTOCOL_VERSIONS.has(requested) ? requested : LATEST_PROTOCOL_VERSION,
         serverInfo: { name: SERVER_NAME, version: SERVER_VERSION },
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@call-me-sensei/toonlab",
-  "version": "0.4.20",
+  "version": "0.4.21",
   "description": "Anime-style game toolkit for Three.js with cel shading, vegetation, rocks, water, sky, clouds, procedural textures, and portable Lab artifacts",
   "license": "MIT",
   "author": "Hyperbond Studio PTE. LTD. (Call Me Sensei)",
@@ -347,7 +347,6 @@
     "verify:quality-integration": "node scripts/verify-quality-budget-integration.mjs && node scripts/verify-packaged-quality-budget-integration.mjs",
     "verify:vegetation-shader": "node scripts/verify-vegetation-shader.mjs",
     "verify:lab-styles": "node scripts/verify-lab-style-boundaries.mjs",
-    "verify:legacy-trees": "node scripts/verify-legacy-trees.mjs",
     "verify:branch-tree": "node scripts/verify-branch-tree.mjs",
     "verify:tree-doodle": "node scripts/verify-tree-doodle.mjs",
     "verify:tree-woody": "node scripts/verify-tree-woody-engine.mjs",
@@ -365,7 +364,7 @@
     "verify:collision-package": "node scripts/verify-packaged-world-collision.mjs",
     "verify:official-catalog": "node scripts/verify-official-catalog-provider.mjs && node scripts/verify-official-catalog-runtime.mjs && node scripts/verify-official-catalog-lod.mjs && node scripts/verify-official-catalog-placement.mjs && node scripts/verify-playground-official-catalog.mjs && node scripts/verify-packaged-official-catalog.mjs",
     "verify:system-style": "node scripts/verify-system-style-policy.mjs",
-    "verify:release": "npm run verify:system-style && npm run verify:style-contract && npm run verify:style-labels-package && npm run verify:collision-package && npm run verify:scene-collision && npm run verify:official-catalog && npm run verify:public-labs && npm run verify:live-labs && npm run verify:rock-shader && npm run verify:rock-generation-lab && npm run verify:rock-lab-lifecycle && npm run verify:ground-shader && npm run verify:manufactured-materials && npm run verify:material-labeling:agent && npm run verify:material-labeling:mcp && npm run verify:water-lab && npm run verify:water && npm run verify:vegetation-labs && npm run verify:texgen && npm run verify:cloud-shader && npm run verify:sky-cloud-lab && npm run verify:world-quality && npm run verify:scatter && npm run verify:legacy-trees && npm run verify:branch-tree && npm run verify:grass-package && npm run verify:character-package && npm run verify:locomotion-state && npm run verify:ground-stabilizer && npm run verify:water-interaction && npm run verify:walkable-character && npm run verify:playground-walkable && npm run verify:renderer-configuration && npm run verify:scene-scheduler && npm run verify:scene-surface && npm run verify:shared-shadow-receivers && npm run verify:scene-quality && npm run verify:quality-integration && npm run verify:lab-asset-provenance && npm run verify:api && npm run verify:types && npm run verify:mcp && npm run verify:skills && npm run verify:docs && npm run verify:local-database && npm run verify:package",
+    "verify:release": "npm run verify:system-style && npm run verify:style-contract && npm run verify:style-labels-package && npm run verify:collision-package && npm run verify:scene-collision && npm run verify:official-catalog && npm run verify:public-labs && npm run verify:live-labs && npm run verify:rock-shader && npm run verify:rock-generation-lab && npm run verify:rock-lab-lifecycle && npm run verify:ground-shader && npm run verify:manufactured-materials && npm run verify:material-labeling:agent && npm run verify:material-labeling:mcp && npm run verify:water-lab && npm run verify:water && npm run verify:vegetation-labs && npm run verify:texgen && npm run verify:cloud-shader && npm run verify:sky-cloud-lab && npm run verify:world-quality && npm run verify:scatter && npm run verify:branch-tree && npm run verify:grass-package && npm run verify:character-package && npm run verify:locomotion-state && npm run verify:ground-stabilizer && npm run verify:water-interaction && npm run verify:walkable-character && npm run verify:playground-walkable && npm run verify:renderer-configuration && npm run verify:scene-scheduler && npm run verify:scene-surface && npm run verify:shared-shadow-receivers && npm run verify:scene-quality && npm run verify:quality-integration && npm run verify:lab-asset-provenance && npm run verify:api && npm run verify:types && npm run verify:mcp && npm run verify:skills && npm run verify:docs && npm run verify:local-database && npm run verify:package",
     "verify:generation": "node scripts/verify-generation.mjs",
     "verify:post": "node scripts/verify-post.mjs",
     "verify:camera": "node scripts/verify-camera.mjs",
@@ -374,7 +373,7 @@
     "verify:soundscape": "node scripts/verify-soundscape.mjs",
     "verify:game-feel": "node scripts/verify-game-feel.mjs",
     "verify:world-quality": "node scripts/verify-world-quality.mjs",
-    "verify:all": "npm run verify:system-style && npm run verify:product-namespace && npm run verify:generation && npm run verify:post && npm run verify:camera && npm run verify:motion && npm run verify:biome && npm run verify:soundscape && npm run verify:game-feel && npm run verify:world-quality && npm run verify:rock-shader && npm run verify:ground-shader && npm run verify:rockgen && npm run verify:rock-generation-lab && npm run verify:pathgen && npm run verify:propgen && npm run verify:buildinggen && npm run verify:villagegen && npm run verify:fauna && npm run verify:ambientfx && npm run verify:vfxgen && npm run verify:water && npm run verify:landscape && npm run verify:lighting && npm run verify:lighting-lab && npm run verify:live-labs && npm run verify:lab-preview && npm run verify:weather && npm run verify:climate && npm run verify:atmospheric-condition-lab && npm run verify:sky && npm run verify:cloud-shader && npm run verify:sky-cloud-lab && npm run verify:environment-cycle && npm run verify:manufactured-materials && npm run verify:ground-field && npm run verify:grass && npm run verify:grass-package && npm run verify:character-package && npm run verify:vegetation-shader && npm run verify:lab-styles && npm run verify:scatter && npm run verify:legacy-trees && npm run verify:branch-tree && npm run verify:collision-package && npm run verify:scene-collision && npm run verify:official-catalog && npm run verify:api && npm run verify:package && npm run verify:catalog && npm run verify:assetlib && npm run verify:mcp && npm run verify:local-generation",
+    "verify:all": "npm run verify:system-style && npm run verify:product-namespace && npm run verify:generation && npm run verify:post && npm run verify:camera && npm run verify:motion && npm run verify:biome && npm run verify:soundscape && npm run verify:game-feel && npm run verify:world-quality && npm run verify:rock-shader && npm run verify:ground-shader && npm run verify:rockgen && npm run verify:rock-generation-lab && npm run verify:pathgen && npm run verify:propgen && npm run verify:buildinggen && npm run verify:villagegen && npm run verify:fauna && npm run verify:ambientfx && npm run verify:vfxgen && npm run verify:water && npm run verify:landscape && npm run verify:lighting && npm run verify:lighting-lab && npm run verify:live-labs && npm run verify:lab-preview && npm run verify:weather && npm run verify:climate && npm run verify:atmospheric-condition-lab && npm run verify:sky && npm run verify:cloud-shader && npm run verify:sky-cloud-lab && npm run verify:environment-cycle && npm run verify:manufactured-materials && npm run verify:ground-field && npm run verify:grass && npm run verify:grass-package && npm run verify:character-package && npm run verify:vegetation-shader && npm run verify:lab-styles && npm run verify:scatter && npm run verify:branch-tree && npm run verify:collision-package && npm run verify:scene-collision && npm run verify:official-catalog && npm run verify:api && npm run verify:package && npm run verify:catalog && npm run verify:assetlib && npm run verify:mcp && npm run verify:local-generation",
     "verify:catalog": "node scripts/verify-catalog.mjs",
     "verify:assetlib": "node scripts/verify-assetlib.mjs",
     "verify:mcp": "node scripts/verify-mcp.mjs",

package/src/vegetation/index.js

@@ -4,9 +4,29 @@ export * from './grassClump.js';
 export * from './callMeSenseiGrass.js';
 export * from './stylizedFlowers.js';
 export * from './flowerSpecies.js';
-export * from './stylizedTree.js';
+// Public tree construction/runtime surface. Authored tree recipes are assets
+// and are discovered through ToonLab MCP; showcase/example recipe arrays are
+// deliberately not re-exported from the npm package.
+export {
+  DEFAULT_STYLIZED_TREE_SETTINGS,
+  STYLIZED_TREE_SETTING_FIELD_SCHEMA,
+  STYLIZED_TREE_SETTING_GROUPS,
+  TREE_RECIPE_SCHEMA,
+  TREE_RECIPE_VERSION,
+  TREE_TRUNK_STYLES,
+  StylizedTree,
+  createBranchTubeGeometry,
+  createBranchingTreeSkeleton,
+  createStylizedTreeSettings,
+  createTreeSkeleton,
+  createTreeTrunkGeometry,
+  getStylizedTreePresetOptions,
+  polarProfileFromOutline,
+  registerStylizedTreePreset,
+  resolvePadPruning,
+  serializableTreeOptions,
+} from './stylizedTree.js';
 export * from './branchTree.js';
-export * from './legacyTreePresets.js';
 export * from './stylizedTreeFoliage.js';
 export * from './stylizedBush.js';
 export * from './stylizedFlower.js';

package/src/vegetation/scatter.js

@@ -247,7 +247,12 @@ export function scatterGrassAround({
  * straight to StylizedTree for silhouette variation:
  *
  *   for (const p of scatterForest({ center, radius: 80, spacing: 9, heightAt, mask })) {
- *     const tree = new StylizedTree({ preset: 'call_me_sensei', seed: p.seed, size: 3.2 });
+ *     const tree = new StylizedTree({
+ *       ...galleryTreeRecipe.options,
+ *       seed: p.seed,
+ *       size: 3.2,
+ *       vegetationShader: { preset: 'call_me_sensei' },
+ *     });
  *     tree.position.set(p.x, p.y, p.z);
  *     scene.add(tree);
  *   }

package/src/vegetation/stylizedTree.js

@@ -1334,88 +1334,6 @@ export const TREE_TRUNK_STYLES = Object.freeze({
     height: 1.8, radiusBottom: 0.24 },
 });
 
-// Ready-made example recipes, ordered least → most complex configuration.
-// Used by Tree Lab and the playground scene's showcase row; each is a
-// complete options object for `new StylizedTree(...)`.
-export const STYLIZED_TREE_EXAMPLES = Object.freeze([
-  // 1. Baseline: straight trunk, default crown, one flat color.
-  { seed: 3, size: 1.7, canopyColor: 0x4da258, leafDensity: 1,
-    trunk: TREE_TRUNK_STYLES.straight },
-  // 2. Leaning trunk, same simple crown.
-  { seed: 8, size: 1.8, canopyColor: 0x54a85e, leafDensity: 1,
-    trunk: TREE_TRUNK_STYLES.leaning },
-  // 3. Slight see-through: gap pockets open, branches peek through.
-  { seed: 5, size: 1.9, canopyColor: 0x5eb063, leafDensity: 0.85,
-    trunk: TREE_TRUNK_STYLES.leaning },
-  // 4. Curved trunk + its own irregular crown layout.
-  { seed: 11, size: 2.0, canopyColor: 0x58ab5c, leafDensity: 0.95,
-    trunk: TREE_TRUNK_STYLES.curved },
-  // 5. Color picked from a list, per-seed (forest variation from one spec).
-  { seed: 17, size: 2.0, canopyColor: [0x4da258, 0x7fb84e, 0x9cbf46], leafDensity: 0.95,
-    trunk: TREE_TRUNK_STYLES.curved },
-  // 6. Wide-and-shallow crown (X reach 1.6, Z reach 0.7).
-  { seed: 9, size: 2.0, canopyColor: 0x6db54f, leafDensity: 0.95,
-    canopyWidth: 1.6, canopyDepth: 0.7, trunk: TREE_TRUNK_STYLES.leaning },
-  // 7. Autumn blend: seeded mix between two colors.
-  { seed: 21, size: 2.1, canopyColor: { from: 0xe8a33c, to: 0xd96f29 }, leafDensity: 0.9,
-    trunk: TREE_TRUNK_STYLES.curved },
-  // 8. Gnarled old tree: knotted growth, sparser crown shows the wood.
-  { seed: 14, size: 2.0, canopyColor: 0x8f9e44, leafDensity: 0.72,
-    trunk: TREE_TRUNK_STYLES.gnarled },
-  // 9. Bonsai: corkscrew twist, flat wide pads, HSL-range blossom color.
-  { seed: 26, size: 1.7, leafDensity: 0.8, canopyWidth: 1.4, canopyDepth: 1.2,
-    canopyColor: { hue: [0.9, 1.0], saturation: [0.45, 0.6], lightness: [0.62, 0.72] },
-    trunk: TREE_TRUNK_STYLES.bonsai },
-  // 10. The Liyue golden gingko: fat-based serpentine trunk (bow right,
-  //     top swept hard left, S locked by leanOffset), extra-wide crown,
-  //     pinned pale-gold highlight tone. bendDirection 0 keeps the S in the
-  //     X-Y plane so the silhouette reads head-on in the showcase row.
-  { seed: 12, size: 2.4, canopyColor: 0xf5c531, canopyPalette: { crown: 0xffe98a },
-    leafDensity: 0.95, canopyWidth: 1.5,
-    skeleton: { radialSegments: 10 },
-    trunk: { ...TREE_TRUNK_STYLES.swooping, bend: 0.5, lean: 0.95,
-      bendDirection: 0, height: 2.0, radiusBottom: 0.28 } },
-  // 11. Sumeru-style: long bare pale limbs reaching out of the crown with
-  //     violet leaf bushes only at the branch ends (leafPlacement 'tips').
-  { seed: 31, size: 2.3, pale: true, canopyColor: 0x8578e6,
-    canopyPalette: { crown: 0xbdb2ff },
-    leafDensity: 0.9, canopyWidth: 1.45, leafPlacement: 'tips',
-    trunkReceiveShadow: false,
-    skeleton: { attractionCount: 70, influenceRadius: 1.35 },
-    trunk: { ...TREE_TRUNK_STYLES.curved, bend: 0.3, lean: 0.35, gnarl: 0.45,
-      height: 1.9, radiusBottom: 0.26 } },
-  // 12. MASSIVE climbable Sumeru tree: thick bare limbs long and low enough
-  //     to stand or sit on (scenes read `climbable: true` and collide the
-  //     wood as a trimesh instead of a trunk capsule), sparse skeleton so
-  //     the pale limbs stay on show, foliage clouds only at the limb ends.
-  { seed: 46, size: 4.0, pale: true, climbable: true,
-    canopyColor: 0x8578e6, canopyPalette: { crown: 0xbdb2ff },
-    leafDensity: 0.92, canopyWidth: 1.75, canopyDepth: 1.2,
-    leafPlacement: 'tips', trunkReceiveShadow: false,
-    skeleton: { attractionCount: 55, influenceRadius: 1.7, killRadius: 0.55,
-      segmentLength: 0.36, attractionReach: 0.95, radialSegments: 14,
-      tipRadius: 0.05, minLimbRadius: 0.04, maxNodes: 130 },
-    canopy: { cardsPerCluster: 12, clusterRadius: 0.62 },
-    trunk: { ...TREE_TRUNK_STYLES.leaning, bend: 0.24, lean: 0.42,
-      height: 1.4, radiusBottom: 0.48 } },
-]);
-
-// Centered X offsets for a showcase row: cumulative spacing from each tree's
-// approximate crown footprint, so a massive example doesn't swallow its
-// neighbors the way fixed spacing would.
-export function layoutTreeRow(configs, { margin = 1.6 } = {}) {
-  const footprints = configs.map((config) =>
-    (config.size ?? 1) * (config.canopyWidth ?? 1) * 2.3 + 1.4);
-  const offsets = [];
-  let cursor = 0;
-  footprints.forEach((footprint, index) => {
-    if (index > 0) cursor += (footprints[index - 1] + footprint) / 2 + margin;
-    offsets.push(cursor);
-  });
-  const center = cursor / 2;
-  return offsets.map((offset) => offset - center);
-}
-
 // Recipe documents: a plant serialized as { schema, version, type, options }.
 // The options are exactly what the constructor takes, so a recipe rebuilds
 // the identical plant (generation is deterministic per seed). Defined here —
@@ -1667,37 +1585,15 @@ export const DEFAULT_STYLIZED_TREE_SETTINGS = Object.freeze({
   }),
 });
 
-// Named tree presets (grouped partial settings): 'default' is the baseline;
-// 'call_me_sensei' is the studio-managed signature look, curated and updated
-// over releases. Community presets register alongside them via
-// registerStylizedTreePreset().
+// Named runtime settings: npm ships only the neutral baseline. Authored tree
+// recipes live in the public Gallery and may be registered explicitly after
+// MCP discovery when an application wants name-based selection.
 const stylizedTreePresetRegistry = new Map([
   ['default', Object.freeze({
     description: 'Baseline stylized tree.',
     label: 'Default',
     settings: Object.freeze({}),
   })],
-  ['call_me_sensei', Object.freeze({
-    description: 'Studio-managed signature tree, curated by Call Me Sensei and updated over releases. Open broadleaf with visible branching: leaf clusters sit at the branch tips instead of filling a solid shell, so the limb structure reads through the crown.',
-    label: 'Call Me Sensei',
-    settings: Object.freeze({
-      skeleton: Object.freeze({ attractionCount: 55, influenceRadius: 1.35 }),
-      tree: Object.freeze({
-        canopyWidth: 1.35,
-        leafDensity: 1.15,
-        leafPlacement: 'tips',
-        trunkColor: Object.freeze([0.58, 0.36, 0.2]),
-      }),
-      trunk: Object.freeze({
-        ...TREE_TRUNK_STYLES.curved,
-        bend: 0.24,
-        gnarl: 0.22,
-        height: 1.9,
-        lean: 0.24,
-        radiusBottom: 0.2,
-      }),
-    }),
-  })],
 ]);
 
 /**

package/src/version.js

@@ -1,3 +1,3 @@
 // Single runtime source of truth for package consumers and ToonLab Pro/MCP.
 // Keep this value synchronized with package.json during release preparation.
-export const TOONLAB_VERSION = '0.4.20';
+export const TOONLAB_VERSION = '0.4.21';

package/types/index.d.ts

@@ -299,8 +299,6 @@ export const HERO_CLOUD_RECIPE_VERSION: any;
 export const HUMANOID_ROLES: any;
 export const LEAF_SHAPE_PRESETS: any;
 export const LEGACY_STYLE_BUNDLE_SCHEMA_VERSION: any;
-export const LEGACY_TREE_IDS: any;
-export const LEGACY_TREE_PRESETS: any;
 export const LIGHTING_LOOK_DOCUMENT_TYPE: any;
 export const LIGHTING_LOOK_PRESETS: any;
 export const LIGHTING_LOOK_SCHEMA_VERSION: any;
@@ -505,7 +503,6 @@ export const STYLE_TARGET_DOMAINS: any;
 export const STYLE_TARGET_LABEL_KEY: any;
 export const STYLE_TARGET_LABEL_SCHEMA_VERSION: any;
 export const STYLIZED_FOREST_IMPOSTOR_QUALITY: any;
-export const STYLIZED_TREE_EXAMPLES: any;
 export const STYLIZED_TREE_SETTING_FIELD_SCHEMA: any;
 export const STYLIZED_TREE_SETTING_GROUPS: any;
 export const SUN_COLOR_FIELD: any;
@@ -869,7 +866,6 @@ export function createHeroCloudWeatherTexture(...args: any[]): any;
 export function createImportedVegetationMaterial(...args: any[]): any;
 export function createIndirectLightSettings(...args: any[]): any;
 export function createLeafSpriteTexture(...args: any[]): any;
-export function createLegacyTree(...args: any[]): any;
 export function createLightArtisticSettings(...args: any[]): any;
 export function createLightColor(...args: any[]): any;
 export function createLightCookie(...args: any[]): any;
@@ -1098,8 +1094,6 @@ export function getGeometryTriangleCount(...args: any[]): any;
 export function getGrassPresetOptions(...args: any[]): any;
 export function getGroundShaderPresetOptions(...args: any[]): any;
 export function getHeroCloudPreviewCenter(...args: any[]): any;
-export function getLegacyTreePreset(...args: any[]): any;
-export function getLegacyTreePresetOptions(...args: any[]): any;
 export function getLightFixtureGeneratorFamilyOptions(...args: any[]): any;
 export function getLightFixtureOptions(...args: any[]): any;
 export function getLightingPresetOptions(...args: any[]): any;
@@ -1159,7 +1153,6 @@ export function isVegetationSharedShaderGroup(...args: any[]): any;
 export function isWindowCutoutMaterial(...args: any[]): any;
 export function labelManufacturedStyleTarget(...args: any[]): any;
 export function labelStyleTarget(...args: any[]): any;
-export function layoutTreeRow(...args: any[]): any;
 export function listFirstPartyStyleBundles(...args: any[]): any;
 export function listSurfaceMaterialModes(...args: any[]): any;
 export function loadAsync(...args: any[]): any;

package/types/vegetation/index.d.ts

@@ -39,12 +39,9 @@ export const GRASS_SHADER_PROFILE: any;
 export const GRASS_SHADER_PROFILE_DOCUMENT_TYPE: any;
 export const GRASS_SHADER_PROFILE_SCHEMA_VERSION: any;
 export const LEAF_SHAPE_PRESETS: any;
-export const LEGACY_TREE_IDS: any;
-export const LEGACY_TREE_PRESETS: any;
 export const NEEDLE_LEAF_SHAPES: any;
 export class RetainedGrassClumpField { constructor(...args: any[]); [key: string]: any; }
 export const STYLIZED_FOREST_IMPOSTOR_QUALITY: any;
-export const STYLIZED_TREE_EXAMPLES: any;
 export const STYLIZED_TREE_SETTING_FIELD_SCHEMA: any;
 export const STYLIZED_TREE_SETTING_GROUPS: any;
 export class StylizedBush { constructor(...args: any[]); [key: string]: any; }
@@ -133,7 +130,6 @@ export function createGrassShaderProfileSettings(...args: any[]): any;
 export function createGrassShaderSettings(...args: any[]): any;
 export function createImportedVegetationMaterial(...args: any[]): any;
 export function createLeafSpriteTexture(...args: any[]): any;
-export function createLegacyTree(...args: any[]): any;
 export function createNoisePatchMask(...args: any[]): any;
 export function createOrganLeafSpriteTexture(...args: any[]): any;
 export function createSlopeMask(...args: any[]): any;
@@ -159,8 +155,6 @@ export function deriveCanopyPalette(...args: any[]): any;
 export function disposeExportGroup(...args: any[]): any;
 export function getFlowerPresetOptions(...args: any[]): any;
 export function getGrassPresetOptions(...args: any[]): any;
-export function getLegacyTreePreset(...args: any[]): any;
-export function getLegacyTreePresetOptions(...args: any[]): any;
 export function getStylizedTreePresetOptions(...args: any[]): any;
 export function getTreeSurfaceProfileOptions(...args: any[]): any;
 export function getVegetationMaterialContract(...args: any[]): any;
@@ -169,7 +163,6 @@ export function getVegetationShaderScopeExcludedFields(...args: any[]): any;
 export function getVegetationShaderScopeFieldSchema(...args: any[]): any;
 export function getVegetationShaderScopeSettingGroups(...args: any[]): any;
 export function isVegetationSharedShaderGroup(...args: any[]): any;
-export function layoutTreeRow(...args: any[]): any;
 export function loadCallMeSenseiGrassClump(...args: any[]): any;
 export function loadCompiledTreeAsset(...args: any[]): any;
 export function matchGrassColorPalette(...args: any[]): any;

package/types/vegetation/stylizedTree.d.ts

@@ -1,6 +1,5 @@
 // Source inference fallback: public names retained with permissive signatures.
 export const DEFAULT_STYLIZED_TREE_SETTINGS: any;
-export const STYLIZED_TREE_EXAMPLES: any;
 export const STYLIZED_TREE_SETTING_FIELD_SCHEMA: any;
 export const STYLIZED_TREE_SETTING_GROUPS: any;
 export class StylizedTree { constructor(...args: any[]); [key: string]: any; }
@@ -13,7 +12,6 @@ export function createStylizedTreeSettings(...args: any[]): any;
 export function createTreeSkeleton(...args: any[]): any;
 export function createTreeTrunkGeometry(...args: any[]): any;
 export function getStylizedTreePresetOptions(...args: any[]): any;
-export function layoutTreeRow(...args: any[]): any;
 export function polarProfileFromOutline(...args: any[]): any;
 export function registerStylizedTreePreset(...args: any[]): any;
 export function resolvePadPruning(...args: any[]): any;

package/types/version.d.ts

@@ -1 +1 @@
-export const TOONLAB_VERSION: "0.4.20";
+export const TOONLAB_VERSION: "0.4.21";

package/src/vegetation/legacyTreePresets.js

@@ -1,120 +0,0 @@
-import {
-  STYLIZED_TREE_EXAMPLES,
-  StylizedTree,
-  TREE_RECIPE_SCHEMA,
-  TREE_RECIPE_VERSION,
-  serializableTreeOptions,
-} from './stylizedTree.js';
-
-const LEGACY_TREE_DEFINITIONS = Object.freeze([
-  Object.freeze({ id: 'straight', label: 'Straight' }),
-  Object.freeze({ id: 'leaning', label: 'Leaning' }),
-  Object.freeze({ id: 'see-through', label: 'See-through' }),
-  Object.freeze({ id: 'curved', label: 'Curved' }),
-  Object.freeze({ id: 'forest-mix', label: 'Forest Mix' }),
-  Object.freeze({ id: 'wide-crown', label: 'Wide Crown' }),
-  Object.freeze({ id: 'autumn-blend', label: 'Autumn Blend' }),
-  Object.freeze({ id: 'gnarled', label: 'Gnarled' }),
-  Object.freeze({ id: 'bonsai', label: 'Bonsai' }),
-  Object.freeze({ id: 'golden-gingko', label: 'Golden Gingko' }),
-  Object.freeze({ id: 'sumeru-tips', label: 'Sumeru Tips' }),
-  Object.freeze({ id: 'massive-sumeru', label: 'Massive Sumeru' }),
-]);
-
-function clone(value) {
-  if (Array.isArray(value)) return value.map(clone);
-  if (value && typeof value === 'object') {
-    return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, clone(entry)]));
-  }
-  return value;
-}
-
-function deepFreeze(value) {
-  if (!value || typeof value !== 'object' || Object.isFrozen(value)) return value;
-  for (const entry of Object.values(value)) deepFreeze(entry);
-  return Object.freeze(value);
-}
-
-function legacyOptions(example) {
-  // `pale` and `climbable` are old showcase-scene hints, not tree generator
-  // inputs. Preserve them as document metadata without feeding them into the
-  // stable constructor surface.
-  const { pale = false, climbable = false, ...options } = example;
-  return {
-    metadata: { climbable: Boolean(climbable), pale: Boolean(pale) },
-    options: serializableTreeOptions(options),
-  };
-}
-
-/**
- * The twelve pre-species ToonLab trees, now named and versioned explicitly.
- *
- * This is the supported legacy set that existed before the repository's
- * botanical species research. It contains only generic stylized silhouettes;
- * none of the documents claims a botanical species identity.
- */
-export const LEGACY_TREE_PRESETS = deepFreeze(LEGACY_TREE_DEFINITIONS.map((definition, index) => {
-  const normalized = legacyOptions(STYLIZED_TREE_EXAMPLES[index]);
-  return {
-    builtIn: true,
-    id: definition.id,
-    label: definition.label,
-    metadata: normalized.metadata,
-    options: normalized.options,
-    schema: TREE_RECIPE_SCHEMA,
-    type: 'tree',
-    version: TREE_RECIPE_VERSION,
-  };
-}));
-
-export const LEGACY_TREE_IDS = Object.freeze(LEGACY_TREE_PRESETS.map(({ id }) => id));
-
-/** Returns one immutable legacy recipe document, or null. */
-export function getLegacyTreePreset(id) {
-  return LEGACY_TREE_PRESETS.find((preset) => preset.id === id) ?? null;
-}
-
-/** Lists the stable legacy IDs and labels without duplicating recipe data. */
-export function getLegacyTreePresetOptions() {
-  return LEGACY_TREE_PRESETS.map(({ id, label, metadata }) => ({
-    id,
-    label,
-    metadata: { ...metadata },
-  }));
-}
-
-/**
- * Creates one tree from the supported pre-species set.
- *
- * Overrides remain the ordinary StylizedTree contract, including `leafShape`,
- * `trunkMap`, `foliage.leafMap`, and `vegetationShader`. Nested generator and
- * material groups merge over the selected recipe instead of replacing it.
- */
-export function createLegacyTree(id, overrides = {}) {
-  const preset = getLegacyTreePreset(id);
-  if (!preset) throw new Error(`Unknown legacy tree preset "${String(id)}".`);
-  const base = clone(preset.options);
-  const source = overrides && typeof overrides === 'object' && !Array.isArray(overrides)
-    ? overrides
-    : {};
-  const tree = new StylizedTree({
-    ...base,
-    ...source,
-    canopy: { ...(base.canopy ?? {}), ...(source.canopy ?? {}) },
-    foliage: { ...(base.foliage ?? {}), ...(source.foliage ?? {}) },
-    skeleton: { ...(base.skeleton ?? {}), ...(source.skeleton ?? {}) },
-    tree: {
-      ...(base.tree ?? {}),
-      ...(source.tree ?? {}),
-      trunkReceiveShadow: source.tree?.trunkReceiveShadow ?? true,
-    },
-    trunk: { ...(base.trunk ?? {}), ...(source.trunk ?? {}) },
-  });
-  tree.name = `LegacyTree:${preset.id}`;
-  tree.userData.legacyTree = {
-    id: preset.id,
-    label: preset.label,
-    recipeVersion: preset.version,
-  };
-  return tree;
-}

package/types/vegetation/legacyTreePresets.d.ts

@@ -1,22 +0,0 @@
-/** Returns one immutable legacy recipe document, or null. */
-export function getLegacyTreePreset(id: any): any;
-/** Lists the stable legacy IDs and labels without duplicating recipe data. */
-export function getLegacyTreePresetOptions(): any;
-/**
- * Creates one tree from the supported pre-species set.
- *
- * Overrides remain the ordinary StylizedTree contract, including `leafShape`,
- * `trunkMap`, `foliage.leafMap`, and `vegetationShader`. Nested generator and
- * material groups merge over the selected recipe instead of replacing it.
- */
-export function createLegacyTree(id: any, overrides?: {}): StylizedTree;
-/**
- * The twelve pre-species ToonLab trees, now named and versioned explicitly.
- *
- * This is the supported legacy set that existed before the repository's
- * botanical species research. It contains only generic stylized silhouettes;
- * none of the documents claims a botanical species identity.
- */
-export const LEGACY_TREE_PRESETS: any;
-export const LEGACY_TREE_IDS: any;
-import { StylizedTree } from './stylizedTree.js';