diff --git a/core/block.ts b/core/block.ts index 14b34972e..d9d0455e2 100644 --- a/core/block.ts +++ b/core/block.ts @@ -50,8 +50,6 @@ import type {Workspace} from './workspace.js'; /** * Class for one block. * Not normally called directly, workspace.newBlock() is preferred. - * - * @alias Blockly.Block */ export class Block implements IASTNodeLocation, IDeletable { /** diff --git a/core/block_animations.ts b/core/block_animations.ts index 9b2d6d0bd..d9d0c5bef 100644 --- a/core/block_animations.ts +++ b/core/block_animations.ts @@ -36,7 +36,6 @@ let wobblingBlock: BlockSvg|null = null; * 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) { @@ -88,7 +87,6 @@ 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) { @@ -145,7 +143,6 @@ 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) { @@ -196,7 +193,6 @@ function disconnectUiStep(block: BlockSvg, magnitude: number, start: Date) { /** * Stop the disconnect UI animation immediately. * - * @alias Blockly.blockAnimations.disconnectUiStop * @internal */ export function disconnectUiStop() { diff --git a/core/block_dragger.ts b/core/block_dragger.ts index 7673baf8b..4cd3d1b0a 100644 --- a/core/block_dragger.ts +++ b/core/block_dragger.ts @@ -34,8 +34,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; /** * Class for a block dragger. It moves blocks around the workspace when they * are being dragged by a mouse or touch. - * - * @alias Blockly.BlockDragger */ export class BlockDragger implements IBlockDragger { /** The top block in the stack that is being dragged. */ diff --git a/core/block_svg.ts b/core/block_svg.ts index 789a76177..6d84c6d3f 100644 --- a/core/block_svg.ts +++ b/core/block_svg.ts @@ -61,8 +61,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; /** * Class for a block's SVG representation. * Not normally called directly, workspace.newBlock() is preferred. - * - * @alias Blockly.BlockSvg */ export class BlockSvg extends Block implements IASTNodeLocationSvg, IBoundedElement, ICopyable, diff --git a/core/blockly.ts b/core/blockly.ts index c91d23294..ab81e516e 100644 --- a/core/blockly.ts +++ b/core/blockly.ts @@ -175,7 +175,6 @@ import {ZoomControls} from './zoom_controls.js'; * compiler to override this constant. * * @define {string} - * @alias Blockly.VERSION */ export const VERSION = 'uncompiled'; @@ -193,19 +192,16 @@ export const VERSION = 'uncompiled'; /** * @see Blockly.Input.Align.LEFT - * @alias Blockly.ALIGN_LEFT */ export const ALIGN_LEFT = Align.LEFT; /** * @see Blockly.Input.Align.CENTRE - * @alias Blockly.ALIGN_CENTRE */ export const ALIGN_CENTRE = Align.CENTRE; /** * @see Blockly.Input.Align.RIGHT - * @alias Blockly.ALIGN_RIGHT */ export const ALIGN_RIGHT = Align.RIGHT; /* @@ -214,31 +210,26 @@ export const ALIGN_RIGHT = Align.RIGHT; /** * @see ConnectionType.INPUT_VALUE - * @alias Blockly.INPUT_VALUE */ export const INPUT_VALUE = ConnectionType.INPUT_VALUE; /** * @see ConnectionType.OUTPUT_VALUE - * @alias Blockly.OUTPUT_VALUE */ export const OUTPUT_VALUE = ConnectionType.OUTPUT_VALUE; /** * @see ConnectionType.NEXT_STATEMENT - * @alias Blockly.NEXT_STATEMENT */ export const NEXT_STATEMENT = ConnectionType.NEXT_STATEMENT; /** * @see ConnectionType.PREVIOUS_STATEMENT - * @alias Blockly.PREVIOUS_STATEMENT */ export const PREVIOUS_STATEMENT = ConnectionType.PREVIOUS_STATEMENT; /** * @see inputTypes.DUMMY_INPUT - * @alias Blockly.DUMMY_INPUT */ export const DUMMY_INPUT = inputTypes.DUMMY; @@ -246,25 +237,21 @@ export const DUMMY_INPUT = inputTypes.DUMMY; /** * @see toolbox.Position.TOP - * @alias Blockly.TOOLBOX_AT_TOP */ export const TOOLBOX_AT_TOP = toolbox.Position.TOP; /** * @see toolbox.Position.BOTTOM - * @alias Blockly.TOOLBOX_AT_BOTTOM */ export const TOOLBOX_AT_BOTTOM = toolbox.Position.BOTTOM; /** * @see toolbox.Position.LEFT - * @alias Blockly.TOOLBOX_AT_LEFT */ export const TOOLBOX_AT_LEFT = toolbox.Position.LEFT; /** * @see toolbox.Position.RIGHT - * @alias Blockly.TOOLBOX_AT_RIGHT */ export const TOOLBOX_AT_RIGHT = toolbox.Position.RIGHT; @@ -281,7 +268,6 @@ export const TOOLBOX_AT_RIGHT = toolbox.Position.RIGHT; * * @param workspace Any workspace in the SVG. * @see Blockly.common.svgResize - * @alias Blockly.svgResize */ export const svgResize = common.svgResize; @@ -290,7 +276,6 @@ export const svgResize = common.svgResize; * * @param opt_onlyClosePopups Whether only popups should be closed. * @see Blockly.WorkspaceSvg.hideChaff - * @alias Blockly.hideChaff */ export function hideChaff(opt_onlyClosePopups?: boolean) { (common.getMainWorkspace() as WorkspaceSvg).hideChaff(opt_onlyClosePopups); @@ -302,14 +287,11 @@ export function hideChaff(opt_onlyClosePopups?: boolean) { * Blockly instances on a page. * * @see Blockly.common.getMainWorkspace - * @alias Blockly.getMainWorkspace */ export const getMainWorkspace = common.getMainWorkspace; /** * Returns the currently selected copyable object. - * - * @alias Blockly.common.getSelected */ export const getSelected = common.getSelected; @@ -319,7 +301,6 @@ export const getSelected = common.getSelected; * * @param jsonArray An array of JSON block definitions. * @see Blockly.common.defineBlocksWithJsonArray - * @alias Blockly.defineBlocksWithJsonArray */ export const defineBlocksWithJsonArray = common.defineBlocksWithJsonArray; @@ -331,7 +312,6 @@ export const defineBlocksWithJsonArray = common.defineBlocksWithJsonArray; * * @param container The container element. * @see Blockly.common.setParentContainer - * @alias Blockly.setParentContainer */ export const setParentContainer = common.setParentContainer; @@ -342,7 +322,6 @@ export const setParentContainer = common.setParentContainer; * @param workspace The workspace to resize. * @deprecated Use **workspace.resizeContents** instead. * @see Blockly.WorkspaceSvg.resizeContents - * @alias Blockly.resizeSvgContents */ function resizeSvgContentsLocal(workspace: WorkspaceSvg) { deprecation.warn( @@ -358,7 +337,6 @@ export const resizeSvgContents = resizeSvgContentsLocal; * @param toCopy Block or Workspace Comment to be copied. * @deprecated Use **Blockly.clipboard.copy** instead. * @see Blockly.clipboard.copy - * @alias Blockly.copy */ export function copy(toCopy: ICopyable) { deprecation.warn( @@ -373,7 +351,6 @@ export function copy(toCopy: ICopyable) { * @returns True if the paste was successful, false otherwise. * @deprecated Use **Blockly.clipboard.paste** instead. * @see Blockly.clipboard.paste - * @alias Blockly.paste */ export function paste(): boolean { deprecation.warn( @@ -388,7 +365,6 @@ export function paste(): boolean { * @param toDuplicate Block or Workspace Comment to be copied. * @deprecated Use **Blockly.clipboard.duplicate** instead. * @see Blockly.clipboard.duplicate - * @alias Blockly.duplicate */ export function duplicate(toDuplicate: ICopyable) { deprecation.warn( @@ -404,7 +380,6 @@ export function duplicate(toDuplicate: ICopyable) { * @returns True if number, false otherwise. * @deprecated Use **Blockly.utils.string.isNumber** instead. * @see Blockly.utils.string.isNumber - * @alias Blockly.isNumber */ export function isNumber(str: string): boolean { deprecation.warn( @@ -420,7 +395,6 @@ export function isNumber(str: string): boolean { * @returns RGB code, e.g. '#5ba65b'. * @deprecated Use **Blockly.utils.colour.hueToHex** instead. * @see Blockly.utils.colour.hueToHex - * @alias Blockly.hueToHex */ export function hueToHex(hue: number): string { deprecation.warn( @@ -442,7 +416,6 @@ export function hueToHex(hue: number): string { * @returns Opaque data that can be passed to unbindEvent_. * @deprecated Use **Blockly.browserEvents.bind** instead. * @see Blockly.browserEvents.bind - * @alias Blockly.bindEvent_ */ export function bindEvent_( node: EventTarget, name: string, thisObject: Object|null, @@ -461,7 +434,6 @@ export function bindEvent_( * @returns The function call. * @deprecated Use **Blockly.browserEvents.unbind** instead. * @see browserEvents.unbind - * @alias Blockly.unbindEvent_ */ export function unbindEvent_(bindData: browserEvents.Data): Function { deprecation.warn( @@ -487,7 +459,6 @@ export function unbindEvent_(bindData: browserEvents.Data): Function { * @returns Opaque data that can be passed to unbindEvent_. * @deprecated Use **Blockly.browserEvents.conditionalBind** instead. * @see browserEvents.conditionalBind - * @alias Blockly.bindEventWithChecks_ */ export function bindEventWithChecks_( node: EventTarget, name: string, thisObject: Object|null, func: Function, @@ -513,8 +484,6 @@ export const COLLAPSED_FIELD_NAME = constants.COLLAPSED_FIELD_NAME; * String for use in the "custom" attribute of a category in toolbox XML. * This string indicates that the category should be dynamically populated with * variable blocks. - * - * @alias Blockly.VARIABLE_CATEGORY_NAME */ export const VARIABLE_CATEGORY_NAME: string = Variables.CATEGORY_NAME; @@ -522,8 +491,6 @@ export const VARIABLE_CATEGORY_NAME: string = Variables.CATEGORY_NAME; * String for use in the "custom" attribute of a category in toolbox XML. * This string indicates that the category should be dynamically populated with * variable blocks. - * - * @alias Blockly.VARIABLE_DYNAMIC_CATEGORY_NAME */ export const VARIABLE_DYNAMIC_CATEGORY_NAME: string = VariablesDynamic.CATEGORY_NAME; @@ -531,8 +498,6 @@ export const VARIABLE_DYNAMIC_CATEGORY_NAME: string = * String for use in the "custom" attribute of a category in toolbox XML. * This string indicates that the category should be dynamically populated with * procedure blocks. - * - * @alias Blockly.PROCEDURE_CATEGORY_NAME */ export const PROCEDURE_CATEGORY_NAME: string = Procedures.CATEGORY_NAME; diff --git a/core/blockly_options.ts b/core/blockly_options.ts index 8933bd637..6741def18 100644 --- a/core/blockly_options.ts +++ b/core/blockly_options.ts @@ -19,8 +19,6 @@ import type {ToolboxDefinition} from './utils/toolbox.js'; /** * Blockly options. - * - * @alias Blockly.BlocklyOptions */ export interface BlocklyOptions { collapse?: boolean; diff --git a/core/blocks.ts b/core/blocks.ts index cb3348c74..9d9466b7e 100644 --- a/core/blocks.ts +++ b/core/blocks.ts @@ -21,7 +21,5 @@ export type BlockDefinition = AnyDuringMigration; /** * A mapping of block type names to block prototype objects. - * - * @alias Blockly.blocks.Blocks */ export const Blocks: {[key: string]: BlockDefinition} = Object.create(null); diff --git a/core/browser_events.ts b/core/browser_events.ts index a36c7e537..c87655bda 100644 --- a/core/browser_events.ts +++ b/core/browser_events.ts @@ -20,8 +20,6 @@ import * as userAgent from './utils/useragent.js'; /** * Blockly opaque event data used to unbind events when using * `bind` and `conditionalBind`. - * - * @alias Blockly.browserEvents.Data */ export type Data = [EventTarget, string, (e: Event) => void][]; @@ -54,7 +52,6 @@ const PAGE_MODE_MULTIPLIER = 125; * simultaneous touches. False by default. * @param opt_noPreventDefault No-op, deprecated and will be removed in v10. * @returns Opaque data that can be passed to unbindEvent_. - * @alias Blockly.browserEvents.conditionalBind */ export function conditionalBind( node: EventTarget, name: string, thisObject: Object|null, func: Function, @@ -105,7 +102,6 @@ export function conditionalBind( * @param thisObject The value of 'this' in the function. * @param func Function to call when event is triggered. * @returns Opaque data that can be passed to unbindEvent_. - * @alias Blockly.browserEvents.bind */ export function bind( node: EventTarget, name: string, thisObject: Object|null, @@ -142,7 +138,6 @@ export function bind( * @param bindData Opaque data from bindEvent_. * This list is emptied during the course of calling this function. * @returns The function call. - * @alias Blockly.browserEvents.unbind */ export function unbind(bindData: Data): (e: Event) => void { // Accessing an element of the last property of the array is unsafe if the @@ -164,7 +159,6 @@ export function unbind(bindData: Data): (e: Event) => void { * * @param e An event. * @returns True if text input. - * @alias Blockly.browserEvents.isTargetInput */ export function isTargetInput(e: Event): boolean { if (e.target instanceof HTMLElement) { @@ -194,7 +188,6 @@ export function isTargetInput(e: Event): boolean { * * @param e Mouse event. * @returns True if right-click. - * @alias Blockly.browserEvents.isRightButton */ export function isRightButton(e: MouseEvent): boolean { if (e.ctrlKey && userAgent.MAC) { @@ -213,7 +206,6 @@ export function isRightButton(e: MouseEvent): boolean { * @param svg SVG element. * @param matrix Inverted screen CTM to use. * @returns Object with .x and .y properties. - * @alias Blockly.browserEvents.mouseToSvg */ export function mouseToSvg( e: MouseEvent, svg: SVGSVGElement, matrix: SVGMatrix|null): SVGPoint { @@ -232,7 +224,6 @@ export function mouseToSvg( * * @param e Mouse event. * @returns Scroll delta object with .x and .y properties. - * @alias Blockly.browserEvents.getScrollDeltaPixels */ export function getScrollDeltaPixels(e: WheelEvent): {x: number, y: number} { switch (e.deltaMode) { diff --git a/core/bubble.ts b/core/bubble.ts index 7f8a1eb3b..3107af725 100644 --- a/core/bubble.ts +++ b/core/bubble.ts @@ -29,8 +29,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; /** * Class for UI bubble. - * - * @alias Blockly.Bubble */ export class Bubble implements IBubble { /** Width of the border around the bubble. */ diff --git a/core/bubble_dragger.ts b/core/bubble_dragger.ts index 083faf734..45a0ba430 100644 --- a/core/bubble_dragger.ts +++ b/core/bubble_dragger.ts @@ -27,8 +27,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; * Class for a bubble dragger. It moves things on the bubble canvas around the * workspace when they are being dragged by a mouse or touch. These can be * block comments, mutators, warnings, or workspace comments. - * - * @alias Blockly.BubbleDragger */ export class BubbleDragger { /** Which drag target the mouse pointer is over, if any. */ diff --git a/core/bump_objects.ts b/core/bump_objects.ts index cd2c754a4..301d65a96 100644 --- a/core/bump_objects.ts +++ b/core/bump_objects.ts @@ -35,7 +35,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; * in workspace coordinates. * @param object The object to bump. * @returns True if block was bumped. - * @alias Blockly.bumpObjects.bumpIntoBounds */ function bumpObjectIntoBounds( workspace: WorkspaceSvg, scrollMetrics: ContainerRegion, @@ -87,7 +86,6 @@ export const bumpIntoBounds = bumpObjectIntoBounds; * * @param workspace The workspace to handle. * @returns The event handler. - * @alias Blockly.bumpObjects.bumpIntoBoundsHandler */ export function bumpIntoBoundsHandler(workspace: WorkspaceSvg): (p1: Abstract) => void { @@ -167,7 +165,6 @@ function extractObjectFromEvent( * Bumps the top objects in the given workspace into bounds. * * @param workspace The workspace. - * @alias Blockly.bumpObjects.bumpTopObjectsIntoBounds */ export function bumpTopObjectsIntoBounds(workspace: WorkspaceSvg) { const metricsManager = workspace.getMetricsManager(); diff --git a/core/clipboard.ts b/core/clipboard.ts index 4b3bcbb6f..2056e950f 100644 --- a/core/clipboard.ts +++ b/core/clipboard.ts @@ -22,7 +22,6 @@ 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) { @@ -40,7 +39,6 @@ function copyInternal(toCopy: ICopyable) { * Paste a block or workspace comment on to the main workspace. * * @returns The pasted thing if the paste was successful, null otherwise. - * @alias Blockly.clipboard.paste * @internal */ export function paste(): ICopyable|null { @@ -66,7 +64,6 @@ export function paste(): ICopyable|null { * @param toDuplicate Block or Workspace Comment to be duplicated. * @returns 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 { diff --git a/core/comment.ts b/core/comment.ts index d716aa2f0..3dc4e31ef 100644 --- a/core/comment.ts +++ b/core/comment.ts @@ -32,8 +32,6 @@ import {Svg} from './utils/svg.js'; /** * Class for a comment. - * - * @alias Blockly.Comment */ export class Comment extends Icon { private readonly model: CommentModel; diff --git a/core/common.ts b/core/common.ts index 3181e88e7..a678ceef0 100644 --- a/core/common.ts +++ b/core/common.ts @@ -79,7 +79,6 @@ let mainWorkspace: Workspace; * page. * * @returns The main workspace. - * @alias Blockly.common.getMainWorkspace */ export function getMainWorkspace(): Workspace { return mainWorkspace; @@ -89,7 +88,6 @@ export function getMainWorkspace(): Workspace { * Sets last used main workspace. * * @param workspace The most recently used top level workspace. - * @alias Blockly.common.setMainWorkspace */ export function setMainWorkspace(workspace: Workspace) { mainWorkspace = workspace; @@ -102,8 +100,6 @@ let selected: ICopyable|null = null; /** * Returns the currently selected copyable object. - * - * @alias Blockly.common.getSelected */ export function getSelected(): ICopyable|null { return selected; @@ -115,7 +111,6 @@ 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) { @@ -132,7 +127,6 @@ let parentContainer: Element|null; * Tooltip. * * @returns The parent container. - * @alias Blockly.common.getParentContainer */ export function getParentContainer(): Element|null { return parentContainer; @@ -145,7 +139,6 @@ export function getParentContainer(): Element|null { * This method is a NOP if called after the first `Blockly.inject`. * * @param newParent The container element. - * @alias Blockly.common.setParentContainer */ export function setParentContainer(newParent: Element) { parentContainer = newParent; @@ -159,7 +152,6 @@ export function setParentContainer(newParent: Element) { * Record the height/width of the SVG image. * * @param workspace Any workspace in the SVG. - * @alias Blockly.common.svgResize */ export function svgResize(workspace: WorkspaceSvg) { let mainWorkspace = workspace; @@ -201,7 +193,6 @@ export const draggingConnections: Connection[] = []; * statements (blocks that are not inside a value or statement input * of the block). * @returns Map of types to type counts for descendants of the bock. - * @alias Blockly.common.getBlockTypeCounts */ export function getBlockTypeCounts( block: Block, opt_stripFollowing?: boolean): {[key: string]: number} { @@ -243,7 +234,6 @@ function jsonInitFactory(jsonDef: AnyDuringMigration): () => void { * by the Blockly Developer Tools. * * @param jsonArray An array of JSON block definitions. - * @alias Blockly.common.defineBlocksWithJsonArray */ export function defineBlocksWithJsonArray(jsonArray: AnyDuringMigration[]) { TEST_ONLY.defineBlocksWithJsonArrayInternal(jsonArray); @@ -263,7 +253,6 @@ function defineBlocksWithJsonArrayInternal(jsonArray: AnyDuringMigration[]) { * @param jsonArray An array of JSON block definitions. * @returns A map of the block * definitions created. - * @alias Blockly.common.defineBlocksWithJsonArray */ export function createBlockDefinitionsFromJsonArray( jsonArray: AnyDuringMigration[]): {[key: string]: BlockDefinition} { @@ -292,7 +281,6 @@ export function createBlockDefinitionsFromJsonArray( * * @param blocks A map of block * type names to block definitions. - * @alias Blockly.common.defineBlocks */ export function defineBlocks(blocks: {[key: string]: BlockDefinition}) { // Iterate over own enumerable properties. diff --git a/core/component_manager.ts b/core/component_manager.ts index 7ba9986e4..426860a74 100644 --- a/core/component_manager.ts +++ b/core/component_manager.ts @@ -43,8 +43,6 @@ class Capability<_T> { /** * Manager for all items registered with the workspace. - * - * @alias Blockly.ComponentManager */ export class ComponentManager { static Capability = Capability; diff --git a/core/config.ts b/core/config.ts index aa8bc9f5e..e2b6c6988 100644 --- a/core/config.ts +++ b/core/config.ts @@ -39,7 +39,6 @@ export const config: Config = { /** * Number of pixels the mouse must move before a drag starts. * - * @alias Blockly.config.dragRadius */ dragRadius: 5, /** @@ -47,20 +46,17 @@ export const config: Config = { * flyout. Because the drag-intention is determined when this is reached, it * is larger than dragRadius so that the drag-direction is clearer. * - * @alias Blockly.config.flyoutDragRadius */ flyoutDragRadius: 10, /** * Maximum misalignment between connections for them to snap together. * - * @alias Blockly.config.snapRadius */ snapRadius: DEFAULT_SNAP_RADIUS, /** * Maximum misalignment between connections for them to snap together. * This should be the same as the snap radius. * - * @alias Blockly.config.connectingSnapRadius */ connectingSnapRadius: DEFAULT_SNAP_RADIUS, /** @@ -69,13 +65,11 @@ export const config: Config = { * this much closer to the matching connection on the block than it actually * is. * - * @alias Blockly.config.currentConnectionPreference */ currentConnectionPreference: 8, /** * Delay in ms between trigger and bumping unconnected block out of alignment. * - * @alias Blockly.config.bumpDelay */ bumpDelay: 250, }; diff --git a/core/connection.ts b/core/connection.ts index e495df85d..f5dc0a6bb 100644 --- a/core/connection.ts +++ b/core/connection.ts @@ -25,8 +25,6 @@ import * as Xml from './xml.js'; /** * Class for a connection between blocks. - * - * @alias Blockly.Connection */ export class Connection implements IASTNodeLocationWithBlock { /** Constants for checking whether two connections are compatible. */ diff --git a/core/connection_checker.ts b/core/connection_checker.ts index 498245303..599da547f 100644 --- a/core/connection_checker.ts +++ b/core/connection_checker.ts @@ -24,8 +24,6 @@ import type {RenderedConnection} from './rendered_connection.js'; /** * Class for connection type checking logic. - * - * @alias Blockly.ConnectionChecker */ export class ConnectionChecker implements IConnectionChecker { /** diff --git a/core/connection_db.ts b/core/connection_db.ts index e2a2da999..9320d9f28 100644 --- a/core/connection_db.ts +++ b/core/connection_db.ts @@ -24,8 +24,6 @@ import type {Coordinate} from './utils/coordinate.js'; * Database of connections. * Connections are stored in order of their vertical component. This way * connections in an area may be looked up quickly using a binary search. - * - * @alias Blockly.ConnectionDB */ export class ConnectionDB { /** Array of connections sorted by y position in workspace units. */ diff --git a/core/connection_type.ts b/core/connection_type.ts index 4e2d123f9..990b9a5af 100644 --- a/core/connection_type.ts +++ b/core/connection_type.ts @@ -15,8 +15,6 @@ goog.declareModuleId('Blockly.ConnectionType'); /** * Enum for the type of a connection or input. - * - * @alias Blockly.ConnectionType */ export enum ConnectionType { // A right-facing value input. E.g. 'set item to' or 'return'. diff --git a/core/constants.ts b/core/constants.ts index 68e807a21..49ec99b91 100644 --- a/core/constants.ts +++ b/core/constants.ts @@ -15,14 +15,10 @@ goog.declareModuleId('Blockly.constants'); /** * The language-neutral ID given to the collapsed input. - * - * @alias Blockly.constants.COLLAPSED_INPUT_NAME */ export const COLLAPSED_INPUT_NAME = '_TEMP_COLLAPSED_INPUT'; /** * The language-neutral ID given to the collapsed field. - * - * @alias Blockly.constants.COLLAPSED_FIELD_NAME */ export const COLLAPSED_FIELD_NAME = '_TEMP_COLLAPSED_FIELD'; diff --git a/core/contextmenu.ts b/core/contextmenu.ts index c7737a597..ec56d9038 100644 --- a/core/contextmenu.ts +++ b/core/contextmenu.ts @@ -44,7 +44,6 @@ const dummyOwner = {}; * Gets the block the context menu is currently attached to. * * @returns The block the context menu is attached to. - * @alias Blockly.ContextMenu.getCurrentBlock */ export function getCurrentBlock(): Block|null { return currentBlock; @@ -54,7 +53,6 @@ export function getCurrentBlock(): Block|null { * Sets the block the context menu is currently attached to. * * @param block The block the context menu is attached to. - * @alias Blockly.ContextMenu.setCurrentBlock */ export function setCurrentBlock(block: Block|null) { currentBlock = block; @@ -71,7 +69,6 @@ let menu_: Menu|null = null; * @param e Mouse event. * @param options Array of menu options. * @param rtl True if RTL, false if LTR. - * @alias Blockly.ContextMenu.show */ export function show( e: Event, options: (ContextMenuOption|LegacyContextMenuOption)[], @@ -200,8 +197,6 @@ function haltPropagation(e: Event) { /** * Hide the context menu. - * - * @alias Blockly.ContextMenu.hide */ export function hide() { WidgetDiv.hideIfOwner(dummyOwner); @@ -210,8 +205,6 @@ export function hide() { /** * Dispose of the menu. - * - * @alias Blockly.ContextMenu.dispose */ export function dispose() { if (menu_) { @@ -227,7 +220,6 @@ export function dispose() { * @param block Original block. * @param xml XML representation of new block. * @returns Function that creates a block. - * @alias Blockly.ContextMenu.callbackFactory */ export function callbackFactory(block: Block, xml: Element): Function { return () => { @@ -263,7 +255,6 @@ export function callbackFactory(block: Block, xml: Element): Function { * right-click originated. * @returns A menu option, * containing text, enabled, and a callback. - * @alias Blockly.ContextMenu.commentDeleteOption * @internal */ export function commentDeleteOption(comment: WorkspaceCommentSvg): @@ -287,7 +278,6 @@ export function commentDeleteOption(comment: WorkspaceCommentSvg): * right-click originated. * @returns A menu option, * containing text, enabled, and a callback. - * @alias Blockly.ContextMenu.commentDuplicateOption * @internal */ export function commentDuplicateOption(comment: WorkspaceCommentSvg): @@ -311,7 +301,6 @@ export function commentDuplicateOption(comment: WorkspaceCommentSvg): * @returns A menu option, containing text, enabled, and a callback. * @suppress {strictModuleDepCheck,checkTypes} Suppress checks while workspace * comments are not bundled in. - * @alias Blockly.ContextMenu.workspaceCommentOption * @internal */ export function workspaceCommentOption( diff --git a/core/contextmenu_items.ts b/core/contextmenu_items.ts index db87b2618..706ba4fbe 100644 --- a/core/contextmenu_items.ts +++ b/core/contextmenu_items.ts @@ -26,8 +26,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; /** * Option to undo previous action. - * - * @alias Blockly.ContextMenuItems.registerUndo */ export function registerUndo() { const undoOption: RegistryItem = { @@ -52,8 +50,6 @@ export function registerUndo() { /** * Option to redo previous action. - * - * @alias Blockly.ContextMenuItems.registerRedo */ export function registerRedo() { const redoOption: RegistryItem = { @@ -78,8 +74,6 @@ export function registerRedo() { /** * Option to clean up blocks. - * - * @alias Blockly.ContextMenuItems.registerCleanup */ export function registerCleanup() { const cleanOption: RegistryItem = { @@ -135,8 +129,6 @@ function toggleOption_(shouldCollapse: boolean, topBlocks: BlockSvg[]) { /** * Option to collapse all blocks. - * - * @alias Blockly.ContextMenuItems.registerCollapse */ export function registerCollapse() { const collapseOption: RegistryItem = { @@ -171,8 +163,6 @@ export function registerCollapse() { /** * Option to expand all blocks. - * - * @alias Blockly.ContextMenuItems.registerExpand */ export function registerExpand() { const expandOption: RegistryItem = { @@ -261,8 +251,6 @@ function deleteNext_(deleteList: BlockSvg[], eventGroup: string) { /** * Option to delete all blocks. - * - * @alias Blockly.ContextMenuItems.registerDeleteAll */ export function registerDeleteAll() { const deleteOption: RegistryItem = { @@ -323,8 +311,6 @@ function registerWorkspaceOptions_() { /** * Option to duplicate a block. - * - * @alias Blockly.ContextMenuItems.registerDuplicate */ export function registerDuplicate() { const duplicateOption: RegistryItem = { @@ -355,8 +341,6 @@ export function registerDuplicate() { /** * Option to add or remove block-level comment. - * - * @alias Blockly.ContextMenuItems.registerComment */ export function registerComment() { const commentOption: RegistryItem = { @@ -393,8 +377,6 @@ export function registerComment() { /** * Option to inline variables. - * - * @alias Blockly.ContextMenuItems.registerInline */ export function registerInline() { const inlineOption: RegistryItem = { @@ -428,8 +410,6 @@ export function registerInline() { /** * Option to collapse or expand a block. - * - * @alias Blockly.ContextMenuItems.registerCollapseExpandBlock */ export function registerCollapseExpandBlock() { const collapseExpandOption: RegistryItem = { @@ -457,8 +437,6 @@ export function registerCollapseExpandBlock() { /** * Option to disable or enable a block. - * - * @alias Blockly.ContextMenuItems.registerDisable */ export function registerDisable() { const disableOption: RegistryItem = { @@ -497,8 +475,6 @@ export function registerDisable() { /** * Option to delete a block. - * - * @alias Blockly.ContextMenuItems.registerDelete */ export function registerDelete() { const deleteOption: RegistryItem = { @@ -535,8 +511,6 @@ export function registerDelete() { /** * Option to open help for a block. - * - * @alias Blockly.ContextMenuItems.registerHelp */ export function registerHelp() { const helpOption: RegistryItem = { @@ -577,7 +551,6 @@ 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() { diff --git a/core/contextmenu_registry.ts b/core/contextmenu_registry.ts index 8f2a297b2..6f3eb5e1c 100644 --- a/core/contextmenu_registry.ts +++ b/core/contextmenu_registry.ts @@ -20,8 +20,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; * Class for the registry of context menu items. This is intended to be a * singleton. You should not create a new instance, and only access this class * from ContextMenuRegistry.registry. - * - * @alias Blockly.ContextMenuRegistry */ export class ContextMenuRegistry { static registry: ContextMenuRegistry; diff --git a/core/css.ts b/core/css.ts index 1582b783f..2d024acca 100644 --- a/core/css.ts +++ b/core/css.ts @@ -21,7 +21,6 @@ let injected = false; * components such as fields and the toolbox to store separate CSS. * * @param cssContent Multiline CSS string or an array of single lines of CSS. - * @alias Blockly.Css.register */ export function register(cssContent: string) { if (injected) { @@ -40,7 +39,6 @@ export function register(cssContent: string) { * @param hasCss If false, don't inject CSS (providing CSS becomes the * document's responsibility). * @param pathToMedia Path from page to the Blockly media directory. - * @alias Blockly.Css.inject */ export function inject(hasCss: boolean, pathToMedia: string) { // Only inject the CSS once. @@ -67,8 +65,6 @@ export function inject(hasCss: boolean, pathToMedia: string) { /** * The CSS content for Blockly. - * - * @alias Blockly.Css.content */ let content = ` .blocklySvg { diff --git a/core/delete_area.ts b/core/delete_area.ts index 9bee66742..576d2475a 100644 --- a/core/delete_area.ts +++ b/core/delete_area.ts @@ -22,8 +22,6 @@ import type {IDraggable} from './interfaces/i_draggable.js'; /** * Abstract class for a component that can delete a block or bubble that is * dropped on top of it. - * - * @alias Blockly.DeleteArea */ export class DeleteArea extends DragTarget implements IDeleteArea { /** diff --git a/core/dialog.ts b/core/dialog.ts index c0d99d781..733eab90d 100644 --- a/core/dialog.ts +++ b/core/dialog.ts @@ -37,7 +37,6 @@ let promptImplementation = function( * * @param message The message to display to the user. * @param opt_callback The callback when the alert is dismissed. - * @alias Blockly.dialog.alert */ export function alert(message: string, opt_callback?: () => void) { alertImplementation(message, opt_callback); @@ -48,7 +47,6 @@ export function alert(message: string, opt_callback?: () => void) { * * @param alertFunction The function to be run. * @see Blockly.dialog.alert - * @alias Blockly.dialog.setAlert */ export function setAlert(alertFunction: (p1: string, p2?: () => void) => void) { alertImplementation = alertFunction; @@ -60,7 +58,6 @@ export function setAlert(alertFunction: (p1: string, p2?: () => void) => void) { * * @param message The message to display to the user. * @param callback The callback for handling user response. - * @alias Blockly.dialog.confirm */ export function confirm(message: string, callback: (p1: boolean) => void) { TEST_ONLY.confirmInternal(message, callback); @@ -79,7 +76,6 @@ function confirmInternal(message: string, callback: (p1: boolean) => void) { * * @param confirmFunction The function to be run. * @see Blockly.dialog.confirm - * @alias Blockly.dialog.setConfirm */ export function setConfirm( confirmFunction: (p1: string, p2: (p1: boolean) => void) => void) { @@ -95,7 +91,6 @@ export function setConfirm( * @param message The message to display to the user. * @param defaultValue The value to initialize the prompt with. * @param callback The callback for handling user response. - * @alias Blockly.dialog.prompt */ export function prompt( message: string, defaultValue: string, @@ -108,7 +103,6 @@ export function prompt( * * @param promptFunction The function to be run. * @see Blockly.dialog.prompt - * @alias Blockly.dialog.setPrompt */ export function setPrompt( promptFunction: (p1: string, p2: string, p3: (p1: string|null) => void) => diff --git a/core/drag_target.ts b/core/drag_target.ts index a8977bca2..5ef9d82cc 100644 --- a/core/drag_target.ts +++ b/core/drag_target.ts @@ -21,8 +21,6 @@ import type {Rect} from './utils/rect.js'; /** * Abstract class for a component with custom behaviour when a block or bubble * is dragged over or dropped on top of it. - * - * @alias Blockly.DragTarget */ export class DragTarget implements IDragTarget { /** diff --git a/core/events/events_abstract.ts b/core/events/events_abstract.ts index f22c9c3b8..2da378866 100644 --- a/core/events/events_abstract.ts +++ b/core/events/events_abstract.ts @@ -22,8 +22,6 @@ import * as eventUtils from './utils.js'; /** * Abstract class for an event. - * - * @alias Blockly.Events.Abstract */ export abstract class Abstract { /** @@ -52,7 +50,6 @@ export abstract class Abstract { /** Type of this event. */ type = ''; - /** @alias Blockly.Events.Abstract */ constructor() { this.group = eventUtils.getGroup(); this.recordUndo = eventUtils.getRecordUndo(); diff --git a/core/events/events_block_base.ts b/core/events/events_block_base.ts index 8d2c79665..b279af43b 100644 --- a/core/events/events_block_base.ts +++ b/core/events/events_block_base.ts @@ -21,8 +21,6 @@ import {Abstract as AbstractEvent, AbstractEventJson} from './events_abstract.js /** * Abstract class for any event related to blocks. - * - * @alias Blockly.Events.BlockBase */ export class BlockBase extends AbstractEvent { override isBlank = true; diff --git a/core/events/events_block_change.ts b/core/events/events_block_change.ts index 288fe0e46..a81be70d9 100644 --- a/core/events/events_block_change.ts +++ b/core/events/events_block_change.ts @@ -26,8 +26,6 @@ import * as eventUtils from './utils.js'; /** * Notifies listeners when some element of a block has changed (e.g. * field values, comments, etc). - * - * @alias Blockly.Events.BlockChange */ export class BlockChange extends BlockBase { override type = eventUtils.BLOCK_CHANGE; diff --git a/core/events/events_block_create.ts b/core/events/events_block_create.ts index d88f84388..41fb63988 100644 --- a/core/events/events_block_create.ts +++ b/core/events/events_block_create.ts @@ -26,8 +26,6 @@ import {Workspace} from '../workspace.js'; /** * Notifies listeners when a block (or connected stack of blocks) is * created. - * - * @alias Blockly.Events.BlockCreate */ export class BlockCreate extends BlockBase { override type = eventUtils.BLOCK_CREATE; diff --git a/core/events/events_block_delete.ts b/core/events/events_block_delete.ts index 77071b95d..5a7686edc 100644 --- a/core/events/events_block_delete.ts +++ b/core/events/events_block_delete.ts @@ -26,8 +26,6 @@ import {Workspace} from '../workspace.js'; /** * Notifies listeners when a block (or connected stack of blocks) is * deleted. - * - * @alias Blockly.Events.BlockDelete */ export class BlockDelete extends BlockBase { /** The XML representation of the deleted block(s). */ diff --git a/core/events/events_block_drag.ts b/core/events/events_block_drag.ts index bf928d713..4163da907 100644 --- a/core/events/events_block_drag.ts +++ b/core/events/events_block_drag.ts @@ -23,8 +23,6 @@ import {Workspace} from '../workspace.js'; /** * Notifies listeners when a block is being manually dragged/dropped. - * - * @alias Blockly.Events.BlockDrag */ export class BlockDrag extends UiBase { /** The ID of the top-level block being dragged. */ diff --git a/core/events/events_block_move.ts b/core/events/events_block_move.ts index a0bb9bbd5..0034c2e0b 100644 --- a/core/events/events_block_move.ts +++ b/core/events/events_block_move.ts @@ -32,8 +32,6 @@ interface BlockLocation { /** * Notifies listeners when a block is moved. This could be from one * connection to another, or from one location on the workspace to another. - * - * @alias Blockly.Events.BlockMove */ export class BlockMove extends BlockBase { override type = eventUtils.BLOCK_MOVE; diff --git a/core/events/events_bubble_open.ts b/core/events/events_bubble_open.ts index 8ea2f967e..8697d22c0 100644 --- a/core/events/events_bubble_open.ts +++ b/core/events/events_bubble_open.ts @@ -23,8 +23,6 @@ import type {Workspace} from '../workspace.js'; /** * Class for a bubble open event. - * - * @alias Blockly.Events.BubbleOpen */ export class BubbleOpen extends UiBase { /** The ID of the block the bubble is attached to. */ diff --git a/core/events/events_click.ts b/core/events/events_click.ts index f9ac79817..66915762a 100644 --- a/core/events/events_click.ts +++ b/core/events/events_click.ts @@ -24,8 +24,6 @@ import {Workspace} from '../workspace.js'; /** * Notifies listeners that ome blockly element was clicked. - * - * @alias Blockly.Events.Click */ export class Click extends UiBase { /** The ID of the block that was clicked, if a block was clicked. */ diff --git a/core/events/events_comment_base.ts b/core/events/events_comment_base.ts index cfbb333c0..bee960886 100644 --- a/core/events/events_comment_base.ts +++ b/core/events/events_comment_base.ts @@ -26,8 +26,6 @@ import type {Workspace} from '../workspace.js'; /** * Abstract class for a comment event. - * - * @alias Blockly.Events.CommentBase */ export class CommentBase extends AbstractEvent { override isBlank = true; diff --git a/core/events/events_comment_change.ts b/core/events/events_comment_change.ts index afecc21ca..d154f6425 100644 --- a/core/events/events_comment_change.ts +++ b/core/events/events_comment_change.ts @@ -23,8 +23,6 @@ import type {Workspace} from '../workspace.js'; /** * Notifies listeners that the contents of a workspace comment has changed. - * - * @alias Blockly.Events.CommentChange */ export class CommentChange extends CommentBase { override type = eventUtils.COMMENT_CHANGE; diff --git a/core/events/events_comment_create.ts b/core/events/events_comment_create.ts index 712c7248c..74c9b1737 100644 --- a/core/events/events_comment_create.ts +++ b/core/events/events_comment_create.ts @@ -24,8 +24,6 @@ import type {Workspace} from '../workspace.js'; /** * Notifies listeners that a workspace comment was created. - * - * @alias Blockly.Events.CommentCreate */ export class CommentCreate extends CommentBase { override type = eventUtils.COMMENT_CREATE; diff --git a/core/events/events_comment_delete.ts b/core/events/events_comment_delete.ts index fdc513b23..f9079fd20 100644 --- a/core/events/events_comment_delete.ts +++ b/core/events/events_comment_delete.ts @@ -23,8 +23,6 @@ import type {Workspace} from '../workspace.js'; /** * Notifies listeners that a workspace comment has been deleted. - * - * @alias Blockly.Events.CommentDelete */ export class CommentDelete extends CommentBase { override type = eventUtils.COMMENT_DELETE; diff --git a/core/events/events_comment_move.ts b/core/events/events_comment_move.ts index 40f2a0da3..31a893c0a 100644 --- a/core/events/events_comment_move.ts +++ b/core/events/events_comment_move.ts @@ -24,8 +24,6 @@ import type {Workspace} from '../workspace.js'; /** * Notifies listeners that a workspace comment has moved. - * - * @alias Blockly.Events.CommentMove */ export class CommentMove extends CommentBase { override type = eventUtils.COMMENT_MOVE; diff --git a/core/events/events_marker_move.ts b/core/events/events_marker_move.ts index 9ba2fdc8b..dcb4fe784 100644 --- a/core/events/events_marker_move.ts +++ b/core/events/events_marker_move.ts @@ -26,8 +26,6 @@ import * as eventUtils from './utils.js'; /** * Notifies listeners that a marker (used for keyboard navigation) has * moved. - * - * @alias Blockly.Events.MarkerMove */ export class MarkerMove extends UiBase { /** The ID of the block the marker is now on, if any. */ diff --git a/core/events/events_selected.ts b/core/events/events_selected.ts index 03fcfd9d9..fc1d6ce3f 100644 --- a/core/events/events_selected.ts +++ b/core/events/events_selected.ts @@ -24,8 +24,6 @@ import type {Workspace} from '../workspace.js'; /** * Class for a selected event. * Notifies listeners that a new element has been selected. - * - * @alias Blockly.Events.Selected */ export class Selected extends UiBase { /** The id of the last selected selectable element. */ diff --git a/core/events/events_theme_change.ts b/core/events/events_theme_change.ts index 9f5a58464..d7ebef5bf 100644 --- a/core/events/events_theme_change.ts +++ b/core/events/events_theme_change.ts @@ -22,8 +22,6 @@ import type {Workspace} from '../workspace.js'; /** * Notifies listeners that the workspace theme has changed. - * - * @alias Blockly.Events.ThemeChange */ export class ThemeChange extends UiBase { /** The name of the new theme that has been set. */ diff --git a/core/events/events_toolbox_item_select.ts b/core/events/events_toolbox_item_select.ts index 2f47eb9d8..4eca80b4d 100644 --- a/core/events/events_toolbox_item_select.ts +++ b/core/events/events_toolbox_item_select.ts @@ -22,8 +22,6 @@ import type {Workspace} from '../workspace.js'; /** * Notifies listeners that a toolbox item has been selected. - * - * @alias Blockly.Events.ToolboxItemSelect */ export class ToolboxItemSelect extends UiBase { /** The previously selected toolbox item. */ diff --git a/core/events/events_trashcan_open.ts b/core/events/events_trashcan_open.ts index 95876dfd8..fd03b2da6 100644 --- a/core/events/events_trashcan_open.ts +++ b/core/events/events_trashcan_open.ts @@ -23,8 +23,6 @@ import type {Workspace} from '../workspace.js'; /** * Notifies listeners when the trashcan is opening or closing. - * - * @alias Blockly.Events.TrashcanOpen */ export class TrashcanOpen extends UiBase { /** diff --git a/core/events/events_ui.ts b/core/events/events_ui.ts index 670d9143d..f743f14d9 100644 --- a/core/events/events_ui.ts +++ b/core/events/events_ui.ts @@ -23,7 +23,6 @@ import * as eventUtils from './utils.js'; * Class for a UI event. * * @deprecated December 2020. Instead use a more specific UI event. - * @alias Blockly.Events.Ui */ export class Ui extends UiBase { blockId: AnyDuringMigration; diff --git a/core/events/events_ui_base.ts b/core/events/events_ui_base.ts index 5f585f079..be5a60d59 100644 --- a/core/events/events_ui_base.ts +++ b/core/events/events_ui_base.ts @@ -22,8 +22,6 @@ import {Abstract as AbstractEvent} from './events_abstract.js'; * editing to work (e.g. scrolling the workspace, zooming, opening toolbox * categories). * UI events do not undo or redo. - * - * @alias Blockly.Events.UiBase */ export class UiBase extends AbstractEvent { override isBlank = true; diff --git a/core/events/events_var_base.ts b/core/events/events_var_base.ts index 0bbd48fcf..f25628888 100644 --- a/core/events/events_var_base.ts +++ b/core/events/events_var_base.ts @@ -21,8 +21,6 @@ import type {Workspace} from '../workspace.js'; /** * Abstract class for a variable event. - * - * @alias Blockly.Events.VarBase */ export class VarBase extends AbstractEvent { override isBlank = true; diff --git a/core/events/events_var_create.ts b/core/events/events_var_create.ts index c30fb8463..63292bc84 100644 --- a/core/events/events_var_create.ts +++ b/core/events/events_var_create.ts @@ -23,8 +23,6 @@ import type {Workspace} from '../workspace.js'; /** * Notifies listeners that a variable model has been created. - * - * @alias Blockly.Events.VarCreate */ export class VarCreate extends VarBase { override type = eventUtils.VAR_CREATE; diff --git a/core/events/events_viewport.ts b/core/events/events_viewport.ts index 7f853fae2..f0287a399 100644 --- a/core/events/events_viewport.ts +++ b/core/events/events_viewport.ts @@ -25,8 +25,6 @@ import type {Workspace} from '../workspace.js'; * changed. * * Does not notify when the workspace itself resizes. - * - * @alias Blockly.Events.ViewportChange */ export class ViewportChange extends UiBase { /** diff --git a/core/events/utils.ts b/core/events/utils.ts index 60b9c155f..970ae695a 100644 --- a/core/events/utils.ts +++ b/core/events/utils.ts @@ -39,7 +39,6 @@ let recordUndo = true; * Sets whether events should be added to the undo stack. * * @param newValue True if events should be added to the undo stack. - * @alias Blockly.Events.utils.setRecordUndo */ export function setRecordUndo(newValue: boolean) { recordUndo = newValue; @@ -49,7 +48,6 @@ export function setRecordUndo(newValue: boolean) { * Returns whether or not events will be added to the undo stack. * * @returns True if events will be added to the undo stack. - * @alias Blockly.Events.utils.getRecordUndo */ export function getRecordUndo(): boolean { return recordUndo; @@ -60,183 +58,131 @@ let disabled = 0; /** * Name of event that creates a block. Will be deprecated for BLOCK_CREATE. - * - * @alias Blockly.Events.utils.CREATE */ export const CREATE = 'create'; /** * Name of event that creates a block. - * - * @alias Blockly.Events.utils.BLOCK_CREATE */ export const BLOCK_CREATE = CREATE; /** * Name of event that deletes a block. Will be deprecated for BLOCK_DELETE. - * - * @alias Blockly.Events.utils.DELETE */ export const DELETE = 'delete'; /** * Name of event that deletes a block. - * - * @alias Blockly.Events.utils.BLOCK_DELETE */ export const BLOCK_DELETE = DELETE; /** * Name of event that changes a block. Will be deprecated for BLOCK_CHANGE. - * - * @alias Blockly.Events.utils.CHANGE */ export const CHANGE = 'change'; /** * Name of event that changes a block. - * - * @alias Blockly.Events.utils.BLOCK_CHANGE */ export const BLOCK_CHANGE = CHANGE; /** * Name of event that moves a block. Will be deprecated for BLOCK_MOVE. - * - * @alias Blockly.Events.utils.MOVE */ export const MOVE = 'move'; /** * Name of event that moves a block. - * - * @alias Blockly.Events.utils.BLOCK_MOVE */ export const BLOCK_MOVE = MOVE; /** * Name of event that creates a variable. - * - * @alias Blockly.Events.utils.VAR_CREATE */ export const VAR_CREATE = 'var_create'; /** * Name of event that deletes a variable. - * - * @alias Blockly.Events.utils.VAR_DELETE */ export const VAR_DELETE = 'var_delete'; /** * Name of event that renames a variable. - * - * @alias Blockly.Events.utils.VAR_RENAME */ export const VAR_RENAME = 'var_rename'; /** * Name of generic event that records a UI change. - * - * @alias Blockly.Events.utils.UI */ export const UI = 'ui'; /** * Name of event that record a block drags a block. - * - * @alias Blockly.Events.utils.BLOCK_DRAG */ export const BLOCK_DRAG = 'drag'; /** * Name of event that records a change in selected element. - * - * @alias Blockly.Events.utils.SELECTED */ export const SELECTED = 'selected'; /** * Name of event that records a click. - * - * @alias Blockly.Events.utils.CLICK */ export const CLICK = 'click'; /** * Name of event that records a marker move. - * - * @alias Blockly.Events.utils.MARKER_MOVE */ export const MARKER_MOVE = 'marker_move'; /** * Name of event that records a bubble open. - * - * @alias Blockly.Events.utils.BUBBLE_OPEN */ export const BUBBLE_OPEN = 'bubble_open'; /** * Name of event that records a trashcan open. - * - * @alias Blockly.Events.utils.TRASHCAN_OPEN */ export const TRASHCAN_OPEN = 'trashcan_open'; /** * Name of event that records a toolbox item select. - * - * @alias Blockly.Events.utils.TOOLBOX_ITEM_SELECT */ export const TOOLBOX_ITEM_SELECT = 'toolbox_item_select'; /** * Name of event that records a theme change. - * - * @alias Blockly.Events.utils.THEME_CHANGE */ export const THEME_CHANGE = 'theme_change'; /** * Name of event that records a viewport change. - * - * @alias Blockly.Events.utils.VIEWPORT_CHANGE */ export const VIEWPORT_CHANGE = 'viewport_change'; /** * Name of event that creates a comment. - * - * @alias Blockly.Events.utils.COMMENT_CREATE */ export const COMMENT_CREATE = 'comment_create'; /** * Name of event that deletes a comment. - * - * @alias Blockly.Events.utils.COMMENT_DELETE */ export const COMMENT_DELETE = 'comment_delete'; /** * Name of event that changes a comment. - * - * @alias Blockly.Events.utils.COMMENT_CHANGE */ export const COMMENT_CHANGE = 'comment_change'; /** * Name of event that moves a comment. - * - * @alias Blockly.Events.utils.COMMENT_MOVE */ export const COMMENT_MOVE = 'comment_move'; /** * Name of event that records a workspace load. - * - * @alias Blockly.Events.utils.FINISHED_LOADING */ export const FINISHED_LOADING = 'finished_loading'; @@ -246,8 +192,6 @@ export const FINISHED_LOADING = 'finished_loading'; * * Not to be confused with bumping so that disconnected connections do not * appear connected. - * - * @alias Blockly.Events.utils.BumpEvent */ export type BumpEvent = BlockCreate|BlockMove|CommentCreate|CommentMove; @@ -257,8 +201,6 @@ export type BumpEvent = BlockCreate|BlockMove|CommentCreate|CommentMove; * * Not to be confused with bumping so that disconnected connections do not * appear connected. - * - * @alias Blockly.Events.utils.BUMP_EVENTS */ export const BUMP_EVENTS: string[] = [BLOCK_CREATE, BLOCK_MOVE, COMMENT_CREATE, COMMENT_MOVE]; @@ -270,7 +212,6 @@ const FIRE_QUEUE: Abstract[] = []; * Create a custom event and fire it. * * @param event Custom data for event. - * @alias Blockly.Events.utils.fire */ export function fire(event: Abstract) { TEST_ONLY.fireInternal(event); @@ -312,7 +253,6 @@ function fireNow() { * @param queueIn Array of events. * @param forward True if forward (redo), false if backward (undo). * @returns Array of filtered events. - * @alias Blockly.Events.utils.filter */ export function filter(queueIn: Abstract[], forward: boolean): Abstract[] { let queue = queueIn.slice(); @@ -395,8 +335,6 @@ export function filter(queueIn: Abstract[], forward: boolean): Abstract[] { /** * Modify pending undo events so that when they are fired they don't land * in the undo stack. Called by Workspace.clearUndo. - * - * @alias Blockly.Events.utils.clearPendingUndo */ export function clearPendingUndo() { for (let i = 0, event; event = FIRE_QUEUE[i]; i++) { @@ -406,8 +344,6 @@ export function clearPendingUndo() { /** * Stop sending events. Every call to this function MUST also call enable. - * - * @alias Blockly.Events.utils.disable */ export function disable() { disabled++; @@ -416,8 +352,6 @@ export function disable() { /** * Start sending events. Unless events were already disabled when the * corresponding call to disable was made. - * - * @alias Blockly.Events.utils.enable */ export function enable() { disabled--; @@ -427,7 +361,6 @@ export function enable() { * Returns whether events may be fired or not. * * @returns True if enabled. - * @alias Blockly.Events.utils.isEnabled */ export function isEnabled(): boolean { return disabled === 0; @@ -437,7 +370,6 @@ export function isEnabled(): boolean { * Current group. * * @returns ID string. - * @alias Blockly.Events.utils.getGroup */ export function getGroup(): string { return group; @@ -448,7 +380,6 @@ export function getGroup(): string { * * @param state True to start new group, false to end group. * String to set group explicitly. - * @alias Blockly.Events.utils.setGroup */ export function setGroup(state: boolean|string) { TEST_ONLY.setGroupInternal(state); @@ -470,7 +401,6 @@ function setGroupInternal(state: boolean|string) { * * @param block The root block. * @returns List of block IDs. - * @alias Blockly.Events.utils.getDescendantIds * @internal */ export function getDescendantIds(block: Block): string[] { @@ -489,7 +419,6 @@ export function getDescendantIds(block: Block): string[] { * @param workspace Target workspace for event. * @returns The event represented by the JSON. * @throws {Error} if an event type is not found in the registry. - * @alias Blockly.Events.utils.fromJson */ export function fromJson( json: AnyDuringMigration, workspace: Workspace): Abstract { @@ -526,7 +455,6 @@ function eventClassHasStaticFromJson(eventClass: new (...p: any[]) => Abstract): * * @param eventType The type of the event to get. * @returns The event class with the given type. - * @alias Blockly.Events.utils.get */ export function get(eventType: string): (new (...p1: AnyDuringMigration[]) => Abstract) { @@ -544,7 +472,6 @@ export function get(eventType: string): * users don't try to re-enable disabled orphan blocks. * * @param event Custom data for event. - * @alias Blockly.Events.utils.disableOrphans */ export function disableOrphans(event: Abstract) { if (event.type === MOVE || event.type === CREATE) { diff --git a/core/events/workspace_events.ts b/core/events/workspace_events.ts index 6f6fc7e8e..30fab99b7 100644 --- a/core/events/workspace_events.ts +++ b/core/events/workspace_events.ts @@ -21,8 +21,6 @@ import * as eventUtils from './utils.js'; /** * Notifies listeners when the workspace has finished deserializing from * JSON/XML. - * - * @alias Blockly.Events.FinishedLoading */ export class FinishedLoading extends AbstractEvent { override isBlank = true; diff --git a/core/extensions.ts b/core/extensions.ts index c30cb314a..79a21ecb5 100644 --- a/core/extensions.ts +++ b/core/extensions.ts @@ -36,7 +36,6 @@ export const TEST_ONLY = {allExtensions}; * @param initFn The function to initialize an extended block. * @throws {Error} if the extension name is empty, the extension is already * registered, or extensionFn is not a function. - * @alias Blockly.Extensions.register */ export function register(name: string, initFn: Function) { if (typeof name !== 'string' || name.trim() === '') { @@ -58,7 +57,6 @@ export function register(name: string, initFn: Function) { * @param mixinObj The values to mix in. * @throws {Error} if the extension name is empty or the extension is already * registered. - * @alias Blockly.Extensions.registerMixin */ export function registerMixin(name: string, mixinObj: AnyDuringMigration) { if (!mixinObj || typeof mixinObj !== 'object') { @@ -81,7 +79,6 @@ export function registerMixin(name: string, mixinObj: AnyDuringMigration) { * @param opt_blockList A list of blocks to appear in the flyout of the mutator * dialog. * @throws {Error} if the mutation is invalid or can't be applied to the block. - * @alias Blockly.Extensions.registerMutator */ export function registerMutator( name: string, mixinObj: AnyDuringMigration, @@ -113,7 +110,6 @@ export function registerMutator( * Unregisters the extension registered with the given name. * * @param name The name of the extension to unregister. - * @alias Blockly.Extensions.unregister */ export function unregister(name: string) { if (isRegistered(name)) { @@ -129,7 +125,6 @@ export function unregister(name: string) { * * @param name The name of the extension to check for. * @returns True if the extension is registered. False if it is not registered. - * @alias Blockly.Extensions.isRegistered */ export function isRegistered(name: string): boolean { return !!allExtensions[name]; @@ -143,7 +138,6 @@ export function isRegistered(name: string): boolean { * @param block The block to apply the named extension to. * @param isMutator True if this extension defines a mutator. * @throws {Error} if the extension is not found. - * @alias Blockly.Extensions.apply */ export function apply(name: string, block: Block, isMutator: boolean) { const extensionFn = allExtensions[name]; @@ -387,7 +381,6 @@ export function runAfterPageLoad(fn: () => void) { * lookup table. * @param lookupTable The table of field values to tooltip text. * @returns The extension function. - * @alias Blockly.Extensions.buildTooltipForDropdown */ export function buildTooltipForDropdown( dropdownName: string, lookupTable: {[key: string]: string}): Function { @@ -470,7 +463,6 @@ function checkDropdownOptionsInTable( * placeholder. * @param fieldName The field with the replacement text. * @returns The extension function. - * @alias Blockly.Extensions.buildTooltipWithFieldText */ export function buildTooltipWithFieldText( msgTemplate: string, fieldName: string): Function { diff --git a/core/field.ts b/core/field.ts index 0bcf99119..4e7121bb2 100644 --- a/core/field.ts +++ b/core/field.ts @@ -67,7 +67,6 @@ export type FieldValidator = (newValue: T) => T|null|undefined; /** * Abstract class for an editable field. * - * @alias Blockly.Field * @typeParam T - The value stored on the field. */ export abstract class Field implements IASTNodeLocationSvg, diff --git a/core/field_angle.ts b/core/field_angle.ts index 70cce0f4e..be00a958e 100644 --- a/core/field_angle.ts +++ b/core/field_angle.ts @@ -31,8 +31,6 @@ export type FieldAngleValidator = FieldInputValidator; /** * Class for an editable angle field. - * - * @alias Blockly.FieldAngle */ export class FieldAngle extends FieldInput { /** diff --git a/core/field_checkbox.ts b/core/field_checkbox.ts index 3b8c08a92..9f3f107c7 100644 --- a/core/field_checkbox.ts +++ b/core/field_checkbox.ts @@ -26,8 +26,6 @@ export type FieldCheckboxValidator = FieldValidator; /** * Class for a checkbox field. - * - * @alias Blockly.FieldCheckbox */ export class FieldCheckbox extends Field { /** Default character for the checkmark. */ diff --git a/core/field_colour.ts b/core/field_colour.ts index 73843c0b6..8df51ed77 100644 --- a/core/field_colour.ts +++ b/core/field_colour.ts @@ -33,8 +33,6 @@ export type FieldColourValidator = FieldValidator; /** * Class for a colour input field. - * - * @alias Blockly.FieldColour */ export class FieldColour extends Field { /** diff --git a/core/field_dropdown.ts b/core/field_dropdown.ts index ced3a4bfe..54cb0dc6f 100644 --- a/core/field_dropdown.ts +++ b/core/field_dropdown.ts @@ -32,8 +32,6 @@ export type FieldDropdownValidator = FieldValidator; /** * Class for an editable dropdown field. - * - * @alias Blockly.FieldDropdown */ export class FieldDropdown extends Field { /** Horizontal distance that a checkmark overhangs the dropdown. */ diff --git a/core/field_image.ts b/core/field_image.ts index a265a182b..173a3dc63 100644 --- a/core/field_image.ts +++ b/core/field_image.ts @@ -22,8 +22,6 @@ import {Svg} from './utils/svg.js'; /** * Class for an image on a block. - * - * @alias Blockly.FieldImage */ export class FieldImage extends Field { /** diff --git a/core/field_input.ts b/core/field_input.ts index 88946b47a..9eb0b7614 100644 --- a/core/field_input.ts +++ b/core/field_input.ts @@ -38,7 +38,6 @@ export type FieldInputValidator = /** * Abstract class for an editable input field. * - * @alias Blockly.FieldInput * @typeParam T - The value stored on the field. */ export abstract class FieldInput extends Field { diff --git a/core/field_label.ts b/core/field_label.ts index 22a55a3b7..1c6daea50 100644 --- a/core/field_label.ts +++ b/core/field_label.ts @@ -21,8 +21,6 @@ import type {Sentinel} from './utils/sentinel.js'; /** * Class for a non-editable, non-serializable text field. - * - * @alias Blockly.FieldLabel */ export class FieldLabel extends Field { /** The html class name to use for this field. */ diff --git a/core/field_label_serializable.ts b/core/field_label_serializable.ts index ad1a5a06e..79c4c8e06 100644 --- a/core/field_label_serializable.ts +++ b/core/field_label_serializable.ts @@ -20,8 +20,6 @@ import * as parsing from './utils/parsing.js'; /** * Class for a non-editable, serializable text field. - * - * @alias Blockly.FieldLabelSerializable */ export class FieldLabelSerializable extends FieldLabel { /** diff --git a/core/field_multilineinput.ts b/core/field_multilineinput.ts index e6473811b..1d4aac52f 100644 --- a/core/field_multilineinput.ts +++ b/core/field_multilineinput.ts @@ -29,8 +29,6 @@ export type FieldMultilineInputValidator = FieldTextInputValidator; /** * Class for an editable text area field. - * - * @alias Blockly.FieldMultilineInput */ export class FieldMultilineInput extends FieldTextInput { /** diff --git a/core/field_number.ts b/core/field_number.ts index 20b799555..2e3da1d91 100644 --- a/core/field_number.ts +++ b/core/field_number.ts @@ -22,8 +22,6 @@ export type FieldNumberValidator = FieldInputValidator; /** * Class for an editable number field. - * - * @alias Blockly.FieldNumber */ export class FieldNumber extends FieldInput { /** The minimum value this number field can contain. */ diff --git a/core/field_registry.ts b/core/field_registry.ts index 172e1d8ae..9606dd55a 100644 --- a/core/field_registry.ts +++ b/core/field_registry.ts @@ -32,7 +32,6 @@ interface RegistryOptions { * construct an instance of the field. * @throws {Error} if the type name is empty, the field is already registered, * or the fieldClass is not an object containing a fromJson function. - * @alias Blockly.fieldRegistry.register */ export function register(type: string, fieldClass: FieldProto) { registry.register(registry.Type.FIELD, type, fieldClass); @@ -42,7 +41,6 @@ export function register(type: string, fieldClass: FieldProto) { * Unregisters the field registered with the given type. * * @param type The field type name as used in the JSON definition. - * @alias Blockly.fieldRegistry.unregister */ export function unregister(type: string) { registry.unregister(registry.Type.FIELD, type); @@ -57,7 +55,6 @@ export function unregister(type: string) { * type. * @returns 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: RegistryOptions): Field|null { diff --git a/core/field_textinput.ts b/core/field_textinput.ts index 5ef633dc4..401984b76 100644 --- a/core/field_textinput.ts +++ b/core/field_textinput.ts @@ -24,8 +24,6 @@ export type FieldTextInputValidator = FieldInputValidator; /** * Class for an editable text field. - * - * @alias Blockly.FieldTextInput */ export class FieldTextInput extends FieldInput { /** diff --git a/core/field_variable.ts b/core/field_variable.ts index 8d2fd276c..4a2c1b8f1 100644 --- a/core/field_variable.ts +++ b/core/field_variable.ts @@ -34,8 +34,6 @@ export type FieldVariableValidator = FieldDropdownValidator; /** * Class for a variable's dropdown field. - * - * @alias Blockly.FieldVariable */ export class FieldVariable extends FieldDropdown { protected override menuGenerator_: MenuGenerator|undefined; diff --git a/core/flyout_base.ts b/core/flyout_base.ts index be6b5da4b..7e5716d25 100644 --- a/core/flyout_base.ts +++ b/core/flyout_base.ts @@ -43,8 +43,6 @@ enum FlyoutItemType { /** * Class for a flyout. - * - * @alias Blockly.Flyout */ export abstract class Flyout extends DeleteArea implements IFlyout { /** diff --git a/core/flyout_button.ts b/core/flyout_button.ts index 9faa5671e..63f19e7a0 100644 --- a/core/flyout_button.ts +++ b/core/flyout_button.ts @@ -25,8 +25,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; /** * Class for a button or label in the flyout. - * - * @alias Blockly.FlyoutButton */ export class FlyoutButton { /** The horizontal margin around the text in the button. */ diff --git a/core/flyout_horizontal.ts b/core/flyout_horizontal.ts index 634fd41a4..5a0c96f84 100644 --- a/core/flyout_horizontal.ts +++ b/core/flyout_horizontal.ts @@ -27,8 +27,6 @@ import * as WidgetDiv from './widgetdiv.js'; /** * Class for a flyout. - * - * @alias Blockly.HorizontalFlyout */ export class HorizontalFlyout extends Flyout { override horizontalLayout = true; diff --git a/core/flyout_metrics_manager.ts b/core/flyout_metrics_manager.ts index e8f4e0401..48ca9379a 100644 --- a/core/flyout_metrics_manager.ts +++ b/core/flyout_metrics_manager.ts @@ -20,8 +20,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; /** * Calculates metrics for a flyout's workspace. * The metrics are mainly used to size scrollbars for the flyout. - * - * @alias Blockly.FlyoutMetricsManager */ export class FlyoutMetricsManager extends MetricsManager { /** The flyout that owns the workspace to calculate metrics for. */ diff --git a/core/flyout_vertical.ts b/core/flyout_vertical.ts index fa9d1ad39..b6c1ae7c2 100644 --- a/core/flyout_vertical.ts +++ b/core/flyout_vertical.ts @@ -27,8 +27,6 @@ import * as WidgetDiv from './widgetdiv.js'; /** * Class for a flyout. - * - * @alias Blockly.VerticalFlyout */ export class VerticalFlyout extends Flyout { /** The name of the vertical flyout in the registry. */ diff --git a/core/generator.ts b/core/generator.ts index 351aee41e..d51081a6d 100644 --- a/core/generator.ts +++ b/core/generator.ts @@ -24,7 +24,6 @@ import type {Workspace} from './workspace.js'; * Class for a code generator that translates the blocks into a language. * * @unrestricted - * @alias Blockly.CodeGenerator */ export class CodeGenerator { name_: string; diff --git a/core/gesture.ts b/core/gesture.ts index 065434097..c3d00ea3f 100644 --- a/core/gesture.ts +++ b/core/gesture.ts @@ -51,8 +51,6 @@ const ZOOM_OUT_MULTIPLIER = 6; /** * Class for one gesture. - * - * @alias Blockly.Gesture */ export class Gesture { /** diff --git a/core/grid.ts b/core/grid.ts index 6a939322b..ca84d90d6 100644 --- a/core/grid.ts +++ b/core/grid.ts @@ -20,8 +20,6 @@ import {GridOptions} from './options.js'; /** * Class for a workspace's grid. - * - * @alias Blockly.Grid */ export class Grid { private readonly spacing: number; diff --git a/core/icon.ts b/core/icon.ts index 83051610a..791f835d2 100644 --- a/core/icon.ts +++ b/core/icon.ts @@ -25,8 +25,6 @@ import * as deprecation from './utils/deprecation.js'; /** * Class for an icon. - * - * @alias Blockly.Icon */ export abstract class Icon { protected block_: BlockSvg|null; diff --git a/core/inject.ts b/core/inject.ts index d2f561865..1f7d81cbf 100644 --- a/core/inject.ts +++ b/core/inject.ts @@ -39,7 +39,6 @@ import {WorkspaceSvg} from './workspace_svg.js'; * @param container Containing element, or its ID, or a CSS selector. * @param opt_options Optional dictionary of options. * @returns Newly created main workspace. - * @alias Blockly.inject */ export function inject( container: Element|string, opt_options?: BlocklyOptions): WorkspaceSvg { diff --git a/core/input.ts b/core/input.ts index 5b69e566a..9c0224c8b 100644 --- a/core/input.ts +++ b/core/input.ts @@ -26,8 +26,6 @@ import type {RenderedConnection} from './rendered_connection.js'; /** * Class for an input with an optional field. - * - * @alias Blockly.Input */ export class Input { private sourceBlock: Block; @@ -306,7 +304,6 @@ export namespace Input { /** * Enum for alignment of inputs. * - * @alias Blockly.Input.Align */ export enum Align { LEFT = -1, diff --git a/core/input_types.ts b/core/input_types.ts index 0ea695e89..eab660df9 100644 --- a/core/input_types.ts +++ b/core/input_types.ts @@ -17,8 +17,6 @@ import {ConnectionType} from './connection_type.js'; /** * Enum for the type of a connection or input. - * - * @alias Blockly.inputTypes */ export enum inputTypes { // A right-facing value input. E.g. 'set item to' or 'return'. diff --git a/core/insertion_marker_manager.ts b/core/insertion_marker_manager.ts index 278809a7d..ec8963df6 100644 --- a/core/insertion_marker_manager.ts +++ b/core/insertion_marker_manager.ts @@ -56,8 +56,6 @@ const DUPLICATE_BLOCK_ERROR = 'The insertion marker ' + * Class that controls updates to connections during drags. It is primarily * responsible for finding the closest eligible connection and highlighting or * unhighlighting it as needed during a drag. - * - * @alias Blockly.InsertionMarkerManager */ export class InsertionMarkerManager { /** diff --git a/core/interfaces/i_ast_node_location.ts b/core/interfaces/i_ast_node_location.ts index 814873852..bb601d260 100644 --- a/core/interfaces/i_ast_node_location.ts +++ b/core/interfaces/i_ast_node_location.ts @@ -15,7 +15,5 @@ goog.declareModuleId('Blockly.IASTNodeLocation'); /** * An AST node location interface. - * - * @alias Blockly.IASTNodeLocation */ export interface IASTNodeLocation {} diff --git a/core/interfaces/i_ast_node_location_svg.ts b/core/interfaces/i_ast_node_location_svg.ts index 8bc51ec26..83eb6585f 100644 --- a/core/interfaces/i_ast_node_location_svg.ts +++ b/core/interfaces/i_ast_node_location_svg.ts @@ -17,8 +17,6 @@ import type {IASTNodeLocation} from './i_ast_node_location.js'; /** * An AST node location SVG interface. - * - * @alias Blockly.IASTNodeLocationSvg */ export interface IASTNodeLocationSvg extends IASTNodeLocation { /** diff --git a/core/interfaces/i_ast_node_location_with_block.ts b/core/interfaces/i_ast_node_location_with_block.ts index cf54ddc41..48eb094d7 100644 --- a/core/interfaces/i_ast_node_location_with_block.ts +++ b/core/interfaces/i_ast_node_location_with_block.ts @@ -19,8 +19,6 @@ import type {Block} from '../block.js'; /** * An AST node location that has an associated block. - * - * @alias Blockly.IASTNodeLocationWithBlock */ export interface IASTNodeLocationWithBlock extends IASTNodeLocation { /** diff --git a/core/interfaces/i_autohideable.ts b/core/interfaces/i_autohideable.ts index 542e3edf7..8b72e33c3 100644 --- a/core/interfaces/i_autohideable.ts +++ b/core/interfaces/i_autohideable.ts @@ -18,8 +18,6 @@ import type {IComponent} from './i_component.js'; /** * Interface for a component that can be automatically hidden. - * - * @alias Blockly.IAutoHideable */ export interface IAutoHideable extends IComponent { /** diff --git a/core/interfaces/i_block_dragger.ts b/core/interfaces/i_block_dragger.ts index e977369ea..db6995c13 100644 --- a/core/interfaces/i_block_dragger.ts +++ b/core/interfaces/i_block_dragger.ts @@ -16,8 +16,6 @@ goog.declareModuleId('Blockly.IBlockDragger'); /** * A block dragger interface. - * - * @alias Blockly.IBlockDragger */ export interface IBlockDragger { /** diff --git a/core/interfaces/i_bounded_element.ts b/core/interfaces/i_bounded_element.ts index 8aae86285..d1edec75d 100644 --- a/core/interfaces/i_bounded_element.ts +++ b/core/interfaces/i_bounded_element.ts @@ -15,8 +15,6 @@ goog.declareModuleId('Blockly.IBoundedElement'); /** * A bounded element interface. - * - * @alias Blockly.IBoundedElement */ export interface IBoundedElement { /** diff --git a/core/interfaces/i_bubble.ts b/core/interfaces/i_bubble.ts index af9450430..467aae673 100644 --- a/core/interfaces/i_bubble.ts +++ b/core/interfaces/i_bubble.ts @@ -19,8 +19,6 @@ import type {IDraggable} from './i_draggable.js'; /** * A bubble interface. - * - * @alias Blockly.IBubble */ export interface IBubble extends IDraggable, IContextMenu { /** diff --git a/core/interfaces/i_collapsible_toolbox_item.ts b/core/interfaces/i_collapsible_toolbox_item.ts index a7d8e9153..b6eabcf14 100644 --- a/core/interfaces/i_collapsible_toolbox_item.ts +++ b/core/interfaces/i_collapsible_toolbox_item.ts @@ -18,8 +18,6 @@ import type {IToolboxItem} from './i_toolbox_item.js'; /** * Interface for an item in the toolbox that can be collapsed. - * - * @alias Blockly.ICollapsibleToolboxItem */ export interface ICollapsibleToolboxItem extends ISelectableToolboxItem { /** diff --git a/core/interfaces/i_component.ts b/core/interfaces/i_component.ts index f75a6b014..3d61f805b 100644 --- a/core/interfaces/i_component.ts +++ b/core/interfaces/i_component.ts @@ -17,8 +17,6 @@ goog.declareModuleId('Blockly.IComponent'); /** * The interface for a workspace component that can be registered with the * ComponentManager. - * - * @alias Blockly.IComponent */ export interface IComponent { /** diff --git a/core/interfaces/i_connection_checker.ts b/core/interfaces/i_connection_checker.ts index deb3c59fa..5472aecd1 100644 --- a/core/interfaces/i_connection_checker.ts +++ b/core/interfaces/i_connection_checker.ts @@ -17,8 +17,6 @@ goog.declareModuleId('Blockly.IConnectionChecker'); /** * Class for connection type checking logic. - * - * @alias Blockly.IConnectionChecker */ export interface IConnectionChecker { /** diff --git a/core/interfaces/i_contextmenu.ts b/core/interfaces/i_contextmenu.ts index b0a28630e..f005fdbdd 100644 --- a/core/interfaces/i_contextmenu.ts +++ b/core/interfaces/i_contextmenu.ts @@ -13,7 +13,6 @@ import * as goog from '../../closure/goog/goog.js'; goog.declareModuleId('Blockly.IContextMenu'); -/** @alias Blockly.IContextMenu */ export interface IContextMenu { /** * Show the context menu for this object. diff --git a/core/interfaces/i_copyable.ts b/core/interfaces/i_copyable.ts index 4c6a7a62c..6204eeacc 100644 --- a/core/interfaces/i_copyable.ts +++ b/core/interfaces/i_copyable.ts @@ -16,7 +16,6 @@ import type {WorkspaceSvg} from '../workspace_svg.js'; import type {ISelectable} from './i_selectable.js'; -/** @alias Blockly.ICopyable */ export interface ICopyable extends ISelectable { /** * Encode for copying. diff --git a/core/interfaces/i_deletable.ts b/core/interfaces/i_deletable.ts index 4a1683574..507cdca33 100644 --- a/core/interfaces/i_deletable.ts +++ b/core/interfaces/i_deletable.ts @@ -15,8 +15,6 @@ goog.declareModuleId('Blockly.IDeletable'); /** * The interface for an object that can be deleted. - * - * @alias Blockly.IDeletable */ export interface IDeletable { /** diff --git a/core/interfaces/i_delete_area.ts b/core/interfaces/i_delete_area.ts index 1d9752b05..1c9a1d0d0 100644 --- a/core/interfaces/i_delete_area.ts +++ b/core/interfaces/i_delete_area.ts @@ -20,8 +20,6 @@ import type {IDraggable} from './i_draggable.js'; /** * Interface for a component that can delete a block or bubble that is dropped * on top of it. - * - * @alias Blockly.IDeleteArea */ export interface IDeleteArea extends IDragTarget { /** diff --git a/core/interfaces/i_drag_target.ts b/core/interfaces/i_drag_target.ts index f1e1b3c97..eef00dcd9 100644 --- a/core/interfaces/i_drag_target.ts +++ b/core/interfaces/i_drag_target.ts @@ -23,8 +23,6 @@ import type {IComponent} from './i_component.js'; /** * Interface for a component with custom behaviour when a block or bubble is * dragged over or dropped on top of it. - * - * @alias Blockly.IDragTarget */ export interface IDragTarget extends IComponent { /** diff --git a/core/interfaces/i_draggable.ts b/core/interfaces/i_draggable.ts index 313525d5e..f7a080949 100644 --- a/core/interfaces/i_draggable.ts +++ b/core/interfaces/i_draggable.ts @@ -17,7 +17,5 @@ import type {IDeletable} from './i_deletable.js'; /** * The interface for an object that can be dragged. - * - * @alias Blockly.IDraggable */ export interface IDraggable extends IDeletable {} diff --git a/core/interfaces/i_flyout.ts b/core/interfaces/i_flyout.ts index 825660686..a5488c549 100644 --- a/core/interfaces/i_flyout.ts +++ b/core/interfaces/i_flyout.ts @@ -22,8 +22,6 @@ import type {IRegistrable} from './i_registrable.js'; /** * Interface for a flyout. - * - * @alias Blockly.IFlyout */ export interface IFlyout extends IRegistrable { /** Whether the flyout is laid out horizontally or not. */ diff --git a/core/interfaces/i_keyboard_accessible.ts b/core/interfaces/i_keyboard_accessible.ts index d60fb0224..2d48bad9c 100644 --- a/core/interfaces/i_keyboard_accessible.ts +++ b/core/interfaces/i_keyboard_accessible.ts @@ -15,8 +15,6 @@ goog.declareModuleId('Blockly.IKeyboardAccessible'); /** * An interface for an object that handles keyboard shortcuts. - * - * @alias Blockly.IKeyboardAccessible */ export interface IKeyboardAccessible { /** diff --git a/core/interfaces/i_metrics_manager.ts b/core/interfaces/i_metrics_manager.ts index be82b4991..c60dc7f52 100644 --- a/core/interfaces/i_metrics_manager.ts +++ b/core/interfaces/i_metrics_manager.ts @@ -17,8 +17,6 @@ goog.declareModuleId('Blockly.IMetricsManager'); /** * Interface for a metrics manager. - * - * @alias Blockly.IMetricsManager */ export interface IMetricsManager { /** diff --git a/core/interfaces/i_movable.ts b/core/interfaces/i_movable.ts index eed624de9..a0c420a9b 100644 --- a/core/interfaces/i_movable.ts +++ b/core/interfaces/i_movable.ts @@ -15,8 +15,6 @@ goog.declareModuleId('Blockly.IMovable'); /** * The interface for an object that is movable. - * - * @alias Blockly.IMovable */ export interface IMovable { /** diff --git a/core/interfaces/i_positionable.ts b/core/interfaces/i_positionable.ts index 7edf0c694..73cc299b7 100644 --- a/core/interfaces/i_positionable.ts +++ b/core/interfaces/i_positionable.ts @@ -19,8 +19,6 @@ import type {IComponent} from './i_component.js'; /** * Interface for a component that is positioned on top of the workspace. - * - * @alias Blockly.IPositionable */ export interface IPositionable extends IComponent { /** diff --git a/core/interfaces/i_registrable.ts b/core/interfaces/i_registrable.ts index 9faa55e9a..b43fff5d3 100644 --- a/core/interfaces/i_registrable.ts +++ b/core/interfaces/i_registrable.ts @@ -16,7 +16,5 @@ goog.declareModuleId('Blockly.IRegistrable'); /** * The interface for a Blockly component that can be registered. - * - * @alias Blockly.IRegistrable */ export interface IRegistrable {} diff --git a/core/interfaces/i_selectable.ts b/core/interfaces/i_selectable.ts index a29bdb9cb..f76bdd969 100644 --- a/core/interfaces/i_selectable.ts +++ b/core/interfaces/i_selectable.ts @@ -18,8 +18,6 @@ import type {IMovable} from './i_movable.js'; /** * The interface for an object that is selectable. - * - * @alias Blockly.ISelectable */ export interface ISelectable extends IDeletable, IMovable { id: string; diff --git a/core/interfaces/i_selectable_toolbox_item.ts b/core/interfaces/i_selectable_toolbox_item.ts index 765a42c6e..b43c320b2 100644 --- a/core/interfaces/i_selectable_toolbox_item.ts +++ b/core/interfaces/i_selectable_toolbox_item.ts @@ -18,8 +18,6 @@ import type {IToolboxItem} from './i_toolbox_item.js'; /** * Interface for an item in the toolbox that can be selected. - * - * @alias Blockly.ISelectableToolboxItem */ export interface ISelectableToolboxItem extends IToolboxItem { /** diff --git a/core/interfaces/i_serializer.ts b/core/interfaces/i_serializer.ts index 3bf99fe4c..495be1f1c 100644 --- a/core/interfaces/i_serializer.ts +++ b/core/interfaces/i_serializer.ts @@ -18,8 +18,6 @@ import type {Workspace} from '../workspace.js'; /** * Serializes and deserializes a plugin or system. - * - * @alias Blockly.serialization.ISerializer.ISerializer */ export interface ISerializer { /** diff --git a/core/interfaces/i_styleable.ts b/core/interfaces/i_styleable.ts index 7e98a6dc7..f9554680e 100644 --- a/core/interfaces/i_styleable.ts +++ b/core/interfaces/i_styleable.ts @@ -15,8 +15,6 @@ goog.declareModuleId('Blockly.IStyleable'); /** * Interface for an object that a style can be added to. - * - * @alias Blockly.IStyleable */ export interface IStyleable { /** diff --git a/core/interfaces/i_toolbox.ts b/core/interfaces/i_toolbox.ts index fdc021f5a..9e936a54a 100644 --- a/core/interfaces/i_toolbox.ts +++ b/core/interfaces/i_toolbox.ts @@ -21,8 +21,6 @@ import type {WorkspaceSvg} from '../workspace_svg.js'; /** * Interface for a toolbox. - * - * @alias Blockly.IToolbox */ export interface IToolbox extends IRegistrable { /** Initializes the toolbox. */ diff --git a/core/interfaces/i_toolbox_item.ts b/core/interfaces/i_toolbox_item.ts index a478cae5c..3c5344725 100644 --- a/core/interfaces/i_toolbox_item.ts +++ b/core/interfaces/i_toolbox_item.ts @@ -15,8 +15,6 @@ goog.declareModuleId('Blockly.IToolboxItem'); /** * Interface for an item in the toolbox. - * - * @alias Blockly.IToolboxItem */ export interface IToolboxItem { /** diff --git a/core/internal_constants.ts b/core/internal_constants.ts index d1bd27b48..330d2662e 100644 --- a/core/internal_constants.ts +++ b/core/internal_constants.ts @@ -19,7 +19,6 @@ 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; @@ -28,7 +27,6 @@ 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; @@ -36,7 +34,6 @@ 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[] = []; @@ -52,7 +49,6 @@ 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'; @@ -62,7 +58,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'; diff --git a/core/keyboard_nav/ast_node.ts b/core/keyboard_nav/ast_node.ts index 27d0a4554..b3e18d299 100644 --- a/core/keyboard_nav/ast_node.ts +++ b/core/keyboard_nav/ast_node.ts @@ -28,8 +28,6 @@ import type {Workspace} from '../workspace.js'; * Class for an AST node. * It is recommended that you use one of the createNode methods instead of * creating a node directly. - * - * @alias Blockly.ASTNode */ export class ASTNode { /** @@ -56,7 +54,6 @@ export class ASTNode { * Must be in ASTNode.types. * @param location The position in the AST. * @param opt_params Optional dictionary of options. - * @alias Blockly.ASTNode */ constructor(type: string, location: IASTNodeLocation, opt_params?: Params) { if (!location) { diff --git a/core/keyboard_nav/basic_cursor.ts b/core/keyboard_nav/basic_cursor.ts index 648158fc6..5f0b4dfa4 100644 --- a/core/keyboard_nav/basic_cursor.ts +++ b/core/keyboard_nav/basic_cursor.ts @@ -23,14 +23,11 @@ import {Cursor} from './cursor.js'; * Class for a basic cursor. * This will allow the user to get to all nodes in the AST by hitting next or * previous. - * - * @alias Blockly.BasicCursor */ export class BasicCursor extends Cursor { /** Name used for registering a basic cursor. */ static readonly registrationName = 'basicCursor'; - /** @alias Blockly.BasicCursor */ constructor() { super(); } diff --git a/core/keyboard_nav/cursor.ts b/core/keyboard_nav/cursor.ts index 7fcf603e5..31ca083d6 100644 --- a/core/keyboard_nav/cursor.ts +++ b/core/keyboard_nav/cursor.ts @@ -22,13 +22,10 @@ import {Marker} from './marker.js'; /** * Class for a cursor. * A cursor controls how a user navigates the Blockly AST. - * - * @alias Blockly.Cursor */ export class Cursor extends Marker { override type = 'cursor'; - /** @alias Blockly.Cursor */ constructor() { super(); } diff --git a/core/keyboard_nav/marker.ts b/core/keyboard_nav/marker.ts index 725bc26e3..d569f3637 100644 --- a/core/keyboard_nav/marker.ts +++ b/core/keyboard_nav/marker.ts @@ -22,8 +22,6 @@ import type {ASTNode} from './ast_node.js'; /** * Class for a marker. * This is used in keyboard navigation to save a location in the Blockly AST. - * - * @alias Blockly.Marker */ export class Marker { /** The colour of the marker. */ diff --git a/core/keyboard_nav/tab_navigate_cursor.ts b/core/keyboard_nav/tab_navigate_cursor.ts index 588ddede5..eb4395969 100644 --- a/core/keyboard_nav/tab_navigate_cursor.ts +++ b/core/keyboard_nav/tab_navigate_cursor.ts @@ -21,8 +21,6 @@ import {BasicCursor} from './basic_cursor.js'; /** * A cursor for navigating between tab navigable fields. - * - * @alias Blockly.TabNavigateCursor */ export class TabNavigateCursor extends BasicCursor { /** diff --git a/core/marker_manager.ts b/core/marker_manager.ts index 6bc928c1b..653e220a9 100644 --- a/core/marker_manager.ts +++ b/core/marker_manager.ts @@ -19,8 +19,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; /** * Class to manage the multiple markers and the cursor on a workspace. - * - * @alias Blockly.MarkerManager */ export class MarkerManager { /** The name of the local marker. */ diff --git a/core/menu.ts b/core/menu.ts index 85b8070cf..0b800d6ff 100644 --- a/core/menu.ts +++ b/core/menu.ts @@ -24,8 +24,6 @@ import * as style from './utils/style.js'; /** * A basic menu class. - * - * @alias Blockly.Menu */ export class Menu { /** diff --git a/core/menuitem.ts b/core/menuitem.ts index ee9b2ad0c..55c623ff8 100644 --- a/core/menuitem.ts +++ b/core/menuitem.ts @@ -19,8 +19,6 @@ import * as idGenerator from './utils/idgenerator.js'; /** * Class representing an item in a menu. - * - * @alias Blockly.MenuItem */ export class MenuItem { /** Is the menu item clickable, as opposed to greyed-out. */ diff --git a/core/metrics_manager.ts b/core/metrics_manager.ts index 082a8c3a9..615d19385 100644 --- a/core/metrics_manager.ts +++ b/core/metrics_manager.ts @@ -24,8 +24,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; /** * The manager for all workspace metrics calculations. - * - * @alias Blockly.MetricsManager */ export class MetricsManager implements IMetricsManager { /** The workspace to calculate metrics for. */ diff --git a/core/mutator.ts b/core/mutator.ts index de9da6eb2..30b613d50 100644 --- a/core/mutator.ts +++ b/core/mutator.ts @@ -38,8 +38,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; /** * Class for a mutator dialog. - * - * @alias Blockly.Mutator */ export class Mutator extends Icon { private quarkNames: string[]; diff --git a/core/names.ts b/core/names.ts index b6b026fd3..c6602d825 100644 --- a/core/names.ts +++ b/core/names.ts @@ -21,8 +21,6 @@ import type {Workspace} from './workspace.js'; /** * Class for a database of entity names (variables, procedures, etc). - * - * @alias Blockly.Names */ export class Names { static DEVELOPER_VARIABLE_TYPE: NameType; @@ -251,7 +249,6 @@ export namespace Names { * getName('foo', 'VARIABLE') = 'foo' * getName('foo', 'PROCEDURE') = 'foo2' * - * @alias Blockly.Names.NameType */ export enum NameType { DEVELOPER_VARIABLE = 'DEVELOPER_VARIABLE', diff --git a/core/options.ts b/core/options.ts index 92fd7182e..4f66582bb 100644 --- a/core/options.ts +++ b/core/options.ts @@ -26,8 +26,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; /** * Parse the user-specified options, using reasonable defaults where behaviour * is unspecified. - * - * @alias Blockly.Options */ export class Options { RTL: boolean; diff --git a/core/positionable_helpers.ts b/core/positionable_helpers.ts index 035ba91cd..34d1ef97a 100644 --- a/core/positionable_helpers.ts +++ b/core/positionable_helpers.ts @@ -23,7 +23,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; /** * Enum for vertical positioning. * - * @alias Blockly.uiPosition.verticalPosition * @internal */ export enum verticalPosition { @@ -34,7 +33,6 @@ export enum verticalPosition { /** * Enum for horizontal positioning. * - * @alias Blockly.uiPosition.horizontalPosition * @internal */ export enum horizontalPosition { @@ -45,7 +43,6 @@ export enum horizontalPosition { /** * An object defining a horizontal and vertical positioning. * - * @alias Blockly.uiPosition.Position * @internal */ export interface Position { @@ -56,7 +53,6 @@ export interface Position { /** * Enum for bump rules to use for dealing with collisions. * - * @alias Blockly.uiPosition.bumpDirection * @internal */ export enum bumpDirection { @@ -77,7 +73,6 @@ export enum bumpDirection { * @param metrics The workspace UI metrics. * @param workspace The workspace. * @returns The suggested start position. - * @alias Blockly.uiPosition.getStartPositionRect * @internal */ export function getStartPositionRect( @@ -124,7 +119,6 @@ export function getStartPositionRect( * @param workspace The workspace. * @param metrics The workspace metrics. * @returns The suggested corner position. - * @alias Blockly.uiPosition.getCornerOppositeToolbox * @internal */ export function getCornerOppositeToolbox( @@ -151,7 +145,6 @@ export function getCornerOppositeToolbox( * @param savedPositions List of rectangles that represent the positions of UI * elements already placed. * @returns The suggested position rectangle. - * @alias Blockly.uiPosition.bumpPositionRect * @internal */ export function bumpPositionRect( diff --git a/core/procedures.ts b/core/procedures.ts index cd36b660b..6213888ec 100644 --- a/core/procedures.ts +++ b/core/procedures.ts @@ -43,15 +43,11 @@ import * as Xml from './xml.js'; * procedure blocks. * See also Blockly.Variables.CATEGORY_NAME and * Blockly.VariablesDynamic.CATEGORY_NAME. - * - * @alias Blockly.Procedures.CATEGORY_NAME */ export const CATEGORY_NAME = 'PROCEDURE'; /** * The default argument for a procedures_mutatorarg block. - * - * @alias Blockly.Procedures.DEFAULT_ARG */ export const DEFAULT_ARG = 'x'; @@ -59,8 +55,6 @@ export type ProcedureTuple = [string, string[], boolean]; /** * Procedure block type. - * - * @alias Blockly.Procedures.ProcedureBlock */ export interface ProcedureBlock { getProcedureCall: () => string; @@ -95,7 +89,6 @@ function isLegacyProcedureCallBlock(block: Object): * @returns Pair of arrays, the first contains procedures without return * variables, the second with. Each procedure is defined by a three-element * list of name, parameter list, and return value boolean. - * @alias Blockly.Procedures.allProcedures */ export function allProcedures(root: Workspace): [ProcedureTuple[], ProcedureTuple[]] { @@ -155,7 +148,6 @@ function procTupleComparator(ta: ProcedureTuple, tb: ProcedureTuple): number { * @param name Proposed procedure name. * @param block Block to disambiguate. * @returns Non-colliding name. - * @alias Blockly.Procedures.findLegalName */ export function findLegalName(name: string, block: Block): string { if (block.isInFlyout) { @@ -197,7 +189,6 @@ function isLegalName( * @param opt_exclude Optional block to exclude from comparisons (one doesn't * want to collide with oneself). * @returns True if the name is used, otherwise return false. - * @alias Blockly.Procedures.isNameUsed */ export function isNameUsed( name: string, workspace: Workspace, opt_exclude?: Block): boolean { @@ -221,7 +212,6 @@ export function isNameUsed( * * @param name The proposed new name. * @returns The accepted name. - * @alias Blockly.Procedures.rename */ export function rename(this: Field, name: string): string { const block = this.getSourceBlock(); @@ -256,7 +246,6 @@ export function rename(this: Field, name: string): string { * * @param workspace The workspace containing procedures. * @returns Array of XML block elements. - * @alias Blockly.Procedures.flyoutCategory */ export function flyoutCategory(workspace: WorkspaceSvg): Element[] { const xmlList = []; @@ -373,7 +362,6 @@ 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) { @@ -419,7 +407,6 @@ function mutatorChangeListener(e: Abstract) { * @param name Name of procedure. * @param workspace The workspace to find callers in. * @returns Array of caller blocks. - * @alias Blockly.Procedures.getCallers */ export function getCallers(name: string, workspace: Workspace): Block[] { return workspace.getAllBlocks(false).filter((block) => { @@ -444,7 +431,6 @@ function blockIsModernCallerFor(block: Block, procName: string): boolean { * callers. * * @param defBlock Procedure definition block. - * @alias Blockly.Procedures.mutateCallers */ export function mutateCallers(defBlock: Block) { const oldRecordUndo = eventUtils.getRecordUndo(); @@ -478,7 +464,6 @@ export function mutateCallers(defBlock: Block) { * @param name Name of procedure. * @param workspace The workspace to search. * @returns The procedure definition block, or null not found. - * @alias Blockly.Procedures.getDefinition */ export function getDefinition(name: string, workspace: Workspace): Block|null { // Do not assume procedure is a top block. Some languages allow nested diff --git a/core/registry.ts b/core/registry.ts index f032fe362..c3219934b 100644 --- a/core/registry.ts +++ b/core/registry.ts @@ -48,15 +48,11 @@ const nameMap: {[key: string]: {[key: string]: string}} = Object.create(null); /** * The string used to register the default class for a type of plugin. - * - * @alias Blockly.registry.DEFAULT */ export const DEFAULT = 'default'; /** * A name with the type of the element stored in the generic. - * - * @alias Blockly.registry.Type */ export class Type<_T> { /** @param name The name of the registry type. */ @@ -112,7 +108,6 @@ export class Type<_T> { * @throws {Error} if the type or name is empty, a name with the given type has * already been registered, or if the given class or object is not valid for * its type. - * @alias Blockly.registry.register */ export function register( type: string|Type, name: string, @@ -181,7 +176,6 @@ function validate(type: string, registryItem: Function|AnyDuringMigration) { * @param type The type of the plugin. * (e.g. Field, Renderer) * @param name The plugin's name. (Ex. field_angle, geras) - * @alias Blockly.registry.unregister */ export function unregister(type: string|Type, name: string) { type = String(type).toLowerCase(); @@ -237,7 +231,6 @@ function getItem( * @param name The plugin's name. (Ex. field_angle, geras) * @returns True if the registry has an item with the given type and name, false * otherwise. - * @alias Blockly.registry.hasItem */ export function hasItem(type: string|Type, name: string): boolean { type = String(type).toLowerCase(); @@ -258,7 +251,6 @@ export function hasItem(type: string|Type, name: string): boolean { * @param opt_throwIfMissing Whether or not to throw an error if we are unable * to find the plugin. * @returns The class with the given name and type or null if none exists. - * @alias Blockly.registry.getClass */ export function getClass( type: string|Type, name: string, opt_throwIfMissing?: boolean): @@ -277,7 +269,6 @@ export function getClass( * @param opt_throwIfMissing Whether or not to throw an error if we are unable * to find the object. * @returns The object with the given name and type or null if none exists. - * @alias Blockly.registry.getObject */ export function getObject( type: string|Type, name: string, opt_throwIfMissing?: boolean): T|null { @@ -293,7 +284,6 @@ export function getObject( * @param opt_throwIfMissing Whether or not to throw an error if we are unable * to find the object. False by default. * @returns A map of objects with the given type, or null if none exists. - * @alias Blockly.registry.getAllItems */ export function getAllItems( type: string|Type, opt_cased?: boolean, opt_throwIfMissing?: boolean): @@ -331,7 +321,6 @@ export function getAllItems( * @param opt_throwIfMissing Whether or not to throw an error if we are unable * to find the plugin. * @returns The class for the plugin. - * @alias Blockly.registry.getClassFromOptions */ export function getClassFromOptions( type: Type, options: Options, opt_throwIfMissing?: boolean): diff --git a/core/rendered_connection.ts b/core/rendered_connection.ts index 82af1b1b1..05b98e75c 100644 --- a/core/rendered_connection.ts +++ b/core/rendered_connection.ts @@ -43,8 +43,6 @@ const BUMP_RANDOMNESS = 10; /** * Class for a connection between blocks that may be rendered on screen. - * - * @alias Blockly.RenderedConnection */ export class RenderedConnection extends Connection { // TODO(b/109816955): remove '!', see go/strict-prop-init-fix. diff --git a/core/renderers/common/block_rendering.ts b/core/renderers/common/block_rendering.ts index 3700bfa91..a7b558740 100644 --- a/core/renderers/common/block_rendering.ts +++ b/core/renderers/common/block_rendering.ts @@ -63,7 +63,6 @@ export function register(name: string, rendererClass: Function) { * Unregisters the renderer registered with the given name. * * @param name The name of the renderer. - * @alias Blockly.blockRendering.unregister */ export function unregister(name: string) { registry.unregister(registry.Type.RENDERER, name); @@ -72,7 +71,6 @@ export function unregister(name: string) { /** * Turn off the blocks debugger. * - * @alias Blockly.blockRendering.stopDebugger * @deprecated Use the debug renderer in **\@blockly/dev-tools** (See {@link * https://www.npmjs.com/package/@blockly/dev-tools}.) * @internal @@ -93,7 +91,6 @@ export function stopDebugger() { * @param opt_rendererOverrides Rendering constant overrides. * @returns The new instance of a renderer. * Already initialized. - * @alias Blockly.blockRendering.init * @internal */ export function init( diff --git a/core/renderers/common/constants.ts b/core/renderers/common/constants.ts index 82854abb4..c5e294bc2 100644 --- a/core/renderers/common/constants.ts +++ b/core/renderers/common/constants.ts @@ -105,8 +105,6 @@ export function isDynamicShape(shape: Shape): shape is DynamicShape { /** * An object that provides constants for rendering blocks. - * - * @alias Blockly.blockRendering.ConstantProvider */ export class ConstantProvider { /** The size of an empty spacer. */ diff --git a/core/renderers/common/debug.ts b/core/renderers/common/debug.ts index d54a2866e..6d331cc10 100644 --- a/core/renderers/common/debug.ts +++ b/core/renderers/common/debug.ts @@ -21,7 +21,6 @@ let useDebugger = false; * Returns whether the debugger is turned on. * * @returns Whether the debugger is turned on. - * @alias Blockly.blockRendering.debug.isDebuggerEnabled * @internal */ export function isDebuggerEnabled(): boolean { @@ -31,7 +30,6 @@ export function isDebuggerEnabled(): boolean { /** * Turn on the blocks debugger. * - * @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 @@ -46,7 +44,6 @@ export function startDebugger() { /** * Turn off the blocks debugger. * - * @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 diff --git a/core/renderers/common/debugger.ts b/core/renderers/common/debugger.ts index 4ec0e2ab6..89689630f 100644 --- a/core/renderers/common/debugger.ts +++ b/core/renderers/common/debugger.ts @@ -32,8 +32,6 @@ import type {RenderInfo} from './info.js'; /** * An object that renders rectangles and dots for debugging rendering code. - * - * @alias Blockly.blockRendering.Debug */ export class Debug { /** diff --git a/core/renderers/common/drawer.ts b/core/renderers/common/drawer.ts index 8751252da..c48397db1 100644 --- a/core/renderers/common/drawer.ts +++ b/core/renderers/common/drawer.ts @@ -32,8 +32,6 @@ import type {RenderInfo} from './info.js'; /** * An object that draws a block based on the given rendering information. - * - * @alias Blockly.blockRendering.Drawer */ export class Drawer { block_: BlockSvg; diff --git a/core/renderers/common/i_path_object.ts b/core/renderers/common/i_path_object.ts index 0d49835ec..661e61c6f 100644 --- a/core/renderers/common/i_path_object.ts +++ b/core/renderers/common/i_path_object.ts @@ -24,7 +24,6 @@ import {RenderedConnection} from '../../rendered_connection.js'; * * @param _root The root SVG element. * @param _constants The renderer's constants. - * @alias Blockly.blockRendering.IPathObject */ export interface IPathObject { /** diff --git a/core/renderers/common/info.ts b/core/renderers/common/info.ts index 1d0a9e0e7..16f2c726a 100644 --- a/core/renderers/common/info.ts +++ b/core/renderers/common/info.ts @@ -47,8 +47,6 @@ import type {Renderer} from './renderer.js'; * 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. - * - * @alias Blockly.blockRendering.RenderInfo */ export class RenderInfo { block_: BlockSvg; diff --git a/core/renderers/common/marker_svg.ts b/core/renderers/common/marker_svg.ts index 67e4fdb8a..6df65adf8 100644 --- a/core/renderers/common/marker_svg.ts +++ b/core/renderers/common/marker_svg.ts @@ -46,8 +46,6 @@ const HEIGHT_MULTIPLIER = 3 / 4; /** * Class for a marker. - * - * @alias Blockly.blockRendering.MarkerSvg */ export class MarkerSvg { /** diff --git a/core/renderers/common/path_object.ts b/core/renderers/common/path_object.ts index c28a629e4..5d54d929f 100644 --- a/core/renderers/common/path_object.ts +++ b/core/renderers/common/path_object.ts @@ -25,8 +25,6 @@ import type {IPathObject} from './i_path_object.js'; /** * An object that handles creating and setting each of the SVG elements * used by the renderer. - * - * @alias Blockly.blockRendering.PathObject */ export class PathObject implements IPathObject { svgRoot: SVGElement; diff --git a/core/renderers/common/renderer.ts b/core/renderers/common/renderer.ts index ef2ab2146..fa0314cca 100644 --- a/core/renderers/common/renderer.ts +++ b/core/renderers/common/renderer.ts @@ -35,8 +35,6 @@ import {PathObject} from './path_object.js'; /** * The base class for a block renderer. - * - * @alias Blockly.blockRendering.Renderer */ export class Renderer implements IRegistrable { /** The renderer's constant provider. */ diff --git a/core/renderers/geras/constants.ts b/core/renderers/geras/constants.ts index 7eb829d94..b7b9cacb7 100644 --- a/core/renderers/geras/constants.ts +++ b/core/renderers/geras/constants.ts @@ -18,8 +18,6 @@ import {ConstantProvider as BaseConstantProvider} from '../common/constants.js'; /** * An object that provides constants for rendering blocks in Geras mode. - * - * @alias Blockly.geras.ConstantProvider */ export class ConstantProvider extends BaseConstantProvider { override FIELD_TEXT_BASELINE_CENTER = false; diff --git a/core/renderers/geras/drawer.ts b/core/renderers/geras/drawer.ts index b0469e259..f886888df 100644 --- a/core/renderers/geras/drawer.ts +++ b/core/renderers/geras/drawer.ts @@ -27,8 +27,6 @@ import type {PathObject} from './path_object.js'; /** * An object that draws a block based on the given rendering information. - * - * @alias Blockly.geras.Drawer */ export class Drawer extends BaseDrawer { highlighter_: Highlighter; diff --git a/core/renderers/geras/highlight_constants.ts b/core/renderers/geras/highlight_constants.ts index fab2ec9b9..bc8d768c8 100644 --- a/core/renderers/geras/highlight_constants.ts +++ b/core/renderers/geras/highlight_constants.ts @@ -64,8 +64,6 @@ export interface JaggedTeeth { * Some highlights are simple offsets of the parent paths and can be generated * programmatically. Others, especially on curves, are just made out of piles * of constants and are hard to tweak. - * - * @alias Blockly.geras.HighlightConstantProvider */ export class HighlightConstantProvider { constantProvider: ConstantProvider; diff --git a/core/renderers/geras/highlighter.ts b/core/renderers/geras/highlighter.ts index 8a619fa34..097456dfd 100644 --- a/core/renderers/geras/highlighter.ts +++ b/core/renderers/geras/highlighter.ts @@ -36,8 +36,6 @@ import type {InlineInput} from './measurables/inline_input.js'; * position of each part of the block. The resulting paths are not continuous * or closed paths. The highlights for tabs and notches are loosely based on * tab and notch shapes, but are not exactly the same. - * - * @alias Blockly.geras.Highlighter */ export class Highlighter { info_: RenderInfo; diff --git a/core/renderers/geras/info.ts b/core/renderers/geras/info.ts index 305cde369..9dcfcb1ef 100644 --- a/core/renderers/geras/info.ts +++ b/core/renderers/geras/info.ts @@ -39,8 +39,6 @@ import type {Renderer} from './renderer.js'; * 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. - * - * @alias Blockly.geras.RenderInfo */ export class RenderInfo extends BaseRenderInfo { // TODO(b/109816955): remove '!', see go/strict-prop-init-fix. diff --git a/core/renderers/geras/measurables/inline_input.ts b/core/renderers/geras/measurables/inline_input.ts index be3b6578a..016f1fbd4 100644 --- a/core/renderers/geras/measurables/inline_input.ts +++ b/core/renderers/geras/measurables/inline_input.ts @@ -23,8 +23,6 @@ import type {ConstantProvider as GerasConstantProvider} from '../constants.js'; /** * An object containing information about the space an inline input takes up * during rendering. - * - * @alias Blockly.geras.InlineInput */ export class InlineInput extends BaseInlineInput { override constants_: GerasConstantProvider; diff --git a/core/renderers/geras/measurables/statement_input.ts b/core/renderers/geras/measurables/statement_input.ts index 2fa21fa11..58e35ac5f 100644 --- a/core/renderers/geras/measurables/statement_input.ts +++ b/core/renderers/geras/measurables/statement_input.ts @@ -23,8 +23,6 @@ import type {ConstantProvider as GerasConstantProvider} from '../constants.js'; /** * An object containing information about the space a statement input takes up * during rendering. - * - * @alias Blockly.geras.StatementInput */ export class StatementInput extends BaseStatementInput { override constants_: GerasConstantProvider; diff --git a/core/renderers/geras/path_object.ts b/core/renderers/geras/path_object.ts index 07d2fcbc5..fc11f5a6c 100644 --- a/core/renderers/geras/path_object.ts +++ b/core/renderers/geras/path_object.ts @@ -25,8 +25,6 @@ import type {ConstantProvider} from './constants.js'; /** * An object that handles creating and setting each of the SVG elements * used by the renderer. - * - * @alias Blockly.geras.PathObject */ export class PathObject extends BasePathObject { /** @internal */ diff --git a/core/renderers/geras/renderer.ts b/core/renderers/geras/renderer.ts index bdc4969b2..7f0c50ed8 100644 --- a/core/renderers/geras/renderer.ts +++ b/core/renderers/geras/renderer.ts @@ -27,8 +27,6 @@ import {PathObject} from './path_object.js'; /** * The geras renderer. - * - * @alias Blockly.geras.Renderer */ export class Renderer extends BaseRenderer { /** The renderer's highlight constant provider. */ diff --git a/core/renderers/measurables/base.ts b/core/renderers/measurables/base.ts index 105396b63..48ab5b3b0 100644 --- a/core/renderers/measurables/base.ts +++ b/core/renderers/measurables/base.ts @@ -21,8 +21,6 @@ import {Types} from './types.js'; * The base class to represent a part of a block that takes up space during * rendering. The constructor for each non-spacer Measurable records the size * of the block element (e.g. field, statement input). - * - * @alias Blockly.blockRendering.Measurable */ export class Measurable { width = 0; diff --git a/core/renderers/measurables/bottom_row.ts b/core/renderers/measurables/bottom_row.ts index f72809052..73602c5af 100644 --- a/core/renderers/measurables/bottom_row.ts +++ b/core/renderers/measurables/bottom_row.ts @@ -26,8 +26,6 @@ import {Types} from './types.js'; * a block as well as spacing information for the bottom row. * Elements in a bottom row can consist of corners, spacers and next * connections. - * - * @alias Blockly.blockRendering.BottomRow */ export class BottomRow extends Row { /** diff --git a/core/renderers/measurables/connection.ts b/core/renderers/measurables/connection.ts index ab4dbcd37..3f6080c5f 100644 --- a/core/renderers/measurables/connection.ts +++ b/core/renderers/measurables/connection.ts @@ -24,8 +24,6 @@ import {Types} from './types.js'; /** * The base class to represent a connection and the space that it takes up on * the block. - * - * @alias Blockly.blockRendering.Connection */ export class Connection extends Measurable { shape: Shape; diff --git a/core/renderers/measurables/external_value_input.ts b/core/renderers/measurables/external_value_input.ts index 86adebe9d..7e4e57731 100644 --- a/core/renderers/measurables/external_value_input.ts +++ b/core/renderers/measurables/external_value_input.ts @@ -24,8 +24,6 @@ import {Types} from './types.js'; /** * An object containing information about the space an external value input * takes up during rendering - * - * @alias Blockly.blockRendering.ExternalValueInput */ export class ExternalValueInput extends InputConnection { override height = 0; diff --git a/core/renderers/measurables/field.ts b/core/renderers/measurables/field.ts index 344f3e636..140011ae4 100644 --- a/core/renderers/measurables/field.ts +++ b/core/renderers/measurables/field.ts @@ -25,8 +25,6 @@ import {Types} from './types.js'; /** * An object containing information about the space a field takes up during * rendering - * - * @alias Blockly.blockRendering.Field */ export class Field extends Measurable { isEditable: boolean; diff --git a/core/renderers/measurables/hat.ts b/core/renderers/measurables/hat.ts index 2d747c834..52eec943f 100644 --- a/core/renderers/measurables/hat.ts +++ b/core/renderers/measurables/hat.ts @@ -22,8 +22,6 @@ import {Types} from './types.js'; /** * An object containing information about the space a hat takes up during * rendering. - * - * @alias Blockly.blockRendering.Hat */ export class Hat extends Measurable { ascenderHeight: number; diff --git a/core/renderers/measurables/icon.ts b/core/renderers/measurables/icon.ts index 3fdfd99fd..1259eaafd 100644 --- a/core/renderers/measurables/icon.ts +++ b/core/renderers/measurables/icon.ts @@ -24,8 +24,6 @@ import {Types} from './types.js'; /** * An object containing information about the space an icon takes up during * rendering - * - * @alias Blockly.blockRendering.Icon */ export class Icon extends Measurable { isVisible: boolean; diff --git a/core/renderers/measurables/in_row_spacer.ts b/core/renderers/measurables/in_row_spacer.ts index c3474f403..a28618b10 100644 --- a/core/renderers/measurables/in_row_spacer.ts +++ b/core/renderers/measurables/in_row_spacer.ts @@ -22,8 +22,6 @@ import {Types} from './types.js'; /** * An object containing information about a spacer between two elements on a * row. - * - * @alias Blockly.blockRendering.InRowSpacer */ export class InRowSpacer extends Measurable { /** diff --git a/core/renderers/measurables/inline_input.ts b/core/renderers/measurables/inline_input.ts index a252b5950..564d33227 100644 --- a/core/renderers/measurables/inline_input.ts +++ b/core/renderers/measurables/inline_input.ts @@ -24,8 +24,6 @@ import {Types} from './types.js'; /** * An object containing information about the space an inline input takes up * during rendering - * - * @alias Blockly.blockRendering.InlineInput */ export class InlineInput extends InputConnection { connectionHeight: number; diff --git a/core/renderers/measurables/input_connection.ts b/core/renderers/measurables/input_connection.ts index 3a2d23a06..4716dfde9 100644 --- a/core/renderers/measurables/input_connection.ts +++ b/core/renderers/measurables/input_connection.ts @@ -24,8 +24,6 @@ import {Types} from './types.js'; /** * The base class to represent an input that takes up space on a block * during rendering - * - * @alias Blockly.blockRendering.InputConnection */ export class InputConnection extends Connection { align: number; diff --git a/core/renderers/measurables/input_row.ts b/core/renderers/measurables/input_row.ts index 40854f958..d43e29be0 100644 --- a/core/renderers/measurables/input_row.ts +++ b/core/renderers/measurables/input_row.ts @@ -24,8 +24,6 @@ import {Types} from './types.js'; /** * An object containing information about a row that holds one or more inputs. - * - * @alias Blockly.blockRendering.InputRow */ export class InputRow extends Row { /** diff --git a/core/renderers/measurables/jagged_edge.ts b/core/renderers/measurables/jagged_edge.ts index b9721ffab..c65c24081 100644 --- a/core/renderers/measurables/jagged_edge.ts +++ b/core/renderers/measurables/jagged_edge.ts @@ -22,8 +22,6 @@ import {Types} from './types.js'; /** * An object containing information about the jagged edge of a collapsed block * takes up during rendering - * - * @alias Blockly.blockRendering.JaggedEdge */ export class JaggedEdge extends Measurable { /** diff --git a/core/renderers/measurables/next_connection.ts b/core/renderers/measurables/next_connection.ts index 9be182963..7ef5212e7 100644 --- a/core/renderers/measurables/next_connection.ts +++ b/core/renderers/measurables/next_connection.ts @@ -23,8 +23,6 @@ import {Types} from './types.js'; /** * An object containing information about the space a next connection takes * up during rendering. - * - * @alias Blockly.blockRendering.NextConnection */ export class NextConnection extends Connection { /** diff --git a/core/renderers/measurables/output_connection.ts b/core/renderers/measurables/output_connection.ts index 17a73c1c2..c2d407a96 100644 --- a/core/renderers/measurables/output_connection.ts +++ b/core/renderers/measurables/output_connection.ts @@ -23,8 +23,6 @@ import {Types} from './types.js'; /** * An object containing information about the space an output connection takes * up during rendering. - * - * @alias Blockly.blockRendering.OutputConnection */ export class OutputConnection extends Connection { startX: number; diff --git a/core/renderers/measurables/previous_connection.ts b/core/renderers/measurables/previous_connection.ts index cb65f8746..6d95b02e1 100644 --- a/core/renderers/measurables/previous_connection.ts +++ b/core/renderers/measurables/previous_connection.ts @@ -23,8 +23,6 @@ import {Types} from './types.js'; /** * An object containing information about the space a previous connection takes * up during rendering. - * - * @alias Blockly.blockRendering.PreviousConnection */ export class PreviousConnection extends Connection { /** diff --git a/core/renderers/measurables/round_corner.ts b/core/renderers/measurables/round_corner.ts index 0e0c809bf..7746b7998 100644 --- a/core/renderers/measurables/round_corner.ts +++ b/core/renderers/measurables/round_corner.ts @@ -22,8 +22,6 @@ import {Types} from './types.js'; /** * An object containing information about the space a rounded corner takes up * during rendering. - * - * @alias Blockly.blockRendering.RoundCorner */ export class RoundCorner extends Measurable { /** diff --git a/core/renderers/measurables/row.ts b/core/renderers/measurables/row.ts index 17aed1e07..2063e74d9 100644 --- a/core/renderers/measurables/row.ts +++ b/core/renderers/measurables/row.ts @@ -23,8 +23,6 @@ import {Types} from './types.js'; /** * An object representing a single row on a rendered block and all of its * subcomponents. - * - * @alias Blockly.blockRendering.Row */ export class Row { /** @internal */ diff --git a/core/renderers/measurables/spacer_row.ts b/core/renderers/measurables/spacer_row.ts index 2a9d1be26..1e1fdcfd3 100644 --- a/core/renderers/measurables/spacer_row.ts +++ b/core/renderers/measurables/spacer_row.ts @@ -21,8 +21,6 @@ import {Types} from './types.js'; /** * An object containing information about a spacer between two rows. - * - * @alias Blockly.blockRendering.SpacerRow */ export class SpacerRow extends Row { followsStatement = false; diff --git a/core/renderers/measurables/square_corner.ts b/core/renderers/measurables/square_corner.ts index a37e63d23..9e3e4b226 100644 --- a/core/renderers/measurables/square_corner.ts +++ b/core/renderers/measurables/square_corner.ts @@ -22,8 +22,6 @@ import {Types} from './types.js'; /** * An object containing information about the space a square corner takes up * during rendering. - * - * @alias Blockly.blockRendering.SquareCorner */ export class SquareCorner extends Measurable { /** diff --git a/core/renderers/measurables/statement_input.ts b/core/renderers/measurables/statement_input.ts index 58bbbdabe..f7f0ce137 100644 --- a/core/renderers/measurables/statement_input.ts +++ b/core/renderers/measurables/statement_input.ts @@ -24,8 +24,6 @@ import {Types} from './types.js'; /** * An object containing information about the space a statement input takes up * during rendering - * - * @alias Blockly.blockRendering.StatementInput */ export class StatementInput extends InputConnection { /** diff --git a/core/renderers/measurables/top_row.ts b/core/renderers/measurables/top_row.ts index 8c7c7f084..1ba9301b5 100644 --- a/core/renderers/measurables/top_row.ts +++ b/core/renderers/measurables/top_row.ts @@ -28,8 +28,6 @@ import {Types} from './types.js'; * connections. * After this constructor is called, the row will contain all non-spacer * elements it needs. - * - * @alias Blockly.blockRendering.TopRow */ export class TopRow extends Row { /** diff --git a/core/renderers/measurables/types.ts b/core/renderers/measurables/types.ts index d4be3297a..1667148e5 100644 --- a/core/renderers/measurables/types.ts +++ b/core/renderers/measurables/types.ts @@ -18,8 +18,6 @@ import type {Row} from './row.js'; /** * Types of rendering elements. - * - * @alias Blockly.blockRendering.Types */ class TypesContainer { [index: string]: number|Function; diff --git a/core/renderers/minimalist/constants.ts b/core/renderers/minimalist/constants.ts index f9dc23aee..10b5251b2 100644 --- a/core/renderers/minimalist/constants.ts +++ b/core/renderers/minimalist/constants.ts @@ -18,8 +18,6 @@ import {ConstantProvider as BaseConstantProvider} from '../common/constants.js'; /** * An object that provides constants for rendering blocks in the sample. - * - * @alias Blockly.minimalist.ConstantProvider */ export class ConstantProvider extends BaseConstantProvider { /** @internal */ diff --git a/core/renderers/minimalist/drawer.ts b/core/renderers/minimalist/drawer.ts index 1027a8d9d..0b45cc4da 100644 --- a/core/renderers/minimalist/drawer.ts +++ b/core/renderers/minimalist/drawer.ts @@ -20,8 +20,6 @@ import type {RenderInfo} from './info.js'; /** * An object that draws a block based on the given rendering information. - * - * @alias Blockly.minimalist.Drawer */ export class Drawer extends BaseDrawer { /** diff --git a/core/renderers/minimalist/info.ts b/core/renderers/minimalist/info.ts index aa31270eb..1af3d4e9a 100644 --- a/core/renderers/minimalist/info.ts +++ b/core/renderers/minimalist/info.ts @@ -24,8 +24,6 @@ import type {Renderer} from './renderer.js'; * 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. - * - * @alias Blockly.minimalist.RenderInfo */ export class RenderInfo extends BaseRenderInfo { // Exclamation is fine b/c this is assigned by the super constructor. diff --git a/core/renderers/minimalist/renderer.ts b/core/renderers/minimalist/renderer.ts index 2a4a509ee..0696f8e14 100644 --- a/core/renderers/minimalist/renderer.ts +++ b/core/renderers/minimalist/renderer.ts @@ -24,8 +24,6 @@ import {RenderInfo} from './info.js'; /** * The minimalist renderer. - * - * @alias Blockly.minimalist.Renderer */ export class Renderer extends BaseRenderer { /** diff --git a/core/renderers/thrasos/info.ts b/core/renderers/thrasos/info.ts index abedc8793..c7e62b612 100644 --- a/core/renderers/thrasos/info.ts +++ b/core/renderers/thrasos/info.ts @@ -32,8 +32,6 @@ import type {Renderer} from './renderer.js'; * 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. - * - * @alias Blockly.thrasos.RenderInfo */ export class RenderInfo extends BaseRenderInfo { // Exclamation is fine b/c this is assigned by the super constructor. diff --git a/core/renderers/thrasos/renderer.ts b/core/renderers/thrasos/renderer.ts index 88d6732a4..2789a0ba2 100644 --- a/core/renderers/thrasos/renderer.ts +++ b/core/renderers/thrasos/renderer.ts @@ -21,8 +21,6 @@ import {RenderInfo} from './info.js'; /** * The thrasos renderer. - * - * @alias Blockly.thrasos.Renderer */ export class Renderer extends BaseRenderer { /** diff --git a/core/renderers/zelos/constants.ts b/core/renderers/zelos/constants.ts index 4d7832aac..038e45d9f 100644 --- a/core/renderers/zelos/constants.ts +++ b/core/renderers/zelos/constants.ts @@ -38,8 +38,6 @@ export interface InsideCorners { /** * An object that provides constants for rendering blocks in Zelos mode. - * - * @alias Blockly.zelos.ConstantProvider */ export class ConstantProvider extends BaseConstantProvider { GRID_UNIT = 4; diff --git a/core/renderers/zelos/drawer.ts b/core/renderers/zelos/drawer.ts index f081166b1..301fbd004 100644 --- a/core/renderers/zelos/drawer.ts +++ b/core/renderers/zelos/drawer.ts @@ -30,8 +30,6 @@ import type {PathObject} from './path_object.js'; /** * An object that draws a block based on the given rendering information. - * - * @alias Blockly.zelos.Drawer */ export class Drawer extends BaseDrawer { // TODO(b/109816955): remove '!', see go/strict-prop-init-fix. diff --git a/core/renderers/zelos/info.ts b/core/renderers/zelos/info.ts index 9071bb8da..fdaa913b6 100644 --- a/core/renderers/zelos/info.ts +++ b/core/renderers/zelos/info.ts @@ -42,8 +42,6 @@ import type {Renderer} from './renderer.js'; * 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. - * - * @alias Blockly.zelos.RenderInfo */ export class RenderInfo extends BaseRenderInfo { override topRow: TopRow; diff --git a/core/renderers/zelos/marker_svg.ts b/core/renderers/zelos/marker_svg.ts index 4227c3a9e..27c701d47 100644 --- a/core/renderers/zelos/marker_svg.ts +++ b/core/renderers/zelos/marker_svg.ts @@ -27,8 +27,6 @@ import type {ConstantProvider as ZelosConstantProvider} from './constants.js'; /** * Class to draw a marker. - * - * @alias Blockly.zelos.MarkerSvg */ export class MarkerSvg extends BaseMarkerSvg { // TODO(b/109816955): remove '!', see go/strict-prop-init-fix. diff --git a/core/renderers/zelos/measurables/bottom_row.ts b/core/renderers/zelos/measurables/bottom_row.ts index f4acded33..d0e1d2ba6 100644 --- a/core/renderers/zelos/measurables/bottom_row.ts +++ b/core/renderers/zelos/measurables/bottom_row.ts @@ -22,8 +22,6 @@ import {BottomRow as BaseBottomRow} from '../../../renderers/measurables/bottom_ * a block as well as spacing information for the top row. * Elements in a bottom row can consist of corners, spacers and next * connections. - * - * @alias Blockly.zelos.BottomRow */ export class BottomRow extends BaseBottomRow { /** diff --git a/core/renderers/zelos/measurables/inputs.ts b/core/renderers/zelos/measurables/inputs.ts index b0e629dbe..909d1a314 100644 --- a/core/renderers/zelos/measurables/inputs.ts +++ b/core/renderers/zelos/measurables/inputs.ts @@ -22,8 +22,6 @@ import {StatementInput as BaseStatementInput} from '../../../renderers/measurabl /** * An object containing information about the space a statement input takes up * during rendering. - * - * @alias Blockly.zelos.StatementInput */ export class StatementInput extends BaseStatementInput { connectedBottomNextConnection = false; diff --git a/core/renderers/zelos/measurables/row_elements.ts b/core/renderers/zelos/measurables/row_elements.ts index 0da74d4e5..05f594766 100644 --- a/core/renderers/zelos/measurables/row_elements.ts +++ b/core/renderers/zelos/measurables/row_elements.ts @@ -21,8 +21,6 @@ import {Types} from '../../../renderers/measurables/types.js'; /** * An object containing information about the space a right connection shape * takes up during rendering. - * - * @alias Blockly.zelos.RightConnectionShape */ export class RightConnectionShape extends Measurable { // Size is dynamic diff --git a/core/renderers/zelos/measurables/top_row.ts b/core/renderers/zelos/measurables/top_row.ts index 9c3e207dc..996018ae4 100644 --- a/core/renderers/zelos/measurables/top_row.ts +++ b/core/renderers/zelos/measurables/top_row.ts @@ -24,8 +24,6 @@ import {TopRow as BaseTopRow} from '../../../renderers/measurables/top_row.js'; * connections. * After this constructor is called, the row will contain all non-spacer * elements it needs. - * - * @alias Blockly.zelos.TopRow */ export class TopRow extends BaseTopRow { /** diff --git a/core/renderers/zelos/path_object.ts b/core/renderers/zelos/path_object.ts index fba99877a..352b7dddf 100644 --- a/core/renderers/zelos/path_object.ts +++ b/core/renderers/zelos/path_object.ts @@ -25,8 +25,6 @@ import type {ConstantProvider} from './constants.js'; /** * An object that handles creating and setting each of the SVG elements * used by the renderer. - * - * @alias Blockly.zelos.PathObject */ export class PathObject extends BasePathObject { /** The selected path of the block. */ diff --git a/core/renderers/zelos/renderer.ts b/core/renderers/zelos/renderer.ts index 6fa749104..c4f8ed1ce 100644 --- a/core/renderers/zelos/renderer.ts +++ b/core/renderers/zelos/renderer.ts @@ -33,8 +33,6 @@ import {PathObject} from './path_object.js'; /** * The zelos renderer. - * - * @alias Blockly.zelos.Renderer */ export class Renderer extends BaseRenderer { protected override constants_!: ConstantProvider; diff --git a/core/scrollbar.ts b/core/scrollbar.ts index 1ddf4cf56..17e3d29bd 100644 --- a/core/scrollbar.ts +++ b/core/scrollbar.ts @@ -31,8 +31,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; * Class for a pure SVG scrollbar. * This technique offers a scrollbar that is guaranteed to work, but may not * look or behave like the system's scrollbars. - * - * @alias Blockly.Scrollbar */ export class Scrollbar { /** diff --git a/core/scrollbar_pair.ts b/core/scrollbar_pair.ts index 6c29a9648..35e3a0cd3 100644 --- a/core/scrollbar_pair.ts +++ b/core/scrollbar_pair.ts @@ -22,8 +22,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; /** * Class for a pair of scrollbars. Horizontal and vertical. - * - * @alias Blockly.ScrollbarPair */ export class ScrollbarPair { hScroll: Scrollbar|null = null; diff --git a/core/serialization/blocks.ts b/core/serialization/blocks.ts index 5c55f04ab..8d3e096db 100644 --- a/core/serialization/blocks.ts +++ b/core/serialization/blocks.ts @@ -32,8 +32,6 @@ import * as serializationRegistry from './registry.js'; /** * Represents the state of a connection. - * - * @alias Blockly.serialization.blocks.ConnectionState */ export interface ConnectionState { shadow: State|undefined; @@ -42,8 +40,6 @@ export interface ConnectionState { /** * Represents the state of a given block. - * - * @alias Blockly.serialization.blocks.State */ export interface State { type: string; @@ -77,7 +73,6 @@ export interface State { * exist. True by default. * @returns The serialized state of the block, or null if the block could not be * serialied (eg it was an insertion marker). - * @alias Blockly.serialization.blocks.save */ export function save(block: Block, { addCoordinates = false, @@ -317,7 +312,6 @@ function saveConnection(connection: Connection, doFullSerialization: boolean): * @param param1 recordUndo: If true, events triggered by this function will be * undo-able by the user. False by default. * @returns The block that was just loaded. - * @alias Blockly.serialization.blocks.append */ export function append( state: State, workspace: Workspace, @@ -340,7 +334,6 @@ export function append( * it is created. False by default. recordUndo: If true, events triggered by * this function will be undo-able by the user. False by default. * @returns The block that was just appended. - * @alias Blockly.serialization.blocks.appendInternal * @internal */ export function appendInternal( @@ -662,8 +655,6 @@ const saveBlock = save; /** * Serializer for saving and loading block state. - * - * @alias Blockly.serialization.blocks.BlockSerializer */ export class BlockSerializer implements ISerializer { priority: number; diff --git a/core/serialization/exceptions.ts b/core/serialization/exceptions.ts index 440769450..506c83063 100644 --- a/core/serialization/exceptions.ts +++ b/core/serialization/exceptions.ts @@ -16,14 +16,12 @@ import type {Block} from '../block.js'; import type {State} from './blocks.js'; -/** @alias Blockly.serialization.exceptions.DeserializationError */ export class DeserializationError extends Error {} /** * Represents an error where the serialized state is expected to provide a * block type, but it is not provided. * - * @alias Blockly.serialization.exceptions.MissingBlockType */ export class MissingBlockType extends DeserializationError { /** @@ -38,8 +36,6 @@ export class MissingBlockType extends DeserializationError { /** * Represents an error where deserialization encountered a block that did * not have a connection that was defined in the serialized state. - * - * @alias Blockly.serialization.exceptions.MissingConnection */ export class MissingConnection extends DeserializationError { /** @@ -58,8 +54,6 @@ connection`); /** * Represents an error where deserialization tried to connect two connections * that were not compatible. - * - * @alias Blockly.serialization.exceptions.BadConnectionCheck */ export class BadConnectionCheck extends DeserializationError { /** @@ -83,8 +77,6 @@ ${childConnection} to its parent, because: ${reason}`); * was deserializing children of a shadow. * This is an error because it is an invariant of Blockly that shadow blocks * do not have real children. - * - * @alias Blockly.serialization.exceptions.RealChildOfShadow */ export class RealChildOfShadow extends DeserializationError { /** diff --git a/core/serialization/priorities.ts b/core/serialization/priorities.ts index b49c7222d..03d053279 100644 --- a/core/serialization/priorities.ts +++ b/core/serialization/priorities.ts @@ -17,8 +17,6 @@ goog.declareModuleId('Blockly.serialization.priorities'); /** * The priority for deserializing variables. - * - * @alias Blockly.serialization.priorities.VARIABLES */ export const VARIABLES = 100; @@ -29,7 +27,5 @@ export const PROCEDURES = 75; /** * The priority for deserializing blocks. - * - * @alias Blockly.serialization.priorities.BLOCKS */ export const BLOCKS = 50; diff --git a/core/serialization/registry.ts b/core/serialization/registry.ts index ab6b2023c..b57030751 100644 --- a/core/serialization/registry.ts +++ b/core/serialization/registry.ts @@ -24,7 +24,6 @@ import * as registry from '../registry.js'; * * @param name The name of the serializer to register. * @param serializer The serializer to register. - * @alias Blockly.serialization.registry.register */ export function register(name: string, serializer: ISerializer) { registry.register(registry.Type.SERIALIZER, name, serializer); @@ -34,7 +33,6 @@ export function register(name: string, serializer: ISerializer) { * Unregisters the serializer associated with the given name. * * @param name The name of the serializer to unregister. - * @alias Blockly.serialization.registry.unregister */ export function unregister(name: string) { registry.unregister(registry.Type.SERIALIZER, name); diff --git a/core/serialization/variables.ts b/core/serialization/variables.ts index dd1eb2d5b..3259763ac 100644 --- a/core/serialization/variables.ts +++ b/core/serialization/variables.ts @@ -22,8 +22,6 @@ import * as serializationRegistry from './registry.js'; /** * Represents the state of a given variable. - * - * @alias Blockly.serialization.variables.State */ export interface State { name: string; @@ -33,8 +31,6 @@ export interface State { /** * Serializer for saving and loading variable state. - * - * @alias Blockly.serialization.variables.VariableSerializer */ export class VariableSerializer implements ISerializer { priority: number; diff --git a/core/serialization/workspaces.ts b/core/serialization/workspaces.ts index 9d8e857ef..378d12a61 100644 --- a/core/serialization/workspaces.ts +++ b/core/serialization/workspaces.ts @@ -27,7 +27,6 @@ import {WorkspaceSvg} from '../workspace_svg.js'; * * @param workspace The workspace to serialize. * @returns The serialized state of the workspace. - * @alias Blockly.serialization.workspaces.save */ export function save(workspace: Workspace): {[key: string]: AnyDuringMigration} { @@ -49,7 +48,6 @@ export function save(workspace: Workspace): * @param workspace The workspace to add the new state to. * @param param1 recordUndo: If true, events triggered by this function will be * undo-able by the user. False by default. - * @alias Blockly.serialization.workspaces.load */ export function load( state: {[key: string]: AnyDuringMigration}, workspace: Workspace, diff --git a/core/shortcut_items.ts b/core/shortcut_items.ts index cf35096e9..936ae4f5c 100644 --- a/core/shortcut_items.ts +++ b/core/shortcut_items.ts @@ -24,8 +24,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; /** * Object holding the names of the default shortcut items. - * - * @alias Blockly.ShortcutItems.names */ export enum names { ESCAPE = 'escape', @@ -39,8 +37,6 @@ export enum names { /** * Keyboard shortcut to hide chaff on escape. - * - * @alias Blockly.ShortcutItems.registerEscape */ export function registerEscape() { const escapeAction: KeyboardShortcut = { @@ -61,8 +57,6 @@ export function registerEscape() { /** * Keyboard shortcut to delete a block on delete or backspace - * - * @alias Blockly.ShortcutItems.registerDelete */ export function registerDelete() { const deleteShortcut: KeyboardShortcut = { @@ -92,8 +86,6 @@ export function registerDelete() { /** * Keyboard shortcut to copy a block on ctrl+c, cmd+c, or alt+c. - * - * @alias Blockly.ShortcutItems.registerCopy */ export function registerCopy() { const ctrlC = ShortcutRegistry.registry.createSerializedKey( @@ -127,8 +119,6 @@ export function registerCopy() { /** * Keyboard shortcut to copy and delete a block on ctrl+x, cmd+x, or alt+x. - * - * @alias Blockly.ShortcutItems.registerCut */ export function registerCut() { const ctrlX = ShortcutRegistry.registry.createSerializedKey( @@ -165,8 +155,6 @@ export function registerCut() { /** * Keyboard shortcut to paste a block on ctrl+v, cmd+v, or alt+v. - * - * @alias Blockly.ShortcutItems.registerPaste */ export function registerPaste() { const ctrlV = ShortcutRegistry.registry.createSerializedKey( @@ -192,8 +180,6 @@ export function registerPaste() { /** * Keyboard shortcut to undo the previous action on ctrl+z, cmd+z, or alt+z. - * - * @alias Blockly.ShortcutItems.registerUndo */ export function registerUndo() { const ctrlZ = ShortcutRegistry.registry.createSerializedKey( @@ -222,8 +208,6 @@ export function registerUndo() { /** * Keyboard shortcut to redo the previous action on ctrl+shift+z, cmd+shift+z, * or alt+shift+z. - * - * @alias Blockly.ShortcutItems.registerRedo */ export function registerRedo() { const ctrlShiftZ = ShortcutRegistry.registry.createSerializedKey( @@ -256,7 +240,6 @@ export function registerRedo() { * Registers all default keyboard shortcut item. This should be called once per * instance of KeyboardShortcutRegistry. * - * @alias Blockly.ShortcutItems.registerDefaultShortcuts * @internal */ export function registerDefaultShortcuts() { diff --git a/core/shortcut_registry.ts b/core/shortcut_registry.ts index aba367887..191913941 100644 --- a/core/shortcut_registry.ts +++ b/core/shortcut_registry.ts @@ -22,8 +22,6 @@ import type {Workspace} from './workspace.js'; * Class for the registry of keyboard shortcuts. This is intended to be a * singleton. You should not create a new instance, and only access this class * from ShortcutRegistry.registry. - * - * @alias Blockly.ShortcutRegistry */ export class ShortcutRegistry { static readonly registry = new ShortcutRegistry(); diff --git a/core/sprites.ts b/core/sprites.ts index 223535ca9..41933de3d 100644 --- a/core/sprites.ts +++ b/core/sprites.ts @@ -7,8 +7,6 @@ /** * Contains the path to a single png tat holds the images for the trashcan * as well as the zoom controls. - * - * @alias Blockly.sprite.SPRITE */ export const SPRITE = { width: 96, diff --git a/core/theme.ts b/core/theme.ts index c34600233..c79bc8a33 100644 --- a/core/theme.ts +++ b/core/theme.ts @@ -28,8 +28,6 @@ export interface ITheme { /** * Class for a theme. - * - * @alias Blockly.Theme */ export class Theme implements ITheme { /** @internal */ diff --git a/core/theme/classic.ts b/core/theme/classic.ts index 8989573ab..8c0bd3755 100644 --- a/core/theme/classic.ts +++ b/core/theme/classic.ts @@ -44,8 +44,6 @@ const categoryStyles = { /** * Classic theme. * Contains multi-coloured border to create shadow effect. - * - * @alias Blockly.Themes.Classic */ export const Classic = new Theme( 'classic', defaultBlockStyles as AnyDuringMigration, categoryStyles); diff --git a/core/theme/zelos.ts b/core/theme/zelos.ts index a0583cd69..66c85d9a0 100644 --- a/core/theme/zelos.ts +++ b/core/theme/zelos.ts @@ -83,7 +83,5 @@ const categoryStyles = { /** * Zelos theme. - * - * @alias Blockly.Themes.Zelos */ export const Zelos = new Theme('zelos', defaultBlockStyles, categoryStyles); diff --git a/core/theme_manager.ts b/core/theme_manager.ts index 33fa9f483..2052b7f61 100644 --- a/core/theme_manager.ts +++ b/core/theme_manager.ts @@ -22,8 +22,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; /** * Class for storing and updating a workspace's theme and UI components. - * - * @alias Blockly.ThemeManager */ export class ThemeManager { /** A list of workspaces that are subscribed to this theme. */ diff --git a/core/toolbox/category.ts b/core/toolbox/category.ts index 9a2c125f6..a3a685ec8 100644 --- a/core/toolbox/category.ts +++ b/core/toolbox/category.ts @@ -30,8 +30,6 @@ import {ToolboxItem} from './toolbox_item.js'; /** * Class for a category in a toolbox. - * - * @alias Blockly.ToolboxCategory */ export class ToolboxCategory extends ToolboxItem implements ISelectableToolboxItem { diff --git a/core/toolbox/collapsible_category.ts b/core/toolbox/collapsible_category.ts index c6f45ebdd..0cb3df7b4 100644 --- a/core/toolbox/collapsible_category.ts +++ b/core/toolbox/collapsible_category.ts @@ -26,8 +26,6 @@ import {ToolboxSeparator} from './separator.js'; /** * Class for a category in a toolbox that can be collapsed. - * - * @alias Blockly.CollapsibleToolboxCategory */ export class CollapsibleToolboxCategory extends ToolboxCategory implements ICollapsibleToolboxItem { diff --git a/core/toolbox/separator.ts b/core/toolbox/separator.ts index 26fac7e32..41c600655 100644 --- a/core/toolbox/separator.ts +++ b/core/toolbox/separator.ts @@ -24,8 +24,6 @@ import {ToolboxItem} from './toolbox_item.js'; /** * Class for a toolbox separator. This is the thin visual line that appears on * the toolbox. This item is not interactable. - * - * @alias Blockly.ToolboxSeparator */ export class ToolboxSeparator extends ToolboxItem { /** Name used for registering a toolbox separator. */ diff --git a/core/toolbox/toolbox.ts b/core/toolbox/toolbox.ts index 8c1aeb577..91cf9d6d9 100644 --- a/core/toolbox/toolbox.ts +++ b/core/toolbox/toolbox.ts @@ -51,8 +51,6 @@ import {CollapsibleToolboxCategory} from './collapsible_category.js'; /** * Class for a Toolbox. * Creates the toolbox's DOM. - * - * @alias Blockly.Toolbox */ export class Toolbox extends DeleteArea implements IAutoHideable, IKeyboardAccessible, diff --git a/core/toolbox/toolbox_item.ts b/core/toolbox/toolbox_item.ts index 36e0e14ac..3fe7ffb5b 100644 --- a/core/toolbox/toolbox_item.ts +++ b/core/toolbox/toolbox_item.ts @@ -22,8 +22,6 @@ import type {WorkspaceSvg} from '../workspace_svg.js'; /** * Class for an item in the toolbox. - * - * @alias Blockly.ToolboxItem */ export class ToolboxItem implements IToolboxItem { protected id_: string; diff --git a/core/tooltip.ts b/core/tooltip.ts index cdd5bde0d..50a2a1e2a 100644 --- a/core/tooltip.ts +++ b/core/tooltip.ts @@ -27,8 +27,6 @@ import * as blocklyString from './utils/string.js'; * Either a string, an object containing a tooltip property, or a function which * returns either a string, or another arbitrarily nested function which * eventually unwinds to a string. - * - * @alias Blockly.Tooltip.TipInfo */ export type TipInfo = string|{tooltip: AnyDuringMigration}|(() => TipInfo|string|Function); @@ -38,8 +36,6 @@ export type TipInfo = * 1st parameter: the div element to render content into. * 2nd parameter: the element being moused over (i.e., the element for which the * tooltip should be shown). - * - * @alias Blockly.Tooltip.CustomTooltip */ export type CustomTooltip = (p1: Element, p2: Element) => AnyDuringMigration; @@ -55,7 +51,6 @@ let customTooltip: CustomTooltip|undefined = undefined; * tooltip UI. * * @param customFn A custom tooltip used to render an alternate tooltip UI. - * @alias Blockly.Tooltip.setCustomTooltip */ export function setCustomTooltip(customFn: CustomTooltip) { customTooltip = customFn; @@ -77,7 +72,6 @@ let visible = false; * Returns whether or not a tooltip is showing * * @returns True if a tooltip is showing - * @alias Blockly.Tooltip.isVisible */ export function isVisible(): boolean { return visible; @@ -88,8 +82,6 @@ let blocked = false; /** * Maximum width (in characters) of a tooltip. - * - * @alias Blockly.Tooltip.LIMIT */ export const LIMIT = 50; @@ -120,36 +112,26 @@ let poisonedElement: AnyDuringMigration = null; /** * Horizontal offset between mouse cursor and tooltip. - * - * @alias Blockly.Tooltip.OFFSET_X */ export const OFFSET_X = 0; /** * Vertical offset between mouse cursor and tooltip. - * - * @alias Blockly.Tooltip.OFFSET_Y */ export const OFFSET_Y = 10; /** * Radius mouse can move before killing tooltip. - * - * @alias Blockly.Tooltip.RADIUS_OK */ export const RADIUS_OK = 10; /** * Delay before tooltip appears. - * - * @alias Blockly.Tooltip.HOVER_MS */ export const HOVER_MS = 750; /** * Horizontal padding between tooltip and screen edge. - * - * @alias Blockly.Tooltip.MARGINS */ export const MARGINS = 5; @@ -160,7 +142,6 @@ let containerDiv: HTMLDivElement|null = null; * Returns the HTML tooltip container. * * @returns The HTML tooltip container. - * @alias Blockly.Tooltip.getDiv */ export function getDiv(): HTMLDivElement|null { return containerDiv; @@ -171,7 +152,6 @@ export function getDiv(): HTMLDivElement|null { * * @param object The object to get the tooltip text of. * @returns The tooltip text of the element. - * @alias Blockly.Tooltip.getTooltipOfObject */ export function getTooltipOfObject(object: AnyDuringMigration|null): string { const obj = getTargetObject(object); @@ -208,8 +188,6 @@ function getTargetObject(obj: object|null): {tooltip: AnyDuringMigration}|null { /** * Create the tooltip div and inject it onto the page. - * - * @alias Blockly.Tooltip.createDom */ export function createDom() { if (containerDiv) { @@ -226,7 +204,6 @@ export function createDom() { * Binds the required mouse events onto an SVG element. * * @param element SVG element onto which tooltip is to be bound. - * @alias Blockly.Tooltip.bindMouseEvents */ export function bindMouseEvents(element: Element) { // TODO (#6097): Don't stash wrapper info on the DOM. @@ -245,7 +222,6 @@ export function bindMouseEvents(element: Element) { * Unbinds tooltip mouse events from the SVG element. * * @param element SVG element onto which tooltip is bound. - * @alias Blockly.Tooltip.unbindMouseEvents */ export function unbindMouseEvents(element: Element|null) { if (!element) { @@ -346,7 +322,6 @@ function onMouseMove(e: Event) { /** * Dispose of the tooltip. * - * @alias Blockly.Tooltip.dispose * @internal */ export function dispose() { @@ -357,8 +332,6 @@ export function dispose() { /** * Hide the tooltip. - * - * @alias Blockly.Tooltip.hide */ export function hide() { if (visible) { @@ -376,7 +349,6 @@ export function hide() { * Hide any in-progress tooltips and block showing new tooltips until the next * call to unblock(). * - * @alias Blockly.Tooltip.block * @internal */ export function block() { @@ -388,7 +360,6 @@ export function block() { * Unblock tooltips: allow them to be scheduled and shown according to their own * logic. * - * @alias Blockly.Tooltip.unblock * @internal */ export function unblock() { diff --git a/core/touch.ts b/core/touch.ts index 250b162a1..f8be51c60 100644 --- a/core/touch.ts +++ b/core/touch.ts @@ -50,8 +50,6 @@ let touchIdentifier_: string|null = null; /** * The TOUCH_MAP lookup dictionary specifies additional touch events to fire, * in conjunction with mouse events. - * - * @alias Blockly.Touch.TOUCH_MAP */ export const TOUCH_MAP: {[key: string]: string[]} = { 'mousedown': ['pointerdown'], @@ -77,7 +75,6 @@ let longPid_: AnyDuringMigration = 0; * * @param e Touch start event. * @param gesture The gesture that triggered this longStart. - * @alias Blockly.Touch.longStart * @internal */ export function longStart(e: PointerEvent, gesture: Gesture) { @@ -94,7 +91,6 @@ export function longStart(e: PointerEvent, gesture: Gesture) { * Nope, that's not a long-press. Either touchend or touchcancel was fired, * or a drag hath begun. Kill the queued long-press task. * - * @alias Blockly.Touch.longStop * @internal */ export function longStop() { @@ -108,8 +104,6 @@ export function longStop() { * Clear the touch identifier that tracks which touch stream to pay attention * to. This ends the current drag/gesture and allows other pointers to be * captured. - * - * @alias Blockly.Touch.clearTouchIdentifier */ export function clearTouchIdentifier() { touchIdentifier_ = null; @@ -123,7 +117,6 @@ export function clearTouchIdentifier() { * @param e The event to check. * @returns True if this event should be passed through to the registered * handler; false if it should be blocked. - * @alias Blockly.Touch.shouldHandleEvent */ export function shouldHandleEvent(e: Event): boolean { // Do not replace the startsWith with a check for `instanceof PointerEvent`. @@ -139,7 +132,6 @@ export function shouldHandleEvent(e: Event): boolean { * * @param e Pointer event. * @returns The pointerId of the event. - * @alias Blockly.Touch.getTouchIdentifierFromEvent */ export function getTouchIdentifierFromEvent(e: PointerEvent): string { return `${e.pointerId}`; @@ -154,7 +146,6 @@ export function getTouchIdentifierFromEvent(e: PointerEvent): string { * @param e Pointer event. * @returns Whether the identifier on the event matches the current saved * identifier. - * @alias Blockly.Touch.checkTouchIdentifier */ export function checkTouchIdentifier(e: PointerEvent): boolean { const identifier = getTouchIdentifierFromEvent(e); @@ -181,7 +172,6 @@ export function checkTouchIdentifier(e: PointerEvent): boolean { * make a touch event work in a mouse event handler. * * @param e A touch event. - * @alias Blockly.Touch.setClientFromTouch */ export function setClientFromTouch(e: Event|PseudoEvent) { deprecation.warn('setClientFromTouch()', 'version 9', 'version 10'); @@ -206,7 +196,6 @@ export function setClientFromTouch(e: Event|PseudoEvent) { * * @param e An event. * @returns True if it is a mouse, touch, or pointer event; false otherwise. - * @alias Blockly.Touch.isMouseOrTouchEvent */ export function isMouseOrTouchEvent(e: Event|PseudoEvent): boolean { deprecation.warn('isMouseOrTouchEvent()', 'version 9', 'version 10'); @@ -219,7 +208,6 @@ export function isMouseOrTouchEvent(e: Event|PseudoEvent): boolean { * * @param e An event. * @returns True if it is a touch or pointer event; false otherwise. - * @alias Blockly.Touch.isTouchEvent */ export function isTouchEvent(e: Event|PseudoEvent): boolean { deprecation.warn('isTouchEvent()', 'version 9', 'version 10'); @@ -234,7 +222,6 @@ export function isTouchEvent(e: Event|PseudoEvent): boolean { * @returns An array of events or pseudo events. * Each pseudo-touch event will have exactly one changed touch and there * will be no real touch events. - * @alias Blockly.Touch.splitEventByTouches */ export function splitEventByTouches(e: Event): Array { deprecation.warn('splitEventByTouches()', 'version 9', 'version 10'); diff --git a/core/trashcan.ts b/core/trashcan.ts index 04c1196e7..820a0caed 100644 --- a/core/trashcan.ts +++ b/core/trashcan.ts @@ -43,8 +43,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; /** * Class for a trash can. - * - * @alias Blockly.Trashcan */ export class Trashcan extends DeleteArea implements IAutoHideable, IPositionable { diff --git a/core/utils.ts b/core/utils.ts index 3891d0b21..e8eb87fea 100644 --- a/core/utils.ts +++ b/core/utils.ts @@ -75,7 +75,6 @@ export { * @param element SVG element to find the coordinates of. * @returns Object with .x and .y properties. * @deprecated Use **Blockly.utils.svgMath.getRelativeXY** instead. - * @alias Blockly.utils.getRelativeXY */ export function getRelativeXY(element: Element): Coordinate { deprecation.warn( @@ -92,7 +91,6 @@ export function getRelativeXY(element: Element): Coordinate { * of the div Blockly was injected into, the behaviour is undefined. * @returns Object with .x and .y properties. * @deprecated Use **Blockly.utils.svgMath.getInjectionDivXY** instead. - * @alias Blockly.utils.getInjectionDivXY_ */ function getInjectionDivXY(element: Element): Coordinate { deprecation.warn( @@ -113,7 +111,6 @@ export const getInjectionDivXY_ = getInjectionDivXY; * interpolation tokens. * @returns Array of strings and numbers. * @deprecated Use **Blockly.utils.parsing.tokenizeInterpolation** instead. - * @alias Blockly.utils.tokenizeInterpolation */ export function tokenizeInterpolation(message: string): Array { deprecation.warn( @@ -131,7 +128,6 @@ export function tokenizeInterpolation(message: string): Array { * references. * @returns String with message references replaced. * @deprecated Use **Blockly.utils.parsing.replaceMessageReferences** instead. - * @alias Blockly.utils.replaceMessageReferences */ export function replaceMessageReferences(message: string|any): string { deprecation.warn( @@ -148,7 +144,6 @@ export function replaceMessageReferences(message: string|any): string { * @returns True if all message references have matching values. * Otherwise, false. * @deprecated Use **Blockly.utils.parsing.checkMessageReferences** instead. - * @alias Blockly.utils.checkMessageReferences */ export function checkMessageReferences(message: string): boolean { deprecation.warn( @@ -163,7 +158,6 @@ export function checkMessageReferences(message: string): boolean { * * @returns True if 3D transforms are supported. * @deprecated Use **Blockly.utils.svgMath.is3dSupported** instead. - * @alias Blockly.utils.is3dSupported */ export function is3dSupported(): boolean { deprecation.warn( @@ -178,7 +172,6 @@ export function is3dSupported(): boolean { * * @returns An object containing window width, height, and scroll position in * window coordinates. - * @alias Blockly.utils.getViewportBBox * @deprecated Use **Blockly.utils.svgMath.getViewportBBox** instead. * @internal */ @@ -195,7 +188,6 @@ export function getViewportBBox(): Rect { * @param arr Array from which to remove value. * @param value Value to remove. * @returns True if an element was removed. - * @alias Blockly.utils.arrayRemove * @deprecated Use **Blockly.array.removeElem** instead. * @internal */ @@ -212,7 +204,6 @@ export function arrayRemove(arr: Array, value: T): boolean { * * @returns Object with values 'x' and 'y'. * @deprecated Use **Blockly.utils.svgMath.getDocumentScroll** instead. - * @alias Blockly.utils.getDocumentScroll */ export function getDocumentScroll(): Coordinate { deprecation.warn( @@ -230,7 +221,6 @@ export function getDocumentScroll(): Coordinate { * that are not inside a value or statement input of the block). * @returns Map of types to type counts for descendants of the bock. * @deprecated Use **Blockly.common.getBlockTypeCounts** instead. - * @alias Blockly.utils.getBlockTypeCounts */ export function getBlockTypeCounts( block: Block, opt_stripFollowing?: boolean): {[key: string]: number} { @@ -267,7 +257,6 @@ export function screenToWsCoordinates( * the input was an HSV hue value. * @throws {Error} If the colour cannot be parsed. * @deprecated Use **Blockly.utils.parsing.parseBlockColour** instead. - * @alias Blockly.utils.parseBlockColour */ export function parseBlockColour(colour: number| string): {hue: number|null, hex: string} { @@ -283,7 +272,6 @@ export function parseBlockColour(colour: number| * @param fn Function to run. * @throws Error Will throw if no global document can be found (e.g., Node.js). * @deprecated No longer provided by Blockly. - * @alias Blockly.utils.runAfterPageLoad */ export function runAfterPageLoad(fn: () => void) { deprecation.warn( diff --git a/core/utils/aria.ts b/core/utils/aria.ts index fcacf4da7..e31951d8a 100644 --- a/core/utils/aria.ts +++ b/core/utils/aria.ts @@ -24,8 +24,6 @@ const ROLE_ATTRIBUTE = 'role'; /** * ARIA role values. * Copied from Closure's goog.a11y.aria.Role - * - * @alias Blockly.utils.aria.Role */ export enum Role { // ARIA role for an interactive control of tabular data. @@ -64,8 +62,6 @@ export enum Role { /** * ARIA states and properties. * Copied from Closure's goog.a11y.aria.State - * - * @alias Blockly.utils.aria.State */ export enum State { // ARIA property for setting the currently active descendant of an element, @@ -129,7 +125,6 @@ export enum State { * * @param element DOM node to set role of. * @param roleName Role name. - * @alias Blockly.utils.aria.setRole */ export function setRole(element: Element, roleName: Role) { element.setAttribute(ROLE_ATTRIBUTE, roleName); @@ -144,7 +139,6 @@ export function setRole(element: Element, roleName: Role) { * Automatically adds prefix 'aria-' to the state name if the attribute is * not an extra attribute. * @param value Value for the state attribute. - * @alias Blockly.utils.aria.setState */ export function setState( element: Element, stateName: State, value: string|boolean|number|string[]) { diff --git a/core/utils/array.ts b/core/utils/array.ts index 26cda7961..dbf1b6467 100644 --- a/core/utils/array.ts +++ b/core/utils/array.ts @@ -15,7 +15,6 @@ goog.declareModuleId('Blockly.utils.array'); * @param arr Array from which to remove value. * @param value Value to remove. * @returns True if an element was removed. - * @alias Blockly.array.removeElem * @internal */ export function removeElem(arr: Array, value: T): boolean { diff --git a/core/utils/colour.ts b/core/utils/colour.ts index fad93adb8..6f234d308 100644 --- a/core/utils/colour.ts +++ b/core/utils/colour.ts @@ -16,15 +16,12 @@ goog.declareModuleId('Blockly.utils.colour'); /** * The richness of block colours, regardless of the hue. * Must be in the range of 0 (inclusive) to 1 (exclusive). - * - * @alias Blockly.utils.colour.hsvSaturation */ let hsvSaturation = 0.45; /** * Get the richness of block colours, regardless of the hue. * - * @alias Blockly.utils.colour.getHsvSaturation * @returns The current richness. * @internal */ @@ -37,7 +34,6 @@ export function getHsvSaturation(): number { * * @param newSaturation The new richness, in the range of 0 (inclusive) to 1 * (exclusive) - * @alias Blockly.utils.colour.setHsvSaturation * @internal */ export function setHsvSaturation(newSaturation: number) { @@ -47,15 +43,12 @@ export function setHsvSaturation(newSaturation: number) { /** * The intensity of block colours, regardless of the hue. * Must be in the range of 0 (inclusive) to 1 (exclusive). - * - * @alias Blockly.utils.colour.hsvValue */ let hsvValue = 0.65; /** * Get the intensity of block colours, regardless of the hue. * - * @alias Blockly.utils.colour.getHsvValue * @returns The current intensity. * @internal */ @@ -68,7 +61,6 @@ export function getHsvValue(): number { * * @param newValue The new intensity, in the range of 0 (inclusive) to 1 * (exclusive) - * @alias Blockly.utils.colour.setHsvValue * @internal */ export function setHsvValue(newValue: number) { @@ -86,7 +78,6 @@ export function setHsvValue(newValue: number) { * @param str Colour in some CSS format. * @returns A string containing a hex representation of the colour, or null if * can't be parsed. - * @alias Blockly.utils.colour.parse */ export function parse(str: string|number): string|null { str = String(str).toLowerCase().trim(); @@ -125,7 +116,6 @@ export function parse(str: string|number): string|null { * @param g Amount of green, int between 0 and 255. * @param b Amount of blue, int between 0 and 255. * @returns Hex representation of the colour. - * @alias Blockly.utils.colour.rgbToHex */ export function rgbToHex(r: number, g: number, b: number): string { const rgb = r << 16 | g << 8 | b; @@ -141,7 +131,6 @@ export function rgbToHex(r: number, g: number, b: number): string { * @param colour String representing colour in any colour format ('#ff0000', * 'red', '0xff000', etc). * @returns RGB representation of the colour. - * @alias Blockly.utils.colour.hexToRgb */ export function hexToRgb(colour: string): number[] { const hex = parse(colour); @@ -164,7 +153,6 @@ export function hexToRgb(colour: string): number[] { * @param s Saturation value in [0, 1]. * @param v Brightness in [0, 255]. * @returns Hex representation of the colour. - * @alias Blockly.utils.colour.hsvToHex */ export function hsvToHex(h: number, s: number, v: number): string { let red = 0; @@ -226,7 +214,6 @@ export function hsvToHex(h: number, s: number, v: number): string { * @param factor The weight to be given to colour1 over colour2. * Values should be in the range [0, 1]. * @returns Combined colour represented in hex. - * @alias Blockly.utils.colour.blend */ export function blend(colour1: string, colour2: string, factor: number): string| null { @@ -251,8 +238,6 @@ export function blend(colour1: string, colour2: string, factor: number): string| * https://www.w3.org/TR/2018/REC-css-color-3-20180619/#html4 * The keys of this map are the lowercase "readable" names of the colours, * while the values are the "hex" values. - * - * @alias Blockly.utils.colour.names */ export const names: {[key: string]: string} = { 'aqua': '#00ffff', @@ -278,7 +263,6 @@ export const names: {[key: string]: string} = { * * @param hue Hue on a colour wheel (0-360). * @returns RGB code, e.g. '#5ba65b'. - * @alias Blockly.utils.colour.hueToHex */ export function hueToHex(hue: number): string { return hsvToHex(hue, hsvSaturation, hsvValue * 255); diff --git a/core/utils/coordinate.ts b/core/utils/coordinate.ts index 80ef56e00..12d422b70 100644 --- a/core/utils/coordinate.ts +++ b/core/utils/coordinate.ts @@ -17,8 +17,6 @@ goog.declareModuleId('Blockly.utils.Coordinate'); /** * Class for representing coordinates and positions. - * - * @alias Blockly.utils.Coordinate */ export class Coordinate { /** diff --git a/core/utils/deprecation.ts b/core/utils/deprecation.ts index af2800fb3..0492c6423 100644 --- a/core/utils/deprecation.ts +++ b/core/utils/deprecation.ts @@ -23,7 +23,6 @@ goog.declareModuleId('Blockly.utils.deprecation'); * @param deletionDate The date of deletion. Prefer 'version n.0.0' * format, and fall back to 'month yyyy' or 'quarter yyyy' format. * @param opt_use The name of a function or property to use instead, if any. - * @alias Blockly.utils.deprecation.warn * @internal */ export function warn( diff --git a/core/utils/dom.ts b/core/utils/dom.ts index c8e799fe2..383934f47 100644 --- a/core/utils/dom.ts +++ b/core/utils/dom.ts @@ -19,30 +19,22 @@ import type {Svg} from './svg.js'; /** * Required name space for SVG elements. - * - * @alias Blockly.utils.dom.SVG_NS */ export const SVG_NS = 'http://www.w3.org/2000/svg'; /** * Required name space for HTML elements. - * - * @alias Blockly.utils.dom.HTML_NS */ export const HTML_NS = 'http://www.w3.org/1999/xhtml'; /** * Required name space for XLINK elements. - * - * @alias Blockly.utils.dom.XLINK_NS */ export const XLINK_NS = 'http://www.w3.org/1999/xlink'; /** * Node type constants. * https://developer.mozilla.org/en-US/docs/Web/API/Node/nodeType - * - * @alias Blockly.utils.dom.NodeType */ export enum NodeType { ELEMENT_NODE = 1, @@ -67,7 +59,6 @@ let canvasContext: CanvasRenderingContext2D|null = null; * @param attrs Dictionary of attribute names and values. * @param opt_parent Optional parent on which to append the element. * @returns if name is a string or a more specific type if it a member of Svg. - * @alias Blockly.utils.dom.createSvgElement */ export function createSvgElement( name: string|Svg, attrs: {[key: string]: string|number}, @@ -90,7 +81,6 @@ export function createSvgElement( * @param element DOM element to add class to. * @param className Name of class to add. * @returns True if class was added, false if already present. - * @alias Blockly.utils.dom.addClass */ export function addClass(element: Element, className: string): boolean { const classNames = className.split(' '); @@ -106,7 +96,6 @@ export function addClass(element: Element, className: string): boolean { * * @param element DOM element to remove classes from. * @param classNames A string of one or multiple class names for an element. - * @alias Blockly.utils.dom.removeClasses */ export function removeClasses(element: Element, classNames: string) { element.classList.remove(...classNames.split(' ')); @@ -120,7 +109,6 @@ export function removeClasses(element: Element, classNames: string) { * @param element DOM element to remove class from. * @param className Name of class to remove. * @returns True if class was removed, false if never present. - * @alias Blockly.utils.dom.removeClass */ export function removeClass(element: Element, className: string): boolean { const classNames = className.split(' '); @@ -137,7 +125,6 @@ export function removeClass(element: Element, className: string): boolean { * @param element DOM element to check. * @param className Name of class to check. * @returns True if class exists, false otherwise. - * @alias Blockly.utils.dom.hasClass */ export function hasClass(element: Element, className: string): boolean { return element.classList.contains(className); @@ -148,7 +135,6 @@ export function hasClass(element: Element, className: string): boolean { * * @param node The node to remove. * @returns The node removed if removed; else, null. - * @alias Blockly.utils.dom.removeNode */ // Copied from Closure goog.dom.removeNode export function removeNode(node: Node|null): Node|null { @@ -161,7 +147,6 @@ export function removeNode(node: Node|null): Node|null { * * @param newNode New element to insert. * @param refNode Existing element to precede new node. - * @alias Blockly.utils.dom.insertAfter */ export function insertAfter(newNode: Element, refNode: Element) { const siblingNode = refNode.nextSibling; @@ -182,7 +167,6 @@ export function insertAfter(newNode: Element, refNode: Element) { * @param parent The node that should contain the other node. * @param descendant The node to test presence of. * @returns Whether the parent node contains the descendant node. - * @alias Blockly.utils.dom.containsNode */ export function containsNode(parent: Node, descendant: Node): boolean { return !!( @@ -197,7 +181,6 @@ export function containsNode(parent: Node, descendant: Node): boolean { * * @param element Element to which the CSS transform will be applied. * @param transform The value of the CSS `transform` property. - * @alias Blockly.utils.dom.setCssTransform */ export function setCssTransform( element: HTMLElement|SVGElement, transform: string) { @@ -208,8 +191,6 @@ export function setCssTransform( /** * Start caching text widths. Every call to this function MUST also call * stopTextWidthCache. Caches must not survive between execution threads. - * - * @alias Blockly.utils.dom.startTextWidthCache */ export function startTextWidthCache() { cacheReference++; @@ -221,8 +202,6 @@ export function startTextWidthCache() { /** * Stop caching field widths. Unless caching was already on when the * corresponding call to startTextWidthCache was made. - * - * @alias Blockly.utils.dom.stopTextWidthCache */ export function stopTextWidthCache() { cacheReference--; @@ -236,7 +215,6 @@ export function stopTextWidthCache() { * * @param textElement An SVG 'text' element. * @returns Width of element. - * @alias Blockly.utils.dom.getTextWidth */ export function getTextWidth(textElement: SVGTextElement): number { const key = textElement.textContent + '\n' + textElement.className.baseVal; @@ -277,7 +255,6 @@ export function getTextWidth(textElement: SVGTextElement): number { * @param fontWeight The font weight to use. * @param fontFamily The font family to use. * @returns Width of element. - * @alias Blockly.utils.dom.getFastTextWidth */ export function getFastTextWidth( textElement: SVGTextElement, fontSize: number, fontWeight: string, @@ -298,7 +275,6 @@ export function getFastTextWidth( * @param fontWeight The font weight to use. * @param fontFamily The font family to use. * @returns Width of element. - * @alias Blockly.utils.dom.getFastTextWidthWithSizeString */ export function getFastTextWidthWithSizeString( textElement: SVGTextElement, fontSize: string, fontWeight: string, @@ -351,7 +327,6 @@ export function getFastTextWidthWithSizeString( * @param fontWeight The font weight to use. * @param fontFamily The font family to use. * @returns Font measurements. - * @alias Blockly.utils.dom.measureFontMetrics */ export function measureFontMetrics( text: string, fontSize: string, fontWeight: string, diff --git a/core/utils/idgenerator.ts b/core/utils/idgenerator.ts index e0b647df1..1e5461292 100644 --- a/core/utils/idgenerator.ts +++ b/core/utils/idgenerator.ts @@ -59,7 +59,6 @@ let nextId = 0; * primarily be used for IDs that end up in the DOM. * * @returns The next unique identifier. - * @alias Blockly.utils.idGenerator.getNextUniqueId */ export function getNextUniqueId(): string { return 'blockly-' + (nextId++).toString(36); @@ -70,7 +69,6 @@ export function getNextUniqueId(): string { * * @see internal.genUid * @returns A globally unique ID string. - * @alias Blockly.utils.idGenerator.genUid */ export function genUid(): string { return internal.genUid(); diff --git a/core/utils/keycodes.ts b/core/utils/keycodes.ts index 49aa8f8d7..d96e72ee5 100644 --- a/core/utils/keycodes.ts +++ b/core/utils/keycodes.ts @@ -22,8 +22,6 @@ goog.declareModuleId('Blockly.utils.KeyCodes'); * * This list is not localized and therefore some of the key codes are not * correct for non US keyboard layouts. See comments below. - * - * @alias Blockly.utils.KeyCodes */ export enum KeyCodes { WIN_KEY_FF_LINUX = 0, diff --git a/core/utils/math.ts b/core/utils/math.ts index c92749aa5..7dbef74e6 100644 --- a/core/utils/math.ts +++ b/core/utils/math.ts @@ -21,7 +21,6 @@ goog.declareModuleId('Blockly.utils.math'); * * @param angleDegrees Angle in degrees. * @returns Angle in radians. - * @alias Blockly.utils.math.toRadians */ export function toRadians(angleDegrees: number): number { return angleDegrees * Math.PI / 180; @@ -33,7 +32,6 @@ export function toRadians(angleDegrees: number): number { * * @param angleRadians Angle in radians. * @returns Angle in degrees. - * @alias Blockly.utils.math.toDegrees */ export function toDegrees(angleRadians: number): number { return angleRadians * 180 / Math.PI; @@ -46,7 +44,6 @@ export function toDegrees(angleRadians: number): number { * @param number The number to clamp. * @param upperBound The desired upper bound. * @returns The clamped number. - * @alias Blockly.utils.math.clamp */ export function clamp( lowerBound: number, number: number, upperBound: number): number { diff --git a/core/utils/metrics.ts b/core/utils/metrics.ts index 495e017b8..04dc9b366 100644 --- a/core/utils/metrics.ts +++ b/core/utils/metrics.ts @@ -13,7 +13,6 @@ import * as goog from '../../closure/goog/goog.js'; goog.declareModuleId('Blockly.utils.Metrics'); -/** @alias Blockly.utils.Metrics */ export interface Metrics { /** Height of the visible portion of the workspace. */ viewHeight: number; diff --git a/core/utils/object.ts b/core/utils/object.ts index 708c69905..2467b8abc 100644 --- a/core/utils/object.ts +++ b/core/utils/object.ts @@ -22,7 +22,6 @@ import * as deprecation from './deprecation.js'; * @param parentCtor Parent class. * @suppress {strictMissingProperties} superClass_ is not defined on Function. * @deprecated No longer provided by Blockly. - * @alias Blockly.utils.object.inherits */ export function inherits(childCtor: Function, parentCtor: Function) { deprecation.warn('Blockly.utils.object.inherits', 'version 9', 'version 10'); @@ -50,7 +49,6 @@ export function inherits(childCtor: Function, parentCtor: Function) { * @param target Target. * @param source Source. * @deprecated Use the built-in **Object.assign** instead. - * @alias Blockly.utils.object.mixin */ export function mixin(target: AnyDuringMigration, source: AnyDuringMigration) { deprecation.warn( @@ -66,7 +64,6 @@ export function mixin(target: AnyDuringMigration, source: AnyDuringMigration) { * @param target Target. * @param source Source. * @returns The resulting object. - * @alias Blockly.utils.object.deepMerge */ export function deepMerge( target: AnyDuringMigration, @@ -87,7 +84,6 @@ export function deepMerge( * @param obj Object containing values. * @returns Array of values. * @deprecated Use the built-in **Object.values** instead. - * @alias Blockly.utils.object.values */ export function values(obj: AnyDuringMigration): AnyDuringMigration[] { deprecation.warn( diff --git a/core/utils/parsing.ts b/core/utils/parsing.ts index 3a2fdd611..79c3784fc 100644 --- a/core/utils/parsing.ts +++ b/core/utils/parsing.ts @@ -166,7 +166,6 @@ function tokenizeInterpolationInternal( * @param message Text which might contain string table references and * interpolation tokens. * @returns Array of strings and numbers. - * @alias Blockly.utils.parsing.tokenizeInterpolation */ export function tokenizeInterpolation(message: string): (string|number)[] { return tokenizeInterpolationInternal(message, true); @@ -180,7 +179,6 @@ export function tokenizeInterpolation(message: string): (string|number)[] { * @param message Message, which may be a string that contains * string table references. * @returns String with message references replaced. - * @alias Blockly.utils.parsing.replaceMessageReferences */ export function replaceMessageReferences(message: string|any): string { if (typeof message !== 'string') { @@ -199,7 +197,6 @@ export function replaceMessageReferences(message: string|any): string { * @param message Text which might contain string table references. * @returns True if all message references have matching values. * Otherwise, false. - * @alias Blockly.utils.parsing.checkMessageReferences */ export function checkMessageReferences(message: string): boolean { let validSoFar = true; @@ -230,7 +227,6 @@ export function checkMessageReferences(message: string): boolean { * @returns An object containing the colour as * a #RRGGBB string, and the hue if the input was an HSV hue value. * @throws {Error} If the colour cannot be parsed. - * @alias Blockly.utils.parsing.parseBlockColour */ export function parseBlockColour(colour: number| string): {hue: number|null, hex: string} { diff --git a/core/utils/rect.ts b/core/utils/rect.ts index af97efd1c..a0ed1ca37 100644 --- a/core/utils/rect.ts +++ b/core/utils/rect.ts @@ -17,8 +17,6 @@ goog.declareModuleId('Blockly.utils.Rect'); /** * Class for representing rectangular regions. - * - * @alias Blockly.utils.Rect */ export class Rect { /** diff --git a/core/utils/sentinel.ts b/core/utils/sentinel.ts index 723c29986..6f71ee9d5 100644 --- a/core/utils/sentinel.ts +++ b/core/utils/sentinel.ts @@ -15,8 +15,6 @@ goog.declareModuleId('Blockly.utils.Sentinel'); /** * A type used to create flag values. - * - * @alias Blockly.utils.Sentinel */ export class Sentinel { /** diff --git a/core/utils/size.ts b/core/utils/size.ts index 3424c48fa..504b8182f 100644 --- a/core/utils/size.ts +++ b/core/utils/size.ts @@ -17,8 +17,6 @@ goog.declareModuleId('Blockly.utils.Size'); /** * Class for representing sizes consisting of a width and height. - * - * @alias Blockly.utils.Size */ export class Size { /** diff --git a/core/utils/string.ts b/core/utils/string.ts index 35856f354..ece17bf01 100644 --- a/core/utils/string.ts +++ b/core/utils/string.ts @@ -24,7 +24,6 @@ import * as deprecation from './deprecation.js'; * @param str The string to check. * @param prefix A string to look for at the start of `str`. * @returns True if `str` begins with `prefix`. - * @alias Blockly.utils.string.startsWith * @deprecated Use built-in **string.startsWith** instead. */ export function startsWith(str: string, prefix: string): boolean { @@ -39,7 +38,6 @@ export function startsWith(str: string, prefix: string): boolean { * * @param array Array of strings. * @returns Length of shortest string. - * @alias Blockly.utils.string.shortestStringLength */ export function shortestStringLength(array: string[]): number { if (!array.length) { @@ -59,7 +57,6 @@ export function shortestStringLength(array: string[]): number { * @param array Array of strings. * @param opt_shortest Length of shortest string. * @returns Length of common prefix. - * @alias Blockly.utils.string.commonWordPrefix */ export function commonWordPrefix( array: string[], opt_shortest?: number): number { @@ -98,7 +95,6 @@ export function commonWordPrefix( * @param array Array of strings. * @param opt_shortest Length of shortest string. * @returns Length of common suffix. - * @alias Blockly.utils.string.commonWordSuffix */ export function commonWordSuffix( array: string[], opt_shortest?: number): number { @@ -136,7 +132,6 @@ export function commonWordSuffix( * @param text Text to wrap. * @param limit Width to wrap each line. * @returns Wrapped text. - * @alias Blockly.utils.string.wrap */ export function wrap(text: string, limit: number): string { const lines = text.split('\n'); @@ -306,7 +301,6 @@ function wrapToText(words: string[], wordBreaks: boolean[]): string { * * @param str Input string. * @returns True if number, false otherwise. - * @alias Blockly.utils.string.isNumber */ export function isNumber(str: string): boolean { return /^\s*-?\d+(\.\d+)?\s*$/.test(str); diff --git a/core/utils/style.ts b/core/utils/style.ts index dbe6f9020..11c6fa232 100644 --- a/core/utils/style.ts +++ b/core/utils/style.ts @@ -26,7 +26,6 @@ import {Size} from './size.js'; * * @param element Element to get size of. * @returns Object with width/height properties. - * @alias Blockly.utils.style.getSize */ export function getSize(element: Element): Size { return TEST_ONLY.getSizeInternal(element); @@ -84,7 +83,6 @@ function getSizeWithDisplay(element: Element): Size { * @param element Element to get style of. * @param property Property to get (camel-case). * @returns Style value. - * @alias Blockly.utils.style.getComputedStyle */ export function getComputedStyle(element: Element, property: string): string { const styles = window.getComputedStyle(element); @@ -104,7 +102,6 @@ export function getComputedStyle(element: Element, property: string): string { * @param style Property to get (camel-case). * @returns Style value. * @deprecated No longer provided by Blockly. - * @alias Blockly.utils.style.getCascadedStyle */ export function getCascadedStyle(element: Element, style: string): string { deprecation.warn( @@ -123,7 +120,6 @@ export function getCascadedStyle(element: Element, style: string): string { * * @param el Element to get the page offset for. * @returns The page offset. - * @alias Blockly.utils.style.getPageOffset */ export function getPageOffset(el: Element): Coordinate { const pos = new Coordinate(0, 0); @@ -146,7 +142,6 @@ export function getPageOffset(el: Element): Coordinate { * Similar to Closure's goog.style.getViewportPageOffset * * @returns The page offset of the viewport. - * @alias Blockly.utils.style.getViewportPageOffset */ export function getViewportPageOffset(): Coordinate { const body = document.body; @@ -162,7 +157,6 @@ export function getViewportPageOffset(): Coordinate { * * @param element The element to get the border widths for. * @returns The computed border widths. - * @alias Blockly.utils.style.getBorderBox */ export function getBorderBox(element: Element): Rect { const left = parseFloat(getComputedStyle(element, 'borderLeftWidth')); @@ -185,7 +179,6 @@ export function getBorderBox(element: Element): Rect { * scroll element will be used. * @param opt_center Whether to center the element in the container. * Defaults to false. - * @alias Blockly.utils.style.scrollIntoContainerView */ export function scrollIntoContainerView( element: Element, container: Element, opt_center?: boolean) { @@ -207,7 +200,6 @@ export function scrollIntoContainerView( * @param opt_center Whether to center the element in the container. * Defaults to false. * @returns The new scroll position of the container. - * @alias Blockly.utils.style.getContainerOffsetToScrollInto */ export function getContainerOffsetToScrollInto( element: Element, container: Element, opt_center?: boolean): Coordinate { diff --git a/core/utils/svg.ts b/core/utils/svg.ts index 798505351..04904fcb9 100644 --- a/core/utils/svg.ts +++ b/core/utils/svg.ts @@ -16,8 +16,6 @@ goog.declareModuleId('Blockly.utils.Svg'); /** * A name with the type of the SVG element stored in the generic. - * - * @alias Blockly.utils.Svg */ export class Svg<_T> { /** @internal */ diff --git a/core/utils/svg_math.ts b/core/utils/svg_math.ts index 60820c915..8fdb1e393 100644 --- a/core/utils/svg_math.ts +++ b/core/utils/svg_math.ts @@ -43,7 +43,6 @@ const XY_STYLE_REGEX = * * @param element SVG element to find the coordinates of. * @returns Object with .x and .y properties. - * @alias Blockly.utils.svgMath.getRelativeXY */ export function getRelativeXY(element: Element): Coordinate { const xy = new Coordinate(0, 0); @@ -90,7 +89,6 @@ export function getRelativeXY(element: Element): Coordinate { * @param element SVG element to find the coordinates of. If this is not a child * of the div Blockly was injected into, the behaviour is undefined. * @returns Object with .x and .y properties. - * @alias Blockly.utils.svgMath.getInjectionDivXY */ export function getInjectionDivXY(element: Element): Coordinate { let x = 0; @@ -114,7 +112,6 @@ export function getInjectionDivXY(element: Element): Coordinate { * * @returns True if 3D transforms are supported. * @deprecated No longer provided by Blockly. - * @alias Blockly.utils.svgMath.is3dSupported */ export function is3dSupported(): boolean { // All browsers support translate3d in 2022. @@ -129,7 +126,6 @@ export function is3dSupported(): boolean { * * @returns An object containing window width, height, and scroll position in * window coordinates. - * @alias Blockly.utils.svgMath.getViewportBBox * @internal */ export function getViewportBBox(): Rect { @@ -145,7 +141,6 @@ export function getViewportBBox(): Rect { * Copied from Closure's goog.dom.getDocumentScroll. * * @returns Object with values 'x' and 'y'. - * @alias Blockly.utils.svgMath.getDocumentScroll */ export function getDocumentScroll(): Coordinate { const el = document.documentElement; @@ -161,7 +156,6 @@ export function getDocumentScroll(): Coordinate { * @param screenCoordinates The screen coordinates to be converted to workspace * coordinates * @returns The workspace coordinates. - * @alias Blockly.utils.svgMath.screenToWsCoordinates */ export function screenToWsCoordinates( ws: WorkspaceSvg, screenCoordinates: Coordinate): Coordinate { diff --git a/core/utils/svg_paths.ts b/core/utils/svg_paths.ts index d87766604..6c9707c47 100644 --- a/core/utils/svg_paths.ts +++ b/core/utils/svg_paths.ts @@ -22,7 +22,6 @@ goog.declareModuleId('Blockly.utils.svgPaths'); * @param x The x coordinate. * @param y The y coordinate. * @returns A string of the format ' x,y ' - * @alias Blockly.utils.svgPaths.point */ export function point(x: number, y: number): string { return ' ' + x + ',' + y + ' '; @@ -40,7 +39,6 @@ export function point(x: number, y: number): string { * x, y '. * @returns A string defining one or more Bezier curves. See the MDN * documentation for exact format. - * @alias Blockly.utils.svgPaths.curve */ export function curve(command: string, points: string[]): string { return ' ' + command + points.join(''); @@ -55,7 +53,6 @@ export function curve(command: string, points: string[]): string { * @param x The absolute x coordinate. * @param y The absolute y coordinate. * @returns A string of the format ' M x,y ' - * @alias Blockly.utils.svgPaths.moveTo */ export function moveTo(x: number, y: number): string { return ' M ' + x + ',' + y + ' '; @@ -70,7 +67,6 @@ export function moveTo(x: number, y: number): string { * @param dx The relative x coordinate. * @param dy The relative y coordinate. * @returns A string of the format ' m dx,dy ' - * @alias Blockly.utils.svgPaths.moveBy */ export function moveBy(dx: number, dy: number): string { return ' m ' + dx + ',' + dy + ' '; @@ -85,7 +81,6 @@ export function moveBy(dx: number, dy: number): string { * @param dx The relative x coordinate. * @param dy The relative y coordinate. * @returns A string of the format ' l dx,dy ' - * @alias Blockly.utils.svgPaths.lineTo */ export function lineTo(dx: number, dy: number): string { return ' l ' + dx + ',' + dy + ' '; @@ -100,7 +95,6 @@ export function lineTo(dx: number, dy: number): string { * @param points An array containing all of the points to draw lines to, in * order. The points are represented as strings of the format ' dx,dy '. * @returns A string of the format ' l (dx,dy)+ ' - * @alias Blockly.utils.svgPaths.line */ export function line(points: string[]): string { return ' l' + points.join(''); @@ -118,7 +112,6 @@ export function line(points: string[]): string { * @param val The coordinate to pass to the command. It may be absolute or * relative. * @returns A string of the format ' command val ' - * @alias Blockly.utils.svgPaths.lineOnAxis */ export function lineOnAxis(command: string, val: number): string { return ' ' + command + ' ' + val + ' '; @@ -136,7 +129,6 @@ export function lineOnAxis(command: string, val: number): string { * @param point The point to move the cursor to after drawing the arc, specified * either in absolute or relative coordinates depending on the command. * @returns A string of the format 'command radius radius flags point' - * @alias Blockly.utils.svgPaths.arc */ export function arc( command: string, flags: string, radius: number, point: string): string { diff --git a/core/utils/toolbox.ts b/core/utils/toolbox.ts index 28a64b778..e41c35848 100644 --- a/core/utils/toolbox.ts +++ b/core/utils/toolbox.ts @@ -21,8 +21,6 @@ import * as Xml from '../xml.js'; /** * The information needed to create a block in the toolbox. * Note that disabled has a different type for backwards compatibility. - * - * @alias Blockly.utils.toolbox.BlockInfo */ export interface BlockInfo { kind: string; @@ -46,8 +44,6 @@ export interface BlockInfo { /** * The information needed to create a separator in the toolbox. - * - * @alias Blockly.utils.toolbox.SeparatorInfo */ export interface SeparatorInfo { kind: string; @@ -58,8 +54,6 @@ export interface SeparatorInfo { /** * The information needed to create a button in the toolbox. - * - * @alias Blockly.utils.toolbox.ButtonInfo */ export interface ButtonInfo { kind: string; @@ -69,8 +63,6 @@ export interface ButtonInfo { /** * The information needed to create a label in the toolbox. - * - * @alias Blockly.utils.toolbox.LabelInfo */ export interface LabelInfo { kind: string; @@ -80,15 +72,11 @@ export interface LabelInfo { /** * The information needed to create either a button or a label in the flyout. - * - * @alias Blockly.utils.toolbox.ButtonOrLabelInfo */ export type ButtonOrLabelInfo = ButtonInfo|LabelInfo; /** * The information needed to create a category in the toolbox. - * - * @alias Blockly.utils.toolbox.StaticCategoryInfo */ export interface StaticCategoryInfo { kind: string; @@ -104,8 +92,6 @@ export interface StaticCategoryInfo { /** * The information needed to create a custom category. - * - * @alias Blockly.utils.toolbox.DynamicCategoryInfo */ export interface DynamicCategoryInfo { kind: string; @@ -120,30 +106,22 @@ export interface DynamicCategoryInfo { /** * The information needed to create either a dynamic or static category. - * - * @alias Blockly.utils.toolbox.CategoryInfo */ export type CategoryInfo = StaticCategoryInfo|DynamicCategoryInfo; /** * Any information that can be used to create an item in the toolbox. - * - * @alias Blockly.utils.toolbox.ToolboxItemInfo */ export type ToolboxItemInfo = FlyoutItemInfo|StaticCategoryInfo; /** * All the different types that can be displayed in a flyout. - * - * @alias Blockly.utils.toolbox.FlyoutItemInfo */ export type FlyoutItemInfo = BlockInfo|SeparatorInfo|ButtonInfo|LabelInfo|DynamicCategoryInfo; /** * The JSON definition of a toolbox. - * - * @alias Blockly.utils.toolbox.ToolboxInfo */ export interface ToolboxInfo { kind?: string; @@ -152,22 +130,16 @@ export interface ToolboxInfo { /** * An array holding flyout items. - * - * @alias Blockly.utils.toolbox.FlyoutItemInfoArray */ export type FlyoutItemInfoArray = FlyoutItemInfo[]; /** * All of the different types that can create a toolbox. - * - * @alias Blockly.utils.toolbox.ToolboxDefinition */ export type ToolboxDefinition = Node|ToolboxInfo|string; /** * All of the different types that can be used to show items in a flyout. - * - * @alias Blockly.utils.toolbox.FlyoutDefinition */ export type FlyoutDefinition = FlyoutItemInfoArray|NodeList|ToolboxInfo|Node[]; @@ -187,8 +159,6 @@ const FLYOUT_TOOLBOX_KIND = 'flyoutToolbox'; /** * Position of the toolbox and/or flyout relative to the workspace. - * - * @alias Blockly.utils.toolbox.Position */ export enum Position { TOP, @@ -202,7 +172,6 @@ export enum Position { * * @param toolboxDef The definition of the toolbox in one of its many forms. * @returns Object holding information for creating a toolbox. - * @alias Blockly.utils.toolbox.convertToolboxDefToJson * @internal */ export function convertToolboxDefToJson(toolboxDef: ToolboxDefinition| @@ -252,7 +221,6 @@ function validateToolbox(toolboxJson: ToolboxInfo) { * * @param flyoutDef The definition of the flyout in one of its many forms. * @returns A list of flyout items. - * @alias Blockly.utils.toolbox.convertFlyoutDefToJsonArray * @internal */ export function convertFlyoutDefToJsonArray(flyoutDef: FlyoutDefinition| @@ -284,7 +252,6 @@ export function convertFlyoutDefToJsonArray(flyoutDef: FlyoutDefinition| * * @param toolboxJson Object holding information for creating a toolbox. * @returns True if the toolbox has categories. - * @alias Blockly.utils.toolbox.hasCategories * @internal */ export function hasCategories(toolboxJson: ToolboxInfo|null): boolean { @@ -315,7 +282,6 @@ function hasCategoriesInternal(toolboxJson: ToolboxInfo|null): boolean { * * @param categoryInfo Object holing information for creating a category. * @returns True if the category has subcategories. - * @alias Blockly.utils.toolbox.isCategoryCollapsible * @internal */ export function isCategoryCollapsible(categoryInfo: CategoryInfo): boolean { @@ -415,7 +381,6 @@ function addAttributes(node: Node, obj: AnyDuringMigration) { * * @param toolboxDef DOM tree of blocks, or text representation of same. * @returns DOM tree of blocks, or null. - * @alias Blockly.utils.toolbox.parseToolboxTree */ export function parseToolboxTree(toolboxDef: Element|null|string): Element| null { diff --git a/core/utils/useragent.ts b/core/utils/useragent.ts index d0b7f91e8..59808af1b 100644 --- a/core/utils/useragent.ts +++ b/core/utils/useragent.ts @@ -78,26 +78,18 @@ isTablet = isIPad || isAndroid && !has('Mobile') || has('Silk'); isMobile = !isTablet && (isIPhone || isAndroid); })(globalThis['navigator'] && globalThis['navigator']['userAgent'] || ''); -/** @alias Blockly.utils.userAgent.raw */ export const raw: string = rawUserAgent; -/** @alias Blockly.utils.userAgent.JavaFx */ export const JavaFx: boolean = isJavaFx; -/** @alias Blockly.utils.userAgent.GECKO */ export const GECKO: boolean = isGecko; -/** @alias Blockly.utils.userAgent.ANDROID */ export const ANDROID: boolean = isAndroid; -/** @alias Blockly.utils.userAgent.IPAD */ export const IPAD: boolean = isIPad; -/** @alias Blockly.utils.userAgent.IPHONE */ export const IPHONE: boolean = isIPhone; -/** @alias Blockly.utils.userAgent.MAC */ export const MAC: boolean = isMac; -/** @alias Blockly.utils.userAgent.MOBILE */ export const MOBILE: boolean = isMobile; diff --git a/core/utils/xml.ts b/core/utils/xml.ts index c33712992..b64e85dd4 100644 --- a/core/utils/xml.ts +++ b/core/utils/xml.ts @@ -61,8 +61,6 @@ export function injectDependencies(dependencies: { /** * Namespace for Blockly's XML. - * - * @alias Blockly.utils.xml.NAME_SPACE */ export const NAME_SPACE = 'https://developers.google.com/blockly/xml'; @@ -71,7 +69,6 @@ export const NAME_SPACE = 'https://developers.google.com/blockly/xml'; * * @returns The document object. * @deprecated No longer provided by Blockly. - * @alias Blockly.utils.xml.getDocument */ export function getDocument(): Document { deprecation.warn('Blockly.utils.xml.getDocument', 'version 9', 'version 10'); @@ -83,7 +80,6 @@ export function getDocument(): Document { * * @param xmlDocument The document object to use. * @deprecated No longer provided by Blockly. - * @alias Blockly.utils.xml.setDocument */ export function setDocument(xmlDocument: Document) { deprecation.warn('Blockly.utils.xml.setDocument', 'version 9', 'version 10'); @@ -95,7 +91,6 @@ export function setDocument(xmlDocument: Document) { * * @param tagName Name of DOM element. * @returns New DOM element. - * @alias Blockly.utils.xml.createElement */ export function createElement(tagName: string): Element { return document.createElementNS(NAME_SPACE, tagName); @@ -106,7 +101,6 @@ export function createElement(tagName: string): Element { * * @param text Text content. * @returns New DOM text node. - * @alias Blockly.utils.xml.createTextNode */ export function createTextNode(text: string): Text { return document.createTextNode(text); @@ -118,7 +112,6 @@ export function createTextNode(text: string): Text { * @param text XML string. * @returns The DOM document. * @throws if XML doesn't parse. - * @alias Blockly.utils.xml.textToDomDocument */ export function textToDomDocument(text: string): Document { const oParser = new DOMParser(); @@ -131,7 +124,6 @@ export function textToDomDocument(text: string): Document { * * @param dom A tree of XML nodes. * @returns Text representation. - * @alias Blockly.utils.xml.domToText */ export function domToText(dom: Node): string { const oSerializer = new XMLSerializer(); diff --git a/core/variable_map.ts b/core/variable_map.ts index ecba4b87f..45f562618 100644 --- a/core/variable_map.ts +++ b/core/variable_map.ts @@ -32,8 +32,6 @@ import type {Workspace} from './workspace.js'; * Class for a variable map. This contains a dictionary data structure with * variable types as keys and lists of variables as values. The list of * variables are the type indicated by the key. - * - * @alias Blockly.VariableMap */ export class VariableMap { /** diff --git a/core/variable_model.ts b/core/variable_model.ts index cfd832a90..11c901474 100644 --- a/core/variable_model.ts +++ b/core/variable_model.ts @@ -24,7 +24,6 @@ import type {Workspace} from './workspace.js'; * Holds information for the variable including name, ID, and type. * * @see {Blockly.FieldVariable} - * @alias Blockly.VariableModel */ export class VariableModel { type: string; diff --git a/core/variables.ts b/core/variables.ts index e50327347..f919aca24 100644 --- a/core/variables.ts +++ b/core/variables.ts @@ -28,8 +28,6 @@ import * as Xml from './xml.js'; * variable blocks. * See also Blockly.Procedures.CATEGORY_NAME and * Blockly.VariablesDynamic.CATEGORY_NAME. - * - * @alias Blockly.Variables.CATEGORY_NAME */ export const CATEGORY_NAME = 'VARIABLE'; @@ -41,7 +39,6 @@ export const CATEGORY_NAME = 'VARIABLE'; * * @param ws The workspace to search for variables. * @returns Array of variable models. - * @alias Blockly.Variables.allUsedVarModels */ export function allUsedVarModels(ws: Workspace): VariableModel[] { const blocks = ws.getAllBlocks(false); @@ -73,7 +70,6 @@ export function allUsedVarModels(ws: Workspace): VariableModel[] { * * @param workspace The workspace to search. * @returns A list of non-duplicated variable names. - * @alias Blockly.Variables.allDeveloperVariables */ export function allDeveloperVariables(workspace: Workspace): string[] { const blocks = workspace.getAllBlocks(false); @@ -97,7 +93,6 @@ export function allDeveloperVariables(workspace: Workspace): string[] { * * @param workspace The workspace containing variables. * @returns Array of XML elements. - * @alias Blockly.Variables.flyoutCategory */ export function flyoutCategory(workspace: WorkspaceSvg): Element[] { let xmlList = new Array(); @@ -121,7 +116,6 @@ export function flyoutCategory(workspace: WorkspaceSvg): Element[] { * * @param workspace The workspace containing variables. * @returns Array of XML block elements. - * @alias Blockly.Variables.flyoutCategoryBlocks */ export function flyoutCategoryBlocks(workspace: Workspace): Element[] { const variableModelList = workspace.getVariablesOfType(''); @@ -166,7 +160,6 @@ export function flyoutCategoryBlocks(workspace: Workspace): Element[] { return xmlList; } -/** @alias Blockly.Variables.VAR_LETTER_OPTIONS */ export const VAR_LETTER_OPTIONS = 'ijkmnopqrstuvwxyzabcdefgh'; /** @@ -177,7 +170,6 @@ export const VAR_LETTER_OPTIONS = 'ijkmnopqrstuvwxyzabcdefgh'; * * @param workspace The workspace to be unique in. * @returns New variable name. - * @alias Blockly.Variables.generateUniqueName */ export function generateUniqueName(workspace: Workspace): string { return TEST_ONLY.generateUniqueNameInternal(workspace); @@ -199,7 +191,6 @@ function generateUniqueNameInternal(workspace: Workspace): string { * @param startChar The character to start the search at. * @param usedNames A list of all of the used names. * @returns A unique name that is not present in the usedNames array. - * @alias Blockly.Variables.generateUniqueNameFromOptions */ export function generateUniqueNameFromOptions( startChar: string, usedNames: string[]): string { @@ -251,7 +242,6 @@ export function generateUniqueNameFromOptions( * an existing variable was chosen. * @param opt_type The type of the variable like 'int', 'string', or ''. This * will default to '', which is a specific type. - * @alias Blockly.Variables.createVariableButtonHandler */ export function createVariableButtonHandler( workspace: Workspace, opt_callback?: (p1?: string|null) => void, @@ -301,7 +291,6 @@ export function createVariableButtonHandler( * @param opt_callback A callback. It will be passed an acceptable new variable * name, or null if change is to be aborted (cancel button), or undefined if * an existing variable was chosen. - * @alias Blockly.Variables.renameVariable */ export function renameVariable( workspace: Workspace, variable: VariableModel, @@ -345,7 +334,6 @@ export function renameVariable( * @param defaultText The default value to show in the prompt's field. * @param callback A callback. It will be passed the new variable name, or null * if the user picked something illegal. - * @alias Blockly.Variables.promptName */ export function promptName( promptText: string, defaultText: string, @@ -392,7 +380,6 @@ function nameUsedWithOtherType( * @param name The name to search for. * @param workspace The workspace to search for the variable. * @returns The variable with the given name, or null if none was found. - * @alias Blockly.Variables.nameUsedWithAnyType */ export function nameUsedWithAnyType( name: string, workspace: Workspace): VariableModel|null { @@ -412,7 +399,6 @@ export function nameUsedWithAnyType( * * @param variableModel The variable model to represent. * @returns The generated DOM. - * @alias Blockly.Variables.generateVariableFieldDom */ export function generateVariableFieldDom(variableModel: VariableModel): Element { @@ -439,7 +425,6 @@ export function generateVariableFieldDom(variableModel: VariableModel): * @param opt_type The type to use to look up or create the variable. * @returns The variable corresponding to the given ID or name + type * combination. - * @alias Blockly.Variables.getOrCreateVariablePackage */ export function getOrCreateVariablePackage( workspace: Workspace, id: string|null, opt_name?: string, @@ -465,7 +450,6 @@ export function getOrCreateVariablePackage( * Only used if lookup by ID fails. * @returns The variable corresponding to the given ID or name + type * combination, or null if not found. - * @alias Blockly.Variables.getVariable */ export function getVariable( workspace: Workspace, id: string|null, opt_name?: string, @@ -543,7 +527,6 @@ function createVariable( * @returns The new array of variables that were freshly added to the workspace * after creating the new block, or [] if no new variables were added to the * workspace. - * @alias Blockly.Variables.getAddedVariables * @internal */ export function getAddedVariables( diff --git a/core/variables_dynamic.ts b/core/variables_dynamic.ts index 6191b99d2..500cbec41 100644 --- a/core/variables_dynamic.ts +++ b/core/variables_dynamic.ts @@ -28,8 +28,6 @@ import type {FlyoutButton} from './flyout_button.js'; * variable blocks. * See also Blockly.Variables.CATEGORY_NAME and * Blockly.Procedures.CATEGORY_NAME. - * - * @alias Blockly.VariablesDynamic.CATEGORY_NAME */ export const CATEGORY_NAME = 'VARIABLE_DYNAMIC'; @@ -75,7 +73,6 @@ export const onCreateVariableButtonClick_Colour = colourButtonClickHandler; * * @param workspace The workspace containing variables. * @returns Array of XML elements. - * @alias Blockly.VariablesDynamic.flyoutCategory */ export function flyoutCategory(workspace: WorkspaceSvg): Element[] { let xmlList = new Array(); @@ -109,7 +106,6 @@ export function flyoutCategory(workspace: WorkspaceSvg): Element[] { * * @param workspace The workspace containing variables. * @returns Array of XML block elements. - * @alias Blockly.VariablesDynamic.flyoutCategoryBlocks */ export function flyoutCategoryBlocks(workspace: Workspace): Element[] { const variableModelList = workspace.getAllVariables(); diff --git a/core/warning.ts b/core/warning.ts index 76ae9ff00..8e80f9234 100644 --- a/core/warning.ts +++ b/core/warning.ts @@ -26,8 +26,6 @@ import {Svg} from './utils/svg.js'; /** * Class for a warning. - * - * @alias Blockly.Warning */ export class Warning extends Icon { private text: {[key: string]: string}; diff --git a/core/widgetdiv.ts b/core/widgetdiv.ts index 1ca04092f..9a24540ac 100644 --- a/core/widgetdiv.ts +++ b/core/widgetdiv.ts @@ -40,7 +40,6 @@ let containerDiv: HTMLDivElement|null; * Returns the HTML container for editor widgets. * * @returns The editor widget container. - * @alias Blockly.WidgetDiv.getDiv */ export function getDiv(): HTMLDivElement|null { return containerDiv; @@ -50,7 +49,6 @@ export function getDiv(): HTMLDivElement|null { * Allows unit tests to reset the div. Do not use outside of tests. * * @param newDiv The new value for the DIV field. - * @alias Blockly.WidgetDiv.testOnly_setDiv * @internal */ export function testOnly_setDiv(newDiv: HTMLDivElement|null) { @@ -59,8 +57,6 @@ export function testOnly_setDiv(newDiv: HTMLDivElement|null) { /** * Create the widget div and inject it onto the page. - * - * @alias Blockly.WidgetDiv.createDom */ export function createDom() { if (containerDiv) { @@ -80,7 +76,6 @@ export function createDom() { * @param rtl Right-to-left (true) or left-to-right (false). * @param newDispose Optional cleanup function to be run when the widget is * closed. - * @alias Blockly.WidgetDiv.show */ export function show(newOwner: unknown, rtl: boolean, newDispose: () => void) { hide(); @@ -103,8 +98,6 @@ export function show(newOwner: unknown, rtl: boolean, newDispose: () => void) { /** * Destroy the widget and hide the div. - * - * @alias Blockly.WidgetDiv.hide */ export function hide() { if (!isVisible()) { @@ -136,7 +129,6 @@ export function hide() { * Is the container visible? * * @returns True if visible. - * @alias Blockly.WidgetDiv.isVisible */ export function isVisible(): boolean { return !!owner; @@ -147,7 +139,6 @@ export function isVisible(): boolean { * object. * * @param oldOwner The object that was using this container. - * @alias Blockly.WidgetDiv.hideIfOwner */ export function hideIfOwner(oldOwner: unknown) { if (owner === oldOwner) { @@ -182,7 +173,6 @@ function positionInternal(x: number, y: number, height: number) { * window coordinates. * @param rtl Whether the workspace is in RTL mode. This determines horizontal * alignment. - * @alias Blockly.WidgetDiv.positionWithAnchor * @internal */ export function positionWithAnchor( diff --git a/core/workspace.ts b/core/workspace.ts index 4018cef9f..61cbb3fa7 100644 --- a/core/workspace.ts +++ b/core/workspace.ts @@ -39,8 +39,6 @@ import {ObservableProcedureMap} from './observable_procedure_map.js'; /** * Class for a workspace. This is a data structure that contains blocks. * There is no UI, and can be created headlessly. - * - * @alias Blockly.Workspace */ export class Workspace implements IASTNodeLocation { /** diff --git a/core/workspace_audio.ts b/core/workspace_audio.ts index 3c9d443f8..7874161f8 100644 --- a/core/workspace_audio.ts +++ b/core/workspace_audio.ts @@ -25,8 +25,6 @@ const SOUND_LIMIT = 100; /** * Class for loading, storing, and playing audio for a workspace. - * - * @alias Blockly.WorkspaceAudio */ export class WorkspaceAudio { /** Database of pre-loaded sounds. */ diff --git a/core/workspace_comment.ts b/core/workspace_comment.ts index 8870c6245..4a4de35ff 100644 --- a/core/workspace_comment.ts +++ b/core/workspace_comment.ts @@ -22,8 +22,6 @@ import type {Workspace} from './workspace.js'; /** * Class for a workspace comment. - * - * @alias Blockly.WorkspaceComment */ export class WorkspaceComment { id: string; diff --git a/core/workspace_comment_svg.ts b/core/workspace_comment_svg.ts index 4a86e89f9..318c4ee77 100644 --- a/core/workspace_comment_svg.ts +++ b/core/workspace_comment_svg.ts @@ -45,8 +45,6 @@ const TEXTAREA_OFFSET = 2; /** * Class for a workspace comment's SVG representation. - * - * @alias Blockly.WorkspaceCommentSvg */ export class WorkspaceCommentSvg extends WorkspaceComment implements IBoundedElement, IBubble, ICopyable { diff --git a/core/workspace_dragger.ts b/core/workspace_dragger.ts index 939c73ab6..35f6e97f5 100644 --- a/core/workspace_dragger.ts +++ b/core/workspace_dragger.ts @@ -20,8 +20,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; /** * Class for a workspace dragger. It moves the workspace around when it is * being dragged by a mouse or touch. - * - * @alias Blockly.WorkspaceDragger */ export class WorkspaceDragger { private readonly horizontalScrollEnabled_: boolean; diff --git a/core/workspace_svg.ts b/core/workspace_svg.ts index 67bdaf814..dfc287afa 100644 --- a/core/workspace_svg.ts +++ b/core/workspace_svg.ts @@ -85,8 +85,6 @@ const ZOOM_TO_FIT_MARGIN = 20; /** * Class for a workspace. This is an onscreen area with optional trashcan, * scrollbars, bubbles, and dragging. - * - * @alias Blockly.WorkspaceSvg */ export class WorkspaceSvg extends Workspace implements IASTNodeLocationSvg { /** @@ -2478,7 +2476,6 @@ export class WorkspaceSvg extends Workspace implements IASTNodeLocationSvg { * scrollbars accordingly. * * @param workspace The workspace to resize. - * @alias Blockly.WorkspaceSvg.resizeSvgContents * @internal */ export function resizeSvgContents(workspace: WorkspaceSvg) { diff --git a/core/xml.ts b/core/xml.ts index 4ecde7780..78c5d31b2 100644 --- a/core/xml.ts +++ b/core/xml.ts @@ -35,7 +35,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; * @param workspace The workspace containing blocks. * @param opt_noId True if the encoder should skip the block IDs. * @returns XML DOM element. - * @alias Blockly.Xml.workspaceToDom */ export function workspaceToDom( workspace: Workspace, opt_noId?: boolean): Element { @@ -63,7 +62,6 @@ export function workspaceToDom( * * @param variableList List of all variable models. * @returns Tree of XML elements. - * @alias Blockly.Xml.variablesToDom */ export function variablesToDom(variableList: VariableModel[]): Element { const variables = utilsXml.createElement('variables'); @@ -87,7 +85,6 @@ export function variablesToDom(variableList: VariableModel[]): Element { * @param opt_noId True if the encoder should skip the block ID. * @returns Tree of XML elements or an empty document fragment if the block was * an insertion marker. - * @alias Blockly.Xml.blockToDomWithXY */ export function blockToDomWithXY(block: Block, opt_noId?: boolean): Element| DocumentFragment { @@ -158,7 +155,6 @@ function allFieldsToDom(block: Block, element: Element) { * @param opt_noId True if the encoder should skip the block ID. * @returns Tree of XML elements or an empty document fragment if the block was * an insertion marker. - * @alias Blockly.Xml.blockToDom */ export function blockToDom(block: Block, opt_noId?: boolean): Element| DocumentFragment { @@ -337,7 +333,6 @@ function cloneShadow(shadow: Element, opt_noId?: boolean): Element { * * @param dom A tree of XML nodes. * @returns Text representation. - * @alias Blockly.Xml.domToText */ export function domToText(dom: Node): string { const text = utilsXml.domToText(dom); @@ -351,7 +346,6 @@ export function domToText(dom: Node): string { * * @param dom A tree of XML elements. * @returns Text representation. - * @alias Blockly.Xml.domToPrettyText */ export function domToPrettyText(dom: Node): string { // This function is not guaranteed to be correct for all XML. @@ -386,7 +380,6 @@ export function domToPrettyText(dom: Node): string { * @returns A DOM object representing the singular child of the document * element. * @throws if the text doesn't parse. - * @alias Blockly.Xml.textToDom */ export function textToDom(text: string): Element { const doc = utilsXml.textToDomDocument(text); @@ -404,7 +397,6 @@ export function textToDom(text: string): Element { * @param xml XML DOM. * @param workspace The workspace. * @returns An array containing new block IDs. - * @alias Blockly.Xml.clearWorkspaceAndLoadFromXml */ export function clearWorkspaceAndLoadFromXml( xml: Element, workspace: WorkspaceSvg): string[] { @@ -425,7 +417,6 @@ export function clearWorkspaceAndLoadFromXml( * @returns An array containing new block IDs. * @suppress {strictModuleDepCheck} Suppress module check while workspace * comments are not bundled in. - * @alias Blockly.Xml.domToWorkspace */ export function domToWorkspace(xml: Element, workspace: Workspace): string[] { let width = 0; // Not used in LTR. @@ -512,7 +503,6 @@ export function domToWorkspace(xml: Element, workspace: Workspace): string[] { * @param xml The XML DOM. * @param workspace The workspace to add to. * @returns An array containing new block IDs. - * @alias Blockly.Xml.appendDomToWorkspace */ export function appendDomToWorkspace( xml: Element, workspace: WorkspaceSvg): string[] { @@ -566,7 +556,6 @@ export function appendDomToWorkspace( * @param xmlBlock XML block element. * @param workspace The workspace. * @returns The root block created. - * @alias Blockly.Xml.domToBlock */ export function domToBlock(xmlBlock: Element, workspace: Workspace): Block { // Create top-level block. @@ -630,7 +619,6 @@ export function domToBlock(xmlBlock: Element, workspace: Workspace): Block { * * @param xmlVariables List of XML variable elements. * @param workspace The workspace to which the variable should be added. - * @alias Blockly.Xml.domToVariables */ export function domToVariables(xmlVariables: Element, workspace: Workspace) { for (let i = 0; i < xmlVariables.children.length; i++) { @@ -1020,7 +1008,6 @@ function domToField(block: Block, fieldName: string, xml: Element) { * * @param xmlBlock XML block element or an empty DocumentFragment if the block * was an insertion marker. - * @alias Blockly.Xml.deleteNext */ export function deleteNext(xmlBlock: Element|DocumentFragment) { for (let i = 0; i < xmlBlock.childNodes.length; i++) { diff --git a/core/zoom_controls.ts b/core/zoom_controls.ts index b25ff4a85..128ad7fa6 100644 --- a/core/zoom_controls.ts +++ b/core/zoom_controls.ts @@ -33,8 +33,6 @@ import type {WorkspaceSvg} from './workspace_svg.js'; /** * Class for a zoom controls. - * - * @alias Blockly.ZoomControls */ export class ZoomControls implements IPositionable { /** diff --git a/demos/blockfactory/block_definition_extractor.js b/demos/blockfactory/block_definition_extractor.js index ef791a224..35186ac84 100644 --- a/demos/blockfactory/block_definition_extractor.js +++ b/demos/blockfactory/block_definition_extractor.js @@ -17,7 +17,6 @@ * * The exampleBlocklyBlock is usually the block loaded into the * preview workspace after manually entering the block definition. - * */ 'use strict'; diff --git a/demos/blockfactory/block_exporter_controller.js b/demos/blockfactory/block_exporter_controller.js index 66e7c61fe..bd41f2e74 100644 --- a/demos/blockfactory/block_exporter_controller.js +++ b/demos/blockfactory/block_exporter_controller.js @@ -9,7 +9,6 @@ * users to export block definitions and generator stubs of their saved blocks * easily using a visual interface. Depends on Block Exporter View and Block * Exporter Tools classes. Interacts with Export Settings in the index.html. - * */ 'use strict'; diff --git a/demos/blockfactory/block_exporter_tools.js b/demos/blockfactory/block_exporter_tools.js index bec5e86b2..58da9be1a 100644 --- a/demos/blockfactory/block_exporter_tools.js +++ b/demos/blockfactory/block_exporter_tools.js @@ -9,7 +9,6 @@ * block definitions and generator stubs for given block types. Also generates * toolbox XML for the exporter's workspace. Depends on the FactoryUtils for * its code generation functions. - * */ 'use strict'; diff --git a/demos/blockfactory/block_exporter_view.js b/demos/blockfactory/block_exporter_view.js index 6c2562a55..aa840e59d 100644 --- a/demos/blockfactory/block_exporter_view.js +++ b/demos/blockfactory/block_exporter_view.js @@ -7,7 +7,6 @@ /** * @fileoverview Javascript for the Block Exporter View class. Reads from and * manages a block selector through which users select blocks to export. - * */ 'use strict'; diff --git a/demos/blockfactory/block_library_controller.js b/demos/blockfactory/block_library_controller.js index 25d50726e..2192a7bdd 100644 --- a/demos/blockfactory/block_library_controller.js +++ b/demos/blockfactory/block_library_controller.js @@ -13,7 +13,6 @@ * - delete blocks * - clear their block library * Depends on BlockFactory functions defined in factory.js. - * */ 'use strict'; diff --git a/demos/blockfactory/block_library_storage.js b/demos/blockfactory/block_library_storage.js index dc19ce64f..a413a6c73 100644 --- a/demos/blockfactory/block_library_storage.js +++ b/demos/blockfactory/block_library_storage.js @@ -7,7 +7,6 @@ /** * @fileoverview Javascript for Block Library's Storage Class. * Depends on Block Library for its namespace. - * */ 'use strict'; diff --git a/demos/blockfactory/block_library_view.js b/demos/blockfactory/block_library_view.js index 2a47dcd0f..a47980408 100644 --- a/demos/blockfactory/block_library_view.js +++ b/demos/blockfactory/block_library_view.js @@ -7,7 +7,6 @@ /** * @fileoverview Javascript for BlockLibraryView class. It manages the display * of the Block Library dropdown, save, and delete buttons. - * */ 'use strict'; diff --git a/demos/blockfactory/block_option.js b/demos/blockfactory/block_option.js index efc308834..184c3c235 100644 --- a/demos/blockfactory/block_option.js +++ b/demos/blockfactory/block_option.js @@ -9,7 +9,6 @@ * of the various blocks that you may select in the Block Selector. Each block * option has a checkbox, a label, and a preview workspace through which to * view the block. - * */ 'use strict'; diff --git a/demos/blockfactory/factory.js b/demos/blockfactory/factory.js index 6acdbee82..015bcedf5 100644 --- a/demos/blockfactory/factory.js +++ b/demos/blockfactory/factory.js @@ -10,7 +10,6 @@ * generate a preview block and starter code for the block (block definition and * generator stub. Uses the Block Factory namespace. Depends on the FactoryUtils * for its code generation functions. - * */ 'use strict'; diff --git a/demos/blockfactory/standard_categories.js b/demos/blockfactory/standard_categories.js index eefadf2b9..f4289d586 100644 --- a/demos/blockfactory/standard_categories.js +++ b/demos/blockfactory/standard_categories.js @@ -10,7 +10,6 @@ * the lower case name of the category, and contains the Category object for * that particular category. Also has a list of core block types provided * by Blockly. - * */ 'use strict'; diff --git a/demos/blockfactory/workspacefactory/wfactory_controller.js b/demos/blockfactory/workspacefactory/wfactory_controller.js index 73a2a4b41..57afaab65 100644 --- a/demos/blockfactory/workspacefactory/wfactory_controller.js +++ b/demos/blockfactory/workspacefactory/wfactory_controller.js @@ -16,7 +16,6 @@ * - updating the preview workspace * - changing a category name * - moving the position of a category. - * */ /** diff --git a/demos/blockfactory/workspacefactory/wfactory_generator.js b/demos/blockfactory/workspacefactory/wfactory_generator.js index 02a1fa43e..ca1a47b09 100644 --- a/demos/blockfactory/workspacefactory/wfactory_generator.js +++ b/demos/blockfactory/workspacefactory/wfactory_generator.js @@ -10,7 +10,6 @@ * Blockly.Xml and depends on information in the model (holds a reference). * Depends on a hidden workspace created in the generator to load saved XML in * order to generate toolbox XML. - * */ diff --git a/demos/blockfactory/workspacefactory/wfactory_init.js b/demos/blockfactory/workspacefactory/wfactory_init.js index c04f451a9..352c1d220 100644 --- a/demos/blockfactory/workspacefactory/wfactory_init.js +++ b/demos/blockfactory/workspacefactory/wfactory_init.js @@ -9,7 +9,6 @@ * Adds click handlers to buttons and dropdowns, adds event listeners for * keydown events and Blockly events, and configures the initial setup of * the page. - * */ /** diff --git a/demos/blockfactory/workspacefactory/wfactory_model.js b/demos/blockfactory/workspacefactory/wfactory_model.js index 4b871ccf6..9b9586ea1 100644 --- a/demos/blockfactory/workspacefactory/wfactory_model.js +++ b/demos/blockfactory/workspacefactory/wfactory_model.js @@ -12,7 +12,6 @@ * move categories easily. Keeps track of the currently selected list * element. Also keeps track of all the user-created shadow blocks and * manipulates them as necessary. - * */ /** diff --git a/tests/bootstrap.js b/tests/bootstrap.js index d872ab269..01bae8c2b 100644 --- a/tests/bootstrap.js +++ b/tests/bootstrap.js @@ -35,7 +35,6 @@ * The bootstrap code will consult a BLOCKLY_BOOTSTRAP_OPTIONS * global variable to determine what to load. This must be set * before loading this script. See documentation inline below. - * */ 'use strict';