@embedpdf/engine-services 3.0.0-next.10 → 3.0.0-next.11

package/dist/index.d.cts

@@ -1396,22 +1396,38 @@ declare class SearchReader {
 }
 //#endregion
 //#region src/features/actions/ActionModelReader.d.ts
-/** Mutable aggregate budget shared by every action model in one read job. */
+/** Mutable aggregate budget shared by every action model in one read job.
+ *  Payload budgets are RESERVED before the backing buffer is allocated. */
 declare class ActionReadBudgetTracker {
   private readonly limits;
   private models;
   private nodes;
   private scriptCodeUnits;
+  private targetEntries;
+  private payloadCodeUnits;
   constructor(limits?: ActionReadBudget);
   addModel(nodeCount: number): void;
   addScript(script: string): void;
+  /** Charge target entries BEFORE the target array is walked. */
+  reserveTargets(count: number): void;
+  /** Charge payload text BEFORE the scratch buffer for it is allocated. */
+  reservePayloadBytes(length: number): void;
   private assertWithinBudget;
 }
 /**
  * Convert and close one detached native action model. This is the only
  * native-model walker used by document, page, field, and annotation reads.
+ *
+ * `docPtr` resolves `goto` destinations (page identity + named-destination
+ * lookup); every caller reads within an open document session.
+ *
+ * Payload rule: a node whose payload cannot be materialised (a goto without
+ * a resolvable destination, a javascript node with no `/JS`, a withheld
+ * target list) degrades to `{ type: 'unknown' }` with its original `/S` on
+ * `subtype`, and the tree gains the `'payload-dropped'` warning — impossible
+ * states stay unrepresentable while malformed documents stay readable.
  */
-declare function readActionModel(fn: PdfFunctions, mem: PdfRuntimeMemory, modelPtr: Ptr, budget: ActionReadBudgetTracker): PdfActionTree | null;
+declare function readActionModel(fn: PdfFunctions, mem: PdfRuntimeMemory, docPtr: Ptr, modelPtr: Ptr, budget: ActionReadBudgetTracker): PdfActionTree | null;
 //#endregion
 //#region src/features/actions/DocumentActionsReader.d.ts
 /** Read catalog-owned actions. Extraction only; no action is executed. */

package/dist/index.d.ts

@@ -1396,22 +1396,38 @@ declare class SearchReader {
 }
 //#endregion
 //#region src/features/actions/ActionModelReader.d.ts
-/** Mutable aggregate budget shared by every action model in one read job. */
+/** Mutable aggregate budget shared by every action model in one read job.
+ *  Payload budgets are RESERVED before the backing buffer is allocated. */
 declare class ActionReadBudgetTracker {
   private readonly limits;
   private models;
   private nodes;
   private scriptCodeUnits;
+  private targetEntries;
+  private payloadCodeUnits;
   constructor(limits?: ActionReadBudget);
   addModel(nodeCount: number): void;
   addScript(script: string): void;
+  /** Charge target entries BEFORE the target array is walked. */
+  reserveTargets(count: number): void;
+  /** Charge payload text BEFORE the scratch buffer for it is allocated. */
+  reservePayloadBytes(length: number): void;
   private assertWithinBudget;
 }
 /**
  * Convert and close one detached native action model. This is the only
  * native-model walker used by document, page, field, and annotation reads.
+ *
+ * `docPtr` resolves `goto` destinations (page identity + named-destination
+ * lookup); every caller reads within an open document session.
+ *
+ * Payload rule: a node whose payload cannot be materialised (a goto without
+ * a resolvable destination, a javascript node with no `/JS`, a withheld
+ * target list) degrades to `{ type: 'unknown' }` with its original `/S` on
+ * `subtype`, and the tree gains the `'payload-dropped'` warning — impossible
+ * states stay unrepresentable while malformed documents stay readable.
  */
-declare function readActionModel(fn: PdfFunctions, mem: PdfRuntimeMemory, modelPtr: Ptr, budget: ActionReadBudgetTracker): PdfActionTree | null;
+declare function readActionModel(fn: PdfFunctions, mem: PdfRuntimeMemory, docPtr: Ptr, modelPtr: Ptr, budget: ActionReadBudgetTracker): PdfActionTree | null;
 //#endregion
 //#region src/features/actions/DocumentActionsReader.d.ts
 /** Read catalog-owned actions. Extraction only; no action is executed. */