@gondola-lyrics/kit 0.4.0 → 0.6.0

package/dist/generator.d.ts

@@ -3,15 +3,18 @@ import { runtime } from '@gondola-lyrics/model';
 /**
  * Generates text in the requested format, which need not match `lyric.format`.
  *
- * The writer map pairs each format's options with its result and requires a writer for every supported format.
+ * The writer map pairs options with results only for formats that have an implemented writer.
  * An unknown target returns `null`.
  */
-export declare const generate: <Target extends LyricFormat>(lyric: runtime.Lyric, target: Target, options?: GenerateOptions[Target]) => GenerateResults[Target] | null;
+export declare const generate: <Target extends GenerateFormat>(lyric: runtime.Lyric, target: Target, options?: GenerateOptions[Target]) => GenerateResults[Target] | null;
+
+export declare type GenerateFormat = keyof GenerateOptions;
 
 /**
  * Generates the LRC text plus the annotations a single file cannot hold.
  *
  * Word tags appear only for a word-timed lyric when `wordTiming` is not `none`; otherwise every line stays whole.
+ * Word romanizations retain token boundaries; explicit line romanizations take precedence for the same language.
  */
 export declare const generateLrc: (lyric: runtime.Lyric, options?: LrcGenerateOptions) => LrcGenerateResult;
 
@@ -30,6 +33,7 @@ declare interface GenerateResults {
  *
  * Offsets are baked into timestamps; a negative result or a missing required time throws.
  * Profile mappings retain the lead agent and first AMLL ruby, omitting unsupported fields and instrumental nodes.
+ * Word romanizations are emitted as line text without their token timing.
  */
 export declare const generateTtml: (lyric: runtime.Lyric, options?: TtmlGenerateOptions) => TtmlGenerateResult;
 
@@ -63,7 +67,7 @@ export declare type LrcGenerateResult = LrcContent;
 /**
  * Values match the lowercase format names stored in `Lyric.format`.
  */
-export declare type LyricFormat = 'lrc' | 'ttml';
+export declare type LyricFormat = 'lrc' | 'qrc' | 'krc' | 'kwrc' | 'yrc' | 'ttml';
 
 export declare interface TtmlGenerateOptions {
     /**

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 import { Diagnostic } from '@gondola-lyrics/model/runtime';
 import { runtime } from '@gondola-lyrics/model';
 
+export declare const DEFAULT_CREDIT_NAME_SEPARATORS: readonly ["+", "：", "/"];
+
 /**
  * Derives emphasis for normal words in lead and background vocals using complete, valid word ranges.
  * The stored word duration must strictly exceed durationThreshold; metadata offset and duration have no effect.
@@ -29,6 +31,32 @@ export declare interface DeriveWordEmphasisOptions {
  */
 export declare const detectFormat: (input: unknown) => LyricFormat | undefined;
 
+/**
+ * Extracts colon-prefixed performers and carries them across nonempty normal lines, replacing their existing agent lists.
+ * Missing bindings enables legacy name inference; supplied bindings accept exact prefixes and reset propagation on unmatched prefixes.
+ * Removing prefixes preserves retained line and word times, but drops prefix-only lines with their attached content.
+ *
+ * @returns The input when unchanged, or a new lyric sharing all unchanged nodes.
+ *
+ * @throws {TypeError} If bindings reference an agent id absent from lyric.agents.
+ */
+export declare const extractAgents: (lyric: runtime.Lyric, options?: ExtractAgentsOptions) => runtime.Lyric;
+
+export declare interface ExtractAgentsOptions {
+    /**
+     * Maps complete, trimmed prefixes to existing agent ids, preserving array order for joint performers.
+     * Matching is case-sensitive and preserves internal whitespace; an empty object disables automatic inference.
+     * Omitting this option enables legacy name inference; explicit bindings override its clock exclusion.
+     */
+    bindings?: Readonly<Record<string, string | readonly string[]>>;
+    /**
+     * Removes matched prefixes and drops lines left with no sung text, including their attached content.
+     *
+     * @default true
+     */
+    removePrefixes?: boolean;
+}
+
 /**
  * Pulls bracketed background vocals out of the sung lines and attaches them to the line they accompany.
  *
@@ -61,18 +89,56 @@ export declare interface ExtractBackgroundLinesOptions {
     crossLine?: boolean;
 }
 
+/**
+ * Preserves source labels and name spelling while matching normalized credit labels in normal lead lines.
+ * Merges names by role and original label without inferring their language.
+ * Unknown metadata is processed only when matchUnknowns is enabled; consumed entries leave the unknown list.
+ *
+ * @returns The input when unchanged, or a new lyric sharing all unchanged nodes.
+ */
+export declare const extractCredits: (lyric: runtime.Lyric, options?: ExtractCreditsOptions) => runtime.Lyric;
+
+export declare interface ExtractCreditsOptions {
+    /**
+     * Matches existing unknown metadata keys as credit labels and consumes fully readable matches.
+     * Values use nameSeparators; unrecognized keys and values with no readable names remain unchanged.
+     *
+     * @default false
+     */
+    matchUnknowns?: boolean;
+    /**
+     * Removes successfully extracted source lines together with their backgrounds and annotations.
+     * Extracted roles and names remain in metadata; attached content is not moved to other lines.
+     *
+     * Refreshes language usages and falls back to line timing when no word-level content remains.
+     *
+     * @default false
+     */
+    removeSourceLines?: boolean;
+    /**
+     * Splits names at literal separators and ignores empty strings; an empty list preserves the complete source name.
+     * Longer separators take precedence so overlapping delimiters remain predictable.
+     *
+     * @default DEFAULT_CREDIT_NAME_SEPARATORS
+     */
+    nameSeparators?: readonly string[];
+}
+
 /**
  * Generates text in the requested format, which need not match `lyric.format`.
  *
- * The writer map pairs each format's options with its result and requires a writer for every supported format.
+ * The writer map pairs options with results only for formats that have an implemented writer.
  * An unknown target returns `null`.
  */
-export declare const generate: <Target extends LyricFormat>(lyric: runtime.Lyric, target: Target, options?: GenerateOptions[Target]) => GenerateResults[Target] | null;
+export declare const generate: <Target extends GenerateFormat>(lyric: runtime.Lyric, target: Target, options?: GenerateOptions[Target]) => GenerateResults[Target] | null;
+
+export declare type GenerateFormat = keyof GenerateOptions;
 
 /**
  * Generates the LRC text plus the annotations a single file cannot hold.
  *
  * Word tags appear only for a word-timed lyric when `wordTiming` is not `none`; otherwise every line stays whole.
+ * Word romanizations retain token boundaries; explicit line romanizations take precedence for the same language.
  */
 export declare const generateLrc: (lyric: runtime.Lyric, options?: LrcGenerateOptions) => LrcGenerateResult;
 
@@ -91,6 +157,7 @@ declare interface GenerateResults {
  *
  * Offsets are baked into timestamps; a negative result or a missing required time throws.
  * Profile mappings retain the lead agent and first AMLL ruby, omitting unsupported fields and instrumental nodes.
+ * Word romanizations are emitted as line text without their token timing.
  */
 export declare const generateTtml: (lyric: runtime.Lyric, options?: TtmlGenerateOptions) => TtmlGenerateResult;
 
@@ -196,6 +263,16 @@ export declare const InsertSpacesRules: {
     readonly TRIM_INSIDE_SYMBOLS: "trimInsideSymbols";
 };
 
+declare interface KrcContent {
+    original: string;
+}
+
+export declare type KrcParseInput = KrcContent;
+
+export declare interface KwrcParseInput {
+    original: string;
+}
+
 declare interface LrcContent {
     original: string;
     translations?: string;
@@ -231,28 +308,86 @@ export declare interface LrcParseOptions {
      * Defaults to `0`, which requires an exact match.
      */
     annotationTolerance?: number;
+    /**
+     * Maximum roman token drift outside a matched word, in milliseconds; matched boundaries are adjusted to that word.
+     * Original word timing is preserved, and incomplete word matches retain the source line romanization.
+     *
+     * @default 0
+     */
+    wordAnnotationTolerance?: number;
+    /**
+     * Recovers unmatched roman fragments from unique two-kana combination starts or equal-sized gaps between timing anchors.
+     * Only a base kana followed by its small kana combines; doubled consonants and long vowels retain the whole line romanization.
+     * Recovered token times are clipped to their original word; untimed fragments inherit its range.
+     *
+     * @default false
+     */
+    wordAnnotationFallback?: boolean;
 }
 
 /**
  * Values match the lowercase format names stored in `Lyric.format`.
  */
-export declare type LyricFormat = 'lrc' | 'ttml';
+export declare type LyricFormat = 'lrc' | 'qrc' | 'krc' | 'kwrc' | 'yrc' | 'ttml';
+
+/**
+ * Categories the bundled filter rules identify, in rule order.
+ */
+export declare const NON_LYRIC_CATEGORIES: readonly string[];
 
 /**
  * Unrecognized text returns `null`; a recognized format returns its canonical lyric and diagnostics.
  * Annotation tracks travel with the source and are attached by the format's parser.
  */
-export declare const parse: (input: unknown, options?: LrcParseOptions & TtmlParseOptions) => ParseResult | null;
+export declare const parse: (input: unknown, options?: LrcParseOptions & QrcParseOptions & TtmlParseOptions & YrcParseOptions) => ParseResult | null;
+
+/**
+ * Parses decrypted Kugou lyrics, retaining explicit durations and attaching embedded annotations by source slot.
+ *
+ * A source carrying no KRC row is read as LRC, so a platform fallback keeps its container annotations.
+ * Placeholder slots carry no annotation, so they never keep a credit line in the stream.
+ * Kana supplies whole-word ruby; type 0 language tracks retain complete line romanization.
+ * Incomplete metadata remains available in unknowns, and source timing violations remain visible in diagnostics.
+ *
+ * @param input Decrypted plaintext or an object containing its original text.
+ *
+ * @returns Canonical lyrics and model diagnostics; no readable timed rows yields INVALID status.
+ */
+export declare const parseKrc: (input: string | KrcParseInput) => ParseResult;
+
+/**
+ * Parses decoded KWRC with explicit word durations and structurally verified embedded translations.
+ *
+ * Missing or conflicting parameters and unsafe word calculations retain the complete row as line-level text.
+ * Plain LRC remains readable; offset is stored as metadata without changing source timestamps.
+ *
+ * @param input Decoded plaintext or an object containing its original text.
+ *
+ * @returns Canonical lyrics and model diagnostics; no readable timed rows yields INVALID status.
+ */
+export declare const parseKwrc: (input: string | KwrcParseInput) => ParseResult;
 
 /**
  * Empty timed rows become instrumental lines; source order and missing word times remain for model validation.
  *
  * Annotation tracks are read as lines too and attached by timestamp, and rows that match no line are dropped.
+ * Complete roman tracks attach to words by timing and optional local recovery; other tracks retain their source line text.
  *
  * `INVALID` means no readable timed lines; the returned diagnostics carry whatever the canonical tree breaks.
  */
 export declare const parseLrc: (input: string | LrcParseInput, options?: LrcParseOptions) => ParseResult;
 
+/**
+ * Parses plaintext or XML QRC, retaining explicit timing, word romanization, and ruby from kana metadata.
+ * Original-track kana supplies ruby and is removed from the returned metadata.
+ *
+ * @param input Original lyrics with optional translation and romanization tracks.
+ * @param options Independent line and word tolerances, with optional local roman recovery.
+ *
+ * @returns Canonical lyrics and source diagnostics; an empty result has INVALID status.
+ */
+export declare const parseQrc: (input: string | QrcParseInput, options?: QrcParseOptions) => ParseResult;
+
 /**
  * A parsed lyric in canonical form, with every rule it breaks.
  */
@@ -269,6 +404,77 @@ export declare interface ParseResult {
  */
 export declare const parseTtml: (input: TtmlParseInput, options?: TtmlParseOptions) => ParseResult;
 
+/**
+ * Parses native YRC or LRC fallback, keeping JSON display rows separate from annotation matching.
+ * Explicit line and word durations remain unchanged, including zero durations and source timing violations.
+ * JSON credit content becomes separate plain-text unknown entries sharing the source label and is omitted from lyric lines.
+ *
+ * @param input Plaintext tracks on the same timeline: yrc with ytlrc/yromalrc, or lrc with tlyric/romalrc.
+ * @param options Independent line and word tolerances, with optional local roman recovery.
+ *
+ * @returns Canonical lyrics and model diagnostics; no readable timed rows yields INVALID status.
+ */
+export declare const parseYrc: (input: string | YrcParseInput, options?: YrcParseOptions) => ParseResult;
+
+declare interface QrcContent {
+    original: string;
+    translations?: string;
+    romans?: string;
+}
+
+export declare type QrcParseInput = QrcContent;
+
+export declare interface QrcParseOptions {
+    /**
+     * Extra tolerance in milliseconds for line annotations left after exact time and row order matching.
+     *
+     * @default 0
+     */
+    annotationTolerance?: number;
+    /**
+     * Extra word-boundary tolerance in milliseconds; native QRC tracks allow at least 1ms for rounding.
+     * LRC auxiliary tracks use exact word boundaries by default, and incomplete matches retain the whole line romanization.
+     *
+     * @default 0
+     */
+    wordAnnotationTolerance?: number;
+    /**
+     * Recovers unmatched roman fragments from unique two-kana combination starts or equal-sized gaps between timing anchors.
+     * Only a base kana followed by its small kana combines; doubled consonants and long vowels retain the whole line romanization.
+     * Recovered token times are clipped to their original word; untimed fragments inherit its range.
+     *
+     * @default false
+     */
+    wordAnnotationFallback?: boolean;
+}
+
+/**
+ * Removes normal lead lines matched by the shared notice rules and, when musicInfo is provided, first-line song information.
+ * The first non-empty normal line must have one literal " - " separator and a known title and artist on opposite sides; either order and extra text such as bracketed aliases are accepted.
+ * Drops attached annotations and backgrounds, refreshes language usages, and falls back to line timing when no word-level content remains.
+ *
+ * @returns The input when unchanged, or a new lyric sharing all unchanged nodes.
+ */
+export declare const removeNonLyricLines: (lyric: runtime.Lyric, options?: RemoveNonLyricLinesOptions) => runtime.Lyric;
+
+export declare interface RemoveNonLyricLinesOptions {
+    /**
+     * Removes lines identified under these categories; an empty list skips the shared rules.
+     * First-line music information is selected independently.
+     *
+     * @default NON_LYRIC_CATEGORIES
+     */
+    categories?: readonly string[];
+    /**
+     * Enables first-line music-information matching using these known titles and artists.
+     * Omitting this option, or leaving either list empty, skips the check; lyric metadata is not inferred.
+     */
+    musicInfo?: {
+        titles?: readonly string[];
+        artists?: readonly string[];
+    };
+}
+
 /**
  * Removes the brackets some sources wrap around background vocals.
  *
@@ -307,4 +513,36 @@ export declare interface TtmlParseOptions {
 
 export declare type TtmlProfile = 'amll' | 'itunes';
 
+declare interface YrcContent {
+    original: string;
+    translations?: string;
+    romans?: string;
+}
+
+export declare type YrcParseInput = YrcContent;
+
+export declare interface YrcParseOptions {
+    /**
+     * Extra timestamp drift allowed after exact and source-precision matching, in milliseconds.
+     * Tracks must share the original timeline; equal row counts never enable order matching.
+     *
+     * @default 0
+     */
+    annotationTolerance?: number;
+    /**
+     * Maximum roman token drift outside a matched word, in milliseconds; matched boundaries are adjusted to that word.
+     * Original word timing is preserved, and incomplete matches retain the whole line romanization.
+     *
+     * @default 0
+     */
+    wordAnnotationTolerance?: number;
+    /**
+     * Recovers roman fragments from unique two-kana combination starts or equal-sized gaps between timing anchors.
+     * Recovered token times are clipped to their original word; untimed fragments inherit its range.
+     *
+     * @default false
+     */
+    wordAnnotationFallback?: boolean;
+}
+
 export { }

package/dist/index.js

@@ -1,5 +1,5 @@
-import { detectFormat, generate, generateLrc, generateTtml, parse, parseLrc, parseTtml } from "./formats.js";
-import { InsertSpacesRules, deriveWordEmphasis, extractBackgroundLines, insertInstrumentalLines, insertSpacesInLines, stripBackgroundBrackets } from "./transforms.js";
+import { detectFormat, generate, generateLrc, generateTtml, parse, parseKrc, parseKwrc, parseLrc, parseQrc, parseTtml, parseYrc } from "./formats.js";
+import { DEFAULT_CREDIT_NAME_SEPARATORS, InsertSpacesRules, NON_LYRIC_CATEGORIES, deriveWordEmphasis, extractAgents, extractBackgroundLines, extractCredits, insertInstrumentalLines, insertSpacesInLines, removeNonLyricLines, stripBackgroundBrackets } from "./transforms.js";
 import "./parser.js";
 import "./generator.js";
-export { InsertSpacesRules, deriveWordEmphasis, detectFormat, extractBackgroundLines, generate, generateLrc, generateTtml, insertInstrumentalLines, insertSpacesInLines, parse, parseLrc, parseTtml, stripBackgroundBrackets };
+export { DEFAULT_CREDIT_NAME_SEPARATORS, InsertSpacesRules, NON_LYRIC_CATEGORIES, deriveWordEmphasis, detectFormat, extractAgents, extractBackgroundLines, extractCredits, generate, generateLrc, generateTtml, insertInstrumentalLines, insertSpacesInLines, parse, parseKrc, parseKwrc, parseLrc, parseQrc, parseTtml, parseYrc, removeNonLyricLines, stripBackgroundBrackets };

package/dist/parser.d.ts

@@ -1,6 +1,8 @@
 import { Diagnostic } from '@gondola-lyrics/model/runtime';
 import { runtime } from '@gondola-lyrics/model';
 
+export declare const DEFAULT_CREDIT_NAME_SEPARATORS: readonly ["+", "：", "/"];
+
 /**
  * Derives emphasis for normal words in lead and background vocals using complete, valid word ranges.
  * The stored word duration must strictly exceed durationThreshold; metadata offset and duration have no effect.
@@ -29,6 +31,32 @@ export declare interface DeriveWordEmphasisOptions {
  */
 export declare const detectFormat: (input: unknown) => LyricFormat | undefined;
 
+/**
+ * Extracts colon-prefixed performers and carries them across nonempty normal lines, replacing their existing agent lists.
+ * Missing bindings enables legacy name inference; supplied bindings accept exact prefixes and reset propagation on unmatched prefixes.
+ * Removing prefixes preserves retained line and word times, but drops prefix-only lines with their attached content.
+ *
+ * @returns The input when unchanged, or a new lyric sharing all unchanged nodes.
+ *
+ * @throws {TypeError} If bindings reference an agent id absent from lyric.agents.
+ */
+export declare const extractAgents: (lyric: runtime.Lyric, options?: ExtractAgentsOptions) => runtime.Lyric;
+
+export declare interface ExtractAgentsOptions {
+    /**
+     * Maps complete, trimmed prefixes to existing agent ids, preserving array order for joint performers.
+     * Matching is case-sensitive and preserves internal whitespace; an empty object disables automatic inference.
+     * Omitting this option enables legacy name inference; explicit bindings override its clock exclusion.
+     */
+    bindings?: Readonly<Record<string, string | readonly string[]>>;
+    /**
+     * Removes matched prefixes and drops lines left with no sung text, including their attached content.
+     *
+     * @default true
+     */
+    removePrefixes?: boolean;
+}
+
 /**
  * Pulls bracketed background vocals out of the sung lines and attaches them to the line they accompany.
  *
@@ -61,6 +89,41 @@ export declare interface ExtractBackgroundLinesOptions {
     crossLine?: boolean;
 }
 
+/**
+ * Preserves source labels and name spelling while matching normalized credit labels in normal lead lines.
+ * Merges names by role and original label without inferring their language.
+ * Unknown metadata is processed only when matchUnknowns is enabled; consumed entries leave the unknown list.
+ *
+ * @returns The input when unchanged, or a new lyric sharing all unchanged nodes.
+ */
+export declare const extractCredits: (lyric: runtime.Lyric, options?: ExtractCreditsOptions) => runtime.Lyric;
+
+export declare interface ExtractCreditsOptions {
+    /**
+     * Matches existing unknown metadata keys as credit labels and consumes fully readable matches.
+     * Values use nameSeparators; unrecognized keys and values with no readable names remain unchanged.
+     *
+     * @default false
+     */
+    matchUnknowns?: boolean;
+    /**
+     * Removes successfully extracted source lines together with their backgrounds and annotations.
+     * Extracted roles and names remain in metadata; attached content is not moved to other lines.
+     *
+     * Refreshes language usages and falls back to line timing when no word-level content remains.
+     *
+     * @default false
+     */
+    removeSourceLines?: boolean;
+    /**
+     * Splits names at literal separators and ignores empty strings; an empty list preserves the complete source name.
+     * Longer separators take precedence so overlapping delimiters remain predictable.
+     *
+     * @default DEFAULT_CREDIT_NAME_SEPARATORS
+     */
+    nameSeparators?: readonly string[];
+}
+
 /**
  * Inserts derived instrumental lines into uncovered gaps on the stored timeline, starting at zero.
  * Existing lines and background vocals occupy their full ranges; an unknown end blocks later gaps.
@@ -163,6 +226,16 @@ export declare const InsertSpacesRules: {
     readonly TRIM_INSIDE_SYMBOLS: "trimInsideSymbols";
 };
 
+declare interface KrcContent {
+    original: string;
+}
+
+export declare type KrcParseInput = KrcContent;
+
+export declare interface KwrcParseInput {
+    original: string;
+}
+
 declare interface LrcContent {
     original: string;
     translations?: string;
@@ -177,28 +250,86 @@ export declare interface LrcParseOptions {
      * Defaults to `0`, which requires an exact match.
      */
     annotationTolerance?: number;
+    /**
+     * Maximum roman token drift outside a matched word, in milliseconds; matched boundaries are adjusted to that word.
+     * Original word timing is preserved, and incomplete word matches retain the source line romanization.
+     *
+     * @default 0
+     */
+    wordAnnotationTolerance?: number;
+    /**
+     * Recovers unmatched roman fragments from unique two-kana combination starts or equal-sized gaps between timing anchors.
+     * Only a base kana followed by its small kana combines; doubled consonants and long vowels retain the whole line romanization.
+     * Recovered token times are clipped to their original word; untimed fragments inherit its range.
+     *
+     * @default false
+     */
+    wordAnnotationFallback?: boolean;
 }
 
 /**
  * Values match the lowercase format names stored in `Lyric.format`.
  */
-export declare type LyricFormat = 'lrc' | 'ttml';
+export declare type LyricFormat = 'lrc' | 'qrc' | 'krc' | 'kwrc' | 'yrc' | 'ttml';
+
+/**
+ * Categories the bundled filter rules identify, in rule order.
+ */
+export declare const NON_LYRIC_CATEGORIES: readonly string[];
 
 /**
  * Unrecognized text returns `null`; a recognized format returns its canonical lyric and diagnostics.
  * Annotation tracks travel with the source and are attached by the format's parser.
  */
-export declare const parse: (input: unknown, options?: LrcParseOptions & TtmlParseOptions) => ParseResult | null;
+export declare const parse: (input: unknown, options?: LrcParseOptions & QrcParseOptions & TtmlParseOptions & YrcParseOptions) => ParseResult | null;
+
+/**
+ * Parses decrypted Kugou lyrics, retaining explicit durations and attaching embedded annotations by source slot.
+ *
+ * A source carrying no KRC row is read as LRC, so a platform fallback keeps its container annotations.
+ * Placeholder slots carry no annotation, so they never keep a credit line in the stream.
+ * Kana supplies whole-word ruby; type 0 language tracks retain complete line romanization.
+ * Incomplete metadata remains available in unknowns, and source timing violations remain visible in diagnostics.
+ *
+ * @param input Decrypted plaintext or an object containing its original text.
+ *
+ * @returns Canonical lyrics and model diagnostics; no readable timed rows yields INVALID status.
+ */
+export declare const parseKrc: (input: string | KrcParseInput) => ParseResult;
+
+/**
+ * Parses decoded KWRC with explicit word durations and structurally verified embedded translations.
+ *
+ * Missing or conflicting parameters and unsafe word calculations retain the complete row as line-level text.
+ * Plain LRC remains readable; offset is stored as metadata without changing source timestamps.
+ *
+ * @param input Decoded plaintext or an object containing its original text.
+ *
+ * @returns Canonical lyrics and model diagnostics; no readable timed rows yields INVALID status.
+ */
+export declare const parseKwrc: (input: string | KwrcParseInput) => ParseResult;
 
 /**
  * Empty timed rows become instrumental lines; source order and missing word times remain for model validation.
  *
  * Annotation tracks are read as lines too and attached by timestamp, and rows that match no line are dropped.
+ * Complete roman tracks attach to words by timing and optional local recovery; other tracks retain their source line text.
  *
  * `INVALID` means no readable timed lines; the returned diagnostics carry whatever the canonical tree breaks.
  */
 export declare const parseLrc: (input: string | LrcParseInput, options?: LrcParseOptions) => ParseResult;
 
+/**
+ * Parses plaintext or XML QRC, retaining explicit timing, word romanization, and ruby from kana metadata.
+ * Original-track kana supplies ruby and is removed from the returned metadata.
+ *
+ * @param input Original lyrics with optional translation and romanization tracks.
+ * @param options Independent line and word tolerances, with optional local roman recovery.
+ *
+ * @returns Canonical lyrics and source diagnostics; an empty result has INVALID status.
+ */
+export declare const parseQrc: (input: string | QrcParseInput, options?: QrcParseOptions) => ParseResult;
+
 /**
  * A parsed lyric in canonical form, with every rule it breaks.
  */
@@ -215,6 +346,77 @@ export declare interface ParseResult {
  */
 export declare const parseTtml: (input: TtmlParseInput, options?: TtmlParseOptions) => ParseResult;
 
+/**
+ * Parses native YRC or LRC fallback, keeping JSON display rows separate from annotation matching.
+ * Explicit line and word durations remain unchanged, including zero durations and source timing violations.
+ * JSON credit content becomes separate plain-text unknown entries sharing the source label and is omitted from lyric lines.
+ *
+ * @param input Plaintext tracks on the same timeline: yrc with ytlrc/yromalrc, or lrc with tlyric/romalrc.
+ * @param options Independent line and word tolerances, with optional local roman recovery.
+ *
+ * @returns Canonical lyrics and model diagnostics; no readable timed rows yields INVALID status.
+ */
+export declare const parseYrc: (input: string | YrcParseInput, options?: YrcParseOptions) => ParseResult;
+
+declare interface QrcContent {
+    original: string;
+    translations?: string;
+    romans?: string;
+}
+
+export declare type QrcParseInput = QrcContent;
+
+export declare interface QrcParseOptions {
+    /**
+     * Extra tolerance in milliseconds for line annotations left after exact time and row order matching.
+     *
+     * @default 0
+     */
+    annotationTolerance?: number;
+    /**
+     * Extra word-boundary tolerance in milliseconds; native QRC tracks allow at least 1ms for rounding.
+     * LRC auxiliary tracks use exact word boundaries by default, and incomplete matches retain the whole line romanization.
+     *
+     * @default 0
+     */
+    wordAnnotationTolerance?: number;
+    /**
+     * Recovers unmatched roman fragments from unique two-kana combination starts or equal-sized gaps between timing anchors.
+     * Only a base kana followed by its small kana combines; doubled consonants and long vowels retain the whole line romanization.
+     * Recovered token times are clipped to their original word; untimed fragments inherit its range.
+     *
+     * @default false
+     */
+    wordAnnotationFallback?: boolean;
+}
+
+/**
+ * Removes normal lead lines matched by the shared notice rules and, when musicInfo is provided, first-line song information.
+ * The first non-empty normal line must have one literal " - " separator and a known title and artist on opposite sides; either order and extra text such as bracketed aliases are accepted.
+ * Drops attached annotations and backgrounds, refreshes language usages, and falls back to line timing when no word-level content remains.
+ *
+ * @returns The input when unchanged, or a new lyric sharing all unchanged nodes.
+ */
+export declare const removeNonLyricLines: (lyric: runtime.Lyric, options?: RemoveNonLyricLinesOptions) => runtime.Lyric;
+
+export declare interface RemoveNonLyricLinesOptions {
+    /**
+     * Removes lines identified under these categories; an empty list skips the shared rules.
+     * First-line music information is selected independently.
+     *
+     * @default NON_LYRIC_CATEGORIES
+     */
+    categories?: readonly string[];
+    /**
+     * Enables first-line music-information matching using these known titles and artists.
+     * Omitting this option, or leaving either list empty, skips the check; lyric metadata is not inferred.
+     */
+    musicInfo?: {
+        titles?: readonly string[];
+        artists?: readonly string[];
+    };
+}
+
 /**
  * Removes the brackets some sources wrap around background vocals.
  *
@@ -234,4 +436,36 @@ export declare interface TtmlParseOptions {
 
 export declare type TtmlProfile = 'amll' | 'itunes';
 
+declare interface YrcContent {
+    original: string;
+    translations?: string;
+    romans?: string;
+}
+
+export declare type YrcParseInput = YrcContent;
+
+export declare interface YrcParseOptions {
+    /**
+     * Extra timestamp drift allowed after exact and source-precision matching, in milliseconds.
+     * Tracks must share the original timeline; equal row counts never enable order matching.
+     *
+     * @default 0
+     */
+    annotationTolerance?: number;
+    /**
+     * Maximum roman token drift outside a matched word, in milliseconds; matched boundaries are adjusted to that word.
+     * Original word timing is preserved, and incomplete matches retain the whole line romanization.
+     *
+     * @default 0
+     */
+    wordAnnotationTolerance?: number;
+    /**
+     * Recovers roman fragments from unique two-kana combination starts or equal-sized gaps between timing anchors.
+     * Recovered token times are clipped to their original word; untimed fragments inherit its range.
+     *
+     * @default false
+     */
+    wordAnnotationFallback?: boolean;
+}
+
 export { }