laif-ds 1.0.0 → 1.0.2-app-data-grid.76

package/dist/agent-docs/manifest.json

@@ -1,22 +1,20 @@
 {
   "schemaVersion": "1.1.0",
-  "generatedAt": "2026-09-02T16:31:00.468Z",
+  "generatedAt": "2026-09-22T08:46:35.988Z",
   "package": {
     "name": "laif-ds",
-    "version": "1.0.0"
+    "version": "1.0.2-app-data-grid.76"
   },
   "stats": {
-    "documentedComponentCount": 94,
-    "catalogedComponentCount": 93,
-    "missingFromDocsCount": 1,
-    "deprecatedComponentCount": 2,
-    "averageAiReadinessScore": 56.17,
-    "highAiReadinessCount": 38,
-    "lowAiReadinessCount": 41
+    "documentedComponentCount": 97,
+    "catalogedComponentCount": 97,
+    "missingFromDocsCount": 0,
+    "deprecatedComponentCount": 4,
+    "averageAiReadinessScore": 56.55,
+    "highAiReadinessCount": 40,
+    "lowAiReadinessCount": 42
   },
-  "missingFromDocs": [
-    "TruncatedCell"
-  ],
+  "missingFromDocs": [],
   "components": [
     {
       "name": "Accordion",
@@ -286,8 +284,9 @@
         "exampleTitles": [
           "`BottomNavItem`",
           "Layout",
-          "Icon size: a deliberate divergence from the native baselines",
+          "Icon size",
           "Active state",
+          "Badges",
           "Opening the menu",
           "Accessibility",
           "Motion",
@@ -295,6 +294,7 @@
           "Edge cases",
           "App shell",
           "Localised copy",
+          "A Menu cell of the app's own",
           "Without the Menu cell"
         ],
         "controlledPattern": "likely-controlled",
@@ -307,10 +307,10 @@
       },
       "metadata": {
         "props": {
-          "totalProps": 15,
+          "totalProps": 19,
           "requiredPropsCount": 4,
-          "typedPropsCount": 15,
-          "describedPropsCount": 14
+          "typedPropsCount": 19,
+          "describedPropsCount": 18
         },
         "accessibility": {
           "hasCoverage": true
@@ -502,6 +502,107 @@
         "interface AppCheckboxProps {\r"
       ]
     },
+    {
+      "name": "AppDataGrid",
+      "markdownPath": "components/AppDataGrid.md",
+      "importPath": "laif-ds",
+      "deprecated": false,
+      "replacement": null,
+      "tags": {
+        "cataloged": true,
+        "aiReady": true
+      },
+      "docs": {
+        "sections": [
+          {
+            "title": "Overview",
+            "slug": "overview"
+          },
+          {
+            "title": "Props",
+            "slug": "props"
+          },
+          {
+            "title": "Column builders",
+            "slug": "column-builders"
+          },
+          {
+            "title": "Usage",
+            "slug": "usage"
+          },
+          {
+            "title": "Coexistence with `DataTable`",
+            "slug": "coexistence-with-datatable"
+          },
+          {
+            "title": "DOM contract (for tests)",
+            "slug": "dom-contract-for-tests"
+          }
+        ],
+        "hasPropsTable": true,
+        "hasExamples": false,
+        "exampleTitles": [
+          "AppDataGridProps<TData>",
+          "Counting props — the paginator, and where each figure comes from (Fase 4)",
+          "The scope on a self-paginating grid",
+          "What arrives in `onQueryChange`",
+          "Why `onQueryChange` cannot fire on a view change",
+          "Cosa i tipi rifiutano (what the types reject)",
+          "Accessor builder options",
+          "Column group builder (P5)",
+          "The toolbar order, and the one decision still open (`adg-m3`)",
+          "Column widths, resize and pinning (P4)",
+          "Multi-level headers (P5)",
+          "Virtualization (P3)",
+          "Density is the consumer's setting, not a toolbar control (`adg-c12`) — BREAKING",
+          "Density, full screen and vertical space (P6)",
+          "Lifted filters, chips, panel and column registry (P7)",
+          "Filters the application declares — the `GridFilterControl` registry (R15, Fase 8)",
+          "Infinite source and skeleton rows (P8)",
+          "Riga Zero — the filters inside the columns (C9)",
+          "Row grouping (P9)",
+          "Page selection: the bar, the status line and the group tri-state (Fase 6)",
+          "Selected row: tint and left bar (R19)",
+          "Row header, table name, bypass links (Fase 2, fetta E)",
+          "Truncation is recoverable where it truncates, and only there (Fase 2, fetta E)",
+          "Row header and row menu (Fase 2, fetta E)",
+          "The `table` i18n section (Fase 2, fetta E)",
+          "Saved views, and the migration surface (P10)"
+        ],
+        "controlledPattern": "controlled-uncontrolled-documented",
+        "requiredProps": []
+      },
+      "metadata": {
+        "props": {
+          "totalProps": 169,
+          "requiredPropsCount": 0,
+          "typedPropsCount": 169,
+          "describedPropsCount": 153
+        },
+        "accessibility": {
+          "hasCoverage": true
+        },
+        "states": {
+          "coveredStates": [
+            "hover",
+            "focus",
+            "disabled",
+            "loading",
+            "error",
+            "empty",
+            "selected"
+          ],
+          "coveredStateCount": 7
+        }
+      },
+      "aiReadiness": {
+        "score": 80,
+        "tier": "high"
+      },
+      "typeReferences": [
+        "type AppDataGridProps<TData> = GridClientProps<TData> | GridServerProps<TData>;\r"
+      ]
+    },
     {
       "name": "AppDialog",
       "markdownPath": "components/AppDialog.md",
@@ -923,6 +1024,10 @@
             "title": "Examples",
             "slug": "examples"
           },
+          {
+            "title": "Accessibility and layer behaviour",
+            "slug": "accessibility-and-layer-behaviour"
+          },
           {
             "title": "Notes",
             "slug": "notes"
@@ -956,7 +1061,11 @@
           "Clearable Single Select",
           "With Disabled Options",
           "Multiple with Select All / Deselect All",
-          "Custom Render Value"
+          "Custom Render Value",
+          "Accessible name",
+          "Keyboard",
+          "The popover is NOT modal (behaviour change) — measured",
+          "Residual limits"
         ],
         "controlledPattern": "controlled-uncontrolled-documented",
         "requiredProps": [
@@ -965,10 +1074,10 @@
       },
       "metadata": {
         "props": {
-          "totalProps": 19,
+          "totalProps": 21,
           "requiredPropsCount": 1,
-          "typedPropsCount": 19,
-          "describedPropsCount": 19
+          "typedPropsCount": 21,
+          "describedPropsCount": 21
         },
         "accessibility": {
           "hasCoverage": true
@@ -1016,6 +1125,10 @@
             "title": "Behavior",
             "slug": "behavior"
           },
+          {
+            "title": "Badges (`badge` / `badgeLabel`)",
+            "slug": "badges-badge-badgelabel"
+          },
           {
             "title": "Navigation display (`navigationDisplay`)",
             "slug": "navigation-display-navigationdisplay"
@@ -1024,6 +1137,10 @@
             "title": "Icon mode (`collapsible=\"icon\"`)",
             "slug": "icon-mode-collapsible-icon"
           },
+          {
+            "title": "Hover expansion (`expandOnHover`)",
+            "slug": "hover-expansion-expandonhover"
+          },
           {
             "title": "Mobile menu (`<768px`)",
             "slug": "mobile-menu-768px"
@@ -1041,8 +1158,24 @@
         "hasExamples": true,
         "exampleTitles": [
           "Icons: `iconName` or `icon`",
+          "The three forms",
+          "Degradation per surface",
+          "Counts never aggregate",
+          "Colour and geometry",
+          "Accessibility",
+          "Live counts vs static ones, and who announces them",
+          "What this deliberately does not do",
           "The group selector (`navigationDisplay=\"tab\"` + `collapsible=\"icon\"`, collapsed)",
+          "The peek is an overlay, the pin is a push",
+          "Preconditions",
+          "Timing",
+          "The Pin",
+          "`pinned` is `open`",
+          "Keyboard and focus",
+          "Menus that live in a portal",
+          "Other things worth knowing",
           "Basic",
+          "With badges",
           "With Header/Footer Content"
         ],
         "controlledPattern": "controlled-uncontrolled-documented",
@@ -1052,10 +1185,10 @@
       },
       "metadata": {
         "props": {
-          "totalProps": 11,
+          "totalProps": 21,
           "requiredPropsCount": 1,
-          "typedPropsCount": 11,
-          "describedPropsCount": 11
+          "typedPropsCount": 21,
+          "describedPropsCount": 19
         },
         "accessibility": {
           "hasCoverage": true
@@ -1064,10 +1197,11 @@
           "coveredStates": [
             "hover",
             "focus",
+            "disabled",
             "empty",
             "selected"
           ],
-          "coveredStateCount": 4
+          "coveredStateCount": 5
         }
       },
       "aiReadiness": {
@@ -1713,7 +1847,7 @@
       },
       "typeReferences": [
         "interface ButtonProps extends React_2.ComponentProps<\"button\"> {\r",
-        "type ButtonSize = \"default\" | \"sm\" | \"lg\" | \"icon\";\r",
+        "type ButtonSize = \"default\" | \"sm\" | \"lg\" | \"icon\" | \"icon-xs\";\r",
         "type ButtonVariant = \"default\" | \"destructive\" | \"outline\" | \"outline-primary\" | \"outline-destructive\" | \"secondary\" | \"ghost\" | \"ghost-destructive\" | \"ghost-accent\" | \"link\";\r"
       ]
     },
@@ -2731,8 +2865,8 @@
       "name": "DataTable",
       "markdownPath": "components/DataTable.md",
       "importPath": "laif-ds",
-      "deprecated": false,
-      "replacement": null,
+      "deprecated": true,
+      "replacement": "AppDataGrid",
       "tags": {
         "cataloged": true,
         "aiReady": true
@@ -2763,6 +2897,10 @@
             "title": "Examples",
             "slug": "examples"
           },
+          {
+            "title": "Public assets",
+            "slug": "public-assets"
+          },
           {
             "title": "Notes",
             "slug": "notes"
@@ -3505,6 +3643,71 @@
       },
       "typeReferences": []
     },
+    {
+      "name": "GridFilterPanel",
+      "markdownPath": "components/GridFilterPanel.md",
+      "importPath": "laif-ds",
+      "deprecated": false,
+      "replacement": null,
+      "tags": {
+        "cataloged": true,
+        "aiReady": true
+      },
+      "docs": {
+        "sections": [
+          {
+            "title": "Overview",
+            "slug": "overview"
+          },
+          {
+            "title": "Props",
+            "slug": "props"
+          },
+          {
+            "title": "Behavior",
+            "slug": "behavior"
+          },
+          {
+            "title": "Examples",
+            "slug": "examples"
+          }
+        ],
+        "hasPropsTable": true,
+        "hasExamples": true,
+        "exampleTitles": [
+          "GridFilterPanelProps",
+          "Preferred: the Riga Zero instead",
+          "Existing call-sites: the controlled panel"
+        ],
+        "controlledPattern": "likely-controlled",
+        "requiredProps": []
+      },
+      "metadata": {
+        "props": {
+          "totalProps": 12,
+          "requiredPropsCount": 0,
+          "typedPropsCount": 12,
+          "describedPropsCount": 12
+        },
+        "accessibility": {
+          "hasCoverage": true
+        },
+        "states": {
+          "coveredStates": [
+            "focus",
+            "disabled"
+          ],
+          "coveredStateCount": 2
+        }
+      },
+      "aiReadiness": {
+        "score": 85,
+        "tier": "high"
+      },
+      "typeReferences": [
+        "interface GridFilterPanelProps {\r"
+      ]
+    },
     {
       "name": "HoverCard",
       "markdownPath": "components/HoverCard.md",
@@ -3829,7 +4032,7 @@
       "deprecated": false,
       "replacement": null,
       "tags": {
-        "cataloged": false,
+        "cataloged": true,
         "aiReady": true
       },
       "docs": {
@@ -5080,6 +5283,14 @@
             "title": "Behavior",
             "slug": "behavior"
           },
+          {
+            "title": "`SidebarMenuBadge` is deprecated",
+            "slug": "sidebarmenubadge-is-deprecated"
+          },
+          {
+            "title": "Peek — `useSidebar().peek` / `setPeek`",
+            "slug": "peek-usesidebar-peek-setpeek"
+          },
           {
             "title": "Example",
             "slug": "example"
@@ -5092,7 +5303,7 @@
         "hasPropsTable": false,
         "hasExamples": false,
         "exampleTitles": [],
-        "controlledPattern": "not-specified",
+        "controlledPattern": "likely-controlled",
         "requiredProps": []
       },
       "metadata": {
@@ -5107,9 +5318,10 @@
         },
         "states": {
           "coveredStates": [
+            "hover",
             "focus"
           ],
-          "coveredStateCount": 1
+          "coveredStateCount": 2
         }
       },
       "aiReadiness": {
@@ -5120,6 +5332,64 @@
         "type SidebarContextProps = {\r"
       ]
     },
+    {
+      "name": "SidebarMenuBadge",
+      "markdownPath": "components/SidebarMenuBadge.md",
+      "importPath": "laif-ds",
+      "deprecated": true,
+      "replacement": "NavItem.badge",
+      "tags": {
+        "cataloged": true,
+        "aiReady": true
+      },
+      "docs": {
+        "sections": [
+          {
+            "title": "Overview",
+            "slug": "overview"
+          },
+          {
+            "title": "Props",
+            "slug": "props"
+          },
+          {
+            "title": "Behavior",
+            "slug": "behavior"
+          },
+          {
+            "title": "Example",
+            "slug": "example"
+          }
+        ],
+        "hasPropsTable": true,
+        "hasExamples": false,
+        "exampleTitles": [],
+        "controlledPattern": "likely-controlled",
+        "requiredProps": []
+      },
+      "metadata": {
+        "props": {
+          "totalProps": 0,
+          "requiredPropsCount": 0,
+          "typedPropsCount": 0,
+          "describedPropsCount": 0
+        },
+        "accessibility": {
+          "hasCoverage": true
+        },
+        "states": {
+          "coveredStates": [
+            "hover"
+          ],
+          "coveredStateCount": 1
+        }
+      },
+      "aiReadiness": {
+        "score": 40,
+        "tier": "low"
+      },
+      "typeReferences": []
+    },
     {
       "name": "Skeleton",
       "markdownPath": "components/Skeleton.md",
@@ -5531,7 +5801,9 @@
         "score": 20,
         "tier": "low"
       },
-      "typeReferences": []
+      "typeReferences": [
+        "type TableMode = \"client\" | \"server\";\r"
+      ]
     },
     {
       "name": "TableSkeleton",
@@ -6006,13 +6278,13 @@
       ]
     },
     {
-      "name": "truncated-cell",
-      "markdownPath": "components/truncated-cell.md",
+      "name": "TruncatedCell",
+      "markdownPath": "components/TruncatedCell.md",
       "importPath": "laif-ds",
       "deprecated": false,
       "replacement": null,
       "tags": {
-        "cataloged": false,
+        "cataloged": true,
         "aiReady": true
       },
       "docs": {
@@ -6099,7 +6371,9 @@
         "score": 100,
         "tier": "high"
       },
-      "typeReferences": []
+      "typeReferences": [
+        "interface TruncatedCellProps {\r"
+      ]
     },
     {
       "name": "TypingIndicator",
@@ -6275,5 +6549,5 @@
       ]
     }
   ],
-  "checksum": "7347dd0e46eb44f6186c98afd32585008fadbbbcdcb7909e342274f93f42e45d"
+  "checksum": "f8ac7cce8e9d40a3d02d1cfab5956c01d3301bd9a523afac254cabeadfbcf28c"
 }