Dev

.documentation/SchemaUpdates.md

@@ -1,21 +1,18 @@
 these are the files you must change from the duc repo:
 
-on the typescript side:
-@duc/packages/ducjs/src/types/index.ts 
-@duc/packages/ducjs/src/restore/restoreDataState.ts (and other potential restore files related)
-@duc/packages/ducjs/src/parse.ts 
-@duc/packages/ducjs/src/serialize.ts 
-
 on the rust side:
 @duc/packages/ducrs/src/types.rs 
 @duc/packages/ducrs/src/parse.rs 
 @duc/packages/ducrs/src/serialize.rs 
 
+on the typescript side:
+@duc/packages/ducjs/src/types/index.ts 
+@duc/packages/ducjs/src/restore/restoreDataState.ts (and other potential restore files related)
+
+
 on the python side: 
 @duc/packages/ducpy/src/ducpy/classes/DataStateClass.py 
-@duc/packages/ducpy/src/ducpy/parse.py 
-@duc/packages/ducpy/src/ducpy/serialize.py 
 
 And then run the build (or test commands if available) for each from @duc/package.json 
 
-and in case you need to check the fbs schema or what changed (changes may be git staged): @duc/schema/duc.fbs 
+and in case you need to check the fbs schema or what changed (changes may be git staged): @duc/schema/duc.sql 

.github/workflows/deploy-ducpy-docs.yml

@@ -0,0 +1,69 @@
+name: Deploy Python Docs & Package Index
+
+on:
+  workflow_dispatch:
+  repository_dispatch:
+    types: [trigger-ducpy-docs-deployment]
+  push:
+    branches:
+      - main
+    paths:
+      - 'packages/ducpy/docs/**'
+      - 'packages/ducpy/src/ducpy/**'
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Install Sphinx dependencies
+        run: pip install sphinx furo sphinx-autoapi
+
+      - name: Build Sphinx documentation
+        run: sphinx-build -M html . _build
+        working-directory: packages/ducpy/docs
+
+      - name: Stage site root
+        run: |
+          mkdir -p _site/reference/python
+          cp -r packages/ducpy/docs/_build/html/. _site/reference/python/
+
+      - name: Build PEP 503 Simple Package Index
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        # simple/ lands at _site/simple/ → ducflair.github.io/duc/simple/
+        run: python3 scripts/build-ducpy-simple-index.py _site
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: _site
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/release-ducjs.yml

@@ -38,6 +38,20 @@ jobs:
         uses: oven-sh/setup-bun@v2
         with:
           bun-version: "latest"
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: wasm32-unknown-unknown
+
+      - name: Install native toolchain for wasm build
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y clang
+
+      - name: Install wasm-pack (pinned 0.14.x)
+        run: cargo install wasm-pack --version 0.14.0 --locked --force
+
       # npm 11.5.1 or later must be installed for OIDC to work
       - name: Update npm
         run: npm install -g npm@latest

.github/workflows/release-ducpdf.yml

@@ -38,6 +38,20 @@ jobs:
         uses: oven-sh/setup-bun@v2
         with:
           bun-version: "latest"
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: wasm32-unknown-unknown
+
+      - name: Install native toolchain for wasm build
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y clang
+
+      - name: Install wasm-pack
+        run: cargo install wasm-pack --locked
+
       # npm 11.5.1 or later must be installed for OIDC to work
       - name: Update npm
         run: npm install -g npm@latest

.github/workflows/release-ducpy.yml

@@ -73,6 +73,29 @@ jobs:
             exit 1
           fi
         working-directory: ./packages/ducpy
+
+      - name: Upload wheels to GitHub release
+        if: steps.release.outputs.status == 'success'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          # Get the tag created by semantic-release
+          TAG=$(git describe --tags --abbrev=0)
+          echo "Uploading wheels from dist/ to release $TAG"
+
+          # Upload all wheels and source distributions
+          find packages/ducpy/dist -name "*.whl" -o -name "*.tar.gz" | while read file; do
+            echo "Uploading: $file"
+            gh release upload "$TAG" "$file" --clobber
+          done
+
+      - name: Deploy Python documentation
+        if: steps.release.outputs.status == 'success'
+        uses: peter-evans/repository-dispatch@v3
+        with:
+          event-type: trigger-ducpy-docs-deployment
+          token: ${{ secrets.GITHUB_TOKEN }}
+
       - name: Notify web deployment
         if: steps.release.outputs.status == 'success'
         uses: peter-evans/repository-dispatch@v3

.github/workflows/release-ducsvg.yml

@@ -42,6 +42,18 @@ jobs:
       - name: Update npm
         run: npm install -g npm@latest
 
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: wasm32-unknown-unknown
+
+      - name: Install native toolchain for wasm build
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y clang
+
+      - name: Install wasm-pack
+        run: cargo install wasm-pack --locked
 
       - name: Install deps
         run: bun install

.gitignore

@@ -33,7 +33,6 @@ sst.pyi
 # opennext
 .open-next
 
-# flatc
 build_logs
 
 .claude

.vscode/extensions.json

@@ -2,7 +2,6 @@
   "recommendations": [ 
     "rust-lang.rust-analyzer",
     "streetsidesoftware.code-spell-checker",
-    "gaborv.flatbuffers",
     "PKief.material-icon-theme",
     "bradlc.vscode-tailwindcss",
     "ducflair.duc",