@lt-three/love3 0.0.0-stage → 0.1.0

package/dist/tuning/css.js

@@ -0,0 +1,147 @@
+import { FONT_KEYS, FONT_TOKEN, RADIUS_ROLES } from "./types.js";
+import { bodyLineHeight, colorValue, normalize } from "./model.js";
+
+//#region src/tuning/css.ts
+/** 影の preset（Tailwind の既定の影）。love3 の既定は `--shadow-color` を使う淡い影（`definition.ts` の `theme`）。 */
+const SHADOW_PRESET = {
+	"2xs": "0 1px rgb(0 0 0 / 0.05)",
+	xs: "0 1px 2px 0 rgb(0 0 0 / 0.05)",
+	sm: "0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1)",
+	md: "0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1)",
+	lg: "0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1)",
+	xl: "0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1)",
+	"2xl": "0 25px 50px -12px rgb(0 0 0 / 0.25)"
+};
+/** 影を消す preset（`SHADOW_PRESET` と同じ段）。 */
+const SHADOW_NONE = {
+	"2xs": "none",
+	xs: "none",
+	sm: "none",
+	md: "none",
+	lg: "none",
+	xl: "none",
+	"2xl": "none"
+};
+/** 調整で差し替える影の値。既定（`default`）は差し替えない。 */
+function shadowValues(n) {
+	if (n.shadow === "default") return [];
+	return Object.entries(n.shadow === "none" ? SHADOW_NONE : SHADOW_PRESET);
+}
+/** 変えた色のトークン名（ライト・ダークのどちらかで変えたもの）。定義の順。 */
+function touchedColors(n, catalog) {
+	return catalog.colors.map((color) => color.name).filter((name) => n.tokens.light[name] !== void 0 || n.tokens.dark[name] !== void 0);
+}
+function decl(name, value) {
+	return `  --${name}: ${value};`;
+}
+function block(selector, lines) {
+	return lines.length === 0 ? "" : `${selector} {\n${lines.join("\n")}\n}`;
+}
+/** 既定と違う役割（`normalize` 済みなので、`radius` に残っているのが差分）。 */
+function radiusRoles(n) {
+	return RADIUS_ROLES.flatMap((role) => {
+		const px = n.radius[role];
+		return px === void 0 ? [] : [[`radius-${role}`, `${px}px`]];
+	});
+}
+/**
+* **実行時に `<style id="love3-tuning">` へ差し込む CSS。** 既定どおりなら空文字（差し込まない）。
+*
+* love3 の生成 CSS と同じ形（`:root` がライト・`.dark` がダーク）で、後から読み込んで上書きする。
+* - 変えた色は、**ライトとダークの両方を書く**。生成 CSS は `:root` の後に `.dark` が来るので、ライトだけを上書きすると、
+*   後ろに置いた `:root` が生成の `.dark` に勝ってダークまで潰れる。`.dark` にも実効値を書いて、ダークは別に守る
+* - セマンティックの参照・角丸・書体・本文サイズは `:root` だけ（生成の `.dark` は色のトークンしか再定義しない）
+* - 角丸（`--radius-control` / `--radius-surface`）は Tailwind の `@theme` の変数だが実行時は `:root` の変数として効く。
+*   影は Tailwind がクラスに畳み込む（`.shadow-md { --tw-shadow: … }`）ので、クラスごとに `--tw-shadow` を上書きする
+*/
+function toRuntimeCss(tuning, catalog) {
+	const n = normalize(tuning, catalog);
+	const touched = touchedColors(n, catalog);
+	const root = [];
+	const dark = [];
+	for (const name of touched) {
+		root.push(decl(name, colorValue(n, catalog, "light", name)));
+		if (catalog.colors.find((color) => color.name === name)?.hasDark === true) dark.push(decl(name, colorValue(n, catalog, "dark", name)));
+	}
+	for (const [name, ref] of Object.entries(n.semantic)) root.push(decl(name, `var(--${ref})`));
+	for (const [name, value] of radiusRoles(n)) root.push(decl(name, value));
+	for (const key of FONT_KEYS) {
+		const value = n.font[key];
+		if (value !== void 0) root.push(decl(FONT_TOKEN[key], value));
+	}
+	if (n.font.bodySize !== void 0) {
+		root.push(decl("text-body", `${n.font.bodySize}px`));
+		root.push(decl("text-body--line-height", `${bodyLineHeight(catalog, n.font.bodySize)}px`));
+	}
+	const parts = [block(":root", root), block(".dark", dark)];
+	for (const [step, value] of shadowValues(n)) parts.push(block(`.shadow-${step}`, [`  --tw-shadow: ${value};`]));
+	return parts.filter((part) => part !== "").join("\n");
+}
+/**
+* **コピー用の CSS。** `styles.gen.css` と同じ書式で、既定との差分だけ（`:root` / `.dark` / `@theme`）。
+* `@theme` は Tailwind のビルド時の変数（角丸・影・本文サイズ）で、`styles.gen.css` では `definition.ts` の `theme` から出る。
+* 実行時に効かせる CSS（`toRuntimeCss`）とは別物（そちらは `@theme` を使えない）。
+*/
+function toExportCss(tuning, catalog) {
+	const n = normalize(tuning, catalog);
+	const root = [];
+	const dark = [];
+	for (const color of catalog.colors) {
+		const light = n.tokens.light[color.name];
+		if (light !== void 0) root.push(decl(color.name, light));
+		const night = n.tokens.dark[color.name];
+		if (night !== void 0) dark.push(decl(color.name, night));
+	}
+	for (const [name, ref] of Object.entries(n.semantic)) root.push(decl(name, `var(--${ref})`));
+	for (const key of FONT_KEYS) {
+		const value = n.font[key];
+		if (value !== void 0) root.push(decl(FONT_TOKEN[key], value));
+	}
+	const theme = radiusRoles(n).map(([name, value]) => decl(name, value));
+	for (const [step, value] of shadowValues(n)) theme.push(decl(`shadow-${step}`, value));
+	if (n.font.bodySize !== void 0) {
+		theme.push(decl("text-body", `${n.font.bodySize}px`));
+		theme.push(decl("text-body--line-height", `${bodyLineHeight(catalog, n.font.bodySize)}px`));
+	}
+	return [
+		block(":root", root),
+		block(".dark", dark),
+		block("@theme", theme)
+	].filter((part) => part !== "").join("\n\n");
+}
+/**
+* **`definition.ts` に取り込むための差分。** SSOT のトークンの行（`{ name, value, dark }`）と、`theme` の行の形で、
+* 変えた項目だけを出す。名前は変えず、値を差し替える（トークンの直し方）。取り込んだら `bun run generate`。
+*/
+function toDefinitionDiff(tuning, catalog) {
+	const n = normalize(tuning, catalog);
+	const lines = [];
+	const tokenLines = [];
+	for (const color of catalog.colors) {
+		if (n.tokens.light[color.name] === void 0 && n.tokens.dark[color.name] === void 0) continue;
+		const fields = [`name: ${JSON.stringify(color.name)}`, `value: ${JSON.stringify(colorValue(n, catalog, "light", color.name))}`];
+		if (color.hasDark) fields.push(`dark: ${JSON.stringify(colorValue(n, catalog, "dark", color.name))}`);
+		fields.push("color: true");
+		tokenLines.push(`{ ${fields.join(", ")} },`);
+	}
+	for (const [name, ref] of Object.entries(n.semantic)) tokenLines.push(`{ name: ${JSON.stringify(name)}, value: ${JSON.stringify(`var(--${ref})`)}, color: true },`);
+	for (const key of FONT_KEYS) {
+		const value = n.font[key];
+		if (value !== void 0) tokenLines.push(`{ name: ${JSON.stringify(FONT_TOKEN[key])}, value: ${JSON.stringify(value)} },`);
+	}
+	if (tokenLines.length > 0) lines.push("// groups[].tokens の該当する行を、次の値に差し替える", ...tokenLines);
+	const themeLines = radiusRoles(n).map(([name, value]) => `${JSON.stringify(name)}: ${JSON.stringify(value)},`);
+	for (const [step, value] of shadowValues(n)) themeLines.push(`${JSON.stringify(`shadow-${step}`)}: ${JSON.stringify(value)},`);
+	if (n.font.bodySize !== void 0) {
+		themeLines.push(`"text-body": ${JSON.stringify(`${n.font.bodySize}px`)},`);
+		themeLines.push(`"text-body--line-height": ${JSON.stringify(`${bodyLineHeight(catalog, n.font.bodySize)}px`)},`);
+	}
+	if (themeLines.length > 0) {
+		if (lines.length > 0) lines.push("");
+		lines.push("// theme の該当する行を、次の値に差し替える", ...themeLines);
+	}
+	return lines.join("\n");
+}
+
+//#endregion
+export { SHADOW_PRESET, toDefinitionDiff, toExportCss, toRuntimeCss };

package/dist/tuning/index.d.ts

@@ -0,0 +1,8 @@
+import { BODY_SIZE_MAX, BODY_SIZE_MIN, ColorGroup, ColorToken, FONT_KEYS, FONT_TOKEN, FontKey, MODES, Mode, RADIUS_MAX, RADIUS_ROLES, RadiusRole, ShadowPreset, Tuning, TuningCatalog, emptyTuning } from "./types.js";
+import { buildCatalog, buildCatalogSafe, findColor } from "./catalog.js";
+import { ColorResult, parseTokenColor } from "./color.js";
+import { SHADOW_PRESET, toDefinitionDiff, toExportCss, toRuntimeCss } from "./css.js";
+import { bodyLineHeight, colorValue, countChanges, defaultFont, effectiveTokens, isEmpty, modeOf, normalize, radiusPx, withBodySize, withColor, withFont, withRadius, withSemantic, withShadow } from "./model.js";
+import { NATIVE_BUILD_FIXED_BRAND_TOKENS, NATIVE_BUILD_FIXED_TOKENS, firstFontFamily, nativeLimits, toNativeVariables } from "./native.js";
+import { Envelope, FORMAT, MAX_ENTRIES, MAX_IMPORT_BYTES, MAX_REASONS, ParseResult, STORAGE_KEY, TOO_LARGE_REASON, VERSION, fontProblem, parseTuning, toExportObject, toJson, tooLarge } from "./schema.js";
+export { BODY_SIZE_MAX, BODY_SIZE_MIN, ColorGroup, ColorResult, ColorToken, type Envelope, FONT_KEYS, FONT_TOKEN, FORMAT, FontKey, MAX_ENTRIES, MAX_IMPORT_BYTES, MAX_REASONS, MODES, Mode, NATIVE_BUILD_FIXED_BRAND_TOKENS, NATIVE_BUILD_FIXED_TOKENS, ParseResult, RADIUS_MAX, RADIUS_ROLES, RadiusRole, SHADOW_PRESET, STORAGE_KEY, ShadowPreset, TOO_LARGE_REASON, Tuning, TuningCatalog, VERSION, bodyLineHeight, buildCatalog, buildCatalogSafe, colorValue, countChanges, defaultFont, effectiveTokens, emptyTuning, findColor, firstFontFamily, fontProblem, isEmpty, modeOf, nativeLimits, normalize, parseTokenColor, parseTuning, radiusPx, toDefinitionDiff, toExportCss, toExportObject, toJson, toNativeVariables, toRuntimeCss, tooLarge, withBodySize, withColor, withFont, withRadius, withSemantic, withShadow };

package/dist/tuning/index.js

@@ -0,0 +1,9 @@
+import { buildCatalog, buildCatalogSafe, findColor } from "./catalog.js";
+import { parseTokenColor } from "./color.js";
+import { BODY_SIZE_MAX, BODY_SIZE_MIN, FONT_KEYS, FONT_TOKEN, MODES, RADIUS_MAX, RADIUS_ROLES, emptyTuning } from "./types.js";
+import { bodyLineHeight, colorValue, countChanges, defaultFont, effectiveTokens, isEmpty, modeOf, normalize, radiusPx, withBodySize, withColor, withFont, withRadius, withSemantic, withShadow } from "./model.js";
+import { SHADOW_PRESET, toDefinitionDiff, toExportCss, toRuntimeCss } from "./css.js";
+import { NATIVE_BUILD_FIXED_BRAND_TOKENS, NATIVE_BUILD_FIXED_TOKENS, firstFontFamily, nativeLimits, toNativeVariables } from "./native.js";
+import { FORMAT, MAX_ENTRIES, MAX_IMPORT_BYTES, MAX_REASONS, STORAGE_KEY, TOO_LARGE_REASON, VERSION, fontProblem, parseTuning, toExportObject, toJson, tooLarge } from "./schema.js";
+
+export { BODY_SIZE_MAX, BODY_SIZE_MIN, FONT_KEYS, FONT_TOKEN, FORMAT, MAX_ENTRIES, MAX_IMPORT_BYTES, MAX_REASONS, MODES, NATIVE_BUILD_FIXED_BRAND_TOKENS, NATIVE_BUILD_FIXED_TOKENS, RADIUS_MAX, RADIUS_ROLES, SHADOW_PRESET, STORAGE_KEY, TOO_LARGE_REASON, VERSION, bodyLineHeight, buildCatalog, buildCatalogSafe, colorValue, countChanges, defaultFont, effectiveTokens, emptyTuning, findColor, firstFontFamily, fontProblem, isEmpty, modeOf, nativeLimits, normalize, parseTokenColor, parseTuning, radiusPx, toDefinitionDiff, toExportCss, toExportObject, toJson, toNativeVariables, toRuntimeCss, tooLarge, withBodySize, withColor, withFont, withRadius, withSemantic, withShadow };

package/dist/tuning/model.d.ts

@@ -0,0 +1,33 @@
+import { FontKey, Mode, RadiusRole, ShadowPreset, Tuning, TuningCatalog } from "./types.js";
+//#region src/tuning/model.d.ts
+/** 色のトークンを実際に持つモード。ブランド色は共通なので、ダークの指定は `light` に寄せる。 */
+export declare function modeOf(catalog: TuningCatalog, name: string, mode: Mode): Mode;
+/** 既定のフォント値。 */
+export declare function defaultFont(catalog: TuningCatalog, key: FontKey): string;
+/** 役割ごとの角丸（px）。指定が無ければ既定（control 6・surface 10）。 */
+export declare function radiusPx(tuning: Tuning, catalog: TuningCatalog, role: RadiusRole): number;
+/** 本文の行の高さ（px）。サイズに比例させる（既定の 14px / 22px の比）。 */
+export declare function bodyLineHeight(catalog: TuningCatalog, size: number): number;
+/**
+ * 既定と同じ値の項目を落として、同じ内容が 1 通りの形になるようにする（保存・エクスポート・比較の前に通す）。
+ * 色は正規の形（小文字の `#rrggbb`）にそろえる。読めない色は落とさずそのまま残す（検証は `parseTuning` の仕事）。
+ */
+export declare function normalize(tuning: Tuning, catalog: TuningCatalog): Tuning;
+/** 既定と同じ（差分が無い）か。 */
+export declare function isEmpty(tuning: Tuning, catalog: TuningCatalog): boolean;
+/** 既定との差分の数（色・参照先・角丸・書体・影の項目ごとに 1）。 */
+export declare function countChanges(tuning: Tuning, catalog: TuningCatalog): number;
+/**
+ * トークンの実値。**参照（`var()`）をたどる**: セマンティックトークンは参照先（上書きがあればそれ、無ければ既定）の実値になる。
+ * 参照先のランプを調整すれば、それを指すセマンティックトークンも変わる（実行時の CSS と同じ解決）。
+ */
+export declare function colorValue(tuning: Tuning, catalog: TuningCatalog, mode: Mode, name: string): string;
+/** 全トークン（色・書体・調整した角丸）の実値の表。調整を重ねた後の値で、`tokens` と同じ形。 */
+export declare function effectiveTokens(tuning: Tuning, catalog: TuningCatalog): Record<Mode, Record<string, string>>;
+export declare function withColor(tuning: Tuning, catalog: TuningCatalog, mode: Mode, name: string, value: string | undefined): Tuning;
+export declare function withSemantic(tuning: Tuning, name: string, ref: string | undefined): Tuning;
+export declare function withRadius(tuning: Tuning, role: RadiusRole, px: number | undefined): Tuning;
+export declare function withFont(tuning: Tuning, key: FontKey, value: string | undefined): Tuning;
+export declare function withBodySize(tuning: Tuning, size: number | undefined): Tuning;
+export declare function withShadow(tuning: Tuning, shadow: ShadowPreset): Tuning;
+//#endregion

package/dist/tuning/model.js

@@ -0,0 +1,154 @@
+import { parseTokenColor } from "./color.js";
+import { FONT_KEYS, FONT_TOKEN, MODES, RADIUS_ROLES, emptyTuning } from "./types.js";
+
+//#region src/tuning/model.ts
+/** 色のトークンを実際に持つモード。ブランド色は共通なので、ダークの指定は `light` に寄せる。 */
+function modeOf(catalog, name, mode) {
+	return mode === "dark" && catalog.colors.find((color) => color.name === name)?.hasDark === false ? "light" : mode;
+}
+/** 既定のフォント値。 */
+function defaultFont(catalog, key) {
+	return catalog.defaults.light[FONT_TOKEN[key]] ?? "";
+}
+/** 役割ごとの角丸（px）。指定が無ければ既定（control 6・surface 10）。 */
+function radiusPx(tuning, catalog, role) {
+	return tuning.radius[role] ?? catalog.radius[role];
+}
+/** 本文の行の高さ（px）。サイズに比例させる（既定の 14px / 22px の比）。 */
+function bodyLineHeight(catalog, size) {
+	return Math.round(size * catalog.body.lineHeight / catalog.body.size);
+}
+/**
+* 既定と同じ値の項目を落として、同じ内容が 1 通りの形になるようにする（保存・エクスポート・比較の前に通す）。
+* 色は正規の形（小文字の `#rrggbb`）にそろえる。読めない色は落とさずそのまま残す（検証は `parseTuning` の仕事）。
+*/
+function normalize(tuning, catalog) {
+	const out = emptyTuning();
+	for (const mode of MODES) for (const color of catalog.colors) {
+		const raw = tuning.tokens[mode][color.name];
+		if (raw === void 0) continue;
+		if (mode === "dark" && !color.hasDark) continue;
+		const parsed = parseTokenColor(raw, { alpha: color.alpha });
+		const value = parsed.ok ? parsed.value : raw;
+		const fallback = catalog.defaults[mode][color.name];
+		if (value !== (fallback === void 0 ? void 0 : toCanonical(fallback, color.alpha))) out.tokens[mode][color.name] = value;
+	}
+	for (const [name, ref] of Object.entries(tuning.semantic)) if (Object.hasOwn(catalog.semantic, name) && ref !== catalog.semantic[name]) out.semantic[name] = ref;
+	for (const role of RADIUS_ROLES) {
+		const px = tuning.radius[role];
+		if (px !== void 0 && px !== catalog.radius[role]) out.radius[role] = px;
+	}
+	for (const key of FONT_KEYS) {
+		const value = tuning.font[key];
+		if (value !== void 0 && value !== defaultFont(catalog, key)) out.font[key] = value;
+	}
+	if (tuning.font.bodySize !== void 0 && tuning.font.bodySize !== catalog.body.size) out.font.bodySize = tuning.font.bodySize;
+	out.shadow = tuning.shadow;
+	return out;
+}
+function toCanonical(value, alpha) {
+	const parsed = parseTokenColor(value, { alpha });
+	return parsed.ok ? parsed.value : value;
+}
+/** 既定と同じ（差分が無い）か。 */
+function isEmpty(tuning, catalog) {
+	return countChanges(tuning, catalog) === 0;
+}
+/** 既定との差分の数（色・参照先・角丸・書体・影の項目ごとに 1）。 */
+function countChanges(tuning, catalog) {
+	const n = normalize(tuning, catalog);
+	return Object.keys(n.tokens.light).length + Object.keys(n.tokens.dark).length + Object.keys(n.semantic).length + Object.keys(n.radius).length + Object.keys(n.font).length + (n.shadow === "default" ? 0 : 1);
+}
+/**
+* トークンの実値。**参照（`var()`）をたどる**: セマンティックトークンは参照先（上書きがあればそれ、無ければ既定）の実値になる。
+* 参照先のランプを調整すれば、それを指すセマンティックトークンも変わる（実行時の CSS と同じ解決）。
+*/
+function colorValue(tuning, catalog, mode, name) {
+	const ref = (Object.hasOwn(tuning.semantic, name) ? tuning.semantic[name] : void 0) ?? (Object.hasOwn(catalog.semantic, name) ? catalog.semantic[name] : void 0);
+	if (ref !== void 0) return colorValue(tuning, catalog, mode, ref);
+	const owner = modeOf(catalog, name, mode);
+	const override = Object.hasOwn(tuning.tokens[owner], name) ? tuning.tokens[owner][name] : void 0;
+	if (override !== void 0) return override;
+	const fallback = Object.hasOwn(catalog.defaults[mode], name) ? catalog.defaults[mode][name] : void 0;
+	if (fallback === void 0) throw new Error(`未定義のトークン: --${name}`);
+	return fallback;
+}
+/** 全トークン（色・書体・調整した角丸）の実値の表。調整を重ねた後の値で、`tokens` と同じ形。 */
+function effectiveTokens(tuning, catalog) {
+	const out = {
+		light: {},
+		dark: {}
+	};
+	for (const mode of MODES) {
+		for (const [name, value] of Object.entries(catalog.defaults[mode])) {
+			const isColor = catalog.colors.some((color) => color.name === name) || Object.hasOwn(catalog.semantic, name);
+			out[mode][name] = isColor ? colorValue(tuning, catalog, mode, name) : value;
+		}
+		for (const key of FONT_KEYS) out[mode][FONT_TOKEN[key]] = tuning.font[key] ?? defaultFont(catalog, key);
+		out[mode]["font-mono"] = out[mode]["font-geist-mono"] ?? "";
+		for (const role of RADIUS_ROLES) {
+			const px = tuning.radius[role];
+			if (px !== void 0) out[mode][`radius-${role}`] = `${px}px`;
+		}
+	}
+	return out;
+}
+function withColor(tuning, catalog, mode, name, value) {
+	const owner = modeOf(catalog, name, mode);
+	const table = { ...tuning.tokens[owner] };
+	if (value === void 0) delete table[name];
+	else table[name] = value;
+	return {
+		...tuning,
+		tokens: {
+			...tuning.tokens,
+			[owner]: table
+		}
+	};
+}
+function withSemantic(tuning, name, ref) {
+	const semantic = { ...tuning.semantic };
+	if (ref === void 0) delete semantic[name];
+	else semantic[name] = ref;
+	return {
+		...tuning,
+		semantic
+	};
+}
+function withRadius(tuning, role, px) {
+	const radius = { ...tuning.radius };
+	if (px === void 0) delete radius[role];
+	else radius[role] = px;
+	return {
+		...tuning,
+		radius
+	};
+}
+function withFont(tuning, key, value) {
+	const font = { ...tuning.font };
+	if (value === void 0) delete font[key];
+	else font[key] = value;
+	return {
+		...tuning,
+		font
+	};
+}
+function withBodySize(tuning, size) {
+	const { bodySize: _previous, ...rest } = tuning.font;
+	return {
+		...tuning,
+		font: size === void 0 ? rest : {
+			...rest,
+			bodySize: size
+		}
+	};
+}
+function withShadow(tuning, shadow) {
+	return {
+		...tuning,
+		shadow
+	};
+}
+
+//#endregion
+export { bodyLineHeight, colorValue, countChanges, defaultFont, effectiveTokens, isEmpty, modeOf, normalize, radiusPx, withBodySize, withColor, withFont, withRadius, withSemantic, withShadow };

package/dist/tuning/native.d.ts

@@ -0,0 +1,35 @@
+import { Mode, Tuning, TuningCatalog } from "./types.js";
+//#region src/tuning/native.d.ts
+/**
+ * ライト・ダークで**同じ値**のトークン（`.dark` で再定義しない）と、それを指すエイリアス。
+ * react-native-css は、1 度しか宣言されない変数を**ビルド時にリテラルへ畳み込む**ので、`bg-action` などのクラスは
+ * 実機で CSS 変数を引かず、**実行時の上書き（`toNativeVariables`）に追従しない**。TS から色を引く `useTokenColor` は追従する。
+ * 一覧が `definition.ts` と食い違わないことは、`native/lib/tokens.test.ts` が見る。
+ */
+export declare const NATIVE_BUILD_FIXED_TOKENS: readonly ["action", "action-hover", "action-foreground", "primary", "primary-foreground", "ring", "sidebar-primary", "sidebar-primary-foreground", "sidebar-ring", "destructive-solid-foreground"];
+/**
+ * ブランド色（`lt-three`・`lt-three-foreground`）。ライト・ダーク共通でビルド時に固定され、`bg-lt-three` などのクラスは
+ * 実行時の上書きに追従しない（テーマで反転させないための仕様）。`NATIVE_BUILD_FIXED_TOKENS` とは別に持つのは、
+ * `native/lib/tokens-check.ts` の畳み込み検査がブランド色を別扱いしているため（一覧の検査と食い違わせない）。
+ */
+export declare const NATIVE_BUILD_FIXED_BRAND_TOKENS: readonly ["lt-three", "lt-three-foreground"];
+/** 書体の値（CSS の font-family の並び）の先頭の名前。RN の `fontFamily` は 1 つの名前しか取らない。`var()` なら undefined。 */
+export declare function firstFontFamily(value: string): string | undefined;
+/**
+ * native に配る CSS 変数（react-native-css の `VariableContextProvider` の `value`）。指定したモードの、**既定と違うものだけ**。
+ * - 色のトークン: 実効値（セマンティックの参照も解決した値）。ランプの変更に依存するセマンティックトークンも、同じ変更の下で
+ *   別のリテラルとして載せる（react-native-web では `--card: var(--raised)` が `:root` で解決済みで、ランプの上書きだけでは追従しないため）
+ * - 角丸（`--radius-control` / `--radius-surface`）: px
+ * - 書体（`--font-geist` など）: 先頭の名前だけ
+ *
+ * **実機で効くのは、ライト・ダークで値が違う色のトークンを使うクラス（`bg-card` など。実機ではランプへの参照になる）と書体**。
+ * 角丸・本文サイズはビルド時にリテラルへ畳み込まれ、`NATIVE_BUILD_FIXED_TOKENS` の色のクラスも畳み込まれるので、実機では効かない
+ * （react-native-web では CSS 変数なので効く）。何が効かないかは `nativeLimits` が返す。
+ */
+export declare function toNativeVariables(tuning: Tuning, catalog: TuningCatalog, mode: Mode): Record<`--${string}`, string>;
+/**
+ * 調整のうち、**native の実機では実行時に効かない項目**の説明（日本語）。空なら全部効く（react-native-web では全部効く）。
+ * 調整の画面に出して、「効かないのは仕様」と分かるようにする。値は JSON に残るので、web で読めば効く。
+ */
+export declare function nativeLimits(tuning: Tuning, catalog: TuningCatalog): string[];
+//#endregion

package/dist/tuning/native.js

@@ -0,0 +1,80 @@
+import { FONT_KEYS, FONT_TOKEN, RADIUS_ROLES } from "./types.js";
+import { effectiveTokens, normalize } from "./model.js";
+
+//#region src/tuning/native.ts
+/**
+* ライト・ダークで**同じ値**のトークン（`.dark` で再定義しない）と、それを指すエイリアス。
+* react-native-css は、1 度しか宣言されない変数を**ビルド時にリテラルへ畳み込む**ので、`bg-action` などのクラスは
+* 実機で CSS 変数を引かず、**実行時の上書き（`toNativeVariables`）に追従しない**。TS から色を引く `useTokenColor` は追従する。
+* 一覧が `definition.ts` と食い違わないことは、`native/lib/tokens.test.ts` が見る。
+*/
+const NATIVE_BUILD_FIXED_TOKENS = [
+	"action",
+	"action-hover",
+	"action-foreground",
+	"primary",
+	"primary-foreground",
+	"ring",
+	"sidebar-primary",
+	"sidebar-primary-foreground",
+	"sidebar-ring",
+	"destructive-solid-foreground"
+];
+/**
+* ブランド色（`lt-three`・`lt-three-foreground`）。ライト・ダーク共通でビルド時に固定され、`bg-lt-three` などのクラスは
+* 実行時の上書きに追従しない（テーマで反転させないための仕様）。`NATIVE_BUILD_FIXED_TOKENS` とは別に持つのは、
+* `native/lib/tokens-check.ts` の畳み込み検査がブランド色を別扱いしているため（一覧の検査と食い違わせない）。
+*/
+const NATIVE_BUILD_FIXED_BRAND_TOKENS = ["lt-three", "lt-three-foreground"];
+/** 書体の値（CSS の font-family の並び）の先頭の名前。RN の `fontFamily` は 1 つの名前しか取らない。`var()` なら undefined。 */
+function firstFontFamily(value) {
+	const first = value.split(",")[0]?.trim() ?? "";
+	if (first === "" || first.startsWith("var(")) return void 0;
+	return first.replace(/^["']|["']$/g, "");
+}
+/**
+* native に配る CSS 変数（react-native-css の `VariableContextProvider` の `value`）。指定したモードの、**既定と違うものだけ**。
+* - 色のトークン: 実効値（セマンティックの参照も解決した値）。ランプの変更に依存するセマンティックトークンも、同じ変更の下で
+*   別のリテラルとして載せる（react-native-web では `--card: var(--raised)` が `:root` で解決済みで、ランプの上書きだけでは追従しないため）
+* - 角丸（`--radius-control` / `--radius-surface`）: px
+* - 書体（`--font-geist` など）: 先頭の名前だけ
+*
+* **実機で効くのは、ライト・ダークで値が違う色のトークンを使うクラス（`bg-card` など。実機ではランプへの参照になる）と書体**。
+* 角丸・本文サイズはビルド時にリテラルへ畳み込まれ、`NATIVE_BUILD_FIXED_TOKENS` の色のクラスも畳み込まれるので、実機では効かない
+* （react-native-web では CSS 変数なので効く）。何が効かないかは `nativeLimits` が返す。
+*/
+function toNativeVariables(tuning, catalog, mode) {
+	const n = normalize(tuning, catalog);
+	const effective = effectiveTokens(n, catalog)[mode];
+	const out = {};
+	const isColor = (name) => catalog.colors.some((color) => color.name === name) || Object.hasOwn(catalog.semantic, name);
+	for (const [name, value] of Object.entries(effective)) if (isColor(name) && value !== catalog.defaults[mode][name]) out[`--${name}`] = value;
+	for (const role of RADIUS_ROLES) {
+		const px = n.radius[role];
+		if (px !== void 0) out[`--radius-${role}`] = `${px}px`;
+	}
+	for (const key of FONT_KEYS) {
+		const family = n.font[key] === void 0 ? void 0 : firstFontFamily(n.font[key]);
+		if (family !== void 0) out[`--${FONT_TOKEN[key]}`] = family;
+	}
+	return out;
+}
+/**
+* 調整のうち、**native の実機では実行時に効かない項目**の説明（日本語）。空なら全部効く（react-native-web では全部効く）。
+* 調整の画面に出して、「効かないのは仕様」と分かるようにする。値は JSON に残るので、web で読めば効く。
+*/
+function nativeLimits(tuning, catalog) {
+	const n = normalize(tuning, catalog);
+	const notes = [];
+	const fixed = /* @__PURE__ */ new Set([...NATIVE_BUILD_FIXED_TOKENS, ...NATIVE_BUILD_FIXED_BRAND_TOKENS]);
+	const touched = [.../* @__PURE__ */ new Set([...Object.keys(n.tokens.light), ...Object.keys(n.tokens.dark)])].filter((name) => fixed.has(name));
+	if (touched.length > 0) notes.push(`${touched.map((name) => `--${name}`).join("・")} は、実機ではビルド時に固定されるクラス（bg-action など）に効きません（TS から色を引く部品には効きます）`);
+	if (Object.keys(n.semantic).length > 0) notes.push("セマンティックトークンの参照先の変更は、実機ではクラスに効きません（ビルド時にランプへ解決されるため）");
+	if (Object.keys(n.radius).length > 0) notes.push("角丸は、実機ではビルド時に固定されるので効きません");
+	if (n.font.bodySize !== void 0) notes.push("本文サイズは、実機ではビルド時に固定されるので効きません");
+	if (n.shadow !== "default") notes.push("影の preset は native には適用しません");
+	return notes;
+}
+
+//#endregion
+export { NATIVE_BUILD_FIXED_BRAND_TOKENS, NATIVE_BUILD_FIXED_TOKENS, firstFontFamily, nativeLimits, toNativeVariables };

package/dist/tuning/schema.d.ts

@@ -0,0 +1,69 @@
+import { Tuning, TuningCatalog } from "./types.js";
+import { z } from "zod";
+//#region src/tuning/schema.d.ts
+/** エクスポート・保存の形式の名前とバージョン。形を変えたら `VERSION` を上げる。 */
+export declare const FORMAT = "love3-tuning";
+export declare const VERSION = 1;
+/** 保存先（localStorage）のキー。 */
+export declare const STORAGE_KEY = "love3-preview:tuning";
+/**
+ * 形式の骨組み。**知らない項目は断る**（`strictObject`）。トークン名・色の中身など、DS に依存する検査は `parseTuning` が足す。
+ * 全部省略できる（既定との差分だけを書く）。
+ */
+declare const envelope: z.ZodObject<{
+  format: z.ZodLiteral<"love3-tuning">;
+  version: z.ZodLiteral<1>;
+  tokens: z.ZodOptional<z.ZodObject<{
+    light: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    dark: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  }, z.core.$strict>>;
+  radius: z.ZodOptional<z.ZodObject<{
+    control: z.ZodOptional<z.ZodNumber>;
+    surface: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strict>>;
+  semantic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  font: z.ZodOptional<z.ZodObject<{
+    geist: z.ZodOptional<z.ZodString>;
+    geistMono: z.ZodOptional<z.ZodString>;
+    jp: z.ZodOptional<z.ZodString>;
+    bodySize: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strict>>;
+  shadow: z.ZodOptional<z.ZodEnum<{
+    default: "default";
+    none: "none";
+    preset: "preset";
+  }>>;
+}, z.core.$strict>;
+type Envelope = z.output<typeof envelope>;
+/** 取り込む JSON の大きさの上限（バイト）。貼り付け・ファイルとも。 */
+export declare const MAX_IMPORT_BYTES: number;
+/** 1 つの表（`tokens.light` / `tokens.dark` / `semantic`）の項目数の上限。調整できる名前は 50 に満たない。 */
+export declare const MAX_ENTRIES = 200;
+/** 断る理由を、ここまで並べる（残りは「ほか N 件」）。 */
+export declare const MAX_REASONS = 20;
+/** 取り込もうとしている文字が、上限（`MAX_IMPORT_BYTES`）を超えるか。 */
+export declare function tooLarge(text: string): boolean;
+export declare const TOO_LARGE_REASON = "大きすぎます（256 KB まで）";
+export declare function fontProblem(value: string): string | undefined;
+export type ParseResult = {
+  ok: true;
+  tuning: Tuning;
+} | {
+  ok: false;
+  reasons: string[];
+};
+/**
+ * エクスポートの JSON（文字列）を読んで検証する。**1 つでも不正なら全体を断る（部分適用しない）**。
+ * 断る理由は、見つけたものを全部、項目の場所つきの日本語で返す。
+ *
+ * 断るもの: JSON として読めない・`format` / `version` が違う・知らない項目・未知のトークン名（`--名前`）・
+ * 不正な色・ライト・ダーク共通のトークン（ブランド色）のダークの指定・未知のセマンティックトークン・選べない参照先・
+ * 範囲外の角丸と本文サイズ・差し込めない書体。成功したら、既定と同じ項目を落とした形（`normalize`）で返す。
+ */
+export declare function parseTuning(text: string, catalog: TuningCatalog): ParseResult;
+/** 差分だけのエクスポート用オブジェクト（空の節は省く）。 */
+export declare function toExportObject(tuning: Tuning, catalog: TuningCatalog): Record<string, unknown>;
+/** エクスポート・保存の JSON（既定との差分だけ。整形つき）。 */
+export declare function toJson(tuning: Tuning, catalog: TuningCatalog): string;
+//#endregion
+export type { Envelope };