[@rushstack/heft-config-file] Replace node structuredClone

common/changes/@rushstack/heft-config-file/chore-replace-node-structuredclone_2025-04-24-03-50.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@rushstack/heft-config-file",
+      "comment": "Fix Node 16 compatibility by using non-built-in structuredClone",
+      "type": "patch"
+    }
+  ],
+  "packageName": "@rushstack/heft-config-file"
+}

common/config/rush/browser-approved-packages.json

@@ -46,6 +46,10 @@
       "name": "@rushstack/rush-vscode-command-webview",
       "allowedCategories": [ "vscode-extensions" ]
     },
+    {
+      "name": "@ungap/structured-clone",
+      "allowedCategories": [ "libraries" ]
+    },
     {
       "name": "axios",
       "allowedCategories": [ "libraries" ]

common/config/subspaces/build-tests-subspace/repo-state.json

@@ -1,6 +1,6 @@
 // DO NOT MODIFY THIS FILE MANUALLY BUT DO COMMIT IT. It is generated and used by Rush.
 {
-  "pnpmShrinkwrapHash": "d9e805ea30f80e290b5d5ea83856c8b5d7302941",
+  "pnpmShrinkwrapHash": "e47112c7d099f189f37770e10351e406cf1ec451",
   "preferredVersionsHash": "54149ea3f01558a859c96dee2052b797d4defe68",
-  "packageJsonInjectedDependenciesHash": "949bb6038c34cb0580b82a6f728b26a66fff3177"
+  "packageJsonInjectedDependenciesHash": "a1277b20787fa46cb118a7352d5ca6a922a1098b"
 }

common/config/subspaces/default/repo-state.json

@@ -1,5 +1,5 @@
 // DO NOT MODIFY THIS FILE MANUALLY BUT DO COMMIT IT. It is generated and used by Rush.
 {
-  "pnpmShrinkwrapHash": "1cd4f5444a9d6a085d5418372291de283264d9fb",
+  "pnpmShrinkwrapHash": "cff3c4ef9a27a2377b9fb1f907c5441b3996d5fb",
   "preferredVersionsHash": "54149ea3f01558a859c96dee2052b797d4defe68"
 }

libraries/heft-config-file/package.json

@@ -24,11 +24,13 @@
     "@rushstack/node-core-library": "workspace:*",
     "@rushstack/rig-package": "workspace:*",
     "@rushstack/terminal": "workspace:*",
+    "@ungap/structured-clone": "~1.3.0",
     "jsonpath-plus": "~10.3.0"
   },
   "devDependencies": {
-    "local-eslint-config": "workspace:*",
     "@rushstack/heft": "0.71.2",
-    "decoupled-local-node-rig": "workspace:*"
+    "@types/ungap__structured-clone": "~1.2.0",
+    "decoupled-local-node-rig": "workspace:*",
+    "local-eslint-config": "workspace:*"
   }
 }

libraries/heft-config-file/src/ConfigurationFileBase.ts

@@ -4,6 +4,7 @@
 import * as nodeJsPath from 'path';
 import { JSONPath } from 'jsonpath-plus';
 import { JsonSchema, JsonFile, Import, FileSystem } from '@rushstack/node-core-library';
+import structuredClone from '@ungap/structured-clone';
 import type { ITerminal } from '@rushstack/terminal';
 
 interface IConfigurationJson {
@@ -624,7 +625,10 @@ export abstract class ConfigurationFileBase<TConfigurationFile, TExtraOptions ex
     projectFolderPath: string | undefined
   ): IConfigurationJson & TConfigurationFile {
     // Deep copy the configuration file because different callers might contextualize properties differently.
-    const result: IConfigurationJson & TConfigurationFile = structuredClone(entry.configurationFile);
+    // TODO: Replace this version of structuredClone with the built-in version once Node 16 support is dropped on the TikTok side
+    const result: IConfigurationJson & TConfigurationFile = structuredClone<
+      IConfigurationJson & TConfigurationFile
+    >(entry.configurationFile);
 
     const { resolvedConfigurationFilePath } = entry;