@mearie/codegen 0.0.0-next-20260228035926

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,10 @@
+# @mearie/codegen
+
+Code generator for Mearie GraphQL client.
+
+This package generates TypeScript types from GraphQL schema and operations. It
+is used internally by build plugins and is not intended for direct use.
+
+## Documentation
+
+Full documentation is available at <https://mearie.dev/config/codegen>.

package/dist/index.cjs

@@ -0,0 +1,473 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+//#region \0rolldown/runtime.js
+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");
+let picomatch = require("picomatch");
+picomatch = __toESM(picomatch);
+let node_fs_promises = require("node:fs/promises");
+let _mearie_native = require("@mearie/native");
+let node_path = require("node:path");
+node_path = __toESM(node_path);
+let _logtape_logtape = require("@logtape/logtape");
+let picocolors = require("picocolors");
+picocolors = __toESM(picocolors);
+
+//#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/errors.ts
+/**
+* Custom error class for Mearie-specific errors.
+*/
+var MearieError = class MearieError extends Error {
+	filePath;
+	line;
+	column;
+	constructor(message, filePath, line, column) {
+		super(message);
+		this.name = "MearieError";
+		this.filePath = filePath;
+		this.line = line;
+		this.column = column;
+	}
+	static fromNative(data) {
+		if (!data || typeof data !== "object") throw new TypeError("Invalid native error data");
+		const error = data;
+		const filePath = error.location?.file_path;
+		const line = error.location?.line;
+		const column = error.location?.column;
+		return new MearieError(error.message, filePath, line, column);
+	}
+};
+/**
+* Aggregate error for multiple Mearie errors.
+*/
+var MearieAggregateError = class extends Error {
+	errors;
+	constructor(errors, message) {
+		super(message ?? `${errors.length} error${errors.length > 1 ? "s" : ""} occurred`);
+		this.name = "MearieAggregateError";
+		this.errors = errors;
+	}
+};
+/**
+* Error thrown when `@vue/compiler-sfc` is not installed.
+*/
+var MissingVueCompilerError = class extends Error {
+	constructor() {
+		super(`
+GraphQL operations cannot be extracted from Vue files without @vue/compiler-sfc.
+
+Install it with:
+  npm install @vue/compiler-sfc
+  # or
+  pnpm add @vue/compiler-sfc
+  # or
+  yarn add @vue/compiler-sfc
+`);
+		this.name = "MissingVueCompilerError";
+	}
+};
+/**
+* Error thrown when svelte compiler is not installed.
+*/
+var MissingSvelteCompilerError = class extends Error {
+	constructor() {
+		super(`
+GraphQL operations cannot be extracted from Svelte files without svelte.
+
+Install it with:
+  npm install svelte
+  # or
+  pnpm add svelte
+  # or
+  yarn add svelte
+`);
+		this.name = "MissingSvelteCompilerError";
+	}
+};
+/**
+* Error thrown when TypeScript is not installed.
+*/
+var MissingTypeScriptError = class extends Error {
+	constructor() {
+		super(`
+GraphQL operations cannot be extracted from Vue files without typescript.
+
+Install it with:
+  npm install typescript
+  # or
+  pnpm add typescript
+  # or
+  yarn add typescript
+`);
+		this.name = "MissingTypeScriptError";
+	}
+};
+
+//#endregion
+//#region src/loaders.ts
+/**
+* Loads the Vue compiler dynamically.
+* @returns The Vue compiler module.
+* @throws {MissingVueCompilerError} If `@vue/compiler-sfc` is not installed.
+*/
+const loadVueCompiler = async () => {
+	try {
+		return await import("@vue/compiler-sfc");
+	} catch {
+		throw new MissingVueCompilerError();
+	}
+};
+/**
+* Loads TypeScript dynamically.
+* @returns The TypeScript module.
+* @throws {MissingTypeScriptError} If typescript is not installed.
+*/
+const loadTypeScript = async () => {
+	try {
+		return await import("typescript");
+	} catch {
+		throw new MissingTypeScriptError();
+	}
+};
+/**
+* Loads the Svelte compiler dynamically.
+* @returns The Svelte compiler module.
+* @throws {MissingSvelteCompilerError} If svelte is not installed.
+*/
+const loadSvelteCompiler = async () => {
+	try {
+		return await import("svelte/compiler");
+	} catch {
+		throw new MissingSvelteCompilerError();
+	}
+};
+
+//#endregion
+//#region src/parsers.ts
+const extractVueScript = async (source) => {
+	const [vueCompiler, typescript] = await Promise.all([loadVueCompiler(), loadTypeScript()]);
+	vueCompiler.registerTS(() => typescript);
+	const { descriptor } = vueCompiler.parse(source.code, { filename: source.filePath });
+	const blocks = [];
+	if (descriptor.script) blocks.push({
+		code: descriptor.script.content,
+		filePath: source.filePath,
+		startLine: source.startLine + descriptor.script.loc.start.line - 1
+	});
+	if (descriptor.scriptSetup) blocks.push({
+		code: descriptor.scriptSetup.content,
+		filePath: source.filePath,
+		startLine: source.startLine + descriptor.scriptSetup.loc.start.line - 1
+	});
+	return blocks;
+};
+const extractSvelteScript = async (source) => {
+	const ast = (await loadSvelteCompiler()).parse(source.code);
+	const blocks = [];
+	if (ast.instance?.content) {
+		const code = source.code.slice(ast.instance.content.start, ast.instance.content.end);
+		const lineOffset = source.code.slice(0, ast.instance.content.start).split("\n").length - 1;
+		blocks.push({
+			code,
+			filePath: `${source.filePath}.instance.ts`,
+			startLine: source.startLine + lineOffset
+		});
+	}
+	if (ast.module?.content) {
+		const code = source.code.slice(ast.module.content.start, ast.module.content.end);
+		const lineOffset = source.code.slice(0, ast.module.content.start).split("\n").length - 1;
+		blocks.push({
+			code,
+			filePath: `${source.filePath}.module.ts`,
+			startLine: source.startLine + lineOffset
+		});
+	}
+	return blocks;
+};
+const extractAstroScripts = (source) => {
+	const blocks = [];
+	const frontmatterMatch = /^---\s*\n([\s\S]*?)\n---/.exec(source.code);
+	if (frontmatterMatch) {
+		const lineOffset = source.code.slice(0, frontmatterMatch.index).split("\n").length;
+		blocks.push({
+			code: frontmatterMatch[1],
+			filePath: `${source.filePath}.frontmatter.ts`,
+			startLine: source.startLine + lineOffset
+		});
+	}
+	const scriptMatches = source.code.matchAll(/<script\b[^>]*>([\s\S]*?)<\/script>/gi);
+	let index = 0;
+	for (const match of scriptMatches) {
+		const lineOffset = source.code.slice(0, match.index).split("\n").length;
+		blocks.push({
+			code: match[1],
+			filePath: `${source.filePath}.${index}.ts`,
+			startLine: source.startLine + lineOffset
+		});
+		index++;
+	}
+	return blocks;
+};
+const extractMarkdownCodeBlocks = (source) => {
+	const codeBlocks = [];
+	const codeBlockRegex = /```(tsx|ts)[^\n]*mearie[^\n]*\n([\s\S]*?)```/g;
+	let match;
+	let index = 0;
+	while ((match = codeBlockRegex.exec(source.code)) !== null) {
+		const lineOffset = source.code.slice(0, match.index).split("\n").length;
+		codeBlocks.push({
+			code: match[2],
+			filePath: `${source.filePath}.${index}.${match[1]}`,
+			startLine: source.startLine + lineOffset
+		});
+		index++;
+	}
+	return codeBlocks;
+};
+
+//#endregion
+//#region src/extractor.ts
+const extractGraphQLSources = async (source) => {
+	const ext = source.filePath.split(".").pop()?.toLowerCase();
+	const sources = [];
+	const errors = [];
+	const blocks = [];
+	try {
+		switch (ext) {
+			case "vue":
+				blocks.push(...await extractVueScript(source));
+				break;
+			case "svelte":
+				blocks.push(...await extractSvelteScript(source));
+				break;
+			case "astro":
+				blocks.push(...extractAstroScripts(source));
+				break;
+			case "md":
+				blocks.push(...extractMarkdownCodeBlocks(source));
+				break;
+			case "js":
+			case "jsx":
+			case "ts":
+			case "tsx":
+				blocks.push(source);
+				break;
+			default: return {
+				sources,
+				errors
+			};
+		}
+	} catch (error) {
+		throw new MearieError(error instanceof Error ? error.message : String(error), source.filePath);
+	}
+	for (const block of blocks) {
+		const result = (0, _mearie_native.extractGraphQLSources)(block);
+		sources.push(...result.sources);
+		errors.push(...result.errors.map((error) => MearieError.fromNative(error)));
+	}
+	return {
+		sources,
+		errors
+	};
+};
+
+//#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, config } = options;
+	const { sources, errors } = (0, _mearie_native.generateCode)(schemas, documents, config);
+	return {
+		sources,
+		errors: errors.map((error) => MearieError.fromNative(error))
+	};
+};
+
+//#endregion
+//#region src/writer.ts
+const writeFiles = async (cwd, sources) => {
+	const mearieDir = node_path.default.resolve(cwd, ".mearie");
+	await (0, node_fs_promises.mkdir)(mearieDir, { recursive: true });
+	await Promise.all(sources.map((source) => (0, node_fs_promises.writeFile)(node_path.default.join(mearieDir, 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();
+	cwd;
+	config;
+	constructor(cwd = process.cwd()) {
+		this.cwd = cwd;
+	}
+	setConfig(config) {
+		this.config = config;
+	}
+	/**
+	* 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 extractGraphQLSources({
+			code: await (0, node_fs_promises.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(),
+			config: this.config
+		});
+		await writeFiles(this.cwd, sources);
+		if (errors.length > 0) throw new MearieAggregateError(errors);
+	}
+};
+
+//#endregion
+//#region src/logger.ts
+(0, _logtape_logtape.configureSync)({
+	reset: true,
+	sinks: { console: (0, _logtape_logtape.getConsoleSink)({ formatter: (0, _logtape_logtape.getAnsiColorFormatter)({
+		level: "FULL",
+		timestamp: "time",
+		category: (category) => `💬 ${category.join("·")}`
+	}) }) },
+	loggers: [{
+		category: "mearie",
+		lowestLevel: "info",
+		sinks: ["console"]
+	}, {
+		category: ["logtape", "meta"],
+		lowestLevel: "warning",
+		sinks: ["console"]
+	}]
+});
+const logger = (0, _logtape_logtape.getLogger)(["mearie"]);
+const formatMearieError = (error) => {
+	const parts = [
+		error.filePath,
+		error.line,
+		error.column
+	].filter((part) => part !== void 0 && part !== null).map(String);
+	const location = parts.length > 0 ? parts.join(":") : "";
+	if (location) return `${picocolors.default.bold(error.message)} ${picocolors.default.cyan(picocolors.default.underline(location))}`;
+	return picocolors.default.bold(error.message);
+};
+/**
+* Reports an error using the provided logger.
+* @param logger - The logger to use.
+* @param error - The error to report.
+*/
+const report = (logger, error) => {
+	if (error instanceof MearieAggregateError) for (const err of error.errors) logger.error(formatMearieError(err));
+	else if (error instanceof MearieError) logger.error(formatMearieError(error));
+	else logger.error("{error}", { error });
+};
+
+//#endregion
+exports.CodegenContext = CodegenContext;
+exports.createMatcher = createMatcher;
+exports.findFiles = findFiles;
+exports.logger = logger;
+exports.report = report;

package/dist/index.d.cts

@@ -0,0 +1,77 @@
+import { Logger } from "@logtape/logtape";
+
+//#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 GenerateConfig = {
+  scalars?: Record<string, string>;
+};
+//#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;
+  private cwd;
+  private config?;
+  constructor(cwd?: string);
+  setConfig(config: GenerateConfig): void;
+  /**
+   * 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/logger.d.ts
+declare const logger: Logger;
+/**
+ * Reports an error using the provided logger.
+ * @param logger - The logger to use.
+ * @param error - The error to report.
+ */
+declare const report: (logger: Logger, error: unknown) => void;
+//#endregion
+export { CodegenContext, createMatcher, findFiles, logger, report };

package/dist/index.d.mts

@@ -0,0 +1,77 @@
+import { Logger } from "@logtape/logtape";
+
+//#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 GenerateConfig = {
+  scalars?: Record<string, string>;
+};
+//#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;
+  private cwd;
+  private config?;
+  constructor(cwd?: string);
+  setConfig(config: GenerateConfig): void;
+  /**
+   * 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/logger.d.ts
+declare const logger: Logger;
+/**
+ * Reports an error using the provided logger.
+ * @param logger - The logger to use.
+ * @param error - The error to report.
+ */
+declare const report: (logger: Logger, error: unknown) => void;
+//#endregion
+export { CodegenContext, createMatcher, findFiles, logger, report };

package/dist/index.mjs

@@ -0,0 +1,438 @@
+import { glob } from "tinyglobby";
+import picomatch from "picomatch";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { extractGraphQLSources, generateCode } from "@mearie/native";
+import path from "node:path";
+import { configureSync, getAnsiColorFormatter, getConsoleSink, getLogger } from "@logtape/logtape";
+import pc from "picocolors";
+
+//#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/errors.ts
+/**
+* Custom error class for Mearie-specific errors.
+*/
+var MearieError = class MearieError extends Error {
+	filePath;
+	line;
+	column;
+	constructor(message, filePath, line, column) {
+		super(message);
+		this.name = "MearieError";
+		this.filePath = filePath;
+		this.line = line;
+		this.column = column;
+	}
+	static fromNative(data) {
+		if (!data || typeof data !== "object") throw new TypeError("Invalid native error data");
+		const error = data;
+		const filePath = error.location?.file_path;
+		const line = error.location?.line;
+		const column = error.location?.column;
+		return new MearieError(error.message, filePath, line, column);
+	}
+};
+/**
+* Aggregate error for multiple Mearie errors.
+*/
+var MearieAggregateError = class extends Error {
+	errors;
+	constructor(errors, message) {
+		super(message ?? `${errors.length} error${errors.length > 1 ? "s" : ""} occurred`);
+		this.name = "MearieAggregateError";
+		this.errors = errors;
+	}
+};
+/**
+* Error thrown when `@vue/compiler-sfc` is not installed.
+*/
+var MissingVueCompilerError = class extends Error {
+	constructor() {
+		super(`
+GraphQL operations cannot be extracted from Vue files without @vue/compiler-sfc.
+
+Install it with:
+  npm install @vue/compiler-sfc
+  # or
+  pnpm add @vue/compiler-sfc
+  # or
+  yarn add @vue/compiler-sfc
+`);
+		this.name = "MissingVueCompilerError";
+	}
+};
+/**
+* Error thrown when svelte compiler is not installed.
+*/
+var MissingSvelteCompilerError = class extends Error {
+	constructor() {
+		super(`
+GraphQL operations cannot be extracted from Svelte files without svelte.
+
+Install it with:
+  npm install svelte
+  # or
+  pnpm add svelte
+  # or
+  yarn add svelte
+`);
+		this.name = "MissingSvelteCompilerError";
+	}
+};
+/**
+* Error thrown when TypeScript is not installed.
+*/
+var MissingTypeScriptError = class extends Error {
+	constructor() {
+		super(`
+GraphQL operations cannot be extracted from Vue files without typescript.
+
+Install it with:
+  npm install typescript
+  # or
+  pnpm add typescript
+  # or
+  yarn add typescript
+`);
+		this.name = "MissingTypeScriptError";
+	}
+};
+
+//#endregion
+//#region src/loaders.ts
+/**
+* Loads the Vue compiler dynamically.
+* @returns The Vue compiler module.
+* @throws {MissingVueCompilerError} If `@vue/compiler-sfc` is not installed.
+*/
+const loadVueCompiler = async () => {
+	try {
+		return await import("@vue/compiler-sfc");
+	} catch {
+		throw new MissingVueCompilerError();
+	}
+};
+/**
+* Loads TypeScript dynamically.
+* @returns The TypeScript module.
+* @throws {MissingTypeScriptError} If typescript is not installed.
+*/
+const loadTypeScript = async () => {
+	try {
+		return await import("typescript");
+	} catch {
+		throw new MissingTypeScriptError();
+	}
+};
+/**
+* Loads the Svelte compiler dynamically.
+* @returns The Svelte compiler module.
+* @throws {MissingSvelteCompilerError} If svelte is not installed.
+*/
+const loadSvelteCompiler = async () => {
+	try {
+		return await import("svelte/compiler");
+	} catch {
+		throw new MissingSvelteCompilerError();
+	}
+};
+
+//#endregion
+//#region src/parsers.ts
+const extractVueScript = async (source) => {
+	const [vueCompiler, typescript] = await Promise.all([loadVueCompiler(), loadTypeScript()]);
+	vueCompiler.registerTS(() => typescript);
+	const { descriptor } = vueCompiler.parse(source.code, { filename: source.filePath });
+	const blocks = [];
+	if (descriptor.script) blocks.push({
+		code: descriptor.script.content,
+		filePath: source.filePath,
+		startLine: source.startLine + descriptor.script.loc.start.line - 1
+	});
+	if (descriptor.scriptSetup) blocks.push({
+		code: descriptor.scriptSetup.content,
+		filePath: source.filePath,
+		startLine: source.startLine + descriptor.scriptSetup.loc.start.line - 1
+	});
+	return blocks;
+};
+const extractSvelteScript = async (source) => {
+	const ast = (await loadSvelteCompiler()).parse(source.code);
+	const blocks = [];
+	if (ast.instance?.content) {
+		const code = source.code.slice(ast.instance.content.start, ast.instance.content.end);
+		const lineOffset = source.code.slice(0, ast.instance.content.start).split("\n").length - 1;
+		blocks.push({
+			code,
+			filePath: `${source.filePath}.instance.ts`,
+			startLine: source.startLine + lineOffset
+		});
+	}
+	if (ast.module?.content) {
+		const code = source.code.slice(ast.module.content.start, ast.module.content.end);
+		const lineOffset = source.code.slice(0, ast.module.content.start).split("\n").length - 1;
+		blocks.push({
+			code,
+			filePath: `${source.filePath}.module.ts`,
+			startLine: source.startLine + lineOffset
+		});
+	}
+	return blocks;
+};
+const extractAstroScripts = (source) => {
+	const blocks = [];
+	const frontmatterMatch = /^---\s*\n([\s\S]*?)\n---/.exec(source.code);
+	if (frontmatterMatch) {
+		const lineOffset = source.code.slice(0, frontmatterMatch.index).split("\n").length;
+		blocks.push({
+			code: frontmatterMatch[1],
+			filePath: `${source.filePath}.frontmatter.ts`,
+			startLine: source.startLine + lineOffset
+		});
+	}
+	const scriptMatches = source.code.matchAll(/<script\b[^>]*>([\s\S]*?)<\/script>/gi);
+	let index = 0;
+	for (const match of scriptMatches) {
+		const lineOffset = source.code.slice(0, match.index).split("\n").length;
+		blocks.push({
+			code: match[1],
+			filePath: `${source.filePath}.${index}.ts`,
+			startLine: source.startLine + lineOffset
+		});
+		index++;
+	}
+	return blocks;
+};
+const extractMarkdownCodeBlocks = (source) => {
+	const codeBlocks = [];
+	const codeBlockRegex = /```(tsx|ts)[^\n]*mearie[^\n]*\n([\s\S]*?)```/g;
+	let match;
+	let index = 0;
+	while ((match = codeBlockRegex.exec(source.code)) !== null) {
+		const lineOffset = source.code.slice(0, match.index).split("\n").length;
+		codeBlocks.push({
+			code: match[2],
+			filePath: `${source.filePath}.${index}.${match[1]}`,
+			startLine: source.startLine + lineOffset
+		});
+		index++;
+	}
+	return codeBlocks;
+};
+
+//#endregion
+//#region src/extractor.ts
+const extractGraphQLSources$1 = async (source) => {
+	const ext = source.filePath.split(".").pop()?.toLowerCase();
+	const sources = [];
+	const errors = [];
+	const blocks = [];
+	try {
+		switch (ext) {
+			case "vue":
+				blocks.push(...await extractVueScript(source));
+				break;
+			case "svelte":
+				blocks.push(...await extractSvelteScript(source));
+				break;
+			case "astro":
+				blocks.push(...extractAstroScripts(source));
+				break;
+			case "md":
+				blocks.push(...extractMarkdownCodeBlocks(source));
+				break;
+			case "js":
+			case "jsx":
+			case "ts":
+			case "tsx":
+				blocks.push(source);
+				break;
+			default: return {
+				sources,
+				errors
+			};
+		}
+	} catch (error) {
+		throw new MearieError(error instanceof Error ? error.message : String(error), source.filePath);
+	}
+	for (const block of blocks) {
+		const result = extractGraphQLSources(block);
+		sources.push(...result.sources);
+		errors.push(...result.errors.map((error) => MearieError.fromNative(error)));
+	}
+	return {
+		sources,
+		errors
+	};
+};
+
+//#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, config } = options;
+	const { sources, errors } = generateCode(schemas, documents, config);
+	return {
+		sources,
+		errors: errors.map((error) => MearieError.fromNative(error))
+	};
+};
+
+//#endregion
+//#region src/writer.ts
+const writeFiles = async (cwd, sources) => {
+	const mearieDir = path.resolve(cwd, ".mearie");
+	await mkdir(mearieDir, { recursive: true });
+	await Promise.all(sources.map((source) => writeFile(path.join(mearieDir, 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();
+	cwd;
+	config;
+	constructor(cwd = process.cwd()) {
+		this.cwd = cwd;
+	}
+	setConfig(config) {
+		this.config = config;
+	}
+	/**
+	* 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$1({
+			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(),
+			config: this.config
+		});
+		await writeFiles(this.cwd, sources);
+		if (errors.length > 0) throw new MearieAggregateError(errors);
+	}
+};
+
+//#endregion
+//#region src/logger.ts
+configureSync({
+	reset: true,
+	sinks: { console: getConsoleSink({ formatter: getAnsiColorFormatter({
+		level: "FULL",
+		timestamp: "time",
+		category: (category) => `💬 ${category.join("·")}`
+	}) }) },
+	loggers: [{
+		category: "mearie",
+		lowestLevel: "info",
+		sinks: ["console"]
+	}, {
+		category: ["logtape", "meta"],
+		lowestLevel: "warning",
+		sinks: ["console"]
+	}]
+});
+const logger = getLogger(["mearie"]);
+const formatMearieError = (error) => {
+	const parts = [
+		error.filePath,
+		error.line,
+		error.column
+	].filter((part) => part !== void 0 && part !== null).map(String);
+	const location = parts.length > 0 ? parts.join(":") : "";
+	if (location) return `${pc.bold(error.message)} ${pc.cyan(pc.underline(location))}`;
+	return pc.bold(error.message);
+};
+/**
+* Reports an error using the provided logger.
+* @param logger - The logger to use.
+* @param error - The error to report.
+*/
+const report = (logger, error) => {
+	if (error instanceof MearieAggregateError) for (const err of error.errors) logger.error(formatMearieError(err));
+	else if (error instanceof MearieError) logger.error(formatMearieError(error));
+	else logger.error("{error}", { error });
+};
+
+//#endregion
+export { CodegenContext, createMatcher, findFiles, logger, report };

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@mearie/codegen",
+  "version": "0.0.0-next-20260228035926",
+  "description": "Type-safe, zero-overhead GraphQL client",
+  "keywords": [
+    "graphql",
+    "graphql-client",
+    "typescript",
+    "codegen",
+    "cache"
+  ],
+  "homepage": "https://github.com/devunt/mearie#readme",
+  "bugs": {
+    "url": "https://github.com/devunt/mearie/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/devunt/mearie.git",
+    "directory": "packages/codegen"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/devunt"
+  },
+  "license": "MIT",
+  "author": "Bae Junehyeon <finn@penxle.io>",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md"
+  ],
+  "dependencies": {
+    "@logtape/logtape": "^2.0.2",
+    "picocolors": "^1.1.1",
+    "picomatch": "^4.0.3",
+    "tinyglobby": "^0.2.15",
+    "@mearie/config": "0.0.0-next-20260228035926",
+    "@mearie/native": "0.0.0-next-20260228035926",
+    "@mearie/shared": "0.0.0-next-20260228035926"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "@types/picomatch": "^4.0.2",
+    "@vue/compiler-sfc": "^3.5.29",
+    "svelte": "^5.53.3",
+    "tsdown": "^0.20.3",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "bun": ">=1.2.0",
+    "deno": ">=2.2.0",
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts"
+}