blockly 10.2.0-beta.0 → 10.2.0-beta.1

package/core/block.d.ts

@@ -76,8 +76,14 @@ export declare class Block implements IASTNodeLocation, IDeletable {
      * An optional serialization method for defining how to serialize the
      * block's extra state (eg mutation state) to something JSON compatible.
      * This must be coupled with defining `loadExtraState`.
+     *
+     * @param doFullSerialization Whether or not to serialize the full state of
+     *     the extra state (rather than possibly saving a reference to some
+     *     state). This is used during copy-paste. See the
+     *     {@link https://developers.devsite.google.com/blockly/guides/create-custom-blocks/extensions#full_serialization_and_backing_data | block serialization docs}
+     *     for more information.
      */
-    saveExtraState?: () => any;
+    saveExtraState?: (doFullSerialization?: boolean) => any;
     /**
      * An optional serialization method for defining how to deserialize the
      * block's extra state (eg mutation state) from something JSON compatible.

package/core/field.d.ts

@@ -236,6 +236,9 @@ export declare abstract class Field<T = any> implements IASTNodeLocationSvg, IAS
      * @param _doFullSerialization If true, this signals to the field that if it
      *     normally just saves a reference to some state (eg variable fields) it
      *     should instead serialize the full state of the thing being referenced.
+     *     See the
+     *     {@link https://developers.devsite.google.com/blockly/guides/create-custom-blocks/fields/customizing-fields/creating#full_serialization_and_backing_data | field serialization docs}
+     *     for more information.
      * @returns JSON serializable state.
      * @internal
      */

package/core/workspace_svg.d.ts

@@ -559,6 +559,8 @@ export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationS
      *
      * @param state The representation of the thing to paste.
      * @returns The pasted thing, or null if the paste was not successful.
+     * @deprecated v10. Use `Blockly.clipboard.paste` instead. To be removed in
+     *     v11.
      */
     paste(state: any | Element | DocumentFragment): ICopyable<ICopyData> | null;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blockly",
-  "version": "10.2.0-beta.0",
+  "version": "10.2.0-beta.1",
   "description": "Blockly is a library for building visual programming editors.",
   "keywords": [
     "blockly"
@@ -60,7 +60,7 @@
     "json5": "^2.2.0",
     "markdown-tables-to-json": "^0.1.7",
     "mocha": "^10.0.0",
-    "patch-package": "^7.0.0",
+    "patch-package": "^8.0.0",
     "prettier": "3.0.0",
     "readline-sync": "^1.4.10",
     "rimraf": "^5.0.0",