updates for 2026

.claude/settings.local.json

@@ -0,0 +1,11 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm run build:*)",
+      "mcp__plugin_playwright_playwright__browser_drag",
+      "Bash(bun run build:*)",
+      "Bash(pip uninstall:*)",
+      "Bash(bunx playwright test:*)"
+    ]
+  }
+}

.github/workflows/ci.yml

@@ -0,0 +1,149 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+    tags: ['*']
+  pull_request:
+    branches: [main]
+
+jobs:
+  build-js:
+    name: Build JavaScript
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Build production bundle
+        run: bun run build
+
+      - name: Upload JS bundle
+        uses: actions/upload-artifact@v6
+        with:
+          name: js-bundle
+          path: hiplot/static/built/
+          retention-days: 7
+
+  typecheck-pytest:
+    name: ${{ format('Type Check & Tests (Python {0})', matrix.python-version) }}
+    needs: build-js
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.9', '3.11', '3.12', '3.14']
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download JS bundle
+        uses: actions/download-artifact@v4
+        with:
+          name: js-bundle
+          path: hiplot/static/built/
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run ty
+        run: make check
+
+      - name: Run pytest
+        run: make test
+
+      - name: Test CLI commands
+        run: |
+          uv sync
+          uv run --extra server hiplot --help
+          uv run hiplot-render --help
+          # new alias for hiplot-render: hiplot-mm
+          uv run hiplot-mm --help
+
+  package-verify:
+    name: Verify Package Build
+    needs: build-js
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download JS bundle
+        uses: actions/download-artifact@v4
+        with:
+          name: js-bundle
+          path: hiplot/static/built/
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Build package
+        run: uv build
+
+      - name: Verify wheel install
+        run: |
+          uv venv test-wheel
+          VIRTUAL_ENV=test-wheel uv pip install dist/*.whl
+          test-wheel/bin/python -c "import hiplot as hip; hip.Experiment"
+          test-wheel/bin/python -c "import hiplot as hip; print(hip.__version__)"
+          test-wheel/bin/hiplot-render demo --format html > /dev/null
+
+      - name: Verify sdist install
+        run: |
+          uv venv test-sdist
+          VIRTUAL_ENV=test-sdist uv pip install dist/*.tar.gz
+          test-sdist/bin/python -c "import hiplot as hip; hip.Experiment"
+          test-sdist/bin/hiplot-render demo --format html > /dev/null
+
+      - name: Upload package artifacts
+        uses: actions/upload-artifact@v6
+        with:
+          name: python-package
+          path: dist/
+          retention-days: 7
+
+  windows-test:
+    name: Windows Tests
+    needs: build-js
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download JS bundle
+        uses: actions/download-artifact@v4
+        with:
+          name: js-bundle
+          path: hiplot/static/built/
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run pytest
+        run: uv run pytest hiplot
+
+      - name: Test CLI commands
+        run: |
+          uv sync
+          uv run --extra server hiplot --help
+          uv run hiplot-render --help
+          # new alias for hiplot-render: hiplot-mm
+          uv run hiplot-mm --help

.github/workflows/docs.yml

@@ -0,0 +1,112 @@
+name: Documentation
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+# Allow only one concurrent deployment
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build-js:
+    name: Build JavaScript
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Build production bundle
+        run: bun run build
+
+      - name: Upload JS bundle
+        uses: actions/upload-artifact@v6
+        with:
+          name: js-bundle
+          path: hiplot/static/built/
+          retention-days: 1
+
+  build-docs:
+    name: Build Documentation
+    needs: build-js
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download JS bundle
+        uses: actions/download-artifact@v4
+        with:
+          name: js-bundle
+          path: hiplot/static/built/
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Generate HiPlot demos
+        run: |
+          mkdir -p docs/_static/demo/
+          PAGES=$(uv run python -c "import hiplot.fetchers; print('\n'.join(list(hiplot.fetchers.README_DEMOS.keys())))")
+          for p in $PAGES; do
+            echo "Generating demo: $p"
+            uv run hiplot-render --format html $p > docs/_static/demo/$p.html
+          done
+
+      - name: Generate data demos
+        run: |
+          DATA_PATH="assets/data"
+          for p in $(ls $DATA_PATH); do
+            echo "Generating demo: $p"
+            uv run hiplot-render --format html $DATA_PATH/$p > docs/_static/demo/$p.html
+          done
+
+      - name: Generate HiPlot upload page
+        run: |
+          uv run python -c "from pathlib import Path; import hiplot; Path('docs/_static/hiplot_upload.html').write_text(hiplot.render.make_experiment_standalone_page({'dataProviderName': 'upload'}))"
+          cp -r hiplot/static docs/_static/static
+          cp hiplot/static/built/hiplot.bundle.js docs/_static/hiplot.bundle.js
+
+      - name: Build Sphinx docs
+        run: |
+          cd docs/
+          uv run make html
+
+      - name: Upload docs artifact
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: docs/_build/html
+
+  deploy:
+    name: Deploy to GitHub Pages
+    needs: build-docs
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/release.yml

@@ -0,0 +1,59 @@
+name: Release to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build-js:
+    name: Build JavaScript
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Build production bundle
+        run: bun run build
+
+      - name: Upload JS bundle
+        uses: actions/upload-artifact@v6
+        with:
+          name: js-bundle
+          path: hiplot/static/built/
+          retention-days: 1
+
+  publish:
+    name: Publish to PyPI
+    needs: build-js
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download JS bundle
+        uses: actions/download-artifact@v4
+        with:
+          name: js-bundle
+          path: hiplot/static/built/
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

.gitignore

@@ -17,6 +17,7 @@ env/
 build/
 develop-eggs/
 dist/
+npm-dist/
 downloads/
 eggs/
 .eggs/
@@ -116,3 +117,10 @@ docs/build
 hiplot/static/built
 src/**/*css.d.ts
 *.code-workspace
+
+
+npm-build
+npm-package
+.playwright-mcp
+test_data/
+test-results

MANIFEST.in

@@ -1,4 +1,5 @@
 include LICENSE README.md
+include pyproject.toml
 include requirements/*.txt
 include hiplot/static/*
 include hiplot/static/built/*

Makefile

@@ -0,0 +1,20 @@
+install:
+	bun install
+	uv sync --all-extras
+
+clean:
+	rm -rf node_modules .venv
+
+build:
+	bun run build
+	uv build
+
+test:
+	uv run pytest hiplot --durations=10
+
+check:
+	# uv run mypy --strict --implicit-reexport hiplot
+	uv run ty check
+
+dev:
+	uv run hiplot --port 8765 --host 0.0.0.0