@adecore/editor-react 0.17.0-beta.1 → 0.17.0-beta.2

package/LICENSE

@@ -6,7 +6,7 @@ FSL-1.1-MIT
 
 ## Notice
 
-Copyright 2026 Bas Milius
+Copyright 2026 - present Bas Milius
 
 ## Terms and Conditions
 

package/README.md

@@ -1,55 +1,60 @@
 # @adecore/editor-react
 
-Read the [React editor handbook](https://adecore.dev/editor-react/handbook/) for the complete setup, concepts, host integration and testing guides.
+[![npm](https://img.shields.io/npm/v/@adecore/editor-react)](https://www.npmjs.com/package/@adecore/editor-react)
+[![Docs](https://img.shields.io/badge/docs-adecore.dev-blue)](https://adecore.dev/editor-react/)
 
-Language-enabled editors and React popups over an injected `LanguageService`. Completion and snippets, hover, signature help, diagnostics, selection ranges, semantic tokens, inlay hints, folding, navigation, rename, code actions, symbols, peek and code vision retain their current implementation. The package starts no process and imports no application checkout.
+Language features for [`@adecore/editor`](https://adecore.dev/editor/) over a `LanguageService` of [`@adecore/lsp`](https://adecore.dev/lsp/): suggestions and snippets, hover, signature help, problems, navigation, peek, rename, code actions, symbols, semantic colors, inlay hints, folds and code vision, with the React cards that show them. It starts no language server and touches no file; the app hands it a service and the file operations it allows.
 
-`ProjectLanguage` shares documents, navigation history and diagnostic counts across editors. `EditorLanguage` attaches the feature coordinators to one actual `Editor`. `EditorView` mounts an engine and renders `LanguagePopups`; use the coordinators directly when the host already owns mounting.
+**[Documentation with live demos](https://adecore.dev/editor-react/)**
 
-```tsx
-import { createSmartEditorEngine } from '@adecore/editor';
-import { resolveKeymap } from '@adecore/editor/keymap';
-import { EditorView, ProjectLanguage } from '@adecore/editor-react';
+## Install
 
-const keymap = resolveKeymap({ goToDefinition: { mac: 'Alt+Shift+D', other: 'Alt+Shift+D' } });
-const engine = createSmartEditorEngine({ tokenizer: async () => null, keymap, apple: false });
-const project = new ProjectLanguage(service, { keymap, apple: false, openPlace });
-const options = { text: 'const greeting = "Hello";', language: 'typescript', theme: 'github-light' };
-
-// Render inside a parent with a height; dispose the project when its owner closes it.
-<EditorView engine={engine} options={options} project={project} uri="file:///example.ts" languageId="typescript" className="h-72" />;
+```sh
+bun add @adecore/editor-react
 ```
 
-Here `service` is the host's `LanguageService` and `openPlace` is its file-opening callback. Keep the engine, options, project and `onMount` callback stable across renders: changes remount the editor. `EditorView` disposes its editor and attachment on unmount; it does not dispose the supplied project or service. Dispose `ProjectLanguage` after its editor attachments, then let the host shut down its service. Editors sharing a URI must already share text through the host; the first editor sends document changes, and a surviving editor takes over when it closes.
-
-## CSS and translations
+`@adecore/ui`, React 19, `react-dom`, `i18next` and `react-i18next` are peer dependencies.
 
-Import these styles in order:
+## Set up
 
 ```css
 @import '@adecore/ui/theme.css';
 @import '@adecore/editor/editor.css';
 @import '@adecore/editor-react/editor-react.css';
-@source "../node_modules/@adecore/ui/src";
-@source "../node_modules/@adecore/editor-react/src";
+@source "../node_modules/@adecore/editor-react/dist";
 ```
 
-The last two lines are Tailwind v4 source registrations, relative to the consumer stylesheet. React popups use Adecore UI components and Tailwind utilities. The editor DOM itself uses plain CSS and needs no Tailwind. The editor's positioned container must have a width and height. Define theme mode with `data-theme="light"` or `data-theme="dark"`, then override editor tokens after the imports if needed.
+Add `@adecore/editor-react/locales/en.json` and `nl.json` to i18next as the `editor` namespace, then:
 
-Register `@adecore/editor-react/locales/en.json` and `/locales/nl.json` under the `editor` i18next namespace before mounting popups. The host also initializes the `@adecore/ui` translations. `EditorRenderingProvider` optionally accepts a theme and asynchronous code highlighter for hover and peek previews. Plain code is rendered when none is provided. Markdown supports GFM without raw HTML.
+```tsx
+import { EditorView, ProjectLanguage } from '@adecore/editor-react';
 
-The working example in `examples/language-editor.tsx` owns an isolated i18next instance, mounts the real DOM engine and supplies `FakeLanguageService` completion and hover responses. Type text or press Ctrl+Space to request completion. It uses no filesystem, provider CLI or language-server process.
+const project = new ProjectLanguage(service, { folder, keymap, openPlace, files, notify });
 
-## Host operations
+<EditorView engine={engine} options={options} project={project} uri={uri} languageId="typescript" className="h-96" />;
+```
 
-`LanguageHost` accepts the folder, platform, resolved keymap, path resolver, file-opening callback, server display names, notifications and optional rename suggestions. `ProjectFiles` supplies reads, unsaved staging, saves and renames. Open-file text edits are undoable; unopened files become drafts. Edits containing renames save their changes through the host before moving files. Create/delete operations remain unsupported and return a failure. Permission checks and drafts belong in these adapters.
+## Entry points
 
-Git authorship is supplied explicitly to `language.codeVision.setBlame`; the library runs no Git command. Attribution marks and remote cursors remain engine primitives. `AttributionCard` accepts display content and host action elements. `ChangeReview` renders an explicit selected/proposed diff; its `startLine` is one-based. `RowHost`, `LineActionHost` and `HighlightLayers` coordinate independent display owners. Acceptance, persistence, AI prompts, chat routing, conflict policy and rollback remain host operations.
+| Import | What it holds |
+|---|---|
+| `@adecore/editor-react` | The components, `ProjectLanguage`, `EditorLanguage` and every model |
+| `@adecore/editor-react/models` | The pure models, without React |
+| `@adecore/editor-react/testing` | `FakeLanguageService` and `ManualTimers` |
+| `@adecore/editor-react/editor-react.css` | The styles of the cards |
+| `@adecore/editor-react/locales/*.json` | The words, in English and Dutch |
 
-`FindReplace` operates on an explicit editor. `EditorContextMenu` accepts host action children. `/models` exports the pure language, proposal, edit and view-state helpers; `/testing` exports `FakeLanguageService` and `ManualTimers`. Default imports load compiled JavaScript and declarations; workspace consumers can enable `source` in the bundler, TypeScript `customConditions` and `bun test --conditions=source`.
+## Documentation
 
-## Current limits and validation
+| Page | What it covers |
+|---|---|
+| [Getting started](https://adecore.dev/editor-react/getting-started) | Install, styles, words and a first editor |
+| [Projects and documents](https://adecore.dev/editor-react/project) | `ProjectLanguage`, the host, shared documents and workspace edits |
+| [EditorView](https://adecore.dev/editor-react/editor-view) | The component, `EditorLanguage` and the popups |
+| [Views](https://adecore.dev/editor-react/completion) | A page per feature with a live demo, in the sidebar |
+| [Models](https://adecore.dev/editor-react/models) | The pure functions behind the features |
+| [Testing](https://adecore.dev/editor-react/testing) | `FakeLanguageService` and `ManualTimers` |
 
-This is the current implementation, with remaining feature work preserved. Language results depend on the injected service's supported providers. No bidirectional text or completed screen-reader validation is claimed. The engine retains its long-line coloring and row-list performance limits. File create/delete edits, AI workflows, language-server lifecycle and product shortcuts remain outside this package.
+## License
 
-Run `bun run build`, `bun run typecheck` and `bun run test` after workspace installation. Tests use editor fakes, memory services and manual timers. The package is private at version `0.0.0` and retains FSL-1.1-MIT. See the editor migration guide for source provenance and consumer cutover requirements.
+FSL-1.1-MIT

package/dist/EditorView.d.ts

@@ -1,4 +1,4 @@
-import { type Ref } from 'react';
+import { type ReactNode, type Ref } from 'react';
 import type { Editor, EditorEngine, EditorOptions } from '@adecore/editor';
 import { EditorLanguage } from './editor-language.ts';
 import type { ProjectLanguage } from './project-language.ts';
@@ -11,5 +11,6 @@ export interface EditorViewProps {
     className?: string;
     ref?: Ref<HTMLDivElement>;
     onMount?(editor: Editor, language: EditorLanguage | null): void | (() => void);
+    contextMenuItems?(language: EditorLanguage): ReactNode;
 }
-export declare function EditorView({ engine, options, project, uri, languageId, className, ref, onMount }: EditorViewProps): import("react").JSX.Element;
+export declare function EditorView({ engine, options, project, uri, languageId, className, ref, onMount, contextMenuItems }: EditorViewProps): import("react").JSX.Element;

package/dist/EditorView.js

@@ -3,7 +3,7 @@ import { createHolder } from './holder.js';
 import { useLayoutEffect, useMemo, useRef, useSyncExternalStore } from 'react';
 import { EditorLanguage } from './editor-language.js';
 import { LanguagePopups } from './LanguagePopups.js';
-export function EditorView({ engine, options, project, uri, languageId, className, ref, onMount }) {
+export function EditorView({ engine, options, project, uri, languageId, className, ref, onMount, contextMenuItems }) {
     const element = useRef(null);
     const holder = useMemo(() => createHolder(), []);
     const language = useSyncExternalStore(holder.subscribe, holder.get, holder.get);
@@ -23,5 +23,5 @@ export function EditorView({ engine, options, project, uri, languageId, classNam
             editor.dispose();
         };
     }, [engine, options, project, uri, languageId, holder, onMount]);
-    return (_jsxs("div", { className: className, ref: ref, style: { position: 'relative', minHeight: 0 }, children: [_jsx("div", { ref: element, style: { position: 'absolute', inset: 0 } }), language !== null && _jsx(LanguagePopups, { language: language })] }));
+    return (_jsxs("div", { className: className, ref: ref, style: { position: 'relative', minHeight: 0 }, children: [_jsx("div", { ref: element, style: { position: 'absolute', inset: 0 } }), language !== null && _jsx(LanguagePopups, { language: language, contextMenuItems: contextMenuItems })] }));
 }

package/dist/LanguagePopups.d.ts

@@ -1,4 +1,6 @@
+import { type ReactNode } from 'react';
 import type { EditorLanguage } from './editor-language.ts';
-export declare function LanguagePopups({ language }: {
+export declare function LanguagePopups({ language, contextMenuItems }: {
     language: EditorLanguage;
+    contextMenuItems?: (language: EditorLanguage) => ReactNode;
 }): import("react").JSX.Element;

package/dist/LanguagePopups.js

@@ -14,9 +14,9 @@ import { SignatureCard } from './SignatureCard.js';
 /*
  * Every card a language feature opens over the editor. Each feature keeps its own state and these
  * only draw it, placed by the screen position of the character it belongs to, which is read again
- * whenever the editor scrolls or resizes.
+ * whenever the editor scrolls or resizes. `contextMenuItems` adds rows of the app to the context menu.
  */
-export function LanguagePopups({ language }) {
+export function LanguagePopups({ language, contextMenuItems }) {
     const [, redraw] = useReducer((count) => count + 1, 0);
     const hover = useStore(language.popups, (state) => state.hover);
     const completion = useStore(language.popups, (state) => state.completion);
@@ -34,5 +34,5 @@ export function LanguagePopups({ language }) {
     const pickRect = pick === null ? null : language.editor.rectAt(pick.anchor);
     const renameRect = rename === null ? null : language.editor.rectAt(rename.range.start);
     const renameEnd = rename === null ? null : language.editor.rectAt(rename.range.end);
-    return (_jsxs(_Fragment, { children: [hover !== null && hoverRect !== null && (_jsx(AnchoredPopup, { rect: hoverRect, onPointerEnter: () => language.hover.holdCard(true), onPointerLeave: () => language.hover.holdCard(false), children: _jsx(HoverCard, { language: language, problems: hover.problems, info: hover.info, anchor: hover.anchor, position: hover.position }) })), signature !== null && signatureRect !== null && (_jsx(AnchoredPopup, { rect: signatureRect, placement: { prefer: 'above' }, children: _jsx(SignatureCard, { model: signature.model }) })), completion !== null && completionRect !== null && _jsx(CompletionPopup, { language: language, view: completion, rect: completionRect }), pick !== null && pickRect !== null && _jsx(PickPopup, { language: language, view: pick, rect: pickRect }), menu !== null && _jsx(EditorContextMenu, { language: language, view: menu }), symbols !== null && _jsx(SymbolPicker, { language: language, view: symbols }), peek !== null && _jsx(PeekPanel, { language: language, view: peek }), authors !== null && _jsx(CodeAuthorsCard, { language: language, view: authors }), rename !== null && renameRect !== null && _jsx(RenameCard, { language: language, view: rename, rect: renameRect, endRect: renameEnd })] }));
+    return (_jsxs(_Fragment, { children: [hover !== null && hoverRect !== null && (_jsx(AnchoredPopup, { rect: hoverRect, onPointerEnter: () => language.hover.holdCard(true), onPointerLeave: () => language.hover.holdCard(false), children: _jsx(HoverCard, { language: language, problems: hover.problems, info: hover.info, anchor: hover.anchor, position: hover.position }) })), signature !== null && signatureRect !== null && (_jsx(AnchoredPopup, { rect: signatureRect, placement: { prefer: 'above' }, children: _jsx(SignatureCard, { model: signature.model }) })), completion !== null && completionRect !== null && _jsx(CompletionPopup, { language: language, view: completion, rect: completionRect }), pick !== null && pickRect !== null && _jsx(PickPopup, { language: language, view: pick, rect: pickRect }), menu !== null && (_jsx(EditorContextMenu, { language: language, view: menu, children: contextMenuItems?.(language) })), symbols !== null && _jsx(SymbolPicker, { language: language, view: symbols }), peek !== null && _jsx(PeekPanel, { language: language, view: peek }), authors !== null && _jsx(CodeAuthorsCard, { language: language, view: authors }), rename !== null && renameRect !== null && _jsx(RenameCard, { language: language, view: rename, rect: renameRect, endRect: renameEnd })] }));
 }

package/dist/code-actions.d.ts

@@ -26,4 +26,5 @@ export declare class CodeActionsFeature {
     apply(entry: ActionEntry): Promise<void>;
     private startRename;
     private fail;
+    private say;
 }

package/dist/code-actions.js

@@ -1,4 +1,3 @@
-import i18next from 'i18next';
 import { ErrorCodes, LspError, StaleResultError } from '@adecore/lsp';
 import { ACTION_GROUPS, REFACTOR_GROUPS, actionsOf, diagnosticsAt, fixableOnLine, isHint, mergeEntries, previewOf } from './code-actions-model.js';
 import { Refresher } from './refresher.js';
@@ -19,9 +18,6 @@ class ActionRefused extends Error {
 function isRefusal(error) {
     return error instanceof LspError && error.code === ErrorCodes.InternalError;
 }
-function say(key, options) {
-    return i18next.t(`editor:language.actions.${key}`, options);
-}
 /*
  * What the language servers offer to do at the caret or the selection: a lightbulb in the gutter on the line
  * that has something, a list under the caret (Mod+.) grouped by kind with the change an action would make
@@ -39,12 +35,10 @@ export class CodeActionsFeature {
     resolved = new Map();
     constructor(language, timers = realTimers) {
         this.language = language;
-        const { editor, project, uri } = language;
+        const { editor } = language;
         this.refresher = new Refresher((signal) => this.hint(signal), PAUSE_MS, timers);
-        const providers = project.service.onProvidersChanged((changed) => {
-            if (changed === uri) {
-                this.refresher.later();
-            }
+        const providers = language.onProvidersChanged(() => {
+            this.refresher.later();
         });
         const offs = [
             editor.onCaret(() => {
@@ -65,7 +59,7 @@ export class CodeActionsFeature {
                 return false;
             }),
             language.diagnostics.onChange(() => this.refresher.later()),
-            () => providers.dispose()
+            providers
         ];
         language.onDispose(() => {
             for (const off of offs) {
@@ -99,7 +93,7 @@ export class CodeActionsFeature {
         const entries = await this.request(everything, ['source.organizeImports'], INVOKED);
         const entry = entries?.find((candidate) => candidate.action.kind?.startsWith('source.organizeImports') === true);
         if (entry === undefined) {
-            this.tell('success', say(entries === null ? 'unavailable' : 'organized'));
+            this.tell('success', this.say(entries === null ? 'unavailable' : 'organized'));
             return;
         }
         await this.apply(entry);
@@ -107,13 +101,13 @@ export class CodeActionsFeature {
     async formatDocument() {
         const { editor, project, uri } = this.language;
         if (!project.service.supports('textDocument/formatting', uri)) {
-            this.tell('error', say('noFormatter'));
+            this.tell('error', this.say('noFormatter'));
             return;
         }
         try {
             const edits = await project.service.formatting(uri, { ...editor.getIndentation() });
             if (edits !== null && edits.length > 0 && !editor.applyEdits(edits.map((edit) => ({ range: edit.range, text: edit.newText })))) {
-                this.tell('error', say('readOnly'));
+                this.tell('error', this.say('readOnly'));
             }
         }
         catch (error) {
@@ -128,7 +122,7 @@ export class CodeActionsFeature {
     }
     async ask(options) {
         if (!this.supported) {
-            this.tell('error', say('unavailable'));
+            this.tell('error', this.say('unavailable'));
             return;
         }
         // The press on a card or the gutter may have taken the focus, and the list answers to the editor's keys.
@@ -147,13 +141,13 @@ export class CodeActionsFeature {
             return;
         }
         if (entries.length === 0) {
-            this.tell('success', say('none'));
+            this.tell('success', this.say('none'));
             return;
         }
         const byId = new Map(entries.map((entry) => [entry.id, entry]));
         const groups = (options.groups ?? ACTION_GROUPS).flatMap((group) => {
             const rows = entries.filter((entry) => entry.group === group).map((entry) => ({ id: entry.id, label: entry.action.title, detail: '' }));
-            return rows.length === 0 ? [] : [{ title: say(`groups.${group}`), rows }];
+            return rows.length === 0 ? [] : [{ title: this.say(`groups.${group}`), rows }];
         });
         this.language.completion.close();
         this.language.pick.open({
@@ -220,7 +214,7 @@ export class CodeActionsFeature {
         if (signal.aborted || this.asking) {
             return;
         }
-        editor.setGutterAction(entries?.some(isHint) === true ? { line: editor.getCaret().line, label: say('show') } : null);
+        editor.setGutterAction(entries?.some(isHint) === true ? { line: editor.getCaret().line, label: this.say('show') } : null);
     }
     async resolve(entry, signal) {
         const known = this.resolved.get(entry);
@@ -267,9 +261,9 @@ export class CodeActionsFeature {
             return null;
         }
         const notes = [
-            ...(found.hiddenLines > 0 ? [say('moreLines', { count: found.hiddenLines })] : []),
-            ...(found.otherFiles > 0 ? [say('otherFiles', { count: found.otherFiles })] : []),
-            ...(found.moves > 0 ? [say('moves', { count: found.moves })] : [])
+            ...(found.hiddenLines > 0 ? [this.say('moreLines', { count: found.hiddenLines })] : []),
+            ...(found.otherFiles > 0 ? [this.say('otherFiles', { count: found.otherFiles })] : []),
+            ...(found.moves > 0 ? [this.say('moves', { count: found.moves })] : [])
         ];
         return { removed: found.removed, added: found.added, note: notes.length === 0 ? null : notes.join(' · ') };
     }
@@ -294,7 +288,7 @@ export class CodeActionsFeature {
             if (action.edit !== undefined) {
                 const result = await project.applyWorkspaceEdit(action.edit);
                 if (!result.applied) {
-                    this.tell('error', say('failed', { message: result.failureReason ?? say('refused') }));
+                    this.tell('error', this.say('failed', { message: result.failureReason ?? this.say('refused') }));
                     return;
                 }
             }
@@ -323,7 +317,10 @@ export class CodeActionsFeature {
     }
     fail(error) {
         if (!(error instanceof StaleResultError)) {
-            this.tell('error', say('failed', { message: error instanceof Error ? error.message : String(error) }));
+            this.tell('error', this.say('failed', { message: error instanceof Error ? error.message : String(error) }));
         }
     }
+    say(key, options) {
+        return this.language.project.i18n.t(`editor:language.actions.${key}`, options);
+    }
 }

package/dist/code-authors.d.ts

@@ -1,3 +1,4 @@
+import type { i18n } from 'i18next';
 import type { GitBlameCommit, GitBlameResult } from './host-types.ts';
 export declare const UNCOMMITTED = -1;
 export declare function mapBlame(blame: GitBlameResult, base: string, current: readonly string[]): Int32Array | null;
@@ -14,4 +15,4 @@ export interface CodeAuthorship {
 }
 export declare function shortName(name: string): string;
 export declare function authorshipOf(commits: readonly GitBlameCommit[], mapped: Int32Array, lines: readonly string[], from: number, to: number): CodeAuthorship;
-export declare function authorsText(authorship: CodeAuthorship): string;
+export declare function authorsText(authorship: CodeAuthorship, i18n: i18n): string;

package/dist/code-authors.js

@@ -1,4 +1,3 @@
-import i18next from 'i18next';
 import { diffLines, splitLines } from '@adecore/merge';
 import { formatNumber } from '@adecore/ui/format';
 /* What a line of the text in the editor is: the index of the commit that wrote it, or this for a line no commit holds yet. */
@@ -70,10 +69,10 @@ export function authorshipOf(commits, mapped, lines, from, to) {
     return { authors, uncommittedLines, modified, latest };
 }
 /* The row's words: the author with most lines, how many others wrote some, and a star when the range is edited since the commit. */
-export function authorsText(authorship) {
+export function authorsText(authorship, i18n) {
     const main = authorship.authors[0];
     if (main === undefined) {
-        return i18next.t('editor:language.codeVision.newCode');
+        return i18n.t('editor:language.codeVision.newCode');
     }
     const others = authorship.authors.length - 1;
     return `${main.name}${others > 0 ? ` +${formatNumber(others)}` : ''}${authorship.modified ? ' *' : ''}`;

package/dist/code-vision-model.d.ts

@@ -1,4 +1,5 @@
 import type { DocumentSymbolResult, Position } from '@adecore/lsp';
+import type { i18n } from 'i18next';
 export declare const MAX_DECLARATIONS = 3000;
 export interface CodeVisionDeclaration {
     readonly id: string;
@@ -17,4 +18,4 @@ export interface DeclarationSource {
 }
 export declare function startAfterComments(source: DeclarationSource, from: Position, to: Position): Position | null;
 export declare function declarationsOf(result: DocumentSymbolResult, source: DeclarationSource): CodeVisionDeclaration[];
-export declare function usagesText(count: number): string;
+export declare function usagesText(count: number, i18n: i18n): string;

package/dist/code-vision-model.js

@@ -1,5 +1,4 @@
 import { formatNumber } from '@adecore/ui/format';
-import i18next from 'i18next';
 /* More declarations than this in one file and the rows are left out, which is the file that is too big for them to be quiet. */
 export const MAX_DECLARATIONS = 3000;
 /* LSP's SymbolKind: the kinds a row is drawn for and the ones whose children can be declarations too. */
@@ -177,8 +176,8 @@ export function declarationsOf(result, source) {
     return declarations;
 }
 /* "No usages", "1 usage" and "N usages". */
-export function usagesText(count) {
+export function usagesText(count, i18n) {
     return count === 0
-        ? i18next.t('editor:language.codeVision.usagesNone')
-        : i18next.t('editor:language.codeVision.usages', { count, formatted: formatNumber(count) });
+        ? i18n.t('editor:language.codeVision.usagesNone')
+        : i18n.t('editor:language.codeVision.usages', { count, formatted: formatNumber(count) });
 }

package/dist/code-vision.js

@@ -42,7 +42,7 @@ export class CodeVisionFeature {
     constructor(language, onSymbols, timers = realTimers) {
         this.language = language;
         this.timers = timers;
-        const { editor, project, uri } = language;
+        const { editor } = language;
         const offs = [
             onSymbols((result) => this.read(result)),
             editor.onTextChange(() => {
@@ -54,19 +54,17 @@ export class CodeVisionFeature {
                 this.scrollTimer = this.timers.set(() => this.plan(), SCROLL_PAUSE_MS);
             })
         ];
-        const providers = project.service.onProvidersChanged((changed) => {
-            if (changed === uri) {
-                this.failed.clear();
-                this.publish();
-                this.plan();
-            }
+        const providers = language.onProvidersChanged(() => {
+            this.failed.clear();
+            this.publish();
+            this.plan();
         });
         language.onDispose(() => {
             this.disposed = true;
             for (const off of offs) {
                 off();
             }
-            providers.dispose();
+            providers();
             this.timers.clear(this.scrollTimer);
             for (const controller of this.running.values()) {
                 controller.abort();
@@ -180,7 +178,11 @@ export class CodeVisionFeature {
             const entries = [];
             const known = this.counts.get(declaration.id);
             if (counted && declaration.usages && known !== undefined) {
-                entries.push({ id: 'usages', text: usagesText(known.count), activate: () => void this.language.peek.open(declaration.position) });
+                entries.push({
+                    id: 'usages',
+                    text: usagesText(known.count, this.language.project.i18n),
+                    activate: () => void this.language.peek.open(declaration.position)
+                });
             }
             if (mapped !== null && declaration.authors) {
                 let authorship = this.authorships.get(declaration.id);
@@ -191,7 +193,7 @@ export class CodeVisionFeature {
                 const shown = authorship;
                 entries.push({
                     id: 'authors',
-                    text: authorsText(shown),
+                    text: authorsText(shown, this.language.project.i18n),
                     ...(shown.authors.length > 0 ? { icon: shown.authors.length > 1 ? 'users' : 'user' } : {}),
                     activate: (anchor) => this.showAuthors(declaration, shown, anchor)
                 });

package/dist/completion.js

@@ -1,4 +1,3 @@
-import i18next from 'i18next';
 import { StaleResultError } from '@adecore/lsp';
 import { comparePositions, shiftPosition } from './diagnostics-model.js';
 import { completionDocsOf, identifierPrefix, insertionOf, isIdentifierCharacter, itemsOf, matchedCharacters, mirroredInsertions, prefixFor, qualifiersOf, rankCompletions } from './completion-model.js';
@@ -368,7 +367,7 @@ export class CompletionFeature {
         const asked = this.explicit && !refresh;
         this.refilter();
         if (asked && !this.isOpen && !this.incomplete) {
-            this.language.project.host.notify?.({ id: TOAST_ID, kind: 'error', title: i18next.t('editor:language.completion.none') });
+            this.language.project.host.notify?.({ id: TOAST_ID, kind: 'error', title: this.language.project.i18n.t('editor:language.completion.none') });
         }
         else if (asked && this.ranked.length === 1 && !this.incomplete) {
             // One answer to a list that was asked for is the one wanted.

package/dist/editor-language.d.ts

@@ -59,6 +59,7 @@ export declare class EditorLanguage {
     jump(position: EditorPosition): void;
     visit(place: Place): void;
     locations(places: readonly Location[], anchor: EditorPosition, title: string): void;
+    onProvidersChanged(listener: () => void): () => void;
     onDispose(dispose: () => void): void;
     dispose(): void;
 }

package/dist/editor-language.js

@@ -131,6 +131,28 @@ export class EditorLanguage {
         const rows = places.map((place, index) => ({ id: String(index), ...locationRow(place, this.project.pathOfLocation(place.uri)) }));
         this.pick.open({ anchor, title, groups: [{ title: null, rows }], accept: (id) => this.goTo(places[Number(id)]) });
     }
+    /*
+     * Runs `listener` once the document is open and again whenever the service says what it can ask for
+     * this document changed. A service that is ready before the document opens never says so, so the
+     * opening counts as the first change.
+     */
+    onProvidersChanged(listener) {
+        let listening = true;
+        void this.document.ready.then(() => {
+            if (listening && !this.disposed) {
+                listener();
+            }
+        }, () => undefined);
+        const providers = this.project.service.onProvidersChanged((uri) => {
+            if (uri === this.uri) {
+                listener();
+            }
+        });
+        return () => {
+            listening = false;
+            providers.dispose();
+        };
+    }
     /* Runs `dispose` when the editor lets go of its document. */
     onDispose(dispose) {
         this.disposers.push(dispose);

package/dist/folding.js

@@ -77,15 +77,13 @@ export class FoldingFeature {
             this.publish();
         });
         const edits = editor.onTextChange(() => this.refresher.later());
-        const providers = project.service.onProvidersChanged((changed) => {
-            if (changed === uri) {
-                this.refresher.now();
-            }
+        const providers = language.onProvidersChanged(() => {
+            this.refresher.now();
         });
         language.onDispose(() => {
             symbols();
             edits();
-            providers.dispose();
+            providers();
             this.refresher.dispose();
             editor.setFoldHints(null);
         });

package/dist/history.js

@@ -1,4 +1,3 @@
-import i18next from 'i18next';
 import { isShortcut } from './shortcut-keys.js';
 /* Back, Forward and the list of recent locations over the history the whole project shares. */
 export class HistoryFeature {
@@ -42,6 +41,6 @@ export class HistoryFeature {
     /* Lists the places of the history under the caret; choosing one jumps there like any other jump. */
     recent() {
         const places = this.language.project.history.recent(this.language.place);
-        this.language.locations(places.map((place) => ({ uri: place.uri, range: { start: place.position, end: place.position } })), this.language.editor.getCaret(), i18next.t('editor:language.history.recent'));
+        this.language.locations(places.map((place) => ({ uri: place.uri, range: { start: place.position, end: place.position } })), this.language.editor.getCaret(), this.language.project.i18n.t('editor:language.history.recent'));
     }
 }

package/dist/host-types.d.ts

@@ -1,3 +1,4 @@
+import type { i18n } from 'i18next';
 import type { Keymap } from '@adecore/editor/keymap';
 import type { ProjectFiles } from './workspace-edit.ts';
 import type { Place } from './navigation-history.ts';
@@ -31,6 +32,7 @@ export interface RenameSuggestionsRequest {
     uses: readonly string[];
 }
 export interface LanguageHost {
+    readonly i18n?: i18n;
     readonly folder?: string;
     readonly files?: ProjectFiles;
     readonly apple?: boolean;

package/dist/hover.js

@@ -1,4 +1,3 @@
-import i18next from 'i18next';
 import { rangeHolds } from './diagnostics-model.js';
 import { hoverTextOf, isEmptyHover, locationsOf } from './hover-content.js';
 import { wordRangeAt } from './rename-model.js';
@@ -197,7 +196,7 @@ export class HoverFeature {
         if (problems.length === 0 && info === null) {
             this.hide();
             if (pinned) {
-                this.language.project.host.notify?.({ id: TOAST_ID, kind: 'error', title: i18next.t('editor:language.hover.none') });
+                this.language.project.host.notify?.({ id: TOAST_ID, kind: 'error', title: this.language.project.i18n.t('editor:language.hover.none') });
             }
             return;
         }

package/dist/inlay-hints.js

@@ -57,15 +57,13 @@ export class InlayHintsFeature {
                 this.refresher.later();
             }
         });
-        const providers = project.service.onProvidersChanged((changed) => {
-            if (changed === uri) {
-                this.refresher.now();
-            }
+        const providers = language.onProvidersChanged(() => {
+            this.refresher.now();
         });
         language.onDispose(() => {
             edits();
             scrolls();
-            providers.dispose();
+            providers();
             this.refresher.dispose();
             editor.setInlayHints([]);
         });

package/dist/navigation.d.ts

@@ -14,6 +14,7 @@ export declare class NavigationFeature {
     go(kind: NavigationKind, position?: EditorPosition): Promise<void>;
     goToName(name: string, anchor: EditorPosition, own: Location | null): Promise<void>;
     private tell;
+    private say;
 }
 export declare function locationRow(location: Location, stored: string | null): {
     label: string;