castle-web-cli 0.4.133 → 0.4.134

package/kits/physics-2d/castle.json

@@ -131,5 +131,5 @@
   "main": "main.jsx",
   "autoUpdateWhenImported": true,
   "title": "physics-2d",
-  "publishedVersion": "2026-08-21T23:15:26.298Z"
+  "publishedVersion": "2026-08-21T23:53:35.620Z"
 }

package/kits/physics-2d/engine/liveReload.js

@@ -70,7 +70,7 @@ async function readDeckFile(path) {
 // no serve, a race with a delete, or a declared type that is binary (an image
 // the deck claims) -- the serve flags those rather than mangling them, and an
 // image decoded as utf-8 is nothing.
-async function readDeclaredFile(file) {
+export async function readDeclaredFile(file) {
   try {
     const res = await fetch(`/__castle/files/read?path=${encodeURIComponent(file)}`);
     if (!res.ok) return null;
@@ -82,7 +82,12 @@ async function readDeclaredFile(file) {
   }
 }
 
-async function hydrateDeclaredFiles(ensurePath) {
+// `knownExts` / `knownFiles` are the CALLER's, because each kit globs a
+// different set: physics-3d also knows `.pxmodel`, and a type one kit already
+// handles is not a declared type that needs fetching. Returns the extensions
+// found as well as the files, so the caller can teach its own change
+// classifier about them.
+export async function hydrateDeclaredFiles({ knownExts, knownFiles, ensurePath }) {
   let info;
   let listing;
   try {
@@ -97,11 +102,10 @@ async function hydrateDeclaredFiles(ensurePath) {
   const exts = (info.fileTypes ?? [])
     .filter((type) => type.data || (typeof type.editor === 'string' && type.editor !== 'kit'))
     .map((type) => type.ext)
-    .filter((ext) => typeof ext === 'string' && ext && !DATA_EXTS.includes(ext));
+    .filter((ext) => typeof ext === 'string' && ext && !knownExts.includes(ext));
   if (exts.length === 0) return null;
-  for (const ext of exts) declaredDataExts.add(ext);
   const paths = (listing.files ?? []).filter(
-    (file) => initialFiles[file] === undefined && exts.some((ext) => file.endsWith(ext))
+    (file) => knownFiles[file] === undefined && exts.some((ext) => file.endsWith(ext))
   );
   const entries = await Promise.all(
     paths.map(async (file) => {
@@ -114,11 +118,11 @@ async function hydrateDeclaredFiles(ensurePath) {
   // of visiblePaths is not in it. The shell can still open that file by path,
   // and an editor handed '' for it would be back to the original bug -- so make
   // sure whatever was actually opened is present, curated or not.
-  if (ensurePath && initialFiles[ensurePath] === undefined && extra[ensurePath] === undefined) {
+  if (ensurePath && knownFiles[ensurePath] === undefined && extra[ensurePath] === undefined) {
     const one = await readDeclaredFile(ensurePath);
     if (one !== null) extra[ensurePath] = one;
   }
-  return Object.keys(extra).length ? extra : null;
+  return { extra, exts };
 }
 
 // Deck files as live state: starts from the build-time glob snapshot, fills in
@@ -142,11 +146,20 @@ export function useLiveDeckFiles({ shouldSkipPath, ensurePath, live = true } = {
 
   useEffect(() => {
     let alive = true;
-    void hydrateDeclaredFiles(ensurePath).then((extra) => {
+    void hydrateDeclaredFiles({
+      knownExts: DATA_EXTS,
+      knownFiles: initialFiles,
+      ensurePath,
+    }).then((found) => {
       if (!alive) return;
-      // `current` wins: by the time this lands the editor may already have made
-      // an optimistic edit, and the disk copy behind it is stale.
-      if (extra) setFiles((current) => ({ ...extra, ...current }));
+      if (found) {
+        for (const ext of found.exts) declaredDataExts.add(ext);
+        // `current` wins: by the time this lands the editor may already have
+        // made an optimistic edit, and the disk copy behind it is stale.
+        if (Object.keys(found.extra).length) {
+          setFiles((current) => ({ ...found.extra, ...current }));
+        }
+      }
       setHydrated(true);
     });
     return () => {

package/kits/physics-3d/castle.json

@@ -25,7 +25,8 @@
       "scenes/**",
       "blueprints/**",
       "behaviors/**",
-      "assets/**"
+      "assets/**",
+      "theme.style"
     ],
     "fileTypes": [
       {
@@ -64,12 +65,12 @@
   "imports": {
     "castle.physics-2d": {
       "deckId": "ckRZGFW4iPrx",
-      "version": "2026-08-14T21:20:31.152Z"
+      "version": "2026-08-21T23:52:56.888Z"
     }
   },
   "main": "main.jsx",
   "autoUpdateWhenImported": true,
   "deckId": "JH0SclbPVP0y",
   "cardId": "eXfAaUdbSU5A",
-  "publishedVersion": "2026-08-21T23:15:28.646Z"
+  "publishedVersion": "2026-08-21T23:53:37.801Z"
 }

package/kits/physics-3d/engine3d/PxModelEditor.jsx

@@ -66,8 +66,9 @@ function descendantIds(parts, rootId) {
 
 export function PxModelEditor({ path }) {
   const saver = useFileSaver3D();
-  const { files, setFiles, dataVersion } = useLiveDeckFiles3D({
+  const { files, setFiles, dataVersion, hydrated } = useLiveDeckFiles3D({
     shouldSkipPath: saver.hasPending,
+    ensurePath: path,
   });
   const text = files[path];
   useEffect(() => {
@@ -265,6 +266,16 @@ export function PxModelEditor({ path }) {
     );
   }
 
+  if (!hydrated && files[path] === undefined) {
+    return (
+      <div className={styles.panelBare}>
+        <MainEditor>
+          <EditorBody>loading…</EditorBody>
+        </MainEditor>
+      </div>
+    );
+  }
+
   return (
     <div className={styles.panelBare}>
       <MainEditor>

package/kits/physics-3d/engine3d/Scene3DEditor.jsx

@@ -65,8 +65,9 @@ export function Scene3DEditor({ path }) {
   const stashKey = `scene3d-editor:${path}`;
   const [stash] = useState(() => takeReloadState(stashKey));
   const saver = useFileSaver3D();
-  const { files, setFiles, dataVersion } = useLiveDeckFiles3D({
+  const { files, setFiles, dataVersion, hydrated } = useLiveDeckFiles3D({
     shouldSkipPath: saver.hasPending,
+    ensurePath: path,
   });
   const text = files[path] ?? '';
   const onChangeText = (next) => {
@@ -305,6 +306,16 @@ export function Scene3DEditor({ path }) {
     onSelectActorIds([]);
   };
 
+  if (!hydrated && files[path] === undefined) {
+    return (
+      <div className={styles.panelBare}>
+        <MainEditor>
+          <EditorBody>loading…</EditorBody>
+        </MainEditor>
+      </div>
+    );
+  }
+
   return (
     <div className={styles.panelBare}>
       <MainEditor>

package/kits/physics-3d/engine3d/modelFiles.js

@@ -8,6 +8,7 @@
 import { useEffect, useRef, useState } from 'react';
 import { onFilesChanged } from 'castle-web-sdk';
 import { initialFiles, initialMedia, isImageFile } from '@imports/castle.physics-2d/engine/files';
+import { hydrateDeclaredFiles } from '@imports/castle.physics-2d/engine/liveReload';
 import { parseFull } from '@imports/castle.physics-2d/engine/pxart';
 import { imageArt } from '@imports/castle.physics-2d/engine/art';
 
@@ -31,8 +32,15 @@ export const initialFiles3D = {
 const DATA_EXTS = ['.scene', '.pxart', '.drawing', '.pxmodel'];
 const CODE_EXTS = ['.js', '.jsx', '.ts', '.tsx', '.css'];
 
+// Extensions the DECK declared that this kit has never heard of, learned from
+// the serve at mount. Module-level because the change classifier runs per
+// event, with no state to thread through -- same shape as the imported kit's.
+const declaredDataExts = new Set();
+
 export function isDataFile3D(path) {
-  return DATA_EXTS.some((ext) => path.endsWith(ext));
+  if (DATA_EXTS.some((ext) => path.endsWith(ext))) return true;
+  for (const ext of declaredDataExts) if (path.endsWith(ext)) return true;
+  return false;
 }
 
 function needsContextReload(change) {
@@ -81,8 +89,12 @@ async function applyDataChanges(changes, setFiles, setDataVersion) {
 // A code change does nothing here, matching the imported hook: only a page
 // reload picks up new code, and throwing one at a panel someone is working in
 // loses their place, so the panel header offers it instead.
-export function useLiveDeckFiles3D({ shouldSkipPath } = {}) {
+export function useLiveDeckFiles3D({ shouldSkipPath, ensurePath } = {}) {
   const [files, setFiles] = useState(initialFiles3D);
+  // False until the declared-type read has settled. An editor mounted before
+  // then would be handed '' for a file that exists, and an edit made in that
+  // window writes its empty document over the real one.
+  const [hydrated, setHydrated] = useState(false);
   // Bumped on every applied data change. The editors watch it to re-apply when
   // a file they REFERENCE changed -- their own `text` is unchanged then, so it
   // is the only signal that the drawing under an actor moved.
@@ -90,6 +102,30 @@ export function useLiveDeckFiles3D({ shouldSkipPath } = {}) {
   const skipRef = useRef(shouldSkipPath);
   skipRef.current = shouldSkipPath;
 
+  // Same gap, same fix as the imported kit: the glob above is a compile-time
+  // transform, so a type the DECK declares is invisible to it. `initialFiles3D`
+  // is what this kit already knows, models included.
+  useEffect(() => {
+    let alive = true;
+    void hydrateDeclaredFiles({
+      knownExts: DATA_EXTS,
+      knownFiles: initialFiles3D,
+      ensurePath,
+    }).then((found) => {
+      if (!alive) return;
+      if (found) {
+        for (const ext of found.exts) declaredDataExts.add(ext);
+        if (Object.keys(found.extra).length) {
+          setFiles((current) => ({ ...found.extra, ...current }));
+        }
+      }
+      setHydrated(true);
+    });
+    return () => {
+      alive = false;
+    };
+  }, [ensurePath]);
+
   useEffect(
     () =>
       onFilesChanged((event) => {
@@ -102,7 +138,7 @@ export function useLiveDeckFiles3D({ shouldSkipPath } = {}) {
     []
   );
 
-  return { files, setFiles, dataVersion };
+  return { files, setFiles, dataVersion, hydrated };
 }
 
 // The sprites map with parsed pxarts CACHED BY TEXT: re-parsing every file on

package/kits/physics-3d/theme.style

@@ -0,0 +1,3 @@
+{
+  "palette": "endesga-64"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "castle-web-cli",
-  "version": "0.4.133",
+  "version": "0.4.134",
   "type": "module",
   "bin": {
     "castle-web": "./dist/index.js"