[rush] Support deep references to internal Apis (#4825)

* feat: support deep references to internal api

* rush change

* update exports

* update exports

* update exports

* update exports

* chore: update exports

* feat: rush-sdk build test for runtime import issue

---------

Co-authored-by: qun <[email protected]>
Co-authored-by: Cheng Liu <[email protected]>

Author: L-Qun

build-tests-subspace/rush-sdk-test/config/heft.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/heft/v0/heft.schema.json",
+
+  "extends": "local-node-rig/profiles/default/config/heft.json",
+
+  "phasesByName": {
+    "build": {
+      "tasksByName": {
+        "run-start": {
+          "taskDependencies": ["typescript"],
+          "taskPlugin": {
+            "pluginPackage": "@rushstack/heft",
+            "pluginName": "run-script-plugin",
+            "options": {
+              "scriptPath": "./lib/run-start.js"
+            }
+          }
+        }
+      }
+    }
+  }
+}

build-tests-subspace/rush-sdk-test/src/run-start.ts

@@ -0,0 +1,6 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+
+export async function runAsync(): Promise<void> {
+  await import('./start.js');
+}

build-tests-subspace/rush-sdk-test/src/start.ts

@@ -7,7 +7,7 @@ console.log('rush-sdk-test loading Rush configuration...');
 
 // Important: Since we're calling an internal API, we need to use the unbundled .d.ts files
 // instead of the normal .d.ts rollup
-import { RushConfiguration } from '@rushstack/rush-sdk/lib/';
+import { RushConfiguration } from '@rushstack/rush-sdk/lib/index';
 
 const config: RushConfiguration = RushConfiguration.loadFromDefaultLocation();
 console.log(config.commonFolder);

common/changes/@microsoft/rush/fix-deep-reference-to-internal-api_2024-07-05-09-42.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@microsoft/rush",
+      "comment": "Support deep references to internal Apis",
+      "type": "none"
+    }
+  ],
+  "packageName": "@microsoft/rush"
+}

libraries/rush-sdk/package.json

@@ -11,8 +11,18 @@
   "main": "lib-shim/index.js",
   "typings": "dist/rush-lib.d.ts",
   "exports": {
-    ".": "./lib-shim/index.js",
-    "./loader": "./lib-shim/loader.js"
+    ".": {
+      "types": "./dist/rush-lib.d.ts",
+      "default": "./lib-shim/index.js"
+    },
+    "./loader": {
+      "types": "./dist/loader.d.ts",
+      "default": "./lib-shim/loader.js"
+    },
+    "./lib/*": {
+      "types": "./lib/*.d.ts",
+      "default": "./lib/*.js"
+    }
   },
   "typesVersions": {
     "*": {