@stnd/modules 0.5.1

package/gsap/index.module.js

@@ -0,0 +1,20 @@
+/**
+ * GSAP Module — Animation library loaded from CDN on demand.
+ *
+ * Provides a lazy loader for GSAP core and ScrollTrigger plugin.
+ * No bundling — loaded at runtime from jsDelivr.
+ *
+ * Usage in components:
+ *   import { loadGsap } from "@stnd/modules/gsap/client.js";
+ */
+
+export default {
+  id: "gsap",
+  name: "GSAP",
+  description: "Animation library with ScrollTrigger — loaded from CDN on demand",
+
+  metadata: {
+    version: "1.0.0",
+    tags: ["animation", "scroll", "gsap", "scroll-trigger"],
+  },
+};

package/headers/index.module.js

@@ -0,0 +1,16 @@
+/**
+ * Security Headers core module
+ *
+ * Exposes the /_headers route via the Standard module system.
+ */
+export default {
+  id: "stnd-headers",
+  name: "Stnd :: Headers",
+  description: "Emits security headers (_headers) from site configuration.",
+  routes: [
+    {
+      path: "/_headers",
+      entrypoint: "./route.js",
+    },
+  ],
+};

package/headers/route.js

@@ -0,0 +1,93 @@
+import config from "virtual:stnd/config";
+
+export async function GET() {
+  const security = config.security || {};
+  if (security.enabled === false) {
+    return new Response(null, { status: 404 });
+  }
+
+  const defaults = {
+    xFrameOptions: "DENY",
+    xContentTypeOptions: "nosniff",
+    referrerPolicy: "strict-origin-when-cross-origin",
+    hsts: "max-age=31536000; includeSubDomains; preload",
+    enableCaching: true,
+    permissions: {
+      geolocation: [],
+      camera: [],
+      microphone: [],
+      payment: [],
+      usb: [],
+    },
+  };
+
+  const xFrameOptions = security.xFrameOptions ?? defaults.xFrameOptions;
+  const xContentTypeOptions =
+    security.xContentTypeOptions ?? defaults.xContentTypeOptions;
+  const referrerPolicy = security.referrerPolicy ?? defaults.referrerPolicy;
+  const hsts = security.hsts ?? defaults.hsts;
+  const enableCaching = security.enableCaching ?? defaults.enableCaching;
+
+  const permissionsConfig = {
+    ...defaults.permissions,
+    ...(security.permissions || {}),
+  };
+
+  const permissionsStr = Object.entries(permissionsConfig)
+    .map(([key, values]) => {
+      const origins = values.length > 0 ? values.join(" ") : "";
+      return `${key}=(${origins})`;
+    })
+    .join(", ");
+
+  // CSP is intentionally omitted — Astro 6 handles Content-Security-Policy
+  // natively via security.csp with proper hash-based script-src and style-src.
+  // Duplicating it here would conflict with Astro's generated hashes.
+
+  let content = `# Security Headers
+# Generated by Standard Framework
+
+/*
+  Strict-Transport-Security: ${hsts}
+  X-Frame-Options: ${xFrameOptions}
+  X-Content-Type-Options: ${xContentTypeOptions}
+  Referrer-Policy: ${referrerPolicy}
+  Permissions-Policy: ${permissionsStr}
+  X-DNS-Prefetch-Control: on
+  Cross-Origin-Opener-Policy: same-origin
+  Cross-Origin-Resource-Policy: same-origin
+`;
+
+  if (enableCaching) {
+    content += `
+# Cache Headers — immutable hashed assets
+/_astro/*
+  Cache-Control: public, max-age=31536000, immutable
+
+/*.css
+  Cache-Control: public, max-age=31536000, immutable
+
+/*.js
+  Cache-Control: public, max-age=31536000, immutable
+
+/*.woff2
+  Cache-Control: public, max-age=31536000, immutable
+
+# Cache Headers — static assets (revalidate periodically)
+/assets/*
+  Cache-Control: public, max-age=86400, stale-while-revalidate=604800
+
+/*.svg
+  Cache-Control: public, max-age=86400, stale-while-revalidate=604800
+
+/*.ico
+  Cache-Control: public, max-age=86400, stale-while-revalidate=604800
+`;
+  }
+
+  return new Response(content, {
+    headers: {
+      "Content-Type": "text/plain",
+    },
+  });
+}

package/humans/index.module.js

@@ -0,0 +1,17 @@
+/**
+ * humans.txt core module
+ *
+ * Exposes the /humans.txt route via the Standard module system.
+ * A small signal of craft — who built this, and with what.
+ */
+export default {
+  id: "stnd-humans",
+  name: "Stnd :: humans.txt",
+  description: "Serves humans.txt — the people and tools behind the site.",
+  routes: [
+    {
+      path: "/humans.txt",
+      entrypoint: "./route.js",
+    },
+  ],
+};

package/humans/route.js

@@ -0,0 +1,79 @@
+import config from "virtual:stnd/config";
+
+export async function GET() {
+  const humans = config.humans || {};
+  if (humans.enabled === false) {
+    return new Response(null, { status: 404 });
+  }
+
+  const site = config.site || "";
+  const title = config.title || "A Standard Framework Site";
+  const language = config.language || "en";
+  const author = config.author || {};
+
+  let content = `/* TEAM */
+`;
+
+  if (author.name) {
+    content += `  Chef: ${author.name}\n`;
+  }
+  if (author.url) {
+    content += `  Site: ${author.url}\n`;
+  }
+  if (author.location) {
+    content += `  Location: ${author.location}\n`;
+  }
+  if (author.contact) {
+    content += `  Contact: ${author.contact}\n`;
+  }
+
+  // Additional team members from config
+  if (Array.isArray(humans.team)) {
+    for (const member of humans.team) {
+      content += `\n`;
+      if (member.role) content += `  ${member.role}: ${member.name || ""}\n`;
+      else if (member.name) content += `  Name: ${member.name}\n`;
+      if (member.site) content += `  Site: ${member.site}\n`;
+      if (member.location) content += `  Location: ${member.location}\n`;
+      if (member.contact) content += `  Contact: ${member.contact}\n`;
+    }
+  }
+
+  content += `
+/* THANKS */
+  Astro — https://astro.build
+  Standard Framework — https://stnd.build
+`;
+
+  if (Array.isArray(humans.thanks)) {
+    for (const thanks of humans.thanks) {
+      if (typeof thanks === "string") {
+        content += `  ${thanks}\n`;
+      } else if (thanks.name) {
+        content += `  ${thanks.name}${thanks.url ? ` — ${thanks.url}` : ""}\n`;
+      }
+    }
+  }
+
+  content += `
+/* SITE */
+  Name: ${title}
+  Language: ${language}
+  Standards: HTML5, CSS3
+  Software: Astro, Standard Framework
+`;
+
+  if (site) {
+    content += `  URL: ${site}\n`;
+  }
+
+  if (humans.components) {
+    content += `  Components: ${humans.components}\n`;
+  }
+
+  return new Response(content, {
+    headers: {
+      "Content-Type": "text/plain; charset=utf-8",
+    },
+  });
+}

package/iconify/index.module.js

@@ -0,0 +1,9 @@
+/**
+ * Iconify Module
+ * Client script lives in @stnd/client — manifest registered here.
+ */
+export default {
+  id: "stnd-iconify",
+  name: "Stnd :: Client :: Iconify",
+  scripts: [{ src: "@stnd/icon/client", init: "initIconify" }],
+};

package/image-zoom/index.module.js

@@ -0,0 +1,9 @@
+/**
+ * Image Zoom Module
+ * Client script lives in @stnd/client — manifest registered here.
+ */
+export default {
+  id: "stnd-image-zoom",
+  name: "Stnd :: Client :: Image Zoom",
+  scripts: [{ src: "@stnd/client/image-zoom", init: "initImageZoom", refresh: "rescanImages" }],
+};

package/keyboard/index.module.js

@@ -0,0 +1,9 @@
+/**
+ * Keyboard Module
+ * Client script lives in @stnd/client — manifest registered here.
+ */
+export default {
+  id: "stnd-keyboard",
+  name: "Stnd :: Client :: Keyboard",
+  scripts: [{ src: "@stnd/client/keyboard", init: "initKeyboard" }],
+};

package/lab/index.module.js

@@ -0,0 +1,26 @@
+/**
+ * Lab Module Manifest
+ *
+ * Live CSS token inspector and design debug tools.
+ * Registered as a Gold Standard module — every @stnd site ships with this.
+ *
+ * Zone: stnd:client (hydrated Svelte component, needs client-side interactivity)
+ */
+export default {
+  id: "stnd-lab",
+  name: "Stnd :: Lab",
+  description: "Loads the StandardLab bundle for inspector/debug tools.",
+  environment: ["dev"],
+  scripts: ["@stnd/lab"],
+
+  hooks: {
+    "stnd:client": [
+      {
+        ui: "@stnd/lab/Lab.svelte",
+        meta: {
+          "client:load": true,
+        },
+      },
+    ],
+  },
+};

package/launcher/index.module.js

@@ -0,0 +1,27 @@
+/**
+ * Launcher Module Manifest
+ *
+ * Provides the core launcher engine and UI hooks.
+ * Registers the Launcher UI in the stnd:client hook zone so it
+ * auto-injects into every page via <Hook zone="stnd:client" />.
+ *
+ * Runtime API (initLauncher, configureLauncher, launcherToggle, etc.)
+ * should be imported from "@stnd/launcher/launcher" — not from this file.
+ */
+export default {
+  id: "stnd::launcher",
+  name: "Stnd :: Launcher",
+  description: "Universal Command Palette Engine",
+  dependencies: ["@stnd/modules/keyboard", "@stnd/icon/module"],
+
+  hooks: {
+    "stnd:client": [
+      {
+        ui: "@stnd/launcher/Launcher.svelte",
+        meta: {
+          "client:load": true,
+        },
+      },
+    ],
+  },
+};

package/maintenance/index.module.js

@@ -0,0 +1,18 @@
+/**
+ * Maintenance Mode core module
+ *
+ * Displays a maintenance page and restricts access to the site.
+ * Disabled by default — load explicitly via moduleLoad when needed.
+ */
+export default {
+  id: "stnd-maintenance",
+  name: "Stnd :: Mode Maintenance",
+  description: "Affiche une page de construction et restreint l'accès au site.",
+  routes: [
+    {
+      path: "/maintenance",
+      entrypoint: "./routes/index.astro",
+    },
+  ],
+  middleware: ["./middleware.js"],
+};

package/maintenance/middleware.js

@@ -0,0 +1,34 @@
+
+import { defineMiddleware } from "astro:middleware";
+
+export const onRequest = defineMiddleware(async (context, next) => {
+    console.log("🔒 Maintenance Middleware Check:", context.request.url);
+    // 1. Check if maintenance mode is enabled via Environment Variable
+    // Cloudflare uses context.locals.runtime.env usually, or import.meta.env for build time vars
+    // We check both for robustness (dev vs prod)
+
+    // const env = context.locals?.runtime?.env || import.meta.env;
+    // const isMaintenance = env.MAINTENANCE_MODE === "true";
+
+    // Mode Maintenance "ON" par défaut si ce folio est chargé.
+    const isMaintenance = true;
+
+    // 2. Allow access to the maintenance page itself and assets
+    const pathname = context.url.pathname;
+    if (
+        pathname === "/maintenance" ||
+        pathname === "/maintenance/" ||
+        pathname.startsWith("/_astro") ||
+        pathname.startsWith("/assets") ||
+        pathname.startsWith("/favicon")
+    ) {
+        return next();
+    }
+
+    // 3. Redirect if maintenance is active
+    if (isMaintenance) {
+        return context.redirect("/maintenance", 307); // 307 Temporary Redirect
+    }
+
+    return next();
+});

package/maintenance/routes/index.astro

@@ -0,0 +1,45 @@
+---
+
+---
+
+<!doctype html>
+<html lang="fr">
+    <head>
+        <meta charset="UTF-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+        <title>En construction</title>
+        <style>
+            body {
+                display: flex;
+                height: 100vh;
+                margin: 0;
+                align-items: center;
+                justify-content: center;
+                font-family: system-ui, sans-serif;
+                background-color: #f5f5f0;
+                color: #1a1a1a;
+                text-align: center;
+            }
+            .container {
+                max-width: 600px;
+                padding: 2rem;
+            }
+            h1 {
+                margin-bottom: 1rem;
+            }
+            a {
+                color: inherit;
+                text-decoration: underline;
+            }
+        </style>
+    </head>
+    <body>
+        <div class="container">
+            <h1>Site en construction</h1>
+            <p>Nous revenons très bientôt.</p>
+            <p>
+                <a href="mailto:contact@lartdenseigner.com">Nous contacter</a>
+            </p>
+        </div>
+    </body>
+</html>

package/manifest/index.module.js

@@ -0,0 +1,16 @@
+/**
+ * Web Manifest core module
+ *
+ * Exposes the /site.webmanifest route via the Standard module system.
+ */
+export default {
+  id: "stnd-manifest",
+  name: "Stnd :: Manifest",
+  routes: [
+    {
+      path: "/site.webmanifest",
+      entrypoint: "./route.js",
+    },
+  ],
+  description: "Serves the web app manifest from site configuration.",
+};

package/manifest/route.js

@@ -0,0 +1,57 @@
+import config from "virtual:stnd/config";
+
+export async function GET() {
+  const manifestConfig = config.manifest || {};
+  if (manifestConfig.enabled === false) {
+    return new Response(null, { status: 404 });
+  }
+
+  const defaults = {
+    name: "My Site",
+    short_name: "Site",
+    description: "A website",
+    start_url: "/",
+    display: "standalone",
+    orientation: "any",
+    theme_color: "#000000",
+    background_color: "#ffffff",
+    icons: [],
+    categories: [],
+    screenshots: [],
+    shortcuts: [],
+  };
+
+  const manifest = {
+    name: manifestConfig.name || config.title || defaults.name,
+    short_name:
+      manifestConfig.short_name || config.title || defaults.short_name,
+    description:
+      manifestConfig.description || config.description || defaults.description,
+    start_url: manifestConfig.start_url || defaults.start_url,
+    display: manifestConfig.display || defaults.display,
+    orientation: manifestConfig.orientation || defaults.orientation,
+    theme_color: manifestConfig.theme_color || defaults.theme_color,
+    background_color:
+      manifestConfig.background_color || defaults.background_color,
+    icons: manifestConfig.icons || defaults.icons,
+  };
+
+  if (manifestConfig.categories)
+    manifest.categories = manifestConfig.categories;
+  if (manifestConfig.screenshots)
+    manifest.screenshots = manifestConfig.screenshots;
+  if (manifestConfig.shortcuts) manifest.shortcuts = manifestConfig.shortcuts;
+
+  if (config.author && config.author.name) {
+    manifest.author = config.author.name;
+    if (config.author.url) {
+      manifest.author_url = config.author.url;
+    }
+  }
+
+  return new Response(JSON.stringify(manifest, null, 2), {
+    headers: {
+      "Content-Type": "application/manifest+json",
+    },
+  });
+}

package/math/client.js

@@ -0,0 +1,98 @@
+/**
+ * Math Module — KaTeX Client Initializer
+ *
+ * Standalone module that detects and renders mathematical notation.
+ * Decoupled from the markdown renderer.
+ */
+
+const KATEX_VERSION = "0.16.32";
+const KATEX_CDN = `https://cdn.jsdelivr.net/npm/katex@${KATEX_VERSION}/dist`;
+
+const RENDER_CONFIG = {
+  delimiters: [
+    { left: "$$", right: "$$", display: true },
+    { left: "$", right: "$", display: false },
+    { left: "\\[", right: "\\]", display: true },
+    { left: "\\(", right: "\\)", display: false },
+  ],
+  throwOnError: false,
+  trust: false,
+};
+
+/** Quick check — does the page contain anything that looks like math? */
+function pageHasMath() {
+  const scope = document.querySelector("main") || document.body;
+  const text = scope.textContent || "";
+  if (text.includes("$$")) return true;
+  if (/\$[^$\n]+\$/.test(text)) return true;
+  if (text.includes("\\(") || text.includes("\\[")) return true;
+  const markers = ["\\frac", "\\sum", "\\int", "\\sqrt", "\\alpha", "\\beta"];
+  return markers.some((m) => text.includes(m));
+}
+
+/** Inject the KaTeX stylesheet (idempotent) */
+function ensureStylesheet() {
+  if (document.querySelector(`link[href*="katex@${KATEX_VERSION}"]`)) return;
+  const link = document.createElement("link");
+  link.rel = "stylesheet";
+  link.href = `${KATEX_CDN}/katex.min.css`;
+  document.head.appendChild(link);
+}
+
+/** Load a script via <script> tag, returns a promise (idempotent) */
+function loadScript(src) {
+  return new Promise((resolve, reject) => {
+    const existing = document.querySelector(`script[src="${src}"]`);
+    if (existing) {
+      if (existing.dataset.loaded) resolve();
+      else {
+        existing.addEventListener("load", () => resolve());
+        existing.addEventListener("error", () =>
+          reject(new Error(`Failed to load ${src}`)),
+        );
+      }
+      return;
+    }
+    const s = document.createElement("script");
+    s.src = src;
+    s.onload = () => {
+      s.dataset.loaded = "1";
+      resolve();
+    };
+    s.onerror = () => reject(new Error(`Failed to load ${src}`));
+    document.head.appendChild(s);
+  });
+}
+
+let loaded = false;
+let isProcessing = false;
+
+/** Dynamically load KaTeX + auto-render, then render math in the page. */
+async function renderMath() {
+  if (isProcessing || !pageHasMath()) return;
+  isProcessing = true;
+
+  ensureStylesheet();
+
+  if (!loaded) {
+    try {
+      await loadScript(`${KATEX_CDN}/katex.min.js`);
+      await loadScript(`${KATEX_CDN}/contrib/auto-render.min.js`);
+      loaded = true;
+    } catch (err) {
+      console.error("[Math] Failed to load KaTeX:", err);
+      isProcessing = false; // Ensure processing flag is reset on error
+      return;
+    }
+  }
+
+  const render = window.renderMathInElement;
+  if (typeof render === "function") {
+    const scope = document.querySelector("main") || document.body;
+    render(scope, RENDER_CONFIG);
+  }
+  isProcessing = false;
+}
+
+export const init = renderMath;
+export const refresh = renderMath;

package/math/index.module.js

@@ -0,0 +1,19 @@
+/**
+ * Math Module — Standalone mathematical notation rendering.
+ *
+ * Scans the page for LaTeX-style markers ($$, $) and renders them via KaTeX.
+ */
+
+export default {
+  id: "math",
+  name: "Math (KaTeX)",
+  description: "Mathematical notation rendering with KaTeX",
+
+  styles: ["./styles.css"],
+  scripts: [{ src: "./client.js", init: "init", refresh: "refresh" }],
+
+  metadata: {
+    version: "1.0.0",
+    tags: ["math", "katex", "latex"],
+  },
+};

package/math/styles.css

@@ -0,0 +1,25 @@
+.katex,
+.katex-display {
+  text-box-trim: none !important;
+}
+
+/*
+  Fix Chromium "Aw, Snap! Error code 11"
+  Chromium crashes when a block-level element is injected inside a <p> tag
+  that has text-box-trim applied.
+  1. We turn off text-box-trim on the parent paragraph.
+  2. We force the display math to be inline-block instead of block, preventing the illegal DOM structure.
+*/
+p:has(.katex-display) {
+  padding-block: var(--space-2);
+  font-size: var(--size-lg);
+  * {
+    text-box-trim: none !important;
+  }
+}
+
+.katex-display {
+  display: inline-block !important;
+  width: 100%;
+  text-align: center;
+}