@component-compass/parser-react 0.0.4 → 0.1.0

package/dist/emit.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Emit references for a single React/TSX file into the graph.
+ *
+ * Replaces walk-jsx.ts. This is a structural AST walker — it pattern-matches
+ * shapes without doing resolution. Meaning emerges from the engine resolving
+ * the InferredType algebra in a post-Walk phase. See spec §8.
+ */
+import type { Node as OxcNode, Program } from "@oxc-project/types";
+import type { FileBuilder, InferredType } from "@component-compass/reference-graph";
+export type EmitOptions = {
+    file: string;
+    source: string;
+    ast: Program;
+    fileBuilder: FileBuilder;
+    captureValues?: boolean;
+};
+export declare function emitReact(opts: EmitOptions): void;
+export type PatternLeaf = {
+    symbol: string;
+    value: InferredType;
+    loc: {
+        line: number;
+        column: number;
+    };
+};
+/**
+ * Walk a function-parameter or destructure pattern AST node, yielding one
+ * PatternLeaf per leaf Identifier. The `source` InferredType describes the
+ * value being destructured (e.g. `ParameterOf(fnRef, i)` or the call-return
+ * type for `const { X } = useFoo()`). Leaves carry MemberOf chains over
+ * `source` keyed by destructure path. Mirrors Omlet's
+ * extract_symbols_from_pattern.
+ *
+ * `sourceText` is needed to compute `positionAt` for each leaf identifier.
+ */
+export declare function extractBindingsFromPattern(pattern: OxcNode, source: InferredType, sourceText: string): PatternLeaf[];
+/**
+ * True if the given node type is a JSX expression that produces a React
+ * element value. Used to detect module-scope `const X = <JSX/>` bindings
+ * whose JSX construction site needs prop-forward owner attribution.
+ */
+export declare function isJsxTypeInit(nodeType: string): boolean;
+/**
+ * Extract the root identifier from a JSX init expression.
+ * Returns the root binding name (`<Foo.Bar />` → `"Foo"`) or null for
+ * JSXFragment / namespaced names (no static root identifier).
+ */
+export declare function rootSymbolOfJsxInit(init: OxcNode): string | null;