mkdocs-terok 0.5.6__tar.gz

mkdocs_terok-0.5.6/LICENSE

@@ -0,0 +1,5 @@
+Copyright © 2026 by Jiří Vyskočil <jiri@vyskocil.com>
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

mkdocs_terok-0.5.6/LICENSES/0BSD.txt

@@ -0,0 +1,5 @@
+Copyright © 2026 by Jiří Vyskočil <jiri@vyskocil.com>
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

mkdocs_terok-0.5.6/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: mkdocs-terok
+Version: 0.5.6
+Summary: Shared ProperDocs documentation generators for terok projects
+License: 0BSD
+License-File: LICENSE
+License-File: LICENSES/0BSD.txt
+Keywords: properdocs,mkdocs,documentation,quality-report,ci-map
+Author: Jiri Vyskocil
+Author-email: jiri@vyskocil.com
+Maintainer: Jiri Vyskocil
+Maintainer-email: jiri@vyskocil.com
+Requires-Python: >=3.12,<4.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Framework :: MkDocs
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Documentation
+Classifier: Typing :: Typed
+Requires-Dist: PyYAML (>=6.0)
+Requires-Dist: properdocs (>=1.6.7)
+Project-URL: Changelog, https://github.com/terok-ai/mkdocs-terok/releases
+Project-URL: Documentation, https://terok-ai.github.io/mkdocs-terok/
+Project-URL: Homepage, https://terok.ai/
+Project-URL: Issues, https://github.com/terok-ai/mkdocs-terok/issues
+Project-URL: Repository, https://github.com/terok-ai/mkdocs-terok
+Project-URL: Security, https://github.com/terok-ai/mkdocs-terok/security/policy
+Description-Content-Type: text/markdown
+
+# mkdocs-terok
+
+[![License: 0BSD](https://img.shields.io/badge/License-0BSD-green.svg)](https://opensource.org/license/0bsd)
+[![REUSE](https://api.reuse.software/badge/github.com/terok-ai/mkdocs-terok)](https://api.reuse.software/info/github.com/terok-ai/mkdocs-terok)
+[![codecov](https://codecov.io/gh/terok-ai/mkdocs-terok/graph/badge.svg)](https://codecov.io/gh/terok-ai/mkdocs-terok)
+
+Shared [ProperDocs](https://properdocs.org/) documentation generators for terok projects.
+
+Provides reusable modules for generating CI workflow maps, integration test maps,
+code quality reports, API reference pages, and config reference documentation from
+Pydantic models. A built-in `terok` ProperDocs plugin drives all generators
+automatically; the generator modules themselves never import the doc engine and can
+also be used standalone via `mkdocs-gen-files` shims.
+
+The quality report module can optionally parse output from
+[scc](https://github.com/boyter/scc),
+[complexipy](https://github.com/rohaquinern/complexipy),
+[tach](https://github.com/gauge-sh/tach),
+[vulture](https://github.com/jendrikseipp/vulture), and
+[docstr-coverage](https://github.com/HunterMcGushion/docstr_coverage).
+When any of these tools is absent, the corresponding report section degrades
+gracefully to a warning admonition.
+
+## Installation
+
+Add to your project's `pyproject.toml` as a docs-build dependency:
+
+```toml
+[tool.poetry.group.docs.dependencies]
+mkdocs-terok = "^0.5"
+```
+
+## License
+
+[0BSD](https://opensource.org/license/0bsd) — use freely, no strings attached.
+

mkdocs_terok-0.5.6/README.md

@@ -0,0 +1,35 @@
+# mkdocs-terok
+
+[![License: 0BSD](https://img.shields.io/badge/License-0BSD-green.svg)](https://opensource.org/license/0bsd)
+[![REUSE](https://api.reuse.software/badge/github.com/terok-ai/mkdocs-terok)](https://api.reuse.software/info/github.com/terok-ai/mkdocs-terok)
+[![codecov](https://codecov.io/gh/terok-ai/mkdocs-terok/graph/badge.svg)](https://codecov.io/gh/terok-ai/mkdocs-terok)
+
+Shared [ProperDocs](https://properdocs.org/) documentation generators for terok projects.
+
+Provides reusable modules for generating CI workflow maps, integration test maps,
+code quality reports, API reference pages, and config reference documentation from
+Pydantic models. A built-in `terok` ProperDocs plugin drives all generators
+automatically; the generator modules themselves never import the doc engine and can
+also be used standalone via `mkdocs-gen-files` shims.
+
+The quality report module can optionally parse output from
+[scc](https://github.com/boyter/scc),
+[complexipy](https://github.com/rohaquinern/complexipy),
+[tach](https://github.com/gauge-sh/tach),
+[vulture](https://github.com/jendrikseipp/vulture), and
+[docstr-coverage](https://github.com/HunterMcGushion/docstr_coverage).
+When any of these tools is absent, the corresponding report section degrades
+gracefully to a warning admonition.
+
+## Installation
+
+Add to your project's `pyproject.toml` as a docs-build dependency:
+
+```toml
+[tool.poetry.group.docs.dependencies]
+mkdocs-terok = "^0.5"
+```
+
+## License
+
+[0BSD](https://opensource.org/license/0bsd) — use freely, no strings attached.

mkdocs_terok-0.5.6/pyproject.toml

@@ -0,0 +1,134 @@
+[build-system]
+requires = ["poetry-core>=1.9.0", "poetry-dynamic-versioning>=1.0.0,<2.0.0"]
+build-backend = "poetry_dynamic_versioning.backend"
+
+[tool.poetry]
+name = "mkdocs-terok"
+version = "0.5.6"
+description = "Shared ProperDocs documentation generators for terok projects"
+readme = "README.md"
+license = "0BSD"
+authors = ["Jiri Vyskocil <jiri@vyskocil.com>"]
+keywords = ["properdocs", "mkdocs", "documentation", "quality-report", "ci-map"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Framework :: MkDocs",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: BSD License",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python",
+    "Topic :: Documentation",
+    "Typing :: Typed",
+]
+
+packages = [
+  { include = "mkdocs_terok", from = "src" },
+]
+
+include = [
+  { path = "src/mkdocs_terok/_assets/*.css" },
+  { path = "src/mkdocs_terok/_assets/*.js" },
+]
+maintainers = ["Jiri Vyskocil <jiri@vyskocil.com>"]
+homepage = "https://terok.ai/"
+repository = "https://github.com/terok-ai/mkdocs-terok"
+documentation = "https://terok-ai.github.io/mkdocs-terok/"
+
+[tool.poetry.dependencies]
+python = ">=3.12,<4.0"
+PyYAML = ">=6.0"
+properdocs = ">=1.6.7"
+
+[tool.poetry.plugins."mkdocs.plugins"]
+terok = "mkdocs_terok.plugin:TerokPlugin"
+
+[tool.poetry.group.dev.dependencies]
+ruff = ">=0.8"
+docstr-coverage = "^2.3.2"
+vulture = ">=2.12"
+reuse = "^6.2.0"
+
+[tool.poetry.group.test.dependencies]
+pytest = ">=7.0"
+pytest-cov = ">=4.0"
+pydantic = ">=2.6"
+
+
+[tool.poetry.urls]
+Issues = "https://github.com/terok-ai/mkdocs-terok/issues"
+Changelog = "https://github.com/terok-ai/mkdocs-terok/releases"
+Security = "https://github.com/terok-ai/mkdocs-terok/security/policy"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*", "*Tests"]
+python_functions = ["test_*"]
+addopts = "-v --tb=short"
+
+[tool.poetry.group.docs]
+optional = true
+
+[tool.poetry.group.docs.dependencies]
+mkdocs-material = ">=9.7.6"
+mkdocs-gen-files = ">=0.5"
+mkdocs-literate-nav = ">=0.6"
+mkdocstrings = {version = ">=0.26", extras = ["python"]}
+pydantic = ">=2.6"
+complexipy = ">=5.0"
+tach = ">=0.34"
+
+[tool.ruff]
+target-version = "py312"
+line-length = 100
+src = ["src", "tests", "docs"]
+
+[tool.ruff.lint]
+select = [
+  "E",      # pycodestyle errors
+  "W",      # pycodestyle warnings
+  "F",      # pyflakes
+  "I",      # isort
+  "B",      # flake8-bugbear
+  "C4",     # flake8-comprehensions
+  "UP",     # pyupgrade
+  "SIM",    # flake8-simplify
+]
+ignore = [
+  "E501",   # line too long (handled by formatter)
+  "B904",   # raise from in except
+  "SIM102", # nested if statements
+  "SIM105", # contextlib.suppress vs try/except/pass
+  "SIM108", # use ternary operator
+  "SIM117", # nested with statements
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["E402"]
+"docs/**" = ["E402"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["mkdocs_terok"]
+combine-as-imports = true
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+docstring-code-format = true
+
+[tool.coverage.run]
+source = ["mkdocs_terok"]
+relative_files = true
+
+[tool.coverage.xml]
+output = "reports/coverage.xml"
+
+[tool.poetry-dynamic-versioning]
+enable = false
+vcs = "git"
+pattern = "^v(?P<base>\\d+\\.\\d+\\.\\d+)$"
+style = "pep440"
+
+[tool.poetry-dynamic-versioning.substitution]
+folders = [{path = "src"}]

mkdocs_terok-0.5.6/src/mkdocs_terok/__init__.py

@@ -0,0 +1,26 @@
+# SPDX-FileCopyrightText: 2026 Jiri Vyskocil
+# SPDX-License-Identifier: 0BSD
+
+"""Shared ProperDocs documentation generators for terok projects.
+
+Provides reusable modules for CI maps, test maps, quality reports,
+API reference pages, and Pydantic config reference rendering.
+The ``terok`` ProperDocs plugin wraps all generators; individual modules
+remain usable standalone (they never import properdocs themselves).
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+__version__ = "0.5.6"  # managed by poetry-dynamic-versioning
+
+
+def brand_css_path() -> Path:
+    """Return the filesystem path to the shared brand CSS file."""
+    return Path(__file__).parent / "_assets" / "extra.css"
+
+
+def mermaid_zoom_js_path() -> Path:
+    """Return the filesystem path to the Mermaid diagram zoom script."""
+    return Path(__file__).parent / "_assets" / "mermaid_zoom.js"

mkdocs_terok-0.5.6/src/mkdocs_terok/_assets/extra.css

@@ -0,0 +1,211 @@
+/* Black/Red/Gold palette with subdued neutrals. */
+:root {
+  --terok-black: #0b0b0b;
+  --terok-red: #a31219;
+  --terok-red-dark: #7f0f14;
+  --terok-red-pure: #c00000;
+  --terok-red-bright: #e04b3f;
+  --terok-gold: #c79a22;
+  --terok-gold-bright: #d8b454;
+  --terok-gold-link: #7a6200;
+  --terok-red-hover: #8b0000;
+
+  --md-text-font: "Ubuntu", sans-serif;
+  --md-code-font: "Ubuntu Mono", monospace;
+
+  --md-primary-fg-color: var(--terok-red-dark);
+  --md-primary-fg-color--light: #8f1117;
+  --md-primary-fg-color--dark: #650b10;
+
+  --md-primary-bg-color: #f7f2e8;
+  --md-primary-bg-color--light: #f7f2e8;
+  --md-primary-bg-color--dark: #e7decc;
+
+  --md-accent-fg-color: var(--terok-gold);
+  --md-accent-fg-color--transparent: rgba(199, 154, 34, 0.12);
+
+  --md-typeset-a-color: var(--terok-gold-link);
+  --md-typeset-mark-color: var(--terok-gold-bright);
+}
+
+body,
+.md-typeset,
+.md-header,
+.md-tabs,
+.md-nav,
+.md-search__input {
+  font-family: var(--md-text-font);
+}
+
+pre,
+code,
+kbd,
+samp {
+  font-family: var(--md-code-font);
+}
+
+.md-header,
+.md-tabs,
+.md-header__inner,
+.md-tabs__inner {
+  background-color: var(--terok-red-dark) !important;
+}
+
+.md-typeset a,
+.md-typeset a:visited {
+  color: var(--terok-gold-link);
+}
+
+.md-typeset a:hover,
+.md-nav__link:hover,
+.md-tabs__link:hover,
+.md-header__button:hover {
+  color: var(--terok-red-hover) !important;
+}
+
+.md-nav__item--active > .md-nav__link,
+.md-nav__link--active,
+.md-nav--secondary .md-nav__link--active {
+  color: var(--terok-gold-bright) !important;
+}
+
+.md-nav--secondary .md-nav__link--active::before,
+.md-nav--secondary .md-nav__link--active::after {
+  background-color: var(--terok-gold-bright);
+}
+
+.md-nav--secondary .md-nav__link--active {
+  border-left-color: var(--terok-gold-bright);
+}
+
+.md-tabs__link--active {
+  color: inherit !important;
+  font-weight: 700;
+}
+
+#codecov-treemap-img {
+  display: block;
+  min-width: 300px;
+  width: 60%;
+  margin: 0 auto;
+}
+
+[data-md-color-scheme="default"] {
+  --md-primary-fg-color: var(--terok-red-dark);
+  --md-primary-fg-color--light: #8f1117;
+  --md-primary-fg-color--dark: #650b10;
+  --md-default-bg-color: #f7f2e8;
+  --md-default-fg-color: #111111;
+  --md-default-fg-color--light: #2b2b2b;
+  --md-default-fg-color--lighter: #4a4a4a;
+  --md-default-fg-color--lightest: #6a6a6a;
+  --md-code-bg-color: #efe6d6;
+  --md-code-fg-color: #111111;
+  --md-footer-bg-color: #0b0b0b;
+  --md-footer-fg-color: #f7f2e8;
+  --md-footer-fg-color--light: #d9cfbd;
+  --md-footer-fg-color--lighter: #bdb39f;
+  --md-footer-fg-color--lightest: #a79c87;
+  --md-accent-fg-color: var(--terok-gold);
+  --md-accent-fg-color--transparent: rgba(199, 154, 34, 0.12);
+  --md-typeset-a-color: var(--terok-gold-link);
+}
+
+[data-md-color-scheme="slate"] {
+  --md-primary-fg-color: var(--terok-red-dark);
+  --md-primary-fg-color--light: #8f1117;
+  --md-primary-fg-color--dark: #650b10;
+  --md-default-bg-color: #0b0b0b;
+  --md-default-fg-color: #f2ead9;
+  --md-default-fg-color--light: #d8cfbf;
+  --md-default-fg-color--lighter: #bcb4a5;
+  --md-default-fg-color--lightest: #a19a8d;
+  --md-code-bg-color: #151515;
+  --md-code-fg-color: #f2ead9;
+  --md-footer-bg-color: #000000;
+  --md-footer-fg-color: #f2ead9;
+  --md-footer-fg-color--light: #d8cfbf;
+  --md-footer-fg-color--lighter: #bcb4a5;
+  --md-footer-fg-color--lightest: #a19a8d;
+
+  --md-primary-bg-color: #f2ead9;
+  --md-primary-bg-color--light: #f2ead9;
+  --md-primary-bg-color--dark: #d8cfbf;
+
+  --md-accent-fg-color: var(--terok-gold-bright);
+  --md-accent-fg-color--transparent: rgba(216, 180, 84, 0.14);
+  --md-typeset-a-color: var(--terok-gold-bright);
+}
+
+/* ── Mermaid diagram zoom overlay ───────────────────────────── */
+.mermaid-zoom-wrapper {
+  position: relative;
+}
+
+.mermaid-zoom-btn {
+  position: absolute;
+  top: 4px;
+  right: 4px;
+  z-index: 1;
+  padding: 2px 8px;
+  border: 1px solid var(--md-default-fg-color--lightest);
+  border-radius: 4px;
+  background: var(--md-default-bg-color);
+  color: var(--md-default-fg-color--light);
+  font: 0.7rem var(--md-text-font);
+  cursor: pointer;
+}
+
+.mermaid-zoom-overlay {
+  display: none;
+  position: fixed;
+  inset: 0;
+  z-index: 9999;
+  background: rgba(0, 0, 0, 0.75);
+  backdrop-filter: blur(4px);
+}
+
+.mermaid-zoom-overlay.mermaid-zoom-active {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.mermaid-zoom-viewport {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: calc(100vw - 4rem);
+  height: calc(100vh - 4rem);
+  padding: 1rem;
+  border-radius: 8px;
+  background: var(--md-default-bg-color);
+  box-shadow: 0 8px 32px rgba(0, 0, 0, 0.4);
+  overflow: auto;
+}
+
+.mermaid-zoom-viewport svg {
+  max-width: 100%;
+  max-height: 100%;
+}
+
+.mermaid-zoom-close {
+  position: absolute;
+  top: 0.75rem;
+  right: 0.75rem;
+  z-index: 10000;
+  width: 2rem;
+  height: 2rem;
+  border: none;
+  border-radius: 50%;
+  background: var(--terok-red-dark);
+  color: #fff;
+  font-size: 1.1rem;
+  line-height: 1;
+  cursor: pointer;
+  transition: background 0.15s;
+}
+
+.mermaid-zoom-close:hover {
+  background: var(--terok-red);
+}

mkdocs_terok-0.5.6/src/mkdocs_terok/_assets/mermaid_zoom.js

@@ -0,0 +1,128 @@
+// SPDX-FileCopyrightText: 2026 Jiri Vyskocil
+// SPDX-License-Identifier: 0BSD
+
+/**
+ * Adds an "Enlarge" button to each rendered Mermaid diagram.
+ * Clicking it opens the diagram in a fullscreen overlay (lightbox-style).
+ * Close via backdrop click, the X button, or Escape.
+ */
+;(() => {
+  const BUTTON_LABEL = "\u2922 Enlarge"
+
+  // ── Main action ────────────────────────────────────────
+
+  /** Scan the DOM for rendered mermaid SVGs and attach buttons. */
+  function scan() {
+    document.querySelectorAll("pre.mermaid, .mermaid").forEach((el) => {
+      if (el.querySelector("svg") || el.tagName === "SVG") attachButton(el)
+    })
+  }
+
+  /** Wrap a rendered mermaid container and inject the enlarge button. */
+  function attachButton(container) {
+    if (container.dataset.zoomAttached) return
+    container.dataset.zoomAttached = "1"
+
+    const wrapper = document.createElement("div")
+    wrapper.className = "mermaid-zoom-wrapper"
+    container.parentNode.insertBefore(wrapper, container)
+    wrapper.appendChild(container)
+
+    const btn = document.createElement("button")
+    btn.className = "mermaid-zoom-btn"
+    btn.textContent = BUTTON_LABEL
+    btn.addEventListener("click", () => {
+      openOverlay(container.querySelector("svg") ?? container)
+    })
+    container.before(btn)
+  }
+
+  // ── Overlay mechanics ──────────────────────────────────
+
+  function openOverlay(svgSource) {
+    const overlay =
+      document.querySelector(".mermaid-zoom-overlay") || createOverlay()
+    const viewport = overlay.querySelector(".mermaid-zoom-viewport")
+    viewport.innerHTML = ""
+    const clone = svgSource.cloneNode(true)
+    clone.removeAttribute("height")
+    clone.removeAttribute("width")
+    clone.style.maxWidth = "100%"
+    clone.style.maxHeight = "100%"
+    clone.style.width = "auto"
+    clone.style.height = "auto"
+    viewport.appendChild(clone)
+    overlay.classList.add("mermaid-zoom-active")
+    document.addEventListener("keydown", onEscape)
+  }
+
+  function closeOverlay(overlay) {
+    overlay.classList.remove("mermaid-zoom-active")
+    document.removeEventListener("keydown", onEscape)
+  }
+
+  function onEscape(e) {
+    if (e.key === "Escape") {
+      const overlay = document.querySelector(".mermaid-zoom-overlay")
+      if (overlay) closeOverlay(overlay)
+    }
+  }
+
+  /** Build the overlay element (singleton, appended on first use). */
+  function createOverlay() {
+    const overlay = document.createElement("div")
+    overlay.className = "mermaid-zoom-overlay"
+    overlay.addEventListener("click", (e) => {
+      if (e.target === overlay) closeOverlay(overlay)
+    })
+
+    const close = document.createElement("button")
+    close.className = "mermaid-zoom-close"
+    close.textContent = "\u2715"
+    close.title = "Close"
+    close.addEventListener("click", () => closeOverlay(overlay))
+
+    const viewport = document.createElement("div")
+    viewport.className = "mermaid-zoom-viewport"
+
+    overlay.append(close, viewport)
+    document.body.appendChild(overlay)
+    return overlay
+  }
+
+  // ── Initialization ─────────────────────────────────────
+
+  // Initial scan once DOM + mermaid rendering settle.
+  if (document.readyState === "loading") {
+    document.addEventListener("DOMContentLoaded", () => setTimeout(scan, 2000))
+  } else {
+    setTimeout(scan, 2000)
+  }
+
+  // Catch diagrams rendered after initial load (e.g. instant navigation).
+  const observer = new MutationObserver((mutations) => {
+    for (const m of mutations) {
+      for (const node of m.addedNodes) {
+        if (node.nodeType !== 1) continue
+        if (
+          (node.matches?.(".mermaid, pre.mermaid") && node.querySelector("svg")) ||
+          node.querySelector?.(".mermaid svg, pre.mermaid svg") ||
+          (node.tagName === "svg" && node.parentElement?.matches?.(".mermaid, pre.mermaid"))
+        ) {
+          setTimeout(scan, 200)
+          return
+        }
+      }
+    }
+  })
+
+  function startObserver() {
+    observer.observe(document.body, { childList: true, subtree: true })
+  }
+
+  if (document.body) {
+    startObserver()
+  } else {
+    document.addEventListener("DOMContentLoaded", startObserver, { once: true })
+  }
+})()