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

package/LICENSE

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

package/README.md

@@ -0,0 +1 @@
+# seyuna-cli

package/esm/_dnt.polyfills.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Based on [import-meta-ponyfill](https://github.com/gaubee/import-meta-ponyfill),
+ * but instead of using npm to install additional dependencies,
+ * this approach manually consolidates cjs/mjs/d.ts into a single file.
+ *
+ * Note that this code might be imported multiple times
+ * (for example, both dnt.test.polyfills.ts and dnt.polyfills.ts contain this code;
+ *  or Node.js might dynamically clear the cache and then force a require).
+ * Therefore, it's important to avoid redundant writes to global objects.
+ * Additionally, consider that commonjs is used alongside esm,
+ * so the two ponyfill functions are stored independently in two separate global objects.
+ */
+import { createRequire } from "node:module";
+import { type URL } from "node:url";
+declare global {
+    interface ImportMeta {
+        /** A string representation of the fully qualified module URL. When the
+         * module is loaded locally, the value will be a file URL (e.g.
+         * `file:///path/module.ts`).
+         *
+         * You can also parse the string as a URL to determine more information about
+         * how the current module was loaded. For example to determine if a module was
+         * local or not:
+         *
+         * ```ts
+         * const url = new URL(import.meta.url);
+         * if (url.protocol === "file:") {
+         *   console.log("this module was loaded locally");
+         * }
+         * ```
+         */
+        url: string;
+        /**
+         * A function that returns resolved specifier as if it would be imported
+         * using `import(specifier)`.
+         *
+         * ```ts
+         * console.log(import.meta.resolve("./foo.js"));
+         * // file:///dev/foo.js
+         * ```
+         *
+         * @param specifier The module specifier to resolve relative to `parent`.
+         * @param parent The absolute parent module URL to resolve from.
+         * @returns The absolute (`file:`) URL string for the resolved module.
+         */
+        resolve(specifier: string, parent?: string | URL | undefined): string;
+        /** A flag that indicates if the current module is the main module that was
+         * called when starting the program under Deno.
+         *
+         * ```ts
+         * if (import.meta.main) {
+         *   // this was loaded as the main module, maybe do some bootstrapping
+         * }
+         * ```
+         */
+        main: boolean;
+        /** The absolute path of the current module.
+         *
+         * This property is only provided for local modules (ie. using `file://` URLs).
+         *
+         * Example:
+         * ```
+         * // Unix
+         * console.log(import.meta.filename); // /home/alice/my_module.ts
+         *
+         * // Windows
+         * console.log(import.meta.filename); // C:\alice\my_module.ts
+         * ```
+         */
+        filename: string;
+        /** The absolute path of the directory containing the current module.
+         *
+         * This property is only provided for local modules (ie. using `file://` URLs).
+         *
+         * * Example:
+         * ```
+         * // Unix
+         * console.log(import.meta.dirname); // /home/alice
+         *
+         * // Windows
+         * console.log(import.meta.dirname); // C:\alice
+         * ```
+         */
+        dirname: string;
+    }
+}
+type NodeRequest = ReturnType<typeof createRequire>;
+type NodeModule = NonNullable<NodeRequest["main"]>;
+interface ImportMetaPonyfillCommonjs {
+    (require: NodeRequest, module: NodeModule): ImportMeta;
+}
+interface ImportMetaPonyfillEsmodule {
+    (importMeta: ImportMeta): ImportMeta;
+}
+interface ImportMetaPonyfill extends ImportMetaPonyfillCommonjs, ImportMetaPonyfillEsmodule {
+}
+export declare let import_meta_ponyfill_commonjs: ImportMetaPonyfillCommonjs;
+export declare let import_meta_ponyfill_esmodule: ImportMetaPonyfillEsmodule;
+export declare let import_meta_ponyfill: ImportMetaPonyfill;
+export {};
+//# sourceMappingURL=_dnt.polyfills.d.ts.map

package/esm/_dnt.polyfills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.polyfills.d.ts","sourceRoot":"","sources":["../src/_dnt.polyfills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAgC,KAAK,GAAG,EAAE,MAAM,UAAU,CAAC;AAGlE,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,UAAU;QAClB;;;;;;;;;;;;;;WAcG;QACH,GAAG,EAAE,MAAM,CAAC;QACZ;;;;;;;;;;;;WAYG;QACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,GAAG,MAAM,CAAC;QACtE;;;;;;;;WAQG;QACH,IAAI,EAAE,OAAO,CAAC;QAEd;;;;;;;;;;;;WAYG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;;;;;;;;;;;WAYG;QACH,OAAO,EAAE,MAAM,CAAC;KACjB;CACF;AAED,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,KAAK,UAAU,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;AACnD,UAAU,0BAA0B;IAClC,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;CACxD;AACD,UAAU,0BAA0B;IAClC,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAAC;CACtC;AACD,UAAU,kBACR,SAAQ,0BAA0B,EAAE,0BAA0B;CAC/D;AAiBD,eAAO,IAAI,6BAA6B,EA2BnC,0BAA0B,CAAC;AAMhC,eAAO,IAAI,6BAA6B,EA4DnC,0BAA0B,CAAC;AAMhC,eAAO,IAAI,oBAAoB,EAoB1B,kBAAkB,CAAC"}

package/esm/_dnt.polyfills.js

@@ -0,0 +1,127 @@
+/**
+ * Based on [import-meta-ponyfill](https://github.com/gaubee/import-meta-ponyfill),
+ * but instead of using npm to install additional dependencies,
+ * this approach manually consolidates cjs/mjs/d.ts into a single file.
+ *
+ * Note that this code might be imported multiple times
+ * (for example, both dnt.test.polyfills.ts and dnt.polyfills.ts contain this code;
+ *  or Node.js might dynamically clear the cache and then force a require).
+ * Therefore, it's important to avoid redundant writes to global objects.
+ * Additionally, consider that commonjs is used alongside esm,
+ * so the two ponyfill functions are stored independently in two separate global objects.
+ */
+//@ts-ignore
+import { createRequire } from "node:module";
+//@ts-ignore
+import { fileURLToPath, pathToFileURL } from "node:url";
+//@ts-ignore
+import { dirname } from "node:path";
+const defineGlobalPonyfill = (symbolFor, fn) => {
+    if (!Reflect.has(globalThis, Symbol.for(symbolFor))) {
+        Object.defineProperty(globalThis, Symbol.for(symbolFor), {
+            configurable: true,
+            get() {
+                return fn;
+            },
+        });
+    }
+};
+export let import_meta_ponyfill_commonjs = (Reflect.get(globalThis, Symbol.for("import-meta-ponyfill-commonjs")) ??
+    (() => {
+        const moduleImportMetaWM = new WeakMap();
+        return (require, module) => {
+            let importMetaCache = moduleImportMetaWM.get(module);
+            if (importMetaCache == null) {
+                const importMeta = Object.assign(Object.create(null), {
+                    url: pathToFileURL(module.filename).href,
+                    main: require.main == module,
+                    resolve: (specifier, parentURL = importMeta.url) => {
+                        return pathToFileURL((importMeta.url === parentURL
+                            ? require
+                            : createRequire(parentURL))
+                            .resolve(specifier)).href;
+                    },
+                    filename: module.filename,
+                    dirname: module.path,
+                });
+                moduleImportMetaWM.set(module, importMeta);
+                importMetaCache = importMeta;
+            }
+            return importMetaCache;
+        };
+    })());
+defineGlobalPonyfill("import-meta-ponyfill-commonjs", import_meta_ponyfill_commonjs);
+export let import_meta_ponyfill_esmodule = (Reflect.get(globalThis, Symbol.for("import-meta-ponyfill-esmodule")) ??
+    ((importMeta) => {
+        const resolveFunStr = String(importMeta.resolve);
+        const shimWs = new WeakSet();
+        //@ts-ignore
+        const mainUrl = ("file:///" + process.argv[1].replace(/\\/g, "/"))
+            .replace(/\/{3,}/, "///");
+        const commonShim = (importMeta) => {
+            if (typeof importMeta.main !== "boolean") {
+                importMeta.main = importMeta.url === mainUrl;
+            }
+            if (typeof importMeta.filename !== "string") {
+                importMeta.filename = fileURLToPath(importMeta.url);
+                importMeta.dirname = dirname(importMeta.filename);
+            }
+        };
+        if (
+        // v16.2.0+, v14.18.0+: Add support for WHATWG URL object to parentURL parameter.
+        resolveFunStr === "undefined" ||
+            // v20.0.0+, v18.19.0+"" This API now returns a string synchronously instead of a Promise.
+            resolveFunStr.startsWith("async")
+        // enable by --experimental-import-meta-resolve flag
+        ) {
+            import_meta_ponyfill_esmodule = (importMeta) => {
+                if (!shimWs.has(importMeta)) {
+                    shimWs.add(importMeta);
+                    const importMetaUrlRequire = {
+                        url: importMeta.url,
+                        require: createRequire(importMeta.url),
+                    };
+                    importMeta.resolve = function resolve(specifier, parentURL = importMeta.url) {
+                        return pathToFileURL((importMetaUrlRequire.url === parentURL
+                            ? importMetaUrlRequire.require
+                            : createRequire(parentURL)).resolve(specifier)).href;
+                    };
+                    commonShim(importMeta);
+                }
+                return importMeta;
+            };
+        }
+        else {
+            /// native support
+            import_meta_ponyfill_esmodule = (importMeta) => {
+                if (!shimWs.has(importMeta)) {
+                    shimWs.add(importMeta);
+                    commonShim(importMeta);
+                }
+                return importMeta;
+            };
+        }
+        return import_meta_ponyfill_esmodule(importMeta);
+    }));
+defineGlobalPonyfill("import-meta-ponyfill-esmodule", import_meta_ponyfill_esmodule);
+export let import_meta_ponyfill = ((...args) => {
+    const _MODULE = (() => {
+        if (typeof require === "function" && typeof module === "object") {
+            return "commonjs";
+        }
+        else {
+            // eval("typeof import.meta");
+            return "esmodule";
+        }
+    })();
+    if (_MODULE === "commonjs") {
+        //@ts-ignore
+        import_meta_ponyfill = (r, m) => import_meta_ponyfill_commonjs(r, m);
+    }
+    else {
+        //@ts-ignore
+        import_meta_ponyfill = (im) => import_meta_ponyfill_esmodule(im);
+    }
+    //@ts-ignore
+    return import_meta_ponyfill(...args);
+});

package/esm/_dnt.shims.d.ts

@@ -0,0 +1,6 @@
+import { Deno } from "@deno/shim-deno";
+export { Deno } from "@deno/shim-deno";
+export declare const dntGlobalThis: Omit<typeof globalThis, "Deno"> & {
+    Deno: typeof Deno;
+};
+//# sourceMappingURL=_dnt.shims.d.ts.map

package/esm/_dnt.shims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.shims.d.ts","sourceRoot":"","sources":["../src/_dnt.shims.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAKvC,eAAO,MAAM,aAAa;;CAA2C,CAAC"}

package/esm/_dnt.shims.js

@@ -0,0 +1,61 @@
+import { Deno } from "@deno/shim-deno";
+export { Deno } from "@deno/shim-deno";
+const dntGlobals = {
+    Deno,
+};
+export const dntGlobalThis = createMergeProxy(globalThis, dntGlobals);
+function createMergeProxy(baseObj, extObj) {
+    return new Proxy(baseObj, {
+        get(_target, prop, _receiver) {
+            if (prop in extObj) {
+                return extObj[prop];
+            }
+            else {
+                return baseObj[prop];
+            }
+        },
+        set(_target, prop, value) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            baseObj[prop] = value;
+            return true;
+        },
+        deleteProperty(_target, prop) {
+            let success = false;
+            if (prop in extObj) {
+                delete extObj[prop];
+                success = true;
+            }
+            if (prop in baseObj) {
+                delete baseObj[prop];
+                success = true;
+            }
+            return success;
+        },
+        ownKeys(_target) {
+            const baseKeys = Reflect.ownKeys(baseObj);
+            const extKeys = Reflect.ownKeys(extObj);
+            const extKeysSet = new Set(extKeys);
+            return [...baseKeys.filter((k) => !extKeysSet.has(k)), ...extKeys];
+        },
+        defineProperty(_target, prop, desc) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            Reflect.defineProperty(baseObj, prop, desc);
+            return true;
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            if (prop in extObj) {
+                return Reflect.getOwnPropertyDescriptor(extObj, prop);
+            }
+            else {
+                return Reflect.getOwnPropertyDescriptor(baseObj, prop);
+            }
+        },
+        has(_target, prop) {
+            return prop in extObj || prop in baseObj;
+        },
+    });
+}

package/esm/deno.d.ts

@@ -0,0 +1,27 @@
+declare namespace _default {
+    let nodeModulesDir: string;
+    let name: string;
+    let version: string;
+    let exports: string;
+    namespace publish {
+        let include: string[];
+    }
+    namespace tasks {
+        let start: string;
+        let test: string;
+    }
+    let imports: {
+        "@std/cli": string;
+        "@std/fs": string;
+        "@std/path": string;
+        "@std/streams": string;
+        "@std/assert": string;
+        "@std/async": string;
+        "@std/fmt": string;
+        "@cliffy/command": string;
+        "@cliffy/prompt": string;
+        dnt: string;
+    };
+}
+export default _default;
+//# sourceMappingURL=deno.d.ts.map

package/esm/deno.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deno.d.ts","sourceRoot":"","sources":["../src/deno.js"],"names":[],"mappings":""}

package/esm/deno.js

@@ -0,0 +1,30 @@
+export default {
+    "nodeModulesDir": "auto",
+    "name": "@seyuna/cli",
+    "version": "1.0.0-canary.21",
+    "exports": "./src/main.ts",
+    "publish": {
+        "include": [
+            "src/**/*.ts",
+            "deno.json",
+            "README.md",
+            "LICENSE"
+        ]
+    },
+    "tasks": {
+        "start": "deno run -A src/main.ts",
+        "test": "deno test -A"
+    },
+    "imports": {
+        "@std/cli": "npm:@jsr/std__cli@^1.0.25",
+        "@std/fs": "npm:@jsr/std__fs@^1.0.0",
+        "@std/path": "npm:@jsr/std__path@^1.0.0",
+        "@std/streams": "npm:@jsr/std__streams@^1.0.8",
+        "@std/assert": "npm:@jsr/std__assert@^1.0.0",
+        "@std/async": "npm:@jsr/std__async@^1.0.0",
+        "@std/fmt": "npm:@jsr/std__fmt@^1.0.0",
+        "@cliffy/command": "npm:@jsr/cliffy__command@^1.0.0-rc.8",
+        "@cliffy/prompt": "npm:@jsr/cliffy__prompt@^1.0.0-rc.8",
+        "dnt": "jsr:@deno/dnt@0.42.3"
+    }
+};

package/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/esm/src/config/init.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Initializes a new Seyuna project by creating a 'seyuna.json' configuration file.
+ * This function performs safety checks to avoid overwriting existing configurations.
+ *
+ * @returns A promise that resolves when initialization is complete.
+ */
+export declare function initConfig(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/esm/src/config/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/src/config/init.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAgEhD"}

package/esm/src/config/init.js

@@ -0,0 +1,68 @@
+import * as dntShim from "../../_dnt.shims.js";
+import { UI_CONFIGURATION } from "../ui/default.js";
+import { SeyunaSpinner } from "../helpers/cli.js";
+import { Brand } from "../helpers/styles.js";
+import { Input, Select } from "@jsr/cliffy__prompt";
+/**
+ * Initializes a new Seyuna project by creating a 'seyuna.json' configuration file.
+ * This function performs safety checks to avoid overwriting existing configurations.
+ *
+ * @returns A promise that resolves when initialization is complete.
+ */
+export async function initConfig() {
+    const licenseKey = await Input.prompt({
+        message: `${Brand.muted("›")} Enter your Seyuna license key (optional)`,
+    });
+    const outputDir = await Input.prompt({
+        message: `${Brand.muted("›")} Output directory for generated CSS`,
+        default: "src/styles",
+    }) || "src/styles";
+    const mode = await Select.prompt({
+        message: `${Brand.muted("›")} Default color appearance mode`,
+        default: "system",
+        options: [
+            { name: "System", value: "system" },
+            { name: "Light", value: "light" },
+            { name: "Dark", value: "dark" },
+        ],
+    });
+    const spinner = new SeyunaSpinner("Setting up your Seyuna project").start();
+    try {
+        /** @type {Config} Template for the initial project configuration */
+        const config = {
+            license: licenseKey || undefined,
+            ui: {
+                ...UI_CONFIGURATION,
+                mode,
+                output_dir: outputDir,
+            },
+        };
+        spinner.progress("Building configuration manifest");
+        const json = JSON.stringify(config, null, 2);
+        spinner.progress("Writing manifest to disk");
+        const fileName = "seyuna.json";
+        // Safety check: Avoid accidental overwrites of existing configurations
+        try {
+            const stats = await dntShim.Deno.stat(fileName);
+            if (stats.isFile) {
+                spinner.error(`Existing '${fileName}' found. Initialization aborted to prevent data loss.`);
+                return;
+            }
+        }
+        catch (error) {
+            if (!(error instanceof dntShim.Deno.errors.NotFound)) {
+                throw error;
+            }
+            // File doesn't exist, proceed with initialization
+        }
+        await dntShim.Deno.writeTextFile(fileName, json);
+        spinner.done("Success! Your project is now powered by Seyuna.");
+        // Display helpful onboarding steps
+        console.log(`\n${Brand.muted("Next steps:")}`);
+        console.log(`${Brand.secondary("seyuna ui --compile")}   ${Brand.muted("Build your initial styles")}`);
+        console.log(`${Brand.secondary("seyuna ui --watch")}     ${Brand.muted("Start the development server")}`);
+    }
+    catch (error) {
+        spinner.error(`Failed to initialize: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+}

package/esm/src/config/types.d.ts

@@ -0,0 +1,25 @@
+import type { UI } from "../ui/types.js";
+/**
+ * Root configuration structure for a Seyuna project.
+ * This interface represents the schema of the 'seyuna.json' file.
+ */
+export interface Config {
+    /**
+     * Optional license key for premium features.
+     */
+    license?: string;
+    /**
+     * UI and styling engine configuration.
+     */
+    ui?: UI;
+}
+/**
+ * Deeply merges two project configurations.
+ * Currently handles nested merging for the 'ui' property.
+ *
+ * @param base - The default or base configuration
+ * @param override - The user-provided or overriding configuration
+ * @returns A new configuration object with combined properties
+ */
+export declare function mergeConfig(base: Config, override: Config): Config;
+//# sourceMappingURL=types.d.ts.map

package/esm/src/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/config/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAGzC;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,EAAE,CAAC,EAAE,EAAE,CAAC;CACT;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQlE"}

package/esm/src/config/types.js

@@ -0,0 +1,18 @@
+import { mergeUI } from "../ui/types.js";
+/**
+ * Deeply merges two project configurations.
+ * Currently handles nested merging for the 'ui' property.
+ *
+ * @param base - The default or base configuration
+ * @param override - The user-provided or overriding configuration
+ * @returns A new configuration object with combined properties
+ */
+export function mergeConfig(base, override) {
+    return {
+        ...base,
+        ...override,
+        ui: base.ui && override.ui
+            ? mergeUI(base.ui, override.ui)
+            : (override.ui ?? base.ui),
+    };
+}

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

@@ -0,0 +1,45 @@
+/**
+ * A branded spinner class that provides visual feedback for long-running CLI operations.
+ * It uses the Seyuna color palette and gradients for a premium experience.
+ */
+export declare class SeyunaSpinner {
+    private spinner;
+    /**
+     * Creates a new branded spinner.
+     * @param message - The initial message to display next to the spinner.
+     */
+    constructor(message: string);
+    /**
+     * Starts the spinner animation.
+     * @returns The spinner instance for chaining.
+     */
+    start(): this;
+    /**
+     * Updates the message displayed next to the active spinner.
+     * @param message - The new progress message.
+     */
+    progress(message: string): void;
+    /**
+     * Stops the spinner and displays a branded success message.
+     * @param message - The message to display upon completion.
+     */
+    done(message: string): void;
+    /**
+     * Stops the spinner and displays a branded error message.
+     * @param message - The error message to display.
+     */
+    error(message: string): void;
+    /**
+     * Stops the spinner and displays a branded warning message.
+     * @param message - The warning message to display.
+     */
+    warning(message: string): void;
+}
+/**
+ * Convenience function to create and start a branded spinner in one call.
+ *
+ * @param message - The message to display.
+ * @returns An active SeyunaSpinner instance.
+ */
+export declare function startSpinner(message: string): SeyunaSpinner;
+//# sourceMappingURL=cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/src/helpers/cli.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAU;IAEzB;;;OAGG;gBACS,OAAO,EAAE,MAAM;IAO3B;;;OAGG;IACH,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI/B;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK3B;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK5B;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAI/B;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAE3D"}

package/esm/src/helpers/cli.js

@@ -0,0 +1,72 @@
+import { Spinner } from "@jsr/std__cli/unstable-spinner";
+import { Brand, seyunaGradient, Symbols } from "./styles.js";
+/**
+ * A branded spinner class that provides visual feedback for long-running CLI operations.
+ * It uses the Seyuna color palette and gradients for a premium experience.
+ */
+export class SeyunaSpinner {
+    /**
+     * Creates a new branded spinner.
+     * @param message - The initial message to display next to the spinner.
+     */
+    constructor(message) {
+        Object.defineProperty(this, "spinner", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.spinner = new Spinner({
+            message: seyunaGradient(message),
+            color: "cyan",
+        });
+    }
+    /**
+     * Starts the spinner animation.
+     * @returns The spinner instance for chaining.
+     */
+    start() {
+        this.spinner.start();
+        return this;
+    }
+    /**
+     * Updates the message displayed next to the active spinner.
+     * @param message - The new progress message.
+     */
+    progress(message) {
+        this.spinner.message = seyunaGradient(message);
+    }
+    /**
+     * Stops the spinner and displays a branded success message.
+     * @param message - The message to display upon completion.
+     */
+    done(message) {
+        this.spinner.stop();
+        console.log(`${Symbols.success} ${Brand.success(message)}`);
+    }
+    /**
+     * Stops the spinner and displays a branded error message.
+     * @param message - The error message to display.
+     */
+    error(message) {
+        this.spinner.stop();
+        console.log(`${Symbols.error} ${Brand.error(message)}`);
+    }
+    /**
+     * Stops the spinner and displays a branded warning message.
+     * @param message - The warning message to display.
+     */
+    warning(message) {
+        this.spinner.stop();
+        console.log(`${Symbols.warning} ${Brand.warning(message)}`);
+    }
+}
+/**
+ * Convenience function to create and start a branded spinner in one call.
+ *
+ * @param message - The message to display.
+ * @returns An active SeyunaSpinner instance.
+ */
+export function startSpinner(message) {
+    return new SeyunaSpinner(message).start();
+}