frameos-editor 2026.7.3 → 2026.7.6

package/README.md

@@ -2,8 +2,12 @@
 
 The [FrameOS](https://frameos.net) visual scene editor — the same node-graph editor the FrameOS
 backend ships — as an embeddable static bundle. No backend needed: the app catalog and app sources
-are embedded at build time, scenes go in and come back out as JSON over `postMessage`. JS app
-sources can be viewed and edited in the built-in Monaco editor.
+are embedded at build time, scenes go in and come back out as JSON over `postMessage`. The editor
+carries the full scene workspace: the node diagram plus side panels for scene settings, state
+variables, the app catalog, events and raw scene JSON; app sources open in a Monaco editor modal.
+When the [`frameos-wasm`](https://www.npmjs.com/package/frameos-wasm) package's assets are served
+next to the bundle (at `./frameos-wasm/` relative to `dist/`), the Preview panel runs the edited
+scenes live through the FrameOS WebAssembly runtime — canvas, scene state and runtime logs included.
 
 The package version always equals the FrameOS release it was built from.
 
@@ -36,7 +40,10 @@ editor.destroy()
 
 Parent → editor:
 
-- `{type: 'frameos-editor:init', scenes, sceneId?, mode?, width?, height?, interval?}`
+- `{type: 'frameos-editor:init', scenes, sceneId?, mode?, width?, height?, interval?, theme?, previewProxyUrl?, description?}` —
+  `theme` is `'light' | 'dark'`; `previewProxyUrl` is an optional same-origin endpoint the in-editor wasm live
+  preview routes CORS-blocked HTTP requests through; `description` is the embedding page's description of the
+  scene, shown in the Scene settings panel
 - `{type: 'frameos-editor:get-scenes'}` — replies with a `:scenes` message
 - `{type: 'frameos-editor:select-scene', sceneId}`
 
@@ -45,6 +52,9 @@ Editor → parent:
 - `{type: 'frameos-editor:ready'}` — once listening (the helper auto-sends `init` on this)
 - `{type: 'frameos-editor:scenes', scenes}` — after every edit (debounced) and as the
   `:get-scenes` reply
+- `{type: 'frameos-editor:save-screenshot', dataUrl, sceneId}` — the Preview panel captured a frame;
+  reply with `{type: 'frameos-editor:screenshot-saved', ok, error?, fallbackDownload?}` to store it
+  yourself, or stay silent and the editor downloads the PNG locally after a short timeout
 
 ## Demo
 

package/dist/index.html

@@ -8,13 +8,19 @@
       // Serve this directory anywhere; asset URLs resolve relative to it.
       window.FRAMEOS_APP_CONFIG = { ingress_path: new URL('.', location.href).pathname.replace(/\/$/, '') }
       window.ESBUILD_LOAD_CHUNKS = function () {}
+      window.FRAMEOS_EMBEDDED_NO_BACKEND = true
+      // Default theme before the bundle loads; the embedding page can
+      // override it via the init message's `theme`.
+      const theme = window.matchMedia?.('(prefers-color-scheme: dark)').matches ? 'dark' : 'light'
+      document.documentElement.dataset.frameosTheme = theme
+      document.documentElement.style.colorScheme = theme
     </script>
-    <link rel="stylesheet" href="./static/editor.css" />
+    <link rel="stylesheet" href="./static/editor-H74LRON2.css" />
   </head>
   <body>
     <div id="root"></div>
     <div id="modal" style="position: absolute; z-index: 10"></div>
     <div id="popper" style="position: absolute; z-index: 80"></div>
-    <script type="module" src="./static/editor.js"></script>
+    <script type="module" src="./static/editor-VD5PEDR3.js"></script>
   </body>
 </html>