@primereact/mcp 11.0.0-rc.2

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

@@ -0,0 +1,68 @@
+[
+  {
+    "name": "useToolbar",
+    "source": "apps/showcase/assets/apidoc/usetoolbar.json",
+    "data": {
+      "description": "The useToolbar manages the state and functionality of a toolbar component.",
+      "interfaces": {
+        "UseToolbarProps": {
+          "description": "Defines valid properties in useToolbar.",
+          "relatedProp": "",
+          "props": [],
+          "methods": []
+        },
+        "UseToolbarState": {
+          "description": "Defines valid state in useToolbar.",
+          "relatedProp": "",
+          "props": [],
+          "methods": []
+        },
+        "UseToolbarRootProps": {
+          "description": "Pre-built props for the toolbar root element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "string",
+              "default": "",
+              "description": "Component scope identifier."
+            },
+            {
+              "name": "data-part",
+              "type": "string",
+              "default": "",
+              "description": "Component part identifier."
+            },
+            {
+              "name": "role",
+              "type": "\"toolbar\"",
+              "default": "",
+              "description": "ARIA role for the toolbar."
+            }
+          ],
+          "methods": []
+        },
+        "UseToolbarExposes": {
+          "description": "Defines the methods and properties exposed by useToolbar.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "rootProps",
+              "type": "UseToolbarRootProps",
+              "default": "",
+              "description": "Pre-built props for the root element."
+            }
+          ],
+          "methods": []
+        }
+      },
+      "types": {
+        "UseToolbarInstance": {
+          "description": "Instance of useToolbar headless.",
+          "values": "HeadlessInstance<UseToolbarProps, UseToolbarState, UseToolbarExposes>"
+        }
+      },
+      "variables": {}
+    }
+  }
+]

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

@@ -0,0 +1,96 @@
+# useToolbar
+
+Headless hook for building toolbar containers with custom markup.
+
+```tsx
+'use client';
+import { Plus } from '@primeicons/react/plus';
+import { Search } from '@primeicons/react/search';
+import { Upload } from '@primeicons/react/upload';
+import { useToolbar } from '@primereact/headless/toolbar';
+
+export default function BasicDemo() {
+    const { rootProps } = useToolbar();
+
+    return (
+        <div
+            {...rootProps}
+            role="toolbar"
+            className="flex items-center justify-between gap-2 p-2 border border-surface-200 dark:border-surface-700 rounded-lg"
+        >
+            <div className="flex items-center gap-1">
+                <button className="p-2 rounded cursor-pointer hover:bg-surface-100 dark:hover:bg-surface-800 transition">
+                    <Plus className="w-4 h-4" />
+                </button>
+                <button className="p-2 rounded cursor-pointer hover:bg-surface-100 dark:hover:bg-surface-800 transition">
+                    <Upload className="w-4 h-4" />
+                </button>
+            </div>
+            <div>
+                <button className="p-2 rounded cursor-pointer hover:bg-surface-100 dark:hover:bg-surface-800 transition">
+                    <Search className="w-4 h-4" />
+                </button>
+            </div>
+        </div>
+    );
+}
+```
+
+## Usage
+
+```tsx
+import { useToolbar } from '@primereact/headless/toolbar';
+```
+
+```tsx
+const { rootProps } = useToolbar();
+
+<div {...rootProps} role="toolbar">
+    ...
+</div>;
+```
+
+`useToolbar` returns spread-ready `rootProps` with data attributes, see [Primitive](/docs/primitive/components/toolbar) for a component-based API.
+
+## Features
+
+- Spread-ready `rootProps` for the root container element
+- Stateless hook, no internal state or side effects
+- Full freedom over content layout (start, center, end regions)
+
+## Behavior
+
+### Layout Regions
+
+Compose start, center, and end sections using native HTML elements. There are no structural constraints, arrange content in any order using flex or grid layout.
+
+```tsx
+const { rootProps } = useToolbar();
+
+<div {...rootProps} role="toolbar">
+    <div>Left actions</div>
+    <div>Center content</div>
+    <div>Right actions</div>
+</div>;
+```
+
+### Custom Styling with Data Attributes
+
+```css
+[data-scope='toolbar'][data-part='root'] {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 0.5rem;
+}
+```
+
+## API
+
+### useToolbar
+
+<DocTable name="useToolbar" category="api" />
+
+## Accessibility
+
+Arrow keys navigate items, Home/End jump to first/last, and standard focus management applies. See [Primitive](/docs/primitive/components/toolbar#accessibility) for full WAI-ARIA compliance details.

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

@@ -0,0 +1,478 @@
+[
+  {
+    "name": "useTooltip",
+    "source": "apps/showcase/assets/apidoc/usetooltip.json",
+    "data": {
+      "description": "The useTooltip manages the state and functionality of a tooltip component.",
+      "interfaces": {
+        "UseTooltipChangeEvent": {
+          "description": "",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "value",
+              "type": "boolean",
+              "default": "",
+              "description": "The open value of the tooltip."
+            }
+          ],
+          "methods": []
+        },
+        "UseTooltipProps": {
+          "description": "Defines valid properties in useTooltip.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "anchor",
+              "type": "HTMLElement",
+              "default": "undefined",
+              "description": "External anchor element for positioning the tooltip programmatically. When provided, it is\nused instead of the element attached via  `Tooltip.Trigger` ."
+            },
+            {
+              "name": "open",
+              "type": "boolean",
+              "default": "",
+              "description": "Controls the open state of the tooltip."
+            },
+            {
+              "name": "defaultOpen",
+              "type": "boolean",
+              "default": "false",
+              "description": "Whether the tooltip is open by default."
+            },
+            {
+              "name": "onOpenChange",
+              "type": "(event: UseTooltipChangeEvent) => void",
+              "default": "undefined",
+              "description": "Callback fired when the open state changes."
+            },
+            {
+              "name": "onExitComplete",
+              "type": "() => void",
+              "default": "undefined",
+              "description": "Callback fired after the leave (exit) transition completes."
+            },
+            {
+              "name": "disabled",
+              "type": "boolean",
+              "default": "false",
+              "description": "Whether the tooltip is disabled."
+            },
+            {
+              "name": "openDelay",
+              "type": "number",
+              "default": "600",
+              "description": "The delay in milliseconds before opening the tooltip on hover."
+            },
+            {
+              "name": "closeDelay",
+              "type": "number",
+              "default": "0",
+              "description": "The delay in milliseconds before closing the tooltip."
+            },
+            {
+              "name": "interactive",
+              "type": "boolean",
+              "default": "true",
+              "description": "Whether the tooltip popup is interactive (hoverable).\nWhen true, hovering over the popup keeps the tooltip open.\nWhen false, the tooltip closes as soon as the pointer leaves the trigger."
+            },
+            {
+              "name": "tooltipManager",
+              "type": "UseTooltipManagerExposes",
+              "default": "",
+              "description": "The tooltip manager instance for group behavior."
+            }
+          ],
+          "methods": []
+        },
+        "UseTooltipState": {
+          "description": "Defines valid state in useTooltip.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "open",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the tooltip is open."
+            },
+            {
+              "name": "rendered",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the tooltip is currently rendered in the DOM (may still be playing exit animation\nwhen  `open`  is false)."
+            },
+            {
+              "name": "anchorElement",
+              "type": "HTMLElement",
+              "default": "",
+              "description": "The anchor element."
+            },
+            {
+              "name": "positionerElement",
+              "type": "HTMLDivElement",
+              "default": "",
+              "description": "The positioner element."
+            },
+            {
+              "name": "popupElement",
+              "type": "HTMLElement",
+              "default": "",
+              "description": "The popup element."
+            },
+            {
+              "name": "arrowElement",
+              "type": "HTMLDivElement",
+              "default": "",
+              "description": "The arrow element."
+            },
+            {
+              "name": "instantType",
+              "type": "InstantType",
+              "default": "",
+              "description": "The type of instant transition, if any."
+            }
+          ],
+          "methods": []
+        },
+        "UseTooltipRootProps": {
+          "description": "Pre-built props for the tooltip root element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-instant",
+              "type": "string",
+              "default": "",
+              "description": "Instant transition type attribute."
+            }
+          ],
+          "methods": []
+        },
+        "UseTooltipTriggerProps": {
+          "description": "Pre-built props for the tooltip trigger element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "ref",
+              "type": "(node: HTMLElement) => void",
+              "default": "",
+              "description": "Ref callback for the trigger element."
+            },
+            {
+              "name": "data-scope",
+              "type": "string",
+              "default": "",
+              "description": "Component scope identifier."
+            },
+            {
+              "name": "data-part",
+              "type": "string",
+              "default": "",
+              "description": "Component part identifier."
+            },
+            {
+              "name": "data-popup-open",
+              "type": "string",
+              "default": "",
+              "description": "Present when the tooltip is open."
+            }
+          ],
+          "methods": []
+        },
+        "UseTooltipPositionerProps": {
+          "description": "Pre-built props for the tooltip positioner element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "ref",
+              "type": "(node: HTMLDivElement) => void",
+              "default": "",
+              "description": "Ref callback for the positioner element."
+            },
+            {
+              "name": "data-scope",
+              "type": "string",
+              "default": "",
+              "description": "Component scope identifier."
+            },
+            {
+              "name": "data-part",
+              "type": "string",
+              "default": "",
+              "description": "Component part identifier."
+            },
+            {
+              "name": "data-open",
+              "type": "string",
+              "default": "",
+              "description": "Present when the tooltip is open."
+            }
+          ],
+          "methods": []
+        },
+        "UseTooltipPopupProps": {
+          "description": "Pre-built props for the tooltip popup element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "ref",
+              "type": "(node: HTMLDivElement) => void",
+              "default": "",
+              "description": "Ref callback for the popup element."
+            },
+            {
+              "name": "data-scope",
+              "type": "string",
+              "default": "",
+              "description": "Component scope identifier."
+            },
+            {
+              "name": "data-part",
+              "type": "string",
+              "default": "",
+              "description": "Component part identifier."
+            },
+            {
+              "name": "data-open",
+              "type": "string",
+              "default": "",
+              "description": "Present when the tooltip popup is visible."
+            },
+            {
+              "name": "data-instant",
+              "type": "string",
+              "default": "",
+              "description": "Present when an instant transition is active."
+            },
+            {
+              "name": "data-instant-type",
+              "type": "InstantType",
+              "default": "",
+              "description": "The type of instant transition."
+            }
+          ],
+          "methods": []
+        },
+        "UseTooltipArrowProps": {
+          "description": "Pre-built props for the tooltip arrow element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "ref",
+              "type": "(node: HTMLDivElement) => void",
+              "default": "",
+              "description": "Ref callback for the arrow element."
+            },
+            {
+              "name": "data-scope",
+              "type": "string",
+              "default": "",
+              "description": "Component scope identifier."
+            },
+            {
+              "name": "data-part",
+              "type": "string",
+              "default": "",
+              "description": "Component part identifier."
+            },
+            {
+              "name": "data-open",
+              "type": "string",
+              "default": "",
+              "description": "Present when the tooltip popup is visible."
+            },
+            {
+              "name": "data-instant",
+              "type": "string",
+              "default": "",
+              "description": "Instant transition type attribute."
+            }
+          ],
+          "methods": []
+        },
+        "UseTooltipExposes": {
+          "description": "Defines the methods and properties exposed by useTooltip.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "state",
+              "type": "UseTooltipState",
+              "default": "",
+              "description": "Current state of the tooltip."
+            },
+            {
+              "name": "popupRef",
+              "type": "RefObject<HTMLElement>",
+              "default": "",
+              "description": "Ref pointing to the popup element. Used by the motion system to apply enter/leave classes\nsynchronously before the first paint, avoiding a flash of the default (visible) state."
+            },
+            {
+              "name": "rootProps",
+              "type": "UseTooltipRootProps",
+              "default": "",
+              "description": "Pre-built props for the root element."
+            },
+            {
+              "name": "triggerProps",
+              "type": "UseTooltipTriggerProps",
+              "default": "",
+              "description": "Pre-built props for the trigger element."
+            },
+            {
+              "name": "positionerProps",
+              "type": "UseTooltipPositionerProps",
+              "default": "",
+              "description": "Pre-built props for the positioner element."
+            },
+            {
+              "name": "popupProps",
+              "type": "UseTooltipPopupProps",
+              "default": "",
+              "description": "Pre-built props for the popup element."
+            },
+            {
+              "name": "arrowProps",
+              "type": "UseTooltipArrowProps",
+              "default": "",
+              "description": "Pre-built props for the arrow element."
+            },
+            {
+              "name": "setRendered",
+              "type": "(rendered: boolean) => void",
+              "default": "",
+              "description": "Sets the rendered state of the tooltip. Called by the motion system when the exit\nanimation finishes to unmount the popup."
+            },
+            {
+              "name": "onOpenComplete",
+              "type": "() => void",
+              "default": "",
+              "description": "Callback invoked after the enter animation completes."
+            },
+            {
+              "name": "onCloseComplete",
+              "type": "() => void",
+              "default": "",
+              "description": "Callback invoked after the leave animation completes. Fires  `onExitComplete` ."
+            }
+          ],
+          "methods": []
+        }
+      },
+      "types": {
+        "UseTooltipInstance": {
+          "description": "Instance of useTooltip headless.",
+          "values": "HeadlessInstance<UseTooltipProps, UseTooltipState, UseTooltipExposes>"
+        }
+      },
+      "variables": {}
+    }
+  },
+  {
+    "name": "useTooltipManager",
+    "source": "apps/showcase/assets/apidoc/usetooltipmanager.json",
+    "data": {
+      "description": "The useTooltipManager manages the state and functionality of a tooltip manager component.",
+      "interfaces": {
+        "UseTooltipManagerProps": {
+          "description": "Defines valid properties in useTooltipManager.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "openDelay",
+              "type": "number",
+              "default": "",
+              "description": "The delay in milliseconds before opening a tooltip."
+            },
+            {
+              "name": "closeDelay",
+              "type": "number",
+              "default": "",
+              "description": "The delay in milliseconds before closing a tooltip."
+            },
+            {
+              "name": "timeout",
+              "type": "number",
+              "default": "400",
+              "description": "The timeout in milliseconds for the instant phase.\nIf another tooltip opens within this timeout after a tooltip closes,\nthe transition will be instant."
+            }
+          ],
+          "methods": []
+        },
+        "UseTooltipManagerState": {
+          "description": "Defines valid state in useTooltipManager.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "isInstantPhase",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the manager is in the instant phase.\nWhen true, tooltips should open/close instantly without delay."
+            },
+            {
+              "name": "lastClosedTooltipId",
+              "type": "string",
+              "default": "",
+              "description": "The ID of the last tooltip that was closed.\nUsed to distinguish same-tooltip re-open vs different-tooltip transition."
+            },
+            {
+              "name": "currentOpenTooltipId",
+              "type": "string",
+              "default": "",
+              "description": "The ID of the currently open tooltip.\nUsed to detect group transitions (hovering from one tooltip to another)."
+            },
+            {
+              "name": "openDelay",
+              "type": "number",
+              "default": "",
+              "description": "The group-level open delay override."
+            },
+            {
+              "name": "closeDelay",
+              "type": "number",
+              "default": "",
+              "description": "The group-level close delay override."
+            }
+          ],
+          "methods": []
+        },
+        "UseTooltipManagerExposes": {
+          "description": "Defines the methods and properties exposed by useTooltipManager.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "state",
+              "type": "UseTooltipManagerState",
+              "default": "",
+              "description": "Current state of the tooltip manager."
+            },
+            {
+              "name": "notifyOpen",
+              "type": "(tooltipId: string, closeFn: () => void) => void",
+              "default": "",
+              "description": "Notify the manager that a tooltip has opened."
+            },
+            {
+              "name": "notifyClose",
+              "type": "(tooltipId: string) => void",
+              "default": "",
+              "description": "Notify the manager that a tooltip has closed."
+            },
+            {
+              "name": "closeCurrentTooltip",
+              "type": "() => void",
+              "default": "",
+              "description": "Force-close the currently open tooltip with instant animation (data-instant).\nUsed during group transitions to instantly dismiss the previous tooltip."
+            }
+          ],
+          "methods": []
+        }
+      },
+      "types": {
+        "UseTooltipManagerInstance": {
+          "description": "Instance of useTooltipManager headless.",
+          "values": "HeadlessInstance<UseTooltipManagerProps, UseTooltipManagerState, UseTooltipManagerExposes>"
+        }
+      },
+      "variables": {}
+    }
+  }
+]