@kiberon-labs/behave-graph-scene 1.0.0 → 2.0.0

package/.turbo/turbo-build.log

@@ -0,0 +1,8 @@
+
+> @kiberon-labs/behave-graph-scene@2.0.0 build /home/runner/work/behave-graph/behave-graph/packages/nodes/scene
+> tsdown && behave-graph-manifest dist/manifest.source.js --out dist
+
+ℹ tsdown v0.16.5 powered by rolldown v1.0.0-beta.50
+ℹ Using tsdown config: /home/runner/work/behave-graph/behave-graph/packages/nodes/scene/tsdown.config.ts
+ℹ Build start
+Wrote 191 nodes, 8 value types to /home/runner/work/behave-graph/behave-graph/packages/nodes/scene/dist/behave-graph.manifest.json

package/CHANGELOG.md

@@ -0,0 +1,84 @@
+# @kiberon-labs/behave-graph-scene
+
+## 2.0.0
+
+### Minor Changes
+
+- cf72d27: Static package-manifest system: let editors and tooling discover the nodes,
+  value types, UI contributions and host requirements a package provides
+  **without importing or executing the package's code**.
+
+  Previously the only way to learn what a package offered was to call its
+  `registerProfile`, which imports and runs every node implementation (closures,
+  side effects, even WASM init) — a security and performance cost just to list
+  nodes. A manifest is the persisted, on-disk form of the static projection the
+  editor already renders from (`NodeSpecJSON` + value display metadata), so the
+  executable half (node `exec`, value serializers, React components, a persistent
+  backend) is loaded only by a runner or on explicit, trust-gated demand.
+
+  ## `@kiberon-labs/behave-graph`
+
+  New `Manifest/` module (exported from the package root), all additive:
+
+  - **Schema** (`ManifestJSON`): function-free `ValueTypeSpecJSON`, `NodeManifestEntry`
+    (the existing `NodeSpecJSON` plus optional authoring extras), `ContributionSpec`
+    / `ContributionKind` (control, specific, panel, socketGenerator, conversion,
+    command, contextMenu, valueType), open-ended `categories` (`PackageCategory`
+    constants are advisory), and `requirements` (`PackageRequirement`, discriminated
+    by `kind` with known `backendService` / `config` kinds **plus an open escape
+    hatch** so hosts tolerate kinds not yet modelled).
+  - **Generation** (build time): `writeManifest` (reuses `writeNodeSpecsToJSON`, so
+    node specs are identical to runtime), `writeValueTypesToJSON` (function-free
+    display + `serialize(creator())` default), `defineManifestSource` /
+    `runManifestSource`, and a `behave-graph-manifest` CLI bin.
+  - **Validation**: `parseManifest`, a dependency-free well-formedness gate a host
+    runs on an untrusted manifest before consuming it.
+  - **Conventions**: `MANIFEST_FILE_NAME` (`behave-graph.manifest.json` — a plain
+    `.json` file, the canonical name; a directory `--out` writes it there) and
+    `MANIFEST_PACKAGE_FIELD` (`behaveGraph`, the `package.json` field pointing at
+    the manifest).
+
+  ## `@kiberon-labs/behave-graph-flow`
+
+  New `manifest/` module for consuming a manifest in the editor:
+
+  - `loadManifest` / `manifestPlugin`: always register node specs + value types from
+    JSON with **zero code execution** (the palette renders from JSON alone); surface
+    declared host requirements via `onRequirement`; and load code contributions
+    **only under an explicit `trust` flag + a host-provided `resolve`r** (the host
+    owns module resolution because a bundler must know the concrete module). A
+    failing contribution is logged and skipped, never aborting the rest.
+  - `passthroughValueType`: synthesises a working `ValueTypeMetadata` from a
+    function-free spec (identity (de)serialize, cloned default) so existing UI call
+    sites keep working until a trusted `valueType` contribution swaps in the real
+    implementation.
+  - `contributionRegistry`: maps each `ContributionKind` to its editor store.
+
+  ## `@kiberon-labs/behave-graph-nodes-image` and `@kiberon-labs/behave-graph-scene`
+
+  Both packages now generate a `behave-graph.manifest.json` at build time as
+  reference implementations:
+
+  - A side-effect-light `src/manifest.source.ts` (`defineManifestSource`) declares
+    the registry builder, `runtime` entry, category and contributions; the package
+    `build` runs `behave-graph-manifest`, and `package.json#behaveGraph.manifest`
+    points at the output. Spec generation runs no node code (image needs no WASM
+    init; scene is fed a `DummyScene` for `IScene`).
+  - **image**: 13 nodes + the `image` value type, with control / specific / panel /
+    valueType contributions. `ui.tsx` now re-exports `ImageControl`,
+    `imagePreviewSpecific` and an extracted `imageOutputTab` loader so a host can
+    resolve them from the manifest.
+  - **scene**: ~191 nodes + 8 value types (`vec2`…`mat4`), the `vec3` control and a
+    `valueType` contribution per scene type.
+
+  Also (private packages, no version bump): the VS Code extension gains
+  `discoverManifests`, which statically scans `node_modules` for
+  `package.json#behaveGraph.manifest` and reads/validates the JSON without importing
+  package code; and the documentation site gains a dedicated "Package Manifests"
+  section.
+
+### Patch Changes
+
+- Updated dependencies [cf72d27]
+- Updated dependencies [cf72d27]
+  - @kiberon-labs/behave-graph@1.2.0

package/LICENSE

@@ -0,0 +1,6 @@
+Internet Systems Consortium license
+Copyright (c) 2022 behave-graph authors
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,13 @@
+# Behave-Graph Scene
+
+[![GitHub license](https://img.shields.io/npm/l/behave-graph-scene)](https://github.com/kiberon-labs/behave-graph/blob/master/LICENSE) [![npm version](https://img.shields.io/npm/v/@kiberon-labs/behave-graph-scene)](https://www.npmjs.com/package/@kiberon-labs/behave-graph-scene)
+
+This is a set of 3D nodes for threejs when working with [behave graphs](https://www.npmjs.com/package/@kiberon-labs/behave-graph)
+
+## Documentation
+
+See the dedicated documentation site [here](https://behave-graph.kiberon-labs.co.za)
+
+## Licence 
+
+ISC. See [here](./LICENSE)

package/dist/Abstractions/Drivers/DummyScene.d.ts

@@ -0,0 +1,64 @@
+import { GeometryType, IScene, LightType } from "../IScene.js";
+import { EventEmitter } from "@kiberon-labs/behave-graph";
+
+//#region src/Abstractions/Drivers/DummyScene.d.ts
+declare class DummyScene implements IScene {
+  onSceneChanged: EventEmitter<void>;
+  private valueRegistry;
+  constructor();
+  getProperty(jsonPath: string, valueTypeName: string): unknown;
+  setProperty(): void;
+  addOnClickedListener(jsonPath: string, callback: (jsonPath: string) => void): void;
+  removeOnClickedListener(jsonPath: string, callback: (jsonPath: string) => void): void;
+  getQueryableProperties(): never[];
+  getRaycastableProperties(): never[];
+  getProperties(): never[];
+  addOnSceneChangedListener(): void;
+  removeOnSceneChangedListener(): void;
+  createMesh(_name: string, _geometryType: GeometryType, _size: {
+    x: number;
+    y: number;
+    z: number;
+  }): void;
+  deleteMesh(_name: string): void;
+  getMeshNames(): never[];
+  addLight(_name: string, _lightType: LightType, _color: {
+    r: number;
+    g: number;
+    b: number;
+  }, _intensity: number): void;
+  removeLight(_name: string): void;
+  setLightProperty(_name: string, _property: string, _value: unknown): void;
+  getLightProperty(_name: string, _property: string): unknown;
+  getLightNames(): never[];
+  setMaterialProperty(_meshName: string, _property: string, _value: unknown): void;
+  getMaterialProperty(_meshName: string, _property: string): unknown;
+  addOnAnyMeshClickedListener(_callback: (meshName: string) => void): void;
+  removeOnAnyMeshClickedListener(_callback: (meshName: string) => void): void;
+  getMeshPosition(_meshName: string): {
+    x: number;
+    y: number;
+    z: number;
+  } | undefined;
+  setMeshPosition(_meshName: string, _position: {
+    x: number;
+    y: number;
+    z: number;
+  }): void;
+  getDistanceBetween(_meshA: string, _meshB: string): number;
+  lookAt(_meshName: string, _target: {
+    x: number;
+    y: number;
+    z: number;
+  }): void;
+  moveTowards(_meshName: string, _target: {
+    x: number;
+    y: number;
+    z: number;
+  }, _speed: number, _deltaSeconds: number): boolean;
+  cloneMesh(_sourceName: string, _newName: string): void;
+  setMeshVisible(_meshName: string, _visible: boolean): void;
+}
+//#endregion
+export { DummyScene };
+//# sourceMappingURL=DummyScene.d.ts.map

package/dist/Abstractions/Drivers/DummyScene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DummyScene.d.ts","names":[],"sources":["../../../src/Abstractions/Drivers/DummyScene.ts"],"sourcesContent":[],"mappings":";;;;cAiBa,UAAA,YAAsB;kBACZ;EADV,QAAA,aAAW;EACD,WAAA,CAAA;EAgEJ,WAAA,CAAA,QAAA,EAAA,MAAA,EAAA,aAAA,EAAA,MAAA,CAAA,EAAA,OAAA;EAiBH,WAAA,CAAA,CAAA,EAAA,IAAA;EAlFmB,oBAAA,CAAA,QAAA,EAAA,MAAA,EAAA,QAAA,EAAA,CAAA,QAAA,EAAA,MAAA,EAAA,GAAA,IAAA,CAAA,EAAA,IAAA;EAAM,uBAAA,CAAA,QAAA,EAAA,MAAA,EAAA,QAAA,EAAA,CAAA,QAAA,EAAA,MAAA,EAAA,GAAA,IAAA,CAAA,EAAA,IAAA;;;;;;2CAiEtB;;;;;;;sCAiBH"}

package/dist/Abstractions/Drivers/DummyScene.js

@@ -0,0 +1,115 @@
+import { ColorValue } from "../../Values/ColorValue.js";
+import { EulerValue } from "../../Values/EulerValue.js";
+import { QuatValue } from "../../Values/QuatValue.js";
+import { Vec2Value } from "../../Values/Vec2Value.js";
+import { Vec3Value } from "../../Values/Vec3Value.js";
+import { Vec4Value } from "../../Values/Vec4Value.js";
+import { BooleanValue, EventEmitter, FloatValue, IntegerValue, StringValue } from "@kiberon-labs/behave-graph";
+
+//#region src/Abstractions/Drivers/DummyScene.ts
+var DummyScene = class {
+	onSceneChanged = new EventEmitter();
+	valueRegistry;
+	constructor() {
+		this.valueRegistry = Object.fromEntries([
+			BooleanValue,
+			StringValue,
+			IntegerValue,
+			FloatValue,
+			Vec2Value,
+			Vec3Value,
+			Vec4Value,
+			ColorValue,
+			EulerValue,
+			QuatValue
+		].map((valueType) => [valueType.name, valueType]));
+	}
+	getProperty(jsonPath, valueTypeName) {
+		return this.valueRegistry[valueTypeName]?.creator();
+	}
+	setProperty() {
+		this.onSceneChanged.emit();
+	}
+	addOnClickedListener(jsonPath, callback) {
+		console.log("added on clicked listener");
+	}
+	removeOnClickedListener(jsonPath, callback) {
+		console.log("removed on clicked listener");
+	}
+	getQueryableProperties() {
+		return [];
+	}
+	getRaycastableProperties() {
+		return [];
+	}
+	getProperties() {
+		return [];
+	}
+	addOnSceneChangedListener() {
+		console.log("added on scene changed listener");
+	}
+	removeOnSceneChangedListener() {
+		console.log("removed on scene changed listener");
+	}
+	createMesh(_name, _geometryType, _size) {
+		console.log("created mesh (dummy)");
+	}
+	deleteMesh(_name) {
+		console.log("deleted mesh (dummy)");
+	}
+	getMeshNames() {
+		return [];
+	}
+	addLight(_name, _lightType, _color, _intensity) {
+		console.log("added light (dummy)");
+	}
+	removeLight(_name) {
+		console.log("removed light (dummy)");
+	}
+	setLightProperty(_name, _property, _value) {
+		console.log("set light property (dummy)");
+	}
+	getLightProperty(_name, _property) {}
+	getLightNames() {
+		return [];
+	}
+	setMaterialProperty(_meshName, _property, _value) {
+		console.log("set material property (dummy)");
+	}
+	getMaterialProperty(_meshName, _property) {}
+	addOnAnyMeshClickedListener(_callback) {
+		console.log("added on any mesh clicked listener (dummy)");
+	}
+	removeOnAnyMeshClickedListener(_callback) {
+		console.log("removed on any mesh clicked listener (dummy)");
+	}
+	getMeshPosition(_meshName) {
+		return {
+			x: 0,
+			y: 0,
+			z: 0
+		};
+	}
+	setMeshPosition(_meshName, _position) {
+		console.log("set mesh position (dummy)");
+	}
+	getDistanceBetween(_meshA, _meshB) {
+		return 0;
+	}
+	lookAt(_meshName, _target) {
+		console.log("lookAt (dummy)");
+	}
+	moveTowards(_meshName, _target, _speed, _deltaSeconds) {
+		return true;
+	}
+	cloneMesh(_sourceName, _newName) {
+		console.log("cloned mesh (dummy)");
+	}
+	setMeshVisible(_meshName, _visible) {
+		console.log("set mesh visible (dummy)");
+	}
+};
+
+//#endregion
+export { DummyScene };
+//# sourceMappingURL=DummyScene.js.map

package/dist/Abstractions/Drivers/DummyScene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DummyScene.js","names":[],"sources":["../../../src/Abstractions/Drivers/DummyScene.ts"],"sourcesContent":["import {\n  BooleanValue,\n  EventEmitter,\n  FloatValue,\n  IntegerValue,\n  StringValue,\n  type ValueType\n} from '@kiberon-labs/behave-graph';\n\nimport { ColorValue } from '../../Values/ColorValue.js';\nimport { EulerValue } from '../../Values/EulerValue.js';\nimport { QuatValue } from '../../Values/QuatValue.js';\nimport { Vec2Value } from '../../Values/Vec2Value.js';\nimport { Vec3Value } from '../../Values/Vec3Value.js';\nimport { Vec4Value } from '../../Values/Vec4Value.js';\nimport type { GeometryType, IScene, LightType } from '../IScene.js';\n\nexport class DummyScene implements IScene {\n  public onSceneChanged = new EventEmitter<void>();\n\n  private valueRegistry: Record<string, ValueType>;\n\n  constructor() {\n    this.valueRegistry = Object.fromEntries(\n      [\n        BooleanValue,\n        StringValue,\n        IntegerValue,\n        FloatValue,\n        Vec2Value,\n        Vec3Value,\n        Vec4Value,\n        ColorValue,\n        EulerValue,\n        QuatValue\n      ].map((valueType) => [valueType.name, valueType])\n    );\n    // pull in value type nodes\n  }\n\n  getProperty(jsonPath: string, valueTypeName: string): unknown {\n    return this.valueRegistry[valueTypeName]?.creator();\n  }\n  setProperty(): void {\n    this.onSceneChanged.emit();\n  }\n  addOnClickedListener(\n    jsonPath: string,\n    callback: (jsonPath: string) => void\n  ): void {\n    console.log('added on clicked listener');\n  }\n  removeOnClickedListener(\n    jsonPath: string,\n    callback: (jsonPath: string) => void\n  ): void {\n    console.log('removed on clicked listener');\n  }\n\n  getQueryableProperties() {\n    return [];\n  }\n\n  getRaycastableProperties() {\n    return [];\n  }\n\n  getProperties() {\n    return [];\n  }\n\n  addOnSceneChangedListener() {\n    console.log('added on scene changed listener');\n  }\n\n  removeOnSceneChangedListener(): void {\n    console.log('removed on scene changed listener');\n  }\n\n  // --- mesh lifecycle ---\n  createMesh(\n    _name: string,\n    _geometryType: GeometryType,\n    _size: { x: number; y: number; z: number }\n  ): void {\n    console.log('created mesh (dummy)');\n  }\n\n  deleteMesh(_name: string): void {\n    console.log('deleted mesh (dummy)');\n  }\n\n  getMeshNames() {\n    return [];\n  }\n\n  // --- lighting ---\n  addLight(\n    _name: string,\n    _lightType: LightType,\n    _color: { r: number; g: number; b: number },\n    _intensity: number\n  ): void {\n    console.log('added light (dummy)');\n  }\n\n  removeLight(_name: string): void {\n    console.log('removed light (dummy)');\n  }\n\n  setLightProperty(_name: string, _property: string, _value: unknown): void {\n    console.log('set light property (dummy)');\n  }\n\n  getLightProperty(_name: string, _property: string): unknown {\n    return undefined;\n  }\n\n  getLightNames() {\n    return [];\n  }\n\n  // --- material ---\n  setMaterialProperty(\n    _meshName: string,\n    _property: string,\n    _value: unknown\n  ): void {\n    console.log('set material property (dummy)');\n  }\n\n  getMaterialProperty(_meshName: string, _property: string): unknown {\n    return undefined;\n  }\n\n  // --- global click ---\n  addOnAnyMeshClickedListener(_callback: (meshName: string) => void): void {\n    console.log('added on any mesh clicked listener (dummy)');\n  }\n\n  removeOnAnyMeshClickedListener(_callback: (meshName: string) => void): void {\n    console.log('removed on any mesh clicked listener (dummy)');\n  }\n\n  // --- spatial helpers ---\n  getMeshPosition(\n    _meshName: string\n  ): { x: number; y: number; z: number } | undefined {\n    return { x: 0, y: 0, z: 0 };\n  }\n\n  setMeshPosition(\n    _meshName: string,\n    _position: { x: number; y: number; z: number }\n  ): void {\n    console.log('set mesh position (dummy)');\n  }\n\n  getDistanceBetween(_meshA: string, _meshB: string): number {\n    return 0;\n  }\n\n  lookAt(\n    _meshName: string,\n    _target: { x: number; y: number; z: number }\n  ): void {\n    console.log('lookAt (dummy)');\n  }\n\n  moveTowards(\n    _meshName: string,\n    _target: { x: number; y: number; z: number },\n    _speed: number,\n    _deltaSeconds: number\n  ): boolean {\n    return true;\n  }\n\n  // --- mesh utilities ---\n  cloneMesh(_sourceName: string, _newName: string): void {\n    console.log('cloned mesh (dummy)');\n  }\n\n  setMeshVisible(_meshName: string, _visible: boolean): void {\n    console.log('set mesh visible (dummy)');\n  }\n}\n"],"mappings":";;;;;;;;;AAiBA,IAAa,aAAb,MAA0C;CACxC,AAAO,iBAAiB,IAAI,cAAoB;CAEhD,AAAQ;CAER,cAAc;AACZ,OAAK,gBAAgB,OAAO,YAC1B;GACE;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACD,CAAC,KAAK,cAAc,CAAC,UAAU,MAAM,UAAU,CAAC,CAClD;;CAIH,YAAY,UAAkB,eAAgC;AAC5D,SAAO,KAAK,cAAc,gBAAgB,SAAS;;CAErD,cAAoB;AAClB,OAAK,eAAe,MAAM;;CAE5B,qBACE,UACA,UACM;AACN,UAAQ,IAAI,4BAA4B;;CAE1C,wBACE,UACA,UACM;AACN,UAAQ,IAAI,8BAA8B;;CAG5C,yBAAyB;AACvB,SAAO,EAAE;;CAGX,2BAA2B;AACzB,SAAO,EAAE;;CAGX,gBAAgB;AACd,SAAO,EAAE;;CAGX,4BAA4B;AAC1B,UAAQ,IAAI,kCAAkC;;CAGhD,+BAAqC;AACnC,UAAQ,IAAI,oCAAoC;;CAIlD,WACE,OACA,eACA,OACM;AACN,UAAQ,IAAI,uBAAuB;;CAGrC,WAAW,OAAqB;AAC9B,UAAQ,IAAI,uBAAuB;;CAGrC,eAAe;AACb,SAAO,EAAE;;CAIX,SACE,OACA,YACA,QACA,YACM;AACN,UAAQ,IAAI,sBAAsB;;CAGpC,YAAY,OAAqB;AAC/B,UAAQ,IAAI,wBAAwB;;CAGtC,iBAAiB,OAAe,WAAmB,QAAuB;AACxE,UAAQ,IAAI,6BAA6B;;CAG3C,iBAAiB,OAAe,WAA4B;CAI5D,gBAAgB;AACd,SAAO,EAAE;;CAIX,oBACE,WACA,WACA,QACM;AACN,UAAQ,IAAI,gCAAgC;;CAG9C,oBAAoB,WAAmB,WAA4B;CAKnE,4BAA4B,WAA6C;AACvE,UAAQ,IAAI,6CAA6C;;CAG3D,+BAA+B,WAA6C;AAC1E,UAAQ,IAAI,+CAA+C;;CAI7D,gBACE,WACiD;AACjD,SAAO;GAAE,GAAG;GAAG,GAAG;GAAG,GAAG;GAAG;;CAG7B,gBACE,WACA,WACM;AACN,UAAQ,IAAI,4BAA4B;;CAG1C,mBAAmB,QAAgB,QAAwB;AACzD,SAAO;;CAGT,OACE,WACA,SACM;AACN,UAAQ,IAAI,iBAAiB;;CAG/B,YACE,WACA,SACA,QACA,eACS;AACT,SAAO;;CAIT,UAAU,aAAqB,UAAwB;AACrD,UAAQ,IAAI,sBAAsB;;CAGpC,eAAe,WAAmB,UAAyB;AACzD,UAAQ,IAAI,2BAA2B"}

package/dist/Abstractions/IScene.d.ts

@@ -0,0 +1,75 @@
+import { Choices } from "@kiberon-labs/behave-graph";
+
+//#region src/Abstractions/IScene.d.ts
+declare const GeometryType: {
+  readonly Box: "box";
+  readonly Sphere: "sphere";
+  readonly Cylinder: "cylinder";
+  readonly Torus: "torus";
+  readonly Plane: "plane";
+  readonly Cone: "cone";
+};
+type GeometryType = (typeof GeometryType)[keyof typeof GeometryType];
+declare const LightType: {
+  readonly Point: "point";
+  readonly Directional: "directional";
+  readonly Spot: "spot";
+  readonly Ambient: "ambient";
+};
+type LightType = (typeof LightType)[keyof typeof LightType];
+interface IScene {
+  getProperty(jsonPath: string, valueTypeName: string): unknown;
+  setProperty(jsonPath: string, valueTypeName: string, value: unknown): void;
+  addOnClickedListener(jsonPath: string, callback: (jsonPath: string) => void): void;
+  removeOnClickedListener(jsonPath: string, callback: (jsonPath: string) => void): void;
+  getRaycastableProperties: () => Choices;
+  getProperties: (valueFilter?: string) => Choices;
+  addOnSceneChangedListener(listener: () => void): void;
+  removeOnSceneChangedListener(listener: () => void): void;
+  createMesh(name: string, geometryType: GeometryType, size: {
+    x: number;
+    y: number;
+    z: number;
+  }): void;
+  deleteMesh(name: string): void;
+  getMeshNames: () => Choices;
+  addLight(name: string, lightType: LightType, color: {
+    r: number;
+    g: number;
+    b: number;
+  }, intensity: number): void;
+  removeLight(name: string): void;
+  setLightProperty(name: string, property: string, value: unknown): void;
+  getLightProperty(name: string, property: string): unknown;
+  getLightNames: () => Choices;
+  setMaterialProperty(meshName: string, property: string, value: unknown): void;
+  getMaterialProperty(meshName: string, property: string): unknown;
+  addOnAnyMeshClickedListener(callback: (meshName: string) => void): void;
+  removeOnAnyMeshClickedListener(callback: (meshName: string) => void): void;
+  getMeshPosition(meshName: string): {
+    x: number;
+    y: number;
+    z: number;
+  } | undefined;
+  setMeshPosition(meshName: string, position: {
+    x: number;
+    y: number;
+    z: number;
+  }): void;
+  getDistanceBetween(meshA: string, meshB: string): number;
+  lookAt(meshName: string, target: {
+    x: number;
+    y: number;
+    z: number;
+  }): void;
+  moveTowards(meshName: string, target: {
+    x: number;
+    y: number;
+    z: number;
+  }, speed: number, deltaSeconds: number): boolean;
+  cloneMesh(sourceName: string, newName: string): void;
+  setMeshVisible(meshName: string, visible: boolean): void;
+}
+//#endregion
+export { GeometryType, IScene, LightType };
+//# sourceMappingURL=IScene.d.ts.map

package/dist/Abstractions/IScene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IScene.d.ts","names":[],"sources":["../../src/Abstractions/IScene.ts"],"sourcesContent":[],"mappings":";;;cAEa;;EAAA,SAAA,MAOH,EAAA,QAAA;EAEE,SAAA,QAAY,EAAA,UAAW;EAEtB,SAAA,KAKH,EAAA,OAAA;EAEE,SAAA,KAAS,EAAA,OAAA;EAEJ,SAAM,IAAA,EAAA,MAAA;CAYW;AACS,KAxB/B,YAAA,GAwB+B,CAAA,OAxBR,YAwBQ,CAAA,CAAA,MAAA,OAxBmB,YAwBnB,CAAA;AAOzB,cA7BL,SA6BK,EAAA;EAII,SAAA,KAAA,EAAA,OAAA;EAKP,SAAA,WAAA,EAAA,aAAA;EAOQ,SAAA,IAAA,EAAA,MAAA;EAAO,SAAA,OAAA,EAAA,SAAA;;KAtClB,SAAA,WAAoB,wBAAwB;UAEvC,MAAA;;;;;kCAYiB;2CACS;;;yCAOzB;;;;;;sBAII;oCAKP;;;;;;;;uBAOQ"}

package/dist/Abstractions/IScene.js

@@ -0,0 +1,19 @@
+//#region src/Abstractions/IScene.ts
+const GeometryType = {
+	Box: "box",
+	Sphere: "sphere",
+	Cylinder: "cylinder",
+	Torus: "torus",
+	Plane: "plane",
+	Cone: "cone"
+};
+const LightType = {
+	Point: "point",
+	Directional: "directional",
+	Spot: "spot",
+	Ambient: "ambient"
+};
+
+//#endregion
+export { GeometryType, LightType };
+//# sourceMappingURL=IScene.js.map

package/dist/Abstractions/IScene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IScene.js","names":[],"sources":["../../src/Abstractions/IScene.ts"],"sourcesContent":["import type { Choices } from '@kiberon-labs/behave-graph';\n\nexport const GeometryType = {\n  Box: 'box',\n  Sphere: 'sphere',\n  Cylinder: 'cylinder',\n  Torus: 'torus',\n  Plane: 'plane',\n  Cone: 'cone'\n} as const;\n\nexport type GeometryType = (typeof GeometryType)[keyof typeof GeometryType];\n\nexport const LightType = {\n  Point: 'point',\n  Directional: 'directional',\n  Spot: 'spot',\n  Ambient: 'ambient'\n} as const;\n\nexport type LightType = (typeof LightType)[keyof typeof LightType];\n\nexport interface IScene {\n  // --- existing property accessors ---\n  getProperty(jsonPath: string, valueTypeName: string): unknown;\n  setProperty(jsonPath: string, valueTypeName: string, value: unknown): void;\n  addOnClickedListener(\n    jsonPath: string,\n    callback: (jsonPath: string) => void\n  ): void;\n  removeOnClickedListener(\n    jsonPath: string,\n    callback: (jsonPath: string) => void\n  ): void;\n  getRaycastableProperties: () => Choices;\n  getProperties: (valueFilter?: string) => Choices;\n  addOnSceneChangedListener(listener: () => void): void;\n  removeOnSceneChangedListener(listener: () => void): void;\n\n  // --- mesh lifecycle ---\n  createMesh(\n    name: string,\n    geometryType: GeometryType,\n    size: { x: number; y: number; z: number }\n  ): void;\n  deleteMesh(name: string): void;\n  getMeshNames: () => Choices;\n\n  // --- lighting ---\n  addLight(\n    name: string,\n    lightType: LightType,\n    color: { r: number; g: number; b: number },\n    intensity: number\n  ): void;\n  removeLight(name: string): void;\n  setLightProperty(name: string, property: string, value: unknown): void;\n  getLightProperty(name: string, property: string): unknown;\n  getLightNames: () => Choices;\n\n  // --- material ---\n  setMaterialProperty(meshName: string, property: string, value: unknown): void;\n  getMaterialProperty(meshName: string, property: string): unknown;\n\n  // --- global click (returns which mesh was hit) ---\n  addOnAnyMeshClickedListener(callback: (meshName: string) => void): void;\n  removeOnAnyMeshClickedListener(callback: (meshName: string) => void): void;\n\n  // --- spatial helpers ---\n  getMeshPosition(\n    meshName: string\n  ): { x: number; y: number; z: number } | undefined;\n  setMeshPosition(\n    meshName: string,\n    position: { x: number; y: number; z: number }\n  ): void;\n  getDistanceBetween(meshA: string, meshB: string): number;\n  lookAt(meshName: string, target: { x: number; y: number; z: number }): void;\n  moveTowards(\n    meshName: string,\n    target: { x: number; y: number; z: number },\n    speed: number,\n    deltaSeconds: number\n  ): boolean; // returns true when arrived\n\n  // --- mesh utilities ---\n  cloneMesh(sourceName: string, newName: string): void;\n  setMeshVisible(meshName: string, visible: boolean): void;\n}\n"],"mappings":";AAEA,MAAa,eAAe;CAC1B,KAAK;CACL,QAAQ;CACR,UAAU;CACV,OAAO;CACP,OAAO;CACP,MAAM;CACP;AAID,MAAa,YAAY;CACvB,OAAO;CACP,aAAa;CACb,MAAM;CACN,SAAS;CACV"}

package/dist/GLTFJson.d.ts

@@ -0,0 +1,33 @@
+//#region src/GLTFJson.d.ts
+type GLTFAssetJson = {
+  generator: string;
+  version: string;
+};
+type GLTFSceneJson = {
+  name: string;
+  nodes: number[];
+};
+type GLTFNodeJson = {
+  name?: string;
+  mesh?: number;
+  translation?: number[];
+  children?: number[];
+};
+type GLTFMaterialJson = {
+  name?: string;
+  doubleSided?: boolean;
+};
+type GLTFMeshJson = {
+  name?: string;
+};
+type GLTFJson = {
+  asset: GLTFAssetJson;
+  scene: number;
+  scenes: GLTFSceneJson[];
+  nodes: GLTFNodeJson[];
+  materials: GLTFMaterialJson[];
+  meshes: GLTFMeshJson[];
+};
+//#endregion
+export { GLTFJson };
+//# sourceMappingURL=GLTFJson.d.ts.map

package/dist/GLTFJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GLTFJson.d.ts","names":[],"sources":["../src/GLTFJson.ts"],"sourcesContent":[],"mappings":";KAAY,aAAA;EAAA,SAAA,EAAA,MAAa;EAKb,OAAA,EAAA,MAAA;AAKZ,CAAA;AAOY,KAZA,aAAA,GAYgB;EAKhB,IAAA,EAAA,MAAA;EAIA,KAAA,EAAA,MAAQ,EAAA;CACX;AAEC,KAnBE,YAAA,GAmBF;EACD,IAAA,CAAA,EAAA,MAAA;EACI,IAAA,CAAA,EAAA,MAAA;EACH,WAAA,CAAA,EAAA,MAAA,EAAA;EAAY,QAAA,CAAA,EAAA,MAAA,EAAA;;KAfV,gBAAA;;;;KAKA,YAAA;;;KAIA,QAAA;SACH;;UAEC;SACD;aACI;UACH"}

package/dist/Nodes/Actions/AddLight.d.ts

@@ -0,0 +1,21 @@
+import * as _kiberon_labs_behave_graph5 from "@kiberon-labs/behave-graph";
+
+//#region src/Nodes/Actions/AddLight.d.ts
+declare const AddLight: _kiberon_labs_behave_graph5.IFlowNodeDefinition<{
+  flow: string;
+  name: string;
+  lightType: (_: _kiberon_labs_behave_graph5.NodeConfiguration) => {
+    valueType: string;
+    choices: {
+      text: "point" | "directional" | "spot" | "ambient";
+      value: "point" | "directional" | "spot" | "ambient";
+    }[];
+  };
+  color: string;
+  intensity: string;
+}, {
+  flow: string;
+}, _kiberon_labs_behave_graph5.NodeConfigurationDescription, undefined>;
+//#endregion
+export { AddLight };
+//# sourceMappingURL=AddLight.d.ts.map

package/dist/Nodes/Actions/AddLight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddLight.d.ts","names":[],"sources":["../../../src/Nodes/Actions/AddLight.ts"],"sourcesContent":[],"mappings":";;;cAYa,sCAAQ;;;EAAR,SAAA,EAiCX,CAAA,CAAA,EAAA,2BAAA,CAAA,iBAAA,EAAA,GAAA;IAAA,SAAA,EAAA,MAAA;;mCAjCmB,GAAA,MAAA,GAAA,SAAA;MAAA,KAAA,EAAA,OAAA,GAAA,aAAA,GAAA,MAAA,GAAA,SAAA"}

package/dist/Nodes/Actions/AddLight.js

@@ -0,0 +1,38 @@
+import { LightType } from "../../Abstractions/IScene.js";
+import { NodeCategory, makeFlowNodeDefinition } from "@kiberon-labs/behave-graph";
+
+//#region src/Nodes/Actions/AddLight.ts
+const lightTypeChoices = Object.values(LightType).map((v) => ({
+	text: v,
+	value: v
+}));
+const AddLight = makeFlowNodeDefinition({
+	typeName: "scene/addLight",
+	category: NodeCategory.Effect,
+	label: "Add Light",
+	in: {
+		flow: "flow",
+		name: "string",
+		lightType: (_) => ({
+			valueType: "string",
+			choices: lightTypeChoices
+		}),
+		color: "color",
+		intensity: "float"
+	},
+	out: { flow: "flow" },
+	initialState: void 0,
+	triggered: ({ commit, read, graph }) => {
+		const scene = graph.getDependency("IScene");
+		const name = read("name");
+		const lightType = read("lightType");
+		const color = read("color");
+		const intensity = read("intensity");
+		scene?.addLight(name, lightType, color, intensity);
+		commit("flow");
+	}
+});
+
+//#endregion
+export { AddLight };
+//# sourceMappingURL=AddLight.js.map

package/dist/Nodes/Actions/AddLight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddLight.js","names":[],"sources":["../../../src/Nodes/Actions/AddLight.ts"],"sourcesContent":["import {\n  makeFlowNodeDefinition,\n  NodeCategory\n} from '@kiberon-labs/behave-graph';\n\nimport { LightType } from '../../Abstractions/IScene.js';\n\nconst lightTypeChoices = Object.values(LightType).map((v) => ({\n  text: v,\n  value: v\n}));\n\nexport const AddLight = makeFlowNodeDefinition({\n  typeName: 'scene/addLight',\n  category: NodeCategory.Effect,\n  label: 'Add Light',\n  in: {\n    flow: 'flow',\n    name: 'string',\n    lightType: (_) => ({\n      valueType: 'string',\n      choices: lightTypeChoices\n    }),\n    color: 'color',\n    intensity: 'float'\n  },\n  out: {\n    flow: 'flow'\n  },\n  initialState: undefined,\n  triggered: ({ commit, read, graph }) => {\n    const scene = graph.getDependency('IScene');\n    const name = read<string>('name');\n    const lightType = read<string>('lightType');\n    const color = read<{ r: number; g: number; b: number }>('color');\n    const intensity = read<number>('intensity');\n\n    scene?.addLight(\n      name,\n      lightType as (typeof LightType)[keyof typeof LightType],\n      color,\n      intensity\n    );\n    commit('flow');\n  }\n});\n"],"mappings":";;;;AAOA,MAAM,mBAAmB,OAAO,OAAO,UAAU,CAAC,KAAK,OAAO;CAC5D,MAAM;CACN,OAAO;CACR,EAAE;AAEH,MAAa,WAAW,uBAAuB;CAC7C,UAAU;CACV,UAAU,aAAa;CACvB,OAAO;CACP,IAAI;EACF,MAAM;EACN,MAAM;EACN,YAAY,OAAO;GACjB,WAAW;GACX,SAAS;GACV;EACD,OAAO;EACP,WAAW;EACZ;CACD,KAAK,EACH,MAAM,QACP;CACD,cAAc;CACd,YAAY,EAAE,QAAQ,MAAM,YAAY;EACtC,MAAM,QAAQ,MAAM,cAAc,SAAS;EAC3C,MAAM,OAAO,KAAa,OAAO;EACjC,MAAM,YAAY,KAAa,YAAY;EAC3C,MAAM,QAAQ,KAA0C,QAAQ;EAChE,MAAM,YAAY,KAAa,YAAY;AAE3C,SAAO,SACL,MACA,WACA,OACA,UACD;AACD,SAAO,OAAO;;CAEjB,CAAC"}

package/dist/Nodes/Actions/CloneMesh.d.ts

@@ -0,0 +1,16 @@
+import * as _kiberon_labs_behave_graph8 from "@kiberon-labs/behave-graph";
+
+//#region src/Nodes/Actions/CloneMesh.d.ts
+declare const CloneMesh: _kiberon_labs_behave_graph8.IFlowNodeDefinition<{
+  flow: string;
+  sourceName: (_: _kiberon_labs_behave_graph8.NodeConfiguration, graphApi: _kiberon_labs_behave_graph8.IGraph) => {
+    valueType: string;
+    choices: _kiberon_labs_behave_graph8.Choices | undefined;
+  };
+  newName: string;
+}, {
+  flow: string;
+}, _kiberon_labs_behave_graph8.NodeConfigurationDescription, undefined>;
+//#endregion
+export { CloneMesh };
+//# sourceMappingURL=CloneMesh.d.ts.map

package/dist/Nodes/Actions/CloneMesh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloneMesh.d.ts","names":[],"sources":["../../../src/Nodes/Actions/CloneMesh.ts"],"sourcesContent":[],"mappings":";;;cAMa,uCAAS;;kBAwBpB,2BAAA,CAAA;IAxBW,SAwBX,EAAA,MAAA;IAAA,OAAA,wCAAA,SAAA;;;;;CAxBoB,4DAAA,SAAA,CAAA"}

package/dist/Nodes/Actions/CloneMesh.js

@@ -0,0 +1,28 @@
+import { NodeCategory, makeFlowNodeDefinition } from "@kiberon-labs/behave-graph";
+
+//#region src/Nodes/Actions/CloneMesh.ts
+const CloneMesh = makeFlowNodeDefinition({
+	typeName: "scene/cloneMesh",
+	category: NodeCategory.Effect,
+	label: "Clone Mesh",
+	in: {
+		flow: "flow",
+		sourceName: (_, graphApi) => {
+			return {
+				valueType: "string",
+				choices: graphApi.getDependency("IScene")?.getMeshNames()
+			};
+		},
+		newName: "string"
+	},
+	out: { flow: "flow" },
+	initialState: void 0,
+	triggered: ({ commit, read, graph }) => {
+		graph.getDependency("IScene")?.cloneMesh(read("sourceName"), read("newName"));
+		commit("flow");
+	}
+});
+
+//#endregion
+export { CloneMesh };
+//# sourceMappingURL=CloneMesh.js.map

package/dist/Nodes/Actions/CloneMesh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloneMesh.js","names":[],"sources":["../../../src/Nodes/Actions/CloneMesh.ts"],"sourcesContent":["import {\n  makeFlowNodeDefinition,\n  NodeCategory\n} from '@kiberon-labs/behave-graph';\n\n// Clone an existing mesh under a new name.\nexport const CloneMesh = makeFlowNodeDefinition({\n  typeName: 'scene/cloneMesh',\n  category: NodeCategory.Effect,\n  label: 'Clone Mesh',\n  in: {\n    flow: 'flow',\n    sourceName: (_, graphApi) => {\n      const scene = graphApi.getDependency('IScene');\n      return {\n        valueType: 'string',\n        choices: scene?.getMeshNames()\n      };\n    },\n    newName: 'string'\n  },\n  out: {\n    flow: 'flow'\n  },\n  initialState: undefined,\n  triggered: ({ commit, read, graph }) => {\n    const scene = graph.getDependency('IScene');\n    scene?.cloneMesh(read<string>('sourceName'), read<string>('newName'));\n    commit('flow');\n  }\n});\n"],"mappings":";;;AAMA,MAAa,YAAY,uBAAuB;CAC9C,UAAU;CACV,UAAU,aAAa;CACvB,OAAO;CACP,IAAI;EACF,MAAM;EACN,aAAa,GAAG,aAAa;AAE3B,UAAO;IACL,WAAW;IACX,SAHY,SAAS,cAAc,SAAS,EAG5B,cAAc;IAC/B;;EAEH,SAAS;EACV;CACD,KAAK,EACH,MAAM,QACP;CACD,cAAc;CACd,YAAY,EAAE,QAAQ,MAAM,YAAY;AAEtC,EADc,MAAM,cAAc,SAAS,EACpC,UAAU,KAAa,aAAa,EAAE,KAAa,UAAU,CAAC;AACrE,SAAO,OAAO;;CAEjB,CAAC"}

package/dist/Nodes/Actions/CreateMesh.d.ts

@@ -0,0 +1,22 @@
+import * as _kiberon_labs_behave_graph13 from "@kiberon-labs/behave-graph";
+
+//#region src/Nodes/Actions/CreateMesh.d.ts
+declare const CreateMesh: _kiberon_labs_behave_graph13.IFlowNodeDefinition<{
+  flow: string;
+  name: string;
+  geometryType: (_: _kiberon_labs_behave_graph13.NodeConfiguration) => {
+    valueType: string;
+    choices: {
+      text: "box" | "sphere" | "cylinder" | "torus" | "plane" | "cone";
+      value: "box" | "sphere" | "cylinder" | "torus" | "plane" | "cone";
+    }[];
+  };
+  sizeX: string;
+  sizeY: string;
+  sizeZ: string;
+}, {
+  flow: string;
+}, _kiberon_labs_behave_graph13.NodeConfigurationDescription, undefined>;
+//#endregion
+export { CreateMesh };
+//# sourceMappingURL=CreateMesh.d.ts.map

package/dist/Nodes/Actions/CreateMesh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateMesh.d.ts","names":[],"sources":["../../../src/Nodes/Actions/CreateMesh.ts"],"sourcesContent":[],"mappings":";;;cAYa,yCAAU;;;EAAV,YAAA,EAkCX,CAAA,CAAA,EAAA,4BAAA,CAAA,iBAAA,EAAA,GAAA;IAAA,SAAA,EAAA,MAAA;;4BAlCqB,GAAA,UAAA,GAAA,OAAA,GAAA,OAAA,GAAA,MAAA;MAAA,KAAA,EAAA,KAAA,GAAA,QAAA,GAAA,UAAA,GAAA,OAAA,GAAA,OAAA,GAAA,MAAA"}