@poe-platform/safe-bash 0.1.812 → 0.1.814

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

@@ -1,25 +1,31 @@
 import {
   getXmlPart,
   openRetainedXmlPart,
+  openRetainedXmlReplacement,
   replaceXmlPart,
   stageRetainedXmlPart,
+  stageRetainedXmlReplacement,
   validateXmlPartReplacement
-} 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";
+} from "../safe-bash/command-chunks/chunk-VT2PHQ63.js";
+import "../safe-bash/command-chunks/chunk-SEPUP6TZ.js";
+import "../safe-bash/command-chunks/chunk-3ZRCL756.js";
+import "../safe-bash/command-chunks/chunk-4EHY6J2Z.js";
+import "../safe-bash/command-chunks/chunk-NQINS4XY.js";
+import "../safe-bash/command-chunks/chunk-KBAQHE5Y.js";
+import "../safe-bash/command-chunks/chunk-W3ZSWK76.js";
+import "../safe-bash/command-chunks/chunk-IWHNRYER.js";
+import "../safe-bash/command-chunks/chunk-NFII726L.js";
+import "../safe-bash/command-chunks/chunk-3GRMU7TM.js";
+import "../safe-bash/command-chunks/chunk-AWPI4DZR.js";
+import "../safe-bash/command-chunks/chunk-FWKLBDMK.js";
+import "../safe-bash/command-chunks/chunk-XTEIT5CI.js";
+import "../safe-bash/command-chunks/chunk-DBLQUZGN.js";
+import "../safe-bash/command-chunks/chunk-ZQM37BGE.js";
+import "../safe-bash/command-chunks/chunk-LNTEV56A.js";
+import "../safe-bash/command-chunks/chunk-WTVJLHMG.js";
 import "../safe-bash/command-chunks/chunk-ZITBS2EB.js";
-import "../safe-bash/command-chunks/chunk-S6R3IB36.js";
-import "../safe-bash/command-chunks/chunk-Q73EMLLZ.js";
+import "../safe-bash/command-chunks/chunk-JUHOL5KB.js";
+import "../safe-bash/command-chunks/chunk-CXME4YHU.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";
@@ -27,7 +33,9 @@ import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {
   getXmlPart,
   openRetainedXmlPart,
+  openRetainedXmlReplacement,
   replaceXmlPart,
   stageRetainedXmlPart,
+  stageRetainedXmlReplacement,
   validateXmlPartReplacement
 };

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

@@ -1,8 +1,8 @@
 import {
   createXmlElementView
-} from "../safe-bash/command-chunks/chunk-4CKFNXRN.js";
-import "../safe-bash/command-chunks/chunk-S6R3IB36.js";
-import "../safe-bash/command-chunks/chunk-Q73EMLLZ.js";
+} from "../safe-bash/command-chunks/chunk-XNGM3W5R.js";
+import "../safe-bash/command-chunks/chunk-JUHOL5KB.js";
+import "../safe-bash/command-chunks/chunk-CXME4YHU.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-554Z6IKP.js";
-import "../safe-bash/command-chunks/chunk-S6R3IB36.js";
-import "../safe-bash/command-chunks/chunk-Q73EMLLZ.js";
+} from "../safe-bash/command-chunks/chunk-DBLQUZGN.js";
+import "../safe-bash/command-chunks/chunk-JUHOL5KB.js";
+import "../safe-bash/command-chunks/chunk-CXME4YHU.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-query-engine/index.js

@@ -1,20 +1,20 @@
 import {
   YqValueFailure,
   createYqQuerySession
-} from "../safe-bash/command-chunks/chunk-WTE23QXN.js";
-import "../safe-bash/command-chunks/chunk-NJ4NTTCR.js";
+} from "../safe-bash/command-chunks/chunk-6ZGCKUAM.js";
+import "../safe-bash/command-chunks/chunk-77NXQZGK.js";
+import "../safe-bash/command-chunks/chunk-LNLACEAN.js";
 import "../safe-bash/command-chunks/chunk-DRHONH2C.js";
 import "../safe-bash/command-chunks/chunk-EBX5RKKT.js";
 import "../safe-bash/command-chunks/chunk-YJ5IA5YQ.js";
+import "../safe-bash/command-chunks/chunk-N6TG44VG.js";
 import "../safe-bash/command-chunks/chunk-E3DF7RTE.js";
 import "../safe-bash/command-chunks/chunk-AQ3XOOPQ.js";
 import "../safe-bash/command-chunks/chunk-ITXSHOLP.js";
-import "../safe-bash/command-chunks/chunk-77NXQZGK.js";
 import "../safe-bash/command-chunks/chunk-F5QYUK2E.js";
 import "../safe-bash/command-chunks/chunk-VWRHPDCD.js";
 import "../safe-bash/command-chunks/chunk-GNT3SCF3.js";
 import "../safe-bash/command-chunks/chunk-ZOEKSH3R.js";
-import "../safe-bash/command-chunks/chunk-N6TG44VG.js";
 import "../safe-bash/command-chunks/chunk-5VO534FR.js";
 import "../safe-bash/command-chunks/chunk-KK2T6Z7J.js";
 import "../safe-bash/command-chunks/chunk-V72MXW7X.js";

package/dist/safe-bash-query-engine/interpreter.js

@@ -1,9 +1,10 @@
 import {
   Interpreter
-} from "../safe-bash/command-chunks/chunk-NJ4NTTCR.js";
+} from "../safe-bash/command-chunks/chunk-LNLACEAN.js";
 import "../safe-bash/command-chunks/chunk-DRHONH2C.js";
 import "../safe-bash/command-chunks/chunk-EBX5RKKT.js";
 import "../safe-bash/command-chunks/chunk-YJ5IA5YQ.js";
+import "../safe-bash/command-chunks/chunk-N6TG44VG.js";
 import "../safe-bash/command-chunks/chunk-E3DF7RTE.js";
 import "../safe-bash/command-chunks/chunk-AQ3XOOPQ.js";
 import "../safe-bash/command-chunks/chunk-ITXSHOLP.js";
@@ -11,7 +12,6 @@ import "../safe-bash/command-chunks/chunk-F5QYUK2E.js";
 import "../safe-bash/command-chunks/chunk-VWRHPDCD.js";
 import "../safe-bash/command-chunks/chunk-GNT3SCF3.js";
 import "../safe-bash/command-chunks/chunk-ZOEKSH3R.js";
-import "../safe-bash/command-chunks/chunk-N6TG44VG.js";
 import "../safe-bash/command-chunks/chunk-5VO534FR.js";
 import "../safe-bash/command-chunks/chunk-KK2T6Z7J.js";
 import "../safe-bash/command-chunks/chunk-V72MXW7X.js";

package/dist/safe-bash-query-engine/query-core.js

@@ -1,20 +1,20 @@
 import {
   YqValueFailure,
   createYqQuerySession
-} from "../safe-bash/command-chunks/chunk-WTE23QXN.js";
-import "../safe-bash/command-chunks/chunk-NJ4NTTCR.js";
+} from "../safe-bash/command-chunks/chunk-6ZGCKUAM.js";
+import "../safe-bash/command-chunks/chunk-77NXQZGK.js";
+import "../safe-bash/command-chunks/chunk-LNLACEAN.js";
 import "../safe-bash/command-chunks/chunk-DRHONH2C.js";
 import "../safe-bash/command-chunks/chunk-EBX5RKKT.js";
 import "../safe-bash/command-chunks/chunk-YJ5IA5YQ.js";
+import "../safe-bash/command-chunks/chunk-N6TG44VG.js";
 import "../safe-bash/command-chunks/chunk-E3DF7RTE.js";
 import "../safe-bash/command-chunks/chunk-AQ3XOOPQ.js";
 import "../safe-bash/command-chunks/chunk-ITXSHOLP.js";
-import "../safe-bash/command-chunks/chunk-77NXQZGK.js";
 import "../safe-bash/command-chunks/chunk-F5QYUK2E.js";
 import "../safe-bash/command-chunks/chunk-VWRHPDCD.js";
 import "../safe-bash/command-chunks/chunk-GNT3SCF3.js";
 import "../safe-bash/command-chunks/chunk-ZOEKSH3R.js";
-import "../safe-bash/command-chunks/chunk-N6TG44VG.js";
 import "../safe-bash/command-chunks/chunk-5VO534FR.js";
 import "../safe-bash/command-chunks/chunk-KK2T6Z7J.js";
 import "../safe-bash/command-chunks/chunk-V72MXW7X.js";

package/dist/safe-bash-regex-engine/index.js

@@ -6,7 +6,7 @@ import {
   trySubstitutePairSync,
   trySubstitutePairToBufferSync,
   trySubstituteSync
-} from "../safe-bash/command-chunks/chunk-MMBZTYXO.js";
+} from "../safe-bash/command-chunks/chunk-2PQRZDNR.js";
 import "../safe-bash/command-chunks/chunk-CPVPK4JE.js";
 import {
   RustPatternError,

package/dist/safe-bash-regex-engine/python-glob.js

@@ -1,6 +1,6 @@
 import {
   Pattern
-} from "../safe-bash/command-chunks/chunk-MMBZTYXO.js";
+} from "../safe-bash/command-chunks/chunk-2PQRZDNR.js";
 import "../safe-bash/command-chunks/chunk-CPVPK4JE.js";
 import "../safe-bash/command-chunks/chunk-B4GWKTPC.js";
 import "../safe-bash/command-chunks/chunk-TCDWTX76.js";

package/dist/safe-bash-regex-engine/text/regex.d.ts

@@ -10,6 +10,16 @@ export interface Match {
     readonly groups: readonly (string | undefined)[];
     readonly captureOffsets?: readonly (number | undefined)[];
 }
+/** Caller-owned replay text and deduplicated work queue. All offsets are UTF-16.
+ * enqueue must copy its state before resolving and suppress previously seen
+ * identical states (including NaN slots), even after they have been dequeued.
+ * Each invocation requires a fresh queue; read returns the exact requested span. */
+export interface StoredPatternInput {
+    readonly length: number;
+    read(start: number, length: number): Promise<string>;
+    enqueue(state: readonly number[]): Promise<void>;
+    dequeue(): Promise<number[] | undefined>;
+}
 type PatternBudget = Pick<Budget, "step" | "maxBufferBytes"> & {
     readonly options?: PatternLimits;
 } & Partial<Pick<Budget, "checkpointSync">> & {
@@ -59,6 +69,13 @@ export declare class Pattern {
     tryFindSync(text: string, budget: PatternBudget, from?: number): Match | undefined | Promise<Match | undefined>;
     tryTestSync(text: string, budget: PatternBudget, textStart?: number, textEnd?: number): boolean | Promise<boolean>;
     private execSimpleRepeat;
+    supportsStoredTest(budget: PatternBudget): Promise<boolean>;
+    /** Replay captures as bounded spans; input-dependent search state belongs to the caller. */
+    testStored(source: StoredPatternInput, budget: PatternBudget): Promise<boolean>;
+    /** Existence-only streaming does not retain captures or the input text. */
+    supportsStreamTest(budget: PatternBudget): Promise<boolean>;
+    /** Working state is proportional to the compiled pattern, independent of input size. */
+    testStream(source: AsyncIterable<string>, budget: PatternBudget): Promise<boolean>;
     find(text: string, budget: PatternBudget, from?: number, continuation?: number): Promise<Match | undefined>;
 }
 type ReplacementSyntax = "sed" | "awk";
@@ -87,6 +104,8 @@ export declare class BytePattern extends Pattern {
     private input;
     private byteMatch;
     prepare(budget: Parameters<Pattern["prepare"]>[0]): Promise<void>;
+    supportsStreamTest(budget: PatternBudget): Promise<boolean>;
+    supportsStoredTest(budget: PatternBudget): Promise<boolean>;
     canFindSync(): boolean;
     getFastPrefixInfo(): ReturnType<Pattern["getFastPrefixInfo"]>;
     findSyncFastInto(text: string, budget: Parameters<Pattern["findSyncFastInto"]>[1], from: number, outOffsets: Int32Array, textEnd?: number, textStart?: number): boolean;

package/dist/safe-bash-regex-engine/text/regex.js

@@ -6,7 +6,7 @@ import {
   trySubstitutePairSync,
   trySubstitutePairToBufferSync,
   trySubstituteSync
-} from "../../safe-bash/command-chunks/chunk-MMBZTYXO.js";
+} from "../../safe-bash/command-chunks/chunk-2PQRZDNR.js";
 import "../../safe-bash/command-chunks/chunk-CPVPK4JE.js";
 import "../../safe-bash/command-chunks/chunk-B4GWKTPC.js";
 import "../../safe-bash/command-chunks/chunk-TCDWTX76.js";

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

@@ -1,8 +1,8 @@
 import {
   serializeDocument
-} from "../safe-bash/command-chunks/chunk-D2ASPM7R.js";
-import "../safe-bash/command-chunks/chunk-D2KZ66W4.js";
-import "../safe-bash/command-chunks/chunk-JYUJAF4L.js";
+} from "../safe-bash/command-chunks/chunk-FF7UGJWS.js";
+import "../safe-bash/command-chunks/chunk-PIVH35EQ.js";
+import "../safe-bash/command-chunks/chunk-CSE4VQKG.js";
 import "../safe-bash/command-chunks/chunk-3I5WTVWZ.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {

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

@@ -6,7 +6,7 @@ import {
   serialize,
   serializeSimpleSync,
   stringValue
-} from "../safe-bash/command-chunks/chunk-JYUJAF4L.js";
+} from "../safe-bash/command-chunks/chunk-CSE4VQKG.js";
 import "../safe-bash/command-chunks/chunk-3I5WTVWZ.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {

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

@@ -2,3 +2,4 @@ export * from "./limits.js";
 export * from "./query.js";
 export * from "./evaluate.js";
 export * from "./document.js";
+export { parseStoredXml, parseXmlRecovery } from "./recovery.js";

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

@@ -1,10 +1,12 @@
+import {
+  parseQuery
+} from "../safe-bash/command-chunks/chunk-WJ2ERUCQ.js";
 import {
   serializeDocument
-} from "../safe-bash/command-chunks/chunk-D2ASPM7R.js";
-import "../safe-bash/command-chunks/chunk-D2KZ66W4.js";
+} from "../safe-bash/command-chunks/chunk-FF7UGJWS.js";
 import {
-  parseQuery
-} from "../safe-bash/command-chunks/chunk-MIRL7HTF.js";
+  parseStoredXml
+} from "../safe-bash/command-chunks/chunk-PIVH35EQ.js";
 import {
   escape,
   evaluate,
@@ -13,7 +15,7 @@ import {
   serialize,
   serializeSimpleSync,
   stringValue
-} from "../safe-bash/command-chunks/chunk-JYUJAF4L.js";
+} from "../safe-bash/command-chunks/chunk-CSE4VQKG.js";
 import {
   XmlBudget,
   XmlQueryError,
@@ -32,6 +34,8 @@ export {
   evaluateScalar,
   formatScalar,
   parseQuery,
+  parseStoredXml,
+  parseStoredXml as parseXmlRecovery,
   resolveXmlQueryLimits,
   serialize,
   serializeDocument,

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

@@ -1,7 +1,7 @@
 import {
   parseQuery
-} from "../safe-bash/command-chunks/chunk-MIRL7HTF.js";
-import "../safe-bash/command-chunks/chunk-JYUJAF4L.js";
+} from "../safe-bash/command-chunks/chunk-WJ2ERUCQ.js";
+import "../safe-bash/command-chunks/chunk-CSE4VQKG.js";
 import "../safe-bash/command-chunks/chunk-3I5WTVWZ.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {

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

@@ -0,0 +1,10 @@
+import { parseXmlSourceSteps, type XmlElement } from "@poe-platform/safe-fs/core";
+import { type PagedStorageContext } from "@poe-platform/safe-fs/storage";
+import { XmlBudget } from "./limits.js";
+type XmlEvent = Parameters<NonNullable<NonNullable<Parameters<typeof parseXmlSourceSteps>[1]>["events"]>>[0];
+/** Parse lazy input, or prevalidated recovery input, through a shared 64 KiB source/frame cache.
+ * The parser retains only its current source window, tokens and the current frame. */
+export declare function parseStoredXml(source: AsyncIterable<string> | Iterable<string>, context: PagedStorageContext & {
+    readonly registerCleanup?: (cleanup: () => Promise<void>) => void;
+}, budget: XmlBudget, recover?: (message: string) => void, consume?: (event: XmlEvent) => Promise<void>): Promise<XmlElement>;
+export { parseStoredXml as parseXmlRecovery };

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

@@ -18,13 +18,13 @@ export declare class StoredXmlDocument {
     get document(): number;
     static parse(source: AsyncIterable<string> | Iterable<string>, context: PagedStorageContext & {
         readonly registerCleanup?: (cleanup: () => Promise<void>) => void;
-    }, budget: XmlBudget, pages?: number): Promise<StoredXmlDocument>;
+    }, budget: XmlBudget, pages?: number, recover?: (message: string) => void): Promise<StoredXmlDocument>;
     private field;
     private set;
     private append;
     node(reference: number): Promise<XmlContent | StoredXmlAttribute>;
-    /** Logical text may span many original parser tokens after CDATA conversion.
-     * Replay their bodies without making a concatenated node value. */
+    /** Content bodies may span parser fragments or coalesced text tokens.
+     * Replay them without making a concatenated node value. */
     text(reference: number): AsyncGenerator<string>;
     /** Apply tree transformations by changing stored links. Whitespace inheritance
      * lives on each parent record; merged text remains a chain of token bodies. */

package/dist/safe-bash-xml-engine/stored-document.js

@@ -1,6 +1,6 @@
 import {
   StoredXmlDocument
-} from "../safe-bash/command-chunks/chunk-D2KZ66W4.js";
+} from "../safe-bash/command-chunks/chunk-PIVH35EQ.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {
   StoredXmlDocument

package/dist/safe-bash-xml-engine/stored-evaluate.js

@@ -3,7 +3,7 @@ import {
   expressionText,
   formatScalar,
   testPredicate
-} from "../safe-bash/command-chunks/chunk-JYUJAF4L.js";
+} from "../safe-bash/command-chunks/chunk-CSE4VQKG.js";
 import {
   XmlQueryError
 } from "../safe-bash/command-chunks/chunk-3I5WTVWZ.js";

package/dist/safe-bash-zip-engine/zip/repair.js

@@ -1,6 +1,9 @@
 import {
   ArchiveMetadataMap
 } from "../../safe-bash/command-chunks/chunk-MLOYXEKT.js";
+import {
+  ZipFailure
+} from "../../safe-bash/command-chunks/chunk-4REP6ZW6.js";
 import {
   decodeZipEntry,
   readZipArchive,
@@ -21,9 +24,6 @@ import "../../safe-bash/command-chunks/chunk-CFK5CVU7.js";
 import "../../safe-bash/command-chunks/chunk-7OZAH3MX.js";
 import "../../safe-bash/command-chunks/chunk-ZNVKI6FP.js";
 import "../../safe-bash/command-chunks/chunk-RYNTNJMA.js";
-import {
-  ZipFailure
-} from "../../safe-bash/command-chunks/chunk-4REP6ZW6.js";
 import "../../safe-bash/command-chunks/chunk-65DS4IOB.js";
 
 // packages/safe-bash-zip-engine/src/zip/repair.ts

package/dist/safe-bash-zip-engine/zip/volumes.js

@@ -6,6 +6,9 @@ import {
   sameZipIdentity,
   stageZip
 } from "../../safe-bash/command-chunks/chunk-IHLZ6HNQ.js";
+import {
+  ZipFailure
+} from "../../safe-bash/command-chunks/chunk-4REP6ZW6.js";
 import {
   ZipRanges
 } from "../../safe-bash/command-chunks/chunk-FVQFB7OD.js";
@@ -13,9 +16,6 @@ import {
   zip64Fields,
   zip64RangeDirectory
 } from "../../safe-bash/command-chunks/chunk-3I3PD6VU.js";
-import {
-  ZipFailure
-} from "../../safe-bash/command-chunks/chunk-4REP6ZW6.js";
 import "../../safe-bash/command-chunks/chunk-65DS4IOB.js";
 
 // packages/safe-bash-zip-engine/src/zip/volumes.ts

package/dist/spreadsheet-engine/datasource.js

@@ -91,6 +91,20 @@ export async function openDatasourceSession(capability, context) {
                 }
                 return values.has(key) ? numericResult(values.get(key)) : { kind: "error", value: "#N/A" };
             } } });
+    // Unlink before every actual evaluation, even when its selected branch never
+    // calls ATL_LAST. Calls within that evaluation rebuild all active tag links.
+    const unlink = (position) => {
+        const cell = JSON.stringify([position.sheet, position.row, position.column]);
+        for (const tag of observed.get(cell)?.tags ?? []) {
+            tick();
+            if (watchers.get(tag)?.delete(cell)) {
+                watcherCount--;
+                if (!watchers.get(tag).size)
+                    watchers.delete(tag);
+            }
+        }
+        observed.delete(cell);
+    };
     const calculationContext = { ...context, runtimeFunctions: { ...context.runtimeFunctions, ...runtimeFunctions } };
     return Object.freeze({ runtimeFunctions, async poll(book) {
             tick();
@@ -118,7 +132,7 @@ export async function openDatasourceSession(capability, context) {
                             }
                         observed.delete(cell);
                     }
-                book = await recalculateWithDiagnostics(book, calculationContext, !linked);
+                book = await recalculateWithDiagnostics(book, calculationContext, !linked, unlink);
                 tick();
                 linked = true;
                 if (!transport)
@@ -191,7 +205,7 @@ export async function openDatasourceSession(capability, context) {
                             tick();
                             return changed.has(JSON.stringify([sheet.id, cell.row, cell.column])) ? { ...cell, formulaDirty: true } : cell;
                         }) })) };
-                const result = await recalculateWithDiagnostics(dirty, calculationContext);
+                const result = await recalculateWithDiagnostics(dirty, calculationContext, false, unlink);
                 tick();
                 return result;
             }

package/dist/spreadsheet-engine/formulas/diagnostics.d.ts

@@ -1,5 +1,6 @@
 import { type CapabilityContext } from "../contracts.js";
 import type { Workbook } from "../../spreadsheet-ast/index.js";
+import type { ParsePosition } from "./ast.js";
 import type { FormulaRecalculationOptions } from "../formulas.js";
 /** Synchronous calculation notices settle in order before any export or failure. */
-export declare function recalculateWithDiagnostics(book: Workbook, context: CapabilityContext, options?: boolean | FormulaRecalculationOptions): Promise<Workbook>;
+export declare function recalculateWithDiagnostics(book: Workbook, context: CapabilityContext, options?: boolean | FormulaRecalculationOptions, onEvaluate?: (position: ParsePosition) => void): Promise<Workbook>;

package/dist/spreadsheet-engine/formulas/diagnostics.js

@@ -1,7 +1,7 @@
 import { SsconvertError } from "../contracts.js";
 import { recalculateWorkbook } from "./recalculation.js";
 /** Synchronous calculation notices settle in order before any export or failure. */
-export async function recalculateWithDiagnostics(book, context, options = false) {
+export async function recalculateWithDiagnostics(book, context, options = false, onEvaluate) {
     const notices = [];
     let bytes = 0;
     try {
@@ -10,7 +10,7 @@ export async function recalculateWithDiagnostics(book, context, options = false)
             if (bytes > context.limits.outputBytes)
                 throw new SsconvertError("resource-limit", "ssconvert diagnostic bytes limit exceeded");
             notices.push(diagnostic);
-        });
+        }, undefined, onEvaluate);
     }
     finally {
         for (const notice of notices) {

package/dist/spreadsheet-engine/formulas/evaluator.d.ts

@@ -8,6 +8,6 @@ export declare function recalculateWorkbookSteps(input: Workbook, context: Capab
     readonly target: ParsePosition | readonly ParsePosition[] | null;
     readonly tick?: () => void;
     readonly onCycle?: () => void;
-}): Generator<void, Workbook>;
+}, onEvaluate?: (position: ParsePosition) => void): Generator<void, Workbook>;
 /** Synchronous evaluator for numerical callbacks that require immediate values. */
 export declare function recalculateWorkbook(...args: Parameters<typeof recalculateWorkbookSteps>): Workbook;

package/dist/spreadsheet-engine/formulas/evaluator.js

@@ -17,7 +17,7 @@ import { callFunction } from "./functions/registry.js";
 import { matchNumber } from "./functions/text.js";
 import { gnumericGrammar, sylkGrammar } from "./conventions.js";
 /** A calculation run owns its indexes, traversal state and caches. No host I/O. */
-export function* recalculateWorkbookSteps(input, context, options = false, onDiagnostic, cellEvaluation) {
+export function* recalculateWorkbookSteps(input, context, options = false, onDiagnostic, cellEvaluation, onEvaluate) {
     context.signal.throwIfAborted();
     const force = typeof options === "boolean" ? options : options.force;
     if (context.runtimeFunctions !== undefined)
@@ -677,6 +677,7 @@ export function* recalculateWorkbookSteps(input, context, options = false, onDia
                 const key = `${sheet.id}:${group?.id ?? ""}`;
                 let value = group ? matrices.get(key) : undefined;
                 if (!value) {
+                    onEvaluate?.(position);
                     value = evaluate(node, position, Boolean(group));
                     if (group)
                         matrices.set(key, value);

package/dist/spreadsheet-engine/formulas/functions/python-printf.js

@@ -1,5 +1,6 @@
 import { SsconvertError } from "../../contracts.js";
 import { boundedText } from "./common.js";
+import { rendered } from "../values.js";
 import { nonPrintable } from "./python-printf-profile.js";
 import { inUnicodeRanges } from "./python-unicode-profile.js";
 class PythonFormatError extends Error {
@@ -20,49 +21,66 @@ function floatText(value) {
     const text = String(value);
     return text.includes(".") ? text : text + ".0";
 }
-function pythonText(profile, value, repr, ascii, host, precision) {
+function* pythonText(profile, value, repr, ascii, host) {
     host.tick();
-    if (value === null)
-        return "None";
-    if (typeof value === "number")
-        return floatText(value);
-    if (typeof value === "boolean")
-        return value ? "True" : "False";
+    if (value === null) {
+        yield* "None";
+        return;
+    }
+    if (typeof value === "number") {
+        yield* floatText(value);
+        return;
+    }
+    if (typeof value === "boolean") {
+        yield* value ? "True" : "False";
+        return;
+    }
     if (typeof value === "object") {
         if ("range" in value) {
-            // The native default repr includes an address. Precision can exclude
-            // every address digit while retaining a portable, source-defined prefix.
-            const prefix = "<RangeRef object at 0x";
-            if (precision !== undefined && precision <= prefix.length)
-                return prefix.slice(0, precision);
+            // Precision may stop before the address, whose native bytes are unstable.
+            yield* "<RangeRef object at 0x";
             throw new SsconvertError("unsupported-feature", "Unsupported ssconvert feature: Python RangeRef object representation");
         }
-        return "[" + value.columns.map(column => "[" + column.map(cell => pythonText(profile, cell, true, ascii, host)).join(", ") + "]").join(", ") + "]";
+        yield "[";
+        for (let column = 0; column < value.columns.length; column++) {
+            if (column)
+                yield* ", ";
+            yield "[";
+            const cells = value.columns[column];
+            for (let row = 0; row < cells.length; row++) {
+                if (row)
+                    yield* ", ";
+                yield* pythonText(profile, cells[row], true, ascii, host);
+            }
+            yield "]";
+        }
+        yield "]";
+        return;
+    }
+    if (!repr) {
+        yield* value;
+        return;
     }
-    if (!repr)
-        return value;
     const quote = value.includes("'") && !value.includes('"') ? '"' : "'";
-    let result = quote;
+    yield quote;
     for (const char of value) {
         host.tick();
         const code = char.codePointAt(0);
         if (char === quote || char === "\\")
-            result += "\\" + char;
+            yield* "\\" + char;
         else if (char === "\n")
-            result += "\\n";
+            yield* "\\n";
         else if (char === "\r")
-            result += "\\r";
+            yield* "\\r";
         else if (char === "\t")
-            result += "\\t";
+            yield* "\\t";
         else if (ascii && code > 127 || inUnicodeRanges(code, nonPrintable) || inUnicodeRanges(code, profile.nonPrintable))
-            result += code <= 255 ? "\\x" + code.toString(16).padStart(2, "0") : code <= 65535 ?
+            yield* code <= 255 ? "\\x" + code.toString(16).padStart(2, "0") : code <= 65535 ?
                 "\\u" + code.toString(16).padStart(4, "0") : "\\U" + code.toString(16).padStart(8, "0");
         else
-            result += char;
-        if (result.length > host.context.limits.outputBytes)
-            throw new SsconvertError("resource-limit", "ssconvert calculation text limit exceeded");
+            yield char;
     }
-    return result + quote;
+    yield quote;
 }
 function pythonValue(value, host, argument = true) {
     host.tick();
@@ -81,7 +99,7 @@ function pythonValue(value, host, argument = true) {
         return { columns: Array.from({ length: rows[0]?.length ?? 0 }, (_, column) => rows.map(row => pythonValue(row[column], host, false))) };
     }
     // Both Python C-string acquisition and returned Gnumeric strings stop at NUL.
-    return typeof value.value === "string" ? value.value.split("\0", 1)[0] : value.value;
+    return typeof value.value === "string" ? rendered(value).split("\0", 1)[0] : value.value;
 }
 function decimalRatio(value) {
     const view = new DataView(new ArrayBuffer(8));
@@ -234,16 +252,21 @@ export function pythonPrintf(profile, args, host) {
             const value = take();
             let text, sign = "", prefix = "", numeric = false;
             if ("sra".includes(conversion)) {
-                text = pythonText(profile, value, conversion !== "s", conversion === "a", host, precision);
-                if (precision !== undefined) {
-                    let count = 0, truncated = "";
-                    for (const char of text) {
+                const representation = pythonText(profile, value, conversion !== "s", conversion === "a", host);
+                text = "";
+                try {
+                    for (let count = 0; precision === undefined || count < precision; count++) {
                         host.tick();
-                        if (count++ >= precision)
+                        const next = representation.next();
+                        if (next.done)
                             break;
-                        truncated += char;
+                        text += next.value;
+                        if (text.length > limit)
+                            throw new SsconvertError("resource-limit", "ssconvert calculation text limit exceeded");
                     }
-                    text = truncated;
+                }
+                finally {
+                    representation.return(undefined);
                 }
             }
             else if (conversion === "c") {

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

@@ -8,5 +8,5 @@ export declare function encryptedBiffPropertyStream(streams: ReadonlyMap<string,
  * 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 retained ciphertext and descriptor bytes directly into caller storage.
- * Parsed descriptors and names remain resident; plaintext transfers are bounded. */
+ * Parsed descriptors, duplicate names and overlap order use caller-backed indexes. */
 export declare function decryptBiffPropertySources(encrypted: Uint8Array | RangeSource, createCipher: (block: number) => BiffRc4Cipher, context: CapabilityContext, charge: (amount: number) => void): Promise<ReadonlyMap<string, BiffPropertySource>>;