Add tsclibrary.d.ts

Author: jakebailey

.github/fabricbot.json

@@ -642,7 +642,8 @@
               "parameters": {
                 "pathFilters": [
                   "tests/baselines/reference/api/typescript.d.ts",
-                  "tests/baselines/reference/api/tsserverlibrary.d.ts"
+                  "tests/baselines/reference/api/tsserverlibrary.d.ts",
+                  "tests/baselines/reference/api/tsclibrary.d.ts"
                 ]
               }
             }

.github/workflows/new-release-branch.yaml

@@ -28,6 +28,7 @@ jobs:
         sed -i -e 's/const versionMajorMinor = ".*"/const versionMajorMinor = "${{ github.event.client_payload.core_major_minor }}"/g' src/compiler/corePublic.ts
         sed -i -e 's/const versionMajorMinor = ".*"/const versionMajorMinor = "${{ github.event.client_payload.core_major_minor }}"/g' tests/baselines/reference/api/typescript.d.ts
         sed -i -e 's/const versionMajorMinor = ".*"/const versionMajorMinor = "${{ github.event.client_payload.core_major_minor }}"/g' tests/baselines/reference/api/tsserverlibrary.d.ts
+        sed -i -e 's/const versionMajorMinor = ".*"/const versionMajorMinor = "${{ github.event.client_payload.core_major_minor }}"/g' tests/baselines/reference/api/tsclibrary.d.ts
         sed -i -e 's/const version\(: string\)\{0,1\} = `${versionMajorMinor}.0-.*`/const version = `${versionMajorMinor}.0-${{ github.event.client_payload.core_tag || 'dev' }}`/g' src/compiler/corePublic.ts
         npm ci
         npx hereby LKG
@@ -37,6 +38,7 @@ jobs:
         git add src/compiler/corePublic.ts
         git add tests/baselines/reference/api/typescript.d.ts
         git add tests/baselines/reference/api/tsserverlibrary.d.ts
+        git add tests/baselines/reference/api/tsclibrary.d.ts
         git add --force ./lib
         git config user.email "[email protected]"
         git config user.name "TypeScript Bot"

.github/workflows/set-version.yaml

@@ -34,6 +34,7 @@ jobs:
         sed -i -e 's/const versionMajorMinor = ".*"/const versionMajorMinor = "${{ github.event.client_payload.core_major_minor }}"/g' src/compiler/corePublic.ts
         sed -i -e 's/const versionMajorMinor = ".*"/const versionMajorMinor = "${{ github.event.client_payload.core_major_minor }}"/g' tests/baselines/reference/api/typescript.d.ts
         sed -i -e 's/const versionMajorMinor = ".*"/const versionMajorMinor = "${{ github.event.client_payload.core_major_minor }}"/g' tests/baselines/reference/api/tsserverlibrary.d.ts
+        sed -i -e 's/const versionMajorMinor = ".*"/const versionMajorMinor = "${{ github.event.client_payload.core_major_minor }}"/g' tests/baselines/reference/api/tsclibrary.d.ts
         sed -i -e 's/const version\(: string\)\{0,1\} = .*;/const version = "${{ github.event.client_payload.package_version }}" as string;/g' src/compiler/corePublic.ts
         npm ci
         npx hereby LKG
@@ -43,6 +44,7 @@ jobs:
         git add src/compiler/corePublic.ts
         git add tests/baselines/reference/api/typescript.d.ts
         git add tests/baselines/reference/api/tsserverlibrary.d.ts
+        git add tests/baselines/reference/api/tsclibrary.d.ts
         git add --force ./lib
         git config user.email "[email protected]"
         git config user.name "TypeScript Bot"

Herebyfile.mjs

@@ -338,7 +338,7 @@ function entrypointBuildTask(options) {
 }
 
 
-const { main: tsc, watch: watchTsc } = entrypointBuildTask({
+const { main: tsc, build: buildTsc, watch: watchTsc } = entrypointBuildTask({
     name: "tsc",
     description: "Builds the command-line compiler",
     buildDeps: [generateDiagnostics],
@@ -428,9 +428,20 @@ export const dtsLssl = task({
     }
 });
 
+export const dtsTsc = task({
+    name: "dts-tsc",
+    description: "Bundles tsclibrary.d.ts",
+    dependencies: [buildTsc],
+    run: async () => {
+        if (needsUpdate("./built/local/tsc/tsconfig.tsbuildinfo", ["./built/local/tsclibrary.d.ts", "./built/local/tsclibrary.internal.d.ts"])) {
+            await runDtsBundler("./built/local/tsc/_namespaces/ts.d.ts", "./built/local/tsclibrary.d.ts");
+        }
+    }
+});
+
 export const dts = task({
     name: "dts",
-    dependencies: [dtsServices, dtsLssl],
+    dependencies: [dtsServices, dtsLssl, dtsTsc],
 });
 
 
@@ -820,6 +831,7 @@ export const produceLKG = task({
             "built/local/tsserver.js",
             "built/local/tsserverlibrary.js",
             "built/local/tsserverlibrary.d.ts",
+            "built/local/tsclibrary.d.ts",
             "built/local/typescript.js",
             "built/local/typescript.d.ts",
             "built/local/typingsInstaller.js",

scripts/produceLKG.mjs

@@ -54,6 +54,7 @@ async function copyScriptOutputs() {
 async function copyDeclarationOutputs() {
     await copyFromBuiltLocal("tsserverlibrary.d.ts");
     await copyFromBuiltLocal("typescript.d.ts");
+    await copyFromBuiltLocal("tsclibrary.d.ts");
 }
 
 async function writeGitAttributes() {

src/executeCommandLine/executeCommandLine.ts

@@ -87,6 +87,7 @@ import {
     validateLocaleAndSetLanguage,
     version,
     WatchCompilerHost,
+    WatchOfConfigFile,
     WatchOptions,
 } from "./_namespaces/ts";
 
@@ -744,7 +745,7 @@ export function executeCommandLine(
     system: System,
     cb: ExecuteCommandLineCallbacks,
     commandLineArgs: readonly string[],
-) {
+): void | WatchOfConfigFile<EmitAndSemanticDiagnosticsBuilderProgram> | SolutionBuilder<EmitAndSemanticDiagnosticsBuilderProgram> {
     if (isBuild(commandLineArgs)) {
         const { buildOptions, watchOptions, projects, errors } = parseBuildCommand(commandLineArgs.slice(1));
         if (buildOptions.generateCpuProfile && system.enableCPUProfiler) {

src/testRunner/unittests/publicApi.ts

@@ -43,6 +43,10 @@ describe("unittests:: Public APIs", () => {
     describe("for the language server", () => {
         verifyApi("tsserverlibrary.d.ts");
     });
+
+    describe("for the tsc", () => {
+        verifyApi("tsclibrary.d.ts");
+    });
 });
 
 describe("unittests:: Public APIs:: token to string", () => {

tests/baselines/reference/APILibCheck.js

@@ -24,11 +24,25 @@
     "types": "/.ts/tsserverlibrary.internal.d.ts"
 }
 
+//// [package.json]
+{
+    "name": "tsclibrary",
+    "types": "/.ts/tsclibrary.d.ts"
+}
+
+//// [package.json]
+{
+    "name": "tsclibrary-internal",
+    "types": "/.ts/tsclibrary.internal.d.ts"
+}
+
 //// [index.ts]
 import ts = require("typescript");
 import tsInternal = require("typescript-internal");
 import tsserverlibrary = require("tsserverlibrary");
 import tsserverlibraryInternal = require("tsserverlibrary-internal");
+import tsclibrary = require("tsclibrary");
+import tsclibraryInternal = require("tsclibrary-internal");
 
 
 //// [index.js]

tests/baselines/reference/APILibCheck.symbols

@@ -11,3 +11,9 @@ import tsserverlibrary = require("tsserverlibrary");
 import tsserverlibraryInternal = require("tsserverlibrary-internal");
 >tsserverlibraryInternal : Symbol(tsserverlibraryInternal, Decl(index.ts, 2, 52))
 
+import tsclibrary = require("tsclibrary");
+>tsclibrary : Symbol(tsclibrary, Decl(index.ts, 3, 69))
+
+import tsclibraryInternal = require("tsclibrary-internal");
+>tsclibraryInternal : Symbol(tsclibraryInternal, Decl(index.ts, 4, 42))
+

tests/baselines/reference/APILibCheck.types

@@ -11,3 +11,9 @@ import tsserverlibrary = require("tsserverlibrary");
 import tsserverlibraryInternal = require("tsserverlibrary-internal");
 >tsserverlibraryInternal : typeof tsserverlibraryInternal
 
+import tsclibrary = require("tsclibrary");
+>tsclibrary : typeof tsclibrary
+
+import tsclibraryInternal = require("tsclibrary-internal");
+>tsclibraryInternal : typeof tsclibraryInternal
+