@nice2dev/ui-audio 0.1.0

package/dist/karaoke/AudioPitchAnalyzer.d.ts

@@ -0,0 +1,25 @@
+interface PitchSegment {
+    start: number;
+    duration: number;
+    pitch: number;
+    freq: number;
+}
+/** Result from a backend pitch detection endpoint */
+export interface PitchTrackResult {
+    track: Array<{
+        t: number;
+        hz: number;
+    }>;
+}
+interface AudioPitchAnalyzerProps {
+    onSegments?: (segments: PitchSegment[]) => void;
+    defaultCompareAll?: boolean;
+    externalFile?: File | null;
+    /** Optional backend pitch detection via CREPE. If not provided, CREPE algorithm is unavailable. */
+    postPitch?: (file: File) => Promise<PitchTrackResult>;
+    /** Optional backend pitch detection via librosa. If not provided, librosa algorithm is unavailable. */
+    postLibrosaPitchTrack?: (file: File) => Promise<PitchTrackResult>;
+}
+export default function AudioPitchAnalyzer({ onSegments, defaultCompareAll, externalFile, postPitch, postLibrosaPitchTrack: apiLibrosa }: AudioPitchAnalyzerProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=AudioPitchAnalyzer.d.ts.map

package/dist/karaoke/AudioPitchAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioPitchAnalyzer.d.ts","sourceRoot":"","sources":["../../src/karaoke/AudioPitchAnalyzer.tsx"],"names":[],"mappings":"AASA,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzC;AAED,UAAU,uBAAuB;IAC/B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;IAChD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,YAAY,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B,mGAAmG;IACnG,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACtD,uGAAuG;IACvG,qBAAqB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACnE;AAED,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,EAAE,UAAU,EAAE,iBAAyB,EAAE,YAAmB,EAAE,SAAS,EAAE,qBAAqB,EAAE,UAAU,EAAE,EAAE,uBAAuB,2CA0wB/K"}

package/dist/karaoke/BarFillEditor.d.ts

@@ -0,0 +1,14 @@
+import { KaraokeBarFill } from '../karaoke/rendering/glossyBarRenderer';
+interface BarFillEditorProps {
+    /** Current bar fill settings */
+    fill: KaraokeBarFill;
+    /** Called when any field changes */
+    onChange: (fill: KaraokeBarFill) => void;
+    /** Player / preview color for SVG preview */
+    previewColor: string;
+    /** Accent color for active border (e.g. '#d4a017' for gold bars) */
+    accentColor?: string;
+}
+declare const BarFillEditor: React.FC<BarFillEditorProps>;
+export default BarFillEditor;
+//# sourceMappingURL=BarFillEditor.d.ts.map

package/dist/karaoke/BarFillEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BarFillEditor.d.ts","sourceRoot":"","sources":["../../src/karaoke/BarFillEditor.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAI7E,UAAU,kBAAkB;IACxB,gCAAgC;IAChC,IAAI,EAAE,cAAc,CAAC;IACrB,oCAAoC;IACpC,QAAQ,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IACzC,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CA2S/C,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/karaoke/KaraokeLyrics.d.ts

@@ -0,0 +1,9 @@
+import { default as React } from 'react';
+import { KaraokeSongFile } from '../models/modelsKaraoke';
+interface KaraokeLyricsProps {
+    song: KaraokeSongFile;
+    currentTime: number;
+}
+declare const _default: React.NamedExoticComponent<KaraokeLyricsProps>;
+export default _default;
+//# sourceMappingURL=KaraokeLyrics.d.ts.map

package/dist/karaoke/KaraokeLyrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KaraokeLyrics.d.ts","sourceRoot":"","sources":["../../src/karaoke/KaraokeLyrics.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,UAAU,kBAAkB;IACxB,IAAI,EAAE,eAAe,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACvB;;AAoJD,wBAAyC"}

package/dist/karaoke/KaraokeTimeline.d.ts

@@ -0,0 +1,21 @@
+import { default as React } from 'react';
+import { KaraokeSongFile } from '../models/modelsKaraoke';
+import { KaraokeSegmentScore, KaraokeGoldBurst, KaraokeComboInfo, KaraokeVerseRating, KaraokeTimelineConfig } from './karaokeTimelineTypes';
+interface KaraokeTimelineProps {
+    song: KaraokeSongFile;
+    currentTime: number;
+    playerRef: React.RefObject<HTMLDivElement>;
+    /** Optional config grouping display/layout/visual settings (reduces props drilling). */
+    config?: KaraokeTimelineConfig;
+    userPitch?: {
+        t: number;
+        hz: number;
+    }[];
+    segmentScores?: KaraokeSegmentScore[];
+    goldBursts?: KaraokeGoldBurst[];
+    combo?: KaraokeComboInfo;
+    verseRatings?: KaraokeVerseRating[];
+}
+declare const KaraokeTimeline: React.FC<KaraokeTimelineProps>;
+export default KaraokeTimeline;
+//# sourceMappingURL=KaraokeTimeline.d.ts.map

package/dist/karaoke/KaraokeTimeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KaraokeTimeline.d.ts","sourceRoot":"","sources":["../../src/karaoke/KaraokeTimeline.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,KAAK,EACR,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACxB,MAAM,wBAAwB,CAAC;AAEhC,UAAU,oBAAoB;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC3C,wFAAwF;IACxF,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,SAAS,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxC,aAAa,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACtC,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACvC;AAED,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA8SnD,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/karaoke/karaokeTimelineTypes.d.ts

@@ -0,0 +1,77 @@
+import { KaraokeAnimMode } from '../karaoke/rendering/karaokeDisplaySettings';
+import { PlayerKaraokeSettings } from '../karaoke/rendering/glossyBarRenderer';
+/** Per-note scoring result rendered on the timeline. */
+export interface KaraokeSegmentScore {
+    start: number;
+    end: number;
+    pitch: number;
+    frac: number;
+    isGold?: boolean;
+    noteStart?: number;
+    noteEnd?: number;
+}
+/** Gold-note burst particle effect metadata. */
+export interface KaraokeGoldBurst {
+    playerId: number;
+    createdAt: number;
+    noteStart: number;
+    notePitch: number;
+    seed: number;
+}
+/** Visual tuning for gold-note burst effects. */
+export interface KaraokeGoldSettings {
+    lifeMs?: number;
+    count?: number;
+    baseSpeed?: number;
+    baseSize?: number;
+    glowBlur?: number;
+    shadowColor?: string;
+}
+/** Live combo tracking state. */
+export interface KaraokeComboInfo {
+    maxCombo: number;
+    currentCombo: number;
+    totalComboBonus: number;
+}
+/** Per-verse rating after verse boundary. */
+export interface KaraokeVerseRating {
+    verseIndex: number;
+    hitFraction: number;
+    label: string;
+    comboBonus: number;
+}
+/**
+ * Config object grouping optional display, layout and visual settings
+ * for KaraokeTimeline — reduces props drilling from 24 → 9 top-level props.
+ */
+export interface KaraokeTimelineConfig {
+    /** Player display name (default: "Ziom") */
+    playerName?: string;
+    /** Current score value (default: 10000) */
+    score?: number;
+    /** CSS color for player background (default: accent blue) */
+    playerBgColor?: string;
+    /** Number of players — affects timeline width scaling */
+    playerCount?: number;
+    /** Whether the karaoke is currently playing */
+    isPlaying?: boolean;
+    /** Override for vertical position (px) */
+    top?: number;
+    /** Network latency badge value (ms) */
+    latencyMs?: number | null;
+    /** Gap between notes desaturation level */
+    gapDesaturation?: number;
+    /** Difficulty label display */
+    difficultyLevel?: string;
+    /** Pitch algorithm label */
+    algorithmLabel?: string;
+    /** Pitch algorithm theme color */
+    algorithmColor?: string;
+    /** Animation rendering mode */
+    animationMode?: KaraokeAnimMode;
+    /** Per-player karaoke visual settings */
+    karaokeSettings?: PlayerKaraokeSettings | null;
+    /** Gold note burst visual tuning */
+    goldSettings?: KaraokeGoldSettings;
+}
+//# sourceMappingURL=karaokeTimelineTypes.d.ts.map

package/dist/karaoke/karaokeTimelineTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"karaokeTimelineTypes.d.ts","sourceRoot":"","sources":["../../src/karaoke/karaokeTimelineTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AACnF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAEpF,wDAAwD;AACxD,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,iDAAiD;AACjD,MAAM,WAAW,mBAAmB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IAClC,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+BAA+B;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4BAA4B;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,eAAe,CAAC;IAChC,yCAAyC;IACzC,eAAe,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC/C,oCAAoC;IACpC,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACtC"}

package/dist/karaoke/rendering/fontCatalog.d.ts

@@ -0,0 +1,30 @@
+/**
+ * fontCatalog.ts — Catalog of custom fonts from public/fonts/ for karaoke bar rendering.
+ *
+ * Each entry maps a human-readable font family name to the URL of the font file.
+ * Fonts are registered as @font-face on demand so canvas can use them.
+ */
+export interface FontEntry {
+    /** CSS font-family name to use in canvas ctx.font */
+    family: string;
+    /** URL path relative to public root */
+    url: string;
+    /** Format hint for @font-face src (truetype, opentype, woff, woff2) */
+    format: string;
+}
+/** All available custom fonts from public/fonts/ */
+export declare const FONT_CATALOG: FontEntry[];
+/**
+ * Register a custom font via @font-face so canvas ctx.font can use it.
+ * Returns a promise that resolves when the font is loaded and ready.
+ */
+export declare function loadCustomFont(fe: FontEntry): Promise<void>;
+/**
+ * Ensure the given font family is loaded and ready for canvas use.
+ * If it's a custom font from the catalog, registers @font-face and loads it.
+ * For system fonts (Arial etc.) this is a no-op.
+ */
+export declare function ensureFontLoaded(family: string): Promise<void>;
+/** Find a font entry by family name */
+export declare function findFontByFamily(family: string): FontEntry | undefined;
+//# sourceMappingURL=fontCatalog.d.ts.map

package/dist/karaoke/rendering/fontCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fontCatalog.d.ts","sourceRoot":"","sources":["../../../src/karaoke/rendering/fontCatalog.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,SAAS;IACtB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;CAClB;AAUD,oDAAoD;AACpD,eAAO,MAAM,YAAY,EAAE,SAAS,EA8BnC,CAAC;AAKF;;;GAGG;AACH,wBAAsB,cAAc,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAYjE;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMpE;AAED,uCAAuC;AACvC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAEtE"}

package/dist/karaoke/rendering/glossyBarCaps.d.ts

@@ -0,0 +1,57 @@
+/**
+ * glossyBarCaps.ts — Cap shape definitions and registries for glossy karaoke bars.
+ *
+ * Each cap shape is a pair of left/right generator functions that produce
+ * SVG paths (outer border + inner fill) for a given bar height.
+ */
+/** Cap shape geometry result */
+export interface CapGeometry {
+    /** Width of the cap in pixels */
+    w: number;
+    /** SVG path for the outer border shape */
+    out: string;
+    /** SVG path for the inner (fill) shape (inset by border width) */
+    inn: string;
+}
+/** Cap shape generator function */
+export type CapShapeGenerator = (H: number) => CapGeometry;
+/** A named cap style with left and right generators */
+export interface CapStyle {
+    name: string;
+    L: CapShapeGenerator;
+    R: CapShapeGenerator;
+}
+export declare function pill_L(H: number): CapGeometry;
+export declare function sharp_L(H: number): CapGeometry;
+export declare function soft_L(H: number): CapGeometry;
+export declare function chamfer_L(H: number): CapGeometry;
+export declare function arrow_L(H: number): CapGeometry;
+export declare function shield_L(H: number): CapGeometry;
+export declare function bracket_L(H: number): CapGeometry;
+export declare function tab_L(H: number): CapGeometry;
+export declare function wave_L(H: number): CapGeometry;
+export declare function ornate_L(H: number): CapGeometry;
+export declare function skewTL_L(H: number): CapGeometry;
+export declare function skewTR_L(H: number): CapGeometry;
+export declare function pill_R(H: number): CapGeometry;
+export declare function sharp_R(H: number): CapGeometry;
+export declare function soft_R(H: number): CapGeometry;
+export declare function chamfer_R(H: number): CapGeometry;
+export declare function arrow_R(H: number): CapGeometry;
+export declare function shield_R(H: number): CapGeometry;
+export declare function bracket_R(H: number): CapGeometry;
+export declare function tab_R(H: number): CapGeometry;
+export declare function wave_R(H: number): CapGeometry;
+export declare function ornate_R(H: number): CapGeometry;
+export declare function skewTL_R(H: number): CapGeometry;
+export declare function skewTR_R(H: number): CapGeometry;
+export declare const SYMMETRIC_CAPS: CapStyle[];
+export declare const ASYMMETRIC_CAPS: CapStyle[];
+export declare const SKEW_CAPS: CapStyle[];
+/** All cap styles in one flat list for lookup by name */
+export declare const ALL_CAP_STYLES: CapStyle[];
+/** Default cap style */
+export declare const DEFAULT_CAP_STYLE: CapStyle;
+/** Lookup cap style by name, falling back to Pill */
+export declare function getCapStyleByName(name: string): CapStyle;
+//# sourceMappingURL=glossyBarCaps.d.ts.map

package/dist/karaoke/rendering/glossyBarCaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossyBarCaps.d.ts","sourceRoot":"","sources":["../../../src/karaoke/rendering/glossyBarCaps.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,gCAAgC;AAChC,MAAM,WAAW,WAAW;IACxB,iCAAiC;IACjC,CAAC,EAAE,MAAM,CAAC;IACV,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;CACf;AAED,mCAAmC;AACnC,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,WAAW,CAAC;AAE3D,uDAAuD;AACvD,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,iBAAiB,CAAC;IACrB,CAAC,EAAE,iBAAiB,CAAC;CACxB;AAUD,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAO7C;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAE9C;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAO7C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAOhD;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAO9C;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAO/C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAOhD;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAO5C;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAO7C;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAO/C;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAO/C;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAO/C;AAMD,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAO7C;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAE9C;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAO7C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAOhD;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAO9C;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAO/C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAOhD;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAO5C;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAO7C;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAO/C;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAO/C;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAO/C;AAMD,eAAO,MAAM,cAAc,EAAE,QAAQ,EAWpC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,QAAQ,EAqBrC,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,QAAQ,EAW/B,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,cAAc,EAAE,QAAQ,EAA0D,CAAC;AAEhG,wBAAwB;AACxB,eAAO,MAAM,iBAAiB,UAAoB,CAAC;AAEnD,qDAAqD;AACrD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAExD"}

package/dist/karaoke/rendering/glossyBarPatterns.d.ts

@@ -0,0 +1,16 @@
+/**
+ * glossyBarPatterns.ts — Overlay pattern definitions for glossy karaoke bars.
+ *
+ * Each pattern is an SVG <pattern> generator that produces a tiling fill.
+ * 30 patterns total including flames, zigzag, scales, hex, dots, stars, etc.
+ */
+/** Named overlay pattern */
+export interface OverlayPattern {
+    name: string;
+    /** Generate an SVG <pattern> element string. `color` = primary, `color2` = optional secondary */
+    mk: (id: string, color: string, color2?: string) => string;
+}
+export declare const OVERLAY_PATTERNS: OverlayPattern[];
+/** Lookup a pattern by name */
+export declare function getPatternByName(name: string): OverlayPattern | null;
+//# sourceMappingURL=glossyBarPatterns.d.ts.map

package/dist/karaoke/rendering/glossyBarPatterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossyBarPatterns.d.ts","sourceRoot":"","sources":["../../../src/karaoke/rendering/glossyBarPatterns.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,4BAA4B;AAC5B,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,iGAAiG;IACjG,EAAE,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAC9D;AAMD,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAkN5C,CAAC;AAEF,+BAA+B;AAC/B,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAEpE"}

package/dist/karaoke/rendering/glossyBarRenderer.d.ts

@@ -0,0 +1,65 @@
+import { CapStyle } from './glossyBarCaps';
+import { OverlayPattern } from './glossyBarPatterns';
+/**
+ * glossyBarRenderer.ts — Glossy SVG bar generator for karaoke note timeline.
+ *
+ * Generates glossy, 3D-look note bars with configurable:
+ * - Cap shapes (pill, sharp, soft, chamfer, arrow, shield, bracket, tab, wave, ornate, skew)
+ * - Overlay patterns (flames, zigzag, scales, hex, dots, stars, etc.)
+ * - Colors, highlight, glow, glass transparency
+ *
+ * Based on the standalone glossy-buttons-v8 generator, adapted for Canvas rendering.
+ *
+ * Sub-modules:
+ * - glossyBarCaps.ts   — cap shape definitions & registries
+ * - glossyBarPatterns.ts — overlay pattern definitions
+ * - karaokeSettings.ts  — per-player karaoke visual settings (bar fills + font)
+ */
+export type { CapGeometry, CapShapeGenerator, CapStyle } from './glossyBarCaps';
+export { pill_L, sharp_L, soft_L, chamfer_L, arrow_L, shield_L, bracket_L, tab_L, wave_L, ornate_L, skewTL_L, skewTR_L, pill_R, sharp_R, soft_R, chamfer_R, arrow_R, shield_R, bracket_R, tab_R, wave_R, ornate_R, skewTL_R, skewTR_R, SYMMETRIC_CAPS, ASYMMETRIC_CAPS, SKEW_CAPS, ALL_CAP_STYLES, DEFAULT_CAP_STYLE, getCapStyleByName } from './glossyBarCaps';
+export type { OverlayPattern } from './glossyBarPatterns';
+export { OVERLAY_PATTERNS, getPatternByName } from './glossyBarPatterns';
+export type { KaraokeBarFill, KaraokeFontSettings, PlayerKaraokeSettings, EmptyBarPreset, PlayerBarStyle } from './karaokeSettings';
+export { DEFAULT_BAR_FILL, DEFAULT_EMPTY_BAR_FILL, DEFAULT_GOLD_EMPTY_BAR_FILL, DEFAULT_GOLD_FILLED_BAR_FILL, DEFAULT_FONT_SETTINGS, DEFAULT_KARAOKE_SETTINGS, DEFAULT_PLAYER_BAR_STYLE, loadKaraokeSettings, saveKaraokeSettings, hydratePlayerKaraokeSettingsFromBackend, loadAllKaraokeSettings, loadPlayerBarStyle, savePlayerBarStyle, loadPlayerBarStyles } from './karaokeSettings';
+/** Render options for a glossy bar */
+export interface GlossyBarOptions {
+    /** Total width in pixels */
+    width: number;
+    /** Total height in pixels */
+    height: number;
+    /** Cap style to use */
+    capStyle: CapStyle;
+    /** Base color (hex, e.g. "#2196f3") */
+    color: string;
+    /** Highlight intensity 0-100 (default 70) */
+    highlight?: number;
+    /** Bottom glow intensity 0-100 (default 55) */
+    glow?: number;
+    /** Glass transparency 0-100 — 100 = fully transparent/white (default 0) */
+    glass?: number;
+    /** optional overlay pattern */
+    pattern?: OverlayPattern | null;
+    /** Secondary color for pattern overlay (hex). If omitted, auto-derived from main color */
+    patternColor?: string | null;
+    /** Pattern-only mode: no glossy 3D button, just the pattern fill inside a simple rounded rect.
+     *  Gray bars = unsung notes, colored bars = sung by player. */
+    patternOnly?: boolean;
+    /** Texture image URL for filling the bar (overrides/supplements gradient fill) */
+    textureUrl?: string | null;
+    /** Texture tile scale for SVG preview (default 1.0) */
+    textureScale?: number;
+}
+/** Convert hex color to HSL [h: 0-360, s: 0-100, l: 0-100] */
+export declare function hexToHsl(hex: string): [number, number, number];
+/** Normalize any CSS hex to 6-digit lowercase */
+export declare function normalizeHex(hex: string): string;
+/** Render a complete glossy bar as SVG markup string */
+export declare function renderGlossyBarSvg(opts: GlossyBarOptions): string;
+/**
+ * Draw a glossy bar directly onto a Canvas2D context at position (x, y).
+ *
+ * This renders the same visual as `renderGlossyBarSvg` but using Canvas commands,
+ * which is much more efficient for real-time karaoke timeline rendering.
+ */
+export declare function drawGlossyBarOnCanvas(ctx: CanvasRenderingContext2D, x: number, y: number, totalW: number, H: number, capStyle: CapStyle, color: string, highlight?: number, glow?: number, glass?: number, _pattern?: OverlayPattern | null, _patternColor?: string | null, patternOnly?: boolean, texturePattern?: CanvasPattern | null, overlayCanvasPattern?: CanvasPattern | null): void;
+//# sourceMappingURL=glossyBarRenderer.d.ts.map

package/dist/karaoke/rendering/glossyBarRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossyBarRenderer.d.ts","sourceRoot":"","sources":["../../../src/karaoke/rendering/glossyBarRenderer.ts"],"names":[],"mappings":"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"}

package/dist/karaoke/rendering/karaokeAnimations.d.ts

@@ -0,0 +1,25 @@
+import { KaraokeAnimMode } from './karaokeDisplaySettings';
+export interface AnimDrawParams {
+    ctx: CanvasRenderingContext2D;
+    ballX: number;
+    ballY: number;
+    ballRadius: number;
+    playerColor: string;
+    ballIsGold: boolean;
+    currentTime: number;
+    width: number;
+    height: number;
+    /** Notes currently visible on screen, mapped to pixel coords */
+    visibleNotes: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+        isGold?: boolean;
+        isSung?: boolean;
+    }[];
+}
+/** Draw the alternative animation indicator based on the selected mode.
+ *  Returns false if mode is 'ball' (caller should use existing code). */
+export declare function drawAlternativeAnimation(mode: KaraokeAnimMode, params: AnimDrawParams): boolean;
+//# sourceMappingURL=karaokeAnimations.d.ts.map

package/dist/karaoke/rendering/karaokeAnimations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"karaokeAnimations.d.ts","sourceRoot":"","sources":["../../../src/karaoke/rendering/karaokeAnimations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC3B,GAAG,EAAE,wBAAwB,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,YAAY,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;CACtG;AAgLD;yEACyE;AACzE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAe/F"}

package/dist/karaoke/rendering/karaokeDisplaySettings.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Karaoke display settings � user-configurable visual options
+ * persisted in localStorage and applied as CSS custom properties.
+ */
+/** Curtain transition effect type */
+export type CurtainEffect = 'none' | 'fade' | 'slide' | 'curtain' | 'iris';
+/** Gradient color preset definition */
+export interface GradientPreset {
+    id: string;
+    name: string;
+    /** [start, mid, end] hex colors for the sung-text sweep */
+    sungGradient: [string, string, string];
+    /** Gold note gradient */
+    goldGradient: [string, string, string];
+    /** Glow color for active syllables */
+    glowColor: string;
+}
+/** Karaoke animation mode */
+export type KaraokeAnimMode = "ball" | "wipe" | "pulse" | "bounce";
+/** Font options for karaoke display � system fonts + fonts from public/fonts/ catalog */
+export declare const KARAOKE_FONT_OPTIONS: {
+    value: string;
+    label: string;
+}[];
+/** Persisted display settings */
+export interface KaraokeDisplaySettings {
+    /** Color preset id or 'custom' */
+    presetId: string;
+    /** Custom gradient colors (used when presetId === 'custom') */
+    customSungGradient: [string, string, string];
+    customGoldGradient: [string, string, string];
+    customGlowColor: string;
+    /** Animation mode for the timeline canvas */
+    animationMode: KaraokeAnimMode;
+    /** Font family for canvas text and lyrics overlay */
+    fontFamily: string;
+    /** Transition effect shown between karaoke scenes */
+    transitionEffect: CurtainEffect;
+    /** Primary curtain / overlay color */
+    curtainPrimaryColor: string;
+    /** Secondary accent color (gradients, trims) */
+    curtainSecondaryColor: string;
+    /** Transition animation duration in ms */
+    curtainDurationMs: number;
+    /** Enter immersive mode (hide navbar) while singing */
+    immersiveMode: boolean;
+}
+/** Built-in gradient presets */
+export declare const GRADIENT_PRESETS: GradientPreset[];
+export declare function loadKaraokeDisplaySettings(): KaraokeDisplaySettings;
+/** Hydrate from external source (call early in app lifecycle). Pass a fetcher that returns settings JSON string or null. */
+export declare function hydrateKaraokeDisplayFromBackend(fetchSettings?: () => Promise<string | null>): Promise<void>;
+/** Save settings to localStorage + backend */
+export declare function saveKaraokeDisplaySettings(settings: KaraokeDisplaySettings): void;
+/** Get the active gradient colors based on current settings */
+export declare function getActiveGradient(settings: KaraokeDisplaySettings): {
+    sungGradient: [string, string, string];
+    goldGradient: [string, string, string];
+    glowColor: string;
+};
+/** Apply karaoke display CSS custom properties to :root */
+export declare function applyKaraokeDisplayVars(settings: KaraokeDisplaySettings): void;
+/** Initialize karaoke display vars on app startup */
+export declare function initKaraokeDisplaySettings(): void;
+//# sourceMappingURL=karaokeDisplaySettings.d.ts.map

package/dist/karaoke/rendering/karaokeDisplaySettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"karaokeDisplaySettings.d.ts","sourceRoot":"","sources":["../../../src/karaoke/rendering/karaokeDisplaySettings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qCAAqC;AACrC,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAI3E,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,yBAAyB;IACzB,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,6BAA6B;AAC7B,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEnE,yFAAyF;AACzF,eAAO,MAAM,oBAAoB,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EASlE,CAAC;AAEF,iCAAiC;AACjC,MAAM,WAAW,sBAAsB;IACrC,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,aAAa,EAAE,eAAe,CAAC;IAC/B,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IAGnB,qDAAqD;IACrD,gBAAgB,EAAE,aAAa,CAAC;IAChC,sCAAsC;IACtC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gDAAgD;IAChD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,0CAA0C;IAC1C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,gCAAgC;AAChC,eAAO,MAAM,gBAAgB,EAAE,cAAc,EA2C5C,CAAC;AAkBF,wBAAgB,0BAA0B,IAAI,sBAAsB,CASnE;AAED,4HAA4H;AAC5H,wBAAsB,gCAAgC,CACpD,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,8CAA8C;AAC9C,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAKjF;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,sBAAsB,GAAG;IACnE,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB,CAqBA;AAED,2DAA2D;AAC3D,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CA6B9E;AAED,qDAAqD;AACrD,wBAAgB,0BAA0B,IAAI,IAAI,CAGjD"}

package/dist/karaoke/rendering/karaokeLyrics.d.ts

@@ -0,0 +1,54 @@
+export interface KaraokeLine {
+    text: string;
+    timestamp: number;
+}
+/**
+ * Represents a single word/syllable in the karaoke
+ */
+export interface KaraokeWord {
+    text: string;
+    startTime: number;
+    endTime: number;
+    isGolden: boolean;
+}
+/**
+ * Represents a verse (line) with words
+ */
+export interface KaraokeVerse {
+    text: string;
+    timestamp: number;
+    words: KaraokeWord[];
+}
+/**
+ * Parses Ultrastar notes into lyric lines with timestamps.
+ * Returns lines with full text (for backward compatibility).
+ */
+export declare const parseLyrics: (notes: string[], bpmOverride?: number) => KaraokeLine[];
+export declare const parseVersesWithWords: (notes: string[], bpmOverride?: number) => KaraokeVerse[];
+/**
+ * Represents a single syllable in the karaoke with precise timing
+ */
+export interface KaraokeSyllable {
+    text: string;
+    startTime: number;
+    endTime: number;
+    isGolden: boolean;
+    hasTrailingSpace: boolean;
+}
+/**
+ * Represents a verse (line) with syllables
+ */
+export interface KaraokeSyllableVerse {
+    timestamp: number;
+    syllables: KaraokeSyllable[];
+}
+/**
+ * Parses UltraStar notes into verses with syllables — each note = separate syllable with its own timing.
+ */
+export declare const parseVersesWithSyllables: (notes: string[], bpmOverride?: number) => KaraokeSyllableVerse[];
+export declare const getActiveLyrics: (lyrics: KaraokeLine[], currentTime: number, maxLines?: number) => string[];
+/**
+ * Finds active words to display based on the current time.
+ */
+export declare const getActiveWords: (verses: KaraokeVerse[], currentTime: number) => KaraokeWord[];
+//# sourceMappingURL=karaokeLyrics.d.ts.map

package/dist/karaoke/rendering/karaokeLyrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"karaokeLyrics.d.ts","sourceRoot":"","sources":["../../../src/karaoke/rendering/karaokeLyrics.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,WAAW,EAAE,CAAC;CACxB;AAwBD;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,EAAE,EAAE,cAAc,MAAM,KAAG,WAAW,EAuE9E,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,EAAE,EAAE,cAAc,MAAM,KAAG,YAAY,EA8GxF,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,eAAe,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,MAAM,EAAE,EAAE,cAAc,MAAM,KAAG,oBAAoB,EAqEpG,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,QAAQ,WAAW,EAAE,EAAE,aAAa,MAAM,EAAE,iBAAY,KAAG,MAAM,EAwBhG,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,YAAY,EAAE,EAAE,aAAa,MAAM,KAAG,WAAW,EAWvF,CAAC"}

package/dist/karaoke/rendering/karaokeNoteParsing.d.ts

@@ -0,0 +1,20 @@
+import { KaraokeNoteData } from './karaokeTimelineTypes';
+/**
+ * Searches for BPM value from #BPM: headers in UltraStar note lines.
+ * UltraStar WorldParty internally multiplies BPM×4, so the time formula is:
+ *   time_seconds = beat * 60 / (fileBPM * 4) = beat * 15 / fileBPM
+ */
+export declare const extractBpmFromNotes: (notes: string[]) => number | null;
+/**
+ * Converts Ultrastar note lines to `KaraokeNoteData` objects.
+ * Automatically extracts BPM from #BPM: headers (if present) for beat-to-seconds conversion.
+ */
+export declare const parseNotes: (notes: string[], bpmOverride?: number) => KaraokeNoteData[][];
+/**
+ * Converts Hz to UltraStar pitch with octave-folding per UltraStar WorldParty:
+ *   1. Hz → MIDI → pitch class (0-11)
+ *   2. Adjust octave so detected pitch is within ±6 of target note.
+ * If no target note, returns raw MIDI value mod 12.
+ */
+export declare const hzToUltrastarPitch: (hz: number, targetNotePitch: number | null) => number;
+//# sourceMappingURL=karaokeNoteParsing.d.ts.map

package/dist/karaoke/rendering/karaokeNoteParsing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"karaokeNoteParsing.d.ts","sourceRoot":"","sources":["../../../src/karaoke/rendering/karaokeNoteParsing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,MAAM,EAAE,KAAG,MAAM,GAAG,IAS9D,CAAC;AAYF;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,EAAE,EAAE,cAAc,MAAM,KAAG,eAAe,EAAE,EA6BnF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,IAAI,MAAM,EAAE,iBAAiB,MAAM,GAAG,IAAI,KAAG,MAa/E,CAAC"}