blockly 12.5.1 → 13.0.0-beta.1

package/core/utils/aria.d.ts

@@ -4,66 +4,283 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 /**
- * ARIA role values.
- * Copied from Closure's goog.a11y.aria.Role
+ * ARIA state values for LivePriority.
+ * Copied from Closure's goog.a11y.aria.LivePriority
+ */
+export declare enum LiveRegionAssertiveness {
+    ASSERTIVE = "assertive",
+    OFF = "off",
+    POLITE = "polite"
+}
+/**
+ * Customization options that can be passed when using `announceDynamicAriaState`.
+ */
+export interface DynamicAnnouncementOptions {
+    /** The custom ARIA `Role` that should be used for the announcement container. */
+    role?: Role;
+    /**
+     * How assertive the announcement should be.
+     *
+     * Important*: It was found through testing that `ASSERTIVE` announcements are
+     * often outright ignored by some screen readers, so it's generally recommended
+     * to always use `POLITE` unless specifically tested across supported readers.
+     */
+    assertiveness?: LiveRegionAssertiveness;
+}
+/**
+ * A valid ARIA role for a Blockly DOM element. See also setRole() and getRole().
+ *
+ * This should be used instead of directly setting an element's role attribute.
  */
 export declare enum Role {
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/application_role. */
+    APPLICATION = "application",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/button_role. */
+    BUTTON = "button",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/checkbox_role. */
+    CHECKBOX = "checkbox",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/dialog_role. */
+    DIALOG = "dialog",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/figure_role. */
+    FIGURE = "figure",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/generic_role. */
+    GENERIC = "generic",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/grid_role. */
     GRID = "grid",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/gridcell_role. */
     GRIDCELL = "gridcell",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/group_role. */
     GROUP = "group",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/list_role. */
+    LIST = "list",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/listbox_role. */
     LISTBOX = "listbox",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/listitem_role. */
+    LISTITEM = "listitem",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/menu_role. */
     MENU = "menu",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/menuitem_role. */
     MENUITEM = "menuitem",
-    MENUITEMCHECKBOX = "menuitemcheckbox",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/option_role. */
     OPTION = "option",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/presentation_role. */
     PRESENTATION = "presentation",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/region_role. */
+    REGION = "region",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/row_role. */
     ROW = "row",
-    TREE = "tree",
-    TREEITEM = "treeitem",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/separator_role. */
     SEPARATOR = "separator",
-    STATUS = "status"
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/status_role. */
+    STATUS = "status",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/textbox_role. */
+    TEXTBOX = "textbox",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/tree_role. */
+    TREE = "tree",
+    /** See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/treeitem_role. */
+    TREEITEM = "treeitem"
 }
 /**
- * ARIA states and properties.
- * Copied from Closure's goog.a11y.aria.State
+ * A possible ARIA attribute state for a Blockly DOM element. See also setState() and getState().
+ *
+ * This should be used instead of directly setting aria-* attributes on elements.
  */
 export declare enum State {
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-activedescendant.
+     *
+     * Value: ID of a DOM element.
+     */
     ACTIVEDESCENDANT = "activedescendant",
-    COLCOUNT = "colcount",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-atomic.
+     *
+     * Value: one of {true, false}.
+     */
+    ATOMIC = "atomic",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-checked.
+     *
+     * Value: one of {true, false, mixed, undefined}.
+     */
+    CHECKED = "checked",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-controls.
+     *
+     * Value: an array of element IDs.
+     */
+    CONTROLS = "controls",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-disabled.
+     *
+     * Value: one of {true, false}.
+     */
     DISABLED = "disabled",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-expanded.
+     *
+     * Value: one of {true, false, undefined}.
+     */
     EXPANDED = "expanded",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-haspopup.
+     *
+     * Value: one of {true, false, menu, listbox, tree, grid, dialog}.
+     */
+    HASPOPUP = "haspopup",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-hidden.
+     *
+     * Value: one of {true, false,undefined}.
+     */
+    HIDDEN = "hidden",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-invalid.
+     *
+     * Value: one of {true, false, grammar, spelling}.
+     */
     INVALID = "invalid",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-label.
+     *
+     * Value: a string.
+     */
     LABEL = "label",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-labelledby.
+     *
+     * Value: an array of element IDs.
+     */
     LABELLEDBY = "labelledby",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-level.
+     *
+     * Value: an integer.
+     */
     LEVEL = "level",
-    ORIENTATION = "orientation",
-    POSINSET = "posinset",
-    ROWCOUNT = "rowcount",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-live.
+     *
+     * Value: one of {polite, assertive, off}.
+     */
+    LIVE = "live",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-roledescription.
+     *
+     * Value: a string.
+     */
+    ROLEDESCRIPTION = "roledescription",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-selected.
+     *
+     * Value:one of {true, false, undefined}.
+     */
     SELECTED = "selected",
-    SETSIZE = "setsize",
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-valuemax.
+     *
+     * Value: a number representing the maximum allowed value for a range widget.
+     */
     VALUEMAX = "valuemax",
-    VALUEMIN = "valuemin",
-    LIVE = "live",
-    HIDDEN = "hidden"
+    /**
+     * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-valuemin.
+     *
+     * Value: a number representing the minimum allowed value for a range widget.
+     */
+    VALUEMIN = "valuemin"
+}
+/**
+ * Used to control how verbose generated a11y labels are.
+ */
+export declare enum Verbosity {
+    TERSE = 0,
+    STANDARD = 1,
+    LOQUACIOUS = 2
 }
 /**
- * Sets the role of an element.
+ * Removes the ARIA role from an element.
  *
- * Similar to Closure's goog.a11y.aria
+ * Similar to Closure's goog.a11y.aria.removeRole
  *
- * @param element DOM node to set role of.
- * @param roleName Role name.
+ * @param element DOM element to remove the role from.
  */
-export declare function setRole(element: Element, roleName: Role): void;
+export declare function removeRole(element: Element): void;
 /**
- * Sets the state or property of an element.
- * Copied from Closure's goog.a11y.aria
+ * Updates the specific role for the specified element.
  *
- * @param element DOM node where we set state.
- * @param stateName State attribute being set.
- *     Automatically adds prefix 'aria-' to the state name if the attribute is
- * not an extra attribute.
- * @param value Value for the state attribute.
+ * @param element The element whose ARIA role should be changed.
+ * @param roleName The new role for the specified element, or null if its role
+ *     should be cleared.
+ */
+export declare function setRole(element: Element, roleName: Role | null): void;
+/**
+ * Returns the ARIA role of the specified element, or null if it either doesn't
+ * have a designated role or if that role is unknown.
+ *
+ * @param element The element from which to retrieve its ARIA role.
+ * @returns The ARIA role of the element, or null if undefined or unknown.
+ */
+export declare function getRole(element: Element): Role | null;
+/**
+ * Sets the specified ARIA state by its name and value for the specified
+ * element.
+ *
+ * Note that the type of value is not validated against the specific type of
+ * state being changed, so it's up to callers to ensure the correct value is
+ * used for the given state.
+ *
+ * @param element The element whose ARIA state may be changed.
+ * @param stateName The state to change.
+ * @param value The new value to specify for the provided state.
  */
 export declare function setState(element: Element, stateName: State, value: string | boolean | number | string[]): void;
+/**
+ * Clears the specified ARIA state by removing any related attributes from the
+ * specified element that have been set using setState().
+ *
+ * @param element The element whose ARIA state may be changed.
+ * @param stateName The state to clear from the provided element.
+ */
+export declare function clearState(element: Element, stateName: State): void;
+/**
+ * Returns a string representation of the specified state for the specified
+ * element, or null if it's not defined or specified.
+ *
+ * Note that an explicit set state of 'null' will return the 'null' string, not
+ * the value null.
+ *
+ * @param element The element whose state is being retrieved.
+ * @param stateName The state to retrieve.
+ * @returns The string representation of the requested state for the specified
+ *     element, or null if not defined.
+ */
+export declare function getState(element: Element, stateName: State): string | null;
+/**
+ * Creates an ARIA live region under the specified parent Element to be used
+ * for all dynamic announcements via `announceDynamicAriaState`. This must be
+ * called only once and before any dynamic announcements can be made.
+ *
+ * @param parent The container element to which the live region will be appended.
+ */
+export declare function initializeGlobalAriaLiveRegion(parent: HTMLDivElement): void;
+/**
+ * Requests that the specified text be read to the user if a screen reader is
+ * currently active.
+ *
+ * This relies on a centrally managed ARIA live region that is hidden from the
+ * visual DOM. This live region is designed to try and ensure the text is read,
+ * including if the same text is issued multiple times consecutively. Note that
+ * `initializeGlobalAriaLiveRegion` must be called before this can be used.
+ *
+ * Callers should use this judiciously. It's often considered bad practice to
+ * over-announce information that can be inferred from other sources on the page,
+ * so this ought to be used only when certain context cannot be easily determined
+ * (such as dynamic states that may not have perfect ARIA representations or
+ * indications).
+ *
+ * @param text The text to read to the user.
+ * @param options Custom options to configure the announcement. This defaults to
+ *    the status role and polite assertiveness.
+ */
+export declare function announceDynamicAriaState(text: string, options?: DynamicAnnouncementOptions): void;
 //# sourceMappingURL=aria.d.ts.map

package/core/utils/dom.d.ts

@@ -3,7 +3,7 @@
  * Copyright 2019 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { Svg } from './svg.js';
+import { Svg } from './svg.js';
 /**
  * Required name space for SVG elements.
  */

package/core/utils/shortcut_formatting.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2026 Raspberry Pi Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Find the primary shortcut for this platform and return it as single string
+ * in a short user facing format.
+ *
+ * @param shortcutName The keyboard shortcut name, e.g. "cut".
+ * @returns The formatted shortcut.
+ */
+export declare function getShortcutKeysShort(shortcutName: string): string;
+/**
+ * Find the relevant shortcuts for the given shortcut for the current platform.
+ * Keys are returned in a long user facing format, e.g. "Command ⌘ Option ⌥ C"
+ *
+ * @param shortcutName The keyboard shortcut name, e.g. "cut".
+ * @returns The formatted shortcuts as individual keys.
+ */
+export declare function getShortcutKeysLong(shortcutName: string): string[][];
+//# sourceMappingURL=shortcut_formatting.d.ts.map

package/core/utils/useragent.d.ts

@@ -11,4 +11,5 @@ export declare const IPAD: boolean;
 export declare const IPHONE: boolean;
 export declare const MAC: boolean;
 export declare const MOBILE: boolean;
+export declare const APPLE: boolean;
 //# sourceMappingURL=useragent.d.ts.map

package/core/variables.d.ts

@@ -109,7 +109,7 @@ export declare function generateUniqueNameFromOptions(startChar: string, usedNam
  * @param opt_type The type of the variable like 'int', 'string', or ''. This
  *     will default to '', which is a specific type.
  */
-export declare function createVariableButtonHandler(workspace: Workspace, opt_callback?: (p1?: string | null) => void, opt_type?: string): void;
+export declare function createVariableButtonHandler(workspace: WorkspaceSvg, opt_callback?: (p1?: string | null) => void, opt_type?: string): void;
 /**
  * Opens a prompt that allows the user to enter a new name for a variable.
  * Triggers a rename if the new name is valid. Or re-prompts if there is a

package/core/workspace_audio.d.ts

@@ -50,6 +50,29 @@ export declare class WorkspaceAudio {
      * @param opt_volume Volume of sound (0-1).
      */
     play(name: string, opt_volume?: number): Promise<void>;
+    /**
+     * Plays a beep at the given frequency.
+     *
+     * @param tone The frequency of the beep to play, in hertz.
+     * @param duration The duration of the beep, in seconds. Defaults to 0.2.
+     */
+    beep(tone: number, duration?: number): Promise<void>;
+    /**
+     * Plays a standard error beep.
+     */
+    playErrorBeep(): Promise<void>;
+    /**
+     * Returns whether or not playing sounds is currently allowed.
+     *
+     * @returns False if audio is muted or a sound has just been played, otherwise
+     *     true.
+     */
+    private isPlayingAllowed;
+    /**
+     * Prepares to play audio by recording the time of the last play and resuming
+     * the audio context.
+     */
+    private prepareToPlay;
     /**
      * @param muted If true, mute sounds. Otherwise, play them.
      */

package/core/workspace_svg.d.ts

@@ -29,11 +29,8 @@ import { type IFocusableNode } from './interfaces/i_focusable_node.js';
 import type { IFocusableTree } from './interfaces/i_focusable_tree.js';
 import type { IMetricsManager } from './interfaces/i_metrics_manager.js';
 import type { IToolbox } from './interfaces/i_toolbox.js';
-import type { LineCursor } from './keyboard_nav/line_cursor.js';
-import type { Marker } from './keyboard_nav/marker.js';
+import { Navigator } from './keyboard_nav/navigators/navigator.js';
 import { LayerManager } from './layer_manager.js';
-import { MarkerManager } from './marker_manager.js';
-import { Navigator } from './navigator.js';
 import { Options } from './options.js';
 import type { Renderer } from './renderers/common/renderer.js';
 import type { ScrollbarPair } from './scrollbar_pair.js';
@@ -220,7 +217,6 @@ export declare class WorkspaceSvg extends Workspace implements IContextMenu, IFo
     private readonly highlightedBlocks;
     private audioManager;
     private grid;
-    private markerManager;
     /**
      * Map from function names to callbacks, for deciding what to do when a
      * custom toolbox category is opened.
@@ -235,10 +231,6 @@ export declare class WorkspaceSvg extends Workspace implements IContextMenu, IFo
     private readonly renderer;
     /** Cached parent SVG. */
     private cachedParentSvg;
-    /** True if keyboard accessibility mode is on, false otherwise. */
-    keyboardAccessibilityMode: boolean;
-    /** True iff a keyboard-initiated move ("drag") is in progress. */
-    keyboardMoveInProgress: boolean;
     /** The list of top-level bounded elements on the workspace. */
     private topBoundedElements;
     /** The recorded drag targets. */
@@ -259,12 +251,6 @@ export declare class WorkspaceSvg extends Workspace implements IContextMenu, IFo
      * @param options Dictionary of options.
      */
     constructor(options: Options);
-    /**
-     * Get the marker manager for this workspace.
-     *
-     * @returns The marker manager.
-     */
-    getMarkerManager(): MarkerManager;
     /**
      * Gets the metrics manager for this workspace.
      *
@@ -284,21 +270,6 @@ export declare class WorkspaceSvg extends Workspace implements IContextMenu, IFo
      * @returns The component manager.
      */
     getComponentManager(): ComponentManager;
-    /**
-     * Get the marker with the given ID.
-     *
-     * @param id The ID of the marker.
-     * @returns The marker with the given ID or null if no marker with the given
-     *     ID exists.
-     * @internal
-     */
-    getMarker(id: string): Marker | null;
-    /**
-     * The cursor for this workspace.
-     *
-     * @returns The cursor for the workspace.
-     */
-    getCursor(): LineCursor;
     /**
      * Get the block renderer attached to this workspace.
      *
@@ -608,11 +579,11 @@ export declare class WorkspaceSvg extends Workspace implements IContextMenu, IFo
     /**
      * Returns the drag target the pointer event is over.
      *
-     * @param e Pointer move event.
+     * @param e Pointer move event or a workspace coordinate.
      * @returns Null if not over a drag target, or the drag target the event is
      *     over.
      */
-    getDragTarget(e: PointerEvent): IDragTarget | null;
+    getDragTarget(e: PointerEvent | Coordinate): IDragTarget | null;
     /**
      * Handle a pointerdown on SVG drawing surface.
      *
@@ -633,24 +604,6 @@ export declare class WorkspaceSvg extends Workspace implements IContextMenu, IFo
      * @returns New location of object.
      */
     moveDrag(e: PointerEvent): Coordinate;
-    /**
-     * Indicate whether a keyboard move is in progress or not.
-     *
-     * Should be called with true when a keyboard move of an IDraggable
-     * is starts, and false when it finishes or is aborted.
-     *
-     * N.B.: This method is experimental and internal-only.  It is
-     * intended only to called only from the keyboard navigation plugin.
-     * Its signature and behaviour may be modified, or the method
-     * removed, at an time without notice and without being treated
-     * as a breaking change.
-     *
-     * TODO(#8960): Delete this.
-     *
-     * @internal
-     * @param inProgress Is a keyboard-initated move in progress?
-     */
-    setKeyboardMoveInProgress(inProgress: boolean): void;
     /**
      * Returns true iff the user is currently engaged in a drag gesture,
      * or if a keyboard-initated move is in progress.
@@ -1077,6 +1030,11 @@ export declare class WorkspaceSvg extends Workspace implements IContextMenu, IFo
     onTreeFocus(_node: IFocusableNode, _previousTree: IFocusableTree | null): void;
     /** See IFocusableTree.onTreeBlur. */
     onTreeBlur(nextTree: IFocusableTree | null): void;
+    /**
+     * Handles the user acting on this workspace via keyboard navigation by
+     * prompting them to use the arrow keys (instead of Enter) to navigate.
+     */
+    performAction(): void;
     /**
      * Returns an object responsible for coordinating movement of focus between
      * items on this workspace in response to keyboard navigation commands.

package/dart_compressed.js

@@ -226,15 +226,15 @@ int ${b.FUNCTION_NAME_PLACEHOLDER_}(num a, num b) {
 }
 `)+"("+c+", "+a+")",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},math_random_float$$module$build$src$generators$dart$math=function(a,b){b.definitions_.import_dart_math="import 'dart:math' as Math;";return["new Math.Random().nextDouble()",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},math_atan2$$module$build$src$generators$dart$math=function(a,b){b.definitions_.import_dart_math="import 'dart:math' as Math;";const c=b.valueToCode(a,"X",Order$$module$build$src$generators$dart$dart_generator.NONE)||
 "0";return["Math.atan2("+(b.valueToCode(a,"Y",Order$$module$build$src$generators$dart$dart_generator.NONE)||"0")+", "+c+") / Math.pi * 180",Order$$module$build$src$generators$dart$dart_generator.MULTIPLICATIVE]},procedures_defreturn$$module$build$src$generators$dart$procedures=function(a,b){const c=b.getProcedureName(a.getFieldValue("NAME"));var d="";b.STATEMENT_PREFIX&&(d+=b.injectId(b.STATEMENT_PREFIX,a));b.STATEMENT_SUFFIX&&(d+=b.injectId(b.STATEMENT_SUFFIX,a));d&&(d=b.prefixLines(d,b.INDENT));
-let e="";b.INFINITE_LOOP_TRAP&&(e=b.prefixLines(b.injectId(b.INFINITE_LOOP_TRAP,a),b.INDENT));let f="";a.getInput("STACK")&&(f=b.statementToCode(a,"STACK"));let g="";a.getInput("RETURN")&&(g=b.valueToCode(a,"RETURN",Order$$module$build$src$generators$dart$dart_generator.NONE)||"");let h="";f&&g&&(h=d);g&&(g=b.INDENT+"return "+g+";\n");const k=g?"dynamic":"void",l=[],m=a.getVars();for(let n=0;n<m.length;n++)l[n]=b.getVariableName(m[n]);d=k+" "+c+"("+l.join(", ")+") {\n"+d+e+f+h+g+"}";d=b.scrub_(a,
-d);b.definitions_["%"+c]=d;return null},procedures_callreturn$$module$build$src$generators$dart$procedures=function(a,b){const c=b.getProcedureName(a.getFieldValue("NAME")),d=[],e=a.getVars();for(let f=0;f<e.length;f++)d[f]=b.valueToCode(a,"ARG"+f,Order$$module$build$src$generators$dart$dart_generator.NONE)||"null";return[c+"("+d.join(", ")+")",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},procedures_callnoreturn$$module$build$src$generators$dart$procedures=function(a,b){return b.forBlock.procedures_callreturn(a,
-b)[0]+";\n"},procedures_ifreturn$$module$build$src$generators$dart$procedures=function(a,b){let c="if ("+(b.valueToCode(a,"CONDITION",Order$$module$build$src$generators$dart$dart_generator.NONE)||"false")+") {\n";b.STATEMENT_SUFFIX&&(c+=b.prefixLines(b.injectId(b.STATEMENT_SUFFIX,a),b.INDENT));a.hasReturnValue_?(a=b.valueToCode(a,"VALUE",Order$$module$build$src$generators$dart$dart_generator.NONE)||"null",c+=b.INDENT+"return "+a+";\n"):c+=b.INDENT+"return;\n";return c+"}\n"},text$$module$build$src$generators$dart$text=
-function(a,b){return[b.quote_(a.getFieldValue("TEXT")),Order$$module$build$src$generators$dart$dart_generator.ATOMIC]},text_join$$module$build$src$generators$dart$text=function(a,b){switch(a.itemCount_){case 0:return["''",Order$$module$build$src$generators$dart$dart_generator.ATOMIC];case 1:return[(b.valueToCode(a,"ADD0",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX)||"''")+".toString()",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX];default:const c=Array(a.itemCount_);
-for(let d=0;d<a.itemCount_;d++)c[d]=b.valueToCode(a,"ADD"+d,Order$$module$build$src$generators$dart$dart_generator.NONE)||"''";return["["+c.join(",")+"].join()",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]}},text_append$$module$build$src$generators$dart$text=function(a,b){const c=b.getVariableName(a.getFieldValue("VAR"));a=b.valueToCode(a,"TEXT",Order$$module$build$src$generators$dart$dart_generator.NONE)||"''";return c+" = ["+c+", "+a+"].join();\n"},text_length$$module$build$src$generators$dart$text=
-function(a,b){return[(b.valueToCode(a,"VALUE",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX)||"''")+".length",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},text_isEmpty$$module$build$src$generators$dart$text=function(a,b){return[(b.valueToCode(a,"VALUE",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX)||"''")+".isEmpty",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},text_indexOf$$module$build$src$generators$dart$text=
-function(a,b){const c=a.getFieldValue("END")==="FIRST"?"indexOf":"lastIndexOf",d=b.valueToCode(a,"FIND",Order$$module$build$src$generators$dart$dart_generator.NONE)||"''";b=(b.valueToCode(a,"VALUE",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX)||"''")+"."+c+"("+d+")";return a.workspace.options.oneBasedIndex?[b+" + 1",Order$$module$build$src$generators$dart$dart_generator.ADDITIVE]:[b,Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},text_charAt$$module$build$src$generators$dart$text=
-function(a,b){const c=a.getFieldValue("WHERE")||"FROM_START",d=b.valueToCode(a,"VALUE",c==="FIRST"||c==="FROM_START"?Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX:Order$$module$build$src$generators$dart$dart_generator.NONE)||"''";switch(c){case "FIRST":return[d+"[0]",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX];case "FROM_START":return a=b.getAdjusted(a,"AT"),[d+"["+a+"]",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX];case "LAST":case "FROM_END":return a=
-c==="LAST"?1:b.getAdjusted(a,"AT",1),[`${b.provideFunction_("text_get_from_end",`
+let e="";b.INFINITE_LOOP_TRAP&&(e=b.prefixLines(b.injectId(b.INFINITE_LOOP_TRAP,a),b.INDENT));let f="";a.getInput("STACK")&&(f=b.statementToCode(a,"STACK"));let g="";a.getInput("RETURN")&&(g=b.valueToCode(a,"RETURN",Order$$module$build$src$generators$dart$dart_generator.NONE)||"");let h="";f&&g&&(h=d);g&&(g=b.INDENT+"return "+g+";\n");const k=g?"dynamic":"void",l=[],m=a.getVarModels();for(let n=0;n<m.length;n++)l[n]=b.getVariableName(m[n].getId());d=k+" "+c+"("+l.join(", ")+") {\n"+d+e+f+h+g+"}";
+d=b.scrub_(a,d);b.definitions_["%"+c]=d;return null},procedures_callreturn$$module$build$src$generators$dart$procedures=function(a,b){const c=b.getProcedureName(a.getFieldValue("NAME")),d=[],e=a.getVarModels();for(let f=0;f<e.length;f++)d[f]=b.valueToCode(a,"ARG"+f,Order$$module$build$src$generators$dart$dart_generator.NONE)||"null";return[c+"("+d.join(", ")+")",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},procedures_callnoreturn$$module$build$src$generators$dart$procedures=
+function(a,b){return b.forBlock.procedures_callreturn(a,b)[0]+";\n"},procedures_ifreturn$$module$build$src$generators$dart$procedures=function(a,b){let c="if ("+(b.valueToCode(a,"CONDITION",Order$$module$build$src$generators$dart$dart_generator.NONE)||"false")+") {\n";b.STATEMENT_SUFFIX&&(c+=b.prefixLines(b.injectId(b.STATEMENT_SUFFIX,a),b.INDENT));a.hasReturnValue_?(a=b.valueToCode(a,"VALUE",Order$$module$build$src$generators$dart$dart_generator.NONE)||"null",c+=b.INDENT+"return "+a+";\n"):c+=b.INDENT+
+"return;\n";return c+"}\n"},text$$module$build$src$generators$dart$text=function(a,b){return[b.quote_(a.getFieldValue("TEXT")),Order$$module$build$src$generators$dart$dart_generator.ATOMIC]},text_join$$module$build$src$generators$dart$text=function(a,b){switch(a.itemCount_){case 0:return["''",Order$$module$build$src$generators$dart$dart_generator.ATOMIC];case 1:return[(b.valueToCode(a,"ADD0",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX)||"''")+".toString()",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX];
+default:const c=Array(a.itemCount_);for(let d=0;d<a.itemCount_;d++)c[d]=b.valueToCode(a,"ADD"+d,Order$$module$build$src$generators$dart$dart_generator.NONE)||"''";return["["+c.join(",")+"].join()",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]}},text_append$$module$build$src$generators$dart$text=function(a,b){const c=b.getVariableName(a.getFieldValue("VAR"));a=b.valueToCode(a,"TEXT",Order$$module$build$src$generators$dart$dart_generator.NONE)||"''";return c+" = ["+c+", "+a+
+"].join();\n"},text_length$$module$build$src$generators$dart$text=function(a,b){return[(b.valueToCode(a,"VALUE",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX)||"''")+".length",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},text_isEmpty$$module$build$src$generators$dart$text=function(a,b){return[(b.valueToCode(a,"VALUE",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX)||"''")+".isEmpty",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},
+text_indexOf$$module$build$src$generators$dart$text=function(a,b){const c=a.getFieldValue("END")==="FIRST"?"indexOf":"lastIndexOf",d=b.valueToCode(a,"FIND",Order$$module$build$src$generators$dart$dart_generator.NONE)||"''";b=(b.valueToCode(a,"VALUE",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX)||"''")+"."+c+"("+d+")";return a.workspace.options.oneBasedIndex?[b+" + 1",Order$$module$build$src$generators$dart$dart_generator.ADDITIVE]:[b,Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX]},
+text_charAt$$module$build$src$generators$dart$text=function(a,b){const c=a.getFieldValue("WHERE")||"FROM_START",d=b.valueToCode(a,"VALUE",c==="FIRST"||c==="FROM_START"?Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX:Order$$module$build$src$generators$dart$dart_generator.NONE)||"''";switch(c){case "FIRST":return[d+"[0]",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX];case "FROM_START":return a=b.getAdjusted(a,"AT"),[d+"["+a+"]",Order$$module$build$src$generators$dart$dart_generator.UNARY_POSTFIX];
+case "LAST":case "FROM_END":return a=c==="LAST"?1:b.getAdjusted(a,"AT",1),[`${b.provideFunction_("text_get_from_end",`
 String ${b.FUNCTION_NAME_PLACEHOLDER_}(String text, num x) {
   return text[text.length - x];
 }