blockly 10.2.1 → 10.3.0-beta.0

package/core/generator.d.ts

@@ -13,8 +13,10 @@ import type { Block } from './block.js';
 import { Names } from './names.js';
 import type { Workspace } from './workspace.js';
 /**
- * Type declaration for per-block-type generator functions.
+ * Deprecated, no-longer used type declaration for per-block-type generator
+ * functions.
  *
+ * @deprecated
  * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/generating-code}
  * @param block The Block instance to generate code for.
  * @param genearator The CodeGenerator calling the function.
@@ -28,10 +30,22 @@ export type BlockGenerator = (block: Block, generator: CodeGenerator) => [string
  */
 export declare class CodeGenerator {
     name_: string;
-    /** A dictionary of block generator functions keyed by block type. */
-    forBlock: {
-        [type: string]: BlockGenerator;
-    };
+    /**
+     * A dictionary of block generator functions, keyed by block type.
+     * Each block generator function takes two parameters:
+     *
+     * - the Block to generate code for, and
+     * - the calling CodeGenerator (or subclass) instance, so the
+     *   function can call methods defined below (e.g. blockToCode) or
+     *   on the relevant subclass (e.g. JavascripGenerator),
+     *
+     * and returns:
+     *
+     * - a [code, precedence] tuple (for value/expression blocks), or
+     * - a string containing the generated code (for statement blocks), or
+     * - null if no code should be emitted for block.
+     */
+    forBlock: Record<string, (block: Block, generator: this) => [string, number] | string | null>;
     /**
      * This is used as a placeholder in functions defined using
      * CodeGenerator.provideFunction_.  It must not be legal code that could

package/core/renderers/common/info.d.ts

@@ -93,11 +93,11 @@ export declare class RenderInfo {
     /**
      * Decide whether to start a new row between the two Blockly.Inputs.
      *
-     * @param input The first input to consider
-     * @param lastInput The input that follows.
-     * @returns True if the next input should be rendered on a new row.
+     * @param currInput The current input.
+     * @param prevInput The previous input.
+     * @returns True if the current input should be rendered on a new row.
      */
-    protected shouldStartNewRow_(input: Input, lastInput?: Input): boolean;
+    protected shouldStartNewRow_(currInput: Input, prevInput?: Input): boolean;
     /** Add horizontal spacing between and around elements within each row. */
     protected addElemSpacing_(): void;
     /**

package/core/renderers/zelos/info.d.ts

@@ -42,7 +42,7 @@ export declare class RenderInfo extends BaseRenderInfo {
      */
     getRenderer(): Renderer;
     measure(): void;
-    shouldStartNewRow_(input: Input, lastInput: Input): boolean;
+    shouldStartNewRow_(currInput: Input, prevInput: Input): boolean;
     getDesiredRowWidth_(row: Row): number;
     getInRowSpacing_(prev: Measurable | null, next: Measurable | null): number;
     getSpacerRowHeight_(prev: Row, next: Row): number;

package/package.json

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