Build types in core-math and core-utils with tsc

packages/core-math/.gitignore

@@ -1,5 +1,6 @@
 index.js
 index.d.ts
+index.tsc.d.ts
 Build
 Specs/SpecList.js
 docs

packages/core-math/Source/Cartesian2.js

@@ -1,6 +1,9 @@
 import { Check, defined, DeveloperError } from "@cesium/core-utils";
 import CesiumMath from "./Math.js";
 
+/** @ignore @typedef {import('./Cartesian3.js')} Cartesian3 */
+/** @ignore @typedef {import('./Cartesian4.js')} Cartesian4 */
+
 /**
  * A 2D Cartesian point.
  * @alias Cartesian2

packages/core-math/Source/Cartesian4.js

@@ -1,6 +1,8 @@
 import { Check, defined, DeveloperError } from "@cesium/core-utils";
 import CesiumMath from "./Math.js";
 
+/** @ignore @typedef {import('@cesium/engine').Color} Color */
+
 /**
  * A 4D Cartesian point.
  * @alias Cartesian4

packages/core-math/Source/Matrix4.js

@@ -10,6 +10,10 @@ import {
 import CesiumMath from "./Math.js";
 import Matrix3 from "./Matrix3.js";
 
+/** @ignore @typedef {import('@cesium/engine').Camera} Camera */
+/** @ignore @typedef {import('@cesium/engine').TranslationRotationScale} TranslationRotationScale */
+/** @ignore @typedef {import('@cesium/engine').Quaternion} Quaternion */
+
 /**
  * A 4x4 matrix, indexable as a column-major order array.
  * Constructor parameters are in row-major order for code readability.

packages/core-math/package.json

@@ -37,6 +37,7 @@
   "scripts": {
     "build": "gulp build --workspace @cesium/core-math",
     "build-ts": "gulp buildTs --workspace @cesium/core-math",
+    "build-tsc": "tsc --checkJs false",
     "coverage": "gulp coverage --workspace @cesium/core-math",
     "test": "gulp test --workspace @cesium/core-math",
     "postversion": "gulp postversion --workspace @cesium/core-math",

packages/core-math/tsconfig.json

@@ -1,14 +1,20 @@
 {
-  "include": ["index.js", "Source/**/*.js"],
+  "include": ["Source/**/*.js"],
   "compilerOptions": {
     // module configuration
     "moduleResolution": "bundler",
     "module": "ES2022",
     "target": "ES2022",
 
     // i/o
-    "noEmit": true,
+    "declaration": true,
+    "declarationDir": "Build/Types",
+    "emitDeclarationOnly": true,
     "allowJs": true,
-    "checkJs": true
+    "checkJs": true,
+
+    // ignore type definitions in other modules for now, we need types
+    // to be correct and to resolve imports first.
+    "skipLibCheck": true
   }
 }

packages/core-utils/.gitignore

@@ -1,5 +1,6 @@
 index.js
 index.d.ts
+index.tsc.d.ts
 Build
 Specs/SpecList.js
 docs

packages/core-utils/package.json

@@ -35,6 +35,7 @@
   "scripts": {
     "build": "gulp build --workspace @cesium/core-utils",
     "build-ts": "gulp buildTs --workspace @cesium/core-utils",
+    "build-tsc": "tsc --checkJs false",
     "build-docs": "typedoc ./index.js --skipErrorChecking",
     "coverage": "gulp coverage --workspace @cesium/core-utils",
     "test": "gulp test --workspace @cesium/core-utils",

packages/core-utils/tsconfig.json

@@ -1,14 +1,20 @@
 {
-  "include": ["index.js", "Source/**/*.js"],
+  "include": ["Source/**/*.js"],
   "compilerOptions": {
     // module configuration
     "moduleResolution": "bundler",
     "module": "ES2022",
     "target": "ES2022",
 
     // i/o
-    "noEmit": true,
+    "declaration": true,
+    "declarationDir": "Build/Types",
+    "emitDeclarationOnly": true,
     "allowJs": true,
-    "checkJs": true
+    "checkJs": true,
+
+    // ignore type definitions in other modules for now, we need types
+    // to be correct and to resolve imports first.
+    "skipLibCheck": true
   }
 }

scripts/build.js

@@ -916,6 +916,7 @@ export async function bundleTestWorkers(options) {
 export async function createIndexJs(workspace) {
   const version = await getVersion();
   let contents = `globalThis.CESIUM_VERSION = "${version}";\n`;
+  let contentsDts = "";
 
   // Re-export core-utils and core-math types for backwards compatibility in engine package
   if (workspace === "engine") {
@@ -937,6 +938,7 @@ export async function createIndexJs(workspace) {
 
     let moduleId = file;
     moduleId = filePathToModuleId(moduleId);
+    const moduleTypesId = moduleId.replace("Source", "Build/Types");
 
     // Rename shader files, such that ViewportQuadFS.glsl is exported as _shadersViewportQuadFS in JS.
 
@@ -946,6 +948,7 @@ export async function createIndexJs(workspace) {
     }
     assignmentName = assignmentName.replace(/(\.|-)/g, "_");
     contents += `export { default as ${assignmentName} } from './${moduleId}.js';${EOL}`;
+    contentsDts += `export { default as ${assignmentName} } from './${moduleTypesId}.js';${EOL}`;
 
     // TODO(donmccurdy): Why is this needed?
     if (assignmentName === "Math") {
@@ -957,6 +960,12 @@ export async function createIndexJs(workspace) {
     encoding: "utf-8",
   });
 
+  if (workspace === "core-math" || workspace === "core-utils") {
+    await writeFile(`packages/${workspace}/index.tsc.d.ts`, contentsDts, {
+      encoding: "utf-8",
+    });
+  }
+
   return contents;
 }