living-documentation 7.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +661 -0
- package/README.md +329 -0
- package/dist/bin/cli.d.ts +3 -0
- package/dist/bin/cli.d.ts.map +1 -0
- package/dist/bin/cli.js +62 -0
- package/dist/bin/cli.js.map +1 -0
- package/dist/src/frontend/admin.html +1073 -0
- package/dist/src/frontend/annotations.js +546 -0
- package/dist/src/frontend/boot.js +90 -0
- package/dist/src/frontend/config.js +19 -0
- package/dist/src/frontend/dark-mode.js +20 -0
- package/dist/src/frontend/diagram/alignment.js +161 -0
- package/dist/src/frontend/diagram/clipboard.js +172 -0
- package/dist/src/frontend/diagram/constants.js +109 -0
- package/dist/src/frontend/diagram/debug.js +43 -0
- package/dist/src/frontend/diagram/edge-panel.js +260 -0
- package/dist/src/frontend/diagram/edge-rendering.js +12 -0
- package/dist/src/frontend/diagram/grid.js +78 -0
- package/dist/src/frontend/diagram/groups.js +102 -0
- package/dist/src/frontend/diagram/history.js +153 -0
- package/dist/src/frontend/diagram/image-name-modal.js +48 -0
- package/dist/src/frontend/diagram/image-upload.js +36 -0
- package/dist/src/frontend/diagram/label-editor.js +115 -0
- package/dist/src/frontend/diagram/link-panel.js +144 -0
- package/dist/src/frontend/diagram/main.js +299 -0
- package/dist/src/frontend/diagram/network.js +1473 -0
- package/dist/src/frontend/diagram/node-panel.js +267 -0
- package/dist/src/frontend/diagram/node-rendering.js +773 -0
- package/dist/src/frontend/diagram/persistence.js +161 -0
- package/dist/src/frontend/diagram/ports.js +386 -0
- package/dist/src/frontend/diagram/selection-overlay.js +336 -0
- package/dist/src/frontend/diagram/state.js +39 -0
- package/dist/src/frontend/diagram/t.js +3 -0
- package/dist/src/frontend/diagram/toast.js +21 -0
- package/dist/src/frontend/diagram/unlock-hold.js +182 -0
- package/dist/src/frontend/diagram/zoom.js +20 -0
- package/dist/src/frontend/diagram-link-modal.js +137 -0
- package/dist/src/frontend/diagram.html +1279 -0
- package/dist/src/frontend/documents.js +373 -0
- package/dist/src/frontend/export.js +338 -0
- package/dist/src/frontend/i18n/en.json +406 -0
- package/dist/src/frontend/i18n/fr.json +406 -0
- package/dist/src/frontend/i18n.js +32 -0
- package/dist/src/frontend/image-paste.js +101 -0
- package/dist/src/frontend/index.html +2314 -0
- package/dist/src/frontend/misc.js +25 -0
- package/dist/src/frontend/new-doc-modal.js +260 -0
- package/dist/src/frontend/new-folder-modal.js +174 -0
- package/dist/src/frontend/search.js +157 -0
- package/dist/src/frontend/sidebar-helpers.js +58 -0
- package/dist/src/frontend/sidebar.js +182 -0
- package/dist/src/frontend/snippet-detect.js +25 -0
- package/dist/src/frontend/snippet-table.js +85 -0
- package/dist/src/frontend/snippet-tree.js +94 -0
- package/dist/src/frontend/snippets.js +534 -0
- package/dist/src/frontend/state.js +28 -0
- package/dist/src/frontend/utils.js +21 -0
- package/dist/src/frontend/vendor/wordcloud2.js +1187 -0
- package/dist/src/frontend/wordcloud.js +693 -0
- package/dist/src/lib/config.d.ts +17 -0
- package/dist/src/lib/config.d.ts.map +1 -0
- package/dist/src/lib/config.js +79 -0
- package/dist/src/lib/config.js.map +1 -0
- package/dist/src/lib/parser.d.ts +11 -0
- package/dist/src/lib/parser.d.ts.map +1 -0
- package/dist/src/lib/parser.js +111 -0
- package/dist/src/lib/parser.js.map +1 -0
- package/dist/src/mcp/server.d.ts +3 -0
- package/dist/src/mcp/server.d.ts.map +1 -0
- package/dist/src/mcp/server.js +986 -0
- package/dist/src/mcp/server.js.map +1 -0
- package/dist/src/mcp/tools/diagrams.d.ts +44 -0
- package/dist/src/mcp/tools/diagrams.d.ts.map +1 -0
- package/dist/src/mcp/tools/diagrams.js +245 -0
- package/dist/src/mcp/tools/diagrams.js.map +1 -0
- package/dist/src/mcp/tools/documents.d.ts +26 -0
- package/dist/src/mcp/tools/documents.d.ts.map +1 -0
- package/dist/src/mcp/tools/documents.js +127 -0
- package/dist/src/mcp/tools/documents.js.map +1 -0
- package/dist/src/mcp/tools/source.d.ts +29 -0
- package/dist/src/mcp/tools/source.d.ts.map +1 -0
- package/dist/src/mcp/tools/source.js +200 -0
- package/dist/src/mcp/tools/source.js.map +1 -0
- package/dist/src/routes/annotations.d.ts +3 -0
- package/dist/src/routes/annotations.d.ts.map +1 -0
- package/dist/src/routes/annotations.js +83 -0
- package/dist/src/routes/annotations.js.map +1 -0
- package/dist/src/routes/browse.d.ts +3 -0
- package/dist/src/routes/browse.d.ts.map +1 -0
- package/dist/src/routes/browse.js +75 -0
- package/dist/src/routes/browse.js.map +1 -0
- package/dist/src/routes/config.d.ts +3 -0
- package/dist/src/routes/config.d.ts.map +1 -0
- package/dist/src/routes/config.js +97 -0
- package/dist/src/routes/config.js.map +1 -0
- package/dist/src/routes/diagrams.d.ts +3 -0
- package/dist/src/routes/diagrams.d.ts.map +1 -0
- package/dist/src/routes/diagrams.js +69 -0
- package/dist/src/routes/diagrams.js.map +1 -0
- package/dist/src/routes/documents.d.ts +8 -0
- package/dist/src/routes/documents.d.ts.map +1 -0
- package/dist/src/routes/documents.js +332 -0
- package/dist/src/routes/documents.js.map +1 -0
- package/dist/src/routes/export.d.ts +3 -0
- package/dist/src/routes/export.d.ts.map +1 -0
- package/dist/src/routes/export.js +277 -0
- package/dist/src/routes/export.js.map +1 -0
- package/dist/src/routes/images.d.ts +3 -0
- package/dist/src/routes/images.d.ts.map +1 -0
- package/dist/src/routes/images.js +49 -0
- package/dist/src/routes/images.js.map +1 -0
- package/dist/src/routes/wordcloud.d.ts +3 -0
- package/dist/src/routes/wordcloud.d.ts.map +1 -0
- package/dist/src/routes/wordcloud.js +95 -0
- package/dist/src/routes/wordcloud.js.map +1 -0
- package/dist/src/server.d.ts +7 -0
- package/dist/src/server.d.ts.map +1 -0
- package/dist/src/server.js +76 -0
- package/dist/src/server.js.map +1 -0
- package/dist/starting-doc/.annotations.json +3 -0
- package/dist/starting-doc/.diagrams.json +1884 -0
- package/dist/starting-doc/.living-doc.json +39 -0
- package/dist/starting-doc/1_tutorial/2026_04_11_13_25_[General]_crer_vos_dossiers.md +16 -0
- package/dist/starting-doc/1_tutorial/2026_04_11_18_58_[General]_creer_un_document_dans_un_dossier.md +9 -0
- package/dist/starting-doc/1_tutorial/2026_04_12_09_00_[General]_editer_et_sauvegarder.md +39 -0
- package/dist/starting-doc/1_tutorial/2026_04_12_10_00_[General]_utiliser_les_snippets.md +71 -0
- package/dist/starting-doc/2026_04_08_20_52_[General]_welcome.md +17 -0
- package/dist/starting-doc/2026_04_11_12_55_[General]_premiers_pas.md +271 -0
- package/dist/starting-doc/2_guide/2026_04_08_00_04_[DOCUMENT]_utilisation_des_images_plein_ecran_lien_clickable.md +40 -0
- package/dist/starting-doc/2_guide/2026_04_08_23_38_[Configuration]_demarrage_de_living_documentation.md +32 -0
- package/dist/starting-doc/2_guide/2026_04_09_09_00_[NAVIGATION]_recherche_plein_texte.md +65 -0
- package/dist/starting-doc/2_guide/2026_04_09_10_00_[EXPORT]_exporter_en_pdf.md +43 -0
- package/dist/starting-doc/2_guide/2026_04_09_11_00_[Configuration]_configurer_le_panneau_admin.md +55 -0
- package/dist/starting-doc/2_guide/2026_04_09_12_00_[Configuration]_extra_files.md +68 -0
- package/dist/starting-doc/2_guide/2026_04_09_13_00_[WORDCLOUD]_word_cloud.md +54 -0
- package/dist/starting-doc/2_guide/2026_04_09_14_00_[DIAGRAM]_creer_et_lier_un_diagramme.md +77 -0
- package/dist/starting-doc/3_concept/2026_04_08_20_58_[DOCUMENTING]_ADRS.md +20 -0
- package/dist/starting-doc/3_concept/2026_04_08_22_15_[DOCUMENTING]_living_documentation.md +17 -0
- package/dist/starting-doc/3_concept/2026_04_08_22_46_[METHODOLOGY]_diataxis_architecture_du_contenu.md +16 -0
- package/dist/starting-doc/4_reference/2026_04_08_23_14_[FUNDAMENTALS]_the_living_documentation_tool.md +41 -0
- package/dist/starting-doc/4_reference/2026_04_09_01_00_[REFERENCE]_raccourcis_clavier.md +61 -0
- package/dist/starting-doc/4_reference/2026_04_09_02_00_[REFERENCE]_tokens_pattern_nommage.md +75 -0
- package/dist/starting-doc/4_reference/2026_04_09_03_00_[REFERENCE]_types_de_snippets.md +68 -0
- package/dist/starting-doc/4_reference/2026_04_11_17_31_[FUNDAMENTALS]_architecturer_une_documentation.md +12 -0
- package/dist/starting-doc/4_reference/2026_04_12_14_07_[FUNDAMENTALS]_dossiers_et_catgories.md +89 -0
- package/dist/starting-doc/images/admin_screenshot.png +0 -0
- package/dist/starting-doc/images/ajout-document.png +0 -0
- package/dist/starting-doc/images/ajouter-document-categorie.png +0 -0
- package/dist/starting-doc/images/ajouter_un_document_dans_un_dossier.png +0 -0
- package/dist/starting-doc/images/architecturer_une_documentation_reference.png +0 -0
- package/dist/starting-doc/images/cr_er_un_document.png +0 -0
- package/dist/starting-doc/images/creation-nouveau-dossier.png +0 -0
- package/dist/starting-doc/images/creer-document-context-engineering.png +0 -0
- package/dist/starting-doc/images/creer-dossier-only-tutoriel.png +0 -0
- package/dist/starting-doc/images/creer-dossier-tutoriel.png +0 -0
- package/dist/starting-doc/images/creer-dossiers-done.png +0 -0
- package/dist/starting-doc/images/creer-un-document.png +0 -0
- package/dist/starting-doc/images/creer-vos-dossiers-tutoriel.png +0 -0
- package/dist/starting-doc/images/creer-vos-dossiers.png +0 -0
- package/dist/starting-doc/images/decouverte_adrs.png +0 -0
- package/dist/starting-doc/images/diataxis.png +0 -0
- package/dist/starting-doc/images/diataxis_callout.png +0 -0
- package/dist/starting-doc/images/document-cree.png +0 -0
- package/dist/starting-doc/images/liens_snippets.png +0 -0
- package/dist/starting-doc/images/living_documentation.png +0 -0
- package/dist/starting-doc/images/npm_logo.png +0 -0
- package/dist/starting-doc/images/popup-creer-document.png +0 -0
- package/dist/starting-doc/images/popup-creer-dossier.png +0 -0
- package/dist/starting-doc/images/popup-dossier-cree.png +0 -0
- package/dist/starting-doc/images/quatre-dossiers-crees.png +0 -0
- package/dist/starting-doc/images/screenshot-living-doc.png +0 -0
- package/dist/starting-doc/images/the_living_documentation_tool.png +0 -0
- package/package.json +49 -0
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
// ── Diagram link modal ──────────────────────────────────────────────────────
|
|
2
|
+
// Depends on globals from state.js (currentDocId, currentDocContent) and
|
|
3
|
+
// utils.js (esc).
|
|
4
|
+
|
|
5
|
+
let _diagrams = [];
|
|
6
|
+
|
|
7
|
+
async function openDiagramLinkModal() {
|
|
8
|
+
if (!currentDocId) return;
|
|
9
|
+
// Fetch diagram list
|
|
10
|
+
try {
|
|
11
|
+
_diagrams = await fetch("/api/diagrams").then((r) => r.json());
|
|
12
|
+
} catch {
|
|
13
|
+
_diagrams = [];
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
const sel = document.getElementById("diag-select");
|
|
17
|
+
sel.innerHTML = _diagrams.length
|
|
18
|
+
? _diagrams
|
|
19
|
+
.map(
|
|
20
|
+
(d) => `<option value="${esc(d.id)}">${esc(d.title)}</option>`,
|
|
21
|
+
)
|
|
22
|
+
.join("")
|
|
23
|
+
: `<option value="" disabled>${window.t('modal.diag_link.no_diagrams')}</option>`;
|
|
24
|
+
|
|
25
|
+
// Pre-fill image name from current doc title
|
|
26
|
+
const docTitle = document
|
|
27
|
+
.getElementById("doc-title")
|
|
28
|
+
.textContent.trim();
|
|
29
|
+
const slug = docTitle
|
|
30
|
+
.toLowerCase()
|
|
31
|
+
.replace(/[^a-z0-9]+/g, "_")
|
|
32
|
+
.replace(/^_|_$/g, "");
|
|
33
|
+
document.getElementById("diag-img-name").value = slug
|
|
34
|
+
? slug + ".png"
|
|
35
|
+
: "diagram.png";
|
|
36
|
+
document.getElementById("diag-new-name").value = docTitle
|
|
37
|
+
? docTitle + " Diagram"
|
|
38
|
+
: "";
|
|
39
|
+
|
|
40
|
+
// Default mode
|
|
41
|
+
document.getElementById("diag-mode-existing").checked = true;
|
|
42
|
+
diagModeChanged();
|
|
43
|
+
|
|
44
|
+
document.getElementById("diag-link-modal").classList.remove("hidden");
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
function closeDiagramLinkModal() {
|
|
48
|
+
document.getElementById("diag-link-modal").classList.add("hidden");
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
function diagModeChanged() {
|
|
52
|
+
const isNew = document.getElementById("diag-mode-new").checked;
|
|
53
|
+
document
|
|
54
|
+
.getElementById("diag-existing-section")
|
|
55
|
+
.classList.toggle("hidden", isNew);
|
|
56
|
+
document
|
|
57
|
+
.getElementById("diag-new-section")
|
|
58
|
+
.classList.toggle("hidden", !isNew);
|
|
59
|
+
diagUpdatePreview();
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
function diagUpdatePreview() {
|
|
63
|
+
const isNew = document.getElementById("diag-mode-new").checked;
|
|
64
|
+
const imgName =
|
|
65
|
+
document.getElementById("diag-img-name").value.trim() ||
|
|
66
|
+
"diagram.png";
|
|
67
|
+
let diagId, diagLabel;
|
|
68
|
+
if (isNew) {
|
|
69
|
+
diagId = "d" + Date.now();
|
|
70
|
+
diagLabel =
|
|
71
|
+
document.getElementById("diag-new-name").value.trim() || "Diagram";
|
|
72
|
+
} else {
|
|
73
|
+
const sel = document.getElementById("diag-select");
|
|
74
|
+
diagId = sel.value;
|
|
75
|
+
diagLabel = sel.options[sel.selectedIndex]?.text || "Diagram";
|
|
76
|
+
}
|
|
77
|
+
const md = `\n\n[](/diagram?id=${diagId})`;
|
|
78
|
+
document.getElementById("diag-preview").textContent = md.trim();
|
|
79
|
+
// store for insertDiagramLink
|
|
80
|
+
document.getElementById("diag-insert-btn").dataset.diagId = diagId;
|
|
81
|
+
document.getElementById("diag-insert-btn").dataset.diagLabel =
|
|
82
|
+
diagLabel;
|
|
83
|
+
document.getElementById("diag-insert-btn").dataset.imgName = imgName;
|
|
84
|
+
document.getElementById("diag-insert-btn").dataset.isNew = isNew
|
|
85
|
+
? "1"
|
|
86
|
+
: "0";
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
async function insertDiagramLink() {
|
|
90
|
+
const btn = document.getElementById("diag-insert-btn");
|
|
91
|
+
const diagId = btn.dataset.diagId;
|
|
92
|
+
const diagLabel = btn.dataset.diagLabel;
|
|
93
|
+
const imgName = btn.dataset.imgName;
|
|
94
|
+
const isNew = btn.dataset.isNew === "1";
|
|
95
|
+
|
|
96
|
+
btn.disabled = true;
|
|
97
|
+
btn.textContent = window.t('modal.diag_link.saving_btn');
|
|
98
|
+
|
|
99
|
+
try {
|
|
100
|
+
// Create new diagram if needed
|
|
101
|
+
if (isNew) {
|
|
102
|
+
await fetch(`/api/diagrams/${diagId}`, {
|
|
103
|
+
method: "PUT",
|
|
104
|
+
headers: { "Content-Type": "application/json" },
|
|
105
|
+
body: JSON.stringify({ title: diagLabel, nodes: [], edges: [] }),
|
|
106
|
+
});
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
// Append markdown to document and save
|
|
110
|
+
const md = `\n\n[](/diagram?id=${diagId})`;
|
|
111
|
+
const newContent = currentDocContent + md;
|
|
112
|
+
const res = await fetch("/api/documents/" + currentDocId, {
|
|
113
|
+
method: "PUT",
|
|
114
|
+
headers: { "Content-Type": "application/json" },
|
|
115
|
+
body: JSON.stringify({ content: newContent }),
|
|
116
|
+
});
|
|
117
|
+
if (!res.ok) throw new Error(await res.text());
|
|
118
|
+
currentDocContent = newContent;
|
|
119
|
+
|
|
120
|
+
// Re-render the document so the page is up-to-date when the user navigates back
|
|
121
|
+
const doc = await fetch("/api/documents/" + currentDocId).then((r) =>
|
|
122
|
+
r.json(),
|
|
123
|
+
);
|
|
124
|
+
const contentEl = document.getElementById("doc-content");
|
|
125
|
+
contentEl.innerHTML = doc.html;
|
|
126
|
+
contentEl
|
|
127
|
+
.querySelectorAll("pre code")
|
|
128
|
+
.forEach((b) => hljs.highlightElement(b));
|
|
129
|
+
|
|
130
|
+
closeDiagramLinkModal();
|
|
131
|
+
window.location.href = `/diagram?id=${diagId}`;
|
|
132
|
+
} catch (err) {
|
|
133
|
+
btn.disabled = false;
|
|
134
|
+
btn.textContent = window.t('modal.diag_link.insert_btn');
|
|
135
|
+
alert(window.t('common.error_prefix') + err.message);
|
|
136
|
+
}
|
|
137
|
+
}
|