From 65dcdd86e09b95b4e42b43861fa8e427e974407f Mon Sep 17 00:00:00 2001
From: Gato <cedric@goutailler-olivier.fr>
Date: Sat, 4 Jul 2026 07:02:12 +0200
Subject: [PATCH] fix: tri naturel de la navigation (numerique au lieu de
 lexicographique)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 lib/converter.js | 21 +++++++++++++++------
 1 file changed, 15 insertions(+), 6 deletions(-)

diff --git a/lib/converter.js b/lib/converter.js
index ab56f5c..348ee3e 100644
--- a/lib/converter.js
+++ b/lib/converter.js
@@ -333,6 +333,15 @@ function escapeHtml(str) {
     .replace(/"/g, '&quot;');
 }
 
+/**
+ * Natural sort comparator: orders numeric chunks by value, not lexically,
+ * so "2" comes before "11" (and "2.1" before "2.10"). Case-insensitive.
+ */
+const collator = new Intl.Collator('fr', { numeric: true, sensitivity: 'base' });
+function naturalCompare(a, b) {
+  return collator.compare(a, b);
+}
+
 /** Build a nested tree object from a flat list of relative paths. */
 function buildTree(relPaths) {
   const tree = { _files: [], _dirs: {} };
@@ -354,8 +363,8 @@ function renderTree(node, baseDir, currentRel, depth) {
   let html = '';
   const depthClass = depth > 0 ? ` class="nav-depth-${Math.min(depth, 3)}"` : '';
 
-  // Files first (sorted)
-  node._files.slice().sort().forEach((rel) => {
+  // Files first (natural sort)
+  node._files.slice().sort(naturalCompare).forEach((rel) => {
     const pagePath = rel.replace(/\.md$/i, '');
     const label = path.basename(pagePath).replace(/-/g, ' ');
     const href = '/' + pagePath.split('/').map(encodeURIComponent).join('/');
@@ -368,8 +377,8 @@ function renderTree(node, baseDir, currentRel, depth) {
     }
   });
 
-  // Sub-directories (sorted)
-  Object.keys(node._dirs).sort().forEach((dirName) => {
+  // Sub-directories (natural sort)
+  Object.keys(node._dirs).sort(naturalCompare).forEach((dirName) => {
     const child = node._dirs[dirName];
     const isOpen = currentRel && currentRel.split(path.sep).includes(dirName);
     const openAttr = isOpen ? ' open' : '';
@@ -498,8 +507,8 @@ function buildIndex(baseDir, files, watchMode = false) {
     groups.get(group).push(rel);
   });
 
-  const listHtml = [...groups.keys()].sort().map((group) => {
-    const items = groups.get(group).sort().map((rel) => {
+  const listHtml = [...groups.keys()].sort(naturalCompare).map((group) => {
+    const items = groups.get(group).sort(naturalCompare).map((rel) => {
       const pagePath = rel.replace(/\.md$/i, '');
       const label = path.basename(pagePath).replace(/-/g, ' ');
       const href = '/' + pagePath.split('/').map(encodeURIComponent).join('/');