fix: re-add @package annotations as @internal annotations (#6232)

* fix: add ~70% of internal attributes

* fix: work on manually adding more @internal annotations

* fix: add more manual internal annotations

* fix: rename package typos to internal

* fix: final manual fixes for internal annotations

* chore: format

* chore: make unnecessary multiline jsdoc a single line

* fix: fix internal tags in serialization exceptions

core/block.ts

@@ -85,7 +85,10 @@ export class Block implements IASTNodeLocation, IDeletable {
    */
   data: string|null = null;
 
-  /** Has this block been disposed of? */
+  /**
+   * Has this block been disposed of?
+   * @internal
+   */
   disposed = false;
 
   /**
@@ -193,6 +196,7 @@ export class Block implements IASTNodeLocation, IDeletable {
    * @deprecated August 2019. Use getCommentText instead.
    */
   comment: string|Comment|null = null;
+  /** @internal */
   commentModel: CommentModel;
   private readonly xy_: Coordinate;
   isInFlyout: boolean;
@@ -217,7 +221,10 @@ export class Block implements IASTNodeLocation, IDeletable {
   /** A bound callback function to use when the parent workspace changes. */
   private onchangeWrapper_: ((p1: Abstract) => AnyDuringMigration)|null = null;
 
-  /** A count of statement inputs on the block. */
+  /**
+   * A count of statement inputs on the block.
+   * @internal
+   */
   statementInputCount = 0;
   // TODO(b/109816955): remove '!', see go/strict-prop-init-fix.
   type!: string;
@@ -493,6 +500,7 @@ export class Block implements IASTNodeLocation, IDeletable {
    * Returns all connections originating from this block.
    * @param _all If true, return all connections even hidden ones.
    * @return Array of connections.
+   * @internal
    */
   getConnections_(_all: boolean): Connection[] {
     const myConnections = [];
@@ -520,6 +528,7 @@ export class Block implements IASTNodeLocation, IDeletable {
    *     be returned. If false, this will follow shadows to find the last
    *     connection.
    * @return The last next connection on the stack, or null.
+   * @internal
    */
   lastConnectionInStack(ignoreShadows: boolean): Connection|null {
     let nextConnection = this.nextConnection;
@@ -609,6 +618,7 @@ export class Block implements IASTNodeLocation, IDeletable {
    * Return the connection on the first statement input on this block, or null
    * if there are none.
    * @return The first statement connection or null.
+   * @internal
    */
   getFirstStatementConnection(): Connection|null {
     for (let i = 0, input; input = this.inputList[i]; i++) {
@@ -640,6 +650,7 @@ export class Block implements IASTNodeLocation, IDeletable {
    * the top block of the sub stack. If we are nested in a statement input only
    * find the top-most nested block. Do not go all the way to the root block.
    * @return The top block in a stack.
+   * @internal
    */
   getTopStackBlock(): this {
     let block = this;
@@ -684,6 +695,7 @@ export class Block implements IASTNodeLocation, IDeletable {
   /**
    * Set parent of this block to be a new block or null.
    * @param newParent New parent block.
+   * @internal
    */
   setParent(newParent: this|null) {
     if (newParent === this.parentBlock_) {
@@ -809,6 +821,7 @@ export class Block implements IASTNodeLocation, IDeletable {
   /**
    * Set whether this block is a shadow block or not.
    * @param shadow True if a shadow.
+   * @internal
    */
   setShadow(shadow: boolean) {
     this.isShadow_ = shadow;
@@ -826,6 +839,7 @@ export class Block implements IASTNodeLocation, IDeletable {
    * Set whether this block is an insertion marker block or not.
    * Once set this cannot be unset.
    * @param insertionMarker True if an insertion marker.
+   * @internal
    */
   setInsertionMarker(insertionMarker: boolean) {
     this.isInsertionMarker_ = insertionMarker;
@@ -868,6 +882,7 @@ export class Block implements IASTNodeLocation, IDeletable {
    * @param otherBlock The other block to match against.
    * @param conn The other connection to match.
    * @return The matching connection on this block, or null.
+   * @internal
    */
   getMatchingConnection(otherBlock: Block, conn: Connection): Connection|null {
     const connections = this.getConnections_(true);
@@ -1015,6 +1030,7 @@ export class Block implements IASTNodeLocation, IDeletable {
   /**
    * Return all variables referenced by this block.
    * @return List of variable models.
+   * @internal
    */
   getVarModels(): VariableModel[] {
     const vars = [];
@@ -1038,6 +1054,7 @@ export class Block implements IASTNodeLocation, IDeletable {
    * Notification that a variable is renaming but keeping the same ID.  If the
    * variable is in use on this block, rerender to show the new name.
    * @param variable The variable being renamed.
+   * @internal
    */
   updateVarName(variable: VariableModel) {
     for (let i = 0, input; input = this.inputList[i]; i++) {

core/block_animations.ts

@@ -40,6 +40,7 @@ let disconnectGroup: Element = null as AnyDuringMigration;
  * Play some UI effects (sound, animation) when disposing of a block.
  * @param block The block being disposed of.
  * @alias Blockly.blockAnimations.disposeUiEffect
+ * @internal
  */
 export function disposeUiEffect(block: BlockSvg) {
   const workspace = block.workspace;
@@ -97,6 +98,7 @@ function disposeUiStep(
  * Play some UI effects (sound, ripple) after a connection has been established.
  * @param block The block being connected.
  * @alias Blockly.blockAnimations.connectionUiEffect
+ * @internal
  */
 export function connectionUiEffect(block: BlockSvg) {
   const workspace = block.workspace;
@@ -154,6 +156,7 @@ function connectionUiStep(ripple: SVGElement, start: Date, scale: number) {
  * Play some UI effects (sound, animation) when disconnecting a block.
  * @param block The block being disconnected.
  * @alias Blockly.blockAnimations.disconnectUiEffect
+ * @internal
  */
 export function disconnectUiEffect(block: BlockSvg) {
   block.workspace.getAudioManager().play('disconnect');
@@ -206,6 +209,7 @@ function disconnectUiStep(group: SVGElement, magnitude: number, start: Date) {
 /**
  * Stop the disconnect UI animation immediately.
  * @alias Blockly.blockAnimations.disconnectUiStop
+ * @internal
  */
 export function disconnectUiStop() {
   if (disconnectGroup) {

core/block_dragger.ts

@@ -80,7 +80,10 @@ export class BlockDragger implements IBlockDragger {
     this.dragIconData_ = initIconData(block);
   }
 
-  /** Sever all links from this object. */
+  /**
+   * Sever all links from this object.
+   * @internal
+   */
   dispose() {
     this.dragIconData_.length = 0;
 

core/block_svg.ts

@@ -109,6 +109,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
 
   /**
    * An property used internally to reference the block's rendering debugger.
+   * @internal
    */
   renderingDebugger: BlockRenderingDebug|null = null;
 
@@ -144,6 +145,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
   // Create core elements for the block.
   private svgGroup_: SVGGElement;
   style: BlockStyle;
+  /** @internal */
   pathObject: IPathObject;
   override rendered = false;
 
@@ -342,6 +344,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
   /**
    * Sets the parent of this block to be a new block or null.
    * @param newParent New parent block.
+   * @internal
    */
   override setParent(newParent: this|null) {
     const oldParent = this.parentBlock_;
@@ -458,6 +461,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
    * Move this block to its workspace's drag surface, accounting for
    * positioning. Generally should be called at the same time as
    * setDragging_(true). Does nothing if useDragSurface_ is false.
+   * @internal
    */
   moveToDragSurface() {
     if (!this.useDragSurface_) {
@@ -492,6 +496,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
    * Does nothing if useDragSurface_ is false.
    * @param newXY The position the block should take on on the workspace canvas,
    *     in workspace coordinates.
+   * @internal
    */
   moveOffDragSurface(newXY: Coordinate) {
     if (!this.useDragSurface_) {
@@ -508,6 +513,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
    * drag surface to translate blocks.
    * This block must be a top-level block.
    * @param newLoc The location to translate to, in workspace coordinates.
+   * @internal
    */
   moveDuringDrag(newLoc: Coordinate) {
     if (this.useDragSurface_) {
@@ -696,7 +702,10 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
     }
   }
 
-  /** Load the block's help page in a new window. */
+  /**
+   * Load the block's help page in a new window.
+   * @internal
+   */
   showHelp() {
     const url =
         typeof this.helpUrl === 'function' ? this.helpUrl() : this.helpUrl;
@@ -731,6 +740,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
   /**
    * Show the context menu for this block.
    * @param e Mouse event.
+   * @internal
    */
   showContextMenu(e: Event) {
     const menuOptions = this.generateContextMenu();
@@ -748,6 +758,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
    * Also update any attached bubbles.
    * @param dx Horizontal offset from current location, in workspace units.
    * @param dy Vertical offset from current location, in workspace units.
+   * @internal
    */
   moveConnections(dx: number, dy: number) {
     if (!this.rendered) {
@@ -774,6 +785,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
    * Recursively adds or removes the dragging class to this node and its
    * children.
    * @param adding True if adding, false if removing.
+   * @internal
    */
   setDragging(adding: boolean) {
     if (adding) {
@@ -816,6 +828,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
   /**
    * Sets whether this block is a shadow block or not.
    * @param shadow True if a shadow.
+   * @internal
    */
   override setShadow(shadow: boolean) {
     super.setShadow(shadow);
@@ -826,6 +839,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
    * Set whether this block is an insertion marker block or not.
    * Once set this cannot be unset.
    * @param insertionMarker True if an insertion marker.
+   * @internal
    */
   override setInsertionMarker(insertionMarker: boolean) {
     if (this.isInsertionMarker_ === insertionMarker) {
@@ -944,6 +958,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
   /**
    * Encode a block for copying.
    * @return Copy metadata, or null if the block is an insertion marker.
+   * @internal
    */
   toCopyData(): CopyData|null {
     if (this.isInsertionMarker_) {
@@ -962,7 +977,10 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
     };
   }
 
-  /** Updates the colour of the block to match the block's state. */
+  /**
+   * Updates the colour of the block to match the block's state.
+   * @internal
+   */
   applyColour() {
     this.pathObject.applyColour(this);
 
@@ -981,6 +999,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
   /**
    * Updates the color of the block (and children) to match the current disabled
    * state.
+   * @internal
    */
   updateDisabled() {
     const children = (this.getChildren(false));
@@ -1191,6 +1210,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
   /**
    * Update the cursor over this block by adding or removing a class.
    * @param enable True if the delete cursor should be shown, false otherwise.
+   * @internal
    */
   setDeleteStyle(enable: boolean) {
     this.pathObject.updateDraggingDelete(enable);
@@ -1254,6 +1274,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
    * <g> tags do not respect z-index so SVG renders them in the
    * order that they are in the DOM.  By placing this block first within the
    * block group's <g>, it will render on top of any other blocks.
+   * @internal
    */
   bringToFront() {
     let block = this;
@@ -1391,6 +1412,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
    * tracked_ value to false keeps it from adding itself to the db when it
    * gets its first moveTo call, saving expensive ops for later.
    * @param track If true, start tracking. If false, stop tracking.
+   * @internal
    */
   setConnectionTracking(track: boolean) {
     if (this.previousConnection) {
@@ -1434,6 +1456,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
    *     Otherwise, for a non-rendered block return an empty list, and for a
    * collapsed block don't return inputs connections.
    * @return Array of connections.
+   * @internal
    */
   override getConnections_(all: boolean): RenderedConnection[] {
     const myConnections = [];
@@ -1465,6 +1488,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
    *     be returned. If false, this will follow shadows to find the last
    *     connection.
    * @return The last next connection on the stack, or null.
+   * @internal
    */
   override lastConnectionInStack(ignoreShadows: boolean): RenderedConnection
       |null {
@@ -1478,6 +1502,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
    * @param otherBlock The other block to match against.
    * @param conn The other connection to match.
    * @return The matching connection on this block, or null.
+   * @internal
    */
   override getMatchingConnection(otherBlock: Block, conn: Connection):
       RenderedConnection|null {
@@ -1559,6 +1584,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
   /**
    * Schedule snapping to grid and bumping neighbours to occur after a brief
    * delay.
+   * @internal
    */
   scheduleSnapAndBump() {
     const block = this;
@@ -1585,6 +1611,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
    * @param sourceConnection The connection on the moving block's stack.
    * @param targetConnection The connection that should stay stationary as this
    *     block is positioned.
+   * @internal
    */
   positionNearConnection(
       sourceConnection: RenderedConnection,
@@ -1600,7 +1627,10 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
     }
   }
 
-  /** @return The first statement connection or null. */
+  /**
+   * @return The first statement connection or null.
+   * @internal
+   */
   override getFirstStatementConnection(): RenderedConnection|null {
     return super.getFirstStatementConnection() as RenderedConnection | null;
   }
@@ -1704,6 +1734,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
    * Add the cursor SVG to this block's SVG group.
    * @param cursorSvg The SVG root of the cursor to be added to the block SVG
    *     group.
+   * @internal
    */
   setCursorSvg(cursorSvg: SVGElement) {
     this.pathObject.setCursorSvg(cursorSvg);
@@ -1713,6 +1744,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
    * Add the marker SVG to this block's SVG group.
    * @param markerSvg The SVG root of the marker to be added to the block SVG
    *     group.
+   * @internal
    */
   setMarkerSvg(markerSvg: SVGElement) {
     this.pathObject.setMarkerSvg(markerSvg);
@@ -1722,6 +1754,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
    * Returns a bounding box describing the dimensions of this block
    * and any blocks stacked below it.
    * @return Object with height and width properties in workspace units.
+   * @internal
    */
   getHeightWidth(): {height: number, width: number} {
     let height = this.height;
@@ -1743,6 +1776,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
    * will be replaced.  If a shadow block, it will disappear.  Otherwise it will
    * bump.
    * @param add True if highlighting should be added.
+   * @internal
    */
   fadeForReplacement(add: boolean) {
     this.pathObject.updateReplacementFade(add);
@@ -1753,6 +1787,7 @@ export class BlockSvg extends Block implements IASTNodeLocationSvg,
    * to this input.
    * @param conn The connection on the input to highlight.
    * @param add True if highlighting should be added.
+   * @internal
    */
   highlightShapeForInput(conn: Connection, add: boolean) {
     this.pathObject.updateShapeForInputHighlight(conn, add);

core/bubble.ts

@@ -143,9 +143,10 @@ export class Bubble implements IBubble {
   /**
    * Describes whether this bubble has been disposed of (nodes and event
    * listeners removed from the page) or not.
+   * @internal
    */
   disposed = false;
-  arrow_radians_: AnyDuringMigration;
+  private arrow_radians_: AnyDuringMigration;
 
   /**
    * @param workspace The workspace on which to draw the bubble.
@@ -310,6 +311,7 @@ export class Bubble implements IBubble {
   /**
    * Show the context menu for this bubble.
    * @param _e Mouse event.
+   * @internal
    */
   showContextMenu(_e: Event) {}
   // NOP on bubbles, but used by the bubble dragger to pass events to
@@ -318,6 +320,7 @@ export class Bubble implements IBubble {
   /**
    * Get whether this bubble is deletable or not.
    * @return True if deletable.
+   * @internal
    */
   isDeletable(): boolean {
     return false;
@@ -394,6 +397,7 @@ export class Bubble implements IBubble {
   /**
    * Move this bubble to the top of the stack.
    * @return Whether or not the bubble has been moved.
+   * @internal
    */
   promote(): boolean {
     const svgGroup = this.bubbleGroup_.parentNode;
@@ -626,6 +630,7 @@ export class Bubble implements IBubble {
    * Move the bubble group to the specified location in workspace coordinates.
    * @param x The x position to move to.
    * @param y The y position to move to.
+   * @internal
    */
   moveTo(x: number, y: number) {
     this.bubbleGroup_.setAttribute(
@@ -635,6 +640,7 @@ export class Bubble implements IBubble {
   /**
    * Triggers a move callback if one exists at the end of a drag.
    * @param adding True if adding, false if removing.
+   * @internal
    */
   setDragging(adding: boolean) {
     if (!adding && this.moveCallback_) {
@@ -793,6 +799,7 @@ export class Bubble implements IBubble {
    * @param dragSurface The surface that carries rendered items during a drag,
    *     or null if no drag surface is in use.
    * @param newLoc The location to translate to, in workspace coordinates.
+   * @internal
    */
   moveDuringDrag(dragSurface: BlockDragSurfaceSvg, newLoc: Coordinate) {
     if (dragSurface) {
@@ -827,6 +834,7 @@ export class Bubble implements IBubble {
    * is shown it positions itself to not cover any blocks.  Once a user has
    * dragged it to reposition, it renders where the user put it.
    * @param enable True if auto-layout should be enabled, false otherwise.
+   * @internal
    */
   setAutoLayout(enable: boolean) {
     this.autoLayout_ = enable;
@@ -857,6 +865,7 @@ export class Bubble implements IBubble {
    * Create the text for a non editable bubble.
    * @param text The text to display.
    * @return The top-level node of the text.
+   * @internal
    */
   static textToDom(text: string): SVGTextElement {
     const paragraph = dom.createSvgElement(Svg.TEXT, {
@@ -879,6 +888,7 @@ export class Bubble implements IBubble {
    * @param block The block that the bubble is attached to.
    * @param iconXY The coordinate of the icon.
    * @return The non editable bubble.
+   * @internal
    */
   static createNonEditableBubble(
       paragraphElement: SVGTextElement, block: BlockSvg,

core/bubble_dragger.ts

@@ -80,6 +80,7 @@ export class BubbleDragger {
   /**
    * Sever all links from this object.
    * @suppress {checkTypes}
+   * @internal
    */
   dispose() {
     // AnyDuringMigration because:  Type 'null' is not assignable to type
@@ -95,6 +96,7 @@ export class BubbleDragger {
 
   /**
    * Start dragging a bubble.  This includes moving it to the drag surface.
+   * @internal
    */
   startBubbleDrag() {
     if (!eventUtils.getGroup()) {
@@ -116,6 +118,7 @@ export class BubbleDragger {
    * @param e The most recent move event.
    * @param currentDragDeltaXY How far the pointer has moved from the position
    *     at the start of the drag, in pixel units.
+   * @internal
    */
   dragBubble(e: Event, currentDragDeltaXY: Coordinate) {
     const delta = this.pixelsToWorkspaceUnits_(currentDragDeltaXY);
@@ -170,6 +173,7 @@ export class BubbleDragger {
    * @param e The mouseup/touchend event.
    * @param currentDragDeltaXY How far the pointer has moved from the position
    *     at the start of the drag, in pixel units.
+   * @internal
    */
   endBubbleDrag(e: Event, currentDragDeltaXY: Coordinate) {
     // Make sure internal state is fresh.

core/clipboard.ts

@@ -25,6 +25,7 @@ let copyData: CopyData|null = null;
  * Copy a block or workspace comment onto the local clipboard.
  * @param toCopy Block or Workspace Comment to be copied.
  * @alias Blockly.clipboard.copy
+ * @internal
  */
 export function copy(toCopy: ICopyable) {
   copyData = toCopy.toCopyData();
@@ -34,6 +35,7 @@ export function copy(toCopy: ICopyable) {
  * Paste a block or workspace comment on to the main workspace.
  * @return The pasted thing if the paste was successful, null otherwise.
  * @alias Blockly.clipboard.paste
+ * @internal
  */
 export function paste(): ICopyable|null {
   if (!copyData) {
@@ -58,6 +60,7 @@ export function paste(): ICopyable|null {
  * @return The block or workspace comment that was duplicated, or null if the
  *     duplication failed.
  * @alias Blockly.clipboard.duplicate
+ * @internal
  */
 export function duplicate(toDuplicate: ICopyable): ICopyable|null {
   const oldCopyData = copyData;

core/comment.ts

@@ -365,7 +365,10 @@ export class Comment extends Icon {
     }
   }
 
-  /** Update the comment's view to match the model. */
+  /**
+   * Update the comment's view to match the model.
+   * @internal
+   */
   updateText() {
     if (this.textarea_) {
       // AnyDuringMigration because:  Type 'string | null' is not assignable to

core/common.ts

@@ -77,6 +77,7 @@ export function getSelected(): ICopyable|null {
  * programmatically select a block, use `BlockSvg#select`.
  * @param newSelection The newly selected block.
  * @alias Blockly.common.setSelected
+ * @internal
  */
 export function setSelected(newSelection: ICopyable|null) {
   selected = newSelection;

core/connection.ts

@@ -53,7 +53,10 @@ export class Connection implements IASTNodeLocationWithBlock {
   /** Connection this connection connects to.  Null if not connected. */
   targetConnection: Connection|null = null;
 
-  /** Has this connection been disposed of? */
+  /**
+   * Has this connection been disposed of?
+   * @internal
+   */
   disposed = false;
 
   /** List of compatible value types.  Null if all types are compatible. */
@@ -65,10 +68,16 @@ export class Connection implements IASTNodeLocationWithBlock {
   // 'Element'.
   private shadowDom_: Element = null as AnyDuringMigration;
 
-  /** Horizontal location of this connection. */
+  /**
+   * Horizontal location of this connection.
+   * @internal
+   */
   x = 0;
 
-  /** Vertical location of this connection. */
+  /**
+   * Vertical location of this connection.
+   * @internal
+   */
   y = 0;
 
   private shadowState_: blocks.State|null = null;
@@ -137,7 +146,10 @@ export class Connection implements IASTNodeLocationWithBlock {
     }
   }
 
-  /** Dispose of this connection and deal with connected blocks. */
+  /**
+   * Dispose of this connection and deal with connected blocks.
+   * @internal
+   */
   dispose() {
     // isConnected returns true for shadows and non-shadows.
     if (this.isConnected()) {
@@ -183,6 +195,7 @@ export class Connection implements IASTNodeLocationWithBlock {
   /**
    * Get the workspace's connection type checker object.
    * @return The connection type checker for the source block's workspace.
+   * @internal
    */
   getConnectionChecker(): IConnectionChecker {
     return this.source.workspace.connectionChecker;
@@ -193,6 +206,7 @@ export class Connection implements IASTNodeLocationWithBlock {
    * headless workspaces).
    * @param _otherConnection Connection that this connection failed to connect
    *     to.
+   * @internal
    */
   onFailedConnect(_otherConnection: Connection) {}
   // NOP
@@ -411,6 +425,7 @@ export class Connection implements IASTNodeLocationWithBlock {
    * computed from the rendered positioning.
    * @param _maxLimit The maximum radius to another connection.
    * @return List of connections.
+   * @internal
    */
   neighbours(_maxLimit: number): Connection[] {
     return [];
@@ -420,6 +435,7 @@ export class Connection implements IASTNodeLocationWithBlock {
    * Get the parent input of a connection.
    * @return The input that the connection belongs to or null if no parent
    *     exists.
+   * @internal
    */
   getParentInput(): Input|null {
     let parentInput = null;

core/connection_db.ts

@@ -51,6 +51,7 @@ export class ConnectionDB {
    * Add a connection to the database. Should not already exist in the database.
    * @param connection The connection to be added.
    * @param yPos The y position used to decide where to insert the connection.
+   * @internal
    */
   addConnection(connection: RenderedConnection, yPos: number) {
     const index = this.calculateIndexForYPos_(yPos);

core/contextmenu.ts

@@ -260,6 +260,7 @@ export function callbackFactory(block: Block, xml: Element): Function {
  * @return A menu option,
  *     containing text, enabled, and a callback.
  * @alias Blockly.ContextMenu.commentDeleteOption
+ * @internal
  */
 export function commentDeleteOption(comment: WorkspaceCommentSvg):
     LegacyContextMenuOption {
@@ -282,6 +283,7 @@ export function commentDeleteOption(comment: WorkspaceCommentSvg):
  * @return A menu option,
  *     containing text, enabled, and a callback.
  * @alias Blockly.ContextMenu.commentDuplicateOption
+ * @internal
  */
 export function commentDuplicateOption(comment: WorkspaceCommentSvg):
     LegacyContextMenuOption {
@@ -304,6 +306,7 @@ export function commentDuplicateOption(comment: WorkspaceCommentSvg):
  * @suppress {strictModuleDepCheck,checkTypes} Suppress checks while workspace
  *     comments are not bundled in.
  * @alias Blockly.ContextMenu.workspaceCommentOption
+ * @internal
  */
 export function workspaceCommentOption(
     ws: WorkspaceSvg, e: Event): ContextMenuOption {

core/contextmenu_items.ts

@@ -576,6 +576,7 @@ function registerBlockOptions_() {
  * Registers all default context menu items. This should be called once per
  * instance of ContextMenuRegistry.
  * @alias Blockly.ContextMenuItems.registerDefaultOptions
+ * @internal
  */
 export function registerDefaultOptions() {
   registerWorkspaceOptions_();

core/dropdowndiv.ts

@@ -117,7 +117,10 @@ export interface PositionMetrics {
   arrowVisible: boolean;
 }
 
-/** Create and insert the DOM element for this div. */
+/**
+ * Create and insert the DOM element for this div.
+ * @internal
+ */
 export function createDom() {
   if (div) {
     return;
@@ -296,6 +299,7 @@ function showPositionedByRect(
  * @param secondaryY Secondary/alternative origin point y, in absolute px.
  * @param opt_onHide Optional callback for when the drop-down is hidden.
  * @return True if the menu rendered at the primary origin point.
+ * @internal
  */
 export function show(
     newOwner: AnyDuringMigration|null, rtl: boolean, primaryX: number,
@@ -490,6 +494,7 @@ function getPositionTopOfPageMetrics(
  * @param divWidth The width of the div in px.
  * @return An object containing metrics for the x positions of the left side of
  *     the DropDownDiv and the arrow.
+ * @internal
  */
 export function getPositionX(
     sourceX: number, boundsLeft: number, boundsRight: number,
@@ -656,6 +661,7 @@ function positionInternal(
 /**
  * Repositions the dropdownDiv on window resize. If it doesn't know how to
  * calculate the new position, it will just hide it instead.
+ * @internal
  */
 export function repositionForWindowResize() {
   // This condition mainly catches the dropdown div when it is being used as a

core/events/events_block_change.ts

@@ -161,6 +161,7 @@ export class BlockChange extends BlockBase {
    * depending on the block's definition).
    * @param block The block to get the extra state of.
    * @return A stringified version of the extra state of the given block.
+   * @internal
    */
   static getExtraBlockState_(block: BlockSvg): string {
     if (block.saveExtraState) {

core/events/utils.ts

@@ -431,6 +431,7 @@ export function setGroup(state: boolean|string) {
  * @param block The root block.
  * @return List of block IDs.
  * @alias Blockly.Events.utils.getDescendantIds
+ * @internal
  */
 export function getDescendantIds(block: Block): string[] {
   const ids = [];

core/extensions.ts

@@ -345,6 +345,7 @@ function mutatorPropertiesMatch(
  * Calls a function after the page has loaded, possibly immediately.
  * @param fn Function to run.
  * @throws Error Will throw if no global document can be found (e.g., Node.js).
+ * @internal
  */
 export function runAfterPageLoad(fn: () => AnyDuringMigration) {
   if (typeof document !== 'object') {

core/field.ts

@@ -148,7 +148,10 @@ export abstract class Field implements IASTNodeLocationSvg,
   // 'ConstantProvider'.
   protected constants_: ConstantProvider = null as AnyDuringMigration;
 
-  /** Has this field been disposed of? */
+  /**
+   * Has this field been disposed of?
+   * @internal
+   */
   disposed = false;
 
   /** Maximum characters of text to display before adding an ellipsis. */
@@ -174,10 +177,16 @@ export abstract class Field implements IASTNodeLocationSvg,
   // 'Element'.
   protected clickTarget_: Element = null as AnyDuringMigration;
 
-  /** The prefix field. */
+  /**
+   * The prefix field.
+   * @internal
+   */
   prefixField: string|null = null;
 
-  /** The suffix field. */
+  /**
+   * The suffix field.
+   * @internal
+   */
   suffixField: string|null = null;
 
   /**
@@ -286,6 +295,7 @@ export abstract class Field implements IASTNodeLocationSvg,
    * Initialize everything to render this field. Override
    * methods initModel and initView rather than this method.
    * @final
+   * @internal
    */
   init() {
     if (this.fieldGroup_) {
@@ -305,7 +315,10 @@ export abstract class Field implements IASTNodeLocationSvg,
     this.initModel();
   }
 
-  /** Create the block UI for this field. */
+  /**
+   * Create the block UI for this field.
+   * @internal
+   */
   initView() {
     this.createBorderRect_();
     this.createTextElement_();
@@ -314,6 +327,7 @@ export abstract class Field implements IASTNodeLocationSvg,
   /**
    * Initializes the model of the field after it has been installed on a block.
    * No-op by default.
+   * @internal
    */
   initModel() {}
 
@@ -368,6 +382,7 @@ export abstract class Field implements IASTNodeLocationSvg,
    * Sets the field's value based on the given XML element. Should only be
    * called by Blockly.Xml.
    * @param fieldElement The element containing info about the field's state.
+   * @internal
    */
   fromXml(fieldElement: Element) {
     this.setValue(fieldElement.textContent);
@@ -378,6 +393,7 @@ export abstract class Field implements IASTNodeLocationSvg,
    * @param fieldElement The element to populate with info about the field's
    *     state.
    * @return The element containing info about the field's state.
+   * @internal
    */
   toXml(fieldElement: Element): Element {
     fieldElement.textContent = this.getValue();
@@ -391,6 +407,7 @@ export abstract class Field implements IASTNodeLocationSvg,
    *     normally just saves a reference to some state (eg variable fields) it
    *     should instead serialize the full state of the thing being referenced.
    * @return JSON serializable state.
+   * @internal
    */
   saveState(_doFullSerialization?: boolean): AnyDuringMigration {
     const legacyState = this.saveLegacyState(Field);
@@ -404,6 +421,7 @@ export abstract class Field implements IASTNodeLocationSvg,
    * Sets the field's state based on the given state value. Should only be
    * called by the serialization system.
    * @param state The state we want to apply to the field.
+   * @internal
    */
   loadState(state: AnyDuringMigration) {
     if (this.loadLegacyState(Field, state)) {
@@ -456,6 +474,7 @@ export abstract class Field implements IASTNodeLocationSvg,
 
   /**
    * Dispose of all DOM objects and events belonging to this editable field.
+   * @internal
    */
   dispose() {
     dropDownDiv.hideIfOwner(this);
@@ -562,6 +581,7 @@ export abstract class Field implements IASTNodeLocationSvg,
    * Sets whether this editable field is visible or not. Should only be called
    * by input.setVisible.
    * @param visible True if visible.
+   * @internal
    */
   setVisible(visible: boolean) {
     if (this.visible_ === visible) {
@@ -613,6 +633,7 @@ export abstract class Field implements IASTNodeLocationSvg,
   /**
    * Updates the field to match the colour/style of the block. Should only be
    * called by BlockSvg.applyColour().
+   * @internal
    */
   applyColour() {}
   // Non-abstract sub-classes may wish to implement this. See FieldDropdown.
@@ -636,6 +657,7 @@ export abstract class Field implements IASTNodeLocationSvg,
    * @param opt_e Optional mouse event that triggered the field to open, or
    *     undefined if triggered programmatically.
    * @final
+   * @internal
    */
   showEditor(opt_e?: Event) {
     if (this.isClickable()) {
@@ -766,6 +788,7 @@ export abstract class Field implements IASTNodeLocationSvg,
    * scaling.
    * @return An object with top, bottom, left, and right in pixels relative to
    *     the top left corner of the page (window coordinates).
+   * @internal
    */
   getScaledBBox(): Rect {
     let scaledWidth;
@@ -860,6 +883,7 @@ export abstract class Field implements IASTNodeLocationSvg,
    * rerender this field and adjust for any sizing changes.
    * Other fields on the same block will not rerender, because their sizes have
    * already been recorded.
+   * @internal
    */
   markDirty() {
     this.isDirty_ = true;
@@ -873,6 +897,7 @@ export abstract class Field implements IASTNodeLocationSvg,
    * rerender this field and adjust for any sizing changes.
    * Other fields on the same block will not rerender, because their sizes have
    * already been recorded.
+   * @internal
    */
   forceRerender() {
     this.isDirty_ = true;
@@ -1075,6 +1100,7 @@ export abstract class Field implements IASTNodeLocationSvg,
    * to be handled differently during serialization and deserialization.
    * Subclasses may override this.
    * @return True if this field has any variable references.
+   * @internal
    */
   referencesVariables(): boolean {
     return false;
@@ -1083,6 +1109,7 @@ export abstract class Field implements IASTNodeLocationSvg,
   /**
    * Refresh the variable name referenced by this field if this field references
    * variables.
+   * @internal
    */
   refreshVariableName() {}
   // NOP
@@ -1091,6 +1118,7 @@ export abstract class Field implements IASTNodeLocationSvg,
    * Search through the list of inputs and their fields in order to find the
    * parent input of a field.
    * @return The input that the field belongs to.
+   * @internal
    */
   getParentInput(): Input {
     let parentInput = null;
@@ -1140,6 +1168,7 @@ export abstract class Field implements IASTNodeLocationSvg,
   /**
    * Add the cursor SVG to this fields SVG group.
    * @param cursorSvg The SVG root of the cursor to be added to the field group.
+   * @internal
    */
   setCursorSvg(cursorSvg: SVGElement) {
     if (!cursorSvg) {
@@ -1156,6 +1185,7 @@ export abstract class Field implements IASTNodeLocationSvg,
   /**
    * Add the marker SVG to this fields SVG group.
    * @param markerSvg The SVG root of the marker to be added to the field group.
+   * @internal
    */
   setMarkerSvg(markerSvg: SVGElement) {
     if (!markerSvg) {

core/field_angle.ts

@@ -212,7 +212,10 @@ export class FieldAngle extends FieldTextInput {
     }
   }
 
-  /** Create the block UI for this field. */
+  /**
+   * Create the block UI for this field.
+   * @internal
+   */
   override initView() {
     super.initView();
     // Add the degree symbol to the left of the number, even in RTL (issue
@@ -505,6 +508,7 @@ export class FieldAngle extends FieldTextInput {
    * @param options A JSON object with options (angle).
    * @return The new field instance.
    * @nocollapse
+   * @internal
    */
   static override fromJson(options: AnyDuringMigration): FieldAngle {
     // `this` might be a subclass of FieldAngle if that class doesn't override

core/field_checkbox.ts

@@ -100,6 +100,7 @@ export class FieldCheckbox extends Field {
   /**
    * Saves this field's value.
    * @return The boolean value held by this field.
+   * @internal
    */
   override saveState(): AnyDuringMigration {
     const legacyState = this.saveLegacyState(FieldCheckbox);
@@ -109,7 +110,10 @@ export class FieldCheckbox extends Field {
     return this.getValueBoolean();
   }
 
-  /** Create the block UI for this checkbox. */
+  /**
+   * Create the block UI for this checkbox.
+   * @internal
+   */
   override initView() {
     super.initView();
 
@@ -217,6 +221,7 @@ export class FieldCheckbox extends Field {
    * @param options A JSON object with options (checked).
    * @return The new field instance.
    * @nocollapse
+   * @internal
    */
   static fromJson(options: AnyDuringMigration): FieldCheckbox {
     // `this` might be a subclass of FieldCheckbox if that class doesn't

core/field_colour.ts

@@ -187,7 +187,10 @@ export class FieldColour extends Field {
     }
   }
 
-  /** Create the block UI for this colour field. */
+  /**
+   * Create the block UI for this colour field.
+   * @internal
+   */
   override initView() {
     this.size_ = new Size(
         this.getConstants()!.FIELD_COLOUR_DEFAULT_WIDTH,
@@ -569,6 +572,7 @@ export class FieldColour extends Field {
    * @param options A JSON object with options (colour).
    * @return The new field instance.
    * @nocollapse
+   * @internal
    */
   static fromJson(options: AnyDuringMigration): FieldColour {
     // `this` might be a subclass of FieldColour if that class doesn't override

core/field_dropdown.ts

@@ -88,11 +88,13 @@ export class FieldDropdown extends Field {
 
   /**
    * The prefix field label, of common words set after options are trimmed.
+   * @internal
    */
   override prefixField: string|null = null;
 
   /**
    * The suffix field label, of common words set after options are trimmed.
+   * @internal
    */
   override suffixField: string|null = null;
   // TODO(b/109816955): remove '!', see go/strict-prop-init-fix.
@@ -157,6 +159,7 @@ export class FieldDropdown extends Field {
    * Sets the field's value based on the given XML element. Should only be
    * called by Blockly.Xml.
    * @param fieldElement The element containing info about the field's state.
+   * @internal
    */
   override fromXml(fieldElement: Element) {
     if (this.isOptionListDynamic()) {
@@ -168,6 +171,7 @@ export class FieldDropdown extends Field {
   /**
    * Sets the field's value based on the given state.
    * @param state The state to apply to the dropdown field.
+   * @internal
    */
   override loadState(state: AnyDuringMigration) {
     if (this.loadLegacyState(FieldDropdown, state)) {
@@ -179,7 +183,10 @@ export class FieldDropdown extends Field {
     this.setValue(state);
   }
 
-  /** Create the block UI for this dropdown. */
+  /**
+   * Create the block UI for this dropdown.
+   * @internal
+   */
   override initView() {
     if (this.shouldAddBorderRect_()) {
       this.createBorderRect_();
@@ -481,7 +488,10 @@ export class FieldDropdown extends Field {
     }
   }
 
-  /** Updates the dropdown arrow to match the colour/style of the block. */
+  /**
+   * Updates the dropdown arrow to match the colour/style of the block.
+   * @internal
+   */
   override applyColour() {
     const style = (this.sourceBlock_ as BlockSvg).style;
     if (this.borderRect_) {
@@ -649,6 +659,7 @@ export class FieldDropdown extends Field {
    * @param options A JSON object with options (options).
    * @return The new field instance.
    * @nocollapse
+   * @internal
    */
   static fromJson(options: AnyDuringMigration): FieldDropdown {
     // `this` might be a subclass of FieldDropdown if that class doesn't

core/field_image.ts

@@ -143,7 +143,10 @@ export class FieldImage extends Field {
     this.altText_ = parsing.replaceMessageReferences(config['alt']) || '';
   }
 
-  /** Create the block UI for this image. */
+  /**
+   * Create the block UI for this image.
+   * @internal
+   */
   override initView() {
     this.imageElement_ = dom.createSvgElement(
         Svg.IMAGE, {
@@ -247,6 +250,7 @@ export class FieldImage extends Field {
    *     flipRtl).
    * @return The new field instance.
    * @nocollapse
+   * @internal
    */
   static fromJson(options: AnyDuringMigration): FieldImage {
     // `this` might be a subclass of FieldImage if that class doesn't override

core/field_label.ts

@@ -75,7 +75,10 @@ export class FieldLabel extends Field {
     this.class_ = config['class'];
   }
 
-  /** Create block UI for this label. */
+  /**
+   * Create block UI for this label.
+   * @internal
+   */
   override initView() {
     this.createTextElement_();
     if (this.class_) {
@@ -120,6 +123,7 @@ export class FieldLabel extends Field {
    * @param options A JSON object with options (text, and class).
    * @return The new field instance.
    * @nocollapse
+   * @internal
    */
   static fromJson(options: AnyDuringMigration): FieldLabel {
     const text = parsing.replaceMessageReferences(options['text']);

core/field_label_serializable.ts

@@ -62,6 +62,7 @@ export class FieldLabelSerializable extends FieldLabel {
    * @param options A JSON object with options (text, and class).
    * @return The new field instance.
    * @nocollapse
+   * @internal
    */
   static override fromJson(options: AnyDuringMigration):
       FieldLabelSerializable {

core/field_multilineinput.ts

@@ -94,6 +94,7 @@ export class FieldMultilineInput extends FieldTextInput {
    * @param fieldElement The element to populate with info about the field's
    *     state.
    * @return The element containing info about the field's state.
+   * @internal
    */
   override toXml(fieldElement: Element): Element {
     // Replace '\n' characters with HTML-escaped equivalent '&#10'. This is
@@ -109,6 +110,7 @@ export class FieldMultilineInput extends FieldTextInput {
    * Sets the field's value based on the given XML element. Should only be
    * called by Blockly.Xml.
    * @param fieldElement The element containing info about the field's state.
+   * @internal
    */
   override fromXml(fieldElement: Element) {
     this.setValue(fieldElement.textContent!.replace(/
/g, '\n'));
@@ -117,6 +119,7 @@ export class FieldMultilineInput extends FieldTextInput {
   /**
    * Saves this field's value.
    * @return The state of this field.
+   * @internal
    */
   override saveState(): AnyDuringMigration {
     const legacyState = this.saveLegacyState(FieldMultilineInput);
@@ -129,6 +132,7 @@ export class FieldMultilineInput extends FieldTextInput {
   /**
    * Sets the field's value based on the given state.
    * @param state The state of the variable to assign to this variable field.
+   * @internal
    */
   override loadState(state: AnyDuringMigration) {
     if (this.loadLegacyState(Field, state)) {
@@ -137,7 +141,10 @@ export class FieldMultilineInput extends FieldTextInput {
     this.setValue(state);
   }
 
-  /** Create the block UI for this field. */
+  /**
+   * Create the block UI for this field.
+   * @internal
+   */
   override initView() {
     this.createBorderRect_();
     this.textGroup_ = dom.createSvgElement(
@@ -416,6 +423,7 @@ export class FieldMultilineInput extends FieldTextInput {
    * @param options A JSON object with options (text, and spellcheck).
    * @return The new field instance.
    * @nocollapse
+   * @internal
    */
   static override fromJson(options: AnyDuringMigration): FieldMultilineInput {
     const text = parsing.replaceMessageReferences(options['text']);

core/field_number.ts

@@ -300,6 +300,7 @@ export class FieldNumber extends FieldTextInput {
    * @param options A JSON object with options (value, min, max, and precision).
    * @return The new field instance.
    * @nocollapse
+   * @internal
    */
   static override fromJson(options: AnyDuringMigration): FieldNumber {
     // `this` might be a subclass of FieldNumber if that class doesn't override

core/field_registry.ts

@@ -59,6 +59,7 @@ export function unregister(type: string) {
  * @return The new field instance or null if a field wasn't found with the given
  *     type name
  * @alias Blockly.fieldRegistry.fromJson
+ * @internal
  */
 export function fromJson(options: AnyDuringMigration): Field|null {
   const fieldObject =

core/field_textinput.ts

@@ -133,6 +133,7 @@ export class FieldTextInput extends Field {
     }
   }
 
+  /** @internal */
   override initView() {
     if (this.getConstants()!.FULL_BLOCK_FIELDS) {
       // Step one: figure out if this is the only field on this block.
@@ -215,7 +216,10 @@ export class FieldTextInput extends Field {
     }
   }
 
-  /** Updates text field to match the colour/style of the block. */
+  /**
+   * Updates text field to match the colour/style of the block.
+   * @internal
+   */
   override applyColour() {
     if (this.sourceBlock_ && this.getConstants()!.FULL_BLOCK_FIELDS) {
       if (this.borderRect_) {
@@ -564,6 +568,7 @@ export class FieldTextInput extends Field {
    * @param options A JSON object with options (text, and spellcheck).
    * @return The new field instance.
    * @nocollapse
+   * @internal
    */
   static fromJson(options: AnyDuringMigration): FieldTextInput {
     const text = parsing.replaceMessageReferences(options['text']);

core/field_variable.ts

@@ -136,6 +136,7 @@ export class FieldVariable extends FieldDropdown {
    * Initialize the model for this field if it has not already been initialized.
    * If the value has not been set to a variable by the first render, we make up
    * a variable rather than let the value be invalid.
+   * @internal
    */
   override initModel() {
     if (this.variable_) {
@@ -210,6 +211,7 @@ export class FieldVariable extends FieldDropdown {
    *     full state of the field being referenced (ie ID, name, and type) rather
    *     than just a reference to it (ie ID).
    * @return The state of the variable field.
+   * @internal
    */
   override saveState(doFullSerialization?: boolean): AnyDuringMigration {
     const legacyState = this.saveLegacyState(FieldVariable);
@@ -229,6 +231,7 @@ export class FieldVariable extends FieldDropdown {
   /**
    * Sets the field's value based on the given state.
    * @param state The state of the variable to assign to this variable field.
+   * @internal
    */
   override loadState(state: AnyDuringMigration) {
     if (this.loadLegacyState(FieldVariable, state)) {
@@ -274,6 +277,7 @@ export class FieldVariable extends FieldDropdown {
    * Not guaranteed to be in the variable map on the workspace (e.g. if accessed
    * after the variable has been deleted).
    * @return The selected variable, or null if none was selected.
+   * @internal
    */
   getVariable(): VariableModel|null {
     return this.variable_;
@@ -426,6 +430,7 @@ export class FieldVariable extends FieldDropdown {
    * Refreshes the name of the variable by grabbing the name of the model.
    * Used when a variable gets renamed, but the ID stays the same. Should only
    * be called by the block.
+   * @internal
    */
   override refreshVariableName() {
     this.forceRerender();
@@ -461,6 +466,7 @@ export class FieldVariable extends FieldDropdown {
    * Overrides referencesVariables(), indicating this field refers to a
    * variable.
    * @return True.
+   * @internal
    */
   override referencesVariables(): boolean {
     return true;
@@ -473,6 +479,7 @@ export class FieldVariable extends FieldDropdown {
    *     defaultType).
    * @return The new field instance.
    * @nocollapse
+   * @internal
    */
   static override fromJson(options: AnyDuringMigration): FieldVariable {
     const varName = parsing.replaceMessageReferences(options['variable']);

core/flyout_base.ts

@@ -130,6 +130,7 @@ export abstract class Flyout extends DeleteArea implements IFlyout {
   RTL: boolean;
   /**
    * Whether the flyout should be laid out horizontally or not.
+   * @internal
    */
   horizontalLayout: boolean = false;
   protected toolboxPosition_: number;
@@ -173,7 +174,8 @@ export abstract class Flyout extends DeleteArea implements IFlyout {
   protected readonly tabWidth_: number;
 
   /**
-   * The target workspace
+   * The target workspace.
+   * @internal
    */
   targetWorkspace!: WorkspaceSvg;
   /**
@@ -287,6 +289,7 @@ export abstract class Flyout extends DeleteArea implements IFlyout {
     /**
      * A map from blocks to the rects which are beneath them to act as input
      * targets.
+     * @internal
      */
     this.rectMap_ = new WeakMap();
 
@@ -440,6 +443,7 @@ export abstract class Flyout extends DeleteArea implements IFlyout {
   /**
    * Get the workspace inside the flyout.
    * @return The workspace inside the flyout.
+   * @internal
    */
   getWorkspace(): WorkspaceSvg {
     return this.workspace_;
@@ -932,6 +936,7 @@ export abstract class Flyout extends DeleteArea implements IFlyout {
    * @param block The block to copy from the flyout.
    * @return True if you can create a new instance of the block, false
    *    otherwise.
+   * @internal
    */
   isBlockCreatable(block: BlockSvg): boolean {
     return block.isEnabled();
@@ -942,6 +947,7 @@ export abstract class Flyout extends DeleteArea implements IFlyout {
    * @param originalBlock The block to copy from the flyout.
    * @return The newly created block.
    * @throws {Error} if something went wrong with deserialization.
+   * @internal
    */
   createBlock(originalBlock: BlockSvg): BlockSvg {
     let newBlock = null;
@@ -1087,6 +1093,7 @@ export abstract class Flyout extends DeleteArea implements IFlyout {
   /**
    * @return True if this flyout may be scrolled with a scrollbar or
    *     by dragging.
+   * @internal
    */
   isScrollable(): boolean {
     return this.workspace_.scrollbar ? this.workspace_.scrollbar.isVisible() :

core/flyout_button.ts

@@ -64,6 +64,7 @@ export class FlyoutButton {
    * @param targetWorkspace The flyout's target workspace.
    * @param json The JSON specifying the label/button.
    * @param isLabel Whether this button should be styled as a label.
+   * @internal
    */
   constructor(
       private readonly workspace: WorkspaceSvg,
@@ -208,6 +209,7 @@ export class FlyoutButton {
   /**
    * Location of the button.
    * @return x, y coordinates.
+   * @internal
    */
   getPosition(): Coordinate {
     return this.position_;

core/flyout_horizontal.ts

@@ -287,6 +287,7 @@ export class HorizontalFlyout extends Flyout {
    * @param currentDragDeltaXY How far the pointer has moved from the position
    *     at mouse down, in pixel units.
    * @return True if the drag is toward the workspace.
+   * @internal
    */
   override isDragTowardWorkspace(currentDragDeltaXY: Coordinate): boolean {
     const dx = currentDragDeltaXY.x;

core/flyout_vertical.ts

@@ -270,6 +270,7 @@ export class VerticalFlyout extends Flyout {
    * @param currentDragDeltaXY How far the pointer has moved from the position
    *     at mouse down, in pixel units.
    * @return True if the drag is toward the workspace.
+   * @internal
    */
   override isDragTowardWorkspace(currentDragDeltaXY: Coordinate): boolean {
     const dx = currentDragDeltaXY.x;

core/gesture.ts

@@ -192,7 +192,10 @@ export class Gesture {
     this.healStack_ = !internalConstants.DRAG_STACK;
   }
 
-  /** Sever all links from this object. */
+  /**
+   * Sever all links from this object.
+   * @internal
+   */
   dispose() {
     Touch.clearTouchIdentifier();
     Tooltip.unblock();
@@ -415,6 +418,7 @@ export class Gesture {
    * Start a gesture: update the workspace to indicate that a gesture is in
    * progress and bind mousemove and mouseup handlers.
    * @param e A mouse down or touch start event.
+   * @internal
    */
   doStart(e: Event) {
     if (browserEvents.isTargetInput(e)) {
@@ -474,6 +478,7 @@ export class Gesture {
   /**
    * Bind gesture events.
    * @param e A mouse down or touch start event.
+   * @internal
    */
   bindMouseEvents(e: Event) {
     this.onMoveWrapper_ = browserEvents.conditionalBind(
@@ -488,6 +493,7 @@ export class Gesture {
   /**
    * Handle a mouse move or touch move event.
    * @param e A mouse move or touch move event.
+   * @internal
    */
   handleMove(e: Event) {
     this.updateFromEvent_(e);
@@ -505,6 +511,7 @@ export class Gesture {
   /**
    * Handle a mouse up or touch end event.
    * @param e A mouse up or touch end event.
+   * @internal
    */
   handleUp(e: Event) {
     this.updateFromEvent_(e);
@@ -546,6 +553,7 @@ export class Gesture {
   /**
    * Cancel an in-progress gesture.  If a workspace or block drag is in
    * progress, end the drag at the most recent location.
+   * @internal
    */
   cancel() {
     // Disposing of a block cancels in-progress drags, but dragging to a delete
@@ -568,6 +576,7 @@ export class Gesture {
   /**
    * Handle a real or faked right-click event by showing a context menu.
    * @param e A mouse move or touch move event.
+   * @internal
    */
   handleRightClick(e: Event) {
     if (this.targetBlock_) {
@@ -592,6 +601,7 @@ export class Gesture {
    * Handle a mousedown/touchstart event on a workspace.
    * @param e A mouse down or touch start event.
    * @param ws The workspace the event hit.
+   * @internal
    */
   handleWsStart(e: Event, ws: WorkspaceSvg) {
     if (this.hasStarted_) {
@@ -617,6 +627,7 @@ export class Gesture {
    * Handle a mousedown/touchstart event on a flyout.
    * @param e A mouse down or touch start event.
    * @param flyout The flyout the event hit.
+   * @internal
    */
   handleFlyoutStart(e: Event, flyout: IFlyout) {
     if (this.hasStarted_) {
@@ -632,6 +643,7 @@ export class Gesture {
    * Handle a mousedown/touchstart event on a block.
    * @param e A mouse down or touch start event.
    * @param block The block the event hit.
+   * @internal
    */
   handleBlockStart(e: Event, block: BlockSvg) {
     if (this.hasStarted_) {
@@ -647,6 +659,7 @@ export class Gesture {
    * Handle a mousedown/touchstart event on a bubble.
    * @param e A mouse down or touch start event.
    * @param bubble The bubble the event hit.
+   * @internal
    */
   handleBubbleStart(e: Event, bubble: IBubble) {
     if (this.hasStarted_) {
@@ -732,6 +745,7 @@ export class Gesture {
   /**
    * Record the field that a gesture started on.
    * @param field The field the gesture started on.
+   * @internal
    */
   setStartField(field: Field) {
     if (this.hasStarted_) {
@@ -747,6 +761,7 @@ export class Gesture {
   /**
    * Record the bubble that a gesture started on
    * @param bubble The bubble the gesture started on.
+   * @internal
    */
   setStartBubble(bubble: IBubble) {
     if (!this.startBubble_) {
@@ -758,6 +773,7 @@ export class Gesture {
    * Record the block that a gesture started on, and set the target block
    * appropriately.
    * @param block The block the gesture started on.
+   * @internal
    */
   setStartBlock(block: BlockSvg) {
     // If the gesture already went through a bubble, don't set the start block.
@@ -866,6 +882,7 @@ export class Gesture {
    * This function is called externally to block actions that cannot be taken
    * mid-drag (e.g. using the keyboard to delete the selected blocks).
    * @return True if this gesture is a drag of a workspace or block.
+   * @internal
    */
   isDragging(): boolean {
     return this.isDraggingWorkspace_ || this.isDraggingBlock_ ||
@@ -877,6 +894,7 @@ export class Gesture {
    * has a corresponding mouse up, but in reality it is possible to lose a
    * mouse up, leaving an in-process gesture hanging.
    * @return Whether this gesture was a click on a workspace.
+   * @internal
    */
   hasStarted(): boolean {
     return this.hasStarted_;
@@ -886,6 +904,7 @@ export class Gesture {
    * Get a list of the insertion markers that currently exist.  Block drags have
    * 0, 1, or 2 insertion markers.
    * @return A possibly empty list of insertion marker blocks.
+   * @internal
    */
   getInsertionMarkers(): BlockSvg[] {
     if (this.blockDragger_) {

core/grid.ts

@@ -64,6 +64,7 @@ export class Grid {
   /**
    * Dispose of this grid and unlink from the DOM.
    * @suppress {checkTypes}
+   * @internal
    */
   dispose() {
     // AnyDuringMigration because:  Type 'null' is not assignable to type
@@ -74,6 +75,7 @@ export class Grid {
   /**
    * Whether blocks should snap to the grid, based on the initial configuration.
    * @return True if blocks should snap, false otherwise.
+   * @internal
    */
   shouldSnap(): boolean {
     return this.snapToGrid_;
@@ -82,6 +84,7 @@ export class Grid {
   /**
    * Get the spacing of the grid points (in px).
    * @return The spacing of the grid points.
+   * @internal
    */
   getSpacing(): number {
     return this.spacing_;
@@ -91,6 +94,7 @@ export class Grid {
    * Get the ID of the pattern element, which should be randomized to avoid
    * conflicts with other Blockly instances on the page.
    * @return The pattern ID.
+   * @internal
    */
   getPatternId(): string {
     return this.pattern.id;
@@ -99,6 +103,7 @@ export class Grid {
   /**
    * Update the grid with a new scale.
    * @param scale The new workspace scale.
+   * @internal
    */
   update(scale: number) {
     this.scale_ = scale;
@@ -161,6 +166,7 @@ export class Grid {
    * visible.
    * @param x The new x position of the grid (in px).
    * @param y The new y position of the grid (in px).
+   * @internal
    */
   moveTo(x: number, y: number) {
     // AnyDuringMigration because:  Argument of type 'number' is not assignable
@@ -183,6 +189,7 @@ export class Grid {
    * @param gridOptions The object containing grid configuration.
    * @param defs The root SVG element for this workspace's defs.
    * @return The SVG element for the grid pattern.
+   * @internal
    */
   static createDom(
       rnd: string, gridOptions: AnyDuringMigration,

core/input.ts

@@ -181,6 +181,7 @@ export class Input {
    * Should only be used to collapse/uncollapse a block.
    * @param visible True if visible.
    * @return List of blocks to render.
+   * @internal
    */
   setVisible(visible: boolean): BlockSvg[] {
     // Note: Currently there are only unit tests for block.setCollapsed()
@@ -211,7 +212,10 @@ export class Input {
     return renderList;
   }
 
-  /** Mark all fields on this input as dirty. */
+  /**
+   * Mark all fields on this input as dirty.
+   * @internal
+   */
   markDirty() {
     for (let y = 0, field; field = this.fieldRow[y]; y++) {
       field.markDirty();

core/insertion_marker_manager.ts

@@ -167,7 +167,10 @@ export class InsertionMarkerManager {
     this.availableConnections_ = this.initAvailableConnections_();
   }
 
-  /** Sever all links from this object. */
+  /**
+   * Sever all links from this object.
+   * @internal
+   */
   dispose() {
     this.availableConnections_.length = 0;
 
@@ -187,6 +190,7 @@ export class InsertionMarkerManager {
   /**
    * Update the available connections for the top block. These connections can
    * change if a block is unplugged and the stack is healed.
+   * @internal
    */
   updateAvailableConnections() {
     this.availableConnections_ = this.initAvailableConnections_();
@@ -196,6 +200,7 @@ export class InsertionMarkerManager {
    * Return whether the block would be deleted if dropped immediately, based on
    * information from the most recent move event.
    * @return True if the block would be deleted if dropped immediately.
+   * @internal
    */
   wouldDeleteBlock(): boolean {
     return this.wouldDeleteBlock_;
@@ -205,6 +210,7 @@ export class InsertionMarkerManager {
    * Return whether the block would be connected if dropped immediately, based
    * on information from the most recent move event.
    * @return True if the block would be connected if dropped immediately.
+   * @internal
    */
   wouldConnectBlock(): boolean {
     return !!this.closestConnection_;
@@ -213,6 +219,7 @@ export class InsertionMarkerManager {
   /**
    * Connect to the closest connection and render the results.
    * This should be called at the end of a drag.
+   * @internal
    */
   applyConnections() {
     if (this.closestConnection_) {
@@ -243,6 +250,7 @@ export class InsertionMarkerManager {
    * Update connections based on the most recent move location.
    * @param dxy Position relative to drag start, in workspace units.
    * @param dragTarget The drag target that the block is currently over.
+   * @internal
    */
   update(dxy: Coordinate, dragTarget: IDragTarget|null) {
     const candidate = this.getCandidate_(dxy);
@@ -769,6 +777,7 @@ export class InsertionMarkerManager {
    * Get a list of the insertion markers that currently exist.  Drags have 0, 1,
    * or 2 insertion markers.
    * @return A possibly empty list of insertion marker blocks.
+   * @internal
    */
   getInsertionMarkers(): BlockSvg[] {
     const result = [];

core/interfaces/i_copyable.ts

@@ -27,6 +27,7 @@ export interface ICopyable extends ISelectable {
   /**
    * Encode for copying.
    * @return Copy metadata.
+   * @internal
    */
   toCopyData: AnyDuringMigration;
 }

core/interfaces/i_metrics_manager.ts

@@ -34,6 +34,7 @@ export interface IMetricsManager {
   /**
    * Returns whether the scroll area has fixed edges.
    * @return Whether the scroll area has fixed edges.
+   * @internal
    */
   hasFixedEdges: AnyDuringMigration;
 

core/interfaces/i_toolbox_item.ts

@@ -50,6 +50,7 @@ export interface IToolboxItem {
   /**
    * Gets the nested level of the category.
    * @return The nested level of the category.
+   * @internal
    */
   getLevel(): number;
 

core/internal_constants.ts

@@ -23,6 +23,7 @@ import {ConnectionType} from './connection_type.js';
 /**
  * Number of characters to truncate a collapsed block to.
  * @alias Blockly.internalConstants.COLLAPSE_CHARS
+ * @internal
  */
 export const COLLAPSE_CHARS = 30;
 
@@ -30,12 +31,14 @@ export const COLLAPSE_CHARS = 30;
  * When dragging a block out of a stack, split the stack in two (true), or drag
  * out the block healing the stack (false).
  * @alias Blockly.internalConstants.DRAG_STACK
+ * @internal
  */
 export const DRAG_STACK = true;
 
 /**
  * Lookup table for determining the opposite type of a connection.
  * @alias Blockly.internalConstants.OPPOSITE_TYPE
+ * @internal
  */
 export const OPPOSITE_TYPE: number[] = [];
 OPPOSITE_TYPE[ConnectionType.INPUT_VALUE] = ConnectionType.OUTPUT_VALUE;
@@ -50,6 +53,7 @@ OPPOSITE_TYPE[ConnectionType.PREVIOUS_STATEMENT] =
  * This string indicates that this option in the dropdown is 'Rename
  * variable...' and if selected, should trigger the prompt to rename a variable.
  * @alias Blockly.internalConstants.RENAME_VARIABLE_ID
+ * @internal
  */
 export const RENAME_VARIABLE_ID = 'RENAME_VARIABLE_ID';
 
@@ -58,5 +62,6 @@ export const RENAME_VARIABLE_ID = 'RENAME_VARIABLE_ID';
  * This string indicates that this option in the dropdown is 'Delete the "%1"
  * variable' and if selected, should trigger the prompt to delete a variable.
  * @alias Blockly.internalConstants.DELETE_VARIABLE_ID
+ * @internal
  */
 export const DELETE_VARIABLE_ID = 'DELETE_VARIABLE_ID';

core/keyboard_nav/ast_node.ts

@@ -145,6 +145,7 @@ export class ASTNode {
   /**
    * Whether the node points to a connection.
    * @return [description]
+   * @internal
    */
   isConnection(): boolean {
     return this.isConnection_;

core/keyboard_nav/marker.ts

@@ -90,7 +90,10 @@ export class Marker {
     }
   }
 
-  /** Redraw the current marker. */
+  /**
+   * Redraw the current marker.
+   * @internal
+   */
   draw() {
     if (this.drawer_) {
       this.drawer_.draw(this.curNode_, this.curNode_);

core/marker_manager.ts

@@ -41,7 +41,10 @@ export class MarkerManager {
   /** The marker's SVG element. */
   private markerSvg_: SVGElement|null = null;
 
-  /** @param workspace The workspace for the marker manager. */
+  /**
+   * @param workspace The workspace for the marker manager.
+   * @internal
+   */
   constructor(private readonly workspace: WorkspaceSvg) {
     /** The map of markers for the workspace. */
     this.markers_ = Object.create(null);
@@ -118,6 +121,7 @@ export class MarkerManager {
    * Add the cursor SVG to this workspace SVG group.
    * @param cursorSvg The SVG root of the cursor to be added to the workspace
    *     SVG group.
+   * @internal
    */
   setCursorSvg(cursorSvg: SVGElement|null) {
     if (!cursorSvg) {
@@ -133,6 +137,7 @@ export class MarkerManager {
    * Add the marker SVG to this workspaces SVG group.
    * @param markerSvg The SVG root of the marker to be added to the workspace
    *     SVG group.
+   * @internal
    */
   setMarkerSvg(markerSvg: SVGElement|null) {
     if (!markerSvg) {
@@ -150,7 +155,10 @@ export class MarkerManager {
     }
   }
 
-  /** Redraw the attached cursor SVG if needed. */
+  /**
+   * Redraw the attached cursor SVG if needed.
+   * @internal
+   */
   updateMarkers() {
     if (this.workspace.keyboardAccessibilityMode && this.cursorSvg_) {
       this.workspace.getCursor()!.draw();
@@ -161,6 +169,7 @@ export class MarkerManager {
    * Dispose of the marker manager.
    * Go through and delete all markers associated with this marker manager.
    * @suppress {checkTypes}
+   * @internal
    */
   dispose() {
     const markerIds = Object.keys(this.markers_);

core/menu.ts

@@ -79,6 +79,7 @@ export class Menu {
   /**
    * Add a new menu item to the bottom of this menu.
    * @param menuItem Menu item to append.
+   * @internal
    */
   addChild(menuItem: MenuItem) {
     this.menuItems_.push(menuItem);
@@ -121,12 +122,16 @@ export class Menu {
   /**
    * Gets the menu's element.
    * @return The DOM element.
+   * @internal
    */
   getElement(): Element|null {
     return this.element_;
   }
 
-  /** Focus the menu element. */
+  /**
+   * Focus the menu element.
+   * @internal
+   */
   focus() {
     const el = this.getElement();
     if (el) {
@@ -151,6 +156,7 @@ export class Menu {
   /**
    * Set the menu accessibility role.
    * @param roleName role name.
+   * @internal
    */
   setRole(roleName: aria.Role) {
     this.roleName_ = roleName;
@@ -222,6 +228,7 @@ export class Menu {
   /**
    * Highlights the given menu item, or clears highlighting if null.
    * @param item Item to highlight, or null.
+   * @internal
    */
   setHighlighted(item: MenuItem|null) {
     const currentHighlighted = this.highlightedItem_;
@@ -244,6 +251,7 @@ export class Menu {
   /**
    * Highlights the next highlightable item (or the first if nothing is
    * currently highlighted).
+   * @internal
    */
   highlightNext() {
     // AnyDuringMigration because:  Argument of type 'MenuItem | null' is not
@@ -256,6 +264,7 @@ export class Menu {
   /**
    * Highlights the previous highlightable item (or the last if nothing is
    * currently highlighted).
+   * @internal
    */
   highlightPrevious() {
     // AnyDuringMigration because:  Argument of type 'MenuItem | null' is not
@@ -430,6 +439,7 @@ export class Menu {
   /**
    * Get the size of a rendered menu.
    * @return Object with width and height properties.
+   * @internal
    */
   getSize(): Size {
     const menuDom = this.getElement();

core/menuitem.ts

@@ -113,6 +113,7 @@ export class MenuItem {
   /**
    * Gets the menu item's element.
    * @return The DOM element.
+   * @internal
    */
   getElement(): Element|null {
     return this.element_;
@@ -121,6 +122,7 @@ export class MenuItem {
   /**
    * Gets the unique ID for this menu item.
    * @return Unique component ID.
+   * @internal
    */
   getId(): string {
     return this.element_!.id;
@@ -129,6 +131,7 @@ export class MenuItem {
   /**
    * Gets the value associated with the menu item.
    * @return value Value associated with the menu item.
+   * @internal
    */
   getValue(): AnyDuringMigration {
     return this.opt_value;
@@ -137,6 +140,7 @@ export class MenuItem {
   /**
    * Set menu item's rendering direction.
    * @param rtl True if RTL, false if LTR.
+   * @internal
    */
   setRightToLeft(rtl: boolean) {
     this.rightToLeft_ = rtl;
@@ -145,6 +149,7 @@ export class MenuItem {
   /**
    * Set the menu item's accessibility role.
    * @param roleName Role name.
+   * @internal
    */
   setRole(roleName: aria.Role) {
     this.roleName_ = roleName;
@@ -154,6 +159,7 @@ export class MenuItem {
    * Sets the menu item to be checkable or not. Set to true for menu items
    * that represent checkable options.
    * @param checkable Whether the menu item is checkable.
+   * @internal
    */
   setCheckable(checkable: boolean) {
     this.checkable_ = checkable;
@@ -162,6 +168,7 @@ export class MenuItem {
   /**
    * Checks or unchecks the component.
    * @param checked Whether to check or uncheck the component.
+   * @internal
    */
   setChecked(checked: boolean) {
     this.checked_ = checked;
@@ -170,6 +177,7 @@ export class MenuItem {
   /**
    * Highlights or unhighlights the component.
    * @param highlight Whether to highlight or unhighlight the component.
+   * @internal
    */
   setHighlighted(highlight: boolean) {
     this.highlight_ = highlight;
@@ -193,6 +201,7 @@ export class MenuItem {
   /**
    * Returns true if the menu item is enabled, false otherwise.
    * @return Whether the menu item is enabled.
+   * @internal
    */
   isEnabled(): boolean {
     return this.enabled_;
@@ -201,6 +210,7 @@ export class MenuItem {
   /**
    * Enables or disables the menu item.
    * @param enabled Whether to enable or disable the menu item.
+   * @internal
    */
   setEnabled(enabled: boolean) {
     this.enabled_ = enabled;
@@ -209,6 +219,7 @@ export class MenuItem {
   /**
    * Performs the appropriate action when the menu item is activated
    * by the user.
+   * @internal
    */
   performAction() {
     if (this.isEnabled() && this.actionHandler_) {
@@ -221,6 +232,7 @@ export class MenuItem {
    * `obj` will be used as the 'this' object in the function when called.
    * @param fn The handler.
    * @param obj Used as the 'this' object in fn when called.
+   * @internal
    */
   onAction(fn: (p1: MenuItem) => AnyDuringMigration, obj: AnyDuringMigration) {
     this.actionHandler_ = fn.bind(obj);

core/metrics_manager.ts

@@ -203,6 +203,7 @@ export class MetricsManager implements IMetricsManager {
   /**
    * Returns whether the scroll area has fixed edges.
    * @return Whether the scroll area has fixed edges.
+   * @internal
    */
   hasFixedEdges(): boolean {
     // This exists for optimization of bump logic.

core/mutator.ts

@@ -94,6 +94,7 @@ export class Mutator extends Icon {
   /**
    * Set the block this mutator is associated with.
    * @param block The block associated with this mutator.
+   * @internal
    */
   setBlock(block: BlockSvg) {
     this.block_ = block;
@@ -103,6 +104,7 @@ export class Mutator extends Icon {
    * Returns the workspace inside this mutator icon's bubble.
    * @return The workspace inside this mutator icon's bubble or null if the
    *     mutator isn't open.
+   * @internal
    */
   getWorkspace(): WorkspaceSvg|null {
     return this.workspace_;

core/positionable_helpers.ts

@@ -32,6 +32,7 @@ import {WorkspaceSvg} from './workspace_svg.js';
 /**
  * Enum for vertical positioning.
  * @alias Blockly.uiPosition.verticalPosition
+ * @internal
  */
 export enum verticalPosition {
   TOP,
@@ -41,6 +42,7 @@ export enum verticalPosition {
 /**
  * Enum for horizontal positioning.
  * @alias Blockly.uiPosition.horizontalPosition
+ * @internal
  */
 export enum horizontalPosition {
   LEFT,
@@ -50,6 +52,7 @@ export enum horizontalPosition {
 /**
  * An object defining a horizontal and vertical positioning.
  * @alias Blockly.uiPosition.Position
+ * @internal
  */
 export interface Position {
   horizontal: horizontalPosition;
@@ -59,6 +62,7 @@ export interface Position {
 /**
  * Enum for bump rules to use for dealing with collisions.
  * @alias Blockly.uiPosition.bumpDirection
+ * @internal
  */
 export enum bumpDirection {
   UP,
@@ -78,6 +82,7 @@ export enum bumpDirection {
  * @param workspace The workspace.
  * @return The suggested start position.
  * @alias Blockly.uiPosition.getStartPositionRect
+ * @internal
  */
 export function getStartPositionRect(
     position: Position, size: Size, horizontalPadding: number,
@@ -125,6 +130,7 @@ export function getStartPositionRect(
  * @param metrics The workspace metrics.
  * @return The suggested corner position.
  * @alias Blockly.uiPosition.getCornerOppositeToolbox
+ * @internal
  */
 export function getCornerOppositeToolbox(
     workspace: WorkspaceSvg, metrics: UiMetrics): Position {
@@ -150,6 +156,7 @@ export function getCornerOppositeToolbox(
  *     elements already placed.
  * @return The suggested position rectangle.
  * @alias Blockly.uiPosition.bumpPositionRect
+ * @internal
  */
 export function bumpPositionRect(
     startRect: Rect, margin: number, bumpDir: bumpDirection,

core/procedures.ts

@@ -327,6 +327,7 @@ function updateMutatorFlyout(workspace: WorkspaceSvg) {
  * update and adds a mutator change listener to the mutator workspace.
  * @param e The event that triggered this listener.
  * @alias Blockly.Procedures.mutatorOpenListener
+ * @internal
  */
 export function mutatorOpenListener(e: Abstract) {
   if (e.type !== eventUtils.BUBBLE_OPEN) {

core/registry.ts

@@ -87,6 +87,7 @@ export class Type<T> {
       new Type<IFlyout>('flyoutsHorizontalToolbox');
   static METRICS_MANAGER = new Type<IMetricsManager>('metricsManager');
   static BLOCK_DRAGGER = new Type<IBlockDragger>('blockDragger');
+  /** @internal */
   static SERIALIZER = new Type<ISerializer>('serializer');
 
   /** @param name The name of the registry type. */

core/rendered_connection.ts

@@ -112,6 +112,7 @@ export class RenderedConnection extends Connection {
   /**
    * Dispose of this connection. Remove it from the database (if it is
    * tracked) and call the super-function to deal with connected blocks.
+   * @internal
    */
   override dispose() {
     super.dispose();
@@ -152,6 +153,7 @@ export class RenderedConnection extends Connection {
    * Move the block(s) belonging to the connection to a point where they don't
    * visually interfere with the specified connection.
    * @param staticConnection The connection to move away from.
+   * @internal
    */
   bumpAwayFrom(staticConnection: RenderedConnection) {
     if (this.sourceBlock_.workspace.isDragging()) {
@@ -245,6 +247,7 @@ export class RenderedConnection extends Connection {
   /**
    * Get the offset of this connection relative to the top left of its block.
    * @return The offset of the connection.
+   * @internal
    */
   getOffsetInBlock(): Coordinate {
     return this.offsetInBlock_;
@@ -252,6 +255,7 @@ export class RenderedConnection extends Connection {
 
   /**
    * Move the blocks on either side of this connection right next to each other.
+   * @internal
    */
   tighten() {
     const dx = this.targetConnection!.x - this.x;
@@ -334,6 +338,7 @@ export class RenderedConnection extends Connection {
   /**
    * Set whether this connections is tracked in the database or not.
    * @param doTracking If true, start tracking. If false, stop tracking.
+   * @internal
    */
   setTracking(doTracking: boolean) {
     if (doTracking &&
@@ -363,6 +368,7 @@ export class RenderedConnection extends Connection {
    * collapsed.
    *
    * Also closes down-stream icons/bubbles.
+   * @internal
    */
   stopTrackingAll() {
     this.setTracking(false);
@@ -432,6 +438,7 @@ export class RenderedConnection extends Connection {
    * attempted connection fails.
    * @param otherConnection Connection that this connection failed to connect
    *     to.
+   * @internal
    */
   override onFailedConnect(otherConnection: Connection) {
     const block = this.getSourceBlock();
@@ -494,6 +501,7 @@ export class RenderedConnection extends Connection {
    * @param maxLimit The maximum radius to another connection, in workspace
    *     units.
    * @return List of connections.
+   * @internal
    */
   override neighbours(maxLimit: number): Connection[] {
     return this.dbOpposite_.getNeighbours(this, maxLimit);

core/renderers/common/block_rendering.ts

@@ -58,6 +58,7 @@ import {Renderer} from './renderer.js';
  * @return Whether the debugger is turned on.
  * @alias Blockly.blockRendering.isDebuggerEnabled
  * @deprecated
+ * @internal
  */
 export function isDebuggerEnabled(): boolean {
   deprecation.warn(
@@ -90,6 +91,7 @@ export function unregister(name: string) {
  * Turn on the blocks debugger.
  * @alias Blockly.blockRendering.startDebugger
  * @deprecated
+ * @internal
  */
 export function startDebugger() {
   deprecation.warn(
@@ -103,6 +105,7 @@ export function startDebugger() {
  * Turn off the blocks debugger.
  * @alias Blockly.blockRendering.stopDebugger
  * @deprecated
+ * @internal
  */
 export function stopDebugger() {
   deprecation.warn(
@@ -120,6 +123,7 @@ export function stopDebugger() {
  * @return The new instance of a renderer.
  *     Already initialized.
  * @alias Blockly.blockRendering.init
+ * @internal
  */
 export function init(
     name: string, theme: Theme, opt_rendererOverrides?: object): Renderer {

core/renderers/common/constants.ts

@@ -244,7 +244,10 @@ export class ConstantProvider {
   /** A field's border rect Y padding. */
   FIELD_BORDER_RECT_Y_PADDING = 3;
 
-  /** The backing colour of a field's border rect. */
+  /**
+   * The backing colour of a field's border rect.
+   * @internal
+   */
   FIELD_BORDER_RECT_COLOUR = '#fff';
   FIELD_TEXT_BASELINE_CENTER: boolean;
   FIELD_DROPDOWN_BORDER_RECT_HEIGHT: number;
@@ -285,6 +288,7 @@ export class ConstantProvider {
   FIELD_COLOUR_DEFAULT_WIDTH = 26;
   FIELD_COLOUR_DEFAULT_HEIGHT: number;
   FIELD_CHECKBOX_X_OFFSET: number;
+  /** @internal */
   randomIdentifier: string;
 
   /**
@@ -295,6 +299,7 @@ export class ConstantProvider {
 
   /**
    * The ID of the emboss filter, or the empty string if no filter is set.
+   * @internal
    */
   embossFilterId = '';
 
@@ -305,6 +310,7 @@ export class ConstantProvider {
 
   /**
    * The ID of the disabled pattern, or the empty string if no pattern is set.
+   * @internal
    */
   disabledPatternId = '';
 
@@ -332,39 +338,65 @@ export class ConstantProvider {
   // 'HTMLStyleElement'.
   private cssNode_: HTMLStyleElement = null as AnyDuringMigration;
 
-  /** Cursor colour. */
+  /**
+   * Cursor colour.
+   * @internal
+   */
   CURSOR_COLOUR = '#cc0a0a';
 
-  /** Immovable marker colour. */
+  /**
+   * Immovable marker colour.
+   * @internal
+   */
   MARKER_COLOUR = '#4286f4';
 
-  /** Width of the horizontal cursor. */
+  /**
+   * Width of the horizontal cursor.
+   * @internal
+   */
   CURSOR_WS_WIDTH = 100;
 
-  /** Height of the horizontal cursor. */
+  /**
+   * Height of the horizontal cursor.
+   * @internal
+   */
   WS_CURSOR_HEIGHT = 5;
 
-  /** Padding around a stack. */
+  /**
+   * Padding around a stack.
+   * @internal
+   */
   CURSOR_STACK_PADDING = 10;
 
-  /** Padding around a block. */
+  /**
+   * Padding around a block.
+   * @internal
+   */
   CURSOR_BLOCK_PADDING = 2;
 
-  /** Stroke of the cursor. */
+  /**
+   * Stroke of the cursor.
+   * @internal
+   */
   CURSOR_STROKE_WIDTH = 4;
 
   /**
    * Whether text input and colour fields fill up the entire source block.
+   * @internal
    */
   FULL_BLOCK_FIELDS = false;
 
   /**
    * The main colour of insertion markers, in hex.  The block is rendered a
    * transparent grey by changing the fill opacity in CSS.
+   * @internal
    */
   INSERTION_MARKER_COLOUR = '#000000';
 
-  /** The insertion marker opacity. */
+  /**
+   * The insertion marker opacity.
+   * @internal
+   */
   INSERTION_MARKER_OPACITY = 0.2;
 
   /** Enum for connection shapes. */
@@ -382,8 +414,10 @@ export class ConstantProvider {
   // TODO(b/109816955): remove '!', see go/strict-prop-init-fix.
   OUTSIDE_CORNERS!: OutsideCorners;
   // TODO(b/109816955): remove '!', see go/strict-prop-init-fix.
+  /** @internal */
   blockStyles!: {[key: string]: BlockStyle};
 
+  /** @internal */
   constructor() {
     /**
      * Offset from the top of the row for placing fields on inline input rows
@@ -463,12 +497,14 @@ export class ConstantProvider {
     /**
      * A random identifier used to ensure a unique ID is used for each
      * filter/pattern for the case of multiple Blockly instances on a page.
+     * @internal
      */
     this.randomIdentifier = String(Math.random()).substring(2);
   }
 
   /**
    * Initialize shape objects based on the constants set in the constructor.
+   * @internal
    */
   init() {
     /**
@@ -502,6 +538,7 @@ export class ConstantProvider {
   /**
    * Refresh constants properties that depend on the theme.
    * @param theme The current workspace theme.
+   * @internal
    */
   setTheme(theme: Theme) {
     /** The block styles map. */
@@ -575,6 +612,7 @@ export class ConstantProvider {
    * @param colour #RRGGBB colour string.
    * @return An object containing the style and an autogenerated name for that
    *     style.
+   * @internal
    */
   getBlockStyleForColour(colour: string): {style: BlockStyle, name: string} {
     const name = 'auto_' + colour;
@@ -659,6 +697,7 @@ export class ConstantProvider {
   /**
    * Dispose of this constants provider.
    * Delete all DOM elements that this provider created.
+   * @internal
    */
   dispose() {
     if (this.embossFilter_) {
@@ -678,6 +717,7 @@ export class ConstantProvider {
   /**
    * @return An object containing sizing and path information about collapsed
    *     block indicators.
+   * @internal
    */
   makeJaggedTeeth(): JaggedTeeth {
     const height = this.JAGGED_TEETH_HEIGHT;
@@ -693,6 +733,7 @@ export class ConstantProvider {
 
   /**
    * @return An object containing sizing and path information about start hats.
+   * @internal
    */
   makeStartHat(): StartHat {
     const height = this.START_HAT_HEIGHT;
@@ -708,6 +749,7 @@ export class ConstantProvider {
 
   /**
    * @return An object containing sizing and path information about puzzle tabs.
+   * @internal
    */
   makePuzzleTab(): PuzzleTab {
     const width = this.TAB_WIDTH;
@@ -764,6 +806,7 @@ export class ConstantProvider {
 
   /**
    * @return An object containing sizing and path information about notches.
+   * @internal
    */
   makeNotch(): Notch {
     const width = this.NOTCH_WIDTH;
@@ -799,6 +842,7 @@ export class ConstantProvider {
   /**
    * @return An object containing sizing and path information about inside
    *     corners.
+   * @internal
    */
   makeInsideCorners(): InsideCorners {
     const radius = this.CORNER_RADIUS;
@@ -820,6 +864,7 @@ export class ConstantProvider {
   /**
    * @return An object containing sizing and path information about outside
    *     corners.
+   * @internal
    */
   makeOutsideCorners(): OutsideCorners {
     const radius = this.CORNER_RADIUS;
@@ -853,6 +898,7 @@ export class ConstantProvider {
    * type of the connection.
    * @param connection The connection to find a shape object for
    * @return The shape object for the connection.
+   * @internal
    */
   shapeFor(connection: RenderedConnection): Shape {
     switch (connection.type) {
@@ -874,6 +920,7 @@ export class ConstantProvider {
    * @param selector The CSS selector to use.
    * @suppress {strictModuleDepCheck} Debug renderer only included in
    * playground.
+   * @internal
    */
   createDom(svg: SVGElement, tagName: string, selector: string) {
     this.injectCSS_(tagName, selector);

core/renderers/common/debug.ts

@@ -24,6 +24,7 @@ let useDebugger = false;
  * Returns whether the debugger is turned on.
  * @return Whether the debugger is turned on.
  * @alias Blockly.blockRendering.debug.isDebuggerEnabled
+ * @internal
  */
 export function isDebuggerEnabled(): boolean {
   return useDebugger;
@@ -34,6 +35,7 @@ export function isDebuggerEnabled(): boolean {
  * @alias Blockly.blockRendering.debug.startDebugger
  * @deprecated March 2022. Use the rendering debugger in @blockly/dev-tools.
  * See https://www.npmjs.com/package/@blockly/dev-tools for more information.
+ * @internal
  */
 export function startDebugger() {
   deprecation.warn(
@@ -48,6 +50,7 @@ export function startDebugger() {
  * @alias Blockly.blockRendering.debug.stopDebugger
  * @deprecated March 2022. Use the rendering debugger in @blockly/dev-tools.
  * See https://www.npmjs.com/package/@blockly/dev-tools for more information.
+ * @internal
  */
 export function stopDebugger() {
   deprecation.warn(

core/renderers/common/debugger.ts

@@ -75,10 +75,16 @@ export class Debug {
 
   private randomColour_ = '';
 
-  /** @param constants The renderer's constants. */
+  /**
+   * @param constants The renderer's constants.
+   * @internal
+   */
   constructor(private readonly constants: ConstantProvider) {}
 
-  /** Remove all elements the this object created on the last pass. */
+  /**
+   * Remove all elements the this object created on the last pass.
+   * @internal
+   */
   clearElems() {
     for (let i = 0; i < this.debugElements_.length; i++) {
       const elem = this.debugElements_[i];
@@ -93,6 +99,7 @@ export class Debug {
    * @param row The row to render.
    * @param cursorY The y position of the top of the row.
    * @param isRtl Whether the block is rendered RTL.
+   * @internal
    */
   drawSpacerRow(row: Row, cursorY: number, isRtl: boolean) {
     if (!Debug.config.rowSpacers) {
@@ -125,6 +132,7 @@ export class Debug {
    * @param elem The spacer to render.
    * @param rowHeight The height of the container row.
    * @param isRtl Whether the block is rendered RTL.
+   * @internal
    */
   drawSpacerElem(elem: InRowSpacer, rowHeight: number, isRtl: boolean) {
     if (!Debug.config.elemSpacers) {
@@ -157,6 +165,7 @@ export class Debug {
    * Draw a debug rectangle for an in-row element.
    * @param elem The element to render.
    * @param isRtl Whether the block is rendered RTL.
+   * @internal
    */
   drawRenderedElem(elem: Measurable, isRtl: boolean) {
     if (Debug.config.elems) {
@@ -209,6 +218,7 @@ export class Debug {
    * @param conn The connection to circle.
    * @suppress {visibility} Suppress visibility of conn.offsetInBlock_ since
    * this is a debug module.
+   * @internal
    */
   drawConnection(conn: RenderedConnection) {
     if (!Debug.config.connections) {
@@ -256,6 +266,7 @@ export class Debug {
    * @param row The non-empty row to render.
    * @param cursorY The y position of the top of the row.
    * @param isRtl Whether the block is rendered RTL.
+   * @internal
    */
   drawRenderedRow(row: Row, cursorY: number, isRtl: boolean) {
     if (!Debug.config.rows) {
@@ -302,6 +313,7 @@ export class Debug {
    * @param row The non-empty row to render.
    * @param cursorY The y position of the top of the row.
    * @param isRtl Whether the block is rendered RTL.
+   * @internal
    */
   drawRowWithElements(row: Row, cursorY: number, isRtl: boolean) {
     for (let i = 0; i < row.elements.length; i++) {
@@ -322,6 +334,7 @@ export class Debug {
   /**
    * Draw a debug rectangle around the entire block.
    * @param info Rendering information about the block to debug.
+   * @internal
    */
   drawBoundingBox(info: RenderInfo) {
     if (!Debug.config.blockBounds) {
@@ -367,6 +380,7 @@ export class Debug {
    * Do all of the work to draw debug information for the whole block.
    * @param block The block to draw debug information for.
    * @param info Rendering information about the block to debug.
+   * @internal
    */
   drawDebug(block: BlockSvg, info: RenderInfo) {
     this.clearElems();
@@ -412,6 +426,7 @@ export class Debug {
   /**
    * Show a debug filter to highlight that a block has been rendered.
    * @param svgPath The block's SVG path.
+   * @internal
    */
   drawRender(svgPath: SVGElement) {
     if (!Debug.config.render) {

core/renderers/common/drawer.ts

@@ -56,6 +56,7 @@ export class Drawer {
    * @param block The block to render.
    * @param info An object containing all information needed to render this
    *     block.
+   * @internal
    */
   constructor(block: BlockSvg, info: RenderInfo) {
     this.block_ = block;
@@ -74,6 +75,7 @@ export class Drawer {
    * joined with spaces and set directly on the block.  This guarantees that
    * the steps are separated by spaces for improved readability, but isn't
    * required.
+   * @internal
    */
   draw() {
     this.hideHiddenIcons_();

core/renderers/common/i_path_object.ts

@@ -64,6 +64,7 @@ export interface IPathObject {
   /**
    * Set the path generated by the renderer onto the respective SVG element.
    * @param pathString The path.
+   * @internal
    */
   setPath: AnyDuringMigration;
 
@@ -71,22 +72,28 @@ export interface IPathObject {
    * Apply the stored colours to the block's path, taking into account whether
    * the paths belong to a shadow block.
    * @param block The source block.
+   * @internal
    */
   applyColour: AnyDuringMigration;
 
   /**
    * Update the style.
    * @param blockStyle The block style to use.
+   * @internal
    */
   setStyle: AnyDuringMigration;
 
-  /** Flip the SVG paths in RTL. */
+  /**
+   * Flip the SVG paths in RTL.
+   * @internal
+   */
   flipRTL: () => void;
 
   /**
    * Add the cursor SVG to this block's SVG group.
    * @param cursorSvg The SVG root of the cursor to be added to the block SVG
    *     group.
+   * @internal
    */
   setCursorSvg: AnyDuringMigration;
 
@@ -94,6 +101,7 @@ export interface IPathObject {
    * Add the marker SVG to this block's SVG group.
    * @param markerSvg The SVG root of the marker to be added to the block SVG
    *     group.
+   * @internal
    */
   setMarkerSvg: AnyDuringMigration;
 
@@ -101,12 +109,14 @@ export interface IPathObject {
    * Set whether the block shows a highlight or not.  Block highlighting is
    * often used to visually mark blocks currently being executed.
    * @param highlighted True if highlighted.
+   * @internal
    */
   updateHighlighted: AnyDuringMigration;
 
   /**
    * Add or remove styling showing that a block is selected.
    * @param enable True if selection is enabled, false otherwise.
+   * @internal
    */
   updateSelected: AnyDuringMigration;
 
@@ -114,18 +124,21 @@ export interface IPathObject {
    * Add or remove styling showing that a block is dragged over a delete area.
    * @param enable True if the block is being dragged over a delete area, false
    *     otherwise.
+   * @internal
    */
   updateDraggingDelete: AnyDuringMigration;
 
   /**
    * Add or remove styling showing that a block is an insertion marker.
    * @param enable True if the block is an insertion marker, false otherwise.
+   * @internal
    */
   updateInsertionMarker: AnyDuringMigration;
 
   /**
    * Add or remove styling showing that a block is movable.
    * @param enable True if the block is movable, false otherwise.
+   * @internal
    */
   updateMovable: AnyDuringMigration;
 
@@ -134,6 +147,7 @@ export interface IPathObject {
    * this block will be replaced.  If a shadow block, it will disappear.
    * Otherwise it will bump.
    * @param enable True if styling should be added.
+   * @internal
    */
   updateReplacementFade: AnyDuringMigration;
 
@@ -142,6 +156,7 @@ export interface IPathObject {
    * 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.
+   * @internal
    */
   updateShapeForInputHighlight: AnyDuringMigration;
 }

core/renderers/common/info.ts

@@ -99,6 +99,7 @@ export class RenderInfo {
   /**
    * @param renderer The renderer in use.
    * @param block The block to measure.
+   * @internal
    */
   constructor(protected readonly renderer: Renderer, block: BlockSvg) {
     this.block_ = block;
@@ -150,6 +151,7 @@ export class RenderInfo {
   /**
    * Get the block renderer in use.
    * @return The block renderer in use.
+   * @internal
    */
   getRenderer(): Renderer {
     return this.renderer;
@@ -162,6 +164,7 @@ export class RenderInfo {
    * This measure pass does not propagate changes to the block (although fields
    * may choose to rerender when getSize() is called).  However, calling it
    * repeatedly may be expensive.
+   * @internal
    */
   measure() {
     this.createRows_();
@@ -227,7 +230,10 @@ export class RenderInfo {
     this.rows.push(this.bottomRow);
   }
 
-  /** Create all non-spacer elements that belong on the top row. */
+  /**
+   * Create all non-spacer elements that belong on the top row.
+   * @internal
+   */
   populateTopRow_() {
     const hasPrevious = !!this.block_.previousConnection;
     const hasHat = (this.block_.hat ? this.block_.hat === 'cap' :
@@ -268,7 +274,10 @@ export class RenderInfo {
     this.topRow.elements.push(new cornerClass(this.constants_, 'right'));
   }
 
-  /** Create all non-spacer elements that belong on the bottom row. */
+  /**
+   * Create all non-spacer elements that belong on the bottom row.
+   * @internal
+   */
   populateBottomRow_() {
     this.bottomRow.hasNextConnection = !!this.block_.nextConnection;
 

core/renderers/common/marker_svg.ts

@@ -126,6 +126,7 @@ export class MarkerSvg {
   /**
    * Create the DOM element for the marker.
    * @return The marker controls SVG group.
+   * @internal
    */
   createDom(): SVGElement {
     const className = this.isCursor() ? CURSOR_CLASS : MARKER_CLASS;

core/renderers/common/path_object.ts

@@ -40,11 +40,13 @@ import {IPathObject} from './i_path_object.js';
  */
 export class PathObject implements IPathObject {
   svgRoot: AnyDuringMigration;
+  /** @internal */
   svgPath: SVGElement;
 
   /**
    * Holds the cursors svg element when the cursor is attached to the block.
    * This is null if there is no cursor on the block.
+   * @internal
    */
   // AnyDuringMigration because:  Type 'null' is not assignable to type
   // 'SVGElement'.
@@ -53,19 +55,27 @@ export class PathObject implements IPathObject {
   /**
    * Holds the markers svg element when the marker is attached to the block.
    * This is null if there is no marker on the block.
+   * @internal
    */
   // AnyDuringMigration because:  Type 'null' is not assignable to type
   // 'SVGElement'.
   markerSvg: SVGElement = null as AnyDuringMigration;
 
+  /** @internal */
+  constants: ConstantProvider;
+  /** @internal */
+  style: BlockStyle;
+
   /**
    * @param root The root SVG element.
    * @param style The style object to use for colouring.
    * @param constants The renderer's constants.
+   * @internal
    */
   constructor(
-      root: SVGElement, public style: BlockStyle,
-      public constants: ConstantProvider) {
+      root: SVGElement, style: BlockStyle, constants: ConstantProvider) {
+    this.constants = constants;
+    this.style = style;
     this.svgRoot = root;
 
     /** The primary path of the block. */
@@ -76,12 +86,16 @@ export class PathObject implements IPathObject {
   /**
    * Set the path generated by the renderer onto the respective SVG element.
    * @param pathString The path.
+   * @internal
    */
   setPath(pathString: string) {
     this.svgPath.setAttribute('d', pathString);
   }
 
-  /** Flip the SVG paths in RTL. */
+  /**
+   * Flip the SVG paths in RTL.
+   * @internal
+   */
   flipRTL() {
     // Mirror the block's path.
     this.svgPath.setAttribute('transform', 'scale(-1 1)');
@@ -91,6 +105,7 @@ export class PathObject implements IPathObject {
    * Add the cursor SVG to this block's SVG group.
    * @param cursorSvg The SVG root of the cursor to be added to the block SVG
    *     group.
+   * @internal
    */
   setCursorSvg(cursorSvg: SVGElement) {
     if (!cursorSvg) {
@@ -108,6 +123,7 @@ export class PathObject implements IPathObject {
    * Add the marker SVG to this block's SVG group.
    * @param markerSvg The SVG root of the marker to be added to the block SVG
    *     group.
+   * @internal
    */
   setMarkerSvg(markerSvg: SVGElement) {
     if (!markerSvg) {
@@ -129,6 +145,7 @@ export class PathObject implements IPathObject {
    * Apply the stored colours to the block's path, taking into account whether
    * the paths belong to a shadow block.
    * @param block The source block.
+   * @internal
    */
   applyColour(block: BlockSvg) {
     this.svgPath.setAttribute('stroke', this.style.colourTertiary);
@@ -141,6 +158,7 @@ export class PathObject implements IPathObject {
   /**
    * Set the style.
    * @param blockStyle The block style to use.
+   * @internal
    */
   setStyle(blockStyle: BlockStyle) {
     this.style = blockStyle;
@@ -164,6 +182,7 @@ export class PathObject implements IPathObject {
    * Set whether the block shows a highlight or not.  Block highlighting is
    * often used to visually mark blocks currently being executed.
    * @param enable True if highlighted.
+   * @internal
    */
   updateHighlighted(enable: boolean) {
     if (enable) {
@@ -200,6 +219,7 @@ export class PathObject implements IPathObject {
   /**
    * Add or remove styling showing that a block is selected.
    * @param enable True if selection is enabled, false otherwise.
+   * @internal
    */
   updateSelected(enable: boolean) {
     this.setClass_('blocklySelected', enable);
@@ -209,6 +229,7 @@ export class PathObject implements IPathObject {
    * Add or remove styling showing that a block is dragged over a delete area.
    * @param enable True if the block is being dragged over a delete area, false
    *     otherwise.
+   * @internal
    */
   updateDraggingDelete(enable: boolean) {
     this.setClass_('blocklyDraggingDelete', enable);
@@ -217,6 +238,7 @@ export class PathObject implements IPathObject {
   /**
    * Add or remove styling showing that a block is an insertion marker.
    * @param enable True if the block is an insertion marker, false otherwise.
+   * @internal
    */
   updateInsertionMarker(enable: boolean) {
     this.setClass_('blocklyInsertionMarker', enable);
@@ -225,6 +247,7 @@ export class PathObject implements IPathObject {
   /**
    * Add or remove styling showing that a block is movable.
    * @param enable True if the block is movable, false otherwise.
+   * @internal
    */
   updateMovable(enable: boolean) {
     this.setClass_('blocklyDraggable', enable);
@@ -235,6 +258,7 @@ export class PathObject implements IPathObject {
    * this block will be replaced.  If a shadow block, it will disappear.
    * Otherwise it will bump.
    * @param enable True if styling should be added.
+   * @internal
    */
   updateReplacementFade(enable: boolean) {
     this.setClass_('blocklyReplaceable', enable);
@@ -245,6 +269,7 @@ export class PathObject implements IPathObject {
    * 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.
+   * @internal
    */
   updateShapeForInputHighlight(_conn: Connection, _enable: boolean) {}
 }

core/renderers/common/renderer.ts

@@ -52,15 +52,27 @@ export class Renderer implements IRegistrable {
   /** The renderer's constant provider. */
   protected constants_!: ConstantProvider;
 
-  /** Rendering constant overrides, passed in through options. */
+  /** @internal */
+  name: string;
+
+  /**
+   * Rendering constant overrides, passed in through options.
+   * @internal
+   */
   overrides: object|null = null;
 
-  /** @param name The renderer name. */
-  constructor(public name: string) {}
+  /**
+   * @param name The renderer name.
+   * @internal
+   */
+  constructor(name: string) {
+    this.name = name;
+  }
 
   /**
    * Gets the class name that identifies this renderer.
    * @return The CSS class name.
+   * @internal
    */
   getClassName(): string {
     return this.name + '-renderer';
@@ -70,6 +82,7 @@ export class Renderer implements IRegistrable {
    * Initialize the renderer.
    * @param theme The workspace theme object.
    * @param opt_rendererOverrides Rendering constant overrides.
+   * @internal
    */
   init(theme: Theme, opt_rendererOverrides?: object) {
     this.constants_ = this.makeConstants_();
@@ -85,6 +98,7 @@ export class Renderer implements IRegistrable {
    * Create any DOM elements that this renderer needs.
    * @param svg The root of the workspace's SVG.
    * @param theme The workspace theme object.
+   * @internal
    */
   createDom(svg: SVGElement, theme: Theme) {
     this.constants_.createDom(
@@ -96,6 +110,7 @@ export class Renderer implements IRegistrable {
    * Refresh the renderer after a theme change.
    * @param svg The root of the workspace's SVG.
    * @param theme The workspace theme object.
+   * @internal
    */
   refreshDom(svg: SVGElement, theme: Theme) {
     const previousConstants = this.getConstants();
@@ -114,6 +129,7 @@ export class Renderer implements IRegistrable {
   /**
    * Dispose of this renderer.
    * Delete all DOM elements that this renderer and its constants created.
+   * @internal
    */
   dispose() {
     if (this.constants_) {
@@ -164,6 +180,7 @@ export class Renderer implements IRegistrable {
    * @param workspace The workspace the marker belongs to.
    * @param marker The marker.
    * @return The object in charge of drawing the marker.
+   * @internal
    */
   makeMarkerDrawer(workspace: WorkspaceSvg, marker: Marker): MarkerSvg {
     return new MarkerSvg(workspace, this.getConstants(), marker);
@@ -174,6 +191,7 @@ export class Renderer implements IRegistrable {
    * @param root The root SVG element.
    * @param style The style object to use for colouring.
    * @return The renderer path object.
+   * @internal
    */
   makePathObject(root: SVGElement, style: BlockStyle): IPathObject {
     return new PathObject(root, style, (this.constants_));
@@ -183,6 +201,7 @@ export class Renderer implements IRegistrable {
    * Get the current renderer's constant provider.  We assume that when this is
    * called, the renderer has already been initialized.
    * @return The constant provider.
+   * @internal
    */
   getConstants(): ConstantProvider {
     return this.constants_;
@@ -192,6 +211,7 @@ export class Renderer implements IRegistrable {
    * Determine whether or not to highlight a connection.
    * @param _conn The connection to determine whether or not to highlight.
    * @return True if we should highlight the connection.
+   * @internal
    */
   shouldHighlightConnection(_conn: Connection): boolean {
     return true;
@@ -207,6 +227,7 @@ export class Renderer implements IRegistrable {
    * @param orphanBlock The orphan block that wants to find a home.
    * @param localType The type of the connection being dragged.
    * @return Whether there is a home for the orphan or not.
+   * @internal
    */
   orphanCanConnectAtEnd(
       topBlock: BlockSvg, orphanBlock: BlockSvg, localType: number): boolean {
@@ -224,6 +245,7 @@ export class Renderer implements IRegistrable {
    * @param local The connection currently being dragged.
    * @param topBlock The block currently being dragged.
    * @return The preview type to display.
+   * @internal
    */
   getConnectionPreviewMethod(
       closest: RenderedConnection, local: RenderedConnection,
@@ -244,6 +266,7 @@ export class Renderer implements IRegistrable {
   /**
    * Render the block.
    * @param block The block to render.
+   * @internal
    */
   render(block: BlockSvg) {
     if (debug.isDebuggerEnabled() && !block.renderingDebugger) {

core/renderers/geras/constants.ts

@@ -38,6 +38,7 @@ export class ConstantProvider extends BaseConstantProvider {
   MAX_BOTTOM_WIDTH = 30;
   override STATEMENT_BOTTOM_SPACER: AnyDuringMigration;
 
+  /** @internal */
   constructor() {
     super();
 

core/renderers/geras/drawer.ts

@@ -46,6 +46,7 @@ export class Drawer extends BaseDrawer {
    * @param block The block to render.
    * @param info An object containing all information needed to render this
    *     block.
+   * @internal
    */
   constructor(block: BlockSvg, info: RenderInfo) {
     super(block, info);

core/renderers/geras/highlight_constants.ts

@@ -89,19 +89,24 @@ export class HighlightConstantProvider {
   // TODO(b/109816955): remove '!', see go/strict-prop-init-fix.
   START_HAT!: StartHat;
 
-  /** @param constants The rendering constants provider. */
+  /**
+   * @param constants The rendering constants provider.
+   * @internal
+   */
   constructor(constants: ConstantProvider) {
     /** The renderer's constant provider. */
     this.constantProvider = constants;
 
     /**
      * The start point, which is offset in both X and Y, as an SVG path chunk.
+     * @internal
      */
     this.START_POINT = svgPaths.moveBy(this.OFFSET, this.OFFSET);
   }
 
   /**
    * Initialize shape objects based on the constants set in the constructor.
+   * @internal
    */
   init() {
     /**
@@ -143,6 +148,7 @@ export class HighlightConstantProvider {
   /**
    * @return An object containing sizing and path information about inside
    *     corner highlights.
+   * @internal
    */
   makeInsideCorner(): InsideCorner {
     const radius = this.constantProvider.CORNER_RADIUS;
@@ -186,6 +192,7 @@ export class HighlightConstantProvider {
   /**
    * @return An object containing sizing and path information about outside
    *     corner highlights.
+   * @internal
    */
   makeOutsideCorner(): OutsideCorner {
     const radius = this.constantProvider.CORNER_RADIUS;
@@ -234,6 +241,7 @@ export class HighlightConstantProvider {
   /**
    * @return An object containing sizing and path information about puzzle tab
    *     highlights.
+   * @internal
    */
   makePuzzleTab(): PuzzleTab {
     const width = this.constantProvider.TAB_WIDTH;
@@ -283,6 +291,7 @@ export class HighlightConstantProvider {
   /**
    * @return An object containing sizing and path information about notch
    *     highlights.
+   * @internal
    */
   makeNotch(): Notch {
     // This is only for the previous connection.
@@ -294,6 +303,7 @@ export class HighlightConstantProvider {
   /**
    * @return An object containing sizing and path information about collapsed
    *     block edge highlights.
+   * @internal
    */
   makeJaggedTeeth(): JaggedTeeth {
     const pathLeft = svgPaths.lineTo(5.1, 2.6) + svgPaths.moveBy(-10.2, 6.8) +
@@ -304,6 +314,7 @@ export class HighlightConstantProvider {
   /**
    * @return An object containing sizing and path information about start
    *     highlights.
+   * @internal
    */
   makeStartHat(): StartHat {
     const hatHeight = this.constantProvider.START_HAT.height;

core/renderers/geras/highlighter.ts

@@ -70,6 +70,7 @@ export class Highlighter {
   /**
    * @param info An object containing all information needed to render this
    *     block.
+   * @internal
    */
   constructor(info: RenderInfo) {
     this.info_ = info;
@@ -96,6 +97,7 @@ export class Highlighter {
   /**
    * Get the steps for the highlight path.
    * @return The steps for the highlight path.
+   * @internal
    */
   getPath(): string {
     return this.steps_ + '\n' + this.inlineSteps_;
@@ -104,6 +106,7 @@ export class Highlighter {
   /**
    * Add a highlight to the top corner of a block.
    * @param row The top row of the block.
+   * @internal
    */
   drawTopCorner(row: TopRow) {
     this.steps_ += svgPaths.moveBy(row.xPos, this.info_.startY);
@@ -133,6 +136,7 @@ export class Highlighter {
   /**
    * Add a highlight on a jagged edge for a collapsed block.
    * @param row  The row to highlight.
+   * @internal
    */
   drawJaggedEdge_(row: Row) {
     if (this.info_.RTL) {
@@ -146,6 +150,7 @@ export class Highlighter {
   /**
    * Add a highlight on a value input.
    * @param row The row the input belongs to.
+   * @internal
    */
   drawValueInput(row: Row) {
     const input = row.getLastInput() as InlineInput;
@@ -166,6 +171,7 @@ export class Highlighter {
   /**
    * Add a highlight on a statement input.
    * @param row The row to highlight.
+   * @internal
    */
   drawStatementInput(row: Row) {
     const input = row.getLastInput();
@@ -188,6 +194,7 @@ export class Highlighter {
   /**
    * Add a highlight on the right side of a row.
    * @param row The row to highlight.
+   * @internal
    */
   drawRightSideRow(row: Row) {
     const rightEdge = row.xPos + row.width - this.highlightOffset_;
@@ -206,6 +213,7 @@ export class Highlighter {
   /**
    * Add a highlight to the bottom row.
    * @param row The row to highlight.
+   * @internal
    */
   drawBottomRow(row: BottomRow) {
     // Highlight the vertical edge of the bottom row on the input side.
@@ -226,7 +234,10 @@ export class Highlighter {
     }
   }
 
-  /** Draw the highlight on the left side of the block. */
+  /**
+   * Draw the highlight on the left side of the block.
+   * @internal
+   */
   drawLeft() {
     const outputConnection = this.info_.outputConnection;
     if (outputConnection) {
@@ -259,6 +270,7 @@ export class Highlighter {
   /**
    * Add a highlight to an inline input.
    * @param input The input to highlight.
+   * @internal
    */
   drawInlineInput(input: InlineInput) {
     const offset = this.highlightOffset_;

core/renderers/geras/info.ts

@@ -61,6 +61,7 @@ export class RenderInfo extends BaseRenderInfo {
   /**
    * @param renderer The renderer in use.
    * @param block The block to measure.
+   * @internal
    */
   constructor(renderer: Renderer, block: BlockSvg) {
     super(renderer, block);
@@ -70,6 +71,7 @@ export class RenderInfo extends BaseRenderInfo {
   /**
    * Get the block renderer in use.
    * @return The block renderer in use.
+   * @internal
    */
   override getRenderer(): Renderer {
     return this.renderer;

core/renderers/geras/measurables/inline_input.ts

@@ -37,6 +37,7 @@ export class InlineInput extends BaseInlineInput {
   /**
    * @param constants The rendering constants provider.
    * @param input The inline input to measure and store information for.
+   * @internal
    */
   constructor(constants: BaseConstantProvider, input: Input) {
     super(constants, input);

core/renderers/geras/measurables/statement_input.ts

@@ -37,6 +37,7 @@ export class StatementInput extends BaseStatementInput {
   /**
    * @param constants The rendering constants provider.
    * @param input The statement input to measure and store information for.
+   * @internal
    */
   constructor(constants: BaseConstantProvider, input: Input) {
     super(constants, input);

core/renderers/geras/path_object.ts

@@ -36,10 +36,15 @@ import {ConstantProvider} from './constants.js';
  * @alias Blockly.geras.PathObject
  */
 export class PathObject extends BasePathObject {
+  /** @internal */
   svgPathDark: SVGElement;
+  /** @internal */
   svgPathLight: SVGElement;
 
-  /** The colour of the dark path on the block in '#RRGGBB' format. */
+  /**
+   * The colour of the dark path on the block in '#RRGGBB' format.
+   * @internal
+   */
   colourDark = '#000000';
   override style: AnyDuringMigration;
 
@@ -47,6 +52,7 @@ export class PathObject extends BasePathObject {
    * @param root The root SVG element.
    * @param style The style object to use for colouring.
    * @param constants The renderer's constants.
+   * @internal
    */
   constructor(
       root: SVGElement, style: BlockStyle,
@@ -74,6 +80,7 @@ export class PathObject extends BasePathObject {
   /**
    * Set the highlight path generated by the renderer onto the SVG element.
    * @param highlightPath The highlight path.
+   * @internal
    */
   setHighlightPath(highlightPath: string) {
     this.svgPathLight.setAttribute('d', highlightPath);

core/renderers/geras/renderer.ts

@@ -45,7 +45,10 @@ export class Renderer extends BaseRenderer {
   private highlightConstants_: HighlightConstantProvider =
       null as AnyDuringMigration;
 
-  /** @param name The renderer name. */
+  /**
+   * @param name The renderer name.
+   * @internal
+   */
   constructor(name: string) {
     super(name);
   }
@@ -53,6 +56,7 @@ export class Renderer extends BaseRenderer {
   /**
    * Initialize the renderer.  Geras has a highlight provider in addition to
    * the normal constant provider.
+   * @internal
    */
   override init(theme: Theme, opt_rendererOverrides: AnyDuringMigration) {
     super.init(theme, opt_rendererOverrides);
@@ -95,6 +99,7 @@ export class Renderer extends BaseRenderer {
    * @param root The root SVG element.
    * @param style The style object to use for colouring.
    * @return The renderer path object.
+   * @internal
    */
   override makePathObject(root: SVGElement, style: BlockStyle): PathObject {
     return new PathObject(
@@ -113,6 +118,7 @@ export class Renderer extends BaseRenderer {
    * Get the renderer's highlight constant provider.  We assume that when this
    * is called, the renderer has already been initialized.
    * @return The highlight constant provider.
+   * @internal
    */
   getHighlightConstants(): HighlightConstantProvider {
     return this.highlightConstants_;

core/renderers/measurables/base.ts

@@ -37,7 +37,10 @@ export class Measurable {
   centerline = 0;
   notchOffset: number;
 
-  /** @param constants The rendering constants provider. */
+  /**
+   * @param constants The rendering constants provider.
+   * @internal
+   */
   constructor(protected readonly constants: ConstantProvider) {
     this.type = Types.NONE;
 

core/renderers/measurables/bottom_row.ts

@@ -37,16 +37,23 @@ import {Types} from './types.js';
  * @alias Blockly.blockRendering.BottomRow
  */
 export class BottomRow extends Row {
-  /** Whether this row has a next connection. */
+  /**
+   * Whether this row has a next connection.
+   * @internal
+   */
   hasNextConnection = false;
 
-  /** The next connection on the row, if any. */
+  /**
+   * The next connection on the row, if any.
+   * @internal
+   */
   connection: NextConnection|null = null;
 
   /**
    * The amount that the bottom of the block extends below the horizontal
    * edge, e.g. because of a next connection.  Must be non-negative (see
    * #2820).
+   * @internal
    */
   descenderHeight = 0;
 
@@ -56,7 +63,10 @@ export class BottomRow extends Row {
    */
   baseline = 0;
 
-  /** @param constants The rendering constants provider. */
+  /**
+   * @param constants The rendering constants provider.
+   * @internal
+   */
   constructor(constants: ConstantProvider) {
     super(constants);
     this.type |= Types.BOTTOM_ROW;

core/renderers/measurables/connection.ts

@@ -39,6 +39,7 @@ export class Connection extends Measurable {
    * @param constants The rendering constants provider.
    * @param connectionModel The connection object on the block that this
    *     represents.
+   * @internal
    */
   constructor(
       constants: ConstantProvider, public connectionModel: RenderedConnection) {

core/renderers/measurables/external_value_input.ts

@@ -42,6 +42,7 @@ export class ExternalValueInput extends InputConnection {
   /**
    * @param constants The rendering constants provider.
    * @param input The external value input to measure and store information for.
+   * @internal
    */
   constructor(constants: ConstantProvider, input: Input) {
     super(constants, input);

core/renderers/measurables/field.ts

@@ -44,6 +44,7 @@ export class Field extends Measurable {
    * @param constants The rendering constants provider.
    * @param field The field to measure and store information for.
    * @param parentInput The parent input for the field.
+   * @internal
    */
   constructor(
       constants: ConstantProvider, public field: BlocklyField,

core/renderers/measurables/hat.ts

@@ -33,7 +33,10 @@ import {Types} from './types.js';
 export class Hat extends Measurable {
   ascenderHeight: number;
 
-  /** @param constants The rendering constants provider. */
+  /**
+   * @param constants The rendering constants provider.
+   * @internal
+   */
   constructor(constants: ConstantProvider) {
     super(constants);
     this.type |= Types.HAT;

core/renderers/measurables/icon.ts

@@ -40,6 +40,7 @@ export class Icon extends Measurable {
    * rendering
    * @param constants The rendering constants provider.
    * @param icon The icon to measure and store information for.
+   * @internal
    */
   constructor(constants: ConstantProvider, public icon: BlocklyIcon) {
     super(constants);

core/renderers/measurables/in_row_spacer.ts

@@ -34,6 +34,7 @@ export class InRowSpacer extends Measurable {
   /**
    * @param constants The rendering constants provider.
    * @param width The width of the spacer.
+   * @internal
    */
   constructor(constants: ConstantProvider, width: number) {
     super(constants);

core/renderers/measurables/inline_input.ts

@@ -39,6 +39,7 @@ export class InlineInput extends InputConnection {
   /**
    * @param constants The rendering constants provider.
    * @param input The inline input to measure and store information for.
+   * @internal
    */
   constructor(constants: ConstantProvider, input: Input) {
     super(constants, input);

core/renderers/measurables/input_connection.ts

@@ -44,6 +44,7 @@ export class InputConnection extends Connection {
   /**
    * @param constants The rendering constants provider.
    * @param input The input to measure and store information for.
+   * @internal
    */
   constructor(constants: ConstantProvider, public input: Input) {
     super(constants, input.connection as RenderedConnection);

core/renderers/measurables/input_row.ts

@@ -33,10 +33,16 @@ import {Types} from './types.js';
  * @alias Blockly.blockRendering.InputRow
  */
 export class InputRow extends Row {
-  /** The total width of all blocks connected to this row. */
+  /**
+   * The total width of all blocks connected to this row.
+   * @internal
+   */
   connectedBlockWidths = 0;
 
-  /** @param constants The rendering constants provider. */
+  /**
+   * @param constants The rendering constants provider.
+   * @internal
+   */
   constructor(constants: ConstantProvider) {
     super(constants);
     this.type |= Types.INPUT_ROW;
@@ -44,6 +50,7 @@ export class InputRow extends Row {
 
   /**
    * Inspect all subcomponents and populate all size properties on the row.
+   * @internal
    */
   override measure() {
     this.width = this.minWidth;

core/renderers/measurables/jagged_edge.ts

@@ -31,7 +31,10 @@ import {Types} from './types.js';
  * @alias Blockly.blockRendering.JaggedEdge
  */
 export class JaggedEdge extends Measurable {
-  /** @param constants The rendering constants provider. */
+  /**
+   * @param constants The rendering constants provider.
+   * @internal
+   */
   constructor(constants: ConstantProvider) {
     super(constants);
     this.type |= Types.JAGGED_EDGE;

core/renderers/measurables/next_connection.ts

@@ -37,6 +37,7 @@ export class NextConnection extends Connection {
    * @param constants The rendering constants provider.
    * @param connectionModel The connection object on the block that this
    *     represents.
+   * @internal
    */
   constructor(
       constants: ConstantProvider, connectionModel: RenderedConnection) {

core/renderers/measurables/output_connection.ts

@@ -41,6 +41,7 @@ export class OutputConnection extends Connection {
    * @param constants The rendering constants provider.
    * @param connectionModel The connection object on the block that this
    *     represents.
+   * @internal
    */
   constructor(
       constants: ConstantProvider, connectionModel: RenderedConnection) {

core/renderers/measurables/previous_connection.ts

@@ -37,6 +37,7 @@ export class PreviousConnection extends Connection {
    * @param constants The rendering constants provider.
    * @param connectionModel The connection object on the block that this
    *     represents.
+   * @internal
    */
   constructor(
       constants: ConstantProvider, connectionModel: RenderedConnection) {

core/renderers/measurables/round_corner.ts

@@ -34,6 +34,7 @@ export class RoundCorner extends Measurable {
   /**
    * @param constants The rendering constants provider.
    * @param opt_position The position of this corner.
+   * @internal
    */
   constructor(constants: ConstantProvider, opt_position?: string) {
     super(constants);

core/renderers/measurables/row.ts

@@ -33,51 +33,72 @@ import {Types} from './types.js';
  * @alias Blockly.blockRendering.Row
  */
 export class Row {
+  /** @internal */
   type: number;
 
-  /** An array of elements contained in this row. */
+  /**
+   * An array of elements contained in this row.
+   * @internal
+   */
   elements: Measurable[] = [];
 
-  /** The height of the row. */
+  /**
+   * The height of the row.
+   * @internal
+   */
   height = 0;
 
   /**
    * The width of the row, from the left edge of the block to the right.
    * Does not include child blocks unless they are inline.
+   * @internal
    */
   width = 0;
 
-  /** The minimum height of the row. */
+  /**
+   * The minimum height of the row.
+   * @internal
+   */
   minHeight = 0;
 
   /**
    * The minimum width of the row, from the left edge of the block to the
    * right. Does not include child blocks unless they are inline.
+   * @internal
    */
   minWidth = 0;
 
   /**
    * The width of the row, from the left edge of the block to the edge of the
    * block or any connected child blocks.
+   * @internal
    */
   widthWithConnectedBlocks = 0;
 
   /**
    * The Y position of the row relative to the origin of the block's svg
    * group.
+   * @internal
    */
   yPos = 0;
 
   /**
    * The X position of the row relative to the origin of the block's svg
    * group.
+   * @internal
    */
   xPos = 0;
 
-  /** Whether the row has any external inputs. */
+  /**
+   * Whether the row has any external inputs.
+   * @internal
+   */
   hasExternalInput = false;
 
-  /** Whether the row has any statement inputs. */
+  /**
+   * Whether the row has any statement inputs.
+   * @internal
+   */
   hasStatement = false;
 
   /**
@@ -87,20 +108,35 @@ export class Row {
    */
   statementEdge = 0;
 
-  /** Whether the row has any inline inputs. */
+  /**
+   * Whether the row has any inline inputs.
+   * @internal
+   */
   hasInlineInput = false;
 
-  /** Whether the row has any dummy inputs. */
+  /**
+   * Whether the row has any dummy inputs.
+   * @internal
+   */
   hasDummyInput = false;
 
-  /** Whether the row has a jagged edge. */
+  /**
+   * Whether the row has a jagged edge.
+   * @internal
+   */
   hasJaggedEdge = false;
   notchOffset: number;
 
-  /** Alignment of the row. */
+  /**
+   * Alignment of the row.
+   * @internal
+   */
   align: number|null = null;
 
-  /** @param constants_ The rendering constants provider. */
+  /**
+   * @param constants_ The rendering constants provider.
+   * @internal
+   */
   constructor(protected readonly constants_: ConstantProvider) {
     /** The type of this rendering object. */
     this.type = Types.ROW;
@@ -111,6 +147,7 @@ export class Row {
   /**
    * Get the last input on this row, if it has one.
    * @return The last input on the row, or null.
+   * @internal
    */
   getLastInput(): InputConnection {
     // TODO: Consider moving this to InputRow, if possible.
@@ -127,6 +164,7 @@ export class Row {
 
   /**
    * Inspect all subcomponents and populate all size properties on the row.
+   * @internal
    */
   measure() {
     throw Error('Unexpected attempt to measure a base Row.');
@@ -135,6 +173,7 @@ export class Row {
   /**
    * Determines whether this row should start with an element spacer.
    * @return Whether the row should start with a spacer.
+   * @internal
    */
   startsWithElemSpacer(): boolean {
     return true;
@@ -143,6 +182,7 @@ export class Row {
   /**
    * Determines whether this row should end with an element spacer.
    * @return Whether the row should end with a spacer.
+   * @internal
    */
   endsWithElemSpacer(): boolean {
     return true;
@@ -151,6 +191,7 @@ export class Row {
   /**
    * Convenience method to get the first spacer element on this row.
    * @return The first spacer element on this row.
+   * @internal
    */
   getFirstSpacer(): InRowSpacer {
     for (let i = 0; i < this.elements.length; i++) {
@@ -167,6 +208,7 @@ export class Row {
   /**
    * Convenience method to get the last spacer element on this row.
    * @return The last spacer element on this row.
+   * @internal
    */
   getLastSpacer(): InRowSpacer {
     for (let i = this.elements.length - 1; i >= 0; i--) {

core/renderers/measurables/spacer_row.ts

@@ -40,6 +40,7 @@ export class SpacerRow extends Row {
    * @param constants The rendering constants provider.
    * @param height The height of the spacer.
    * @param width The width of the spacer.
+   * @internal
    */
   constructor(
       constants: ConstantProvider, public override height: number,

core/renderers/measurables/square_corner.ts

@@ -34,6 +34,7 @@ export class SquareCorner extends Measurable {
   /**
    * @param constants The rendering constants provider.
    * @param opt_position The position of this corner.
+   * @internal
    */
   constructor(constants: ConstantProvider, opt_position?: string) {
     super(constants);

core/renderers/measurables/statement_input.ts

@@ -36,6 +36,7 @@ export class StatementInput extends InputConnection {
   /**
    * @param constants The rendering constants provider.
    * @param input The statement input to measure and store information for.
+   * @internal
    */
   constructor(constants: ConstantProvider, input: Input) {
     super(constants, input);

core/renderers/measurables/top_row.ts

@@ -42,6 +42,7 @@ export class TopRow extends Row {
    * The starting point for drawing the row, in the y direction.
    * This allows us to draw hats and similar shapes that don't start at the
    * origin. Must be non-negative (see #2820).
+   * @internal
    */
   capline = 0;
 
@@ -55,7 +56,10 @@ export class TopRow extends Row {
   connection: PreviousConnection|null = null;
   override widthWithConnectedBlocks: AnyDuringMigration;
 
-  /** @param constants The rendering constants provider. */
+  /**
+   * @param constants The rendering constants provider.
+   * @internal
+   */
   constructor(constants: ConstantProvider) {
     super(constants);
 
@@ -66,6 +70,7 @@ export class TopRow extends Row {
    * Returns whether or not the top row has a left square corner.
    * @param block The block whose top row this represents.
    * @return Whether or not the top row has a left square corner.
+   * @internal
    */
   hasLeftSquareCorner(block: BlockSvg): boolean {
     const hasHat =

core/renderers/measurables/types.ts

@@ -79,10 +79,16 @@ class TypesContainer {
   INPUT_ROW = 1 << 23;
 
   // Input Row.
-  /** A Left Corner Union Type. */
+  /**
+   * A Left Corner Union Type.
+   * @internal
+   */
   LEFT_CORNER = this.LEFT_SQUARE_CORNER | this.LEFT_ROUND_CORNER;
 
-  /** A Right Corner Union Type. */
+  /**
+   * A Right Corner Union Type.
+   * @internal
+   */
   RIGHT_CORNER = this.RIGHT_SQUARE_CORNER | this.RIGHT_ROUND_CORNER;
 
   /**
@@ -97,6 +103,7 @@ class TypesContainer {
    * Get the enum flag value of an existing type or register a new type.
    * @param type The name of the type.
    * @return The enum flag value associated with that type.
+   * @internal
    */
   getType(type: string): number {
     if (!Object.prototype.hasOwnProperty.call(this, type)) {
@@ -110,6 +117,7 @@ class TypesContainer {
    * Whether a measurable stores information about a field.
    * @param elem The element to check.
    * @return 1 if the object stores information about a field.
+   * @internal
    */
   isField(elem: Measurable): number {
     return elem.type & this.FIELD;
@@ -119,6 +127,7 @@ class TypesContainer {
    * Whether a measurable stores information about a hat.
    * @param elem The element to check.
    * @return 1 if the object stores information about a hat.
+   * @internal
    */
   isHat(elem: Measurable): number {
     return elem.type & this.HAT;
@@ -128,6 +137,7 @@ class TypesContainer {
    * Whether a measurable stores information about an icon.
    * @param elem The element to check.
    * @return 1 if the object stores information about an icon.
+   * @internal
    */
   isIcon(elem: Measurable): number {
     return elem.type & this.ICON;
@@ -137,6 +147,7 @@ class TypesContainer {
    * Whether a measurable stores information about a spacer.
    * @param elem The element to check.
    * @return 1 if the object stores information about a spacer.
+   * @internal
    */
   isSpacer(elem: Measurable|Row): number {
     return elem.type & this.SPACER;
@@ -146,6 +157,7 @@ class TypesContainer {
    * Whether a measurable stores information about an in-row spacer.
    * @param elem The element to check.
    * @return 1 if the object stores information about an in-row spacer.
+   * @internal
    */
   isInRowSpacer(elem: Measurable): number {
     return elem.type & this.IN_ROW_SPACER;
@@ -155,6 +167,7 @@ class TypesContainer {
    * Whether a measurable stores information about an input.
    * @param elem The element to check.
    * @return 1 if the object stores information about an input.
+   * @internal
    */
   isInput(elem: Measurable): number {
     return elem.type & this.INPUT;
@@ -164,6 +177,7 @@ class TypesContainer {
    * Whether a measurable stores information about an external input.
    * @param elem The element to check.
    * @return 1 if the object stores information about an external input.
+   * @internal
    */
   isExternalInput(elem: Measurable): number {
     return elem.type & this.EXTERNAL_VALUE_INPUT;
@@ -173,6 +187,7 @@ class TypesContainer {
    * Whether a measurable stores information about an inline input.
    * @param elem The element to check.
    * @return 1 if the object stores information about an inline input.
+   * @internal
    */
   isInlineInput(elem: Measurable): number {
     return elem.type & this.INLINE_INPUT;
@@ -182,6 +197,7 @@ class TypesContainer {
    * Whether a measurable stores information about a statement input.
    * @param elem The element to check.
    * @return 1 if the object stores information about a statement input.
+   * @internal
    */
   isStatementInput(elem: Measurable): number {
     return elem.type & this.STATEMENT_INPUT;
@@ -191,6 +207,7 @@ class TypesContainer {
    * Whether a measurable stores information about a previous connection.
    * @param elem The element to check.
    * @return 1 if the object stores information about a previous connection.
+   * @internal
    */
   isPreviousConnection(elem: Measurable): number {
     return elem.type & this.PREVIOUS_CONNECTION;
@@ -200,6 +217,7 @@ class TypesContainer {
    * Whether a measurable stores information about a next connection.
    * @param elem The element to check.
    * @return 1 if the object stores information about a next connection.
+   * @internal
    */
   isNextConnection(elem: Measurable): number {
     return elem.type & this.NEXT_CONNECTION;
@@ -211,6 +229,7 @@ class TypesContainer {
    * @param elem The element to check.
    * @return 1 if the object stores information about a previous or next
    *     connection.
+   * @internal
    */
   isPreviousOrNextConnection(elem: Measurable): number {
     return elem.type & (this.PREVIOUS_CONNECTION | this.NEXT_CONNECTION);
@@ -220,6 +239,7 @@ class TypesContainer {
    * Whether a measurable stores information about a left round corner.
    * @param elem The element to check.
    * @return 1 if the object stores information about a left round corner.
+   * @internal
    */
   isLeftRoundedCorner(elem: Measurable): number {
     return elem.type & this.LEFT_ROUND_CORNER;
@@ -229,6 +249,7 @@ class TypesContainer {
    * Whether a measurable stores information about a right round corner.
    * @param elem The element to check.
    * @return 1 if the object stores information about a right round corner.
+   * @internal
    */
   isRightRoundedCorner(elem: Measurable): number {
     return elem.type & this.RIGHT_ROUND_CORNER;
@@ -238,6 +259,7 @@ class TypesContainer {
    * Whether a measurable stores information about a left square corner.
    * @param elem The element to check.
    * @return 1 if the object stores information about a left square corner.
+   * @internal
    */
   isLeftSquareCorner(elem: Measurable): number {
     return elem.type & this.LEFT_SQUARE_CORNER;
@@ -247,6 +269,7 @@ class TypesContainer {
    * Whether a measurable stores information about a right square corner.
    * @param elem The element to check.
    * @return 1 if the object stores information about a right square corner.
+   * @internal
    */
   isRightSquareCorner(elem: Measurable): number {
     return elem.type & this.RIGHT_SQUARE_CORNER;
@@ -256,6 +279,7 @@ class TypesContainer {
    * Whether a measurable stores information about a corner.
    * @param elem The element to check.
    * @return 1 if the object stores information about a corner.
+   * @internal
    */
   isCorner(elem: Measurable): number {
     return elem.type & this.CORNER;
@@ -265,6 +289,7 @@ class TypesContainer {
    * Whether a measurable stores information about a jagged edge.
    * @param elem The element to check.
    * @return 1 if the object stores information about a jagged edge.
+   * @internal
    */
   isJaggedEdge(elem: Measurable): number {
     return elem.type & this.JAGGED_EDGE;
@@ -274,6 +299,7 @@ class TypesContainer {
    * Whether a measurable stores information about a row.
    * @param row The row to check.
    * @return 1 if the object stores information about a row.
+   * @internal
    */
   isRow(row: Row): number {
     return row.type & this.ROW;
@@ -283,6 +309,7 @@ class TypesContainer {
    * Whether a measurable stores information about a between-row spacer.
    * @param row The row to check.
    * @return 1 if the object stores information about a between-row spacer.
+   * @internal
    */
   isBetweenRowSpacer(row: Row): number {
     return row.type & this.BETWEEN_ROW_SPACER;
@@ -292,6 +319,7 @@ class TypesContainer {
    * Whether a measurable stores information about a top row.
    * @param row The row to check.
    * @return 1 if the object stores information about a top row.
+   * @internal
    */
   isTopRow(row: Row): number {
     return row.type & this.TOP_ROW;
@@ -301,6 +329,7 @@ class TypesContainer {
    * Whether a measurable stores information about a bottom row.
    * @param row The row to check.
    * @return 1 if the object stores information about a bottom row.
+   * @internal
    */
   isBottomRow(row: Row): number {
     return row.type & this.BOTTOM_ROW;
@@ -310,6 +339,7 @@ class TypesContainer {
    * Whether a measurable stores information about a top or bottom row.
    * @param row The row to check.
    * @return 1 if the object stores information about a top or bottom row.
+   * @internal
    */
   isTopOrBottomRow(row: Row): number {
     return row.type & (this.TOP_ROW | this.BOTTOM_ROW);
@@ -319,6 +349,7 @@ class TypesContainer {
    * Whether a measurable stores information about an input row.
    * @param row The row to check.
    * @return 1 if the object stores information about an input row.
+   * @internal
    */
   isInputRow(row: Row): number {
     return row.type & this.INPUT_ROW;

core/renderers/minimalist/constants.ts

@@ -25,6 +25,7 @@ import {ConstantProvider as BaseConstantProvider} from '../common/constants.js';
  * @alias Blockly.minimalist.ConstantProvider
  */
 export class ConstantProvider extends BaseConstantProvider {
+  /** @internal */
   constructor() {
     super();
   }

core/renderers/minimalist/drawer.ts

@@ -32,6 +32,7 @@ export class Drawer extends BaseDrawer {
    * @param block The block to render.
    * @param info An object containing all information needed to render this
    *     block.
+   * @internal
    */
   constructor(block: BlockSvg, info: RenderInfo) {
     super(block, info);

core/renderers/minimalist/info.ts

@@ -35,6 +35,7 @@ export class RenderInfo extends BaseRenderInfo {
   /**
    * @param renderer The renderer in use.
    * @param block The block to measure.
+   * @internal
    */
   constructor(renderer: Renderer, block: BlockSvg) {
     super(renderer, block);
@@ -43,6 +44,7 @@ export class RenderInfo extends BaseRenderInfo {
   /**
    * Get the block renderer in use.
    * @return The block renderer in use.
+   * @internal
    */
   override getRenderer(): Renderer {
     // AnyDuringMigration because:  Property 'renderer_' does not exist on type

core/renderers/minimalist/renderer.ts

@@ -32,7 +32,10 @@ import {RenderInfo} from './info.js';
  * @alias Blockly.minimalist.Renderer
  */
 export class Renderer extends BaseRenderer {
-  /** @param name The renderer name. */
+  /**
+   * @param name The renderer name.
+   * @internal
+   */
   constructor(name: string) {
     super(name);
   }

core/renderers/thrasos/info.ts

@@ -51,6 +51,7 @@ export class RenderInfo extends BaseRenderInfo {
   /**
    * @param renderer The renderer in use.
    * @param block The block to measure.
+   * @internal
    */
   constructor(renderer: Renderer, block: BlockSvg) {
     super(renderer, block);
@@ -59,6 +60,7 @@ export class RenderInfo extends BaseRenderInfo {
   /**
    * Get the block renderer in use.
    * @return The block renderer in use.
+   * @internal
    */
   override getRenderer(): Renderer {
     // AnyDuringMigration because:  Property 'renderer_' does not exist on type

core/renderers/thrasos/renderer.ts

@@ -28,7 +28,10 @@ import {RenderInfo} from './info.js';
  * @alias Blockly.thrasos.Renderer
  */
 export class Renderer extends BaseRenderer {
-  /** @param name The renderer name. */
+  /**
+   * @param name The renderer name.
+   * @internal
+   */
   constructor(name: string) {
     super(name);
   }