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

package/dist/cli/command.d.ts

@@ -0,0 +1,9 @@
+export interface ThemeCssCommandInput {
+    argv: readonly string[];
+    cwd: string;
+    write?: (line: string) => void;
+    writeError?: (line: string) => void;
+}
+/** `softure-theme-css [packageDir]`: builds a theme package's stylesheets; returns the exit code. */
+export declare function runThemeCssCommand({ argv, cwd, write, writeError, }: ThemeCssCommandInput): Promise<number>;
+//# sourceMappingURL=command.d.ts.map

package/dist/cli/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/cli/command.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAID,qGAAqG;AACrG,wBAAsB,kBAAkB,CAAC,EACvC,IAAI,EACJ,GAAG,EACH,KAAmC,EACnC,UAA0C,GAC3C,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAaxC"}

package/dist/cli/command.js

@@ -0,0 +1,19 @@
+import { resolve } from "node:path";
+import { buildThemePackage } from "../build/build-theme-package.js";
+const USAGE = "Usage: softure-theme-css [packageDir]   (default: the current folder, after tsc)";
+/** `softure-theme-css [packageDir]`: builds a theme package's stylesheets; returns the exit code. */
+export async function runThemeCssCommand({ argv, cwd, write = (line) => console.log(line), writeError = (line) => console.error(line), }) {
+    if (argv.length > 1 || argv[0] === "--help" || argv[0] === "-h") {
+        writeError(USAGE);
+        return argv.length > 1 ? 1 : 0;
+    }
+    const packageDir = resolve(cwd, argv[0] ?? ".");
+    const result = await buildThemePackage(packageDir);
+    if (!result.ok) {
+        writeError(`softure-theme-css: ${result.error}`);
+        return 1;
+    }
+    write(`softure-theme-css: ${result.files.join(", ")} in ${resolve(packageDir, "dist")}`);
+    return 0;
+}
+//# sourceMappingURL=command.js.map

package/dist/cli/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/cli/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AASpE,MAAM,KAAK,GAAG,kFAAkF,CAAC;AAEjG,qGAAqG;AACrG,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EACvC,IAAI,EACJ,GAAG,EACH,KAAK,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EACnC,UAAU,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GACrB;IACrB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAChE,UAAU,CAAC,KAAK,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,UAAU,CAAC,sBAAsB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACjD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,KAAK,CAAC,sBAAsB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACzF,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/create-cn.d.ts

@@ -0,0 +1,18 @@
+import { type ClassValue } from "clsx";
+import type { ThemeDefinition } from "./theme-definition.js";
+export type { ClassValue } from "clsx";
+export interface CnOptions {
+    /** The theme's named text styles, so `text-body` (a size) and `text-muted-foreground` (a colour) both stay. */
+    textStyles?: readonly string[];
+    /** The theme's named shadows, so a later `shadow-card` replaces an earlier `shadow-menu`. */
+    shadows?: readonly string[];
+}
+export type Cn = (...inputs: ClassValue[]) => string;
+/**
+ * shadcn/ui's `cn` for a theme: joins class names and lets a later Tailwind utility win over an earlier one of the
+ * same kind, knowing the theme's own text styles and shadows.
+ */
+export declare function createCn({ textStyles, shadows }?: CnOptions): Cn;
+/** `createCn` with the text styles and shadows a theme definition names. */
+export declare function createThemeCn(definition: Pick<ThemeDefinition, "textStyles" | "shadows">): Cn;
+//# sourceMappingURL=create-cn.d.ts.map

package/dist/create-cn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-cn.d.ts","sourceRoot":"","sources":["../src/create-cn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAG7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,YAAY,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAEvC,MAAM,WAAW,SAAS;IACxB,+GAA+G;IAC/G,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,6FAA6F;IAC7F,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,KAAK,MAAM,CAAC;AAErD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,EAAE,UAAe,EAAE,OAAY,EAAE,GAAE,SAAc,GAAG,EAAE,CAK9E;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,YAAY,GAAG,SAAS,CAAC,GAAG,EAAE,CAE7F"}

package/dist/create-cn.js

@@ -0,0 +1,17 @@
+import { clsx } from "clsx";
+import { extendTailwindMerge } from "tailwind-merge";
+/**
+ * shadcn/ui's `cn` for a theme: joins class names and lets a later Tailwind utility win over an earlier one of the
+ * same kind, knowing the theme's own text styles and shadows.
+ */
+export function createCn({ textStyles = [], shadows = [] } = {}) {
+    const mergeClasses = extendTailwindMerge({
+        extend: { theme: { text: [...textStyles], shadow: [...shadows] } },
+    });
+    return (...inputs) => mergeClasses(clsx(inputs));
+}
+/** `createCn` with the text styles and shadows a theme definition names. */
+export function createThemeCn(definition) {
+    return createCn({ textStyles: Object.keys(definition.textStyles), shadows: Object.keys(definition.shadows) });
+}
+//# sourceMappingURL=create-cn.js.map

package/dist/create-cn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-cn.js","sourceRoot":"","sources":["../src/create-cn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmB,MAAM,MAAM,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAerD;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAE,UAAU,GAAG,EAAE,EAAE,OAAO,GAAG,EAAE,KAAgB,EAAE;IACxE,MAAM,YAAY,GAAG,mBAAmB,CAAC;QACvC,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,EAAE;KACnE,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAAC,UAA2D;IACvF,OAAO,QAAQ,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAChH,CAAC"}

package/dist/define-theme.d.ts

@@ -0,0 +1,8 @@
+import type { ThemeDefinition } from "./theme-definition.js";
+/**
+ * Declares a theme: checks it against the contract (`checkTheme`) and returns it unchanged, with its literal types, so
+ * a broken theme fails where it is written, at import time, not when its CSS is generated. Throws with every problem
+ * listed.
+ */
+export declare function defineTheme<const T extends ThemeDefinition>(definition: T): T;
+//# sourceMappingURL=define-theme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-theme.d.ts","sourceRoot":"","sources":["../src/define-theme.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,CAAC,SAAS,eAAe,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAM7E"}

package/dist/define-theme.js

@@ -0,0 +1,14 @@
+import { checkTheme } from "./check-theme.js";
+/**
+ * Declares a theme: checks it against the contract (`checkTheme`) and returns it unchanged, with its literal types, so
+ * a broken theme fails where it is written, at import time, not when its CSS is generated. Throws with every problem
+ * listed.
+ */
+export function defineTheme(definition) {
+    const problems = checkTheme(definition);
+    if (problems.length > 0) {
+        throw new Error(`defineTheme: theme "${definition.name}" breaks the theme contract:\n- ${problems.join("\n- ")}`);
+    }
+    return definition;
+}
+//# sourceMappingURL=define-theme.js.map

package/dist/define-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-theme.js","sourceRoot":"","sources":["../src/define-theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAkC,UAAa;IACxE,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACxC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,uBAAuB,UAAU,CAAC,IAAI,mCAAmC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACpH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/extend-theme.d.ts

@@ -0,0 +1,20 @@
+import type { ThemeDefinition } from "./theme-definition.js";
+/** What a variant changes: a new name, and per token group only the tokens it adds or replaces. */
+export interface ThemeOverrides {
+    name: string;
+    colors?: ThemeDefinition["colors"];
+    shadows?: ThemeDefinition["shadows"];
+    fonts?: ThemeDefinition["fonts"];
+    textStyles?: ThemeDefinition["textStyles"];
+    radii?: ThemeDefinition["radii"];
+    sizes?: ThemeDefinition["sizes"];
+    clearDefaultPalette?: boolean;
+}
+/**
+ * A theme built on another: each token group of `overrides` is laid over the base's group (a token is replaced
+ * whole, never merged field by field), the rest is the base's. Used for a theme that differs from an existing one in
+ * a few tokens, and by an app that generates its own variant with `buildThemeCss`. The result is checked like
+ * `defineTheme`.
+ */
+export declare function extendTheme(base: ThemeDefinition, overrides: ThemeOverrides): ThemeDefinition;
+//# sourceMappingURL=extend-theme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extend-theme.d.ts","sourceRoot":"","sources":["../src/extend-theme.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,mGAAmG;AACnG,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IAC3C,KAAK,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IACjC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,cAAc,GAAG,eAAe,CAW7F"}

package/dist/extend-theme.js

@@ -0,0 +1,20 @@
+import { defineTheme } from "./define-theme.js";
+/**
+ * A theme built on another: each token group of `overrides` is laid over the base's group (a token is replaced
+ * whole, never merged field by field), the rest is the base's. Used for a theme that differs from an existing one in
+ * a few tokens, and by an app that generates its own variant with `buildThemeCss`. The result is checked like
+ * `defineTheme`.
+ */
+export function extendTheme(base, overrides) {
+    return defineTheme({
+        name: overrides.name,
+        colors: { ...base.colors, ...overrides.colors },
+        shadows: { ...base.shadows, ...overrides.shadows },
+        fonts: { ...base.fonts, ...overrides.fonts },
+        textStyles: { ...base.textStyles, ...overrides.textStyles },
+        radii: { ...base.radii, ...overrides.radii },
+        sizes: { ...base.sizes, ...overrides.sizes },
+        clearDefaultPalette: overrides.clearDefaultPalette ?? base.clearDefaultPalette,
+    });
+}
+//# sourceMappingURL=extend-theme.js.map

package/dist/extend-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extend-theme.js","sourceRoot":"","sources":["../src/extend-theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAehD;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAqB,EAAE,SAAyB;IAC1E,OAAO,WAAW,CAAC;QACjB,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,EAAE;QAC/C,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE;QAClD,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,SAAS,CAAC,KAAK,EAAE;QAC5C,UAAU,EAAE,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,SAAS,CAAC,UAAU,EAAE;QAC3D,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,SAAS,CAAC,KAAK,EAAE;QAC5C,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,SAAS,CAAC,KAAK,EAAE;QAC5C,mBAAmB,EAAE,SAAS,CAAC,mBAAmB,IAAI,IAAI,CAAC,mBAAmB;KAC/E,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { SHADCN_COLOR_ROLES, findMissingColorRoles, isColorAlias, type ColorAlias, type ColorValue, type SchemeValue, type ShadcnColorRole, type TextStyle, type ThemeDefinition, } from "./theme-definition.js";
+export { checkTheme } from "./check-theme.js";
+export { defineTheme } from "./define-theme.js";
+export { extendTheme, type ThemeOverrides } from "./extend-theme.js";
+export { buildThemeCss } from "./build-theme-css.js";
+export { createCn, createThemeCn, type ClassValue, type Cn, type CnOptions } from "./create-cn.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,EAAE,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { SHADCN_COLOR_ROLES, findMissingColorRoles, isColorAlias, } from "./theme-definition.js";
+export { checkTheme } from "./check-theme.js";
+export { defineTheme } from "./define-theme.js";
+export { extendTheme } from "./extend-theme.js";
+export { buildThemeCss } from "./build-theme-css.js";
+export { createCn, createThemeCn } from "./create-cn.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,GAOb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAuB,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAA4C,MAAM,gBAAgB,CAAC"}

package/dist/preflight.css

@@ -0,0 +1,77 @@
+/*
+ * Tailwind CSS v4's preflight, scoped to design-system elements: every shadcn/ui part carries `data-slot`, so a
+ * screen root with a `data-slot` brings the reset to everything inside it, while pages drawn by other packages (on
+ * `@softure-ai/ui`'s own base) keep theirs. Import it instead of Tailwind's `preflight.css` when the app mixes both;
+ * an app that is all design system can take Tailwind's full preflight instead.
+ *
+ * Reads `--border`, `--ring` and `--muted-foreground` from the theme. Also turns transitions and animations off under
+ * `prefers-reduced-motion`.
+ */
+@layer base {
+  :where([data-slot], [data-slot] *),
+  :where([data-slot], [data-slot] *)::before,
+  :where([data-slot], [data-slot] *)::after,
+  :where([data-slot], [data-slot] *)::backdrop {
+    box-sizing: border-box;
+    margin: 0;
+    padding: 0;
+    border: 0 solid var(--border);
+  }
+
+  :where([data-slot], [data-slot] *) {
+    outline-color: color-mix(in oklab, var(--ring) 50%, transparent);
+  }
+
+  :where(h1, h2, h3, h4, h5, h6):where([data-slot], [data-slot] *) {
+    font-size: inherit;
+    font-weight: inherit;
+  }
+
+  :where(a):where([data-slot], [data-slot] *) {
+    color: inherit;
+    text-decoration: inherit;
+  }
+
+  :where(ol, ul, menu):where([data-slot], [data-slot] *) {
+    list-style: none;
+  }
+
+  :where(img, svg, video, canvas):where([data-slot], [data-slot] *) {
+    display: block;
+    vertical-align: middle;
+  }
+
+  :where(table):where([data-slot], [data-slot] *) {
+    border-collapse: collapse;
+    text-indent: 0;
+  }
+
+  :where(button, input, select, optgroup, textarea):where([data-slot], [data-slot] *) {
+    font: inherit;
+    letter-spacing: inherit;
+    color: inherit;
+    background-color: transparent;
+    border-radius: 0;
+    opacity: 1;
+  }
+
+  :where(button, [role="button"]):where([data-slot], [data-slot] *):not(:disabled) {
+    cursor: pointer;
+  }
+
+  :where(textarea):where([data-slot], [data-slot] *) {
+    resize: vertical;
+  }
+
+  :where(::placeholder):where([data-slot], [data-slot] *) {
+    opacity: 1;
+    color: var(--muted-foreground);
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    :where([data-slot], [data-slot] *) {
+      transition-duration: 0s !important;
+      animation-duration: 0s !important;
+    }
+  }
+}

package/dist/react/index.d.ts

@@ -0,0 +1,2 @@
+export { MOBILE_BREAKPOINT, useIsMobile } from "./use-is-mobile.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,2 @@
+export { MOBILE_BREAKPOINT, useIsMobile } from "./use-is-mobile.js";
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/react/use-is-mobile.d.ts

@@ -0,0 +1,8 @@
+/** The width below which shadcn/ui's sidebar turns into a sheet. */
+export declare const MOBILE_BREAKPOINT = 768;
+/**
+ * Whether the viewport is narrower than `MOBILE_BREAKPOINT` (shadcn/ui's `useIsMobile`, read through
+ * `useSyncExternalStore` instead of a state set inside an effect).
+ */
+export declare function useIsMobile(): boolean;
+//# sourceMappingURL=use-is-mobile.d.ts.map

package/dist/react/use-is-mobile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-is-mobile.d.ts","sourceRoot":"","sources":["../../src/react/use-is-mobile.ts"],"names":[],"mappings":"AAEA,oEAAoE;AACpE,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAmBrC;;;GAGG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAErC"}

package/dist/react/use-is-mobile.js

@@ -0,0 +1,24 @@
+import * as React from "react";
+/** The width below which shadcn/ui's sidebar turns into a sheet. */
+export const MOBILE_BREAKPOINT = 768;
+const MOBILE_QUERY = `(max-width: ${MOBILE_BREAKPOINT - 1}px)`;
+function subscribeToViewport(onChange) {
+    const query = window.matchMedia(MOBILE_QUERY);
+    query.addEventListener("change", onChange);
+    return () => query.removeEventListener("change", onChange);
+}
+function isMobileViewport() {
+    return window.matchMedia(MOBILE_QUERY).matches;
+}
+// The server renders the desktop layout; the browser switches on hydration.
+function isMobileOnServer() {
+    return false;
+}
+/**
+ * Whether the viewport is narrower than `MOBILE_BREAKPOINT` (shadcn/ui's `useIsMobile`, read through
+ * `useSyncExternalStore` instead of a state set inside an effect).
+ */
+export function useIsMobile() {
+    return React.useSyncExternalStore(subscribeToViewport, isMobileViewport, isMobileOnServer);
+}
+//# sourceMappingURL=use-is-mobile.js.map

package/dist/react/use-is-mobile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-is-mobile.js","sourceRoot":"","sources":["../../src/react/use-is-mobile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,oEAAoE;AACpE,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAErC,MAAM,YAAY,GAAG,eAAe,iBAAiB,GAAG,CAAC,KAAK,CAAC;AAE/D,SAAS,mBAAmB,CAAC,QAAoB;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAC9C,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC3C,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,gBAAgB;IACvB,OAAO,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;AACjD,CAAC;AAED,4EAA4E;AAC5E,SAAS,gBAAgB;IACvB,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,KAAK,CAAC,oBAAoB,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;AAC7F,CAAC"}

package/dist/theme-definition.d.ts

@@ -0,0 +1,49 @@
+/** A colour or shadow with one value per colour scheme. */
+export interface SchemeValue {
+    light: string;
+    dark: string;
+}
+/** A colour that follows another token of the same theme in both schemes (`chart-1` → `blue`). */
+export interface ColorAlias {
+    alias: string;
+}
+export type ColorValue = SchemeValue | ColorAlias;
+/** A named text style: `text-<name>` sets the size, line height, weight and tracking at once. */
+export interface TextStyle {
+    fontSize: string;
+    lineHeight: string;
+    fontWeight: number;
+    letterSpacing?: string;
+}
+/**
+ * Everything a theme decides, as plain data. `buildThemeCss` turns it into the theme's CSS; a theme package keeps
+ * one definition and ships the generated file.
+ */
+export interface ThemeDefinition {
+    /** The theme's name, written into the generated file's header. */
+    name: string;
+    /** Colour tokens by name (`background`, `primary`, `green-tag`), utilities `bg-<name>`, `text-<name>`. */
+    colors: Record<string, ColorValue>;
+    /** Shadows by name without the prefix (`menu` → `--shadow-menu`, `shadow-menu`). */
+    shadows: Record<string, SchemeValue>;
+    /** Font stacks by family (`sans` → `font-sans`). */
+    fonts: Record<string, string>;
+    /** Named text styles (`page-title` → `text-page-title`). */
+    textStyles: Record<string, TextStyle>;
+    /** Radii by step (`md` → `rounded-md`). */
+    radii: Record<string, string>;
+    /** Layout sizes as spacing values (`sidebar-width` → `w-sidebar-width`). */
+    sizes: Record<string, string>;
+    /** Clears Tailwind's default palette, so only the theme's colours exist as utilities. */
+    clearDefaultPalette: boolean;
+}
+/**
+ * The colour roles shadcn/ui components read. Every theme defines them, so a component written for one theme renders
+ * in another; a theme adds its own tokens on top.
+ */
+export declare const SHADCN_COLOR_ROLES: readonly ["background", "foreground", "card", "card-foreground", "popover", "popover-foreground", "primary", "primary-foreground", "secondary", "secondary-foreground", "muted", "muted-foreground", "accent", "accent-foreground", "destructive", "border", "input", "ring", "chart-1", "chart-2", "chart-3", "chart-4", "chart-5", "sidebar", "sidebar-foreground", "sidebar-primary", "sidebar-primary-foreground", "sidebar-accent", "sidebar-accent-foreground", "sidebar-border", "sidebar-ring"];
+export type ShadcnColorRole = (typeof SHADCN_COLOR_ROLES)[number];
+/** The shadcn colour roles a definition lacks, in contract order; empty when it is complete. */
+export declare function findMissingColorRoles(definition: Pick<ThemeDefinition, "colors">): ShadcnColorRole[];
+export declare function isColorAlias(value: ColorValue): value is ColorAlias;
+//# sourceMappingURL=theme-definition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme-definition.d.ts","sourceRoot":"","sources":["../src/theme-definition.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,kGAAkG;AAClG,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;AAElD,iGAAiG;AACjG,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,0GAA0G;IAC1G,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,yFAAyF;IACzF,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,yeAgCrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,gGAAgG;AAChG,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,GAAG,eAAe,EAAE,CAEpG;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,IAAI,UAAU,CAEnE"}

package/dist/theme-definition.js

@@ -0,0 +1,45 @@
+/**
+ * The colour roles shadcn/ui components read. Every theme defines them, so a component written for one theme renders
+ * in another; a theme adds its own tokens on top.
+ */
+export const SHADCN_COLOR_ROLES = [
+    "background",
+    "foreground",
+    "card",
+    "card-foreground",
+    "popover",
+    "popover-foreground",
+    "primary",
+    "primary-foreground",
+    "secondary",
+    "secondary-foreground",
+    "muted",
+    "muted-foreground",
+    "accent",
+    "accent-foreground",
+    "destructive",
+    "border",
+    "input",
+    "ring",
+    "chart-1",
+    "chart-2",
+    "chart-3",
+    "chart-4",
+    "chart-5",
+    "sidebar",
+    "sidebar-foreground",
+    "sidebar-primary",
+    "sidebar-primary-foreground",
+    "sidebar-accent",
+    "sidebar-accent-foreground",
+    "sidebar-border",
+    "sidebar-ring",
+];
+/** The shadcn colour roles a definition lacks, in contract order; empty when it is complete. */
+export function findMissingColorRoles(definition) {
+    return SHADCN_COLOR_ROLES.filter((role) => !(role in definition.colors));
+}
+export function isColorAlias(value) {
+    return "alias" in value;
+}
+//# sourceMappingURL=theme-definition.js.map

package/dist/theme-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-definition.js","sourceRoot":"","sources":["../src/theme-definition.ts"],"names":[],"mappings":"AA4CA;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,YAAY;IACZ,YAAY;IACZ,MAAM;IACN,iBAAiB;IACjB,SAAS;IACT,oBAAoB;IACpB,SAAS;IACT,oBAAoB;IACpB,WAAW;IACX,sBAAsB;IACtB,OAAO;IACP,kBAAkB;IAClB,QAAQ;IACR,mBAAmB;IACnB,aAAa;IACb,QAAQ;IACR,OAAO;IACP,MAAM;IACN,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,oBAAoB;IACpB,iBAAiB;IACjB,4BAA4B;IAC5B,gBAAgB;IAChB,2BAA2B;IAC3B,gBAAgB;IAChB,cAAc;CACN,CAAC;AAIX,gGAAgG;AAChG,MAAM,UAAU,qBAAqB,CAAC,UAA2C;IAC/E,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAiB;IAC5C,OAAO,OAAO,IAAI,KAAK,CAAC;AAC1B,CAAC"}

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "@softure-ai/theme-kit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "SOFTURE AI theme kit: the theme contract (defineTheme), the theme CSS generator and build command, cn and the scoped preflight every shadcn/ui theme package shares.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": [
+    "*.css"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SOFTURE/AI.git",
+    "directory": "themes/theme-kit"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "CHANGELOG.md",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "bin": {
+    "softure-theme-css": "./bin/softure-theme-css.mjs"
+  },
+  "exports": {
+    ".": {
+      "@softure-ai/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "@softure-ai/source": "./src/react/index.ts",
+      "types": "./dist/react/index.d.ts",
+      "default": "./dist/react/index.js"
+    },
+    "./build": {
+      "@softure-ai/source": "./src/build/index.ts",
+      "types": "./dist/build/index.d.ts",
+      "default": "./dist/build/index.js"
+    },
+    "./preflight.css": "./dist/preflight.css"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node scripts/copy-css.mjs"
+  },
+  "dependencies": {
+    "clsx": "^2.1.1",
+    "tailwind-merge": "^3.7.0"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0"
+  }
+}

package/src/build/build-theme-package.ts

@@ -0,0 +1,45 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+
+import { checkTheme } from "../check-theme.js";
+import type { ThemeDefinition } from "../theme-definition.js";
+import { parseThemePackageConfig } from "./theme-package-config.js";
+import { writeThemeStylesheets } from "./theme-stylesheet.js";
+
+export type BuildResult = { ok: true; files: string[] } | { ok: false; error: string };
+
+const DEFINITION_GROUPS = ["colors", "shadows", "fonts", "textStyles", "radii", "sizes"] as const;
+
+/** A first, structural narrowing of the `theme` export; `checkTheme` then checks the values. */
+function isThemeDefinition(value: unknown): value is ThemeDefinition {
+  if (typeof value !== "object" || value === null) return false;
+  const record = value as Record<string, unknown>;
+  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: string): Promise<BuildResult> {
+  const manifest = JSON.parse(readFileSync(join(packageDir, "package.json"), "utf8")) as Record<string, unknown>;
+  const parsed = parseThemePackageConfig(manifest.softureTheme);
+  if (!parsed.ok) return parsed;
+  const tokensPath = join(packageDir, "dist", "tokens.js");
+  let tokens: Record<string, unknown>;
+  try {
+    tokens = (await import(pathToFileURL(tokensPath).href)) as Record<string, unknown>;
+  } 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 }) };
+}

package/src/build/index.ts

@@ -0,0 +1,9 @@
+// Node-only: the code that builds a theme package's stylesheets (`softure-theme-css`). Not for the browser bundle.
+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";

package/src/build/theme-package-config.ts

@@ -0,0 +1,46 @@
+/**
+ * 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 };
+
+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: Record<string, unknown>, key: keyof ThemePackageConfig, pattern: RegExp, hint: string): string[] | string {
+  const value = record[key] ?? [];
+  if (!Array.isArray(value)) return `"${key}" is not a list`;
+  const items: string[] = [];
+  for (const item of value as unknown[]) {
+    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: unknown): ConfigResult {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return { ok: false, error: "softureTheme: missing, or not an object" };
+  }
+  const record = value as Record<string, unknown>;
+  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 as string[], imports: imports as string[], stylesheets: stylesheets as string[] } };
+}