@vorra/cli 0.3.0

package/dist/commands/new.js

@@ -0,0 +1,235 @@
+// =============================================================================
+// @forge/cli — forge new
+// Scaffolds a new Forge application in a subdirectory of cwd.
+// =============================================================================
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Scaffolds a new project.
+ *
+ * Usage: forge new <project-name>
+ *
+ * Creates the following structure:
+ *   <name>/
+ *     .gitignore
+ *     index.html
+ *     forge.config.js
+ *     package.json
+ *     tsconfig.json
+ *     src/
+ *       env.d.ts
+ *       main.ts
+ *       App.forge
+ */
+export function runNew(args) {
+    const name = args[0];
+    if (!name) {
+        console.error('[Forge CLI] Usage: forge new <project-name>');
+        process.exit(1);
+        return;
+    }
+    if (!/^[a-z][a-z0-9-]*$/.test(name)) {
+        console.error('[Forge CLI] Project name must be lowercase letters/digits/hyphens, starting with a letter.');
+        process.exit(1);
+        return;
+    }
+    const projectDir = path.join(process.cwd(), name);
+    if (fs.existsSync(projectDir)) {
+        console.error(`[Forge CLI] Directory "${name}" already exists.`);
+        process.exit(1);
+        return;
+    }
+    console.log(`\n  Scaffolding Forge app: ${name}\n`);
+    // Create directory tree.
+    fs.mkdirSync(path.join(projectDir, 'src'), { recursive: true });
+    // Write each template file.
+    write(projectDir, 'package.json', tplPackageJson(name));
+    write(projectDir, 'tsconfig.json', tplTsconfig());
+    write(projectDir, 'forge.config.js', tplForgeConfig());
+    write(projectDir, 'index.html', tplIndexHtml(name));
+    write(projectDir, '.gitignore', tplGitignore());
+    write(projectDir, 'src/env.d.ts', tplEnvDts());
+    write(projectDir, 'src/main.ts', tplMainTs());
+    write(projectDir, 'src/App.forge', tplAppForge());
+    const files = [
+        'package.json',
+        'tsconfig.json',
+        'forge.config.js',
+        'index.html',
+        '.gitignore',
+        'src/env.d.ts',
+        'src/main.ts',
+        'src/App.forge',
+    ];
+    for (const f of files) {
+        console.log(`  \u2713 ${name}/${f}`);
+    }
+    console.log(`
+  Done! Next steps:
+
+    cd ${name}
+    npm install
+    npm run dev
+`);
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function write(dir, filename, content) {
+    fs.writeFileSync(path.join(dir, filename), content, 'utf8');
+}
+// ---------------------------------------------------------------------------
+// Templates
+// ---------------------------------------------------------------------------
+function tplPackageJson(name) {
+    return JSON.stringify({
+        name,
+        version: '0.1.0',
+        private: true,
+        type: 'module',
+        scripts: {
+            dev: 'forge dev',
+            build: 'forge build',
+            typecheck: 'forge typecheck',
+        },
+        dependencies: {
+            '@forge/core': '^0.1.0',
+        },
+        devDependencies: {
+            '@forge/cli': '^0.1.0',
+            '@forge/compiler': '^0.1.0',
+            rolldown: '^0.14.0',
+            typescript: '^5.4.0',
+        },
+        engines: {
+            node: '>=20.0.0',
+        },
+    }, null, 2);
+}
+function tplTsconfig() {
+    return JSON.stringify({
+        compilerOptions: {
+            target: 'ES2022',
+            module: 'ESNext',
+            moduleResolution: 'Bundler',
+            strict: true,
+            exactOptionalPropertyTypes: true,
+            noUncheckedIndexedAccess: true,
+            experimentalDecorators: true,
+            useDefineForClassFields: false,
+            skipLibCheck: true,
+            noEmit: true,
+        },
+        include: ['src'],
+    }, null, 2);
+}
+function tplForgeConfig() {
+    return `// forge.config.js
+import { defineConfig } from '@forge/cli';
+
+export default defineConfig({
+  entry: 'src/main.ts',
+  outDir: 'dist',
+  port: 3000,
+});
+`;
+}
+function tplIndexHtml(name) {
+    return `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${name}</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="./dist/main.js"></script>
+  </body>
+</html>
+`;
+}
+function tplGitignore() {
+    return `node_modules/
+dist/
+*.tsbuildinfo
+`;
+}
+function tplEnvDts() {
+    return `// Type declarations for .forge single-file components.
+import type { ComponentContext } from '@forge/core';
+
+declare module '*.forge' {
+  const component: (ctx: ComponentContext) => Node;
+  export default component;
+}
+`;
+}
+function tplMainTs() {
+    return `import { bootstrapApp } from '@forge/core';
+import { createComponent, mountComponent } from '@forge/core';
+import App from './App.forge';
+
+const appEl = document.getElementById('app');
+if (appEl === null) throw new Error('[App] #app element not found in index.html');
+
+const root = bootstrapApp();
+const ctx = createComponent(root);
+mountComponent(App, appEl, ctx);
+`;
+}
+function tplAppForge() {
+    return `<script>
+import { signal } from '@forge/core';
+
+const count = signal(0);
+
+function increment(): void {
+  count.update((n) => n + 1);
+}
+</script>
+
+<template>
+  <div class="app">
+    <h1>Welcome to Forge ⚡</h1>
+    <p class="counter">Count: {count()}</p>
+    <button @click="increment">Increment</button>
+  </div>
+</template>
+
+<style scoped>
+.app {
+  font-family: system-ui, sans-serif;
+  max-width: 480px;
+  margin: 4rem auto;
+  padding: 0 1rem;
+  text-align: center;
+}
+
+h1 {
+  font-size: 2rem;
+  margin-bottom: 1rem;
+}
+
+.counter {
+  font-size: 1.25rem;
+  margin-bottom: 1.5rem;
+}
+
+button {
+  padding: 0.5rem 1.5rem;
+  font-size: 1rem;
+  cursor: pointer;
+  border: 2px solid currentColor;
+  border-radius: 6px;
+  background: transparent;
+  transition: background 0.2s;
+}
+
+button:hover {
+  background: #f0f0f0;
+}
+</style>
+`;
+}
+//# sourceMappingURL=new.js.map

package/dist/commands/new.js.map

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

package/dist/commands/typecheck.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Runs TypeScript type checking via `tsc --build`.
+ * Passes `--noEmit` unless the project tsconfig already disables emit.
+ * Exits with the same code as tsc.
+ */
+export declare function runTypecheck(args: string[]): void;
+//# sourceMappingURL=typecheck.d.ts.map

package/dist/commands/typecheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typecheck.d.ts","sourceRoot":"","sources":["../../src/commands/typecheck.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAkBjD"}

package/dist/commands/typecheck.js

@@ -0,0 +1,26 @@
+// =============================================================================
+// @forge/cli — forge typecheck
+// Delegates to `tsc --build` in the project root.
+// =============================================================================
+import { spawnSync } from 'node:child_process';
+/**
+ * Runs TypeScript type checking via `tsc --build`.
+ * Passes `--noEmit` unless the project tsconfig already disables emit.
+ * Exits with the same code as tsc.
+ */
+export function runTypecheck(args) {
+    const noEmit = args.includes('--emit') ? [] : ['--noEmit'];
+    console.log('[forge typecheck] Running tsc --build...');
+    const result = spawnSync('tsc', ['--build', ...noEmit], {
+        stdio: 'inherit',
+        shell: true,
+        cwd: process.cwd(),
+    });
+    if (result.error !== undefined) {
+        console.error('[Forge CLI] Failed to run tsc:', result.error.message);
+        process.exit(1);
+        return;
+    }
+    process.exit(result.status ?? 0);
+}
+//# sourceMappingURL=typecheck.js.map

package/dist/commands/typecheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typecheck.js","sourceRoot":"","sources":["../../src/commands/typecheck.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,+BAA+B;AAC/B,kDAAkD;AAClD,gFAAgF;AAEhF,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAE3D,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IAExD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,GAAG,MAAM,CAAC,EAAE;QACtD,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,IAAI;QACX,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;KACnB,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;AACnC,CAAC"}

package/dist/index.cjs

@@ -0,0 +1,24 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/index.ts
+/**
+* Type-safe helper for writing `vorra.config.js`.
+*
+* @example
+* ```js
+* // vorra.config.js
+* import { defineConfig } from '@vorra/cli';
+*
+* export default defineConfig({
+*   entry: 'src/main.ts',
+*   outDir: 'dist',
+*   port: 3000,
+* });
+* ```
+*/
+function defineConfig(config) {
+	return config;
+}
+//#endregion
+exports.defineConfig = defineConfig;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["// =============================================================================\r\n// @vorra/cli — Public API\r\n// =============================================================================\r\n\r\n/**\r\n * User-facing configuration for a Vorra project.\r\n * Returned by `defineConfig()` and loaded by `vorra dev` / `vorra build`.\r\n */\r\nexport interface VorraConfig {\r\n  /** Application entry point. Defaults to `'src/main.ts'`. */\r\n  entry?: string;\r\n  /** Output directory. Defaults to `'dist'`. */\r\n  outDir?: string;\r\n  /** Dev server port. Defaults to `3000`. */\r\n  port?: number;\r\n  /**\r\n   * Output directory used by `vorra dev`. Defaults to `'.vorra'`.\r\n   * Kept separate from `outDir` so dev artifacts never pollute the production\r\n   * build folder. Add `.vorra/` to your `.gitignore`.\r\n   */\r\n  devOutDir?: string;\r\n  /** Additional Rolldown plugins appended after the built-in vorra plugin. */\r\n  plugins?: unknown[];\r\n  /**\r\n   * Emit source map files alongside build output.\r\n   * Defaults to `false` for `vorra build` (production).\r\n   * `vorra dev` always enables source maps regardless of this setting.\r\n   *\r\n   * @example\r\n   * ```js\r\n   * // vorra.config.js — enable source maps for a debug/staging build\r\n   * export default defineConfig({ sourcemap: true });\r\n   * ```\r\n   */\r\n  sourcemap?: boolean;\r\n  /**\r\n   * Absolute or relative path to a CSS entry file processed through PostCSS\r\n   * (e.g. a Tailwind CSS file using `@import \"tailwindcss\"`). Import the\r\n   * virtual module `\"vorra:css\"` from your entry point to inject it:\r\n   *\r\n   * ```ts\r\n   * // src/main.ts\r\n   * import 'vorra:css';\r\n   * ```\r\n   */\r\n  css?: string;\r\n  /**\r\n   * PostCSS configuration. Required when `css` uses PostCSS-processed rules\r\n   * such as Tailwind CSS.\r\n   *\r\n   * @example\r\n   * ```js\r\n   * // vorra.config.js\r\n   * import tailwindcss from '@tailwindcss/postcss';\r\n   * export default defineConfig({\r\n   *   css: './src/tailwind.css',\r\n   *   postcss: { plugins: [tailwindcss()] },\r\n   * });\r\n   * ```\r\n   */\r\n  postcss?: { plugins: unknown[] };\r\n}\r\n\r\n/**\r\n * Type-safe helper for writing `vorra.config.js`.\r\n *\r\n * @example\r\n * ```js\r\n * // vorra.config.js\r\n * import { defineConfig } from '@vorra/cli';\r\n *\r\n * export default defineConfig({\r\n *   entry: 'src/main.ts',\r\n *   outDir: 'dist',\r\n *   port: 3000,\r\n * });\r\n * ```\r\n */\r\nexport function defineConfig(config: VorraConfig): VorraConfig {\r\n  return config;\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;AA8EA,SAAgB,aAAa,QAAkC;AAC7D,QAAO"}

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * User-facing configuration for a Forge project.
+ * Returned by `defineConfig()` and loaded by `forge dev` / `forge build`.
+ */
+export interface ForgeConfig {
+    /** Application entry point. Defaults to `'src/main.ts'`. */
+    entry?: string;
+    /** Output directory. Defaults to `'dist'`. */
+    outDir?: string;
+    /** Dev server port. Defaults to `3000`. */
+    port?: number;
+    /** Additional Rolldown plugins appended after the built-in forge plugin. */
+    plugins?: unknown[];
+}
+/**
+ * Type-safe helper for writing `forge.config.js`.
+ *
+ * @example
+ * ```js
+ * // forge.config.js
+ * import { defineConfig } from '@forge/cli';
+ *
+ * export default defineConfig({
+ *   entry: 'src/main.ts',
+ *   outDir: 'dist',
+ *   port: 3000,
+ * });
+ * ```
+ */
+export declare function defineConfig(config: ForgeConfig): ForgeConfig;
+//# 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":"AAIA;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;CACrB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAE7D"}

package/dist/index.js

@@ -0,0 +1,23 @@
+//#region src/index.ts
+/**
+* Type-safe helper for writing `vorra.config.js`.
+*
+* @example
+* ```js
+* // vorra.config.js
+* import { defineConfig } from '@vorra/cli';
+*
+* export default defineConfig({
+*   entry: 'src/main.ts',
+*   outDir: 'dist',
+*   port: 3000,
+* });
+* ```
+*/
+function defineConfig(config) {
+	return config;
+}
+//#endregion
+export { defineConfig };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["// =============================================================================\r\n// @vorra/cli — Public API\r\n// =============================================================================\r\n\r\n/**\r\n * User-facing configuration for a Vorra project.\r\n * Returned by `defineConfig()` and loaded by `vorra dev` / `vorra build`.\r\n */\r\nexport interface VorraConfig {\r\n  /** Application entry point. Defaults to `'src/main.ts'`. */\r\n  entry?: string;\r\n  /** Output directory. Defaults to `'dist'`. */\r\n  outDir?: string;\r\n  /** Dev server port. Defaults to `3000`. */\r\n  port?: number;\r\n  /**\r\n   * Output directory used by `vorra dev`. Defaults to `'.vorra'`.\r\n   * Kept separate from `outDir` so dev artifacts never pollute the production\r\n   * build folder. Add `.vorra/` to your `.gitignore`.\r\n   */\r\n  devOutDir?: string;\r\n  /** Additional Rolldown plugins appended after the built-in vorra plugin. */\r\n  plugins?: unknown[];\r\n  /**\r\n   * Emit source map files alongside build output.\r\n   * Defaults to `false` for `vorra build` (production).\r\n   * `vorra dev` always enables source maps regardless of this setting.\r\n   *\r\n   * @example\r\n   * ```js\r\n   * // vorra.config.js — enable source maps for a debug/staging build\r\n   * export default defineConfig({ sourcemap: true });\r\n   * ```\r\n   */\r\n  sourcemap?: boolean;\r\n  /**\r\n   * Absolute or relative path to a CSS entry file processed through PostCSS\r\n   * (e.g. a Tailwind CSS file using `@import \"tailwindcss\"`). Import the\r\n   * virtual module `\"vorra:css\"` from your entry point to inject it:\r\n   *\r\n   * ```ts\r\n   * // src/main.ts\r\n   * import 'vorra:css';\r\n   * ```\r\n   */\r\n  css?: string;\r\n  /**\r\n   * PostCSS configuration. Required when `css` uses PostCSS-processed rules\r\n   * such as Tailwind CSS.\r\n   *\r\n   * @example\r\n   * ```js\r\n   * // vorra.config.js\r\n   * import tailwindcss from '@tailwindcss/postcss';\r\n   * export default defineConfig({\r\n   *   css: './src/tailwind.css',\r\n   *   postcss: { plugins: [tailwindcss()] },\r\n   * });\r\n   * ```\r\n   */\r\n  postcss?: { plugins: unknown[] };\r\n}\r\n\r\n/**\r\n * Type-safe helper for writing `vorra.config.js`.\r\n *\r\n * @example\r\n * ```js\r\n * // vorra.config.js\r\n * import { defineConfig } from '@vorra/cli';\r\n *\r\n * export default defineConfig({\r\n *   entry: 'src/main.ts',\r\n *   outDir: 'dist',\r\n *   port: 3000,\r\n * });\r\n * ```\r\n */\r\nexport function defineConfig(config: VorraConfig): VorraConfig {\r\n  return config;\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;AA8EA,SAAgB,aAAa,QAAkC;AAC7D,QAAO"}

package/dist/utils/config.d.ts

@@ -0,0 +1,11 @@
+import type { ForgeConfig } from '../index.js';
+/**
+ * Loads forge.config.{js,mjs,cjs} from `cwd` and returns the config object.
+ * Returns an empty object if no config file is found.
+ *
+ * Note: `.ts` configs are not supported at CLI runtime without a TS loader.
+ * Compile `forge.config.ts` to `.js` first, or run with `tsx`:
+ *   npx tsx node_modules/.bin/forge dev
+ */
+export declare function loadConfig(cwd: string): Promise<ForgeConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAQ/C;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAwBlE"}

package/dist/utils/config.js

@@ -0,0 +1,43 @@
+// =============================================================================
+// @forge/cli — Config loader
+// Loads forge.config.js / .mjs / .cjs from the project root.
+// TypeScript configs require a TS loader (tsx, ts-node) to be active.
+// =============================================================================
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as url from 'node:url';
+const CONFIG_CANDIDATES = [
+    'forge.config.js',
+    'forge.config.mjs',
+    'forge.config.cjs',
+];
+/**
+ * Loads forge.config.{js,mjs,cjs} from `cwd` and returns the config object.
+ * Returns an empty object if no config file is found.
+ *
+ * Note: `.ts` configs are not supported at CLI runtime without a TS loader.
+ * Compile `forge.config.ts` to `.js` first, or run with `tsx`:
+ *   npx tsx node_modules/.bin/forge dev
+ */
+export async function loadConfig(cwd) {
+    for (const candidate of CONFIG_CANDIDATES) {
+        const configPath = path.join(cwd, candidate);
+        if (fs.existsSync(configPath)) {
+            const fileUrl = url.pathToFileURL(configPath).href;
+            // Dynamic import — works for ESM and CJS configs alike.
+            const mod = (await import(fileUrl));
+            if (mod.default !== null && mod.default !== undefined && typeof mod.default === 'object') {
+                return mod.default;
+            }
+            return {};
+        }
+    }
+    // Warn if a TS config exists but cannot be loaded.
+    const tsConfigPath = path.join(cwd, 'forge.config.ts');
+    if (fs.existsSync(tsConfigPath)) {
+        console.warn('[Forge CLI] forge.config.ts found but cannot be loaded without a TS loader.\n' +
+            '  Tip: Compile it first (tsc forge.config.ts) or run via: npx tsx .../bin.js dev');
+    }
+    return {};
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,6BAA6B;AAC7B,6DAA6D;AAC7D,sEAAsE;AACtE,gFAAgF;AAEhF,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAGhC,MAAM,iBAAiB,GAAG;IACxB,iBAAiB;IACjB,kBAAkB;IAClB,kBAAkB;CACnB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW;IAC1C,KAAK,MAAM,SAAS,IAAI,iBAAiB,EAAE,CAAC;QAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC7C,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,GAAG,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;YACnD,wDAAwD;YACxD,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,CAA0B,CAAC;YAC7D,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACzF,OAAO,GAAG,CAAC,OAAsB,CAAC;YACpC,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IACvD,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,IAAI,CACV,+EAA+E;YAC7E,kFAAkF,CACrF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@vorra/cli",
+  "version": "0.3.0",
+  "description": "Vorra CLI — vorra new / vorra dev / vorra build",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ubergeoff/vorra.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/ubergeoff/vorra/tree/main/packages/cli#readme",
+  "keywords": [
+    "vorra",
+    "cli",
+    "dev-server",
+    "build-tool",
+    "framework"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "type": "module",
+  "bin": {
+    "vorra": "./dist/bin.js"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "rolldown -c rolldown.config.mjs",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  },
+  "dependencies": {
+    "@vorra/compiler": "*",
+    "rolldown": "*"
+  },
+  "devDependencies": {
+    "typescript": "*"
+  }
+}