feat: Cesium 1.144 composable camera controllers + monthly maintenance

[bnimit]

Adds support for the composable Controller framework introduced in Cesium 1.144, and takes Cesium from 1.143 to 1.144. Also folds in this month's dev/CI dependency refresh, since it lands the same day.

Camera controller components

Cesium 1.144 added a composable Controller framework plus a set of alternative camera controllers aimed at asset inspection. All of them are now wrapped:

Component	Behaviour
ScreenSpaceMapCameraController	Pans across the map, keeping the world position picked at drag start under the pointer
ScreenSpaceElevatorCameraController	Pans the camera vertically, as if riding an elevator
ScreenSpaceTiltOrbitCameraController	Tilts and orbits around a pivot — the screen centre, or the position under the pointer via useDragPosition
ScreenSpaceZoomCameraController	Zooms towards a picked world position via scroll or drag
HybridScreenSpacePanCameraController	Switches between map and elevator panning based on the camera's angle from nadir

The 1.144 changelog lists only four controllers. ScreenSpaceZoomCameraController ships in the same API and is wrapped here too — without it you can't assemble a complete inspection camera.

Registration

Each controller registers with Scene.controllerHost on mount and unregisters on unmount, through new registerController / unregisterController helpers in core.

CesiumWidget.addController is a thin wrapper around registerController(controller, widget.container) and drops the priority argument, so these components go one level down to controllerHost directly and expose priority as a create-time prop. Precedence ordering is the point of a composable controller framework, so it shouldn't be unreachable.

The helpers are exported, so users can build resium-style components around their own Controller implementations.

dragInputs / scrollInputs are create-time props

Cesium attaches these bindings once, inside connectedCallback, via registerDragInputBindings. Mutating them after registration has no effect. Exposing them as ordinary reactive props would produce a prop that looks live but silently does nothing, so they're declared as cesiumReadonlyProps: changing one re-creates the controller. Every other property is applied in place.

Storybook

One Basic story per controller, plus a CombinedInspectionCamera story composing pan + tilt/orbit + zoom into a single camera rig. Each story pairs the controller with <ScreenSpaceCameraController enableInputs={false} />, since Cesium's built-in controller otherwise keeps handling input alongside it. No external tile endpoints are used.

Nothing else in 1.144 needs wrapping

Scene.snap is a method and Texture.defaultColor a static, neither of which resium wraps as components. The vector-tile terrain draping is internal and driven by the existing Cesium3DTileStyle — MVTDataProvider.fromUrl's options are unchanged. The new glTF extensions have no public API surface. The existing exhaustive UnusedCesiumProps checks would have failed had any already-wrapped class gained a property.

Maintenance refresh

Dev toolchain — Storybook 10.4.6 → 10.5.6, ESLint 10.6 → 10.8, Prettier → 3.9.6, Vite 8.1.3 → 8.2.0, @vitejs/plugin-react 6.0.2 → 6.0.5, React/React-DOM 19.2.7 → 19.2.8, plus patch bumps to types, globby, npm-run-all2, concurrently and wait-on.

Three dev-only majors, each checked against its breaking notes:

• @testing-library/jest-dom 6 → 7 — @testing-library/dom becomes a required peer (already present); requires Node ≥22
• jsdom 29 → 30 — requires Node ^22.22.2 || ^24.15.0 || >=26
• c8 11 → 12 — yargs 18 narrows the supported Node range

None affect shipped output. engines.node deliberately stays at >=20.19.0: it describes what consumers need, not what building resium needs.

CI — actions/checkout v7.0.0 → v7.0.1, actions/setup-node v6.4.0 → v7.0.0 (ESM migration, no config change needed). .node-version 24.16.0 → 24.19.0, staying on the 24 LTS line.

codecov/codecov-action was pinned to e53489f4, which is the annotated tag object for v7.0.0 rather than the commit it points at. GitHub resolves it, so CI had been passing, but only a commit SHA is the immutable target SHA-pinning is meant to provide — a tag object can be deleted and re-created upstream. Repinned to fb8b3582, the commit v7.0.0 and v7 actually resolve to. Same action version, no behaviour change.

All seven action pins across the workflows are now verified to resolve to commits. The remaining ones were already current: actions/upload-artifact v7.0.1, actions/create-github-app-token v3.2.0 and peaceiris/actions-gh-pages v4.1.0 are each the latest release and correctly pinned. reearth/changelog-action stays on its existing main pin — main is two commits ahead, but both only add a Backstage catalog-info.yaml, so there is nothing functional to pick up.

Docs — Astro 7.0.7 → 7.1.6, Starlight 0.41.3 → 0.41.6, and npm audit fix clears transitive postcss and svgo advisories. The docs workspace audit is now clean.

Lockfile regenerated. @vitejs/plugin-react 6.0.5 pulls an optional babel chain needing @babel/core ^8 nested, and the old lock had 7.29.7 hoisted at the root with nowhere to place 8.x — npm install failed on eresolve even with node_modules cleared. The manifest resolves cleanly from scratch, so the lock was regenerated rather than forcing --legacy-peer-deps. That accounts for the large lock diff.

TypeScript stays on 6.0.3

TypeScript 7.0.2 was attempted and reverted. resium's own code is ready — tsc 7.0.2 passes with zero errors — but the surrounding toolchain isn't:

• typescript-eslint: every published version, including canary, caps at typescript >=4.8.4 <6.1.0, and @vitest/eslint-plugin carries its own copy with the same cap. npm run lint crashes with Cannot read properties of undefined (reading 'Cjs'). Scoping TS 6 to that subtree via npm overrides doesn't work: npm keeps 7.0.2 deduped and marks it invalid.
• unplugin-dts: solvable, via the official @typescript/typescript6 shim.

6.0.3 is also the newest TypeScript the lint toolchain accepts, so there's no intermediate step to take either. Worth revisiting once typescript-eslint ships TS 7 support.

Drive-by fix

The docs generator collapsed wrapped JSDoc lines with no separator, rendering "tilt ororbit" and "everyother controller". These components were the first to carry multi-line JSDoc in the generated property tables, so it had gone unnoticed. One-line fix in scripts/generator/parser.mts.

Verification

tsc, eslint, vitest (87 files / 127 tests, up from 81 / 115), library build plus the postbuild import check, Storybook build (all six new stories registered), docs generate (98 pages) and docs build all pass. All five components confirmed present in dist/resium.cjs.

Beyond the exhaustive type-level prop checks, there are seven new runtime tests covering registration against the widget container, priority forwarding, unregistration on unmount, live prop application, and dragInputs re-creation.

The VRT image comparison wasn't run locally — it needs the reg-suit credentials, so that's for CI.

Supersedes

• chore: update dependency cesium to v1.144.0 #789 — cesium 1.143; already stale, since main is on 1.143 as of chore: upgrade to Cesium 1.143 + monthly dep and CI action refresh #797, and this goes to 1.144
• ci: update actions/checkout action to v7.0.1 - autoclosed #801 — actions/checkout v7.0.1
• chore: update actions/setup-node action to v7 - autoclosed #800 — actions/setup-node v7
• chore: update node.js to v24.18.1 - autoclosed #794 — node 24.x (this goes further, to 24.19.0)
• chore: update npm dependencies #790 — npm dependencies (partially; see the refresh above)
• chore: update codecov/codecov-action digest to fb8b358 - autoclosed #798 — codecov/codecov-action digest; this pins the same fb8b358 commit

Screenshots

Screen Space Map Camera Controller

Basic

Screen Space Elevator Camera Controller

Basic

Screen Space Tilt Orbit Camera Controller

Basic

Screen Space Zoom Camera Controller

Basic

Hybrid Screen Space Pan Camera Controller

Basic

[reg-suit]

✨✨ That's perfect, there is no visual difference! ✨✨

[Copilot]

Pull request overview

Adds Resium wrappers for Cesium 1.144’s composable Controller-based camera controllers, alongside the monthly dependency/CI refresh and a small docs-generator formatting fix.

Changes:

• Introduces five new camera-controller components (map, elevator, tilt/orbit, zoom, and hybrid pan) with Storybook stories and type-level “unused prop” tests.
• Adds core helpers to register/unregister Cesium Controllers against the widget container (including priority support) plus runtime tests.
• Performs maintenance updates: Cesium 1.143 → 1.144, dev/docs dependency bumps, Node version bump, and GitHub Actions updates; fixes JSDoc line-wrap rendering in the docs generator.

Reviewed changes

Copilot reviewed 33 out of 35 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/ScreenSpaceZoomCameraController/ScreenSpaceZoomCameraController.ts	New Resium wrapper for Cesium’s ScreenSpaceZoomCameraController, including create-time bindings and priority support.
src/ScreenSpaceZoomCameraController/ScreenSpaceZoomCameraController.test.ts	Adds type-level unused-prop coverage for the zoom controller wrapper.
src/ScreenSpaceZoomCameraController/ScreenSpaceZoomCameraController.stories.tsx	Adds a Storybook “Basic” story demonstrating zoom-towards-pointer usage.
src/ScreenSpaceZoomCameraController/index.ts	Exposes the zoom controller component + props from its folder entrypoint.
src/ScreenSpaceTiltOrbitCameraController/ScreenSpaceTiltOrbitCameraController.ts	New wrapper for tilt/orbit inspection controller with create-time drag bindings and priority.
src/ScreenSpaceTiltOrbitCameraController/ScreenSpaceTiltOrbitCameraController.test.ts	Adds type-level unused-prop coverage for the tilt/orbit controller wrapper.
src/ScreenSpaceTiltOrbitCameraController/ScreenSpaceTiltOrbitCameraController.stories.tsx	Adds a Storybook “Basic” story for tilt/orbit inspection behavior.
src/ScreenSpaceTiltOrbitCameraController/index.ts	Exposes the tilt/orbit controller component + props from its folder entrypoint.
src/ScreenSpaceMapCameraController/ScreenSpaceMapCameraController.ts	New wrapper for map-style pan controller with create-time drag bindings and priority.
src/ScreenSpaceMapCameraController/ScreenSpaceMapCameraController.test.ts	Adds type-level unused-prop coverage for the map pan controller wrapper.
src/ScreenSpaceMapCameraController/ScreenSpaceMapCameraController.stories.tsx	Adds a Storybook “Basic” story for map panning behavior.
src/ScreenSpaceMapCameraController/index.ts	Exposes the map controller component + props from its folder entrypoint.
src/ScreenSpaceElevatorCameraController/ScreenSpaceElevatorCameraController.ts	New wrapper for vertical “elevator” pan controller with create-time drag bindings and priority.
src/ScreenSpaceElevatorCameraController/ScreenSpaceElevatorCameraController.test.ts	Adds type-level unused-prop coverage for the elevator controller wrapper.
src/ScreenSpaceElevatorCameraController/ScreenSpaceElevatorCameraController.stories.tsx	Adds a Storybook “Basic” story for elevator panning behavior.
src/ScreenSpaceElevatorCameraController/index.ts	Exposes the elevator controller component + props from its folder entrypoint.
src/index.ts	Re-exports the newly added controller components from the library root.
src/HybridScreenSpacePanCameraController/index.ts	Exposes the hybrid pan controller component + props from its folder entrypoint.
src/HybridScreenSpacePanCameraController/HybridScreenSpacePanCameraController.ts	New wrapper for the hybrid map/elevator pan controller with priority.
src/HybridScreenSpacePanCameraController/HybridScreenSpacePanCameraController.test.ts	Adds type-level unused-prop coverage for the hybrid pan controller wrapper.
src/HybridScreenSpacePanCameraController/HybridScreenSpacePanCameraController.stories.tsx	Adds “Basic” and combined inspection-camera composition Storybook stories.
src/core/index.ts	Exports the new controller registration helpers from core.
src/core/Controller.ts	Adds registerController / unregisterController helpers built around Scene.controllerHost.
src/core/Controller.test.tsx	Adds runtime tests verifying controller registration/unregistration and readonly-prop recreation behavior.
scripts/generator/parser.mts	Fixes docs generation to preserve spaces when collapsing wrapped JSDoc newlines.
package.json	Bumps Cesium and dev toolchain dependencies (Storybook, ESLint, Prettier, Vite, etc.).
docs/package.json	Updates Astro/Starlight versions for the docs workspace.
docs/package-lock.json	Regenerates docs lockfile to match updated docs dependencies.
.node-version	Updates pinned Node version used by CI workflows.
.github/workflows/vrt.yml	Updates pinned actions/checkout and actions/setup-node versions/SHAs for VRT workflow.
.github/workflows/tag.yml	Updates pinned actions/checkout version/SHA for tagging workflow.
.github/workflows/release.yml	Updates pinned actions/checkout and actions/setup-node versions/SHAs for release workflow.
.github/workflows/publish.yml	Updates pinned actions/checkout and actions/setup-node versions/SHAs for publish workflow.
.github/workflows/ci.yml	Updates pinned actions/checkout and actions/setup-node versions/SHAs for CI workflow.

Files not reviewed (1)

• docs/package-lock.json: Generated file

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.