isthmus-cli 0.5.0 → 0.7.0

package/dist/extract/js-scan.d.ts

@@ -0,0 +1,93 @@
+/**
+ * extract-js의 파일 한 개 스캐너다.
+ *
+ * 토큰 열 위에서 코어 RN과 Expo Modules의 브리지 호출 형태를 찾는다.
+ * 모듈·컴포넌트 이름 경계 사실은 즉시 확정하고, 멤버 호출(`M.foo()`)은
+ * 바인딩 정보와 함께 문서 조립 단계로 넘겨 같은 파일·가져오기 해석을 거친다.
+ *
+ * 이 스캐너는 이름을 정적으로 확정할 수 있는 형태만 fact로 낸다. 비리터럴
+ * 인자는 `dynamic: true`에 원문 표현식을 실어 한계 계수에 맡긴다.
+ */
+import type { BridgeFact, BridgeMechanism } from '../exchange/parse.ts';
+import type { JsToken } from './lexer.ts';
+/** 스캔이 모은 한 파일의 결과다. */
+export interface JsFileScan {
+    /** 이미 확정된 경계·메서드 사실이다. location은 토큰 위치로 호출자가 채운다. */
+    readonly facts: readonly ScannedFact[];
+    /**
+     * 베이스가 로컬·import 식별자인 멤버 호출 후보다. 문서 단계에서 바인딩을
+     * 해석해 메서드 호출 사실로 바꾼다.
+     */
+    readonly memberCalls: readonly ScannedMemberCall[];
+    /** 같은 파일에서 식별자가 가리키는 모듈·컴포넌트 이름이다. */
+    readonly bindings: ReadonlyMap<string, BoundName>;
+    /** 한 단계 문자열 상수(`const X = 'lit'` / 백틱)다. */
+    readonly constStrings: ReadonlyMap<string, string>;
+    /** `import X from 'spec'` 바인딩이다. 문서 단계에서 파일 해석을 거친다. */
+    readonly imports: readonly ScannedImport[];
+    /** 다른 파일이 이 파일의 export를 해석하는 데 쓰는 이름 지도다. */
+    readonly exports: ScannedExports;
+    /** 생산자 limitation에 쓰는 원시 계수다. */
+    readonly counts: JsScanCounts;
+}
+/** 스캔이 세는 한계 분류다. */
+export interface JsScanCounts {
+    readonly dynamicModuleNames: number;
+    readonly dynamicComponentNames: number;
+    readonly dynamicMethodNames: number;
+}
+/** 위치 정보가 붙기 전의 사실 골격이다. */
+export interface ScannedFact {
+    readonly kind: BridgeFact['kind'];
+    readonly channel: string;
+    readonly method?: string;
+    readonly mechanism?: BridgeMechanism;
+    /** 호출 API가 모듈 부재를 허용한다(`null` 반환)는 module-import 증거다. */
+    readonly optional?: boolean;
+    readonly dynamic: boolean;
+    readonly token: JsToken;
+}
+/** 바인딩이 확정된 이름인지 원문 표현식인지 구분한다. */
+export type BoundName = {
+    readonly name: string;
+} | {
+    readonly dynamicExpression: string;
+};
+/** `ident.method(...)` 또는 `ident[expr](...)` 호출 후보다. */
+export interface ScannedMemberCall {
+    /** 베이스 식별자다. */
+    readonly ident: string;
+    /** 리터럴이면 메서드명, 아니면 원문 표현식이다. */
+    readonly method: string;
+    readonly dynamicMethod: boolean;
+    readonly token: JsToken;
+}
+/** 한 파일의 import 바인딩이다. */
+export interface ScannedImport {
+    readonly localName: string;
+    readonly specifier: string;
+    /** default export 해석인지 named export 해석인지 구분한다. */
+    readonly exportedName: string | 'default';
+    readonly token: JsToken;
+}
+/** 이 파일이 외부에보내는 모듈 바인딩이다. */
+export interface ScannedExports {
+    readonly defaultName?: BoundName;
+    readonly named: ReadonlyMap<string, BoundName>;
+    /**
+     * `export { A as B } from 'spec'`·`export { default as X } from 'spec'`의
+     * 배럴 재수출이다. 키는 이 파일이보내는 이름, 값은 원본 specifier다.
+     */
+    readonly reexported: ReadonlyMap<string, {
+        readonly specifier: string;
+        readonly exportedName: string | 'default';
+    }>;
+}
+/** 한 소스 텍스트를 스캔해 사실 후보·바인딩·계수를 모은다. */
+export declare function scanJsSource(source: string): JsFileScan;
+/**
+ * 동적 표현식의 원문을 계약 필드가 허용하는 안전한 문자열로 바꾼다.
+ *
+ * 제어 문자는 공백으로 접고 길이를 제한해 원문 표현이 키 파싱을 깨지 않게 한다.
+ */
+export declare function sanitizeExpression(expression: string): string;