mirror of
https://github.com/google/blockly.git
synced 2025-12-16 06:10:12 +01:00
4ab8d00099
* refactor(generators): Migrate javascript_generator.js to TypeScript * refactor(generators): Simplify getAdjusted Slightly simplify the implementation of getAdjusted, in part to make it more readable. Also improve its JSDoc comment. * refactor(generators): Migrate generators/javascript/* to TypeScript First pass doing very mechanistic migration, not attempting to fix all the resulting type errors. * fix(generators): Fix type errors in generator functions This consists almost entirely of adding casts, so the code output by tsc should be as similar as possible to the pre-migration .js source files. * refactor(generators): Migrate generators/javascript.js to TypeScript The way the generator functions are added to javascriptGenerator.forBlock has been modified so that incorrect generator function signatures will cause tsc to generate a type error. * chore(generator): Format One block protected with // prettier-ignore to preserve careful comment formatting. Where there are repeated concatenations prettier has made a pretty mess of things, but the correct fix is probably to use template literals instead (rather than just locally disabling prettier). This has been added to the to-do list in #7600. * fix(generators): Fixes for PR #7602 * fix(generators): Fix syntax error
1086 lines
34 KiB
TypeScript
1086 lines
34 KiB
TypeScript
/**
|
|
* @license
|
|
* Copyright 2012 Google LLC
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
// Former goog.module ID: Blockly.libraryBlocks.lists
|
|
|
|
import * as fieldRegistry from '../core/field_registry.js';
|
|
import * as xmlUtils from '../core/utils/xml.js';
|
|
import {Align} from '../core/inputs/align.js';
|
|
import type {Block} from '../core/block.js';
|
|
import type {Connection} from '../core/connection.js';
|
|
import type {BlockSvg} from '../core/block_svg.js';
|
|
import type {FieldDropdown} from '../core/field_dropdown.js';
|
|
import {Msg} from '../core/msg.js';
|
|
import {MutatorIcon} from '../core/icons/mutator_icon.js';
|
|
import type {Workspace} from '../core/workspace.js';
|
|
import {
|
|
createBlockDefinitionsFromJsonArray,
|
|
defineBlocks,
|
|
} from '../core/common.js';
|
|
import '../core/field_dropdown.js';
|
|
import {ValueInput} from '../core/inputs/value_input.js';
|
|
|
|
/**
|
|
* A dictionary of the block definitions provided by this module.
|
|
*/
|
|
export const blocks = createBlockDefinitionsFromJsonArray([
|
|
// Block for creating an empty list
|
|
// The 'list_create_with' block is preferred as it is more flexible.
|
|
// <block type="lists_create_with">
|
|
// <mutation items="0"></mutation>
|
|
// </block>
|
|
{
|
|
'type': 'lists_create_empty',
|
|
'message0': '%{BKY_LISTS_CREATE_EMPTY_TITLE}',
|
|
'output': 'Array',
|
|
'style': 'list_blocks',
|
|
'tooltip': '%{BKY_LISTS_CREATE_EMPTY_TOOLTIP}',
|
|
'helpUrl': '%{BKY_LISTS_CREATE_EMPTY_HELPURL}',
|
|
},
|
|
// Block for creating a list with one element repeated.
|
|
{
|
|
'type': 'lists_repeat',
|
|
'message0': '%{BKY_LISTS_REPEAT_TITLE}',
|
|
'args0': [
|
|
{
|
|
'type': 'input_value',
|
|
'name': 'ITEM',
|
|
},
|
|
{
|
|
'type': 'input_value',
|
|
'name': 'NUM',
|
|
'check': 'Number',
|
|
},
|
|
],
|
|
'output': 'Array',
|
|
'style': 'list_blocks',
|
|
'tooltip': '%{BKY_LISTS_REPEAT_TOOLTIP}',
|
|
'helpUrl': '%{BKY_LISTS_REPEAT_HELPURL}',
|
|
},
|
|
// Block for reversing a list.
|
|
{
|
|
'type': 'lists_reverse',
|
|
'message0': '%{BKY_LISTS_REVERSE_MESSAGE0}',
|
|
'args0': [
|
|
{
|
|
'type': 'input_value',
|
|
'name': 'LIST',
|
|
'check': 'Array',
|
|
},
|
|
],
|
|
'output': 'Array',
|
|
'inputsInline': true,
|
|
'style': 'list_blocks',
|
|
'tooltip': '%{BKY_LISTS_REVERSE_TOOLTIP}',
|
|
'helpUrl': '%{BKY_LISTS_REVERSE_HELPURL}',
|
|
},
|
|
// Block for checking if a list is empty
|
|
{
|
|
'type': 'lists_isEmpty',
|
|
'message0': '%{BKY_LISTS_ISEMPTY_TITLE}',
|
|
'args0': [
|
|
{
|
|
'type': 'input_value',
|
|
'name': 'VALUE',
|
|
'check': ['String', 'Array'],
|
|
},
|
|
],
|
|
'output': 'Boolean',
|
|
'style': 'list_blocks',
|
|
'tooltip': '%{BKY_LISTS_ISEMPTY_TOOLTIP}',
|
|
'helpUrl': '%{BKY_LISTS_ISEMPTY_HELPURL}',
|
|
},
|
|
// Block for getting the list length
|
|
{
|
|
'type': 'lists_length',
|
|
'message0': '%{BKY_LISTS_LENGTH_TITLE}',
|
|
'args0': [
|
|
{
|
|
'type': 'input_value',
|
|
'name': 'VALUE',
|
|
'check': ['String', 'Array'],
|
|
},
|
|
],
|
|
'output': 'Number',
|
|
'style': 'list_blocks',
|
|
'tooltip': '%{BKY_LISTS_LENGTH_TOOLTIP}',
|
|
'helpUrl': '%{BKY_LISTS_LENGTH_HELPURL}',
|
|
},
|
|
]);
|
|
|
|
/**
|
|
* Type of a 'lists_create_with' block.
|
|
*
|
|
* @internal
|
|
*/
|
|
export type CreateWithBlock = Block & ListCreateWithMixin;
|
|
interface ListCreateWithMixin extends ListCreateWithMixinType {
|
|
itemCount_: number;
|
|
}
|
|
type ListCreateWithMixinType = typeof LISTS_CREATE_WITH;
|
|
|
|
const LISTS_CREATE_WITH = {
|
|
/**
|
|
* Block for creating a list with any number of elements of any type.
|
|
*/
|
|
init: function (this: CreateWithBlock) {
|
|
this.setHelpUrl(Msg['LISTS_CREATE_WITH_HELPURL']);
|
|
this.setStyle('list_blocks');
|
|
this.itemCount_ = 3;
|
|
this.updateShape_();
|
|
this.setOutput(true, 'Array');
|
|
this.setMutator(
|
|
new MutatorIcon(['lists_create_with_item'], this as unknown as BlockSvg),
|
|
); // BUG(#6905)
|
|
this.setTooltip(Msg['LISTS_CREATE_WITH_TOOLTIP']);
|
|
},
|
|
/**
|
|
* Create XML to represent list inputs.
|
|
* Backwards compatible serialization implementation.
|
|
*/
|
|
mutationToDom: function (this: CreateWithBlock): Element {
|
|
const container = xmlUtils.createElement('mutation');
|
|
container.setAttribute('items', String(this.itemCount_));
|
|
return container;
|
|
},
|
|
/**
|
|
* Parse XML to restore the list inputs.
|
|
* Backwards compatible serialization implementation.
|
|
*
|
|
* @param xmlElement XML storage element.
|
|
*/
|
|
domToMutation: function (this: CreateWithBlock, xmlElement: Element) {
|
|
const items = xmlElement.getAttribute('items');
|
|
if (!items) throw new TypeError('element did not have items');
|
|
this.itemCount_ = parseInt(items, 10);
|
|
this.updateShape_();
|
|
},
|
|
/**
|
|
* Returns the state of this block as a JSON serializable object.
|
|
*
|
|
* @returns The state of this block, ie the item count.
|
|
*/
|
|
saveExtraState: function (this: CreateWithBlock): {itemCount: number} {
|
|
return {
|
|
'itemCount': this.itemCount_,
|
|
};
|
|
},
|
|
/**
|
|
* Applies the given state to this block.
|
|
*
|
|
* @param state The state to apply to this block, ie the item count.
|
|
*/
|
|
loadExtraState: function (this: CreateWithBlock, state: AnyDuringMigration) {
|
|
this.itemCount_ = state['itemCount'];
|
|
this.updateShape_();
|
|
},
|
|
/**
|
|
* Populate the mutator's dialog with this block's components.
|
|
*
|
|
* @param workspace Mutator's workspace.
|
|
* @returns Root block in mutator.
|
|
*/
|
|
decompose: function (
|
|
this: CreateWithBlock,
|
|
workspace: Workspace,
|
|
): ContainerBlock {
|
|
const containerBlock = workspace.newBlock(
|
|
'lists_create_with_container',
|
|
) as ContainerBlock;
|
|
(containerBlock as BlockSvg).initSvg();
|
|
let connection = containerBlock.getInput('STACK')!.connection;
|
|
for (let i = 0; i < this.itemCount_; i++) {
|
|
const itemBlock = workspace.newBlock(
|
|
'lists_create_with_item',
|
|
) as ItemBlock;
|
|
(itemBlock as BlockSvg).initSvg();
|
|
if (!itemBlock.previousConnection) {
|
|
throw new Error('itemBlock has no previousConnection');
|
|
}
|
|
connection!.connect(itemBlock.previousConnection);
|
|
connection = itemBlock.nextConnection;
|
|
}
|
|
return containerBlock;
|
|
},
|
|
/**
|
|
* Reconfigure this block based on the mutator dialog's components.
|
|
*
|
|
* @param containerBlock Root block in mutator.
|
|
*/
|
|
compose: function (this: CreateWithBlock, containerBlock: Block) {
|
|
let itemBlock: ItemBlock | null = containerBlock.getInputTargetBlock(
|
|
'STACK',
|
|
) as ItemBlock;
|
|
// Count number of inputs.
|
|
const connections: Connection[] = [];
|
|
while (itemBlock) {
|
|
if (itemBlock.isInsertionMarker()) {
|
|
itemBlock = itemBlock.getNextBlock() as ItemBlock | null;
|
|
continue;
|
|
}
|
|
connections.push(itemBlock.valueConnection_ as Connection);
|
|
itemBlock = itemBlock.getNextBlock() as ItemBlock | null;
|
|
}
|
|
// Disconnect any children that don't belong.
|
|
for (let i = 0; i < this.itemCount_; i++) {
|
|
const connection = this.getInput('ADD' + i)!.connection!.targetConnection;
|
|
if (connection && connections.indexOf(connection) === -1) {
|
|
connection.disconnect();
|
|
}
|
|
}
|
|
this.itemCount_ = connections.length;
|
|
this.updateShape_();
|
|
// Reconnect any child blocks.
|
|
for (let i = 0; i < this.itemCount_; i++) {
|
|
connections[i]?.reconnect(this, 'ADD' + i);
|
|
}
|
|
},
|
|
/**
|
|
* Store pointers to any connected child blocks.
|
|
*
|
|
* @param containerBlock Root block in mutator.
|
|
*/
|
|
saveConnections: function (this: CreateWithBlock, containerBlock: Block) {
|
|
let itemBlock: ItemBlock | null = containerBlock.getInputTargetBlock(
|
|
'STACK',
|
|
) as ItemBlock;
|
|
let i = 0;
|
|
while (itemBlock) {
|
|
if (itemBlock.isInsertionMarker()) {
|
|
itemBlock = itemBlock.getNextBlock() as ItemBlock | null;
|
|
continue;
|
|
}
|
|
const input = this.getInput('ADD' + i);
|
|
itemBlock.valueConnection_ = input?.connection!
|
|
.targetConnection as Connection;
|
|
itemBlock = itemBlock.getNextBlock() as ItemBlock | null;
|
|
i++;
|
|
}
|
|
},
|
|
/**
|
|
* Modify this block to have the correct number of inputs.
|
|
*/
|
|
updateShape_: function (this: CreateWithBlock) {
|
|
if (this.itemCount_ && this.getInput('EMPTY')) {
|
|
this.removeInput('EMPTY');
|
|
} else if (!this.itemCount_ && !this.getInput('EMPTY')) {
|
|
this.appendDummyInput('EMPTY').appendField(
|
|
Msg['LISTS_CREATE_EMPTY_TITLE'],
|
|
);
|
|
}
|
|
// Add new inputs.
|
|
for (let i = 0; i < this.itemCount_; i++) {
|
|
if (!this.getInput('ADD' + i)) {
|
|
const input = this.appendValueInput('ADD' + i).setAlign(Align.RIGHT);
|
|
if (i === 0) {
|
|
input.appendField(Msg['LISTS_CREATE_WITH_INPUT_WITH']);
|
|
}
|
|
}
|
|
}
|
|
// Remove deleted inputs.
|
|
for (let i = this.itemCount_; this.getInput('ADD' + i); i++) {
|
|
this.removeInput('ADD' + i);
|
|
}
|
|
},
|
|
};
|
|
blocks['lists_create_with'] = LISTS_CREATE_WITH;
|
|
|
|
/** Type for a 'lists_create_with_container' block. */
|
|
type ContainerBlock = Block & ContainerMutator;
|
|
interface ContainerMutator extends ContainerMutatorType {}
|
|
type ContainerMutatorType = typeof LISTS_CREATE_WITH_CONTAINER;
|
|
|
|
const LISTS_CREATE_WITH_CONTAINER = {
|
|
/**
|
|
* Mutator block for list container.
|
|
*/
|
|
init: function (this: ContainerBlock) {
|
|
this.setStyle('list_blocks');
|
|
this.appendDummyInput().appendField(
|
|
Msg['LISTS_CREATE_WITH_CONTAINER_TITLE_ADD'],
|
|
);
|
|
this.appendStatementInput('STACK');
|
|
this.setTooltip(Msg['LISTS_CREATE_WITH_CONTAINER_TOOLTIP']);
|
|
this.contextMenu = false;
|
|
},
|
|
};
|
|
blocks['lists_create_with_container'] = LISTS_CREATE_WITH_CONTAINER;
|
|
|
|
/** Type for a 'lists_create_with_item' block. */
|
|
type ItemBlock = Block & ItemMutator;
|
|
interface ItemMutator extends ItemMutatorType {
|
|
valueConnection_?: Connection;
|
|
}
|
|
type ItemMutatorType = typeof LISTS_CREATE_WITH_ITEM;
|
|
|
|
const LISTS_CREATE_WITH_ITEM = {
|
|
/**
|
|
* Mutator block for adding items.
|
|
*/
|
|
init: function (this: ItemBlock) {
|
|
this.setStyle('list_blocks');
|
|
this.appendDummyInput().appendField(Msg['LISTS_CREATE_WITH_ITEM_TITLE']);
|
|
this.setPreviousStatement(true);
|
|
this.setNextStatement(true);
|
|
this.setTooltip(Msg['LISTS_CREATE_WITH_ITEM_TOOLTIP']);
|
|
this.contextMenu = false;
|
|
},
|
|
};
|
|
blocks['lists_create_with_item'] = LISTS_CREATE_WITH_ITEM;
|
|
|
|
/** Type for a 'lists_indexOf' block. */
|
|
type IndexOfBlock = Block & IndexOfMutator;
|
|
interface IndexOfMutator extends IndexOfMutatorType {}
|
|
type IndexOfMutatorType = typeof LISTS_INDEXOF;
|
|
|
|
const LISTS_INDEXOF = {
|
|
/**
|
|
* Block for finding an item in the list.
|
|
*/
|
|
init: function (this: IndexOfBlock) {
|
|
const OPERATORS = [
|
|
[Msg['LISTS_INDEX_OF_FIRST'], 'FIRST'],
|
|
[Msg['LISTS_INDEX_OF_LAST'], 'LAST'],
|
|
];
|
|
this.setHelpUrl(Msg['LISTS_INDEX_OF_HELPURL']);
|
|
this.setStyle('list_blocks');
|
|
this.setOutput(true, 'Number');
|
|
this.appendValueInput('VALUE')
|
|
.setCheck('Array')
|
|
.appendField(Msg['LISTS_INDEX_OF_INPUT_IN_LIST']);
|
|
const operatorsDropdown = fieldRegistry.fromJson({
|
|
type: 'field_dropdown',
|
|
options: OPERATORS,
|
|
});
|
|
if (!operatorsDropdown) throw new Error('field_dropdown not found');
|
|
this.appendValueInput('FIND').appendField(operatorsDropdown, 'END');
|
|
this.setInputsInline(true);
|
|
this.setTooltip(() => {
|
|
return Msg['LISTS_INDEX_OF_TOOLTIP'].replace(
|
|
'%1',
|
|
this.workspace.options.oneBasedIndex ? '0' : '-1',
|
|
);
|
|
});
|
|
},
|
|
};
|
|
blocks['lists_indexOf'] = LISTS_INDEXOF;
|
|
|
|
/** Type for a 'lists_getIndex' block. */
|
|
type GetIndexBlock = Block & GetIndexMutator;
|
|
interface GetIndexMutator extends GetIndexMutatorType {
|
|
WHERE_OPTIONS: Array<[string, string]>;
|
|
}
|
|
type GetIndexMutatorType = typeof LISTS_GETINDEX;
|
|
|
|
const LISTS_GETINDEX = {
|
|
/**
|
|
* Block for getting element at index.
|
|
*/
|
|
init: function (this: GetIndexBlock) {
|
|
const MODE = [
|
|
[Msg['LISTS_GET_INDEX_GET'], 'GET'],
|
|
[Msg['LISTS_GET_INDEX_GET_REMOVE'], 'GET_REMOVE'],
|
|
[Msg['LISTS_GET_INDEX_REMOVE'], 'REMOVE'],
|
|
];
|
|
this.WHERE_OPTIONS = [
|
|
[Msg['LISTS_GET_INDEX_FROM_START'], 'FROM_START'],
|
|
[Msg['LISTS_GET_INDEX_FROM_END'], 'FROM_END'],
|
|
[Msg['LISTS_GET_INDEX_FIRST'], 'FIRST'],
|
|
[Msg['LISTS_GET_INDEX_LAST'], 'LAST'],
|
|
[Msg['LISTS_GET_INDEX_RANDOM'], 'RANDOM'],
|
|
];
|
|
this.setHelpUrl(Msg['LISTS_GET_INDEX_HELPURL']);
|
|
this.setStyle('list_blocks');
|
|
const modeMenu = fieldRegistry.fromJson({
|
|
type: 'field_dropdown',
|
|
options: MODE,
|
|
}) as FieldDropdown;
|
|
modeMenu.setValidator(
|
|
/** @param value The input value. */
|
|
function (this: FieldDropdown, value: string) {
|
|
const isStatement = value === 'REMOVE';
|
|
(this.getSourceBlock() as GetIndexBlock).updateStatement_(isStatement);
|
|
return undefined;
|
|
},
|
|
);
|
|
this.appendValueInput('VALUE')
|
|
.setCheck('Array')
|
|
.appendField(Msg['LISTS_GET_INDEX_INPUT_IN_LIST']);
|
|
this.appendDummyInput()
|
|
.appendField(modeMenu, 'MODE')
|
|
.appendField('', 'SPACE');
|
|
this.appendDummyInput('AT');
|
|
if (Msg['LISTS_GET_INDEX_TAIL']) {
|
|
this.appendDummyInput('TAIL').appendField(Msg['LISTS_GET_INDEX_TAIL']);
|
|
}
|
|
this.setInputsInline(true);
|
|
this.setOutput(true);
|
|
this.updateAt_(true);
|
|
this.setTooltip(() => {
|
|
const mode = this.getFieldValue('MODE');
|
|
const where = this.getFieldValue('WHERE');
|
|
let tooltip = '';
|
|
switch (mode + ' ' + where) {
|
|
case 'GET FROM_START':
|
|
case 'GET FROM_END':
|
|
tooltip = Msg['LISTS_GET_INDEX_TOOLTIP_GET_FROM'];
|
|
break;
|
|
case 'GET FIRST':
|
|
tooltip = Msg['LISTS_GET_INDEX_TOOLTIP_GET_FIRST'];
|
|
break;
|
|
case 'GET LAST':
|
|
tooltip = Msg['LISTS_GET_INDEX_TOOLTIP_GET_LAST'];
|
|
break;
|
|
case 'GET RANDOM':
|
|
tooltip = Msg['LISTS_GET_INDEX_TOOLTIP_GET_RANDOM'];
|
|
break;
|
|
case 'GET_REMOVE FROM_START':
|
|
case 'GET_REMOVE FROM_END':
|
|
tooltip = Msg['LISTS_GET_INDEX_TOOLTIP_GET_REMOVE_FROM'];
|
|
break;
|
|
case 'GET_REMOVE FIRST':
|
|
tooltip = Msg['LISTS_GET_INDEX_TOOLTIP_GET_REMOVE_FIRST'];
|
|
break;
|
|
case 'GET_REMOVE LAST':
|
|
tooltip = Msg['LISTS_GET_INDEX_TOOLTIP_GET_REMOVE_LAST'];
|
|
break;
|
|
case 'GET_REMOVE RANDOM':
|
|
tooltip = Msg['LISTS_GET_INDEX_TOOLTIP_GET_REMOVE_RANDOM'];
|
|
break;
|
|
case 'REMOVE FROM_START':
|
|
case 'REMOVE FROM_END':
|
|
tooltip = Msg['LISTS_GET_INDEX_TOOLTIP_REMOVE_FROM'];
|
|
break;
|
|
case 'REMOVE FIRST':
|
|
tooltip = Msg['LISTS_GET_INDEX_TOOLTIP_REMOVE_FIRST'];
|
|
break;
|
|
case 'REMOVE LAST':
|
|
tooltip = Msg['LISTS_GET_INDEX_TOOLTIP_REMOVE_LAST'];
|
|
break;
|
|
case 'REMOVE RANDOM':
|
|
tooltip = Msg['LISTS_GET_INDEX_TOOLTIP_REMOVE_RANDOM'];
|
|
break;
|
|
}
|
|
if (where === 'FROM_START' || where === 'FROM_END') {
|
|
const msg =
|
|
where === 'FROM_START'
|
|
? Msg['LISTS_INDEX_FROM_START_TOOLTIP']
|
|
: Msg['LISTS_INDEX_FROM_END_TOOLTIP'];
|
|
tooltip +=
|
|
' ' +
|
|
msg.replace('%1', this.workspace.options.oneBasedIndex ? '#1' : '#0');
|
|
}
|
|
return tooltip;
|
|
});
|
|
},
|
|
/**
|
|
* Create XML to represent whether the block is a statement or a value.
|
|
* Also represent whether there is an 'AT' input.
|
|
*
|
|
* @returns XML storage element.
|
|
*/
|
|
mutationToDom: function (this: GetIndexBlock): Element {
|
|
const container = xmlUtils.createElement('mutation');
|
|
const isStatement = !this.outputConnection;
|
|
container.setAttribute('statement', String(isStatement));
|
|
const isAt = this.getInput('AT') instanceof ValueInput;
|
|
container.setAttribute('at', String(isAt));
|
|
return container;
|
|
},
|
|
/**
|
|
* Parse XML to restore the 'AT' input.
|
|
*
|
|
* @param xmlElement XML storage element.
|
|
*/
|
|
domToMutation: function (this: GetIndexBlock, xmlElement: Element) {
|
|
// Note: Until January 2013 this block did not have mutations,
|
|
// so 'statement' defaults to false and 'at' defaults to true.
|
|
const isStatement = xmlElement.getAttribute('statement') === 'true';
|
|
this.updateStatement_(isStatement);
|
|
const isAt = xmlElement.getAttribute('at') !== 'false';
|
|
this.updateAt_(isAt);
|
|
},
|
|
/**
|
|
* Returns the state of this block as a JSON serializable object.
|
|
* Returns null for efficiency if no state is needed (not a statement)
|
|
*
|
|
* @returns The state of this block, ie whether it's a statement.
|
|
*/
|
|
saveExtraState: function (this: GetIndexBlock): {
|
|
isStatement: boolean;
|
|
} | null {
|
|
if (!this.outputConnection) {
|
|
return {
|
|
isStatement: true,
|
|
};
|
|
}
|
|
return null;
|
|
},
|
|
|
|
/**
|
|
* Applies the given state to this block.
|
|
*
|
|
* @param state The state to apply to this block, ie whether it's a
|
|
* statement.
|
|
*/
|
|
loadExtraState: function (this: GetIndexBlock, state: AnyDuringMigration) {
|
|
if (state['isStatement']) {
|
|
this.updateStatement_(true);
|
|
} else if (typeof state === 'string') {
|
|
// backward compatible for json serialised mutations
|
|
this.domToMutation(xmlUtils.textToDom(state));
|
|
}
|
|
},
|
|
|
|
/**
|
|
* Switch between a value block and a statement block.
|
|
*
|
|
* @param newStatement True if the block should be a statement.
|
|
* False if the block should be a value.
|
|
*/
|
|
updateStatement_: function (this: GetIndexBlock, newStatement: boolean) {
|
|
const oldStatement = !this.outputConnection;
|
|
if (newStatement !== oldStatement) {
|
|
// TODO(#6920): The .unplug only has one parameter.
|
|
(this.unplug as (arg0?: boolean, arg1?: boolean) => void)(true, true);
|
|
if (newStatement) {
|
|
this.setOutput(false);
|
|
this.setPreviousStatement(true);
|
|
this.setNextStatement(true);
|
|
} else {
|
|
this.setPreviousStatement(false);
|
|
this.setNextStatement(false);
|
|
this.setOutput(true);
|
|
}
|
|
}
|
|
},
|
|
/**
|
|
* Create or delete an input for the numeric index.
|
|
*
|
|
* @param isAt True if the input should exist.
|
|
*/
|
|
updateAt_: function (this: GetIndexBlock, isAt: boolean) {
|
|
// Destroy old 'AT' and 'ORDINAL' inputs.
|
|
this.removeInput('AT');
|
|
this.removeInput('ORDINAL', true);
|
|
// Create either a value 'AT' input or a dummy input.
|
|
if (isAt) {
|
|
this.appendValueInput('AT').setCheck('Number');
|
|
if (Msg['ORDINAL_NUMBER_SUFFIX']) {
|
|
this.appendDummyInput('ORDINAL').appendField(
|
|
Msg['ORDINAL_NUMBER_SUFFIX'],
|
|
);
|
|
}
|
|
} else {
|
|
this.appendDummyInput('AT');
|
|
}
|
|
const menu = fieldRegistry.fromJson({
|
|
type: 'field_dropdown',
|
|
options: this.WHERE_OPTIONS,
|
|
}) as FieldDropdown;
|
|
menu.setValidator(
|
|
/**
|
|
* @param value The input value.
|
|
* @returns Null if the field has been replaced; otherwise undefined.
|
|
*/
|
|
function (this: FieldDropdown, value: string) {
|
|
const newAt = value === 'FROM_START' || value === 'FROM_END';
|
|
// The 'isAt' variable is available due to this function being a
|
|
// closure.
|
|
if (newAt !== isAt) {
|
|
const block = this.getSourceBlock() as GetIndexBlock;
|
|
block.updateAt_(newAt);
|
|
// This menu has been destroyed and replaced. Update the
|
|
// replacement.
|
|
block.setFieldValue(value, 'WHERE');
|
|
return null;
|
|
}
|
|
return undefined;
|
|
},
|
|
);
|
|
this.getInput('AT')!.appendField(menu, 'WHERE');
|
|
if (Msg['LISTS_GET_INDEX_TAIL']) {
|
|
this.moveInputBefore('TAIL', null);
|
|
}
|
|
},
|
|
};
|
|
blocks['lists_getIndex'] = LISTS_GETINDEX;
|
|
|
|
/** Type for a 'lists_setIndex' block. */
|
|
type SetIndexBlock = Block & SetIndexMutator;
|
|
interface SetIndexMutator extends SetIndexMutatorType {
|
|
WHERE_OPTIONS: Array<[string, string]>;
|
|
}
|
|
type SetIndexMutatorType = typeof LISTS_SETINDEX;
|
|
|
|
const LISTS_SETINDEX = {
|
|
/**
|
|
* Block for setting the element at index.
|
|
*/
|
|
init: function (this: SetIndexBlock) {
|
|
const MODE = [
|
|
[Msg['LISTS_SET_INDEX_SET'], 'SET'],
|
|
[Msg['LISTS_SET_INDEX_INSERT'], 'INSERT'],
|
|
];
|
|
this.WHERE_OPTIONS = [
|
|
[Msg['LISTS_GET_INDEX_FROM_START'], 'FROM_START'],
|
|
[Msg['LISTS_GET_INDEX_FROM_END'], 'FROM_END'],
|
|
[Msg['LISTS_GET_INDEX_FIRST'], 'FIRST'],
|
|
[Msg['LISTS_GET_INDEX_LAST'], 'LAST'],
|
|
[Msg['LISTS_GET_INDEX_RANDOM'], 'RANDOM'],
|
|
];
|
|
this.setHelpUrl(Msg['LISTS_SET_INDEX_HELPURL']);
|
|
this.setStyle('list_blocks');
|
|
this.appendValueInput('LIST')
|
|
.setCheck('Array')
|
|
.appendField(Msg['LISTS_SET_INDEX_INPUT_IN_LIST']);
|
|
const operationDropdown = fieldRegistry.fromJson({
|
|
type: 'field_dropdown',
|
|
options: MODE,
|
|
}) as FieldDropdown;
|
|
this.appendDummyInput()
|
|
.appendField(operationDropdown, 'MODE')
|
|
.appendField('', 'SPACE');
|
|
this.appendDummyInput('AT');
|
|
this.appendValueInput('TO').appendField(Msg['LISTS_SET_INDEX_INPUT_TO']);
|
|
this.setInputsInline(true);
|
|
this.setPreviousStatement(true);
|
|
this.setNextStatement(true);
|
|
this.setTooltip(Msg['LISTS_SET_INDEX_TOOLTIP']);
|
|
this.updateAt_(true);
|
|
this.setTooltip(() => {
|
|
const mode = this.getFieldValue('MODE');
|
|
const where = this.getFieldValue('WHERE');
|
|
let tooltip = '';
|
|
switch (mode + ' ' + where) {
|
|
case 'SET FROM_START':
|
|
case 'SET FROM_END':
|
|
tooltip = Msg['LISTS_SET_INDEX_TOOLTIP_SET_FROM'];
|
|
break;
|
|
case 'SET FIRST':
|
|
tooltip = Msg['LISTS_SET_INDEX_TOOLTIP_SET_FIRST'];
|
|
break;
|
|
case 'SET LAST':
|
|
tooltip = Msg['LISTS_SET_INDEX_TOOLTIP_SET_LAST'];
|
|
break;
|
|
case 'SET RANDOM':
|
|
tooltip = Msg['LISTS_SET_INDEX_TOOLTIP_SET_RANDOM'];
|
|
break;
|
|
case 'INSERT FROM_START':
|
|
case 'INSERT FROM_END':
|
|
tooltip = Msg['LISTS_SET_INDEX_TOOLTIP_INSERT_FROM'];
|
|
break;
|
|
case 'INSERT FIRST':
|
|
tooltip = Msg['LISTS_SET_INDEX_TOOLTIP_INSERT_FIRST'];
|
|
break;
|
|
case 'INSERT LAST':
|
|
tooltip = Msg['LISTS_SET_INDEX_TOOLTIP_INSERT_LAST'];
|
|
break;
|
|
case 'INSERT RANDOM':
|
|
tooltip = Msg['LISTS_SET_INDEX_TOOLTIP_INSERT_RANDOM'];
|
|
break;
|
|
}
|
|
if (where === 'FROM_START' || where === 'FROM_END') {
|
|
tooltip +=
|
|
' ' +
|
|
Msg['LISTS_INDEX_FROM_START_TOOLTIP'].replace(
|
|
'%1',
|
|
this.workspace.options.oneBasedIndex ? '#1' : '#0',
|
|
);
|
|
}
|
|
return tooltip;
|
|
});
|
|
},
|
|
/**
|
|
* Create XML to represent whether there is an 'AT' input.
|
|
*
|
|
* @returns XML storage element.
|
|
*/
|
|
mutationToDom: function (this: SetIndexBlock): Element {
|
|
const container = xmlUtils.createElement('mutation');
|
|
const isAt = this.getInput('AT') instanceof ValueInput;
|
|
container.setAttribute('at', String(isAt));
|
|
return container;
|
|
},
|
|
/**
|
|
* Parse XML to restore the 'AT' input.
|
|
*
|
|
* @param xmlElement XML storage element.
|
|
*/
|
|
domToMutation: function (this: SetIndexBlock, xmlElement: Element) {
|
|
// Note: Until January 2013 this block did not have mutations,
|
|
// so 'at' defaults to true.
|
|
const isAt = xmlElement.getAttribute('at') !== 'false';
|
|
this.updateAt_(isAt);
|
|
},
|
|
|
|
/**
|
|
* Returns the state of this block as a JSON serializable object.
|
|
* This block does not need to serialize any specific state as it is already
|
|
* encoded in the dropdown values, but must have an implementation to avoid
|
|
* the backward compatible XML mutations being serialized.
|
|
*
|
|
* @returns The state of this block.
|
|
*/
|
|
saveExtraState: function (this: SetIndexBlock): null {
|
|
return null;
|
|
},
|
|
|
|
/**
|
|
* Applies the given state to this block.
|
|
* No extra state is needed or expected as it is already encoded in the
|
|
* dropdown values.
|
|
*/
|
|
loadExtraState: function (this: SetIndexBlock) {},
|
|
|
|
/**
|
|
* Create or delete an input for the numeric index.
|
|
*
|
|
* @param isAt True if the input should exist.
|
|
*/
|
|
updateAt_: function (this: SetIndexBlock, isAt: boolean) {
|
|
// Destroy old 'AT' and 'ORDINAL' input.
|
|
this.removeInput('AT');
|
|
this.removeInput('ORDINAL', true);
|
|
// Create either a value 'AT' input or a dummy input.
|
|
if (isAt) {
|
|
this.appendValueInput('AT').setCheck('Number');
|
|
if (Msg['ORDINAL_NUMBER_SUFFIX']) {
|
|
this.appendDummyInput('ORDINAL').appendField(
|
|
Msg['ORDINAL_NUMBER_SUFFIX'],
|
|
);
|
|
}
|
|
} else {
|
|
this.appendDummyInput('AT');
|
|
}
|
|
const menu = fieldRegistry.fromJson({
|
|
type: 'field_dropdown',
|
|
options: this.WHERE_OPTIONS,
|
|
}) as FieldDropdown;
|
|
menu.setValidator(
|
|
/**
|
|
* @param value The input value.
|
|
* @returns Null if the field has been replaced; otherwise undefined.
|
|
*/
|
|
function (this: FieldDropdown, value: string) {
|
|
const newAt = value === 'FROM_START' || value === 'FROM_END';
|
|
// The 'isAt' variable is available due to this function being a
|
|
// closure.
|
|
if (newAt !== isAt) {
|
|
const block = this.getSourceBlock() as SetIndexBlock;
|
|
block.updateAt_(newAt);
|
|
// This menu has been destroyed and replaced. Update the
|
|
// replacement.
|
|
block.setFieldValue(value, 'WHERE');
|
|
return null;
|
|
}
|
|
return undefined;
|
|
},
|
|
);
|
|
this.moveInputBefore('AT', 'TO');
|
|
if (this.getInput('ORDINAL')) {
|
|
this.moveInputBefore('ORDINAL', 'TO');
|
|
}
|
|
|
|
this.getInput('AT')!.appendField(menu, 'WHERE');
|
|
},
|
|
};
|
|
blocks['lists_setIndex'] = LISTS_SETINDEX;
|
|
|
|
/** Type for a 'lists_getSublist' block. */
|
|
type GetSublistBlock = Block & GetSublistMutator;
|
|
interface GetSublistMutator extends GetSublistMutatorType {
|
|
WHERE_OPTIONS_1: Array<[string, string]>;
|
|
WHERE_OPTIONS_2: Array<[string, string]>;
|
|
}
|
|
type GetSublistMutatorType = typeof LISTS_GETSUBLIST;
|
|
|
|
const LISTS_GETSUBLIST = {
|
|
/**
|
|
* Block for getting sublist.
|
|
*/
|
|
init: function (this: GetSublistBlock) {
|
|
this['WHERE_OPTIONS_1'] = [
|
|
[Msg['LISTS_GET_SUBLIST_START_FROM_START'], 'FROM_START'],
|
|
[Msg['LISTS_GET_SUBLIST_START_FROM_END'], 'FROM_END'],
|
|
[Msg['LISTS_GET_SUBLIST_START_FIRST'], 'FIRST'],
|
|
];
|
|
this['WHERE_OPTIONS_2'] = [
|
|
[Msg['LISTS_GET_SUBLIST_END_FROM_START'], 'FROM_START'],
|
|
[Msg['LISTS_GET_SUBLIST_END_FROM_END'], 'FROM_END'],
|
|
[Msg['LISTS_GET_SUBLIST_END_LAST'], 'LAST'],
|
|
];
|
|
this.setHelpUrl(Msg['LISTS_GET_SUBLIST_HELPURL']);
|
|
this.setStyle('list_blocks');
|
|
this.appendValueInput('LIST')
|
|
.setCheck('Array')
|
|
.appendField(Msg['LISTS_GET_SUBLIST_INPUT_IN_LIST']);
|
|
this.appendDummyInput('AT1');
|
|
this.appendDummyInput('AT2');
|
|
if (Msg['LISTS_GET_SUBLIST_TAIL']) {
|
|
this.appendDummyInput('TAIL').appendField(Msg['LISTS_GET_SUBLIST_TAIL']);
|
|
}
|
|
this.setInputsInline(true);
|
|
this.setOutput(true, 'Array');
|
|
this.updateAt_(1, true);
|
|
this.updateAt_(2, true);
|
|
this.setTooltip(Msg['LISTS_GET_SUBLIST_TOOLTIP']);
|
|
},
|
|
/**
|
|
* Create XML to represent whether there are 'AT' inputs.
|
|
*
|
|
* @returns XML storage element.
|
|
*/
|
|
mutationToDom: function (this: GetSublistBlock): Element {
|
|
const container = xmlUtils.createElement('mutation');
|
|
const isAt1 = this.getInput('AT1') instanceof ValueInput;
|
|
container.setAttribute('at1', String(isAt1));
|
|
const isAt2 = this.getInput('AT2') instanceof ValueInput;
|
|
container.setAttribute('at2', String(isAt2));
|
|
return container;
|
|
},
|
|
/**
|
|
* Parse XML to restore the 'AT' inputs.
|
|
*
|
|
* @param xmlElement XML storage element.
|
|
*/
|
|
domToMutation: function (this: GetSublistBlock, xmlElement: Element) {
|
|
const isAt1 = xmlElement.getAttribute('at1') === 'true';
|
|
const isAt2 = xmlElement.getAttribute('at2') === 'true';
|
|
this.updateAt_(1, isAt1);
|
|
this.updateAt_(2, isAt2);
|
|
},
|
|
|
|
/**
|
|
* Returns the state of this block as a JSON serializable object.
|
|
* This block does not need to serialize any specific state as it is already
|
|
* encoded in the dropdown values, but must have an implementation to avoid
|
|
* the backward compatible XML mutations being serialized.
|
|
*
|
|
* @returns The state of this block.
|
|
*/
|
|
saveExtraState: function (this: GetSublistBlock): null {
|
|
return null;
|
|
},
|
|
|
|
/**
|
|
* Applies the given state to this block.
|
|
* No extra state is needed or expected as it is already encoded in the
|
|
* dropdown values.
|
|
*/
|
|
loadExtraState: function (this: GetSublistBlock) {},
|
|
|
|
/**
|
|
* Create or delete an input for a numeric index.
|
|
* This block has two such inputs, independent of each other.
|
|
*
|
|
* @param n Specify first or second input (1 or 2).
|
|
* @param isAt True if the input should exist.
|
|
*/
|
|
updateAt_: function (this: GetSublistBlock, n: 1 | 2, isAt: boolean) {
|
|
// Create or delete an input for the numeric index.
|
|
// Destroy old 'AT' and 'ORDINAL' inputs.
|
|
this.removeInput('AT' + n);
|
|
this.removeInput('ORDINAL' + n, true);
|
|
// Create either a value 'AT' input or a dummy input.
|
|
if (isAt) {
|
|
this.appendValueInput('AT' + n).setCheck('Number');
|
|
if (Msg['ORDINAL_NUMBER_SUFFIX']) {
|
|
this.appendDummyInput('ORDINAL' + n).appendField(
|
|
Msg['ORDINAL_NUMBER_SUFFIX'],
|
|
);
|
|
}
|
|
} else {
|
|
this.appendDummyInput('AT' + n);
|
|
}
|
|
const menu = fieldRegistry.fromJson({
|
|
type: 'field_dropdown',
|
|
options:
|
|
this[('WHERE_OPTIONS_' + n) as 'WHERE_OPTIONS_1' | 'WHERE_OPTIONS_2'],
|
|
}) as FieldDropdown;
|
|
menu.setValidator(
|
|
/**
|
|
* @param value The input value.
|
|
* @returns Null if the field has been replaced; otherwise undefined.
|
|
*/
|
|
function (this: FieldDropdown, value: string) {
|
|
const newAt = value === 'FROM_START' || value === 'FROM_END';
|
|
// The 'isAt' variable is available due to this function being a
|
|
// closure.
|
|
if (newAt !== isAt) {
|
|
const block = this.getSourceBlock() as GetSublistBlock;
|
|
block.updateAt_(n, newAt);
|
|
// This menu has been destroyed and replaced.
|
|
// Update the replacement.
|
|
block.setFieldValue(value, 'WHERE' + n);
|
|
return null;
|
|
}
|
|
},
|
|
);
|
|
this.getInput('AT' + n)!.appendField(menu, 'WHERE' + n);
|
|
if (n === 1) {
|
|
this.moveInputBefore('AT1', 'AT2');
|
|
if (this.getInput('ORDINAL1')) {
|
|
this.moveInputBefore('ORDINAL1', 'AT2');
|
|
}
|
|
}
|
|
if (Msg['LISTS_GET_SUBLIST_TAIL']) {
|
|
this.moveInputBefore('TAIL', null);
|
|
}
|
|
},
|
|
};
|
|
blocks['lists_getSublist'] = LISTS_GETSUBLIST;
|
|
|
|
type SortBlock = Block | (typeof blocks)['lists_sort'];
|
|
|
|
blocks['lists_sort'] = {
|
|
/**
|
|
* Block for sorting a list.
|
|
*/
|
|
init: function (this: SortBlock) {
|
|
this.jsonInit({
|
|
'message0': '%{BKY_LISTS_SORT_TITLE}',
|
|
'args0': [
|
|
{
|
|
'type': 'field_dropdown',
|
|
'name': 'TYPE',
|
|
'options': [
|
|
['%{BKY_LISTS_SORT_TYPE_NUMERIC}', 'NUMERIC'],
|
|
['%{BKY_LISTS_SORT_TYPE_TEXT}', 'TEXT'],
|
|
['%{BKY_LISTS_SORT_TYPE_IGNORECASE}', 'IGNORE_CASE'],
|
|
],
|
|
},
|
|
{
|
|
'type': 'field_dropdown',
|
|
'name': 'DIRECTION',
|
|
'options': [
|
|
['%{BKY_LISTS_SORT_ORDER_ASCENDING}', '1'],
|
|
['%{BKY_LISTS_SORT_ORDER_DESCENDING}', '-1'],
|
|
],
|
|
},
|
|
{
|
|
'type': 'input_value',
|
|
'name': 'LIST',
|
|
'check': 'Array',
|
|
},
|
|
],
|
|
'output': 'Array',
|
|
'style': 'list_blocks',
|
|
'tooltip': '%{BKY_LISTS_SORT_TOOLTIP}',
|
|
'helpUrl': '%{BKY_LISTS_SORT_HELPURL}',
|
|
});
|
|
},
|
|
};
|
|
|
|
type SplitBlock = Block | (typeof blocks)['lists_split'];
|
|
|
|
blocks['lists_split'] = {
|
|
/**
|
|
* Block for splitting text into a list, or joining a list into text.
|
|
*/
|
|
init: function (this: SplitBlock) {
|
|
const dropdown = fieldRegistry.fromJson({
|
|
type: 'field_dropdown',
|
|
options: [
|
|
[Msg['LISTS_SPLIT_LIST_FROM_TEXT'], 'SPLIT'],
|
|
[Msg['LISTS_SPLIT_TEXT_FROM_LIST'], 'JOIN'],
|
|
],
|
|
});
|
|
if (!dropdown) throw new Error('field_dropdown not found');
|
|
dropdown.setValidator((newMode) => {
|
|
this.updateType_(newMode);
|
|
});
|
|
this.setHelpUrl(Msg['LISTS_SPLIT_HELPURL']);
|
|
this.setStyle('list_blocks');
|
|
this.appendValueInput('INPUT')
|
|
.setCheck('String')
|
|
.appendField(dropdown, 'MODE');
|
|
this.appendValueInput('DELIM')
|
|
.setCheck('String')
|
|
.appendField(Msg['LISTS_SPLIT_WITH_DELIMITER']);
|
|
this.setInputsInline(true);
|
|
this.setOutput(true, 'Array');
|
|
this.setTooltip(() => {
|
|
const mode = this.getFieldValue('MODE');
|
|
if (mode === 'SPLIT') {
|
|
return Msg['LISTS_SPLIT_TOOLTIP_SPLIT'];
|
|
} else if (mode === 'JOIN') {
|
|
return Msg['LISTS_SPLIT_TOOLTIP_JOIN'];
|
|
}
|
|
throw Error('Unknown mode: ' + mode);
|
|
});
|
|
},
|
|
/**
|
|
* Modify this block to have the correct input and output types.
|
|
*
|
|
* @param newMode Either 'SPLIT' or 'JOIN'.
|
|
*/
|
|
updateType_: function (this: SplitBlock, newMode: string) {
|
|
const mode = this.getFieldValue('MODE');
|
|
if (mode !== newMode) {
|
|
const inputConnection = this.getInput('INPUT')!.connection;
|
|
inputConnection!.setShadowDom(null);
|
|
const inputBlock = inputConnection!.targetBlock();
|
|
// TODO(#6920): This is probably not needed; see details in bug.
|
|
if (inputBlock) {
|
|
inputConnection!.disconnect();
|
|
if (inputBlock.isShadow()) {
|
|
inputBlock.dispose(false);
|
|
} else {
|
|
this.bumpNeighbours();
|
|
}
|
|
}
|
|
}
|
|
if (newMode === 'SPLIT') {
|
|
this.outputConnection!.setCheck('Array');
|
|
this.getInput('INPUT')!.setCheck('String');
|
|
} else {
|
|
this.outputConnection!.setCheck('String');
|
|
this.getInput('INPUT')!.setCheck('Array');
|
|
}
|
|
},
|
|
/**
|
|
* Create XML to represent the input and output types.
|
|
*
|
|
* @returns XML storage element.
|
|
*/
|
|
mutationToDom: function (this: SplitBlock): Element {
|
|
const container = xmlUtils.createElement('mutation');
|
|
container.setAttribute('mode', this.getFieldValue('MODE'));
|
|
return container;
|
|
},
|
|
/**
|
|
* Parse XML to restore the input and output types.
|
|
*
|
|
* @param xmlElement XML storage element.
|
|
*/
|
|
domToMutation: function (this: SplitBlock, xmlElement: Element) {
|
|
this.updateType_(xmlElement.getAttribute('mode'));
|
|
},
|
|
|
|
/**
|
|
* Returns the state of this block as a JSON serializable object.
|
|
* This block does not need to serialize any specific state as it is already
|
|
* encoded in the dropdown values, but must have an implementation to avoid
|
|
* the backward compatible XML mutations being serialized.
|
|
*
|
|
* @returns The state of this block.
|
|
*/
|
|
saveExtraState: function (this: SplitBlock): null {
|
|
return null;
|
|
},
|
|
|
|
/**
|
|
* Applies the given state to this block.
|
|
* No extra state is needed or expected as it is already encoded in the
|
|
* dropdown values.
|
|
*/
|
|
loadExtraState: function (this: SplitBlock) {},
|
|
};
|
|
|
|
// Register provided blocks.
|
|
defineBlocks(blocks);
|