@soda-gql/common 0.12.2 → 0.12.4

package/dist/template-extraction.cjs

@@ -0,0 +1,356 @@
+
+//#region packages/common/src/template-extraction/extract.ts
+const OPERATION_KINDS = new Set([
+	"query",
+	"mutation",
+	"subscription",
+	"fragment"
+]);
+const isOperationKind = (value) => OPERATION_KINDS.has(value);
+/**
+* Check if a call expression is a gql.{schemaName}(...) call.
+* Returns the schema name if it is, null otherwise.
+*/
+const getGqlCallSchemaName = (identifiers, call) => {
+	const callee = call.callee;
+	if (callee.type !== "MemberExpression") {
+		return null;
+	}
+	const member = callee;
+	if (member.object.type !== "Identifier" || !identifiers.has(member.object.value)) {
+		return null;
+	}
+	if (member.property.type !== "Identifier") {
+		return null;
+	}
+	const firstArg = call.arguments[0];
+	if (!firstArg?.expression || firstArg.expression.type !== "ArrowFunctionExpression") {
+		return null;
+	}
+	return member.property.value;
+};
+/**
+* Extract templates from a gql callback's arrow function body.
+* Handles both expression bodies and block bodies with return statements.
+*/
+const extractTemplatesFromCallback = (arrow, schemaName, positionCtx) => {
+	const templates = [];
+	const processExpression = (expr) => {
+		if (expr.type === "TaggedTemplateExpression") {
+			const tagged = expr;
+			extractFromTaggedTemplate(tagged, schemaName, templates, positionCtx);
+			return;
+		}
+		if (expr.type === "CallExpression") {
+			const call = expr;
+			if (call.callee.type === "TaggedTemplateExpression") {
+				extractFromTaggedTemplate(call.callee, schemaName, templates, positionCtx);
+			}
+		}
+	};
+	if (arrow.body.type !== "BlockStatement") {
+		processExpression(arrow.body);
+		return templates;
+	}
+	for (const stmt of arrow.body.stmts) {
+		if (stmt.type === "ReturnStatement" && stmt.argument) {
+			processExpression(stmt.argument);
+		}
+	}
+	return templates;
+};
+/**
+* Extract a single template from a tagged template expression.
+* Supports both bare-tag (Identifier) and curried (CallExpression) tag forms.
+*/
+const extractFromTaggedTemplate = (tagged, schemaName, templates, positionCtx) => {
+	let kind;
+	let elementName;
+	let typeName;
+	if (tagged.tag.type === "Identifier") {
+		kind = tagged.tag.value;
+	} else if (tagged.tag.type === "CallExpression") {
+		const tagCall = tagged.tag;
+		if (tagCall.callee.type === "Identifier") {
+			kind = tagCall.callee.value;
+		} else {
+			return;
+		}
+		const firstArg = tagCall.arguments[0]?.expression;
+		if (firstArg?.type === "StringLiteral") {
+			elementName = firstArg.value;
+		}
+		const secondArg = tagCall.arguments[1]?.expression;
+		if (secondArg?.type === "StringLiteral") {
+			typeName = secondArg.value;
+		}
+	} else {
+		return;
+	}
+	if (!isOperationKind(kind)) {
+		return;
+	}
+	const { quasis, expressions } = tagged.template;
+	if (tagged.tag.type === "Identifier" && expressions.length > 0) {
+		return;
+	}
+	if (quasis.length === 0) {
+		return;
+	}
+	let contentStart = -1;
+	let contentEnd = -1;
+	const expressionRanges = [];
+	const parts = [];
+	for (let i = 0; i < quasis.length; i++) {
+		const quasi = quasis[i];
+		if (!quasi) continue;
+		if (positionCtx) {
+			const quasiStart = positionCtx.converter.byteOffsetToCharIndex(quasi.span.start - positionCtx.spanOffset);
+			const quasiEnd = positionCtx.converter.byteOffsetToCharIndex(quasi.span.end - positionCtx.spanOffset);
+			if (contentStart === -1) contentStart = quasiStart;
+			contentEnd = quasiEnd;
+		}
+		parts.push(quasi.cooked ?? quasi.raw);
+		if (i < expressions.length) {
+			parts.push(`__FRAG_SPREAD_${i}__`);
+			if (positionCtx) {
+				const expr = expressions[i];
+				const exprStart = positionCtx.converter.byteOffsetToCharIndex(expr.span.start - positionCtx.spanOffset);
+				const exprEnd = positionCtx.converter.byteOffsetToCharIndex(expr.span.end - positionCtx.spanOffset);
+				expressionRanges.push({
+					start: exprStart,
+					end: exprEnd
+				});
+			}
+		}
+	}
+	const content = parts.join("");
+	const template = {
+		schemaName,
+		kind,
+		content,
+		...elementName !== undefined ? { elementName } : {},
+		...typeName !== undefined ? { typeName } : {},
+		...positionCtx && contentStart !== -1 && contentEnd !== -1 ? { contentRange: {
+			start: contentStart,
+			end: contentEnd
+		} } : {},
+		...expressionRanges.length > 0 ? { expressionRanges } : {}
+	};
+	templates.push(template);
+};
+/**
+* Find the innermost gql call, unwrapping method chains like .attach().
+*/
+const findGqlCall = (identifiers, node) => {
+	if (!node || node.type !== "CallExpression") {
+		return null;
+	}
+	const call = node;
+	if (getGqlCallSchemaName(identifiers, call) !== null) {
+		return call;
+	}
+	const callee = call.callee;
+	if (callee.type !== "MemberExpression") {
+		return null;
+	}
+	return findGqlCall(identifiers, callee.object);
+};
+function walkAndExtract(node, identifiers, positionCtx) {
+	const templates = [];
+	const visit = (n) => {
+		if (!n || typeof n !== "object") {
+			return;
+		}
+		if ("type" in n && n.type === "CallExpression") {
+			const gqlCall = findGqlCall(identifiers, n);
+			if (gqlCall) {
+				const schemaName = getGqlCallSchemaName(identifiers, gqlCall);
+				if (schemaName) {
+					const arrow = gqlCall.arguments[0]?.expression;
+					templates.push(...extractTemplatesFromCallback(arrow, schemaName, positionCtx));
+				}
+				return;
+			}
+		}
+		if (Array.isArray(n)) {
+			for (const item of n) {
+				visit(item);
+			}
+			return;
+		}
+		for (const key of Object.keys(n)) {
+			if (key === "span" || key === "type") {
+				continue;
+			}
+			const value = n[key];
+			if (value && typeof value === "object") {
+				visit(value);
+			}
+		}
+	};
+	visit(node);
+	return templates;
+}
+
+//#endregion
+//#region packages/common/src/template-extraction/format.ts
+/**
+* Detect the base indentation for a template by looking at the line
+* containing the opening backtick.
+*/
+const detectBaseIndent = (tsSource, contentStartOffset) => {
+	let lineStart = contentStartOffset;
+	while (lineStart > 0 && tsSource.charCodeAt(lineStart - 1) !== 10) {
+		lineStart--;
+	}
+	let i = lineStart;
+	while (i < tsSource.length && (tsSource.charCodeAt(i) === 32 || tsSource.charCodeAt(i) === 9)) {
+		i++;
+	}
+	return tsSource.slice(lineStart, i);
+};
+/**
+* Re-indent formatted GraphQL to match the embedding context.
+*
+* - If original was single-line and formatted is single-line, keep as-is
+* - Otherwise, apply base indent + one level to each line, preserving
+*   original leading/trailing newline pattern
+*/
+const reindent = (formatted, baseIndent, originalContent) => {
+	const trimmedFormatted = formatted.trim();
+	if (!originalContent.includes("\n") && !trimmedFormatted.includes("\n")) {
+		return trimmedFormatted;
+	}
+	const indent = `${baseIndent}  `;
+	const lines = trimmedFormatted.split("\n");
+	const indentedLines = lines.map((line) => line.trim() === "" ? "" : indent + line);
+	const startsWithNewline = originalContent.startsWith("\n");
+	const endsWithNewline = originalContent.endsWith("\n");
+	let result = indentedLines.join("\n");
+	if (startsWithNewline) {
+		result = `\n${result}`;
+	}
+	if (endsWithNewline) {
+		result = `${result}\n${baseIndent}`;
+	}
+	return result;
+};
+const GRAPHQL_KEYWORDS = new Set([
+	"query",
+	"mutation",
+	"subscription",
+	"fragment"
+]);
+/**
+* Reconstruct a full GraphQL document from template content + metadata.
+*
+* For curried syntax, the template `content` is only the body (e.g., `{ user { id } }`).
+* GraphQL parsers need a full document (e.g., `query GetUser { user { id } }`).
+*
+* For bare-tag syntax, the content already starts with a keyword and is a full document.
+*
+* @returns The wrapped source and a regex pattern to strip the synthetic prefix after formatting
+*/
+const buildGraphqlWrapper = (template) => {
+	const content = template.content.trimStart();
+	const firstWord = content.split(/[\s({]/)[0] ?? "";
+	if (GRAPHQL_KEYWORDS.has(firstWord)) {
+		return {
+			wrapped: template.content,
+			prefixPattern: null
+		};
+	}
+	if (template.elementName) {
+		if (template.kind === "fragment" && template.typeName) {
+			const prefix$2 = `fragment ${template.elementName} on ${template.typeName} `;
+			const prefixPattern$2 = new RegExp(`^fragment\\s+${template.elementName}\\s+on\\s+${template.typeName}\\s*`);
+			return {
+				wrapped: prefix$2 + template.content,
+				prefixPattern: prefixPattern$2
+			};
+		}
+		const prefix$1 = `${template.kind} ${template.elementName} `;
+		const prefixPattern$1 = new RegExp(`^${template.kind}\\s+${template.elementName}\\s*`);
+		return {
+			wrapped: prefix$1 + template.content,
+			prefixPattern: prefixPattern$1
+		};
+	}
+	const prefix = `${template.kind} `;
+	const prefixPattern = new RegExp(`^${template.kind}\\s*`);
+	return {
+		wrapped: prefix + template.content,
+		prefixPattern
+	};
+};
+/**
+* Strip the reconstructed prefix from formatted output to get back the template body.
+* Uses regex pattern matching to handle whitespace normalization by the formatter
+* (e.g., `query Foo ($id: ID!)` → `query Foo($id: ID!)`).
+*/
+const unwrapFormattedContent = (formatted, prefixPattern) => {
+	if (!prefixPattern) return formatted;
+	const match = formatted.match(prefixPattern);
+	if (!match) return formatted;
+	return formatted.slice(match[0].length);
+};
+/**
+* Format GraphQL templates within TypeScript source.
+*
+* Applies the given format function to each template's content, handles
+* wrapper reconstruction for curried syntax, and re-indents the result
+* to match the TypeScript embedding context.
+*
+* @returns Array of edits to apply to the source (sorted by position, not yet applied)
+*/
+const formatTemplatesInSource = (templates, tsSource, formatGraphql) => {
+	const edits = [];
+	for (const template of templates) {
+		if (!template.contentRange) continue;
+		const { wrapped, prefixPattern } = buildGraphqlWrapper(template);
+		let formatted;
+		try {
+			formatted = formatGraphql(wrapped);
+		} catch {
+			continue;
+		}
+		let unwrapped = unwrapFormattedContent(formatted, prefixPattern);
+		if (template.expressionRanges && template.expressionRanges.length > 0) {
+			for (let i = 0; i < template.expressionRanges.length; i++) {
+				const range = template.expressionRanges[i];
+				const exprText = tsSource.slice(range.start, range.end);
+				unwrapped = unwrapped.replace(`__FRAG_SPREAD_${i}__`, `\${${exprText}}`);
+			}
+		}
+		if (unwrapped === template.content) {
+			continue;
+		}
+		const baseIndent = detectBaseIndent(tsSource, template.contentRange.start);
+		const reindented = reindent(unwrapped, baseIndent, template.content);
+		if (reindented === template.content) {
+			continue;
+		}
+		edits.push({
+			start: template.contentRange.start,
+			end: template.contentRange.end,
+			newText: reindented
+		});
+	}
+	return edits;
+};
+
+//#endregion
+exports.OPERATION_KINDS = OPERATION_KINDS;
+exports.buildGraphqlWrapper = buildGraphqlWrapper;
+exports.detectBaseIndent = detectBaseIndent;
+exports.extractFromTaggedTemplate = extractFromTaggedTemplate;
+exports.extractTemplatesFromCallback = extractTemplatesFromCallback;
+exports.findGqlCall = findGqlCall;
+exports.formatTemplatesInSource = formatTemplatesInSource;
+exports.getGqlCallSchemaName = getGqlCallSchemaName;
+exports.isOperationKind = isOperationKind;
+exports.reindent = reindent;
+exports.unwrapFormattedContent = unwrapFormattedContent;
+exports.walkAndExtract = walkAndExtract;
+//# sourceMappingURL=template-extraction.cjs.map

package/dist/template-extraction.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-extraction.cjs","names":["templates: ExtractedTemplate[]","kind: string","elementName: string | undefined","typeName: string | undefined","expressionRanges: { start: number; end: number }[]","parts: string[]","template: ExtractedTemplate","prefix","prefixPattern","edits: TemplateFormatEdit[]","formatted: string"],"sources":["../src/template-extraction/extract.ts","../src/template-extraction/format.ts"],"sourcesContent":["/**\n * Template extraction from TypeScript source using SWC AST.\n *\n * Based on the typegen extractor (superset): supports both bare-tag\n * (`query\\`...\\``) and curried (`query(\"Name\")\\`...\\``) syntax.\n *\n * Position tracking is optional — pass spanOffset + converter to\n * populate contentRange on extracted templates.\n *\n * @module\n */\n\n// Re-export for convenience — SWC types are type-only imports\nimport type { ArrowFunctionExpression, CallExpression, MemberExpression, Node, TaggedTemplateExpression } from \"@swc/types\";\nimport type { SwcSpanConverter } from \"../utils/swc-span\";\nimport type { ExtractedTemplate, ExtractedTemplateWithPosition, OperationKind } from \"./types\";\n\nexport const OPERATION_KINDS = new Set<string>([\"query\", \"mutation\", \"subscription\", \"fragment\"]);\n\nexport const isOperationKind = (value: string): value is OperationKind => OPERATION_KINDS.has(value);\n\n/** Optional position tracking context for extraction. */\nexport type PositionTrackingContext = {\n  readonly spanOffset: number;\n  readonly converter: SwcSpanConverter;\n};\n\n/**\n * Check if a call expression is a gql.{schemaName}(...) call.\n * Returns the schema name if it is, null otherwise.\n */\nexport const getGqlCallSchemaName = (identifiers: ReadonlySet<string>, call: CallExpression): string | null => {\n  const callee = call.callee;\n  if (callee.type !== \"MemberExpression\") {\n    return null;\n  }\n\n  const member = callee as MemberExpression;\n  if (member.object.type !== \"Identifier\" || !identifiers.has(member.object.value)) {\n    return null;\n  }\n\n  if (member.property.type !== \"Identifier\") {\n    return null;\n  }\n\n  const firstArg = call.arguments[0];\n  if (!firstArg?.expression || firstArg.expression.type !== \"ArrowFunctionExpression\") {\n    return null;\n  }\n\n  return member.property.value;\n};\n\n/**\n * Extract templates from a gql callback's arrow function body.\n * Handles both expression bodies and block bodies with return statements.\n */\nexport const extractTemplatesFromCallback = (\n  arrow: ArrowFunctionExpression,\n  schemaName: string,\n  positionCtx?: PositionTrackingContext,\n): ExtractedTemplate[] => {\n  const templates: ExtractedTemplate[] = [];\n\n  const processExpression = (expr: Node): void => {\n    // Direct tagged template: query(\"Name\")`...`\n    if (expr.type === \"TaggedTemplateExpression\") {\n      const tagged = expr as unknown as TaggedTemplateExpression;\n      extractFromTaggedTemplate(tagged, schemaName, templates, positionCtx);\n      return;\n    }\n\n    // Metadata chaining: query(\"Name\")`...`({ metadata: {} })\n    if (expr.type === \"CallExpression\") {\n      const call = expr as unknown as CallExpression;\n      if (call.callee.type === \"TaggedTemplateExpression\") {\n        extractFromTaggedTemplate(call.callee as TaggedTemplateExpression, schemaName, templates, positionCtx);\n      }\n    }\n  };\n\n  // Expression body: ({ query }) => query(\"Name\")`...`\n  if (arrow.body.type !== \"BlockStatement\") {\n    processExpression(arrow.body);\n    return templates;\n  }\n\n  // Block body: ({ query }) => { return query(\"Name\")`...`; }\n  for (const stmt of arrow.body.stmts) {\n    if (stmt.type === \"ReturnStatement\" && stmt.argument) {\n      processExpression(stmt.argument);\n    }\n  }\n\n  return templates;\n};\n\n/**\n * Extract a single template from a tagged template expression.\n * Supports both bare-tag (Identifier) and curried (CallExpression) tag forms.\n */\nexport const extractFromTaggedTemplate = (\n  tagged: TaggedTemplateExpression,\n  schemaName: string,\n  templates: ExtractedTemplate[],\n  positionCtx?: PositionTrackingContext,\n): void => {\n  // Tag can be:\n  // - CallExpression: query(\"name\")`...` or fragment(\"name\", \"type\")`...` (curried syntax)\n  // - Identifier: legacy bare-tag form (skipped if it contains interpolations)\n  let kind: string;\n  let elementName: string | undefined;\n  let typeName: string | undefined;\n\n  if (tagged.tag.type === \"Identifier\") {\n    kind = tagged.tag.value;\n  } else if (tagged.tag.type === \"CallExpression\") {\n    const tagCall = tagged.tag as CallExpression;\n    if (tagCall.callee.type === \"Identifier\") {\n      kind = tagCall.callee.value;\n    } else {\n      return;\n    }\n    // Extract elementName and typeName from call arguments\n    const firstArg = tagCall.arguments[0]?.expression;\n    if (firstArg?.type === \"StringLiteral\") {\n      elementName = (firstArg as { value: string }).value;\n    }\n    const secondArg = tagCall.arguments[1]?.expression;\n    if (secondArg?.type === \"StringLiteral\") {\n      typeName = (secondArg as { value: string }).value;\n    }\n  } else {\n    return;\n  }\n\n  if (!isOperationKind(kind)) {\n    return;\n  }\n\n  const { quasis, expressions } = tagged.template;\n\n  // For legacy Identifier tag, skip templates with interpolations\n  if (tagged.tag.type === \"Identifier\" && expressions.length > 0) {\n    return;\n  }\n\n  if (quasis.length === 0) {\n    return;\n  }\n\n  // Build content and optionally track position\n  let contentStart = -1;\n  let contentEnd = -1;\n  const expressionRanges: { start: number; end: number }[] = [];\n\n  const parts: string[] = [];\n  for (let i = 0; i < quasis.length; i++) {\n    const quasi = quasis[i];\n    if (!quasi) continue;\n\n    if (positionCtx) {\n      const quasiStart = positionCtx.converter.byteOffsetToCharIndex(quasi.span.start - positionCtx.spanOffset);\n      const quasiEnd = positionCtx.converter.byteOffsetToCharIndex(quasi.span.end - positionCtx.spanOffset);\n      if (contentStart === -1) contentStart = quasiStart;\n      contentEnd = quasiEnd;\n    }\n\n    parts.push(quasi.cooked ?? quasi.raw);\n    if (i < expressions.length) {\n      parts.push(`__FRAG_SPREAD_${i}__`);\n      if (positionCtx) {\n        // All SWC AST nodes have span; cast needed because Expression union type doesn't expose it uniformly\n        const expr = expressions[i] as unknown as { span: { start: number; end: number } };\n        const exprStart = positionCtx.converter.byteOffsetToCharIndex(expr.span.start - positionCtx.spanOffset);\n        const exprEnd = positionCtx.converter.byteOffsetToCharIndex(expr.span.end - positionCtx.spanOffset);\n        expressionRanges.push({ start: exprStart, end: exprEnd });\n      }\n    }\n  }\n  const content = parts.join(\"\");\n\n  const template: ExtractedTemplate = {\n    schemaName,\n    kind,\n    content,\n    ...(elementName !== undefined ? { elementName } : {}),\n    ...(typeName !== undefined ? { typeName } : {}),\n    ...(positionCtx && contentStart !== -1 && contentEnd !== -1\n      ? { contentRange: { start: contentStart, end: contentEnd } }\n      : {}),\n    ...(expressionRanges.length > 0 ? { expressionRanges } : {}),\n  };\n\n  templates.push(template);\n};\n\n/**\n * Find the innermost gql call, unwrapping method chains like .attach().\n */\nexport const findGqlCall = (identifiers: ReadonlySet<string>, node: Node): CallExpression | null => {\n  if (!node || node.type !== \"CallExpression\") {\n    return null;\n  }\n\n  const call = node as unknown as CallExpression;\n  if (getGqlCallSchemaName(identifiers, call) !== null) {\n    return call;\n  }\n\n  const callee = call.callee;\n  if (callee.type !== \"MemberExpression\") {\n    return null;\n  }\n\n  return findGqlCall(identifiers, callee.object as unknown as Node);\n};\n\n/**\n * Walk AST to find gql calls and extract templates.\n */\nexport function walkAndExtract(\n  node: Node,\n  identifiers: ReadonlySet<string>,\n  positionCtx: PositionTrackingContext,\n): ExtractedTemplateWithPosition[];\nexport function walkAndExtract(\n  node: Node,\n  identifiers: ReadonlySet<string>,\n  positionCtx?: PositionTrackingContext,\n): ExtractedTemplate[];\nexport function walkAndExtract(\n  node: Node,\n  identifiers: ReadonlySet<string>,\n  positionCtx?: PositionTrackingContext,\n): ExtractedTemplate[] {\n  const templates: ExtractedTemplate[] = [];\n\n  const visit = (n: Node | ReadonlyArray<Node> | Record<string, unknown>): void => {\n    if (!n || typeof n !== \"object\") {\n      return;\n    }\n\n    if (\"type\" in n && n.type === \"CallExpression\") {\n      const gqlCall = findGqlCall(identifiers, n as Node);\n      if (gqlCall) {\n        const schemaName = getGqlCallSchemaName(identifiers, gqlCall);\n        if (schemaName) {\n          const arrow = gqlCall.arguments[0]?.expression as ArrowFunctionExpression;\n          templates.push(...extractTemplatesFromCallback(arrow, schemaName, positionCtx));\n        }\n        return; // Don't recurse into gql calls\n      }\n    }\n\n    // Recurse into all array and object properties\n    if (Array.isArray(n)) {\n      for (const item of n) {\n        visit(item as Node);\n      }\n      return;\n    }\n\n    for (const key of Object.keys(n)) {\n      if (key === \"span\" || key === \"type\") {\n        continue;\n      }\n      const value = (n as Record<string, unknown>)[key];\n      if (value && typeof value === \"object\") {\n        visit(value as Node);\n      }\n    }\n  };\n\n  visit(node);\n  return templates;\n}\n","/**\n * GraphQL template formatting utilities.\n *\n * Pure string operations — no dependency on `graphql` package.\n * Consumers provide their own format function (e.g., graphql-js parse/print).\n *\n * @module\n */\n\nimport type { ExtractedTemplate, TemplateFormatEdit } from \"./types\";\n\n/** A function that formats GraphQL source text. */\nexport type FormatGraphqlFn = (source: string) => string;\n\n/**\n * Detect the base indentation for a template by looking at the line\n * containing the opening backtick.\n */\nexport const detectBaseIndent = (tsSource: string, contentStartOffset: number): string => {\n  // Find the start of the line containing contentStartOffset\n  let lineStart = contentStartOffset;\n  while (lineStart > 0 && tsSource.charCodeAt(lineStart - 1) !== 10) {\n    lineStart--;\n  }\n\n  // Extract leading whitespace from that line\n  let i = lineStart;\n  while (i < tsSource.length && (tsSource.charCodeAt(i) === 32 || tsSource.charCodeAt(i) === 9)) {\n    i++;\n  }\n\n  return tsSource.slice(lineStart, i);\n};\n\n/**\n * Re-indent formatted GraphQL to match the embedding context.\n *\n * - If original was single-line and formatted is single-line, keep as-is\n * - Otherwise, apply base indent + one level to each line, preserving\n *   original leading/trailing newline pattern\n */\nexport const reindent = (formatted: string, baseIndent: string, originalContent: string): string => {\n  const trimmedFormatted = formatted.trim();\n\n  // If original was single-line and formatted is also single-line, keep it\n  if (!originalContent.includes(\"\\n\") && !trimmedFormatted.includes(\"\\n\")) {\n    return trimmedFormatted;\n  }\n\n  // For multi-line: use the indentation pattern from the original content\n  const indent = `${baseIndent}  `; // add one level of indentation\n  const lines = trimmedFormatted.split(\"\\n\");\n  const indentedLines = lines.map((line) => (line.trim() === \"\" ? \"\" : indent + line));\n\n  // Match original leading/trailing newline pattern\n  const startsWithNewline = originalContent.startsWith(\"\\n\");\n  const endsWithNewline = originalContent.endsWith(\"\\n\");\n\n  let result = indentedLines.join(\"\\n\");\n  if (startsWithNewline) {\n    result = `\\n${result}`;\n  }\n  if (endsWithNewline) {\n    result = `${result}\\n${baseIndent}`;\n  }\n\n  return result;\n};\n\nconst GRAPHQL_KEYWORDS = new Set([\"query\", \"mutation\", \"subscription\", \"fragment\"]);\n\n/**\n * Reconstruct a full GraphQL document from template content + metadata.\n *\n * For curried syntax, the template `content` is only the body (e.g., `{ user { id } }`).\n * GraphQL parsers need a full document (e.g., `query GetUser { user { id } }`).\n *\n * For bare-tag syntax, the content already starts with a keyword and is a full document.\n *\n * @returns The wrapped source and a regex pattern to strip the synthetic prefix after formatting\n */\nexport const buildGraphqlWrapper = (template: ExtractedTemplate): { wrapped: string; prefixPattern: RegExp | null } => {\n  const content = template.content.trimStart();\n  const firstWord = content.split(/[\\s({]/)[0] ?? \"\";\n\n  // If content already starts with a GraphQL keyword, it's a full document (bare-tag)\n  if (GRAPHQL_KEYWORDS.has(firstWord)) {\n    return { wrapped: template.content, prefixPattern: null };\n  }\n\n  // Curried syntax — reconstruct the header\n  if (template.elementName) {\n    if (template.kind === \"fragment\" && template.typeName) {\n      const prefix = `fragment ${template.elementName} on ${template.typeName} `;\n      const prefixPattern = new RegExp(`^fragment\\\\s+${template.elementName}\\\\s+on\\\\s+${template.typeName}\\\\s*`);\n      return { wrapped: prefix + template.content, prefixPattern };\n    }\n    const prefix = `${template.kind} ${template.elementName} `;\n    const prefixPattern = new RegExp(`^${template.kind}\\\\s+${template.elementName}\\\\s*`);\n    return { wrapped: prefix + template.content, prefixPattern };\n  }\n\n  // No elementName — try wrapping with just the kind\n  const prefix = `${template.kind} `;\n  const prefixPattern = new RegExp(`^${template.kind}\\\\s*`);\n  return { wrapped: prefix + template.content, prefixPattern };\n};\n\n/**\n * Strip the reconstructed prefix from formatted output to get back the template body.\n * Uses regex pattern matching to handle whitespace normalization by the formatter\n * (e.g., `query Foo ($id: ID!)` → `query Foo($id: ID!)`).\n */\nexport const unwrapFormattedContent = (formatted: string, prefixPattern: RegExp | null): string => {\n  if (!prefixPattern) return formatted;\n  const match = formatted.match(prefixPattern);\n  if (!match) return formatted;\n  return formatted.slice(match[0].length);\n};\n\n/**\n * Format GraphQL templates within TypeScript source.\n *\n * Applies the given format function to each template's content, handles\n * wrapper reconstruction for curried syntax, and re-indents the result\n * to match the TypeScript embedding context.\n *\n * @returns Array of edits to apply to the source (sorted by position, not yet applied)\n */\nexport const formatTemplatesInSource = (\n  templates: readonly ExtractedTemplate[],\n  tsSource: string,\n  formatGraphql: FormatGraphqlFn,\n): readonly TemplateFormatEdit[] => {\n  const edits: TemplateFormatEdit[] = [];\n\n  for (const template of templates) {\n    if (!template.contentRange) continue;\n\n    // Wrap the content for formatting\n    const { wrapped, prefixPattern } = buildGraphqlWrapper(template);\n\n    let formatted: string;\n    try {\n      formatted = formatGraphql(wrapped);\n    } catch {\n      continue;\n    }\n\n    // Unwrap the prefix\n    let unwrapped = unwrapFormattedContent(formatted, prefixPattern);\n\n    // Restore interpolation expressions: replace __FRAG_SPREAD_N__ with original ${...} syntax\n    if (template.expressionRanges && template.expressionRanges.length > 0) {\n      for (let i = 0; i < template.expressionRanges.length; i++) {\n        const range = template.expressionRanges[i]!;\n        const exprText = tsSource.slice(range.start, range.end);\n        unwrapped = unwrapped.replace(`__FRAG_SPREAD_${i}__`, `\\${${exprText}}`);\n      }\n    }\n\n    // Fast path: skip if formatter produces identical output\n    if (unwrapped === template.content) {\n      continue;\n    }\n\n    // Detect base indentation from the TS source\n    const baseIndent = detectBaseIndent(tsSource, template.contentRange.start);\n\n    // Re-indent the formatted output\n    const reindented = reindent(unwrapped, baseIndent, template.content);\n\n    // Skip if no changes after re-indentation\n    if (reindented === template.content) {\n      continue;\n    }\n\n    edits.push({\n      start: template.contentRange.start,\n      end: template.contentRange.end,\n      newText: reindented,\n    });\n  }\n\n  return edits;\n};\n"],"mappings":"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"}

package/dist/template-extraction.d.cts

@@ -0,0 +1,131 @@
+import { t as SwcSpanConverter } from "./swc-span-Bi4N-vaI.cjs";
+import { ArrowFunctionExpression, CallExpression, Node, TaggedTemplateExpression } from "@swc/types";
+
+//#region packages/common/src/template-extraction/types.d.ts
+
+/**
+ * Shared types for tagged template extraction and formatting.
+ * @module
+ */
+/** Operation kind extracted from tagged template tag name. */
+type OperationKind = "query" | "mutation" | "subscription" | "fragment";
+/** A single tagged template extracted from a TypeScript source file. */
+type ExtractedTemplate = {
+  /** Resolved schema name from gql.{schemaName}. */
+  readonly schemaName: string;
+  /** Operation kind from tag name. */
+  readonly kind: OperationKind;
+  /** Raw GraphQL content between backticks (may contain __FRAG_SPREAD_N__ placeholders). */
+  readonly content: string;
+  /** Element name from curried tag call (e.g., "GetUser" from query("GetUser")). */
+  readonly elementName?: string;
+  /** Type name from curried fragment call (e.g., "User" from fragment("UserFields", "User")). */
+  readonly typeName?: string;
+  /** Character offset range of GraphQL content within TS source (excludes backticks). */
+  readonly contentRange?: {
+    readonly start: number;
+    readonly end: number;
+  };
+  /** Character offset ranges of interpolation expressions within TS source (for __FRAG_SPREAD_N__ restoration). */
+  readonly expressionRanges?: readonly {
+    readonly start: number;
+    readonly end: number;
+  }[];
+};
+/** ExtractedTemplate with guaranteed position information (when positionCtx is provided). */
+type ExtractedTemplateWithPosition = ExtractedTemplate & {
+  readonly contentRange: {
+    readonly start: number;
+    readonly end: number;
+  };
+};
+/** A text edit to apply to source code for template formatting. */
+type TemplateFormatEdit = {
+  readonly start: number;
+  readonly end: number;
+  readonly newText: string;
+};
+//#endregion
+//#region packages/common/src/template-extraction/extract.d.ts
+
+declare const OPERATION_KINDS: Set<string>;
+declare const isOperationKind: (value: string) => value is OperationKind;
+/** Optional position tracking context for extraction. */
+type PositionTrackingContext = {
+  readonly spanOffset: number;
+  readonly converter: SwcSpanConverter;
+};
+/**
+ * Check if a call expression is a gql.{schemaName}(...) call.
+ * Returns the schema name if it is, null otherwise.
+ */
+declare const getGqlCallSchemaName: (identifiers: ReadonlySet<string>, call: CallExpression) => string | null;
+/**
+ * Extract templates from a gql callback's arrow function body.
+ * Handles both expression bodies and block bodies with return statements.
+ */
+declare const extractTemplatesFromCallback: (arrow: ArrowFunctionExpression, schemaName: string, positionCtx?: PositionTrackingContext) => ExtractedTemplate[];
+/**
+ * Extract a single template from a tagged template expression.
+ * Supports both bare-tag (Identifier) and curried (CallExpression) tag forms.
+ */
+declare const extractFromTaggedTemplate: (tagged: TaggedTemplateExpression, schemaName: string, templates: ExtractedTemplate[], positionCtx?: PositionTrackingContext) => void;
+/**
+ * Find the innermost gql call, unwrapping method chains like .attach().
+ */
+declare const findGqlCall: (identifiers: ReadonlySet<string>, node: Node) => CallExpression | null;
+/**
+ * Walk AST to find gql calls and extract templates.
+ */
+declare function walkAndExtract(node: Node, identifiers: ReadonlySet<string>, positionCtx: PositionTrackingContext): ExtractedTemplateWithPosition[];
+declare function walkAndExtract(node: Node, identifiers: ReadonlySet<string>, positionCtx?: PositionTrackingContext): ExtractedTemplate[];
+//#endregion
+//#region packages/common/src/template-extraction/format.d.ts
+/** A function that formats GraphQL source text. */
+type FormatGraphqlFn = (source: string) => string;
+/**
+ * Detect the base indentation for a template by looking at the line
+ * containing the opening backtick.
+ */
+declare const detectBaseIndent: (tsSource: string, contentStartOffset: number) => string;
+/**
+ * Re-indent formatted GraphQL to match the embedding context.
+ *
+ * - If original was single-line and formatted is single-line, keep as-is
+ * - Otherwise, apply base indent + one level to each line, preserving
+ *   original leading/trailing newline pattern
+ */
+declare const reindent: (formatted: string, baseIndent: string, originalContent: string) => string;
+/**
+ * Reconstruct a full GraphQL document from template content + metadata.
+ *
+ * For curried syntax, the template `content` is only the body (e.g., `{ user { id } }`).
+ * GraphQL parsers need a full document (e.g., `query GetUser { user { id } }`).
+ *
+ * For bare-tag syntax, the content already starts with a keyword and is a full document.
+ *
+ * @returns The wrapped source and a regex pattern to strip the synthetic prefix after formatting
+ */
+declare const buildGraphqlWrapper: (template: ExtractedTemplate) => {
+  wrapped: string;
+  prefixPattern: RegExp | null;
+};
+/**
+ * Strip the reconstructed prefix from formatted output to get back the template body.
+ * Uses regex pattern matching to handle whitespace normalization by the formatter
+ * (e.g., `query Foo ($id: ID!)` → `query Foo($id: ID!)`).
+ */
+declare const unwrapFormattedContent: (formatted: string, prefixPattern: RegExp | null) => string;
+/**
+ * Format GraphQL templates within TypeScript source.
+ *
+ * Applies the given format function to each template's content, handles
+ * wrapper reconstruction for curried syntax, and re-indents the result
+ * to match the TypeScript embedding context.
+ *
+ * @returns Array of edits to apply to the source (sorted by position, not yet applied)
+ */
+declare const formatTemplatesInSource: (templates: readonly ExtractedTemplate[], tsSource: string, formatGraphql: FormatGraphqlFn) => readonly TemplateFormatEdit[];
+//#endregion
+export { ExtractedTemplate, ExtractedTemplateWithPosition, FormatGraphqlFn, OPERATION_KINDS, OperationKind, PositionTrackingContext, TemplateFormatEdit, buildGraphqlWrapper, detectBaseIndent, extractFromTaggedTemplate, extractTemplatesFromCallback, findGqlCall, formatTemplatesInSource, getGqlCallSchemaName, isOperationKind, reindent, unwrapFormattedContent, walkAndExtract };
+//# sourceMappingURL=template-extraction.d.cts.map

package/dist/template-extraction.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-extraction.d.cts","names":[],"sources":["../src/template-extraction/types.ts","../src/template-extraction/extract.ts","../src/template-extraction/format.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/template-extraction.d.mts

@@ -0,0 +1,131 @@
+import { t as SwcSpanConverter } from "./swc-span-C4QReqWr.mjs";
+import { ArrowFunctionExpression, CallExpression, Node, TaggedTemplateExpression } from "@swc/types";
+
+//#region packages/common/src/template-extraction/types.d.ts
+
+/**
+ * Shared types for tagged template extraction and formatting.
+ * @module
+ */
+/** Operation kind extracted from tagged template tag name. */
+type OperationKind = "query" | "mutation" | "subscription" | "fragment";
+/** A single tagged template extracted from a TypeScript source file. */
+type ExtractedTemplate = {
+  /** Resolved schema name from gql.{schemaName}. */
+  readonly schemaName: string;
+  /** Operation kind from tag name. */
+  readonly kind: OperationKind;
+  /** Raw GraphQL content between backticks (may contain __FRAG_SPREAD_N__ placeholders). */
+  readonly content: string;
+  /** Element name from curried tag call (e.g., "GetUser" from query("GetUser")). */
+  readonly elementName?: string;
+  /** Type name from curried fragment call (e.g., "User" from fragment("UserFields", "User")). */
+  readonly typeName?: string;
+  /** Character offset range of GraphQL content within TS source (excludes backticks). */
+  readonly contentRange?: {
+    readonly start: number;
+    readonly end: number;
+  };
+  /** Character offset ranges of interpolation expressions within TS source (for __FRAG_SPREAD_N__ restoration). */
+  readonly expressionRanges?: readonly {
+    readonly start: number;
+    readonly end: number;
+  }[];
+};
+/** ExtractedTemplate with guaranteed position information (when positionCtx is provided). */
+type ExtractedTemplateWithPosition = ExtractedTemplate & {
+  readonly contentRange: {
+    readonly start: number;
+    readonly end: number;
+  };
+};
+/** A text edit to apply to source code for template formatting. */
+type TemplateFormatEdit = {
+  readonly start: number;
+  readonly end: number;
+  readonly newText: string;
+};
+//#endregion
+//#region packages/common/src/template-extraction/extract.d.ts
+
+declare const OPERATION_KINDS: Set<string>;
+declare const isOperationKind: (value: string) => value is OperationKind;
+/** Optional position tracking context for extraction. */
+type PositionTrackingContext = {
+  readonly spanOffset: number;
+  readonly converter: SwcSpanConverter;
+};
+/**
+ * Check if a call expression is a gql.{schemaName}(...) call.
+ * Returns the schema name if it is, null otherwise.
+ */
+declare const getGqlCallSchemaName: (identifiers: ReadonlySet<string>, call: CallExpression) => string | null;
+/**
+ * Extract templates from a gql callback's arrow function body.
+ * Handles both expression bodies and block bodies with return statements.
+ */
+declare const extractTemplatesFromCallback: (arrow: ArrowFunctionExpression, schemaName: string, positionCtx?: PositionTrackingContext) => ExtractedTemplate[];
+/**
+ * Extract a single template from a tagged template expression.
+ * Supports both bare-tag (Identifier) and curried (CallExpression) tag forms.
+ */
+declare const extractFromTaggedTemplate: (tagged: TaggedTemplateExpression, schemaName: string, templates: ExtractedTemplate[], positionCtx?: PositionTrackingContext) => void;
+/**
+ * Find the innermost gql call, unwrapping method chains like .attach().
+ */
+declare const findGqlCall: (identifiers: ReadonlySet<string>, node: Node) => CallExpression | null;
+/**
+ * Walk AST to find gql calls and extract templates.
+ */
+declare function walkAndExtract(node: Node, identifiers: ReadonlySet<string>, positionCtx: PositionTrackingContext): ExtractedTemplateWithPosition[];
+declare function walkAndExtract(node: Node, identifiers: ReadonlySet<string>, positionCtx?: PositionTrackingContext): ExtractedTemplate[];
+//#endregion
+//#region packages/common/src/template-extraction/format.d.ts
+/** A function that formats GraphQL source text. */
+type FormatGraphqlFn = (source: string) => string;
+/**
+ * Detect the base indentation for a template by looking at the line
+ * containing the opening backtick.
+ */
+declare const detectBaseIndent: (tsSource: string, contentStartOffset: number) => string;
+/**
+ * Re-indent formatted GraphQL to match the embedding context.
+ *
+ * - If original was single-line and formatted is single-line, keep as-is
+ * - Otherwise, apply base indent + one level to each line, preserving
+ *   original leading/trailing newline pattern
+ */
+declare const reindent: (formatted: string, baseIndent: string, originalContent: string) => string;
+/**
+ * Reconstruct a full GraphQL document from template content + metadata.
+ *
+ * For curried syntax, the template `content` is only the body (e.g., `{ user { id } }`).
+ * GraphQL parsers need a full document (e.g., `query GetUser { user { id } }`).
+ *
+ * For bare-tag syntax, the content already starts with a keyword and is a full document.
+ *
+ * @returns The wrapped source and a regex pattern to strip the synthetic prefix after formatting
+ */
+declare const buildGraphqlWrapper: (template: ExtractedTemplate) => {
+  wrapped: string;
+  prefixPattern: RegExp | null;
+};
+/**
+ * Strip the reconstructed prefix from formatted output to get back the template body.
+ * Uses regex pattern matching to handle whitespace normalization by the formatter
+ * (e.g., `query Foo ($id: ID!)` → `query Foo($id: ID!)`).
+ */
+declare const unwrapFormattedContent: (formatted: string, prefixPattern: RegExp | null) => string;
+/**
+ * Format GraphQL templates within TypeScript source.
+ *
+ * Applies the given format function to each template's content, handles
+ * wrapper reconstruction for curried syntax, and re-indents the result
+ * to match the TypeScript embedding context.
+ *
+ * @returns Array of edits to apply to the source (sorted by position, not yet applied)
+ */
+declare const formatTemplatesInSource: (templates: readonly ExtractedTemplate[], tsSource: string, formatGraphql: FormatGraphqlFn) => readonly TemplateFormatEdit[];
+//#endregion
+export { ExtractedTemplate, ExtractedTemplateWithPosition, FormatGraphqlFn, OPERATION_KINDS, OperationKind, PositionTrackingContext, TemplateFormatEdit, buildGraphqlWrapper, detectBaseIndent, extractFromTaggedTemplate, extractTemplatesFromCallback, findGqlCall, formatTemplatesInSource, getGqlCallSchemaName, isOperationKind, reindent, unwrapFormattedContent, walkAndExtract };
+//# sourceMappingURL=template-extraction.d.mts.map