@kreuzberg/html-to-markdown-wasm 3.1.0 → 3.2.2

package/dist/html_to_markdown_wasm.d.ts

@@ -1,40 +1,488 @@
 /* tslint:disable */
 /* eslint-disable */
 
-/**
- * Convert HTML to Markdown, returning a JavaScript object with structured content, metadata,
- * images, and warnings in a single pass.
- *
- * This is the primary API entry point. Returns a JavaScript object with:
- * - `content`: converted text (string or null)
- * - `document`: structured document tree (object or null)
- * - `metadata`: extracted HTML metadata (object or null)
- * - `tables`: array of extracted table data
- * - `warnings`: array of non-fatal processing warnings
- *
- * # Arguments
- *
- * * `html` - The HTML string to convert
- * * `options` - Optional conversion options (as a JavaScript object)
- *
- * # Example
- *
- * ```javascript
- * import { convert } from 'html-to-markdown-wasm';
- *
- * const html = '<h1>Hello World</h1><p>Some text.</p>';
- * const result = convert(html, null);
- * console.log(result.content);   // '# Hello World\n\nSome text.'
- * console.log(result.tables);    // []
- * console.log(result.warnings);  // []
- * ```
- */
-export function convert(html: string, options?: WasmConversionOptions | null): WasmConversionResult;
+export enum WasmAnnotationKind {
+    Bold = 0,
+    Italic = 1,
+    Underline = 2,
+    Strikethrough = 3,
+    Code = 4,
+    Subscript = 5,
+    Superscript = 6,
+    Highlight = 7,
+    Link = 8,
+}
+
+export enum WasmCodeBlockStyle {
+    Indented = 0,
+    Backticks = 1,
+    Tildes = 2,
+}
+
+export class WasmConversionOptions {
+    free(): void;
+    [Symbol.dispose](): void;
+    static builder(): WasmConversionOptionsBuilder;
+    static default(): WasmConversionOptions;
+    constructor(heading_style?: WasmHeadingStyle | null, list_indent_type?: WasmListIndentType | null, list_indent_width?: number | null, bullets?: string | null, strong_em_symbol?: string | null, escape_asterisks?: boolean | null, escape_underscores?: boolean | null, escape_misc?: boolean | null, escape_ascii?: boolean | null, code_language?: string | null, autolinks?: boolean | null, default_title?: boolean | null, br_in_tables?: boolean | null, highlight_style?: WasmHighlightStyle | null, extract_metadata?: boolean | null, whitespace_mode?: WasmWhitespaceMode | null, strip_newlines?: boolean | null, wrap?: boolean | null, wrap_width?: number | null, convert_as_inline?: boolean | null, sub_symbol?: string | null, sup_symbol?: string | null, newline_style?: WasmNewlineStyle | null, code_block_style?: WasmCodeBlockStyle | null, keep_inline_images_in?: string[] | null, preprocessing?: WasmPreprocessingOptions | null, encoding?: string | null, debug?: boolean | null, strip_tags?: string[] | null, preserve_tags?: string[] | null, skip_images?: boolean | null, link_style?: WasmLinkStyle | null, output_format?: WasmOutputFormat | null, include_document_structure?: boolean | null, extract_images?: boolean | null, max_image_size?: bigint | null, capture_svg?: boolean | null, infer_dimensions?: boolean | null);
+    autolinks: boolean;
+    brInTables: boolean;
+    bullets: string;
+    captureSvg: boolean;
+    codeBlockStyle: WasmCodeBlockStyle;
+    codeLanguage: string;
+    convertAsInline: boolean;
+    debug: boolean;
+    defaultTitle: boolean;
+    encoding: string;
+    escapeAscii: boolean;
+    escapeAsterisks: boolean;
+    escapeMisc: boolean;
+    escapeUnderscores: boolean;
+    extractImages: boolean;
+    extractMetadata: boolean;
+    headingStyle: WasmHeadingStyle;
+    highlightStyle: WasmHighlightStyle;
+    includeDocumentStructure: boolean;
+    inferDimensions: boolean;
+    keepInlineImagesIn: string[];
+    linkStyle: WasmLinkStyle;
+    listIndentType: WasmListIndentType;
+    listIndentWidth: number;
+    maxImageSize: bigint;
+    newlineStyle: WasmNewlineStyle;
+    outputFormat: WasmOutputFormat;
+    preprocessing: WasmPreprocessingOptions;
+    preserveTags: string[];
+    skipImages: boolean;
+    stripNewlines: boolean;
+    stripTags: string[];
+    strongEmSymbol: string;
+    subSymbol: string;
+    supSymbol: string;
+    whitespaceMode: WasmWhitespaceMode;
+    wrap: boolean;
+    wrapWidth: number;
+}
+
+export class WasmConversionOptionsBuilder {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    build(): WasmConversionOptions;
+    keepInlineImagesIn(tags: string[]): WasmConversionOptionsBuilder;
+    preprocessing(preprocessing: WasmPreprocessingOptions): WasmConversionOptionsBuilder;
+    preserveTags(tags: string[]): WasmConversionOptionsBuilder;
+    stripTags(tags: string[]): WasmConversionOptionsBuilder;
+}
+
+export class WasmConversionOptionsUpdate {
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor(heading_style?: WasmHeadingStyle | null, list_indent_type?: WasmListIndentType | null, list_indent_width?: number | null, bullets?: string | null, strong_em_symbol?: string | null, escape_asterisks?: boolean | null, escape_underscores?: boolean | null, escape_misc?: boolean | null, escape_ascii?: boolean | null, code_language?: string | null, autolinks?: boolean | null, default_title?: boolean | null, br_in_tables?: boolean | null, highlight_style?: WasmHighlightStyle | null, extract_metadata?: boolean | null, whitespace_mode?: WasmWhitespaceMode | null, strip_newlines?: boolean | null, wrap?: boolean | null, wrap_width?: number | null, convert_as_inline?: boolean | null, sub_symbol?: string | null, sup_symbol?: string | null, newline_style?: WasmNewlineStyle | null, code_block_style?: WasmCodeBlockStyle | null, keep_inline_images_in?: string[] | null, preprocessing?: WasmPreprocessingOptionsUpdate | null, encoding?: string | null, debug?: boolean | null, strip_tags?: string[] | null, preserve_tags?: string[] | null, skip_images?: boolean | null, link_style?: WasmLinkStyle | null, output_format?: WasmOutputFormat | null, include_document_structure?: boolean | null, extract_images?: boolean | null, max_image_size?: bigint | null, capture_svg?: boolean | null, infer_dimensions?: boolean | null);
+    get autolinks(): boolean | undefined;
+    set autolinks(value: boolean | null | undefined);
+    get brInTables(): boolean | undefined;
+    set brInTables(value: boolean | null | undefined);
+    get bullets(): string | undefined;
+    set bullets(value: string | null | undefined);
+    get captureSvg(): boolean | undefined;
+    set captureSvg(value: boolean | null | undefined);
+    get codeBlockStyle(): WasmCodeBlockStyle | undefined;
+    set codeBlockStyle(value: WasmCodeBlockStyle | null | undefined);
+    get codeLanguage(): string | undefined;
+    set codeLanguage(value: string | null | undefined);
+    get convertAsInline(): boolean | undefined;
+    set convertAsInline(value: boolean | null | undefined);
+    get debug(): boolean | undefined;
+    set debug(value: boolean | null | undefined);
+    get defaultTitle(): boolean | undefined;
+    set defaultTitle(value: boolean | null | undefined);
+    get encoding(): string | undefined;
+    set encoding(value: string | null | undefined);
+    get escapeAscii(): boolean | undefined;
+    set escapeAscii(value: boolean | null | undefined);
+    get escapeAsterisks(): boolean | undefined;
+    set escapeAsterisks(value: boolean | null | undefined);
+    get escapeMisc(): boolean | undefined;
+    set escapeMisc(value: boolean | null | undefined);
+    get escapeUnderscores(): boolean | undefined;
+    set escapeUnderscores(value: boolean | null | undefined);
+    get extractImages(): boolean | undefined;
+    set extractImages(value: boolean | null | undefined);
+    get extractMetadata(): boolean | undefined;
+    set extractMetadata(value: boolean | null | undefined);
+    get headingStyle(): WasmHeadingStyle | undefined;
+    set headingStyle(value: WasmHeadingStyle | null | undefined);
+    get highlightStyle(): WasmHighlightStyle | undefined;
+    set highlightStyle(value: WasmHighlightStyle | null | undefined);
+    get includeDocumentStructure(): boolean | undefined;
+    set includeDocumentStructure(value: boolean | null | undefined);
+    get inferDimensions(): boolean | undefined;
+    set inferDimensions(value: boolean | null | undefined);
+    get keepInlineImagesIn(): string[] | undefined;
+    set keepInlineImagesIn(value: string[] | null | undefined);
+    get linkStyle(): WasmLinkStyle | undefined;
+    set linkStyle(value: WasmLinkStyle | null | undefined);
+    get listIndentType(): WasmListIndentType | undefined;
+    set listIndentType(value: WasmListIndentType | null | undefined);
+    get listIndentWidth(): number | undefined;
+    set listIndentWidth(value: number | null | undefined);
+    get maxImageSize(): bigint | undefined;
+    set maxImageSize(value: bigint | null | undefined);
+    get newlineStyle(): WasmNewlineStyle | undefined;
+    set newlineStyle(value: WasmNewlineStyle | null | undefined);
+    get outputFormat(): WasmOutputFormat | undefined;
+    set outputFormat(value: WasmOutputFormat | null | undefined);
+    get preprocessing(): WasmPreprocessingOptionsUpdate | undefined;
+    set preprocessing(value: WasmPreprocessingOptionsUpdate | null | undefined);
+    get preserveTags(): string[] | undefined;
+    set preserveTags(value: string[] | null | undefined);
+    get skipImages(): boolean | undefined;
+    set skipImages(value: boolean | null | undefined);
+    get stripNewlines(): boolean | undefined;
+    set stripNewlines(value: boolean | null | undefined);
+    get stripTags(): string[] | undefined;
+    set stripTags(value: string[] | null | undefined);
+    get strongEmSymbol(): string | undefined;
+    set strongEmSymbol(value: string | null | undefined);
+    get subSymbol(): string | undefined;
+    set subSymbol(value: string | null | undefined);
+    get supSymbol(): string | undefined;
+    set supSymbol(value: string | null | undefined);
+    get whitespaceMode(): WasmWhitespaceMode | undefined;
+    set whitespaceMode(value: WasmWhitespaceMode | null | undefined);
+    get wrap(): boolean | undefined;
+    set wrap(value: boolean | null | undefined);
+    get wrapWidth(): number | undefined;
+    set wrapWidth(value: number | null | undefined);
+}
+
+export class WasmConversionResult {
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor(metadata?: WasmHtmlMetadata | null, tables?: WasmTableData[] | null, images?: string[] | null, warnings?: WasmProcessingWarning[] | null, content?: string | null, document?: WasmDocumentStructure | null);
+    get content(): string | undefined;
+    set content(value: string | null | undefined);
+    get document(): WasmDocumentStructure | undefined;
+    set document(value: WasmDocumentStructure | null | undefined);
+    images: string[];
+    metadata: WasmHtmlMetadata;
+    tables: WasmTableData[];
+    warnings: WasmProcessingWarning[];
+}
+
+export class WasmDocumentMetadata {
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor(keywords?: string[] | null, open_graph?: any | null, twitter_card?: any | null, meta_tags?: any | null, title?: string | null, description?: string | null, author?: string | null, canonical_url?: string | null, base_href?: string | null, language?: string | null, text_direction?: WasmTextDirection | null);
+    get author(): string | undefined;
+    set author(value: string | null | undefined);
+    get baseHref(): string | undefined;
+    set baseHref(value: string | null | undefined);
+    get canonicalUrl(): string | undefined;
+    set canonicalUrl(value: string | null | undefined);
+    get description(): string | undefined;
+    set description(value: string | null | undefined);
+    keywords: string[];
+    get language(): string | undefined;
+    set language(value: string | null | undefined);
+    metaTags: any;
+    openGraph: any;
+    get textDirection(): WasmTextDirection | undefined;
+    set textDirection(value: WasmTextDirection | null | undefined);
+    get title(): string | undefined;
+    set title(value: string | null | undefined);
+    twitterCard: any;
+}
+
+export class WasmDocumentNode {
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor(id: string, content: WasmNodeContent, children: Uint32Array, annotations: WasmTextAnnotation[], parent?: number | null, attributes?: any | null);
+    annotations: WasmTextAnnotation[];
+    get attributes(): any | undefined;
+    set attributes(value: any | null | undefined);
+    children: Uint32Array;
+    content: WasmNodeContent;
+    id: string;
+    get parent(): number | undefined;
+    set parent(value: number | null | undefined);
+}
+
+export class WasmDocumentStructure {
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor(nodes: WasmDocumentNode[], source_format?: string | null);
+    nodes: WasmDocumentNode[];
+    get sourceFormat(): string | undefined;
+    set sourceFormat(value: string | null | undefined);
+}
+
+export class WasmGridCell {
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor(content: string, row: number, col: number, row_span: number, col_span: number, is_header: boolean);
+    col: number;
+    colSpan: number;
+    content: string;
+    isHeader: boolean;
+    row: number;
+    rowSpan: number;
+}
+
+export class WasmHeaderMetadata {
+    free(): void;
+    [Symbol.dispose](): void;
+    isValid(): boolean;
+    constructor(level: number, text: string, depth: number, html_offset: number, id?: string | null);
+    depth: number;
+    htmlOffset: number;
+    get id(): string | undefined;
+    set id(value: string | null | undefined);
+    level: number;
+    text: string;
+}
+
+export enum WasmHeadingStyle {
+    Underlined = 0,
+    Atx = 1,
+    AtxClosed = 2,
+}
+
+export enum WasmHighlightStyle {
+    DoubleEqual = 0,
+    Html = 1,
+    Bold = 2,
+    None = 3,
+}
+
+export class WasmHtmlMetadata {
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor(document?: WasmDocumentMetadata | null, headers?: WasmHeaderMetadata[] | null, links?: WasmLinkMetadata[] | null, images?: WasmImageMetadata[] | null, structured_data?: WasmStructuredData[] | null);
+    document: WasmDocumentMetadata;
+    headers: WasmHeaderMetadata[];
+    images: WasmImageMetadata[];
+    links: WasmLinkMetadata[];
+    structuredData: WasmStructuredData[];
+}
+
+export class WasmImageMetadata {
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor(src: string, image_type: WasmImageType, attributes: any, alt?: string | null, title?: string | null, dimensions?: string | null);
+    get alt(): string | undefined;
+    set alt(value: string | null | undefined);
+    attributes: any;
+    get dimensions(): string | undefined;
+    set dimensions(value: string | null | undefined);
+    imageType: WasmImageType;
+    src: string;
+    get title(): string | undefined;
+    set title(value: string | null | undefined);
+}
+
+export enum WasmImageType {
+    DataUri = 0,
+    InlineSvg = 1,
+    External = 2,
+    Relative = 3,
+}
+
+export class WasmLinkMetadata {
+    free(): void;
+    [Symbol.dispose](): void;
+    static classifyLink(href: string): WasmLinkType;
+    constructor(href: string, text: string, link_type: WasmLinkType, rel: string[], attributes: any, title?: string | null);
+    attributes: any;
+    href: string;
+    linkType: WasmLinkType;
+    rel: string[];
+    text: string;
+    get title(): string | undefined;
+    set title(value: string | null | undefined);
+}
+
+export enum WasmLinkStyle {
+    Inline = 0,
+    Reference = 1,
+}
+
+export enum WasmLinkType {
+    Anchor = 0,
+    Internal = 1,
+    External = 2,
+    Email = 3,
+    Phone = 4,
+    Other = 5,
+}
 
-/**
- * Initialize panic hook for better error messages in the browser
- */
-export function init(): void;
+export enum WasmListIndentType {
+    Spaces = 0,
+    Tabs = 1,
+}
+
+export class WasmMetadataConfig {
+    free(): void;
+    [Symbol.dispose](): void;
+    anyEnabled(): boolean;
+    static default(): WasmMetadataConfig;
+    constructor(extract_document?: boolean | null, extract_headers?: boolean | null, extract_links?: boolean | null, extract_images?: boolean | null, extract_structured_data?: boolean | null, max_structured_data_size?: number | null);
+    extractDocument: boolean;
+    extractHeaders: boolean;
+    extractImages: boolean;
+    extractLinks: boolean;
+    extractStructuredData: boolean;
+    maxStructuredDataSize: number;
+}
+
+export class WasmMetadataConfigUpdate {
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor(extract_document?: boolean | null, extract_headers?: boolean | null, extract_links?: boolean | null, extract_images?: boolean | null, extract_structured_data?: boolean | null, max_structured_data_size?: number | null);
+    get extractDocument(): boolean | undefined;
+    set extractDocument(value: boolean | null | undefined);
+    get extractHeaders(): boolean | undefined;
+    set extractHeaders(value: boolean | null | undefined);
+    get extractImages(): boolean | undefined;
+    set extractImages(value: boolean | null | undefined);
+    get extractLinks(): boolean | undefined;
+    set extractLinks(value: boolean | null | undefined);
+    get extractStructuredData(): boolean | undefined;
+    set extractStructuredData(value: boolean | null | undefined);
+    get maxStructuredDataSize(): number | undefined;
+    set maxStructuredDataSize(value: number | null | undefined);
+}
+
+export enum WasmNewlineStyle {
+    Spaces = 0,
+    Backslash = 1,
+}
+
+export enum WasmNodeContent {
+    Heading = 0,
+    Paragraph = 1,
+    List = 2,
+    ListItem = 3,
+    Table = 4,
+    Image = 5,
+    Code = 6,
+    Quote = 7,
+    DefinitionList = 8,
+    DefinitionItem = 9,
+    RawBlock = 10,
+    MetadataBlock = 11,
+    Group = 12,
+}
+
+export enum WasmOutputFormat {
+    Markdown = 0,
+    Djot = 1,
+    Plain = 2,
+}
+
+export class WasmPreprocessingOptions {
+    free(): void;
+    [Symbol.dispose](): void;
+    static default(): WasmPreprocessingOptions;
+    constructor(enabled?: boolean | null, preset?: WasmPreprocessingPreset | null, remove_navigation?: boolean | null, remove_forms?: boolean | null);
+    enabled: boolean;
+    preset: WasmPreprocessingPreset;
+    removeForms: boolean;
+    removeNavigation: boolean;
+}
+
+export class WasmPreprocessingOptionsUpdate {
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor(enabled?: boolean | null, preset?: WasmPreprocessingPreset | null, remove_navigation?: boolean | null, remove_forms?: boolean | null);
+    get enabled(): boolean | undefined;
+    set enabled(value: boolean | null | undefined);
+    get preset(): WasmPreprocessingPreset | undefined;
+    set preset(value: WasmPreprocessingPreset | null | undefined);
+    get removeForms(): boolean | undefined;
+    set removeForms(value: boolean | null | undefined);
+    get removeNavigation(): boolean | undefined;
+    set removeNavigation(value: boolean | null | undefined);
+}
+
+export enum WasmPreprocessingPreset {
+    Minimal = 0,
+    Standard = 1,
+    Aggressive = 2,
+}
+
+export class WasmProcessingWarning {
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor(message: string, kind: WasmWarningKind);
+    kind: WasmWarningKind;
+    message: string;
+}
+
+export class WasmStructuredData {
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor(data_type: WasmStructuredDataType, raw_json: string, schema_type?: string | null);
+    dataType: WasmStructuredDataType;
+    rawJson: string;
+    get schemaType(): string | undefined;
+    set schemaType(value: string | null | undefined);
+}
+
+export enum WasmStructuredDataType {
+    JsonLd = 0,
+    Microdata = 1,
+    RDFa = 2,
+}
+
+export class WasmTableData {
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor(grid: WasmTableGrid, markdown: string);
+    grid: WasmTableGrid;
+    markdown: string;
+}
+
+export class WasmTableGrid {
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor(rows?: number | null, cols?: number | null, cells?: WasmGridCell[] | null);
+    cells: WasmGridCell[];
+    cols: number;
+    rows: number;
+}
+
+export class WasmTextAnnotation {
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor(start: number, end: number, kind: WasmAnnotationKind);
+    end: number;
+    kind: WasmAnnotationKind;
+    start: number;
+}
+
+export enum WasmTextDirection {
+    LeftToRight = 0,
+    RightToLeft = 1,
+    Auto = 2,
+}
+
+export enum WasmWarningKind {
+    ImageExtractionFailed = 0,
+    EncodingFallback = 1,
+    TruncatedInput = 2,
+    MalformedHtml = 3,
+    SanitizationApplied = 4,
+}
+
+export enum WasmWhitespaceMode {
+    Normalized = 0,
+    Strict = 1,
+}
+
+export function convert(html: string, options?: WasmConversionOptions | null): WasmConversionResult;
 
 export declare function initWasm(): Promise<void>;
 export declare const wasmReady: Promise<void>;