living-documentation 7.1.0 → 7.3.0

package/README.md

@@ -31,6 +31,7 @@ ExtraFiles (added in the admin section) are always first, always expanded in a `
 
 - **Inline editing** — edit any document directly in the browser, saves to disk instantly
 - **Image paste** — paste an image from clipboard in the editor; auto-uploaded and inserted as Markdown
+- **File attachments** — drag & drop, paste or pick any non-image file (PDF, archives, office docs…) in the editor; uploaded under `DOCS_FOLDER/files/` and inserted as a paperclip link. Blocked extensions and size limits are configurable from the Admin panel.
 - **Snippet inserter** — click **🧩 Snippets** while editing to insert pre-built Markdown constructs at the cursor position:
   - *Simple snippets*: collapsible block (`<details>`), link, link to another document, anchor link, anchor link in another document, numbered list (3 levels), bullet list (3 levels), code block, blockquote, horizontal separator, image
   - *Complex snippets*: **table editor** (dynamic rows/columns grid, generates aligned Markdown table) and **tree editor** (indentation-based ASCII tree, generates a `text` code block with `├──` / `└──` connectors)
@@ -211,22 +212,42 @@ Use the Admin panel's **General — Extra Files** section to browse the filesyst
 ```
 living-documentation/
 ├── bin/
-│   └── cli.ts              CLI entry point
+│   └── cli.ts                  CLI entry point (Commander)
 ├── src/
-│   ├── server.ts            Express app
+│   ├── server.ts                Express app (mounts routes + static frontend)
 │   ├── routes/
-│   │   ├── documents.ts     Documents API (list, search, read, write)
-│   │   ├── config.ts        Config API
-│   │   ├── browse.ts        Filesystem browser API
-│   │   └── images.ts        Image upload API
+│   │   ├── documents.ts         Documents API (list, search, read, write, create, delete)
+│   │   ├── config.ts            Config API
+│   │   ├── browse.ts            Filesystem browser API (+ mkdir)
+│   │   ├── images.ts            Image upload API
+│   │   ├── files.ts             File attachment upload API (paperclip)
+│   │   ├── wordcloud.ts         Word cloud raw text reader
+│   │   ├── diagrams.ts          Diagrams CRUD API (vis-network JSON)
+│   │   ├── annotations.ts       Per-document highlight markers API
+│   │   └── export.ts            HTML export (PDF, Notion, Confluence zip)
+│   ├── mcp/
+│   │   ├── server.ts            Model Context Protocol server (Streamable HTTP)
+│   │   └── tools/
+│   │       ├── documents.ts     MCP tools: list/read/create document
+│   │       ├── diagrams.ts      MCP tools: list/read/create diagram
+│   │       └── source.ts        MCP tools: list/read/search source files
 │   ├── lib/
-│   │   ├── parser.ts        Filename parser
-│   │   └── config.ts        Config management
+│   │   ├── parser.ts            Filename parser
+│   │   └── config.ts            Config management (.living-doc.json)
 │   └── frontend/
-│       ├── index.html       Main viewer
-│       └── admin.html       Admin panel
+│       ├── index.html           Main viewer shell
+│       ├── admin.html           Admin panel
+│       ├── diagram.html         Diagram editor shell
+│       ├── i18n.js              i18n loader (window.t + data-i18n binding)
+│       ├── i18n/{en,fr}.json    Translation catalogs
+│       ├── wordcloud.js         Word cloud logic
+│       ├── vendor/              Vendored browser libraries (wordcloud2.js)
+│       ├── *.js                 Viewer modules (state, sidebar, search, documents, …)
+│       └── diagram/*.js         Diagram editor modules (network, panels, history, …)
 ├── scripts/
-│   └── copy-assets.js       Build helper (copies HTML to dist/)
+│   └── copy-assets.ts           Build helper (copies frontend + starting-doc to dist/)
+├── starting-doc/                Sample docs shipped with the npm package
+├── documentation/adrs/          Architecture Decision Records for this project
 ├── package.json
 └── tsconfig.json
 ```
@@ -235,16 +256,34 @@ living-documentation/
 
 ## API reference
 
-| Method | Endpoint                   | Description                                                        |
-| ------ | -------------------------- | ------------------------------------------------------------------ |
-| `GET`  | `/api/documents`           | List all documents with metadata (includes extra files)            |
-| `GET`  | `/api/documents/:id`       | Get document content + rendered HTML                               |
-| `PUT`  | `/api/documents/:id`       | Save document content to disk                                      |
-| `GET`  | `/api/documents/search?q=` | Full-text search                                                   |
-| `GET`  | `/api/config`              | Read config                                                        |
-| `PUT`  | `/api/config`              | Update config (`title`, `theme`, `filenamePattern`, `extraFiles`)  |
-| `GET`  | `/api/browse?path=`        | List directories and `.md` files at a given filesystem path        |
-| `POST` | `/api/images/upload`       | Upload a base64 image; saved to `DOCS_FOLDER/images/`             |
+| Method   | Endpoint                       | Description                                                        |
+| -------- | ------------------------------ | ------------------------------------------------------------------ |
+| `GET`    | `/api/documents`               | List all documents with metadata (includes extra files)            |
+| `GET`    | `/api/documents/:id`           | Get document content + rendered HTML                               |
+| `POST`   | `/api/documents`               | Create a new document from `{ title, category, folder?, content? }` |
+| `PUT`    | `/api/documents/:id`           | Save document content to disk                                      |
+| `DELETE` | `/api/documents/:id`           | Delete a document                                                  |
+| `GET`    | `/api/documents/search?q=`     | Full-text search                                                   |
+| `GET`    | `/api/config`                  | Read config                                                        |
+| `PUT`    | `/api/config`                  | Update config (`title`, `theme`, `filenamePattern`, `extraFiles`, `showDiagramDebug`, `sourceRoot`, `blockedFileExtensions`) |
+| `GET`    | `/api/browse?path=`            | List directories and `.md` files at a given filesystem path        |
+| `GET`    | `/api/browse/alldirs?path=`    | List directories recursively (for the folder picker)               |
+| `POST`   | `/api/browse/mkdir`            | Create a new folder under the docs root                            |
+| `POST`   | `/api/images/upload`           | Upload a base64 image; saved to `DOCS_FOLDER/images/`              |
+| `POST`   | `/api/files/upload`            | Upload a base64 file attachment; saved to `DOCS_FOLDER/files/`     |
+| `GET`    | `/api/diagrams`                | List saved diagrams                                                |
+| `GET`    | `/api/diagrams/:id`            | Read a single diagram (nodes + edges)                              |
+| `PUT`    | `/api/diagrams/:id`            | Create or update a diagram                                         |
+| `DELETE` | `/api/diagrams/:id`            | Delete a diagram                                                   |
+| `GET`    | `/api/annotations`             | List annotations for all documents                                 |
+| `GET`    | `/api/annotations/:docId`      | List annotations for one document                                  |
+| `POST`   | `/api/annotations/:docId`      | Add an annotation                                                  |
+| `DELETE` | `/api/annotations/:docId/:id`  | Delete one annotation                                              |
+| `POST`   | `/api/export/html`             | Export a document (or a zip bundle) as HTML — Notion / Confluence modes |
+| `POST`   | `/api/export/markdown`         | Export documents as a Markdown bundle                              |
+| `GET`    | `/api/wordcloud?path=&ext=`    | Recursively concatenate matching files as raw text                 |
+| `POST`   | `/mcp`                         | Model Context Protocol endpoint (Streamable HTTP)                  |
+| `GET`    | `/mcp`                         | Summary of available MCP tools and prompts                         |
 
 ---
 
@@ -268,11 +307,18 @@ A `GET http://localhost:4321/mcp` returns a JSON summary of available tools for
 
 | Tool | Description |
 |---|---|
+| `get_server_guide` | Return the server guide (purpose, workflow, diagram conventions, coordinate system) |
 | `list_documents` | List all documents with their id, title, category and folder |
 | `read_document` | Read the raw Markdown content of a document by its id |
 | `create_document` | Create a new Markdown document (filename generated from the configured pattern) |
 | `list_diagrams` | List all saved diagrams with their id and title |
-| `create_diagram` | Create a diagram from nodes and edges (shapes, colors, labels) |
+| `read_diagram` | Read the nodes and edges of a diagram (same shape as `create_diagram` input) |
+| `create_diagram` | Create or overwrite a diagram from nodes and edges (shapes, colors, labels) |
+| `list_source_files` | List project source files under `sourceRoot` (fallback only) |
+| `read_source_file` | Read a source file under `sourceRoot` (fallback only) |
+| `search_source` | Grep-like text search across files under `sourceRoot` |
+
+Prompts (`generate-context-diagram`, `generate-container-diagram`, `generate-uml-diagram`, `update-diagram-from-docs`, `generate-screen-guide`, `flow`, `erd`) are exposed alongside the tools for clients that surface MCP prompts to the user.
 
 ### Installation — Claude Desktop
 

package/dist/src/frontend/admin.html

@@ -316,6 +316,35 @@
           </div>
         </div>
 
+        <!-- ── File Attachments (full width) ── -->
+        <div
+          class="mt-8 rounded-xl border border-gray-200 dark:border-gray-800 bg-white dark:bg-gray-900 p-5 space-y-3"
+        >
+          <div>
+            <h3 class="text-sm font-semibold text-gray-700 dark:text-gray-300">
+              <span data-i18n="admin.files.title">File Attachments</span>
+            </h3>
+            <p class="mt-1 text-xs text-gray-500 dark:text-gray-400" data-i18n="admin.files.description">
+              Extensions that are rejected by the <code>/api/files/upload</code> endpoint. One extension per line (or comma/space separated), without the leading dot.
+            </p>
+          </div>
+          <label
+            class="block text-xs font-medium text-gray-500 dark:text-gray-400"
+            for="field-blocked-extensions"
+            data-i18n="admin.files.blocked_label"
+          >Blocked extensions</label>
+          <textarea
+            id="field-blocked-extensions"
+            name="blockedFileExtensions"
+            rows="3"
+            class="w-full px-3 py-2 font-mono text-xs rounded-lg border border-gray-300 dark:border-gray-600 bg-gray-50 dark:bg-gray-800 text-gray-900 dark:text-gray-100 placeholder:text-gray-400 dark:placeholder:text-gray-500 focus:outline-none focus:ring-2 focus:ring-blue-500"
+            placeholder="exe sh bat cmd com scr ps1 msi"
+          ></textarea>
+          <p class="text-xs text-gray-400 dark:text-gray-500" data-i18n="admin.files.hint">
+            Defaults to common executable formats. Max upload size is 19 MB per file.
+          </p>
+        </div>
+
         <!-- ── Diagram Palettes (full width) ── -->
         <div
           class="mt-8 rounded-xl border border-gray-200 dark:border-gray-800 bg-white dark:bg-gray-900 divide-y divide-gray-100 dark:divide-gray-800"
@@ -497,6 +526,8 @@
             cfg.filenamePattern || "";
           document.getElementById("field-debug").checked =
             !!cfg.showDiagramDebug;
+          document.getElementById("field-blocked-extensions").value =
+            (cfg.blockedFileExtensions || []).join(" ");
           updatePreview(cfg.filenamePattern);
           initExtraFiles(cfg);
           initPalettes(cfg);
@@ -525,6 +556,12 @@
         const sourceRootRaw = document
           .getElementById("field-source-root")
           .value.trim();
+        const blockedExtensions = document
+          .getElementById("field-blocked-extensions")
+          .value
+          .split(/[\s,]+/)
+          .map((e) => e.trim().replace(/^\.+/, "").toLowerCase())
+          .filter((e) => /^[a-z0-9]+$/.test(e));
         const payload = {
           title: document.getElementById("field-title").value.trim(),
           theme: document.getElementById("field-theme").value,
@@ -534,6 +571,7 @@
           diagramNodePalette: [...nodePalette],
           diagramEdgePalette: [...edgePalette],
           sourceRoot: sourceRootRaw === "" ? null : sourceRootRaw,
+          blockedFileExtensions: blockedExtensions,
         };
 
         try {

package/dist/src/frontend/boot.js

@@ -11,6 +11,7 @@ document.addEventListener("DOMContentLoaded", async () => {
   setupDarkToggle();
   setupSearch();
   wcRestorePrefs();
+  if (typeof initFileAttach === "function") initFileAttach();
   await loadConfig();
   await loadDocuments();
 
@@ -86,5 +87,10 @@ document
 window.addEventListener("popstate", (e) => {
   const id =
     e.state?.docId || new URLSearchParams(location.search).get("doc");
-  if (id) openDocument(id, true);
+  const anchor =
+    e.state?.anchor ||
+    (location.hash && location.hash.length > 1
+      ? location.hash.slice(1)
+      : null);
+  if (id) openDocument(id, true, false, anchor);
 });

package/dist/src/frontend/documents.js

@@ -43,17 +43,23 @@ async function refreshAnnotationCounts() {
   }
 }
 
-async function openDocument(id, skipHistory = false, fromLink = false) {
+async function openDocument(id, skipHistory = false, fromLink = false, anchor = null) {
   // Track navigation history for breadcrumb trail
   // fromLink===true  : forward navigation via in-doc link → push current to stack
+  //                   (unless target is already in the stack → rewind instead of loop)
   // fromLink==="restore" : back navigation via history breadcrumb → stack already trimmed, don't touch
   // fromLink===false : sidebar/direct navigation → reset stack
   if (fromLink === true && currentDocId && currentDocId !== id) {
-    const prev = allDocs && allDocs.find((d) => d.id === currentDocId);
-    navHistory.push({
-      id: currentDocId,
-      title: prev ? prev.title : currentDocId,
-    });
+    const existingIdx = navHistory.findIndex((e) => e.id === id);
+    if (existingIdx !== -1) {
+      navHistory = navHistory.slice(0, existingIdx);
+    } else {
+      const prev = allDocs && allDocs.find((d) => d.id === currentDocId);
+      navHistory.push({
+        id: currentDocId,
+        title: prev ? prev.title : currentDocId,
+      });
+    }
   } else if (!fromLink) {
     navHistory = [];
   }
@@ -105,7 +111,8 @@ async function openDocument(id, skipHistory = false, fromLink = false) {
   if (!skipHistory) {
     const url = new URL(location.href);
     url.searchParams.set("doc", id);
-    history.pushState({ docId: id }, "", url);
+    url.hash = anchor ? `#${anchor}` : "";
+    history.pushState({ docId: id, anchor: anchor || null }, "", url);
   }
 
   document.getElementById("welcome").classList.add("hidden");
@@ -158,14 +165,16 @@ async function openDocument(id, skipHistory = false, fromLink = false) {
       hljs.highlightElement(block);
     });
 
-    // Intercept inter-doc links (?doc=X) to stay in SPA and track origin
+    // Intercept inter-doc links (?doc=X[#anchor]) to stay in SPA and track origin
     contentEl.querySelectorAll("a[href]").forEach((a) => {
       const href = a.getAttribute("href");
       const m = href && href.match(/[?&]doc=([^&#]+)/);
       if (!m) return;
+      const hashIdx = href.indexOf("#");
+      const anchor = hashIdx !== -1 ? href.slice(hashIdx + 1) : null;
       a.addEventListener("click", (e) => {
         e.preventDefault();
-        openDocument(decodeURIComponent(m[1]), false, true);
+        openDocument(decodeURIComponent(m[1]), false, true, anchor);
       });
     });
 
@@ -199,10 +208,11 @@ async function openDocument(id, skipHistory = false, fromLink = false) {
 
     document.title = doc.title;
 
-    // Scroll to anchor if present in URL
-    const hash = window.location.hash;
-    if (hash && hash.length > 1) {
-      scrollToAnchor(hash.slice(1));
+    // Scroll to anchor if present (explicit param wins over URL hash)
+    const targetAnchor =
+      anchor || (window.location.hash ? window.location.hash.slice(1) : "");
+    if (targetAnchor) {
+      scrollToAnchor(targetAnchor);
     } else {
       document.getElementById("content-area").scrollTop = 0;
     }
@@ -331,9 +341,11 @@ async function saveDocument() {
       const href = a.getAttribute("href");
       const m = href && href.match(/[?&]doc=([^&#]+)/);
       if (!m) return;
+      const hashIdx = href.indexOf("#");
+      const anchor = hashIdx !== -1 ? href.slice(hashIdx + 1) : null;
       a.addEventListener("click", (e) => {
         e.preventDefault();
-        openDocument(decodeURIComponent(m[1]), false, true);
+        openDocument(decodeURIComponent(m[1]), false, true, anchor);
       });
     });
 

package/dist/src/frontend/file-attach.js

@@ -0,0 +1,178 @@
+// ── File attachments ────────────────────────────────────────────────────────
+// Attach arbitrary files (pdf, docx, zip, …) to a document via drag & drop,
+// paste or the Snippets panel. Files are saved under DOCS_FOLDER/files/ and
+// inserted as `[📎 name.ext](./files/<server-name>.<ext>)` in the markdown.
+//
+// Client-side size guard matches server-side MAX_FILE_BYTES (19 MB) so the
+// user gets an immediate toast when Express would otherwise reject the body.
+
+const FILE_MAX_BYTES = 19 * 1024 * 1024;
+
+function _fileAttachNotify(message, isError) {
+  const msgEl = document.getElementById("edit-save-msg");
+  if (msgEl) {
+    msgEl.textContent = message;
+    msgEl.className = isError
+      ? "text-xs text-red-500 dark:text-red-400"
+      : "text-xs text-gray-400";
+  }
+}
+
+function _fileAttachReadAsBase64(file) {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onload = () => resolve(reader.result);
+    reader.onerror = reject;
+    reader.readAsDataURL(file);
+  });
+}
+
+function _fileAttachInsertAtCursor(markdown, start, end) {
+  const editor = document.getElementById("doc-editor");
+  if (!editor) return;
+  const s = typeof start === "number" ? start : editor.selectionStart;
+  const e = typeof end === "number" ? end : editor.selectionEnd;
+  const before = editor.value.slice(0, s);
+  const after = editor.value.slice(e);
+  editor.value = before + markdown + after;
+  editor.selectionStart = editor.selectionEnd = s + markdown.length;
+  editor.focus();
+}
+
+async function uploadAttachedFile(file, cursorStart, cursorEnd) {
+  if (!file) return;
+
+  if (file.size > FILE_MAX_BYTES) {
+    const mb = (file.size / 1024 / 1024).toFixed(1);
+    _fileAttachNotify(
+      (window.t ? window.t("doc.file_too_large") : "File too large") +
+        ` (${mb} MB, max 19 MB)`,
+      true,
+    );
+    return;
+  }
+
+  _fileAttachNotify(
+    window.t ? window.t("doc.uploading_file") : "Uploading file…",
+    false,
+  );
+
+  try {
+    const base64 = await _fileAttachReadAsBase64(file);
+    const res = await fetch("/api/files/upload", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ data: base64, name: file.name }),
+    });
+    if (!res.ok) {
+      let msg = "";
+      try {
+        const body = await res.json();
+        msg = body.error || "";
+      } catch {
+        msg = await res.text();
+      }
+      throw new Error(msg || `HTTP ${res.status}`);
+    }
+    const { url, originalName } = await res.json();
+    const label = originalName || file.name;
+    const markdown = `[📎 ${label}](${url})`;
+    _fileAttachInsertAtCursor(markdown, cursorStart, cursorEnd);
+    _fileAttachNotify("", false);
+  } catch (err) {
+    _fileAttachNotify(
+      (window.t ? window.t("doc.file_upload_failed") : "File upload failed: ") +
+        (err.message || String(err)),
+      true,
+    );
+  }
+}
+
+function _fileAttachHandleDrop(e) {
+  const editor = document.getElementById("doc-editor");
+  if (!editor || editor.classList.contains("hidden")) return;
+  const files = Array.from(e.dataTransfer?.files ?? []);
+  if (files.length === 0) return;
+
+  // Images keep flowing through image-paste.js → ignore them here.
+  const nonImage = files.filter((f) => !f.type.startsWith("image/"));
+  if (nonImage.length === 0) return;
+
+  e.preventDefault();
+  e.stopPropagation();
+
+  // Drop uses the current caret, not the drop coordinates — keeps things simple.
+  const start = editor.selectionStart;
+  const end = editor.selectionEnd;
+  (async () => {
+    let offset = 0;
+    for (const file of nonImage) {
+      await uploadAttachedFile(file, start + offset, end + offset);
+      // After insertion the caret is positioned AFTER the inserted markdown;
+      // re-read it for the next file so multiple drops append correctly.
+      offset = 0;
+    }
+  })();
+}
+
+function _fileAttachHandlePaste(e) {
+  const editor = document.getElementById("doc-editor");
+  if (!editor) return;
+  const files = Array.from(e.clipboardData?.files ?? []);
+  if (files.length === 0) return;
+  const nonImage = files.filter((f) => !f.type.startsWith("image/"));
+  if (nonImage.length === 0) return;
+
+  e.preventDefault();
+  const start = editor.selectionStart;
+  const end = editor.selectionEnd;
+  (async () => {
+    for (const file of nonImage) {
+      await uploadAttachedFile(file, start, end);
+    }
+  })();
+}
+
+function _fileAttachHandleDragOver(e) {
+  const editor = document.getElementById("doc-editor");
+  if (!editor || editor.classList.contains("hidden")) return;
+  if (e.dataTransfer?.types?.includes("Files")) {
+    e.preventDefault();
+    e.dataTransfer.dropEffect = "copy";
+  }
+}
+
+function initFileAttach() {
+  const editor = document.getElementById("doc-editor");
+  if (!editor) return;
+  editor.addEventListener("drop", _fileAttachHandleDrop);
+  editor.addEventListener("dragover", _fileAttachHandleDragOver);
+  editor.addEventListener("paste", _fileAttachHandlePaste);
+}
+
+// Triggered by the 📎 snippet button — opens the native file picker.
+function openFilePicker() {
+  const editor = document.getElementById("doc-editor");
+  if (!editor) return;
+  const start = editor.selectionStart;
+  const end = editor.selectionEnd;
+
+  let input = document.getElementById("file-attach-picker");
+  if (!input) {
+    input = document.createElement("input");
+    input.type = "file";
+    input.id = "file-attach-picker";
+    input.style.display = "none";
+    document.body.appendChild(input);
+  }
+  input.value = "";
+  input.onchange = async () => {
+    const file = input.files && input.files[0];
+    if (file) await uploadAttachedFile(file, start, end);
+  };
+  input.click();
+}
+
+window.initFileAttach = initFileAttach;
+window.openFilePicker = openFilePicker;
+window.uploadAttachedFile = uploadAttachedFile;

package/dist/src/frontend/i18n/en.json

@@ -58,6 +58,9 @@
   "doc.save": "Save document",
   "doc.uploading_image": "Uploading image…",
   "doc.image_upload_failed": "Image upload failed: ",
+  "doc.uploading_file": "Uploading file…",
+  "doc.file_upload_failed": "File upload failed: ",
+  "doc.file_too_large": "File too large",
   "doc.saving": "Saving…",
   "doc.failed_to_load": "Failed to load document: ",
   "doc.copied": "✓ Copied!",
@@ -149,6 +152,8 @@
   "snippet.link_anchor_label": "Anchor",
   "snippet.link_anchor_placeholder": "my-heading",
   "snippet.link_anchor_hint": "(without #, e.g. my-heading)",
+  "snippet.link_anchor_select_hint": "(pick a heading from the document)",
+  "snippet.link_anchor_no_headings": "No headings detected in this document",
   "snippet.link_target_doc_label": "Target document",
   "snippet.code_lang_label": "Language",
   "snippet.code_lang_hint": "(e.g. javascript, python, bash…)",
@@ -176,6 +181,9 @@
   "snippet.saving_btn": "Saving…",
   "snippet.detected_msg": "✓ Detected type: {type}. Fields pre-filled — edit then click Insert to replace selection.",
   "snippet.unknown_type_msg": "⚠ Selected text doesn't match any known snippet type. Choose a type below — the snippet will still replace the selection.",
+  "snippet.attachment": "📎 File attachment",
+  "snippet.attachment_help": "Click <strong>Insert</strong> to choose a file. It will be uploaded under the <code>files/</code> folder and inserted as a <i class=\"fa-solid fa-paperclip\"></i> link in your document.",
+  "snippet.attachment_alt": "Tip: you can also drag &amp; drop a file onto the editor, or paste it from the clipboard.",
 
   "modal.img_paste.title": "Paste clipboard image?",
   "modal.img_paste.filename_label": "Filename",
@@ -275,6 +283,11 @@
   "admin.extra_files.added_label": "Added",
   "admin.extra_files.loading": "Loading…",
 
+  "admin.files.title": "File Attachments",
+  "admin.files.description": "Extensions that are rejected by the <code>/api/files/upload</code> endpoint. One extension per line (or comma/space separated), without the leading dot.",
+  "admin.files.blocked_label": "Blocked extensions",
+  "admin.files.hint": "Defaults to common executable formats. Max upload size is 19 MB per file.",
+
   "admin.palette.title": "Diagram Color Palettes",
   "admin.palette.description": "Customize the colors available in the diagram editor. Changes take effect after saving.",
   "admin.palette.shapes_title": "Shape colors",

package/dist/src/frontend/i18n/fr.json

@@ -58,6 +58,9 @@
   "doc.save": "Enregistrer le document",
   "doc.uploading_image": "Téléversement de l'image…",
   "doc.image_upload_failed": "Échec du téléversement : ",
+  "doc.uploading_file": "Téléversement du fichier…",
+  "doc.file_upload_failed": "Échec du téléversement du fichier : ",
+  "doc.file_too_large": "Fichier trop volumineux",
   "doc.saving": "Enregistrement…",
   "doc.failed_to_load": "Impossible de charger le document : ",
   "doc.copied": "✓ Copié !",
@@ -149,6 +152,8 @@
   "snippet.link_anchor_label": "Ancre",
   "snippet.link_anchor_placeholder": "mon-titre",
   "snippet.link_anchor_hint": "(sans #, ex : mon-titre)",
+  "snippet.link_anchor_select_hint": "(choisissez un titre du document)",
+  "snippet.link_anchor_no_headings": "Aucun titre détecté dans ce document",
   "snippet.link_target_doc_label": "Document cible",
   "snippet.code_lang_label": "Langage",
   "snippet.code_lang_hint": "(ex : javascript, python, bash…)",
@@ -176,6 +181,9 @@
   "snippet.saving_btn": "Enregistrement…",
   "snippet.detected_msg": "✓ Type détecté : {type}. Les champs ont été pré-remplis — modifiez puis cliquez sur Insérer pour remplacer la sélection.",
   "snippet.unknown_type_msg": "⚠ Le texte sélectionné ne correspond à aucun type de snippet reconnu. Choisissez un type ci-dessous — le snippet remplacera quand même la sélection.",
+  "snippet.attachment": "📎 Pièce jointe",
+  "snippet.attachment_help": "Cliquez sur <strong>Insérer</strong> pour choisir un fichier. Il sera téléversé dans le dossier <code>files/</code> et inséré sous forme de lien <i class=\"fa-solid fa-paperclip\"></i> dans votre document.",
+  "snippet.attachment_alt": "Astuce : vous pouvez aussi glisser-déposer un fichier sur l'éditeur ou le coller depuis le presse-papiers.",
 
   "modal.img_paste.title": "Coller l'image du presse-papiers ?",
   "modal.img_paste.filename_label": "Nom du fichier",
@@ -275,6 +283,11 @@
   "admin.extra_files.added_label": "Ajouté",
   "admin.extra_files.loading": "Chargement…",
 
+  "admin.files.title": "Pièces jointes",
+  "admin.files.description": "Extensions refusées par le endpoint <code>/api/files/upload</code>. Une extension par ligne (ou séparées par des virgules ou des espaces), sans le point.",
+  "admin.files.blocked_label": "Extensions bloquées",
+  "admin.files.hint": "Par défaut, les formats exécutables courants. Taille maximale : 19 Mo par fichier.",
+
   "admin.palette.title": "Palettes de couleurs des diagrammes",
   "admin.palette.description": "Personnalisez les couleurs disponibles dans l'éditeur de diagrammes. Les modifications prennent effet après enregistrement.",
   "admin.palette.shapes_title": "Couleurs des formes",