@alloy-js/core 0.23.0-dev.13 → 0.23.0-dev.16

package/testing/vitest.d.ts

@@ -1,8 +1,23 @@
+/**
+ * Vitest matcher type augmentations for alloy testing.
+ *
+ * Consumers load these types via `"types": ["@alloy-js/core/testing/matchers"]`
+ * in their tsconfig.json. This file is resolved directly from the source tree
+ * (not from dist/), so it **must remain self-contained** — do NOT add imports
+ * that resolve to .ts source files (e.g. `./extend-expect.js`). Doing so pulls
+ * the entire src/ tree into the consumer's compilation, creating a dual-module
+ * identity conflict between src/ types and dist/ types that produces TS errors.
+ *
+ * If matcher signatures change, update the inlined types here to match.
+ */
 import "vitest";
 
-interface ToRenderToRenderOptions {
+interface ToRenderToOptions {
+  /** Maximum line width before the formatter wraps output. */
   printWidth?: number;
+  /** Number of spaces per indentation level. */
   tabWidth?: number;
+  /** Use tab characters instead of spaces. */
   useTabs?: boolean;
 }
 
@@ -14,11 +29,11 @@ interface ExpectedDiagnostic {
 interface CustomMatchers<R = unknown> {
   toRenderTo: (
     str: string | Record<string, string>,
-    options?: ToRenderToRenderOptions,
+    options?: ToRenderToOptions,
   ) => R;
   toRenderToAsync: (
     str: string | Record<string, string>,
-    options?: ToRenderToRenderOptions,
+    options?: ToRenderToOptions,
   ) => Promise<R>;
   toHaveDiagnostics: (expectedDiagnostics: ExpectedDiagnostic[]) => R;
   toHaveDiagnosticsAsync: (