@baseplate-dev/core-generators 0.3.7 → 0.4.0

package/dist/test-helpers/import-map-helpers.js

@@ -0,0 +1,33 @@
+import { createTsImportMap } from '../renderers/typescript/import-maps/ts-import-map.js';
+/**
+ * Creates a test import map with consistent module specifiers for testing
+ *
+ * Each import will use the pattern `<name>/<importKey>`, making it easy to
+ * identify which test module an import comes from
+ *
+ * @param importSchema - The import map schema to use
+ * @param name - Base name for the module (e.g., 'data-utils')
+ * @returns A mock import provider for testing
+ *
+ * @example
+ * ```typescript
+ * const schema = createTsImportMapSchema({
+ *   scalarField: {},
+ *   relationHelpers: {},
+ * });
+ *
+ * const imports = createTestTsImportMap(schema, 'data-utils');
+ * // Creates imports:
+ * //   scalarField -> 'data-utils/scalarField'
+ * //   relationHelpers -> 'data-utils/relationHelpers'
+ * ```
+ */
+export function createTestTsImportMap(importSchema, name) {
+    // Build the imports object based on the schema
+    const imports = {};
+    for (const key of Object.keys(importSchema)) {
+        imports[key] = `${name}/${key}`;
+    }
+    return createTsImportMap(importSchema, imports);
+}
+//# sourceMappingURL=import-map-helpers.js.map

package/dist/test-helpers/import-map-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-map-helpers.js","sourceRoot":"","sources":["../../src/test-helpers/import-map-helpers.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sDAAsD,CAAC;AAEzF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,qBAAqB,CAEnC,YAAe,EAAE,IAAY;IAC7B,+CAA+C;IAC/C,MAAM,OAAO,GAA2B,EAAE,CAAC;IAE3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC;IAClC,CAAC;IAED,OAAO,iBAAiB,CAAC,YAAY,EAAE,OAAkC,CAAC,CAAC;AAC7E,CAAC"}

package/dist/test-helpers/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Test helpers for @baseplate-dev/core-generators
+ *
+ * This module provides utilities for testing code generators, including:
+ * - Custom Vitest matchers for TypeScript fragments
+ * - Utilities for creating mock import providers
+ * - Fragment comparison functions
+ *
+ * @example
+ * ```typescript
+ * import { createTestTsImportMap, extendFragmentMatchers } from '@baseplate-dev/core-generators/test-helpers';
+ *
+ * // Extend Vitest matchers (call once in setup)
+ * extendFragmentMatchers();
+ *
+ * // Create mock import providers for testing
+ * const imports = createTestTsImportMap(schema);
+ *
+ * // Use custom matchers in tests
+ * expect(fragment).toMatchTsFragment(expectedFragment);
+ * expect(fragment).toIncludeImport('z', 'zod');
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { createTestTsImportMap } from './import-map-helpers.js';
+export { extendFragmentMatchers, fragmentMatchers, type ToIncludeImportOptions, type ToMatchTsFragmentOptions, } from './matchers.js';
+export { areFragmentsEqual, type CompareFragmentsOptions, normalizeFragment, } from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/test-helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test-helpers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,GAC9B,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,iBAAiB,EACjB,KAAK,uBAAuB,EAC5B,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/test-helpers/index.js

@@ -0,0 +1,32 @@
+/**
+ * Test helpers for @baseplate-dev/core-generators
+ *
+ * This module provides utilities for testing code generators, including:
+ * - Custom Vitest matchers for TypeScript fragments
+ * - Utilities for creating mock import providers
+ * - Fragment comparison functions
+ *
+ * @example
+ * ```typescript
+ * import { createTestTsImportMap, extendFragmentMatchers } from '@baseplate-dev/core-generators/test-helpers';
+ *
+ * // Extend Vitest matchers (call once in setup)
+ * extendFragmentMatchers();
+ *
+ * // Create mock import providers for testing
+ * const imports = createTestTsImportMap(schema);
+ *
+ * // Use custom matchers in tests
+ * expect(fragment).toMatchTsFragment(expectedFragment);
+ * expect(fragment).toIncludeImport('z', 'zod');
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Export import map helpers
+export { createTestTsImportMap } from './import-map-helpers.js';
+// Export matcher functions and types
+export { extendFragmentMatchers, fragmentMatchers, } from './matchers.js';
+// Export utility functions
+export { areFragmentsEqual, normalizeFragment, } from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/test-helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/test-helpers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,4BAA4B;AAC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,qCAAqC;AACrC,OAAO,EACL,sBAAsB,EACtB,gBAAgB,GAGjB,MAAM,eAAe,CAAC;AAEvB,2BAA2B;AAC3B,OAAO,EACL,iBAAiB,EAEjB,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/test-helpers/matchers.d.ts

@@ -0,0 +1,91 @@
+import type { TsCodeFragment } from '../renderers/typescript/index.js';
+/**
+ * Options for toMatchTsFragment matcher
+ */
+export interface ToMatchTsFragmentOptions {
+    /**
+     * Whether to ignore hoisted fragments in comparison (default: false)
+     */
+    ignoreHoistedFragments?: boolean;
+}
+/**
+ * Options for toIncludeImport matcher
+ */
+export interface ToIncludeImportOptions {
+    /**
+     * Whether the import should be type-only
+     */
+    isTypeOnly?: boolean;
+}
+/**
+ * Custom Vitest matchers for TypeScript code fragments
+ */
+export declare const fragmentMatchers: {
+    /**
+     * Asserts that a TypeScript fragment matches the expected fragment
+     * Compares contents, imports (order-independent), and optionally hoisted fragments
+     *
+     * @example
+     * ```typescript
+     * expect(actualFragment).toMatchTsFragment(expectedFragment);
+     * expect(actualFragment).toMatchTsFragment(expectedFragment, {
+     *   ignoreHoistedFragments: true
+     * });
+     * ```
+     */
+    toMatchTsFragment(this: {
+        isNot: boolean;
+    }, received: TsCodeFragment, expected: TsCodeFragment, options?: ToMatchTsFragmentOptions): {
+        pass: boolean;
+        message: () => string;
+    };
+    /**
+     * Asserts that a fragment includes a specific import
+     *
+     * @example
+     * ```typescript
+     * expect(fragment).toIncludeImport('z', 'zod');
+     * expect(fragment).toIncludeImport('Prisma', '@prisma/client', { isTypeOnly: true });
+     * ```
+     */
+    toIncludeImport(this: {
+        isNot: boolean;
+    }, received: TsCodeFragment, name: string, from: string, options?: ToIncludeImportOptions): {
+        pass: boolean;
+        message: () => string;
+    };
+};
+/**
+ * Extends Vitest's expect with custom matchers for TypeScript fragments
+ * Call this function once in your test setup to enable the matchers
+ *
+ * @example
+ * ```typescript
+ * // In test setup file or at the top of test file
+ * import { extendFragmentMatchers } from '@baseplate-dev/core-generators/test-helpers';
+ *
+ * extendFragmentMatchers();
+ * ```
+ */
+export declare function extendFragmentMatchers(): void;
+/**
+ * TypeScript module augmentation for custom matchers
+ * This provides type checking and autocomplete for the custom matchers
+ */
+interface FragmentMatchers<R = unknown> {
+    /**
+     * Asserts that a TypeScript fragment matches the expected fragment
+     * Compares contents, imports (order-independent), and optionally hoisted fragments
+     */
+    toMatchTsFragment(expected: TsCodeFragment, options?: ToMatchTsFragmentOptions): R;
+    /**
+     * Asserts that a fragment includes a specific import
+     */
+    toIncludeImport(name: string, from: string, options?: ToIncludeImportOptions): R;
+}
+declare module 'vitest' {
+    interface Matchers<T = any> extends FragmentMatchers<T> {
+    }
+}
+export {};
+//# sourceMappingURL=matchers.d.ts.map

package/dist/test-helpers/matchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchers.d.ts","sourceRoot":"","sources":["../../src/test-helpers/matchers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,kCAAkC,CAAC;AAI1C;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAuED;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;;;;;;;;;;OAWG;4BAEK;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,YACd,cAAc,YACd,cAAc,YACd,wBAAwB;;;;IA6EpC;;;;;;;;OAQG;0BAEK;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,YACd,cAAc,QAClB,MAAM,QACN,MAAM,YACF,sBAAsB;;;;CAiCnC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;GAGG;AACH,UAAU,gBAAgB,CAAC,CAAC,GAAG,OAAO;IACpC;;;OAGG;IACH,iBAAiB,CACf,QAAQ,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,wBAAwB,GACjC,CAAC,CAAC;IACL;;OAEG;IACH,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,sBAAsB,GAC/B,CAAC,CAAC;CACN;AAED,OAAO,QAAQ,QAAQ,CAAC;IAEtB,UAAU,QAAQ,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;KAAG;CAC3D"}

package/dist/test-helpers/matchers.js

@@ -0,0 +1,167 @@
+import { expect } from 'vitest';
+import { areFragmentsEqual, normalizeFragment } from './utils.js';
+/**
+ * Formats imports for display in error messages
+ */
+function formatImports(imports) {
+    if (!imports || imports.length === 0)
+        return '(none)';
+    return imports
+        .map((imp) => {
+        const parts = [];
+        if (imp.isTypeOnly)
+            parts.push('type');
+        if (imp.namespaceImport) {
+            parts.push(`* as ${imp.namespaceImport}`);
+        }
+        if (imp.defaultImport) {
+            parts.push(imp.defaultImport);
+        }
+        if (imp.namedImports && imp.namedImports.length > 0) {
+            const namedStr = imp.namedImports
+                .map((ni) => (ni.alias ? `${ni.name} as ${ni.alias}` : ni.name))
+                .join(', ');
+            parts.push(`{ ${namedStr} }`);
+        }
+        return `  ${parts.join(' ')} from '${imp.moduleSpecifier}'`;
+    })
+        .join('\n');
+}
+/**
+ * Formats hoisted fragments for display in error messages
+ */
+function formatHoistedFragments(fragments) {
+    if (!fragments || fragments.length === 0)
+        return '(none)';
+    return fragments
+        .map((frag) => `  [${frag.key}]: ${frag.contents}`)
+        .join('\n');
+}
+/**
+ * Checks if an import declaration contains a specific named import
+ */
+function hasNamedImport(imp, name, options) {
+    if (!imp.namedImports)
+        return false;
+    return imp.namedImports.some((ni) => {
+        if (ni.name !== name)
+            return false;
+        // If isTypeOnly is specified in options, check it matches
+        if (options?.isTypeOnly !== undefined) {
+            // Check both the named import level and the declaration level
+            const isImportTypeOnly = ni.isTypeOnly ?? imp.isTypeOnly ?? false;
+            return isImportTypeOnly === options.isTypeOnly;
+        }
+        return true;
+    });
+}
+/**
+ * Custom Vitest matchers for TypeScript code fragments
+ */
+export const fragmentMatchers = {
+    /**
+     * Asserts that a TypeScript fragment matches the expected fragment
+     * Compares contents, imports (order-independent), and optionally hoisted fragments
+     *
+     * @example
+     * ```typescript
+     * expect(actualFragment).toMatchTsFragment(expectedFragment);
+     * expect(actualFragment).toMatchTsFragment(expectedFragment, {
+     *   ignoreHoistedFragments: true
+     * });
+     * ```
+     */
+    toMatchTsFragment(received, expected, options) {
+        const { isNot } = this;
+        // Normalize both fragments for comparison
+        const normalizedReceived = normalizeFragment(received, {
+            compareHoistedFragments: !options?.ignoreHoistedFragments,
+        });
+        const normalizedExpected = normalizeFragment(expected, {
+            compareHoistedFragments: !options?.ignoreHoistedFragments,
+        });
+        // Check equality
+        const pass = areFragmentsEqual(received, expected, {
+            compareHoistedFragments: !options?.ignoreHoistedFragments,
+        });
+        return {
+            pass,
+            message: () => {
+                if (pass && isNot) {
+                    return 'Expected fragments not to be equal';
+                }
+                const messages = ['Expected fragments to be equal'];
+                // Check contents
+                if (normalizedReceived.contents !== normalizedExpected.contents) {
+                    messages.push('', 'Contents:', `  Expected: ${normalizedExpected.contents}`, `  Received: ${normalizedReceived.contents}`);
+                }
+                // Check imports
+                const receivedImportsStr = formatImports(normalizedReceived.imports);
+                const expectedImportsStr = formatImports(normalizedExpected.imports);
+                if (receivedImportsStr !== expectedImportsStr) {
+                    messages.push('', 'Imports:', 'Expected:', expectedImportsStr, 'Received:', receivedImportsStr);
+                }
+                // Check hoisted fragments if not ignored
+                if (!options?.ignoreHoistedFragments) {
+                    const receivedHoistedStr = formatHoistedFragments(normalizedReceived.hoistedFragments);
+                    const expectedHoistedStr = formatHoistedFragments(normalizedExpected.hoistedFragments);
+                    if (receivedHoistedStr !== expectedHoistedStr) {
+                        messages.push('', 'Hoisted Fragments:', 'Expected:', expectedHoistedStr, 'Received:', receivedHoistedStr);
+                    }
+                }
+                return messages.join('\n');
+            },
+        };
+    },
+    /**
+     * Asserts that a fragment includes a specific import
+     *
+     * @example
+     * ```typescript
+     * expect(fragment).toIncludeImport('z', 'zod');
+     * expect(fragment).toIncludeImport('Prisma', '@prisma/client', { isTypeOnly: true });
+     * ```
+     */
+    toIncludeImport(received, name, from, options) {
+        const { isNot } = this;
+        const imports = received.imports ?? [];
+        const matchingImport = imports.find((imp) => imp.moduleSpecifier === from);
+        const pass = matchingImport !== undefined &&
+            hasNamedImport(matchingImport, name, options);
+        return {
+            pass,
+            message: () => {
+                if (pass && isNot) {
+                    const typeOnlyStr = options?.isTypeOnly ? ' (type-only)' : '';
+                    return `Expected not to include import "${name}"${typeOnlyStr} from "${from}"`;
+                }
+                const typeOnlyStr = options?.isTypeOnly ? ' (type-only)' : '';
+                const foundFrom = matchingImport
+                    ? `, but found import from "${matchingImport.moduleSpecifier}"`
+                    : '';
+                return [
+                    `Expected to include import "${name}"${typeOnlyStr} from "${from}"${foundFrom}`,
+                    '',
+                    'Available imports:',
+                    formatImports(imports),
+                ].join('\n');
+            },
+        };
+    },
+};
+/**
+ * Extends Vitest's expect with custom matchers for TypeScript fragments
+ * Call this function once in your test setup to enable the matchers
+ *
+ * @example
+ * ```typescript
+ * // In test setup file or at the top of test file
+ * import { extendFragmentMatchers } from '@baseplate-dev/core-generators/test-helpers';
+ *
+ * extendFragmentMatchers();
+ * ```
+ */
+export function extendFragmentMatchers() {
+    expect.extend(fragmentMatchers);
+}
+//# sourceMappingURL=matchers.js.map

package/dist/test-helpers/matchers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchers.js","sourceRoot":"","sources":["../../src/test-helpers/matchers.ts"],"names":[],"mappings":"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"}

package/dist/test-helpers/setup.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Auto-setup file for test helpers
+ *
+ * This file automatically extends Vitest matchers when imported.
+ * Add this to your vitest.config.ts setupFiles to enable custom matchers globally.
+ *
+ * @example
+ * ```typescript
+ * // vitest.config.ts
+ * export default defineConfig({
+ *   test: {
+ *     setupFiles: ['@baseplate-dev/core-generators/test-helpers/setup']
+ *   }
+ * });
+ * ```
+ */
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/test-helpers/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/test-helpers/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/test-helpers/setup.js

@@ -0,0 +1,20 @@
+/**
+ * Auto-setup file for test helpers
+ *
+ * This file automatically extends Vitest matchers when imported.
+ * Add this to your vitest.config.ts setupFiles to enable custom matchers globally.
+ *
+ * @example
+ * ```typescript
+ * // vitest.config.ts
+ * export default defineConfig({
+ *   test: {
+ *     setupFiles: ['@baseplate-dev/core-generators/test-helpers/setup']
+ *   }
+ * });
+ * ```
+ */
+import { extendFragmentMatchers } from './matchers.js';
+// Automatically extend matchers when this file is imported
+extendFragmentMatchers();
+//# sourceMappingURL=setup.js.map

package/dist/test-helpers/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/test-helpers/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEvD,2DAA2D;AAC3D,sBAAsB,EAAE,CAAC"}

package/dist/test-helpers/utils.d.ts

@@ -0,0 +1,55 @@
+import type { TsCodeFragment, TsHoistedFragment, TsImportDeclaration } from '../renderers/typescript/index.js';
+/**
+ * Options for fragment comparison
+ */
+export interface CompareFragmentsOptions {
+    /**
+     * Whether to compare hoisted fragments (default: true)
+     */
+    compareHoistedFragments?: boolean;
+}
+/**
+ * Normalizes imports for comparison by sorting them in a deterministic order
+ * This allows order-independent comparison of imports
+ *
+ * @param imports - Array of import declarations to normalize
+ * @returns Normalized array of import declarations
+ */
+export declare function normalizeImports(imports: TsImportDeclaration[]): TsImportDeclaration[];
+/**
+ * Normalizes hoisted fragments for comparison by sorting them by key
+ *
+ * @param fragments - Array of hoisted fragments to normalize
+ * @returns Normalized array of hoisted fragments
+ */
+export declare function normalizeHoistedFragments(fragments?: TsHoistedFragment[]): TsHoistedFragment[] | undefined;
+/**
+ * Normalizes a code fragment for comparison
+ * This includes trimming contents, sorting imports, and normalizing hoisted fragments
+ *
+ * @param fragment - The fragment to normalize
+ * @param options - Options for normalization
+ * @returns Normalized fragment
+ */
+export declare function normalizeFragment(fragment: TsCodeFragment, options?: CompareFragmentsOptions): TsCodeFragment;
+/**
+ * Compares two TsCodeFragment objects for equality, ignoring import order
+ * This is useful for programmatic checks outside of test assertions
+ *
+ * @param actual - The actual fragment
+ * @param expected - The expected fragment
+ * @param options - Comparison options
+ * @returns True if fragments are equal
+ *
+ * @example
+ * ```typescript
+ * const actual = tsCodeFragment('foo()', ...);
+ * const expected = tsCodeFragment('foo()', ...);
+ *
+ * if (areFragmentsEqual(actual, expected)) {
+ *   console.log('Fragments match!');
+ * }
+ * ```
+ */
+export declare function areFragmentsEqual(actual: TsCodeFragment, expected: TsCodeFragment, options?: CompareFragmentsOptions): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/test-helpers/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/test-helpers/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,kCAAkC,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,mBAAmB,EAAE,GAC7B,mBAAmB,EAAE,CAmCvB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,CAAC,EAAE,iBAAiB,EAAE,GAC9B,iBAAiB,EAAE,GAAG,SAAS,CAajC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,uBAAuB,GAChC,cAAc,CAqBhB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAKT"}

package/dist/test-helpers/utils.js

@@ -0,0 +1,118 @@
+import { isDeepStrictEqual } from 'node:util';
+/**
+ * Normalizes imports for comparison by sorting them in a deterministic order
+ * This allows order-independent comparison of imports
+ *
+ * @param imports - Array of import declarations to normalize
+ * @returns Normalized array of import declarations
+ */
+export function normalizeImports(imports) {
+    return imports
+        .map((imp) => ({
+        ...imp,
+        // Sort named imports alphabetically
+        namedImports: imp.namedImports?.slice().sort((a, b) => {
+            const nameCompare = a.name.localeCompare(b.name);
+            if (nameCompare !== 0)
+                return nameCompare;
+            // If names are equal, sort by alias
+            return (a.alias ?? '').localeCompare(b.alias ?? '');
+        }),
+    }))
+        .sort((a, b) => {
+        // Primary sort: module specifier
+        const moduleCompare = a.moduleSpecifier.localeCompare(b.moduleSpecifier);
+        if (moduleCompare !== 0)
+            return moduleCompare;
+        // Secondary sort: import type (namespace > default > named)
+        const getImportTypeOrder = (imp) => {
+            if (imp.namespaceImport)
+                return 1;
+            if (imp.defaultImport)
+                return 2;
+            if (imp.namedImports)
+                return 3;
+            return 4;
+        };
+        const typeOrderA = getImportTypeOrder(a);
+        const typeOrderB = getImportTypeOrder(b);
+        if (typeOrderA !== typeOrderB)
+            return typeOrderA - typeOrderB;
+        // Tertiary sort: isTypeOnly (type-only imports first)
+        if (a.isTypeOnly && !b.isTypeOnly)
+            return -1;
+        if (!a.isTypeOnly && b.isTypeOnly)
+            return 1;
+        return 0;
+    });
+}
+/**
+ * Normalizes hoisted fragments for comparison by sorting them by key
+ *
+ * @param fragments - Array of hoisted fragments to normalize
+ * @returns Normalized array of hoisted fragments
+ */
+export function normalizeHoistedFragments(fragments) {
+    if (!fragments || fragments.length === 0)
+        return undefined;
+    return [...fragments]
+        .map((frag) => {
+        const normalized = normalizeFragment(frag);
+        // Preserve the key property from the original hoisted fragment
+        return {
+            ...normalized,
+            key: frag.key,
+        };
+    })
+        .sort((a, b) => a.key.localeCompare(b.key));
+}
+/**
+ * Normalizes a code fragment for comparison
+ * This includes trimming contents, sorting imports, and normalizing hoisted fragments
+ *
+ * @param fragment - The fragment to normalize
+ * @param options - Options for normalization
+ * @returns Normalized fragment
+ */
+export function normalizeFragment(fragment, options) {
+    const normalized = {
+        contents: fragment.contents.trim(),
+    };
+    // Only include imports if they exist
+    if (fragment.imports && fragment.imports.length > 0) {
+        normalized.imports = normalizeImports(fragment.imports);
+    }
+    // Only include hoisted fragments if they exist and should be compared
+    if (options?.compareHoistedFragments !== false && fragment.hoistedFragments) {
+        const normalizedHoisted = normalizeHoistedFragments(fragment.hoistedFragments);
+        if (normalizedHoisted) {
+            normalized.hoistedFragments = normalizedHoisted;
+        }
+    }
+    return normalized;
+}
+/**
+ * Compares two TsCodeFragment objects for equality, ignoring import order
+ * This is useful for programmatic checks outside of test assertions
+ *
+ * @param actual - The actual fragment
+ * @param expected - The expected fragment
+ * @param options - Comparison options
+ * @returns True if fragments are equal
+ *
+ * @example
+ * ```typescript
+ * const actual = tsCodeFragment('foo()', ...);
+ * const expected = tsCodeFragment('foo()', ...);
+ *
+ * if (areFragmentsEqual(actual, expected)) {
+ *   console.log('Fragments match!');
+ * }
+ * ```
+ */
+export function areFragmentsEqual(actual, expected, options) {
+    const normalizedActual = normalizeFragment(actual, options);
+    const normalizedExpected = normalizeFragment(expected, options);
+    return isDeepStrictEqual(normalizedActual, normalizedExpected);
+}
+//# sourceMappingURL=utils.js.map

package/dist/test-helpers/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/test-helpers/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baseplate-dev/core-generators",
-  "version": "0.3.7",
+  "version": "0.4.0",
   "description": "Core generators for Baseplate",
   "keywords": [
     "code-generation",
@@ -35,6 +35,18 @@
     "./extractors": {
       "types": "./dist/renderers/extractors.d.ts",
       "default": "./dist/renderers/extractors.js"
+    },
+    "./test-helpers": {
+      "types": "./dist/test-helpers/index.d.ts",
+      "default": "./dist/test-helpers/index.js"
+    },
+    "./test-helpers/setup": {
+      "types": "./dist/test-helpers/setup.d.ts",
+      "default": "./dist/test-helpers/setup.js"
+    },
+    "./test-helpers/vitest-types": {
+      "types": "./dist/test-helpers/vitest-types.d.ts",
+      "default": "./dist/test-helpers/vitest-types.js"
     }
   },
   "main": "dist/index.js",
@@ -58,9 +70,10 @@
     "semver": "^7.5.4",
     "sort-package-json": "2.10.1",
     "ts-morph": "26.0.0",
+    "yaml": "2.8.1",
     "zod": "3.25.76",
-    "@baseplate-dev/sync": "0.3.7",
-    "@baseplate-dev/utils": "0.3.7"
+    "@baseplate-dev/sync": "0.4.0",
+    "@baseplate-dev/utils": "0.4.0"
   },
   "devDependencies": {
     "@types/node": "^22.17.2",
@@ -71,7 +84,7 @@
     "eslint": "9.32.0",
     "typescript": "5.8.3",
     "vitest": "3.2.4",
-    "@baseplate-dev/tools": "0.3.7"
+    "@baseplate-dev/tools": "0.4.0"
   },
   "engines": {
     "node": "^22.0.0"