@angri450/zvec-grep 0.2.2

package/dist/engine/config.js

@@ -0,0 +1,351 @@
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { EngineError } from "./errors.js";
+import { readJsonFileSync, writeJsonFileSync } from "./utils/json.js";
+import { acquireReadWriteLock } from "./utils/lock.js";
+export function resolveEmbeddingRuntimeOptions(reference, explicit, workspace, config, environment = process.env) {
+    const provider = providerFromEmbedding(reference);
+    const local = provider === "local";
+    if (local && explicit.endpoint !== undefined) {
+        throw invalidRuntime(reference, "endpoint is only supported for remote embedding models");
+    }
+    if (!local && explicit.device !== undefined) {
+        throw invalidRuntime(reference, "device is only supported for local embedding models");
+    }
+    const model = config.models?.[reference];
+    const providerConfig = provider ? config.providers?.[provider] : undefined;
+    const endpoint = !local
+        ? (explicit.endpoint ??
+            workspace.endpoint ??
+            model?.endpoint ??
+            nonEmptyEnvironmentValue(environment.ZVEC_GREP_ENDPOINT))
+        : undefined;
+    if (endpoint !== undefined && !isHttpEndpoint(endpoint)) {
+        throw invalidRuntime(reference, "endpoint must be a valid HTTP(S) URL");
+    }
+    const device = local
+        ? (explicit.device ??
+            workspace.device ??
+            model?.device ??
+            environmentDevice(environment))
+        : undefined;
+    return {
+        apiKey: explicit.apiKey ??
+            workspace.apiKey ??
+            providerConfig?.apiKey ??
+            environmentApiKey(provider, environment) ??
+            "",
+        ...(endpoint !== undefined ? { endpoint } : {}),
+        ...(device !== undefined ? { device } : {}),
+    };
+}
+const GLOBAL_CONFIG_VERSION = 1;
+const GLOBAL_CONFIG_DIRECTORY_MODE = 0o700;
+const GLOBAL_CONFIG_FILE_MODE = 0o600;
+export function globalConfigPath() {
+    return resolve(homedir(), ".zvec-grep", "config.json");
+}
+export function readGlobalConfig(path = globalConfigPath()) {
+    const value = readJsonFileSync(path, null);
+    if (value === null) {
+        return emptyGlobalConfig();
+    }
+    return parseGlobalConfig(value, path);
+}
+export function updateGlobalConfig(update, path = globalConfigPath()) {
+    const lock = acquireReadWriteLock(join(dirname(path), "locks", "config"), "write", {
+        operation: "global-config.update",
+    });
+    try {
+        const current = readGlobalConfig(path);
+        const next = parseGlobalConfig({
+            version: GLOBAL_CONFIG_VERSION,
+            defaults: {
+                ...current.defaults,
+                ...update.defaults,
+            },
+            providers: mergeProviderConfigs(current.providers, update.providers),
+            models: mergeModelConfigs(current.models, update.models),
+            client: { ...current.client, ...update.client },
+            server: { ...current.server, ...update.server },
+            log: { ...current.log, ...update.log },
+        }, path);
+        writeJsonFileSync(path, next, {
+            directoryMode: GLOBAL_CONFIG_DIRECTORY_MODE,
+            fileMode: GLOBAL_CONFIG_FILE_MODE,
+        });
+        return next;
+    }
+    finally {
+        lock.release();
+    }
+}
+function emptyGlobalConfig() {
+    return { version: GLOBAL_CONFIG_VERSION };
+}
+function providerFromEmbedding(embedding) {
+    if (!embedding) {
+        return undefined;
+    }
+    const separator = embedding.indexOf("/");
+    return separator > 0 ? embedding.slice(0, separator) : undefined;
+}
+function parseGlobalConfig(value, path) {
+    if (!isRecord(value) || value.version !== GLOBAL_CONFIG_VERSION) {
+        throw invalidConfig(path, "version must be 1");
+    }
+    assertKnownFields(value, ["version", "defaults", "providers", "models", "client", "server", "log"], path, "config");
+    const defaults = parseDefaults(value.defaults, path);
+    const providers = parseProviders(value.providers, path);
+    const models = parseModels(value.models, path);
+    const client = parseClient(value.client, path);
+    const server = parseServer(value.server, path);
+    const log = parseLog(value.log, path);
+    return {
+        version: GLOBAL_CONFIG_VERSION,
+        ...(defaults ? { defaults } : {}),
+        ...(providers ? { providers } : {}),
+        ...(models ? { models } : {}),
+        ...(client ? { client } : {}),
+        ...(server ? { server } : {}),
+        ...(log ? { log } : {}),
+    };
+}
+function parseLog(value, path) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value))
+        throw invalidConfig(path, "log must be an object");
+    assertKnownFields(value, ["maxBytes", "keep", "level"], path, "log");
+    const log = {};
+    for (const key of ["maxBytes", "keep"]) {
+        const number = value[key];
+        if (number === undefined)
+            continue;
+        const minimum = key === "keep" ? 0 : 1;
+        if (typeof number !== "number" ||
+            !Number.isSafeInteger(number) ||
+            number < minimum) {
+            throw invalidConfig(path, `log.${key} must be a safe integer >= ${minimum}`);
+        }
+        log[key] = number;
+    }
+    if (value.level !== undefined) {
+        if (value.level !== "info" && value.level !== "debug") {
+            throw invalidConfig(path, "log.level must be info or debug");
+        }
+        log.level = value.level;
+    }
+    return Object.keys(log).length ? log : undefined;
+}
+function parseModels(value, path) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value))
+        throw invalidConfig(path, "models must be an object");
+    const models = {};
+    for (const [reference, modelValue] of Object.entries(value)) {
+        if (!/^[a-z][a-z0-9_-]*\/[A-Za-z0-9._-]+$/.test(reference) ||
+            !isRecord(modelValue)) {
+            throw invalidConfig(path, `models.${reference} must be an object with a valid embedding reference`);
+        }
+        assertKnownFields(modelValue, ["endpoint", "device"], path, `models.${reference}`);
+        const endpoint = optionalNonEmptyString(modelValue.endpoint, path, `models.${reference}.endpoint`);
+        if (endpoint !== undefined && !isHttpEndpoint(endpoint)) {
+            throw invalidConfig(path, `models.${reference}.endpoint must be a valid HTTP(S) URL`);
+        }
+        const device = optionalDevice(modelValue.device, path, `models.${reference}.device`);
+        if (reference.startsWith("local/") && endpoint !== undefined) {
+            throw invalidConfig(path, `models.${reference}.endpoint is only supported for remote models`);
+        }
+        if (!reference.startsWith("local/") && device !== undefined) {
+            throw invalidConfig(path, `models.${reference}.device is only supported for local models`);
+        }
+        const config = {
+            ...(endpoint !== undefined ? { endpoint } : {}),
+            ...(device !== undefined ? { device } : {}),
+        };
+        if (Object.keys(config).length > 0)
+            models[reference] = config;
+    }
+    return Object.keys(models).length > 0 ? models : undefined;
+}
+function parseClient(value, path) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value))
+        throw invalidConfig(path, "client must be an object");
+    assertKnownFields(value, ["mode", "serverUrl"], path, "client");
+    const mode = value.mode;
+    if (mode !== undefined &&
+        mode !== "direct" &&
+        mode !== "server" &&
+        mode !== "auto") {
+        throw invalidConfig(path, "client.mode must be direct, server, or auto");
+    }
+    const serverUrl = optionalNonEmptyString(value.serverUrl, path, "client.serverUrl");
+    return mode || serverUrl
+        ? { ...(mode ? { mode } : {}), ...(serverUrl ? { serverUrl } : {}) }
+        : undefined;
+}
+function parseServer(value, path) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value))
+        throw invalidConfig(path, "server must be an object");
+    assertKnownFields(value, ["host", "port"], path, "server");
+    const host = optionalNonEmptyString(value.host, path, "server.host");
+    const port = value.port === undefined
+        ? undefined
+        : optionalPositiveInteger(value.port, path, "server.port");
+    if (port !== undefined && port > 65_535)
+        throw invalidConfig(path, "server.port must not exceed 65535");
+    return host || port
+        ? { ...(host ? { host } : {}), ...(port ? { port } : {}) }
+        : undefined;
+}
+function parseDefaults(value, path) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!isRecord(value)) {
+        throw invalidConfig(path, "defaults must be an object");
+    }
+    assertKnownFields(value, ["embedding", "modelCacheDir"], path, "defaults");
+    const embedding = optionalNonEmptyString(value.embedding, path, "defaults.embedding");
+    const modelCacheDir = optionalNonEmptyString(value.modelCacheDir, path, "defaults.modelCacheDir");
+    const defaults = {
+        ...(embedding ? { embedding } : {}),
+        ...(modelCacheDir ? { modelCacheDir } : {}),
+    };
+    return Object.keys(defaults).length > 0 ? defaults : undefined;
+}
+function parseProviders(value, path) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!isRecord(value)) {
+        throw invalidConfig(path, "providers must be an object");
+    }
+    const providers = {};
+    for (const [provider, providerValue] of Object.entries(value)) {
+        if (!/^[a-z][a-z0-9_-]*$/.test(provider) || !isRecord(providerValue)) {
+            throw invalidConfig(path, `providers.${provider} must be an object with a valid provider name`);
+        }
+        assertKnownFields(providerValue, ["apiKey"], path, `providers.${provider}`);
+        const apiKey = optionalNonEmptyString(providerValue.apiKey, path, `providers.${provider}.apiKey`);
+        const config = {
+            ...(apiKey ? { apiKey } : {}),
+        };
+        if (Object.keys(config).length > 0) {
+            providers[provider] = config;
+        }
+    }
+    return Object.keys(providers).length > 0 ? providers : undefined;
+}
+function mergeProviderConfigs(current, update) {
+    if (!current && !update) {
+        return undefined;
+    }
+    const merged = { ...current };
+    for (const [provider, config] of Object.entries(update ?? {})) {
+        merged[provider] = {
+            ...merged[provider],
+            ...config,
+        };
+    }
+    return merged;
+}
+function mergeModelConfigs(current, update) {
+    if (!current && !update)
+        return undefined;
+    const merged = { ...current };
+    for (const [reference, config] of Object.entries(update ?? {})) {
+        merged[reference] = { ...merged[reference], ...config };
+    }
+    return merged;
+}
+function optionalNonEmptyString(value, path, field) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw invalidConfig(path, `${field} must be a non-empty string`);
+    }
+    return value.trim();
+}
+function optionalPositiveInteger(value, path, field) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!Number.isInteger(value) || value <= 0) {
+        throw invalidConfig(path, `${field} must be a positive integer`);
+    }
+    return value;
+}
+function optionalDevice(value, path, field) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value === "auto" ||
+        value === "cpu" ||
+        value === "metal" ||
+        value === "vulkan" ||
+        value === "cuda") {
+        return value;
+    }
+    throw invalidConfig(path, `${field} must be auto, cpu, metal, vulkan, or cuda`);
+}
+function environmentApiKey(provider, environment) {
+    const values = provider === "qwen"
+        ? [
+            environment.ZVEC_GREP_API_KEY,
+            environment.DASHSCOPE_API_KEY,
+            environment.QWEN_API_KEY,
+        ]
+        : [environment.ZVEC_GREP_API_KEY];
+    return values.map(nonEmptyEnvironmentValue).find(Boolean);
+}
+function nonEmptyEnvironmentValue(value) {
+    const normalized = value?.trim();
+    return normalized ? normalized : undefined;
+}
+function environmentDevice(environment) {
+    const normalized = environment.ZVEC_GREP_DEVICE?.trim().toLowerCase() ?? "";
+    if (["auto", "cpu", "metal", "vulkan", "cuda"].includes(normalized))
+        return normalized;
+    return "auto";
+}
+function assertKnownFields(value, allowed, path, field) {
+    const allowedFields = new Set(allowed);
+    for (const key of Object.keys(value)) {
+        if (!allowedFields.has(key)) {
+            throw invalidConfig(path, `${field}.${key} is not supported`);
+        }
+    }
+}
+function invalidConfig(path, detail) {
+    return new EngineError("zvec-grep global config is invalid", {
+        code: "ZVEC_GREP.ENGINE.CONFIG.INVALID",
+        context: `path=${path}\ndetail=${detail}`,
+    });
+}
+function invalidRuntime(reference, message) {
+    return new EngineError("Embedding runtime configuration is invalid", {
+        code: "ZVEC_GREP.ENGINE.CONFIG.INVALID_EMBEDDING_RUNTIME",
+        context: `reference=${reference}\ndetail=${message}`,
+    });
+}
+function isHttpEndpoint(value) {
+    try {
+        const url = new URL(value);
+        return url.protocol === "http:" || url.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=config.js.map

package/dist/engine/config.js.map

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

package/dist/engine/errors.d.ts

@@ -0,0 +1,20 @@
+export declare const ENGINE_ERROR_CODE_PREFIX = "ZVEC_GREP.ENGINE";
+export type EngineErrorCode = `${typeof ENGINE_ERROR_CODE_PREFIX}.${string}`;
+export type EngineErrorOptions = {
+    code: EngineErrorCode;
+    context?: string;
+    cause?: unknown;
+};
+export declare class EngineError extends Error {
+    readonly code: EngineErrorCode;
+    readonly context?: string;
+    constructor(message: string, options: EngineErrorOptions);
+}
+export declare function isEngineError(error: unknown): error is EngineError;
+type ErrorDetailValue = string | number | boolean | null | undefined;
+export type ErrorDetailEntry = string | readonly [string, ErrorDetailValue] | null | undefined;
+export declare function errorDetails(entries: readonly ErrorDetailEntry[]): string | undefined;
+export declare function detail(key: string, value: ErrorDetailValue): ErrorDetailEntry;
+export declare function workspaceIndexDetail(name: string): ErrorDetailEntry;
+export declare function redactErrorText(value: string, maxLength: number): string;
+export {};

package/dist/engine/errors.js

@@ -0,0 +1,51 @@
+export const ENGINE_ERROR_CODE_PREFIX = "ZVEC_GREP.ENGINE";
+export class EngineError extends Error {
+    code;
+    context;
+    constructor(message, options) {
+        super(message, { cause: options.cause });
+        this.name = "EngineError";
+        this.code = options.code;
+        this.context = options.context;
+    }
+}
+export function isEngineError(error) {
+    return error instanceof EngineError;
+}
+export function errorDetails(entries) {
+    const lines = entries
+        .map(formatDetailEntry)
+        .filter((line) => line !== null && line.length > 0);
+    return lines.length > 0 ? lines.join("\n") : undefined;
+}
+export function detail(key, value) {
+    return value === null || value === undefined ? null : [key, value];
+}
+export function workspaceIndexDetail(name) {
+    return detail("workspaceIndex", name);
+}
+export function redactErrorText(value, maxLength) {
+    const redacted = value
+        .replace(/(?<![a-z0-9+.-])([a-z][a-z0-9+.-]*:\/\/)[^/\s@]+@/gi, "$1[redacted]@")
+        .replace(/(["']?authorization["']?\s*[:=]\s*)(?:"(?:\\[\s\S]|[^"\\])*"|'(?:\\[\s\S]|[^'\\])*'|[^\r\n]+)/gi, "$1[redacted]")
+        .replace(/\b(Bearer|Basic)[^\S\r\n]+(?:"(?:\\[^\r\n]|[^"\\\r\n])*"|'(?:\\[^\r\n]|[^'\\\r\n])*'|[^\s"',;]+)/gi, "$1 [redacted]")
+        .replace(/(["']?(?:api[_ -]?key|(?:access[_ -]?|refresh[_ -]?|id[_ -]?)?token|authorization|password|secret)["']?\s*[:=]\s*)(?:"(?:\\[\s\S]|[^"\\])*"|'(?:\\[\s\S]|[^'\\])*'|[^\s&]+)/gi, "$1[redacted]")
+        .replace(/\bsk-[A-Za-z0-9_-]{8,}\b/gi, "sk-[redacted]");
+    return redacted.length <= maxLength
+        ? redacted
+        : `${redacted.slice(0, maxLength - 1)}…`;
+}
+function formatDetailEntry(entry) {
+    if (entry === null || entry === undefined) {
+        return null;
+    }
+    if (typeof entry === "string") {
+        return entry.trim().length > 0 ? entry.trim() : null;
+    }
+    const [key, value] = entry;
+    if (value === null || value === undefined) {
+        return null;
+    }
+    return `${key}=${String(value)}`;
+}
+//# sourceMappingURL=errors.js.map

package/dist/engine/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/engine/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;AAU3D,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAkB;IACtB,OAAO,CAAU;IAE1B,YAAY,OAAe,EAAE,OAA2B;QACtD,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;CACF;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,KAAK,YAAY,WAAW,CAAC;AACtC,CAAC;AAOD,MAAM,UAAU,YAAY,CAC1B,OAAoC;IAEpC,MAAM,KAAK,GAAG,OAAO;SAClB,GAAG,CAAC,iBAAiB,CAAC;SACtB,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEtE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAW,EAAE,KAAuB;IACzD,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,MAAM,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,SAAiB;IAC9D,MAAM,QAAQ,GAAG,KAAK;SACnB,OAAO,CACN,qDAAqD,EACrD,eAAe,CAChB;SACA,OAAO,CACN,iGAAiG,EACjG,cAAc,CACf;SACA,OAAO,CACN,oGAAoG,EACpG,eAAe,CAChB;SACA,OAAO,CACN,+KAA+K,EAC/K,cAAc,CACf;SACA,OAAO,CAAC,4BAA4B,EAAE,eAAe,CAAC,CAAC;IAC1D,OAAO,QAAQ,CAAC,MAAM,IAAI,SAAS;QACjC,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC;AAC7C,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAuB;IAChD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACvD,CAAC;IAED,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC;IAC3B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACnC,CAAC"}

package/dist/engine/extraction/code/adapter.d.ts

@@ -0,0 +1,19 @@
+import type { CodeEntityModifier, CodeSymbolType } from "../../types.js";
+import type { TSNode } from "./tree-sitter/nodes.js";
+export type LanguageAdapter = {
+    format: string;
+    entityTypes: ReadonlySet<string>;
+    scopeTypes: ReadonlySet<string>;
+    extractName(node: TSNode): string | undefined;
+    shouldIndexEntity?(node: TSNode): boolean;
+    shouldEnterScope?(node: TSNode): boolean;
+    resolveEntities?(node: TSNode): readonly TSNode[];
+    enterScopeNode?(node: TSNode): TSNode;
+    resolveEntity?(node: TSNode): TSNode;
+    scopeBreadcrumb?(node: TSNode, breadcrumb: readonly string[]): readonly string[];
+    classifyNode?(node: TSNode, breadcrumb: readonly string[]): CodeSymbolType | undefined;
+    extractSignature?(node: TSNode): string | undefined;
+    extractDoc?(node: TSNode): string | undefined;
+    extractModifiers?(node: TSNode): readonly CodeEntityModifier[];
+};
+export declare function resolveAdapter(format: string): LanguageAdapter | null;

package/dist/engine/extraction/code/adapter.js

@@ -0,0 +1,24 @@
+import { C_ADAPTER } from "./languages/c.js";
+import { CPP_ADAPTER } from "./languages/cpp.js";
+import { GO_ADAPTER } from "./languages/go.js";
+import { JAVA_ADAPTER } from "./languages/java.js";
+import { JAVASCRIPT_ADAPTER } from "./languages/javascript.js";
+import { PYTHON_ADAPTER } from "./languages/python.js";
+import { RUST_ADAPTER } from "./languages/rust.js";
+import { TYPESCRIPT_ADAPTER } from "./languages/typescript.js";
+const ADAPTERS = {
+    c: C_ADAPTER,
+    cpp: CPP_ADAPTER,
+    go: GO_ADAPTER,
+    java: JAVA_ADAPTER,
+    javascript: JAVASCRIPT_ADAPTER,
+    jsx: JAVASCRIPT_ADAPTER,
+    python: PYTHON_ADAPTER,
+    rust: RUST_ADAPTER,
+    tsx: TYPESCRIPT_ADAPTER,
+    typescript: TYPESCRIPT_ADAPTER,
+};
+export function resolveAdapter(format) {
+    return format in ADAPTERS ? ADAPTERS[format] : null;
+}
+//# sourceMappingURL=adapter.js.map

package/dist/engine/extraction/code/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../../src/engine/extraction/code/adapter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAyB/D,MAAM,QAAQ,GAAG;IACf,CAAC,EAAE,SAAS;IACZ,GAAG,EAAE,WAAW;IAChB,EAAE,EAAE,UAAU;IACd,IAAI,EAAE,YAAY;IAClB,UAAU,EAAE,kBAAkB;IAC9B,GAAG,EAAE,kBAAkB;IACvB,MAAM,EAAE,cAAc;IACtB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,kBAAkB;IACvB,UAAU,EAAE,kBAAkB;CACyB,CAAC;AAE1D,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAA8B,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9E,CAAC"}

package/dist/engine/extraction/code/extractor.d.ts

@@ -0,0 +1,13 @@
+import type { EntityFragment } from "../../types.js";
+import { type Source } from "../source.js";
+import type { ChunkOptions } from "../types.js";
+export declare class CodeExtractor {
+    extract(source: Source, options?: ChunkOptions): Promise<EntityFragment[]>;
+    extractForIndexing(source: Source, options?: ChunkOptions): Promise<PreparedCodeFragment[]>;
+    private fallback;
+    private extractScriptBlocks;
+}
+export type PreparedCodeFragment = {
+    fragment: EntityFragment;
+    embeddingText?: string;
+};