@happyvertical/smrt-vitest 0.30.0

package/dist/a11y.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Accessibility assertion helper for component tests (Sweep S11, #1416).
+ *
+ * Runs axe-core against a rendered container and fails the test with a readable
+ * report if any violations are found. Use after a Testing Library `render()`:
+ *
+ *   import { render } from '@testing-library/svelte';
+ *   import { expectNoA11yViolations } from '@happyvertical/smrt-vitest/a11y';
+ *
+ *   const { container } = render(MyComponent, { props });
+ *   await expectNoA11yViolations(container);
+ *
+ * `color-contrast` is disabled by default: jsdom has no layout/paint engine, so
+ * contrast can't be computed and the rule produces non-deterministic noise.
+ * Pass `{ rules: { 'color-contrast': { enabled: true } } }` to override.
+ */
+import axe from 'axe-core';
+export declare function expectNoA11yViolations(container: HTMLElement, options?: axe.RunOptions): Promise<void>;
+//# sourceMappingURL=a11y.d.ts.map

package/dist/a11y.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.d.ts","sourceRoot":"","sources":["../src/a11y.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,GAAG,MAAM,UAAU,CAAC;AAG3B,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,WAAW,EACtB,OAAO,GAAE,GAAG,CAAC,UAAe,GAC3B,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/dist/a11y.js

@@ -0,0 +1,39 @@
+/**
+ * Accessibility assertion helper for component tests (Sweep S11, #1416).
+ *
+ * Runs axe-core against a rendered container and fails the test with a readable
+ * report if any violations are found. Use after a Testing Library `render()`:
+ *
+ *   import { render } from '@testing-library/svelte';
+ *   import { expectNoA11yViolations } from '@happyvertical/smrt-vitest/a11y';
+ *
+ *   const { container } = render(MyComponent, { props });
+ *   await expectNoA11yViolations(container);
+ *
+ * `color-contrast` is disabled by default: jsdom has no layout/paint engine, so
+ * contrast can't be computed and the rule produces non-deterministic noise.
+ * Pass `{ rules: { 'color-contrast': { enabled: true } } }` to override.
+ */
+import axe from 'axe-core';
+import { expect } from 'vitest';
+export async function expectNoA11yViolations(container, options = {}) {
+    const results = await axe.run(container, {
+        ...options,
+        // Merge rules last so caller-supplied rules extend (not replace) the
+        // color-contrast default; pass `{ 'color-contrast': { enabled: true } }` to
+        // opt back in.
+        rules: { 'color-contrast': { enabled: false }, ...options.rules },
+    });
+    if (results.violations.length > 0) {
+        const report = results.violations
+            .map((v) => {
+            const targets = v.nodes
+                .map((n) => `      - ${n.target.join(' ')}`)
+                .join('\n');
+            return `  [${v.id}] ${v.help}\n    ${v.helpUrl}\n${targets}`;
+        })
+            .join('\n');
+        expect.fail(`axe found ${results.violations.length} accessibility violation(s):\n${report}`);
+    }
+}
+//# sourceMappingURL=a11y.js.map

package/dist/a11y.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.js","sourceRoot":"","sources":["../src/a11y.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,SAAsB,EACtB,UAA0B,EAAE;IAE5B,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE;QACvC,GAAG,OAAO;QACV,qEAAqE;QACrE,4EAA4E;QAC5E,eAAe;QACf,KAAK,EAAE,EAAE,gBAAgB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE;KAClE,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU;aAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACT,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK;iBACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;iBAC3C,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,OAAO,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAC/D,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,CAAC,IAAI,CACT,aAAa,OAAO,CAAC,UAAU,CAAC,MAAM,iCAAiC,MAAM,EAAE,CAChF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,190 @@
+/**
+ * SMRT Vitest Plugin
+ *
+ * Automatically loads manifests from SMRT peer dependencies before tests run.
+ * This solves Issue #583 where cross-package integration tests fail because
+ * external package classes aren't registered in the test manifest.
+ *
+ * Uses ManifestManager for unified manifest loading, which properly handles
+ * the manifest priority order: .smrt/manifest.json (test) -> dist/manifest.json (production)
+ *
+ * @example
+ * ```typescript
+ * // vitest.config.ts
+ * import { defineConfig } from 'vitest/config';
+ * import { smrtVitestPlugin } from '@happyvertical/smrt-vitest';
+ *
+ * export default defineConfig({
+ *   plugins: [smrtVitestPlugin()],
+ *   test: {
+ *     globals: true,
+ *     environment: 'node',
+ *   },
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+import type { Plugin } from 'vitest/config';
+/**
+ * Configuration options for {@link smrtVitestPlugin} and
+ * {@link setupSmrtManifests}.
+ *
+ * All fields are optional — the defaults work for the typical single-package
+ * SMRT project.  Override them when you need to tune manifest generation,
+ * add extra packages, or adjust the scan scope.
+ */
+export interface SmrtVitestPluginOptions {
+    /**
+     * Extra `@happyvertical/smrt-*` package names whose manifests should be
+     * loaded in addition to those discovered automatically from `package.json`.
+     *
+     * Useful when a dependency is not listed in `dependencies`,
+     * `peerDependencies`, or `devDependencies` but still needs its classes
+     * registered (e.g., a dynamically loaded plugin).
+     *
+     * @default [] — only auto-discovered packages are loaded
+     */
+    packages?: string[];
+    /**
+     * Emit diagnostic log lines for each manifest discovered, loaded, or
+     * skipped.  Helpful when debugging "No field metadata found" errors.
+     *
+     * @default false
+     */
+    verbose?: boolean;
+    /**
+     * Project root used to locate `package.json` and to resolve relative
+     * manifest paths.
+     *
+     * @default process.cwd()
+     */
+    root?: string;
+    /**
+     * Automatically generate the local manifest at vitest startup using
+     * `ManifestBuilder`.  When `true`, there is no need to run
+     * `smrt generate:test` or `smrt test` before running vitest.
+     *
+     * The manifest is generated **once** at startup and cached for the session.
+     * In watch mode, restart vitest after adding new `@smrt()` classes or
+     * fields to pick up the changes.
+     *
+     * @default true
+     */
+    generateManifest?: boolean;
+    /**
+     * Glob patterns that determine which source files are scanned for SMRT
+     * classes when `generateManifest` is `true`.
+     *
+     * @default ['src/**\/*.ts']
+     */
+    include?: string[];
+    /**
+     * Glob patterns excluded from the manifest scan.
+     *
+     * @default ['**\/*.d.ts', '**\/node_modules/**', '**\/dist/**']
+     */
+    exclude?: string[];
+    /**
+     * Override the setup file injected into Vitest projects.
+     *
+     * Defaults to the published package entry. Workspace packages can point this
+     * at a local source file while still using the same plugin API.
+     */
+    setupFile?: string;
+}
+type ViteAliasEntry = {
+    find: string;
+    replacement: string;
+};
+export declare function getWorkspaceViteAliases(root?: string): ViteAliasEntry[];
+/**
+ * Create the SMRT Vitest plugin
+ *
+ * This plugin automatically generates and loads manifests before tests run,
+ * enabling cross-package integration tests without needing to run `smrt test` first.
+ *
+ * @param options - Plugin configuration options
+ * @returns Vitest plugin
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { defineConfig } from 'vitest/config';
+ * import { smrtVitestPlugin } from '@happyvertical/smrt-vitest';
+ *
+ * export default defineConfig({
+ *   plugins: [smrtVitestPlugin()],
+ * });
+ * ```
+ *
+ * @example With additional packages
+ * ```typescript
+ * import { defineConfig } from 'vitest/config';
+ * import { smrtVitestPlugin } from '@happyvertical/smrt-vitest';
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     smrtVitestPlugin({
+ *       packages: ['@my-org/custom-smrt-package'],
+ *       verbose: true,
+ *     }),
+ *   ],
+ * });
+ * ```
+ *
+ * @example Disable auto-generation (use pre-built manifest)
+ * ```typescript
+ * export default defineConfig({
+ *   plugins: [
+ *     smrtVitestPlugin({
+ *       generateManifest: false, // Use existing manifest only
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+export declare function smrtVitestPlugin(options?: SmrtVitestPluginOptions): Plugin;
+/**
+ * Discover and register SMRT manifests from peer dependencies.
+ *
+ * An imperative alternative to {@link smrtVitestPlugin} for environments
+ * where a Vite plugin is not available (e.g., a plain `globalSetup` file or
+ * a custom test runner bootstrap).
+ *
+ * The function reads `package.json` in the working directory, finds all
+ * `@happyvertical/smrt-*` dependencies, locates their manifest files, and
+ * registers every class in the global `ObjectRegistry`.  It does **not**
+ * generate a new manifest — use `smrtVitestPlugin()` with
+ * `generateManifest: true` (the default) if auto-generation is needed.
+ *
+ * @param options - Same options accepted by {@link smrtVitestPlugin}.
+ *   Relevant fields: `packages`, `verbose`, `root`.
+ * @returns A promise that resolves once all manifests have been loaded.
+ *
+ * @example
+ * ```typescript
+ * // vitest.config.ts
+ * import { defineConfig } from 'vitest/config';
+ *
+ * export default defineConfig({
+ *   test: {
+ *     globalSetup: ['@happyvertical/smrt-vitest/setup'],
+ *   },
+ * });
+ * ```
+ *
+ * @example Calling directly in a custom bootstrap
+ * ```typescript
+ * import { setupSmrtManifests } from '@happyvertical/smrt-vitest';
+ *
+ * await setupSmrtManifests({ verbose: true });
+ * ```
+ *
+ * @see {@link smrtVitestPlugin} for the recommended Vite-plugin approach that
+ *   also handles manifest generation.
+ */
+export declare function setupSmrtManifests(options?: SmrtVitestPluginOptions): Promise<void>;
+export default smrtVitestPlugin;
+export { createIsolatedTestDb, createIsolatedTestDbFromManifest, createTestDb, getAdapterDisplayName, getInMemoryDbConfig, getTestAdapter, getTestDbConfig, type IsolatedTestDbOptions, type IsolatedTestDbResult, isPostgresAvailable, type ManifestTestDbOptions, type TestDbAdapter, type TestDbConfig, } from './test-db.js';
+export type { TransactionHandle } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgBD,KAAK,cAAc,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAkGF,wBAAgB,uBAAuB,CACrC,IAAI,SAAgB,GACnB,cAAc,EAAE,CAyQlB;AA0ZD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAuKR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED,eAAe,gBAAgB,CAAC;AAGhC,OAAO,EACL,oBAAoB,EACpB,gCAAgC,EAChC,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}