brs-js 3.1.0 → 3.2.1

package/dist/dist.mjs

@@ -10398,7 +10398,7 @@ var ca = (e) => ({
 }, pa = (e) => e.u8(192), ma = (e, t) => e.u8(t ? 195 : 194);
 function ha(e, t) {
 	if (t < 0 || t > 255 || !Number.isInteger(t)) throw RangeError(`brdb: u8 value out of range: ${t}`);
-	t <= 127 || t > 224 || e.u8(204), e.u8(t);
+	t <= 127 || t > 224 || e.u8(208), e.u8(t);
 }
 function ga(e, t) {
 	if (fa(t, "uint"), t < 0) throw RangeError(`brdb: uint value negative: ${t}`);
@@ -12793,7 +12793,7 @@ var ro = class {
 	}
 }, ao = class {
 	constructor() {
-		this.counters = [], this.brickIndices = [], this.trailing = [], this.numComponents = 0;
+		this.counters = [], this.brickIndices = [], this.trailing = [], this.microchipBrickIndices = [], this.microchipGridReferences = [], this.numComponents = 0;
 	}
 	add(e, t, n, r) {
 		let i = this.counters[this.counters.length - 1];
@@ -12805,6 +12805,9 @@ var ro = class {
 			data: r
 		}), this.numComponents += 1;
 	}
+	addMicrochipLink(e, t) {
+		this.microchipBrickIndices.push(e), this.microchipGridReferences.push(t);
+	}
 	toBytes(e) {
 		let t = new Ui();
 		e.writeValue(t, "BRSavedComponentChunkSoA", {
@@ -12814,15 +12817,55 @@ var ro = class {
 			JointEntityReferences: [],
 			JointInitialRelativeOffsets: [],
 			JointInitialRelativeRotations: [],
-			MicrochipBrickIndices: [],
-			MicrochipBrickGridReferences: []
+			MicrochipBrickIndices: this.microchipBrickIndices,
+			MicrochipBrickGridReferences: this.microchipGridReferences
 		});
 		for (let n of this.trailing) e.writeValue(t, n.structName, e.fillStruct(n.structName, n.data, ea.get(n.structName)));
 		return t.toBytes();
 	}
 };
-function oo(e, t = {}) {
-	let n = no(e), r = new ro(), i = new ro(), a = new ro();
+function oo(e) {
+	let t = [{
+		guid: aa,
+		name: "PUBLIC",
+		display: "PUBLIC"
+	}];
+	for (let n of e ?? []) t.push({
+		guid: oa(n.id ?? "00000000-0000-0000-0000-000000000000"),
+		name: n.name ?? "Unknown",
+		display: n.display_name ?? n.name ?? "Unknown"
+	});
+	return t;
+}
+function so(e, t = {}) {
+	let n = no(e), r = (e.wires ?? []).filter((e) => "component_type" in e.source);
+	return co({
+		description: e.description,
+		authorName: e.author?.name,
+		ownerRows: oo(e.brick_owners),
+		grids: [n],
+		gridIds: [1],
+		entities: [],
+		wires: r.map((e) => ({
+			source: {
+				gridSlot: 0,
+				brickIndex: e.source.brick_index,
+				componentType: e.source.component_type,
+				port: e.source.port
+			},
+			target: {
+				gridSlot: 0,
+				brickIndex: e.target.brick_index,
+				componentType: e.target.component_type,
+				port: e.target.port
+			}
+		})),
+		microchipLinks: [],
+		prefab: null
+	}, t);
+}
+function co(e, t = {}) {
+	let n = e.grids.flat(), r = new ro(), i = new ro(), a = new ro();
 	for (let e of n) r.add(e.materialName), (e.procedural ? a : i).add(e.assetName);
 	if (r.size > 256) throw Error(`brdb: too many distinct materials (${r.size}); MaterialIndices is u8 (max 256)`);
 	let o = {
@@ -12834,193 +12877,484 @@ function oo(e, t = {}) {
 		let e = c.size;
 		c.add(t.type) === e && l.push($i.get(t.type));
 	}
-	let u = (e.wires ?? []).filter((e) => "component_type" in e.source), d = new ro();
-	u.forEach((e, t) => {
-		for (let [r, i] of [["source", e.source], ["target", e.target]]) {
-			if (!Number.isInteger(i.brick_index) || i.brick_index < 0 || i.brick_index >= n.length) throw Error(`brdb: wires[${t}].${r}: brick_index ${i.brick_index} out of range`);
-			if (!c.has(i.component_type)) throw Error(`brdb: wires[${t}].${r}: component type '${i.component_type}' is not used by any brick`);
-			d.add(i.port);
+	let u = new ro();
+	e.wires.forEach((t, n) => {
+		for (let [r, i] of [["source", t.source], ["target", t.target]]) {
+			let t = e.grids[i.gridSlot]?.length ?? 0;
+			if (!Number.isInteger(i.brickIndex) || i.brickIndex < 0 || i.brickIndex >= t) throw Error(`brdb: wires[${n}].${r}: brick_index ${i.brickIndex} out of range`);
+			if (!c.has(i.componentType)) throw Error(`brdb: wires[${n}].${r}: component type '${i.componentType}' is not used by any brick`);
+			u.add(i.port);
 		}
 	});
-	let f = Ja.fromData(Ba.BRSavedComponentChunkSoA);
+	let d = new ro(), f = [];
+	for (let t of e.entities) {
+		let e = d.size;
+		d.add(t.type) === e && f.push(t.className);
+	}
+	let p = Ja.fromData(Ba.BRSavedComponentChunkSoA);
 	if (c.size > 0) {
 		let e = [];
 		for (let t of l) t !== "None" && !e.includes(t) && e.push(t);
-		f.merge(Xa("BRSavedComponentChunkSoA_max").extractStructsTransitive(e));
-	}
-	let p = [{
-		guid: aa,
-		name: "PUBLIC",
-		display: "PUBLIC"
-	}];
-	for (let t of e.brick_owners ?? []) p.push({
-		guid: oa(t.id ?? "00000000-0000-0000-0000-000000000000"),
-		name: t.name ?? "Unknown",
-		display: t.display_name ?? t.name ?? "Unknown"
-	});
-	let m = p.map(() => 0), h = p.map(() => 0), g = [], _ = /* @__PURE__ */ new Map(), v = /* @__PURE__ */ new Map(), y = [];
-	for (let e of n) {
-		let { chunk: t, rel: n } = to(e.position), r = t.join("_"), i = _.get(r);
-		i || (i = {
-			index: t,
-			builder: new io()
-		}, _.set(r, i), g.push(r));
-		let a = i.builder.numBricks;
-		if (i.builder.addBrick(e, n, o, s), y.push({
-			key: r,
-			chunk: t,
-			localIndex: a
-		}), m[e.ownerIndex] += 1, e.components.length > 0) {
-			h[e.ownerIndex] += e.components.length;
-			let t = v.get(r);
-			t || v.set(r, t = new ao());
-			for (let n of e.components) {
-				let e = c.indexOf(n.type);
-				t.add(e, a, l[e], n.data ?? {});
+		p.merge(Xa("BRSavedComponentChunkSoA_max").extractStructsTransitive(e));
+	}
+	let m = e.ownerRows, h = m.map(() => 0), g = m.map(() => 0), _ = m.map(() => 0);
+	for (let t of e.entities) _[t.ownerIndex] += 1;
+	let v = e.grids.map((e) => {
+		let t = {
+			chunkOrder: [],
+			chunks: /* @__PURE__ */ new Map(),
+			componentChunks: /* @__PURE__ */ new Map(),
+			brickLocations: [],
+			wireChunks: /* @__PURE__ */ new Map(),
+			chunkWireCounts: /* @__PURE__ */ new Map()
+		};
+		for (let n of e) {
+			let { chunk: e, rel: r } = to(n.position), i = e.join("_"), a = t.chunks.get(i);
+			a || (a = {
+				index: e,
+				builder: new io()
+			}, t.chunks.set(i, a), t.chunkOrder.push(i));
+			let u = a.builder.numBricks;
+			if (a.builder.addBrick(n, r, o, s), t.brickLocations.push({
+				key: i,
+				chunk: e,
+				localIndex: u
+			}), h[n.ownerIndex] += 1, n.components.length > 0) {
+				g[n.ownerIndex] += n.components.length;
+				let e = t.componentChunks.get(i);
+				e || t.componentChunks.set(i, e = new ao());
+				for (let t of n.components) {
+					let n = c.indexOf(t.type);
+					e.add(n, u, l[n], t.data ?? {});
+				}
 			}
 		}
-	}
-	let b = /* @__PURE__ */ new Map(), x = /* @__PURE__ */ new Map();
-	for (let e of u) {
-		let t = y[e.source.brick_index], n = y[e.target.brick_index], r = {
-			BrickIndexInChunk: n.localIndex,
-			ComponentTypeIndex: c.indexOf(e.target.component_type),
-			PortIndex: d.indexOf(e.target.port)
-		}, i = b.get(n.key);
-		i || b.set(n.key, i = {
+		return t;
+	});
+	for (let t of e.microchipLinks) {
+		let e = v[t.gridSlot], n = e?.brickLocations[t.brickIndex];
+		if (!n) throw Error(`brdb: microchip link brick index ${t.brickIndex} out of range`);
+		let r = e.componentChunks.get(n.key);
+		r || e.componentChunks.set(n.key, r = new ao()), r.addMicrochipLink(n.localIndex, t.gridReference);
+	}
+	for (let t of e.wires) {
+		let n = v[t.source.gridSlot].brickLocations[t.source.brickIndex], r = v[t.target.gridSlot], i = r.brickLocations[t.target.brickIndex], a = {
+			BrickIndexInChunk: i.localIndex,
+			ComponentTypeIndex: c.indexOf(t.target.componentType),
+			PortIndex: u.indexOf(t.target.port)
+		}, o = r.wireChunks.get(i.key);
+		o || r.wireChunks.set(i.key, o = {
 			remoteSources: [],
 			localSources: [],
 			remoteTargets: [],
 			localTargets: []
-		}), x.set(n.key, (x.get(n.key) ?? 0) + 1), t.key === n.key ? (i.localSources.push({
-			BrickIndexInChunk: t.localIndex,
-			ComponentTypeIndex: c.indexOf(e.source.component_type),
-			PortIndex: d.indexOf(e.source.port)
-		}), i.localTargets.push(r)) : (i.remoteSources.push({
-			GridPersistentIndex: 1,
+		}), r.chunkWireCounts.set(i.key, (r.chunkWireCounts.get(i.key) ?? 0) + 1), t.source.gridSlot === t.target.gridSlot && n.key === i.key ? (o.localSources.push({
+			BrickIndexInChunk: n.localIndex,
+			ComponentTypeIndex: c.indexOf(t.source.componentType),
+			PortIndex: u.indexOf(t.source.port)
+		}), o.localTargets.push(a)) : (o.remoteSources.push({
+			GridPersistentIndex: e.gridIds[t.source.gridSlot],
 			ChunkIndex: {
-				X: t.chunk[0],
-				Y: t.chunk[1],
-				Z: t.chunk[2]
-			},
-			BrickIndexInChunk: t.localIndex,
-			ComponentTypeIndex: c.indexOf(e.source.component_type),
-			PortIndex: d.indexOf(e.source.port)
-		}), i.remoteTargets.push(r));
-	}
-	let S = Xa("BRSavedGlobalDataSoA"), C = Xa("BRSavedOwnerTableSoA"), w = Xa("BRSavedBrickChunkIndexSoA"), T = Xa("BRSavedBrickChunkSoA"), E = Xa("BRSavedWireChunkSoA"), D = Xa("BRSavedEntityChunkIndexSoA"), O = Xa("BRSavedEntityChunkSoA"), k = S.encode("BRSavedGlobalDataSoA", {
-		EntityTypeNames: [],
-		EntityDataClassNames: [],
+				X: n.chunk[0],
+				Y: n.chunk[1],
+				Z: n.chunk[2]
+			},
+			BrickIndexInChunk: n.localIndex,
+			ComponentTypeIndex: c.indexOf(t.source.componentType),
+			PortIndex: u.indexOf(t.source.port)
+		}), o.remoteTargets.push(a));
+	}
+	let y = Xa("BRSavedGlobalDataSoA"), b = Xa("BRSavedOwnerTableSoA"), x = Xa("BRSavedBrickChunkIndexSoA"), S = Xa("BRSavedBrickChunkSoA"), C = Xa("BRSavedWireChunkSoA"), w = Xa("BRSavedEntityChunkIndexSoA"), T = Xa("BRSavedEntityChunkSoA"), E = y.encode("BRSavedGlobalDataSoA", {
+		EntityTypeNames: d.names,
+		EntityDataClassNames: f,
 		BasicBrickAssetNames: i.names,
 		ProceduralBrickAssetNames: a.names,
 		MaterialAssetNames: r.names,
 		ComponentTypeNames: c.names,
 		ComponentDataStructNames: l,
-		ComponentWirePortNames: d.names,
+		ComponentWirePortNames: u.names,
 		ExternalAssetReferences: [],
 		GlobalGridEntityTypeIndex: -1
-	}), A = C.encode("BRSavedOwnerTableSoA", {
-		UserIds: p.map((e) => ({
+	}), D = b.encode("BRSavedOwnerTableSoA", {
+		UserIds: m.map((e) => ({
 			A: e.guid.A,
 			B: e.guid.B,
 			C: e.guid.C,
 			D: e.guid.D
 		})),
-		UserNames: p.map((e) => e.name),
-		DisplayNames: p.map((e) => e.display),
-		EntityCounts: p.map(() => 0),
-		BrickCounts: m,
-		ComponentCounts: h,
-		WireCounts: p.map(() => 0)
-	}), j = w.encode("BRSavedBrickChunkIndexSoA", {
-		Chunk3DIndices: g.map((e) => {
-			let [t, n, r] = _.get(e).index;
-			return {
-				X: t,
-				Y: n,
-				Z: r
-			};
-		}),
-		ChunkOffsets: g.map((e) => {
-			let t = _.get(e).index.every((e) => e === 0) ? 0 : Qa;
-			return {
-				X: t,
-				Y: t,
-				Z: t
-			};
-		}),
-		ChunkSizes: g.map(() => Za),
-		NumBricks: g.map((e) => _.get(e).builder.numBricks),
-		NumComponents: g.map((e) => v.get(e)?.numComponents ?? 0),
-		NumWires: g.map((e) => x.get(e) ?? 0)
-	}), M = D.encode("BRSavedEntityChunkIndexSoA", {
-		NextPersistentIndex: 2,
-		Chunk3DIndices: [],
-		NumEntities: []
-	}), ee = new TextEncoder(), te = {
-		type: "World",
+		UserNames: m.map((e) => e.name),
+		DisplayNames: m.map((e) => e.display),
+		EntityCounts: _,
+		BrickCounts: h,
+		ComponentCounts: g,
+		WireCounts: m.map(() => 0)
+	}), O = e.entities.length, k = w.encode("BRSavedEntityChunkIndexSoA", {
+		NextPersistentIndex: 2 + O,
+		Chunk3DIndices: O ? [{
+			X: 0,
+			Y: 0,
+			Z: 0
+		}] : [],
+		NumEntities: O ? [O] : []
+	}), A = null;
+	if (O > 0) {
+		let t = [], n = new Rr(), r = new Rr();
+		for (let i of e.entities) {
+			let e = d.indexOf(i.type), a = t[t.length - 1];
+			a && a.TypeIndex === e ? a.NumEntities += 1 : t.push({
+				TypeIndex: e,
+				NumEntities: 1
+			}), n.push(i.frozen), r.push(i.sleeping);
+		}
+		let i = new Ui();
+		T.writeValue(i, "BRSavedEntityChunkSoA", {
+			TypeCounters: t,
+			PersistentIndices: e.entities.map((e, t) => 2 + t),
+			OwnerIndices: e.entities.map((e) => e.ownerIndex),
+			OriginalOwnerIndices: e.entities.map((e) => e.ownerIndex),
+			Locations: e.entities.map((e) => e.location),
+			Rotations: e.entities.map((e) => e.rotation),
+			WeldParentFlags: { Flags: [] },
+			PhysicsLockedFlags: n.toValue(),
+			PhysicsSleepingFlags: r.toValue(),
+			WeldParentIndices: [],
+			LinearVelocities: e.entities.map((e) => e.velocity),
+			AngularVelocities: e.entities.map((e) => e.angularVelocity),
+			ColorsAndAlphas: e.entities.map((e) => Object.fromEntries(e.colors.map((e, t) => [`Color${t}`, e]))),
+			RemainingLifeSpans: e.entities.map(() => 0),
+			bColorsAreLinear: !1
+		}), e.entities.forEach((e, t) => {
+			if (e.className !== "None") try {
+				T.writeValue(i, e.className, T.fillStruct(e.className, e.data));
+			} catch (n) {
+				throw Error(`brdb: entities[${t}] (${e.type}) data: ${n.message}`);
+			}
+		}), A = i.toBytes();
+	}
+	let j = new TextEncoder(), M = {
+		type: e.prefab ? "Prefab" : "World",
 		iD: "00000000-0000-0000-0000-000000000000",
 		name: "",
 		version: "",
 		tags: [],
-		authors: e.author?.name ? [e.author.name] : [],
+		authors: e.authorName ? [e.authorName] : [],
 		createdAt: "0001.01.01-00.00.00",
 		updatedAt: "0001.01.01-00.00.00",
 		description: e.description ?? "A Generated World",
 		dependencies: [],
 		gameVersion: "CL0",
 		...t.bundle
-	}, ne = [["ChunkIndex.mps", X(j)]];
-	return g.length > 0 && ne.push(["Chunks", ca(g.map((e) => [`${e}.mps`, X(T.encode("BRSavedBrickChunkSoA", _.get(e).builder.toValue(s)))]))]), v.size > 0 && ne.push(["Components", ca(g.filter((e) => v.has(e)).map((e) => [`${e}.mps`, X(v.get(e).toBytes(f))]))]), b.size > 0 && ne.push(["Wires", ca(g.filter((e) => b.has(e)).map((e) => {
-		let t = b.get(e);
-		return [`${e}.mps`, X(E.encode("BRSavedWireChunkSoA", {
-			RemoteWireSources: t.remoteSources,
-			LocalWireSources: t.localSources,
-			RemoteWireTargets: t.remoteTargets,
-			LocalWireTargets: t.localTargets,
-			PendingPropagationFlags: { Flags: [] }
-		}))];
-	}))]), [["Meta", ca([["Bundle.json", X(ee.encode(JSON.stringify(te)))], ["World.json", X(ee.encode(JSON.stringify({ environment: t.environment ?? "Plate" })))]])], ["World", ca([["0", ca([
-		["GlobalData.schema", X(S.toBinary())],
-		["GlobalData.mps", X(k)],
-		["Owners.schema", X(C.toBinary())],
-		["Owners.mps", X(A)],
+	}, ee = (e, t) => {
+		let n = t ? 0 : Qa, r = [["ChunkIndex.mps", X(x.encode("BRSavedBrickChunkIndexSoA", {
+			Chunk3DIndices: e.chunkOrder.map((t) => {
+				let [n, r, i] = e.chunks.get(t).index;
+				return {
+					X: n,
+					Y: r,
+					Z: i
+				};
+			}),
+			ChunkOffsets: e.chunkOrder.map(() => ({
+				X: n,
+				Y: n,
+				Z: n
+			})),
+			ChunkSizes: e.chunkOrder.map(() => Za),
+			NumBricks: e.chunkOrder.map((t) => e.chunks.get(t).builder.numBricks),
+			NumComponents: e.chunkOrder.map((t) => e.componentChunks.get(t)?.numComponents ?? 0),
+			NumWires: e.chunkOrder.map((t) => e.chunkWireCounts.get(t) ?? 0)
+		}))]];
+		return e.chunkOrder.length > 0 && r.push(["Chunks", ca(e.chunkOrder.map((t) => [`${t}.mps`, X(S.encode("BRSavedBrickChunkSoA", e.chunks.get(t).builder.toValue(s)))]))]), e.componentChunks.size > 0 && r.push(["Components", ca(e.chunkOrder.filter((t) => e.componentChunks.has(t)).map((t) => [`${t}.mps`, X(e.componentChunks.get(t).toBytes(p))]))]), e.wireChunks.size > 0 && r.push(["Wires", ca(e.chunkOrder.filter((t) => e.wireChunks.has(t)).map((t) => {
+			let n = e.wireChunks.get(t);
+			return [`${t}.mps`, X(C.encode("BRSavedWireChunkSoA", {
+				RemoteWireSources: n.remoteSources,
+				LocalWireSources: n.localSources,
+				RemoteWireTargets: n.remoteTargets,
+				LocalWireTargets: n.localTargets,
+				PendingPropagationFlags: { Flags: [] }
+			}))];
+		}))]), r;
+	}, te = [["Bundle.json", X(j.encode(JSON.stringify(M)))]];
+	e.prefab ? te.push(["Prefab.json", X(j.encode(JSON.stringify(e.prefab)))]) : te.push(["World.json", X(j.encode(JSON.stringify({ environment: t.environment ?? "Plate" })))]);
+	let ne = [
+		["ChunkIndex.schema", X(w.toBinary())],
+		["ChunkIndex.mps", X(k)],
+		["ChunksShared.schema", X(T.toBinary())]
+	];
+	return A && ne.push(["Chunks", ca([["0_0_0.mps", X(A)]])]), [["Meta", ca(te)], ["World", ca([["0", ca([
+		["GlobalData.schema", X(y.toBinary())],
+		["GlobalData.mps", X(E)],
+		["Owners.schema", X(b.toBinary())],
+		["Owners.mps", X(D)],
 		["Bricks", ca([
-			["ChunkIndexShared.schema", X(w.toBinary())],
-			["ChunksShared.schema", X(T.toBinary())],
-			["WiresShared.schema", X(E.toBinary())],
-			["ComponentsShared.schema", X(f.toBinary())],
-			["Grids", ca([["1", ca(ne)]])]
+			["ChunkIndexShared.schema", X(x.toBinary())],
+			["ChunksShared.schema", X(S.toBinary())],
+			["WiresShared.schema", X(C.toBinary())],
+			["ComponentsShared.schema", X(p.toBinary())],
+			["Grids", ca(v.map((t, n) => [String(e.gridIds[n]), ca(ee(t, e.gridIds[n] === 1))]))]
 		])],
-		["Entities", ca([
-			["ChunkIndex.schema", X(D.toBinary())],
-			["ChunkIndex.mps", X(M)],
-			["ChunksShared.schema", X(O.toBinary())]
-		])]
+		["Entities", ca(ne)]
 	])]])]];
 }
-function so(e, t = {}) {
+function lo(e, t, n) {
+	let r = e.type ?? "Entity_DynamicBrickGrid", i = na.get(r);
+	if (i === void 0) throw Error(`brdb: entities[${t}]: unknown entity type '${r}'`);
+	let a = e.owner_index ?? 0;
+	if (!Number.isInteger(a) || a < 0 || a > n) throw Error(`brdb: entities[${t}]: owner_index ${a} out of range (0..${n})`);
+	let o = [...e.colors ?? []];
+	if (o.length > 8) throw Error(`brdb: entities[${t}]: at most 8 colors, got ${o.length}`);
+	for (; o.length < 8;) o.push({
+		R: 255,
+		G: 255,
+		B: 255,
+		A: 255
+	});
+	return {
+		type: r,
+		className: i,
+		location: e.location ?? {
+			X: 0,
+			Y: 0,
+			Z: 0
+		},
+		rotation: e.rotation ?? {
+			X: 0,
+			Y: 0,
+			Z: 0,
+			W: 1
+		},
+		ownerIndex: a,
+		frozen: e.frozen ?? !1,
+		sleeping: e.sleeping ?? !1,
+		velocity: e.linear_velocity ?? {
+			X: 0,
+			Y: 0,
+			Z: 0
+		},
+		angularVelocity: e.angular_velocity ?? {
+			X: 0,
+			Y: 0,
+			Z: 0
+		},
+		colors: o,
+		data: e.data ?? {}
+	};
+}
+function uo(e, t) {
+	let n = [
+		0,
+		0,
+		0
+	], r = [
+		0,
+		0,
+		0
+	];
+	e.forEach((e, t) => {
+		let i = e.procedural ? e.size : e.assetName === "B_1x1_Microchip" ? [
+			5,
+			5,
+			2
+		] : [
+			5,
+			5,
+			6
+		];
+		for (let a = 0; a < 3; a++) {
+			let o = e.position[a] - i[a], s = e.position[a] + i[a];
+			(t === 0 || o < n[a]) && (n[a] = o), (t === 0 || s > r[a]) && (r[a] = s);
+		}
+	});
+	let i = {
+		center: {
+			x: (n[0] + r[0]) / 2,
+			y: (n[1] + r[1]) / 2,
+			z: (n[2] + r[2]) / 2
+		},
+		halfExtent: {
+			x: (r[0] - n[0]) / 2,
+			y: (r[1] - n[1]) / 2,
+			z: (r[2] - n[2]) / 2
+		}
+	};
+	return {
+		pivots: {
+			bottomStudsPivot: i,
+			studsExpandedPivot: i,
+			topStudsPivot: i,
+			boundsPivot: i,
+			bottomStudsDirection: "Z_Negative",
+			topStudsDirection: "Z_Positive",
+			bBottomStudsValid: !0,
+			bTopStudsValid: !0
+		},
+		addedGlobalGridOffset: t.addedGlobalGridOffset ?? {
+			x: 0,
+			y: 0,
+			z: 0
+		},
+		bIsPhysicsGrid: t.isPhysicsGrid ?? !1,
+		bFreezePhysicsGrid: t.freezePhysicsGrid ?? !1,
+		bFreezeGlobalGrid: t.freezeGlobalGrid ?? !1,
+		bIsMicrochipPrefab: t.isMicrochipPrefab ?? !1
+	};
+}
+var fo = class {
+	constructor() {
+		this.gridBrickInputs = [[]], this.gridEntityOrders = [], this.entityInputs = [], this.wireList = [], this.chipLinks = [], this.ownerList = [], this.prefabOptions = null;
+	}
+	addOwner(e) {
+		return this.ownerList.push(e), this.ownerList.length;
+	}
+	addBrick(e, t) {
+		let n = t?.grid ?? 0, r = this.gridBrickInputs[n];
+		if (!r) throw Error(`brdb: unknown grid handle (slot ${n})`);
+		return r.push(e), {
+			grid: n,
+			index: r.length - 1
+		};
+	}
+	addBricks(e, t) {
+		return [...e].map((e) => this.addBrick(e, t));
+	}
+	addEntity(e = {}) {
+		return this.entityInputs.push(e), { entityOrder: this.entityInputs.length - 1 };
+	}
+	addBrickGrid(e = {}) {
+		let t = this.addEntity({
+			type: "Entity_DynamicBrickGrid",
+			...e
+		});
+		return this.gridBrickInputs.push([]), this.gridEntityOrders.push(t.entityOrder), {
+			grid: this.gridBrickInputs.length - 1,
+			entityOrder: t.entityOrder
+		};
+	}
+	addWire(e, t) {
+		this.wireList.push({
+			source: e,
+			target: t
+		});
+	}
+	registerMicrochipLink(e, t) {
+		this.chipLinks.push({
+			brick: e,
+			grid: t
+		});
+	}
+	addMicrochip(e) {
+		let t = this.addBrick({
+			asset: "B_1x1_Microchip",
+			position: e.position,
+			color: e.color,
+			owner_index: e.owner_index,
+			components: [{ type: "Component_Internal_Microchip" }]
+		}), n = this.addBrickGrid({
+			type: "Entity_MicrochipDynamicBrickGrid",
+			location: e.entityLocation ?? {
+				X: 0,
+				Y: 0,
+				Z: 40
+			},
+			data: {
+				bCollapsed: e.collapsed ?? !0,
+				PlaneCenter: {
+					X: 0,
+					Y: 0,
+					Z: 0
+				},
+				PlaneExtent: e.planeExtent ?? {
+					X: 14,
+					Y: 14,
+					Z: 2
+				}
+			}
+		});
+		return this.registerMicrochipLink(t, n), {
+			brick: t,
+			grid: n
+		};
+	}
+	makePrefab(e = {}) {
+		this.prefabOptions = e;
+	}
+	toPendingFs(e = {}) {
+		let t = new ro(), n = new ro();
+		for (let e of this.gridBrickInputs) for (let r of e) t.add(r.asset ?? "PB_DefaultBrick"), n.add(r.material ?? "BMC_Plastic");
+		let r = this.gridBrickInputs.map((e, r) => no({
+			brick_assets: t.names,
+			materials: n.names,
+			brick_owners: this.ownerList,
+			bricks: e.map((e) => ({
+				...e,
+				asset_name_index: t.indexOf(e.asset ?? "PB_DefaultBrick"),
+				material_index: n.indexOf(e.material ?? "BMC_Plastic"),
+				size: e.size ?? (e.asset === void 0 ? [
+					5,
+					5,
+					6
+				] : void 0),
+				position: r === 0 ? e.position : e.position.map((e) => e - Qa),
+				color: e.color ?? [
+					255,
+					255,
+					255
+				]
+			}))
+		})), i = this.entityInputs.map((e, t) => lo(e, t, this.ownerList.length)), a = [1, ...this.gridEntityOrders.map((e) => 2 + e)];
+		return co({
+			ownerRows: oo(this.ownerList),
+			grids: r,
+			gridIds: a,
+			entities: i,
+			wires: this.wireList.map((e) => ({
+				source: {
+					gridSlot: e.source.brick.grid,
+					brickIndex: e.source.brick.index,
+					componentType: e.source.component_type,
+					port: e.source.port
+				},
+				target: {
+					gridSlot: e.target.brick.grid,
+					brickIndex: e.target.brick.index,
+					componentType: e.target.component_type,
+					port: e.target.port
+				}
+			})),
+			microchipLinks: this.chipLinks.map((e) => ({
+				gridSlot: e.brick.grid,
+				brickIndex: e.brick.index,
+				gridReference: 2 + e.grid.entityOrder
+			})),
+			prefab: this.prefabOptions ? uo(r[0], this.prefabOptions) : null
+		}, e);
+	}
+	toBrz(e = {}) {
+		return Gi(this.toPendingFs(e), { compress: e.compress });
+	}
+};
+function po(e, t = {}) {
 	let n = { compress: t.compress };
-	return Gi(oo(e, t), n);
+	return Gi(so(e, t), n);
 }
-function co(e) {
+function mo(e) {
 	let t = e <= 15 ? 15 : 255;
 	return Math.trunc((e / 255) ** (1 / 2.2) * t);
 }
-function lo(e) {
+function ho(e) {
 	return {
 		...e,
-		R: co(e.R),
-		G: co(e.G),
-		B: co(e.B)
+		R: mo(e.R),
+		G: mo(e.G),
+		B: mo(e.B)
 	};
 }
-function uo(e) {
+function go(e) {
 	let t = {};
-	for (let [n, r] of Object.entries(e)) t[n] = lo(r);
+	for (let [n, r] of Object.entries(e)) t[n] = ho(r);
 	return t;
 }
-function fo(e, t, n) {
+function _o(e, t, n) {
 	let r = 0;
 	for (let t of e.BrickSizeCounters) r += t.NumSizes;
 	if (r < 0 || r > e.BrickSizes.length) throw Error("brdb: brick size counters exceed size table");
@@ -13043,7 +13377,7 @@ function fo(e, t, n) {
 				r.Z
 			];
 		}
-		let d = e.RelativePositions[r], f = e.Orientations[r], p = e.ColorsAndAlphas[r], m = o ? lo(p) : p;
+		let d = e.RelativePositions[r], f = e.Orientations[r], p = e.ColorsAndAlphas[r], m = o ? ho(p) : p;
 		s.push({
 			asset_name_index: l,
 			size: u,
@@ -13074,7 +13408,7 @@ function fo(e, t, n) {
 	}
 	return s;
 }
-var po = class e {
+var vo = class e {
 	constructor(e, t = 0) {
 		this.fs = e, this.worldId = t, this.schemas = /* @__PURE__ */ new Map(), this.values = /* @__PURE__ */ new Map();
 	}
@@ -13169,7 +13503,7 @@ var po = class e {
 	}
 	*bricks(e = 1) {
 		let t = this.globalData().BasicBrickAssetNames.length;
-		for (let n of this.brickChunkIndex(e)) yield* fo(this.brickChunkSoa(e, n.index), n.index, t);
+		for (let n of this.brickChunkIndex(e)) yield* _o(this.brickChunkSoa(e, n.index), n.index, t);
 	}
 	entityChunkIndex() {
 		let e = this.decode(this.path("Entities/ChunkIndex.mps"), this.path("Entities/ChunkIndex.schema"), "BRSavedEntityChunkIndexSoA");
@@ -13255,7 +13589,7 @@ var po = class e {
 					sleeping: Lr(s.PhysicsSleepingFlags, f),
 					linearVelocity: s.LinearVelocities[f],
 					angularVelocity: s.AngularVelocities[f],
-					colors: u ? uo(e) : e,
+					colors: u ? go(e) : e,
 					remainingLifeSpan: s.RemainingLifeSpans?.[f] ?? 0,
 					data: r ? i.readValue(o, r) : null
 				}), f += 1;
@@ -13267,74 +13601,74 @@ var po = class e {
 	*entities() {
 		for (let e of this.entityChunkIndex().chunks) yield* this.entityChunk(e.index);
 	}
-}, mo, $ = "\n				", ho = "\n			", go = `CREATE TABLE blobs (${$}blob_id INTEGER PRIMARY KEY,${$}compression INTEGER,${$}size_uncompressed INTEGER,${$}size_compressed INTEGER,${$}delta_base_id INTEGER REFERENCES blobs(blob_id),${$}hash BLOB,${$}content BLOB${ho});\nCREATE TABLE revisions (${$}revision_id INTEGER PRIMARY KEY,${$}description TEXT,${$}created_at INTEGER${ho});\nCREATE TABLE folders (${$}folder_id INTEGER PRIMARY KEY,${$}parent_id INTEGER REFERENCES folders(folder_id),${$}name TEXT,${$}created_at INTEGER,${$}deleted_at INTEGER${ho});\nCREATE TABLE files (${$}file_id INTEGER PRIMARY KEY,${$}parent_id INTEGER REFERENCES folders(folder_id),${$}name TEXT,${$}content_id INTEGER REFERENCES blobs(blob_id),${$}created_at INTEGER,${$}deleted_at INTEGER${ho});\nCREATE INDEX blobs_size_hash ON blobs(size_uncompressed, hash);
+}, yo, $ = "\n				", bo = "\n			", xo = `CREATE TABLE blobs (${$}blob_id INTEGER PRIMARY KEY,${$}compression INTEGER,${$}size_uncompressed INTEGER,${$}size_compressed INTEGER,${$}delta_base_id INTEGER REFERENCES blobs(blob_id),${$}hash BLOB,${$}content BLOB${bo});\nCREATE TABLE revisions (${$}revision_id INTEGER PRIMARY KEY,${$}description TEXT,${$}created_at INTEGER${bo});\nCREATE TABLE folders (${$}folder_id INTEGER PRIMARY KEY,${$}parent_id INTEGER REFERENCES folders(folder_id),${$}name TEXT,${$}created_at INTEGER,${$}deleted_at INTEGER${bo});\nCREATE TABLE files (${$}file_id INTEGER PRIMARY KEY,${$}parent_id INTEGER REFERENCES folders(folder_id),${$}name TEXT,${$}content_id INTEGER REFERENCES blobs(blob_id),${$}created_at INTEGER,${$}deleted_at INTEGER${bo});\nCREATE INDEX blobs_size_hash ON blobs(size_uncompressed, hash);
 CREATE INDEX folders_parent_name_deleted ON folders(parent_id, name, deleted_at);
-CREATE INDEX files_parent_name_deleted ON files(parent_id, name, deleted_at);`, _o = [
+CREATE INDEX files_parent_name_deleted ON files(parent_id, name, deleted_at);`, So = [
 	"blobs",
 	"revisions",
 	"folders",
 	"files"
-], vo = () => Math.floor(Date.now() / 1e3), yo = (e) => typeof Buffer > "u" ? e : Buffer.from(e.buffer, e.byteOffset, e.byteLength), bo = (e) => {
+], Co = () => Math.floor(Date.now() / 1e3), wo = (e) => typeof Buffer > "u" ? e : Buffer.from(e.buffer, e.byteOffset, e.byteLength), To = (e) => {
 	try {
 		return typeof process < "u" ? process?.getBuiltinModule?.(e) ?? null : null;
 	} catch {
 		return null;
 	}
-}, xo = null, So = (e) => (xo ?? (xo = Function("specifier", "return import(specifier)")), xo(e));
-async function Co() {
+}, Eo = null, Do = (e) => (Eo ?? (Eo = Function("specifier", "return import(specifier)")), Eo(e));
+async function Oo() {
 	try {
-		let e = await (To.engineLoader ?? (() => So("better-sqlite3")))();
+		let e = await (Ao.engineLoader ?? (() => Do("better-sqlite3")))();
 		return e.default ?? e;
 	} catch {
 		throw Error("brdb: the Brdb openers require better-sqlite3 (npm install better-sqlite3), or wrap your own handle with new Brdb(db)");
 	}
 }
-function wo() {
-	let e = bo("node:zlib");
+function ko() {
+	let e = To("node:zlib");
 	if (typeof e?.zstdCompressSync != "function") return null;
 	let t = e.constants.ZSTD_c_compressionLevel;
 	return (n) => new Uint8Array(e.zstdCompressSync(n, { params: { [t]: 14 } }));
 }
-var To = class e {
+var Ao = class e {
 	constructor(e) {
 		this.db = e, this.defaultCompress = null;
-		for (let e of _o) if (!this.db.prepare("SELECT name FROM sqlite_schema WHERE type = 'table' AND name = ?").get(e)) throw Error(`brdb: missing required table '${e}'`);
+		for (let e of So) if (!this.db.prepare("SELECT name FROM sqlite_schema WHERE type = 'table' AND name = ?").get(e)) throw Error(`brdb: missing required table '${e}'`);
 	}
-	static init(t, n = vo()) {
-		t.exec(go);
+	static init(t, n = Co()) {
+		t.exec(xo);
 		let r = new e(t);
 		return r.createRevision("Initial Revision", n), r;
 	}
 	static async wrap(t, n) {
 		try {
 			let r = n ? e.init(t) : new e(t);
-			return r.defaultCompress = wo(), r;
+			return r.defaultCompress = ko(), r;
 		} catch (e) {
 			throw t.close(), e;
 		}
 	}
 	static async open(t) {
-		return e.wrap(new (await (Co()))(t, { fileMustExist: !0 }), !1);
+		return e.wrap(new (await (Oo()))(t, { fileMustExist: !0 }), !1);
 	}
 	static async openReadonly(t) {
-		return e.wrap(new (await (Co()))(t, {
+		return e.wrap(new (await (Oo()))(t, {
 			readonly: !0,
 			fileMustExist: !0
 		}), !1);
 	}
 	static async create(t) {
-		return e.wrap(new (await (Co()))(t), !0);
+		return e.wrap(new (await (Oo()))(t), !0);
 	}
 	static async openOrCreate(t) {
-		let n = bo("node:fs");
+		let n = To("node:fs");
 		if (!n) throw Error("brdb: openOrCreate requires node 22.3 or newer; call open or create explicitly");
 		return n.existsSync(t) ? e.open(t) : e.create(t);
 	}
 	static async memory() {
-		return e.wrap(new (await (Co()))(":memory:"), !0);
+		return e.wrap(new (await (Oo()))(":memory:"), !0);
 	}
 	static async fromBytes(t) {
-		return e.wrap(new (await (Co()))(Buffer.from(t)), !1);
+		return e.wrap(new (await (Oo()))(Buffer.from(t)), !1);
 	}
 	toBytes() {
 		let e = this.db.serialize;
@@ -13342,15 +13676,15 @@ var To = class e {
 		return new Uint8Array(e.call(this.db));
 	}
 	save(e, t, n = {}) {
-		this.writePending(e, oo(t, n), n);
+		this.writePending(e, t instanceof fo ? t.toPendingFs(n) : so(t, n), n);
 	}
 	worldReader() {
-		return new po(this);
+		return new vo(this);
 	}
 	sqliteSchema() {
 		return this.db.prepare("SELECT sql FROM sqlite_schema").all().map((e) => e.sql).join("\n");
 	}
-	createRevision(e, t = vo()) {
+	createRevision(e, t = Co()) {
 		return Number(this.db.prepare("INSERT INTO revisions (description, created_at) VALUES (?, ?);").run(e, t).lastInsertRowid);
 	}
 	revisions() {
@@ -13370,16 +13704,16 @@ var To = class e {
 		let r = this.findBlobByHash(e.length, t);
 		if (r) return r.blobId;
 		let i = e.length, a = i, o = 0, s = e, c = n ? n(e) : null;
-		return c && c.length < i && (a = c.length, o = 1, s = c), Number(this.db.prepare("INSERT INTO blobs (compression, size_uncompressed, size_compressed, delta_base_id, hash, content) VALUES (?, ?, ?, ?, ?, ?);").run(o, i, a, null, yo(t), yo(s)).lastInsertRowid);
+		return c && c.length < i && (a = c.length, o = 1, s = c), Number(this.db.prepare("INSERT INTO blobs (compression, size_uncompressed, size_compressed, delta_base_id, hash, content) VALUES (?, ?, ?, ?, ?, ?);").run(o, i, a, null, wo(t), wo(s)).lastInsertRowid);
 	}
 	findBlobByHash(e, t) {
-		let n = this.db.prepare("SELECT blob_id, compression, size_uncompressed, size_compressed, delta_base_id, hash, content FROM blobs WHERE hash = ? AND size_uncompressed = ? LIMIT 1;").get(yo(t), e);
-		return n ? Eo(n) : null;
+		let n = this.db.prepare("SELECT blob_id, compression, size_uncompressed, size_compressed, delta_base_id, hash, content FROM blobs WHERE hash = ? AND size_uncompressed = ? LIMIT 1;").get(wo(t), e);
+		return n ? jo(n) : null;
 	}
 	findBlob(e) {
 		let t = this.db.prepare("SELECT blob_id, compression, size_uncompressed, size_compressed, delta_base_id, hash, content FROM blobs WHERE blob_id = ?;").get(e);
 		if (!t) throw Error(`brdb: blob ${e} not found`);
-		return Eo(t);
+		return jo(t);
 	}
 	deleteFile(e, t) {
 		this.db.prepare("UPDATE files SET deleted_at = ? WHERE file_id = ?;").run(t, e);
@@ -13406,7 +13740,7 @@ var To = class e {
 	}
 	findFile(e, t) {
 		let n = this.db.prepare(`SELECT content_id, created_at FROM files WHERE parent_id ${e === null ? "IS NULL" : "= ?"} AND name = ? AND deleted_at IS NULL;`).get(...e === null ? [t] : [e, t]);
-		return n ? Do(n) : null;
+		return n ? Mo(n) : null;
 	}
 	findFileAtRevision(e, t, n) {
 		let r = this.db.prepare(`SELECT content_id, created_at FROM files WHERE parent_id ${e === null ? "IS NULL" : "= ?"} AND name = ? AND created_at <= ? AND (deleted_at IS NULL OR deleted_at > ?) ORDER BY created_at ASC LIMIT 1;`).get(...e === null ? [
@@ -13419,13 +13753,13 @@ var To = class e {
 			n,
 			n
 		]);
-		return r ? Do(r) : null;
+		return r ? Mo(r) : null;
 	}
 	close() {
 		this.db.close();
 	}
 	writePending(e, t, n = {}) {
-		let r = n.createdAt ?? vo(), i = n.compress === void 0 ? this.defaultCompress : n.compress;
+		let r = n.createdAt ?? Co(), i = n.compress === void 0 ? this.defaultCompress : n.compress;
 		this.db.exec("BEGIN");
 		try {
 			this.createRevision(e, r), this.mergeFolder(null, t, r, i), this.db.exec("COMMIT");
@@ -13552,8 +13886,8 @@ var To = class e {
 		return e(null);
 	}
 };
-mo = To, mo.engineLoader = null;
-var Eo = (e) => ({
+yo = Ao, yo.engineLoader = null;
+var jo = (e) => ({
 	blobId: Number(e.blob_id),
 	compression: Number(e.compression),
 	sizeUncompressed: Number(e.size_uncompressed),
@@ -13561,15 +13895,15 @@ var Eo = (e) => ({
 	deltaBaseId: e.delta_base_id === null ? null : Number(e.delta_base_id),
 	hash: new Uint8Array(e.hash),
 	content: new Uint8Array(e.content)
-}), Do = (e) => ({
+}), Mo = (e) => ({
 	contentId: e.content_id === null ? -1 : Number(e.content_id),
 	createdAt: Number(e.created_at)
-}), Oo = /* @__PURE__ */ t({
+}), No = /* @__PURE__ */ t({
 	BASIC_BRICK_ASSETS: () => qi,
-	BRDB_SQLITE_SCHEMA: () => go,
+	BRDB_SQLITE_SCHEMA: () => xo,
 	BRICK_ASSETS: () => Yi,
 	BitFlags: () => Rr,
-	Brdb: () => To,
+	Brdb: () => Ao,
 	BrdbSchema: () => Ja,
 	BrzReader: () => Ki,
 	ByteReader: () => Wi,
@@ -13585,7 +13919,8 @@ var Eo = (e) => ({
 	PROCEDURAL_BRICK_ASSETS: () => Ji,
 	PUBLIC_GUID: () => aa,
 	WIRE_PORT_NAMES: () => ta,
-	WorldReader: () => po,
+	World: () => fo,
+	WorldReader: () => vo,
 	bit: () => Lr,
 	embeddedSchema: () => Xa,
 	file: () => X,
@@ -13593,21 +13928,21 @@ var Eo = (e) => ({
 	guidToUuid: () => sa,
 	isProceduralAsset: () => Qi,
 	msgpack: () => la,
-	saveToPendingFs: () => oo,
+	saveToPendingFs: () => so,
 	toRelative: () => to,
 	uuidToGuid: () => oa,
 	writeBrzContainer: () => Gi,
-	writeBrzLegacy: () => so
-}), ko = {
+	writeBrzLegacy: () => po
+}), Po = {
 	read: Ar,
 	write: Nr,
 	utils: tr,
 	constants: n,
 	types: Pr,
-	brdb: Oo
+	brdb: No
 };
-typeof window < "u" && (window.BRS = ko);
+typeof window < "u" && (window.BRS = Po);
 //#endregion
-export { To as Brdb, Fr as Direction, Ir as Rotation, po as WorldReader, Oo as brdb, n as constants, ko as default, Ar as read, Pr as types, tr as utils, Nr as write, so as writeBrzLegacy };
+export { Ao as Brdb, Fr as Direction, Ir as Rotation, fo as World, vo as WorldReader, No as brdb, n as constants, Po as default, Ar as read, Pr as types, tr as utils, Nr as write, po as writeBrzLegacy };
 
 //# sourceMappingURL=dist.mjs.map