@workos/oagen-emitters 0.15.2 → 0.16.1

package/src/snippets/kotlin.ts

@@ -0,0 +1,144 @@
+import type { EmitterContext, ExampleBuilder, ResolvedOperation, SnippetArg, SnippetEmitter } from '@workos/oagen';
+import { collectSnippetArgs, collectWrapperArgs } from '@workos/oagen';
+import { apiClassName, methodName, packageSegment, propertyName } from '../kotlin/naming.js';
+
+const INDENT = '    ';
+
+/**
+ * Emits Java-syntax snippets (rendered as `.java`) backed by the Kotlin SDK's
+ * naming so JVM callers see the same method and options names whether they
+ * write Kotlin or Java. The WorkOS docs render the `.java` extension because
+ * Java is the most common JVM consumer; Kotlin call sites would look almost
+ * identical apart from `var`/`val` and named-argument syntax.
+ */
+export const kotlinSnippetEmitter: SnippetEmitter = {
+  language: 'java',
+  fileExtension: 'java',
+
+  renderOperation(resolved, ctx, examples) {
+    if (resolved.urlBuilder) return null;
+
+    const method =
+      resolved.wrappers && resolved.wrappers.length > 0
+        ? methodName(resolved.wrappers[0]!.name)
+        : methodName(resolved.methodName);
+
+    return renderCall(resolved, ctx, examples, method);
+  },
+};
+
+function renderCall(
+  resolved: ResolvedOperation,
+  ctx: EmitterContext,
+  examples: ExampleBuilder,
+  method: string,
+): string {
+  const apiClass = apiClassName(resolved.mountOn);
+  const accessor = propertyName(resolved.mountOn);
+  const optionsType = `${methodName(
+    resolved.wrappers && resolved.wrappers.length > 0 ? resolved.wrappers[0]!.name : resolved.methodName,
+  )}Options`;
+  const optionsTypeCapitalized = optionsType[0]!.toUpperCase() + optionsType.slice(1);
+  const apiSubPackage = packageSegment(resolved.mountOn);
+
+  let args: SnippetArg[];
+  let pathArgs: SnippetArg[];
+  let optionsArgs: SnippetArg[];
+
+  if (resolved.wrappers && resolved.wrappers.length > 0) {
+    args = collectWrapperArgs(resolved.wrappers[0]!, ctx, examples);
+    pathArgs = [];
+    optionsArgs = args;
+  } else {
+    const collected = collectSnippetArgs(resolved, ctx, examples);
+    args = collected.args;
+    pathArgs = args.filter((a) => a.source === 'path');
+    optionsArgs = args.filter((a) => a.source !== 'path');
+  }
+
+  const lines: string[] = [];
+  lines.push('import com.workos.WorkOS;');
+  if (optionsArgs.length > 0) {
+    lines.push(`import com.workos.${apiSubPackage}.${apiClass}Api.${optionsTypeCapitalized};`);
+  }
+  lines.push('');
+  lines.push('WorkOS workos = new WorkOS("sk_example_123456789");');
+  lines.push('');
+
+  const callParts: string[] = pathArgs.map((p) => renderValue(p.value));
+
+  if (optionsArgs.length > 0) {
+    lines.push(`${optionsTypeCapitalized} options = ${optionsTypeCapitalized}.builder()`);
+    for (const a of optionsArgs) {
+      const prop = propertyName(a.wireName);
+      const value = renderValue(a.value);
+      const indentedValue = indentContinuationLines(value, INDENT);
+      lines.push(`${INDENT}.${prop}(${indentedValue})`);
+    }
+    lines.push(`${INDENT}.build();`);
+    lines.push('');
+    callParts.push('options');
+  }
+
+  if (callParts.length === 0) {
+    lines.push(`workos.${accessor}.${method}();`);
+  } else {
+    lines.push(`workos.${accessor}.${method}(${callParts.join(', ')});`);
+  }
+
+  return lines.join('\n');
+}
+
+// ---------------------------------------------------------------------------
+// Java literal rendering
+// ---------------------------------------------------------------------------
+
+function renderValue(value: unknown): string {
+  if (value === null || value === undefined) return 'null';
+  if (typeof value === 'boolean') return value ? 'true' : 'false';
+  if (typeof value === 'number') return String(value);
+  if (typeof value === 'string') return javaString(value);
+  if (Array.isArray(value)) return renderList(value);
+  if (typeof value === 'object') return renderMap(value as Record<string, unknown>);
+  return 'null';
+}
+
+function javaString(s: string): string {
+  return `"${s.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+}
+
+function renderList(items: unknown[]): string {
+  if (items.length === 0) return 'List.of()';
+  const rendered = items.map((v) => renderValue(v));
+  const oneline = `List.of(${rendered.join(', ')})`;
+  if (oneline.length <= 80 && rendered.every((r) => !r.includes('\n'))) return oneline;
+  const lines: string[] = ['List.of('];
+  for (let i = 0; i < rendered.length; i++) {
+    const trailing = i < rendered.length - 1 ? ',' : '';
+    lines.push(`${INDENT}${indentContinuationLines(rendered[i]!, INDENT)}${trailing}`);
+  }
+  lines.push(')');
+  return lines.join('\n');
+}
+
+function renderMap(obj: Record<string, unknown>): string {
+  const entries = Object.entries(obj);
+  if (entries.length === 0) return 'Map.of()';
+  const rendered = entries.map(([k, v]) => ({ key: k, value: renderValue(v) }));
+  const oneline = `Map.of(${rendered.map((e) => `"${e.key}", ${e.value}`).join(', ')})`;
+  if (oneline.length <= 80 && rendered.every((e) => !e.value.includes('\n'))) return oneline;
+  const lines: string[] = ['Map.of('];
+  for (let i = 0; i < rendered.length; i++) {
+    const e = rendered[i]!;
+    const trailing = i < rendered.length - 1 ? ',' : '';
+    lines.push(`${INDENT}"${e.key}", ${indentContinuationLines(e.value, INDENT)}${trailing}`);
+  }
+  lines.push(')');
+  return lines.join('\n');
+}
+
+function indentContinuationLines(s: string, indent: string): string {
+  if (!s.includes('\n')) return s;
+  const lines = s.split('\n');
+  return lines.map((line, i) => (i === 0 ? line : `${indent}${line}`)).join('\n');
+}

package/src/snippets/php.ts

@@ -0,0 +1,149 @@
+import type { SnippetArg, SnippetEmitter } from '@workos/oagen';
+import { collectSnippetArgs, collectWrapperArgs } from '@workos/oagen';
+import { fieldName, servicePropertyName } from '../php/naming.js';
+
+const INDENT = '    ';
+
+export const phpSnippetEmitter: SnippetEmitter = {
+  language: 'php',
+  fileExtension: 'php',
+
+  renderOperation(resolved, ctx, examples) {
+    if (resolved.urlBuilder) return null;
+
+    const accessor = servicePropertyName(resolved.mountOn);
+    const method = fieldName(
+      resolved.wrappers && resolved.wrappers.length > 0 ? resolved.wrappers[0]!.name : resolved.methodName,
+    );
+
+    let args: SnippetArg[];
+    let collisionNames: Set<string>;
+    if (resolved.wrappers && resolved.wrappers.length > 0) {
+      args = collectWrapperArgs(resolved.wrappers[0]!, ctx, examples);
+      collisionNames = new Set();
+    } else {
+      const collected = collectSnippetArgs(resolved, ctx, examples);
+      args = collected.args;
+      collisionNames = collected.collisionNames;
+    }
+
+    return renderCall(accessor, method, toPhpArgs(args, collisionNames));
+  },
+};
+
+interface PhpArg {
+  keyword: string;
+  value: string;
+}
+
+function toPhpArgs(args: SnippetArg[], collisions: Set<string>): PhpArg[] {
+  const seen = new Set<string>();
+  const out: PhpArg[] = [];
+  for (const a of args) {
+    const keyword = phpKeyword(a, collisions);
+    if (seen.has(keyword)) continue;
+    seen.add(keyword);
+    out.push({ keyword, value: renderValue(a.value) });
+  }
+  return out;
+}
+
+function phpKeyword(arg: SnippetArg, collisions: Set<string>): string {
+  const base = fieldName(arg.wireName);
+  if (arg.source === 'body' && collisions.has(arg.wireName)) return `body${capitalize(base)}`;
+  return base;
+}
+
+function capitalize(s: string): string {
+  return s.length === 0 ? s : s[0]!.toUpperCase() + s.slice(1);
+}
+
+function renderCall(accessor: string, method: string, args: PhpArg[]): string {
+  const lines: string[] = [];
+  lines.push('<?php');
+  lines.push('');
+  lines.push('use WorkOS\\WorkOS;');
+  lines.push('');
+  lines.push('$workos = new WorkOS(');
+  lines.push(`${INDENT}apiKey: 'sk_example_123456789',`);
+  lines.push(`${INDENT}clientId: 'client_123456789',`);
+  lines.push(');');
+  lines.push('');
+
+  const target = `$workos->${accessor}()->${method}`;
+  if (args.length === 0) {
+    lines.push(`${target}();`);
+    return lines.join('\n');
+  }
+
+  if (args.length === 1 && !args[0]!.value.includes('\n')) {
+    const a = args[0]!;
+    lines.push(`${target}(${a.keyword}: ${a.value});`);
+    return lines.join('\n');
+  }
+
+  lines.push(`${target}(`);
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i]!;
+    const trailing = i < args.length - 1 ? ',' : ',';
+    const valueIndented = indentContinuationLines(a.value, INDENT);
+    lines.push(`${INDENT}${a.keyword}: ${valueIndented}${trailing}`);
+  }
+  lines.push(');');
+
+  return lines.join('\n');
+}
+
+// ---------------------------------------------------------------------------
+// PHP literal rendering
+// ---------------------------------------------------------------------------
+
+function renderValue(value: unknown): string {
+  if (value === null || value === undefined) return 'null';
+  if (typeof value === 'boolean') return value ? 'true' : 'false';
+  if (typeof value === 'number') return String(value);
+  if (typeof value === 'string') return phpString(value);
+  if (Array.isArray(value)) return renderArray(value);
+  if (typeof value === 'object') return renderAssoc(value as Record<string, unknown>);
+  return 'null';
+}
+
+function phpString(s: string): string {
+  return `'${s.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'`;
+}
+
+function renderArray(items: unknown[]): string {
+  if (items.length === 0) return '[]';
+  const rendered = items.map((v) => renderValue(v));
+  const oneline = `[${rendered.join(', ')}]`;
+  if (oneline.length <= 80 && rendered.every((r) => !r.includes('\n'))) return oneline;
+  const lines: string[] = ['['];
+  for (let i = 0; i < rendered.length; i++) {
+    const trailing = i < rendered.length - 1 ? ',' : ',';
+    lines.push(`${INDENT}${indentContinuationLines(rendered[i]!, INDENT)}${trailing}`);
+  }
+  lines.push(']');
+  return lines.join('\n');
+}
+
+function renderAssoc(obj: Record<string, unknown>): string {
+  const entries = Object.entries(obj);
+  if (entries.length === 0) return '[]';
+  const rendered = entries.map(([k, v]) => ({ key: k, value: renderValue(v) }));
+  const oneline = `[${rendered.map((e) => `'${e.key}' => ${e.value}`).join(', ')}]`;
+  if (oneline.length <= 80 && rendered.every((e) => !e.value.includes('\n'))) return oneline;
+  const lines: string[] = ['['];
+  for (let i = 0; i < rendered.length; i++) {
+    const e = rendered[i]!;
+    const trailing = i < rendered.length - 1 ? ',' : ',';
+    lines.push(`${INDENT}'${e.key}' => ${indentContinuationLines(e.value, INDENT)}${trailing}`);
+  }
+  lines.push(']');
+  return lines.join('\n');
+}
+
+function indentContinuationLines(s: string, indent: string): string {
+  if (!s.includes('\n')) return s;
+  const lines = s.split('\n');
+  return lines.map((line, i) => (i === 0 ? line : `${indent}${line}`)).join('\n');
+}

package/src/snippets/plugin.ts

@@ -0,0 +1,36 @@
+import type { SnippetEmitter } from '@workos/oagen';
+import { dotnetSnippetEmitter } from './dotnet.js';
+import { goSnippetEmitter } from './go.js';
+import { kotlinSnippetEmitter } from './kotlin.js';
+import { phpSnippetEmitter } from './php.js';
+import { pythonSnippetEmitter } from './python.js';
+import { rubySnippetEmitter } from './ruby.js';
+import { rustSnippetEmitter } from './rust.js';
+
+/**
+ * Bundle of snippet emitters for every WorkOS SDK language we currently
+ * generate call-site samples for. Node is intentionally absent — the docs
+ * pipeline still owns hand-authored TypeScript samples there.
+ *
+ * ```ts
+ * import { runSnippetEmitters, workosSnippetsPlugin } from '@workos/oagen-emitters';
+ *
+ * const snippets = runSnippetEmitters(workosSnippetsPlugin.snippets, ctx);
+ * ```
+ *
+ * Each entry mirrors a published WorkOS SDK and reuses that emitter's naming
+ * helpers (`src/<lang>/naming.ts`), so generated samples stay in lockstep
+ * with the SDK they document — method names, mount-target casing, parameter
+ * names, and reserved-word handling all match what the real SDK exposes.
+ */
+export const workosSnippetsPlugin: { snippets: SnippetEmitter[] } = {
+  snippets: [
+    rubySnippetEmitter,
+    pythonSnippetEmitter,
+    phpSnippetEmitter,
+    goSnippetEmitter,
+    dotnetSnippetEmitter,
+    kotlinSnippetEmitter,
+    rustSnippetEmitter,
+  ],
+};

package/src/snippets/python.ts

@@ -0,0 +1,135 @@
+import type { SnippetArg, SnippetEmitter } from '@workos/oagen';
+import { collectSnippetArgs, collectWrapperArgs, toSnakeCase } from '@workos/oagen';
+import { fieldName, safeParamName } from '../python/naming.js';
+
+const INDENT = '    ';
+
+export const pythonSnippetEmitter: SnippetEmitter = {
+  language: 'python',
+  fileExtension: 'py',
+
+  renderOperation(resolved, ctx, examples) {
+    if (resolved.urlBuilder) return null;
+
+    const accessor = toSnakeCase(resolved.mountOn);
+
+    if (resolved.wrappers && resolved.wrappers.length > 0) {
+      const wrapper = resolved.wrappers[0]!;
+      const args = collectWrapperArgs(wrapper, ctx, examples);
+      return renderCall(accessor, wrapper.name, toPyArgs(args, new Set()));
+    }
+
+    const { args, collisionNames } = collectSnippetArgs(resolved, ctx, examples);
+    return renderCall(accessor, resolved.methodName, toPyArgs(args, collisionNames));
+  },
+};
+
+interface PyArg {
+  keyword: string;
+  value: string;
+}
+
+function toPyArgs(args: SnippetArg[], collisionNames: Set<string>): PyArg[] {
+  const seen = new Set<string>();
+  const out: PyArg[] = [];
+  for (const a of args) {
+    const keyword = pythonKeyword(a, collisionNames);
+    if (seen.has(keyword)) continue;
+    seen.add(keyword);
+    out.push({ keyword, value: renderValue(a.value) });
+  }
+  return out;
+}
+
+function pythonKeyword(arg: SnippetArg, collisions: Set<string>): string {
+  if (arg.source === 'body') {
+    const base = fieldName(arg.wireName);
+    return collisions.has(arg.wireName) ? `body_${base}` : base;
+  }
+  return safeParamName(arg.wireName);
+}
+
+function renderCall(accessor: string, method: string, args: PyArg[]): string {
+  const lines: string[] = [];
+  lines.push('from workos import WorkOSClient');
+  lines.push('');
+  lines.push('client = WorkOSClient(api_key="sk_example_123456789", client_id="client_123456789")');
+  lines.push('');
+
+  const target = `client.${accessor}.${method}`;
+  if (args.length === 0) {
+    lines.push(`${target}()`);
+    return lines.join('\n');
+  }
+
+  if (args.length === 1 && !args[0]!.value.includes('\n')) {
+    const a = args[0]!;
+    lines.push(`${target}(${a.keyword}=${a.value})`);
+    return lines.join('\n');
+  }
+
+  lines.push(`${target}(`);
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i]!;
+    const trailing = i < args.length - 1 ? ',' : '';
+    const valueIndented = indentContinuationLines(a.value, INDENT);
+    lines.push(`${INDENT}${a.keyword}=${valueIndented}${trailing}`);
+  }
+  lines.push(')');
+  return lines.join('\n');
+}
+
+// ---------------------------------------------------------------------------
+// Python literal rendering
+// ---------------------------------------------------------------------------
+
+function renderValue(value: unknown): string {
+  if (value === null || value === undefined) return 'None';
+  if (typeof value === 'boolean') return value ? 'True' : 'False';
+  if (typeof value === 'number') return String(value);
+  if (typeof value === 'string') return pythonString(value);
+  if (Array.isArray(value)) return renderArray(value);
+  if (typeof value === 'object') return renderDict(value as Record<string, unknown>);
+  return 'None';
+}
+
+function pythonString(s: string): string {
+  return `"${s.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+}
+
+function renderArray(items: unknown[]): string {
+  if (items.length === 0) return '[]';
+  const rendered = items.map((v) => renderValue(v));
+  const oneline = `[${rendered.join(', ')}]`;
+  if (oneline.length <= 80 && rendered.every((r) => !r.includes('\n'))) return oneline;
+  const lines: string[] = ['['];
+  for (let i = 0; i < rendered.length; i++) {
+    const trailing = i < rendered.length - 1 ? ',' : '';
+    lines.push(`${INDENT}${indentContinuationLines(rendered[i]!, INDENT)}${trailing}`);
+  }
+  lines.push(']');
+  return lines.join('\n');
+}
+
+function renderDict(obj: Record<string, unknown>): string {
+  const entries = Object.entries(obj);
+  if (entries.length === 0) return '{}';
+  const rendered = entries.map(([k, v]) => ({ key: k, value: renderValue(v) }));
+  const oneline = `{${rendered.map((e) => `"${e.key}": ${e.value}`).join(', ')}}`;
+  if (oneline.length <= 80 && rendered.every((e) => !e.value.includes('\n'))) return oneline;
+
+  const lines: string[] = ['{'];
+  for (let i = 0; i < rendered.length; i++) {
+    const e = rendered[i]!;
+    const trailing = i < rendered.length - 1 ? ',' : '';
+    lines.push(`${INDENT}"${e.key}": ${indentContinuationLines(e.value, INDENT)}${trailing}`);
+  }
+  lines.push('}');
+  return lines.join('\n');
+}
+
+function indentContinuationLines(s: string, indent: string): string {
+  if (!s.includes('\n')) return s;
+  const lines = s.split('\n');
+  return lines.map((line, i) => (i === 0 ? line : `${indent}${line}`)).join('\n');
+}

package/src/snippets/ruby.ts

@@ -0,0 +1,152 @@
+import type { EmitterContext, SnippetArg, SnippetEmitter } from '@workos/oagen';
+import { collectSnippetArgs, collectWrapperArgs, toSnakeCase } from '@workos/oagen';
+import { buildExportedClassNameSet, fieldName, resolveServiceTarget, safeParamName } from '../ruby/naming.js';
+
+const INDENT = '  ';
+
+export const rubySnippetEmitter: SnippetEmitter = {
+  language: 'ruby',
+  fileExtension: 'rb',
+
+  renderOperation(resolved, ctx, examples) {
+    if (resolved.urlBuilder) return null;
+
+    const accessor = serviceAccessor(resolved.mountOn, ctx);
+
+    if (resolved.wrappers && resolved.wrappers.length > 0) {
+      const wrapper = resolved.wrappers[0]!;
+      const args = collectWrapperArgs(wrapper, ctx, examples);
+      return renderCall(accessor, wrapper.name, toRubyArgs(args, new Set()));
+    }
+
+    const { args, collisionNames } = collectSnippetArgs(resolved, ctx, examples);
+    return renderCall(accessor, resolved.methodName, toRubyArgs(args, collisionNames));
+  },
+};
+
+interface RubyArg {
+  keyword: string;
+  value: string;
+}
+
+function toRubyArgs(args: SnippetArg[], collisionNames: Set<string>): RubyArg[] {
+  const seen = new Set<string>();
+  const out: RubyArg[] = [];
+  for (const a of args) {
+    const keyword = rubyKeyword(a, collisionNames);
+    if (seen.has(keyword)) continue;
+    seen.add(keyword);
+    out.push({ keyword, value: renderValue(a.value) });
+  }
+  return out;
+}
+
+function rubyKeyword(arg: SnippetArg, collisions: Set<string>): string {
+  if (arg.source === 'body') {
+    const base = fieldName(arg.wireName);
+    return collisions.has(arg.wireName) ? `body_${base}` : base;
+  }
+  // path / query
+  return safeParamName(arg.wireName);
+}
+
+function renderCall(accessor: string, method: string, args: RubyArg[]): string {
+  const lines: string[] = [];
+  lines.push('require "workos"');
+  lines.push('');
+  lines.push('WorkOS.configure do |config|');
+  lines.push(`${INDENT}config.api_key = "sk_example_123456789"`);
+  lines.push('end');
+  lines.push('');
+
+  const target = `WorkOS.client.${accessor}.${method}`;
+  if (args.length === 0) {
+    lines.push(target);
+    return lines.join('\n');
+  }
+
+  if (args.length === 1 && !args[0]!.value.includes('\n')) {
+    const a = args[0]!;
+    lines.push(`${target}(${a.keyword}: ${a.value})`);
+    return lines.join('\n');
+  }
+
+  lines.push(`${target}(`);
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i]!;
+    const trailing = i < args.length - 1 ? ',' : '';
+    const valueIndented = indentContinuationLines(a.value, INDENT);
+    lines.push(`${INDENT}${a.keyword}: ${valueIndented}${trailing}`);
+  }
+  lines.push(')');
+
+  return lines.join('\n');
+}
+
+function serviceAccessor(mountOn: string, ctx: EmitterContext): string {
+  // The accessor uses the raw mount target (no `Service` suffix) to match
+  // the `client.organization_membership` style documented in workos-ruby.
+  void resolveServiceTarget(mountOn, buildExportedClassNameSet(ctx));
+  return toSnakeCase(mountOn);
+}
+
+// ---------------------------------------------------------------------------
+// Ruby literal rendering
+// ---------------------------------------------------------------------------
+
+function renderValue(value: unknown): string {
+  if (value === null || value === undefined) return 'nil';
+  if (typeof value === 'boolean') return value ? 'true' : 'false';
+  if (typeof value === 'number') return String(value);
+  if (typeof value === 'string') return rubyString(value);
+  if (Array.isArray(value)) return renderArray(value);
+  if (typeof value === 'object') return renderHash(value as Record<string, unknown>);
+  return 'nil';
+}
+
+function rubyString(s: string): string {
+  return `"${s.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+}
+
+function renderArray(items: unknown[]): string {
+  if (items.length === 0) return '[]';
+  const rendered = items.map((v) => renderValue(v));
+  const oneline = `[${rendered.join(', ')}]`;
+  if (oneline.length <= 80 && rendered.every((r) => !r.includes('\n'))) return oneline;
+  const lines: string[] = ['['];
+  for (let i = 0; i < rendered.length; i++) {
+    const trailing = i < rendered.length - 1 ? ',' : '';
+    lines.push(`${INDENT}${indentContinuationLines(rendered[i]!, INDENT)}${trailing}`);
+  }
+  lines.push(']');
+  return lines.join('\n');
+}
+
+function renderHash(obj: Record<string, unknown>): string {
+  const entries = Object.entries(obj);
+  if (entries.length === 0) return '{}';
+  const rendered = entries.map(([k, v]) => ({ key: k, value: renderValue(v) }));
+  const oneLineParts = rendered.map((e) => `${formatInlineKey(e.key)} ${e.value}`);
+  const oneline = `{ ${oneLineParts.join(', ')} }`;
+  if (oneline.length <= 80 && rendered.every((e) => !e.value.includes('\n'))) return oneline;
+
+  const lines: string[] = ['{'];
+  for (let i = 0; i < rendered.length; i++) {
+    const e = rendered[i]!;
+    const trailing = i < rendered.length - 1 ? ',' : '';
+    lines.push(`${INDENT}${formatInlineKey(e.key)} ${indentContinuationLines(e.value, INDENT)}${trailing}`);
+  }
+  lines.push('}');
+  return lines.join('\n');
+}
+
+function formatInlineKey(name: string): string {
+  if (/^[a-z_][a-zA-Z0-9_]*$/.test(name)) return `${name}:`;
+  return `"${name.replace(/"/g, '\\"')}" =>`;
+}
+
+function indentContinuationLines(s: string, indent: string): string {
+  if (!s.includes('\n')) return s;
+  const lines = s.split('\n');
+  return lines.map((line, i) => (i === 0 ? line : `${indent}${line}`)).join('\n');
+}