@hex-core/themes 0.1.1 → 0.2.1

package/dist/index.d.ts

@@ -1,59 +1,221 @@
-import { Theme } from '@hex-core/registry';
+import { ThemeCategory, Theme } from '@hex-core/registry';
 export { emberTheme, midnightTheme } from '@hex-core/tokens';
+export { loadThemeBrief, presetSlugs, presetsByCategory, voltagentPresets } from './presets/index.js';
+export { airbnbTheme } from './presets/airbnb.js';
+export { airtableTheme } from './presets/airtable.js';
+export { appleTheme } from './presets/apple.js';
+export { binanceTheme } from './presets/binance.js';
+export { bmwMTheme } from './presets/bmw-m.js';
+export { bmwTheme } from './presets/bmw.js';
+export { bugattiTheme } from './presets/bugatti.js';
+export { calTheme } from './presets/cal.js';
+export { claudeTheme } from './presets/claude.js';
+export { clayTheme } from './presets/clay.js';
+export { clickhouseTheme } from './presets/clickhouse.js';
+export { cohereTheme } from './presets/cohere.js';
+export { coinbaseTheme } from './presets/coinbase.js';
+export { composioTheme } from './presets/composio.js';
+export { cursorTheme } from './presets/cursor.js';
+export { elevenlabsTheme } from './presets/elevenlabs.js';
+export { expoTheme } from './presets/expo.js';
+export { ferrariTheme } from './presets/ferrari.js';
+export { figmaTheme } from './presets/figma.js';
+export { framerTheme } from './presets/framer.js';
+export { hashicorpTheme } from './presets/hashicorp.js';
+export { ibmTheme } from './presets/ibm.js';
+export { intercomTheme } from './presets/intercom.js';
+export { krakenTheme } from './presets/kraken.js';
+export { lamborghiniTheme } from './presets/lamborghini.js';
+export { linearTheme } from './presets/linear.js';
+export { lovableTheme } from './presets/lovable.js';
+export { mastercardTheme } from './presets/mastercard.js';
+export { metaTheme } from './presets/meta.js';
+export { minimaxTheme } from './presets/minimax.js';
+export { mintlifyTheme } from './presets/mintlify.js';
+export { miroTheme } from './presets/miro.js';
+export { mistralTheme } from './presets/mistral.js';
+export { mongodbTheme } from './presets/mongodb.js';
+export { nikeTheme } from './presets/nike.js';
+export { notionTheme } from './presets/notion.js';
+export { nvidiaTheme } from './presets/nvidia.js';
+export { ollamaTheme } from './presets/ollama.js';
+export { opencodeTheme } from './presets/opencode.js';
+export { pinterestTheme } from './presets/pinterest.js';
+export { playstationTheme } from './presets/playstation.js';
+export { posthogTheme } from './presets/posthog.js';
+export { raycastTheme } from './presets/raycast.js';
+export { renaultTheme } from './presets/renault.js';
+export { replicateTheme } from './presets/replicate.js';
+export { resendTheme } from './presets/resend.js';
+export { revolutTheme } from './presets/revolut.js';
+export { runwaymlTheme } from './presets/runwayml.js';
+export { sanityTheme } from './presets/sanity.js';
+export { sentryTheme } from './presets/sentry.js';
+export { shopifyTheme } from './presets/shopify.js';
+export { slackTheme } from './presets/slack.js';
+export { spacexTheme } from './presets/spacex.js';
+export { spotifyTheme } from './presets/spotify.js';
+export { starbucksTheme } from './presets/starbucks.js';
+export { stripeTheme } from './presets/stripe.js';
+export { supabaseTheme } from './presets/supabase.js';
+export { superhumanTheme } from './presets/superhuman.js';
+export { teslaTheme } from './presets/tesla.js';
+export { thevergeTheme } from './presets/theverge.js';
+export { togetherTheme } from './presets/together.js';
+export { uberTheme } from './presets/uber.js';
+export { vercelTheme } from './presets/vercel.js';
+export { vodafoneTheme } from './presets/vodafone.js';
+export { voltagentTheme } from './presets/voltagent.js';
+export { warpTheme } from './presets/warp.js';
+export { webflowTheme } from './presets/webflow.js';
+export { wiredTheme } from './presets/wired.js';
+export { wiseTheme } from './presets/wise.js';
+export { xTheme } from './presets/x.js';
+export { zapierTheme } from './presets/zapier.js';
 
 /**
- * @hex-core/themes — premium theme catalog and convenience re-exports.
+ * @hex-core/themes — premium theme catalog and brand-derived presets.
  *
  * This package establishes a separate publish/version surface for theme
  * presets so the bundled `@hex-core/tokens` package can stay focused on the
  * single canonical default theme + the transformer functions.
  *
- * Today: re-exports `midnightTheme` and `emberTheme` from `@hex-core/tokens`
- * so consumers have a single import location for "the catalog of themes",
- * and adds a `listPremiumThemes()` helper. Future premium themes
- * (`fintech-dark`, `editorial-warm`, `data-dense`, `pastel-soft`,
- * `monochrome-strict`) will land here directly without bumping `tokens`.
- *
- * The default theme remains in `@hex-core/tokens` since it is the canonical
- * baseline that the transformers (themeToCss, themeToScopedRuntimeCss,
- * themeToFlatJson, themeToTailwindConfig, generateGlobalsCss) operate on.
+ * Catalog:
+ *   - `midnight`, `ember` — first-party premium themes (re-exports from `@hex-core/tokens`)
+ *   - `voltagent` brand presets — 71 brand-inspired themes (Tesla, Stripe, Linear, …)
+ *     auto-generated from the MIT-licensed voltagent/awesome-design-md briefs
  *
  * @example
  * ```ts
- * import { midnightTheme, emberTheme, listPremiumThemes } from "@hex-core/themes";
+ * import { teslaTheme, listPremiumThemes, extendTheme, searchThemes } from "@hex-core/themes";
  * import { themeToScopedRuntimeCss } from "@hex-core/tokens";
  *
- * const css = themeToScopedRuntimeCss(midnightTheme, { mode: "dark" });
- * console.log(listPremiumThemes().map(t => t.name));
+ * const css = themeToScopedRuntimeCss(teslaTheme, { mode: "dark" });
+ *
+ * const myTesla = extendTheme(teslaTheme, {
+ *   name: "my-tesla",
+ *   tokens: { light: { primary: { value: "0 100% 50%", type: "color" } } },
+ * });
+ *
+ * const fintech = searchThemes({ category: "fintech" });
  * ```
  */
 
 /**
- * The full set of premium themes shipped by this package, keyed by name.
- * Future premium themes added here are picked up automatically by
- * {@link listPremiumThemes} and {@link getPremiumTheme}.
+ * The full set of themes shipped by this package, keyed by slug. Includes:
+ *   - First-party premium themes: `midnight`, `ember`
+ *   - 71 voltagent brand-derived presets (e.g. `tesla`, `stripe`, `linear`)
+ *
+ * Studio's theme picker iterates this map directly, so every entry shows up
+ * automatically without barrel-side wiring.
  */
 declare const premiumThemes: Record<string, Theme>;
 /**
- * Retrieve a premium theme by name.
+ * Retrieve a premium theme by slug.
  *
- * @param name - The theme identifier (e.g. `"midnight"`, `"ember"`).
- * @returns The matching Theme object, or `undefined` if the name is unknown.
+ * @param name - Theme slug (e.g. `"midnight"`, `"tesla"`, `"stripe"`).
+ * @returns The matching Theme object, or `undefined` if the slug is unknown.
  */
 declare function getPremiumTheme(name: string): Theme | undefined;
 /**
- * List metadata for every premium theme in the catalog.
+ * List metadata for every theme in the catalog.
  *
  * Mirrors the shape of `listThemes()` from `@hex-core/tokens` so studios and
  * theme switchers can drive both catalogs through the same UI without
  * adapter code.
  *
- * @returns Array of `{ name, displayName, description }` summaries.
+ * @returns Array of `{ name, displayName, description, category?, tags?, brand? }` summaries.
  */
 declare function listPremiumThemes(): Array<{
     name: string;
     displayName: string;
     description: string;
+    category?: ThemeCategory;
+    tags?: string[];
+    brand?: string;
 }>;
+/** Filter input for {@link searchThemes}. */
+interface SearchThemesInput {
+    /** Case-insensitive substring match against `name` / `displayName` / `description`. */
+    query?: string;
+    /** Restrict to a single category. */
+    category?: ThemeCategory;
+    /** All listed tags must be present (intersection match). */
+    tags?: string[];
+}
+/**
+ * Search the full preset catalog by category, tags, or free-text query.
+ * The 71 voltagent presets each carry `category` and `tags`; the
+ * first-party `midnight` / `ember` themes don't (they pre-date the
+ * metadata extension), so they only match via the `query` filter.
+ *
+ * @param input - Filter criteria; combine for AND semantics.
+ * @returns Matching themes, in catalog order.
+ */
+declare function searchThemes(input?: SearchThemesInput): Theme[];
+/**
+ * Override input for {@link extendTheme}. Token sets accept partial
+ * objects (token slots merge); scalar fields replace the base value
+ * when present. `attribution` is full-replacement (not merged) — a
+ * consumer rebranding a preset under their own license / URL almost
+ * always wants their attribution to fully replace the upstream's.
+ * Pass `attribution: undefined` to remove attribution entirely.
+ */
+interface ThemeOverrides {
+    name?: string;
+    displayName?: string;
+    description?: string;
+    brand?: string;
+    category?: Theme["category"];
+    tags?: string[];
+    designBrief?: string;
+    attribution?: Theme["attribution"];
+    /**
+     * Per-mode token overrides — token slot keys are an open record
+     * (the schema's `tokenSetSchema` uses a catchall), so any subset
+     * of slots is valid. Slots not listed fall through from the base.
+     */
+    tokens?: {
+        light?: Theme["tokens"]["light"];
+        dark?: Theme["tokens"]["dark"];
+    };
+}
+/**
+ * Compose a custom theme by overlaying overrides on a base preset.
+ *
+ * Token sets are merged at the slot level: missing slots fall through
+ * from the base; overridden slots replace the entire `{ value, type }`
+ * record. Scalar fields replace the base when present (including
+ * `tags: []` which clears the inherited tag list — explicit empty is
+ * intentional, not surprising).
+ *
+ * `attribution` is FULL-REPLACEMENT (not deep-merged) — a consumer
+ * republishing a preset under their own license / brand wants their
+ * attribution to land cleanly without the upstream's `brand` /
+ * `source` / `url` leaking through. Spread base.attribution yourself
+ * if you actually want partial merge.
+ *
+ * The composed theme is re-validated via `strictThemeSchema` before
+ * return, so consumers can't accidentally produce an under-spec'd
+ * Theme.
+ *
+ * @example
+ * ```ts
+ * const myTesla = extendTheme(teslaTheme, {
+ *   name: "my-tesla",
+ *   displayName: "My Tesla",
+ *   tokens: {
+ *     light: { primary: { value: "0 100% 50%", type: "color" } },
+ *   },
+ * });
+ * ```
+ *
+ * @param base - The starting theme (any preset or first-party theme)
+ * @param overrides - Partial theme; only specified fields override
+ * @returns A new validated Theme that's safe to feed to any transformer
+ */
+declare function extendTheme(base: Theme, overrides?: ThemeOverrides): Theme;
+/** All preset slugs known to this package, including first-party themes. */
+declare const allThemeSlugs: readonly string[];
 
-export { getPremiumTheme, listPremiumThemes, premiumThemes };
+export { type SearchThemesInput, type ThemeOverrides, allThemeSlugs, extendTheme, getPremiumTheme, listPremiumThemes, premiumThemes, searchThemes };

package/dist/index.js

@@ -1,8 +1,230 @@
+import {
+  loadThemeBrief,
+  presetSlugs,
+  presetsByCategory,
+  voltagentPresets
+} from "./chunk-EV4APPVD.js";
+import {
+  vodafoneTheme
+} from "./chunk-EZFP45CP.js";
+import {
+  voltagentTheme
+} from "./chunk-4QXKFLEQ.js";
+import {
+  warpTheme
+} from "./chunk-GAQ6LS55.js";
+import {
+  webflowTheme
+} from "./chunk-DLLP5KXF.js";
+import {
+  wiredTheme
+} from "./chunk-2LU3ENLP.js";
+import {
+  wiseTheme
+} from "./chunk-GSTGBWQZ.js";
+import {
+  xTheme
+} from "./chunk-7MPAMAFC.js";
+import {
+  zapierTheme
+} from "./chunk-7ZAFN5WE.js";
+import {
+  stripeTheme
+} from "./chunk-I267MA2D.js";
+import {
+  supabaseTheme
+} from "./chunk-IXKXYUXQ.js";
+import {
+  superhumanTheme
+} from "./chunk-5BH5ZMDH.js";
+import {
+  teslaTheme
+} from "./chunk-Z3XCYZN4.js";
+import {
+  thevergeTheme
+} from "./chunk-IRDDULX7.js";
+import {
+  togetherTheme
+} from "./chunk-MVMZS3PQ.js";
+import {
+  uberTheme
+} from "./chunk-7OAKNGRU.js";
+import {
+  vercelTheme
+} from "./chunk-KCI73LIZ.js";
+import {
+  runwaymlTheme
+} from "./chunk-GAOOBTSH.js";
+import {
+  sanityTheme
+} from "./chunk-NKTZOR54.js";
+import {
+  sentryTheme
+} from "./chunk-YRGKMQP4.js";
+import {
+  shopifyTheme
+} from "./chunk-PN567MCL.js";
+import {
+  slackTheme
+} from "./chunk-5O65TVZP.js";
+import {
+  spacexTheme
+} from "./chunk-TXY7LBYM.js";
+import {
+  spotifyTheme
+} from "./chunk-BH7IPZBT.js";
+import {
+  starbucksTheme
+} from "./chunk-WAU2FYDY.js";
+import {
+  pinterestTheme
+} from "./chunk-72IPJZ6V.js";
+import {
+  playstationTheme
+} from "./chunk-SG2ACM7O.js";
+import {
+  posthogTheme
+} from "./chunk-CFLNGBY5.js";
+import {
+  raycastTheme
+} from "./chunk-KDS62BXD.js";
+import {
+  renaultTheme
+} from "./chunk-IJBNLZQH.js";
+import {
+  replicateTheme
+} from "./chunk-CUO2HNBR.js";
+import {
+  resendTheme
+} from "./chunk-RTCJ5B7S.js";
+import {
+  revolutTheme
+} from "./chunk-7YP2HHHV.js";
+import {
+  miroTheme
+} from "./chunk-Z6XLNVF3.js";
+import {
+  mistralTheme
+} from "./chunk-5TDK4XMA.js";
+import {
+  mongodbTheme
+} from "./chunk-LDZC2QYF.js";
+import {
+  nikeTheme
+} from "./chunk-LNKOIFH4.js";
+import {
+  notionTheme
+} from "./chunk-VUSSQAEI.js";
+import {
+  nvidiaTheme
+} from "./chunk-QTKMLEEM.js";
+import {
+  ollamaTheme
+} from "./chunk-VOXUB4AT.js";
+import {
+  opencodeTheme
+} from "./chunk-D5JFUYFN.js";
+import {
+  krakenTheme
+} from "./chunk-4LQ3BH7F.js";
+import {
+  lamborghiniTheme
+} from "./chunk-73N7YFTY.js";
+import {
+  linearTheme
+} from "./chunk-ATBX7KXM.js";
+import {
+  lovableTheme
+} from "./chunk-I6H6W42Y.js";
+import {
+  mastercardTheme
+} from "./chunk-BK432RWC.js";
+import {
+  metaTheme
+} from "./chunk-RN4ZII2I.js";
+import {
+  minimaxTheme
+} from "./chunk-OCQYO6PW.js";
+import {
+  mintlifyTheme
+} from "./chunk-ZQJDUTSK.js";
+import {
+  elevenlabsTheme
+} from "./chunk-NIED6GXO.js";
+import {
+  expoTheme
+} from "./chunk-CTI3W357.js";
+import {
+  ferrariTheme
+} from "./chunk-2OH25A4J.js";
+import {
+  figmaTheme
+} from "./chunk-FE2IENES.js";
+import {
+  framerTheme
+} from "./chunk-JZEZHM5N.js";
+import {
+  hashicorpTheme
+} from "./chunk-FK5WSFAA.js";
+import {
+  ibmTheme
+} from "./chunk-KZDIZ2FL.js";
+import {
+  intercomTheme
+} from "./chunk-KXBE5FQ7.js";
+import {
+  calTheme
+} from "./chunk-2SI7O4FQ.js";
+import {
+  claudeTheme
+} from "./chunk-E26YKJRK.js";
+import {
+  clayTheme
+} from "./chunk-I4Z7DY3Z.js";
+import {
+  clickhouseTheme
+} from "./chunk-QEBXRSTH.js";
+import {
+  cohereTheme
+} from "./chunk-SORTCBSJ.js";
+import {
+  coinbaseTheme
+} from "./chunk-PJAJD5VJ.js";
+import {
+  composioTheme
+} from "./chunk-7YPET3HT.js";
+import {
+  cursorTheme
+} from "./chunk-UIS6TMM5.js";
+import {
+  airbnbTheme
+} from "./chunk-BCLCH6JZ.js";
+import {
+  airtableTheme
+} from "./chunk-G2V6XAJ7.js";
+import {
+  appleTheme
+} from "./chunk-CEQN6EQY.js";
+import {
+  binanceTheme
+} from "./chunk-BMLLM5GC.js";
+import {
+  bmwMTheme
+} from "./chunk-DE2NWOEB.js";
+import {
+  bmwTheme
+} from "./chunk-ZTYINGDT.js";
+import {
+  bugattiTheme
+} from "./chunk-KLNZW4GO.js";
+
 // src/index.ts
+import { strictThemeSchema, themeSchema } from "@hex-core/registry";
 import { emberTheme, midnightTheme } from "@hex-core/tokens";
 var premiumThemes = {
   midnight: midnightTheme,
-  ember: emberTheme
+  ember: emberTheme,
+  ...voltagentPresets
 };
 function getPremiumTheme(name) {
   return premiumThemes[name];
@@ -11,14 +233,148 @@ function listPremiumThemes() {
   return Object.values(premiumThemes).map((t) => ({
     name: t.name,
     displayName: t.displayName,
-    description: t.description
+    description: t.description,
+    category: t.category,
+    tags: t.tags,
+    // `brand` falls back to `attribution.brand` (the trademark notice
+    // for voltagent-derived presets) — single source of truth on the
+    // theme object, no duplicated top-level `brand` field.
+    brand: t.brand ?? t.attribution?.brand
   }));
 }
+function searchThemes(input = {}) {
+  const { query, category, tags } = input;
+  const q = query?.toLowerCase().trim();
+  const requiredTags = tags?.map((t) => t.toLowerCase());
+  const out = [];
+  for (const theme of Object.values(premiumThemes)) {
+    if (category && theme.category !== category) continue;
+    if (requiredTags && requiredTags.length > 0) {
+      const themeTags = (theme.tags ?? []).map((t) => t.toLowerCase());
+      if (!requiredTags.every((t) => themeTags.includes(t))) continue;
+    }
+    if (q) {
+      const haystack = [
+        theme.name,
+        theme.displayName,
+        theme.description,
+        theme.brand,
+        theme.attribution?.brand
+      ].filter(Boolean).join(" ").toLowerCase();
+      if (!haystack.includes(q)) continue;
+    }
+    out.push(theme);
+  }
+  return out;
+}
+function extendTheme(base, overrides = {}) {
+  const merged = {
+    name: overrides.name ?? base.name,
+    displayName: overrides.displayName ?? base.displayName,
+    description: overrides.description ?? base.description,
+    tokens: {
+      light: { ...base.tokens.light, ...overrides.tokens?.light ?? {} },
+      dark: { ...base.tokens.dark, ...overrides.tokens?.dark ?? {} }
+    }
+  };
+  if ("brand" in overrides) merged.brand = overrides.brand;
+  else if (base.brand !== void 0) merged.brand = base.brand;
+  if ("category" in overrides) merged.category = overrides.category;
+  else if (base.category !== void 0) merged.category = base.category;
+  if ("tags" in overrides) merged.tags = overrides.tags;
+  else if (base.tags !== void 0) merged.tags = base.tags;
+  if ("designBrief" in overrides) merged.designBrief = overrides.designBrief;
+  else if (base.designBrief !== void 0) merged.designBrief = base.designBrief;
+  if ("attribution" in overrides) merged.attribution = overrides.attribution;
+  else if (base.attribution !== void 0) merged.attribution = base.attribution;
+  themeSchema.parse(merged);
+  strictThemeSchema.parse(merged);
+  return merged;
+}
+var allThemeSlugs = [...Object.keys(premiumThemes)];
 export {
+  airbnbTheme,
+  airtableTheme,
+  allThemeSlugs,
+  appleTheme,
+  binanceTheme,
+  bmwMTheme,
+  bmwTheme,
+  bugattiTheme,
+  calTheme,
+  claudeTheme,
+  clayTheme,
+  clickhouseTheme,
+  cohereTheme,
+  coinbaseTheme,
+  composioTheme,
+  cursorTheme,
+  elevenlabsTheme,
   emberTheme,
+  expoTheme,
+  extendTheme,
+  ferrariTheme,
+  figmaTheme,
+  framerTheme,
   getPremiumTheme,
+  hashicorpTheme,
+  ibmTheme,
+  intercomTheme,
+  krakenTheme,
+  lamborghiniTheme,
+  linearTheme,
   listPremiumThemes,
+  loadThemeBrief,
+  lovableTheme,
+  mastercardTheme,
+  metaTheme,
   midnightTheme,
-  premiumThemes
+  minimaxTheme,
+  mintlifyTheme,
+  miroTheme,
+  mistralTheme,
+  mongodbTheme,
+  nikeTheme,
+  notionTheme,
+  nvidiaTheme,
+  ollamaTheme,
+  opencodeTheme,
+  pinterestTheme,
+  playstationTheme,
+  posthogTheme,
+  premiumThemes,
+  presetSlugs,
+  presetsByCategory,
+  raycastTheme,
+  renaultTheme,
+  replicateTheme,
+  resendTheme,
+  revolutTheme,
+  runwaymlTheme,
+  sanityTheme,
+  searchThemes,
+  sentryTheme,
+  shopifyTheme,
+  slackTheme,
+  spacexTheme,
+  spotifyTheme,
+  starbucksTheme,
+  stripeTheme,
+  supabaseTheme,
+  superhumanTheme,
+  teslaTheme,
+  thevergeTheme,
+  togetherTheme,
+  uberTheme,
+  vercelTheme,
+  vodafoneTheme,
+  voltagentPresets,
+  voltagentTheme,
+  warpTheme,
+  webflowTheme,
+  wiredTheme,
+  wiseTheme,
+  xTheme,
+  zapierTheme
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @hex-core/themes — premium theme catalog and convenience re-exports.\n *\n * This package establishes a separate publish/version surface for theme\n * presets so the bundled `@hex-core/tokens` package can stay focused on the\n * single canonical default theme + the transformer functions.\n *\n * Today: re-exports `midnightTheme` and `emberTheme` from `@hex-core/tokens`\n * so consumers have a single import location for \"the catalog of themes\",\n * and adds a `listPremiumThemes()` helper. Future premium themes\n * (`fintech-dark`, `editorial-warm`, `data-dense`, `pastel-soft`,\n * `monochrome-strict`) will land here directly without bumping `tokens`.\n *\n * The default theme remains in `@hex-core/tokens` since it is the canonical\n * baseline that the transformers (themeToCss, themeToScopedRuntimeCss,\n * themeToFlatJson, themeToTailwindConfig, generateGlobalsCss) operate on.\n *\n * @example\n * ```ts\n * import { midnightTheme, emberTheme, listPremiumThemes } from \"@hex-core/themes\";\n * import { themeToScopedRuntimeCss } from \"@hex-core/tokens\";\n *\n * const css = themeToScopedRuntimeCss(midnightTheme, { mode: \"dark\" });\n * console.log(listPremiumThemes().map(t => t.name));\n * ```\n */\nimport type { Theme } from \"@hex-core/registry\";\nimport { emberTheme, midnightTheme } from \"@hex-core/tokens\";\n\nexport { emberTheme, midnightTheme };\n\n/**\n * The full set of premium themes shipped by this package, keyed by name.\n * Future premium themes added here are picked up automatically by\n * {@link listPremiumThemes} and {@link getPremiumTheme}.\n */\nexport const premiumThemes: Record<string, Theme> = {\n\tmidnight: midnightTheme,\n\tember: emberTheme,\n};\n\n/**\n * Retrieve a premium theme by name.\n *\n * @param name - The theme identifier (e.g. `\"midnight\"`, `\"ember\"`).\n * @returns The matching Theme object, or `undefined` if the name is unknown.\n */\nexport function getPremiumTheme(name: string): Theme | undefined {\n\treturn premiumThemes[name];\n}\n\n/**\n * List metadata for every premium theme in the catalog.\n *\n * Mirrors the shape of `listThemes()` from `@hex-core/tokens` so studios and\n * theme switchers can drive both catalogs through the same UI without\n * adapter code.\n *\n * @returns Array of `{ name, displayName, description }` summaries.\n */\nexport function listPremiumThemes(): Array<{\n\tname: string;\n\tdisplayName: string;\n\tdescription: string;\n}> {\n\treturn Object.values(premiumThemes).map((t) => ({\n\t\tname: t.name,\n\t\tdisplayName: t.displayName,\n\t\tdescription: t.description,\n\t}));\n}\n"],"mappings":";AA2BA,SAAS,YAAY,qBAAqB;AASnC,IAAM,gBAAuC;AAAA,EACnD,UAAU;AAAA,EACV,OAAO;AACR;AAQO,SAAS,gBAAgB,MAAiC;AAChE,SAAO,cAAc,IAAI;AAC1B;AAWO,SAAS,oBAIb;AACF,SAAO,OAAO,OAAO,aAAa,EAAE,IAAI,CAAC,OAAO;AAAA,IAC/C,MAAM,EAAE;AAAA,IACR,aAAa,EAAE;AAAA,IACf,aAAa,EAAE;AAAA,EAChB,EAAE;AACH;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @hex-core/themes — premium theme catalog and brand-derived presets.\n *\n * This package establishes a separate publish/version surface for theme\n * presets so the bundled `@hex-core/tokens` package can stay focused on the\n * single canonical default theme + the transformer functions.\n *\n * Catalog:\n *   - `midnight`, `ember` — first-party premium themes (re-exports from `@hex-core/tokens`)\n *   - `voltagent` brand presets — 71 brand-inspired themes (Tesla, Stripe, Linear, …)\n *     auto-generated from the MIT-licensed voltagent/awesome-design-md briefs\n *\n * @example\n * ```ts\n * import { teslaTheme, listPremiumThemes, extendTheme, searchThemes } from \"@hex-core/themes\";\n * import { themeToScopedRuntimeCss } from \"@hex-core/tokens\";\n *\n * const css = themeToScopedRuntimeCss(teslaTheme, { mode: \"dark\" });\n *\n * const myTesla = extendTheme(teslaTheme, {\n *   name: \"my-tesla\",\n *   tokens: { light: { primary: { value: \"0 100% 50%\", type: \"color\" } } },\n * });\n *\n * const fintech = searchThemes({ category: \"fintech\" });\n * ```\n */\nimport type { Theme, ThemeCategory } from \"@hex-core/registry\";\nimport { strictThemeSchema, themeSchema } from \"@hex-core/registry\";\nimport { emberTheme, midnightTheme } from \"@hex-core/tokens\";\nimport { presetSlugs, presetsByCategory, voltagentPresets } from \"./presets/index.js\";\n\nexport { emberTheme, midnightTheme };\nexport * from \"./presets/index.js\";\n\n/**\n * The full set of themes shipped by this package, keyed by slug. Includes:\n *   - First-party premium themes: `midnight`, `ember`\n *   - 71 voltagent brand-derived presets (e.g. `tesla`, `stripe`, `linear`)\n *\n * Studio's theme picker iterates this map directly, so every entry shows up\n * automatically without barrel-side wiring.\n */\nexport const premiumThemes: Record<string, Theme> = {\n\tmidnight: midnightTheme,\n\tember: emberTheme,\n\t...voltagentPresets,\n};\n\n/**\n * Retrieve a premium theme by slug.\n *\n * @param name - Theme slug (e.g. `\"midnight\"`, `\"tesla\"`, `\"stripe\"`).\n * @returns The matching Theme object, or `undefined` if the slug is unknown.\n */\nexport function getPremiumTheme(name: string): Theme | undefined {\n\treturn premiumThemes[name];\n}\n\n/**\n * List metadata for every theme in the catalog.\n *\n * Mirrors the shape of `listThemes()` from `@hex-core/tokens` so studios and\n * theme switchers can drive both catalogs through the same UI without\n * adapter code.\n *\n * @returns Array of `{ name, displayName, description, category?, tags?, brand? }` summaries.\n */\nexport function listPremiumThemes(): Array<{\n\tname: string;\n\tdisplayName: string;\n\tdescription: string;\n\tcategory?: ThemeCategory;\n\ttags?: string[];\n\tbrand?: string;\n}> {\n\treturn Object.values(premiumThemes).map((t) => ({\n\t\tname: t.name,\n\t\tdisplayName: t.displayName,\n\t\tdescription: t.description,\n\t\tcategory: t.category,\n\t\ttags: t.tags,\n\t\t// `brand` falls back to `attribution.brand` (the trademark notice\n\t\t// for voltagent-derived presets) — single source of truth on the\n\t\t// theme object, no duplicated top-level `brand` field.\n\t\tbrand: t.brand ?? t.attribution?.brand,\n\t}));\n}\n\n/** Filter input for {@link searchThemes}. */\nexport interface SearchThemesInput {\n\t/** Case-insensitive substring match against `name` / `displayName` / `description`. */\n\tquery?: string;\n\t/** Restrict to a single category. */\n\tcategory?: ThemeCategory;\n\t/** All listed tags must be present (intersection match). */\n\ttags?: string[];\n}\n\n/**\n * Search the full preset catalog by category, tags, or free-text query.\n * The 71 voltagent presets each carry `category` and `tags`; the\n * first-party `midnight` / `ember` themes don't (they pre-date the\n * metadata extension), so they only match via the `query` filter.\n *\n * @param input - Filter criteria; combine for AND semantics.\n * @returns Matching themes, in catalog order.\n */\nexport function searchThemes(input: SearchThemesInput = {}): Theme[] {\n\tconst { query, category, tags } = input;\n\tconst q = query?.toLowerCase().trim();\n\tconst requiredTags = tags?.map((t) => t.toLowerCase());\n\tconst out: Theme[] = [];\n\tfor (const theme of Object.values(premiumThemes)) {\n\t\tif (category && theme.category !== category) continue;\n\t\tif (requiredTags && requiredTags.length > 0) {\n\t\t\tconst themeTags = (theme.tags ?? []).map((t) => t.toLowerCase());\n\t\t\tif (!requiredTags.every((t) => themeTags.includes(t))) continue;\n\t\t}\n\t\tif (q) {\n\t\t\tconst haystack = [\n\t\t\t\ttheme.name,\n\t\t\t\ttheme.displayName,\n\t\t\t\ttheme.description,\n\t\t\t\ttheme.brand,\n\t\t\t\ttheme.attribution?.brand,\n\t\t\t]\n\t\t\t\t.filter(Boolean)\n\t\t\t\t.join(\" \")\n\t\t\t\t.toLowerCase();\n\t\t\tif (!haystack.includes(q)) continue;\n\t\t}\n\t\tout.push(theme);\n\t}\n\treturn out;\n}\n\n/**\n * Override input for {@link extendTheme}. Token sets accept partial\n * objects (token slots merge); scalar fields replace the base value\n * when present. `attribution` is full-replacement (not merged) — a\n * consumer rebranding a preset under their own license / URL almost\n * always wants their attribution to fully replace the upstream's.\n * Pass `attribution: undefined` to remove attribution entirely.\n */\nexport interface ThemeOverrides {\n\tname?: string;\n\tdisplayName?: string;\n\tdescription?: string;\n\tbrand?: string;\n\tcategory?: Theme[\"category\"];\n\ttags?: string[];\n\tdesignBrief?: string;\n\tattribution?: Theme[\"attribution\"];\n\t/**\n\t * Per-mode token overrides — token slot keys are an open record\n\t * (the schema's `tokenSetSchema` uses a catchall), so any subset\n\t * of slots is valid. Slots not listed fall through from the base.\n\t */\n\ttokens?: {\n\t\tlight?: Theme[\"tokens\"][\"light\"];\n\t\tdark?: Theme[\"tokens\"][\"dark\"];\n\t};\n}\n\n/**\n * Compose a custom theme by overlaying overrides on a base preset.\n *\n * Token sets are merged at the slot level: missing slots fall through\n * from the base; overridden slots replace the entire `{ value, type }`\n * record. Scalar fields replace the base when present (including\n * `tags: []` which clears the inherited tag list — explicit empty is\n * intentional, not surprising).\n *\n * `attribution` is FULL-REPLACEMENT (not deep-merged) — a consumer\n * republishing a preset under their own license / brand wants their\n * attribution to land cleanly without the upstream's `brand` /\n * `source` / `url` leaking through. Spread base.attribution yourself\n * if you actually want partial merge.\n *\n * The composed theme is re-validated via `strictThemeSchema` before\n * return, so consumers can't accidentally produce an under-spec'd\n * Theme.\n *\n * @example\n * ```ts\n * const myTesla = extendTheme(teslaTheme, {\n *   name: \"my-tesla\",\n *   displayName: \"My Tesla\",\n *   tokens: {\n *     light: { primary: { value: \"0 100% 50%\", type: \"color\" } },\n *   },\n * });\n * ```\n *\n * @param base - The starting theme (any preset or first-party theme)\n * @param overrides - Partial theme; only specified fields override\n * @returns A new validated Theme that's safe to feed to any transformer\n */\nexport function extendTheme(base: Theme, overrides: ThemeOverrides = {}): Theme {\n\t// Build a fresh theme so we never mutate `base` (consumers can call\n\t// extendTheme repeatedly against the same shared preset).\n\tconst merged: Theme = {\n\t\tname: overrides.name ?? base.name,\n\t\tdisplayName: overrides.displayName ?? base.displayName,\n\t\tdescription: overrides.description ?? base.description,\n\t\ttokens: {\n\t\t\tlight: { ...base.tokens.light, ...(overrides.tokens?.light ?? {}) },\n\t\t\tdark: { ...base.tokens.dark, ...(overrides.tokens?.dark ?? {}) },\n\t\t},\n\t};\n\n\t// Optional metadata: caller-supplied value wins (including explicit\n\t// empty arrays / undefined). `in` checks distinguish \"not specified\"\n\t// from \"specified as undefined\" so consumers can clear inherited\n\t// fields when they want to.\n\tif (\"brand\" in overrides) merged.brand = overrides.brand;\n\telse if (base.brand !== undefined) merged.brand = base.brand;\n\n\tif (\"category\" in overrides) merged.category = overrides.category;\n\telse if (base.category !== undefined) merged.category = base.category;\n\n\tif (\"tags\" in overrides) merged.tags = overrides.tags;\n\telse if (base.tags !== undefined) merged.tags = base.tags;\n\n\tif (\"designBrief\" in overrides) merged.designBrief = overrides.designBrief;\n\telse if (base.designBrief !== undefined) merged.designBrief = base.designBrief;\n\n\t// Full-replacement semantics for attribution (see JSDoc).\n\tif (\"attribution\" in overrides) merged.attribution = overrides.attribution;\n\telse if (base.attribution !== undefined) merged.attribution = base.attribution;\n\n\t// Permissive parse first so consumer overrides like `tags: []` pass.\n\t// Strict parse catches any token-slot regression.\n\tthemeSchema.parse(merged);\n\tstrictThemeSchema.parse(merged);\n\n\treturn merged;\n}\n\n/** All preset slugs known to this package, including first-party themes. */\nexport const allThemeSlugs: readonly string[] = [...Object.keys(premiumThemes)];\n\nexport { presetSlugs, presetsByCategory };\n"],"mappings":"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","names":[]}