@lt-three/love3 0.0.0 → 0.1.1

package/dist/tuning/catalog.gen.js

@@ -0,0 +1,397 @@
+//#region src/tuning/catalog.gen.ts
+const catalog = {
+	"defaults": {
+		"light": {
+			"ink-1000": "#0f1012",
+			"ink-900": "#1b1c20",
+			"ink-700": "#40434a",
+			"ink-500": "#676b74",
+			"ink-300": "#a3a6ad",
+			"line": "#e6e7eb",
+			"line-strong": "#d5d7dd",
+			"line-control": "#80858f",
+			"frame": "#f4f5f7",
+			"paper": "#ffffff",
+			"raised": "#ffffff",
+			"overlay": "#ffffff",
+			"wash": "#f1f2f4",
+			"scrim": "rgba(0, 0, 0, 0.32)",
+			"shadow-color": "rgba(16, 24, 40, 0.1)",
+			"action": "#5e6ad2",
+			"action-hover": "#5059c2",
+			"action-foreground": "#ffffff",
+			"action-ink": "#4a55c0",
+			"lt-three": "#ff5c76",
+			"lt-three-foreground": "#000000",
+			"state-success": "#187548",
+			"state-error": "#c42b3a",
+			"state-warning": "#8f5f00",
+			"destructive-solid": "#c42b3a",
+			"destructive-solid-foreground": "#ffffff",
+			"font-geist": "\"Geist Variable\", \"Geist\"",
+			"font-geist-mono": "\"Geist Mono Variable\", \"Geist Mono\", ui-monospace, monospace",
+			"font-jp": "\"Yu Gothic Medium\", \"游ゴシック Medium\", YuGothic, \"游ゴシック体\", \"游ゴシック\", \"Yu Gothic\", sans-serif",
+			"font-mono": "\"Geist Mono Variable\", \"Geist Mono\", ui-monospace, monospace",
+			"background": "#ffffff",
+			"foreground": "#1b1c20",
+			"card": "#ffffff",
+			"card-foreground": "#1b1c20",
+			"popover": "#ffffff",
+			"popover-foreground": "#1b1c20",
+			"primary": "#5e6ad2",
+			"primary-foreground": "#ffffff",
+			"secondary": "#f1f2f4",
+			"secondary-foreground": "#1b1c20",
+			"muted": "#f1f2f4",
+			"muted-foreground": "#676b74",
+			"accent": "#f1f2f4",
+			"accent-foreground": "#1b1c20",
+			"destructive": "#c42b3a",
+			"destructive-foreground": "#ffffff",
+			"border": "#e6e7eb",
+			"input": "#d5d7dd",
+			"ring": "#5e6ad2",
+			"chart-1": "#5e6ad2",
+			"chart-2": "#1f9d6a",
+			"chart-3": "#bd7100",
+			"chart-4": "#d6495c",
+			"chart-5": "#7a8194",
+			"section": "#f4f5f7",
+			"radius": "6px",
+			"sidebar": "#f4f5f7",
+			"sidebar-foreground": "#1b1c20",
+			"sidebar-primary": "#5e6ad2",
+			"sidebar-primary-foreground": "#ffffff",
+			"sidebar-accent": "#f1f2f4",
+			"sidebar-accent-foreground": "#1b1c20",
+			"sidebar-border": "#e6e7eb",
+			"sidebar-ring": "#5e6ad2"
+		},
+		"dark": {
+			"ink-1000": "#f7f8f8",
+			"ink-900": "#eceef0",
+			"ink-700": "#cfd3da",
+			"ink-500": "#8a8f98",
+			"ink-300": "#5b5f67",
+			"line": "#25272c",
+			"line-strong": "#34363d",
+			"line-control": "#6b707a",
+			"frame": "#0a0b0d",
+			"paper": "#121316",
+			"raised": "#17181c",
+			"overlay": "#1d1e23",
+			"wash": "#1b1c20",
+			"scrim": "rgba(0, 0, 0, 0.72)",
+			"shadow-color": "rgba(0, 0, 0, 0.7)",
+			"action": "#5e6ad2",
+			"action-hover": "#5059c2",
+			"action-foreground": "#ffffff",
+			"action-ink": "#98a2f5",
+			"lt-three": "#ff5c76",
+			"lt-three-foreground": "#000000",
+			"state-success": "#4cc38a",
+			"state-error": "#f2707f",
+			"state-warning": "#e0a53a",
+			"destructive-solid": "#cf3345",
+			"destructive-solid-foreground": "#ffffff",
+			"font-geist": "\"Geist Variable\", \"Geist\"",
+			"font-geist-mono": "\"Geist Mono Variable\", \"Geist Mono\", ui-monospace, monospace",
+			"font-jp": "\"Yu Gothic Medium\", \"游ゴシック Medium\", YuGothic, \"游ゴシック体\", \"游ゴシック\", \"Yu Gothic\", sans-serif",
+			"font-mono": "\"Geist Mono Variable\", \"Geist Mono\", ui-monospace, monospace",
+			"background": "#121316",
+			"foreground": "#eceef0",
+			"card": "#17181c",
+			"card-foreground": "#eceef0",
+			"popover": "#1d1e23",
+			"popover-foreground": "#eceef0",
+			"primary": "#5e6ad2",
+			"primary-foreground": "#ffffff",
+			"secondary": "#1b1c20",
+			"secondary-foreground": "#eceef0",
+			"muted": "#1b1c20",
+			"muted-foreground": "#8a8f98",
+			"accent": "#1b1c20",
+			"accent-foreground": "#eceef0",
+			"destructive": "#f2707f",
+			"destructive-foreground": "#121316",
+			"border": "#25272c",
+			"input": "#34363d",
+			"ring": "#5e6ad2",
+			"chart-1": "#7c86e8",
+			"chart-2": "#4cc38a",
+			"chart-3": "#e5a23f",
+			"chart-4": "#f2707f",
+			"chart-5": "#9aa1b3",
+			"section": "#0a0b0d",
+			"radius": "6px",
+			"sidebar": "#0a0b0d",
+			"sidebar-foreground": "#eceef0",
+			"sidebar-primary": "#5e6ad2",
+			"sidebar-primary-foreground": "#ffffff",
+			"sidebar-accent": "#1b1c20",
+			"sidebar-accent-foreground": "#eceef0",
+			"sidebar-border": "#25272c",
+			"sidebar-ring": "#5e6ad2"
+		}
+	},
+	"colors": [
+		{
+			"name": "ink-1000",
+			"group": "ramp",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "ink-900",
+			"group": "ramp",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "ink-700",
+			"group": "ramp",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "ink-500",
+			"group": "ramp",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "ink-300",
+			"group": "ramp",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "line",
+			"group": "ramp",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "line-strong",
+			"group": "ramp",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "line-control",
+			"group": "ramp",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "frame",
+			"group": "ramp",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "paper",
+			"group": "ramp",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "raised",
+			"group": "ramp",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "overlay",
+			"group": "ramp",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "wash",
+			"group": "ramp",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "scrim",
+			"group": "ramp",
+			"hasDark": true,
+			"alpha": true
+		},
+		{
+			"name": "shadow-color",
+			"group": "ramp",
+			"hasDark": true,
+			"alpha": true
+		},
+		{
+			"name": "action",
+			"group": "action",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "action-hover",
+			"group": "action",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "action-foreground",
+			"group": "action",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "action-ink",
+			"group": "action",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "lt-three",
+			"group": "brand",
+			"hasDark": false,
+			"alpha": false
+		},
+		{
+			"name": "lt-three-foreground",
+			"group": "brand",
+			"hasDark": false,
+			"alpha": false
+		},
+		{
+			"name": "state-success",
+			"group": "state",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "state-error",
+			"group": "state",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "state-warning",
+			"group": "state",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "destructive-solid",
+			"group": "state",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "destructive-solid-foreground",
+			"group": "state",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "chart-1",
+			"group": "chart",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "chart-2",
+			"group": "chart",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "chart-3",
+			"group": "chart",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "chart-4",
+			"group": "chart",
+			"hasDark": true,
+			"alpha": false
+		},
+		{
+			"name": "chart-5",
+			"group": "chart",
+			"hasDark": true,
+			"alpha": false
+		}
+	],
+	"semantic": {
+		"background": "paper",
+		"foreground": "ink-900",
+		"card": "raised",
+		"card-foreground": "ink-900",
+		"popover": "overlay",
+		"popover-foreground": "ink-900",
+		"primary": "action",
+		"primary-foreground": "action-foreground",
+		"secondary": "wash",
+		"secondary-foreground": "ink-900",
+		"muted": "wash",
+		"muted-foreground": "ink-500",
+		"accent": "wash",
+		"accent-foreground": "ink-900",
+		"destructive": "state-error",
+		"destructive-foreground": "paper",
+		"border": "line",
+		"input": "line-strong",
+		"ring": "action",
+		"section": "frame",
+		"sidebar": "frame",
+		"sidebar-foreground": "ink-900",
+		"sidebar-primary": "action",
+		"sidebar-primary-foreground": "action-foreground",
+		"sidebar-accent": "wash",
+		"sidebar-accent-foreground": "ink-900",
+		"sidebar-border": "line",
+		"sidebar-ring": "action"
+	},
+	"refOptions": [
+		"ink-1000",
+		"ink-900",
+		"ink-700",
+		"ink-500",
+		"ink-300",
+		"line",
+		"line-strong",
+		"line-control",
+		"frame",
+		"paper",
+		"raised",
+		"overlay",
+		"wash",
+		"action",
+		"action-hover",
+		"action-foreground",
+		"action-ink",
+		"lt-three",
+		"lt-three-foreground",
+		"state-success",
+		"state-error",
+		"state-warning",
+		"destructive-solid",
+		"destructive-solid-foreground",
+		"chart-1",
+		"chart-2",
+		"chart-3",
+		"chart-4",
+		"chart-5"
+	],
+	"radius": {
+		"control": 6,
+		"surface": 10
+	},
+	"body": {
+		"size": 14,
+		"lineHeight": 22
+	}
+};
+
+//#endregion
+export { catalog };

package/dist/tuning/catalog.js

@@ -0,0 +1,128 @@
+//#region src/tuning/catalog.ts
+const COLOR_LITERAL = /^(#[0-9a-f]{3,8}|rgba?\(.*\))$/i;
+const RAMP_NAMES = /* @__PURE__ */ new Set([
+	"ink-1000",
+	"ink-900",
+	"ink-700",
+	"ink-500",
+	"ink-300",
+	"line",
+	"line-strong",
+	"line-control",
+	"frame",
+	"paper",
+	"raised",
+	"overlay",
+	"wash",
+	"scrim",
+	"action"
+]);
+function groupOf(name) {
+	if (name.startsWith("lt-three")) return "brand";
+	if (name.startsWith("state-") || name.startsWith("destructive-solid")) return "state";
+	if (name.startsWith("action")) return "action";
+	if (name.startsWith("chart-")) return "chart";
+	return "ramp";
+}
+/** Whether it is a translucent value (`rgba(…, 0.45)`, `#rrggbbaa`, and so on). Unreadable values are not treated as translucent. */
+function hasAlpha(value) {
+	const text = value.trim();
+	if (/^#[0-9a-f]{8}$/i.test(text)) return Number.parseInt(text.slice(7), 16) < 255;
+	const alpha = /^rgba\(\s*[\d.]+\s*,\s*[\d.]+\s*,\s*[\d.]+\s*,\s*([\d.]+)\s*\)$/i.exec(text)?.[1];
+	return alpha !== void 0 && Number(alpha) < 1;
+}
+/**
+* Builds what can be tuned from the definition.
+*
+* - Color tokens: those whose value is a color literal (`#…`, `rgba(…)`). Split into ramp, primary action, brand, state, and chart by name prefix
+* - Default references of semantic tokens: read from **`:root` in the generated CSS** (`--background: var(--paper)`).
+*   `tokens` holds actual values with `var()` resolved, so the targets are not preserved. The CSS holds the values that actually run, so it is the source of truth here
+* - Body size: `--text-body` / `--text-body--line-height` in the CSS `@theme`
+*
+* Throws if it cannot be read (so a change in the default shape that makes this reading stale is not silently missed).
+*/
+function buildCatalog({ tokens, tokenNames, css }) {
+	const root = /:root\s*\{([\s\S]*?)\n\}/.exec(css)?.[1];
+	if (root === void 0) throw new Error("生成された CSS に :root が見つからない");
+	const declared = /* @__PURE__ */ new Map();
+	for (const match of root.matchAll(/^\s*--([\w-]+):\s*([^;]+);/gm)) {
+		const [, name, value] = match;
+		if (name !== void 0 && value !== void 0) declared.set(name, value.trim());
+	}
+	const colors = tokenNames.filter((name) => COLOR_LITERAL.test(declared.get(name) ?? "")).map((name) => {
+		const group = groupOf(name);
+		return {
+			name,
+			group,
+			hasDark: group !== "brand",
+			alpha: hasAlpha(tokens.light[name] ?? "")
+		};
+	});
+	const colorNames = new Set(colors.map((color) => color.name));
+	for (const name of RAMP_NAMES) if (!colorNames.has(name)) throw new Error(`ランプのトークン --${name} が定義に無い`);
+	const semantic = {};
+	for (const name of tokenNames) {
+		const ref = /^var\(--([\w-]+)\)$/.exec(declared.get(name) ?? "")?.[1];
+		if (ref !== void 0 && colorNames.has(ref)) semantic[name] = ref;
+	}
+	if (Object.keys(semantic).length === 0) throw new Error("セマンティックトークンの参照先が CSS から読めない");
+	const size = /--text-body:\s*([\d.]+)px/.exec(css)?.[1];
+	const lineHeight = /--text-body--line-height:\s*([\d.]+)px/.exec(css)?.[1];
+	if (size === void 0 || lineHeight === void 0) throw new Error("--text-body が CSS から読めない");
+	const radiusOf = (role) => {
+		const px = new RegExp(`--radius-${role}:\\s*([\\d.]+)px`).exec(css)?.[1];
+		if (px === void 0) throw new Error(`--radius-${role} が CSS から読めない`);
+		return Number(px);
+	};
+	const radius = {
+		control: radiusOf("control"),
+		surface: radiusOf("surface")
+	};
+	return {
+		defaults: tokens,
+		colors,
+		semantic,
+		refOptions: colors.filter((color) => !color.alpha).map((color) => color.name),
+		radius,
+		body: {
+			size: Number(size),
+			lineHeight: Number(lineHeight)
+		}
+	};
+}
+function findColor(catalog, name) {
+	return catalog.colors.find((color) => color.name === name);
+}
+/**
+* Runs `buildCatalog` and returns instead of throwing on failure. When the generated CSS changes shape and the reading goes stale, **only tuning is disabled** and the rest of the screens keep working
+* (the reason is in `error`. An empty catalog is returned, so tuning has no effect). The caller shows and records `error`.
+*/
+function buildCatalogSafe(input) {
+	try {
+		return {
+			catalog: buildCatalog(input),
+			error: null
+		};
+	} catch (error) {
+		return {
+			catalog: {
+				defaults: input.tokens,
+				colors: [],
+				semantic: {},
+				refOptions: [],
+				radius: {
+					control: 6,
+					surface: 10
+				},
+				body: {
+					size: 14,
+					lineHeight: 22
+				}
+			},
+			error: error instanceof Error ? error.message : String(error)
+		};
+	}
+}
+
+//#endregion
+export { buildCatalog, buildCatalogSafe, findColor };

package/dist/tuning/color.d.ts

@@ -0,0 +1,20 @@
+//#region src/tuning/color.d.ts
+export type ColorResult = {
+  ok: true;
+  value: string;
+} | {
+  ok: false;
+  reason: string;
+};
+/**
+ * Reads a color token input and turns it into the canonical form.
+ *
+ * - Opaque colors (the default): `#rgb` / `#rrggbb` becomes a lowercase `#rrggbb` (the same form as `<input type="color">`)
+ * - Colors that allow translucency (scrim; `alpha: true`): additionally `#rrggbbaa` and `rgb()` / `rgba()`, normalized to the `rgba(r, g, b, a)` form
+ *
+ * Unreadable values and out-of-range values (above 255, or an opacity outside 0 to 1) are rejected with a reason.
+ */
+export declare function parseTokenColor(input: string, options: {
+  alpha: boolean;
+}): ColorResult;
+//#endregion

package/dist/tuning/color.js

@@ -0,0 +1,80 @@
+//#region src/tuning/color.ts
+const HEX6 = /^#([0-9a-f]{6})$/i;
+const HEX3 = /^#([0-9a-f]{3})$/i;
+const HEX8 = /^#([0-9a-f]{8})$/i;
+const RGBA = /^rgba?\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*(?:,\s*(\d*\.?\d+)\s*)?\)$/i;
+/**
+* Reads a color token input and turns it into the canonical form.
+*
+* - Opaque colors (the default): `#rgb` / `#rrggbb` becomes a lowercase `#rrggbb` (the same form as `<input type="color">`)
+* - Colors that allow translucency (scrim; `alpha: true`): additionally `#rrggbbaa` and `rgb()` / `rgba()`, normalized to the `rgba(r, g, b, a)` form
+*
+* Unreadable values and out-of-range values (above 255, or an opacity outside 0 to 1) are rejected with a reason.
+*/
+function parseTokenColor(input, options) {
+	const text = input.trim();
+	const hex6 = HEX6.exec(text);
+	if (hex6?.[1] !== void 0) return options.alpha ? {
+		ok: true,
+		value: toRgba(hex6[1], 255)
+	} : hex(hex6[1]);
+	const hex3 = HEX3.exec(text);
+	if (hex3?.[1] !== void 0) {
+		const expanded = hex3[1].replace(/./g, (c) => c + c);
+		return options.alpha ? {
+			ok: true,
+			value: toRgba(expanded, 255)
+		} : hex(expanded);
+	}
+	if (!options.alpha) return {
+		ok: false,
+		reason: `「${input}」は色として読めません。不透明な色は #rrggbb（または #rgb）で書きます（半透明は scrim だけ）`
+	};
+	const hex8 = HEX8.exec(text);
+	if (hex8?.[1] !== void 0) return {
+		ok: true,
+		value: toRgba(hex8[1].slice(0, 6), Number.parseInt(hex8[1].slice(6), 16))
+	};
+	const rgba = RGBA.exec(text);
+	if (rgba?.[1] !== void 0 && rgba[2] !== void 0 && rgba[3] !== void 0) {
+		const channels = [
+			rgba[1],
+			rgba[2],
+			rgba[3]
+		].map(Number);
+		if (channels.some((channel) => channel > 255)) return {
+			ok: false,
+			reason: `「${input}」の色の成分が 255 を超えています`
+		};
+		const alpha = rgba[4] === void 0 ? 1 : Number(rgba[4]);
+		if (alpha > 1) return {
+			ok: false,
+			reason: `「${input}」の不透明度が 1 を超えています（0〜1）`
+		};
+		return {
+			ok: true,
+			value: `rgba(${channels.join(", ")}, ${trimNumber(alpha)})`
+		};
+	}
+	return {
+		ok: false,
+		reason: `「${input}」は色として読めません。#rrggbb・#rrggbbaa・rgba(r, g, b, a) のどれかで書きます`
+	};
+}
+function hex(digits) {
+	return {
+		ok: true,
+		value: `#${digits.toLowerCase()}`
+	};
+}
+function toRgba(rgb, alpha255) {
+	const channel = (offset) => Number.parseInt(rgb.slice(offset, offset + 2), 16);
+	return `rgba(${channel(0)}, ${channel(2)}, ${channel(4)}, ${trimNumber(alpha255 / 255)})`;
+}
+/** Rounds a decimal and drops trailing zeros (0.45 → `0.45`, 1 → `1`). */
+function trimNumber(value) {
+	return String(Math.round(value * 100) / 100);
+}
+
+//#endregion
+export { parseTokenColor };

package/dist/tuning/css.d.ts

@@ -0,0 +1,35 @@
+import { Tuning, TuningCatalog } from "./types.js";
+//#region src/tuning/css.d.ts
+/** The shadow preset (Tailwind's default shadows). The love3 default is a soft shadow using `--shadow-color` (the `theme` in `definition.ts`). */
+export declare const SHADOW_PRESET: {
+  readonly "2xs": "0 1px rgb(0 0 0 / 0.05)";
+  readonly xs: "0 1px 2px 0 rgb(0 0 0 / 0.05)";
+  readonly sm: "0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1)";
+  readonly md: "0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1)";
+  readonly lg: "0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1)";
+  readonly xl: "0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1)";
+  readonly "2xl": "0 25px 50px -12px rgb(0 0 0 / 0.25)";
+};
+/**
+ * **The CSS injected into `<style id="love3-tuning">` at runtime.** An empty string when everything is at the defaults (nothing is injected).
+ *
+ * It has the same shape as the generated CSS of love3 (`:root` for light, `.dark` for dark), and is loaded later to override it.
+ * - For a changed color, **write both light and dark**. In the generated CSS `.dark` comes after `:root`, so if only light were overridden,
+ *   the `:root` placed later would beat the generated `.dark` and flatten dark mode too. The effective value is also written to `.dark` to protect dark separately
+ * - Semantic references, radius, typeface, and body size go only in `:root` (the generated `.dark` redefines only color tokens)
+ * - The radius (`--radius-control` / `--radius-surface`) is a variable of Tailwind's `@theme`, but at runtime it takes effect as a `:root` variable.
+ *   Tailwind folds shadows into classes (`.shadow-md { --tw-shadow: … }`), so `--tw-shadow` is overridden per class
+ */
+export declare function toRuntimeCss(tuning: Tuning, catalog: TuningCatalog): string;
+/**
+ * **The CSS for copying.** The same format as `styles.gen.css`, with only the difference from the defaults (`:root` / `.dark` / `@theme`).
+ * `@theme` holds Tailwind build-time variables (radius, shadow, body size), which `styles.gen.css` emits from the `theme` in `definition.ts`.
+ * It is separate from the CSS applied at runtime (`toRuntimeCss`; that one cannot use `@theme`).
+ */
+export declare function toExportCss(tuning: Tuning, catalog: TuningCatalog): string;
+/**
+ * **The diff to bring into `definition.ts`.** In the shape of the SSOT token lines (`{ name, value, dark }`) and the `theme` lines,
+ * it outputs only the changed items. Names stay the same and only values are swapped (how to edit tokens). Run `bun run generate` after bringing it in.
+ */
+export declare function toDefinitionDiff(tuning: Tuning, catalog: TuningCatalog): string;
+//#endregion