npm - laif-ds - Versions diffs - 0.2.83 → 0.2.85 - Mend

laif-ds 0.2.83 → 0.2.85

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/dist/CHANGELOG.md +30 -0
package/dist/agent-docs/adoption-report.json +17 -13
package/dist/agent-docs/components/AppEditor.md +117 -7
package/dist/agent-docs/manifest.json +119 -13
package/dist/components/editor/nodes/mention-node.js +113 -0
package/dist/components/editor/plugins/mention-plugin.js +224 -0
package/dist/components/editor/plugins/toolbar/mention-insert-toolbar-plugin.js +41 -0
package/dist/components/ui/app-editor.js +150 -112
package/dist/index.d.ts +40 -4
package/dist/node_modules/@lexical/markdown/LexicalMarkdown.prod.js +5 -5
package/dist/node_modules/@lexical/react/LexicalTypeaheadMenuPlugin.prod.js +220 -0
package/dist/node_modules/lexical/Lexical.prod.js +314 -303
package/dist/styles.v3.css +1 -1
package/package.json +1 -1
/package/dist/agent-docs/{truncated-cell.md → components/truncated-cell.md} +0 -0

package/dist/CHANGELOG.md CHANGED Viewed

@@ -5,6 +5,36 @@ All notable technical changes to the laif-ds core will be documented in this fil
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## [laif-ds@0.2.85]
+### 🐛 Fixed
+- **AppEditor**: The `@mention` typeahead menu now renders above modals. The menu is portaled to `<body>`, so inside a laif-ds `Dialog` it was hidden behind the overlay (z-index had no effect on the statically-positioned menu) and, once visible, its options were unclickable (Radix sets `pointer-events:none` on `<body>` while a modal is open). The menu is now positioned with a higher stacking order and re-enables pointer events, so it is both visible and selectable inside dialogs (see issue ISS-235)
+## [laif-ds@0.2.84]
+### 🚀 Added
+- **AppEditor**: Added opt-in `@mention` support — pass a `mentions` prop (a `MentionItem[]` or an async loader) to register the mention node, plugin, transformer and a toolbar insert button. Typing the trigger (configurable via `mentionTrigger`, default `@`) opens a searchable people menu; selected mentions render as atomic, removable chips. `onValueChange` now reports `meta.mentions` — the deduped (by `id`) list of mentions present in the text. Mentions serialize to a round-trippable markdown token (`@[label](mention:id?v=value)`). When `mentions` is omitted, the node/plugin/transformer are not registered and output is byte-identical to a mention-less editor
+### 🔧 Changed
+- **AppEditor**: Mention chips are now primary-tinted (`text-d-primary` on a de-opacified `bg-d-primary/10` background) so they stand out from surrounding text without the solid fill of a primary CTA
+### 🐛 Fixed
+- **AppEditor**: Fixed the caret resetting to the start of the editor on every keystroke in the `Default` story by seeding `defaultValue` from a stable constant instead of feeding live state back into the uncontrolled prop
+## [laif-ds@0.2.83]
+### 🚀 Added
+- **FileUploader**: Added an `onRemove(removed: File[], remaining: File[])` callback fired when files are removed (single file or remove-all), reporting the removed files and the remaining list
+### 🔧 Changed
+- **FileUploader**: Removals now notify via `onRemove` instead of `onUpload` — `onUpload` fires only on add. Consumers mirroring the file list in their own state must wire both callbacks (e.g. `onRemove={(_, remaining) => setFiles(remaining)}`); the previous behavior, where removing the last file silently failed to propagate, is fixed (see issue #84)
 ## [laif-ds@0.2.82]
 ### 🚀 Added

package/dist/agent-docs/adoption-report.json CHANGED Viewed

@@ -1,12 +1,12 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-06-09T07:56:53.942Z",
+  "generatedAt": "2026-06-30T13:45:32.734Z",
   "package": {
     "name": "laif-ds",
-    "version": "0.2.83"
+    "version": "0.2.85"
   },
   "summary": {
-    "scannedFiles": 394,
+    "scannedFiles": 397,
     "deprecatedComponentsCount": 2,
     "deprecatedComponentsUsedCount": 0,
     "componentsWithoutExamplesCount": 5,
@@ -14,8 +14,8 @@
     "repeatedClassPatternsCount": 25,
     "lowAiReadinessComponentsCount": 42,
     "componentsWithoutAccessibilityCoverageCount": 46,
-    "componentsWithWeakStateCoverageCount": 73,
-    "averageAiReadinessScore": 54.73
+    "componentsWithWeakStateCoverageCount": 72,
+    "averageAiReadinessScore": 55.38
   },
   "deprecatedUsage": [],
   "documentationGaps": {
@@ -111,7 +111,6 @@
       "Alert",
       "AlertDialog",
       "AppDialog",
-      "AppEditor",
       "AppMultipleSelectDropdown",
       "AppSidebar",
       "AspectRatio",
@@ -551,6 +550,18 @@
           "src/components/stories/spinner.stories.tsx"
         ]
       },
+      {
+        "className": "text-d-muted-foreground text-xs",
+        "occurrences": 6,
+        "files": [
+          "src/components/editor/plugins/mention-plugin.tsx",
+          "src/components/stories/app-card.stories.tsx",
+          "src/components/stories/input.stories.tsx",
+          "src/components/ui/tables/data-cross-table/cell-editor-dialog.tsx",
+          "src/components/ui/tables/data-cross-table/data-cross-table.tsx",
+          "src/components/ui/tables/data-cross-table/editable-input.tsx"
+        ]
+      },
       {
         "className": "flex items-center gap-1 font-normal",
         "occurrences": 6,
@@ -605,13 +616,6 @@
           "src/components/stories/data-table-no-utils-example.stories.tsx",
           "src/components/stories/data-table-utils-example.stories.tsx"
         ]
-      },
-      {
-        "className": "mx-1 rounded bg-gray-200 px-1",
-        "occurrences": 6,
-        "files": [
-          "src/components/stories/data-table-utils-example.stories.tsx"
-        ]
       }
     ]
   }

package/dist/agent-docs/components/AppEditor.md CHANGED Viewed

@@ -11,12 +11,26 @@ Rich text editor powered by Lexical with optional Markdown sync. Supports config
 | Prop             | Type                         | Default                                               | Description                                                                                             |
 | ---------------- | ---------------------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- | ---------------------- |
 | `defaultValue`   | `string`                     | `undefined`                                           | Initial content. Interpreted as Markdown when `onlyMarkdown=true`, plain text otherwise.                |
-| `onMarkdownEdit` | `(markdown: string) => void` | `undefined`                                           | Emits current content as Markdown on change.                                                            |
-| `plugins`        | `("clear"                    | "counter")[]`                                         | `[]`                                                                                                    | Enable optional plugins: clear buttons, character counter. |
-| `toolbars`       | `("block-format"             | "font-format"                                         | "history")[]`                                                                                           | `[]`                                                       | Enable toolbar groups. |
+| `onValueChange`  | `(markdown: string, meta: { mentions: MentionItem[] }) => void` | `undefined`        | Fires on every edit with the current Markdown and a metadata object. `meta.mentions` is the deduped (by `id`) list of mentions in the text (empty when mentions are disabled). Takes precedence over `onMarkdownEdit`. |
+| `onMarkdownEdit` | `(markdown: string) => void` | `undefined`                                           | **Deprecated** — use `onValueChange`. Still honored as a fallback when `onValueChange` is not provided, but never receives mention metadata. |
+| `plugins`        | `("clear" \| "counter")[]`   | `[]`                                                  | Enable optional plugins: clear buttons, character counter.                                              |
+| `toolbars`       | `("block-format" \| "font-format" \| "history")[]` | `[]`                            | Enable toolbar groups.                                                                                  |
 | `placeholder`    | `string`                     | `"Start typing..."`                                   | Placeholder for empty editor.                                                                           |
 | `onlyMarkdown`   | `boolean`                    | `true`                                                | Treat `defaultValue` as Markdown and sync editor to Markdown. If `false`, `defaultValue` is plain text. |
 | `className`      | `string`                     | `"overflow-hidden rounded-lg border border-d-border"` | Extra classes for the content editable.                                                                 |
+| `mentions`         | `MentionItem[] \| (() => MentionItem[] \| Promise<MentionItem[]>)` | `undefined` | Enables @mention support when provided. Either a ready array (filtered client-side) or a **loader** called once on first menu open (no preload on mount). When omitted, no mention node/plugin/transformer is registered and output is identical to a mention-less editor. |
+| `mentionTrigger`   | `string`                   | `"@"`       | Single character that opens the mention typeahead menu.                                                 |
+### MentionItem
+```ts
+type MentionItem = {
+  id: string | number; // stable identifier (mandatory join key)
+  label: string; // shown text + rendered in the chip
+  value?: string; // free-form metadata (email, phone, URL, …)
+  sublabel?: string; // optional secondary line in the menu
+};
+```
 ---
@@ -31,8 +45,45 @@ Rich text editor powered by Lexical with optional Markdown sync. Supports config
 - **Plugins**:
   - `clear`: clear actions in the footer.
   - `counter`: UTF-16 character counter in the footer.
-- **Editing**: Autosave via `onMarkdownEdit`. Keyboard navigation and selection per Lexical defaults.
+- **Editing**: Autosave via `onValueChange`. Keyboard navigation and selection per Lexical defaults.
 - **Markdown Features**: Full support for headings, lists, quotes, links, inline code, bold, italic, strikethrough, and custom underline syntax.
+- **Mentions** (opt-in via `mentions`):
+  - `mentions` is either a ready `MentionItem[]` or a **loader function** `() => MentionItem[] | Promise<MentionItem[]>`. The loader is called **once, the first time the menu opens**, so a large list is never preloaded on mount; while it resolves the menu shows a `Loading…` row, and on failure a `Couldn't load mentions` row (re-opening the menu retries). The resolved list is then filtered client-side like the array form.
+  - With the **loader form**, `meta.mentions` cannot reconcile against a synchronous source list, so its emitted items carry `id`/`label`/`value` from the chip but **not `sublabel`** (which is menu-only metadata). The array form preserves `sublabel`.
+  - Typing `mentionTrigger` (default `@`) opens a typeahead menu filtering `mentions` by `label` (case-insensitive, word-prefix match).
+  - Selecting an item inserts a single **non-editable chip token** (not free text), styled with the secondary token family (`bg-d-secondary text-d-secondary-foreground`, the same as `<Badge variant="secondary">`) so it does not compete with primary-CTA buttons.
+  - Each chip carries a built-in **remove control** (a small `X` button with a ≥44pt hit area, `aria-label="Remove mention <label>"`) that deletes the mention. Removal fires `onValueChange` through the normal change path.
+  - When `mentions` is set **and** the `font-format` toolbar is enabled, an `@` insert button (`aria-label="Insert mention"`) appears immediately after the strikethrough button; clicking it inserts the trigger character at the caret and opens the typeahead menu. The button is hidden when `mentions` is not provided (or the `font-format` toolbar is not enabled).
+  - The menu shows `label` and `sublabel` (when present) and is fully keyboard-driven (↑/↓ navigate, Enter selects, Esc closes). When a non-empty query matches nothing, the menu shows a non-interactive `No matches for "<query>"` row.
+  - **Source of truth for tags is `onValueChange`'s `meta.mentions`, not the body.** Consumers should persist the deduped `MentionItem[]` it emits rather than parse the markdown body. The body markdown is for rendering/round-trip only.
+### Mention markdown serialization
+When mentions are enabled, each chip serializes to a stable, round-trip-safe token:
+```
+@[<encodedLabel>](mention:<encodedId>)                 # when no value
+@[<encodedLabel>](mention:<encodedId>?v=<encodedValue>) # when a value is present
+```
+`<encodedLabel>`, `<encodedId>`, and `<encodedValue>` are all `encodeURIComponent`-encoded, so a value containing `]`, `)`, `?`, newlines, or `++` cannot break the parser, corrupt the round-trip, or be mangled by the `++`→`<u>` underline substitution. On import the segments are decoded with a safe fallback: a malformed `%`-sequence falls back to the raw segment instead of throwing, so one bad token never aborts the whole markdown import. The chip and menu always render the human-readable label from the node fields, never from the token text.
+This token is parsed back into a chip on import (reconstructing `label`, `id`, and `value`), so mentions survive the markdown round-trip. The mention transformer is appended to the editor transformers **only when `mentions` is provided** — without it, markdown output is byte-identical to a mention-less editor.
+### Dedup, reconciliation, and id types
+`meta.mentions` keys on the **mandatory `id`** (not `value`). For each mention currently in the text:
+- If the mention is still in the `mentions` prop, the original source `MentionItem` is returned **verbatim** — its original `id` type (e.g. `number`), `value`, and `sublabel` are preserved.
+- If it is an **orphan** (e.g. imported from a saved token, no longer in `mentions`), the node's own data is returned. In this case the emitted `id` may be a **string**, since the token carries the id as text.
+The emitted list is deduped by `id`, so mentioning the same person multiple times yields a single entry.
+### Mention accessibility
+- The menu is a `role="listbox"` with a stable `id` and `aria-label="People you can mention"`; each option is a `role="option"` with a stable `id` and `aria-selected`.
+- While the menu is open, the contenteditable's `aria-activedescendant` points at the highlighted option's id (cleared on close).
+- The chip exposes `aria-roledescription="mention"` and `aria-label="Mention: <label>[, <value>]"`; its remove button has `aria-label="Remove mention <label>"`.
 ---
@@ -50,7 +101,7 @@ export function EditorFull() {
     <div className="space-y-4">
       <AppEditor
         defaultValue={markdown}
-        onMarkdownEdit={setMarkdown}
+        onValueChange={setMarkdown}
         toolbars={["block-format", "font-format", "history"]}
         plugins={["clear", "counter"]}
         className="h-96"
@@ -76,7 +127,7 @@ export function MarkdownDefault() {
   return (
     <AppEditor
       defaultValue={initial}
-      onMarkdownEdit={setMd}
+      onValueChange={setMd}
       toolbars={["block-format", "font-format", "history"]}
     />
   );
@@ -95,7 +146,64 @@ export function UnderlineExample() {
   return (
     <AppEditor
       defaultValue={initial}
-      onMarkdownEdit={setMd}
+      onValueChange={setMd}
+      toolbars={["font-format"]}
+    />
+  );
+}
+```
+### Mentions
+```tsx
+import * as React from "react";
+import { AppEditor, type MentionItem } from "laif-ds";
+const people: MentionItem[] = [
+  { id: 1, label: "Alice Rossi", value: "alice@laif.it", sublabel: "Product" },
+  { id: 2, label: "Bob Bianchi", value: "bob@laif.it", sublabel: "Engineering" },
+];
+export function EditorWithMentions() {
+  const [markdown, setMarkdown] = React.useState("");
+  // Persist this list — it is the source of truth for tags, not the body.
+  const [mentions, setMentions] = React.useState<MentionItem[]>([]);
+  return (
+    <AppEditor
+      mentions={people}
+      onValueChange={(md, { mentions }) => {
+        setMarkdown(md);
+        setMentions(mentions);
+      }}
+      mentionTrigger="@"
+      toolbars={["font-format"]}
+    />
+  );
+}
+```
+The emitted markdown contains tokens like `Ping @[Alice%20Rossi](mention:1?v=alice%40laif.it) about this`, while `meta.mentions` yields `[{ id: 1, label: "Alice Rossi", value: "alice@laif.it", sublabel: "Product" }]` (the source item, returned verbatim).
+### Async mentions (lazy loader)
+```tsx
+import * as React from "react";
+import { AppEditor, type MentionItem } from "laif-ds";
+export function EditorWithAsyncMentions() {
+  const [mentions, setMentions] = React.useState<MentionItem[]>([]);
+  // Called ONCE the first time the menu opens — never preloaded on mount.
+  const loadPeople = async (): Promise<MentionItem[]> => {
+    const users = await fetchApi("/users");
+    return users.map((u) => ({ id: u.id, label: u.name, value: u.email }));
+  };
+  return (
+    <AppEditor
+      mentions={loadPeople}
+      onValueChange={(_md, meta) => setMentions(meta.mentions)}
       toolbars={["font-format"]}
     />
   );
@@ -111,3 +219,5 @@ export function UnderlineExample() {
 - **Accessibility**: Toolbar buttons and editor area follow Lexical best practices.
 - **Underline Syntax**: Uses `<u>text</u>` HTML tags for underline, which is standard HTML and natively supported by both this component and `MarkdownRenderer` via `rehype-raw`.
 - **Theme**: Uses design system tokens for consistent styling with `border-d-border`, `bg-d-background`, etc.
+- **Mention remove control sizing**: The inline mention remove `X` button is intentionally sized for desktop pointers (20px), not the 44pt touch-target minimum — `AppEditor` is a desktop authoring surface. Mentions are also removable via Backspace (the chip is an atomic token), so the small control is not the only removal path.
+- **Mention trigger**: `mentionTrigger` must be a single character; any multi-character or empty value falls back to `"@"`.

package/dist/agent-docs/manifest.json CHANGED Viewed

@@ -1,17 +1,17 @@
 {
   "schemaVersion": "1.1.0",
-  "generatedAt": "2026-06-09T07:56:53.318Z",
+  "generatedAt": "2026-06-30T13:45:32.075Z",
   "package": {
     "name": "laif-ds",
-    "version": "0.2.83"
+    "version": "0.2.85"
   },
   "stats": {
-    "documentedComponentCount": 92,
+    "documentedComponentCount": 93,
     "catalogedComponentCount": 92,
     "missingFromDocsCount": 1,
     "deprecatedComponentCount": 2,
-    "averageAiReadinessScore": 54.73,
-    "highAiReadinessCount": 36,
+    "averageAiReadinessScore": 55.38,
+    "highAiReadinessCount": 37,
     "lowAiReadinessCount": 42
   },
   "missingFromDocs": [
@@ -530,35 +530,45 @@
         "hasPropsTable": true,
         "hasExamples": true,
         "exampleTitles": [
+          "MentionItem",
+          "Mention markdown serialization",
+          "Dedup, reconciliation, and id types",
+          "Mention accessibility",
           "Full Toolbar + Plugins",
           "Markdown Default Value",
-          "Underline Support"
+          "Underline Support",
+          "Mentions",
+          "Async mentions (lazy loader)"
         ],
         "controlledPattern": "likely-controlled",
         "requiredProps": []
       },
       "metadata": {
         "props": {
-          "totalProps": 7,
+          "totalProps": 10,
           "requiredPropsCount": 0,
-          "typedPropsCount": 7,
-          "describedPropsCount": 7
+          "typedPropsCount": 10,
+          "describedPropsCount": 10
         },
         "accessibility": {
           "hasCoverage": true
         },
         "states": {
           "coveredStates": [
-            "empty"
+            "disabled",
+            "loading",
+            "empty",
+            "selected"
           ],
-          "coveredStateCount": 1
+          "coveredStateCount": 4
         }
       },
       "aiReadiness": {
-        "score": 85,
+        "score": 100,
         "tier": "high"
       },
       "typeReferences": [
+        "interface AppEditorChangeMeta {\r",
         "interface AppEditorProps {\r",
         "type AppEditorPlugin = \"clear\" | \"counter\";\r",
         "type AppEditorToolbar = \"block-format\" | \"font-format\" | \"history\";\r"
@@ -5887,6 +5897,102 @@
         "interface TooltipContentProps extends React_2.ComponentProps<typeof TooltipPrimitive.Content>, VariantProps<typeof tooltipVariants> {\r"
       ]
     },
+    {
+      "name": "truncated-cell",
+      "markdownPath": "components/truncated-cell.md",
+      "importPath": "laif-ds",
+      "deprecated": false,
+      "replacement": null,
+      "tags": {
+        "cataloged": false,
+        "aiReady": true
+      },
+      "docs": {
+        "sections": [
+          {
+            "title": "Features",
+            "slug": "features"
+          },
+          {
+            "title": "Usage",
+            "slug": "usage"
+          },
+          {
+            "title": "Props",
+            "slug": "props"
+          },
+          {
+            "title": "Behavior",
+            "slug": "behavior"
+          },
+          {
+            "title": "Technical Details",
+            "slug": "technical-details"
+          },
+          {
+            "title": "Accessibility",
+            "slug": "accessibility"
+          },
+          {
+            "title": "Examples",
+            "slug": "examples"
+          },
+          {
+            "title": "Comparison with Alternatives",
+            "slug": "comparison-with-alternatives"
+          }
+        ],
+        "hasPropsTable": true,
+        "hasExamples": true,
+        "exampleTitles": [
+          "Truncation Detection",
+          "Visual States",
+          "Styling",
+          "Content Types",
+          "Choosing Between `children` and `text`",
+          "Custom Popover Content",
+          "Button Visibility Control",
+          "Empty Fallback",
+          "Popover Styling",
+          "Dependencies",
+          "Performance Optimizations",
+          "Event Handling",
+          "Accessibility Features",
+          "In a Table Cell",
+          "With Maximum Width Constraint",
+          "Multiline Text Support",
+          "vs Tooltip",
+          "vs CSS text-overflow alone",
+          "vs Expandable Text"
+        ],
+        "controlledPattern": "likely-controlled",
+        "requiredProps": []
+      },
+      "metadata": {
+        "props": {
+          "totalProps": 9,
+          "requiredPropsCount": 0,
+          "typedPropsCount": 9,
+          "describedPropsCount": 9
+        },
+        "accessibility": {
+          "hasCoverage": true
+        },
+        "states": {
+          "coveredStates": [
+            "hover",
+            "focus",
+            "empty"
+          ],
+          "coveredStateCount": 3
+        }
+      },
+      "aiReadiness": {
+        "score": 100,
+        "tier": "high"
+      },
+      "typeReferences": []
+    },
     {
       "name": "TypingIndicator",
       "markdownPath": "components/TypingIndicator.md",
@@ -6061,5 +6167,5 @@
       ]
     }
   ],
-  "checksum": "911fd5d24f66568dc9007439161320c179ac69eaed81a631fe5b38ffc901e9c7"
+  "checksum": "7f642d50b2acfeced3ccdf69ffdba0041f4c65b70e3b54ae8d47ba311c8637a9"
 }

package/dist/components/editor/nodes/mention-node.js ADDED Viewed

@@ -0,0 +1,113 @@
+"use client";
+import { jsx as o, jsxs as s } from "react/jsx-runtime";
+import { useLexicalComposerContext as m } from "../../../node_modules/@lexical/react/LexicalComposerContext.prod.js";
+import { DecoratorNode as u, $getNodeByKey as c } from "../../../node_modules/lexical/Lexical.prod.js";
+import { Icon as _ } from "../../ui/icon.js";
+const p = "bg-d-primary/10 text-d-primary inline-flex items-center gap-0.5 rounded-md py-0.5 pr-0.5 pl-1.5 text-sm font-medium align-baseline", d = "ml-0.5 inline-flex size-5 items-center justify-center rounded-sm hover:bg-d-primary/20 cursor-pointer";
+function b({ nodeKey: n, data: e }) {
+  const [i] = m(), a = () => {
+    i.update(() => {
+      const r = c(n);
+      f(r) && r.remove();
+    });
+  }, l = e.value ? `Mention: ${e.label}, ${e.value}` : `Mention: ${e.label}`;
+  return /* @__PURE__ */ s(
+    "span",
+    {
+      className: p,
+      "data-mention-id": e.id,
+      "aria-roledescription": "mention",
+      "aria-label": l,
+      children: [
+        "@",
+        e.label,
+        /* @__PURE__ */ o(
+          "button",
+          {
+            type: "button",
+            className: d,
+            "aria-label": `Remove mention ${e.label}`,
+            onClick: a,
+            children: /* @__PURE__ */ o(_, { name: "X", size: "xs", "aria-hidden": !0 })
+          }
+        )
+      ]
+    }
+  );
+}
+class t extends u {
+  __mentionId;
+  __mentionLabel;
+  __mentionValue;
+  static getType() {
+    return "mention";
+  }
+  static clone(e) {
+    return new t(
+      {
+        id: e.__mentionId,
+        label: e.__mentionLabel,
+        value: e.__mentionValue
+      },
+      e.__key
+    );
+  }
+  constructor(e, i) {
+    super(i), this.__mentionId = e.id, this.__mentionLabel = e.label, this.__mentionValue = e.value;
+  }
+  static importJSON(e) {
+    return h({
+      id: e.mentionId,
+      label: e.mentionLabel,
+      value: e.mentionValue
+    });
+  }
+  exportJSON() {
+    return {
+      ...super.exportJSON(),
+      type: "mention",
+      version: 1,
+      mentionId: this.__mentionId,
+      mentionLabel: this.__mentionLabel,
+      mentionValue: this.__mentionValue
+    };
+  }
+  static importDOM() {
+    return null;
+  }
+  getMentionData() {
+    return {
+      id: this.__mentionId,
+      label: this.__mentionLabel,
+      value: this.__mentionValue
+    };
+  }
+  // Plain-text representation (used by $rootTextContent, copy/paste, counters).
+  // Intentionally returns the human-readable `@label`, NOT the markdown token —
+  // the token is the markdown-serialization concern (see MENTION_TRANSFORMER),
+  // while plain-text consumers want readable text.
+  getTextContent() {
+    return `@${this.__mentionLabel}`;
+  }
+  createDOM() {
+    const e = document.createElement("span");
+    return e.setAttribute("data-slot", "mention-node"), e;
+  }
+  updateDOM() {
+    return !1;
+  }
+  decorate() {
+    return /* @__PURE__ */ o(b, { nodeKey: this.getKey(), data: this.getMentionData() });
+  }
+}
+function h(n) {
+  return new t(n);
+}
+function f(n) {
+  return n instanceof t;
+}
+export {
+  h as $createMentionNode,
+  f as $isMentionNode,
+  t as MentionNode
+};