@call-me-sensei/toonlab 0.3.1 → 0.4.20

package/src/catalog/catalog.js

@@ -1,210 +0,0 @@
-// The asset catalog runtime — the Megascans moment, minus the download.
-// One searchable registry of every ToonLab recipe/preset, and ONE function
-// that turns any asset entry into a placeable PropAsset:
-//
-//   import { catalog } from '@call-me-sensei/toonlab/catalog';
-//   catalog.list({ tags: ['prop'] });
-//   const asset = catalog.spawn('prop/lantern/stone-toro', { seed: 7 });
-//   placeAlongSpline({ asset, spline: world.paths.splines[0], ... });
-//
-// OSS ships the full built-in registry + local user entries;
-// `catalog.addSource(url, { headers })` mounts remote registries (the pro
-// cloud library and its generated imports use exactly this seam — the catalog never
-// knows they exist).
-
-import * as THREE from 'three';
-
-import { validateCatalogEntry } from './manifest.js';
-import { builtinCatalogEntries } from './builtinEntries.js';
-import { createPropAssetFromRecipe, propAssetFromObject } from '../propgen/index.js';
-import { buildingAsset } from '../buildinggen/buildingAsset.js';
-import { createPlantFromRecipe } from '../vegetation/treeRecipe.js';
-import { createRockDocument } from '../rockgen/rockDocument.js';
-import { meshDocument } from '../rockgen/index.js';
-import { createDebrisAsset } from '../debrisgen/debrisGenerator.js';
-import { createStylizedPathsFromRecipe } from '../pathgen/stylizedPaths.js';
-
-// Per-cluster spawners: entry (+ seed override) → PropAsset. Clusters whose
-// presets are settings documents rather than placeable things (water, sky,
-// post, toon) intentionally have no spawner — spawn() explains instead of
-// guessing.
-const SPAWNERS = {
-  buildinggen(entry, { seed }) {
-    const recipe = entry.recipe;
-    return buildingAsset(seed === undefined
-      ? recipe
-      : { ...recipe, options: { ...recipe.options, seed } });
-  },
-  debrisgen(entry, { seed }) {
-    const settings = entry.recipe.settings;
-    const spawnSettings = seed === undefined
-      ? settings
-      : { ...settings, asset: { ...settings.asset, seed } };
-    return {
-      build(buildSeed = spawnSettings.asset.seed) {
-        const root = createDebrisAsset({
-          ...spawnSettings,
-          asset: { ...spawnSettings.asset, seed: buildSeed },
-        });
-        const asset = propAssetFromObject(root, {
-          footprint: {
-            radius: Math.max((spawnSettings.asset.spread || 0.6) * spawnSettings.asset.scale, 0.4),
-          },
-        });
-        return asset.build();
-      },
-      linear: false,
-      type: 'debris',
-      variant: spawnSettings.asset.variant,
-    };
-  },
-  propgen(entry, { seed }) {
-    const recipe = entry.recipe;
-    const spawnRecipe = seed === undefined
-      ? recipe
-      : {
-        ...recipe,
-        settings: {
-          ...recipe.settings,
-          asset: { ...recipe.settings.asset, seed },
-        },
-      };
-    return createPropAssetFromRecipe(spawnRecipe);
-  },
-  rockgen(entry, { seed = 4, resolution = 44 }) {
-    const preset = entry.recipe.preset;
-    return {
-      build(buildSeed = seed) {
-        const geometry = meshDocument(
-          createRockDocument({ preset, seed: buildSeed }),
-          { resolution },
-        );
-        const material = new THREE.MeshStandardMaterial({ vertexColors: true });
-        material.userData.envRole = 'standard';
-        const mesh = new THREE.Mesh(geometry, material);
-        mesh.castShadow = true;
-        mesh.receiveShadow = true;
-        const asset = propAssetFromObject(mesh);
-        return asset.build();
-      },
-      linear: false,
-      type: 'rock',
-      variant: preset,
-    };
-  },
-  vegetation(entry, { seed }) {
-    const recipe = entry.recipe;
-    return {
-      build(buildSeed = seed ?? recipe.options?.seed ?? 1) {
-        const plant = createPlantFromRecipe({
-          ...recipe,
-          options: { ...recipe.options, seed: buildSeed },
-        });
-        const size = Number(recipe.options?.size) || 1.7;
-        return propAssetFromObject(plant, {
-          // trunk-scale blocker, not canopy-scale — characters walk under crowns
-          anchor: 0,
-          footprint: { radius: Math.max(0.13 * size, 0.2) },
-        }).build();
-      },
-      linear: false,
-      type: recipe.type ?? 'tree',
-      variant: recipe.type ?? 'tree',
-    };
-  },
-};
-
-function createRegistry() {
-  const entries = new Map();
-  const sources = [];
-
-  const register = (entry, { source = 'user' } = {}) => {
-    const { ok, errors } = validateCatalogEntry(entry);
-    if (!ok) throw new Error(`catalog.register: ${errors.join(' ')}`);
-    entries.set(entry.id, { ...entry, source });
-    return entry.id;
-  };
-
-  for (const entry of builtinCatalogEntries()) register(entry, { source: 'builtin' });
-
-  return {
-    /**
-     * Mounts a remote registry: fetches `{ entries: [...] }` JSON and
-     * registers every valid entry (thumbnails resolved against the source
-     * URL). This is the whole pro seam — auth is just headers.
-     */
-    async addSource(url, { headers = {}, name = url } = {}) {
-      const response = await fetch(url, { headers });
-      if (!response.ok) throw new Error(`catalog.addSource: ${response.status} for ${url}`);
-      const manifest = await response.json();
-      const base = new URL(url, globalThis.location?.href ?? 'http://localhost/');
-      let added = 0;
-      for (const entry of manifest.entries ?? []) {
-        try {
-          const resolved = entry.thumbnail
-            ? { ...entry, thumbnail: new URL(entry.thumbnail, base).href }
-            : entry;
-          register(resolved, { source: name });
-          added += 1;
-        } catch {
-          // skip invalid remote entries; a bad source must not break the lab
-        }
-      }
-      sources.push({ count: added, name, url });
-      return added;
-    },
-    entries,
-    get(id) {
-      return entries.get(id) ?? null;
-    },
-    /** Filter by tags (every tag must match), cluster, kind, or free text. */
-    list({ tags = null, cluster = null, kind = null, text = null } = {}) {
-      const query = text ? String(text).toLowerCase() : null;
-      const wanted = Array.isArray(tags) ? tags.map((tag) => tag.toLowerCase()) : null;
-      const results = [];
-      for (const entry of entries.values()) {
-        if (cluster && entry.cluster !== cluster) continue;
-        if (kind && entry.kind !== kind) continue;
-        if (wanted && !wanted.every((tag) => entry.tags.includes(tag))) continue;
-        if (query) {
-          const haystack = `${entry.id} ${entry.label} ${entry.description ?? ''} ${entry.tags.join(' ')}`.toLowerCase();
-          if (!haystack.includes(query)) continue;
-        }
-        results.push(entry);
-      }
-      return results.sort((a, b) => a.id.localeCompare(b.id));
-    },
-    register,
-    sources,
-    /**
-     * The download button: any asset entry id → a PropAsset ready for
-     * placeProps / scatterProps / placeAlongSpline. Settings-preset entries
-     * (water, sky, post, toon, path networks) aren't placeable objects —
-     * spawn throws with their copy-paste snippet instead.
-     */
-    spawn(id, options = {}) {
-      const entry = entries.get(id);
-      if (!entry) throw new Error(`catalog.spawn: unknown entry "${id}".`);
-      const spawner = SPAWNERS[entry.cluster];
-      if (!spawner) {
-        throw new Error(
-          `catalog.spawn: "${id}" is a ${entry.cluster} settings preset, not a placeable asset. Use its snippet instead:\n  ${entry.spawn}`,
-        );
-      }
-      return spawner(entry, options);
-    },
-    unregister(id) {
-      return entries.delete(id);
-    },
-  };
-}
-
-/** The shared default registry (labs and docs use this instance). */
-export const catalog = createRegistry();
-
-/** Fresh isolated registry (tests, embedded hosts). */
-export function createCatalog() {
-  return createRegistry();
-}
-
-export { createStylizedPathsFromRecipe };

package/src/catalog/index.js

@@ -1,3 +0,0 @@
-export * from './manifest.js';
-export * from './builtinEntries.js';
-export { catalog, createCatalog } from './catalog.js';

package/src/core/shaderBackend.js

@@ -1,24 +0,0 @@
-// Active shader backend for the material factories in src/.
-//
-// 'tsl'  — WebGPURenderer (WebGPU or forced-WebGL2 backend) + NodeMaterial.
-//
-// The renderer factory sets this at boot, BEFORE any material factory runs.
-// TSL is also the module default so setup utilities that create materials
-// before renderer construction still land on the supported path.
-
-let activeShaderBackend = 'tsl';
-
-export function setActiveShaderBackend(backend) {
-  if (backend !== 'tsl') {
-    console.warn(`Unsupported shader backend "${backend}"; using TSL.`);
-  }
-  activeShaderBackend = 'tsl';
-}
-
-export function getActiveShaderBackend() {
-  return activeShaderBackend;
-}
-
-export function isTslBackend() {
-  return true;
-}