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

@@ -39,7 +39,7 @@ import {
   syncMaster,
   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,
@@ -88,6 +88,7 @@ export {
   buildAdvancedCompilationTest,
   createRC as gitCreateRC,
   docs,
+  typings,
 }
 
 // Legacy targets, to be deleted.

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.');
 }