@seyuna/cli 1.0.0-canary.2 → 1.0.0-canary.21

package/esm/src/helpers/fs.d.ts

@@ -0,0 +1,35 @@
+import type { Config } from "../config/types.js";
+/**
+ * Constructs an absolute or relative path from a filename and an output directory.
+ *
+ * @param fileName - The name of the file (e.g., "styles.css")
+ * @param outputDir - The target directory (e.g., "dist")
+ * @throws Error if fileName or outputDir are empty strings
+ * @returns The joined path string
+ */
+export declare function createPathFromFileName(fileName: string, outputDir: string): string;
+/**
+ * Reads the text content of a file at the specified path.
+ *
+ * @param path - Path to the file to be read
+ * @throws Error with a descriptive message if the file is not found or cannot be read
+ * @returns The file content as a string
+ */
+export declare function readFile(path: string): Promise<string>;
+/**
+ * Saves content to a file, ensuring the parent directory exists.
+ *
+ * @param path - The target file path
+ * @param content - The content to write (string or Uint8Array)
+ * @returns A promise that resolves when the file is written
+ */
+export declare function saveFile(path: string, content: string | Uint8Array): Promise<void>;
+/**
+ * Loads and parses the 'seyuna.json' configuration file from the current directory.
+ * Merges the user configuration with the default UI settings.
+ *
+ * @throws Error if 'seyuna.json' is missing or contains invalid JSON
+ * @returns The merged configuration object
+ */
+export declare function loadSeyunaUserConfig(): Promise<Config>;
+//# sourceMappingURL=fs.d.ts.map

package/esm/src/helpers/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../src/src/helpers/fs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAIjD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,MAAM,CAQR;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS5D;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,UAAU,GAC3B,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,CAuB5D"}

package/esm/src/helpers/fs.js

@@ -0,0 +1,83 @@
+import * as dntShim from "../../_dnt.shims.js";
+import { dirname, join } from "@jsr/std__path";
+import { ensureDir } from "@jsr/std__fs";
+import { mergeConfig } from "../config/types.js";
+import { UI_CONFIGURATION } from "../ui/default.js";
+/**
+ * Constructs an absolute or relative path from a filename and an output directory.
+ *
+ * @param fileName - The name of the file (e.g., "styles.css")
+ * @param outputDir - The target directory (e.g., "dist")
+ * @throws Error if fileName or outputDir are empty strings
+ * @returns The joined path string
+ */
+export function createPathFromFileName(fileName, outputDir) {
+    if (!fileName.trim()) {
+        throw new Error("File name cannot be empty");
+    }
+    if (!outputDir.trim()) {
+        throw new Error("Output directory cannot be empty");
+    }
+    return join(outputDir, fileName);
+}
+/**
+ * Reads the text content of a file at the specified path.
+ *
+ * @param path - Path to the file to be read
+ * @throws Error with a descriptive message if the file is not found or cannot be read
+ * @returns The file content as a string
+ */
+export async function readFile(path) {
+    try {
+        return await dntShim.Deno.readTextFile(path);
+    }
+    catch (error) {
+        if (error instanceof dntShim.Deno.errors.NotFound) {
+            throw new Error(`File not found at path: ${path}`);
+        }
+        throw new Error(`Failed to read file at ${path}: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+}
+/**
+ * Saves content to a file, ensuring the parent directory exists.
+ *
+ * @param path - The target file path
+ * @param content - The content to write (string or Uint8Array)
+ * @returns A promise that resolves when the file is written
+ */
+export async function saveFile(path, content) {
+    const dir = dirname(path);
+    await ensureDir(dir);
+    const data = typeof content === "string"
+        ? new TextEncoder().encode(content)
+        : content;
+    await dntShim.Deno.writeFile(path, data);
+}
+/**
+ * Loads and parses the 'seyuna.json' configuration file from the current directory.
+ * Merges the user configuration with the default UI settings.
+ *
+ * @throws Error if 'seyuna.json' is missing or contains invalid JSON
+ * @returns The merged configuration object
+ */
+export async function loadSeyunaUserConfig() {
+    try {
+        const content = await readFile("seyuna.json");
+        const userConfig = JSON.parse(content);
+        /** @type {Config} Default fallback configuration */
+        const defaultConfig = {
+            license: undefined,
+            ui: UI_CONFIGURATION,
+        };
+        return mergeConfig(defaultConfig, userConfig);
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes("File not found")) {
+            throw new Error("Could not find 'seyuna.json' in the current directory. Please run 'seyuna ui config --init' to generate it.");
+        }
+        if (error instanceof SyntaxError) {
+            throw new Error(`Failed to parse 'seyuna.json': ${error.message}`);
+        }
+        throw error;
+    }
+}

package/esm/src/helpers/styles.d.ts

@@ -0,0 +1,54 @@
+/**
+ * A function that applies a color or style to a string.
+ */
+export type ColorFunction = (text: string) => string;
+/**
+ * Standard brand colors and styles for the Seyuna CLI.
+ * Provides a consistent visual identity across all command outputs.
+ */
+export declare const Brand: {
+    /** Vibrant Spring Green - Primary brand color */
+    readonly primary: (text: string) => string;
+    /** Cyan - Secondary brand color */
+    readonly secondary: (text: string) => string;
+    /** Magenta - Accent color for highlights */
+    readonly accent: (text: string) => string;
+    /** Bold Green - Indicates successful operations */
+    readonly success: (text: string) => string;
+    /** Bold Red - Indicates errors or critical failures */
+    readonly error: (text: string) => string;
+    /** Bold Yellow - Indicates warnings or non-critical issues */
+    readonly warning: (text: string) => string;
+    /** Gray - For less important or decorative text */
+    readonly muted: (text: string) => string;
+};
+/**
+ * Interpolates between two hex colors to create a gradient effect on text.
+ *
+ * @param text - The string to apply the gradient to
+ * @param startRgb - Start color in hex format (e.g., 0x00FF87)
+ * @param endRgb - End color in hex format (e.g., 0x60EFFF)
+ * @returns The text with ANSI color codes applied per character
+ */
+export declare function gradient(text: string, startRgb: number, endRgb: number): string;
+/**
+ * Standard Seyuna gradient (Spring Green to Cyan).
+ * Used for logos and primary brand headings.
+ */
+export declare const seyunaGradient: ColorFunction;
+/**
+ * Branded Unicode symbols for consistent status reporting.
+ */
+export declare const Symbols: {
+    /** Info icon (Cyan) */
+    readonly info: string;
+    /** Success icon (Green) */
+    readonly success: string;
+    /** Warning icon (Yellow) */
+    readonly warning: string;
+    /** Error icon (Red) */
+    readonly error: string;
+    /** Decorative arrow (Muted) */
+    readonly arrow: string;
+};
+//# sourceMappingURL=styles.d.ts.map

package/esm/src/helpers/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/src/helpers/styles.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,KAAK;IAChB,iDAAiD;6BACjC,MAAM;IAEtB,mCAAmC;+BACjB,MAAM;IAExB,4CAA4C;4BAC7B,MAAM;IAErB,mDAAmD;6BACnC,MAAM;IAEtB,uDAAuD;2BACzC,MAAM;IAEpB,8DAA8D;6BAC9C,MAAM;IAEtB,mDAAmD;2BACrC,MAAM;CAC4B,CAAC;AAEnD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAyB/E;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,aACO,CAAC;AAErC;;GAEG;AACH,eAAO,MAAM,OAAO;IAClB,uBAAuB;;IAGvB,2BAA2B;;IAG3B,4BAA4B;;IAG5B,uBAAuB;;IAGvB,+BAA+B;;CAEU,CAAC"}

package/esm/src/helpers/styles.js

@@ -0,0 +1,71 @@
+import * as colors from "@jsr/std__fmt/colors";
+/**
+ * Standard brand colors and styles for the Seyuna CLI.
+ * Provides a consistent visual identity across all command outputs.
+ */
+export const Brand = {
+    /** Vibrant Spring Green - Primary brand color */
+    primary: (text) => colors.rgb24(text, 0x00FF87),
+    /** Cyan - Secondary brand color */
+    secondary: (text) => colors.rgb24(text, 0x60EFFF),
+    /** Magenta - Accent color for highlights */
+    accent: (text) => colors.rgb24(text, 0xFF00E5),
+    /** Bold Green - Indicates successful operations */
+    success: (text) => colors.bold(colors.green(text)),
+    /** Bold Red - Indicates errors or critical failures */
+    error: (text) => colors.bold(colors.red(text)),
+    /** Bold Yellow - Indicates warnings or non-critical issues */
+    warning: (text) => colors.bold(colors.yellow(text)),
+    /** Gray - For less important or decorative text */
+    muted: (text) => colors.gray(text),
+};
+/**
+ * Interpolates between two hex colors to create a gradient effect on text.
+ *
+ * @param text - The string to apply the gradient to
+ * @param startRgb - Start color in hex format (e.g., 0x00FF87)
+ * @param endRgb - End color in hex format (e.g., 0x60EFFF)
+ * @returns The text with ANSI color codes applied per character
+ */
+export function gradient(text, startRgb, endRgb) {
+    const start = {
+        r: (startRgb >> 16) & 0xFF,
+        g: (startRgb >> 8) & 0xFF,
+        b: startRgb & 0xFF,
+    };
+    const end = {
+        r: (endRgb >> 16) & 0xFF,
+        g: (endRgb >> 8) & 0xFF,
+        b: endRgb & 0xFF,
+    };
+    const characters = Array.from(text);
+    const length = characters.length;
+    return characters.map((char, i) => {
+        // If text is 1 char long, use start color
+        const factor = length > 1 ? i / (length - 1) : 0;
+        const r = Math.round(start.r + factor * (end.r - start.r));
+        const g = Math.round(start.g + factor * (end.g - start.g));
+        const b = Math.round(start.b + factor * (end.b - start.b));
+        return colors.rgb24(char, (r << 16) | (g << 8) | b);
+    }).join("");
+}
+/**
+ * Standard Seyuna gradient (Spring Green to Cyan).
+ * Used for logos and primary brand headings.
+ */
+export const seyunaGradient = (text) => gradient(text, 0x00FF87, 0x60EFFF);
+/**
+ * Branded Unicode symbols for consistent status reporting.
+ */
+export const Symbols = {
+    /** Info icon (Cyan) */
+    info: Brand.secondary("ℹ"),
+    /** Success icon (Green) */
+    success: Brand.success("✔"),
+    /** Warning icon (Yellow) */
+    warning: Brand.warning("⚠"),
+    /** Error icon (Red) */
+    error: Brand.error("✖"),
+    /** Decorative arrow (Muted) */
+    arrow: Brand.muted("›"),
+};

package/esm/src/main.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Seyuna CLI - Entrypoint
+ *
+ * This is the main orchestrator for the Seyuna Command Line Interface.
+ * It defines the command hierarchy and provides the branded "Premium"
+ * help screens.
+ *
+ * @module
+ */
+import "../_dnt.polyfills.js";
+//# sourceMappingURL=main.d.ts.map

package/esm/src/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/src/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,sBAAsB,CAAC"}

package/esm/src/main.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+/**
+ * Seyuna CLI - Entrypoint
+ *
+ * This is the main orchestrator for the Seyuna Command Line Interface.
+ * It defines the command hierarchy and provides the branded "Premium"
+ * help screens.
+ *
+ * @module
+ */
+import "../_dnt.polyfills.js";
+import * as dntShim from "../_dnt.shims.js";
+import { Command } from "@jsr/cliffy__command";
+import * as colors from "@jsr/std__fmt/colors";
+import { initConfig } from "./config/init.js";
+import { compile } from "./ui/compile.js";
+import { Brand, seyunaGradient } from "./helpers/styles.js";
+// Import project name and version from deno.json for single-source-of-truth.
+import denoConfig from "../deno.js";
+const VERSION = denoConfig.version;
+/**
+ * High-fidelity ASCII logo for the CLI.
+ * Rendered using the primary brand gradient.
+ */
+const seyunaLogo = seyunaGradient(`
+                                     
+ _____ _____ __ __ _____ _____ _____ 
+|   __|   __|  |  |  |  |   | |  _  |
+|__   |   __|_   _|  |  | | | |     |
+|_____|_____| |_| |_____|_|___|__|__|
+                                             
+`);
+/**
+ * 'ui' Command Definition.
+ * Handles style compilation, real-time watching, and configuration.
+ */
+const uiCmd = new Command()
+    .option("-c, --compile", "Run a one-time compilation of your styles.")
+    .option("-w, --watch", "Watch for changes and re-compile automatically.")
+    .action(async (options) => {
+    if (options.compile || options.watch) {
+        await compile({ watch: options.watch });
+    }
+    else {
+        console.log(Brand.warning("Please provide an option or subcommand. See --help for more info."));
+    }
+})
+    /**
+     * 'ui config' Subcommand.
+     * Handles project initialization.
+     */
+    .command("config")
+    .option("-i, --init", "Initialize a new 'seyuna.json' configuration.")
+    .action(async (options) => {
+    if (options.init) {
+        await initConfig();
+    }
+    else {
+        console.log(Brand.warning("Please provide an option. See --help for more info."));
+    }
+});
+/**
+ * Root 'seyuna' Command.
+ */
+const cmd = new Command()
+    .name("seyuna")
+    .version(VERSION)
+    .action(() => {
+    // Show help by default if no subcommand is provided.
+    cmd.showHelp();
+})
+    .command("ui", uiCmd)
+    .command("generate-json-schema")
+    .hidden() // Hidden command for future expansion
+    .action(() => {
+    console.log(Brand.muted("JSON schema generation is planned for a future release."));
+});
+/**
+ * Traverses the command tree and prepends the branded logo to every
+ * generated help screen. This ensures a consistent premium brand experience.
+ *
+ * @param command - The Cliffy Command instance to apply the logo to.
+ */
+// deno-lint-ignore no-explicit-any
+const applyBrandedHelp = (command) => {
+    const originalGetHelp = command.getHelp;
+    command.getHelp = function () {
+        return seyunaLogo + originalGetHelp.call(this);
+    };
+    // Recursively apply to all sub-commands
+    command.getCommands().forEach((c) => applyBrandedHelp(c));
+};
+// Initialize branding
+// @ts-ignore: Cliffy Command types are highly generic and conflict after adding subcommands
+applyBrandedHelp(cmd);
+/**
+ * CLI Execution Loop.
+ * Handles argument parsing and top-level error reporting.
+ */
+if (globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).main) {
+    try {
+        await cmd.parse(dntShim.Deno.args);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(`${colors.bold(colors.red("Error:"))} ${error.message}`);
+        }
+        dntShim.Deno.exit(1);
+    }
+}

package/esm/src/ui/compile.d.ts

@@ -0,0 +1,21 @@
+import type { Config } from "../config/types.js";
+/**
+ * Main entrypoint for the UI compilation process.
+ * Orchestrates loading configuration, generating CSS, and optionally
+ * starting a file watcher for real-time development.
+ *
+ * @param options - Compilation options, including 'watch' mode
+ * @returns The loaded project configuration
+ */
+export declare function compile(options: {
+    watch?: boolean;
+}): Promise<Config>;
+/**
+ * The core engine that translates project tokens into functional CSS files.
+ * Generates both 'seyuna-global.css' (reset + variables) and
+ * 'postcss-variables.css' (design token manifest for PostCSS).
+ *
+ * @param config - The project configuration object
+ */
+export declare function compileCss(config: Config): Promise<void>;
+//# sourceMappingURL=compile.d.ts.map

package/esm/src/ui/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../src/src/ui/compile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAYjD;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAc3E;AAkCD;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB9D"}

package/esm/src/ui/compile.js

@@ -0,0 +1,193 @@
+import * as dntShim from "../../_dnt.shims.js";
+import { GLOBAL_CSS } from "./global.css.js";
+import { createPathFromFileName, loadSeyunaUserConfig, saveFile, } from "../helpers/fs.js";
+import { SeyunaSpinner } from "../helpers/cli.js";
+import { delay } from "@jsr/std__async";
+import { Brand } from "../helpers/styles.js";
+/**
+ * Main entrypoint for the UI compilation process.
+ * Orchestrates loading configuration, generating CSS, and optionally
+ * starting a file watcher for real-time development.
+ *
+ * @param options - Compilation options, including 'watch' mode
+ * @returns The loaded project configuration
+ */
+export async function compile(options) {
+    try {
+        const config = await loadSeyunaUserConfig();
+        await compileCss(config);
+        if (options.watch) {
+            console.log(`\n${Brand.secondary("Watching for changes...")}`);
+            await watchConfigAndRecompile("seyuna.json");
+        }
+        return config;
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * Starts an optimized file watcher on the configuration manifest.
+ * Provides debounced recompilation to handle rapid file system events.
+ *
+ * @param file - The path to the configuration file to watch
+ */
+async function watchConfigAndRecompile(file) {
+    const watcher = dntShim.Deno.watchFs(file);
+    let debounceTimer;
+    for await (const event of watcher) {
+        // Only trigger on actual content modifications
+        if (event.kind === "modify") {
+            if (debounceTimer)
+                clearTimeout(debounceTimer);
+            debounceTimer = setTimeout(async () => {
+                // Short delay to ensure the OS has finished writing the file
+                await delay(300);
+                try {
+                    const config = await loadSeyunaUserConfig();
+                    await compileCss(config);
+                    const time = new Date().toLocaleTimeString();
+                    console.log(`${Brand.muted(time)} ${Brand.success("Recompiled successfully")}`);
+                }
+                catch (e) {
+                    console.error(`${Brand.error("Watch Error:")} ${e instanceof Error ? e.message : "Unknown error"}`);
+                }
+            }, 50);
+        }
+    }
+}
+/**
+ * The core engine that translates project tokens into functional CSS files.
+ * Generates both 'seyuna-global.css' (reset + variables) and
+ * 'postcss-variables.css' (design token manifest for PostCSS).
+ *
+ * @param config - The project configuration object
+ */
+export async function compileCss(config) {
+    const spinner = new SeyunaSpinner("Compiling your UI styles").start();
+    try {
+        const ui = getUiConfig(config);
+        if (!ui.output_dir) {
+            throw new Error("Output directory ('output_dir') must be specified in the UI configuration.");
+        }
+        spinner.progress("Building token manifest");
+        const globalCss = buildGlobalCss(config);
+        const postcssVariables = buildPostcssVariables(config);
+        const globalPath = createPathFromFileName("seyuna-global.css", ui.output_dir);
+        const varsPath = createPathFromFileName("postcss-variables.css", ui.output_dir);
+        spinner.progress(`Persisting styles to ${ui.output_dir}`);
+        await saveFile(globalPath, globalCss);
+        await saveFile(varsPath, postcssVariables);
+        spinner.done("Styles compiled successfully!");
+    }
+    catch (error) {
+        spinner.error(`Compilation failed: ${error instanceof Error ? error.message : "Unknown error"}`);
+        throw error;
+    }
+}
+/**
+ * Safely extracts the UI block from the root configuration.
+ */
+function getUiConfig(config) {
+    if (!config.ui) {
+        throw new Error("Missing 'ui' configuration block in 'seyuna.json'.");
+    }
+    return config.ui;
+}
+/**
+ * Combines dynamic token variables with the global reset template.
+ */
+function buildGlobalCss(config) {
+    return [buildCssVariables(config), GLOBAL_CSS].join("\n");
+}
+/**
+ * Generates a full CSS variable sheet including base tokens,
+ * theme modes, and system scheme adaptivity.
+ */
+function buildCssVariables(config) {
+    const ui = getUiConfig(config);
+    const out = [":root {"];
+    // Hue Tokens (e.g., --alpha-hue)
+    for (const [name, val] of Object.entries(ui.theme.hues)) {
+        out.push(`  --${name}-hue: ${val};`);
+    }
+    // Global Semantic Colors
+    for (const [name, color] of Object.entries(ui.theme.colors)) {
+        out.push(`  --${name}-lightness: ${color.lightness};`);
+        out.push(`  --${name}-chroma: ${color.chroma};`);
+        out.push(`  --${name}-hue: ${color.hue};`);
+    }
+    out.push("}\n");
+    const modes = ["light", "dark"];
+    // Explicit Theme Mode Overrides ([data-mode="light"])
+    for (const mode of modes) {
+        out.push(`[data-mode="${mode}"] {`);
+        out.push(buildModeBlock(ui, mode));
+        // Mode-specific semantic color overrides
+        for (const [name, color] of Object.entries(ui.theme[mode].colors)) {
+            out.push(`  --${name}-lightness: ${color.lightness};`);
+            out.push(`  --${name}-chroma: ${color.chroma};`);
+            out.push(`  --${name}-hue: ${color.hue};`);
+        }
+        out.push("}\n");
+    }
+    // System Adatpivity (Auto switching via @media)
+    for (const mode of modes) {
+        out.push(`@media (prefers-color-scheme: ${mode}) {`);
+        out.push('  [data-mode="system"] {');
+        out.push(indent(buildModeBlock(ui, mode), 2));
+        for (const [name, color] of Object.entries(ui.theme[mode].colors)) {
+            out.push(`    --${name}-lightness: ${color.lightness};`);
+            out.push(`    --${name}-chroma: ${color.chroma};`);
+            out.push(`    --${name}-hue: ${color.hue};`);
+        }
+        out.push("  }");
+        out.push("}\n");
+    }
+    return out.join("\n");
+}
+/**
+ * Generates a SASS/PostCSS compatible SCSS manifest.
+ * Used for deep integration with traditional build tools.
+ */
+function buildPostcssVariables(config) {
+    const ui = getUiConfig(config);
+    const fixed = Object.keys(ui.theme.colors).map((c) => `'${c}'`).join(", ");
+    const hues = Object.keys(ui.theme.hues).map((n) => `'${n}'`).join(", ");
+    return [
+        `$fixed_colors: (${fixed});`,
+        `$standard_colors: (${hues});`,
+        "$xs: 20rem;",
+        "$sm: 40rem;",
+        "$md: 48rem;",
+        "$lg: 64rem;",
+        "$xl: 80rem;",
+        "\n",
+    ].join("\n");
+}
+/**
+ * Builds a block of core CSS variables (background, text) for a specific mode.
+ */
+function buildModeBlock(ui, mode) {
+    const p = ui.theme[mode];
+    return [
+        `  --background: oklch(${p.background.lightness} ${p.background.chroma} ${p.background.hue});`,
+        `  --text: oklch(${p.text.lightness} ${p.text.chroma} ${p.text.hue});`,
+        `  --chroma: ${p.chroma};`,
+        `  --lightness: ${p.lightness};`,
+    ].join("\n");
+}
+/**
+ * Helper to indent string lines for pretty-printed CSS output.
+ *
+ * @param s - The string to indent
+ * @param level - Number of double-space indents to apply
+ * @returns The formatted and indented string
+ */
+function indent(s, level) {
+    const pad = "  ".repeat(level);
+    return s.split(/\r?\n/)
+        .filter((line) => line.trim().length > 0)
+        .map((line) => `${pad}${line.trim()}\n`)
+        .join("");
+}

package/esm/src/ui/default.d.ts

@@ -0,0 +1,8 @@
+import type { UI } from "./types.js";
+/**
+ * The default out-of-the-box UI configuration for Seyuna projects.
+ * This provides a robust set of design tokens including a full
+ * Greek-lettered hue scale and foundational semantic colors.
+ */
+export declare const UI_CONFIGURATION: UI;
+//# sourceMappingURL=default.d.ts.map

package/esm/src/ui/default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../../src/src/ui/default.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AAErC;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,EAgE9B,CAAC"}

package/esm/src/ui/default.js

@@ -0,0 +1,65 @@
+/**
+ * The default out-of-the-box UI configuration for Seyuna projects.
+ * This provides a robust set of design tokens including a full
+ * Greek-lettered hue scale and foundational semantic colors.
+ */
+export const UI_CONFIGURATION = {
+    theme: {
+        /**
+         * Global hue scale. Uses Greek letters to provide semantically neutral
+         * references for the 360-degree color wheel.
+         */
+        hues: {
+            "alpha": 0,
+            "beta": 15,
+            "gamma": 30,
+            "delta": 45,
+            "epsilon": 60,
+            "zeta": 75,
+            "eta": 90,
+            "theta": 105,
+            "iota": 120,
+            "kappa": 135,
+            "lambda": 150,
+            "mu": 165,
+            "nu": 180,
+            "xi": 195,
+            "omicron": 210,
+            "pi": 225,
+            "rho": 240,
+            "sigma": 255,
+            "tau": 270,
+            "upsilon": 285,
+            "phi": 300,
+            "chi": 315,
+            "psi": 330,
+            "omega": 345,
+        },
+        /** Base semantic colors shared across modes */
+        colors: {
+            "white": { lightness: 1.0, chroma: 0.0, hue: 0 },
+            "black": { lightness: 0.0, chroma: 0.0, hue: 0 },
+            "primary": { lightness: 0.66, chroma: 0.26, hue: 240 },
+        },
+        /** Default light mode palette */
+        light: {
+            chroma: 0.26,
+            lightness: 0.66,
+            background: { hue: 0, chroma: 0.0, lightness: 1.0 },
+            text: { hue: 0, chroma: 0.0, lightness: 0.0 },
+            colors: {},
+        },
+        /** Default dark mode palette */
+        dark: {
+            chroma: 0.26,
+            lightness: 0.66,
+            background: { hue: 0, chroma: 0.0, lightness: 0.0 },
+            text: { hue: 0, chroma: 0.0, lightness: 1.0 },
+            colors: {},
+        },
+    },
+    /** Default to following the system's preferred color scheme */
+    mode: "system",
+    /** Standard output directory for generated CSS assets */
+    output_dir: "src/styles",
+};