mkdocs-treeview 0.1.0__tar.gz → 0.2.1__tar.gz

{mkdocs_treeview-0.1.0 → mkdocs_treeview-0.2.1}/.gitignore

@@ -10,4 +10,5 @@ site/
 *.egg
 .ruff_cache/
 .mypy_cache/
-.claude/
+.claude/
+.cache/

{mkdocs_treeview-0.1.0 → mkdocs_treeview-0.2.1}/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.2.1] - 2026-06-08
+
+- Changed some PyPI configs in `pyproject.toml`
+
+## [0.2.0] - 2026-06-08
+
+### Fixed
+
+- **Zensical multi-page CSS accumulation** ([#1](https://github.com/knudsen/markdown-treeview/pull/1)): Zensical's Rust core spawns a fresh Python sub-interpreter per page, resetting module-level state including the `IconRegistry`. Icons from earlier pages were dropped, leaving later pages with incomplete CSS. Fixed by persisting the icon registry to a JSON manifest file (`.cache/treeview.manifest.json`) between page renders. Each page merges its icons into the manifest before regenerating CSS, so the final stylesheet contains every icon used across the entire site. Add `.cache/` to `.gitignore`.
+
 ## [0.1.0] - 2026-06-07
 
 Initial release.

{mkdocs_treeview-0.1.0 → mkdocs_treeview-0.2.1}/PKG-INFO

@@ -1,7 +1,12 @@
 Metadata-Version: 2.4
 Name: mkdocs-treeview
-Version: 0.1.0
+Version: 0.2.1
 Summary: MkDocs plugin and Markdown extension for rendering ASCII file trees with material icons
+Project-URL: Homepage, https://github.com/lknudsen/markdown-treeview
+Project-URL: Repository, https://github.com/lknudsen/markdown-treeview
+Project-URL: Issues, https://github.com/lknudsen/markdown-treeview/issues
+Project-URL: Changelog, https://github.com/lknudsen/markdown-treeview/blob/main/CHANGELOG.md
+Author: Lasse Knudsen
 License: MIT License
         
         Copyright (c) 2026 Lasse Knudsen
@@ -24,9 +29,23 @@ License: MIT License
         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
         SOFTWARE.
 License-File: LICENSE
+Keywords: icons,markdown,material-icons,mkdocs,mkdocs-plugin,treeview
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Documentation
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Text Processing :: Markup :: HTML
 Requires-Python: >=3.9
 Requires-Dist: markdown>=3.4
-Requires-Dist: mkdocs>=1.5
+Provides-Extra: mkdocs
+Requires-Dist: mkdocs>=1.5; extra == 'mkdocs'
 Description-Content-Type: text/markdown
 
 # mkdocs-treeview
@@ -52,7 +71,7 @@ Inspired by [asciidoctor-treeview](https://github.com/lask79/asciidoctor-treevie
 
 | Light | Dark |
 |:---:|:---:|
-| ![Treeview light theme](docs/images/treeview-light.png) | ![Treeview dark theme](docs/images/treeview-dark.png) |
+| ![Treeview light theme](https://raw.githubusercontent.com/lask79/mkdocs-treeview/main/docs/images/treeview-light.png) | ![Treeview dark theme](https://raw.githubusercontent.com/lask79/mkdocs-treeview/main/docs/images/treeview-dark.png) |
 
 ---
 
@@ -152,6 +171,18 @@ icon_mode = "embedded"
 `css_output_path` is resolved relative to the directory where `zensical build` is
 run (the project root). The extension writes a lean CSS file there after each page.
 
+**Add `.cache/` to your `.gitignore`:**
+
+```text
+.cache/
+```
+
+The extension writes a manifest file to `.cache/treeview.manifest.json` to
+accumulate icon data across pages. Zensical isolates each page render in its
+own Python sub-interpreter, so this file is the mechanism that lets the final
+CSS contain icons from *all* pages rather than just the last one rendered.
+The manifest is a build artifact — do not commit it.
+
 ---
 
 ## Asset modes
@@ -172,8 +203,11 @@ HTML with `tv-icon tv-icon-<name>` CSS classes. After the build, `on_post_build`
 writes a lean CSS file containing only the icons that were actually rendered.
 
 For Zensical, `TreeviewCSSPostprocessor` writes the CSS file after every page.
-Because the extension object persists across all `render()` calls, the registry
-accumulates icons across pages. The final write contains the complete lean CSS.
+Zensical isolates each page render in its own Python sub-interpreter, so the
+extension cannot keep an in-memory registry across pages. Instead, the extension
+persists the accumulated icon registry to `.cache/treeview.manifest.json` on
+disk. Each page render merges its icons into that file, then regenerates the
+full CSS. The final CSS contains every icon used across the entire site.
 
 ---
 

{mkdocs_treeview-0.1.0 → mkdocs_treeview-0.2.1}/README.md

@@ -21,7 +21,7 @@ Inspired by [asciidoctor-treeview](https://github.com/lask79/asciidoctor-treevie
 
 | Light | Dark |
 |:---:|:---:|
-| ![Treeview light theme](docs/images/treeview-light.png) | ![Treeview dark theme](docs/images/treeview-dark.png) |
+| ![Treeview light theme](https://raw.githubusercontent.com/lask79/mkdocs-treeview/main/docs/images/treeview-light.png) | ![Treeview dark theme](https://raw.githubusercontent.com/lask79/mkdocs-treeview/main/docs/images/treeview-dark.png) |
 
 ---
 
@@ -121,6 +121,18 @@ icon_mode = "embedded"
 `css_output_path` is resolved relative to the directory where `zensical build` is
 run (the project root). The extension writes a lean CSS file there after each page.
 
+**Add `.cache/` to your `.gitignore`:**
+
+```text
+.cache/
+```
+
+The extension writes a manifest file to `.cache/treeview.manifest.json` to
+accumulate icon data across pages. Zensical isolates each page render in its
+own Python sub-interpreter, so this file is the mechanism that lets the final
+CSS contain icons from *all* pages rather than just the last one rendered.
+The manifest is a build artifact — do not commit it.
+
 ---
 
 ## Asset modes
@@ -141,8 +153,11 @@ HTML with `tv-icon tv-icon-<name>` CSS classes. After the build, `on_post_build`
 writes a lean CSS file containing only the icons that were actually rendered.
 
 For Zensical, `TreeviewCSSPostprocessor` writes the CSS file after every page.
-Because the extension object persists across all `render()` calls, the registry
-accumulates icons across pages. The final write contains the complete lean CSS.
+Zensical isolates each page render in its own Python sub-interpreter, so the
+extension cannot keep an in-memory registry across pages. Instead, the extension
+persists the accumulated icon registry to `.cache/treeview.manifest.json` on
+disk. Each page render merges its icons into that file, then regenerates the
+full CSS. The final CSS contains every icon used across the entire site.
 
 ---
 

{mkdocs_treeview-0.1.0 → mkdocs_treeview-0.2.1}/mkdocs_treeview/extension.py

@@ -4,6 +4,7 @@ Python-Markdown extension for treeview fenced code blocks.
 
 from __future__ import annotations
 
+import json
 import re
 from pathlib import Path
 from typing import Any
@@ -59,13 +60,14 @@ class TreeviewPreprocessor(Preprocessor):
 
 
 class TreeviewCSSPostprocessor(Postprocessor):
-    """Writes a lean CSS file containing only the icons used so far.
-
-    Registered when css_output_path is set on TreeviewExtension. Since
-    Zensical (and similar pipelines) create a new Markdown() instance per
-    page, this runs after every page. The registry accumulates icons across
-    all pages; each write overwrites the previous file. By the last page the
-    file contains exactly the icons referenced across the whole site.
+    """Writes a lean CSS file accumulating icons from all rendered pages.
+
+    Registered when css_output_path is set on TreeviewExtension. Zensical's
+    Rust core isolates each page render in its own Python sub-interpreter, so
+    module-level state cannot be shared across pages. Instead, a JSON manifest
+    (css_output_path + ".manifest.json") persists the full icon registry on
+    disk. Each page render merges its icons into the manifest, then regenerates
+    the CSS. Every write is additive — no previously seen icon is ever lost.
     """
 
     def __init__(
@@ -75,24 +77,54 @@ class TreeviewCSSPostprocessor(Postprocessor):
         css_output_path: Path,
         icon_mode: str,
         icons_dir: Path,
+        manifest_path: Path | None = None,
     ):
         super().__init__(md)
         self.registry = registry
         self.css_output_path = css_output_path
+        self.manifest_path = manifest_path or (
+            Path.cwd() / ".cache" / f"{css_output_path.stem}.manifest.json"
+        )
         self.icon_mode = icon_mode
         self.icons_dir = icons_dir
 
+    def _load_manifest(self) -> dict[str, tuple[str, str]]:
+        """Load the persisted icon registry from disk, or return empty dict."""
+        if not self.manifest_path.exists():
+            return {}
+        try:
+            data = json.loads(self.manifest_path.read_text(encoding="utf-8"))
+            return {cls: tuple(pair) for cls, pair in data.items()}  # type: ignore[misc]
+        except Exception:
+            return {}
+
+    def _save_manifest(self, registry: dict[str, tuple[str, str]]) -> None:
+        self.manifest_path.parent.mkdir(parents=True, exist_ok=True)
+        self.manifest_path.write_text(
+            json.dumps(registry, indent=2), encoding="utf-8"
+        )
+
     def run(self, text: str) -> str:
-        icons = self.registry.items()
-        if icons:
-            self.css_output_path.parent.mkdir(parents=True, exist_ok=True)
-            css = generate_css(
-                icons=icons,
-                icon_mode=self.icon_mode,
-                icons_dir=self.icons_dir if self.icon_mode == "embedded" else None,
-                assets_path="icons",
-            )
-            self.css_output_path.write_text(css, encoding="utf-8")
+        this_page_icons = self.registry.items()
+        if not this_page_icons:
+            return text
+
+        # Merge this page's icons into the persisted manifest.
+        manifest = self._load_manifest()
+        for cls, dark, light in this_page_icons:
+            manifest[cls] = (dark, light)
+
+        self.css_output_path.parent.mkdir(parents=True, exist_ok=True)
+        self._save_manifest(manifest)
+
+        merged = [(cls, dark, light) for cls, (dark, light) in manifest.items()]
+        css = generate_css(
+            icons=merged,
+            icon_mode=self.icon_mode,
+            icons_dir=self.icons_dir if self.icon_mode == "embedded" else None,
+            assets_path="icons",
+        )
+        self.css_output_path.write_text(css, encoding="utf-8")
         return text
 
 
@@ -114,6 +146,9 @@ class TreeviewExtension(Extension):
             Path(kwargs.pop("css_output_path")) if "css_output_path" in kwargs else None
         )
         self._icon_mode: str = kwargs.pop("icon_mode", "embedded")
+        self._manifest_path: Path | None = (
+            Path(kwargs.pop("manifest_path")) if "manifest_path" in kwargs else None
+        )
         super().__init__(**kwargs)
 
     def extendMarkdown(self, md: Any) -> None:
@@ -133,6 +168,7 @@ class TreeviewExtension(Extension):
                     self._css_output_path,
                     self._icon_mode,
                     ICONS_PKG_DIR,
+                    manifest_path=self._manifest_path,
                 ),
                 "treeview_css",
                 # Priority 0: run last, after all HTML is finalised.

{mkdocs_treeview-0.1.0 → mkdocs_treeview-0.2.1}/pyproject.toml

@@ -4,16 +4,42 @@ build-backend = "hatchling.build"
 
 [project]
 name = "mkdocs-treeview"
-version = "0.1.0"
+version = "0.2.1"
 description = "MkDocs plugin and Markdown extension for rendering ASCII file trees with material icons"
 readme = "README.md"
 license = { file = "LICENSE" }
 requires-python = ">=3.9"
+authors = [
+    { name = "Lasse Knudsen" },
+]
+keywords = ["mkdocs", "mkdocs-plugin", "markdown", "treeview", "icons", "material-icons"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Documentation",
+    "Topic :: Software Development :: Documentation",
+    "Topic :: Text Processing :: Markup :: HTML",
+]
 dependencies = [
-    "mkdocs>=1.5",
     "markdown>=3.4",
 ]
 
+[project.urls]
+Homepage = "https://github.com/lknudsen/markdown-treeview"
+Repository = "https://github.com/lknudsen/markdown-treeview"
+Issues = "https://github.com/lknudsen/markdown-treeview/issues"
+Changelog = "https://github.com/lknudsen/markdown-treeview/blob/main/CHANGELOG.md"
+
+[project.optional-dependencies]
+mkdocs = ["mkdocs>=1.5"]
+
 [project.entry-points."mkdocs.plugins"]
 treeview = "mkdocs_treeview.plugin:TreeviewPlugin"
 

mkdocs_treeview-0.2.1/tests/demos/zensical/docs/extra.md

@@ -0,0 +1,5 @@
+# Extra
+
+```treeview
+└── main.rs
+```

mkdocs_treeview-0.2.1/tests/demos/zensical/docs/index.md

@@ -0,0 +1,3 @@
+# Home
+
+See [Treeview](treeview.md) and [Extra](extra.md).

{mkdocs_treeview-0.1.0 → mkdocs_treeview-0.2.1}/tests/demos/zensical/docs/stylesheets/treeview.css

@@ -11,6 +11,7 @@
   background-size: contain;
 }
 
+.tv-icon-rust { background-image: url('data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAzMiAzMiI+PHBhdGggZmlsbD0iI2ZmNzA0MyIgZD0ibTMwIDEyLTQtMlY2aC00bC0yLTQtNCAyLTQtMi0yIDRINnY0bC00IDIgMiA0LTIgNCA0IDJ2NGg0bDIgNCA0LTIgNCAyIDItNGg0di00bDQtMi0yLTRaTTYgMTZhOS45IDkuOSAwIDAgMSAuODQyLTRIMTB2OEg2Ljg0MkE5LjkgOS45IDAgMCAxIDYgMTZtMTAgMTBhOS45OCA5Ljk4IDAgMCAxLTcuOTc4LTRIMTZ2LTJoLTJ2LTJoNGMuODE5LjgxOS4yOTcgMi4zMDggMS4xNzkgMy4zN2ExLjg5IDEuODkgMCAwIDAgMS40Ni42M2gzLjM0QTkuOTggOS45OCAwIDAgMSAxNiAyNm0tMi0xMnYtMmg0YTEgMSAwIDAgMSAwIDJabTExLjE1OCA2SDI0YTIuMDA2IDIuMDA2IDAgMCAxLTItMiAyIDIgMCAwIDAtMi0yIDMgMyAwIDAgMCAzLTNxMC0uMDgtLjAwNC0uMTYxQTMuMTE1IDMuMTE1IDAgMCAwIDE5LjgzIDEwSDguMDIyYTkuOTg2IDkuOTg2IDAgMCAxIDE3LjEzNiAxMCIvPjwvc3ZnPg=='); }
 .tv-icon-folder-src-open { background-image: url('data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAzMiAzMiI+PHBhdGggZmlsbD0iIzRjYWY1MCIgZD0iTTI4Ljk2NyAxMkg5LjQ0MmEyIDIgMCAwIDAtMS44OTggMS4zNjhMNCAyNFYxMGgyNGEyIDIgMCAwIDAtMi0ySDE1LjEyNGEyIDIgMCAwIDEtMS4yOC0uNDY0bC0xLjI4OC0xLjA3MkEyIDIgMCAwIDAgMTEuMjc2IDZINGEyIDIgMCAwIDAtMiAydjE2YTIgMiAwIDAgMCAyIDJoMjJsNC44MDUtMTEuMjEyQTIgMiAwIDAgMCAyOC45NjcgMTIiLz48cGF0aCBmaWxsPSIjYzhlNmM5IiBkPSJNMTguNDczIDMwYTEgMSAwIDAgMS0uMjM4LS4wMjggMS4xMzcgMS4xMzcgMCAwIDEtLjgyOC0xLjMyM0wyMC41IDEyLjkwNWExLjEzIDEuMTMgMCAwIDEgLjUwNy0uNzQ0IDEuMDYgMS4wNiAwIDAgMSAuOC0uMTM0IDEuMTQgMS4xNCAwIDAgMSAuODI4IDEuMzI0bC0zLjEwMSAxNS43NDRhMS4xMiAxLjEyIDAgMCAxLS41MDQuNzQzIDEuMDYgMS4wNiAwIDAgMS0uNTU3LjE2Mm02LjItMmgtLjA3N2ExLjA4IDEuMDggMCAwIDEtLjc2Mi0uNDEyIDEuMTY0IDEuMTY0IDAgMCAxIC4xMTMtMS41NDhsNS4zMTktNC45NjctNS4yOTYtNC42MjNhMS4xNjUgMS4xNjUgMCAwIDEtLjE2Mi0xLjU0NCAxLjA4IDEuMDggMCAwIDEgLjc1NC0uNDM3IDEuMDYgMS4wNiAwIDAgMSAuODEuMjU4bDYuMjQ0IDUuNDU1YTEuMTU2IDEuMTU2IDAgMCAxIC4wMDMgMS43MjNsLTYuMjE4IDUuODA4YTEuMDcgMS4wNyAwIDAgMS0uNzI5LjI4OVptLTkuMzEgMGExLjA3IDEuMDcgMCAwIDEtLjcyOC0uMjkybC02LjIyNi01LjgxMWExLjE2IDEuMTYgMCAwIDEtLjAxLTEuNjkybC4wMi0uMDE4IDYuMjQ2LTUuNDU0YTEuMDMgMS4wMyAwIDAgMSAuOC0uMjYgMS4wOCAxLjA4IDAgMCAxIC43Ni40MzYgMS4xNjUgMS4xNjUgMCAwIDEtLjE2IDEuNTQ3bC01LjI5NCA0LjYyIDUuMzIgNC45NjRhMS4xNTYgMS4xNTYgMCAwIDEgLjExMiAxLjU0OCAxLjA3IDEuMDcgMCAwIDEtLjc2Mi40MTJaIi8+PC9zdmc+'); }
 .tv-icon-python { background-image: url('data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0iIzAyODhkMSIgZD0iTTkuODYgMkEyLjg2IDIuODYgMCAwIDAgNyA0Ljg2djEuNjhoNC4yOWMuMzkgMCAuNzEuNTcuNzEuOTZINC44NkEyLjg2IDIuODYgMCAwIDAgMiAxMC4zNnYzLjc4MWEyLjg2IDIuODYgMCAwIDAgMi44NiAyLjg2aDEuMTh2LTIuNjhhMi44NSAyLjg1IDAgMCAxIDIuODUtMi44Nmg1LjI1YzEuNTggMCAyLjg2LTEuMjcxIDIuODYtMi44NTFWNC44NkEyLjg2IDIuODYgMCAwIDAgMTQuMTQgMnptLS43MiAxLjYxYy40IDAgLjcyLjEyLjcyLjcxcy0uMzIuODkxLS43Mi44OTFjLS4zOSAwLS43MS0uMy0uNzEtLjg5cy4zMi0uNzExLjcxLS43MTEiLz48cGF0aCBmaWxsPSIjZmRkODM1IiBkPSJNMTcuOTU5IDd2Mi42OGEyLjg1IDIuODUgMCAwIDEtMi44NSAyLjg1OUg5Ljg2QTIuODUgMi44NSAwIDAgMCA3IDE1LjM4OXYzLjc1YTIuODYgMi44NiAwIDAgMCAyLjg2IDIuODZoNC4yOEEyLjg2IDIuODYgMCAwIDAgMTcgMTkuMTR2LTEuNjhoLTQuMjkxYy0uMzkgMC0uNzA5LS41Ny0uNzA5LS45Nmg3LjE0QTIuODYgMi44NiAwIDAgMCAyMiAxMy42NFY5Ljg2QTIuODYgMi44NiAwIDAgMCAxOS4xNCA3ek04LjMyIDExLjUxM2wtLjAwNC4wMDQuMDM4LS4wMDR6bTYuNTQgNy4yNzZjLjM5IDAgLjcxLjMuNzEuODlhLjcxLjcxIDAgMCAxLS43MS43MWMtLjQgMC0uNzItLjEyLS43Mi0uNzFzLjMyLS44OS43Mi0uODkiLz48L3N2Zz4='); }
 .tv-icon-folder-test-open { background-image: url('data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAzMiAzMiI+PHBhdGggZmlsbD0iIzAwYmZhNSIgZD0iTTI4Ljk2NyAxMkg5LjQ0MmEyIDIgMCAwIDAtMS44OTggMS4zNjhMNCAyNFYxMGgyNGEyIDIgMCAwIDAtMi0ySDE1LjEyNGEyIDIgMCAwIDEtMS4yOC0uNDY0bC0xLjI4OC0xLjA3MkEyIDIgMCAwIDAgMTEuMjc2IDZINGEyIDIgMCAwIDAtMiAydjE2YTIgMiAwIDAgMCAyIDJoMjJsNC44MDUtMTEuMjEyQTIgMiAwIDAgMCAyOC45NjcgMTIiLz48cGF0aCBmaWxsPSIjYTdmZmViIiBkPSJNMTYgMTJ2MmgydjEyYTQgNCAwIDAgMCA4IDBWMTRoMnYtMlptNSAxNGExIDEgMCAxIDEgMS0xIDEgMSAwIDAgMS0xIDFtMi00YTEgMSAwIDEgMSAxLTEgMSAxIDAgMCAxLTEgMW0xLTRoLTR2LTRoNFoiLz48L3N2Zz4='); }

{mkdocs_treeview-0.1.0 → mkdocs_treeview-0.2.1}/tests/integration/test_build_demos.py

@@ -150,8 +150,15 @@ def zensical_demo() -> Path:
     docs = root / "docs"
     docs.mkdir()
     (docs / "treeview.md").write_text(TREEVIEW_MD, encoding="utf-8")
-    # Zensical requires at least an index page
-    (docs / "index.md").write_text("# Home\n\nSee [Treeview](treeview.md).\n", encoding="utf-8")
+    # Second page with a distinct icon (Rust) not present on treeview.md.
+    # Proves the CSS accumulates icons across pages instead of only keeping
+    # the last page's icons.
+    (docs / "extra.md").write_text(
+        "# Extra\n\n```treeview\n└── main.rs\n```\n", encoding="utf-8"
+    )
+    (docs / "index.md").write_text(
+        "# Home\n\nSee [Treeview](treeview.md) and [Extra](extra.md).\n", encoding="utf-8"
+    )
 
     (root / "zensical.toml").write_text(
         textwrap.dedent("""\
@@ -199,10 +206,22 @@ def test_zensical_demo_css_linked_in_html(zensical_demo: Path):
 
 
 def test_zensical_demo_css_is_lean(zensical_demo: Path):
-    """Generated CSS contains only the icons actually used (dynamic, not 1.3 MB)."""
+    """Generated CSS contains only the icons actually used (dynamic, not 1.3 MB).
+
+    The manifest lives in .cache/ (a build artifact, not part of the served site).
+    The CSS itself stays in docs/stylesheets/ where extra_css points to it.
+    """
     css_path = zensical_demo / "docs" / "stylesheets" / "treeview.css"
     assert css_path.exists(), "treeview.css not written — TreeviewCSSPostprocessor did not run"
 
+    manifest_path = zensical_demo / ".cache" / "treeview.manifest.json"
+    assert manifest_path.exists(), (
+        ".cache/treeview.manifest.json not written — manifest should be in .cache/, not docs/"
+    )
+    assert not (zensical_demo / "docs" / "stylesheets" / "treeview.css.manifest.json").exists(), (
+        "manifest must not appear in docs/ — it should be in .cache/"
+    )
+
     css = css_path.read_text(encoding="utf-8")
 
     # Embedded mode: base64 data URIs
@@ -212,7 +231,13 @@ def test_zensical_demo_css_is_lean(zensical_demo: Path):
     for cls in EXPECTED_ICONS:
         assert cls in css, f"expected icon class '{cls}' missing from CSS"
 
-    # Sanity: file is small — only 6 icons, not 1120
+    # Icon from extra.md (second page) must also be present — proves the
+    # registry accumulates icons across all pages, not just the last one.
+    assert "tv-icon-rust" in css, (
+        "Rust icon (from extra.md) missing — CSS only contains last page's icons"
+    )
+
+    # Sanity: file is small — only ~7 icons, not 1120
     size = css_path.stat().st_size
     assert size < 50_000, (
         f"CSS is {size} bytes — looks like all icons were embedded instead of only used ones"

{mkdocs_treeview-0.1.0 → mkdocs_treeview-0.2.1}/tests/integration/test_zensical.py

@@ -142,6 +142,57 @@ def test_zensical_multiple_trees_in_one_page(zensical_config):
     assert "beta.py" in html
 
 
+def test_zensical_css_accumulates_icons_across_multiple_pages(tmp_path: Path):
+    """CSS file must contain icons from ALL pages, not just the last one rendered.
+
+    Simulates the real zensical.toml production path: extension loaded as a
+    module string so Python-Markdown calls makeExtension() — and therefore
+    creates a fresh IconRegistry — on every page render.  The fix requires
+    that the registry survive across pages so that the CSS written after page N
+    contains every icon seen from page 1 through page N.
+    """
+    import zensical.config as zc
+
+    from mkdocs_treeview.extension import TreeviewExtension
+
+    css_path = tmp_path / "treeview.css"
+    docs = tmp_path / "docs"
+    docs.mkdir()
+    (docs / "index.md").write_text("# placeholder", encoding="utf-8")
+    (tmp_path / "mkdocs.yml").write_text("site_name: Test\n", encoding="utf-8")
+
+    zc.parse_mkdocs_config(str(tmp_path / "mkdocs.yml"))
+    config = zc.get_config()
+
+    # Load the extension as a string — exactly what zensical.toml does.
+    # This means Python-Markdown calls makeExtension() on each render() call,
+    # giving each page its own fresh IconRegistry unless we persist state.
+    config["markdown_extensions"] = [
+        e for e in config["markdown_extensions"] if not isinstance(e, TreeviewExtension)
+    ]
+    config["markdown_extensions"].append("mkdocs_treeview.extension")
+    config["mdx_configs"]["mkdocs_treeview.extension"] = {
+        "css_output_path": str(css_path),
+        "icon_mode": "embedded",
+        "manifest_path": str(tmp_path / ".cache" / "treeview.manifest.json"),
+    }
+
+    from zensical.markdown.render import render
+
+    # Page 1: Python file
+    render("```treeview\n└── main.py\n```", "page1.md", "/page1/")
+    # Page 2: TypeScript file (different icon, different registry if bug is present)
+    render("```treeview\n└── app.ts\n```", "page2.md", "/page2/")
+
+    assert css_path.exists(), "CSS file was not written"
+    css = css_path.read_text(encoding="utf-8")
+
+    # Both pages' icons must be present; if page-1 icons are missing the
+    # registry was reset on page 2 (the bug).
+    assert "tv-icon-python" in css, "Python icon missing from CSS — page 1 icons were lost"
+    assert "tv-icon-typescript" in css, "TypeScript icon missing — page 2 icons absent"
+
+
 def test_zensical_plain_markdown_unaffected(zensical_config):
     """Regular Markdown outside treeview fences is unaffected by the extension."""
     from zensical.markdown.render import render

mkdocs_treeview-0.1.0/tests/demos/zensical/docs/index.md

@@ -1,3 +0,0 @@
-# Home
-
-See [Treeview](treeview.md).