quoin-editor 1.7.0 → 2.0.0

package/dist/index.d.ts

@@ -4,192 +4,20 @@ import { C as CodeHighlighter } from './code-highlighter-BQDxhRrv.js';
 export { a as CodeToken } from './code-highlighter-BQDxhRrv.js';
 import { Q as QuoinBlock, P as Pos } from './types-CQ8Vw_7N.js';
 export { d as Assoc, c as AtomNode, e as AtomSpec, A as Attrs, B as BlockAttrs, f as BlockContent, g as BlockFlow, h as BlockRangeSelection, i as BlockSpec, C as CodecContext, j as CreatedBlock, k as EngineBlock, E as EngineDoc, I as Inline, l as InlineCodec, m as InlineNode, M as Mark, n as MarkSpec, o as MarkdownExportContext, N as NodeSelection, p as ParseInlineOptions, q as PosMap, S as Schema, b as Selection, r as SerializeInlineOptions, a as Step, s as StepJSON, t as StepResult, T as TextNode, u as TextSelection } from './types-CQ8Vw_7N.js';
-import { E as Extension, a as Editor, c as EditorState, b as Command } from './types-BjLcmV00.js';
-export { A as Align, B as BlockStructureOptions, e as BoundCommands, f as Chain, C as CommandFactories, g as CoreCommands, h as CoreExtensionOptions, i as DOMParserLike, D as Decoration, j as EditorOptions, F as FromHTMLOptions, I as InputRule, k as InputRuleContext, l as InputRuleRange, m as InsertTextOptions, K as KeyLike, M as MarkdownOptions, n as PasteRule, P as PluginKey, d as PluginSpec, S as Slice, o as TextStats, T as Transaction, p as TransactionOrigin, q as applyTransaction, r as coreExtensions, s as createEditor, t as createPluginKey, u as createState, v as fromHTML, w as getPluginState, x as insertBlockAfter, y as insertText, z as insertTextWithRules, G as keyName, H as normalizeKey, J as setBlockType, L as toggleMark } from './types-BjLcmV00.js';
-import { PALETTE } from './engine.js';
-export { AttrsPatch, BlockChange, BlockCodec, BlockDiff, FromMarkdownOptions, InlineChange, SchemaInput, addMarkStep, atom, blockInputRules, blockRangeSelection, coreBlockSpecs, countDoc, countText, createBlockCodec, createSchema, defineExtension, diffBlocks, diffInline, fromMarkdown, insertBlocksStep, joinBlocksStep, markInputRules, moveBlocksStep, nodeSelection, normalizeInline, parseInline, redo, removeBlocksStep, removeMarkStep, replaceBlockStep, replaceDocStep, replaceInlineStep, sanitizeHref, serializeInline, setAttrsStep, setIndentStep, splitBlockStep, stepFromJSON, text, textSelection, toPlainText, typographyRules, undo } from './engine.js';
+import { E as Extension, a as Editor, c as EditorState, b as Command } from './types-DMuuDBVh.js';
+export { A as Align, B as BlockStructureOptions, e as BoundCommands, f as Chain, C as CommandFactories, g as CoreCommands, h as CoreExtensionOptions, i as DOMParserLike, D as Decoration, j as EditorOptions, F as FromHTMLOptions, I as InputRule, k as InputRuleContext, l as InputRuleRange, m as InsertTextOptions, K as KeyLike, M as MarkdownOptions, n as PasteRule, P as PluginKey, d as PluginSpec, S as Slice, o as TextStats, T as Transaction, p as TransactionOrigin, q as applyTransaction, r as coreExtensions, s as createEditor, t as createPluginKey, u as createState, v as fromHTML, w as getPluginState, x as insertBlockAfter, y as insertText, z as insertTextWithRules, G as keyName, H as normalizeKey, J as setBlockType, L as toggleMark } from './types-DMuuDBVh.js';
+import { Q as QuoinLabels, S as SlashGroup } from './labels-BhRJYo46.js';
 import { A as AnyBlockDefinition, U as UploadFn, a as UploadResult } from './registry-DZ8LIGt5.js';
 export { B as BlockDefinition, b as BlockEditorProps, c as BlockPreviewProps, e as blockByType, d as defineBlock, p as paletteBlocks } from './registry-DZ8LIGt5.js';
-import { V as ViewController, R as RenderOptions } from './view-controller-p-2x3J7Y.js';
-export { A as AtomRenderer, K as KeyInterceptor, a as ViewControllerOptions, W as WidgetRenderer, h as hostKey } from './view-controller-p-2x3J7Y.js';
+import { V as ViewController, R as RenderOptions } from './node-reveal-BnFcnHhz.js';
+export { A as Announcer, a as AtomRenderer, E as Engagement, F as FocusTarget, H as HostEntry, b as HostRegistry, K as KeyInterceptor, N as NodeReveal, S as Spoken, c as ViewControllerOptions, W as WidgetRenderer, h as hostKey } from './node-reveal-BnFcnHhz.js';
 import { BlockRenderer } from './headless.js';
-export { BlockLabel, BlockPlaceholder, BlockRenderProps, BlockShell, DomMap, DomPoint, EditableRegion, EditableRegionProps, EditorView, EditorViewProps, SelectionSink, UseQuoinEditorOptions, VoidBlockFallback, caretFromPoint, defaultRenderers, domMapOf, isCrossSelection, renderInline, useEditorState, useQuoinEditor, useViewController } from './headless.js';
-export { T as ToMarkdownOptions, t as toMarkdown } from './to-markdown-BVOzhgVM.js';
+export { BlockLabel, BlockPlaceholder, BlockRenderProps, CaretPoint, DomMap, DomPoint, EditableRegion, EditableRegionProps, EditorView, EditorViewProps, UseQuoinEditorOptions, caretFromPoint, domMapOf, renderInline, useEditorState, useQuoinEditor, useViewController } from './headless.js';
+export { AttrsPatch, BlockChange, BlockCodec, BlockDiff, FromMarkdownOptions, InlineChange, SchemaInput, addMarkStep, atom, blockInputRules, blockRangeSelection, coreBlockSpecs, countDoc, countText, createBlockCodec, createSchema, defineExtension, diffBlocks, diffInline, fromMarkdown, insertBlocksStep, joinBlocksStep, markInputRules, moveBlocksStep, nodeSelection, normalizeInline, parseInline, redo, removeBlocksStep, removeMarkStep, replaceBlockStep, replaceDocStep, replaceInlineStep, sanitizeHref, serializeInline, setAttrsStep, setIndentStep, splitBlockStep, stepFromJSON, text, textSelection, toPlainText, typographyRules, undo } from './engine.js';
+export { T as ToMarkdownOptions, t as toMarkdown } from './to-markdown-DC1EUye5.js';
+export { P as PALETTE } from './palette-BrX-hEd-.js';
 export { E as EmbedProvider, a as EmbedUrl } from './embed-provider-jXwlRmnp.js';
-export { H as HTMLOptions, t as toHTML } from './to-html-CLRBCX0I.js';
-
-type PaletteName = (typeof PALETTE)[number];
-
-type SlashGroup = 'basic' | 'lists' | 'media' | 'advanced' | 'embeds' | 'ai' | 'custom';
-type CalloutTone = 'info' | 'tip' | 'success' | 'warning' | 'danger';
-/** The block types the menus name. Headings are named by `heading`. */
-type BlockName = 'text' | 'bulletedList' | 'numberedList' | 'todoList' | 'quote' | 'callout' | 'toggle' | 'code' | 'divider' | 'image' | 'file';
-/** The slash commands that insert a block, which the menu explains under their names. */
-type SlashBlockCommand = BlockName | 'heading1' | 'heading2' | 'heading3';
-type ModifierKey = 'ctrl' | 'alt' | 'shift';
-/** The keys a shortcut writes out by name rather than by the character they type. */
-type NamedKey = 'escape' | 'tab' | 'enter' | 'space' | 'backspace' | 'delete' | 'f10';
-type ShortcutGroupName = 'text' | 'blocks' | 'selection' | 'navigation' | 'menus';
-/** The rows of the keyboard shortcuts dialog that no other label names. */
-type ShortcutName = 'lineBreak' | 'flipBlock' | 'selectBlock' | 'openBlockEditor' | 'leaveBlockEditor' | 'selectAll' | 'extendUp' | 'extendDown' | 'lineUp' | 'lineDown' | 'leaveEditor' | 'blockMenu' | 'closeMenu' | 'splitBlock' | 'joinAbove' | 'joinBelow' | 'previousBlockEnd' | 'nextBlockStart';
-/** Every string the editor shows or speaks. A label that depends on a value is a function of it. */
-type QuoinLabels = {
-    document: string;
-    editorHint: string;
-    paragraph: string;
-    heading: (level: number) => string;
-    bulletItem: string;
-    numberedItem: (n: number) => string;
-    task: string;
-    quote: string;
-    /** The name of a callout's text, given the name of its tone from `calloutTones`, which it takes as written. */
-    callout: (tone: string) => string;
-    /** The name of each tone, on its chip and in its menus as inside the name of a callout's text. */
-    calloutTones: Record<CalloutTone, string>;
-    calloutIcon: string;
-    /** The name of the button that shows a callout's tone and opens the menu of tones, given the tone's name. */
-    calloutToneMenu: (tone: string) => string;
-    toggle: string;
-    /** The name of a toggle's chevron, given how many blocks the closed toggle hides, 0 while it is open. */
-    toggleButton: (hidden: number) => string;
-    placeholderEmpty: string;
-    placeholderHeading: (level: number) => string;
-    placeholderList: string;
-    placeholderQuote: string;
-    blockMenu: (type: string) => string;
-    blockNames: Record<BlockName, string>;
-    turnInto: string;
-    color: string;
-    textColor: string;
-    backgroundColor: string;
-    /** The submenus of a callout's block menu that set its tone and its icon. */
-    tone: string;
-    icon: string;
-    duplicate: string;
-    copy: string;
-    copyLink: string;
-    copied: string;
-    moveUp: string;
-    moveDown: string;
-    delete: string;
-    askAi: string;
-    addBelow: string;
-    dragHandle: string;
-    slashMenu: string;
-    noResults: string;
-    /** What the open slash menu says once its list settles, given how many commands match. */
-    resultCount: (n: number) => string;
-    slashDescriptions: Record<SlashBlockCommand, string>;
-    groups: Record<SlashGroup, string>;
-    bold: string;
-    italic: string;
-    underline: string;
-    strike: string;
-    code: string;
-    link: string;
-    highlight: string;
-    align: string;
-    alignLeft: string;
-    alignCenter: string;
-    alignRight: string;
-    alignJustify: string;
-    subscript: string;
-    superscript: string;
-    comment: string;
-    linkUrl: string;
-    linkApply: string;
-    linkRemove: string;
-    linkOpen: string;
-    linkEdit: string;
-    invalidLink: string;
-    colors: Record<PaletteName, string>;
-    blockMoved: (position: number, total: number) => string;
-    blockInserted: (position: number, total: number) => string;
-    blockDeleted: (n: number) => string;
-    blocksSelected: (n: number) => string;
-    /** How to bring deleted blocks back, given the platform's undo shortcut. */
-    undoHint: (shortcut: string) => string;
-    shortcuts: string;
-    shortcutGroupNames: Record<ShortcutGroupName, string>;
-    shortcutNames: Record<ShortcutName, string>;
-    /** Two keys pressed one after the other. */
-    keySequence: (first: string, then: string) => string;
-    /** Two shortcuts that do the same thing. */
-    keyAlternative: (first: string, other: string) => string;
-    /** The modifier keys a shortcut hint names away from a Mac, where it draws their symbols instead. */
-    keyNames: Record<ModifierKey, string>;
-    namedKeys: Record<NamedKey, string>;
-    formattingToolbar: string;
-    mobileToolbar: string;
-    indent: string;
-    outdent: string;
-    undo: string;
-    redo: string;
-    close: string;
-    selectedContent: string;
-    editBlock: (label: string) => string;
-    unsupportedBlock: string;
-    /** Optional so a translation written for 1.0 still compiles; English where it is missing. */
-    blockError?: string;
-    uploading: string;
-    uploaded: (name: string) => string;
-    /** What an upload field shows when the host's upload fails without a message of its own. */
-    uploadFailed: string;
-    /** What an upload field shows in place of working when the canvas was given no upload function. */
-    uploadsUnavailable: string;
-    /** An empty image block: its upload button, the link it can embed instead and what can be dropped or pasted on it. */
-    uploadImage: string;
-    embedLink: string;
-    imageLink: string;
-    dropImage: string;
-    /** An image block: its caption, its toolbar, the handles of its width with their value, and the toolbar's buttons. */
-    imageCaption: string;
-    addCaption: string;
-    imageTools: string;
-    resizeFromLeft: string;
-    resizeFromRight: string;
-    widthValue: (percent: number) => string;
-    replaceImage: string;
-    download: string;
-    /** The alt text of an image: its field, what the field asks for, its button, and the name of an image without one. */
-    altText: string;
-    altTextHint: string;
-    save: string;
-    imageNoAlt: string;
-    /**
-     * The checkbox of the alt text popover that marks an image as deliberately without a description, the visible text of
-     * the badge an editable canvas draws over an image that has neither, and the badge's name, which starts with that
-     * visible text and then says what it does. A translation that sets `noAltBadge` should set `addAltText` too; with `noAltBadge` alone the
-     * badge is named by its visible text. Optional like `blockError`.
-     */
-    decorativeImage?: string;
-    noAltBadge?: string;
-    addAltText?: string;
-    /** An empty file block: its upload button and what can be dropped or pasted on it. */
-    uploadFile: string;
-    dropFile: string;
-    /** A file block: its toolbar and the toolbar's replace button. */
-    fileTools: string;
-    replaceFile: string;
-    /** The name of a file's download link, given the file's name. It contains `download`, the link's visible text. */
-    downloadFile: (name: string) => string;
-    /** The size of a file, given in bytes. */
-    fileSize: (bytes: number) => string;
-    /** The name of a file block selected as a whole, given the file's name. */
-    fileBlockName: (name: string) => string;
-    /** A code block: its code, its language, the name of a code in no language, and its copy button. */
-    codeText: string;
-    /** The name of a code block selected as a whole, given the name of its language. */
-    codeBlockName: (language: string) => string;
-    codeLanguage: string;
-    plainText: string;
-    copyCode: string;
-    /** What the preview of a block without content says. */
-    emptyImage: string;
-    emptyFile: string;
-    emptyMarkdown: string;
-    emptyCallout: string;
-};
+export { H as HTMLOptions, t as toHTML } from './to-html-CogwrQer.js';
 
 type BlockCanvasProps = {
     /**
@@ -250,6 +78,10 @@ type QuoinEditorHandle = {
     }): string;
 };
 
+/**
+ * The editor with the whole canvas UI: the slash menu, the bubble toolbar, the block menu, drag handles, the mobile
+ * tools and the shortcuts dialog. The document is controlled, `blocks` in and `onChange` out, as an input's value is.
+ */
 declare const BlockCanvas: react.ForwardRefExoticComponent<BlockCanvasProps & react.RefAttributes<QuoinEditorHandle>>;
 
 /** The block types Quoin ships with. Spread them alongside your own definitions. */
@@ -372,11 +204,12 @@ declare function QuoinProvider({ value, children, }: {
 /** Reads the canvas configuration. Throws outside a QuoinProvider rather than returning a silent default. */
 declare function useQuoin(): QuoinConfig;
 
+/** Every string the canvas shows or speaks, in English. Pass `labels` to the canvas to change any of them. */
 declare const englishLabels: Required<QuoinLabels>;
 
 /** The English labels with the host's overrides on top. A key the host leaves out, or passes as undefined, stays
  *  English. */
-declare function resolveLabels(overrides?: Partial<QuoinLabels>): QuoinLabels;
+declare const resolveLabels: (overrides?: Partial<QuoinLabels>) => QuoinLabels;
 
 type BlockMenuAction = {
     id: string;
@@ -513,5 +346,5 @@ type UseAutosaveResult = {
  */
 declare function useAutosave<T>({ deps, build, save, debounceMs, maxBackoffMs, maxRetries, isRetryable, flushOnHide, }: UseAutosaveInput<T>): UseAutosaveResult;
 
-export { AnyBlockDefinition, BlockCanvas, BlockRenderer, CodeHighlighter, Command, Editor, EditorState, Extension, FilePickerButton, PALETTE, Pos, QuoinBlock, QuoinProvider, RenderOptions, UploadField, UploadFn, UploadResult, ViewController, coreBlocks, englishLabels, formatShortcut, resolveLabels, useAutosave, useLabels, useQuoin };
-export type { AutosaveStatus, BlockCanvasProps, BlockMenuAction, CalloutBlockData, CodeBlockData, CoreBlockData, ExtensionUI, FileBlockData, FilePickerButtonProps, ImageBlockData, MarkdownBlockData, QuoinConfig, QuoinConfigInput, QuoinEditorHandle, QuoinLabels, ShortcutPlatform, SlashGroup, SlashItem, SuggestionRange, ToolbarItem, UploadFieldProps, UseAutosaveInput, UseAutosaveResult };
+export { AnyBlockDefinition, BlockCanvas, BlockRenderer, CodeHighlighter, Command, Editor, EditorState, Extension, FilePickerButton, Pos, QuoinBlock, QuoinLabels, QuoinProvider, RenderOptions, SlashGroup, UploadField, UploadFn, UploadResult, ViewController, coreBlocks, englishLabels, formatShortcut, resolveLabels, useAutosave, useLabels, useQuoin };
+export type { AutosaveStatus, BlockCanvasProps, BlockMenuAction, CalloutBlockData, CodeBlockData, CoreBlockData, ExtensionUI, FileBlockData, FilePickerButtonProps, ImageBlockData, MarkdownBlockData, QuoinConfig, QuoinConfigInput, QuoinEditorHandle, ShortcutPlatform, SlashItem, SuggestionRange, ToolbarItem, UploadFieldProps, UseAutosaveInput, UseAutosaveResult };

package/dist/index.js

@@ -1,9 +1,10 @@
 'use client';
-export { BlockCanvas, FilePickerButton, QuoinProvider, UploadField, coreBlocks, englishLabels, formatShortcut, resolveLabels, useAutosave, useLabels, useQuoin } from './chunk-HSLOPJVT.js';
-export { BlockShell, EditableRegion, EditorView, SelectionSink, ViewController, VoidBlockFallback, caretFromPoint, defaultRenderers, domMapOf, hostKey, isCrossSelection, renderInline, useEditorState, useQuoinEditor, useViewController } from './chunk-XFEDJEJF.js';
+export { BlockCanvas, FilePickerButton, QuoinProvider, UploadField, coreBlocks, englishLabels, formatShortcut, resolveLabels, useAutosave, useLabels, useQuoin } from './chunk-ZN5DHNSL.js';
+export { EditableRegion, EditorView, ViewController, caretFromPoint, domMapOf, hostKey, renderInline, useEditorState, useQuoinEditor, useViewController } from './chunk-NL5J77VD.js';
+import './chunk-DLQCTGC3.js';
 export { blockByType, defineBlock, paletteBlocks } from './chunk-HDJ653LM.js';
-export { Transaction, addMarkStep, applyTransaction, blockInputRules, blockRangeSelection, coreExtensions, countDoc, countText, createEditor, createPluginKey, createState, defineExtension, fromHTML, getPluginState, insertBlockAfter, insertBlocksStep, insertText, insertTextWithRules, joinBlocksStep, keyName, markInputRules, moveBlocksStep, nodeSelection, normalizeKey, redo, removeBlocksStep, removeMarkStep, replaceBlockStep, replaceDocStep, replaceInlineStep, setAttrsStep, setBlockType, setIndentStep, splitBlockStep, stepFromJSON, textSelection, toHTML, toMarkdown, toPlainText, toggleMark, typographyRules, undo } from './chunk-OS2O6IKX.js';
-export { diffBlocks, diffInline } from './chunk-CSKKSXCE.js';
-export { PALETTE, atom, coreBlockSpecs, createBlockCodec, createSchema, fromMarkdown, normalizeInline, parseInline, sanitizeHref, serializeInline, text } from './chunk-BJTOLCRR.js';
+export { Transaction, addMarkStep, applyTransaction, blockInputRules, blockRangeSelection, coreExtensions, countDoc, countText, createEditor, createPluginKey, createState, defineExtension, fromHTML, getPluginState, insertBlockAfter, insertBlocksStep, insertText, insertTextWithRules, joinBlocksStep, keyName, markInputRules, moveBlocksStep, nodeSelection, normalizeKey, redo, removeBlocksStep, removeMarkStep, replaceBlockStep, replaceDocStep, replaceInlineStep, setAttrsStep, setBlockType, setIndentStep, splitBlockStep, stepFromJSON, textSelection, toHTML, toMarkdown, toPlainText, toggleMark, typographyRules, undo } from './chunk-5RBMZGKV.js';
+export { diffBlocks, diffInline } from './chunk-CSPCDVCT.js';
+export { PALETTE, atom, coreBlockSpecs, createBlockCodec, createSchema, fromMarkdown, normalizeInline, parseInline, sanitizeHref, serializeInline, text } from './chunk-7Y4B7NHO.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/labels-BhRJYo46.d.ts

@@ -0,0 +1,176 @@
+import { P as PALETTE } from './palette-BrX-hEd-.js';
+
+type PaletteName = (typeof PALETTE)[number];
+
+type SlashGroup = 'basic' | 'lists' | 'media' | 'advanced' | 'embeds' | 'ai' | 'custom';
+type CalloutTone = 'info' | 'tip' | 'success' | 'warning' | 'danger';
+/** The block types the menus name. Headings are named by `heading`. */
+type BlockName = 'text' | 'bulletedList' | 'numberedList' | 'todoList' | 'quote' | 'callout' | 'toggle' | 'code' | 'divider' | 'image' | 'file';
+/** The slash commands that insert a block, which the menu explains under their names. */
+type SlashBlockCommand = BlockName | 'heading1' | 'heading2' | 'heading3';
+type ModifierKey = 'ctrl' | 'alt' | 'shift';
+/** The keys a shortcut writes out by name rather than by the character they type. */
+type NamedKey = 'escape' | 'tab' | 'enter' | 'space' | 'backspace' | 'delete' | 'f10';
+type ShortcutGroupName = 'text' | 'blocks' | 'selection' | 'navigation' | 'menus';
+/** The rows of the keyboard shortcuts dialog that no other label names. */
+type ShortcutName = 'lineBreak' | 'flipBlock' | 'selectBlock' | 'openBlockEditor' | 'leaveBlockEditor' | 'selectAll' | 'extendUp' | 'extendDown' | 'lineUp' | 'lineDown' | 'leaveEditor' | 'blockMenu' | 'closeMenu' | 'splitBlock' | 'joinAbove' | 'joinBelow' | 'previousBlockEnd' | 'nextBlockStart';
+/** Every string the editor shows or speaks. A label that depends on a value is a function of it. */
+type QuoinLabels = {
+    document: string;
+    editorHint: string;
+    paragraph: string;
+    heading: (level: number) => string;
+    bulletItem: string;
+    numberedItem: (n: number) => string;
+    task: string;
+    quote: string;
+    /** The name of a callout's text, given the name of its tone from `calloutTones`, which it takes as written. */
+    callout: (tone: string) => string;
+    /** The name of each tone, on its chip and in its menus as inside the name of a callout's text. */
+    calloutTones: Record<CalloutTone, string>;
+    calloutIcon: string;
+    /** The name of the button that shows a callout's tone and opens the menu of tones, given the tone's name. */
+    calloutToneMenu: (tone: string) => string;
+    toggle: string;
+    /** The name of a toggle's chevron, given how many blocks the closed toggle hides, 0 while it is open. */
+    toggleButton: (hidden: number) => string;
+    placeholderEmpty: string;
+    placeholderHeading: (level: number) => string;
+    placeholderList: string;
+    placeholderQuote: string;
+    blockMenu: (type: string) => string;
+    blockNames: Record<BlockName, string>;
+    turnInto: string;
+    color: string;
+    textColor: string;
+    backgroundColor: string;
+    /** The submenus of a callout's block menu that set its tone and its icon. */
+    tone: string;
+    icon: string;
+    duplicate: string;
+    copy: string;
+    copyLink: string;
+    copied: string;
+    moveUp: string;
+    moveDown: string;
+    delete: string;
+    askAi: string;
+    addBelow: string;
+    dragHandle: string;
+    slashMenu: string;
+    noResults: string;
+    /** What the open slash menu says once its list settles, given how many commands match. */
+    resultCount: (n: number) => string;
+    slashDescriptions: Record<SlashBlockCommand, string>;
+    groups: Record<SlashGroup, string>;
+    bold: string;
+    italic: string;
+    underline: string;
+    strike: string;
+    code: string;
+    link: string;
+    highlight: string;
+    align: string;
+    alignLeft: string;
+    alignCenter: string;
+    alignRight: string;
+    alignJustify: string;
+    subscript: string;
+    superscript: string;
+    comment: string;
+    linkUrl: string;
+    linkApply: string;
+    linkRemove: string;
+    linkOpen: string;
+    linkEdit: string;
+    invalidLink: string;
+    colors: Record<PaletteName, string>;
+    blockMoved: (position: number, total: number) => string;
+    blockInserted: (position: number, total: number) => string;
+    blockDeleted: (n: number) => string;
+    blocksSelected: (n: number) => string;
+    /** How to bring deleted blocks back, given the platform's undo shortcut. */
+    undoHint: (shortcut: string) => string;
+    shortcuts: string;
+    shortcutGroupNames: Record<ShortcutGroupName, string>;
+    shortcutNames: Record<ShortcutName, string>;
+    /** Two keys pressed one after the other. */
+    keySequence: (first: string, then: string) => string;
+    /** Two shortcuts that do the same thing. */
+    keyAlternative: (first: string, other: string) => string;
+    /** The modifier keys a shortcut hint names away from a Mac, where it draws their symbols instead. */
+    keyNames: Record<ModifierKey, string>;
+    namedKeys: Record<NamedKey, string>;
+    formattingToolbar: string;
+    mobileToolbar: string;
+    indent: string;
+    outdent: string;
+    undo: string;
+    redo: string;
+    close: string;
+    selectedContent: string;
+    editBlock: (label: string) => string;
+    unsupportedBlock: string;
+    /** Optional so a translation written for 1.0 still compiles; English where it is missing. */
+    blockError?: string;
+    uploading: string;
+    uploaded: (name: string) => string;
+    /** What an upload field shows when the host's upload fails without a message of its own. */
+    uploadFailed: string;
+    /** What an upload field shows in place of working when the canvas was given no upload function. */
+    uploadsUnavailable: string;
+    /** An empty image block: its upload button, the link it can embed instead and what can be dropped or pasted on it. */
+    uploadImage: string;
+    embedLink: string;
+    imageLink: string;
+    dropImage: string;
+    /** An image block: its caption, its toolbar, the handles of its width with their value, and the toolbar's buttons. */
+    imageCaption: string;
+    addCaption: string;
+    imageTools: string;
+    resizeFromLeft: string;
+    resizeFromRight: string;
+    widthValue: (percent: number) => string;
+    replaceImage: string;
+    download: string;
+    /** The alt text of an image: its field, what the field asks for, its button, and the name of an image without one. */
+    altText: string;
+    altTextHint: string;
+    save: string;
+    imageNoAlt: string;
+    /**
+     * The checkbox of the alt text popover that marks an image as deliberately without a description, the visible text of
+     * the badge an editable canvas draws over an image that has neither, and the badge's name, which starts with that
+     * visible text and then says what it does. A translation that sets `noAltBadge` should set `addAltText` too; with `noAltBadge` alone the
+     * badge is named by its visible text. Optional like `blockError`.
+     */
+    decorativeImage?: string;
+    noAltBadge?: string;
+    addAltText?: string;
+    /** An empty file block: its upload button and what can be dropped or pasted on it. */
+    uploadFile: string;
+    dropFile: string;
+    /** A file block: its toolbar and the toolbar's replace button. */
+    fileTools: string;
+    replaceFile: string;
+    /** The name of a file's download link, given the file's name. It contains `download`, the link's visible text. */
+    downloadFile: (name: string) => string;
+    /** The size of a file, given in bytes. */
+    fileSize: (bytes: number) => string;
+    /** The name of a file block selected as a whole, given the file's name. */
+    fileBlockName: (name: string) => string;
+    /** A code block: its code, its language, the name of a code in no language, and its copy button. */
+    codeText: string;
+    /** The name of a code block selected as a whole, given the name of its language. */
+    codeBlockName: (language: string) => string;
+    codeLanguage: string;
+    plainText: string;
+    copyCode: string;
+    /** What the preview of a block without content says. */
+    emptyImage: string;
+    emptyFile: string;
+    emptyMarkdown: string;
+    emptyCallout: string;
+};
+
+export type { QuoinLabels as Q, SlashGroup as S };

package/dist/labels-CiCxj2jP.d.cts

@@ -0,0 +1,176 @@
+import { P as PALETTE } from './palette-BrX-hEd-.cjs';
+
+type PaletteName = (typeof PALETTE)[number];
+
+type SlashGroup = 'basic' | 'lists' | 'media' | 'advanced' | 'embeds' | 'ai' | 'custom';
+type CalloutTone = 'info' | 'tip' | 'success' | 'warning' | 'danger';
+/** The block types the menus name. Headings are named by `heading`. */
+type BlockName = 'text' | 'bulletedList' | 'numberedList' | 'todoList' | 'quote' | 'callout' | 'toggle' | 'code' | 'divider' | 'image' | 'file';
+/** The slash commands that insert a block, which the menu explains under their names. */
+type SlashBlockCommand = BlockName | 'heading1' | 'heading2' | 'heading3';
+type ModifierKey = 'ctrl' | 'alt' | 'shift';
+/** The keys a shortcut writes out by name rather than by the character they type. */
+type NamedKey = 'escape' | 'tab' | 'enter' | 'space' | 'backspace' | 'delete' | 'f10';
+type ShortcutGroupName = 'text' | 'blocks' | 'selection' | 'navigation' | 'menus';
+/** The rows of the keyboard shortcuts dialog that no other label names. */
+type ShortcutName = 'lineBreak' | 'flipBlock' | 'selectBlock' | 'openBlockEditor' | 'leaveBlockEditor' | 'selectAll' | 'extendUp' | 'extendDown' | 'lineUp' | 'lineDown' | 'leaveEditor' | 'blockMenu' | 'closeMenu' | 'splitBlock' | 'joinAbove' | 'joinBelow' | 'previousBlockEnd' | 'nextBlockStart';
+/** Every string the editor shows or speaks. A label that depends on a value is a function of it. */
+type QuoinLabels = {
+    document: string;
+    editorHint: string;
+    paragraph: string;
+    heading: (level: number) => string;
+    bulletItem: string;
+    numberedItem: (n: number) => string;
+    task: string;
+    quote: string;
+    /** The name of a callout's text, given the name of its tone from `calloutTones`, which it takes as written. */
+    callout: (tone: string) => string;
+    /** The name of each tone, on its chip and in its menus as inside the name of a callout's text. */
+    calloutTones: Record<CalloutTone, string>;
+    calloutIcon: string;
+    /** The name of the button that shows a callout's tone and opens the menu of tones, given the tone's name. */
+    calloutToneMenu: (tone: string) => string;
+    toggle: string;
+    /** The name of a toggle's chevron, given how many blocks the closed toggle hides, 0 while it is open. */
+    toggleButton: (hidden: number) => string;
+    placeholderEmpty: string;
+    placeholderHeading: (level: number) => string;
+    placeholderList: string;
+    placeholderQuote: string;
+    blockMenu: (type: string) => string;
+    blockNames: Record<BlockName, string>;
+    turnInto: string;
+    color: string;
+    textColor: string;
+    backgroundColor: string;
+    /** The submenus of a callout's block menu that set its tone and its icon. */
+    tone: string;
+    icon: string;
+    duplicate: string;
+    copy: string;
+    copyLink: string;
+    copied: string;
+    moveUp: string;
+    moveDown: string;
+    delete: string;
+    askAi: string;
+    addBelow: string;
+    dragHandle: string;
+    slashMenu: string;
+    noResults: string;
+    /** What the open slash menu says once its list settles, given how many commands match. */
+    resultCount: (n: number) => string;
+    slashDescriptions: Record<SlashBlockCommand, string>;
+    groups: Record<SlashGroup, string>;
+    bold: string;
+    italic: string;
+    underline: string;
+    strike: string;
+    code: string;
+    link: string;
+    highlight: string;
+    align: string;
+    alignLeft: string;
+    alignCenter: string;
+    alignRight: string;
+    alignJustify: string;
+    subscript: string;
+    superscript: string;
+    comment: string;
+    linkUrl: string;
+    linkApply: string;
+    linkRemove: string;
+    linkOpen: string;
+    linkEdit: string;
+    invalidLink: string;
+    colors: Record<PaletteName, string>;
+    blockMoved: (position: number, total: number) => string;
+    blockInserted: (position: number, total: number) => string;
+    blockDeleted: (n: number) => string;
+    blocksSelected: (n: number) => string;
+    /** How to bring deleted blocks back, given the platform's undo shortcut. */
+    undoHint: (shortcut: string) => string;
+    shortcuts: string;
+    shortcutGroupNames: Record<ShortcutGroupName, string>;
+    shortcutNames: Record<ShortcutName, string>;
+    /** Two keys pressed one after the other. */
+    keySequence: (first: string, then: string) => string;
+    /** Two shortcuts that do the same thing. */
+    keyAlternative: (first: string, other: string) => string;
+    /** The modifier keys a shortcut hint names away from a Mac, where it draws their symbols instead. */
+    keyNames: Record<ModifierKey, string>;
+    namedKeys: Record<NamedKey, string>;
+    formattingToolbar: string;
+    mobileToolbar: string;
+    indent: string;
+    outdent: string;
+    undo: string;
+    redo: string;
+    close: string;
+    selectedContent: string;
+    editBlock: (label: string) => string;
+    unsupportedBlock: string;
+    /** Optional so a translation written for 1.0 still compiles; English where it is missing. */
+    blockError?: string;
+    uploading: string;
+    uploaded: (name: string) => string;
+    /** What an upload field shows when the host's upload fails without a message of its own. */
+    uploadFailed: string;
+    /** What an upload field shows in place of working when the canvas was given no upload function. */
+    uploadsUnavailable: string;
+    /** An empty image block: its upload button, the link it can embed instead and what can be dropped or pasted on it. */
+    uploadImage: string;
+    embedLink: string;
+    imageLink: string;
+    dropImage: string;
+    /** An image block: its caption, its toolbar, the handles of its width with their value, and the toolbar's buttons. */
+    imageCaption: string;
+    addCaption: string;
+    imageTools: string;
+    resizeFromLeft: string;
+    resizeFromRight: string;
+    widthValue: (percent: number) => string;
+    replaceImage: string;
+    download: string;
+    /** The alt text of an image: its field, what the field asks for, its button, and the name of an image without one. */
+    altText: string;
+    altTextHint: string;
+    save: string;
+    imageNoAlt: string;
+    /**
+     * The checkbox of the alt text popover that marks an image as deliberately without a description, the visible text of
+     * the badge an editable canvas draws over an image that has neither, and the badge's name, which starts with that
+     * visible text and then says what it does. A translation that sets `noAltBadge` should set `addAltText` too; with `noAltBadge` alone the
+     * badge is named by its visible text. Optional like `blockError`.
+     */
+    decorativeImage?: string;
+    noAltBadge?: string;
+    addAltText?: string;
+    /** An empty file block: its upload button and what can be dropped or pasted on it. */
+    uploadFile: string;
+    dropFile: string;
+    /** A file block: its toolbar and the toolbar's replace button. */
+    fileTools: string;
+    replaceFile: string;
+    /** The name of a file's download link, given the file's name. It contains `download`, the link's visible text. */
+    downloadFile: (name: string) => string;
+    /** The size of a file, given in bytes. */
+    fileSize: (bytes: number) => string;
+    /** The name of a file block selected as a whole, given the file's name. */
+    fileBlockName: (name: string) => string;
+    /** A code block: its code, its language, the name of a code in no language, and its copy button. */
+    codeText: string;
+    /** The name of a code block selected as a whole, given the name of its language. */
+    codeBlockName: (language: string) => string;
+    codeLanguage: string;
+    plainText: string;
+    copyCode: string;
+    /** What the preview of a block without content says. */
+    emptyImage: string;
+    emptyFile: string;
+    emptyMarkdown: string;
+    emptyCallout: string;
+};
+
+export type { QuoinLabels as Q, SlashGroup as S };