@openleaf-editor/ui 0.1.0-beta.0

package/dist/openleaf.css

@@ -0,0 +1,426 @@
+.ol-editor {
+  /* Two families, named before either is public API. A singular
+     `--openleaf-font` implies "the" font, and source view already has a
+     monospace surface -- bolting a mono token on beside a singular name later
+     is the awkward outcome worth avoiding now. `--openleaf-font` is still
+     honoured as a fallback. */
+  --ol-font: var(--openleaf-font-ui, var(--openleaf-font, system-ui, -apple-system, "Segoe UI", sans-serif));
+  --ol-font-mono: var(--openleaf-font-mono, ui-monospace, SFMono-Regular, Menlo, Consolas, monospace);
+  --ol-font-size: var(--openleaf-font-size, 14px);
+  --ol-radius: var(--openleaf-radius, 4px);
+  --ol-text: var(--openleaf-color-text, #1f2328);
+  --ol-text-muted: var(--openleaf-color-text-muted, #59636e);
+  --ol-surface: var(--openleaf-color-surface, #ffffff);
+  --ol-surface-hover: var(--openleaf-color-surface-hover, #f0f1f3);
+  --ol-surface-active: var(--openleaf-color-surface-active, #dbe9ff);
+  --ol-border: var(--openleaf-color-border, #d1d9e0);
+  --ol-accent: var(--openleaf-color-accent, #0550ae);
+  --ol-focus: var(--openleaf-color-focus, #0969da);
+  --ol-button-size: var(--openleaf-button-size, 32px);
+  --ol-icon-size: var(--openleaf-icon-size, 16px);
+  --ol-gap: var(--openleaf-gap, 2px);
+  /* A 2009 WordPress admin bar sits at z-index 99999 and Drupal's toolbar plays
+     similar games. Without a sanctioned escape hatch integrators fix a toolbar
+     rendered behind a sticky host header with !important -- the exact thing the
+     token API exists to prevent. */
+  --ol-z: var(--openleaf-z-index, 1);
+  /* Thickness and offset, not just colour: "you can change the colour but not
+     the thickness" is a poor answer to a Section 508 team citing WCAG 2.2
+     Focus Appearance. */
+  --ol-focus-width: var(--openleaf-focus-width, 2px);
+  --ol-focus-offset: var(--openleaf-focus-offset, 1px);
+
+  display: block;
+  color: var(--ol-text);
+}
+
+/* Three ways into the dark palette, and one way out of it.
+   `data-ol-scheme` is set from the applied skin's declared scheme, and a skin
+   that declares one outranks both the attribute and the system -- it has to,
+   because its tokens have already replaced the palette outright. Without the
+   `:not()` guards a light skin on a dark machine would take these fallbacks for
+   every token it did not itself set, which is a light surface carrying dark-mode
+   muted text. */
+@media (prefers-color-scheme: dark) {
+  .ol-editor:not([data-ol-theme="light"]):not([data-ol-scheme]) {
+  --ol-text: var(--openleaf-color-text, #e6edf3);
+  --ol-text-muted: var(--openleaf-color-text-muted, #9198a1);
+  --ol-surface: var(--openleaf-color-surface, #0d1117);
+  --ol-surface-hover: var(--openleaf-color-surface-hover, #21262d);
+  --ol-surface-active: var(--openleaf-color-surface-active, #1f3a5f);
+  --ol-border: var(--openleaf-color-border, #3d444d);
+  --ol-accent: var(--openleaf-color-accent, #79c0ff);
+  --ol-focus: var(--openleaf-color-focus, #79c0ff);
+}
+}
+
+.ol-editor[data-ol-theme="dark"]:not([data-ol-scheme]) {
+  --ol-text: var(--openleaf-color-text, #e6edf3);
+  --ol-text-muted: var(--openleaf-color-text-muted, #9198a1);
+  --ol-surface: var(--openleaf-color-surface, #0d1117);
+  --ol-surface-hover: var(--openleaf-color-surface-hover, #21262d);
+  --ol-surface-active: var(--openleaf-color-surface-active, #1f3a5f);
+  --ol-border: var(--openleaf-color-border, #3d444d);
+  --ol-accent: var(--openleaf-color-accent, #79c0ff);
+  --ol-focus: var(--openleaf-color-focus, #79c0ff);
+}
+
+.ol-editor[data-ol-scheme="dark"] {
+  --ol-text: var(--openleaf-color-text, #e6edf3);
+  --ol-text-muted: var(--openleaf-color-text-muted, #9198a1);
+  --ol-surface: var(--openleaf-color-surface, #0d1117);
+  --ol-surface-hover: var(--openleaf-color-surface-hover, #21262d);
+  --ol-surface-active: var(--openleaf-color-surface-active, #1f3a5f);
+  --ol-border: var(--openleaf-color-border, #3d444d);
+  --ol-accent: var(--openleaf-color-accent, #79c0ff);
+  --ol-focus: var(--openleaf-color-focus, #79c0ff);
+}
+
+/* Native widget chrome -- the popup a `select` opens, scrollbars, the caret,
+   form control backgrounds -- is painted by the browser from `color-scheme`,
+   not from any property we can hand an integrator. Left alone it follows the
+   page, which is right while the editor's own palette also follows the page and
+   wrong the moment either attribute pins the editor to one world. So it is set
+   exactly when the editor stops following along, and inherited from the host
+   otherwise. */
+.ol-editor[data-ol-theme="light"] { color-scheme: light; }
+.ol-editor[data-ol-theme="dark"] { color-scheme: dark; }
+.ol-editor[data-ol-scheme="light"] { color-scheme: light; }
+.ol-editor[data-ol-scheme="dark"] { color-scheme: dark; }
+
+/* Wrapping, not scrolling and not an overflow menu. Both of those hide
+   controls -- one off-screen, one behind a click -- and a formatting control
+   the author cannot see is a control they do not have. */
+.ol-editor .ol-toolbar {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: var(--ol-gap);
+  box-sizing: border-box;
+  margin: 0;
+  padding: 4px;
+  border: 1px solid var(--ol-border);
+  border-bottom: 0;
+  border-radius: var(--ol-radius) var(--ol-radius) 0 0;
+  background: var(--ol-surface);
+  font: inherit;
+  position: relative;
+  z-index: var(--ol-z);
+}
+
+.ol-editor .ol-group {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: var(--ol-gap);
+}
+
+/* The divider is a BORDER on the group, not a standalone flex item.
+   As its own element it could wrap onto the trailing edge of a row with nothing
+   after it -- a stranded line floating at the end of a row. Wrapping begins
+   around 690-740px, well inside ordinary desktop widths (a CMS sidebar, a
+   half-width split pane), so this was not a 360px-only edge case.
+   border-inline-start rather than border-left, so it flips under RTL. */
+.ol-editor .ol-group + .ol-group {
+  border-inline-start: 1px solid var(--ol-border);
+  padding-inline-start: 5px;
+  margin-inline-start: 1px;
+}
+
+/* Every property a host reset or `button {}` rule is likely to touch is set
+   here explicitly. Specificity is (0,2,0) via the descendant selector, which
+   beats a bare element or single-class host rule without resorting to
+   !important. */
+.ol-editor .ol-btn {
+  box-sizing: border-box;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex: 0 0 auto;
+  width: var(--ol-button-size);
+  height: var(--ol-button-size);
+  min-width: var(--ol-button-size);
+  min-height: var(--ol-button-size);
+  max-width: none;
+  padding: 0;
+  margin: 0;
+  border: 1px solid transparent;
+  border-radius: var(--ol-radius);
+  background: transparent;
+  color: var(--ol-text);
+  font: inherit;
+  font-family: var(--ol-font);
+  font-size: var(--ol-font-size);
+  font-weight: 400;
+  line-height: 1;
+  letter-spacing: normal;
+  text-transform: none;
+  text-align: center;
+  text-decoration: none;
+  text-shadow: none;
+  box-shadow: none;
+  opacity: 1;
+  cursor: pointer;
+  appearance: none;
+  -webkit-appearance: none;
+  outline-offset: var(--ol-focus-offset);
+  -webkit-tap-highlight-color: transparent;
+  transition: background-color 120ms ease, border-color 120ms ease;
+}
+
+.ol-editor .ol-btn:hover {
+  background: var(--ol-surface-hover);
+}
+
+/* :focus-visible only, so a mouse click does not leave a ring behind, but the
+   ring is never removed for keyboard users. */
+.ol-editor .ol-btn:focus-visible {
+  outline: var(--ol-focus-width) solid var(--ol-focus);
+  outline-offset: var(--ol-focus-offset);
+}
+
+/* Pressed state is distinguished from hover by THREE signals, not just colour:
+   a filled background, a visible border, and an inset shadow that reads as
+   physically depressed. Colour alone would fail for a colour-blind author and
+   would be invisible in forced-colours mode. */
+.ol-editor .ol-btn[aria-pressed="true"] {
+  background: var(--ol-surface-active);
+  border-color: var(--ol-accent);
+  color: var(--ol-accent);
+  box-shadow: inset 0 1px 2px rgb(0 0 0 / 12%);
+}
+
+.ol-editor .ol-btn[aria-pressed="true"]:hover {
+  background: var(--ol-surface-active);
+  border-color: var(--ol-accent);
+}
+
+/* aria-disabled rather than the disabled attribute: a disabled button is
+   removed from the roving tabindex and cannot be reached or announced, so an
+   author using a screen reader cannot discover that the control exists. */
+.ol-editor .ol-btn[aria-disabled="true"] {
+  opacity: 0.4;
+  cursor: default;
+}
+
+.ol-editor .ol-btn[aria-disabled="true"]:hover {
+  background: transparent;
+}
+
+.ol-editor .ol-icon {
+  width: var(--ol-icon-size);
+  height: var(--ol-icon-size);
+  display: block;
+  pointer-events: none;
+  flex: 0 0 auto;
+}
+
+/* Block-type select. Sized and coloured to sit level with the icon buttons so
+   it does not read as bolted on, but it stays a native <select> -- a custom
+   listbox is a large amount of ARIA that would then owe real screen reader
+   testing to be worth anything. */
+.ol-editor .ol-select {
+  box-sizing: border-box;
+  height: var(--ol-button-size);
+  max-width: 11em;
+  padding: 0 22px 0 6px;
+  margin: 0;
+  border: 1px solid var(--ol-border);
+  border-radius: var(--ol-radius);
+  background-color: transparent;
+  background-image: linear-gradient(45deg, transparent 50%, currentColor 50%),
+    linear-gradient(135deg, currentColor 50%, transparent 50%);
+  background-position: right 10px center, right 6px center;
+  background-size: 4px 4px, 4px 4px;
+  background-repeat: no-repeat;
+  color: var(--ol-text);
+  font-family: var(--ol-font);
+  font-size: var(--ol-font-size);
+  font-weight: 400;
+  line-height: 1;
+  text-transform: none;
+  letter-spacing: normal;
+  box-shadow: none;
+  cursor: pointer;
+  appearance: none;
+  -webkit-appearance: none;
+}
+
+.ol-editor .ol-select:hover {
+  background-color: var(--ol-surface-hover);
+}
+
+.ol-editor .ol-select:focus-visible {
+  outline: var(--ol-focus-width) solid var(--ol-focus);
+  outline-offset: var(--ol-focus-offset);
+}
+
+/* The option list is painted by the OS, which does not inherit our tokens, so
+   give it explicit colours or dark mode shows black text on black. */
+.ol-editor .ol-select option {
+  background: var(--ol-surface);
+  color: var(--ol-text);
+}
+
+.ol-editor .ol-content {
+  box-sizing: border-box;
+  border: 1px solid var(--ol-border);
+  border-radius: 0 0 var(--ol-radius) var(--ol-radius);
+  background: var(--ol-surface);
+}
+
+/* Deliberately minimal: the content area inherits the host's typography, which
+   is the entire reason this project does not use Shadow DOM. Only padding and
+   the focus ring are ours. */
+.ol-editor .ol-content .ProseMirror {
+  padding: 12px;
+  min-height: 8rem;
+  outline: none;
+}
+
+.ol-editor .ol-content:focus-within {
+  outline: 2px solid var(--ol-focus);
+  outline-offset: -1px;
+}
+
+/* Tables.
+   These styles live in core, not in the opt-in table plugin, because table
+   NODES live in core: every deployment reads and renders tables even where
+   editing them is switched off. Unstyled tables would render as runs of
+   undelimited text. */
+.ol-editor .ol-content .ProseMirror table {
+  border-collapse: collapse;
+  table-layout: fixed;
+  width: 100%;
+  margin: 0 0 1em;
+  overflow: hidden;
+}
+
+.ol-editor .ol-content .ProseMirror td,
+.ol-editor .ol-content .ProseMirror th {
+  border: 1px solid var(--ol-border);
+  padding: 6px 8px;
+  vertical-align: top;
+  /* A zero-width cell cannot be clicked into, so it cannot be repaired. */
+  min-width: 2em;
+  position: relative;
+}
+
+.ol-editor .ol-content .ProseMirror th {
+  background: var(--ol-surface-hover);
+  font-weight: 600;
+  text-align: start;
+}
+
+/* prosemirror-tables marks cells in a rectangular selection with this class.
+   An ::after overlay rather than a background so it composes with a cell that
+   already has one, and so a header cell still reads as a header. */
+.ol-editor .ol-content .ProseMirror .selectedCell::after {
+  content: "";
+  position: absolute;
+  inset: 0;
+  background: var(--ol-surface-active);
+  opacity: 0.4;
+  pointer-events: none;
+}
+
+/* The column resize handle, drawn by prosemirror-tables' columnResizing. */
+.ol-editor .ol-content .ProseMirror .column-resize-handle {
+  position: absolute;
+  right: -2px;
+  top: 0;
+  bottom: 0;
+  width: 4px;
+  background: var(--ol-accent);
+  pointer-events: none;
+  z-index: 20;
+}
+
+.ol-editor .ol-content .ProseMirror.resize-cursor {
+  cursor: col-resize;
+}
+
+/* Preserved-but-unrecognised markup, surfaced rather than hidden. */
+.ol-editor .ol-content .ProseMirror-selectednode {
+  outline: 2px solid var(--ol-focus);
+  outline-offset: 2px;
+  border-radius: 2px;
+}
+
+.ol-editor .ol-source {
+  box-sizing: border-box;
+  display: block;
+  width: 100%;
+  min-height: 12rem;
+  padding: 12px;
+  border: 1px solid var(--ol-border);
+  border-radius: 0 0 var(--ol-radius) var(--ol-radius);
+  background: var(--ol-surface);
+  color: var(--ol-text);
+  font-family: var(--ol-font-mono);
+  font-size: 13px;
+  line-height: 1.5;
+  resize: vertical;
+  white-space: pre-wrap;
+}
+
+/* Directional icons under RTL.
+   Group order reverses for free with flexbox, but a curved undo arrow does not:
+   in an RTL document "back" points the other way. Only genuinely directional
+   icons are flipped -- bold and italic must not be mirrored. */
+.ol-editor[dir="rtl"] .ol-icon--directional,
+[dir="rtl"] .ol-editor .ol-icon--directional {
+  transform: scaleX(-1);
+}
+
+/* The announcement region. Visually hidden but not display:none, which would
+   remove it from the accessibility tree and silence it. */
+.ol-editor .ol-live {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  margin: -1px;
+  padding: 0;
+  overflow: hidden;
+  clip: rect(0 0 0 0);
+  clip-path: inset(50%);
+  white-space: nowrap;
+  border: 0;
+}
+
+/* Coarse pointers get a larger target. WCAG 2.2 SC 2.5.8 asks for 24x24 CSS px
+   minimum; 32 clears that on a mouse and 40 is comfortable on a thumb. */
+@media (pointer: coarse) {
+  .ol-editor {
+    --ol-button-size: var(--openleaf-button-size, 40px);
+    --ol-gap: var(--openleaf-gap, 4px);
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .ol-editor .ol-btn {
+    transition: none;
+  }
+}
+
+/* Forced colours (Windows high contrast) replaces our palette wholesale. The
+   pressed state must not depend on a background we no longer control, so it is
+   re-expressed as a border, which the mode preserves. */
+@media (forced-colors: active) {
+  .ol-editor .ol-btn {
+    border-color: ButtonBorder;
+    color: ButtonText;
+  }
+  .ol-editor .ol-btn[aria-pressed="true"] {
+    border-color: Highlight;
+    color: Highlight;
+    box-shadow: none;
+  }
+  .ol-editor .ol-btn:focus-visible {
+    outline-color: Highlight;
+  }
+  .ol-editor .ol-btn[aria-disabled="true"] {
+    color: GrayText;
+    opacity: 1;
+  }
+}

package/dist/registry.d.ts

@@ -0,0 +1,85 @@
+/**
+ * The toolbar item registry.
+ *
+ * The extension point exists now, before any plugin needs it, because
+ * retrofitting one later means either a breaking change or a second parallel
+ * mechanism. `@openleaf-editor/plugins-table` will call `registerToolbarItem` at import
+ * time and the toolbar will pick it up without ever importing the plugin.
+ *
+ * Two responsibilities are deliberately split:
+ *
+ *   A plugin declares CAPABILITY -- here is a button, here is what it does,
+ *   here is when it is active.
+ *   An integrator declares LAYOUT -- via the `toolbar` attribute, which names
+ *   item ids and separators in the order they want them.
+ *
+ * So installing a plugin never silently rearranges somebody's toolbar, and an
+ * integrator can omit a registered item without uninstalling anything.
+ */
+import type { Command, EditorState } from 'prosemirror-state';
+import type { EditorView } from 'prosemirror-view';
+import type { IconName } from './icons.js';
+/** What a custom `run` handler receives. */
+export interface ToolbarContext {
+    view: EditorView;
+    /** The `<openleaf-editor>` element, for dispatching events or hosting dialogs. */
+    host: HTMLElement;
+}
+export interface ToolbarItemSpec {
+    /** Stable id used in the `toolbar` layout attribute. */
+    id: string;
+    /**
+     * What kind of control this is.
+     *
+     * Present from day one even though **only `button` is implemented** -- the
+     * block-type control is special-cased by id, not by type. A flat spec models
+     * a button and nothing else, and adding this discriminant *after* the config
+     * shape is public is precisely the breaking change the registry exists to
+     * avoid. Colour grids, table-insert popovers and link editors will all be
+     * `custom`.
+     *
+     * Declaring an unimplemented variant logs a warning rather than failing
+     * quietly as a button.
+     */
+    type?: 'button' | 'select' | 'custom';
+    /** Accessible name. Kept constant across states -- the platform announces pressed. */
+    label: string;
+    icon?: IconName;
+    /**
+     * `toggle` gets `aria-pressed` and reflects `isActive`. `action` does not:
+     * marking Undo as "pressed" is meaningless and screen readers say so.
+     */
+    kind?: 'toggle' | 'action';
+    /** A plain ProseMirror command. Its no-dispatch call also drives enabled state. */
+    command?: Command;
+    /** For items needing more than the editor state -- dialogs, mode switches. */
+    run?: (ctx: ToolbarContext) => void;
+    isActive?: (state: EditorState) => boolean;
+    /** Defaults to asking `command` whether it would apply. */
+    isEnabled?: (state: EditorState) => boolean;
+    /** Label to look up in the core shortcut table, for the tooltip. */
+    shortcut?: string;
+}
+export declare function onRegistryChange(listener: () => void): () => void;
+/**
+ * Register a toolbar item. Last registration for an id wins, which lets an
+ * integrator replace a built-in (a different link dialog, say) without forking.
+ */
+export declare function registerToolbarItem(spec: ToolbarItemSpec): void;
+export declare function getToolbarItem(id: string): ToolbarItemSpec | undefined;
+export declare function allToolbarItems(): ToolbarItemSpec[];
+/** Testing seam. Not part of the public API. */
+export declare function clearToolbarItems(): void;
+/**
+ * The default layout. `|` is a separator.
+ *
+ * Order reasoning: history sits leftmost because it is the control an author
+ * reaches for under stress and muscle memory puts it at the start of the bar in
+ * every office application. Block type comes next because choosing what a
+ * paragraph *is* precedes decorating it. Then character marks, then block
+ * structure, then insertions, and finally source view -- the one control that
+ * changes the editor's mode rather than the document, kept away from the rest
+ * so it is not hit by accident.
+ */
+export declare const DEFAULT_LAYOUT: string;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1C,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAA;IAChB,kFAAkF;IAClF,IAAI,EAAE,WAAW,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAA;IACV;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACrC,sFAAsF;IACtF,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAC1B,mFAAmF;IACnF,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,8EAA8E;IAC9E,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,CAAA;IACnC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAA;IAC1C,2DAA2D;IAC3D,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAA;IAC3C,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAcD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAGjE;AAcD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAG/D;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEtE;AAED,wBAAgB,eAAe,IAAI,eAAe,EAAE,CAEnD;AAED,gDAAgD;AAChD,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,QAEgE,CAAA"}

package/dist/registry.js

@@ -0,0 +1,77 @@
+/**
+ * The toolbar item registry.
+ *
+ * The extension point exists now, before any plugin needs it, because
+ * retrofitting one later means either a breaking change or a second parallel
+ * mechanism. `@openleaf-editor/plugins-table` will call `registerToolbarItem` at import
+ * time and the toolbar will pick it up without ever importing the plugin.
+ *
+ * Two responsibilities are deliberately split:
+ *
+ *   A plugin declares CAPABILITY -- here is a button, here is what it does,
+ *   here is when it is active.
+ *   An integrator declares LAYOUT -- via the `toolbar` attribute, which names
+ *   item ids and separators in the order they want them.
+ *
+ * So installing a plugin never silently rearranges somebody's toolbar, and an
+ * integrator can omit a registered item without uninstalling anything.
+ */
+const registry = new Map();
+/**
+ * Registry change notifications.
+ *
+ * Import-time registration races code-split plugins: if a lazily loaded chunk
+ * resolves after a toolbar has already read the registry and rendered, its
+ * button would silently never appear. Toolbars subscribe and re-render instead
+ * of reading once at mount.
+ */
+const listeners = new Set();
+export function onRegistryChange(listener) {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+}
+function notify() {
+    // Isolated per listener: one toolbar failing to re-render must not stop the
+    // others, and must not propagate into the plugin that registered the item.
+    for (const listener of listeners) {
+        try {
+            listener();
+        }
+        catch (error) {
+            console.error('@openleaf-editor/ui: a toolbar failed to re-render', error);
+        }
+    }
+}
+/**
+ * Register a toolbar item. Last registration for an id wins, which lets an
+ * integrator replace a built-in (a different link dialog, say) without forking.
+ */
+export function registerToolbarItem(spec) {
+    registry.set(spec.id, spec);
+    notify();
+}
+export function getToolbarItem(id) {
+    return registry.get(id);
+}
+export function allToolbarItems() {
+    return [...registry.values()];
+}
+/** Testing seam. Not part of the public API. */
+export function clearToolbarItems() {
+    registry.clear();
+    notify();
+}
+/**
+ * The default layout. `|` is a separator.
+ *
+ * Order reasoning: history sits leftmost because it is the control an author
+ * reaches for under stress and muscle memory puts it at the start of the bar in
+ * every office application. Block type comes next because choosing what a
+ * paragraph *is* precedes decorating it. Then character marks, then block
+ * structure, then insertions, and finally source view -- the one control that
+ * changes the editor's mode rather than the document, kept away from the rest
+ * so it is not hit by accident.
+ */
+export const DEFAULT_LAYOUT = 'undo redo | blockType | bold italic underline strikethrough code | ' +
+    'bulletList orderedList blockquote codeBlock | link unlink image horizontalRule | source';
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAiDH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAA;AAEnD;;;;;;;GAOG;AACH,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAA;AAEvC,MAAM,UAAU,gBAAgB,CAAC,QAAoB;IACnD,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACvB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;AACzC,CAAC;AAED,SAAS,MAAM;IACb,4EAA4E;IAC5E,2EAA2E;IAC3E,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,QAAQ,EAAE,CAAA;QACZ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,oDAAoD,EAAE,KAAK,CAAC,CAAA;QAC5E,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAqB;IACvD,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;IAC3B,MAAM,EAAE,CAAA;AACV,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,OAAO,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;AAC/B,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,iBAAiB;IAC/B,QAAQ,CAAC,KAAK,EAAE,CAAA;IAChB,MAAM,EAAE,CAAA;AACV,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,cAAc,GACzB,qEAAqE;IACrE,yFAAyF,CAAA"}