@3driseai/3drise-core 1.0.19 → 1.0.20

package/dist/properties/tables/geometryProperties.js

@@ -0,0 +1,91 @@
+const int = (key, label, min, max, def) => ({ type: 'range', key, label, min, max, step: 1, default: def });
+const num = (key, label, min, max, step, def) => ({ type: 'range', key, label, min, max, step, default: def, digits: 2 });
+const ang = (key, label, def) => ({ type: 'range', key, label, min: 0, max: Math.PI * 2, step: 0.05, default: def, digits: 2, unit: 'rad' });
+const str = (key, label, def) => ({ type: 'text', key, label, default: def });
+const CURVE = int('curveSegments', 'Curve detail', 6, 160, 64);
+export const SHAPE_CONTROLS = {
+    heart: [CURVE],
+    star: [int('points', 'Points', 2, 12, 5), num('outer', 'Outer radius', 0.1, 0.6, 0.01, 0.5), num('inner', 'Inner radius', 0.05, 0.5, 0.01, 0.2), CURVE],
+    polygon: [int('sides', 'Sides', 3, 12, 6), CURVE],
+    gear: [int('teeth', 'Teeth', 4, 32, 12), num('outer', 'Outer', 0.2, 0.6, 0.01, 0.5), num('inner', 'Root', 0.15, 0.55, 0.01, 0.38), num('hole', 'Bore', 0.05, 0.35, 0.01, 0.16), CURVE],
+    flower: [int('petals', 'Petals', 3, 16, 6), num('outer', 'Outer', 0.2, 0.6, 0.01, 0.5), num('inner', 'Inner', 0.05, 0.5, 0.01, 0.26), num('sharp', 'Sharpness', 0.2, 3, 0.05, 0.7), CURVE],
+    spade: [CURVE],
+    club: [CURVE],
+    diamond: [CURVE],
+    droplet: [num('width', 'Width', 0.2, 0.8, 0.01, 0.5), num('taper', 'Taper', 0.4, 1.8, 0.01, 1), CURVE],
+    lightning: [num('width', 'Width', 0.3, 1, 0.01, 0.6), num('height', 'Height', 0.5, 1.4, 0.01, 1), CURVE],
+    sparkle: [int('points', 'Points', 3, 12, 4), num('outer', 'Outer', 0.2, 0.6, 0.01, 0.5), num('inner', 'Pinch', 0.02, 0.4, 0.01, 0.14), CURVE],
+    shield: [num('width', 'Width', 0.4, 1.2, 0.01, 0.8), CURVE],
+    pawPrint: [CURVE],
+    superformula: [
+        int('symmetry', 'Symmetry', 1, 20, 6), num('roundness', 'Roundness', 0.1, 2, 0.05, 0.3),
+        num('twist1', 'Twist 1', 0.1, 4, 0.05, 0.3), num('twist2', 'Twist 2', 0.1, 4, 0.05, 0.3),
+        num('stretchX', 'Stretch X', 0.3, 2, 0.05, 1), num('stretchY', 'Stretch Y', 0.3, 2, 0.05, 1),
+        int('samples', 'Resolution', 32, 512, 256), CURVE,
+    ],
+    infinity: [num('waist', 'Waist', 0.04, 0.3, 0.01, 0.14), num('thickness', 'Ribbon', 0.05, 0.25, 0.01, 0.12), int('samples', 'Resolution', 64, 512, 220), CURVE],
+    box: [int('subdivisions', 'Subdivisions', 1, 24, 1)],
+    sphere: [num('radius', 'Radius', 0.1, 2, 0.01, 0.5), int('segments', 'Segments', 3, 64, 32), int('rings', 'Rings', 2, 64, 32)],
+    cylinder: [num('radiusTop', 'Top radius', 0, 2, 0.01, 0.5), num('radiusBottom', 'Bottom radius', 0, 2, 0.01, 0.5), num('height', 'Height', 0.1, 3, 0.01, 1), int('radialSegments', 'Radial segments', 3, 64, 32)],
+    cone: [num('radius', 'Radius', 0.1, 2, 0.01, 0.5), num('height', 'Height', 0.1, 3, 0.01, 1), int('radialSegments', 'Radial segments', 3, 64, 32)],
+    torus: [num('radius', 'Radius', 0.1, 2, 0.01, 0.5), num('tube', 'Tube', 0.02, 0.6, 0.01, 0.2), int('radialSegments', 'Radial segments', 3, 64, 16), int('tubularSegments', 'Tubular segments', 3, 200, 100)],
+    capsule: [num('radius', 'Radius', 0.05, 1.5, 0.01, 0.3), num('length', 'Length', 0.1, 3, 0.01, 1), int('capSegments', 'Cap segments', 1, 16, 4), int('radialSegments', 'Radial segments', 3, 64, 8)],
+    icosahedron: [num('radius', 'Radius', 0.1, 2, 0.01, 0.5), int('detail', 'Detail', 0, 5, 0)],
+    octahedron: [num('radius', 'Radius', 0.1, 2, 0.01, 0.5), int('detail', 'Detail', 0, 5, 0)],
+    tetrahedron: [num('radius', 'Radius', 0.1, 2, 0.01, 0.5), int('detail', 'Detail', 0, 5, 0)],
+    dodecahedron: [num('radius', 'Radius', 0.1, 2, 0.01, 0.5), int('detail', 'Detail', 0, 5, 0)],
+    plane: [num('width', 'Width', 0.2, 3, 0.01, 1), num('height', 'Height', 0.2, 3, 0.01, 1), int('widthSegments', 'Width segments', 1, 64, 1), int('heightSegments', 'Height segments', 1, 64, 1)],
+    ring: [num('innerRadius', 'Inner radius', 0.05, 1.5, 0.01, 0.3), num('outerRadius', 'Outer radius', 0.1, 2, 0.01, 0.8), int('thetaSegments', 'Theta segments', 3, 64, 32), int('phiSegments', 'Phi segments', 1, 32, 8)],
+    arcPlane: [num('radius', 'Radius', 0.2, 3, 0.01, 1), num('width', 'Band width', 0.02, 1, 0.01, 0.2), ang('startAngle', 'Start angle', 0), ang('endAngle', 'End angle', Math.PI), int('segments', 'Segments', 3, 128, 32)],
+    bentPlane: [num('radius', 'Radius', 0.2, 5, 0.01, 2), num('height', 'Height', 0.1, 3, 0.01, 1), ang('arc', 'Arc', Math.PI / 2), int('widthSegments', 'Width segments', 1, 64, 32), int('heightSegments', 'Height segments', 1, 64, 1)],
+    bentPlaneInverse: [num('radius', 'Radius', 0.2, 5, 0.01, 2), num('height', 'Height', 0.1, 3, 0.01, 1), ang('arc', 'Arc', Math.PI / 2), int('widthSegments', 'Width segments', 1, 64, 32), int('heightSegments', 'Height segments', 1, 64, 1)],
+    text: [str('text', 'Text', 'Hello'), num('size', 'Size', 0.2, 3, 0.01, 1), num('height', 'Depth', 0.05, 1, 0.01, 0.2)],
+    point: [num('size', 'Size', 0.02, 0.5, 0.01, 0.1)],
+    custom: [],
+};
+export const ALL_SHAPES = Object.keys(SHAPE_CONTROLS);
+export function defaultShapeOptions(type = 'heart') {
+    const opts = { type };
+    for (const c of SHAPE_CONTROLS[type])
+        opts[c.key] = c.default;
+    return opts;
+}
+export function defaultShapeConfig(type = 'heart') {
+    return defaultShapeOptions(type);
+}
+export function defaultModeConfig(mode = 'solid') {
+    return { mode, count: 1000, symmetry: 6, spacing: 1, slices: 24, linkRadius: 0.18, angle: 18, lineWidth: 2.5 };
+}
+const cnt = { type: 'range', key: 'count', label: 'Count', min: 1000, max: 40000, step: 500, default: 1000, format: (v) => v.toLocaleString() };
+const lw = { type: 'range', key: 'lineWidth', label: 'Line weight', min: 0.5, max: 8, step: 0.1, default: 2.5, digits: 1 };
+export const MODE_CONTROLS = {
+    solid: [],
+    volume: [cnt],
+    surface: [cnt],
+    symmetric: [cnt, int('symmetry', 'Symmetry', 2, 16, 6)],
+    evenScatter: [cnt, num('spacing', 'Spacing', 0.5, 3, 0.05, 1)],
+    vertices: [],
+    edges3d: [int('angle', 'Edge angle', 0, 80, 18), lw],
+    profile2d: [lw],
+    wireframe: [lw],
+    contourSlices: [int('slices', 'Slices', 4, 60, 24), lw],
+    plexus: [cnt, num('linkRadius', 'Link radius', 0.05, 0.5, 0.01, 0.18), lw],
+};
+export const MODE_GROUPS = [
+    { label: 'mesh', modes: ['solid'] },
+    { label: 'points', modes: ['volume', 'surface', 'symmetric', 'evenScatter', 'vertices'] },
+    { label: 'lines', modes: ['edges3d', 'profile2d', 'wireframe', 'contourSlices', 'plexus'] },
+];
+export const MODE_LABEL = {
+    solid: 'Solid',
+    volume: 'Volume',
+    surface: 'Surface',
+    symmetric: 'Symmetric',
+    evenScatter: 'Even',
+    vertices: 'Vertices',
+    edges3d: 'Edges',
+    profile2d: 'Profile',
+    wireframe: 'Wireframe',
+    contourSlices: 'Contours',
+    plexus: 'Plexus',
+};

package/dist/properties/tables/getPropertyConfig.d.ts

@@ -0,0 +1,3 @@
+/** Property rows for a generative effect / particles type or an environment element. */
+export declare const getPropertyConfig: (type: string) => import("./optionalProperties").OptionalProperty[];
+//# sourceMappingURL=getPropertyConfig.d.ts.map

package/dist/properties/tables/getPropertyConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPropertyConfig.d.ts","sourceRoot":"","sources":["../../../src/properties/tables/getPropertyConfig.ts"],"names":[],"mappings":"AAWA,wFAAwF;AACxF,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,sDAK7C,CAAC"}

package/dist/properties/tables/getPropertyConfig.js

@@ -0,0 +1,16 @@
+// Moved from client (client/app/utils/getPropertyConfig.ts).
+import { EFFECT_PROPERTIES } from './effectsProperties.js';
+import { PARTICLES_PROPERTIES } from './particlesProperties.js';
+import { environmentOptionalProperties } from './optionalProperties.js';
+const allProperties = {
+    ...EFFECT_PROPERTIES,
+    ...PARTICLES_PROPERTIES,
+    ...environmentOptionalProperties,
+};
+/** Property rows for a generative effect / particles type or an environment element. */
+export const getPropertyConfig = (type) => {
+    if (type in allProperties) {
+        return allProperties[type];
+    }
+    return undefined;
+};

package/dist/properties/tables/gridProperties.d.ts

@@ -0,0 +1,6 @@
+import type { OptionalProperty } from './optionalProperties';
+/** Knobs every shader-plane grid shares. */
+export declare const GRID_SURFACE_PROPERTIES: OptionalProperty[];
+/** Every shader-plane grid's inputs: its own knobs first, then the shared surface. */
+export declare const GRID_PROPERTIES: Record<string, OptionalProperty[]>;
+//# sourceMappingURL=gridProperties.d.ts.map

package/dist/properties/tables/gridProperties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridProperties.d.ts","sourceRoot":"","sources":["../../../src/properties/tables/gridProperties.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAiB7D,4CAA4C;AAC5C,eAAO,MAAM,uBAAuB,EAAE,gBAAgB,EAwBrD,CAAC;AAmFF,sFAAsF;AACtF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAE9D,CAAC"}

package/dist/properties/tables/gridProperties.js

@@ -0,0 +1,121 @@
+// =============================================================================
+// GRID OPTIONAL PROPERTIES
+// The configurable inputs of each shader-plane grid (createdObject type 'grid'),
+// keyed by config.type. Every grid shares the surface vocabulary below; each adds
+// its own knobs. Rendered by ConfigControllerUi, so a grid slider looks and behaves
+// like every other slider in the app.
+//
+// Each entry must be a real config key of that grid (viewer types/gridConfigs.ts).
+// =============================================================================
+const LINE_MODES = ['0', '1', '2', '3', '4'];
+const LINE_MODE_LABELS = ['Static', 'Ripple', 'Flow', 'Scan', 'Pulse'];
+const CELL_MODES = ['0', '1', '2', '3', '4'];
+const CELL_MODE_LABELS = ['Off', 'Wave', 'Twinkle', 'Ripple', 'Alternate'];
+/** Knobs every shader-plane grid shares. */
+export const GRID_SURFACE_PROPERTIES = [
+    { name: 'cellSize', description: 'Size of one tile, in world units', type: 'number', min: 0.1, max: 40, step: 0.1 },
+    { name: 'lineWidth', description: 'Line thickness, in pixels', type: 'number', min: 0, max: 6, step: 0.05 },
+    { name: 'sectionSize', description: 'How many tiles make one accent group', type: 'number', min: 0, max: 20, step: 1 },
+    { name: 'sectionWidth', description: 'Accent line thickness, in pixels; 0 hides the accents', type: 'number', min: 0, max: 6, step: 0.05 },
+    { name: 'lineMode', description: 'How the lines animate', type: 'select', options: LINE_MODES, optionLabels: LINE_MODE_LABELS },
+    { name: 'cellMode', description: 'How the cells light up', type: 'select', options: CELL_MODES, optionLabels: CELL_MODE_LABELS },
+    { name: 'animSpeed', description: 'Animation speed', type: 'number', min: 0, max: 5, step: 0.05 },
+    { name: 'animScale', description: 'Spatial scale of the animation', type: 'number', min: 0, max: 3, step: 0.05 },
+    { name: 'animIntensity', description: 'Strength of the animation', type: 'number', min: 0, max: 3, step: 0.05 },
+    { name: 'fadeDistance', description: 'Radius at which the grid fades out', type: 'number', min: 1, max: 200, step: 0.5 },
+    { name: 'fadeStrength', description: 'How hard the edge fades', type: 'number', min: 0, max: 1, step: 0.01 },
+    { name: 'displace', description: 'Lift the surface along its normal (subdivides the plane)', type: 'number', min: 0, max: 5, step: 0.05 },
+    { name: 'size', description: 'Size of the plane, per side', type: 'number', min: 5, max: 400, step: 1 },
+    { name: 'lineColor', description: 'Line colour', type: 'color' },
+    { name: 'sectionColor', description: 'Accent colour', type: 'color' },
+    { name: 'cellColor', description: 'Cell fill colour', type: 'color' },
+    { name: 'glowColor', description: 'Glow colour of the animated highlights', type: 'color' },
+    { name: 'bgColor', description: 'Background colour', type: 'color' },
+    { name: 'bgOpacity', description: 'Background opacity; 0 leaves only the lines', type: 'number', min: 0, max: 1, step: 0.01 },
+    { name: 'flat', description: 'Lie flat (on) or stand upright (off)', type: 'boolean' },
+    { name: 'followMouse', description: 'Ripples and focus follow the pointer', type: 'boolean' },
+    { name: 'reveal', description: 'How much of the grid is built (0 gone, 1 complete)', type: 'number', min: 0, max: 1, step: 0.01 },
+    { name: 'revealDuration', description: 'Seconds to build or dissolve; 0 applies instantly', type: 'number', min: 0, max: 10, step: 0.1 },
+];
+const own = {
+    advancedGrid: [],
+    quasiGrid: [
+        { name: 'symmetry', description: 'Line families, 3..9. 5 is Penrose; 4 and 6 come out periodic', type: 'number', min: 3, max: 9, step: 1 },
+        { name: 'phase', description: 'Slides the pattern through itself', type: 'number', min: 0, max: 1, step: 0.01 },
+    ],
+    hexGrid: [
+        { name: 'plateau', description: 'With displacement, each hex lifts as a flat plate', type: 'boolean' },
+    ],
+    circuitGrid: [
+        { name: 'powered', description: 'Fraction of tiles carrying a powered trace', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'chipChance', description: 'Fraction of tiles replaced by a chip; 0 disables chips', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'padSize', description: 'Solder-pad size; 0 disables pads', type: 'number', min: 0, max: 2, step: 0.01 },
+    ],
+    voronoiGrid: [
+        { name: 'jitter', description: '0 regular lattice, 1 fully scattered seeds', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'drift', description: 'How far the seeds wander; 0 freezes the cells', type: 'number', min: 0, max: 2, step: 0.01 },
+    ],
+    radarGrid: [
+        { name: 'spokes', description: 'Radial spokes; 0 disables them', type: 'number', min: 0, max: 72, step: 1 },
+        { name: 'sweepWidth', description: 'Length of the sweep trail, as a fraction of a turn', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'blipDensity', description: 'Chance a sector holds a blip', type: 'number', min: 0, max: 1, step: 0.01 },
+    ],
+    moireGrid: [
+        { name: 'shape', description: 'Lattice shape of both layers', type: 'select', options: ['square', 'hex', 'rings'], optionLabels: ['Square', 'Hex', 'Rings'] },
+        { name: 'layerAngle', description: 'Angle between the layers, in radians; small values beat slowly', type: 'number', min: 0, max: 0.5, step: 0.001 },
+        { name: 'layerScale', description: 'Spacing ratio of the second layer; near 1 gives long beats', type: 'number', min: 0.8, max: 1.25, step: 0.001 },
+        { name: 'spin', description: 'Counter-rotation speed; 0 freezes the pattern', type: 'number', min: -5, max: 5, step: 0.05 },
+    ],
+    fractalGrid: [
+        { name: 'depth', description: 'Maximum subdivision levels', type: 'number', min: 1, max: 6, step: 1 },
+        { name: 'splitRadius', description: 'Radius around the focus inside which cells subdivide', type: 'number', min: 0, max: 10, step: 0.05 },
+        { name: 'splitJitter', description: 'Wobble of the split edge', type: 'number', min: 0, max: 1, step: 0.01 },
+    ],
+    contourGrid: [
+        { name: 'levels', description: 'Contour steps across the height range', type: 'number', min: 2, max: 64, step: 1 },
+        { name: 'roughness', description: 'Terrain roughness: 0.35 rolling, 0.65 craggy', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'warp', description: 'Bends the contours into ridges and valleys', type: 'number', min: 0, max: 2, step: 0.01 },
+    ],
+    flowNetGrid: [
+        { name: 'obstacleRadius', description: 'Cylinder radius, in cells', type: 'number', min: 0, max: 10, step: 0.05 },
+        { name: 'circulation', description: 'Circulation around the cylinder (lift)', type: 'number', min: -6, max: 6, step: 1 },
+        { name: 'flowAngle', description: 'Free-stream direction, in radians', type: 'number', min: -3.1416, max: 3.1416, step: 0.01 },
+    ],
+    chladniGrid: [
+        { name: 'modeN', description: 'First mode number of the standing wave', type: 'number', min: 1, max: 12, step: 1 },
+        { name: 'modeM', description: 'Second mode number of the standing wave', type: 'number', min: 1, max: 12, step: 1 },
+        { name: 'morph', description: 'Drift to the neighbouring resonance; 0 holds the pattern', type: 'number', min: 0, max: 2, step: 0.01 },
+        { name: 'grain', description: 'Amount of sand on the plate', type: 'number', min: 0, max: 1, step: 0.01 },
+    ],
+    hyperbolicGrid: [
+        { name: 'sides', description: 'Sides of each polygon (p)', type: 'number', min: 3, max: 12, step: 1 },
+        { name: 'valence', description: 'Polygons around each vertex (q)', type: 'number', min: 3, max: 12, step: 1 },
+        { name: 'drift', description: 'How far the tiling glides through itself', type: 'number', min: 0, max: 1, step: 0.01 },
+    ],
+    gravWaveGrid: [
+        { name: 'strain', description: 'Wave amplitude; 0 leaves only the static wells', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'chirpTime', description: 'Seconds per inspiral-merger-ringdown cycle', type: 'number', min: 4, max: 60, step: 0.5 },
+        { name: 'waveSpeed', description: 'Wave speed, in cells per second', type: 'number', min: 0.5, max: 20, step: 0.1 },
+        { name: 'massRatio', description: 'Mass ratio m2/m1', type: 'number', min: 0.1, max: 1, step: 0.01 },
+    ],
+    girihGrid: [
+        { name: 'tiling', description: 'Base tiling', type: 'select', options: ['0', '1', '2'], optionLabels: ['4.8.8', 'Hexagons', '3.6.3.6'] },
+        { name: 'contactAngle', description: 'Hankin contact angle, degrees; 67.5 is the classic 8-point star', type: 'number', min: 20, max: 85, step: 0.5 },
+        { name: 'strapWidth', description: 'Width of the strapwork band, in cells', type: 'number', min: 0, max: 0.3, step: 0.005 },
+        { name: 'angleDrift', description: 'Degrees the contact angle drifts, morphing the pattern', type: 'number', min: 0, max: 30, step: 0.5 },
+    ],
+    wallpaperGrid: [
+        { name: 'group', description: 'Wallpaper group (-1 cycles through all 17)', type: 'number', min: -1, max: 16, step: 1 },
+        { name: 'cycleTime', description: 'Seconds per group while cycling', type: 'number', min: 1, max: 60, step: 0.5 },
+        { name: 'motif', description: 'Motif complexity', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'levels', description: 'Number of contour levels', type: 'number', min: 2, max: 32, step: 1 },
+    ],
+    reactionDiffusionGrid: [
+        { name: 'feed', description: 'Gray-Scott feed rate F', type: 'number', min: 0.01, max: 0.08, step: 0.0005 },
+        { name: 'kill', description: 'Gray-Scott kill rate k', type: 'number', min: 0.04, max: 0.075, step: 0.0005 },
+        { name: 'variation', description: 'Spread of F and k across the tile, so morphologies coexist', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'tileCells', description: 'Cells covered by one simulation tile', type: 'number', min: 1, max: 20, step: 1 },
+    ],
+};
+/** Every shader-plane grid's inputs: its own knobs first, then the shared surface. */
+export const GRID_PROPERTIES = Object.fromEntries(Object.entries(own).map(([type, props]) => [type, [...props, ...GRID_SURFACE_PROPERTIES]]));

package/dist/properties/tables/index.d.ts

@@ -0,0 +1,9 @@
+export * from './optionalProperties';
+export * from './lightProperties';
+export * from './particlesProperties';
+export * from './effectsProperties';
+export * from './gridProperties';
+export * from './materialBounds';
+export * from './getPropertyConfig';
+export * from './geometryProperties';
+//# sourceMappingURL=index.d.ts.map

package/dist/properties/tables/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/properties/tables/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/properties/tables/index.js

@@ -0,0 +1,8 @@
+export * from './optionalProperties.js';
+export * from './lightProperties.js';
+export * from './particlesProperties.js';
+export * from './effectsProperties.js';
+export * from './gridProperties.js';
+export * from './materialBounds.js';
+export * from './getPropertyConfig.js';
+export * from './geometryProperties.js';

package/dist/properties/tables/lightProperties.d.ts

@@ -0,0 +1,14 @@
+import type { LightType } from '../../types/lights';
+import type { OptionalProperty } from './optionalProperties';
+export type LightTab = 'light' | 'bulb' | 'beam' | 'array' | 'tube' | 'flame' | 'candle';
+export type LightProperty = OptionalProperty & {
+    tab?: LightTab;
+};
+export declare const LIGHT_PROPERTIES: Record<LightType, LightProperty[]>;
+/** Re-export under the name the controller already uses; the table itself lives in core. */
+export declare const LIGHT_DEFAULTS: Record<LightType, Record<string, unknown>>;
+/** Knobs hidden by another knob's value (colour vs temperature, tint only when tinted). */
+export declare function isLightPropertyHidden(name: string, values: Record<string, unknown>): boolean;
+export declare const SHADOW_MAP_SIZES: string[];
+export declare const SHADOW_PROPERTIES: Record<LightType, OptionalProperty[]>;
+//# sourceMappingURL=lightProperties.d.ts.map

package/dist/properties/tables/lightProperties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lightProperties.d.ts","sourceRoot":"","sources":["../../../src/properties/tables/lightProperties.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AACzF,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG;IAAE,GAAG,CAAC,EAAE,QAAQ,CAAA;CAAE,CAAC;AAQlE,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,SAAS,EAAE,aAAa,EAAE,CA4I/D,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAkB,CAAC;AAEzF,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CA2C5F;AAMD,eAAO,MAAM,gBAAgB,UAAyC,CAAC;AAmBvE,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,SAAS,EAAE,gBAAgB,EAAE,CAkBnE,CAAC"}

package/dist/properties/tables/lightProperties.js

@@ -0,0 +1,263 @@
+// Moved from client (client/app/utils/lightProperties.ts). Property tables — the registry (../registry) is built on these.
+// =============================================================================
+// lightProperties — the knobs LightControllerUi shows, per light type
+// =============================================================================
+//
+// OptionalProperty arrays in the same shape as PARTICLES_PROPERTIES, so the
+// light panel renders with BaseControllerUi's PropertiesTab / ColorsTab and
+// looks like every other controller.
+//
+// `tab` groups a knob; only the bulb has more than one ('light' + 'bulb').
+// LIGHT_DEFAULTS fills in a knob a saved config does not carry yet (every
+// light saved before the bulb existed has no `temperature`, for one), so the
+// control still shows instead of silently disappearing.
+//
+import { DEFAULT_LIGHTS } from '../../data/lightsDefaults.js';
+const enabled = { name: 'enabled', label: 'Enabled', type: 'boolean', description: 'Switch the light off without deleting it' };
+const color = { name: 'color', type: 'color', description: 'Light colour' };
+const intensity = (max) => ({ name: 'intensity', type: 'number', min: 0, max, step: 0.01, description: 'Brightness of the light' });
+const distance = { name: 'distance', type: 'number', min: 0, max: 100, step: 0.1, description: 'Range of the light. 0 = unlimited' };
+const decay = { name: 'decay', type: 'number', min: 0, max: 2, step: 0.01, description: 'How fast the light dims with distance. 2 is physically correct' };
+export const LIGHT_PROPERTIES = {
+    ambient: [enabled, intensity(5), color],
+    directional: [enabled, intensity(10), color],
+    point: [enabled, intensity(20), distance, decay, color],
+    spot: [
+        enabled, intensity(20), distance, decay,
+        { name: 'angle', type: 'number', min: 0.01, max: Math.PI / 2, step: 0.01, description: 'Cone half-angle, radians' },
+        { name: 'penumbra', type: 'number', min: 0, max: 1, step: 0.01, description: 'Softness of the cone edge' },
+        color,
+    ],
+    lightBulb: [
+        // Light tab
+        { ...enabled, tab: 'light' },
+        { name: 'on', label: 'Power', type: 'boolean', tab: 'light', description: 'Switch the bulb on or off. Runs the warm-up / cool-down' },
+        { name: 'colorMode', label: 'Colour', type: 'select', tab: 'light', options: ['temperature', 'color'], optionLabels: ['Temperature', 'Custom colour'], description: 'Drive the colour from a Kelvin temperature, or pick one' },
+        { ...intensity(20), tab: 'light' },
+        { name: 'temperature', label: 'Temperature (K)', type: 'number', min: 1000, max: 10000, step: 50, tab: 'light', description: '2700K warm incandescent, 4000K neutral, 6500K daylight' },
+        { ...distance, tab: 'light' },
+        { ...decay, tab: 'light' },
+        { ...color, tab: 'light' },
+        // Bulb tab
+        { name: 'shape', type: 'select', tab: 'bulb', options: ['classic', 'globe', 'edison', 'tube'], optionLabels: ['Classic', 'Globe', 'Edison', 'Tube'], description: 'Glass silhouette and matching filament' },
+        { name: 'glass', type: 'select', tab: 'bulb', options: ['clear', 'frosted', 'tinted'], optionLabels: ['Clear', 'Frosted', 'Tinted'], description: 'Glass finish' },
+        { name: 'warmup', label: 'Warm-up (s)', type: 'number', min: 0, max: 3, step: 0.05, tab: 'bulb', description: 'Time for the filament to heat up. Cooling takes ~2.5x longer. 0 = instant' },
+        { name: 'flicker', type: 'number', min: 0, max: 1, step: 0.01, tab: 'bulb', description: 'Random dips in brightness' },
+        { name: 'halo', type: 'number', min: 0, max: 2, step: 0.01, tab: 'bulb', description: 'Strength of the glow around the bulb' },
+        { name: 'glassTint', label: 'Glass tint', type: 'color', tab: 'bulb', description: 'Glass colour when the glass is Tinted' },
+    ],
+    spotBeam: [
+        // Light tab
+        { ...enabled, tab: 'light' },
+        { name: 'on', label: 'Power', type: 'boolean', tab: 'light', description: 'Switch the lamp on or off. Runs the warm-up' },
+        { name: 'colorMode', label: 'Colour', type: 'select', tab: 'light', options: ['temperature', 'color'], optionLabels: ['Temperature', 'Custom colour'], description: 'Drive the colour from a Kelvin temperature, or pick one' },
+        { ...intensity(50), tab: 'light' },
+        { name: 'temperature', label: 'Temperature (K)', type: 'number', min: 1000, max: 10000, step: 50, tab: 'light', description: '3200K tungsten stage lamp, 5600K daylight' },
+        { name: 'angle', type: 'number', min: 0.01, max: Math.PI / 2, step: 0.01, tab: 'light', description: 'Cone half-angle, radians' },
+        { name: 'penumbra', type: 'number', min: 0, max: 1, step: 0.01, tab: 'light', description: 'Softness of the cone edge' },
+        { ...distance, tab: 'light' },
+        { ...decay, tab: 'light' },
+        { ...color, tab: 'light' },
+        // Beam tab
+        { name: 'pattern', label: 'Gobo', type: 'select', tab: 'beam', options: ['round', 'slot', 'bars', 'blinds', 'window', 'leaves'], optionLabels: ['Round', 'Slot', 'Bars', 'Blinds', 'Window', 'Leaves'], description: 'Shapes both the pool on the floor and the haze in the air' },
+        { name: 'patternSoftness', label: 'Gobo softness', type: 'number', min: 0, max: 1, step: 0.01, tab: 'beam', description: 'Edge softness of the gobo' },
+        { name: 'patternRotation', label: 'Gobo rotation', type: 'number', min: 0, max: Math.PI * 2, step: 0.01, tab: 'beam', description: 'Turns the gobo, radians' },
+        { name: 'beamMode', label: 'Beam quality', type: 'select', tab: 'beam', options: ['none', 'soft', 'layered', 'volumetric'], optionLabels: ['None', 'Soft', 'Layered', 'Volumetric'], description: 'How the beam in the air is drawn. Volumetric carries the gobo through the haze and costs the most' },
+        { name: 'beam', label: 'Beam', type: 'number', min: 0, max: 3, step: 0.01, tab: 'beam', description: 'Brightness of the beam in the air. 0 hides it' },
+        { name: 'beamLength', label: 'Beam length', type: 'number', min: 0.05, max: 1, step: 0.01, tab: 'beam', description: 'How far down the throw the beam reaches' },
+        { name: 'beamNoise', label: 'Haze', type: 'number', min: 0, max: 1, step: 0.01, tab: 'beam', description: 'Breakup in the beam, like smoke drifting through it' },
+        { name: 'beamSteps', label: 'Beam steps', type: 'number', min: 8, max: 48, step: 1, tab: 'beam', description: 'Raymarch samples for the Volumetric beam. Higher is smoother and slower' },
+        { name: 'emitter', label: 'Source', type: 'select', tab: 'beam', options: ['none', 'dot', 'lens'], optionLabels: ['Hidden', 'Dot', 'Lens'], description: 'The bit of visible geometry at the light itself' },
+        { name: 'warmup', label: 'Warm-up (s)', type: 'number', min: 0, max: 3, step: 0.05, tab: 'beam', description: 'Time for the lamp to come up to full. 0 = instant' },
+        { name: 'flicker', type: 'number', min: 0, max: 1, step: 0.01, tab: 'beam', description: 'Random dips in brightness' },
+        { name: 'halo', type: 'number', min: 0, max: 2, step: 0.01, tab: 'beam', description: 'Strength of the glow around the source' },
+    ],
+    ledArray: [
+        // Light tab
+        { ...enabled, tab: 'light' },
+        { name: 'on', label: 'Power', type: 'boolean', tab: 'light', description: 'Switch the array on or off. An LED has no thermal lag, so this is instant unless Warm-up says otherwise' },
+        { name: 'colorMode', label: 'Colour', type: 'select', tab: 'light', options: ['temperature', 'color', 'rgb'], optionLabels: ['Temperature', 'Custom colour', 'RGB'], description: 'Kelvin, one colour, or a hue running across the array' },
+        { ...intensity(40), tab: 'light' },
+        { name: 'temperature', label: 'Temperature (K)', type: 'number', min: 1800, max: 10000, step: 50, tab: 'light', description: '2700K warm white, 4000K neutral, 6500K cool daylight' },
+        { name: 'rgbSpread', label: 'Hue spread', type: 'number', min: 0, max: 2, step: 0.01, tab: 'light', description: 'How many turns of hue fit across the array' },
+        { name: 'rgbSpeed', label: 'Chase', type: 'number', min: -2, max: 2, step: 0.01, tab: 'light', description: 'How fast the hue runs along the array' },
+        { ...distance, tab: 'light' },
+        { ...decay, tab: 'light' },
+        { ...color, tab: 'light' },
+        // Array tab
+        { name: 'layout', type: 'select', tab: 'array', options: ['single', 'strip', 'panel', 'ring'], optionLabels: ['Single', 'Strip', 'Panel', 'Ring'], description: 'How the dies are arranged' },
+        { name: 'count', label: 'Dies', type: 'number', min: 1, max: 64, step: 1, tab: 'array', description: 'Dies along the main axis' },
+        { name: 'rows', type: 'number', min: 1, max: 12, step: 1, tab: 'array', description: 'Rows of dies. Panel only' },
+        { name: 'spacing', type: 'number', min: 0.005, max: 0.5, step: 0.005, tab: 'array', description: 'Distance between dies' },
+        { name: 'dieSize', label: 'Die size', type: 'number', min: 0.002, max: 0.1, step: 0.001, tab: 'array', description: 'Size of one die' },
+        { name: 'emitter', label: 'Source', type: 'select', tab: 'array', options: ['dies', 'none'], optionLabels: ['Dies', 'Hidden'], description: 'Hide the dies to leave only the light' },
+        { name: 'diffuser', type: 'number', min: 0, max: 1, step: 0.01, tab: 'array', description: 'Sheet over the dies. A bigger source, so it softens the shadow too' },
+        { name: 'pwm', label: 'PWM', type: 'number', min: 0, max: 1, step: 0.01, tab: 'array', description: 'The high-frequency chop a dimmed LED runs on. Reads as a slow strobe, the way a camera sees it' },
+        { name: 'warmup', label: 'Warm-up (s)', type: 'number', min: 0, max: 3, step: 0.05, tab: 'array', description: 'Fade-up time. 0 = instant, which is what an LED actually does' },
+        { name: 'flicker', type: 'number', min: 0, max: 1, step: 0.01, tab: 'array', description: 'Random dips in brightness' },
+        { name: 'halo', type: 'number', min: 0, max: 2, step: 0.01, tab: 'array', description: 'Strength of the glow around the array' },
+    ],
+    fluorescentTube: [
+        // Light tab
+        { ...enabled, tab: 'light' },
+        { name: 'on', label: 'Power', type: 'boolean', tab: 'light', description: 'Switch the fixture on or off' },
+        { name: 'colorMode', label: 'Colour', type: 'select', tab: 'light', options: ['temperature', 'color'], optionLabels: ['Temperature', 'Custom colour'], description: 'Drive the colour from a Kelvin temperature, or pick one' },
+        { ...intensity(60), tab: 'light' },
+        { name: 'temperature', label: 'Temperature (K)', type: 'number', min: 2700, max: 8000, step: 50, tab: 'light', description: '3000K warm white, 4000K cool white, 6500K daylight' },
+        { name: 'greenShift', label: 'Green spike', type: 'number', min: 0, max: 1, step: 0.01, tab: 'light', description: "The phosphor's green cast. Real halophosphate tubes read distinctly green next to daylight" },
+        { name: 'shadowStrength', label: 'Shadow core', type: 'number', min: 0, max: 1, step: 0.01, tab: 'light', description: 'Share of the output coming from a point at the middle of the fixture. A rect-area light cannot cast a shadow, so only this part does. 0 = pure soft area light, no shadow' },
+        { ...color, tab: 'light' },
+        // Tube tab
+        { name: 'tubes', type: 'number', min: 1, max: 4, step: 1, tab: 'tube', description: 'Tubes in the fixture' },
+        { name: 'tubeSpacing', label: 'Tube spacing', type: 'number', min: 0.02, max: 0.6, step: 0.005, tab: 'tube', description: 'Distance between tubes' },
+        { name: 'length', type: 'number', min: 0.1, max: 4, step: 0.05, tab: 'tube', description: 'Tube length' },
+        { name: 'diameter', type: 'number', min: 0.006, max: 0.12, step: 0.002, tab: 'tube', description: 'Tube diameter' },
+        { name: 'emitter', label: 'Source', type: 'select', tab: 'tube', options: ['tubes', 'none'], optionLabels: ['Tubes', 'Hidden'], description: 'Hide the tubes to leave only the light' },
+        { name: 'startup', type: 'select', tab: 'tube', options: ['instant', 'stutter'], optionLabels: ['Instant', 'Stutter'], description: 'Stutter strikes the arc with false starts first, the way a magnetic ballast does' },
+        { name: 'warmup', label: 'Warm-up (s)', type: 'number', min: 0, max: 5, step: 0.05, tab: 'tube', description: 'Time for the mercury vapour to reach full output' },
+        { name: 'hum', label: 'Ballast hum', type: 'number', min: 0, max: 1, step: 0.01, tab: 'tube', description: 'Depth of the 100 Hz ripple a magnetic ballast leaves in the light' },
+        { name: 'age', type: 'number', min: 0, max: 1, step: 0.01, tab: 'tube', description: 'Wear: dimmer, blackened ends, a longer strike and more flicker' },
+        // The rect-area light has neither; these govern the shadow core only.
+        { ...distance, tab: 'tube', description: 'Range of the shadow core. 0 = unlimited' },
+        { ...decay, tab: 'tube', description: 'How fast the shadow core dims with distance. 2 is physically correct' },
+        { name: 'flicker', type: 'number', min: 0, max: 1, step: 0.01, tab: 'tube', description: 'Random dips in brightness, on top of whatever Age adds' },
+        { name: 'halo', type: 'number', min: 0, max: 2, step: 0.01, tab: 'tube', description: 'Strength of the wash around the fixture' },
+    ],
+    candle: [
+        // Light tab
+        { ...enabled, tab: 'light' },
+        { name: 'on', label: 'Lit', type: 'boolean', tab: 'light', description: 'Lighting it runs the ignition; putting it out snuffs the flame and leaves a thread of smoke' },
+        { name: 'colorMode', label: 'Colour', type: 'select', tab: 'light', options: ['temperature', 'color'], optionLabels: ['Temperature', 'Custom colour'], description: 'Drive the colour from a Kelvin temperature, or pick one' },
+        { ...intensity(6), tab: 'light' },
+        { name: 'temperature', label: 'Temperature (K)', type: 'number', min: 1200, max: 3200, step: 10, tab: 'light', description: 'A candle is about 1850K' },
+        { ...distance, tab: 'light' },
+        { ...decay, tab: 'light' },
+        { ...color, tab: 'light' },
+        // Flame tab
+        { name: 'flameMode', label: 'Flame quality', type: 'select', tab: 'flame', options: ['volumetric', 'billboard'], optionLabels: ['Volumetric', 'Billboard'], description: 'Volumetric raymarches the flame, so it has real depth from every angle. Billboard is the same flame on one quad — for scenes full of candles' },
+        { name: 'flameHeight', label: 'Flame height', type: 'number', min: 0.008, max: 0.2, step: 0.001, tab: 'flame', description: 'A real candle flame is 3-6 cm' },
+        { name: 'flameWidth', label: 'Flame width', type: 'number', min: 0.2, max: 2, step: 0.01, tab: 'flame', description: 'Width relative to the height' },
+        { name: 'movement', type: 'number', min: 0, max: 1, step: 0.01, tab: 'flame', description: 'How much the flame moves at all. 0 holds it perfectly still — it can still flicker in brightness' },
+        { name: 'flicker', type: 'number', min: 0, max: 1, step: 0.01, tab: 'flame', description: 'Depth of the brightness dip. This is the light’s output, not its shape' },
+        { name: 'flickerHz', label: 'Flicker rate (Hz)', type: 'number', min: 4, max: 20, step: 0.1, tab: 'flame', description: 'Real candle flames oscillate near 11 Hz almost regardless of size' },
+        { name: 'draught', type: 'number', min: 0, max: 1, step: 0.01, tab: 'flame', description: 'Air movement: lean, stretch, turbulence, and guttering once it is strong' },
+        { name: 'blue', label: 'Blue base', type: 'number', min: 0, max: 1, step: 0.01, tab: 'flame', description: 'The blue cone at the wick, where there is plenty of oxygen' },
+        { name: 'blueBasePercentage', label: 'Blue base height', type: 'number', min: 0, max: 100, step: 1, tab: 'flame', description: 'How much of the flame’s height reads blue, as a percentage. Past about 40 it fills in rather than staying a collar' },
+        { name: 'soot', type: 'number', min: 0, max: 1, step: 0.01, tab: 'flame', description: 'How much the soot absorbs: gives the flame a body instead of a ghost' },
+        { name: 'flameSteps', label: 'Raymarch steps', type: 'number', min: 8, max: 40, step: 1, tab: 'flame', description: 'Volumetric only. Higher is smoother and slower' },
+        { name: 'flameGain', label: 'Flame gain', type: 'number', min: 1, max: 20, step: 0.1, tab: 'flame', description: 'Emission scale. Raise for a hotter, whiter flame' },
+        { name: 'flameWhite', label: 'White point', type: 'number', min: 1.5, max: 10, step: 0.1, tab: 'flame', description: 'Where the flame\u2019s own knee clips to white. Lower blows the core out sooner' },
+        { name: 'ignite', label: 'Ignition (s)', type: 'number', min: 0, max: 5, step: 0.05, tab: 'flame', description: 'Time for the wick to catch and the flame to establish. 0 = instant' },
+        { name: 'smoke', label: 'Smoke when snuffed', type: 'boolean', tab: 'flame', description: 'A thread of smoke for a few seconds after it goes out' },
+        { name: 'halo', type: 'number', min: 0, max: 2, step: 0.01, tab: 'flame', description: 'Strength of the wash around the flame' },
+        // Candle tab
+        { name: 'body', type: 'select', tab: 'candle', options: ['pillar', 'taper', 'tealight', 'none'], optionLabels: ['Pillar', 'Taper', 'Tealight', 'None'], description: 'None leaves the flame and the light on their own, to drop into your own candle' },
+        { name: 'height', type: 'number', min: 0.01, max: 1, step: 0.005, tab: 'candle', description: 'Candle height, before the body style\u2019s own proportions' },
+        { name: 'radius', type: 'number', min: 0.004, max: 0.15, step: 0.001, tab: 'candle', description: 'Candle radius' },
+        { name: 'melt', type: 'number', min: 0, max: 1, step: 0.01, tab: 'candle', description: 'How far it has burned down: the depth of the well round the wick' },
+        { name: 'waxGlow', label: 'Wax glow', type: 'number', min: 0, max: 1, step: 0.01, tab: 'candle', description: 'How much the wax is lit from inside' },
+        { name: 'waxColor', label: 'Wax colour', type: 'color', tab: 'candle', description: 'Wax colour' },
+    ],
+};
+/** Re-export under the name the controller already uses; the table itself lives in core. */
+export const LIGHT_DEFAULTS = DEFAULT_LIGHTS;
+/** Knobs hidden by another knob's value (colour vs temperature, tint only when tinted). */
+export function isLightPropertyHidden(name, values) {
+    const type = values.type;
+    if (type === 'ledArray') {
+        const mode = values.colorMode ?? 'temperature';
+        if (name === 'color')
+            return mode !== 'color';
+        if (name === 'temperature')
+            return mode === 'rgb';
+        if (name === 'rgbSpread' || name === 'rgbSpeed')
+            return mode !== 'rgb';
+        if (name === 'rows')
+            return (values.layout ?? 'panel') !== 'panel';
+        if (name === 'count')
+            return (values.layout ?? 'panel') === 'single';
+        return false;
+    }
+    if (type === 'candle') {
+        const mode = values.colorMode ?? 'temperature';
+        if (name === 'color')
+            return mode !== 'color';
+        if (name === 'temperature')
+            return mode !== 'temperature';
+        // Only the raymarched flame has steps, and the wax knobs mean nothing
+        // when there is no wax.
+        if (name === 'flameSteps')
+            return (values.flameMode ?? 'volumetric') !== 'volumetric';
+        if (name === 'height' || name === 'radius' || name === 'melt' || name === 'waxGlow' || name === 'waxColor')
+            return (values.body ?? 'pillar') === 'none';
+        return false;
+    }
+    if (type === 'fluorescentTube') {
+        const mode = values.colorMode ?? 'temperature';
+        if (name === 'color')
+            return mode !== 'color';
+        if (name === 'temperature')
+            return mode !== 'temperature';
+        if (name === 'tubeSpacing')
+            return (typeof values.tubes === 'number' ? values.tubes : 1) < 2;
+        return false;
+    }
+    if (type !== 'lightBulb' && type !== 'spotBeam')
+        return false;
+    const mode = values.colorMode ?? 'temperature';
+    if (name === 'color')
+        return mode !== 'color';
+    if (name === 'temperature')
+        return mode !== 'temperature';
+    if (type === 'lightBulb') {
+        if (name === 'glassTint')
+            return (values.glass ?? 'clear') !== 'tinted';
+        return false;
+    }
+    // spotBeam: the beam knobs mean nothing with the beam off, and the step count
+    // only drives the raymarched mode.
+    const beamMode = values.beamMode ?? 'soft';
+    if (name === 'beamSteps')
+        return beamMode !== 'volumetric';
+    if (name === 'beam' || name === 'beamLength' || name === 'beamNoise')
+        return beamMode === 'none';
+    return false;
+}
+// -----------------------------------------------------------------------------
+// Shadow
+// -----------------------------------------------------------------------------
+export const SHADOW_MAP_SIZES = ['256', '512', '1024', '2048', '4096'];
+const common = [
+    { name: 'enabled', label: 'Cast shadows', type: 'boolean', description: 'A point light / bulb shadow costs six extra renders' },
+    { name: 'mapSize', label: 'Resolution', type: 'select', options: SHADOW_MAP_SIZES, description: 'Shadow map size. Higher is sharper and slower' },
+    { name: 'intensity', type: 'number', min: 0, max: 1, step: 0.01, description: 'How dark the shadow is' },
+    { name: 'radius', label: 'Softness', type: 'number', min: 0, max: 10, step: 0.1, description: 'Blur radius of the shadow edge (PCF shadows)' },
+    { name: 'bias', type: 'number', min: -0.01, max: 0.01, step: 0.0001, description: 'Fixes shadow acne. Too far and shadows detach from objects' },
+    { name: 'normalBias', label: 'Normal bias', type: 'number', min: 0, max: 0.1, step: 0.001, description: 'Acne fix along the surface normal; better on curved surfaces' },
+    { name: 'cameraNear', label: 'Near', type: 'number', min: 0.01, max: 10, step: 0.01, description: 'Closest distance that casts a shadow' },
+    { name: 'cameraFar', label: 'Far', type: 'number', min: 1, max: 1000, step: 1, description: 'Farthest distance that casts a shadow' },
+];
+const spotShadow = [
+    ...common,
+    { name: 'cameraFov', label: 'Shadow FOV', type: 'number', min: 1, max: 120, step: 1, description: 'Field of view of the shadow camera' },
+    { name: 'focus', type: 'number', min: 0, max: 1, step: 0.01, description: 'Tightens the shadow camera around the cone' },
+];
+export const SHADOW_PROPERTIES = {
+    ambient: [],
+    point: common,
+    lightBulb: common,
+    spot: spotShadow,
+    spotBeam: spotShadow,
+    ledArray: common,
+    candle: common,
+    // The shadow belongs to the point light at the fixture's centre, so the point
+    // light's settings are the ones that matter.
+    fluorescentTube: common,
+    directional: [
+        ...common,
+        { name: 'cameraLeft', label: 'Left', type: 'number', min: -200, max: 0, step: 1, description: 'Shadow area, left edge' },
+        { name: 'cameraRight', label: 'Right', type: 'number', min: 0, max: 200, step: 1, description: 'Shadow area, right edge' },
+        { name: 'cameraTop', label: 'Top', type: 'number', min: 0, max: 200, step: 1, description: 'Shadow area, top edge' },
+        { name: 'cameraBottom', label: 'Bottom', type: 'number', min: -200, max: 0, step: 1, description: 'Shadow area, bottom edge' },
+    ],
+};

package/dist/properties/tables/materialBounds.d.ts

@@ -0,0 +1,33 @@
+export interface MaterialPropertyBounds {
+    min: number;
+    max: number;
+    step: number;
+    label?: string;
+    accentColor?: 'cyan' | 'purple' | 'pink' | 'green' | 'yellow' | 'blue';
+}
+/**
+ * Known bounds for standard Three.js material properties.
+ * Used by MaterialControllerUi to render SliderControls with correct ranges.
+ *
+ * If a property is not in this map, it falls back to a sensible default (0–1, step 0.01).
+ */
+export declare const MATERIAL_PROPERTY_BOUNDS: Record<string, MaterialPropertyBounds>;
+/**
+ * Default bounds for unknown numeric properties.
+ */
+export declare const DEFAULT_MATERIAL_BOUNDS: MaterialPropertyBounds;
+/**
+ * Get bounds for a property, falling back to defaults.
+ */
+export declare function getMaterialBounds(key: string): MaterialPropertyBounds;
+/**
+ * Get a human-readable label for a property key.
+ * Uses the bounds label if available, otherwise converts camelCase to Title Case.
+ */
+export declare function getMaterialPropertyLabel(key: string): string;
+/**
+ * Generate random values for numeric and color properties within their bounds.
+ * Skips texture/mapping properties and internal fields.
+ */
+export declare function generateRandomMaterialSettings(currentSettings: Record<string, any>): Record<string, any>;
+//# sourceMappingURL=materialBounds.d.ts.map