[cmaranes]

Implements the 0.2.0 plan: the extension now shows point clouds in its own viewer and no longer depends on tatsy.vscode-3d-preview. That also makes it possible to publish to Open VSX.

What changes for users

• Built-in viewer (webview + three.js): orbit controls, point size, RGB / height / solid coloring, Z-up or Y-up, axes and grid, and point count and bounding box. Viewing the same expression again updates its tab. The last toolbar choices become the defaults for new viewers.
• pythonPlyPreview.maxPoints (default 1,000,000): larger clouds are randomly subsampled in Python before export, with a fixed seed so you get the same points every time. The viewer says when a cloud was subsampled.
• Docker / remote debugging: if the debuggee can't write to the workspace path, the exporter writes to its temp folder, and the extension fetches the file through the debugger in 3 MB base64 chunks. It uses the DAP clipboard context, the only one where debugpy doesn't truncate strings (pydevd_comm.py). Every chunk's size is checked, so a truncated transfer fails instead of showing a partial cloud.
• .ply custom editor with priority: "option": available via Reopen Editor With..., and it never replaces another default.
• pythonPlyPreview.viewer: "default" restores the old behaviour, so people who prefer 3D Preview can keep it.

Implementation notes

• src/webview/viewer.ts is bundled by esbuild.mjs into media/viewer.js, which is gitignored and built by npm run compile / vscode:prepublish. It's type-checked by its own src/webview/tsconfig.json, which uses DOM libs. The extension itself is still compiled by tsc.
• src/viewerProtocol.ts types the messages exchanged in both directions. The webview reports loaded after parsing and before rendering, so the tests don't need WebGL.
• activate() returns { onViewerMessage } so the integration tests can watch the viewer.
• The vsix grows from 47 KB to 198 KB.

Commits

feat(export) subsampling → build esbuild/three → feat(viewer) viewer + settings + .ply editor → feat debugger transfer → test → feat! drop the dependency, docs, 0.2.0 → fix(viewer) point to the default setting when WebGL is unavailable

Test plan

• python python/test_ply_export.py: new tests for subsampling, deterministic subsets, and the temp-folder fallback
• npm test: 13/13 locally (Windows). New tests:
  • viewer loads lidar (500 points, colours) in a webview tab
  • panel reuse
  • maxPoints = 100 → 100 of 1000
  • forced debugger transfer of a 300k-point cloud (~4.5 MB, 2 chunks, ~1 s)
  • the default setting opens the .ply file instead
  • Reopen Editor With loads a .ply
• npm run lint: 0 problems; the vsix contains only out/, media/, python/ply_export.py, the icon and the docs
• CI green on Linux, Windows and macOS (no debugger retries). WebGL is blocklisted on the Linux runner: the viewer shows its fallback message and the tests still pass, because they check the parsed point count
• Manual check (F5 → test-fixtures/workspace): rotate, pan and zoom, each colour mode, Z/Y up, point size, light and dark themes, a 1M-point array, and a 5M array capped by maxPoints
• Not covered: attaching to a real Docker container. The test forces the debugger transfer; the exporter's temp-folder fallback is covered by the Python tests.

Before merging

• images/viewer.gif recorded and added; the old demo GIFs and MP4s are removed

After merging

• Open VSX: create the cmaranes namespace and add an OVSX_PAT secret to the marketplace environment; release.yml already publishes there when the secret exists.

🤖 Generated with Claude Code

https://claude.ai/code/session_01JBDmV8VxTwVxxpuC8NMG8y