@gondola-lyrics/kit 0.3.0 → 0.4.0

package/README.md

@@ -10,9 +10,10 @@ npm install @gondola-lyrics/kit
 
 ## Supports
 
-| Format | Parse | Generate | Annotation tracks | Notes                                                                |
-| ------ | ----- | -------- | ----------------- | -------------------------------------------------------------------- |
-| LRC    | ✅    | ✅       | ✅                | Line and enhanced word timing, metadata, translations, romanizations |
+| Format | Line level | Word level | Annotation | Meta |
+| ------ | ---------- | ---------- | ---------- | ---- |
+| LRC    | ✅         | ✅         | ✅         | ✅   |
+| TTML   | ✅         | ✅         | ✅         | ✅   |
 
 ## Usage
 

package/dist/formats.d.ts

@@ -104,7 +104,7 @@ export declare type LyricFormat = 'lrc' | 'ttml';
 export declare const parse: (input: unknown, options?: LrcParseOptions & TtmlParseOptions) => ParseResult | null;
 
 /**
- * Source order, empty timed lines, and missing word times are preserved for model validation.
+ * 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.
  *

package/dist/formats.js

@@ -1,4 +1,4 @@
-import { AgentType, CreditRole, LineType, LyricStatus, Timing, WordType, canonicalizeLyric, deriveLanguageUsages, getWordsText, makeAgent, makeLineAnnotation, makeLineAnnotationRoman, makeLineAnnotationTranslation, makeLineBackground, makeLineContentText, makeLineContentWords, makeLineNormal, makeLyric, makeMeta, makeMetaCredit, makeText, makeTimeRange, makeUnknownEntry, makeWordAnnotation, makeWordAnnotationRuby, makeWordAnnotationToken, makeWordNormal, makeWordSpace, removeOffset, resolveAnnotationItemTime, resolveAnnotationTokenTime, validateLyric } from "@gondola-lyrics/model/runtime";
+import { AgentType, CreditRole, LineType, LyricStatus, Timing, WordType, canonicalizeLyric, deriveLanguageUsages, getWordsText, makeAgent, makeLineAnnotation, makeLineAnnotationRoman, makeLineAnnotationTranslation, makeLineBackground, makeLineContentText, makeLineContentWords, makeLineInstrumental, makeLineNormal, makeLyric, makeMeta, makeMetaCredit, makeText, makeTimeRange, makeUnknownEntry, makeWordAnnotation, makeWordAnnotationRuby, makeWordAnnotationToken, makeWordNormal, makeWordSpace, removeOffset, resolveAnnotationItemTime, resolveAnnotationTokenTime, validateLyric } from "@gondola-lyrics/model/runtime";
 //#region src/utils/annotation.ts
 /**
 * An annotation line carries its text in either field, depending on whether the track used word tags.
@@ -1184,14 +1184,20 @@ var readWords$1 = (text, lineStart) => {
 /**
 * A line ends at the next line's start; without one, it ends at its final word's end.
 * An open word is closed by the next timed word, or by the line end, so every sung word stays inside the line.
+* Empty timed rows represent instrumental time rather than sung content.
 */
 var readLine$1 = (text, start, nextStart) => {
+	const trimmed = text.trim();
+	let end = nextStart !== void 0 && nextStart >= start ? nextStart : void 0;
+	if (trimmed === "") return makeLineInstrumental({ time: makeTimeRange({
+		start,
+		end
+	}) });
 	const wordTimed = isWordTimed(text);
 	const { drafts, closeSegment } = wordTimed ? readWords$1(text, start) : {
 		drafts: [],
 		closeSegment: () => {}
 	};
-	let end = nextStart !== void 0 && nextStart >= start ? nextStart : void 0;
 	if (end === void 0) end = [...drafts].reverse().find((draft) => !draft.space && draft.start !== void 0)?.end;
 	closeSegment(end);
 	const words = drafts.map((draft) => {
@@ -1209,7 +1215,7 @@ var readLine$1 = (text, start, nextStart) => {
 		start,
 		end
 	});
-	const content = wordTimed ? makeLineContentWords(words) : makeLineContentText(text.trim());
+	const content = wordTimed ? makeLineContentWords(words) : makeLineContentText(trimmed);
 	return makeLineNormal({
 		time,
 		content
@@ -1217,7 +1223,7 @@ var readLine$1 = (text, start, nextStart) => {
 };
 /**
 * Builds one line per timed row, so an annotation track reuses the original text's reading unchanged.
-* An empty timed row still yields a line, since it marks a gap rather than a parse failure.
+* Empty timed rows become instrumental lines bounded by the next timestamp when one is usable.
 */
 var readLines = (timed) => {
 	const lines = [];
@@ -1247,7 +1253,7 @@ var parseLrcText = (text) => {
 	});
 };
 /**
-* Source order, empty timed lines, and missing word times are preserved for model validation.
+* 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.
 *