blockly 9.0.0-beta.0 → 9.0.0-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (736) hide show
  1. package/blockly.min.js +830 -810
  2. package/blockly_compressed.js +821 -801
  3. package/blockly_compressed.js.map +1 -1
  4. package/blocks.d.ts +0 -5
  5. package/blocks_compressed.js +9 -9
  6. package/blocks_compressed.js.map +1 -1
  7. package/closure/goog/base.d.ts +1 -0
  8. package/closure/goog/base_minimal.d.ts +1 -0
  9. package/closure/goog/goog.d.ts +1 -0
  10. package/core/any_aliases.d.ts +1 -0
  11. package/core/block.d.ts +156 -53
  12. package/core/block_animations.d.ts +5 -0
  13. package/core/block_drag_surface.d.ts +18 -5
  14. package/core/block_dragger.d.ts +20 -5
  15. package/core/block_svg.d.ts +92 -24
  16. package/core/blockly.d.ts +31 -10
  17. package/core/blockly_options.d.ts +2 -0
  18. package/core/blocks.d.ts +2 -0
  19. package/core/browser_events.d.ts +16 -7
  20. package/core/bubble.d.ts +42 -12
  21. package/core/bubble_dragger.d.ts +9 -2
  22. package/core/bump_objects.d.ts +6 -2
  23. package/core/clipboard.d.ts +6 -2
  24. package/core/comment.d.ts +13 -3
  25. package/core/common.d.ts +35 -9
  26. package/core/component_manager.d.ts +16 -6
  27. package/core/config.d.ts +1 -0
  28. package/core/connection.d.ts +48 -18
  29. package/core/connection_checker.d.ts +16 -7
  30. package/core/connection_db.d.ts +17 -6
  31. package/core/connection_type.d.ts +2 -0
  32. package/core/constants.d.ts +3 -0
  33. package/core/contextmenu.d.ts +15 -5
  34. package/core/contextmenu_items.d.ts +15 -0
  35. package/core/contextmenu_registry.d.ts +12 -7
  36. package/core/css.d.ts +3 -0
  37. package/core/delete_area.d.ts +5 -1
  38. package/core/dialog.d.ts +14 -7
  39. package/core/drag_target.d.ts +10 -2
  40. package/core/dropdowndiv.d.ts +42 -10
  41. package/core/events/events.d.ts +51 -24
  42. package/core/events/events_abstract.d.ts +18 -7
  43. package/core/events/events_block_base.d.ts +13 -7
  44. package/core/events/events_block_change.d.ts +24 -11
  45. package/core/events/events_block_create.d.ts +18 -7
  46. package/core/events/events_block_delete.d.ts +20 -8
  47. package/core/events/events_block_drag.d.ts +14 -4
  48. package/core/events/events_block_move.d.ts +25 -12
  49. package/core/events/events_bubble_open.d.ts +21 -6
  50. package/core/events/events_click.d.ts +20 -6
  51. package/core/events/events_comment_base.d.ts +13 -6
  52. package/core/events/events_comment_change.d.ts +17 -7
  53. package/core/events/events_comment_create.d.ts +13 -5
  54. package/core/events/events_comment_delete.d.ts +4 -11
  55. package/core/events/events_comment_move.d.ts +19 -8
  56. package/core/events/events_marker_move.d.ts +16 -5
  57. package/core/events/events_selected.d.ts +14 -5
  58. package/core/events/events_theme_change.d.ts +11 -3
  59. package/core/events/events_toolbox_item_select.d.ts +14 -5
  60. package/core/events/events_trashcan_open.d.ts +11 -3
  61. package/core/events/events_ui.d.ts +5 -1
  62. package/core/events/events_ui_base.d.ts +2 -0
  63. package/core/events/events_var_base.d.ts +13 -7
  64. package/core/events/events_var_create.d.ts +15 -6
  65. package/core/events/events_var_delete.d.ts +15 -6
  66. package/core/events/events_var_rename.d.ts +15 -6
  67. package/core/events/events_viewport.d.ts +14 -3
  68. package/core/events/utils.d.ts +50 -7
  69. package/core/events/workspace_events.d.ts +11 -6
  70. package/core/extensions.d.ts +14 -4
  71. package/core/field.d.ts +93 -36
  72. package/core/field_angle.d.ts +14 -3
  73. package/core/field_checkbox.d.ts +20 -7
  74. package/core/field_colour.d.ts +22 -6
  75. package/core/field_dropdown.d.ts +28 -8
  76. package/core/field_image.d.ts +15 -4
  77. package/core/field_label.d.ts +8 -2
  78. package/core/field_label_serializable.d.ts +4 -1
  79. package/core/field_multilineinput.d.ts +21 -6
  80. package/core/field_number.d.ts +22 -6
  81. package/core/field_registry.d.ts +8 -2
  82. package/core/field_textinput.d.ts +28 -8
  83. package/core/field_variable.d.ts +36 -13
  84. package/core/flyout_base.d.ts +70 -24
  85. package/core/flyout_button.d.ts +12 -5
  86. package/core/flyout_horizontal.d.ts +14 -6
  87. package/core/flyout_metrics_manager.d.ts +6 -3
  88. package/core/flyout_vertical.d.ts +14 -6
  89. package/core/generator.d.ts +39 -20
  90. package/core/gesture.d.ts +56 -22
  91. package/core/grid.d.ts +20 -16
  92. package/core/icon.d.ts +18 -5
  93. package/core/inject.d.ts +3 -1
  94. package/core/input.d.ts +25 -10
  95. package/core/input_types.d.ts +2 -0
  96. package/core/insertion_marker_manager.d.ts +27 -9
  97. package/core/interfaces/i_ast_node_location.d.ts +2 -0
  98. package/core/interfaces/i_ast_node_location_svg.d.ts +4 -0
  99. package/core/interfaces/i_ast_node_location_with_block.d.ts +4 -1
  100. package/core/interfaces/i_autohideable.d.ts +3 -0
  101. package/core/interfaces/i_block_dragger.d.ts +7 -1
  102. package/core/interfaces/i_bounded_element.d.ts +5 -1
  103. package/core/interfaces/i_bubble.d.ts +11 -2
  104. package/core/interfaces/i_collapsible_toolbox_item.d.ts +6 -2
  105. package/core/interfaces/i_component.d.ts +3 -1
  106. package/core/interfaces/i_connection_checker.d.ts +14 -6
  107. package/core/interfaces/i_contextmenu.d.ts +2 -0
  108. package/core/interfaces/i_copyable.d.ts +3 -1
  109. package/core/interfaces/i_deletable.d.ts +4 -1
  110. package/core/interfaces/i_delete_area.d.ts +4 -1
  111. package/core/interfaces/i_drag_target.d.ts +10 -2
  112. package/core/interfaces/i_draggable.d.ts +2 -0
  113. package/core/interfaces/i_flyout.d.ts +27 -11
  114. package/core/interfaces/i_keyboard_accessible.d.ts +4 -1
  115. package/core/interfaces/i_metrics_manager.d.ts +24 -12
  116. package/core/interfaces/i_movable.d.ts +4 -1
  117. package/core/interfaces/i_positionable.d.ts +5 -1
  118. package/core/interfaces/i_registrable.d.ts +2 -0
  119. package/core/interfaces/i_registrable_field.d.ts +2 -0
  120. package/core/interfaces/i_selectable.d.ts +2 -0
  121. package/core/interfaces/i_selectable_toolbox_item.d.ts +10 -3
  122. package/core/interfaces/i_serializer.d.ts +6 -1
  123. package/core/interfaces/i_styleable.d.ts +4 -0
  124. package/core/interfaces/i_toolbox.d.ts +17 -6
  125. package/core/interfaces/i_toolbox_item.d.ts +17 -7
  126. package/core/internal_constants.d.ts +6 -0
  127. package/core/keyboard_nav/ast_node.d.ts +55 -28
  128. package/core/keyboard_nav/basic_cursor.d.ts +20 -9
  129. package/core/keyboard_nav/cursor.d.ts +11 -5
  130. package/core/keyboard_nav/marker.d.ts +9 -2
  131. package/core/keyboard_nav/tab_navigate_cursor.d.ts +4 -1
  132. package/core/main.d.ts +1 -0
  133. package/core/marker_manager.d.ts +13 -2
  134. package/core/menu.d.ts +25 -6
  135. package/core/menuitem.d.ts +22 -7
  136. package/core/metrics_manager.d.ts +30 -15
  137. package/core/msg.d.ts +15 -0
  138. package/core/mutator.d.ts +20 -8
  139. package/core/names.d.ts +20 -8
  140. package/core/options.d.ts +12 -6
  141. package/core/positionable_helpers.d.ts +11 -3
  142. package/core/procedures.d.ts +27 -10
  143. package/core/registry.d.ts +19 -8
  144. package/core/rendered_connection.d.ts +29 -7
  145. package/core/renderers/common/block_rendering.d.ts +9 -2
  146. package/core/renderers/common/constants.d.ts +57 -18
  147. package/core/renderers/common/debug.d.ts +5 -1
  148. package/core/renderers/common/debugger.d.ts +12 -1
  149. package/core/renderers/common/drawer.d.ts +16 -3
  150. package/core/renderers/common/i_path_object.d.ts +37 -16
  151. package/core/renderers/common/info.d.ts +28 -11
  152. package/core/renderers/common/marker_svg.d.ts +42 -11
  153. package/core/renderers/common/path_object.d.ts +23 -3
  154. package/core/renderers/common/renderer.d.ts +33 -12
  155. package/core/renderers/geras/constants.d.ts +6 -2
  156. package/core/renderers/geras/drawer.d.ts +4 -1
  157. package/core/renderers/geras/geras.d.ts +3 -2
  158. package/core/renderers/geras/highlight_constants.d.ts +9 -6
  159. package/core/renderers/geras/highlighter.d.ts +12 -1
  160. package/core/renderers/geras/info.d.ts +4 -1
  161. package/core/renderers/geras/measurables/inline_input.d.ts +2 -0
  162. package/core/renderers/geras/measurables/statement_input.d.ts +2 -0
  163. package/core/renderers/geras/path_object.d.ts +4 -1
  164. package/core/renderers/geras/renderer.d.ts +16 -6
  165. package/core/renderers/measurables/base.d.ts +2 -0
  166. package/core/renderers/measurables/bottom_row.d.ts +9 -3
  167. package/core/renderers/measurables/connection.d.ts +2 -0
  168. package/core/renderers/measurables/external_value_input.d.ts +2 -1
  169. package/core/renderers/measurables/field.d.ts +2 -1
  170. package/core/renderers/measurables/hat.d.ts +2 -1
  171. package/core/renderers/measurables/icon.d.ts +4 -1
  172. package/core/renderers/measurables/in_row_spacer.d.ts +2 -1
  173. package/core/renderers/measurables/inline_input.d.ts +2 -1
  174. package/core/renderers/measurables/input_connection.d.ts +2 -0
  175. package/core/renderers/measurables/input_row.d.ts +4 -1
  176. package/core/renderers/measurables/jagged_edge.d.ts +2 -1
  177. package/core/renderers/measurables/next_connection.d.ts +2 -1
  178. package/core/renderers/measurables/output_connection.d.ts +2 -1
  179. package/core/renderers/measurables/previous_connection.d.ts +2 -1
  180. package/core/renderers/measurables/round_corner.d.ts +2 -1
  181. package/core/renderers/measurables/row.d.ts +30 -8
  182. package/core/renderers/measurables/spacer_row.d.ts +2 -1
  183. package/core/renderers/measurables/square_corner.d.ts +2 -1
  184. package/core/renderers/measurables/statement_input.d.ts +2 -1
  185. package/core/renderers/measurables/top_row.d.ts +7 -4
  186. package/core/renderers/measurables/types.d.ts +54 -25
  187. package/core/renderers/minimalist/constants.d.ts +2 -0
  188. package/core/renderers/minimalist/drawer.d.ts +2 -0
  189. package/core/renderers/minimalist/info.d.ts +5 -1
  190. package/core/renderers/minimalist/minimalist.d.ts +2 -1
  191. package/core/renderers/minimalist/renderer.d.ts +8 -3
  192. package/core/renderers/thrasos/info.d.ts +5 -4
  193. package/core/renderers/thrasos/renderer.d.ts +4 -1
  194. package/core/renderers/thrasos/thrasos.d.ts +2 -1
  195. package/core/renderers/zelos/constants.d.ts +31 -44
  196. package/core/renderers/zelos/drawer.d.ts +3 -0
  197. package/core/renderers/zelos/info.d.ts +10 -5
  198. package/core/renderers/zelos/marker_svg.d.ts +5 -0
  199. package/core/renderers/zelos/measurables/bottom_row.d.ts +2 -0
  200. package/core/renderers/zelos/measurables/inputs.d.ts +2 -1
  201. package/core/renderers/zelos/measurables/row_elements.d.ts +2 -0
  202. package/core/renderers/zelos/measurables/top_row.d.ts +2 -0
  203. package/core/renderers/zelos/path_object.d.ts +9 -2
  204. package/core/renderers/zelos/renderer.d.ts +14 -6
  205. package/core/renderers/zelos/zelos.d.ts +3 -2
  206. package/core/scrollbar.d.ts +41 -9
  207. package/core/scrollbar_pair.d.ts +20 -6
  208. package/core/serialization/blocks.d.ts +10 -4
  209. package/core/serialization/exceptions.d.ts +5 -0
  210. package/core/serialization/priorities.d.ts +3 -0
  211. package/core/serialization/registry.d.ts +3 -0
  212. package/core/serialization/variables.d.ts +2 -0
  213. package/core/serialization/workspaces.d.ts +4 -1
  214. package/core/shortcut_items.d.ts +10 -0
  215. package/core/shortcut_registry.d.ts +25 -9
  216. package/core/sprites.d.ts +2 -4
  217. package/core/theme/classic.d.ts +2 -0
  218. package/core/theme/themes.d.ts +1 -0
  219. package/core/theme/zelos.d.ts +2 -0
  220. package/core/theme.d.ts +41 -30
  221. package/core/theme_manager.d.ts +10 -1
  222. package/core/toolbox/category.d.ts +60 -32
  223. package/core/toolbox/collapsible_category.d.ts +10 -3
  224. package/core/toolbox/separator.d.ts +4 -1
  225. package/core/toolbox/toolbox.d.ts +71 -23
  226. package/core/toolbox/toolbox_item.d.ts +17 -7
  227. package/core/tooltip.d.ts +22 -1
  228. package/core/touch.d.ts +18 -6
  229. package/core/touch_gesture.d.ts +19 -4
  230. package/core/trashcan.d.ts +27 -6
  231. package/core/utils/aria.d.ts +4 -0
  232. package/core/utils/array.d.ts +4 -2
  233. package/core/utils/colour.d.ts +24 -13
  234. package/core/utils/coordinate.d.ts +19 -9
  235. package/core/utils/deprecation.d.ts +6 -4
  236. package/core/utils/dom.d.ts +37 -18
  237. package/core/utils/idgenerator.d.ts +14 -4
  238. package/core/utils/keycodes.d.ts +1 -0
  239. package/core/utils/math.d.ts +7 -3
  240. package/core/utils/metrics.d.ts +1 -0
  241. package/core/utils/object.d.ts +7 -2
  242. package/core/utils/parsing.d.ts +9 -4
  243. package/core/utils/rect.d.ts +5 -3
  244. package/core/utils/sentinel.d.ts +2 -0
  245. package/core/utils/size.d.ts +4 -2
  246. package/core/utils/string.d.ts +13 -6
  247. package/core/utils/style.d.ts +14 -33
  248. package/core/utils/svg.d.ts +5 -2
  249. package/core/utils/svg_math.d.ts +15 -7
  250. package/core/utils/svg_paths.d.ts +20 -10
  251. package/core/utils/toolbox.d.ts +26 -5
  252. package/core/utils/useragent.d.ts +1 -12
  253. package/core/utils/xml.d.ts +13 -5
  254. package/core/utils.d.ts +43 -21
  255. package/core/variable_map.d.ts +26 -9
  256. package/core/variable_model.d.ts +5 -2
  257. package/core/variables.d.ts +33 -18
  258. package/core/variables_dynamic.d.ts +25 -5
  259. package/core/warning.d.ts +8 -3
  260. package/core/widgetdiv.d.ts +15 -6
  261. package/core/workspace.d.ts +80 -30
  262. package/core/workspace_audio.d.ts +6 -0
  263. package/core/workspace_comment.d.ts +33 -11
  264. package/core/workspace_comment_svg.d.ts +52 -9
  265. package/core/workspace_drag_surface_svg.d.ts +20 -14
  266. package/core/workspace_dragger.d.ts +6 -0
  267. package/core/workspace_svg.d.ts +174 -62
  268. package/core/xml.d.ts +26 -11
  269. package/core/zoom_controls.d.ts +17 -7
  270. package/core-browser.js +0 -6
  271. package/core.d.ts +0 -5
  272. package/core.js +0 -6
  273. package/dart.d.ts +1 -7
  274. package/dart_compressed.js.map +1 -1
  275. package/index.d.ts +2 -6
  276. package/javascript.d.ts +1 -7
  277. package/javascript_compressed.js.map +1 -1
  278. package/lua.d.ts +1 -7
  279. package/lua_compressed.js.map +1 -1
  280. package/msg/ab.d.ts +8 -0
  281. package/msg/ace.d.ts +8 -0
  282. package/msg/af.d.ts +8 -0
  283. package/msg/am.d.ts +8 -0
  284. package/msg/ar.d.ts +8 -0
  285. package/msg/ast.d.ts +8 -0
  286. package/msg/az.d.ts +8 -0
  287. package/msg/ba.d.ts +8 -0
  288. package/msg/bcc.d.ts +8 -0
  289. package/msg/be-tarask.d.ts +8 -0
  290. package/msg/be.d.ts +8 -0
  291. package/msg/bg.d.ts +8 -0
  292. package/msg/bn.d.ts +8 -0
  293. package/msg/br.d.ts +8 -0
  294. package/msg/bs.d.ts +8 -0
  295. package/msg/ca.d.ts +8 -0
  296. package/msg/cdo.d.ts +8 -0
  297. package/msg/constants.d.ts +16 -0
  298. package/msg/cs.d.ts +8 -0
  299. package/msg/da.d.ts +8 -0
  300. package/msg/de.d.ts +8 -0
  301. package/msg/diq.d.ts +8 -0
  302. package/msg/dty.d.ts +8 -0
  303. package/msg/ee.d.ts +8 -0
  304. package/msg/el.d.ts +8 -0
  305. package/msg/en-gb.d.ts +8 -0
  306. package/msg/en.d.ts +8 -0
  307. package/msg/eo.d.ts +8 -0
  308. package/msg/es.d.ts +8 -0
  309. package/msg/et.d.ts +8 -0
  310. package/msg/eu.d.ts +8 -0
  311. package/msg/fa.d.ts +8 -0
  312. package/msg/fi.d.ts +8 -0
  313. package/msg/fo.d.ts +8 -0
  314. package/msg/fr.d.ts +8 -0
  315. package/msg/frr.d.ts +8 -0
  316. package/msg/gl.d.ts +8 -0
  317. package/msg/gn.d.ts +8 -0
  318. package/msg/gor.d.ts +8 -0
  319. package/msg/ha.d.ts +8 -0
  320. package/msg/hak.d.ts +8 -0
  321. package/msg/he.d.ts +8 -0
  322. package/msg/hi.d.ts +8 -0
  323. package/msg/hr.d.ts +8 -0
  324. package/msg/hrx.d.ts +8 -0
  325. package/msg/hu.d.ts +8 -0
  326. package/msg/hy.d.ts +8 -0
  327. package/msg/ia.d.ts +8 -0
  328. package/msg/id.d.ts +8 -0
  329. package/msg/ig.d.ts +8 -0
  330. package/msg/inh.d.ts +8 -0
  331. package/msg/is.d.ts +8 -0
  332. package/msg/it.d.ts +8 -0
  333. package/msg/ja.d.ts +8 -0
  334. package/msg/ka.d.ts +8 -0
  335. package/msg/kab.d.ts +8 -0
  336. package/msg/kbd-cyrl.d.ts +8 -0
  337. package/msg/km.d.ts +8 -0
  338. package/msg/kn.d.ts +8 -0
  339. package/msg/ko.d.ts +8 -0
  340. package/msg/ksh.d.ts +8 -0
  341. package/msg/ku-latn.d.ts +8 -0
  342. package/msg/ky.d.ts +8 -0
  343. package/msg/la.d.ts +8 -0
  344. package/msg/lb.d.ts +8 -0
  345. package/msg/lki.d.ts +8 -0
  346. package/msg/lo.d.ts +8 -0
  347. package/msg/lrc.d.ts +8 -0
  348. package/msg/lt.d.ts +8 -0
  349. package/msg/lv.d.ts +8 -0
  350. package/msg/mg.d.ts +8 -0
  351. package/msg/mk.d.ts +8 -0
  352. package/msg/ml.d.ts +8 -0
  353. package/msg/mnw.d.ts +8 -0
  354. package/msg/ms.d.ts +8 -0
  355. package/msg/msg.d.ts +429 -432
  356. package/msg/my.d.ts +8 -0
  357. package/msg/mzn.d.ts +8 -0
  358. package/msg/nb.d.ts +8 -0
  359. package/msg/ne.d.ts +8 -0
  360. package/msg/nl.d.ts +8 -0
  361. package/msg/oc.d.ts +8 -0
  362. package/msg/olo.d.ts +8 -0
  363. package/msg/pa.d.ts +8 -0
  364. package/msg/pl.d.ts +8 -0
  365. package/msg/pms.d.ts +8 -0
  366. package/msg/ps.d.ts +8 -0
  367. package/msg/pt-br.d.ts +8 -0
  368. package/msg/pt.d.ts +8 -0
  369. package/msg/qqq.d.ts +16 -0
  370. package/msg/ro.d.ts +8 -0
  371. package/msg/ru.d.ts +8 -0
  372. package/msg/sc.d.ts +8 -0
  373. package/msg/sco.d.ts +8 -0
  374. package/msg/sd.d.ts +8 -0
  375. package/msg/shn.d.ts +8 -0
  376. package/msg/si.d.ts +8 -0
  377. package/msg/sk.d.ts +8 -0
  378. package/msg/skr-arab.d.ts +8 -0
  379. package/msg/sl.d.ts +8 -0
  380. package/msg/smn.d.ts +8 -0
  381. package/msg/sq.d.ts +8 -0
  382. package/msg/sr-latn.d.ts +8 -0
  383. package/msg/sr.d.ts +8 -0
  384. package/msg/sv.d.ts +8 -0
  385. package/msg/sw.d.ts +8 -0
  386. package/msg/synonyms.d.ts +16 -0
  387. package/msg/ta.d.ts +8 -0
  388. package/msg/tcy.d.ts +8 -0
  389. package/msg/te.d.ts +8 -0
  390. package/msg/th.d.ts +8 -0
  391. package/msg/ti.d.ts +8 -0
  392. package/msg/tl.d.ts +8 -0
  393. package/msg/tlh.d.ts +8 -0
  394. package/msg/tr.d.ts +8 -0
  395. package/msg/ug-arab.d.ts +8 -0
  396. package/msg/uk.d.ts +8 -0
  397. package/msg/ur.d.ts +8 -0
  398. package/msg/uz.d.ts +8 -0
  399. package/msg/vi.d.ts +8 -0
  400. package/msg/xmf.d.ts +8 -0
  401. package/msg/yo.d.ts +8 -0
  402. package/msg/yue.d.ts +8 -0
  403. package/msg/zgh.d.ts +8 -0
  404. package/msg/zh-hans.d.ts +8 -0
  405. package/msg/zh-hant.d.ts +8 -0
  406. package/package.json +6 -3
  407. package/php.d.ts +1 -7
  408. package/php_compressed.js.map +1 -1
  409. package/python.d.ts +1 -7
  410. package/python_compressed.js.map +1 -1
  411. package/blocks/blocks.js +0 -48
  412. package/blocks/colour.js +0 -121
  413. package/blocks/lists.js +0 -996
  414. package/blocks/logic.js +0 -665
  415. package/blocks/loops.js +0 -375
  416. package/blocks/math.js +0 -594
  417. package/blocks/procedures.js +0 -1196
  418. package/blocks/text.js +0 -1000
  419. package/blocks/variables.js +0 -176
  420. package/blocks/variables_dynamic.js +0 -192
  421. package/core/any_aliases.ts +0 -1
  422. package/core/block.ts +0 -2102
  423. package/core/block_animations.ts +0 -202
  424. package/core/block_drag_surface.ts +0 -237
  425. package/core/block_dragger.ts +0 -447
  426. package/core/block_svg.ts +0 -1758
  427. package/core/blockly.js +0 -890
  428. package/core/blockly.ts +0 -749
  429. package/core/blockly_options.ts +0 -81
  430. package/core/blocks.ts +0 -29
  431. package/core/browser_events.ts +0 -289
  432. package/core/bubble.ts +0 -892
  433. package/core/bubble_dragger.ts +0 -229
  434. package/core/bump_objects.ts +0 -182
  435. package/core/clipboard.ts +0 -91
  436. package/core/comment.ts +0 -398
  437. package/core/common.ts +0 -288
  438. package/core/component_manager.ts +0 -211
  439. package/core/config.ts +0 -80
  440. package/core/connection.ts +0 -692
  441. package/core/connection_checker.ts +0 -301
  442. package/core/connection_db.ts +0 -289
  443. package/core/connection_type.ts +0 -32
  444. package/core/constants.ts +0 -29
  445. package/core/contextmenu.ts +0 -363
  446. package/core/contextmenu_items.ts +0 -576
  447. package/core/contextmenu_registry.ts +0 -179
  448. package/core/css.ts +0 -560
  449. package/core/delete_area.ts +0 -82
  450. package/core/dialog.ts +0 -127
  451. package/core/drag_target.ts +0 -94
  452. package/core/dropdowndiv.ts +0 -683
  453. package/core/events/events.ts +0 -123
  454. package/core/events/events_abstract.ts +0 -112
  455. package/core/events/events_block_base.ts +0 -65
  456. package/core/events/events_block_change.ts +0 -176
  457. package/core/events/events_block_create.ts +0 -114
  458. package/core/events/events_block_delete.ts +0 -126
  459. package/core/events/events_block_drag.ts +0 -82
  460. package/core/events/events_block_move.ts +0 -206
  461. package/core/events/events_bubble_open.ts +0 -82
  462. package/core/events/events_click.ts +0 -84
  463. package/core/events/events_comment_base.ts +0 -107
  464. package/core/events/events_comment_change.ts +0 -108
  465. package/core/events/events_comment_create.ts +0 -82
  466. package/core/events/events_comment_delete.ts +0 -77
  467. package/core/events/events_comment_move.ts +0 -154
  468. package/core/events/events_marker_move.ts +0 -99
  469. package/core/events/events_selected.ts +0 -78
  470. package/core/events/events_theme_change.ts +0 -67
  471. package/core/events/events_toolbox_item_select.ts +0 -79
  472. package/core/events/events_trashcan_open.ts +0 -68
  473. package/core/events/events_ui.ts +0 -89
  474. package/core/events/events_ui_base.ts +0 -54
  475. package/core/events/events_var_base.ts +0 -65
  476. package/core/events/events_var_create.ts +0 -88
  477. package/core/events/events_var_delete.ts +0 -88
  478. package/core/events/events_var_rename.ts +0 -89
  479. package/core/events/events_viewport.ts +0 -100
  480. package/core/events/utils.ts +0 -529
  481. package/core/events/workspace_events.ts +0 -86
  482. package/core/extensions.ts +0 -504
  483. package/core/field.ts +0 -1206
  484. package/core/field_angle.ts +0 -563
  485. package/core/field_checkbox.ts +0 -243
  486. package/core/field_colour.ts +0 -632
  487. package/core/field_dropdown.ts +0 -773
  488. package/core/field_image.ts +0 -282
  489. package/core/field_label.ts +0 -152
  490. package/core/field_label_serializable.ts +0 -76
  491. package/core/field_multilineinput.ts +0 -466
  492. package/core/field_number.ts +0 -327
  493. package/core/field_registry.ts +0 -87
  494. package/core/field_textinput.ts +0 -591
  495. package/core/field_variable.ts +0 -545
  496. package/core/flyout_base.ts +0 -1165
  497. package/core/flyout_button.ts +0 -292
  498. package/core/flyout_horizontal.ts +0 -381
  499. package/core/flyout_metrics_manager.ts +0 -94
  500. package/core/flyout_vertical.ts +0 -384
  501. package/core/generator.ts +0 -539
  502. package/core/gesture.ts +0 -946
  503. package/core/grid.ts +0 -192
  504. package/core/icon.ts +0 -189
  505. package/core/inject.ts +0 -390
  506. package/core/input.ts +0 -309
  507. package/core/input_types.ts +0 -32
  508. package/core/insertion_marker_manager.ts +0 -788
  509. package/core/interfaces/i_ast_node_location.ts +0 -23
  510. package/core/interfaces/i_ast_node_location_svg.ts +0 -37
  511. package/core/interfaces/i_ast_node_location_with_block.ts +0 -38
  512. package/core/interfaces/i_autohideable.ts +0 -34
  513. package/core/interfaces/i_block_dragger.ts +0 -67
  514. package/core/interfaces/i_bounded_element.ts +0 -42
  515. package/core/interfaces/i_bubble.ts +0 -88
  516. package/core/interfaces/i_collapsible_toolbox_item.ts +0 -47
  517. package/core/interfaces/i_component.ts +0 -32
  518. package/core/interfaces/i_connection_checker.ts +0 -102
  519. package/core/interfaces/i_contextmenu.ts +0 -26
  520. package/core/interfaces/i_copyable.ts +0 -40
  521. package/core/interfaces/i_deletable.ts +0 -29
  522. package/core/interfaces/i_delete_area.ts +0 -46
  523. package/core/interfaces/i_drag_target.ts +0 -84
  524. package/core/interfaces/i_draggable.ts +0 -25
  525. package/core/interfaces/i_flyout.ts +0 -186
  526. package/core/interfaces/i_keyboard_accessible.ts +0 -35
  527. package/core/interfaces/i_metrics_manager.ts +0 -151
  528. package/core/interfaces/i_movable.ts +0 -29
  529. package/core/interfaces/i_positionable.ts +0 -50
  530. package/core/interfaces/i_registrable.ts +0 -25
  531. package/core/interfaces/i_registrable_field.ts +0 -31
  532. package/core/interfaces/i_selectable.ts +0 -34
  533. package/core/interfaces/i_selectable_toolbox_item.ts +0 -64
  534. package/core/interfaces/i_serializer.ts +0 -65
  535. package/core/interfaces/i_styleable.ts +0 -35
  536. package/core/interfaces/i_toolbox.ts +0 -127
  537. package/core/interfaces/i_toolbox_item.ts +0 -84
  538. package/core/internal_constants.ts +0 -67
  539. package/core/keyboard_nav/ast_node.ts +0 -717
  540. package/core/keyboard_nav/basic_cursor.ts +0 -214
  541. package/core/keyboard_nav/cursor.ts +0 -134
  542. package/core/keyboard_nav/marker.ts +0 -115
  543. package/core/keyboard_nav/tab_navigate_cursor.ts +0 -48
  544. package/core/main.js +0 -303
  545. package/core/marker_manager.ts +0 -181
  546. package/core/menu.ts +0 -449
  547. package/core/menuitem.ts +0 -240
  548. package/core/metrics_manager.ts +0 -456
  549. package/core/msg.ts +0 -20
  550. package/core/mutator.ts +0 -560
  551. package/core/names.ts +0 -267
  552. package/core/options.ts +0 -365
  553. package/core/positionable_helpers.ts +0 -181
  554. package/core/procedures.ts +0 -443
  555. package/core/registry.ts +0 -339
  556. package/core/rendered_connection.ts +0 -568
  557. package/core/renderers/common/block_rendering.ts +0 -164
  558. package/core/renderers/common/constants.ts +0 -1124
  559. package/core/renderers/common/debug.ts +0 -61
  560. package/core/renderers/common/debugger.ts +0 -433
  561. package/core/renderers/common/drawer.ts +0 -450
  562. package/core/renderers/common/i_path_object.ts +0 -161
  563. package/core/renderers/common/info.ts +0 -718
  564. package/core/renderers/common/marker_svg.ts +0 -680
  565. package/core/renderers/common/path_object.ts +0 -272
  566. package/core/renderers/common/renderer.ts +0 -271
  567. package/core/renderers/geras/constants.ts +0 -61
  568. package/core/renderers/geras/drawer.ts +0 -176
  569. package/core/renderers/geras/geras.ts +0 -37
  570. package/core/renderers/geras/highlight_constants.ts +0 -337
  571. package/core/renderers/geras/highlighter.ts +0 -306
  572. package/core/renderers/geras/info.ts +0 -450
  573. package/core/renderers/geras/measurables/inline_input.ts +0 -51
  574. package/core/renderers/geras/measurables/statement_input.ts +0 -50
  575. package/core/renderers/geras/path_object.ts +0 -138
  576. package/core/renderers/geras/renderer.ts +0 -126
  577. package/core/renderers/measurables/base.ts +0 -53
  578. package/core/renderers/measurables/bottom_row.ts +0 -120
  579. package/core/renderers/measurables/connection.ts +0 -52
  580. package/core/renderers/measurables/external_value_input.ts +0 -65
  581. package/core/renderers/measurables/field.ts +0 -63
  582. package/core/renderers/measurables/hat.ts +0 -48
  583. package/core/renderers/measurables/icon.ts +0 -54
  584. package/core/renderers/measurables/in_row_spacer.ts +0 -44
  585. package/core/renderers/measurables/inline_input.ts +0 -76
  586. package/core/renderers/measurables/input_connection.ts +0 -66
  587. package/core/renderers/measurables/input_row.ts +0 -82
  588. package/core/renderers/measurables/jagged_edge.ts +0 -43
  589. package/core/renderers/measurables/next_connection.ts +0 -47
  590. package/core/renderers/measurables/output_connection.ts +0 -56
  591. package/core/renderers/measurables/previous_connection.ts +0 -47
  592. package/core/renderers/measurables/round_corner.ts +0 -49
  593. package/core/renderers/measurables/row.ts +0 -225
  594. package/core/renderers/measurables/spacer_row.ts +0 -55
  595. package/core/renderers/measurables/square_corner.ts +0 -47
  596. package/core/renderers/measurables/statement_input.ts +0 -55
  597. package/core/renderers/measurables/top_row.ts +0 -122
  598. package/core/renderers/measurables/types.ts +0 -332
  599. package/core/renderers/minimalist/constants.ts +0 -32
  600. package/core/renderers/minimalist/drawer.ts +0 -38
  601. package/core/renderers/minimalist/info.ts +0 -52
  602. package/core/renderers/minimalist/minimalist.ts +0 -22
  603. package/core/renderers/minimalist/renderer.ts +0 -71
  604. package/core/renderers/thrasos/info.ts +0 -338
  605. package/core/renderers/thrasos/renderer.ts +0 -48
  606. package/core/renderers/thrasos/thrasos.ts +0 -20
  607. package/core/renderers/zelos/constants.ts +0 -858
  608. package/core/renderers/zelos/drawer.ts +0 -228
  609. package/core/renderers/zelos/info.ts +0 -593
  610. package/core/renderers/zelos/marker_svg.ts +0 -151
  611. package/core/renderers/zelos/measurables/bottom_row.ts +0 -53
  612. package/core/renderers/zelos/measurables/inputs.ts +0 -56
  613. package/core/renderers/zelos/measurables/row_elements.ts +0 -45
  614. package/core/renderers/zelos/measurables/top_row.ts +0 -58
  615. package/core/renderers/zelos/path_object.ts +0 -215
  616. package/core/renderers/zelos/renderer.ts +0 -142
  617. package/core/renderers/zelos/zelos.ts +0 -39
  618. package/core/scrollbar.ts +0 -870
  619. package/core/scrollbar_pair.ts +0 -321
  620. package/core/serialization/blocks.ts +0 -706
  621. package/core/serialization/exceptions.ts +0 -98
  622. package/core/serialization/priorities.ts +0 -32
  623. package/core/serialization/registry.ts +0 -43
  624. package/core/serialization/variables.ts +0 -96
  625. package/core/serialization/workspaces.ts +0 -106
  626. package/core/shortcut_items.ts +0 -266
  627. package/core/shortcut_registry.ts +0 -355
  628. package/core/sprites.ts +0 -29
  629. package/core/theme/classic.ts +0 -54
  630. package/core/theme/themes.ts +0 -22
  631. package/core/theme/zelos.ts +0 -91
  632. package/core/theme.ts +0 -221
  633. package/core/theme_manager.ts +0 -186
  634. package/core/toolbox/category.ts +0 -679
  635. package/core/toolbox/collapsible_category.ts +0 -273
  636. package/core/toolbox/separator.ts +0 -105
  637. package/core/toolbox/toolbox.ts +0 -1044
  638. package/core/toolbox/toolbox_item.ts +0 -147
  639. package/core/tooltip.ts +0 -463
  640. package/core/touch.ts +0 -306
  641. package/core/touch_gesture.ts +0 -295
  642. package/core/trashcan.ts +0 -671
  643. package/core/utils/aria.ts +0 -160
  644. package/core/utils/array.ts +0 -32
  645. package/core/utils/colour.ts +0 -276
  646. package/core/utils/coordinate.ts +0 -124
  647. package/core/utils/deprecation.ts +0 -41
  648. package/core/utils/dom.ts +0 -408
  649. package/core/utils/idgenerator.ts +0 -80
  650. package/core/utils/keycodes.ts +0 -169
  651. package/core/utils/math.ts +0 -61
  652. package/core/utils/metrics.ts +0 -97
  653. package/core/utils/object.ts +0 -95
  654. package/core/utils/parsing.ts +0 -261
  655. package/core/utils/rect.ts +0 -62
  656. package/core/utils/sentinel.ts +0 -23
  657. package/core/utils/size.ts +0 -51
  658. package/core/utils/string.ts +0 -308
  659. package/core/utils/style.ts +0 -306
  660. package/core/utils/svg.ts +0 -88
  661. package/core/utils/svg_math.ts +0 -269
  662. package/core/utils/svg_paths.ts +0 -140
  663. package/core/utils/toolbox.ts +0 -433
  664. package/core/utils/useragent.ts +0 -135
  665. package/core/utils/xml.ts +0 -97
  666. package/core/utils.ts +0 -428
  667. package/core/variable_map.ts +0 -392
  668. package/core/variable_model.ts +0 -82
  669. package/core/variables.ts +0 -596
  670. package/core/variables_dynamic.ts +0 -133
  671. package/core/warning.ts +0 -161
  672. package/core/widgetdiv.ts +0 -257
  673. package/core/workspace.ts +0 -801
  674. package/core/workspace_audio.ts +0 -156
  675. package/core/workspace_comment.ts +0 -398
  676. package/core/workspace_comment_svg.ts +0 -1127
  677. package/core/workspace_drag_surface_svg.ts +0 -187
  678. package/core/workspace_dragger.ts +0 -104
  679. package/core/workspace_svg.ts +0 -2655
  680. package/core/xml.ts +0 -1023
  681. package/core/zoom_controls.ts +0 -441
  682. package/generators/dart/all.js +0 -27
  683. package/generators/dart/colour.js +0 -105
  684. package/generators/dart/lists.js +0 -431
  685. package/generators/dart/logic.js +0 -123
  686. package/generators/dart/loops.js +0 -161
  687. package/generators/dart/math.js +0 -446
  688. package/generators/dart/procedures.js +0 -105
  689. package/generators/dart/text.js +0 -338
  690. package/generators/dart/variables.js +0 -32
  691. package/generators/dart/variables_dynamic.js +0 -21
  692. package/generators/dart.js +0 -303
  693. package/generators/javascript/all.js +0 -27
  694. package/generators/javascript/colour.js +0 -85
  695. package/generators/javascript/lists.js +0 -405
  696. package/generators/javascript/logic.js +0 -127
  697. package/generators/javascript/loops.js +0 -180
  698. package/generators/javascript/math.js +0 -401
  699. package/generators/javascript/procedures.js +0 -110
  700. package/generators/javascript/text.js +0 -371
  701. package/generators/javascript/variables.js +0 -32
  702. package/generators/javascript/variables_dynamic.js +0 -21
  703. package/generators/javascript.js +0 -322
  704. package/generators/lua/all.js +0 -27
  705. package/generators/lua/colour.js +0 -71
  706. package/generators/lua/lists.js +0 -348
  707. package/generators/lua/logic.js +0 -112
  708. package/generators/lua/loops.js +0 -168
  709. package/generators/lua/math.js +0 -406
  710. package/generators/lua/procedures.js +0 -106
  711. package/generators/lua/text.js +0 -327
  712. package/generators/lua/variables.js +0 -31
  713. package/generators/lua/variables_dynamic.js +0 -21
  714. package/generators/lua.js +0 -206
  715. package/generators/php/all.js +0 -27
  716. package/generators/php/colour.js +0 -81
  717. package/generators/php/lists.js +0 -481
  718. package/generators/php/logic.js +0 -119
  719. package/generators/php/loops.js +0 -161
  720. package/generators/php/math.js +0 -349
  721. package/generators/php/procedures.js +0 -125
  722. package/generators/php/text.js +0 -255
  723. package/generators/php/variables.js +0 -32
  724. package/generators/php/variables_dynamic.js +0 -21
  725. package/generators/php.js +0 -303
  726. package/generators/python/all.js +0 -27
  727. package/generators/python/colour.js +0 -67
  728. package/generators/python/lists.js +0 -346
  729. package/generators/python/logic.js +0 -120
  730. package/generators/python/loops.js +0 -206
  731. package/generators/python/math.js +0 -373
  732. package/generators/python/procedures.js +0 -129
  733. package/generators/python/text.js +0 -291
  734. package/generators/python/variables.js +0 -32
  735. package/generators/python/variables_dynamic.js +0 -21
  736. package/generators/python.js +0 -333
package/core/block.d.ts CHANGED
@@ -22,7 +22,7 @@ import type { Workspace } from './workspace.js';
22
22
  /**
23
23
  * Class for one block.
24
24
  * Not normally called directly, workspace.newBlock() is preferred.
25
- * @unrestricted
25
+ *
26
26
  * @alias Blockly.Block
27
27
  */
28
28
  export declare class Block implements IASTNodeLocation, IDeletable {
@@ -43,6 +43,7 @@ export declare class Block implements IASTNodeLocation, IDeletable {
43
43
  data: string | null;
44
44
  /**
45
45
  * Has this block been disposed of?
46
+ *
46
47
  * @internal
47
48
  */
48
49
  disposed: boolean;
@@ -120,8 +121,13 @@ export declare class Block implements IASTNodeLocation, IDeletable {
120
121
  private isShadow_;
121
122
  protected collapsed_: boolean;
122
123
  protected outputShape_: number | null;
124
+ /**
125
+ * Is the current block currently in the process of being disposed?
126
+ */
127
+ private disposing;
123
128
  /**
124
129
  * A string representing the comment attached to this block.
130
+ *
125
131
  * @deprecated August 2019. Use getCommentText instead.
126
132
  */
127
133
  comment: string | Comment | null;
@@ -144,6 +150,7 @@ export declare class Block implements IASTNodeLocation, IDeletable {
144
150
  private onchangeWrapper_;
145
151
  /**
146
152
  * A count of statement inputs on the block.
153
+ *
147
154
  * @internal
148
155
  */
149
156
  statementInputCount: number;
@@ -163,12 +170,20 @@ export declare class Block implements IASTNodeLocation, IDeletable {
163
170
  protected doInit_(): void;
164
171
  /**
165
172
  * Dispose of this block.
173
+ *
166
174
  * @param healStack If true, then try to heal any gap by connecting the next
167
175
  * statement with the previous statement. Otherwise, dispose of all
168
176
  * children of this block.
169
177
  * @suppress {checkTypes}
170
178
  */
171
179
  dispose(healStack: boolean): void;
180
+ /**
181
+ * Returns true if the block is either in the process of being disposed, or
182
+ * is disposed.
183
+ *
184
+ * @internal
185
+ */
186
+ isDeadOrDying(): boolean;
172
187
  /**
173
188
  * Call initModel on all fields on the block.
174
189
  * May be called more than once.
@@ -181,6 +196,7 @@ export declare class Block implements IASTNodeLocation, IDeletable {
181
196
  /**
182
197
  * Unplug this block from its superior block. If this block is a statement,
183
198
  * optionally reconnect the block underneath with the block on top.
199
+ *
184
200
  * @param opt_healStack Disconnect child statement and reconnect stack.
185
201
  * Defaults to false.
186
202
  */
@@ -188,6 +204,7 @@ export declare class Block implements IASTNodeLocation, IDeletable {
188
204
  /**
189
205
  * Unplug this block's output from an input on another block. Optionally
190
206
  * reconnect the block's parent to the only child block, if possible.
207
+ *
191
208
  * @param opt_healStack Disconnect right-side block and connect to left-side
192
209
  * block. Defaults to false.
193
210
  */
@@ -199,30 +216,33 @@ export declare class Block implements IASTNodeLocation, IDeletable {
199
216
  * Since only one block can be displaced and attached to the insertion marker
200
217
  * this should only ever return one connection.
201
218
  *
202
- * @return The connection on the value input, or null.
219
+ * @returns The connection on the value input, or null.
203
220
  */
204
221
  private getOnlyValueConnection_;
205
222
  /**
206
223
  * Unplug this statement block from its superior block. Optionally reconnect
207
224
  * the block underneath with the block on top.
225
+ *
208
226
  * @param opt_healStack Disconnect child statement and reconnect stack.
209
227
  * Defaults to false.
210
228
  */
211
229
  private unplugFromStack_;
212
230
  /**
213
231
  * Returns all connections originating from this block.
232
+ *
214
233
  * @param _all If true, return all connections even hidden ones.
215
- * @return Array of connections.
234
+ * @returns Array of connections.
216
235
  * @internal
217
236
  */
218
237
  getConnections_(_all: boolean): Connection[];
219
238
  /**
220
239
  * Walks down a stack of blocks and finds the last next connection on the
221
240
  * stack.
241
+ *
222
242
  * @param ignoreShadows If true,the last connection on a non-shadow block will
223
243
  * be returned. If false, this will follow shadows to find the last
224
244
  * connection.
225
- * @return The last next connection on the stack, or null.
245
+ * @returns The last next connection on the stack, or null.
226
246
  * @internal
227
247
  */
228
248
  lastConnectionInStack(ignoreShadows: boolean): Connection | null;
@@ -236,13 +256,15 @@ export declare class Block implements IASTNodeLocation, IDeletable {
236
256
  * parent block is either the block connected to the previous connection (for
237
257
  * a statement block) or the block connected to the output connection (for a
238
258
  * value block).
239
- * @return The block (if any) that holds the current block.
259
+ *
260
+ * @returns The block (if any) that holds the current block.
240
261
  */
241
262
  getParent(): this | null;
242
263
  /**
243
264
  * Return the input that connects to the specified block.
265
+ *
244
266
  * @param block A block connected to an input on this block.
245
- * @return The input (if any) that connects to the specified block.
267
+ * @returns The input (if any) that connects to the specified block.
246
268
  */
247
269
  getInputWithBlock(block: Block): Input | null;
248
270
  /**
@@ -250,37 +272,43 @@ export declare class Block implements IASTNodeLocation, IDeletable {
250
272
  * block has no surrounding block. A parent block might just be the previous
251
273
  * statement, whereas the surrounding block is an if statement, while loop,
252
274
  * etc.
253
- * @return The block (if any) that surrounds the current block.
275
+ *
276
+ * @returns The block (if any) that surrounds the current block.
254
277
  */
255
278
  getSurroundParent(): this | null;
256
279
  /**
257
280
  * Return the next statement block directly connected to this block.
258
- * @return The next statement block or null.
281
+ *
282
+ * @returns The next statement block or null.
259
283
  */
260
284
  getNextBlock(): Block | null;
261
285
  /**
262
286
  * Returns the block connected to the previous connection.
263
- * @return The previous statement block or null.
287
+ *
288
+ * @returns The previous statement block or null.
264
289
  */
265
290
  getPreviousBlock(): Block | null;
266
291
  /**
267
292
  * Return the connection on the first statement input on this block, or null
268
293
  * if there are none.
269
- * @return The first statement connection or null.
294
+ *
295
+ * @returns The first statement connection or null.
270
296
  * @internal
271
297
  */
272
298
  getFirstStatementConnection(): Connection | null;
273
299
  /**
274
300
  * Return the top-most block in this block's tree.
275
301
  * This will return itself if this block is at the top level.
276
- * @return The root block.
302
+ *
303
+ * @returns The root block.
277
304
  */
278
305
  getRootBlock(): this;
279
306
  /**
280
307
  * Walk up from the given block up through the stack of blocks to find
281
308
  * the top block of the sub stack. If we are nested in a statement input only
282
309
  * find the top-most nested block. Do not go all the way to the root block.
283
- * @return The top block in a stack.
310
+ *
311
+ * @returns The top block in a stack.
284
312
  * @internal
285
313
  */
286
314
  getTopStackBlock(): this;
@@ -289,12 +317,14 @@ export declare class Block implements IASTNodeLocation, IDeletable {
289
317
  * Includes value and statement inputs, as well as any following statement.
290
318
  * Excludes any connection on an output tab or any preceding statement.
291
319
  * Blocks are optionally sorted by position; top to bottom.
320
+ *
292
321
  * @param ordered Sort the list if true.
293
- * @return Array of blocks.
322
+ * @returns Array of blocks.
294
323
  */
295
324
  getChildren(ordered: boolean): Block[];
296
325
  /**
297
326
  * Set parent of this block to be a new block or null.
327
+ *
298
328
  * @param newParent New parent block.
299
329
  * @internal
300
330
  */
@@ -305,27 +335,32 @@ export declare class Block implements IASTNodeLocation, IDeletable {
305
335
  * Includes value and statement inputs, as well as any following statements.
306
336
  * Excludes any connection on an output tab or any preceding statements.
307
337
  * Blocks are optionally sorted by position; top to bottom.
338
+ *
308
339
  * @param ordered Sort the list if true.
309
- * @return Flattened array of blocks.
340
+ * @returns Flattened array of blocks.
310
341
  */
311
342
  getDescendants(ordered: boolean): this[];
312
343
  /**
313
344
  * Get whether this block is deletable or not.
314
- * @return True if deletable.
345
+ *
346
+ * @returns True if deletable.
315
347
  */
316
348
  isDeletable(): boolean;
317
349
  /**
318
350
  * Set whether this block is deletable or not.
351
+ *
319
352
  * @param deletable True if deletable.
320
353
  */
321
354
  setDeletable(deletable: boolean): void;
322
355
  /**
323
356
  * Get whether this block is movable or not.
324
- * @return True if movable.
357
+ *
358
+ * @returns True if movable.
325
359
  */
326
360
  isMovable(): boolean;
327
361
  /**
328
362
  * Set whether this block is movable or not.
363
+ *
329
364
  * @param movable True if movable.
330
365
  */
331
366
  setMovable(movable: boolean): void;
@@ -334,65 +369,76 @@ export declare class Block implements IASTNodeLocation, IDeletable {
334
369
  * descendants will put this block over the workspace's capacity this block is
335
370
  * not duplicatable. If duplicating this block and descendants will put any
336
371
  * type over their maxInstances this block is not duplicatable.
337
- * @return True if duplicatable.
372
+ *
373
+ * @returns True if duplicatable.
338
374
  */
339
375
  isDuplicatable(): boolean;
340
376
  /**
341
377
  * Get whether this block is a shadow block or not.
342
- * @return True if a shadow.
378
+ *
379
+ * @returns True if a shadow.
343
380
  */
344
381
  isShadow(): boolean;
345
382
  /**
346
383
  * Set whether this block is a shadow block or not.
384
+ *
347
385
  * @param shadow True if a shadow.
348
386
  * @internal
349
387
  */
350
388
  setShadow(shadow: boolean): void;
351
389
  /**
352
390
  * Get whether this block is an insertion marker block or not.
353
- * @return True if an insertion marker.
391
+ *
392
+ * @returns True if an insertion marker.
354
393
  */
355
394
  isInsertionMarker(): boolean;
356
395
  /**
357
396
  * Set whether this block is an insertion marker block or not.
358
397
  * Once set this cannot be unset.
398
+ *
359
399
  * @param insertionMarker True if an insertion marker.
360
400
  * @internal
361
401
  */
362
402
  setInsertionMarker(insertionMarker: boolean): void;
363
403
  /**
364
404
  * Get whether this block is editable or not.
365
- * @return True if editable.
405
+ *
406
+ * @returns True if editable.
366
407
  */
367
408
  isEditable(): boolean;
368
409
  /**
369
410
  * Set whether this block is editable or not.
411
+ *
370
412
  * @param editable True if editable.
371
413
  */
372
414
  setEditable(editable: boolean): void;
373
415
  /**
374
416
  * Returns if this block has been disposed of / deleted.
375
- * @return True if this block has been disposed of / deleted.
417
+ *
418
+ * @returns True if this block has been disposed of / deleted.
376
419
  */
377
420
  isDisposed(): boolean;
378
421
  /**
379
422
  * Find the connection on this block that corresponds to the given connection
380
423
  * on the other block.
381
424
  * Used to match connections between a block and its insertion marker.
425
+ *
382
426
  * @param otherBlock The other block to match against.
383
427
  * @param conn The other connection to match.
384
- * @return The matching connection on this block, or null.
428
+ * @returns The matching connection on this block, or null.
385
429
  * @internal
386
430
  */
387
431
  getMatchingConnection(otherBlock: Block, conn: Connection): Connection | null;
388
432
  /**
389
433
  * Set the URL of this block's help page.
434
+ *
390
435
  * @param url URL string for block help, or function that returns a URL. Null
391
436
  * for no help.
392
437
  */
393
438
  setHelpUrl(url: string | Function): void;
394
439
  /**
395
440
  * Sets the tooltip for this block.
441
+ *
396
442
  * @param newTip The text for the tooltip, a function that returns the text
397
443
  * for the tooltip, or a parent object whose tooltip will be used. To not
398
444
  * display a tooltip pass the empty string.
@@ -400,32 +446,38 @@ export declare class Block implements IASTNodeLocation, IDeletable {
400
446
  setTooltip(newTip: Tooltip.TipInfo): void;
401
447
  /**
402
448
  * Returns the tooltip text for this block.
403
- * @return The tooltip text for this block.
449
+ *
450
+ * @returns The tooltip text for this block.
404
451
  */
405
452
  getTooltip(): string;
406
453
  /**
407
454
  * Get the colour of a block.
408
- * @return #RRGGBB string.
455
+ *
456
+ * @returns #RRGGBB string.
409
457
  */
410
458
  getColour(): string;
411
459
  /**
412
460
  * Get the name of the block style.
413
- * @return Name of the block style.
461
+ *
462
+ * @returns Name of the block style.
414
463
  */
415
464
  getStyleName(): string;
416
465
  /**
417
466
  * Get the HSV hue value of a block. Null if hue not set.
418
- * @return Hue value (0-360).
467
+ *
468
+ * @returns Hue value (0-360).
419
469
  */
420
470
  getHue(): number | null;
421
471
  /**
422
472
  * Change the colour of a block.
473
+ *
423
474
  * @param colour HSV hue value (0 to 360), #RRGGBB string, or a message
424
475
  * reference string pointing to one of those two values.
425
476
  */
426
477
  setColour(colour: number | string): void;
427
478
  /**
428
479
  * Set the style and colour values of a block.
480
+ *
429
481
  * @param blockStyleName Name of the block style.
430
482
  */
431
483
  setStyle(blockStyleName: string): void;
@@ -434,30 +486,35 @@ export declare class Block implements IASTNodeLocation, IDeletable {
434
486
  * changes, replacing any prior onchange handler. This is usually only called
435
487
  * from the constructor, the block type initializer function, or an extension
436
488
  * initializer function.
489
+ *
437
490
  * @param onchangeFn The callback to call when the block's workspace changes.
438
491
  * @throws {Error} if onchangeFn is not falsey and not a function.
439
492
  */
440
493
  setOnChange(onchangeFn: (p1: Abstract) => any): void;
441
494
  /**
442
495
  * Returns the named field from a block.
496
+ *
443
497
  * @param name The name of the field.
444
- * @return Named field, or null if field does not exist.
498
+ * @returns Named field, or null if field does not exist.
445
499
  */
446
500
  getField(name: string): Field | null;
447
501
  /**
448
502
  * Return all variables referenced by this block.
449
- * @return List of variable ids.
503
+ *
504
+ * @returns List of variable ids.
450
505
  */
451
506
  getVars(): string[];
452
507
  /**
453
508
  * Return all variables referenced by this block.
454
- * @return List of variable models.
509
+ *
510
+ * @returns List of variable models.
455
511
  * @internal
456
512
  */
457
513
  getVarModels(): VariableModel[];
458
514
  /**
459
515
  * Notification that a variable is renaming but keeping the same ID. If the
460
516
  * variable is in use on this block, rerender to show the new name.
517
+ *
461
518
  * @param variable The variable being renamed.
462
519
  * @internal
463
520
  */
@@ -465,6 +522,7 @@ export declare class Block implements IASTNodeLocation, IDeletable {
465
522
  /**
466
523
  * Notification that a variable is renaming.
467
524
  * If the ID matches one of this block's variables, rename it.
525
+ *
468
526
  * @param oldId ID of variable to rename.
469
527
  * @param newId ID of new variable. May be the same as oldId, but with an
470
528
  * updated name.
@@ -472,18 +530,21 @@ export declare class Block implements IASTNodeLocation, IDeletable {
472
530
  renameVarById(oldId: string, newId: string): void;
473
531
  /**
474
532
  * Returns the language-neutral value of the given field.
533
+ *
475
534
  * @param name The name of the field.
476
- * @return Value of the field or null if field does not exist.
535
+ * @returns Value of the field or null if field does not exist.
477
536
  */
478
537
  getFieldValue(name: string): any;
479
538
  /**
480
539
  * Sets the value of the given field for this block.
540
+ *
481
541
  * @param newValue The value to set.
482
542
  * @param name The name of the field to set the value of.
483
543
  */
484
544
  setFieldValue(newValue: any, name: string): void;
485
545
  /**
486
546
  * Set whether this block can chain onto the bottom of another block.
547
+ *
487
548
  * @param newBoolean True if there can be a previous statement.
488
549
  * @param opt_check Statement type or list of statement types. Null/undefined
489
550
  * if any type could be connected.
@@ -491,6 +552,7 @@ export declare class Block implements IASTNodeLocation, IDeletable {
491
552
  setPreviousStatement(newBoolean: boolean, opt_check?: string | string[] | null): void;
492
553
  /**
493
554
  * Set whether another block can chain onto the bottom of this block.
555
+ *
494
556
  * @param newBoolean True if there can be a next statement.
495
557
  * @param opt_check Statement type or list of statement types. Null/undefined
496
558
  * if any type could be connected.
@@ -498,6 +560,7 @@ export declare class Block implements IASTNodeLocation, IDeletable {
498
560
  setNextStatement(newBoolean: boolean, opt_check?: string | string[] | null): void;
499
561
  /**
500
562
  * Set whether this block returns a value.
563
+ *
501
564
  * @param newBoolean True if there is an output.
502
565
  * @param opt_check Returned type or list of returned types. Null or
503
566
  * undefined if any type could be returned (e.g. variable get).
@@ -505,93 +568,109 @@ export declare class Block implements IASTNodeLocation, IDeletable {
505
568
  setOutput(newBoolean: boolean, opt_check?: string | string[] | null): void;
506
569
  /**
507
570
  * Set whether value inputs are arranged horizontally or vertically.
571
+ *
508
572
  * @param newBoolean True if inputs are horizontal.
509
573
  */
510
574
  setInputsInline(newBoolean: boolean): void;
511
575
  /**
512
576
  * Get whether value inputs are arranged horizontally or vertically.
513
- * @return True if inputs are horizontal.
577
+ *
578
+ * @returns True if inputs are horizontal.
514
579
  */
515
580
  getInputsInline(): boolean;
516
581
  /**
517
582
  * Set the block's output shape.
583
+ *
518
584
  * @param outputShape Value representing an output shape.
519
585
  */
520
586
  setOutputShape(outputShape: number | null): void;
521
587
  /**
522
588
  * Get the block's output shape.
523
- * @return Value representing output shape if one exists.
589
+ *
590
+ * @returns Value representing output shape if one exists.
524
591
  */
525
592
  getOutputShape(): number | null;
526
593
  /**
527
594
  * Get whether this block is enabled or not.
528
- * @return True if enabled.
595
+ *
596
+ * @returns True if enabled.
529
597
  */
530
598
  isEnabled(): boolean;
531
599
  /**
532
600
  * Set whether the block is enabled or not.
601
+ *
533
602
  * @param enabled True if enabled.
534
603
  */
535
604
  setEnabled(enabled: boolean): void;
536
605
  /**
537
606
  * Get whether the block is disabled or not due to parents.
538
607
  * The block's own disabled property is not considered.
539
- * @return True if disabled.
608
+ *
609
+ * @returns True if disabled.
540
610
  */
541
611
  getInheritedDisabled(): boolean;
542
612
  /**
543
613
  * Get whether the block is collapsed or not.
544
- * @return True if collapsed.
614
+ *
615
+ * @returns True if collapsed.
545
616
  */
546
617
  isCollapsed(): boolean;
547
618
  /**
548
619
  * Set whether the block is collapsed or not.
620
+ *
549
621
  * @param collapsed True if collapsed.
550
622
  */
551
623
  setCollapsed(collapsed: boolean): void;
552
624
  /**
553
625
  * Create a human-readable text representation of this block and any children.
626
+ *
554
627
  * @param opt_maxLength Truncate the string to this length.
555
628
  * @param opt_emptyToken The placeholder string used to denote an empty field.
556
629
  * If not specified, '?' is used.
557
- * @return Text of block.
630
+ * @returns Text of block.
558
631
  */
559
632
  toString(opt_maxLength?: number, opt_emptyToken?: string): string;
560
633
  /**
561
634
  * Shortcut for appending a value input row.
635
+ *
562
636
  * @param name Language-neutral identifier which may used to find this input
563
637
  * again. Should be unique to this block.
564
- * @return The input object created.
638
+ * @returns The input object created.
565
639
  */
566
640
  appendValueInput(name: string): Input;
567
641
  /**
568
642
  * Shortcut for appending a statement input row.
643
+ *
569
644
  * @param name Language-neutral identifier which may used to find this input
570
645
  * again. Should be unique to this block.
571
- * @return The input object created.
646
+ * @returns The input object created.
572
647
  */
573
648
  appendStatementInput(name: string): Input;
574
649
  /**
575
650
  * Shortcut for appending a dummy input row.
651
+ *
576
652
  * @param opt_name Language-neutral identifier which may used to find this
577
653
  * input again. Should be unique to this block.
578
- * @return The input object created.
654
+ * @returns The input object created.
579
655
  */
580
656
  appendDummyInput(opt_name?: string): Input;
581
657
  /**
582
658
  * Initialize this block using a cross-platform, internationalization-friendly
583
659
  * JSON description.
660
+ *
584
661
  * @param json Structured data describing the block.
585
662
  */
586
663
  jsonInit(json: any): void;
587
664
  /**
588
665
  * Initialize the colour of this block from the JSON description.
666
+ *
589
667
  * @param json Structured data describing the block.
590
668
  * @param warningPrefix Warning prefix string identifying block.
591
669
  */
592
670
  private jsonInitColour_;
593
671
  /**
594
672
  * Initialize the style of this block from the JSON description.
673
+ *
595
674
  * @param json Structured data describing the block.
596
675
  * @param warningPrefix Warning prefix string identifying block.
597
676
  */
@@ -602,12 +681,14 @@ export declare class Block implements IASTNodeLocation, IDeletable {
602
681
  * the block, including prototype values. This provides some insurance against
603
682
  * mixin / extension incompatibilities with future block features. This check
604
683
  * can be disabled by passing true as the second argument.
684
+ *
605
685
  * @param mixinObj The key/values pairs to add to this block object.
606
686
  * @param opt_disableCheck Option flag to disable overwrite checks.
607
687
  */
608
688
  mixin(mixinObj: any, opt_disableCheck?: boolean): void;
609
689
  /**
610
690
  * Interpolate a message description onto the block.
691
+ *
611
692
  * @param message Text contains interpolation tokens (%1, %2, ...) that match
612
693
  * with fields or inputs defined in the args array.
613
694
  * @param args Array of arguments to be interpolated.
@@ -620,6 +701,7 @@ export declare class Block implements IASTNodeLocation, IDeletable {
620
701
  * Validates that the tokens are within the correct bounds, with no
621
702
  * duplicates, and that all of the arguments are referred to. Throws errors if
622
703
  * any of these things are not true.
704
+ *
623
705
  * @param tokens An array of tokens to validate
624
706
  * @param argsCount The number of args that need to be referred to.
625
707
  */
@@ -628,55 +710,62 @@ export declare class Block implements IASTNodeLocation, IDeletable {
628
710
  * Inserts args in place of numerical tokens. String args are converted to
629
711
  * JSON that defines a label field. If necessary an extra dummy input is added
630
712
  * to the end of the elements.
713
+ *
631
714
  * @param tokens The tokens to interpolate
632
715
  * @param args The arguments to insert.
633
716
  * @param lastDummyAlign The alignment the added dummy input should have, if
634
717
  * we are required to add one.
635
- * @return The JSON definitions of field and inputs to add to the block.
718
+ * @returns The JSON definitions of field and inputs to add to the block.
636
719
  */
637
720
  private interpolateArguments_;
638
721
  /**
639
722
  * Creates a field from the JSON definition of a field. If a field with the
640
723
  * given type cannot be found, this attempts to create a different field using
641
724
  * the 'alt' property of the JSON definition (if it exists).
725
+ *
642
726
  * @param element The element to try to turn into a field.
643
- * @return The field defined by the JSON, or null if one couldn't be created.
727
+ * @returns The field defined by the JSON, or null if one couldn't be created.
644
728
  */
645
729
  private fieldFromJson_;
646
730
  /**
647
731
  * Creates an input from the JSON definition of an input. Sets the input's
648
732
  * check and alignment if they are provided.
733
+ *
649
734
  * @param element The JSON to turn into an input.
650
735
  * @param warningPrefix The prefix to add to warnings to help the developer
651
736
  * debug.
652
- * @return The input that has been created, or null if one could not be
737
+ * @returns The input that has been created, or null if one could not be
653
738
  * created for some reason (should never happen).
654
739
  */
655
740
  private inputFromJson_;
656
741
  /**
657
742
  * Returns true if the given string matches one of the input keywords.
743
+ *
658
744
  * @param str The string to check.
659
- * @return True if the given string matches one of the input keywords, false
745
+ * @returns True if the given string matches one of the input keywords, false
660
746
  * otherwise.
661
747
  */
662
748
  private isInputKeyword_;
663
749
  /**
664
750
  * Turns a string into the JSON definition of a label field. If the string
665
751
  * becomes an empty string when trimmed, this returns null.
752
+ *
666
753
  * @param str String to turn into the JSON definition of a label field.
667
- * @return The JSON definition or null.
754
+ * @returns The JSON definition or null.
668
755
  */
669
756
  private stringToFieldJson_;
670
757
  /**
671
758
  * Add a value input, statement input or local variable to this block.
759
+ *
672
760
  * @param type One of Blockly.inputTypes.
673
761
  * @param name Language-neutral identifier which may used to find this input
674
762
  * again. Should be unique to this block.
675
- * @return The input object created.
763
+ * @returns The input object created.
676
764
  */
677
765
  protected appendInput_(type: number, name: string): Input;
678
766
  /**
679
767
  * Move a named input to a different location on this block.
768
+ *
680
769
  * @param name The name of the input to move.
681
770
  * @param refName Name of input that should be after the moved input, or null
682
771
  * to be the input at the end.
@@ -684,44 +773,51 @@ export declare class Block implements IASTNodeLocation, IDeletable {
684
773
  moveInputBefore(name: string, refName: string | null): void;
685
774
  /**
686
775
  * Move a numbered input to a different location on this block.
776
+ *
687
777
  * @param inputIndex Index of the input to move.
688
778
  * @param refIndex Index of input that should be after the moved input.
689
779
  */
690
780
  moveNumberedInputBefore(inputIndex: number, refIndex: number): void;
691
781
  /**
692
782
  * Remove an input from this block.
783
+ *
693
784
  * @param name The name of the input.
694
785
  * @param opt_quiet True to prevent an error if input is not present.
695
- * @return True if operation succeeds, false if input is not present and
786
+ * @returns True if operation succeeds, false if input is not present and
696
787
  * opt_quiet is true.
697
788
  * @throws {Error} if the input is not present and opt_quiet is not true.
698
789
  */
699
790
  removeInput(name: string, opt_quiet?: boolean): boolean;
700
791
  /**
701
792
  * Fetches the named input object.
793
+ *
702
794
  * @param name The name of the input.
703
- * @return The input object, or null if input does not exist.
795
+ * @returns The input object, or null if input does not exist.
704
796
  */
705
797
  getInput(name: string): Input | null;
706
798
  /**
707
799
  * Fetches the block attached to the named input.
800
+ *
708
801
  * @param name The name of the input.
709
- * @return The attached value block, or null if the input is either
802
+ * @returns The attached value block, or null if the input is either
710
803
  * disconnected or if the input does not exist.
711
804
  */
712
805
  getInputTargetBlock(name: string): Block | null;
713
806
  /**
714
807
  * Returns the comment on this block (or null if there is no comment).
715
- * @return Block's comment.
808
+ *
809
+ * @returns Block's comment.
716
810
  */
717
811
  getCommentText(): string | null;
718
812
  /**
719
813
  * Set this block's comment text.
814
+ *
720
815
  * @param text The text, or null to delete.
721
816
  */
722
817
  setCommentText(text: string | null): void;
723
818
  /**
724
819
  * Set this block's warning text.
820
+ *
725
821
  * @param _text The text, or null to delete.
726
822
  * @param _opt_id An optional ID for the warning text to be able to maintain
727
823
  * multiple warnings.
@@ -729,33 +825,38 @@ export declare class Block implements IASTNodeLocation, IDeletable {
729
825
  setWarningText(_text: string | null, _opt_id?: string): void;
730
826
  /**
731
827
  * Give this block a mutator dialog.
828
+ *
732
829
  * @param _mutator A mutator dialog instance or null to remove.
733
830
  */
734
831
  setMutator(_mutator: Mutator): void;
735
832
  /**
736
833
  * Return the coordinates of the top-left corner of this block relative to the
737
834
  * drawing surface's origin (0,0), in workspace units.
738
- * @return Object with .x and .y properties.
835
+ *
836
+ * @returns Object with .x and .y properties.
739
837
  */
740
838
  getRelativeToSurfaceXY(): Coordinate;
741
839
  /**
742
840
  * Move a block by a relative offset.
841
+ *
743
842
  * @param dx Horizontal offset, in workspace units.
744
843
  * @param dy Vertical offset, in workspace units.
745
844
  */
746
845
  moveBy(dx: number, dy: number): void;
747
846
  /**
748
847
  * Create a connection of the specified type.
848
+ *
749
849
  * @param type The type of the connection to create.
750
- * @return A new connection of the specified type.
850
+ * @returns A new connection of the specified type.
751
851
  */
752
852
  protected makeConnection_(type: number): Connection;
753
853
  /**
754
854
  * Recursively checks whether all statement and value inputs are filled with
755
855
  * blocks. Also checks all following statement blocks in this stack.
856
+ *
756
857
  * @param opt_shadowBlocksAreFilled An optional argument controlling whether
757
858
  * shadow blocks are counted as filled. Defaults to true.
758
- * @return True if all inputs are filled, false otherwise.
859
+ * @returns True if all inputs are filled, false otherwise.
759
860
  */
760
861
  allInputsFilled(opt_shadowBlocksAreFilled?: boolean): boolean;
761
862
  /**
@@ -765,7 +866,8 @@ export declare class Block implements IASTNodeLocation, IDeletable {
765
866
  * Intended to on be used in console logs and errors. If you need a string
766
867
  * that uses the user's native language (including block text, field values,
767
868
  * and child blocks), use [toString()]{@link Block#toString}.
768
- * @return The description.
869
+ *
870
+ * @returns The description.
769
871
  */
770
872
  toDevString(): string;
771
873
  }
@@ -777,3 +879,4 @@ export declare namespace Block {
777
879
  }
778
880
  }
779
881
  export declare type CommentModel = Block.CommentModel;
882
+ //# sourceMappingURL=block.d.ts.map