scratch-blocks 2.1.15 → 2.1.17

package/dist/types/src/checkable_continuous_flyout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkable_continuous_flyout.d.ts","sourceRoot":"","sources":["../../../src/checkable_continuous_flyout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAA;AACpF,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAiBvC,qBAAa,yBAA0B,SAAQ,gBAAgB;IAC7D,UAAkB,SAAS,EAAE,MAAM,CAAA;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IAErB;;;OAGG;gBACS,gBAAgB,EAAE,OAAO,CAAC,OAAO;IAQ7C;;;;OAIG;IACH,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ;IAUhD;;;;OAIG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;IAahD,cAAc;IAId,QAAQ;IAIR,SAAS,CAAC,eAAe;IAwBzB;;;;OAIG;IACH,SAAS,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,GAAG,IAAI,IAAI,eAAe;IAO/E;;OAEG;IACH,oBAAoB;IASpB,QAAQ,CAAC,QAAQ,EAAE,MAAM;CAG1B"}
+{"version":3,"file":"checkable_continuous_flyout.d.ts","sourceRoot":"","sources":["../../../src/checkable_continuous_flyout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAA;AACpF,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAkBvC,qBAAa,yBAA0B,SAAQ,gBAAgB;IAC7D,UAAkB,SAAS,EAAE,MAAM,CAAA;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IAErB;;;OAGG;gBACS,gBAAgB,EAAE,OAAO,CAAC,OAAO;IAQ7C;;;;OAIG;IACH,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ;IAWhD;;;;OAIG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;IAahD,cAAc;IAId,QAAQ;IAIR,SAAS,CAAC,eAAe;IAwBzB;;;;OAIG;IACH,SAAS,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,GAAG,IAAI,IAAI,eAAe;IAO/E;;OAEG;IACH,oBAAoB;IASpB,QAAQ,CAAC,QAAQ,EAAE,MAAM;CAG1B"}

package/dist/types/src/scratch_block_paster.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scratch_block_paster.d.ts","sourceRoot":"","sources":["../../../src/scratch_block_paster.ts"],"names":[],"mappings":"AA0CA;;;GAGG;AACH,wBAAgB,0BAA0B,SAGzC"}
+{"version":3,"file":"scratch_block_paster.d.ts","sourceRoot":"","sources":["../../../src/scratch_block_paster.ts"],"names":[],"mappings":"AAiDA;;;GAGG;AACH,wBAAgB,0BAA0B,SAGzC"}

package/dist/types/src/scratch_blocks_utils.d.ts

@@ -20,6 +20,16 @@
  * @file Utility methods for Scratch Blocks but not Blockly.
  * @author fenichel@google.com (Rachel Fenichel)
  */
+import type * as Blockly from 'blockly/core';
+/**
+ * Recursively strip `id` properties from a serialized block state tree
+ * so that every block (including shadows and nested inputs) gets a fresh
+ * ID when deserialized onto the workspace. This prevents two blocks from
+ * sharing the same shadow block in the VM, which would cause deleting
+ * one to destroy the other's shadow.
+ * @param state A serialized block state object.
+ */
+export declare function stripIds(state: Blockly.serialization.blocks.State): void;
 /**
  * Compare strings with natural number sorting.
  * @param str1 First input.

package/dist/types/src/scratch_blocks_utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scratch_blocks_utils.d.ts","sourceRoot":"","sources":["../../../src/scratch_blocks_utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH;;;GAGG;AACH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjE"}
+{"version":3,"file":"scratch_blocks_utils.d.ts","sourceRoot":"","sources":["../../../src/scratch_blocks_utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH;;;GAGG;AACH,OAAO,KAAK,KAAK,OAAO,MAAM,cAAc,CAAA;AAE5C;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,CAaxE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjE"}

package/dist/types/src/xml.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../../../src/xml.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAGvC;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,YAAY,GAAG,MAAM,EAAE,CAkDpG"}
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../../../src/xml.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAwEvC;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,YAAY,GAAG,MAAM,EAAE,CAkDpG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scratch-blocks",
-  "version": "2.1.15",
+  "version": "2.1.17",
   "description": "Scratch Blocks is a library for building creative computing interfaces.",
   "author": "Massachusetts Institute of Technology",
   "license": "Apache-2.0",
@@ -41,7 +41,7 @@
     "@vitest/browser": "4.1.4",
     "@vitest/browser-playwright": "4.1.4",
     "eslint": "9.39.4",
-    "eslint-config-scratch": "14.1.11",
+    "eslint-config-scratch": "14.1.12",
     "husky": "9.1.7",
     "playwright": "1.59.1",
     "prettier": "3.8.3",

package/src/checkable_continuous_flyout.ts

@@ -5,6 +5,7 @@
 import { ContinuousFlyout, type LabelFlyoutItem } from '@blockly/continuous-toolbox'
 import * as Blockly from 'blockly/core'
 import { CheckboxBubble } from './checkbox_bubble'
+import { stripIds } from './scratch_blocks_utils'
 import { StatusIndicatorLabel } from './status_indicator_label'
 import { STATUS_INDICATOR_LABEL_TYPE } from './status_indicator_label_flyout_inflater'
 
@@ -44,11 +45,12 @@ export class CheckableContinuousFlyout extends ContinuousFlyout {
    */
   protected serializeBlock(block: Blockly.BlockSvg) {
     const json = super.serializeBlock(block)
-    // Delete the serialized block's ID so that a new one is generated when it is
-    // placed on the workspace. Otherwise, the block on the workspace may be
-    // indistinguishable from the one in the flyout, which can cause reporter blocks
-    // to have their value dropdown shown in the wrong place.
-    delete json.id
+    // Strip all IDs so every block in the tree (including shadows) gets a
+    // fresh ID when placed on the workspace. Without this, disposed shadows
+    // from a previous copy can reuse the flyout's IDs, causing two workspace
+    // blocks to share the same shadow in the VM. Deleting one then destroys
+    // the other's shadow (bug 878291).
+    stripIds(json)
     return json
   }
 

package/src/scratch_block_paster.ts

@@ -3,6 +3,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import * as Blockly from 'blockly/core'
+import { stripIds } from './scratch_blocks_utils'
 import type { ScratchCommentIcon } from './scratch_comment_icon'
 
 /**
@@ -22,6 +23,12 @@ class ScratchBlockPaster extends Blockly.clipboard.BlockPaster {
     workspace: Blockly.WorkspaceSvg,
     coordinate: Blockly.utils.Coordinate,
   ) {
+    // Strip all block IDs so that every block in the pasted tree (including
+    // shadows) gets a fresh ID. Without this, disposed shadows from the
+    // original block can reuse the same ID, causing the VM to think both
+    // blocks share the same shadow. Deleting one then destroys the other's
+    // shadow (forum topic 878291).
+    stripIds(copyData.blockState)
     const block = super.paste(copyData, workspace, coordinate)
     if (block?.type === 'argument_reporter_boolean' || block?.type === 'argument_reporter_string_number') {
       block.setDragStrategy(new Blockly.dragging.BlockDragStrategy(block))

package/src/scratch_blocks_utils.ts

@@ -20,6 +20,31 @@
  * @file Utility methods for Scratch Blocks but not Blockly.
  * @author fenichel@google.com (Rachel Fenichel)
  */
+import type * as Blockly from 'blockly/core'
+
+/**
+ * Recursively strip `id` properties from a serialized block state tree
+ * so that every block (including shadows and nested inputs) gets a fresh
+ * ID when deserialized onto the workspace. This prevents two blocks from
+ * sharing the same shadow block in the VM, which would cause deleting
+ * one to destroy the other's shadow.
+ * @param state A serialized block state object.
+ */
+export function stripIds(state: Blockly.serialization.blocks.State): void {
+  delete state.id
+  if (state.inputs) {
+    for (const inputName in state.inputs) {
+      const conn = state.inputs[inputName]
+      if (conn.shadow) stripIds(conn.shadow)
+      if (conn.block) stripIds(conn.block)
+    }
+  }
+  if (state.next) {
+    if (state.next.shadow) stripIds(state.next.shadow)
+    if (state.next.block) stripIds(state.next.block)
+  }
+}
+
 /**
  * Compare strings with natural number sorting.
  * @param str1 First input.

package/src/xml.ts

@@ -5,6 +5,75 @@
 import * as Blockly from 'blockly/core'
 import { ScratchVariableModel } from './scratch_variable_model'
 
+// Blockly's blockToDom has a bug where the `empty` flag for an input's
+// container element is only set to false when a non-shadow target block
+// exists. If a connection has shadow DOM but no target block (which can
+// happen transiently during connect/disconnect operations or if shadow
+// respawn fails), the shadow clone IS appended to the <value> container
+// but the container is never appended to the output because `empty`
+// stays true. This causes the input to silently disappear from the XML,
+// which corrupts the VM's block representation on the next save/load.
+//
+// We fix this by wrapping blockToDom: after the original runs, we check
+// each value/statement input. If the connection has shadow state but the
+// output XML is missing the corresponding <value>/<statement> element,
+// we serialize the shadow ourselves and inject it.
+const originalBlockToDom = Blockly.Xml.blockToDom.bind(Blockly.Xml)
+
+Blockly.Xml.blockToDom = function blockToDomFixed(
+  block: Blockly.Block,
+  opt_noId?: boolean,
+): Element | DocumentFragment {
+  const result = originalBlockToDom(block, opt_noId)
+  if (!(result instanceof Element)) return result
+
+  for (const input of block.inputList) {
+    if (!input.connection) continue
+
+    const name = input.name
+    // Check if this input already appears in the serialized XML.
+    // Use localName for case-insensitive comparison across DOM implementations.
+    const alreadySerialized = Array.from(result.children).some((child) => {
+      const tag = child.localName
+      return (tag === 'value' || tag === 'statement') && child.getAttribute('name') === name
+    })
+    if (alreadySerialized) continue
+
+    // The input is missing from the XML. Check if there's shadow state
+    // that should have been included.
+    if (!input.connection.getShadowState()) continue
+
+    // If shadow DOM is still available on the connection, clone that DOM
+    // into a new container and append it to the serialized output.
+    const existingShadowDom = input.connection.getShadowDom()
+    if (existingShadowDom) {
+      const tagName = input.type === Blockly.inputs.inputTypes.VALUE ? 'value' : 'statement'
+      const doc = result.ownerDocument
+      const container = doc.createElementNS(result.namespaceURI, tagName)
+      container.setAttribute('name', name)
+      const importedShadow = doc.importNode(existingShadowDom, true)
+      if (opt_noId) {
+        importedShadow.removeAttribute('id')
+        for (const el of importedShadow.querySelectorAll('[id]')) {
+          el.removeAttribute('id')
+        }
+      }
+      container.appendChild(importedShadow)
+      result.appendChild(container)
+      console.warn(
+        `[scratch-blocks] blockToDom fix: recovered missing input "${name}" on ${block.type} (${block.id})`,
+      )
+    } else {
+      console.warn(
+        `[scratch-blocks] blockToDom fix: input "${name}" on ${block.type} (${block.id}) has shadow state` +
+          ` but no shadow DOM — cannot recover`,
+      )
+    }
+  }
+
+  return result
+}
+
 /**
  * Clears the workspace and loads the given serialized state.
  * @param xml XML representation of a Blockly workspace.