@baseplate-dev/core-generators 0.4.4 → 0.5.1

package/dist/test-helpers/snapshot-serializer.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Vitest snapshot serializer for TsCodeFragment
+ *
+ * Produces readable snapshots that look like actual TypeScript code output.
+ *
+ * @example
+ * ```typescript
+ * // In test setup file
+ * import { extendFragmentSerializer } from '@baseplate-dev/core-generators/test-helpers';
+ *
+ * extendFragmentSerializer();
+ *
+ * // In tests
+ * expect(fragment).toMatchSnapshot();
+ * ```
+ *
+ * @packageDocumentation
+ */
+import type { TsCodeFragment } from '../renderers/typescript/index.js';
+/**
+ * Vitest snapshot serializer for TsCodeFragment
+ *
+ * Produces TypeScript-like snapshots showing:
+ * - Hoisted fragments (if any) as nested TsCodeFragment blocks
+ * - Import statements as actual TypeScript import syntax
+ * - Fragment contents as code
+ */
+export declare const tsFragmentSerializer: {
+    /**
+     * Tests if the value is a TsCodeFragment
+     */
+    test(val: unknown): boolean;
+    /**
+     * Serializes a TsCodeFragment to a readable string format
+     */
+    serialize(val: TsCodeFragment, config: {
+        indent: string;
+    }, indentation: string): string;
+};
+/**
+ * Extends Vitest with the TsCodeFragment snapshot serializer
+ * Call this function once in your test setup to enable the serializer
+ *
+ * @example
+ * ```typescript
+ * // In test setup file or at the top of test file
+ * import { extendFragmentSerializer } from '@baseplate-dev/core-generators/test-helpers';
+ *
+ * extendFragmentSerializer();
+ * ```
+ */
+export declare function extendFragmentSerializer(): void;
+//# sourceMappingURL=snapshot-serializer.d.ts.map

package/dist/test-helpers/snapshot-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-serializer.d.ts","sourceRoot":"","sources":["../../src/test-helpers/snapshot-serializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,kCAAkC,CAAC;AA6F1C;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;OAEG;cACO,OAAO,GAAG,OAAO;IAI3B;;OAEG;mBAEI,cAAc,UACX;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,eACb,MAAM,GAClB,MAAM;CAGV,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/test-helpers/snapshot-serializer.js

@@ -0,0 +1,125 @@
+/**
+ * Vitest snapshot serializer for TsCodeFragment
+ *
+ * Produces readable snapshots that look like actual TypeScript code output.
+ *
+ * @example
+ * ```typescript
+ * // In test setup file
+ * import { extendFragmentSerializer } from '@baseplate-dev/core-generators/test-helpers';
+ *
+ * extendFragmentSerializer();
+ *
+ * // In tests
+ * expect(fragment).toMatchSnapshot();
+ * ```
+ *
+ * @packageDocumentation
+ */
+import { expect } from 'vitest';
+import { normalizeFragment } from './utils.js';
+/**
+ * Type guard to detect TsCodeFragment objects
+ */
+function isTsCodeFragment(val) {
+    return (val !== null &&
+        typeof val === 'object' &&
+        'contents' in val &&
+        typeof val.contents === 'string');
+}
+/**
+ * Formats a single import declaration as a TypeScript import statement
+ */
+function formatImportStatement(imp) {
+    const parts = [];
+    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) => {
+            const name = ni.alias ? `${ni.name} as ${ni.alias}` : ni.name;
+            return ni.isTypeOnly ? `type ${name}` : name;
+        })
+            .join(', ');
+        parts.push(`{ ${namedStr} }`);
+    }
+    const importKeyword = imp.isTypeOnly ? 'import type' : 'import';
+    return `${importKeyword} ${parts.join(', ')} from '${imp.moduleSpecifier}';`;
+}
+/**
+ * Indents all lines in a string
+ */
+function indentLines(text, indent) {
+    return text
+        .split('\n')
+        .map((line) => (line ? `${indent}${line}` : line))
+        .join('\n');
+}
+/**
+ * Serializes a TsCodeFragment to TypeScript-like output
+ */
+function serializeFragment(fragment, baseIndent, indentUnit) {
+    const normalized = normalizeFragment(fragment);
+    const lines = [];
+    // Hoisted fragments (if present) - each as "Hoisted [key]:"
+    if (normalized.hoistedFragments && normalized.hoistedFragments.length > 0) {
+        for (const frag of normalized.hoistedFragments) {
+            lines.push(`${baseIndent}Hoisted [${frag.key}]:`);
+            // Recursively serialize the hoisted fragment
+            const nestedOutput = serializeFragment(frag, baseIndent + indentUnit, indentUnit);
+            lines.push(nestedOutput, ''); // blank line between hoisted fragments
+        }
+    }
+    // Import statements (if present)
+    if (normalized.imports && normalized.imports.length > 0) {
+        for (const imp of normalized.imports) {
+            lines.push(`${baseIndent}${formatImportStatement(imp)}`);
+        }
+        lines.push(''); // blank line after imports
+    }
+    // Fragment contents
+    lines.push(indentLines(normalized.contents, baseIndent));
+    return lines.join('\n');
+}
+/**
+ * Vitest snapshot serializer for TsCodeFragment
+ *
+ * Produces TypeScript-like snapshots showing:
+ * - Hoisted fragments (if any) as nested TsCodeFragment blocks
+ * - Import statements as actual TypeScript import syntax
+ * - Fragment contents as code
+ */
+export const tsFragmentSerializer = {
+    /**
+     * Tests if the value is a TsCodeFragment
+     */
+    test(val) {
+        return isTsCodeFragment(val);
+    },
+    /**
+     * Serializes a TsCodeFragment to a readable string format
+     */
+    serialize(val, config, indentation) {
+        return serializeFragment(val, indentation, config.indent);
+    },
+};
+/**
+ * Extends Vitest with the TsCodeFragment snapshot serializer
+ * Call this function once in your test setup to enable the serializer
+ *
+ * @example
+ * ```typescript
+ * // In test setup file or at the top of test file
+ * import { extendFragmentSerializer } from '@baseplate-dev/core-generators/test-helpers';
+ *
+ * extendFragmentSerializer();
+ * ```
+ */
+export function extendFragmentSerializer() {
+    expect.addSnapshotSerializer(tsFragmentSerializer);
+}
+//# sourceMappingURL=snapshot-serializer.js.map

package/dist/test-helpers/snapshot-serializer.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baseplate-dev/core-generators",
-  "version": "0.4.4",
+  "version": "0.5.1",
   "description": "Core generators for Baseplate",
   "keywords": [
     "code-generation",
@@ -39,14 +39,6 @@
     "./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",
@@ -72,8 +64,8 @@
     "ts-morph": "26.0.0",
     "yaml": "2.8.1",
     "zod": "^4.1.13",
-    "@baseplate-dev/sync": "0.4.4",
-    "@baseplate-dev/utils": "0.4.4"
+    "@baseplate-dev/sync": "0.5.1",
+    "@baseplate-dev/utils": "0.5.1"
   },
   "devDependencies": {
     "@types/node": "^22.17.2",
@@ -83,8 +75,8 @@
     "cpx2": "8.0.0",
     "eslint": "9.32.0",
     "typescript": "5.8.3",
-    "vitest": "3.2.4",
-    "@baseplate-dev/tools": "0.4.4"
+    "vitest": "4.0.16",
+    "@baseplate-dev/tools": "0.5.1"
   },
   "engines": {
     "node": "^22.0.0"