@primereact/mcp 11.0.0 → 11.2.0

package/data/llms/headless/components/tree/api.json

@@ -181,7 +181,7 @@
             },
             {
               "name": "dropNode",
-              "type": "TreeNodeData",
+              "type": "null | TreeNodeData",
               "default": "",
               "description": "The drop target node, or null if dropped at the root level."
             },
@@ -206,7 +206,7 @@
           "props": [
             {
               "name": "value",
-              "type": "string",
+              "type": "null | string",
               "default": "",
               "description": "The new focused key, or null when focus leaves the tree."
             }
@@ -358,7 +358,7 @@
             {
               "name": "loading",
               "type": "boolean",
-              "default": "",
+              "default": "false",
               "description": "Displays a loading overlay over the tree. Pair with  `Tree.Loading`  to render\nthe spinner / message of your choice."
             }
           ],
@@ -370,19 +370,19 @@
           "props": [
             {
               "name": "expandedKeys",
-              "type": "TreeExpandedKeys",
+              "type": "undefined | TreeExpandedKeys",
               "default": "",
               "description": "The current expanded keys of the tree."
             },
             {
               "name": "selectionKeys",
-              "type": "TreeSelectionKeys | TreeCheckboxSelectionKeys",
+              "type": "undefined | TreeSelectionKeys | TreeCheckboxSelectionKeys",
               "default": "",
               "description": "The current selected keys of the tree."
             },
             {
               "name": "focusedKey",
-              "type": "string",
+              "type": "null | string",
               "default": "",
               "description": "The key of the currently focused node, or null when none."
             },
@@ -474,13 +474,13 @@
             },
             {
               "name": "findNodeByKey",
-              "type": "(key: string) => TreeNodeData",
+              "type": "(key: string) => undefined | TreeNodeData",
               "default": "",
               "description": "Look up a node by key in O(1)."
             },
             {
               "name": "findNodeInfo",
-              "type": "(key: string) => { level: number; posInSet: number; setSize: number; parentKey: string }",
+              "type": "(key: string) => { level: number; posInSet: number; setSize: number; parentKey: null | string }",
               "default": "",
               "description": "Look up a node's position metadata by key."
             },
@@ -492,13 +492,13 @@
             },
             {
               "name": "setFocusedKey",
-              "type": "(key: string) => void",
+              "type": "(key: null | string) => void",
               "default": "",
               "description": "Set the focused key explicitly (e.g. from a click handler)."
             },
             {
               "name": "setSelectionKeys",
-              "type": "(keys: TreeSelectionKeys | TreeCheckboxSelectionKeys, event?: SyntheticEvent) => void",
+              "type": "(keys: TreeSelectionKeys | TreeCheckboxSelectionKeys, event?: SyntheticEvent<Element, Event>) => void",
               "default": "",
               "description": "Replace the entire selection map."
             },
@@ -706,7 +706,7 @@
           "props": [
             {
               "name": "id",
-              "type": "string",
+              "type": "undefined | string",
               "default": "",
               "description": "Unique identifier for the root element."
             },
@@ -791,19 +791,19 @@
             },
             {
               "name": "aria-expanded",
-              "type": "boolean",
+              "type": "undefined | boolean",
               "default": "",
               "description": "Whether the node is expanded. Omitted for leaf nodes."
             },
             {
               "name": "aria-selected",
-              "type": "boolean",
+              "type": "undefined | boolean",
               "default": "",
               "description": "Whether the node is selected (single/multiple selection mode)."
             },
             {
               "name": "aria-checked",
-              "type": "boolean | \"mixed\"",
+              "type": "undefined | boolean | \"mixed\"",
               "default": "",
               "description": "Whether the node is checked (checkbox selection mode);  `'mixed'`  for partial."
             },
@@ -821,7 +821,7 @@
             },
             {
               "name": "data-node-key",
-              "type": "string",
+              "type": "undefined | string",
               "default": "",
               "description": "The key of the node for identification."
             },
@@ -991,13 +991,13 @@
             },
             {
               "name": "context",
-              "type": "UseTreeInstance",
+              "type": "null | UseTreeInstance",
               "default": "",
               "description": "The parent tree instance providing state and methods."
             },
             {
               "name": "parentContext",
-              "type": "UseTreeNodeInstance",
+              "type": "null | UseTreeNodeInstance",
               "default": "",
               "description": "The parent tree node instance (if this is a nested node)."
             },
@@ -1022,7 +1022,7 @@
             },
             {
               "name": "selected",
-              "type": "boolean",
+              "type": "undefined | boolean",
               "default": "",
               "description": "Whether the node is selected (single/multiple mode)."
             },
@@ -1107,13 +1107,13 @@
             },
             {
               "name": "parentNode",
-              "type": "UseTreeNodeInstance",
+              "type": "undefined | null | UseTreeNodeInstance",
               "default": "",
               "description": "The parent tree node instance (for nested traversal)."
             },
             {
               "name": "nodeProps",
-              "type": "UseTreeNodeProps",
+              "type": "undefined | UseTreeNodeProps",
               "default": "",
               "description": "Pre-built props for the node root element (li)."
             },

package/data/llms/headless/components/tree.md

@@ -55,6 +55,7 @@ export default function BasicDemo() {
             <ul {...getNodesProps()} className="m-0 p-0 list-none">
                 {visibleKeys.map((key) => {
                     const node = findNodeByKey(key);
+
                     if (!node) return null;
 
                     const info = findNodeInfo(key);

package/data/llms/headless/components/treetable/api.json

@@ -379,7 +379,7 @@
             },
             {
               "name": "onDragEnd",
-              "type": "(event?: DragEvent) => void",
+              "type": "(event?: DragEvent<Element>) => void",
               "default": "",
               "description": "Handles drag end."
             },
@@ -411,7 +411,7 @@
           "props": [
             {
               "name": "originalEvent",
-              "type": "SyntheticEvent",
+              "type": "SyntheticEvent<Element, Event>",
               "default": ""
             },
             {
@@ -451,7 +451,7 @@
             },
             {
               "name": "globalFilter",
-              "type": "string",
+              "type": "null | string",
               "default": ""
             }
           ],
@@ -524,7 +524,7 @@
             },
             {
               "name": "registerDropTarget",
-              "type": "(columnIndex: number, notify: (state: { side: \"start\" | \"end\" }) => void) => () => void",
+              "type": "(columnIndex: number, notify: (state: null | { side: \"start\" | \"end\" }) => void) => () => void",
               "default": "",
               "description": "Registers a drop-target for a specific column index. The hook calls  `notify`  with  `{ side }` \nwhen this column becomes the active drop target and with  `null`  when it stops being active.\nReturns an unregister function to call on unmount."
             },
@@ -561,7 +561,7 @@
             },
             {
               "name": "registerIndicator",
-              "type": "(element: HTMLElement) => void",
+              "type": "(element: null | HTMLElement) => void",
               "default": "",
               "description": "Registers a DOM element that the hook will use as the visual resize indicator.\nPass  `null`  to unregister (e.g. on component unmount)."
             },
@@ -671,7 +671,7 @@
             },
             {
               "name": "getRowToggleProps",
-              "type": "(rowKey: string | number, item?: Record<string, unknown>) => { isSpacer: true; spacerProps: Record<string, any> } | { isSpacer: false; rootProps: Record<string, any>; isExpanded: boolean }",
+              "type": "(rowKey: undefined | string | number, item?: null | Record<string, unknown>) => { isSpacer: true; spacerProps: Record<string, any> } | { isSpacer: false; rootProps: Record<string, any>; isExpanded: boolean }",
               "default": "",
               "description": "Returns props for the row toggle element. The shape distinguishes between a \"spacer\"\n(rendered for tree-mode leaves) and a real button."
             }
@@ -881,25 +881,25 @@
           "props": [
             {
               "name": "data",
-              "type": "Record<string, unknown>[] | object[]",
+              "type": "null | Record<string, unknown>[] | object[]",
               "default": "null",
               "description": "An array of objects to display."
             },
             {
               "name": "defaultValue",
-              "type": "string",
+              "type": "null | string",
               "default": "null",
               "description": "Default sort value for uncontrolled mode."
             },
             {
               "name": "value",
-              "type": "string",
+              "type": "null | string",
               "default": "null",
               "description": "Sort field value for controlled mode."
             },
             {
               "name": "dataKey",
-              "type": "string",
+              "type": "null | string",
               "default": "null",
               "description": "A property to uniquely identify each row in the data."
             },
@@ -929,7 +929,7 @@
             },
             {
               "name": "scrollHeight",
-              "type": "string",
+              "type": "null | string",
               "default": "null",
               "description": "Height of the scroll viewport in fixed pixels or the \"flex\" keyword for a dynamic size."
             },
@@ -989,7 +989,7 @@
             },
             {
               "name": "selectionMode",
-              "type": "\"multiple\" | \"single\"",
+              "type": "null | \"multiple\" | \"single\"",
               "default": "null",
               "description": "Defines the selection mode. 'single' allows one row, 'multiple' allows many."
             },
@@ -1201,7 +1201,7 @@
             },
             {
               "name": "globalFilter",
-              "type": "string",
+              "type": "null | string",
               "default": "null",
               "description": "Global filter value applied across globalFilterFields."
             },
@@ -1237,7 +1237,7 @@
             },
             {
               "name": "rowClassName",
-              "type": "(data: Record<string, unknown>, options: { index: number; props: UseDataTableProps }) => string",
+              "type": "(data: Record<string, unknown>, options: { index: number; props: UseDataTableProps }) => undefined | string",
               "default": "",
               "description": "A function that returns a className for a given row."
             },
@@ -1400,7 +1400,7 @@
             },
             {
               "name": "editingCell",
-              "type": "{ rowIndex: number; field: string; rowKey?: string | number }",
+              "type": "null | { rowIndex: number; field: string; rowKey?: string | number }",
               "default": "",
               "description": "The currently editing cell, if any."
             },
@@ -1412,7 +1412,7 @@
             },
             {
               "name": "globalFilter",
-              "type": "string",
+              "type": "null | string",
               "default": "",
               "description": "The current global filter value."
             }
@@ -1590,7 +1590,7 @@
             },
             {
               "name": "keyboard",
-              "type": "{ getRowTabIndex: (index: number) => number; onRowKeyDown: (event: KeyboardEvent<HTMLTableRowElement>, index: number) => void; focusRow: (tbody: HTMLElement, index: number) => void }",
+              "type": "{ getRowTabIndex: (index: number) => number; onRowKeyDown: (event: KeyboardEvent<HTMLTableRowElement>, index: number) => void; focusRow: (tbody: null | HTMLElement, index: number) => void }",
               "default": "",
               "description": "Keyboard navigation methods."
             }
@@ -1619,7 +1619,7 @@
           "props": [
             {
               "name": "item",
-              "type": "Record<string, unknown>",
+              "type": "null | Record<string, unknown>",
               "default": "null",
               "description": "The data object for this row."
             },
@@ -1631,7 +1631,7 @@
             },
             {
               "name": "context",
-              "type": "UseDataTableInstance",
+              "type": "null | UseDataTableInstance",
               "default": "",
               "description": "The parent datatable instance providing state and methods."
             }

package/data/llms/headless/guides/misc/internationalization.md

@@ -0,0 +1,282 @@
+# Internationalization and Localization
+
+Translating component messages and configuring regional settings such as date formats and the first day of the week.
+
+## Overview
+
+Components ship with a set of built-in messages such as filter operator labels, month names and ARIA descriptions. These messages live in a locale registry that is shared across PrimeReact, PrimeVue and PrimeNG through the `@primeuix/locale` package, and are re-exported from `@primereact/core/locale`.
+
+English is registered by default, so no configuration is required until another language is needed.
+
+Setting a language is enough for components to pick it up. No per-component prop is involved. A DatePicker then renders its month and day names in that language, with the first day of the week adjusted to match.
+
+```jsx
+import { PrimeReactProvider } from '@primereact/core';
+import { de } from 'primelocale/js/de.js';
+
+<PrimeReactProvider locale="de" locales={{ de }}>
+    <App />
+</PrimeReactProvider>;
+```
+
+## Import
+
+```js
+import { $t, $l, defineLocale, updateLocale, useLocale, Locale, LocaleService, en } from '@primereact/core/locale';
+```
+
+## Setting the Language
+
+`Locale.use` selects the active language. Every component reading a message re-renders when it changes, so this works both at startup and later in response to a language switcher.
+
+```js
+import { Locale } from '@primereact/core/locale';
+
+Locale.use('de');
+```
+
+Only `en` is built in, so any other language has to be registered first. See [Adding a Language](#adding-a-language) below.
+
+`PrimeReactProvider` also accepts a `locale` prop, which sets the initial language for the components beneath it.
+
+```jsx
+import { PrimeReactProvider } from '@primereact/core';
+
+<PrimeReactProvider locale="de">
+    <App />
+</PrimeReactProvider>;
+```
+
+## Adding a Language
+
+`defineLocale` registers a new language.
+
+```js
+import { defineLocale, Locale } from '@primereact/core/locale';
+
+defineLocale('es', {
+    clear: 'Limpiar',
+    apply: 'Aplicar',
+    accept: 'Sí',
+    reject: 'No',
+    dayNames: ['domingo', 'lunes', 'martes', 'miércoles', 'jueves', 'viernes', 'sábado'],
+    dayNamesShort: ['dom', 'lun', 'mar', 'mié', 'jue', 'vie', 'sáb'],
+    dayNamesMin: ['D', 'L', 'M', 'X', 'J', 'V', 'S'],
+    monthNames: ['enero', 'febrero', 'marzo', 'abril', 'mayo', 'junio', 'julio', 'agosto', 'septiembre', 'octubre', 'noviembre', 'diciembre'],
+    monthNamesShort: ['ene', 'feb', 'mar', 'abr', 'may', 'jun', 'jul', 'ago', 'sep', 'oct', 'nov', 'dic']
+});
+
+Locale.use('es');
+```
+
+A registered language must be complete. Keys that are left out resolve to `undefined` rather than falling back to English, which renders as an empty label. The practical approach is to spread the built-in English messages and override from there:
+
+```js
+import { defineLocale, en } from '@primereact/core/locale';
+
+defineLocale('es', {
+    ...en,
+    clear: 'Limpiar',
+    apply: 'Aplicar'
+});
+```
+
+The `en` object holds the built-in English messages and is exported for exactly this purpose. Ready-made translations from [PrimeLocale](#ready-made-translations) already cover every key, so spreading is only needed for hand-written translations.
+
+The provider accepts a `locales` map, which registers languages and selects one in a single step. Anything listed here is registered before `locale` is applied.
+
+```jsx
+import { PrimeReactProvider } from '@primereact/core';
+
+<PrimeReactProvider locale="es" locales={{ es: spanishMessages }}>
+    <App />
+</PrimeReactProvider>;
+```
+
+## Updating an Existing Language
+
+`updateLocale` merges new values into a language that is already registered, leaving the remaining keys untouched. It is useful for overriding a handful of labels without redefining a full translation.
+
+```js
+import { updateLocale } from '@primereact/core/locale';
+
+updateLocale('en', {
+    clear: 'Reset',
+    apply: 'Confirm'
+});
+```
+
+If the language does not exist yet, `updateLocale` registers it, behaving like `defineLocale`.
+
+## Reading Messages
+
+### In Components
+
+`useLocale` is the React hook for reading the active locale. It re-renders the calling component when the language changes.
+
+```jsx
+import { useLocale } from '@primereact/core/locale';
+
+function ClearFilterButton({ onClear }) {
+    const { t } = useLocale();
+
+    return <button onClick={onClear}>{t('clear')}</button>;
+}
+```
+
+| Field      | Description                                   |
+| ---------- | --------------------------------------------- |
+| `lang`     | Active language code, such as `en` or `de`.   |
+| `messages` | Full message object of the active language.   |
+| `t`        | Translates a key against the active language. |
+
+Re-rendering on a language change relies on the context published by `PrimeReactProvider`, which applications normally have at their root. A component rendered outside any provider still reads the correct messages on first render, but will not update when the language changes later.
+
+### Outside Components
+
+`$t` performs the same lookup without a React context, which suits utilities, event handlers and module-level code.
+
+```js
+import { $t } from '@primereact/core/locale';
+
+$t('clear'); // 'Clear'
+```
+
+Nested keys use dot notation.
+
+```js
+$t('aria.selectRow'); // 'Row Selected'
+```
+
+Messages containing placeholders accept replacement values. Positional placeholders such as `{0}` are filled from the argument order, while named ones are filled from an object.
+
+```js
+$t('searchMessage', 5); // '5 results are available'
+$t('selectionMessage', 3); // '3 items selected'
+$t('aria.stars', { star: 4 }); // '4 stars'
+```
+
+## Reacting to Language Changes
+
+Language changes emit a `locale:change` event. Components handle this automatically through `useLocale`; the event is only needed for code living outside React, such as syncing a third-party library.
+
+```js
+import { LocaleService } from '@primereact/core/locale';
+
+const onChange = ({ lang }) => console.log('Language is now', lang);
+
+LocaleService.on('locale:change', onChange);
+
+// remove the listener when it is no longer needed
+LocaleService.off('locale:change', onChange);
+```
+
+## Inspecting the Registry
+
+`$l` returns a facade over the registry, which helps when building a language switcher.
+
+```js
+import { $l } from '@primereact/core/locale';
+
+$l().langs; // ['en', 'es']
+$l().get('es'); // message object of the Spanish locale
+```
+
+## Message Keys
+
+These components read their labels from the active language:
+
+| Component  | Keys                                                                                                                                                    |
+| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| DatePicker | `dayNames`, `dayNamesShort`, `dayNamesMin`, `monthNames`, `monthNamesShort`, `today`, `weekHeader`, `clear`, `am`, `pm`, `firstDayOfWeek`, `dateFormat` |
+| FileUpload | `fileSizeTypes`                                                                                                                                         |
+| Paginator  | `aria.firstPageLabel`, `aria.prevPageLabel`, `aria.nextPageLabel`, `aria.lastPageLabel`, `aria.pageLabel`                                               |
+| Sidebar    | `aria.toggleSidebar`                                                                                                                                    |
+
+The registry holds a larger set covering filter operators, password strength labels, empty-state messages and the remaining `aria` labels. Those are reserved for components that do not consume them yet, so translating them has no visible effect today.
+
+Not every entry is a string. `firstDayOfWeek` is a number, `showMonthAfterYear` is a boolean, and `dayNames`, `monthNames` and `fileSizeTypes` are arrays. `searchMessage` and similar entries carry a `{0}` placeholder.
+
+The full set with default English values is exported as `en`, which can also be inspected at runtime:
+
+```js
+import { en } from '@primereact/core/locale';
+
+Object.keys(en); // every top-level key
+```
+
+## Ready-Made Translations
+
+Writing a translation from scratch is rarely necessary. The community maintained [PrimeLocale](https://github.com/primefaces/primelocale) repository publishes complete translations for 70+ languages, shared across all Prime libraries. Each file covers every built-in message key, so nothing is left resolving to `undefined`.
+
+### Copying a File
+
+Grab the JSON file for the desired language from the repository, for example `es.json`, and place it in the project.
+
+Each file wraps its messages in a single key named after the language:
+
+```json
+{
+    "es": {
+        "clear": "Limpiar",
+        "apply": "Aplicar",
+        "aria": { "selectRow": "Seleccionar fila" }
+    }
+}
+```
+
+That wrapper has to be unwrapped before registering, otherwise every lookup resolves to `undefined`:
+
+```js
+import { defineLocale, Locale } from '@primereact/core/locale';
+import es from './locales/es.json';
+
+defineLocale('es', es.es);
+Locale.use('es');
+```
+
+The same unwrapping applies when the language is registered through the provider:
+
+```jsx
+import { PrimeReactProvider } from '@primereact/core';
+import es from './locales/es.json';
+
+<PrimeReactProvider locale="es" locales={{ es: es.es }}>
+    <App />
+</PrimeReactProvider>;
+```
+
+### Installing the Package
+
+The translations are also published to npm, which avoids maintaining copies by hand.
+
+```bash
+npm install primelocale
+```
+
+```js
+import { defineLocale, Locale } from '@primereact/core/locale';
+import { es } from 'primelocale/js/es.js';
+
+defineLocale('es', es);
+Locale.use('es');
+```
+
+The package entry points export the messages directly, so no unwrapping is needed there.
+
+Regional variants are named with an underscore in the package and a hyphen in the JSON files. Brazilian Portuguese is `primelocale/js/pt_BR.js` when imported and `pt-BR.json` when copied.
+
+### Adjusting a Translation
+
+A ready-made translation can be tuned without editing the file, by layering overrides on top of it:
+
+```js
+defineLocale('es', es.es);
+updateLocale('es', { clear: 'Borrar' });
+```
+
+Contributions of new languages and corrections are welcome in the PrimeLocale repository, and benefit every Prime library at once.
+
+## Coming from v10
+
+The locale helpers from `primereact/api` were replaced. The [migration guide](/docs/primitive/guides/migration/updating-to-v11) maps each one to its replacement.

package/data/llms/hooks/use-filter.md

@@ -95,7 +95,7 @@ export default function BasicDemo() {
                     type="search"
                     placeholder="Search name, category, code..."
                     value={search}
-                    onChange={(e: any) => setSearch(e.target.value)}
+                    onChange={(e: React.ChangeEvent<HTMLInputElement>) => setSearch(e.target.value)}
                     className="w-full"
                 />
             </IconField.Root>
@@ -189,7 +189,7 @@ export default function AdvancedDemo() {
                         placeholder="Name contains..."
                         size="small"
                         value={(nameRule?.value as string) ?? ''}
-                        onChange={(e: any) => nameRule?.setValue(e.target.value)}
+                        onChange={(e: React.ChangeEvent<HTMLInputElement>) => nameRule?.setValue(e.target.value)}
                         className="w-full"
                     />
                 </IconField.Root>

package/data/llms/hooks/use-tree-filter.md

@@ -119,7 +119,9 @@ export default function TreeDemo() {
                         type="search"
                         placeholder="Search nodes..."
                         value={search}
-                        onChange={(e: any) => setRules([{ field: 'name', value: e.target.value, matchMode: 'contains' }])}
+                        onChange={(e: React.ChangeEvent<HTMLInputElement>) =>
+                            setRules([{ field: 'name', value: e.target.value, matchMode: 'contains' }])
+                        }
                     />
                 </IconField.Root>