cyberia 3.1.3 → 3.2.5

package/src/server/semantic-layer-generator-floor.js

@@ -0,0 +1,359 @@
+/**
+ * Floor semantic descriptors for the Semantic Layer Generator.
+ *
+ * Provides procedural generation recipes for all floor-type object layers:
+ * desert, grass, water, stone, and lava.  Imported by the main
+ * semantic-layer-generator.js which registers them at startup.
+ *
+ * @module src/server/semantic-layer-generator-floor.js
+ * @namespace SemanticLayerGeneratorFloor
+ */
+
+/* ═══════════════════════════════════════════════════════════════════════════
+ *  FLOOR SEMANTIC REGISTRY
+ *  Call registerFloorSemantics(registerFn) once to add all floor descriptors.
+ * ═══════════════════════════════════════════════════════════════════════════ */
+
+/**
+ * Registers all built-in floor semantic descriptors.
+ * Uses dependency injection — no import from the parent module.
+ *
+ * @param {function(string, import('./semantic-layer-generator.js').SemanticDescriptor): void} registerFn
+ * @memberof SemanticLayerGeneratorFloor
+ */
+export function registerFloorSemantics(registerFn) {
+  /* ── Desert ───────────────────────────────────────────────────────────── */
+  registerFn('floor-desert', {
+    semanticTags: ['sand', 'dune', 'arid', 'dry'],
+    paletteHints: [
+      [210, 180, 120, 255],
+      [194, 160, 100, 255],
+      [230, 205, 150, 255],
+      [180, 140, 80, 255],
+      [160, 120, 70, 255],
+      [120, 90, 55, 255],
+      [100, 80, 50, 255],
+      [240, 220, 175, 255],
+    ],
+    preferredShapes: { ellipse: 3, circle: 2, cactus: 1, star: 0.5 },
+    itemType: 'floor',
+    layers: {
+      base: {
+        generator: 'noise-field',
+        shapes: ['ellipse'],
+        count: 0,
+        scaleVariance: 0,
+        rotationVariance: 0,
+        colorShift: 8,
+        jitter: 0,
+        noiseLevel: 0.3,
+        detailLevel: 1,
+        sparsity: 0,
+        frameJitter: 0,
+        frameRotation: 0,
+        frameScale: 0,
+      },
+      dunes: {
+        generator: 'shape',
+        shapes: ['ellipse', 'circle'],
+        count: 5,
+        scaleVariance: 0.3,
+        rotationVariance: 15,
+        colorShift: 12,
+        jitter: 0.08,
+        noiseLevel: 0.15,
+        detailLevel: 1.2,
+        sparsity: 0.3,
+        frameJitter: 0.005,
+        frameRotation: 0.5,
+        frameScale: 0.005,
+      },
+      rocks: {
+        generator: 'shape',
+        shapes: ['star', 'circle'],
+        count: 3,
+        scaleVariance: 0.4,
+        rotationVariance: 45,
+        colorShift: 15,
+        jitter: 0.12,
+        noiseLevel: 0.2,
+        detailLevel: 1,
+        sparsity: 0.5,
+        frameJitter: 0.002,
+        frameRotation: 0.3,
+        frameScale: 0.003,
+      },
+      tufts: {
+        generator: 'shape',
+        shapes: ['cactus', 'star'],
+        count: 2,
+        scaleVariance: 0.25,
+        rotationVariance: 20,
+        colorShift: 10,
+        jitter: 0.1,
+        noiseLevel: 0.1,
+        detailLevel: 0.8,
+        sparsity: 0.6,
+        frameJitter: 0.008,
+        frameRotation: 1.0,
+        frameScale: 0.006,
+      },
+    },
+  });
+
+  /* ── Grass ────────────────────────────────────────────────────────────── */
+  registerFn('floor-grass', {
+    semanticTags: ['grass', 'meadow', 'green', 'earth'],
+    paletteHints: [
+      [80, 140, 60, 255],
+      [60, 120, 45, 255],
+      [110, 170, 80, 255],
+      [90, 130, 55, 255],
+      [130, 100, 65, 255],
+      [70, 110, 40, 255],
+      [150, 190, 100, 255],
+      [100, 85, 50, 255],
+    ],
+    preferredShapes: { ellipse: 3, circle: 2, heart: 0.5 },
+    itemType: 'floor',
+    layers: {
+      base: {
+        generator: 'noise-field',
+        shapes: ['circle'],
+        count: 0,
+        scaleVariance: 0,
+        rotationVariance: 0,
+        colorShift: 10,
+        jitter: 0,
+        noiseLevel: 0.25,
+        detailLevel: 1,
+        sparsity: 0,
+        frameJitter: 0,
+        frameRotation: 0,
+        frameScale: 0,
+      },
+      blades: {
+        generator: 'shape',
+        shapes: ['ellipse', 'heart'],
+        count: 6,
+        scaleVariance: 0.35,
+        rotationVariance: 40,
+        colorShift: 15,
+        jitter: 0.1,
+        noiseLevel: 0.12,
+        detailLevel: 1.0,
+        sparsity: 0.25,
+        frameJitter: 0.01,
+        frameRotation: 2.0,
+        frameScale: 0.005,
+      },
+      patches: {
+        generator: 'shape',
+        shapes: ['circle', 'ellipse'],
+        count: 3,
+        scaleVariance: 0.3,
+        rotationVariance: 30,
+        colorShift: 12,
+        jitter: 0.08,
+        noiseLevel: 0.15,
+        detailLevel: 0.9,
+        sparsity: 0.4,
+        frameJitter: 0.003,
+        frameRotation: 0.5,
+        frameScale: 0.003,
+      },
+    },
+  });
+
+  /* ── Water ────────────────────────────────────────────────────────────── */
+  registerFn('floor-water', {
+    semanticTags: ['water', 'ocean', 'wave', 'liquid'],
+    paletteHints: [
+      [40, 100, 180, 255],
+      [60, 130, 200, 255],
+      [90, 160, 220, 255],
+      [120, 190, 230, 255],
+      [30, 80, 150, 255],
+      [70, 140, 210, 255],
+      [150, 210, 240, 255],
+      [20, 60, 120, 255],
+    ],
+    preferredShapes: { ellipse: 3, circle: 2 },
+    itemType: 'floor',
+    layers: {
+      base: {
+        generator: 'noise-field',
+        shapes: ['ellipse'],
+        count: 0,
+        scaleVariance: 0,
+        rotationVariance: 0,
+        colorShift: 12,
+        jitter: 0,
+        noiseLevel: 0.35,
+        detailLevel: 1,
+        sparsity: 0,
+        frameJitter: 0,
+        frameRotation: 0,
+        frameScale: 0,
+      },
+      waves: {
+        generator: 'shape',
+        shapes: ['ellipse'],
+        count: 4,
+        scaleVariance: 0.3,
+        rotationVariance: 10,
+        colorShift: 18,
+        jitter: 0.06,
+        noiseLevel: 0.2,
+        detailLevel: 1.2,
+        sparsity: 0.2,
+        frameJitter: 0.015,
+        frameRotation: 1.5,
+        frameScale: 0.008,
+      },
+      foam: {
+        generator: 'shape',
+        shapes: ['circle'],
+        count: 3,
+        scaleVariance: 0.5,
+        rotationVariance: 0,
+        colorShift: 10,
+        jitter: 0.15,
+        noiseLevel: 0.1,
+        detailLevel: 0.7,
+        sparsity: 0.5,
+        frameJitter: 0.012,
+        frameRotation: 0.5,
+        frameScale: 0.01,
+      },
+    },
+  });
+
+  /* ── Stone ────────────────────────────────────────────────────────────── */
+  registerFn('floor-stone', {
+    semanticTags: ['stone', 'rock', 'cobble', 'grey'],
+    paletteHints: [
+      [140, 140, 145, 255],
+      [120, 118, 125, 255],
+      [165, 165, 170, 255],
+      [100, 98, 105, 255],
+      [180, 180, 185, 255],
+      [90, 85, 80, 255],
+      [155, 150, 148, 255],
+      [110, 108, 115, 255],
+    ],
+    preferredShapes: { circle: 3, ellipse: 2, star: 1, 'pixel-art': 0.5 },
+    itemType: 'floor',
+    layers: {
+      base: {
+        generator: 'noise-field',
+        shapes: ['circle'],
+        count: 0,
+        scaleVariance: 0,
+        rotationVariance: 0,
+        colorShift: 6,
+        jitter: 0,
+        noiseLevel: 0.2,
+        detailLevel: 1,
+        sparsity: 0,
+        frameJitter: 0,
+        frameRotation: 0,
+        frameScale: 0,
+      },
+      cobbles: {
+        generator: 'shape',
+        shapes: ['circle', 'ellipse', 'pixel-art'],
+        count: 6,
+        scaleVariance: 0.35,
+        rotationVariance: 90,
+        colorShift: 10,
+        jitter: 0.06,
+        noiseLevel: 0.15,
+        detailLevel: 1.0,
+        sparsity: 0.2,
+        frameJitter: 0.001,
+        frameRotation: 0.2,
+        frameScale: 0.001,
+      },
+      cracks: {
+        generator: 'shape',
+        shapes: ['star'],
+        count: 2,
+        scaleVariance: 0.5,
+        rotationVariance: 180,
+        colorShift: 20,
+        jitter: 0.1,
+        noiseLevel: 0.25,
+        detailLevel: 0.8,
+        sparsity: 0.6,
+        frameJitter: 0.0,
+        frameRotation: 0.0,
+        frameScale: 0.0,
+      },
+    },
+  });
+
+  /* ── Lava ─────────────────────────────────────────────────────────────── */
+  registerFn('floor-lava', {
+    semanticTags: ['lava', 'magma', 'fire', 'hot'],
+    paletteHints: [
+      [200, 50, 20, 255],
+      [230, 100, 30, 255],
+      [255, 180, 50, 255],
+      [160, 30, 10, 255],
+      [80, 20, 10, 255],
+      [50, 15, 8, 255],
+      [240, 140, 40, 255],
+      [120, 25, 12, 255],
+    ],
+    preferredShapes: { circle: 3, ellipse: 2, cactus: 1 },
+    itemType: 'floor',
+    layers: {
+      base: {
+        generator: 'noise-field',
+        shapes: ['circle'],
+        count: 0,
+        scaleVariance: 0,
+        rotationVariance: 0,
+        colorShift: 15,
+        jitter: 0,
+        noiseLevel: 0.4,
+        detailLevel: 1,
+        sparsity: 0,
+        frameJitter: 0,
+        frameRotation: 0,
+        frameScale: 0,
+      },
+      flow: {
+        generator: 'shape',
+        shapes: ['ellipse', 'circle'],
+        count: 5,
+        scaleVariance: 0.35,
+        rotationVariance: 25,
+        colorShift: 20,
+        jitter: 0.1,
+        noiseLevel: 0.2,
+        detailLevel: 1.1,
+        sparsity: 0.2,
+        frameJitter: 0.02,
+        frameRotation: 2.0,
+        frameScale: 0.01,
+      },
+      crust: {
+        generator: 'shape',
+        shapes: ['star', 'cactus'],
+        count: 3,
+        scaleVariance: 0.4,
+        rotationVariance: 60,
+        colorShift: 10,
+        jitter: 0.08,
+        noiseLevel: 0.15,
+        detailLevel: 0.9,
+        sparsity: 0.4,
+        frameJitter: 0.005,
+        frameRotation: 0.5,
+        frameScale: 0.004,
+      },
+    },
+  });
+}