@kubohiroya/turbowarp-extension-data-editor 0.5.0 → 0.7.0

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,

package/dist/webpack4/metafile.json

@@ -10,8 +10,13 @@
       "imports": [],
       "format": "esm"
     },
+    "dist/preview.js": {
+      "bytes": 4540,
+      "imports": [],
+      "format": "esm"
+    },
     "dist/view.js": {
-      "bytes": 4215,
+      "bytes": 4330,
       "imports": [],
       "format": "esm"
     },
@@ -1868,7 +1873,7 @@
       "format": "esm"
     },
     "dist/session.js": {
-      "bytes": 28647,
+      "bytes": 29156,
       "imports": [
         {
           "path": "dist/data.js",
@@ -1940,7 +1945,7 @@
       "format": "esm"
     },
     "dist/descendants.js": {
-      "bytes": 24370,
+      "bytes": 24407,
       "imports": [
         {
           "path": "dist/data.js",
@@ -1976,13 +1981,18 @@
       "format": "esm"
     },
     "dist/registry.js": {
-      "bytes": 9498,
+      "bytes": 11958,
       "imports": [
         {
           "path": "dist/data.js",
           "kind": "import-statement",
           "original": "./data.js"
         },
+        {
+          "path": "dist/preview.js",
+          "kind": "import-statement",
+          "original": "./preview.js"
+        },
         {
           "path": "dist/session.js",
           "kind": "import-statement",
@@ -14055,7 +14065,7 @@
       "format": "esm"
     },
     "dist/rjsf.js": {
-      "bytes": 15030,
+      "bytes": 15344,
       "imports": [
         {
           "path": "react",
@@ -14170,14 +14180,24 @@
       "imports": [],
       "format": "esm"
     },
+    "dist/dialog-window.js": {
+      "bytes": 7349,
+      "imports": [],
+      "format": "esm"
+    },
     "dist/react.js": {
-      "bytes": 14377,
+      "bytes": 14863,
       "imports": [
         {
           "path": "dist/field-errors.js",
           "kind": "import-statement",
           "original": "./field-errors.js"
         },
+        {
+          "path": "dist/dialog-window.js",
+          "kind": "import-statement",
+          "original": "./dialog-window.js"
+        },
         {
           "path": "dist/field-errors.js",
           "kind": "import-statement",
@@ -14213,7 +14233,7 @@
       "format": "esm"
     },
     "dist/turbowarp/fixed-fields.js": {
-      "bytes": 15007,
+      "bytes": 15532,
       "imports": [],
       "format": "esm"
     },
@@ -14270,7 +14290,7 @@
       "format": "esm"
     },
     "dist/turbowarp/icon.js": {
-      "bytes": 2885,
+      "bytes": 3218,
       "imports": [],
       "format": "esm"
     },
@@ -14285,7 +14305,7 @@
       "format": "esm"
     },
     "dist/turbowarp/bridge.js": {
-      "bytes": 9167,
+      "bytes": 10982,
       "imports": [
         {
           "path": "dist/turbowarp/host.js",
@@ -14361,7 +14381,7 @@
           "kind": "import-statement"
         },
         {
-          "path": "dist/webpack4/shared-QIOZ73LT.js",
+          "path": "dist/webpack4/shared-FW4MRLXW.js",
           "kind": "import-statement"
         },
         {
@@ -14405,12 +14425,12 @@
       "imports": [],
       "exports": [],
       "inputs": {},
-      "bytes": 1928761
+      "bytes": 1929265
     },
     "dist/webpack4/rjsf.js": {
       "imports": [
         {
-          "path": "dist/webpack4/shared-QIOZ73LT.js",
+          "path": "dist/webpack4/shared-FW4MRLXW.js",
           "kind": "import-statement"
         },
         {
@@ -15483,7 +15503,7 @@
           "bytesInOutput": 275
         },
         "dist/rjsf.js": {
-          "bytesInOutput": 11742
+          "bytesInOutput": 12016
         },
         "dist/config/feature-flags.js": {
           "bytesInOutput": 274
@@ -16809,13 +16829,13 @@
           "bytesInOutput": 11025
         }
       },
-      "bytes": 896935
+      "bytes": 897209
     },
     "dist/webpack4/react.js.map": {
       "imports": [],
       "exports": [],
       "inputs": {},
-      "bytes": 30867
+      "bytes": 43883
     },
     "dist/webpack4/react.js": {
       "imports": [
@@ -16842,17 +16862,20 @@
         "dist/field-errors.js": {
           "bytesInOutput": 3769
         },
+        "dist/dialog-window.js": {
+          "bytesInOutput": 6802
+        },
         "dist/react.js": {
-          "bytesInOutput": 13029
+          "bytesInOutput": 13396
         }
       },
-      "bytes": 17088
+      "bytes": 24283
     },
     "dist/webpack4/turbowarp.js.map": {
       "imports": [],
       "exports": [],
       "inputs": {},
-      "bytes": 118563
+      "bytes": 122586
     },
     "dist/webpack4/turbowarp.js": {
       "imports": [
@@ -16861,7 +16884,7 @@
           "kind": "import-statement"
         },
         {
-          "path": "dist/webpack4/shared-QIOZ73LT.js",
+          "path": "dist/webpack4/shared-FW4MRLXW.js",
           "kind": "import-statement"
         },
         {
@@ -16891,7 +16914,7 @@
           "bytesInOutput": 2252
         },
         "dist/turbowarp/fixed-fields.js": {
-          "bytesInOutput": 13374
+          "bytesInOutput": 13606
         },
         "dist/turbowarp/fixed-transaction.js": {
           "bytesInOutput": 19836
@@ -16900,7 +16923,7 @@
           "bytesInOutput": 13371
         },
         "dist/turbowarp/icon.js": {
-          "bytesInOutput": 2576
+          "bytesInOutput": 2917
         },
         "dist/turbowarp/appearance.js": {
           "bytesInOutput": 1884
@@ -16909,13 +16932,13 @@
           "bytesInOutput": 835
         },
         "dist/turbowarp/bridge.js": {
-          "bytesInOutput": 7193
+          "bytesInOutput": 8571
         },
         "dist/turbowarp.js": {
           "bytesInOutput": 1134
         }
       },
-      "bytes": 63580
+      "bytes": 65531
     },
     "dist/webpack4/shared-FYUILHED.js.map": {
       "imports": [],
@@ -16933,13 +16956,13 @@
       },
       "bytes": 44
     },
-    "dist/webpack4/shared-QIOZ73LT.js.map": {
+    "dist/webpack4/shared-FW4MRLXW.js.map": {
       "imports": [],
       "exports": [],
       "inputs": {},
-      "bytes": 204661
+      "bytes": 216305
     },
-    "dist/webpack4/shared-QIOZ73LT.js": {
+    "dist/webpack4/shared-FW4MRLXW.js": {
       "imports": [
         {
           "path": "dist/webpack4/shared-BKTRZUZH.js",
@@ -16981,25 +17004,28 @@
           "bytesInOutput": 795
         },
         "dist/view.js": {
-          "bytesInOutput": 3765
+          "bytesInOutput": 3894
         },
         "dist/prepared-save.js": {
           "bytesInOutput": 1886
         },
         "dist/session.js": {
-          "bytesInOutput": 26276
+          "bytesInOutput": 26754
         },
         "dist/subtree.js": {
           "bytesInOutput": 4426
         },
         "dist/descendants.js": {
-          "bytesInOutput": 22584
+          "bytesInOutput": 22617
+        },
+        "dist/preview.js": {
+          "bytesInOutput": 3801
         },
         "dist/registry.js": {
-          "bytesInOutput": 8369
+          "bytesInOutput": 10668
         }
       },
-      "bytes": 116031
+      "bytes": 122791
     },
     "dist/webpack4/shared-BKTRZUZH.js.map": {
       "imports": [],