import type { PathProvidedItem, PathTable } from "./+types.path-table.js";
/**
 * Constructs a hierarchical table structure from path-based items, primarily used for creating
 * grouped table headers.
 *
 * The path table represents a layout with potentially asymmetric rows where:
 * - Each item in a row represents a column
 * - Each column defines its starting/ending positions and span ranges for both rows and columns
 * - Items are organized into a hierarchy based on their groupPath properties
 * - Leaf nodes (without children) will expand to fill available vertical space
 *
 * @example
 * ```ts
 * const table = computePathTable([
 *   { id: "x", groupPath: ["A", "B"] },
 *   { id: "y" },
 *   { id: "z", groupPath: ["A", "B", "C"] },
 *   { id: "d", groupPath: ["Y", "X", "C"] },
 *   { id: "v", groupPath: ["F"] },
 * ]);
 * ```
 *
 * This creates a table structure like:
 *
 * ```
 * ┌─────┬───┬───────┬───────┬───┐
 * │ A   │ y │ A     │ Y     │ F │
 * ├─────┤   ├───────┼───────┼───┤
 * │ A#B │   │ A#B   │ Y#X   │ v │
 * ├─────┤   ├───────┼───────┤   │
 * │ x   │   │ A#B#C │ Y#X#C │   │
 * │     │   ├───────┼───────┤   │
 * │     │   │ z     │ d     │   │
 * └─────┴───┴───────┴───────┴───┘
 * ```
 *
 * @param paths - Array of items with optional groupPath properties defining their hierarchical structure
 * @param maxDepth - Optional limit for the maximum depth of the hierarchy to process
 * @param mutableSeenMap - Optional map to track occurrence counts of path segments (used internally)
 * @returns A PathTable object containing the structured table layout and dimension information
 */
export declare function computePathTable<T extends PathProvidedItem>(paths: T[], maxDepth?: number, mutableSeenMap?: Record<string, number>, pathDelimiter?: string, startOffset?: number): PathTable<T>;