@glissade/core 0.9.0-pre.0 → 0.9.0

package/dist/index.js

@@ -364,7 +364,9 @@ function parseFormat4(dv, base, into) {
 	}
 }
 function parseFormat12(dv, base, into) {
-	const nGroups = u32(dv, base + 12);
+	const declared = u32(dv, base + 12);
+	const maxGroups = Math.max(0, Math.floor((dv.byteLength - (base + 16)) / 12));
+	const nGroups = Math.min(declared, maxGroups);
 	let off = base + 16;
 	for (let i = 0; i < nGroups; i++, off += 12) {
 		const startChar = u32(dv, off);

package/dist/sidecar.js

@@ -1118,6 +1118,7 @@ function assignKeyIds(keys) {
 * with no baseline). Keys get stable `k<N>` ids. Returns a new document.
 */
 function setSidecarTrack(doc, timelineId, target, type, keys, codeBaselineKeys) {
+	if (!isEditableNodeId(targetNodeId(target))) throw new TrackValidationError(target, "structural/un-id'd nodes cannot host editor tracks (§6.5) — only nodes with an explicit id");
 	const tl = doc.timelines[timelineId] ?? { tracks: {} };
 	const entry = {
 		type,

package/dist/studioHost.d.ts

@@ -16,10 +16,12 @@ type TimelinePatch = {
   type: ValueTypeId;
   keys: Key[];
   baseHash?: string | null;
+  verbatim?: boolean;
 } | {
   op: 'removeTrack';
   timelineId: string;
   target: string;
+  prune?: boolean;
 } | {
   op: 'addKey';
   timelineId: string;

package/dist/studioHost.js

@@ -38,11 +38,20 @@ function putEntry(doc, timelineId, target, entry) {
 		}
 	};
 }
-function removeEntry(doc, timelineId, target) {
+function removeEntry(doc, timelineId, target, prune = false) {
 	const tl = doc.timelines[timelineId];
 	if (!tl?.tracks[target]) return doc;
 	const tracks = { ...tl.tracks };
 	delete tracks[target];
+	const labels = tl.labels;
+	if (prune && Object.keys(tracks).length === 0 && (!labels || Object.keys(labels).length === 0)) {
+		const timelines = { ...doc.timelines };
+		delete timelines[timelineId];
+		return {
+			...doc,
+			timelines
+		};
+	}
 	return {
 		...doc,
 		timelines: {
@@ -54,11 +63,16 @@ function removeEntry(doc, timelineId, target) {
 		}
 	};
 }
-/** Apply a key-list edit: normalize (§2.7 spring re-pin + collision nudge) and (re)assign stable ids. */
-function withKeys(entry, keys) {
+/**
+* Apply a key-list edit. `verbatim` restores keys EXACTLY as given (the inverse
+* path — it is replaying a prior valid state, so re-normalizing would re-pin
+* springs / re-nudge collisions and break byte-exact undo). The forward editor
+* path normalizes (§2.7 spring re-pin + collision nudge) and (re)assigns ids.
+*/
+function withKeys(entry, keys, verbatim = false) {
 	return {
 		...entry,
-		keys: assignKeyIds(normalizeEditedKeys(keys))
+		keys: verbatim ? keys.map((k) => ({ ...k })) : assignKeyIds(normalizeEditedKeys(keys))
 	};
 }
 /**
@@ -72,7 +86,9 @@ function applyPatches(doc, patches, baseline) {
 	let work = doc;
 	const trackSnap = /* @__PURE__ */ new Map();
 	const labelSnap = /* @__PURE__ */ new Map();
+	const tlExisted = /* @__PURE__ */ new Map();
 	const snapTrack = (timelineId, target) => {
+		if (!tlExisted.has(timelineId)) tlExisted.set(timelineId, work.timelines[timelineId] !== void 0);
 		const k = refKey(timelineId, target);
 		if (!trackSnap.has(k)) trackSnap.set(k, work.timelines[timelineId]?.tracks[target] ?? null);
 	};
@@ -82,13 +98,17 @@ function applyPatches(doc, patches, baseline) {
 	};
 	for (const p of patches) switch (p.op) {
 		case "setTrackKeys": {
+			if (!p.verbatim && !isEditableNodeId(targetNodeId(p.target))) return {
+				ok: false,
+				error: `setTrackKeys: '${p.target}' is not an editable host (structural/un-id'd nodes cannot host tracks, §6.5)`
+			};
 			snapTrack(p.timelineId, p.target);
 			const prev = work.timelines[p.timelineId]?.tracks[p.target];
 			const entry = withKeys({
 				type: p.type,
 				baseHash: p.baseHash !== void 0 ? p.baseHash : prev?.baseHash ?? null,
 				keys: []
-			}, p.keys.map((k) => ({ ...k })));
+			}, p.keys.map((k) => ({ ...k })), p.verbatim);
 			work = putEntry(work, p.timelineId, p.target, entry);
 			break;
 		}
@@ -98,9 +118,13 @@ function applyPatches(doc, patches, baseline) {
 				error: `removeTrack: no sidecar track '${p.target}'`
 			};
 			snapTrack(p.timelineId, p.target);
-			work = removeEntry(work, p.timelineId, p.target);
+			work = removeEntry(work, p.timelineId, p.target, p.prune);
 			break;
 		case "addKey": {
+			if (!isEditableNodeId(targetNodeId(p.target))) return {
+				ok: false,
+				error: `addKey: '${p.target}' is not an editable host (structural/un-id'd nodes cannot host tracks, §6.5)`
+			};
 			const entry = resolveEntry(work, p, baseline);
 			if (!entry) return {
 				ok: false,
@@ -191,7 +215,12 @@ function applyPatches(doc, patches, baseline) {
 	const inverse = [];
 	for (const [k, snap] of trackSnap) {
 		const [timelineId, target] = parseRefKey(k);
-		if (snap === null) inverse.push({
+		if (snap === null) inverse.push(tlExisted.get(timelineId) === false ? {
+			op: "removeTrack",
+			timelineId,
+			target,
+			prune: true
+		} : {
 			op: "removeTrack",
 			timelineId,
 			target
@@ -202,7 +231,8 @@ function applyPatches(doc, patches, baseline) {
 			target,
 			type: snap.type,
 			keys: snap.keys.map((x) => ({ ...x })),
-			baseHash: snap.baseHash
+			baseHash: snap.baseHash,
+			verbatim: true
 		});
 	}
 	for (const [k, value] of labelSnap) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/core",
-  "version": "0.9.0-pre.0",
+  "version": "0.9.0",
   "description": "glissade core: signals, tracks, timeline document, evaluation, easing, springs, seeded RNG. Zero DOM/Node dependencies.",
   "license": "Apache-2.0",
   "type": "module",