@invinite-org/chartlang-language-service 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,182 @@
+# @invinite-org/chartlang-language-service
+
+## 1.1.0
+
+### Minor Changes
+
+- 4d44a9c: Add a `ChartlangLanguageService` interface (exported from `@invinite-org/chartlang-language-service` and re-exported from `@invinite-org/chartlang-editor`) and let `createChartlangEditor({ service })` (and the React `<ChartlangEditor service={...}>` prop) inject a consumer-provided implementation. When a service is injected, `setCapabilities(...)` becomes a no-op because the injected service owns its own capability surface. Editor extension type signatures now reference the named interface instead of `ReturnType<typeof createLanguageService>`, so consumers can build the surface from scratch (e.g. a hybrid local hover / remote `compileToDiagnostics`) without abandoning the editor factory.
+
+### Patch Changes
+
+- 4d44a9c: Surface TypeScript semantic type errors from `compile()` and `createLanguageService().compileToDiagnostics()`.
+
+  The compiler was creating a `ts.Program` for symbol resolution but never requesting `program.getSemanticDiagnostics(sourceFile)`, so scripts like `const x: number = "oops"` slipped past the gate and reached the runtime. The pipeline now wires the program's semantic diagnostics into `transformAndAnalyse`, filtered to the user's source file and mapped to a new stable `type-error` diagnostic code (with the original `TS<code>` prefix preserved in the message so editor tooling can route to TypeScript documentation).
+
+  Companion fix: the in-memory `@invinite-org/chartlang-core` ambient shim in `packages/compiler/src/program.ts` was significantly out of lockstep with the real core surface. The shim now ships the full 61-method `DrawNamespace`, every missing `TaNamespace` method (`adx`, `dmi`, `trix`, `ichimoku`, `tsi`, `smi`, `pmo`, `stochRsi`, `ultimateOsc`, `coppock`, `vortex`, `trendStrengthIndex`, `ulcerIndex`, `adr`, `median`), and `ScalarOrSeries`-widened `ta.*` source parameters that match the runtime's `readSourceValue` contract.
+
+- d1de692: Fix end-user-blocking Node-ESM packaging bug. Every published `dist/index.js` previously failed to load under Node's strict ESM resolver because `tsc` had been configured with `moduleResolution: "Bundler"` and emitted relative specifiers verbatim, so `dist/index.js` carried `from "./api"` (extensionless) and Node rejected the resolution. Workspace consumers never saw this because tsx / vitest / Vite resolve loosely, but `npm install @invinite-org/chartlang-compiler` followed by `import` failed immediately for any Node consumer, and `examples/react-demo/vite.config.ts`'s server-side compile plugin broke at dev-config-load time.
+
+  This release switches `tsconfig.base.json` to `module: "NodeNext"` / `moduleResolution: "NodeNext"`, and rewrites every relative import / export / dynamic-import / `typeof import("…")` specifier across all packages' source to carry an explicit `.js` (or `/index.js`) suffix. The new resolution mode also surfaces this bug class as a compile error rather than runtime breakage, so it cannot regress.
+
+  No behavioural change for runtime consumers — the rewritten specifiers resolve to the same TypeScript sources at build time and the same `dist/<path>.js` files at consumer-load time.
+
+- Updated dependencies [4d44a9c]
+- Updated dependencies [4d44a9c]
+- Updated dependencies [d1de692]
+- Updated dependencies [d1de692]
+- Updated dependencies [98599b2]
+  - @invinite-org/chartlang-adapter-kit@1.1.0
+  - @invinite-org/chartlang-compiler@1.0.1
+  - @invinite-org/chartlang-core@1.0.1
+
+## 1.0.0
+
+### Major Changes
+
+- chartlang `1.0.0` -- the `apiVersion: 1` standard.
+
+  - `apiVersion: 1` frozen: compiler accepts only the frozen language
+    version; `STATEFUL_PRIMITIVES` locked at 172 entries by exact
+    name-set; every shipping export `@stable`; pre-1.0 deprecations
+    removed (`PHASE_1_SCENARIOS`).
+  - Canonical language spec published (`docs/spec/`): grammar,
+    semantics, manifest, emissions, versioning -- self-contained for
+    alternate implementations. The `v1.0.0` tag is the frozen spec
+    snapshot.
+  - Public conformance reports: `pnpm conformance --report` emits
+    `CONFORMANCE.md` + `conformance-report.json`; canvas2d reference
+    report published and drift-gated.
+  - Adapter-author path proven end-to-end: scaffolded adapters ship a
+    wired conformance test; full writing-an-adapter tutorial +
+    Lightweight Charts porting walkthrough.
+  - Pine migration guide finalised with a pattern-coverage matrix
+    audited against the top ~50 Pine scripts.
+
+### Minor Changes
+
+- d14a034: Add phase 5 server alerts, multi-timeframe request handling, runtime persistence, QuickJS hosting, expanded plot and table rendering, color helpers, alert conditions, and volume profile primitives.
+
+### Patch Changes
+
+- Pre-1.0 surface cleanup: remove the deprecated `PHASE_1_SCENARIOS`
+  alias (use `ALL_SCENARIOS`) and promote every shipping export from
+  `@experimental` to `@stable` ahead of the `apiVersion: 1` freeze.
+- Updated dependencies [d14a034]
+- Updated dependencies [3cfff10]
+- Updated dependencies [3cfff10]
+- Updated dependencies [3cfff10]
+- Updated dependencies [3cfff10]
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+  - @invinite-org/chartlang-adapter-kit@1.0.0
+  - @invinite-org/chartlang-compiler@1.0.0
+  - @invinite-org/chartlang-core@1.0.0
+
+## 0.5.0
+
+### Phase 5
+
+#### Patch Changes
+
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+  - @invinite-org/chartlang-core@0.5.0
+  - @invinite-org/chartlang-compiler@0.5.0
+  - @invinite-org/chartlang-adapter-kit@0.5.0
+
+## 0.4.0
+
+### Minor Changes
+
+- Phase 4 - Editor + Inputs + Timeframes + Tier-1 Pine parity.
+  Adds: input._ builders, state._ / state.tick.\* slots,
+  barstate / syminfo / timeframe views, request.security typed
+  surface (NaN fallback), defineIndicator overrides,
+  Capabilities triad (intervals / multiTimeframe / subPanes /
+  symInfoFields / maxDrawingsPerScript / alertConditions / logs),
+  language-service hover registry + LSP-style API, CodeMirror 6
+  editor shell + /react sub-export, Inputs UI ViewModel + React
+  form. See tasks/phase-4-editor-tier1/README.md.
+- Ship the Phase 4 headless language service with generated hover registry,
+  diagnostics, hovers, completions, signature help, definitions, and interval
+  capability helpers.
+
+### Patch Changes
+
+- Updated dependencies [3f3ce38]
+- Updated dependencies [3f3ce38]
+- Updated dependencies [3f3ce38]
+- Updated dependencies [3f3ce38]
+- Updated dependencies [3f3ce38]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+  - @invinite-org/chartlang-adapter-kit@0.4.0
+  - @invinite-org/chartlang-compiler@0.4.0
+  - @invinite-org/chartlang-core@0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Invinite
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,45 @@
+# @invinite-org/chartlang-language-service
+
+`experimental`
+
+Headless editor intelligence for chartlang: diagnostics, completions, hover
+docs, signature help, definitions, and interval-aware suggestions.
+
+## Install
+
+```bash
+pnpm add @invinite-org/chartlang-language-service
+```
+
+## Public surface
+
+| Export | Purpose |
+|---|---|
+| `createLanguageService(opts?)` | Builds a capability-aware service instance. |
+| `compileToDiagnostics(source, opts)` | Converts compiler diagnostics to LSP-style ranges. |
+| `getCompletions(document, position)` | Returns core symbols and interval completions. |
+| `getHoverDoc(document, position)` | Looks up generated hover docs from core JSDoc. |
+| `getSignatureHelp(document, position)` | Returns call signatures for known symbols. |
+| `getDefinition(document, position)` | Resolves generated source-location metadata. |
+| `getAvailableIntervals()` | Reads intervals from target capabilities. |
+| `HOVER_REGISTRY` | Checked-in generated hover-doc table. |
+
+## Minimum-viable API call
+
+```ts
+import { createLanguageService } from "@invinite-org/chartlang-language-service";
+
+const service = createLanguageService({ targetCapabilities: capabilities });
+const diagnostics = service.compileToDiagnostics(source, {
+    apiVersion: 1,
+    sourcePath: "demo.chart.ts",
+});
+```
+
+## Docs
+
+See [`docs/reference/`](../../docs/reference/).
+
+## License
+
+MIT

package/dist/_lib/collectCompletions.d.ts

@@ -0,0 +1,13 @@
+import type { HoverRegistryEntry } from "../hoverRegistry.generated.js";
+import type { CompletionItem } from "../types.js";
+/**
+ * Collect registry and source-local completion items for an offset.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const items = collectCompletions("const length = 20;", 5, {});
+ *     void items;
+ */
+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

@@ -0,0 +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"}

package/dist/_lib/collectCompletions.js

@@ -0,0 +1,51 @@
+// 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 { toHoverDoc } from "./toHoverDoc.js";
+/**
+ * Collect registry and source-local completion items for an offset.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const items = collectCompletions("const length = 20;", 5, {});
+ *     void items;
+ */
+export function collectCompletions(source, _offset, registry) {
+    const registryItems = Object.values(registry).map(registryCompletion);
+    const localItems = collectLocalIdentifiers(source).map((label) => Object.freeze({
+        label,
+        kind: "property",
+        insertText: label,
+        detail: "local identifier",
+    }));
+    const byLabel = new Map();
+    for (const item of [...registryItems, ...localItems])
+        byLabel.set(item.label, item);
+    return Object.freeze([...byLabel.values()].sort((a, b) => a.label.localeCompare(b.label)));
+}
+function registryCompletion(entry) {
+    return Object.freeze({
+        label: entry.fqn,
+        kind: entry.kind === "type" ? "property" : entry.kind,
+        insertText: entry.fqn,
+        detail: entry.title,
+        doc: toHoverDoc(entry),
+    });
+}
+function collectLocalIdentifiers(source) {
+    const sourceFile = ts.createSourceFile("script.chart.ts", source, ts.ScriptTarget.Latest, true);
+    const names = new Set();
+    const visit = (node) => {
+        if (ts.isVariableDeclaration(node) && ts.isIdentifier(node.name))
+            names.add(node.name.text);
+        if (ts.isFunctionDeclaration(node) && node.name !== undefined)
+            names.add(node.name.text);
+        if (ts.isParameter(node) && ts.isIdentifier(node.name))
+            names.add(node.name.text);
+        ts.forEachChild(node, visit);
+    };
+    visit(sourceFile);
+    return Object.freeze([...names].sort());
+}
+//# sourceMappingURL=collectCompletions.js.map

package/dist/_lib/collectCompletions.js.map

@@ -0,0 +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"}

package/dist/_lib/isInsideIntervalLiteral.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Return true when an offset sits inside a completable interval string.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const inside = isInsideIntervalLiteral('request.security({ interval: "" })', 31);
+ *     void inside;
+ */
+export declare function isInsideIntervalLiteral(source: string, offset: number): boolean;
+//# sourceMappingURL=isInsideIntervalLiteral.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"isInsideIntervalLiteral.d.ts","sourceRoot":"","sources":["../../src/_lib/isInsideIntervalLiteral.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAkB/E"}

package/dist/_lib/isInsideIntervalLiteral.js

@@ -0,0 +1,58 @@
+// 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 sits inside a completable interval string.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const inside = isInsideIntervalLiteral('request.security({ interval: "" })', 31);
+ *     void inside;
+ */
+export function isInsideIntervalLiteral(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 = isIntervalLiteralNode(node, sourceFile);
+            return;
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sourceFile);
+    return matched;
+}
+function isIntervalLiteralNode(node, sourceFile) {
+    const parent = node.parent;
+    if (ts.isCallExpression(parent))
+        return callName(parent, sourceFile) === "input.interval";
+    if (!ts.isPropertyAssignment(parent))
+        return false;
+    if (!propertyNameIs(parent.name, "interval"))
+        return false;
+    const objectLiteral = parent.parent;
+    /* v8 ignore next -- PropertyAssignment nodes are owned by ObjectLiteralExpression. */
+    if (!ts.isObjectLiteralExpression(objectLiteral))
+        return false;
+    const call = objectLiteral.parent;
+    return ts.isCallExpression(call) && callName(call, sourceFile) === "request.security";
+}
+function propertyNameIs(name, expected) {
+    return (ts.isIdentifier(name) || ts.isStringLiteral(name)) && name.text === expected;
+}
+function callName(call, sourceFile) {
+    const expression = call.expression;
+    if (!ts.isPropertyAccessExpression(expression))
+        return null;
+    const left = expression.expression;
+    /* v8 ignore next -- covered defensively for malformed/incremental ASTs. */
+    if (!ts.isIdentifier(left))
+        return null;
+    return `${left.text}.${expression.name.getText(sourceFile)}`;
+}
+//# sourceMappingURL=isInsideIntervalLiteral.js.map

package/dist/_lib/isInsideIntervalLiteral.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isInsideIntervalLiteral.js","sourceRoot":"","sources":["../../src/_lib/isInsideIntervalLiteral.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAc,EAAE,MAAc;IAClE,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,qBAAqB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAClD,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,qBAAqB,CAAC,IAAsB,EAAE,UAAyB;IAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,IAAI,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC;QAAE,OAAO,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,gBAAgB,CAAC;IAC1F,IAAI,CAAC,EAAE,CAAC,oBAAoB,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAE3D,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IACpC,sFAAsF;IACtF,IAAI,CAAC,EAAE,CAAC,yBAAyB,CAAC,aAAa,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/D,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,kBAAkB,CAAC;AAC1F,CAAC;AAED,SAAS,cAAc,CAAC,IAAqB,EAAE,QAAgB;IAC3D,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;AACzF,CAAC;AAED,SAAS,QAAQ,CAAC,IAAuB,EAAE,UAAyB;IAChE,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IACnC,IAAI,CAAC,EAAE,CAAC,0BAA0B,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5D,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC;IACnC,2EAA2E;IAC3E,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;AACjE,CAAC"}

package/dist/_lib/mapDiagnostic.d.ts

@@ -0,0 +1,43 @@
+import type { CompileDiagnostic } from "@invinite-org/chartlang-compiler";
+import type { LspDiagnostic, LspSeverity } from "../types.js";
+/**
+ * Map a compiler diagnostic into the language-service diagnostic shape.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const diagnostic = mapDiagnostic({
+ *         severity: "error",
+ *         code: "unbounded-loop",
+ *         message: "while loops are not allowed",
+ *         file: "demo.chart.ts",
+ *         line: 1,
+ *         column: 1,
+ *     });
+ *     void diagnostic;
+ */
+export declare function mapDiagnostic(diagnostic: CompileDiagnostic): LspDiagnostic;
+/**
+ * Build a language-service diagnostic at a 1-based line/column position.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const diagnostic = makeDiagnostic({
+ *         line: 1,
+ *         column: 1,
+ *         severity: "hint",
+ *         code: "unsupported-interval",
+ *         message: "Unsupported interval",
+ *     });
+ *     void diagnostic;
+ */
+export declare function makeDiagnostic(args: {
+    readonly line: number;
+    readonly column: number;
+    readonly severity: LspSeverity;
+    readonly code: string;
+    readonly message: string;
+    readonly relatedCallsite?: string;
+}): LspDiagnostic;
+//# sourceMappingURL=mapDiagnostic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mapDiagnostic.d.ts","sourceRoot":"","sources":["../../src/_lib/mapDiagnostic.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,iBAAiB,GAAG,aAAa,CAW1E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACrC,GAAG,aAAa,CAehB"}

package/dist/_lib/mapDiagnostic.js

@@ -0,0 +1,60 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+/**
+ * Map a compiler diagnostic into the language-service diagnostic shape.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const diagnostic = mapDiagnostic({
+ *         severity: "error",
+ *         code: "unbounded-loop",
+ *         message: "while loops are not allowed",
+ *         file: "demo.chart.ts",
+ *         line: 1,
+ *         column: 1,
+ *     });
+ *     void diagnostic;
+ */
+export function mapDiagnostic(diagnostic) {
+    const related = diagnostic.nodeText === undefined ? {} : { relatedCallsite: diagnostic.nodeText };
+    return makeDiagnostic({
+        line: diagnostic.line,
+        column: diagnostic.column,
+        severity: diagnostic.severity,
+        code: diagnostic.code,
+        message: diagnostic.message,
+        ...related,
+    });
+}
+/**
+ * Build a language-service diagnostic at a 1-based line/column position.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const diagnostic = makeDiagnostic({
+ *         line: 1,
+ *         column: 1,
+ *         severity: "hint",
+ *         code: "unsupported-interval",
+ *         message: "Unsupported interval",
+ *     });
+ *     void diagnostic;
+ */
+export function makeDiagnostic(args) {
+    const related = args.relatedCallsite === undefined ? {} : { relatedCallsite: args.relatedCallsite };
+    return Object.freeze({
+        range: Object.freeze({
+            startLine: args.line,
+            startColumn: args.column,
+            endLine: args.line,
+            endColumn: args.column,
+        }),
+        severity: args.severity,
+        code: args.code,
+        message: args.message,
+        ...related,
+    });
+}
+//# sourceMappingURL=mapDiagnostic.js.map

package/dist/_lib/mapDiagnostic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapDiagnostic.js","sourceRoot":"","sources":["../../src/_lib/mapDiagnostic.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAM/D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa,CAAC,UAA6B;IACvD,MAAM,OAAO,GACT,UAAU,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC;IACtF,OAAO,cAAc,CAAC;QAClB,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,GAAG,OAAO;KACb,CAAC,CAAC;AACP,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,IAO9B;IACG,MAAM,OAAO,GACT,IAAI,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC;IACxF,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;YACjB,SAAS,EAAE,IAAI,CAAC,IAAI;YACpB,WAAW,EAAE,IAAI,CAAC,MAAM;YACxB,OAAO,EAAE,IAAI,CAAC,IAAI;YAClB,SAAS,EAAE,IAAI,CAAC,MAAM;SACzB,CAAC;QACF,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,GAAG,OAAO;KACb,CAAC,CAAC;AACP,CAAC"}

package/dist/_lib/resolveFqnAtOffset.d.ts

@@ -0,0 +1,23 @@
+import ts from "typescript";
+/**
+ * Resolve the chartlang primitive FQN under a source offset.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const fqn = resolveFqnAtOffset("ta.ema(bar.close, 20)", 4);
+ *     void fqn;
+ */
+export declare function resolveFqnAtOffset(source: string, offset: number): string | null;
+/**
+ * Find the smallest AST token containing an offset.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const sf = ts.createSourceFile("x.ts", "ta.ema()", ts.ScriptTarget.Latest, true);
+ *     const token = findTokenAtOffset(sf, 1);
+ *     void token;
+ */
+export declare function findTokenAtOffset(sourceFile: ts.SourceFile, offset: number): ts.Node | null;
+//# sourceMappingURL=resolveFqnAtOffset.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveFqnAtOffset.d.ts","sourceRoot":"","sources":["../../src/_lib/resolveFqnAtOffset.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOhF;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,EAAE,CAAC,IAAI,GAAG,IAAI,CAW3F"}

package/dist/_lib/resolveFqnAtOffset.js

@@ -0,0 +1,72 @@
+// 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";
+/**
+ * Resolve the chartlang primitive FQN under a source offset.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const fqn = resolveFqnAtOffset("ta.ema(bar.close, 20)", 4);
+ *     void fqn;
+ */
+export function resolveFqnAtOffset(source, offset) {
+    const sourceFile = ts.createSourceFile("script.chart.ts", source, ts.ScriptTarget.Latest, true);
+    const token = findTokenAtOffset(sourceFile, offset);
+    if (token === null || !ts.isIdentifier(token))
+        return null;
+    const access = enclosingPropertyAccess(token);
+    if (access !== null)
+        return propertyAccessToFqn(access);
+    return token.text;
+}
+/**
+ * Find the smallest AST token containing an offset.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const sf = ts.createSourceFile("x.ts", "ta.ema()", ts.ScriptTarget.Latest, true);
+ *     const token = findTokenAtOffset(sf, 1);
+ *     void token;
+ */
+export function findTokenAtOffset(sourceFile, offset) {
+    let best = null;
+    const visit = (node) => {
+        const start = node.getStart(sourceFile);
+        const end = node.getEnd();
+        if (offset < start || offset > end)
+            return;
+        best = node;
+        ts.forEachChild(node, visit);
+    };
+    visit(sourceFile);
+    return best;
+}
+function enclosingPropertyAccess(token) {
+    let current = token;
+    let candidate = null;
+    while (current.parent !== undefined) {
+        const parent = current.parent;
+        if (ts.isPropertyAccessExpression(parent)) {
+            candidate = parent;
+            current = parent;
+            continue;
+        }
+        break;
+    }
+    return candidate;
+}
+function propertyAccessToFqn(access) {
+    const parts = [];
+    let current = access;
+    while (ts.isPropertyAccessExpression(current)) {
+        parts.unshift(current.name.text);
+        current = current.expression;
+    }
+    if (!ts.isIdentifier(current))
+        return null;
+    parts.unshift(current.text);
+    return parts.join(".");
+}
+//# sourceMappingURL=resolveFqnAtOffset.js.map

package/dist/_lib/resolveFqnAtOffset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveFqnAtOffset.js","sourceRoot":"","sources":["../../src/_lib/resolveFqnAtOffset.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,MAAc;IAC7D,MAAM,UAAU,GAAG,EAAE,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChG,MAAM,KAAK,GAAG,iBAAiB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACpD,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3D,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACxD,OAAO,KAAK,CAAC,IAAI,CAAC;AACtB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAyB,EAAE,MAAc;IACvE,IAAI,IAAI,GAAmB,IAAI,CAAC;IAChC,MAAM,KAAK,GAAG,CAAC,IAAa,EAAQ,EAAE;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC1B,IAAI,MAAM,GAAG,KAAK,IAAI,MAAM,GAAG,GAAG;YAAE,OAAO;QAC3C,IAAI,GAAG,IAAI,CAAC;QACZ,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC,CAAC;IACF,KAAK,CAAC,UAAU,CAAC,CAAC;IAClB,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAoB;IACjD,IAAI,OAAO,GAAY,KAAK,CAAC;IAC7B,IAAI,SAAS,GAAuC,IAAI,CAAC;IACzD,OAAO,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,IAAI,EAAE,CAAC,0BAA0B,CAAC,MAAM,CAAC,EAAE,CAAC;YACxC,SAAS,GAAG,MAAM,CAAC;YACnB,OAAO,GAAG,MAAM,CAAC;YACjB,SAAS;QACb,CAAC;QACD,MAAM;IACV,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAmC;IAC5D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,GAAkB,MAAM,CAAC;IACpC,OAAO,EAAE,CAAC,0BAA0B,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5C,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IACjC,CAAC;IACD,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC"}

package/dist/_lib/toHoverDoc.d.ts

@@ -0,0 +1,20 @@
+import type { HoverRegistryEntry } from "../hoverRegistry.generated.js";
+import type { HoverDoc } from "../types.js";
+/**
+ * Convert a generated hover-registry entry into the public hover payload.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const doc = toHoverDoc({
+ *         fqn: "ta.ema",
+ *         kind: "function",
+ *         title: "ta.ema(source, length)",
+ *         summary: "EMA.",
+ *         since: "0.1",
+ *         stability: "stable",
+ *     });
+ *     void doc;
+ */
+export declare function toHoverDoc(entry: HoverRegistryEntry): HoverDoc;
+//# sourceMappingURL=toHoverDoc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toHoverDoc.d.ts","sourceRoot":"","sources":["../../src/_lib/toHoverDoc.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,kBAAkB,GAAG,QAAQ,CAO9D"}