@nowline/lsp 0.4.1

package/dist/references/ast-utils.js

@@ -0,0 +1,313 @@
+import { isAnchorDeclaration, isFootnoteDeclaration, isGroupBlock, isItemDeclaration, isLabelDeclaration, isMilestoneDeclaration, isNowlineFile, isParallelBlock, isPersonDeclaration, isPersonMemberRef, isSizeDeclaration, isStatusDeclaration, isStyleDeclaration, isSwimlaneDeclaration, isSymbolDeclaration, isTeamDeclaration, } from '@nowline/core';
+import { CstUtils } from 'langium';
+/**
+ * Property keys whose value(s) name another entity in the same file. Used by
+ * definition / references / rename / completion to decide whether the cursor
+ * sits on an id reference.
+ *
+ * Wider than the validator's `checkReferenceResolution` (which is strict only
+ * for sequencing — `after` / `before` / `on`). Categorisation references
+ * (`size` / `status` / `style` / `labels`), decoration references
+ * (`icon` / `capacity-icon`), and ownership references (`owner` / `team`) are
+ * permissive in the validator (an undeclared id is not an error) but still
+ * navigable when a declaration exists.
+ *
+ * `footnote:` is intentionally absent — the legacy `item … footnote:foo`
+ * form was removed in favor of the spec-mandated reverse direction.
+ * Footnote association flows only from the footnote declaration's `on:`,
+ * and the validator now rejects `footnote:` as a property on host entities.
+ */
+export const REFERENCE_PROP_KEYS = new Set([
+    'after',
+    'before',
+    'depends',
+    'on',
+    'owner',
+    'team',
+    'size',
+    'status',
+    'style',
+    'labels',
+    'icon',
+    'capacity-icon',
+]);
+/** Status value-completion source: built-in statuses ship with the renderer. */
+export const BUILTIN_STATUSES = [
+    'planned',
+    'in-progress',
+    'done',
+    'at-risk',
+    'blocked',
+];
+/**
+ * Built-in `capacity-icon:` vocabulary. Mirrors `BUILTIN_CAPACITY_ICONS` in
+ * the validator — kept as a literal here so the LSP doesn't have to import a
+ * non-public symbol from `@nowline/core`.
+ */
+export const BUILTIN_CAPACITY_ICONS = [
+    'none',
+    'multiplier',
+    'person',
+    'people',
+    'points',
+    'time',
+];
+/**
+ * Built-in `icon:` vocabulary. Superset of `BUILTIN_CAPACITY_ICONS` plus the
+ * entity-decoration glyphs the renderer ships.
+ */
+export const BUILTIN_ICON_NAMES = [
+    ...BUILTIN_CAPACITY_ICONS,
+    'shield',
+    'warning',
+    'lock',
+];
+/** Strip the trailing `:` an `EntityProperty.key` carries from the grammar. */
+export function propKey(prop) {
+    return prop.key.endsWith(':') ? prop.key.slice(0, -1) : prop.key;
+}
+/**
+ * Walk the `NowlineFile` and collect every entity that owns an `id`. Covers
+ * roadmap-section entities (mirrors the validator's `collectReferenceableIds`)
+ * plus the named config-section declarations (`style`, `symbol`) so style and
+ * symbol references navigate correctly. Anonymous config blocks (`scale`,
+ * `calendar`, `default <entity>`) are skipped.
+ */
+export function collectNamedEntities(file) {
+    const out = [];
+    for (const entry of file.configEntries) {
+        if (isStyleDeclaration(entry) && entry.name)
+            out.push(entry);
+        else if (isSymbolDeclaration(entry) && entry.name)
+            out.push(entry);
+    }
+    const visitTeam = (team) => {
+        if (team.name)
+            out.push(team);
+        for (const c of team.content) {
+            if (isTeamDeclaration(c))
+                visitTeam(c);
+            // `PersonMemberRef` and `DescriptionDirective` are references / prose,
+            // not declarations — skip.
+            else if (isPersonMemberRef(c)) {
+                /* skip */
+            }
+        }
+    };
+    const visitTrackChild = (child) => {
+        if (isItemDeclaration(child) && child.name)
+            out.push(child);
+        else if (isParallelBlock(child)) {
+            if (child.name)
+                out.push(child);
+            for (const sub of child.content)
+                visitTrackChild(sub);
+        }
+        else if (isGroupBlock(child)) {
+            if (child.name)
+                out.push(child);
+            for (const sub of child.content)
+                visitTrackChild(sub);
+        }
+    };
+    for (const entry of file.roadmapEntries) {
+        if (isSwimlaneDeclaration(entry)) {
+            if (entry.name)
+                out.push(entry);
+            for (const c of entry.content)
+                visitTrackChild(c);
+        }
+        else if (isTeamDeclaration(entry))
+            visitTeam(entry);
+        else if (isPersonDeclaration(entry) ||
+            isAnchorDeclaration(entry) ||
+            isMilestoneDeclaration(entry) ||
+            isFootnoteDeclaration(entry) ||
+            isLabelDeclaration(entry) ||
+            isSizeDeclaration(entry) ||
+            isStatusDeclaration(entry)) {
+            if (entry.name)
+                out.push(entry);
+        }
+    }
+    return out;
+}
+/**
+ * Build a map from id → declaring entity. When a name appears multiple times
+ * the validator already flags it; we keep the first occurrence so navigation
+ * is deterministic.
+ */
+export function buildEntityIndex(file) {
+    const index = new Map();
+    for (const ent of collectNamedEntities(file)) {
+        const id = ent.name;
+        if (id && !index.has(id))
+            index.set(id, ent);
+    }
+    return index;
+}
+/** Visit every `EntityProperty` reachable from a roadmap entry, depth-first. */
+export function visitProperties(node, visit) {
+    const walk = (n) => {
+        const props = n.properties;
+        if (Array.isArray(props)) {
+            for (const p of props)
+                visit(p, n);
+        }
+        if (isSwimlaneDeclaration(n)) {
+            for (const c of n.content)
+                walk(c);
+        }
+        else if (isParallelBlock(n) || isGroupBlock(n)) {
+            for (const c of n.content)
+                walk(c);
+        }
+        else if (isTeamDeclaration(n)) {
+            for (const c of n.content) {
+                if (isTeamDeclaration(c) || isPersonDeclaration(c))
+                    walk(c);
+            }
+        }
+    };
+    walk(node);
+}
+/**
+ * Iterate every `EntityProperty` in the file, including those on the roadmap
+ * declaration itself, plus the properties on top-level config entries (style /
+ * default / symbol blocks). Useful for find-references and completion when the
+ * cursor isn't necessarily inside a roadmap entry.
+ */
+export function visitAllProperties(file, visit) {
+    if (file.roadmapDecl) {
+        for (const p of file.roadmapDecl.properties)
+            visit(p, file.roadmapDecl);
+    }
+    for (const entry of file.roadmapEntries)
+        visitProperties(entry, visit);
+}
+/**
+ * Pull the `NowlineFile` AST root from a Langium document.
+ */
+export function fileFromDocument(document) {
+    const root = document.parseResult?.value;
+    return root && isNowlineFile(root) ? root : undefined;
+}
+/**
+ * Find the leaf CST node directly under the given offset. Wraps
+ * `CstUtils.findLeafNodeAtOffset` to make the call sites read clearly.
+ */
+export function leafAt(document, offset) {
+    const root = document.parseResult?.value?.$cstNode;
+    if (!root)
+        return undefined;
+    return CstUtils.findLeafNodeAtOffset(root, offset);
+}
+/**
+ * When `leaf` sits inside the value(s) of an `EntityProperty`, return the
+ * containing property along with the matched value text. Returns `undefined`
+ * when the leaf is the property key, surrounding punctuation, or otherwise
+ * outside a property value.
+ *
+ * Used by definition / hover / references to detect "cursor on a reference".
+ */
+export function propertyValueAt(leaf) {
+    if (!leaf)
+        return undefined;
+    let node = leaf;
+    while (node && node.astNode.$type !== 'EntityProperty')
+        node = node.container;
+    if (!node)
+        return undefined;
+    const prop = node.astNode;
+    const text = leaf.text;
+    if (prop.value === text) {
+        return { prop, value: prop.value, valueNode: leaf };
+    }
+    if (prop.values?.includes(text)) {
+        return { prop, value: text, valueNode: leaf };
+    }
+    return undefined;
+}
+/**
+ * When `leaf` is the `name=ID` token of a named entity declaration, return the
+ * declaring entity. Returns `undefined` for any other position.
+ */
+export function declarationAt(leaf) {
+    if (!leaf)
+        return undefined;
+    const owner = leaf.astNode;
+    if (!owner || typeof owner.name !== 'string')
+        return undefined;
+    if (owner.name !== leaf.text)
+        return undefined;
+    if (isSwimlaneDeclaration(owner) ||
+        isItemDeclaration(owner) ||
+        isParallelBlock(owner) ||
+        isGroupBlock(owner) ||
+        isAnchorDeclaration(owner) ||
+        isMilestoneDeclaration(owner) ||
+        isFootnoteDeclaration(owner) ||
+        isPersonDeclaration(owner) ||
+        isTeamDeclaration(owner) ||
+        isLabelDeclaration(owner) ||
+        isSizeDeclaration(owner) ||
+        isStatusDeclaration(owner) ||
+        isStyleDeclaration(owner) ||
+        isSymbolDeclaration(owner)) {
+        return owner;
+    }
+    return undefined;
+}
+/**
+ * Look up the `name=ID` token range of the entity that declares `id`. Walks
+ * `collectNamedEntities` so config-section declarations (style / symbol)
+ * participate. Returns `undefined` when no declaration matches.
+ *
+ * Replaces the per-provider `findDeclarationRange` helpers in
+ * references.ts and rename.ts so all providers agree on what "declared"
+ * means.
+ */
+export function findDeclarationRange(file, id) {
+    for (const ent of collectNamedEntities(file)) {
+        if (ent.name === id) {
+            const range = nameRangeOf(ent);
+            if (range)
+                return range;
+        }
+    }
+    return undefined;
+}
+/**
+ * Render a one-line "type id" label used by hover and document-symbols.
+ */
+export function entityKind(entity) {
+    return entity.$type
+        .replace(/Declaration$/, '')
+        .replace(/Block$/, '')
+        .toLowerCase();
+}
+/**
+ * Find the CST node that holds the given entity's `name=ID` token. Walks the
+ * entity's CST subtree and returns the first leaf whose text equals the
+ * entity's resolved name. Returns `undefined` when the entity has no `name`
+ * (anonymous declaration), no CST node, or no matching leaf.
+ */
+export function nameRangeOf(entity) {
+    const name = entity.name;
+    if (!name || !entity.$cstNode)
+        return undefined;
+    for (const leaf of CstUtils.flattenCst(entity.$cstNode)) {
+        if (leaf.text === name)
+            return leaf.range;
+    }
+    return undefined;
+}
+/**
+ * Iterate every leaf CST node inside the given root. Convenience wrapper over
+ * `CstUtils.flattenCst` so call sites don't need to import the namespace.
+ */
+export function* flattenLeaves(root) {
+    for (const leaf of CstUtils.flattenCst(root))
+        yield leaf;
+}
+//# sourceMappingURL=ast-utils.js.map

package/dist/references/ast-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-utils.js","sourceRoot":"","sources":["../../src/references/ast-utils.ts"],"names":[],"mappings":"AAqBA,OAAO,EACH,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IACvC,OAAO;IACP,QAAQ;IACR,SAAS;IACT,IAAI;IACJ,OAAO;IACP,MAAM;IACN,MAAM;IACN,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,MAAM;IACN,eAAe;CAClB,CAAC,CAAC;AAEH,gFAAgF;AAChF,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IAC/C,SAAS;IACT,aAAa;IACb,MAAM;IACN,SAAS;IACT,SAAS;CACZ,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAsB;IACrD,MAAM;IACN,YAAY;IACZ,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,MAAM;CACT,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAsB;IACjD,GAAG,sBAAsB;IACzB,QAAQ;IACR,SAAS;IACT,MAAM;CACT,CAAC;AAEF,+EAA+E;AAC/E,MAAM,UAAU,OAAO,CAAC,IAAqB;IACzC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;AACrE,CAAC;AA6BD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAiB;IAClD,MAAM,GAAG,GAAkB,EAAE,CAAC;IAE9B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACrC,IAAI,kBAAkB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;aACxD,IAAI,mBAAmB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,SAAS,GAAG,CAAC,IAAqB,EAAE,EAAE;QACxC,IAAI,IAAI,CAAC,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC3B,IAAI,iBAAiB,CAAC,CAAC,CAAC;gBAAE,SAAS,CAAC,CAAC,CAAC,CAAC;YACvC,uEAAuE;YACvE,2BAA2B;iBACtB,IAAI,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5B,UAAU;YACd,CAAC;QACL,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,eAAe,GAAG,CAAC,KAAuD,EAAE,EAAE;QAChF,IAAI,iBAAiB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;aACvD,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,KAAK,CAAC,IAAI;gBAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO;gBAAE,eAAe,CAAC,GAAG,CAAC,CAAC;QAC1D,CAAC;aAAM,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,IAAI,KAAK,CAAC,IAAI;gBAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO;gBAAE,eAAe,CAAC,GAAG,CAAC,CAAC;QAC1D,CAAC;IACL,CAAC,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QACtC,IAAI,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,IAAI,KAAK,CAAC,IAAI;gBAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO;gBAAE,eAAe,CAAC,CAAC,CAAC,CAAC;QACtD,CAAC;aAAM,IAAI,iBAAiB,CAAC,KAAK,CAAC;YAAE,SAAS,CAAC,KAAK,CAAC,CAAC;aACjD,IACD,mBAAmB,CAAC,KAAK,CAAC;YAC1B,mBAAmB,CAAC,KAAK,CAAC;YAC1B,sBAAsB,CAAC,KAAK,CAAC;YAC7B,qBAAqB,CAAC,KAAK,CAAC;YAC5B,kBAAkB,CAAC,KAAK,CAAC;YACzB,iBAAiB,CAAC,KAAK,CAAC;YACxB,mBAAmB,CAAC,KAAK,CAAC,EAC5B,CAAC;YACC,IAAI,KAAK,CAAC,IAAI;gBAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACL,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAiB;IAC9C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;QACpB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,eAAe,CAC3B,IAAa,EACb,KAAqD;IAErD,MAAM,IAAI,GAAG,CAAC,CAAU,EAAQ,EAAE;QAC9B,MAAM,KAAK,GAAI,CAAuC,CAAC,UAAU,CAAC;QAClE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,KAAK,MAAM,CAAC,IAAI,KAAK;gBAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO;gBAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;aAAM,IAAI,eAAe,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO;gBAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;aAAM,IAAI,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBACxB,IAAI,iBAAiB,CAAC,CAAC,CAAC,IAAI,mBAAmB,CAAC,CAAC,CAAC;oBAAE,IAAI,CAAC,CAAC,CAAC,CAAC;YAChE,CAAC;QACL,CAAC;IACL,CAAC,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAC9B,IAAiB,EACjB,KAAqD;IAErD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU;YAAE,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5E,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,cAAc;QAAE,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAyB;IACtD,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,KAA4B,CAAC;IAChE,OAAO,IAAI,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAoB,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,QAAyB,EAAE,MAAc;IAC5D,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,KAAK,EAAE,QAAQ,CAAC;IACnD,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,OAAO,QAAQ,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC3B,IAAyB;IAEzB,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,IAAI,IAAI,GAAwB,IAAI,CAAC;IACrC,OAAO,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,gBAAgB;QAAE,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;IAC9E,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAyB,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACxD,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAClD,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAyB;IACnD,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAsC,CAAC;IAC1D,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC/D,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC/C,IACI,qBAAqB,CAAC,KAAK,CAAC;QAC5B,iBAAiB,CAAC,KAAK,CAAC;QACxB,eAAe,CAAC,KAAK,CAAC;QACtB,YAAY,CAAC,KAAK,CAAC;QACnB,mBAAmB,CAAC,KAAK,CAAC;QAC1B,sBAAsB,CAAC,KAAK,CAAC;QAC7B,qBAAqB,CAAC,KAAK,CAAC;QAC5B,mBAAmB,CAAC,KAAK,CAAC;QAC1B,iBAAiB,CAAC,KAAK,CAAC;QACxB,kBAAkB,CAAC,KAAK,CAAC;QACzB,iBAAiB,CAAC,KAAK,CAAC;QACxB,mBAAmB,CAAC,KAAK,CAAC;QAC1B,kBAAkB,CAAC,KAAK,CAAC;QACzB,mBAAmB,CAAC,KAAK,CAAC,EAC5B,CAAC;QACC,OAAO,KAAoB,CAAC;IAChC,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAiB,EAAE,EAAU;IAC9D,KAAK,MAAM,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,IAAI,GAAG,CAAC,IAAI,KAAK,EAAE,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAC;QAC5B,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAAe;IACtC,OAAO,MAAM,CAAC,KAAK;SACd,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;SAC3B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,WAAW,EAAE,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,MAAe;IACvC,MAAM,IAAI,GAAI,MAA4B,CAAC,IAAI,CAAC;IAChD,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtD,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC;IAC9C,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,SAAS,CAAC,CAAC,aAAa,CAAC,IAAa;IACxC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,CAAC;AAC7D,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Boot the Nowline language server over stdio. Used both by the bundled VS
+ * Code / Cursor extension (spawned as a Node module via `LanguageClient`) and
+ * by the standalone `nowline-lsp` binary editors like Neovim and JetBrains
+ * point at via the LSP config.
+ */
+export declare function startNowlineServer(): void;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AAMA;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAOzC"}

package/dist/server.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import { startLanguageServer } from 'langium/lsp';
+import { NodeFileSystem } from 'langium/node';
+import { createConnection, ProposedFeatures } from 'vscode-languageserver/node.js';
+import { createNowlineLspServices } from './nowline-lsp-module.js';
+/**
+ * Boot the Nowline language server over stdio. Used both by the bundled VS
+ * Code / Cursor extension (spawned as a Node module via `LanguageClient`) and
+ * by the standalone `nowline-lsp` binary editors like Neovim and JetBrains
+ * point at via the LSP config.
+ */
+export function startNowlineServer() {
+    const connection = createConnection(ProposedFeatures.all);
+    const { shared } = createNowlineLspServices({
+        connection,
+        fileSystemProvider: NodeFileSystem.fileSystemProvider,
+    });
+    startLanguageServer(shared);
+}
+// Only auto-start when invoked directly (the binary entrypoint). Importers
+// (e.g. tests or in-process embeddings) call `startNowlineServer()` themselves.
+const isDirect = (() => {
+    if (typeof process === 'undefined' || !process.argv?.[1])
+        return false;
+    try {
+        const url = new URL(import.meta.url);
+        return url.protocol === 'file:' && url.pathname === process.argv[1];
+    }
+    catch {
+        return false;
+    }
+})();
+if (isDirect)
+    startNowlineServer();
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB;IAC9B,MAAM,UAAU,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC1D,MAAM,EAAE,MAAM,EAAE,GAAG,wBAAwB,CAAC;QACxC,UAAU;QACV,kBAAkB,EAAE,cAAc,CAAC,kBAAkB;KACxD,CAAC,CAAC;IACH,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,2EAA2E;AAC3E,gFAAgF;AAChF,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE;IACnB,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACvE,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC,CAAC,EAAE,CAAC;AACL,IAAI,QAAQ;IAAE,kBAAkB,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@nowline/lsp",
+  "version": "0.4.1",
+  "description": "Nowline language-server — Langium-based LSP that powers VS Code, Cursor, and any other LSP-capable editor",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=22",
+    "pnpm": ">=11"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "nowline-lsp": "./dist/server.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "src/"
+  ],
+  "dependencies": {
+    "langium": "~4.2.4",
+    "vscode-languageserver": "~9.0.1",
+    "vscode-languageserver-textdocument": "~1.0.12",
+    "@nowline/core": "0.4.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.json",
+    "watch": "tsc -b tsconfig.json --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/src/index.ts

@@ -0,0 +1,26 @@
+export {
+    type CreateNowlineLspServicesContext,
+    createNowlineLspServices,
+    type NowlineLspServices,
+} from './nowline-lsp-module.js';
+export { NowlineCompletionProvider } from './providers/completion.js';
+export { NowlineDefinitionProvider } from './providers/definition.js';
+export { NowlineDocumentSymbolProvider } from './providers/document-symbols.js';
+export { NowlineHoverProvider } from './providers/hover.js';
+export { NowlineReferencesProvider } from './providers/references.js';
+export { NowlineRenameProvider } from './providers/rename.js';
+export {
+    BUILTIN_STATUSES,
+    buildEntityIndex,
+    collectNamedEntities,
+    declarationAt,
+    entityKind,
+    fileFromDocument,
+    leafAt,
+    type NamedEntity,
+    propertyValueAt,
+    propKey,
+    REFERENCE_PROP_KEYS,
+    visitAllProperties,
+    visitProperties,
+} from './references/ast-utils.js';

package/src/nowline-lsp-module.ts

@@ -0,0 +1,102 @@
+import {
+    type NowlineAddedServices,
+    NowlineGeneratedModule,
+    NowlineGeneratedSharedModule,
+    NowlineModule,
+    registerValidationChecks,
+} from '@nowline/core';
+import {
+    type FileSystemProvider,
+    inject,
+    type LangiumSharedCoreServices,
+    type Module,
+} from 'langium';
+import {
+    createDefaultModule,
+    createDefaultSharedModule,
+    type DefaultSharedModuleContext,
+    type LangiumServices,
+    type LangiumSharedServices,
+    type PartialLangiumServices,
+} from 'langium/lsp';
+import { NowlineCompletionProvider } from './providers/completion.js';
+import { NowlineDefinitionProvider } from './providers/definition.js';
+import { NowlineDocumentSymbolProvider } from './providers/document-symbols.js';
+import { NowlineHoverProvider } from './providers/hover.js';
+import { NowlineReferencesProvider } from './providers/references.js';
+import { NowlineRenameProvider } from './providers/rename.js';
+
+/**
+ * Combined Langium LSP services + Nowline-specific additions.
+ *
+ * `LangiumServices` already covers parser, validation, and the LSP service
+ * slots (`lsp.DefinitionProvider`, `lsp.HoverProvider`, …). We layer the
+ * Nowline validator on top via `NowlineAddedServices`.
+ */
+export type NowlineLspServices = LangiumServices & NowlineAddedServices;
+
+/**
+ * Language-specific module. Carries the Nowline LSP provider overrides on top
+ * of whatever the cross-package `NowlineModule` (parser config + validator
+ * factory, lifted from `@nowline/core`) already contributes.
+ *
+ * Keeping the parser/validation slots on the core-side `NowlineModule` means
+ * the LSP and the headless `@nowline/cli` parse path stay byte-identical.
+ */
+const NowlineLspProviderModule: Module<NowlineLspServices, PartialLangiumServices> = {
+    lsp: {
+        CompletionProvider: (services) => new NowlineCompletionProvider(services),
+        DefinitionProvider: (services) => new NowlineDefinitionProvider(services),
+        DocumentSymbolProvider: (services) => new NowlineDocumentSymbolProvider(services),
+        HoverProvider: (services) => new NowlineHoverProvider(services),
+        ReferencesProvider: (services) => new NowlineReferencesProvider(services),
+        RenameProvider: (services) => new NowlineRenameProvider(services),
+    },
+};
+
+export interface CreateNowlineLspServicesContext {
+    /** Optional shared services container (e.g. when reusing across languages). */
+    shared?: LangiumSharedServices;
+    /** Either a `NodeFileSystem` (real disk) or `EmptyFileSystem` (tests). */
+    fileSystemProvider: (services: LangiumSharedCoreServices) => FileSystemProvider;
+    /** Optional LSP connection (omit for headless / in-memory usage). */
+    connection?: DefaultSharedModuleContext['connection'];
+}
+
+/**
+ * Build the full Langium LSP service container plus the Nowline language
+ * services. Returns the shared container (used to start the language server)
+ * and the language-specific services (used by tests + provider call sites).
+ */
+export function createNowlineLspServices(context: CreateNowlineLspServicesContext): {
+    shared: LangiumSharedServices;
+    Nowline: NowlineLspServices;
+} {
+    const shared =
+        context.shared ??
+        inject(
+            createDefaultSharedModule({
+                connection: context.connection,
+                fileSystemProvider: context.fileSystemProvider,
+            }),
+            NowlineGeneratedSharedModule,
+        );
+
+    const Nowline = inject(
+        createDefaultModule({ shared }),
+        NowlineGeneratedModule,
+        // `NowlineModule` is typed against `NowlineServices` (core only); cast
+        // through `unknown` because the LSP injector is strictly broader and
+        // Langium's `inject()` accepts that at runtime. See
+        // `packages/core/src/language/nowline-module.ts` for the source.
+        NowlineModule as unknown as Module<
+            NowlineLspServices,
+            PartialLangiumServices & NowlineAddedServices
+        >,
+        NowlineLspProviderModule,
+    );
+
+    shared.ServiceRegistry.register(Nowline);
+    registerValidationChecks(Nowline);
+    return { shared, Nowline };
+}