@dineug/erd-editor 4.1.0 → 5.0.0

package/README.md

@@ -9,16 +9,19 @@ and renders into a closed shadow root, so it drops into React, Vue, Svelte or pl
 leaking styles either way. It is the same editor as [erd-editor.io](https://erd-editor.io), the
 [VS Code extension](https://marketplace.visualstudio.com/items?itemName=dineug.vuerd-vscode), the
 [JetBrains plugin](https://plugins.jetbrains.com/plugin/23594-erd-editor) and the
-[Obsidian plugin](https://community.obsidian.md/plugins/erd-editor).
+[Obsidian plugin](https://community.obsidian.md/plugins/erd-editor). Beside it,
+[`<erd-viewer>`](#viewer) shows a diagram read-only, for a page that only displays one.
 
 ## Features
 
 - **Design** — tables, columns, memos and table groups, four relationship cardinalities, ON DELETE
   and ON UPDATE, alternate keys, Auto Layout
+- **Naming standards** — logical and physical names, physical names and data types derived from
+  word, term and domain dictionaries, which have their own tab with CSV import and export and checks
 - **Import** — SQL DDL, GraphQL SDL, DBML and AML from the menu or [`setSchema*`](#importing-a-schema),
   replacing the diagram or adding to it
 - **Export** — DDL for eight databases, also from `getSchemaSQL()`, code in 22 languages and ORMs,
-  PNG and SVG
+  PNG and SVG, also from [`toImage()`](#images)
 - **Navigate** — command palette (`Ctrl`/`Cmd`+`K`), an Explorer tree with find and replace, Graph
   and Flow views
 - **History** — undo and redo, time travel through the session, a diff viewer (`setDiffValue()`)
@@ -37,14 +40,21 @@ Drizzle, DBML, AML, Mermaid, PHP, Doctrine, Rust, SeaORM, Swift, Zod, JSON Schem
 npm install @dineug/erd-editor
 ```
 
-The PNG and SVG export, the Flow and tree layouts and the syntax highlighting run in shared
-workers, which Vite, webpack and Rspack emit beside your chunks and esbuild does not. A strict CSP
-needs `worker-src 'self'`. Without a bundler, use the [script tag](#script-tag) build.
+The editor's PNG and SVG export, the Flow and tree layouts and the syntax highlighting run in shared
+workers, which Vite, webpack and Rspack emit beside your chunks and esbuild does not. webpack's
+experimental `experiments.outputModule` starts none of them, as each waits on a chunk split off it
+that nothing loads: keep webpack's default output, or set `optimization.splitChunks: false`. A
+strict CSP needs `worker-src 'self'`. `<erd-viewer>` starts no worker. Both elements style
+themselves with constructed stylesheets, which `style-src 'self'` allows, but the editor's code
+panels color their text with `style` attributes and its image export previews from a `blob:` url, so
+they need `style-src 'unsafe-inline'` and `img-src blob:`. A browser without constructed
+stylesheets, as Firefox before 101, gets `<style>` elements, which need `style-src 'unsafe-inline'`
+too. Without a bundler, use the [script tag](#script-tag) builds.
 
 ## Usage
 
 ```js
-import '@dineug/erd-editor';
+import '@dineug/erd-editor/erd-editor.js';
 
 const editor = document.createElement('erd-editor');
 // a custom element is inline, and the editor fills its box
@@ -57,54 +67,121 @@ editor.addEventListener('change', () => {
 });
 ```
 
+### Registering the elements
+
+`@dineug/erd-editor/erd-editor.js` defines `<erd-editor>` when imported, and
+`@dineug/erd-editor/erd-viewer.js` defines [`<erd-viewer>`](#viewer). Importing the package root
+defines neither. It exports both element classes, `ErdEditorElement` and `ErdViewerElement`, and
+`defineErdEditor()` and `defineErdViewer()`, which define their tag where you call them:
+
+```js
+import { defineErdEditor } from '@dineug/erd-editor';
+
+defineErdEditor();
+```
+
+A second call does nothing, and a call throws an `Error` naming the tag when another class already
+holds it.
+
+A bundle that holds both elements makes Vite and Rolldown warn 24 times of an
+`INEFFECTIVE_DYNAMIC_IMPORT`: the viewer loads each language but English with `import()`, and the
+editor imports every dictionary at once, so they stay in the editor's chunk and load with it.
+
+For a tag of your own, define the class yourself and add the tag to `HTMLElementTagNameMap`
+yourself, in a window that loads neither that element's entry nor its [script tag](#script-tag)
+build and calls no define function for it, since a class takes one name per window:
+
+```ts
+import { ErdEditorElement } from '@dineug/erd-editor';
+
+customElements.define('my-erd-editor', ErdEditorElement);
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'my-erd-editor': ErdEditorElement;
+  }
+}
+```
+
+### Migrating from the bare import
+
+Importing the package root used to define `<erd-editor>`. It now defines nothing, so an element
+created after that import alone is a plain `HTMLElement` without the editor's methods. Import the
+entry for its effect instead, or call `defineErdEditor()`:
+
+```diff
+-import '@dineug/erd-editor';
++import '@dineug/erd-editor/erd-editor.js';
+ import { setExportFileCallback } from '@dineug/erd-editor';
+```
+
 ### Server-side rendering
 
-Importing the package registers the element, which needs a DOM, so in Next.js, Nuxt, SvelteKit or
-Astro import it on the client:
+Every entry but [`engine.js` and `peer.js`](#headless-replica) needs a DOM, the package root too,
+since evaluating it builds both element classes. So in Next.js, Nuxt, SvelteKit or Astro import
+the element on the client:
 
 ```js
 useEffect(() => {
-  import('@dineug/erd-editor');
+  import('@dineug/erd-editor/erd-editor.js');
 }, []);
 ```
 
 ### Vite
 
-In development, keep the editor out of Vite's pre-bundling and include the ELK bundle its layout
-worker imports, or the Flow and tree layouts fail. A production build needs nothing.
+In development, include the ELK bundle the editor's layout worker imports in Vite's
+pre-bundling, or the Flow and tree layouts fail. Vite 7 and older also need the editor kept out
+of pre-bundling, since their pre-bundle points the workers' URLs at files it never writes. A
+production build needs nothing.
 
 ```js
 // vite.config.js
 export default {
   optimizeDeps: {
-    exclude: ['@dineug/erd-editor'],
     include: ['@dineug/erd-editor > elkjs/lib/elk.bundled.js'],
+    // Vite 7 and older only:
+    // exclude: ['@dineug/erd-editor'],
   },
 };
 ```
 
 ### Script tag
 
-`dist/erd-editor.umd.js` bundles every dependency and worker, registers `<erd-editor>` and puts
-`setExportFileCallback`, `setImportFileCallback` and `createKeyBindingMap` on `window.ErdEditor`.
-Its workers are `data:` URLs, so a strict CSP needs `worker-src data:`. Pin a version beyond a demo.
+Two builds bundle every dependency, so a page loads one with no bundler. Pin a version beyond a
+demo.
+
+- `dist/erd-editor.umd.js` bundles the workers too, defines `<erd-editor>` and puts
+  `setExportFileCallback`, `setImportFileCallback`, `createKeyBindingMap`, `dictionaryRowChords`,
+  `ErdEditorElement` and `defineErdEditor` on `window.ErdEditor`. Its workers are `data:` URLs, so
+  a strict CSP needs `worker-src data:`.
+- `dist/erd-viewer.umd.js` defines `<erd-viewer>` and puts `ErdViewerElement` and
+  `defineErdViewer` on `window.ErdViewer`. It starts no worker and holds all 25 languages.
+
+The package's `unpkg` and `jsdelivr` fields name the editor's file, so a CDN URL without a path
+serves the editor.
 
 ```html
 <erd-editor style="display: block; width: 100%; height: 100vh"></erd-editor>
 <script src="https://cdn.jsdelivr.net/npm/@dineug/erd-editor/dist/erd-editor.umd.js"></script>
 ```
 
+```html
+<erd-viewer src="diagram.erd.json" style="display: block; height: 480px"></erd-viewer>
+<script src="https://cdn.jsdelivr.net/npm/@dineug/erd-editor/dist/erd-viewer.umd.js"></script>
+```
+
 ## API
 
-The element's type is exported as `ErdEditorElement`. The
+`ErdEditorElement` is exported as both the element's type and its class, beside
+`defineErdEditor()` ([Registering the elements](#registering-the-elements)). The
 [Element API docs](https://docs.erd-editor.io/docs/api/erd-editor-element) cover each member in
-full.
+full. The read-only element has a section of its own, [Viewer](#viewer).
 
 ### Attributes
 
 | Attribute | Property | Description |
 | --- | --- | --- |
-| `readonly` | `readonly` | Blocks editing and `change`; only `setInitialValue()` still loads. |
+| `readonly` | `readonly` | Blocks editing and `change`; only `setInitialValue()` still loads. Takes the edit UI away and keeps navigation, export, the diff viewer and Table Properties to read; a setting the reader changes stays on their own screen. |
 | `system-dark-mode` | `systemDarkMode` | Sets the appearance to `system`. |
 | `enable-theme-builder` | `enableThemeBuilder` | Shows the theme builder and the palette's Theme. |
 | `enable-locale-picker` | `enableLocalePicker` | Shows the language button and the palette's Display Language, System by default. |
@@ -124,7 +201,7 @@ An attribute is on when present with no value or `"true"`.
 | Method | Description |
 | --- | --- |
 | `setInitialValue(value)` | Load a document with no undo entry; `''` starts a new one. |
-| `getSchemaSQL(vendor?, options?)` | DDL for one of the eight databases, by default the document's. `options`: `statements` (`create`, `ifNotExists`, `recreate`), `header` (`none`, `use`, `createAndUse`). |
+| `getSchemaSQL(vendor?, options?)` | DDL for one of the eight databases, by default the one this editor shows (the document's, unless a readonly reader picked another), always in the bracket it shows. `options`: `statements` (`create`, `ifNotExists`, `recreate`), `header` (`none`, `use`, `createAndUse`), `logicalNameAsComment` (`true` writes a table's or column's logical name where its comment is empty). |
 | `setSchemaSQL(value, options?)`, `setSchemaGraphQL`, `setSchemaDBML`, `setSchemaAML` | Replace the document with parsed DDL, GraphQL SDL, DBML or AML, or append it ([Importing a schema](#importing-a-schema)). |
 | `setSchemaJSON(value, options?)` | Load an `.erd.json` document as `value` does, or append it. |
 | `setDiffValue(value)` | Diff another document over the ERD tab. |
@@ -152,7 +229,8 @@ An attribute is on when present with no value or `"true"`.
 - Save `value`. `runtimeValue` also keeps removed entities and only seeds a
   [collaborator](#collaboration).
 - `change` fires 200 ms after the last change, never under `readonly`, and never for scroll, zoom,
-  the open tab or the code settings while the document locks them, which a new document does.
+  the open tab, the name view or the code settings while the document locks them, which a new
+  document does.
 - A file written by hand or by another release can differ from `value` once loaded, so detect edits
   with a [replica](#headless-replica)'s `changed`, not by comparing bytes.
 
@@ -163,12 +241,105 @@ An attribute is on when present with no value or `"true"`.
 - `'grid'`, the default, lands at once in rows. `'auto'` lays the tables out as the Import menu does
   and returns a `Promise` that resolves when they land; a later load supersedes it.
 - `mode: 'append'` adds the tables below the diagram, as Import and Add does.
+- A replace by the four text methods keeps the document's word, term and domain dictionaries, which
+  the text cannot hold; a replacing `setSchemaJSON` takes the ones its document holds, as `value`
+  does.
 
 ### Theme and language
 
 The element starts dark and English and stores neither choice: `setPresetTheme` and `setLocale`
 set them, and your host keeps what `changePresetTheme` and `changeLocale` report.
 
+## Viewer
+
+`<erd-viewer>` shows a document read-only: a reader pans, zooms, searches and lights relationships,
+and nothing in it edits. It renders into a closed shadow root as the editor does, and several on one
+page each keep their own document and view.
+
+```js
+import '@dineug/erd-editor/erd-viewer.js';
+```
+
+```html
+<erd-viewer src="/diagrams/shop.erd.json" style="display: block; height: 480px"></erd-viewer>
+```
+
+A page that cannot load the element can frame the hosted viewer,
+`https://erd-editor.io/embed?src=…`, instead; the hosted viewer also takes a file or gist on GitHub
+by the address its page shows, from public repositories and public gists only, fetched from
+GitHub's raw host with its five-minute cache.
+
+### Viewer attributes and properties
+
+| Attribute | Property | Description |
+| --- | --- | --- |
+| `src` | `src` | The URL of a document as an `.erd.json` file saves it, in no other format, fetched with `GET` under the browser's CORS rules. |
+| `name-view` | `nameView` | `physical`, `logical` or `both`, shown over the name view the document saves, which `value` keeps. |
+| `minimap` | `minimap` | The minimap, which shows while the document has content. |
+| `controls` | `controls` | The controls bar: zoom out, the zoom level, which resets it, zoom in, Fit, the name view list, and an arrow to the nearest part of the diagram while none of it is on screen. |
+
+`minimap` and `controls` are on unless their value is `"false"`.
+
+| Property | Description |
+| --- | --- |
+| `value: string` | The document as an `.erd.json` file saves it, as the editor's `value` does: while the document locks its viewport, which a new document does, it keeps the zoom and scroll the file saved, and only with that lock off holds the reader's. Assigning one shows it and throws on text that does not parse; `''` shows an empty diagram. |
+
+Whichever of `value` and `src` is set last wins, so assigning `value` cancels a fetch still
+running. A `value`, `src`, `nameView`, `minimap` or `controls` set on the element before its tag is
+defined is taken up once it is, over the attributes its markup gave it.
+
+### Viewer methods
+
+| Method | Description |
+| --- | --- |
+| `setPresetTheme(options)` | Set `appearance` (`light`, `dark`, `system`), `grayColor` and `accentColor`. |
+| `setSystemAppearance(appearance)` | Name the light or dark `system` shows; `null` follows the OS. |
+| `setTheme(theme)` | Override theme tokens; each call replaces the earlier overrides. |
+| `setLocale(locale)` | Set the display language, `'system'` or a [code](#display-language). The `Promise` it returns resolves once that language's dictionary has loaded or failed to. |
+| `setSystemLocale(tag)` | Name the BCP 47 language `system` shows; `null` goes back to the page's languages. It resolves as `setLocale` does. |
+| `destroy()` | Take the view down, abort a fetch and stop watching the OS color scheme and the page's styles. A destroyed viewer draws nothing more, even when added to the page again. |
+
+### Viewer events
+
+| Event | Description |
+| --- | --- |
+| `load` | The document `src` names was fetched and shown. Assigning `value` fires none. |
+| `error` | Fetching `src`, its response or its document failed; `event.detail` holds the cause. The viewer shows an empty diagram and a notice. |
+
+### Loading, focus and language
+
+- **Loading.** A notice over the canvas shows while `src` loads and once it failed. A new `src`
+  aborts the fetch before it, removing the viewer from the page aborts the one running, and a
+  viewer put back fetches a `src` it has not shown. Each document is fitted to the viewer's box
+  as it lands, the zoom and scroll the file saved left aside.
+- **Focus.** The viewer takes no focus as it mounts. Until a click, a tap or the Tab key focuses
+  it, the wheel and a swipe from empty canvas scroll the page, a trackpad pinch passes to the
+  page, a finger pans nothing, and it answers no key. Once focused, the wheel pans it (`Shift`
+  across) and so does a finger, `Ctrl`/`Cmd` with the wheel or a pinch zooms, `Ctrl`/`Cmd`+`=`,
+  `-` and `0` zoom in, out and back, and `Ctrl`/`Cmd`+`K` opens a palette that searches the
+  document: `#` tables, `@` columns and `:` comments and memos. A mouse drag pans and a still click
+  or tap lights relationships, focused or not: a table's, or the one clicked; the table the pointer
+  rests on lights its own.
+- **Theme and language.** Both start on `system`: the OS color scheme, and the page's
+  `<html lang>`, then `navigator.languages`, read once as the viewer first connects. English is in
+  the entry. Each other language is a chunk of its own, which your bundler emits and the viewer
+  loads once a page asks for it, showing English until it lands and keeping English if it fails.
+  The palette and the notices follow a right-to-left language; the canvas and the controls stay
+  left to right.
+
+### What it adds to a page
+
+- `src` is the one `fetch` the package makes, so a strict CSP lists its origin in `connect-src`.
+  Besides it, a viewer requests only the dictionary chunk of a language other than English, from
+  your own bundle. Its styles are constructed stylesheets, which a strict CSP lets through, but for
+  a browser without them, which gets `<style>` elements.
+- It starts no worker and writes no storage. Importing it adds three listeners to `window` for
+  the life of the page, for `mousedown`, `touchstart` and an event of the package's own,
+  `@dineug/erd-editor/internal-forward-move-start`, and Konva, which draws the canvas, sets
+  `window.Konva` and, with its first stage, adds mouse and touch listeners to `window` and a
+  `visibilitychange` listener to `document`, which it never removes. The editor's entry adds the
+  same.
+
 ## Collaboration
 
 A joiner starts from the first editor's `runtimeValue`, then each relays its actions:
@@ -194,6 +365,10 @@ names. A chord is modifiers (`Shift`, `Alt`, `Control`, `Meta`, or `$mod` for Cm
 elsewhere) joined by `+` with a `KeyboardEvent.code` or `key`; a space separates the chords of a
 sequence, such as `KeyT KeyG`. Several defaults, search and find and replace among them, stop the
 keydown, so to leave `$mod+KeyF` to the page, call `setKeyBindingMap({ findReplace: [] })`.
+`dictionaryRowChords(map)` lists the chords the Dictionary tab's grid inserts and deletes rows by
+under a map: the one-press chords of `addColumn` and `removeColumn`, and those of `addColumn` with
+`Shift` held as well, for Insert above, which no binding names. A host that keeps its own hotkeys
+off the editor's keys takes both lists.
 
 ## Display language
 
@@ -229,7 +404,33 @@ setImportFileCallback(async ({ type, op, accept, mode }) => {
 ```
 
 Skip a `type` you do not handle: a replacing `setSchemaJSON()` empties the document on any other
-payload. Unset or `null`, the browser's download and file picker work.
+payload. Unset or `null`, the browser's download and file picker work. The Dictionary tab's Import
+CSV always opens the browser's file picker, since no `type` names CSV, and its Export CSV goes
+through the export callback.
+
+## Images
+
+`toImage()` draws a document, the text a `value` holds, as a PNG `Blob` or an SVG string, with the
+Export image dialog's options. It draws the whole document at 100%, whatever zoom it was saved at,
+and needs a browser: it measures and draws on a canvas, in a `SharedWorker` where there is one.
+
+```js
+import { toImage } from '@dineug/erd-editor';
+
+const png = await toImage(value, { format: 'png', scale: 3 });
+const svg = await toImage(value, { format: 'svg', darkMode: true, background: false });
+```
+
+| Option | Default | Description |
+| --- | --- | --- |
+| `format` | | `'png'` resolves to a `Blob`, `'svg'` to a string. |
+| `background` | `true` | Paint the canvas color behind the diagram; `false` leaves it transparent. |
+| `darkMode` | `false` | Draw the dark theme in place of the light one. |
+| `scale` | `2` | `1`, `2` or `3` image pixels per unit, PNG only; cut to what a canvas holds. |
+
+It rejects text that does not parse, as the viewer's `value` does, and a value outside the table,
+and reads no other option. Empty text, or JSON with none of a document's fields, draws an empty
+diagram. The words the diagram draws itself, such as an unnamed table's placeholder, are English.
 
 ## Headless replica
 

package/dist/_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/assertClassBrand.js

@@ -0,0 +1,7 @@
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/assertClassBrand.js
+function _assertClassBrand(e, t, n) {
+	if ("function" == typeof e ? e === t : e.has(t)) return arguments.length < 3 ? t : n;
+	throw new TypeError("Private element is not present on this object");
+}
+//#endregion
+export { _assertClassBrand as default };

package/dist/_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/checkPrivateRedeclaration.js

@@ -0,0 +1,6 @@
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/checkPrivateRedeclaration.js
+function _checkPrivateRedeclaration(e, t) {
+	if (t.has(e)) throw new TypeError("Cannot initialize the same private elements twice on an object");
+}
+//#endregion
+export { _checkPrivateRedeclaration as default };

package/dist/_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/classPrivateFieldGet2.js

@@ -0,0 +1,7 @@
+import _assertClassBrand from "./assertClassBrand.js";
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/classPrivateFieldGet2.js
+function _classPrivateFieldGet2(s, a) {
+	return s.get(_assertClassBrand(s, a));
+}
+//#endregion
+export { _classPrivateFieldGet2 as default };

package/dist/_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/classPrivateFieldInitSpec.js

@@ -0,0 +1,7 @@
+import _checkPrivateRedeclaration from "./checkPrivateRedeclaration.js";
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/classPrivateFieldInitSpec.js
+function _classPrivateFieldInitSpec(e, t, a) {
+	_checkPrivateRedeclaration(e, t), t.set(e, a);
+}
+//#endregion
+export { _classPrivateFieldInitSpec as default };

package/dist/_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/classPrivateFieldSet2.js

@@ -0,0 +1,7 @@
+import _assertClassBrand from "./assertClassBrand.js";
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/classPrivateFieldSet2.js
+function _classPrivateFieldSet2(s, a, r) {
+	return s.set(_assertClassBrand(s, a), r), r;
+}
+//#endregion
+export { _classPrivateFieldSet2 as default };

package/dist/_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/defineProperty.js

@@ -0,0 +1,12 @@
+import toPropertyKey from "./toPropertyKey.js";
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+//#endregion
+export { _defineProperty as default };

package/dist/_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/toPrimitive.js

@@ -0,0 +1,14 @@
+import _typeof from "./typeof.js";
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+//#endregion
+export { toPrimitive as default };

package/dist/_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/toPropertyKey.js

@@ -0,0 +1,9 @@
+import _typeof from "./typeof.js";
+import toPrimitive from "./toPrimitive.js";
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+//#endregion
+export { toPropertyKey as default };

package/dist/_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/typeof.js

@@ -0,0 +1,11 @@
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
+		return typeof o;
+	} : function(o) {
+		return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
+	}, _typeof(o);
+}
+//#endregion
+export { _typeof as default };

package/dist/_virtual/_rolldown/runtime.js

@@ -0,0 +1,13 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+export { __exportAll };

package/dist/components/appContext.js

@@ -0,0 +1,45 @@
+import { createKeyBindingMap } from "../utils/keyboard-shortcut/index.js";
+import { createContext } from "../r-html/dist/context/createContext.js";
+import { observable } from "../r-html/dist/observable/index.js";
+import { useContext } from "../r-html/dist/context/useContext.js";
+import { initialClearAction } from "../engine/modules/editor/atom.actions.js";
+import { actions } from "../engine/actions.js";
+import { createEngineContext } from "../engine/context.js";
+import { createRxStore } from "../engine/rx-store.js";
+import { Emitter } from "../utils/emitter.js";
+import { Subject } from "rxjs";
+//#region src/components/appContext.ts
+function createAppContext(ctx, options) {
+	const { devtools = true, ...storeOptions } = options ?? {};
+	const engineContext = createEngineContext(ctx);
+	const store = createRxStore(engineContext, storeOptions);
+	const keyBindingMap = observable(createKeyBindingMap(), { shallow: true });
+	const shortcut$ = new Subject();
+	const keydown$ = new Subject();
+	const emitter = new Emitter();
+	return Object.freeze({
+		...engineContext,
+		actions,
+		store,
+		keyBindingMap,
+		shortcut$,
+		keydown$,
+		emitter,
+		lifecycle: { destroyed: false }
+	});
+}
+var appContext = createContext({});
+var useAppContext = (ctx, fallback) => useContext(ctx, {
+	...appContext,
+	value: fallback ?? appContext.value
+});
+function appDestroy(app) {
+	app.lifecycle.destroyed = true;
+	app.store.dispatchSync(initialClearAction());
+	app.store.destroy();
+	app.keydown$.complete();
+	app.shortcut$.complete();
+	app.emitter.clear();
+}
+//#endregion
+export { appContext, appDestroy, createAppContext, useAppContext };

package/dist/components/customElementClass.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The type an exported element class carries, written here rather than taken
+ * from @dineug/r-html, which the build inlines, so a declaration file names it
+ * without an import no consumer can resolve.
+ */
+export interface CustomElementClass<C extends HTMLElement = HTMLElement> {
+    new (): C;
+    readonly observedAttributes: string[];
+}
+//# sourceMappingURL=customElementClass.d.ts.map

package/dist/components/dictionary/Dictionary.d.ts

@@ -0,0 +1,12 @@
+import { FC } from '@dineug/r-html';
+export type DictionaryProps = {
+    readonly: boolean;
+};
+/**
+ * The Dictionary tab: the sheet switch, the search and the row and file tools
+ * over a grid of the sheet shown, and its row count and selection under it.
+ * Every edit, paste or clear the grid commits is one dispatch and one undo.
+ */
+declare const Dictionary: FC<DictionaryProps>;
+export default Dictionary;
+//# sourceMappingURL=Dictionary.d.ts.map