@manifest-configuration-language/browser 0.2.0 → 0.3.0

package/README.md

@@ -29,9 +29,9 @@ An open project is a Worker-backed session. Call `project.update(files)` with th
 
 `project.complete({ entrypoint, position })` returns the MCL language-service candidates for a zero-based UTF-16 position. Completion uses the same local project files as parsing and rendering, including schemas and Helm values schemas. It does not access a Kubernetes API server or any other network service.
 
-`project.definition({ entrypoint, position })` returns a project-relative declaration path and zero-based UTF-16 range for local and imported MCL declarations. `project.hover({ entrypoint, position })` returns declaration syntax, including explicit type annotations and function or rule signatures. Hover does not infer runtime value types, and both operations use only project files already supplied to the browser runtime.
+`project.definition({ entrypoint, position })` returns a project-relative declaration path and zero-based UTF-16 range for local and imported MCL declarations. `project.hover({ entrypoint, position })` returns declaration syntax, including explicit type annotations and function or rule signatures. `project.references({ entrypoint, position })` returns the declaration and references found in the supplied MCL project. These operations use only project files already supplied to the browser runtime.
 
-The package exports the completion, definition, hover, rename, and source map result types, `maxSourceBytes`, `maxSourceMapBytes`, `maxRenameNameLength`, `maxProjectFiles`, `maxProjectFileBytes`, and `maxProjectBytes` so browser interfaces can consume the runtime's public types and limits. `isValidProjectFileSet(paths)` checks path validity, duplicate paths, and file/directory conflicts before a UI creates or renames project files. `rename()` returns source edits for local and non-exported top-level declarations within the active file; exported and cross-file symbols are left unchanged so the result never omits external references.
+The package exports the completion, definition, hover, references, rename, and source map result types, `maxSourceBytes`, `maxSourceMapBytes`, `maxRenameNameLength`, `maxProjectFiles`, `maxProjectFileBytes`, and `maxProjectBytes` so browser interfaces can consume the runtime's public types and limits. `isValidProjectFileSet(paths)` checks path validity, duplicate paths, and file/directory conflicts before a UI creates or renames project files. `rename()` returns edits for local symbols and exported declarations, including qualified value and type references in the supplied MCL project. It returns no edits when a rename would be ambiguous or collide with an existing exported declaration.
 
 MCL decodes the request into a root-relative `io/fs` filesystem for project files, module imports, schemas, and dependency locks. Kubernetes resource scope checks use built-in metadata and CRDs in the project; unknown resource kinds can still be rendered. The runtime limits are defined in the [protocol schema](https://github.com/manifest-configuration-language/mcl/blob/main/cmd/mcl-wasm/protocol.schema.json). The worker blocks `fetch` after loading the WASM runtime assets, so MCL project evaluation cannot make external network requests.
 

package/dist/mcl.wasm

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/dist/mcl.wasm
-size: 96317496 bytes
-sha256: 58f90cac0af9f6b4608f787528617729b99a6fcb65db52f168f95a1a6703e98f
+size: 96778456 bytes
+sha256: 037981cf0ac4773dca73ca1cd9ddffa8b9e9b25aedb15d8c72b1be8ea26c5558

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manifest-configuration-language/browser",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Run MCL projects in a browser Web Worker using the Go WebAssembly runtime.",
   "repository": {
     "type": "git",

package/src/index.d.ts

@@ -13,6 +13,8 @@ import type {
   LintDiagnostic as ProtocolLintDiagnostic,
   ParseResult,
   RelatedLocation as ProtocolRelatedLocation,
+  ReferenceLocation as ProtocolReferenceLocation,
+  ReferencesResult as ProtocolReferencesResult,
   RenderResult,
   RenameEdit as ProtocolRenameEdit,
   RenameResult as ProtocolRenameResult,
@@ -52,6 +54,8 @@ export type HoverResult = ProtocolHoverResult;
 export type HoverInfo = ProtocolHoverInfo;
 export type RenameEdit = ProtocolRenameEdit;
 export type RenameResult = ProtocolRenameResult;
+export type ReferenceLocation = ProtocolReferenceLocation;
+export type ReferencesResult = ProtocolReferencesResult;
 export type SourceRange = ProtocolSourceRange;
 export type SourceMap = ProtocolSourceMap;
 export type SourceMapEntry = ProtocolSourceMapEntry;
@@ -63,6 +67,7 @@ export type MclResult =
   | ({ operation: "completion" } & ProtocolCompletionResult)
   | ({ operation: "definition" } & ProtocolDefinitionResult)
   | ({ operation: "hover" } & ProtocolHoverResult)
+  | ({ operation: "references" } & ProtocolReferencesResult)
   | ({ operation: "rename" } & ProtocolRenameResult)
   | ({ operation: "format" } & FormatResult)
   | ({ operation: "check" } & CheckResult)
@@ -114,6 +119,15 @@ export interface MclRuntime {
     files: ProjectFiles | undefined,
     options: PositionRequestOptions,
   ): Promise<MclResult & { operation: "hover" }>;
+  references(
+    source: string,
+    options: PositionRequestOptions,
+  ): Promise<MclResult & { operation: "references" }>;
+  references(
+    source: string,
+    files: ProjectFiles | undefined,
+    options: PositionRequestOptions,
+  ): Promise<MclResult & { operation: "references" }>;
   rename(
     source: string,
     options: RenameRequestOptions,
@@ -134,6 +148,7 @@ export interface MclProject {
   complete(options: ProjectCompletionOptions): Promise<MclResult & { operation: "completion" }>;
   definition(options: ProjectNavigationOptions): Promise<MclResult & { operation: "definition" }>;
   hover(options: ProjectNavigationOptions): Promise<MclResult & { operation: "hover" }>;
+  references(options: ProjectNavigationOptions): Promise<MclResult & { operation: "references" }>;
   rename(options: ProjectRenameOptions): Promise<MclResult & { operation: "rename" }>;
   format(options?: ProjectOperationOptions): Promise<MclResult & { operation: "format" }>;
   check(options?: ProjectOperationOptions): Promise<MclResult & { operation: "check" }>;

package/src/index.js

@@ -507,6 +507,7 @@ export function createMclRuntime(options = {}) {
       complete: (requestOptions) => runProjectOperation("completion", requestOptions),
       definition: (requestOptions) => runProjectOperation("definition", requestOptions),
       hover: (requestOptions) => runProjectOperation("hover", requestOptions),
+      references: (requestOptions) => runProjectOperation("references", requestOptions),
       rename: (requestOptions) => runProjectOperation("rename", requestOptions),
       format: (requestOptions) => runProjectOperation("format", requestOptions),
       check: (requestOptions) => runProjectOperation("check", requestOptions),
@@ -587,6 +588,8 @@ export function createMclRuntime(options = {}) {
       runSourceNavigation("definition", source, filesOrOptions, requestOptions),
     hover: (source, filesOrOptions, requestOptions) =>
       runSourceNavigation("hover", source, filesOrOptions, requestOptions),
+    references: (source, filesOrOptions, requestOptions) =>
+      runSourceNavigation("references", source, filesOrOptions, requestOptions),
     rename: (source, filesOrOptions, requestOptions) =>
       runSourceNavigation("rename", source, filesOrOptions, requestOptions),
     dispose() {

package/src/protocol.d.ts

@@ -5,7 +5,17 @@ export type Request = {
   requestId?: number;
   revision?: number;
   operation:
-    "parse" | "lint" | "format" | "check" | "evaluate" | "render" | "completion" | "definition" | "hover" | "rename";
+    | "parse"
+    | "lint"
+    | "format"
+    | "check"
+    | "evaluate"
+    | "render"
+    | "completion"
+    | "definition"
+    | "hover"
+    | "references"
+    | "rename";
   position?: CompletionPosition;
   newName?: string;
   entrypoint?: ProjectPath;
@@ -53,6 +63,7 @@ export interface Response {
     | CompletionResult
     | DefinitionResult
     | HoverResult
+    | ReferencesResult
     | RenameResult;
   error?: Error;
 }
@@ -136,6 +147,13 @@ export interface HoverInfo {
   contents: string;
   range: SourceRange;
 }
+export interface ReferencesResult {
+  references: ReferenceLocation[];
+}
+export interface ReferenceLocation {
+  path: ProjectPath1;
+  range: SourceRange;
+}
 export interface RenameResult {
   edits: RenameEdit[];
 }