jskelet 0.2.3 → 0.2.5

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/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;
+}