@ramonyx/bundler 0.1.1 → 0.2.0

package/dist/prerender.d.ts

@@ -0,0 +1,49 @@
+import { type FetchHandler, type LoadedPage } from "@ramonyx/core";
+export interface PrerenderOptions {
+    /** Handler aplikasi (hasil `createApp()` dengan `clientScript` produksi). */
+    readonly handler: FetchHandler;
+    /** Halaman hasil `loadPageRoutes` (untuk enumerasi rute statis + `getStaticPaths`). */
+    readonly pages: readonly LoadedPage[];
+    /** Direktori keluaran (mis. `dist/static`). */
+    readonly outDir: string;
+    /** Rute tambahan eksplisit (mis. dari enumerasi aplikasi sendiri). */
+    readonly paths?: readonly string[];
+    /** Sertakan rute statis (tanpa param) dari manifest; default true. */
+    readonly includeStaticPages?: boolean;
+    /** Path sintetis untuk halaman 404; default `/__ramonyx-404__`. */
+    readonly notFoundPath?: string;
+    /** Salin direktori aset klien ke `<outDir>/assets`. */
+    readonly clientDir?: string;
+    /** Tulis `.nojekyll` (hosting GitHub Pages). */
+    readonly nojekyll?: boolean;
+    /** Origin sintetis untuk request prerender. */
+    readonly origin?: string;
+    /** Transformasi HTML per rute (mis. menyuntik link discovery agen). */
+    readonly transformHtml?: (html: string, routePath: string) => string;
+    /** Tulis `<rute>/index.html` (default true) atau `<rute>.html`. */
+    readonly directoryIndex?: boolean;
+}
+export interface PrerenderRouteInfo {
+    readonly path: string;
+    readonly file: string;
+    readonly status: number;
+    readonly bytes: number;
+}
+export interface PrerenderResult {
+    readonly routes: readonly PrerenderRouteInfo[];
+    readonly skipped: readonly {
+        readonly path: string;
+        readonly reason: string;
+    }[];
+    readonly notFoundFile: string | null;
+}
+/**
+ * Render rute → HTML statis di `outDir`.
+ *
+ * - Rute statis (tanpa param) dari manifest ikut kecuali `page.prerender === false`.
+ * - Rute dinamis dienumerasi lewat `getStaticPaths` (bila ada) + `paths` eksplisit.
+ * - Halaman 404 ditulis dari `notFoundPath`; aset klien disalin bila `clientDir` diisi.
+ * - Status non-2xx pada rute = error build (kecuali halaman 404 yang memang non-2xx?
+ *   tidak: 404 harus 404; kegagalan lain menggagalkan build dengan pesan jelas).
+ */
+export declare function prerenderRoutes(options: PrerenderOptions): Promise<PrerenderResult>;

package/dist/prerender.js

@@ -0,0 +1,104 @@
+// Static generation (SSG) — ADR-0056: render rute menjadi HTML saat build.
+//
+// Dipakai `ramonyx build --static` (CLI) dan aplikasi yang mengekspor sendiri
+// (mis. situs docs: `apps/docs/export.ts`). Handler aplikasi dijalankan dengan request
+// sintetis sehingga paritas SSR ↔ statis terjaga (satu pipeline, bukan renderer kedua).
+import { cp, mkdir, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fillRouteParams, hasDynamicSegment, } from "@ramonyx/core";
+function routeToFile(outDir, route, directoryIndex) {
+    if (route === "" || route === "/") {
+        return join(outDir, "index.html");
+    }
+    const clean = route.replace(/^\//, "").replace(/\/$/, "");
+    return directoryIndex ? join(outDir, clean, "index.html") : join(outDir, `${clean}.html`);
+}
+/**
+ * Render rute → HTML statis di `outDir`.
+ *
+ * - Rute statis (tanpa param) dari manifest ikut kecuali `page.prerender === false`.
+ * - Rute dinamis dienumerasi lewat `getStaticPaths` (bila ada) + `paths` eksplisit.
+ * - Halaman 404 ditulis dari `notFoundPath`; aset klien disalin bila `clientDir` diisi.
+ * - Status non-2xx pada rute = error build (kecuali halaman 404 yang memang non-2xx?
+ *   tidak: 404 harus 404; kegagalan lain menggagalkan build dengan pesan jelas).
+ */
+export async function prerenderRoutes(options) {
+    const origin = options.origin ?? "http://prerender.local";
+    const directoryIndex = options.directoryIndex ?? true;
+    const includeStatic = options.includeStaticPages ?? true;
+    const routes = new Set();
+    const skipped = [];
+    for (const page of options.pages) {
+        const prerender = page.page.prerender;
+        if (prerender === false) {
+            skipped.push({ path: page.path, reason: "prerender: false" });
+            continue;
+        }
+        if (!hasDynamicSegment(page.path)) {
+            if (includeStatic) {
+                routes.add(page.path);
+            }
+            continue;
+        }
+        const enumerate = page.page.getStaticPaths;
+        if (enumerate === undefined) {
+            skipped.push({ path: page.path, reason: "rute dinamis tanpa getStaticPaths" });
+            continue;
+        }
+        for (const params of await enumerate()) {
+            const filled = fillRouteParams(page.path, params);
+            if (filled === null) {
+                skipped.push({ path: page.path, reason: `param kurang: ${JSON.stringify(params)}` });
+                continue;
+            }
+            routes.add(filled);
+        }
+    }
+    for (const path of options.paths ?? []) {
+        routes.add(path);
+    }
+    const rendered = [];
+    for (const route of [...routes].sort()) {
+        const response = await options.handler(new Request(new URL(route, origin)));
+        const contentType = response.headers.get("content-type") ?? "";
+        if (!contentType.includes("text/html")) {
+            throw new Error(`prerender ${route}: respons bukan HTML (content-type: ${contentType || "kosong"}, status ${response.status})`);
+        }
+        const html = await response.text();
+        if (response.status >= 400) {
+            const cuplikan = html.replace(/\s+/g, " ").slice(0, 200);
+            throw new Error(`prerender ${route}: status ${response.status} (halaman harus 2xx) — ${cuplikan}`);
+        }
+        const file = routeToFile(options.outDir, route, directoryIndex);
+        await mkdir(dirname(file), { recursive: true });
+        const output = options.transformHtml === undefined ? html : options.transformHtml(html, route);
+        await writeFile(file, output);
+        rendered.push({
+            path: route,
+            file,
+            status: response.status,
+            bytes: Buffer.byteLength(output),
+        });
+    }
+    let notFoundFile = null;
+    if (options.notFoundPath !== undefined) {
+        const response = await options.handler(new Request(new URL(options.notFoundPath, origin)));
+        if (response.status !== 404) {
+            throw new Error(`prerender 404: path "${options.notFoundPath}" menghasilkan status ${response.status} (harus 404)`);
+        }
+        notFoundFile = join(options.outDir, "404.html");
+        const html = await response.text();
+        const output = options.transformHtml === undefined
+            ? html
+            : options.transformHtml(html, options.notFoundPath);
+        await writeFile(notFoundFile, output);
+    }
+    if (options.clientDir !== undefined) {
+        await cp(options.clientDir, join(options.outDir, "assets"), { recursive: true });
+    }
+    if (options.nojekyll === true) {
+        await writeFile(join(options.outDir, ".nojekyll"), "");
+    }
+    return { routes: rendered, skipped, notFoundFile };
+}
+//# sourceMappingURL=prerender.js.map

package/dist/prerender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prerender.js","sourceRoot":"","sources":["../../../packages/bundler/src/prerender.ts"],"names":[],"mappings":"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","sourcesContent":["// Static generation (SSG) — ADR-0056: render rute menjadi HTML saat build.\n//\n// Dipakai `ramonyx build --static` (CLI) dan aplikasi yang mengekspor sendiri\n// (mis. situs docs: `apps/docs/export.ts`). Handler aplikasi dijalankan dengan request\n// sintetis sehingga paritas SSR ↔ statis terjaga (satu pipeline, bukan renderer kedua).\n\nimport { cp, mkdir, writeFile } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\nimport {\n  type FetchHandler,\n  fillRouteParams,\n  hasDynamicSegment,\n  type LoadedPage,\n} from \"@ramonyx/core\";\n\nexport interface PrerenderOptions {\n  /** Handler aplikasi (hasil `createApp()` dengan `clientScript` produksi). */\n  readonly handler: FetchHandler;\n  /** Halaman hasil `loadPageRoutes` (untuk enumerasi rute statis + `getStaticPaths`). */\n  readonly pages: readonly LoadedPage[];\n  /** Direktori keluaran (mis. `dist/static`). */\n  readonly outDir: string;\n  /** Rute tambahan eksplisit (mis. dari enumerasi aplikasi sendiri). */\n  readonly paths?: readonly string[];\n  /** Sertakan rute statis (tanpa param) dari manifest; default true. */\n  readonly includeStaticPages?: boolean;\n  /** Path sintetis untuk halaman 404; default `/__ramonyx-404__`. */\n  readonly notFoundPath?: string;\n  /** Salin direktori aset klien ke `<outDir>/assets`. */\n  readonly clientDir?: string;\n  /** Tulis `.nojekyll` (hosting GitHub Pages). */\n  readonly nojekyll?: boolean;\n  /** Origin sintetis untuk request prerender. */\n  readonly origin?: string;\n  /** Transformasi HTML per rute (mis. menyuntik link discovery agen). */\n  readonly transformHtml?: (html: string, routePath: string) => string;\n  /** Tulis `<rute>/index.html` (default true) atau `<rute>.html`. */\n  readonly directoryIndex?: boolean;\n}\n\nexport interface PrerenderRouteInfo {\n  readonly path: string;\n  readonly file: string;\n  readonly status: number;\n  readonly bytes: number;\n}\n\nexport interface PrerenderResult {\n  readonly routes: readonly PrerenderRouteInfo[];\n  readonly skipped: readonly { readonly path: string; readonly reason: string }[];\n  readonly notFoundFile: string | null;\n}\n\nfunction routeToFile(outDir: string, route: string, directoryIndex: boolean): string {\n  if (route === \"\" || route === \"/\") {\n    return join(outDir, \"index.html\");\n  }\n  const clean = route.replace(/^\\//, \"\").replace(/\\/$/, \"\");\n  return directoryIndex ? join(outDir, clean, \"index.html\") : join(outDir, `${clean}.html`);\n}\n\n/**\n * Render rute → HTML statis di `outDir`.\n *\n * - Rute statis (tanpa param) dari manifest ikut kecuali `page.prerender === false`.\n * - Rute dinamis dienumerasi lewat `getStaticPaths` (bila ada) + `paths` eksplisit.\n * - Halaman 404 ditulis dari `notFoundPath`; aset klien disalin bila `clientDir` diisi.\n * - Status non-2xx pada rute = error build (kecuali halaman 404 yang memang non-2xx?\n *   tidak: 404 harus 404; kegagalan lain menggagalkan build dengan pesan jelas).\n */\nexport async function prerenderRoutes(options: PrerenderOptions): Promise<PrerenderResult> {\n  const origin = options.origin ?? \"http://prerender.local\";\n  const directoryIndex = options.directoryIndex ?? true;\n  const includeStatic = options.includeStaticPages ?? true;\n\n  const routes = new Set<string>();\n  const skipped: Array<{ path: string; reason: string }> = [];\n\n  for (const page of options.pages) {\n    const prerender = page.page.prerender;\n    if (prerender === false) {\n      skipped.push({ path: page.path, reason: \"prerender: false\" });\n      continue;\n    }\n    if (!hasDynamicSegment(page.path)) {\n      if (includeStatic) {\n        routes.add(page.path);\n      }\n      continue;\n    }\n    const enumerate = page.page.getStaticPaths;\n    if (enumerate === undefined) {\n      skipped.push({ path: page.path, reason: \"rute dinamis tanpa getStaticPaths\" });\n      continue;\n    }\n    for (const params of await enumerate()) {\n      const filled = fillRouteParams(page.path, params);\n      if (filled === null) {\n        skipped.push({ path: page.path, reason: `param kurang: ${JSON.stringify(params)}` });\n        continue;\n      }\n      routes.add(filled);\n    }\n  }\n  for (const path of options.paths ?? []) {\n    routes.add(path);\n  }\n\n  const rendered: PrerenderRouteInfo[] = [];\n  for (const route of [...routes].sort()) {\n    const response = await options.handler(new Request(new URL(route, origin)));\n    const contentType = response.headers.get(\"content-type\") ?? \"\";\n    if (!contentType.includes(\"text/html\")) {\n      throw new Error(\n        `prerender ${route}: respons bukan HTML (content-type: ${contentType || \"kosong\"}, status ${response.status})`,\n      );\n    }\n    const html = await response.text();\n    if (response.status >= 400) {\n      const cuplikan = html.replace(/\\s+/g, \" \").slice(0, 200);\n      throw new Error(\n        `prerender ${route}: status ${response.status} (halaman harus 2xx) — ${cuplikan}`,\n      );\n    }\n    const file = routeToFile(options.outDir, route, directoryIndex);\n    await mkdir(dirname(file), { recursive: true });\n    const output = options.transformHtml === undefined ? html : options.transformHtml(html, route);\n    await writeFile(file, output);\n    rendered.push({\n      path: route,\n      file,\n      status: response.status,\n      bytes: Buffer.byteLength(output),\n    });\n  }\n\n  let notFoundFile: string | null = null;\n  if (options.notFoundPath !== undefined) {\n    const response = await options.handler(new Request(new URL(options.notFoundPath, origin)));\n    if (response.status !== 404) {\n      throw new Error(\n        `prerender 404: path \"${options.notFoundPath}\" menghasilkan status ${response.status} (harus 404)`,\n      );\n    }\n    notFoundFile = join(options.outDir, \"404.html\");\n    const html = await response.text();\n    const output =\n      options.transformHtml === undefined\n        ? html\n        : options.transformHtml(html, options.notFoundPath);\n    await writeFile(notFoundFile, output);\n  }\n\n  if (options.clientDir !== undefined) {\n    await cp(options.clientDir, join(options.outDir, \"assets\"), { recursive: true });\n  }\n  if (options.nojekyll === true) {\n    await writeFile(join(options.outDir, \".nojekyll\"), \"\");\n  }\n\n  return { routes: rendered, skipped, notFoundFile };\n}\n"]}

package/dist/server-only.d.ts

@@ -0,0 +1,6 @@
+import type { Plugin } from "vite";
+/**
+ * Plugin untuk `buildClient`: setiap impor `*.server.ts` diresolusi ke stub yang melempar
+ * bila dipanggil di browser.
+ */
+export declare function serverOnlyPlugin(): Plugin;

package/dist/server-only.js

@@ -0,0 +1,69 @@
+// Plugin Vite: modul `*.server.ts` diganti **stub** di bundle klien (ADR-0063).
+//
+// Pola "server-only": halaman boleh mengimpor modul server (dipakai `loader`/`action` yang
+// berjalan di server), tetapi bundle klien menerima stub yang melempar bila dipanggil dari
+// kode klien — bukan kebocoran implementasi/API server.
+import { readFile } from "node:fs/promises";
+const SERVER_MODULE = /\.server\.(ts|tsx|js|mjs)$/;
+const VIRTUAL_PREFIX = "\0ramonyx-server-stub:";
+/** Nama ekspor dari sumber server (regex ringan — tipe/interface diabaikan). */
+function exportedNames(source) {
+    const names = new Set();
+    for (const match of source.matchAll(/export\s+(?:async\s+)?(?:function|const|let|var|class)\s+([A-Za-z_$][\w$]*)/g)) {
+        if (match[1] !== undefined) {
+            names.add(match[1]);
+        }
+    }
+    for (const match of source.matchAll(/export\s*\{([^}]*)\}/g)) {
+        for (const part of (match[1] ?? "").split(",")) {
+            const cleaned = part.trim().replace(/^type\s+/, "");
+            if (cleaned.length === 0) {
+                continue;
+            }
+            const alias = cleaned.split(/\s+as\s+/);
+            const name = (alias[1] ?? alias[0] ?? "").trim();
+            if (name.length > 0 && name !== "default") {
+                names.add(name);
+            }
+        }
+    }
+    return [...names].sort();
+}
+function stubSource(file, names) {
+    const poison = (name) => `(() => { throw new Error(${JSON.stringify(`"${name}" dari ${file} hanya tersedia di server — impor modul ini dari loader/action/route API, bukan kode klien (ADR-0063).`)}); })`;
+    const lines = [
+        "// Stub server-only (digenerate @ramonyx/bundler — ADR-0063).",
+        ...names.map((name) => `export const ${name} = ${poison(name)};`),
+        `export default ${poison("default")};`,
+    ];
+    return `${lines.join("\n")}\n`;
+}
+/**
+ * Plugin untuk `buildClient`: setiap impor `*.server.ts` diresolusi ke stub yang melempar
+ * bila dipanggil di browser.
+ */
+export function serverOnlyPlugin() {
+    return {
+        name: "ramonyx-server-only",
+        enforce: "pre",
+        async resolveId(source, importer) {
+            if (!SERVER_MODULE.test(source) || importer === undefined) {
+                return null;
+            }
+            const resolved = await this.resolve(source, importer, { skipSelf: true });
+            if (resolved === null) {
+                return null;
+            }
+            return `${VIRTUAL_PREFIX}${resolved.id}`;
+        },
+        async load(id) {
+            if (!id.startsWith(VIRTUAL_PREFIX)) {
+                return null;
+            }
+            const file = id.slice(VIRTUAL_PREFIX.length);
+            const source = await readFile(file, "utf8");
+            return stubSource(file, exportedNames(source));
+        },
+    };
+}
+//# sourceMappingURL=server-only.js.map

package/dist/server-only.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-only.js","sourceRoot":"","sources":["../../../packages/bundler/src/server-only.ts"],"names":[],"mappings":"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","sourcesContent":["// Plugin Vite: modul `*.server.ts` diganti **stub** di bundle klien (ADR-0063).\n//\n// Pola \"server-only\": halaman boleh mengimpor modul server (dipakai `loader`/`action` yang\n// berjalan di server), tetapi bundle klien menerima stub yang melempar bila dipanggil dari\n// kode klien — bukan kebocoran implementasi/API server.\n\nimport { readFile } from \"node:fs/promises\";\nimport type { Plugin } from \"vite\";\n\nconst SERVER_MODULE = /\\.server\\.(ts|tsx|js|mjs)$/;\nconst VIRTUAL_PREFIX = \"\\0ramonyx-server-stub:\";\n\n/** Nama ekspor dari sumber server (regex ringan — tipe/interface diabaikan). */\nfunction exportedNames(source: string): string[] {\n  const names = new Set<string>();\n  for (const match of source.matchAll(\n    /export\\s+(?:async\\s+)?(?:function|const|let|var|class)\\s+([A-Za-z_$][\\w$]*)/g,\n  )) {\n    if (match[1] !== undefined) {\n      names.add(match[1]);\n    }\n  }\n  for (const match of source.matchAll(/export\\s*\\{([^}]*)\\}/g)) {\n    for (const part of (match[1] ?? \"\").split(\",\")) {\n      const cleaned = part.trim().replace(/^type\\s+/, \"\");\n      if (cleaned.length === 0) {\n        continue;\n      }\n      const alias = cleaned.split(/\\s+as\\s+/);\n      const name = (alias[1] ?? alias[0] ?? \"\").trim();\n      if (name.length > 0 && name !== \"default\") {\n        names.add(name);\n      }\n    }\n  }\n  return [...names].sort();\n}\n\nfunction stubSource(file: string, names: readonly string[]): string {\n  const poison = (name: string): string =>\n    `(() => { throw new Error(${JSON.stringify(\n      `\"${name}\" dari ${file} hanya tersedia di server — impor modul ini dari loader/action/route API, bukan kode klien (ADR-0063).`,\n    )}); })`;\n  const lines = [\n    \"// Stub server-only (digenerate @ramonyx/bundler — ADR-0063).\",\n    ...names.map((name) => `export const ${name} = ${poison(name)};`),\n    `export default ${poison(\"default\")};`,\n  ];\n  return `${lines.join(\"\\n\")}\\n`;\n}\n\n/**\n * Plugin untuk `buildClient`: setiap impor `*.server.ts` diresolusi ke stub yang melempar\n * bila dipanggil di browser.\n */\nexport function serverOnlyPlugin(): Plugin {\n  return {\n    name: \"ramonyx-server-only\",\n    enforce: \"pre\",\n    async resolveId(source, importer) {\n      if (!SERVER_MODULE.test(source) || importer === undefined) {\n        return null;\n      }\n      const resolved = await this.resolve(source, importer, { skipSelf: true });\n      if (resolved === null) {\n        return null;\n      }\n      return `${VIRTUAL_PREFIX}${resolved.id}`;\n    },\n    async load(id) {\n      if (!id.startsWith(VIRTUAL_PREFIX)) {\n        return null;\n      }\n      const file = id.slice(VIRTUAL_PREFIX.length);\n      const source = await readFile(file, \"utf8\");\n      return stubSource(file, exportedNames(source));\n    },\n  };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ramonyx/bundler",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Paket framework Ramonyx.",
   "license": "MIT",
   "type": "module",
@@ -19,8 +19,8 @@
     "node": ">=24"
   },
   "dependencies": {
-    "@ramonyx/compiler": "^0.1.1",
-    "@ramonyx/core": "^0.1.1",
+    "@ramonyx/compiler": "^0.2.0",
+    "@ramonyx/core": "^0.2.0",
     "vite": "8.3.4"
   },
   "publishConfig": {