Type :smile: or :) to insert an emoji.
',\n});\n```\n\nTyping `:smile:` converts to an emoji node as soon as the closing colon lands. With\n`enableEmoticons: true`, emoticons like `:)` and `<3` convert on the space typed after\nthem, and that space is kept. Neither rule fires inside a code block or inline code.\nTyping `:` followed by a name opens the suggestion dropdown (when a `render` factory is\nprovided).\n\n> The default suggestion dropdown is styled by `@domternal/theme`\n> (`_emoji-picker.scss`, via the `dm-emoji-suggestion` classes). Import the theme,\n> or supply your own `render` factory if you want fully custom markup.\n\n## Commands\n\n```ts\neditor.commands.insertEmoji('fire'); // insert by EmojiItem name (not shortcode)\neditor.commands.suggestEmoji(); // inserts the ':' trigger to open the picker (requires suggestion configured)\n```\n\n## Options\n\n- `emojis` - dataset to use. Defaults to the built-in ~200 popular emoji; pass\n `allEmojis` for the extended ~500-emoji set, or your own `EmojiItem[]`.\n- `enableEmoticons` - convert text emoticons like `:)` and `<3`. Default `false`.\n- `plainText` - insert the raw emoji character instead of an atom node. Default `false`.\n- `suggestion` - `SuggestionOptions` for the autocomplete picker, or `null` to disable. Default `null`.\n- `toolbar` - show the emoji button in the toolbar. Default `true`.\n- `HTMLAttributes` - attributes applied to the rendered emoji `span`.\n\nFor a custom picker, drive the headless plugin directly with `createSuggestionPlugin`\nand read its state via `emojiSuggestionPluginKey`. The `Emoji` storage also exposes\n`searchEmoji`, `findEmoji`, `getFrequentlyUsed`, and `addFrequentlyUsed`.\n\n## Localization\n\nThis package exports `emojiMessages` for typed custom catalogs. Optional German UI\nmessages are available from `@domternal/extension-emoji/locales/de` as `deMessages` and\n`deSearchAliases`. Merge them with the core and other enabled feature catalogs. Missing\nentries fall back to English. Emoji names, shortcodes, and custom dataset labels remain\napplication-owned.\n","readmeFilename":"README.md"}