chore(docs): generate just typings for docs build Workflow

ie. no need to build the entire Blockly package, with Closure compiler, just for the docs

Author: grega

.github/workflows/deploy-docusaurus.yml

@@ -51,10 +51,10 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
-      - name: Build Blockly and generate reference docs
+      - name: Generate reference docs
         working-directory: ./packages/blockly
         run: |
-          npm run package
+          npx gulp typings
           npm run docs
 
       - name: Build the Docusaurus site

packages/blockly/gulpfile.mjs

@@ -34,7 +34,11 @@ import {
 } from './scripts/gulpfiles/build_tasks.mjs';
 import {docs} from './scripts/gulpfiles/docs_tasks.mjs';
 import {updateGithubPages} from './scripts/gulpfiles/git_tasks.mjs';
-import {cleanReleaseDir, pack} from './scripts/gulpfiles/package_tasks.mjs';
+import {
+  cleanReleaseDir,
+  pack,
+  typings,
+} from './scripts/gulpfiles/package_tasks.mjs';
 import {publish, publishBeta} from './scripts/gulpfiles/release_tasks.mjs';
 import {
   generators,
@@ -78,4 +82,5 @@ export {
   interactiveMocha,
   buildAdvancedCompilationTest,
   docs,
+  typings,
 }

packages/blockly/scripts/gulpfiles/package_tasks.mjs

@@ -240,6 +240,11 @@ export function cleanReleaseDir() {
  *
  * Prerequisite: build.
  */
+export const typings = gulp.series(
+    gulp.parallel(build.cleanBuildDir, cleanReleaseDir),
+    build.tsc,
+    packageDTS);
+
 export const pack = gulp.series(
     gulp.parallel(
         build.cleanBuildDir,

packages/docs/sidebars.js

@@ -2,7 +2,7 @@
 
 let referenceSidebar = [];
 try {
-  ({ referenceSidebar } = await import('./docs/reference/_reference.js'));
+  referenceSidebar = require('./docs/reference/_reference.js').referenceSidebar;
 } catch {
   console.warn('Reference sidebar not found — run "npm run docs" in packages/blockly to generate it.');
 }