@augment-vir/test 31.23.3 → 31.24.0

package/dist/augments/test-web.d.ts

@@ -32,6 +32,11 @@ declare function importWebTestApi(this: void): Promise<RuntimeEnvError | {
      * @returns A Promise that will resolve to the first child of the rendered HTML.
      */
     render: typeof import("@open-wc/testing-helpers").fixture;
+    /**
+     * Accepts an element-vir element definition, requires the elements inputs (if any), renders
+     * the element and returns the instance.
+     */
+    renderElement: typeof import("../test-web/render-element").renderElement;
     /** Focus the given element and then type the given string. */
     typeIntoInput: typeof import("../test-web/type-into-element").typeStringIntoElement;
     /**

package/dist/augments/test-web.js

@@ -7,6 +7,7 @@ async function importWebTestApi() {
     const { focusElement } = await import('../test-web/element-test-focus');
     const { deleteAllTextInInput, typeString, typeStringIntoElement } = await import('../test-web/type-into-element');
     const { fixtureCleanup, fixture } = await import('@open-wc/testing-helpers');
+    const { renderElement } = await import('../test-web/render-element');
     return {
         /**
          * Cleans up all rendered test HTML by removing the actual wrapper nodes. Common use case is
@@ -40,6 +41,11 @@ async function importWebTestApi() {
          * @returns A Promise that will resolve to the first child of the rendered HTML.
          */
         render: fixture,
+        /**
+         * Accepts an element-vir element definition, requires the elements inputs (if any), renders
+         * the element and returns the instance.
+         */
+        renderElement,
         /** Focus the given element and then type the given string. */
         typeIntoInput: typeStringIntoElement,
         /**

package/dist/test-web/render-element.d.ts

@@ -0,0 +1,3 @@
+import { type DeclarativeElementDefinition } from 'element-vir';
+import { type EmptyObject } from 'type-fest';
+export declare function renderElement<const Definition extends DeclarativeElementDefinition>(elementDefinition: Definition, ...args: Definition['InputsType'] extends EmptyObject ? [] : [Definition['InputsType']]): Promise<Definition["InstanceType"]>;

package/dist/test-web/render-element.js

@@ -0,0 +1,8 @@
+import { fixture } from '@open-wc/testing-helpers';
+import { html } from 'element-vir';
+export async function renderElement(elementDefinition, ...args) {
+    const instance = await fixture(html `
+        <${elementDefinition.assign(args[0] || {})}></${elementDefinition}>
+    `);
+    return instance;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@augment-vir/test",
-    "version": "31.23.3",
+    "version": "31.24.0",
     "description": "A universal testing suite that works with Mocha style test runners _and_ Node.js's built-in test runner.",
     "keywords": [
         "test",
@@ -43,8 +43,8 @@
         "test:web": "virmator test --no-deps web 'src/test-web/**/*.test.ts' 'src/augments/universal-testing-suite/**/*.test.ts'"
     },
     "dependencies": {
-        "@augment-vir/assert": "^31.23.3",
-        "@augment-vir/common": "^31.23.3",
+        "@augment-vir/assert": "^31.24.0",
+        "@augment-vir/common": "^31.24.0",
         "@open-wc/testing-helpers": "^3.0.1",
         "@virmator/test": "^13.15.3",
         "type-fest": "^4.41.0"
@@ -60,6 +60,9 @@
         "istanbul-smart-text-reporter": "^1.1.5",
         "typescript": "^5.8.3"
     },
+    "peerDependencies": {
+        "element-vir": "*"
+    },
     "engines": {
         "node": ">=22"
     },