@lgtm-hq/turbo-themes 0.31.1 → 0.32.0

package/dist/adapters/tailwind/{colors-DqaAtzaI.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.1",
-	$generated: "bd0d207423eeb729df7a9e1be1fdd01821b2fa02b214ee1df6f0dd1440aef300",
+	$version: "0.32.0",
+	$generated: "bc7967eb4d4221a64b2b156dfb9ca8a00be42bc3be06dc1e2d43368b1d8cd0ea",
 	meta: {
 		"themeIds": [
 			"bulma-dark",
@@ -456,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-DqaAtzaI.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-DqaAtzaI.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-DqaAtzaI.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.1",
-  "$generated": "11eac89550fb538f6e88ec4c02f22b744acba351f1ead37db2757786fefb5c66",
+  "$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.1",
-  "$generated": "bd0d207423eeb729df7a9e1be1fdd01821b2fa02b214ee1df6f0dd1440aef300",
+  "$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.1",
+  "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",
@@ -117,7 +121,7 @@
     "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",
@@ -196,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",
@@ -207,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 { }