@compilr-dev/sdk 0.38.0 → 0.39.0

package/dist/canvas/scene.d.ts

@@ -21,10 +21,26 @@ export declare const SCENE_EXTRUDE_AXES: readonly ExtrudeAxis[];
 export interface SceneMaterial {
     /** 0..1, default 0.78 */
     roughness?: number;
-    /** 0..1, default 0.02 */
+    /**
+     * 0..1, default 0.02.
+     *
+     * ⚠️ Metal is MIRROR, not colour: a metal with nothing to reflect renders near-black. The
+     * viewer lights the scene with a neutral room environment so this means something; without
+     * one, raising it made objects darker, which is why it had looked like a dead knob.
+     */
     metalness?: number;
     /** 0.05..1, default 1 (transparent when < 1) */
     opacity?: number;
+    /**
+     * '#RRGGBB' the object gives off, default '#000000' (none). Emission is NOT light: it
+     * brightens the object itself and casts nothing on its neighbours, so it marks a thing as
+     * live or active — an indicator, a hot path, a selected step — rather than lighting a room.
+     */
+    emissive?: string;
+    /** How strong the emission is. 0..5, default 1. Only means anything with `emissive` set. */
+    emissiveIntensity?: number;
+    /** Draw the edges only. Default false. For the parts of a diagram that are logical, not built. */
+    wireframe?: boolean;
 }
 export interface SceneObjectBase {
     /** Unique in the scene; /^[a-z0-9][a-z0-9_-]{0,47}$/ */
@@ -260,6 +276,8 @@ export declare const SCENE_NEUTRAL_PALETTE: readonly string[];
 /** Accessible names for the palette swatches, same order (Q-10). */
 export declare const SCENE_PALETTE_NAMES: readonly string[];
 export declare const SCENE_DEFAULT_MATERIAL: Readonly<Required<SceneMaterial>>;
+/** `material.emissiveIntensity` range. Above ~5 everything clips to white. */
+export declare const SCENE_EMISSIVE_INTENSITY_MAX = 5;
 /** The reference camera, used for an empty scene. */
 export declare const SCENE_DEFAULT_CAMERA: Readonly<SceneCamera>;
 /** Vertical field of view of the viewer camera, degrees. */

package/dist/canvas/scene.js

@@ -105,7 +105,12 @@ export const SCENE_DEFAULT_MATERIAL = {
     roughness: 0.78,
     metalness: 0.02,
     opacity: 1,
+    emissive: '#000000',
+    emissiveIntensity: 1,
+    wireframe: false,
 };
+/** `material.emissiveIntensity` range. Above ~5 everything clips to white. */
+export const SCENE_EMISSIVE_INTENSITY_MAX = 5;
 /** The reference camera, used for an empty scene. */
 export const SCENE_DEFAULT_CAMERA = {
     position: [7, 5.5, 8],
@@ -216,7 +221,14 @@ const TYPE_SHAPE = {
     group: 'a group is a container: id, name, position, rotation, group, locked, tags only — colour its children',
     label: 'label takes text and optional size (cap height in metres), background, face ("camera" or "fixed"); color is the ink and material is not allowed',
 };
-const MATERIAL_KEYS = new Set(['roughness', 'metalness', 'opacity']);
+const MATERIAL_KEYS = new Set([
+    'roughness',
+    'metalness',
+    'opacity',
+    'emissive',
+    'emissiveIntensity',
+    'wireframe',
+]);
 const HEX_RE = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/;
 /** Short, stable number rendering for messages and summaries. */
 export function fmtNum(n) {
@@ -422,7 +434,7 @@ function validateObject(raw, i, errors) {
             const m = raw.material;
             for (const k of Object.keys(m)) {
                 if (!MATERIAL_KEYS.has(k)) {
-                    errors.push(`${label}.material.${k} is not a material field — roughness, metalness, opacity.`);
+                    errors.push(`${label}.material.${k} is not a material field — roughness, metalness, opacity, emissive, emissiveIntensity, wireframe.`);
                 }
             }
             if (m.roughness !== undefined)
@@ -431,6 +443,15 @@ function validateObject(raw, i, errors) {
                 checkNumber(m.metalness, `${label}.material.metalness`, 0, 1, 'metalness is 0–1', errors);
             if (m.opacity !== undefined)
                 checkNumber(m.opacity, `${label}.material.opacity`, SCENE_OPACITY_MIN, 1, `opacity is ${fmtNum(SCENE_OPACITY_MIN)}–1`, errors);
+            if (m.emissive !== undefined &&
+                (typeof m.emissive !== 'string' || !HEX_RE.test(m.emissive))) {
+                errors.push(`${label}.material.emissive = ${show(m.emissive)} — a colour the object gives off, "#RGB" or "#RRGGBB" ("#000000" for none).`);
+            }
+            if (m.emissiveIntensity !== undefined)
+                checkNumber(m.emissiveIntensity, `${label}.material.emissiveIntensity`, 0, SCENE_EMISSIVE_INTENSITY_MAX, `emissiveIntensity is 0–${String(SCENE_EMISSIVE_INTENSITY_MAX)}, and only does anything with emissive set`, errors);
+            if (m.wireframe !== undefined && typeof m.wireframe !== 'boolean') {
+                errors.push(`${label}.material.wireframe = ${show(m.wireframe)} — true or false.`);
+            }
         }
     }
     // Type-specific dimensions.

package/dist/platform/tools/scene-tools.js

@@ -288,11 +288,30 @@ const OBJECT_PROPERTIES = {
     },
     material: {
         type: 'object',
-        description: '{ roughness 0–1, metalness 0–1, opacity 0.05–1 }. Not on a group.',
+        description: 'Not on a group or a label. { roughness 0–1 (0 = mirror-smooth, 1 = matt) · metalness 0–1 ' +
+            '(metal is MIRROR, not colour: it shows the room, so it reads dark against a plain ' +
+            'background — use it for a few accents, not everything) · opacity 0.05–1 (a pane of glass, ' +
+            'a volume you want to see into) · emissive "#RRGGBB" + emissiveIntensity 0–5 · wireframe }.',
         properties: {
             roughness: { type: 'number' },
             metalness: { type: 'number' },
             opacity: { type: 'number' },
+            emissive: {
+                type: 'string',
+                description: 'A colour the object GIVES OFF, so it reads as live rather than lit: an indicator, an ' +
+                    'active path, the step being explained. ⚠️ It brightens the object only — it casts no ' +
+                    "light on its neighbours and draws no halo. Pair it with the object's own colour, and " +
+                    'use it on a few things: everything glowing is nothing glowing.',
+            },
+            emissiveIntensity: {
+                type: 'number',
+                description: '0–5, default 1. Does nothing without emissive. Past ~3 the colour clips to white.',
+            },
+            wireframe: {
+                type: 'boolean',
+                description: 'Edges only. For the parts of a diagram that are LOGICAL rather than built — a boundary, ' +
+                    'a planned phase, a region — beside solid objects that are real.',
+            },
         },
     },
     locked: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.38.0",
+  "version": "0.39.0",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",