refactor(build): Preparation for building TypeScript (#6205)

* chore(deps): Update closure/goog/base.js, add goog.js

  - Update base.js from the latest version (20220502.0.0).
  - Also copy over goog.js, which provides access to a suitable subset
    of goog.* via an importable module).

* chore(build): Split gulpfiles/config.js exports object

  This makes it possible for entries to depend on each other.

* chore(build): build config consistency

  - Reorder entries in gulpfiles.config.js to better match order they
    are used.
  - Have update_metadata.sh reference config.js and vice versa.

* refactor(build): Move deps.js (+ deps.mocha.js) from test/ to build/

  Once we start using tsc, deps.js will be created based on the ouptut
  of tsc rather than the raw source in core/.  Since tsc will need to
  be run before running closure-make-deps and also before trying to
  load blockly_uncompressed.js, it doesn't really make sense to check
  in deps.js; it's better to re-create as needed.

  To reduce inconvenience, a new "prepare" script is added to
  package.json which will run the buildDeps gulp target automaticaly
  when one runs npm install.

* refactor(build): Always build from TypeScript sources

  - Add buildJavaScript gulp task to use tsc to compile any .ts files
    in core/ into build/src/core/ (and also copy any .js files that
    are not yet migrated to TypeScript, which for now is all of them.
  - Remove closure/goog from explicit inputs to tsc; it will find
    the files it needs (e.g., goog.js) automatically.
  - Have buildDeps, the playground, and all the tests that run in
    uncompiled mode use build/src/core/ instead of core/ as their
    input directory.

* feat(build): Add buildJavaScriptAndDeps gulp task

  Have npm run build:deps (and npm run prepare) use a new gulp task,
  buildJavaScriptAndDeps, to run tsc followed by closure-make-deps,
  ensuring that deps.js is calculated based on the most recent code
  in core/.

* fix(build): Fix implementation of flattenCorePaths

  Even though this function is going away I want to remove it in
  a separate PR so that we can revert easily if desired.  But the
  previous checked-in code was totally wrong.  This version works.

* fix(build): Don't let checkinBuilt copy build/src/**

  Now that we are putting a lot more stuff in build/ (specifically,
  all the tsc output in build/src/), modify checkinBuilt so that it
  only copies the specific things we want to check in (for now):

  - _compressed.js build artifacts and their accompanying .js.maps
  - the generated build/msg/js/*.js language files.

  Unrelatedly, also fix safety-quoting of arguments for one execSync
  call.

scripts/gulpfiles/build_tasks.js

@@ -25,13 +25,18 @@ var closureDeps = require('google-closure-deps');
 var argv = require('yargs').argv;
 var rimraf = require('rimraf');
 
-var {BUILD_DIR, TSC_OUTPUT_DIR} = require('./config');
+var {BUILD_DIR, DEPS_FILE, TEST_DEPS_FILE, TSC_OUTPUT_DIR} = require('./config');
 var {getPackageJson} = require('./helper_tasks');
 
 ////////////////////////////////////////////////////////////
 //                        Build                           //
 ////////////////////////////////////////////////////////////
 
+/**
+ * Directory in which core/ can be found after passing through tsc.
+ */
+const CORE_DIR = path.join(TSC_OUTPUT_DIR, 'core');
+
 /**
  * Suffix to add to compiled output files.
  */
@@ -98,7 +103,7 @@ const NAMESPACE_PROPERTY = '__namespace__';
 const chunks = [
   {
     name: 'blockly',
-    entry: 'core/blockly.js',
+    entry: path.join(CORE_DIR, 'blockly.js'),
     reexport: 'Blockly',
   },
   {
@@ -246,20 +251,30 @@ var JSCOMP_OFF = [
 ];
 
 /**
- * This task updates tests/deps.js, used by blockly_uncompressed.js
- * when loading Blockly in uncompiled mode.
+ * Builds Blockly as a JS program, by running tsc on all the files in
+ * the core directory.  This must be run before buildDeps or
+ * buildCompiled.
+ */
+function buildJavaScript(done) {
+  execSync(`tsc -outDir "${TSC_OUTPUT_DIR}"`, {stdio: 'inherit'});
+  done();
+}
+
+/**
+ * This task updates DEPS_FILE (deps.js), used by
+ * blockly_uncompressed.js when loading Blockly in uncompiled mode.
  *
- * Also updates tests/deps.mocha.js, used by the mocha test suite.
+ * Also updates TEST_DEPS_FILE (deps.mocha.js), used by the mocha test
+ * suite.
  */
 function buildDeps(done) {
   const closurePath = argv.closureLibrary ?
       'node_modules/google-closure-library/closure/goog' :
       'closure/goog';
 
-  const coreDir = argv.compileTs ? path.join(TSC_OUTPUT_DIR, 'core') : 'core';
   const roots = [
     closurePath,
-    coreDir,
+    TSC_OUTPUT_DIR,
     'blocks',
     'generators',
   ];
@@ -270,12 +285,13 @@ function buildDeps(done) {
   ];
 
   const args = roots.map(root => `--root '${root}' `).join('');
-  execSync(`closure-make-deps ${args} > tests/deps.js`, {stdio: 'inherit'});
+  execSync(`closure-make-deps ${args} > '${DEPS_FILE}'`,
+           {stdio: 'inherit'});
 
   // Use grep to filter out the entries that are already in deps.js.
   const testArgs = testRoots.map(root => `--root '${root}' `).join('');
-  execSync(`closure-make-deps ${testArgs} | grep 'tests/mocha'` +
-      ' > tests/deps.mocha.js', {stdio: 'inherit'});
+  execSync(`closure-make-deps ${testArgs} | grep 'tests/mocha' ` +
+      `> '${TEST_DEPS_FILE}'`, {stdio: 'inherit'});
   done();
 };
 
@@ -422,7 +438,7 @@ function getChunkOptions() {
   }
   const cccArgs = [
     '--closure-library-base-js-path ./closure/goog/base_minimal.js',
-    '--deps-file ./tests/deps.js',
+    `--deps-file './${DEPS_FILE}'`,
     ...(chunks.map(chunk => `--entrypoint '${chunk.entry}'`)),
   ];
   const cccCommand = `closure-calculate-chunks ${cccArgs.join(' ')}`;
@@ -462,8 +478,8 @@ function getChunkOptions() {
   //     /* ... remaining handful of chunks */
   //   ],
   //   js: [
-  //     './core/serialization/workspaces.js',
-  //     './core/serialization/variables.js',
+  //     './build/ts/core/serialization/workspaces.js',
+  //     './build/ts/core/serialization/variables.js',
   //     /* ... remaining several hundred files */
   //   ],
   // }
@@ -533,12 +549,12 @@ const pathSepRegExp = new RegExp(path.sep.replace(/\\/, '\\\\'), "g");
  *     callback.  Modified in place.
  */
 function flattenCorePaths(pathObject) {
-  const dirs = pathObject.dirname.split(path.sep);
-  const coreIndex = argv.compileTs ? 2 : 0;
-  if (dirs[coreIndex] === 'core') {
-    pathObject.dirname = path.join(...dirs.slice(0, coreIndex + 1));
+  if (!pathObject.dirname.startsWith(CORE_DIR)) return;
+  const subdir = pathObject.dirname.slice(CORE_DIR.length + 1);
+  if (subdir) {
+    pathObject.dirname = CORE_DIR;
     pathObject.basename =
-        dirs.slice(coreIndex + 1).concat(pathObject.basename).join('-slash-');
+        (subdir + '/' + pathObject.basename).replace(/\//g, '-slash-');
   }
 }
 
@@ -662,7 +678,7 @@ function buildAdvancedCompilationTest() {
  *     test/deps*.js
  */
 const build = gulp.parallel(
-    gulp.series(buildDeps, buildCompiled),
+    gulp.series(buildJavaScript, buildDeps, buildCompiled),
     buildLangfiles,
     );
 
@@ -672,11 +688,10 @@ const build = gulp.parallel(
  */
 function checkinBuilt() {
   return gulp.src([
-    `${BUILD_DIR}/**.js`,
-    `${BUILD_DIR}/**.js.map`,
-    `${BUILD_DIR}/**/**.js`,
-    `${BUILD_DIR}/**/**.js.map`,
-  ]).pipe(gulp.dest('.'));
+    `${BUILD_DIR}/*_compressed.js`,
+    `${BUILD_DIR}/*_compressed.js.map`,
+    `${BUILD_DIR}/msg/js/*.js`,
+  ], {base: BUILD_DIR}).pipe(gulp.dest('.'));
 };
 
 /**
@@ -699,13 +714,9 @@ function format() {
       .pipe(gulp.dest('.'));
 };
 
-function buildTypescript(done) {
-  execSync('npx tsc', {stdio: 'inherit'});
-  done();
-}
-
 module.exports = {
   build: build,
+  javaScript: buildJavaScript,
   deps: buildDeps,
   generateLangfiles: generateLangfiles,
   langfiles: buildLangfiles,
@@ -714,5 +725,4 @@ module.exports = {
   checkinBuilt: checkinBuilt,
   cleanBuildDir: cleanBuildDir,
   advancedCompilationTest: buildAdvancedCompilationTest,
-  buildTypescript: buildTypescript
 }

scripts/gulpfiles/chunks.json

@@ -9,265 +9,265 @@
     "all4:11:blockly"
   ],
   "js": [
-    "./core/inject.js",
-    "./core/flyout_vertical.js",
-    "./core/toolbox/toolbox.js",
-    "./core/interfaces/i_styleable.js",
-    "./core/flyout_horizontal.js",
-    "./core/generator.js",
-    "./core/flyout_base.js",
-    "./core/flyout_metrics_manager.js",
-    "./core/field_variable.js",
-    "./core/field_number.js",
-    "./core/field_multilineinput.js",
-    "./core/field_label_serializable.js",
-    "./core/field_colour.js",
-    "./core/field_checkbox.js",
-    "./core/field_angle.js",
-    "./core/toolbox/collapsible_category.js",
-    "./core/renderers/zelos/zelos.js",
-    "./core/renderers/thrasos/renderer.js",
-    "./core/renderers/thrasos/info.js",
-    "./core/renderers/thrasos/thrasos.js",
-    "./core/serialization/workspaces.js",
-    "./core/serialization/variables.js",
-    "./core/renderers/minimalist/renderer.js",
-    "./core/renderers/minimalist/info.js",
-    "./core/renderers/minimalist/drawer.js",
-    "./core/renderers/minimalist/constants.js",
-    "./core/renderers/minimalist/minimalist.js",
-    "./core/renderers/geras/measurables/statement_input.js",
-    "./core/renderers/geras/path_object.js",
-    "./core/renderers/geras/renderer.js",
-    "./core/renderers/geras/info.js",
-    "./core/renderers/geras/measurables/inline_input.js",
-    "./core/renderers/geras/highlight_constants.js",
-    "./core/renderers/geras/highlighter.js",
-    "./core/renderers/geras/drawer.js",
-    "./core/renderers/geras/constants.js",
-    "./core/renderers/geras/geras.js",
-    "./core/theme/zelos.js",
-    "./core/theme/themes.js",
-    "./core/shortcut_items.js",
-    "./core/events/workspace_events.js",
-    "./core/events/events_toolbox_item_select.js",
-    "./core/events/events_ui.js",
-    "./core/events/events.js",
-    "./core/contextmenu_items.js",
-    "./core/widgetdiv.js",
-    "./core/clipboard.js",
-    "./core/contextmenu.js",
-    "./core/utils/useragent.js",
-    "./core/utils/svg.js",
-    "./core/utils/dom.js",
-    "./core/utils/idgenerator.js",
-    "./core/connection_checker.js",
-    "./core/toolbox/separator.js",
-    "./core/toolbox/toolbox_item.js",
-    "./core/interfaces/i_selectable_toolbox_item.js",
-    "./core/interfaces/i_collapsible_toolbox_item.js",
-    "./core/toolbox/category.js",
-    "./core/serialization/exceptions.js",
-    "./core/interfaces/i_serializer.js",
-    "./core/serialization/registry.js",
-    "./core/serialization/priorities.js",
-    "./core/serialization/blocks.js",
-    "./core/utils/toolbox.js",
-    "./core/utils/math.js",
-    "./core/utils/array.js",
-    "./core/workspace.js",
-    "./core/menu.js",
-    "./core/menuitem.js",
-    "./core/keyboard_nav/basic_cursor.js",
-    "./core/keyboard_nav/tab_navigate_cursor.js",
-    "./core/mutator.js",
-    "./core/warning.js",
-    "./core/comment.js",
-    "./core/events/events_block_drag.js",
-    "./core/events/events_block_move.js",
-    "./core/bump_objects.js",
-    "./core/block_dragger.js",
-    "./core/workspace_dragger.js",
-    "./core/interfaces/i_block_dragger.js",
-    "./core/events/events_viewport.js",
-    "./core/events/events_theme_change.js",
-    "./core/events/events_block_create.js",
-    "./core/events/events_click.js",
-    "./core/zoom_controls.js",
-    "./core/workspace_drag_surface_svg.js",
-    "./core/events/events_selected.js",
-    "./core/events/events_comment_delete.js",
-    "./core/events/events_comment_change.js",
-    "./core/workspace_comment.js",
-    "./core/events/events_comment_create.js",
-    "./core/events/events_comment_base.js",
-    "./core/events/events_comment_move.js",
-    "./core/workspace_comment_svg.js",
-    "./core/workspace_audio.js",
-    "./core/events/events_trashcan_open.js",
-    "./core/sprites.js",
-    "./core/drag_target.js",
-    "./core/delete_area.js",
-    "./core/events/events_block_delete.js",
-    "./core/positionable_helpers.js",
-    "./core/trashcan.js",
-    "./core/touch_gesture.js",
-    "./core/theme_manager.js",
-    "./core/scrollbar_pair.js",
-    "./core/options.js",
-    "./core/interfaces/i_movable.js",
-    "./core/interfaces/i_selectable.js",
-    "./core/interfaces/i_copyable.js",
-    "./core/interfaces/i_bounded_element.js",
-    "./core/grid.js",
-    "./core/css.js",
-    "./core/flyout_button.js",
-    "./core/contextmenu_registry.js",
-    "./core/theme/classic.js",
-    "./core/blockly_options.js",
-    "./core/utils.js",
-    "./core/renderers/zelos/measurables/top_row.js",
-    "./core/renderers/zelos/measurables/row_elements.js",
-    "./core/renderers/zelos/marker_svg.js",
-    "./core/renderers/zelos/measurables/inputs.js",
-    "./core/renderers/zelos/drawer.js",
-    "./core/renderers/zelos/renderer.js",
-    "./core/renderers/zelos/path_object.js",
-    "./core/field_textinput.js",
-    "./core/field_image.js",
-    "./core/renderers/zelos/constants.js",
-    "./core/renderers/zelos/measurables/bottom_row.js",
-    "./core/renderers/zelos/info.js",
-    "./core/renderers/measurables/top_row.js",
-    "./core/renderers/measurables/square_corner.js",
-    "./core/renderers/measurables/spacer_row.js",
-    "./core/renderers/measurables/round_corner.js",
-    "./core/renderers/common/path_object.js",
-    "./core/interfaces/i_positionable.js",
-    "./core/interfaces/i_drag_target.js",
-    "./core/interfaces/i_delete_area.js",
-    "./core/interfaces/i_component.js",
-    "./core/interfaces/i_autohideable.js",
-    "./core/component_manager.js",
-    "./core/insertion_marker_manager.js",
-    "./core/renderers/common/i_path_object.js",
-    "./core/renderers/common/drawer.js",
-    "./core/renderers/common/renderer.js",
-    "./core/renderers/measurables/previous_connection.js",
-    "./core/renderers/measurables/output_connection.js",
-    "./core/renderers/measurables/jagged_edge.js",
-    "./core/renderers/measurables/statement_input.js",
-    "./core/renderers/measurables/input_row.js",
-    "./core/renderers/measurables/inline_input.js",
-    "./core/scrollbar.js",
-    "./core/interfaces/i_toolbox_item.js",
-    "./core/interfaces/i_toolbox.js",
-    "./core/utils/metrics.js",
-    "./core/interfaces/i_metrics_manager.js",
-    "./core/interfaces/i_flyout.js",
-    "./core/metrics_manager.js",
-    "./core/interfaces/i_deletable.js",
-    "./core/interfaces/i_draggable.js",
-    "./core/interfaces/i_contextmenu.js",
-    "./core/interfaces/i_bubble.js",
-    "./core/block_drag_surface.js",
-    "./core/bubble.js",
-    "./core/icon.js",
-    "./core/renderers/measurables/icon.js",
-    "./core/renderers/measurables/hat.js",
-    "./core/renderers/measurables/external_value_input.js",
-    "./core/renderers/common/info.js",
-    "./core/renderers/measurables/field.js",
-    "./core/renderers/common/debugger.js",
-    "./core/renderers/measurables/input_connection.js",
-    "./core/renderers/measurables/in_row_spacer.js",
-    "./core/renderers/measurables/row.js",
-    "./core/renderers/measurables/types.js",
-    "./core/renderers/measurables/base.js",
-    "./core/renderers/measurables/connection.js",
-    "./core/renderers/measurables/next_connection.js",
-    "./core/renderers/measurables/bottom_row.js",
-    "./core/renderers/common/debug.js",
-    "./core/renderers/common/block_rendering.js",
-    "./core/variables_dynamic.js",
-    "./core/events/events_var_rename.js",
-    "./core/events/events_var_delete.js",
-    "./core/variable_map.js",
-    "./core/names.js",
-    "./core/events/events_block_base.js",
-    "./core/events/events_block_change.js",
-    "./core/events/events_marker_move.js",
-    "./core/renderers/common/marker_svg.js",
-    "./core/keyboard_nav/marker.js",
-    "./core/keyboard_nav/ast_node.js",
-    "./core/keyboard_nav/cursor.js",
-    "./core/marker_manager.js",
-    "./core/utils/sentinel.js",
-    "./core/field_label.js",
-    "./core/input_types.js",
-    "./core/interfaces/i_registrable_field.js",
-    "./core/field_registry.js",
-    "./core/input.js",
-    "./core/interfaces/i_registrable.js",
-    "./core/utils/keycodes.js",
-    "./core/shortcut_registry.js",
-    "./core/interfaces/i_keyboard_accessible.js",
-    "./core/interfaces/i_ast_node_location_with_block.js",
-    "./core/interfaces/i_ast_node_location.js",
-    "./core/interfaces/i_ast_node_location_svg.js",
-    "./core/theme.js",
-    "./core/constants.js",
-    "./core/interfaces/i_connection_checker.js",
-    "./core/connection_db.js",
-    "./core/config.js",
-    "./core/rendered_connection.js",
-    "./core/utils/svg_paths.js",
-    "./core/renderers/common/constants.js",
-    "./core/field.js",
-    "./core/events/events_ui_base.js",
-    "./core/events/events_bubble_open.js",
-    "./core/procedures.js",
-    "./core/workspace_svg.js",
-    "./core/utils/svg_math.js",
-    "./core/bubble_dragger.js",
-    "./core/connection_type.js",
-    "./core/internal_constants.js",
-    "./core/block_animations.js",
-    "./core/gesture.js",
-    "./core/touch.js",
-    "./core/browser_events.js",
-    "./core/tooltip.js",
-    "./core/block_svg.js",
-    "./core/utils/size.js",
-    "./core/utils/rect.js",
-    "./core/utils/coordinate.js",
-    "./core/utils/style.js",
-    "./core/dropdowndiv.js",
-    "./core/utils/aria.js",
-    "./core/field_dropdown.js",
-    "./core/msg.js",
-    "./core/utils/colour.js",
-    "./core/utils/parsing.js",
-    "./core/extensions.js",
-    "./core/block.js",
-    "./core/utils/deprecation.js",
-    "./core/utils/string.js",
-    "./core/dialog.js",
-    "./core/utils/xml.js",
-    "./core/events/events_var_base.js",
-    "./core/events/events_var_create.js",
-    "./core/variable_model.js",
-    "./core/variables.js",
-    "./core/utils/object.js",
-    "./core/events/events_abstract.js",
-    "./core/registry.js",
-    "./core/events/utils.js",
-    "./core/xml.js",
-    "./core/connection.js",
-    "./core/common.js",
-    "./core/blocks.js",
+    "./build/src/core/inject.js",
+    "./build/src/core/flyout_vertical.js",
+    "./build/src/core/toolbox/toolbox.js",
+    "./build/src/core/interfaces/i_styleable.js",
+    "./build/src/core/flyout_horizontal.js",
+    "./build/src/core/generator.js",
+    "./build/src/core/flyout_base.js",
+    "./build/src/core/flyout_metrics_manager.js",
+    "./build/src/core/field_variable.js",
+    "./build/src/core/field_number.js",
+    "./build/src/core/field_multilineinput.js",
+    "./build/src/core/field_label_serializable.js",
+    "./build/src/core/field_colour.js",
+    "./build/src/core/field_checkbox.js",
+    "./build/src/core/field_angle.js",
+    "./build/src/core/toolbox/collapsible_category.js",
+    "./build/src/core/renderers/zelos/zelos.js",
+    "./build/src/core/renderers/thrasos/renderer.js",
+    "./build/src/core/renderers/thrasos/info.js",
+    "./build/src/core/renderers/thrasos/thrasos.js",
+    "./build/src/core/serialization/workspaces.js",
+    "./build/src/core/serialization/variables.js",
+    "./build/src/core/renderers/minimalist/renderer.js",
+    "./build/src/core/renderers/minimalist/info.js",
+    "./build/src/core/renderers/minimalist/drawer.js",
+    "./build/src/core/renderers/minimalist/constants.js",
+    "./build/src/core/renderers/minimalist/minimalist.js",
+    "./build/src/core/renderers/geras/measurables/statement_input.js",
+    "./build/src/core/renderers/geras/path_object.js",
+    "./build/src/core/renderers/geras/renderer.js",
+    "./build/src/core/renderers/geras/info.js",
+    "./build/src/core/renderers/geras/measurables/inline_input.js",
+    "./build/src/core/renderers/geras/highlight_constants.js",
+    "./build/src/core/renderers/geras/highlighter.js",
+    "./build/src/core/renderers/geras/drawer.js",
+    "./build/src/core/renderers/geras/constants.js",
+    "./build/src/core/renderers/geras/geras.js",
+    "./build/src/core/theme/zelos.js",
+    "./build/src/core/theme/themes.js",
+    "./build/src/core/shortcut_items.js",
+    "./build/src/core/events/workspace_events.js",
+    "./build/src/core/events/events_toolbox_item_select.js",
+    "./build/src/core/events/events_ui.js",
+    "./build/src/core/events/events.js",
+    "./build/src/core/contextmenu_items.js",
+    "./build/src/core/widgetdiv.js",
+    "./build/src/core/clipboard.js",
+    "./build/src/core/contextmenu.js",
+    "./build/src/core/utils/useragent.js",
+    "./build/src/core/utils/svg.js",
+    "./build/src/core/utils/dom.js",
+    "./build/src/core/utils/idgenerator.js",
+    "./build/src/core/connection_checker.js",
+    "./build/src/core/toolbox/separator.js",
+    "./build/src/core/toolbox/toolbox_item.js",
+    "./build/src/core/interfaces/i_selectable_toolbox_item.js",
+    "./build/src/core/interfaces/i_collapsible_toolbox_item.js",
+    "./build/src/core/toolbox/category.js",
+    "./build/src/core/serialization/exceptions.js",
+    "./build/src/core/interfaces/i_serializer.js",
+    "./build/src/core/serialization/registry.js",
+    "./build/src/core/serialization/priorities.js",
+    "./build/src/core/serialization/blocks.js",
+    "./build/src/core/utils/toolbox.js",
+    "./build/src/core/utils/math.js",
+    "./build/src/core/utils/array.js",
+    "./build/src/core/workspace.js",
+    "./build/src/core/menu.js",
+    "./build/src/core/menuitem.js",
+    "./build/src/core/keyboard_nav/basic_cursor.js",
+    "./build/src/core/keyboard_nav/tab_navigate_cursor.js",
+    "./build/src/core/mutator.js",
+    "./build/src/core/warning.js",
+    "./build/src/core/comment.js",
+    "./build/src/core/events/events_block_drag.js",
+    "./build/src/core/events/events_block_move.js",
+    "./build/src/core/bump_objects.js",
+    "./build/src/core/block_dragger.js",
+    "./build/src/core/workspace_dragger.js",
+    "./build/src/core/interfaces/i_block_dragger.js",
+    "./build/src/core/events/events_viewport.js",
+    "./build/src/core/events/events_theme_change.js",
+    "./build/src/core/events/events_block_create.js",
+    "./build/src/core/events/events_click.js",
+    "./build/src/core/zoom_controls.js",
+    "./build/src/core/workspace_drag_surface_svg.js",
+    "./build/src/core/events/events_selected.js",
+    "./build/src/core/events/events_comment_delete.js",
+    "./build/src/core/events/events_comment_change.js",
+    "./build/src/core/workspace_comment.js",
+    "./build/src/core/events/events_comment_create.js",
+    "./build/src/core/events/events_comment_base.js",
+    "./build/src/core/events/events_comment_move.js",
+    "./build/src/core/workspace_comment_svg.js",
+    "./build/src/core/workspace_audio.js",
+    "./build/src/core/events/events_trashcan_open.js",
+    "./build/src/core/sprites.js",
+    "./build/src/core/drag_target.js",
+    "./build/src/core/delete_area.js",
+    "./build/src/core/events/events_block_delete.js",
+    "./build/src/core/positionable_helpers.js",
+    "./build/src/core/trashcan.js",
+    "./build/src/core/touch_gesture.js",
+    "./build/src/core/theme_manager.js",
+    "./build/src/core/scrollbar_pair.js",
+    "./build/src/core/options.js",
+    "./build/src/core/interfaces/i_movable.js",
+    "./build/src/core/interfaces/i_selectable.js",
+    "./build/src/core/interfaces/i_copyable.js",
+    "./build/src/core/interfaces/i_bounded_element.js",
+    "./build/src/core/grid.js",
+    "./build/src/core/css.js",
+    "./build/src/core/flyout_button.js",
+    "./build/src/core/contextmenu_registry.js",
+    "./build/src/core/theme/classic.js",
+    "./build/src/core/blockly_options.js",
+    "./build/src/core/utils.js",
+    "./build/src/core/renderers/zelos/measurables/top_row.js",
+    "./build/src/core/renderers/zelos/measurables/row_elements.js",
+    "./build/src/core/renderers/zelos/marker_svg.js",
+    "./build/src/core/renderers/zelos/measurables/inputs.js",
+    "./build/src/core/renderers/zelos/drawer.js",
+    "./build/src/core/renderers/zelos/renderer.js",
+    "./build/src/core/renderers/zelos/path_object.js",
+    "./build/src/core/field_textinput.js",
+    "./build/src/core/field_image.js",
+    "./build/src/core/renderers/zelos/constants.js",
+    "./build/src/core/renderers/zelos/measurables/bottom_row.js",
+    "./build/src/core/renderers/zelos/info.js",
+    "./build/src/core/renderers/measurables/top_row.js",
+    "./build/src/core/renderers/measurables/square_corner.js",
+    "./build/src/core/renderers/measurables/spacer_row.js",
+    "./build/src/core/renderers/measurables/round_corner.js",
+    "./build/src/core/renderers/common/path_object.js",
+    "./build/src/core/interfaces/i_positionable.js",
+    "./build/src/core/interfaces/i_drag_target.js",
+    "./build/src/core/interfaces/i_delete_area.js",
+    "./build/src/core/interfaces/i_component.js",
+    "./build/src/core/interfaces/i_autohideable.js",
+    "./build/src/core/component_manager.js",
+    "./build/src/core/insertion_marker_manager.js",
+    "./build/src/core/renderers/common/i_path_object.js",
+    "./build/src/core/renderers/common/drawer.js",
+    "./build/src/core/renderers/common/renderer.js",
+    "./build/src/core/renderers/measurables/previous_connection.js",
+    "./build/src/core/renderers/measurables/output_connection.js",
+    "./build/src/core/renderers/measurables/jagged_edge.js",
+    "./build/src/core/renderers/measurables/statement_input.js",
+    "./build/src/core/renderers/measurables/input_row.js",
+    "./build/src/core/renderers/measurables/inline_input.js",
+    "./build/src/core/scrollbar.js",
+    "./build/src/core/interfaces/i_toolbox_item.js",
+    "./build/src/core/interfaces/i_toolbox.js",
+    "./build/src/core/utils/metrics.js",
+    "./build/src/core/interfaces/i_metrics_manager.js",
+    "./build/src/core/interfaces/i_flyout.js",
+    "./build/src/core/metrics_manager.js",
+    "./build/src/core/interfaces/i_deletable.js",
+    "./build/src/core/interfaces/i_draggable.js",
+    "./build/src/core/interfaces/i_contextmenu.js",
+    "./build/src/core/interfaces/i_bubble.js",
+    "./build/src/core/block_drag_surface.js",
+    "./build/src/core/bubble.js",
+    "./build/src/core/icon.js",
+    "./build/src/core/renderers/measurables/icon.js",
+    "./build/src/core/renderers/measurables/hat.js",
+    "./build/src/core/renderers/measurables/external_value_input.js",
+    "./build/src/core/renderers/common/info.js",
+    "./build/src/core/renderers/measurables/field.js",
+    "./build/src/core/renderers/common/debugger.js",
+    "./build/src/core/renderers/measurables/input_connection.js",
+    "./build/src/core/renderers/measurables/in_row_spacer.js",
+    "./build/src/core/renderers/measurables/row.js",
+    "./build/src/core/renderers/measurables/types.js",
+    "./build/src/core/renderers/measurables/base.js",
+    "./build/src/core/renderers/measurables/connection.js",
+    "./build/src/core/renderers/measurables/next_connection.js",
+    "./build/src/core/renderers/measurables/bottom_row.js",
+    "./build/src/core/renderers/common/debug.js",
+    "./build/src/core/renderers/common/block_rendering.js",
+    "./build/src/core/variables_dynamic.js",
+    "./build/src/core/events/events_var_rename.js",
+    "./build/src/core/events/events_var_delete.js",
+    "./build/src/core/variable_map.js",
+    "./build/src/core/names.js",
+    "./build/src/core/events/events_block_base.js",
+    "./build/src/core/events/events_block_change.js",
+    "./build/src/core/events/events_marker_move.js",
+    "./build/src/core/renderers/common/marker_svg.js",
+    "./build/src/core/keyboard_nav/marker.js",
+    "./build/src/core/keyboard_nav/ast_node.js",
+    "./build/src/core/keyboard_nav/cursor.js",
+    "./build/src/core/marker_manager.js",
+    "./build/src/core/utils/sentinel.js",
+    "./build/src/core/field_label.js",
+    "./build/src/core/input_types.js",
+    "./build/src/core/interfaces/i_registrable_field.js",
+    "./build/src/core/field_registry.js",
+    "./build/src/core/input.js",
+    "./build/src/core/interfaces/i_registrable.js",
+    "./build/src/core/utils/keycodes.js",
+    "./build/src/core/shortcut_registry.js",
+    "./build/src/core/interfaces/i_keyboard_accessible.js",
+    "./build/src/core/interfaces/i_ast_node_location_with_block.js",
+    "./build/src/core/interfaces/i_ast_node_location.js",
+    "./build/src/core/interfaces/i_ast_node_location_svg.js",
+    "./build/src/core/theme.js",
+    "./build/src/core/constants.js",
+    "./build/src/core/interfaces/i_connection_checker.js",
+    "./build/src/core/connection_db.js",
+    "./build/src/core/config.js",
+    "./build/src/core/rendered_connection.js",
+    "./build/src/core/utils/svg_paths.js",
+    "./build/src/core/renderers/common/constants.js",
+    "./build/src/core/field.js",
+    "./build/src/core/events/events_ui_base.js",
+    "./build/src/core/events/events_bubble_open.js",
+    "./build/src/core/procedures.js",
+    "./build/src/core/workspace_svg.js",
+    "./build/src/core/utils/svg_math.js",
+    "./build/src/core/bubble_dragger.js",
+    "./build/src/core/connection_type.js",
+    "./build/src/core/internal_constants.js",
+    "./build/src/core/block_animations.js",
+    "./build/src/core/gesture.js",
+    "./build/src/core/touch.js",
+    "./build/src/core/browser_events.js",
+    "./build/src/core/tooltip.js",
+    "./build/src/core/block_svg.js",
+    "./build/src/core/utils/size.js",
+    "./build/src/core/utils/rect.js",
+    "./build/src/core/utils/coordinate.js",
+    "./build/src/core/utils/style.js",
+    "./build/src/core/dropdowndiv.js",
+    "./build/src/core/utils/aria.js",
+    "./build/src/core/field_dropdown.js",
+    "./build/src/core/msg.js",
+    "./build/src/core/utils/colour.js",
+    "./build/src/core/utils/parsing.js",
+    "./build/src/core/extensions.js",
+    "./build/src/core/block.js",
+    "./build/src/core/utils/deprecation.js",
+    "./build/src/core/utils/string.js",
+    "./build/src/core/dialog.js",
+    "./build/src/core/utils/xml.js",
+    "./build/src/core/events/events_var_base.js",
+    "./build/src/core/events/events_var_create.js",
+    "./build/src/core/variable_model.js",
+    "./build/src/core/variables.js",
+    "./build/src/core/utils/object.js",
+    "./build/src/core/events/events_abstract.js",
+    "./build/src/core/registry.js",
+    "./build/src/core/events/utils.js",
+    "./build/src/core/xml.js",
+    "./build/src/core/connection.js",
+    "./build/src/core/common.js",
+    "./build/src/core/blocks.js",
     "./closure/goog/base_minimal.js",
-    "./core/blockly.js",
+    "./build/src/core/blockly.js",
     "./blocks/variables_dynamic.js",
     "./blocks/variables.js",
     "./blocks/text.js",

scripts/gulpfiles/config.js

@@ -18,18 +18,27 @@ var path = require('path');
 //
 // - tests/scripts/compile_typings.sh
 // - tests/scripts/check_metadata.sh
-module.exports = {
-  // Directory to write compiled output to.
-  BUILD_DIR: 'build',
+// - tests/scripts/update_metadata.sh
+// - blockly_uncompressed.js (for location of deps.js)
+// - tests/playgrounds/prepare.js (for location of deps.js)
+// - tests/mocha/index.html (for location of deps.mocha.js)
 
-  // Directory in which to assemble (and from which to publish) the
-  // blockly npm package.
-  RELEASE_DIR: 'dist',
+// Directory to write compiled output to.
+exports.BUILD_DIR = 'build';
 
-  // Directory to write typings output to.
-  TYPINGS_BUILD_DIR: path.join('build', 'typings'),
+// Dependencies file (for blockly_uncompressed.js):
+exports.DEPS_FILE = path.join(exports.BUILD_DIR, 'deps.js');
 
-  // Directory where typescript compiler output can be found.
-  // Matches the value in tsconfig.json: outDir
-  TSC_OUTPUT_DIR: path.join('build', 'ts'),
-};
+// Dependencies file (for blockly_uncompressed.js):
+exports.TEST_DEPS_FILE = path.join(exports.BUILD_DIR, 'deps.mocha.js');
+
+// Directory to write typings output to.
+exports.TYPINGS_BUILD_DIR = path.join(exports.BUILD_DIR, 'typings');
+
+// Directory where typescript compiler output can be found.
+// Matches the value in tsconfig.json: outDir
+exports.TSC_OUTPUT_DIR = path.join(exports.BUILD_DIR, 'src');
+
+// Directory in which to assemble (and from which to publish) the
+// blockly npm package.
+exports.RELEASE_DIR = 'dist';