Rename package to scoped @valknar/vpinball-wasm

Reverts the earlier unscoping: an unscoped package on a Gitea npm
registry has no `.npmrc` mapping a consumer can use other than pinning
the exact tarball URL, since Gitea's registry doesn't proxy npmjs.org
and only scoped packages support the standard `@scope:registry=`
config. Scoping restores that: consumers add one `@valknar:registry=`
line and depend on a normal semver range.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012hQoM3jJT1Lx7CMTciMzvD

.gitea/workflows/ci.yml

@@ -11,28 +11,41 @@ jobs:
     steps:
       - uses: https://github.com/actions/checkout@v4
 
-      - name: Install bison
+      - name: Install build dependencies
         run: |
           sudo apt-get update
-          sudo apt-get install -y bison
+          sudo apt-get install -y bison cmake curl python3
+
+      # Gitea Actions doesn't support the built-in hashFiles() expression
+      # function (unlike GitHub Actions) - it silently evaluates to an empty
+      # string, which turned every cache key below into the same constant
+      # string regardless of what actually changed, so a cache entry from
+      # before a dependency-version or patch change would still be reused
+      # forever. Hash the same inputs by hand instead.
+      - name: Compute cache keys
+        id: cache-keys
+        run: |
+          echo "emsdk=$(sha256sum scripts/versions.sh | cut -d' ' -f1)" >> "$GITHUB_OUTPUT"
+          echo "deps-wasm32=$(cat scripts/versions.sh $(find patches -type f | sort) | sha256sum | cut -d' ' -f1)" >> "$GITHUB_OUTPUT"
+          echo "libwinevbs=$(cat scripts/versions.sh $(find patches/libwinevbs -type f | sort) | sha256sum | cut -d' ' -f1)" >> "$GITHUB_OUTPUT"
 
       - name: Cache emsdk
         uses: https://github.com/actions/cache@v4
         with:
           path: emsdk
-          key: emsdk-${{ hashFiles('scripts/versions.sh') }}
+          key: emsdk-${{ steps.cache-keys.outputs.emsdk }}
 
       - name: Cache wasm32 dependency builds
         uses: https://github.com/actions/cache@v4
         with:
           path: build/deps-wasm32
-          key: deps-wasm32-${{ hashFiles('scripts/versions.sh', 'patches/**') }}
+          key: deps-wasm32-${{ steps.cache-keys.outputs.deps-wasm32 }}
 
       - name: Cache libwinevbs build
         uses: https://github.com/actions/cache@v4
         with:
           path: vendor/libwinevbs/build
-          key: libwinevbs-wasm32-${{ hashFiles('scripts/versions.sh', 'patches/libwinevbs/**') }}
+          key: libwinevbs-wasm32-${{ steps.cache-keys.outputs.libwinevbs }}
 
       - name: Setup (fetch + patch vendor sources)
         run: ./scripts/setup.sh
@@ -59,70 +72,27 @@ jobs:
           npm install --no-save typescript
           npx tsc -p package/tsconfig.json
 
-      - uses: https://github.com/actions/upload-artifact@v4
-        with:
-          name: vpinball-wasm-dist
-          path: dist/
-
-  publish:
-    name: Publish to npm registry
-    if: startsWith(github.ref, 'refs/tags/')
-    needs: build
-    runs-on: ubuntu-latest
-    steps:
-      - uses: https://github.com/actions/checkout@v4
-
-      - name: Install bison
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y bison
-
-      - name: Cache emsdk
-        uses: https://github.com/actions/cache@v4
-        with:
-          path: emsdk
-          key: emsdk-${{ hashFiles('scripts/versions.sh') }}
-
-      - name: Cache wasm32 dependency builds
-        uses: https://github.com/actions/cache@v4
-        with:
-          path: build/deps-wasm32
-          key: deps-wasm32-${{ hashFiles('scripts/versions.sh', 'patches/**') }}
-
-      - name: Cache libwinevbs build
-        uses: https://github.com/actions/cache@v4
-        with:
-          path: vendor/libwinevbs/build
-          key: libwinevbs-wasm32-${{ hashFiles('scripts/versions.sh', 'patches/libwinevbs/**') }}
-
-      - name: Setup (fetch + patch vendor sources)
-        run: ./scripts/setup.sh
-
-      - name: Build wasm32 dependencies
-        run: |
-          source emsdk/emsdk_env.sh
-          ./scripts/build-deps.sh
-
-      - name: Build vpinball
-        run: |
-          source emsdk/emsdk_env.sh
-          ./scripts/build.sh
-
-      - name: Build npm wrapper
-        run: |
-          npm install --no-save typescript
-          npx tsc -p package/tsconfig.json
-
+      # Everything below only runs on a tag push (a release) - reuses the
+      # exact build just done above instead of the previous separate
+      # "publish" job, which had `needs: build` but still redundantly
+      # re-ran the *entire* checkout/cache/setup/build-deps/build/wrapper
+      # pipeline from scratch, doubling CI time on every release for no
+      # benefit (Gitea Actions' artifact-passing story is also awkward
+      # here - upload-artifact@v4+/download-artifact@v4+ aren't supported
+      # on Gitea at all, see the upload-artifact removal above).
       - name: Set package version from the tag
+        if: startsWith(github.ref, 'refs/tags/')
         run: npm pkg set version="${GITHUB_REF_NAME#v}"
 
       # Scoped to this one registry host+path (via publishConfig.registry in
       # package.json) rather than actions/setup-node's registry-url, which
       # would set it as the *default* registry for every install.
       - name: Configure registry auth for publish
+        if: startsWith(github.ref, 'refs/tags/')
         run: npm config set "//dev.pivoine.art/api/packages/valknar/npm/:_authToken" "$PACKAGE_TOKEN"
         env:
           PACKAGE_TOKEN: ${{ secrets.PACKAGE_TOKEN }}
 
       - name: Publish to Gitea npm registry
+        if: startsWith(github.ref, 'refs/tags/')
         run: npm publish

README.md

@@ -128,7 +128,7 @@ startButton.addEventListener('click', () => {
 pinball.evalScript('DMDWidth = 128 : DMDHeight = 32');
 ```
 
-See `examples/basic/index.html` for a complete working page (loading progress, file upload, touch controls, fullscreen). The published package name/registry (`@valknar/vpinball-wasm` on this project's Gitea npm registry) is a placeholder pending the first real release — see `package.json`.
+See `examples/basic/index.html` for a complete working page (loading progress, file upload, touch controls, fullscreen). Published as `@valknar/vpinball-wasm` on this project's Gitea npm registry — see `package.json`.
 
 ## Known limitations
 

examples/basic/index.html

@@ -1,6 +1,6 @@
 <!doctype html>
 <!--
-  Full usage example for @valknar/vpinball-wasm: loading progress, a
+  Full usage example for vpinball-wasm: loading progress, a
   user-gesture "Start" button (required for audio autoplay and fullscreen
   to work), an optional file picker for a self-contained .vpx table, touch
   controls on touch-capable devices, and a fullscreen button.

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@valknar/vpinball-wasm",
-	"version": "0.0.0",
+	"version": "0.2.0",
 	"description": "Visual Pinball's engine compiled to WebAssembly - real .vpx tables, real VBScript, WebGL2 rendering, in the browser",
 	"license": "SEE LICENSE IN LICENSE",
 	"type": "module",

package/src/types.ts

@@ -1,5 +1,5 @@
 /**
- * Public TypeScript surface for @valknar/vpinball-wasm.
+ * Public TypeScript surface for vpinball-wasm.
  *
  * This wraps the raw Emscripten-generated module (dist/vpinball.js) so
  * consumers don't need to know about ccall/cwrap/FS internals directly.