@cp949/phyx-blockly 12.5.1-p1

package/core/field_textinput.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @license
+ * Copyright 2012 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Text input field.
+ *
+ * @class
+ */
+import './events/events_block_change.js';
+import { Field } from './field.js';
+import { FieldInput, FieldInputConfig, FieldInputValidator } from './field_input.js';
+/**
+ * Class for an editable text field.
+ */
+export declare class FieldTextInput extends FieldInput<string> {
+    /**
+     * @param value The initial value of the field. Should cast to a string.
+     *     Defaults to an empty string if null or undefined. Also accepts
+     *     Field.SKIP_SETUP if you wish to skip setup (only used by subclasses
+     *     that want to handle configuration and setting the field value after
+     *     their own constructors have run).
+     * @param validator A function that is called to validate changes to the
+     *     field's value. Takes in a string & returns a validated string, or null
+     *     to abort the change.
+     * @param config A map of options used to configure the field.
+     *     See the [field creation documentation]{@link
+     * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/text-input#creation}
+     * for a list of properties this parameter supports.
+     */
+    constructor(value?: string | typeof Field.SKIP_SETUP, validator?: FieldTextInputValidator | null, config?: FieldTextInputConfig);
+    initView(): void;
+    /**
+     * Ensure that the input value casts to a valid string.
+     *
+     * @param newValue The input value.
+     * @returns A valid string, or null if invalid.
+     */
+    protected doClassValidation_(newValue?: any): string | null;
+    /**
+     * Construct a FieldTextInput from a JSON arg object,
+     * dereferencing any string table references.
+     *
+     * @param options A JSON object with options (text, and spellcheck).
+     * @returns The new field instance.
+     * @nocollapse
+     * @internal
+     */
+    static fromJson(options: FieldTextInputFromJsonConfig): FieldTextInput;
+}
+/**
+ *  Config options for the text input field.
+ */
+export type FieldTextInputConfig = FieldInputConfig;
+/**
+ * fromJson config options for the text input field.
+ */
+export interface FieldTextInputFromJsonConfig extends FieldTextInputConfig {
+    text?: string;
+}
+/**
+ * A function that is called to validate changes to the field's value before
+ * they are set.
+ *
+ * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+ * @param newValue The value to be validated.
+ * @returns One of three instructions for setting the new value: `T`, `null`,
+ * or `undefined`.
+ *
+ * - `T` to set this function's returned value instead of `newValue`.
+ *
+ * - `null` to invoke `doValueInvalid_` and not set a value.
+ *
+ * - `undefined` to set `newValue` as is.
+ */
+export type FieldTextInputValidator = FieldInputValidator<string>;
+//# sourceMappingURL=field_textinput.d.ts.map

package/core/field_variable.d.ts

@@ -0,0 +1,261 @@
+/**
+ * @license
+ * Copyright 2012 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Variable input field.
+ *
+ * @class
+ */
+import './events/events_block_change.js';
+import type { Block } from './block.js';
+import { Field, FieldConfig } from './field.js';
+import { FieldDropdown, FieldDropdownValidator, MenuGenerator, MenuOption } from './field_dropdown.js';
+import { IVariableModel, IVariableState } from './interfaces/i_variable_model.js';
+import type { Menu } from './menu.js';
+import type { MenuItem } from './menuitem.js';
+/**
+ * Class for a variable's dropdown field.
+ */
+export declare class FieldVariable extends FieldDropdown {
+    protected menuGenerator_: MenuGenerator | undefined;
+    defaultVariableName: string;
+    /** The type of the default variable for this field. */
+    private defaultType;
+    /**
+     * All of the types of variables that will be available in this field's
+     * dropdown.
+     */
+    variableTypes: string[] | null;
+    /** The variable model associated with this field. */
+    private variable;
+    /**
+     * Serializable fields are saved by the serializer, non-serializable fields
+     * are not. Editable fields should also be serializable.
+     */
+    SERIALIZABLE: boolean;
+    /**
+     * @param varName The default name for the variable.
+     *     If null, a unique variable name will be generated.
+     *     Also accepts Field.SKIP_SETUP if you wish to skip setup (only used by
+     * subclasses that want to handle configuration and setting the field value
+     * after their own constructors have run).
+     * @param validator A function that is called to validate changes to the
+     *     field's value. Takes in a variable ID  & returns a validated variable
+     *     ID, or null to abort the change.
+     * @param variableTypes A list of the types of variables to include in the
+     *     dropdown. Pass `null` to include all types that exist on the
+     *     workspace. Will only be used if config is not provided.
+     * @param defaultType The type of variable to create if this field's value
+     *     is not explicitly set.  Defaults to ''. Will only be used if config
+     *     is not provided.
+     * @param config A map of options used to configure the field.
+     *    See the [field creation documentation]{@link
+     * https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/variable#creation}
+     * for a list of properties this parameter supports.
+     */
+    constructor(varName: string | null | typeof Field.SKIP_SETUP, validator?: FieldVariableValidator, variableTypes?: string[] | null, defaultType?: string, config?: FieldVariableConfig);
+    /**
+     * Configure the field based on the given map of options.
+     *
+     * @param config A map of options to configure the field based on.
+     */
+    protected configure_(config: FieldVariableConfig): void;
+    /**
+     * Initialize the model for this field if it has not already been initialized.
+     * If the value has not been set to a variable by the first render, we make up
+     * a variable rather than let the value be invalid.
+     */
+    initModel(): void;
+    initView(): void;
+    shouldAddBorderRect_(): boolean;
+    /**
+     * Initialize this field based on the given XML.
+     *
+     * @param fieldElement The element containing information about the variable
+     *     field's state.
+     */
+    fromXml(fieldElement: Element): void;
+    /**
+     * Serialize this field to XML.
+     *
+     * @param fieldElement The element to populate with info about the field's
+     *     state.
+     * @returns The element containing info about the field's state.
+     */
+    toXml(fieldElement: Element): Element;
+    /**
+     * Saves this field's value.
+     *
+     * @param doFullSerialization If true, the variable field will serialize the
+     *     full state of the field being referenced (ie ID, name, and type) rather
+     *     than just a reference to it (ie ID).
+     * @returns The state of the variable field.
+     * @internal
+     */
+    saveState(doFullSerialization?: boolean): any;
+    /**
+     * Sets the field's value based on the given state.
+     *
+     * @param state The state of the variable to assign to this variable field.
+     * @internal
+     */
+    loadState(state: any): void;
+    /**
+     * Attach this field to a block.
+     *
+     * @param block The block containing this field.
+     */
+    setSourceBlock(block: Block): void;
+    /**
+     * Get the variable's ID.
+     *
+     * @returns Current variable's ID.
+     */
+    getValue(): string | null;
+    /**
+     * Get the text from this field, which is the selected variable's name.
+     *
+     * @returns The selected variable's name, or the empty string if no variable
+     *     is selected.
+     */
+    getText(): string;
+    /**
+     * Get the variable model for the selected variable.
+     * Not guaranteed to be in the variable map on the workspace (e.g. if accessed
+     * after the variable has been deleted).
+     *
+     * @returns The selected variable, or null if none was selected.
+     * @internal
+     */
+    getVariable(): IVariableModel<IVariableState> | null;
+    /**
+     * Gets the type of this field's default variable.
+     *
+     * @returns The default type for this variable field.
+     */
+    protected getDefaultType(): string;
+    /**
+     * Gets the validation function for this field, or null if not set.
+     * Returns null if the variable is not set, because validators should not
+     * run on the initial setValue call, because the field won't be attached to
+     * a block and workspace at that point.
+     *
+     * @returns Validation function, or null.
+     */
+    getValidator(): FieldVariableValidator | null;
+    /**
+     * Ensure that the ID belongs to a valid variable of an allowed type.
+     *
+     * @param newValue The ID of the new variable to set.
+     * @returns The validated ID, or null if invalid.
+     */
+    protected doClassValidation_(newValue?: any): string | null;
+    /**
+     * Update the value of this variable field, as well as its variable and text.
+     *
+     * The variable ID should be valid at this point, but if a variable field
+     * validator returns a bad ID, this could break.
+     *
+     * @param newId The value to be saved.
+     */
+    protected doValueUpdate_(newId: string): void;
+    /**
+     * Check whether the given variable type is allowed on this field.
+     *
+     * @param type The type to check.
+     * @returns True if the type is in the list of allowed types.
+     */
+    private typeIsAllowed;
+    /**
+     * Return a list of variable types to include in the dropdown.
+     *
+     * @returns Array of variable types.
+     */
+    private getVariableTypes;
+    /**
+     * Parse the optional arguments representing the allowed variable types and
+     * the default variable type.
+     *
+     * @param variableTypes A list of the types of variables to include in the
+     *     dropdown.  If null or undefined, variables of all types will be
+     *     displayed in the dropdown.
+     * @param defaultType The type of the variable to create if this field's
+     *     value is not explicitly set.  Defaults to ''.
+     */
+    private setTypes;
+    /**
+     * Refreshes the name of the variable by grabbing the name of the model.
+     * Used when a variable gets renamed, but the ID stays the same. Should only
+     * be called by the block.
+     *
+     * @internal
+     */
+    refreshVariableName(): void;
+    /**
+     * Handle the selection of an item in the variable dropdown menu.
+     * Special case the 'Rename variable...' and 'Delete variable...' options.
+     * In the rename case, prompt the user for a new name.
+     *
+     * @param menu The Menu component clicked.
+     * @param menuItem The MenuItem selected within menu.
+     */
+    protected onItemSelected_(menu: Menu, menuItem: MenuItem): void;
+    /**
+     * Overrides referencesVariables(), indicating this field refers to a
+     * variable.
+     *
+     * @returns True.
+     * @internal
+     */
+    referencesVariables(): boolean;
+    /**
+     * Construct a FieldVariable from a JSON arg object,
+     * dereferencing any string table references.
+     *
+     * @param options A JSON object with options (variable, variableTypes, and
+     *     defaultType).
+     * @returns The new field instance.
+     * @nocollapse
+     * @internal
+     */
+    static fromJson(options: FieldVariableFromJsonConfig): FieldVariable;
+    /**
+     * Return a sorted list of variable names for variable dropdown menus.
+     * Include a special option at the end for creating a new variable name.
+     *
+     * @returns Array of variable names/id tuples.
+     */
+    static dropdownCreate(this: FieldVariable): MenuOption[];
+}
+/**
+ * Config options for the variable field.
+ */
+export interface FieldVariableConfig extends FieldConfig {
+    variableTypes?: string[];
+    defaultType?: string;
+}
+/**
+ * fromJson config options for the variable field.
+ */
+export interface FieldVariableFromJsonConfig extends FieldVariableConfig {
+    variable?: string;
+}
+/**
+ * A function that is called to validate changes to the field's value before
+ * they are set.
+ *
+ * @see {@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/validators#return_values}
+ * @param newValue The value to be validated.
+ * @returns One of three instructions for setting the new value: `T`, `null`,
+ * or `undefined`.
+ *
+ * - `T` to set this function's returned value instead of `newValue`.
+ *
+ * - `null` to invoke `doValueInvalid_` and not set a value.
+ *
+ * - `undefined` to set `newValue` as is.
+ */
+export type FieldVariableValidator = FieldDropdownValidator;
+//# sourceMappingURL=field_variable.d.ts.map