jskelet 0.6.4 → 0.6.6

package/src/build/tasks/client.mjs

@@ -15,6 +15,7 @@ import fs from "node:fs";
 import path from "node:path";
 import process from "node:process";
 import * as esbuild from "esbuild";
+import { chunkGroupsPlugin } from "../chunk-groups.mjs";
 import { paths, patchManifest, pruneAssets } from "../paths.mjs";
 import * as log from "../../log.mjs";
 
@@ -187,13 +188,34 @@ export async function buildClient(config, { watch = false } = {}) {
     .split(path.sep)
     .join("/");
 
+  const clientBuild = config.build?.client ?? {
+    splitting: true,
+    groups: {},
+    chunkGroup: null,
+  };
+  const splitting = clientBuild.splitting !== false;
+  const groups = splitting ? (clientBuild.groups ?? {}) : {};
+  const chunkGroup = splitting ? (clientBuild.chunkGroup ?? null) : null;
+
+  const groupPlugin = splitting
+    ? chunkGroupsPlugin({
+        root: config.root,
+        groups,
+        chunkGroup,
+      })
+    : null;
+
+  /** @type {esbuild.Plugin[]} */
+  const plugins = [aliasPlugin(config.root)];
+  if (groupPlugin) plugins.push(groupPlugin);
+
   /** @type {esbuild.BuildOptions} */
   const options = {
     entryPoints,
     outdir: outDir,
     absWorkingDir: config.root,
     bundle: true,
-    splitting: true,
+    splitting,
     format: "esm",
     target: ["chrome111", "edge111", "firefox111", "safari16.4"],
     minify: true,
@@ -203,10 +225,15 @@ export async function buildClient(config, { watch = false } = {}) {
     entryNames: "[name].[hash]",
     chunkNames: "chunks/[name].[hash]",
     legalComments: "none",
-    plugins: [aliasPlugin(config.root)],
+    plugins,
     define: {
       "process.env": JSON.stringify(publicEnv(config.clientEnv)),
     },
+    // Grup sarmalayıcısı her üyede `export { default }` yazar; named-only
+    // modüllerde bu uyarı gürültü — davranış yine doğru (default undefined).
+    ...(groupPlugin
+      ? { logOverride: { "import-is-undefined": "silent" } }
+      : {}),
   };
 
   if (watch) {
@@ -218,8 +245,7 @@ export async function buildClient(config, { watch = false } = {}) {
     await context.watch();
     writeMetafile(result.metafile);
     const manifest = toManifest(result.metafile, config, entryRoot);
-    const entries = Object.keys(manifest).length;
-    log.detail(`${entries} ${entries === 1 ? "entry" : "entries"}`);
+    log.detail(summarizeClientBuild(manifest, result.metafile));
     return manifest;
   }
 
@@ -230,11 +256,32 @@ export async function buildClient(config, { watch = false } = {}) {
     (sum, output) => sum + output.bytes,
     0,
   );
-  const entries = Object.keys(manifest).length;
-  log.detail(`${entries} ${entries === 1 ? "entry" : "entries"}, ${log.size(bytes)}`);
+  log.detail(
+    `${summarizeClientBuild(manifest, result.metafile)}, ${log.size(bytes)}`,
+  );
   return manifest;
 }
 
+/**
+ * Entry + inject edilen group entry'ler metafile'da durur; teşhis için
+ * hem gerçek manifest entry sayısını hem toplam çıktı dosyasını yaz.
+ *
+ * @param {Record<string, string>} manifest
+ * @param {esbuild.Metafile} [metafile]
+ * @returns {string}
+ */
+function summarizeClientBuild(manifest, metafile) {
+  const entries = Object.keys(manifest).length;
+  const entryLabel = `${entries} ${entries === 1 ? "entry" : "entries"}`;
+  if (!metafile) return entryLabel;
+
+  const outputs = Object.keys(metafile.outputs).filter(
+    (file) => file.endsWith(".js") || file.endsWith(".mjs"),
+  );
+  const chunks = outputs.length;
+  return `${entryLabel}, ${chunks} ${chunks === 1 ? "file" : "files"}`;
+}
+
 /**
  * Metafile diske yazılır: dev panelindeki chunk analizi giriş/çıkış
  * kırılımını buradan okur. Çalışma zamanı bu dosyaya bağımlı değildir.

package/src/config/defaults.js

@@ -470,6 +470,31 @@ export const DEFAULT_SECURITY = {
   },
 };
 
+/**
+ * Client bundle (esbuild) ayarları.
+ *
+ * `groups` / `chunkGroup` esbuild'in native manualChunks'ı olmadığı için
+ * framework plugin'i ile uygulanır — ayrıntı `src/build/chunk-groups.mjs`.
+ */
+export const DEFAULT_BUILD = {
+  client: {
+    /** esbuild `splitting`; kapalıyken gruplama yok sayılır. */
+    splitting: true,
+    /**
+     * İsim → matcher listesi. Bare paket (`chart.js`), yol öneki
+     * (`./client/chrome/`) veya `@/` öneki.
+     * @type {Record<string, string[]>}
+     */
+    groups: {},
+    /**
+     * Modül kimliğini (mutlak yol veya bare specifier) grup adına map eder.
+     * `groups` ile çakışınca hook kazanır.
+     * @type {((id: string) => string | null | undefined) | null}
+     */
+    chunkGroup: null,
+  },
+};
+
 /**
  * Build-zamanı görsel adımı + opsiyonel runtime uzak görsel proxy.
  *

package/src/config/index.js

@@ -47,6 +47,7 @@ import {
   ON_VISIT_CONCURRENCY_CEILING,
   ON_VISIT_PER_PAGE_CEILING,
   ON_VISIT_RPS_CEILING,
+  DEFAULT_BUILD,
   DEFAULT_IMAGES,
   DEFAULT_LOGS,
   DEFAULT_NAVIGATION,
@@ -160,6 +161,17 @@ const CONFIG_FILE = "jskelet.config.mjs";
  * @property {{ scan?: string[], dir: string } | false} icons
  * @property {ImagesConfig | false} images
  * @property {string[]} clientEnv Client bundle'a gömülecek env anahtarları.
+ * @property {BuildConfig} build Client bundling (esbuild splitting / chunk groups).
+ */
+
+/**
+ * @typedef {object} BuildClientConfig
+ * @property {boolean} splitting
+ * @property {Record<string, string[]>} groups
+ * @property {((id: string) => string | null | undefined) | null} chunkGroup
+ *
+ * @typedef {object} BuildConfig
+ * @property {BuildClientConfig} client
  */
 
 /**
@@ -1139,6 +1151,118 @@ function normalizeSecurity(raw) {
   };
 }
 
+/**
+ * Client build ayarları (`build.client`). Bozuk tipler uyarıyla varsayılana düşer.
+ *
+ * @param {unknown} raw
+ * @returns {BuildConfig}
+ */
+export function normalizeBuild(raw) {
+  if (raw == null) {
+    return {
+      client: {
+        splitting: DEFAULT_BUILD.client.splitting,
+        groups: {},
+        chunkGroup: null,
+      },
+    };
+  }
+
+  if (typeof raw !== "object" || Array.isArray(raw)) {
+    console.warn("[config] build must be an object, ignoring it");
+    return {
+      client: {
+        splitting: DEFAULT_BUILD.client.splitting,
+        groups: {},
+        chunkGroup: null,
+      },
+    };
+  }
+
+  const source = /** @type {Record<string, any>} */ (raw);
+  const clientRaw = source.client;
+
+  if (clientRaw == null) {
+    return {
+      client: {
+        splitting: DEFAULT_BUILD.client.splitting,
+        groups: {},
+        chunkGroup: null,
+      },
+    };
+  }
+
+  if (typeof clientRaw !== "object" || Array.isArray(clientRaw)) {
+    console.warn("[config] build.client must be an object, ignoring it");
+    return {
+      client: {
+        splitting: DEFAULT_BUILD.client.splitting,
+        groups: {},
+        chunkGroup: null,
+      },
+    };
+  }
+
+  const client = /** @type {Record<string, any>} */ (clientRaw);
+  const splitting = client.splitting !== false;
+
+  /** @type {Record<string, string[]>} */
+  const groups = {};
+  if (client.groups != null) {
+    if (typeof client.groups !== "object" || Array.isArray(client.groups)) {
+      console.warn("[config] build.client.groups must be an object, ignoring it");
+    } else {
+      for (const [name, matchers] of Object.entries(client.groups)) {
+        if (!isSafeGroupName(name)) {
+          console.warn(
+            `[config] build.client.groups key "${name}" is invalid ` +
+              "(use letters, digits, _ or -); skipping",
+          );
+          continue;
+        }
+        const list = asArray(matchers, `build.client.groups.${name}`)
+          .filter((entry) => typeof entry === "string" && entry.trim())
+          .map((entry) => String(entry).trim());
+        if (list.length) groups[name] = list;
+      }
+    }
+  }
+
+  /** @type {((id: string) => string | null | undefined) | null} */
+  let chunkGroup = null;
+  if (client.chunkGroup != null) {
+    if (typeof client.chunkGroup === "function") {
+      chunkGroup = client.chunkGroup;
+    } else {
+      console.warn(
+        "[config] build.client.chunkGroup must be a function, ignoring it",
+      );
+    }
+  }
+
+  if (
+    !splitting &&
+    (Object.keys(groups).length > 0 || chunkGroup)
+  ) {
+    console.warn(
+      "[config] build.client.groups / chunkGroup require splitting; " +
+        "they are ignored while splitting is false",
+    );
+  }
+
+  return { client: { splitting, groups, chunkGroup } };
+}
+
+/**
+ * Chunk dosya adına güvenli grup adı.
+ *
+ * @param {string} name
+ * @returns {boolean}
+ */
+function isSafeGroupName(name) {
+  return typeof name === "string" && /^[A-Za-z0-9_-]+$/.test(name);
+}
+
 /**
  * İkon sprite ayarları. `false` → adım atlanır. `dir` varsayılanı `"icons"`:
  * o dizin varsa yalnızca yerel SVG'ler; yoksa Phosphor.
@@ -1423,6 +1547,7 @@ export async function loadConfig(options = {}) {
     icons: normalizeIcons(source.icons),
     images: normalizeImages(source.images),
     clientEnv: source.clientEnv ?? [],
+    build: normalizeBuild(source.build),
   };
 
   if (