Detect and auto-rename duplicate cell names before writing

.github/workflows/coverage.yml

@@ -23,6 +23,10 @@ jobs:
         run: |
           DEBIAN_FRONTEND=noninteractive sudo apt install graphviz graphviz-dev
       - uses: actions/checkout@v6
+        with:
+          submodules: recursive
+          ssh-key: ${{ secrets.SUBMODULE_SSH_KEY }}
+          persist-credentials: false
       - uses: astral-sh/setup-uv@v7
         with:
           python-version: ${{ matrix.python-version }}

.github/workflows/docs.yml

@@ -28,5 +28,14 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
       - uses: extractions/setup-just@v4
-      - name: Test coverage
+      - name: Cache executed notebooks
+        uses: actions/cache@v5
+        with:
+          path: |
+            docs/.build-cache
+            docs/source-built
+          key: docs-source-built-${{ matrix.python-version }}-${{ hashFiles('docs/source/**/*.py', 'docs/source/**/*.md', 'src/kfactory/**/*.py', 'docs/scripts/build_docs_source.py') }}
+          restore-keys: |
+            docs-source-built-${{ matrix.python-version }}-
+      - name: Build docs
         run: just docs

.github/workflows/pages.yml

@@ -1,46 +1,66 @@
 name: docs to gh-pages
 
+# Multi-version deployment via mike (zensical fork, installed at runtime via --with):
+#   push to main      → `dev` version       (always tracks latest main)
+#   push to vX.Y.Z    → `<X.Y.Z>` version + `latest` alias (set as default)
+#
+# Pre-existing v2.5.x version dirs on gh-pages stay intact — mike only
+# rewrites the version it's deploying plus versions.json + the alias target.
+#
+# Requires: GitHub Pages source set to "Deploy from a branch" → gh-pages
+# (one-time switch in repo Settings → Pages).
+
 on:
   push:
-    # branches:
-    #   - main
+    branches:
+      - main
     tags:
       - "v[0-9]+.[0-9]+.[0-9]+*"
   workflow_dispatch:
 
+permissions:
+  contents: write   # mike pushes to gh-pages
+
+concurrency:
+  group: docs-deploy
+  cancel-in-progress: false
+
 jobs:
-  build-docs:
+  deploy:
     runs-on: ubuntu-latest
-    name: build docs
     steps:
       - name: Install graphviz
         shell: bash -l {0}
         run: |
           DEBIAN_FRONTEND=noninteractive sudo apt install graphviz graphviz-dev
+
       - uses: actions/checkout@v6
-      - uses: astral-sh/setup-uv@v7
         with:
-          python-version: ${{ matrix.python-version }}
+          fetch-depth: 0   # mike needs full history of gh-pages
+
+      - uses: astral-sh/setup-uv@v7
       - uses: extractions/setup-just@v4
-      - name: Test coverage
-        run: just docs
-      - uses: actions/upload-pages-artifact@v5
+
+      - name: Cache executed notebooks
+        uses: actions/cache@v5
         with:
-          name: github-pages
-          path: "./docs/site/"
+          path: |
+            docs/.build-cache
+            docs/source-built
+          key: docs-source-built-3.14-${{ hashFiles('docs/source/**/*.py', 'docs/source/**/*.md', 'src/kfactory/**/*.py', 'docs/scripts/build_docs_source.py') }}
+          restore-keys: |
+            docs-source-built-3.14-
 
-  deploy-docs:
-    needs: build-docs
-    permissions:
-      pages: write
-      id-token: write
+      - name: Configure git for mike
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git fetch origin gh-pages --depth=1 || echo "no gh-pages branch yet"
 
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
+      - name: Deploy main → dev version
+        if: github.ref == 'refs/heads/main'
+        run: just docs-deploy-dev
 
-    runs-on: ubuntu-latest
-    steps:
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v5
+      - name: Deploy tagged release → <version> + latest alias
+        if: startsWith(github.ref, 'refs/tags/v')
+        run: just docs-deploy-release "${GITHUB_REF#refs/tags/v}"

.github/workflows/release-drafter.yml

@@ -12,13 +12,16 @@ permissions:
 
 jobs:
   update_release_draft:
+    if: github.event_name == 'push' || github.base_ref == 'main'
     permissions:
       contents: write
       pull-requests: write
     runs-on: ubuntu-latest
     steps:
       # Drafts your next Release notes as Pull Requests are merged into "master"
       - uses: release-drafter/release-drafter@v7
+        with:
+          commitish: main
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
   require_label:

.github/workflows/release.yml

@@ -7,6 +7,7 @@ on:
 jobs:
   release_pypi:
     runs-on: ubuntu-latest
+    environment: pypi
     steps:
       - uses: actions/checkout@v6
 

.github/workflows/test.yml

@@ -16,12 +16,19 @@ jobs:
       fail-fast: false
       matrix:
         python-version:
-          - "3.11"
           - "3.12"
           - "3.13"
+          - "3.14"
         os: [ubuntu-latest, windows-latest, macos-latest]
+        exclude: # TODO: remove once klayout wheels are generated
+          - os: windows-latest
+            python-version: "3.14"
     steps:
       - uses: actions/checkout@v6
+        with:
+          submodules: recursive
+          ssh-key: ${{ secrets.SUBMODULE_SSH_KEY }}
+          persist-credentials: false
       - uses: astral-sh/setup-uv@v7
       - uses: extractions/setup-just@v4
       - name: Install dependencies
@@ -38,11 +45,19 @@ jobs:
     strategy:
       matrix:
         python-version:
-          - "3.11"
+          - "3.12"
           - "3.13"
+          - "3.14"
         os: [ubuntu-latest, windows-latest, macos-latest]
+        exclude: # TODO: remove once klayout wheels are generated
+          - os: windows-latest
+            python-version: "3.14"
     steps:
       - uses: actions/checkout@v6
+        with:
+          submodules: recursive
+          ssh-key: ${{ secrets.SUBMODULE_SSH_KEY }}
+          persist-credentials: false
       - uses: astral-sh/setup-uv@v7
       - uses: extractions/setup-just@v4
       - name: Install dependencies

.gitignore

@@ -6,7 +6,20 @@
 .idea
 Pipfile
 docs/_build/
+docs/source-built/
+docs/.build-cache/
 site/
+demo_geometry.gds
+# Logo is regenerated by docs/scripts/gen_logo.py during the docs build
+# (Stage 4 of build_docs_source.py); the staged copy lives in
+# docs/source-built/_static/ which is already ignored above. If the
+# generator is run standalone with --out-dir docs/source/_static the
+# stray copies land here — keep them out of git.
+docs/source/_static/logo.gds
+docs/source/_static/logo.svg
+# Spliced zensical config — built from docs/zensical.yml + the
+# auto-generated API nav by docs/scripts/build_docs_source.py.
+docs/zensical-built.yml
 
 # Packages
 *.egg
@@ -49,3 +62,6 @@ demo.gds
 *.prof
 *.obtained.oas
 *.obtained.gds
+*.obtained.gds.gz
+*.obtained.yml
+*.obtained.yaml

.gitmodules

@@ -1,4 +1,8 @@
 [submodule "tests/gdsfactory-yaml-pics"]
 	path = tests/gdsfactory-yaml-pics
-	url = https://github.com/gdsfactory/gdsfactory.git
+	url = git@github.com:/gdsfactory/gdsfactory.git
+	branch = main
+[submodule "tests/test_data"]
+	path = tests/test_data
+	url = git@github.com:gdsfactory/kfactory-test-data.git
 	branch = main

.pre-commit-config.yaml

@@ -7,7 +7,10 @@ repos:
       - id: check-merge-conflict
       - id: check-symlinks
       - id: check-yaml
-        args: []
+        # mkdocs.yml uses Material's `!!python/name:` tag for the
+        # pymdownx.emoji index/generator; pyyaml's safe loader can't
+        # resolve that, so the safe-loader check would fail.
+        args: ["--unsafe"]
       - id: debug-statements
       - id: end-of-file-fixer
         exclude: 'changelog\.d/.*|CHANGLEOG\.md'
@@ -21,45 +24,63 @@ repos:
         exclude: 'changelog\.d/.*|CHANGELOG\.md'
   - repo: https://github.com/astral-sh/ruff-pre-commit
     # Ruff version.
-    rev: v0.14.13
+    rev: v0.15.17
     hooks:
       # Run the linter.
-      - id: ruff
+      - id: ruff-check
+        args: [ --fix ]
       # Run the formatter.
       - id: ruff-format
+  - repo: https://github.com/tox-dev/pyproject-fmt
+    rev: v2.24.0
+    hooks:
+      - id: pyproject-fmt
   - repo: https://github.com/kynan/nbstripout
-    rev: 0.9.0
+    rev: 0.9.1
     hooks:
       - id: nbstripout
         files: .ipynb
 
   - repo: https://github.com/codespell-project/codespell
-    rev: v2.4.1
+    rev: v2.4.2
     hooks:
       - id: codespell
         additional_dependencies:
           - tomli
   - repo: https://github.com/PyCQA/bandit
-    rev: 1.9.3
+    rev: 1.9.4
     hooks:
       - id: bandit
         args: [--exit-zero]
         # ignore all tests, not just tests data
         exclude: ^tests/
-  - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: "v1.19.1" # Use the sha / tag you want to point at
+  - repo: local
     hooks:
-      - id: mypy
-        args: [--ignore-missing-imports, --strict, --config-file=pyproject.toml]
+      - id: ty
+        name: ty check
+        entry: uvx --with-editable .[dev] ty check .
+        language: python
         additional_dependencies:
+          - uv
+          - aenum
           - pydantic
+          - pydantic-extra-types
           - numpy
           - pytest
-          - "klayout>=0.30"
+          - pytest-regressions
+          - "klayout>=0.30.8"
+          - "kfnetlist>=0.2.0"
           - types-cachetools
           - loguru
           - pydantic-settings
           - typer
           - types-PyYAML
           - scipy
-        exclude: ^docs/|^tests/
+          - "ruamel.yaml"
+          - ruamel.yaml.string
+          - toolz
+          - rapidfuzz
+          - rectangle-packer
+          - semver
+          - pygit2
+        pass_filenames: false