@braccato/core 0.1.7 → 1.1.0

package/dist/styles/lyrics.css

@@ -0,0 +1,274 @@
+/* Main container styles */
+.blyrics-container {
+	font-family: var(--blyrics-font-family);
+	font-size: var(--blyrics-font-size);
+	font-weight: var(--blyrics-font-weight);
+	isolation: isolate;
+	line-height: var(--blyrics-line-height);
+	padding-bottom: calc(var(--blyrics-padding-bottom));
+	padding-top: 2rem;
+	position: relative !important;
+	transition: transform var(--blyrics-lyric-scroll-duration)
+		var(--blyrics-lyric-scroll-timing-function) 0s;
+	will-change: transform;
+	z-index: 1;
+}
+
+.blyrics-container > div {
+	box-sizing: border-box;
+	cursor: pointer;
+	padding: var(--blyrics-padding) 0.25em !important;
+	transform: scale(var(--blyrics-scale));
+	transform-origin: left center;
+}
+
+.blyrics--active {
+	cursor: default;
+}
+
+.blyrics--line {
+	color: var(--blyrics-lyric-inactive-color);
+	max-width: 100%;
+	unicode-bidi: plaintext;
+	white-space: normal;
+	word-break: normal;
+}
+
+.blyrics-line-main {
+	display: block;
+	max-width: 100%;
+	overflow-wrap: normal;
+	text-align: inherit;
+	unicode-bidi: plaintext;
+	white-space: normal;
+}
+
+.blyrics-background-line {
+	display: block;
+	margin-top: 0.1em;
+	max-width: 100%;
+	text-align: inherit;
+	unicode-bidi: plaintext;
+	white-space: normal;
+}
+
+.blyrics-bidi-run {
+	display: inline;
+	max-width: 100%;
+	unicode-bidi: normal;
+	white-space: inherit;
+}
+
+.blyrics-word-group {
+	display: inline-block;
+	max-width: 100%;
+	unicode-bidi: normal;
+	vertical-align: baseline;
+	white-space: nowrap;
+}
+
+.blyrics-word-group-long {
+	display: inline;
+	overflow-wrap: anywhere;
+	white-space: normal;
+	word-break: break-word;
+}
+
+.blyrics--word {
+	color: var(--blyrics-lyric-inactive-color);
+	display: inline;
+	position: relative;
+	transform: translateY(0);
+	unicode-bidi: normal;
+	white-space: inherit;
+}
+
+.blyrics-word-group:not(.blyrics-word-group-long) .blyrics--word {
+	display: inline-block;
+}
+
+.blyrics-bidi-sensitive .blyrics-word-group,
+.blyrics-bidi-sensitive .blyrics-word-group-long {
+	display: contents;
+	max-width: none;
+	overflow-wrap: normal;
+	unicode-bidi: normal;
+	white-space: normal;
+	word-break: normal;
+}
+
+.blyrics-bidi-sensitive .blyrics--word,
+.blyrics-bidi-sensitive .blyrics-word-group:not(.blyrics-word-group-long) .blyrics--word {
+	display: inline;
+	unicode-bidi: normal;
+	white-space: inherit;
+}
+
+@property --lyric-transition-amount-start {
+	syntax: "<number>";
+	inherits: false;
+	initial-value: -0.2;
+}
+
+@property --lyric-transition-amount-end {
+	syntax: "<number>";
+	inherits: false;
+	initial-value: -0.1;
+}
+
+.blyrics--word::after,
+.blyrics-word-highlight {
+	color: transparent;
+	background-image: linear-gradient(
+		90deg,
+		var(--blyrics-lyric-active-color)
+			calc(
+				100% * var(--lyric-transition-amount-start) - 4rem *
+					var(--lyric-transition-amount-start) + 2rem
+			),
+		#00000000
+			calc(
+				100% * var(--lyric-transition-amount-end) - 4rem *
+					var(--lyric-transition-amount-end) + 2rem + 1px
+			)
+	);
+	background-clip: text;
+	box-sizing: content-box;
+	filter: drop-shadow(0 0 0 var(--blyrics-glow-color));
+	left: -2rem;
+	opacity: 0;
+	padding: 2rem;
+	pointer-events: none;
+	position: absolute;
+	top: -2rem;
+	white-space: inherit;
+	width: 100%;
+	--lyric-transition-amount-start: var(
+		--blyrics-highlight-swipe-start-from,
+		-0.2
+	);
+	--lyric-transition-amount-end: var(--blyrics-highlight-swipe-end-from, -0.1);
+}
+
+.blyrics--word::after {
+	content: attr(data-content);
+}
+
+.blyrics-word-highlight {
+	user-select: none;
+}
+
+.blyrics--word:has(.blyrics-word-highlight)::after {
+	content: none;
+}
+
+.blyrics-rtl.blyrics--word::after,
+.blyrics--word.blyrics-rtl::after,
+.blyrics-rtl .blyrics-word-highlight,
+.blyrics--word.blyrics-rtl .blyrics-word-highlight {
+	background-image: linear-gradient(
+		270deg,
+		var(--blyrics-lyric-active-color)
+			calc(
+				100% * var(--lyric-transition-amount-start) - 4rem *
+					var(--lyric-transition-amount-start) + 2rem
+			),
+		#00000000
+			calc(
+				100% * var(--lyric-transition-amount-end) - 4rem *
+					var(--lyric-transition-amount-end) + 2rem + 1px
+			)
+	);
+}
+
+[blyrics-alt-hover] .blyrics--word:hover {
+	text-decoration: underline;
+	text-underline-offset: 0.15em;
+}
+
+.blyrics--line > .blyrics-line-main > .blyrics-background-lyric,
+.blyrics--line > .blyrics-background-line > .blyrics-background-lyric,
+.blyrics--line > .blyrics-line-main > .blyrics-bidi-run > .blyrics-background-lyric,
+.blyrics--line > .blyrics-background-line > .blyrics-bidi-run > .blyrics-background-lyric {
+	font-size: 0.75em;
+	font-weight: 500;
+}
+
+.blyrics--line > .blyrics-line-main > .blyrics-word-group.blyrics-background-lyric,
+.blyrics--line > .blyrics-background-line > .blyrics-word-group.blyrics-background-lyric,
+.blyrics--line > .blyrics-line-main > .blyrics-bidi-run > .blyrics-word-group.blyrics-background-lyric,
+.blyrics--line > .blyrics-background-line > .blyrics-bidi-run > .blyrics-word-group.blyrics-background-lyric {
+	color: color-mix(in srgb, var(--blyrics-lyric-inactive-color) 78%, transparent);
+}
+
+.blyrics-explicit {
+	text-decoration: line-through;
+	text-decoration-thickness: 0.08em;
+}
+
+.blyrics--translated,
+.blyrics--romanized {
+	color: var(--blyrics-translated-color);
+	display: block;
+	font-family: var(--blyrics-translated-font-family);
+	font-size: var(--blyrics-translated-font-size);
+	font-weight: var(--blyrics-translated-font-weight);
+	line-height: 1.1;
+	margin-top: 8px;
+	max-width: 100%;
+	text-align: inherit;
+	unicode-bidi: plaintext;
+	white-space: normal;
+}
+
+.blyrics--romanized {
+	background: rgba(255, 255, 255, 0.05);
+	border: 1px solid rgba(255, 255, 255, 0.1);
+	border-radius: 1rem;
+	box-sizing: border-box;
+	display: block;
+	font-size: calc(var(--blyrics-translated-font-size) / 1.25);
+	padding: 0.375rem 0.75rem;
+	width: fit-content;
+}
+
+.blyrics--romanized .blyrics-line-main {
+	display: inline;
+}
+
+.blyrics-rtl {
+	direction: rtl;
+}
+
+.blyrics--line[data-direction="rtl"] {
+	text-align: right;
+	transform-origin: right center;
+}
+
+/* Secondary and tertiary vocals */
+.blyrics--line[data-agent="v2"],
+.blyrics--line[data-agent="v3"] {
+	text-align: right;
+	transform-origin: right center !important;
+}
+
+/* All vocals together */
+.blyrics--line[data-agent="v1000"] {
+	text-align: center;
+	transform-origin: center center !important;
+}
+
+.blyrics--line[data-agent="v2"] .blyrics--romanized,
+.blyrics--line[data-agent="v3"] .blyrics--romanized,
+.blyrics--line[data-direction="rtl"] .blyrics--romanized {
+	margin-left: auto;
+}
+
+.blyrics--line[data-agent="v1000"] .blyrics--romanized {
+	margin-left: auto;
+	margin-right: auto;
+}
+
+#blyrics-wrapper {
+	margin-top: 0;
+}

package/dist/styles/variables.css

@@ -0,0 +1,181 @@
+:root {
+	/* Colors */
+	--blyrics-ui-text-color: var(
+		--blyrics-text-color,
+		color(display-p3 1 1 1 / 1)
+	);
+	--blyrics-glow-color: var(
+		--blyrics-highlight-color,
+		color(display-p3 1 1 1 / 0.5)
+	);
+	--blyrics-error-color: color(display-p3 0.992 0.882 0.882);
+	--blyrics-footer-bg-color: hsla(0, 0%, 100%, 0.1);
+	--blyrics-footer-border-color: hsla(0, 0%, 100%, 0.1);
+	--blyrics-footer-text-color: #aaa;
+	--blyrics-footer-link-color: #fff;
+	--blyrics-discord-hover-color: #5865f2;
+	--blyrics-vote-hover-color: hsla(0, 0%, 100%, 0.2);
+	--blyrics-lyric-active-color: var(
+		--blyrics-text-color,
+		color(display-p3 1 1 1 / var(--blyrics-active-opacity, 1))
+	);
+	--blyrics-lyric-inactive-color: color(
+		from var(--blyrics-text-color, color(display-p3 1 1 1)) display-p3 r g b /
+			var(--blyrics-inactive-opacity, 0.3)
+	);
+
+	--blyrics-richsync-timing-offset: 0.150s;
+	--blyrics-timing-offset: 0.115s;
+
+	--blyrics-scroll-timing-offset: 0.5s;
+
+	/* Typography */
+	/* The stack behind --noto-sans-universal is 32 Noto families and the extension is what loads
+	   them, so the declaration stays in misc.css, where two published themes select on it by name.
+	   Inside the extension the fallback is unreachable. It is one real family rather than a generic
+	   so that a standalone consumer without it still falls through to the rest of this stack; the
+	   CJK, Devanagari, Arabic, Hebrew and Thai coverage is what such a consumer gives up either
+	   way. */
+	--blyrics-font-family:
+		Satoshi, var(--noto-sans-universal, "Noto Sans"), Avenir, -apple-system,
+		BlinkMacSystemFont, Segoe UI, Roboto, Oxygen, Ubuntu, Cantarell, Open Sans,
+		Helvetica Neue, sans-serif;
+	--blyrics-font-size: 3rem;
+	--blyrics-font-weight: 700;
+	--blyrics-line-height: 1.333;
+
+	--blyrics-translated-font-size: 2rem;
+	--blyrics-translated-font-weight: 600;
+	--blyrics-translated-font-family: var(--blyrics-font-family);
+	--blyrics-translated-color: color(
+		display-p3 1 1 1 / var(--blyrics-translated-opacity, 0.6)
+	);
+
+	--blyrics-footer-font-family: Satoshi, Roboto, Noto Naskh Arabic UI, Arial, sans-serif;
+	--blyrics-footer-font-size: 14px;
+	--blyrics-footer-font-weight: 400;
+
+	/* Animations */
+	--blyrics-animate-line-scale: 1;
+	--blyrics-animate-word-wobble: 1;
+	--blyrics-animate-highlight-swipe: 1;
+	--blyrics-animate-highlight-glow: 1;
+	--blyrics-animate-highlight-fade: 1;
+	--blyrics-animate-scroll: 1;
+	--blyrics-animate-instrumental: 1;
+
+	--blyrics-loader-transition-duration: 0.6s;
+	--blyrics-loader-transition-easing: cubic-bezier(0.22, 1, 0.36, 1);
+	--blyrics-scale-transition-duration: var(
+		--blyrics-transition-duration,
+		0.166s
+	);
+	--blyrics-line-enter-transform-from: scale(var(--blyrics-scale));
+	--blyrics-line-enter-transform-to: scale(var(--blyrics-active-scale));
+	--blyrics-line-exit-transform-from: scale(var(--blyrics-active-scale));
+	--blyrics-line-exit-transform-to: scale(var(--blyrics-scale));
+	--blyrics-line-enter-easing: ease;
+	--blyrics-line-exit-easing: ease;
+
+	--blyrics-lyric-highlight-fade-in-duration: var(
+		--blyrics-opacity-transition,
+		0.33s
+	);
+	--blyrics-lyric-highlight-fade-out-duration: var(
+		--blyrics-opacity-transition,
+		0.5s
+	);
+	--blyrics-lyric-highlight-fade-in-easing: ease;
+	--blyrics-lyric-highlight-fade-out-easing: ease;
+	--blyrics-highlight-swipe-easing: linear;
+	--blyrics-highlight-swipe-start-from: -0.2;
+	--blyrics-highlight-swipe-end-from: -0.1;
+	--blyrics-highlight-swipe-start-to: 1.4;
+	--blyrics-highlight-swipe-end-to: 1.5;
+	--blyrics-highlight-glow-radius-from: 0.8rem;
+	--blyrics-highlight-glow-radius-to: 0;
+	--blyrics-highlight-glow-duration-ratio: 1.2;
+	--blyrics-highlight-glow-min-duration: 1.2s;
+	--blyrics-highlight-glow-easing: ease;
+
+	--blyrics-wobble-duration: 1s;
+	--blyrics-word-wobble-transform-from: scaleX(1);
+	--blyrics-word-wobble-transform-peak: translateX(0.05em) scaleX(1.025);
+	--blyrics-word-wobble-transform-settle: translateX(0) scaleX(1);
+	--blyrics-word-wobble-transform-to: scaleX(1);
+	--blyrics-word-wobble-peak-offset: 0.125;
+	--blyrics-word-wobble-settle-offset: 0.75;
+	--blyrics-word-wobble-easing: ease;
+	--blyrics-word-wobble-peak-easing: ease-in-out;
+	--blyrics-word-wobble-end-easing: ease-out;
+
+	--blyrics-instrumental-fill-fade-duration: 150ms;
+	--blyrics-instrumental-fill-fade-easing: ease;
+	--blyrics-instrumental-fill-transform-from: translateY(78%);
+	--blyrics-instrumental-fill-transform-to: translateY(-4%);
+	--blyrics-instrumental-fill-easing: linear;
+	--blyrics-instrumental-wave-transform-from: scaleY(1.2);
+	--blyrics-instrumental-wave-transform-to: scaleY(0.0001);
+	--blyrics-instrumental-wave-easing: ease-in;
+	--blyrics-instrumental-wave-oscillation-duration: 1.25s;
+	--blyrics-instrumental-wave-oscillation-easing: ease-in-out;
+
+	/* Layout */
+	--blyrics-padding: 2rem;
+	--blyrics-margin: 2rem;
+	--blyrics-small-border-radius: 1rem;
+	--blyrics-border-radius: 1000rem;
+
+	/* Effects */
+	--blyrics-blur-amount: 30px;
+	--blyrics-scale: 0.95;
+	--blyrics-active-scale: 1;
+	--blyrics-error-opacity: 0.33;
+	--blyrics-background-blur: 100px;
+	--blyrics-background-saturate: 2;
+
+	/* Lyric Transition Properties */
+	--blyrics-lyric-scroll-duration: var(
+		--blyrics-lyric-transition-duration,
+		650ms
+	);
+	--blyrics-lyric-scroll-timing-function: var(
+		--blyrics-lyric-transition-timing-function,
+		cubic-bezier(0.86, 0, 0.2, 1)
+	);
+
+	/* Gradient stops */
+	--blyrics-gradient-stops:
+		transparent 0%, rgba(0, 0, 0, 0.013) 8.1%, rgba(0, 0, 0, 0.049) 15.5%,
+		rgba(0, 0, 0, 0.104) 22.5%, rgba(0, 0, 0, 0.175) 29%,
+		rgba(0, 0, 0, 0.259) 35.3%, rgba(0, 0, 0, 0.352) 41.2%,
+		rgba(0, 0, 0, 0.45) 47.1%, rgba(0, 0, 0, 0.55) 52.9%,
+		rgba(0, 0, 0, 0.648) 58.8%, rgba(0, 0, 0, 0.741) 64.7%,
+		rgba(0, 0, 0, 0.825) 71%, rgba(0, 0, 0, 0.896) 77.5%,
+		rgba(0, 0, 0, 0.951) 84.5%, rgba(0, 0, 0, 0.987) 91.9%, #000 100%;
+
+	--blyrics-shimmer-gradient: linear-gradient(
+    	110deg,
+    	color-mix(in srgb, var(--blyrics-ui-text-color) 50%, transparent) 30%,
+    	var(--blyrics-ui-text-color) 50%,
+    	color-mix(in srgb, var(--blyrics-ui-text-color) 50%, transparent) 70%
+  	);
+}
+
+/* Reduced-motion disables the vestibular triggers (zoom-on-active line scale,
+   translateX word wobble, and instrumental fill/wave motion) and flattens the
+   active/inactive scale delta. Smooth scroll remains enabled, but the animation
+   engine suppresses side-specific line-scroll differential effects.
+   Everything else is left on by design:
+     - karaoke swipe + highlight glow: gradient mask / drop-shadow fills, not movement.
+     - highlight fade-in / fade-out: opacity transitions are not motion. */
+@media (prefers-reduced-motion: reduce) {
+	:root {
+		--blyrics-animate-line-scale: 0;
+		--blyrics-animate-word-wobble: 0;
+		--blyrics-animate-instrumental: 0;
+
+		--blyrics-scale: 1;
+		--blyrics-active-scale: 1;
+	}
+}

package/dist/text.d.ts

@@ -0,0 +1,11 @@
+export declare const testRtl: (text: string) => boolean;
+/**
+ * Checks if a given string contains any non-Latin characters.
+ * @param text The string to check.
+ * @returns True if a non-Latin character is found, otherwise false.
+ */
+export declare function containsNonLatin(text: string): boolean;
+declare const SCRIPT_TO_LANG: readonly [readonly [RegExp, "ja"], readonly [RegExp, "ko"], readonly [RegExp, "zh"], readonly [RegExp, "ru"], readonly [RegExp, "hi"], readonly [RegExp, "ar"], readonly [RegExp, "th"], readonly [RegExp, "el"], readonly [RegExp, "he"], readonly [RegExp, "bn"], readonly [RegExp, "ta"], readonly [RegExp, "te"], readonly [RegExp, "ml"], readonly [RegExp, "kn"], readonly [RegExp, "gu"], readonly [RegExp, "pa"], readonly [RegExp, "si"], readonly [RegExp, "my"], readonly [RegExp, "ka"], readonly [RegExp, "km"], readonly [RegExp, "lo"]];
+type NonLatinLanguageCode = (typeof SCRIPT_TO_LANG)[number][1];
+export declare function detectNonLatinLanguage(text: string): NonLatinLanguageCode | null;
+export {};

package/dist/text.js

@@ -0,0 +1,54 @@
+// Script detection for the text the module renders. Pure string work, no DOM and no host state.
+export const testRtl = (text) => /[\p{Script=Arabic}\p{Script=Hebrew}\p{Script=Syriac}\p{Script=Thaana}]/u.test(text);
+/**
+ * This regex is designed to detect any characters that are outside of the
+ * standard "Basic Latin" and "Latin-1 Supplement" Unicode blocks, as well
+ * as common "smart" punctuation like curved quotes.
+ *
+ * How it works:
+ * [^...]     - This is a negated set, which matches any character NOT inside the brackets.
+ * \x00-\xFF  - This range covers both the "Basic Latin" (ASCII) and "Latin-1 Supplement"
+ * blocks. This includes English letters, numbers, common punctuation, and
+ * most accented characters used in Western European languages (e.g., á, ö, ñ).
+ * ‘-” - This range covers common "smart" or curly punctuation, including single
+ * and double quotation marks/apostrophes (‘, ’, “, ”).
+ */
+const nonLatinRegex = /[^\p{Script_Extensions=Latin}\p{Script_Extensions=Common}]/u;
+/**
+ * Checks if a given string contains any non-Latin characters.
+ * @param text The string to check.
+ * @returns True if a non-Latin character is found, otherwise false.
+ */
+export function containsNonLatin(text) {
+    return nonLatinRegex.test(text);
+}
+const SCRIPT_TO_LANG = [
+    [/\p{Script=Hiragana}|\p{Script=Katakana}/u, "ja"],
+    [/\p{Script=Hangul}/u, "ko"],
+    [/\p{Script=Han}/u, "zh"],
+    [/\p{Script=Cyrillic}/u, "ru"],
+    [/\p{Script=Devanagari}/u, "hi"],
+    [/\p{Script=Arabic}/u, "ar"],
+    [/\p{Script=Thai}/u, "th"],
+    [/\p{Script=Greek}/u, "el"],
+    [/\p{Script=Hebrew}/u, "he"],
+    [/\p{Script=Bengali}/u, "bn"],
+    [/\p{Script=Tamil}/u, "ta"],
+    [/\p{Script=Telugu}/u, "te"],
+    [/\p{Script=Malayalam}/u, "ml"],
+    [/\p{Script=Kannada}/u, "kn"],
+    [/\p{Script=Gujarati}/u, "gu"],
+    [/\p{Script=Gurmukhi}/u, "pa"],
+    [/\p{Script=Sinhala}/u, "si"],
+    [/\p{Script=Myanmar}/u, "my"],
+    [/\p{Script=Georgian}/u, "ka"],
+    [/\p{Script=Khmer}/u, "km"],
+    [/\p{Script=Lao}/u, "lo"],
+];
+export function detectNonLatinLanguage(text) {
+    for (const [regex, lang] of SCRIPT_TO_LANG) {
+        if (regex.test(text))
+            return lang;
+    }
+    return null;
+}

package/dist/themeSettings.d.ts

@@ -0,0 +1,23 @@
+/** @public */
+export declare class Setting {
+    readonly type: "number" | "boolean" | "string";
+    value: number | boolean | string;
+    readonly defaultValue: number | boolean | string;
+    readonly requiresLyricReload: boolean;
+    private manuallySet;
+    constructor(type: "number" | "boolean" | "string", value: number | boolean | string, defaultValue: number | boolean | string, requiresLyricReload: boolean);
+    getNumberValue(): number;
+    getBooleanValue(): boolean;
+    getStringValue(): string;
+    isManuallySet(): boolean;
+    setManuallySet(manuallySet: boolean): void;
+}
+/**
+ * The `blyrics-*` configuration a compiled stylesheet declares, in declaration order, last one
+ * winning. Lives here rather than beside the renderer because it depends on nothing and its only
+ * consumer is `setThemeSettings`: a consumer that compiles a theme somewhere the renderer does not
+ * run can read the settings out of it without pulling the engine in.
+ */
+export declare function parseThemeConfig(css: string): Map<string, string>;
+export declare function registerThemeSetting(key: string, defaultValue: number | boolean | string, requiresLyricReload?: boolean): Setting;
+export declare function setThemeSettings(map: Map<string, string>): boolean;

package/dist/themeSettings.js

@@ -0,0 +1,126 @@
+// The renderer declares the theme settings its own code reads, so a setting and the code that
+// consumes it stay together. Applying settings reports whether the lyrics need reloading; the host
+// decides what to do about it.
+//
+// What arrives here is compiled CSS rather than theme source. Better Lyrics themes are written in
+// RICS and compiled with the `rics` package first, which is the consumer's dependency and not this
+// module's: nothing under this directory ships with any.
+let keyToSettingMap = new Map();
+// -- Setting --------------------------------------------
+// `registerThemeSetting` returns one of these, so a consumer of this leaf has to be able to spell
+// it. `@public` keeps knip off an export this repo only ever names through inference.
+/** @public */
+export class Setting {
+    type;
+    value;
+    defaultValue;
+    requiresLyricReload;
+    manuallySet = false;
+    constructor(type, value, defaultValue, requiresLyricReload) {
+        this.type = type;
+        this.value = value;
+        this.defaultValue = defaultValue;
+        this.requiresLyricReload = requiresLyricReload;
+    }
+    getNumberValue() {
+        return this.value;
+    }
+    getBooleanValue() {
+        return this.value;
+    }
+    getStringValue() {
+        return this.value;
+    }
+    isManuallySet() {
+        return this.manuallySet;
+    }
+    setManuallySet(manuallySet) {
+        this.manuallySet = manuallySet;
+    }
+}
+// -- Parsing a theme --------------------------------------------
+// A theme is a stylesheet, and it configures the renderer through comments inside it, in the form
+// `blyrics-some-key = value;`. Only inside comments: everything outside one is CSS the browser is
+// going to read, and a stylesheet must not be able to configure the module by accident.
+const THEME_COMMENT_PATTERN = /\/\*([\s\S]*?)\*\//g;
+const THEME_SETTING_PATTERN = /(blyrics-[\w-]+)\s*=\s*([^;]+);/g;
+/**
+ * The `blyrics-*` configuration a compiled stylesheet declares, in declaration order, last one
+ * winning. Lives here rather than beside the renderer because it depends on nothing and its only
+ * consumer is `setThemeSettings`: a consumer that compiles a theme somewhere the renderer does not
+ * run can read the settings out of it without pulling the engine in.
+ */
+export function parseThemeConfig(css) {
+    const config = new Map();
+    // `matchAll` works off a copy of the pattern, so neither of the two shared at module scope can
+    // carry a `lastIndex` out of one stylesheet and into the next however these loops are nested.
+    // Driving them with `exec` is correct too, as long as every loop is left running to exhaustion:
+    // this is written not to depend on that.
+    for (const [, comment] of css.matchAll(THEME_COMMENT_PATTERN)) {
+        for (const [, key, value] of comment.matchAll(THEME_SETTING_PATTERN)) {
+            config.set(key, value.trim());
+        }
+    }
+    return config;
+}
+// -- Registry --------------------------------------------
+// Registration runs at module scope, which evaluates once per bundle however many views that bundle
+// is rendering, so a setting's value is shared by all of them rather than held per instance. The
+// unit is a bundle rather than a document: this extension bundles the module into the isolated world
+// and the page world separately, and each of those registries needs its own theme applied to it or
+// one view renders against defaults while the other renders against the theme.
+export function registerThemeSetting(key, defaultValue, requiresLyricReload = false) {
+    let type = typeof defaultValue;
+    if (type !== "number" && type !== "boolean" && type !== "string") {
+        throw new Error("Invalid type for theme setting");
+    }
+    let setting = new Setting(type, defaultValue, defaultValue, requiresLyricReload);
+    keyToSettingMap.set(key, setting);
+    return setting;
+}
+// Returns whether a setting flagged requiresLyricReload changed, so the caller can reload.
+export function setThemeSettings(map) {
+    let needsLyricReload = false;
+    map.forEach((value, key) => {
+        let setting = keyToSettingMap.get(key);
+        if (setting) {
+            let lastValue = setting.value;
+            if (setting.type === "number") {
+                const parsed = parseFloat(value);
+                if (isNaN(parsed)) {
+                    setting.value = setting.defaultValue;
+                    setting.setManuallySet(false);
+                }
+                else {
+                    setting.value = parsed;
+                    setting.setManuallySet(true);
+                }
+            }
+            else if (setting.type === "boolean") {
+                setting.value = value.toLowerCase() === "true";
+                setting.setManuallySet(true);
+            }
+            else {
+                setting.value = value;
+                setting.setManuallySet(true);
+            }
+            if (setting.requiresLyricReload && lastValue !== setting.value) {
+                needsLyricReload = true;
+            }
+        }
+    });
+    // second pass reset undefined values to their default values
+    for (const [key, setting] of keyToSettingMap.entries()) {
+        if (!map.has(key) && setting.value !== setting.defaultValue) {
+            setting.value = setting.defaultValue;
+            setting.setManuallySet(false);
+            if (setting.requiresLyricReload) {
+                needsLyricReload = true;
+            }
+        }
+        else if (!map.has(key)) {
+            setting.setManuallySet(false);
+        }
+    }
+    return needsLyricReload;
+}