@tsonic/frontend 0.0.62 → 0.0.64

package/dist/program/binding-types.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Binding manifest types - maps JS/TS names to CLR types/members
+ * See spec/bindings.md for full manifest format
+ */
+/**
+ * Parameter modifier for ref/out/in parameters
+ * Matches the format from tsbindgen: { index: number, modifier: "ref" | "out" | "in" }
+ */
+export type ParameterModifier = {
+    readonly index: number;
+    readonly modifier: "ref" | "out" | "in";
+};
+/**
+ * Member binding (method/property level)
+ */
+export type MemberBinding = {
+    readonly kind: "method" | "property";
+    readonly signature?: string;
+    /** Total CLR parameter count (includes extension receiver for extension methods). */
+    readonly parameterCount?: number;
+    readonly name: string;
+    readonly alias: string;
+    readonly binding: {
+        readonly assembly: string;
+        readonly type: string;
+        readonly member: string;
+    };
+    readonly parameterModifiers?: readonly ParameterModifier[];
+    readonly isExtensionMethod?: boolean;
+};
+/**
+ * Type binding (class/interface/struct/enum level)
+ */
+export type TypeBinding = {
+    readonly name: string;
+    readonly alias: string;
+    readonly kind: "class" | "interface" | "struct" | "enum";
+    readonly members: readonly MemberBinding[];
+};
+/**
+ * Namespace binding
+ */
+export type NamespaceBinding = {
+    readonly name: string;
+    readonly alias: string;
+    readonly types: readonly TypeBinding[];
+};
+/**
+ * Full binding manifest structure (new format from bindings.md)
+ */
+export type FullBindingManifest = {
+    readonly assembly: string;
+    readonly namespaces: readonly NamespaceBinding[];
+};
+/**
+ * Simple binding entry for global/module identifiers
+ * Maps identifiers like `console`, `Math`, `fs` to CLR types
+ */
+export type SimpleBindingDescriptor = {
+    readonly kind: "global" | "module";
+    readonly assembly: string;
+    readonly type: string;
+    readonly csharpName?: string;
+};
+/**
+ * Simple binding file structure for global/module bindings
+ */
+export type SimpleBindingFile = {
+    readonly bindings: Readonly<Record<string, SimpleBindingDescriptor>>;
+};
+/**
+ * tsbindgen format - generated by tsbindgen tool
+ * This is the format produced when generating bindings from .NET assemblies
+ */
+export type TsbindgenMethod = {
+    readonly clrName: string;
+    /** Normalized signature string (tsbindgen metadata, used for extension receiver inference) */
+    readonly normalizedSignature?: string;
+    /** Total parameter count in CLR signature (includes extension receiver) */
+    readonly parameterCount?: number;
+    readonly declaringClrType: string;
+    readonly declaringAssemblyName: string;
+    readonly parameterModifiers?: readonly ParameterModifier[];
+    readonly isExtensionMethod?: boolean;
+};
+export type TsbindgenProperty = {
+    readonly clrName: string;
+    readonly declaringClrType: string;
+    readonly declaringAssemblyName: string;
+};
+export type TsbindgenField = {
+    readonly clrName: string;
+    readonly declaringClrType: string;
+    readonly declaringAssemblyName: string;
+};
+export type TsbindgenTypeRef = {
+    readonly stableId?: string;
+    readonly clrName: string;
+    readonly typeArguments?: readonly string[];
+};
+export type TsbindgenType = {
+    readonly clrName: string;
+    readonly assemblyName: string;
+    readonly baseType?: TsbindgenTypeRef;
+    readonly interfaces?: readonly TsbindgenTypeRef[];
+    /**
+     * CLR type kind from tsbindgen (e.g., "Class", "Interface", "Struct", "Enum").
+     *
+     * This is used for airplane-grade emission decisions (e.g., whether a name in
+     * a TS `implements` clause is a CLR interface and should be emitted in the C#
+     * heritage list).
+     */
+    readonly kind?: "Class" | "Interface" | "Struct" | "Enum";
+    readonly methods: readonly TsbindgenMethod[];
+    readonly properties: readonly TsbindgenProperty[];
+    readonly fields: readonly TsbindgenField[];
+};
+/**
+ * tsbindgen "flattened named export" descriptor.
+ *
+ * This is an additive surface to support JS-style named imports that bind to
+ * a stable declaring CLR type + member (typically module container static types).
+ *
+ * Example (user code):
+ *   import { buildSite } from "@tsumo/engine/Tsumo.Engine.js";
+ *   buildSite(req);
+ *
+ * Example (bindings.json excerpt):
+ *   "exports": {
+ *     "buildSite": {
+ *       "kind": "method",
+ *       "clrName": "buildSite",
+ *       "declaringClrType": "Tsumo.Engine.BuildSite",
+ *       "declaringAssemblyName": "Tsumo.Engine"
+ *     }
+ *   }
+ */
+export type TsbindgenExport = {
+    readonly kind: "method" | "property" | "field";
+    readonly clrName: string;
+    readonly declaringClrType: string;
+    readonly declaringAssemblyName: string;
+};
+export type TsbindgenBindingFile = {
+    readonly namespace: string;
+    readonly types: readonly TsbindgenType[];
+    readonly exports?: Readonly<Record<string, TsbindgenExport>>;
+};
+/**
+ * Union type for all binding formats
+ */
+export type BindingFile = FullBindingManifest | SimpleBindingFile | TsbindgenBindingFile;
+/**
+ * Type guard to check if a manifest is the full format
+ */
+export declare const isFullBindingManifest: (manifest: BindingFile) => manifest is FullBindingManifest;
+/**
+ * Type guard to check if a manifest is the tsbindgen format
+ */
+export declare const isTsbindgenBindingFile: (manifest: BindingFile) => manifest is TsbindgenBindingFile;
+/**
+ * Validate that a parsed JSON object is a valid binding file format.
+ * Returns an error message if invalid, undefined if valid.
+ */
+export declare const validateBindingFile: (obj: unknown, filePath: string) => string | undefined;
+//# sourceMappingURL=binding-types.d.ts.map

package/dist/program/binding-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-types.d.ts","sourceRoot":"","sources":["../../src/program/binding-types.ts"],"names":[],"mappings":"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"}

package/dist/program/binding-types.js

@@ -0,0 +1,57 @@
+/**
+ * Binding manifest types - maps JS/TS names to CLR types/members
+ * See spec/bindings.md for full manifest format
+ */
+/**
+ * Type guard to check if a manifest is the full format
+ */
+export const isFullBindingManifest = (manifest) => {
+    return "assembly" in manifest && "namespaces" in manifest;
+};
+/**
+ * Type guard to check if a manifest is the tsbindgen format
+ */
+export const isTsbindgenBindingFile = (manifest) => {
+    return ("namespace" in manifest &&
+        "types" in manifest &&
+        !("namespaces" in manifest));
+};
+/**
+ * Validate that a parsed JSON object is a valid binding file format.
+ * Returns an error message if invalid, undefined if valid.
+ */
+export const validateBindingFile = (obj, filePath) => {
+    if (obj === null || typeof obj !== "object") {
+        return `${filePath}: Expected object, got ${typeof obj}`;
+    }
+    const manifest = obj;
+    // Check for tsbindgen format
+    if ("namespace" in manifest && "types" in manifest) {
+        if (typeof manifest.namespace !== "string") {
+            return `${filePath}: 'namespace' must be a string`;
+        }
+        if (!Array.isArray(manifest.types)) {
+            return `${filePath}: 'types' must be an array`;
+        }
+        return undefined; // Valid tsbindgen format
+    }
+    // Check for full manifest format
+    if ("assembly" in manifest && "namespaces" in manifest) {
+        if (typeof manifest.assembly !== "string") {
+            return `${filePath}: 'assembly' must be a string`;
+        }
+        if (!Array.isArray(manifest.namespaces)) {
+            return `${filePath}: 'namespaces' must be an array`;
+        }
+        return undefined; // Valid full format
+    }
+    // Check for simple format (global/module bindings)
+    if ("bindings" in manifest) {
+        if (typeof manifest.bindings !== "object" || manifest.bindings === null) {
+            return `${filePath}: 'bindings' must be an object`;
+        }
+        return undefined; // Valid simple format
+    }
+    return `${filePath}: Unrecognized binding file format. Expected tsbindgen (namespace+types), full (assembly+namespaces), or simple (bindings) format.`;
+};
+//# sourceMappingURL=binding-types.js.map

package/dist/program/binding-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-types.js","sourceRoot":"","sources":["../../src/program/binding-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4KH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,QAAqB,EACY,EAAE;IACnC,OAAO,UAAU,IAAI,QAAQ,IAAI,YAAY,IAAI,QAAQ,CAAC;AAC5D,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,QAAqB,EACa,EAAE;IACpC,OAAO,CACL,WAAW,IAAI,QAAQ;QACvB,OAAO,IAAI,QAAQ;QACnB,CAAC,CAAC,YAAY,IAAI,QAAQ,CAAC,CAC5B,CAAC;AACJ,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,GAAY,EACZ,QAAgB,EACI,EAAE;IACtB,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,GAAG,QAAQ,0BAA0B,OAAO,GAAG,EAAE,CAAC;IAC3D,CAAC;IAED,MAAM,QAAQ,GAAG,GAA8B,CAAC;IAEhD,6BAA6B;IAC7B,IAAI,WAAW,IAAI,QAAQ,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;QACnD,IAAI,OAAO,QAAQ,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC3C,OAAO,GAAG,QAAQ,gCAAgC,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACnC,OAAO,GAAG,QAAQ,4BAA4B,CAAC;QACjD,CAAC;QACD,OAAO,SAAS,CAAC,CAAC,yBAAyB;IAC7C,CAAC;IAED,iCAAiC;IACjC,IAAI,UAAU,IAAI,QAAQ,IAAI,YAAY,IAAI,QAAQ,EAAE,CAAC;QACvD,IAAI,OAAO,QAAQ,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1C,OAAO,GAAG,QAAQ,+BAA+B,CAAC;QACpD,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACxC,OAAO,GAAG,QAAQ,iCAAiC,CAAC;QACtD,CAAC;QACD,OAAO,SAAS,CAAC,CAAC,oBAAoB;IACxC,CAAC;IAED,mDAAmD;IACnD,IAAI,UAAU,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,OAAO,QAAQ,CAAC,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACxE,OAAO,GAAG,QAAQ,gCAAgC,CAAC;QACrD,CAAC;QACD,OAAO,SAAS,CAAC,CAAC,sBAAsB;IAC1C,CAAC;IAED,OAAO,GAAG,QAAQ,oIAAoI,CAAC;AACzJ,CAAC,CAAC"}

package/dist/program/bindings.d.ts

@@ -1,277 +1,12 @@
 /**
  * Binding manifest loading - maps JS/TS names to CLR types/members
  * See spec/bindings.md for full manifest format
- */
-/**
- * Parameter modifier for ref/out/in parameters
- * Matches the format from tsbindgen: { index: number, modifier: "ref" | "out" | "in" }
- */
-export type ParameterModifier = {
-    readonly index: number;
-    readonly modifier: "ref" | "out" | "in";
-};
-/**
- * Member binding (method/property level)
- */
-export type MemberBinding = {
-    readonly kind: "method" | "property";
-    readonly signature?: string;
-    /** Total CLR parameter count (includes extension receiver for extension methods). */
-    readonly parameterCount?: number;
-    readonly name: string;
-    readonly alias: string;
-    readonly binding: {
-        readonly assembly: string;
-        readonly type: string;
-        readonly member: string;
-    };
-    readonly parameterModifiers?: readonly ParameterModifier[];
-    readonly isExtensionMethod?: boolean;
-};
-/**
- * Type binding (class/interface/struct/enum level)
- */
-export type TypeBinding = {
-    readonly name: string;
-    readonly alias: string;
-    readonly kind: "class" | "interface" | "struct" | "enum";
-    readonly members: readonly MemberBinding[];
-};
-/**
- * Namespace binding
- */
-export type NamespaceBinding = {
-    readonly name: string;
-    readonly alias: string;
-    readonly types: readonly TypeBinding[];
-};
-/**
- * Full binding manifest structure (new format from bindings.md)
- */
-export type FullBindingManifest = {
-    readonly assembly: string;
-    readonly namespaces: readonly NamespaceBinding[];
-};
-/**
- * Simple binding entry for global/module identifiers
- * Maps identifiers like `console`, `Math`, `fs` to CLR types
- */
-export type SimpleBindingDescriptor = {
-    readonly kind: "global" | "module";
-    readonly assembly: string;
-    readonly type: string;
-    readonly csharpName?: string;
-};
-/**
- * Simple binding file structure for global/module bindings
- */
-export type SimpleBindingFile = {
-    readonly bindings: Readonly<Record<string, SimpleBindingDescriptor>>;
-};
-/**
- * tsbindgen format - generated by tsbindgen tool
- * This is the format produced when generating bindings from .NET assemblies
- */
-export type TsbindgenMethod = {
-    readonly clrName: string;
-    /** Normalized signature string (tsbindgen metadata, used for extension receiver inference) */
-    readonly normalizedSignature?: string;
-    /** Total parameter count in CLR signature (includes extension receiver) */
-    readonly parameterCount?: number;
-    readonly declaringClrType: string;
-    readonly declaringAssemblyName: string;
-    readonly parameterModifiers?: readonly ParameterModifier[];
-    readonly isExtensionMethod?: boolean;
-};
-export type TsbindgenProperty = {
-    readonly clrName: string;
-    readonly declaringClrType: string;
-    readonly declaringAssemblyName: string;
-};
-export type TsbindgenField = {
-    readonly clrName: string;
-    readonly declaringClrType: string;
-    readonly declaringAssemblyName: string;
-};
-export type TsbindgenTypeRef = {
-    readonly stableId?: string;
-    readonly clrName: string;
-    readonly typeArguments?: readonly string[];
-};
-export type TsbindgenType = {
-    readonly clrName: string;
-    readonly assemblyName: string;
-    readonly baseType?: TsbindgenTypeRef;
-    readonly interfaces?: readonly TsbindgenTypeRef[];
-    /**
-     * CLR type kind from tsbindgen (e.g., "Class", "Interface", "Struct", "Enum").
-     *
-     * This is used for airplane-grade emission decisions (e.g., whether a name in
-     * a TS `implements` clause is a CLR interface and should be emitted in the C#
-     * heritage list).
-     */
-    readonly kind?: "Class" | "Interface" | "Struct" | "Enum";
-    readonly methods: readonly TsbindgenMethod[];
-    readonly properties: readonly TsbindgenProperty[];
-    readonly fields: readonly TsbindgenField[];
-};
-/**
- * tsbindgen "flattened named export" descriptor.
- *
- * This is an additive surface to support JS-style named imports that bind to
- * a stable declaring CLR type + member (typically module container static types).
- *
- * Example (user code):
- *   import { buildSite } from "@tsumo/engine/Tsumo.Engine.js";
- *   buildSite(req);
- *
- * Example (bindings.json excerpt):
- *   "exports": {
- *     "buildSite": {
- *       "kind": "method",
- *       "clrName": "buildSite",
- *       "declaringClrType": "Tsumo.Engine.BuildSite",
- *       "declaringAssemblyName": "Tsumo.Engine"
- *     }
- *   }
- */
-export type TsbindgenExport = {
-    readonly kind: "method" | "property" | "field";
-    readonly clrName: string;
-    readonly declaringClrType: string;
-    readonly declaringAssemblyName: string;
-};
-export type TsbindgenBindingFile = {
-    readonly namespace: string;
-    readonly types: readonly TsbindgenType[];
-    readonly exports?: Readonly<Record<string, TsbindgenExport>>;
-};
-/**
- * Union type for all binding formats
- */
-export type BindingFile = FullBindingManifest | SimpleBindingFile | TsbindgenBindingFile;
-/**
- * Registry of all loaded bindings
- * Supports simple (global/module) and hierarchical (namespace/type/member) formats
- */
-export declare class BindingRegistry {
-    private readonly loadedBindingFiles;
-    private readonly simpleBindings;
-    private readonly namespaces;
-    private readonly types;
-    private readonly members;
-    private readonly memberOverloads;
-    private readonly clrMemberOverloads;
-    private readonly tsbindgenExports;
-    private readonly tsSupertypes;
-    /**
-     * Extension method index for instance-style calls.
-     *
-     * Keyed by:
-     * - declaring namespace key (CLR namespace with '.' replaced by '_', e.g. "System_Linq")
-     * - receiver TS type name (e.g. "IEnumerable_1")
-     * - method TS name (e.g. "where")
-     *
-     * Values are one or more candidates (overloads share the same target).
-     */
-    private readonly extensionMethods;
-    private getExtensionMethodCandidates;
-    private addSupertype;
-    private getDirectSupertypes;
-    /**
-     * Resolve an extension method binding target by extension interface name.
-     *
-     * @param extensionInterfaceName - e.g. "__Ext_System_Linq_IEnumerable_1"
-     * @param methodTsName - e.g. "where"
-     */
-    resolveExtensionMethod(extensionInterfaceName: string, methodTsName: string, callArgumentCount?: number): MemberBinding | undefined;
-    /**
-     * Resolve an extension method binding target by explicit (namespaceKey, receiverTypeName).
-     *
-     * Used when extension methods are emitted as method-table members with explicit `this:`
-     * receiver constraints (the declaring interface name no longer encodes the receiver type).
-     */
-    resolveExtensionMethodByKey(namespaceKey: string, receiverTypeName: string, methodTsName: string, callArgumentCount?: number): MemberBinding | undefined;
-    private parseExtensionInterfaceName;
-    /**
-     * Load a binding manifest file and add its bindings to the registry
-     * Supports simple, full, and tsbindgen formats
-     */
-    addBindings(_filePath: string, manifest: BindingFile): void;
-    /**
-     * Look up a simple global/module binding
-     */
-    getBinding(name: string): SimpleBindingDescriptor | undefined;
-    /**
-     * Look up a namespace binding by TS alias
-     */
-    getNamespace(tsAlias: string): NamespaceBinding | undefined;
-    /**
-     * Look up a type binding by TS alias
-     */
-    getType(tsAlias: string): TypeBinding | undefined;
-    /**
-     * Look up a member binding by TS type alias and member alias
-     */
-    getMember(typeAlias: string, memberAlias: string): MemberBinding | undefined;
-    /**
-     * Look up all member bindings for a TS type alias + member alias.
-     *
-     * IMPORTANT: Methods can be overloaded, and overloads can differ in ref/out/in
-     * modifiers (tsbindgen provides these via `parameterModifiers`). This accessor
-     * preserves overload sets so the call converter can select the correct one.
-     */
-    getMemberOverloads(typeAlias: string, memberAlias: string): readonly MemberBinding[] | undefined;
-    /**
-     * Look up all member bindings for a CLR member target.
-     *
-     * Keyed by declaring assembly, CLR type, and CLR member name.
-     */
-    getClrMemberOverloads(assembly: string, clrType: string, clrMember: string): readonly MemberBinding[] | undefined;
-    /**
-     * Look up a tsbindgen flattened named export by CLR namespace + export name.
-     */
-    getTsbindgenExport(namespace: string, exportName: string): TsbindgenExport | undefined;
-    /**
-     * Get all loaded simple bindings
-     */
-    getAllBindings(): readonly [string, SimpleBindingDescriptor][];
-    /**
-     * Get all loaded namespaces
-     */
-    getAllNamespaces(): readonly NamespaceBinding[];
-    /**
-     * Get a copy of the types map for passing to the emitter.
-     * Returns a new Map to ensure immutability - callers cannot modify the registry.
-     */
-    getTypesMap(): ReadonlyMap<string, TypeBinding>;
-    /**
-     * Clear all loaded bindings
-     */
-    clear(): void;
-}
-/**
- * Load binding manifests from configured type roots.
- *
- * Conventions:
- * - Root-level `bindings.json` (simple/global bindings)
- * - `Namespace.d.ts` + `Namespace/bindings.json` (namespace facade)
- *
- * Also recursively loads bindings from @tsonic/* dependencies of typeRoot packages.
- */
-export declare const loadBindings: (typeRoots: readonly string[]) => BindingRegistry;
-/**
- * Load bindings from a specific file path into an existing registry.
- * Validates the file format and logs a warning if invalid.
- */
-export declare const loadBindingsFromPath: (registry: BindingRegistry, bindingsPath: string) => void;
-/**
- * Load all CLR bindings discovered by the resolver.
- * This should be called AFTER createProgram but BEFORE IR building
- * to ensure all bindings are available during IR construction.
  *
- * Note: The ClrBindingsResolver tracks discovered binding paths via caching,
- * so this loads bindings for any imports that were already resolved.
+ * This barrel module re-exports all binding types, the registry, and loaders
+ * so that existing imports from "program/bindings.js" continue to work.
  */
-export declare const loadAllDiscoveredBindings: (registry: BindingRegistry, discoveredPaths: ReadonlySet<string>) => void;
+export type { ParameterModifier, MemberBinding, TypeBinding, NamespaceBinding, FullBindingManifest, SimpleBindingDescriptor, SimpleBindingFile, TsbindgenMethod, TsbindgenProperty, TsbindgenField, TsbindgenTypeRef, TsbindgenType, TsbindgenExport, TsbindgenBindingFile, BindingFile, } from "./binding-types.js";
+export { isFullBindingManifest, isTsbindgenBindingFile, validateBindingFile, } from "./binding-types.js";
+export { BindingRegistry } from "./binding-registry.js";
+export { scanForDeclarationFiles, loadBindings, loadBindingsFromPath, loadAllDiscoveredBindings, } from "./binding-loader.js";
 //# sourceMappingURL=bindings.d.ts.map

package/dist/program/bindings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../../src/program/bindings.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../../src/program/bindings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EACL,uBAAuB,EACvB,YAAY,EACZ,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC"}