@ramonyx/bundler 0.1.0 → 0.2.0

package/README.md

@@ -2,7 +2,7 @@
 
 Paket framework Ramonyx.
 
-> **Alpha (0.1.0)** — framework Node.js ini adalah baseline produksi;
+> **Alpha (0.2.0)** — framework Node.js ini adalah baseline produksi;
 > runtime Rust/V8 bersifat eksperimental. Butuh **Node.js ≥ 24**.
 
 ## Instalasi

package/dist/assets.d.ts

@@ -0,0 +1,39 @@
+import type { AssetResolver } from "@ramonyx/core";
+import { type AssetManifest, type AssetMap } from "./manifest.js";
+export type { AssetEntry, AssetMap } from "./manifest.js";
+/** Direktori aset default (relatif appDir) — dipindai otomatis bila ada. */
+export declare const DEFAULT_ASSETS_DIR = "src/assets";
+export interface CollectAssetsResult {
+    readonly assets: AssetMap;
+    readonly files: readonly string[];
+}
+/**
+ * Salin aset dari `assetsDir` ke `<clientOutDir>/assets/**` dengan nama ber-hash konten.
+ * Key manifest = path relatif posix terhadap `assetsDir` (mis. `img/logo.png`).
+ */
+export declare function collectAssets(assetsDir: string, clientOutDir: string): Promise<CollectAssetsResult>;
+export interface AssetUrlOptions {
+    /** Prefix URL publik; default `/assets`. */
+    readonly urlPrefix?: string;
+}
+/** URL publik entri aset; `undefined` bila path tidak ada di manifest. */
+export declare function assetUrl(manifest: AssetManifest | null, path: string, options?: AssetUrlOptions): string | undefined;
+export interface CreateAssetResolverOptions extends AssetUrlOptions {
+    /**
+     * Fallback ke `${prefix}/<path>` (tanpa hash) bila manifest belum ada/tidak memuat entri —
+     * untuk **dev** (Vite menyajikan `src/assets/**` apa adanya) — default false.
+     */
+    readonly fallbackToPath?: boolean;
+}
+/**
+ * Resolver aset untuk server (dipakai loader lewat `createPageRoutes({ assets })`):
+ * membaca manifest sekali; di dev pakai `fallbackToPath: true` (Vite menyajikan file mentah).
+ */
+export declare function createAssetResolver(clientDir: string, options?: CreateAssetResolverOptions): Promise<AssetResolver>;
+/** Direktori aset ada? (dipakai buildClient untuk memindai `src/assets` secara otomatis). */
+export declare function assetsDirExists(assetsDir: string): Promise<boolean>;
+/** Tag `<link rel="preload">` untuk font (masukkan lewat `metadata.head` halaman/dokumen). */
+export declare function fontPreloadTag(href: string, options?: {
+    readonly type?: string;
+    readonly crossorigin?: boolean;
+}): string;

package/dist/assets.js

@@ -0,0 +1,105 @@
+// Pipeline aset (ADR-0069, M1 — tanpa dependency): pindai `src/assets/**`, salin ke
+// `dist/client/assets/**` dengan **hash konten**, catat di `ramonyx.assets.json`, dan sediakan
+// resolver untuk server (`assetUrl`/`createAssetResolver`).
+//
+// Catatan desain: Node SSR tidak dapat `import foto.png` (hanya Vite/klien yang bisa). Karena itu
+// M1 memakai **manifest + helper** (bukan loader kustom) — paritas SSR ↔ klien tanpa mesin baru.
+import { createHash } from "node:crypto";
+import { copyFile, mkdir, readdir, readFile, stat } from "node:fs/promises";
+import { dirname, extname, join, posix, relative, sep } from "node:path";
+import { readAssetManifest, } from "./manifest.js";
+/** Direktori aset default (relatif appDir) — dipindai otomatis bila ada. */
+export const DEFAULT_ASSETS_DIR = "src/assets";
+async function collectFiles(dir, found = []) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.name.startsWith(".")) {
+            continue;
+        }
+        const path = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            await collectFiles(path, found);
+        }
+        else if (entry.isFile()) {
+            found.push(path);
+        }
+    }
+    return found;
+}
+/**
+ * Salin aset dari `assetsDir` ke `<clientOutDir>/assets/**` dengan nama ber-hash konten.
+ * Key manifest = path relatif posix terhadap `assetsDir` (mis. `img/logo.png`).
+ */
+export async function collectAssets(assetsDir, clientOutDir) {
+    const files = await collectFiles(assetsDir);
+    const assets = {};
+    const copied = [];
+    for (const file of files) {
+        const data = await readFile(file);
+        const hash = createHash("sha256").update(data).digest("hex").slice(0, 10);
+        const rel = relative(assetsDir, file).split(sep).join(posix.sep);
+        const ext = extname(rel);
+        const tanpaExt = rel.slice(0, rel.length - ext.length);
+        const targetRel = posix.join("assets", `${tanpaExt}-${hash}${ext}`);
+        const target = join(clientOutDir, targetRel);
+        await mkdir(dirname(target), { recursive: true });
+        await copyFile(file, target);
+        assets[rel] = { file: targetRel, bytes: data.byteLength };
+        copied.push(targetRel);
+    }
+    return { assets, files: copied };
+}
+/** URL publik entri aset; `undefined` bila path tidak ada di manifest. */
+export function assetUrl(manifest, path, options = {}) {
+    const entry = manifest?.assets?.[normalizeAssetPath(path)];
+    if (entry === undefined) {
+        return undefined;
+    }
+    const prefix = (options.urlPrefix ?? "/assets").replace(/\/$/, "");
+    const tanpaPrefix = entry.file.startsWith("assets/")
+        ? entry.file.slice("assets/".length)
+        : entry.file;
+    return `${prefix}/${tanpaPrefix}`;
+}
+function normalizeAssetPath(path) {
+    return path
+        .replace(/^\.?\//, "")
+        .split(sep)
+        .join(posix.sep);
+}
+/**
+ * Resolver aset untuk server (dipakai loader lewat `createPageRoutes({ assets })`):
+ * membaca manifest sekali; di dev pakai `fallbackToPath: true` (Vite menyajikan file mentah).
+ */
+export async function createAssetResolver(clientDir, options = {}) {
+    const manifest = await readAssetManifest(clientDir);
+    const prefix = (options.urlPrefix ?? "/assets").replace(/\/$/, "");
+    return {
+        url(path) {
+            const found = assetUrl(manifest, path, { urlPrefix: prefix });
+            if (found !== undefined) {
+                return found;
+            }
+            if (options.fallbackToPath === true) {
+                return `${prefix}/${normalizeAssetPath(path)}`;
+            }
+            return undefined;
+        },
+    };
+}
+/** Direktori aset ada? (dipakai buildClient untuk memindai `src/assets` secara otomatis). */
+export async function assetsDirExists(assetsDir) {
+    try {
+        return (await stat(assetsDir)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/** Tag `<link rel="preload">` untuk font (masukkan lewat `metadata.head` halaman/dokumen). */
+export function fontPreloadTag(href, options = {}) {
+    const type = options.type ?? "font/woff2";
+    const crossorigin = (options.crossorigin ?? true) ? " crossorigin" : "";
+    return `<link rel="preload" as="font" type="${type}" href="${href}"${crossorigin} />`;
+}
+//# sourceMappingURL=assets.js.map

package/dist/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../packages/bundler/src/assets.ts"],"names":[],"mappings":"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","sourcesContent":["// Pipeline aset (ADR-0069, M1 — tanpa dependency): pindai `src/assets/**`, salin ke\n// `dist/client/assets/**` dengan **hash konten**, catat di `ramonyx.assets.json`, dan sediakan\n// resolver untuk server (`assetUrl`/`createAssetResolver`).\n//\n// Catatan desain: Node SSR tidak dapat `import foto.png` (hanya Vite/klien yang bisa). Karena itu\n// M1 memakai **manifest + helper** (bukan loader kustom) — paritas SSR ↔ klien tanpa mesin baru.\n\nimport { createHash } from \"node:crypto\";\nimport { copyFile, mkdir, readdir, readFile, stat } from \"node:fs/promises\";\nimport { dirname, extname, join, posix, relative, sep } from \"node:path\";\nimport type { AssetResolver } from \"@ramonyx/core\";\nimport {\n  type AssetEntry,\n  type AssetManifest,\n  type AssetMap,\n  readAssetManifest,\n} from \"./manifest.ts\";\n\nexport type { AssetEntry, AssetMap } from \"./manifest.ts\";\n\n/** Direktori aset default (relatif appDir) — dipindai otomatis bila ada. */\nexport const DEFAULT_ASSETS_DIR = \"src/assets\";\n\nasync function collectFiles(dir: string, found: string[] = []): Promise<string[]> {\n  const entries = await readdir(dir, { withFileTypes: true });\n  for (const entry of entries) {\n    if (entry.name.startsWith(\".\")) {\n      continue;\n    }\n    const path = join(dir, entry.name);\n    if (entry.isDirectory()) {\n      await collectFiles(path, found);\n    } else if (entry.isFile()) {\n      found.push(path);\n    }\n  }\n  return found;\n}\n\nexport interface CollectAssetsResult {\n  readonly assets: AssetMap;\n  readonly files: readonly string[];\n}\n\n/**\n * Salin aset dari `assetsDir` ke `<clientOutDir>/assets/**` dengan nama ber-hash konten.\n * Key manifest = path relatif posix terhadap `assetsDir` (mis. `img/logo.png`).\n */\nexport async function collectAssets(\n  assetsDir: string,\n  clientOutDir: string,\n): Promise<CollectAssetsResult> {\n  const files = await collectFiles(assetsDir);\n  const assets: Record<string, AssetEntry> = {};\n  const copied: string[] = [];\n\n  for (const file of files) {\n    const data = await readFile(file);\n    const hash = createHash(\"sha256\").update(data).digest(\"hex\").slice(0, 10);\n    const rel = relative(assetsDir, file).split(sep).join(posix.sep);\n    const ext = extname(rel);\n    const tanpaExt = rel.slice(0, rel.length - ext.length);\n    const targetRel = posix.join(\"assets\", `${tanpaExt}-${hash}${ext}`);\n    const target = join(clientOutDir, targetRel);\n\n    await mkdir(dirname(target), { recursive: true });\n    await copyFile(file, target);\n\n    assets[rel] = { file: targetRel, bytes: data.byteLength };\n    copied.push(targetRel);\n  }\n\n  return { assets, files: copied };\n}\n\nexport interface AssetUrlOptions {\n  /** Prefix URL publik; default `/assets`. */\n  readonly urlPrefix?: string;\n}\n\n/** URL publik entri aset; `undefined` bila path tidak ada di manifest. */\nexport function assetUrl(\n  manifest: AssetManifest | null,\n  path: string,\n  options: AssetUrlOptions = {},\n): string | undefined {\n  const entry = manifest?.assets?.[normalizeAssetPath(path)];\n  if (entry === undefined) {\n    return undefined;\n  }\n  const prefix = (options.urlPrefix ?? \"/assets\").replace(/\\/$/, \"\");\n  const tanpaPrefix = entry.file.startsWith(\"assets/\")\n    ? entry.file.slice(\"assets/\".length)\n    : entry.file;\n  return `${prefix}/${tanpaPrefix}`;\n}\n\nfunction normalizeAssetPath(path: string): string {\n  return path\n    .replace(/^\\.?\\//, \"\")\n    .split(sep)\n    .join(posix.sep);\n}\n\nexport interface CreateAssetResolverOptions extends AssetUrlOptions {\n  /**\n   * Fallback ke `${prefix}/<path>` (tanpa hash) bila manifest belum ada/tidak memuat entri —\n   * untuk **dev** (Vite menyajikan `src/assets/**` apa adanya) — default false.\n   */\n  readonly fallbackToPath?: boolean;\n}\n\n/**\n * Resolver aset untuk server (dipakai loader lewat `createPageRoutes({ assets })`):\n * membaca manifest sekali; di dev pakai `fallbackToPath: true` (Vite menyajikan file mentah).\n */\nexport async function createAssetResolver(\n  clientDir: string,\n  options: CreateAssetResolverOptions = {},\n): Promise<AssetResolver> {\n  const manifest = await readAssetManifest(clientDir);\n  const prefix = (options.urlPrefix ?? \"/assets\").replace(/\\/$/, \"\");\n\n  return {\n    url(path: string): string | undefined {\n      const found = assetUrl(manifest, path, { urlPrefix: prefix });\n      if (found !== undefined) {\n        return found;\n      }\n      if (options.fallbackToPath === true) {\n        return `${prefix}/${normalizeAssetPath(path)}`;\n      }\n      return undefined;\n    },\n  };\n}\n\n/** Direktori aset ada? (dipakai buildClient untuk memindai `src/assets` secara otomatis). */\nexport async function assetsDirExists(assetsDir: string): Promise<boolean> {\n  try {\n    return (await stat(assetsDir)).isDirectory();\n  } catch {\n    return false;\n  }\n}\n\n/** Tag `<link rel=\"preload\">` untuk font (masukkan lewat `metadata.head` halaman/dokumen). */\nexport function fontPreloadTag(\n  href: string,\n  options: { readonly type?: string; readonly crossorigin?: boolean } = {},\n): string {\n  const type = options.type ?? \"font/woff2\";\n  const crossorigin = (options.crossorigin ?? true) ? \" crossorigin\" : \"\";\n  return `<link rel=\"preload\" as=\"font\" type=\"${type}\" href=\"${href}\"${crossorigin} />`;\n}\n"]}

package/dist/build.d.ts

@@ -1,4 +1,7 @@
-import type { LoadedPage } from "@ramonyx/core";
+import { type LoadedPage } from "@ramonyx/core";
+import { type PluginOption } from "vite";
+export type { AssetEntry, AssetManifest, AssetMap } from "./manifest.js";
+export { CLIENT_MANIFEST_FILE, readAssetManifest } from "./manifest.js";
 export interface BuildClientOptions {
     readonly appDir: string;
     readonly pages: readonly LoadedPage[];
@@ -6,17 +9,31 @@ export interface BuildClientOptions {
     readonly outDir?: string;
     /** Hasilkan source map (`.js.map` + `sourcesContent`); default true. */
     readonly sourcemap?: boolean;
-    /** URL publik bundle untuk `<script type="module">`; default "/assets/client.js". */
-    readonly scriptPath?: string;
+    /** Prefix URL publik aset (untuk `scriptPath` hasil); default "/assets". */
+    readonly assetsUrlPrefix?: string;
     readonly minify?: boolean;
+    /** Plugin Vite tambahan (dari plugin Ramonyx — ADR-0067). */
+    readonly plugins?: readonly PluginOption[];
+    /**
+     * Direktori aset (relatif appDir) yang dipindai & disalin ber-hash ke `assets/**` +
+     * dicatat di manifest (ADR-0069). Default `src/assets` bila ada; `false` mematikan.
+     */
+    readonly assetsDir?: string | false;
 }
 export interface BuildClientResult {
     readonly outDir: string;
+    /** URL bundle klien ber-fingerprint, mis. `/assets/client-D3fK2p.js`. */
     readonly scriptPath: string;
     readonly entryFile: string;
+    /** Nama berkas (relatif terhadap outDir) yang dihasilkan build. */
+    readonly files: readonly string[];
 }
+export declare function buildClient(options: BuildClientOptions): Promise<BuildClientResult>;
 /**
- * Membundel client (React + registry halaman) memakai Vite (ADR-0005).
- * Output ditulis ke `<appDir>/dist/client` dan siap disajikan sebagai aset statis.
+ * URL bundle klien dari manifest hasil build — dipakai server (`ramonyx start`, aplikasi)
+ * agar tetap benar saat nama berkas ber-hash. Fallback `/assets/client.js` bila manifest
+ * belum ada (mis. server dijalankan tanpa build — CLI sudah memperingatkan).
  */
-export declare function buildClient(options: BuildClientOptions): Promise<BuildClientResult>;
+export declare function readClientScript(clientDir: string, options?: {
+    urlPrefix?: string;
+}): Promise<string>;

package/dist/build.js

@@ -1,15 +1,77 @@
-import { mkdir, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 import { generateClientEntry } from "@ramonyx/compiler";
+import { errorHint } from "@ramonyx/core";
 import { build } from "vite";
+import { collectAssets, DEFAULT_ASSETS_DIR } from "./assets.js";
+import { CLIENT_MANIFEST_FILE, readAssetManifest, writeAssetManifest, } from "./manifest.js";
+import { serverOnlyPlugin } from "./server-only.js";
+export { CLIENT_MANIFEST_FILE, readAssetManifest } from "./manifest.js";
+const SERVER_ONLY_IMPORT = /(?:from|import\s*\(|require\s*\()\s*["'](node:[^"']+)["']/g;
+const BROWSER_EXTERNAL_MARKER = "__vite-browser-external";
 /**
  * Membundel client (React + registry halaman) memakai Vite (ADR-0005).
- * Output ditulis ke `<appDir>/dist/client` dan siap disajikan sebagai aset statis.
+ *
+ * Nama berkas memuat **hash konten** (`client-<hash>.js`, ADR-0055) sehingga dapat disajikan
+ * dengan `cache-control: immutable`; peta nama ditulis ke `ramonyx.assets.json` dan dibaca
+ * server lewat `readClientScript`.
  */
+/** Pre-check (ADR-0063): modul yang masuk bundle klien (page/layout) dilarang mengimpor `node:*`. */
+async function assertClientFilesBrowserSafe(pages) {
+    const files = new Set();
+    for (const page of pages) {
+        if (page.pageFile !== undefined) {
+            files.add(page.pageFile);
+        }
+        for (const layout of page.layoutFiles ?? []) {
+            files.add(layout);
+        }
+    }
+    const violations = [];
+    for (const file of files) {
+        let source;
+        try {
+            source = await readFile(file, "utf8");
+        }
+        catch {
+            continue;
+        }
+        for (const match of source.matchAll(SERVER_ONLY_IMPORT)) {
+            violations.push(`${file} → ${match[1] ?? "?"}`);
+        }
+    }
+    if (violations.length > 0) {
+        throw new Error("Batas server/client dilanggar (ADR-0063): modul yang masuk bundle klien mengimpor API server:\n" +
+            violations.map((entry) => `  - ${entry}`).join("\n") +
+            "\nPindahkan kode server ke modul `*.server.ts` yang hanya diimpor dari loader/action/route API, " +
+            `atau akses lewat API route. ${errorHint("RMX-BUILD-1")}`);
+    }
+}
+/** Post-build (ADR-0063): output tidak boleh memuat shim browser-external Vite atau `node:*` (impor transitif). */
+async function assertBundleBrowserSafe(outDir) {
+    const files = (await readdir(outDir, { recursive: true })).filter((file) => file.endsWith(".js"));
+    const violations = new Set();
+    for (const file of files) {
+        const source = await readFile(join(outDir, file), "utf8");
+        if (source.includes(BROWSER_EXTERNAL_MARKER)) {
+            violations.add(file);
+        }
+        for (const match of source.matchAll(SERVER_ONLY_IMPORT)) {
+            violations.add(`${file} → ${match[1] ?? "?"}`);
+        }
+    }
+    if (violations.size > 0) {
+        throw new Error("Bundel klien memuat API server (ADR-0063) — kemungkinan impor transitif dari modul klien:\n" +
+            [...violations].map((entry) => `  - ${entry}`).join("\n") +
+            `\nPisahkan modul server (\`*.server.ts\`) dan impor hanya dari loader/action/route API. ${errorHint("RMX-BUILD-2")}`);
+    }
+}
 export async function buildClient(options) {
     const outDir = join(options.appDir, options.outDir ?? "dist/client");
     const entryDir = join(options.appDir, ".ramonyx");
     const entryFile = join(entryDir, "client-entry.ts");
+    await assertClientFilesBrowserSafe(options.pages);
     await mkdir(entryDir, { recursive: true });
     await writeFile(entryFile, generateClientEntry(options.pages, { from: entryDir }));
     await build({
@@ -17,6 +79,7 @@ export async function buildClient(options) {
         root: options.appDir,
         logLevel: "warn",
         esbuild: { jsx: "automatic" },
+        plugins: [...(options.plugins ?? []), serverOnlyPlugin()],
         build: {
             outDir,
             emptyOutDir: true,
@@ -29,17 +92,45 @@ export async function buildClient(options) {
             rollupOptions: {
                 input: entryFile,
                 output: {
-                    entryFileNames: "client.js",
+                    entryFileNames: "client-[hash].js",
                     chunkFileNames: "chunks/[name]-[hash].js",
-                    assetFileNames: "[name][extname]",
+                    assetFileNames: "[name]-[hash][extname]",
                 },
             },
         },
     });
-    return {
-        outDir,
-        scriptPath: options.scriptPath ?? "/assets/client.js",
-        entryFile,
+    await assertBundleBrowserSafe(outDir);
+    const files = (await readdir(outDir, { recursive: true })).filter((file) => !file.endsWith(CLIENT_MANIFEST_FILE));
+    const clientFile = files.find((file) => /^client-.*\.js$/.test(file));
+    if (clientFile === undefined) {
+        throw new Error(`build klien tidak menghasilkan client-<hash>.js di ${outDir}`);
+    }
+    // Pipeline aset (ADR-0069): pindai `src/assets/**` → salin ber-hash + catat di manifest.
+    const assetsDir = options.assetsDir === false
+        ? null
+        : join(options.appDir, options.assetsDir ?? DEFAULT_ASSETS_DIR);
+    let assets = {};
+    if (assetsDir !== null && existsSync(assetsDir)) {
+        const collected = await collectAssets(assetsDir, outDir);
+        assets = collected.assets;
+    }
+    const manifest = {
+        client: clientFile,
+        files: [...files].sort(),
+        ...(Object.keys(assets).length > 0 ? { assets } : {}),
     };
+    await writeAssetManifest(outDir, manifest);
+    const prefix = (options.assetsUrlPrefix ?? "/assets").replace(/\/$/, "");
+    return { outDir, scriptPath: `${prefix}/${clientFile}`, entryFile, files: manifest.files };
+}
+/**
+ * URL bundle klien dari manifest hasil build — dipakai server (`ramonyx start`, aplikasi)
+ * agar tetap benar saat nama berkas ber-hash. Fallback `/assets/client.js` bila manifest
+ * belum ada (mis. server dijalankan tanpa build — CLI sudah memperingatkan).
+ */
+export async function readClientScript(clientDir, options = {}) {
+    const prefix = (options.urlPrefix ?? "/assets").replace(/\/$/, "");
+    const manifest = await readAssetManifest(clientDir);
+    return manifest === null ? `${prefix}/client.js` : `${prefix}/${manifest.client}`;
 }
 //# sourceMappingURL=build.js.map

package/dist/build.js.map

@@ -1 +1 @@
-{"version":3,"file":"build.js","sourceRoot":"","sources":["../../../packages/bundler/src/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAoB7B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA2B;IAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAEpD,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,SAAS,CAAC,SAAS,EAAE,mBAAmB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAEnF,MAAM,KAAK,CAAC;QACV,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE,OAAO,CAAC,MAAM;QACpB,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE;QAC7B,KAAK,EAAE;YACL,MAAM;YACN,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;YAC/B,gFAAgF;YAChF,2DAA2D;YAC3D,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;YACpC,aAAa,EAAE,KAAK;YACpB,aAAa,EAAE;gBACb,KAAK,EAAE,SAAS;gBAChB,MAAM,EAAE;oBACN,cAAc,EAAE,WAAW;oBAC3B,cAAc,EAAE,yBAAyB;oBACzC,cAAc,EAAE,iBAAiB;iBAClC;aACF;SACF;KACF,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,mBAAmB;QACrD,SAAS;KACV,CAAC;AACJ,CAAC","sourcesContent":["import { mkdir, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { generateClientEntry } from \"@ramonyx/compiler\";\nimport type { LoadedPage } from \"@ramonyx/core\";\nimport { build } from \"vite\";\n\nexport interface BuildClientOptions {\n  readonly appDir: string;\n  readonly pages: readonly LoadedPage[];\n  /** Relatif terhadap appDir; default \"dist/client\". */\n  readonly outDir?: string;\n  /** Hasilkan source map (`.js.map` + `sourcesContent`); default true. */\n  readonly sourcemap?: boolean;\n  /** URL publik bundle untuk `<script type=\"module\">`; default \"/assets/client.js\". */\n  readonly scriptPath?: string;\n  readonly minify?: boolean;\n}\n\nexport interface BuildClientResult {\n  readonly outDir: string;\n  readonly scriptPath: string;\n  readonly entryFile: string;\n}\n\n/**\n * Membundel client (React + registry halaman) memakai Vite (ADR-0005).\n * Output ditulis ke `<appDir>/dist/client` dan siap disajikan sebagai aset statis.\n */\nexport async function buildClient(options: BuildClientOptions): Promise<BuildClientResult> {\n  const outDir = join(options.appDir, options.outDir ?? \"dist/client\");\n  const entryDir = join(options.appDir, \".ramonyx\");\n  const entryFile = join(entryDir, \"client-entry.ts\");\n\n  await mkdir(entryDir, { recursive: true });\n  await writeFile(entryFile, generateClientEntry(options.pages, { from: entryDir }));\n\n  await build({\n    configFile: false,\n    root: options.appDir,\n    logLevel: \"warn\",\n    esbuild: { jsx: \"automatic\" },\n    build: {\n      outDir,\n      emptyOutDir: true,\n      target: \"es2022\",\n      minify: options.minify ?? false,\n      // Source map produksi (default aktif): `sourcesContent` di-embed agar map tetap\n      // berguna walau sumber TS tidak ikut disajikan (ADR-0046).\n      sourcemap: options.sourcemap ?? true,\n      modulePreload: false,\n      rollupOptions: {\n        input: entryFile,\n        output: {\n          entryFileNames: \"client.js\",\n          chunkFileNames: \"chunks/[name]-[hash].js\",\n          assetFileNames: \"[name][extname]\",\n        },\n      },\n    },\n  });\n\n  return {\n    outDir,\n    scriptPath: options.scriptPath ?? \"/assets/client.js\",\n    entryFile,\n  };\n}\n"]}
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../../packages/bundler/src/build.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync } from \"node:fs\";\nimport { mkdir, readdir, readFile, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { generateClientEntry } from \"@ramonyx/compiler\";\nimport { errorHint, type LoadedPage } from \"@ramonyx/core\";\nimport { build, type PluginOption } from \"vite\";\nimport { collectAssets, DEFAULT_ASSETS_DIR } from \"./assets.ts\";\nimport {\n  type AssetManifest,\n  CLIENT_MANIFEST_FILE,\n  readAssetManifest,\n  writeAssetManifest,\n} from \"./manifest.ts\";\nimport { serverOnlyPlugin } from \"./server-only.ts\";\n\nexport type { AssetEntry, AssetManifest, AssetMap } from \"./manifest.ts\";\nexport { CLIENT_MANIFEST_FILE, readAssetManifest } from \"./manifest.ts\";\n\nconst SERVER_ONLY_IMPORT = /(?:from|import\\s*\\(|require\\s*\\()\\s*[\"'](node:[^\"']+)[\"']/g;\nconst BROWSER_EXTERNAL_MARKER = \"__vite-browser-external\";\n\nexport interface BuildClientOptions {\n  readonly appDir: string;\n  readonly pages: readonly LoadedPage[];\n  /** Relatif terhadap appDir; default \"dist/client\". */\n  readonly outDir?: string;\n  /** Hasilkan source map (`.js.map` + `sourcesContent`); default true. */\n  readonly sourcemap?: boolean;\n  /** Prefix URL publik aset (untuk `scriptPath` hasil); default \"/assets\". */\n  readonly assetsUrlPrefix?: string;\n  readonly minify?: boolean;\n  /** Plugin Vite tambahan (dari plugin Ramonyx — ADR-0067). */\n  readonly plugins?: readonly PluginOption[];\n  /**\n   * Direktori aset (relatif appDir) yang dipindai & disalin ber-hash ke `assets/**` +\n   * dicatat di manifest (ADR-0069). Default `src/assets` bila ada; `false` mematikan.\n   */\n  readonly assetsDir?: string | false;\n}\n\nexport interface BuildClientResult {\n  readonly outDir: string;\n  /** URL bundle klien ber-fingerprint, mis. `/assets/client-D3fK2p.js`. */\n  readonly scriptPath: string;\n  readonly entryFile: string;\n  /** Nama berkas (relatif terhadap outDir) yang dihasilkan build. */\n  readonly files: readonly string[];\n}\n\n/**\n * Membundel client (React + registry halaman) memakai Vite (ADR-0005).\n *\n * Nama berkas memuat **hash konten** (`client-<hash>.js`, ADR-0055) sehingga dapat disajikan\n * dengan `cache-control: immutable`; peta nama ditulis ke `ramonyx.assets.json` dan dibaca\n * server lewat `readClientScript`.\n */\n/** Pre-check (ADR-0063): modul yang masuk bundle klien (page/layout) dilarang mengimpor `node:*`. */\nasync function assertClientFilesBrowserSafe(pages: readonly LoadedPage[]): Promise<void> {\n  const files = new Set<string>();\n  for (const page of pages) {\n    if (page.pageFile !== undefined) {\n      files.add(page.pageFile);\n    }\n    for (const layout of page.layoutFiles ?? []) {\n      files.add(layout);\n    }\n  }\n\n  const violations: string[] = [];\n  for (const file of files) {\n    let source: string;\n    try {\n      source = await readFile(file, \"utf8\");\n    } catch {\n      continue;\n    }\n    for (const match of source.matchAll(SERVER_ONLY_IMPORT)) {\n      violations.push(`${file} → ${match[1] ?? \"?\"}`);\n    }\n  }\n\n  if (violations.length > 0) {\n    throw new Error(\n      \"Batas server/client dilanggar (ADR-0063): modul yang masuk bundle klien mengimpor API server:\\n\" +\n        violations.map((entry) => `  - ${entry}`).join(\"\\n\") +\n        \"\\nPindahkan kode server ke modul `*.server.ts` yang hanya diimpor dari loader/action/route API, \" +\n        `atau akses lewat API route. ${errorHint(\"RMX-BUILD-1\")}`,\n    );\n  }\n}\n\n/** Post-build (ADR-0063): output tidak boleh memuat shim browser-external Vite atau `node:*` (impor transitif). */\nasync function assertBundleBrowserSafe(outDir: string): Promise<void> {\n  const files = (await readdir(outDir, { recursive: true })).filter((file) => file.endsWith(\".js\"));\n  const violations = new Set<string>();\n  for (const file of files) {\n    const source = await readFile(join(outDir, file), \"utf8\");\n    if (source.includes(BROWSER_EXTERNAL_MARKER)) {\n      violations.add(file);\n    }\n    for (const match of source.matchAll(SERVER_ONLY_IMPORT)) {\n      violations.add(`${file} → ${match[1] ?? \"?\"}`);\n    }\n  }\n\n  if (violations.size > 0) {\n    throw new Error(\n      \"Bundel klien memuat API server (ADR-0063) — kemungkinan impor transitif dari modul klien:\\n\" +\n        [...violations].map((entry) => `  - ${entry}`).join(\"\\n\") +\n        `\\nPisahkan modul server (\\`*.server.ts\\`) dan impor hanya dari loader/action/route API. ${errorHint(\"RMX-BUILD-2\")}`,\n    );\n  }\n}\n\nexport async function buildClient(options: BuildClientOptions): Promise<BuildClientResult> {\n  const outDir = join(options.appDir, options.outDir ?? \"dist/client\");\n  const entryDir = join(options.appDir, \".ramonyx\");\n  const entryFile = join(entryDir, \"client-entry.ts\");\n\n  await assertClientFilesBrowserSafe(options.pages);\n\n  await mkdir(entryDir, { recursive: true });\n  await writeFile(entryFile, generateClientEntry(options.pages, { from: entryDir }));\n\n  await build({\n    configFile: false,\n    root: options.appDir,\n    logLevel: \"warn\",\n    esbuild: { jsx: \"automatic\" },\n    plugins: [...(options.plugins ?? []), serverOnlyPlugin()],\n    build: {\n      outDir,\n      emptyOutDir: true,\n      target: \"es2022\",\n      minify: options.minify ?? false,\n      // Source map produksi (default aktif): `sourcesContent` di-embed agar map tetap\n      // berguna walau sumber TS tidak ikut disajikan (ADR-0046).\n      sourcemap: options.sourcemap ?? true,\n      modulePreload: false,\n      rollupOptions: {\n        input: entryFile,\n        output: {\n          entryFileNames: \"client-[hash].js\",\n          chunkFileNames: \"chunks/[name]-[hash].js\",\n          assetFileNames: \"[name]-[hash][extname]\",\n        },\n      },\n    },\n  });\n\n  await assertBundleBrowserSafe(outDir);\n\n  const files = (await readdir(outDir, { recursive: true })).filter(\n    (file) => !file.endsWith(CLIENT_MANIFEST_FILE),\n  );\n  const clientFile = files.find((file) => /^client-.*\\.js$/.test(file));\n  if (clientFile === undefined) {\n    throw new Error(`build klien tidak menghasilkan client-<hash>.js di ${outDir}`);\n  }\n\n  // Pipeline aset (ADR-0069): pindai `src/assets/**` → salin ber-hash + catat di manifest.\n  const assetsDir =\n    options.assetsDir === false\n      ? null\n      : join(options.appDir, options.assetsDir ?? DEFAULT_ASSETS_DIR);\n  let assets: Awaited<ReturnType<typeof collectAssets>>[\"assets\"] = {};\n  if (assetsDir !== null && existsSync(assetsDir)) {\n    const collected = await collectAssets(assetsDir, outDir);\n    assets = collected.assets;\n  }\n\n  const manifest: AssetManifest = {\n    client: clientFile,\n    files: [...files].sort(),\n    ...(Object.keys(assets).length > 0 ? { assets } : {}),\n  };\n  await writeAssetManifest(outDir, manifest);\n\n  const prefix = (options.assetsUrlPrefix ?? \"/assets\").replace(/\\/$/, \"\");\n  return { outDir, scriptPath: `${prefix}/${clientFile}`, entryFile, files: manifest.files };\n}\n\n/**\n * URL bundle klien dari manifest hasil build — dipakai server (`ramonyx start`, aplikasi)\n * agar tetap benar saat nama berkas ber-hash. Fallback `/assets/client.js` bila manifest\n * belum ada (mis. server dijalankan tanpa build — CLI sudah memperingatkan).\n */\nexport async function readClientScript(\n  clientDir: string,\n  options: { urlPrefix?: string } = {},\n): Promise<string> {\n  const prefix = (options.urlPrefix ?? \"/assets\").replace(/\\/$/, \"\");\n  const manifest = await readAssetManifest(clientDir);\n  return manifest === null ? `${prefix}/client.js` : `${prefix}/${manifest.client}`;\n}\n"]}

package/dist/dev.d.ts

@@ -1,15 +1,21 @@
 import { type ModuleImporter } from "@ramonyx/compiler";
+import { type PluginOption } from "vite";
+import { type DevtoolsCollector } from "./devtools.js";
 export interface DevServerOptions {
     readonly appDir: string;
     /** URL server SSR yang diproksikan (mis. "http://localhost:3000"). */
     readonly target: string;
     readonly port?: number;
+    /** Plugin Vite tambahan (dari plugin Ramonyx — ADR-0067). */
+    readonly plugins?: readonly PluginOption[];
 }
 export interface DevServer {
     readonly url: string;
     /** Importer untuk compiler: modul mengikuti module graph Vite (invalidasi saat file berubah). */
     readonly importer: ModuleImporter;
     readonly target: string;
+    /** Kolektor panel devtools (ADR-0077) — pasang `hooks`/`middleware`-nya ke handler aplikasi. */
+    readonly devtools: DevtoolsCollector;
     close(): Promise<void>;
 }
 /**

package/dist/dev.js

@@ -1,10 +1,70 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import { join, relative } from "node:path";
+import { existsSync } from "node:fs";
+import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import { extname, join, relative } from "node:path";
 import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import { generateClientEntry, loadPageRoutes, RouteManifestError, } from "@ramonyx/compiler";
 import { createServer } from "vite";
+import { createDevtoolsCollector, devtoolsPanelHtml } from "./devtools.js";
+import { readAssetManifest } from "./manifest.js";
+import { serverOnlyPlugin } from "./server-only.js";
 const ENTRY_FILE = "client-entry.ts";
+const DEV_ASSET_TYPES = {
+    ".svg": "image/svg+xml",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".avif": "image/avif",
+    ".ico": "image/x-icon",
+    ".woff": "font/woff",
+    ".woff2": "font/woff2",
+    ".ttf": "font/ttf",
+    ".otf": "font/otf",
+};
+/**
+ * Dev: sajikan `src/assets/**` apa adanya di `/assets/*` (tanpa hash) — paritas dengan
+ * resolver aset dev (`createAssetResolver(..., { fallbackToPath: true })`, ADR-0069).
+ */
+function assetsDevPlugin(appDir) {
+    return {
+        name: "ramonyx-assets-dev",
+        configureServer(server) {
+            server.middlewares.use((req, res, next) => {
+                const url = req.url ?? "";
+                if (!url.startsWith("/assets/")) {
+                    next();
+                    return;
+                }
+                let rel;
+                try {
+                    rel = decodeURIComponent(url.slice("/assets/".length).split("?")[0] ?? "");
+                }
+                catch {
+                    next();
+                    return;
+                }
+                if (rel.length === 0 || rel.includes("..")) {
+                    next();
+                    return;
+                }
+                const file = join(appDir, "src", "assets", rel);
+                if (!existsSync(file)) {
+                    next();
+                    return;
+                }
+                void readFile(file)
+                    .then((data) => {
+                    res.setHeader("content-type", DEV_ASSET_TYPES[extname(file).toLowerCase()] ?? "application/octet-stream");
+                    res.setHeader("cache-control", "no-cache");
+                    res.end(data);
+                })
+                    .catch(() => next());
+            });
+        },
+    };
+}
 /** Path yang dimiliki Vite (jangan diproksikan ke SSR). */
 function isViteRequest(url) {
     const path = url.split("?")[0] ?? "";
@@ -82,6 +142,33 @@ export async function createDevServer(options) {
     const entryDir = join(appDir, ".ramonyx");
     const entryFile = join(entryDir, ENTRY_FILE);
     const routesDir = join(appDir, "src", "routes");
+    const devtools = createDevtoolsCollector();
+    const clientDir = join(appDir, "dist", "client");
+    /** Ukuran bundel/aset dari manifest build (bila sudah pernah dibangun). */
+    const refreshAssets = async () => {
+        const manifest = await readAssetManifest(clientDir);
+        if (manifest === null) {
+            devtools.setAssets([]);
+            return;
+        }
+        const names = new Set([manifest.client, ...manifest.files]);
+        const entries = [];
+        for (const name of names) {
+            try {
+                const info = await stat(join(clientDir, name));
+                entries.push({ name, bytes: info.size });
+            }
+            catch {
+                // berkas hilang (mis. dibersihkan) — lewati
+            }
+        }
+        if (manifest.assets !== undefined) {
+            for (const entry of Object.values(manifest.assets)) {
+                entries.push({ name: entry.file, bytes: entry.bytes });
+            }
+        }
+        devtools.setAssets(entries);
+    };
     const vite = await createServer({
         configFile: false,
         root: appDir,
@@ -90,6 +177,34 @@ export async function createDevServer(options) {
         esbuild: { jsx: "automatic" },
         server: { port: options.port ?? 5173 },
         plugins: [
+            ...(options.plugins ?? []),
+            serverOnlyPlugin(),
+            assetsDevPlugin(appDir),
+            {
+                name: "ramonyx-devtools",
+                configureServer(server) {
+                    server.middlewares.use((req, res, next) => {
+                        const path = (req.url ?? "").split("?")[0] ?? "";
+                        if (path === "/__ramonyx/devtools") {
+                            res.setHeader("content-type", "text/html; charset=utf-8");
+                            res.setHeader("cache-control", "no-store");
+                            res.end(devtoolsPanelHtml());
+                            return;
+                        }
+                        if (path === "/__ramonyx/data") {
+                            void refreshAssets()
+                                .catch(() => undefined)
+                                .then(() => {
+                                res.setHeader("content-type", "application/json; charset=utf-8");
+                                res.setHeader("cache-control", "no-store");
+                                res.end(JSON.stringify(devtools.snapshot()));
+                            });
+                            return;
+                        }
+                        next();
+                    });
+                },
+            },
             {
                 name: "ramonyx-ssr-proxy",
                 configureServer(server) {
@@ -114,6 +229,10 @@ export async function createDevServer(options) {
     };
     const regenerateEntry = async () => {
         const pages = await loadPageRoutes({ dir: routesDir, importer });
+        devtools.setRoutes(pages.map((page) => ({
+            path: page.path,
+            ...(page.pageFile !== undefined ? { file: relative(appDir, page.pageFile) } : {}),
+        })));
         await mkdir(entryDir, { recursive: true });
         await writeFile(entryFile, generateClientEntry(pages, { from: entryDir }));
     };
@@ -135,6 +254,7 @@ export async function createDevServer(options) {
         url: `http://localhost:${port}`,
         importer,
         target: options.target,
+        devtools,
         close: () => vite.close(),
     };
 }