@clepit/core 0.5.0 → 0.6.0-beta.397

package/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-09-25
+
+Notes derived from the commits that touched shipped `src/` since 0.5.0. `@clepit/react` 0.3.0 rides this release: `ClepitEditor` forwards `resolveLink`, `resolveIssues`, `onEmbedAction` and `onIssueAction` through the same latest-ref contract as the uploaders, and requires `@clepit/core` ^0.6.0.
+
+### Added
+- `EditorConfig.allowedBlockTools` and `allowedInlineTools`: an embedder names the block types the block menu, its search, the convert submenu and the URL paste path offer, and the marks the inline toolbar serves. Absent, everything registered is offered, and a stored block outside the list still renders.
+- `EditorConfig.inlineRewriteTooltip`: the localized tooltip for the inline toolbar's rewrite wand. Without it the wand keeps saying `rewrite`, which was the only string the toolbar rendered untranslated.
+- `INLINE_REWRITE_ACTIONS` and `InlineRewriteAction` are exported from the package root, so a host can label every rewrite action without reaching into `types`.
+- Embeds: a Figma, Miro, Loom, Google Drive or Docs link, or a GitHub gist, pasted on an empty line becomes an embed block at once and goes on the next line when the line has text, honouring the member's preference for a live frame, a card or an offer chip under the caret; Enter on the offer converts it and any other key dismisses it. The block's own menu offers Show live, Show as card, Show as link and Copy link. `EditorConfig` carries the provider policy, the translated words, the host's link lookup (`resolveLink`) and the action seam (`onEmbedAction`). `resolveEmbed`, `isEmbedProviderDisabled`, `embedLabel`, `EMBED_LABELS`, `EMBED_TOOL_NAMES`, `EMBED_WIRE_KEYS`, `EMBED_ENGLISH` and the `Embed*` types are exported from the package root.
+- Issues: an issue link pasted into a sentence is a chip carrying the issue's key, title, status and holder, or a card on an empty line for a member who asked; a Linked issues block is derived from the document like the table of contents; chips, cards and tables are refreshed on mount, on focus and every five minutes without marking the document changed. `EditorConfig.resolveIssues` and `onIssueAction` are the host's seams. `classifyIssueUrl`, `IssueChip`, `chipsInHtml`, `readChipMarkup`, `refreshChipsInHtml`, `issueLabel`, `issueToolName`, `ISSUE_LABELS`, `ISSUE_TOOLS`, `ISSUE_TOOL_NAMES`, `ISSUE_ENGLISH` and the `Issue*` types are exported from the package root.
+
+### Fixed
+- `Editor.destroy` removes the document from the store after the DOM and the listeners are gone, so a destroyed editor no longer keeps its document under its container id, and `Editor.create` releases a previous runtime in the same container without deleting the document the store rehydrated before the page loaded.
+- Issue cards on a public page are no longer redrawn as empty chips by the finished-markup chip pass.
+- The table block's CSV download prefixes an apostrophe to a cell or header that opens with `=`, `+`, `-`, `@`, a tab or a carriage return, so a spreadsheet reads it as text, and a carriage return inside a cell is quoted.
+
 ## [0.5.0] - 2026-08-31
 
 Note: 0.4.0 was released without a changelog entry, so the notes below cover

package/dist/core/allowed.d.ts

@@ -0,0 +1,26 @@
+import { pasteEmbedTarget } from '../tools/block/embed/paste';
+import { pasteIssueTarget } from '../tools/inline/issue/paste';
+import { EditorConfig, Tool } from '../types';
+type BlockAllowance = Pick<EditorConfig, 'allowedBlockTools'> | undefined;
+type InlineAllowance = Pick<EditorConfig, 'allowedInlineTools'> | undefined;
+export declare const isBlockToolAllowed: (config: BlockAllowance, type: string) => boolean;
+export declare const allowedBlockTools: (config: BlockAllowance, tools: Tool[]) => Tool[];
+export declare const isInlineToolAllowed: (config: InlineAllowance, label: string) => boolean;
+export type PasteTarget = {
+    kind: 'embed';
+    embed: NonNullable<ReturnType<typeof pasteEmbedTarget>>;
+} | {
+    kind: 'image';
+    url: string;
+} | {
+    kind: 'issue';
+    issue: NonNullable<ReturnType<typeof pasteIssueTarget>>;
+} | {
+    kind: 'video';
+    url: string;
+    isVimeo: boolean;
+    isYouTube: boolean;
+};
+export declare const pasteTarget: (config: Pick<EditorConfig, "allowedBlockTools" | "disabledEmbedProviders" | "jiraSites"> | undefined, pastedText: string) => PasteTarget | null;
+export {};
+//# sourceMappingURL=allowed.d.ts.map

package/dist/core/editor/index.d.ts

@@ -13,10 +13,20 @@ export declare class Editor {
      */
     private static localizeData;
     private static render;
-    /** Runs even after the container has left the DOM (a React host removes the
+    /** Releases the runtime a container holds and leaves its document in the
+     *  store. `create` runs this first so a second create in the same container
+     *  starts clean, and the document it must NOT touch is the one the store
+     *  rehydrated before this page load: `addInstance` keeps a stored document
+     *  in preference to `initialData`, which is what lets a reader's content
+     *  survive a reload. Removing the store entry here deleted that document a
+     *  moment before `addInstance` would have kept it, and only the landing's
+     *  persistence spec caught it.
+     *
+     *  Runs even after the container has left the DOM (a React host removes the
      *  element before effect cleanup fires): every helper guards its own DOM
      *  access, and the id-keyed state — theme registry, body theme attribute,
      *  pending toolbar timers — must be released either way. */
+    private static teardown;
     static destroy(containerId: string): void;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/core/editor/issues.d.ts

@@ -0,0 +1,19 @@
+/** Five minutes: an issue's status is a slow thing, and a page left open all
+ * day should not cost a tracker a read a minute. */
+export declare const REFRESH_EVERY_MS: number;
+/**
+ * Keeps a page's issues current while it is open: one lookup on mount, again
+ * when the window regains focus (the reader came back from the tracker), and
+ * every five minutes. Chips, cards and tables are redrawn in place; the
+ * document is not marked changed, because nothing the author did changed.
+ */
+export declare class IssueRefresh {
+    private static timers;
+    private static focusHandlers;
+    static start(containerId: string): void;
+    static stop(containerId: string): void;
+    /** The URLs a refresh asks about: every chip and every issue card in the editor. */
+    static urls(containerId: string): string[];
+    static run(containerId: string): Promise<void>;
+}
+//# sourceMappingURL=issues.d.ts.map

package/dist/core/element/index.d.ts

@@ -1,4 +1,4 @@
-import { Block } from '../../types';
+import { Block, EmbedLabel, IssueChipParts, IssueLabel, IssueSnapshot } from '../../types';
 /**
  * The construction surface a block's render path is allowed to use.
  *
@@ -54,6 +54,18 @@ export type DrawContext = {
     mapsEmbedKey?: string;
     /** How a doc card turns a page id into a link, which only the host knows. */
     docHref?: (pageId: string) => string;
+    /** The workspace's switched-off embed tools, by wire key: a card where the
+     * workspace said so, on a public page as much as in the editor. */
+    disabledEmbedProviders?: readonly string[];
+    /** Translated embed words; English fallbacks otherwise. */
+    embedLabels?: Partial<Record<EmbedLabel, string>>;
+    /** The freshest issue snapshots the host resolved, by URL: a chip, a card or
+     * a Linked issues row draws these over what the document stored. */
+    issues?: Record<string, IssueSnapshot>;
+    /** The reader's two chip switches; both on when absent. */
+    issueChip?: IssueChipParts;
+    /** Translated issue words; English fallbacks otherwise. */
+    issueLabels?: Partial<Record<IssueLabel, string>>;
 };
 export type Backing = {
     create(tag: string): ClepitElement;

package/dist/core/labels.d.ts

@@ -0,0 +1,3 @@
+import { BlockToolbarLabel } from '../types';
+export declare const resolveHint: (containerId: string, key: BlockToolbarLabel, fallback: string) => string;
+//# sourceMappingURL=labels.d.ts.map

package/dist/core/managers/block/css.d.ts

@@ -1,3 +1,3 @@
 export declare const stylesKey = "clepit-block-manager-styles";
-export declare const style = "\n/* Blocks */\n.clepit-block {\n  position: relative;\n  margin: var(--block-margin-top, 8px) 0 var(--block-margin-bottom, 16px) 0;\n  padding: 8px 0;\n  padding-left: 54px;\n  border-radius: 4px;\n  transition: background-color 0.2s ease;\n  display: flex;\n  align-items: flex-start;\n  gap: 6px;\n}\n\n.clepit-block:hover {\n  background-color: var(--clepit-block-highlight-bg);\n}\n\n.clepit-block--active {\n  background-color: var(--clepit-block-highlight-bg);\n}\n\n.clepit-block-content {\n  outline: none;\n  min-height: 1.2em;\n  flex: 1;\n  min-width: 0; /* Allow content to shrink */\n}\n\n/* Remove focus outline from editable elements */\n.clepit-block-content [contenteditable=\"true\"] {\n  outline: none;\n}\n\n/* Placeholder styles for all text elements */\n.clepit-block-content:empty::before {\n  content: attr(data-placeholder);\n  color: var(--clepit-text-subtle);\n  pointer-events: none;\n  font-style: italic;\n}\n\n/* Menu animation classes */\n.clepit-block-type-selector--visible {\n  display: block;\n  transform: translateY(0);\n}\n\n.clepit-block-type-selector--hidden {\n  display: none;\n}\n\n/* Block Operations Menu */\n.clepit-block-operations-menu {\n  position: absolute;\n  top: 100%;\n  left: 0;\n  z-index: 1001;\n  background: var(--clepit-bg);\n  border: 1px solid var(--clepit-border);\n  border-radius: 6px;\n  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);\n  padding: 8px;\n  min-width: 200px;\n  margin-top: 4px;\n  display: none;\n  transition: transform 0.2s ease;\n}\n\n.clepit-block-operations-menu--visible {\n  display: block;\n  transform: translateY(0);\n}\n\n.clepit-block-operations-menu--hidden {\n  display: none;\n}\n\n/* Block Type Selector */\n.clepit-block-type-selector {\n  position: absolute;\n  top: 100%;\n  left: 0;\n  z-index: 1001;\n  background: var(--clepit-bg);\n  border: 1px solid var(--clepit-border);\n  border-radius: 6px;\n  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);\n  padding: 8px;\n  min-width: 150px;\n  margin-top: 4px;\n  display: none;\n  transition: transform 0.2s ease;\n}\n\n.clepit-block-type-selector--visible {\n  display: block;\n  transform: translateY(0);\n}\n\n.clepit-block-type-selector--hidden {\n  display: none;\n}\n\n/* Default menu item styles - package doesn't care about theme */\n.clepit-menu-item {\n  padding: 8px 12px;\n  cursor: pointer;\n  border-radius: 4px;\n  transition: background-color 0.2s;\n  display: flex;\n  align-items: center;\n  gap: 8px;\n}\n\n.clepit-menu-item .clepit-menu-icon {\n  width: 16px;\n  height: 16px;\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  font-size: 14px;\n}\n\n.clepit-menu-item:hover {\n  background-color: var(--clepit-selection-bg);\n}\n\n.clepit-menu-item.active {\n  background-color: var(--clepit-primary-bg);\n  color: var(--clepit-primary);\n  font-weight: bold;\n}\n\n.clepit-menu-item--danger {\n  color: var(--clepit-error);\n}\n\n/* Block type menu items - match font size with operations menu */\n.clepit-block-type-item {\n  font-size: 14px;\n}\n\n/* Default menu divider styles */\n.clepit-menu-divider {\n  height: 1px;\n  background: linear-gradient(to right, transparent, var(--clepit-border), transparent);\n  margin: 8px 0;\n}\n\n/* Default menu arrow styles */\n.clepit-menu-arrow {\n  margin-left: auto;\n  font-size: 12px;\n  color: var(--clepit-text-muted);\n}\n\n/* Input styles for block type selector */\n.clepit-block-type-selector input {\n  width: 100%;\n  padding: 8px 12px;\n  border: 1px solid var(--clepit-input-border, var(--clepit-border));\n  border-radius: 4px;\n  font-size: 14px;\n  margin-bottom: 8px;\n  outline: none;\n  transition: border-color 0.2s;\n  background-color: var(--input-bg, var(--clepit-bg));\n  color: var(--input-color, var(--clepit-text));\n}\n\n.clepit-block-type-selector input:focus {\n  border-color: var(--clepit-primary);\n  box-shadow: 0 0 0 2px var(--clepit-primary-bg);\n}\n\n.clepit-block-type-selector input::placeholder {\n  color: var(--placeholder-color, var(--clepit-text-subtle));\n}\n\n.clepit-block-type-selector-items {\n  max-height: 200px;\n  overflow-y: auto;\n}\n\n.clepit-menu-icon {\n  font-size: 14px;\n  min-width: 20px;\n  text-align: center;\n  font-weight: bold;\n}\n\n.clepit-menu-shortcut {\n  margin-left: auto;\n  font-size: 9px;\n  color: var(--clepit-text-muted);\n  opacity: 0.7;\n}\n\n.clepit-menu-positioned {\n  position: absolute;\n  z-index: 1001;\n  top: var(--menu-top, 0);\n  left: var(--menu-left, 0);\n}\n\n/* The block menus are popovers in the top layer. Anchor positioning puts them\n * under the block toolbar without JavaScript measuring anything.\n *\n * Guarded: anchor positioning is Baseline 2026 (Chrome 125+, Firefox 132+,\n * Safari 18.2+), roughly 91% of traffic. Browsers without it get the popover's\n * default centred placement rather than a second JS positioning path \u2014 the menu\n * stays usable, just not adjacent to its button. */\n.clepit-block-type-selector:popover-open,\n.clepit-block-operations-menu:popover-open {\n  /* The base menu rules above still say display:none from the pre-popover\n   * mechanism, and an author rule outranks the UA's popover reveal. Without\n   * an explicit display here every menu opens into the top layer invisible. */\n  display: block;\n  margin: 0;\n  border: 1px solid var(--clepit-border);\n  border-radius: 6px;\n  background: var(--clepit-bg);\n  padding: 8px;\n  overflow: visible;\n}\n\n.clepit-convert-submenu:popover-open {\n  display: block;\n}\n\n@supports (anchor-name: --a) {\n  .clepit-block-type-selector:popover-open,\n  .clepit-block-operations-menu:popover-open {\n    position-anchor: --clepit-block-toolbar;\n    position-area: bottom span-inline-end;\n    margin-block-start: 5px;\n  }\n}\n\n@supports (position-try-fallbacks: flip-block) {\n  .clepit-block-type-selector:popover-open,\n  .clepit-block-operations-menu:popover-open {\n    position-try-fallbacks: flip-block;\n  }\n}\n\n/* Convert Submenu */\n@supports (anchor-name: --a) {\n  .clepit-convert-submenu:popover-open {\n    position: fixed;\n    position-area: inline-end span-block-end;\n    margin: 0 0 0 4px;\n    inset: auto;\n  }\n\n  .clepit-convert-submenu:popover-open {\n    position-try-fallbacks: flip-inline;\n  }\n}\n\n.clepit-convert-submenu {\n  position: absolute;\n  top: var(--submenu-top, 0);\n  left: var(--submenu-left, 100%);\n  z-index: var(--submenu-z-index, 1002);\n  background: var(--clepit-bg);\n  border: 1px solid var(--clepit-border);\n  border-radius: 6px;\n  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);\n  padding: 8px;\n  min-width: 140px;\n  margin-left: 4px;\n  display: none;\n  transition: transform 0.2s ease;\n}\n\n.clepit-convert-submenu--visible {\n  display: block;\n  opacity: 1;\n  transform: translateX(0);\n}\n\n.clepit-convert-submenu--hidden {\n  display: none;\n  opacity: 0;\n  transform: translateX(-10px);\n}\n\n/* Input styles for convert submenu */\n.clepit-convert-submenu input {\n  width: 100%;\n  padding: 6px 8px;\n  border: 1px solid var(--clepit-input-border, var(--clepit-border));\n  border-radius: 4px;\n  font-size: 12px;\n  outline: none;\n  background-color: var(--input-bg, var(--clepit-bg));\n  color: var(--input-color, var(--clepit-text));\n}\n\n.clepit-convert-submenu input:focus {\n  border-color: var(--clepit-input-focus-border, var(--clepit-primary));\n  box-shadow: 0 0 0 2px var(--clepit-input-focus-shadow, var(--clepit-primary-bg));\n}\n\n.clepit-convert-submenu input::placeholder {\n  color: var(--clepit-input-placeholder, var(--clepit-text-subtle));\n}\n\n.clepit-convert-submenu-items {\n  max-height: 200px;\n  overflow-y: auto;\n}\n\n.clepit-block-operation-item {\n  padding: 8px 12px;\n  cursor: pointer;\n  border-radius: 4px;\n  transition: background-color 0.2s;\n  font-size: 14px;\n}\n\n.clepit-block-operation-item:hover {\n  background-color: var(--clepit-hover-bg, var(--clepit-selection-bg));\n}\n\n/* Input styles for operations menu */\n.clepit-block-operations-menu input {\n  width: 100%;\n  padding: 8px 12px;\n  border: 1px solid var(--clepit-input-border, var(--clepit-border));\n  border-radius: 4px;\n  font-size: 14px;\n  margin-bottom: 8px;\n  outline: none;\n  transition: border-color 0.2s;\n  background-color: var(--input-bg, var(--clepit-bg));\n  color: var(--input-color, var(--clepit-text));\n}\n\n.clepit-block-operations-menu input:focus {\n  border-color: var(--clepit-primary);\n  box-shadow: 0 0 0 2px var(--clepit-primary-bg);\n}\n\n.clepit-block-operations-menu input::placeholder {\n  color: var(--placeholder-color, var(--clepit-text-subtle));\n}\n\n.clepit-block-operations-menu-items {\n  max-height: 200px;\n  overflow-y: auto;\n}\n\n.clepit-block-operation-item[data-operation=\"delete\"] {\n  color: var(--clepit-error);\n}\n\n/* Convert submenu items */\n.clepit-convert-option-item {\n  padding: 8px 12px;\n  cursor: pointer;\n  border-radius: 4px;\n  transition: background-color 0.2s;\n  font-size: 14px;\n}\n\n.clepit-convert-option-item:hover {\n  background-color: var(--clepit-hover-bg, var(--clepit-selection-bg));\n}\n\n/* Indentation */\n.clepit-block[data-indent=\"1\"] .clepit-block-content {\n  margin-left: 20px;\n}\n\n.clepit-block[data-indent=\"2\"] .clepit-block-content {\n  margin-left: 40px;\n}\n\n.clepit-block[data-indent=\"3\"] .clepit-block-content {\n  margin-left: 60px;\n}\n\n/* Responsive */\n@media (max-width: 768px) {\n  /* The 54px gutter exists to hold the block toolbar, which is only ever\n   * displayed on the active block. On a phone that reserved a seventh of the\n   * editor's width on every idle block at once, pushing the text into a narrow\n   * column with empty space either side. Give the width back and let the\n   * gutter open only under the block whose toolbar is actually showing. */\n  /* No transition on padding-left. The block element is re-created as you\n   * interact with it, so an animated gutter restarts from 0 every time and\n   * never reaches its end value \u2014 the toolbar would sit on top of the text. */\n  .clepit-block {\n    padding-left: 0;\n  }\n\n  .clepit-block--active,\n  .clepit-block:focus-within,\n  .clepit-block:has(.clepit-block-toolbar--visible) {\n    padding-left: 54px;\n  }\n}\n";
+export declare const style = "\n/* Blocks */\n.clepit-block {\n  position: relative;\n  margin: var(--block-margin-top, 8px) 0 var(--block-margin-bottom, 16px) 0;\n  padding: 8px 0;\n  padding-left: 54px;\n  border-radius: 4px;\n  transition: background-color 0.2s ease;\n  display: flex;\n  align-items: flex-start;\n  gap: 6px;\n}\n\n.clepit-block:hover {\n  background-color: var(--clepit-block-highlight-bg);\n}\n\n.clepit-block--active {\n  background-color: var(--clepit-block-highlight-bg);\n}\n\n.clepit-block-content {\n  outline: none;\n  min-height: 1.2em;\n  flex: 1;\n  min-width: 0; /* Allow content to shrink */\n}\n\n/* Remove focus outline from editable elements */\n.clepit-block-content [contenteditable=\"true\"] {\n  outline: none;\n}\n\n/* Placeholder styles for all text elements */\n.clepit-block-content:empty::before {\n  content: attr(data-placeholder);\n  color: var(--clepit-text-subtle);\n  pointer-events: none;\n  font-style: italic;\n}\n\n/* Menu animation classes */\n.clepit-block-type-selector--visible {\n  display: block;\n  transform: translateY(0);\n}\n\n.clepit-block-type-selector--hidden {\n  display: none;\n}\n\n/* Block Operations Menu */\n.clepit-block-operations-menu {\n  position: absolute;\n  top: 100%;\n  left: 0;\n  z-index: 1001;\n  background: var(--clepit-bg);\n  border: 1px solid var(--clepit-border);\n  border-radius: 6px;\n  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);\n  padding: 8px;\n  min-width: 200px;\n  margin-top: 4px;\n  display: none;\n  transition: transform 0.2s ease;\n}\n\n.clepit-block-operations-menu--visible {\n  display: block;\n  transform: translateY(0);\n}\n\n.clepit-block-operations-menu--hidden {\n  display: none;\n}\n\n/* Block Type Selector */\n.clepit-block-type-selector {\n  position: absolute;\n  top: 100%;\n  left: 0;\n  z-index: 1001;\n  background: var(--clepit-bg);\n  border: 1px solid var(--clepit-border);\n  border-radius: 6px;\n  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);\n  padding: 8px;\n  min-width: 150px;\n  margin-top: 4px;\n  display: none;\n  transition: transform 0.2s ease;\n}\n\n.clepit-block-type-selector--visible {\n  display: block;\n  transform: translateY(0);\n}\n\n.clepit-block-type-selector--hidden {\n  display: none;\n}\n\n/* Default menu item styles - package doesn't care about theme */\n.clepit-menu-item {\n  padding: 8px 12px;\n  cursor: pointer;\n  border-radius: 4px;\n  transition: background-color 0.2s;\n  display: flex;\n  align-items: center;\n  gap: 8px;\n}\n\n.clepit-menu-item .clepit-menu-icon {\n  width: 16px;\n  height: 16px;\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  font-size: 14px;\n}\n\n.clepit-menu-item:hover {\n  background-color: var(--clepit-selection-bg);\n}\n\n.clepit-menu-item.active {\n  background-color: var(--clepit-primary-bg);\n  color: var(--clepit-primary);\n  font-weight: bold;\n}\n\n.clepit-menu-item--danger {\n  color: var(--clepit-error);\n}\n\n/* Block type menu items - match font size with operations menu */\n.clepit-block-type-item {\n  font-size: 14px;\n}\n\n/* Default menu divider styles */\n.clepit-menu-divider {\n  height: 1px;\n  background: linear-gradient(to right, transparent, var(--clepit-border), transparent);\n  margin: 8px 0;\n}\n\n/* Default menu arrow styles */\n.clepit-menu-arrow {\n  margin-left: auto;\n  font-size: 12px;\n  color: var(--clepit-text-muted);\n}\n\n/* Input styles for block type selector */\n.clepit-block-type-selector input {\n  width: 100%;\n  padding: 8px 12px;\n  border: 1px solid var(--clepit-input-border, var(--clepit-border));\n  border-radius: 4px;\n  font-size: 14px;\n  margin-bottom: 8px;\n  outline: none;\n  transition: border-color 0.2s;\n  background-color: var(--input-bg, var(--clepit-bg));\n  color: var(--input-color, var(--clepit-text));\n}\n\n.clepit-block-type-selector input:focus {\n  border-color: var(--clepit-primary);\n  box-shadow: 0 0 0 2px var(--clepit-primary-bg);\n}\n\n.clepit-block-type-selector input::placeholder {\n  color: var(--placeholder-color, var(--clepit-text-subtle));\n}\n\n.clepit-block-type-selector-items {\n  max-height: 200px;\n  overflow-y: auto;\n}\n\n.clepit-menu-icon {\n  font-size: 14px;\n  min-width: 20px;\n  text-align: center;\n  font-weight: bold;\n}\n\n.clepit-menu-shortcut {\n  margin-left: auto;\n  font-size: 9px;\n  color: var(--clepit-text-muted);\n  opacity: 0.7;\n}\n\n.clepit-menu-positioned {\n  position: absolute;\n  z-index: 1001;\n  top: var(--menu-top, 0);\n  left: var(--menu-left, 0);\n}\n\n/* The block menus are popovers in the top layer. Anchor positioning puts them\n * under the block toolbar without JavaScript measuring anything.\n *\n * Guarded: anchor positioning is Baseline 2026 (Chrome 125+, Firefox 132+,\n * Safari 18.2+), roughly 91% of traffic. Browsers without it get the popover's\n * default centred placement rather than a second JS positioning path \u2014 the menu\n * stays usable, just not adjacent to its button. */\n.clepit-block-type-selector:popover-open,\n.clepit-block-operations-menu:popover-open {\n  /* The base menu rules above still say display:none from the pre-popover\n   * mechanism, and an author rule outranks the UA's popover reveal. Without\n   * an explicit display here every menu opens into the top layer invisible. */\n  display: block;\n  margin: 0;\n  border: 1px solid var(--clepit-border);\n  border-radius: 6px;\n  background: var(--clepit-bg);\n  padding: 8px;\n  overflow: visible;\n}\n\n.clepit-convert-submenu:popover-open {\n  display: block;\n}\n\n@supports (anchor-name: --a) {\n  .clepit-block-type-selector:popover-open,\n  .clepit-block-operations-menu:popover-open {\n    position-anchor: --clepit-block-toolbar;\n    position-area: block-end span-inline-end;\n    margin-block-start: 5px;\n    inset: auto;\n  }\n}\n\n@supports (position-try-fallbacks: flip-block) {\n  .clepit-block-type-selector:popover-open,\n  .clepit-block-operations-menu:popover-open {\n    position-try-fallbacks: flip-block;\n  }\n}\n\n/* Convert Submenu */\n@supports (anchor-name: --a) {\n  .clepit-convert-submenu:popover-open {\n    position: fixed;\n    position-area: inline-end span-block-end;\n    margin: 0 0 0 4px;\n    inset: auto;\n  }\n\n  .clepit-convert-submenu:popover-open {\n    position-try-fallbacks: flip-inline;\n  }\n}\n\n.clepit-convert-submenu {\n  position: absolute;\n  top: var(--submenu-top, 0);\n  left: var(--submenu-left, 100%);\n  z-index: var(--submenu-z-index, 1002);\n  background: var(--clepit-bg);\n  border: 1px solid var(--clepit-border);\n  border-radius: 6px;\n  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);\n  padding: 8px;\n  min-width: 140px;\n  margin-left: 4px;\n  display: none;\n  transition: transform 0.2s ease;\n}\n\n.clepit-convert-submenu--visible {\n  display: block;\n  opacity: 1;\n  transform: translateX(0);\n}\n\n.clepit-convert-submenu--hidden {\n  display: none;\n  opacity: 0;\n  transform: translateX(-10px);\n}\n\n/* Input styles for convert submenu */\n.clepit-convert-submenu input {\n  width: 100%;\n  padding: 6px 8px;\n  border: 1px solid var(--clepit-input-border, var(--clepit-border));\n  border-radius: 4px;\n  font-size: 12px;\n  outline: none;\n  background-color: var(--input-bg, var(--clepit-bg));\n  color: var(--input-color, var(--clepit-text));\n}\n\n.clepit-convert-submenu input:focus {\n  border-color: var(--clepit-input-focus-border, var(--clepit-primary));\n  box-shadow: 0 0 0 2px var(--clepit-input-focus-shadow, var(--clepit-primary-bg));\n}\n\n.clepit-convert-submenu input::placeholder {\n  color: var(--clepit-input-placeholder, var(--clepit-text-subtle));\n}\n\n.clepit-convert-submenu-items {\n  max-height: 200px;\n  overflow-y: auto;\n}\n\n.clepit-block-operation-item {\n  padding: 8px 12px;\n  cursor: pointer;\n  border-radius: 4px;\n  transition: background-color 0.2s;\n  font-size: 14px;\n}\n\n.clepit-block-operation-item:hover {\n  background-color: var(--clepit-hover-bg, var(--clepit-selection-bg));\n}\n\n/* Input styles for operations menu */\n.clepit-block-operations-menu input {\n  width: 100%;\n  padding: 8px 12px;\n  border: 1px solid var(--clepit-input-border, var(--clepit-border));\n  border-radius: 4px;\n  font-size: 14px;\n  margin-bottom: 8px;\n  outline: none;\n  transition: border-color 0.2s;\n  background-color: var(--input-bg, var(--clepit-bg));\n  color: var(--input-color, var(--clepit-text));\n}\n\n.clepit-block-operations-menu input:focus {\n  border-color: var(--clepit-primary);\n  box-shadow: 0 0 0 2px var(--clepit-primary-bg);\n}\n\n.clepit-block-operations-menu input::placeholder {\n  color: var(--placeholder-color, var(--clepit-text-subtle));\n}\n\n.clepit-block-operations-menu-items {\n  max-height: 200px;\n  overflow-y: auto;\n}\n\n.clepit-block-operation-item[data-operation=\"delete\"] {\n  color: var(--clepit-error);\n}\n\n/* Convert submenu items */\n.clepit-convert-option-item {\n  padding: 8px 12px;\n  cursor: pointer;\n  border-radius: 4px;\n  transition: background-color 0.2s;\n  font-size: 14px;\n}\n\n.clepit-convert-option-item:hover {\n  background-color: var(--clepit-hover-bg, var(--clepit-selection-bg));\n}\n\n/* Indentation */\n.clepit-block[data-indent=\"1\"] .clepit-block-content {\n  margin-left: 20px;\n}\n\n.clepit-block[data-indent=\"2\"] .clepit-block-content {\n  margin-left: 40px;\n}\n\n.clepit-block[data-indent=\"3\"] .clepit-block-content {\n  margin-left: 60px;\n}\n\n/* Responsive */\n@media (max-width: 768px) {\n  /* The 54px gutter exists to hold the block toolbar, which is only ever\n   * displayed on the active block. On a phone that reserved a seventh of the\n   * editor's width on every idle block at once, pushing the text into a narrow\n   * column with empty space either side. Give the width back and let the\n   * gutter open only under the block whose toolbar is actually showing. */\n  /* No transition on padding-left. The block element is re-created as you\n   * interact with it, so an animated gutter restarts from 0 every time and\n   * never reaches its end value \u2014 the toolbar would sit on top of the text. */\n  .clepit-block {\n    padding-left: 0;\n  }\n\n  .clepit-block--active,\n  .clepit-block:focus-within,\n  .clepit-block:has(.clepit-block-toolbar--visible) {\n    padding-left: 54px;\n  }\n}\n";
 //# sourceMappingURL=css.d.ts.map

package/dist/core/managers/block/index.d.ts

@@ -8,6 +8,9 @@ export declare class BlockManager {
     private static createBlockElement;
     static insertBlock(block: Block, containerId: string, index: number): HTMLElement | null;
     static removeBlock(containerId: string, index: number): null | undefined;
+    /** Insert first, then remove: `removeBlock` keeps the last block of a document,
+     * so replacing the only block by removing it first left the old block in
+     * place beside the new one. */
     static replaceBlock(containerId: string, index: number, block: Block<BlockToolType>): void;
     static moveBlock(containerId: string, fromIndex: number, toIndex: number): void;
     static getBlock(blockId: string): HTMLElement | null;
@@ -27,6 +30,7 @@ export declare class BlockManager {
     static renderBlock(block: HTMLElement, containerId: string, index: number): void;
     static setBlocks(blocks: Block[], containerId: string): void;
     static renderBlocks(blocks: Block[], containerId: string): void;
+    private static adoptStartingBlock;
     private static removeAllBlocks;
     static resetBlocks(containerId: string): void;
     static getEditorId(element: HTMLElement): string | null;

package/dist/core/managers/event.d.ts

@@ -8,6 +8,11 @@ export declare class EventManager {
     } | null;
     private static handleClick;
     private static handleSelectionChange;
+    /**
+     * A paste is intercepted only when it is one this editor turns into a block:
+     * an image URL, a video URL, or a link a provider renders. Plain text and
+     * links no provider knows reach the browser's own paste untouched.
+     */
     static handlePaste(event: ClipboardEvent): void;
 }
 //# sourceMappingURL=event.d.ts.map

package/dist/core/store.d.ts

@@ -6,6 +6,7 @@ type Store = {
     addInstance: (containerId: string, instance: EditorInstance) => void;
     updateInstance: (containerId: string, instance: EditorInstance) => void;
     removeInstance: (containerId: string) => void;
+    seedBlocks: (containerId: string, blocks: Block[]) => void;
     getInstance: (containerId: string) => EditorInstance | null;
     setCurrentView: (containerId: string, currentView: EditorView) => void;
     getCurrentView: (containerId: string) => EditorView | null;

package/dist/core/toolbars/block/index.d.ts

@@ -15,6 +15,7 @@ export declare class BlockToolbar {
     private static showCodeThemeSubmenu;
     static show(containerId: string, block: HTMLElement): void;
     static hide(containerId: string): void;
+    private static menuHost;
     private static hideAllToolbars;
     private static getCurrentHeadingLevel;
     /**

package/dist/index.d.ts

@@ -6,9 +6,14 @@ export { activateBlocks } from './core/renderer/activate';
 export { drawBlock } from './core/renderer/draw';
 export { type PublicPage, pageStylesheet, renderBlocks, renderPage } from './core/renderer/page';
 export { type ThemeTokens, tokensToLightDarkBlock } from './core/theme';
+export { EMBED_ENGLISH, EMBED_TOOL_NAMES, embedLabel } from './tools/block/embed/output';
+export { EMBED_WIRE_KEYS, isEmbedProviderDisabled, resolveEmbed } from './tools/block/embed/providers';
 export type { OpenApiGroup, OpenApiModel, OpenApiOperation, OpenApiServer } from './tools/block/openapi/spec';
 export { parseOpenApi } from './tools/block/openapi/spec';
-export type { ALERT_VARIANTS, AlertData, AlertVariant, AudioData, Block, BlockClassNames, BlockMargins, BlockStyles, BlockTune, CodeData, CodeVariant, CSSProperties, CSSValue, DelimiterData, DelimiterVariant, EditorAPI, EditorClassNames, EditorConfig, EditorData, EditorStyles, GlanceData, GlanceRow, HeaderData, HeaderLevel, ImageData, InlineToolType as InlineTool, InputClassNames, InputConfig, InputStyles, ListData, ListType, OpenApiData, OpenApiFilter, OutputComponent, OutputConfig, ParagraphData, QuoteData, RendererConfig, TableData, ToolType as BlockType, UploadFunction, VideoData, } from './types';
-export { BLOCK_TOOLS, INLINE_TOOLS } from './types';
+export { chipsInHtml, IssueChip, readChipMarkup, refreshChipsInHtml } from './tools/inline/issue';
+export { ISSUE_ENGLISH, ISSUE_TOOL_NAMES, issueLabel, issueToolName } from './tools/inline/issue/labels';
+export { classifyIssueUrl } from './tools/inline/issue/providers';
+export type { ALERT_VARIANTS, AlertData, AlertVariant, AudioData, Block, BlockClassNames, BlockMargins, BlockStyles, BlockTune, CodeData, CodeVariant, ControlLabel, CSSProperties, CSSValue, DelimiterData, DelimiterVariant, EditorAPI, EditorClassNames, EditorConfig, EditorData, EditorStyles, EmbedAction, EmbedData, EmbedFile, EmbedGist, EmbedGistFile, EmbedLabel, EmbedProvider, EmbedReason, EmbedResolution, GlanceData, GlanceRow, HeaderData, HeaderLevel, ImageData, InlineRewriteAction, InlineToolType as InlineTool, InputClassNames, InputConfig, InputStyles, IssueAction, IssueCards, IssueCategory, IssueChipParts, IssueLabel, IssueReason, IssueSnapshot, IssuesData, IssueTarget, IssueTool, ListData, ListType, OpenApiData, OpenApiFilter, OutputComponent, OutputConfig, ParagraphData, PasteEmbeds, QuoteData, RendererConfig, TableData, ToolType as BlockType, UploadFunction, VideoData, } from './types';
+export { BLOCK_TOOLS, CONTROL_LABELS, EMBED_LABELS, INLINE_REWRITE_ACTIONS, INLINE_TOOLS, ISSUE_LABELS, ISSUE_TOOLS } from './types';
 export { sanitizeHtmlWithoutDom } from './utils/sanitize-html-nodom';
 //# sourceMappingURL=index.d.ts.map