laif-ds 0.2.80 → 0.2.84

package/dist/CHANGELOG.md

@@ -5,6 +5,46 @@ 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.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
+
+- **Chat**: Added a `placeholder` prop forwarded to the message input, allowing a custom composer placeholder (defaults to `"Ask AI..."`)
+
+## [laif-ds@0.2.81]
+
+### 🚀 Added
+
+- **FilePreviewer**: Added a `size` option to `PreviewOptions` (`sm` | `default` | `lg` | `xl` | `full`, defaults to `xl`) to control the preview dialog size per call
+
+### 🔧 Changed
+
+- **FilePreviewer**: Migrated from the low-level `Dialog` to `AppDialog`, simplifying the markup and relying on its built-in header and configurable sizing
+
 ## [laif-ds@0.2.80]
 
 ### 🚀 Added

package/dist/_virtual/index3.js

@@ -1,8 +1,8 @@
 "use client";
-import { getDefaultExportFromCjs as e } from "./_commonjsHelpers.js";
-import { __require as t } from "../node_modules/eventemitter3/index2.js";
-var r = t();
-const m = /* @__PURE__ */ e(r);
+import { getDefaultExportFromCjs as r } from "./_commonjsHelpers.js";
+import { __require as e } from "../node_modules/style-to-js/cjs/index.js";
+var t = e();
+const a = /* @__PURE__ */ r(t);
 export {
-  m as default
+  a as default
 };

package/dist/_virtual/index4.js

@@ -1,8 +1,8 @@
 "use client";
-import { getDefaultExportFromCjs as r } from "./_commonjsHelpers.js";
-import { __require as e } from "../node_modules/style-to-js/cjs/index.js";
-var t = e();
-const a = /* @__PURE__ */ r(t);
+import { getDefaultExportFromCjs as e } from "./_commonjsHelpers.js";
+import { __require as r } from "../node_modules/extend/index.js";
+var t = r();
+const x = /* @__PURE__ */ e(t);
 export {
-  a as default
+  x as default
 };

package/dist/_virtual/index5.js

@@ -1,8 +1,8 @@
 "use client";
 import { getDefaultExportFromCjs as e } from "./_commonjsHelpers.js";
-import { __require as r } from "../node_modules/extend/index.js";
-var t = r();
-const x = /* @__PURE__ */ e(t);
+import { __require as t } from "../node_modules/eventemitter3/index2.js";
+var r = t();
+const m = /* @__PURE__ */ e(r);
 export {
-  x as default
+  m as default
 };

package/dist/_virtual/index7.js

@@ -1,5 +1,8 @@
 "use client";
-var e = { exports: {} };
+import { getDefaultExportFromCjs as r } from "./_commonjsHelpers.js";
+import { __require as e } from "../node_modules/classnames/index.js";
+var s = e();
+const o = /* @__PURE__ */ r(s);
 export {
-  e as __module
+  o as default
 };

package/dist/_virtual/index8.js

@@ -1,8 +1,5 @@
 "use client";
-import { getDefaultExportFromCjs as r } from "./_commonjsHelpers.js";
-import { __require as e } from "../node_modules/classnames/index.js";
-var s = e();
-const o = /* @__PURE__ */ r(s);
+var e = { exports: {} };
 export {
-  o as default
+  e as __module
 };

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

@@ -1,12 +1,12 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-05-05T15:26:14.216Z",
+  "generatedAt": "2026-06-30T08:03:50.466Z",
   "package": {
     "name": "laif-ds",
-    "version": "0.2.80"
+    "version": "0.2.84"
   },
   "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

@@ -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/components/Chat.md

@@ -25,6 +25,7 @@ Complete chat interface: message list with markdown rendering, auto-scroll and t
 | `suggestions`       | `string[]`                                             | `undefined`             | Suggestions displayed when empty. Requires `append`.                       |
 | `className`         | `string`                                               | `undefined`             | Wrapper classes.                                                           |
 | `welcomeTitle`      | `string`                                               | `"Da dove iniziamo?"`   | Title shown in empty state.                                                |
+| `placeholder`       | `string`                                               | `"Ask AI..."`           | Placeholder text for the composer input.                                   |
 
 ---
 

package/dist/agent-docs/components/FileUploader.md

@@ -12,7 +12,8 @@ Drag-and-drop uploader with keyboard activation, file type filtering, limits (co
 | ------------------- | ------------------------- | -------------------------------------------------- | --------------------------------------------------------- |
 | `extensions`        | `AcceptItem[]`            | `["pdf","image","video","audio"]`                  | Allowed extensions/categories (maps to accept attribute). |
 | `multiple`          | `boolean`                 | `false`                                            | Enables multiple file selection.                          |
-| `onUpload`          | `(files: File[]) => void` | `undefined`                                        | Called whenever selected files change.                    |
+| `onUpload`          | `(files: File[]) => void` | `undefined`                                        | Called when files are **added**, with the resulting list. |
+| `onRemove`          | `(removed: File[], remaining: File[]) => void` | `undefined`                           | Called when files are **removed** (single or remove-all), with the removed files and the list that remains. |
 | `description`       | `string`                  | `"Trascina un file o clicca per selezionare"`      | Dropzone hint.                                            |
 | `formatDescription` | `string`                  | `"Formato accettato: PDF, Immagini, Video, Audio"` | Accepted formats hint.                                    |
 | `selectedLabel`     | `string`                  | `"File selezionati"`                               | Title shown above selected files list.                    |
@@ -30,7 +31,7 @@ Drag-and-drop uploader with keyboard activation, file type filtering, limits (co
 - **Filtering**: `extensions` map to accept string; only matching files are added.
 - **Limits**: Enforces `maxFiles` and `maxTotalSize` (with compact error caption).
 - **Previews**: Renders selected files with `FilePreview`; supports remove per file and remove-all.
-- **Integration**: `onUpload` provides the current `File[]`; perform the actual upload externally.
+- **Integration**: `onUpload` fires on **add** with the resulting `File[]`; `onRemove` fires on **removal** (single file or remove-all) with the removed files and the remaining list. Removals do **not** trigger `onUpload` — a consumer mirroring the list in its own state must handle both callbacks (see example below).
 
 ---
 
@@ -127,7 +128,11 @@ export function ExternalUploadExample() {
 
   return (
     <div className="space-y-4">
-      <FileUploader multiple onUpload={setFiles} />
+      <FileUploader
+        multiple
+        onUpload={setFiles}
+        onRemove={(_removed, remaining) => setFiles(remaining)}
+      />
       {files.length > 0 && (
         <div className="flex justify-end">
           <Button onClick={handleSubmit} isLoading={loading} iconLeft="Upload">

package/dist/agent-docs/manifest.json

@@ -1,17 +1,17 @@
 {
   "schemaVersion": "1.1.0",
-  "generatedAt": "2026-05-05T15:26:13.593Z",
+  "generatedAt": "2026-06-30T08:03:49.821Z",
   "package": {
     "name": "laif-ds",
-    "version": "0.2.80"
+    "version": "0.2.84"
   },
   "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"
@@ -1934,10 +1944,10 @@
       },
       "metadata": {
         "props": {
-          "totalProps": 15,
+          "totalProps": 16,
           "requiredPropsCount": 4,
-          "typedPropsCount": 15,
-          "describedPropsCount": 15
+          "typedPropsCount": 16,
+          "describedPropsCount": 16
         },
         "accessibility": {
           "hasCoverage": false
@@ -3169,10 +3179,10 @@
       },
       "metadata": {
         "props": {
-          "totalProps": 9,
+          "totalProps": 10,
           "requiredPropsCount": 0,
-          "typedPropsCount": 9,
-          "describedPropsCount": 9
+          "typedPropsCount": 10,
+          "describedPropsCount": 10
         },
         "accessibility": {
           "hasCoverage": true
@@ -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": "5365e3750a199ac2ef62a230e7ec5a26fa46e3494a332e48d9f832d003ac6a1b"
+  "checksum": "b5e0252676d93c4e43b15be47dda3d1fae971b84bc0f2907ec12db211e686d5d"
 }