@scriptc/compiler 0.1.7 → 0.2.1

package/dist/frontend/npm-static-declaration-syntax.d.ts

@@ -0,0 +1,57 @@
+import * as ts from "./ts7/syntax.js";
+export interface NpmStaticOverloadParameter {
+    name: string;
+    type: string;
+    optional: boolean;
+}
+export interface NpmStaticOverloadSignature {
+    parameters: readonly NpmStaticOverloadParameter[];
+    returnType: string;
+}
+export type NpmStaticDeclarationOverloads = ReadonlyMap<string, ReadonlyMap<string, readonly NpmStaticOverloadSignature[]>>;
+export type NpmStaticDeclarationProperties = ReadonlyMap<string, ReadonlyMap<string, string>>;
+export interface NpmStaticRuntimeClassTarget {
+    specifier: string | null;
+    localName: string;
+}
+export interface NpmStaticOverloadRewrite {
+    text: string;
+    insertions: readonly {
+        offset: number;
+        length: number;
+    }[];
+}
+/** TypeScript truncates JSDoc inner/instance namepaths (`Owner~Item`,
+ * `Owner#Item`) to Owner. That unrelated nominal type must not dictate a
+ * native layout. Keep the unresolved atom checked, preserving containers,
+ * string literal types, executable source and every diagnostic offset. */
+export declare function applyNpmStaticJsDocNamepaths(sourceFile: ts.SourceFile, source: string): string | null;
+/** Recover nullable class storage erased by a JavaScript bundle. A null
+ * field whose writes construct one named class or call one static factory (or reset to null)
+ * keeps that class's native methods instead of an opaque checked value.
+ * Unknown writes, shadowed constructors and authored annotations decline;
+ * downstream lowering still checks every assignment against the slot. */
+export declare function applyNpmStaticNullableClassFields(sourceFile: ts.SourceFile, source: string): NpmStaticOverloadRewrite | null;
+/** A JavaScript return annotation cannot make Array.find return a value
+ * when no element matches. Widen only direct finds on constructor-owned
+ * arrays; arbitrary methods also named find are left alone. */
+export declare function applyNpmStaticFindReturnWidening(sourceFile: ts.SourceFile, source: string): NpmStaticOverloadRewrite | null;
+/** Extracts complete safe overload groups and zero-argument scalar-return
+ * contracts from exported non-generic classes. */
+export declare function parseNpmStaticDeclarationOverloads(sourceFile: ts.SourceFile): NpmStaticDeclarationOverloads;
+/** Extracts nullable self links and zero-argument void callback fields. */
+export declare function parseNpmStaticDeclarationProperties(sourceFile: ts.SourceFile): NpmStaticDeclarationProperties;
+/** Relative declaration-barrel edges whose target stays subject to the
+ * caller's package-bounded resolution. Bare type dependencies deliberately
+ * do not inherit the opted package's declaration trust. */
+export declare function npmStaticDeclarationReexports(sourceFile: ts.SourceFile): readonly string[];
+/** Maps declaration class names to one implementation edge and binding.
+ * Named ESM aliases preserve the implementation's exported name, including
+ * bundler-renamed classes. Multi-hop re-exports remain outside this slice. */
+export declare function npmStaticRuntimeClassTargets(sourceFile: ts.SourceFile, source: string, classNames: ReadonlySet<string>): ReadonlyMap<string, NpmStaticRuntimeClassTarget>;
+/** Injects declaration overload JSDoc into matching exported JS classes. */
+export declare function applyNpmStaticDeclarationOverloads(sourceFile: ts.SourceFile, source: string, declarations: NpmStaticDeclarationOverloads): NpmStaticOverloadRewrite | null;
+/** Projects self links at constructor null writes and nullable callbacks at
+ * field definitions. Local subclasses retain a callback's nullable storage
+ * type when an arrow replaces null, keeping caller inference slot-exact. */
+export declare function applyNpmStaticDeclarationProperties(sourceFile: ts.SourceFile, source: string, declarations: NpmStaticDeclarationProperties): NpmStaticOverloadRewrite | null;