npm - jskelet - Versions diffs - 0.6.3 → 0.6.4 - Mend

jskelet 0.6.3 → 0.6.4

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 (153) hide show

package/AGENTS.md +136 -136
package/CHANGELOG.md +628 -620
package/LICENSE +21 -21
package/README.md +2 -0
package/bin/jskelet.mjs +130 -130
package/docs/01-baslangic.md +291 -291
package/docs/02-mimari.md +310 -310
package/docs/03-routing.md +515 -515
package/docs/04-render-ve-sablonlar.md +667 -661
package/docs/05-islands.md +486 -486
package/docs/06-cache.md +1467 -1443
package/docs/07-yapilandirma.md +1208 -1197
package/docs/08-build.md +429 -429
package/docs/09-dev-araclari.md +364 -364
package/docs/10-dagitim.md +348 -338
package/docs/12-panel-ve-oturum.md +479 -478
package/docs/README.md +83 -83
package/docs/en/01-getting-started.md +298 -298
package/docs/en/02-architecture.md +329 -329
package/docs/en/03-routing.md +531 -531
package/docs/en/04-rendering.md +675 -669
package/docs/en/05-islands.md +497 -497
package/docs/en/06-caching.md +1476 -1453
package/docs/en/07-configuration.md +1229 -1219
package/docs/en/08-build.md +447 -447
package/docs/en/09-dev-tools.md +373 -373
package/docs/en/10-deployment.md +351 -340
package/docs/en/11-migration.md +398 -398
package/docs/en/12-dashboards-and-sessions.md +489 -488
package/docs/en/README.md +87 -87
package/package.json +137 -137
package/src/build/ensure-build.mjs +19 -19
package/src/build/paths.mjs +153 -153
package/src/build/resolve-peer.mjs +36 -36
package/src/build/tasks/client.mjs +349 -349
package/src/build/tasks/css.mjs +235 -235
package/src/build/tasks/fonts.mjs +146 -146
package/src/build/tasks/icons.mjs +357 -357
package/src/build/tasks/images.mjs +244 -244
package/src/build/tasks/precompress.mjs +78 -78
package/src/build/tasks/templates.mjs +20 -20
package/src/client/admin/i18n.js +764 -764
package/src/client/admin/login.html +74 -74
package/src/client/admin/panel.css +809 -809
package/src/client/admin/panel.html +495 -495
package/src/client/admin/panel.js +1251 -1251
package/src/client/devtools/report.html +185 -185
package/src/client/devtools/report.js +745 -745
package/src/client/devtools/seo.js +628 -628
package/src/client/dom.js +95 -95
package/src/client/form.js +192 -192
package/src/client/index.js +45 -45
package/src/client/registry.js +305 -305
package/src/client/safe-image.js +91 -91
package/src/client/shared-cookie.js +225 -225
package/src/client/store.js +36 -36
package/src/client/swap.js +188 -188
package/src/compile/codegen.js +336 -336
package/src/compile/compile-all.js +149 -149
package/src/compile/errors.js +66 -66
package/src/compile/expr.js +409 -409
package/src/compile/index.js +17 -17
package/src/compile/parse.js +541 -541
package/src/compile/resolve.js +211 -211
package/src/compile/scan-exports.js +51 -51
package/src/config/defaults.js +541 -534
package/src/config/index.js +1500 -1469
package/src/config/pattern.js +107 -107
package/src/generate.mjs +163 -163
package/src/http/control-flow.js +71 -71
package/src/http/cookies-entry.js +21 -21
package/src/http/cookies.js +277 -277
package/src/http/request-cache.js +46 -46
package/src/http/request-context.js +165 -165
package/src/http/shared-cookie.js +178 -178
package/src/index.js +101 -101
package/src/init.mjs +232 -230
package/src/migrate/apply.mjs +262 -262
package/src/migrate/babel.mjs +79 -79
package/src/migrate/classify.mjs +155 -155
package/src/migrate/config.mjs +126 -126
package/src/migrate/fs-walk.mjs +191 -191
package/src/migrate/parse.mjs +26 -26
package/src/migrate/scan.mjs +177 -177
package/src/migrate/transform/expr-source.mjs +168 -168
package/src/migrate/transform/island.mjs +67 -67
package/src/migrate/transform/jsx-to-component.mjs +302 -302
package/src/migrate/transform/jsx-to-jsk.mjs +330 -330
package/src/migrate/transform/page-split.mjs +435 -435
package/src/migrate/write.mjs +81 -81
package/src/migrate.mjs +171 -171
package/src/runtime/alias-hooks.mjs +119 -119
package/src/runtime/register.mjs +4 -4
package/src/server/admin/actions.js +229 -229
package/src/server/admin/auth.js +125 -125
package/src/server/admin/event-log.js +151 -151
package/src/server/admin/gate.js +209 -209
package/src/server/admin/inventory.js +188 -188
package/src/server/admin/mount.js +56 -56
package/src/server/admin/router.js +216 -216
package/src/server/admin/snapshot.js +241 -241
package/src/server/assets.js +147 -147
package/src/server/auth/handoff.js +309 -309
package/src/server/cache-blob.js +70 -70
package/src/server/cache-control.js +45 -0
package/src/server/cache-deps.js +42 -42
package/src/server/cache-vary.js +113 -113
package/src/server/cloudflare.js +607 -607
package/src/server/create-app.js +366 -366
package/src/server/data-cache.js +553 -553
package/src/server/dev/report.js +485 -485
package/src/server/dev/socket.js +170 -170
package/src/server/dev/version-check.mjs +139 -139
package/src/server/disk-cache.js +233 -233
package/src/server/ejs-adapter.js +59 -59
package/src/server/html-cache.js +1196 -1196
package/src/server/image-optimizer.js +500 -500
package/src/server/logs/access-middleware.js +66 -66
package/src/server/logs/file-sink.js +193 -193
package/src/server/logs/pipeline.js +165 -165
package/src/server/logs/s3-put.js +214 -214
package/src/server/logs/s3-sink.js +112 -112
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 +75 -75
package/src/server/middleware/headers.js +37 -37
package/src/server/middleware/redirects.js +32 -32
package/src/server/middleware/robots-txt.js +341 -341
package/src/server/middleware/static-precompressed.js +121 -121
package/src/server/middleware/trailing-slash.js +53 -53
package/src/server/middleware/upstream-proxy.js +141 -141
package/src/server/og-image.js +369 -356
package/src/server/port-guard.js +255 -255
package/src/server/prewarm.js +1082 -1082
package/src/server/redis.js +588 -588
package/src/server/render.js +910 -910
package/src/server/router.js +157 -157
package/src/server/status-page.js +265 -265
package/src/server/upstream-limiter.js +376 -376
package/src/server/upstream-tracking.js +166 -166
package/src/shared/cookie-domain.js +66 -66
package/src/start.mjs +22 -22
package/src/templates/layout.ejs +30 -30
package/src/templates/layout.jsk +30 -30
package/src/version.mjs +31 -31
package/src/views/components/loader.js +101 -101
package/src/views/helpers/html.js +102 -102
package/src/views/helpers/tags.js +375 -375
package/types/config/defaults.d.ts +6 -0
package/types/config/index.d.ts +6 -0
package/types/server/cache-control.d.ts +28 -0
package/types/server/og-image.d.ts +5 -0

package/src/init.mjs CHANGED Viewed

@@ -1,230 +1,232 @@
-/**
- * `jskelet init` — bulunduğun dizine çalışan bir minimum iskelet kurar.
- *
- * Varsayılan düzen feature-first'tir: sayfa, bileşen ve island
- * `features/<name>/` altında toplanır; URL kaydı yine açıkça yazılır.
- * Şablonlar `.jsk`. 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 } },
-      };
-    },
-  },
-};
-`,
-  "features/home/index.js": `/**
- * Feature route registration. Explicit paths only — no filesystem URL routing.
- * Loaded after \`routes/\` (alphabetically among features).
- *
- * @param {import('express').Express} app
- * @param {{ route: Function }} api
- */
-export default function register(app, { route }) {
-  app.get(
-    "/",
-    route(
-      async () => ({
-        view: "pages/home",
-        metadata: { title: "Home" },
-        data: { message: "JSkelet is running." },
-      }),
-      { revalidate: 60 },
-    ),
-  );
-}
-`,
-  "features/home/views/pages/home.jsk": `<section class="wrapper">
-  <h1>{{ metadata.title }}</h1>
-  <p>{{ message }}</p>
-  <Button text="Example component" />
-  <div data-island="counter" data-island-props='{"start":0}'></div>
-</section>
-`,
-  "features/home/views/components/button.js": `import { attrs, esc } from "jskelet/html";
-/**
- * Named exports under \`views/components/**\` (including feature views) become
- * PascalCase tags in \`.jsk\`: \`<Button text="Save" />\`.
- *
- * @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}>\`;
-}
-`,
-  "features/home/client/counter.js": `/**
- * Island contract: a named export called \`mount(element, props)\`.
- * Register it from \`client/entries/main.js\`. 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);
-}
-`,
-  "features/home/server/.gitkeep": "",
-  "views/pages/not-found.jsk": `<section class="wrapper">
-  <h1>404</h1>
-  <p>The page you are looking for was not found.</p>
-  <p><Link href="/" text="Back to home" /></p>
-</section>
-`,
-  "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("../../features/home/client/counter.js"),
-});
-start();
-`,
-  "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";
-@source "../features";
-@source "../shared";
-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");
-  log.line("grow with:  npx jskelet generate feature <name>");
-}
+/**
+ * `jskelet init` — bulunduğun dizine çalışan bir minimum iskelet kurar.
+ *
+ * Varsayılan düzen feature-first'tir: sayfa, bileşen ve island
+ * `features/<name>/` altında toplanır; URL kaydı yine açıkça yazılır.
+ * Şablonlar `.jsk`. 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 },
+      /** Edge stale window after that TTL. 0 omits the directive. */
+      staleWhileRevalidate: 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 } },
+      };
+    },
+  },
+};
+`,
+  "features/home/index.js": `/**
+ * Feature route registration. Explicit paths only — no filesystem URL routing.
+ * Loaded after \`routes/\` (alphabetically among features).
+ *
+ * @param {import('express').Express} app
+ * @param {{ route: Function }} api
+ */
+export default function register(app, { route }) {
+  app.get(
+    "/",
+    route(
+      async () => ({
+        view: "pages/home",
+        metadata: { title: "Home" },
+        data: { message: "JSkelet is running." },
+      }),
+      { revalidate: 60 },
+    ),
+  );
+}
+`,
+  "features/home/views/pages/home.jsk": `<section class="wrapper">
+  <h1>{{ metadata.title }}</h1>
+  <p>{{ message }}</p>
+  <Button text="Example component" />
+  <div data-island="counter" data-island-props='{"start":0}'></div>
+</section>
+`,
+  "features/home/views/components/button.js": `import { attrs, esc } from "jskelet/html";
+/**
+ * Named exports under \`views/components/**\` (including feature views) become
+ * PascalCase tags in \`.jsk\`: \`<Button text="Save" />\`.
+ *
+ * @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}>\`;
+}
+`,
+  "features/home/client/counter.js": `/**
+ * Island contract: a named export called \`mount(element, props)\`.
+ * Register it from \`client/entries/main.js\`. 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);
+}
+`,
+  "features/home/server/.gitkeep": "",
+  "views/pages/not-found.jsk": `<section class="wrapper">
+  <h1>404</h1>
+  <p>The page you are looking for was not found.</p>
+  <p><Link href="/" text="Back to home" /></p>
+</section>
+`,
+  "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("../../features/home/client/counter.js"),
+});
+start();
+`,
+  "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";
+@source "../features";
+@source "../shared";
+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");
+  log.line("grow with:  npx jskelet generate feature <name>");
+}