@askdkc/dsh-lsp-server 0.1.11 → 0.1.13

package/lib/types/structure/types.d.ts

@@ -0,0 +1,147 @@
+import type { CompletionResult, DiagnosticsResult, LspPosition, LspRange, NavigationResult } from '../service.js';
+export type StructureLanguage = 'javascript' | 'typescript' | 'tsx';
+export type CodeIntelligenceStatus = 'ok' | 'partial' | 'unsupported' | 'unavailable' | 'stale' | 'cancelled' | 'timeout' | 'limit_exceeded';
+export type SourceKind = 'disk' | 'overlay';
+/** Values are created by the trusted host adapter, never from model arguments. */
+export interface SnapshotScope {
+    ownerId: string;
+    sessionId: string;
+    workspaceRoot: string;
+}
+export interface SnapshotDescriptor {
+    handle: string;
+    version: number;
+    filePath: string;
+    language: StructureLanguage | null;
+    sourceKind: SourceKind;
+    contentHash: string;
+    sourceBytes: number;
+}
+export interface SnapshotOpenResult extends SnapshotDescriptor {
+    status: 'ok';
+    parserAvailable: boolean;
+    parseErrors: boolean;
+}
+export interface SnapshotReleaseResult {
+    released: boolean;
+}
+export interface StructureNode {
+    handle: string;
+    kind: string;
+    range: LspRange;
+    name?: string;
+    childCount?: number;
+}
+export interface StructureErrorSummary {
+    hasError: boolean;
+    errorNodes: number;
+    missingNodes: number;
+    truncated: boolean;
+}
+export interface StructureOutlineResult {
+    status: 'ok' | 'partial' | 'unsupported';
+    handle: string;
+    version: number;
+    declarations: StructureNode[];
+    truncated: boolean;
+    processed: number;
+    errors: StructureErrorSummary;
+}
+export interface StructureEnclosingResult {
+    status: 'ok' | 'partial' | 'unsupported';
+    handle: string;
+    version: number;
+    node?: StructureNode;
+    ancestors: StructureNode[];
+    errors?: StructureErrorSummary;
+}
+export interface StructureCapture {
+    capture: string;
+    kind: string;
+    range: LspRange;
+    nodeHandle: string;
+    name?: string;
+}
+export interface StructureQueryResult {
+    status: 'ok' | 'partial';
+    handle: string;
+    version: number;
+    queryId: string;
+    captures: StructureCapture[];
+    truncated: boolean;
+    processed: number;
+    errors: StructureErrorSummary;
+}
+export interface StructureSpanResult {
+    status: 'ok' | 'partial';
+    text: string;
+    truncated: boolean;
+    range: LspRange;
+}
+export type SemanticOperation = 'definition' | 'references' | 'implementation' | 'hover' | 'diagnostics' | 'completion';
+export interface SemanticQuery {
+    operation: SemanticOperation;
+    position?: LspPosition;
+    severity?: 'all' | 'error' | 'warning';
+    servers?: string[];
+    maxResults?: number;
+}
+export interface SemanticResult {
+    status: 'ok' | 'partial' | 'unsupported' | 'unavailable' | 'stale' | 'cancelled' | 'timeout' | 'limit_exceeded';
+    operation: SemanticOperation;
+    result?: unknown;
+    truncated?: boolean;
+    omitted?: number;
+}
+export interface CodeIntelligenceCapabilities {
+    version: 1;
+    parsers: Array<{
+        language: StructureLanguage;
+        extensions: string[];
+        available: boolean;
+        abiVersion: number | null;
+        runtimeAbi: {
+            minimum: number;
+            current: number;
+        };
+        lastError?: string;
+    }>;
+    sourceKind: 'disk';
+    overlay: 'unavailable';
+    limits: {
+        maxDocumentBytes: number;
+        maxCaptures: number;
+        maxOutline: number;
+        maxSpanChars: number;
+        maxResponseBytes: number;
+    };
+    incrementalParsing: boolean;
+}
+export interface CodeIntelligenceToolServiceV1 {
+    readonly version: 1;
+    snapshot: {
+        open(scope: SnapshotScope, filePath: string, signal?: AbortSignal): Promise<SnapshotOpenResult>;
+        release(scope: SnapshotScope, handle: string): Promise<SnapshotReleaseResult>;
+    };
+    structure: {
+        outline(scope: SnapshotScope, handle: string, options?: {
+            range?: LspRange;
+            limit?: number;
+        }, signal?: AbortSignal): Promise<StructureOutlineResult>;
+        enclosing(scope: SnapshotScope, handle: string, position: LspPosition, options?: {
+            kinds?: string[];
+        }, signal?: AbortSignal): Promise<StructureEnclosingResult>;
+        query(scope: SnapshotScope, handle: string, queryId: string, options?: {
+            range?: LspRange;
+            limit?: number;
+        }, signal?: AbortSignal): Promise<StructureQueryResult>;
+        span(scope: SnapshotScope, nodeHandle: string, maxChars?: number, signal?: AbortSignal): Promise<StructureSpanResult>;
+    };
+    semantic: {
+        query(scope: SnapshotScope, handle: string, request: SemanticQuery, signal?: AbortSignal): Promise<SemanticResult>;
+    };
+    capabilities(): CodeIntelligenceCapabilities;
+    releaseOwner?(scope: SnapshotScope): Promise<number>;
+    dispose?(): Promise<void>;
+}
+export type SnapshotSemanticCallback = (scope: SnapshotScope, snapshot: SnapshotDescriptor, request: SemanticQuery, signal: AbortSignal) => Promise<CompletionResult | DiagnosticsResult | NavigationResult>;

package/lib/types/structure/worker-pool.d.ts

@@ -0,0 +1,66 @@
+import type { StructureLanguage } from './types.js';
+export interface StructureWorkerRequest {
+    operation: 'matches' | 'enclosing' | 'inspect';
+    language: StructureLanguage;
+    text: string;
+    querySource: string;
+    limit: number;
+    snapshotHandle?: string;
+    previousSnapshotHandle?: string;
+    startIndex?: number;
+    endIndex?: number;
+    index?: number;
+    kinds?: string[];
+}
+export interface WorkerNodeSummary {
+    kind: string;
+    startIndex: number;
+    endIndex: number;
+    startPosition: {
+        row: number;
+        column: number;
+    };
+    endPosition: {
+        row: number;
+        column: number;
+    };
+    nameStartIndex?: number;
+    nameEndIndex?: number;
+    childCount: number;
+}
+export interface WorkerErrorSummary {
+    hasError: boolean;
+    errorNodes: number;
+    missingNodes: number;
+    truncated: boolean;
+}
+export interface WorkerMatch {
+    captures: Array<{
+        name: string;
+    } & WorkerNodeSummary>;
+}
+export interface StructureWorkerResult {
+    status: 'ok' | 'partial';
+    abiVersion?: number;
+    reusedTree?: boolean;
+    incremental?: boolean;
+    matches?: WorkerMatch[];
+    nodes?: WorkerNodeSummary[];
+    truncated?: boolean;
+    errors: WorkerErrorSummary;
+}
+/** CPU-bound parsing runs off the event loop; cancellation terminates the active worker. */
+export declare class StructureWorkerPool {
+    private readonly slots;
+    private readonly queue;
+    private disposed;
+    execute(request: StructureWorkerRequest, signal?: AbortSignal): Promise<StructureWorkerResult>;
+    dispose(): Promise<void>;
+    releaseSnapshot(snapshotHandle: string): void;
+    get queued(): number;
+    get active(): number;
+    private pump;
+    private createWorker;
+    private retire;
+    private finishTask;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askdkc/dsh-lsp-server",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "Composite read-only LSP provider for DeepSeek Harness web stacks",
   "type": "module",
   "main": "./lib/provider.js",
@@ -18,6 +18,14 @@
       "types": "./lib/types/extra-tool.d.ts",
       "default": "./lib/extra-tool.js"
     },
+    "./code-intelligence": {
+      "types": "./lib/types/code-intelligence.d.ts",
+      "default": "./lib/code-intelligence.js"
+    },
+    "./code-intelligence-contracts": {
+      "types": "./lib/types/code-intelligence-contracts.d.ts",
+      "default": "./lib/code-intelligence-contracts.js"
+    },
     "./package.json": "./package.json",
     "./lsp": {
       "types": "./lib/types/lsp.d.ts",
@@ -45,7 +53,7 @@
     }
   },
   "scripts": {
-    "build": "tsdown && tsc -p tsconfig.build.json",
+    "build": "tsdown && tsc -p tsconfig.build.json && node scripts/copy-structure-assets.mjs",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:e2e": "vitest run --config vitest.e2e.config.ts",
@@ -61,7 +69,8 @@
     "svelte-language-server": "0.17.15",
     "typescript": "5.7.3",
     "typescript-language-server": "4.3.3",
-    "vscode-langservers-extracted": "4.10.0"
+    "vscode-langservers-extracted": "4.10.0",
+    "web-tree-sitter": "0.27.1"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "~4.0.4",
@@ -96,6 +105,8 @@
     "@types/node": "22.10.5",
     "tailwindcss-v3": "npm:tailwindcss@3.4.17",
     "tailwindcss-v4": "npm:tailwindcss@4.1.13",
+    "tree-sitter-javascript": "0.25.0",
+    "tree-sitter-typescript": "0.23.2",
     "tsdown": "0.15.0",
     "typescript": "5.7.3",
     "vitest": "4.1.11"
@@ -111,7 +122,9 @@
     "overrides": {
       "tsdown>rolldown": "1.0.0-beta.38",
       "svelte-language-server>svelte": "5.55.7",
-      "vite": "6.4.3"
+      "vite": "6.4.3",
+      "source-map-js": "1.2.2",
+      "postcss-selector-parser": "7.1.6"
     }
   },
   "license": "MIT",