@ttsc/graph 0.19.3 → 0.20.0

package/lib/model/TtscGraphNodeId.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTtscGraphNodeId = parseTtscGraphNodeId;
+exports.writeTtscGraphNodeId = writeTtscGraphNodeId;
+exports.ttscGraphNodeIdPath = ttscGraphNodeIdPath;
+/**
+ * Decode the graph's position-invariant `path#name:kind` identity.
+ *
+ * The producer quotes `#` and `\\` inside path and name. This reader also
+ * accepts pre-codec ordinary ids, so a current package can read an older dump.
+ */
+function parseTtscGraphNodeId(id) {
+    const hash = graphNodeIdHash(id);
+    if (hash < 0)
+        return undefined;
+    const tail = id.slice(hash + 1);
+    if (tail === "")
+        return undefined;
+    const colon = tail.lastIndexOf(":");
+    if (colon === 0 || colon === tail.length - 1)
+        return undefined;
+    return {
+        path: unescapeGraphNodeIdPart(id.slice(0, hash)),
+        name: unescapeGraphNodeIdPart(colon < 0 ? tail : tail.slice(0, colon)),
+        ...(colon < 0 ? {} : { kind: tail.slice(colon + 1) }),
+    };
+}
+/** Encode a symbol identity without making its component boundaries ambiguous. */
+function writeTtscGraphNodeId(path, name, kind) {
+    return `${escapeGraphNodeIdPart(path)}#${escapeGraphNodeIdPart(name)}:${kind}`;
+}
+/** Return the raw path component when id is a symbol identity. */
+function ttscGraphNodeIdPath(id) {
+    return parseTtscGraphNodeId(id)?.path;
+}
+function escapeGraphNodeIdPart(value) {
+    return value.replaceAll("\\", "\\\\").replaceAll("#", "\\#");
+}
+function unescapeGraphNodeIdPart(value) {
+    let result = "";
+    for (let index = 0; index < value.length; index++) {
+        const next = value[index + 1];
+        if (value[index] === "\\" && next !== undefined) {
+            if (next === "#" || (next === "\\" && !legacyUNCStart(value, index))) {
+                result += next;
+                index++;
+                continue;
+            }
+        }
+        result += value[index];
+    }
+    return result;
+}
+function legacyUNCStart(value, index) {
+    return (index === 0 && value.length > 2 && value[2] !== "\\" && value[2] !== "#");
+}
+function graphNodeIdHash(id) {
+    for (let index = 0; index < id.length; index++) {
+        if (id[index] !== "#")
+            continue;
+        let slashes = 0;
+        for (let slash = index - 1; slash >= 0 && id[slash] === "\\"; slash--)
+            slashes++;
+        if (slashes % 2 === 0)
+            return index;
+    }
+    return -1;
+}
+//# sourceMappingURL=TtscGraphNodeId.js.map

package/lib/model/TtscGraphNodeId.js.map

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

package/lib/model/TtscGraphSession.d.ts

@@ -1,4 +1,23 @@
 import { TtscGraphMemory } from "./TtscGraphMemory";
+/** Construction options for a resident native graph session. */
+export interface TtscGraphSessionOptions {
+    /** Project root passed to `ttscgraph serve`. */
+    cwd: string;
+    /** Project tsconfig passed to `ttscgraph serve`. */
+    tsconfig: string;
+    /** Absolute native binary path, resolved from `cwd` when omitted. */
+    binary?: string;
+    /**
+     * Maximum time for one native snapshot response. Defaults to five minutes,
+     * which is more than ten times the published 28.7-second VS Code cold index.
+     */
+    requestTimeoutMs?: number;
+}
+/** Per-call controls for a native graph refresh. */
+export interface TtscGraphRequestOptions {
+    /** Cancel this refresh and retire its native session. */
+    signal?: AbortSignal;
+}
 /**
  * Resident bridge to `ttscgraph serve`.
  *
@@ -11,20 +30,16 @@ export declare class TtscGraphSession {
     private readonly cwd;
     private readonly tsconfig;
     private readonly binary;
+    private readonly requestTimeoutMs;
     private child;
-    private stderr;
     private nextId;
     private readonly pending;
     private queue;
     private current;
     private closed;
-    constructor(options: {
-        cwd: string;
-        tsconfig: string;
-        binary?: string;
-    });
+    constructor(options: TtscGraphSessionOptions);
     /** Return a graph for the current disk snapshot, serialized per tool call. */
-    graph(): Promise<TtscGraphMemory>;
+    graph(options?: TtscGraphRequestOptions): Promise<TtscGraphMemory>;
     /** Close the native session. Safe to call more than once. */
     close(): void;
     private refresh;
@@ -33,4 +48,5 @@ export declare class TtscGraphSession {
     private onLine;
     private failChild;
     private failPending;
+    private settlePending;
 }