@fluixi/devtools 0.2.0-alpha.2 → 0.2.0-alpha.4

package/dist/detail-panel.mjs

@@ -0,0 +1,284 @@
+// src/copy.ts
+function confirmOn(button, said = "copied") {
+  if (!button) return;
+  const was = button.textContent;
+  button.textContent = said;
+  setTimeout(() => {
+    button.textContent = was;
+  }, 1200);
+}
+function fallback(text, button) {
+  try {
+    const doc = button?.ownerDocument ?? document;
+    const area = doc.createElement("textarea");
+    area.value = text;
+    area.setAttribute("readonly", "");
+    area.style.position = "fixed";
+    area.style.opacity = "0";
+    doc.body.appendChild(area);
+    area.select();
+    doc.execCommand("copy");
+    area.remove();
+    confirmOn(button);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function copyText(text, button) {
+  const clipboard = globalThis.navigator?.clipboard;
+  if (clipboard?.writeText) {
+    try {
+      await clipboard.writeText(text);
+      confirmOn(button);
+      return true;
+    } catch {
+    }
+  }
+  return fallback(text, button);
+}
+
+// src/change-view.ts
+var escape = (text) => text.replace(/[&<>"]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" })[c]);
+var SIGN = { added: "+", removed: "−", changed: "~" };
+function pretty(json) {
+  if (!json) return void 0;
+  try {
+    return JSON.stringify(JSON.parse(json), null, 2);
+  } catch {
+    return void 0;
+  }
+}
+function sideOf(text, json, cls) {
+  const block = pretty(json);
+  if (!block) return `<span class="ch-${cls}">${escape(text ?? "")}</span>`;
+  return `<div class="ch-block ch-${cls}"><button type="button" class="ch-copy" title="Copy" data-copy="${escape(block)}">copy</button><pre class="ch-json">${escape(block)}</pre></div>`;
+}
+function changeRows(change, limit = Infinity) {
+  if (!change?.entries?.length) return "";
+  const shown = change.entries.slice(0, limit);
+  const hidden = change.entries.length - shown.length + (change.more ?? 0);
+  const rows = shown.map((entry) => {
+    const from = sideOf(entry.from, entry.fromJson, "from");
+    const to = sideOf(entry.to, entry.toJson, "to");
+    const sides = entry.op === "changed" ? `${from}<span class="ch-arrow">→</span>${to}` : entry.op === "added" ? to : from;
+    const stacked = entry.fromJson || entry.toJson ? " ch-stacked" : "";
+    return `<div class="ch-row ch-${entry.op}${stacked}"><span class="ch-sign">${SIGN[entry.op] ?? "·"}</span><span class="ch-key">${escape(entry.key)}</span><span class="ch-sides">${sides}</span></div>`;
+  }).join("");
+  const size = change.length ? `<div class="ch-size">${change.length.from} → ${change.length.to} items</div>` : "";
+  return `<div class="ch-list">${size}${rows}${hidden > 0 ? `<div class="ch-more">and ${hidden} more</div>` : ""}</div>`;
+}
+function handleCopyClick(event) {
+  const button = event.target?.closest?.(".ch-copy");
+  if (!button) return false;
+  void copyText(button.dataset.copy ?? "", button);
+  return true;
+}
+var CHANGE_CSS = `
+.ch-list { margin-top: 4px; font-family: ui-monospace, monospace; font-size: 11px; }
+.ch-size { color: var(--fx-muted, #8a90a2); margin-bottom: 2px; }
+.ch-row { display: flex; gap: 6px; align-items: baseline; padding: 1px 0; }
+.ch-row.ch-stacked { align-items: flex-start; padding: 3px 0; }
+.ch-sign { flex: none; width: 9px; text-align: center; }
+.ch-added .ch-sign { color: var(--state, #34d399); }
+.ch-removed .ch-sign { color: var(--fx-write, #fb7185); }
+.ch-changed .ch-sign { color: var(--effect, #fbbf24); }
+.ch-key { flex: none; color: var(--fx-muted, #8a90a2); }
+.ch-sides { min-width: 0; flex: 1; overflow-wrap: anywhere; }
+.ch-stacked .ch-sides { display: flex; flex-direction: column; gap: 2px; }
+.ch-from { color: var(--fx-muted, #8a90a2); }
+.ch-row:not(.ch-stacked) .ch-from { text-decoration: line-through; }
+.ch-arrow { color: var(--fx-muted, #8a90a2); margin: 0 4px; }
+.ch-to { color: var(--fx-label, #e7e9ee); }
+.ch-more { color: var(--fx-muted, #8a90a2); margin-top: 2px; }
+/* In the corner: an object can be tall, and a button under it is a scroll away. */
+.ch-block { position: relative; border-radius: 4px; border: 1px solid var(--fx-line, #ffffff14); }
+.ch-block.ch-from { opacity: .72; }
+.ch-json { margin: 0; padding: 5px 7px; overflow-x: auto; white-space: pre; font: inherit; }
+.ch-copy {
+  position: absolute; top: 3px; right: 3px; padding: 1px 6px; cursor: pointer;
+  font: inherit; font-size: 9.5px; opacity: 0; transition: opacity .12s;
+  border: 1px solid var(--fx-line, #ffffff26); border-radius: 3px;
+  background: var(--fx-panel, #14161c); color: var(--fx-muted, #8a90a2);
+}
+.ch-block:hover .ch-copy, .ch-copy:focus { opacity: 1; }
+.ch-copy:hover { color: var(--fx-label, #e7e9ee); }
+`;
+
+// src/detail-panel.ts
+var escape2 = (text) => text.replace(/[&<>"]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" })[c]);
+var clock = (t) => {
+  const d = new Date(t);
+  const pad = (n, w = 2) => String(n).padStart(w, "0");
+  return `${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}.${pad(d.getMilliseconds(), 3)}`;
+};
+var VERBS = {
+  write: "written",
+  ran: "ran",
+  created: "made",
+  disposed: "gone"
+};
+var MIN_W = 320;
+var MIN_H = 200;
+function draggable(handle, onMove) {
+  handle.addEventListener("pointerdown", (event) => {
+    if (event.button !== 0) return;
+    if (event.target.closest("button")) return;
+    event.preventDefault();
+    event.stopPropagation();
+    handle.setPointerCapture(event.pointerId);
+    let lastX = event.clientX;
+    let lastY = event.clientY;
+    const move = (e) => {
+      onMove(e.clientX - lastX, e.clientY - lastY);
+      lastX = e.clientX;
+      lastY = e.clientY;
+    };
+    const stop = () => {
+      handle.removeEventListener("pointermove", move);
+      handle.removeEventListener("pointerup", stop);
+      handle.removeEventListener("pointercancel", stop);
+      handle.removeEventListener("lostpointercapture", stop);
+      if (handle.hasPointerCapture(event.pointerId)) handle.releasePointerCapture(event.pointerId);
+    };
+    handle.addEventListener("pointermove", move);
+    handle.addEventListener("pointerup", stop);
+    handle.addEventListener("pointercancel", stop);
+    handle.addEventListener("lostpointercapture", stop);
+  });
+}
+function createDetailPanel(host, options = {}) {
+  const panel = host.ownerDocument.createElement("div");
+  panel.className = "dp-panel";
+  panel.hidden = true;
+  panel.innerHTML = '<div class="dp-bar"><span class="dp-title"></span><button type="button" class="dp-close" title="Close" aria-label="Close">✕</button></div><div class="dp-body"></div><div class="dp-grip" title="Drag to resize"></div>';
+  host.appendChild(panel);
+  const title = panel.querySelector(".dp-title");
+  const body = panel.querySelector(".dp-body");
+  const bar = panel.querySelector(".dp-bar");
+  const grip = panel.querySelector(".dp-grip");
+  let x = 0;
+  let y = 0;
+  let width = 520;
+  let height = 380;
+  let open = false;
+  const place = () => {
+    panel.style.left = `${Math.round(x)}px`;
+    panel.style.top = `${Math.round(y)}px`;
+    panel.style.width = `${Math.round(width)}px`;
+    panel.style.height = `${Math.round(height)}px`;
+  };
+  draggable(bar, (dx, dy) => {
+    const view = panel.ownerDocument.defaultView;
+    x = Math.max(0, Math.min((view?.innerWidth ?? width) - 60, x + dx));
+    y = Math.max(0, Math.min((view?.innerHeight ?? height) - 30, y + dy));
+    place();
+  });
+  draggable(grip, (dx, dy) => {
+    width = Math.max(MIN_W, width + dx);
+    height = Math.max(MIN_H, height + dy);
+    place();
+  });
+  panel.querySelector(".dp-close")?.addEventListener("click", () => close());
+  body.addEventListener("click", (e) => {
+    if (handleCopyClick(e)) return;
+    const row = e.target.closest(".dp-node");
+    if (row?.dataset.id) options.onPick?.(Number(row.dataset.id));
+  });
+  function close() {
+    open = false;
+    panel.hidden = true;
+  }
+  return {
+    open(commit, graph) {
+      const nameOf = (e) => graph.get(e.id)?.label ?? e.label ?? `#${e.id}`;
+      const cause = commit.cause;
+      title.textContent = cause ? `${nameOf(cause)} · ${clock(commit.t)}` : `${commit.commit === 0 ? "first render" : `commit ${commit.commit}`} · ${clock(commit.t)}`;
+      const headline = cause && cause.from !== void 0 && cause.to !== void 0 ? `<div class="dp-change"><span class="ch-from">${escape2(cause.from)}</span><span class="ch-arrow">→</span><span class="ch-to">${escape2(cause.to)}</span></div>` : "";
+      const groups = ["write", "ran", "created", "disposed"].map((kind) => {
+        const rows = commit.events.filter((e) => e.kind === kind && e !== cause);
+        if (!rows.length) return "";
+        const seen = /* @__PURE__ */ new Map();
+        for (const event of rows) {
+          const found = seen.get(event.id);
+          if (found) found.count++;
+          else seen.set(event.id, { name: nameOf(event), count: 1 });
+        }
+        const items = [...seen].map(
+          ([id, { name, count }]) => `<button type="button" class="dp-node" data-id="${id}">${escape2(name)}${count > 1 ? ` ×${count}` : ""}</button>`
+        ).join("");
+        return `<div class="dp-group"><div class="dp-verb">${VERBS[kind]}</div><div class="dp-nodes">${items}</div></div>`;
+      }).join("");
+      const node = cause ? graph.get(cause.id) : void 0;
+      const where = (t) => {
+        if (!t.source) return "";
+        const file = (t.source.file ?? "").split("/").pop() ?? "";
+        const out = t.source.compiled;
+        const tail = out && out.line !== t.source.line ? ` · out ${out.line}` : "";
+        return ` — ${file}:${t.source.line ?? ""}${tail}`;
+      };
+      const targets = node?.targets?.length ? `<div class="dp-group"><div class="dp-verb">updates</div><div class="dp-targets">${node.targets.map(
+        (t) => `<div>${escape2(t.name ? `${t.name} of ${t.element}` : t.element)}<span class="dp-where">${escape2(where(t))}</span></div>`
+      ).join("")}</div></div>` : "";
+      body.innerHTML = headline + changeRows(cause?.change) + groups + targets;
+      if (!open) {
+        const view = panel.ownerDocument.defaultView;
+        x = Math.max(12, ((view?.innerWidth ?? 900) - width) / 2);
+        y = Math.max(12, ((view?.innerHeight ?? 600) - height) / 3);
+        place();
+      }
+      open = true;
+      panel.hidden = false;
+    },
+    close,
+    get isOpen() {
+      return open;
+    },
+    destroy() {
+      panel.remove();
+    }
+  };
+}
+var DETAIL_PANEL_CSS = `
+.dp-panel {
+  position: fixed; z-index: 40; display: flex; flex-direction: column;
+  border: 1px solid var(--fx-line, #ffffff26); border-radius: 8px;
+  background: var(--fx-panel, #14161c); color: var(--fx-label, #e7e9ee);
+  box-shadow: 0 12px 40px rgba(0, 0, 0, .45); overflow: hidden;
+}
+.dp-panel[hidden] { display: none; }
+.dp-bar {
+  display: flex; align-items: center; gap: 8px; padding: 6px 8px 6px 12px;
+  cursor: move; user-select: none;
+  border-bottom: 1px solid var(--fx-line, #ffffff1f);
+}
+.dp-title { font-family: ui-monospace, monospace; font-size: 12px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.dp-close {
+  margin-left: auto; width: 22px; height: 20px; padding: 0; cursor: pointer; font: inherit; font-size: 11px;
+  border: 1px solid var(--fx-line, #ffffff1f); border-radius: 4px;
+  background: transparent; color: var(--fx-muted, #8a90a2);
+}
+.dp-close:hover { color: var(--fx-label, #e7e9ee); }
+.dp-body { flex: 1; min-height: 0; overflow: auto; padding: 10px 12px; }
+.dp-change { font-family: ui-monospace, monospace; font-size: 12px; overflow-wrap: anywhere; }
+.dp-group { margin-top: 10px; }
+.dp-verb { font-size: 10.5px; text-transform: uppercase; letter-spacing: 1px; color: var(--fx-muted, #8a90a2); }
+.dp-nodes { display: flex; flex-wrap: wrap; gap: 4px; margin-top: 4px; }
+.dp-node {
+  padding: 2px 7px; cursor: pointer; font: inherit; font-family: ui-monospace, monospace; font-size: 11px;
+  border: 1px solid var(--fx-line, #ffffff1f); border-radius: 999px;
+  background: transparent; color: var(--fx-label, #e7e9ee);
+}
+.dp-node:hover { border-color: var(--fx-accent, #5eead4); }
+.dp-targets { margin-top: 4px; font-family: ui-monospace, monospace; font-size: 11px; color: var(--fx-label, #e7e9ee); }
+.dp-where { color: var(--fx-muted, #8a90a2); }
+/* Bottom-right, where every desktop puts it. */
+.dp-grip {
+  position: absolute; right: 0; bottom: 0; width: 16px; height: 16px; cursor: nwse-resize;
+  background: linear-gradient(135deg, transparent 50%, var(--fx-line, #ffffff40) 50%);
+}
+${CHANGE_CSS}`;
+export {
+  DETAIL_PANEL_CSS,
+  createDetailPanel
+};

package/dist/diff.cjs

@@ -0,0 +1,225 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/diff.ts
+var diff_exports = {};
+__export(diff_exports, {
+  diffValues: () => diffValues
+});
+module.exports = __toCommonJS(diff_exports);
+
+// src/format.ts
+var MAX_DEPTH = 3;
+var MAX_ENTRIES = 8;
+function domName(v) {
+  if (typeof v?.nodeType !== "number" || typeof v.nodeName !== "string") return null;
+  return v.tagName ? `<${v.tagName.toLowerCase()}>` : `#${v.nodeName.toLowerCase()}`;
+}
+function fnName(v) {
+  return v.name ? `ƒ ${v.name}()` : "ƒ";
+}
+function className(v) {
+  const name = v.constructor?.name;
+  return name && name !== "Object" ? `${name} ` : "";
+}
+function primitive(v) {
+  if (v === null) return "null";
+  switch (typeof v) {
+    case "undefined":
+      return "undefined";
+    case "string":
+      return JSON.stringify(v);
+    case "number":
+    case "boolean":
+      return String(v);
+    case "bigint":
+      return `${v}n`;
+    case "symbol":
+      return v.toString();
+    case "function":
+      return fnName(v);
+    default:
+      return null;
+  }
+}
+function walk(value, depth, seen) {
+  const simple = primitive(value);
+  if (simple !== null) return simple;
+  const object = value;
+  if (seen.has(object)) return "[circular]";
+  const dom = domName(object);
+  if (dom) return dom;
+  if (object instanceof Date) return Number.isNaN(object.getTime()) ? "Invalid Date" : object.toISOString();
+  if (object instanceof RegExp) return String(object);
+  if (object instanceof Error) return `${object.name}: ${object.message}`;
+  if (object instanceof Promise) return "Promise";
+  if (ArrayBuffer.isView(object)) {
+    return `${className(object).trim()}(${object.length ?? ""})`;
+  }
+  if (depth >= MAX_DEPTH) return Array.isArray(object) ? "[…]" : "{…}";
+  seen.add(object);
+  try {
+    if (Array.isArray(object)) {
+      const shown2 = object.slice(0, MAX_ENTRIES).map((item) => walk(item, depth + 1, seen));
+      if (object.length > MAX_ENTRIES) shown2.push("…");
+      return `[${shown2.join(", ")}]`;
+    }
+    if (object instanceof Map) {
+      const shown2 = [];
+      for (const [k, v] of object) {
+        if (shown2.length === MAX_ENTRIES) {
+          shown2.push("…");
+          break;
+        }
+        shown2.push(`${walk(k, depth + 1, seen)} => ${walk(v, depth + 1, seen)}`);
+      }
+      return `Map(${object.size}) {${shown2.join(", ")}}`;
+    }
+    if (object instanceof Set) {
+      const shown2 = [];
+      for (const item of object) {
+        if (shown2.length === MAX_ENTRIES) {
+          shown2.push("…");
+          break;
+        }
+        shown2.push(walk(item, depth + 1, seen));
+      }
+      return `Set(${object.size}) {${shown2.join(", ")}}`;
+    }
+    const keys = Object.keys(object);
+    const shown = keys.slice(0, MAX_ENTRIES).map((key) => {
+      let read;
+      try {
+        read = walk(object[key], depth + 1, seen);
+      } catch {
+        read = "[unreadable]";
+      }
+      return `${key}: ${read}`;
+    });
+    if (keys.length > MAX_ENTRIES) shown.push("…");
+    return `${className(object)}{${shown.join(", ")}}`;
+  } finally {
+    seen.delete(object);
+  }
+}
+function formatValue(value, limit = 240) {
+  let text;
+  try {
+    text = walk(value, 0, /* @__PURE__ */ new Set());
+  } catch {
+    text = "[unreadable]";
+  }
+  return text.length > limit ? `${text.slice(0, limit - 1)}…` : text;
+}
+
+// src/diff.ts
+var MAX_ENTRIES2 = 24;
+var ENTRY_VALUE = 120;
+var ENTRY_JSON = 4e3;
+var show = (value) => formatValue(value, ENTRY_VALUE);
+function json(value) {
+  if (value === null || typeof value !== "object") return void 0;
+  try {
+    const text = JSON.stringify(value);
+    return text && text.length <= ENTRY_JSON ? text : void 0;
+  } catch {
+    return void 0;
+  }
+}
+var side = (value, key) => {
+  const text = json(value);
+  return { [key]: show(value), ...text ? { [`${key}Json`]: text } : {} };
+};
+var isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function same(a, b) {
+  if (Object.is(a, b)) return true;
+  if (typeof a !== "object" || typeof b !== "object" || a === null || b === null) return false;
+  if (Array.isArray(a) !== Array.isArray(b)) return false;
+  const ka = Object.keys(a);
+  const kb = Object.keys(b);
+  if (ka.length !== kb.length) return false;
+  return ka.every((k) => Object.is(a[k], b[k]));
+}
+function diffArray(before, after) {
+  let head = 0;
+  while (head < before.length && head < after.length && same(before[head], after[head])) head++;
+  let tail = 0;
+  while (tail < before.length - head && tail < after.length - head && same(before[before.length - 1 - tail], after[after.length - 1 - tail])) {
+    tail++;
+  }
+  const entries = [];
+  let skipped = 0;
+  const push = (entry) => {
+    if (entries.length < MAX_ENTRIES2) entries.push(entry);
+    else skipped++;
+  };
+  const removedCount = before.length - head - tail;
+  const addedCount = after.length - head - tail;
+  const overlap = Math.min(removedCount, addedCount);
+  for (let i = 0; i < overlap; i++) {
+    push({
+      key: String(head + i),
+      op: "changed",
+      ...side(before[head + i], "from"),
+      ...side(after[head + i], "to")
+    });
+  }
+  for (let i = overlap; i < addedCount; i++) {
+    push({ key: String(head + i), op: "added", ...side(after[head + i], "to") });
+  }
+  for (let i = overlap; i < removedCount; i++) {
+    push({ key: String(head + i), op: "removed", ...side(before[head + i], "from") });
+  }
+  return {
+    shape: "array",
+    entries,
+    ...skipped ? { more: skipped } : {},
+    ...before.length !== after.length ? { length: { from: before.length, to: after.length } } : {}
+  };
+}
+function diffObject(before, after) {
+  const entries = [];
+  let skipped = 0;
+  const push = (entry) => {
+    if (entries.length < MAX_ENTRIES2) entries.push(entry);
+    else skipped++;
+  };
+  for (const key of /* @__PURE__ */ new Set([...Object.keys(before), ...Object.keys(after)])) {
+    const had = key in before;
+    const has = key in after;
+    if (had && has) {
+      if (!same(before[key], after[key])) {
+        push({ key, op: "changed", ...side(before[key], "from"), ...side(after[key], "to") });
+      }
+    } else if (has) push({ key, op: "added", ...side(after[key], "to") });
+    else push({ key, op: "removed", ...side(before[key], "from") });
+  }
+  return { shape: "object", entries, ...skipped ? { more: skipped } : {} };
+}
+function diffValues(before, after) {
+  if (Array.isArray(before) && Array.isArray(after)) {
+    const change = diffArray(before, after);
+    return change.entries?.length || change.length ? change : void 0;
+  }
+  if (isPlainObject(before) && isPlainObject(after)) {
+    const change = diffObject(before, after);
+    return change.entries?.length ? change : void 0;
+  }
+  return void 0;
+}

package/dist/diff.d.ts

@@ -0,0 +1,31 @@
+export type ChangeOp = 'added' | 'removed' | 'changed';
+export interface ChangeEntry {
+    /** An array index as a string, or an object key. */
+    readonly key: string;
+    readonly op: ChangeOp;
+    /** Formatted, and short: a diff is a list, not a document. */
+    readonly from?: string;
+    readonly to?: string;
+    /**
+     * The two sides as JSON, for showing an object as an object and for copying it. Per entry,
+     * so the cost is one row rather than the whole value. Absent for a cycle, a function, a dom
+     * node, or anything over the cap.
+     */
+    readonly fromJson?: string;
+    readonly toJson?: string;
+}
+export interface ValueChange {
+    /** How to read `entries`: positions for an array, keys for an object, neither for a value. */
+    readonly shape: 'value' | 'array' | 'object';
+    readonly entries?: ChangeEntry[];
+    /** Set when the diff had to stop early, so a reader knows the list is not the whole of it. */
+    readonly more?: number;
+    /** Array only, and worth saying on its own: a list that grew or shrank. */
+    readonly length?: {
+        readonly from: number;
+        readonly to: number;
+    };
+}
+/** A plain value is its own diff: the entry already carries both sides. */
+export declare function diffValues(before: unknown, after: unknown): ValueChange | undefined;
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACjC,8FAA8F;IAC9F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAClE;AAyHD,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAUnF"}

package/dist/diff.js

@@ -0,0 +1,132 @@
+// What changed, rather than what the value is now.
+//
+// `todos [{…}] → [{…}, {…}]` says nothing the graph did not. "One row added at index 2, here
+// it is" does. Computed at the write, while both sides are still in hand — afterwards only
+// the new value exists.
+import { formatValue } from './format.js';
+/** Enough to see what happened, few enough that a write stays cheap. */
+const MAX_ENTRIES = 24;
+/** Per side of one entry. A row of a list, not the whole row's contents. */
+const ENTRY_VALUE = 120;
+/** Past this an entry is a document rather than a row, and not worth carrying per write. */
+const ENTRY_JSON = 4000;
+const show = (value) => formatValue(value, ENTRY_VALUE);
+/** Structure only: `show` already gives the whole of a number, and a second copy of `3` helps nobody. */
+function json(value) {
+    if (value === null || typeof value !== 'object')
+        return undefined;
+    try {
+        const text = JSON.stringify(value);
+        return text && text.length <= ENTRY_JSON ? text : undefined;
+    }
+    catch {
+        // Cyclic, or a getter that threw. The formatted string still says what it is.
+        return undefined;
+    }
+}
+/** One side of an entry: what to read, and what to copy. */
+const side = (value, key) => {
+    const text = json(value);
+    return { [key]: show(value), ...(text ? { [`${key}Json`]: text } : {}) };
+};
+const isPlainObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/**
+ * Reference first: a store hands back the same proxy for an unchanged row, so an append costs
+ * one comparison each. The shallow fallback catches rows rebuilt with the same contents.
+ */
+function same(a, b) {
+    if (Object.is(a, b))
+        return true;
+    if (typeof a !== 'object' || typeof b !== 'object' || a === null || b === null)
+        return false;
+    if (Array.isArray(a) !== Array.isArray(b))
+        return false;
+    const ka = Object.keys(a);
+    const kb = Object.keys(b);
+    if (ka.length !== kb.length)
+        return false;
+    return ka.every((k) => Object.is(a[k], b[k]));
+}
+/**
+ * Ends trimmed first. Index-against-index reports every row after an insertion as changed,
+ * which is true of the positions and useless to whoever added one row.
+ */
+function diffArray(before, after) {
+    let head = 0;
+    while (head < before.length && head < after.length && same(before[head], after[head]))
+        head++;
+    let tail = 0;
+    while (tail < before.length - head &&
+        tail < after.length - head &&
+        same(before[before.length - 1 - tail], after[after.length - 1 - tail])) {
+        tail++;
+    }
+    const entries = [];
+    let skipped = 0;
+    const push = (entry) => {
+        if (entries.length < MAX_ENTRIES)
+            entries.push(entry);
+        else
+            skipped++;
+    };
+    const removedCount = before.length - head - tail;
+    const addedCount = after.length - head - tail;
+    const overlap = Math.min(removedCount, addedCount);
+    // The overlap is a replacement in place; the remainder is the insertion or deletion.
+    for (let i = 0; i < overlap; i++) {
+        push({
+            key: String(head + i),
+            op: 'changed',
+            ...side(before[head + i], 'from'),
+            ...side(after[head + i], 'to'),
+        });
+    }
+    for (let i = overlap; i < addedCount; i++) {
+        push({ key: String(head + i), op: 'added', ...side(after[head + i], 'to') });
+    }
+    for (let i = overlap; i < removedCount; i++) {
+        push({ key: String(head + i), op: 'removed', ...side(before[head + i], 'from') });
+    }
+    return {
+        shape: 'array',
+        entries,
+        ...(skipped ? { more: skipped } : {}),
+        ...(before.length !== after.length ? { length: { from: before.length, to: after.length } } : {}),
+    };
+}
+function diffObject(before, after) {
+    const entries = [];
+    let skipped = 0;
+    const push = (entry) => {
+        if (entries.length < MAX_ENTRIES)
+            entries.push(entry);
+        else
+            skipped++;
+    };
+    for (const key of new Set([...Object.keys(before), ...Object.keys(after)])) {
+        const had = key in before;
+        const has = key in after;
+        if (had && has) {
+            if (!same(before[key], after[key])) {
+                push({ key, op: 'changed', ...side(before[key], 'from'), ...side(after[key], 'to') });
+            }
+        }
+        else if (has)
+            push({ key, op: 'added', ...side(after[key], 'to') });
+        else
+            push({ key, op: 'removed', ...side(before[key], 'from') });
+    }
+    return { shape: 'object', entries, ...(skipped ? { more: skipped } : {}) };
+}
+/** A plain value is its own diff: the entry already carries both sides. */
+export function diffValues(before, after) {
+    if (Array.isArray(before) && Array.isArray(after)) {
+        const change = diffArray(before, after);
+        return change.entries?.length || change.length ? change : undefined;
+    }
+    if (isPlainObject(before) && isPlainObject(after)) {
+        const change = diffObject(before, after);
+        return change.entries?.length ? change : undefined;
+    }
+    return undefined;
+}