@softure-ai/theme-kit 0.0.0-stage → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+Newest first. Each version lists what changed for an app or a theme package that uses the kit.
+
+## 0.1.1
+
+- No change to the package itself: the first version published through the npm trusted publisher (OIDC) with
+  provenance, without a token.
+
+## 0.1.0
+
+- First version: `ThemeDefinition` and `SHADCN_COLOR_ROLES` (the token contract), `buildThemeCss` (tokens on
+  `:root`, dark by the system setting and by `.dark` / `[data-theme]`, the Tailwind `@theme inline` block),
+  `findMissingColorRoles`, `createCn` and `createThemeCn`, `useIsMobile` (`./react`) and `preflight.css` (#708).
+- The theme package contract (#708): `defineTheme` (checks a theme where it is declared), `checkTheme` (the problems
+  as a list), `extendTheme` (a variant of an existing theme), the `softure-theme-css` command that builds every theme
+  package's `theme.css` from `softureTheme` in its `package.json`, and `./build` (`parseThemePackageConfig`,
+  `buildThemeStylesheet`, `writeThemeStylesheets`, `buildThemePackage`).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SOFTURE
+
+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

@@ -1,3 +1,130 @@
-# Temporary Holding Version
+# @softure-ai/theme-kit
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The standard every SOFTURE theme package is built on. A theme is plain shadcn/ui (Radix, Tailwind CSS v4, lucide
+icons) with its own tokens and component deltas; the kit holds everything that does not change from theme to theme:
+the token contract, the way a theme is declared, the CSS generator, the build command and the shared helpers. A new
+theme is a new `themes/theme-<name>` folder that follows the contract below; nothing in the kit changes.
+
+Apps install a theme package (e.g. [`@softure-ai/theme-notion`](../theme-notion/README.md)), which depends on the kit.
+An app imports the kit directly only for `preflight.css`, `useIsMobile`, or to build its own variant of a theme.
+
+## Design
+
+```text
+ThemeDefinition (data)  ──defineTheme──▶  theme (checked)  ──buildThemeCss──▶  tokens CSS
+        ▲                                     │
+   extendTheme(base, overrides)               └──softure-theme-css + softureTheme──▶  dist/theme.css
+```
+
+- **One contract.** `ThemeDefinition` says what a theme decides: colours (light and dark, or an alias of another
+  colour), shadows, fonts, named text styles, radii, layout sizes, whether Tailwind's default palette is cleared.
+  `SHADCN_COLOR_ROLES` are the colour roles shadcn/ui components read; every theme defines them all, so a component
+  written for one theme renders in any other. A theme adds its own tokens on top (`green-tag`, `primary-hover`).
+- **Declared and checked in one place.** `defineTheme(definition)` checks the theme where it is written and throws
+  with every problem listed: a missing colour role, a name that is not kebab-case, an empty value or one that could
+  break out of the CSS, an alias of a colour the theme does not define. `checkTheme` returns the same problems as a
+  list. The literal types stay, so `theme.colors.primary` is known to the compiler.
+- **Built the same way.** A theme package has no build script of its own. It declares its stylesheet as data
+  (`softureTheme` in `package.json`) and its build runs the kit's `softure-theme-css`, which writes `dist/theme.css`
+  from the package's `theme` and copies its extra stylesheets.
+- **Variants, not copies.** `extendTheme(base, overrides)` gives a theme that differs from another in a few tokens:
+  each token group of the overrides is laid over the base's (a token is replaced whole), the result is checked.
+- **Checked in the repository.** `tests/repo/themes.test.ts` runs the contract over every `themes/theme-*` package,
+  so a new theme is covered by being created.
+
+## What it holds
+
+| Export | What it does |
+| --- | --- |
+| `ThemeDefinition`, `SHADCN_COLOR_ROLES`, `findMissingColorRoles` | The token contract |
+| `defineTheme(definition)` | Declares a theme: checks it, returns it with its literal types, throws with every problem |
+| `checkTheme(definition)` | The contract problems as messages; empty when the theme is complete |
+| `extendTheme(base, overrides)` | A checked variant of a theme: a new name, per group only the tokens that change |
+| `buildThemeCss(definition)` | The theme's tokens as CSS for Tailwind CSS v4 (below) |
+| `createCn(options)`, `createThemeCn(definition)` | shadcn/ui's `cn`, with tailwind-merge told the theme's named text styles and shadows (`text-body` and `text-muted-foreground` both stay) |
+| `useIsMobile()`, `MOBILE_BREAKPOINT` (`/react`) | The sidebar's breakpoint (768 px), on `useSyncExternalStore`; the server renders the desktop layout |
+| `preflight.css` | Tailwind's preflight scoped to `[data-slot]` elements, in `@layer base` with zero specificity, plus `prefers-reduced-motion` |
+| `softure-theme-css [packageDir]` | Builds a theme package's stylesheets after `tsc` (the contract below) |
+| `/build`: `parseThemePackageConfig`, `buildThemeStylesheet`, `writeThemeStylesheets`, `buildThemePackage` | The code behind the command, for tests and tools (Node only) |
+
+## The theme package contract
+
+Every `themes/theme-<name>` package (named `@softure-ai/theme-<name>` by its folder):
+
+1. `src/tokens.ts` exports `theme`, declared with `defineTheme`. It may also export a named alias (`NOTION_THEME`).
+2. `src/index.ts` exports `theme`, `cn` (`createThemeCn(theme)`) and the components. The same names in every theme,
+   so an app moves to another theme by changing the import path.
+3. `package.json`:
+   - depends on `@softure-ai/theme-kit`; takes `react` and `tailwindcss` `^4.0.0` as peers;
+   - `"build": "tsc -p tsconfig.build.json && softure-theme-css"`;
+   - exports `./theme.css` (`./dist/theme.css`) and each extra stylesheet (`./<name>.css` → `./dist/<name>.css`);
+   - declares the stylesheet:
+
+     ```json
+     "softureTheme": {
+       "sources": ["./ui", "./notion"],
+       "imports": ["tw-animate-css"],
+       "stylesheets": ["sft-bridge.css"]
+     }
+     ```
+
+     `sources`: the component folders under `src/` (and `dist/`), written into `theme.css` as `@source`, so the app's
+     Tailwind generates their classes inside `node_modules`. `imports`: CSS packages the components need, imported
+     first. `stylesheets`: plain CSS files in `src/` copied to `dist/` as they are. Each defaults to none.
+
+`theme.css` is then `@import` lines, `@source` lines and the generated tokens, in that order.
+
+## The generated CSS
+
+`buildThemeCss` writes, in this order:
+
+1. `@custom-variant dark`: Tailwind's `dark:` follows the same rule as the tokens below.
+2. `:root, .light, [data-theme="light"]`: the light values.
+3. `@media (prefers-color-scheme: dark)` → `:root:not(.light, [data-theme="light"])`: the dark values by the system
+   setting, unless the page asks for light.
+4. `.dark, [data-theme="dark"]`: the dark values by choice. Works with `next-themes` (`attribute="class"`) and with
+   `@softure-ai/ui`'s `ThemeScript` / `ThemeSwitch` (`data-theme` on `<html>`); a section can take a fixed scheme.
+5. `@theme inline`: `--color-<name>`, `--font-*`, `--text-<style>` (size, line height, weight, tracking),
+   `--radius-*`, `--shadow-*` and the sizes as `--spacing-*`, so `bg-primary`, `text-page-title`, `rounded-xl`,
+   `shadow-menu` and `w-sidebar-width` exist. With `clearDefaultPalette`, `--color-*: initial` first.
+
+It throws on a name that is not kebab-case, a value holding `;`, `{`, `}`, `<`, `>` or a line break, and an alias of
+a colour the theme does not define.
+
+## Overriding in an app
+
+- **A few tokens:** redefine the CSS variables after the theme's `theme.css`, for both schemes:
+
+  ```css
+  @import "@softure-ai/theme-notion/theme.css";
+  :root { --primary: #e16259; }
+  .dark, [data-theme="dark"] { --primary: #df5452; }
+  ```
+
+- **A variant of its own:** build it from the theme and write the CSS in the app's build, then import the app's file
+  instead of the theme's tokens:
+
+  ```ts
+  import { writeFileSync } from "node:fs";
+  import { buildThemeCss, extendTheme } from "@softure-ai/theme-kit";
+  import { theme } from "@softure-ai/theme-notion";
+
+  const brand = extendTheme(theme, { name: "Brand", colors: { primary: { light: "#e16259", dark: "#df5452" } } });
+  writeFileSync("app/brand-theme.css", buildThemeCss(brand));
+  ```
+
+  `cn` stays the theme's while the variant adds no text styles or shadows; otherwise use `createThemeCn(brand)`.
+
+## Adding a theme
+
+1. Create `themes/theme-<name>/` with the workspace package shape (`templates/package/` for `package.json`, the
+   `tsconfig` files and `CHANGELOG.md`) and the contract above.
+2. `src/tokens.ts`: `export const theme = defineTheme({ name: "<Name>", colors: { … }, … })`. Every shadcn colour
+   role is required; `defineTheme` names the missing ones. A theme close to an existing one can be
+   `extendTheme(otherTheme, { … })`. Keep a snapshot of the design system's tokens in `tests/fixtures/` and a test
+   that the definition equals it.
+3. `src/lib/utils.ts`: `export const cn = createThemeCn(theme)`.
+4. `src/ui/`: the shadcn/ui components with the theme's deltas (sizes, radii, shadows, variants), listed in the
+   README; keep shadcn's file names and formatting, so a later `npx shadcn@latest add` diff stays readable. Add
+   compositions in a folder of their own and name every folder in `softureTheme.sources`.
+5. Run `npm test`: `tests/repo/themes.test.ts` checks the package against the contract.

package/bin/softure-theme-css.mjs

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+// @ts-check
+// The `softure-theme-css` executable. A checked-in file rather than a file in dist/, so npm links it at install
+// time, before the kit is built; it runs after the kit's build (theme packages depend on the kit, which builds
+// first). The command is loaded by URL, so the type check does not need dist/ either. All logic lives in
+// src/cli/command.ts, which the tests call directly.
+
+/** @typedef {{ runThemeCssCommand: (input: { argv: string[]; cwd: string }) => Promise<number> }} CommandModule */
+
+/** @type {unknown} */
+const loaded = await import(new URL("../dist/cli/command.js", import.meta.url).href);
+const commandModule = /** @type {CommandModule} */ (loaded);
+
+process.exitCode = await commandModule.runThemeCssCommand({ argv: process.argv.slice(2), cwd: process.cwd() });

package/dist/build/build-theme-package.d.ts

@@ -0,0 +1,13 @@
+export type BuildResult = {
+    ok: true;
+    files: string[];
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Builds a theme package's stylesheets after `tsc`: reads `softureTheme` from its `package.json` and the `theme`
+ * export of the built `dist/tokens.js`, checks the theme, writes `dist/theme.css` and copies the stylesheets.
+ */
+export declare function buildThemePackage(packageDir: string): Promise<BuildResult>;
+//# sourceMappingURL=build-theme-package.d.ts.map

package/dist/build/build-theme-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-theme-package.d.ts","sourceRoot":"","sources":["../../src/build/build-theme-package.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAevF;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAgBhF"}

package/dist/build/build-theme-package.js

@@ -0,0 +1,42 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { checkTheme } from "../check-theme.js";
+import { parseThemePackageConfig } from "./theme-package-config.js";
+import { writeThemeStylesheets } from "./theme-stylesheet.js";
+const DEFINITION_GROUPS = ["colors", "shadows", "fonts", "textStyles", "radii", "sizes"];
+/** A first, structural narrowing of the `theme` export; `checkTheme` then checks the values. */
+function isThemeDefinition(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const record = value;
+    return (typeof record.name === "string" &&
+        typeof record.clearDefaultPalette === "boolean" &&
+        DEFINITION_GROUPS.every((group) => typeof record[group] === "object" && record[group] !== null));
+}
+/**
+ * Builds a theme package's stylesheets after `tsc`: reads `softureTheme` from its `package.json` and the `theme`
+ * export of the built `dist/tokens.js`, checks the theme, writes `dist/theme.css` and copies the stylesheets.
+ */
+export async function buildThemePackage(packageDir) {
+    const manifest = JSON.parse(readFileSync(join(packageDir, "package.json"), "utf8"));
+    const parsed = parseThemePackageConfig(manifest.softureTheme);
+    if (!parsed.ok)
+        return parsed;
+    const tokensPath = join(packageDir, "dist", "tokens.js");
+    let tokens;
+    try {
+        tokens = (await import(pathToFileURL(tokensPath).href));
+    }
+    catch (error) {
+        return { ok: false, error: `cannot load ${tokensPath} (run tsc first): ${error instanceof Error ? error.message : String(error)}` };
+    }
+    const theme = tokens.theme;
+    if (!isThemeDefinition(theme))
+        return { ok: false, error: `${tokensPath} does not export \`theme\` as a theme definition` };
+    const problems = checkTheme(theme);
+    if (problems.length > 0)
+        return { ok: false, error: `theme "${theme.name}" breaks the theme contract: ${problems.join("; ")}` };
+    return { ok: true, files: writeThemeStylesheets({ packageDir, theme, config: parsed.config }) };
+}
+//# sourceMappingURL=build-theme-package.js.map

package/dist/build/build-theme-package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-theme-package.js","sourceRoot":"","sources":["../../src/build/build-theme-package.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAI9D,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,CAAU,CAAC;AAElG,gGAAgG;AAChG,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,OAAO,CACL,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAC/B,OAAO,MAAM,CAAC,mBAAmB,KAAK,SAAS;QAC/C,iBAAiB,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAChG,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,UAAkB;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAA4B,CAAC;IAC/G,MAAM,MAAM,GAAG,uBAAuB,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC9D,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC;IAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACzD,IAAI,MAA+B,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAA4B,CAAC;IACrF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,UAAU,qBAAqB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;IACtI,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,UAAU,kDAAkD,EAAE,CAAC;IAC5H,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,KAAK,CAAC,IAAI,gCAAgC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;IAChI,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,qBAAqB,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;AAClG,CAAC"}

package/dist/build/index.d.ts

@@ -0,0 +1,4 @@
+export { buildThemePackage, type BuildResult } from "./build-theme-package.js";
+export { parseThemePackageConfig, type ConfigResult, type ThemePackageConfig } from "./theme-package-config.js";
+export { buildThemeStylesheet, writeThemeStylesheets, type ThemeStylesheetInput, type WriteThemeStylesheetsOptions, } from "./theme-stylesheet.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/build/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,KAAK,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAChH,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,GAClC,MAAM,uBAAuB,CAAC"}

package/dist/build/index.js

@@ -0,0 +1,5 @@
+// Node-only: the code that builds a theme package's stylesheets (`softure-theme-css`). Not for the browser bundle.
+export { buildThemePackage } from "./build-theme-package.js";
+export { parseThemePackageConfig } from "./theme-package-config.js";
+export { buildThemeStylesheet, writeThemeStylesheets, } from "./theme-stylesheet.js";
+//# sourceMappingURL=index.js.map

package/dist/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/build/index.ts"],"names":[],"mappings":"AAAA,mHAAmH;AACnH,OAAO,EAAE,iBAAiB,EAAoB,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAA8C,MAAM,2BAA2B,CAAC;AAChH,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GAGtB,MAAM,uBAAuB,CAAC"}

package/dist/build/theme-package-config.d.ts

@@ -0,0 +1,22 @@
+/**
+ * How a theme package ships its stylesheet, declared under `softureTheme` in its `package.json`. Data, not a script:
+ * every theme builds with the same `softure-theme-css` command, and the repository test reads the same declaration.
+ */
+export interface ThemePackageConfig {
+    /** Folders of components, relative to `theme.css` (`./ui`), that the app's Tailwind scans through `@source`. */
+    sources: string[];
+    /** CSS packages the components need, imported at the top of `theme.css` (`tw-animate-css`). */
+    imports: string[];
+    /** Further plain stylesheets in `src/`, copied to `dist/` as they are (`sft-bridge.css`). */
+    stylesheets: string[];
+}
+export type ConfigResult = {
+    ok: true;
+    config: ThemePackageConfig;
+} | {
+    ok: false;
+    error: string;
+};
+/** Narrows the `softureTheme` value of a `package.json` to a config, or says what is wrong with it. */
+export declare function parseThemePackageConfig(value: unknown): ConfigResult;
+//# sourceMappingURL=theme-package-config.d.ts.map

package/dist/build/theme-package-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-package-config.d.ts","sourceRoot":"","sources":["../../src/build/theme-package-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,gHAAgH;IAChH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+FAA+F;IAC/F,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6FAA6F;IAC7F,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAiBnG,uGAAuG;AACvG,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAcpE"}

package/dist/build/theme-package-config.js

@@ -0,0 +1,34 @@
+const SOURCE_PATH = /^\.\/[a-z0-9-]+(?:\/[a-z0-9-]+)*$/;
+const STYLESHEET_NAME = /^[a-z0-9-]+\.css$/;
+const IMPORT_NAME = /^[@a-z0-9][@a-z0-9._/-]*$/;
+function readList(record, key, pattern, hint) {
+    const value = record[key] ?? [];
+    if (!Array.isArray(value))
+        return `"${key}" is not a list`;
+    const items = [];
+    for (const item of value) {
+        if (typeof item !== "string" || !pattern.test(item))
+            return `"${key}" holds ${JSON.stringify(item)}, which is not ${hint}`;
+        items.push(item);
+    }
+    return items;
+}
+/** Narrows the `softureTheme` value of a `package.json` to a config, or says what is wrong with it. */
+export function parseThemePackageConfig(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return { ok: false, error: "softureTheme: missing, or not an object" };
+    }
+    const record = value;
+    const unknownKeys = Object.keys(record).filter((key) => !["sources", "imports", "stylesheets"].includes(key));
+    if (unknownKeys.length > 0)
+        return { ok: false, error: `softureTheme: unknown keys ${unknownKeys.join(", ")}` };
+    const sources = readList(record, "sources", SOURCE_PATH, "a relative folder like ./ui");
+    const imports = readList(record, "imports", IMPORT_NAME, "a package name");
+    const stylesheets = readList(record, "stylesheets", STYLESHEET_NAME, "a .css file name in src/");
+    for (const result of [sources, imports, stylesheets]) {
+        if (typeof result === "string")
+            return { ok: false, error: `softureTheme: ${result}` };
+    }
+    return { ok: true, config: { sources: sources, imports: imports, stylesheets: stylesheets } };
+}
+//# sourceMappingURL=theme-package-config.js.map

package/dist/build/theme-package-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-package-config.js","sourceRoot":"","sources":["../../src/build/theme-package-config.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,GAAG,mCAAmC,CAAC;AACxD,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAC5C,MAAM,WAAW,GAAG,2BAA2B,CAAC;AAEhD,SAAS,QAAQ,CAAC,MAA+B,EAAE,GAA6B,EAAE,OAAe,EAAE,IAAY;IAC7G,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,GAAG,iBAAiB,CAAC;IAC3D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAkB,EAAE,CAAC;QACtC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,GAAG,WAAW,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,kBAAkB,IAAI,EAAE,CAAC;QAC3H,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC;IACzE,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9G,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,8BAA8B,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;IAChH,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,6BAA6B,CAAC,CAAC;IACxF,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAC;IAC3E,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,0BAA0B,CAAC,CAAC;IACjG,KAAK,MAAM,MAAM,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC;QACrD,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,MAAM,EAAE,EAAE,CAAC;IACzF,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,OAAmB,EAAE,OAAO,EAAE,OAAmB,EAAE,WAAW,EAAE,WAAuB,EAAE,EAAE,CAAC;AACpI,CAAC"}

package/dist/build/theme-stylesheet.d.ts

@@ -0,0 +1,24 @@
+import type { ThemeDefinition } from "../theme-definition.js";
+import type { ThemePackageConfig } from "./theme-package-config.js";
+export interface ThemeStylesheetInput {
+    theme: ThemeDefinition;
+    /** `@source` paths: relative to the written file, or absolute (a test compiling the sources in place). */
+    sources: readonly string[];
+    imports: readonly string[];
+}
+/**
+ * The text of a theme package's `theme.css`: the CSS imports, the component folders as `@source` (Tailwind resolves
+ * them relative to the file, so the app's Tailwind finds them inside `node_modules`), then the generated tokens.
+ */
+export declare function buildThemeStylesheet({ theme, sources, imports }: ThemeStylesheetInput): string;
+export interface WriteThemeStylesheetsOptions {
+    /** The theme package's folder; its `src/` holds the stylesheets to copy. */
+    packageDir: string;
+    /** Where the files go; the package's `dist/` by default. */
+    distDir?: string;
+    theme: ThemeDefinition;
+    config: ThemePackageConfig;
+}
+/** Writes `theme.css` and copies the declared stylesheets; returns the written file names. */
+export declare function writeThemeStylesheets({ packageDir, distDir, theme, config }: WriteThemeStylesheetsOptions): string[];
+//# sourceMappingURL=theme-stylesheet.d.ts.map

package/dist/build/theme-stylesheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-stylesheet.d.ts","sourceRoot":"","sources":["../../src/build/theme-stylesheet.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,eAAe,CAAC;IACvB,0GAA0G;IAC1G,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,oBAAoB,GAAG,MAAM,CAO9F;AAED,MAAM,WAAW,4BAA4B;IAC3C,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED,8FAA8F;AAC9F,wBAAgB,qBAAqB,CAAC,EAAE,UAAU,EAAE,OAAkC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,4BAA4B,GAAG,MAAM,EAAE,CAK/I"}

package/dist/build/theme-stylesheet.js

@@ -0,0 +1,24 @@
+import { copyFileSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { buildThemeCss } from "../build-theme-css.js";
+/**
+ * The text of a theme package's `theme.css`: the CSS imports, the component folders as `@source` (Tailwind resolves
+ * them relative to the file, so the app's Tailwind finds them inside `node_modules`), then the generated tokens.
+ */
+export function buildThemeStylesheet({ theme, sources, imports }) {
+    return [
+        ...imports.map((name) => `@import ${JSON.stringify(name)};`),
+        ...sources.map((source) => `@source ${JSON.stringify(source)};`),
+        "",
+        buildThemeCss(theme),
+    ].join("\n");
+}
+/** Writes `theme.css` and copies the declared stylesheets; returns the written file names. */
+export function writeThemeStylesheets({ packageDir, distDir = join(packageDir, "dist"), theme, config }) {
+    mkdirSync(distDir, { recursive: true });
+    writeFileSync(join(distDir, "theme.css"), buildThemeStylesheet({ theme, sources: config.sources, imports: config.imports }));
+    for (const name of config.stylesheets)
+        copyFileSync(join(packageDir, "src", name), join(distDir, name));
+    return ["theme.css", ...config.stylesheets];
+}
+//# sourceMappingURL=theme-stylesheet.js.map

package/dist/build/theme-stylesheet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-stylesheet.js","sourceRoot":"","sources":["../../src/build/theme-stylesheet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAWtD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAwB;IACpF,OAAO;QACL,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;QAC5D,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC;QAChE,EAAE;QACF,aAAa,CAAC,KAAK,CAAC;KACrB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAWD,8FAA8F;AAC9F,MAAM,UAAU,qBAAqB,CAAC,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAgC;IACnI,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,oBAAoB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC7H,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,WAAW;QAAE,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IACxG,OAAO,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;AAC9C,CAAC"}

package/dist/build-theme-css.d.ts

@@ -0,0 +1,12 @@
+import { type ThemeDefinition } from "./theme-definition.js";
+/**
+ * The theme's CSS for Tailwind CSS v4: the tokens per scheme and the `@theme inline` block that turns them into
+ * utilities (`bg-background`, `text-page-title`, `rounded-xl`, `shadow-menu`, `w-sidebar-width`).
+ *
+ * Schemes: light on `:root` (and on `.light`, `[data-theme="light"]`); dark by the system setting unless the page asks
+ * for light, and on `.dark`, `[data-theme="dark"]`, so `next-themes` and `@softure-ai/ui`'s theme switch both work,
+ * and a section can take a fixed scheme; Tailwind's `dark:` variant follows the same rule. Throws on a name that is not kebab-case, an unsafe value, or an alias of an
+ * undefined colour.
+ */
+export declare function buildThemeCss(definition: ThemeDefinition): string;
+//# sourceMappingURL=build-theme-css.d.ts.map

package/dist/build-theme-css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-theme-css.d.ts","sourceRoot":"","sources":["../src/build-theme-css.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAmF3E;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,CAYjE"}

package/dist/build-theme-css.js

@@ -0,0 +1,102 @@
+import { TOKEN_NAME, UNSAFE_VALUE } from "./check-theme.js";
+import { isColorAlias } from "./theme-definition.js";
+/** Light by default, and for an element or a page that asks for it. */
+const LIGHT_SELECTOR = ':root, .light, [data-theme="light"]';
+/** Dark by the system setting, unless the page asks for light. */
+const SYSTEM_DARK_SELECTOR = ':root:not(.light, [data-theme="light"])';
+/** Dark by choice: `next-themes` (`class="dark"`) or `@softure-ai/ui`'s theme switch (`data-theme="dark"`). */
+const DARK_SELECTOR = '.dark, [data-theme="dark"]';
+/**
+ * Tailwind's `dark:` variant on the same rule as the tokens: the system setting unless the page asks for light, or an
+ * explicit dark scope. Without it, `dark:` would follow only the system setting.
+ */
+const DARK_VARIANT = `@custom-variant dark {
+  @media (prefers-color-scheme: dark) {
+    &:where(${SYSTEM_DARK_SELECTOR}, ${SYSTEM_DARK_SELECTOR} *) {
+      @slot;
+    }
+  }
+  &:where(.dark, .dark *, [data-theme="dark"], [data-theme="dark"] *) {
+    @slot;
+  }
+}`;
+function checkName(kind, name) {
+    if (!TOKEN_NAME.test(name))
+        throw new Error(`buildThemeCss: ${kind} name "${name}" is not a lowercase kebab-case name`);
+    return name;
+}
+function checkValue(name, value) {
+    if (value.trim() === "" || UNSAFE_VALUE.test(value)) {
+        throw new Error(`buildThemeCss: value of "${name}" is empty or holds one of ; { } < > or a line break`);
+    }
+    return value;
+}
+function writeBlock(selector, lines, indent = "") {
+    return [`${indent}${selector} {`, ...lines.map((line) => `${indent}  ${line}`), `${indent}}`].join("\n");
+}
+function writeSchemeLines(definition, scheme) {
+    const colors = Object.entries(definition.colors).flatMap(([name, value]) => {
+        checkName("colour", name);
+        if (isColorAlias(value)) {
+            if (!(value.alias in definition.colors)) {
+                throw new Error(`buildThemeCss: colour "${name}" follows "${value.alias}", which the theme does not define`);
+            }
+            // An alias is a reference, so it follows its target's scheme without a dark line of its own.
+            return scheme === "light" ? [`--${name}: var(--${checkName("colour", value.alias)});`] : [];
+        }
+        return [`--${name}: ${checkValue(name, value[scheme])};`];
+    });
+    const shadows = Object.entries(definition.shadows).map(([name, value]) => `--shadow-${checkName("shadow", name)}: ${checkValue(`shadow-${name}`, value[scheme])};`);
+    return [...colors, ...shadows];
+}
+function writeThemeLines(definition) {
+    const lines = [];
+    if (definition.clearDefaultPalette)
+        lines.push("--color-*: initial;");
+    for (const name of Object.keys(definition.colors))
+        lines.push(`--color-${name}: var(--${name});`);
+    for (const [family, stack] of Object.entries(definition.fonts)) {
+        lines.push(`--font-${checkName("font", family)}: ${checkValue(`font-${family}`, stack)};`);
+    }
+    for (const [name, style] of Object.entries(definition.textStyles)) {
+        const prefix = `--text-${checkName("text style", name)}`;
+        lines.push(`${prefix}: ${checkValue(prefix, style.fontSize)};`);
+        lines.push(`${prefix}--line-height: ${checkValue(prefix, style.lineHeight)};`);
+        lines.push(`${prefix}--font-weight: ${String(style.fontWeight)};`);
+        if (style.letterSpacing !== undefined)
+            lines.push(`${prefix}--letter-spacing: ${checkValue(prefix, style.letterSpacing)};`);
+    }
+    for (const [step, value] of Object.entries(definition.radii)) {
+        lines.push(`--radius-${checkName("radius", step)}: ${checkValue(`radius-${step}`, value)};`);
+    }
+    // A themed shadow: the utility reads the scheme blocks' value, which the dark blocks switch.
+    for (const name of Object.keys(definition.shadows))
+        lines.push(`--shadow-${name}: var(--shadow-${name});`);
+    for (const [name, value] of Object.entries(definition.sizes)) {
+        lines.push(`--spacing-${checkName("size", name)}: ${checkValue(`spacing-${name}`, value)};`);
+    }
+    return lines;
+}
+/**
+ * The theme's CSS for Tailwind CSS v4: the tokens per scheme and the `@theme inline` block that turns them into
+ * utilities (`bg-background`, `text-page-title`, `rounded-xl`, `shadow-menu`, `w-sidebar-width`).
+ *
+ * Schemes: light on `:root` (and on `.light`, `[data-theme="light"]`); dark by the system setting unless the page asks
+ * for light, and on `.dark`, `[data-theme="dark"]`, so `next-themes` and `@softure-ai/ui`'s theme switch both work,
+ * and a section can take a fixed scheme; Tailwind's `dark:` variant follows the same rule. Throws on a name that is not kebab-case, an unsafe value, or an alias of an
+ * undefined colour.
+ */
+export function buildThemeCss(definition) {
+    const light = writeSchemeLines(definition, "light");
+    const dark = writeSchemeLines(definition, "dark");
+    return [
+        `/* Theme "${definition.name.replace(/\*\//g, "")}", generated by @softure-ai/theme-kit (buildThemeCss). */`,
+        DARK_VARIANT,
+        writeBlock(LIGHT_SELECTOR, light),
+        `@media (prefers-color-scheme: dark) {\n${writeBlock(SYSTEM_DARK_SELECTOR, dark, "  ")}\n}`,
+        writeBlock(DARK_SELECTOR, dark),
+        writeBlock("@theme inline", writeThemeLines(definition)),
+        "",
+    ].join("\n\n");
+}
+//# sourceMappingURL=build-theme-css.js.map

package/dist/build-theme-css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-theme-css.js","sourceRoot":"","sources":["../src/build-theme-css.ts"],"names":[],"mappings":"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"}

package/dist/check-theme.d.ts

@@ -0,0 +1,12 @@
+import { type ThemeDefinition } from "./theme-definition.js";
+/** A token name: lowercase kebab-case (`primary-hover`, `chart-1`). */
+export declare const TOKEN_NAME: RegExp;
+/** Characters that would end a CSS declaration or block, or open markup. */
+export declare const UNSAFE_VALUE: RegExp;
+/**
+ * Every way a definition breaks the theme contract, as readable messages; empty when the theme is complete. Checks the
+ * shadcn colour roles, that every token name is kebab-case, that no value is empty or could break out of the CSS, and
+ * that every alias points at a colour of the same theme.
+ */
+export declare function checkTheme(definition: ThemeDefinition): string[];
+//# sourceMappingURL=check-theme.d.ts.map

package/dist/check-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-theme.d.ts","sourceRoot":"","sources":["../src/check-theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAElG,uEAAuE;AACvE,eAAO,MAAM,UAAU,QAA+B,CAAC;AACvD,4EAA4E;AAC5E,eAAO,MAAM,YAAY,QAAgB,CAAC;AA+B1C;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,EAAE,CAoBhE"}

package/dist/check-theme.js

@@ -0,0 +1,46 @@
+import { findMissingColorRoles, isColorAlias } from "./theme-definition.js";
+/** A token name: lowercase kebab-case (`primary-hover`, `chart-1`). */
+export const TOKEN_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** Characters that would end a CSS declaration or block, or open markup. */
+export const UNSAFE_VALUE = /[;{}<>\r\n]/;
+function findNameProblems(kind, names) {
+    return names.filter((name) => !TOKEN_NAME.test(name)).map((name) => `${kind} name "${name}" is not a lowercase kebab-case name`);
+}
+function findValueProblems(entries) {
+    return entries
+        .filter(([, value]) => value.trim() === "" || UNSAFE_VALUE.test(value))
+        .map(([name]) => `value of "${name}" is empty or holds one of ; { } < > or a line break`);
+}
+function listValues(definition) {
+    const colors = Object.entries(definition.colors).flatMap(([name, value]) => isColorAlias(value) ? [] : [[name, value.light], [name, value.dark]]);
+    const shadows = Object.entries(definition.shadows).flatMap(([name, value]) => [
+        [`shadow-${name}`, value.light],
+        [`shadow-${name}`, value.dark],
+    ]);
+    const fonts = Object.entries(definition.fonts).map(([family, stack]) => [`font-${family}`, stack]);
+    const textStyles = Object.entries(definition.textStyles).flatMap(([name, style]) => [style.fontSize, style.lineHeight, ...(style.letterSpacing === undefined ? [] : [style.letterSpacing])].map((value) => [`text-${name}`, value]));
+    const radii = Object.entries(definition.radii).map(([step, value]) => [`radius-${step}`, value]);
+    const sizes = Object.entries(definition.sizes).map(([name, value]) => [`spacing-${name}`, value]);
+    return [...colors, ...shadows, ...fonts, ...textStyles, ...radii, ...sizes];
+}
+/**
+ * Every way a definition breaks the theme contract, as readable messages; empty when the theme is complete. Checks the
+ * shadcn colour roles, that every token name is kebab-case, that no value is empty or could break out of the CSS, and
+ * that every alias points at a colour of the same theme.
+ */
+export function checkTheme(definition) {
+    const problems = [];
+    if (definition.name.trim() === "")
+        problems.push("the theme has no name");
+    const missing = findMissingColorRoles(definition);
+    if (missing.length > 0)
+        problems.push(`missing shadcn colour roles: ${missing.join(", ")}`);
+    problems.push(...findNameProblems("colour", Object.keys(definition.colors)), ...findNameProblems("shadow", Object.keys(definition.shadows)), ...findNameProblems("font", Object.keys(definition.fonts)), ...findNameProblems("text style", Object.keys(definition.textStyles)), ...findNameProblems("radius", Object.keys(definition.radii)), ...findNameProblems("size", Object.keys(definition.sizes)), ...findValueProblems(listValues(definition)));
+    for (const [name, value] of Object.entries(definition.colors)) {
+        if (isColorAlias(value) && !(value.alias in definition.colors)) {
+            problems.push(`colour "${name}" follows "${value.alias}", which the theme does not define`);
+        }
+    }
+    return problems;
+}
+//# sourceMappingURL=check-theme.js.map

package/dist/check-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-theme.js","sourceRoot":"","sources":["../src/check-theme.ts"],"names":[],"mappings":"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"}