refactor: update default output directory

Author: hobbescodes

.changeset/change-default-output.md

@@ -0,0 +1,22 @@
+---
+"tangrams": minor
+---
+
+**BREAKING:** Changed default output directory from `./src/generated` to `./tangrams`.
+
+Users upgrading should either:
+- Update their imports to use the new default location
+- Explicitly set `output: "./src/generated"` in their config to maintain the previous behavior
+
+We recommend using a `@tangrams/*` path alias in your `tsconfig.json` for cleaner imports:
+
+```json
+{
+  "compilerOptions": {
+    "paths": {
+      "@tangrams/*": ["./tangrams/*"]
+    }
+  },
+  "include": ["src", "tangrams"]
+}
+```

apps/docs/content/docs/index.mdx

@@ -92,8 +92,8 @@ Here's a comprehensive example showing all available configuration options:
 import { defineConfig } from "tangrams"
 
 export default defineConfig({
-  // Output directory for all generated files (default: "./src/generated")
-  output: "./src/generated",
+  // Output directory for all generated files (default: "./tangrams")
+  output: "./tangrams",
 
   // Validation library for generated schemas (default: "zod")
   // Supported: "zod", "valibot", "arktype"
@@ -229,7 +229,7 @@ export default defineConfig({
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `output` | `string` | `"./src/generated"` | Output directory for all generated files |
+| `output` | `string` | `"./tangrams"` | Output directory for all generated files |
 | `validator` | `"zod" \| "valibot" \| "arktype"` | `"zod"` | Validation library for generated schemas |
 | `sources` | `SourceConfig[]` | (required) | Array of data sources (minimum 1 required) |
 
@@ -450,7 +450,7 @@ overrides: {
 Generated files are organized by source name:
 
 ```
-src/generated/
+tangrams/
 └── <source-name>/
     ├── client.ts          # API client (GraphQL or REST)
     ├── schema.ts          # Validation schemas + TypeScript types

apps/docs/content/docs/tanstack-db.mdx

@@ -183,7 +183,7 @@ bunx tangrams generate
 ### Output Directory Structure
 
 ```
-src/generated/
+tangrams/
 └── <source>/
     ├── client.ts             # API client (shared)
     ├── schema.ts             # Validation schemas + TypeScript types

apps/docs/content/docs/tanstack-form.mdx

@@ -133,7 +133,7 @@ bunx tangrams generate
 ### Output Directory Structure
 
 ```
-src/generated/
+tangrams/
 └── <source>/
     ├── schema.ts         # Validation schemas for request bodies
     └── form/

apps/docs/content/docs/tanstack-query.mdx

@@ -210,7 +210,7 @@ bunx tangrams generate
 ### Output Directory Structure
 
 ```
-src/generated/
+tangrams/
 └── <source>/
     ├── client.ts             # API client (shared)
     ├── schema.ts             # Validation schemas + TypeScript types

examples/start-full-stack/src/generated/api/db/collections.ts

@@ -1,7 +1,7 @@
 import {
   petCollectionOptions,
   userCollectionOptions,
-} from "@/generated/api/db/collections";
+} from "@tangrams/api/db/collections";
 
 import type { QueryClient } from "@tanstack/react-query";