@hex-core/themes 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hex UI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,46 @@
+# @hex-core/themes
+
+Premium theme catalog for Hex UI — preset palettes that consume the same `Theme` shape as `@hex-core/tokens`.
+
+## Why this is its own package
+
+`@hex-core/tokens` keeps a single canonical default theme + the transformer functions (`themeToCss`, `themeToScopedRuntimeCss`, etc.). `@hex-core/themes` is the publish/version surface for everything else. Adding or revising a theme bumps **only** this package, so consumers who pin a theme don't get pulled forward by an unrelated transformer change.
+
+## Install
+
+```bash
+pnpm add @hex-core/themes @hex-core/tokens
+```
+
+`@hex-core/tokens` is the implicit peer dep — every theme is a `Theme` instance from `@hex-core/registry`, applied by `tokens`' transformers.
+
+## Use
+
+```ts
+import { midnightTheme, emberTheme, listPremiumThemes } from "@hex-core/themes";
+import { themeToScopedRuntimeCss } from "@hex-core/tokens";
+
+// Apply a theme via runtime override (no globals.css round-trip):
+const css = themeToScopedRuntimeCss(midnightTheme, {
+  scope: ".theme-midnight",
+  mode: "dark",
+});
+
+// Drive a theme switcher UI from the catalog:
+for (const { name, displayName, description } of listPremiumThemes()) {
+  // …render a chip per theme
+}
+```
+
+## Catalog (today)
+
+| Name | Display name | Notes |
+|---|---|---|
+| `midnight` | Midnight | Dark canvas, indigo accents. Re-exported from `@hex-core/tokens`. |
+| `ember` | Ember | Warm dark canvas with amber primary. Re-exported from `@hex-core/tokens`. |
+
+Future premium presets (`fintech-dark`, `editorial-warm`, `data-dense`, `pastel-soft`, `monochrome-strict`) ship here directly.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+import { Theme } from '@hex-core/registry';
+export { emberTheme, midnightTheme } from '@hex-core/tokens';
+
+/**
+ * @hex-core/themes — premium theme catalog and convenience re-exports.
+ *
+ * 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.
+ *
+ * @example
+ * ```ts
+ * import { midnightTheme, emberTheme, listPremiumThemes } from "@hex-core/themes";
+ * import { themeToScopedRuntimeCss } from "@hex-core/tokens";
+ *
+ * const css = themeToScopedRuntimeCss(midnightTheme, { mode: "dark" });
+ * console.log(listPremiumThemes().map(t => t.name));
+ * ```
+ */
+
+/**
+ * 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}.
+ */
+declare const premiumThemes: Record<string, Theme>;
+/**
+ * Retrieve a premium theme by name.
+ *
+ * @param name - The theme identifier (e.g. `"midnight"`, `"ember"`).
+ * @returns The matching Theme object, or `undefined` if the name is unknown.
+ */
+declare function getPremiumTheme(name: string): Theme | undefined;
+/**
+ * List metadata for every premium 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.
+ */
+declare function listPremiumThemes(): Array<{
+    name: string;
+    displayName: string;
+    description: string;
+}>;
+
+export { getPremiumTheme, listPremiumThemes, premiumThemes };

package/dist/index.js

@@ -0,0 +1,24 @@
+// src/index.ts
+import { emberTheme, midnightTheme } from "@hex-core/tokens";
+var premiumThemes = {
+  midnight: midnightTheme,
+  ember: emberTheme
+};
+function getPremiumTheme(name) {
+  return premiumThemes[name];
+}
+function listPremiumThemes() {
+  return Object.values(premiumThemes).map((t) => ({
+    name: t.name,
+    displayName: t.displayName,
+    description: t.description
+  }));
+}
+export {
+  emberTheme,
+  getPremiumTheme,
+  listPremiumThemes,
+  midnightTheme,
+  premiumThemes
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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":[]}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@hex-core/themes",
+  "version": "0.1.0",
+  "description": "Theme catalog for Hex UI — premium presets and convenience re-exports built on @hex-core/tokens.",
+  "keywords": [
+    "hex-ui",
+    "themes",
+    "design-tokens",
+    "theme-catalog"
+  ],
+  "license": "MIT",
+  "author": "Oscar Corona <oabc4004@gmail.com>",
+  "homepage": "https://hex-core.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/oscarabcorona/hex-core.git",
+    "directory": "packages/themes"
+  },
+  "bugs": {
+    "url": "https://github.com/oscarabcorona/hex-core/issues"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@hex-core/registry": "^0.2.1",
+    "@hex-core/tokens": "^1.2.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  }
+}