@call-me-sensei/toonlab 0.3.0 → 0.3.1

package/README.md

@@ -80,8 +80,7 @@ Labs home (`/`) presents them by the artifact they author:
 Supporting editors remain available by direct URL: Weather Lab
 (`/weather-lab/`) coordinates current atmosphere, wind, precipitation,
 lightning, and surface state; Lighting Lab (`/lighting-lab/`) authors light
-rigs and budgets; Prop Lab (`/prop-lab/`) and Building Lab
-(`/building-lab/`) expose the broader procedural library; Gallery
+rigs and budgets; Gallery
 (`/gallery/`) searches supported open-asset sources. The procedural Catalog
 is exposed through `@call-me-sensei/toonlab/catalog`. See
 [Lab responsibilities](docs/lab-architecture.md) for the scope rules and
@@ -121,12 +120,10 @@ Point any model-aware lab at your own model with the Model URL input or
 | Water | `@call-me-sensei/toonlab/water` | Fully procedural integrated water system: Gerstner wave stack with a calm→storm dial, wave sets, plunging breakers you can surf, three-stop absorption color, refraction/caustics/foam, GPU ripple sim, splashes, wakes, rain, kelp, underwater view, construction-time quality, and a CPU mirror of the whole spectrum for buoyancy. [Docs](docs/water.md) |
 | Vegetation | `@call-me-sensei/toonlab/vegetation` | Instanced grass and flower fields, procedural trees/flowers with serializable recipes, coordinated grass palettes (base, tip, and shadow tint), and one semantic-role `VegetationShaderProfile` shared across grass, foliage, flowers, bark, and stems. Asset identity and current wind/weather remain separate. [Docs](docs/vegetation-sky.md) |
 | Paths, roads & bridges | `@call-me-sensei/toonlab/pathgen` | Seeded path networks routed over any `heightAt`: cost-field router (slope/water aware), hand-drawn ribbon overlay in dirt/stone/planks, arched plank bridges with collision, stepped stone climbs, flattened `paths.heightAt` for walkability, scatter exclusion mask, minimap overlay. |
-| Props & placement | `@call-me-sensei/toonlab/propgen` | The universal placement pipeline (the PropAsset contract: grounded, collided, instanced, hi/lo LOD by true 3D distance) + 12 seeded prop generators across fences, lanterns, signposts, stairs, milestones, wells, crates, firewood, torii, piers, stone walls, benches. `propAssetFromObject` drops any imported GLB into the same pipeline. |
-| Buildings | `@call-me-sensei/toonlab/buildinggen` | Shape-grammar stylized exteriors (cottage/shed/farmhouse/watchtower/shrine): seeded recipes, timber facades with windows that never intersect beams, always-overhanging roofs (gable/hip/shed/pagoda-ish), buried foundation skirts for slopes, ≤ 6 draw calls per building, grammar invariants asserted across 1000 seeds. |
-| Villages & POIs | `@call-me-sensei/toonlab/villagegen` | Seeded settlements composed from paths + props + buildings: site scoring, main-street layout with parcels facing the street, archetypes as data (village, fishing hamlet, shrine, campsite, ruin), seeded place names, world `pois` option that roads everything together. |
+| Asset placement | `@call-me-sensei/toonlab/propgen` | The universal placement pipeline (the PropAsset contract: grounded, collided, instanced, hi/lo LOD by true 3D distance). `propAssetFromObject` drops any imported GLB — e.g. a CC0 model found through MCP — into the pipeline. |
 | Fauna | `@call-me-sensei/toonlab/fauna` | Instanced GPU-animated ambient creatures: flocking birds that perch and flush, butterflies over flower masks, hovering dragonflies, schooling koi — staggered boids, hard population budgets, ≤ 1 ms CPU at defaults. |
 | Ambient VFX | `@call-me-sensei/toonlab/ambientfx` | One GPU particle backbone, five effects: falling petals and leaves, dusk fireflies, backlit pollen, shoreline mist — follow-window emission, shared wind with grass, time-of-day gates, 3 draw calls total. |
-| Asset catalog | `@call-me-sensei/toonlab/catalog` | Every recipe/preset as a searchable manifest with one headline call: `catalog.spawn(id, { seed })` → a placeable PropAsset for props, buildings, trees, rocks, and debris. `catalog.addSource(url)` mounts remote registries. |
+| Asset catalog | `@call-me-sensei/toonlab/catalog` | Every recipe/preset as a searchable manifest with one headline call: `catalog.spawn(id, { seed })` → a placeable PropAsset for trees, rocks, and debris. `catalog.addSource(url)` mounts remote registries. |
 | Sky | `@call-me-sensei/toonlab/sky` | Integrated gradient/sun/painterly-cloud/star system with exactly 46 portable art fields, named live scene layers, compile-time quality tiers/custom 1–5 cloud octaves, meaningful built-in looks, and water-reflection compatibility. [Docs](docs/sky.md) |
 | Post-processing | `@call-me-sensei/toonlab/post` | Optional single-pipeline compositor: character-aware bloom, color grade, LUT, vignette, screen outline, depth cue — schema-driven, preset-serializable. [Docs](docs/post-processing.md) |
 | Camera | `@call-me-sensei/toonlab/camera` | Extensible camera operator stack, generated recipe/preset documents, follow/framing/collision/damping/noise/impulse behavior, and a director for blending reusable rigs. [Style domain docs](docs/style-labs.md#camera) |
@@ -356,9 +353,9 @@ from spawn to the shoreline and swim.
 
 ```text
 Use the ToonLab MCP server to find CC0 props for a small fishing village —
-lanterns, crates, a pier — then place them with the propgen placement
-pipeline so they are grounded, collided, and LOD'd. Add a torii gate near
-the spawn using catalog.spawn.
+lanterns, crates, a pier, a torii gate — then place every import with
+propAssetFromObject so they are grounded, collided, and LOD'd. Tell me what
+came from where with licenses.
 ```
 
 ```text

package/docs/main.jsx

@@ -88,8 +88,8 @@ function Overview() {
             <code>@call-me-sensei/toonlab</code>
           </a>
           : toon and environment shading, water, sky, weather, vegetation, lighting, post, camera,
-          game feel, and seeded generators for rocks, props, buildings, paths, and villages.
-          MIT-licensed, WebGPU-first with a WebGL2 fallback, zero bundled textures.
+          game feel, and procedural rocks, paths, and textures. MIT-licensed, WebGPU-first with a
+          WebGL2 fallback, zero bundled textures.
         </li>
         <li>
           <strong>The labs</strong> — visual editors served by <code>npm run dev</code> (or hosted
@@ -210,10 +210,10 @@ import { propAssetFromObject } from '@call-me-sensei/toonlab/propgen';
 
 // Procedural catalog: every recipe/preset as a searchable manifest.
 const catalog = createCatalog();
-const lantern = catalog.spawn('prop/lantern/stone-toro', { seed: 7 }); // grounded, collided, LOD'd
+const tree = catalog.spawn('tree/broadleaf/sensei', { seed: 7 }); // grounded, collided, LOD'd
 
-// Any imported GLB (e.g. a CC0 model imported through the local MCP server)
-// joins the same placement pipeline:
+// Imported models (e.g. a CC0 model imported through the local MCP server)
+// join the same placement pipeline — grounded, collided, instanced, LOD'd:
 const shrine = propAssetFromObject(importedGltf.scene);`;
 
 const TEXGEN_SNIPPET = `import {
@@ -300,7 +300,7 @@ function Library() {
             <tr><td>/lighting</td><td>Versioned light recipes, budgets, runtime realization, and a data-only UE5 handoff.</td></tr>
             <tr><td>/post, /camera, /game-feel</td><td>Compositor pipeline, camera operator stack + director, and hit-stop/punch/flash game feel.</td></tr>
             <tr><td>/texgen</td><td>Seamless CPU-baked PBR texture generator with 60+ presets and a natural-language recipe mapper.</td></tr>
-            <tr><td>/rockgen, /propgen, /buildinggen, /pathgen, /villagegen</td><td>Seeded generators for rocks, 12 prop families, building exteriors, road networks, and settlements.</td></tr>
+            <tr><td>/rockgen, /pathgen</td><td>Seeded rock generation and road/bridge networks routed over any terrain.</td></tr>
             <tr><td>/vfxgen, /ambientfx, /fauna</td><td>Gameplay VFX (trails, impacts, weapons), ambient particles (petals, fireflies), and GPU-animated creatures.</td></tr>
             <tr><td>/catalog, /loaders, /debug</td><td>Searchable asset manifest with <code>catalog.spawn</code>, model loaders (GLB/VRM/PMX/FBX), and the schema-driven tuning panel.</td></tr>
           </tbody>
@@ -505,8 +505,8 @@ and swim.`}
         title="CC0 import via the local server"
         prompt={`Use the toonlab-local MCP server to furnish the fishing village: search
 CC0 sources for lanterns, crates, barrels, and a pier (search_cc0_assets),
-import the best fits with import_cc0_asset, and place them with the propgen
-placement pipeline so they are grounded, collided, and LOD'd. Show me what
+import the best fits with import_cc0_asset, and place every import with
+propAssetFromObject so they are grounded, collided, and LOD'd. Show me what
 came from where with attribution.`}
         note="import_cc0_asset writes the files and an attribution manifest into .toonlab/imports for direct use by the project."
       />
@@ -519,9 +519,10 @@ path should flatten heightAt and register collision.`}
       />
       <PromptBlock
         title="Seeded recipes from the catalog"
-        prompt={`With the toonlab-local MCP server, generate three lantern recipe variations
-(generate_asset from the catalog entry, different seeds), save them as
-creations, and spawn them along the pier so I can compare them in the game.`}
+        prompt={`With the toonlab-local MCP server, generate three broadleaf tree recipe
+variations (generate_asset from the catalog entry, different seeds), save
+them as creations, and spawn them along the shore so I can compare them in
+the game.`}
       />
 
       <h2>Textures and style</h2>
@@ -606,11 +607,23 @@ function slugify(text) {
     .replace(/\s+/g, '-');
 }
 
+// Systems intentionally undocumented until their output meets the quality bar.
+const HIDDEN_REFERENCE_SECTIONS = ['Buildings'];
+
+function stripHiddenSections(markdown) {
+  for (const title of HIDDEN_REFERENCE_SECTIONS) {
+    markdown = markdown
+      .replace(new RegExp(`\\n## ${title}\\n[\\s\\S]*?(?=\\n## |$)`), '\n')
+      .replace(new RegExp(`- \\[${title}\\]\\(#[\\w-]+\\)\\n`), '');
+  }
+  return markdown;
+}
+
 let referenceHtmlCache = null;
 
 function referenceHtml() {
   if (referenceHtmlCache) return referenceHtmlCache;
-  let html = marked.parse(settingsReferenceRaw, { async: false });
+  let html = marked.parse(stripHiddenSections(settingsReferenceRaw), { async: false });
   html = html.replace(
     /<h([123])>([^<]+)<\/h\1>/g,
     (_m, level, text) => `<h${level} id="${slugify(text)}">${text}</h${level}>`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@call-me-sensei/toonlab",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Stylized (anime/toon) game starter kit for Three.js: character and environment shading, lighting, weather, water, vegetation, sky, and post-processing",
   "license": "MIT",
   "author": "Hyperbond Studio PTE. LTD. (Call Me Sensei)",