mkdocs.yml

site_name: IFC-Lite Documentation
site_url: https://ifclite.dev/docs/
site_description: High-performance browser-native IFC platform documentation
site_author: IFC-Lite Contributors
repo_url: https://github.com/LTplus-AG/ifc-lite
repo_name: LTplus-AG/ifc-lite
edit_uri: edit/main/docs/
use_directory_urls: true

theme:
  name: material
  custom_dir: docs/overrides
  logo: assets/logo.png
  # PLANKOPF: Swiss engineering plan-sheet identity, matching ifclite.dev.
  # font:false so Material skips its legacy Fonts API (no variable weights) —
  # docs/overrides/main.html loads variable Archivo + Fragment Mono instead.
  # primary/accent:custom so Material emits no colour rules; the carbon header
  # + Swiss-red accents are fully owned by docs/stylesheets/extra.css.
  font: false
  palette:
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: custom
      accent: custom
      toggle:
        icon: material/brightness-7
        name: Switch to dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: custom
      accent: custom
      toggle:
        icon: material/brightness-4
        name: Switch to light mode
  features:
    - navigation.instant
    - navigation.tracking
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.sections
    - navigation.expand
    - navigation.path
    - navigation.top
    - search.suggest
    - search.highlight
    - content.code.copy
    - content.code.annotate
    - content.tabs.link
  icon:
    repo: fontawesome/brands/github

plugins:
  - search
  - minify:
      minify_html: false

markdown_extensions:
  - abbr
  - admonition
  - attr_list
  - def_list
  - footnotes
  - md_in_html
  - tables
  - toc:
      permalink: true
  - pymdownx.arithmatex:
      generic: true
  - pymdownx.betterem:
      smart_enable: all
  - pymdownx.caret
  - pymdownx.details
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.keys
  - pymdownx.magiclink:
      repo_url_shorthand: false
      user: louistrue
      repo: ifc-lite
      normalize_issue_symbols: true
  - pymdownx.mark
  - pymdownx.smartsymbols
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_div_format
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.tasklist:
      custom_checkbox: true
  - pymdownx.tilde

extra:
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/LTplus-AG/ifc-lite
    - icon: fontawesome/brands/npm
      link: https://www.npmjs.com/org/ifc-lite
  generator: false
  version:
    provider: mike

extra_css:
  - stylesheets/extra.css

extra_javascript:
  - https://unpkg.com/mermaid@10/dist/mermaid.min.js
  - javascripts/mermaid-init.js

nav:
  - Home: index.md
  - Getting Started:
    - Installation: guide/installation.md
    - Quick Start: guide/quickstart.md
    - CLI Toolkit: guide/cli.md
    - MCP for AI Agents: guide/mcp.md
    - 3D Viewer & Analysis: guide/viewer-api.md
    - Server Guide: guide/server.md
    - Building for Desktop: guide/desktop.md
    - Browser Requirements: guide/browser-requirements.md
  - User Guide:
    - Parsing IFC Files: guide/parsing.md
    - Geometry Processing: guide/geometry.md
    - Rendering: guide/rendering.md
    - Querying Data: guide/querying.md
    - Exporting Data: guide/exporting.md
    - Multi-Model Federation: guide/federation.md
    - BCF Collaboration: guide/bcf.md
    - IDS Validation: guide/ids.md
    - 2D Drawings: guide/drawing-2d.md
    - Property Editing: guide/mutations.md
    - Performance: guide/performance.md
    - Error Handling & Integration: guide/error-handling.md
    - Clash Detection: guide/clash-detection.md
    - Model Diff: guide/model-diff.md
    - Real-Time Collaboration: guide/collaboration.md
    - Collab Engine (API): guide/collab.md
    - Collaboration Server: guide/collab-server.md
    - Testing Collaboration: guide/collab-testing.md
    - Lens Visualization: guide/lens.md
    - Lists & Schedules: guide/lists.md
    - Solar Analysis: guide/solar.md
    - Scripting SDK: guide/scripting-sdk.md
  - Customization:
    - Extensions: guide/extensions.md
    - Authoring Extensions: guide/extension-authoring.md
    - Flavors: guide/flavors.md
    - Privacy: guide/privacy.md
  - Architecture:
    - Overview: architecture/overview.md
    - Data Flow: architecture/data-flow.md
    - Parsing Pipeline: architecture/parsing-pipeline.md
    - Geometry Pipeline: architecture/geometry-pipeline.md
    - Rendering Pipeline: architecture/rendering-pipeline.md
    - Coordinate Handling: architecture/coordinate-handling.md
    - Federation: architecture/federation.md
    - Layer PRs:
        - Overview: architecture/layer-prs/index.md
        - Concepts: architecture/layer-prs/01-concepts.md
        - Layer Format: architecture/layer-prs/02-layer-format.md
        - Provenance: architecture/layer-prs/03-provenance.md
        - Identity: architecture/layer-prs/04-identity.md
        - Diff & Merge: architecture/layer-prs/05-merge.md
        - Agents (MCP): architecture/layer-prs/06-agents.md
        - Security: architecture/layer-prs/07-security.md
        - Review Workflow: architecture/layer-prs/08-review.md
        - CLI & CI: architecture/layer-prs/09-cli.md
        - Registry: architecture/layer-prs/10-registry.md
        - Standards & Ecosystem: architecture/layer-prs/11-standards-ecosystem.md
        - Roadmap: architecture/layer-prs/12-roadmap.md
  - API Reference:
    - TypeScript API: api/typescript.md
    - Rust API: api/rust.md
    - WASM Bindings: api/wasm.md
    - Python (PyPI): api/python.md
  - Tutorials:
    - Building a Viewer: tutorials/building-viewer.md
    - Three.js Integration: tutorials/threejs-integration.md
    - Babylon.js Integration: tutorials/babylonjs-integration.md
    - Custom Queries: tutorials/custom-queries.md
    - Extending the Parser: tutorials/extending-parser.md
  - Contributing:
    - Development Setup: contributing/setup.md
    - Testing: contributing/testing.md
    - Release Process: contributing/release.md