homegraph 1.1.3 → 1.4.1

package/dist/extraction/languages/nix.js

@@ -0,0 +1,294 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nixExtractor = void 0;
+const tree_sitter_helpers_1 = require("../tree-sitter-helpers");
+function unwrapVariableExpression(node) {
+    if (node.type !== 'variable_expression')
+        return node;
+    return node.namedChild(0) ?? node;
+}
+function getCalleeName(node, source) {
+    let current = node;
+    while (current.type === 'apply_expression') {
+        const funcNode = current.childForFieldName('function') || current.namedChild(0);
+        if (!funcNode)
+            break;
+        current = funcNode;
+    }
+    current = unwrapVariableExpression(current);
+    if (current.type === 'identifier' || current.type === 'select_expression') {
+        return (0, tree_sitter_helpers_1.getNodeText)(current, source).trim();
+    }
+    return null;
+}
+function getDirectCalleeName(node, source) {
+    let funcNode = node.childForFieldName('function') || node.namedChild(0);
+    if (!funcNode)
+        return null;
+    funcNode = unwrapVariableExpression(funcNode);
+    return (0, tree_sitter_helpers_1.getNodeText)(funcNode, source).trim();
+}
+function isStaticProjectPath(value) {
+    return ((value.startsWith('./') || value.startsWith('../')) &&
+        !/[\s{}()[\];"'<>$]/.test(value));
+}
+function getStaticImportPath(argNode, source) {
+    let current = argNode;
+    while (current.type === 'parenthesized_expression') {
+        const inner = current.namedChild(0);
+        if (!inner)
+            break;
+        current = inner;
+    }
+    let text = (0, tree_sitter_helpers_1.getNodeText)(current, source).trim();
+    if (((text.startsWith('"') && text.endsWith('"')) ||
+        (text.startsWith("'") && text.endsWith("'"))) &&
+        text.length >= 2) {
+        text = text.slice(1, -1);
+    }
+    return isStaticProjectPath(text) ? text : null;
+}
+function isReturnedAttrsetMember(node) {
+    let current = node;
+    let seenReturnedAttrset = false;
+    while (current) {
+        const parent = current.parent;
+        if (!parent)
+            break;
+        if (parent.type === 'let_expression') {
+            const bodyNode = parent.childForFieldName('body') || parent.childForFieldName('expression');
+            if (!bodyNode || !bodyNode.equals(current))
+                return false;
+        }
+        if (parent.type === 'binding' && !current.equals(node))
+            return false;
+        if (parent.type === 'formal_parameters' || parent.type === 'formals')
+            return false;
+        if (parent.type === 'attrset' ||
+            parent.type === 'rec_attrset' ||
+            parent.type === 'attrset_expression' ||
+            parent.type === 'rec_attrset_expression') {
+            seenReturnedAttrset = true;
+        }
+        current = parent;
+    }
+    return seenReturnedAttrset;
+}
+function getCurriedParamsAndBody(node, source) {
+    const params = [];
+    let current = node;
+    while (current.type === 'function_expression' && current.namedChildCount > 0) {
+        const bodyNode = current.namedChild(current.namedChildCount - 1);
+        if (!bodyNode)
+            break;
+        const paramPart = source.substring(current.startIndex, bodyNode.startIndex).trim();
+        const paramText = paramPart.endsWith(':') ? paramPart.slice(0, -1).trim() : paramPart;
+        if (paramText)
+            params.push(paramText);
+        if (bodyNode.type === 'function_expression') {
+            current = bodyNode;
+        }
+        else {
+            return { params, bodyNode };
+        }
+    }
+    return {
+        params,
+        bodyNode: current.namedChildCount > 0 ? current.namedChild(current.namedChildCount - 1) : null,
+    };
+}
+function formatFunctionSignature(params) {
+    if (params.length === 0)
+        return '()';
+    if (params.length > 1)
+        return params.join(' : ');
+    const [param] = params;
+    if (!param)
+        return '()';
+    return param.startsWith('(') || param.includes('{') || param.includes('@') ? param : `(${param})`;
+}
+function inheritedAttrs(node) {
+    return node.namedChildren.find((child) => child.type === 'inherited_attrs') ?? null;
+}
+/**
+ * `callPackage ./pkg.nix { }` and `pkgs.callPackage ../tools/foo { }` — the
+ * nixpkgs auto-wiring idiom — reference a file the same way `import` does.
+ */
+function isCallPackageName(name) {
+    return (name === 'callPackage' ||
+        name === 'callPackages' ||
+        name.endsWith('.callPackage') ||
+        name.endsWith('.callPackages'));
+}
+/** Innermost argument of a curried apply chain: `f a b` → `a`. */
+function getFirstApplyArgument(node) {
+    let inner = node;
+    for (;;) {
+        const fn = inner.childForFieldName('function') || inner.namedChild(0);
+        if (fn && fn.type === 'apply_expression') {
+            inner = fn;
+            continue;
+        }
+        break;
+    }
+    return inner.childForFieldName('argument') || inner.namedChild(1);
+}
+/** Import node + unresolved `imports` ref for a static project path. */
+function emitFileImport(ctx, importPath, anchorNode, source) {
+    const impNode = ctx.createNode('import', importPath, anchorNode, {
+        signature: (0, tree_sitter_helpers_1.getNodeText)(anchorNode, source).trim().slice(0, 100),
+    });
+    if (impNode && ctx.nodeStack.length > 0) {
+        const fromNodeId = ctx.nodeStack[ctx.nodeStack.length - 1];
+        if (fromNodeId) {
+            ctx.addUnresolvedReference({
+                fromNodeId,
+                referenceName: importPath,
+                referenceKind: 'imports',
+                line: anchorNode.startPosition.row + 1,
+                column: anchorNode.startPosition.column,
+            });
+        }
+    }
+}
+exports.nixExtractor = {
+    functionTypes: [],
+    classTypes: [],
+    methodTypes: [],
+    interfaceTypes: [],
+    structTypes: [],
+    enumTypes: [],
+    typeAliasTypes: [],
+    importTypes: [],
+    callTypes: [],
+    variableTypes: [],
+    nameField: '',
+    bodyField: '',
+    paramsField: '',
+    visitNode: (node, ctx) => {
+        const { source } = ctx;
+        if (node.type === 'binding') {
+            const attrpath = node.childForFieldName('attrpath') || node.namedChild(0);
+            if (!attrpath)
+                return false;
+            const name = (0, tree_sitter_helpers_1.getNodeText)(attrpath, source).trim();
+            if (!name)
+                return false;
+            const valueNode = node.childForFieldName('expression') || node.childForFieldName('value') || node.namedChild(1);
+            if (!valueNode)
+                return false;
+            if (valueNode.type === 'function_expression') {
+                const { params, bodyNode } = getCurriedParamsAndBody(valueNode, source);
+                const funcNode = ctx.createNode('function', name, node, {
+                    signature: formatFunctionSignature(params),
+                    isExported: isReturnedAttrsetMember(node),
+                });
+                if (funcNode) {
+                    ctx.pushScope(funcNode.id);
+                    if (bodyNode)
+                        ctx.visitNode(bodyNode);
+                    ctx.popScope();
+                }
+            }
+            else {
+                const initValue = (0, tree_sitter_helpers_1.getNodeText)(valueNode, source).slice(0, 100);
+                ctx.createNode('variable', name, node, {
+                    signature: initValue ? `= ${initValue}${initValue.length >= 100 ? '...' : ''}` : undefined,
+                    isExported: isReturnedAttrsetMember(node),
+                });
+                // NixOS/home-manager module lists: `imports = [ ./hardware.nix ../common ]`
+                // (and the flake-era `modules = [ ./configuration.nix ]`) reference files
+                // without an `import` call. Only literal `path_expression` entries count —
+                // variables and interpolations stay dynamic (silent beats wrong).
+                const finalSegment = name.split('.').pop();
+                if ((finalSegment === 'imports' || finalSegment === 'modules') && valueNode.type === 'list_expression') {
+                    for (const child of valueNode.namedChildren) {
+                        if (child.type === 'path_expression') {
+                            const entryPath = (0, tree_sitter_helpers_1.getNodeText)(child, source).trim();
+                            if (isStaticProjectPath(entryPath)) {
+                                emitFileImport(ctx, entryPath, child, source);
+                            }
+                        }
+                    }
+                }
+                ctx.visitNode(valueNode);
+            }
+            return true;
+        }
+        if (node.type === 'function_expression') {
+            const bodyNode = node.namedChild(node.namedChildCount - 1);
+            if (bodyNode)
+                ctx.visitNode(bodyNode);
+            return true;
+        }
+        if (node.type === 'inherit' || node.type === 'inherit_from') {
+            const attrs = inheritedAttrs(node);
+            if (attrs) {
+                for (const child of attrs.namedChildren) {
+                    const name = (0, tree_sitter_helpers_1.getNodeText)(child, source).trim();
+                    if (name) {
+                        ctx.createNode('variable', name, child, {
+                            isExported: isReturnedAttrsetMember(child),
+                        });
+                    }
+                }
+            }
+            for (const child of node.namedChildren) {
+                if (child.type !== 'inherited_attrs')
+                    ctx.visitNode(child);
+            }
+            return true;
+        }
+        if (node.type === 'apply_expression') {
+            const directCallee = getDirectCalleeName(node, source);
+            const isDirectImport = directCallee === 'import' || directCallee === 'builtins.import';
+            // Wrapper objects are re-created per access, so compare with .equals(),
+            // never === — otherwise every level of a curried chain (`f a b`)
+            // re-emits the same refs.
+            const parentFn = node.parent?.type === 'apply_expression'
+                ? (node.parent.childForFieldName('function') ?? node.parent.namedChild(0))
+                : null;
+            const isCalleeOfParent = parentFn ? parentFn.equals(node) : false;
+            if (!(isCalleeOfParent && !isDirectImport)) {
+                if (isDirectImport) {
+                    const argNode = node.childForFieldName('argument') || node.namedChild(1);
+                    const importPath = argNode ? getStaticImportPath(argNode, source) : null;
+                    if (importPath) {
+                        emitFileImport(ctx, importPath, node, source);
+                    }
+                }
+                else {
+                    const calleeName = getCalleeName(node, source);
+                    if (calleeName && calleeName !== 'import' && calleeName !== 'builtins.import' && ctx.nodeStack.length > 0) {
+                        const fromNodeId = ctx.nodeStack[ctx.nodeStack.length - 1];
+                        if (fromNodeId) {
+                            ctx.addUnresolvedReference({
+                                fromNodeId,
+                                referenceName: calleeName,
+                                referenceKind: 'calls',
+                                line: node.startPosition.row + 1,
+                                column: node.startPosition.column,
+                            });
+                        }
+                    }
+                    // `callPackage ./pkg.nix { }` loads the file like `import` does; the
+                    // first argument of the apply chain is the package file. Only a
+                    // literal static path counts (`callPackage pkgPath { }` stays dynamic).
+                    if (calleeName && isCallPackageName(calleeName)) {
+                        const firstArg = getFirstApplyArgument(node);
+                        const importPath = firstArg ? getStaticImportPath(firstArg, source) : null;
+                        if (importPath) {
+                            emitFileImport(ctx, importPath, node, source);
+                        }
+                    }
+                }
+            }
+            for (const child of node.namedChildren) {
+                ctx.visitNode(child);
+            }
+            return true;
+        }
+        return false;
+    },
+};
+//# sourceMappingURL=nix.js.map

package/dist/extraction/languages/nix.js.map

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

package/dist/extraction/languages/ohos-api-consumer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Consumer-side OHOS API db: detect compileSdkVersion, ensure npm package, ATTACH for queries.
+ */
+import type { QueryBuilder } from '../../db/queries';
+export declare const OHOS_API_FILE_PREFIX = "ohos-sdk:";
+export declare const OHOS_API_VERSION_META = "ohos_api_version";
+export declare const OHOS_API_DB_PATH_META = "ohos_api_db_path";
+export interface OhosApiDbBinding {
+    version: string;
+    dbPath: string;
+    packageName: string;
+    installed: boolean;
+}
+export interface OhosApiDbBindingWarning {
+    message: string;
+    code: 'ohos_api_version_unknown' | 'ohos_api_install_failed' | 'ohos_api_db_missing';
+}
+/** Prefix applied to API db node file paths so explore can render without disk reads. */
+export declare function markOhosApiFilePath(relativePath: string): string;
+export declare function isOhosApiFilePath(filePath: string): boolean;
+/** Strip json5 comments/trailing commas enough for compileSdkVersion extraction. */
+export declare function parseJson5Minimal(text: string): unknown;
+/** Normalize compileSdkVersion values like "6.0.1(21)" → "6.0.1". */
+export declare function normalizeOhosApiVersion(raw: unknown): string | null;
+/** Read compileSdkVersion from build-profile.json5 (root or module). */
+export declare function detectOhosCompileSdkVersion(projectRoot: string): string | null;
+export declare function isOhosArktsProject(projectRoot: string, languages?: string[]): boolean;
+/** Install npm package if local db is missing; non-throwing on failure. */
+export declare function ensureOhosApiDb(version: string): OhosApiDbBinding | OhosApiDbBindingWarning;
+/** Detect version, ensure db, persist metadata, ATTACH — never throws. */
+export declare function bindOhosApiDbForProject(projectRoot: string, queries: QueryBuilder, languages?: string[]): OhosApiDbBinding | OhosApiDbBindingWarning | null;
+/** Re-ATTACH from project metadata after reopen / new QueryBuilder. */
+export declare function restoreOhosApiDbAttach(queries: QueryBuilder): OhosApiDbBinding | null;
+//# sourceMappingURL=ohos-api-consumer.d.ts.map

package/dist/extraction/languages/ohos-api-consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ohos-api-consumer.d.ts","sourceRoot":"","sources":["../../../src/extraction/languages/ohos-api-consumer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAOrD,eAAO,MAAM,oBAAoB,cAAc,CAAC;AAChD,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AACxD,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,0BAA0B,GAAG,yBAAyB,GAAG,qBAAqB,CAAC;CACtF;AAED,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMvD;AAED,qEAAqE;AACrE,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAcnE;AAgDD,wEAAwE;AACxE,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmB9E;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAIrF;AAqBD,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,uBAAuB,CA0C3F;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,YAAY,EACrB,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,gBAAgB,GAAG,uBAAuB,GAAG,IAAI,CA6BnD;AAED,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,gBAAgB,GAAG,IAAI,CAerF"}

package/dist/extraction/languages/ohos-api-consumer.js

@@ -0,0 +1,283 @@
+"use strict";
+/**
+ * Consumer-side OHOS API db: detect compileSdkVersion, ensure npm package, ATTACH for queries.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OHOS_API_DB_PATH_META = exports.OHOS_API_VERSION_META = exports.OHOS_API_FILE_PREFIX = void 0;
+exports.markOhosApiFilePath = markOhosApiFilePath;
+exports.isOhosApiFilePath = isOhosApiFilePath;
+exports.parseJson5Minimal = parseJson5Minimal;
+exports.normalizeOhosApiVersion = normalizeOhosApiVersion;
+exports.detectOhosCompileSdkVersion = detectOhosCompileSdkVersion;
+exports.isOhosArktsProject = isOhosArktsProject;
+exports.ensureOhosApiDb = ensureOhosApiDb;
+exports.bindOhosApiDbForProject = bindOhosApiDbForProject;
+exports.restoreOhosApiDbAttach = restoreOhosApiDbAttach;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const arkts_1 = require("./arkts");
+exports.OHOS_API_FILE_PREFIX = 'ohos-sdk:';
+exports.OHOS_API_VERSION_META = 'ohos_api_version';
+exports.OHOS_API_DB_PATH_META = 'ohos_api_db_path';
+/** Prefix applied to API db node file paths so explore can render without disk reads. */
+function markOhosApiFilePath(relativePath) {
+    return `${exports.OHOS_API_FILE_PREFIX}${relativePath.replace(/\\/g, '/')}`;
+}
+function isOhosApiFilePath(filePath) {
+    return filePath.startsWith(exports.OHOS_API_FILE_PREFIX);
+}
+/** Strip json5 comments/trailing commas enough for compileSdkVersion extraction. */
+function parseJson5Minimal(text) {
+    const stripped = text
+        .replace(/\/\/.*$/gm, '')
+        .replace(/\/\*[\s\S]*?\*\//g, '')
+        .replace(/,(\s*[}\]])/g, '$1');
+    return JSON.parse(stripped);
+}
+/** Normalize compileSdkVersion values like "6.0.1(21)" → "6.0.1". */
+function normalizeOhosApiVersion(raw) {
+    if (raw == null)
+        return null;
+    if (typeof raw === 'number') {
+        const s = String(raw);
+        if (/^\d+$/.test(s) && s.length >= 8) {
+            const major = Math.floor(Number(s) / 1_000_000);
+            const minor = Math.floor((Number(s) % 1_000_000) / 1000);
+            const patch = Number(s) % 1000;
+            return `${major}.${minor}.${patch}`;
+        }
+        return null;
+    }
+    const match = String(raw).match(/(\d+\.\d+\.\d+)/);
+    return match?.[1] ?? null;
+}
+function findBuildProfileFiles(projectRoot) {
+    const found = [];
+    const rootProfile = path.join(projectRoot, 'build-profile.json5');
+    if (fs.existsSync(rootProfile))
+        found.push(rootProfile);
+    let entries;
+    try {
+        entries = fs.readdirSync(projectRoot, { withFileTypes: true });
+    }
+    catch {
+        return found;
+    }
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        if (entry.name === 'node_modules' || entry.name === '.git' || entry.name === '.homegraph')
+            continue;
+        const nested = path.join(projectRoot, entry.name, 'build-profile.json5');
+        if (fs.existsSync(nested))
+            found.push(nested);
+    }
+    return found;
+}
+function extractCompileSdkFromObject(obj) {
+    if (!obj || typeof obj !== 'object')
+        return null;
+    const record = obj;
+    for (const key of ['compileSdkVersion', 'compileSdk', 'targetSdkVersion']) {
+        const v = normalizeOhosApiVersion(record[key]);
+        if (v)
+            return v;
+    }
+    const app = record.app;
+    if (app && typeof app === 'object') {
+        const products = app.products;
+        if (Array.isArray(products)) {
+            for (const product of products) {
+                const v = extractCompileSdkFromObject(product);
+                if (v)
+                    return v;
+            }
+        }
+    }
+    for (const value of Object.values(record)) {
+        if (value && typeof value === 'object') {
+            const v = extractCompileSdkFromObject(value);
+            if (v)
+                return v;
+        }
+    }
+    return null;
+}
+/** Read compileSdkVersion from build-profile.json5 (root or module). */
+function detectOhosCompileSdkVersion(projectRoot) {
+    const envOverride = process.env.HOMEGRAPH_OHOS_API_VERSION?.trim();
+    if (envOverride) {
+        return normalizeOhosApiVersion(envOverride) ?? envOverride;
+    }
+    for (const profilePath of findBuildProfileFiles(projectRoot)) {
+        try {
+            const text = fs.readFileSync(profilePath, 'utf-8');
+            const parsed = parseJson5Minimal(text);
+            const version = extractCompileSdkFromObject(parsed);
+            if (version)
+                return version;
+        }
+        catch {
+            const match = fs.readFileSync(profilePath, 'utf-8').match(/compileSdkVersion\s*:\s*['"]?([^'"\s,)]+)/);
+            const v = normalizeOhosApiVersion(match?.[1]);
+            if (v)
+                return v;
+        }
+    }
+    return null;
+}
+function isOhosArktsProject(projectRoot, languages) {
+    if (languages?.includes('arkts'))
+        return true;
+    if (findBuildProfileFiles(projectRoot).length > 0)
+        return true;
+    return hasEtsUnder(projectRoot, 0);
+}
+function hasEtsUnder(dir, depth) {
+    if (depth > 4)
+        return false;
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return false;
+    }
+    for (const entry of entries) {
+        const full = path.join(dir, entry.name);
+        if (entry.isFile() && entry.name.endsWith('.ets'))
+            return true;
+        if (entry.isDirectory()) {
+            if (entry.name === 'node_modules' || entry.name === '.git' || entry.name === '.homegraph')
+                continue;
+            if (hasEtsUnder(full, depth + 1))
+                return true;
+        }
+    }
+    return false;
+}
+/** Install npm package if local db is missing; non-throwing on failure. */
+function ensureOhosApiDb(version) {
+    const dbPath = (0, arkts_1.ohosApiDbInstallPath)(version);
+    if (fs.existsSync(dbPath)) {
+        return {
+            version,
+            dbPath,
+            packageName: (0, arkts_1.ohosApiDbPackageName)(version),
+            installed: false,
+        };
+    }
+    const packageName = (0, arkts_1.ohosApiDbPackageName)(version);
+    const installDir = fs.mkdtempSync(path.join(os.tmpdir(), 'hg-ohos-npm-'));
+    try {
+        (0, child_process_1.execFileSync)('npm', ['install', '--no-save', packageName], {
+            cwd: installDir,
+            stdio: 'pipe',
+            timeout: 180_000,
+            env: { ...process.env, npm_config_loglevel: 'error' },
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            code: 'ohos_api_install_failed',
+            message: `Could not fetch ${packageName} (${msg}). ` +
+                'Explore will use project code only until the matching API db is available.',
+        };
+    }
+    finally {
+        fs.rmSync(installDir, { recursive: true, force: true });
+    }
+    if (!fs.existsSync(dbPath)) {
+        return {
+            code: 'ohos_api_db_missing',
+            message: `${packageName} was fetched but ${(0, arkts_1.ohosApiDbFilename)(version)} is missing under ~/.homegraph/api/. ` +
+                'Explore will use project code only.',
+        };
+    }
+    return { version, dbPath, packageName, installed: true };
+}
+/** Detect version, ensure db, persist metadata, ATTACH — never throws. */
+function bindOhosApiDbForProject(projectRoot, queries, languages) {
+    if (!isOhosArktsProject(projectRoot, languages))
+        return null;
+    const version = detectOhosCompileSdkVersion(projectRoot);
+    if (!version) {
+        return {
+            code: 'ohos_api_version_unknown',
+            message: 'HarmonyOS project detected but compileSdkVersion not found in build-profile.json5. ' +
+                'SDK API lookup disabled; project indexing continues normally.',
+        };
+    }
+    const ensured = ensureOhosApiDb(version);
+    if ('code' in ensured)
+        return ensured;
+    try {
+        queries.attachOhosApiDb(ensured.dbPath);
+        queries.setMetadata(exports.OHOS_API_VERSION_META, ensured.version);
+        queries.setMetadata(exports.OHOS_API_DB_PATH_META, ensured.dbPath);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            code: 'ohos_api_db_missing',
+            message: `Failed to attach OHOS API db at ${ensured.dbPath}: ${msg}`,
+        };
+    }
+    return ensured;
+}
+/** Re-ATTACH from project metadata after reopen / new QueryBuilder. */
+function restoreOhosApiDbAttach(queries) {
+    const dbPath = queries.getMetadata(exports.OHOS_API_DB_PATH_META);
+    const version = queries.getMetadata(exports.OHOS_API_VERSION_META);
+    if (!dbPath || !version || !fs.existsSync(dbPath))
+        return null;
+    try {
+        queries.attachOhosApiDb(dbPath);
+        return {
+            version,
+            dbPath,
+            packageName: (0, arkts_1.ohosApiDbPackageName)(version),
+            installed: false,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=ohos-api-consumer.js.map

package/dist/extraction/languages/ohos-api-consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ohos-api-consumer.js","sourceRoot":"","sources":["../../../src/extraction/languages/ohos-api-consumer.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BH,kDAEC;AAED,8CAEC;AAGD,8CAMC;AAGD,0DAcC;AAiDD,kEAmBC;AAED,gDAIC;AAsBD,0CA0CC;AAGD,0DAiCC;AAGD,wDAeC;AA5PD,uCAAyB;AACzB,uCAAyB;AACzB,2CAA6B;AAC7B,iDAA6C;AAE7C,mCAIiB;AAEJ,QAAA,oBAAoB,GAAG,WAAW,CAAC;AACnC,QAAA,qBAAqB,GAAG,kBAAkB,CAAC;AAC3C,QAAA,qBAAqB,GAAG,kBAAkB,CAAC;AAcxD,yFAAyF;AACzF,SAAgB,mBAAmB,CAAC,YAAoB;IACtD,OAAO,GAAG,4BAAoB,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,SAAgB,iBAAiB,CAAC,QAAgB;IAChD,OAAO,QAAQ,CAAC,UAAU,CAAC,4BAAoB,CAAC,CAAC;AACnD,CAAC;AAED,oFAAoF;AACpF,SAAgB,iBAAiB,CAAC,IAAY;IAC5C,MAAM,QAAQ,GAAG,IAAI;SAClB,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;SACxB,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;SAChC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IACjC,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAED,qEAAqE;AACrE,SAAgB,uBAAuB,CAAC,GAAY;IAClD,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;YAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;YACzD,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;YAC/B,OAAO,GAAG,KAAK,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;QACtC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACnD,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC5B,CAAC;AAED,SAAS,qBAAqB,CAAC,WAAmB;IAChD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC;IAClE,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAExD,IAAI,OAAoB,CAAC;IACzB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QACnC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;YAAE,SAAS;QACpG,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;QACzE,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,2BAA2B,CAAC,GAAY;IAC/C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,MAAM,GAAG,GAA8B,CAAC;IAC9C,KAAK,MAAM,GAAG,IAAI,CAAC,mBAAmB,EAAE,YAAY,EAAE,kBAAkB,CAAC,EAAE,CAAC;QAC1E,MAAM,CAAC,GAAG,uBAAuB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/C,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IACvB,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAI,GAA+B,CAAC,QAAQ,CAAC;QAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,MAAM,CAAC,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;gBAC/C,IAAI,CAAC;oBAAE,OAAO,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,CAAC,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC;YAC7C,IAAI,CAAC;gBAAE,OAAO,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,wEAAwE;AACxE,SAAgB,2BAA2B,CAAC,WAAmB;IAC7D,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,IAAI,EAAE,CAAC;IACnE,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,uBAAuB,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC;IAC7D,CAAC;IAED,KAAK,MAAM,WAAW,IAAI,qBAAqB,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7D,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACnD,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,OAAO,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;YACpD,IAAI,OAAO;gBAAE,OAAO,OAAO,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;YACvG,MAAM,CAAC,GAAG,uBAAuB,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9C,IAAI,CAAC;gBAAE,OAAO,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,kBAAkB,CAAC,WAAmB,EAAE,SAAoB;IAC1E,IAAI,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,IAAI,qBAAqB,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/D,OAAO,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,WAAW,CAAC,GAAW,EAAE,KAAa;IAC7C,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5B,IAAI,OAAoB,CAAC;IACzB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/D,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;gBAAE,SAAS;YACpG,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;QAChD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,2EAA2E;AAC3E,SAAgB,eAAe,CAAC,OAAe;IAC7C,MAAM,MAAM,GAAG,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,OAAO;YACP,MAAM;YACN,WAAW,EAAE,IAAA,4BAAoB,EAAC,OAAO,CAAC;YAC1C,SAAS,EAAE,KAAK;SACjB,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;IAC1E,IAAI,CAAC;QACH,IAAA,4BAAY,EAAC,KAAK,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE;YACzD,GAAG,EAAE,UAAU;YACf,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,OAAO;YAChB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,mBAAmB,EAAE,OAAO,EAAE;SACtD,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO;YACL,IAAI,EAAE,yBAAyB;YAC/B,OAAO,EACL,mBAAmB,WAAW,KAAK,GAAG,KAAK;gBAC3C,4EAA4E;SAC/E,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO;YACL,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EACL,GAAG,WAAW,oBAAoB,IAAA,yBAAiB,EAAC,OAAO,CAAC,uCAAuC;gBACnG,qCAAqC;SACxC,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC3D,CAAC;AAED,0EAA0E;AAC1E,SAAgB,uBAAuB,CACrC,WAAmB,EACnB,OAAqB,EACrB,SAAoB;IAEpB,IAAI,CAAC,kBAAkB,CAAC,WAAW,EAAE,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAE7D,MAAM,OAAO,GAAG,2BAA2B,CAAC,WAAW,CAAC,CAAC;IACzD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,IAAI,EAAE,0BAA0B;YAChC,OAAO,EACL,qFAAqF;gBACrF,+DAA+D;SAClE,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,MAAM,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAEtC,IAAI,CAAC;QACH,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO,CAAC,WAAW,CAAC,6BAAqB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5D,OAAO,CAAC,WAAW,CAAC,6BAAqB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO;YACL,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,mCAAmC,OAAO,CAAC,MAAM,KAAK,GAAG,EAAE;SACrE,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,uEAAuE;AACvE,SAAgB,sBAAsB,CAAC,OAAqB;IAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,6BAAqB,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,6BAAqB,CAAC,CAAC;IAC3D,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/D,IAAI,CAAC;QACH,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAChC,OAAO;YACL,OAAO;YACP,MAAM;YACN,WAAW,EAAE,IAAA,4BAAoB,EAAC,OAAO,CAAC;YAC1C,SAAS,EAAE,KAAK;SACjB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/extraction/languages/solidity.d.ts

@@ -0,0 +1,3 @@
+import type { LanguageExtractor } from '../tree-sitter-types';
+export declare const solidityExtractor: LanguageExtractor;
+//# sourceMappingURL=solidity.d.ts.map

package/dist/extraction/languages/solidity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solidity.d.ts","sourceRoot":"","sources":["../../../src/extraction/languages/solidity.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAsD9D,eAAO,MAAM,iBAAiB,EAAE,iBAiO/B,CAAC"}