@lgtm-hq/turbo-themes 0.31.0 → 0.32.0

package/dist/adapters/tailwind/{colors-C59xB8zn.js → colors-Bz6MUnF4.js}

@@ -3,8 +3,8 @@
 var tokens = {
 	$schema: "https://design-tokens.org/schema.json",
 	$description: "Turbo Themes - Flat tokens for 27 themes",
-	$version: "0.31.0",
-	$generated: "198842d2a7520c69132dfc9b5e52842c0bb23445c6c0b70a72516c41726ffb58",
+	$version: "0.32.0",
+	$generated: "bc7967eb4d4221a64b2b156dfb9ca8a00be42bc3be06dc1e2d43368b1d8cd0ea",
 	meta: {
 		"themeIds": [
 			"bulma-dark",
@@ -181,13 +181,13 @@ function getTheme(id) {
 */
 var themeIds = /* @__PURE__ */ flavors.map((f) => f.id);
 [...new Set(flavors.map((f) => f.vendor))];
-flavors.map((f) => [f.id, f.label]);
-flavors.map((f) => [f.id, f.appearance]);
+//#endregion
+//#region ../../core/dist/themes/generated/metadata.js
 /**
 * Ordered list of vendor IDs controlling display order in dropdowns.
-* New vendors should be appended here.
+* Source: schema/tokens/_vendors.json
 */
-var VENDOR_ORDER = [
+var VENDOR_ORDER$1 = [
 	"catppuccin",
 	"dracula",
 	"gruvbox",
@@ -200,8 +200,15 @@ var VENDOR_ORDER = [
 	"one-dark",
 	"turbo"
 ];
+flavors.map((f) => [f.id, f.label]);
+flavors.map((f) => [f.id, f.appearance]);
+/**
+* Ordered list of vendor IDs controlling display order in dropdowns.
+* Generated from schema/tokens/_vendors.json — do not edit by hand.
+*/
+var VENDOR_ORDER = VENDOR_ORDER$1;
 var _missingFromOrder = Object.keys(packages).filter((id) => !VENDOR_ORDER.includes(id));
-if (_missingFromOrder.length > 0) console.warn(`[metadata] VENDOR_ORDER is missing vendor IDs present in packages: ${_missingFromOrder.join(", ")}. Append them to VENDOR_ORDER so their themes are included in VENDOR_GROUPS.`);
+if (_missingFromOrder.length > 0) console.warn(`[metadata] VENDOR_ORDER is missing vendor IDs present in packages: ${_missingFromOrder.join(", ")}. Append them to schema/tokens/_vendors.json and regenerate metadata.`);
 var VENDOR_GROUPS = /* @__PURE__ */ VENDOR_ORDER.filter((id) => id in packages).map((id) => {
 	const pkg = packages[id];
 	return {
@@ -449,4 +456,4 @@ function createThemeCssVariables(themeId) {
 //#endregion
 export { themeIds as a, getTheme as i, createThemeCssVariables as n, themesById as o, getAllThemeColors as r, createColorMappings as t };
 
-//# sourceMappingURL=colors-C59xB8zn.js.map
+//# sourceMappingURL=colors-Bz6MUnF4.js.map

package/dist/adapters/tailwind/colors.js

@@ -1,2 +1,2 @@
-import { n as createThemeCssVariables, r as getAllThemeColors, t as createColorMappings } from "./colors-C59xB8zn.js";
+import { n as createThemeCssVariables, r as getAllThemeColors, t as createColorMappings } from "./colors-Bz6MUnF4.js";
 export { createColorMappings, createThemeCssVariables, getAllThemeColors };

package/dist/adapters/tailwind/preset.js

@@ -1,4 +1,4 @@
-import { a as themeIds, i as getTheme, o as themesById, t as createColorMappings } from "./colors-C59xB8zn.js";
+import { a as themeIds, i as getTheme, o as themesById, t as createColorMappings } from "./colors-Bz6MUnF4.js";
 //#region preset.ts
 /**
 * Tailwind CSS preset for Turbo Themes

package/dist/tokens/style-dictionary/themes.json

@@ -1,8 +1,8 @@
 {
   "$schema": "https://design-tokens.org/schema.json",
   "$description": "Turbo Themes - Design tokens for 27 themes",
-  "$version": "0.31.0",
-  "$generated": "c49ad6dfccbeac0986065363d20922d6b4aea60499fd96b6548379a76b57439e",
+  "$version": "0.32.0",
+  "$generated": "4ce70bff7096b0a99deb989139e9f1a9789eeaa2b3f9258d358f2161dd4b0b8b",
   "meta": {
     "themeIds": [
       "bulma-dark",

package/dist/tokens/style-dictionary/tokens.json

@@ -1,8 +1,8 @@
 {
   "$schema": "https://design-tokens.org/schema.json",
   "$description": "Turbo Themes - Flat tokens for 27 themes",
-  "$version": "0.31.0",
-  "$generated": "198842d2a7520c69132dfc9b5e52842c0bb23445c6c0b70a72516c41726ffb58",
+  "$version": "0.32.0",
+  "$generated": "bc7967eb4d4221a64b2b156dfb9ca8a00be42bc3be06dc1e2d43368b1d8cd0ea",
   "meta": {
     "themeIds": [
       "bulma-dark",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lgtm-hq/turbo-themes",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "description": "Universal theme packs and an accessible theme selector.",
   "license": "MIT",
   "type": "module",
@@ -92,6 +92,10 @@
     "./adapters/bulma.css": {
       "types": "./packages/adapters/bulma/dist/bulma-adapter.css.d.ts",
       "default": "./packages/adapters/bulma/dist/bulma-adapter.css"
+    },
+    "./adapters/home-assistant": {
+      "types": "./packages/adapters/home-assistant/dist/index.d.ts",
+      "import": "./packages/adapters/home-assistant/dist/index.js"
     }
   },
   "types": "./dist/index.d.ts",
@@ -110,14 +114,14 @@
   ],
   "scripts": {
     "build": "bun run build:tokens && bun run build:packages && bun run theme:sync && bun run build:root && node scripts/copy-adapters.mjs && bun run generate:css",
-    "build:tokens": "node scripts/codegen/validate-schema.mjs && node scripts/prepare-style-dictionary.mjs && node scripts/codegen/generate-catalog.mjs && node scripts/build-style-dictionary.mjs && bun run build:tokens:copy",
+    "build:tokens": "bun scripts/codegen/validate-schema.mjs && bun scripts/prepare-style-dictionary.mjs && bun scripts/codegen/generate-metadata.mjs && bun scripts/codegen/generate-catalog.mjs && bun scripts/build-style-dictionary.mjs && bun run build:tokens:copy",
     "build:tokens:copy": "cp dist/tokens/style-dictionary/tokens.json packages/core/src/themes/tokens.json && cp dist/tokens/style-dictionary/tokens.json python/src/turbo_themes/tokens.json && cp dist/tokens/style-dictionary/tokens.json swift/Sources/TurboThemes/Resources/tokens.json",
-    "build:sd": "node scripts/prepare-style-dictionary.mjs && node scripts/codegen/generate-catalog.mjs && node scripts/build-style-dictionary.mjs",
+    "build:sd": "bun scripts/prepare-style-dictionary.mjs && bun scripts/codegen/generate-metadata.mjs && bun scripts/codegen/generate-catalog.mjs && bun scripts/build-style-dictionary.mjs",
     "build:packages": "bun run build:core && bun run build:selector && bun run build:css-pkg && bun run build:adapters",
     "build:core": "cd packages/core && bun run build",
     "build:selector": "cd packages/theme-selector && bun run build",
     "build:css-pkg": "cd packages/css && bun run build",
-    "build:adapters": "cd packages/adapters/tailwind && bun run build && cd ../bulma && bun run build",
+    "build:adapters": "cd packages/adapters/tailwind && bun run build && cd ../bulma && bun run build && cd ../home-assistant && bun run build",
     "build:root": "tsc -p tsconfig.json",
     "generate:all": "bun run build:tokens && bun run generate:types",
     "generate:css": "cd packages/css && bun run build:css && cd ../.. && bun run generate:css-dts",
@@ -177,7 +181,9 @@
     "prepare": "husky || true",
     "prepublishOnly": "bun run build && bun run build:themes && bun run test",
     "build:tokens:css": "bun run build:tokens",
-    "build:tokens:python": "bun run build:tokens"
+    "build:tokens:python": "bun run build:tokens",
+    "generate:metadata": "bun scripts/codegen/generate-metadata.mjs",
+    "check:generated": "./scripts/ci/verify-generated-tokens.sh"
   },
   "lint-staged": {
     "*.{js,jsx,ts,tsx,mjs,cjs,json,md,yml,yaml,css,html}": [
@@ -194,6 +200,7 @@
     "@primer/primitives": "11.7.1",
     "@rose-pine/palette": "4.0.1",
     "@testing-library/react": "16.3.2",
+    "@types/js-yaml": "4.0.9",
     "@types/react": "19.2.14",
     "@types/react-dom": "19.2.3",
     "@vitest/coverage-v8": "4.1.5",
@@ -205,6 +212,7 @@
     "happy-dom": "20.9.0",
     "http-server": "14.1.1",
     "husky": "9.1.7",
+    "js-yaml": "4.2.0",
     "lightningcss": "1.32.0",
     "lint-staged": "16.4.0",
     "oxfmt": "0.48.0",

package/packages/adapters/home-assistant/dist/index.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Home Assistant theme adapter for Turbo Themes.
+ *
+ * Emits a single Home Assistant `themes.yaml`-compatible YAML string that maps
+ * Turbo theme tokens onto Home Assistant frontend theme variables. Every value is
+ * a concrete hex color or `R, G, B` triplet, so the artifact is self-contained.
+ *
+ * @packageDocumentation
+ */
+
+import { ThemeTokens } from '../../../core/dist/index.js/themes/types';
+
+/**
+ * Validate every pairing, throwing on the first problem.
+ *
+ * @param pairings - Pairings to validate (defaults to {@link AUTO_THEME_PAIRINGS}).
+ * @throws If any pairing is invalid; see {@link resolveAutoTheme}.
+ */
+export declare function assertPairingsValid(pairings?: readonly AutoThemePairing[]): void;
+
+/** Dark/light flavor pairings, one per vendor family, emitted as auto themes. */
+export declare const AUTO_THEME_PAIRINGS: readonly AutoThemePairing[];
+
+/** A dark/light pairing that becomes a single Home Assistant auto theme. */
+export declare interface AutoThemePairing {
+    /** Human-readable Home Assistant theme name, e.g. `"Catppuccin (Auto)"`. */
+    readonly name: string;
+    /** Registry id of the dark flavor (also used for the flat top-level keys). */
+    readonly dark: string;
+    /** Registry id of the light flavor. */
+    readonly light: string;
+}
+
+/**
+ * Fixed card-mod hook value. This is an inert marker unless the optional
+ * `card-mod` custom component is installed; it never affects core Home Assistant.
+ */
+export declare const CARD_MOD_THEME = "turbo-themes";
+
+/**
+ * YAML emitter for the Home Assistant adapter.
+ *
+ * Hand-rolls a deterministic Home Assistant `themes.yaml` document from the Turbo
+ * theme registry. js-yaml is intentionally not used at runtime so the adapter has
+ * no serialization dependency; tests parse the output with js-yaml to validate it.
+ */
+/**
+ * Generate the Home Assistant themes YAML document.
+ *
+ * Flat themes are emitted first, sorted alphabetically by theme id for
+ * determinism, followed by the auto (dark/light paired) themes in
+ * {@link AUTO_THEME_PAIRINGS} order.
+ *
+ * @returns The full YAML document as a string.
+ * @throws If any auto-theme pairing is invalid (see {@link assertPairingsValid}).
+ */
+export declare function generateHomeAssistantThemes(): string;
+
+/**
+ * Color helpers for the Home Assistant adapter.
+ *
+ * Home Assistant expects some frontend variables (the `rgb-*` family) to be a
+ * bare `"R, G, B"` triplet rather than a `rgb()`/hex value, because it composes
+ * them into `rgba(var(--rgb-primary-color), 0.5)` style expressions internally.
+ */
+/**
+ * Parse a `#rgb` or `#rrggbb` hex string into its red/green/blue components.
+ *
+ * @param hex - Hex color string, with a leading `#`.
+ * @returns The `[r, g, b]` channel values (0-255).
+ * @throws If the input is not a valid 3- or 6-digit hex color.
+ */
+export declare function hexToRgb(hex: string): [number, number, number];
+
+/**
+ * Convert a hex color to a bare `"R, G, B"` triplet string (no `rgb()` wrapper).
+ *
+ * @param hex - Hex color string, with a leading `#`.
+ * @returns The comma-separated triplet, e.g. `"137, 180, 250"`.
+ * @throws If the input is not a valid 3- or 6-digit hex color.
+ */
+export declare function hexToRgbTriplet(hex: string): string;
+
+/**
+ * Map a single theme's tokens onto Home Assistant frontend variables.
+ *
+ * All color values are concrete hex strings (no CSS `var()` references), and the
+ * `rgb-*` family is emitted as bare `"R, G, B"` triplets as Home Assistant expects.
+ *
+ * @param tokens - The platform-agnostic Turbo theme tokens.
+ * @returns A record of Home Assistant variable name → value, ordered to match
+ *   {@link REQUIRED_KEYS}.
+ */
+export declare function mapTokensToHomeAssistant(tokens: ThemeTokens): Record<string, string>;
+
+/**
+ * Every Home Assistant variable key emitted per theme, in deterministic order.
+ *
+ * The emitter walks this list to serialize each theme, and
+ * {@link mapTokensToHomeAssistant} produces a record whose keys match this list
+ * exactly (verified in tests).
+ */
+export declare const REQUIRED_KEYS: readonly string[];
+
+/**
+ * Resolve a pairing to its concrete dark/light tokens, validating as it goes.
+ *
+ * @param pairing - The pairing to resolve.
+ * @returns The pairing name plus the resolved dark and light token sets.
+ * @throws If either id is missing from the registry, or an id's appearance does
+ *   not match the slot it occupies (dark slot must be dark, light slot light).
+ */
+export declare function resolveAutoTheme(pairing: AutoThemePairing): ResolvedAutoTheme;
+
+/** A pairing whose dark/light flavors have been resolved to concrete tokens. */
+export declare interface ResolvedAutoTheme {
+    readonly name: string;
+    readonly darkTokens: ThemeTokens;
+    readonly lightTokens: ThemeTokens;
+}
+
+export { }