@adatechnology/game-shapes 0.1.0 → 0.2.1

package/README.md

@@ -140,6 +140,11 @@ A `lod` rule `{ distance, detail, minSize?, minSegments? }` regenerates the tree
 static body. Instance a node when the same geometry repeats tens of times or is placed at run time; merge when copies are few or coloured per
 vertex.
 
+## Generators by instance
+
+`createShapes({ packs, patch, remove })` makes a set of generators of its own. `packs` is a list of objects `{ [name]: ShapeGenerator }` (`[{ 'my.stones': stones }]`); later packs replace earlier ones with the same name.
+`patch` replaces a generator by name, `remove` lists names to take out. `shapes.generate` looks custom nodes up in that set only. For a pool use `createShapePool({ generators: shapes.record(), isolatedGenerators: true })`: its jobs then run in the calling thread and never see the global registry.
+
 ## Português
 
 Gerador único de 3D do kit: forma em JSON vira buffers por material, puro, por semente, pronto para worker e cache. Os geradores são portes linha a

package/dist/{chunk-R4RY23RH.js → chunk-M5N2SHNL.js}

@@ -1431,8 +1431,8 @@ function mesh(p) {
     groups: []
   };
 }
-function make(kind, p) {
-  switch (kind) {
+function make(p) {
+  switch (p.kind) {
     case "box": {
       const size = p.size ?? [1, 1, 1];
       const segments = p.segments ?? [1, 1, 1];
@@ -1461,7 +1461,7 @@ function make(kind, p) {
     case "mesh":
       return mesh(p);
     default:
-      throw new Error(`game-shapes: unknown primitive kind "${String(kind)}"`);
+      throw new Error(`game-shapes: unknown primitive kind "${String(p.kind)}"`);
   }
 }
 var templates = /* @__PURE__ */ new Map();
@@ -1479,7 +1479,7 @@ function clearTemplateCache() {
 var templateCacheStats = () => ({ size: templates.size, ...stats });
 function buildPrimitive(node, options = {}) {
   const parameters = primitiveParameters(node, options);
-  if (node.kind === "mesh" || templateLimit === 0) return make(node.kind, parameters);
+  if (node.kind === "mesh" || templateLimit === 0) return make({ ...node, ...parameters });
   const key = `${node.kind}:${canonicalJson(parameters)}`;
   const cached = templates.get(key);
   if (cached) {
@@ -1489,7 +1489,7 @@ function buildPrimitive(node, options = {}) {
     return cached;
   }
   stats.misses++;
-  const built = make(node.kind, parameters);
+  const built = make({ ...node, ...parameters });
   templates.set(key, built);
   if (templates.size > templateLimit) templates.delete(templates.keys().next().value);
   return built;
@@ -1520,14 +1520,23 @@ function mulberry32(seed) {
 var streamFor = (seed, generator, path) => mulberry32(parseInt(hash64(`${String(seed)}\0${generator}\0${path}`).slice(0, 8), 16));
 
 // src/registry.ts
-var generators = /* @__PURE__ */ new Map();
-function registerGenerator(name, generator) {
-  if (!/^[a-zA-Z][\w.:-]*$/.test(name)) throw new Error(`game-shapes: generator name "${name}" must start with a letter and use letters, digits, ".", ":", "-" or "_"`);
-  generators.set(name, generator);
-}
-var unregisterGenerator = (name) => generators.delete(name);
-var getGenerator = (name) => generators.get(name);
-var listGenerators = () => [...generators.keys()].sort();
+var GENERATOR_NAME = /^[a-zA-Z][\w.:-]*$/;
+var generatorsOver = (generators) => ({
+  register(name, generator) {
+    if (!GENERATOR_NAME.test(name)) throw new Error(`game-shapes: generator name "${name}" must start with a letter and use letters, digits, ".", ":", "-" or "_"`);
+    generators.set(name, generator);
+  },
+  unregister: (name) => generators.delete(name),
+  get: (name) => generators.get(name),
+  list: () => [...generators.keys()].sort(),
+  record: () => Object.fromEntries(generators)
+});
+var defaultGenerators;
+var defaultShapeGenerators = () => defaultGenerators ?? (defaultGenerators = generatorsOver(/* @__PURE__ */ new Map()));
+var registerGenerator = (name, generator) => defaultShapeGenerators().register(name, generator);
+var unregisterGenerator = (name) => defaultShapeGenerators().unregister(name);
+var getGenerator = (name) => defaultShapeGenerators().get(name);
+var listGenerators = () => defaultShapeGenerators().list();
 
 // schema/shape.schema.json
 var shape_schema_default = {
@@ -2573,7 +2582,7 @@ var radiusOf = (t, world) => {
   return r * Math.max(sx, sy, sz);
 };
 function expandCustom(node, settings, detail, path) {
-  const generator = settings.generators?.[node.generator] ?? getGenerator(node.generator);
+  const generator = settings.generators?.[node.generator] ?? (settings.isolatedGenerators ? void 0 : getGenerator(node.generator));
   if (!generator) throw new Error(`game-shapes: no generator "${node.generator}" (register it with registerGenerator, in the worker too) at ${path}`);
   const generated = generator(node.params, { random: streamFor(settings.seed, node.generator, path), seed: settings.seed, detail, path });
   const { kind: _kind, generator: _generator, params: _params, ...common } = node;
@@ -2781,6 +2790,7 @@ function generate(schema, options = {}) {
     ...options.materialAlias ? { alias: options.materialAlias } : {},
     seed: options.seed ?? 0,
     ...options.generators ? { generators: options.generators } : {},
+    ...options.isolatedGenerators ? { isolatedGenerators: true } : {},
     ...options.instancing ? { autoMin: Math.max(2, options.instancing.minCount) } : {}
   };
   const specs = [{ distance: 0, detail: 1, index: 0 }, ...(schema.lod ?? []).map((rule, index) => ({ ...rule, index: index + 1 }))];
@@ -2952,6 +2962,8 @@ export {
   clonePrimitive,
   mulberry32,
   streamFor,
+  generatorsOver,
+  defaultShapeGenerators,
   registerGenerator,
   unregisterGenerator,
   getGenerator,
@@ -2969,4 +2981,4 @@ export {
   byteSizeOf,
   installShapeWorker
 };
-//# sourceMappingURL=chunk-R4RY23RH.js.map
+//# sourceMappingURL=chunk-M5N2SHNL.js.map