@mearie/codegen 0.0.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright 2025 Bae Junehyeon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# @mearie/codegen
+
+Code generation utilities for Mearie GraphQL client.
+
+This package provides the core code generation logic that can be reused across different build tool integrations (Vite, Webpack, Rollup, etc.).
+
+## Features
+
+- **Scanner**: Scans files for GraphQL operations
+- **Generator**: Generates TypeScript types from GraphQL operations and schema
+- **Writer**: Writes generated types to the filesystem
+
+## Usage
+
+```typescript
+import { runCodegen, scanDocuments, generateTypes, writeTypes } from '@mearie/codegen';
+
+// High-level API
+await runCodegen({
+  schema: 'schema.graphql',
+  documents: 'src/**/*.ts',
+  cwd: process.cwd(),
+});
+
+// Low-level API for custom workflows
+const operations = await scanDocuments(
+  {
+    include: 'src/**/*.ts',
+    exclude: 'node_modules/**',
+  },
+  process.cwd(),
+);
+
+const { types, augmentation } = await generateTypes(operations, schemaContent);
+
+await writeTypes({ types, augmentation });
+```
+
+## API
+
+### `runCodegen(config: CodegenConfig): Promise<void>`
+
+Runs the complete code generation pipeline.
+
+### `scanDocuments(patterns: ScanPatterns, cwd: string): Promise<ExtractedDocument[]>`
+
+Scans files for GraphQL operations.
+
+### `generateTypes(operations: ExtractedDocument[], schema: string): Promise<GeneratedCode>`
+
+Generates TypeScript types from operations and schema.
+
+### `writeTypes(code: GeneratedCode, outputDir?: string): Promise<WrittenFiles>`
+
+Writes generated types to the filesystem.

package/dist/index.cjs

@@ -0,0 +1,166 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let tinyglobby = require("tinyglobby");
+tinyglobby = __toESM(tinyglobby);
+let picomatch = require("picomatch");
+picomatch = __toESM(picomatch);
+let __mearie_native = require("@mearie/native");
+__mearie_native = __toESM(__mearie_native);
+let __mearie_core = require("@mearie/core");
+__mearie_core = __toESM(__mearie_core);
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = __toESM(node_fs_promises);
+let __mearie_extractor = require("@mearie/extractor");
+__mearie_extractor = __toESM(__mearie_extractor);
+let node_module = require("node:module");
+node_module = __toESM(node_module);
+let node_path = require("node:path");
+node_path = __toESM(node_path);
+
+//#region src/glob.ts
+/**
+* Finds files matching the given patterns.
+* @param cwd - Current working directory.
+* @param patterns - File patterns to match.
+* @returns Array of absolute file paths.
+*/
+const findFiles = async (cwd, patterns) => {
+	const includePatterns = Array.isArray(patterns.include) ? patterns.include : [patterns.include];
+	const negatedExcludes = (patterns.exclude ? Array.isArray(patterns.exclude) ? patterns.exclude : [patterns.exclude] : []).map((pattern) => `!${pattern}`);
+	return await (0, tinyglobby.glob)([...includePatterns, ...negatedExcludes], {
+		cwd,
+		absolute: true
+	});
+};
+/**
+* Creates a matcher function.
+* @internal
+* @param patterns - File patterns to match.
+* @returns A function that checks if a file path matches the patterns.
+*/
+const createMatcher = (patterns) => {
+	const includePatterns = Array.isArray(patterns.include) ? patterns.include : [patterns.include];
+	const excludePatterns = patterns.exclude ? Array.isArray(patterns.exclude) ? patterns.exclude : [patterns.exclude] : [];
+	const isMatch = (0, picomatch.default)(includePatterns);
+	const isExcluded = excludePatterns.length > 0 ? (0, picomatch.default)(excludePatterns) : () => false;
+	return (filePath) => {
+		return isMatch(filePath) && !isExcluded(filePath);
+	};
+};
+
+//#endregion
+//#region src/generator.ts
+/**
+* Generates code from GraphQL documents and schemas.
+* @param options - Generation options.
+* @returns Generated code.
+* @throws {Error} If code generation fails.
+*/
+const generate = (options) => {
+	const { schemas, documents } = options;
+	const { sources, errors } = (0, __mearie_native.generateCode)(schemas, documents);
+	return {
+		sources,
+		errors: errors.map((error) => __mearie_core.MearieError.fromNative(error))
+	};
+};
+
+//#endregion
+//#region src/writer.ts
+const writeFiles = async (sources) => {
+	const clientPackageJsonPath = (0, node_module.createRequire)(node_path.default.resolve(process.cwd(), "package.json")).resolve("@mearie/client/package.json");
+	const meariePackagePath = node_path.default.dirname(clientPackageJsonPath);
+	const clientDir = node_path.default.resolve(meariePackagePath, ".mearie", "client");
+	await (0, node_fs_promises.mkdir)(clientDir, { recursive: true });
+	await Promise.all(sources.map((source) => (0, node_fs_promises.writeFile)(node_path.default.join(clientDir, source.filePath), source.code, "utf8")));
+};
+
+//#endregion
+//#region src/context.ts
+/**
+* Stateful context for incremental code generation.
+* Reads and caches file contents when files are added/updated.
+*/
+var CodegenContext = class {
+	schemas = /* @__PURE__ */ new Map();
+	documents = /* @__PURE__ */ new Map();
+	/**
+	* Adds a schema file by reading it.
+	* @param filePath - Schema file path.
+	*/
+	async addSchema(filePath) {
+		const code = await (0, node_fs_promises.readFile)(filePath, "utf8");
+		this.schemas.set(filePath, {
+			code,
+			filePath,
+			startLine: 1
+		});
+	}
+	/**
+	* Removes a schema file.
+	* @param filePath - Schema file path.
+	*/
+	removeSchema(filePath) {
+		this.schemas.delete(filePath);
+	}
+	/**
+	* Adds a document file by reading and extracting operations.
+	* @param filePath - Document file path.
+	*/
+	async addDocument(filePath) {
+		const { sources, errors } = await (0, __mearie_extractor.extractGraphQLSources)({
+			code: await (0, node_fs_promises.readFile)(filePath, "utf8"),
+			filePath,
+			startLine: 1
+		});
+		this.documents.set(filePath, sources);
+		if (errors.length > 0) throw new __mearie_core.MearieAggregateError(errors);
+	}
+	/**
+	* Removes a document file.
+	* @param filePath - Document file path.
+	*/
+	removeDocument(filePath) {
+		this.documents.delete(filePath);
+	}
+	/**
+	* Generates code from cached schemas and documents and writes to files.
+	* @returns Written file paths.
+	* @throws {Error} If generation or writing fails.
+	*/
+	async generate() {
+		const { sources, errors } = generate({
+			schemas: [...this.schemas.values()],
+			documents: [...this.documents.values()].flat()
+		});
+		await writeFiles(sources);
+		if (errors.length > 0) throw new __mearie_core.MearieAggregateError(errors);
+	}
+};
+
+//#endregion
+exports.CodegenContext = CodegenContext;
+exports.createMatcher = createMatcher;
+exports.findFiles = findFiles;
+exports.generate = generate;

package/dist/index.d.cts

@@ -0,0 +1,87 @@
+import { MearieError, Source } from "@mearie/core";
+
+//#region src/glob.d.ts
+type GlobPatterns = {
+  include: string | string[];
+  exclude?: string | string[];
+};
+/**
+ * Finds files matching the given patterns.
+ * @param cwd - Current working directory.
+ * @param patterns - File patterns to match.
+ * @returns Array of absolute file paths.
+ */
+declare const findFiles: (cwd: string, patterns: GlobPatterns) => Promise<string[]>;
+/**
+ * Creates a matcher function.
+ * @internal
+ * @param patterns - File patterns to match.
+ * @returns A function that checks if a file path matches the patterns.
+ */
+declare const createMatcher: (patterns: GlobPatterns) => ((filePath: string) => boolean);
+//#endregion
+//#region src/generator.d.ts
+type GenerateOptions = {
+  schemas: Source[];
+  documents: Source[];
+};
+type GenerateResult = {
+  sources: Source[];
+  errors: MearieError[];
+};
+/**
+ * Generates code from GraphQL documents and schemas.
+ * @param options - Generation options.
+ * @returns Generated code.
+ * @throws {Error} If code generation fails.
+ */
+declare const generate: (options: GenerateOptions) => GenerateResult;
+//#endregion
+//#region src/context.d.ts
+/**
+ * Stateful context for incremental code generation.
+ * Reads and caches file contents when files are added/updated.
+ */
+declare class CodegenContext {
+  private schemas;
+  private documents;
+  /**
+   * Adds a schema file by reading it.
+   * @param filePath - Schema file path.
+   */
+  addSchema(filePath: string): Promise<void>;
+  /**
+   * Removes a schema file.
+   * @param filePath - Schema file path.
+   */
+  removeSchema(filePath: string): void;
+  /**
+   * Adds a document file by reading and extracting operations.
+   * @param filePath - Document file path.
+   */
+  addDocument(filePath: string): Promise<void>;
+  /**
+   * Removes a document file.
+   * @param filePath - Document file path.
+   */
+  removeDocument(filePath: string): void;
+  /**
+   * Generates code from cached schemas and documents and writes to files.
+   * @returns Written file paths.
+   * @throws {Error} If generation or writing fails.
+   */
+  generate(): Promise<void>;
+}
+//#endregion
+//#region src/types.d.ts
+/**
+ * Configuration for the code generator.
+ */
+type CodegenConfig = {
+  schemas: string;
+  documents: string | string[];
+  exclude?: string | string[];
+  cwd: string;
+};
+//#endregion
+export { type CodegenConfig, CodegenContext, type GenerateOptions, type GlobPatterns, createMatcher, findFiles, generate };

package/dist/index.d.ts

@@ -0,0 +1,87 @@
+import { MearieError, Source } from "@mearie/core";
+
+//#region src/glob.d.ts
+type GlobPatterns = {
+  include: string | string[];
+  exclude?: string | string[];
+};
+/**
+ * Finds files matching the given patterns.
+ * @param cwd - Current working directory.
+ * @param patterns - File patterns to match.
+ * @returns Array of absolute file paths.
+ */
+declare const findFiles: (cwd: string, patterns: GlobPatterns) => Promise<string[]>;
+/**
+ * Creates a matcher function.
+ * @internal
+ * @param patterns - File patterns to match.
+ * @returns A function that checks if a file path matches the patterns.
+ */
+declare const createMatcher: (patterns: GlobPatterns) => ((filePath: string) => boolean);
+//#endregion
+//#region src/generator.d.ts
+type GenerateOptions = {
+  schemas: Source[];
+  documents: Source[];
+};
+type GenerateResult = {
+  sources: Source[];
+  errors: MearieError[];
+};
+/**
+ * Generates code from GraphQL documents and schemas.
+ * @param options - Generation options.
+ * @returns Generated code.
+ * @throws {Error} If code generation fails.
+ */
+declare const generate: (options: GenerateOptions) => GenerateResult;
+//#endregion
+//#region src/context.d.ts
+/**
+ * Stateful context for incremental code generation.
+ * Reads and caches file contents when files are added/updated.
+ */
+declare class CodegenContext {
+  private schemas;
+  private documents;
+  /**
+   * Adds a schema file by reading it.
+   * @param filePath - Schema file path.
+   */
+  addSchema(filePath: string): Promise<void>;
+  /**
+   * Removes a schema file.
+   * @param filePath - Schema file path.
+   */
+  removeSchema(filePath: string): void;
+  /**
+   * Adds a document file by reading and extracting operations.
+   * @param filePath - Document file path.
+   */
+  addDocument(filePath: string): Promise<void>;
+  /**
+   * Removes a document file.
+   * @param filePath - Document file path.
+   */
+  removeDocument(filePath: string): void;
+  /**
+   * Generates code from cached schemas and documents and writes to files.
+   * @returns Written file paths.
+   * @throws {Error} If generation or writing fails.
+   */
+  generate(): Promise<void>;
+}
+//#endregion
+//#region src/types.d.ts
+/**
+ * Configuration for the code generator.
+ */
+type CodegenConfig = {
+  schemas: string;
+  documents: string | string[];
+  exclude?: string | string[];
+  cwd: string;
+};
+//#endregion
+export { type CodegenConfig, CodegenContext, type GenerateOptions, type GlobPatterns, createMatcher, findFiles, generate };

package/dist/index.js

@@ -0,0 +1,132 @@
+import { createRequire } from "node:module";
+import { glob } from "tinyglobby";
+import picomatch from "picomatch";
+import { generateCode } from "@mearie/native";
+import { MearieAggregateError, MearieError } from "@mearie/core";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { extractGraphQLSources } from "@mearie/extractor";
+import path from "node:path";
+
+//#region src/glob.ts
+/**
+* Finds files matching the given patterns.
+* @param cwd - Current working directory.
+* @param patterns - File patterns to match.
+* @returns Array of absolute file paths.
+*/
+const findFiles = async (cwd, patterns) => {
+	const includePatterns = Array.isArray(patterns.include) ? patterns.include : [patterns.include];
+	const negatedExcludes = (patterns.exclude ? Array.isArray(patterns.exclude) ? patterns.exclude : [patterns.exclude] : []).map((pattern) => `!${pattern}`);
+	return await glob([...includePatterns, ...negatedExcludes], {
+		cwd,
+		absolute: true
+	});
+};
+/**
+* Creates a matcher function.
+* @internal
+* @param patterns - File patterns to match.
+* @returns A function that checks if a file path matches the patterns.
+*/
+const createMatcher = (patterns) => {
+	const includePatterns = Array.isArray(patterns.include) ? patterns.include : [patterns.include];
+	const excludePatterns = patterns.exclude ? Array.isArray(patterns.exclude) ? patterns.exclude : [patterns.exclude] : [];
+	const isMatch = picomatch(includePatterns);
+	const isExcluded = excludePatterns.length > 0 ? picomatch(excludePatterns) : () => false;
+	return (filePath) => {
+		return isMatch(filePath) && !isExcluded(filePath);
+	};
+};
+
+//#endregion
+//#region src/generator.ts
+/**
+* Generates code from GraphQL documents and schemas.
+* @param options - Generation options.
+* @returns Generated code.
+* @throws {Error} If code generation fails.
+*/
+const generate = (options) => {
+	const { schemas, documents } = options;
+	const { sources, errors } = generateCode(schemas, documents);
+	return {
+		sources,
+		errors: errors.map((error) => MearieError.fromNative(error))
+	};
+};
+
+//#endregion
+//#region src/writer.ts
+const writeFiles = async (sources) => {
+	const clientPackageJsonPath = createRequire(path.resolve(process.cwd(), "package.json")).resolve("@mearie/client/package.json");
+	const meariePackagePath = path.dirname(clientPackageJsonPath);
+	const clientDir = path.resolve(meariePackagePath, ".mearie", "client");
+	await mkdir(clientDir, { recursive: true });
+	await Promise.all(sources.map((source) => writeFile(path.join(clientDir, source.filePath), source.code, "utf8")));
+};
+
+//#endregion
+//#region src/context.ts
+/**
+* Stateful context for incremental code generation.
+* Reads and caches file contents when files are added/updated.
+*/
+var CodegenContext = class {
+	schemas = /* @__PURE__ */ new Map();
+	documents = /* @__PURE__ */ new Map();
+	/**
+	* Adds a schema file by reading it.
+	* @param filePath - Schema file path.
+	*/
+	async addSchema(filePath) {
+		const code = await readFile(filePath, "utf8");
+		this.schemas.set(filePath, {
+			code,
+			filePath,
+			startLine: 1
+		});
+	}
+	/**
+	* Removes a schema file.
+	* @param filePath - Schema file path.
+	*/
+	removeSchema(filePath) {
+		this.schemas.delete(filePath);
+	}
+	/**
+	* Adds a document file by reading and extracting operations.
+	* @param filePath - Document file path.
+	*/
+	async addDocument(filePath) {
+		const { sources, errors } = await extractGraphQLSources({
+			code: await readFile(filePath, "utf8"),
+			filePath,
+			startLine: 1
+		});
+		this.documents.set(filePath, sources);
+		if (errors.length > 0) throw new MearieAggregateError(errors);
+	}
+	/**
+	* Removes a document file.
+	* @param filePath - Document file path.
+	*/
+	removeDocument(filePath) {
+		this.documents.delete(filePath);
+	}
+	/**
+	* Generates code from cached schemas and documents and writes to files.
+	* @returns Written file paths.
+	* @throws {Error} If generation or writing fails.
+	*/
+	async generate() {
+		const { sources, errors } = generate({
+			schemas: [...this.schemas.values()],
+			documents: [...this.documents.values()].flat()
+		});
+		await writeFiles(sources);
+		if (errors.length > 0) throw new MearieAggregateError(errors);
+	}
+};
+
+//#endregion
+export { CodegenContext, createMatcher, findFiles, generate };

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@mearie/codegen",
+  "version": "0.0.0",
+  "description": "Code generation utilities for Mearie",
+  "license": "MIT",
+  "type": "module",
+  "main": "./src/index.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "picomatch": "^4.0.3",
+    "tinyglobby": "^0.2.15",
+    "@mearie/core": "0.0.0",
+    "@mearie/config": "0.0.0",
+    "@mearie/extractor": "0.0.0",
+    "@mearie/native": "0.0.0"
+  },
+  "devDependencies": {
+    "@types/picomatch": "^4.0.2",
+    "tsdown": "^0.15.7",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export { findFiles, createMatcher, type GlobPatterns } from './glob.ts';
+export { generate, type GenerateOptions } from './generator.ts';
+export { CodegenContext } from './context.ts';
+export type { CodegenConfig } from './types.ts';