@tsonic/cli 0.0.63 → 0.0.64

package/dist/commands/library-bindings-firstparty.js

@@ -0,0 +1,2250 @@
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync, } from "node:fs";
+import { join, posix, resolve } from "node:path";
+import { buildModuleDependencyGraph } from "@tsonic/frontend";
+import * as ts from "typescript";
+import { resolveSurfaceCapabilities } from "../surface/profiles.js";
+import { overlayDependencyBindings } from "./library-bindings-augment.js";
+const primitiveImportLine = "import type { sbyte, byte, short, ushort, int, uint, long, ulong, int128, uint128, half, float, double, decimal, nint, nuint, char } from '@tsonic/core/types.js';";
+const typePrinter = ts.createPrinter({ removeComments: true });
+const printTypeNodeText = (node, sourceFile) => {
+    return typePrinter
+        .printNode(ts.EmitHint.Unspecified, node, sourceFile)
+        .trim();
+};
+const ensureUndefinedInType = (typeText) => {
+    const trimmed = typeText.trim();
+    if (/\bundefined\b/.test(trimmed))
+        return trimmed;
+    return `${trimmed} | undefined`;
+};
+const applyWrappersToBaseType = (baseType, wrappers) => {
+    let expr = baseType.trim();
+    for (const w of wrappers.slice().reverse()) {
+        expr = `${w.aliasName}<${expr}>`;
+    }
+    return expr;
+};
+const getPropertyNameText = (name) => {
+    if (ts.isIdentifier(name))
+        return name.text;
+    if (ts.isStringLiteral(name) || ts.isNumericLiteral(name))
+        return name.text;
+    return undefined;
+};
+const sanitizeForBrand = (value) => {
+    const normalized = value.replace(/[^A-Za-z0-9_]/g, "_");
+    return normalized.length > 0 ? normalized : "_";
+};
+const printTypeParameters = (typeParameters) => {
+    if (!typeParameters || typeParameters.length === 0)
+        return "";
+    return `<${typeParameters.map((typeParameter) => typeParameter.name).join(", ")}>`;
+};
+const normalizeTypeReferenceName = (name, arity) => {
+    const withoutNamespace = (() => {
+        const dotIndex = Math.max(name.lastIndexOf("."), name.lastIndexOf("+"));
+        return dotIndex >= 0 ? name.slice(dotIndex + 1) : name;
+    })();
+    const backtickNormalized = withoutNamespace.replace(/`(\d+)$/, "_$1");
+    if (!arity || arity <= 0)
+        return backtickNormalized;
+    if (new RegExp(`_${arity}$`).test(backtickNormalized)) {
+        return backtickNormalized;
+    }
+    return `${backtickNormalized}_${arity}`;
+};
+const renderReferenceType = (referenceName, typeArguments, typeParametersInScope) => {
+    if (typeParametersInScope.includes(referenceName))
+        return referenceName;
+    if (referenceName === "unknown")
+        return "unknown";
+    if (referenceName === "any")
+        return "unknown";
+    if (referenceName === "object")
+        return "object";
+    if (referenceName === "string")
+        return "string";
+    if (referenceName === "boolean")
+        return "boolean";
+    if (referenceName === "number")
+        return "number";
+    let normalizedName = normalizeTypeReferenceName(referenceName);
+    if (typeArguments && typeArguments.length > 0) {
+        const arityMatch = normalizedName.match(/_(\d+)$/);
+        if (arityMatch &&
+            arityMatch[1] &&
+            Number(arityMatch[1]) === typeArguments.length &&
+            !normalizedName.includes("__Alias_") &&
+            !normalizedName.includes("__")) {
+            normalizedName = normalizedName.slice(0, -arityMatch[0].length);
+        }
+        else if (normalizedName.endsWith("_") &&
+            !normalizedName.includes("__Alias_")) {
+            normalizedName = normalizedName.slice(0, -1);
+        }
+    }
+    if (!typeArguments || typeArguments.length === 0)
+        return normalizedName;
+    return `${normalizedName}<${typeArguments
+        .map((arg) => renderPortableType(arg, typeParametersInScope))
+        .join(", ")}>`;
+};
+const renderPortableType = (type, typeParametersInScope = []) => {
+    if (!type)
+        return "object";
+    switch (type.kind) {
+        case "primitiveType":
+            return type.name;
+        case "literalType":
+            return typeof type.value === "string"
+                ? JSON.stringify(type.value)
+                : String(type.value);
+        case "voidType":
+            return "void";
+        case "neverType":
+            return "never";
+        case "unknownType":
+        case "anyType":
+            return "unknown";
+        case "typeParameterType":
+            return type.name;
+        case "arrayType":
+            return `${renderPortableType(type.elementType, typeParametersInScope)}[]`;
+        case "tupleType":
+            return `[${type.elementTypes
+                .map((item) => renderPortableType(item, typeParametersInScope))
+                .join(", ")}]`;
+        case "unionType":
+            return type.types
+                .map((item) => renderPortableType(item, typeParametersInScope))
+                .join(" | ");
+        case "intersectionType":
+            return type.types
+                .map((item) => renderPortableType(item, typeParametersInScope))
+                .join(" & ");
+        case "dictionaryType":
+            return `Record<${renderPortableType(type.keyType, typeParametersInScope)}, ${renderPortableType(type.valueType, typeParametersInScope)}>`;
+        case "functionType":
+            return `(${type.parameters
+                .map((parameter, index) => {
+                const parameterName = parameter.pattern.kind === "identifierPattern"
+                    ? parameter.pattern.name
+                    : `p${index + 1}`;
+                return `${parameterName}: ${renderPortableType(parameter.type, typeParametersInScope)}`;
+            })
+                .join(", ")}) => ${renderPortableType(type.returnType, typeParametersInScope)}`;
+        case "objectType":
+            return `{ ${type.members
+                .map((member) => {
+                if (member.kind === "methodSignature") {
+                    return `${member.name}${printTypeParameters(member.typeParameters)}(${member.parameters
+                        .map((parameter, index) => {
+                        const parameterName = parameter.pattern.kind === "identifierPattern"
+                            ? parameter.pattern.name
+                            : `p${index + 1}`;
+                        const optionalMark = parameter.isOptional ? "?" : "";
+                        return `${parameterName}${optionalMark}: ${renderPortableType(parameter.type, typeParametersInScope)}`;
+                    })
+                        .join(", ")}): ${renderPortableType(member.returnType, typeParametersInScope)}`;
+                }
+                const optionalMark = member.isOptional ? "?" : "";
+                const readonlyMark = member.isReadonly ? "readonly " : "";
+                return `${readonlyMark}${member.name}${optionalMark}: ${renderPortableType(member.type, typeParametersInScope)}`;
+            })
+                .join("; ")} }`;
+        case "referenceType": {
+            return renderReferenceType(type.name, type.typeArguments, typeParametersInScope);
+        }
+        default:
+            return "object";
+    }
+};
+const renderUnknownParameters = (parameters, typeParametersInScope) => {
+    return parameters
+        .map((parameter, index) => {
+        const baseName = parameter.pattern.kind === "identifierPattern"
+            ? parameter.pattern.name
+            : `p${index + 1}`;
+        const restPrefix = parameter.isRest ? "..." : "";
+        const optionalMark = parameter.isOptional && !parameter.isRest ? "?" : "";
+        const parameterType = renderPortableType(parameter.type, typeParametersInScope);
+        const typeSuffix = parameter.isRest
+            ? `${parameterType}[]`
+            : parameterType;
+        return `${restPrefix}${baseName}${optionalMark}: ${typeSuffix}`;
+    })
+        .join(", ");
+};
+const renderMethodSignature = (name, typeParameters, parameters, returnType) => {
+    const typeParametersText = printTypeParameters(typeParameters);
+    const typeParameterNames = typeParameters?.map((typeParameter) => typeParameter.name) ?? [];
+    const parametersText = renderUnknownParameters(parameters, typeParameterNames);
+    const returnTypeText = renderPortableType(returnType, typeParameterNames);
+    return `${name}${typeParametersText}(${parametersText}): ${returnTypeText};`;
+};
+const declarationNameOf = (statement) => {
+    switch (statement.kind) {
+        case "functionDeclaration":
+        case "classDeclaration":
+        case "interfaceDeclaration":
+        case "enumDeclaration":
+        case "typeAliasDeclaration":
+            return statement.name;
+        default:
+            return undefined;
+    }
+};
+const resolveModuleLocalDeclaration = (module, localName) => {
+    for (const statement of module.body) {
+        const statementName = declarationNameOf(statement);
+        if (statementName === localName)
+            return statement;
+        if (statement.kind === "variableDeclaration") {
+            for (const declarator of statement.declarations) {
+                if (declarator.name.kind === "identifierPattern" &&
+                    declarator.name.name === localName) {
+                    return statement;
+                }
+            }
+        }
+    }
+    return undefined;
+};
+const classifyDeclarationKind = (statement, filePath, exportName) => {
+    switch (statement.kind) {
+        case "functionDeclaration":
+            return { ok: true, value: "function" };
+        case "variableDeclaration":
+            return { ok: true, value: "variable" };
+        case "classDeclaration":
+            return { ok: true, value: "class" };
+        case "interfaceDeclaration":
+            return { ok: true, value: "interface" };
+        case "enumDeclaration":
+            return { ok: true, value: "enum" };
+        case "typeAliasDeclaration":
+            return { ok: true, value: "typeAlias" };
+        default:
+            return {
+                ok: false,
+                error: `Unsupported export '${exportName}' in ${filePath}: ${statement.kind}.\n` +
+                    "First-party bindings generation requires explicit support for each exported declaration kind.",
+            };
+    }
+};
+const collectModuleExports = (module, modulesByFileKey) => {
+    const exportedSymbols = [];
+    const seen = new Set();
+    const pushExport = (symbol) => {
+        const key = `${symbol.exportName}|${symbol.localName}|${symbol.kind}`;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        exportedSymbols.push(symbol);
+    };
+    for (const item of module.exports) {
+        if (item.kind === "default") {
+            return {
+                ok: false,
+                error: `Unsupported default export in ${module.filePath}.\n` +
+                    "First-party bindings generation currently requires named/declaration exports for deterministic namespace facades.",
+            };
+        }
+        if (item.kind === "declaration") {
+            const declaration = item.declaration;
+            if (declaration.kind === "variableDeclaration") {
+                for (const declarator of declaration.declarations) {
+                    if (declarator.name.kind !== "identifierPattern") {
+                        return {
+                            ok: false,
+                            error: `Unsupported exported variable declarator in ${module.filePath}: ${declarator.name.kind}.\n` +
+                                "First-party bindings generation requires identifier-based exported variables.",
+                        };
+                    }
+                    const localName = declarator.name.name;
+                    pushExport({
+                        exportName: localName,
+                        localName,
+                        kind: "variable",
+                        declaration,
+                        declaringNamespace: module.namespace,
+                        declaringClassName: module.className,
+                        declaringFilePath: module.filePath,
+                    });
+                }
+                continue;
+            }
+            const declarationName = declarationNameOf(declaration);
+            if (!declarationName) {
+                return {
+                    ok: false,
+                    error: `Unsupported exported declaration in ${module.filePath}: ${declaration.kind}.\n` +
+                        "First-party bindings generation requires explicit support for each exported declaration kind.",
+                };
+            }
+            const declarationKind = classifyDeclarationKind(declaration, module.filePath, declarationName);
+            if (!declarationKind.ok)
+                return declarationKind;
+            pushExport({
+                exportName: declarationName,
+                localName: declarationName,
+                kind: declarationKind.value,
+                declaration,
+                declaringNamespace: module.namespace,
+                declaringClassName: module.className,
+                declaringFilePath: module.filePath,
+            });
+            continue;
+        }
+        if (item.kind === "reexport")
+            continue;
+        const resolved = resolveExportedDeclaration(module, item.name, modulesByFileKey);
+        if (!resolved.ok)
+            return resolved;
+        const declaration = resolved.value.declaration;
+        const declarationName = declarationNameOf(declaration);
+        if (!declarationName && declaration.kind !== "variableDeclaration") {
+            return {
+                ok: false,
+                error: `Unsupported named export '${item.name}' in ${module.filePath}: ${declaration.kind}.\n` +
+                    "First-party bindings generation requires explicit support for each exported declaration kind.",
+            };
+        }
+        const declarationKind = classifyDeclarationKind(declaration, module.filePath, item.name);
+        if (!declarationKind.ok)
+            return declarationKind;
+        pushExport({
+            exportName: item.name,
+            localName: resolved.value.clrName,
+            kind: declarationKind.value,
+            declaration,
+            declaringNamespace: resolved.value.module.namespace,
+            declaringClassName: resolved.value.module.className,
+            declaringFilePath: resolved.value.module.filePath,
+        });
+    }
+    return {
+        ok: true,
+        value: exportedSymbols.sort((left, right) => left.exportName.localeCompare(right.exportName)),
+    };
+};
+const moduleNamespacePath = (namespace) => {
+    return namespace.length > 0 ? namespace : "index";
+};
+const normalizeModuleFileKey = (filePath) => {
+    return filePath
+        .replace(/\\/g, "/")
+        .replace(/^(\.\/)+/, "")
+        .replace(/^\/+/, "");
+};
+const resolveLocalModuleFile = (fromModule, fromFile, modulesByFile) => {
+    const dir = posix.dirname(fromFile);
+    const candidates = [];
+    const raw = fromModule.startsWith("/")
+        ? posix.normalize(fromModule.slice(1))
+        : posix.normalize(posix.join(dir, fromModule));
+    candidates.push(raw);
+    if (raw.endsWith(".js")) {
+        candidates.push(raw.replace(/\.js$/, ".ts"));
+    }
+    if (!raw.endsWith(".ts") && !raw.endsWith(".js")) {
+        candidates.push(raw + ".ts");
+        candidates.push(raw + ".js");
+        candidates.push(posix.join(raw, "index.ts"));
+        candidates.push(posix.join(raw, "index.js"));
+    }
+    for (const cand of candidates) {
+        const normalized = normalizeModuleFileKey(cand);
+        const found = modulesByFile.get(normalized);
+        if (found)
+            return found;
+    }
+    return undefined;
+};
+const resolveReexportModuleKey = (fromFilePath, fromModule) => {
+    const fromDir = posix.dirname(normalizeModuleFileKey(fromFilePath));
+    return normalizeModuleFileKey(posix.normalize(posix.join(fromDir, fromModule)));
+};
+const isRelativeModuleSpecifier = (specifier) => specifier.startsWith(".") || specifier.startsWith("/");
+const resolveImportedLocalDeclaration = (module, localName, modulesByFileKey, visited) => {
+    for (const importEntry of module.imports) {
+        for (const specifier of importEntry.specifiers) {
+            if (specifier.localName !== localName)
+                continue;
+            if (specifier.kind === "namespace") {
+                return {
+                    ok: false,
+                    error: `Unable to re-export '${localName}' from ${module.filePath}: namespace imports are not supported for first-party bindings generation.`,
+                };
+            }
+            if (!importEntry.isLocal) {
+                return {
+                    ok: false,
+                    error: `Unsupported re-export in ${module.filePath}: '${localName}' resolves to non-local module '${importEntry.source}'.\n` +
+                        "First-party bindings generation currently supports only local source-module exports.",
+                };
+            }
+            const targetModule = modulesByFileKey.get(resolveReexportModuleKey(module.filePath, importEntry.source));
+            if (!targetModule) {
+                return {
+                    ok: false,
+                    error: `Unable to resolve local import target for '${localName}' in ${module.filePath}: '${importEntry.source}'.\n` +
+                        "First-party bindings generation requires local import targets to resolve deterministically.",
+                };
+            }
+            const importedName = specifier.kind === "named" ? specifier.name : "default";
+            return resolveExportedDeclaration(targetModule, importedName, modulesByFileKey, visited);
+        }
+    }
+    return {
+        ok: false,
+        error: `Unable to resolve local symbol '${localName}' in ${module.filePath}.\n` +
+            "First-party bindings generation requires resolvable local exports and aliases.",
+    };
+};
+const resolveExportedDeclaration = (module, exportName, modulesByFileKey, visited = new Set()) => {
+    const cycleKey = `${normalizeModuleFileKey(module.filePath)}::${exportName}`;
+    if (visited.has(cycleKey)) {
+        return {
+            ok: false,
+            error: `Cyclic re-export detected while resolving '${exportName}' in ${module.filePath}.\n` +
+                "First-party bindings generation requires acyclic local re-export graphs.",
+        };
+    }
+    const nextVisited = new Set(visited);
+    nextVisited.add(cycleKey);
+    for (const item of module.exports) {
+        if (item.kind === "declaration") {
+            const declaration = item.declaration;
+            if (declaration.kind === "variableDeclaration") {
+                for (const declarator of declaration.declarations) {
+                    if (declarator.name.kind !== "identifierPattern")
+                        continue;
+                    if (declarator.name.name !== exportName)
+                        continue;
+                    return {
+                        ok: true,
+                        value: {
+                            declaration,
+                            module,
+                            clrName: declarator.name.name,
+                        },
+                    };
+                }
+                continue;
+            }
+            const declarationName = declarationNameOf(declaration);
+            if (declarationName !== exportName)
+                continue;
+            return {
+                ok: true,
+                value: {
+                    declaration,
+                    module,
+                    clrName: declarationName,
+                },
+            };
+        }
+        if (item.kind === "named") {
+            if (item.name !== exportName)
+                continue;
+            const declaration = resolveModuleLocalDeclaration(module, item.localName);
+            if (declaration) {
+                return {
+                    ok: true,
+                    value: {
+                        declaration,
+                        module,
+                        clrName: item.localName,
+                    },
+                };
+            }
+            return resolveImportedLocalDeclaration(module, item.localName, modulesByFileKey, nextVisited);
+        }
+        if (item.kind === "reexport") {
+            if (item.name !== exportName)
+                continue;
+            if (!isRelativeModuleSpecifier(item.fromModule)) {
+                return {
+                    ok: false,
+                    error: `Unsupported re-export in ${module.filePath}: '${item.name}' from '${item.fromModule}'.\n` +
+                        "First-party bindings generation currently supports only relative re-exports from local source modules.",
+                };
+            }
+            const targetModule = modulesByFileKey.get(resolveReexportModuleKey(module.filePath, item.fromModule));
+            if (!targetModule) {
+                return {
+                    ok: false,
+                    error: `Unable to resolve local re-export target for '${item.name}' in ${module.filePath}: '${item.fromModule}'.\n` +
+                        "First-party bindings generation requires local re-export targets to resolve deterministically.",
+                };
+            }
+            return resolveExportedDeclaration(targetModule, item.originalName, modulesByFileKey, nextVisited);
+        }
+        if (item.kind === "default" && exportName === "default") {
+            return {
+                ok: false,
+                error: `Unsupported default export in ${module.filePath}.\n` +
+                    "First-party bindings generation currently requires named/declaration exports for deterministic namespace facades.",
+            };
+        }
+    }
+    return {
+        ok: false,
+        error: `Unable to resolve exported symbol '${exportName}' in ${module.filePath}.\n` +
+            "First-party bindings generation requires explicit resolvable exports.",
+    };
+};
+const buildModuleSourceIndex = (absoluteFilePath, fileKey) => {
+    if (!existsSync(absoluteFilePath)) {
+        return {
+            ok: false,
+            error: `Failed to read source file for bindings generation: ${absoluteFilePath}`,
+        };
+    }
+    const content = readFileSync(absoluteFilePath, "utf-8");
+    const scriptKind = absoluteFilePath.endsWith(".tsx")
+        ? ts.ScriptKind.TSX
+        : absoluteFilePath.endsWith(".js")
+            ? ts.ScriptKind.JS
+            : ts.ScriptKind.TS;
+    const sourceFile = ts.createSourceFile(absoluteFilePath, content, ts.ScriptTarget.Latest, true, scriptKind);
+    const wrapperImportsByLocalName = new Map();
+    const typeImportsByLocalName = new Map();
+    const typeAliasesByName = new Map();
+    const exportedFunctionSignaturesByName = new Map();
+    const memberTypesByClassAndMember = new Map();
+    const printTypeParametersText = (typeParameters) => {
+        if (!typeParameters || typeParameters.length === 0)
+            return "";
+        return `<${typeParameters.map((tp) => tp.getText(sourceFile)).join(", ")}>`;
+    };
+    const printParameterText = (param) => {
+        const rest = param.dotDotDotToken ? "..." : "";
+        const name = param.name.getText(sourceFile);
+        const optional = param.questionToken ? "?" : "";
+        const type = param.type
+            ? printTypeNodeText(param.type, sourceFile)
+            : "unknown";
+        return `${rest}${name}${optional}: ${type}`;
+    };
+    const addExportedFunctionSignature = (name, signature) => {
+        const signatures = exportedFunctionSignaturesByName.get(name) ?? [];
+        signatures.push(signature);
+        exportedFunctionSignaturesByName.set(name, signatures);
+    };
+    for (const stmt of sourceFile.statements) {
+        if (ts.isImportDeclaration(stmt)) {
+            const moduleSpecifier = ts.isStringLiteral(stmt.moduleSpecifier)
+                ? stmt.moduleSpecifier.text
+                : undefined;
+            if (!moduleSpecifier)
+                continue;
+            const clause = stmt.importClause;
+            if (!clause)
+                continue;
+            const namedBindings = clause.namedBindings;
+            if (!namedBindings || !ts.isNamedImports(namedBindings))
+                continue;
+            for (const spec of namedBindings.elements) {
+                const localName = spec.name.text;
+                const importedName = (spec.propertyName ?? spec.name).text;
+                const isTypeOnly = clause.isTypeOnly || spec.isTypeOnly;
+                if (!isTypeOnly)
+                    continue;
+                typeImportsByLocalName.set(localName, {
+                    source: moduleSpecifier,
+                    importedName,
+                });
+                if (importedName === "ExtensionMethods") {
+                    wrapperImportsByLocalName.set(localName, {
+                        source: moduleSpecifier,
+                        importedName,
+                    });
+                }
+            }
+            continue;
+        }
+        if (ts.isTypeAliasDeclaration(stmt)) {
+            const aliasName = stmt.name.text;
+            const typeParameterNames = (stmt.typeParameters ?? []).map((tp) => tp.name.text);
+            typeAliasesByName.set(aliasName, {
+                typeParametersText: printTypeParametersText(stmt.typeParameters),
+                typeParameterNames,
+                type: stmt.type,
+                typeText: printTypeNodeText(stmt.type, sourceFile),
+            });
+            continue;
+        }
+        if (ts.isFunctionDeclaration(stmt)) {
+            const hasExport = stmt.modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.ExportKeyword);
+            if (!hasExport || !stmt.name || !stmt.type)
+                continue;
+            const parametersText = stmt.parameters.map(printParameterText).join(", ");
+            addExportedFunctionSignature(stmt.name.text, {
+                typeParametersText: printTypeParametersText(stmt.typeParameters),
+                parametersText,
+                returnTypeText: printTypeNodeText(stmt.type, sourceFile),
+            });
+            continue;
+        }
+        if (ts.isVariableStatement(stmt)) {
+            const hasExport = stmt.modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.ExportKeyword);
+            if (!hasExport)
+                continue;
+            for (const declaration of stmt.declarationList.declarations) {
+                if (!ts.isIdentifier(declaration.name))
+                    continue;
+                const exportName = declaration.name.text;
+                const initializer = declaration.initializer;
+                if (!initializer)
+                    continue;
+                if (!ts.isArrowFunction(initializer) &&
+                    !ts.isFunctionExpression(initializer)) {
+                    continue;
+                }
+                if (!initializer.type)
+                    continue;
+                const parametersText = initializer.parameters
+                    .map(printParameterText)
+                    .join(", ");
+                addExportedFunctionSignature(exportName, {
+                    typeParametersText: printTypeParametersText(initializer.typeParameters),
+                    parametersText,
+                    returnTypeText: printTypeNodeText(initializer.type, sourceFile),
+                });
+            }
+            continue;
+        }
+        if (ts.isClassDeclaration(stmt) && stmt.name) {
+            const className = stmt.name.text;
+            const members = memberTypesByClassAndMember.get(className) ??
+                new Map();
+            for (const member of stmt.members) {
+                if (ts.isGetAccessorDeclaration(member)) {
+                    if (!member.name || !member.type)
+                        continue;
+                    const name = getPropertyNameText(member.name);
+                    if (!name)
+                        continue;
+                    members.set(name, {
+                        typeNode: member.type,
+                        typeText: printTypeNodeText(member.type, sourceFile),
+                        isOptional: false,
+                    });
+                    continue;
+                }
+                if (ts.isPropertyDeclaration(member)) {
+                    if (!member.name || !member.type)
+                        continue;
+                    const name = getPropertyNameText(member.name);
+                    if (!name)
+                        continue;
+                    members.set(name, {
+                        typeNode: member.type,
+                        typeText: printTypeNodeText(member.type, sourceFile),
+                        isOptional: member.questionToken !== undefined,
+                    });
+                }
+            }
+            if (members.size > 0) {
+                memberTypesByClassAndMember.set(className, members);
+            }
+            continue;
+        }
+        if (ts.isInterfaceDeclaration(stmt)) {
+            const interfaceName = stmt.name.text;
+            const members = memberTypesByClassAndMember.get(interfaceName) ??
+                new Map();
+            for (const member of stmt.members) {
+                if (!ts.isPropertySignature(member))
+                    continue;
+                if (!member.name || !member.type)
+                    continue;
+                const name = getPropertyNameText(member.name);
+                if (!name)
+                    continue;
+                members.set(name, {
+                    typeNode: member.type,
+                    typeText: printTypeNodeText(member.type, sourceFile),
+                    isOptional: member.questionToken !== undefined,
+                });
+            }
+            if (members.size > 0) {
+                memberTypesByClassAndMember.set(interfaceName, members);
+            }
+        }
+    }
+    return {
+        ok: true,
+        value: {
+            fileKey,
+            wrapperImportsByLocalName,
+            typeImportsByLocalName,
+            typeAliasesByName,
+            exportedFunctionSignaturesByName,
+            memberTypesByClassAndMember,
+        },
+    };
+};
+const typeNodeUsesImportedTypeNames = (node, typeImportsByLocalName) => {
+    const allowlistedImportSources = new Set(["@tsonic/core/types.js"]);
+    let found = false;
+    const visit = (current) => {
+        if (found)
+            return;
+        if (ts.isTypeReferenceNode(current) && ts.isIdentifier(current.typeName)) {
+            const imported = typeImportsByLocalName.get(current.typeName.text);
+            if (imported && !allowlistedImportSources.has(imported.source.trim())) {
+                found = true;
+                return;
+            }
+        }
+        ts.forEachChild(current, visit);
+    };
+    visit(node);
+    return found;
+};
+const unwrapParens = (node) => {
+    let current = node;
+    while (ts.isParenthesizedTypeNode(current)) {
+        current = current.type;
+    }
+    return current;
+};
+const collectExtensionWrapperImportsFromSourceType = (opts) => {
+    const wrappers = [];
+    let currentModuleKey = opts.startModuleKey;
+    let currentNode = opts.typeNode;
+    let subst = new Map();
+    const aliasStack = [];
+    while (true) {
+        currentNode = unwrapParens(currentNode);
+        if (!ts.isTypeReferenceNode(currentNode))
+            break;
+        if (!ts.isIdentifier(currentNode.typeName))
+            break;
+        const ident = currentNode.typeName.text;
+        const info = opts.sourceIndexByFileKey.get(currentModuleKey);
+        if (!info)
+            break;
+        const substituted = subst.get(ident);
+        if (substituted) {
+            currentNode = substituted;
+            continue;
+        }
+        const expandAlias = (aliasKey, alias, typeArgs) => {
+            if (aliasStack.includes(aliasKey))
+                return;
+            aliasStack.push(aliasKey);
+            if (alias.typeParameterNames.length === typeArgs.length) {
+                const next = new Map(subst);
+                for (let i = 0; i < alias.typeParameterNames.length; i += 1) {
+                    const paramName = alias.typeParameterNames[i];
+                    const arg = typeArgs[i];
+                    if (!paramName || !arg)
+                        continue;
+                    next.set(paramName, arg);
+                }
+                subst = next;
+            }
+            currentNode = alias.type;
+        };
+        const localAlias = info.typeAliasesByName.get(ident);
+        if (localAlias) {
+            expandAlias(`${currentModuleKey}:${ident}`, localAlias, currentNode.typeArguments ?? []);
+            continue;
+        }
+        const imported = info.typeImportsByLocalName.get(ident);
+        if (imported &&
+            (imported.source.startsWith(".") || imported.source.startsWith("/"))) {
+            const targetModule = resolveLocalModuleFile(imported.source, currentModuleKey, opts.modulesByFileKey);
+            if (targetModule) {
+                const targetKey = normalizeModuleFileKey(targetModule.filePath);
+                const targetInfo = opts.sourceIndexByFileKey.get(targetKey);
+                const targetAlias = targetInfo?.typeAliasesByName.get(imported.importedName);
+                if (targetAlias) {
+                    currentModuleKey = targetKey;
+                    expandAlias(`${targetKey}:${imported.importedName}`, targetAlias, currentNode.typeArguments ?? []);
+                    continue;
+                }
+            }
+        }
+        const wrapperImport = info.wrapperImportsByLocalName.get(ident);
+        if (!wrapperImport)
+            break;
+        const args = currentNode.typeArguments ?? [];
+        if (args.length !== 1) {
+            return {
+                ok: false,
+                error: `ExtensionMethods wrapper '${ident}' must have exactly 1 type argument.\n` +
+                    `Found: ${args.length} in ${currentModuleKey}.`,
+            };
+        }
+        wrappers.push({
+            source: wrapperImport.source,
+            importedName: wrapperImport.importedName,
+            localName: ident,
+            aliasName: `__TsonicExt_${ident}`,
+        });
+        const nextNode = args[0];
+        if (!nextNode) {
+            return {
+                ok: false,
+                error: `ExtensionMethods wrapper '${ident}' is missing its type argument in ${currentModuleKey}.`,
+            };
+        }
+        currentNode = nextNode;
+    }
+    return { ok: true, value: wrappers };
+};
+const classifyExportKind = (module, name) => {
+    const isNamed = (stmt) => typeof stmt.name === "string";
+    const findDecl = () => {
+        for (const stmt of module.body) {
+            if (!("isExported" in stmt) ||
+                stmt.isExported !== true)
+                continue;
+            if (isNamed(stmt) && stmt.name === name)
+                return stmt;
+            if (stmt.kind === "variableDeclaration") {
+                for (const decl of stmt.declarations) {
+                    if (decl.name.kind === "identifierPattern" &&
+                        decl.name.name === name) {
+                        return stmt;
+                    }
+                }
+            }
+        }
+        return undefined;
+    };
+    const decl = findDecl();
+    if (!decl)
+        return "unknown";
+    switch (decl.kind) {
+        case "typeAliasDeclaration":
+        case "interfaceDeclaration":
+            return "type";
+        case "classDeclaration":
+        case "enumDeclaration":
+        case "functionDeclaration":
+        case "variableDeclaration":
+            return "value";
+        default:
+            return "unknown";
+    }
+};
+const moduleNamespaceToInternalSpecifier = (namespace) => {
+    const nsPath = moduleNamespacePath(namespace);
+    return `./${nsPath}/internal/index.js`;
+};
+const toClrTypeName = (namespace, typeName, arity) => {
+    const suffix = arity && arity > 0 ? `\`${arity}` : "";
+    return `${namespace}.${typeName}${suffix}`;
+};
+const toStableId = (assemblyName, clrName) => {
+    return `${assemblyName}:${clrName}`;
+};
+const primitiveSignatureType = (name) => {
+    const map = {
+        string: "System.String",
+        boolean: "System.Boolean",
+        number: "System.Double",
+        int: "System.Int32",
+        char: "System.Char",
+        null: "System.Object",
+        undefined: "System.Object",
+    };
+    return map[name] ?? name;
+};
+const isNumericValueType = (name) => {
+    return (name === "System.Int32" ||
+        name === "System.Double" ||
+        name === "System.Single" ||
+        name === "System.Decimal" ||
+        name === "System.Int64" ||
+        name === "System.Int16" ||
+        name === "System.UInt16" ||
+        name === "System.UInt32" ||
+        name === "System.UInt64" ||
+        name === "System.Byte" ||
+        name === "System.SByte");
+};
+const toSignatureType = (type, typeParametersInScope) => {
+    if (!type)
+        return "System.Object";
+    switch (type.kind) {
+        case "primitiveType":
+            return primitiveSignatureType(type.name);
+        case "literalType":
+            if (typeof type.value === "string")
+                return "System.String";
+            if (typeof type.value === "boolean")
+                return "System.Boolean";
+            if (typeof type.value === "number")
+                return "System.Double";
+            return "System.Object";
+        case "voidType":
+            return "System.Void";
+        case "neverType":
+        case "unknownType":
+        case "anyType":
+            return "System.Object";
+        case "typeParameterType":
+            return type.name;
+        case "arrayType":
+            return `${toSignatureType(type.elementType, typeParametersInScope)}[]`;
+        case "tupleType":
+        case "objectType":
+        case "functionType":
+        case "dictionaryType":
+            return "System.Object";
+        case "intersectionType":
+            return toSignatureType(type.types[0], typeParametersInScope);
+        case "unionType": {
+            const nonUndefined = type.types.filter((candidate) => {
+                return !(candidate.kind === "primitiveType" && candidate.name === "undefined");
+            });
+            if (nonUndefined.length === 1 && nonUndefined[0]) {
+                const single = toSignatureType(nonUndefined[0], typeParametersInScope);
+                if (isNumericValueType(single)) {
+                    return `System.Nullable\`1[[${single}]]`;
+                }
+                return single;
+            }
+            return "System.Object";
+        }
+        case "referenceType": {
+            if (typeParametersInScope.includes(type.name))
+                return type.name;
+            const normalizedName = normalizeTypeReferenceName(type.name, type.typeArguments?.length);
+            if (!type.typeArguments || type.typeArguments.length === 0) {
+                return normalizedName;
+            }
+            const args = type.typeArguments
+                .map((arg) => toSignatureType(arg, typeParametersInScope))
+                .join(",");
+            return `${normalizedName}[[${args}]]`;
+        }
+        default:
+            return "System.Object";
+    }
+};
+const buildParameterModifiers = (parameters) => {
+    const modifiers = parameters
+        .map((parameter, index) => {
+        if (parameter.passing === "value")
+            return undefined;
+        return { index, modifier: parameter.passing };
+    })
+        .filter((modifier) => modifier !== undefined);
+    return modifiers;
+};
+const makeMethodBinding = (opts) => {
+    const typeParameterScope = Array.from(new Set(opts.parameters
+        .map((parameter) => parameter.type?.kind === "typeParameterType"
+        ? parameter.type.name
+        : undefined)
+        .filter((name) => name !== undefined)));
+    const normalizedSignature = `${opts.methodName}|(${opts.parameters
+        .map((parameter) => toSignatureType(parameter.type, typeParameterScope))
+        .join(",")}):${toSignatureType(opts.returnType, typeParameterScope)}|static=${opts.isStatic ? "true" : "false"}`;
+    const stableId = `${toStableId(opts.declaringAssemblyName, opts.declaringClrType)}::method:${opts.methodName}|${normalizedSignature}`;
+    return {
+        stableId,
+        clrName: opts.methodName,
+        normalizedSignature,
+        arity: opts.arity,
+        parameterCount: opts.parameters.length,
+        isStatic: opts.isStatic,
+        isAbstract: opts.isAbstract ?? false,
+        isVirtual: opts.isVirtual ?? false,
+        isOverride: opts.isOverride ?? false,
+        isSealed: opts.isSealed ?? false,
+        declaringClrType: opts.declaringClrType,
+        declaringAssemblyName: opts.declaringAssemblyName,
+        parameterModifiers: opts.parameterModifiers.length > 0 ? opts.parameterModifiers : undefined,
+        isExtensionMethod: false,
+    };
+};
+const renderClassInternal = (declaration, namespace, memberOverrides) => {
+    const lines = [];
+    const typeParameterScope = (declaration.typeParameters ?? []).map((typeParameter) => typeParameter.name);
+    const typeParameters = printTypeParameters(declaration.typeParameters);
+    const markerName = `__tsonic_type_${sanitizeForBrand(namespace)}_${sanitizeForBrand(declaration.name)}`;
+    const heritageNames = [
+        declaration.superClass
+            ? renderPortableType(declaration.superClass, typeParameterScope)
+            : undefined,
+        ...declaration.implements.map((implementedType) => renderPortableType(implementedType, typeParameterScope)),
+    ]
+        .filter((name) => name !== undefined)
+        .map((name) => name.trim())
+        .filter((name) => name.length > 0 &&
+        name !== "unknown" &&
+        name !== "never" &&
+        name !== "void");
+    const extendsClause = heritageNames.length > 0
+        ? ` extends ${Array.from(new Set(heritageNames)).join(", ")}`
+        : "";
+    lines.push(`export interface ${declaration.name}$instance${typeParameters}${extendsClause} {`);
+    lines.push(`    readonly ${markerName}: never;`);
+    const instanceMembers = declaration.members.filter((member) => {
+        if (member.kind === "constructorDeclaration")
+            return false;
+        if ("isStatic" in member && member.isStatic)
+            return false;
+        return true;
+    });
+    for (const member of instanceMembers) {
+        if (member.kind === "methodDeclaration") {
+            lines.push(`    ${renderMethodSignature(member.name, member.typeParameters, member.parameters, member.returnType)}`);
+            continue;
+        }
+        if (member.kind === "propertyDeclaration") {
+            const memberOverride = memberOverrides.get(member.name);
+            const hasAccessorBody = member.getterBody !== undefined || member.setterBody !== undefined;
+            const hasGetter = hasAccessorBody
+                ? member.getterBody !== undefined
+                : true;
+            const hasSetter = hasAccessorBody
+                ? member.setterBody !== undefined
+                : !member.isReadonly;
+            const baseType = (memberOverride?.replaceWithSourceType
+                ? memberOverride.sourceTypeText
+                : undefined) ?? renderPortableType(member.type);
+            const wrappedType = applyWrappersToBaseType(baseType, memberOverride?.wrappers ?? []);
+            const memberType = memberOverride?.isOptional === true
+                ? ensureUndefinedInType(wrappedType)
+                : wrappedType;
+            if (hasGetter && !hasSetter) {
+                lines.push(`    readonly ${member.name}: ${memberType};`);
+                continue;
+            }
+            lines.push(`    ${member.name}: ${memberType};`);
+        }
+    }
+    lines.push("}");
+    lines.push("");
+    lines.push(`export const ${declaration.name}: {`);
+    lines.push(`    new(...args: unknown[]): ${declaration.name}${typeParameters};`);
+    const staticMembers = declaration.members.filter((member) => {
+        if (member.kind === "constructorDeclaration")
+            return false;
+        return "isStatic" in member && member.isStatic;
+    });
+    for (const member of staticMembers) {
+        if (member.kind === "methodDeclaration") {
+            lines.push(`    ${renderMethodSignature(member.name, member.typeParameters, member.parameters, member.returnType)}`);
+            continue;
+        }
+        if (member.kind === "propertyDeclaration") {
+            lines.push(`    ${member.name}: ${renderPortableType(member.type)};`);
+        }
+    }
+    lines.push("};");
+    lines.push("");
+    lines.push(`export type ${declaration.name}${typeParameters} = ${declaration.name}$instance${typeParameters};`);
+    lines.push("");
+    return lines;
+};
+const renderInterfaceInternal = (declaration, namespace, memberOverrides) => {
+    const lines = [];
+    const typeParameterScope = (declaration.typeParameters ?? []).map((typeParameter) => typeParameter.name);
+    const typeParameters = printTypeParameters(declaration.typeParameters);
+    const markerName = `__tsonic_type_${sanitizeForBrand(namespace)}_${sanitizeForBrand(declaration.name)}`;
+    const extendsNames = declaration.extends
+        .map((baseType) => renderPortableType(baseType, typeParameterScope).trim())
+        .filter((name) => name.length > 0 &&
+        name !== "unknown" &&
+        name !== "never" &&
+        name !== "void");
+    const extendsClause = extendsNames.length > 0
+        ? ` extends ${Array.from(new Set(extendsNames)).join(", ")}`
+        : "";
+    lines.push(`export interface ${declaration.name}$instance${typeParameters}${extendsClause} {`);
+    lines.push(`    readonly ${markerName}?: never;`);
+    for (const member of declaration.members) {
+        if (member.kind === "methodSignature") {
+            lines.push(`    ${renderMethodSignature(member.name, member.typeParameters, member.parameters, member.returnType)}`);
+            continue;
+        }
+        if (member.kind === "propertySignature") {
+            const memberOverride = memberOverrides.get(member.name);
+            const optionalBySource = memberOverride?.emitOptionalPropertySyntax === true &&
+                memberOverride.isOptional === true &&
+                !member.name.startsWith("__tsonic_type_");
+            const optionalMark = optionalBySource || member.isOptional ? "?" : "";
+            const baseType = (memberOverride?.replaceWithSourceType
+                ? memberOverride.sourceTypeText
+                : undefined) ?? renderPortableType(member.type);
+            const wrappedType = applyWrappersToBaseType(baseType, memberOverride?.wrappers ?? []);
+            const memberType = memberOverride?.isOptional && !optionalBySource
+                ? ensureUndefinedInType(wrappedType)
+                : wrappedType;
+            lines.push(`    ${member.name}${optionalMark}: ${memberType};`);
+        }
+    }
+    lines.push("}");
+    lines.push("");
+    lines.push(`export type ${declaration.name}${typeParameters} = ${declaration.name}$instance${typeParameters};`);
+    lines.push("");
+    return lines;
+};
+const renderEnumInternal = (declaration) => {
+    const lines = [];
+    lines.push(`export enum ${declaration.name} {`);
+    declaration.members.forEach((member, index) => {
+        lines.push(`    ${member.name} = ${index},`);
+    });
+    lines.push("}");
+    lines.push("");
+    return lines;
+};
+const renderStructuralAliasInternal = (declaration, namespace, memberOverrides) => {
+    if (declaration.type.kind !== "objectType")
+        return [];
+    const lines = [];
+    const arity = declaration.typeParameters?.length ?? 0;
+    const typeParameters = printTypeParameters(declaration.typeParameters);
+    const internalAliasName = `${declaration.name}__Alias${arity > 0 ? `_${arity}` : ""}`;
+    const markerName = `__tsonic_type_${sanitizeForBrand(namespace)}_${sanitizeForBrand(internalAliasName)}`;
+    lines.push(`export interface ${internalAliasName}$instance${typeParameters} {`);
+    lines.push(`    readonly ${markerName}?: never;`);
+    for (const member of declaration.type.members) {
+        if (member.kind === "methodSignature") {
+            lines.push(`    ${renderMethodSignature(member.name, member.typeParameters, member.parameters, member.returnType)}`);
+            continue;
+        }
+        if (member.kind === "propertySignature") {
+            const memberOverride = memberOverrides.get(member.name);
+            const optionalMark = member.isOptional ? "?" : "";
+            const baseType = (memberOverride?.replaceWithSourceType
+                ? memberOverride.sourceTypeText
+                : undefined) ?? renderPortableType(member.type);
+            const wrappedType = applyWrappersToBaseType(baseType, memberOverride?.wrappers ?? []);
+            const memberType = memberOverride?.isOptional === true
+                ? ensureUndefinedInType(wrappedType)
+                : wrappedType;
+            lines.push(`    ${member.name}${optionalMark}: ${memberType};`);
+        }
+    }
+    lines.push("}");
+    lines.push("");
+    lines.push(`export type ${internalAliasName}${typeParameters} = ${internalAliasName}$instance${typeParameters};`);
+    lines.push("");
+    return lines;
+};
+const renderContainerInternal = (entry) => {
+    const lines = [];
+    lines.push(`export abstract class ${entry.module.className}$instance {`);
+    for (const method of entry.methods) {
+        lines.push(`    static ${renderMethodSignature(method.localName, method.declaration.typeParameters, method.declaration.parameters, method.declaration.returnType)}`);
+    }
+    for (const variable of entry.variables) {
+        lines.push(`    static ${variable.localName}: ${renderPortableType(variable.declarator?.type)};`);
+    }
+    lines.push("}");
+    lines.push("");
+    lines.push(`export type ${entry.module.className} = ${entry.module.className}$instance;`);
+    lines.push("");
+    return lines;
+};
+const buildTypeBindingFromClass = (declaration, namespace, assemblyName) => {
+    const declaringClrType = toClrTypeName(namespace, declaration.name, declaration.typeParameters?.length ?? 0);
+    const typeStableId = toStableId(assemblyName, declaringClrType);
+    const typeParameterScope = declaration.typeParameters?.map((typeParameter) => typeParameter.name) ??
+        [];
+    const methods = [];
+    const properties = [];
+    const constructors = [];
+    for (const member of declaration.members) {
+        if (member.kind === "constructorDeclaration") {
+            constructors.push({
+                normalizedSignature: `.ctor|(${member.parameters
+                    .map((parameter) => toSignatureType(parameter.type, typeParameterScope))
+                    .join(",")})|static=false`,
+                isStatic: false,
+                parameterCount: member.parameters.length,
+            });
+            continue;
+        }
+        if (member.kind === "methodDeclaration") {
+            methods.push(makeMethodBinding({
+                declaringClrType,
+                declaringAssemblyName: assemblyName,
+                methodName: member.name,
+                parameters: member.parameters,
+                returnType: member.returnType,
+                arity: member.typeParameters?.length ?? 0,
+                parameterModifiers: buildParameterModifiers(member.parameters),
+                isStatic: member.isStatic,
+                isAbstract: member.body === undefined,
+                isVirtual: member.isVirtual,
+                isOverride: member.isOverride,
+            }));
+            continue;
+        }
+        if (member.kind === "propertyDeclaration") {
+            const hasAccessorBody = member.getterBody !== undefined || member.setterBody !== undefined;
+            const hasGetter = hasAccessorBody
+                ? member.getterBody !== undefined
+                : true;
+            const hasSetter = hasAccessorBody
+                ? member.setterBody !== undefined
+                : !member.isReadonly;
+            const propertyType = toSignatureType(member.type, typeParameterScope);
+            properties.push({
+                stableId: `${typeStableId}::property:${member.name}`,
+                clrName: member.name,
+                normalizedSignature: `${member.name}|:${propertyType}|static=${member.isStatic ? "true" : "false"}|accessor=${hasGetter && hasSetter ? "getset" : hasSetter ? "set" : "get"}`,
+                isStatic: member.isStatic,
+                isAbstract: member.getterBody === undefined && member.setterBody === undefined
+                    ? false
+                    : false,
+                isVirtual: member.isVirtual ?? false,
+                isOverride: member.isOverride ?? false,
+                isIndexer: false,
+                hasGetter,
+                hasSetter,
+                declaringClrType,
+                declaringAssemblyName: assemblyName,
+            });
+        }
+    }
+    return {
+        stableId: typeStableId,
+        clrName: declaringClrType,
+        assemblyName,
+        kind: declaration.isStruct ? "Struct" : "Class",
+        accessibility: "Public",
+        isAbstract: false,
+        isSealed: false,
+        isStatic: false,
+        arity: declaration.typeParameters?.length ?? 0,
+        typeParameters: declaration.typeParameters?.map((typeParameter) => typeParameter.name) ??
+            [],
+        methods,
+        properties,
+        fields: [],
+        events: [],
+        constructors: constructors.length > 0
+            ? constructors
+            : [
+                {
+                    normalizedSignature: ".ctor|()|static=false",
+                    isStatic: false,
+                    parameterCount: 0,
+                },
+            ],
+    };
+};
+const buildTypeBindingFromInterface = (declaration, namespace, assemblyName) => {
+    const declaringClrType = toClrTypeName(namespace, declaration.name, declaration.typeParameters?.length ?? 0);
+    const typeStableId = toStableId(assemblyName, declaringClrType);
+    const typeParameterScope = declaration.typeParameters?.map((typeParameter) => typeParameter.name) ??
+        [];
+    const methods = [];
+    const properties = [];
+    for (const member of declaration.members) {
+        if (member.kind === "methodSignature") {
+            methods.push(makeMethodBinding({
+                declaringClrType,
+                declaringAssemblyName: assemblyName,
+                methodName: member.name,
+                parameters: member.parameters,
+                returnType: member.returnType,
+                arity: member.typeParameters?.length ?? 0,
+                parameterModifiers: buildParameterModifiers(member.parameters),
+                isStatic: false,
+                isAbstract: true,
+            }));
+            continue;
+        }
+        properties.push({
+            stableId: `${typeStableId}::property:${member.name}`,
+            clrName: member.name,
+            normalizedSignature: `${member.name}|:${toSignatureType(member.type, typeParameterScope)}|static=false|accessor=${member.isReadonly ? "get" : "getset"}`,
+            isStatic: false,
+            isAbstract: true,
+            isVirtual: false,
+            isOverride: false,
+            isIndexer: false,
+            hasGetter: true,
+            hasSetter: !member.isReadonly,
+            declaringClrType,
+            declaringAssemblyName: assemblyName,
+        });
+    }
+    return {
+        stableId: typeStableId,
+        clrName: declaringClrType,
+        assemblyName,
+        kind: declaration.isStruct ? "Struct" : "Interface",
+        accessibility: "Public",
+        isAbstract: false,
+        isSealed: false,
+        isStatic: false,
+        arity: declaration.typeParameters?.length ?? 0,
+        typeParameters: declaration.typeParameters?.map((typeParameter) => typeParameter.name) ??
+            [],
+        methods,
+        properties,
+        fields: [],
+        events: [],
+        constructors: [],
+    };
+};
+const buildTypeBindingFromEnum = (declaration, namespace, assemblyName) => {
+    const declaringClrType = toClrTypeName(namespace, declaration.name);
+    const typeStableId = toStableId(assemblyName, declaringClrType);
+    const fields = declaration.members.map((member) => ({
+        stableId: `${typeStableId}::field:${member.name}`,
+        clrName: member.name,
+        normalizedSignature: `${member.name}|${declaringClrType}|static=true|const=true`,
+        isStatic: true,
+        isReadOnly: true,
+        isLiteral: true,
+        declaringClrType,
+        declaringAssemblyName: assemblyName,
+    }));
+    return {
+        stableId: typeStableId,
+        clrName: declaringClrType,
+        assemblyName,
+        kind: "Enum",
+        accessibility: "Public",
+        isAbstract: false,
+        isSealed: true,
+        isStatic: false,
+        arity: 0,
+        typeParameters: [],
+        methods: [],
+        properties: [],
+        fields,
+        events: [],
+        constructors: [],
+    };
+};
+const buildTypeBindingFromStructuralAlias = (declaration, namespace, assemblyName) => {
+    if (declaration.type.kind !== "objectType")
+        return undefined;
+    const arity = declaration.typeParameters?.length ?? 0;
+    const internalAliasName = `${declaration.name}__Alias`;
+    const declaringClrType = toClrTypeName(namespace, internalAliasName, arity);
+    const typeStableId = toStableId(assemblyName, declaringClrType);
+    const typeParameterScope = declaration.typeParameters?.map((typeParameter) => typeParameter.name) ??
+        [];
+    const methods = [];
+    const properties = [];
+    for (const member of declaration.type.members) {
+        if (member.kind === "methodSignature") {
+            methods.push(makeMethodBinding({
+                declaringClrType,
+                declaringAssemblyName: assemblyName,
+                methodName: member.name,
+                parameters: member.parameters,
+                returnType: member.returnType,
+                arity: member.typeParameters?.length ?? 0,
+                parameterModifiers: buildParameterModifiers(member.parameters),
+                isStatic: false,
+                isAbstract: true,
+            }));
+            continue;
+        }
+        properties.push({
+            stableId: `${typeStableId}::property:${member.name}`,
+            clrName: member.name,
+            normalizedSignature: `${member.name}|:${toSignatureType(member.type, typeParameterScope)}|static=false|accessor=${member.isReadonly ? "get" : "getset"}`,
+            isStatic: false,
+            isAbstract: true,
+            isVirtual: false,
+            isOverride: false,
+            isIndexer: false,
+            hasGetter: true,
+            hasSetter: !member.isReadonly,
+            declaringClrType,
+            declaringAssemblyName: assemblyName,
+        });
+    }
+    return {
+        stableId: typeStableId,
+        clrName: declaringClrType,
+        assemblyName,
+        kind: declaration.isStruct ? "Struct" : "Class",
+        accessibility: "Public",
+        isAbstract: false,
+        isSealed: false,
+        isStatic: false,
+        arity,
+        typeParameters: declaration.typeParameters?.map((typeParameter) => typeParameter.name) ??
+            [],
+        methods,
+        properties,
+        fields: [],
+        events: [],
+        constructors: [],
+    };
+};
+const buildTypeBindingFromContainer = (entry, namespace, assemblyName) => {
+    const declaringClrType = toClrTypeName(namespace, entry.module.className);
+    const typeStableId = toStableId(assemblyName, declaringClrType);
+    const methods = entry.methods.map((method) => makeMethodBinding({
+        declaringClrType,
+        declaringAssemblyName: assemblyName,
+        methodName: method.localName,
+        parameters: method.declaration.parameters,
+        returnType: method.declaration.returnType,
+        arity: method.declaration.typeParameters?.length ?? 0,
+        parameterModifiers: buildParameterModifiers(method.declaration.parameters),
+        isStatic: true,
+    }));
+    const properties = entry.variables.map((variable) => ({
+        stableId: `${typeStableId}::property:${variable.localName}`,
+        clrName: variable.localName,
+        normalizedSignature: `${variable.localName}|:${toSignatureType(variable.declarator?.type, [])}|static=true|accessor=getset`,
+        isStatic: true,
+        isAbstract: false,
+        isVirtual: false,
+        isOverride: false,
+        isIndexer: false,
+        hasGetter: true,
+        hasSetter: true,
+        declaringClrType,
+        declaringAssemblyName: assemblyName,
+    }));
+    return {
+        stableId: typeStableId,
+        clrName: declaringClrType,
+        assemblyName,
+        kind: "Class",
+        accessibility: "Public",
+        isAbstract: true,
+        isSealed: false,
+        isStatic: true,
+        arity: 0,
+        typeParameters: [],
+        methods,
+        properties,
+        fields: [],
+        events: [],
+        constructors: [],
+    };
+};
+const collectNamespacePlans = (modules, assemblyName, rootNamespace, sourceIndexByFileKey) => {
+    const modulesByNamespace = new Map();
+    modulesByNamespace.set(rootNamespace, []);
+    const modulesByFileKey = new Map();
+    for (const module of modules) {
+        const syntheticAnonymousModule = module.filePath.startsWith("__tsonic/") &&
+            module.body.some((statement) => statement.kind === "classDeclaration" &&
+                statement.name.startsWith("__Anon_"));
+        if (module.filePath.startsWith("__tsonic/") && !syntheticAnonymousModule) {
+            continue;
+        }
+        const list = modulesByNamespace.get(module.namespace) ?? [];
+        list.push(module);
+        modulesByNamespace.set(module.namespace, list);
+        modulesByFileKey.set(normalizeModuleFileKey(module.filePath), module);
+    }
+    const plans = [];
+    for (const [namespace, moduleList] of Array.from(modulesByNamespace.entries())) {
+        const typeDeclarations = [];
+        const moduleContainers = [];
+        const valueExportsMap = new Map();
+        const seenTypeDeclarationKeys = new Set();
+        const sourceAliasLines = new Set();
+        const sourceAliasInternalImports = new Set();
+        const memberOverrides = [];
+        const wrapperImportByAlias = new Map();
+        const registerValueExport = (valueExport) => {
+            const existing = valueExportsMap.get(valueExport.exportName);
+            if (!existing) {
+                valueExportsMap.set(valueExport.exportName, valueExport);
+                return { ok: true, value: undefined };
+            }
+            const sameBinding = existing.binding.kind === valueExport.binding.kind &&
+                existing.binding.clrName === valueExport.binding.clrName &&
+                existing.binding.declaringClrType ===
+                    valueExport.binding.declaringClrType &&
+                existing.binding.declaringAssemblyName ===
+                    valueExport.binding.declaringAssemblyName;
+            const normalizeFunctionFacade = (facade) => {
+                const declaration = facade.declaration;
+                const typeParametersText = printTypeParameters(declaration.typeParameters);
+                const typeParameterNames = declaration.typeParameters?.map((typeParameter) => typeParameter.name) ?? [];
+                const parametersText = renderUnknownParameters(declaration.parameters, typeParameterNames);
+                const returnTypeText = renderPortableType(declaration.returnType, typeParameterNames);
+                const sourceSignatures = (facade.sourceSignatures ?? [])
+                    .map((signature) => `${signature.typeParametersText}(${signature.parametersText}):${signature.returnTypeText}`)
+                    .sort((left, right) => left.localeCompare(right))
+                    .join("||");
+                return `${typeParametersText}(${parametersText}):${returnTypeText}|source=${sourceSignatures}`;
+            };
+            const normalizeVariableFacade = (declarator) => renderPortableType(declarator?.type);
+            const sameFacade = (() => {
+                if (existing.facade.kind !== valueExport.facade.kind)
+                    return false;
+                if (existing.facade.kind === "function" &&
+                    valueExport.facade.kind === "function") {
+                    return (normalizeFunctionFacade(existing.facade) ===
+                        normalizeFunctionFacade(valueExport.facade));
+                }
+                if (existing.facade.kind === "variable" &&
+                    valueExport.facade.kind === "variable") {
+                    return (normalizeVariableFacade(existing.facade.declarator) ===
+                        normalizeVariableFacade(valueExport.facade.declarator));
+                }
+                return false;
+            })();
+            if (sameBinding && sameFacade) {
+                return { ok: true, value: undefined };
+            }
+            return {
+                ok: false,
+                error: `Conflicting value export '${valueExport.exportName}' in namespace ${namespace}.\n` +
+                    "First-party bindings generation requires each exported value name to map deterministically to exactly one CLR member.",
+            };
+        };
+        const registerWrapperImports = (wrappers, moduleFilePath) => {
+            for (const wrapper of wrappers) {
+                const existing = wrapperImportByAlias.get(wrapper.aliasName);
+                if (existing) {
+                    if (existing.source !== wrapper.source ||
+                        existing.importedName !== wrapper.importedName) {
+                        return {
+                            ok: false,
+                            error: `Conflicting wrapper import alias '${wrapper.aliasName}' while generating ${moduleFilePath}.\n` +
+                                `- ${existing.importedName} from '${existing.source}'\n` +
+                                `- ${wrapper.importedName} from '${wrapper.source}'\n` +
+                                "Disambiguate ExtensionMethods aliases in source code.",
+                        };
+                    }
+                    continue;
+                }
+                wrapperImportByAlias.set(wrapper.aliasName, wrapper);
+            }
+            return { ok: true, value: undefined };
+        };
+        for (const module of moduleList.sort((left, right) => left.filePath.localeCompare(right.filePath))) {
+            const moduleKey = normalizeModuleFileKey(module.filePath);
+            const sourceIndex = sourceIndexByFileKey.get(moduleKey);
+            if (sourceIndex) {
+                const exportedAliasDecls = module.body.filter((stmt) => stmt.kind === "typeAliasDeclaration" && stmt.isExported);
+                for (const alias of exportedAliasDecls) {
+                    const sourceAlias = sourceIndex.typeAliasesByName.get(alias.name);
+                    const sourceTypeParams = sourceAlias?.typeParametersText ??
+                        printTypeParameters(alias.typeParameters);
+                    if (alias.type.kind === "objectType") {
+                        const arity = alias.typeParameters?.length ?? 0;
+                        const internalName = `${alias.name}__Alias${arity > 0 ? `_${arity}` : ""}`;
+                        const typeArgs = sourceAlias && sourceAlias.typeParameterNames.length > 0
+                            ? `<${sourceAlias.typeParameterNames.join(", ")}>`
+                            : alias.typeParameters && alias.typeParameters.length > 0
+                                ? `<${alias.typeParameters.map((tp) => tp.name).join(", ")}>`
+                                : "";
+                        sourceAliasLines.add(`export type ${alias.name}${sourceTypeParams} = ${internalName}${typeArgs};`);
+                        sourceAliasInternalImports.add(internalName);
+                        continue;
+                    }
+                    const rhs = renderPortableType(alias.type, alias.typeParameters?.map((tp) => tp.name) ?? []);
+                    const shouldPreferSourceAliasText = sourceAlias !== undefined &&
+                        !typeNodeUsesImportedTypeNames(sourceAlias.type, sourceIndex.typeImportsByLocalName) &&
+                        /__\d+\b|\$instance\b/.test(rhs);
+                    sourceAliasLines.add(`export type ${alias.name}${sourceTypeParams} = ${shouldPreferSourceAliasText ? sourceAlias.typeText : rhs};`);
+                }
+                const exportedClasses = module.body.filter((stmt) => stmt.kind === "classDeclaration" && stmt.isExported);
+                const exportedInterfaces = module.body.filter((stmt) => stmt.kind === "interfaceDeclaration" && stmt.isExported);
+                const exportedAliases = module.body.filter((stmt) => stmt.kind === "typeAliasDeclaration" && stmt.isExported);
+                for (const cls of exportedClasses) {
+                    const sourceMembers = sourceIndex.memberTypesByClassAndMember.get(cls.name);
+                    if (!sourceMembers)
+                        continue;
+                    for (const member of cls.members) {
+                        if (member.kind !== "propertyDeclaration")
+                            continue;
+                        if (member.isStatic || member.accessibility === "private")
+                            continue;
+                        const sourceMember = sourceMembers.get(member.name);
+                        if (!sourceMember)
+                            continue;
+                        const wrappersResult = collectExtensionWrapperImportsFromSourceType({
+                            startModuleKey: moduleKey,
+                            typeNode: sourceMember.typeNode,
+                            sourceIndexByFileKey,
+                            modulesByFileKey,
+                        });
+                        if (!wrappersResult.ok)
+                            return wrappersResult;
+                        const wrappers = wrappersResult.value;
+                        const canUseSourceTypeText = !typeNodeUsesImportedTypeNames(sourceMember.typeNode, sourceIndex.typeImportsByLocalName);
+                        if (!canUseSourceTypeText &&
+                            wrappers.length === 0 &&
+                            !sourceMember.isOptional) {
+                            continue;
+                        }
+                        const wrapperRegistered = registerWrapperImports(wrappers, module.filePath);
+                        if (!wrapperRegistered.ok)
+                            return wrapperRegistered;
+                        memberOverrides.push({
+                            className: cls.name,
+                            memberName: member.name,
+                            sourceTypeText: canUseSourceTypeText
+                                ? sourceMember.typeText
+                                : undefined,
+                            replaceWithSourceType: canUseSourceTypeText,
+                            isOptional: sourceMember.isOptional,
+                            wrappers,
+                        });
+                    }
+                }
+                for (const iface of exportedInterfaces) {
+                    const sourceMembers = sourceIndex.memberTypesByClassAndMember.get(iface.name);
+                    if (!sourceMembers)
+                        continue;
+                    for (const member of iface.members) {
+                        if (member.kind !== "propertySignature")
+                            continue;
+                        const sourceMember = sourceMembers.get(member.name);
+                        if (!sourceMember)
+                            continue;
+                        const wrappersResult = collectExtensionWrapperImportsFromSourceType({
+                            startModuleKey: moduleKey,
+                            typeNode: sourceMember.typeNode,
+                            sourceIndexByFileKey,
+                            modulesByFileKey,
+                        });
+                        if (!wrappersResult.ok)
+                            return wrappersResult;
+                        const wrappers = wrappersResult.value;
+                        const canUseSourceTypeText = !typeNodeUsesImportedTypeNames(sourceMember.typeNode, sourceIndex.typeImportsByLocalName);
+                        if (!canUseSourceTypeText && wrappers.length === 0)
+                            continue;
+                        const wrapperRegistered = registerWrapperImports(wrappers, module.filePath);
+                        if (!wrapperRegistered.ok)
+                            return wrapperRegistered;
+                        memberOverrides.push({
+                            className: iface.name,
+                            memberName: member.name,
+                            sourceTypeText: canUseSourceTypeText
+                                ? sourceMember.typeText
+                                : undefined,
+                            replaceWithSourceType: canUseSourceTypeText,
+                            isOptional: sourceMember.isOptional,
+                            emitOptionalPropertySyntax: true,
+                            wrappers,
+                        });
+                    }
+                }
+                for (const alias of exportedAliases) {
+                    const sourceAlias = sourceIndex.typeAliasesByName.get(alias.name);
+                    if (!sourceAlias)
+                        continue;
+                    const aliasType = unwrapParens(sourceAlias.type);
+                    if (!ts.isTypeLiteralNode(aliasType))
+                        continue;
+                    const arity = sourceAlias.typeParameterNames.length;
+                    const internalAliasName = `${alias.name}__Alias${arity > 0 ? `_${arity}` : ""}`;
+                    for (const member of aliasType.members) {
+                        if (!ts.isPropertySignature(member))
+                            continue;
+                        if (!member.name || !member.type)
+                            continue;
+                        const memberName = getPropertyNameText(member.name);
+                        if (!memberName)
+                            continue;
+                        const wrappersResult = collectExtensionWrapperImportsFromSourceType({
+                            startModuleKey: moduleKey,
+                            typeNode: member.type,
+                            sourceIndexByFileKey,
+                            modulesByFileKey,
+                        });
+                        if (!wrappersResult.ok)
+                            return wrappersResult;
+                        const wrappers = wrappersResult.value;
+                        const canUseSourceTypeText = !typeNodeUsesImportedTypeNames(member.type, sourceIndex.typeImportsByLocalName);
+                        if (!canUseSourceTypeText && wrappers.length === 0)
+                            continue;
+                        const wrapperRegistered = registerWrapperImports(wrappers, module.filePath);
+                        if (!wrapperRegistered.ok)
+                            return wrapperRegistered;
+                        memberOverrides.push({
+                            className: internalAliasName,
+                            memberName,
+                            sourceTypeText: canUseSourceTypeText
+                                ? printTypeNodeText(member.type, member.getSourceFile())
+                                : undefined,
+                            replaceWithSourceType: canUseSourceTypeText,
+                            isOptional: member.questionToken !== undefined,
+                            wrappers,
+                        });
+                    }
+                }
+            }
+            for (const exportItem of module.exports) {
+                if (exportItem.kind !== "reexport")
+                    continue;
+                const resolved = resolveExportedDeclaration(module, exportItem.name, modulesByFileKey);
+                if (!resolved.ok)
+                    return resolved;
+                const declaration = resolved.value.declaration;
+                const declarationModule = resolved.value.module;
+                const exportKind = classifyDeclarationKind(declaration, declarationModule.filePath, exportItem.name);
+                if (!exportKind.ok)
+                    return exportKind;
+                if (exportKind.value === "function") {
+                    const functionDeclaration = declaration.kind === "functionDeclaration"
+                        ? declaration
+                        : undefined;
+                    if (!functionDeclaration) {
+                        return {
+                            ok: false,
+                            error: `Invalid function export '${exportItem.name}' in ${declarationModule.filePath}: expected function declaration.`,
+                        };
+                    }
+                    const registered = registerValueExport({
+                        exportName: exportItem.name,
+                        binding: {
+                            kind: "method",
+                            clrName: resolved.value.clrName,
+                            declaringClrType: toClrTypeName(declarationModule.namespace, declarationModule.className),
+                            declaringAssemblyName: assemblyName,
+                        },
+                        facade: {
+                            kind: "function",
+                            declaration: functionDeclaration,
+                            sourceSignatures: sourceIndexByFileKey
+                                .get(normalizeModuleFileKey(declarationModule.filePath))
+                                ?.exportedFunctionSignaturesByName.get(resolved.value.clrName) ?? [],
+                        },
+                    });
+                    if (!registered.ok)
+                        return registered;
+                    continue;
+                }
+                if (exportKind.value === "variable") {
+                    const declarationStatement = declaration.kind === "variableDeclaration"
+                        ? declaration
+                        : undefined;
+                    if (!declarationStatement) {
+                        return {
+                            ok: false,
+                            error: `Invalid variable export '${exportItem.name}' in ${declarationModule.filePath}: expected variable declaration.`,
+                        };
+                    }
+                    const declarator = declarationStatement.declarations.find((candidate) => candidate.name.kind === "identifierPattern" &&
+                        candidate.name.name === resolved.value.clrName);
+                    const registered = registerValueExport({
+                        exportName: exportItem.name,
+                        binding: {
+                            kind: "field",
+                            clrName: resolved.value.clrName,
+                            declaringClrType: toClrTypeName(declarationModule.namespace, declarationModule.className),
+                            declaringAssemblyName: assemblyName,
+                        },
+                        facade: {
+                            kind: "variable",
+                            declarator: declarator && declarator.name.kind === "identifierPattern"
+                                ? {
+                                    kind: declarator.kind,
+                                    name: declarator.name,
+                                    type: declarator.type,
+                                }
+                                : undefined,
+                        },
+                    });
+                    if (!registered.ok)
+                        return registered;
+                    continue;
+                }
+                if (exportKind.value === "class" ||
+                    exportKind.value === "interface" ||
+                    exportKind.value === "enum" ||
+                    exportKind.value === "typeAlias") {
+                    if (exportKind.value === "typeAlias" &&
+                        declaration.kind === "typeAliasDeclaration" &&
+                        declaration.type.kind !== "objectType") {
+                        continue;
+                    }
+                    const typeKey = `${declarationModule.namespace}|${declarationModule.className}|${resolved.value.clrName}|${exportKind.value}`;
+                    if (seenTypeDeclarationKeys.has(typeKey))
+                        continue;
+                    seenTypeDeclarationKeys.add(typeKey);
+                    typeDeclarations.push({
+                        exportName: exportItem.name,
+                        localName: resolved.value.clrName,
+                        kind: exportKind.value,
+                        declaration,
+                        declaringNamespace: declarationModule.namespace,
+                        declaringClassName: declarationModule.className,
+                        declaringFilePath: declarationModule.filePath,
+                    });
+                }
+            }
+            const moduleExports = collectModuleExports(module, modulesByFileKey);
+            if (!moduleExports.ok)
+                return moduleExports;
+            const containerMethods = [];
+            const containerVariables = [];
+            if (module.filePath.startsWith("__tsonic/")) {
+                for (const statement of module.body) {
+                    if (statement.kind !== "classDeclaration")
+                        continue;
+                    if (!statement.name.startsWith("__Anon_"))
+                        continue;
+                    const key = `${statement.name}|class`;
+                    if (seenTypeDeclarationKeys.has(key))
+                        continue;
+                    seenTypeDeclarationKeys.add(key);
+                    typeDeclarations.push({
+                        exportName: statement.name,
+                        localName: statement.name,
+                        kind: "class",
+                        declaration: statement,
+                        declaringNamespace: module.namespace,
+                        declaringClassName: module.className,
+                        declaringFilePath: module.filePath,
+                    });
+                }
+            }
+            for (const symbol of moduleExports.value) {
+                if (symbol.kind === "class" ||
+                    symbol.kind === "interface" ||
+                    symbol.kind === "enum" ||
+                    symbol.kind === "typeAlias") {
+                    if (symbol.kind === "typeAlias" &&
+                        symbol.declaration.kind === "typeAliasDeclaration" &&
+                        symbol.declaration.type.kind !== "objectType") {
+                        continue;
+                    }
+                    const key = `${symbol.declaringNamespace}|${symbol.declaringClassName}|${symbol.localName}|${symbol.kind}`;
+                    if (!seenTypeDeclarationKeys.has(key)) {
+                        seenTypeDeclarationKeys.add(key);
+                        typeDeclarations.push(symbol);
+                    }
+                }
+                if (symbol.kind === "function") {
+                    const functionDeclaration = symbol.declaration.kind === "functionDeclaration"
+                        ? symbol.declaration
+                        : undefined;
+                    if (!functionDeclaration)
+                        continue;
+                    const isLocalContainerMember = symbol.declaringNamespace === module.namespace &&
+                        symbol.declaringClassName === module.className;
+                    if (isLocalContainerMember) {
+                        containerMethods.push({
+                            exportName: symbol.exportName,
+                            localName: symbol.localName,
+                            declaration: functionDeclaration,
+                        });
+                    }
+                    const registered = registerValueExport({
+                        exportName: symbol.exportName,
+                        binding: {
+                            kind: "method",
+                            clrName: symbol.localName,
+                            declaringClrType: toClrTypeName(symbol.declaringNamespace, symbol.declaringClassName),
+                            declaringAssemblyName: assemblyName,
+                        },
+                        facade: {
+                            kind: "function",
+                            declaration: functionDeclaration,
+                            sourceSignatures: sourceIndexByFileKey
+                                .get(normalizeModuleFileKey(symbol.declaringFilePath))
+                                ?.exportedFunctionSignaturesByName.get(symbol.localName) ??
+                                [],
+                        },
+                    });
+                    if (!registered.ok)
+                        return registered;
+                    continue;
+                }
+                if (symbol.kind === "variable") {
+                    const declaration = symbol.declaration.kind === "variableDeclaration"
+                        ? symbol.declaration
+                        : undefined;
+                    if (!declaration)
+                        continue;
+                    const declarator = declaration.declarations.find((candidate) => candidate.name.kind === "identifierPattern" &&
+                        candidate.name.name === symbol.localName);
+                    const isLocalContainerMember = symbol.declaringNamespace === module.namespace &&
+                        symbol.declaringClassName === module.className;
+                    if (isLocalContainerMember) {
+                        containerVariables.push({
+                            exportName: symbol.exportName,
+                            localName: symbol.localName,
+                            declaration,
+                            declarator: declarator && declarator.name.kind === "identifierPattern"
+                                ? {
+                                    kind: declarator.kind,
+                                    name: declarator.name,
+                                    type: declarator.type,
+                                }
+                                : undefined,
+                        });
+                    }
+                    const registered = registerValueExport({
+                        exportName: symbol.exportName,
+                        binding: {
+                            kind: "field",
+                            clrName: symbol.localName,
+                            declaringClrType: toClrTypeName(symbol.declaringNamespace, symbol.declaringClassName),
+                            declaringAssemblyName: assemblyName,
+                        },
+                        facade: {
+                            kind: "variable",
+                            declarator: declarator && declarator.name.kind === "identifierPattern"
+                                ? {
+                                    kind: declarator.kind,
+                                    name: declarator.name,
+                                    type: declarator.type,
+                                }
+                                : undefined,
+                        },
+                    });
+                    if (!registered.ok)
+                        return registered;
+                }
+            }
+            if (containerMethods.length > 0 || containerVariables.length > 0) {
+                moduleContainers.push({
+                    module,
+                    methods: containerMethods,
+                    variables: containerVariables,
+                });
+            }
+        }
+        plans.push({
+            namespace,
+            typeDeclarations: typeDeclarations.sort((left, right) => left.exportName.localeCompare(right.exportName)),
+            moduleContainers: moduleContainers.sort((left, right) => left.module.className.localeCompare(right.module.className)),
+            sourceAliasLines: Array.from(sourceAliasLines.values()).sort((left, right) => left.localeCompare(right)),
+            sourceAliasInternalImports: Array.from(sourceAliasInternalImports.values()).sort((left, right) => left.localeCompare(right)),
+            memberOverrides: memberOverrides.sort((left, right) => {
+                const classCmp = left.className.localeCompare(right.className);
+                if (classCmp !== 0)
+                    return classCmp;
+                return left.memberName.localeCompare(right.memberName);
+            }),
+            wrapperImports: Array.from(wrapperImportByAlias.values()).sort((left, right) => left.aliasName.localeCompare(right.aliasName)),
+            valueExports: Array.from(valueExportsMap.values()).sort((left, right) => left.exportName.localeCompare(right.exportName)),
+        });
+    }
+    return {
+        ok: true,
+        value: plans.sort((left, right) => left.namespace.localeCompare(right.namespace)),
+    };
+};
+const collectEntrypointReexports = (entryModule, modulesByFileKey) => {
+    const grouped = new Map();
+    for (const exported of entryModule.exports) {
+        if (exported.kind !== "reexport")
+            continue;
+        const targetModule = resolveLocalModuleFile(exported.fromModule, entryModule.filePath, modulesByFileKey);
+        if (!targetModule) {
+            return {
+                ok: false,
+                error: `Failed to resolve re-export '${exported.name}' from '${exported.fromModule}' in ${entryModule.filePath}.`,
+            };
+        }
+        if (targetModule.namespace === entryModule.namespace)
+            continue;
+        const kind = classifyExportKind(targetModule, exported.originalName);
+        if (kind === "unknown") {
+            return {
+                ok: false,
+                error: `Failed to classify re-export '${exported.name}' from '${exported.fromModule}' in ${entryModule.filePath}.`,
+            };
+        }
+        const moduleSpecifier = `./${moduleNamespacePath(targetModule.namespace)}.js`;
+        const key = `${moduleSpecifier}|${kind}`;
+        const specifier = exported.name === exported.originalName
+            ? exported.name
+            : `${exported.originalName} as ${exported.name}`;
+        const list = grouped.get(key) ?? [];
+        list.push(specifier);
+        grouped.set(key, list);
+    }
+    const dtsStatements = [];
+    const jsValueStatements = [];
+    for (const [key, specs] of Array.from(grouped.entries()).sort((a, b) => a[0].localeCompare(b[0]))) {
+        const [moduleSpecifier, kind] = key.split("|");
+        const unique = Array.from(new Set(specs)).sort((a, b) => a.localeCompare(b));
+        if (kind === "type") {
+            dtsStatements.push(`export type { ${unique.join(", ")} } from '${moduleSpecifier}';`);
+            continue;
+        }
+        const statement = `export { ${unique.join(", ")} } from '${moduleSpecifier}';`;
+        dtsStatements.push(statement);
+        jsValueStatements.push(statement);
+    }
+    return {
+        ok: true,
+        value: { dtsStatements, jsValueStatements },
+    };
+};
+const writeNamespaceArtifacts = (config, outDir, plan, entrypointReexports) => {
+    const namespacePath = moduleNamespacePath(plan.namespace);
+    const namespaceDir = join(outDir, namespacePath);
+    const internalDir = join(namespaceDir, "internal");
+    mkdirSync(internalDir, { recursive: true });
+    const internalIndexPath = join(internalDir, "index.d.ts");
+    const facadeDtsPath = join(outDir, `${namespacePath}.d.ts`);
+    const facadeJsPath = join(outDir, `${namespacePath}.js`);
+    const bindingsPath = join(namespaceDir, "bindings.json");
+    const internalLines = [];
+    const memberOverridesByClass = new Map();
+    for (const override of plan.memberOverrides) {
+        const byMember = memberOverridesByClass.get(override.className) ??
+            new Map();
+        byMember.set(override.memberName, override);
+        memberOverridesByClass.set(override.className, byMember);
+    }
+    internalLines.push("// Generated by Tsonic - Source bindings");
+    internalLines.push(`// Namespace: ${plan.namespace}`);
+    internalLines.push(`// Assembly: ${config.outputName}`);
+    internalLines.push("");
+    internalLines.push(primitiveImportLine);
+    if (plan.wrapperImports.length > 0) {
+        internalLines.push("");
+        internalLines.push("// Tsonic source member type imports (generated)");
+        for (const wrapperImport of plan.wrapperImports) {
+            if (wrapperImport.importedName === wrapperImport.aliasName) {
+                internalLines.push(`import type { ${wrapperImport.importedName} } from '${wrapperImport.source}';`);
+                continue;
+            }
+            internalLines.push(`import type { ${wrapperImport.importedName} as ${wrapperImport.aliasName} } from '${wrapperImport.source}';`);
+        }
+        internalLines.push("// End Tsonic source member type imports");
+    }
+    internalLines.push("");
+    const typeBindings = [];
+    for (const symbol of plan.typeDeclarations) {
+        if (symbol.kind === "class" &&
+            symbol.declaration.kind === "classDeclaration") {
+            internalLines.push(...renderClassInternal(symbol.declaration, plan.namespace, memberOverridesByClass.get(symbol.declaration.name) ?? new Map()));
+            typeBindings.push(buildTypeBindingFromClass(symbol.declaration, plan.namespace, config.outputName));
+            continue;
+        }
+        if (symbol.kind === "interface" &&
+            symbol.declaration.kind === "interfaceDeclaration") {
+            internalLines.push(...renderInterfaceInternal(symbol.declaration, plan.namespace, memberOverridesByClass.get(symbol.declaration.name) ?? new Map()));
+            typeBindings.push(buildTypeBindingFromInterface(symbol.declaration, plan.namespace, config.outputName));
+            continue;
+        }
+        if (symbol.kind === "enum" &&
+            symbol.declaration.kind === "enumDeclaration") {
+            internalLines.push(...renderEnumInternal(symbol.declaration));
+            typeBindings.push(buildTypeBindingFromEnum(symbol.declaration, plan.namespace, config.outputName));
+            continue;
+        }
+        if (symbol.kind === "typeAlias" &&
+            symbol.declaration.kind === "typeAliasDeclaration") {
+            internalLines.push(...renderStructuralAliasInternal(symbol.declaration, plan.namespace, memberOverridesByClass.get(`${symbol.declaration.name}__Alias${(symbol.declaration.typeParameters?.length ?? 0) > 0
+                ? `_${symbol.declaration.typeParameters?.length ?? 0}`
+                : ""}`) ?? new Map()));
+            const binding = buildTypeBindingFromStructuralAlias(symbol.declaration, plan.namespace, config.outputName);
+            if (binding)
+                typeBindings.push(binding);
+        }
+    }
+    for (const container of plan.moduleContainers) {
+        internalLines.push(...renderContainerInternal(container));
+        typeBindings.push(buildTypeBindingFromContainer(container, plan.namespace, config.outputName));
+    }
+    writeFileSync(internalIndexPath, internalLines.join("\n").trimEnd() + "\n", "utf-8");
+    const internalSpecifier = moduleNamespaceToInternalSpecifier(plan.namespace);
+    const facadeLines = [];
+    facadeLines.push(`// Namespace: ${plan.namespace}`);
+    facadeLines.push("// Generated by Tsonic - Source bindings");
+    facadeLines.push("");
+    facadeLines.push(`import * as Internal from '${internalSpecifier}';`);
+    facadeLines.push("");
+    for (const symbol of plan.typeDeclarations) {
+        if (symbol.kind === "typeAlias") {
+            continue;
+        }
+        const isValueType = symbol.kind === "class" || symbol.kind === "enum";
+        const isSyntheticAnonymousClass = symbol.kind === "class" && symbol.localName.startsWith("__Anon_");
+        if (isValueType) {
+            const specifier = symbol.exportName === symbol.localName
+                ? symbol.exportName
+                : `${symbol.localName} as ${symbol.exportName}`;
+            if (!isSyntheticAnonymousClass) {
+                facadeLines.push(`export { ${specifier} } from '${internalSpecifier}';`);
+            }
+            facadeLines.push(`export type { ${specifier} } from '${internalSpecifier}';`);
+            if (symbol.kind === "class") {
+                facadeLines.push(`export type { ${symbol.localName}$instance } from '${internalSpecifier}';`);
+            }
+            continue;
+        }
+        const specifier = symbol.exportName === symbol.localName
+            ? symbol.exportName
+            : `${symbol.localName} as ${symbol.exportName}`;
+        facadeLines.push(`export type { ${specifier} } from '${internalSpecifier}';`);
+        if (symbol.kind === "interface") {
+            facadeLines.push(`export type { ${symbol.localName}$instance } from '${internalSpecifier}';`);
+        }
+    }
+    for (const container of plan.moduleContainers) {
+        facadeLines.push(`export { ${container.module.className}$instance as ${container.module.className} } from '${internalSpecifier}';`);
+    }
+    const valueBindings = new Map();
+    const localTypeImports = new Set();
+    for (const symbol of plan.typeDeclarations) {
+        if (symbol.kind === "typeAlias")
+            continue;
+        localTypeImports.add(symbol.localName);
+        if (symbol.kind === "class" || symbol.kind === "interface") {
+            localTypeImports.add(`${symbol.localName}$instance`);
+        }
+    }
+    for (const internalImport of plan.sourceAliasInternalImports) {
+        localTypeImports.add(internalImport);
+    }
+    if (localTypeImports.size > 0) {
+        facadeLines.push("");
+        facadeLines.push("// Tsonic source alias imports (generated)");
+        facadeLines.push(`import type { ${Array.from(localTypeImports.values())
+            .sort((left, right) => left.localeCompare(right))
+            .join(", ")} } from '${internalSpecifier}';`);
+        facadeLines.push("// End Tsonic source alias imports");
+    }
+    if (plan.sourceAliasLines.length > 0) {
+        facadeLines.push("");
+        facadeLines.push("// Tsonic source type aliases (generated)");
+        facadeLines.push(...plan.sourceAliasLines);
+        facadeLines.push("// End Tsonic source type aliases");
+    }
+    if (entrypointReexports && entrypointReexports.dtsStatements.length > 0) {
+        facadeLines.push("");
+        facadeLines.push("// Tsonic entrypoint re-exports (generated)");
+        facadeLines.push(...entrypointReexports.dtsStatements);
+        facadeLines.push("// End Tsonic entrypoint re-exports");
+    }
+    for (const valueExport of plan.valueExports) {
+        valueBindings.set(valueExport.exportName, valueExport.binding);
+        if (valueExport.facade.kind === "function") {
+            const typeParametersText = printTypeParameters(valueExport.facade.declaration.typeParameters);
+            const typeParameterNames = valueExport.facade.declaration.typeParameters?.map((typeParameter) => typeParameter.name) ?? [];
+            const parametersText = renderUnknownParameters(valueExport.facade.declaration.parameters, typeParameterNames);
+            const returnTypeText = renderPortableType(valueExport.facade.declaration.returnType, typeParameterNames);
+            facadeLines.push(`export declare function ${valueExport.exportName}${typeParametersText}(${parametersText}): ${returnTypeText};`);
+            continue;
+        }
+        facadeLines.push(`export declare const ${valueExport.exportName}: ${renderPortableType(valueExport.facade.declarator?.type)};`);
+    }
+    if (plan.typeDeclarations.length === 0 &&
+        plan.moduleContainers.length === 0 &&
+        plan.valueExports.length === 0 &&
+        plan.sourceAliasLines.length === 0 &&
+        (!entrypointReexports || entrypointReexports.dtsStatements.length === 0)) {
+        facadeLines.push("export {};");
+    }
+    writeFileSync(facadeDtsPath, facadeLines.join("\n").trimEnd() + "\n", "utf-8");
+    writeFileSync(facadeJsPath, [
+        `// Namespace: ${plan.namespace}`,
+        "// Generated by Tsonic - Source bindings",
+        "// Module Stub - Do Not Execute",
+        "",
+        ...(entrypointReexports &&
+            entrypointReexports.jsValueStatements.length > 0
+            ? [
+                "// Tsonic entrypoint value re-exports (generated)",
+                ...entrypointReexports.jsValueStatements,
+                "// End Tsonic entrypoint value re-exports",
+                "",
+            ]
+            : []),
+        "throw new Error(",
+        `  'Cannot import CLR namespace ${plan.namespace} in JavaScript runtime. ' +`,
+        "  'This module provides TypeScript type definitions only. ' +",
+        "  'Actual implementation requires .NET runtime via Tsonic compiler.'",
+        ");",
+        "",
+    ].join("\n"), "utf-8");
+    const bindings = {
+        namespace: plan.namespace,
+        contributingAssemblies: [config.outputName],
+        types: typeBindings.sort((left, right) => left.clrName.localeCompare(right.clrName)),
+        exports: valueBindings.size > 0
+            ? Object.fromEntries(Array.from(valueBindings.entries()).sort((left, right) => left[0].localeCompare(right[0])))
+            : undefined,
+        producer: {
+            tool: "tsonic",
+            mode: "aikya-firstparty",
+        },
+    };
+    writeFileSync(bindingsPath, JSON.stringify(bindings, null, 2) + "\n", "utf-8");
+    return { ok: true, value: undefined };
+};
+export const generateFirstPartyLibraryBindings = (config, bindingsOutDir) => {
+    if (!config.entryPoint) {
+        return {
+            ok: false,
+            error: "Library bindings generation requires an entryPoint in tsonic.json.",
+        };
+    }
+    const absoluteEntryPoint = resolve(config.projectRoot, config.entryPoint);
+    const absoluteSourceRoot = resolve(config.projectRoot, config.sourceRoot);
+    const surfaceCapabilities = resolveSurfaceCapabilities(config.surface);
+    const typeLibraries = config.libraries.filter((library) => !library.endsWith(".dll"));
+    const allTypeRoots = [...config.typeRoots, ...typeLibraries].map((typeRoot) => resolve(config.workspaceRoot, typeRoot));
+    const compilerOptions = {
+        projectRoot: config.projectRoot,
+        sourceRoot: absoluteSourceRoot,
+        rootNamespace: config.rootNamespace,
+        typeRoots: allTypeRoots,
+        surface: config.surface,
+        useStandardLib: surfaceCapabilities.useStandardLib,
+        verbose: false,
+    };
+    const graphResult = buildModuleDependencyGraph(absoluteEntryPoint, compilerOptions);
+    if (!graphResult.ok) {
+        const message = graphResult.error
+            .map((diagnostic) => diagnostic.location
+            ? `${diagnostic.location.file}:${diagnostic.location.line}:${diagnostic.location.column} ${diagnostic.message}`
+            : diagnostic.message)
+            .join("\n");
+        return {
+            ok: false,
+            error: `Failed to generate first-party bindings from source:\n${message}`,
+        };
+    }
+    rmSync(bindingsOutDir, { recursive: true, force: true });
+    mkdirSync(bindingsOutDir, { recursive: true });
+    const modulesByFileKey = new Map();
+    for (const module of graphResult.value.modules) {
+        modulesByFileKey.set(normalizeModuleFileKey(module.filePath), module);
+    }
+    const sourceIndexByFileKey = new Map();
+    for (const module of graphResult.value.modules) {
+        if (module.filePath.startsWith("__tsonic/"))
+            continue;
+        const moduleKey = normalizeModuleFileKey(module.filePath);
+        const absolutePath = resolve(absoluteSourceRoot, moduleKey);
+        const indexed = buildModuleSourceIndex(absolutePath, moduleKey);
+        if (!indexed.ok)
+            return indexed;
+        sourceIndexByFileKey.set(moduleKey, indexed.value);
+    }
+    const plansResult = collectNamespacePlans(graphResult.value.modules, config.outputName, config.rootNamespace, sourceIndexByFileKey);
+    if (!plansResult.ok)
+        return plansResult;
+    const entrypointReexportsResult = collectEntrypointReexports(graphResult.value.entryModule, modulesByFileKey);
+    if (!entrypointReexportsResult.ok)
+        return entrypointReexportsResult;
+    for (const plan of plansResult.value) {
+        const result = writeNamespaceArtifacts(config, bindingsOutDir, plan, plan.namespace === graphResult.value.entryModule.namespace
+            ? entrypointReexportsResult.value
+            : undefined);
+        if (!result.ok)
+            return result;
+    }
+    const overlayResult = overlayDependencyBindings(config, bindingsOutDir);
+    if (!overlayResult.ok)
+        return overlayResult;
+    return { ok: true, value: undefined };
+};
+//# sourceMappingURL=library-bindings-firstparty.js.map