@gtkx/codegen 0.21.0

package/dist/writers/method.js

@@ -0,0 +1,510 @@
+import { toCamelCase } from "@gtkx/utils";
+import { isCallerAllocatedOut, isInoutParameter, isOutParameter } from "../gir/parameter.js";
+import { qualifyTypeRef } from "../gir/qualify.js";
+import { arrayLengthSources, closureAndDestroyIndices, inputParameters, isCollectibleCallerOut, isHandlePassing, parameterIdentifier, returnArrayLengthIndices, } from "./param-classify.js";
+import { handleCast, wrapReturnValue } from "./return-wrap.js";
+import { renderTsType } from "./ts-type.js";
+import { isCellInout, resolveCallbackType } from "./value.js";
+/**
+ * Returns the camelCased JS export name for a callable's method or static.
+ *
+ * @param fn - The callable
+ */
+export const methodExportName = (fn) => toCamelCase(fn.name);
+/**
+ * Renders the TypeScript parameter list for a callable.
+ *
+ * Drops out-only parameters, `<varargs>` slots, and array-length
+ * parameters whose value is computed from a sibling array's `.length`.
+ * Names follow `toCamelCase` of the GIR name, falling back to
+ * `arg<index>` for unnamed positions.
+ *
+ * @param context - The module context
+ * @param fn - The callable
+ */
+export const renderMethodSignature = (context, fn) => renderInputParameters(context, fn, () => false, () => false);
+const renderInputParameters = (context, fn, skip, isOptionalExtra) => {
+    const parts = [];
+    let sawOptional = false;
+    for (const { parameter, index } of inputParameters(fn)) {
+        if (skip(parameter))
+            continue;
+        const name = parameterIdentifier(parameter, index);
+        if (parameter.optional || isOptionalExtra(parameter)) {
+            sawOptional = true;
+        }
+        const annotation = renderTsType(context, parameter.type, parameter.nullable);
+        parts.push(sawOptional ? `${name}?: ${annotation}` : `${name}: ${annotation}`);
+    }
+    return parts.join(", ");
+};
+/**
+ * Renders the TypeScript return-type annotation for a callable.
+ *
+ * Multi-out callables tuple the primary return with each out-parameter
+ * (`[primary, ...outs]`); when the primary return is void the tuple
+ * starts at the first out-parameter.
+ *
+ * @param context - The module context
+ * @param fn - The callable
+ */
+export const renderMethodReturnType = (context, fn) => {
+    const consumedByReturn = returnArrayLengthIndices(fn);
+    const outs = fn.parameters.filter((p, index) => (isOutParameter(p) ||
+        (isCallerAllocatedOut(p) && isCollectibleCallerOut(context, p)) ||
+        isInoutParameter(p)) &&
+        !consumedByReturn.has(index));
+    const primaryReturnsValue = !isVoidReturn(fn);
+    if (outs.length === 0) {
+        return primaryReturnsValue ? renderTsType(context, fn.returnValue.type, fn.returnValue.nullable) : "void";
+    }
+    const outTypes = outs.map((parameter) => renderTsType(context, parameter.type, false));
+    if (!primaryReturnsValue) {
+        return outTypes.length === 1 ? `${outTypes[0]}` : `[${outTypes.join(", ")}]`;
+    }
+    const primary = renderTsType(context, fn.returnValue.type, fn.returnValue.nullable);
+    return `[${primary}, ${outTypes.join(", ")}]`;
+};
+const isVoidReturn = (fn) => {
+    const ref = fn.returnValue.type;
+    if (ref === undefined)
+        return true;
+    return ref.kind === "primitive" && ref.category === "void";
+};
+/**
+ * Renders the JS body of a promisified `*_async` method that delegates to
+ * the runtime's `promisify` helper.
+ *
+ * The method's leading FFI args (everything before the `GCancellable*`
+ * slot) and the cancellable parameter are extracted from the GIR `*_async`
+ * signature; the trailing `GAsyncReadyCallback` slot is filled by
+ * `promisify`. The `*_finish` companion is bound from the same class via
+ * `this[finishName].bind(this)`.
+ *
+ * @param context - The module context
+ * @param asyncFn - The `*_async` callable
+ * @param finishMember - The camelCase JS name of the companion `*_finish` method
+ * @param bindingExpression - Expression that evaluates to the bound async `t.fn` callable
+ */
+export const renderPromisifiedBody = (context, asyncFn, finishMember, bindingExpression) => {
+    context.addRuntimeImport("promisify");
+    const cancellableIndex = findCancellableIndex(asyncFn.parameters);
+    const closureIndices = closureAndDestroyIndices(asyncFn);
+    const lengthFor = arrayLengthSources(asyncFn);
+    const leadingExpressions = [];
+    if (asyncFn.instance !== undefined) {
+        context.addRuntimeImport("getHandle");
+        leadingExpressions.push("getHandle(this)");
+    }
+    let cancellableExpression = "null";
+    asyncFn.parameters.forEach((parameter, index) => {
+        if (parameter.isVarargs)
+            return;
+        if (index === cancellableIndex) {
+            cancellableExpression = parameterIdentifier(parameter, index);
+            return;
+        }
+        if (isCallbackParameter(context, parameter))
+            return;
+        if (closureIndices.has(index))
+            return;
+        const sourceIndex = lengthFor.get(index);
+        if (sourceIndex !== undefined) {
+            const source = asyncFn.parameters[sourceIndex];
+            if (source !== undefined) {
+                leadingExpressions.push(`${parameterIdentifier(source, sourceIndex)}.length`);
+                return;
+            }
+        }
+        leadingExpressions.push(parameterCallExpression(context, parameter, index));
+    });
+    const leadingLiteral = `[${leadingExpressions.join(", ")}]`;
+    return `return promisify(${bindingExpression}, this.${finishMember}.bind(this), ${cancellableExpression}, { leading: ${leadingLiteral} });`;
+};
+const findCancellableIndex = (parameters) => {
+    for (let index = 0; index < parameters.length; index += 1) {
+        const parameter = parameters[index];
+        if (parameter === undefined)
+            continue;
+        if (parameter.type?.kind !== "named")
+            continue;
+        if (parameter.type.typeName === "Cancellable")
+            return index;
+    }
+    return -1;
+};
+/**
+ * Renders the TypeScript signature for a promisified `*_async` method.
+ *
+ * The signature drops the trailing `GAsyncReadyCallback` and `gpointer
+ * user_data` slots, marks the cancellable optional, and returns a
+ * `Promise` wrapping the finish method's return type.
+ *
+ * @param context - The module context
+ * @param asyncFn - The `*_async` callable
+ * @param finishFn - The companion `*_finish` callable
+ */
+export const renderPromisifiedSignature = (context, asyncFn, finishFn) => {
+    const signature = renderInputParameters(context, asyncFn, (parameter) => isCallbackParameter(context, parameter), isCancellable);
+    const finishReturn = renderMethodReturnType(context, finishFn);
+    return { signature, returnType: `Promise<${finishReturn}>` };
+};
+const isCancellable = (parameter) => parameter.type?.kind === "named" && parameter.type.typeName === "Cancellable";
+const isCallbackParameter = (context, parameter) => {
+    const ref = parameter.type;
+    if (ref === undefined)
+        return false;
+    if (ref.kind === "callback")
+        return true;
+    if (ref.kind !== "named")
+        return false;
+    const namespaceName = ref.namespaceName ?? context.namespace.name;
+    const resolved = context.repository.resolveNamed(namespaceName, ref.typeName);
+    return resolved !== undefined && resolved.kind === "callback";
+};
+export const renderMethodBody = (context, fn, options) => {
+    const { bindingExpression, isStatic, returnAs } = options;
+    const builder = { callArgs: [], setup: [], outRefs: [] };
+    if (!isStatic && fn.instance !== undefined) {
+        context.addRuntimeImport("getHandle");
+        builder.callArgs.push("getHandle(this)");
+    }
+    collectParameterArgs(context, fn, builder);
+    const errorRef = appendErrorRef(fn, builder);
+    const callExpression = `${bindingExpression}(${builder.callArgs.join(", ")})`;
+    const lines = [...builder.setup];
+    const returnsValue = !isVoidReturn(fn);
+    lines.push(returnsValue ? `const __result = ${callExpression};` : `${callExpression};`);
+    if (errorRef !== undefined) {
+        context.addRuntimeImport("checkError");
+        lines.push(`checkError(${errorRef}, ${context.qualify("GLib", "Error")});`);
+    }
+    const primary = returnsValue ? wrapPrimary(context, fn, "__result", returnAs) : undefined;
+    appendReturn(context, lines, primary, builder.outRefs);
+    return lines.join("\n");
+};
+const collectParameterArgs = (context, fn, builder) => {
+    const lengthFor = arrayLengthSources(fn);
+    const closureIndices = closureAndDestroyIndices(fn);
+    const returnLengthIndices = returnArrayLengthIndices(fn);
+    fn.parameters.forEach((parameter, index) => {
+        if (parameter.isVarargs)
+            return;
+        if (isOutParameter(parameter)) {
+            appendOutRef({ context, parameter, index, returnLengthIndices, builder });
+            return;
+        }
+        if (isCallerAllocatedOut(parameter)) {
+            appendCallerAllocatedOut(context, parameter, builder);
+            return;
+        }
+        if (isInoutParameter(parameter)) {
+            appendInoutParameter({ context, parameter, index, returnLengthIndices, builder });
+            return;
+        }
+        const sourceIndex = lengthFor.get(index);
+        if (sourceIndex !== undefined) {
+            const source = fn.parameters[sourceIndex];
+            if (source !== undefined) {
+                builder.callArgs.push(`${parameterIdentifier(source, sourceIndex)}.length`);
+                return;
+            }
+        }
+        if (closureIndices.has(index)) {
+            return;
+        }
+        builder.callArgs.push(parameterCallExpression(context, parameter, index));
+    });
+};
+const appendOutRef = (options) => {
+    const { context, parameter, builder } = options;
+    const refName = `out${builder.outRefs.length}`;
+    builder.setup.push(`const ${refName}: { value: unknown } = { value: ${outRefInitial(context, parameter.type)} };`);
+    registerRefArg(options, refName);
+};
+/**
+ * The initial value seeded into a pure-out `{ value }` ref cell.
+ *
+ * The native marshaller encodes the cell's current value against the ref's
+ * inner FFI type before the call, so the seed must be assignable to that
+ * type: numeric and pointer cells seed `0`, booleans `false`, strings `""`,
+ * and object/boxed cells `null`.
+ */
+const outRefInitial = (context, ref) => {
+    if (ref === undefined)
+        return "null";
+    switch (ref.kind) {
+        case "primitive":
+            return primitiveInitial(ref.category);
+        case "named":
+            return namedInitial(context, ref);
+        case "array":
+        case "list":
+        case "hashtable":
+        case "callback":
+        case "varargs":
+            return "null";
+    }
+};
+const primitiveInitial = (category) => {
+    switch (category) {
+        case "boolean":
+            return "false";
+        case "string":
+            return '""';
+        case "void":
+            return "null";
+        default:
+            return "0";
+    }
+};
+const namedInitial = (context, ref) => {
+    const owner = ref.namespaceName ?? context.namespace.name;
+    const resolved = context.repository.resolveNamed(owner, ref.typeName);
+    if (resolved === undefined)
+        return "null";
+    if (resolved.kind === "enum")
+        return "0";
+    if (resolved.kind === "alias") {
+        const qualified = qualifyTypeRef(resolved.targetRef, resolved.namespace.name);
+        return qualified === undefined ? "null" : outRefInitial(context, qualified);
+    }
+    return "null";
+};
+const appendInoutRef = (options) => {
+    const { context, parameter, index, builder } = options;
+    const refName = `inout${builder.outRefs.length}`;
+    builder.setup.push(`const ${refName}: { value: unknown } = { value: ${parameterCallExpression(context, parameter, index)} };`);
+    registerRefArg(options, refName);
+};
+const appendInoutParameter = (options) => {
+    const { context, parameter } = options;
+    if (parameter.type !== undefined && isHandlePassing(context, parameter.type)) {
+        appendInoutHandle(options);
+    }
+    else {
+        appendInoutRef(options);
+    }
+};
+const appendInoutHandle = (options) => {
+    const { context, parameter, index, returnLengthIndices, builder } = options;
+    builder.callArgs.push(parameterCallExpression(context, parameter, index));
+    if (!returnLengthIndices.has(index)) {
+        builder.outRefs.push({
+            name: parameterIdentifier(parameter, index),
+            type: parameter.type,
+            nullable: parameter.nullable,
+            raw: true,
+        });
+    }
+};
+const registerRefArg = (options, refName) => {
+    const { parameter, index, returnLengthIndices, builder } = options;
+    builder.callArgs.push(refName);
+    if (!returnLengthIndices.has(index)) {
+        builder.outRefs.push({ name: refName, type: parameter.type, nullable: parameter.nullable });
+    }
+};
+const appendCallerAllocatedOut = (context, parameter, builder) => {
+    const allocated = allocateCallerOut(context, parameter, builder.outRefs.length);
+    if (allocated === undefined) {
+        builder.callArgs.push("undefined");
+        return;
+    }
+    builder.setup.push(allocated.setup);
+    builder.callArgs.push(allocated.callArg);
+    builder.outRefs.push({
+        name: allocated.returnExpression,
+        type: parameter.type,
+        nullable: parameter.nullable,
+        raw: true,
+    });
+};
+const appendErrorRef = (fn, builder) => {
+    if (!fn.throws)
+        return undefined;
+    const errorRef = "__error";
+    builder.setup.push(`const ${errorRef} = { value: null };`);
+    builder.callArgs.push(errorRef);
+    return errorRef;
+};
+const appendReturn = (context, lines, primary, outRefs) => {
+    if (outRefs.length === 0) {
+        if (primary !== undefined)
+            lines.push(`return ${primary};`);
+        return;
+    }
+    const outExpressions = outRefs.map((ref) => ref.raw === true
+        ? ref.name
+        : wrapReturnValue(context, {
+            ref: ref.type,
+            transfer: "full",
+            nullable: false,
+            valueExpression: `${ref.name}.value`,
+        }));
+    if (primary !== undefined) {
+        lines.push(`return [${primary}, ${outExpressions.join(", ")}];`);
+        return;
+    }
+    if (outExpressions.length === 1) {
+        lines.push(`return ${outExpressions[0]};`);
+        return;
+    }
+    lines.push(`return [${outExpressions.join(", ")}];`);
+};
+const allocateCallerOut = (context, parameter, index) => {
+    if (parameter.type === undefined || parameter.type.kind !== "named")
+        return undefined;
+    if (!isCollectibleCallerOut(context, parameter))
+        return undefined;
+    const owner = parameter.type.namespaceName ?? context.namespace.name;
+    const local = `__out${index}`;
+    const classExpression = context.qualify(owner, parameter.type.typeName);
+    context.addRuntimeImport("getHandle");
+    return {
+        setup: `const ${local} = new ${classExpression}();`,
+        callArg: `getHandle(${local})`,
+        returnExpression: local,
+    };
+};
+const parameterCallExpression = (context, parameter, index) => {
+    const name = parameterIdentifier(parameter, index);
+    const ref = parameter.type;
+    if (ref === undefined)
+        return name;
+    const callback = resolveCallbackType(context, ref);
+    if (callback !== undefined)
+        return renderCallbackArgument(context, callback, name);
+    const nullable = parameter.nullable || parameter.optional;
+    if (isHandlePassing(context, ref)) {
+        if (nullable) {
+            context.addRuntimeImport("tryGetHandle");
+            return `tryGetHandle(${name})`;
+        }
+        context.addRuntimeImport("getHandle");
+        return `getHandle(${name})`;
+    }
+    if ((ref.kind === "array" || ref.kind === "list") && isHandlePassing(context, ref.element)) {
+        context.addRuntimeImport("getHandle");
+        return nullable ? `${name}?.map((item) => getHandle(item))` : `${name}.map((item) => getHandle(item))`;
+    }
+    if (ref.kind === "hashtable") {
+        if (isHandlePassing(context, ref.value)) {
+            context.addRuntimeImport("tryGetHandle");
+            return `${name} ? globalThis.Array.from(${name}).map(([k, v]) => [k, tryGetHandle(v)]) : null`;
+        }
+        return `${name} ? globalThis.Array.from(${name}) : null`;
+    }
+    return name;
+};
+/**
+ * Plans how a callback or signal trampoline forwards its raw arguments to the
+ * user handler.
+ *
+ * In-parameters are wrapped via {@link wrapReturnValue} and joined into the
+ * handler call; out-parameters are dropped from the call and their trampoline
+ * cell indices collected for write-back. `argOffset` shifts every `args[...]`
+ * access: callbacks read from index `0`, while signal trampolines reserve
+ * index `0` for the emitting instance and so pass `1`.
+ *
+ * @param context - The module context
+ * @param parameters - The callback or signal parameters, varargs excluded
+ * @param namespaceName - The namespace the parameter type references resolve against
+ * @param argOffset - Added to each parameter's positional index
+ */
+export const planTrampolineArgs = (context, parameters, namespaceName, argOffset) => {
+    const callArgs = parameters
+        .map((parameter, index) => isOutParameter(parameter)
+        ? undefined
+        : wrapReturnValue(context, {
+            ref: qualifyTypeRef(parameter.type, namespaceName),
+            transfer: parameter.transferOwnership,
+            nullable: parameter.nullable,
+            valueExpression: isCellInout(context, parameter)
+                ? `args[${index + argOffset}].value`
+                : `args[${index + argOffset}]`,
+        }))
+        .filter((expression) => expression !== undefined)
+        .join(", ");
+    const outArgIndices = parameters
+        .map((parameter, index) => isOutParameter(parameter) || isCellInout(context, parameter) ? index + argOffset : -1)
+        .filter((index) => index >= 0);
+    return { callArgs, outArgIndices };
+};
+const renderCallbackArgument = (context, resolved, name) => {
+    const { callback, namespaceName } = resolved;
+    const { callArgs, outArgIndices } = planTrampolineArgs(context, callback.parameters, namespaceName, 0);
+    const returnRef = qualifyTypeRef(callback.returnValue.type, namespaceName);
+    if (outArgIndices.length > 0) {
+        const body = renderTupleWriteback(context, `${name}(${callArgs})`, outArgIndices, returnRef);
+        return `${name} ? (...args: unknown[]) => {\n    ${body}\n} : null`;
+    }
+    if (returnRef !== undefined && isHandlePassing(context, returnRef)) {
+        context.addRuntimeImport("getHandle");
+        return `${name} ? (...args: unknown[]) => {\n    const _result = ${name}(${callArgs});\n    return _result != null ? getHandle(_result) : null;\n} : null`;
+    }
+    return `${name} ? (...args: unknown[]) => ${name}(${callArgs}) : null`;
+};
+/**
+ * Renders the body of a native→JS callback wrapper that returns out-parameters
+ * as a tuple.
+ *
+ * The wrapped user function returns `[primary, ...outs]` (or the scalar out
+ * alone for a void return with a single out, or an out-only tuple otherwise).
+ * This emits `const _result = …;`, writes each out value into its `{ value }`
+ * cell's `value` slot (`args[i].value = …`), and returns the primary — keeping the
+ * tuple convention entirely in generated code so the native layer only flushes
+ * cells through their out-pointers. Shared by signal and callback writers.
+ *
+ * @param context - The module context
+ * @param callExpression - The expression that invokes the user function
+ * @param outArgIndices - Argument indices of the out-parameter cells
+ * @param returnRef - The primary return type, or `undefined` for void
+ */
+export const renderTupleWriteback = (context, callExpression, outArgIndices, returnRef) => {
+    const lines = [`const _result = ${callExpression};`];
+    const isVoid = returnRef === undefined || (returnRef.kind === "primitive" && returnRef.category === "void");
+    if (!isVoid) {
+        outArgIndices.forEach((argIndex, position) => {
+            lines.push(`args[${argIndex}].value = _result[${position + 1}];`);
+        });
+        if (returnRef !== undefined && isHandlePassing(context, returnRef)) {
+            context.addRuntimeImport("tryGetHandle");
+            lines.push("return tryGetHandle(_result[0]);");
+        }
+        else {
+            lines.push("return _result[0];");
+        }
+    }
+    else if (outArgIndices.length === 1) {
+        lines.push(`args[${outArgIndices[0]}].value = _result;`);
+    }
+    else {
+        outArgIndices.forEach((argIndex, position) => {
+            lines.push(`args[${argIndex}].value = _result[${position}];`);
+        });
+    }
+    return lines.join("\n    ");
+};
+const wrapPrimary = (context, fn, valueExpression, returnAs) => {
+    if (returnAs !== undefined) {
+        const handle = handleCast(context, valueExpression, false);
+        if (returnAs.via === "gobject") {
+            context.addRuntimeImport("getNativeObject");
+            return `getNativeObject(${handle})`;
+        }
+        if (returnAs.via === "boxed") {
+            context.addRuntimeImport("getNativeObject");
+            return `getNativeObject(${handle}, ${returnAs.className})`;
+        }
+        context.addRuntimeImport("getNativeObjectAsInterface");
+        return `getNativeObjectAsInterface(${handle}, ${returnAs.className})`;
+    }
+    return wrapReturnValue(context, {
+        ref: fn.returnValue.type,
+        transfer: fn.returnValue.transferOwnership,
+        nullable: fn.returnValue.nullable,
+        valueExpression,
+    });
+};
+//# sourceMappingURL=method.js.map

package/dist/writers/method.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"method.js","sourceRoot":"","sources":["../../src/writers/method.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAqB,oBAAoB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAChH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EACH,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EACnB,wBAAwB,GAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAyB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAErF;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,EAAe,EAAU,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;AAElF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,OAAsB,EAAE,EAAe,EAAU,EAAE,CACrF,qBAAqB,CACjB,OAAO,EACP,EAAE,EACF,GAAG,EAAE,CAAC,KAAK,EACX,GAAG,EAAE,CAAC,KAAK,CACd,CAAC;AAEN,MAAM,qBAAqB,GAAG,CAC1B,OAAsB,EACtB,EAAe,EACf,IAA0C,EAC1C,eAAqD,EAC/C,EAAE;IACR,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,KAAK,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,eAAe,CAAC,EAAE,CAAC,EAAE,CAAC;QACrD,IAAI,IAAI,CAAC,SAAS,CAAC;YAAE,SAAS;QAC9B,MAAM,IAAI,GAAG,mBAAmB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACnD,IAAI,SAAS,CAAC,QAAQ,IAAI,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;YACnD,WAAW,GAAG,IAAI,CAAC;QACvB,CAAC;QACD,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC7E,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,UAAU,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,UAAU,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,OAAsB,EAAE,EAAe,EAAU,EAAE;IACtF,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,EAAE,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAC7B,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CACT,CAAC,cAAc,CAAC,CAAC,CAAC;QACd,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,sBAAsB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC/D,gBAAgB,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,CACnC,CAAC;IACF,MAAM,mBAAmB,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAC9C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,mBAAmB,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9G,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACvF,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACvB,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IACjF,CAAC;IACD,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACpF,OAAO,IAAI,OAAO,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAClD,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,EAAe,EAAW,EAAE;IAC9C,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC;IAChC,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAC;AAC/D,CAAC,CAAC;AAuCF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACjC,OAAsB,EACtB,OAAoB,EACpB,YAAoB,EACpB,iBAAyB,EACnB,EAAE;IACR,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAClE,MAAM,cAAc,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,kBAAkB,GAAa,EAAE,CAAC;IACxC,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACtC,kBAAkB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,qBAAqB,GAAG,MAAM,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE;QAC5C,IAAI,SAAS,CAAC,SAAS;YAAE,OAAO;QAChC,IAAI,KAAK,KAAK,gBAAgB,EAAE,CAAC;YAC7B,qBAAqB,GAAG,mBAAmB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAC9D,OAAO;QACX,CAAC;QACD,IAAI,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC;YAAE,OAAO;QACpD,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO;QACtC,MAAM,WAAW,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;YAC/C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACvB,kBAAkB,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;gBAC9E,OAAO;YACX,CAAC;QACL,CAAC;QACD,kBAAkB,CAAC,IAAI,CAAC,uBAAuB,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IACH,MAAM,cAAc,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAC5D,OAAO,oBAAoB,iBAAiB,UAAU,YAAY,gBAAgB,qBAAqB,gBAAgB,cAAc,MAAM,CAAC;AAChJ,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,UAAmC,EAAU,EAAE;IACzE,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACxD,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,SAAS,KAAK,SAAS;YAAE,SAAS;QACtC,IAAI,SAAS,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO;YAAE,SAAS;QAC/C,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,KAAK,aAAa;YAAE,OAAO,KAAK,CAAC;IAChE,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACd,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACtC,OAAsB,EACtB,OAAoB,EACpB,QAAqB,EACsC,EAAE;IAC7D,MAAM,SAAS,GAAG,qBAAqB,CACnC,OAAO,EACP,OAAO,EACP,CAAC,SAAS,EAAE,EAAE,CAAC,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,EACtD,aAAa,CAChB,CAAC;IACF,MAAM,YAAY,GAAG,sBAAsB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC/D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,YAAY,GAAG,EAAE,CAAC;AACjE,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,SAAuB,EAAW,EAAE,CACvD,SAAS,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,KAAK,aAAa,CAAC;AAElF,MAAM,mBAAmB,GAAG,CAAC,OAAsB,EAAE,SAAuB,EAAW,EAAE;IACrF,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC;IAC3B,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACpC,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,aAAa,GAAG,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC;IAClE,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,aAAa,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9E,OAAO,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU,CAAC;AAClE,CAAC,CAAC;AAwCF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAsB,EAAE,EAAe,EAAE,OAA+B,EAAU,EAAE;IACjH,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC1D,MAAM,OAAO,GAAgB,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACtE,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzC,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC7C,CAAC;IACD,oBAAoB,CAAC,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7C,MAAM,cAAc,GAAG,GAAG,iBAAiB,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAC9E,MAAM,KAAK,GAAa,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,oBAAoB,cAAc,GAAG,CAAC,CAAC,CAAC,GAAG,cAAc,GAAG,CAAC,CAAC;IACxF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,cAAc,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1F,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,OAAsB,EAAE,EAAe,EAAE,OAAoB,EAAQ,EAAE;IACjG,MAAM,SAAS,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACzC,MAAM,cAAc,GAAG,wBAAwB,CAAC,EAAE,CAAC,CAAC;IACpD,MAAM,mBAAmB,GAAG,wBAAwB,CAAC,EAAE,CAAC,CAAC;IACzD,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE;QACvC,IAAI,SAAS,CAAC,SAAS;YAAE,OAAO;QAChC,IAAI,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5B,YAAY,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,CAAC;YAC1E,OAAO;QACX,CAAC;QACD,IAAI,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,wBAAwB,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YACtD,OAAO;QACX,CAAC;QACD,IAAI,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,oBAAoB,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,CAAC;YAClF,OAAO;QACX,CAAC;QACD,MAAM,WAAW,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;YAC1C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;gBAC5E,OAAO;YACX,CAAC;QACL,CAAC;QACD,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO;QACX,CAAC;QACD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,uBAAuB,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAUF,MAAM,YAAY,GAAG,CAAC,OAA4B,EAAQ,EAAE;IACxD,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;IAC/C,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,mCAAmC,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnH,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,aAAa,GAAG,CAAC,OAAsB,EAAE,GAA2B,EAAU,EAAE;IAClF,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACrC,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,WAAW;YACZ,OAAO,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,KAAK,OAAO;YACR,OAAO,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACtC,KAAK,OAAO,CAAC;QACb,KAAK,MAAM,CAAC;QACZ,KAAK,WAAW,CAAC;QACjB,KAAK,UAAU,CAAC;QAChB,KAAK,SAAS;YACV,OAAO,MAAM,CAAC;IACtB,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,QAAsC,EAAU,EAAE;IACxE,QAAQ,QAAQ,EAAE,CAAC;QACf,KAAK,SAAS;YACV,OAAO,OAAO,CAAC;QACnB,KAAK,QAAQ;YACT,OAAO,IAAI,CAAC;QAChB,KAAK,MAAM;YACP,OAAO,MAAM,CAAC;QAClB;YACI,OAAO,GAAG,CAAC;IACnB,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,OAAsB,EAAE,GAAiB,EAAU,EAAE;IACvE,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC;IAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtE,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAC1C,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,GAAG,CAAC;IACzC,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,cAAc,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9E,OAAO,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,OAA4B,EAAQ,EAAE;IAC1D,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACvD,MAAM,OAAO,GAAG,QAAQ,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;IACjD,OAAO,CAAC,KAAK,CAAC,IAAI,CACd,SAAS,OAAO,mCAAmC,uBAAuB,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,CAC7G,CAAC;IACF,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,OAA4B,EAAQ,EAAE;IAChE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IACvC,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,IAAI,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3E,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;SAAM,CAAC;QACJ,cAAc,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,OAA4B,EAAQ,EAAE;IAC7D,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC5E,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,uBAAuB,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IAC1E,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;YACjB,IAAI,EAAE,mBAAmB,CAAC,SAAS,EAAE,KAAK,CAAC;YAC3C,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,QAAQ,EAAE,SAAS,CAAC,QAAQ;YAC5B,GAAG,EAAE,IAAI;SACZ,CAAC,CAAC;IACP,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,OAA4B,EAAE,OAAe,EAAQ,EAAE;IAC3E,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACnE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;IAChG,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,wBAAwB,GAAG,CAAC,OAAsB,EAAE,SAAuB,EAAE,OAAoB,EAAQ,EAAE;IAC7G,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChF,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnC,OAAO;IACX,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QACjB,IAAI,EAAE,SAAS,CAAC,gBAAgB;QAChC,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,QAAQ,EAAE,SAAS,CAAC,QAAQ;QAC5B,GAAG,EAAE,IAAI;KACZ,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,EAAe,EAAE,OAAoB,EAAsB,EAAE;IACjF,IAAI,CAAC,EAAE,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IACjC,MAAM,QAAQ,GAAG,SAAS,CAAC;IAC3B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,QAAQ,qBAAqB,CAAC,CAAC;IAC3D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,OAAO,QAAQ,CAAC;AACpB,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CACjB,OAAsB,EACtB,KAAe,EACf,OAA2B,EAC3B,OAA0B,EACtB,EAAE;IACN,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,IAAI,OAAO,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,OAAO,GAAG,CAAC,CAAC;QAC5D,OAAO;IACX,CAAC;IACD,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACvC,GAAG,CAAC,GAAG,KAAK,IAAI;QACZ,CAAC,CAAC,GAAG,CAAC,IAAI;QACV,CAAC,CAAC,eAAe,CAAC,OAAO,EAAE;YACrB,GAAG,EAAE,GAAG,CAAC,IAAI;YACb,QAAQ,EAAE,MAAM;YAChB,QAAQ,EAAE,KAAK;YACf,eAAe,EAAE,GAAG,GAAG,CAAC,IAAI,QAAQ;SACvC,CAAC,CACX,CAAC;IACF,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,KAAK,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjE,OAAO;IACX,CAAC;IACD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,UAAU,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC3C,OAAO;IACX,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,WAAW,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CACtB,OAAsB,EACtB,SAAuB,EACvB,KAAa,EACsF,EAAE;IACrG,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IACtF,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAClE,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC;IACrE,MAAM,KAAK,GAAG,QAAQ,KAAK,EAAE,CAAC;IAC9B,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxE,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACtC,OAAO;QACH,KAAK,EAAE,SAAS,KAAK,UAAU,eAAe,KAAK;QACnD,OAAO,EAAE,aAAa,KAAK,GAAG;QAC9B,gBAAgB,EAAE,KAAK;KAC1B,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAAC,OAAsB,EAAE,SAAuB,EAAE,KAAa,EAAU,EAAE;IACvG,MAAM,IAAI,GAAG,mBAAmB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC;IAC3B,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACnD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,sBAAsB,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACnF,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,QAAQ,CAAC;IAC1D,IAAI,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC;QAChC,IAAI,QAAQ,EAAE,CAAC;YACX,OAAO,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;YACzC,OAAO,gBAAgB,IAAI,GAAG,CAAC;QACnC,CAAC;QACD,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACtC,OAAO,aAAa,IAAI,GAAG,CAAC;IAChC,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACzF,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACtC,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,kCAAkC,CAAC,CAAC,CAAC,GAAG,IAAI,iCAAiC,CAAC;IAC3G,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC3B,IAAI,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACtC,OAAO,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;YACzC,OAAO,GAAG,IAAI,4BAA4B,IAAI,gDAAgD,CAAC;QACnG,CAAC;QACD,OAAO,GAAG,IAAI,4BAA4B,IAAI,UAAU,CAAC;IAC7D,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAYF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAC9B,OAAsB,EACtB,UAAmC,EACnC,aAAqB,EACrB,SAAiB,EACA,EAAE;IACnB,MAAM,QAAQ,GAAG,UAAU;SACtB,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CACtB,cAAc,CAAC,SAAS,CAAC;QACrB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,eAAe,CAAC,OAAO,EAAE;YACrB,GAAG,EAAE,cAAc,CAAC,SAAS,CAAC,IAAI,EAAE,aAAa,CAAC;YAClD,QAAQ,EAAE,SAAS,CAAC,iBAAiB;YACrC,QAAQ,EAAE,SAAS,CAAC,QAAQ;YAC5B,eAAe,EAAE,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC;gBAC5C,CAAC,CAAC,QAAQ,KAAK,GAAG,SAAS,SAAS;gBACpC,CAAC,CAAC,QAAQ,KAAK,GAAG,SAAS,GAAG;SACrC,CAAC,CACX;SACA,MAAM,CAAC,CAAC,UAAU,EAAwB,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC;SACtE,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,MAAM,aAAa,GAAG,UAAU;SAC3B,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CACtB,cAAc,CAAC,SAAS,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CACxF;SACA,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;IACnC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;AACvC,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAAC,OAAsB,EAAE,QAA0B,EAAE,IAAY,EAAU,EAAE;IACxG,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,QAAQ,CAAC;IAC7C,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC;IACvG,MAAM,SAAS,GAAG,cAAc,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAC3E,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,oBAAoB,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,QAAQ,GAAG,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;QAC7F,OAAO,GAAG,IAAI,qCAAqC,IAAI,YAAY,CAAC;IACxE,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,IAAI,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;QACjE,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACtC,OAAO,GAAG,IAAI,qDAAqD,IAAI,IAAI,QAAQ,uEAAuE,CAAC;IAC/J,CAAC;IACD,OAAO,GAAG,IAAI,8BAA8B,IAAI,IAAI,QAAQ,UAAU,CAAC;AAC3E,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAChC,OAAsB,EACtB,cAAsB,EACtB,aAAgC,EAChC,SAAiC,EAC3B,EAAE;IACR,MAAM,KAAK,GAAG,CAAC,mBAAmB,cAAc,GAAG,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,SAAS,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,WAAW,IAAI,SAAS,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC;IAC5G,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,aAAa,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE;YACzC,KAAK,CAAC,IAAI,CAAC,QAAQ,QAAQ,qBAAqB,QAAQ,GAAG,CAAC,IAAI,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;QACH,IAAI,SAAS,KAAK,SAAS,IAAI,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;YACjE,OAAO,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACJ,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACrC,CAAC;IACL,CAAC;SAAM,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,QAAQ,aAAa,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC7D,CAAC;SAAM,CAAC;QACJ,aAAa,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE;YACzC,KAAK,CAAC,IAAI,CAAC,QAAQ,QAAQ,qBAAqB,QAAQ,IAAI,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;IACP,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAChB,OAAsB,EACtB,EAAe,EACf,eAAuB,EACvB,QAAoC,EAC9B,EAAE;IACR,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;QAC3D,IAAI,QAAQ,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;YAC5C,OAAO,mBAAmB,MAAM,GAAG,CAAC;QACxC,CAAC;QACD,IAAI,QAAQ,CAAC,GAAG,KAAK,OAAO,EAAE,CAAC;YAC3B,OAAO,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;YAC5C,OAAO,mBAAmB,MAAM,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC;QAC/D,CAAC;QACD,OAAO,CAAC,gBAAgB,CAAC,4BAA4B,CAAC,CAAC;QACvD,OAAO,8BAA8B,MAAM,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC;IAC1E,CAAC;IACD,OAAO,eAAe,CAAC,OAAO,EAAE;QAC5B,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI;QACxB,QAAQ,EAAE,EAAE,CAAC,WAAW,CAAC,iBAAiB;QAC1C,QAAQ,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ;QACjC,eAAe;KAClB,CAAC,CAAC;AACP,CAAC,CAAC"}

package/dist/writers/param-classify.d.ts

@@ -0,0 +1,93 @@
+import type { ModuleContext } from "../dsl/context.js";
+import type { GirFunction } from "../gir/function.js";
+import { type GirParameter } from "../gir/parameter.js";
+import type { GirTypeRef } from "../gir/type-ref.js";
+/**
+ * Parameter classification shared across the callable writers: which positions
+ * a TypeScript signature exposes, which marshal through a `{ value }` ref cell,
+ * which cross the FFI as native handles, and how a parameter is named. Depends
+ * only on the GIR model and the module context.
+ */
+/**
+ * A callable input parameter paired with its original GIR position.
+ */
+export type InputParameter = {
+    /** The GIR parameter. */
+    readonly parameter: GirParameter;
+    /** The parameter's index in the callable's full parameter list. */
+    readonly index: number;
+};
+/**
+ * The input parameters a callable's TypeScript signature exposes.
+ *
+ * Drops `<varargs>` slots, out-only and caller-allocated-out parameters,
+ * array-length parameters computed from a sibling array, and the
+ * `user_data`/`GDestroyNotify` slots folded into a callback descriptor. Each
+ * surviving parameter keeps its original index so callers can recover argument
+ * names.
+ *
+ * @param fn - The callable
+ */
+export declare const inputParameters: (fn: GirFunction) => readonly InputParameter[];
+/**
+ * Indices of the `gpointer user_data` and `GDestroyNotify` parameters paired
+ * to a callback parameter. These slots are folded into the callback's
+ * trampoline descriptor and are not emitted as standalone FFI arguments.
+ *
+ * @param fn - The callable
+ */
+export declare const closureAndDestroyIndices: (fn: GirFunction) => ReadonlySet<number>;
+/**
+ * Maps each array-length parameter's index to the array parameter whose
+ * `.length` supplies it.
+ *
+ * @param fn - The callable
+ */
+export declare const arrayLengthSources: (fn: GirFunction) => ReadonlyMap<number, number>;
+/**
+ * Indices of parameters consumed as the length of the return array (and so
+ * dropped from the return tuple).
+ *
+ * @param fn - The callable
+ */
+export declare const returnArrayLengthIndices: (fn: GirFunction) => ReadonlySet<number>;
+/**
+ * Whether a parameter is passed to the FFI binding as a `t.ref(...)` cell.
+ *
+ * Pure out parameters marshal through a `{ value }` ref cell the native layer
+ * writes into. Inout parameters do too — except handle-passing ones
+ * (objects, interfaces, boxed), which are passed by their existing handle
+ * and mutated in place, not through a pointer-to-pointer cell.
+ * Caller-allocated outs pass a pre-built handle and are excluded.
+ *
+ * @param context - The module context
+ * @param parameter - The parameter to test
+ */
+export declare const needsRefArg: (context: ModuleContext, parameter: GirParameter) => boolean;
+/**
+ * Whether a caller-allocated-out parameter is one the body can materialize and
+ * collect into the return — a boxed record or class the runtime can allocate
+ * via its wrapper constructor. Array and other caller-out buffers cannot be
+ * allocated here, so they are excluded from both the body and the return type.
+ *
+ * @param context - The module context
+ * @param parameter - The parameter to test
+ */
+export declare const isCollectibleCallerOut: (context: ModuleContext, parameter: GirParameter) => boolean;
+/**
+ * Whether a value of `ref` is passed across the FFI boundary as a native
+ * handle (object, interface, boxed, or an alias to one) instead of by value.
+ *
+ * @param context - The module context
+ * @param ref - The type reference to test
+ */
+export declare const isHandlePassing: (context: ModuleContext, ref: GirTypeRef) => boolean;
+/**
+ * The JavaScript identifier for a parameter: the camelCased GIR name, or
+ * `arg<index>` for an unnamed position.
+ *
+ * @param parameter - The GIR parameter
+ * @param index - The parameter's position in the callable
+ */
+export declare const parameterIdentifier: (parameter: GirParameter, index: number) => string;
+//# sourceMappingURL=param-classify.d.ts.map

package/dist/writers/param-classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-classify.d.ts","sourceRoot":"","sources":["../../src/writers/param-classify.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,KAAK,YAAY,EAAwC,MAAM,qBAAqB,CAAC;AAC9F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB,yBAAyB;IACzB,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAAI,IAAI,WAAW,KAAG,SAAS,cAAc,EAaxE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GAAI,IAAI,WAAW,KAAG,WAAW,CAAC,MAAM,CAO5E,CAAC;AAOF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,IAAI,WAAW,KAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAS9E,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,IAAI,WAAW,KAAG,WAAW,CAAC,MAAM,CAK5E,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,aAAa,EAAE,WAAW,YAAY,KAAG,OAO7E,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,aAAa,EAAE,WAAW,YAAY,KAAG,OAOxF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,aAAa,EAAE,KAAK,UAAU,KAAG,OAmBzE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,WAAW,YAAY,EAAE,OAAO,MAAM,KAAG,MAG5E,CAAC"}