blockly 11.2.0 → 12.0.0-beta.1

package/core/variables.d.ts

@@ -3,7 +3,9 @@
  * Copyright 2012 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { VariableModel } from './variable_model.js';
+import type { Block } from './block.js';
+import { IVariableModel, IVariableState } from './interfaces/i_variable_model.js';
+import type { BlockInfo, FlyoutItemInfo } from './utils/toolbox.js';
 import type { Workspace } from './workspace.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 /**
@@ -23,7 +25,7 @@ export declare const CATEGORY_NAME = "VARIABLE";
  * @param ws The workspace to search for variables.
  * @returns Array of variable models.
  */
-export declare function allUsedVarModels(ws: Workspace): VariableModel[];
+export declare function allUsedVarModels(ws: Workspace): IVariableModel<IVariableState>[];
 /**
  * Find all developer variables used by blocks in the workspace.
  * Developer variables are never shown to the user, but are declared as global
@@ -37,13 +39,26 @@ export declare function allUsedVarModels(ws: Workspace): VariableModel[];
  */
 export declare function allDeveloperVariables(workspace: Workspace): string[];
 /**
- * Construct the elements (blocks and button) required by the flyout for the
- * variable category.
+ * Internal wrapper that returns the contents of the variables category.
  *
+ * @internal
+ * @param workspace The workspace to populate variable blocks for.
+ */
+export declare function internalFlyoutCategory(workspace: WorkspaceSvg): FlyoutItemInfo[];
+export declare function flyoutCategory(workspace: WorkspaceSvg, useXml: true): Element[];
+export declare function flyoutCategory(workspace: WorkspaceSvg, useXml: false): FlyoutItemInfo[];
+/**
+ * Construct the blocks required by the flyout for the variable category.
+ *
+ * @internal
  * @param workspace The workspace containing variables.
- * @returns Array of XML elements.
+ * @param variables List of variables to create blocks for.
+ * @param includeChangeBlocks True to include `change x by _` blocks.
+ * @param getterType The type of the variable getter block to generate.
+ * @param setterType The type of the variable setter block to generate.
+ * @returns JSON list of blocks.
  */
-export declare function flyoutCategory(workspace: WorkspaceSvg): Element[];
+export declare function jsonFlyoutCategoryBlocks(workspace: Workspace, variables: IVariableModel<IVariableState>[], includeChangeBlocks: boolean, getterType?: string, setterType?: string): BlockInfo[];
 /**
  * Construct the blocks required by the flyout for the variable category.
  *
@@ -104,7 +119,7 @@ export declare function createVariableButtonHandler(workspace: Workspace, opt_ca
  *     name, or null if change is to be aborted (cancel button), or undefined if
  *     an existing variable was chosen.
  */
-export declare function renameVariable(workspace: Workspace, variable: VariableModel, opt_callback?: (p1?: string | null) => void): void;
+export declare function renameVariable(workspace: Workspace, variable: IVariableModel<IVariableState>, opt_callback?: (p1?: string | null) => void): void;
 /**
  * Prompt the user for a new variable name.
  *
@@ -121,7 +136,7 @@ export declare function promptName(promptText: string, defaultText: string, call
  * @param workspace The workspace to search for the variable.
  * @returns The variable with the given name, or null if none was found.
  */
-export declare function nameUsedWithAnyType(name: string, workspace: Workspace): VariableModel | null;
+export declare function nameUsedWithAnyType(name: string, workspace: Workspace): IVariableModel<IVariableState> | null;
 /**
  * Returns the name of the procedure with a conflicting parameter name, or null
  * if one does not exist.
@@ -141,7 +156,7 @@ export declare function nameUsedWithConflictingParam(oldName: string, newName: s
  * @param variableModel The variable model to represent.
  * @returns The generated DOM.
  */
-export declare function generateVariableFieldDom(variableModel: VariableModel): Element;
+export declare function generateVariableFieldDom(variableModel: IVariableModel<IVariableState>): Element;
 /**
  * Helper function to look up or create a variable on the given workspace.
  * If no variable exists, creates and returns it.
@@ -154,7 +169,7 @@ export declare function generateVariableFieldDom(variableModel: VariableModel):
  * @returns The variable corresponding to the given ID or name + type
  *     combination.
  */
-export declare function getOrCreateVariablePackage(workspace: Workspace, id: string | null, opt_name?: string, opt_type?: string): VariableModel;
+export declare function getOrCreateVariablePackage(workspace: Workspace, id: string | null, opt_name?: string, opt_type?: string): IVariableModel<IVariableState>;
 /**
  * Look up  a variable on the given workspace.
  * Always looks in the main workspace before looking in the flyout workspace.
@@ -170,7 +185,7 @@ export declare function getOrCreateVariablePackage(workspace: Workspace, id: str
  * @returns The variable corresponding to the given ID or name + type
  *     combination, or null if not found.
  */
-export declare function getVariable(workspace: Workspace, id: string | null, opt_name?: string, opt_type?: string): VariableModel | null;
+export declare function getVariable(workspace: Workspace, id: string | null, opt_name?: string, opt_type?: string): IVariableModel<IVariableState> | null;
 /**
  * Helper function to get the list of variables that have been added to the
  * workspace after adding a new block, using the given list of variables that
@@ -184,7 +199,36 @@ export declare function getVariable(workspace: Workspace, id: string | null, opt
  *     workspace.
  * @internal
  */
-export declare function getAddedVariables(workspace: Workspace, originalVariables: VariableModel[]): VariableModel[];
+export declare function getAddedVariables(workspace: Workspace, originalVariables: IVariableModel<IVariableState>[]): IVariableModel<IVariableState>[];
+/**
+ * A custom compare function for the VariableModel objects.
+ *
+ * @param var1 First variable to compare.
+ * @param var2 Second variable to compare.
+ * @returns -1 if name of var1 is less than name of var2, 0 if equal, and 1 if
+ *     greater.
+ * @internal
+ */
+export declare function compareByName(var1: IVariableModel<IVariableState>, var2: IVariableModel<IVariableState>): number;
+/**
+ * Find all the uses of a named variable.
+ *
+ * @param workspace The workspace to search for the variable.
+ * @param id ID of the variable to find.
+ * @returns Array of block usages.
+ */
+export declare function getVariableUsesById(workspace: Workspace, id: string): Block[];
+/**
+ * Delete a variable and all of its uses from the given workspace. May prompt
+ * the user for confirmation.
+ *
+ * @param workspace The workspace from which to delete the variable.
+ * @param variable The variable to delete.
+ * @param triggeringBlock The block from which this deletion was triggered, if
+ *     any. Used to exclude it from checking and warning about blocks
+ *     referencing the variable being deleted.
+ */
+export declare function deleteVariable(workspace: Workspace, variable: IVariableModel<IVariableState>, triggeringBlock?: Block): void;
 export declare const TEST_ONLY: {
     generateUniqueNameInternal: typeof generateUniqueNameInternal;
 };

package/core/variables_dynamic.d.ts

@@ -4,6 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { FlyoutButton } from './flyout_button.js';
+import type { FlyoutItemInfo } from './utils/toolbox.js';
 import type { Workspace } from './workspace.js';
 import type { WorkspaceSvg } from './workspace_svg.js';
 /**
@@ -36,13 +37,14 @@ export declare const onCreateVariableButtonClick_Number: typeof numberButtonClic
 declare function colourButtonClickHandler(button: FlyoutButton): void;
 export declare const onCreateVariableButtonClick_Colour: typeof colourButtonClickHandler;
 /**
- * Construct the elements (blocks and button) required by the flyout for the
- * variable category.
+ * Internal wrapper that returns the contents of the dynamic variables category.
  *
- * @param workspace The workspace containing variables.
- * @returns Array of XML elements.
+ * @internal
+ * @param workspace The workspace to populate variable blocks for.
  */
-export declare function flyoutCategory(workspace: WorkspaceSvg): Element[];
+export declare function internalFlyoutCategory(workspace: WorkspaceSvg): FlyoutItemInfo[];
+export declare function flyoutCategory(workspace: WorkspaceSvg, useXml: true): Element[];
+export declare function flyoutCategory(workspace: WorkspaceSvg, useXml: false): FlyoutItemInfo[];
 /**
  * Construct the blocks required by the flyout for the variable category.
  *

package/core/widgetdiv.d.ts

@@ -54,9 +54,9 @@ export declare function hideIfOwner(oldOwner: unknown): void;
  * Destroy the widget and hide the div if it is being used by an object in the
  * specified workspace, or if it is used by an unknown workspace.
  *
- * @param oldOwnerWorkspace The workspace that was using this container.
+ * @param workspace The workspace that was using this container.
  */
-export declare function hideIfOwnerIsInWorkspace(oldOwnerWorkspace: WorkspaceSvg): void;
+export declare function hideIfOwnerIsInWorkspace(workspace: WorkspaceSvg): void;
 /**
  * Position the widget div based on an anchor rectangle.
  * The widget should be placed adjacent to but not overlapping the anchor

package/core/workspace.d.ts

@@ -16,10 +16,10 @@ import type { Abstract } from './events/events_abstract.js';
 import type { IASTNodeLocation } from './interfaces/i_ast_node_location.js';
 import type { IConnectionChecker } from './interfaces/i_connection_checker.js';
 import { IProcedureMap } from './interfaces/i_procedure_map.js';
+import type { IVariableMap } from './interfaces/i_variable_map.js';
+import type { IVariableModel, IVariableState } from './interfaces/i_variable_model.js';
 import { Options } from './options.js';
 import type * as toolbox from './utils/toolbox.js';
-import { VariableMap } from './variable_map.js';
-import type { VariableModel } from './variable_model.js';
 /**
  * Class for a workspace.  This is a data structure that contains blocks.
  * There is no UI, and can be created headlessly.
@@ -183,8 +183,8 @@ export declare class Workspace implements IASTNodeLocation {
     /** Dispose of all blocks and comments in workspace. */
     clear(): void;
     /**
-     * Rename a variable by updating its name in the variable map. Identify the
-     * variable to rename with the given ID.
+     * @deprecated v12 - Rename a variable by updating its name in the variable
+     * map. Identify the variable to rename with the given ID.
      *
      * @param id ID of the variable to rename.
      * @param newName New variable name.
@@ -193,6 +193,7 @@ export declare class Workspace implements IASTNodeLocation {
     /**
      * Create a variable with a given name, optional type, and optional ID.
      *
+     * @deprecated v12, use Blockly.Workspace.getVariableMap().createVariable.
      * @param name The name of the variable. This must be unique across variables
      *     and procedures.
      * @param opt_type The type of the variable like 'int' or 'string'.
@@ -201,10 +202,11 @@ export declare class Workspace implements IASTNodeLocation {
      * @param opt_id The unique ID of the variable. This will default to a UUID.
      * @returns The newly created variable.
      */
-    createVariable(name: string, opt_type?: string | null, opt_id?: string | null): VariableModel;
+    createVariable(name: string, opt_type?: string | null, opt_id?: string | null): IVariableModel<IVariableState>;
     /**
      * Find all the uses of the given variable, which is identified by ID.
      *
+     * @deprecated v12, use Blockly.Workspace.getVariableMap().getVariableUsesById
      * @param id ID of the variable to find.
      * @returns Array of block usages.
      */
@@ -213,6 +215,7 @@ export declare class Workspace implements IASTNodeLocation {
      * Delete a variables by the passed in ID and all of its uses from this
      * workspace. May prompt the user for confirmation.
      *
+     * @deprecated v12, use Blockly.Workspace.getVariableMap().deleteVariable.
      * @param id ID of variable to delete.
      */
     deleteVariableById(id: string): void;
@@ -220,44 +223,42 @@ export declare class Workspace implements IASTNodeLocation {
      * Find the variable by the given name and return it. Return null if not
      * found.
      *
+     * @deprecated v12, use Blockly.Workspace.getVariableMap().getVariable.
      * @param name The name to check for.
      * @param opt_type The type of the variable.  If not provided it defaults to
      *     the empty string, which is a specific type.
      * @returns The variable with the given name.
      */
-    getVariable(name: string, opt_type?: string): VariableModel | null;
+    getVariable(name: string, opt_type?: string): IVariableModel<IVariableState> | null;
     /**
      * Find the variable by the given ID and return it. Return null if not found.
      *
+     * @deprecated v12, use Blockly.Workspace.getVariableMap().getVariableById.
      * @param id The ID to check for.
      * @returns The variable with the given ID.
      */
-    getVariableById(id: string): VariableModel | null;
+    getVariableById(id: string): IVariableModel<IVariableState> | null;
     /**
      * Find the variable with the specified type. If type is null, return list of
      *     variables with empty string type.
      *
+     * @deprecated v12, use Blockly.Workspace.getVariableMap().getVariablesOfType.
      * @param type Type of the variables to find.
      * @returns The sought after variables of the passed in type. An empty array
      *     if none are found.
      */
-    getVariablesOfType(type: string | null): VariableModel[];
-    /**
-     * Return all variable types.
-     *
-     * @returns List of variable types.
-     * @internal
-     */
-    getVariableTypes(): string[];
+    getVariablesOfType(type: string | null): IVariableModel<IVariableState>[];
     /**
      * Return all variables of all types.
      *
+     * @deprecated v12, use Blockly.Workspace.getVariableMap().getAllVariables.
      * @returns List of variable models.
      */
-    getAllVariables(): VariableModel[];
+    getAllVariables(): IVariableModel<IVariableState>[];
     /**
      * Returns all variable names of all types.
      *
+     * @deprecated v12, use Blockly.Workspace.getVariableMap().getAllVariables.
      * @returns List of all variable names of all types.
      */
     getAllVariableNames(): string[];
@@ -411,7 +412,7 @@ export declare class Workspace implements IASTNodeLocation {
      * @returns The potential variable map.
      * @internal
      */
-    getPotentialVariableMap(): VariableMap | null;
+    getPotentialVariableMap(): IVariableMap<IVariableModel<IVariableState>> | null;
     /**
      * Create and store the potential variable map for this workspace.
      *
@@ -423,14 +424,14 @@ export declare class Workspace implements IASTNodeLocation {
      *
      * @returns The variable map.
      */
-    getVariableMap(): VariableMap;
+    getVariableMap(): IVariableMap<IVariableModel<IVariableState>>;
     /**
      * Set the map of all variables on the workspace.
      *
      * @param variableMap The variable map.
      * @internal
      */
-    setVariableMap(variableMap: VariableMap): void;
+    setVariableMap(variableMap: IVariableMap<IVariableModel<IVariableState>>): void;
     /** Returns the map of all procedures on the workpace. */
     getProcedureMap(): IProcedureMap;
     /**
@@ -454,5 +455,6 @@ export declare class Workspace implements IASTNodeLocation {
      * @returns Array of workspaces.
      */
     static getAll(): Workspace[];
+    protected getVariableMapClass(): new (...p1: any[]) => IVariableMap<IVariableModel<IVariableState>>;
 }
 //# sourceMappingURL=workspace.d.ts.map

package/core/workspace_svg.d.ts

@@ -26,6 +26,7 @@ import type { IDragTarget } from './interfaces/i_drag_target.js';
 import type { IFlyout } from './interfaces/i_flyout.js';
 import type { IMetricsManager } from './interfaces/i_metrics_manager.js';
 import type { IToolbox } from './interfaces/i_toolbox.js';
+import type { IVariableModel, IVariableState } from './interfaces/i_variable_model.js';
 import type { Cursor } from './keyboard_nav/cursor.js';
 import type { Marker } from './keyboard_nav/marker.js';
 import { LayerManager } from './layer_manager.js';
@@ -42,7 +43,6 @@ import { Rect } from './utils/rect.js';
 import { Size } from './utils/size.js';
 import { Svg } from './utils/svg.js';
 import * as toolbox from './utils/toolbox.js';
-import type { VariableModel } from './variable_model.js';
 import { Workspace } from './workspace.js';
 import { WorkspaceAudio } from './workspace_audio.js';
 import { ZoomControls } from './zoom_controls.js';
@@ -392,7 +392,7 @@ export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationS
      * @returns The first parent div with 'injectionDiv' in the name.
      * @internal
      */
-    getInjectionDiv(): Element;
+    getInjectionDiv(): HTMLElement;
     /**
      * Returns the SVG group for the workspace.
      *
@@ -419,7 +419,7 @@ export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationS
      *     'blocklyMutatorBackground'.
      * @returns The workspace's SVG group.
      */
-    createDom(opt_backgroundClass?: string, injectionDiv?: Element): Element;
+    createDom(opt_backgroundClass?: string, injectionDiv?: HTMLElement): Element;
     /**
      * Dispose of this workspace.
      * Unlink from all DOM elements to prevent memory leaks.
@@ -495,6 +495,7 @@ export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationS
     updateScreenCalculationsIfScrolled(): void;
     /**
      * @returns The layer manager for this workspace.
+     * @internal
      */
     getLayerManager(): LayerManager | null;
     /**
@@ -603,7 +604,7 @@ export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationS
      * @param opt_id The unique ID of the variable. This will default to a UUID.
      * @returns The newly created variable.
      */
-    createVariable(name: string, opt_type?: string | null, opt_id?: string | null): VariableModel;
+    createVariable(name: string, opt_type?: string | null, opt_id?: string | null): IVariableModel<IVariableState>;
     /** Make a list of all the delete areas for this workspace. */
     recordDragTargets(): void;
     /**
@@ -773,12 +774,27 @@ export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationS
      */
     setScale(newScale: number): void;
     /**
-     * Get the workspace's zoom factor.  If the workspace has a parent, we call
-     * into the parent to get the workspace scale.
+     * Get the workspace's zoom factor.
      *
      * @returns The workspace zoom factor. Units: (pixels / workspaceUnit).
      */
     getScale(): number;
+    /**
+     * Returns the absolute scale of the workspace.
+     *
+     * Workspace scaling is multiplicative; if a workspace B (e.g. a mutator editor)
+     * with scale Y is nested within a root workspace A with scale X, workspace B's
+     * effective scale is X * Y, because, as a child of A, it is already transformed
+     * by A's scaling factor, and then further transforms itself by its own scaling
+     * factor. Normally this Just Works, but for global elements (e.g. field
+     * editors) that are visually associated with a particular workspace but live at
+     * the top level of the DOM rather than being a child of their associated
+     * workspace, the absolute/effective scale may be needed to render
+     * appropriately.
+     *
+     * @returns The absolute/effective scale of the given workspace.
+     */
+    getAbsoluteScale(): number;
     /**
      * Scroll the workspace to a specified offset (in pixels), keeping in the
      * workspace bounds. See comment on workspaceSvg.scrollX for more detail on
@@ -975,6 +991,18 @@ export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationS
      *     and 1 specifying the degree of scrolling.
      */
     private static setTopLevelWorkspaceMetrics;
+    /**
+     * Adds a CSS class to the workspace.
+     *
+     * @param className Name of class to add.
+     */
+    addClass(className: string): void;
+    /**
+     * Removes a CSS class from the workspace.
+     *
+     * @param className Name of class to remove.
+     */
+    removeClass(className: string): void;
 }
 /**
  * Size the workspace when the contents change.  This also updates

package/core/xml.d.ts

@@ -5,7 +5,7 @@
  */
 import type { Block } from './block.js';
 import { WorkspaceComment } from './comments/workspace_comment.js';
-import type { VariableModel } from './variable_model.js';
+import type { IVariableModel, IVariableState } from './interfaces/i_variable_model.js';
 import type { Workspace } from './workspace.js';
 import { WorkspaceSvg } from './workspace_svg.js';
 /**
@@ -25,7 +25,7 @@ export declare function saveWorkspaceComment(comment: WorkspaceComment, skipId?:
  * @param variableList List of all variable models.
  * @returns Tree of XML elements.
  */
-export declare function variablesToDom(variableList: VariableModel[]): Element;
+export declare function variablesToDom(variableList: IVariableModel<IVariableState>[]): Element;
 /**
  * Encode a block subtree as XML with XY coordinates.
  *

package/index.mjs

@@ -3,8 +3,10 @@ export const {
   ASTNode,
   BasicCursor,
   Block,
+  BlockFlyoutInflater,
   BlockSvg,
   Blocks,
+  ButtonFlyoutInflater,
   COLLAPSED_FIELD_NAME,
   COLLAPSED_INPUT_NAME,
   COLLAPSE_CHARS,
@@ -37,15 +39,17 @@ export const {
   FieldVariable,
   Flyout,
   FlyoutButton,
+  FlyoutItem,
   FlyoutMetricsManager,
+  FlyoutSeparator,
   Generator,
   Gesture,
   Grid,
   HorizontalFlyout,
   INPUT_VALUE,
   Input,
-  InsertionMarkerManager,
   InsertionMarkerPreviewer,
+  LabelFlyoutInflater,
   Marker,
   MarkerManager,
   Menu,
@@ -64,6 +68,7 @@ export const {
   RenderedConnection,
   Scrollbar,
   ScrollbarPair,
+  SeparatorFlyoutInflater,
   ShortcutItems,
   ShortcutRegistry,
   TOOLBOX_AT_BOTTOM,

package/package.json

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

package/php_compressed.js

@@ -200,7 +200,7 @@ function ${b.FUNCTION_NAME_PLACEHOLDER_}($a, $b) {
   return rand($a, $b);
 }
 `)+"("+c+", "+a+")",Order$$module$build$src$generators$php$php_generator.FUNCTION_CALL]},math_random_float$$module$build$src$generators$php$math=function(a,b){return["(float)rand()/(float)getrandmax()",Order$$module$build$src$generators$php$php_generator.FUNCTION_CALL]},math_atan2$$module$build$src$generators$php$math=function(a,b){const c=b.valueToCode(a,"X",Order$$module$build$src$generators$php$php_generator.NONE)||"0";return["atan2("+(b.valueToCode(a,"Y",Order$$module$build$src$generators$php$php_generator.NONE)||
-"0")+", "+c+") / pi() * 180",Order$$module$build$src$generators$php$php_generator.DIVISION]},procedures_defreturn$$module$build$src$generators$php$procedures=function(a,b){var c=[],d=a.workspace,e=$.allUsedVarModels$$module$build$src$core$variables(d)||[];for(var f of e)e=f.name,a.getVars().includes(e)||c.push(b.getVariableName(e));d=$.allDeveloperVariables$$module$build$src$core$variables(d);for(f=0;f<d.length;f++)c.push(b.nameDB_.getName(d[f],$.NameType$$module$build$src$core$names.DEVELOPER_VARIABLE));
+"0")+", "+c+") / pi() * 180",Order$$module$build$src$generators$php$php_generator.DIVISION]},procedures_defreturn$$module$build$src$generators$php$procedures=function(a,b){var c=[],d=a.workspace,e=$.allUsedVarModels$$module$build$src$core$variables(d)||[];for(var f of e)e=f.getName(),a.getVars().includes(e)||c.push(b.getVariableName(e));d=$.allDeveloperVariables$$module$build$src$core$variables(d);for(f=0;f<d.length;f++)c.push(b.nameDB_.getName(d[f],$.NameType$$module$build$src$core$names.DEVELOPER_VARIABLE));
 d=c.length?b.INDENT+"global "+c.join(", ")+";\n":"";c=b.getProcedureName(a.getFieldValue("NAME"));f="";b.STATEMENT_PREFIX&&(f+=b.injectId(b.STATEMENT_PREFIX,a));b.STATEMENT_SUFFIX&&(f+=b.injectId(b.STATEMENT_SUFFIX,a));f&&(f=b.prefixLines(f,b.INDENT));e="";b.INFINITE_LOOP_TRAP&&(e=b.prefixLines(b.injectId(b.INFINITE_LOOP_TRAP,a),b.INDENT));let g="";a.getInput("STACK")&&(g=b.statementToCode(a,"STACK"));let h="";a.getInput("RETURN")&&(h=b.valueToCode(a,"RETURN",Order$$module$build$src$generators$php$php_generator.NONE)||
 "");let k="";g&&h&&(k=f);h&&(h=b.INDENT+"return "+h+";\n");const l=[],m=a.getVars();for(let n=0;n<m.length;n++)l[n]=b.getVariableName(m[n]);d="function "+c+"("+l.join(", ")+") {\n"+d+f+e+g+k+h+"}";d=b.scrub_(a,d);b.definitions_["%"+c]=d;return null},procedures_callreturn$$module$build$src$generators$php$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$php$php_generator.NONE)||
 "null";return[c+"("+d.join(", ")+")",Order$$module$build$src$generators$php$php_generator.FUNCTION_CALL]},procedures_callnoreturn$$module$build$src$generators$php$procedures=function(a,b){return b.forBlock.procedures_callreturn(a,b)[0]+";\n"},procedures_ifreturn$$module$build$src$generators$php$procedures=function(a,b){let c="if ("+(b.valueToCode(a,"CONDITION",Order$$module$build$src$generators$php$php_generator.NONE)||"false")+") {\n";b.STATEMENT_SUFFIX&&(c+=b.prefixLines(b.injectId(b.STATEMENT_SUFFIX,