← Commit history

Follow the rename: refs and title to adom/adom-3d-viewer

Colby Knox ·52c81bc13e · ·parent af7efbc
6 files changed +79−31
README.md+5−5
@@ -1,4 +1,4 @@-# adom-3d-viewer-babylon9+# Adom 3D Viewer  The Babylon 9.5 viewer engine behind every component page's 3D tab on wiki.adom.inc. A fork of `adom-inc/3d-viewer` (Babylon 7.54) upgraded to@@ -7,7 +7,7 @@ that downstream tools vendor (the wiki's native component viewer, chiplinter, and the next wave of Adom 3D apps).  This page is the canonical home: the source lives on the Files tab-(`adom-wiki repo clone adom/adom-3d-viewer-babylon9`), and each version's+(`adom-wiki repo clone adom/adom-3d-viewer`), and each version's built bundle is attached as a release asset you can pin.  ## What is in 0.4.x@@ -29,7 +29,7 @@ built bundle is attached as a release asset you can pin. Every release attaches the built bundle as a tarball asset:  ```bash-adom-wiki release download adom/adom-3d-viewer-babylon9 <version> adom-3d-viewer-babylon9-<version>.tar.gz+adom-wiki release download adom/adom-3d-viewer <version> adom-3d-viewer-babylon9-<version>.tar.gz tar -xzf adom-3d-viewer-babylon9-<version>.tar.gz -C ./vendor/3d-viewer/ ``` @@ -94,8 +94,8 @@ chiplinter uses `V.BABYLON.MeshBuilder.CreateDisc`, `V.BABYLON.PBRMaterial`, ## Build from source  ```bash-adom-wiki repo clone adom/adom-3d-viewer-babylon9-cd adom-3d-viewer-babylon9+adom-wiki repo clone adom/adom-3d-viewer+cd adom-3d-viewer npm install npx vite build --config vite.standalone.config.ts   # -> dist-standalone/ ```
SKILL.md+2−2
@@ -19,7 +19,7 @@ wiki.adom.inc. Ships as a versioned ESM bundle (entry + code-split chunks). Pinnable, versioned artifact (recommended for tools that vendor it):  ```bash-adom-wiki release download adom/adom-3d-viewer-babylon9 <version> adom-3d-viewer-babylon9-<version>.tar.gz+adom-wiki release download adom/adom-3d-viewer <version> adom-3d-viewer-babylon9-<version>.tar.gz tar -xzf adom-3d-viewer-babylon9-<version>.tar.gz -C ./vendor/3d-viewer/ ``` @@ -43,5 +43,5 @@ The extracted VERSION file records exactly which build you have.  Full API (loadModel, frameModel, toggleAxes, layers toolbar, laser etch, BABYLON namespace re-export) is documented in the README on this page. Source-lives on the Files tab; `adom-wiki repo clone adom/adom-3d-viewer-babylon9`+lives on the Files tab; `adom-wiki repo clone adom/adom-3d-viewer` gets you a working checkout.
package.json+4−3
@@ -1,7 +1,7 @@ {   "name": "adom-3d-viewer-babylon9",   "version": "0.4.3",-  "description": "Fork of adom-inc/3d-viewer upgraded to Babylon 9.5 with the redesigned Inspector + 3d-viewer-design-skill-compliant defaults (background gradient, bottom-light toggle, medium-gray ground plane, world-origin axes).",+  "description": "The Babylon 9.5 engine behind every component page's 3D tab on wiki.adom.inc. Versioned ESM bundle with GLB loading, view cube, layers toolbar, ground shadows, and Z-up CAD framing.",   "type": "app",   "main": "./dist/index.js",   "module": "./dist/index.js",@@ -35,7 +35,7 @@   "peerDependencies": {     "svelte": "^4.0.0 || ^5.0.0"   },-  "slug": "adom-3d-viewer-babylon9",+  "slug": "adom-3d-viewer",   "license": "MIT",   "tags": [     "3d",@@ -67,5 +67,6 @@       "label": "Pin a version",       "prompt": "Download the 0.4.3 viewer bundle so my tool vendors a fixed build"     }-  ]+  ],+  "title": "Adom 3D Viewer" }\ No newline at end of file
publish-skills/release/SKILL.md+42−21
@@ -2,40 +2,61 @@ name: release description: >   Cut a new adom-3d-viewer-babylon9 version: build the standalone ESM bundle,-  push source to the wiki page repo, publish the package, and attach the built-  bundle tarball as a pinnable release asset. Use when bumping the viewer+  stage a wiki-clean manifest, publish the package, push source, and attach the+  built bundle tarball as a pinnable release asset. Use when bumping the viewer   version, shipping viewer fixes, or syncing the GitHub mirror to the wiki. --- # Cut a release -Versions live in three places that must agree: `VERSION`, `package.json`-`version`, and the release you upload. The wiki page adom/adom-3d-viewer-babylon9-is the canonical home; GitHub adom-inc/adom-3d-viewer-babylon9 is the working-mirror.+Versions must agree in `VERSION` and `package.json`. The wiki page+adom/adom-3d-viewer is the canonical home; GitHub+adom-inc/adom-3d-viewer-babylon9 is the working mirror.++The checkout's package.json carries npm dev/peer deps (svelte, vite, ...),+which the wiki's owner-qualified dependency validation rejects. Publish+therefore goes through a STAGING DIR with a wiki-clean manifest; never run+`pkg publish` from the checkout root.  ```bash # 0. bump the version in BOTH package.json and VERSION # 1. build the standalone browser bundle npm install && npx vite build --config vite.standalone.config.ts echo "$(cat VERSION)" > dist-standalone/VERSION+V=$(cat VERSION) -# 2. push source to the wiki page repo (never node_modules/dist)-adom-wiki repo push adom/adom-3d-viewer-babylon9 -m "v$(cat VERSION)"+# 2. stage the wiki publish (wiki-clean manifest + lifecycle scripts)+STAGE=$(mktemp -d)+cp README.md SKILL.md VERSION "$STAGE/"+cp wiki/install.sh wiki/uninstall.sh "$STAGE/"+python3 - "$STAGE" << 'PY'+import json, sys+d = json.load(open("package.json"))+for k in ["devDependencies","peerDependencies","scripts","main","module","exports","files","types"]:+    d.pop(k, None)+d["scripts"] = {"install": "./install.sh", "uninstall": "./uninstall.sh"}+json.dump(d, open(sys.argv[1] + "/package.json", "w"), indent=2)+PY -# 3. publish the package (metadata from package.json)-adom-wiki pkg publish --org adom+# 3. publish from the stage+(cd "$STAGE" && adom-wiki pkg publish --org adom) -# 4. attach the built bundle as the pinnable artifact-V=$(cat VERSION)-tar -czf "adom-3d-viewer-babylon9-$V.tar.gz" -C dist-standalone .-adom-wiki release upload adom/adom-3d-viewer-babylon9 "$V" "adom-3d-viewer-babylon9-$V.tar.gz" --platform any-rm "adom-3d-viewer-babylon9-$V.tar.gz"+# 4. push source to the page repo (explicit files; never node_modules/dist)+adom-wiki repo push adom/adom-3d-viewer \+  --files src static docs README.md README-FORK.md SKILL.md publish-skills \+          package.json package-lock.json VERSION standalone.ts \+          svelte.config.js tsconfig.json vite.config.ts vite.standalone.config.ts .gitignore \+  -- -m "v$V"++# 5. attach the built bundle as the pinnable artifact+tar -czf "/tmp/adom-3d-viewer-babylon9-$V.tar.gz" -C dist-standalone .+adom-wiki release upload adom/adom-3d-viewer "$V" "/tmp/adom-3d-viewer-babylon9-$V.tar.gz" --platform any+rm "/tmp/adom-3d-viewer-babylon9-$V.tar.gz" -# 5. if the wiki's native viewer should ship this build too: vendor-#    dist-standalone/ into git-wiki/static/vendor/adom-3d-viewer-babylon9 and-#    bump VIEWER_BUNDLE_VER in git-wiki/lib/viewers/viewer-3d.js+# 6. if the wiki's native viewer should ship this build: vendor dist-standalone/+#    into git-wiki/static/vendor/adom-3d-viewer-babylon9 and bump+#    VIEWER_BUNDLE_VER in git-wiki/lib/viewers/viewer-3d.js ``` -Also push the same commit to the GitHub mirror so the two stay in sync.-The old `publish.sh` targeted the dead legacy wiki host and was removed when-the page moved to wiki.adom.inc (2026-07-23).+Verify: the page shows the new version, `adom-wiki pkg install+adom/adom-3d-viewer` fetches and extracts the bundle, and the+extracted VERSION matches. Also push the same commit to the GitHub mirror.
wiki/install.shadded+21
@@ -0,0 +1,21 @@+#!/usr/bin/env bash+# Install the adom-3d-viewer-babylon9 bundle: fetch this version's built ESM+# bundle (release asset) into a shared vendor location tools can symlink.+set -euo pipefail+cd "$(dirname "$0")"+V=$(tr -d '[:space:]' < VERSION)+DEST="${ADOM_3D_VIEWER_DIR:-$HOME/.local/share/adom-3d-viewer-babylon9}"+TMP=$(mktemp -d)+trap 'rm -rf "$TMP"' EXIT+adom-wiki release download adom/adom-3d-viewer "$V" --platform any --out "$TMP"+TAR="$TMP/adom-3d-viewer-babylon9-$V.tar.gz"+if [ ! -f "$TAR" ]; then+  echo "ERROR: release asset adom-3d-viewer-babylon9-$V.tar.gz did not download" >&2+  exit 1+fi+mkdir -p "$DEST.new-$$"+tar -xzf "$TAR" -C "$DEST.new-$$"+rm -rf "$DEST"+mv "$DEST.new-$$" "$DEST"+echo "OK: adom-3d-viewer-babylon9 $V installed at $DEST"+echo "Hint: load $DEST/adom-3d-viewer-babylon9.esm.js via <script type=\"module\">; serve the whole directory (code-split chunks)."
wiki/uninstall.shadded+5
@@ -0,0 +1,5 @@+#!/usr/bin/env bash+set -euo pipefail+DEST="${ADOM_3D_VIEWER_DIR:-$HOME/.local/share/adom-3d-viewer-babylon9}"+rm -rf "$DEST"+echo "OK: adom-3d-viewer-babylon9 removed from $DEST"