@llamaindex/liteparse 1.5.3 → 2.0.0-beta.0

package/dist/src/processing/gridDebugLogger.d.ts

@@ -1,206 +0,0 @@
-import { ProjectionTextBox } from "../core/types.js";
-/**
- * Configuration for grid projection debug logging.
- *
- * When enabled, logs detailed information about how text elements are
- * snapped, anchored, and projected during grid layout. Use filters to
- * narrow output to specific elements you're investigating.
- */
-export interface GridDebugConfig {
-    /**
-     * Enable debug logging for grid projection.
-     * @defaultValue `false`
-     */
-    enabled: boolean;
-    /**
-     * Only log elements whose text contains one of these substrings (case-insensitive).
-     * If empty, all elements are logged.
-     */
-    textFilter?: string[];
-    /**
-     * Only log elements on these line indices (0-based within the page).
-     */
-    lineFilter?: number[];
-    /**
-     * Only log elements on this page number (1-indexed).
-     */
-    pageFilter?: number;
-    /**
-     * Only log elements within this bounding region (PDF coordinates).
-     */
-    regionFilter?: {
-        x1: number;
-        y1: number;
-        x2: number;
-        y2: number;
-    };
-    /**
-     * Write log output to a file path instead of stderr. If not set, logs to stderr.
-     */
-    outputPath?: string;
-    /**
-     * Generate PNG visualizations of the grid projection showing text boxes
-     * color-coded by snap type (left/right/center/floating/flowing) with
-     * anchor lines overlaid.
-     * @defaultValue `false`
-     */
-    visualize?: boolean;
-    /**
-     * Directory to save visualization PNGs. Each page produces a file
-     * named `page-{N}-grid.png`.
-     * @defaultValue `"./debug-output"`
-     */
-    visualizePath?: string;
-    /**
-     * Enable trace mode for detailed render decision logging.
-     * When enabled, each render logs the full decision chain: initial targetX,
-     * lineMax computation, forward anchor checks, and which factor was the
-     * binding constraint. Forward anchor mutations are also traced with their
-     * triggering item. Respects textFilter/lineFilter/pageFilter.
-     * @defaultValue `false`
-     */
-    trace?: boolean;
-}
-export declare const DEFAULT_DEBUG_CONFIG: GridDebugConfig;
-/** A segment of rendered text placed into the output grid. */
-export interface RenderedSegment {
-    lineIndex: number;
-    /** Character column where this segment starts in the output line. */
-    gridCol: number;
-    text: string;
-    snap: "left" | "right" | "center" | "floating" | "flowing";
-}
-/** Context for a render decision trace — captures every factor that influenced targetX. */
-export interface RenderTraceContext {
-    snapType: "left" | "right" | "center" | "floating";
-    initialTargetX: number;
-    medianWidth: number;
-    lineMax: number;
-    lastSnapLeft?: number;
-    lastSnapLeftKey?: number;
-    rawLineTrimLength: number;
-    shouldSpace: number;
-    lineMaxCandidates?: Array<{
-        text: string;
-        lineIndex: number;
-        lineItemCount: number;
-        filtered: boolean;
-        value: number;
-    }>;
-    forwardAnchorValue?: number;
-    prevAnchorValue?: number;
-    pdfFallbackUsed?: boolean;
-    pdfFallbackTargetX?: number;
-    floatingAnchorBump?: number;
-    isSparseAnchor?: boolean;
-    finalTargetX: number;
-    bindingConstraint: string;
-}
-/** Captured data for a single page, used by the grid visualizer. */
-export interface VisualizerPageData {
-    pageNum: number;
-    /** Rendered text segments with snap type for color coding. */
-    segments: RenderedSegment[];
-    /** Final projected text lines (the actual output). */
-    rawLines: string[];
-}
-/**
- * Debug logger for grid projection. Provides targeted logging to trace
- * exactly why specific text elements are projected the way they are.
- *
- * Usage from LiteParse config:
- * ```typescript
- * const parser = new LiteParse({
- *   debug: {
- *     enabled: true,
- *     textFilter: ["Total", "Revenue"],  // only log elements containing these strings
- *     pageFilter: 2,                      // only page 2
- *     visualize: true,                    // generate PNG overlays
- *   }
- * });
- * ```
- */
-export declare class GridDebugLogger {
-    private config;
-    private entries;
-    private currentPage;
-    private writeOutput;
-    private trackedSnapPositions;
-    private vizPages;
-    private currentVizPage?;
-    constructor(config: GridDebugConfig);
-    get enabled(): boolean;
-    get shouldVisualize(): boolean;
-    get visualizerPages(): VisualizerPageData[];
-    get debugConfig(): GridDebugConfig;
-    setPage(pageNum: number, _width: number, _height: number): void;
-    private isPageFiltered;
-    /** Check if a bbox passes the configured filters */
-    matchesBbox(bbox: ProjectionTextBox, lineIndex?: number): boolean;
-    /** Log which block a line range was assigned to */
-    logBlock(blockIndex: number, start: number, end: number): void;
-    /** Log flowing text classification */
-    logFlowingBlock(start: number, end: number): void;
-    /** Log non-flowing block (no-op, only used for symmetry with logFlowingBlock) */
-    logStructuredBlock(_start: number, _end: number): void;
-    /** Log flowing line detection */
-    logFlowingLine(lineIndex: number, reason: string): void;
-    /** Log anchor extraction results for a block */
-    logAnchors(anchorLeft: Record<number, ProjectionTextBox[]>, anchorRight: Record<number, ProjectionTextBox[]>, anchorCenter: Record<number, ProjectionTextBox[]>): void;
-    /** Log snap assignment for a bbox */
-    logSnapAssignment(bbox: ProjectionTextBox, lineIndex: number, boxIndex: number): void;
-    /** Capture a rendered text segment for visualization. */
-    captureRender(lineIndex: number, gridCol: number, text: string, snap: "left" | "right" | "center" | "floating" | "flowing"): void;
-    /** Capture the final raw lines after projection completes for this page. */
-    captureRawLines(rawLines: string[]): void;
-    /** Log the rendering of a bbox to a target column position */
-    logRender(bbox: ProjectionTextBox, lineIndex: number, targetX: number, reason: string): void;
-    /** Log forward anchor updates */
-    logForwardAnchor(type: "left" | "right" | "center" | "floating", pdfX: number, gridCol: number): void;
-    /** Log duplicate resolution for multi-anchor elements */
-    logDuplicateResolution(bbox: ProjectionTextBox, resolvedTo: string): void;
-    /** Log block-level context (medianWidth, sparse anchors, snap maps) */
-    logBlockContext(blockStart: number, blockEnd: number, medianWidth: number, sparseLeftAnchors: Set<number>): void;
-    /** Log full render decision trace for a single item */
-    logRenderTrace(bbox: ProjectionTextBox, lineIndex: number, ctx: RenderTraceContext): void;
-    /** Log a forward anchor mutation with the triggering item */
-    logForwardAnchorMutation(triggerText: string, triggerLineIndex: number, snapType: string, snapPosition: number, oldValue: number | undefined, newValue: number, rightBound: number): void;
-    /** Log line composition (the full set of bboxes on a line) */
-    logLineComposition(lineIndex: number, line: ProjectionTextBox[]): void;
-    private emit;
-    private formatEntries;
-    /** Synchronous flush of log entries to file. */
-    flushSync(): void;
-    /** Flush entries to file if outputPath is configured */
-    flush(): Promise<void>;
-}
-/** No-op logger that skips all checks. Use when debug is disabled. */
-declare class NoopGridDebugLogger extends GridDebugLogger {
-    constructor();
-    get enabled(): boolean;
-    get shouldVisualize(): boolean;
-    matchesBbox(): boolean;
-    setPage(): void;
-    logBlock(): void;
-    logFlowingBlock(): void;
-    logStructuredBlock(): void;
-    logFlowingLine(): void;
-    logAnchors(): void;
-    logSnapAssignment(): void;
-    captureRender(): void;
-    captureRawLines(): void;
-    logRender(): void;
-    logForwardAnchor(): void;
-    logDuplicateResolution(): void;
-    logBlockContext(): void;
-    logRenderTrace(): void;
-    logForwardAnchorMutation(): void;
-    logLineComposition(): void;
-    flushSync(): void;
-    flush(): Promise<void>;
-}
-/** Singleton no-op instance for zero-overhead when debug is off */
-export declare const NOOP_LOGGER: NoopGridDebugLogger;
-export declare function createGridDebugLogger(config?: GridDebugConfig): GridDebugLogger;
-export {};
-//# sourceMappingURL=gridDebugLogger.d.ts.map

package/dist/src/processing/gridDebugLogger.d.ts.map

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

package/dist/src/processing/gridDebugLogger.js

@@ -1,446 +0,0 @@
-import { mkdirSync, writeFileSync } from "fs";
-import { mkdir, writeFile } from "fs/promises";
-import { dirname } from "path";
-export const DEFAULT_DEBUG_CONFIG = {
-    enabled: false,
-};
-/**
- * Debug logger for grid projection. Provides targeted logging to trace
- * exactly why specific text elements are projected the way they are.
- *
- * Usage from LiteParse config:
- * ```typescript
- * const parser = new LiteParse({
- *   debug: {
- *     enabled: true,
- *     textFilter: ["Total", "Revenue"],  // only log elements containing these strings
- *     pageFilter: 2,                      // only page 2
- *     visualize: true,                    // generate PNG overlays
- *   }
- * });
- * ```
- */
-export class GridDebugLogger {
-    config;
-    entries = [];
-    currentPage = 0;
-    writeOutput;
-    // Trace mode: snap positions that matched-filter items belong to.
-    // Forward anchor mutations affecting these positions are always logged.
-    trackedSnapPositions = new Set();
-    // Visualization data collection
-    vizPages = [];
-    currentVizPage;
-    constructor(config) {
-        this.config = config;
-        if (config.outputPath) {
-            // Defer file writing to flush()
-            this.writeOutput = () => { };
-        }
-        else {
-            this.writeOutput = (msg) => process.stderr.write(msg + "\n");
-        }
-    }
-    get enabled() {
-        return this.config.enabled;
-    }
-    get shouldVisualize() {
-        return this.config.visualize ?? false;
-    }
-    get visualizerPages() {
-        return this.vizPages;
-    }
-    get debugConfig() {
-        return this.config;
-    }
-    setPage(pageNum, _width, _height) {
-        this.currentPage = pageNum;
-        if (this.config.pageFilter && pageNum !== this.config.pageFilter) {
-            return;
-        }
-        this.emit({ phase: "page", message: `=== Page ${pageNum} ===` });
-        if (this.shouldVisualize) {
-            this.currentVizPage = {
-                pageNum,
-                segments: [],
-                rawLines: [],
-            };
-            this.vizPages.push(this.currentVizPage);
-        }
-    }
-    isPageFiltered() {
-        return !!this.config.pageFilter && this.currentPage !== this.config.pageFilter;
-    }
-    /** Check if a bbox passes the configured filters */
-    matchesBbox(bbox, lineIndex) {
-        if (!this.config.enabled)
-            return false;
-        if (this.isPageFiltered())
-            return false;
-        if (this.config.textFilter?.length) {
-            const text = bbox.str.toLowerCase();
-            if (!this.config.textFilter.some((f) => text.includes(f.toLowerCase()))) {
-                return false;
-            }
-        }
-        if (this.config.lineFilter?.length && lineIndex !== undefined) {
-            if (!this.config.lineFilter.includes(lineIndex)) {
-                return false;
-            }
-        }
-        if (this.config.regionFilter) {
-            const r = this.config.regionFilter;
-            if (bbox.x + bbox.w < r.x1 || bbox.x > r.x2 || bbox.y + bbox.h < r.y1 || bbox.y > r.y2) {
-                return false;
-            }
-        }
-        return true;
-    }
-    /** Log which block a line range was assigned to */
-    logBlock(blockIndex, start, end) {
-        if (!this.config.enabled || this.isPageFiltered())
-            return;
-        this.emit({
-            phase: "blocks",
-            message: `Block ${blockIndex}: lines ${start}-${end - 1}`,
-        });
-    }
-    /** Log flowing text classification */
-    logFlowingBlock(start, end) {
-        if (!this.config.enabled || this.isPageFiltered())
-            return;
-        this.emit({
-            phase: "flowing",
-            message: `Block lines ${start}-${end - 1} classified as flowing text`,
-        });
-    }
-    /** Log non-flowing block (no-op, only used for symmetry with logFlowingBlock) */
-    logStructuredBlock(_start, _end) { }
-    /** Log flowing line detection */
-    logFlowingLine(lineIndex, reason) {
-        if (!this.config.enabled || this.isPageFiltered())
-            return;
-        if (this.config.lineFilter?.length && !this.config.lineFilter.includes(lineIndex))
-            return;
-        this.emit({
-            phase: "flowing",
-            lineIndex,
-            message: `Line ${lineIndex} marked flowing: ${reason}`,
-        });
-    }
-    /** Log anchor extraction results for a block */
-    logAnchors(anchorLeft, anchorRight, anchorCenter) {
-        if (!this.config.enabled || this.isPageFiltered())
-            return;
-        const leftKeys = Object.keys(anchorLeft).map(Number);
-        const rightKeys = Object.keys(anchorRight).map(Number);
-        const centerKeys = Object.keys(anchorCenter).map(Number);
-        this.emit({
-            phase: "anchors",
-            message: `Anchors: left=[${leftKeys.join(", ")}] right=[${rightKeys.join(", ")}] center=[${centerKeys.join(", ")}]`,
-        });
-        // Log which elements are in each anchor, but only if they match filters
-        for (const key of leftKeys) {
-            const items = anchorLeft[key];
-            const matchingItems = this.config.textFilter?.length
-                ? items.filter((b) => this.matchesBbox(b))
-                : items;
-            if (matchingItems.length > 0) {
-                this.emit({
-                    phase: "anchors",
-                    message: `  left@${key}: ${matchingItems.map((b) => `"${b.str.substring(0, 30)}" (x=${b.x.toFixed(1)}, y=${b.y.toFixed(1)})`).join(", ")}`,
-                });
-            }
-        }
-        for (const key of rightKeys) {
-            const items = anchorRight[key];
-            const matchingItems = this.config.textFilter?.length
-                ? items.filter((b) => this.matchesBbox(b))
-                : items;
-            if (matchingItems.length > 0) {
-                this.emit({
-                    phase: "anchors",
-                    message: `  right@${key}: ${matchingItems.map((b) => `"${b.str.substring(0, 30)}" (x=${b.x.toFixed(1)}, y=${b.y.toFixed(1)})`).join(", ")}`,
-                });
-            }
-        }
-        for (const key of centerKeys) {
-            const items = anchorCenter[key];
-            const matchingItems = this.config.textFilter?.length
-                ? items.filter((b) => this.matchesBbox(b))
-                : items;
-            if (matchingItems.length > 0) {
-                this.emit({
-                    phase: "anchors",
-                    message: `  center@${key}: ${matchingItems.map((b) => `"${b.str.substring(0, 30)}" (x=${b.x.toFixed(1)}, y=${b.y.toFixed(1)})`).join(", ")}`,
-                });
-            }
-        }
-    }
-    /** Log snap assignment for a bbox */
-    logSnapAssignment(bbox, lineIndex, boxIndex) {
-        if (!this.matchesBbox(bbox, lineIndex))
-            return;
-        // Track snap positions for matched items so we can trace forward anchor
-        // mutations that affect them even when the triggering item doesn't match filters
-        if (this.config.trace) {
-            if (bbox.leftAnchor)
-                this.trackedSnapPositions.add(parseFloat(bbox.leftAnchor));
-            if (bbox.rightAnchor)
-                this.trackedSnapPositions.add(parseFloat(bbox.rightAnchor));
-            if (bbox.centerAnchor)
-                this.trackedSnapPositions.add(parseFloat(bbox.centerAnchor));
-        }
-        this.emit({
-            phase: "snap",
-            lineIndex,
-            boxIndex,
-            text: bbox.str,
-            message: `"${bbox.str.substring(0, 40)}" snap=${bbox.snap ?? "none"} leftAnchor=${bbox.leftAnchor ?? "-"} rightAnchor=${bbox.rightAnchor ?? "-"} centerAnchor=${bbox.centerAnchor ?? "-"} forceUnsnapped=${bbox.forceUnsnapped ?? false}`,
-            data: {
-                x: round2(bbox.x),
-                y: round2(bbox.y),
-                w: round2(bbox.w),
-                h: round2(bbox.h),
-                shouldSpace: bbox.shouldSpace,
-            },
-        });
-    }
-    /** Capture a rendered text segment for visualization. */
-    captureRender(lineIndex, gridCol, text, snap) {
-        if (!this.currentVizPage)
-            return;
-        this.currentVizPage.segments.push({ lineIndex, gridCol, text, snap });
-    }
-    /** Capture the final raw lines after projection completes for this page. */
-    captureRawLines(rawLines) {
-        if (!this.currentVizPage)
-            return;
-        this.currentVizPage.rawLines = Array.from({ length: rawLines.length }, (_, i) => rawLines[i] ?? "");
-    }
-    /** Log the rendering of a bbox to a target column position */
-    logRender(bbox, lineIndex, targetX, reason) {
-        if (!this.matchesBbox(bbox, lineIndex))
-            return;
-        this.emit({
-            phase: "render",
-            lineIndex,
-            text: bbox.str,
-            message: `"${bbox.str.substring(0, 40)}" → col ${targetX} (${reason})`,
-            data: {
-                pdfX: round2(bbox.x),
-                snap: bbox.snap ?? "none",
-                shouldSpace: bbox.shouldSpace,
-            },
-        });
-    }
-    /** Log forward anchor updates */
-    logForwardAnchor(type, pdfX, gridCol) {
-        if (!this.config.enabled || this.isPageFiltered())
-            return;
-        // Only log if no text filter (forward anchors aren't bbox-specific) or if we've been logging
-        if (this.config.textFilter?.length)
-            return;
-        this.emit({
-            phase: "forward-anchor",
-            message: `${type}@${round2(pdfX)} → col ${gridCol}`,
-        });
-    }
-    /** Log duplicate resolution for multi-anchor elements */
-    logDuplicateResolution(bbox, resolvedTo) {
-        if (!this.matchesBbox(bbox))
-            return;
-        this.emit({
-            phase: "dedup",
-            text: bbox.str,
-            message: `"${bbox.str.substring(0, 40)}" multi-anchor resolved to ${resolvedTo} (left=${bbox.leftAnchor ?? "-"} right=${bbox.rightAnchor ?? "-"} center=${bbox.centerAnchor ?? "-"})`,
-        });
-    }
-    /** Log block-level context (medianWidth, sparse anchors, snap maps) */
-    logBlockContext(blockStart, blockEnd, medianWidth, sparseLeftAnchors) {
-        if (!this.config.trace || !this.config.enabled || this.isPageFiltered())
-            return;
-        let msg = `Block ${blockStart}-${blockEnd - 1}: medianWidth=${round2(medianWidth)}`;
-        if (sparseLeftAnchors.size > 0) {
-            msg += `, sparseLeft=[${[...sparseLeftAnchors].map(round2).join(", ")}]`;
-        }
-        this.emit({ phase: "trace-block", message: msg });
-    }
-    /** Log full render decision trace for a single item */
-    logRenderTrace(bbox, lineIndex, ctx) {
-        if (!this.config.trace || !this.matchesBbox(bbox, lineIndex))
-            return;
-        const lines = [];
-        lines.push(`"${bbox.str.substring(0, 40)}" → col ${ctx.finalTargetX} (${ctx.snapType}) [binding: ${ctx.bindingConstraint}]`);
-        lines.push(`  initial: round(${round2(bbox.x)} / ${round2(ctx.medianWidth)}) = ${ctx.initialTargetX}, COLUMN_SPACES cap → ${Math.min(ctx.initialTargetX, 4)}`);
-        // lineMax details
-        if (ctx.lineMaxCandidates) {
-            // Right snap: show per-item candidates
-            lines.push(`  lineMax: ${ctx.lineMax} from ${ctx.lineMaxCandidates.length} candidates:`);
-            for (const c of ctx.lineMaxCandidates) {
-                const mark = c.filtered ? " [FILTERED: single-item line]" : "";
-                lines.push(`    L${c.lineIndex} "${c.text}" → ${c.value} (lineItems=${c.lineItemCount})${mark}`);
-            }
-        }
-        else {
-            const parts = [];
-            if (ctx.lastSnapLeft !== undefined && ctx.lastSnapLeft > 0) {
-                parts.push(`lastSnapLeft=${ctx.lastSnapLeft}${ctx.lastSnapLeftKey !== undefined ? ` (from left@${round2(ctx.lastSnapLeftKey)})` : ""}`);
-            }
-            parts.push(`rawLine.trimEnd=${ctx.rawLineTrimLength}`);
-            if (ctx.shouldSpace > 0)
-                parts.push(`shouldSpace=${ctx.shouldSpace}`);
-            lines.push(`  lineMax: ${ctx.lineMax} (${parts.join(", ")})`);
-        }
-        // Forward anchor
-        if (ctx.forwardAnchorValue !== undefined) {
-            lines.push(`  forwardAnchor: ${ctx.forwardAnchorValue}`);
-        }
-        // prevAnchors
-        if (ctx.prevAnchorValue !== undefined) {
-            lines.push(`  prevAnchor: ${ctx.prevAnchorValue}`);
-        }
-        // Floating-specific
-        if (ctx.pdfFallbackUsed) {
-            lines.push(`  pdfFallback: targetX raised to ${ctx.pdfFallbackTargetX} (empty line)`);
-        }
-        if (ctx.floatingAnchorBump !== undefined) {
-            lines.push(`  floatingAnchor bump: +${ctx.floatingAnchorBump}`);
-        }
-        if (ctx.isSparseAnchor) {
-            lines.push(`  sparse anchor: skipping forward anchor propagation and block padding`);
-        }
-        this.emit({
-            phase: "trace-render",
-            lineIndex,
-            text: bbox.str,
-            message: lines.join("\n"),
-        });
-    }
-    /** Log a forward anchor mutation with the triggering item */
-    logForwardAnchorMutation(triggerText, triggerLineIndex, snapType, snapPosition, oldValue, newValue, rightBound) {
-        if (!this.config.trace || !this.config.enabled || this.isPageFiltered())
-            return;
-        // Log if: no text filter, or trigger matches filter, or snap position is tracked
-        if (this.config.textFilter?.length) {
-            const text = triggerText.toLowerCase();
-            const matchesTrigger = this.config.textFilter.some((f) => text.includes(f.toLowerCase()));
-            const matchesPosition = this.trackedSnapPositions.has(snapPosition);
-            if (!matchesTrigger && !matchesPosition)
-                return;
-        }
-        const oldStr = oldValue !== undefined ? `was ${oldValue}` : "unset";
-        this.emit({
-            phase: "trace-fwd-mutation",
-            lineIndex: triggerLineIndex,
-            message: `${snapType}@${round2(snapPosition)}: ${oldStr} → ${newValue} (triggered by "${triggerText.substring(0, 40)}" L${triggerLineIndex}, rightBound=${round2(rightBound)})`,
-        });
-    }
-    /** Log line composition (the full set of bboxes on a line) */
-    logLineComposition(lineIndex, line) {
-        if (!this.config.enabled || this.isPageFiltered())
-            return;
-        if (this.config.lineFilter?.length && !this.config.lineFilter.includes(lineIndex))
-            return;
-        // If text filter is set, only log lines that contain a matching bbox
-        if (this.config.textFilter?.length) {
-            if (!line.some((b) => this.matchesBbox(b, lineIndex)))
-                return;
-        }
-        const items = line.map((b) => `"${b.str.substring(0, 20)}"@(${round2(b.x)},${round2(b.y)})`);
-        this.emit({
-            phase: "lines",
-            lineIndex,
-            message: `Line ${lineIndex} [${line.length} items]: ${items.join("  ")}`,
-        });
-    }
-    emit(entry) {
-        this.entries.push(entry);
-        if (!this.config.outputPath) {
-            const prefix = `[grid-debug][${entry.phase}]`;
-            const loc = entry.lineIndex !== undefined
-                ? ` L${entry.lineIndex}${entry.boxIndex !== undefined ? `:${entry.boxIndex}` : ""}`
-                : "";
-            let line = `${prefix}${loc} ${entry.message}`;
-            if (entry.data) {
-                line += ` ${JSON.stringify(entry.data)}`;
-            }
-            this.writeOutput(line);
-        }
-    }
-    formatEntries() {
-        return (this.entries
-            .map((entry) => {
-            const prefix = `[${entry.phase}]`;
-            const loc = entry.lineIndex !== undefined
-                ? ` L${entry.lineIndex}${entry.boxIndex !== undefined ? `:${entry.boxIndex}` : ""}`
-                : "";
-            let line = `${prefix}${loc} ${entry.message}`;
-            if (entry.data) {
-                line += ` ${JSON.stringify(entry.data)}`;
-            }
-            return line;
-        })
-            .join("\n") + "\n");
-    }
-    /** Synchronous flush of log entries to file. */
-    flushSync() {
-        if (!this.config.outputPath || this.entries.length === 0)
-            return;
-        mkdirSync(dirname(this.config.outputPath), { recursive: true });
-        writeFileSync(this.config.outputPath, this.formatEntries(), "utf-8");
-        this.entries = [];
-    }
-    /** Flush entries to file if outputPath is configured */
-    async flush() {
-        if (!this.config.outputPath || this.entries.length === 0)
-            return;
-        await mkdir(dirname(this.config.outputPath), { recursive: true });
-        await writeFile(this.config.outputPath, this.formatEntries(), "utf-8");
-        this.entries = [];
-    }
-}
-/** No-op logger that skips all checks. Use when debug is disabled. */
-class NoopGridDebugLogger extends GridDebugLogger {
-    constructor() {
-        super({ enabled: false });
-    }
-    get enabled() {
-        return false;
-    }
-    get shouldVisualize() {
-        return false;
-    }
-    matchesBbox() {
-        return false;
-    }
-    setPage() { }
-    logBlock() { }
-    logFlowingBlock() { }
-    logStructuredBlock() { }
-    logFlowingLine() { }
-    logAnchors() { }
-    logSnapAssignment() { }
-    captureRender() { }
-    captureRawLines() { }
-    logRender() { }
-    logForwardAnchor() { }
-    logDuplicateResolution() { }
-    logBlockContext() { }
-    logRenderTrace() { }
-    logForwardAnchorMutation() { }
-    logLineComposition() { }
-    flushSync() { }
-    async flush() { }
-}
-/** Singleton no-op instance for zero-overhead when debug is off */
-export const NOOP_LOGGER = new NoopGridDebugLogger();
-export function createGridDebugLogger(config) {
-    if (!config?.enabled)
-        return NOOP_LOGGER;
-    return new GridDebugLogger(config);
-}
-function round2(n) {
-    return Math.round(n * 100) / 100;
-}
-//# sourceMappingURL=gridDebugLogger.js.map