@spexcode/spec-core 0.6.2 → 0.6.4

package/dist/anchors.d.ts

@@ -0,0 +1,94 @@
+import { type DriftIndex, type DriftPathEvent } from './git.js';
+export type Unit = {
+    name: string;
+    kind: string;
+    start: number;
+    end: number;
+    typeOnly?: boolean;
+};
+export type Extractor = {
+    id: string;
+    claims(ext: string): boolean;
+    ready(): true | string;
+    extract(content: string, filename: string): Unit[];
+    memoKey: (filename: string) => string;
+};
+export type CodeEntry = {
+    path: string;
+    anchor: string | null;
+};
+export declare function parseCodeEntry(raw: string): CodeEntry;
+export type RelationEntry = {
+    path: string;
+    selectors: string[];
+};
+export type RelationParse = {
+    entries: RelationEntry[];
+    problems: string[];
+};
+export declare function relationClaimsPath(claim: string, file: string): boolean;
+export declare function parseRelation(raws: string[], relation: 'code' | 'related'): RelationParse;
+export declare function tsAstExtractor(root: string): Extractor;
+export type LangSpec = {
+    id: string;
+    extensions: string[];
+    decls: {
+        re: RegExp;
+        kind: string;
+        typeOnly?: boolean;
+        classOpener?: boolean;
+        declList?: boolean;
+        scopeOpener?: boolean;
+        memberOf?: {
+            parentKind: string;
+            kind: string;
+        };
+    }[];
+    member?: {
+        re: RegExp;
+        blacklist?: RegExp;
+    };
+    indentScopes?: {
+        decorator?: RegExp;
+    };
+    boundary: RegExp;
+};
+export declare function heuristicExtractor(spec: LangSpec): Extractor;
+export declare const JS_LANG_R5B: LangSpec;
+export declare const PYTHON_LANG: LangSpec;
+export declare function extractors(root: string): Extractor[];
+export declare function extractorFor(regs: Extractor[], ext: string): Extractor | null;
+export declare const extOf: (path: string) => string;
+export type AnchorResolution = {
+    ok: Unit;
+} | {
+    dead: true;
+} | {
+    ambiguous: number;
+};
+export type SelectorVerdict = {
+    selector: string;
+} & ({
+    ok: Unit;
+} | {
+    dead: true;
+} | {
+    ambiguous: number;
+});
+export declare function resolveSelectors(units: Unit[], selectors: readonly string[]): SelectorVerdict[];
+export declare function resolveAnchor(units: Unit[], symbol: string): AnchorResolution;
+export declare function selectorsHitRanges(units: readonly Unit[], symbols: readonly string[], ranges: readonly [number, number][]): string[];
+export declare function diffHunkRanges(patch: string, side?: 'old' | 'new'): [number, number][];
+export declare function windowEvents(idx: DriftIndex, sinceHash: string, path: string, nodeId?: string): DriftPathEvent[];
+export type AnchorHit = {
+    commit: string;
+    selectors: string[];
+    unparseable?: string;
+};
+export type AnchorHitQuery = {
+    win: DriftPathEvent[];
+    symbols: string[];
+};
+export declare function anchorHitQueries(root: string, queries: AnchorHitQuery[], regs: Extractor[]): Promise<AnchorHit[][]>;
+export declare function anchorHitExists(root: string, queries: AnchorHitQuery[], regs: Extractor[]): Promise<boolean[]>;
+export declare function anchorHitCommits(root: string, win: DriftPathEvent[], symbols: string[], regs: Extractor[]): Promise<AnchorHit[]>;