// Generated by alef. Do not edit by hand.
@file:Suppress(
    "ktlint:standard:trailing-comma-on-call-site",
    "ktlint:standard:trailing-comma-on-declaration-site",
    "ktlint:standard:spacing-between-declarations-with-comments",
    "ktlint:standard:spacing-between-declarations-with-annotations",
    "ktlint:standard:when-entry-bracing",
    "ktlint:standard:blank-line-between-when-conditions",
    "ktlint:standard:blank-line-before-declaration",
    "ktlint:standard:chain-method-continuation",
    "ktlint:standard:annotation",
    "ktlint:standard:max-line-length",
    "ktlint:standard:no-semi",
    "ktlint:standard:statement-wrapping",
    "MaxLineLength",
    "TooManyFunctions",
    "FunctionParameterNaming",
    "LongParameterList",
    "CyclomaticComplexMethod",
    "LongMethod",
)

package dev.kreuzberg

/**
 * Hierarchy extraction configuration for PDF text structure analysis.
 *
 * Enables extraction of document hierarchy levels (H1-H6) based on font size
 * clustering and semantic analysis. When enabled, hierarchical blocks are
 * included in page content.
 */
data class HierarchyConfig(
    /** Enable hierarchy extraction */
    val enabled: Boolean = true,
    /**
     * Number of font size clusters to use for hierarchy levels (1-7)
     *
     * Default: 6, which provides H1-H6 heading levels with body text.
     * Larger values create more fine-grained hierarchy levels.
     */
    val kClusters: Long = 3L,
    /** Include bounding box information in hierarchy blocks */
    val includeBbox: Boolean = true,
    /**
     * OCR coverage threshold for smart OCR triggering (0.0-1.0)
     *
     * Determines when OCR should be triggered based on text block coverage.
     * OCR is triggered when text blocks cover less than this fraction of the page.
     * Default: 0.5 (trigger OCR if less than 50% of page has text)
     */
    val ocrCoverageThreshold: Float? = null,
)
