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

package/dist/buildScene.d.ts

@@ -0,0 +1,74 @@
+import { IScene } from "./Abstractions/IScene.js";
+import { GLTFJson } from "./GLTFJson.js";
+import { Choices } from "@kiberon-labs/behave-graph";
+import { Material, Object3D } from "three";
+import { GLTF } from "three-stdlib";
+
+//#region src/buildScene.d.ts
+declare const Resource: {
+  readonly nodes: "nodes";
+  readonly materials: "materials";
+  readonly animations: "animations";
+};
+type Resource = (typeof Resource)[keyof typeof Resource];
+declare type ObjectMap = {
+  nodes: {
+    [name: string]: Object3D;
+  };
+  materials: {
+    [name: string]: Material;
+  };
+};
+type Optional<T> = { [K in keyof T]: T[K] | undefined };
+type Path = {
+  resource: Resource;
+  index: number;
+  property: string;
+};
+declare function toJsonPathString({
+  index,
+  property,
+  resource: resourceType
+}: Optional<Path>, short: boolean): string | undefined;
+declare function parseJsonPath(jsonPath: string, short?: boolean): Path;
+declare function applyPropertyToModel({
+  resource,
+  index,
+  property
+}: Path, gltf: GLTF & ObjectMap, value: any, properties: Properties, setActiveAnimations: ((animation: string, active: boolean) => void) | undefined): void;
+type ResourceOption = {
+  name: string;
+  index: number;
+};
+type ResourceProperties = {
+  options: ResourceOption[];
+  properties: string[];
+};
+type Properties = { [key in Resource]?: ResourceProperties };
+type ParsableScene = GLTF & ObjectMap & {
+  json?: GLTFJson;
+};
+declare const extractProperties: (gltf: ParsableScene) => Properties;
+declare function generateSettableChoices(properties: Properties): Choices;
+declare function generateRaycastableChoices(properties: Properties): Choices;
+type OnClickCallback = (jsonPath: string) => void;
+type OnClickListener = {
+  path: Path;
+  elementName: string;
+  callbacks: OnClickCallback[];
+};
+type OnClickListeners = {
+  [jsonPath: string]: OnClickListener;
+};
+declare const buildScene: ({
+  gltf,
+  setOnClickListeners,
+  setActiveAnimations
+}: {
+  gltf: GLTF & ObjectMap;
+  setOnClickListeners: ((cb: (existing: OnClickListeners) => OnClickListeners) => void) | undefined;
+  setActiveAnimations: ((animation: string, active: boolean) => void) | undefined;
+}) => IScene;
+//#endregion
+export { ObjectMap, OnClickCallback, OnClickListener, OnClickListeners, Optional, ParsableScene, Path, ResourceOption, ResourceProperties, applyPropertyToModel, buildScene, extractProperties, generateRaycastableChoices, generateSettableChoices, parseJsonPath, toJsonPathString };
+//# sourceMappingURL=buildScene.d.ts.map

package/dist/buildScene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildScene.d.ts","names":[],"sources":["../src/buildScene.ts"],"sourcesContent":[],"mappings":";;;;;;;cAiBM;;EAAA,SAAA,SAII,EAAA,WAAA;EAEL,SAAA,UAAQ,EAAA,YAAW;AASxB,CAAA;AAaA,KAtBK,QAAA,GAsBe,CAAA,OAtBI,QAsBJ,CAAA,CAAA,MAAA,OAtB2B,QAsB3B,CAAA;AACN,aAdM,SAAA,GAcN;EAAI,KAAA,EAAA;IAAE,CAAA,IAAA,EAAA,MAAA,CAAA,EAZA,QAYA;EAAC,CAAA;EAGT,SAAI,EAAA;IAMA,CAAA,IAAA,EAAA,MAAA,CAAA,EAlBI,QAkBY;EAC5B,CAAA;CAAO;AAAoB,KAXnB,QAWmB,CAAA,CAAA,CAAA,GAAA,QAAyB,MAV1C,CAU0C,GAVtC,CAUsC,CAVpC,CAUoC,CAAA,GAAA,SAAA,EAAT;AAAQ,KAP3C,IAAA,GAO2C;EAYvC,QAAA,EAlBJ,QAkBiB;EAcb,KAAA,EAAA,MAAA;EACZ,QAAA,EAAA,MAAA;CAAU;AAAO,iBA5BL,gBAAA,CA4BK;EAAA,KAAA;EAAA,QAAA;EAAA,QAAA,EA3BU;AA2BV,CAAA,EA3B0B,QA2B1B,CA3BmC,IA2BnC,CAAA,EAAA,KAAA,EAAA,OAAA,CAAA,EAAA,MAAA,GAAA,SAAA;AAAY,iBAfjB,aAAA,CAeiB,QAAA,EAAA,MAAA,EAAA,KAAA,CAAA,EAAA,OAAA,CAAA,EAf+B,IAe/B;AACzB,iBAFQ,oBAAA,CAER;EAAA,QAAA;EAAA,KAAA;EAAA;AAAA,CAAA,EADyB,IACzB,EAAA,IAAA,EAAA,IAAA,GAAO,SAAP,EAAA,KAAA,EAAA,GAAA,EAAA,UAAA,EAEM,UAFN,EAAA,mBAAA,EAAA,CAAA,CAAA,SAAA,EAAA,MAAA,EAAA,MAAA,EAAA,OAAA,EAAA,GAAA,IAAA,CAAA,GAAA,SAAA,CAAA,EAAA,IAAA;AAAO,KA2IH,cAAA,GA3IG;EAED,IAAA,EAAA,MAAA;EAAU,KAAA,EAAA,MAAA;AAyIxB,CAAA;AAKY,KAAA,kBAAA,GAAkB;EAKzB,OAAA,EAJM,cAII,EAAA;EAIH,UAAA,EAAA,MAAa,EAAA;CAAG;KAJvB,UAAA,GAKH,UAJQ,QAKC,IALW,kBAKX,EAAQ;AAGN,KALD,aAAA,GAAgB,IAkD3B,GAjDC,SAIsC,GAAA;EA2ExB,IAAA,CAAA,EA9EL,QA8EK;AAUhB,CAAA;AAaY,cAlGC,iBAkGc,EAAA,CAAA,IAAA,EAlGa,aAkGb,EAAA,GAlG6B,UAkG7B;AAEf,iBAzBI,uBAAA,CA4BH,UAAe,EA5BwB,UA4BxB,CAAA,EA5BqC,OA4BrC;AAGhB,iBArBI,0BAAA,CAsBM,UAAe,EAtBkB,UAsBlB,CAAA,EAtB+B,OAsB/B;AAGxB,KAZD,eAAA,GA4KX,CAAA,QAAA,EAAA,MAAA,EAAA,GAAA,IAAA;AAhK0B,KAVf,eAAA,GAUe;EAAA,IAAA,EATnB,IASmB;EAAA,WAAA,EAAA,MAAA;EAKnB,SAAA,EAZK,eAYL,EAAA;CAAO;AAEQ,KAXX,gBAAA,GAWW;EAAqB,CAAA,QAAA,EAAA,MAAA,CAAA,EAVtB,eAUsB;CAK3C;AAoJA,cAhKY,UAgKZ,EAAA,CAAA;EAAA,IAAA;EAAA,mBAAA;EAAA;CAAA,EAAA;QA3JO,OAAO;wCAEQ,qBAAqB;;MAK3C"}

package/dist/buildScene.js

@@ -0,0 +1,304 @@
+import { Vec3 } from "./Values/Internal/Vec3.js";
+import { Vec4 } from "./Values/Internal/Vec4.js";
+import { EventEmitter } from "@kiberon-labs/behave-graph";
+import { Material, Object3D } from "three";
+
+//#region src/buildScene.ts
+const Resource = {
+	nodes: "nodes",
+	materials: "materials",
+	animations: "animations"
+};
+function toVec3(value) {
+	return new Vec3(value.x, value.y, value.z);
+}
+function toVec4(value) {
+	return new Vec4(value.x, value.y, value.z, value.w);
+}
+const shortPathRegEx = /^\/?(?<resource>[^/]+)\/(?<index>\d+)$/;
+const jsonPathRegEx = /^\/?(?<resource>[^/]+)\/(?<index>\d+)\/(?<property>[^/]+)$/;
+function toJsonPathString({ index, property, resource: resourceType }, short) {
+	if (short) {
+		if (!resourceType || index === void 0) return;
+		return `${resourceType}/${index}`;
+	} else {
+		if (!resourceType || index === void 0 || !property) return;
+		return `${resourceType}/${index}/${property}`;
+	}
+}
+function parseJsonPath(jsonPath, short = false) {
+	const matches = (short ? shortPathRegEx : jsonPathRegEx).exec(jsonPath);
+	if (matches === null) throw new Error(`can not parse jsonPath: ${jsonPath}`);
+	if (matches.groups === void 0) throw new Error(`can not parse jsonPath (no groups): ${jsonPath}`);
+	return {
+		resource: matches.groups.resource,
+		index: +matches.groups.index,
+		property: matches.groups.property
+	};
+}
+function applyPropertyToModel({ resource, index, property }, gltf, value, properties, setActiveAnimations) {
+	const nodeName = getResourceName({
+		resource,
+		index
+	}, properties);
+	if (!nodeName) throw new Error(`could not get node at index ${index}`);
+	if (resource === Resource.nodes) {
+		const node = gltf.nodes[nodeName];
+		if (!node) {
+			console.error(`no node at path ${nodeName}`);
+			return;
+		}
+		applyNodeModifier(property, node, value);
+		return;
+	}
+	if (resource === Resource.materials) {
+		const node = gltf.materials[nodeName];
+		if (!node) {
+			console.error(`no node at path ${nodeName}`);
+			return;
+		}
+		applyMaterialModifier(property, node, value);
+		return;
+	}
+	if (resource === Resource.animations) {
+		if (!setActiveAnimations) {
+			console.error("cannot apply animation property without setActiveAnimations");
+			return;
+		}
+		setActiveAnimations(nodeName, value);
+		return;
+	}
+	console.error(`unknown resource type ${resource}`);
+}
+const getResourceName = ({ resource, index }, properties) => {
+	return properties[resource]?.options[index]?.name;
+};
+const getPropertyFromModel = ({ resource, index, property }, gltf, properties) => {
+	if (resource === Resource.nodes) {
+		const nodeName = getResourceName({
+			resource,
+			index
+		}, properties);
+		if (!nodeName) throw new Error(`could not get node at index ${index}`);
+		const node = gltf.nodes[nodeName];
+		if (!node) {
+			console.error(`no node at path ${nodeName}`);
+			return;
+		}
+		getPropertyValue(property, node);
+		return;
+	}
+};
+function applyNodeModifier(property, objectRef, value) {
+	switch (property) {
+		case "visible":
+			objectRef.visible = value;
+			break;
+		case "translation": {
+			const v = value;
+			objectRef.position.set(v.x, v.y, v.z);
+			break;
+		}
+		case "scale": {
+			const v = value;
+			objectRef.scale.set(v.x, v.y, v.z);
+			break;
+		}
+		case "rotation": {
+			const v = value;
+			objectRef.quaternion.set(v.x, v.y, v.z, v.w);
+			break;
+		}
+	}
+}
+function applyMaterialModifier(property, materialRef, value) {
+	switch (property) {
+		case "color": {
+			const basic = materialRef;
+			if (basic.color) {
+				const v = value;
+				basic.color.setRGB(v.x, v.y, v.z);
+				basic.needsUpdate = true;
+			}
+			break;
+		}
+	}
+}
+function getPropertyValue(property, objectRef) {
+	switch (property) {
+		case "visible": return objectRef.visible;
+		case "translation": return toVec3(objectRef.position);
+		case "scale": return toVec3(objectRef.scale);
+		case "rotation": return toVec4(objectRef.quaternion);
+		default: throw new Error(`unrecognized property: ${property}`);
+	}
+}
+const extractProperties = (gltf) => {
+	const nodeProperties = [
+		"visible",
+		"translation",
+		"scale",
+		"rotation",
+		"color"
+	];
+	const animationProperties = ["playing"];
+	const materialProperties = ["color"];
+	const gltfJson = gltf.parser.json;
+	const nodeOptions = gltfJson.nodes?.map(({ name }, index) => ({
+		name: name || index.toString(),
+		index
+	}));
+	const materialOptions = gltfJson.materials?.map(({ name }, index) => ({
+		name: name || index.toString(),
+		index
+	}));
+	const animationOptions = gltf.animations?.map(({ name }, index) => ({
+		name: name || index.toString(),
+		index
+	}));
+	const properties = {};
+	properties.nodes = {
+		options: nodeOptions,
+		properties: nodeProperties
+	};
+	if (materialOptions) properties.materials = {
+		options: materialOptions,
+		properties: materialProperties
+	};
+	if (animationOptions) properties.animations = {
+		options: animationOptions,
+		properties: animationProperties
+	};
+	return properties;
+};
+function createPropertyChoice(resource, name, property, index) {
+	return {
+		text: `${resource}/${name}/${property}`,
+		value: `${resource}/${index}/${property}`
+	};
+}
+function generateChoicesForProperty(property, resource) {
+	if (!property) return [];
+	const choices = [];
+	property.options.forEach(({ index, name }) => {
+		property.properties.forEach((property$1) => {
+			choices.push(createPropertyChoice(resource, name, property$1, index));
+		});
+	});
+	return choices;
+}
+function generateSettableChoices(properties) {
+	return [
+		...generateChoicesForProperty(properties.nodes, Resource.nodes),
+		...generateChoicesForProperty(properties.materials, Resource.materials),
+		...generateChoicesForProperty(properties.animations, Resource.animations)
+	];
+}
+function generateRaycastableChoices(properties) {
+	const choices = [];
+	properties.nodes?.options.forEach(({ index, name }) => {
+		choices.push({
+			text: `nodes/${name}`,
+			value: `nodes/${index}`
+		});
+	});
+	return choices;
+}
+const buildScene = ({ gltf, setOnClickListeners, setActiveAnimations }) => {
+	const properties = extractProperties(gltf);
+	const onSceneChanged = new EventEmitter();
+	const addOnClickedListener = (jsonPath, callback) => {
+		if (!setOnClickListeners) return;
+		const path = parseJsonPath(jsonPath, true);
+		setOnClickListeners((existing) => {
+			const listenersForPath = existing[jsonPath] || {
+				path,
+				elementName: getResourceName({
+					resource: path.resource,
+					index: path.index
+				}, properties),
+				callbacks: []
+			};
+			const updatedListeners = {
+				...listenersForPath,
+				callbacks: [...listenersForPath.callbacks, callback]
+			};
+			return {
+				...existing,
+				[jsonPath]: updatedListeners
+			};
+		});
+	};
+	const removeOnClickedListener = (jsonPath, callback) => {
+		if (!setOnClickListeners) return;
+		setOnClickListeners((existing) => {
+			const listenersForPath = existing[jsonPath];
+			if (!listenersForPath) return existing;
+			const updatedCallbacks = listenersForPath.callbacks.filter((x) => x !== callback);
+			if (updatedCallbacks.length > 0) {
+				const updatedListeners = {
+					...listenersForPath,
+					callback: updatedCallbacks
+				};
+				return {
+					...existing,
+					[jsonPath]: updatedListeners
+				};
+			}
+			const result = { ...existing };
+			delete result[jsonPath];
+			return result;
+		});
+	};
+	const getProperty = (jsonPath, _valueTypeName) => {
+		return getPropertyFromModel(parseJsonPath(jsonPath), gltf, properties);
+	};
+	const setProperty = (jsonPath, valueTypeName, value) => {
+		applyPropertyToModel(parseJsonPath(jsonPath), gltf, value, properties, setActiveAnimations);
+		onSceneChanged.emit();
+	};
+	const settableChoices = generateSettableChoices(properties);
+	const raycastableChoices = generateRaycastableChoices(properties);
+	const addOnSceneChangedListener = (listener) => {
+		onSceneChanged.addListener(listener);
+	};
+	const removeOnSceneChangedListener = (listener) => {
+		onSceneChanged.removeListener(listener);
+	};
+	const notSupported = (op) => {
+		throw new Error(`The glTF-backed scene does not support "${op}". Use a scene backend that implements the procedural mesh/light API (e.g. the demo scene) for that operation.`);
+	};
+	return {
+		getProperty,
+		setProperty,
+		getProperties: () => settableChoices,
+		getRaycastableProperties: () => raycastableChoices,
+		addOnClickedListener,
+		removeOnClickedListener,
+		addOnSceneChangedListener,
+		removeOnSceneChangedListener,
+		createMesh: () => notSupported("createMesh"),
+		deleteMesh: () => notSupported("deleteMesh"),
+		getMeshNames: () => [],
+		addLight: () => notSupported("addLight"),
+		removeLight: () => notSupported("removeLight"),
+		setLightProperty: () => notSupported("setLightProperty"),
+		getLightProperty: () => notSupported("getLightProperty"),
+		getLightNames: () => [],
+		setMaterialProperty: () => notSupported("setMaterialProperty"),
+		getMaterialProperty: () => notSupported("getMaterialProperty"),
+		addOnAnyMeshClickedListener: () => notSupported("addOnAnyMeshClickedListener"),
+		removeOnAnyMeshClickedListener: () => notSupported("removeOnAnyMeshClickedListener"),
+		getMeshPosition: () => notSupported("getMeshPosition"),
+		setMeshPosition: () => notSupported("setMeshPosition"),
+		getDistanceBetween: () => notSupported("getDistanceBetween"),
+		lookAt: () => notSupported("lookAt"),
+		moveTowards: () => notSupported("moveTowards"),
+		cloneMesh: () => notSupported("cloneMesh"),
+		setMeshVisible: () => notSupported("setMeshVisible")
+	};
+};
+
+//#endregion
+export { applyPropertyToModel, buildScene, extractProperties, generateRaycastableChoices, generateSettableChoices, parseJsonPath, toJsonPathString };
+//# sourceMappingURL=buildScene.js.map

package/dist/buildScene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildScene.js","names":["properties: Properties","choices: { text: string; value: any }[]","property","updatedListeners: OnClickListener","addOnSceneChangedListener: IScene['addOnSceneChangedListener']","removeOnSceneChangedListener: IScene['removeOnSceneChangedListener']"],"sources":["../src/buildScene.ts"],"sourcesContent":["import { type Choices, EventEmitter } from '@kiberon-labs/behave-graph';\nimport {\n  type Event,\n  Material,\n  MeshBasicMaterial,\n  Object3D,\n  Quaternion,\n  Vector3,\n  Vector4\n} from 'three';\nimport type { GLTF } from 'three-stdlib';\n\nimport type { IScene } from './Abstractions/IScene.js';\nimport type { GLTFJson } from './GLTFJson.js';\nimport { Vec3 } from './Values/Internal/Vec3.js';\nimport { Vec4 } from './Values/Internal/Vec4.js';\n\nconst Resource = {\n  nodes: 'nodes',\n  materials: 'materials',\n  animations: 'animations'\n} as const;\n\ntype Resource = (typeof Resource)[keyof typeof Resource];\n\nfunction toVec3(value: Vector3): Vec3 {\n  return new Vec3(value.x, value.y, value.z);\n}\nfunction toVec4(value: Vector4 | Quaternion): Vec4 {\n  return new Vec4(value.x, value.y, value.z, value.w);\n}\n\nexport declare type ObjectMap = {\n  nodes: {\n    [name: string]: Object3D;\n  };\n  materials: {\n    [name: string]: Material;\n  };\n};\n\nconst shortPathRegEx = /^\\/?(?<resource>[^/]+)\\/(?<index>\\d+)$/;\nconst jsonPathRegEx =\n  /^\\/?(?<resource>[^/]+)\\/(?<index>\\d+)\\/(?<property>[^/]+)$/;\n\nexport type Optional<T> = {\n  [K in keyof T]: T[K] | undefined;\n};\n\nexport type Path = {\n  resource: Resource;\n  index: number;\n  property: string;\n};\n\nexport function toJsonPathString(\n  { index, property, resource: resourceType }: Optional<Path>,\n  short: boolean\n) {\n  if (short) {\n    if (!resourceType || index === undefined) return;\n    return `${resourceType}/${index}`;\n  } else {\n    if (!resourceType || index === undefined || !property) return;\n    return `${resourceType}/${index}/${property}`;\n  }\n}\n\nexport function parseJsonPath(jsonPath: string, short = false): Path {\n  // hack = for now we see if there are 2 segments to know if its short\n  const regex = short ? shortPathRegEx : jsonPathRegEx;\n  const matches = regex.exec(jsonPath);\n  if (matches === null) throw new Error(`can not parse jsonPath: ${jsonPath}`);\n  if (matches.groups === undefined)\n    throw new Error(`can not parse jsonPath (no groups): ${jsonPath}`);\n  return {\n    resource: matches.groups.resource as Resource,\n    index: +matches.groups.index!,\n    property: matches.groups.property!\n  };\n}\n\nexport function applyPropertyToModel(\n  { resource, index, property }: Path,\n  gltf: GLTF & ObjectMap,\n  value: any,\n  properties: Properties,\n  setActiveAnimations:\n    | ((animation: string, active: boolean) => void)\n    | undefined\n) {\n  const nodeName = getResourceName({ resource, index }, properties);\n  if (!nodeName) throw new Error(`could not get node at index ${index}`);\n  if (resource === Resource.nodes) {\n    const node = gltf.nodes[nodeName] as unknown as Object3D | undefined;\n\n    if (!node) {\n      console.error(`no node at path ${nodeName}`);\n      return;\n    }\n\n    applyNodeModifier(property, node, value);\n\n    return;\n  }\n  if (resource === Resource.materials) {\n    const node = gltf.materials[nodeName] as unknown as Material | undefined;\n\n    if (!node) {\n      console.error(`no node at path ${nodeName}`);\n      return;\n    }\n\n    applyMaterialModifier(property, node, value);\n\n    return;\n  }\n\n  if (resource === Resource.animations) {\n    if (!setActiveAnimations) {\n      console.error(\n        'cannot apply animation property without setActiveAnimations'\n      );\n      return;\n    }\n\n    setActiveAnimations(nodeName, value as boolean);\n    return;\n  }\n\n  console.error(`unknown resource type ${resource}`);\n}\n\nconst getResourceName = (\n  { resource, index }: Pick<Path, 'resource' | 'index'>,\n  properties: Properties\n) => {\n  return properties[resource]?.options[index]?.name;\n};\n\nconst getPropertyFromModel = (\n  { resource, index, property }: Path,\n  gltf: GLTF & ObjectMap,\n  properties: Properties\n) => {\n  if (resource === Resource.nodes) {\n    const nodeName = getResourceName({ resource, index }, properties);\n    if (!nodeName) throw new Error(`could not get node at index ${index}`);\n    const node = gltf.nodes[nodeName] as unknown as Object3D | undefined;\n\n    if (!node) {\n      console.error(`no node at path ${nodeName}`);\n      return;\n    }\n\n    getPropertyValue(property, node);\n\n    return;\n  }\n};\n\nfunction applyNodeModifier(property: string, objectRef: Object3D, value: any) {\n  switch (property) {\n    case 'visible': {\n      objectRef.visible = value as boolean;\n      break;\n    }\n    case 'translation': {\n      const v = value as Vec3;\n      objectRef.position.set(v.x, v.y, v.z);\n      break;\n    }\n    case 'scale': {\n      const v = value as Vec3;\n      objectRef.scale.set(v.x, v.y, v.z);\n      break;\n    }\n    case 'rotation': {\n      const v = value as Vec4;\n      objectRef.quaternion.set(v.x, v.y, v.z, v.w);\n      break;\n    }\n  }\n}\n\nfunction applyMaterialModifier(\n  property: string,\n  materialRef: Material,\n  value: any\n) {\n  switch (property) {\n    case 'color': {\n      const basic = materialRef as MeshBasicMaterial;\n\n      if (basic.color) {\n        const v = value as Vec3;\n        basic.color.setRGB(v.x, v.y, v.z);\n        basic.needsUpdate = true;\n      }\n      break;\n    }\n  }\n}\n\nfunction getPropertyValue(property: string, objectRef: Object3D<Event>) {\n  switch (property) {\n    case 'visible': {\n      return objectRef.visible;\n    }\n    case 'translation': {\n      return toVec3(objectRef.position);\n    }\n    case 'scale': {\n      return toVec3(objectRef.scale);\n    }\n    case 'rotation': {\n      return toVec4(objectRef.quaternion);\n    }\n    default:\n      throw new Error(`unrecognized property: ${property}`);\n  }\n}\n\nexport type ResourceOption = {\n  name: string;\n  index: number;\n};\n\nexport type ResourceProperties = {\n  options: ResourceOption[];\n  properties: string[];\n};\n\ntype Properties = {\n  [key in Resource]?: ResourceProperties;\n};\n\nexport type ParsableScene = GLTF &\n  ObjectMap & {\n    json?: GLTFJson;\n  };\n\nexport const extractProperties = (gltf: ParsableScene): Properties => {\n  const nodeProperties = [\n    'visible',\n    'translation',\n    'scale',\n    'rotation',\n    'color'\n  ];\n  const animationProperties = ['playing'];\n  const materialProperties = ['color'];\n\n  const gltfJson = gltf.parser.json as GLTFJson;\n\n  const nodeOptions = gltfJson.nodes?.map(({ name }, index) => ({\n    name: name || index.toString(),\n    index\n  }));\n  const materialOptions = gltfJson.materials?.map(({ name }, index) => ({\n    name: name || index.toString(),\n    index\n  }));\n  const animationOptions = gltf.animations?.map(({ name }, index) => ({\n    name: name || index.toString(),\n    index\n  }));\n\n  const properties: Properties = {};\n\n  properties.nodes = { options: nodeOptions, properties: nodeProperties };\n\n  if (materialOptions) {\n    properties.materials = {\n      options: materialOptions,\n      properties: materialProperties\n    };\n  }\n\n  if (animationOptions) {\n    properties.animations = {\n      options: animationOptions,\n      properties: animationProperties\n    };\n  }\n\n  return properties;\n};\n\nfunction createPropertyChoice(\n  resource: string,\n  name: string,\n  property: string,\n  index: number\n): { text: string; value: any } {\n  return {\n    text: `${resource}/${name}/${property}`,\n    value: `${resource}/${index}/${property}`\n  };\n}\n\nfunction generateChoicesForProperty(\n  property: ResourceProperties | undefined,\n  resource: Resource\n) {\n  if (!property) return [];\n  const choices: { text: string; value: any }[] = [];\n\n  property.options.forEach(({ index, name }) => {\n    property.properties.forEach((property) => {\n      choices.push(createPropertyChoice(resource, name, property, index));\n    });\n  });\n\n  return choices;\n}\n\nexport function generateSettableChoices(properties: Properties): Choices {\n  const choices: { text: string; value: any }[] = [\n    ...generateChoicesForProperty(properties.nodes, Resource.nodes),\n    ...generateChoicesForProperty(properties.materials, Resource.materials),\n    ...generateChoicesForProperty(properties.animations, Resource.animations)\n  ];\n\n  return choices;\n}\n\nexport function generateRaycastableChoices(properties: Properties): Choices {\n  const choices: { text: string; value: any }[] = [];\n\n  properties.nodes?.options.forEach(({ index, name }) => {\n    choices.push({\n      text: `nodes/${name}`,\n      value: `nodes/${index}`\n    });\n  });\n\n  return choices;\n}\n\nexport type OnClickCallback = (jsonPath: string) => void;\n\nexport type OnClickListener = {\n  path: Path;\n  elementName: string;\n  callbacks: OnClickCallback[];\n};\n\nexport type OnClickListeners = {\n  [jsonPath: string]: OnClickListener;\n};\n\nexport const buildScene = ({\n  gltf,\n  setOnClickListeners,\n  setActiveAnimations\n}: {\n  gltf: GLTF & ObjectMap;\n  setOnClickListeners:\n    | ((cb: (existing: OnClickListeners) => OnClickListeners) => void)\n    | undefined;\n  setActiveAnimations:\n    | ((animation: string, active: boolean) => void)\n    | undefined;\n}) => {\n  const properties = extractProperties(gltf);\n\n  const onSceneChanged = new EventEmitter<void>();\n\n  const addOnClickedListener = (\n    jsonPath: string,\n    callback: (jsonPath: string) => void\n  ) => {\n    if (!setOnClickListeners) return;\n    const path = parseJsonPath(jsonPath, true);\n\n    setOnClickListeners((existing) => {\n      const listenersForPath = existing[jsonPath] || {\n        path,\n        elementName: getResourceName(\n          { resource: path.resource, index: path.index },\n          properties\n        )!,\n        callbacks: []\n      };\n\n      const updatedListeners: OnClickListener = {\n        ...listenersForPath,\n        callbacks: [...listenersForPath.callbacks, callback]\n      };\n\n      const result: OnClickListeners = {\n        ...existing,\n        [jsonPath]: updatedListeners\n      };\n\n      return result;\n    });\n  };\n\n  const removeOnClickedListener = (\n    jsonPath: string,\n    callback: (jsonPath: string) => void\n  ) => {\n    if (!setOnClickListeners) return;\n    setOnClickListeners((existing) => {\n      const listenersForPath = existing[jsonPath];\n\n      if (!listenersForPath) return existing;\n\n      const updatedCallbacks = listenersForPath.callbacks.filter(\n        (x) => x !== callback\n      );\n\n      if (updatedCallbacks.length > 0) {\n        const updatedListeners = {\n          ...listenersForPath,\n          callback: updatedCallbacks\n        };\n\n        return {\n          ...existing,\n          [jsonPath]: updatedListeners\n        };\n      }\n\n      const result = {\n        ...existing\n      };\n\n      delete result[jsonPath];\n\n      return result;\n    });\n  };\n\n  const getProperty = (jsonPath: string, _valueTypeName: string) => {\n    const path = parseJsonPath(jsonPath);\n\n    return getPropertyFromModel(path, gltf, properties);\n  };\n\n  const setProperty = (jsonPath: string, valueTypeName: string, value: any) => {\n    const path = parseJsonPath(jsonPath);\n\n    applyPropertyToModel(path, gltf, value, properties, setActiveAnimations);\n\n    onSceneChanged.emit();\n  };\n\n  const settableChoices = generateSettableChoices(properties);\n  const raycastableChoices = generateRaycastableChoices(properties);\n\n  const addOnSceneChangedListener: IScene['addOnSceneChangedListener'] = (\n    listener\n  ) => {\n    onSceneChanged.addListener(listener);\n  };\n\n  const removeOnSceneChangedListener: IScene['removeOnSceneChangedListener'] = (\n    listener\n  ) => {\n    onSceneChanged.removeListener(listener);\n  };\n\n  // This scene is backed by a loaded glTF model and exposes it through the\n  // json-path property API (getProperty/setProperty/...). The procedural\n  // mesh/light/material API (added to IScene for scene backends like the demo\n  // scene) is not supported here, so those operations fail loudly rather than\n  // silently doing the wrong thing. Name-enumeration getters return empty so\n  // generic choice UIs degrade gracefully instead of throwing.\n  const notSupported = (op: string): never => {\n    throw new Error(\n      `The glTF-backed scene does not support \"${op}\". Use a scene backend that implements the procedural mesh/light API (e.g. the demo scene) for that operation.`\n    );\n  };\n\n  const scene: IScene = {\n    getProperty,\n    setProperty,\n    getProperties: () => settableChoices,\n    getRaycastableProperties: () => raycastableChoices,\n    addOnClickedListener,\n    removeOnClickedListener,\n    addOnSceneChangedListener,\n    removeOnSceneChangedListener,\n\n    // --- procedural mesh/light/material API: unsupported on a glTF scene ---\n    createMesh: () => notSupported('createMesh'),\n    deleteMesh: () => notSupported('deleteMesh'),\n    getMeshNames: () => [],\n    addLight: () => notSupported('addLight'),\n    removeLight: () => notSupported('removeLight'),\n    setLightProperty: () => notSupported('setLightProperty'),\n    getLightProperty: () => notSupported('getLightProperty'),\n    getLightNames: () => [],\n    setMaterialProperty: () => notSupported('setMaterialProperty'),\n    getMaterialProperty: () => notSupported('getMaterialProperty'),\n    addOnAnyMeshClickedListener: () =>\n      notSupported('addOnAnyMeshClickedListener'),\n    removeOnAnyMeshClickedListener: () =>\n      notSupported('removeOnAnyMeshClickedListener'),\n    getMeshPosition: () => notSupported('getMeshPosition'),\n    setMeshPosition: () => notSupported('setMeshPosition'),\n    getDistanceBetween: () => notSupported('getDistanceBetween'),\n    lookAt: () => notSupported('lookAt'),\n    moveTowards: () => notSupported('moveTowards'),\n    cloneMesh: () => notSupported('cloneMesh'),\n    setMeshVisible: () => notSupported('setMeshVisible')\n  };\n\n  return scene;\n};\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,57 @@
+import { GeometryType, IScene, LightType } from "./Abstractions/IScene.js";
+import { DummyScene } from "./Abstractions/Drivers/DummyScene.js";
+import { Vec2, Vec2JSON, vec2Add, vec2Dot, vec2Equals, vec2FromArray, vec2Length, vec2Mix, vec2MultiplyByScalar, vec2Negate, vec2Normalize, vec2Parse, vec2Subtract, vec2ToArray, vec2ToString } from "./Values/Internal/Vec2.js";
+import { Vec4, Vec4JSON, angleAxisToQuat, eulerToQuat, mat3ToQuat, mat4ToQuat, quatConjugate, quatExp, quatLn, quatMultiply, quatPow, quatSlerp, quatToAngleAxis, vec4Add, vec4Dot, vec4Equals, vec4FromArray, vec4Length, vec4Mix, vec4MultiplyByScalar, vec4Negate, vec4Normalize, vec4Parse, vec4Subtract, vec4ToArray, vec4ToString } from "./Values/Internal/Vec4.js";
+import { Vec3, Vec3JSON, hexToRGB, hslToRGB, mat3ToEuler, mat4ToEuler, quatToEuler, rgbToHSL, rgbToHex, vec3Add, vec3Cross, vec3Dot, vec3Equals, vec3FromArray, vec3Length, vec3Mix, vec3MultiplyByScalar, vec3Negate, vec3Normalize, vec3Parse, vec3Subtract, vec3ToArray, vec3ToString } from "./Values/Internal/Vec3.js";
+import { Mat4, Mat4JSON, column4ToMat4, eulerToMat4, mat3ToMat4, mat4Add, mat4Adjoint, mat4Determinant, mat4Equals, mat4FromArray, mat4Inverse, mat4LookAt, mat4Mix, mat4Multiply, mat4MultiplyByScalar, mat4Negate, mat4Orthogonal, mat4OrthogonalSimple, mat4Parse, mat4Perspective, mat4PerspectiveFov, mat4RotateByEuler, mat4RotateByQuat, mat4Scale, mat4SetColumn4, mat4SetRow4, mat4Subtract, mat4ToArray, mat4ToScale3, mat4ToString, mat4ToTranslation3, mat4TransformNormal3, mat4TransformPoint3, mat4Translate, mat4Transpose, quatToMat4, scale3ToMat4, translation3ToMat4 } from "./Values/Internal/Mat4.js";
+import { Mat3, Mat3JSON, column3ToMat3, eulerToMat3, mat3Add, mat3Determinant, mat3Equals, mat3FromArray, mat3Inverse, mat3Mix, mat3Multiply, mat3MultiplyByScalar, mat3Negate, mat3Parse, mat3SetColumn3, mat3SetRow3, mat3Subtract, mat3ToArray, mat3ToScale2, mat3ToScale3, mat3ToString, mat3ToTranslation2, mat3Transpose, mat4ToMat3, quatToMat3, scale2ToMat3, scale3ToMat3, translation2ToMat3 } from "./Values/Internal/Mat3.js";
+import { ColorValue } from "./Values/ColorValue.js";
+import { EulerValue } from "./Values/EulerValue.js";
+import { Mat3Value } from "./Values/Mat3Value.js";
+import { Mat4Value } from "./Values/Mat4Value.js";
+import { Vec2Value } from "./Values/Vec2Value.js";
+import { Vec3Value } from "./Values/Vec3Value.js";
+import { Vec4Value } from "./Values/Vec4Value.js";
+import { QuatValue } from "./Values/QuatValue.js";
+import { AddLight } from "./Nodes/Actions/AddLight.js";
+import { CloneMesh } from "./Nodes/Actions/CloneMesh.js";
+import { CreateMesh } from "./Nodes/Actions/CreateMesh.js";
+import { DeleteMesh } from "./Nodes/Actions/DeleteMesh.js";
+import { EaseSceneProperty } from "./Nodes/Actions/EaseSceneProperty.js";
+import { LookAt } from "./Nodes/Actions/LookAt.js";
+import { MoveTowards } from "./Nodes/Actions/MoveTowards.js";
+import { RemoveLight } from "./Nodes/Actions/RemoveLight.js";
+import { SetLightProperty } from "./Nodes/Actions/SetLightProperty.js";
+import { SetMaterialProperty } from "./Nodes/Actions/SetMaterialProperty.js";
+import { SetMeshPosition } from "./Nodes/Actions/SetMeshPosition.js";
+import { SetMeshVisible } from "./Nodes/Actions/SetMeshVisible.js";
+import { SetSceneProperty } from "./Nodes/Actions/SetSceneProperty.js";
+import { OnAnyMeshClicked } from "./Nodes/Events/OnAnyMeshClicked.js";
+import { OnSceneChanged } from "./Nodes/Events/OnSceneChanged.js";
+import { OnSceneNodeClick } from "./Nodes/Events/OnSceneNodeClick.js";
+import { ColorNodes_d_exports } from "./Nodes/Logic/ColorNodes.js";
+import { EulerNodes_d_exports } from "./Nodes/Logic/EulerNodes.js";
+import { Mat3Nodes_d_exports } from "./Nodes/Logic/Mat3Nodes.js";
+import { Mat4Nodes_d_exports } from "./Nodes/Logic/Mat4Nodes.js";
+import { Vec2Nodes_d_exports } from "./Nodes/Logic/Vec2Nodes.js";
+import { Vec3Nodes_d_exports } from "./Nodes/Logic/Vec3Nodes.js";
+import { Vec4Nodes_d_exports } from "./Nodes/Logic/Vec4Nodes.js";
+import { QuatNodes_d_exports } from "./Nodes/Logic/QuatNodes.js";
+import { VecElements } from "./Nodes/Logic/VecElements.js";
+import { GetDistanceBetween } from "./Nodes/Queries/GetDistanceBetween.js";
+import { GetLightProperty } from "./Nodes/Queries/GetLightProperty.js";
+import { GetMaterialProperty } from "./Nodes/Queries/GetMaterialProperty.js";
+import { GetMeshPosition } from "./Nodes/Queries/GetMeshPosition.js";
+import { GetSceneProperty } from "./Nodes/Queries/GetSceneProperty.js";
+import { getSceneNodesMap, getSceneStringConversions, getSceneValuesMap, registerSceneProfile } from "./registerSceneProfile.js";
+import { ObjectMap, OnClickCallback, OnClickListener, OnClickListeners, Optional, ParsableScene, Path, ResourceOption, ResourceProperties, applyPropertyToModel, buildScene, extractProperties, generateRaycastableChoices, generateSettableChoices, parseJsonPath, toJsonPathString } from "./buildScene.js";
+
+//#region src/index.d.ts
+declare module '@kiberon-labs/behave-graph' {
+  interface Dependencies {
+    IScene: IScene;
+  }
+}
+//#endregion
+export { AddLight, CloneMesh, ColorNodes_d_exports as ColorNodes, ColorValue, CreateMesh, DeleteMesh, DummyScene, EaseSceneProperty, EulerNodes_d_exports as EulerNodes, EulerValue, GeometryType, GetDistanceBetween, GetLightProperty, GetMaterialProperty, GetMeshPosition, GetSceneProperty, IScene, LightType, LookAt, Mat3, Mat3JSON, Mat3Nodes_d_exports as Mat3Nodes, Mat3Value, Mat4, Mat4JSON, Mat4Nodes_d_exports as Mat4Nodes, Mat4Value, MoveTowards, ObjectMap, OnAnyMeshClicked, OnClickCallback, OnClickListener, OnClickListeners, OnSceneChanged, OnSceneNodeClick, Optional, ParsableScene, Path, QuatNodes_d_exports as QuatNodes, QuatValue, RemoveLight, ResourceOption, ResourceProperties, SetLightProperty, SetMaterialProperty, SetMeshPosition, SetMeshVisible, SetSceneProperty, Vec2, Vec2JSON, Vec2Nodes_d_exports as Vec2Nodes, Vec2Value, Vec3, Vec3JSON, Vec3Nodes_d_exports as Vec3Nodes, Vec3Value, Vec4, Vec4JSON, Vec4Nodes_d_exports as Vec4Nodes, Vec4Value, VecElements, angleAxisToQuat, applyPropertyToModel, buildScene, column3ToMat3, column4ToMat4, eulerToMat3, eulerToMat4, eulerToQuat, extractProperties, generateRaycastableChoices, generateSettableChoices, getSceneNodesMap, getSceneStringConversions, getSceneValuesMap, hexToRGB, hslToRGB, mat3Add, mat3Determinant, mat3Equals, mat3FromArray, mat3Inverse, mat3Mix, mat3Multiply, mat3MultiplyByScalar, mat3Negate, mat3Parse, mat3SetColumn3, mat3SetRow3, mat3Subtract, mat3ToArray, mat3ToEuler, mat3ToMat4, mat3ToQuat, mat3ToScale2, mat3ToScale3, mat3ToString, mat3ToTranslation2, mat3Transpose, mat4Add, mat4Adjoint, mat4Determinant, mat4Equals, mat4FromArray, mat4Inverse, mat4LookAt, mat4Mix, mat4Multiply, mat4MultiplyByScalar, mat4Negate, mat4Orthogonal, mat4OrthogonalSimple, mat4Parse, mat4Perspective, mat4PerspectiveFov, mat4RotateByEuler, mat4RotateByQuat, mat4Scale, mat4SetColumn4, mat4SetRow4, mat4Subtract, mat4ToArray, mat4ToEuler, mat4ToMat3, mat4ToQuat, mat4ToScale3, mat4ToString, mat4ToTranslation3, mat4TransformNormal3, mat4TransformPoint3, mat4Translate, mat4Transpose, parseJsonPath, quatConjugate, quatExp, quatLn, quatMultiply, quatPow, quatSlerp, quatToAngleAxis, quatToEuler, quatToMat3, quatToMat4, registerSceneProfile, rgbToHSL, rgbToHex, scale2ToMat3, scale3ToMat3, scale3ToMat4, toJsonPathString, translation2ToMat3, translation3ToMat4, vec2Add, vec2Dot, vec2Equals, vec2FromArray, vec2Length, vec2Mix, vec2MultiplyByScalar, vec2Negate, vec2Normalize, vec2Parse, vec2Subtract, vec2ToArray, vec2ToString, vec3Add, vec3Cross, vec3Dot, vec3Equals, vec3FromArray, vec3Length, vec3Mix, vec3MultiplyByScalar, vec3Negate, vec3Normalize, vec3Parse, vec3Subtract, vec3ToArray, vec3ToString, vec4Add, vec4Dot, vec4Equals, vec4FromArray, vec4Length, vec4Mix, vec4MultiplyByScalar, vec4Negate, vec4Normalize, vec4Parse, vec4Subtract, vec4ToArray, vec4ToString };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAIY"}

package/dist/index.js

@@ -0,0 +1,49 @@
+import { GeometryType, LightType } from "./Abstractions/IScene.js";
+import { Vec2, vec2Add, vec2Dot, vec2Equals, vec2FromArray, vec2Length, vec2Mix, vec2MultiplyByScalar, vec2Negate, vec2Normalize, vec2Parse, vec2Subtract, vec2ToArray, vec2ToString } from "./Values/Internal/Vec2.js";
+import { Mat3, column3ToMat3, eulerToMat3, mat3Add, mat3Determinant, mat3Equals, mat3FromArray, mat3Inverse, mat3Mix, mat3Multiply, mat3MultiplyByScalar, mat3Negate, mat3Parse, mat3SetColumn3, mat3SetRow3, mat3Subtract, mat3ToArray, mat3ToScale2, mat3ToScale3, mat3ToString, mat3ToTranslation2, mat3Transpose, mat4ToMat3, quatToMat3, scale2ToMat3, scale3ToMat3, translation2ToMat3 } from "./Values/Internal/Mat3.js";
+import { Vec3, hexToRGB, hslToRGB, mat3ToEuler, mat4ToEuler, quatToEuler, rgbToHSL, rgbToHex, vec3Add, vec3Cross, vec3Dot, vec3Equals, vec3FromArray, vec3Length, vec3Mix, vec3MultiplyByScalar, vec3Negate, vec3Normalize, vec3Parse, vec3Subtract, vec3ToArray, vec3ToString } from "./Values/Internal/Vec3.js";
+import { ColorValue } from "./Values/ColorValue.js";
+import { EulerValue } from "./Values/EulerValue.js";
+import { Vec4, angleAxisToQuat, eulerToQuat, mat3ToQuat, mat4ToQuat, quatConjugate, quatExp, quatLn, quatMultiply, quatPow, quatSlerp, quatToAngleAxis, vec4Add, vec4Dot, vec4Equals, vec4FromArray, vec4Length, vec4Mix, vec4MultiplyByScalar, vec4Negate, vec4Normalize, vec4Parse, vec4Subtract, vec4ToArray, vec4ToString } from "./Values/Internal/Vec4.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 { DummyScene } from "./Abstractions/Drivers/DummyScene.js";
+import { Mat4, column4ToMat4, eulerToMat4, mat3ToMat4, mat4Add, mat4Adjoint, mat4Determinant, mat4Equals, mat4FromArray, mat4Inverse, mat4LookAt, mat4Mix, mat4Multiply, mat4MultiplyByScalar, mat4Negate, mat4Orthogonal, mat4OrthogonalSimple, mat4Parse, mat4Perspective, mat4PerspectiveFov, mat4RotateByEuler, mat4RotateByQuat, mat4Scale, mat4SetColumn4, mat4SetRow4, mat4Subtract, mat4ToArray, mat4ToScale3, mat4ToString, mat4ToTranslation3, mat4TransformNormal3, mat4TransformPoint3, mat4Translate, mat4Transpose, quatToMat4, scale3ToMat4, translation3ToMat4 } from "./Values/Internal/Mat4.js";
+import { Mat3Value } from "./Values/Mat3Value.js";
+import { Mat4Value } from "./Values/Mat4Value.js";
+import { AddLight } from "./Nodes/Actions/AddLight.js";
+import { CloneMesh } from "./Nodes/Actions/CloneMesh.js";
+import { CreateMesh } from "./Nodes/Actions/CreateMesh.js";
+import { DeleteMesh } from "./Nodes/Actions/DeleteMesh.js";
+import { EaseSceneProperty } from "./Nodes/Actions/EaseSceneProperty.js";
+import { LookAt } from "./Nodes/Actions/LookAt.js";
+import { MoveTowards } from "./Nodes/Actions/MoveTowards.js";
+import { RemoveLight } from "./Nodes/Actions/RemoveLight.js";
+import { SetLightProperty } from "./Nodes/Actions/SetLightProperty.js";
+import { SetMaterialProperty } from "./Nodes/Actions/SetMaterialProperty.js";
+import { SetMeshPosition } from "./Nodes/Actions/SetMeshPosition.js";
+import { SetMeshVisible } from "./Nodes/Actions/SetMeshVisible.js";
+import { SetSceneProperty } from "./Nodes/Actions/SetSceneProperty.js";
+import { OnAnyMeshClicked } from "./Nodes/Events/OnAnyMeshClicked.js";
+import { OnSceneChanged } from "./Nodes/Events/OnSceneChanged.js";
+import { OnSceneNodeClick } from "./Nodes/Events/OnSceneNodeClick.js";
+import { ColorNodes_exports } from "./Nodes/Logic/ColorNodes.js";
+import { EulerNodes_exports } from "./Nodes/Logic/EulerNodes.js";
+import { Mat3Nodes_exports } from "./Nodes/Logic/Mat3Nodes.js";
+import { Mat4Nodes_exports } from "./Nodes/Logic/Mat4Nodes.js";
+import { Vec2Nodes_exports } from "./Nodes/Logic/Vec2Nodes.js";
+import { Vec3Nodes_exports } from "./Nodes/Logic/Vec3Nodes.js";
+import { Vec4Nodes_exports } from "./Nodes/Logic/Vec4Nodes.js";
+import { QuatNodes_exports } from "./Nodes/Logic/QuatNodes.js";
+import { VecElements } from "./Nodes/Logic/VecElements.js";
+import { GetDistanceBetween } from "./Nodes/Queries/GetDistanceBetween.js";
+import { GetLightProperty } from "./Nodes/Queries/GetLightProperty.js";
+import { GetMaterialProperty } from "./Nodes/Queries/GetMaterialProperty.js";
+import { GetMeshPosition } from "./Nodes/Queries/GetMeshPosition.js";
+import { GetSceneProperty } from "./Nodes/Queries/GetSceneProperty.js";
+import { getSceneNodesMap, getSceneStringConversions, getSceneValuesMap, registerSceneProfile } from "./registerSceneProfile.js";
+import { applyPropertyToModel, buildScene, extractProperties, generateRaycastableChoices, generateSettableChoices, parseJsonPath, toJsonPathString } from "./buildScene.js";
+
+export { AddLight, CloneMesh, ColorNodes_exports as ColorNodes, ColorValue, CreateMesh, DeleteMesh, DummyScene, EaseSceneProperty, EulerNodes_exports as EulerNodes, EulerValue, GeometryType, GetDistanceBetween, GetLightProperty, GetMaterialProperty, GetMeshPosition, GetSceneProperty, LightType, LookAt, Mat3, Mat3Nodes_exports as Mat3Nodes, Mat3Value, Mat4, Mat4Nodes_exports as Mat4Nodes, Mat4Value, MoveTowards, OnAnyMeshClicked, OnSceneChanged, OnSceneNodeClick, QuatNodes_exports as QuatNodes, QuatValue, RemoveLight, SetLightProperty, SetMaterialProperty, SetMeshPosition, SetMeshVisible, SetSceneProperty, Vec2, Vec2Nodes_exports as Vec2Nodes, Vec2Value, Vec3, Vec3Nodes_exports as Vec3Nodes, Vec3Value, Vec4, Vec4Nodes_exports as Vec4Nodes, Vec4Value, VecElements, angleAxisToQuat, applyPropertyToModel, buildScene, column3ToMat3, column4ToMat4, eulerToMat3, eulerToMat4, eulerToQuat, extractProperties, generateRaycastableChoices, generateSettableChoices, getSceneNodesMap, getSceneStringConversions, getSceneValuesMap, hexToRGB, hslToRGB, mat3Add, mat3Determinant, mat3Equals, mat3FromArray, mat3Inverse, mat3Mix, mat3Multiply, mat3MultiplyByScalar, mat3Negate, mat3Parse, mat3SetColumn3, mat3SetRow3, mat3Subtract, mat3ToArray, mat3ToEuler, mat3ToMat4, mat3ToQuat, mat3ToScale2, mat3ToScale3, mat3ToString, mat3ToTranslation2, mat3Transpose, mat4Add, mat4Adjoint, mat4Determinant, mat4Equals, mat4FromArray, mat4Inverse, mat4LookAt, mat4Mix, mat4Multiply, mat4MultiplyByScalar, mat4Negate, mat4Orthogonal, mat4OrthogonalSimple, mat4Parse, mat4Perspective, mat4PerspectiveFov, mat4RotateByEuler, mat4RotateByQuat, mat4Scale, mat4SetColumn4, mat4SetRow4, mat4Subtract, mat4ToArray, mat4ToEuler, mat4ToMat3, mat4ToQuat, mat4ToScale3, mat4ToString, mat4ToTranslation3, mat4TransformNormal3, mat4TransformPoint3, mat4Translate, mat4Transpose, parseJsonPath, quatConjugate, quatExp, quatLn, quatMultiply, quatPow, quatSlerp, quatToAngleAxis, quatToEuler, quatToMat3, quatToMat4, registerSceneProfile, rgbToHSL, rgbToHex, scale2ToMat3, scale3ToMat3, scale3ToMat4, toJsonPathString, translation2ToMat3, translation3ToMat4, vec2Add, vec2Dot, vec2Equals, vec2FromArray, vec2Length, vec2Mix, vec2MultiplyByScalar, vec2Negate, vec2Normalize, vec2Parse, vec2Subtract, vec2ToArray, vec2ToString, vec3Add, vec3Cross, vec3Dot, vec3Equals, vec3FromArray, vec3Length, vec3Mix, vec3MultiplyByScalar, vec3Negate, vec3Normalize, vec3Parse, vec3Subtract, vec3ToArray, vec3ToString, vec4Add, vec4Dot, vec4Equals, vec4FromArray, vec4Length, vec4Mix, vec4MultiplyByScalar, vec4Negate, vec4Normalize, vec4Parse, vec4Subtract, vec4ToArray, vec4ToString };

package/dist/manifest.source.d.ts

@@ -0,0 +1,7 @@
+import * as _kiberon_labs_behave_graph0 from "@kiberon-labs/behave-graph";
+
+//#region src/manifest.source.d.ts
+declare const _default: _kiberon_labs_behave_graph0.ManifestSource;
+//#endregion
+export { _default as default };
+//# sourceMappingURL=manifest.source.d.ts.map

package/dist/manifest.source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.source.d.ts","names":[],"sources":["../src/manifest.source.ts"],"sourcesContent":[],"mappings":""}

package/dist/manifest.source.js

@@ -0,0 +1,54 @@
+import { DummyScene } from "./Abstractions/Drivers/DummyScene.js";
+import { getSceneNodesMap, getSceneValuesMap } from "./registerSceneProfile.js";
+import { name, version } from "./packages/nodes/scene/package.js";
+import { ContributionKind, PackageCategory, defineManifestSource } from "@kiberon-labs/behave-graph";
+
+//#region src/manifest.source.ts
+/**
+* Build-time manifest source for the scene package.
+*
+* The registry projects scene's own nodes + value types into static specs
+* (instantiation only — nodes are never run, no IScene driver needed). The
+* executable profile (`registerSceneProfile`) lives behind the `runtime` entry,
+* loaded only by a runner. Contributions point into the built `dist`: the vec3
+* input control, plus each scene value type so a trusted host can swap the
+* editor's pass-through implementations for the real serializers.
+*/
+const valueTypeContributions = [
+	["Vec2Value", "vec2"],
+	["Vec3Value", "vec3"],
+	["Vec4Value", "vec4"],
+	["ColorValue", "color"],
+	["EulerValue", "euler"],
+	["QuatValue", "quat"],
+	["Mat3Value", "mat3"],
+	["Mat4Value", "mat4"]
+].map(([exportName, valueType]) => ({
+	id: `${valueType}-value`,
+	kind: ContributionKind.ValueType,
+	export: `./Values/${exportName}.js#${exportName}`,
+	bind: { valueType }
+}));
+var manifest_source_default = defineManifestSource({
+	package: {
+		name,
+		version
+	},
+	registry: () => ({
+		nodes: getSceneNodesMap(),
+		values: getSceneValuesMap(),
+		dependencies: { IScene: new DummyScene() }
+	}),
+	runtime: "./index.js",
+	categories: [PackageCategory.Effect],
+	contributions: [{
+		id: "vec3-control",
+		kind: ContributionKind.Control,
+		export: "./ui/controls/vec3.js#Vec3Control",
+		bind: { controlName: "vec3" }
+	}, ...valueTypeContributions]
+});
+
+//#endregion
+export { manifest_source_default as default };
+//# sourceMappingURL=manifest.source.js.map

package/dist/manifest.source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.source.js","names":["valueTypeContributions: ContributionSpec[]","pkg.name","pkg.version"],"sources":["../src/manifest.source.ts"],"sourcesContent":["import {\n  ContributionKind,\n  PackageCategory,\n  defineManifestSource,\n  type ContributionSpec,\n  type Dependencies\n} from '@kiberon-labs/behave-graph';\nimport { getSceneNodesMap, getSceneValuesMap } from './registerSceneProfile.js';\nimport { DummyScene } from './Abstractions/Drivers/DummyScene.js';\nimport pkg from '../package.json' with { type: 'json' };\n\n/**\n * Build-time manifest source for the scene package.\n *\n * The registry projects scene's own nodes + value types into static specs\n * (instantiation only — nodes are never run, no IScene driver needed). The\n * executable profile (`registerSceneProfile`) lives behind the `runtime` entry,\n * loaded only by a runner. Contributions point into the built `dist`: the vec3\n * input control, plus each scene value type so a trusted host can swap the\n * editor's pass-through implementations for the real serializers.\n */\n\n// (file, export, valueType name) for each scene value type.\nconst valueTypeContributions: ContributionSpec[] = [\n  ['Vec2Value', 'vec2'],\n  ['Vec3Value', 'vec3'],\n  ['Vec4Value', 'vec4'],\n  ['ColorValue', 'color'],\n  ['EulerValue', 'euler'],\n  ['QuatValue', 'quat'],\n  ['Mat3Value', 'mat3'],\n  ['Mat4Value', 'mat4']\n].map(([exportName, valueType]) => ({\n  id: `${valueType}-value`,\n  kind: ContributionKind.ValueType,\n  export: `./Values/${exportName}.js#${exportName}`,\n  bind: { valueType }\n}));\n\nexport default defineManifestSource({\n  package: { name: pkg.name, version: pkg.version },\n  registry: () => ({\n    nodes: getSceneNodesMap(),\n    values: getSceneValuesMap(),\n    // The DummyScene driver satisfies IScene-dependent nodes during spec\n    // generation (it never runs them); the real driver is host-provided at run\n    // time. Without it, scene-property nodes log \"IScene not registered\".\n    dependencies: { IScene: new DummyScene() } as unknown as Dependencies\n  }),\n  runtime: './index.js',\n  categories: [PackageCategory.Effect],\n  contributions: [\n    {\n      id: 'vec3-control',\n      kind: ContributionKind.Control,\n      export: './ui/controls/vec3.js#Vec3Control',\n      bind: { controlName: 'vec3' }\n    },\n    ...valueTypeContributions\n  ]\n});\n"],"mappings":";;;;;;;;;;;;;;;;AAuBA,MAAMA,yBAA6C;CACjD,CAAC,aAAa,OAAO;CACrB,CAAC,aAAa,OAAO;CACrB,CAAC,aAAa,OAAO;CACrB,CAAC,cAAc,QAAQ;CACvB,CAAC,cAAc,QAAQ;CACvB,CAAC,aAAa,OAAO;CACrB,CAAC,aAAa,OAAO;CACrB,CAAC,aAAa,OAAO;CACtB,CAAC,KAAK,CAAC,YAAY,gBAAgB;CAClC,IAAI,GAAG,UAAU;CACjB,MAAM,iBAAiB;CACvB,QAAQ,YAAY,WAAW,MAAM;CACrC,MAAM,EAAE,WAAW;CACpB,EAAE;AAEH,8BAAe,qBAAqB;CAClC,SAAS;EAAQC;EAAmBC;EAAa;CACjD,iBAAiB;EACf,OAAO,kBAAkB;EACzB,QAAQ,mBAAmB;EAI3B,cAAc,EAAE,QAAQ,IAAI,YAAY,EAAE;EAC3C;CACD,SAAS;CACT,YAAY,CAAC,gBAAgB,OAAO;CACpC,eAAe,CACb;EACE,IAAI;EACJ,MAAM,iBAAiB;EACvB,QAAQ;EACR,MAAM,EAAE,aAAa,QAAQ;EAC9B,EACD,GAAG,uBACJ;CACF,CAAC"}