Update Test Descriptions to Active Tense

.gitignore

@@ -32,3 +32,9 @@ scripts/coverage
 
 # typescript
 packages/*/*.tsbuildinfo
+
+# Ignore build artifacts in src and tests directories
+packages/*/src/*.js
+packages/*/src/*.d.ts
+packages/*/tests/**/*.js
+packages/*/tests/**/*.d.ts

packages/accounts-controller/tsconfig.build.json

@@ -12,5 +12,8 @@
     },
     { "path": "../keyring-controller/tsconfig.build.json" }
   ],
-  "include": ["../../types", "./src"]
+  "include": [
+    "../../types",
+    "./src/**/*.ts"
+  ]
 }

packages/base-controller/package.json

@@ -45,12 +45,14 @@
   },
   "devDependencies": {
     "@metamask/auto-changelog": "^3.4.4",
+    "@microsoft/api-extractor": "^7.47.0",
     "@types/jest": "^27.4.1",
     "@types/sinon": "^9.0.10",
     "deepmerge": "^4.2.2",
     "jest": "^27.5.1",
     "sinon": "^9.2.4",
     "ts-jest": "^27.1.4",
+    "tsup": "^8.1.0",
     "typedoc": "^0.24.8",
     "typedoc-plugin-missing-exports": "^2.0.0",
     "typescript": "~4.9.5"

packages/base-controller/tsconfig.build.json

@@ -10,5 +10,9 @@
       "path": "../controller-utils/tsconfig.build.json"
     }
   ],
-  "include": ["../../types", "./src"]
+  "include": [
+    "../../types",
+    "./src",
+    "./src/**/*.ts"
+  ]
 }

packages/build-utils/src/index.d.ts

@@ -0,0 +1,3 @@
+export type { FeatureLabels } from './transforms/remove-fenced-code';
+export { removeFencedCode } from './transforms/remove-fenced-code';
+export { lintTransformedFile } from './transforms/utils';

packages/build-utils/src/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lintTransformedFile = exports.removeFencedCode = void 0;
+var remove_fenced_code_1 = require("./transforms/remove-fenced-code");
+Object.defineProperty(exports, "removeFencedCode", { enumerable: true, get: function () { return remove_fenced_code_1.removeFencedCode; } });
+var utils_1 = require("./transforms/utils");
+Object.defineProperty(exports, "lintTransformedFile", { enumerable: true, get: function () { return utils_1.lintTransformedFile; } });

packages/build-utils/src/transforms/remove-fenced-code.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Two sets of feature labels, where:
+ * - `active` is the set of labels that are active for the current build.
+ * - `all` is the set of all labels that are declared in the codebase.
+ *
+ * For `ONLY_INCLUDE_IF` fences, the code fence removal transform will
+ * include the fenced code if any of the specified labels are active. See
+ * {@link removeFencedCode} for details.
+ */
+export type FeatureLabels = {
+    active: ReadonlySet<string>;
+    all: ReadonlySet<string>;
+};
+export declare enum DirectiveCommand {
+    ONLY_INCLUDE_IF = "ONLY_INCLUDE_IF"
+}
+/**
+ * Removes fenced code from the given JavaScript source string. "Fenced code"
+ * includes the entire fence lines, including their trailing newlines, and the
+ * lines that they surround.
+ *
+ * A valid fence consists of two well-formed fence lines, separated by one or
+ * more lines that should be excluded. The first line must contain a `BEGIN`
+ * directive, and the second most contain an `END` directive. Both directives
+ * must specify the same command.
+ *
+ * Here's an example of a valid fence:
+ *
+ * ```javascript
+ *   ///: BEGIN:ONLY_INCLUDE_IF(build-flask)
+ *   console.log('I am Flask.');
+ *   ///: END:ONLY_INCLUDE_IF
+ * ```
+ *
+ * For details, please see the documentation.
+ *
+ * @param filePath - The path to the file being transformed.
+ * @param fileContent - The contents of the file being transformed.
+ * @param featureLabels - FeatureLabels that are currently active.
+ * @returns A tuple of the post-transform file contents and a boolean indicating
+ * whether they were modified.
+ */
+export declare function removeFencedCode(filePath: string, fileContent: string, featureLabels: FeatureLabels): [string, boolean];
+/**
+ * Returns a copy of the given string, without the character ranges specified
+ * by the splicing indices array.
+ *
+ * The splicing indices must be a non-empty, even-length array of non-negative
+ * integers, specifying the character ranges to remove from the given string, as
+ * follows:
+ *
+ * `[ start, end, start, end, start, end, ... ]`
+ *
+ * Throws if the array is not an even-length array of non-negative integers.
+ *
+ * @param toSplice - The string to splice.
+ * @param splicingIndices - Indices to splice at.
+ * @returns The spliced string.
+ */
+export declare function multiSplice(toSplice: string, splicingIndices: number[]): string;
+/**
+ * Validates the specified command. Throws if validation fails.
+ *
+ * @param command - The command to validate.
+ * @param params - The parameters of the command.
+ * @param filePath - The path of the current file.
+ * @param featureLabels - The possible feature labels.
+ */
+export declare function validateCommand(command: unknown, params: string[], filePath: string, featureLabels: FeatureLabels): asserts command is DirectiveCommand;