@hgdc/docs 0.1.0 → 0.2.0

package/docs.schema.json

@@ -23,6 +23,10 @@
       "type": "string",
       "enum": ["fr", "en", "de", "it"]
     },
+    "base": {
+      "type": "string",
+      "pattern": "^(?:\\/[a-z0-9][a-z0-9_-]*)+$"
+    },
     "colors": {
       "type": "object",
       "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hgdc/docs",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Modèle de site de HGDC Docs : documentation MDX (docs.json) construite avec Astro Starlight, recherche, versions, llms.txt et assistant.",
   "license": "UNLICENSED",
   "type": "module",
@@ -11,7 +11,8 @@
     "bin",
     "src",
     "template",
-    "docs.schema.json"
+    "docs.schema.json",
+    "!src/**/*.test.ts"
   ],
   "exports": {
     "./core/*": "./src/core/*.ts",

package/src/build/base-links.ts

@@ -0,0 +1,35 @@
+import type { Root } from "mdast"
+
+import { withBase } from "../core/navigation.ts"
+
+type Node = { type: string; url?: unknown; attributes?: unknown; children?: Array<Node> }
+type Attribute = { type: string; name?: string; value?: unknown }
+
+/** Attributs JSX qui portent une adresse : `<Card href>`, `<img src>`, `<a href>`, `<video poster>`. */
+const URL_ATTRIBUTES = new Set(["href", "src", "poster"])
+
+/**
+ * Site servi sous un sous-chemin (`base: "/docs"`) : les liens et médias écrits depuis la
+ * racine du site (`/guides/publier/`, `/images/x.png`) reçoivent le sous-chemin, dans le
+ * Markdown (`[…](/…)`, `![…](/…)`, définitions) comme dans les composants MDX. Le rédacteur
+ * écrit ses liens comme pour un site à la racine ; la doc reste déplaçable.
+ */
+export function remarkBaseLinks(options: { base: string }) {
+  const { base } = options
+  return (tree: Root) => {
+    if (!base) return
+    const walk = (node: Node) => {
+      if (typeof node.url === "string") node.url = withBase(base, node.url)
+      // Les directives (`:::note{…}`) portent un objet d'attributs : seuls ceux de JSX nous intéressent.
+      for (const attribute of Array.isArray(node.attributes) ? (node.attributes as Array<Attribute>) : [])
+        if (
+          attribute.type === "mdxJsxAttribute" &&
+          URL_ATTRIBUTES.has(attribute.name ?? "") &&
+          typeof attribute.value === "string"
+        )
+          attribute.value = withBase(base, attribute.value)
+      for (const child of node.children ?? []) walk(child)
+    }
+    walk(tree as unknown as Node)
+  }
+}

package/src/build/outputs.ts

@@ -10,10 +10,18 @@ import { unified } from "unified"
 import type { DocsConfig } from "../core/config.ts"
 import { CORPUS_FORMAT, CORPUS_PATH, MAX_PAGE_CHARS, type Corpus } from "../core/corpus.ts"
 import { llmsFullTxt, llmsTxt, markdownPath, type LlmsPage } from "../core/llms.ts"
-import { allPages, locatePage, pageToPath, type NavTree } from "../core/navigation.ts"
+import { allPages, locatePage, pageToPath, withBase, type NavTree } from "../core/navigation.ts"
 import { htmlToMarkdown } from "./markdown.ts"
 
-type Input = { outDir: string; pathnames: Array<string>; config: DocsConfig; tree: NavTree; site: string | null }
+type Input = {
+  outDir: string
+  pathnames: Array<string>
+  config: DocsConfig
+  tree: NavTree
+  site: string | null
+  /** Sous-chemin du site (`/docs`) : porté par les chemins publiés, pas par les fichiers écrits ici. */
+  base?: string
+}
 
 /** `guides/publier/` (pathname d'Astro) → `/guides/publier/`. */
 const normalize = (pathname: string) => `/${pathname}`.replace(/\/+/g, "/").replace(/([^/])$/, "$1/")
@@ -24,6 +32,7 @@ const normalize = (pathname: string) => `/${pathname}`.replace(/\/+/g, "/").repl
  * navigation y entrent : une page hors navigation n'est pas annoncée aux agents.
  */
 export async function writeMachineReadable(input: Input): Promise<{ pages: number }> {
+  const base = input.base ?? ""
   const byPath = new Map(allPages(input.tree).map((page) => [pageToPath(page), page]))
   const pages = new Map<string, LlmsPage>()
   const corpusPages: Corpus["pages"] = []
@@ -45,7 +54,7 @@ export async function writeMachineReadable(input: Input): Promise<{ pages: numbe
     pages.set(page, entry)
     await write(input.outDir, markdownPath(path), `# ${title}\n\n${markdown}\n`)
     corpusPages.push({
-      path,
+      path: withBase(base, path),
       title,
       description: entry.description,
       version: locatePage(input.tree, page)?.version.id ?? null,
@@ -57,6 +66,7 @@ export async function writeMachineReadable(input: Input): Promise<{ pages: numbe
     name: input.config.name,
     description: input.config.description ?? null,
     site: input.site,
+    base,
     tree: input.tree,
     pages,
   }
@@ -75,7 +85,7 @@ export async function writeMachineReadable(input: Input): Promise<{ pages: numbe
     builtAt: new Date().toISOString(),
     theme: {
       primary: input.config.colors?.primary ?? null,
-      logo: typeof logo === "string" ? logo : (logo?.light ?? null),
+      logo: withLogoBase(base, typeof logo === "string" ? logo : (logo?.light ?? null)),
     },
     versions: input.tree.versions.map(({ id, label, isDefault }) => ({ id, label, isDefault })),
     pages: corpusPages,
@@ -84,6 +94,9 @@ export async function writeMachineReadable(input: Input): Promise<{ pages: numbe
   return { pages: pages.size }
 }
 
+const withLogoBase = (base: string, logo: string | null) =>
+  logo ? withBase(base, logo.startsWith("/") || logo.includes("://") ? logo : `/${logo}`) : null
+
 async function write(outDir: string, path: string, content: string): Promise<void> {
   const target = join(outDir, path)
   await mkdir(dirname(target), { recursive: true })

package/src/core/config.ts

@@ -16,6 +16,8 @@ const PAGE = /^(?!\/)(?!.*\.\.)[a-z0-9][a-z0-9/_-]*$/i
 const PROJECT_ID_PATTERN = /^[a-z0-9]{8,64}$/
 
 const hex = z.string().regex(HEX, "couleur attendue au format #rrggbb")
+/** Sous-chemin du site (`/docs`) : un ou plusieurs segments, sans « / » final. */
+const BASE = /^(?:\/[a-z0-9][a-z0-9_-]*)+$/i
 
 export type NavPageRef = string
 export type NavGroupInput = { group: string; pages: Array<NavPageRef | NavGroupInput>; expanded?: boolean }
@@ -64,6 +66,12 @@ export const docsConfigSchema = z.object({
     .regex(PROJECT_ID_PATTERN, "identifiant de projet attendu, copié depuis la console docs.hgdc.ch")
     .optional(),
   language: z.enum(["fr", "en", "de", "it"]).default("fr"),
+  /**
+   * Sous-chemin où la doc est servie, quand un produit la publie derrière un proxy
+   * (`https://app.exemple.ch/docs`). Liens, médias, recherche, `llms.txt` et pages `.md`
+   * le portent ; le site est écrit dans `dist/<base>/`.
+   */
+  base: z.string().regex(BASE, "sous-chemin attendu, sans « / » final (ex. /docs)").optional(),
   colors: z.object({ primary: hex, light: hex.optional(), dark: hex.optional() }).optional(),
   logo: logo.optional(),
   favicon: z.string().optional(),

package/src/core/llms.ts

@@ -1,5 +1,5 @@
 import type { NavItem, NavTree } from "./navigation.ts"
-import { pagesOf as pagesIn, pageToPath } from "./navigation.ts"
+import { pagesOf as pagesIn, pageToPath, withBase } from "./navigation.ts"
 
 /**
  * `llms.txt` et `llms-full.txt` au format de llmstxt.org : un H1, un résumé en citation,
@@ -12,6 +12,8 @@ export type LlmsInput = {
   name: string
   description: string | null
   site: string | null
+  /** Sous-chemin du site (`/docs`), `""` ou absent à la racine. */
+  base?: string
   tree: NavTree
   pages: ReadonlyMap<string, LlmsPage>
 }
@@ -22,14 +24,15 @@ export function markdownPath(path: string): string {
   return trimmed ? `${trimmed}.md` : "/index.md"
 }
 
-function url(site: string | null, path: string): string {
-  return site ? new URL(path, site).toString() : path
+function url(input: Pick<LlmsInput, "site" | "base">, path: string): string {
+  const full = withBase(input.base ?? "", path)
+  return input.site ? new URL(full, input.site).toString() : full
 }
 
 function link(input: LlmsInput, page: string): string | null {
   const data = input.pages.get(page)
   if (!data) return null
-  const target = url(input.site, markdownPath(pageToPath(page)))
+  const target = url(input, markdownPath(pageToPath(page)))
   return `- [${data.title}](${target})${data.description ? `: ${data.description}` : ""}`
 }
 
@@ -89,7 +92,7 @@ export function llmsFullTxt(input: LlmsInput, order: Array<string>): string {
   for (const page of order) {
     const data = input.pages.get(page)
     if (!data) continue
-    parts.push(`\n---\n\nSource : ${url(input.site, pageToPath(page))}\n\n# ${data.title}\n\n${data.markdown.trim()}`)
+    parts.push(`\n---\n\nSource : ${url(input, pageToPath(page))}\n\n# ${data.title}\n\n${data.markdown.trim()}`)
   }
   return `${parts.join("\n").trim()}\n`
 }

package/src/core/navigation.ts

@@ -82,6 +82,30 @@ export function pageToPath(page: string): string {
   return slug ? `/${slug}/` : "/"
 }
 
+/** Sous-chemin du site tel que docs.json le déclare, ou `""` pour un site à la racine. */
+export function siteBase(config: Pick<DocsConfig, "base">): string {
+  return config.base ? config.base.replace(/\/+$/, "") : ""
+}
+
+/**
+ * Chemin public d'un chemin du site : `/guides/publier/` → `/docs/guides/publier/` sous
+ * `base: "/docs"`. Un chemin qui porte déjà le sous-chemin, ou qui n'est pas absolu
+ * (`#ancre`, `https://…`, `//hôte`), reste tel quel.
+ */
+export function withBase(base: string, path: string): string {
+  if (!base || !path.startsWith("/") || path.startsWith("//")) return path
+  if (path === base || path.startsWith(`${base}/`) || path.startsWith(`${base}#`) || path.startsWith(`${base}?`))
+    return path
+  return `${base}${path}`
+}
+
+/** Chemin du site sans son sous-chemin : `/docs/guides/` → `/guides/`, `/docs/` → `/`. */
+export function withoutBase(base: string, pathname: string): string {
+  if (!base) return pathname
+  if (pathname === base) return "/"
+  return pathname.startsWith(`${base}/`) ? pathname.slice(base.length) : pathname
+}
+
 /** Pages citées dans la navigation mais absentes du dossier : erreur de build lisible. */
 export function missingPages(tree: NavTree, existing: ReadonlySet<string>): Array<string> {
   return [...new Set(allPages(tree))].filter((page) => !existing.has(pageToSlug(page)))

package/src/integration.ts

@@ -1,4 +1,4 @@
-import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync } from "node:fs"
+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from "node:fs"
 import { dirname, join, relative, resolve } from "node:path"
 import { fileURLToPath } from "node:url"
 
@@ -7,10 +7,18 @@ import starlight from "@astrojs/starlight"
 import type { AstroIntegration, AstroUserConfig } from "astro"
 
 import { remarkAutoImport } from "./build/auto-import.ts"
+import { remarkBaseLinks } from "./build/base-links.ts"
 import { publicFiles } from "./build/public-files.ts"
 import { writeMachineReadable } from "./build/outputs.ts"
 import { parseDocsConfig, withHostProject, type DocsConfig } from "./core/config.ts"
-import { missingPages, normalizeNavigation, pageToSlug, type NavItem, type NavTree } from "./core/navigation.ts"
+import {
+  missingPages,
+  normalizeNavigation,
+  pageToSlug,
+  siteBase,
+  type NavItem,
+  type NavTree,
+} from "./core/navigation.ts"
 import { themeCss, themeFor } from "./core/theme.ts"
 
 /** Où lire la doc du client et où écrire le site : posé par la CLI `hgdc-docs`. */
@@ -35,12 +43,27 @@ export function readSiteOptions(env: NodeJS.ProcessEnv = process.env): SiteOptio
   return {
     contentDir,
     outDir: resolve(env.HGDC_DOCS_OUT ?? join(contentDir, "dist")),
-    site: env.HGDC_DOCS_SITE ?? vercelUrl,
+    site: siteOrigin(env.HGDC_DOCS_SITE ?? vercelUrl),
     apiEndpoint: env.HGDC_DOCS_API ?? DEFAULT_API,
     project: env.HGDC_DOCS_PROJECT ?? null,
   }
 }
 
+/**
+ * Origine du site seulement : le sous-chemin vient de `base` dans docs.json, pas de
+ * l'adresse (`https://app.ch/docs` et `https://app.ch` donnent le même site).
+ */
+function siteOrigin(value: string | null): string | null {
+  if (!value) return null
+  try {
+    return new URL(value).origin
+  } catch {
+    throw new DocsConfigError(
+      `HGDC_DOCS_SITE : adresse invalide (${value.slice(0, 100)}). Exemple : https://docs.exemple.ch`,
+    )
+  }
+}
+
 export class DocsConfigError extends Error {}
 
 export function loadDocsConfig(contentDir: string, hostProject: string | null = null): DocsConfig {
@@ -58,6 +81,8 @@ export type VirtualConfig = {
   tree: NavTree
   apiEndpoint: string
   site: string | null
+  /** Sous-chemin du site (`/docs`), `""` à la racine. */
+  base: string
 }
 
 const IGNORED_DIRS = new Set(["node_modules", "dist", ".hgdc-docs", ".git", ".github", ".vercel"])
@@ -144,6 +169,10 @@ function virtualConfigPlugin(data: VirtualConfig) {
   }
 }
 
+/** Site sous un sous-chemin : la racine renvoie vers la doc, pour une visite directe de l'hôte. */
+const rootRedirect = (base: string) =>
+  `<!doctype html><meta charset="utf-8"><meta name="robots" content="noindex"><meta http-equiv="refresh" content="0; url=${base}/"><link rel="canonical" href="${base}/"><a href="${base}/">Documentation</a>\n`
+
 function machineReadableOutputs(data: VirtualConfig, options: SiteOptions): AstroIntegration {
   return {
     name: "hgdc-docs-outputs",
@@ -155,12 +184,17 @@ function machineReadableOutputs(data: VirtualConfig, options: SiteOptions): Astr
           config: data.config,
           tree: data.tree,
           site: options.site,
+          base: data.base,
         })
         logger.info(`llms.txt, llms-full.txt, ${written.pages} pages Markdown et le corpus de l'assistant écrits.`)
         // Le build tourne dans le paquet, où ses dépendances se résolvent quel que soit le
         // gestionnaire du client (npm, pnpm, bun isolé), puis le site seul est copié chez lui.
+        // Sous un sous-chemin, le site va dans `dist/<base>/` : servi tel quel par Host, il
+        // répond aux mêmes adresses que derrière le proxy du produit (`/docs/_astro/…`).
         rmSync(options.outDir, { recursive: true, force: true })
-        cpSync(fileURLToPath(dir), options.outDir, { recursive: true, filter: (path) => !path.includes(".prerender") })
+        const target = join(options.outDir, ...data.base.split("/").filter(Boolean))
+        cpSync(fileURLToPath(dir), target, { recursive: true, filter: (path) => !path.includes(".prerender") })
+        if (data.base) writeFileSync(join(options.outDir, "index.html"), rootRedirect(data.base))
         logger.info(`Site écrit dans ${options.outDir}`)
       },
     },
@@ -176,7 +210,8 @@ export function createAstroConfig(options: SiteOptions = readSiteOptions()): Ast
     throw new DocsConfigError(
       `docs.json cite des pages absentes du dossier :\n- ${missing.map((page) => `${page}.mdx`).join("\n- ")}`,
     )
-  const data: VirtualConfig = { config, tree, apiEndpoint: options.apiEndpoint, site: options.site }
+  const base = siteBase(config)
+  const data: VirtualConfig = { config, tree, apiEndpoint: options.apiEndpoint, site: options.site, base }
   const theme = themeFor(config.colors?.primary, config.colors?.dark)
   const logo = typeof config.logo === "string" ? { light: config.logo } : config.logo
   const asset = (path: string) => join(options.contentDir, path.replace(/^\//, ""))
@@ -194,8 +229,9 @@ export function createAstroConfig(options: SiteOptions = readSiteOptions()): Ast
     outDir: file("../template/.build"),
     cacheDir: join(options.contentDir, ".hgdc-docs", "cache"),
     site: options.site ?? undefined,
+    ...(base ? { base } : {}),
     trailingSlash: "always",
-    markdown: { processor: unified({ remarkPlugins: [remarkAutoImport] }) },
+    markdown: { processor: unified({ remarkPlugins: [remarkAutoImport, [remarkBaseLinks, { base }]] }) },
     vite: {
       plugins: [virtualConfigPlugin(data)],
       server: { fs: { allow: [options.contentDir, file("..")] } },

package/src/overrides/Head.astro

@@ -1,12 +1,14 @@
----
-import Default from "@astrojs/starlight/components/Head.astro"
-
-import { markdownPath } from "../core/llms.ts"
-
-// llmstxt.org : chaque page annonce sa version Markdown et l'index qui la décrit.
-const markdown = markdownPath(Astro.url.pathname)
----
-
-<Default><slot /></Default>
-<link rel="alternate" type="text/markdown" href={markdown} />
-<link rel="describedby" type="text/markdown" href="/llms.txt" />
+---
+import Default from "@astrojs/starlight/components/Head.astro"
+import data from "virtual:hgdc-docs/config"
+
+import { markdownPath } from "../core/llms.ts"
+import { withBase, withoutBase } from "../core/navigation.ts"
+
+// llmstxt.org : chaque page annonce sa version Markdown et l'index qui la décrit.
+const markdown = withBase(data.base, markdownPath(withoutBase(data.base, Astro.url.pathname)))
+---
+
+<Default><slot /></Default>
+<link rel="alternate" type="text/markdown" href={markdown} />
+<link rel="describedby" type="text/markdown" href={withBase(data.base, "/llms.txt")} />

package/src/overrides/PageTitle.astro

@@ -1,94 +1,95 @@
----
-import Default from "@astrojs/starlight/components/PageTitle.astro"
-import data from "virtual:hgdc-docs/config"
-
-import { markdownPath } from "../core/llms.ts"
-
-const markdown = markdownPath(Astro.url.pathname)
-const assistant = Boolean(data.config.project) && data.config.assistant?.enabled !== false
----
-
-<div class="hgdc-title">
-  <Default><slot /></Default>
-  <div class="hgdc-page-actions not-content" data-hgdc-skip data-pagefind-ignore>
-    <button type="button" class="hgdc-action" data-hgdc-copy={markdown}>
-      <svg aria-hidden="true" viewBox="0 0 24 24" width="16" height="16"
-        ><rect x="8" y="8" width="12" height="12" rx="3" fill="none" stroke="currentColor" stroke-width="1.8"
-        ></rect><path d="M16 8V6a2 2 0 0 0-2-2H6a2 2 0 0 0-2 2v8a2 2 0 0 0 2 2h2" fill="none" stroke="currentColor" stroke-width="1.8"
-        ></path></svg
-      >
-      <span data-label>Copier pour un LLM</span>
-    </button>
-    <details class="hgdc-menu">
-      <summary class="hgdc-action hgdc-action--icon" aria-label="Autres formats de la page">
-        <svg aria-hidden="true" viewBox="0 0 24 24" width="16" height="16"
-          ><path d="m6 9 6 6 6-6" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"></path></svg
-        >
-      </summary>
-      <ul class="hgdc-menu__list">
-        <li><a href={markdown}>Voir en Markdown</a></li>
-        <li><a data-hgdc-open="claude" href="https://claude.ai/new" target="_blank" rel="noopener">Ouvrir dans Claude</a></li>
-        <li><a data-hgdc-open="chatgpt" href="https://chatgpt.com/" target="_blank" rel="noopener">Ouvrir dans ChatGPT</a></li>
-        <li><a href="/llms.txt">Index pour les agents (llms.txt)</a></li>
-      </ul>
-    </details>
-    {
-      assistant && (
-        <button type="button" class="hgdc-action" data-hgdc-ask>
-          <svg aria-hidden="true" viewBox="0 0 24 24" width="16" height="16">
-            <path d="M12 3l1.9 4.6L18.5 9.5l-4.6 1.9L12 16l-1.9-4.6L5.5 9.5l4.6-1.9z" fill="currentColor" />
-          </svg>
-          <span>Demander à l'assistant</span>
-        </button>
-      )
-    }
-    <span class="sr-only" role="status" aria-live="polite" data-hgdc-copy-status></span>
-  </div>
-</div>
-
-<script>
-  const status = document.querySelector<HTMLElement>("[data-hgdc-copy-status]")
-
-  for (const button of document.querySelectorAll<HTMLButtonElement>("[data-hgdc-copy]")) {
-    const label = button.querySelector<HTMLElement>("[data-label]")!
-    button.addEventListener("click", async () => {
-      const done = (text: string) => {
-        label.textContent = text
-        if (status) status.textContent = text
-        setTimeout(() => (label.textContent = "Copier pour un LLM"), 2000)
-      }
-      try {
-        const response = await fetch(button.dataset.hgdcCopy!)
-        if (!response.ok) throw new Error(String(response.status))
-        await navigator.clipboard.writeText(await response.text())
-        done("Page copiée")
-      } catch {
-        done("Copie impossible")
-      }
-    })
-  }
-
-  // « Ouvrir dans… » : l'assistant externe lit la version Markdown de cette page.
-  const markdownUrl = new URL(document.querySelector<HTMLElement>("[data-hgdc-copy]")!.dataset.hgdcCopy!, location.href)
-  const prompt = `Lis ${markdownUrl.href} et réponds à mes questions sur cette page.`
-  for (const link of document.querySelectorAll<HTMLAnchorElement>("[data-hgdc-open]")) {
-    const base = link.dataset.hgdcOpen === "claude" ? "https://claude.ai/new" : "https://chatgpt.com/"
-    link.href = `${base}?q=${encodeURIComponent(prompt)}`
-  }
-
-  // Le menu se ferme au clic extérieur et à Échap, comme un menu natif.
-  for (const menu of document.querySelectorAll<HTMLDetailsElement>(".hgdc-menu")) {
-    document.addEventListener("click", (event) => {
-      if (menu.open && !menu.contains(event.target as Node)) menu.open = false
-    })
-    menu.addEventListener("keydown", (event) => {
-      if (event.key === "Escape" && menu.open) {
-        menu.open = false
-        menu.querySelector("summary")?.focus()
-      }
-    })
-  }
-
-  for (const button of document.querySelectorAll("[data-hgdc-ask]"))
-    button.addEventListener("click", () => document.dispatchEvent(new CustomEvent("hgdc:assistant-open")))
-</script>
+---
+import Default from "@astrojs/starlight/components/PageTitle.astro"
+import data from "virtual:hgdc-docs/config"
+
+import { markdownPath } from "../core/llms.ts"
+import { withBase, withoutBase } from "../core/navigation.ts"
+
+const markdown = withBase(data.base, markdownPath(withoutBase(data.base, Astro.url.pathname)))
+const assistant = Boolean(data.config.project) && data.config.assistant?.enabled !== false
+---
+
+<div class="hgdc-title">
+  <Default><slot /></Default>
+  <div class="hgdc-page-actions not-content" data-hgdc-skip data-pagefind-ignore>
+    <button type="button" class="hgdc-action" data-hgdc-copy={markdown}>
+      <svg aria-hidden="true" viewBox="0 0 24 24" width="16" height="16"
+        ><rect x="8" y="8" width="12" height="12" rx="3" fill="none" stroke="currentColor" stroke-width="1.8"
+        ></rect><path d="M16 8V6a2 2 0 0 0-2-2H6a2 2 0 0 0-2 2v8a2 2 0 0 0 2 2h2" fill="none" stroke="currentColor" stroke-width="1.8"
+        ></path></svg
+      >
+      <span data-label>Copier pour un LLM</span>
+    </button>
+    <details class="hgdc-menu">
+      <summary class="hgdc-action hgdc-action--icon" aria-label="Autres formats de la page">
+        <svg aria-hidden="true" viewBox="0 0 24 24" width="16" height="16"
+          ><path d="m6 9 6 6 6-6" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"></path></svg
+        >
+      </summary>
+      <ul class="hgdc-menu__list">
+        <li><a href={markdown}>Voir en Markdown</a></li>
+        <li><a data-hgdc-open="claude" href="https://claude.ai/new" target="_blank" rel="noopener">Ouvrir dans Claude</a></li>
+        <li><a data-hgdc-open="chatgpt" href="https://chatgpt.com/" target="_blank" rel="noopener">Ouvrir dans ChatGPT</a></li>
+        <li><a href={withBase(data.base, "/llms.txt")}>Index pour les agents (llms.txt)</a></li>
+      </ul>
+    </details>
+    {
+      assistant && (
+        <button type="button" class="hgdc-action" data-hgdc-ask>
+          <svg aria-hidden="true" viewBox="0 0 24 24" width="16" height="16">
+            <path d="M12 3l1.9 4.6L18.5 9.5l-4.6 1.9L12 16l-1.9-4.6L5.5 9.5l4.6-1.9z" fill="currentColor" />
+          </svg>
+          <span>Demander à l'assistant</span>
+        </button>
+      )
+    }
+    <span class="sr-only" role="status" aria-live="polite" data-hgdc-copy-status></span>
+  </div>
+</div>
+
+<script>
+  const status = document.querySelector<HTMLElement>("[data-hgdc-copy-status]")
+
+  for (const button of document.querySelectorAll<HTMLButtonElement>("[data-hgdc-copy]")) {
+    const label = button.querySelector<HTMLElement>("[data-label]")!
+    button.addEventListener("click", async () => {
+      const done = (text: string) => {
+        label.textContent = text
+        if (status) status.textContent = text
+        setTimeout(() => (label.textContent = "Copier pour un LLM"), 2000)
+      }
+      try {
+        const response = await fetch(button.dataset.hgdcCopy!)
+        if (!response.ok) throw new Error(String(response.status))
+        await navigator.clipboard.writeText(await response.text())
+        done("Page copiée")
+      } catch {
+        done("Copie impossible")
+      }
+    })
+  }
+
+  // « Ouvrir dans… » : l'assistant externe lit la version Markdown de cette page.
+  const markdownUrl = new URL(document.querySelector<HTMLElement>("[data-hgdc-copy]")!.dataset.hgdcCopy!, location.href)
+  const prompt = `Lis ${markdownUrl.href} et réponds à mes questions sur cette page.`
+  for (const link of document.querySelectorAll<HTMLAnchorElement>("[data-hgdc-open]")) {
+    const base = link.dataset.hgdcOpen === "claude" ? "https://claude.ai/new" : "https://chatgpt.com/"
+    link.href = `${base}?q=${encodeURIComponent(prompt)}`
+  }
+
+  // Le menu se ferme au clic extérieur et à Échap, comme un menu natif.
+  for (const menu of document.querySelectorAll<HTMLDetailsElement>(".hgdc-menu")) {
+    document.addEventListener("click", (event) => {
+      if (menu.open && !menu.contains(event.target as Node)) menu.open = false
+    })
+    menu.addEventListener("keydown", (event) => {
+      if (event.key === "Escape" && menu.open) {
+        menu.open = false
+        menu.querySelector("summary")?.focus()
+      }
+    })
+  }
+
+  for (const button of document.querySelectorAll("[data-hgdc-ask]"))
+    button.addEventListener("click", () => document.dispatchEvent(new CustomEvent("hgdc:assistant-open")))
+</script>