@lexmata/micropdf 0.4.0

package/dist/render-options.d.ts

@@ -0,0 +1,227 @@
+/**
+ * Advanced Rendering Options
+ *
+ * Provides fine-grained control over PDF rendering quality, colorspace,
+ * and performance characteristics.
+ */
+import type { Colorspace } from './colorspace.js';
+import type { Matrix } from './geometry.js';
+/**
+ * Anti-aliasing level
+ *
+ * Controls the quality of anti-aliasing applied during rendering.
+ * Higher levels produce smoother output but are slower.
+ */
+export declare enum AntiAliasLevel {
+    /** No anti-aliasing - fastest, lowest quality */
+    None = 0,
+    /** Low anti-aliasing - 2x2 sampling */
+    Low = 2,
+    /** Medium anti-aliasing - 4x4 sampling */
+    Medium = 4,
+    /** High anti-aliasing - 8x8 sampling - best quality, slowest */
+    High = 8
+}
+/**
+ * Rendering options
+ *
+ * Configures how a PDF page is rendered to a pixmap.
+ *
+ * @example
+ * ```typescript
+ * const options: RenderOptions = {
+ *   dpi: 300,
+ *   colorspace: Colorspace.deviceRGB(),
+ *   alpha: true,
+ *   antiAlias: AntiAliasLevel.High
+ * };
+ *
+ * const pixmap = page.renderWithOptions(options);
+ * ```
+ */
+export interface RenderOptions {
+    /**
+     * Resolution in dots per inch
+     *
+     * Common values:
+     * - 72: Screen resolution (1:1)
+     * - 150: Low-quality print
+     * - 300: Standard print quality
+     * - 600: High-quality print
+     *
+     * @default 72
+     */
+    dpi?: number;
+    /**
+     * Target colorspace
+     *
+     * Determines the color model of the output pixmap.
+     *
+     * @default Colorspace.deviceRGB()
+     */
+    colorspace?: Colorspace;
+    /**
+     * Include alpha channel
+     *
+     * If true, the output pixmap will have an alpha (transparency) channel.
+     *
+     * @default false
+     */
+    alpha?: boolean;
+    /**
+     * Anti-aliasing level
+     *
+     * Controls the quality of anti-aliasing applied during rendering.
+     *
+     * @default AntiAliasLevel.High
+     */
+    antiAlias?: AntiAliasLevel;
+    /**
+     * Transformation matrix
+     *
+     * Optional matrix to transform the page before rendering.
+     * If provided, DPI is ignored.
+     */
+    transform?: Matrix;
+    /**
+     * Render annotations
+     *
+     * If true, annotations will be rendered on the page.
+     *
+     * @default true
+     */
+    renderAnnotations?: boolean;
+    /**
+     * Render form fields
+     *
+     * If true, form fields will be rendered on the page.
+     *
+     * @default true
+     */
+    renderFormFields?: boolean;
+}
+/**
+ * Render progress callback
+ *
+ * Called periodically during rendering to report progress.
+ *
+ * @param current - Current progress value
+ * @param total - Total progress value
+ * @returns true to continue rendering, false to abort
+ */
+export type RenderProgressCallback = (current: number, total: number) => boolean;
+/**
+ * Render error callback
+ *
+ * Called when an error occurs during rendering.
+ *
+ * @param error - Error message
+ */
+export type RenderErrorCallback = (error: string) => void;
+/**
+ * Extended rendering options with progress tracking
+ *
+ * Adds progress and error callbacks for long-running render operations.
+ *
+ * @example
+ * ```typescript
+ * const options: ExtendedRenderOptions = {
+ *   dpi: 300,
+ *   alpha: true,
+ *   onProgress: (current, total) => {
+ *     console.log(`Rendering: ${current}/${total}`);
+ *     return true; // Continue
+ *   },
+ *   onError: (error) => {
+ *     console.error('Render error:', error);
+ *   }
+ * };
+ * ```
+ */
+export interface ExtendedRenderOptions extends RenderOptions {
+    /**
+     * Progress callback
+     *
+     * Called periodically during rendering to report progress.
+     * Return false to abort rendering.
+     */
+    onProgress?: RenderProgressCallback;
+    /**
+     * Error callback
+     *
+     * Called when an error occurs during rendering.
+     */
+    onError?: RenderErrorCallback;
+    /**
+     * Timeout in milliseconds
+     *
+     * If rendering takes longer than this, it will be aborted.
+     *
+     * @default undefined (no timeout)
+     */
+    timeout?: number;
+}
+/**
+ * Get default render options
+ *
+ * @returns Default rendering options
+ *
+ * @example
+ * ```typescript
+ * const defaults = getDefaultRenderOptions();
+ * const custom = { ...defaults, dpi: 300 };
+ * ```
+ */
+export declare function getDefaultRenderOptions(): RenderOptions;
+/**
+ * Calculate scale matrix from DPI
+ *
+ * @param dpi - Target resolution in dots per inch
+ * @returns Scale factor
+ *
+ * @example
+ * ```typescript
+ * const scale = dpiToScale(300); // 4.166... (300/72)
+ * ```
+ */
+export declare function dpiToScale(dpi: number): number;
+/**
+ * Calculate DPI from scale matrix
+ *
+ * @param scale - Scale factor
+ * @returns Resolution in dots per inch
+ *
+ * @example
+ * ```typescript
+ * const dpi = scaleToDpi(2.0); // 144 (72 * 2)
+ * ```
+ */
+export declare function scaleToDpi(scale: number): number;
+/**
+ * Validate render options
+ *
+ * Checks that all options are within valid ranges.
+ *
+ * @param options - Options to validate
+ * @throws Error if options are invalid
+ *
+ * @example
+ * ```typescript
+ * validateRenderOptions({ dpi: 300, alpha: true });
+ * ```
+ */
+export declare function validateRenderOptions(options: RenderOptions): void;
+/**
+ * Merge render options with defaults
+ *
+ * @param options - User-provided options
+ * @returns Complete options with defaults filled in
+ *
+ * @example
+ * ```typescript
+ * const options = mergeRenderOptions({ dpi: 300 });
+ * // { dpi: 300, alpha: false, antiAlias: 8, ... }
+ * ```
+ */
+export declare function mergeRenderOptions(options: RenderOptions): Required<RenderOptions>;
+//# sourceMappingURL=render-options.d.ts.map

package/dist/render-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-options.d.ts","sourceRoot":"","sources":["../src/render-options.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;GAKG;AACH,oBAAY,cAAc;IACxB,iDAAiD;IACjD,IAAI,IAAI;IACR,uCAAuC;IACvC,GAAG,IAAI;IACP,0CAA0C;IAC1C,MAAM,IAAI;IACV,gEAAgE;IAChE,IAAI,IAAI;CACT;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;;OAUG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC;IAE3B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;AAEjF;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D;;;;;OAKG;IACH,UAAU,CAAC,EAAE,sBAAsB,CAAC;IAEpC;;;;OAIG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAE9B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,IAAI,aAAa,CAQvD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAqBlE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC,CAWlF"}

package/dist/render-options.js

@@ -0,0 +1,130 @@
+/**
+ * Advanced Rendering Options
+ *
+ * Provides fine-grained control over PDF rendering quality, colorspace,
+ * and performance characteristics.
+ */
+/**
+ * Anti-aliasing level
+ *
+ * Controls the quality of anti-aliasing applied during rendering.
+ * Higher levels produce smoother output but are slower.
+ */
+export var AntiAliasLevel;
+(function (AntiAliasLevel) {
+    /** No anti-aliasing - fastest, lowest quality */
+    AntiAliasLevel[AntiAliasLevel["None"] = 0] = "None";
+    /** Low anti-aliasing - 2x2 sampling */
+    AntiAliasLevel[AntiAliasLevel["Low"] = 2] = "Low";
+    /** Medium anti-aliasing - 4x4 sampling */
+    AntiAliasLevel[AntiAliasLevel["Medium"] = 4] = "Medium";
+    /** High anti-aliasing - 8x8 sampling - best quality, slowest */
+    AntiAliasLevel[AntiAliasLevel["High"] = 8] = "High";
+})(AntiAliasLevel || (AntiAliasLevel = {}));
+/**
+ * Get default render options
+ *
+ * @returns Default rendering options
+ *
+ * @example
+ * ```typescript
+ * const defaults = getDefaultRenderOptions();
+ * const custom = { ...defaults, dpi: 300 };
+ * ```
+ */
+export function getDefaultRenderOptions() {
+    return {
+        dpi: 72,
+        alpha: false,
+        antiAlias: AntiAliasLevel.High,
+        renderAnnotations: true,
+        renderFormFields: true
+    };
+}
+/**
+ * Calculate scale matrix from DPI
+ *
+ * @param dpi - Target resolution in dots per inch
+ * @returns Scale factor
+ *
+ * @example
+ * ```typescript
+ * const scale = dpiToScale(300); // 4.166... (300/72)
+ * ```
+ */
+export function dpiToScale(dpi) {
+    return dpi / 72.0;
+}
+/**
+ * Calculate DPI from scale matrix
+ *
+ * @param scale - Scale factor
+ * @returns Resolution in dots per inch
+ *
+ * @example
+ * ```typescript
+ * const dpi = scaleToDpi(2.0); // 144 (72 * 2)
+ * ```
+ */
+export function scaleToDpi(scale) {
+    return scale * 72.0;
+}
+/**
+ * Validate render options
+ *
+ * Checks that all options are within valid ranges.
+ *
+ * @param options - Options to validate
+ * @throws Error if options are invalid
+ *
+ * @example
+ * ```typescript
+ * validateRenderOptions({ dpi: 300, alpha: true });
+ * ```
+ */
+export function validateRenderOptions(options) {
+    if (options.dpi !== undefined) {
+        if (options.dpi <= 0) {
+            throw new Error('DPI must be positive');
+        }
+        if (options.dpi > 2400) {
+            throw new Error('DPI too high (max 2400)');
+        }
+    }
+    if (options.antiAlias !== undefined) {
+        const validLevels = [
+            AntiAliasLevel.None,
+            AntiAliasLevel.Low,
+            AntiAliasLevel.Medium,
+            AntiAliasLevel.High
+        ];
+        if (!validLevels.includes(options.antiAlias)) {
+            throw new Error(`Invalid anti-alias level: ${options.antiAlias}`);
+        }
+    }
+}
+/**
+ * Merge render options with defaults
+ *
+ * @param options - User-provided options
+ * @returns Complete options with defaults filled in
+ *
+ * @example
+ * ```typescript
+ * const options = mergeRenderOptions({ dpi: 300 });
+ * // { dpi: 300, alpha: false, antiAlias: 8, ... }
+ * ```
+ */
+export function mergeRenderOptions(options) {
+    const defaults = getDefaultRenderOptions();
+    return {
+        dpi: options.dpi ?? defaults.dpi,
+        colorspace: options.colorspace ?? defaults.colorspace,
+        alpha: options.alpha ?? defaults.alpha,
+        antiAlias: options.antiAlias ?? defaults.antiAlias,
+        transform: options.transform ?? defaults.transform,
+        renderAnnotations: options.renderAnnotations ?? defaults.renderAnnotations,
+        renderFormFields: options.renderFormFields ?? defaults.renderFormFields
+    };
+}
+//# sourceMappingURL=render-options.js.map

package/dist/render-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-options.js","sourceRoot":"","sources":["../src/render-options.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;;GAKG;AACH,MAAM,CAAN,IAAY,cASX;AATD,WAAY,cAAc;IACxB,iDAAiD;IACjD,mDAAQ,CAAA;IACR,uCAAuC;IACvC,iDAAO,CAAA;IACP,0CAA0C;IAC1C,uDAAU,CAAA;IACV,gEAAgE;IAChE,mDAAQ,CAAA;AACV,CAAC,EATW,cAAc,KAAd,cAAc,QASzB;AAyJD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,GAAG,EAAE,EAAE;QACP,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,cAAc,CAAC,IAAI;QAC9B,iBAAiB,EAAE,IAAI;QACvB,gBAAgB,EAAE,IAAI;KACvB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,GAAG,GAAG,IAAI,CAAC;AACpB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK,GAAG,IAAI,CAAC;AACtB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAsB;IAC1D,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,GAAG,IAAI,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,WAAW,GAAG;YAClB,cAAc,CAAC,IAAI;YACnB,cAAc,CAAC,GAAG;YAClB,cAAc,CAAC,MAAM;YACrB,cAAc,CAAC,IAAI;SACpB,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAsB;IACvD,MAAM,QAAQ,GAAG,uBAAuB,EAAE,CAAC;IAC3C,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,QAAQ,CAAC,GAAI;QACjC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAW;QACtD,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAM;QACvC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAU;QACnD,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAU;QACnD,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,QAAQ,CAAC,iBAAkB;QAC3E,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,QAAQ,CAAC,gBAAiB;KACzE,CAAC;AACJ,CAAC"}

package/dist/resource-tracking.d.ts

@@ -0,0 +1,332 @@
+/**
+ * Resource Tracking and Memory Optimization for MicroPDF
+ *
+ * This module provides:
+ * - FinalizationRegistry-based handle tracking for leak detection
+ * - Object pools for geometry types (Point, Rect, Matrix, Quad)
+ * - WeakRef-based leak detection warnings
+ * - Buffer optimization utilities
+ *
+ * @module resource-tracking
+ */
+import { Point, Rect, Matrix, Quad } from './geometry.js';
+/**
+ * Resource types that can be tracked
+ */
+export declare enum ResourceType {
+    Context = "Context",
+    Buffer = "Buffer",
+    Stream = "Stream",
+    Pixmap = "Pixmap",
+    Document = "Document",
+    Page = "Page",
+    Font = "Font",
+    Image = "Image",
+    Path = "Path",
+    Text = "Text",
+    Device = "Device",
+    DisplayList = "DisplayList",
+    Colorspace = "Colorspace",
+    PdfObject = "PdfObject",
+    Annotation = "Annotation",
+    Link = "Link",
+    Outline = "Outline",
+    Cookie = "Cookie",
+    Archive = "Archive",
+    StextPage = "StextPage",
+    Other = "Other"
+}
+/**
+ * Information about a tracked allocation
+ */
+export interface AllocationInfo {
+    handle: number;
+    type: ResourceType;
+    createdAt: number;
+    stackTrace?: string | undefined;
+    tag?: string | undefined;
+}
+/**
+ * Statistics for a resource type
+ */
+export interface TypeStats {
+    currentCount: number;
+    totalAllocated: number;
+    totalDeallocated: number;
+}
+/**
+ * Global tracking statistics
+ */
+export interface GlobalStats {
+    totalHandlesCreated: number;
+    totalHandlesDestroyed: number;
+    currentHandles: number;
+    peakHandles: number;
+    leakWarnings: number;
+}
+/**
+ * Global handle registry for tracking unreleased resources
+ */
+declare class HandleRegistry {
+    private registry;
+    private allocations;
+    private weakRefs;
+    private stats;
+    private typeStats;
+    private enabled;
+    private captureStacks;
+    private leakWarnings;
+    constructor();
+    /**
+     * Enable or disable resource tracking
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Check if tracking is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Enable or disable stack trace capture (expensive)
+     */
+    setCaptureStacks(capture: boolean): void;
+    /**
+     * Register an object for tracking
+     */
+    register(target: object, handle: number, type: ResourceType, tag?: string): void;
+    /**
+     * Unregister an object (called when properly disposed)
+     */
+    unregister(target: object, handle: number): void;
+    /**
+     * Called when an object is garbage collected without being properly disposed
+     */
+    private handleFinalized;
+    /**
+     * Get current global statistics
+     */
+    getStats(): GlobalStats;
+    /**
+     * Get statistics by resource type
+     */
+    getTypeStats(): Map<ResourceType, TypeStats>;
+    /**
+     * Get all current allocations
+     */
+    getAllocations(): AllocationInfo[];
+    /**
+     * Get potential leaks (allocations older than threshold)
+     */
+    getPotentialLeaks(minAgeMs: number): AllocationInfo[];
+    /**
+     * Get and clear leak warnings
+     */
+    getLeakWarnings(): string[];
+    /**
+     * Reset all tracking data
+     */
+    reset(): void;
+}
+/**
+ * Global handle registry instance
+ */
+export declare const handleRegistry: HandleRegistry;
+/**
+ * Enable resource tracking
+ */
+export declare function enableTracking(enabled: boolean): void;
+/**
+ * Enable stack trace capture for allocations
+ */
+export declare function enableStackTraces(enabled: boolean): void;
+/**
+ * Check if tracking is enabled
+ */
+export declare function isTrackingEnabled(): boolean;
+/**
+ * Generic object pool
+ */
+declare class ObjectPool<T> {
+    private pool;
+    private maxSize;
+    private factory;
+    private reset;
+    private hits;
+    private misses;
+    private returns;
+    constructor(factory: () => T, reset: (obj: T) => void, maxSize?: number);
+    /**
+     * Get an object from the pool or create a new one
+     */
+    acquire(): T;
+    /**
+     * Return an object to the pool
+     */
+    release(obj: T): void;
+    /**
+     * Get pool statistics
+     */
+    getStats(): {
+        size: number;
+        hits: number;
+        misses: number;
+        returns: number;
+        hitRate: number;
+    };
+    /**
+     * Clear the pool
+     */
+    clear(): void;
+}
+/**
+ * Mutable Point for pooling (internal use only)
+ */
+declare class MutablePoint {
+    x: number;
+    y: number;
+    reset(): void;
+    toPoint(): Point;
+}
+/**
+ * Mutable Rect for pooling (internal use only)
+ */
+declare class MutableRect {
+    x0: number;
+    y0: number;
+    x1: number;
+    y1: number;
+    reset(): void;
+    toRect(): Rect;
+}
+/**
+ * Mutable Matrix for pooling (internal use only)
+ */
+declare class MutableMatrix {
+    a: number;
+    b: number;
+    c: number;
+    d: number;
+    e: number;
+    f: number;
+    reset(): void;
+    toMatrix(): Matrix;
+}
+/**
+ * Mutable Quad for pooling (internal use only)
+ */
+declare class MutableQuad {
+    ulX: number;
+    ulY: number;
+    urX: number;
+    urY: number;
+    llX: number;
+    llY: number;
+    lrX: number;
+    lrY: number;
+    reset(): void;
+    toQuad(): Quad;
+}
+/**
+ * Acquire a mutable point from the pool
+ */
+export declare function acquirePoint(): MutablePoint;
+/**
+ * Release a mutable point back to the pool
+ */
+export declare function releasePoint(p: MutablePoint): void;
+/**
+ * Acquire a mutable rect from the pool
+ */
+export declare function acquireRect(): MutableRect;
+/**
+ * Release a mutable rect back to the pool
+ */
+export declare function releaseRect(r: MutableRect): void;
+/**
+ * Acquire a mutable matrix from the pool
+ */
+export declare function acquireMatrix(): MutableMatrix;
+/**
+ * Release a mutable matrix back to the pool
+ */
+export declare function releaseMatrix(m: MutableMatrix): void;
+/**
+ * Acquire a mutable quad from the pool
+ */
+export declare function acquireQuad(): MutableQuad;
+/**
+ * Release a mutable quad back to the pool
+ */
+export declare function releaseQuad(q: MutableQuad): void;
+/**
+ * Get pool statistics
+ */
+export declare function getPoolStats(): Record<string, ReturnType<ObjectPool<unknown>['getStats']>>;
+/**
+ * Clear all pools
+ */
+export declare function clearPools(): void;
+/**
+ * Pool for reusable byte arrays
+ */
+declare class ByteArrayPool {
+    private pools;
+    private sizes;
+    private maxPerSize;
+    /**
+     * Get the size class for a given length
+     */
+    private getSizeClass;
+    /**
+     * Acquire a byte array with at least the specified length
+     */
+    acquire(minLength: number): Uint8Array;
+    /**
+     * Release a byte array back to the pool
+     */
+    release(arr: Uint8Array): void;
+    /**
+     * Clear all pools
+     */
+    clear(): void;
+}
+/**
+ * Global byte array pool
+ */
+export declare const byteArrayPool: ByteArrayPool;
+/**
+ * Convert a Uint8Array to string efficiently
+ *
+ * Uses TextDecoder for larger buffers (> 1KB) which is more efficient,
+ * and falls back to simple string conversion for smaller buffers.
+ */
+export declare function uint8ArrayToString(data: Uint8Array): string;
+/**
+ * Convert a Buffer to string efficiently
+ *
+ * Uses TextDecoder for larger buffers (> 1KB) which is more efficient.
+ */
+export declare function bufferToString(data: globalThis.Buffer, encoding?: BufferEncoding): string;
+/**
+ * Reusable number array pool for hot paths
+ */
+declare class NumberArrayPool {
+    private pools;
+    private maxPerSize;
+    acquire(size: number): number[];
+    release(arr: number[]): void;
+    clear(): void;
+}
+/**
+ * Global number array pool
+ */
+export declare const numberArrayPool: NumberArrayPool;
+/**
+ * Generate a comprehensive leak report
+ */
+export declare function generateLeakReport(minAgeMs?: number): string;
+/**
+ * Print leak report to console
+ */
+export declare function printLeakReport(minAgeMs?: number): void;
+export {};
+//# sourceMappingURL=resource-tracking.d.ts.map

package/dist/resource-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-tracking.d.ts","sourceRoot":"","sources":["../src/resource-tracking.ts"],"names":[],"mappings":"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"}