blockly 11.0.0-beta.8 → 11.0.0

package/core/interfaces/i_flyout.d.ts

@@ -9,6 +9,7 @@ import type { Coordinate } from '../utils/coordinate.js';
 import type { FlyoutDefinition } from '../utils/toolbox.js';
 import type { Svg } from '../utils/svg.js';
 import type { IRegistrable } from './i_registrable.js';
+import { FlyoutItem } from '../flyout_base.js';
 /**
  * Interface for a flyout.
  */
@@ -94,6 +95,15 @@ export interface IFlyout extends IRegistrable {
      *     of the dynamic category.
      */
     show(flyoutDef: FlyoutDefinition | string): void;
+    /**
+     * Returns the list of flyout items currently present in the flyout.
+     * The `show` method parses the flyout definition into a list of actual
+     * flyout items. This method should return those concrete items, which
+     * may be used for e.g. keyboard navigation.
+     *
+     * @returns List of flyout items.
+     */
+    getContents(): FlyoutItem[];
     /**
      * Create a copy of this block on the workspace.
      *

package/core/keyboard_nav/ast_node.d.ts

@@ -9,7 +9,7 @@
  *
  * @class
  */
-import type { Block } from '../block.js';
+import { Block } from '../block.js';
 import type { Connection } from '../connection.js';
 import type { Field } from '../field.js';
 import type { Input } from '../inputs/input.js';
@@ -127,6 +127,15 @@ export declare class ASTNode {
      * @returns The next button, or next stack's first block, or null
      */
     private navigateFlyoutContents;
+    /**
+     * Finds the next (or previous if navigating backward) item in the flyout that should be navigated to.
+     *
+     * @param flyoutContents Contents of the current flyout.
+     * @param currentLocation Current ASTNode location.
+     * @param forward True if we're navigating forward, else false.
+     * @returns The next (or previous) FlyoutItem, or null if there is none.
+     */
+    private findNextLocationInFlyout;
     /**
      * Finds the top most AST node for a given block.
      * This is either the previous connection, output connection or block

package/core/layer_manager.d.ts

@@ -11,11 +11,22 @@ export declare class LayerManager {
     private workspace;
     /** The layer elements being dragged are appended to. */
     private dragLayer;
+    /** The layer elements being animated are appended to. */
+    private animationLayer;
     /** The layers elements not being dragged are appended to.  */
     private layers;
     /** @internal */
     constructor(workspace: WorkspaceSvg);
     private createDragLayer;
+    private createAnimationLayer;
+    /**
+     * Appends the element to the animation layer. The animation layer doesn't
+     * move when the workspace moves, so e.g. delete animations don't move
+     * when a block delete triggers a workspace resize.
+     *
+     * @internal
+     */
+    appendToAnimationLayer(elem: IRenderedElement): void;
     /**
      * Translates layers when the workspace is dragged or zoomed.
      *

package/core/serialization/blocks.d.ts

@@ -27,6 +27,7 @@ export interface State {
     movable?: boolean;
     editable?: boolean;
     enabled?: boolean;
+    disabledReasons?: string[];
     inline?: boolean;
     data?: string;
     extraState?: any;

package/core/serialization/workspace_comments.d.ts

@@ -5,7 +5,7 @@
  */
 import { ISerializer } from '../interfaces/i_serializer.js';
 import { Workspace } from '../workspace.js';
-import { WorkspaceComment } from '../comments/workspace_comment.js';
+import type { WorkspaceComment } from '../comments/workspace_comment.js';
 export interface State {
     id?: string;
     text?: string;

package/core/utils/toolbox.d.ts

@@ -16,6 +16,7 @@ export interface BlockInfo {
     type?: string;
     gap?: string | number;
     disabled?: string | boolean;
+    disabledReasons?: string[];
     enabled?: boolean;
     id?: string;
     x?: number;

package/core/workspace.d.ts

@@ -18,7 +18,7 @@ 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';
-import type { WorkspaceComment } from './workspace_comment.js';
+import { WorkspaceComment } from './comments/workspace_comment.js';
 import { IProcedureMap } from './interfaces/i_procedure_map.js';
 /**
  * Class for a workspace.  This is a data structure that contains blocks.
@@ -279,6 +279,14 @@ export declare class Workspace implements IASTNodeLocation {
      * @returns The created block.
      */
     newBlock(prototypeName: string, opt_id?: string): Block;
+    /**
+     * Obtain a newly created comment.
+     *
+     * @param id Optional ID.  Use this ID if provided, otherwise create a new
+     *     ID.
+     * @returns The created comment.
+     */
+    newComment(id?: string): WorkspaceComment;
     /**
      * The number of blocks that may be added to the workspace before reaching
      *     the maxBlocks.

package/core/workspace_svg.d.ts

@@ -42,7 +42,7 @@ 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 { WorkspaceComment } from './workspace_comment.js';
+import { WorkspaceComment } from './comments/workspace_comment.js';
 import { ZoomControls } from './zoom_controls.js';
 import { ContextMenuOption } from './contextmenu_registry.js';
 import { LayerManager } from './layer_manager.js';
@@ -618,6 +618,14 @@ export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationS
      * @returns The created block.
      */
     newBlock(prototypeName: string, opt_id?: string): BlockSvg;
+    /**
+     * Obtain a newly created comment.
+     *
+     * @param id Optional ID.  Use this ID if provided, otherwise create a new
+     *     ID.
+     * @returns The created comment.
+     */
+    newComment(id?: string): WorkspaceComment;
     /**
      * Returns the drag target the pointer event is over.
      *
@@ -704,7 +712,7 @@ export declare class WorkspaceSvg extends Workspace implements IASTNodeLocationS
      * @param e Mouse event.
      * @internal
      */
-    showContextMenu(e: Event): void;
+    showContextMenu(e: PointerEvent): void;
     /**
      * Modify the block tree on the existing toolbox.
      *

package/core.js

@@ -0,0 +1,4 @@
+// Shim for backwards-compatibility with bundlers that do not
+// support the 'exports' clause in package.json, to allow them
+// to load the blockly/core submodule entrypoint.
+module.exports = require('./blockly_compressed.js');

package/dart.js

@@ -0,0 +1,4 @@
+// Shim for backwards-compatibility with bundlers that do not
+// support the 'exports' clause in package.json, to allow them
+// to load the blockly/dart submodule entrypoint.
+module.exports = require('./dart_compressed.js');

package/dart.mjs

@@ -0,0 +1,6 @@
+import dart from './dart_compressed.js';
+export const {
+  DartGenerator,
+  Order,
+  dartGenerator,
+} = dart;

package/index.mjs

@@ -0,0 +1,143 @@
+import Blockly from './index.js';
+export const {
+  ASTNode,
+  BasicCursor,
+  Block,
+  BlockSvg,
+  Blocks,
+  COLLAPSED_FIELD_NAME,
+  COLLAPSED_INPUT_NAME,
+  COLLAPSE_CHARS,
+  CodeGenerator,
+  CollapsibleToolboxCategory,
+  ComponentManager,
+  Connection,
+  ConnectionChecker,
+  ConnectionDB,
+  ConnectionType,
+  ContextMenu,
+  ContextMenuItems,
+  ContextMenuRegistry,
+  Css,
+  Cursor,
+  DELETE_VARIABLE_ID,
+  DeleteArea,
+  DragTarget,
+  DropDownDiv,
+  Events,
+  Extensions,
+  Field,
+  FieldCheckbox,
+  FieldDropdown,
+  FieldImage,
+  FieldLabel,
+  FieldLabelSerializable,
+  FieldNumber,
+  FieldTextInput,
+  FieldVariable,
+  Flyout,
+  FlyoutButton,
+  FlyoutMetricsManager,
+  Generator,
+  Gesture,
+  Grid,
+  HorizontalFlyout,
+  INPUT_VALUE,
+  Input,
+  InsertionMarkerManager,
+  InsertionMarkerPreviewer,
+  Marker,
+  MarkerManager,
+  Menu,
+  MenuItem,
+  MetricsManager,
+  Msg,
+  NEXT_STATEMENT,
+  Names,
+  OPPOSITE_TYPE,
+  OUTPUT_VALUE,
+  Options,
+  PREVIOUS_STATEMENT,
+  PROCEDURE_CATEGORY_NAME,
+  Procedures,
+  RENAME_VARIABLE_ID,
+  RenderedConnection,
+  Scrollbar,
+  ScrollbarPair,
+  ShortcutItems,
+  ShortcutRegistry,
+  TOOLBOX_AT_BOTTOM,
+  TOOLBOX_AT_LEFT,
+  TOOLBOX_AT_RIGHT,
+  TOOLBOX_AT_TOP,
+  TabNavigateCursor,
+  Theme,
+  ThemeManager,
+  Themes,
+  Toolbox,
+  ToolboxCategory,
+  ToolboxItem,
+  ToolboxSeparator,
+  Tooltip,
+  Touch,
+  Trashcan,
+  UnattachedFieldError,
+  VARIABLE_CATEGORY_NAME,
+  VARIABLE_DYNAMIC_CATEGORY_NAME,
+  VERSION,
+  VariableMap,
+  VariableModel,
+  Variables,
+  VariablesDynamic,
+  VerticalFlyout,
+  WidgetDiv,
+  Workspace,
+  WorkspaceAudio,
+  WorkspaceDragger,
+  WorkspaceSvg,
+  Xml,
+  ZoomControls,
+  blockAnimations,
+  blockRendering,
+  browserEvents,
+  bubbles,
+  bumpObjects,
+  clipboard,
+  comments,
+  common,
+  config,
+  constants,
+  defineBlocksWithJsonArray,
+  dialog,
+  dragging,
+  fieldRegistry,
+  geras,
+  getMainWorkspace,
+  getSelected,
+  hasBubble,
+  hideChaff,
+  icons,
+  inject,
+  inputs,
+  isCopyable,
+  isDeletable,
+  isDraggable,
+  isIcon,
+  isObservable,
+  isPaster,
+  isRenderedElement,
+  isSelectable,
+  isSerializable,
+  isVariableBackedParameterModel,
+  procedures,
+  registry,
+  renderManagement,
+  serialization,
+  setLocale,
+  setParentContainer,
+  svgResize,
+  thrasos,
+  uiPosition,
+  utils,
+  zelos,
+} = Blockly;

package/javascript.js

@@ -0,0 +1,4 @@
+// Shim for backwards-compatibility with bundlers that do not
+// support the 'exports' clause in package.json, to allow them
+// to load the blockly/javascript submodule entrypoint.
+module.exports = require('./javascript_compressed.js');

package/javascript.mjs

@@ -0,0 +1,6 @@
+import javascript from './javascript_compressed.js';
+export const {
+  JavascriptGenerator,
+  Order,
+  javascriptGenerator,
+} = javascript;

package/lua.js

@@ -0,0 +1,4 @@
+// Shim for backwards-compatibility with bundlers that do not
+// support the 'exports' clause in package.json, to allow them
+// to load the blockly/lua submodule entrypoint.
+module.exports = require('./lua_compressed.js');

package/lua.mjs

@@ -0,0 +1,6 @@
+import lua from './lua_compressed.js';
+export const {
+  LuaGenerator,
+  Order,
+  luaGenerator,
+} = lua;

package/media/resize-handle.svg

@@ -1,3 +1,3 @@
 <svg xmlns="http://www.w3.org/2000/svg" height="8" viewBox="0 0 8 8" width="8" fill="#041E49" stroke="#000">
-<g><line x1="2.6666666666666665" y1="7" x2="7" y2="2.6666666666666665"></line><line x1="5.333333333333333" y1="7" x2="7" y2="5.333333333333333"></line></g>
+<g><line x1="2.67" y1="7" x2="7" y2="2.67"></line><line x1="5.33" y1="7" x2="7" y2="5.33"></line></g>
 </svg>

package/msg/ab.js

@@ -103,6 +103,7 @@ Blockly.Msg["LISTS_GET_INDEX_FROM_END"] = "№ анҵәамнҭа аҟынтәи
 Blockly.Msg["LISTS_GET_INDEX_FROM_START"] = "#";  // untranslated
 Blockly.Msg["LISTS_GET_INDEX_GET"] = "игатәуп";
 Blockly.Msg["LISTS_GET_INDEX_GET_REMOVE"] = "иалхны ианыхтәуп";
+Blockly.Msg["LISTS_GET_INDEX_HELPURL"] = "https://github.com/google/blockly/wiki/Lists#getting-items-from-a-list";  // untranslated
 Blockly.Msg["LISTS_GET_INDEX_LAST"] = "аҵыхәтәантәи";
 Blockly.Msg["LISTS_GET_INDEX_RANDOM"] = "иарбанзаалакь";
 Blockly.Msg["LISTS_GET_INDEX_REMOVE"] = "ианыхтәуп";
@@ -131,7 +132,7 @@ Blockly.Msg["LISTS_GET_SUBLIST_TOOLTIP"] = "Creates a copy of the specified port
 Blockly.Msg["LISTS_INDEX_FROM_END_TOOLTIP"] = "%1 - аҵыхәтәантәи аелемент.";
 Blockly.Msg["LISTS_INDEX_FROM_START_TOOLTIP"] = "%1 - актәи аелемент.";
 Blockly.Msg["LISTS_INDEX_OF_FIRST"] = "find first occurrence of item";  // untranslated
-Blockly.Msg["LISTS_INDEX_OF_HELPURL"] = "https://github.com/google/blockly/wiki/Lists#getting-items-from-a-list";  // untranslated
+Blockly.Msg["LISTS_INDEX_OF_HELPURL"] = "https://github.com/google/blockly/wiki/Lists#finding-items-in-a-list";  // untranslated
 Blockly.Msg["LISTS_INDEX_OF_LAST"] = "find last occurrence of item";  // untranslated
 Blockly.Msg["LISTS_INDEX_OF_TOOLTIP"] = "Returns the index of the first/last occurrence of the item in the list. Returns %1 if item is not found.";  // untranslated
 Blockly.Msg["LISTS_INLIST"] = "ахьӡынҵа аҟны";
@@ -300,6 +301,7 @@ Blockly.Msg["PROCEDURES_CALLNORETURN_TOOLTIP"] = "Run the user-defined function
 Blockly.Msg["PROCEDURES_CALLRETURN_HELPURL"] = "https://ru.wikipedia.org/wiki/Ацхыраагӡатә программа";
 Blockly.Msg["PROCEDURES_CALLRETURN_TOOLTIP"] = "Run the user-defined function '%1' and use its output.";  // untranslated
 Blockly.Msg["PROCEDURES_CALL_BEFORE_PARAMS"] = "аҟынтәи:";
+Blockly.Msg["PROCEDURES_CALL_DISABLED_DEF_WARNING"] = "Can't run the user-defined function '%1' because the definition block is disabled.";  // untranslated
 Blockly.Msg["PROCEDURES_CREATE_DO"] = "Иаԥҵатәуп ааԥхьара '%1'";
 Blockly.Msg["PROCEDURES_DEFNORETURN_COMMENT"] = "Абри афункциа ахҳәа азыҟашәҵа...";
 Blockly.Msg["PROCEDURES_DEFNORETURN_DO"] = "";  // untranslated
@@ -415,7 +417,6 @@ Blockly.Msg["CONTROLS_IF_IF_TITLE_IF"] = Blockly.Msg["CONTROLS_IF_MSG_IF"];
 Blockly.Msg["CONTROLS_IF_MSG_THEN"] = Blockly.Msg["CONTROLS_REPEAT_INPUT_DO"];
 Blockly.Msg["CONTROLS_WHILEUNTIL_INPUT_DO"] = Blockly.Msg["CONTROLS_REPEAT_INPUT_DO"];
 Blockly.Msg["LISTS_CREATE_WITH_ITEM_TITLE"] = Blockly.Msg["VARIABLES_DEFAULT_NAME"];
-Blockly.Msg["LISTS_GET_INDEX_HELPURL"] = Blockly.Msg["LISTS_INDEX_OF_HELPURL"];
 Blockly.Msg["LISTS_GET_INDEX_INPUT_IN_LIST"] = Blockly.Msg["LISTS_INLIST"];
 Blockly.Msg["LISTS_GET_SUBLIST_INPUT_IN_LIST"] = Blockly.Msg["LISTS_INLIST"];
 Blockly.Msg["LISTS_INDEX_OF_INPUT_IN_LIST"] = Blockly.Msg["LISTS_INLIST"];
@@ -428,14 +429,14 @@ Blockly.Msg["PROCEDURES_DEFRETURN_TITLE"] = Blockly.Msg["PROCEDURES_DEFNORETURN_
 Blockly.Msg["TEXT_APPEND_VARIABLE"] = Blockly.Msg["VARIABLES_DEFAULT_NAME"];
 Blockly.Msg["TEXT_CREATE_JOIN_ITEM_TITLE_ITEM"] = Blockly.Msg["VARIABLES_DEFAULT_NAME"];
 
-Blockly.Msg["MATH_HUE"] = "230";
-Blockly.Msg["LOOPS_HUE"] = "120";
+Blockly.Msg["COLOUR_HUE"] = "20";
 Blockly.Msg["LISTS_HUE"] = "260";
 Blockly.Msg["LOGIC_HUE"] = "210";
-Blockly.Msg["VARIABLES_HUE"] = "330";
-Blockly.Msg["TEXTS_HUE"] = "160";
+Blockly.Msg["LOOPS_HUE"] = "120";
+Blockly.Msg["MATH_HUE"] = "230";
 Blockly.Msg["PROCEDURES_HUE"] = "290";
-Blockly.Msg["COLOUR_HUE"] = "20";
+Blockly.Msg["TEXTS_HUE"] = "160";
 Blockly.Msg["VARIABLES_DYNAMIC_HUE"] = "310";
+Blockly.Msg["VARIABLES_HUE"] = "330";
 return Blockly.Msg;
 }));