create-ramonyx-app 0.1.0 → 0.1.1

package/README.md

@@ -2,7 +2,7 @@
 
 Scaffolder aplikasi Ramonyx — SSR React + hydration, file routing `src/routes`.
 
-> **Alpha (0.1.0)** — butuh **Node.js ≥ 24**.
+> **Alpha (0.1.1)** — butuh **Node.js ≥ 24**.
 
 ## Pemakaian
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ramonyx-app",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Scaffolder aplikasi Ramonyx (SSR React + hydration, file routing src/routes).",
   "license": "MIT",
   "type": "module",

package/template/README.md

@@ -8,17 +8,19 @@ Aplikasi [Ramonyx](https://github.com/ramonyx/ramonyx) — framework full-stack
 
 ```bash
 pnpm install
-pnpm build     # bundel klien (wajib sebelum start)
-pnpm start     # http://127.0.0.1:3000 (React build produksi: NODE_ENV=production)
-pnpm dev       # mode watch (jalankan `pnpm build` setelah mengubah UI klien)
+pnpm dev       # Vite + HMR (http://localhost:5173) → SSR :3000
+pnpm build     # bundel klien (wajib sebelum start produksi)
+pnpm start     # http://127.0.0.1:3000 (NODE_ENV=production otomatis)
 ```
 
+Perintah memakai CLI **`ramonyx`** (`@ramonyx/devtools`): `ramonyx dev|build|start|doctor`.
+
 ## Struktur
 
+- `src/app.ts` — mengekspor `createApp(options?)` (dipakai CLI)
 - `src/routes/page.tsx` — halaman (loader + komponen React; `layout.tsx`/`error.tsx` opsional)
 - `src/routes/api/halo/[nama].ts` — route API (`export const GET = route({ ... })`)
 - `src/routes/middleware.ts` — security headers + CSP nonce + aset `/assets/*`
-- `build.ts` — bundel klien (Vite) lewat `@ramonyx/bundler`
 - `ramonyx.config.ts` — port/host + strict validation
 
 ## Endpoint contoh

package/template/package.json

@@ -6,14 +6,13 @@
     "node": ">=24"
   },
   "scripts": {
-    "build": "node --import @ramonyx/compiler/register build.ts",
-    "start": "NODE_ENV=production node --import @ramonyx/compiler/register src/main.ts",
-    "dev": "node --watch --import @ramonyx/compiler/register src/main.ts"
+    "build": "ramonyx build",
+    "start": "ramonyx start",
+    "dev": "ramonyx dev"
   },
   "dependencies": {
-    "@ramonyx/adapter-runtime": "^0.1.0",
-    "@ramonyx/bundler": "^0.1.0",
     "@ramonyx/compiler": "^0.1.0",
+    "@ramonyx/devtools": "^0.1.0",
     "@ramonyx/react": "^0.1.0",
     "@ramonyx/security": "^0.1.0",
     "@ramonyx/server": "^0.1.0",

package/template/src/app.ts

@@ -1,5 +1,5 @@
 import { fileURLToPath } from "node:url";
-import { createRouteManifest, loadPageRoutes } from "@ramonyx/compiler";
+import { createRouteManifest, loadPageRoutes, type ModuleImporter } from "@ramonyx/compiler";
 import { createReactRenderer } from "@ramonyx/react";
 import { createHandler } from "@ramonyx/server";
 import { createPageRoutes } from "@ramonyx/ssr";
@@ -7,32 +7,57 @@ import type { FetchHandler } from "ramonyx";
 
 import middleware from "./routes/middleware.ts";
 
+export interface CreateAppOptions {
+  /** URL bundle klien (produksi "/assets/client.js"; dev via entry Vite). */
+  readonly clientScript?: string;
+  /** Modul tambahan sebelum entry (mis. "/@vite/client"). */
+  readonly clientModules?: readonly string[];
+  /** Importer modul (dev: module graph Vite). */
+  readonly importer?: ModuleImporter;
+  /** Bangun ulang manifest tiap request (dev, tanpa restart). */
+  readonly reloadManifests?: boolean;
+  readonly strictValidation?: boolean;
+  /** SSR streaming untuk halaman (ADR-0047). */
+  readonly streaming?: boolean;
+}
+
 /**
  * Aplikasi __APP_NAME__: route API + halaman SSR React dari `src/routes` (file routing),
- * dengan hydration klien (`/assets/client.js` — jalankan `pnpm build` dulu).
+ * dengan hydration klien.
  *
- * Konvensi folder `src/routes`:
- * - `page.tsx` — halaman (loader + komponen React; boleh `layout.tsx`, `error.tsx`);
- * - `api/*.ts` — route API (`export const GET = route({ ... })`).
+ * Dijalankan lewat CLI: `ramonyx dev` (Vite + HMR), `ramonyx build` (bundle klien),
+ * `ramonyx start` (produksi — `NODE_ENV=production` otomatis).
  */
-export async function createApp(): Promise<FetchHandler> {
+export async function createApp(options: CreateAppOptions = {}): Promise<FetchHandler> {
   const dir = fileURLToPath(new URL("./routes", import.meta.url));
+  const client =
+    options.clientScript === undefined
+      ? undefined
+      : { script: options.clientScript, extraModules: options.clientModules };
+
+  const build = async (): Promise<FetchHandler> => {
+    const [apiRoutes, pages] = await Promise.all([
+      createRouteManifest({ dir, importer: options.importer }),
+      loadPageRoutes({ dir, importer: options.importer }),
+    ]);
 
-  const [apiRoutes, pages] = await Promise.all([
-    createRouteManifest({ dir }),
-    loadPageRoutes({ dir }),
-  ]);
+    return createHandler({
+      routes: [
+        ...apiRoutes,
+        ...createPageRoutes({
+          pages,
+          renderer: createReactRenderer(),
+          client,
+          streaming: options.streaming,
+        }),
+      ],
+      middleware,
+      strictValidation: options.strictValidation,
+    });
+  };
 
-  return createHandler({
-    strictValidation: true,
-    routes: [
-      ...apiRoutes,
-      ...createPageRoutes({
-        pages,
-        renderer: createReactRenderer(),
-        client: { script: "/assets/client.js" },
-      }),
-    ],
-    middleware,
-  });
+  if (options.reloadManifests === true) {
+    return async (request) => (await build())(request);
+  }
+  return build();
 }

package/template/build.ts

@@ -1,13 +0,0 @@
-// Build client (React + hydration) lewat Vite — jalankan `pnpm build` sebelum `pnpm start`
-// di produksi. Hasil: `dist/client/client.js` disajikan di `/assets/client.js`.
-
-import { join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { buildClient } from "@ramonyx/bundler";
-import { loadPageRoutes } from "@ramonyx/compiler";
-
-const appDir = fileURLToPath(new URL(".", import.meta.url));
-const pages = await loadPageRoutes({ dir: join(appDir, "src/routes") });
-const result = await buildClient({ appDir, pages });
-
-console.log(`✓ client bundle: ${result.scriptPath} (${result.outDir})`);

package/template/src/main.ts

@@ -1,16 +0,0 @@
-import { createNodeHost } from "@ramonyx/adapter-runtime";
-import { resolveConfig } from "ramonyx";
-
-import config from "../ramonyx.config.ts";
-import { createApp } from "./app.ts";
-
-const resolved = resolveConfig(config);
-const host = createNodeHost();
-const app = await createApp();
-
-const server = await host.serve(app, {
-  port: resolved.server.port,
-  host: resolved.server.host,
-});
-
-console.log(`__APP_NAME__ berjalan di ${server.url}`);