npm - jskelet - Versions diffs - 0.2.5 → 0.3.0 - Mend

jskelet 0.2.5 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (106) hide show

package/AGENTS.md +132 -132
package/CHANGELOG.md +403 -383
package/LICENSE +21 -21
package/bin/jskelet.mjs +103 -103
package/docs/01-baslangic.md +285 -285
package/docs/02-mimari.md +293 -287
package/docs/03-routing.md +486 -480
package/docs/04-render-ve-sablonlar.md +490 -490
package/docs/05-islands.md +482 -482
package/docs/06-cache.md +1231 -1209
package/docs/07-yapilandirma.md +44 -21
package/docs/08-build.md +366 -366
package/docs/09-dev-araclari.md +335 -335
package/docs/10-dagitim.md +329 -329
package/docs/11-tasima.md +1 -0
package/docs/12-panel-ve-oturum.md +384 -384
package/docs/README.md +105 -105
package/docs/en/01-getting-started.md +292 -292
package/docs/en/02-architecture.md +311 -305
package/docs/en/03-routing.md +503 -497
package/docs/en/04-rendering.md +504 -504
package/docs/en/05-islands.md +492 -492
package/docs/en/06-caching.md +1197 -1198
package/docs/en/07-configuration.md +1009 -986
package/docs/en/08-build.md +383 -383
package/docs/en/09-dev-tools.md +342 -342
package/docs/en/10-deployment.md +332 -332
package/docs/en/11-migration.md +360 -359
package/docs/en/12-dashboards-and-sessions.md +392 -392
package/docs/en/README.md +112 -112
package/package.json +102 -102
package/src/build/ensure-build.mjs +15 -15
package/src/build/paths.mjs +143 -143
package/src/build/resolve-peer.mjs +36 -36
package/src/build/tasks/client.mjs +268 -268
package/src/build/tasks/css.mjs +124 -124
package/src/build/tasks/fonts.mjs +146 -146
package/src/build/tasks/icons.mjs +224 -224
package/src/build/tasks/images.mjs +244 -244
package/src/build/tasks/precompress.mjs +78 -78
package/src/client/{cache-panel → admin}/i18n.js +756 -670
package/src/client/{cache-panel → admin}/login.html +74 -74
package/src/client/{cache-panel → admin}/panel.css +804 -756
package/src/client/admin/panel.html +486 -0
package/src/client/{cache-panel → admin}/panel.js +1242 -915
package/src/client/devtools/report.html +185 -185
package/src/client/devtools/report.js +725 -725
package/src/client/dom.js +95 -95
package/src/client/form.js +192 -192
package/src/client/index.js +35 -35
package/src/client/registry.js +297 -297
package/src/client/safe-image.js +91 -91
package/src/client/store.js +36 -36
package/src/client/swap.js +188 -188
package/src/config/defaults.js +16 -7
package/src/config/index.js +38 -22
package/src/config/pattern.js +107 -107
package/src/http/control-flow.js +71 -71
package/src/http/cookies.js +257 -257
package/src/http/request-cache.js +46 -46
package/src/http/request-context.js +162 -162
package/src/index.js +83 -83
package/src/init.mjs +221 -221
package/src/log.mjs +58 -0
package/src/runtime/alias-hooks.mjs +119 -119
package/src/runtime/register.mjs +4 -4
package/src/server/admin/actions.js +229 -0
package/src/server/admin/auth.js +125 -0
package/src/server/admin/event-log.js +151 -0
package/src/server/admin/gate.js +209 -0
package/src/server/admin/inventory.js +188 -0
package/src/server/admin/mount.js +56 -0
package/src/server/admin/router.js +216 -0
package/src/server/admin/snapshot.js +126 -0
package/src/server/assets.js +147 -147
package/src/server/cache-deps.js +42 -42
package/src/server/cloudflare.js +607 -607
package/src/server/create-app.js +295 -291
package/src/server/data-cache.js +462 -462
package/src/server/dev/report.js +369 -369
package/src/server/dev/socket.js +170 -170
package/src/server/dev/version-check.mjs +139 -139
package/src/server/html-cache.js +817 -817
package/src/server/metadata.js +102 -102
package/src/server/middleware/compression.js +205 -205
package/src/server/middleware/csrf.js +134 -134
package/src/server/middleware/dev-gate.js +62 -62
package/src/server/middleware/headers.js +37 -37
package/src/server/middleware/redirects.js +32 -32
package/src/server/middleware/static-precompressed.js +100 -100
package/src/server/middleware/trailing-slash.js +53 -0
package/src/server/middleware/upstream-proxy.js +141 -141
package/src/server/prewarm.js +601 -601
package/src/server/redis.js +569 -569
package/src/server/router.js +128 -128
package/src/server/status-page.js +164 -164
package/src/server/upstream-limiter.js +376 -376
package/src/server/upstream-tracking.js +166 -166
package/src/start.mjs +7 -7
package/src/templates/layout.ejs +44 -44
package/src/version.mjs +31 -31
package/src/views/components/loader.js +85 -85
package/src/views/helpers/html.js +102 -102
package/src/views/helpers/tags.js +245 -245
package/src/client/cache-panel/panel.html +0 -308
package/src/server/cache-panel.js +0 -759

package/src/init.mjs CHANGED Viewed

@@ -1,221 +1,221 @@
-/**
- * `jskelet init` — bulunduğun dizine çalışan bir minimum iskelet kurar.
- *
- * Var olan dosyaların üzerine yazmaz: komutu ikinci kez çalıştırmak yalnızca
- * eksikleri tamamlar. Amaç, "kurulum yaptım ama hiçbir şey çalışmıyor"
- * aşamasını tamamen atlamak — `jskelet dev` hemen ardından çalışır.
- */
-import fs from "node:fs";
-import path from "node:path";
-import * as log from "./log.mjs";
-/** @type {Record<string, string>} */
-const FILES = {
-  "jskelet.config.mjs": `/**
- * JSkelet configuration. Every field is optional; the app still runs on
- * defaults if you delete this file.
- *
- * Details: node_modules/jskelet/docs/en/07-configuration.md
- */
-export default {
-  brand: { lang: "en" },
-  /** Third-party origins; emitted as preconnect in \`<head>\`. */
-  preconnect: [],
-  async cache() {
-    return {
-      /** How long a page's HTML stays in the cache (seconds). */
-      html: { "/": 60 },
-    };
-  },
-  hooks: {
-    /** Metadata defaults for every page. */
-    metadata() {
-      return {
-        titleTemplate: "%s | JSkelet",
-        description: "A site built with JSkelet.",
-      };
-    },
-    /** Locals added to the layout on every render. */
-    layoutContext() {
-      return { bodyClass: "min-h-full" };
-    },
-    /** 404 page. */
-    notFound() {
-      return {
-        view: "pages/not-found",
-        metadata: { title: "Page not found", robots: { index: false } },
-      };
-    },
-  },
-};
-`,
-  "routes/10-pages.mjs": `/**
- * Route module. The default export receives \`(app, api)\`; \`api.route()\` wraps
- * the controller with the HTML cache, the notFound/redirect flow and
- * compression.
- *
- * The numeric prefix in the file name sets load order: catch-all routes
- * (like "/:slug") belong to a higher number.
- */
-export default function register(app, { route }) {
-  app.get(
-    "/",
-    route(
-      async () => ({
-        view: "pages/home",
-        metadata: { title: "Home" },
-        data: { message: "JSkelet is running." },
-      }),
-      { revalidate: 60 },
-    ),
-  );
-}
-`,
-  "views/pages/home.ejs": `<section class="wrapper">
-  <h1><%= metadata.title %></h1>
-  <p><%= message %></p>
-  <div data-island="counter" data-island-props='{"start":0}'></div>
-</section>
-`,
-  "views/pages/not-found.ejs": `<section class="wrapper">
-  <h1>404</h1>
-  <p>The page you are looking for was not found.</p>
-  <p><a href="/">Back to home</a></p>
-</section>
-`,
-  "views/components/button.js": `import { attrs, esc } from "jskelet/html";
-/**
- * Every named export under \`views/components/**\` is usable directly in
- * templates: \`<%- button({ text: "Save" }) %>\`. No import needed.
- *
- * @param {{ text: string, href?: string, class?: string }} props
- * @returns {string}
- */
-export function button({ text, href, class: className }) {
-  const tag = href ? "a" : "button";
-  return \`<\${tag}\${attrs({ href, class: className })}>\${esc(text)}</\${tag}>\`;
-}
-`,
-  "client/entries/main.js": `import { registerAll, start } from "jskelet/client";
-/**
- * Island registry. Values are dynamic imports: a module is downloaded only if
- * that island is actually on the page and becomes visible.
- */
-registerAll({
-  counter: () => import("../islands/counter.js"),
-});
-start();
-`,
-  "client/islands/counter.js": `/**
- * Island contract: a named export called \`mount(element, props)\`.
- * The returned function, if any, is reserved for cleanup.
- *
- * @param {HTMLElement} element
- * @param {{ start?: number }} props
- */
-export function mount(element, props) {
-  let value = props.start ?? 0;
-  const button = document.createElement("button");
-  button.type = "button";
-  const paint = () => {
-    button.textContent = \`Clicks: \${value}\`;
-  };
-  button.addEventListener("click", () => {
-    value += 1;
-    paint();
-  });
-  paint();
-  element.append(button);
-}
-`,
-  "styles/globals.css": `@import "tailwindcss" source(none);
-/**
- * Tailwind's class scanning depends on these directives. Automatic detection
- * only scans the directory holding this file; variants used in templates
- * (like data-[active=false]:…) would otherwise be dropped silently.
- */
-@source "../views";
-@source "../client";
-@source "../routes";
-body {
-  margin: 0;
-  font-family: system-ui, sans-serif;
-}
-.wrapper {
-  max-width: 64rem;
-  margin-inline: auto;
-  padding: 2rem 1rem;
-}
-`,
-  "jsconfig.json": `{
-  "compilerOptions": {
-    "checkJs": true,
-    "module": "esnext",
-    "moduleResolution": "bundler",
-    "target": "es2022",
-    "baseUrl": ".",
-    "paths": { "@/*": ["./*"] }
-  },
-  "exclude": ["node_modules", "public/assets"]
-}
-`,
-  ".gitignore": `node_modules/
-.jskelet/
-public/assets/
-.env
-`,
-};
-/**
- * @param {string} root
- * @returns {Promise<void>}
- */
-export async function init(root) {
-  log.section("init");
-  const created = [];
-  const skipped = [];
-  for (const [relative, contents] of Object.entries(FILES)) {
-    const target = path.join(root, relative);
-    if (fs.existsSync(target)) {
-      skipped.push(relative);
-      continue;
-    }
-    fs.mkdirSync(path.dirname(target), { recursive: true });
-    fs.writeFileSync(target, contents);
-    created.push(relative);
-  }
-  for (const file of created) log.line(`+ ${file}`);
-  if (skipped.length) log.warn(`${skipped.length} files already existed, skipped`);
-  log.line("");
-  log.line("next step:  npx jskelet dev");
-}
+/**
+ * `jskelet init` — bulunduğun dizine çalışan bir minimum iskelet kurar.
+ *
+ * Var olan dosyaların üzerine yazmaz: komutu ikinci kez çalıştırmak yalnızca
+ * eksikleri tamamlar. Amaç, "kurulum yaptım ama hiçbir şey çalışmıyor"
+ * aşamasını tamamen atlamak — `jskelet dev` hemen ardından çalışır.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import * as log from "./log.mjs";
+/** @type {Record<string, string>} */
+const FILES = {
+  "jskelet.config.mjs": `/**
+ * JSkelet configuration. Every field is optional; the app still runs on
+ * defaults if you delete this file.
+ *
+ * Details: node_modules/jskelet/docs/en/07-configuration.md
+ */
+export default {
+  brand: { lang: "en" },
+  /** Third-party origins; emitted as preconnect in \`<head>\`. */
+  preconnect: [],
+  async cache() {
+    return {
+      /** How long a page's HTML stays in the cache (seconds). */
+      html: { "/": 60 },
+    };
+  },
+  hooks: {
+    /** Metadata defaults for every page. */
+    metadata() {
+      return {
+        titleTemplate: "%s | JSkelet",
+        description: "A site built with JSkelet.",
+      };
+    },
+    /** Locals added to the layout on every render. */
+    layoutContext() {
+      return { bodyClass: "min-h-full" };
+    },
+    /** 404 page. */
+    notFound() {
+      return {
+        view: "pages/not-found",
+        metadata: { title: "Page not found", robots: { index: false } },
+      };
+    },
+  },
+};
+`,
+  "routes/10-pages.mjs": `/**
+ * Route module. The default export receives \`(app, api)\`; \`api.route()\` wraps
+ * the controller with the HTML cache, the notFound/redirect flow and
+ * compression.
+ *
+ * The numeric prefix in the file name sets load order: catch-all routes
+ * (like "/:slug") belong to a higher number.
+ */
+export default function register(app, { route }) {
+  app.get(
+    "/",
+    route(
+      async () => ({
+        view: "pages/home",
+        metadata: { title: "Home" },
+        data: { message: "JSkelet is running." },
+      }),
+      { revalidate: 60 },
+    ),
+  );
+}
+`,
+  "views/pages/home.ejs": `<section class="wrapper">
+  <h1><%= metadata.title %></h1>
+  <p><%= message %></p>
+  <div data-island="counter" data-island-props='{"start":0}'></div>
+</section>
+`,
+  "views/pages/not-found.ejs": `<section class="wrapper">
+  <h1>404</h1>
+  <p>The page you are looking for was not found.</p>
+  <p><a href="/">Back to home</a></p>
+</section>
+`,
+  "views/components/button.js": `import { attrs, esc } from "jskelet/html";
+/**
+ * Every named export under \`views/components/**\` is usable directly in
+ * templates: \`<%- button({ text: "Save" }) %>\`. No import needed.
+ *
+ * @param {{ text: string, href?: string, class?: string }} props
+ * @returns {string}
+ */
+export function button({ text, href, class: className }) {
+  const tag = href ? "a" : "button";
+  return \`<\${tag}\${attrs({ href, class: className })}>\${esc(text)}</\${tag}>\`;
+}
+`,
+  "client/entries/main.js": `import { registerAll, start } from "jskelet/client";
+/**
+ * Island registry. Values are dynamic imports: a module is downloaded only if
+ * that island is actually on the page and becomes visible.
+ */
+registerAll({
+  counter: () => import("../islands/counter.js"),
+});
+start();
+`,
+  "client/islands/counter.js": `/**
+ * Island contract: a named export called \`mount(element, props)\`.
+ * The returned function, if any, is reserved for cleanup.
+ *
+ * @param {HTMLElement} element
+ * @param {{ start?: number }} props
+ */
+export function mount(element, props) {
+  let value = props.start ?? 0;
+  const button = document.createElement("button");
+  button.type = "button";
+  const paint = () => {
+    button.textContent = \`Clicks: \${value}\`;
+  };
+  button.addEventListener("click", () => {
+    value += 1;
+    paint();
+  });
+  paint();
+  element.append(button);
+}
+`,
+  "styles/globals.css": `@import "tailwindcss" source(none);
+/**
+ * Tailwind's class scanning depends on these directives. Automatic detection
+ * only scans the directory holding this file; variants used in templates
+ * (like data-[active=false]:…) would otherwise be dropped silently.
+ */
+@source "../views";
+@source "../client";
+@source "../routes";
+body {
+  margin: 0;
+  font-family: system-ui, sans-serif;
+}
+.wrapper {
+  max-width: 64rem;
+  margin-inline: auto;
+  padding: 2rem 1rem;
+}
+`,
+  "jsconfig.json": `{
+  "compilerOptions": {
+    "checkJs": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "target": "es2022",
+    "baseUrl": ".",
+    "paths": { "@/*": ["./*"] }
+  },
+  "exclude": ["node_modules", "public/assets"]
+}
+`,
+  ".gitignore": `node_modules/
+.jskelet/
+public/assets/
+.env
+`,
+};
+/**
+ * @param {string} root
+ * @returns {Promise<void>}
+ */
+export async function init(root) {
+  log.section("init");
+  const created = [];
+  const skipped = [];
+  for (const [relative, contents] of Object.entries(FILES)) {
+    const target = path.join(root, relative);
+    if (fs.existsSync(target)) {
+      skipped.push(relative);
+      continue;
+    }
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    fs.writeFileSync(target, contents);
+    created.push(relative);
+  }
+  for (const file of created) log.line(`+ ${file}`);
+  if (skipped.length) log.warn(`${skipped.length} files already existed, skipped`);
+  log.line("");
+  log.line("next step:  npx jskelet dev");
+}

package/src/log.mjs CHANGED Viewed

@@ -253,6 +253,14 @@ export function event({ symbol = symbols.ok, scope, message, note, time = null }
     `${message}${note ? `  ${c.dim(note)}` : ""}${padding}` +
     `${c.gray((time == null ? "" : ms(time)).padStart(TIME))}\n`,
   );
+  emitLog({
+    kind: "event",
+    scope,
+    message,
+    note: note ?? null,
+    ms: time ?? null,
+  });
 }
 /**
@@ -271,6 +279,15 @@ export function http(info) {
     `${tint(String(info.status))} ${c.gray(ms(info.ms).padStart(TIME))}` +
     `${info.cache === "HIT" ? ` ${c.dim("cached")}` : ""}\n`,
   );
+  emitLog({
+    kind: "http",
+    method: info.method,
+    url: info.url,
+    status: info.status,
+    ms: info.ms,
+    cache: info.cache ?? null,
+  });
 }
 /**
@@ -337,6 +354,14 @@ export function errorBox({ title, name, message, lines = [] }) {
   }
   line("");
   write(`${c.red(bottom)}\n\n`);
+  emitLog({
+    kind: "error",
+    scope: title,
+    message: `${name}: ${message}`,
+    note: lines.length ? lines.join(" · ") : null,
+    ms: null,
+  });
 }
 /**
@@ -361,3 +386,36 @@ function wrap(text, max) {
   if (current) out.push(current);
   return out.length ? out : [""];
 }
+/* -------------------------------------------------------------- aboneler */
+/**
+ * Admin paneli gibi dinleyiciler. Abone yokken `emitLog` boş Set üzerinde
+ * döner — stdout yoluna maliyet eklemez.
+ *
+ * @type {Set<(entry: Record<string, unknown>) => void>}
+ */
+const listeners = new Set();
+/**
+ * @param {(entry: Record<string, unknown>) => void} listener
+ * @returns {() => void} Aboneliği iptal eden fonksiyon.
+ */
+export function subscribe(listener) {
+  listeners.add(listener);
+  return () => listeners.delete(listener);
+}
+/**
+ * @param {Record<string, unknown>} entry
+ */
+function emitLog(entry) {
+  if (!listeners.size) return;
+  for (const listener of listeners) {
+    try {
+      listener(entry);
+    } catch {
+      // Dinleyici paneli düşürmesin.
+    }
+  }
+}