@ai-matrx/kit 0.5.0

package/dist/invalidation.cjs

@@ -0,0 +1,64 @@
+"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/invalidation.ts
+var invalidation_exports = {};
+__export(invalidation_exports, {
+  fireInvalidation: () => fireInvalidation,
+  registerInvalidationCallback: () => registerInvalidationCallback
+});
+module.exports = __toCommonJS(invalidation_exports);
+var STATE_SLOT = /* @__PURE__ */ Symbol.for("ai-matrx.kit.invalidation-registry");
+function getCallbacks() {
+  const holder = globalThis;
+  let state = holder[STATE_SLOT];
+  if (!state) {
+    state = /* @__PURE__ */ new Map();
+    holder[STATE_SLOT] = state;
+  }
+  return state;
+}
+function registerInvalidationCallback(name, callback) {
+  const callbacks = getCallbacks();
+  let set = callbacks.get(name);
+  if (!set) {
+    set = /* @__PURE__ */ new Set();
+    callbacks.set(name, set);
+  }
+  set.add(callback);
+  return () => {
+    set.delete(callback);
+  };
+}
+function fireInvalidation(name, detail) {
+  const set = getCallbacks().get(name);
+  if (!set || set.size === 0) return false;
+  for (const callback of set) {
+    try {
+      callback(detail);
+    } catch (error) {
+      console.error(
+        `[invalidation-registry] callback for "${name}" threw`,
+        error
+      );
+    }
+  }
+  return true;
+}
+//# sourceMappingURL=invalidation.cjs.map

package/dist/invalidation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/invalidation.ts"],"sourcesContent":["/**\n * @ai-matrx/kit/invalidation — a tiny name-keyed callback registry that lets a\n * UBIQUITOUS module (a stream processor, an effect runner) trigger cache\n * invalidation inside a HEAVY chunk cluster with ZERO import edge between them.\n *\n * WHY THIS EXISTS (the fragmentation-law incident): a module statically\n * reachable from ~every route context reached a heavy registry cluster with an\n * `await import()` — one line that added +14 GB peak build RSS / +50% compile\n * time and OOM-killed 12 straight production builds. The sanctioned shape is\n * the INVERSION implemented here: the heavy cluster registers a callback at\n * its own module init (it is always initialized wherever its output can\n * render — if the chunk never loaded, nothing stale is mounted), and the\n * ubiquitous module fires the callback by NAME. The only shared code is this\n * module, which imports nothing.\n *\n * RULES:\n *  - This module must NEVER grow an import. It is in every chunk that touches\n *    it; any dependency it gains is multiplied across all of them.\n *  - Firing an unregistered name is a NO-OP by design, not an error — the\n *    consumer chunk simply isn't loaded in this tab, so there is nothing\n *    stale to invalidate.\n *  - Callbacks never break the caller: each runs in its own try/catch and\n *    screams to the console on failure.\n *  - Key constants live in the HOST app (one shared constants module per app),\n *    so producer and consumer agree on the name without importing each other.\n *    The registry itself is generic over names — app-specific keys never move\n *    into this package.\n *\n * Ported from matrx-frontend `lib/invalidation/invalidation-registry.ts`, with\n * ONE structural inversion: the callback map lives on `globalThis` under a\n * `Symbol.for` slot instead of a module-level variable. With the package built\n * `splitting: false` in dual ESM/CJS format, this module is duplicated into\n * the root bundle and the `./invalidation` bundle, and CJS/ESM each\n * instantiate their own module graph — a module-level Map would silently split\n * the producers from the consumers (the same hazard the confirm opener\n * documents). Behavior is unchanged; never \"clean this up\" into a module\n * local.\n */\n\nexport type InvalidationCallback = (detail?: unknown) => void;\n\nconst STATE_SLOT = Symbol.for(\"ai-matrx.kit.invalidation-registry\");\n\ntype RegistryState = Map<string, Set<InvalidationCallback>>;\n\nfunction getCallbacks(): RegistryState {\n  const holder = globalThis as Record<symbol, RegistryState | undefined>;\n  let state = holder[STATE_SLOT];\n  if (!state) {\n    state = new Map();\n    holder[STATE_SLOT] = state;\n  }\n  return state;\n}\n\n/**\n * Register a callback for a name. Idempotent-friendly: returns the\n * unsubscribe. Module-scope registration in the consumer chunk is the\n * intended pattern (register once per chunk load, never unsubscribe).\n */\nexport function registerInvalidationCallback(\n  name: string,\n  callback: InvalidationCallback,\n): () => void {\n  const callbacks = getCallbacks();\n  let set = callbacks.get(name);\n  if (!set) {\n    set = new Set();\n    callbacks.set(name, set);\n  }\n  set.add(callback);\n  return () => {\n    set.delete(callback);\n  };\n}\n\n/**\n * Fire every callback registered under `name`. Returns true when at least one\n * callback ran. Never throws — a failing callback screams and the rest run.\n */\nexport function fireInvalidation(name: string, detail?: unknown): boolean {\n  const set = getCallbacks().get(name);\n  if (!set || set.size === 0) return false;\n  for (const callback of set) {\n    try {\n      callback(detail);\n    } catch (error) {\n      console.error(\n        `[invalidation-registry] callback for \"${name}\" threw`,\n        error,\n      );\n    }\n  }\n  return true;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAyCA,IAAM,aAAa,uBAAO,IAAI,oCAAoC;AAIlE,SAAS,eAA8B;AACrC,QAAM,SAAS;AACf,MAAI,QAAQ,OAAO,UAAU;AAC7B,MAAI,CAAC,OAAO;AACV,YAAQ,oBAAI,IAAI;AAChB,WAAO,UAAU,IAAI;AAAA,EACvB;AACA,SAAO;AACT;AAOO,SAAS,6BACd,MACA,UACY;AACZ,QAAM,YAAY,aAAa;AAC/B,MAAI,MAAM,UAAU,IAAI,IAAI;AAC5B,MAAI,CAAC,KAAK;AACR,UAAM,oBAAI,IAAI;AACd,cAAU,IAAI,MAAM,GAAG;AAAA,EACzB;AACA,MAAI,IAAI,QAAQ;AAChB,SAAO,MAAM;AACX,QAAI,OAAO,QAAQ;AAAA,EACrB;AACF;AAMO,SAAS,iBAAiB,MAAc,QAA2B;AACxE,QAAM,MAAM,aAAa,EAAE,IAAI,IAAI;AACnC,MAAI,CAAC,OAAO,IAAI,SAAS,EAAG,QAAO;AACnC,aAAW,YAAY,KAAK;AAC1B,QAAI;AACF,eAAS,MAAM;AAAA,IACjB,SAAS,OAAO;AACd,cAAQ;AAAA,QACN,yCAAyC,IAAI;AAAA,QAC7C;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;","names":[]}

package/dist/invalidation.d.cts

@@ -0,0 +1,52 @@
+/**
+ * @ai-matrx/kit/invalidation — a tiny name-keyed callback registry that lets a
+ * UBIQUITOUS module (a stream processor, an effect runner) trigger cache
+ * invalidation inside a HEAVY chunk cluster with ZERO import edge between them.
+ *
+ * WHY THIS EXISTS (the fragmentation-law incident): a module statically
+ * reachable from ~every route context reached a heavy registry cluster with an
+ * `await import()` — one line that added +14 GB peak build RSS / +50% compile
+ * time and OOM-killed 12 straight production builds. The sanctioned shape is
+ * the INVERSION implemented here: the heavy cluster registers a callback at
+ * its own module init (it is always initialized wherever its output can
+ * render — if the chunk never loaded, nothing stale is mounted), and the
+ * ubiquitous module fires the callback by NAME. The only shared code is this
+ * module, which imports nothing.
+ *
+ * RULES:
+ *  - This module must NEVER grow an import. It is in every chunk that touches
+ *    it; any dependency it gains is multiplied across all of them.
+ *  - Firing an unregistered name is a NO-OP by design, not an error — the
+ *    consumer chunk simply isn't loaded in this tab, so there is nothing
+ *    stale to invalidate.
+ *  - Callbacks never break the caller: each runs in its own try/catch and
+ *    screams to the console on failure.
+ *  - Key constants live in the HOST app (one shared constants module per app),
+ *    so producer and consumer agree on the name without importing each other.
+ *    The registry itself is generic over names — app-specific keys never move
+ *    into this package.
+ *
+ * Ported from matrx-frontend `lib/invalidation/invalidation-registry.ts`, with
+ * ONE structural inversion: the callback map lives on `globalThis` under a
+ * `Symbol.for` slot instead of a module-level variable. With the package built
+ * `splitting: false` in dual ESM/CJS format, this module is duplicated into
+ * the root bundle and the `./invalidation` bundle, and CJS/ESM each
+ * instantiate their own module graph — a module-level Map would silently split
+ * the producers from the consumers (the same hazard the confirm opener
+ * documents). Behavior is unchanged; never "clean this up" into a module
+ * local.
+ */
+type InvalidationCallback = (detail?: unknown) => void;
+/**
+ * Register a callback for a name. Idempotent-friendly: returns the
+ * unsubscribe. Module-scope registration in the consumer chunk is the
+ * intended pattern (register once per chunk load, never unsubscribe).
+ */
+declare function registerInvalidationCallback(name: string, callback: InvalidationCallback): () => void;
+/**
+ * Fire every callback registered under `name`. Returns true when at least one
+ * callback ran. Never throws — a failing callback screams and the rest run.
+ */
+declare function fireInvalidation(name: string, detail?: unknown): boolean;
+
+export { type InvalidationCallback, fireInvalidation, registerInvalidationCallback };

package/dist/invalidation.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @ai-matrx/kit/invalidation — a tiny name-keyed callback registry that lets a
+ * UBIQUITOUS module (a stream processor, an effect runner) trigger cache
+ * invalidation inside a HEAVY chunk cluster with ZERO import edge between them.
+ *
+ * WHY THIS EXISTS (the fragmentation-law incident): a module statically
+ * reachable from ~every route context reached a heavy registry cluster with an
+ * `await import()` — one line that added +14 GB peak build RSS / +50% compile
+ * time and OOM-killed 12 straight production builds. The sanctioned shape is
+ * the INVERSION implemented here: the heavy cluster registers a callback at
+ * its own module init (it is always initialized wherever its output can
+ * render — if the chunk never loaded, nothing stale is mounted), and the
+ * ubiquitous module fires the callback by NAME. The only shared code is this
+ * module, which imports nothing.
+ *
+ * RULES:
+ *  - This module must NEVER grow an import. It is in every chunk that touches
+ *    it; any dependency it gains is multiplied across all of them.
+ *  - Firing an unregistered name is a NO-OP by design, not an error — the
+ *    consumer chunk simply isn't loaded in this tab, so there is nothing
+ *    stale to invalidate.
+ *  - Callbacks never break the caller: each runs in its own try/catch and
+ *    screams to the console on failure.
+ *  - Key constants live in the HOST app (one shared constants module per app),
+ *    so producer and consumer agree on the name without importing each other.
+ *    The registry itself is generic over names — app-specific keys never move
+ *    into this package.
+ *
+ * Ported from matrx-frontend `lib/invalidation/invalidation-registry.ts`, with
+ * ONE structural inversion: the callback map lives on `globalThis` under a
+ * `Symbol.for` slot instead of a module-level variable. With the package built
+ * `splitting: false` in dual ESM/CJS format, this module is duplicated into
+ * the root bundle and the `./invalidation` bundle, and CJS/ESM each
+ * instantiate their own module graph — a module-level Map would silently split
+ * the producers from the consumers (the same hazard the confirm opener
+ * documents). Behavior is unchanged; never "clean this up" into a module
+ * local.
+ */
+type InvalidationCallback = (detail?: unknown) => void;
+/**
+ * Register a callback for a name. Idempotent-friendly: returns the
+ * unsubscribe. Module-scope registration in the consumer chunk is the
+ * intended pattern (register once per chunk load, never unsubscribe).
+ */
+declare function registerInvalidationCallback(name: string, callback: InvalidationCallback): () => void;
+/**
+ * Fire every callback registered under `name`. Returns true when at least one
+ * callback ran. Never throws — a failing callback screams and the rest run.
+ */
+declare function fireInvalidation(name: string, detail?: unknown): boolean;
+
+export { type InvalidationCallback, fireInvalidation, registerInvalidationCallback };

package/dist/invalidation.js

@@ -0,0 +1,43 @@
+// src/invalidation.ts
+var STATE_SLOT = /* @__PURE__ */ Symbol.for("ai-matrx.kit.invalidation-registry");
+function getCallbacks() {
+  const holder = globalThis;
+  let state = holder[STATE_SLOT];
+  if (!state) {
+    state = /* @__PURE__ */ new Map();
+    holder[STATE_SLOT] = state;
+  }
+  return state;
+}
+function registerInvalidationCallback(name, callback) {
+  const callbacks = getCallbacks();
+  let set = callbacks.get(name);
+  if (!set) {
+    set = /* @__PURE__ */ new Set();
+    callbacks.set(name, set);
+  }
+  set.add(callback);
+  return () => {
+    set.delete(callback);
+  };
+}
+function fireInvalidation(name, detail) {
+  const set = getCallbacks().get(name);
+  if (!set || set.size === 0) return false;
+  for (const callback of set) {
+    try {
+      callback(detail);
+    } catch (error) {
+      console.error(
+        `[invalidation-registry] callback for "${name}" threw`,
+        error
+      );
+    }
+  }
+  return true;
+}
+export {
+  fireInvalidation,
+  registerInvalidationCallback
+};
+//# sourceMappingURL=invalidation.js.map

package/dist/invalidation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/invalidation.ts"],"sourcesContent":["/**\n * @ai-matrx/kit/invalidation — a tiny name-keyed callback registry that lets a\n * UBIQUITOUS module (a stream processor, an effect runner) trigger cache\n * invalidation inside a HEAVY chunk cluster with ZERO import edge between them.\n *\n * WHY THIS EXISTS (the fragmentation-law incident): a module statically\n * reachable from ~every route context reached a heavy registry cluster with an\n * `await import()` — one line that added +14 GB peak build RSS / +50% compile\n * time and OOM-killed 12 straight production builds. The sanctioned shape is\n * the INVERSION implemented here: the heavy cluster registers a callback at\n * its own module init (it is always initialized wherever its output can\n * render — if the chunk never loaded, nothing stale is mounted), and the\n * ubiquitous module fires the callback by NAME. The only shared code is this\n * module, which imports nothing.\n *\n * RULES:\n *  - This module must NEVER grow an import. It is in every chunk that touches\n *    it; any dependency it gains is multiplied across all of them.\n *  - Firing an unregistered name is a NO-OP by design, not an error — the\n *    consumer chunk simply isn't loaded in this tab, so there is nothing\n *    stale to invalidate.\n *  - Callbacks never break the caller: each runs in its own try/catch and\n *    screams to the console on failure.\n *  - Key constants live in the HOST app (one shared constants module per app),\n *    so producer and consumer agree on the name without importing each other.\n *    The registry itself is generic over names — app-specific keys never move\n *    into this package.\n *\n * Ported from matrx-frontend `lib/invalidation/invalidation-registry.ts`, with\n * ONE structural inversion: the callback map lives on `globalThis` under a\n * `Symbol.for` slot instead of a module-level variable. With the package built\n * `splitting: false` in dual ESM/CJS format, this module is duplicated into\n * the root bundle and the `./invalidation` bundle, and CJS/ESM each\n * instantiate their own module graph — a module-level Map would silently split\n * the producers from the consumers (the same hazard the confirm opener\n * documents). Behavior is unchanged; never \"clean this up\" into a module\n * local.\n */\n\nexport type InvalidationCallback = (detail?: unknown) => void;\n\nconst STATE_SLOT = Symbol.for(\"ai-matrx.kit.invalidation-registry\");\n\ntype RegistryState = Map<string, Set<InvalidationCallback>>;\n\nfunction getCallbacks(): RegistryState {\n  const holder = globalThis as Record<symbol, RegistryState | undefined>;\n  let state = holder[STATE_SLOT];\n  if (!state) {\n    state = new Map();\n    holder[STATE_SLOT] = state;\n  }\n  return state;\n}\n\n/**\n * Register a callback for a name. Idempotent-friendly: returns the\n * unsubscribe. Module-scope registration in the consumer chunk is the\n * intended pattern (register once per chunk load, never unsubscribe).\n */\nexport function registerInvalidationCallback(\n  name: string,\n  callback: InvalidationCallback,\n): () => void {\n  const callbacks = getCallbacks();\n  let set = callbacks.get(name);\n  if (!set) {\n    set = new Set();\n    callbacks.set(name, set);\n  }\n  set.add(callback);\n  return () => {\n    set.delete(callback);\n  };\n}\n\n/**\n * Fire every callback registered under `name`. Returns true when at least one\n * callback ran. Never throws — a failing callback screams and the rest run.\n */\nexport function fireInvalidation(name: string, detail?: unknown): boolean {\n  const set = getCallbacks().get(name);\n  if (!set || set.size === 0) return false;\n  for (const callback of set) {\n    try {\n      callback(detail);\n    } catch (error) {\n      console.error(\n        `[invalidation-registry] callback for \"${name}\" threw`,\n        error,\n      );\n    }\n  }\n  return true;\n}\n"],"mappings":";AAyCA,IAAM,aAAa,uBAAO,IAAI,oCAAoC;AAIlE,SAAS,eAA8B;AACrC,QAAM,SAAS;AACf,MAAI,QAAQ,OAAO,UAAU;AAC7B,MAAI,CAAC,OAAO;AACV,YAAQ,oBAAI,IAAI;AAChB,WAAO,UAAU,IAAI;AAAA,EACvB;AACA,SAAO;AACT;AAOO,SAAS,6BACd,MACA,UACY;AACZ,QAAM,YAAY,aAAa;AAC/B,MAAI,MAAM,UAAU,IAAI,IAAI;AAC5B,MAAI,CAAC,KAAK;AACR,UAAM,oBAAI,IAAI;AACd,cAAU,IAAI,MAAM,GAAG;AAAA,EACzB;AACA,MAAI,IAAI,QAAQ;AAChB,SAAO,MAAM;AACX,QAAI,OAAO,QAAQ;AAAA,EACrB;AACF;AAMO,SAAS,iBAAiB,MAAc,QAA2B;AACxE,QAAM,MAAM,aAAa,EAAE,IAAI,IAAI;AACnC,MAAI,CAAC,OAAO,IAAI,SAAS,EAAG,QAAO;AACnC,aAAW,YAAY,KAAK;AAC1B,QAAI;AACF,eAAS,MAAM;AAAA,IACjB,SAAS,OAAO;AACd,cAAQ;AAAA,QACN,yCAAyC,IAAI;AAAA,QAC7C;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;","names":[]}

package/dist/json-format.cjs

@@ -0,0 +1,319 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/json-format.ts
+var json_format_exports = {};
+__export(json_format_exports, {
+  DEFAULT_JSON_INDENT: () => DEFAULT_JSON_INDENT,
+  DEFAULT_JSON_WIDTH: () => DEFAULT_JSON_WIDTH,
+  detectJson: () => detectJson,
+  formatJsonText: () => formatJsonText,
+  isJsonArray: () => isJsonArray,
+  isJsonObject: () => isJsonObject,
+  isJsonPrimitive: () => isJsonPrimitive,
+  stringifyJson: () => stringifyJson
+});
+module.exports = __toCommonJS(json_format_exports);
+
+// src/json-format/detect.ts
+var import_json5 = __toESM(require("json5"), 1);
+var FENCE_OPEN = /^([ \t]*)(`{3,}|~{3,})[ \t]*([^\s`~]*)[ \t]*$/;
+var JSON_FENCE_LANGS = /* @__PURE__ */ new Set(["json", "jsonc", "json5", "geojson", "jsonl"]);
+function splitFence(text) {
+  const lines = text.split("\n");
+  const openIdx = lines.findIndex((l) => FENCE_OPEN.test(l));
+  if (openIdx === -1) return null;
+  const open = FENCE_OPEN.exec(lines[openIdx] ?? "");
+  if (!open) return null;
+  const [, indent = "", marker = "```", lang = ""] = open;
+  const fenceChar = marker[0] ?? "`";
+  const closeRe = new RegExp(`^[ \\t]*\\${fenceChar}{${marker.length},}[ \\t]*$`);
+  let closeIdx = -1;
+  for (let i = openIdx + 1; i < lines.length; i++) {
+    if (closeRe.test(lines[i] ?? "")) {
+      closeIdx = i;
+      break;
+    }
+  }
+  const afterClose = closeIdx === -1 ? [] : lines.slice(closeIdx + 1);
+  if (afterClose.some((l) => FENCE_OPEN.test(l))) return null;
+  const bodyEnd = closeIdx === -1 ? lines.length : closeIdx;
+  return {
+    leading: openIdx > 0 ? `${lines.slice(0, openIdx).join("\n")}
+` : "",
+    payload: lines.slice(openIdx + 1, bodyEnd).join("\n"),
+    trailing: afterClose.length > 0 ? `
+${afterClose.join("\n")}` : "",
+    fence: {
+      marker,
+      lang: lang.toLowerCase(),
+      indent,
+      closed: closeIdx !== -1
+    }
+  };
+}
+function splitBare(text) {
+  const payload = text.trim();
+  if (payload === "") {
+    return { leading: text, payload: "", trailing: "", fence: null };
+  }
+  const start = text.indexOf(payload);
+  return {
+    leading: text.slice(0, start),
+    payload,
+    trailing: text.slice(start + payload.length),
+    fence: null
+  };
+}
+function rootKindOf(value) {
+  if (Array.isArray(value)) return "array";
+  if (typeof value === "object" && value !== null) return "object";
+  return "scalar";
+}
+function isBracketShaped(payload) {
+  const first = payload[0];
+  const last = payload[payload.length - 1];
+  if (payload.length < 2) return false;
+  return first === "{" && last === "}" || first === "[" && last === "]";
+}
+function errorMessage(err) {
+  return err instanceof Error ? err.message : "Invalid JSON";
+}
+function countLines(s) {
+  if (s === "") return 0;
+  let n = 1;
+  for (let i = 0; i < s.length; i++) if (s[i] === "\n") n++;
+  return n;
+}
+function detectJson(text) {
+  const split = splitFence(text) ?? splitBare(text);
+  const payload = split.fence ? split.payload.trim() : split.payload;
+  const fenceSaysJson = split.fence !== null && (split.fence.lang === "" || JSON_FENCE_LANGS.has(split.fence.lang));
+  const base = {
+    fence: split.fence,
+    leading: split.leading,
+    trailing: split.trailing,
+    payload,
+    lineCount: countLines(payload),
+    charCount: payload.length
+  };
+  if (payload === "") {
+    return { ...base, ok: false, looksLikeJson: false };
+  }
+  if (split.fence !== null && !fenceSaysJson) {
+    return { ...base, ok: false, looksLikeJson: false };
+  }
+  const shaped = isBracketShaped(payload);
+  let value;
+  let parser;
+  let error;
+  try {
+    value = JSON.parse(payload);
+    parser = "strict";
+  } catch (strictErr) {
+    try {
+      value = import_json5.default.parse(payload);
+      parser = "tolerant";
+    } catch {
+      error = errorMessage(strictErr);
+    }
+  }
+  if (value === void 0 || parser === void 0) {
+    return { ...base, ok: false, looksLikeJson: shaped, error };
+  }
+  const root = rootKindOf(value);
+  const worthOffering = root !== "scalar" || fenceSaysJson;
+  return { ...base, ok: true, looksLikeJson: worthOffering, value, parser, root };
+}
+
+// src/json-format/json-value.ts
+function isJsonObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isJsonArray(value) {
+  return Array.isArray(value);
+}
+function isJsonPrimitive(value) {
+  return value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+}
+
+// src/json-format/format.ts
+var DEFAULT_JSON_INDENT = 2;
+var DEFAULT_JSON_WIDTH = 100;
+function orderedKeys(obj, sortKeys) {
+  const keys = Object.keys(obj).filter((k) => obj[k] !== void 0);
+  return sortKeys ? [...keys].sort((a, b) => a.localeCompare(b)) : keys;
+}
+function writeScalar(value) {
+  return JSON.stringify(value) ?? "null";
+}
+function flatten(value, cfg) {
+  if (isJsonArray(value)) {
+    if (value.length === 0) return "[]";
+    const parts = value.map((v) => flatten(v ?? null, cfg));
+    return cfg.spaced ? `[${parts.join(", ")}]` : `[${parts.join(",")}]`;
+  }
+  if (isJsonObject(value)) {
+    const keys = orderedKeys(value, cfg.sortKeys);
+    if (keys.length === 0) return "{}";
+    const colon = cfg.spaced ? ": " : ":";
+    const parts = keys.map(
+      (k) => `${JSON.stringify(k)}${colon}${flatten(value[k] ?? null, cfg)}`
+    );
+    return cfg.spaced ? `{ ${parts.join(", ")} }` : `{${parts.join(",")}}`;
+  }
+  return writeScalar(value);
+}
+function layoutEntries(entries, pad, cfg) {
+  if (!cfg.pack) return entries.map((e) => pad + e);
+  const lines = [];
+  let current = "";
+  for (let i = 0; i < entries.length; i++) {
+    const entry = entries[i] ?? "";
+    const isLast = i === entries.length - 1;
+    const piece = isLast ? entry : `${entry},`;
+    if (entry.includes("\n")) {
+      if (current !== "") {
+        lines.push(pad + current);
+        current = "";
+      }
+      lines.push(pad + piece);
+      continue;
+    }
+    if (current === "") {
+      current = piece;
+      continue;
+    }
+    const merged = `${current} ${piece}`;
+    if (pad.length + merged.length <= cfg.width) {
+      current = merged;
+    } else {
+      lines.push(pad + current);
+      current = piece;
+    }
+  }
+  if (current !== "") lines.push(pad + current);
+  return lines;
+}
+function renderNode(value, level, used, cfg) {
+  const isContainer = isJsonArray(value) || isJsonObject(value);
+  if (!isContainer) return writeScalar(value);
+  const flat = flatten(value, cfg);
+  if (flat === "[]" || flat === "{}") return flat;
+  if (cfg.width >= 0 && used + flat.length <= cfg.width) return flat;
+  const pad = " ".repeat((level + 1) * cfg.indent);
+  const closePad = " ".repeat(level * cfg.indent);
+  if (isJsonArray(value)) {
+    const entries2 = value.map(
+      (v) => renderNode(v ?? null, level + 1, pad.length, cfg)
+    );
+    const body2 = layoutEntries(entries2, pad, cfg);
+    const joined2 = cfg.pack ? body2.join("\n") : body2.join(",\n");
+    return `[
+${joined2}
+${closePad}]`;
+  }
+  const keys = orderedKeys(value, cfg.sortKeys);
+  const entries = keys.map((k) => {
+    const prefix = `${JSON.stringify(k)}: `;
+    const rendered = renderNode(
+      value[k] ?? null,
+      level + 1,
+      pad.length + prefix.length,
+      cfg
+    );
+    return prefix + rendered;
+  });
+  const body = layoutEntries(entries, pad, cfg);
+  const joined = cfg.pack ? body.join("\n") : body.join(",\n");
+  return `{
+${joined}
+${closePad}}`;
+}
+function stringifyJson(value, options) {
+  const indent = options.indent ?? DEFAULT_JSON_INDENT;
+  const sortKeys = options.sortKeys ?? false;
+  if (options.style === "minify") {
+    return flatten(value, { indent, width: -1, pack: false, spaced: false, sortKeys });
+  }
+  const cfg = {
+    indent,
+    width: options.style === "pretty" ? -1 : options.width ?? DEFAULT_JSON_WIDTH,
+    pack: options.style === "compact",
+    spaced: true,
+    sortKeys
+  };
+  return renderNode(value, 0, 0, cfg);
+}
+function sizeOf(text) {
+  let lines = text === "" ? 0 : 1;
+  for (let i = 0; i < text.length; i++) if (text[i] === "\n") lines++;
+  return { lines, chars: text.length };
+}
+function reassemble(detection, payload, mode) {
+  const { fence, leading, trailing } = detection;
+  const keepFence = mode === "add" || mode === "preserve" && fence !== null;
+  if (!keepFence) {
+    return leading + payload + trailing;
+  }
+  const marker = fence?.marker ?? "```";
+  const lang = fence?.lang && fence.lang !== "" ? fence.lang : "json";
+  const indent = fence?.indent ?? "";
+  const body = indent ? payload.split("\n").map((l) => l === "" ? l : indent + l).join("\n") : payload;
+  const close = fence !== null && !fence.closed ? "" : `
+${indent}${marker}`;
+  return `${leading}${indent}${marker}${lang}
+${body}${close}${trailing}`;
+}
+function formatJsonText(text, options) {
+  const detection = detectJson(text);
+  const before = sizeOf(text);
+  if (!detection.ok || detection.value === void 0) {
+    return {
+      ok: false,
+      text,
+      error: detection.error ?? "Selection is not JSON.",
+      changed: false,
+      detection,
+      before,
+      after: before
+    };
+  }
+  const payload = stringifyJson(detection.value, options);
+  const next = reassemble(detection, payload, options.fence ?? "preserve");
+  return {
+    ok: true,
+    text: next,
+    changed: next !== text,
+    detection,
+    before,
+    after: sizeOf(next)
+  };
+}
+//# sourceMappingURL=json-format.cjs.map

package/dist/json-format.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/json-format.ts","../src/json-format/detect.ts","../src/json-format/json-value.ts","../src/json-format/format.ts"],"sourcesContent":["/**\n * @ai-matrx/kit/json-format — \"is this text JSON, and what shape should it be\n * in?\" so no surface ever hand-rolls another `JSON.stringify(v, null, 2)` /\n * \"strip the backticks\" / \"does this look like JSON\" helper.\n *\n * Two questions, two entry points:\n * - `detectJson(text)` — finds the JSON (code fences, prose around the\n *   payload, tolerant JSON5 input) and says exactly where it starts and stops.\n *   `looksLikeJson` gates OFFERING actions; `ok` gates RUNNING them.\n * - `formatJsonText(text, opts)` / `stringifyJson(value, opts)` — re-print in\n *   `minify` / `compact` (width-aware fill+pack) / `pretty`, with key sorting\n *   and fence add/strip/preserve. Everything around the payload is restored\n *   verbatim.\n *\n * Pure (no React / DOM); never throws — non-JSON comes back `ok: false` with\n * the input unchanged. Handles partial/streamed text honestly: bracket-shaped\n * text that does not (yet) parse is `looksLikeJson: true, ok: false`, and an\n * unterminated fence stays unterminated.\n *\n * Runtime dependency of this subpath (and only this subpath's bundles):\n * `json5`, for the tolerant parse tier — the JSON people paste out of logs and\n * code is frequently not legal JSON, and reporting `parser: \"tolerant\"` versus\n * hiding it is a core behavior of the unit.\n */\nexport { detectJson } from \"./json-format/detect\";\nexport {\n  DEFAULT_JSON_INDENT,\n  DEFAULT_JSON_WIDTH,\n  formatJsonText,\n  stringifyJson,\n} from \"./json-format/format\";\nexport type {\n  JsonDetection,\n  JsonFence,\n  JsonFenceMode,\n  JsonFormatOptions,\n  JsonFormatResult,\n  JsonFormatStyle,\n  JsonParser,\n  JsonRootKind,\n  JsonTextSize,\n} from \"./json-format/types\";\nexport {\n  isJsonArray,\n  isJsonObject,\n  isJsonPrimitive,\n} from \"./json-format/json-value\";\nexport type {\n  JsonArray,\n  JsonObject,\n  JsonPrimitive,\n  JsonValue,\n} from \"./json-format/json-value\";\n","// json-format/detect.ts\n//\n// \"Is this text JSON, and where exactly does the JSON start and stop?\"\n//\n// The answer has to survive real-world selections: a fenced ```json block, a\n// bare pasted object, an object with a stray blank line above it, a fence the\n// user only half-selected. So detection splits the text into three parts —\n// leading / payload / trailing — and only the payload is ever re-formatted.\n// Everything outside it is restored verbatim, because a formatter that eats\n// the prose around the JSON is worse than no formatter at all.\n//\n// Two parse tiers: `JSON.parse` first (strict — what the value really is), then\n// JSON5 (tolerant — trailing commas, comments, unquoted keys, single quotes),\n// because the JSON people paste out of logs and code is frequently not legal\n// JSON. Tolerant parsing is reported, never hidden: a consumer that re-emits a\n// tolerantly-parsed value is normalizing it, and the caller can say so.\n//\n// Pure: no React / DOM. Never throws.\n//\n// Ported verbatim from matrx-frontend `lib/json-format/detect.ts`.\n\nimport JSON5 from \"json5\";\nimport type { JsonValue } from \"./json-value\";\nimport type {\n  JsonDetection,\n  JsonFence,\n  JsonParser,\n  JsonRootKind,\n} from \"./types\";\n\n/** Opening fence line: optional indent, 3+ backticks or tildes, optional info. */\nconst FENCE_OPEN = /^([ \\t]*)(`{3,}|~{3,})[ \\t]*([^\\s`~]*)[ \\t]*$/;\n\n/** Languages we treat as \"this fence contains JSON\". */\nconst JSON_FENCE_LANGS = new Set([\"json\", \"jsonc\", \"json5\", \"geojson\", \"jsonl\"]);\n\ninterface Split {\n  leading: string;\n  payload: string;\n  trailing: string;\n  fence: JsonFence | null;\n}\n\n/** Peel a markdown code fence off the text, if the text IS a fenced block. */\nfunction splitFence(text: string): Split | null {\n  const lines = text.split(\"\\n\");\n\n  // The fence may sit anywhere in the selection (a user highlighting a block\n  // plus the sentence above it is the common case) — but there must be exactly\n  // ONE block. Two fenced blocks in one selection is not a single JSON payload,\n  // and spanning them would splice unrelated content together.\n  const openIdx = lines.findIndex((l) => FENCE_OPEN.test(l));\n  if (openIdx === -1) return null;\n\n  const open = FENCE_OPEN.exec(lines[openIdx] ?? \"\");\n  if (!open) return null;\n  const [, indent = \"\", marker = \"```\", lang = \"\"] = open;\n  const fenceChar = marker[0] ?? \"`\";\n  const closeRe = new RegExp(`^[ \\\\t]*\\\\${fenceChar}{${marker.length},}[ \\\\t]*$`);\n\n  let closeIdx = -1;\n  for (let i = openIdx + 1; i < lines.length; i++) {\n    if (closeRe.test(lines[i] ?? \"\")) {\n      closeIdx = i;\n      break;\n    }\n  }\n\n  const afterClose = closeIdx === -1 ? [] : lines.slice(closeIdx + 1);\n  if (afterClose.some((l) => FENCE_OPEN.test(l))) return null;\n\n  const bodyEnd = closeIdx === -1 ? lines.length : closeIdx;\n  // The line separators bordering the fence belong to leading/trailing, so\n  // reassembly is a plain concatenation and blank lines survive it.\n  return {\n    leading: openIdx > 0 ? `${lines.slice(0, openIdx).join(\"\\n\")}\\n` : \"\",\n    payload: lines.slice(openIdx + 1, bodyEnd).join(\"\\n\"),\n    trailing: afterClose.length > 0 ? `\\n${afterClose.join(\"\\n\")}` : \"\",\n    fence: {\n      marker,\n      lang: lang.toLowerCase(),\n      indent,\n      closed: closeIdx !== -1,\n    },\n  };\n}\n\n/** Split bare (unfenced) text into surrounding whitespace + payload. */\nfunction splitBare(text: string): Split {\n  const payload = text.trim();\n  if (payload === \"\") {\n    return { leading: text, payload: \"\", trailing: \"\", fence: null };\n  }\n  const start = text.indexOf(payload);\n  return {\n    leading: text.slice(0, start),\n    payload,\n    trailing: text.slice(start + payload.length),\n    fence: null,\n  };\n}\n\nfunction rootKindOf(value: JsonValue): JsonRootKind {\n  if (Array.isArray(value)) return \"array\";\n  if (typeof value === \"object\" && value !== null) return \"object\";\n  return \"scalar\";\n}\n\n/** Bracket-shaped: opens and closes with a matching container delimiter. */\nfunction isBracketShaped(payload: string): boolean {\n  const first = payload[0];\n  const last = payload[payload.length - 1];\n  if (payload.length < 2) return false;\n  return (first === \"{\" && last === \"}\") || (first === \"[\" && last === \"]\");\n}\n\nfunction errorMessage(err: unknown): string {\n  return err instanceof Error ? err.message : \"Invalid JSON\";\n}\n\nfunction countLines(s: string): number {\n  if (s === \"\") return 0;\n  let n = 1;\n  for (let i = 0; i < s.length; i++) if (s[i] === \"\\n\") n++;\n  return n;\n}\n\n/**\n * Detect JSON in `text`. Never throws; a non-JSON string comes back with\n * `ok: false` and `looksLikeJson: false`, which is the signal to offer nothing.\n */\nexport function detectJson(text: string): JsonDetection {\n  const split = splitFence(text) ?? splitBare(text);\n  // A fenced block's body still carries its own indentation/blank lines.\n  const payload = split.fence ? split.payload.trim() : split.payload;\n\n  const fenceSaysJson =\n    split.fence !== null &&\n    (split.fence.lang === \"\" || JSON_FENCE_LANGS.has(split.fence.lang));\n\n  const base = {\n    fence: split.fence,\n    leading: split.leading,\n    trailing: split.trailing,\n    payload,\n    lineCount: countLines(payload),\n    charCount: payload.length,\n  };\n\n  if (payload === \"\") {\n    return { ...base, ok: false, looksLikeJson: false };\n  }\n\n  // A fence declaring a NON-JSON language is a hard no, even if the body would\n  // parse — reformatting the inside of a ```python block is not our business.\n  if (split.fence !== null && !fenceSaysJson) {\n    return { ...base, ok: false, looksLikeJson: false };\n  }\n\n  const shaped = isBracketShaped(payload);\n\n  let value: JsonValue | undefined;\n  let parser: JsonParser | undefined;\n  let error: string | undefined;\n  try {\n    value = JSON.parse(payload) as JsonValue;\n    parser = \"strict\";\n  } catch (strictErr) {\n    try {\n      value = JSON5.parse(payload) as JsonValue;\n      parser = \"tolerant\";\n    } catch {\n      error = errorMessage(strictErr);\n    }\n  }\n\n  if (value === undefined || parser === undefined) {\n    // Unparseable. Still \"looks like JSON\" when it is bracket-shaped, so a\n    // surface can show the actions and report the parse error on click rather\n    // than pretending the selection is ordinary prose.\n    return { ...base, ok: false, looksLikeJson: shaped, error };\n  }\n\n  const root = rootKindOf(value);\n  // A bare scalar (\"hello\", 42, true) parses but is not worth offering JSON\n  // actions on — every prose word that happens to be a number would qualify.\n  const worthOffering = root !== \"scalar\" || fenceSaysJson;\n\n  return { ...base, ok: true, looksLikeJson: worthOffering, value, parser, root };\n}\n","/**\n * Canonical JSON value types + narrowing guards.\n *\n * Ported (the subset this subpath needs) from matrx-frontend `types/json.ts` —\n * the honest names for \"this is just JSON\" that are NOT `any` and NOT a bare\n * `unknown`. The package must stand alone, so the types live here; a Matrx\n * host keeps using its own `@/types/json` for app code and the two are\n * structurally identical.\n */\n\nexport type JsonPrimitive = string | number | boolean | null;\n\n/**\n * A JSON object. Values are `JsonValue | undefined` so optional keys read\n * cleanly (mirrors Supabase's original generated `Json` object member).\n */\nexport interface JsonObject {\n  [key: string]: JsonValue | undefined;\n}\n\nexport type JsonArray = JsonValue[];\n\nexport type JsonValue = JsonPrimitive | JsonObject | JsonArray;\n\n/**\n * Narrow an `unknown` (e.g. a bare JSONB column) to a `JsonObject`.\n * Plain object only — arrays and `null` return false.\n */\nexport function isJsonObject(value: unknown): value is JsonObject {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** Narrow an `unknown` to a `JsonArray`. */\nexport function isJsonArray(value: unknown): value is JsonArray {\n  return Array.isArray(value);\n}\n\n/** Narrow an `unknown` to a JSON primitive (string | number | boolean | null). */\nexport function isJsonPrimitive(value: unknown): value is JsonPrimitive {\n  return (\n    value === null ||\n    typeof value === \"string\" ||\n    typeof value === \"number\" ||\n    typeof value === \"boolean\"\n  );\n}\n","// json-format/format.ts\n//\n// The JSON writer. Three styles over one recursive printer:\n//\n//   minify  — one line, no optional whitespace.\n//   compact — width-aware FILL. Any subtree whose flat form fits the remaining\n//             columns is inlined; a subtree that does not fit expands, but its\n//             children are then PACKED onto shared lines while they fit. This\n//             is what turns an 11-line reference blob into 3 lines without\n//             turning it into an unreadable one-liner.\n//   pretty  — one entry per line (classic 2-space JSON).\n//\n// Why not `JSON.stringify(v, null, 2)`: it cannot inline, cannot pack, and\n// cannot sort keys. All three are the point.\n//\n// Pure: no React / DOM. Never throws — a parse failure comes back as a result\n// with `ok: false` and the input text unchanged.\n//\n// Ported verbatim from matrx-frontend `lib/json-format/format.ts`.\n\nimport type { JsonObject, JsonValue } from \"./json-value\";\nimport { isJsonArray, isJsonObject } from \"./json-value\";\nimport { detectJson } from \"./detect\";\nimport type {\n  JsonDetection,\n  JsonFormatOptions,\n  JsonFormatResult,\n  JsonTextSize,\n} from \"./types\";\n\nexport const DEFAULT_JSON_INDENT = 2;\nexport const DEFAULT_JSON_WIDTH = 100;\n\ninterface WriterConfig {\n  indent: number;\n  /** Target line width; `-1` disables inlining entirely (pretty). */\n  width: number;\n  /** Pack sibling entries onto shared lines (compact only). */\n  pack: boolean;\n  /** Spaces inside braces/brackets and after colons/commas. */\n  spaced: boolean;\n  sortKeys: boolean;\n}\n\nfunction orderedKeys(obj: JsonObject, sortKeys: boolean): string[] {\n  // `undefined` values are not JSON — JSON.stringify drops them, so do we.\n  const keys = Object.keys(obj).filter((k) => obj[k] !== undefined);\n  return sortKeys ? [...keys].sort((a, b) => a.localeCompare(b)) : keys;\n}\n\n/** Serialize a scalar exactly as JSON does. */\nfunction writeScalar(value: JsonValue): string {\n  // NaN / Infinity stringify to \"null\", matching JSON.stringify.\n  return JSON.stringify(value) ?? \"null\";\n}\n\n/** The whole subtree on one line. */\nfunction flatten(value: JsonValue, cfg: WriterConfig): string {\n  if (isJsonArray(value)) {\n    if (value.length === 0) return \"[]\";\n    const parts = value.map((v) => flatten(v ?? null, cfg));\n    return cfg.spaced ? `[${parts.join(\", \")}]` : `[${parts.join(\",\")}]`;\n  }\n  if (isJsonObject(value)) {\n    const keys = orderedKeys(value, cfg.sortKeys);\n    if (keys.length === 0) return \"{}\";\n    const colon = cfg.spaced ? \": \" : \":\";\n    const parts = keys.map(\n      (k) => `${JSON.stringify(k)}${colon}${flatten(value[k] ?? null, cfg)}`,\n    );\n    return cfg.spaced ? `{ ${parts.join(\", \")} }` : `{${parts.join(\",\")}}`;\n  }\n  return writeScalar(value);\n}\n\n/**\n * Lay out `entries` (already-rendered child texts) inside a container.\n * Single-line entries are packed together while they fit; a multi-line entry\n * always occupies its own line(s). Returns the body lines, unindented-prefixed\n * with `pad` already applied.\n */\nfunction layoutEntries(\n  entries: string[],\n  pad: string,\n  cfg: WriterConfig,\n): string[] {\n  if (!cfg.pack) return entries.map((e) => pad + e);\n\n  const lines: string[] = [];\n  let current = \"\";\n  for (let i = 0; i < entries.length; i++) {\n    const entry = entries[i] ?? \"\";\n    const isLast = i === entries.length - 1;\n    const piece = isLast ? entry : `${entry},`;\n\n    if (entry.includes(\"\\n\")) {\n      // Multi-line child: flush whatever is buffered, then stand alone.\n      if (current !== \"\") {\n        lines.push(pad + current);\n        current = \"\";\n      }\n      lines.push(pad + piece);\n      continue;\n    }\n\n    if (current === \"\") {\n      current = piece;\n      continue;\n    }\n    const merged = `${current} ${piece}`;\n    if (pad.length + merged.length <= cfg.width) {\n      current = merged;\n    } else {\n      lines.push(pad + current);\n      current = piece;\n    }\n  }\n  if (current !== \"\") lines.push(pad + current);\n  return lines;\n}\n\n/**\n * Render `value` starting at column `used` on its current line, at nesting\n * `level`. `used` includes the indentation AND any key prefix already written,\n * so the width budget is honest about `\"items\": [` style prefixes.\n */\nfunction renderNode(\n  value: JsonValue,\n  level: number,\n  used: number,\n  cfg: WriterConfig,\n): string {\n  const isContainer = isJsonArray(value) || isJsonObject(value);\n  if (!isContainer) return writeScalar(value);\n\n  const flat = flatten(value, cfg);\n  if (flat === \"[]\" || flat === \"{}\") return flat;\n  if (cfg.width >= 0 && used + flat.length <= cfg.width) return flat;\n\n  const pad = \" \".repeat((level + 1) * cfg.indent);\n  const closePad = \" \".repeat(level * cfg.indent);\n\n  if (isJsonArray(value)) {\n    const entries = value.map((v) =>\n      renderNode(v ?? null, level + 1, pad.length, cfg),\n    );\n    const body = layoutEntries(entries, pad, cfg);\n    const joined = cfg.pack ? body.join(\"\\n\") : body.join(\",\\n\");\n    return `[\\n${joined}\\n${closePad}]`;\n  }\n\n  const keys = orderedKeys(value, cfg.sortKeys);\n  const entries = keys.map((k) => {\n    const prefix = `${JSON.stringify(k)}: `;\n    const rendered = renderNode(\n      value[k] ?? null,\n      level + 1,\n      pad.length + prefix.length,\n      cfg,\n    );\n    return prefix + rendered;\n  });\n  const body = layoutEntries(entries, pad, cfg);\n  const joined = cfg.pack ? body.join(\"\\n\") : body.join(\",\\n\");\n  return `{\\n${joined}\\n${closePad}}`;\n}\n\n/**\n * Serialize a JSON value in one of the three styles. This is the entry point\n * for callers that already HAVE a value (a DB JSONB blob, an API frame) and\n * just want it laid out; text callers want {@link formatJsonText}.\n */\nexport function stringifyJson(\n  value: JsonValue,\n  options: JsonFormatOptions,\n): string {\n  const indent = options.indent ?? DEFAULT_JSON_INDENT;\n  const sortKeys = options.sortKeys ?? false;\n\n  if (options.style === \"minify\") {\n    return flatten(value, { indent, width: -1, pack: false, spaced: false, sortKeys });\n  }\n\n  const cfg: WriterConfig = {\n    indent,\n    width: options.style === \"pretty\" ? -1 : (options.width ?? DEFAULT_JSON_WIDTH),\n    pack: options.style === \"compact\",\n    spaced: true,\n    sortKeys,\n  };\n  return renderNode(value, 0, 0, cfg);\n}\n\nfunction sizeOf(text: string): JsonTextSize {\n  let lines = text === \"\" ? 0 : 1;\n  for (let i = 0; i < text.length; i++) if (text[i] === \"\\n\") lines++;\n  return { lines, chars: text.length };\n}\n\n/** Re-assemble the full text: leading + fence + formatted payload + trailing. */\nfunction reassemble(\n  detection: JsonDetection,\n  payload: string,\n  mode: NonNullable<JsonFormatOptions[\"fence\"]>,\n): string {\n  const { fence, leading, trailing } = detection;\n\n  const keepFence =\n    mode === \"add\" || (mode === \"preserve\" && fence !== null);\n  if (!keepFence) {\n    return leading + payload + trailing;\n  }\n\n  const marker = fence?.marker ?? \"```\";\n  const lang = fence?.lang && fence.lang !== \"\" ? fence.lang : \"json\";\n  const indent = fence?.indent ?? \"\";\n  const body = indent\n    ? payload\n        .split(\"\\n\")\n        .map((l) => (l === \"\" ? l : indent + l))\n        .join(\"\\n\")\n    : payload;\n\n  // An unterminated source fence stays unterminated — inventing a closing fence\n  // would change the surrounding document's structure, not just this block's.\n  const close = fence !== null && !fence.closed ? \"\" : `\\n${indent}${marker}`;\n  return `${leading}${indent}${marker}${lang}\\n${body}${close}${trailing}`;\n}\n\n/**\n * Format the JSON found in `text`, preserving everything around it.\n *\n * Never throws. When the text does not parse, the result is `ok: false`,\n * `changed: false`, and `text` is the input verbatim — a formatter that\n * mangles text it did not understand is a data-loss bug.\n */\nexport function formatJsonText(\n  text: string,\n  options: JsonFormatOptions,\n): JsonFormatResult {\n  const detection = detectJson(text);\n  const before = sizeOf(text);\n\n  if (!detection.ok || detection.value === undefined) {\n    return {\n      ok: false,\n      text,\n      error: detection.error ?? \"Selection is not JSON.\",\n      changed: false,\n      detection,\n      before,\n      after: before,\n    };\n  }\n\n  const payload = stringifyJson(detection.value, options);\n  const next = reassemble(detection, payload, options.fence ?? \"preserve\");\n\n  return {\n    ok: true,\n    text: next,\n    changed: next !== text,\n    detection,\n    before,\n    after: sizeOf(next),\n  };\n}\n"],"mappings":"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","names":["JSON5","entries","body","joined"]}