@poe-platform/safe-bash 0.1.810 → 0.1.811

package/dist/safe-bash-presentation-engine/text-replacement.js

@@ -1,22 +1,22 @@
 import {
   replacePresentationText
-} from "../safe-bash/command-chunks/chunk-3UJWHRK4.js";
-import "../safe-bash/command-chunks/chunk-HONWGFDA.js";
-import "../safe-bash/command-chunks/chunk-ORZRWT62.js";
-import "../safe-bash/command-chunks/chunk-VPDSQPSN.js";
-import "../safe-bash/command-chunks/chunk-S4IIOSRA.js";
-import "../safe-bash/command-chunks/chunk-SFCERNHU.js";
-import "../safe-bash/command-chunks/chunk-KMMAJ6H6.js";
-import "../safe-bash/command-chunks/chunk-MMBRBANA.js";
-import "../safe-bash/command-chunks/chunk-FXKBM5KJ.js";
-import "../safe-bash/command-chunks/chunk-6UHGIWFX.js";
-import "../safe-bash/command-chunks/chunk-5L6GHFRW.js";
-import "../safe-bash/command-chunks/chunk-DVQBZXMQ.js";
-import "../safe-bash/command-chunks/chunk-NTRZMQZP.js";
-import "../safe-bash/command-chunks/chunk-AXWPJRY6.js";
+} from "../safe-bash/command-chunks/chunk-XVP6V5K3.js";
+import "../safe-bash/command-chunks/chunk-33YCKZZX.js";
+import "../safe-bash/command-chunks/chunk-56NYSX65.js";
+import "../safe-bash/command-chunks/chunk-DM2CPMB4.js";
+import "../safe-bash/command-chunks/chunk-X7FA7ZD5.js";
+import "../safe-bash/command-chunks/chunk-XPD636C4.js";
+import "../safe-bash/command-chunks/chunk-PNGDJA6M.js";
+import "../safe-bash/command-chunks/chunk-RNSKXOG3.js";
+import "../safe-bash/command-chunks/chunk-QC5RMGSA.js";
+import "../safe-bash/command-chunks/chunk-2ZFLMWOX.js";
+import "../safe-bash/command-chunks/chunk-554Z6IKP.js";
+import "../safe-bash/command-chunks/chunk-WJCN2IXI.js";
+import "../safe-bash/command-chunks/chunk-ZMHEGDU2.js";
+import "../safe-bash/command-chunks/chunk-36XGIPOG.js";
 import "../safe-bash/command-chunks/chunk-ZITBS2EB.js";
-import "../safe-bash/command-chunks/chunk-NXCMXD74.js";
-import "../safe-bash/command-chunks/chunk-KJ3PEDI2.js";
+import "../safe-bash/command-chunks/chunk-S6R3IB36.js";
+import "../safe-bash/command-chunks/chunk-Q73EMLLZ.js";
 import "../safe-bash/command-chunks/chunk-37XCUS43.js";
 import "../safe-bash/command-chunks/chunk-IOEUZ4EA.js";
 import "../safe-bash/command-chunks/chunk-E6SK3OU2.js";

package/dist/safe-bash-presentation-engine/text-runs.js

@@ -8,27 +8,27 @@ import {
   textStrikeStyles,
   textUnderlineStyles,
   validateTextRunOptions
-} from "../safe-bash/command-chunks/chunk-KTI3BULE.js";
-import "../safe-bash/command-chunks/chunk-HONWGFDA.js";
-import "../safe-bash/command-chunks/chunk-53JP3S6H.js";
-import "../safe-bash/command-chunks/chunk-7AVN3OBH.js";
-import "../safe-bash/command-chunks/chunk-KCTV4NVX.js";
+} from "../safe-bash/command-chunks/chunk-XZ2FWFNV.js";
+import "../safe-bash/command-chunks/chunk-33YCKZZX.js";
+import "../safe-bash/command-chunks/chunk-5HPU7D36.js";
+import "../safe-bash/command-chunks/chunk-RHYJVTJO.js";
+import "../safe-bash/command-chunks/chunk-CRV2Q3PB.js";
 import "../safe-bash/command-chunks/chunk-HR2Y6YEP.js";
-import "../safe-bash/command-chunks/chunk-ORZRWT62.js";
-import "../safe-bash/command-chunks/chunk-VPDSQPSN.js";
-import "../safe-bash/command-chunks/chunk-S4IIOSRA.js";
-import "../safe-bash/command-chunks/chunk-SFCERNHU.js";
-import "../safe-bash/command-chunks/chunk-KMMAJ6H6.js";
-import "../safe-bash/command-chunks/chunk-MMBRBANA.js";
-import "../safe-bash/command-chunks/chunk-FXKBM5KJ.js";
-import "../safe-bash/command-chunks/chunk-6UHGIWFX.js";
-import "../safe-bash/command-chunks/chunk-5L6GHFRW.js";
-import "../safe-bash/command-chunks/chunk-DVQBZXMQ.js";
-import "../safe-bash/command-chunks/chunk-NTRZMQZP.js";
-import "../safe-bash/command-chunks/chunk-AXWPJRY6.js";
+import "../safe-bash/command-chunks/chunk-56NYSX65.js";
+import "../safe-bash/command-chunks/chunk-DM2CPMB4.js";
+import "../safe-bash/command-chunks/chunk-X7FA7ZD5.js";
+import "../safe-bash/command-chunks/chunk-XPD636C4.js";
+import "../safe-bash/command-chunks/chunk-PNGDJA6M.js";
+import "../safe-bash/command-chunks/chunk-RNSKXOG3.js";
+import "../safe-bash/command-chunks/chunk-QC5RMGSA.js";
+import "../safe-bash/command-chunks/chunk-2ZFLMWOX.js";
+import "../safe-bash/command-chunks/chunk-554Z6IKP.js";
+import "../safe-bash/command-chunks/chunk-WJCN2IXI.js";
+import "../safe-bash/command-chunks/chunk-ZMHEGDU2.js";
+import "../safe-bash/command-chunks/chunk-36XGIPOG.js";
 import "../safe-bash/command-chunks/chunk-ZITBS2EB.js";
-import "../safe-bash/command-chunks/chunk-NXCMXD74.js";
-import "../safe-bash/command-chunks/chunk-KJ3PEDI2.js";
+import "../safe-bash/command-chunks/chunk-S6R3IB36.js";
+import "../safe-bash/command-chunks/chunk-Q73EMLLZ.js";
 import "../safe-bash/command-chunks/chunk-37XCUS43.js";
 import "../safe-bash/command-chunks/chunk-IOEUZ4EA.js";
 import "../safe-bash/command-chunks/chunk-E6SK3OU2.js";

package/dist/safe-bash-presentation-engine/themes.js

@@ -4,22 +4,22 @@ import {
   themeColorSlots,
   themeFontSlots,
   validateColor
-} from "../safe-bash/command-chunks/chunk-7AVN3OBH.js";
-import "../safe-bash/command-chunks/chunk-ORZRWT62.js";
-import "../safe-bash/command-chunks/chunk-VPDSQPSN.js";
-import "../safe-bash/command-chunks/chunk-S4IIOSRA.js";
-import "../safe-bash/command-chunks/chunk-SFCERNHU.js";
-import "../safe-bash/command-chunks/chunk-KMMAJ6H6.js";
-import "../safe-bash/command-chunks/chunk-MMBRBANA.js";
-import "../safe-bash/command-chunks/chunk-FXKBM5KJ.js";
-import "../safe-bash/command-chunks/chunk-6UHGIWFX.js";
-import "../safe-bash/command-chunks/chunk-5L6GHFRW.js";
-import "../safe-bash/command-chunks/chunk-DVQBZXMQ.js";
-import "../safe-bash/command-chunks/chunk-NTRZMQZP.js";
-import "../safe-bash/command-chunks/chunk-AXWPJRY6.js";
+} from "../safe-bash/command-chunks/chunk-RHYJVTJO.js";
+import "../safe-bash/command-chunks/chunk-56NYSX65.js";
+import "../safe-bash/command-chunks/chunk-DM2CPMB4.js";
+import "../safe-bash/command-chunks/chunk-X7FA7ZD5.js";
+import "../safe-bash/command-chunks/chunk-XPD636C4.js";
+import "../safe-bash/command-chunks/chunk-PNGDJA6M.js";
+import "../safe-bash/command-chunks/chunk-RNSKXOG3.js";
+import "../safe-bash/command-chunks/chunk-QC5RMGSA.js";
+import "../safe-bash/command-chunks/chunk-2ZFLMWOX.js";
+import "../safe-bash/command-chunks/chunk-554Z6IKP.js";
+import "../safe-bash/command-chunks/chunk-WJCN2IXI.js";
+import "../safe-bash/command-chunks/chunk-ZMHEGDU2.js";
+import "../safe-bash/command-chunks/chunk-36XGIPOG.js";
 import "../safe-bash/command-chunks/chunk-ZITBS2EB.js";
-import "../safe-bash/command-chunks/chunk-NXCMXD74.js";
-import "../safe-bash/command-chunks/chunk-KJ3PEDI2.js";
+import "../safe-bash/command-chunks/chunk-S6R3IB36.js";
+import "../safe-bash/command-chunks/chunk-Q73EMLLZ.js";
 import "../safe-bash/command-chunks/chunk-37XCUS43.js";
 import "../safe-bash/command-chunks/chunk-IOEUZ4EA.js";
 import "../safe-bash/command-chunks/chunk-E6SK3OU2.js";

package/dist/safe-bash-presentation-engine/transitions.js

@@ -2,22 +2,22 @@ import {
   mutateTransitions,
   readTransitions,
   validateTransitionOptions
-} from "../safe-bash/command-chunks/chunk-SE5SJ4JT.js";
-import "../safe-bash/command-chunks/chunk-ORZRWT62.js";
-import "../safe-bash/command-chunks/chunk-VPDSQPSN.js";
-import "../safe-bash/command-chunks/chunk-S4IIOSRA.js";
-import "../safe-bash/command-chunks/chunk-SFCERNHU.js";
-import "../safe-bash/command-chunks/chunk-KMMAJ6H6.js";
-import "../safe-bash/command-chunks/chunk-MMBRBANA.js";
-import "../safe-bash/command-chunks/chunk-FXKBM5KJ.js";
-import "../safe-bash/command-chunks/chunk-6UHGIWFX.js";
-import "../safe-bash/command-chunks/chunk-5L6GHFRW.js";
-import "../safe-bash/command-chunks/chunk-DVQBZXMQ.js";
-import "../safe-bash/command-chunks/chunk-NTRZMQZP.js";
-import "../safe-bash/command-chunks/chunk-AXWPJRY6.js";
+} from "../safe-bash/command-chunks/chunk-Z2JW6M2D.js";
+import "../safe-bash/command-chunks/chunk-56NYSX65.js";
+import "../safe-bash/command-chunks/chunk-DM2CPMB4.js";
+import "../safe-bash/command-chunks/chunk-X7FA7ZD5.js";
+import "../safe-bash/command-chunks/chunk-XPD636C4.js";
+import "../safe-bash/command-chunks/chunk-PNGDJA6M.js";
+import "../safe-bash/command-chunks/chunk-RNSKXOG3.js";
+import "../safe-bash/command-chunks/chunk-QC5RMGSA.js";
+import "../safe-bash/command-chunks/chunk-2ZFLMWOX.js";
+import "../safe-bash/command-chunks/chunk-554Z6IKP.js";
+import "../safe-bash/command-chunks/chunk-WJCN2IXI.js";
+import "../safe-bash/command-chunks/chunk-ZMHEGDU2.js";
+import "../safe-bash/command-chunks/chunk-36XGIPOG.js";
 import "../safe-bash/command-chunks/chunk-ZITBS2EB.js";
-import "../safe-bash/command-chunks/chunk-NXCMXD74.js";
-import "../safe-bash/command-chunks/chunk-KJ3PEDI2.js";
+import "../safe-bash/command-chunks/chunk-S6R3IB36.js";
+import "../safe-bash/command-chunks/chunk-Q73EMLLZ.js";
 import "../safe-bash/command-chunks/chunk-37XCUS43.js";
 import "../safe-bash/command-chunks/chunk-IOEUZ4EA.js";
 import "../safe-bash/command-chunks/chunk-E6SK3OU2.js";

package/dist/safe-bash-presentation-engine/validation.js

@@ -1,16 +1,16 @@
 import {
   openRetainedPresentationValidation,
   validatePresentation
-} from "../safe-bash/command-chunks/chunk-MMBRBANA.js";
-import "../safe-bash/command-chunks/chunk-FXKBM5KJ.js";
-import "../safe-bash/command-chunks/chunk-6UHGIWFX.js";
-import "../safe-bash/command-chunks/chunk-5L6GHFRW.js";
-import "../safe-bash/command-chunks/chunk-DVQBZXMQ.js";
-import "../safe-bash/command-chunks/chunk-NTRZMQZP.js";
-import "../safe-bash/command-chunks/chunk-AXWPJRY6.js";
+} from "../safe-bash/command-chunks/chunk-RNSKXOG3.js";
+import "../safe-bash/command-chunks/chunk-QC5RMGSA.js";
+import "../safe-bash/command-chunks/chunk-2ZFLMWOX.js";
+import "../safe-bash/command-chunks/chunk-554Z6IKP.js";
+import "../safe-bash/command-chunks/chunk-WJCN2IXI.js";
+import "../safe-bash/command-chunks/chunk-ZMHEGDU2.js";
+import "../safe-bash/command-chunks/chunk-36XGIPOG.js";
 import "../safe-bash/command-chunks/chunk-ZITBS2EB.js";
-import "../safe-bash/command-chunks/chunk-NXCMXD74.js";
-import "../safe-bash/command-chunks/chunk-KJ3PEDI2.js";
+import "../safe-bash/command-chunks/chunk-S6R3IB36.js";
+import "../safe-bash/command-chunks/chunk-Q73EMLLZ.js";
 import "../safe-bash/command-chunks/chunk-IOEUZ4EA.js";
 import "../safe-bash/command-chunks/chunk-E6SK3OU2.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";

package/dist/safe-bash-presentation-engine/xml-parts.js

@@ -4,22 +4,22 @@ import {
   replaceXmlPart,
   stageRetainedXmlPart,
   validateXmlPartReplacement
-} from "../safe-bash/command-chunks/chunk-CAXJ4RLF.js";
-import "../safe-bash/command-chunks/chunk-U6QHTC5J.js";
-import "../safe-bash/command-chunks/chunk-VPDSQPSN.js";
-import "../safe-bash/command-chunks/chunk-S4IIOSRA.js";
-import "../safe-bash/command-chunks/chunk-SFCERNHU.js";
-import "../safe-bash/command-chunks/chunk-KMMAJ6H6.js";
-import "../safe-bash/command-chunks/chunk-MMBRBANA.js";
-import "../safe-bash/command-chunks/chunk-FXKBM5KJ.js";
-import "../safe-bash/command-chunks/chunk-6UHGIWFX.js";
-import "../safe-bash/command-chunks/chunk-5L6GHFRW.js";
-import "../safe-bash/command-chunks/chunk-DVQBZXMQ.js";
-import "../safe-bash/command-chunks/chunk-NTRZMQZP.js";
-import "../safe-bash/command-chunks/chunk-AXWPJRY6.js";
+} from "../safe-bash/command-chunks/chunk-KJ4XXZIL.js";
+import "../safe-bash/command-chunks/chunk-L5MCW6CM.js";
+import "../safe-bash/command-chunks/chunk-DM2CPMB4.js";
+import "../safe-bash/command-chunks/chunk-X7FA7ZD5.js";
+import "../safe-bash/command-chunks/chunk-XPD636C4.js";
+import "../safe-bash/command-chunks/chunk-PNGDJA6M.js";
+import "../safe-bash/command-chunks/chunk-RNSKXOG3.js";
+import "../safe-bash/command-chunks/chunk-QC5RMGSA.js";
+import "../safe-bash/command-chunks/chunk-2ZFLMWOX.js";
+import "../safe-bash/command-chunks/chunk-554Z6IKP.js";
+import "../safe-bash/command-chunks/chunk-WJCN2IXI.js";
+import "../safe-bash/command-chunks/chunk-ZMHEGDU2.js";
+import "../safe-bash/command-chunks/chunk-36XGIPOG.js";
 import "../safe-bash/command-chunks/chunk-ZITBS2EB.js";
-import "../safe-bash/command-chunks/chunk-NXCMXD74.js";
-import "../safe-bash/command-chunks/chunk-KJ3PEDI2.js";
+import "../safe-bash/command-chunks/chunk-S6R3IB36.js";
+import "../safe-bash/command-chunks/chunk-Q73EMLLZ.js";
 import "../safe-bash/command-chunks/chunk-37XCUS43.js";
 import "../safe-bash/command-chunks/chunk-IOEUZ4EA.js";
 import "../safe-bash/command-chunks/chunk-E6SK3OU2.js";

package/dist/safe-bash-presentation-engine/xml-view.js

@@ -1,8 +1,8 @@
 import {
   createXmlElementView
-} from "../safe-bash/command-chunks/chunk-UJXP3T6R.js";
-import "../safe-bash/command-chunks/chunk-NXCMXD74.js";
-import "../safe-bash/command-chunks/chunk-KJ3PEDI2.js";
+} from "../safe-bash/command-chunks/chunk-4CKFNXRN.js";
+import "../safe-bash/command-chunks/chunk-S6R3IB36.js";
+import "../safe-bash/command-chunks/chunk-Q73EMLLZ.js";
 import "../safe-bash/command-chunks/chunk-IOEUZ4EA.js";
 import "../safe-bash/command-chunks/chunk-E6SK3OU2.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";

package/dist/safe-bash-presentation-engine/xml.js

@@ -1,8 +1,8 @@
 import {
   parseXmlPart
-} from "../safe-bash/command-chunks/chunk-5L6GHFRW.js";
-import "../safe-bash/command-chunks/chunk-NXCMXD74.js";
-import "../safe-bash/command-chunks/chunk-KJ3PEDI2.js";
+} from "../safe-bash/command-chunks/chunk-554Z6IKP.js";
+import "../safe-bash/command-chunks/chunk-S6R3IB36.js";
+import "../safe-bash/command-chunks/chunk-Q73EMLLZ.js";
 import "../safe-bash/command-chunks/chunk-IOEUZ4EA.js";
 import "../safe-bash/command-chunks/chunk-E6SK3OU2.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";

package/dist/safe-bash-xml-engine/json.d.ts

@@ -2,3 +2,4 @@ import type { XmlElement } from "@poe-platform/safe-fs/core";
 import type { Json } from "../safe-bash-query-engine/limits.js";
 import type { XmlBudget } from "./limits.js";
 export declare function xmlToJson(root: XmlElement, budget: XmlBudget): Promise<Json>;
+export { storedXmlToJson } from "./stored-json.js";

package/dist/safe-bash-xml-engine/json.js

@@ -1,5 +1,207 @@
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 
+// packages/safe-bash-xml-engine/src/stored-json.ts
+import { IntegerTable } from "@poe-platform/safe-fs/storage";
+async function* quoted(parts) {
+  yield '"';
+  for await (const part of parts) for (let start = 0; start < part.length; ) {
+    let end = Math.min(start + 1024, part.length);
+    if (end < part.length && part.charCodeAt(end - 1) >= 55296 && part.charCodeAt(end - 1) <= 56319) end--;
+    yield JSON.stringify(part.slice(start, end)).slice(1, -1);
+    start = end;
+  }
+  yield '"';
+}
+async function* storedXmlToJson(document, budget) {
+  const storage = document.storage;
+  const parents = new IntegerTable(storage, 128), hashes = new IntegerTable(storage, 128);
+  const encoder = new TextEncoder();
+  let cached;
+  async function node(reference) {
+    if (cached?.reference === reference) return cached.value;
+    const value = await document.node(reference);
+    if (value.kind !== "element") throw new TypeError("XML JSON conversion expected an element");
+    cached = { reference, value };
+    return value;
+  }
+  async function record(values) {
+    const bytes = new Uint8Array(values.length * 8), view = new DataView(bytes.buffer);
+    for (let index = 0; index < values.length; index++) view.setFloat64(index * 8, values[index], true);
+    return storage.append(bytes);
+  }
+  async function fields(reference, count) {
+    const bytes = await storage.read(reference, count * 8), view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    return Array.from({ length: count }, (_, index) => view.getFloat64(index * 8, true));
+  }
+  async function set(reference, index, value) {
+    const bytes = new Uint8Array(8);
+    new DataView(bytes.buffer).setFloat64(0, value, true);
+    await storage.write(reference + index * 8, bytes);
+  }
+  async function hash(parent, name) {
+    let value = 14695981039346656037n;
+    for (const part of [String(parent), ":", name]) for (const character of part) {
+      const checkpoint = budget.tick();
+      if (checkpoint) await checkpoint;
+      value = BigInt.asUintN(64, (value ^ BigInt(character.codePointAt(0))) * 1099511628211n);
+    }
+    return value;
+  }
+  for await (const entry of document.walk(document.root)) {
+    if (entry.closing || entry.reference === document.root) continue;
+    const current = await document.node(entry.reference);
+    if (current.kind !== "element") continue;
+    const parent = await document.parent(entry.reference), key = await hash(parent, current.name);
+    const bucket = Number(await hashes.get(key) ?? 0n);
+    let group = bucket;
+    while (group) {
+      const value = await fields(group, 8);
+      const checkpoint = budget.tick(current.name.length + 1);
+      if (checkpoint) await checkpoint;
+      if (value[0] === parent && (await node(value[1])).name === current.name) break;
+      group = value[6];
+    }
+    const member = await record([entry.reference, 0]);
+    if (group) {
+      const value = await fields(group, 8);
+      await set(value[3], 1, member);
+      await set(group, 3, member);
+      await set(group, 7, value[7] + 1);
+    } else {
+      let owner = Number(await parents.get(BigInt(parent)) ?? 0n);
+      if (!owner) {
+        owner = await record([0, 0]);
+        await parents.set(BigInt(parent), BigInt(owner));
+      }
+      const ends = await fields(owner, 2);
+      group = await record([parent, entry.reference, member, member, ends[1], 0, bucket, 1]);
+      if (ends[1]) await set(ends[1], 5, group);
+      else await set(owner, 0, group);
+      await set(owner, 1, group);
+      await hashes.set(key, BigInt(group));
+    }
+  }
+  async function* directText(reference, first = 0, last = Infinity) {
+    let offset = 0;
+    for await (const child of document.children(reference)) {
+      const value = await document.node(child);
+      if (value.kind !== "text" && value.kind !== "cdata") continue;
+      for await (const part of document.text(child)) {
+        const end = offset + part.length;
+        if (end > first && offset < last) yield part.slice(Math.max(0, first - offset), Math.min(part.length, last - offset));
+        offset = end;
+      }
+    }
+  }
+  let head = 0;
+  async function push(task) {
+    const checkpoint = budget.tick();
+    if (checkpoint) await checkpoint;
+    const bytes = encoder.encode(JSON.stringify(task));
+    const reference = await record([head, bytes.length]);
+    await storage.append(bytes);
+    head = reference;
+  }
+  async function pop() {
+    if (!head) return void 0;
+    const reference = head, value = await fields(reference, 2);
+    head = value[0];
+    return JSON.parse(new TextDecoder().decode(await storage.read(reference + 16, value[1])));
+  }
+  async function* output() {
+    const root = await node(document.root);
+    yield "{";
+    yield* quoted([root.name]);
+    yield ":";
+    await push({ kind: "literal", value: "}" });
+    await push({ kind: "element", reference: document.root });
+    while (true) {
+      const checkpoint = budget.tick();
+      if (checkpoint) await checkpoint;
+      const task = await pop();
+      if (!task) break;
+      if (task.kind === "literal") {
+        yield task.value;
+        continue;
+      }
+      if (task.kind === "attribute") {
+        const attribute = (await node(task.reference)).attributes[task.index];
+        yield* quoted(["@" + attribute.name]);
+        yield ":";
+        yield* quoted([attribute.value]);
+        continue;
+      }
+      if (task.kind === "text") {
+        yield* quoted(directText(task.reference, task.first, task.last));
+        continue;
+      }
+      if (task.kind === "members") {
+        const member = await fields(task.reference, 2);
+        if (member[1]) {
+          await push({ kind: "members", reference: member[1] });
+          await push({ kind: "literal", value: "," });
+        }
+        await push({ kind: "element", reference: member[0] });
+        continue;
+      }
+      if (task.kind === "group") {
+        const group = await fields(task.reference, 8);
+        yield* quoted([(await node(group[1])).name]);
+        yield ":";
+        if (group[7] === 1) await push({ kind: "element", reference: group[1] });
+        else {
+          yield "[";
+          await push({ kind: "literal", value: "]" });
+          await push({ kind: "members", reference: group[2] });
+        }
+        continue;
+      }
+      const current = await node(task.reference);
+      let first = -1, last = 0, offset = 0;
+      for await (const part of directText(task.reference)) for (const character of part) {
+        const checkpoint2 = budget.tick();
+        if (checkpoint2) await checkpoint2;
+        if (character.trim()) {
+          if (first < 0) first = offset;
+          last = offset + character.length;
+        }
+        offset += character.length;
+      }
+      const owner = Number(await parents.get(BigInt(task.reference)) ?? 0n);
+      if (!owner && !current.attributes.length) {
+        if (first < 0) yield "null";
+        else yield* quoted(directText(task.reference, first, last));
+        continue;
+      }
+      yield "{";
+      await push({ kind: "literal", value: "}" });
+      if (first >= 0) {
+        await push({ kind: "text", reference: task.reference, first, last });
+        await push({ kind: "literal", value: ',"#text":' });
+      }
+      if (owner) {
+        let group = (await fields(owner, 2))[1];
+        while (group) {
+          const value = await fields(group, 8);
+          await push({ kind: "group", reference: group });
+          if (value[4] || current.attributes.length) await push({ kind: "literal", value: "," });
+          group = value[4];
+        }
+      }
+      for (let index = current.attributes.length - 1; index >= 0; index--) {
+        await push({ kind: "attribute", reference: task.reference, index });
+        if (index) await push({ kind: "literal", value: "," });
+      }
+    }
+    yield "\n";
+  }
+  for await (const part of output()) {
+    const checkpoint = budget.tick(part.length);
+    if (checkpoint) await checkpoint;
+    yield encoder.encode(part);
+  }
+}
+
 // packages/safe-bash-xml-engine/src/json.ts
 async function xmlToJson(root, budget) {
   async function element(node) {
@@ -36,5 +238,6 @@ async function xmlToJson(root, budget) {
   return result;
 }
 export {
+  storedXmlToJson,
   xmlToJson
 };

package/dist/safe-bash-xml-engine/stored-json.d.ts

@@ -0,0 +1,5 @@
+import type { XmlBudget } from "./limits.js";
+import type { StoredXmlDocument } from "./stored-document.js";
+/** xmltodict grouping and traversal use caller-backed records. Only the current
+ * node's metadata and a fixed page cache are resident; jq owns its input values. */
+export declare function storedXmlToJson(document: StoredXmlDocument, budget: XmlBudget): AsyncGenerator<Uint8Array>;

package/dist/spreadsheet-engine/rendering/print/bidi-runs.d.ts

@@ -0,0 +1,5 @@
+/** Visual run order with logical text retained for the font shaper. */
+export declare function printBidiRuns(text: string, direction: "ltr" | "rtl", tick: (amount?: number) => void): {
+    text: string;
+    direction: "ltr" | "rtl";
+}[];

package/dist/spreadsheet-engine/rendering/print/bidi-runs.js

@@ -0,0 +1,35 @@
+import createBidi from "bidi-js";
+// The CommonJS factory is published with an ESM-shaped declaration.
+const bidi = createBidi();
+/** Visual run order with logical text retained for the font shaper. */
+export function printBidiRuns(text, direction, tick) {
+    // UAX #9 caps embedding depth at 125; reserve synchronous resolver work.
+    tick(text.length * 128);
+    if (!text)
+        return [];
+    const embedding = bidi.getEmbeddingLevels(text, direction);
+    const groups = [];
+    const membership = [];
+    let previous = -1;
+    for (let index = 0; index < text.length; index++) {
+        tick();
+        const level = embedding.levels[index];
+        if (level !== previous) {
+            groups.push({ text: "", direction: level % 2 ? "rtl" : "ltr" });
+            previous = level;
+        }
+        groups[groups.length - 1].text += text[index];
+        membership.push(groups.length - 1);
+    }
+    const seen = new Set();
+    const result = [];
+    for (const index of bidi.getReorderedIndices(text, embedding)) {
+        tick();
+        const group = membership[index];
+        if (!seen.has(group)) {
+            seen.add(group);
+            result.push(groups[group]);
+        }
+    }
+    return result;
+}

package/dist/spreadsheet-engine/rendering/print/control-bidi.d.ts

@@ -0,0 +1,8 @@
+/** Pango's single-paragraph FriBidi profile for mixed letter/tab/control runs. */
+export declare function controlBidiItems(text: string, direction: "ltr" | "rtl", tick: (amount?: number) => void): {
+    items: {
+        text: string;
+        direction: "ltr" | "rtl";
+    }[];
+    order: number[];
+} | undefined;

package/dist/spreadsheet-engine/rendering/print/control-bidi.js

@@ -0,0 +1,80 @@
+import createBidi from "bidi-js";
+const bidi = createBidi();
+/** Pango's single-paragraph FriBidi profile for mixed letter/tab/control runs. */
+export function controlBidiItems(text, direction, tick) {
+    tick(text.length * 128);
+    const types = Array.from(text, char => bidi.getBidiCharTypeName(char));
+    // Wider weak/neutral/explicit profiles need independent native qualification.
+    if (!types.includes("L") || !types.includes("R") || types.some(type => !["L", "R", "BN", "B", "S"].includes(type)))
+        return;
+    const levels = new Uint8Array(text.length);
+    let start = 0;
+    for (let index = 0; index <= text.length; index++) {
+        tick();
+        if (index < text.length && text[index] !== "\r" && text[index] !== "\u2029")
+            continue;
+        // FriBidi X8 stops explicit-level assignment at the first B. Later
+        // letters retain the initialized zero base before implicit resolution.
+        levels.set(bidi.getEmbeddingLevels(text.slice(start, index), start === 0 ? direction : "ltr").levels, start);
+        if (index < text.length)
+            levels[index] = direction === "rtl" ? 1 : 0;
+        start = index + 1;
+    }
+    // FriBidi L1 restores segment/paragraph separators to the original base.
+    let afterParagraph = false;
+    for (let index = 0; index < text.length; index++) {
+        tick();
+        if (text[index] === "\r" || text[index] === "\u2029")
+            afterParagraph = true;
+        if (afterParagraph && bidi.getBidiCharTypeName(text[index]) === "BN")
+            levels[index] = 0;
+        if (text[index] === "\t")
+            levels[index] = direction === "rtl" ? 1 : 0;
+    }
+    let reset = true;
+    for (let index = text.length - 1; index >= 0; index--) {
+        tick();
+        const char = text[index];
+        if (char === "\t" || char === "\r" || char === "\u2029")
+            reset = true;
+        else if (bidi.getBidiCharTypeName(char) !== "BN")
+            reset = false;
+        if (reset)
+            levels[index] = direction === "rtl" ? 1 : 0;
+    }
+    const items = [];
+    const itemLevels = [];
+    let previousControl = true;
+    for (let index = 0; index < text.length; index++) {
+        tick();
+        const char = text[index], level = levels[index];
+        const control = char === "\t" || char === "\r" || char === "\u2029";
+        if (control || previousControl || level !== itemLevels.at(-1)) {
+            items.push({ text: "", direction: level % 2 ? "rtl" : "ltr" });
+            itemLevels.push(level);
+        }
+        items.at(-1).text += char;
+        previousControl = control;
+    }
+    const order = items.map((_, index) => index);
+    const max = itemLevels.reduce((max, level) => Math.max(max, level), 0);
+    // Reorder the single rendered line, including controls, as Pango does.
+    for (let level = max; level >= 1; level--) {
+        for (let first = 0; first < order.length;) {
+            tick();
+            if (itemLevels[order[first]] < level) {
+                first++;
+                continue;
+            }
+            let last = first;
+            while (last < order.length && itemLevels[order[last]] >= level) {
+                tick();
+                last++;
+            }
+            for (let a = first, b = last - 1; a < b; a++, b--)
+                [order[a], order[b]] = [order[b], order[a]];
+            first = last;
+        }
+    }
+    return { items, order };
+}

package/dist/spreadsheet-format-xls/biff-encrypted-properties.d.ts

@@ -3,10 +3,10 @@ import type { BiffPropertySource } from "./biff-encrypted-properties-write.js";
 import type { BiffRc4Cipher } from "./biff-encryption.js";
 /** Admit the outer container and reject hidden plaintext property collisions
  * before asking for a password. POI emits an empty document-summary placeholder. */
-export declare function encryptedBiffPropertyStream(streams: ReadonlyMap<string, Uint8Array> | undefined, context: CapabilityContext, charge: (amount: number) => void, propertySources?: ReadonlyMap<string, RangeSource>): Promise<Uint8Array>;
+export declare function encryptedBiffPropertyStream(streams: ReadonlyMap<string, Uint8Array> | undefined, context: CapabilityContext, charge: (amount: number) => void, propertySources?: ReadonlyMap<string, RangeSource>): Promise<Uint8Array | RangeSource>;
 /** MS-OFFCRYPTO 2.3.5.4: header/table restart block 0; each payload restarts its
  * descriptor block. These are not Workbook's absolute-position 1024-byte chunks. */
 export declare function decryptBiffPropertyContainer(encrypted: Uint8Array, keyStream: (block: number, length: number) => Uint8Array, context: CapabilityContext, charge: (amount: number) => void, createCipher?: (block: number) => BiffRc4Cipher): ReadonlyMap<string, Uint8Array>;
-/** Decrypt payloads directly into caller storage. Container bytes and the validated
- * descriptor table are still buffered; payload plaintext never accumulates in RAM. */
-export declare function decryptBiffPropertySources(encrypted: Uint8Array, createCipher: (block: number) => BiffRc4Cipher, context: CapabilityContext, charge: (amount: number) => void): Promise<ReadonlyMap<string, BiffPropertySource>>;
+/** Decrypt retained ciphertext directly into caller storage. Only the descriptor
+ * table is buffered; payload plaintext never accumulates in RAM. */
+export declare function decryptBiffPropertySources(encrypted: Uint8Array | RangeSource, createCipher: (block: number) => BiffRc4Cipher, context: CapabilityContext, charge: (amount: number) => void): Promise<ReadonlyMap<string, BiffPropertySource>>;