elegance-js 3.0.0 → 3.0.2

package/README.md

@@ -0,0 +1,90 @@
+# Elegance
+
+Elegance is a TypeScript framework for web applications. It provides file‑system routing, reactive state, server‑side rendering, and client‑side interactivity in a single codebase.
+
+## Features
+
+- Ridiculous speed: Up to ~24x faster build times compared to Next.JS, and up to ~1400x raw RPS on API Routes.
+- Optimized: 4KB client runtime
+- File‑system routing: pages and API endpoints are defined by the directory structure.
+- TSX support: use TSX with no runtime overhead.
+- Server & Client hybrid: You can write server & client-code in 1 file with no issues.
+- Reactive: atoms and components with automatic dependency tracking.
+- Dynamic rendering: opt into per‑request rendering or statically enumerate paths.
+- Server Actions: Inline API routes into your page files for faster development times.
+- Middleware: scoped request processing with the ability to pass data to downstream handlers.
+- Built‑in bundling: code splitting and advanced dead‑code elimination (DCE).
+- API routes: define `GET`, `POST`, `PUT`, `DELETE`, and `OPTIONS` handlers.
+
+## Quick Start
+
+```bash
+npx create-elegance-app my-app
+cd my-app
+npx elegance
+```
+
+Visit `http://localhost:3000` to see the default page.
+
+## Example
+
+A simple counter:
+
+```tsx
+const counter = state(0);
+
+export default function CounterPage() {
+    return div(
+        button({
+            onClick: () => counter.value++,
+        }, 
+            `Counter: ${counter.value}`
+        )
+    );
+}
+```
+
+A reusable component version:
+
+```tsx
+const Counter = component({
+    atoms: {
+        counter: 0,
+    },
+    view(_, { counter }) {
+        return button({
+            onClick: () => counter.value++,
+        }, 
+            `Counter: ${counter.value}`
+        );
+    }
+});
+
+export default function Page() {
+    return Counter();
+}
+```
+
+## Project Structure
+
+```
+my-app/
+├── pages/
+│   ├── page.tsx          # / (home)
+│   ├── about/
+│   │   └── page.tsx      # /about
+│   ├── api/
+│   │   └── route.ts      # /api/*
+│   ├── [slug]/
+│   │   └── page.tsx      # dynamic routes
+│   └── middleware.ts     # global middleware
+└── ...
+```
+
+## Documentation
+
+Full documentation is available via [Our Website](https://elegance.js.org/)
+
+## License
+
+MIT

package/bin/export.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+import { spawn, ChildProcess } from "node:child_process";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname  = dirname(__filename);
+
+const BUILD_PROD_ENTRY  = join(__dirname, "build", "prod.js");
+
+const MODE = process.argv.includes("-prod") ? "prod" : "dev";
+
+function spawnTs(entry, extraEnv = {}) {
+    return spawn("node", ["--import", "ts-arc/register", entry], {
+        stdio: ["inherit", "inherit", "inherit", "ipc"],
+        env: {
+            ...process.env,
+            ELEGANCE_DEV_MODE: MODE,
+            ARGS: JSON.stringify(process.argv.slice(2)),
+            ...extraEnv,
+        },
+    });
+}
+
+function spawnBuild() {
+    return spawnTs(BUILD_PROD_ENTRY);
+}
+
+function runBuild() {
+    return new Promise((resolve, reject) => {
+        const build = spawnBuild();
+
+        build.once("exit", (code) => {
+            if (code === 0 || code === null) resolve();
+            else reject(new Error(`Build process exited with code ${code}`));
+        });
+    });
+}
+
+(async () => {
+    await runBuild();
+})();

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "elegance-js",
-  "version": "3.0.0",
+  "version": "3.0.2",
   "type": "module",
   "main": "dist/user-utils.js",
   "bin": {
     "bootstrap": "./bin/bootstrap.js",
-    "elegance": "./bin/run.js"
+    "elegance": "./bin/run.js",
+    "export": "./bin/export.js"
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "lint": "oxlint ./src --fix -D unused-variable -D unused-import",
     "build": "esbuild './src/*.ts' './src/**/*.ts' --outdir=./dist --outbase=./src --format=esm --platform=node --bundle=false && tsc --emitDeclarationOnly && node scripts/fix-imports.js"
@@ -62,4 +65,4 @@
     "oxlint": "^1.68.0",
     "typescript": "^5.0.0"
   }
-}
+}