@constela/cli 0.3.8 → 0.3.10

package/README.md

@@ -0,0 +1,177 @@
+# @constela/cli
+
+Command-line tools for the Constela UI framework.
+
+## Installation
+
+```bash
+npm install -g @constela/cli
+```
+
+Or use with npx:
+
+```bash
+npx constela <command>
+```
+
+## Commands
+
+### constela compile
+
+Compiles a Constela DSL file to a program.
+
+```bash
+constela compile <input> [options]
+```
+
+**Arguments:**
+- `<input>` - Input DSL file (JSON)
+
+**Options:**
+- `-o, --out <path>` - Output file path
+- `--pretty` - Pretty-print JSON output
+
+**Examples:**
+
+```bash
+# Compile to stdout
+constela compile app.json
+
+# Compile to file
+constela compile app.json --out dist/app.compiled.json
+
+# Pretty-print output
+constela compile app.json --pretty
+```
+
+### constela dev
+
+Starts the development server with hot reload.
+
+```bash
+constela dev [options]
+```
+
+**Options:**
+- `-p, --port <number>` - Server port (default: 3000)
+- `--host <string>` - Server host (default: localhost)
+
+**Examples:**
+
+```bash
+# Default settings
+constela dev
+
+# Custom port
+constela dev --port 8080
+
+# Accessible from network
+constela dev --host 0.0.0.0
+```
+
+### constela build
+
+Builds the application for production.
+
+```bash
+constela build [options]
+```
+
+**Options:**
+- `-o, --outDir <path>` - Output directory (default: dist)
+
+**Examples:**
+
+```bash
+# Default output to dist/
+constela build
+
+# Custom output directory
+constela build --outDir build
+```
+
+**Output:**
+- Static HTML files for each route
+- Bundled runtime JavaScript
+- Copied public assets
+
+### constela start
+
+Starts the production server.
+
+```bash
+constela start [options]
+```
+
+**Options:**
+- `-p, --port <number>` - Server port (default: 3000)
+
+**Examples:**
+
+```bash
+# Default settings
+constela start
+
+# Custom port
+constela start --port 8080
+```
+
+The server binds to `0.0.0.0` by default for deployment compatibility.
+
+## Project Structure
+
+The CLI expects the following project structure:
+
+```
+project/
+  src/
+    pages/           # Page files (.json, .ts)
+      index.json     # / route
+      about.json     # /about route
+      users/
+        [id].json    # /users/:id route
+    layouts/         # Layout files (optional)
+      default.json
+      docs.json
+  public/            # Static assets
+    styles/
+    images/
+  content/           # Content files (optional)
+    blog/
+      *.mdx
+```
+
+## Configuration
+
+Create a `constela.config.ts` file in your project root:
+
+```typescript
+import type { ConstelaConfig } from '@constela/start';
+
+export default {
+  adapter: 'node', // 'cloudflare' | 'vercel' | 'deno' | 'node'
+  ssg: {
+    routes: ['/about', '/contact'],
+  },
+} satisfies ConstelaConfig;
+```
+
+## Exit Codes
+
+| Code | Description |
+|------|-------------|
+| 0 | Success |
+| 1 | Compilation error |
+| 1 | Server startup failed |
+| 1 | Build failed |
+
+## Signals
+
+The `start` command handles graceful shutdown:
+
+- `SIGINT` (Ctrl+C) - Graceful shutdown
+- `SIGTERM` - Graceful shutdown
+
+## License
+
+MIT

package/dist/index.js

@@ -80,18 +80,34 @@ async function compileCommand(inputPath, options) {
 }
 
 // src/commands/dev.ts
-import { createDevServer } from "@constela/start";
+import { createDevServer, loadConfig, resolveConfig } from "@constela/start";
 async function devCommand(options) {
-  const port = options.port ? parseInt(options.port, 10) : 3e3;
-  if (Number.isNaN(port)) {
+  const port = options.port ? parseInt(options.port, 10) : void 0;
+  if (options.port !== void 0 && Number.isNaN(port)) {
     console.error("Error: Invalid port number");
     process.exit(1);
   }
-  const host = options.host ?? "localhost";
   try {
-    const server = await createDevServer({ port, host });
+    const fileConfig = await loadConfig(process.cwd());
+    const resolvedConfig = await resolveConfig(fileConfig, {
+      port,
+      host: options.host,
+      routesDir: options.routesDir,
+      publicDir: options.publicDir,
+      layoutsDir: options.layoutsDir
+    });
+    const serverPort = resolvedConfig.dev?.port ?? port ?? 3e3;
+    const serverHost = resolvedConfig.dev?.host ?? options.host ?? "localhost";
+    const server = await createDevServer({
+      port: serverPort,
+      host: serverHost,
+      ...resolvedConfig.routesDir && { routesDir: resolvedConfig.routesDir },
+      ...resolvedConfig.publicDir && { publicDir: resolvedConfig.publicDir },
+      ...resolvedConfig.layoutsDir && { layoutsDir: resolvedConfig.layoutsDir },
+      ...resolvedConfig.css && { css: resolvedConfig.css }
+    });
     await server.listen();
-    console.log(`Development server running at http://${host}:${server.port}`);
+    console.log(`Development server running at http://${serverHost}:${server.port}`);
     process.on("SIGINT", async () => {
       console.log("\nShutting down server...");
       await server.close();
@@ -109,12 +125,24 @@ async function devCommand(options) {
 }
 
 // src/commands/build.ts
-import { build } from "@constela/start";
+import { build, loadConfig as loadConfig2, resolveConfig as resolveConfig2 } from "@constela/start";
 async function buildCommand(options) {
-  const outDir = options.outDir ?? "dist";
   try {
     console.log("Building for production...");
-    const result = await build({ outDir });
+    const fileConfig = await loadConfig2(process.cwd());
+    const resolvedConfig = await resolveConfig2(fileConfig, {
+      outDir: options.outDir,
+      routesDir: options.routesDir,
+      publicDir: options.publicDir,
+      layoutsDir: options.layoutsDir
+    });
+    const result = await build({
+      outDir: resolvedConfig.build?.outDir ?? options.outDir ?? "dist",
+      routesDir: resolvedConfig.routesDir,
+      publicDir: resolvedConfig.publicDir,
+      layoutsDir: resolvedConfig.layoutsDir,
+      css: resolvedConfig.css
+    });
     console.log("Build completed: " + result.outDir);
     if (result.routes.length > 0) {
       console.log("Routes: " + result.routes.join(", "));
@@ -158,8 +186,8 @@ async function startCommand(options) {
 var program = new Command();
 program.name("constela").description("Constela UI framework CLI").version("0.1.0");
 program.command("compile <input>").description("Compile a Constela DSL file").option("-o, --out <path>", "Output file path").option("--pretty", "Pretty-print JSON output").action(compileCommand);
-program.command("dev").description("Start development server").option("-p, --port <number>", "Port number (default: 3000)").option("--host <string>", "Host address").action(devCommand);
-program.command("build").description("Build for production").option("-o, --outDir <path>", "Output directory (default: dist)").action(buildCommand);
+program.command("dev").description("Start development server").option("-p, --port <number>", "Port number (default: 3000)").option("--host <string>", "Host address").option("--routesDir <path>", "Routes directory").option("--publicDir <path>", "Public directory").option("--layoutsDir <path>", "Layouts directory").action(devCommand);
+program.command("build").description("Build for production").option("-o, --outDir <path>", "Output directory (default: dist)").option("--routesDir <path>", "Routes directory").option("--publicDir <path>", "Public directory").option("--layoutsDir <path>", "Layouts directory").action(buildCommand);
 program.command("start").description("Start production server").option("-p, --port <number>", "Port number (default: 3000)").action(startCommand);
 if (process.argv.length <= 2) {
   program.outputHelp();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constela/cli",
-  "version": "0.3.8",
+  "version": "0.3.10",
   "description": "CLI tools for Constela UI framework",
   "type": "module",
   "main": "./dist/index.js",
@@ -19,9 +19,9 @@
   ],
   "dependencies": {
     "commander": "^12.0.0",
-    "@constela/compiler": "0.7.0",
     "@constela/core": "0.7.0",
-    "@constela/start": "1.2.1"
+    "@constela/compiler": "0.7.0",
+    "@constela/start": "1.2.3"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",