@weasel-js/core 1.10.1 → 1.11.1

package/dist/devtools/serialize.js

@@ -0,0 +1,86 @@
+//#region src/devtools/serialize.ts
+var TYPED = [
+	Int8Array,
+	Uint8Array,
+	Uint8ClampedArray,
+	Int16Array,
+	Uint16Array,
+	Int32Array,
+	Uint32Array,
+	Float32Array,
+	Float64Array,
+	BigInt64Array,
+	BigUint64Array
+];
+var tagOf = (value) => Object.prototype.toString.call(value).slice(8, -1);
+function isTyped(value) {
+	return ArrayBuffer.isView(value) && !(value instanceof DataView) && TYPED.some((T) => tagOf(value) === T.name);
+}
+/** `value` as plain data: functions as `ƒ name`, typed arrays as their type and
+*  length, maps and sets tagged, cycles marked, and every size capped. */
+function serialize(value, limits = {}) {
+	const depth = limits.depth ?? 6;
+	const items = limits.items ?? 100;
+	const chars = limits.chars ?? 1e3;
+	const open = /* @__PURE__ */ new Set();
+	const cut = (count) => `… ${count - items} more`;
+	const walk = (v, level) => {
+		switch (typeof v) {
+			case "string": return v.length > chars ? `${v.slice(0, chars)}…` : v;
+			case "number": return Number.isFinite(v) ? v : String(v);
+			case "boolean": return v;
+			case "undefined": return;
+			case "bigint": return `${v}n`;
+			case "symbol": return v.toString();
+			case "function": return `ƒ ${v.name || "anonymous"}`;
+		}
+		if (v === null) return null;
+		const obj = v;
+		if (open.has(obj)) return "[cycle]";
+		if (level >= depth) return "…";
+		if (isTyped(obj)) return {
+			$type: tagOf(obj),
+			length: obj.length
+		};
+		if (obj instanceof Date || tagOf(obj) === "Date") return {
+			$type: "Date",
+			value: obj.toISOString()
+		};
+		open.add(obj);
+		try {
+			if (Array.isArray(obj)) {
+				const out = obj.slice(0, items).map((x) => walk(x, level + 1));
+				if (obj.length > items) out.push(cut(obj.length));
+				return out;
+			}
+			const tag = tagOf(obj);
+			if (tag === "Map" || tag === "Set") {
+				const all = tag === "Map" ? [...obj] : [...obj];
+				const entries = all.slice(0, items).map((x) => walk(x, level + 1));
+				if (all.length > items) entries.push(cut(all.length));
+				return {
+					$type: tag,
+					size: all.length,
+					entries
+				};
+			}
+			const out = {};
+			const proto = Object.getPrototypeOf(obj);
+			if (proto !== null && proto !== Object.prototype && tag === "Object") {
+				const name = proto.constructor?.name;
+				if (name && name !== "Object") out.$class = name;
+			}
+			const keys = Object.keys(obj);
+			for (const key of keys.slice(0, items)) out[key] = walk(obj[key], level + 1);
+			if (keys.length > items) out["…"] = cut(keys.length);
+			return out;
+		} finally {
+			open.delete(obj);
+		}
+	};
+	return walk(value, 0);
+}
+
+//#endregion
+export { serialize };
+//# sourceMappingURL=serialize.js.map

package/dist/devtools/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","names":[],"sources":["../../src/devtools/serialize.ts"],"sourcesContent":["/**\n * Turn any value into plain data a panel can display. A node's `data` is the\n * app's own type, so nothing here assumes it is JSON-safe.\n */\n\n/** What {@link serialize} produces: JSON-safe apart from `undefined`, which structured clone carries. */\nexport type SerializedValue =\n  | string | number | boolean | null | undefined\n  | SerializedValue[]\n  | { [key: string]: SerializedValue };\n\n/** How much of a value {@link serialize} writes out. */\nexport interface SerializeLimits {\n  /** Nesting below this depth is written as `'…'`. */\n  depth?: number;\n  /** Array, map, set and object entries past this many are cut, with a note of how many. */\n  items?: number;\n  /** Strings longer than this are cut. */\n  chars?: number;\n}\n\nconst TYPED = [\n  Int8Array, Uint8Array, Uint8ClampedArray, Int16Array, Uint16Array,\n  Int32Array, Uint32Array, Float32Array, Float64Array, BigInt64Array, BigUint64Array,\n];\n\nconst tagOf = (value: object): string => Object.prototype.toString.call(value).slice(8, -1);\n\nfunction isTyped(value: object): value is ArrayBufferView {\n  return ArrayBuffer.isView(value) && !(value instanceof DataView)\n    && TYPED.some((T) => tagOf(value) === T.name);\n}\n\n/** `value` as plain data: functions as `ƒ name`, typed arrays as their type and\n *  length, maps and sets tagged, cycles marked, and every size capped. */\nexport function serialize(value: unknown, limits: SerializeLimits = {}): SerializedValue {\n  const depth = limits.depth ?? 6;\n  const items = limits.items ?? 100;\n  const chars = limits.chars ?? 1000;\n  const open = new Set<object>();\n\n  const cut = (count: number): string => `… ${count - items} more`;\n\n  const walk = (v: unknown, level: number): SerializedValue => {\n    switch (typeof v) {\n      case 'string': return v.length > chars ? `${v.slice(0, chars)}…` : v;\n      case 'number': return Number.isFinite(v) ? v : String(v);\n      case 'boolean': return v;\n      case 'undefined': return undefined;\n      case 'bigint': return `${v}n`;\n      case 'symbol': return v.toString();\n      case 'function': return `ƒ ${v.name || 'anonymous'}`;\n    }\n    if (v === null) return null;\n    const obj = v as object;\n    if (open.has(obj)) return '[cycle]';\n    if (level >= depth) return '…';\n    if (isTyped(obj)) return { $type: tagOf(obj), length: (obj as unknown as { length: number }).length };\n    if (obj instanceof Date || tagOf(obj) === 'Date') return { $type: 'Date', value: (obj as Date).toISOString() };\n    open.add(obj);\n    try {\n      if (Array.isArray(obj)) {\n        const out = obj.slice(0, items).map((x) => walk(x, level + 1));\n        if (obj.length > items) out.push(cut(obj.length));\n        return out;\n      }\n      const tag = tagOf(obj);\n      if (tag === 'Map' || tag === 'Set') {\n        const all = tag === 'Map' ? [...(obj as Map<unknown, unknown>)] : [...(obj as Set<unknown>)];\n        const entries = all.slice(0, items).map((x) => walk(x, level + 1));\n        if (all.length > items) entries.push(cut(all.length));\n        return { $type: tag, size: all.length, entries };\n      }\n      const out: { [key: string]: SerializedValue } = {};\n      const proto = Object.getPrototypeOf(obj) as object | null;\n      if (proto !== null && proto !== Object.prototype && tag === 'Object') {\n        const name = (proto.constructor as { name?: string } | undefined)?.name;\n        if (name && name !== 'Object') out.$class = name;\n      }\n      const keys = Object.keys(obj);\n      for (const key of keys.slice(0, items)) out[key] = walk((obj as Record<string, unknown>)[key], level + 1);\n      if (keys.length > items) out['…'] = cut(keys.length);\n      return out;\n    } finally {\n      open.delete(obj);\n    }\n  };\n\n  return walk(value, 0);\n}\n"],"mappings":";AAqBA,IAAM,QAAQ;CACZ;CAAW;CAAY;CAAmB;CAAY;CACtD;CAAY;CAAa;CAAc;CAAc;CAAe;AACtE;AAEA,IAAM,SAAS,UAA0B,OAAO,UAAU,SAAS,KAAK,KAAK,CAAC,CAAC,MAAM,GAAG,EAAE;AAE1F,SAAS,QAAQ,OAAyC;CACxD,OAAO,YAAY,OAAO,KAAK,KAAK,EAAE,iBAAiB,aAClD,MAAM,MAAM,MAAM,MAAM,KAAK,MAAM,EAAE,IAAI;AAChD;;;AAIA,SAAgB,UAAU,OAAgB,SAA0B,CAAC,GAAoB;CACvF,MAAM,QAAQ,OAAO,SAAS;CAC9B,MAAM,QAAQ,OAAO,SAAS;CAC9B,MAAM,QAAQ,OAAO,SAAS;CAC9B,MAAM,uBAAO,IAAI,IAAY;CAE7B,MAAM,OAAO,UAA0B,KAAK,QAAQ,MAAM;CAE1D,MAAM,QAAQ,GAAY,UAAmC;EAC3D,QAAQ,OAAO,GAAf;GACE,KAAK,UAAU,OAAO,EAAE,SAAS,QAAQ,GAAG,EAAE,MAAM,GAAG,KAAK,EAAE,KAAK;GACnE,KAAK,UAAU,OAAO,OAAO,SAAS,CAAC,IAAI,IAAI,OAAO,CAAC;GACvD,KAAK,WAAW,OAAO;GACvB,KAAK,aAAa;GAClB,KAAK,UAAU,OAAO,GAAG,EAAE;GAC3B,KAAK,UAAU,OAAO,EAAE,SAAS;GACjC,KAAK,YAAY,OAAO,KAAK,EAAE,QAAQ;EACzC;EACA,IAAI,MAAM,MAAM,OAAO;EACvB,MAAM,MAAM;EACZ,IAAI,KAAK,IAAI,GAAG,GAAG,OAAO;EAC1B,IAAI,SAAS,OAAO,OAAO;EAC3B,IAAI,QAAQ,GAAG,GAAG,OAAO;GAAE,OAAO,MAAM,GAAG;GAAG,QAAS,IAAsC;EAAO;EACpG,IAAI,eAAe,QAAQ,MAAM,GAAG,MAAM,QAAQ,OAAO;GAAE,OAAO;GAAQ,OAAQ,IAAa,YAAY;EAAE;EAC7G,KAAK,IAAI,GAAG;EACZ,IAAI;GACF,IAAI,MAAM,QAAQ,GAAG,GAAG;IACtB,MAAM,MAAM,IAAI,MAAM,GAAG,KAAK,CAAC,CAAC,KAAK,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC;IAC7D,IAAI,IAAI,SAAS,OAAO,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC;IAChD,OAAO;GACT;GACA,MAAM,MAAM,MAAM,GAAG;GACrB,IAAI,QAAQ,SAAS,QAAQ,OAAO;IAClC,MAAM,MAAM,QAAQ,QAAQ,CAAC,GAAI,GAA6B,IAAI,CAAC,GAAI,GAAoB;IAC3F,MAAM,UAAU,IAAI,MAAM,GAAG,KAAK,CAAC,CAAC,KAAK,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC;IACjE,IAAI,IAAI,SAAS,OAAO,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC;IACpD,OAAO;KAAE,OAAO;KAAK,MAAM,IAAI;KAAQ;IAAQ;GACjD;GACA,MAAM,MAA0C,CAAC;GACjD,MAAM,QAAQ,OAAO,eAAe,GAAG;GACvC,IAAI,UAAU,QAAQ,UAAU,OAAO,aAAa,QAAQ,UAAU;IACpE,MAAM,OAAQ,MAAM,aAA+C;IACnE,IAAI,QAAQ,SAAS,UAAU,IAAI,SAAS;GAC9C;GACA,MAAM,OAAO,OAAO,KAAK,GAAG;GAC5B,KAAK,MAAM,OAAO,KAAK,MAAM,GAAG,KAAK,GAAG,IAAI,OAAO,KAAM,IAAgC,MAAM,QAAQ,CAAC;GACxG,IAAI,KAAK,SAAS,OAAO,IAAI,OAAO,IAAI,KAAK,MAAM;GACnD,OAAO;EACT,UAAU;GACR,KAAK,OAAO,GAAG;EACjB;CACF;CAEA,OAAO,KAAK,OAAO,CAAC;AACtB"}

package/dist/devtools/session.js

@@ -0,0 +1,111 @@
+import { VERSION } from "../version.js";
+import { DEVTOOLS_PROTOCOL } from "./protocol.js";
+import { answer } from "./handlers.js";
+import { createNotices } from "./notices.js";
+
+//#region src/devtools/session.ts
+/**
+* One panel's connection to the page: the handshake, every request, the
+* change notices, and the overrides the panel holds, which go when it does.
+*/
+function openSession(host, transport) {
+	const send = (m) => transport.send(m);
+	const fail = (requestId, message) => send({
+		type: "error",
+		protocol: DEVTOOLS_PROTOCOL,
+		requestId,
+		message
+	});
+	let greeted = false;
+	let closed = false;
+	const notices = createNotices(host.root, host.schedule, (m) => {
+		if (!closed) send(m);
+	});
+	const overrides = /* @__PURE__ */ new Map();
+	const dropOverride = (rootId) => {
+		if (overrides.delete(rootId)) host.root(rootId)?.source.setOverride(null);
+	};
+	const steer = (root, change) => {
+		const prev = overrides.get(root.id) ?? {
+			overlays: {},
+			highlight: []
+		};
+		const next = {
+			overlays: change.overlays ? {
+				...prev.overlays,
+				...change.overlays
+			} : prev.overlays,
+			highlight: change.highlight ?? prev.highlight
+		};
+		overrides.set(root.id, next);
+		root.source.setOverride(next);
+	};
+	const offRoots = host.onRoots((event) => {
+		if (!greeted) return;
+		if ("added" in event) {
+			notices.follow(event.added);
+			send({
+				type: "root-added",
+				protocol: DEVTOOLS_PROTOCOL,
+				root: event.added.info()
+			});
+		} else {
+			notices.unfollow(event.removed);
+			dropOverride(event.removed);
+			send({
+				type: "root-removed",
+				protocol: DEVTOOLS_PROTOCOL,
+				rootId: event.removed
+			});
+		}
+	});
+	const close = () => {
+		if (closed) return;
+		closed = true;
+		offRoots();
+		for (const rootId of notices.ids()) notices.unfollow(rootId);
+		for (const rootId of [...overrides.keys()]) dropOverride(rootId);
+	};
+	const greet = () => {
+		greeted = true;
+		for (const root of host.roots()) notices.follow(root);
+		send({
+			type: "sup",
+			protocol: DEVTOOLS_PROTOCOL,
+			kitVersion: VERSION,
+			roots: host.roots().map((r) => r.info())
+		});
+	};
+	return {
+		receive(message) {
+			if (closed) return;
+			const requestId = "requestId" in message ? message.requestId : null;
+			if (message.protocol !== DEVTOOLS_PROTOCOL) {
+				fail(requestId, `protocol mismatch: the page speaks ${DEVTOOLS_PROTOCOL}, the panel ${String(message.protocol)}`);
+				return;
+			}
+			if (message.type === "yo") return greet();
+			if (message.type === "bye") return close();
+			if (!greeted) return fail(requestId, "send yo before any request");
+			const root = host.root(message.rootId);
+			if (!root) return fail(requestId, `no root "${message.rootId}"`);
+			let result;
+			try {
+				result = answer(root, message, (change) => steer(root, change));
+			} catch (err) {
+				return fail(requestId, err.message);
+			}
+			send({
+				type: "result",
+				protocol: DEVTOOLS_PROTOCOL,
+				requestId: message.requestId,
+				result
+			});
+		},
+		close
+	};
+}
+
+//#endregion
+export { openSession };
+//# sourceMappingURL=session.js.map

package/dist/devtools/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","names":[],"sources":["../../src/devtools/session.ts"],"sourcesContent":["/**\n * One panel's connection to the page: the handshake, every request, the\n * change notices, and the overrides the panel holds, which go when it does.\n */\nimport { VERSION } from '../version';\nimport { answer } from './handlers';\nimport { createNotices, type DevtoolsSchedule } from './notices';\nimport {\n  DEVTOOLS_PROTOCOL, type DevtoolsOverlays, type DevtoolsResult, type PageMessage, type PanelMessage,\n} from './protocol';\nimport type { DevtoolsRoot } from './root';\nimport type { PageTransport } from './transport';\n\nexport type { DevtoolsSchedule };\n\n/** What a session needs from the hook. */\nexport interface SessionHost {\n  roots(): readonly DevtoolsRoot[];\n  root(id: string): DevtoolsRoot | undefined;\n  /** Hear roots come and go. Returns the unsubscribe. */\n  onRoots(listener: (event: { added: DevtoolsRoot } | { removed: string }) => void): () => void;\n  schedule: DevtoolsSchedule;\n}\n\nexport interface DevtoolsSession {\n  receive(message: PanelMessage): void;\n  close(): void;\n}\n\n/** What one panel lays over one canvas. */\nexport interface Override {\n  overlays: DevtoolsOverlays;\n  highlight: readonly string[];\n}\n\nexport function openSession(host: SessionHost, transport: PageTransport): DevtoolsSession {\n  const send = (m: PageMessage): void => transport.send(m);\n  const fail = (requestId: number | null, message: string): void =>\n    send({ type: 'error', protocol: DEVTOOLS_PROTOCOL, requestId, message });\n\n  let greeted = false;\n  let closed = false;\n  const notices = createNotices(host.root, host.schedule, (m) => { if (!closed) send(m); });\n  const overrides = new Map<string, Override>();\n\n  const dropOverride = (rootId: string): void => {\n    if (overrides.delete(rootId)) host.root(rootId)?.source.setOverride(null);\n  };\n\n  const steer = (root: DevtoolsRoot, change: Partial<Override>): void => {\n    const prev = overrides.get(root.id) ?? { overlays: {}, highlight: [] };\n    const next: Override = {\n      overlays: change.overlays ? { ...prev.overlays, ...change.overlays } : prev.overlays,\n      highlight: change.highlight ?? prev.highlight,\n    };\n    overrides.set(root.id, next);\n    root.source.setOverride(next);\n  };\n\n  const offRoots = host.onRoots((event) => {\n    if (!greeted) return;\n    if ('added' in event) {\n      notices.follow(event.added);\n      send({ type: 'root-added', protocol: DEVTOOLS_PROTOCOL, root: event.added.info() });\n    } else {\n      notices.unfollow(event.removed);\n      dropOverride(event.removed);\n      send({ type: 'root-removed', protocol: DEVTOOLS_PROTOCOL, rootId: event.removed });\n    }\n  });\n\n  const close = (): void => {\n    if (closed) return;\n    closed = true;\n    offRoots();\n    for (const rootId of notices.ids()) notices.unfollow(rootId);\n    for (const rootId of [...overrides.keys()]) dropOverride(rootId);\n  };\n\n  const greet = (): void => {\n    greeted = true;\n    for (const root of host.roots()) notices.follow(root);\n    send({ type: 'sup', protocol: DEVTOOLS_PROTOCOL, kitVersion: VERSION, roots: host.roots().map((r) => r.info()) });\n  };\n\n  return {\n    receive(message) {\n      if (closed) return;\n      const requestId = 'requestId' in message ? message.requestId : null;\n      if (message.protocol !== DEVTOOLS_PROTOCOL) {\n        fail(requestId, `protocol mismatch: the page speaks ${DEVTOOLS_PROTOCOL}, the panel ${String(message.protocol)}`);\n        return;\n      }\n      if (message.type === 'yo') return greet();\n      if (message.type === 'bye') return close();\n      if (!greeted) return fail(requestId, 'send yo before any request');\n      const root = host.root(message.rootId);\n      if (!root) return fail(requestId, `no root \"${message.rootId}\"`);\n      let result: DevtoolsResult;\n      try {\n        result = answer(root, message, (change) => steer(root, change));\n      } catch (err) {\n        return fail(requestId, (err as Error).message);\n      }\n      send({ type: 'result', protocol: DEVTOOLS_PROTOCOL, requestId: message.requestId, result });\n    },\n    close,\n  };\n}\n"],"mappings":";;;;;;;;;;AAmCA,SAAgB,YAAY,MAAmB,WAA2C;CACxF,MAAM,QAAQ,MAAyB,UAAU,KAAK,CAAC;CACvD,MAAM,QAAQ,WAA0B,YACtC,KAAK;EAAE,MAAM;EAAS,UAAU;EAAmB;EAAW;CAAQ,CAAC;CAEzE,IAAI,UAAU;CACd,IAAI,SAAS;CACb,MAAM,UAAU,cAAc,KAAK,MAAM,KAAK,WAAW,MAAM;EAAE,IAAI,CAAC,QAAQ,KAAK,CAAC;CAAG,CAAC;CACxF,MAAM,4BAAY,IAAI,IAAsB;CAE5C,MAAM,gBAAgB,WAAyB;EAC7C,IAAI,UAAU,OAAO,MAAM,GAAG,KAAK,KAAK,MAAM,CAAC,EAAE,OAAO,YAAY,IAAI;CAC1E;CAEA,MAAM,SAAS,MAAoB,WAAoC;EACrE,MAAM,OAAO,UAAU,IAAI,KAAK,EAAE,KAAK;GAAE,UAAU,CAAC;GAAG,WAAW,CAAC;EAAE;EACrE,MAAM,OAAiB;GACrB,UAAU,OAAO,WAAW;IAAE,GAAG,KAAK;IAAU,GAAG,OAAO;GAAS,IAAI,KAAK;GAC5E,WAAW,OAAO,aAAa,KAAK;EACtC;EACA,UAAU,IAAI,KAAK,IAAI,IAAI;EAC3B,KAAK,OAAO,YAAY,IAAI;CAC9B;CAEA,MAAM,WAAW,KAAK,SAAS,UAAU;EACvC,IAAI,CAAC,SAAS;EACd,IAAI,WAAW,OAAO;GACpB,QAAQ,OAAO,MAAM,KAAK;GAC1B,KAAK;IAAE,MAAM;IAAc,UAAU;IAAmB,MAAM,MAAM,MAAM,KAAK;GAAE,CAAC;EACpF,OAAO;GACL,QAAQ,SAAS,MAAM,OAAO;GAC9B,aAAa,MAAM,OAAO;GAC1B,KAAK;IAAE,MAAM;IAAgB,UAAU;IAAmB,QAAQ,MAAM;GAAQ,CAAC;EACnF;CACF,CAAC;CAED,MAAM,cAAoB;EACxB,IAAI,QAAQ;EACZ,SAAS;EACT,SAAS;EACT,KAAK,MAAM,UAAU,QAAQ,IAAI,GAAG,QAAQ,SAAS,MAAM;EAC3D,KAAK,MAAM,UAAU,CAAC,GAAG,UAAU,KAAK,CAAC,GAAG,aAAa,MAAM;CACjE;CAEA,MAAM,cAAoB;EACxB,UAAU;EACV,KAAK,MAAM,QAAQ,KAAK,MAAM,GAAG,QAAQ,OAAO,IAAI;EACpD,KAAK;GAAE,MAAM;GAAO,UAAU;GAAmB,YAAY;GAAS,OAAO,KAAK,MAAM,CAAC,CAAC,KAAK,MAAM,EAAE,KAAK,CAAC;EAAE,CAAC;CAClH;CAEA,OAAO;EACL,QAAQ,SAAS;GACf,IAAI,QAAQ;GACZ,MAAM,YAAY,eAAe,UAAU,QAAQ,YAAY;GAC/D,IAAI,QAAQ,aAAa,mBAAmB;IAC1C,KAAK,WAAW,sCAAsC,kBAAkB,cAAc,OAAO,QAAQ,QAAQ,GAAG;IAChH;GACF;GACA,IAAI,QAAQ,SAAS,MAAM,OAAO,MAAM;GACxC,IAAI,QAAQ,SAAS,OAAO,OAAO,MAAM;GACzC,IAAI,CAAC,SAAS,OAAO,KAAK,WAAW,4BAA4B;GACjE,MAAM,OAAO,KAAK,KAAK,QAAQ,MAAM;GACrC,IAAI,CAAC,MAAM,OAAO,KAAK,WAAW,YAAY,QAAQ,OAAO,EAAE;GAC/D,IAAI;GACJ,IAAI;IACF,SAAS,OAAO,MAAM,UAAU,WAAW,MAAM,MAAM,MAAM,CAAC;GAChE,SAAS,KAAK;IACZ,OAAO,KAAK,WAAY,IAAc,OAAO;GAC/C;GACA,KAAK;IAAE,MAAM;IAAU,UAAU;IAAmB,WAAW,QAAQ;IAAW;GAAO,CAAC;EAC5F;EACA;CACF;AACF"}

package/dist/devtools/transport.js

@@ -0,0 +1,67 @@
+//#region src/devtools/transport.ts
+/** Marks devtools traffic among whatever else a page posts to its window. */
+var DEVTOOLS_ENVELOPE = "weasel-devtools";
+/** Whether a posted message's `data` is devtools traffic. */
+function isDevtoolsEnvelope(data) {
+	return typeof data === "object" && data !== null && data.source === DEVTOOLS_ENVELOPE;
+}
+function pair() {
+	const toA = /* @__PURE__ */ new Set();
+	const toB = /* @__PURE__ */ new Set();
+	const listen = (set) => (listener) => {
+		set.add(listener);
+		return () => {
+			set.delete(listener);
+		};
+	};
+	return [{
+		send: (m) => {
+			for (const l of [...toB]) l(m);
+		},
+		onMessage: listen(toA)
+	}, {
+		send: (m) => {
+			for (const l of [...toA]) l(m);
+		},
+		onMessage: listen(toB)
+	}];
+}
+/** Both ends of a connection within one page: delivery is a direct, synchronous call. */
+function createInPageTransports() {
+	const [page, panel] = pair();
+	return {
+		page,
+		panel
+	};
+}
+function windowTransport(side, target) {
+	return {
+		send(message) {
+			const envelope = {
+				source: DEVTOOLS_ENVELOPE,
+				side,
+				message
+			};
+			target.postMessage(envelope, "*");
+		},
+		onMessage(listener) {
+			const onEvent = (e) => {
+				if (isDevtoolsEnvelope(e.data) && e.data.side !== side) listener(e.data.message);
+			};
+			target.addEventListener("message", onEvent);
+			return () => target.removeEventListener("message", onEvent);
+		}
+	};
+}
+/** The page's end over `window.postMessage`, for an extension's content script. */
+function createWindowPageTransport(target = window) {
+	return windowTransport("page", target);
+}
+/** The panel's end over `window.postMessage`: what a content script uses to reach the page. */
+function createWindowPanelTransport(target = window) {
+	return windowTransport("panel", target);
+}
+
+//#endregion
+export { DEVTOOLS_ENVELOPE, createInPageTransports, createWindowPageTransport, createWindowPanelTransport, isDevtoolsEnvelope };
+//# sourceMappingURL=transport.js.map

package/dist/devtools/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","names":[],"sources":["../../src/devtools/transport.ts"],"sourcesContent":["/**\n * How devtools messages travel. A transport sends one side's messages and\n * hears the other side's; the session neither knows nor cares which kind it has.\n */\nimport type { PageMessage, PanelMessage } from './protocol';\n\n/** One end of a connection: it sends `Out` and hears `In`. */\nexport interface DevtoolsTransport<Out, In> {\n  send(message: Out): void;\n  /** Hear the other side. Returns the unsubscribe. */\n  onMessage(listener: (message: In) => void): () => void;\n}\n\n/** The page's end of a connection. */\nexport type PageTransport = DevtoolsTransport<PageMessage, PanelMessage>;\n/** The panel's end of a connection. */\nexport type PanelTransport = DevtoolsTransport<PanelMessage, PageMessage>;\n\n/** Marks devtools traffic among whatever else a page posts to its window. */\nexport const DEVTOOLS_ENVELOPE = 'weasel-devtools';\n\n/** A devtools message as posted to a window. */\nexport interface DevtoolsEnvelope {\n  source: typeof DEVTOOLS_ENVELOPE;\n  side: 'page' | 'panel';\n  message: PageMessage | PanelMessage;\n}\n\n/** Whether a posted message's `data` is devtools traffic. */\nexport function isDevtoolsEnvelope(data: unknown): data is DevtoolsEnvelope {\n  return typeof data === 'object' && data !== null\n    && (data as { source?: unknown }).source === DEVTOOLS_ENVELOPE;\n}\n\nfunction pair<A, B>(): [DevtoolsTransport<A, B>, DevtoolsTransport<B, A>] {\n  const toA = new Set<(m: B) => void>();\n  const toB = new Set<(m: A) => void>();\n  const listen = <M>(set: Set<(m: M) => void>) => (listener: (m: M) => void) => {\n    set.add(listener);\n    return () => { set.delete(listener); };\n  };\n  return [\n    { send: (m) => { for (const l of [...toB]) l(m); }, onMessage: listen(toA) },\n    { send: (m) => { for (const l of [...toA]) l(m); }, onMessage: listen(toB) },\n  ];\n}\n\n/** Both ends of a connection within one page: delivery is a direct, synchronous call. */\nexport function createInPageTransports(): { page: PageTransport; panel: PanelTransport } {\n  const [page, panel] = pair<PageMessage, PanelMessage>();\n  return { page, panel };\n}\n\nfunction windowTransport<Out extends PageMessage | PanelMessage, In>(\n  side: 'page' | 'panel',\n  target: Window,\n): DevtoolsTransport<Out, In> {\n  return {\n    send(message) {\n      const envelope: DevtoolsEnvelope = { source: DEVTOOLS_ENVELOPE, side, message };\n      target.postMessage(envelope, '*');\n    },\n    onMessage(listener) {\n      const onEvent = (e: MessageEvent): void => {\n        if (isDevtoolsEnvelope(e.data) && e.data.side !== side) listener(e.data.message as In);\n      };\n      target.addEventListener('message', onEvent);\n      return () => target.removeEventListener('message', onEvent);\n    },\n  };\n}\n\n/** The page's end over `window.postMessage`, for an extension's content script. */\nexport function createWindowPageTransport(target: Window = window): PageTransport {\n  return windowTransport<PageMessage, PanelMessage>('page', target);\n}\n\n/** The panel's end over `window.postMessage`: what a content script uses to reach the page. */\nexport function createWindowPanelTransport(target: Window = window): PanelTransport {\n  return windowTransport<PanelMessage, PageMessage>('panel', target);\n}\n"],"mappings":";;AAmBA,IAAa,oBAAoB;;AAUjC,SAAgB,mBAAmB,MAAyC;CAC1E,OAAO,OAAO,SAAS,YAAY,SAAS,QACtC,KAA8B,WAAW;AACjD;AAEA,SAAS,OAAiE;CACxE,MAAM,sBAAM,IAAI,IAAoB;CACpC,MAAM,sBAAM,IAAI,IAAoB;CACpC,MAAM,UAAa,SAA8B,aAA6B;EAC5E,IAAI,IAAI,QAAQ;EAChB,aAAa;GAAE,IAAI,OAAO,QAAQ;EAAG;CACvC;CACA,OAAO,CACL;EAAE,OAAO,MAAM;GAAE,KAAK,MAAM,KAAK,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC;EAAG;EAAG,WAAW,OAAO,GAAG;CAAE,GAC3E;EAAE,OAAO,MAAM;GAAE,KAAK,MAAM,KAAK,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC;EAAG;EAAG,WAAW,OAAO,GAAG;CAAE,CAC7E;AACF;;AAGA,SAAgB,yBAAyE;CACvF,MAAM,CAAC,MAAM,SAAS,KAAgC;CACtD,OAAO;EAAE;EAAM;CAAM;AACvB;AAEA,SAAS,gBACP,MACA,QAC4B;CAC5B,OAAO;EACL,KAAK,SAAS;GACZ,MAAM,WAA6B;IAAE,QAAQ;IAAmB;IAAM;GAAQ;GAC9E,OAAO,YAAY,UAAU,GAAG;EAClC;EACA,UAAU,UAAU;GAClB,MAAM,WAAW,MAA0B;IACzC,IAAI,mBAAmB,EAAE,IAAI,KAAK,EAAE,KAAK,SAAS,MAAM,SAAS,EAAE,KAAK,OAAa;GACvF;GACA,OAAO,iBAAiB,WAAW,OAAO;GAC1C,aAAa,OAAO,oBAAoB,WAAW,OAAO;EAC5D;CACF;AACF;;AAGA,SAAgB,0BAA0B,SAAiB,QAAuB;CAChF,OAAO,gBAA2C,QAAQ,MAAM;AAClE;;AAGA,SAAgB,2BAA2B,SAAiB,QAAwB;CAClF,OAAO,gBAA2C,SAAS,MAAM;AACnE"}

package/dist/devtools/useDevtoolsRoot.js

@@ -0,0 +1,81 @@
+import { parseDebugFlags } from "../debug/parseDebugFlags.js";
+import { installDevtoolsHook } from "./hook.js";
+import { createDevtoolsRoot } from "./root.js";
+import { useEffect, useMemo, useState } from "react";
+import { isDev, useLatest } from "@weasel-js/react";
+
+//#region src/devtools/useDevtoolsRoot.ts
+/** `debug` as the canvas resolves it, with `override` over it. Absent `debug` reads `?debug=` from the URL. */
+function withOverride(debug, override) {
+	if (!override) return debug;
+	return {
+		...debug === void 0 ? (typeof window === "undefined" ? null : parseDebugFlags(window.location.search)) ?? {} : debug === false ? {} : debug,
+		...override.overlays,
+		...override.highlight.length ? { highlight: override.highlight } : {}
+	};
+}
+/** A canvas's `debug` prop with the override a connected panel holds. */
+function useDevtoolsOverride(debug) {
+	const [override, setOverride] = useState(null);
+	return {
+		debug: useMemo(() => withOverride(debug, override), [debug, override]),
+		setOverride
+	};
+}
+function dimensionOf(inputs) {
+	const scene = inputs.scene();
+	const first = scene?.roots[0];
+	return typeof (first ? scene?.get(first)?.pose : void 0)?.position?.z === "number" ? "3d" : "2d";
+}
+/**
+* This canvas's root, for the test hook and the devtools hook alike. Registered
+* with the devtools hook in a dev build, which installs it, and in a production
+* build only when the app imported `@weasel-js/core/devtools`.
+*/
+function useDevtoolsRoot(inputs, changes) {
+	const live = useLatest(inputs);
+	const [root] = useState(() => {
+		const l = live.current;
+		return createDevtoolsRoot({
+			label: () => live.current.label(),
+			get dimension() {
+				return dimensionOf(live.current);
+			},
+			scene: () => live.current.scene(),
+			selection: () => live.current.selection(),
+			select: (ids) => live.current.select(ids),
+			view: () => live.current.view(),
+			activeTool: () => live.current.activeTool(),
+			tools: () => live.current.tools(),
+			setTool: (id) => live.current.setTool(id),
+			trace: l.trace,
+			coords: l.coords,
+			frame: () => live.current.frame(),
+			overlays: () => live.current.overlays(),
+			setOverride: (o) => live.current.setOverride(o),
+			...l.registry ? { registry: () => live.current.registry() } : {},
+			...l.subscribeRegistry ? { subscribeRegistry: (fn) => live.current.subscribeRegistry(fn) } : {},
+			...l.history ? { history: l.history } : {}
+		});
+	});
+	useEffect(() => {
+		return (typeof window === "undefined" ? null : isDev() ? installDevtoolsHook() : window.__weaselDevtools__ ?? null)?.register(root);
+	}, [root]);
+	const scene = inputs.scene();
+	useEffect(() => {
+		root.notify("scene");
+	}, [root, scene]);
+	useEffect(() => {
+		root.notify("selection");
+	}, [root, changes.selection]);
+	useEffect(() => {
+		root.notify("tool");
+	}, [root, changes.tool]);
+	const { subscribeView } = inputs;
+	useEffect(() => subscribeView(() => root.notify("view")), [root, subscribeView]);
+	return root;
+}
+
+//#endregion
+export { useDevtoolsOverride, useDevtoolsRoot, withOverride };
+//# sourceMappingURL=useDevtoolsRoot.js.map

package/dist/devtools/useDevtoolsRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDevtoolsRoot.js","names":[],"sources":["../../src/devtools/useDevtoolsRoot.ts"],"sourcesContent":["import { useEffect, useMemo, useState } from 'react';\nimport { isDev, useLatest } from '@weasel-js/react';\nimport type { View } from 'core/viewport/view';\nimport type { DebugConfig } from '../debug/types';\nimport { parseDebugFlags } from '../debug/parseDebugFlags';\nimport { installDevtoolsHook } from './hook';\nimport { createDevtoolsRoot, type DevtoolsRoot, type DevtoolsRootSource } from './root';\nimport type { DevtoolsOverlays } from './protocol';\n\n/** What a panel lays over a canvas's own `debug` prop. */\nexport interface DevtoolsOverride {\n  overlays: DevtoolsOverlays;\n  highlight: readonly string[];\n}\n\n/** `debug` as the canvas resolves it, with `override` over it. Absent `debug` reads `?debug=` from the URL. */\nexport function withOverride<D extends DebugConfig>(\n  debug: D | false | undefined,\n  override: DevtoolsOverride | null,\n): D | DebugConfig | false | undefined {\n  if (!override) return debug;\n  const base: DebugConfig = debug === undefined\n    ? (typeof window === 'undefined' ? null : parseDebugFlags(window.location.search)) ?? {}\n    : debug === false ? {} : debug;\n  return { ...base, ...override.overlays, ...(override.highlight.length ? { highlight: override.highlight } : {}) };\n}\n\n/** A canvas's `debug` prop with the override a connected panel holds. */\nexport function useDevtoolsOverride<T extends DebugConfig | false | undefined>(debug: T) {\n  const [override, setOverride] = useState<DevtoolsOverride | null>(null);\n  // An override only adds feature flags, so the canvas's own config type still describes the result.\n  const effective = useMemo(() => withOverride(debug, override) as T, [debug, override]);\n  return { debug: effective, setOverride };\n}\n\n/** The live values a root reads, re-read from the latest render on every call. */\nexport type DevtoolsRootInputs = Omit<DevtoolsRootSource, 'trace' | 'coords' | 'history' | 'dimension'> & {\n  trace: DevtoolsRootSource['trace'];\n  coords: DevtoolsRootSource['coords'];\n  history?: DevtoolsRootSource['history'];\n  /** The view's own change feed: a pan writes the view without a render. */\n  subscribeView(listener: (view: View) => void): () => void;\n};\n\nfunction dimensionOf(inputs: DevtoolsRootInputs): '2d' | '3d' {\n  const scene = inputs.scene();\n  const first = scene?.roots[0];\n  const pose = first ? scene?.get(first)?.pose : undefined;\n  return typeof (pose as { position?: { z?: unknown } } | undefined)?.position?.z === 'number' ? '3d' : '2d';\n}\n\n/**\n * This canvas's root, for the test hook and the devtools hook alike. Registered\n * with the devtools hook in a dev build, which installs it, and in a production\n * build only when the app imported `@weasel-js/core/devtools`.\n */\nexport function useDevtoolsRoot(\n  inputs: DevtoolsRootInputs,\n  changes: { selection: readonly string[]; tool: string | null },\n): DevtoolsRoot {\n  const live = useLatest(inputs);\n  const [root] = useState(() => {\n    const l = live.current;\n    return createDevtoolsRoot({\n      label: () => live.current.label(),\n      get dimension() { return dimensionOf(live.current); },\n      scene: () => live.current.scene(),\n      selection: () => live.current.selection(),\n      select: (ids) => live.current.select(ids),\n      view: () => live.current.view(),\n      activeTool: () => live.current.activeTool(),\n      tools: () => live.current.tools(),\n      setTool: (id) => live.current.setTool(id),\n      trace: l.trace,\n      coords: l.coords,\n      frame: () => live.current.frame(),\n      overlays: () => live.current.overlays(),\n      setOverride: (o) => live.current.setOverride(o),\n      ...(l.registry ? { registry: () => live.current.registry!() } : {}),\n      ...(l.subscribeRegistry ? { subscribeRegistry: (fn: () => void) => live.current.subscribeRegistry!(fn) } : {}),\n      ...(l.history ? { history: l.history } : {}),\n    });\n  });\n\n  useEffect(() => {\n    const hook = typeof window === 'undefined' ? null\n      : isDev() ? installDevtoolsHook() : window.__weaselDevtools__ ?? null;\n    return hook?.register(root);\n  }, [root]);\n\n  const scene = inputs.scene();\n  useEffect(() => { root.notify('scene'); }, [root, scene]);\n  useEffect(() => { root.notify('selection'); }, [root, changes.selection]);\n  useEffect(() => { root.notify('tool'); }, [root, changes.tool]);\n  const { subscribeView } = inputs;\n  useEffect(() => subscribeView(() => root.notify('view')), [root, subscribeView]);\n  return root;\n}\n"],"mappings":";;;;;;;;AAgBA,SAAgB,aACd,OACA,UACqC;CACrC,IAAI,CAAC,UAAU,OAAO;CAItB,OAAO;EAAE,GAHiB,UAAU,UAC/B,OAAO,WAAW,cAAc,OAAO,gBAAgB,OAAO,SAAS,MAAM,MAAM,CAAC,IACrF,UAAU,QAAQ,CAAC,IAAI;EACT,GAAG,SAAS;EAAU,GAAI,SAAS,UAAU,SAAS,EAAE,WAAW,SAAS,UAAU,IAAI,CAAC;CAAG;AAClH;;AAGA,SAAgB,oBAA+D,OAAU;CACvF,MAAM,CAAC,UAAU,eAAe,SAAkC,IAAI;CAGtE,OAAO;EAAE,OADS,cAAc,aAAa,OAAO,QAAQ,GAAQ,CAAC,OAAO,QAAQ,CACpE;EAAW;CAAY;AACzC;AAWA,SAAS,YAAY,QAAyC;CAC5D,MAAM,QAAQ,OAAO,MAAM;CAC3B,MAAM,QAAQ,OAAO,MAAM;CAE3B,OAAO,QADM,QAAQ,OAAO,IAAI,KAAK,CAAC,EAAE,OAAO,OAChC,EAAqD,UAAU,MAAM,WAAW,OAAO;AACxG;;;;;;AAOA,SAAgB,gBACd,QACA,SACc;CACd,MAAM,OAAO,UAAU,MAAM;CAC7B,MAAM,CAAC,QAAQ,eAAe;EAC5B,MAAM,IAAI,KAAK;EACf,OAAO,mBAAmB;GACxB,aAAa,KAAK,QAAQ,MAAM;GAChC,IAAI,YAAY;IAAE,OAAO,YAAY,KAAK,OAAO;GAAG;GACpD,aAAa,KAAK,QAAQ,MAAM;GAChC,iBAAiB,KAAK,QAAQ,UAAU;GACxC,SAAS,QAAQ,KAAK,QAAQ,OAAO,GAAG;GACxC,YAAY,KAAK,QAAQ,KAAK;GAC9B,kBAAkB,KAAK,QAAQ,WAAW;GAC1C,aAAa,KAAK,QAAQ,MAAM;GAChC,UAAU,OAAO,KAAK,QAAQ,QAAQ,EAAE;GACxC,OAAO,EAAE;GACT,QAAQ,EAAE;GACV,aAAa,KAAK,QAAQ,MAAM;GAChC,gBAAgB,KAAK,QAAQ,SAAS;GACtC,cAAc,MAAM,KAAK,QAAQ,YAAY,CAAC;GAC9C,GAAI,EAAE,WAAW,EAAE,gBAAgB,KAAK,QAAQ,SAAU,EAAE,IAAI,CAAC;GACjE,GAAI,EAAE,oBAAoB,EAAE,oBAAoB,OAAmB,KAAK,QAAQ,kBAAmB,EAAE,EAAE,IAAI,CAAC;GAC5G,GAAI,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,IAAI,CAAC;EAC5C,CAAC;CACH,CAAC;CAED,gBAAgB;EAGd,QAFa,OAAO,WAAW,cAAc,OACzC,MAAM,IAAI,oBAAoB,IAAI,OAAO,sBAAsB,KAC5D,EAAM,SAAS,IAAI;CAC5B,GAAG,CAAC,IAAI,CAAC;CAET,MAAM,QAAQ,OAAO,MAAM;CAC3B,gBAAgB;EAAE,KAAK,OAAO,OAAO;CAAG,GAAG,CAAC,MAAM,KAAK,CAAC;CACxD,gBAAgB;EAAE,KAAK,OAAO,WAAW;CAAG,GAAG,CAAC,MAAM,QAAQ,SAAS,CAAC;CACxE,gBAAgB;EAAE,KAAK,OAAO,MAAM;CAAG,GAAG,CAAC,MAAM,QAAQ,IAAI,CAAC;CAC9D,MAAM,EAAE,kBAAkB;CAC1B,gBAAgB,oBAAoB,KAAK,OAAO,MAAM,CAAC,GAAG,CAAC,MAAM,aAAa,CAAC;CAC/E,OAAO;AACT"}