@lzehrung/codegraph-native 1.9.0

package/index.d.ts

@@ -0,0 +1,94 @@
+/* auto-generated by NAPI-RS */
+/* eslint-disable */
+/**
+ * Compact capture with only name and text -- used by graph-mode imports
+ * where position and node-type data are not consumed by the caller.
+ */
+export interface CompactCapture {
+  name: string
+  text: string
+}
+
+export interface CompactMatch {
+  patternIndex: number
+  captures: Array<CompactCapture>
+}
+
+export interface CompactQueryResults {
+  imports: Array<CompactMatch>
+}
+
+export declare function extractLanguage(source: string, languageId: string, importsQuery: string, exportsQuery: string, localsQuery: string, importBindingsQuery: string): NativeLanguageExtraction
+
+export interface NativeCapture {
+  name: string
+  text: string
+  nodeType: string
+  start: NativePoint
+  end: NativePoint
+}
+
+export interface NativeDuplicateTokens {
+  normalizedTokens: Array<string>
+}
+
+export interface NativeLanguageExtraction {
+  results: NativeQueryResults
+  syntaxTree: NativeSyntaxTree
+}
+
+export interface NativeMatch {
+  patternIndex: number
+  captures: Array<NativeCapture>
+}
+
+export interface NativePoint {
+  row: number
+  column: number
+  index: number
+}
+
+export interface NativeQueryResults {
+  imports: Array<NativeMatch>
+  exports: Array<NativeMatch>
+  locals: Array<NativeMatch>
+  importBindings: Array<NativeMatch>
+}
+
+export interface NativeQueryRunResult {
+  matches: Array<NativeMatch>
+}
+
+export interface NativeSyntaxNode {
+  id: number
+  parentId: number
+  nodeType: string
+  named: boolean
+  start: NativePoint
+  end: NativePoint
+  childIds: Array<number>
+  namedChildIds: Array<number>
+  childFieldNames: Array<string>
+}
+
+export interface NativeSyntaxTree {
+  rootId: number
+  nodes: Array<NativeSyntaxNode>
+}
+
+export declare function parseSyntaxTree(source: string, languageId: string): NativeSyntaxTree
+
+/**
+ * Run only the imports query and return compact results (name + text only).
+ * This is the graph-mode entrypoint optimized for minimal marshaling.
+ */
+export declare function runImportsQueryCompact(source: string, languageId: string, importsQuery: string): CompactQueryResults
+
+export declare function runLanguageQueries(source: string, languageId: string, importsQuery: string, exportsQuery: string, localsQuery: string, importBindingsQuery: string): NativeQueryResults
+
+/** Execute a single arbitrary query and return full capture metadata. */
+export declare function runQuery(source: string, languageId: string, queryText: string): NativeQueryRunResult
+
+export declare function supportedLanguageIds(): Array<string>
+
+export declare function tokenizeDuplicateSource(source: string): NativeDuplicateTokens

package/index.js

@@ -0,0 +1,64 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { createRequire } from "node:module";
+import childProcess from "node:child_process";
+import { nativeTargetSuffixForPlatform } from "./platform.js";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const require = createRequire(import.meta.url);
+
+function isMusl() {
+  if (process.platform !== "linux") return false;
+  const report = process.report?.getReport();
+  if (report?.header?.glibcVersionRuntime) return false;
+  try {
+    return childProcess.execSync("ldd --version", { encoding: "utf8" }).toLowerCase().includes("musl");
+  } catch {
+    return true;
+  }
+}
+
+function platformPackageSuffix() {
+  const linuxAbi = isMusl() ? "musl" : "gnu";
+  return nativeTargetSuffixForPlatform(process.platform, process.arch, linuxAbi);
+}
+
+function findLocalNativeBinary() {
+  const suffix = platformPackageSuffix();
+  if (!suffix) return null;
+  const expectedName = `index.${suffix}.node`;
+  const files = fs.readdirSync(__dirname);
+  const binary = files.find((file) => file === expectedName);
+  return binary ? path.join(__dirname, binary) : null;
+}
+
+function loadBinding() {
+  const localBinary = findLocalNativeBinary();
+  if (localBinary) return require(localBinary);
+
+  const suffix = platformPackageSuffix();
+  if (suffix) {
+    try {
+      return require(`@lzehrung/codegraph-native-${suffix}`);
+    } catch {
+      // Fall through to the final error below.
+    }
+  }
+
+  throw new Error(
+    "Codegraph native addon is unavailable for this platform. Build it locally with `npm run build:native` or install a published native package for this target.",
+  );
+}
+
+const binding = loadBinding();
+
+export const parseSyntaxTree = binding.parseSyntaxTree;
+export const extractLanguage = binding.extractLanguage;
+export const runImportsQueryCompact = binding.runImportsQueryCompact;
+export const runLanguageQueries = binding.runLanguageQueries;
+export const runQuery = binding.runQuery;
+export const tokenizeDuplicateSource = binding.tokenizeDuplicateSource;
+export const supportedLanguageIds = binding.supportedLanguageIds;
+export default binding;

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@lzehrung/codegraph-native",
+  "version": "1.9.0",
+  "type": "module",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    }
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "platform.js"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lzehrung/codegraph.git",
+    "directory": "packages/codegraph-native"
+  },
+  "scripts": {
+    "build": "node ../../node_modules/@napi-rs/cli/dist/cli.js build --platform --release --cwd . --no-js --dts index.d.ts",
+    "build:debug": "node ../../node_modules/@napi-rs/cli/dist/cli.js build --platform --cwd . --no-js --dts index.d.ts",
+    "clean": "cargo clean",
+    "create-npm-dirs": "node ../../node_modules/@napi-rs/cli/dist/cli.js create-npm-dirs --cwd .",
+    "artifacts": "node ../../node_modules/@napi-rs/cli/dist/cli.js artifacts --cwd .",
+    "prepublish:napi": "node ../../node_modules/@napi-rs/cli/dist/cli.js pre-publish --cwd ."
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "napi": {
+    "binaryName": "index",
+    "packageName": "@lzehrung/codegraph-native",
+    "targets": [
+      "x86_64-pc-windows-msvc",
+      "aarch64-pc-windows-msvc",
+      "x86_64-apple-darwin",
+      "aarch64-apple-darwin",
+      "x86_64-unknown-linux-gnu",
+      "aarch64-unknown-linux-gnu",
+      "x86_64-unknown-linux-musl",
+      "aarch64-unknown-linux-musl"
+    ]
+  },
+  "optionalDependencies": {
+    "@lzehrung/codegraph-native-darwin-arm64": "1.9.0",
+    "@lzehrung/codegraph-native-darwin-x64": "1.9.0",
+    "@lzehrung/codegraph-native-linux-arm64-gnu": "1.9.0",
+    "@lzehrung/codegraph-native-linux-arm64-musl": "1.9.0",
+    "@lzehrung/codegraph-native-linux-x64-gnu": "1.9.0",
+    "@lzehrung/codegraph-native-linux-x64-musl": "1.9.0",
+    "@lzehrung/codegraph-native-win32-arm64-msvc": "1.9.0",
+    "@lzehrung/codegraph-native-win32-x64-msvc": "1.9.0"
+  }
+}

package/platform.js

@@ -0,0 +1,17 @@
+export function nativeTargetSuffixForPlatform(platform, arch, linuxAbi) {
+  if (platform === "win32") {
+    if (arch === "x64") return "win32-x64-msvc";
+    if (arch === "arm64") return "win32-arm64-msvc";
+    return null;
+  }
+  if (platform === "darwin") {
+    if (arch === "x64") return "darwin-x64";
+    if (arch === "arm64") return "darwin-arm64";
+    return null;
+  }
+  if (platform === "linux") {
+    if (arch === "x64") return `linux-x64-${linuxAbi}`;
+    if (arch === "arm64") return `linux-arm64-${linuxAbi}`;
+  }
+  return null;
+}