jskelet 0.6.3 → 0.6.4

package/src/config/pattern.js

@@ -1,107 +1,107 @@
-/**
- * `next.config` `source`/`destination` sözdiziminin küçük bir derleyicisi.
- *
- * Desteklenen biçimler:
- *   `/haber/:slug`      → tek segment yakalar
- *   `/:path*`           → sıfır veya daha fazla segment yakalar
- *   `/:path*.svg`       → joker + sabit son ek (uzantı kuralları böyle yazılır)
- *   `/etiket-:slug`     → segment ortasında parametre
- *
- * Yakalanan değerler `destination` içindeki aynı adlı `:param`'lara yazılır.
- * Next'in tam `path-to-regexp` yüzeyi değil; config'te fiilen kullanılan alt
- * küme bilinçli olarak seçildi ve tanınmayan bir sözdizimi sessizce literal
- * kabul edilmez, uyarı üretir.
- */
-
-/** @typedef {{ regex: RegExp, keys: string[], source: string }} CompiledPattern */
-
-const PARAM = /^:([A-Za-z_][A-Za-z0-9_]*)(\*)?/;
-
-/** @param {string} text */
-function escapeLiteral(text) {
-  return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-
-/**
- * @param {string} source
- * @returns {CompiledPattern | null}
- */
-export function compilePattern(source) {
-  if (typeof source !== "string" || !source.startsWith("/")) {
-    console.warn(`[config] invalid source (must start with \`/\`): ${source}`);
-    return null;
-  }
-
-  /** @type {string[]} */
-  const keys = [];
-  let pattern = "";
-  let index = 0;
-
-  while (index < source.length) {
-    const char = source[index];
-
-    if (char !== ":") {
-      pattern += escapeLiteral(char);
-      index += 1;
-      continue;
-    }
-
-    const match = source.slice(index).match(PARAM);
-    if (!match) {
-      pattern += escapeLiteral(char);
-      index += 1;
-      continue;
-    }
-
-    const [raw, name, wildcard] = match;
-    keys.push(name);
-
-    if (!wildcard) {
-      // Tek segmentli parametre segment sınırını aşmaz.
-      pattern += "([^/]+)";
-      index += raw.length;
-      continue;
-    }
-
-    // Joker parametre segment sınırlarını aşar ve **sıfır** segment de
-    // yakalar: `/hesabim/:path*` kuralı `/hesabim`i de kapsamalı, aksi hâlde
-    // bir bölümün tamamını kapatmak isteyen kural kök yolu atlıyor. Bunun için
-    // hemen öncesindeki `/` de opsiyonele alınır.
-    const trailingSlash = pattern.endsWith("/");
-    pattern = trailingSlash ? `${pattern.slice(0, -1)}(?:/(.*))?` : `${pattern}(.*)`;
-    index += raw.length;
-  }
-
-  return { regex: new RegExp(`^${pattern}$`), keys, source };
-}
-
-/**
- * @param {CompiledPattern} compiled
- * @param {string} pathname
- * @returns {Record<string, string> | null}
- */
-export function matchPattern(compiled, pathname) {
-  const match = compiled.regex.exec(pathname);
-  if (!match) return null;
-
-  /** @type {Record<string, string>} */
-  const params = {};
-  compiled.keys.forEach((key, i) => {
-    params[key] = match[i + 1] ?? "";
-  });
-  return params;
-}
-
-/**
- * `destination` içindeki `:param` yer tutucularını doldurur.
- *
- * @param {string} destination
- * @param {Record<string, string>} params
- * @returns {string}
- */
-export function fillDestination(destination, params) {
-  return destination.replace(
-    /:([A-Za-z_][A-Za-z0-9_]*)(\*)?/g,
-    (raw, name) => params[name] ?? raw,
-  );
-}
+/**
+ * `next.config` `source`/`destination` sözdiziminin küçük bir derleyicisi.
+ *
+ * Desteklenen biçimler:
+ *   `/haber/:slug`      → tek segment yakalar
+ *   `/:path*`           → sıfır veya daha fazla segment yakalar
+ *   `/:path*.svg`       → joker + sabit son ek (uzantı kuralları böyle yazılır)
+ *   `/etiket-:slug`     → segment ortasında parametre
+ *
+ * Yakalanan değerler `destination` içindeki aynı adlı `:param`'lara yazılır.
+ * Next'in tam `path-to-regexp` yüzeyi değil; config'te fiilen kullanılan alt
+ * küme bilinçli olarak seçildi ve tanınmayan bir sözdizimi sessizce literal
+ * kabul edilmez, uyarı üretir.
+ */
+
+/** @typedef {{ regex: RegExp, keys: string[], source: string }} CompiledPattern */
+
+const PARAM = /^:([A-Za-z_][A-Za-z0-9_]*)(\*)?/;
+
+/** @param {string} text */
+function escapeLiteral(text) {
+  return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+/**
+ * @param {string} source
+ * @returns {CompiledPattern | null}
+ */
+export function compilePattern(source) {
+  if (typeof source !== "string" || !source.startsWith("/")) {
+    console.warn(`[config] invalid source (must start with \`/\`): ${source}`);
+    return null;
+  }
+
+  /** @type {string[]} */
+  const keys = [];
+  let pattern = "";
+  let index = 0;
+
+  while (index < source.length) {
+    const char = source[index];
+
+    if (char !== ":") {
+      pattern += escapeLiteral(char);
+      index += 1;
+      continue;
+    }
+
+    const match = source.slice(index).match(PARAM);
+    if (!match) {
+      pattern += escapeLiteral(char);
+      index += 1;
+      continue;
+    }
+
+    const [raw, name, wildcard] = match;
+    keys.push(name);
+
+    if (!wildcard) {
+      // Tek segmentli parametre segment sınırını aşmaz.
+      pattern += "([^/]+)";
+      index += raw.length;
+      continue;
+    }
+
+    // Joker parametre segment sınırlarını aşar ve **sıfır** segment de
+    // yakalar: `/hesabim/:path*` kuralı `/hesabim`i de kapsamalı, aksi hâlde
+    // bir bölümün tamamını kapatmak isteyen kural kök yolu atlıyor. Bunun için
+    // hemen öncesindeki `/` de opsiyonele alınır.
+    const trailingSlash = pattern.endsWith("/");
+    pattern = trailingSlash ? `${pattern.slice(0, -1)}(?:/(.*))?` : `${pattern}(.*)`;
+    index += raw.length;
+  }
+
+  return { regex: new RegExp(`^${pattern}$`), keys, source };
+}
+
+/**
+ * @param {CompiledPattern} compiled
+ * @param {string} pathname
+ * @returns {Record<string, string> | null}
+ */
+export function matchPattern(compiled, pathname) {
+  const match = compiled.regex.exec(pathname);
+  if (!match) return null;
+
+  /** @type {Record<string, string>} */
+  const params = {};
+  compiled.keys.forEach((key, i) => {
+    params[key] = match[i + 1] ?? "";
+  });
+  return params;
+}
+
+/**
+ * `destination` içindeki `:param` yer tutucularını doldurur.
+ *
+ * @param {string} destination
+ * @param {Record<string, string>} params
+ * @returns {string}
+ */
+export function fillDestination(destination, params) {
+  return destination.replace(
+    /:([A-Za-z_][A-Za-z0-9_]*)(\*)?/g,
+    (raw, name) => params[name] ?? raw,
+  );
+}

package/src/generate.mjs

@@ -1,163 +1,163 @@
-/**
- * `jskelet generate` — feature / page / island iskeleti.
- *
- * Var olan dosyaların üzerine yazmaz. Route kaydı hâlâ açık `register`
- * sözleşmesine bağlıdır; filesystem URL türetme yoktur.
- */
-import fs from "node:fs";
-import path from "node:path";
-import process from "node:process";
-import * as log from "./log.mjs";
-
-/**
- * @param {string} name
- * @returns {string}
- */
-function toPascal(name) {
-  return name
-    .split(/[-_/]+/)
-    .filter(Boolean)
-    .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
-    .join("");
-}
-
-/**
- * @param {string} file
- * @param {string} contents
- * @returns {boolean} yazıldı mı
- */
-function writeIfMissing(file, contents) {
-  if (fs.existsSync(file)) {
-    log.line(`skip ${path.relative(process.cwd(), file)} (exists)`);
-    return false;
-  }
-  fs.mkdirSync(path.dirname(file), { recursive: true });
-  fs.writeFileSync(file, contents, "utf8");
-  log.line(`create ${path.relative(process.cwd(), file)}`);
-  return true;
-}
-
-/**
- * @param {string} root
- * @param {string[]} args
- * @returns {Promise<void>}
- */
-export async function generate(root, args) {
-  const [kind, target] = args;
-  if (!kind || !target) {
-    throw new Error(
-      "usage: jskelet generate <feature|page|island> <name>\n" +
-        "  feature  features/<name>/{index.js,server,views,client}\n" +
-        "  page     features/<feature>/views/pages/<name>.jsk  (name: feature/page)\n" +
-        "  island   features/<feature>/client/<name>.js       (name: feature/island)",
-    );
-  }
-
-  if (kind === "feature") {
-    await generateFeature(root, target);
-    return;
-  }
-  if (kind === "page") {
-    const [feature, page] = splitTarget(target);
-    await generatePage(root, feature, page);
-    return;
-  }
-  if (kind === "island") {
-    const [feature, island] = splitTarget(target);
-    await generateIsland(root, feature, island);
-    return;
-  }
-
-  throw new Error(`unknown generate kind: ${kind}`);
-}
-
-/**
- * @param {string} target
- * @returns {[string, string]}
- */
-function splitTarget(target) {
-  const parts = target.split("/").filter(Boolean);
-  if (parts.length < 2) {
-    throw new Error(`expected <feature>/<name>, got "${target}"`);
-  }
-  return [parts[0], parts.slice(1).join("/")];
-}
-
-/**
- * @param {string} root
- * @param {string} name
- */
-async function generateFeature(root, name) {
-  const base = path.join(root, "features", name);
-  writeIfMissing(
-    path.join(base, "index.js"),
-    `/**
- * Feature route registration. Explicit paths only — no filesystem URL routing.
- * @param {import('express').Express} app
- * @param {{ route: Function }} api
- */
-export default function register(app, { route }) {
-  app.get(
-    "/${name}",
-    route(async () => ({
-      view: "pages/${name}",
-      metadata: { title: "${toPascal(name)}" },
-      data: {},
-    })),
-  );
-}
-`,
-  );
-  writeIfMissing(path.join(base, "server", ".gitkeep"), "");
-  writeIfMissing(
-    path.join(base, "views", "pages", `${name}.jsk`),
-    `<section class="wrapper">
-  <h1>{{ metadata.title }}</h1>
-</section>
-`,
-  );
-  writeIfMissing(path.join(base, "client", ".gitkeep"), "");
-  log.ready({ label: `Feature ${name}` });
-}
-
-/**
- * @param {string} root
- * @param {string} feature
- * @param {string} page
- */
-async function generatePage(root, feature, page) {
-  const file = path.join(root, "features", feature, "views", "pages", `${page}.jsk`);
-  writeIfMissing(
-    file,
-    `<section class="wrapper">
-  <h1>{{ metadata.title }}</h1>
-</section>
-`,
-  );
-  log.ready({ label: `Page ${feature}/${page}` });
-}
-
-/**
- * @param {string} root
- * @param {string} feature
- * @param {string} island
- */
-async function generateIsland(root, feature, island) {
-  const file = path.join(root, "features", feature, "client", `${island}.js`);
-  writeIfMissing(
-    file,
-    `/**
- * @param {HTMLElement} element
- * @param {Record<string, unknown>} props
- * @returns {void | (() => void)}
- */
-export function mount(element, props) {
-  element.textContent = String(props.label ?? "${island}");
-}
-`,
-  );
-  log.line(
-    `Register in client/entries/main.js: "${island}": () => import("../../features/${feature}/client/${island}.js")`,
-  );
-  log.ready({ label: `Island ${feature}/${island}` });
-}
+/**
+ * `jskelet generate` — feature / page / island iskeleti.
+ *
+ * Var olan dosyaların üzerine yazmaz. Route kaydı hâlâ açık `register`
+ * sözleşmesine bağlıdır; filesystem URL türetme yoktur.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import process from "node:process";
+import * as log from "./log.mjs";
+
+/**
+ * @param {string} name
+ * @returns {string}
+ */
+function toPascal(name) {
+  return name
+    .split(/[-_/]+/)
+    .filter(Boolean)
+    .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
+    .join("");
+}
+
+/**
+ * @param {string} file
+ * @param {string} contents
+ * @returns {boolean} yazıldı mı
+ */
+function writeIfMissing(file, contents) {
+  if (fs.existsSync(file)) {
+    log.line(`skip ${path.relative(process.cwd(), file)} (exists)`);
+    return false;
+  }
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  fs.writeFileSync(file, contents, "utf8");
+  log.line(`create ${path.relative(process.cwd(), file)}`);
+  return true;
+}
+
+/**
+ * @param {string} root
+ * @param {string[]} args
+ * @returns {Promise<void>}
+ */
+export async function generate(root, args) {
+  const [kind, target] = args;
+  if (!kind || !target) {
+    throw new Error(
+      "usage: jskelet generate <feature|page|island> <name>\n" +
+        "  feature  features/<name>/{index.js,server,views,client}\n" +
+        "  page     features/<feature>/views/pages/<name>.jsk  (name: feature/page)\n" +
+        "  island   features/<feature>/client/<name>.js       (name: feature/island)",
+    );
+  }
+
+  if (kind === "feature") {
+    await generateFeature(root, target);
+    return;
+  }
+  if (kind === "page") {
+    const [feature, page] = splitTarget(target);
+    await generatePage(root, feature, page);
+    return;
+  }
+  if (kind === "island") {
+    const [feature, island] = splitTarget(target);
+    await generateIsland(root, feature, island);
+    return;
+  }
+
+  throw new Error(`unknown generate kind: ${kind}`);
+}
+
+/**
+ * @param {string} target
+ * @returns {[string, string]}
+ */
+function splitTarget(target) {
+  const parts = target.split("/").filter(Boolean);
+  if (parts.length < 2) {
+    throw new Error(`expected <feature>/<name>, got "${target}"`);
+  }
+  return [parts[0], parts.slice(1).join("/")];
+}
+
+/**
+ * @param {string} root
+ * @param {string} name
+ */
+async function generateFeature(root, name) {
+  const base = path.join(root, "features", name);
+  writeIfMissing(
+    path.join(base, "index.js"),
+    `/**
+ * Feature route registration. Explicit paths only — no filesystem URL routing.
+ * @param {import('express').Express} app
+ * @param {{ route: Function }} api
+ */
+export default function register(app, { route }) {
+  app.get(
+    "/${name}",
+    route(async () => ({
+      view: "pages/${name}",
+      metadata: { title: "${toPascal(name)}" },
+      data: {},
+    })),
+  );
+}
+`,
+  );
+  writeIfMissing(path.join(base, "server", ".gitkeep"), "");
+  writeIfMissing(
+    path.join(base, "views", "pages", `${name}.jsk`),
+    `<section class="wrapper">
+  <h1>{{ metadata.title }}</h1>
+</section>
+`,
+  );
+  writeIfMissing(path.join(base, "client", ".gitkeep"), "");
+  log.ready({ label: `Feature ${name}` });
+}
+
+/**
+ * @param {string} root
+ * @param {string} feature
+ * @param {string} page
+ */
+async function generatePage(root, feature, page) {
+  const file = path.join(root, "features", feature, "views", "pages", `${page}.jsk`);
+  writeIfMissing(
+    file,
+    `<section class="wrapper">
+  <h1>{{ metadata.title }}</h1>
+</section>
+`,
+  );
+  log.ready({ label: `Page ${feature}/${page}` });
+}
+
+/**
+ * @param {string} root
+ * @param {string} feature
+ * @param {string} island
+ */
+async function generateIsland(root, feature, island) {
+  const file = path.join(root, "features", feature, "client", `${island}.js`);
+  writeIfMissing(
+    file,
+    `/**
+ * @param {HTMLElement} element
+ * @param {Record<string, unknown>} props
+ * @returns {void | (() => void)}
+ */
+export function mount(element, props) {
+  element.textContent = String(props.label ?? "${island}");
+}
+`,
+  );
+  log.line(
+    `Register in client/entries/main.js: "${island}": () => import("../../features/${feature}/client/${island}.js")`,
+  );
+  log.ready({ label: `Island ${feature}/${island}` });
+}

package/src/http/control-flow.js

@@ -1,71 +1,71 @@
-/**
- * `next/navigation` içindeki notFound/redirect kontrol akışının karşılığı.
- * Derinlerdeki bir fonksiyon throw eder, Express error handler yakalar.
- */
-
-export class NotFoundError extends Error {
-  constructor(message = "Not Found") {
-    super(message);
-    this.name = "NotFoundError";
-    this.statusCode = 404;
-  }
-}
-
-export class RedirectError extends Error {
-  /**
-   * @param {string} location
-   * @param {301 | 302 | 303 | 307 | 308} [statusCode]
-   */
-  constructor(location, statusCode = 307) {
-    super(`Redirect to ${location}`);
-    this.name = "RedirectError";
-    this.location = location;
-    this.statusCode = statusCode;
-  }
-}
-
-/** @returns {never} */
-export function notFound() {
-  throw new NotFoundError();
-}
-
-/**
- * @param {string} location
- * @returns {never}
- */
-export function permanentRedirect(location) {
-  throw new RedirectError(location, 308);
-}
-
-/**
- * @param {string} location
- * @returns {never}
- */
-export function redirect(location) {
-  throw new RedirectError(location, 307);
-}
-
-/**
- * POST sonrası yönlendirme (303 See Other).
- *
- * `redirect()` 307 kullanır ve 307 **metodu korur**: bir POST handler'ından
- * çağrıldığında tarayıcı hedefe yeniden POST eder. Form gönderiminden sonra
- * sayfayı GET olarak açmak — yani geri tuşunun formu yeniden göndermediği
- * klasik "post/redirect/get" akışı — 303 gerektiriyor.
- *
- * @param {string} location
- * @returns {never}
- */
-export function seeOther(location) {
-  throw new RedirectError(location, 303);
-}
-
-/** @param {unknown} error */
-export function isNotFoundError(error) {
-  return error instanceof NotFoundError;
-}
-
-/** @param {unknown} error */
-export function isRedirectError(error) {
-  return error instanceof RedirectError;
-}
+/**
+ * `next/navigation` içindeki notFound/redirect kontrol akışının karşılığı.
+ * Derinlerdeki bir fonksiyon throw eder, Express error handler yakalar.
+ */
+
+export class NotFoundError extends Error {
+  constructor(message = "Not Found") {
+    super(message);
+    this.name = "NotFoundError";
+    this.statusCode = 404;
+  }
+}
+
+export class RedirectError extends Error {
+  /**
+   * @param {string} location
+   * @param {301 | 302 | 303 | 307 | 308} [statusCode]
+   */
+  constructor(location, statusCode = 307) {
+    super(`Redirect to ${location}`);
+    this.name = "RedirectError";
+    this.location = location;
+    this.statusCode = statusCode;
+  }
+}
+
+/** @returns {never} */
+export function notFound() {
+  throw new NotFoundError();
+}
+
+/**
+ * @param {string} location
+ * @returns {never}
+ */
+export function permanentRedirect(location) {
+  throw new RedirectError(location, 308);
+}
+
+/**
+ * @param {string} location
+ * @returns {never}
+ */
+export function redirect(location) {
+  throw new RedirectError(location, 307);
+}
+
+/**
+ * POST sonrası yönlendirme (303 See Other).
+ *
+ * `redirect()` 307 kullanır ve 307 **metodu korur**: bir POST handler'ından
+ * çağrıldığında tarayıcı hedefe yeniden POST eder. Form gönderiminden sonra
+ * sayfayı GET olarak açmak — yani geri tuşunun formu yeniden göndermediği
+ * klasik "post/redirect/get" akışı — 303 gerektiriyor.
+ *
+ * @param {string} location
+ * @returns {never}
+ */
+export function seeOther(location) {
+  throw new RedirectError(location, 303);
+}
+
+/** @param {unknown} error */
+export function isNotFoundError(error) {
+  return error instanceof NotFoundError;
+}
+
+/** @param {unknown} error */
+export function isRedirectError(error) {
+  return error instanceof RedirectError;
+}