@opentrace/components 0.1.1-rc.44 → 0.1.1-rc.54

package/README.md

@@ -0,0 +1,306 @@
+# @opentrace/components
+
+Shared library for the [OpenTrace](https://github.com/opentrace/opentrace) platform. Ships two independent feature sets:
+
+1. **Graph visualization** — React components powered by Sigma.js and Graphology
+2. **Ingest pipeline** — framework-free code parsing pipeline (no React required)
+
+## Installation
+
+```bash
+npm install @opentrace/components
+```
+
+## Entry points
+
+| Import path | Needs React | Description |
+|---|---|---|
+| `@opentrace/components` | Yes | Graph visualization components |
+| `@opentrace/components/pipeline` | No | Code parsing & knowledge graph pipeline |
+| `@opentrace/components/pipeline/wasm` | No (Node.js only) | WASM file path helpers |
+| `@opentrace/components/utils` | No | Shared utility functions |
+| `@opentrace/components/indexing` | Yes | Indexing UI components |
+| `@opentrace/components/style.css` | — | Base CSS styles |
+
+---
+
+## Graph visualization
+
+Interactive knowledge graph renderer built on [Sigma.js](https://www.sigmajs.org/).
+
+### Quick start
+
+```tsx
+import { GraphCanvas } from '@opentrace/components';
+import '@opentrace/components/style.css';
+
+const data = {
+  nodes: [
+    { id: '1', type: 'Service', name: 'api-gateway', properties: {} },
+    { id: '2', type: 'Service', name: 'user-service', properties: {} },
+  ],
+  links: [
+    { source: '1', target: '2', type: 'CALLS', id: 'e1' },
+  ],
+};
+
+function App() {
+  return <GraphCanvas data={data} height={600} />;
+}
+```
+
+### Components
+
+- **`GraphCanvas`** — main graph renderer with layout, filtering, and interaction
+- **`FilterPanel`** — node type / relationship type filter controls
+- **`GraphToolbar`** — zoom, fit, layout toggle controls
+- **`GraphLegend`** — color legend for node types
+- **`GraphBadge`** — node/edge count badge
+- **`DiscoverPanel`** — tree-based graph explorer
+- **`AddRepoModal`** — repository URL input modal
+- **`IndexingProgress`** — multi-stage indexing progress display
+
+### Hooks
+
+- `useGraphInstance` — access the underlying Graphology/Sigma instances
+- `useGraphFilters` — manage filter state
+- `useGraphVisuals` — control visual properties (colors, sizes, opacity)
+- `useCommunities` — Louvain community detection
+- `useHighlights` — node/edge highlight state
+
+---
+
+## Ingest pipeline
+
+Pure TypeScript pipeline that parses source code into a knowledge graph using [web-tree-sitter](https://github.com/nicolo-ribaudo/tree-sitter-wasm-prebuilt). No React, no browser APIs — works in Node.js, workers, or the browser.
+
+### Peer dependency
+
+The pipeline requires `web-tree-sitter` at runtime:
+
+```bash
+npm install web-tree-sitter
+```
+
+### Browser setup
+
+WASM grammar files must be served as static assets. Copy them to your app's public directory:
+
+```bash
+# All languages (~25 MB)
+npx opentrace-copy-wasm public/
+
+# Only the languages you need
+npx opentrace-copy-wasm --languages python,typescript,go public/
+
+# Just the runtime (if you load grammars separately)
+npx opentrace-copy-wasm --runtime-only public/
+```
+
+Add this to `package.json` to keep them in sync:
+
+```json
+{
+  "scripts": {
+    "postinstall": "opentrace-copy-wasm public/"
+  }
+}
+```
+
+### Running the pipeline
+
+```ts
+import { Parser, Language } from 'web-tree-sitter';
+import {
+  runPipeline,
+  initParsers,
+  collectPipeline,
+  type RepoTree,
+  type PipelineEvent,
+} from '@opentrace/components/pipeline';
+
+// 1. Initialize tree-sitter parsers
+await Parser.init({ locateFile: (file) => `/${file}` });
+
+const pyParser = new Parser();
+pyParser.setLanguage(await Language.load('/tree-sitter-python.wasm'));
+
+initParsers(new Map([['python', pyParser]]));
+
+// 2. Build a RepoTree (your files)
+const repo: RepoTree = {
+  owner: 'myorg',
+  repo: 'myproject',
+  ref: 'main',
+  files: [
+    { path: 'app.py', content: 'def hello():\n    print("hi")\n' },
+    { path: 'utils.py', content: 'def helper():\n    pass\n' },
+  ],
+};
+
+// 3. Run the pipeline (streaming)
+for (const event of runPipeline({ repo }, { cancelled: false })) {
+  if (event.nodes) {
+    console.log(`${event.phase}: ${event.nodes.length} nodes`);
+  }
+}
+
+// Or collect everything at once
+const { nodes, relationships } = collectPipeline(
+  { repo },
+  { cancelled: false },
+);
+```
+
+### Pipeline stages
+
+The pipeline is a chain of synchronous generators. Each stage yields `PipelineEvent` objects:
+
+```
+runPipeline()
+  saving(inner, store)              <- persists nodes/rels to the store
+    wrapWithSummaries(inner)        <- adds summary property to every node
+      corePipeline()                <- produces events via:
+        yield* scanning()           <- repo structure (files, dirs, packages)
+        yield* processing()         <- symbol extraction (classes, functions)
+        yield* resolving()          <- call resolution (CALLS relationships)
+```
+
+**Scanning** — builds the structural graph: Repository, Directory, File, Package nodes + DEFINED_IN, DEPENDS_ON relationships. Parses dependency manifests (package.json, go.mod, requirements.txt, pyproject.toml, Cargo.toml).
+
+**Processing** — parses each file with tree-sitter, extracts Class/Function nodes, analyzes imports, and builds registries for call resolution.
+
+**Resolving** — resolves function calls using a 7-strategy priority resolver (self/this, Go receiver, ClassName.method, import-based, constructor, intra-file, cross-file).
+
+**Summarizing** — generates one-sentence summaries for every node using identifier analysis and template patterns. No ML required.
+
+### Using the in-memory store
+
+```ts
+import {
+  runPipeline,
+  MemoryStore,
+  type RepoTree,
+} from '@opentrace/components/pipeline';
+
+const store = new MemoryStore();
+const repo: RepoTree = { /* ... */ };
+
+for (const event of runPipeline({ repo }, { cancelled: false }, store)) {
+  // events flow through
+}
+
+// Query the store
+console.log(`${store.nodes.size} nodes, ${store.relationships.size} relationships`);
+
+const classes = [...store.nodes.values()].filter(n => n.type === 'Class');
+const calls = [...store.relationships.values()].filter(r => r.type === 'CALLS');
+```
+
+### Supported languages
+
+| Language | Extractor | Import analysis | Call resolution |
+|---|---|---|---|
+| Python | Bespoke | Yes | Yes |
+| TypeScript/TSX | Bespoke | Yes | Yes |
+| JavaScript/JSX | Bespoke (shared with TS) | Yes | Yes |
+| Go | Bespoke | Yes (with module path) | Yes |
+| Rust | Generic | Yes | No |
+| Ruby | Generic | Yes | No |
+| Java | Generic | No | No |
+| Kotlin | Generic | No | No |
+| C# | Generic | No | No |
+| C | Generic | No | No |
+| C++ | Generic | No | No |
+| Swift | Generic | No | No |
+
+### Node.js WASM helpers
+
+For Node.js scripts, tests, or CLI tools, use the WASM path helpers to locate grammar files without hardcoding paths:
+
+```ts
+import { readFile } from 'node:fs/promises';
+import { Parser, Language } from 'web-tree-sitter';
+import { getWasmPath, getWasmDir } from '@opentrace/components/pipeline/wasm';
+
+// Initialize the runtime
+const runtimeBuf = await readFile(getWasmPath('runtime'));
+await Parser.init({
+  locateFile: () => getWasmPath('runtime'),
+  wasmBinary: runtimeBuf,
+});
+
+// Load a specific grammar
+const parser = new Parser();
+const lang = await Language.load(await readFile(getWasmPath('python')));
+parser.setLanguage(lang);
+
+// Or get the directory for bulk operations
+const wasmDir = getWasmDir(); // absolute path to .wasm files
+```
+
+> **Note:** `@opentrace/components/pipeline/wasm` uses `node:fs` and `node:path` internally. Import it only in Node.js contexts — not in browser bundles.
+
+### Using individual parsers
+
+The extractors, import analyzer, and manifest parser are all exported individually:
+
+```ts
+import {
+  extractPython,
+  extractTypeScript,
+  extractGo,
+  extractGeneric,
+  analyzeImports,
+  parseManifest,
+  isManifestFile,
+  resolveCalls,
+  summarizeFromMetadata,
+} from '@opentrace/components/pipeline';
+```
+
+---
+
+## Graph node types
+
+The pipeline produces these node types:
+
+| Type | Description | ID format |
+|---|---|---|
+| Repository | Source code repository | `owner/repo` |
+| Directory | Directory in the repo | `owner/repo/path` |
+| File | Source file | `owner/repo/path/file` |
+| Class | Class, struct, interface, enum | `fileId::ClassName` |
+| Function | Function or method | `fileId::funcName` or `classId::methodName` |
+| Package | External dependency | `pkg:registry:name` |
+
+## Relationship types
+
+| Type | Description |
+|---|---|
+| DEFINED_IN | Child is defined in parent (File in Dir, Class in File, etc.) |
+| CALLS | Function/method calls another function/method |
+| IMPORTS | File imports another file or package |
+| DEPENDS_ON | Repository depends on a package |
+
+---
+
+## Development
+
+```bash
+# Build the library
+npm run build
+
+# Run tests
+npm test
+
+# Format
+npm run fmt
+
+# Lint
+npm run lint
+```
+
+## License
+
+Apache 2.0 — see [LICENSE](../LICENSE).

package/bin/copy-wasm.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+
+/*
+ * Copyright 2026 OpenTrace Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * Copy tree-sitter WASM files to your app's public directory.
+ *
+ * Usage:
+ *   npx opentrace-copy-wasm <dest-dir>
+ *   npx opentrace-copy-wasm public/
+ *   npx opentrace-copy-wasm --languages python,typescript,go public/
+ *
+ * Options:
+ *   --languages <list>  Comma-separated list of languages to copy (default: all)
+ *   --runtime-only      Copy only the web-tree-sitter runtime WASM
+ *   --help              Show this help message
+ */
+
+import { readdir, copyFile, mkdir } from 'node:fs/promises';
+import { join, dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const WASM_DIR = join(__dirname, '..', 'public', 'wasm');
+
+function printUsage() {
+  console.log(`Usage: opentrace-copy-wasm [options] <dest-dir>
+
+Copy tree-sitter WASM files to your app's public directory so they can
+be served as static assets for browser-based code parsing.
+
+Options:
+  --languages <list>  Comma-separated list of languages (default: all)
+                      Available: python, typescript, tsx, go, rust, java,
+                      kotlin, ruby, c, cpp, csharp, swift, bash, json, toml
+  --runtime-only      Copy only the web-tree-sitter.wasm runtime
+  --help              Show this help message
+
+Examples:
+  opentrace-copy-wasm public/
+  opentrace-copy-wasm --languages python,typescript,go public/
+  opentrace-copy-wasm --runtime-only public/`);
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.includes('--help') || args.length === 0) {
+    printUsage();
+    process.exit(args.includes('--help') ? 0 : 1);
+  }
+
+  let languages = null;
+  let runtimeOnly = false;
+  let destDir = null;
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--languages' && i + 1 < args.length) {
+      languages = new Set(args[++i].split(',').map((s) => s.trim()));
+    } else if (args[i] === '--runtime-only') {
+      runtimeOnly = true;
+    } else if (!args[i].startsWith('-')) {
+      destDir = args[i];
+    }
+  }
+
+  if (!destDir) {
+    console.error('Error: destination directory is required');
+    printUsage();
+    process.exit(1);
+  }
+
+  const dest = resolve(destDir);
+  await mkdir(dest, { recursive: true });
+
+  const files = await readdir(WASM_DIR);
+  let copied = 0;
+
+  for (const file of files) {
+    if (!file.endsWith('.wasm')) continue;
+
+    // Always copy the runtime
+    if (file === 'web-tree-sitter.wasm') {
+      await copyFile(join(WASM_DIR, file), join(dest, file));
+      copied++;
+      continue;
+    }
+
+    if (runtimeOnly) continue;
+
+    // Filter by language if specified
+    if (languages) {
+      const lang = file
+        .replace('tree-sitter-', '')
+        .replace('.wasm', '')
+        .replace('c_sharp', 'csharp');
+      if (!languages.has(lang)) continue;
+    }
+
+    await copyFile(join(WASM_DIR, file), join(dest, file));
+    copied++;
+  }
+
+  console.log(`Copied ${copied} WASM file${copied !== 1 ? 's' : ''} to ${dest}`);
+}
+
+main().catch((err) => {
+  console.error(err.message);
+  process.exit(1);
+});

package/dist/components.css

@@ -1529,11 +1529,11 @@
 /* ── Toolbar layout ─────────────────────────── */
 
 .ot-toolbar {
-  position: absolute;
+  position: fixed;
   top: 0;
   left: 0;
   right: 0;
-  z-index: 10;
+  z-index: 20;
   display: flex;
   align-items: center;
   gap: 12px;

package/dist/pipeline-wasm.cjs

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const node_fs = require("node:fs");
+const node_url = require("node:url");
+const node_path = require("node:path");
+var _documentCurrentScript = typeof document !== "undefined" ? document.currentScript : null;
+const __filename$1 = node_url.fileURLToPath(typeof document === "undefined" ? require("url").pathToFileURL(__filename).href : _documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === "SCRIPT" && _documentCurrentScript.src || new URL("pipeline-wasm.cjs", document.baseURI).href);
+const __dirname$1 = node_path.dirname(__filename$1);
+function findWasmDir() {
+  let dir = __dirname$1;
+  for (let i = 0; i < 5; i++) {
+    const candidate = node_path.join(dir, "public", "wasm");
+    if (node_fs.existsSync(candidate)) return candidate;
+    dir = node_path.dirname(dir);
+  }
+  throw new Error(
+    "Could not find WASM directory. Ensure @opentrace/components is installed correctly."
+  );
+}
+let _wasmDir;
+const WASM_FILES = {
+  bash: "tree-sitter-bash.wasm",
+  c: "tree-sitter-c.wasm",
+  cpp: "tree-sitter-cpp.wasm",
+  csharp: "tree-sitter-c_sharp.wasm",
+  go: "tree-sitter-go.wasm",
+  java: "tree-sitter-java.wasm",
+  json: "tree-sitter-json.wasm",
+  kotlin: "tree-sitter-kotlin.wasm",
+  python: "tree-sitter-python.wasm",
+  ruby: "tree-sitter-ruby.wasm",
+  rust: "tree-sitter-rust.wasm",
+  swift: "tree-sitter-swift.wasm",
+  toml: "tree-sitter-toml.wasm",
+  tsx: "tree-sitter-tsx.wasm",
+  typescript: "tree-sitter-typescript.wasm"
+};
+const SUPPORTED_LANGUAGES = Object.keys(WASM_FILES);
+function getWasmDir() {
+  if (!_wasmDir) _wasmDir = findWasmDir();
+  return _wasmDir;
+}
+function getWasmPath(key) {
+  if (key === "runtime") {
+    return node_path.join(getWasmDir(), "web-tree-sitter.wasm");
+  }
+  const file = WASM_FILES[key];
+  if (!file) {
+    throw new Error(
+      `Unknown language "${key}". Supported: ${SUPPORTED_LANGUAGES.join(", ")}, runtime`
+    );
+  }
+  return node_path.join(getWasmDir(), file);
+}
+exports.SUPPORTED_LANGUAGES = SUPPORTED_LANGUAGES;
+exports.getWasmDir = getWasmDir;
+exports.getWasmPath = getWasmPath;
+//# sourceMappingURL=pipeline-wasm.cjs.map

package/dist/pipeline-wasm.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-wasm.cjs","sources":["../src/pipeline/wasm.ts"],"sourcesContent":["/*\n * Copyright 2026 OpenTrace Contributors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Helpers for locating tree-sitter WASM files shipped with this package.\n *\n * Usage (Node.js — tests, build scripts, CLI tools):\n *\n *   import { getWasmDir, getWasmPath } from '@opentrace/components/pipeline';\n *\n *   // Directory containing all WASM files\n *   const dir = getWasmDir();\n *\n *   // Path to a specific grammar\n *   const pyWasm = getWasmPath('python');\n *   const lang = await Language.load(await readFile(pyWasm));\n *\n * Usage (browser — Vite/webpack/etc.):\n *\n *   WASM files must be copied to your app's public directory so they're\n *   served as static assets. Use the included CLI:\n *\n *     npx opentrace-copy-wasm public/\n *\n *   Or in your package.json scripts:\n *\n *     \"postinstall\": \"opentrace-copy-wasm public/\"\n */\n\nimport { existsSync } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\nimport { dirname, join } from 'node:path';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n/**\n * Resolve the WASM directory. Walks up from this file's location until\n * it finds a `public/wasm` directory. Works from both source and dist:\n *\n * - Source: components/src/pipeline/wasm.ts  (2 levels up)\n * - Dist:   components/dist/pipeline.js      (1 level up)\n * - npm:    @opentrace/components/dist/pipeline.js (1 level up)\n */\nfunction findWasmDir(): string {\n  let dir = __dirname;\n  for (let i = 0; i < 5; i++) {\n    const candidate = join(dir, 'public', 'wasm');\n    if (existsSync(candidate)) return candidate;\n    dir = dirname(dir);\n  }\n  // Should not happen in a correctly installed package\n  throw new Error(\n    'Could not find WASM directory. Ensure @opentrace/components is installed correctly.',\n  );\n}\n\nlet _wasmDir: string | undefined;\n\n/** Language key → WASM filename mapping. */\nconst WASM_FILES: Record<string, string> = {\n  bash: 'tree-sitter-bash.wasm',\n  c: 'tree-sitter-c.wasm',\n  cpp: 'tree-sitter-cpp.wasm',\n  csharp: 'tree-sitter-c_sharp.wasm',\n  go: 'tree-sitter-go.wasm',\n  java: 'tree-sitter-java.wasm',\n  json: 'tree-sitter-json.wasm',\n  kotlin: 'tree-sitter-kotlin.wasm',\n  python: 'tree-sitter-python.wasm',\n  ruby: 'tree-sitter-ruby.wasm',\n  rust: 'tree-sitter-rust.wasm',\n  swift: 'tree-sitter-swift.wasm',\n  toml: 'tree-sitter-toml.wasm',\n  tsx: 'tree-sitter-tsx.wasm',\n  typescript: 'tree-sitter-typescript.wasm',\n};\n\n/** All supported language keys. */\nexport const SUPPORTED_LANGUAGES = Object.keys(WASM_FILES);\n\n/** Get the absolute path to the directory containing all WASM files. */\nexport function getWasmDir(): string {\n  if (!_wasmDir) _wasmDir = findWasmDir();\n  return _wasmDir;\n}\n\n/**\n * Get the absolute path to a specific WASM file.\n *\n * @param key - Language key (e.g. 'python', 'typescript', 'tsx') or\n *              'runtime' for the web-tree-sitter runtime WASM.\n * @returns Absolute path to the .wasm file.\n * @throws If the language key is not recognized.\n */\nexport function getWasmPath(key: string): string {\n  if (key === 'runtime') {\n    return join(getWasmDir(), 'web-tree-sitter.wasm');\n  }\n  const file = WASM_FILES[key];\n  if (!file) {\n    throw new Error(\n      `Unknown language \"${key}\". Supported: ${SUPPORTED_LANGUAGES.join(', ')}, runtime`,\n    );\n  }\n  return join(getWasmDir(), file);\n}\n"],"names":["__filename","fileURLToPath","__dirname","dirname","join","existsSync"],"mappings":";;;;;;AA8CA,MAAMA,eAAaC,SAAAA,wQAA6B;AAChD,MAAMC,cAAYC,UAAAA,QAAQH,YAAU;AAUpC,SAAS,cAAsB;AAC7B,MAAI,MAAME;AACV,WAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AAC1B,UAAM,YAAYE,UAAAA,KAAK,KAAK,UAAU,MAAM;AAC5C,QAAIC,QAAAA,WAAW,SAAS,EAAG,QAAO;AAClC,UAAMF,UAAAA,QAAQ,GAAG;AAAA,EACnB;AAEA,QAAM,IAAI;AAAA,IACR;AAAA,EAAA;AAEJ;AAEA,IAAI;AAGJ,MAAM,aAAqC;AAAA,EACzC,MAAM;AAAA,EACN,GAAG;AAAA,EACH,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AAAA,EACP,MAAM;AAAA,EACN,KAAK;AAAA,EACL,YAAY;AACd;AAGO,MAAM,sBAAsB,OAAO,KAAK,UAAU;AAGlD,SAAS,aAAqB;AACnC,MAAI,CAAC,SAAU,YAAW,YAAA;AAC1B,SAAO;AACT;AAUO,SAAS,YAAY,KAAqB;AAC/C,MAAI,QAAQ,WAAW;AACrB,WAAOC,UAAAA,KAAK,WAAA,GAAc,sBAAsB;AAAA,EAClD;AACA,QAAM,OAAO,WAAW,GAAG;AAC3B,MAAI,CAAC,MAAM;AACT,UAAM,IAAI;AAAA,MACR,qBAAqB,GAAG,iBAAiB,oBAAoB,KAAK,IAAI,CAAC;AAAA,IAAA;AAAA,EAE3E;AACA,SAAOA,UAAAA,KAAK,WAAA,GAAc,IAAI;AAChC;;;;"}

package/dist/pipeline-wasm.js

@@ -0,0 +1,57 @@
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+const __filename$1 = fileURLToPath(import.meta.url);
+const __dirname$1 = dirname(__filename$1);
+function findWasmDir() {
+  let dir = __dirname$1;
+  for (let i = 0; i < 5; i++) {
+    const candidate = join(dir, "public", "wasm");
+    if (existsSync(candidate)) return candidate;
+    dir = dirname(dir);
+  }
+  throw new Error(
+    "Could not find WASM directory. Ensure @opentrace/components is installed correctly."
+  );
+}
+let _wasmDir;
+const WASM_FILES = {
+  bash: "tree-sitter-bash.wasm",
+  c: "tree-sitter-c.wasm",
+  cpp: "tree-sitter-cpp.wasm",
+  csharp: "tree-sitter-c_sharp.wasm",
+  go: "tree-sitter-go.wasm",
+  java: "tree-sitter-java.wasm",
+  json: "tree-sitter-json.wasm",
+  kotlin: "tree-sitter-kotlin.wasm",
+  python: "tree-sitter-python.wasm",
+  ruby: "tree-sitter-ruby.wasm",
+  rust: "tree-sitter-rust.wasm",
+  swift: "tree-sitter-swift.wasm",
+  toml: "tree-sitter-toml.wasm",
+  tsx: "tree-sitter-tsx.wasm",
+  typescript: "tree-sitter-typescript.wasm"
+};
+const SUPPORTED_LANGUAGES = Object.keys(WASM_FILES);
+function getWasmDir() {
+  if (!_wasmDir) _wasmDir = findWasmDir();
+  return _wasmDir;
+}
+function getWasmPath(key) {
+  if (key === "runtime") {
+    return join(getWasmDir(), "web-tree-sitter.wasm");
+  }
+  const file = WASM_FILES[key];
+  if (!file) {
+    throw new Error(
+      `Unknown language "${key}". Supported: ${SUPPORTED_LANGUAGES.join(", ")}, runtime`
+    );
+  }
+  return join(getWasmDir(), file);
+}
+export {
+  SUPPORTED_LANGUAGES,
+  getWasmDir,
+  getWasmPath
+};
+//# sourceMappingURL=pipeline-wasm.js.map

package/dist/pipeline-wasm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-wasm.js","sources":["../src/pipeline/wasm.ts"],"sourcesContent":["/*\n * Copyright 2026 OpenTrace Contributors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Helpers for locating tree-sitter WASM files shipped with this package.\n *\n * Usage (Node.js — tests, build scripts, CLI tools):\n *\n *   import { getWasmDir, getWasmPath } from '@opentrace/components/pipeline';\n *\n *   // Directory containing all WASM files\n *   const dir = getWasmDir();\n *\n *   // Path to a specific grammar\n *   const pyWasm = getWasmPath('python');\n *   const lang = await Language.load(await readFile(pyWasm));\n *\n * Usage (browser — Vite/webpack/etc.):\n *\n *   WASM files must be copied to your app's public directory so they're\n *   served as static assets. Use the included CLI:\n *\n *     npx opentrace-copy-wasm public/\n *\n *   Or in your package.json scripts:\n *\n *     \"postinstall\": \"opentrace-copy-wasm public/\"\n */\n\nimport { existsSync } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\nimport { dirname, join } from 'node:path';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n/**\n * Resolve the WASM directory. Walks up from this file's location until\n * it finds a `public/wasm` directory. Works from both source and dist:\n *\n * - Source: components/src/pipeline/wasm.ts  (2 levels up)\n * - Dist:   components/dist/pipeline.js      (1 level up)\n * - npm:    @opentrace/components/dist/pipeline.js (1 level up)\n */\nfunction findWasmDir(): string {\n  let dir = __dirname;\n  for (let i = 0; i < 5; i++) {\n    const candidate = join(dir, 'public', 'wasm');\n    if (existsSync(candidate)) return candidate;\n    dir = dirname(dir);\n  }\n  // Should not happen in a correctly installed package\n  throw new Error(\n    'Could not find WASM directory. Ensure @opentrace/components is installed correctly.',\n  );\n}\n\nlet _wasmDir: string | undefined;\n\n/** Language key → WASM filename mapping. */\nconst WASM_FILES: Record<string, string> = {\n  bash: 'tree-sitter-bash.wasm',\n  c: 'tree-sitter-c.wasm',\n  cpp: 'tree-sitter-cpp.wasm',\n  csharp: 'tree-sitter-c_sharp.wasm',\n  go: 'tree-sitter-go.wasm',\n  java: 'tree-sitter-java.wasm',\n  json: 'tree-sitter-json.wasm',\n  kotlin: 'tree-sitter-kotlin.wasm',\n  python: 'tree-sitter-python.wasm',\n  ruby: 'tree-sitter-ruby.wasm',\n  rust: 'tree-sitter-rust.wasm',\n  swift: 'tree-sitter-swift.wasm',\n  toml: 'tree-sitter-toml.wasm',\n  tsx: 'tree-sitter-tsx.wasm',\n  typescript: 'tree-sitter-typescript.wasm',\n};\n\n/** All supported language keys. */\nexport const SUPPORTED_LANGUAGES = Object.keys(WASM_FILES);\n\n/** Get the absolute path to the directory containing all WASM files. */\nexport function getWasmDir(): string {\n  if (!_wasmDir) _wasmDir = findWasmDir();\n  return _wasmDir;\n}\n\n/**\n * Get the absolute path to a specific WASM file.\n *\n * @param key - Language key (e.g. 'python', 'typescript', 'tsx') or\n *              'runtime' for the web-tree-sitter runtime WASM.\n * @returns Absolute path to the .wasm file.\n * @throws If the language key is not recognized.\n */\nexport function getWasmPath(key: string): string {\n  if (key === 'runtime') {\n    return join(getWasmDir(), 'web-tree-sitter.wasm');\n  }\n  const file = WASM_FILES[key];\n  if (!file) {\n    throw new Error(\n      `Unknown language \"${key}\". Supported: ${SUPPORTED_LANGUAGES.join(', ')}, runtime`,\n    );\n  }\n  return join(getWasmDir(), file);\n}\n"],"names":["__filename","__dirname"],"mappings":";;;AA8CA,MAAMA,eAAa,cAAc,YAAY,GAAG;AAChD,MAAMC,cAAY,QAAQD,YAAU;AAUpC,SAAS,cAAsB;AAC7B,MAAI,MAAMC;AACV,WAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AAC1B,UAAM,YAAY,KAAK,KAAK,UAAU,MAAM;AAC5C,QAAI,WAAW,SAAS,EAAG,QAAO;AAClC,UAAM,QAAQ,GAAG;AAAA,EACnB;AAEA,QAAM,IAAI;AAAA,IACR;AAAA,EAAA;AAEJ;AAEA,IAAI;AAGJ,MAAM,aAAqC;AAAA,EACzC,MAAM;AAAA,EACN,GAAG;AAAA,EACH,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AAAA,EACP,MAAM;AAAA,EACN,KAAK;AAAA,EACL,YAAY;AACd;AAGO,MAAM,sBAAsB,OAAO,KAAK,UAAU;AAGlD,SAAS,aAAqB;AACnC,MAAI,CAAC,SAAU,YAAW,YAAA;AAC1B,SAAO;AACT;AAUO,SAAS,YAAY,KAAqB;AAC/C,MAAI,QAAQ,WAAW;AACrB,WAAO,KAAK,WAAA,GAAc,sBAAsB;AAAA,EAClD;AACA,QAAM,OAAO,WAAW,GAAG;AAC3B,MAAI,CAAC,MAAM;AACT,UAAM,IAAI;AAAA,MACR,qBAAqB,GAAG,iBAAiB,oBAAoB,KAAK,IAAI,CAAC;AAAA,IAAA;AAAA,EAE3E;AACA,SAAO,KAAK,WAAA,GAAc,IAAI;AAChC;"}