Platform neutrality

compulim · compulim · commit c22a6a49038e · 2025-08-07T10:58:27.000Z
diff --git a/package-lock.json b/package-lock.json
diff --git a/packages/api/package.json b/packages/api/package.json
@@ -100,6 +100,7 @@
     "@msinternal/botframework-webchat-redux-store": "^0.0.0-0",
     "@msinternal/botframework-webchat-tsconfig": "^0.0.0-0",
     "@types/dom-speech-recognition": "^0.0.6",
+    "@types/jest": "^30.0.0",
     "@types/node": "^24.1.0",
     "@types/react": "^16.14.65",
     "babel-plugin-istanbul": "^7.0.0",
diff --git a/packages/api/src/__tests__/addMetaTag.spec.js b/packages/api/src/__tests__/addMetaTag.spec.js
@@ -1,4 +1,5 @@
 /** @jest-environment @happy-dom/jest-environment */
+/// <reference types="jest" />
 
 test('CommonJS should export matching buildInfo', () => {
   const { buildInfo } = jest.requireActual('../../dist/botframework-webchat-api.js');
diff --git a/packages/api/src/__tests__/addMetaTag.spec.mjs b/packages/api/src/__tests__/addMetaTag.spec.mjs
@@ -1,4 +1,5 @@
 /** @jest-environment @happy-dom/jest-environment */
+/// <reference types="jest" />
 
 test('ESModules should export matching buildInfo', () => {
   const { buildInfo } = jest.requireActual('../../dist/botframework-webchat-api.mjs');
diff --git a/packages/api/src/env.d.ts b/packages/api/src/env.d.ts
@@ -0,0 +1,11 @@
+declare global {
+  const process: {
+    env?: {
+      build_tool?: string | undefined;
+      module_format?: string | undefined;
+      npm_package_version?: string | undefined;
+    };
+  };
+}
+
+export {};
diff --git a/packages/api/src/index.ts b/packages/api/src/index.ts
@@ -48,9 +48,9 @@ export {
 } from './middleware/SendBoxToolbarMiddleware';
 // #endregion
 
-const buildTool = process.env.build_tool;
-const moduleFormat = process.env.module_format;
-const version = process.env.npm_package_version;
+const buildTool = process?.env?.build_tool;
+const moduleFormat = process?.env?.module_format;
+const version = process?.env?.npm_package_version;
 
 const buildInfo = { buildTool, moduleFormat, version };
 
diff --git a/packages/api/src/providers/ActivityTyping/private/useReduceActivities.spec.tsx b/packages/api/src/providers/ActivityTyping/private/useReduceActivities.spec.tsx
@@ -1,4 +1,6 @@
 /** @jest-environment @happy-dom/jest-environment */
+/// <reference types="jest" />
+/// <reference types="node" />
 
 import { render, type RenderResult } from '@testing-library/react';
 import type { WebChatActivity } from 'botframework-webchat-core';
diff --git a/packages/api/src/tsconfig.json b/packages/api/src/tsconfig.json
@@ -2,6 +2,7 @@
   "compilerOptions": {
     "downlevelIteration": true,
     "resolveJsonModule": true, // Required for localization files
+    "types": ["dom-speech-recognition"]
   },
   "extends": "@msinternal/botframework-webchat-tsconfig/legacy"
 }
diff --git a/packages/bundle/src/createCognitiveServicesSpeechServicesPonyfillFactory.spec.js b/packages/bundle/src/createCognitiveServicesSpeechServicesPonyfillFactory.spec.js
@@ -1,3 +1,4 @@
+/// <reference types="jest" />
 /**
  * @jest-environment @happy-dom/jest-environment
  * @jest-environment-options { "customExportConditions": ["node"] }
diff --git a/packages/bundle/src/markdown/private/betterLinkDocumentMod.ariaLabel.spec.ts b/packages/bundle/src/markdown/private/betterLinkDocumentMod.ariaLabel.spec.ts
@@ -1,3 +1,4 @@
+/// <reference types="jest" />
 /** @jest-environment @happy-dom/jest-environment */
 
 import {
diff --git a/packages/bundle/src/markdown/private/betterLinkDocumentMod.asButton.spec.ts b/packages/bundle/src/markdown/private/betterLinkDocumentMod.asButton.spec.ts
@@ -1,3 +1,4 @@
+/// <reference types="jest" />
 /** @jest-environment @happy-dom/jest-environment */
 
 import {
diff --git a/packages/bundle/src/markdown/private/betterLinkDocumentMod.className.spec.ts b/packages/bundle/src/markdown/private/betterLinkDocumentMod.className.spec.ts
@@ -1,3 +1,4 @@
+/// <reference types="jest" />
 /** @jest-environment @happy-dom/jest-environment */
 
 import {
diff --git a/packages/bundle/src/markdown/private/betterLinkDocumentMod.iconClassName.spec.ts b/packages/bundle/src/markdown/private/betterLinkDocumentMod.iconClassName.spec.ts
@@ -1,3 +1,4 @@
+/// <reference types="jest" />
 /** @jest-environment @happy-dom/jest-environment */
 
 import {
diff --git a/packages/bundle/src/markdown/private/betterLinkDocumentMod.rel.spec.ts b/packages/bundle/src/markdown/private/betterLinkDocumentMod.rel.spec.ts
@@ -1,3 +1,4 @@
+/// <reference types="jest" />
 /** @jest-environment @happy-dom/jest-environment */
 
 import {
diff --git a/packages/bundle/src/markdown/private/betterLinkDocumentMod.selector.spec.ts b/packages/bundle/src/markdown/private/betterLinkDocumentMod.selector.spec.ts
@@ -1,3 +1,4 @@
+/// <reference types="jest" />
 /** @jest-environment @happy-dom/jest-environment */
 
 import {
diff --git a/packages/bundle/src/markdown/private/betterLinkDocumentMod.target.spec.ts b/packages/bundle/src/markdown/private/betterLinkDocumentMod.target.spec.ts
@@ -1,3 +1,4 @@
+/// <reference types="jest" />
 /** @jest-environment @happy-dom/jest-environment */
 
 import {
diff --git a/packages/bundle/src/markdown/private/betterLinkDocumentMod.title.spec.ts b/packages/bundle/src/markdown/private/betterLinkDocumentMod.title.spec.ts
@@ -1,3 +1,4 @@
+/// <reference types="jest" />
 /** @jest-environment @happy-dom/jest-environment */
 
 import {
diff --git a/packages/bundle/src/markdown/private/betterLinkDocumentMod.wrapZeroWidthSpace.spec.ts b/packages/bundle/src/markdown/private/betterLinkDocumentMod.wrapZeroWidthSpace.spec.ts
@@ -1,3 +1,4 @@
+/// <reference types="jest" />
 /** @jest-environment @happy-dom/jest-environment */
 
 import {
diff --git a/packages/bundle/src/tsconfig.json b/packages/bundle/src/tsconfig.json
@@ -1,3 +1,6 @@
 {
+  "compilerOptions": {
+    "types": ["dom-speech-recognition"]
+  },
   "extends": "@msinternal/botframework-webchat-tsconfig/legacy"
 }
diff --git a/packages/component/package.json b/packages/component/package.json
@@ -108,6 +108,8 @@
     "@msinternal/botframework-webchat-react-valibot": "^0.0.0-0",
     "@msinternal/botframework-webchat-styles": "0.0.0-0",
     "@msinternal/botframework-webchat-tsconfig": "^0.0.0-0",
+    "@types/dom-speech-recognition": "^0.0.6",
+    "@types/jest": "^30.0.0",
     "@types/mdast": "^4.0.4",
     "@types/node": "^24.1.0",
     "@types/react": "^16.14.65",
diff --git a/packages/component/src/LinkDefinition/private/extractHostnameWithSubdomain.spec.ts b/packages/component/src/LinkDefinition/private/extractHostnameWithSubdomain.spec.ts
@@ -1,3 +1,5 @@
+/// <reference types="jest" />
+
 import extractHostnameWithSubdomain from './extractHostnameWithSubdomain';
 
 test.each([
diff --git a/packages/component/src/Utils/JSONLinkedData/dereferenceBlankNodes.spec.ts b/packages/component/src/Utils/JSONLinkedData/dereferenceBlankNodes.spec.ts
@@ -1,3 +1,5 @@
+/// <reference types="jest" />
+
 import dereferenceBlankNodes from './dereferenceBlankNodes';
 
 test('should leave non-blank node as-is', () => {
diff --git a/packages/component/src/Utils/JSONLinkedData/isUnconnectedBlankNode.spec.ts b/packages/component/src/Utils/JSONLinkedData/isUnconnectedBlankNode.spec.ts
@@ -1,3 +1,5 @@
+/// <reference types="jest" />
+
 import isUnconnectedBlankNode from './isUnconnectedBlankNode';
 
 test('passing a blank node identifier should return true', () =>
diff --git a/packages/component/src/env.d.ts b/packages/component/src/env.d.ts
@@ -1 +1,15 @@
 /// <reference types="@msinternal/botframework-webchat-styles/env" />
+
+declare global {
+  const process: {
+    env?: {
+      build_tool?: string | undefined;
+      module_format?: string | undefined;
+      node_env?: string | undefined;
+      NODE_ENV?: string | undefined;
+      npm_package_version?: string | undefined;
+    };
+  };
+}
+
+export {};
diff --git a/packages/component/src/hooks/internal/createWaitUntilable.spec.ts b/packages/component/src/hooks/internal/createWaitUntilable.spec.ts
@@ -1,3 +1,5 @@
+/// <reference types="jest" />
+
 import createWaitUntilable, { type WaitUntilable } from './createWaitUntilable';
 
 type Deferred<T> = {
diff --git a/packages/component/src/hooks/internal/private/createOnEventShim.spec.ts b/packages/component/src/hooks/internal/private/createOnEventShim.spec.ts
@@ -1,3 +1,5 @@
+/// <reference types="jest" />
+
 import createOnEventShim from './createOnEventShim';
 
 describe('A shimmed event target', () => {
diff --git a/packages/component/src/providers/GroupedRenderingActivities/private/group.spec.ts b/packages/component/src/providers/GroupedRenderingActivities/private/group.spec.ts
@@ -1,3 +1,5 @@
+/// <reference types="jest" />
+
 import group from './group';
 
 test('when nothing is passed should return empty array', () => {
diff --git a/packages/component/src/providers/GroupedRenderingActivities/private/pick.spec.ts b/packages/component/src/providers/GroupedRenderingActivities/private/pick.spec.ts
@@ -1,3 +1,5 @@
+/// <reference types="jest" />
+
 import pick from './pick';
 
 test('when no item should return empty', () => {
diff --git a/packages/component/src/tsconfig.json b/packages/component/src/tsconfig.json
@@ -1,6 +1,7 @@
 {
   "compilerOptions": {
-    "downlevelIteration": true
+    "downlevelIteration": true,
+    "types": ["dom-speech-recognition"]
   },
   "extends": [
     "@msinternal/botframework-webchat-tsconfig/legacy",
diff --git a/packages/core/package.json b/packages/core/package.json
@@ -88,6 +88,7 @@
     "@babel/preset-env": "^7.28.0",
     "@msinternal/botframework-webchat-base": "^0.0.0-0",
     "@msinternal/botframework-webchat-tsconfig": "^0.0.0-0",
+    "@types/jest": "^30.0.0",
     "@types/node": "^24.1.0",
     "babel-plugin-istanbul": "^7.0.0",
     "babel-plugin-transform-inline-environment-variables": "^0.4.4",
diff --git a/packages/core/src/__tests__/activityFromBot.spec.js b/packages/core/src/__tests__/activityFromBot.spec.js
@@ -1,3 +1,5 @@
+/// <reference types="jest" />
+
 import activityFromBot from '../definitions/activityFromBot';
 
 describe('activityFromBot', () => {
diff --git a/packages/core/src/__tests__/addMetaTag.spec.js b/packages/core/src/__tests__/addMetaTag.spec.js
@@ -1,3 +1,5 @@
+/// <reference types="jest" />
+
 test('CommonJS should export matching buildInfo', () => {
   const { buildInfo } = jest.requireActual('../../dist/botframework-webchat-core.js');
 
diff --git a/packages/core/src/__tests__/addMetaTag.spec.mjs b/packages/core/src/__tests__/addMetaTag.spec.mjs
@@ -1,3 +1,5 @@
+/// <reference types="jest" />
+
 test('ESModules should export matching buildInfo', () => {
   const { buildInfo } = jest.requireActual('../../dist/botframework-webchat-core.mjs');
 
diff --git a/packages/core/src/__tests__/connectSaga.spec.js b/packages/core/src/__tests__/connectSaga.spec.js
@@ -1,3 +1,5 @@
+/// <reference types="jest" />
+
 /* eslint no-magic-numbers: "off" */
 
 import connectSaga from '../sagas/connectSaga';
diff --git a/packages/core/src/__tests__/deleteKey.spec.js b/packages/core/src/__tests__/deleteKey.spec.js
@@ -1,3 +1,5 @@
+/// <reference types="jest" />
+
 import deleteKey from '../utils/deleteKey';
 
 describe('deleteKey', () => {
diff --git a/packages/core/src/__tests__/detectSlowConnectionSaga.spec.js b/packages/core/src/__tests__/detectSlowConnectionSaga.spec.js
@@ -1,3 +1,5 @@
+/// <reference types="jest" />
+
 /* eslint no-magic-numbers: "off" */
 
 import { applyMiddleware, combineReducers, createStore } from 'redux';
diff --git a/packages/core/src/__tests__/observeOnce.spec.js b/packages/core/src/__tests__/observeOnce.spec.js
@@ -1,3 +1,5 @@
+/// <reference types="jest" />
+
 /* eslint no-magic-numbers: ["error", { "ignore": [0, 1, 2] }] */
 
 import { runSaga } from 'redux-saga';
diff --git a/packages/core/src/__tests__/speakableActivity.spec.js b/packages/core/src/__tests__/speakableActivity.spec.js
@@ -1,3 +1,5 @@
+/// <reference types="jest" />
+
 import speakableActivity from '../definitions/speakableActivity';
 
 describe('speakableActivity', () => {
diff --git a/packages/core/src/__tests__/uniqueID.spec.js b/packages/core/src/__tests__/uniqueID.spec.js
@@ -1,3 +1,5 @@
+/// <reference types="jest" />
+
 import uniqueId from '../utils/uniqueID';
 
 describe('uniqueID', () => {
diff --git a/packages/core/src/env.d.ts b/packages/core/src/env.d.ts
@@ -0,0 +1,14 @@
+declare global {
+  const process: {
+    env?: {
+      build_tool?: string | undefined;
+      module_format?: string | undefined;
+      npm_package_version?: string | undefined;
+    };
+  };
+
+  const clearImmediate: ((timeout: number) => void) | undefined;
+  const setImmediate: ((fn: () => void) => number) | undefined;
+}
+
+export {};
diff --git a/packages/core/src/tsconfig.json b/packages/core/src/tsconfig.json
@@ -1,6 +1,7 @@
 {
-  "exclude": [
-    "**/*.spec.ts"
-  ],
-  "extends": "@msinternal/botframework-webchat-tsconfig/legacy",
+  "compilerOptions": {
+    "types": []
+  },
+  "exclude": ["**/*.spec.ts"],
+  "extends": "@msinternal/botframework-webchat-tsconfig/legacy"
 }
diff --git a/packages/fluent-theme/src/env.d.ts b/packages/fluent-theme/src/env.d.ts
@@ -1 +1,13 @@
 /// <reference types="@msinternal/botframework-webchat-styles/env" />
+
+declare global {
+  const process: {
+    env?: {
+      build_tool?: string | undefined;
+      module_format?: string | undefined;
+      npm_package_version?: string | undefined;
+    };
+  };
+}
+
+export {};
diff --git a/packages/fluent-theme/src/external.umd/botframework-webchat-api/decorator.ts b/packages/fluent-theme/src/external.umd/botframework-webchat-api/decorator.ts
@@ -1 +1,3 @@
+/// <reference types="node" />
+
 module.exports = (globalThis as any).WebChat.decorator;
diff --git a/packages/fluent-theme/src/external.umd/botframework-webchat-api/index.ts b/packages/fluent-theme/src/external.umd/botframework-webchat-api/index.ts
@@ -1,3 +1,5 @@
+/// <reference types="node" />
+
 module.exports = {
   hooks: (globalThis as any).WebChat.hooks
 };
diff --git a/packages/fluent-theme/src/external.umd/botframework-webchat-component/decorator.ts b/packages/fluent-theme/src/external.umd/botframework-webchat-component/decorator.ts
@@ -1 +1,3 @@
+/// <reference types="node" />
+
 module.exports = (globalThis as any).WebChat.decorator;
diff --git a/packages/fluent-theme/src/external.umd/botframework-webchat-component/internal.ts b/packages/fluent-theme/src/external.umd/botframework-webchat-component/internal.ts
@@ -1 +1,3 @@
+/// <reference types="node" />
+
 module.exports = (globalThis as any).WebChat.internal;
diff --git a/packages/fluent-theme/src/external.umd/react.ts b/packages/fluent-theme/src/external.umd/react.ts
@@ -1 +1,3 @@
+/// <reference types="node" />
+
 module.exports = (globalThis as any).React;
diff --git a/packages/fluent-theme/src/index.ts b/packages/fluent-theme/src/index.ts
@@ -4,15 +4,15 @@ import { SendBox as FluentSendBox } from './components/sendBox/index';
 import FluentThemeProvider from './private/FluentThemeProvider';
 import testIds from './testIds';
 
-const buildTool = process.env['build_tool'];
-const moduleFormat = process.env['module_format'];
-const version = process.env['npm_package_version'];
+const buildTool = process?.env?.['build_tool'];
+const moduleFormat = process?.env?.['module_format'];
+const version = process?.env?.['npm_package_version'];
 
 const buildInfo = { buildTool, moduleFormat, version };
 
 injectMetaTag(
   'botframework-webchat:fluent-theme',
-  `version=${process.env['npm_package_version']}; build-tool=${process.env['build_tool']}; module-format=${process.env['module_format']}`
+  `version=${version || ''}; build-tool=${buildTool || ''}; module-format=${moduleFormat || ''}`
 );
 
-export { FluentThemeProvider, FluentSendBox, buildInfo, testIds };
+export { buildInfo, FluentSendBox, FluentThemeProvider, testIds };
diff --git a/packages/react-valibot/package.json b/packages/react-valibot/package.json
@@ -58,6 +58,7 @@
   "devDependencies": {
     "@msinternal/botframework-webchat-tsconfig": "^0.0.0-0",
     "@tsconfig/strictest": "^2.0.5",
+    "@types/jest": "^30.0.0",
     "@types/react": "^16.14.65",
     "tsup": "^8.5.0",
     "typescript": "~5.8.3"
diff --git a/packages/styles/src/build/tsconfig.json b/packages/styles/src/build/tsconfig.json
@@ -0,0 +1,7 @@
+{
+  "compilerOptions": {
+    "module": "nodenext",
+    "moduleResolution": "nodenext",
+    "types": ["node"]
+  }
+}
diff --git a/packages/styles/src/tsconfig.json b/packages/styles/src/tsconfig.json
@@ -3,5 +3,5 @@
     "allowSyntheticDefaultImports": true,
     "checkJs": false
   },
-  "extends": "@msinternal/botframework-webchat-tsconfig/current"
+  "extends": ["@msinternal/botframework-webchat-tsconfig/current", "./build/tsconfig.json"]
 }
diff --git a/packages/tsconfig/src/current/tsconfig.json b/packages/tsconfig/src/current/tsconfig.json
@@ -6,9 +6,7 @@
     "noEmit": true,
     "skipLibCheck": true,
     "target": "ESNext",
-
-    // TODO: Add "types: []" to disable default types.
-    // "types": []
+    "types": [] // Platform neutrality: disable loading default types
   },
   "extends": "@tsconfig/strictest/tsconfig.json"
 }
diff --git a/packages/tsconfig/src/legacy/tsconfig.json b/packages/tsconfig/src/legacy/tsconfig.json
@@ -7,6 +7,7 @@
     "noEmit": true,
     "skipLibCheck": true,
     "sourceMap": true,
-    "target": "ESNext"
+    "target": "ESNext",
+    "types": [] // Platform neutrality: disable loading default types
   }
 }

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,5 @@`
`1`	`1`	`/** @jest-environment @happy-dom/jest-environment */`
	`2`	`+/// <reference types="jest" />`
`2`	`3`
`3`	`4`	`test('CommonJS should export matching buildInfo', () => {`
`4`	`5`	`const { buildInfo } = jest.requireActual('../../dist/botframework-webchat-api.js');`
Original file line number	Diff line number	Diff line change
`@@ -2,6 +2,7 @@`
`2`	`2`	`"compilerOptions": {`
`3`	`3`	`"downlevelIteration": true,`
`4`	`4`	`"resolveJsonModule": true, // Required for localization files`
	`5`	`+ "types": ["dom-speech-recognition"]`
`5`	`6`	`},`
`6`	`7`	`"extends": "@msinternal/botframework-webchat-tsconfig/legacy"`
`7`	`8`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+/// <reference types="jest" />`
`1`	`2`	`/**`
`2`	`3`	`* @jest-environment @happy-dom/jest-environment`
`3`	`4`	`* @jest-environment-options { "customExportConditions": ["node"] }`