@birdcc/lsp 0.0.1-alpha.1 → 0.1.0-beta.0

package/dist/hover-context.js

@@ -0,0 +1,125 @@
+import { getLineText } from "./utils.js";
+const CONTEXT_CACHE_LIMIT = 16;
+const contextIndexCache = new Map();
+const CONTEXT_WORD_PATTERN = /[A-Za-z_][A-Za-z0-9_]*/g;
+const stripLineComment = (line) => {
+    const commentIndex = line.indexOf("#");
+    if (commentIndex === -1) {
+        return line;
+    }
+    return line.slice(0, commentIndex);
+};
+const extractWords = (text) => Array.from(text.matchAll(CONTEXT_WORD_PATTERN), (match) => match[0].toLowerCase());
+const parseBlockSegments = (header) => {
+    const words = extractWords(header);
+    if (words.length === 0) {
+        return [];
+    }
+    if (words[0] === "protocol" && words[1]) {
+        return ["protocol", words[1]];
+    }
+    if (words[0] === "template" && words[1]) {
+        return ["protocol", words[1]];
+    }
+    if (words[0] === "area") {
+        return ["area"];
+    }
+    if (words[0] === "interface") {
+        return ["interface"];
+    }
+    if (words[0] === "ipv4" || words[0] === "ipv6") {
+        return ["channel", words[0]];
+    }
+    if (words[0] === "channel") {
+        return ["channel"];
+    }
+    if (words[0] === "external") {
+        return ["external"];
+    }
+    if (words[0] === "authentication") {
+        return ["authentication"];
+    }
+    if (words[0] === "password") {
+        return ["password"];
+    }
+    if (words[0] === "virtual" && words[1] === "link") {
+        return ["virtual-link"];
+    }
+    return [];
+};
+const processLineIntoStack = (line, stack, maxCharacter) => {
+    const text = stripLineComment(line.slice(0, Math.max(0, maxCharacter)));
+    let headerStart = 0;
+    for (let index = 0; index < text.length; index += 1) {
+        const char = text[index];
+        if (char === "}") {
+            if (stack.length > 0) {
+                stack.pop();
+            }
+            headerStart = index + 1;
+            continue;
+        }
+        if (char === "{") {
+            const header = text.slice(headerStart, index).trim();
+            stack.push({
+                segments: parseBlockSegments(header),
+            });
+            headerStart = index + 1;
+        }
+    }
+};
+const cloneFrames = (frames) => frames.map((frame) => ({
+    segments: frame.segments,
+}));
+const buildContextIndex = (document) => {
+    const stack = [];
+    const lineFrames = [];
+    for (let lineIndex = 0; lineIndex < document.lineCount; lineIndex += 1) {
+        lineFrames.push(cloneFrames(stack));
+        processLineIntoStack(getLineText(document, lineIndex), stack, Number.MAX_SAFE_INTEGER);
+    }
+    return {
+        version: document.version,
+        fingerprint: toDocumentFingerprint(document),
+        lineFrames,
+    };
+};
+const toDocumentFingerprint = (document) => {
+    if (document.lineCount === 0) {
+        return "0::";
+    }
+    const firstLine = getLineText(document, 0);
+    const lastLine = getLineText(document, document.lineCount - 1);
+    return `${String(document.lineCount)}:${firstLine}:${lastLine}`;
+};
+const getCachedContextIndex = (document) => {
+    const cacheKey = typeof document.uri === "string" ? document.uri : document.uri.toString();
+    const cached = contextIndexCache.get(cacheKey);
+    const fingerprint = toDocumentFingerprint(document);
+    if (cached &&
+        cached.version === document.version &&
+        cached.fingerprint === fingerprint) {
+        return cached;
+    }
+    const rebuilt = buildContextIndex(document);
+    contextIndexCache.set(cacheKey, rebuilt);
+    if (contextIndexCache.size > CONTEXT_CACHE_LIMIT) {
+        const oldestKey = contextIndexCache.keys().next().value;
+        if (oldestKey) {
+            contextIndexCache.delete(oldestKey);
+        }
+    }
+    return rebuilt;
+};
+export const resolveHoverContextPath = (document, targetLine, targetCharacter) => {
+    const index = getCachedContextIndex(document);
+    const baseFrames = index.lineFrames[targetLine] ??
+        index.lineFrames[index.lineFrames.length - 1] ??
+        [];
+    const stack = cloneFrames(baseFrames);
+    const lineText = getLineText(document, targetLine);
+    const maxCharacter = Math.min(targetCharacter + 1, lineText.length);
+    processLineIntoStack(lineText, stack, maxCharacter);
+    return stack.flatMap((frame) => frame.segments);
+};
+//# sourceMappingURL=hover-context.js.map

package/dist/hover-context.js.map

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

package/dist/hover-docs/00-base.yaml

@@ -0,0 +1,5 @@
+version: 1
+baseUrls:
+  v2: https://bird.nic.cz/doc/bird-2.18.html
+  v3: https://bird.nic.cz/doc/bird-3.2.0.html
+entries: []

package/dist/hover-docs/10-global-options.yaml

@@ -0,0 +1,442 @@
+entries:
+  - keyword: attribute
+    description: Define custom route attribute
+    detail: Create a custom route attribute that can be attached to routes and used in filters.
+    diff: same
+    version: v2+
+    anchor: opt-attribute
+    path: global
+    parameters:
+      - name: type
+        description: Custom attribute value type.
+      - name: name
+        description: Attribute identifier.
+  - keyword: cork threshold
+    description: Cork threshold (v3 only)
+    detail: Memory pressure control threshold for batching updates.
+    diff: added
+    version: v3+
+    anchor: rtable-cork-threshold
+    notes:
+      v3: "v3 only: Memory pressure control."
+    path: global
+    parameters:
+      - name: number
+        description: Memory pressure threshold for corking updates.
+  - keyword: debug
+    description: Table debug options
+    detail: Enable debugging for routing table operations. v3 has simplified option set.
+    diff: modified
+    version: v2-v3
+    anchors:
+      v2: table-debug
+      v3: rtable-debug
+    notes:
+      v3: "v3 Breaking Change: Options simplified to {states|routes|events}"
+    path: global
+    related:
+      - debug latency
+      - debug tables
+    parameters:
+      - name: options
+        description: Debug categories to enable.
+  - keyword: debug latency
+    description: Enable latency debugging
+    detail:
+      Enable debugging of scheduling latency. v3 extends this to support granular event type
+      filtering.
+    diff: modified
+    version: v2-v3
+    anchor: opt-debug-latency
+    notes:
+      v3:
+        "v3 Breaking Change: Extended to {ping|wakeup|scheduling|sockets|events|timers} for granular
+        control."
+    path: global
+    related:
+      - debug
+    parameters:
+      - name: switch-or-categories
+        description: Enable latency debug globally or by category.
+  - keyword: debug tables
+    description: Enable routing table debugging
+    detail: Log detailed information about routing table operations and state changes.
+    diff: same
+    version: v2+
+    anchor: opt-debug-tables
+    path: global
+    related:
+      - debug
+    parameters:
+      - name: switch
+        description: Enable routing table debug logs.
+  - keyword: define
+    description: Define a constant value
+    detail: Create a named constant that can be referenced throughout the configuration.
+    diff: same
+    version: v2+
+    anchor: opt-define
+    path: global
+    parameters:
+      - name: name
+        description: Constant identifier.
+      - name: value
+        description: Literal or expression value.
+  - keyword: eval
+    description: Evaluate expression at config load time
+    detail: Execute a filter expression during configuration parsing. Useful for dynamic configuration.
+    diff: same
+    version: v2+
+    anchor: opt-eval
+    path: global
+    parameters:
+      - name: expression
+        description: Expression executed at config load time.
+  - keyword: export settle time
+    description: Export settle time (v3 only)
+    detail: Time to wait before exporting route changes to protocols.
+    diff: added
+    version: v3+
+    anchor: rtable-export-settle-time
+    notes:
+      v3: "v3 only: Replaces min/max settle time from v2."
+    path: global
+    related:
+      - min settle time
+      - max settle time
+      - table
+    parameters:
+      - name: time
+        description: Export settle duration.
+  - keyword: filter
+    description: Define a routing filter
+    detail:
+      Create a named filter that can be used to accept, reject, or modify routes during
+      import/export.
+    diff: same
+    version: v2+
+    anchor: opt-filter
+    path: global
+    related:
+      - function
+      - protocol
+      - import
+      - export
+    parameters:
+      - name: name
+        description: Filter function name.
+  - keyword: function
+    description: Define a reusable filter function
+    detail:
+      Create a named function that can be called from filters. Supports typed parameters and
+      return values.
+    diff: same
+    version: v2+
+    anchor: opt-function
+    path: global
+    related:
+      - filter
+      - define
+    parameters:
+      - name: signature
+        description: Function signature and return type.
+  - keyword: gc period
+    description: Garbage collection period
+    detail: Set the interval between garbage collection runs.
+    diff: same
+    version: v2+
+    anchor: rtable-gc-period
+    path: global
+    related:
+      - gc threshold
+      - table
+    parameters:
+      - name: seconds
+        description: Interval between GC runs.
+  - keyword: gc threshold
+    description: Garbage collection threshold
+    detail: Configure the garbage collection threshold for the routing table.
+    diff: same
+    version: v2+
+    anchor: rtable-gc-threshold
+    path: global
+    related:
+      - gc period
+      - table
+    parameters:
+      - name: number
+        description: Threshold before GC is triggered.
+  - keyword: graceful restart wait
+    description: Set graceful restart timeout
+    detail: Configure how long to wait for protocols to recover after a graceful restart.
+    diff: same
+    version: v2+
+    anchor: opt-graceful-restart-wait
+    path: global
+    parameters:
+      - name: seconds
+        description: Maximum graceful-restart wait.
+  - keyword: hostname
+    description: Set router hostname
+    detail: Override the system hostname used in protocol announcements and logging.
+    diff: same
+    version: v2+
+    anchor: opt-hostname
+    path: global
+    parameters:
+      - name: name
+        description: Hostname string.
+  - keyword: include
+    description: Include another configuration file
+    detail:
+      Include and parse another configuration file at this point. Supports glob patterns for
+      including multiple files.
+    diff: same
+    version: v2+
+    anchor: opt-include
+    path: global
+    related:
+      - define
+      - template
+      - protocol
+    parameters:
+      - name: path-or-glob
+        description: Path or glob to include.
+  - keyword: log
+    description: Configure logging destination and format
+    detail:
+      Set log output to stderr, syslog, or a file. BIRD 3 adds 'fixed' option for ring buffer
+      logging.
+    diff: modified
+    version: v2-v3
+    anchor: opt-log
+    notes:
+      v3: v3 adds 'fixed' ring buffer option for memory-constrained environments.
+    path: global
+    related:
+      - timeformat
+      - debug
+      - debug latency
+    parameters:
+      - name: target
+        description: Logging target like syslog/file/stderr.
+      - name: classes
+        description: Enabled log classes.
+  - keyword: max settle time
+    description: Maximum settle time (v2 only)
+    detail: Maximum time to wait before announcing route changes. Removed in v3.
+    diff: removed
+    version: v2
+    anchor: rtable-max-settle-time
+    notes:
+      v3: "v3: Removed - use export settle time instead"
+    path: global
+    related:
+      - min settle time
+      - export settle time
+    parameters:
+      - name: time
+        description: Legacy max settle time (v2).
+  - keyword: min settle time
+    description: Minimum settle time (v2 only)
+    detail: Minimum time to wait before announcing route changes. Removed in v3.
+    diff: removed
+    version: v2
+    anchor: rtable-min-settle-time
+    notes:
+      v3: "v3: Removed - use export settle time instead"
+    path: global
+    related:
+      - max settle time
+      - export settle time
+    parameters:
+      - name: time
+        description: Legacy min settle time (v2).
+  - keyword: mrtdump
+    description: Configure MRT dump output
+    detail: Set up MRT format dump for BGP updates and routing table dumps for analysis.
+    diff: same
+    version: v2+
+    anchor: opt-mrtdump
+    path: global
+    parameters:
+      - name: path
+        description: MRT dump file path.
+  - keyword: protocol
+    description: Define a routing protocol instance
+    detail: Create a named instance of a routing protocol (BGP, OSPF, etc.) with its configuration.
+    diff: same
+    version: v2+
+    anchor: opt-protocol
+    path: global
+    related:
+      - template
+      - filter
+      - function
+      - router id
+    parameters:
+      - name: type
+        description: Protocol type (bgp/ospf/etc).
+      - name: name
+        description: Protocol instance name.
+  - keyword: router id
+    description: Set BIRD's router ID
+    detail:
+      "Router ID is a 4-byte integer that should be unique within an AS. It is used to identify
+      the router in routing protocols. Default: the lowest IPv4 address of the router."
+    diff: same
+    version: v2+
+    anchor: opt-router-id
+    path: global
+    related:
+      - router id from
+      - protocol
+    parameters:
+      - name: router-id
+        description: Router ID in IPv4 format.
+        required: true
+  - keyword: router id from
+    description: Derive router ID from interface
+    detail: Automatically determine the router ID from the lowest IP address of the specified interface.
+    diff: same
+    version: v2+
+    anchor: opt-router-id-from
+    path: global
+    related:
+      - router id
+    parameters:
+      - name: interface-pattern
+        description: Interface selection pattern.
+        required: true
+  - keyword: sorted
+    description: Enable sorted table mode
+    detail: Keep routes sorted for faster route lookups.
+    diff: same
+    version: v2+
+    anchor: rtable-sorted
+    path: global
+    parameters:
+      - name: switch
+        description: Enable sorted table mode.
+  - keyword: table
+    description: Define a routing table
+    detail:
+      Create a named routing table to store routes. Tables can be associated with channels for
+      import/export.
+    diff: same
+    version: v2+
+    anchor: rtable-opts
+    path: global
+    related:
+      - sorted
+      - trie
+      - gc period
+      - gc threshold
+      - export settle time
+    parameters:
+      - name: name
+        description: Routing table name.
+  - keyword: template
+    description: Define a protocol template
+    detail: Create a reusable protocol configuration template that can be inherited by other protocols.
+    diff: same
+    version: v2+
+    anchor: opt-template
+    path: global
+    related:
+      - protocol
+      - function
+      - filter
+    parameters:
+      - name: protocol-type
+        description: Template protocol type.
+      - name: name
+        description: Template name.
+  - keyword: max latency
+    description: Set maximum latency for thread group (v3 only)
+    detail: Configure the maximum allowed latency for threads in a thread group before warnings.
+    diff: added
+    version: v3+
+    anchor: thread-setup
+    notes:
+      v3: "v3 only: Thread group performance tuning option."
+    path: global
+    parameters:
+      - name: time
+        description: Maximum thread-group latency.
+  - keyword: thread group
+    description: Configure thread groups for multi-threading (v3 only)
+    detail:
+      Define a thread group for running protocol and channel tasks in parallel. BIRD 3.0+ supports
+      multi-threading with configurable thread groups.
+    diff: added
+    version: v3+
+    anchor: thread-setup
+    notes:
+      v3: "v3.2.0+: BIRD runs in several threads with configurable thread groups for different workloads."
+    path: global
+    related: &a1
+      - threads
+      - max latency
+    parameters: &a2
+      - name: name
+        description: Thread group name.
+  - keyword: thread group
+    description: Assign protocol to thread group (v3 only)
+    detail: Specify which thread group should handle this protocol's tasks.
+    diff: added
+    version: v3+
+    anchor: proto-thread-group
+    notes:
+      v3: "v3 only: Multi-threading support for protocol tasks."
+    path: protocol
+    related: *a1
+    parameters: *a2
+  - keyword: threads
+    description: Set number of threads (deprecated in v3)
+    detail:
+      Configure the number of worker threads. In v3, use 'thread group' instead for more granular
+      control.
+    diff: modified
+    version: v2-v3
+    anchors:
+      v2: opt-threads
+      v3: thread-setup
+    notes:
+      v3: "v3: Deprecated in favor of 'thread group' configuration blocks."
+    path: global
+    related:
+      - thread group
+    parameters:
+      - name: number
+        description: Legacy worker thread count.
+  - keyword: timeformat
+    description: Set time format for logging
+    detail: Configure the format string used for timestamps in log messages.
+    diff: same
+    version: v2+
+    anchor: opt-timeformat
+    path: global
+    parameters:
+      - name: format
+        description: Time format string.
+  - keyword: trie
+    description: Use trie data structure
+    detail: Store routes in a trie data structure for optimized longest-prefix matching.
+    diff: same
+    version: v2+
+    anchor: rtable-trie
+    path: global
+    parameters:
+      - name: switch
+        description: Enable trie table mode.
+  - keyword: watchdog warning
+    description: Set watchdog warning threshold
+    detail: Configure the time threshold after which a warning is logged if the scheduler doesn't respond.
+    diff: same
+    version: v2+
+    anchor: opt-watchdog-warning
+    path: global
+    parameters:
+      - name: time
+        description: Scheduler warning threshold.