tywrap 0.5.1 → 0.6.1

package/dist/core/emit-call.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Shared call-emission helpers for the TypeScript wrapper generator.
+ *
+ * The function, method, and constructor wrappers all emit the same runtime
+ * prelude (assemble `__args`, fold a trailing object into `__kwargs`, unpack
+ * `*args`) and the same argument guards (reject positional-only-as-keyword,
+ * require keyword-only arguments). They differ only by indentation, the error
+ * label used in thrown messages, and the terminal RPC verb (which the call
+ * sites still emit themselves).
+ *
+ * The emitted strings MUST stay byte-identical to the previous inline copies.
+ */
+import type { Parameter } from '../types/index.js';
+/** Describes one call site for prelude/guard emission. */
+export interface CallDescriptor {
+    /** Positional parameters (no *args/**kwargs/keyword-only). */
+    positionalParams: readonly Parameter[];
+    /** The `*args` parameter, if any. */
+    varArgsParam?: Parameter;
+    /** Whether `*args` is modeled as an array param (true when kwargs coexist). */
+    needsVarArgsArray: boolean;
+    /** Whether the wrapper takes a `kwargs` parameter. */
+    hasKwArgs: boolean;
+    /** Whether the callee declares `**kwargs`. */
+    hasVarKwArgs: boolean;
+    /** Names of keyword-only parameters. */
+    keywordOnlyNames: readonly string[];
+    /** Names of required keyword-only parameters. */
+    requiredKwOnlyNames: readonly string[];
+    /** Names of positional-only parameters. */
+    positionalOnlyNames: readonly string[];
+    /** Number of leading required positional parameters. */
+    requiredPosCount: number;
+    /** Base indentation (e.g. '  ' for functions, '    ' for methods/ctors). */
+    indent: string;
+    /** Error label used in thrown messages (function/method name or '__init__'). */
+    errorLabel: string;
+}
+/** Helpers wired from the generator instance (they depend on `this`). */
+export interface CallEmitHelpers {
+    escapeIdentifier(name: string): string;
+    renderLooksLikeKwargsExpr(valueExpr: string, options: {
+        keywordOnlyNames: string[];
+        requiredKwOnlyNames: string[];
+        hasVarKwArgs: boolean;
+    }): string;
+}
+/**
+ * Emit the runtime prelude lines that build the `__args` array, fold a trailing
+ * plain object into `__kwargs`, and unpack `*args`.
+ */
+export declare function emitCallPrelude(desc: CallDescriptor, helpers: CallEmitHelpers): string[];
+/**
+ * Emit the argument guard lines that reject positional-only arguments passed as
+ * keywords and enforce required keyword-only arguments.
+ */
+export declare function emitArgGuards(desc: CallDescriptor): string[];
+//# sourceMappingURL=emit-call.d.ts.map

package/dist/core/emit-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-call.d.ts","sourceRoot":"","sources":["../../src/core/emit-call.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,gBAAgB,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,qCAAqC;IACrC,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,+EAA+E;IAC/E,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sDAAsD;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,YAAY,EAAE,OAAO,CAAC;IACtB,wCAAwC;IACxC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,iDAAiD;IACjD,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,2CAA2C;IAC3C,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,wDAAwD;IACxD,gBAAgB,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACvC,yBAAyB,CACvB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;QACP,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,mBAAmB,EAAE,MAAM,EAAE,CAAC;QAC9B,YAAY,EAAE,OAAO,CAAC;KACvB,GACA,MAAM,CAAC;CACX;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,EAAE,CAqExF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE,CAqC5D"}

package/dist/core/emit-call.js

@@ -0,0 +1,103 @@
+/**
+ * Shared call-emission helpers for the TypeScript wrapper generator.
+ *
+ * The function, method, and constructor wrappers all emit the same runtime
+ * prelude (assemble `__args`, fold a trailing object into `__kwargs`, unpack
+ * `*args`) and the same argument guards (reject positional-only-as-keyword,
+ * require keyword-only arguments). They differ only by indentation, the error
+ * label used in thrown messages, and the terminal RPC verb (which the call
+ * sites still emit themselves).
+ *
+ * The emitted strings MUST stay byte-identical to the previous inline copies.
+ */
+/**
+ * Emit the runtime prelude lines that build the `__args` array, fold a trailing
+ * plain object into `__kwargs`, and unpack `*args`.
+ */
+export function emitCallPrelude(desc, helpers) {
+    const { positionalParams, varArgsParam, needsVarArgsArray, hasKwArgs, hasVarKwArgs, keywordOnlyNames, requiredKwOnlyNames, requiredPosCount, indent: i, errorLabel, } = desc;
+    const i2 = `${i}  `;
+    const i3 = `${i2}  `;
+    const lines = [];
+    if (hasKwArgs) {
+        lines.push(`${i}let __kwargs = kwargs;`);
+    }
+    const positionalArgExprs = positionalParams.map(p => helpers.escapeIdentifier(p.name));
+    lines.push(`${i}const __args: unknown[] = [${positionalArgExprs.join(', ')}];`);
+    if (requiredPosCount < positionalParams.length) {
+        lines.push(`${i}while (__args.length > ${requiredPosCount} && __args[__args.length - 1] === undefined) {`);
+        lines.push(`${i2}__args.pop();`);
+        lines.push(`${i}}`);
+    }
+    if (hasKwArgs && requiredPosCount < positionalParams.length) {
+        const looksLikeKwargs = helpers.renderLooksLikeKwargsExpr('__candidate', {
+            keywordOnlyNames: [...keywordOnlyNames],
+            requiredKwOnlyNames: [...requiredKwOnlyNames],
+            hasVarKwArgs,
+        });
+        lines.push(`${i}if (__kwargs === undefined && __args.length > ${requiredPosCount}) {`);
+        lines.push(`${i2}const __candidate = __args[__args.length - 1];`);
+        lines.push(`${i2}if (${looksLikeKwargs}) {`);
+        lines.push(`${i3}__kwargs = __candidate as any;`);
+        lines.push(`${i3}__args.pop();`);
+        lines.push(`${i2}}`);
+        lines.push(`${i}}`);
+    }
+    if (varArgsParam) {
+        const vname = helpers.escapeIdentifier(varArgsParam.name);
+        if (needsVarArgsArray) {
+            const looksLikeKwargs = helpers.renderLooksLikeKwargsExpr(vname, {
+                keywordOnlyNames: [...keywordOnlyNames],
+                requiredKwOnlyNames: [...requiredKwOnlyNames],
+                hasVarKwArgs,
+            });
+            lines.push(`${i}let __varargs: unknown[] = [];`);
+            lines.push(`${i}if (${vname} !== undefined) {`);
+            lines.push(`${i2}if (globalThis.Array.isArray(${vname})) {`);
+            lines.push(`${i3}__varargs = ${vname};`);
+            lines.push(`${i2}} else if (__kwargs === undefined && ${looksLikeKwargs}) {`);
+            lines.push(`${i3}__kwargs = ${vname} as any;`);
+            lines.push(`${i2}} else {`);
+            lines.push(`${i3}throw new Error(\`${errorLabel} expected ${varArgsParam.name} to be an array\`);`);
+            lines.push(`${i2}}`);
+            lines.push(`${i}}`);
+            lines.push(`${i}__args.push(...__varargs);`);
+        }
+        else {
+            lines.push(`${i}__args.push(...${vname});`);
+        }
+    }
+    return lines;
+}
+/**
+ * Emit the argument guard lines that reject positional-only arguments passed as
+ * keywords and enforce required keyword-only arguments.
+ */
+export function emitArgGuards(desc) {
+    const { hasKwArgs, positionalOnlyNames, requiredKwOnlyNames, indent: i, errorLabel, } = desc;
+    const i2 = `${i}  `;
+    const i3 = `${i2}  `;
+    const lines = [];
+    if (hasKwArgs && positionalOnlyNames.length > 0) {
+        lines.push(`${i}const __positionalOnly = ${JSON.stringify(positionalOnlyNames)} as const;`);
+        lines.push(`${i}for (const key of __positionalOnly) {`);
+        lines.push(`${i2}if (__kwargs && Object.prototype.hasOwnProperty.call(__kwargs, key)) {`);
+        lines.push(`${i3}throw new Error(\`${errorLabel} does not accept positional-only argument "\${key}" as a keyword argument\`);`);
+        lines.push(`${i2}}`);
+        lines.push(`${i}}`);
+    }
+    if (hasKwArgs && requiredKwOnlyNames.length > 0) {
+        lines.push(`${i}const __requiredKwOnly = ${JSON.stringify(requiredKwOnlyNames)} as const;`);
+        lines.push(`${i}const __missing: string[] = [];`);
+        lines.push(`${i}for (const key of __requiredKwOnly) {`);
+        lines.push(`${i2}if (!__kwargs || !Object.prototype.hasOwnProperty.call(__kwargs, key)) {`);
+        lines.push(`${i3}__missing.push(key);`);
+        lines.push(`${i2}}`);
+        lines.push(`${i}}`);
+        lines.push(`${i}if (__missing.length > 0) {`);
+        lines.push(`${i2}throw new Error(\`Missing required keyword-only arguments for ${errorLabel}: \${__missing.join(', ')}\`);`);
+        lines.push(`${i}}`);
+    }
+    return lines;
+}
+//# sourceMappingURL=emit-call.js.map

package/dist/core/emit-call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-call.js","sourceRoot":"","sources":["../../src/core/emit-call.ts"],"names":[],"mappings":"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"}

package/dist/core/generator.d.ts

@@ -26,6 +26,8 @@ export declare class CodeGenerator {
     private sanitizeType;
     private typeToTsFromPython;
     private renderLooksLikeKwargsExpr;
+    /** Helpers passed to the shared call-emission module (they depend on `this`). */
+    private callEmitHelpers;
     generateFunctionWrapper(func: PythonFunction, moduleName?: string, annotatedJSDoc?: boolean): GeneratedCode;
     generateClassWrapper(cls: PythonClass, moduleName?: string, _annotatedJSDoc?: boolean): GeneratedCode;
     generateTypeAlias(alias: PythonTypeAlias, moduleName?: string): GeneratedCode;

package/dist/core/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/core/generator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAEV,cAAc,EACd,WAAW,EACX,YAAY,EAEZ,eAAe,EACf,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAezC,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CA2BnC;gBAES,MAAM,GAAE,UAA6B;IAIjD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,yBAAyB;IAyCjC,OAAO,CAAC,0BAA0B;IAalC,OAAO,CAAC,yBAAyB;IAuCjC,OAAO,CAAC,YAAY;IAyEpB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,yBAAyB;IA+BjC,uBAAuB,CACrB,IAAI,EAAE,cAAc,EACpB,UAAU,CAAC,EAAE,MAAM,EACnB,cAAc,UAAQ,GACrB,aAAa;IAmQhB,oBAAoB,CAClB,GAAG,EAAE,WAAW,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,eAAe,UAAQ,GACtB,aAAa;IAwgBhB,iBAAiB,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa;IAY7E;;OAEG;IACG,cAAc,CAClB,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAE3E,GACA,OAAO,CAAC,aAAa,CAAC;IAiBzB,wBAAwB,CAAC,MAAM,EAAE,YAAY,EAAE,cAAc,UAAQ,GAAG,aAAa;IAiCrF,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,IAAI;IAcZ,OAAO,CAAC,QAAQ;CAgEjB"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/core/generator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAEV,cAAc,EACd,WAAW,EACX,YAAY,EAEZ,eAAe,EACf,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAS3B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAezC,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CA2BnC;gBAES,MAAM,GAAE,UAA6B;IAIjD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,yBAAyB;IAyCjC,OAAO,CAAC,0BAA0B;IAalC,OAAO,CAAC,yBAAyB;IAuCjC,OAAO,CAAC,YAAY;IAyEpB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,yBAAyB;IA+BjC,iFAAiF;IACjF,OAAO,CAAC,eAAe;IAcvB,uBAAuB,CACrB,IAAI,EAAE,cAAc,EACpB,UAAU,CAAC,EAAE,MAAM,EACnB,cAAc,UAAQ,GACrB,aAAa;IA6LhB,oBAAoB,CAClB,GAAG,EAAE,WAAW,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,eAAe,UAAQ,GACtB,aAAa;IAqXhB,iBAAiB,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa;IAY7E;;OAEG;IACG,cAAc,CAClB,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAE3E,GACA,OAAO,CAAC,aAAa,CAAC;IAiBzB,wBAAwB,CAAC,MAAM,EAAE,YAAY,EAAE,cAAc,UAAQ,GAAG,aAAa;IAiCrF,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,IAAI;IAcZ,OAAO,CAAC,QAAQ;CAgEjB"}

package/dist/core/generator.js

@@ -2,6 +2,7 @@
  * CodeGenerator - TypeScript wrapper generation
  */
 import { globalCache } from '../utils/cache.js';
+import { emitArgGuards, emitCallPrelude, } from './emit-call.js';
 import { TypeMapper } from './mapper.js';
 export class CodeGenerator {
     mapper;
@@ -262,6 +263,13 @@ export class CodeGenerator {
         })();
         return `(${base} && (${keyCheck}))`;
     }
+    /** Helpers passed to the shared call-emission module (they depend on `this`). */
+    callEmitHelpers() {
+        return {
+            escapeIdentifier: (name) => this.escapeIdentifier(name),
+            renderLooksLikeKwargsExpr: (valueExpr, options) => this.renderLooksLikeKwargsExpr(valueExpr, options),
+        };
+    }
     generateFunctionWrapper(func, moduleName, annotatedJSDoc = false) {
         const jsdoc = this.generateJsDoc(func.docstring, annotatedJSDoc ? func.parameters.map(p => String(p.type)) : undefined);
         const filteredParams = func.parameters.filter(p => p.name !== 'self' && p.name !== 'cls');
@@ -386,79 +394,24 @@ export class CodeGenerator {
             }
         }
         const overloadDecl = overloads.length > 0 ? `${overloads.join('\n')}\n` : '';
-        const guardLines = [];
-        if (hasKwArgs && positionalOnlyNames.length > 0) {
-            guardLines.push(`  const __positionalOnly = ${JSON.stringify(positionalOnlyNames)} as const;`);
-            guardLines.push(`  for (const key of __positionalOnly) {`);
-            guardLines.push(`    if (__kwargs && Object.prototype.hasOwnProperty.call(__kwargs, key)) {`);
-            guardLines.push(`      throw new Error(\`${func.name} does not accept positional-only argument "\${key}" as a keyword argument\`);`);
-            guardLines.push(`    }`);
-            guardLines.push(`  }`);
-        }
-        if (hasKwArgs && requiredKwOnlyNames.length > 0) {
-            guardLines.push(`  const __requiredKwOnly = ${JSON.stringify(requiredKwOnlyNames)} as const;`);
-            guardLines.push(`  const __missing: string[] = [];`);
-            guardLines.push(`  for (const key of __requiredKwOnly) {`);
-            guardLines.push(`    if (!__kwargs || !Object.prototype.hasOwnProperty.call(__kwargs, key)) {`);
-            guardLines.push(`      __missing.push(key);`);
-            guardLines.push(`    }`);
-            guardLines.push(`  }`);
-            guardLines.push(`  if (__missing.length > 0) {`);
-            guardLines.push(`    throw new Error(\`Missing required keyword-only arguments for ${func.name}: \${__missing.join(', ')}\`);`);
-            guardLines.push(`  }`);
-        }
-        const guards = guardLines.length > 0 ? `${guardLines.join('\n')}\n` : '';
         const firstOptionalPosIndex = positionalParams.findIndex(p => p.optional);
         const requiredPosCount = firstOptionalPosIndex >= 0 ? firstOptionalPosIndex : positionalParams.length;
-        const callPreludeLines = [];
-        if (hasKwArgs) {
-            callPreludeLines.push(`  let __kwargs = kwargs;`);
-        }
-        const positionalArgExprs = positionalParams.map(p => this.escapeIdentifier(p.name));
-        callPreludeLines.push(`  const __args: unknown[] = [${positionalArgExprs.join(', ')}];`);
-        if (requiredPosCount < positionalParams.length) {
-            callPreludeLines.push(`  while (__args.length > ${requiredPosCount} && __args[__args.length - 1] === undefined) {`);
-            callPreludeLines.push(`    __args.pop();`);
-            callPreludeLines.push(`  }`);
-        }
-        if (hasKwArgs && requiredPosCount < positionalParams.length) {
-            const looksLikeKwargs = this.renderLooksLikeKwargsExpr('__candidate', {
-                keywordOnlyNames,
-                requiredKwOnlyNames,
-                hasVarKwArgs,
-            });
-            callPreludeLines.push(`  if (__kwargs === undefined && __args.length > ${requiredPosCount}) {`);
-            callPreludeLines.push(`    const __candidate = __args[__args.length - 1];`);
-            callPreludeLines.push(`    if (${looksLikeKwargs}) {`);
-            callPreludeLines.push(`      __kwargs = __candidate as any;`);
-            callPreludeLines.push(`      __args.pop();`);
-            callPreludeLines.push(`    }`);
-            callPreludeLines.push(`  }`);
-        }
-        if (varArgsParam) {
-            const vname = this.escapeIdentifier(varArgsParam.name);
-            if (needsVarArgsArray) {
-                const looksLikeKwargs = this.renderLooksLikeKwargsExpr(vname, {
-                    keywordOnlyNames,
-                    requiredKwOnlyNames,
-                    hasVarKwArgs,
-                });
-                callPreludeLines.push(`  let __varargs: unknown[] = [];`);
-                callPreludeLines.push(`  if (${vname} !== undefined) {`);
-                callPreludeLines.push(`    if (globalThis.Array.isArray(${vname})) {`);
-                callPreludeLines.push(`      __varargs = ${vname};`);
-                callPreludeLines.push(`    } else if (__kwargs === undefined && ${looksLikeKwargs}) {`);
-                callPreludeLines.push(`      __kwargs = ${vname} as any;`);
-                callPreludeLines.push(`    } else {`);
-                callPreludeLines.push(`      throw new Error(\`${func.name} expected ${varArgsParam.name} to be an array\`);`);
-                callPreludeLines.push(`    }`);
-                callPreludeLines.push(`  }`);
-                callPreludeLines.push(`  __args.push(...__varargs);`);
-            }
-            else {
-                callPreludeLines.push(`  __args.push(...${vname});`);
-            }
-        }
+        const callDescriptor = {
+            positionalParams,
+            varArgsParam,
+            needsVarArgsArray,
+            hasKwArgs,
+            hasVarKwArgs,
+            keywordOnlyNames,
+            requiredKwOnlyNames,
+            positionalOnlyNames,
+            requiredPosCount,
+            indent: '  ',
+            errorLabel: func.name,
+        };
+        const guardLines = emitArgGuards(callDescriptor);
+        const guards = guardLines.length > 0 ? `${guardLines.join('\n')}\n` : '';
+        const callPreludeLines = emitCallPrelude(callDescriptor, this.callEmitHelpers());
         const callPrelude = callPreludeLines.length > 0 ? `${callPreludeLines.join('\n')}\n` : '';
         const ts = `${jsdoc}${overloadDecl}export async function ${fname}${typeParamDecl}(${paramDecl}): Promise<${returnType}> {
 ${callPrelude}${guards}  return getRuntimeBridge().call('${moduleId}', '${func.name}', __args${hasKwArgs ? ', __kwargs' : ''});
@@ -605,77 +558,22 @@ ${callPrelude}${guards}  return getRuntimeBridge().call('${moduleId}', '${func.n
                 }
             }
             const overloadDecl = overloads.length > 0 ? `${overloads.join('\n')}\n` : '';
-            const callPreludeLines = [];
-            if (needsKwargsParam) {
-                callPreludeLines.push(`    let __kwargs = kwargs;`);
-            }
-            const positionalArgExprs = positionalParams.map(p => this.escapeIdentifier(p.name));
-            callPreludeLines.push(`    const __args: unknown[] = [${positionalArgExprs.join(', ')}];`);
-            if (requiredPosCount < positionalParams.length) {
-                callPreludeLines.push(`    while (__args.length > ${requiredPosCount} && __args[__args.length - 1] === undefined) {`);
-                callPreludeLines.push(`      __args.pop();`);
-                callPreludeLines.push(`    }`);
-            }
-            if (needsKwargsParam && requiredPosCount < positionalParams.length) {
-                const looksLikeKwargs = this.renderLooksLikeKwargsExpr('__candidate', {
-                    keywordOnlyNames,
-                    requiredKwOnlyNames,
-                    hasVarKwArgs,
-                });
-                callPreludeLines.push(`    if (__kwargs === undefined && __args.length > ${requiredPosCount}) {`);
-                callPreludeLines.push(`      const __candidate = __args[__args.length - 1];`);
-                callPreludeLines.push(`      if (${looksLikeKwargs}) {`);
-                callPreludeLines.push(`        __kwargs = __candidate as any;`);
-                callPreludeLines.push(`        __args.pop();`);
-                callPreludeLines.push(`      }`);
-                callPreludeLines.push(`    }`);
-            }
-            if (varArgsParam) {
-                const vname = this.escapeIdentifier(varArgsParam.name);
-                if (needsVarArgsArray) {
-                    const looksLikeKwargs = this.renderLooksLikeKwargsExpr(vname, {
-                        keywordOnlyNames,
-                        requiredKwOnlyNames,
-                        hasVarKwArgs,
-                    });
-                    callPreludeLines.push(`    let __varargs: unknown[] = [];`);
-                    callPreludeLines.push(`    if (${vname} !== undefined) {`);
-                    callPreludeLines.push(`      if (globalThis.Array.isArray(${vname})) {`);
-                    callPreludeLines.push(`        __varargs = ${vname};`);
-                    callPreludeLines.push(`      } else if (__kwargs === undefined && ${looksLikeKwargs}) {`);
-                    callPreludeLines.push(`        __kwargs = ${vname} as any;`);
-                    callPreludeLines.push(`      } else {`);
-                    callPreludeLines.push(`        throw new Error(\`${method.name} expected ${varArgsParam.name} to be an array\`);`);
-                    callPreludeLines.push(`      }`);
-                    callPreludeLines.push(`    }`);
-                    callPreludeLines.push(`    __args.push(...__varargs);`);
-                }
-                else {
-                    callPreludeLines.push(`    __args.push(...${vname});`);
-                }
-            }
+            const callDescriptor = {
+                positionalParams,
+                varArgsParam,
+                needsVarArgsArray,
+                hasKwArgs: needsKwargsParam,
+                hasVarKwArgs,
+                keywordOnlyNames,
+                requiredKwOnlyNames,
+                positionalOnlyNames,
+                requiredPosCount,
+                indent: '    ',
+                errorLabel: method.name,
+            };
+            const callPreludeLines = emitCallPrelude(callDescriptor, this.callEmitHelpers());
             const callPrelude = callPreludeLines.length > 0 ? `${callPreludeLines.join('\n')}\n` : '';
-            const guardLines = [];
-            if (needsKwargsParam && positionalOnlyNames.length > 0) {
-                guardLines.push(`    const __positionalOnly = ${JSON.stringify(positionalOnlyNames)} as const;`);
-                guardLines.push(`    for (const key of __positionalOnly) {`);
-                guardLines.push(`      if (__kwargs && Object.prototype.hasOwnProperty.call(__kwargs, key)) {`);
-                guardLines.push(`        throw new Error(\`${method.name} does not accept positional-only argument "\${key}" as a keyword argument\`);`);
-                guardLines.push(`      }`);
-                guardLines.push(`    }`);
-            }
-            if (needsKwargsParam && requiredKwOnlyNames.length > 0) {
-                guardLines.push(`    const __requiredKwOnly = ${JSON.stringify(requiredKwOnlyNames)} as const;`);
-                guardLines.push(`    const __missing: string[] = [];`);
-                guardLines.push(`    for (const key of __requiredKwOnly) {`);
-                guardLines.push(`      if (!__kwargs || !Object.prototype.hasOwnProperty.call(__kwargs, key)) {`);
-                guardLines.push(`        __missing.push(key);`);
-                guardLines.push(`      }`);
-                guardLines.push(`    }`);
-                guardLines.push(`    if (__missing.length > 0) {`);
-                guardLines.push(`      throw new Error(\`Missing required keyword-only arguments for ${method.name}: \${__missing.join(', ')}\`);`);
-                guardLines.push(`    }`);
-            }
+            const guardLines = emitArgGuards(callDescriptor);
             const guards = guardLines.length > 0 ? `${guardLines.join('\n')}\n` : '';
             methodBodies.push(`${overloadDecl}  async ${mname}${methodTypeParamDecl}(${paramsDecl}): Promise<${returnType}> {
 ${callPrelude}${guards}    return getRuntimeBridge().callMethod(this.__handle, '${method.name}', __args${needsKwargsParam ? ', __kwargs' : ''});
@@ -758,77 +656,22 @@ ${callPrelude}${guards}    return getRuntimeBridge().callMethod(this.__handle, '
             const declaration = overloads.length > 0
                 ? overloadDecl
                 : `  static create${classTypeParamDecl}(${paramsDecl}): Promise<${classSelfType}>;\n`;
-            const guardLines = [];
-            const callPreludeLines = [];
-            if (needsKwargsParam) {
-                callPreludeLines.push(`    let __kwargs = kwargs;`);
-            }
-            const positionalArgExprs = positionalParams.map(p => this.escapeIdentifier(p.name));
-            callPreludeLines.push(`    const __args: unknown[] = [${positionalArgExprs.join(', ')}];`);
-            if (requiredPosCount < positionalParams.length) {
-                callPreludeLines.push(`    while (__args.length > ${requiredPosCount} && __args[__args.length - 1] === undefined) {`);
-                callPreludeLines.push(`      __args.pop();`);
-                callPreludeLines.push(`    }`);
-            }
-            if (needsKwargsParam && requiredPosCount < positionalParams.length) {
-                const looksLikeKwargs = this.renderLooksLikeKwargsExpr('__candidate', {
-                    keywordOnlyNames,
-                    requiredKwOnlyNames,
-                    hasVarKwArgs,
-                });
-                callPreludeLines.push(`    if (__kwargs === undefined && __args.length > ${requiredPosCount}) {`);
-                callPreludeLines.push(`      const __candidate = __args[__args.length - 1];`);
-                callPreludeLines.push(`      if (${looksLikeKwargs}) {`);
-                callPreludeLines.push(`        __kwargs = __candidate as any;`);
-                callPreludeLines.push(`        __args.pop();`);
-                callPreludeLines.push(`      }`);
-                callPreludeLines.push(`    }`);
-            }
-            if (varArgsParam) {
-                const vname = this.escapeIdentifier(varArgsParam.name);
-                if (needsVarArgsArray) {
-                    const looksLikeKwargs = this.renderLooksLikeKwargsExpr(vname, {
-                        keywordOnlyNames,
-                        requiredKwOnlyNames,
-                        hasVarKwArgs,
-                    });
-                    callPreludeLines.push(`    let __varargs: unknown[] = [];`);
-                    callPreludeLines.push(`    if (${vname} !== undefined) {`);
-                    callPreludeLines.push(`      if (globalThis.Array.isArray(${vname})) {`);
-                    callPreludeLines.push(`        __varargs = ${vname};`);
-                    callPreludeLines.push(`      } else if (__kwargs === undefined && ${looksLikeKwargs}) {`);
-                    callPreludeLines.push(`        __kwargs = ${vname} as any;`);
-                    callPreludeLines.push(`      } else {`);
-                    callPreludeLines.push(`        throw new Error(\`__init__ expected ${varArgsParam.name} to be an array\`);`);
-                    callPreludeLines.push(`      }`);
-                    callPreludeLines.push(`    }`);
-                    callPreludeLines.push(`    __args.push(...__varargs);`);
-                }
-                else {
-                    callPreludeLines.push(`    __args.push(...${vname});`);
-                }
-            }
+            const callDescriptor = {
+                positionalParams,
+                varArgsParam,
+                needsVarArgsArray,
+                hasKwArgs: needsKwargsParam,
+                hasVarKwArgs,
+                keywordOnlyNames,
+                requiredKwOnlyNames,
+                positionalOnlyNames,
+                requiredPosCount,
+                indent: '    ',
+                errorLabel: '__init__',
+            };
+            const callPreludeLines = emitCallPrelude(callDescriptor, this.callEmitHelpers());
             const callPrelude = callPreludeLines.length > 0 ? `${callPreludeLines.join('\n')}\n` : '';
-            if (needsKwargsParam && positionalOnlyNames.length > 0) {
-                guardLines.push(`    const __positionalOnly = ${JSON.stringify(positionalOnlyNames)} as const;`);
-                guardLines.push(`    for (const key of __positionalOnly) {`);
-                guardLines.push(`      if (__kwargs && Object.prototype.hasOwnProperty.call(__kwargs, key)) {`);
-                guardLines.push(`        throw new Error(\`__init__ does not accept positional-only argument "\${key}" as a keyword argument\`);`);
-                guardLines.push(`      }`);
-                guardLines.push(`    }`);
-            }
-            if (needsKwargsParam && requiredKwOnlyNames.length > 0) {
-                guardLines.push(`    const __requiredKwOnly = ${JSON.stringify(requiredKwOnlyNames)} as const;`);
-                guardLines.push(`    const __missing: string[] = [];`);
-                guardLines.push(`    for (const key of __requiredKwOnly) {`);
-                guardLines.push(`      if (!__kwargs || !Object.prototype.hasOwnProperty.call(__kwargs, key)) {`);
-                guardLines.push(`        __missing.push(key);`);
-                guardLines.push(`      }`);
-                guardLines.push(`    }`);
-                guardLines.push(`    if (__missing.length > 0) {`);
-                guardLines.push(`      throw new Error(\`Missing required keyword-only arguments for __init__: \${__missing.join(', ')}\`);`);
-                guardLines.push(`    }`);
-            }
+            const guardLines = emitArgGuards(callDescriptor);
             return {
                 overloadDecl,
                 declaration,