@lgtm-hq/turbo-themes 0.27.0 → 0.28.0

package/dist/adapters/tailwind/{colors-BI7jSURT.js → colors-CrjfMYUV.js}

@@ -1,23 +1,9 @@
 //#endregion
 //#region ../../core/dist/tokens/index.js
-/**
-* Platform-agnostic design tokens export
-*
-* This module exports pure theme data (colors, typography, etc.) without
-* any DOM, CSS, or platform-specific code. Use this for:
-*
-* - React Native apps
-* - Flutter apps (via JSON export)
-* - iOS/Android native apps
-* - Any platform that needs theme colors
-*
-* For web apps, you can also import the CSS files directly:
-* import '@lgtm-hq/turbo-themes/css/catppuccin-mocha.css'
-*/
 var tokens = {
 	$schema: "https://design-tokens.org/schema.json",
 	$description: "Turbo Themes - Flat tokens for 27 themes",
-	$version: "0.27.0",
+	$version: "0.28.0",
 	$generated: "97d2eb2a06c98ae3fe744ed4e8a81843f9973a7673916438b57f0ac72d478295",
 	meta: {
 		"themeIds": [
@@ -216,6 +202,14 @@ var VENDOR_ORDER = [
 ];
 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.`);
+var VENDOR_GROUPS = /* @__PURE__ */ VENDOR_ORDER.filter((id) => id in packages).map((id) => {
+	const pkg = packages[id];
+	return {
+		id,
+		displayName: pkg.name.replace(/\s*\(synced\)\s*/i, ""),
+		themeIds: pkg.flavors.flatMap((f) => f ? [f.id] : [])
+	};
+});
 /** O(1) flavor lookup by ID, built once at module evaluation time. */
 var flavorById = /* @__PURE__ */ new Map(flavors.map((f) => [f.id, f]));
 /** Cache for computed short labels. */
@@ -255,6 +249,88 @@ function getShortLabel(themeId) {
 }
 flavors.map((f) => [f.id, getShortLabel(f.id)]);
 //#endregion
+//#region ../../core/dist/catalog/index.js
+/**
+* Consumer theme curation API.
+*
+* `createThemeCatalog()` provides a single, composable surface for selecting a
+* subset of themes. It composes with the existing `flavors` (tokens) and
+* `VENDOR_GROUPS` (metadata) so consumers no longer need to hand-slice arrays.
+*
+* Filter precedence:
+*   all themes -> vendors/appearances -> include -> exclude
+*
+* Invalid IDs supplied to `include`/`exclude` warn in development (never
+* throw), so a typo cannot silently drop or duplicate a theme.
+*/
+var KNOWN_THEME_IDS = new Set(themeIds);
+/**
+* Emit a dev-time warning for unknown IDs. Bundlers replace
+* `process.env.NODE_ENV` with the literal `"production"` and eliminate this
+* branch via dead-code removal, so production builds never log.
+*/
+function warnInvalidIds(source, ids) {
+	if (ids.length === 0) return;
+	if (process.env.NODE_ENV === "production") return;
+	console.warn(`[catalog] createThemeCatalog: ignoring unknown ${source} theme ID(s): ${ids.join(", ")}. Valid IDs come from the exported \`themeIds\`.`);
+}
+/**
+* Build a curated {@link ThemeCatalog} from the full theme set.
+*
+* @param options - Vendor/appearance filters plus explicit include/exclude IDs.
+* @returns A catalog exposing `themeIds`, `flavors`, and `vendorGroups`.
+*/
+function createThemeCatalog(options = {}) {
+	const { vendors, appearances, include = [], exclude = [] } = options;
+	const selected = /* @__PURE__ */ new Set();
+	for (const flavor of flavors) {
+		if (vendors !== void 0 && !vendors.includes(flavor.vendor)) continue;
+		if (appearances !== void 0 && !appearances.includes(flavor.appearance)) continue;
+		selected.add(flavor.id);
+	}
+	const invalidInclude = [];
+	for (const id of include) if (KNOWN_THEME_IDS.has(id)) selected.add(id);
+	else invalidInclude.push(id);
+	warnInvalidIds("include", invalidInclude);
+	const invalidExclude = [];
+	for (const id of exclude) if (KNOWN_THEME_IDS.has(id)) selected.delete(id);
+	else invalidExclude.push(id);
+	warnInvalidIds("exclude", invalidExclude);
+	const selectedFlavors = flavors.filter((flavor) => selected.has(flavor.id));
+	return {
+		themeIds: selectedFlavors.map((flavor) => flavor.id),
+		flavors: selectedFlavors,
+		vendorGroups: VENDOR_GROUPS.map((group) => ({
+			...group,
+			themeIds: group.themeIds.filter((id) => selected.has(id))
+		})).filter((group) => group.themeIds.length > 0)
+	};
+}
+//#endregion
+//#region ../../core/dist/catalog/sets.js
+/**
+* Named theme presets built on top of {@link createThemeCatalog}.
+*
+* These provide opinionated defaults so consumers don't rebuild the same
+* "minimal" or "dark-only" lists in every app. Per-vendor sets are derived
+* from the `packages` keys, so new vendor variants appear automatically on
+* upgrade for opted-in vendors.
+*/
+/**
+* The curated "minimal" starter set: one light + one dark theme from the two
+* most common vendors.
+*/
+var MINIMAL_THEME_IDS = [
+	"catppuccin-mocha",
+	"catppuccin-latte",
+	"github-light",
+	"github-dark"
+];
+({ ...Object.fromEntries(Object.keys(packages).map((vendor) => [vendor, createThemeCatalog({ vendors: [vendor] })])) }), createThemeCatalog({
+	vendors: [],
+	include: MINIMAL_THEME_IDS
+}), createThemeCatalog({ appearances: ["dark"] }), createThemeCatalog({ appearances: ["light"] });
+//#endregion
 //#region colors.ts
 /**
 * Color mappings for Tailwind preset
@@ -372,4 +448,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-BI7jSURT.js.map
+//# sourceMappingURL=colors-CrjfMYUV.js.map

package/dist/adapters/tailwind/colors.js

@@ -1,2 +1,2 @@
-import { n as createThemeCssVariables, r as getAllThemeColors, t as createColorMappings } from "./colors-BI7jSURT.js";
+import { n as createThemeCssVariables, r as getAllThemeColors, t as createColorMappings } from "./colors-CrjfMYUV.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-BI7jSURT.js";
+import { a as themeIds, i as getTheme, o as themesById, t as createColorMappings } from "./colors-CrjfMYUV.js";
 //#region preset.ts
 /**
 * Tailwind CSS preset for Turbo Themes

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

@@ -1,7 +1,7 @@
 {
   "$schema": "https://design-tokens.org/schema.json",
   "$description": "Turbo Themes - Design tokens for 27 themes",
-  "$version": "0.27.0",
+  "$version": "0.28.0",
   "$generated": "956991011f323f365ba1cba0836b8fe9d8ba2f3d4d1196e630a2258df2cfbd84",
   "meta": {
     "themeIds": [

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

@@ -1,7 +1,7 @@
 {
   "$schema": "https://design-tokens.org/schema.json",
   "$description": "Turbo Themes - Flat tokens for 27 themes",
-  "$version": "0.27.0",
+  "$version": "0.28.0",
   "$generated": "97d2eb2a06c98ae3fe744ed4e8a81843f9973a7673916438b57f0ac72d478295",
   "meta": {
     "themeIds": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lgtm-hq/turbo-themes",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "Universal theme packs and an accessible theme selector.",
   "license": "MIT",
   "type": "module",
@@ -118,7 +118,7 @@
     "generate:css": "cd packages/css && bun run build:css && cd ../.. && bun run generate:css-dts",
     "generate:css-dts": "node scripts/generate-css-dts.mjs",
     "generate:types": "node scripts/codegen/generate-types.mjs --all",
-    "generate:types:ts": "node scripts/codegen/generate-ts-types.mjs",
+    "generate:types:ts": "node scripts/codegen/generate-ts-types.mjs && node scripts/codegen/generate-theme-ids.mjs",
     "generate:types:python": "node scripts/codegen/generate-python-types.mjs",
     "generate:types:swift": "node scripts/codegen/generate-swift-types.mjs",
     "generate:python": "bun run build:tokens && bun run generate:types:python",

package/packages/adapters/tailwind/dist/{colors-BI7jSURT.js → colors-CrjfMYUV.js}

@@ -1,23 +1,9 @@
 //#endregion
 //#region ../../core/dist/tokens/index.js
-/**
-* Platform-agnostic design tokens export
-*
-* This module exports pure theme data (colors, typography, etc.) without
-* any DOM, CSS, or platform-specific code. Use this for:
-*
-* - React Native apps
-* - Flutter apps (via JSON export)
-* - iOS/Android native apps
-* - Any platform that needs theme colors
-*
-* For web apps, you can also import the CSS files directly:
-* import '@lgtm-hq/turbo-themes/css/catppuccin-mocha.css'
-*/
 var tokens = {
 	$schema: "https://design-tokens.org/schema.json",
 	$description: "Turbo Themes - Flat tokens for 27 themes",
-	$version: "0.27.0",
+	$version: "0.28.0",
 	$generated: "97d2eb2a06c98ae3fe744ed4e8a81843f9973a7673916438b57f0ac72d478295",
 	meta: {
 		"themeIds": [
@@ -216,6 +202,14 @@ var VENDOR_ORDER = [
 ];
 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.`);
+var VENDOR_GROUPS = /* @__PURE__ */ VENDOR_ORDER.filter((id) => id in packages).map((id) => {
+	const pkg = packages[id];
+	return {
+		id,
+		displayName: pkg.name.replace(/\s*\(synced\)\s*/i, ""),
+		themeIds: pkg.flavors.flatMap((f) => f ? [f.id] : [])
+	};
+});
 /** O(1) flavor lookup by ID, built once at module evaluation time. */
 var flavorById = /* @__PURE__ */ new Map(flavors.map((f) => [f.id, f]));
 /** Cache for computed short labels. */
@@ -255,6 +249,88 @@ function getShortLabel(themeId) {
 }
 flavors.map((f) => [f.id, getShortLabel(f.id)]);
 //#endregion
+//#region ../../core/dist/catalog/index.js
+/**
+* Consumer theme curation API.
+*
+* `createThemeCatalog()` provides a single, composable surface for selecting a
+* subset of themes. It composes with the existing `flavors` (tokens) and
+* `VENDOR_GROUPS` (metadata) so consumers no longer need to hand-slice arrays.
+*
+* Filter precedence:
+*   all themes -> vendors/appearances -> include -> exclude
+*
+* Invalid IDs supplied to `include`/`exclude` warn in development (never
+* throw), so a typo cannot silently drop or duplicate a theme.
+*/
+var KNOWN_THEME_IDS = new Set(themeIds);
+/**
+* Emit a dev-time warning for unknown IDs. Bundlers replace
+* `process.env.NODE_ENV` with the literal `"production"` and eliminate this
+* branch via dead-code removal, so production builds never log.
+*/
+function warnInvalidIds(source, ids) {
+	if (ids.length === 0) return;
+	if (process.env.NODE_ENV === "production") return;
+	console.warn(`[catalog] createThemeCatalog: ignoring unknown ${source} theme ID(s): ${ids.join(", ")}. Valid IDs come from the exported \`themeIds\`.`);
+}
+/**
+* Build a curated {@link ThemeCatalog} from the full theme set.
+*
+* @param options - Vendor/appearance filters plus explicit include/exclude IDs.
+* @returns A catalog exposing `themeIds`, `flavors`, and `vendorGroups`.
+*/
+function createThemeCatalog(options = {}) {
+	const { vendors, appearances, include = [], exclude = [] } = options;
+	const selected = /* @__PURE__ */ new Set();
+	for (const flavor of flavors) {
+		if (vendors !== void 0 && !vendors.includes(flavor.vendor)) continue;
+		if (appearances !== void 0 && !appearances.includes(flavor.appearance)) continue;
+		selected.add(flavor.id);
+	}
+	const invalidInclude = [];
+	for (const id of include) if (KNOWN_THEME_IDS.has(id)) selected.add(id);
+	else invalidInclude.push(id);
+	warnInvalidIds("include", invalidInclude);
+	const invalidExclude = [];
+	for (const id of exclude) if (KNOWN_THEME_IDS.has(id)) selected.delete(id);
+	else invalidExclude.push(id);
+	warnInvalidIds("exclude", invalidExclude);
+	const selectedFlavors = flavors.filter((flavor) => selected.has(flavor.id));
+	return {
+		themeIds: selectedFlavors.map((flavor) => flavor.id),
+		flavors: selectedFlavors,
+		vendorGroups: VENDOR_GROUPS.map((group) => ({
+			...group,
+			themeIds: group.themeIds.filter((id) => selected.has(id))
+		})).filter((group) => group.themeIds.length > 0)
+	};
+}
+//#endregion
+//#region ../../core/dist/catalog/sets.js
+/**
+* Named theme presets built on top of {@link createThemeCatalog}.
+*
+* These provide opinionated defaults so consumers don't rebuild the same
+* "minimal" or "dark-only" lists in every app. Per-vendor sets are derived
+* from the `packages` keys, so new vendor variants appear automatically on
+* upgrade for opted-in vendors.
+*/
+/**
+* The curated "minimal" starter set: one light + one dark theme from the two
+* most common vendors.
+*/
+var MINIMAL_THEME_IDS = [
+	"catppuccin-mocha",
+	"catppuccin-latte",
+	"github-light",
+	"github-dark"
+];
+({ ...Object.fromEntries(Object.keys(packages).map((vendor) => [vendor, createThemeCatalog({ vendors: [vendor] })])) }), createThemeCatalog({
+	vendors: [],
+	include: MINIMAL_THEME_IDS
+}), createThemeCatalog({ appearances: ["dark"] }), createThemeCatalog({ appearances: ["light"] });
+//#endregion
 //#region colors.ts
 /**
 * Color mappings for Tailwind preset
@@ -372,4 +448,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-BI7jSURT.js.map
+//# sourceMappingURL=colors-CrjfMYUV.js.map