blockly 9.0.0-beta.2 → 9.0.0-beta.4

package/core/field.d.ts

@@ -38,7 +38,7 @@ export declare abstract class Field implements IASTNodeLocationSvg, IASTNodeLoca
     name?: string;
     protected value_: any;
     /** Validation function called when user edits an editable field. */
-    protected validator_: Function;
+    protected validator_: Function | null;
     /**
      * Used to cache the field's tooltip value if setTooltip is called when the
      * field is not yet initialized. Is *not* guaranteed to be accurate.
@@ -56,17 +56,17 @@ export declare abstract class Field implements IASTNodeLocationSvg, IASTNodeLoca
      */
     private markerSvg_;
     /** The rendered field's SVG group element. */
-    protected fieldGroup_: SVGGElement;
+    protected fieldGroup_: SVGGElement | null;
     /** The rendered field's SVG border element. */
-    protected borderRect_: SVGRectElement;
+    protected borderRect_: SVGRectElement | null;
     /** The rendered field's SVG text element. */
-    protected textElement_: SVGTextElement;
+    protected textElement_: SVGTextElement | null;
     /** The rendered field's text content element. */
-    protected textContent_: Text;
+    protected textContent_: Text | null;
     /** Mouse down event listener data. */
     private mouseDownWrapper_;
     /** Constants associated with the source block's renderer. */
-    protected constants_: ConstantProvider;
+    protected constants_: ConstantProvider | null;
     /**
      * Has this field been disposed of?
      *
@@ -76,7 +76,7 @@ export declare abstract class Field implements IASTNodeLocationSvg, IASTNodeLoca
     /** Maximum characters of text to display before adding an ellipsis. */
     maxDisplayLength: number;
     /** Block this field is attached to.  Starts as null, then set in init. */
-    protected sourceBlock_: Block;
+    protected sourceBlock_: Block | null;
     /** Does this block need to be re-rendered? */
     protected isDirty_: boolean;
     /** Is the field visible, or hidden due to the block being collapsed? */
@@ -86,7 +86,7 @@ export declare abstract class Field implements IASTNodeLocationSvg, IASTNodeLoca
      */
     protected enabled_: boolean;
     /** The element the click handler is bound to. */
-    protected clickTarget_: Element;
+    protected clickTarget_: Element | null;
     /**
      * The prefix field.
      *
@@ -149,6 +149,7 @@ export declare abstract class Field implements IASTNodeLocationSvg, IASTNodeLoca
      * Get the block this field is attached to.
      *
      * @returns The block containing this field.
+     * @throws An error if the source block is not defined.
      */
     getSourceBlock(): Block;
     /**
@@ -234,7 +235,7 @@ export declare abstract class Field implements IASTNodeLocationSvg, IASTNodeLoca
      *     Used to see if `this` has overridden any relevant hooks.
      * @returns The stringified version of the XML state, or null.
      */
-    protected saveLegacyState(callingClass: any): string | null;
+    protected saveLegacyState(callingClass: FieldProto): string | null;
     /**
      * Loads the given state using either the old XML hooks, if they should be
      * used. Returns true to indicate loading has been handled, false otherwise.
@@ -244,7 +245,7 @@ export declare abstract class Field implements IASTNodeLocationSvg, IASTNodeLoca
      * @param state The state to apply to the field.
      * @returns Whether the state was applied or not.
      */
-    loadLegacyState(callingClass: any, state: any): boolean;
+    loadLegacyState(callingClass: FieldProto, state: any): boolean;
     /**
      * Dispose of all DOM objects and events belonging to this editable field.
      *
@@ -331,7 +332,28 @@ export declare abstract class Field implements IASTNodeLocationSvg, IASTNodeLoca
      *
      * @returns The group element.
      */
-    getSvgRoot(): SVGGElement;
+    getSvgRoot(): SVGGElement | null;
+    /**
+     * Gets the border rectangle element.
+     *
+     * @returns The border rectangle element.
+     * @throws An error if the border rectangle element is not defined.
+     */
+    protected getBorderRect(): SVGRectElement;
+    /**
+     * Gets the text element.
+     *
+     * @returns The text element.
+     * @throws An error if the text element is not defined.
+     */
+    protected getTextElement(): SVGTextElement;
+    /**
+     * Gets the text content.
+     *
+     * @returns The text content.
+     * @throws An error if the text content is not defined.
+     */
+    protected getTextContent(): Text;
     /**
      * Updates the field to match the colour/style of the block. Should only be
      * called by BlockSvg.applyColour().
@@ -514,7 +536,7 @@ export declare abstract class Field implements IASTNodeLocationSvg, IASTNodeLoca
      *
      * @returns Element to bind click handler to.
      */
-    protected getClickTarget_(): Element;
+    protected getClickTarget_(): Element | null;
     /**
      * Return the absolute coordinates of the top-left corner of this field.
      * The origin (0,0) is the top-left corner of the page body.
@@ -588,4 +610,9 @@ export declare abstract class Field implements IASTNodeLocationSvg, IASTNodeLoca
 export interface FieldConfig {
     tooltip?: string;
 }
+/**
+ * For use by Field and descendants of Field. Constructors can change
+ * in descendants, though they should contain all of Field's prototype methods.
+ */
+export declare type FieldProto = Pick<typeof Field, 'prototype'>;
 //# sourceMappingURL=field.d.ts.map

package/core/tooltip.d.ts

@@ -114,7 +114,7 @@ export declare function bindMouseEvents(element: Element): void;
  * @param element SVG element onto which tooltip is bound.
  * @alias Blockly.Tooltip.unbindMouseEvents
  */
-export declare function unbindMouseEvents(element: Element): void;
+export declare function unbindMouseEvents(element: Element | null): void;
 /**
  * Dispose of the tooltip.
  *

package/core/utils/dom.d.ts

@@ -49,6 +49,8 @@ export declare function createSvgElement<T extends SVGElement>(name: string | Sv
 /**
  * Add a CSS class to a element.
  *
+ * Handles multiple space-separated classes for legacy reasons.
+ *
  * @param element DOM element to add class to.
  * @param className Name of class to add.
  * @returns True if class was added, false if already present.
@@ -56,7 +58,7 @@ export declare function createSvgElement<T extends SVGElement>(name: string | Sv
  */
 export declare function addClass(element: Element, className: string): boolean;
 /**
- * Removes multiple calsses from an element.
+ * Removes multiple classes from an element.
  *
  * @param element DOM element to remove classes from.
  * @param classNames A string of one or multiple class names for an element.
@@ -66,6 +68,8 @@ export declare function removeClasses(element: Element, classNames: string): voi
 /**
  * Remove a CSS class from a element.
  *
+ * Handles multiple space-separated classes for legacy reasons.
+ *
  * @param element DOM element to remove class from.
  * @param className Name of class to remove.
  * @returns True if class was removed, false if never present.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blockly",
-  "version": "9.0.0-beta.2",
+  "version": "9.0.0-beta.4",
   "description": "Blockly is a library for building visual programming editors.",
   "keywords": [
     "blockly"