@poe-platform/safe-bash 0.1.811 → 0.1.812

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

@@ -1,3 +1,4 @@
+export { normalizeVorbisCommentKey } from "./vorbis.js";
 export { probeFlacSource, type FlacCommentSpan } from "./flac-source.js";
 export { probeWavSource, type AudioProbeSource, type WavTagSpan } from "./wav-source.js";
 export * from "./types.js";

package/dist/audio-ast/index.js

@@ -158,11 +158,15 @@ function pictureBase64(picture) {
 function addVorbisComment(tags, value) {
   const split = value.indexOf("=");
   if (split > 0) {
-    const key = value.slice(0, split).toUpperCase(), name = names[key] ?? key;
+    const name = normalizeVorbisCommentKey(value.slice(0, split));
     tags[name] = tags[name] ? `${tags[name]}
 ${value.slice(split + 1)}` : value.slice(split + 1);
   }
 }
+function normalizeVorbisCommentKey(value) {
+  const key = value.toUpperCase();
+  return names[key] ?? key;
+}
 
 // packages/audio-ast/src/flac.ts
 function parseFlac(bytes) {
@@ -1694,6 +1698,7 @@ export {
   extractChannels,
   fade,
   normalize,
+  normalizeVorbisCommentKey,
   pad,
   parseAudio,
   probeAudio,

package/dist/audio-ast/vorbis.d.ts

@@ -0,0 +1,14 @@
+import type { AudioPicture, AudioTags } from "./types.js";
+export declare function parseComments(bytes: Uint8Array): {
+    tags: AudioTags;
+    vendor: string;
+    comments: string[];
+    size: number;
+};
+export declare function encodeComments(tags: AudioTags, vendor?: string): Uint8Array;
+export declare function parsePicture(bytes: Uint8Array): AudioPicture;
+export declare function encodePicture(p: AudioPicture): Uint8Array;
+export declare function pictureBase64(picture: AudioPicture): string;
+/** Preserve normalization and duplicate joining for decoded Vorbis comments. */
+export declare function addVorbisComment(tags: AudioTags, value: string): void;
+export declare function normalizeVorbisCommentKey(value: string): string;

package/dist/image-ast/index.js

@@ -1762,7 +1762,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", chunkBytes: 16384, maxNodes: 1 / 0, maxTokenBytes: 1 / 0, maxRecursionDepth: 1 / 0, maxPageTreeDepth: 1 / 0, xref: { arrayStorage: values, storedArrayKeys: ["Index"] }, valueArrays: { 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", chunkBytes: 16384, maxNodes: 1 / 0, maxTokenBytes: 1 / 0, maxRecursionDepth: 1 / 0, maxPageTreeDepth: 1 / 0, xref: { arrayStorage: values, storedArrayKeys: ["Index"] }, valueArrays: { 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/pdf-ast/cos/value-parser.d.ts

@@ -1,7 +1,9 @@
-import type { PdfCosNode, PdfCosDict, PdfPixelStorage } from "../ast.js";
+import type { PdfCosNode, PdfCosDict, PdfDictEntry, PdfPixelStorage, PdfStoredItems } from "../ast.js";
 import type { CosToken } from "./lexer.js";
 export interface ValueArrayStorage {
     readonly arrayStorage?: PdfPixelStorage;
+    /** Back suspended parser containers; selected descriptors must share this storage. */
+    readonly containerStorage?: PdfPixelStorage;
     /** Select decoded source strings without changing other string consumers. */
     readonly stringStorage?: PdfPixelStorage;
     readonly storedStringKeys?: readonly string[];
@@ -14,11 +16,30 @@ export interface ValueArrayStorage {
     readonly arrayPathPrefix?: readonly string[];
     readonly storeRootArray?: boolean;
 }
+export type ValueContainer = ({
+    kind: "array";
+    start: number;
+    items: PdfCosNode[];
+    storedItems?: PdfStoredItems;
+    tail: number;
+} | {
+    kind: "dict";
+    start: number;
+    entries: PdfDictEntry[];
+    key?: PdfDictEntry["key"];
+}) & {
+    path: readonly (string | null)[];
+};
 export type ValueWork<T> = Generator<void | "token" | PdfCosDict | {
     kind: "array-append";
     node: PdfCosNode;
     previous: number;
-}, T, CosToken | PdfCosNode | number | undefined>;
+} | {
+    kind: "container-push";
+    container: ValueContainer;
+} | {
+    kind: "container-pop";
+}, T, CosToken | PdfCosNode | ValueContainer | number | undefined>;
 export declare function parseValueSteps(lexer: {
     offset: number;
     setStringStorage?: (storage: PdfPixelStorage | undefined) => void;

package/dist/pdf-ast/extract/retained-form-field-details.d.ts

@@ -0,0 +1,20 @@
+import type { PdfIndexStorage } from "../cos/object-index.js";
+import type { PdfFormFieldInfo } from "../edit/forms.js";
+import type { PdfRetainedDocument } from "../retained-document.js";
+import { type RetainedFieldOptions } from "./retained-form-fields.js";
+/** Borrowed field metadata. Consume values/options before advancing the field
+ * iterator. Both iterators close when their field or document is released. */
+export interface PdfRetainedFormFieldDetails {
+    readonly name: string;
+    readonly type: PdfFormFieldInfo["type"];
+    readonly flags: number;
+    readonly justification: "Left" | "Centered" | "Right";
+    readonly maxLength: number | undefined;
+    readonly altName: string | undefined;
+    readonly defaultValue: string | undefined;
+    readonly stateValue: string | undefined;
+    readonly checked: boolean | undefined;
+    values(): AsyncGenerator<string, void, void>;
+    options(): AsyncGenerator<string, void, void>;
+}
+export declare function walkRetainedFormFieldDetails(document: PdfRetainedDocument, storage: PdfIndexStorage, options?: RetainedFieldOptions): AsyncGenerator<PdfRetainedFormFieldDetails, void, void>;

package/dist/pdf-ast/extract/retained-form-fields.d.ts

@@ -1,11 +1,24 @@
+import { type PdfCosDict, type PdfCosNode } from "../ast.js";
 import type { PdfIndexStorage } from "../cos/object-index.js";
 import type { PdfFormFieldInfo } from "../edit/forms.js";
 import type { PdfRetainedDocument } from "../retained-document.js";
 export type PdfRetainedFormField = Pick<PdfFormFieldInfo, "name" | "type" | "value">;
-/** Summarize fields one at a time. Traversal frames and active-path membership
- * live on caller storage, preserving repeated fields while stopping cycles. */
-export declare function walkRetainedFormFields(document: PdfRetainedDocument, storage: PdfIndexStorage, options?: {
+export interface RetainedFieldEntry {
+    readonly name: string;
+    readonly dict: PdfCosDict;
+    readonly ft: string;
+    readonly flags: number;
+    readonly justification: number;
+    readonly maxLength: number | undefined;
+}
+export interface RetainedFieldOptions {
     maxDepth?: number;
     maxStagingBytes?: number;
     signal?: AbortSignal;
-}): AsyncGenerator<PdfRetainedFormField, void, void>;
+}
+export declare function inheritedRetainedFieldEntry(document: PdfRetainedDocument, storage: PdfIndexStorage, dict: PdfCosDict, key: string, options: RetainedFieldOptions): Promise<PdfCosNode | undefined>;
+/** Summarize fields one at a time. Traversal frames and active-path membership
+ * live on caller storage, preserving repeated fields while stopping cycles. */
+export declare function walkRetainedFieldEntries(document: PdfRetainedDocument, storage: PdfIndexStorage, options?: RetainedFieldOptions): AsyncGenerator<RetainedFieldEntry, void, void>;
+/** Compatibility summaries; detailed consumers can iterate values/options separately. */
+export declare function walkRetainedFormFields(document: PdfRetainedDocument, storage: PdfIndexStorage, options?: RetainedFieldOptions): AsyncGenerator<PdfRetainedFormField, void, void>;

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

@@ -32,6 +32,7 @@ export * from "./extract/text.js";
 export * from "./extract/tables.js";
 export * from "./extract/semantic-ast.js";
 export * from "./extract/images.js";
+export type { PdfRetainedFormFieldDetails } from "./extract/retained-form-field-details.js";
 export type { PdfRetainedFormField } from "./extract/retained-form-fields.js";
 export type { PdfRetainedAttachment } from "./extract/retained-attachments.js";
 export * from "./edit/redact.js";