@poe-platform/safe-bash 0.1.813 → 0.1.814

package/dist/image-ast/index.js

@@ -1890,7 +1890,7 @@ async function openPdfImage(source, fs, directory, signal, options, storage) {
     if (failure) throw failure.error;
   };
   try {
-    document = await PdfRetainedDocument.open(retained, { fs, directory }, { signal, recovery: "repair", compactNumbers: !0, compactKeywords: !0, chunkBytes: 16384, maxNodes: 1 / 0, maxTokenBytes: 1 / 0, maxRecursionDepth: 1 / 0, maxPageTreeDepth: 1 / 0, xref: { arrayStorage: values, storedArrayKeys: ["Index"] }, valueArrays: { dictionaryStorage: values, storedDictionaryKeys: ["Font"], containerStorage: values, stringStorage: values, storedStringKeys: ["ActualText"], arrayStorage: values, storedArrayKeys: ["Contents", "Annots", "Kids", "Widths", "W", "Differences", "ON", "OFF", "OCGs"], storedArrayPaths: [["ExtGState", "*", "D"]] } });
+    document = await PdfRetainedDocument.open(retained, { fs, directory }, { signal, recovery: "repair", compactNumbers: !0, compactKeywords: !0, chunkBytes: 16384, maxNodes: 1 / 0, maxTokenBytes: 1 / 0, maxRecursionDepth: 1 / 0, maxPageTreeDepth: 1 / 0, xref: { arrayStorage: values, storedArrayKeys: ["Index"] }, valueArrays: { dictionaryStorage: values, storedDictionaryKeys: ["Font", "XObject", "Properties"], containerStorage: values, stringStorage: values, storedStringKeys: ["ActualText"], arrayStorage: values, storedArrayKeys: ["Contents", "Annots", "Kids", "Widths", "W", "Differences", "ON", "OFF", "OCGs"], storedArrayPaths: [["ExtGState", "*", "D"]] } });
     let pages = 0, selected;
     for await (let page of document.pages())
       pages++, page.index <= Math.max(0, settings.page ?? 0) && (selected = page);

package/dist/mp4-ast/index.d.ts

@@ -2,9 +2,11 @@ export * from "./types.js";
 export * from "./binary.js";
 export * from "./codecs.js";
 export * from "./mp4.js";
+export * from "./mp4-source.js";
 export * from "./containers/mkv.js";
 export * from "./containers/mpegts.js";
 export * from "./containers/avi.js";
 export * from "./containers/adapters.js";
 export * from "./containers/streaming.js";
 export { decodeH264Samples } from "./h264.js";
+export { scanMp4SampleTable, type Mp4SampleTables, type Mp4TableRange, type Mp4SampleSpan, type Mp4SampleScanOptions } from "./mp4-sample-source.js";

package/dist/mp4-ast/mp4-sample-source.d.ts

@@ -0,0 +1,52 @@
+import type { MediaBudgetTracker, MediaProbeSource, MediaTrackType } from './types.js';
+export interface Mp4TableRange {
+    readonly payloadOffset: number;
+    readonly payloadSize: number;
+}
+export type Mp4SampleTables = Partial<Record<'stts' | 'ctts' | 'stsc' | 'stsz' | 'stco' | 'co64' | 'stss', Mp4TableRange>>;
+export interface Mp4SampleSpan {
+    readonly offset: number;
+    readonly size: number;
+    readonly dts: number;
+    readonly pts: number;
+    readonly cts: number;
+    readonly duration: number;
+    readonly isKeyframe: boolean;
+    readonly sampleDescriptionIndex: number;
+}
+export interface Mp4SampleScanOptions {
+    readonly type?: MediaTrackType;
+    readonly signal?: AbortSignal;
+    readonly budget?: MediaBudgetTracker;
+    readonly checkpoint?: () => void | Promise<void>;
+    /** Fresh caller-owned membership index for this track. Required for nonempty stss. */
+    readonly syncSamples?: {
+        add(sample: number): void | Promise<void>;
+        has(sample: number): boolean | Promise<boolean>;
+    };
+}
+type Step = {
+    kind: 'read';
+    offset: number;
+    length: number;
+    table?: Mp4TableRange;
+} | {
+    kind: 'sync-add';
+    sample: number;
+} | {
+    kind: 'sync-has';
+    sample: number;
+} | {
+    kind: 'sample';
+    sample: Mp4SampleSpan;
+};
+type Steps<T> = Generator<Step, T, Uint8Array | boolean | undefined>;
+/** One traversal shared by the resident parser and asynchronous caller ranges. */
+export declare function mp4SampleTableSteps(size: number, tables: Mp4SampleTables, options?: Pick<Mp4SampleScanOptions, 'type' | 'budget'>): Steps<void>;
+/**
+ * Replay a classic (non-fragmented) stbl without materializing tables or payloads.
+ * At most seven 16 KiB table pages are cached; sync membership belongs to the caller.
+ * Input/index lifetime, publication after validation, and fragmented runs remain caller-owned.
+ */
+export declare function scanMp4SampleTable(source: MediaProbeSource, tables: Mp4SampleTables, options?: Mp4SampleScanOptions): AsyncGenerator<Mp4SampleSpan, void>;
+export {};

package/dist/mp4-ast/mp4-source.d.ts

@@ -0,0 +1,32 @@
+import type { MediaBudgetTracker, MediaProbeSource } from "./types.js";
+/** Physical ranges in the original caller-owned source; payload bytes stay there. */
+export interface Mp4BoxSpan {
+    readonly type: string;
+    readonly offset: number;
+    readonly size: number;
+    readonly headerSize: number;
+    readonly payloadOffset: number;
+    readonly payloadSize: number;
+    readonly uuid?: Uint8Array;
+    readonly children?: {
+        readonly offset: number;
+        readonly length: number;
+        readonly depth: number;
+    };
+}
+export interface Mp4BoxScanOptions {
+    readonly offset?: number;
+    readonly length?: number;
+    readonly depth?: number;
+    readonly signal?: AbortSignal;
+    readonly budget?: MediaBudgetTracker;
+    readonly checkpoint?: () => void | Promise<void>;
+}
+/**
+ * Scan siblings lazily, using at most 16-byte reads and no payload/tree arrays.
+ * Pass a returned children range to another scan to inspect that container.
+ * The caller owns source lifetime, input admission and any traversal backing.
+ * Spans may precede a later I/O failure; callers must finish validation before publication.
+ * Like parseMp4Boxes, clips malformed lengths and ignores incomplete headers.
+ */
+export declare function scanMp4Boxes(source: MediaProbeSource, options?: Mp4BoxScanOptions): AsyncGenerator<Mp4BoxSpan, void>;

package/dist/office-xml/retained-xml-document.d.ts

@@ -14,6 +14,12 @@ export interface RetainedXmlDocument {
     node(id: number): Promise<RetainedXmlNode>;
     /** The factory must replay the same immutable prefix bytes. */
     resolveNamespace(node: RetainedXmlNode, prefix: () => ByteSource): Promise<ByteSource | undefined>;
+    /** All document nodes in source order, including prolog/epilog text. Depth
+     * counts containing elements, including the node itself for element nodes. */
+    nodes(): AsyncGenerator<{
+        readonly node: RetainedXmlNode;
+        readonly depth: number;
+    }>;
     children(node: RetainedXmlNode): AsyncGenerator<RetainedXmlNode>;
     attributes(node: RetainedXmlNode): AsyncGenerator<RetainedXmlNode>;
     /** Local xmlns attributes, in source order. */

package/dist/pdf-ast/content/evaluator.d.ts

@@ -155,6 +155,10 @@ interface EvaluationFrame {
     savedState?: GraphicsState;
 }
 export type PdfEvaluationRequest = {
+    readonly kind: "dictionary-value";
+    readonly dict: PdfCosDict;
+    readonly key: string;
+} | {
     readonly kind: "array-reference";
     readonly items: import("../ast.js").PdfStoredItems;
     readonly objectNumber: number;

package/dist/pdf-ast/cos/object-reader.d.ts

@@ -17,6 +17,8 @@ export interface PdfObjectReaderOptions extends Omit<ParseCosRangeOptions, "reso
     /** Aggregate decoded object-stream data and header tape bytes. */
     readonly maxStagingBytes?: number;
     readonly maxObjectStreamMembers?: number;
+    /** Live ancestor-index staging for each indirect length traversal. */
+    readonly maxTraversalStagingBytes?: number;
 }
 /** Raw indexed COS access. The source and xref index remain caller-owned.
  * Only decoded object streams are cached; each returned AST belongs to its
@@ -29,6 +31,7 @@ export declare class PdfObjectReader {
     private readonly storage;
     private readonly streams;
     private readonly backingFailures;
+    private readonly lengthPaths;
     private readonly repairedOffsets;
     private readonly options;
     private readonly capacity;
@@ -42,6 +45,10 @@ export declare class PdfObjectReader {
     /** Decode one retained stream under consumer backpressure. The caller owns
      * the source and must keep it open until iteration finishes. */
     decodeStream(objectNumber: number, generationNumber?: number, options?: Pick<PdfStreamDecodeOptions, "stopBeforeImageCodec" | "raw">): AsyncGenerator<Uint8Array, void, void>;
+    /** A stream-valued /Length is invalid as a length, but its references still
+     * need cycle, admission and backing-error validation. Walk those discarded
+     * values in source order instead of retaining one parser and AST per link. */
+    private resolveLength;
     private load;
     /** Discover compressed members after authentication, without retaining a
      * member array. Each pull re-enters the serialized cache before reading. */

package/dist/pdf-ast/cos/value-parser.d.ts

@@ -2,6 +2,7 @@ import type { PdfCosNode, PdfCosDict, PdfDictEntry, PdfPixelStorage, PdfStoredIt
 import type { CosToken } from "./lexer.js";
 export interface ValueArrayStorage {
     readonly dictionaryStorage?: PdfPixelStorage;
+    /** Select resource maps; their entry names are data, not nested map selectors. */
     readonly storedDictionaryKeys?: readonly string[];
     readonly storeRootDictionary?: boolean;
     readonly arrayStorage?: PdfPixelStorage;

package/dist/pdf-ast/edit/retained-form-appearances.d.ts

@@ -0,0 +1,10 @@
+import type { PdfMutableObjectStore } from "../cos/mutable-object-store.js";
+import type { PdfIndexStorage } from "../cos/object-index.js";
+import type { PdfRetainedDocument } from "../retained-document.js";
+export interface RetainedFormUpdate {
+    readonly name: string;
+    readonly value: string | boolean;
+}
+/** Field traversal and generated streams live on caller storage. Locations keep
+ * direct fields attached to their indirect owner without retaining the tree. */
+export declare function generateRetainedFormAppearances(document: PdfRetainedDocument, store: PdfMutableObjectStore, storage: PdfIndexStorage, signal: AbortSignal, update?: RetainedFormUpdate): Promise<void>;

package/dist/pdf-ast/edit/retained-graph.d.ts

@@ -1,6 +1,9 @@
+import { type RetainedInfoUpdate } from "./retained-info-updates.js";
+export type { RetainedInfoUpdate } from "./retained-info-updates.js";
 import { type RetainedBookmark } from "./retained-bookmarks.js";
 export type { RetainedBookmark } from "./retained-bookmarks.js";
 import { type RetainedAppendAttachment } from "./retained-append-attachments.js";
+import { type RetainedFormUpdate } from "./retained-form-appearances.js";
 import { type RetainedStampInput } from "./retained-stamps.js";
 export type { RetainedStampInput } from "./retained-stamps.js";
 import { type RetainedInlineImageOptions } from "./retained-inline-images.js";
@@ -12,7 +15,10 @@ export type { RetainedPageLabel } from "./retained-merge-labels.js";
 import type { PdfIndexStorage } from "../cos/object-index.js";
 import { PdfRetainedDocument, PdfRetainedPage } from "../retained-document.js";
 import type { SaveRetainedDocumentOptions } from "./retained-save.js";
+export type { RetainedFormUpdate } from "./retained-form-appearances.js";
 export type EditRetainedDocumentOptions = Pick<SaveRetainedDocumentOptions, "linearize" | "rotations" | "removeInfo" | "removeMetadata" | "removeStructure" | "removeAcroform" | "removePageLabels" | "maxObjects" | "maxPages" | "maxRecursionDepth" | "signal"> & {
+    readonly formUpdates?: Iterable<RetainedFormUpdate> | AsyncIterable<RetainedFormUpdate>;
+    readonly infoUpdates?: Iterable<RetainedInfoUpdate> | AsyncIterable<RetainedInfoUpdate>;
     readonly bookmarks?: Iterable<RetainedBookmark> | AsyncIterable<RetainedBookmark>;
     readonly appendAttachments?: AsyncIterable<RetainedAppendAttachment>;
     readonly attachmentPageIndex?: number;

package/dist/pdf-ast/edit/retained-info-updates.d.ts

@@ -0,0 +1,33 @@
+import { type PdfCosArray, type PdfCosRef } from "../ast.js";
+import { PdfMutableObjectStore } from "../cos/mutable-object-store.js";
+import type { PdfIndexStorage } from "../cos/object-index.js";
+import type { PdfRetainedDocument, PdfRetainedPage } from "../retained-document.js";
+import { type RetainedBookmark } from "./retained-bookmarks.js";
+export type RetainedInfoUpdate = {
+    readonly kind: "info";
+    readonly key: string;
+    readonly value: string;
+} | {
+    readonly kind: "id";
+    readonly index: 0 | 1;
+    readonly bytes: Uint8Array;
+} | {
+    readonly kind: "page";
+    readonly pageNumber: number;
+    readonly property: "rotation" | "dimensions" | "media" | "crop";
+    readonly values: readonly number[];
+} | {
+    readonly kind: "label";
+    readonly index: number;
+    readonly start: number;
+    readonly prefix?: string;
+    readonly style?: string;
+} | ({
+    readonly kind: "bookmark";
+} & RetainedBookmark);
+/** Apply metadata immediately, then last-wins page properties in first-seen
+ * order, labels and bookmarks. Record counts and hierarchy use caller storage. */
+export declare function applyRetainedInfoUpdates(document: PdfRetainedDocument, store: PdfMutableObjectStore, storage: PdfIndexStorage, count: number, getPage: (index: number) => Promise<PdfRetainedPage>, updates: Iterable<RetainedInfoUpdate> | AsyncIterable<RetainedInfoUpdate>, signal: AbortSignal, maxDepth?: number): Promise<{
+    infoRef: PdfCosRef | undefined;
+    idArray: PdfCosArray | undefined;
+}>;

package/dist/pdf-ast/index.d.ts

@@ -71,7 +71,7 @@ export { createRetainedPageCopy, type PdfRetainedPageCopy, copyRetainedPageChunk
 export { PdfRawTextIndex, type PdfRawTextGlyph, type PdfRawTextIndexOptions, type PdfStoredTextWord, type PdfStoredTextLine, type PdfStoredTextBlock } from "./extract/raw-text-index.js";
 export { retainedCosObjects, type PdfRetainedObjectsOptions } from "./cos/retained-objects.js";
 export { saveRetainedDocumentChunks, type SaveRetainedDocumentOptions, type RetainedPageRotation } from "./edit/retained-save.js";
-export { editRetainedDocument, PdfDuplicateAttachment, type RetainedAttachmentInput, type EditRetainedDocumentOptions, type RetainedBookmark, type RetainedStampInput, type RetainedPageLabel } from "./edit/retained-graph.js";
+export { editRetainedDocument, PdfDuplicateAttachment, type RetainedAttachmentInput, type EditRetainedDocumentOptions, type RetainedBookmark, type RetainedFormUpdate, type RetainedInfoUpdate, type RetainedStampInput, type RetainedPageLabel } from "./edit/retained-graph.js";
 export { copyRetainedAttachments } from "./edit/retained-attachment-copies.js";
 export { retainedObjectOrder } from "./cos/retained-object-order.js";
 export { encryptRetainedPdfChunks } from "./cos/retained-encryption.js";