@stnd/modules 0.5.1

package/Backlinks.astro

@@ -0,0 +1,56 @@
+---
+interface BacklinkItem {
+  url: string;
+  title?: string;
+  data?: {
+    visibility?: string;
+  };
+}
+
+interface Props {
+  backlinks?: BacklinkItem[];
+  heading?: string;
+  ariaLabel?: string;
+}
+
+const props = Astro.props as Props;
+const {
+  backlinks = [],
+  heading = "Mentionné dans",
+  ariaLabel = "Backlinks small",
+} = props;
+
+// ✨ NEW: Deduplicate backlinks by URL
+const seenUrls = new Set();
+const deduplicatedBacklinks = backlinks.filter((entry: BacklinkItem) => {
+  if (seenUrls.has(entry.url)) {
+    return false; // Skip duplicates
+  }
+  seenUrls.add(entry.url);
+  return true;
+});
+
+const publicBacklinks = deduplicatedBacklinks.filter(
+  (entry: BacklinkItem) => entry?.data?.visibility !== "private",
+);
+---
+
+{
+  publicBacklinks.length > 0 && (
+    <>
+      <hr />
+      <article class="backlinks prose small tight">
+        <p class="muted mb-d4 flow-row">{heading}</p>
+        <nav aria-label={ariaLabel}>
+          <ul>
+             {publicBacklinks.map((item: BacklinkItem) => (
+              <li>
+                <a href={item.url}>{item.title ?? item.url}</a>
+              </li>
+            ))}
+          </ul>
+        </nav>
+      </article>
+    </>
+  )
+}

package/CHANGELOG.md

@@ -0,0 +1,60 @@
+# @stnd/folios
+
+## 0.5.1
+
+### Patch Changes
+
+- Updated dependencies
+  - @stnd/styles@0.5.2
+
+## 0.5.0
+
+### Minor Changes
+
+- Folio Load order
+
+### Patch Changes
+
+- Updated dependencies
+  - @stnd/styles@0.5.0
+  - @stnd/log@0.5.0
+  - @stnd/utils@0.5.0
+
+## 0.4.0
+
+### Minor Changes
+
+- Folio order
+
+### Patch Changes
+
+- Updated dependencies
+  - @stnd/styles@0.4.0
+  - @stnd/log@0.4.0
+  - @stnd/utils@0.4.0
+
+## 0.3.0
+
+### Minor Changes
+
+- 2d0ae02: NPM Test
+
+### Patch Changes
+
+- Updated dependencies [2d0ae02]
+  - @stnd/styles@0.3.0
+  - @stnd/log@0.3.0
+  - @stnd/utils@0.3.0
+
+## 0.2.0
+
+### Minor Changes
+
+- 6d8888a: First release
+
+### Patch Changes
+
+- Updated dependencies [6d8888a]
+  - @stnd/styles@0.2.0
+  - @stnd/log@0.2.0
+  - @stnd/utils@0.2.0

package/Comments.astro

@@ -0,0 +1,115 @@
+---
+/**
+ * Comments Component
+ * Renders the GitHub comments form.
+ */
+const { 
+  showSubmit = true, 
+  showReset = false, 
+  showCancel = false,
+  apiUrl = "/api/comments",
+  pollInterval = null
+} = Astro.props;
+
+// Get page ID from URL
+const url = Astro.url.pathname;
+const pageId = url
+  .replace(/^\//, "")
+  .replace(/\/$/, "")
+  .replace(/\//g, "_") || "index";
+
+const initOptions = {
+  apiUrl,
+  pageId,
+  container: "#comments",
+  form: "#comment-form",
+  pollInterval
+};
+---
+
+<article class="comments-system">
+  <div id="comments"></div>
+
+  <button 
+    id="show-comment-form-btn" 
+    type="button" 
+    class="button" 
+    onclick="document.getElementById('comment-form-wrapper').style.display='block'; this.style.display='none';"
+  >
+    Write a Comment
+  </button>
+
+  <div id="comment-form-wrapper" style="display: none;">
+    <form id="comment-form" method="post" action={apiUrl} novalidate>
+      <fieldset>
+        <legend>Leave a Comment</legend>
+
+        <label for="author">Your Name <span aria-label="required">*</span></label>
+        <input
+          type="text"
+          id="author"
+          name="author"
+          placeholder="Your name will be displayed with your comment."
+          required
+          maxlength="100"
+        />
+
+        <label for="email">Email Address <span aria-label="required">*</span></label>
+        <input
+          type="email"
+          id="email"
+          name="email"
+          placeholder="Your email will not be displayed publicly."
+          required
+        />
+
+        <label for="content">Comment <span aria-label="required">*</span></label>
+        <textarea
+          id="content"
+          name="content"
+          placeholder="Share your thoughts... Supports **bold**, *italic*, `code`, and [links](url)"
+          required
+          minlength="3"
+          maxlength="10000"
+          rows="6"
+        ></textarea>
+
+        <!-- Hidden fields -->
+        <input type="hidden" id="pageId" name="pageId" value={pageId} />
+        <input type="hidden" id="parentId" name="parentId" value="" />
+
+        <!-- Status indicator -->
+        <div id="form-status" role="status" aria-live="polite"></div>
+
+        <!-- Submit buttons -->
+        <div class="form-actions">
+          {showSubmit && <button type="submit" class="button">Post Comment</button>}
+          {showReset && <button type="reset" class="button">Clear</button>}
+          {showCancel && <button type="button" class="button">Cancel</button>}
+        </div>
+      </fieldset>
+    </form>
+  </div>
+</article>
+
+<script define:vars={{ initOptions }} is:inline defer>
+  document.addEventListener("DOMContentLoaded", async () => {
+    // Assuming GitHubComments is loaded globally or imported. 
+    // Since the original used a global script, we might need to import it here or assume it's available.
+    // For now, we'll assume the user includes the standard.comment.js script separately or we should import it.
+    // But standard.comment.js is in dist/.
+    
+    if (typeof GitHubComments !== 'undefined') {
+      const comments = new GitHubComments(initOptions);
+      try {
+        await comments.load();
+        comments.render();
+      } catch (error) {
+        console.error("Error loading comments:", error);
+        const container = document.querySelector("#comments");
+        if (container) container.innerHTML = '<p class="error">Failed to load comments. Please try again later.</p>';
+      }
+      comments.attachFormHandler();
+    }
+  });
+</script>

package/README.md

@@ -0,0 +1,404 @@
+---
+title: "@stnd/modules"
+aliases: []
+created: 2026-07-04 23:28
+modified: 2026-07-05 19:23
+last_audited: 2026-07-14
+audit_interval_days: 90
+next_audit: 2026-10-12
+audit_priority: 3
+maturity: tree
+mode: read
+publish: false
+status: active
+tags:
+  - package
+  - stnd
+theme: kernel
+type: package
+visibility: private
+---
+
+# @[stnd](../README)/modules
+
+> *The spine of the Standard application.*
+
+`@stnd/modules` is the discovery engine and runtime loader for the Standard vertical slice architecture. Each `*.module.js` manifest declares a self-contained section of your application — routes, styles, components, middleware, and actions in one folder.
+
+The name reflects the modular, self-contained units of the application. Remove one, and that feature disappears cleanly.
+
+## ELI5
+
+A *“module”* is one feature, in one folder: its routes, its styles, its components, all together. Want to add an RSS feed? `moduleLoad: ["@stnd/modules/rss"]` and it’s there — routes and all. Want to remove a feature entirely? Delete its folder. Nothing else in the app needs to know or change. This is the pattern behind everything: Standard itself ships as a pile of small modules (`@stnd/modules/robots`, `/sitemap`, `/rss`, `/toast`…) rather than one big framework blob.
+
+**Use a built-in module (in `astro.config.mjs`):**
+
+```javascript
+standard({ moduleLoad: ["@stnd/modules/rss", "@stnd/modules/humans"] });
+```
+
+**Make your own:** `stnd module <name>` (see `packages/cli`) scaffolds `modules/<name>/index.module.js` for you.
+
+## Manifest Schema
+
+A module manifest must be named `*.module.{js,ts}` (convention: `index.module.js`) and `export default { … }` with this shape:
+
+```javascript
+// REQUIRED
+id: string                // unique module id (e.g., "my-feature")
+name: string              // human-friendly label
+description?: string      // human-friendly description
+
+// Conditional Loading
+status?: "disabled"       // skip this module entirely
+environment?: string | string[]
+  // Restrict to specific Astro commands: "dev", "build", "preview"
+  // Accepts a single string or an array (e.g., ["dev", "preview"])
+  // Omit to load in all environments (default)
+
+// Unified Hooks (Logic & Interface)
+// ---------------------------------------------------------------------------
+// Standard automatically routes hooks based on their file extension:
+// - .js, .ts             -> LOGIC  (Listeners / Handlers)
+// - .astro, .svelte, .md -> UI     (Components / Plugs)
+//
+// These can be a single string or an array of entries.
+hooks?: {
+  [hookName: string]: string | Array<string | HookEntry>
+}
+
+// Routes (Astro)
+routes?: Array<{
+  path: string          // URL pattern (e.g., "/robots.txt")
+  entrypoint: string    // relative to folio dir (e.g., "./route.js" or "./route.astro")
+}>
+
+// Styles
+// - starts with "@" → imported as-is (package import)
+// - else resolved relative to module dir and injected via injectScript("page-ssr")
+styles?: string[]
+
+// Scripts
+// - starts with "@" → imported as-is
+// - else resolved relative to module dir and injected on the client page
+scripts?: string[]
+
+// Head entries
+// - string → imported like styles (SSR import)
+// - { inline: string } → injected as inline head script
+head?: Array<string | { inline: string }>
+
+// Middleware
+// - string → entrypoint, order defaults to 0
+// - { entrypoint: string; order?: number }
+middleware?: Array<string | { entrypoint: string; order?: number }>
+
+// Astro integrations (passed through)
+integrations?: Array<any>
+
+// Actions (Astro Actions)
+// - string → path to file exporting actions object(s)
+actions?: string
+
+// Content Collections
+// - string → path to file exporting collections (e.g., "./content.ts")
+content?: string
+
+// Dependencies (other modules this one requires)
+dependencies?: string[]
+```
+
+## Unified Hooks Architecture
+
+The `hooks` object is the brain of your module. It handles both system events and UI injection.
+
+### 1. Integration Hooks (Logic)
+
+If the hook name starts with `astro:` or the entry ends in `.js`/`.ts`, it’s treated as logic.
+
+```javascript
+// index.module.js
+export default {
+  id: "my-feature",
+  hooks: {
+    "astro:config:setup": "./hooks/setup.js", // Astro native hook
+    "app:init": "./hooks/init.ts", // Custom app hook
+  },
+};
+```
+
+### 2. Interface Hooks (UI Plugs)
+
+If the entry ends in `.astro`, `.svelte`, `.md`, or any other format, it’s treated as a UI component.
+
+```javascript
+// index.module.js
+export default {
+  id: "my-feature",
+  hooks: {
+    "header:top": ["./components/Banner.astro"],
+    "footer:bottom": "./components/Copyright.astro",
+  },
+};
+```
+
+### Consuming Hooks
+
+**UI Rendering (Zones):**
+
+In your Layout or components, use the `<Hook />` component to render all registered components for a hook ID.
+
+```astro
+---
+import Hook from "@stnd/core/Hook";
+---
+
+<header>
+  <Hook id="header:top" props={{ theme: "dark" }} />
+</header>
+```
+
+**Logic Execution:**
+
+Trigger logic hooks via the virtual module.
+
+```javascript
+import { runHook } from "virtual:stnd/hooks";
+
+await runHook("app:init", { some: "data" });
+```
+
+### Middleware
+
+Module middlewares are native Astro Middlewares. They must follow the `(context, next)` signature and call `next()` to continue the chain.
+
+```javascript
+// index.module.js
+export default {
+  id: "auth",
+  middleware: [{ entrypoint: "./middleware.js", order: -100 }],
+};
+```
+
+```javascript
+// middleware.js
+import { defineMiddleware } from "astro:middleware";
+
+export const onRequest = defineMiddleware(async (context, next) => {
+  // Root initialization, auth checks, etc.
+  return next();
+});
+```
+
+### Content Extensions
+
+Modules can define Astro Content Collections.
+
+```javascript
+// index.module.js
+export default {
+  id: "my-feature",
+  content: "./content.ts",
+};
+```
+
+```typescript
+// content.ts
+import { defineCollection, z } from "astro:content";
+import { glob } from "astro/loaders";
+
+export const myCollection = defineCollection({
+  loader: glob({ pattern: "*.md", base: "./content/my-collection" }),
+  schema: z.object({
+    /* ... */
+  }),
+});
+```
+
+The application’s `src/content.config.ts` imports and merges these collections:
+
+```typescript
+import { collections as moduleCollections } from "virtual:stnd/content";
+
+export const collections = {
+  ...moduleCollections,
+};
+```
+
+---
+
+## Authoring Guide
+
+1. Place modules under `modules/<name>/index.module.js` at the project root.
+2. Keep logic inside the module; `.astro` files should only consume model instances.
+3. Import from sibling modules via `@modules/<name>` — this alias is auto-registered by `@stnd/core`.
+4. Prefer OKLCH and Standard tokens for styles; avoid one-off CSS.
+5. No backward compatibility — ship only the current shape.
+
+## The `@modules` Import Alias
+
+`@stnd/core` automatically registers `@modules` as a Vite alias pointing to the app’s `modules/` directory. Every app gets this for free — no manual tsconfig or Vite config needed.
+
+```javascript
+import { Note } from "@modules/spine/models/Note";
+import Author from "@modules/spine/models/Author";
+import Base from "@modules/base/layouts/Base.astro";
+```
+
+The corresponding `tsconfig.json` path (for editor intellisense):
+
+```json
+{
+  "compilerOptions": {
+    "paths": {
+      "@modules/*": ["modules/*"]
+    }
+  }
+}
+```
+
+## Boundary Rules
+
+Modules follow strict vertical slice isolation enforced by `dependency-cruiser`:
+
+- **Foundation modules** (`models`, `core`) — importable by any module
+- **Feature modules** (everything else) — must NOT import from sibling feature modules
+- **One-way dependencies** — features → foundation → `@stnd/*` packages, never reversed
+- **No circular deps** — within or across modules
+
+Run the boundary check:
+
+```bash
+pnpm boundaries:gd    # Check Standard Garden
+pnpm boundaries:ade   # Check L'art d'enseigner
+```
+
+## Loader Behavior
+
+- Discovers `**/*.module.{js,ts}` in the configured `moduleFolder` (default: `modules`).
+- `moduleLoad` in `astro.config` accepts:
+  - Bare names (auto-prefixed): `"launcher"`, `"design"`, etc.
+  - Explicit specifiers: `"@stnd/modules/design"` or `"./local/feature"`.
+- Routes, styles, scripts, head, middleware are injected per manifest.
+- Integrations are forwarded to Astro via `updateConfig`.
+- UI/Component extensions are exposed via `virtual:stnd/components`.
+- Client payload strips infrastructure keys; keeps `__importPath` for server use.
+
+## Disabling a Module
+
+Prefix the folder name with `_` to temporarily disable without deleting:
+
+```bash
+mv modules/export/ modules/_export/    # Disabled
+mv modules/_export/ modules/export/    # Re-enabled
+```
+
+The loader skips any folders starting with `_`.
+
+## Environment-Gated Modules
+
+Restrict a module to specific Astro commands (`dev`, `build`, or `preview`) using the `environment` field. The module is skipped entirely when the current command doesn’t match.
+
+```javascript
+// Only loaded during `astro dev`
+export default {
+  id: "dev-tools",
+  name: "Dev Tools",
+  environment: "dev",
+};
+
+// Loaded during `astro dev` and `astro preview`, but not `astro build`
+export default {
+  id: "staging-tools",
+  name: "Staging Tools",
+  environment: ["dev", "preview"],
+};
+```
+
+Omit the field to load in all environments (the default). When a module is skipped, its routes, styles, scripts, middleware, and hooks are completely absent from the build — as if the module didn’t exist.
+
+## Shipped Modules
+
+These built-in modules come with `@stnd/modules` and can be loaded via `moduleLoad`:
+
+### Gold Standard (loaded by default)
+
+Every `@stnd` site ships with these. Opt out via `moduleExclude`.
+
+| Module                   | ID              | Route               | What it does                                                       |
+| :----------------------- | :-------------- | :------------------ | :----------------------------------------------------------------- |
+| `@stnd/modules/styles`   | `stnd-styles`   | —                   | Injects the Standard design stylesheet                             |
+| `@stnd/modules/robots`   | `stnd-robots`   | `/robots.txt`       | Generates `robots.txt` from site config                            |
+| `@stnd/modules/headers`  | `stnd-headers`  | `/_headers`         | Emits security headers (HSTS, X-Frame-Options, Permissions-Policy) |
+| `@stnd/modules/manifest` | `stnd-manifest` | `/site.webmanifest` | Serves the web app manifest                                        |
+| `@stnd/modules/sitemap`  | `stnd-sitemap`  | —                   | Sitemap generation via `@astrojs/sitemap`                          |
+
+### Opt-In Modules
+
+Load these explicitly via `moduleLoad` when your site needs them.
+
+| Module                       | ID                  | Route                       | What it does                                           |
+| :--------------------------- | :------------------ | :-------------------------- | :----------------------------------------------------- |
+| `@stnd/modules/rss`          | `stnd-rss`          | `/rss.xml`                  | Generates an RSS 2.0 feed from site content and config |
+| `@stnd/modules/security-txt` | `stnd-security-txt` | `/.well-known/security.txt` | RFC 9116 security contact disclosure                   |
+| `@stnd/modules/humans`       | `stnd-humans`       | `/humans.txt`               | The people and tools behind the site                   |
+| `@stnd/modules/themes`       | `stnd-themes`       | —                           | Theme/temperament stylesheet injection                 |
+| `@stnd/modules/lab`          | `stnd-lab`          | —                           | StandardLab CSS inspector (dev tool)                   |
+| `@stnd/modules/content`      | `stnd-content`      | `/[…slug]`                | Content collection catch-all route                     |
+| `@stnd/modules/maintenance`  | `stnd-maintenance`  | `/maintenance`              | Maintenance mode with redirect middleware              |
+
+## Usage in an App
+
+Gold standard modules load automatically — just add your fonts, themes, and features:
+
+```javascript
+// astro.config.mjs
+import standard from "@stnd/core";
+
+export default defineConfig({
+  integrations: [
+    standard({
+      // Gold standard modules load automatically:
+      //   styles, robots, headers, manifest, sitemap, @stnd/fonts/inter
+
+      // Add your own modules on top of the defaults
+      moduleLoad: [
+        "@stnd/modules/rss",
+        "@stnd/modules/humans",
+        "@stnd/modules/security-txt",
+        "@stnd/fonts/kalice",
+        "@stnd/themes/editorial",
+      ],
+    }),
+  ],
+});
+```
+
+To opt out of a specific default, use `moduleExclude`:
+
+```javascript
+standard({
+  // Everything except the sitemap
+  moduleExclude: ["@stnd/modules/sitemap"],
+  moduleLoad: ["@stnd/modules/rss"],
+});
+```
+
+## Philosophy
+
+- **Vertical slice**: each module is self-contained — a section of the application.
+- **Strict boundaries**: features don’t cross-import. Dependencies flow one way.
+- **Zero shims**: no legacy flags, no backward compatibility layers.
+- **Performance and clarity**: small, explicit manifests; no hidden magic.
+
+## Notes / Observations
+
+*(jot down anything noticed here — quirks, gotchas, ideas)*
+
+## Todo
+
+- [ ] Nothing tracked yet. [priority:: 3] [token_scale:: 3] [created:: 2026-07-14] [area:: framework]
+
+---
+
+*“A well-bound app holds together not because of glue, but because every module knows its place.”*

package/ReadingTime.astro

@@ -0,0 +1,60 @@
+---
+/**
+ * ReadingTime Component
+ * Calculates and displays reading time estimate for given text
+ */
+interface Props {
+    text?: string;
+    wordsPerMinute?: number;
+    showIcon?: boolean;
+    prefix?: string;
+    suffix?: string;
+    class?: string;
+}
+
+const {
+    text = "",
+    wordsPerMinute = 225,
+    showIcon = false,
+    prefix = " - ",
+    suffix = "",
+    class: className = "",
+} = Astro.props;
+
+// Return empty string if no text provided
+if (!text || typeof text !== "string") {
+    return "";
+}
+
+// Count words by splitting on any whitespace
+const wordCount = text.split(/\s+/g).filter((word) => word.length > 0).length;
+const minutes = Math.floor(wordCount / wordsPerMinute);
+
+// Format the reading time
+let readingTime = "";
+if (minutes === 1) {
+    readingTime = `${prefix}1 minute${suffix}`;
+} else if (minutes > 1) {
+    readingTime = `${prefix}${minutes} minutes${suffix}`;
+} else {
+    readingTime = `${prefix}less than 1 minute${suffix}`;
+}
+
+// Icon SVG (optional)
+const icon = showIcon
+    ? `
+  <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" style="margin-right: 4px; vertical-align: middle;">
+    <circle cx="12" cy="12" r="10"></circle>
+    <polyline points="12,6 12,12 16,14"></polyline>
+  </svg>
+`
+    : "";
+---
+
+<span
+    class:list={["reading-time", className]}
+    aria-label={`Estimated reading time: ${minutes} ${minutes === 1 ? "minute" : "minutes"}`}
+>
+    <Fragment set:html={icon} />
+    <Fragment set:html={readingTime} />
+</span>