@jamesyong42/infinite-canvas 1.0.0 → 1.2.0

package/dist/advanced.cjs

@@ -1,175 +1,120 @@
-'use strict';
-
-var chunkVSHXWTJH_cjs = require('./chunk-VSHXWTJH.cjs');
-
-// src/serialization.ts
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_WebGLWidgetLayer = require("./WebGLWidgetLayer-BBMuwzHq.cjs");
+const require_hooks = require("./hooks-DHShH86C.cjs");
+//#region src/serialization.ts
+/**
+* Serializes all entities, components, and tags to a JSON-compatible document.
+* Requires registries of known component and tag types for enumeration.
+*/
 function serializeWorld(world, componentTypes, tagTypes, camera, navigationFrames) {
-  const entities = [];
-  const allEntities = world.query();
-  for (const entityId of allEntities) {
-    const components = {};
-    const tags = [];
-    for (const type of componentTypes) {
-      const data = world.getComponent(entityId, type);
-      if (data !== void 0) {
-        components[type.name] = structuredClone(data);
-      }
-    }
-    for (const type of tagTypes) {
-      if (world.hasTag(entityId, type)) {
-        if (type.name !== "Active" && type.name !== "Visible") {
-          tags.push(type.name);
-        }
-      }
-    }
-    if (Object.keys(components).length > 0 || tags.length > 0) {
-      entities.push({ id: entityId, components, tags });
-    }
-  }
-  return {
-    version: 1,
-    entities,
-    resources: {
-      camera: { ...camera },
-      navigationStack: structuredClone(navigationFrames)
-    }
-  };
+	const entities = [];
+	const allEntities = world.query();
+	for (const entityId of allEntities) {
+		const components = {};
+		const tags = [];
+		for (const type of componentTypes) {
+			const data = world.getComponent(entityId, type);
+			if (data !== void 0) components[type.name] = structuredClone(data);
+		}
+		for (const type of tagTypes) if (world.hasTag(entityId, type)) {
+			if (type.name !== "Active" && type.name !== "Visible") tags.push(type.name);
+		}
+		if (Object.keys(components).length > 0 || tags.length > 0) entities.push({
+			id: entityId,
+			components,
+			tags
+		});
+	}
+	return {
+		version: 1,
+		entities,
+		resources: {
+			camera: { ...camera },
+			navigationStack: structuredClone(navigationFrames)
+		}
+	};
 }
+/**
+* Restores entities from a serialized document into the world.
+* Clears existing state first and remaps entity IDs automatically.
+*/
 function deserializeWorld(world, doc, componentTypes, tagTypes) {
-  if (doc.version !== 1) {
-    throw new Error(`Unsupported canvas document version: ${doc.version}. Expected version 1.`);
-  }
-  const compByName = /* @__PURE__ */ new Map();
-  for (const t of componentTypes) compByName.set(t.name, t);
-  const tagByName = /* @__PURE__ */ new Map();
-  for (const t of tagTypes) tagByName.set(t.name, t);
-  for (const entityId of world.query()) {
-    world.destroyEntity(entityId);
-  }
-  const idMap = /* @__PURE__ */ new Map();
-  for (const entry of doc.entities) {
-    const newId = world.createEntity();
-    idMap.set(entry.id, newId);
-    for (const [compName, data] of Object.entries(entry.components)) {
-      const type = compByName.get(compName);
-      if (type) {
-        world.addComponent(newId, type, data);
-      }
-    }
-    for (const tagName of entry.tags) {
-      const type = tagByName.get(tagName);
-      if (type) {
-        world.addTag(newId, type);
-      }
-    }
-  }
-  for (const [_oldId, newId] of idMap) {
-    const parent = world.getComponent(newId, chunkVSHXWTJH_cjs.Parent);
-    if (parent && idMap.has(parent.id)) {
-      const mappedId = idMap.get(parent.id);
-      if (mappedId !== void 0) {
-        world.setComponent(newId, chunkVSHXWTJH_cjs.Parent, { id: mappedId });
-      }
-    }
-    const children = world.getComponent(newId, chunkVSHXWTJH_cjs.Children);
-    if (children) {
-      world.setComponent(newId, chunkVSHXWTJH_cjs.Children, {
-        ids: children.ids.map((id) => idMap.get(id) ?? id)
-      });
-    }
-    const handleSet = world.getComponent(newId, chunkVSHXWTJH_cjs.HandleSet);
-    if (handleSet) {
-      world.setComponent(newId, chunkVSHXWTJH_cjs.HandleSet, {
-        ids: handleSet.ids.map((id) => idMap.get(id) ?? id)
-      });
-    }
-  }
+	if (doc.version !== 1) throw new Error(`Unsupported canvas document version: ${doc.version}. Expected version 1.`);
+	const compByName = /* @__PURE__ */ new Map();
+	for (const t of componentTypes) compByName.set(t.name, t);
+	const tagByName = /* @__PURE__ */ new Map();
+	for (const t of tagTypes) tagByName.set(t.name, t);
+	for (const entityId of world.query()) world.destroyEntity(entityId);
+	const idMap = /* @__PURE__ */ new Map();
+	for (const entry of doc.entities) {
+		const newId = world.createEntity();
+		idMap.set(entry.id, newId);
+		for (const [compName, data] of Object.entries(entry.components)) {
+			const type = compByName.get(compName);
+			if (type) world.addComponent(newId, type, data);
+		}
+		for (const tagName of entry.tags) {
+			const type = tagByName.get(tagName);
+			if (type) world.addTag(newId, type);
+		}
+	}
+	for (const [_oldId, newId] of idMap) {
+		const parent = world.getComponent(newId, require_hooks.Parent);
+		if (parent && idMap.has(parent.id)) {
+			const mappedId = idMap.get(parent.id);
+			if (mappedId !== void 0) world.setComponent(newId, require_hooks.Parent, { id: mappedId });
+		}
+		const children = world.getComponent(newId, require_hooks.Children);
+		if (children) world.setComponent(newId, require_hooks.Children, { ids: children.ids.map((id) => idMap.get(id) ?? id) });
+		const handleSet = world.getComponent(newId, require_hooks.HandleSet);
+		if (handleSet) world.setComponent(newId, require_hooks.HandleSet, { ids: handleSet.ids.map((id) => idMap.get(id) ?? id) });
+	}
 }
+/**
+* Serializes a subset of entities (e.g., for copy/paste).
+* Recursively includes children of the specified entities.
+*/
 function serializeEntities(world, entityIds, componentTypes, tagTypes) {
-  const result = [];
-  const visited = /* @__PURE__ */ new Set();
-  function visit(entityId) {
-    if (visited.has(entityId)) return;
-    visited.add(entityId);
-    const components = {};
-    const tags = [];
-    for (const type of componentTypes) {
-      const data = world.getComponent(entityId, type);
-      if (data !== void 0) {
-        components[type.name] = structuredClone(data);
-      }
-    }
-    for (const type of tagTypes) {
-      if (world.hasTag(entityId, type)) {
-        if (type.name !== "Active" && type.name !== "Visible") {
-          tags.push(type.name);
-        }
-      }
-    }
-    result.push({ id: entityId, components, tags });
-    const children = components.Children;
-    if (children?.ids) {
-      for (const childId of children.ids) {
-        visit(childId);
-      }
-    }
-  }
-  for (const id of entityIds) {
-    visit(id);
-  }
-  return result;
+	const result = [];
+	const visited = /* @__PURE__ */ new Set();
+	function visit(entityId) {
+		if (visited.has(entityId)) return;
+		visited.add(entityId);
+		const components = {};
+		const tags = [];
+		for (const type of componentTypes) {
+			const data = world.getComponent(entityId, type);
+			if (data !== void 0) components[type.name] = structuredClone(data);
+		}
+		for (const type of tagTypes) if (world.hasTag(entityId, type)) {
+			if (type.name !== "Active" && type.name !== "Visible") tags.push(type.name);
+		}
+		result.push({
+			id: entityId,
+			components,
+			tags
+		});
+		const children = components.Children;
+		if (children?.ids) for (const childId of children.ids) visit(childId);
+	}
+	for (const id of entityIds) visit(id);
+	return result;
 }
-
-Object.defineProperty(exports, "ContainerRefProvider", {
-  enumerable: true,
-  get: function () { return chunkVSHXWTJH_cjs.ContainerRefProvider; }
-});
-Object.defineProperty(exports, "EngineProvider", {
-  enumerable: true,
-  get: function () { return chunkVSHXWTJH_cjs.EngineProvider; }
-});
-Object.defineProperty(exports, "GridRenderer", {
-  enumerable: true,
-  get: function () { return chunkVSHXWTJH_cjs.GridRenderer; }
-});
-Object.defineProperty(exports, "Profiler", {
-  enumerable: true,
-  get: function () { return chunkVSHXWTJH_cjs.Profiler; }
-});
-Object.defineProperty(exports, "SelectionOverlaySlot", {
-  enumerable: true,
-  get: function () { return chunkVSHXWTJH_cjs.SelectionOverlaySlot; }
-});
-Object.defineProperty(exports, "SelectionRenderer", {
-  enumerable: true,
-  get: function () { return chunkVSHXWTJH_cjs.SelectionRenderer; }
-});
-Object.defineProperty(exports, "SpatialIndex", {
-  enumerable: true,
-  get: function () { return chunkVSHXWTJH_cjs.SpatialIndex; }
-});
-Object.defineProperty(exports, "SpatialIndexResource", {
-  enumerable: true,
-  get: function () { return chunkVSHXWTJH_cjs.SpatialIndexResource; }
-});
-Object.defineProperty(exports, "WebGLWidgetLayer", {
-  enumerable: true,
-  get: function () { return chunkVSHXWTJH_cjs.WebGLWidgetLayer; }
-});
-Object.defineProperty(exports, "WebGLWidgetSlot", {
-  enumerable: true,
-  get: function () { return chunkVSHXWTJH_cjs.WebGLWidgetSlot; }
-});
-Object.defineProperty(exports, "WidgetSlot", {
-  enumerable: true,
-  get: function () { return chunkVSHXWTJH_cjs.WidgetSlot; }
-});
-Object.defineProperty(exports, "computeSnapGuides", {
-  enumerable: true,
-  get: function () { return chunkVSHXWTJH_cjs.computeSnapGuides; }
-});
+//#endregion
+exports.ContainerRefProvider = require_hooks.ContainerRefProvider;
+exports.EngineProvider = require_hooks.EngineProvider;
+exports.GridRenderer = require_WebGLWidgetLayer.GridRenderer;
+exports.Profiler = require_WebGLWidgetLayer.Profiler;
+exports.SelectionOverlaySlot = require_WebGLWidgetLayer.SelectionOverlaySlot;
+exports.SelectionRenderer = require_WebGLWidgetLayer.SelectionRenderer;
+exports.SpatialIndex = require_WebGLWidgetLayer.SpatialIndex;
+exports.SpatialIndexResource = require_WebGLWidgetLayer.SpatialIndexResource;
+exports.WebGLWidgetLayer = require_WebGLWidgetLayer.WebGLWidgetLayer;
+exports.WebGLWidgetSlot = require_WebGLWidgetLayer.WebGLWidgetSlot;
+exports.WidgetSlot = require_WebGLWidgetLayer.WidgetSlot;
+exports.computeSnapGuides = require_WebGLWidgetLayer.computeSnapGuides;
 exports.deserializeWorld = deserializeWorld;
 exports.serializeEntities = serializeEntities;
 exports.serializeWorld = serializeWorld;
-//# sourceMappingURL=advanced.cjs.map
+
 //# sourceMappingURL=advanced.cjs.map

package/dist/advanced.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/serialization.ts"],"names":["Parent","Children","HandleSet"],"mappings":"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","file":"advanced.cjs","sourcesContent":["import type { ComponentType, EntityId, TagType, World } from '@jamesyong42/reactive-ecs';\nimport { Children, HandleSet, Parent } from './components.js';\nimport type { NavigationFrame } from './resources.js';\n\n// === Serialization Types ===\n\n/** JSON-serializable snapshot of the canvas state, including all entities and camera. */\nexport interface CanvasDocument {\n\tversion: number;\n\tentities: SerializedEntity[];\n\tresources: {\n\t\tcamera: { x: number; y: number; zoom: number };\n\t\tnavigationStack: NavigationFrame[];\n\t};\n}\n\n/** A single serialized entity with its components and tags. */\nexport interface SerializedEntity {\n\tid: EntityId;\n\tcomponents: Record<string, unknown>;\n\ttags: string[];\n}\n\n// === Serialize/Deserialize ===\n\n/**\n * Serializes all entities, components, and tags to a JSON-compatible document.\n * Requires registries of known component and tag types for enumeration.\n */\nexport function serializeWorld(\n\tworld: World,\n\tcomponentTypes: ComponentType[],\n\ttagTypes: TagType[],\n\tcamera: { x: number; y: number; zoom: number },\n\tnavigationFrames: NavigationFrame[],\n): CanvasDocument {\n\tconst entities: SerializedEntity[] = [];\n\n\t// Get all entity IDs (use a broad query)\n\tconst allEntities = world.query();\n\n\tfor (const entityId of allEntities) {\n\t\tconst components: Record<string, unknown> = {};\n\t\tconst tags: string[] = [];\n\n\t\tfor (const type of componentTypes) {\n\t\t\tconst data = world.getComponent(entityId, type);\n\t\t\tif (data !== undefined) {\n\t\t\t\tcomponents[type.name] = structuredClone(data);\n\t\t\t}\n\t\t}\n\n\t\tfor (const type of tagTypes) {\n\t\t\tif (world.hasTag(entityId, type)) {\n\t\t\t\t// Skip runtime-only tags (Active, Visible — they're recomputed)\n\t\t\t\tif (type.name !== 'Active' && type.name !== 'Visible') {\n\t\t\t\t\ttags.push(type.name);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif (Object.keys(components).length > 0 || tags.length > 0) {\n\t\t\tentities.push({ id: entityId, components, tags });\n\t\t}\n\t}\n\n\treturn {\n\t\tversion: 1,\n\t\tentities,\n\t\tresources: {\n\t\t\tcamera: { ...camera },\n\t\t\tnavigationStack: structuredClone(navigationFrames),\n\t\t},\n\t};\n}\n\n/**\n * Restores entities from a serialized document into the world.\n * Clears existing state first and remaps entity IDs automatically.\n */\nexport function deserializeWorld(\n\tworld: World,\n\tdoc: CanvasDocument,\n\tcomponentTypes: ComponentType[],\n\ttagTypes: TagType[],\n): void {\n\tif (doc.version !== 1) {\n\t\tthrow new Error(`Unsupported canvas document version: ${doc.version}. Expected version 1.`);\n\t}\n\n\t// Build lookup maps\n\tconst compByName = new Map<string, ComponentType>();\n\tfor (const t of componentTypes) compByName.set(t.name, t);\n\n\tconst tagByName = new Map<string, TagType>();\n\tfor (const t of tagTypes) tagByName.set(t.name, t);\n\n\t// Destroy all existing entities\n\tfor (const entityId of world.query()) {\n\t\tworld.destroyEntity(entityId);\n\t}\n\n\t// First pass: create entities and build old-to-new ID mapping\n\tconst idMap = new Map<EntityId, EntityId>();\n\n\tfor (const entry of doc.entities) {\n\t\tconst newId = world.createEntity();\n\t\tidMap.set(entry.id as EntityId, newId);\n\n\t\tfor (const [compName, data] of Object.entries(entry.components)) {\n\t\t\tconst type = compByName.get(compName);\n\t\t\tif (type) {\n\t\t\t\tworld.addComponent(newId, type, data);\n\t\t\t}\n\t\t}\n\n\t\tfor (const tagName of entry.tags) {\n\t\t\tconst type = tagByName.get(tagName);\n\t\t\tif (type) {\n\t\t\t\tworld.addTag(newId, type);\n\t\t\t}\n\t\t}\n\t}\n\n\t// Second pass: remap cross-reference components (Parent, Children, HandleSet)\n\tfor (const [_oldId, newId] of idMap) {\n\t\tconst parent = world.getComponent(newId, Parent);\n\t\tif (parent && idMap.has(parent.id)) {\n\t\t\tconst mappedId = idMap.get(parent.id);\n\t\t\tif (mappedId !== undefined) {\n\t\t\t\tworld.setComponent(newId, Parent, { id: mappedId });\n\t\t\t}\n\t\t}\n\n\t\tconst children = world.getComponent(newId, Children);\n\t\tif (children) {\n\t\t\tworld.setComponent(newId, Children, {\n\t\t\t\tids: children.ids.map((id: EntityId) => idMap.get(id) ?? id),\n\t\t\t});\n\t\t}\n\n\t\tconst handleSet = world.getComponent(newId, HandleSet);\n\t\tif (handleSet) {\n\t\t\tworld.setComponent(newId, HandleSet, {\n\t\t\t\tids: handleSet.ids.map((id: EntityId) => idMap.get(id) ?? id),\n\t\t\t});\n\t\t}\n\t}\n}\n\n/**\n * Serializes a subset of entities (e.g., for copy/paste).\n * Recursively includes children of the specified entities.\n */\nexport function serializeEntities(\n\tworld: World,\n\tentityIds: EntityId[],\n\tcomponentTypes: ComponentType[],\n\ttagTypes: TagType[],\n): SerializedEntity[] {\n\tconst result: SerializedEntity[] = [];\n\tconst visited = new Set<EntityId>();\n\n\tfunction visit(entityId: EntityId) {\n\t\tif (visited.has(entityId)) return;\n\t\tvisited.add(entityId);\n\n\t\tconst components: Record<string, unknown> = {};\n\t\tconst tags: string[] = [];\n\n\t\tfor (const type of componentTypes) {\n\t\t\tconst data = world.getComponent(entityId, type);\n\t\t\tif (data !== undefined) {\n\t\t\t\tcomponents[type.name] = structuredClone(data);\n\t\t\t}\n\t\t}\n\n\t\tfor (const type of tagTypes) {\n\t\t\tif (world.hasTag(entityId, type)) {\n\t\t\t\tif (type.name !== 'Active' && type.name !== 'Visible') {\n\t\t\t\t\ttags.push(type.name);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tresult.push({ id: entityId, components, tags });\n\n\t\t// Recurse into children. components.Children is typed as unknown via\n\t\t// the Record<string, unknown> shape, so narrow through a cast.\n\t\tconst children = components.Children as { ids?: EntityId[] } | undefined;\n\t\tif (children?.ids) {\n\t\t\tfor (const childId of children.ids) {\n\t\t\t\tvisit(childId);\n\t\t\t}\n\t\t}\n\t}\n\n\tfor (const id of entityIds) {\n\t\tvisit(id);\n\t}\n\n\treturn result;\n}\n"]}
+{"version":3,"file":"advanced.cjs","names":["Parent","Children","HandleSet"],"sources":["../src/serialization.ts"],"sourcesContent":["import type { ComponentType, EntityId, TagType, World } from '@jamesyong42/reactive-ecs';\nimport { Children, HandleSet, Parent } from './components.js';\nimport type { NavigationFrame } from './resources.js';\n\n// === Serialization Types ===\n\n/** JSON-serializable snapshot of the canvas state, including all entities and camera. */\nexport interface CanvasDocument {\n\tversion: number;\n\tentities: SerializedEntity[];\n\tresources: {\n\t\tcamera: { x: number; y: number; zoom: number };\n\t\tnavigationStack: NavigationFrame[];\n\t};\n}\n\n/** A single serialized entity with its components and tags. */\nexport interface SerializedEntity {\n\tid: EntityId;\n\tcomponents: Record<string, unknown>;\n\ttags: string[];\n}\n\n// === Serialize/Deserialize ===\n\n/**\n * Serializes all entities, components, and tags to a JSON-compatible document.\n * Requires registries of known component and tag types for enumeration.\n */\nexport function serializeWorld(\n\tworld: World,\n\tcomponentTypes: ComponentType[],\n\ttagTypes: TagType[],\n\tcamera: { x: number; y: number; zoom: number },\n\tnavigationFrames: NavigationFrame[],\n): CanvasDocument {\n\tconst entities: SerializedEntity[] = [];\n\n\t// Get all entity IDs (use a broad query)\n\tconst allEntities = world.query();\n\n\tfor (const entityId of allEntities) {\n\t\tconst components: Record<string, unknown> = {};\n\t\tconst tags: string[] = [];\n\n\t\tfor (const type of componentTypes) {\n\t\t\tconst data = world.getComponent(entityId, type);\n\t\t\tif (data !== undefined) {\n\t\t\t\tcomponents[type.name] = structuredClone(data);\n\t\t\t}\n\t\t}\n\n\t\tfor (const type of tagTypes) {\n\t\t\tif (world.hasTag(entityId, type)) {\n\t\t\t\t// Skip runtime-only tags (Active, Visible — they're recomputed)\n\t\t\t\tif (type.name !== 'Active' && type.name !== 'Visible') {\n\t\t\t\t\ttags.push(type.name);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif (Object.keys(components).length > 0 || tags.length > 0) {\n\t\t\tentities.push({ id: entityId, components, tags });\n\t\t}\n\t}\n\n\treturn {\n\t\tversion: 1,\n\t\tentities,\n\t\tresources: {\n\t\t\tcamera: { ...camera },\n\t\t\tnavigationStack: structuredClone(navigationFrames),\n\t\t},\n\t};\n}\n\n/**\n * Restores entities from a serialized document into the world.\n * Clears existing state first and remaps entity IDs automatically.\n */\nexport function deserializeWorld(\n\tworld: World,\n\tdoc: CanvasDocument,\n\tcomponentTypes: ComponentType[],\n\ttagTypes: TagType[],\n): void {\n\tif (doc.version !== 1) {\n\t\tthrow new Error(`Unsupported canvas document version: ${doc.version}. Expected version 1.`);\n\t}\n\n\t// Build lookup maps\n\tconst compByName = new Map<string, ComponentType>();\n\tfor (const t of componentTypes) compByName.set(t.name, t);\n\n\tconst tagByName = new Map<string, TagType>();\n\tfor (const t of tagTypes) tagByName.set(t.name, t);\n\n\t// Destroy all existing entities\n\tfor (const entityId of world.query()) {\n\t\tworld.destroyEntity(entityId);\n\t}\n\n\t// First pass: create entities and build old-to-new ID mapping\n\tconst idMap = new Map<EntityId, EntityId>();\n\n\tfor (const entry of doc.entities) {\n\t\tconst newId = world.createEntity();\n\t\tidMap.set(entry.id as EntityId, newId);\n\n\t\tfor (const [compName, data] of Object.entries(entry.components)) {\n\t\t\tconst type = compByName.get(compName);\n\t\t\tif (type) {\n\t\t\t\tworld.addComponent(newId, type, data);\n\t\t\t}\n\t\t}\n\n\t\tfor (const tagName of entry.tags) {\n\t\t\tconst type = tagByName.get(tagName);\n\t\t\tif (type) {\n\t\t\t\tworld.addTag(newId, type);\n\t\t\t}\n\t\t}\n\t}\n\n\t// Second pass: remap cross-reference components (Parent, Children, HandleSet)\n\tfor (const [_oldId, newId] of idMap) {\n\t\tconst parent = world.getComponent(newId, Parent);\n\t\tif (parent && idMap.has(parent.id)) {\n\t\t\tconst mappedId = idMap.get(parent.id);\n\t\t\tif (mappedId !== undefined) {\n\t\t\t\tworld.setComponent(newId, Parent, { id: mappedId });\n\t\t\t}\n\t\t}\n\n\t\tconst children = world.getComponent(newId, Children);\n\t\tif (children) {\n\t\t\tworld.setComponent(newId, Children, {\n\t\t\t\tids: children.ids.map((id: EntityId) => idMap.get(id) ?? id),\n\t\t\t});\n\t\t}\n\n\t\tconst handleSet = world.getComponent(newId, HandleSet);\n\t\tif (handleSet) {\n\t\t\tworld.setComponent(newId, HandleSet, {\n\t\t\t\tids: handleSet.ids.map((id: EntityId) => idMap.get(id) ?? id),\n\t\t\t});\n\t\t}\n\t}\n}\n\n/**\n * Serializes a subset of entities (e.g., for copy/paste).\n * Recursively includes children of the specified entities.\n */\nexport function serializeEntities(\n\tworld: World,\n\tentityIds: EntityId[],\n\tcomponentTypes: ComponentType[],\n\ttagTypes: TagType[],\n): SerializedEntity[] {\n\tconst result: SerializedEntity[] = [];\n\tconst visited = new Set<EntityId>();\n\n\tfunction visit(entityId: EntityId) {\n\t\tif (visited.has(entityId)) return;\n\t\tvisited.add(entityId);\n\n\t\tconst components: Record<string, unknown> = {};\n\t\tconst tags: string[] = [];\n\n\t\tfor (const type of componentTypes) {\n\t\t\tconst data = world.getComponent(entityId, type);\n\t\t\tif (data !== undefined) {\n\t\t\t\tcomponents[type.name] = structuredClone(data);\n\t\t\t}\n\t\t}\n\n\t\tfor (const type of tagTypes) {\n\t\t\tif (world.hasTag(entityId, type)) {\n\t\t\t\tif (type.name !== 'Active' && type.name !== 'Visible') {\n\t\t\t\t\ttags.push(type.name);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tresult.push({ id: entityId, components, tags });\n\n\t\t// Recurse into children. components.Children is typed as unknown via\n\t\t// the Record<string, unknown> shape, so narrow through a cast.\n\t\tconst children = components.Children as { ids?: EntityId[] } | undefined;\n\t\tif (children?.ids) {\n\t\t\tfor (const childId of children.ids) {\n\t\t\t\tvisit(childId);\n\t\t\t}\n\t\t}\n\t}\n\n\tfor (const id of entityIds) {\n\t\tvisit(id);\n\t}\n\n\treturn result;\n}\n"],"mappings":"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"}

package/dist/advanced.d.cts

@@ -1,71 +1,88 @@
-import { L as LayoutEngine, R as ResolvedWidget, a as R3FWidgetProps, N as NavigationFrame } from './SelectionRenderer-CeWSNZT8.cjs';
-export { C as ContainerRefProvider, E as EngineProvider, F as FrameSample, G as GridRenderer, P as Profiler, b as ProfilerStats, S as SelectionRenderer, c as SpatialIndex, d as SpatialIndexResource, e as computeSnapGuides } from './SelectionRenderer-CeWSNZT8.cjs';
-import * as react from 'react';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { EntityId, World, ComponentType, TagType } from '@jamesyong42/reactive-ecs';
-import 'three';
+import { A as NavigationFrame, C as computeSnapGuides, G as FrameTimeStats, J as R3FSample, K as Profiler, L as R3FWidgetProps, Q as WebGLStats, W as EcsStats, X as TickSample, Y as R3FStats, Z as WebGLPass, l as SpatialIndex, n as LayoutEngine, o as SpatialIndexResource, q as ProfilerStats } from "./engine-CCjuFMC-.cjs";
+import { c as ContainerRefProvider, i as SelectionRenderer, l as EngineProvider, s as GridRenderer, u as ResolvedWidget } from "./SelectionRenderer-CR2PBQwx.cjs";
+import { ComponentType, EntityId, TagType, World } from "@jamesyong42/reactive-ecs";
+import * as _$react from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
+//#region src/react/SelectionOverlaySlot.d.ts
 interface SelectionOverlaySlotProps {
-    entityId: EntityId;
-    slotRef: (entityId: EntityId, el: HTMLDivElement | null) => void;
+  entityId: EntityId;
+  slotRef: (entityId: EntityId, el: HTMLDivElement | null) => void;
 }
 /**
  * DOM overlay for WebGL widgets — provides selection frame and pointer
  * interaction (select, drag, resize) without rendering widget content.
  */
-declare const SelectionOverlaySlot: react.MemoExoticComponent<({ entityId, slotRef, }: SelectionOverlaySlotProps) => react_jsx_runtime.JSX.Element>;
-
+declare const SelectionOverlaySlot: _$react.MemoExoticComponent<({
+  entityId,
+  slotRef
+}: SelectionOverlaySlotProps) => _$react_jsx_runtime0.JSX.Element>;
+//#endregion
+//#region src/react/WidgetSlot.d.ts
 interface WidgetSlotProps {
-    entityId: EntityId;
-    slotRef: (entityId: EntityId, el: HTMLDivElement | null) => void;
+  entityId: EntityId;
+  slotRef: (entityId: EntityId, el: HTMLDivElement | null) => void;
 }
-declare const WidgetSlot: react.MemoExoticComponent<({ entityId, slotRef }: WidgetSlotProps) => react_jsx_runtime.JSX.Element>;
-
+declare const WidgetSlot: _$react.MemoExoticComponent<({
+  entityId,
+  slotRef
+}: WidgetSlotProps) => _$react_jsx_runtime0.JSX.Element>;
+//#endregion
+//#region src/react/webgl/WebGLWidgetLayer.d.ts
 interface WebGLWidgetLayerProps {
-    engine: LayoutEngine;
-    entities: EntityId[];
-    resolve: (entityId: EntityId) => ResolvedWidget | null;
+  engine: LayoutEngine;
+  entities: EntityId[];
+  resolve: (entityId: EntityId) => ResolvedWidget | null;
 }
-declare function WebGLWidgetLayer({ engine, entities, resolve }: WebGLWidgetLayerProps): react_jsx_runtime.JSX.Element;
-
+declare function WebGLWidgetLayer({
+  engine,
+  entities,
+  resolve
+}: WebGLWidgetLayerProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/react/webgl/WebGLWidgetSlot.d.ts
 interface WebGLWidgetSlotProps {
-    entityId: EntityId;
-    component: React.ComponentType<R3FWidgetProps>;
+  entityId: EntityId;
+  component: React.ComponentType<R3FWidgetProps>;
 }
 /**
  * Positions a Three.js Group at the entity's world-space center.
  * The widget component renders in local space: origin at center,
  * X right, Y up, dimensions = (width, height) in world units.
  */
-declare function WebGLWidgetSlot({ entityId, component: WidgetComponent }: WebGLWidgetSlotProps): react_jsx_runtime.JSX.Element | null;
-
+declare function WebGLWidgetSlot({
+  entityId,
+  component: WidgetComponent
+}: WebGLWidgetSlotProps): _$react_jsx_runtime0.JSX.Element | null;
+//#endregion
+//#region src/serialization.d.ts
 /** JSON-serializable snapshot of the canvas state, including all entities and camera. */
 interface CanvasDocument {
-    version: number;
-    entities: SerializedEntity[];
-    resources: {
-        camera: {
-            x: number;
-            y: number;
-            zoom: number;
-        };
-        navigationStack: NavigationFrame[];
+  version: number;
+  entities: SerializedEntity[];
+  resources: {
+    camera: {
+      x: number;
+      y: number;
+      zoom: number;
     };
+    navigationStack: NavigationFrame[];
+  };
 }
 /** A single serialized entity with its components and tags. */
 interface SerializedEntity {
-    id: EntityId;
-    components: Record<string, unknown>;
-    tags: string[];
+  id: EntityId;
+  components: Record<string, unknown>;
+  tags: string[];
 }
 /**
  * Serializes all entities, components, and tags to a JSON-compatible document.
  * Requires registries of known component and tag types for enumeration.
  */
 declare function serializeWorld(world: World, componentTypes: ComponentType[], tagTypes: TagType[], camera: {
-    x: number;
-    y: number;
-    zoom: number;
+  x: number;
+  y: number;
+  zoom: number;
 }, navigationFrames: NavigationFrame[]): CanvasDocument;
 /**
  * Restores entities from a serialized document into the world.
@@ -77,5 +94,6 @@ declare function deserializeWorld(world: World, doc: CanvasDocument, componentTy
  * Recursively includes children of the specified entities.
  */
 declare function serializeEntities(world: World, entityIds: EntityId[], componentTypes: ComponentType[], tagTypes: TagType[]): SerializedEntity[];
-
-export { type CanvasDocument, SelectionOverlaySlot, type SerializedEntity, WebGLWidgetLayer, WebGLWidgetSlot, WidgetSlot, deserializeWorld, serializeEntities, serializeWorld };
+//#endregion
+export { type CanvasDocument, ContainerRefProvider, type EcsStats, EngineProvider, type FrameTimeStats, GridRenderer, Profiler, type ProfilerStats, type R3FSample, type R3FStats, SelectionOverlaySlot, SelectionRenderer, type SerializedEntity, SpatialIndex, SpatialIndexResource, type TickSample, type WebGLPass, type WebGLStats, WebGLWidgetLayer, WebGLWidgetSlot, WidgetSlot, computeSnapGuides, deserializeWorld, serializeEntities, serializeWorld };
+//# sourceMappingURL=advanced.d.cts.map

package/dist/advanced.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.d.cts","names":[],"sources":["../src/react/SelectionOverlaySlot.tsx","../src/react/WidgetSlot.tsx","../src/react/webgl/WebGLWidgetLayer.tsx","../src/react/webgl/WebGLWidgetSlot.tsx","../src/serialization.ts"],"mappings":";;;;;;;UAMU,yBAAA;EACT,QAAA,EAAU,QAAA;EACV,OAAA,GAAU,QAAA,EAAU,QAAA,EAAU,EAAA,EAAI,cAAA;AAAA;;;AARuB;;cAmB7C,oBAAA,EAGe,OAAA,CAHK,mBAAA;EAAA,QAAA;EAAA;AAAA,GAG9B,yBAAA,KAAyB,oBAAA,CAAA,GAAA,CAAA,OAAA;;;UCflB,eAAA;EACT,QAAA,EAAU,QAAA;EACV,OAAA,GAAU,QAAA,EAAU,QAAA,EAAU,EAAA,EAAI,cAAA;AAAA;AAAA,cAOtB,UAAA,EAA4E,OAAA,CAAlE,mBAAA;EAAA,QAAA;EAAA;AAAA,GAAmD,eAAA,KAAe,oBAAA,CAAA,GAAA,CAAA,OAAA;;;UCgG/E,qBAAA;EACT,MAAA,EAAQ,YAAA;EACR,QAAA,EAAU,QAAA;EACV,OAAA,GAAU,QAAA,EAAU,QAAA,KAAa,cAAA;AAAA;AAAA,iBAGlB,gBAAA,CAAA;EAAmB,MAAA;EAAQ,QAAA;EAAU;AAAA,GAAW,qBAAA,GAAqB,oBAAA,CAAA,GAAA,CAAA,OAAA;;;UC7G3E,oBAAA;EACT,QAAA,EAAU,QAAA;EACV,SAAA,EAAW,KAAA,CAAM,aAAA,CAAc,cAAA;AAAA;;AHX0B;;;;iBGmB1C,eAAA,CAAA;EAAkB,QAAA;EAAU,SAAA,EAAW;AAAA,GAAmB,oBAAA,GAAoB,oBAAA,CAAA,GAAA,CAAA,OAAA;;;;UCZ7E,cAAA;EAChB,OAAA;EACA,QAAA,EAAU,gBAAA;EACV,SAAA;IACC,MAAA;MAAU,CAAA;MAAW,CAAA;MAAW,IAAA;IAAA;IAChC,eAAA,EAAiB,eAAA;EAAA;AAAA;;UAKF,gBAAA;EAChB,EAAA,EAAI,QAAA;EACJ,UAAA,EAAY,MAAA;EACZ,IAAA;AAAA;;;;AJDD;iBIUgB,cAAA,CACf,KAAA,EAAO,KAAA,EACP,cAAA,EAAgB,aAAA,IAChB,QAAA,EAAU,OAAA,IACV,MAAA;EAAU,CAAA;EAAW,CAAA;EAAW,IAAA;AAAA,GAChC,gBAAA,EAAkB,eAAA,KAChB,cAAA;;;;;iBA6Ca,gBAAA,CACf,KAAA,EAAO,KAAA,EACP,GAAA,EAAK,cAAA,EACL,cAAA,EAAgB,aAAA,IAChB,QAAA,EAAU,OAAA;;;;;iBAsEK,iBAAA,CACf,KAAA,EAAO,KAAA,EACP,SAAA,EAAW,QAAA,IACX,cAAA,EAAgB,aAAA,IAChB,QAAA,EAAU,OAAA,KACR,gBAAA"}

package/dist/advanced.d.mts

@@ -0,0 +1,99 @@
+import { A as NavigationFrame, C as computeSnapGuides, G as FrameTimeStats, J as R3FSample, K as Profiler, L as R3FWidgetProps, Q as WebGLStats, W as EcsStats, X as TickSample, Y as R3FStats, Z as WebGLPass, l as SpatialIndex, n as LayoutEngine, o as SpatialIndexResource, q as ProfilerStats } from "./engine-BfbvWXSk.mjs";
+import { c as ContainerRefProvider, i as SelectionRenderer, l as EngineProvider, s as GridRenderer, u as ResolvedWidget } from "./SelectionRenderer-DlsBstAq.mjs";
+import { ComponentType, EntityId, TagType, World } from "@jamesyong42/reactive-ecs";
+import * as _$react from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/react/SelectionOverlaySlot.d.ts
+interface SelectionOverlaySlotProps {
+  entityId: EntityId;
+  slotRef: (entityId: EntityId, el: HTMLDivElement | null) => void;
+}
+/**
+ * DOM overlay for WebGL widgets — provides selection frame and pointer
+ * interaction (select, drag, resize) without rendering widget content.
+ */
+declare const SelectionOverlaySlot: _$react.MemoExoticComponent<({
+  entityId,
+  slotRef
+}: SelectionOverlaySlotProps) => _$react_jsx_runtime0.JSX.Element>;
+//#endregion
+//#region src/react/WidgetSlot.d.ts
+interface WidgetSlotProps {
+  entityId: EntityId;
+  slotRef: (entityId: EntityId, el: HTMLDivElement | null) => void;
+}
+declare const WidgetSlot: _$react.MemoExoticComponent<({
+  entityId,
+  slotRef
+}: WidgetSlotProps) => _$react_jsx_runtime0.JSX.Element>;
+//#endregion
+//#region src/react/webgl/WebGLWidgetLayer.d.ts
+interface WebGLWidgetLayerProps {
+  engine: LayoutEngine;
+  entities: EntityId[];
+  resolve: (entityId: EntityId) => ResolvedWidget | null;
+}
+declare function WebGLWidgetLayer({
+  engine,
+  entities,
+  resolve
+}: WebGLWidgetLayerProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/react/webgl/WebGLWidgetSlot.d.ts
+interface WebGLWidgetSlotProps {
+  entityId: EntityId;
+  component: React.ComponentType<R3FWidgetProps>;
+}
+/**
+ * Positions a Three.js Group at the entity's world-space center.
+ * The widget component renders in local space: origin at center,
+ * X right, Y up, dimensions = (width, height) in world units.
+ */
+declare function WebGLWidgetSlot({
+  entityId,
+  component: WidgetComponent
+}: WebGLWidgetSlotProps): _$react_jsx_runtime0.JSX.Element | null;
+//#endregion
+//#region src/serialization.d.ts
+/** JSON-serializable snapshot of the canvas state, including all entities and camera. */
+interface CanvasDocument {
+  version: number;
+  entities: SerializedEntity[];
+  resources: {
+    camera: {
+      x: number;
+      y: number;
+      zoom: number;
+    };
+    navigationStack: NavigationFrame[];
+  };
+}
+/** A single serialized entity with its components and tags. */
+interface SerializedEntity {
+  id: EntityId;
+  components: Record<string, unknown>;
+  tags: string[];
+}
+/**
+ * Serializes all entities, components, and tags to a JSON-compatible document.
+ * Requires registries of known component and tag types for enumeration.
+ */
+declare function serializeWorld(world: World, componentTypes: ComponentType[], tagTypes: TagType[], camera: {
+  x: number;
+  y: number;
+  zoom: number;
+}, navigationFrames: NavigationFrame[]): CanvasDocument;
+/**
+ * Restores entities from a serialized document into the world.
+ * Clears existing state first and remaps entity IDs automatically.
+ */
+declare function deserializeWorld(world: World, doc: CanvasDocument, componentTypes: ComponentType[], tagTypes: TagType[]): void;
+/**
+ * Serializes a subset of entities (e.g., for copy/paste).
+ * Recursively includes children of the specified entities.
+ */
+declare function serializeEntities(world: World, entityIds: EntityId[], componentTypes: ComponentType[], tagTypes: TagType[]): SerializedEntity[];
+//#endregion
+export { type CanvasDocument, ContainerRefProvider, type EcsStats, EngineProvider, type FrameTimeStats, GridRenderer, Profiler, type ProfilerStats, type R3FSample, type R3FStats, SelectionOverlaySlot, SelectionRenderer, type SerializedEntity, SpatialIndex, SpatialIndexResource, type TickSample, type WebGLPass, type WebGLStats, WebGLWidgetLayer, WebGLWidgetSlot, WidgetSlot, computeSnapGuides, deserializeWorld, serializeEntities, serializeWorld };
+//# sourceMappingURL=advanced.d.mts.map

package/dist/advanced.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.d.mts","names":[],"sources":["../src/react/SelectionOverlaySlot.tsx","../src/react/WidgetSlot.tsx","../src/react/webgl/WebGLWidgetLayer.tsx","../src/react/webgl/WebGLWidgetSlot.tsx","../src/serialization.ts"],"mappings":";;;;;;;UAMU,yBAAA;EACT,QAAA,EAAU,QAAA;EACV,OAAA,GAAU,QAAA,EAAU,QAAA,EAAU,EAAA,EAAI,cAAA;AAAA;;;AARuB;;cAmB7C,oBAAA,EAGe,OAAA,CAHK,mBAAA;EAAA,QAAA;EAAA;AAAA,GAG9B,yBAAA,KAAyB,oBAAA,CAAA,GAAA,CAAA,OAAA;;;UCflB,eAAA;EACT,QAAA,EAAU,QAAA;EACV,OAAA,GAAU,QAAA,EAAU,QAAA,EAAU,EAAA,EAAI,cAAA;AAAA;AAAA,cAOtB,UAAA,EAA4E,OAAA,CAAlE,mBAAA;EAAA,QAAA;EAAA;AAAA,GAAmD,eAAA,KAAe,oBAAA,CAAA,GAAA,CAAA,OAAA;;;UCgG/E,qBAAA;EACT,MAAA,EAAQ,YAAA;EACR,QAAA,EAAU,QAAA;EACV,OAAA,GAAU,QAAA,EAAU,QAAA,KAAa,cAAA;AAAA;AAAA,iBAGlB,gBAAA,CAAA;EAAmB,MAAA;EAAQ,QAAA;EAAU;AAAA,GAAW,qBAAA,GAAqB,oBAAA,CAAA,GAAA,CAAA,OAAA;;;UC7G3E,oBAAA;EACT,QAAA,EAAU,QAAA;EACV,SAAA,EAAW,KAAA,CAAM,aAAA,CAAc,cAAA;AAAA;;AHX0B;;;;iBGmB1C,eAAA,CAAA;EAAkB,QAAA;EAAU,SAAA,EAAW;AAAA,GAAmB,oBAAA,GAAoB,oBAAA,CAAA,GAAA,CAAA,OAAA;;;;UCZ7E,cAAA;EAChB,OAAA;EACA,QAAA,EAAU,gBAAA;EACV,SAAA;IACC,MAAA;MAAU,CAAA;MAAW,CAAA;MAAW,IAAA;IAAA;IAChC,eAAA,EAAiB,eAAA;EAAA;AAAA;;UAKF,gBAAA;EAChB,EAAA,EAAI,QAAA;EACJ,UAAA,EAAY,MAAA;EACZ,IAAA;AAAA;;;;AJDD;iBIUgB,cAAA,CACf,KAAA,EAAO,KAAA,EACP,cAAA,EAAgB,aAAA,IAChB,QAAA,EAAU,OAAA,IACV,MAAA;EAAU,CAAA;EAAW,CAAA;EAAW,IAAA;AAAA,GAChC,gBAAA,EAAkB,eAAA,KAChB,cAAA;;;;;iBA6Ca,gBAAA,CACf,KAAA,EAAO,KAAA,EACP,GAAA,EAAK,cAAA,EACL,cAAA,EAAgB,aAAA,IAChB,QAAA,EAAU,OAAA;;;;;iBAsEK,iBAAA,CACf,KAAA,EAAO,KAAA,EACP,SAAA,EAAW,QAAA,IACX,cAAA,EAAgB,aAAA,IAChB,QAAA,EAAU,OAAA,KACR,gBAAA"}