@baseplate-dev/project-builder-lib 0.3.7 → 0.4.0

package/dist/schema/{settings.d.ts → settings/settings.d.ts}

@@ -1,41 +1,21 @@
 import { z } from 'zod';
-export declare const generalSettingsSchema: z.ZodObject<{
+/**
+ * Complete project settings schema
+ *
+ * Combines all settings categories:
+ * - general: Project name, scope, and port configuration
+ * - infrastructure: Infrastructure services (Postgres, Redis)
+ * - monorepo: Monorepo folder configuration (optional)
+ * - templateExtractor: Template extraction configuration (optional)
+ * - theme: UI theme and color palette configuration (optional)
+ */
+export declare const createSettingsSchema: (context: import("../index.js").DefinitionSchemaParserContext) => z.ZodObject<{
     /**
-     * The name of the project.
+     * General project settings (required)
      */
-    name: z.ZodString;
-    /**
-     * The package scope of the project if any e.g. halfdomelabs for @baseplate-dev/package-name.
-     */
-    packageScope: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<"">, z.ZodString]>>;
-    /**
-     * The port offset to base the app ports on for development (e.g. 8000 => 8432 for DB).
-     */
-    portOffset: z.ZodEffects<z.ZodNumber, number, number>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    packageScope: string;
-    portOffset: number;
-}, {
-    name: string;
-    portOffset: number;
-    packageScope?: string | undefined;
-}>;
-export type GeneralSettingsInput = z.input<typeof generalSettingsSchema>;
-export type GeneralSettingsDefinition = z.output<typeof generalSettingsSchema>;
-export declare const createSettingsSchema: (context: import("./index.js").DefinitionSchemaParserContext) => z.ZodObject<{
     general: z.ZodObject<{
-        /**
-         * The name of the project.
-         */
         name: z.ZodString;
-        /**
-         * The package scope of the project if any e.g. halfdomelabs for @baseplate-dev/package-name.
-         */
         packageScope: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<"">, z.ZodString]>>;
-        /**
-         * The port offset to base the app ports on for development (e.g. 8000 => 8432 for DB).
-         */
         portOffset: z.ZodEffects<z.ZodNumber, number, number>;
     }, "strip", z.ZodTypeAny, {
         name: string;
@@ -46,6 +26,48 @@ export declare const createSettingsSchema: (context: import("./index.js").Defini
         portOffset: number;
         packageScope?: string | undefined;
     }>;
+    /**
+     * Infrastructure settings (optional)
+     *
+     * Configures infrastructure services like Postgres and Redis.
+     * When omitted, uses default configuration (Postgres enabled, Redis disabled).
+     */
+    infrastructure: z.ZodOptional<z.ZodObject<{
+        redis: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+        }, {
+            enabled?: boolean | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        redis?: {
+            enabled: boolean;
+        } | undefined;
+    }, {
+        redis?: {
+            enabled?: boolean | undefined;
+        } | undefined;
+    }>>;
+    /**
+     * Monorepo configuration (optional)
+     *
+     * Configures the folder structure for monorepo packages.
+     * When omitted, uses default folder structure (apps/*).
+     */
+    monorepo: z.ZodOptional<z.ZodObject<{
+        appsFolder: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        appsFolder: string;
+    }, {
+        appsFolder?: string | undefined;
+    }>>;
+    /**
+     * Template extractor configuration (optional)
+     *
+     * Controls how template extraction works when syncing projects.
+     * Only needed when developing generators or extracting templates.
+     */
     templateExtractor: z.ZodOptional<z.ZodObject<{
         writeMetadata: z.ZodDefault<z.ZodBoolean>;
         fileIdRegexWhitelist: z.ZodDefault<z.ZodString>;
@@ -56,6 +78,12 @@ export declare const createSettingsSchema: (context: import("./index.js").Defini
         writeMetadata?: boolean | undefined;
         fileIdRegexWhitelist?: string | undefined;
     }>>;
+    /**
+     * Theme configuration (optional)
+     *
+     * Defines color palettes and semantic color mappings for the UI.
+     * When omitted, uses default theme configuration.
+     */
     theme: z.ZodOptional<z.ZodObject<{
         palettes: z.ZodObject<{
             base: z.ZodEffects<z.ZodObject<{
@@ -174,6 +202,14 @@ export declare const createSettingsSchema: (context: import("./index.js").Defini
         packageScope: string;
         portOffset: number;
     };
+    infrastructure?: {
+        redis?: {
+            enabled: boolean;
+        } | undefined;
+    } | undefined;
+    monorepo?: {
+        appsFolder: string;
+    } | undefined;
     templateExtractor?: {
         writeMetadata: boolean;
         fileIdRegexWhitelist: string;
@@ -202,6 +238,14 @@ export declare const createSettingsSchema: (context: import("./index.js").Defini
         portOffset: number;
         packageScope?: string | undefined;
     };
+    infrastructure?: {
+        redis?: {
+            enabled?: boolean | undefined;
+        } | undefined;
+    } | undefined;
+    monorepo?: {
+        appsFolder?: string | undefined;
+    } | undefined;
     templateExtractor?: {
         writeMetadata?: boolean | undefined;
         fileIdRegexWhitelist?: string | undefined;

package/dist/schema/settings/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../../src/schema/settings/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB;IAE7B;;OAEG;;;;;;;;;;;;;;IAGH;;;;;OAKG;;;;;;;;;;;;;;;;;;IAGH;;;;;OAKG;;;;;;;;IAGH;;;;;OAKG;;;;;;;;;;;IAGH;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGN,CAAC"}

package/dist/schema/settings/settings.js

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+import { definitionSchema } from '#src/schema/creator/schema-creator.js';
+import { generalSettingsSchema } from './general.js';
+import { infrastructureSettingsSchema } from './infrastructure.js';
+import { monorepoSettingsSchema } from './monorepo.js';
+import { createTemplateExtractorSchema } from './template-extractor.js';
+import { createThemeSchema } from './theme.js';
+/**
+ * Complete project settings schema
+ *
+ * Combines all settings categories:
+ * - general: Project name, scope, and port configuration
+ * - infrastructure: Infrastructure services (Postgres, Redis)
+ * - monorepo: Monorepo folder configuration (optional)
+ * - templateExtractor: Template extraction configuration (optional)
+ * - theme: UI theme and color palette configuration (optional)
+ */
+export const createSettingsSchema = definitionSchema((ctx) => z.object({
+    /**
+     * General project settings (required)
+     */
+    general: generalSettingsSchema,
+    /**
+     * Infrastructure settings (optional)
+     *
+     * Configures infrastructure services like Postgres and Redis.
+     * When omitted, uses default configuration (Postgres enabled, Redis disabled).
+     */
+    infrastructure: infrastructureSettingsSchema.optional(),
+    /**
+     * Monorepo configuration (optional)
+     *
+     * Configures the folder structure for monorepo packages.
+     * When omitted, uses default folder structure (apps/*).
+     */
+    monorepo: monorepoSettingsSchema.optional(),
+    /**
+     * Template extractor configuration (optional)
+     *
+     * Controls how template extraction works when syncing projects.
+     * Only needed when developing generators or extracting templates.
+     */
+    templateExtractor: createTemplateExtractorSchema(ctx).optional(),
+    /**
+     * Theme configuration (optional)
+     *
+     * Defines color palettes and semantic color mappings for the UI.
+     * When omitted, uses default theme configuration.
+     */
+    theme: createThemeSchema(ctx).optional(),
+}));
+//# sourceMappingURL=settings.js.map

package/dist/schema/settings/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../../src/schema/settings/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,CAAC,GAAG,EAAE,EAAE,CAC3D,CAAC,CAAC,MAAM,CAAC;IACP;;OAEG;IACH,OAAO,EAAE,qBAAqB;IAE9B;;;;;OAKG;IACH,cAAc,EAAE,4BAA4B,CAAC,QAAQ,EAAE;IAEvD;;;;;OAKG;IACH,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,EAAE;IAE3C;;;;;OAKG;IACH,iBAAiB,EAAE,6BAA6B,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAEhE;;;;;OAKG;IACH,KAAK,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;CACzC,CAAC,CACH,CAAC"}

package/dist/schema/settings/template-extractor.d.ts

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+import type { def } from '../creator/index.js';
+/**
+ * Template extractor configuration schema
+ *
+ * Controls how template extraction works when syncing projects.
+ * Template extraction allows updating generator templates from working code.
+ */
+export declare const createTemplateExtractorSchema: (context: import("../creator/types.js").DefinitionSchemaParserContext) => z.ZodObject<{
+    /**
+     * Whether to write template extractor metadata when writing files to the project.
+     *
+     * When enabled, Baseplate will write `.templates-info.json` files that track
+     * which generated files correspond to which templates. This metadata enables
+     * the template extraction process to update the generator's templates from
+     * your working code.
+     *
+     * Useful for: Generator development, template refinement, extracting patterns
+     * Default: false
+     */
+    writeMetadata: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * A list of file IDs to include in the template extractor metadata.
+     *
+     * Used for generators that have manually assigned file IDs, particularly
+     * generators with multiple instances (e.g. one generator per model).
+     *
+     * Format: Newline-delimited list of patterns
+     * Supports wildcards: Use * to match any number of characters
+     *
+     * Example:
+     * ```
+     * user-*
+     * post-*
+     * comment-service-*
+     * ```
+     *
+     * Default: empty string (no file ID whitelist)
+     */
+    fileIdRegexWhitelist: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    writeMetadata: boolean;
+    fileIdRegexWhitelist: string;
+}, {
+    writeMetadata?: boolean | undefined;
+    fileIdRegexWhitelist?: string | undefined;
+}>;
+/**
+ * Template extractor configuration type (output after validation)
+ */
+export type TemplateExtractorDefinition = def.InferOutput<typeof createTemplateExtractorSchema>;
+//# sourceMappingURL=template-extractor.d.ts.map

package/dist/schema/settings/template-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-extractor.d.ts","sourceRoot":"","sources":["../../../src/schema/settings/template-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B;IAEtC;;;;;;;;;;OAUG;;IAGH;;;;;;;;;;;;;;;;;OAiBG;;;;;;;;EAGN,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,GAAG,CAAC,WAAW,CACvD,OAAO,6BAA6B,CACrC,CAAC"}

package/dist/schema/settings/template-extractor.js

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import { definitionSchema } from '#src/schema/creator/schema-creator.js';
+/**
+ * Template extractor configuration schema
+ *
+ * Controls how template extraction works when syncing projects.
+ * Template extraction allows updating generator templates from working code.
+ */
+export const createTemplateExtractorSchema = definitionSchema(() => z.object({
+    /**
+     * Whether to write template extractor metadata when writing files to the project.
+     *
+     * When enabled, Baseplate will write `.templates-info.json` files that track
+     * which generated files correspond to which templates. This metadata enables
+     * the template extraction process to update the generator's templates from
+     * your working code.
+     *
+     * Useful for: Generator development, template refinement, extracting patterns
+     * Default: false
+     */
+    writeMetadata: z.boolean().default(false),
+    /**
+     * A list of file IDs to include in the template extractor metadata.
+     *
+     * Used for generators that have manually assigned file IDs, particularly
+     * generators with multiple instances (e.g. one generator per model).
+     *
+     * Format: Newline-delimited list of patterns
+     * Supports wildcards: Use * to match any number of characters
+     *
+     * Example:
+     * ```
+     * user-*
+     * post-*
+     * comment-service-*
+     * ```
+     *
+     * Default: empty string (no file ID whitelist)
+     */
+    fileIdRegexWhitelist: z.string().default(''),
+}));
+//# sourceMappingURL=template-extractor.js.map

package/dist/schema/settings/template-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-extractor.js","sourceRoot":"","sources":["../../../src/schema/settings/template-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAIzE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,gBAAgB,CAAC,GAAG,EAAE,CACjE,CAAC,CAAC,MAAM,CAAC;IACP;;;;;;;;;;OAUG;IACH,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAEzC;;;;;;;;;;;;;;;;;OAiBG;IACH,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CAC7C,CAAC,CACH,CAAC"}

package/dist/schema/{features → settings}/theme.d.ts

@@ -1,13 +1,53 @@
 import { z } from 'zod';
 import type { PaletteShade } from '#src/constants/colors.js';
 import type { def } from '#src/schema/creator/index.js';
+/**
+ * OKLCH color format validator
+ *
+ * OKLCH is a perceptually uniform color space that provides better color manipulation than RGB/HEX.
+ * Format: oklch(l c h [/ a]) where:
+ * - l (lightness): 0-1
+ * - c (chroma): 0-1
+ * - h (hue): 0-360
+ * - a (alpha, optional): 0-100
+ *
+ * Example: "oklch(0.5 0.2 180)" or "oklch(0.5 0.2 180 / 50)"
+ */
 export declare const oklchColor: z.ZodString;
+/**
+ * Theme color configuration
+ *
+ * Maps semantic color keys (e.g. "background", "foreground", "primary") to OKLCH color values.
+ */
 export declare const themeColorSchema: z.ZodRecord<z.ZodEnum<["link" | "success" | "background" | "foreground" | "muted" | "mutedForeground" | "card" | "cardForeground" | "popover" | "popoverForeground" | "accent" | "accentForeground" | "successForeground" | "warning" | "warningForeground" | "error" | "errorForeground" | "primary" | "primaryHover" | "primaryForeground" | "secondary" | "secondaryHover" | "secondaryForeground" | "destructive" | "destructiveHover" | "destructiveForeground" | "linkVisited" | "border" | "input" | "ring", ...("link" | "success" | "background" | "foreground" | "muted" | "mutedForeground" | "card" | "cardForeground" | "popover" | "popoverForeground" | "accent" | "accentForeground" | "successForeground" | "warning" | "warningForeground" | "error" | "errorForeground" | "primary" | "primaryHover" | "primaryForeground" | "secondary" | "secondaryHover" | "secondaryForeground" | "destructive" | "destructiveHover" | "destructiveForeground" | "linkVisited" | "border" | "input" | "ring")[]]>, z.ZodString>;
+/**
+ * Theme colors configuration type
+ */
 export type ThemeColorsConfig = z.infer<typeof themeColorSchema>;
+/**
+ * Palette shades type - maps shade names to OKLCH colors
+ */
 export type PaletteShades = Record<PaletteShade, string>;
+/**
+ * Palette configuration schema
+ *
+ * Defines a color palette with a base color and generated shades.
+ * Palettes can use predefined bases (zinc, slate, etc.) or a custom base color.
+ */
 export declare const paletteSchema: z.ZodEffects<z.ZodObject<{
+    /**
+     * Name of the palette base (e.g. "zinc", "slate") or "custom" for custom base color
+     */
     paletteName: z.ZodString;
+    /**
+     * Custom base color in OKLCH format.
+     * Required when paletteName is "custom", ignored otherwise.
+     */
     customBase: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /**
+     * Generated color shades (50, 100, 200, ..., 950)
+     * Automatically computed from the base color
+     */
     shades: z.ZodRecord<z.ZodEnum<["50", "100", "200", "300", "400", "500", "600", "700", "800", "900", "950"]>, z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     paletteName: string;
@@ -26,10 +66,29 @@ export declare const paletteSchema: z.ZodEffects<z.ZodObject<{
     shades: Partial<Record<"50" | "100" | "200" | "300" | "400" | "500" | "600" | "700" | "800" | "900" | "950", string>>;
     customBase?: string | null | undefined;
 }>;
+/**
+ * Palettes configuration schema
+ *
+ * Defines base (neutral colors) and primary (brand colors) palettes
+ */
 export declare const palettesSchema: z.ZodObject<{
+    /**
+     * Base palette used for neutral colors (backgrounds, borders, text)
+     */
     base: z.ZodEffects<z.ZodObject<{
+        /**
+         * Name of the palette base (e.g. "zinc", "slate") or "custom" for custom base color
+         */
         paletteName: z.ZodString;
+        /**
+         * Custom base color in OKLCH format.
+         * Required when paletteName is "custom", ignored otherwise.
+         */
         customBase: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /**
+         * Generated color shades (50, 100, 200, ..., 950)
+         * Automatically computed from the base color
+         */
         shades: z.ZodRecord<z.ZodEnum<["50", "100", "200", "300", "400", "500", "600", "700", "800", "900", "950"]>, z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         paletteName: string;
@@ -48,9 +107,23 @@ export declare const palettesSchema: z.ZodObject<{
         shades: Partial<Record<"50" | "100" | "200" | "300" | "400" | "500" | "600" | "700" | "800" | "900" | "950", string>>;
         customBase?: string | null | undefined;
     }>;
+    /**
+     * Primary palette used for brand colors (buttons, links, highlights)
+     */
     primary: z.ZodEffects<z.ZodObject<{
+        /**
+         * Name of the palette base (e.g. "zinc", "slate") or "custom" for custom base color
+         */
         paletteName: z.ZodString;
+        /**
+         * Custom base color in OKLCH format.
+         * Required when paletteName is "custom", ignored otherwise.
+         */
         customBase: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /**
+         * Generated color shades (50, 100, 200, ..., 950)
+         * Automatically computed from the base color
+         */
         shades: z.ZodRecord<z.ZodEnum<["50", "100", "200", "300", "400", "500", "600", "700", "800", "900", "950"]>, z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         paletteName: string;
@@ -92,12 +165,34 @@ export declare const palettesSchema: z.ZodObject<{
         customBase?: string | null | undefined;
     };
 }>;
+/**
+ * Palettes configuration type
+ */
 export type PalettesConfig = z.infer<typeof palettesSchema>;
+/**
+ * Theme configuration schema
+ *
+ * Defines the complete theme including palettes and semantic color mappings for light and dark modes.
+ */
 export declare const createThemeSchema: (context: import("#src/schema/creator/index.js").DefinitionSchemaParserContext) => z.ZodObject<{
+    /**
+     * Color palettes for base and primary colors
+     */
     palettes: z.ZodObject<{
         base: z.ZodEffects<z.ZodObject<{
+            /**
+             * Name of the palette base (e.g. "zinc", "slate") or "custom" for custom base color
+             */
             paletteName: z.ZodString;
+            /**
+             * Custom base color in OKLCH format.
+             * Required when paletteName is "custom", ignored otherwise.
+             */
             customBase: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            /**
+             * Generated color shades (50, 100, 200, ..., 950)
+             * Automatically computed from the base color
+             */
             shades: z.ZodRecord<z.ZodEnum<["50", "100", "200", "300", "400", "500", "600", "700", "800", "900", "950"]>, z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             paletteName: string;
@@ -117,8 +212,19 @@ export declare const createThemeSchema: (context: import("#src/schema/creator/in
             customBase?: string | null | undefined;
         }>;
         primary: z.ZodEffects<z.ZodObject<{
+            /**
+             * Name of the palette base (e.g. "zinc", "slate") or "custom" for custom base color
+             */
             paletteName: z.ZodString;
+            /**
+             * Custom base color in OKLCH format.
+             * Required when paletteName is "custom", ignored otherwise.
+             */
             customBase: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            /**
+             * Generated color shades (50, 100, 200, ..., 950)
+             * Automatically computed from the base color
+             */
             shades: z.ZodRecord<z.ZodEnum<["50", "100", "200", "300", "400", "500", "600", "700", "800", "900", "950"]>, z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             paletteName: string;
@@ -160,8 +266,17 @@ export declare const createThemeSchema: (context: import("#src/schema/creator/in
             customBase?: string | null | undefined;
         };
     }>;
+    /**
+     * Semantic color mappings for light and dark modes
+     */
     colors: z.ZodObject<{
+        /**
+         * Light mode color mappings
+         */
         light: z.ZodRecord<z.ZodEnum<["link" | "success" | "background" | "foreground" | "muted" | "mutedForeground" | "card" | "cardForeground" | "popover" | "popoverForeground" | "accent" | "accentForeground" | "successForeground" | "warning" | "warningForeground" | "error" | "errorForeground" | "primary" | "primaryHover" | "primaryForeground" | "secondary" | "secondaryHover" | "secondaryForeground" | "destructive" | "destructiveHover" | "destructiveForeground" | "linkVisited" | "border" | "input" | "ring", ...("link" | "success" | "background" | "foreground" | "muted" | "mutedForeground" | "card" | "cardForeground" | "popover" | "popoverForeground" | "accent" | "accentForeground" | "successForeground" | "warning" | "warningForeground" | "error" | "errorForeground" | "primary" | "primaryHover" | "primaryForeground" | "secondary" | "secondaryHover" | "secondaryForeground" | "destructive" | "destructiveHover" | "destructiveForeground" | "linkVisited" | "border" | "input" | "ring")[]]>, z.ZodString>;
+        /**
+         * Dark mode color mappings
+         */
         dark: z.ZodRecord<z.ZodEnum<["link" | "success" | "background" | "foreground" | "muted" | "mutedForeground" | "card" | "cardForeground" | "popover" | "popoverForeground" | "accent" | "accentForeground" | "successForeground" | "warning" | "warningForeground" | "error" | "errorForeground" | "primary" | "primaryHover" | "primaryForeground" | "secondary" | "secondaryHover" | "secondaryForeground" | "destructive" | "destructiveHover" | "destructiveForeground" | "linkVisited" | "border" | "input" | "ring", ...("link" | "success" | "background" | "foreground" | "muted" | "mutedForeground" | "card" | "cardForeground" | "popover" | "popoverForeground" | "accent" | "accentForeground" | "successForeground" | "warning" | "warningForeground" | "error" | "errorForeground" | "primary" | "primaryHover" | "primaryForeground" | "secondary" | "secondaryHover" | "secondaryForeground" | "destructive" | "destructiveHover" | "destructiveForeground" | "linkVisited" | "border" | "input" | "ring")[]]>, z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         light: Partial<Record<"link" | "success" | "background" | "foreground" | "muted" | "mutedForeground" | "card" | "cardForeground" | "popover" | "popoverForeground" | "accent" | "accentForeground" | "successForeground" | "warning" | "warningForeground" | "error" | "errorForeground" | "primary" | "primaryHover" | "primaryForeground" | "secondary" | "secondaryHover" | "secondaryForeground" | "destructive" | "destructiveHover" | "destructiveForeground" | "linkVisited" | "border" | "input" | "ring", string>>;
@@ -205,5 +320,8 @@ export declare const createThemeSchema: (context: import("#src/schema/creator/in
         dark: Partial<Record<"link" | "success" | "background" | "foreground" | "muted" | "mutedForeground" | "card" | "cardForeground" | "popover" | "popoverForeground" | "accent" | "accentForeground" | "successForeground" | "warning" | "warningForeground" | "error" | "errorForeground" | "primary" | "primaryHover" | "primaryForeground" | "secondary" | "secondaryHover" | "secondaryForeground" | "destructive" | "destructiveHover" | "destructiveForeground" | "linkVisited" | "border" | "input" | "ring", string>>;
     };
 }>;
+/**
+ * Theme configuration type (output after validation)
+ */
 export type ThemeConfig = def.InferOutput<typeof createThemeSchema>;
 //# sourceMappingURL=theme.d.ts.map

package/dist/schema/settings/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/schema/settings/theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,8BAA8B,CAAC;AAMxD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,aAQpB,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,w+BAG5B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,aAAa;IAEtB;;OAEG;;IAGH;;;OAGG;;IAGH;;;OAGG;;;;;;;;;;;;;;;;;;EAMH,CAAC;AAEL;;;;GAIG;AACH,eAAO,MAAM,cAAc;IACzB;;OAEG;;QA9BD;;WAEG;;QAGH;;;WAGG;;QAGH;;;WAGG;;;;;;;;;;;;;;;;;;;IAmBL;;OAEG;;QAnCD;;WAEG;;QAGH;;;WAGG;;QAGH;;;WAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuBL,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;IAE1B;;OAEG;;;YArDH;;eAEG;;YAGH;;;eAGG;;YAGH;;;eAGG;;;;;;;;;;;;;;;;;;;;YAdH;;eAEG;;YAGH;;;eAGG;;YAGH;;;eAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA6CH;;OAEG;;QAED;;WAEG;;QAGH;;WAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIR,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/schema/settings/theme.js

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+import { PALETTE_SHADES } from '#src/constants/colors.js';
+import { THEME_COLOR_KEYS } from '#src/constants/theme-colors.js';
+import { definitionSchema } from '#src/schema/creator/schema-creator.js';
+/**
+ * OKLCH color format validator
+ *
+ * OKLCH is a perceptually uniform color space that provides better color manipulation than RGB/HEX.
+ * Format: oklch(l c h [/ a]) where:
+ * - l (lightness): 0-1
+ * - c (chroma): 0-1
+ * - h (hue): 0-360
+ * - a (alpha, optional): 0-100
+ *
+ * Example: "oklch(0.5 0.2 180)" or "oklch(0.5 0.2 180 / 50)"
+ */
+export const oklchColor = z
+    .string()
+    .regex(/^oklch\(\s*([\d.]+)\s+([\d.]+)\s+([\d.]+)(?:\s*\/\s*([\d.]+))?\s*\)$/, {
+    message: 'OKLCH color must be of the format "oklch(l c h [/ a])" where l and c are between 0 and 1 and h is between 0 and 360 and a is between 0 and 100',
+});
+/**
+ * Theme color configuration
+ *
+ * Maps semantic color keys (e.g. "background", "foreground", "primary") to OKLCH color values.
+ */
+export const themeColorSchema = z.record(z.enum(THEME_COLOR_KEYS), oklchColor);
+/**
+ * Palette configuration schema
+ *
+ * Defines a color palette with a base color and generated shades.
+ * Palettes can use predefined bases (zinc, slate, etc.) or a custom base color.
+ */
+export const paletteSchema = z
+    .object({
+    /**
+     * Name of the palette base (e.g. "zinc", "slate") or "custom" for custom base color
+     */
+    paletteName: z.string().min(1),
+    /**
+     * Custom base color in OKLCH format.
+     * Required when paletteName is "custom", ignored otherwise.
+     */
+    customBase: oklchColor.nullish(),
+    /**
+     * Generated color shades (50, 100, 200, ..., 950)
+     * Automatically computed from the base color
+     */
+    shades: z.record(z.enum(PALETTE_SHADES), oklchColor),
+})
+    .refine((data) => data.paletteName !== 'custom' || !!data.customBase, {
+    message: 'A custom base color is required if using a custom base palette',
+    path: ['customBase'],
+});
+/**
+ * Palettes configuration schema
+ *
+ * Defines base (neutral colors) and primary (brand colors) palettes
+ */
+export const palettesSchema = z.object({
+    /**
+     * Base palette used for neutral colors (backgrounds, borders, text)
+     */
+    base: paletteSchema,
+    /**
+     * Primary palette used for brand colors (buttons, links, highlights)
+     */
+    primary: paletteSchema,
+});
+/**
+ * Theme configuration schema
+ *
+ * Defines the complete theme including palettes and semantic color mappings for light and dark modes.
+ */
+export const createThemeSchema = definitionSchema(() => z.object({
+    /**
+     * Color palettes for base and primary colors
+     */
+    palettes: z.object({
+        base: paletteSchema,
+        primary: paletteSchema,
+    }),
+    /**
+     * Semantic color mappings for light and dark modes
+     */
+    colors: z.object({
+        /**
+         * Light mode color mappings
+         */
+        light: themeColorSchema,
+        /**
+         * Dark mode color mappings
+         */
+        dark: themeColorSchema,
+    }),
+}));
+//# sourceMappingURL=theme.js.map

package/dist/schema/settings/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../../src/schema/settings/theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAEzE;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC;KACxB,MAAM,EAAE;KACR,KAAK,CACJ,sEAAsE,EACtE;IACE,OAAO,EACL,gJAAgJ;CACnJ,CACF,CAAC;AAEJ;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CACtC,CAAC,CAAC,IAAI,CAAC,gBAAuD,CAAC,EAC/D,UAAU,CACX,CAAC;AAYF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN;;OAEG;IACH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAE9B;;;OAGG;IACH,UAAU,EAAE,UAAU,CAAC,OAAO,EAAE;IAEhC;;;OAGG;IACH,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC;CACrD,CAAC;KACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE;IACpE,OAAO,EAAE,gEAAgE;IACzE,IAAI,EAAE,CAAC,YAAY,CAAC;CACrB,CAAC,CAAC;AAEL;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC;;OAEG;IACH,IAAI,EAAE,aAAa;IAEnB;;OAEG;IACH,OAAO,EAAE,aAAa;CACvB,CAAC,CAAC;AAOH;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,GAAG,EAAE,CACrD,CAAC,CAAC,MAAM,CAAC;IACP;;OAEG;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,aAAa;KACvB,CAAC;IAEF;;OAEG;IACH,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf;;WAEG;QACH,KAAK,EAAE,gBAAgB;QAEvB;;WAEG;QACH,IAAI,EAAE,gBAAgB;KACvB,CAAC;CACH,CAAC,CACH,CAAC"}

package/dist/utils/theme.d.ts

@@ -1,5 +1,5 @@
 import type { ThemeColorKey } from '#src/constants/theme-colors.js';
-import type { PalettesConfig, ThemeColorsConfig, ThemeConfig } from '#src/schema/features/theme.js';
+import type { PalettesConfig, ThemeColorsConfig, ThemeConfig } from '#src/schema/settings/theme.js';
 export declare function getDefaultThemeColorFromShade(palettes: PalettesConfig, mode: 'light' | 'dark', themeColorKey: ThemeColorKey): string | undefined;
 export declare function generateThemeColorsFromShade(palettes: PalettesConfig, mode: 'light' | 'dark', previousValues?: {
     palettes: PalettesConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baseplate-dev/project-builder-lib",
-  "version": "0.3.7",
+  "version": "0.4.0",
   "description": "Library for Project Builder using Baseplate generators",
   "keywords": [
     "configuration",
@@ -47,9 +47,9 @@
     "react-hook-form": "7.60.0",
     "zod": "3.25.76",
     "zustand": "5.0.3",
-    "@baseplate-dev/sync": "0.3.7",
-    "@baseplate-dev/ui-components": "0.3.7",
-    "@baseplate-dev/utils": "0.3.7"
+    "@baseplate-dev/sync": "0.4.0",
+    "@baseplate-dev/ui-components": "0.4.0",
+    "@baseplate-dev/utils": "0.4.0"
   },
   "devDependencies": {
     "@faker-js/faker": "9.8.0",
@@ -61,9 +61,9 @@
     "prettier": "3.6.2",
     "type-fest": "4.41.0",
     "typescript": "5.8.3",
-    "vite": "7.1.5",
+    "vite": "7.1.12",
     "vitest": "3.2.4",
-    "@baseplate-dev/tools": "0.3.7"
+    "@baseplate-dev/tools": "0.4.0"
   },
   "engines": {
     "node": "^22.0.0"

package/dist/schema/features/theme.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/schema/features/theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,8BAA8B,CAAC;AAMxD,eAAO,MAAM,UAAU,aAQpB,CAAC;AAEJ,eAAO,MAAM,gBAAgB,w+BAG5B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEjE,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;AAEzD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;EAStB,CAAC;AAEL,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGzB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW7B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAC"}