@invinite-org/chartlang-language-service 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,70 @@
 # @invinite-org/chartlang-language-service
 
+## 1.2.0
+
+### Minor Changes
+
+- 2123181: Language service understands indicator-composition hovers, output-name
+  - override-key completions, and surfaces the new `dep-*` diagnostics
+    inline. Hover on `<binding>.output(...)` lists the producer's titled
+    outputs; hover on `<binding>.withInputs({...})` lists the producer's
+    input schema with kinds + defaults. Completion fires for output titles
+    inside `<binding>.output("|")` and for override keys inside
+    `<binding>.withInputs({ |})`. Best-effort go-to-definition for
+    `.output("title")` navigates to the producer's matching `plot(value,
+{ title })` call when the producer is a same-file `defineIndicator`;
+    cross-file and unresolvable cases fall back to `null`. Editor: no
+    public API change — new behaviour flows through the existing
+    `completionExtension` / `hoverExtension` / `linterExtension` wiring.
+- 2123181: Indicator composition (Phase 7 closeout): one chartlang indicator can
+  read another indicator's titled plot output as a typed `Series<number>`.
+
+  - Compose via local `const` binding plus `<binding>.output("title")` —
+    no new public API beyond the chainable `.output` / `.withInputs`
+    accessors on `CompiledScriptObject`.
+  - A single `.chart.ts` MAY declare a default export plus any number of
+    named exports plus any number of private `const` deps. Export form
+    determines render policy: drawn exports render with the
+    `export:<exportName>/` slot-id prefix; private `const` deps are data
+    feeds only and their visuals are dropped.
+  - Cross-file `import baseTrend from "./base-trend.chart"` resolves
+    recursively; shared producers inline exactly once per consumer.
+  - Additive within `apiVersion: 1.x`. The 172-entry
+    `STATEFUL_PRIMITIVES` set is unchanged. `DiagnosticCode` widens to 32
+    with the new `dep-*` codes (`dep-error`, `dep-cycle`,
+    `dep-unknown-output`, `dep-invalid-input-override`, `dep-dynamic`,
+    `dep-output-not-titled`).
+  - Five conformance scenarios in `@invinite-org/chartlang-conformance`
+    pin the runtime contract end-to-end (`dep-private-single-file`,
+    `dep-multi-export`, `dep-cross-file`, `dep-diamond`,
+    `dep-error-halts-parent`). `Scenario.additionalSources` lets
+    cross-file scenarios ship producer + consumer side-by-side.
+  - Two new example scripts in `examples/scripts/`:
+    `base-trend.chart.ts` (producer) + `trend-confirmation.chart.ts`
+    (multi-export consumer). React-demo gains a fifth catalogue entry
+    exercising the feature end-to-end in the browser.
+  - Docs: `docs/language/indicator-composition.md` narrative guide,
+    `docs/spec/manifest.md` + `docs/spec/semantics.md` +
+    `docs/spec/versioning.md` updates, five new glossary entries.
+
+### Patch Changes
+
+- Updated dependencies [d6d1a1f]
+- Updated dependencies [f0c8eb8]
+- Updated dependencies [f0c8eb8]
+- Updated dependencies [2123181]
+- Updated dependencies [2123181]
+- Updated dependencies [2123181]
+- Updated dependencies [2123181]
+- Updated dependencies [2123181]
+- Updated dependencies [4d77f4d]
+- Updated dependencies [4d77f4d]
+- Updated dependencies [3b4952d]
+- Updated dependencies [0427459]
+  - @invinite-org/chartlang-core@1.1.0
+  - @invinite-org/chartlang-compiler@1.1.0
+  - @invinite-org/chartlang-adapter-kit@1.2.0
+
 ## 1.1.0
 
 ### Minor Changes

package/README.md

@@ -24,6 +24,13 @@ pnpm add @invinite-org/chartlang-language-service
 | `getAvailableIntervals()` | Reads intervals from target capabilities. |
 | `HOVER_REGISTRY` | Checked-in generated hover-doc table. |
 
+Dep-aware surfaces (Phase 0.7 indicator composition):
+hovers + completions for `<binding>.output(...)` and
+`<binding>.withInputs({...})` resolve same-file producer titles and
+input schemas. The new `dep-*` compile diagnostics surface inline via
+`compileToDiagnostics`. Go-to-definition on `.output("title")` jumps
+to the producer's matching `plot(value, { title })` call.
+
 ## Minimum-viable API call
 
 ```ts

package/dist/_lib/collectCompletions.d.ts

@@ -9,5 +9,5 @@ import type { CompletionItem } from "../types.js";
  *     const items = collectCompletions("const length = 20;", 5, {});
  *     void items;
  */
-export declare function collectCompletions(source: string, _offset: number, registry: Readonly<Record<string, HoverRegistryEntry>>): ReadonlyArray<CompletionItem>;
+export declare function collectCompletions(source: string, offset: number, registry: Readonly<Record<string, HoverRegistryEntry>>): ReadonlyArray<CompletionItem>;
 //# sourceMappingURL=collectCompletions.d.ts.map

package/dist/_lib/collectCompletions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collectCompletions.d.ts","sourceRoot":"","sources":["../../src/_lib/collectCompletions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,GACvD,aAAa,CAAC,cAAc,CAAC,CAa/B"}
+{"version":3,"file":"collectCompletions.d.ts","sourceRoot":"","sources":["../../src/_lib/collectCompletions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMlD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,GACvD,aAAa,CAAC,cAAc,CAAC,CAsC/B"}

package/dist/_lib/collectCompletions.js

@@ -1,6 +1,9 @@
 // Copyright (c) 2026 Invinite. Licensed under the MIT License.
 // See the LICENSE file in the repo root for full license text.
 import ts from "typescript";
+import { isInsideOutputStringLiteral } from "./isInsideOutputStringLiteral.js";
+import { isInsideWithInputsKey } from "./isInsideWithInputsKey.js";
+import { resolveDepInputsFor, resolveDepOutputsFor } from "./resolveDepAccessor.js";
 import { toHoverDoc } from "./toHoverDoc.js";
 /**
  * Collect registry and source-local completion items for an offset.
@@ -11,7 +14,23 @@ import { toHoverDoc } from "./toHoverDoc.js";
  *     const items = collectCompletions("const length = 20;", 5, {});
  *     void items;
  */
-export function collectCompletions(source, _offset, registry) {
+export function collectCompletions(source, offset, registry) {
+    if (isInsideOutputStringLiteral(source, offset)) {
+        return Object.freeze(resolveDepOutputsFor(source, offset).map((title) => Object.freeze({
+            label: title,
+            kind: "property",
+            insertText: title,
+            detail: "Series<number> output",
+        })));
+    }
+    if (isInsideWithInputsKey(source, offset)) {
+        return Object.freeze(resolveDepInputsFor(source, offset).map((entry) => Object.freeze({
+            label: entry.name,
+            kind: "property",
+            insertText: entry.name,
+            detail: `${entry.kind} (default: ${entry.defaultText})`,
+        })));
+    }
     const registryItems = Object.values(registry).map(registryCompletion);
     const localItems = collectLocalIdentifiers(source).map((label) => Object.freeze({
         label,

package/dist/_lib/collectCompletions.js.map

@@ -1 +1 @@
-{"version":3,"file":"collectCompletions.js","sourceRoot":"","sources":["../../src/_lib/collectCompletions.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,MAAM,YAAY,CAAC;AAI5B,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAC9B,MAAc,EACd,OAAe,EACf,QAAsD;IAEtD,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACtE,MAAM,UAAU,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC7D,MAAM,CAAC,MAAM,CAAC;QACV,KAAK;QACL,IAAI,EAAE,UAAmB;QACzB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,kBAAkB;KAC7B,CAAC,CACL,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAClD,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,aAAa,EAAE,GAAG,UAAU,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACpF,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC/F,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAyB;IACjD,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,KAAK,EAAE,KAAK,CAAC,GAAG;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI;QACrD,UAAU,EAAE,KAAK,CAAC,GAAG;QACrB,MAAM,EAAE,KAAK,CAAC,KAAK;QACnB,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC;KACzB,CAAC,CAAC;AACP,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAc;IAC3C,MAAM,UAAU,GAAG,EAAE,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChG,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,KAAK,GAAG,CAAC,IAAa,EAAQ,EAAE;QAClC,IAAI,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5F,IAAI,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzF,IAAI,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClF,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC,CAAC;IACF,KAAK,CAAC,UAAU,CAAC,CAAC;IAClB,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"collectCompletions.js","sourceRoot":"","sources":["../../src/_lib/collectCompletions.ts"],"names":[],"mappings":"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"}

package/dist/_lib/isInsideOutputStringLiteral.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Return `true` when an offset lands inside the string-literal argument
+ * of a `<binding>.output("...")` call. The binding name itself is not
+ * validated here — the resolver inspects bindings when collecting
+ * completions or hovers.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     const inside = isInsideOutputStringLiteral('baseTrend.output("line")', 19);
+ *     void inside;
+ */
+export declare function isInsideOutputStringLiteral(source: string, offset: number): boolean;
+//# sourceMappingURL=isInsideOutputStringLiteral.d.ts.map

package/dist/_lib/isInsideOutputStringLiteral.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isInsideOutputStringLiteral.d.ts","sourceRoot":"","sources":["../../src/_lib/isInsideOutputStringLiteral.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAkBnF"}

package/dist/_lib/isInsideOutputStringLiteral.js

@@ -0,0 +1,44 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import ts from "typescript";
+/**
+ * Return `true` when an offset lands inside the string-literal argument
+ * of a `<binding>.output("...")` call. The binding name itself is not
+ * validated here — the resolver inspects bindings when collecting
+ * completions or hovers.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     const inside = isInsideOutputStringLiteral('baseTrend.output("line")', 19);
+ *     void inside;
+ */
+export function isInsideOutputStringLiteral(source, offset) {
+    const sourceFile = ts.createSourceFile("script.chart.ts", source, ts.ScriptTarget.Latest, true);
+    let matched = false;
+    const visit = (node) => {
+        if (matched)
+            return;
+        if (ts.isStringLiteral(node) &&
+            offset > node.getStart(sourceFile) &&
+            offset < node.getEnd()) {
+            matched = isOutputCallArgument(node);
+            return;
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sourceFile);
+    return matched;
+}
+function isOutputCallArgument(node) {
+    const parent = node.parent;
+    if (!ts.isCallExpression(parent))
+        return false;
+    if (parent.arguments[0] !== node)
+        return false;
+    const callee = parent.expression;
+    if (!ts.isPropertyAccessExpression(callee))
+        return false;
+    return callee.name.text === "output";
+}
+//# sourceMappingURL=isInsideOutputStringLiteral.js.map

package/dist/_lib/isInsideOutputStringLiteral.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isInsideOutputStringLiteral.js","sourceRoot":"","sources":["../../src/_lib/isInsideOutputStringLiteral.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAc,EAAE,MAAc;IACtE,MAAM,UAAU,GAAG,EAAE,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChG,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,MAAM,KAAK,GAAG,CAAC,IAAa,EAAQ,EAAE;QAClC,IAAI,OAAO;YAAE,OAAO;QACpB,IACI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC;YACxB,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;YAClC,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,EACxB,CAAC;YACC,OAAO,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;YACrC,OAAO;QACX,CAAC;QACD,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC,CAAC;IACF,KAAK,CAAC,UAAU,CAAC,CAAC;IAClB,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAsB;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/C,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC;IACjC,IAAI,CAAC,EAAE,CAAC,0BAA0B,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACzD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;AACzC,CAAC"}

package/dist/_lib/isInsideWithInputsKey.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Return `true` when an offset lands at a **key** position inside the
+ * object-literal argument of a `<binding>.withInputs({ ... })` call.
+ * Value-position offsets return `false` so completions don't fire when
+ * the user is filling in an override's value.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     const source = 'baseTrend.withInputs({ length: 20 })';
+ *     const atKey = isInsideWithInputsKey(source, source.indexOf("length"));
+ *     void atKey;
+ */
+export declare function isInsideWithInputsKey(source: string, offset: number): boolean;
+//# sourceMappingURL=isInsideWithInputsKey.d.ts.map

package/dist/_lib/isInsideWithInputsKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isInsideWithInputsKey.d.ts","sourceRoot":"","sources":["../../src/_lib/isInsideWithInputsKey.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAK7E"}

package/dist/_lib/isInsideWithInputsKey.js

@@ -0,0 +1,64 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import ts from "typescript";
+/**
+ * Return `true` when an offset lands at a **key** position inside the
+ * object-literal argument of a `<binding>.withInputs({ ... })` call.
+ * Value-position offsets return `false` so completions don't fire when
+ * the user is filling in an override's value.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     const source = 'baseTrend.withInputs({ length: 20 })';
+ *     const atKey = isInsideWithInputsKey(source, source.indexOf("length"));
+ *     void atKey;
+ */
+export function isInsideWithInputsKey(source, offset) {
+    const sourceFile = ts.createSourceFile("script.chart.ts", source, ts.ScriptTarget.Latest, true);
+    const objectLiteral = findEnclosingWithInputsObjectLiteral(sourceFile, offset);
+    if (objectLiteral === null)
+        return false;
+    return !isInsideAnyPropertyValueRange(objectLiteral, sourceFile, offset);
+}
+function findEnclosingWithInputsObjectLiteral(sourceFile, offset) {
+    let match = null;
+    const visit = (node) => {
+        if (match !== null)
+            return;
+        if (ts.isObjectLiteralExpression(node) &&
+            offset > node.getStart(sourceFile) &&
+            offset < node.getEnd() &&
+            isWithInputsArgument(node)) {
+            match = node;
+            return;
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sourceFile);
+    return match;
+}
+function isWithInputsArgument(node) {
+    const parent = node.parent;
+    if (!ts.isCallExpression(parent))
+        return false;
+    if (parent.arguments[0] !== node)
+        return false;
+    const callee = parent.expression;
+    if (!ts.isPropertyAccessExpression(callee))
+        return false;
+    return callee.name.text === "withInputs";
+}
+function isInsideAnyPropertyValueRange(objectLiteral, sourceFile, offset) {
+    for (const property of objectLiteral.properties) {
+        if (!ts.isPropertyAssignment(property))
+            continue;
+        const initializer = property.initializer;
+        const start = initializer.getStart(sourceFile);
+        const end = initializer.getEnd();
+        if (offset >= start && offset <= end)
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=isInsideWithInputsKey.js.map

package/dist/_lib/isInsideWithInputsKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isInsideWithInputsKey.js","sourceRoot":"","sources":["../../src/_lib/isInsideWithInputsKey.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAc,EAAE,MAAc;IAChE,MAAM,UAAU,GAAG,EAAE,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChG,MAAM,aAAa,GAAG,oCAAoC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC/E,IAAI,aAAa,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACzC,OAAO,CAAC,6BAA6B,CAAC,aAAa,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,oCAAoC,CACzC,UAAyB,EACzB,MAAc;IAEd,IAAI,KAAK,GAAsC,IAAI,CAAC;IAEpD,MAAM,KAAK,GAAG,CAAC,IAAa,EAAQ,EAAE;QAClC,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO;QAC3B,IACI,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC;YAClC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;YAClC,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE;YACtB,oBAAoB,CAAC,IAAI,CAAC,EAC5B,CAAC;YACC,KAAK,GAAG,IAAI,CAAC;YACb,OAAO;QACX,CAAC;QACD,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC,CAAC;IACF,KAAK,CAAC,UAAU,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAgC;IAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/C,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC;IACjC,IAAI,CAAC,EAAE,CAAC,0BAA0B,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACzD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC;AAC7C,CAAC;AAED,SAAS,6BAA6B,CAClC,aAAyC,EACzC,UAAyB,EACzB,MAAc;IAEd,KAAK,MAAM,QAAQ,IAAI,aAAa,CAAC,UAAU,EAAE,CAAC;QAC9C,IAAI,CAAC,EAAE,CAAC,oBAAoB,CAAC,QAAQ,CAAC;YAAE,SAAS;QACjD,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC;QACzC,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC;QACjC,IAAI,MAAM,IAAI,KAAK,IAAI,MAAM,IAAI,GAAG;YAAE,OAAO,IAAI,CAAC;IACtD,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/_lib/resolveDepAccessor.d.ts

@@ -0,0 +1,77 @@
+import type { DefinitionLocation, HoverDoc } from "../types.js";
+/**
+ * Producer-side input descriptor surfaced by the dep accessor helpers.
+ * `kind` is the `input.<kind>(default)` builder name; `defaultText` is
+ * the literal default-value text printed verbatim into the completion
+ * detail line.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     const d: DepInputDescriptor = {
+ *         name: "length",
+ *         kind: "int",
+ *         defaultText: "20",
+ *     };
+ *     void d;
+ */
+export type DepInputDescriptor = Readonly<{
+    name: string;
+    kind: string;
+    defaultText: string;
+}>;
+/**
+ * Resolve a hover doc when the offset lands on a `<binding>.output(...)`
+ * or `<binding>.withInputs({...})` call site whose binding's initialiser
+ * is a same-file `defineIndicator(...)` (optionally chained through
+ * `.withInputs(...)`).
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     const fn: typeof resolveDepAccessorHover = resolveDepAccessorHover;
+ *     void fn;
+ */
+export declare function resolveDepAccessorHover(source: string, offset: number): HoverDoc | null;
+/**
+ * Resolve a best-effort go-to-definition target for a
+ * `<binding>.output("title")` call. Returns the line / column of the
+ * producer's matching `plot(value, { title: "<title>" })` call when
+ * resolvable. Returns `null` when the binding is missing, the producer
+ * is not a same-file `defineIndicator`, or no matching `plot` call is
+ * found.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     const fn: typeof resolveDepAccessorDefinition = resolveDepAccessorDefinition;
+ *     void fn;
+ */
+export declare function resolveDepAccessorDefinition(source: string, offset: number): DefinitionLocation | null;
+/**
+ * Collect every producer-side titled output reachable from the binding
+ * at the offset's `<binding>.output("|")` call site. Returns `[]` when
+ * the binding is missing or the producer is not a same-file
+ * `defineIndicator(...)`.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     const titles = resolveDepOutputsFor("baseTrend.output(\"\")", 18);
+ *     void titles;
+ */
+export declare function resolveDepOutputsFor(source: string, offset: number): ReadonlyArray<string>;
+/**
+ * Collect every producer-side input descriptor reachable from the
+ * binding at the offset's `<binding>.withInputs({ |})` call site.
+ * Returns `[]` when the binding is missing or the producer is not a
+ * same-file `defineIndicator(...)`.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     const inputs = resolveDepInputsFor("baseTrend.withInputs({ })", 22);
+ *     void inputs;
+ */
+export declare function resolveDepInputsFor(source: string, offset: number): ReadonlyArray<DepInputDescriptor>;
+//# sourceMappingURL=resolveDepAccessor.d.ts.map

package/dist/_lib/resolveDepAccessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveDepAccessor.d.ts","sourceRoot":"","sources":["../../src/_lib/resolveDepAccessor.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGhE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC,CAAC;AAIH;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAQvF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,CACxC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACf,kBAAkB,GAAG,IAAI,CAqB3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAO1F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACf,aAAa,CAAC,kBAAkB,CAAC,CAOnC"}