@kubohiroya/turbowarp-extension-data-editor 0.4.0 → 0.6.0

package/README.ja.md

@@ -10,8 +10,13 @@ TurboWarp拡張が扱う構造化データを、フォームや独自UIで編集
 
 タブ・グループ・グリッドは[共通レイアウトガイド](docs/common-layout.ja.md)を参照してください。標準RJSFとSource/Formで同じJSON宣言を使用し、ホストの起動時フラグ `commonLayout` で有効にします（既定OFF）。
 
-[公開エディター・日英案内](https://kubohiroya.github.io/turbowarp-extension-data-editor/) と
-[公開・検証の運用Issue #26](https://github.com/kubohiroya/turbowarp-extension-data-editor/issues/26) も本リポジトリが所有します。
+既存フォームと下書きを共有する視覚プレビュー、アイコンのホバー表示は[ブロックプレビュー](docs/block-preview.md)を参照してください。
+
+本パッケージはライブラリです。統合したEditorのビルド・検証・GitHub Pages配信は、下流の [TurboWarp-Plus-Editor](https://github.com/kubohiroya/turbowarp-plus-editor) が所有します。本リポジトリのGitHub Pages提供は廃止し、旧URLでEditorやリダイレクトを提供しません。
+
+<p><a class="twpe-edit-button" href="https://kubohiroya.github.io/turbowarp-plus-editor/editor.html?lang=ja"><img src="https://kubohiroya.github.io/turbowarp-plus-editor/assets/icon.svg" width="32" height="32" alt=""> TurboWarp-Plus-Editorで編集</a></p>
+
+ボタンのHTMLとスタイルは [TurboWarp-Plus-EditorのREADME](https://github.com/kubohiroya/turbowarp-plus-editor#edit-button) を参照してください。
 
 ## 標準の JSON Schema エディター
 
@@ -127,12 +132,12 @@ npm install --save-exact @kubohiroya/turbowarp-extension-data-editor@0.2.2
 
 対応GUIはダイアログ、ソースフォーム、共通レイアウト、固定入力、子孫編集、一括セキュリティ確認を標準で提供します。
 通常の `editor.html?lang=ja` で利用でき、有効化用URLスイッチは不要です。低水準APIのhost能力交渉は維持します。
-切戻しはGUIの変更と公開ページのGUI pinを一組でrevertします。
+切戻しはGUIの変更とTurboWarp-Plus-Editorの固定ソース設定を対応させてrevertします。
 確定値は既存引数へ保存し、UI・下書き・関数・revision をプロジェクトデータへ追加しません。
 
 ## webpack 4 / E2E
 
-[webpack 4配布物と設定API](docs/webpack4.md)、[GUI接続E2EとCIの実行手順](docs/block-editor-e2e.md)を参照。専用編集UIから互換ビルド・E2Eまで共通側で管理し、GUIには明示的なホスト接続とCI呼出しを残す。
+[webpack 4配布物と設定API](docs/webpack4.md)、[GUI接続E2EとCIの実行手順](docs/block-editor-e2e.md)を参照。本リポジトリは専用編集UIと互換ビルドを管理します。GUIはホスト接続、TurboWarp-Plus-Editorは統合ビルド・E2E・配信を管理します。
 
 ## Schemaの共通型と診断変換
 

package/README.md

@@ -10,8 +10,11 @@ Japanese guides for usage, APIs, GUI integration, publishing, and validation rec
 
 For tabs, groups, and grids, see the [shared layout guide (Japanese)](docs/common-layout.ja.md). Standard RJSF and Source/Form use the same JSON declarations, enabled by the host's startup flag `commonLayout` (off by default).
 
-This repository also owns the [public editor and English/Japanese guides](https://kubohiroya.github.io/turbowarp-extension-data-editor/) and
-[deployment and validation tracking issue #26](https://github.com/kubohiroya/turbowarp-extension-data-editor/issues/26).
+This package is a library. The downstream [TurboWarp-Plus-Editor](https://github.com/kubohiroya/turbowarp-plus-editor) owns the integrated Editor build, validation and GitHub Pages distribution. This repository no longer provides GitHub Pages; its former URL does not serve an Editor or a redirect.
+
+<p><a class="twpe-edit-button" href="https://kubohiroya.github.io/turbowarp-plus-editor/editor.html?lang=en"><img src="https://kubohiroya.github.io/turbowarp-plus-editor/assets/icon.svg" width="32" height="32" alt=""> Edit in TurboWarp-Plus-Editor</a></p>
+
+See the [TurboWarp-Plus-Editor README](https://github.com/kubohiroya/turbowarp-plus-editor#edit-button) for the reusable button HTML and stylesheet.
 
 ## Standard JSON Schema editor
 
@@ -127,12 +130,12 @@ For `.sb3` saving, reloading through `project_url` and the OS file picker, Engli
 
 Supported GUIs provide dialogs, source forms, shared layouts, fixed inputs, descendant editing, and batch security confirmation by default.
 These are available at the normal `editor.html?lang=ja` URL without activation switches. Low-level API host capability negotiation remains in place.
-To roll back, revert the GUI changes together with the public page's GUI pin.
+To roll back, revert the GUI changes together with TurboWarp-Plus-Editor's pinned source configuration.
 Committed values are stored in existing arguments. UI state, drafts, functions, and revisions are not added to project data.
 
 ## webpack 4 / E2E
 
-See the [webpack 4 distribution and configuration API (Japanese)](docs/webpack4.md) and [GUI integration E2E and CI procedures (Japanese)](docs/block-editor-e2e.md). This shared repository manages the custom editor UI, compatibility builds, and E2E tests; the GUI retains explicit host integration and CI calls.
+See the [webpack 4 distribution and configuration API (Japanese)](docs/webpack4.md) and [GUI integration E2E and CI procedures (Japanese)](docs/block-editor-e2e.md). This shared repository manages the custom editor UI and compatibility builds. The GUI owns host integration, and TurboWarp-Plus-Editor owns integrated builds, E2E tests and distribution.
 
 ## Shared Schema types and diagnostic conversion
 

package/dist/build-info.json

@@ -1,10 +1,10 @@
 {
   "name": "@kubohiroya/turbowarp-extension-data-editor",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "repository": "https://github.com/kubohiroya/turbowarp-extension-data-editor",
-  "revision": "f728dcb8ab0848c7140f97ee15c7894b525dca4c",
+  "revision": "91533dbbffa9eb9d3b50be8084b85dae5184f9dc",
   "sourceState": "commit",
-  "sourceSha256": "db10dc8cf2cfafa9e0e7275c2f19b66410a4a886c3f021c8c5de1eec301f4b9c",
+  "sourceSha256": "6d60745c40f7b4258f2c80c1e9ec316988e2d7cf8d68042130e156a76255d95d",
   "capabilities": {
     "preparedSource": 1
   }

package/dist/descendants.js

@@ -260,6 +260,7 @@ _DescendantSession_snapshot = new WeakMap(), _DescendantSession_host = new WeakM
     const listeners = new Set();
     const editor = Object.freeze({
         reference: descriptor.reference,
+        getSnapshot: () => snapshot,
         getDraft: () => { __classPrivateFieldGet(this, _DescendantSession_instances, "m", _DescendantSession_assertOpen).call(this); return cloneJson(record.draft); },
         setDraft: (draft) => {
             __classPrivateFieldGet(this, _DescendantSession_instances, "m", _DescendantSession_assertEditable).call(this);

package/dist/preview.d.ts

@@ -0,0 +1,3 @@
+import type { BlockPreviewDefinition, EditorDefinition } from './types.js';
+/** Compose presentation only; the original definition retains sole authority over persistence. */
+export declare function withBlockPreview(original: EditorDefinition | undefined, preview: BlockPreviewDefinition, opcode: string): EditorDefinition;

package/dist/preview.js

@@ -0,0 +1,100 @@
+const cache = new WeakMap();
+/** Compose presentation only; the original definition retains sole authority over persistence. */
+export function withBlockPreview(original, preview, opcode) {
+    let entries = cache.get(preview);
+    if (!entries) {
+        entries = new Map();
+        cache.set(preview, entries);
+    }
+    const previous = entries.get(opcode);
+    if (previous && previous.original === original)
+        return previous.result;
+    const fallback = {
+        apiVersion: 1, extensionId: preview.extensionId, editorId: 'block-preview', opcodes: [opcode], editableArguments: [],
+        read: () => ({}), validate: () => [], createPatch: () => []
+    };
+    const result = Object.freeze({ ...original !== null && original !== void 0 ? original : fallback, mount(container, context) {
+            var _a;
+            const snapshot = (_a = context.getSnapshot) === null || _a === void 0 ? void 0 : _a.call(context);
+            if (!snapshot)
+                throw new TypeError('Block preview requires a captured snapshot.');
+            const document = container.ownerDocument;
+            const layout = document.createElement('div');
+            layout.dataset.blockPreviewLayout = '';
+            layout.dataset.blockPreviewHasForm = String(typeof (original === null || original === void 0 ? void 0 : original.mount) === 'function');
+            const style = document.createElement('style');
+            style.textContent = `
+      [data-block-preview-layout] {
+        display: grid; grid-template-columns: minmax(0, 1fr); gap: 16px;
+        min-width: 0; width: 100%; align-items: start;
+      }
+      [data-block-preview-layout] > [data-block-preview-visual],
+      [data-block-preview-layout] > [data-block-preview-form] {
+        min-width: 0; max-width: 100%; overflow-wrap: anywhere;
+      }
+      @media (min-width: 900px) {
+        [data-block-preview-layout][data-block-preview-has-form="true"] {
+          grid-template-columns: minmax(0, 1fr) minmax(0, 1fr);
+        }
+        [data-block-preview-layout][data-block-preview-has-form="true"] > [data-block-preview-visual] {
+          position: sticky; top: 0; align-self: start;
+        }
+      }
+    `;
+            const visual = document.createElement('div');
+            visual.dataset.blockPreviewVisual = '';
+            const form = document.createElement('div');
+            form.dataset.blockPreviewForm = '';
+            form.hidden = typeof (original === null || original === void 0 ? void 0 : original.mount) !== 'function';
+            layout.append(visual, form);
+            container.append(style, layout);
+            const removeLayout = () => { layout.remove(); style.remove(); };
+            let removeForm;
+            let removePreview;
+            try {
+                if (original === null || original === void 0 ? void 0 : original.mount) {
+                    const cleanup = original.mount(form, context);
+                    if (typeof cleanup !== 'function')
+                        throw new TypeError('mount() must return a cleanup function.');
+                    removeForm = cleanup;
+                }
+                const cleanup = preview.mount(visual, context, snapshot);
+                if (typeof cleanup !== 'function')
+                    throw new TypeError('preview.mount() must return a cleanup function.');
+                removePreview = cleanup;
+            }
+            catch (error) {
+                try {
+                    removePreview === null || removePreview === void 0 ? void 0 : removePreview();
+                }
+                finally {
+                    try {
+                        removeForm === null || removeForm === void 0 ? void 0 : removeForm();
+                    }
+                    finally {
+                        removeLayout();
+                    }
+                }
+                throw error;
+            }
+            let active = true;
+            return () => {
+                if (!active)
+                    return;
+                active = false;
+                try {
+                    removePreview === null || removePreview === void 0 ? void 0 : removePreview();
+                }
+                finally {
+                    try {
+                        removeForm === null || removeForm === void 0 ? void 0 : removeForm();
+                    }
+                    finally {
+                        removeLayout();
+                    }
+                }
+            };
+        } });
+    entries.set(opcode, { original, result });
+    return result;
+}

package/dist/registry.d.ts

@@ -1,3 +1,4 @@
+import type { BlockPreviewDefinition } from './types.js';
 import { EditorSession } from './session.js';
 import { DescendantSession } from './descendants.js';
 import type { DescendantLimits } from './descendant-types.js';
@@ -6,6 +7,8 @@ import type { PreparedEditorDefinition } from './prepared-types.js';
 import type { FixedInputDeclaration, FixedInputEditorDefinition } from './fixed-input-types.js';
 export declare class EditorRegistry {
     #private;
+    registerPreview(definition: BlockPreviewDefinition): () => void;
+    resolvePreview(opcode: string): BlockPreviewDefinition | undefined;
     register(definition: EditorDefinition): () => void;
     registerPrepared(definition: PreparedEditorDefinition): () => void;
     registerFixed<C = null>(definition: FixedInputEditorDefinition<C>): () => void;

package/dist/registry.js

@@ -3,8 +3,9 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _EditorRegistry_instances, _EditorRegistry_editors, _EditorRegistry_opcodes, _EditorRegistry_fixedDeclarations, _EditorRegistry_changes, _EditorRegistry_register, _EditorRegistry_notifyChanges;
+var _EditorRegistry_instances, _EditorRegistry_previews, _EditorRegistry_editors, _EditorRegistry_opcodes, _EditorRegistry_fixedDeclarations, _EditorRegistry_changes, _EditorRegistry_definition, _EditorRegistry_register, _EditorRegistry_notifyChanges;
 import { captureReference, captureSnapshot } from './data.js';
+import { withBlockPreview } from './preview.js';
 import { EditorSession } from './session.js';
 import { DescendantSession } from './descendants.js';
 import { supportsDescendantEditing } from './descendant-types.js';
@@ -17,11 +18,35 @@ import { supportsFixedInputEditing } from './fixed-input-types.js';
 export class EditorRegistry {
     constructor() {
         _EditorRegistry_instances.add(this);
+        _EditorRegistry_previews.set(this, new Map());
         _EditorRegistry_editors.set(this, new Map());
         _EditorRegistry_opcodes.set(this, new Map());
         _EditorRegistry_fixedDeclarations.set(this, new Map());
         _EditorRegistry_changes.set(this, new Set());
     }
+    registerPreview(definition) {
+        if (!definition || !/^[a-z0-9]+$/i.test(definition.extensionId) ||
+            !Array.isArray(definition.opcodes) || !definition.opcodes.length ||
+            new Set(definition.opcodes).size !== definition.opcodes.length ||
+            definition.opcodes.some(op => typeof op !== 'string' || !op.startsWith(`${definition.extensionId}_`) ||
+                op === `${definition.extensionId}_` || __classPrivateFieldGet(this, _EditorRegistry_previews, "f").has(op)) ||
+            typeof definition.mount !== 'function' ||
+            (definition.hover !== undefined && typeof definition.hover !== 'function')) {
+            throw new TypeError('Invalid or duplicate block preview.');
+        }
+        const entry = Object.freeze({ ...definition, opcodes: Object.freeze([...definition.opcodes]) });
+        for (const op of entry.opcodes)
+            __classPrivateFieldGet(this, _EditorRegistry_previews, "f").set(op, entry);
+        __classPrivateFieldGet(this, _EditorRegistry_instances, "m", _EditorRegistry_notifyChanges).call(this);
+        return () => {
+            if (__classPrivateFieldGet(this, _EditorRegistry_previews, "f").get(entry.opcodes[0]) !== entry)
+                return;
+            for (const op of entry.opcodes)
+                __classPrivateFieldGet(this, _EditorRegistry_previews, "f").delete(op);
+            __classPrivateFieldGet(this, _EditorRegistry_instances, "m", _EditorRegistry_notifyChanges).call(this);
+        };
+    }
+    resolvePreview(opcode) { return __classPrivateFieldGet(this, _EditorRegistry_previews, "f").get(opcode); }
     register(definition) {
         if (isFixedInputEditor(definition))
             throw new TypeError('Fixed input editors require registerFixed().');
@@ -39,7 +64,7 @@ export class EditorRegistry {
         return __classPrivateFieldGet(this, _EditorRegistry_instances, "m", _EditorRegistry_register).call(this, captureFixedInputEditorDefinition(definition));
     }
     resolve(opcode) {
-        const entry = __classPrivateFieldGet(this, _EditorRegistry_opcodes, "f").get(opcode);
+        const entry = __classPrivateFieldGet(this, _EditorRegistry_instances, "m", _EditorRegistry_definition).call(this, opcode);
         if (!entry)
             return undefined;
         return Object.freeze({
@@ -57,7 +82,7 @@ export class EditorRegistry {
         const live = host.readBlock(capturedReference);
         if (!live)
             return undefined;
-        const entry = __classPrivateFieldGet(this, _EditorRegistry_opcodes, "f").get(live.opcode);
+        const entry = __classPrivateFieldGet(this, _EditorRegistry_instances, "m", _EditorRegistry_definition).call(this, live.opcode);
         if (!entry) {
             // Preserve legacy snapshot validation even when no editor is registered.
             captureSnapshot(live, capturedReference);
@@ -70,14 +95,14 @@ export class EditorRegistry {
             if (!fixed || fixed.opcode !== live.opcode)
                 return undefined;
             const snapshot = captureFixedSnapshot(fixed, capturedReference, entry);
-            return new EditorSession(entry, snapshot, host, () => __classPrivateFieldGet(this, _EditorRegistry_opcodes, "f").get(snapshot.opcode) === entry, listener => {
+            return new EditorSession(entry, snapshot, host, () => __classPrivateFieldGet(this, _EditorRegistry_instances, "m", _EditorRegistry_definition).call(this, snapshot.opcode) === entry, listener => {
                 __classPrivateFieldGet(this, _EditorRegistry_changes, "f").add(listener);
                 return () => { __classPrivateFieldGet(this, _EditorRegistry_changes, "f").delete(listener); };
             });
         }
         const snapshot = captureSnapshot(live, capturedReference);
-        return new EditorSession(entry, snapshot, host, isPreparedEditor(entry)
-            ? () => __classPrivateFieldGet(this, _EditorRegistry_opcodes, "f").get(snapshot.opcode) === entry : undefined);
+        return new EditorSession(entry, snapshot, host, isPreparedEditor(entry) || __classPrivateFieldGet(this, _EditorRegistry_previews, "f").has(snapshot.opcode)
+            ? () => __classPrivateFieldGet(this, _EditorRegistry_instances, "m", _EditorRegistry_definition).call(this, snapshot.opcode) === entry : undefined);
     }
     openDescendants(reference, host, limits) {
         if (!supportsDescendantEditing(host))
@@ -89,11 +114,11 @@ export class EditorRegistry {
         if (!live)
             return undefined;
         const captured = captureSubtree(live, capturedReference, resolvedLimits);
-        const root = __classPrivateFieldGet(this, _EditorRegistry_opcodes, "f").get(captured.snapshot.nodes[0].block.opcode);
+        const root = __classPrivateFieldGet(this, _EditorRegistry_instances, "m", _EditorRegistry_definition).call(this, captured.snapshot.nodes[0].block.opcode);
         if (!root || isFixedInputEditor(root))
             return undefined;
         return new DescendantSession(captured, port, opcode => {
-            const entry = __classPrivateFieldGet(this, _EditorRegistry_opcodes, "f").get(opcode);
+            const entry = __classPrivateFieldGet(this, _EditorRegistry_instances, "m", _EditorRegistry_definition).call(this, opcode);
             return entry && !isFixedInputEditor(entry) ? entry : undefined;
         }, listener => {
             __classPrivateFieldGet(this, _EditorRegistry_changes, "f").add(listener);
@@ -101,7 +126,11 @@ export class EditorRegistry {
         }, resolvedLimits);
     }
 }
-_EditorRegistry_editors = new WeakMap(), _EditorRegistry_opcodes = new WeakMap(), _EditorRegistry_fixedDeclarations = new WeakMap(), _EditorRegistry_changes = new WeakMap(), _EditorRegistry_instances = new WeakSet(), _EditorRegistry_register = function _EditorRegistry_register(definition) {
+_EditorRegistry_previews = new WeakMap(), _EditorRegistry_editors = new WeakMap(), _EditorRegistry_opcodes = new WeakMap(), _EditorRegistry_fixedDeclarations = new WeakMap(), _EditorRegistry_changes = new WeakMap(), _EditorRegistry_instances = new WeakSet(), _EditorRegistry_definition = function _EditorRegistry_definition(opcode) {
+    const original = __classPrivateFieldGet(this, _EditorRegistry_opcodes, "f").get(opcode);
+    const preview = __classPrivateFieldGet(this, _EditorRegistry_previews, "f").get(opcode);
+    return preview ? withBlockPreview(original, preview, opcode) : original;
+}, _EditorRegistry_register = function _EditorRegistry_register(definition) {
     if (definition.apiVersion !== EDITOR_API_VERSION)
         throw new TypeError('Unsupported editor API version.');
     if (!/^[a-z0-9]+$/i.test(definition.extensionId) ||

package/dist/rjsf.d.ts

@@ -16,7 +16,7 @@ import type { SchemaBundle, SchemaJsonObject, SchemaValidationContext, SyncOwner
 import type { SourceFormat } from './codec.js';
 import { EditorRegistry } from './registry.js';
 import { EDITOR_API_VERSION } from './types.js';
-import type { BlockSnapshot, EditorDefinition, JsonValue, ValidationIssue } from './types.js';
+import type { BlockPreviewDefinition, BlockSnapshot, EditorDefinition, JsonValue, ValidationIssue } from './types.js';
 export interface SchemaEditorOptions {
     readonly apiVersion: typeof EDITOR_API_VERSION;
     readonly extensionId: string;
@@ -41,6 +41,7 @@ export declare function createSchemaBundleEditor<C>(options: SchemaBundleEditorO
 export interface BlockEditorRegistrationAPI {
     readonly apiVersion: typeof EDITOR_API_VERSION;
     register(definition: EditorDefinition | SchemaEditorOptions): () => void;
+    registerPreview?(definition: BlockPreviewDefinition): () => void;
     registerSchema(definition: SchemaEditorOptions): () => void;
     registerSchemaBundle?<C>(definition: SchemaBundleEditorOptions<C>): () => void;
     registerSourceEditor?<C = null>(definition: SourceEditorOptions<C>): () => void;

package/dist/rjsf.js

@@ -105,6 +105,16 @@ export function createBlockEditorService(options) {
     const api = Object.freeze({
         ...fixed,
         apiVersion: EDITOR_API_VERSION,
+        registerPreview: (definition) => {
+            const remove = registry.registerPreview(definition);
+            notify();
+            let active = true;
+            return () => { if (active) {
+                active = false;
+                remove();
+                notify();
+            } };
+        },
         register: (definition) => {
             const custom = definition;
             const editor = !custom.mount && Object.hasOwn(definition, 'schema')

package/dist/session.d.ts

@@ -12,6 +12,7 @@ export declare class EditorSession implements EditorViewContext {
     setValidationIssues(issues: readonly ValidationIssue[]): void;
     getState(): SessionState;
     subscribe(listener: () => void): () => void;
+    getSnapshot(): BlockSnapshot;
     mount(container: HTMLElement): () => void;
     save(): Promise<SaveResult>;
     /** Closing is refused while saving; the host must keep the modal open. */

package/dist/session.js

@@ -158,6 +158,12 @@ export class EditorSession {
         __classPrivateFieldGet(this, _EditorSession_listeners, "f").add(listener);
         return () => { __classPrivateFieldGet(this, _EditorSession_listeners, "f").delete(listener); };
     }
+    getSnapshot() {
+        __classPrivateFieldGet(this, _EditorSession_instances, "m", _EditorSession_assertOpen).call(this);
+        return isFixedInputEditor(__classPrivateFieldGet(this, _EditorSession_definition, "f"))
+            ? captureFixedSnapshot(__classPrivateFieldGet(this, _EditorSession_snapshot, "f"), this.reference, __classPrivateFieldGet(this, _EditorSession_definition, "f"))
+            : captureSnapshot(__classPrivateFieldGet(this, _EditorSession_snapshot, "f"), this.reference);
+    }
     mount(container) {
         return __classPrivateFieldGet(this, _EditorSession_view, "f").mount(container, __classPrivateFieldGet(this, _EditorSession_definition, "f").mount, this);
     }

package/dist/turbowarp/bridge.js

@@ -6,10 +6,14 @@ import createBlockEditorErrorSession from './error-session.js';
 const fixedDeclaration = (registry, snapshot) => snapshot && typeof registry.resolveFixed === 'function' &&
     registry.resolveFixed(snapshot.opcode);
 const openBlockEditorSession = ({ registry, reference, host, descendants }) => {
+    var _a;
     const snapshot = host.readBlock ? host.readBlock(reference) : null;
     // A fixed registration owns only this block; legacy aggregate traversal stays fail-closed.
     if (fixedDeclaration(registry, snapshot))
         return supportsFixedInputEditing(host) ? registry.open(reference, host) : undefined;
+    // A preview owns this icon's scene/action, not a separate live renderer for every descendant.
+    if (snapshot && ((_a = registry.resolvePreview) === null || _a === void 0 ? void 0 : _a.call(registry, snapshot.opcode)))
+        return registry.open(reference, host);
     return descendants && supportsDescendantEditing(host) ?
         registry.openDescendants(reference, host) : registry.open(reference, host);
 };
@@ -22,6 +26,19 @@ const createBlockEditorBridge = ({ ScratchBlocks, workspace, vm, service, label,
         enableFixedInputs: fixedInputs,
         onError });
     const decorations = new Map();
+    let stopHover = null;
+    const clearHover = () => {
+        const stop = stopHover;
+        stopHover = null;
+        if (stop) {
+            try {
+                stop();
+            }
+            catch (error) {
+                onError(error);
+            }
+        }
+    };
     let disposed = false;
     let timer = null;
     let activeSession = null;
@@ -81,6 +98,7 @@ const createBlockEditorBridge = ({ ScratchBlocks, workspace, vm, service, label,
     };
     const open = block => {
         var _a, _b;
+        clearHover();
         if (activeSession && ['editing', 'saving'].includes(activeSession.getState().status))
             return;
         const reference = { targetId: vm.editingTarget.id, blockId: block.id };
@@ -141,10 +159,31 @@ const createBlockEditorBridge = ({ ScratchBlocks, workspace, vm, service, label,
                 element: field.fieldGroup_,
                 label,
                 canOpen: () => available(block),
-                onOpen: () => open(block)
+                onOpen: () => open(block),
+                onHover: () => {
+                    var _a, _b;
+                    if (!available(block) || activeSession && ['editing', 'saving'].includes(activeSession.getState().status))
+                        return;
+                    clearHover();
+                    const preview = (_b = (_a = service.registry).resolvePreview) === null || _b === void 0 ? void 0 : _b.call(_a, block.type);
+                    const snapshot = host.readBlock({ targetId: vm.editingTarget.id, blockId: block.id });
+                    if ((preview === null || preview === void 0 ? void 0 : preview.hover) && snapshot) {
+                        try {
+                            const stop = preview.hover(field.fieldGroup_, snapshot);
+                            if (typeof stop !== 'function')
+                                throw new TypeError('hover() must return a cleanup function.');
+                            stopHover = stop;
+                        }
+                        catch (error) {
+                            onError(error);
+                        }
+                    }
+                },
+                onLeave: clearHover
             });
             decorations.set(block.id, { field,
                 cleanup: () => {
+                    clearHover();
                     unbind();
                     if (field.imageElement_)
                         field.imageElement_.tooltip = tooltip;
@@ -158,6 +197,7 @@ const createBlockEditorBridge = ({ ScratchBlocks, workspace, vm, service, label,
         }
     };
     const schedule = () => {
+        clearHover();
         checkSession();
         clearTimeout(timer);
         timer = setTimeout(refresh, 0);
@@ -184,6 +224,7 @@ const createBlockEditorBridge = ({ ScratchBlocks, workspace, vm, service, label,
         refresh,
         dispose: () => {
             disposed = true;
+            clearHover();
             clearTimeout(timer);
             unregister();
             workspace.removeChangeListener(schedule);

package/dist/turbowarp/fixed-fields.d.ts

@@ -61,7 +61,7 @@ export function inspectFixedArgument({ ScratchBlocks, block, vmBlock, target, ar
     };
     slot: {
         kind: string;
-        value: string;
+        value: string | number;
     };
     metadata: {
         role: any;

package/dist/turbowarp/fixed-fields.js

@@ -217,7 +217,12 @@ export function inspectFixedArgument({ ScratchBlocks, block, vmBlock, target, ar
     if (!safeField(field, Class))
         return unavailable('unsupported', 'The field class, methods or validator is unsupported.', raw);
     const value = inherited(Class.prototype, 'getValue').call(field);
-    if (!Object.is(value, raw))
+    // SB3 numeric primitives remain numbers in the VM while FieldNumber displays a string.
+    // Preserve the original VM primitive in the snapshot; only equivalent native numeric text
+    // is a synchronized representation. Other field families still require exact raw identity.
+    const numericPrimitive = kind === 'number' && typeof raw === 'number' && Number.isFinite(raw) &&
+        typeof value === 'string' && token.test(value.trim()) && Number(value) === raw;
+    if (!Object.is(value, raw) && !numericPrimitive)
         return null;
     if (typeof value !== 'string')
         return unavailable('unsupported', 'The native field value is not a string.', raw);
@@ -231,7 +236,7 @@ export function inspectFixedArgument({ ScratchBlocks, block, vmBlock, target, ar
         restoreHandles: inherited(Class.prototype, 'updateSliderHandles_'),
         restoreDom: inherited(Class.prototype, 'updateDom_'),
         ...(kind === 'color' ? { restoreState: colorState(owner, field) } : {}) };
-    return { slot: { kind: 'literal', value }, metadata: { role, source: direct ? 'field' : 'shadow',
+    return { slot: { kind: 'literal', value: numericPrimitive ? raw : value }, metadata: { role, source: direct ? 'field' : 'shadow',
             identity: JSON.stringify(sourceIdentity), field: { blockId: owner.id, name, type: { text: 'FieldTextInput', number: 'FieldNumber', menu: 'FieldDropdown', color: 'FieldColourSlider' }[kind] } },
         ...(role === 'editable' ? { binding } : {}), signatureParts: [...sourceIdentity, observedFields] };
 }

package/dist/turbowarp/icon.d.ts

@@ -1,7 +1,9 @@
 export default bindBlockEditorIcon;
-declare function bindBlockEditorIcon({ element, label, canOpen, onOpen }: {
+declare function bindBlockEditorIcon({ element, label, canOpen, onOpen, onHover, onLeave }: {
     element: any;
     label: any;
     canOpen: any;
     onOpen: any;
+    onHover?: (() => void) | undefined;
+    onLeave?: (() => void) | undefined;
 }): () => void;

package/dist/turbowarp/icon.js

@@ -1,5 +1,5 @@
 // Decorate one known FieldImage; never search or intercept unrelated workspace DOM.
-const bindBlockEditorIcon = ({ element, label, canOpen, onOpen }) => {
+const bindBlockEditorIcon = ({ element, label, canOpen, onOpen, onHover = () => { }, onLeave = () => { } }) => {
     const attributes = ['role', 'tabindex', 'aria-label', 'data-block-editor-icon'];
     const previous = attributes.map(name => element.getAttribute(name));
     const oldCursor = element.style.cursor;
@@ -48,7 +48,11 @@ const bindBlockEditorIcon = ({ element, label, canOpen, onOpen }) => {
                 onOpen();
         }
     };
+    const enter = () => { if (canOpen())
+        onHover === null || onHover === void 0 ? void 0 : onHover(); };
+    const leave = () => onLeave === null || onLeave === void 0 ? void 0 : onLeave();
     const listeners = [
+        ['pointerenter', enter], ['pointerleave', leave], ['focus', enter], ['blur', leave],
         ['pointerdown', down], ['pointermove', move], ['pointerup', up], ['pointercancel', cancel],
         ['mousedown', stop], ['mouseup', stop], ['click', stop], ['dblclick', stop],
         ['touchstart', stop], ['touchend', stop], ['touchmove', stop], ['keydown', key]

package/dist/turbowarp.d.ts

@@ -59,6 +59,8 @@ export declare function bindBlockEditorIcon(options: {
     readonly label: string;
     readonly canOpen: () => boolean;
     readonly onOpen: () => void;
+    readonly onHover?: () => void;
+    readonly onLeave?: () => void;
 }): () => void;
 /** Supply editor arguments to include other literal inputs as parenthesized identifiers. */
 export declare function readBlockEditorAppearance(block: object | null, ScratchBlocks: object, editableArguments?: readonly string[]): TurboWarpNodeAppearance;

package/dist/types.d.ts

@@ -54,6 +54,7 @@ export interface SessionState {
     readonly error: unknown;
 }
 export interface EditorViewContext {
+    getSnapshot?(): BlockSnapshot;
     getDraft(): JsonObject;
     /** Fixed views obtain only safe presentation data, never live host objects. */
     getFixedInputView?(): FixedInputViewDescription | undefined;
@@ -72,6 +73,13 @@ export interface EditorDescriptor {
     readonly opcodes: readonly string[];
     readonly editableArguments: readonly string[];
 }
+/** Optional presentation companion. It shares the draft and lifetime of the existing form. */
+export interface BlockPreviewDefinition {
+    readonly extensionId: string;
+    readonly opcodes: readonly string[];
+    mount(container: HTMLElement, context: EditorViewContext, snapshot: BlockSnapshot): () => void;
+    hover?(anchor: HTMLElement | SVGElement, snapshot: BlockSnapshot): () => void;
+}
 export interface EditorDefinition extends EditorDescriptor {
     read(snapshot: BlockSnapshot): JsonObject;
     validate(draft: JsonObject, snapshot: BlockSnapshot): readonly ValidationIssue[] | Promise<readonly ValidationIssue[]>;

package/dist/view.js

@@ -35,6 +35,7 @@ export class EditorView {
             subscriptions.clear();
         };
         const context = Object.freeze({
+            ...(owner.getSnapshot ? { getSnapshot: () => { assertMounted(); return owner.getSnapshot(); } } : {}),
             getDraft: () => owner.getDraft(),
             ...(owner.getFixedInputView ? { getFixedInputView: () => {
                     assertMounted();

package/dist/webpack4/index.js

@@ -10,7 +10,7 @@ import {
   sameFixedSnapshot,
   supportsFixedInputEditing,
   supportsFixedInputs
-} from "./shared-QIOZ73LT.js";
+} from "./shared-FW4MRLXW.js";
 import {
   BlockEditorConflictError,
   BlockEditorStructureError,