@rohal12/spindle-lsp 0.14.1 → 0.14.3

package/dist/bin.js

@@ -3039,6 +3039,40 @@ globstar while`, t, d, e, f, m), this.matchOne(t.slice(d), e.slice(f), s)) retur
   }
 });
 
+// src/core/workspace/file-inputs.ts
+import { readFileSync, statSync } from "node:fs";
+import { resolve } from "node:path";
+async function resolveFiles(pattern, cwd) {
+  let input = pattern;
+  let directory = cwd;
+  const literal3 = resolve(cwd, pattern);
+  try {
+    const stat = statSync(literal3);
+    if (stat.isFile()) return [literal3];
+    if (stat.isDirectory()) {
+      directory = literal3;
+      input = "**/*.{tw,twee}";
+    }
+  } catch (error48) {
+    const code = error48.code;
+    if (code !== "ENOENT" && code !== "ENOTDIR") throw error48;
+  }
+  return [...new Set(await Ze(input, { cwd: directory, absolute: true, nodir: true }))];
+}
+function readFileContents(files) {
+  return new Map(files.map((file2) => [file2, readFileSync(file2, "utf8")]));
+}
+async function resolveInputs(patterns, cwd) {
+  const files = await Promise.all(patterns.map((pattern) => resolveFiles(pattern, cwd)));
+  return [...new Set(files.flat())];
+}
+var init_file_inputs = __esm({
+  "src/core/workspace/file-inputs.ts"() {
+    "use strict";
+    init_index_min();
+  }
+});
+
 // node_modules/@rohal12/spindle/dist/pkg/story-variables.js
 function isSigil(c) {
   return c !== void 0 && SIGIL_CHARS.has(c);
@@ -16619,7 +16653,7 @@ var init_tooling = __esm({
 
 // src/core/workspace/document-store.ts
 import { EventEmitter } from "node:events";
-import { readFileSync } from "node:fs";
+import { readFileSync as readFileSync2 } from "node:fs";
 import { pathToFileURL } from "node:url";
 function stripBom(text2) {
   return text2.charCodeAt(0) === 65279 ? text2.slice(1) : text2;
@@ -16667,7 +16701,7 @@ var init_document_store = __esm({
       loadFromDisk(paths) {
         for (const filePath of paths) {
           try {
-            const text2 = readFileSync(filePath, "utf-8");
+            const text2 = readFileSync2(filePath, "utf-8");
             const uri = pathToFileURL(filePath).href;
             this.open(uri, text2);
           } catch {
@@ -16681,31 +16715,32 @@ var init_document_store = __esm({
 // src/core/parsing/passage-parser.ts
 function parsePassageHeader(line, lineNumber) {
   const bomLength = lineNumber === 0 && line.charCodeAt(0) === 65279 ? 1 : 0;
-  const escaped = line.slice(bomLength).replace(/\\./g, "ec");
-  const match = passageHeaderRegex.exec(escaped);
-  if (!match) return null;
-  const prefix = line.slice(0, bomLength) + (match[1] ?? "");
-  const rawName = match[2] ?? "";
-  const rawTags = match[3] ?? "";
-  const rawMeta = match[4] ?? "";
-  const nameStart = prefix.length;
-  const nameEnd = nameStart + rawName.length;
-  const name = line.substring(nameStart, nameEnd).trim();
+  const escaped = line.replace(/\\./g, "ec");
+  const prefix = /^::\s*/.exec(escaped.slice(bomLength));
+  if (!prefix) return null;
+  const nameStart = bomLength + prefix[0].length;
+  const delimiter = /[\[\]{}]/g;
+  delimiter.lastIndex = nameStart;
+  const first = delimiter.exec(escaped);
+  const nameEnd = first?.index ?? line.length;
+  const name = line.slice(nameStart, nameEnd).trim();
   if (!name) return null;
-  const escapedName = name.replace(/\\./g, "ec");
-  if (/[\[\]\{\}]/.test(escapedName)) return null;
-  const tagsStr = rawTags.trim();
+  let rest = nameEnd;
   let tags = [];
-  if (tagsStr) {
-    const inner = tagsStr.substring(1, tagsStr.length - 1).trim();
-    if (/[\[\]\{\}]/.test(inner.replace(/\\./g, "ec"))) return null;
-    tags = inner ? inner.split(/\s+/) : [];
+  if (escaped[rest] === "[") {
+    const end = escaped.indexOf("]", rest + 1);
+    if (end === -1 || /[\[{}]/.test(escaped.slice(rest + 1, end))) return null;
+    const decoded = line.slice(rest + 1, end).replace(/\\(.)/g, "$1").trim();
+    tags = decoded ? decoded.split(/\s+/) : [];
+    rest = end + 1;
+    while (rest < line.length && /\s/.test(escaped[rest])) rest++;
   }
   let meta3;
-  const metaStr = rawMeta.trim();
-  if (metaStr) {
+  if (rest < line.length) {
+    const raw = line.slice(rest).trim();
+    if (escaped[rest] !== "{" || !raw.endsWith("}")) return null;
     try {
-      meta3 = JSON.parse(line.substring(nameStart + rawName.length + rawTags.length, nameStart + rawName.length + rawTags.length + rawMeta.length).trim());
+      meta3 = JSON.parse(raw);
     } catch {
       return null;
     }
@@ -16738,11 +16773,10 @@ function isScriptOrStylesheetPassage(passage) {
 function isMarkupPassage(passage) {
   return !(passage.name !== void 0 && NON_MARKUP_PASSAGES.has(passage.name)) && !isScriptOrStylesheetPassage(passage);
 }
-var passageHeaderRegex, SPECIAL_PASSAGES, CODE_PASSAGE_TAGS, RESERVED_PASSAGE_NAMES, NON_MARKUP_PASSAGES;
+var SPECIAL_PASSAGES, CODE_PASSAGE_TAGS, RESERVED_PASSAGE_NAMES, NON_MARKUP_PASSAGES;
 var init_passage_parser = __esm({
   "src/core/parsing/passage-parser.ts"() {
     "use strict";
-    passageHeaderRegex = /^(::\s+)(.*?)(\[.*?\]\s*)?(\{.*?\}\s*)?\r?$/;
     SPECIAL_PASSAGES = /* @__PURE__ */ new Set([
       "StoryVariables",
       "StoryInit",
@@ -24255,8 +24289,8 @@ var require_dist = __commonJS({
 });
 
 // src/core/workspace/config-loader.ts
-import { readFileSync as readFileSync2, existsSync } from "node:fs";
-import { join, resolve } from "node:path";
+import { readFileSync as readFileSync3, existsSync } from "node:fs";
+import { join, resolve as resolve2 } from "node:path";
 function parseConfig(content, format) {
   if (!content.trim()) {
     return { macros: {} };
@@ -24316,7 +24350,7 @@ function findConfigRoot(directory) {
   let search = directory;
   for (let i2 = 0; i2 < 10; i2++) {
     if (findConfigFile(search)) return search;
-    const parent = resolve(search, "..");
+    const parent = resolve2(search, "..");
     if (parent === search) break;
     search = parent;
   }
@@ -24325,7 +24359,7 @@ function findConfigRoot(directory) {
 function loadConfigFile(configPath) {
   let content;
   try {
-    content = readFileSync2(configPath, "utf-8");
+    content = readFileSync3(configPath, "utf-8");
   } catch (err) {
     const reason = err?.code === "ENOENT" ? "file not found" : err instanceof Error ? err.message : String(err);
     throw new Error(`Cannot read config file '${configPath}': ${reason}`);
@@ -24343,7 +24377,7 @@ function loadConfigFromDisk(workspaceRoot) {
   if (!configPath) {
     return { ...EMPTY_CONFIG };
   }
-  const content = readFileSync2(configPath, "utf-8");
+  const content = readFileSync3(configPath, "utf-8");
   const format = configPath.endsWith(".json") ? "json" : "yaml";
   return parseConfig(content, format);
 }
@@ -24365,6 +24399,12 @@ var init_config_loader = __esm({
 });
 
 // src/core/workspace/macro-registry.ts
+function applySupplement(info, entry) {
+  for (const field of ["description", "parameters", "parameterDocs", "children", "parents", "skipArgs"]) {
+    if (entry[field] !== void 0) Object.assign(info, { [field]: entry[field] });
+  }
+  if (entry.container !== void 0) info.block = entry.container;
+}
 var MacroRegistry;
 var init_macro_registry2 = __esm({
   "src/core/workspace/macro-registry.ts"() {
@@ -24537,30 +24577,20 @@ var init_macro_registry2 = __esm({
         const found = this.discovered.get(key);
         if (!found) return base;
         const info = {
-          ...base,
-          name: base?.name ?? found.name,
-          block: found.block ?? base?.block ?? false,
-          subMacros: found.subMacros?.length ? found.subMacros : base?.subMacros ?? [],
+          name: found.name,
+          block: found.block ?? false,
+          subMacros: found.subMacros ?? [],
           source: "user",
-          storeVar: found.storeVar ?? base?.storeVar,
-          interpolate: found.interpolate ?? base?.interpolate,
-          merged: found.merged ?? base?.merged,
-          description: found.description ?? base?.description,
+          storeVar: found.storeVar,
+          interpolate: found.interpolate,
+          merged: found.merged,
+          description: found.description,
           // A definition replaces the macro it names, parameters included
           parameterDefs: found.parameterDefs,
-          // A discovered sub-macro may also belong to other (e.g. built-in) parents
-          parents: found.parents ? [.../* @__PURE__ */ new Set([...base?.parents ?? [], ...found.parents])] : base?.parents
+          parents: found.parents
         };
         const config2 = this.configEntries.get(key);
-        if (config2) {
-          if (config2.description !== void 0) info.description = config2.description;
-          if (config2.parameters !== void 0) info.parameters = config2.parameters;
-          if (config2.parameterDocs !== void 0) info.parameterDocs = config2.parameterDocs;
-          if (config2.children !== void 0) info.children = config2.children;
-          if (config2.parents !== void 0) info.parents = config2.parents;
-          if (config2.skipArgs !== void 0) info.skipArgs = config2.skipArgs;
-          if (config2.container !== void 0) info.block = config2.container;
-        }
+        if (config2) applySupplement(info, config2);
         return info;
       }
       /** Merge a set of supplement/config entries into the registry. */
@@ -24569,13 +24599,7 @@ var init_macro_registry2 = __esm({
           const key = rawKey.toLowerCase();
           const existing = this.macros.get(key);
           if (existing) {
-            if (entry.description !== void 0) existing.description = entry.description;
-            if (entry.parameters !== void 0) existing.parameters = entry.parameters;
-            if (entry.parameterDocs !== void 0) existing.parameterDocs = entry.parameterDocs;
-            if (entry.children !== void 0) existing.children = entry.children;
-            if (entry.parents !== void 0) existing.parents = entry.parents;
-            if (entry.skipArgs !== void 0) existing.skipArgs = entry.skipArgs;
-            if (entry.container !== void 0) existing.block = entry.container;
+            applySupplement(existing, entry);
           } else {
             this.macros.set(key, {
               name: entry.name ?? rawKey,
@@ -24970,6 +24994,27 @@ var init_variable_tracker = __esm({
       getUsages(name) {
         return usagesOf(this.usagesByUri, name);
       }
+      /** The executable usage or declaration containing the cursor, in source coordinates. */
+      referenceAt(uri, position) {
+        const contains = (range) => (position.line > range.start.line || position.line === range.start.line && position.character >= range.start.character) && (position.line < range.end.line || position.line === range.end.line && position.character <= range.end.character);
+        let atEnd = null;
+        for (const [sigil, usages, declarations] of [
+          ["$", this.usagesByUri.get(uri), this.variables.declared],
+          ["%", this.transientUsagesByUri.get(uri), this.transients.declared]
+        ]) {
+          const candidates = (usages ?? []).map((u) => ({ name: u.baseName, range: u.range }));
+          for (const [name, declaration] of declarations) {
+            if (declaration.declarationUri === uri && declaration.declarationRange) candidates.push({ name, range: declaration.declarationRange });
+          }
+          for (const candidate of candidates) {
+            if (!contains(candidate.range)) continue;
+            const symbol2 = { sigil, ...candidate };
+            if (position.line !== candidate.range.end.line || position.character < candidate.range.end.character) return symbol2;
+            atEnd ??= symbol2;
+          }
+        }
+        return atEnd;
+      }
       /** Whether a StoryVariables passage has been parsed. */
       hasStoryVariables() {
         return this.variables.present;
@@ -25076,6 +25121,7 @@ var init_widget_registry = __esm({
           const { name, tags } = markup.passage;
           for (const definition of widgetDefinitions([{ name, tags, content: markup.content }], known)) {
             this.widgets.set(definition.name.toLowerCase(), {
+              tooling: definition,
               name: definition.name,
               params: definition.params,
               uri: markup.passage.uri,
@@ -25163,7 +25209,7 @@ var init_markup_index = __esm({
 });
 
 // src/core/workspace/macro-sources.ts
-import { existsSync as existsSync2, readFileSync as readFileSync3 } from "node:fs";
+import { existsSync as existsSync2, readFileSync as readFileSync4 } from "node:fs";
 import { dirname, isAbsolute, join as join2, relative } from "node:path";
 import { pathToFileURL as pathToFileURL2 } from "node:url";
 function isExcludedSegment(segment) {
@@ -25212,7 +25258,7 @@ async function addProjectMacroSources(contents, dir) {
     const uri = pathToFileURL2(filePath).toString();
     if (contents.has(uri)) continue;
     try {
-      contents.set(uri, readFileSync3(filePath, "utf-8"));
+      contents.set(uri, readFileSync4(filePath, "utf-8"));
     } catch {
     }
   }
@@ -25231,8 +25277,8 @@ var init_macro_sources = __esm({
 });
 
 // src/core/workspace/spindle-version.ts
-import { existsSync as existsSync3, readFileSync as readFileSync4 } from "node:fs";
-import { dirname as dirname2, join as join3, resolve as resolve2 } from "node:path";
+import { existsSync as existsSync3, readFileSync as readFileSync5 } from "node:fs";
+import { dirname as dirname2, join as join3, resolve as resolve3 } from "node:path";
 function parseSpindleVersion(text2) {
   const m = /^\s*v?(\d+)\.(\d+)\.(\d+)(?:[-+].*)?\s*$/.exec(text2);
   return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : void 0;
@@ -25246,12 +25292,12 @@ function atLeast(version2, minimum) {
 }
 function readInstalledSpindleVersion(startDir) {
   const target = join3("node_modules", "@rohal12", "spindle", "package.json");
-  let dir = resolve2(startDir);
+  let dir = resolve3(startDir);
   for (; ; ) {
     const candidate = join3(dir, target);
     if (existsSync3(candidate)) {
       try {
-        const version2 = JSON.parse(readFileSync4(candidate, "utf-8")).version;
+        const version2 = JSON.parse(readFileSync5(candidate, "utf-8")).version;
         return typeof version2 === "string" && parseSpindleVersion(version2) ? version2 : void 0;
       } catch {
         return void 0;
@@ -25282,7 +25328,7 @@ var init_spindle_version = __esm({
 });
 
 // src/core/workspace/story-format.ts
-import { readFileSync as readFileSync5 } from "node:fs";
+import { readFileSync as readFileSync6 } from "node:fs";
 function isSpindleFormatName(name) {
   return name.trim().toLowerCase() === "spindle";
 }
@@ -25362,7 +25408,7 @@ async function findStoryFormat(texts, dir) {
   const projectTexts = [];
   for (const file2 of await findProjectFiles(findProjectRoot(dir), "**/*.{tw,twee}")) {
     try {
-      projectTexts.push(stripBom(readFileSync5(file2, "utf-8")));
+      projectTexts.push(stripBom(readFileSync6(file2, "utf-8")));
     } catch {
     }
   }
@@ -25389,7 +25435,7 @@ async function findSpindleTarget(texts, dir) {
     const projectTexts = [];
     for (const file2 of await findProjectFiles(findProjectRoot(dir), "**/*.{tw,twee}")) {
       try {
-        projectTexts.push(readFileSync5(file2, "utf-8"));
+        projectTexts.push(readFileSync6(file2, "utf-8"));
       } catch {
       }
     }
@@ -25865,7 +25911,7 @@ var init_workspace_model = __esm({
           text: (uri) => this.documents.getText(uri),
           passages: (uri) => this.passages.getPassagesInDocument(uri),
           context: () => ({
-            macros: this.macros.toolingMacros(),
+            macros: this.toolingMacros(),
             isBlock: (name) => this.isContainer(name)
           })
         });
@@ -26042,60 +26088,38 @@ var init_workspace_model = __esm({
         this.markup.invalidate();
         this.declaredVersion = storyDataFormatVersion(this.passages.getAllPassages(), (uri) => this.documents.getText(uri));
         this.target = resolveSpindleTarget(this.installedVersion, this.declaredVersion);
-        const storyVars = this.passages.getStoryVariables();
-        if (storyVars) {
-          const text2 = this.documents.getText(storyVars.uri);
-          if (text2) {
-            const lines = text2.split("\n");
-            const contentStart = storyVars.headerEnd.end.line + 1;
-            let contentEnd = lines.length;
-            for (let i2 = contentStart; i2 < lines.length; i2++) {
-              if (/^\uFEFF?::\s+/.test(lines[i2])) {
-                contentEnd = i2;
-                break;
-              }
-            }
-            const content = lines.slice(contentStart, contentEnd).join("\n");
-            this.variables.parseStoryVariables(content, contentStart, storyVars.uri);
-          }
-        } else {
-          this.variables.clearStoryVariables();
-        }
-        const storyTransients = this.passages.getStoryTransients();
-        if (storyTransients) {
-          const text2 = this.documents.getText(storyTransients.uri);
-          if (text2) {
-            const lines = text2.split("\n");
-            const contentStart = storyTransients.headerEnd.end.line + 1;
-            let contentEnd = lines.length;
-            for (let i2 = contentStart; i2 < lines.length; i2++) {
-              if (/^\uFEFF?::\s+/.test(lines[i2])) {
-                contentEnd = i2;
-                break;
-              }
-            }
-            const content = lines.slice(contentStart, contentEnd).join("\n");
-            this.variables.parseStoryTransients(content, contentStart, storyTransients.uri);
-          }
-        } else {
-          this.variables.clearStoryTransients();
-        }
-        const documents = this.documents.getUris().flatMap((uri) => {
+        const declarations = (name) => {
+          const passage = this.passages.getPassage(name);
+          return passage ? this.markup.get(passage.uri)?.passages.find((p) => p.passage === passage) : void 0;
+        };
+        const variables = declarations("StoryVariables");
+        if (variables) this.variables.parseStoryVariables(variables.content, variables.passage.headerEnd.end.line + 1, variables.doc.uri);
+        else this.variables.clearStoryVariables();
+        const transients = declarations("StoryTransients");
+        if (transients) this.variables.parseStoryTransients(transients.content, transients.passage.headerEnd.end.line + 1, transients.doc.uri);
+        else this.variables.clearStoryTransients();
+        const readDocuments = () => this.documents.getUris().flatMap((uri) => {
           const markup = isMacroSource(uri) ? void 0 : this.markup.get(uri);
           return markup ? [markup] : [];
         });
         const markups = /* @__PURE__ */ new Map();
-        for (const doc of documents) for (const passage of doc.passages) markups.set(passage.passage, passage);
+        for (const doc of readDocuments()) for (const passage of doc.passages) markups.set(passage.passage, passage);
         this.widgets.scan(
           this.passages.getAllPassages().flatMap((passage) => markups.get(passage) ?? []),
           this.macros.toolingMacros()
         );
+        this.markup.invalidate();
         this.widgets.clearInvocations();
-        for (const doc of documents) {
+        for (const doc of readDocuments()) {
           this.variables.scanDocument(doc.uri, doc.text, doc);
           this.widgets.recordInvocations(doc.uri, doc.passages);
         }
       }
+      /** All runtime metadata, with real macros taking precedence over widgets. */
+      toolingMacros() {
+        const macros = this.macros.toolingMacros();
+        return [...macros, ...this.widgets.getAllWidgets().filter((widget) => !this.macros.getMacro(widget.name)).map((widget) => ({ name: widget.name, block: widget.block, subMacros: [], widget: widget.tooling }))];
+      }
       /** Debounce modelReady emission. */
       scheduleModelReady() {
         if (this.debounceTimer) {
@@ -26205,6 +26229,36 @@ var init_diagnostic_codes = __esm({
   }
 });
 
+// src/core/markup/source-view.ts
+function viewIndex(view, offset2) {
+  if (!view.sourceOffsets) return offset2 - view.offset;
+  let low = 0;
+  let high = view.sourceOffsets.length - 1;
+  while (low < high) {
+    const mid = Math.ceil((low + high) / 2);
+    if (view.sourceOffsets[mid] <= offset2) low = mid;
+    else high = mid - 1;
+  }
+  return low;
+}
+function textAt(passage, start, end) {
+  return passage.pieces.filter((piece) => piece.kind === "text" && piece.offset <= start && pieceOffset(piece, piece.text.length) >= end).at(-1);
+}
+function sourceView(passage, start, end) {
+  const owner = passage.pieces.filter((piece) => {
+    const value = piece.kind === "text" ? piece.text : piece.kind === "code" ? piece.code : void 0;
+    return value !== void 0 && piece.offset <= start && pieceOffset(piece, value.length) >= end;
+  }).at(-1);
+  if (owner?.kind === "code") return { ...owner, text: owner.code };
+  return owner?.kind === "text" ? owner : { offset: 0, text: passage.content };
+}
+var init_source_view = __esm({
+  "src/core/markup/source-view.ts"() {
+    "use strict";
+    init_tooling();
+  }
+});
+
 // src/core/parsing/argument-lexer.ts
 function lexArguments(source) {
   let from = 0;
@@ -26553,6 +26607,7 @@ var TypeError2, TypeWarning, parameterTypes, LEX_LIMIT, wsRe, identStartRe, iden
 var init_parameter_validator = __esm({
   "src/core/parsing/parameter-validator.ts"() {
     "use strict";
+    init_tooling();
     init_argument_lexer();
     TypeError2 = class {
       constructor(message) {
@@ -26666,7 +26721,8 @@ var init_parameter_validator = __esm({
         validate(arg, _args, _index, state) {
           let passageName;
           if (arg.type === 0 /* String */) {
-            passageName = arg.text.slice(1, -1);
+            const target = passageTarget(arg.text);
+            if (target.kind === "name") passageName = target.name;
           } else if (arg.type === 8 /* Bareword */) {
             passageName = arg.text;
           } else if (arg.type === 1 /* Number */) {
@@ -26675,7 +26731,6 @@ var init_parameter_validator = __esm({
             passageName = "NaN";
           }
           if (passageName !== void 0) {
-            passageName = passageName.replace(/\\/g, "");
             if (state && state.passages.length > 0) {
               if (!state.passages.includes(passageName)) {
                 return new TypeWarning(`Nonexistent passage: "${passageName}"`);
@@ -27167,7 +27222,9 @@ function fromMarkup(passage, found, workspace) {
       if (element) code = DiagnosticCode.MalformedElement;
       else if (found.code === "stray-closer" && !workspace.isContainer(name)) code = DiagnosticCode.IllegalClosingTag;
       if (found.code === "unclosed-block") {
-        data2 = { kind: "unclosed-block", closer: element ? `</${name}>` : `{/${name}}`, at: passage.position(passage.content.trimEnd().length) };
+        const owner = textAt(passage, found.start, found.end);
+        const end = owner ? pieceOffset(owner, owner.text.trimEnd().length) : passage.content.trimEnd().length;
+        data2 = { kind: "unclosed-block", closer: element ? `</${name}>` : `{/${name}}`, at: passage.position(end) };
       }
       break;
     }
@@ -27399,10 +27456,9 @@ function loopDiagnostics(passage, token, ancestors) {
   if (!loop || !close) return [];
   const targets = macro === "computed" ? computedTemporaryTarget(token.rawArgs) : setTemporaryTargets(token.rawArgs);
   const bodyStart = loop.node.token.end;
-  const body = passage.content.slice(bodyStart, close.start);
   const diagnostics = [];
   for (const target of targets) {
-    if (!isReadInBody(body, bodyStart, target.name, token.start, token.end)) continue;
+    if (!isReadInBody(passage, bodyStart, close.start, target.name, token.start, token.end)) continue;
     const start = token.argsStart + target.offset;
     diagnostics.push(makeDiag(
       passage.range(start, start + 1 + target.name.length),
@@ -27412,22 +27468,28 @@ function loopDiagnostics(passage, token, ancestors) {
   }
   return diagnostics;
 }
-function isReadInBody(body, bodyOffset, name, macroStart, macroEnd) {
-  const re2 = temporaryRefRegex(name);
-  let m;
-  while ((m = re2.exec(body)) !== null) {
-    const offset2 = bodyOffset + m.index;
-    if (offset2 >= macroStart && offset2 < macroEnd) continue;
-    const after = body.slice(m.index + m[0].length);
-    if (/^\s*=(?![=>])/.test(after)) continue;
-    return true;
+function isReadInBody(passage, bodyStart, bodyEnd, name, macroStart, macroEnd) {
+  const eligible = (offset2) => offset2 >= bodyStart && offset2 < bodyEnd && !(offset2 >= macroStart && offset2 < macroEnd);
+  for (const token of markupTokens(passage)) {
+    if (token.type === "variable" && token.scope === "temporary" && token.name.split(".")[0] === name && eligible(token.start)) return true;
+  }
+  for (const piece of passage.pieces) {
+    if (piece.kind !== "code") continue;
+    let read = false;
+    lexJs(piece.code, {
+      variable(sigil, found, index, _nesting, end) {
+        if (sigil !== "_" || found !== name || !eligible(pieceOffset(piece, index))) return;
+        if (!/^\s*=(?![=>])/.test(maskLiterals(piece.code.slice(end)))) read = true;
+      }
+    }, piece.goal);
+    if (read) return true;
   }
   return false;
 }
 function argumentDiagnostics(passage, workspace) {
   const diagnostics = [];
   const passageNames = Array.from(workspace.passages.getAllPassages(), (candidate) => candidate.name);
-  for (const token of passage.isMarkup ? passage.tokens : []) {
+  for (const token of passage.isMarkup ? macroTokens(passage) : []) {
     if (token.type !== "macro" || token.isClose) continue;
     const info = workspace.macros.getMacro(token.name);
     if (!info?.parameters || info.skipArgs || SPINDLE_MACROS.has(token.name.toLowerCase())) continue;
@@ -27588,6 +27650,7 @@ var init_diagnostics = __esm({
     init_tooling();
     init_diagnostic_codes();
     init_tokens();
+    init_source_view();
     init_argument_lexer();
     init_parameter_validator();
     init_link_parser();
@@ -27830,8 +27893,7 @@ var check_exports = {};
 __export(check_exports, {
   runCheck: () => runCheck
 });
-import { readFileSync as readFileSync6 } from "node:fs";
-import { resolve as resolve3 } from "node:path";
+import { resolve as resolve4 } from "node:path";
 import { pathToFileURL as pathToFileURL3 } from "node:url";
 function parseArgs(args2) {
   const options = {
@@ -27907,22 +27969,21 @@ async function runCheck(args2) {
   let explicitConfig = null;
   if (options.configPath) {
     try {
-      explicitConfig = loadConfigFile(resolve3(cwd, options.configPath));
+      explicitConfig = loadConfigFile(resolve4(cwd, options.configPath));
     } catch (err) {
       console.error(`spindle-lsp check: ${err instanceof Error ? err.message : String(err)}`);
       return 2;
     }
   }
-  const files = [];
-  for (const pattern of options.patterns) {
-    const matches = await Ze(pattern, {
-      cwd,
-      absolute: true,
-      nodir: true
-    });
-    files.push(...matches);
+  let uniqueFiles;
+  let contents;
+  try {
+    uniqueFiles = await resolveInputs(options.patterns, cwd);
+    contents = readFileContents(uniqueFiles);
+  } catch (error48) {
+    console.error(`spindle-lsp check: ${error48 instanceof Error ? error48.message : String(error48)}`);
+    return 2;
   }
-  const uniqueFiles = [...new Set(files)];
   if (uniqueFiles.length === 0) {
     if (options.format === "pretty") {
       console.log("No files found");
@@ -27946,15 +28007,7 @@ async function runCheck(args2) {
       return 1;
     }
   }
-  const fileContents = /* @__PURE__ */ new Map();
-  for (const filePath of uniqueFiles) {
-    try {
-      const text2 = readFileSync6(filePath, "utf-8");
-      const uri = pathToFileURL3(filePath).toString();
-      fileContents.set(uri, text2);
-    } catch {
-    }
-  }
+  const fileContents = new Map([...contents].map(([path, text2]) => [pathToFileURL3(path).toString(), text2]));
   const storyFormat = await findStoryFormat(fileContents.values(), commonDir);
   if (!storyFormat.isSpindle) {
     console.error(skippedFormatNote(storyFormat));
@@ -28007,7 +28060,7 @@ var SEVERITY_ORDER;
 var init_check = __esm({
   "src/cli/check.ts"() {
     "use strict";
-    init_index_min();
+    init_file_inputs();
     init_workspace_model();
     init_diagnostics();
     init_config_loader();
@@ -28043,7 +28096,7 @@ function splitPassages(text2) {
     }
   }
   for (let i2 = 0; i2 < lines.length; i2++) {
-    if (PASSAGE_HEADER_REGEX.test(lines[i2])) {
+    if (parsePassageHeader(lines[i2], i2)) {
       pushPassage();
       currentHeader = lines[i2];
       bodyLines = [];
@@ -28056,7 +28109,7 @@ function splitPassages(text2) {
   return passages;
 }
 function classifyPassage(header) {
-  const tags = headerTags(header).map((t) => t.toLowerCase());
+  const tags = headerTags(header);
   if (tags.includes("script")) return "script";
   if (tags.includes("stylesheet")) return "stylesheet";
   return "normal";
@@ -28067,22 +28120,23 @@ function headerTags(header) {
   const unescaped = header.replace(/\\./g, "ec");
   return (unescaped.match(/\[[^\]]*\]/g) ?? []).flatMap((t) => t.slice(1, -1).split(/\s+/));
 }
-var PASSAGE_HEADER_REGEX;
 var init_segment = __esm({
   "src/plugins/format/segment.ts"() {
     "use strict";
     init_passage_parser();
-    PASSAGE_HEADER_REGEX = /^::\s+/;
   }
 });
 
 // src/plugins/format/prettier-bridge.ts
-async function loadPrettier() {
+import { resolve as resolve5 } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+async function loadPrettier(filePath) {
   prettier ??= import("prettier").catch(() => null);
   const p = await prettier;
   if (!p) return void 0;
   try {
-    const resolved = await p.resolveConfig(process.cwd());
+    const path = filePath?.startsWith("file:") ? fileURLToPath2(filePath) : filePath;
+    const resolved = await p.resolveConfig(path ?? resolve5(process.cwd(), "story.tw"));
     return { prettier: p, options: { tabWidth: 2, ...resolved ?? {} } };
   } catch {
     return { prettier: p, options: { tabWidth: 2 } };
@@ -28122,7 +28176,7 @@ function dominantEol2(text2) {
 async function formatLf2(text2, options) {
   const isBlock = options?.isBlock ?? buildDefaultIsBlock(text2);
   const isDedentingSubMacro = options?.isDedentingSubMacro ?? ((name) => DEFAULT_DEDENTING2.has(name.toLowerCase()));
-  const prettier2 = await loadPrettier();
+  const prettier2 = await loadPrettier(options?.filePath);
   const passages = splitPassages(text2);
   const resultLines = [];
   for (let pi2 = 0; pi2 < passages.length; pi2++) {
@@ -28136,12 +28190,14 @@ async function formatLf2(text2, options) {
       }
     }
     if (passage.header) {
-      const header = PASSAGE_HEADER_REGEX2.test(passage.header) ? normalizePassageHeader(passage.header) : passage.header;
+      const header = PASSAGE_HEADER_REGEX.test(passage.header) ? normalizePassageHeader(passage.header) : passage.header;
       resultLines.push(header.replace(/\s+$/, ""));
     }
     if (passage.body === "") continue;
-    const body = await formatPassage(passage.body, {
-      kind: classifyPassage(passage.header),
+    const role = parsePassageHeader(passage.header, passage.startLine);
+    const kind = classifyPassage(passage.header);
+    const body = kind === "normal" && role && !isMarkupPassage(role) ? passage.body : await formatPassage(passage.body, {
+      kind,
       prettier: prettier2?.prettier,
       prettierOptions: prettier2?.options,
       isBlock,
@@ -28156,7 +28212,7 @@ async function formatRange(text2, _range, options) {
   return formatDocument(text2, options);
 }
 function normalizePassageHeader(line) {
-  const headerMatch = line.match(/^::\s+(.*)/);
+  const headerMatch = line.match(/^::\s*(.*)/);
   if (!headerMatch) return line;
   const rest = headerMatch[1];
   const unescaped = rest.replace(/\\./g, "ec");
@@ -28175,14 +28231,15 @@ function normalizePassageHeader(line) {
   }
   return `:: ${name}${suffix}`;
 }
-var PASSAGE_HEADER_REGEX2, DEFAULT_DEDENTING2, BUILTIN_CONTAINERS, formatPlugin;
+var PASSAGE_HEADER_REGEX, DEFAULT_DEDENTING2, BUILTIN_CONTAINERS, formatPlugin;
 var init_format = __esm({
   "src/plugins/format.ts"() {
     "use strict";
     init_tooling();
+    init_passage_parser();
     init_segment();
     init_prettier_bridge();
-    PASSAGE_HEADER_REGEX2 = /^(::)\s+/;
+    PASSAGE_HEADER_REGEX = /^(::)\s*/;
     DEFAULT_DEDENTING2 = /* @__PURE__ */ new Set(["else", "elseif", "next", "case", "default"]);
     BUILTIN_CONTAINERS = new Set(builtinMacros.filter((m) => m.block).map((m) => m.name.toLowerCase()));
     formatPlugin = {
@@ -28200,7 +28257,7 @@ var init_format = __esm({
         ctx.connection.onDocumentFormatting(async (params) => {
           const text2 = ctx.workspace.documents.getText(params.textDocument.uri);
           if (text2 === void 0) return [];
-          const formatted = await formatDocument(text2, formatOpts);
+          const formatted = await formatDocument(text2, { ...formatOpts, filePath: params.textDocument.uri });
           if (formatted === text2) return [];
           const lines = text2.split("\n");
           return [{
@@ -28218,7 +28275,7 @@ var init_format = __esm({
             start: { line: params.range.start.line, character: params.range.start.character },
             end: { line: params.range.end.line, character: params.range.end.character }
           };
-          const formatted = await formatRange(text2, range, formatOpts);
+          const formatted = await formatRange(text2, range, { ...formatOpts, filePath: params.textDocument.uri });
           if (formatted === text2) return [];
           const lines = text2.split("\n");
           return [{
@@ -28239,7 +28296,7 @@ var format_exports = {};
 __export(format_exports, {
   runFormat: () => runFormat
 });
-import { readFileSync as readFileSync7, writeFileSync } from "node:fs";
+import { writeFileSync } from "node:fs";
 function parseArgs2(args2) {
   const options = {
     check: false,
@@ -28275,27 +28332,19 @@ function parseArgs2(args2) {
 async function runFormat(args2) {
   const options = parseArgs2(args2);
   const cwd = process.cwd();
-  const files = [];
-  for (const pattern of options.patterns) {
-    const matches = await Ze(pattern, {
-      cwd,
-      absolute: true,
-      nodir: true
-    });
-    files.push(...matches);
+  let uniqueFiles;
+  let texts;
+  try {
+    uniqueFiles = await resolveInputs(options.patterns, cwd);
+    texts = readFileContents(uniqueFiles);
+  } catch (error48) {
+    console.error(`spindle-lsp format: ${error48 instanceof Error ? error48.message : String(error48)}`);
+    return 2;
   }
-  const uniqueFiles = [...new Set(files)];
   if (uniqueFiles.length === 0) {
     console.log("No files found");
     return 0;
   }
-  const texts = /* @__PURE__ */ new Map();
-  for (const filePath of uniqueFiles) {
-    try {
-      texts.set(filePath, readFileSync7(filePath, "utf-8"));
-    } catch {
-    }
-  }
   const storyFormat = await findStoryFormat(texts.values(), commonDirectory(uniqueFiles));
   if (!storyFormat.isSpindle) {
     console.error(skippedFormatNote(storyFormat));
@@ -28308,9 +28357,10 @@ async function runFormat(args2) {
     formatOpts.maxLineLength = options.maxLineLength;
   }
   const unformatted = [];
+  let failed = false;
   for (const [filePath, text2] of texts) {
     try {
-      const formatted = await formatDocument(text2, formatOpts);
+      const formatted = await formatDocument(text2, { ...formatOpts, filePath });
       if (formatted !== text2) {
         if (options.check) {
           const relative2 = filePath.startsWith(cwd) ? filePath.slice(cwd.length + 1) : filePath;
@@ -28319,9 +28369,12 @@ async function runFormat(args2) {
           writeFileSync(filePath, formatted, "utf-8");
         }
       }
-    } catch {
+    } catch (error48) {
+      failed = true;
+      console.error(`spindle-lsp format: ${filePath}: ${error48 instanceof Error ? error48.message : String(error48)}`);
     }
   }
+  if (failed) return 2;
   if (options.check) {
     if (unformatted.length > 0) {
       for (const file2 of unformatted) {
@@ -28338,7 +28391,7 @@ ${unformatted.length} file${unformatted.length !== 1 ? "s" : ""} would be reform
 var init_format2 = __esm({
   "src/cli/format.ts"() {
     "use strict";
-    init_index_min();
+    init_file_inputs();
     init_format();
     init_macro_sources();
     init_story_format();
@@ -50599,7 +50652,7 @@ var init_protocol = __esm({
               return;
             }
             const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-            await new Promise((resolve5) => setTimeout(resolve5, pollInterval));
+            await new Promise((resolve6) => setTimeout(resolve6, pollInterval));
             options?.signal?.throwIfAborted();
           }
         } catch (error48) {
@@ -50616,7 +50669,7 @@ var init_protocol = __esm({
        */
       request(request, resultSchema, options) {
         const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-        return new Promise((resolve5, reject) => {
+        return new Promise((resolve6, reject) => {
           const earlyReject = (error48) => {
             reject(error48);
           };
@@ -50694,7 +50747,7 @@ var init_protocol = __esm({
               if (!parseResult.success) {
                 reject(parseResult.error);
               } else {
-                resolve5(parseResult.data);
+                resolve6(parseResult.data);
               }
             } catch (error48) {
               reject(error48);
@@ -50956,12 +51009,12 @@ var init_protocol = __esm({
           }
         } catch {
         }
-        return new Promise((resolve5, reject) => {
+        return new Promise((resolve6, reject) => {
           if (signal.aborted) {
             reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
             return;
           }
-          const timeoutId = setTimeout(resolve5, interval);
+          const timeoutId = setTimeout(resolve6, interval);
           signal.addEventListener("abort", () => {
             clearTimeout(timeoutId);
             reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -53988,7 +54041,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref2];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve5.call(this, root, ref2);
+      let _sch = resolve6.call(this, root, ref2);
       if (_sch === void 0) {
         const schema = (_a2 = root.localRefs) === null || _a2 === void 0 ? void 0 : _a2[ref2];
         const { schemaId } = this.opts;
@@ -54015,7 +54068,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve5(root, ref2) {
+    function resolve6(root, ref2) {
       let sch;
       while (typeof (sch = this.refs[ref2]) == "string")
         ref2 = sch;
@@ -54590,7 +54643,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve5(baseURI, relativeURI, options) {
+    function resolve6(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const resolved = resolveComponent(parse6(baseURI, schemelessOptions), parse6(relativeURI, schemelessOptions), schemelessOptions, true);
       schemelessOptions.skipEscape = true;
@@ -54817,7 +54870,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize,
-      resolve: resolve5,
+      resolve: resolve6,
       resolveComponent,
       equal,
       serialize,
@@ -58975,7 +59028,7 @@ var init_mcp = __esm({
         let task = createTaskResult.task;
         const pollInterval = task.pollInterval ?? 5e3;
         while (task.status !== "completed" && task.status !== "failed" && task.status !== "cancelled") {
-          await new Promise((resolve5) => setTimeout(resolve5, pollInterval));
+          await new Promise((resolve6) => setTimeout(resolve6, pollInterval));
           const updatedTask = await extra.taskStore.getTask(taskId);
           if (!updatedTask) {
             throw new McpError(ErrorCode.InternalError, `Task ${taskId} not found during polling`);
@@ -59584,12 +59637,12 @@ var init_stdio2 = __esm({
         this.onclose?.();
       }
       send(message) {
-        return new Promise((resolve5) => {
+        return new Promise((resolve6) => {
           const json2 = serializeMessage(message);
           if (this._stdout.write(json2)) {
-            resolve5();
+            resolve6();
           } else {
-            this._stdout.once("drain", resolve5);
+            this._stdout.once("drain", resolve6);
           }
         });
       }
@@ -59606,8 +59659,7 @@ __export(server_exports, {
   formatFiles: () => formatFiles,
   startMcpServer: () => startMcpServer
 });
-import { readFileSync as readFileSync8, writeFileSync as writeFileSync2, statSync } from "node:fs";
-import { resolve as resolve4 } from "node:path";
+import { writeFileSync as writeFileSync2 } from "node:fs";
 import { pathToFileURL as pathToFileURL4 } from "node:url";
 function filterBySeverity2(diagnostics, minSeverity) {
   const minIdx = SEVERITY_ORDER2.indexOf(minSeverity);
@@ -59616,37 +59668,8 @@ function filterBySeverity2(diagnostics, minSeverity) {
     return idx >= minIdx;
   });
 }
-async function resolveFiles(pattern, cwd) {
-  let input = pattern;
-  let directory = cwd;
-  try {
-    const literal3 = resolve4(cwd, pattern);
-    const stat = statSync(literal3);
-    if (stat.isFile()) return [literal3];
-    if (stat.isDirectory()) {
-      directory = literal3;
-      input = "**/*.{tw,twee}";
-    }
-  } catch {
-  }
-  const matches = await Ze(input, {
-    cwd: directory,
-    absolute: true,
-    nodir: true
-  });
-  return [...new Set(matches)];
-}
 function readFiles(files) {
-  const fileContents = /* @__PURE__ */ new Map();
-  for (const filePath of files) {
-    try {
-      const text2 = readFileSync8(filePath, "utf-8");
-      const uri = pathToFileURL4(filePath).toString();
-      fileContents.set(uri, text2);
-    } catch {
-    }
-  }
-  return fileContents;
+  return new Map([...readFileContents(files)].map(([path, text2]) => [pathToFileURL4(path).toString(), text2]));
 }
 async function skippedReason(fileContents, files) {
   const format = await findStoryFormat(fileContents.values(), commonDirectory(files));
@@ -59683,7 +59706,6 @@ async function checkProject(pattern, severity, cwd = process.cwd()) {
     const results = [];
     for (const filePath of files) {
       const uri = pathToFileURL4(filePath).toString();
-      if (!workspace.documents.has(uri)) continue;
       let diags = computeDiagnostics(uri, workspace);
       if (severity) {
         diags = filterBySeverity2(diags, severity);
@@ -59721,7 +59743,7 @@ async function formatFiles(pattern, cwd = process.cwd()) {
     const text2 = contents.get(pathToFileURL4(filePath).toString());
     if (text2 === void 0) continue;
     try {
-      const result = await formatDocument(text2);
+      const result = await formatDocument(text2, { filePath });
       if (result !== text2) {
         writeFileSync2(filePath, result, "utf-8");
         formatted++;
@@ -59729,7 +59751,8 @@ async function formatFiles(pattern, cwd = process.cwd()) {
       } else {
         unchanged++;
       }
-    } catch {
+    } catch (error48) {
+      throw new Error(`${filePath}: ${error48 instanceof Error ? error48.message : String(error48)}`, { cause: error48 });
     }
   }
   return { formatted, unchanged, files: changedFiles, ...warning && { warning } };
@@ -59746,9 +59769,10 @@ async function checkFormatting(pattern, cwd = process.cwd()) {
     const text2 = contents.get(pathToFileURL4(filePath).toString());
     if (text2 === void 0) continue;
     try {
-      const result = await formatDocument(text2);
+      const result = await formatDocument(text2, { filePath });
       (result !== text2 ? needsFormatting : alreadyFormatted).push(relativeTo(cwd, filePath));
-    } catch {
+    } catch (error48) {
+      throw new Error(`${filePath}: ${error48 instanceof Error ? error48.message : String(error48)}`, { cause: error48 });
     }
   }
   return { needsFormatting, alreadyFormatted, ...warning && { warning } };
@@ -59808,7 +59832,7 @@ var SEVERITY_ORDER2;
 var init_server3 = __esm({
   "src/mcp/server.ts"() {
     "use strict";
-    init_index_min();
+    init_file_inputs();
     init_mcp();
     init_stdio2();
     init_zod();
@@ -61083,8 +61107,8 @@ var require_semaphore = __commonJS({
         this._waiting = [];
       }
       lock(thunk) {
-        return new Promise((resolve5, reject) => {
-          this._waiting.push({ thunk, resolve: resolve5, reject });
+        return new Promise((resolve6, reject) => {
+          this._waiting.push({ thunk, resolve: resolve6, reject });
           this.runNext();
         });
       }
@@ -62710,9 +62734,9 @@ ${JSON.stringify(message, null, 4)}`);
           if (typeof cancellationStrategy.sender.enableCancellation === "function") {
             cancellationStrategy.sender.enableCancellation(requestMessage);
           }
-          return new Promise(async (resolve5, reject) => {
+          return new Promise(async (resolve6, reject) => {
             const resolveWithCleanup = (r) => {
-              resolve5(r);
+              resolve6(r);
               cancellationStrategy.sender.cleanup(id);
               disposable?.dispose();
             };
@@ -68354,8 +68378,8 @@ var require_server = __commonJS({
         if (value instanceof Promise) {
           return value;
         } else if (Is3.thenable(value)) {
-          return new Promise((resolve5, reject) => {
-            value.then((resolved) => resolve5(resolved), (error48) => reject(error48));
+          return new Promise((resolve6, reject) => {
+            value.then((resolved) => resolve6(resolved), (error48) => reject(error48));
           });
         } else {
           return Promise.resolve(value);
@@ -68639,7 +68663,7 @@ var require_files = __commonJS({
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.FileSystem = void 0;
     exports.uriToFilePath = uriToFilePath;
-    exports.resolve = resolve5;
+    exports.resolve = resolve6;
     exports.resolveGlobalNodePath = resolveGlobalNodePath;
     exports.resolveGlobalYarnPath = resolveGlobalYarnPath;
     exports.resolveModulePath = resolveModulePath;
@@ -68668,7 +68692,7 @@ var require_files = __commonJS({
     function isWindows() {
       return process.platform === "win32";
     }
-    function resolve5(moduleName, nodePath, cwd, tracer) {
+    function resolve6(moduleName, nodePath, cwd, tracer) {
       const nodePathKey = "NODE_PATH";
       const app = [
         "var p = process;",
@@ -68687,7 +68711,7 @@ var require_files = __commonJS({
         "}",
         "});"
       ].join("");
-      return new Promise((resolve6, reject) => {
+      return new Promise((resolve7, reject) => {
         const env = process.env;
         const newEnv = /* @__PURE__ */ Object.create(null);
         Object.keys(env).forEach((key) => newEnv[key] = env[key]);
@@ -68719,7 +68743,7 @@ var require_files = __commonJS({
             if (message2.c === "r") {
               cp.send({ c: "e" });
               if (message2.s) {
-                resolve6(message2.r);
+                resolve7(message2.r);
               } else {
                 reject(new Error(`Failed to resolve module: ${moduleName}`));
               }
@@ -68847,17 +68871,17 @@ var require_files = __commonJS({
         if (!path.isAbsolute(nodePath)) {
           nodePath = path.join(workspaceRoot, nodePath);
         }
-        return resolve5(moduleName, nodePath, nodePath, tracer).then((value) => {
+        return resolve6(moduleName, nodePath, nodePath, tracer).then((value) => {
           if (FileSystem.isParent(nodePath, value)) {
             return value;
           } else {
             return Promise.reject(new Error(`Failed to load ${moduleName} from node path location.`));
           }
         }).then(void 0, (_error) => {
-          return resolve5(moduleName, resolveGlobalNodePath(tracer), workspaceRoot, tracer);
+          return resolve6(moduleName, resolveGlobalNodePath(tracer), workspaceRoot, tracer);
         });
       } else {
-        return resolve5(moduleName, resolveGlobalNodePath(tracer), workspaceRoot, tracer);
+        return resolve6(moduleName, resolveGlobalNodePath(tracer), workspaceRoot, tracer);
       }
     }
   }
@@ -68939,10 +68963,10 @@ var require_ril = __commonJS({
         return api_1.Disposable.create(() => this.stream.off("end", listener));
       }
       write(data2, encoding) {
-        return new Promise((resolve5, reject) => {
+        return new Promise((resolve6, reject) => {
           const callback = (error48) => {
             if (error48 === void 0 || error48 === null) {
-              resolve5();
+              resolve6();
             } else {
               reject(error48);
             }
@@ -69234,10 +69258,10 @@ var require_main = __commonJS({
     }
     function createClientPipeTransport(pipeName, encoding = "utf-8") {
       let connectResolve;
-      const connected = new Promise((resolve5, _reject) => {
-        connectResolve = resolve5;
+      const connected = new Promise((resolve6, _reject) => {
+        connectResolve = resolve6;
       });
-      return new Promise((resolve5, reject) => {
+      return new Promise((resolve6, reject) => {
         const server = (0, net_1.createServer)((socket) => {
           server.close();
           connectResolve([
@@ -69248,7 +69272,7 @@ var require_main = __commonJS({
         server.on("error", reject);
         server.listen(pipeName, () => {
           server.removeListener("error", reject);
-          resolve5({
+          resolve6({
             onConnected: () => {
               return connected;
             }
@@ -69265,10 +69289,10 @@ var require_main = __commonJS({
     }
     function createClientSocketTransport(port, encoding = "utf-8") {
       let connectResolve;
-      const connected = new Promise((resolve5, _reject) => {
-        connectResolve = resolve5;
+      const connected = new Promise((resolve6, _reject) => {
+        connectResolve = resolve6;
       });
-      return new Promise((resolve5, reject) => {
+      return new Promise((resolve6, reject) => {
         const server = (0, net_1.createServer)((socket) => {
           server.close();
           connectResolve([
@@ -69285,7 +69309,7 @@ var require_main = __commonJS({
             return;
           }
           const boundPort = address.port;
-          resolve5({
+          resolve6({
             port: () => boundPort,
             onConnected: () => {
               return connected;
@@ -70079,6 +70103,7 @@ var init_markup_cursor = __esm({
     init_tooling();
     init_passage_markup();
     init_tree();
+    init_source_view();
     init_text();
     MarkupCursor = class {
       constructor(passage, at3, workspace) {
@@ -70104,6 +70129,7 @@ var init_markup_cursor = __esm({
           start: 0,
           end: content.length,
           text: false,
+          view: { offset: 0, text: content },
           tokens: passage.tokens,
           errors: passage.tokenization.errors,
           nodes: () => passage.pairing.nodes
@@ -70116,6 +70142,7 @@ var init_markup_cursor = __esm({
             start: piece.offset,
             end,
             text: true,
+            view: piece,
             tokens: piece.tokens,
             errors: piece.errors,
             nodes: () => pairMarkup(piece.tokens, { isBlock: (name) => this.workspace.isContainer(name), source: content }).nodes
@@ -70130,17 +70157,19 @@ var init_markup_cursor = __esm({
        * of its name.
        */
       enclosingMacro(known) {
-        const { content, at: at3 } = this;
+        const { at: at3 } = this;
         for (const region of this.regions) {
           const found = [];
           for (const token of region.tokens) {
             if (token.type !== "macro" || token.isClose || token.nameEnd >= at3 || at3 >= token.end) continue;
-            found.push({ start: token.start, name: token.name, argsBefore: at3 >= token.argsStart ? content.slice(token.argsStart, at3) : "" });
+            found.push({ start: token.start, name: token.name, argsBefore: at3 >= token.argsStart ? region.view.text.slice(viewIndex(region.view, token.argsStart), viewIndex(region.view, at3)) : "" });
           }
           for (const error48 of region.errors) {
-            if (error48.code !== "unclosed-macro" || error48.offset >= at3 || error48.end >= at3 || !/\s/.test(content[error48.end] ?? "")) continue;
-            const name = content.slice(parseSelectors(content, error48.offset + 1).end, error48.end);
-            if (name && name[0] !== "/") found.push({ start: error48.offset, name, argsBefore: content.slice(error48.end, at3).trimStart() });
+            const source = region.view.text;
+            const end = viewIndex(region.view, error48.end);
+            if (error48.code !== "unclosed-macro" || error48.offset >= at3 || error48.end >= at3 || !/\s/.test(source[end] ?? "")) continue;
+            const name = source.slice(parseSelectors(source, viewIndex(region.view, error48.offset) + 1).end, end);
+            if (name && name[0] !== "/") found.push({ start: error48.offset, name, argsBefore: source.slice(end, viewIndex(region.view, at3)).trimStart() });
           }
           const innermost = found.filter((macro) => known(macro.name)).sort((a, b) => b.start - a.start)[0];
           if (innermost) return { name: innermost.name, argsBefore: innermost.argsBefore };
@@ -70229,10 +70258,9 @@ function variableUses(passage) {
   for (const piece of passage.pieces) {
     if (piece.kind !== "code") continue;
     lexJs(piece.code, {
-      variable(sigil, name, index) {
-        const nameEnd = index + 1 + name.length;
+      variable(sigil, name, index, _nesting, nameEnd) {
         const pathEnd = nameEnd + pathLength(piece.code, nameEnd);
-        uses.push({ sigil, name, start: pieceOffset(piece, index), end: pieceOffset(piece, pathEnd - 1) + 1 });
+        uses.push({ sigil, name, start: pieceOffset(piece, index), end: pieceOffset(piece, pathEnd) });
       }
     }, piece.goal);
   }
@@ -70824,27 +70852,7 @@ function findReferences(uri, position, workspace, includeDeclaration) {
   return [];
 }
 function variableAt(uri, position, workspace) {
-  const line = workspace.documents.getText(uri)?.split("\n")[position.line];
-  if (line === void 0) return null;
-  let atEnd = null;
-  VARIABLE_CANDIDATE.lastIndex = 0;
-  let found;
-  while ((found = VARIABLE_CANDIDATE.exec(line)) !== null) {
-    const match = VARIABLE_PATH.exec(line.slice(found.index));
-    const start = found.index;
-    const end = start + match[0].length;
-    VARIABLE_CANDIDATE.lastIndex = start + 1;
-    if (position.character < start || position.character > end) continue;
-    const sigil = match[1];
-    const name = match[2].split(".")[0];
-    const refs = sigil === "%" ? findTransientReferences(name, workspace, true) : findVariableReferences(name, workspace, true);
-    const hit = refs.find((r) => r.uri === uri && r.range.start.line === position.line && r.range.start.character === start);
-    if (!hit) continue;
-    const symbol2 = { sigil, name, range: hit.range };
-    if (position.character < end) return symbol2;
-    atEnd ??= symbol2;
-  }
-  return atEnd;
+  return workspace.variables.referenceAt(uri, position);
 }
 function findPassageReferences(passageName, workspace, includeDeclaration) {
   const locations = [];
@@ -70927,15 +70935,13 @@ function toLspRange3(r) {
     end: { line: r.end.line, character: r.end.character }
   };
 }
-var VARIABLE_CANDIDATE, VARIABLE_PATH, referencesPlugin;
+var referencesPlugin;
 var init_references = __esm({
   "src/plugins/references.ts"() {
     "use strict";
     init_macro_heads();
     init_passage_refs();
     init_passage_parser();
-    VARIABLE_CANDIDATE = /(?:\$|(?<!\w)%)(?=\w)/g;
-    VARIABLE_PATH = /^([$%])(\w+(?:\.[A-Za-z_$][\w$]*)*)/;
     referencesPlugin = {
       id: "references",
       capabilities: {
@@ -71039,17 +71045,32 @@ function computeRename(uri, position, newName, workspace) {
           `Cannot rename to ${JSON.stringify(newName)}: a transient name cannot start with a digit, \`%5\` is the modulo operator in code.`
         ).at(uri, symbol2.range);
       }
+      const declaration = parseDeclarations(`${symbol2.sigil}${bareName} = 0`, symbol2.sigil);
+      if (declaration.errors.length || declaration.declarations[0]?.name !== bareName) {
+        throw new RenameError(`Cannot rename to ${JSON.stringify(newName)}: ${declaration.errors[0]?.message ?? "invalid variable name"}.`).at(uri, symbol2.range);
+      }
       if (bareName === symbol2.name) return /* @__PURE__ */ new Map();
       if (workspace.variables.getDeclared().has(bareName) || workspace.variables.getDeclaredTransient().has(bareName)) {
         throw new RenameError(`Cannot rename to ${JSON.stringify(newName)}: a variable with that name already exists.`).at(uri, symbol2.range);
       }
       const refs = symbol2.sigil === "%" ? findTransientReferences(symbol2.name, workspace, true) : findVariableReferences(symbol2.name, workspace, true);
       for (const ref2 of refs) {
-        const start = ref2.range.start.character + 1;
-        addEdit(ref2.uri, {
-          start: { line: ref2.range.start.line, character: start },
-          end: { line: ref2.range.start.line, character: start + symbol2.name.length }
-        }, bareName);
+        const doc = workspace.markup.get(ref2.uri);
+        const passage = doc.passageAt(ref2.range.start);
+        const start = passage.contentOffset(positionToOffset(ref2.range.start, doc.lineStarts));
+        const end = passage.contentOffset(positionToOffset(ref2.range.end, doc.lineStarts));
+        const view = sourceView(passage, start, end);
+        const index = viewIndex(view, start);
+        let base;
+        lexJs(view.text.slice(index, viewIndex(view, end)), {
+          variable(sigil, name, at3, _nesting, nameEnd) {
+            if (at3 === 0 && sigil === symbol2.sigil && name === symbol2.name) {
+              base = [pieceOffset(view, index + 1), pieceOffset(view, index + nameEnd)];
+            }
+          }
+        });
+        if (!base) throw new RenameError("Cannot locate the variable name safely.").at(ref2.uri, ref2.range);
+        addEdit(ref2.uri, passage.range(...base), bareName);
       }
       break;
     }
@@ -71204,6 +71225,8 @@ var init_rename = __esm({
     "use strict";
     import_vscode_languageserver2 = __toESM(require_api3(), 1);
     init_tooling();
+    init_source_view();
+    init_text();
     init_link_runtime();
     init_passage_refs();
     init_js_string_literal();
@@ -71358,7 +71381,8 @@ var init_code_lens = __esm({
             range: toLspRange5(l.range),
             command: {
               title: l.command.title,
-              command: "spindle.findReferences"
+              // Informational counts: no editor-specific navigation command is registered.
+              command: ""
             }
           }));
         });
@@ -71387,13 +71411,15 @@ function addWidgetParamHints(passages, inRange, workspace, hints) {
       const widget = workspace.widgets.getWidget(token.name);
       if (!widget || widget.params.length === 0) continue;
       const args2 = splitArgs(token.rawArgs);
+      const view = textAt(passage, token.start, token.end) ?? { offset: 0 };
+      const argsStart = viewIndex(view, token.argsStart);
       let from = 0;
       for (let i2 = 0; i2 < Math.min(args2.length, widget.params.length); i2++) {
         const at3 = token.rawArgs.indexOf(args2[i2], from);
         if (at3 === -1) break;
         from = at3 + args2[i2].length;
         hints.push({
-          position: passage.position(token.argsStart + at3),
+          position: passage.position(pieceOffset(view, argsStart + at3)),
           label: `${widget.params[i2]}:`,
           kind: "parameter"
         });
@@ -71416,6 +71442,7 @@ var init_inlay_hints = __esm({
   "src/plugins/inlay-hints.ts"() {
     "use strict";
     init_tooling();
+    init_source_view();
     init_tokens();
     inlayHintsPlugin = {
       id: "inlay-hints",
@@ -71580,9 +71607,9 @@ var init_semantic_tokens = __esm({
 });
 
 // src/plugins/code-actions.ts
-import { readFileSync as readFileSync9 } from "node:fs";
+import { readFileSync as readFileSync7 } from "node:fs";
 import { basename, dirname as dirname3, join as join4 } from "node:path";
-import { fileURLToPath as fileURLToPath2, pathToFileURL as pathToFileURL5 } from "node:url";
+import { fileURLToPath as fileURLToPath3, pathToFileURL as pathToFileURL5 } from "node:url";
 function computeCodeActions(uri, diagnostics, workspace, options = {}) {
   const actions = [];
   for (const diag of diagnostics) {
@@ -71654,7 +71681,7 @@ function addMacroToConfig(uri, macroName, workspace, options) {
   let text2 = workspace.documents.getText(configUri);
   if (text2 === void 0) {
     try {
-      text2 = readFileSync9(existingPath, "utf-8");
+      text2 = readFileSync7(existingPath, "utf-8");
     } catch {
       return null;
     }
@@ -71665,10 +71692,10 @@ function addMacroToConfig(uri, macroName, workspace, options) {
 }
 function resolveConfigRoot(uri, workspaceRoot) {
   if (workspaceRoot) {
-    return workspaceRoot.startsWith("file:") ? fileURLToPath2(workspaceRoot) : workspaceRoot;
+    return workspaceRoot.startsWith("file:") ? fileURLToPath3(workspaceRoot) : workspaceRoot;
   }
   if (!uri.startsWith("file:")) return null;
-  const docDir = dirname3(fileURLToPath2(uri));
+  const docDir = dirname3(fileURLToPath3(uri));
   let search = docDir;
   for (let i2 = 0; i2 < 10; i2++) {
     if (findConfigFile(search)) return search;
@@ -71785,18 +71812,6 @@ function lineEndingFor(workspace, uri) {
   }
   return "\n";
 }
-function declarationInsertEdit(text2, headerLine, declaration, eol) {
-  const lines = text2.split("\n");
-  let contentEnd = lines.length;
-  for (let i2 = headerLine + 1; i2 < lines.length; i2++) {
-    if (/^\uFEFF?::\s+/.test(lines[i2])) {
-      contentEnd = i2;
-      break;
-    }
-  }
-  if (contentEnd === lines.length && text2.endsWith("\n")) contentEnd = lines.length;
-  return insertLinesAt(text2, contentEnd, declaration, eol);
-}
 function declareVariable(diag, workspace, sigil) {
   if (diag.data?.kind !== "undeclared-variable" || diag.data.sigil !== sigil) return [];
   const { name } = diag.data;
@@ -71804,7 +71819,10 @@ function declareVariable(diag, workspace, sigil) {
   if (!passage) return [];
   const text2 = workspace.documents.getText(passage.uri);
   if (text2 === void 0) return [];
-  const edit = declarationInsertEdit(text2, passage.headerEnd.end.line, `${sigil}${name} = 0
+  const markup = workspace.markup.get(passage.uri)?.passages.find((p) => p.passage === passage);
+  if (!markup) return [];
+  const boundary = markup.bodyEnd === text2.length ? text2.split("\n").length : markup.position(markup.content.length).line;
+  const edit = insertLinesAt(text2, boundary, `${sigil}${name} = 0
 `, lineEndingFor(workspace, passage.uri));
   return [{
     title: `Declare '${sigil}${name}' in ${sigil === "$" ? "StoryVariables" : "StoryTransients"}`,
@@ -72298,12 +72316,12 @@ var server_exports2 = {};
 __export(server_exports2, {
   startServer: () => startServer
 });
-import { fileURLToPath as fileURLToPath3, pathToFileURL as pathToFileURL6 } from "node:url";
-import { readFileSync as readFileSync10 } from "node:fs";
+import { fileURLToPath as fileURLToPath4, pathToFileURL as pathToFileURL6 } from "node:url";
+import { readFileSync as readFileSync8 } from "node:fs";
 import { basename as basename2 } from "node:path";
 function uriToFsPath(uri) {
   try {
-    return fileURLToPath3(uri);
+    return fileURLToPath4(uri);
   } catch {
     return uri;
   }
@@ -72437,7 +72455,7 @@ function startServer(args2) {
     if (workspace) {
       try {
         const fsPath = uriToFsPath(textDocument.uri);
-        const text2 = readFileSync10(fsPath, "utf-8");
+        const text2 = readFileSync8(fsPath, "utf-8");
         workspace.documents.update(textDocument.uri, text2);
       } catch {
         workspace.documents.close(textDocument.uri);
@@ -72473,7 +72491,7 @@ function startServer(args2) {
       } else {
         try {
           const fsPath = uriToFsPath(change.uri);
-          const text2 = readFileSync10(fsPath, "utf-8");
+          const text2 = readFileSync8(fsPath, "utf-8");
           if (workspace.documents.has(change.uri)) {
             workspace.documents.update(change.uri, text2);
           } else {
@@ -72509,7 +72527,7 @@ async function scanWorkspaceFiles(root) {
     ];
     for (const filePath of files) {
       try {
-        const text2 = readFileSync10(filePath, "utf-8");
+        const text2 = readFileSync8(filePath, "utf-8");
         const uri = fsPathToUri(filePath);
         contents.set(uri, text2);
       } catch {
@@ -72539,7 +72557,7 @@ var init_server4 = __esm({
 
 // src/bin.ts
 var args = process.argv.slice(2);
-var VERSION = "0.14.1";
+var VERSION = "0.14.3";
 var HELP = `spindle-lsp v${VERSION}
 Language Server Protocol server for Spindle story format