Highlights
- Blockly core is now in TypeScript! If you use TypeScript, you should notice better type declarations for Blockly. There may still be some rough edges; please tell us about them or submit a fix.
- Blockly is transpiled to ES2015, no longer ES5. ES2015 is supported by all major browsers.
- Blockly is no longer guaranteed to be compatible with Internet Explorer, and some IE workarounds have been removed.
- If you're using modules, the way you import generators has changed. See the generators documentation for more information.
Migration
To help deal with breaking changes from this release:
- Run
npx @blockly/migrate rename --from <your version> <./path/to/my/files*> - Run
npx @blockly/migrate fix-imports --from <your version> <./path/to/my/files*>
These commands will automatically modify your files so that they are compatible with version 9. The first command will automatically rename properties that have been renamed. And the second command will add/fix imports for blocks/generators that have been moved.
Some problems may still exist after running the migration scripts, but the majority of them should be fixed!
What's Changed
⚠ BREAKING CHANGES
Most are removing deprecated, unused, or outdated APIs. Each of the PRs listed below has information about what to do if you are affected by the change.
- Update deprecations for the new release. (#6470)
- remove unused functions in style.ts (#6386)
- Removed backwards compatibility for getDeveloperVars(). (#6385)
- remove checks for IE and EdgeHTML in core (#6336)
- allow blocks to receive their own delete events (#6337)
- build: compile to ES2015 instead of ES5 (#6335)
- Move backwards-compatibility hacks to main.js (#6260)
- Remove remaining use of
goog.module.declareLegacyNamespace. (#6254) - properly add the removal of utils.global to the renamings file. (#6204)
- fix or silence type errors (#6105)
- Correctly handle multiple highlighted RenderedConnections (#6416)
Deprecating Changes
These are changes which deprecate an API but do not remove it. APIs in this category will be removed at a future time. Each of the following PRs should provide guidance on an alternative.
- Fix blocks with mutators (#6440)
- stop using
is3dSupported(#6400) - remove some IE-specific code in dom and style (#6396)
- deprecate functions in object.ts (#6387)
- remove AnyDuringMigration from the block drag surface (#6302)
Features
- Add margin around zoomToFit (#6042) (a202558)
- allow blocks to receive their own delete events (#6337) (e9920a5)
- build: Support TypeScript in
core/(#6220) (4070ffc) - creates a new way to add shortcut key mappings (#6122) (adb5ad1)
- make isMutator public (#6316) (8f4b49a)
- return element from menu.render (#6426) (e3fa43d)
- updates accessors for getMainWorkspace and getSelected (#6313) (fd127f6)
Bug Fixes
- add compose and decompose to block (#6102) (619ee66)
- add timeouts to delay expensive mutation operations (#6149) (91b570a)
- adding and removing css classes that contained spaces (#6455) (8530e6d)
- build: Fix sourcemaps (#6352) (e10bf99)
- build: Have prepare task signal async completion (#6356) (079699b)
- Check for empty array in thrasos.RenderInfo.addElemSpacing_ (#6211) (16b5ccd)
- component id should be on the prototype (#6104) (172a8ce)
- context menu not working (#6399) (79051a6)
- Deep copy options used by dropdown fields (#6425) (05b221b)
- deprecate functions in object.ts (#6387) (9775b51)
- disposing of a workspace that has overwritten shadows (#6424) (f2e408b)
- dragging fails for collapsed blocks with Icons, which have been … (#6081) (5240301)
- field defaults not being defined correctly (#6453) (eb1b786)
- Fix blocks with mutators. (#6440) (ab03c65)
- Fix compilation errors under Closure's strict mode (#6073) (edc2a5c)
- fix message loading from script tags (#6060) (44edbb8)
- fix or silence type errors (#6105) (daf78af)
- generator type declarations (#6412) (b2fa356)
- improve types in touch code (#6099) (7c7cfbe)
- Increases the speed of deleting blocks (#6128) (71e8356)
- inject function options dictionary has wrong type definition (#6231) (233cce8)
- JSON deserialization fails (bug #6091) (collapsed procedure call… (#6103) (45c36f8)
- json hooks for lists blocks not needing extra state (#6177) (8b69b61)
- json serialize lists_getIndex with json extraState (#6136) (#6170) (0afff23)
- loading messages from script tags. (#6184) (2a7d6b0)
- Made workspace non-nullable. (#6300) (83a3e74)
- make eventUtils throw if event type not registered (#6381) (60bc01a)
- Make generator types and BlockDefinition less restrictive (#6185) (2ff4f88)
- Make message files work in unpackaged mode, and rebuild msg files (4b1bb8c)
- message types being incorrect (#6414) (9c81e75)
- Modifying size update handling for multiline field in parent block. (#6461) (2a2cbb4)
- Move backwards-compatibility hacks to main.js (#6260) (aaafbc2)
- mutators disconnecting from children instead of moving them (#6047) (493444c)
- options parser should add trailing slash to 'media' if not present. (#6263) (#6264) (bf1a40c)
- packaging .d.ts files (#6327) (c8dd01a)
- path object not checking theme props (#6451) (893787b)
- provide initial values to reduce functions in generated js (#6178) (706c2bf)
- remove calls to removeClass and hasClass (#6413) (5f11f34)
- remove checks for IE and EdgeHTML in core (#6336) (ffe6d55)
- Remove float() coercion in Python loops (#6259) (5612e13)
- remove some IE-specific code in dom and style (#6396) (a785ab8)
- remove unused functions in style.ts (#6386) (856e74d)
- remove unused or obsolete useragent checks (#6355) (aff21b9)
- remove vestigial dependency (#6219) (334956b)
- replace
object.mixinwithObject.assign(#6138) (df41c23) - reuse the 'bumpObjects' module in inject.js (#6121) (df8349c)
- Silence Closure errors when modifying tooltips. (#6098) (29b6b87)
- some AnyDuringMigration (#6430) (c2cbed1)
- stop using
is3dSupported(#6400) (55ea12b) - tests: Fix race condition causing flakiness in PHP generator test (#6213) (d7ab815)
- tests: revert change in marker_svg to keep keyboard nav tests working (#6457) (dd0d0f6)
- theme types (#6423) (abad51f)
- Theme.name does not match registered name (#6186) (#6226) (9797943)
- TS errors on dependent projects with certain tsconfig settings (#6360) (#6361) (e58cf77)
- type error in uneditable bubbles (#6092) (7353c61)
- Update deprecations for the new release. (#6470) (d3447ea)
- update extraState property in serializer typedefs (#6057) (55cae6e)
- update prettify url (#6459) (852e48a)
- Update readme and remove travis build badge (e65835c)
- Update typescript definition files for core, blocks, and generators (#6174) (87aa4c0)
Miscellaneous Chores
- build: compile to ES2015 instead of ES5 (#6335) (f032151)
- properly add the removal of utils.global to the renamings file. (#6204) (2f734f7)
Code Refactoring
- Remove remaining use of
goog.module.declareLegacyNamespace. (#6254) (f947b3f) - Removed backwards compatibility for getDeveloperVars(). (#6385) (3bc42c5)
New Contributors
- @tweini made their first contribution in #6081
- @derwehr made their first contribution in #6138
- @RomarQ made their first contribution in #6121
- @gregdyke made their first contribution in #6170
- @Zauzolkov made their first contribution in #6211
- @andyanday33 made their first contribution in #6231
- @ktbytechibong made their first contribution in #6361
- @btw17 made their first contribution in #6363
Full Changelog: blockly-v8.0.5...blockly-v9.0.0