@poe-platform/safe-bash 0.1.844 → 0.1.846

package/dist/image-ast/ast.d.ts

@@ -1,5 +1,5 @@
 import type { FileSystem } from "@poe-platform/safe-fs/contracts";
-export type ImageFormat = "png" | "jpeg" | "webp" | "heic" | "heif" | "avif" | "gif" | "ppm" | "pgm" | "pbm" | "bmp" | "tiff" | "svg" | "pdf" | "raw";
+export type ImageFormat = "png" | "jpeg" | "webp" | "heic" | "heif" | "avif" | "gif" | "pam" | "ppm" | "pgm" | "pbm" | "bmp" | "miff" | "tiff" | "svg" | "pdf" | "raw";
 export type ColorSpace = "srgb" | "b-w" | "cmyk" | "rgb16" | "grey16";
 export interface RgbaColor {
     readonly r: number;
@@ -14,6 +14,8 @@ export type ColorInput = string | {
     readonly alpha?: number;
 };
 export interface RgbaImage {
+    readonly miffPages?: readonly RgbaImage[];
+    readonly tiffPages?: readonly RgbaImage[];
     readonly isPalette?: boolean;
     readonly backgroundColor?: RgbaColor;
     readonly width: number;
@@ -25,6 +27,7 @@ export interface RgbaImage {
     readonly channels: 1 | 2 | 3 | 4;
     readonly depth: "uchar" | "char" | "ushort" | "short" | "uint" | "int" | "float" | "double" | "bit";
     readonly density: number;
+    readonly resolution?: NonNullable<ImageMetadata["resolution"]>;
     readonly hasAlpha: boolean;
     readonly isPremultiplied?: boolean;
     readonly wasPremultiplied?: boolean;
@@ -34,6 +37,8 @@ export interface RgbaImage {
         readonly x: number;
         readonly y: number;
     };
+    readonly properties?: Readonly<Record<string, string>>;
+    readonly icc?: Uint8Array;
     readonly orientation?: number;
     readonly autoOrient?: {
         readonly width: number;
@@ -74,7 +79,7 @@ export interface ImageMetadata {
     readonly resolution?: {
         readonly x: number;
         readonly y: number;
-        readonly unit: "meter" | "unknown";
+        readonly unit: "meter" | "inch" | "cm" | "unknown";
     };
     readonly virtualCanvas?: {
         readonly width: number;
@@ -82,6 +87,8 @@ export interface ImageMetadata {
         readonly x: number;
         readonly y: number;
     };
+    readonly properties?: Readonly<Record<string, string>>;
+    readonly icc?: Uint8Array;
     readonly orientation?: number;
     readonly autoOrient?: {
         readonly width: number;
@@ -419,9 +426,12 @@ export type ImageAstNode = {
     readonly orientation?: number;
 };
 export interface OutputEncodeOptions {
+    readonly omitPngResolution?: boolean;
     readonly consumeInput?: boolean;
     readonly format?: ImageFormat;
     readonly rawDepth?: string;
+    readonly netpbmDepth?: number;
+    readonly netpbmAscii?: boolean;
     readonly quality?: number;
     readonly samplingFactor?: string;
     readonly chromaSubsampling?: "4:2:0" | "4:4:4";

package/dist/image-ast/browser/ast.d.ts

@@ -1,5 +1,5 @@
 import type { FileSystem } from "@poe-platform/safe-fs/contracts";
-export type ImageFormat = "png" | "jpeg" | "webp" | "heic" | "heif" | "avif" | "gif" | "ppm" | "pgm" | "pbm" | "bmp" | "tiff" | "svg" | "pdf" | "raw";
+export type ImageFormat = "png" | "jpeg" | "webp" | "heic" | "heif" | "avif" | "gif" | "pam" | "ppm" | "pgm" | "pbm" | "bmp" | "miff" | "tiff" | "svg" | "pdf" | "raw";
 export type ColorSpace = "srgb" | "b-w" | "cmyk" | "rgb16" | "grey16";
 export interface RgbaColor {
     readonly r: number;
@@ -14,6 +14,8 @@ export type ColorInput = string | {
     readonly alpha?: number;
 };
 export interface RgbaImage {
+    readonly miffPages?: readonly RgbaImage[];
+    readonly tiffPages?: readonly RgbaImage[];
     readonly isPalette?: boolean;
     readonly backgroundColor?: RgbaColor;
     readonly width: number;
@@ -25,6 +27,7 @@ export interface RgbaImage {
     readonly channels: 1 | 2 | 3 | 4;
     readonly depth: "uchar" | "char" | "ushort" | "short" | "uint" | "int" | "float" | "double" | "bit";
     readonly density: number;
+    readonly resolution?: NonNullable<ImageMetadata["resolution"]>;
     readonly hasAlpha: boolean;
     readonly isPremultiplied?: boolean;
     readonly wasPremultiplied?: boolean;
@@ -34,6 +37,8 @@ export interface RgbaImage {
         readonly x: number;
         readonly y: number;
     };
+    readonly properties?: Readonly<Record<string, string>>;
+    readonly icc?: Uint8Array;
     readonly orientation?: number;
     readonly autoOrient?: {
         readonly width: number;
@@ -74,7 +79,7 @@ export interface ImageMetadata {
     readonly resolution?: {
         readonly x: number;
         readonly y: number;
-        readonly unit: "meter" | "unknown";
+        readonly unit: "meter" | "inch" | "cm" | "unknown";
     };
     readonly virtualCanvas?: {
         readonly width: number;
@@ -82,6 +87,8 @@ export interface ImageMetadata {
         readonly x: number;
         readonly y: number;
     };
+    readonly properties?: Readonly<Record<string, string>>;
+    readonly icc?: Uint8Array;
     readonly orientation?: number;
     readonly autoOrient?: {
         readonly width: number;
@@ -419,9 +426,12 @@ export type ImageAstNode = {
     readonly orientation?: number;
 };
 export interface OutputEncodeOptions {
+    readonly omitPngResolution?: boolean;
     readonly consumeInput?: boolean;
     readonly format?: ImageFormat;
     readonly rawDepth?: string;
+    readonly netpbmDepth?: number;
+    readonly netpbmAscii?: boolean;
     readonly quality?: number;
     readonly samplingFactor?: string;
     readonly chromaSubsampling?: "4:2:0" | "4:4:4";

package/dist/image-ast/browser/codecs/exif-metadata.d.ts

@@ -1,6 +1,8 @@
+import type { ImageMetadata } from "../ast.js";
 export interface ExifMetadata {
     readonly orientation?: number;
     readonly density?: number;
+    readonly resolution?: ImageMetadata["resolution"];
 }
 export interface MetadataRead {
     readonly position: number;

package/dist/image-ast/browser/codecs/exif.d.ts

@@ -1,7 +1,9 @@
+import type { ImageMetadata } from "../ast.js";
 import { type ExifMetadata } from "./exif-metadata.js";
 export type { ExifMetadata } from "./exif-metadata.js";
 export declare function parseExifBuffer(raw: Uint8Array): ExifMetadata;
 export declare function buildExifApp1Segment(options: {
     readonly orientation?: number;
     readonly density?: number;
+    readonly resolution?: ImageMetadata["resolution"];
 }): Uint8Array;

package/dist/image-ast/browser/codecs/gif-metadata-storage.d.ts

@@ -4,6 +4,7 @@ import { SourceBytes } from "./storage-source.js";
 export declare function scanGifAnimation(reader: SourceBytes, size: number, start: number, onFrame?: (frame: number, delay: number) => Promise<void>): Promise<{
     frames: number;
     loop: number | undefined;
+    properties?: Record<string, string>;
 }>;
 /** Frame delays remain in caller backing. The caller owns both source and storage lifetimes. */
 export declare function readGifMetadataFromSource(source: ImageByteSource, storage: ImageByteStorage, signal: AbortSignal, options?: SharpInputOptions): Promise<RetainedImageMetadata>;

package/dist/image-ast/browser/codecs/gif-metadata.d.ts

@@ -7,5 +7,6 @@ export declare function gifAnimationSteps(size: number, start: number): Generato
 }, {
     frames: number;
     loop: number | undefined;
+    properties?: Record<string, string>;
 }, number | undefined>;
 export declare function gifMetadataFields(width: number, height: number, size: number, frames: number, loop: number | undefined, options?: Pick<SharpInputOptions, "animated" | "page" | "pages">): ImageMetadata;

package/dist/image-ast/browser/codecs/gif-output-parts.d.ts

@@ -5,7 +5,7 @@ export interface GifOptions {
     readonly loop?: number;
     readonly optimizeFrames?: boolean;
 }
-export type GifImage = Pick<RgbaImage, "width" | "height" | "pageHeight" | "delay" | "loop" | "disposal" | "virtualCanvas" | "gifFrames" | "backgroundColor">;
+export type GifImage = Pick<RgbaImage, "width" | "height" | "pageHeight" | "delay" | "loop" | "disposal" | "virtualCanvas" | "gifFrames" | "backgroundColor" | "properties">;
 /** The wire palette is fixed at 256 entries, independent of raster size. */
 export declare class GifPalette {
     readonly bytes: Uint8Array<ArrayBuffer>;

package/dist/image-ast/browser/codecs/jpeg.d.ts

@@ -4,7 +4,7 @@ export declare function readJpegMetadata(bytes: Uint8Array): ImageMetadata;
 export declare function idct8x8(coeffs: Int32Array | Int16Array, quant: Uint16Array, out: Uint8Array, maxK?: number): void;
 export declare function idctScaledBlock(coeffs: Int32Array | Int16Array, quant: Uint16Array, out: Uint8Array, maxK: number, step: 8 | 4 | 2): void;
 export declare function decodeJpegImage(bytes: Uint8Array, options?: SharpInputOptions): RgbaImage;
-export declare function createJpegEncoder(img: Pick<RgbaImage, "width" | "height" | "density" | "orientation">, options?: {
+export declare function createJpegEncoder(img: Pick<RgbaImage, "width" | "height" | "density" | "resolution" | "orientation" | "icc" | "properties">, options?: {
     readonly quality?: number;
     readonly samplingFactor?: string;
     readonly chromaSubsampling?: "4:2:0" | "4:4:4";

package/dist/image-ast/browser/codecs/netpbm-storage.d.ts

@@ -1,6 +1,6 @@
 import type { SharpInputOptions } from "../ast.js";
 import type { ImageByteSource, ImageByteStorage, StoredRgbaImage } from "./png-storage.js";
-/** Decode all six Netpbm variants without retaining the encoded file or raster. */
+/** Decode Netpbm variants including PAM without retaining the encoded file or raster. */
 export declare function decodeNetpbmToStorage(source: ImageByteSource, storage: ImageByteStorage, signal: AbortSignal, options?: SharpInputOptions): Promise<StoredRgbaImage>;
 /** Owned output chunks and pull-driven backpressure; rows never require full buffers. */
-export declare function encodeNetpbmFromStorage(image: StoredRgbaImage, storage: ImageByteStorage, signal: AbortSignal, format: "ppm" | "pgm" | "pbm"): AsyncGenerator<Uint8Array>;
+export declare function encodeNetpbmFromStorage(image: StoredRgbaImage, storage: ImageByteStorage, signal: AbortSignal, format: "ppm" | "pgm" | "pbm" | "pam", depth?: number, ascii?: boolean): AsyncGenerator<Uint8Array>;

package/dist/image-ast/browser/codecs/netpbm.d.ts

@@ -3,10 +3,10 @@ export declare function isNetpbmBytes(bytes: Uint8Array): boolean;
 export declare function isBmpBytes(bytes: Uint8Array): boolean;
 export declare function isTiffBytes(bytes: Uint8Array): boolean;
 export declare function readNetpbmMetadata(bytes: Uint8Array): ImageMetadata;
-export declare function decodeNetpbmImage(bytes: Uint8Array): RgbaImage;
-export declare function encodePpm(img: RgbaImage): Uint8Array;
-export declare function encodePgm(img: RgbaImage): Uint8Array;
-export declare function encodePbm(img: RgbaImage): Uint8Array;
+export declare function decodeNetpbmImage(bytes: Uint8Array, page?: number): RgbaImage;
+export declare function encodePpm(img: RgbaImage, depth?: number, ascii?: boolean, pam?: boolean): Uint8Array;
+export declare function encodePgm(img: RgbaImage, depth?: number, ascii?: boolean): Uint8Array;
+export declare function encodePbm(img: RgbaImage, ascii?: boolean): Uint8Array;
 export declare function readBmpMetadata(bytes: Uint8Array): ImageMetadata;
 export declare function decodeBmpImage(bytes: Uint8Array): RgbaImage;
 export declare function encodeBmpImage(img: RgbaImage): Uint8Array;

package/dist/image-ast/browser/codecs/png-storage.d.ts

@@ -14,7 +14,15 @@ export interface ImageByteStorage extends Pick<ImageByteSource, "read"> {
         readonly signal?: AbortSignal;
     }): Promise<void>;
 }
-export interface StoredRgbaImage extends Omit<RgbaImage, "data" | "data16"> {
+export interface StoredRgbaImage extends Omit<RgbaImage, "data" | "data16" | "miffPages" | "tiffPages"> {
+    readonly storedMiffPages?: {
+        readonly length: number;
+        at(index: number): Promise<StoredRgbaImage>;
+    };
+    readonly storedTiffPages?: {
+        readonly length: number;
+        at(index: number): Promise<StoredRgbaImage>;
+    };
     readonly position: number;
     /** Original high-depth raw samples retain the same lifetime as buffered data16. */
     readonly storedData16?: {

package/dist/image-ast/browser/codecs/png.d.ts

@@ -6,6 +6,7 @@ export declare function encodePngImage(img: RgbaImage, options?: {
     readonly compressionLevel?: number;
     readonly density?: number;
     readonly orientation?: number;
+    readonly omitPngResolution?: boolean;
     readonly forceOpaque?: boolean;
     readonly consumeInput?: boolean;
 }): Uint8Array;

package/dist/image-ast/browser/codecs/tiff-layout.d.ts

@@ -1,11 +1,12 @@
 import type { RgbaImage } from "../ast.js";
 export declare function tiffChannels(img: Pick<RgbaImage, "space" | "hasAlpha">): 1 | 2 | 4;
-export declare function createTiffLayout(img: Pick<RgbaImage, "width" | "height" | "density" | "orientation" | "space" | "hasAlpha">, options?: {
+export declare function createTiffLayout(img: Pick<RgbaImage, "width" | "height" | "density" | "resolution" | "orientation" | "space" | "hasAlpha" | "properties">, options?: {
     readonly density?: number;
     readonly orientation?: number;
-}): {
+}, offset?: number, hasNext?: boolean): {
     header: Uint8Array<ArrayBuffer>;
     directory: Uint8Array<ArrayBuffer>;
     channels: 1 | 2 | 4;
     padding: number;
+    end: number;
 };

package/dist/image-ast/codecs/exif-metadata.d.ts

@@ -1,6 +1,8 @@
+import type { ImageMetadata } from "../ast.js";
 export interface ExifMetadata {
     readonly orientation?: number;
     readonly density?: number;
+    readonly resolution?: ImageMetadata["resolution"];
 }
 export interface MetadataRead {
     readonly position: number;

package/dist/image-ast/codecs/exif.d.ts

@@ -1,7 +1,9 @@
+import type { ImageMetadata } from "../ast.js";
 import { type ExifMetadata } from "./exif-metadata.js";
 export type { ExifMetadata } from "./exif-metadata.js";
 export declare function parseExifBuffer(raw: Uint8Array): ExifMetadata;
 export declare function buildExifApp1Segment(options: {
     readonly orientation?: number;
     readonly density?: number;
+    readonly resolution?: ImageMetadata["resolution"];
 }): Uint8Array;

package/dist/image-ast/codecs/gif-metadata-storage.d.ts

@@ -4,6 +4,7 @@ import { SourceBytes } from "./storage-source.js";
 export declare function scanGifAnimation(reader: SourceBytes, size: number, start: number, onFrame?: (frame: number, delay: number) => Promise<void>): Promise<{
     frames: number;
     loop: number | undefined;
+    properties?: Record<string, string>;
 }>;
 /** Frame delays remain in caller backing. The caller owns both source and storage lifetimes. */
 export declare function readGifMetadataFromSource(source: ImageByteSource, storage: ImageByteStorage, signal: AbortSignal, options?: SharpInputOptions): Promise<RetainedImageMetadata>;

package/dist/image-ast/codecs/gif-metadata.d.ts

@@ -7,5 +7,6 @@ export declare function gifAnimationSteps(size: number, start: number): Generato
 }, {
     frames: number;
     loop: number | undefined;
+    properties?: Record<string, string>;
 }, number | undefined>;
 export declare function gifMetadataFields(width: number, height: number, size: number, frames: number, loop: number | undefined, options?: Pick<SharpInputOptions, "animated" | "page" | "pages">): ImageMetadata;

package/dist/image-ast/codecs/gif-output-parts.d.ts

@@ -5,7 +5,7 @@ export interface GifOptions {
     readonly loop?: number;
     readonly optimizeFrames?: boolean;
 }
-export type GifImage = Pick<RgbaImage, "width" | "height" | "pageHeight" | "delay" | "loop" | "disposal" | "virtualCanvas" | "gifFrames" | "backgroundColor">;
+export type GifImage = Pick<RgbaImage, "width" | "height" | "pageHeight" | "delay" | "loop" | "disposal" | "virtualCanvas" | "gifFrames" | "backgroundColor" | "properties">;
 /** The wire palette is fixed at 256 entries, independent of raster size. */
 export declare class GifPalette {
     readonly bytes: Uint8Array<ArrayBuffer>;

package/dist/image-ast/codecs/jpeg.d.ts

@@ -4,7 +4,7 @@ export declare function readJpegMetadata(bytes: Uint8Array): ImageMetadata;
 export declare function idct8x8(coeffs: Int32Array | Int16Array, quant: Uint16Array, out: Uint8Array, maxK?: number): void;
 export declare function idctScaledBlock(coeffs: Int32Array | Int16Array, quant: Uint16Array, out: Uint8Array, maxK: number, step: 8 | 4 | 2): void;
 export declare function decodeJpegImage(bytes: Uint8Array, options?: SharpInputOptions): RgbaImage;
-export declare function createJpegEncoder(img: Pick<RgbaImage, "width" | "height" | "density" | "orientation">, options?: {
+export declare function createJpegEncoder(img: Pick<RgbaImage, "width" | "height" | "density" | "resolution" | "orientation" | "icc" | "properties">, options?: {
     readonly quality?: number;
     readonly samplingFactor?: string;
     readonly chromaSubsampling?: "4:2:0" | "4:4:4";

package/dist/image-ast/codecs/netpbm-storage.d.ts

@@ -1,6 +1,6 @@
 import type { SharpInputOptions } from "../ast.js";
 import type { ImageByteSource, ImageByteStorage, StoredRgbaImage } from "./png-storage.js";
-/** Decode all six Netpbm variants without retaining the encoded file or raster. */
+/** Decode Netpbm variants including PAM without retaining the encoded file or raster. */
 export declare function decodeNetpbmToStorage(source: ImageByteSource, storage: ImageByteStorage, signal: AbortSignal, options?: SharpInputOptions): Promise<StoredRgbaImage>;
 /** Owned output chunks and pull-driven backpressure; rows never require full buffers. */
-export declare function encodeNetpbmFromStorage(image: StoredRgbaImage, storage: ImageByteStorage, signal: AbortSignal, format: "ppm" | "pgm" | "pbm"): AsyncGenerator<Uint8Array>;
+export declare function encodeNetpbmFromStorage(image: StoredRgbaImage, storage: ImageByteStorage, signal: AbortSignal, format: "ppm" | "pgm" | "pbm" | "pam", depth?: number, ascii?: boolean): AsyncGenerator<Uint8Array>;

package/dist/image-ast/codecs/netpbm.d.ts

@@ -3,10 +3,10 @@ export declare function isNetpbmBytes(bytes: Uint8Array): boolean;
 export declare function isBmpBytes(bytes: Uint8Array): boolean;
 export declare function isTiffBytes(bytes: Uint8Array): boolean;
 export declare function readNetpbmMetadata(bytes: Uint8Array): ImageMetadata;
-export declare function decodeNetpbmImage(bytes: Uint8Array): RgbaImage;
-export declare function encodePpm(img: RgbaImage): Uint8Array;
-export declare function encodePgm(img: RgbaImage): Uint8Array;
-export declare function encodePbm(img: RgbaImage): Uint8Array;
+export declare function decodeNetpbmImage(bytes: Uint8Array, page?: number): RgbaImage;
+export declare function encodePpm(img: RgbaImage, depth?: number, ascii?: boolean, pam?: boolean): Uint8Array;
+export declare function encodePgm(img: RgbaImage, depth?: number, ascii?: boolean): Uint8Array;
+export declare function encodePbm(img: RgbaImage, ascii?: boolean): Uint8Array;
 export declare function readBmpMetadata(bytes: Uint8Array): ImageMetadata;
 export declare function decodeBmpImage(bytes: Uint8Array): RgbaImage;
 export declare function encodeBmpImage(img: RgbaImage): Uint8Array;

package/dist/image-ast/codecs/png-storage.d.ts

@@ -14,7 +14,15 @@ export interface ImageByteStorage extends Pick<ImageByteSource, "read"> {
         readonly signal?: AbortSignal;
     }): Promise<void>;
 }
-export interface StoredRgbaImage extends Omit<RgbaImage, "data" | "data16"> {
+export interface StoredRgbaImage extends Omit<RgbaImage, "data" | "data16" | "miffPages" | "tiffPages"> {
+    readonly storedMiffPages?: {
+        readonly length: number;
+        at(index: number): Promise<StoredRgbaImage>;
+    };
+    readonly storedTiffPages?: {
+        readonly length: number;
+        at(index: number): Promise<StoredRgbaImage>;
+    };
     readonly position: number;
     /** Original high-depth raw samples retain the same lifetime as buffered data16. */
     readonly storedData16?: {

package/dist/image-ast/codecs/png.d.ts

@@ -6,6 +6,7 @@ export declare function encodePngImage(img: RgbaImage, options?: {
     readonly compressionLevel?: number;
     readonly density?: number;
     readonly orientation?: number;
+    readonly omitPngResolution?: boolean;
     readonly forceOpaque?: boolean;
     readonly consumeInput?: boolean;
 }): Uint8Array;

package/dist/image-ast/codecs/tiff-layout.d.ts

@@ -1,11 +1,12 @@
 import type { RgbaImage } from "../ast.js";
 export declare function tiffChannels(img: Pick<RgbaImage, "space" | "hasAlpha">): 1 | 2 | 4;
-export declare function createTiffLayout(img: Pick<RgbaImage, "width" | "height" | "density" | "orientation" | "space" | "hasAlpha">, options?: {
+export declare function createTiffLayout(img: Pick<RgbaImage, "width" | "height" | "density" | "resolution" | "orientation" | "space" | "hasAlpha" | "properties">, options?: {
     readonly density?: number;
     readonly orientation?: number;
-}): {
+}, offset?: number, hasNext?: boolean): {
     header: Uint8Array<ArrayBuffer>;
     directory: Uint8Array<ArrayBuffer>;
     channels: 1 | 2 | 4;
     padding: number;
+    end: number;
 };