blockly 10.3.1 → 10.4.0-beta.0

package/core/block_dragger.d.ts

@@ -11,10 +11,10 @@
 import './events/events_block_drag.js';
 import type { BlockSvg } from './block_svg.js';
 import type { Icon } from './icons/icon.js';
-import { InsertionMarkerManager } from './insertion_marker_manager.js';
 import type { IBlockDragger } from './interfaces/i_block_dragger.js';
 import { Coordinate } from './utils/coordinate.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
+import { IConnectionPreviewer } from './blockly.js';
 /**
  * Class for a block dragger.  It moves blocks around the workspace when they
  * are being dragged by a mouse or touch.
@@ -22,11 +22,12 @@ import type { WorkspaceSvg } from './workspace_svg.js';
 export declare class BlockDragger implements IBlockDragger {
     /** The top block in the stack that is being dragged. */
     protected draggingBlock_: BlockSvg;
-    protected draggedConnectionManager_: InsertionMarkerManager;
+    protected connectionPreviewer: IConnectionPreviewer;
     /** The workspace on which the block is being dragged. */
     protected workspace_: WorkspaceSvg;
     /** Which drag area the mouse pointer is over, if any. */
     private dragTarget_;
+    private connectionCandidate;
     /** Whether the block would be deleted if dropped immediately. */
     protected wouldDeleteBlock_: boolean;
     protected startXY_: Coordinate;
@@ -76,10 +77,43 @@ export declare class BlockDragger implements IBlockDragger {
      * display accordingly.
      *
      * @param e The most recent move event.
-     * @param currentDragDeltaXY How far the pointer has moved from the position
+     * @param delta How far the pointer has moved from the position
      *     at the start of the drag, in pixel units.
      */
-    drag(e: PointerEvent, currentDragDeltaXY: Coordinate): void;
+    drag(e: PointerEvent, delta: Coordinate): void;
+    private moveBlock;
+    private updateDragTargets;
+    /**
+     * Returns true if we would delete the block if it was dropped at this time,
+     * false otherwise.
+     */
+    private wouldDeleteBlock;
+    private updateConnectionPreview;
+    /**
+     * Returns true if the given orphan block can connect at the end of the
+     * top block's stack or row, false otherwise.
+     */
+    private orphanCanConnectAtEnd;
+    /**
+     * Returns true if the current candidate is better than the new candidate.
+     *
+     * We slightly prefer the current candidate even if it is farther away.
+     */
+    private currCandidateIsBetter;
+    /**
+     * Returns the closest valid candidate connection, if one can be found.
+     *
+     * Valid neighbour connections are within the configured start radius, with a
+     * compatible type (input, output, etc) and connection check.
+     */
+    private getConnectionCandidate;
+    /**
+     * Returns all of the connections we might connect to blocks on the workspace.
+     *
+     * Includes any connections on the dragging block, and any last next
+     * connection on the stack (if one exists).
+     */
+    private getLocalConnections;
     /**
      * Finish a block drag and put the block back on the workspace.
      *
@@ -112,6 +146,7 @@ export declare class BlockDragger implements IBlockDragger {
      * Updates the necessary information to place a block at a certain location.
      */
     protected updateBlockAfterMove_(): void;
+    private applyConnections;
     /** Fire a UI event at the end of a block drag. */
     protected fireDragEndEvent_(): void;
     /**

package/core/blockly.d.ts

@@ -64,6 +64,7 @@ import { Input } from './inputs/input.js';
 import { inputTypes } from './inputs/input_types.js';
 import * as inputs from './inputs.js';
 import { InsertionMarkerManager } from './insertion_marker_manager.js';
+import { InsertionMarkerPreviewer } from './connection_previewers/insertion_marker_previewer.js';
 import { IASTNodeLocation } from './interfaces/i_ast_node_location.js';
 import { IASTNodeLocationSvg } from './interfaces/i_ast_node_location_svg.js';
 import { IASTNodeLocationWithBlock } from './interfaces/i_ast_node_location_with_block.js';
@@ -74,6 +75,7 @@ import { IBubble } from './interfaces/i_bubble.js';
 import { ICollapsibleToolboxItem } from './interfaces/i_collapsible_toolbox_item.js';
 import { IComponent } from './interfaces/i_component.js';
 import { IConnectionChecker } from './interfaces/i_connection_checker.js';
+import { IConnectionPreviewer } from './interfaces/i_connection_previewer.js';
 import { IContextMenu } from './interfaces/i_contextmenu.js';
 import { ICopyable, isCopyable } from './interfaces/i_copyable.js';
 import { IDeletable } from './interfaces/i_deletable.js';
@@ -370,6 +372,7 @@ export { IBubble };
 export { ICollapsibleToolboxItem };
 export { IComponent };
 export { IConnectionChecker };
+export { IConnectionPreviewer };
 export { IContextMenu };
 export { icons };
 export { ICopyable, isCopyable };
@@ -386,6 +389,7 @@ export { IMovable };
 export { Input };
 export { inputs };
 export { InsertionMarkerManager };
+export { InsertionMarkerPreviewer };
 export { IObservable, isObservable };
 export { IPaster, isPaster };
 export { IPositionable };

package/core/connection_previewers/insertion_marker_previewer.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @license
+ * Copyright 2024 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BlockSvg } from '../block_svg.js';
+import { IConnectionPreviewer } from '../interfaces/i_connection_previewer.js';
+import { RenderedConnection } from '../rendered_connection.js';
+export declare class InsertionMarkerPreviewer implements IConnectionPreviewer {
+    private readonly workspace;
+    private fadedBlock;
+    private markerConn;
+    private draggedConn;
+    private staticConn;
+    constructor(draggedBlock: BlockSvg);
+    /**
+     * Display a connection preview where the draggedCon connects to the
+     * staticCon, replacing the replacedBlock (currently connected to the
+     * staticCon).
+     *
+     * @param draggedConn The connection on the block stack being dragged.
+     * @param staticConn The connection not being dragged that we are
+     *     connecting to.
+     * @param replacedBlock The block currently connected to the staticCon that
+     *     is being replaced.
+     */
+    previewReplacement(draggedConn: RenderedConnection, staticConn: RenderedConnection, replacedBlock: BlockSvg): void;
+    /**
+     * Display a connection preview where the draggedCon connects to the
+     * staticCon, and no block is being relaced.
+     *
+     * @param draggedConn The connection on the block stack being dragged.
+     * @param staticConn The connection not being dragged that we are
+     *     connecting to.
+     */
+    previewConnection(draggedConn: RenderedConnection, staticConn: RenderedConnection): void;
+    private createInsertionMarker;
+    /**
+     * Gets the connection on the marker block that matches the original
+     * connection on the original block.
+     *
+     * @param orig The original block.
+     * @param marker The marker block (where we want to find the matching
+     *     connection).
+     * @param origConn The original connection.
+     */
+    private getMatchingConnection;
+    /** Hide any previews that are currently displayed. */
+    hidePreview(): void;
+    private hideInsertionMarker;
+    /** Dispose of any references held by this connection previewer. */
+    dispose(): void;
+}
+//# sourceMappingURL=insertion_marker_previewer.d.ts.map

package/core/insertion_marker_manager.d.ts

@@ -10,6 +10,8 @@ import type { Coordinate } from './utils/coordinate.js';
  * Class that controls updates to connections during drags.  It is primarily
  * responsible for finding the closest eligible connection and highlighting or
  * unhighlighting it as needed during a drag.
+ *
+ * @deprecated v10 - Use an IConnectionPreviewer instead.
  */
 export declare class InsertionMarkerManager {
     /**

package/core/interfaces/i_connection_previewer.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright 2023 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { BlockSvg } from '../block_svg';
+import type { RenderedConnection } from '../rendered_connection';
+/**
+ * Displays visual "previews" of where a block will be connected if it is
+ * dropped.
+ */
+export interface IConnectionPreviewer {
+    /**
+     * Display a connection preview where the draggedCon connects to the
+     * staticCon, replacing the replacedBlock (currently connected to the
+     * staticCon).
+     *
+     * @param draggedCon The connection on the block stack being dragged.
+     * @param staticCon The connection not being dragged that we are
+     *     connecting to.
+     * @param replacedBlock The block currently connected to the staticCon that
+     *     is being replaced.
+     */
+    previewReplacement(draggedConn: RenderedConnection, staticConn: RenderedConnection, replacedBlock: BlockSvg): void;
+    /**
+     * Display a connection preview where the draggedCon connects to the
+     * staticCon, and no block is being relaced.
+     *
+     * @param draggedCon The connection on the block stack being dragged.
+     * @param staticCon The connection not being dragged that we are
+     *     connecting to.
+     */
+    previewConnection(draggedConn: RenderedConnection, staticConn: RenderedConnection): void;
+    /** Hide any previews that are currently displayed. */
+    hidePreview(): void;
+    /** Dispose of any references held by this connection previewer. */
+    dispose(): void;
+}
+//# sourceMappingURL=i_connection_previewer.d.ts.map

package/core/registry.d.ts

@@ -18,8 +18,9 @@ import type { Options } from './options.js';
 import type { Renderer } from './renderers/common/renderer.js';
 import type { Theme } from './theme.js';
 import type { ToolboxItem } from './toolbox/toolbox_item.js';
-import { IPaster } from './interfaces/i_paster.js';
-import { ICopyable } from './interfaces/i_copyable.js';
+import type { IPaster } from './interfaces/i_paster.js';
+import type { ICopyable } from './interfaces/i_copyable.js';
+import type { IConnectionPreviewer } from './interfaces/i_connection_previewer.js';
 export declare const TEST_ONLY: {
     typeMap: {
         [key: string]: {
@@ -45,6 +46,7 @@ export declare class Type<_T> {
      */
     toString(): string;
     static CONNECTION_CHECKER: Type<IConnectionChecker>;
+    static CONNECTION_PREVIEWER: Type<IConnectionPreviewer>;
     static CURSOR: Type<Cursor>;
     static EVENT: Type<Abstract>;
     static FIELD: Type<Field<any>>;

package/core/rendered_connection.d.ts

@@ -21,7 +21,7 @@ export declare class RenderedConnection extends Connection {
     private readonly dbOpposite;
     private readonly offsetInBlock;
     private trackedState;
-    private highlightPath;
+    private highlighted;
     /** Connection this connection connects to.  Null if not connected. */
     targetConnection: RenderedConnection | null;
     /**
@@ -130,6 +130,8 @@ export declare class RenderedConnection extends Connection {
     highlight(): void;
     /** Remove the highlighting around this connection. */
     unhighlight(): void;
+    /** Returns true if this connection is highlighted, false otherwise. */
+    isHighlighted(): boolean;
     /**
      * Set whether this connections is tracked in the database or not.
      *

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

@@ -39,8 +39,8 @@ export interface PuzzleTab {
     type: number;
     width: number;
     height: number;
-    pathDown: string | ((p1: number) => string);
-    pathUp: string | ((p1: number) => string);
+    pathDown: string;
+    pathUp: string;
 }
 /**
  * An object containing sizing and path information about collapsed block
@@ -78,6 +78,10 @@ export type Shape = BaseShape | DynamicShape;
  * @returns Whether the shape is a dynamic shape or not.
  */
 export declare function isDynamicShape(shape: Shape): shape is DynamicShape;
+/** Returns whether the shape is a puzzle tab or not. */
+export declare function isPuzzleTab(shape: Shape): shape is PuzzleTab;
+/** Returns whether the shape is a notch or not. */
+export declare function isNotch(shape: Shape): shape is Notch;
 /**
  * An object that provides constants for rendering blocks.
  */

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

@@ -5,6 +5,7 @@
  */
 import type { BlockSvg } from '../../block_svg.js';
 import { Coordinate } from '../../utils.js';
+import { Connection } from '../measurables/connection.js';
 import type { Field } from '../measurables/field.js';
 import type { Icon } from '../measurables/icon.js';
 import type { InlineInput } from '../measurables/inline_input.js';
@@ -141,5 +142,22 @@ export declare class Drawer {
     protected positionNextConnection_(): void;
     /** Position the output connection on a block. */
     protected positionOutputConnection_(): void;
+    /**
+     * Updates the path object to reflect which connections on the block are
+     * highlighted.
+     */
+    protected updateConnectionHighlights(): void;
+    /** Returns a path to highlight the given connection. */
+    drawConnectionHighlightPath(measurable: Connection): void;
+    /**
+     * Returns a path to highlight the given conneciton, assuming it is an
+     * input or output connection.
+     */
+    private getExpressionConnectionHighlightPath;
+    /**
+     * Returns a path to highlight the given conneciton, assuming it is a
+     * next or previous connection.
+     */
+    private getStatementConnectionHighlightPath;
 }
 //# sourceMappingURL=drawer.d.ts.map

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

@@ -6,7 +6,8 @@
 import type { BlockStyle } from '../../theme.js';
 import type { BlockSvg } from '../../block_svg.js';
 import type { ConstantProvider } from './constants.js';
-import { RenderedConnection } from '../../rendered_connection.js';
+import type { RenderedConnection } from '../../rendered_connection.js';
+import type { Coordinate } from '../../utils/coordinate.js';
 /**
  * An interface for a block's path object.
  *
@@ -101,21 +102,11 @@ export interface IPathObject {
      * @param enable True if the block is movable, false otherwise.
      */
     updateMovable(enabled: boolean): void;
+    /** Adds the given path as a connection highlight for the given connection. */
+    addConnectionHighlight?(connection: RenderedConnection, connectionPath: string, offset: Coordinate, rtl: boolean): void;
     /**
-     * Add or remove styling that shows that if the dragging block is dropped,
-     * this block will be replaced.  If a shadow block, it will disappear.
-     * Otherwise it will bump.
-     *
-     * @param enable True if styling should be added.
-     */
-    updateReplacementFade(enabled: boolean): void;
-    /**
-     * Add or remove styling that shows that if the dragging block is dropped,
-     * this block will be connected to the input.
-     *
-     * @param conn The connection on the input to highlight.
-     * @param enable True if styling should be added.
+     * Removes any highlight associated with the given connection, if it exists.
      */
-    updateShapeForInputHighlight(conn: RenderedConnection, enable: boolean): void;
+    removeConnectionHighlight?(connection: RenderedConnection): void;
 }
 //# sourceMappingURL=i_path_object.d.ts.map

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

@@ -5,6 +5,7 @@
  */
 import type { BlockSvg } from '../../block_svg.js';
 import { Input } from '../../inputs/input.js';
+import type { RenderedConnection } from '../../rendered_connection.js';
 import type { Measurable } from '../measurables/base.js';
 import { BottomRow } from '../measurables/bottom_row.js';
 import { InputRow } from '../measurables/input_row.js';
@@ -14,6 +15,7 @@ import { SpacerRow } from '../measurables/spacer_row.js';
 import { TopRow } from '../measurables/top_row.js';
 import type { ConstantProvider } from './constants.js';
 import type { Renderer } from './renderer.js';
+import { Connection } from '../measurables/connection.js';
 /**
  * An object containing all sizing information needed to draw this block.
  *
@@ -61,8 +63,7 @@ export declare class RenderInfo {
      */
     getRenderer(): Renderer;
     /**
-     * Populate and return an object containing all sizing information needed to
-     * draw this block.
+     * Populate this object with all sizing information needed to draw the block.
      *
      * This measure pass does not propagate changes to the block (although fields
      * may choose to rerender when getSize() is called).  However, calling it
@@ -194,5 +195,7 @@ export declare class RenderInfo {
      * store the y position of each row, and record the height of the full block.
      */
     protected finalize_(): void;
+    /** Returns the connection measurable associated with the given connection. */
+    getMeasureableForConnection(conn: RenderedConnection): Connection | null;
 }
 //# sourceMappingURL=info.d.ts.map

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

@@ -5,7 +5,9 @@
  */
 import type { BlockSvg } from '../../block_svg.js';
 import type { Connection } from '../../connection.js';
+import { RenderedConnection } from '../../rendered_connection.js';
 import type { BlockStyle } from '../../theme.js';
+import { Coordinate } from '../../utils/coordinate.js';
 import type { ConstantProvider } from './constants.js';
 import type { IPathObject } from './i_path_object.js';
 /**
@@ -27,6 +29,10 @@ export declare class PathObject implements IPathObject {
     markerSvg: SVGElement | null;
     constants: ConstantProvider;
     style: BlockStyle;
+    /** Highlight paths associated with connections. */
+    private connectionHighlights;
+    /** Locations of connection highlights. */
+    private highlightOffsets;
     /**
      * @param root The root SVG element.
      * @param style The style object to use for colouring.
@@ -138,5 +144,12 @@ export declare class PathObject implements IPathObject {
      * @param _enable True if styling should be added.
      */
     updateShapeForInputHighlight(_conn: Connection, _enable: boolean): void;
+    /** Adds the given path as a connection highlight for the given connection. */
+    addConnectionHighlight(connection: RenderedConnection, connectionPath: string, offset: Coordinate, rtl: boolean): void;
+    private currentHighlightMatchesNew;
+    /**
+     * Removes any highlight associated with the given connection, if it exists.
+     */
+    removeConnectionHighlight(connection: RenderedConnection): void;
 }
 //# sourceMappingURL=path_object.d.ts.map

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

@@ -141,6 +141,9 @@ export declare class Renderer implements IRegistrable {
      * @param local The connection currently being dragged.
      * @param topBlock The block currently being dragged.
      * @returns The preview type to display.
+     *
+     * @deprecated v10 - This function is no longer respected. A custom
+     *    IConnectionPreviewer may be able to fulfill the functionality.
      */
     getConnectionPreviewMethod(closest: RenderedConnection, local: RenderedConnection, topBlock: BlockSvg): PreviewType;
     /**

package/core/renderers/measurables/connection.d.ts

@@ -14,6 +14,7 @@ export declare class Connection extends Measurable {
     connectionModel: RenderedConnection;
     shape: Shape;
     isDynamicShape: boolean;
+    highlighted: boolean;
     /**
      * @param constants The rendering constants provider.
      * @param connectionModel The connection object on the block that this

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

@@ -5,6 +5,7 @@
  */
 import type { BlockSvg } from '../../block_svg.js';
 import { Drawer as BaseDrawer } from '../common/drawer.js';
+import { Connection } from '../measurables/connection.js';
 import type { InlineInput } from '../measurables/inline_input.js';
 import type { Row } from '../measurables/row.js';
 import type { RenderInfo } from './info.js';
@@ -42,6 +43,9 @@ export declare class Drawer extends BaseDrawer {
     /** Add steps to draw a flat bottom row. */
     protected drawFlatBottom_(): void;
     drawInlineInput_(input: InlineInput): void;
+    private getInlineInputPath;
     drawStatementInput_(row: Row): void;
+    /** Returns a path to highlight the given connection. */
+    drawConnectionHighlightPath(measurable: Connection): void;
 }
 //# sourceMappingURL=drawer.d.ts.map

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

@@ -4,7 +4,6 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { BlockSvg } from '../../block_svg.js';
-import type { Connection } from '../../connection.js';
 import { InsertionMarkerManager } from '../../insertion_marker_manager.js';
 import type { Marker } from '../../keyboard_nav/marker.js';
 import type { RenderedConnection } from '../../rendered_connection.js';
@@ -74,7 +73,10 @@ export declare class Renderer extends BaseRenderer {
      * @returns The constant provider.
      */
     getConstants(): ConstantProvider;
-    shouldHighlightConnection(conn: Connection): boolean;
+    /**
+     * @deprecated v10 - This function is no longer respected. A custom
+     *    IConnectionPreviewer may be able to fulfill the functionality.
+     */
     getConnectionPreviewMethod(closest: RenderedConnection, local: RenderedConnection, topBlock: BlockSvg): InsertionMarkerManager.PREVIEW_TYPE;
 }
 //# sourceMappingURL=renderer.d.ts.map

package/core/workspace_audio.d.ts

@@ -13,6 +13,8 @@ export declare class WorkspaceAudio {
     private sounds;
     /** Time that the last sound was played. */
     private lastSound_;
+    /** Whether the audio is muted or not. */
+    private muted;
     /**
      * @param parentWorkspace The parent of the workspace this audio object
      *     belongs to, or null.
@@ -47,5 +49,13 @@ export declare class WorkspaceAudio {
      * @param opt_volume Volume of sound (0-1).
      */
     play(name: string, opt_volume?: number): void;
+    /**
+     * @param muted If true, mute sounds. Otherwise, play them.
+     */
+    setMuted(muted: boolean): void;
+    /**
+     * @returns Whether the audio is currently muted or not.
+     */
+    getMuted(): boolean;
 }
 //# sourceMappingURL=workspace_audio.d.ts.map

package/dart.d.ts

@@ -26,3 +26,5 @@ export enum Order {
 }
 
 export declare const dartGenerator: any;
+
+export {DartGenerator} from './generators/dart';

package/generators/dart/colour.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2014 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @file Generating Dart for colour blocks.
+ */
+import type { Block } from '../../core/block.js';
+import type { DartGenerator } from './dart_generator.js';
+import { Order } from './dart_generator.js';
+export declare function colour_picker(block: Block, generator: DartGenerator): [string, Order];
+export declare function colour_random(block: Block, generator: DartGenerator): [string, Order];
+export declare function colour_rgb(block: Block, generator: DartGenerator): [string, Order];
+export declare function colour_blend(block: Block, generator: DartGenerator): [string, Order];
+//# sourceMappingURL=colour.d.ts.map

package/generators/dart/dart_generator.d.ts

@@ -0,0 +1,100 @@
+/**
+ * @license
+ * Copyright 2014 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Block } from '../../core/block.js';
+import { CodeGenerator } from '../../core/generator.js';
+import type { Workspace } from '../../core/workspace.js';
+/**
+ * Order of operation ENUMs.
+ * https://dart.dev/guides/language/language-tour#operators
+ */
+export declare enum Order {
+    ATOMIC = 0,
+    UNARY_POSTFIX = 1,
+    UNARY_PREFIX = 2,
+    MULTIPLICATIVE = 3,
+    ADDITIVE = 4,
+    SHIFT = 5,
+    BITWISE_AND = 6,
+    BITWISE_XOR = 7,
+    BITWISE_OR = 8,
+    RELATIONAL = 9,
+    EQUALITY = 10,
+    LOGICAL_AND = 11,
+    LOGICAL_OR = 12,
+    IF_NULL = 13,
+    CONDITIONAL = 14,
+    CASCADE = 15,
+    ASSIGNMENT = 16,
+    NONE = 99
+}
+/**
+ * Dart code generator class.
+ */
+export declare class DartGenerator extends CodeGenerator {
+    /** @param name Name of the language the generator is for. */
+    constructor(name?: string);
+    /**
+     * Initialise the database of variable names.
+     *
+     * @param workspace Workspace to generate code from.
+     */
+    init(workspace: Workspace): void;
+    /**
+     * Prepend the generated code with import statements and variable definitions.
+     *
+     * @param code Generated code.
+     * @returns Completed code.
+     */
+    finish(code: string): string;
+    /**
+     * Naked values are top-level blocks with outputs that aren't plugged into
+     * anything.
+     *
+     * @param line Line of generated code.
+     * @returns Legal line of code.
+     */
+    scrubNakedValue(line: string): string;
+    /**
+     * Encode a string as a properly escaped Dart string, complete with quotes.
+     *
+     * @param string Text to encode.
+     * @returns Dart string.
+     */
+    quote_(string: string): string;
+    /**
+     * Encode a string as a properly escaped multiline Dart string, complete
+     * with quotes.
+     *
+     * @param string Text to encode.
+     * @returns Dart string.
+     */
+    multiline_quote_(string: string): string;
+    /**
+     * Common tasks for generating Dart from blocks.
+     * Handles comments for the specified block and any connected value blocks.
+     * Calls any statements following this block.
+     *
+     * @param block The current block.
+     * @param code The Dart code created for this block.
+     * @param thisOnly True to generate code for only this statement.
+     * @returns Dart code with comments and subsequent blocks added.
+     */
+    scrub_(block: Block, code: string, thisOnly?: boolean): string;
+    /**
+     * Generate code representing the specified value input, adjusted to take into
+     * account indexing (zero- or one-based) and optionally by a specified delta
+     * and/or by negation.
+     *
+     * @param block The block.
+     * @param atId The ID of the input block to get (and adjust) the value of.
+     * @param delta Value to add.
+     * @param negate Whether to negate the value.
+     * @param order The highest order acting on this value.
+     * @returns The adjusted value or code that evaluates to it.
+     */
+    getAdjusted(block: Block, atId: string, delta?: number, negate?: boolean, order?: Order): string;
+}
+//# sourceMappingURL=dart_generator.d.ts.map

package/generators/dart/lists.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2014 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @file Generating Dart for list blocks.
+ */
+import type { Block } from '../../core/block.js';
+import type { DartGenerator } from './dart_generator.js';
+import { Order } from './dart_generator.js';
+export declare function lists_create_empty(block: Block, generator: DartGenerator): [string, Order];
+export declare function lists_create_with(block: Block, generator: DartGenerator): [string, Order];
+export declare function lists_repeat(block: Block, generator: DartGenerator): [string, Order];
+export declare function lists_length(block: Block, generator: DartGenerator): [string, Order];
+export declare function lists_isEmpty(block: Block, generator: DartGenerator): [string, Order];
+export declare function lists_indexOf(block: Block, generator: DartGenerator): [string, Order];
+export declare function lists_getIndex(block: Block, generator: DartGenerator): [string, Order] | string;
+export declare function lists_setIndex(block: Block, generator: DartGenerator): string;
+export declare function lists_getSublist(block: Block, generator: DartGenerator): [string, Order];
+export declare function lists_sort(block: Block, generator: DartGenerator): [string, Order];
+export declare function lists_split(block: Block, generator: DartGenerator): [string, Order];
+export declare function lists_reverse(block: Block, generator: DartGenerator): [string, Order];
+//# sourceMappingURL=lists.d.ts.map