trackparse 0.2.1 → 0.3.1

package/dist/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 // src/data.generated.ts
-var SPEC_VERSION = "0.2.1";
+var SPEC_VERSION = "0.3.1";
 var descriptorsData = {
   "descriptors": [
     "radio",
@@ -475,6 +475,19 @@ function isLetterAt(s, index) {
   if (cp === void 0) return false;
   return LETTER.test(String.fromCodePoint(cp));
 }
+function isLetterBefore(s, index) {
+  const low = s.charCodeAt(index - 1);
+  const high = s.charCodeAt(index - 2);
+  const pair = low >= 56320 && low <= 57343 && high >= 55296 && high <= 56319;
+  const start = pair ? index - 2 : index - 1;
+  return start >= 0 && isLetterAt(s, start);
+}
+var UPPER = /^\p{Lu}$/u;
+function isUpperAt(s, index) {
+  const cp = s.codePointAt(index);
+  if (cp === void 0) return false;
+  return UPPER.test(String.fromCodePoint(cp));
+}
 function asciiLower(s) {
   let out = "";
   for (let i = 0; i < s.length; i++) {
@@ -1687,7 +1700,7 @@ function prelude(normalized, requested, ctx) {
   let str = stripPlatformSuffixes(normalized, ctx, junk);
   const hadPlatform = junk.length > 0;
   let mode;
-  if (requested === "clean" || requested === "youtube" || requested === "filename") {
+  if (requested === "clean" || requested === "youtube" || requested === "filename" || requested === "tracklist") {
     mode = requested;
   } else if (extensionOf(str, ctx)) {
     mode = "filename";
@@ -1749,7 +1762,7 @@ function splitYoutubePipes(skel, ctx, junk) {
   return { working: { text: "", base: 0 }, pipeTitle: null };
 }
 
-// src/prefix.ts
+// src/digits.ts
 function digitRun(s, from) {
   let i = from;
   while (isDigit(s[i])) i++;
@@ -1760,6 +1773,8 @@ function twoDigitsUpTo59(s, at) {
   const n = Number(s.slice(at, at + 2));
   return n <= 59 ? n : null;
 }
+
+// src/prefix.ts
 function matchTime(s, at) {
   const lead = digitRun(s, at);
   if (lead < 1 || lead > 2 || s[at + lead] !== ":") return null;
@@ -1877,6 +1892,8 @@ function splitAt(s, cutStart, cutEnd) {
 function findSeparator(input, ctx) {
   const { skel, mode } = input;
   const segments = splitAtSpacedDashes(skel, true);
+  if (mode === "tracklist")
+    return tracklistSeparator(skel, segments, input.listContext === true, ctx);
   const { remaining, peeled } = peelSuffixes(segments, false, ctx);
   if (remaining.length >= 2) {
     const first = remaining[0];
@@ -1893,6 +1910,46 @@ function findSeparator(input, ctx) {
   if (rest.text.length > 0 && artist === null) warn(ctx, "noSeparator");
   return { artist, title: rest, split: false, peeled };
 }
+function tracklistSeparator(skel, segments, listContext, ctx) {
+  if (segments.length >= 2) {
+    const first = segments[0];
+    const second = segments[1];
+    const lastSeg = segments[segments.length - 1];
+    const artist = first.skel.text.length > 0 ? first.skel : null;
+    const title = sliceSkel(skel, second.start, lastSeg.end);
+    return { artist, title, split: artist !== null, peeled: [] };
+  }
+  const rest = segments[0].skel;
+  const asym = asymmetricDash(rest.text);
+  if (asym >= 0) {
+    warn(ctx, "asymmetricDashSplit");
+    const parts = splitAt(rest, asym, asym + 1);
+    return { ...parts, split: parts.artist !== null, peeled: [] };
+  }
+  const underscore = rest.text.indexOf("_-_");
+  if (underscore >= 0) {
+    warn(ctx, "unspacedDashSplit");
+    const parts = splitAt(rest, underscore, underscore + 3);
+    return { ...parts, split: parts.artist !== null, peeled: [] };
+  }
+  if (listContext) {
+    const tight = tightUpperDash(rest.text);
+    if (tight >= 0) {
+      warn(ctx, "unspacedDashSplit");
+      const parts = splitAt(rest, tight, tight + 1);
+      return { ...parts, split: parts.artist !== null, peeled: [] };
+    }
+  }
+  if (rest.text.length > 0) warn(ctx, "noSeparator");
+  return { artist: null, title: rest, split: false, peeled: [] };
+}
+function tightUpperDash(t) {
+  for (let i = t.length - 2; i >= 1; i--) {
+    if (t[i] !== "-") continue;
+    if (isLetterBefore(t, i) && isUpperAt(t, i + 1)) return i;
+  }
+  return -1;
+}
 function splitWithoutSpacedDash(s, mode, ctx) {
   const asym = asymmetricDash(s.text);
   if (asym >= 0) {
@@ -2167,17 +2224,27 @@ function uploaderSkel(uploader) {
   if (u.length === 0) return null;
   return scan(u, UPLOADER_BASE).skel;
 }
-function run(input, options, t) {
+function stage(input, options, t) {
   const ctx = makeCtx(t, options);
   const norm = normalize(input);
   const requested = options.mode ?? "auto";
   const pre = prelude(norm, requested, ctx);
   const track = emptyTrack(typeof input === "string" ? input : "", pre.mode);
-  if (norm.length === 0) return track;
+  if (norm.length === 0) {
+    return { ctx, options, pre, track, working: null };
+  }
   const prefix = stripPrefixes(pre.working.text, pre.working.base, pre.mode, ctx);
   track.timestamp = prefix.timestamp;
   track.position = prefix.position;
   const working = skelOf({ text: prefix.rest, base: prefix.base }, ctx);
+  return { ctx, options, pre, track, working };
+}
+function run(input, options, t, listContext = false) {
+  return finish(stage(input, options, t), listContext);
+}
+function finish(st, listContext) {
+  const { ctx, options, pre, track, working } = st;
+  if (working === null) return track;
   const out = emptyExtracted();
   let artistSkel;
   let titleSkel;
@@ -2188,7 +2255,7 @@ function run(input, options, t) {
     relaxed = artistSkel !== null;
   } else {
     const sep = findSeparator(
-      { skel: working, mode: pre.mode, uploader: uploaderSkel(options.uploader) },
+      { skel: working, mode: pre.mode, uploader: uploaderSkel(options.uploader), listContext },
       ctx
     );
     addPeeled(out, sep.peeled);

package/dist/index.d.cts

@@ -1,89 +1,7 @@
-declare const SPEC_VERSION = "0.2.1";
+import { P as ParsedTrack, A as Artist, F as FormatOptions, a as ParseOptions } from './types-DqJSn18b.cjs';
+export { b as ArtistRole, c as ArtistSource, d as Flags, J as Junk, e as JunkKind, K as KeywordOptions, M as Mode, f as ModeOption, g as Position, T as Timestamp, V as Version, h as VersionDelimiter, i as VersionType, W as Warning } from './types-DqJSn18b.cjs';
 
-/** Public types. They mirror spec/schema/parsed-track.schema.json and options.schema.json. */
-type Mode = "clean" | "youtube" | "filename";
-type ModeOption = Mode | "auto";
-type ArtistRole = "primary" | "featured" | "remixer" | "producer";
-type ArtistSource = "artist" | "title" | "version";
-interface Artist {
-    name: string;
-    role: ArtistRole;
-    /** Raw joiner / marker text that preceded the name in its credit list; `null` for the first name. */
-    joiner: string | null;
-    source: ArtistSource;
-}
-type VersionType = "remix" | "bootleg" | "vip" | "edit" | "flip" | "refix" | "rework" | "mashup" | "blend" | "dub" | "mix" | "extended" | "radio" | "club" | "original" | "instrumental" | "acapella" | "live" | "acoustic" | "remaster" | "demo" | "reprise" | "cover" | "version" | "spedUp" | "slowed" | "nightcore";
-type VersionDelimiter = "(" | "[" | "{" | "-";
-interface Version {
-    type: VersionType;
-    raw: string;
-    artists: Artist[];
-    modifiers: string[];
-    descriptor: string | null;
-    year: number | null;
-    unknownArtist: boolean;
-    delimiter: VersionDelimiter;
-}
-type JunkKind = "video" | "audio" | "lyrics" | "quality" | "promo" | "platform" | "label" | "genre" | "other";
-interface Junk {
-    raw: string;
-    kind: JunkKind;
-}
-type Warning = "noSeparator" | "ambiguousSeparator" | "unspacedDashSplit" | "asymmetricDashSplit" | "bySplit" | "quotedTitleSplit" | "ambiguousMixCredit" | "unbalancedBrackets";
-interface Flags {
-    explicit: boolean;
-    clean: boolean;
-    unknownArtist: boolean;
-    unknownTitle: boolean;
-}
-interface Position {
-    raw: string;
-    number: number;
-}
-interface Timestamp {
-    raw: string;
-    seconds: number;
-}
-interface ParsedTrack {
-    input: string;
-    mode: Mode;
-    position: Position | null;
-    timestamp: Timestamp | null;
-    artists: Artist[];
-    title: string;
-    fullTitle: string;
-    versions: Version[];
-    year: number | null;
-    flags: Flags;
-    junk: Junk[];
-    warnings: Warning[];
-}
-interface KeywordOptions {
-    /** Extra version heads: key → version type. */
-    versionHeads?: Record<string, VersionType>;
-    descriptors?: string[];
-    genres?: string[];
-    /** Extra junk phrases: phrase → kind. */
-    junk?: Record<string, JunkKind>;
-    featMarkers?: string[];
-}
-interface ParseOptions {
-    mode?: ModeOption;
-    /** youtube mode: channel name used as the artist when no separator is found (R6.8). */
-    uploader?: string;
-    /** Names that must never be split (R7.3a). */
-    knownArtists?: string[];
-    splitAnd?: "auto" | "always" | "never";
-    keywords?: KeywordOptions;
-}
-interface FormatOptions {
-    feat?: "source" | "artist" | "title" | "omit";
-    featMarker?: string;
-    joiners?: "original" | "canonical";
-    versions?: "all" | "none";
-    producers?: boolean;
-    position?: boolean;
-}
+declare const SPEC_VERSION = "0.3.1";
 
 declare function format(track: ParsedTrack, options?: FormatOptions): string;
 /** All credited names: track artists plus every version's remixers, deduped by R0.4 key. */
@@ -101,4 +19,4 @@ declare function createParser(base?: ParseOptions): Parser;
 declare function parse(input: string, options?: ParseOptions): ParsedTrack;
 declare function parseArtists(input: string, options?: ParseOptions): Artist[];
 
-export { type Artist, type ArtistRole, type ArtistSource, type Flags, type FormatOptions, type Junk, type JunkKind, type KeywordOptions, type Mode, type ModeOption, type ParseOptions, type ParsedTrack, type Parser, type Position, SPEC_VERSION, type Timestamp, type Version, type VersionDelimiter, type VersionType, type Warning, allArtists, createParser, format, normalize, parse, parseArtists };
+export { Artist, FormatOptions, ParseOptions, ParsedTrack, type Parser, SPEC_VERSION, allArtists, createParser, format, normalize, parse, parseArtists };

package/dist/index.d.ts

@@ -1,89 +1,7 @@
-declare const SPEC_VERSION = "0.2.1";
+import { P as ParsedTrack, A as Artist, F as FormatOptions, a as ParseOptions } from './types-DqJSn18b.js';
+export { b as ArtistRole, c as ArtistSource, d as Flags, J as Junk, e as JunkKind, K as KeywordOptions, M as Mode, f as ModeOption, g as Position, T as Timestamp, V as Version, h as VersionDelimiter, i as VersionType, W as Warning } from './types-DqJSn18b.js';
 
-/** Public types. They mirror spec/schema/parsed-track.schema.json and options.schema.json. */
-type Mode = "clean" | "youtube" | "filename";
-type ModeOption = Mode | "auto";
-type ArtistRole = "primary" | "featured" | "remixer" | "producer";
-type ArtistSource = "artist" | "title" | "version";
-interface Artist {
-    name: string;
-    role: ArtistRole;
-    /** Raw joiner / marker text that preceded the name in its credit list; `null` for the first name. */
-    joiner: string | null;
-    source: ArtistSource;
-}
-type VersionType = "remix" | "bootleg" | "vip" | "edit" | "flip" | "refix" | "rework" | "mashup" | "blend" | "dub" | "mix" | "extended" | "radio" | "club" | "original" | "instrumental" | "acapella" | "live" | "acoustic" | "remaster" | "demo" | "reprise" | "cover" | "version" | "spedUp" | "slowed" | "nightcore";
-type VersionDelimiter = "(" | "[" | "{" | "-";
-interface Version {
-    type: VersionType;
-    raw: string;
-    artists: Artist[];
-    modifiers: string[];
-    descriptor: string | null;
-    year: number | null;
-    unknownArtist: boolean;
-    delimiter: VersionDelimiter;
-}
-type JunkKind = "video" | "audio" | "lyrics" | "quality" | "promo" | "platform" | "label" | "genre" | "other";
-interface Junk {
-    raw: string;
-    kind: JunkKind;
-}
-type Warning = "noSeparator" | "ambiguousSeparator" | "unspacedDashSplit" | "asymmetricDashSplit" | "bySplit" | "quotedTitleSplit" | "ambiguousMixCredit" | "unbalancedBrackets";
-interface Flags {
-    explicit: boolean;
-    clean: boolean;
-    unknownArtist: boolean;
-    unknownTitle: boolean;
-}
-interface Position {
-    raw: string;
-    number: number;
-}
-interface Timestamp {
-    raw: string;
-    seconds: number;
-}
-interface ParsedTrack {
-    input: string;
-    mode: Mode;
-    position: Position | null;
-    timestamp: Timestamp | null;
-    artists: Artist[];
-    title: string;
-    fullTitle: string;
-    versions: Version[];
-    year: number | null;
-    flags: Flags;
-    junk: Junk[];
-    warnings: Warning[];
-}
-interface KeywordOptions {
-    /** Extra version heads: key → version type. */
-    versionHeads?: Record<string, VersionType>;
-    descriptors?: string[];
-    genres?: string[];
-    /** Extra junk phrases: phrase → kind. */
-    junk?: Record<string, JunkKind>;
-    featMarkers?: string[];
-}
-interface ParseOptions {
-    mode?: ModeOption;
-    /** youtube mode: channel name used as the artist when no separator is found (R6.8). */
-    uploader?: string;
-    /** Names that must never be split (R7.3a). */
-    knownArtists?: string[];
-    splitAnd?: "auto" | "always" | "never";
-    keywords?: KeywordOptions;
-}
-interface FormatOptions {
-    feat?: "source" | "artist" | "title" | "omit";
-    featMarker?: string;
-    joiners?: "original" | "canonical";
-    versions?: "all" | "none";
-    producers?: boolean;
-    position?: boolean;
-}
+declare const SPEC_VERSION = "0.3.1";
 
 declare function format(track: ParsedTrack, options?: FormatOptions): string;
 /** All credited names: track artists plus every version's remixers, deduped by R0.4 key. */
@@ -101,4 +19,4 @@ declare function createParser(base?: ParseOptions): Parser;
 declare function parse(input: string, options?: ParseOptions): ParsedTrack;
 declare function parseArtists(input: string, options?: ParseOptions): Artist[];
 
-export { type Artist, type ArtistRole, type ArtistSource, type Flags, type FormatOptions, type Junk, type JunkKind, type KeywordOptions, type Mode, type ModeOption, type ParseOptions, type ParsedTrack, type Parser, type Position, SPEC_VERSION, type Timestamp, type Version, type VersionDelimiter, type VersionType, type Warning, allArtists, createParser, format, normalize, parse, parseArtists };
+export { Artist, FormatOptions, ParseOptions, ParsedTrack, type Parser, SPEC_VERSION, allArtists, createParser, format, normalize, parse, parseArtists };