@genesislcap/foundation-testing 10.3.1 → 11.3.0

package/README.md

@@ -97,7 +97,7 @@ The test related scripts to add to your package's `package.json` file may includ
 "test:coverage:report": "npm run test:coverage && c8 report --reporter=text-lcov > coverage.lcov",
 "test:coverage:report:nyc": "npm run test:unit:browser -- --cov && npx nyc report --reporter=html",
 "test:e2e": "npx playwright test --config=./playwright.config.ts",
-"test:e2e:debug": "cross-env PWDEBUG=1 npm run test:e2e",
+"test:e2e:debug": "npm run test:e2e -- --debug",
 "test:unit": "npm run test:unit:node",
 "test:unit:browser": "playwright-test \"./**/*.test.ts\" --runner uvu",
 "test:unit:browser:watch": "npm run test:unit:browser -- -w -d",

package/dist/dts/playwright/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/playwright/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;;;;;GAQG;AACH,iBAAe,KAAK,CAAC,MAAM,EAAE,UAAU,gCAOtC;AAED,eAAe,KAAK,CAAC"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/playwright/setup.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C;;;;;;;;GAQG;AACH,iBAAe,KAAK,CAAC,MAAM,EAAE,UAAU,gCAStC;AAED,eAAe,KAAK,CAAC"}

package/dist/dts/playwright/test.d.ts

@@ -1,16 +1,43 @@
+import { Browser } from '@playwright/test';
 /**
- * Extend and add fixtures to share across e2e test suite.
  * @public
  */
-export type Fixtures = {
-    hostPage(): Promise<void>;
+export type PackageConfig = {
+    API_HOST?: string;
+    DEFAULT_USER?: string;
+    DEFAULT_PASSWORD?: string;
+    PORT?: number;
 };
 /**
- * Playwright test.
+ * @public
+ */
+export type AuditThresholds = {
+    performance?: number;
+    accessibility?: number;
+    'best-practices'?: number;
+    seo?: number;
+    pwa?: number;
+};
+export declare const defaultAuditThresholds: AuditThresholds;
+/**
+ * @public
+ */
+export type TestFixture = {};
+/**
+ * @public
+ */
+export type WorkerFixture = {
+    config: PackageConfig;
+    port: number;
+    browser: Browser;
+    audit: AuditThresholds;
+};
+/**
+ * Playwright test
  * @public
  * @remarks
  * This is just an example playwright test fixture stub. In reality, you will likely create a custom
  * fixture for your e2e tests depending on the needs of your app or micro frontend.
  */
-export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & Fixtures, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
+export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions & WorkerFixture>;
 //# sourceMappingURL=test.d.ts.map

package/dist/dts/playwright/test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../../src/playwright/test.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,wPAWf,CAAC"}
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../../src/playwright/test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA0B,MAAM,kBAAkB,CAAC;AAGnE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AASF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eAMpC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,EAAE,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,eAAe,CAAC;CACxB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,6PAmBf,CAAC"}

package/dist/dts/suite/suite.d.ts

@@ -1,7 +1,7 @@
 import type { FoundationElement, FoundationElementDefinition, FoundationElementRegistry, Registration } from '@microsoft/fast-foundation';
 import { Container, DesignSystem } from '@microsoft/fast-foundation';
-import { assert, uvu } from '../uvu';
 import { Fixture } from '../component';
+import { assert, uvu } from '../uvu';
 /**
  * @public
  */
@@ -21,6 +21,13 @@ export interface ComponentContext<TElement = HTMLElement> extends Pick<Fixture<T
 export interface LogicContext {
     runCases?(fn: (value: any) => any, cases: [any, any, assert.Message?][]): void;
 }
+/**
+ * Defines the Generic type for a test Suite `T` the callback function
+ * required to assert on type `T`.
+ * @typeParam T - the top level class we are testing
+ * @public
+ */
+export type SuiteCallback<T> = uvu.Callback<ComponentContext<T>>;
 /**
  * Create component test suite.
  *

package/dist/dts/suite/suite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"suite.d.ts","sourceRoot":"","sources":["../../../src/suite/suite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,2BAA2B,EAC3B,yBAAyB,EACzB,YAAY,EACb,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAM,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,MAAM,EAAS,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAE,OAAO,EAA0C,MAAM,cAAc,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,yBAAyB,CACzD,2BAA2B,EAC3B,iBAAiB,CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,QAAQ,GAAG,WAAW,CACtD,SAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IACzD,YAAY,EAAE,YAAY,CAAC;IAC3B,SAAS,EAAE,SAAS,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC;CAChF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,GAAG,WAAW,EACzD,KAAK,EAAE,MAAM,EACb,mBAAmB,EAAE,MAAM,GAAG,aAAa,EAC3C,OAAO,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACpC,aAAa,GAAE,YAAY,CAAC,GAAG,CAAC,EAAO,GACtC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CA0CtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,GAAG,YAAY,EACtD,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,QAAQ,GACjB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CASpB"}
+{"version":3,"file":"suite.d.ts","sourceRoot":"","sources":["../../../src/suite/suite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,2BAA2B,EAC3B,yBAAyB,EACzB,YAAY,EACb,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAM,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,OAAO,EAA0C,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,MAAM,EAAS,GAAG,EAAE,MAAM,QAAQ,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,yBAAyB,CACzD,2BAA2B,EAC3B,iBAAiB,CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,QAAQ,GAAG,WAAW,CACtD,SAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IACzD,YAAY,EAAE,YAAY,CAAC;IAC3B,SAAS,EAAE,SAAS,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC;CAChF;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,GAAG,WAAW,EACzD,KAAK,EAAE,MAAM,EACb,mBAAmB,EAAE,MAAM,GAAG,aAAa,EAC3C,OAAO,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACpC,aAAa,GAAE,YAAY,CAAC,GAAG,CAAC,EAAO,GACtC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CA0CtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,GAAG,YAAY,EACtD,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,QAAQ,GACjB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CASpB"}

package/dist/dts/utils/harness.d.ts

@@ -0,0 +1,75 @@
+import sinon from 'sinon';
+/**
+ * Filters out key/value pairs from an object where they value does not match a condition
+ * @public
+ */
+export type FilterConditionally<Source, Condition> = Pick<Source, {
+    [K in keyof Source]: Source[K] extends Condition ? K : never;
+}[keyof Source]>;
+/**
+ * Filters out all key/value pairs which are not functions, and omits the constructor
+ * @public
+ */
+export type SpiedFunctions<T> = Omit<FilterConditionally<T, (...args: any[]) => any>, 'constructor'>;
+/**
+ * Crates an object with a key value pair for each spied function
+ * where the key is the function name and the value is the sinon wrapped
+ * spy function
+ * @public
+ * @typeParam T - object with keys where values are functions
+ */
+export type SinonWrapper<T extends {
+    [K in keyof T]: (...args: any) => any;
+}> = {
+    [K in keyof T]: sinon.SinonSpy<Parameters<T[K]>, ReturnType<T[K]>>;
+};
+/**
+ * Type can be used  to inform Typescript the object decorated with {@link testSpy} has function
+ * spies which can be interacted upon their normal function reference
+ * @public
+ */
+export type WithTestHarness<T extends {
+    [k in keyof T]: any;
+}> = T & SinonWrapper<SpiedFunctions<T>>;
+/**
+ * Decorator: Used on a test harness class based on a `FoundationElement` to give it extra functionality
+ * which can be used during testing. *Important* this is to be used on a parent element compared to
+ * the element under test.
+ *
+ *
+ * @remarks
+ * Access the test functionality using the type with {@link WithTestHarness}
+ *
+ * Reset after each test with {@link resetTestHarness}
+ *
+ * @example
+ *
+ * // Testing the first function call
+ * async (\{ element \}) =\> \{
+ *
+    assert.ok(
+      element.layout.addItemFromChild.calledWith(\{
+        type: 'component',
+        componentType: 'test',
+        title: `Item test`,
+        reorderEnabled: true,
+        isClosable: false,
+        size: undefined,
+      \})
+    );
+ *
+ *   // Reset the tester at the end of every test even if you don't assert on any of it!
+*   resetTestHarness(element.layout);
+ * \}
+ *
+ * @public
+ */
+export declare function testSpy(constructor: Function): void;
+/**
+ * Resets items tracked during testing such as calls to spied functions.
+ * Must be called at the end of every test even if not asserting on the spies.
+ * @param wrapper - `WithTestHarness<T>` object to reset
+ * @public
+ */
+export declare function resetTestHarness<T>(wrapper: WithTestHarness<T>): void;
+//# sourceMappingURL=harness.d.ts.map

package/dist/dts/utils/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../../src/utils/harness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;GAGG;AACH,MAAM,MAAM,mBAAmB,CAAC,MAAM,EAAE,SAAS,IAAI,IAAI,CACvD,MAAM,EACN;KAAG,CAAC,IAAI,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,SAAS,GAAG,CAAC,GAAG,KAAK;CAAE,CAAC,MAAM,MAAM,CAAC,CAC/E,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,IAAI,CAClC,mBAAmB,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,EAC/C,aAAa,CACd,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG;CAAE,IAAI;KAC7E,CAAC,IAAI,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACnE,CAAC;AACF;;;;GAIG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,GAAG;CAAE,IAAI,CAAC,GAChE,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AAYlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,OAAO,CAAC,WAAW,EAAE,QAAQ,QAK5C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,QAE9D"}

package/dist/dts/utils/index.d.ts

@@ -1,2 +1,4 @@
 export * from './logger';
+export * from './harness';
+export * from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/dts/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC"}

package/dist/dts/utils/types.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Expects that the type parameter T resolves to true, or will be a typescript error
+ * @public
+ */
+export type Expect<T extends true> = T;
+/**
+ * Expects that the type parameter X is equal to Y, returning true or false
+ * @public
+ */
+export type Equal<X, Y> = (<T>() => T extends X ? 1 : 2) extends <T>() => T extends Y ? 1 : 2 ? true : false;
+//# sourceMappingURL=types.d.ts.map

package/dist/dts/utils/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/types.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC;AAEvC;;;GAGG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,GACzF,IAAI,GACJ,KAAK,CAAC"}

package/dist/esm/component/fixture.js

@@ -84,4 +84,3 @@ export function fixture(templateNameOrRegistry, options = {}) {
         };
     });
 }
-//# sourceMappingURL=fixture.js.map

package/dist/esm/component/index.js

@@ -1,2 +1 @@
 export * from './fixture';
-//# sourceMappingURL=index.js.map

package/dist/esm/index.federated.js

@@ -1,2 +1 @@
 import('./index');
-//# sourceMappingURL=index.federated.js.map

package/dist/esm/index.js

@@ -8,4 +8,3 @@ export * from './component';
 export * from './suite';
 export * from './utils';
 export * from './uvu';
-//# sourceMappingURL=index.js.map

package/dist/esm/jsdom/setup.js

@@ -89,4 +89,3 @@ export const teardown = () => __awaiter(void 0, void 0, void 0, function* () {
  * Run setup on import by default.
  */
 setup();
-//# sourceMappingURL=setup.js.map

package/dist/esm/playwright/index.js

@@ -2,4 +2,3 @@
  * Do not export setup
  */
 export * from './test';
-//# sourceMappingURL=index.js.map

package/dist/esm/playwright/setup.js

@@ -1,4 +1,7 @@
 import { __awaiter } from "tslib";
+import os from 'os';
+import path from 'path';
+import rimraf from 'rimraf';
 /**
  * @param config - A playwright configuration object.
  * @returns A teardown function.
@@ -16,9 +19,10 @@ function setup(config) {
             return __awaiter(this, void 0, void 0, function* () {
                 delete process.env.FOO;
                 delete process.env.BAR;
+                const tmpDirPath = path.join(os.tmpdir(), 'pw');
+                rimraf(tmpDirPath, console.log);
             });
         };
     });
 }
 export default setup;
-//# sourceMappingURL=setup.js.map

package/dist/esm/playwright/test.js

@@ -1,22 +1,51 @@
 import { __awaiter } from "tslib";
-import { test as base } from '@playwright/test';
+import { chromium, test as base } from '@playwright/test';
+import { getPort } from 'portfinder-sync';
+const defaultPackageConfig = {
+    API_HOST: 'wss://public-foundation.genesislab.global/gwf/',
+    DEFAULT_USER: 'JohnDoe',
+    DEFAULT_PASSWORD: 'Password11*',
+    PORT: 5030,
+};
+export const defaultAuditThresholds = {
+    performance: 45,
+    accessibility: 60,
+    'best-practices': 60,
+    seo: 60,
+    pwa: 30,
+};
 /**
- * Playwright test.
+ * Playwright test
  * @public
  * @remarks
  * This is just an example playwright test fixture stub. In reality, you will likely create a custom
  * fixture for your e2e tests depending on the needs of your app or micro frontend.
  */
 export const test = base.extend({
-    hostPage: ({ page }, use) => __awaiter(void 0, void 0, void 0, function* () {
-        /**
-         * const host = new HostPage(page);
-         * await host.goto();
-         * await host.addSomeThing('something');
-         * await use(host);
-         * await host.destroy();
-         */
-        yield use(null);
-    }),
+    config: [defaultPackageConfig, { option: true, scope: 'worker' }],
+    port: [
+        ({ config }, use) => __awaiter(void 0, void 0, void 0, function* () {
+            const port = getPort((config === null || config === void 0 ? void 0 : config.PORT) || process.env.PORT || defaultPackageConfig.PORT);
+            yield use(port);
+        }),
+        { scope: 'worker' }, // option: true
+    ],
+    browser: [
+        ({ port }, use) => __awaiter(void 0, void 0, void 0, function* () {
+            const browser = yield chromium.launch({
+                args: [`--remote-debugging-port=${port}`],
+            });
+            yield use(browser);
+        }),
+        { scope: 'worker' },
+    ],
+    audit: [defaultAuditThresholds, { option: true, scope: 'worker' }], // TODO: These are not being used from other test setups extending this.
 });
-//# sourceMappingURL=test.js.map
+// Perhaps we keen extending the test up the package chain... spread the mf tests into our app test
+// const test2 = test.extend<{ foo: boolean }>({
+//   foo: [true, { option: true }],
+// });
+//
+// a('lighthouse audit', async ({ foo, page }) => {
+//
+// });

package/dist/esm/suite/index.js

@@ -1,2 +1 @@
 export * from './suite';
-//# sourceMappingURL=index.js.map

package/dist/esm/suite/suite.js

@@ -1,7 +1,7 @@
 import { __awaiter } from "tslib";
 import { DesignSystem, DI } from '@microsoft/fast-foundation';
-import { assert, suite } from '../uvu';
 import { fixture as FASTFixture } from '../component';
+import { assert, suite } from '../uvu';
 /**
  * Create component test suite.
  *
@@ -141,4 +141,3 @@ export function createLogicSuite(title, context) {
         } }, context));
     return Suite;
 }
-//# sourceMappingURL=suite.js.map

package/dist/esm/utils/harness.js

@@ -0,0 +1,55 @@
+import sinon from 'sinon';
+/**
+ * Predicate function used to check whether the object's value is a function
+ * we want to spy on. We want to spy on all functions, except the constructor
+ * @internal
+ */
+const shouldSpy = (proto) => (k) => typeof proto[k] === 'function' && k !== 'constructor';
+/**
+ * Decorator: Used on a test harness class based on a `FoundationElement` to give it extra functionality
+ * which can be used during testing. *Important* this is to be used on a parent element compared to
+ * the element under test.
+ *
+ *
+ * @remarks
+ * Access the test functionality using the type with {@link WithTestHarness}
+ *
+ * Reset after each test with {@link resetTestHarness}
+ *
+ * @example
+ *
+ * // Testing the first function call
+ * async (\{ element \}) =\> \{
+ *
+    assert.ok(
+      element.layout.addItemFromChild.calledWith(\{
+        type: 'component',
+        componentType: 'test',
+        title: `Item test`,
+        reorderEnabled: true,
+        isClosable: false,
+        size: undefined,
+      \})
+    );
+ *
+ *   // Reset the tester at the end of every test even if you don't assert on any of it!
+*   resetTestHarness(element.layout);
+ * \}
+ *
+ * @public
+ */
+export function testSpy(constructor) {
+    constructor['_test'] = sinon.createSandbox();
+    Object.getOwnPropertyNames(constructor.prototype)
+        .filter(shouldSpy(constructor.prototype))
+        .forEach((p) => constructor['_test'].spy(constructor.prototype, p));
+}
+/**
+ * Resets items tracked during testing such as calls to spied functions.
+ * Must be called at the end of every test even if not asserting on the spies.
+ * @param wrapper - `WithTestHarness<T>` object to reset
+ * @public
+ */
+export function resetTestHarness(wrapper) {
+    wrapper.constructor['_test'].restore();
+}

package/dist/esm/utils/index.js

@@ -1,2 +1,3 @@
 export * from './logger';
-//# sourceMappingURL=index.js.map
+export * from './harness';
+export * from './types';

package/dist/esm/utils/logger.js

@@ -6,4 +6,3 @@ import { createLogger } from '@genesislcap/foundation-utils';
  * Exported so you can set log levels differently across packages when needed.
  */
 export const logger = createLogger('foundation-testing');
-//# sourceMappingURL=logger.js.map

package/dist/esm/utils/types.js

@@ -0,0 +1,2 @@
+// https://github.com/type-challenges/type-challenges/blob/main/utils/index.d.ts
+export {};

package/dist/esm/uvu/index.js

@@ -1,2 +1 @@
 export * from './uvu';
-//# sourceMappingURL=index.js.map

package/dist/esm/uvu/uvu.js

@@ -5,4 +5,3 @@ import * as assert from 'uvu/assert';
  * @public
  */
 export { assert, suite, test };
-//# sourceMappingURL=uvu.js.map