docier-web 0.1.0

package/README.md

@@ -0,0 +1,239 @@
+# docier
+
+A DOCX editor for the browser, written in TypeScript.
+
+`docier` opens a `.docx`, lets a person edit it, and writes a valid `.docx` back. It is a library
+rather than an application: you mount it into an element, configure it with one object, drive it
+through commands and observe it through events. It is framework-agnostic, has one runtime dependency,
+and ships an optional module for document templates.
+
+[![CI](https://github.com/pistonpunk/docier/actions/workflows/ci.yml/badge.svg)](https://github.com/pistonpunk/docier/actions/workflows/ci.yml)
+
+## The problem it solves
+
+Most browser editing is HTML editing. You type into a `contenteditable`, the browser decides where the
+text goes, and a converter guesses at a `.docx` afterwards. That works until the document matters: the
+line breaks are not the ones that print, the page breaks are not the ones Word would choose, and each
+conversion loses something.
+
+`docier` treats the `.docx` as the document and computes the layout itself. Text is positioned from a
+computed layout rather than from what the browser happened to do, so the page you see and the page that
+prints are the same page. Documents from Word keep their markup, including the parts `docier` does not
+understand, so re-saving a contract does not quietly remove things.
+
+## Install
+
+```
+npm install docier-web
+```
+
+## Quick start
+
+```ts
+import { createEditor } from 'docier-web'
+import { mountChrome } from 'docier-web/ui'
+
+const bytes = await fetch('/contract.docx').then((r) => r.arrayBuffer())
+
+const editor = createEditor('#editor', {}, { document: bytes })
+mountChrome(editor)
+
+editor.events.on('docier:doc:change', () => scheduleSave(editor.document))
+```
+
+`createEditor(target, config, options)` where `target` is an element or a selector:
+
+- `config` is a deep-partial configuration object; every key has a default.
+- `options.document` accepts a `Uint8Array`, `ArrayBuffer`, `Blob`, or an already-parsed package or
+  model. `options.zoom` and `options.render` are also accepted here.
+
+The call is safe to repeat: mounting twice on the same element returns the first handle, and `destroy()`
+is idempotent.
+
+## Using it
+
+Everything the user can do is a command. Every state change is an event.
+
+```ts
+editor.commands.execute('docier.command.format.bold')
+editor.commands.execute('docier.command.insert.table', { rows: 3, columns: 4 })
+
+const bold = editor.commands.describe('docier.command.format.bold')
+// { enabled: true, active: false, ... }
+
+const blocked = editor.commands.describe('docier.command.table.deleteRow')
+// { enabled: false, reason: 'The caret is not inside a table' }
+```
+
+A command that cannot run tells you why. Nothing is silently inert, and nothing reports success while
+doing nothing: `describe` returns a reason, and executing a blocked command returns a structured status
+carrying the same reason.
+
+Events follow the same naming scheme, `docier:<area>:<verb>`, with the cancellable ones named
+`before<Verb>`:
+
+```ts
+editor.events.on('docier:selection:change', ({ from, to }) => updateToolbar(from, to))
+editor.events.on('docier:doc:beforechange', (event) => {
+  if (!confirmDiscard()) event.preventDefault()
+})
+```
+
+## Exporting
+
+PDF export is a separate entry point, so an application that never exports never loads it.
+
+```ts
+import { exportPdf } from 'docier-web/pdf'
+
+const { bytes, report } = await exportPdf(editor.layout, { pdfa: 'a-2b' })
+```
+
+The exporter renders the same computed layout the screen renders. It does not re-run layout, re-measure
+text, or consult the document for any position. That is what makes the screen and the printed page agree
+rather than approximately agree. Glyph advances come from the same font measurement the layout used, and
+a font whose metrics disagree is reported rather than substituted.
+
+Output is deterministic: the same document produces byte-identical bytes, verified across separate
+processes. Missing fonts and missing images are reported as losses rather than silently omitted.
+
+Printing is available too, with page ranges shared by the print and PDF paths.
+
+## Document templates
+
+Optional, a separate entry point, and off unless enabled. An application that does not use templates
+never loads it.
+
+A token is a real Word **content control**. It is the same mechanism Word itself uses for fillable
+fields, which means a template stays a valid `.docx` that a person can open and edit in Word, with the
+fields still working. Placeholders are not a special text syntax that only `docier` understands.
+
+```ts
+import { createTokenAttachment, fillTemplate } from 'docier-web/tokens'
+
+const tokens = createTokenAttachment(editor, { catalogue, locale: 'ro-RO' })
+tokens.data.setData({ 'employee.surname': 'Popescu' })
+
+const { bytes, issues } = await fillTemplate({ template, catalogue, data, locale: 'ro-RO' })
+```
+
+The catalogue is the backend's authority. A template that references a field the catalogue does not
+define is reported rather than rendering as blank, and a value that is missing is both reported by code
+and shown as a visible placeholder. A contract must never print a silently empty name.
+
+Filling runs headlessly: bytes in, bytes out, no DOM and no network, so a server can fill a template
+without a browser.
+
+## What it handles
+
+- **DOCX fidelity.** Round-trips a real `.docx`, preserving markup it does not model as raw bytes rather
+  than dropping it. Unicode is preserved exactly, not normalised.
+- **Layout.** Line breaking, justification, hyphenation points, widow and orphan control, keep-with-next
+  and keep-lines-together, page breaks, sections, columns, tab stops, borders and shading.
+- **Tables.** Column resolution, all three row height rules, row splitting across pages, repeating header
+  rows, merged cells, nested tables, and editing inside cells.
+- **Headers, footers and page fields.** Default, first-page and even/odd variants, with `PAGE`,
+  `NUMPAGES`, `SECTION` and `SECTIONPAGES` resolved to real values.
+- **Styles.** The full cascade: document defaults, table styles and conditional formatting, numbering,
+  paragraph and character styles with their `basedOn` chain, and direct formatting, with Word's toggle
+  semantics.
+- **Editing.** Caret and selection, Word's navigation keys, typing, splitting and joining, clipboard with
+  a model-content buffer, undo and redo with one entry per gesture, and 112 commands.
+- **Chrome.** Ribbon with tabs and groups, context menus on every surface, a floating selection toolbar,
+  a ruler, a status bar, and theming through CSS custom properties.
+
+## Requirements
+
+Evergreen browsers: Chrome and Edge 120+, Firefox 121+, Safari 17.4+.
+
+The floor is set by capability rather than version. `docier` uses `CompressionStream`, `Intl.Segmenter`
+for locale-aware line and word breaking, the Popover API, `structuredClone`, and ES modules with
+top-level await. There are no polyfills for older browsers.
+
+**Fonts are not bundled.** You supply them. This keeps the package small and leaves font licensing with
+you, but it means text will not render correctly until you wire up the fonts your documents use. See
+`docs/` for the requirement.
+
+### The font integration contract
+
+Layout happens before paint and without a browser, so the engine cannot ask a font file how wide a run
+is. It measures through a `TextMeasurer`, and the widths it returns are the widths the renderer has to
+produce. That makes three things your responsibility, and they have to agree with each other:
+
+1. **Supply the face bytes.** Read the TTF or OTF files you are licensed to serve, keyed by the family
+   names and the four styles (regular, bold, italic, bold italic) the documents actually ask for.
+2. **Register screen faces for every document family name.** The browser paints with fonts resolved from
+   CSS, so a family the page does not know falls back to something else and the painted run will not be
+   the width the engine reserved. A document asks for `Calibri`, `Times New Roman` or `Arial`, not for
+   the name of the file you happen to ship. Declare only the styles you can actually serve: a `@font-face`
+   with no file behind it makes the browser substitute a font the measurer never saw, which is worse than
+   leaving the style out and letting the family's regular face answer for it.
+3. **Build the measurer from the same bytes.** `createFontMeasurer({ faces })` takes `{ family, bold,
+   italic, bytes }` records and returns a `TextMeasurer` that reads real `hmtx` advances and `cmap`
+   coverage, segments text exactly like the built-in model (combining marks and variation selectors stay
+   with their base), and reports a face id the PDF exporter can verify against the font it embeds. Pass
+   it as `layout.measurer`:
+
+   ```ts
+   import { createEditor, createFontMeasurer } from 'docier-web';
+
+   const measurer = createFontMeasurer({
+     faces: [
+       { family: 'Calibri', bold: false, italic: false, bytes: regularBytes },
+       { family: 'Calibri', bold: true, italic: false, bytes: boldBytes },
+     ],
+     fallbackFamily: 'Calibri',
+   });
+
+   const handle = createEditor(host, { layout: { measurer }, /* ... */ });
+   ```
+
+`layout.measurer` is a reload key, so setting a different measurer lays the document out again with it;
+`updateConfig({ layout: { measurer: other } })` takes effect on the next layout rather than mutating the
+painted page in place.
+
+If no measurer is supplied the engine falls back to a deterministic advance model, which is legible in
+tests but is not a font: real faces are 14 to 30 percent wider, so with that model adjacent runs overlap
+and right-aligned text runs past the margin. That is the failure you see when only the screen `@font-face`
+rules were wired up.
+
+Check that what you fetched really is a font. A development server that answers a missing file with its
+own HTML page returns `200 OK` and markup, and font bytes are parsed rather than trusted, so a placeholder
+page in the place of a face is an error rather than a silent fallback.
+
+The full worked example is the demo host in `example/src/fonts.ts` and `example/src/main.ts`: it loads the
+faces, registers the screen aliases, and hands the same bytes to `createFontMeasurer`.
+
+## Status
+
+Version 0.x. Under active development, CI on every push, 1,200+ assertions.
+
+**Working:** everything listed under "What it handles".
+
+**Not yet:** templates with repeating sections and conditionals; inserting images and shapes, as opposed
+to rendering ones already in a document; comments; footnotes; find and replace; proofing; and editing a
+header or footer from the UI. See `agent_progress.md` for the current state and `docs/SPEC.md` for the
+full design.
+
+## Architecture
+
+For contributors, and for anyone who wants to know why the page you see is the page that prints.
+
+There is one layout engine and two renderers. The engine produces an immutable layout result in
+millipoints; the screen renderer paints it into the DOM and the PDF exporter paints it into a file. No CSS
+takes part in layout, the point-to-pixel conversion happens in exactly one place, and zoom is a paint
+scale that never triggers a re-layout. The constraint is enforced by a test that fails if the renderer
+imports the layout layer, so the two cannot drift apart through inattention.
+
+The document model is a typed view over the parsed XML rather than a structure rebuilt from it. That is
+what lets unmodelled markup survive an edit, and it is why an unknown element in a contract is still
+there after a save.
+
+See `docs/SPEC.md` for the full design and `docs/adr/` for the decisions behind it.
+
+## Licence
+
+Dual-licensed: **AGPL-3.0-only** for open source, or a **commercial licence** for proprietary use.
+
+The AGPL covers use over a network, so it applies to a hosted product as well as a distributed one. If
+that does not suit your project, a commercial licence is available. See `LICENSE` and `COMMERCIAL.md`.

package/dist/api/commands.d.ts

@@ -0,0 +1,46 @@
+import type { CommandContext, CommandDefinition, CommandId, CommandRegistry, DocierErrorCode, DocierEventMap, EventBus, ExecuteOptions, LayoutInvalidation, LocalizedString, MutationOutcome, SelectionSnapshot, SelectionTarget, TextRange } from './types.js';
+export interface CommandTransaction {
+    readonly id: string;
+    readonly changed: boolean;
+    readonly affectedRanges: readonly TextRange[];
+    readonly invalidation: LayoutInvalidation;
+    mutate<T>(fn: () => MutationOutcome<T>): T;
+}
+export declare const nullTransaction: CommandTransaction;
+export interface PermissionBlock {
+    readonly code: DocierErrorCode;
+    readonly reason: LocalizedString;
+}
+export interface CommitInfo {
+    readonly commandId: CommandId;
+    readonly noop: boolean;
+    readonly undoable: boolean;
+    readonly layer: 'document' | 'chrome' | 'global';
+    readonly label: LocalizedString;
+    readonly source: ExecuteOptions['source'];
+    readonly transient: boolean;
+    readonly value: unknown;
+    readonly coalesceKey?: string | undefined;
+    readonly selectionAfter?: SelectionTarget | undefined;
+}
+export interface CommitResult {
+    readonly affectedRanges: readonly TextRange[];
+    readonly invalidation: LayoutInvalidation;
+}
+export interface CommandEnvironment {
+    readonly instanceId: string;
+    readonly events: EventBus<DocierEventMap>;
+    readonly revision: number;
+    readonly selection: SelectionSnapshot;
+    context<A>(definition: CommandDefinition<A, unknown>, args: A, options: ExecuteOptions, transaction: CommandTransaction): CommandContext<A>;
+    begin(commandId: CommandId, invalidation: LayoutInvalidation | undefined): CommandTransaction;
+    commit(transaction: CommandTransaction, info: CommitInfo): CommitResult;
+    rollback(transaction: CommandTransaction): void;
+    permissionBlock(definition: CommandDefinition<never, unknown>): PermissionBlock | undefined;
+}
+export declare const createCommandRegistry: (env: CommandEnvironment) => CommandRegistry;
+export declare class CancelledChangeError extends Error {
+    readonly reason: LocalizedString;
+    constructor(reason: LocalizedString);
+}
+//# sourceMappingURL=commands.d.ts.map

package/dist/api/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/api/commands.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAGjB,SAAS,EACT,eAAe,EAGf,eAAe,EACf,cAAc,EACd,QAAQ,EACR,cAAc,EAEd,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,SAAS,EACV,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,SAAS,SAAS,EAAE,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CAC5C;AAED,eAAO,MAAM,eAAe,EAAE,kBAM7B,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,cAAc,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;CACvD;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,cAAc,EAAE,SAAS,SAAS,EAAE,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,OAAO,CAAC,CAAC,EACP,UAAU,EAAE,iBAAiB,CAAC,CAAC,EAAE,OAAO,CAAC,EACzC,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,kBAAkB,GAC9B,cAAc,CAAC,CAAC,CAAC,CAAC;IACrB,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,GAAG,SAAS,GAAG,kBAAkB,CAAC;IAC9F,MAAM,CAAC,WAAW,EAAE,kBAAkB,EAAE,IAAI,EAAE,UAAU,GAAG,YAAY,CAAC;IACxE,QAAQ,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAChD,eAAe,CAAC,UAAU,EAAE,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,eAAe,GAAG,SAAS,CAAC;CAC7F;AAID,eAAO,MAAM,qBAAqB,GAAI,KAAK,kBAAkB,KAAG,eA6P/D,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;gBACrB,MAAM,EAAE,eAAe;CAKpC"}

package/dist/api/commands.js

@@ -0,0 +1,274 @@
+import { COMMAND_PREFIX, NOOP } from './constants.js';
+import { DocierError, commandIdOf, toDocierError } from './errors.js';
+import { noInvalidation } from './types.js';
+export const nullTransaction = {
+    id: '',
+    changed: false,
+    affectedRanges: [],
+    invalidation: noInvalidation,
+    mutate: (fn) => fn().value,
+};
+const isArea = (id) => id.startsWith(COMMAND_PREFIX);
+export const createCommandRegistry = (env) => {
+    const definitions = new Map();
+    const executing = new Set();
+    const rebinds = new Map();
+    const descriptorOf = (definition) => {
+        const ctx = env.context(definition, undefined, {}, nullTransaction);
+        const visible = definition.isVisible === undefined || definition.isVisible(ctx);
+        const enabled = definition.isEnabled === undefined || definition.isEnabled(ctx);
+        const active = definition.isActive !== undefined && definition.isActive(ctx);
+        const reason = enabled ? undefined : definition.disabledReason?.(ctx);
+        const bindings = rebinds.get(definition.id) ?? definition.bindings ?? [];
+        return {
+            id: definition.id,
+            label: definition.label,
+            category: definition.category,
+            description: definition.description,
+            icon: definition.icon,
+            keywords: definition.keywords,
+            bindings,
+            layer: definition.layer ?? 'document',
+            undoable: definition.undoable ?? true,
+            repeatable: definition.repeatable ?? false,
+            enabled,
+            active,
+            visible,
+            disabledReason: reason,
+        };
+    };
+    const blocked = (id, code, reason) => {
+        env.events.emit('docier:command:blocked', {
+            instanceId: env.instanceId,
+            documentRevision: env.revision,
+            source: 'api',
+            timestamp: Date.now(),
+            commandId: commandIdOf(id),
+            code,
+            reason,
+        });
+        return { status: 'blocked', code, reason };
+    };
+    const execute = async (id, args, options) => {
+        const definition = definitions.get(id);
+        if (definition === undefined) {
+            return {
+                status: 'failed',
+                error: new DocierError({
+                    code: 'COMMAND_NOT_FOUND',
+                    detail: id,
+                    context: { instanceId: env.instanceId, operation: 'execute', documentRevision: env.revision },
+                }),
+            };
+        }
+        if (executing.has(id)) {
+            return blocked(id, 'REENTRANT_COMMAND', `The command ${id} is already executing`);
+        }
+        const source = options?.source ?? 'api';
+        const force = options?.force ?? false;
+        const before = env.events.dispatch('docier:command:beforeexecute', {
+            instanceId: env.instanceId,
+            documentRevision: env.revision,
+            source,
+            timestamp: Date.now(),
+            commandId: commandIdOf(id),
+            args,
+        });
+        if (before.defaultPrevented) {
+            return blocked(id, 'INAPPLICABLE', 'A listener cancelled the command');
+        }
+        const denied = env.permissionBlock(definition);
+        if (denied !== undefined) {
+            return blocked(id, denied.code, denied.reason);
+        }
+        const given = (args === undefined ? {} : args);
+        const context = env.context(definition, given, { ...options, source }, nullTransaction);
+        if (!force && definition.isEnabled !== undefined && !definition.isEnabled(context)) {
+            const reason = definition.disabledReason?.(context) ?? 'The command cannot run here';
+            return blocked(id, definition.disabledCode ?? 'INAPPLICABLE', reason);
+        }
+        const started = Date.now();
+        const declared = definition.invalidation?.(given);
+        let transaction;
+        try {
+            transaction = env.begin(commandIdOf(id), declared);
+        }
+        catch (cause) {
+            if (cause instanceof CancelledChangeError) {
+                return blocked(id, 'INAPPLICABLE', cause.reason);
+            }
+            throw cause;
+        }
+        executing.add(id);
+        let value;
+        try {
+            const scoped = env.context(definition, given, { ...options, source }, transaction);
+            value = await definition.execute(given, scoped);
+        }
+        catch (cause) {
+            env.rollback(transaction);
+            executing.delete(id);
+            if (cause instanceof CancelledChangeError) {
+                return blocked(id, 'INAPPLICABLE', cause.reason);
+            }
+            const error = toDocierError(cause, 'INTERNAL', 'execute', {
+                instanceId: env.instanceId,
+                commandId: commandIdOf(id),
+                documentRevision: env.revision,
+            });
+            env.events.emit('docier:error', {
+                instanceId: env.instanceId,
+                documentRevision: env.revision,
+                source,
+                timestamp: Date.now(),
+                code: error.code,
+                message: error.message,
+                detail: error.detail,
+                operation: 'execute',
+            });
+            return { status: 'failed', error };
+        }
+        executing.delete(id);
+        const muted = value === NOOP;
+        const layer = definition.layer ?? 'document';
+        const undoable = options?.transaction?.undoable ?? definition.undoable ?? true;
+        const noop = muted || (!transaction.changed && layer !== 'chrome' && undoable);
+        const committed = env.commit(transaction, {
+            commandId: commandIdOf(id),
+            noop,
+            undoable,
+            layer,
+            label: options?.transaction?.label ?? definition.label,
+            source,
+            transient: options?.transient ?? false,
+            value,
+            coalesceKey: options?.transaction?.coalesceKey,
+            selectionAfter: options?.transaction?.selectionAfter,
+        });
+        if (noop)
+            return { status: 'noop' };
+        env.events.emit('docier:command:execute', {
+            instanceId: env.instanceId,
+            documentRevision: env.revision,
+            source,
+            timestamp: Date.now(),
+            commandId: commandIdOf(id),
+            args: given,
+            status: 'ok',
+            durationMs: Date.now() - started,
+        });
+        return {
+            status: 'ok',
+            value: value,
+            affectedRanges: committed.affectedRanges,
+            invalidation: committed.invalidation,
+        };
+    };
+    const registry = {
+        register: (definition) => {
+            if (!isArea(definition.id)) {
+                throw new DocierError({
+                    code: 'CONFIG_INVALID',
+                    detail: `The command id ${definition.id} is not in the docier.command. namespace`,
+                    context: { instanceId: env.instanceId, operation: 'register' },
+                });
+            }
+            if (definitions.has(definition.id)) {
+                throw new DocierError({
+                    code: 'CONFIG_INVALID',
+                    detail: `The command id ${definition.id} is already registered`,
+                    context: { instanceId: env.instanceId, operation: 'register' },
+                });
+            }
+            definitions.set(definition.id, definition);
+            return {
+                dispose: () => {
+                    if (definitions.get(definition.id) === definition) {
+                        definitions.delete(definition.id);
+                    }
+                },
+            };
+        },
+        replace: (definition) => {
+            if (!isArea(definition.id)) {
+                throw new DocierError({
+                    code: 'CONFIG_INVALID',
+                    detail: `The command id ${definition.id} is not in the docier.command. namespace`,
+                    context: { instanceId: env.instanceId, operation: 'replace' },
+                });
+            }
+            const inserted = definition;
+            const displaced = definitions.get(definition.id);
+            definitions.set(definition.id, inserted);
+            return {
+                dispose: () => {
+                    if (definitions.get(definition.id) !== inserted)
+                        return;
+                    if (displaced === undefined)
+                        definitions.delete(definition.id);
+                    else
+                        definitions.set(definition.id, displaced);
+                },
+            };
+        },
+        get: (id) => definitions.get(id),
+        list: (filter) => {
+            const out = [];
+            for (const definition of definitions.values()) {
+                if (filter?.area !== undefined && definition.category !== filter.area)
+                    continue;
+                if (filter?.ids !== undefined && !filter.ids.includes(definition.id))
+                    continue;
+                const descriptor = descriptorOf(definition);
+                if (filter?.enabledOnly === true && !descriptor.enabled)
+                    continue;
+                if (filter?.visibleOnly === true && !descriptor.visible)
+                    continue;
+                out.push(descriptor);
+            }
+            return out.sort((first, second) => first.id.localeCompare(second.id));
+        },
+        execute,
+        isEnabled: (id, args) => {
+            const definition = definitions.get(id);
+            if (definition === undefined)
+                return false;
+            const ctx = env.context(definition, args, {}, nullTransaction);
+            if (env.permissionBlock(definition) !== undefined)
+                return false;
+            return definition.isEnabled === undefined || definition.isEnabled(ctx);
+        },
+        disabledReason: (id, args) => {
+            const definition = definitions.get(id);
+            if (definition === undefined)
+                return 'No such command';
+            const ctx = env.context(definition, args, {}, nullTransaction);
+            const denied = env.permissionBlock(definition);
+            if (denied !== undefined)
+                return denied.reason;
+            if (definition.isEnabled === undefined || definition.isEnabled(ctx))
+                return undefined;
+            return definition.disabledReason?.(ctx) ?? 'The command cannot run here';
+        },
+        isActive: (id, args) => {
+            const definition = definitions.get(id);
+            if (definition === undefined)
+                return false;
+            const ctx = env.context(definition, args, {}, nullTransaction);
+            return definition.isActive !== undefined && definition.isActive(ctx);
+        },
+        setKeybinding: (id, bindings) => {
+            rebinds.set(id, bindings);
+        },
+    };
+    return registry;
+};
+export class CancelledChangeError extends Error {
+    reason;
+    constructor(reason) {
+        super('The change was cancelled');
+        this.name = 'CancelledChangeError';
+        this.reason = reason;
+    }
+}
+//# sourceMappingURL=commands.js.map

package/dist/api/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/api/commands.ts"],"names":[],"mappings":"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"}

package/dist/api/config.d.ts

@@ -0,0 +1,14 @@
+import type { ConfigApplyReport, Diagnostic, EditorConfig, EditorConfigPatch } from './types.js';
+export declare const defaultConfig: () => EditorConfig;
+export interface MergeReport {
+    readonly config: EditorConfig;
+    readonly unknown: readonly string[];
+    readonly warnings: readonly Diagnostic[];
+}
+export declare const mergeConfig: (base: EditorConfig, patch: EditorConfigPatch | undefined) => MergeReport;
+export declare const reloadKeysOf: (patch: EditorConfigPatch | undefined) => readonly string[];
+export declare const applyPatch: (base: EditorConfig, patch: EditorConfigPatch | undefined) => {
+    readonly report: MergeReport;
+    readonly applyReport: ConfigApplyReport;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/api/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/api/config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,aAAa,QAAO,YAmC/B,CAAC;AA6FH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;CAC1C;AAyDD,eAAO,MAAM,WAAW,GAAI,MAAM,YAAY,EAAE,OAAO,iBAAiB,GAAG,SAAS,KAAG,WAqBtF,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,OAAO,iBAAiB,GAAG,SAAS,KAAG,SAAS,MAAM,EAiBlF,CAAC;AAEF,eAAO,MAAM,UAAU,GACrB,MAAM,YAAY,EAClB,OAAO,iBAAiB,GAAG,SAAS,KACnC;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAA;CAczE,CAAC"}