TurboWarp Title Menu

Reusable title, menu, and DSL source storage controls for TurboWarp projects.

Blocks

Composition API

Host runtimes can import createTitleDialog, createApplicationMenu, and createDslStorage from @kubohiroya/turbowarp-title-menu, or use the TurboWarpTitleMenu global exposed by the standalone extension bundle.

Safety

The extension is unsandboxed because it mounts DOM controls and uses browser storage. Load reviewed builds only.

Development

See the repository README and architecture documentation for build, test, release, and compatibility details.

TurboWarp Title Menu: complete block reference

All 14 blocks are documented below, including compatibility blocks and blocks available through optional features. Select a block to read its behavior, arguments, default values, and menu choices. Each block has a permanent link.

show title dialog

Shows the configured title dialog above the TurboWarp stage.

Block type: COMMAND. Opcode: showTitle. Permanent link

This block has no arguments.

show application menu

Shows the application menu above the TurboWarp stage.

Block type: COMMAND. Opcode: showMenu. Permanent link

This block has no arguments.

add app menu action [ACTION] labelled [LABEL]

Adds an application menu action this project owns, or relabels one it already added.

Block type: COMMAND. Opcode: addAppMenuAction. Permanent link

ArgumentTypeDefault valueMenu choices
ACTIONSTRINGstart
LABELSTRINGStart

clear app menu actions

Removes every application menu action, including the built-in ones, so a project can define its own set.

Block type: COMMAND. Opcode: clearAppMenuActions. Permanent link

This block has no arguments.

set app menu action [ACTION] enabled [ENABLED]

Enables or disables one application menu action.

Block type: COMMAND. Opcode: setAppMenuActionEnabled. Permanent link

ArgumentTypeDefault valueMenu choices
ACTIONSTRINGNot specifiedAvailable choices depend on the current project or environment.
ENABLEDBOOLEANtrue

when app menu action [ACTION] selected

Runs when the operator selects the named application menu action.

Block type: HAT. Opcode: whenAppMenuActionSelected. Permanent link

ArgumentTypeDefault valueMenu choices
ACTIONSTRINGNot specifiedAvailable choices depend on the current project or environment.

show DSL file manager

Shows the dialog that adds, opens, renames, deletes, and sorts stored DSL files.

Block type: COMMAND. Opcode: showDslFiles. Permanent link

This block has no arguments.

when a DSL source is opened

Runs after the operator opens a stored DSL file, or after the opened source is announced again.

Block type: HAT. Opcode: whenDslSourceOpened. Permanent link

This block has no arguments.

reload the opened DSL source

Announces the currently opened DSL source again without showing a dialog.

Block type: COMMAND. Opcode: reloadOpenedDsl. Permanent link

This block has no arguments.

opened DSL file name

Returns the name of the DSL file that is currently open, or an empty string.

Block type: REPORTER. Opcode: openedDslName. Permanent link

This block has no arguments.

opened DSL source

Returns the text of the DSL file that is currently open, or an empty string.

Block type: REPORTER. Opcode: openedDslSource. Permanent link

This block has no arguments.

has a saved DSL file?

Reports whether at least one DSL file is stored in IndexedDB.

Block type: BOOLEAN. Opcode: hasSavedDsl. Permanent link

This block has no arguments.

saved DSL file count

Returns how many DSL files are stored in IndexedDB.

Block type: REPORTER. Opcode: savedDslCount. Permanent link

This block has no arguments.

last DSL storage error

Returns the most recent DSL storage failure in the interface language, or an empty string.

Block type: REPORTER. Opcode: lastDslError. Permanent link

This block has no arguments.

Repository guide and examples