@primereact/mcp 11.0.0-rc.2

package/data/llms/primitive/components/dialog.md

@@ -0,0 +1,276 @@
+# Dialog
+
+An unstyled modal dialog component with built-in focus trap, scroll lock, drag support, and dismissable backdrop.
+
+<DocPrimitiveIntro description="Build fully custom modal dialogs with complete control over layout and styling." />
+
+```tsx
+'use client';
+import { Times } from '@primeicons/react/times';
+import { Dialog } from 'primereact/dialog';
+import styles from './basic-demo.module.css';
+
+export default function BasicDemo() {
+    return (
+        <div className={styles.wrapper}>
+            <Dialog.Root>
+                <Dialog.Trigger className={styles.trigger}>Edit Profile</Dialog.Trigger>
+                <Dialog.Portal>
+                    <Dialog.Backdrop className={styles.backdrop} />
+                    <Dialog.Positioner className={styles.positioner}>
+                        <Dialog.Popup className={styles.popup}>
+                            <Dialog.Header className={styles.header}>
+                                <Dialog.Title className={styles.title}>Edit Profile</Dialog.Title>
+                                <Dialog.HeaderActions>
+                                    <Dialog.Close className={styles.close}>
+                                        <Times />
+                                    </Dialog.Close>
+                                </Dialog.HeaderActions>
+                            </Dialog.Header>
+                            <Dialog.Content className={styles.content}>
+                                <div className={styles.form}>
+                                    <div className={styles.field}>
+                                        <label htmlFor="name" className={styles.label}>
+                                            Name
+                                        </label>
+                                        <input id="name" defaultValue="Amanda Miller" className={styles.input} />
+                                    </div>
+                                    <div className={styles.field}>
+                                        <label htmlFor="username" className={styles.label}>
+                                            Username
+                                        </label>
+                                        <input id="username" defaultValue="@amandamiller" className={styles.input} />
+                                    </div>
+                                    <div className={styles.field}>
+                                        <label htmlFor="email" className={styles.label}>
+                                            Email
+                                        </label>
+                                        <input id="email" defaultValue="amanda@example.com" className={styles.input} />
+                                    </div>
+                                    <div className={styles.actions}>
+                                        <Dialog.Close className={styles.cancelButton}>Cancel</Dialog.Close>
+                                        <Dialog.Close className={styles.saveButton}>Save Changes</Dialog.Close>
+                                    </div>
+                                </div>
+                            </Dialog.Content>
+                        </Dialog.Popup>
+                    </Dialog.Positioner>
+                </Dialog.Portal>
+            </Dialog.Root>
+        </div>
+    );
+}
+```
+
+<DocPrimitiveLinks name="Dialog" />
+
+## Features
+
+- Compound component API with sub-components: `Root`, `Trigger`, `Portal`, `Backdrop`, `Positioner`, `Popup`, `Header`, `Title`, `HeaderActions`, `Maximizable`, `Close`, `Content`, `Footer`
+- Nine position modes: `center`, `top`, `bottom`, `left`, `right`, `topleft`, `topright`, `bottomleft`, `bottomright`
+- Integrated focus trap with automatic focus management on open and close
+- Dismissable [Backdrop](/docs/primitive/components/backdrop) with click-outside detection
+- Built-in drag support with viewport boundary enforcement
+- Maximizable mode with fullscreen toggle
+- Scroll lock support via `blockScroll`
+
+## Usage
+
+```tsx
+import { Dialog } from 'primereact/dialog';
+```
+
+```tsx
+<Dialog.Root>
+    <Dialog.Trigger></Dialog.Trigger>
+    <Dialog.Portal>
+        <Dialog.Backdrop />
+        <Dialog.Positioner>
+            <Dialog.Popup>
+                <Dialog.Header>
+                    <Dialog.Title></Dialog.Title>
+                    <Dialog.HeaderActions>
+                        <Dialog.Maximizable></Dialog.Maximizable>
+                        <Dialog.Close></Dialog.Close>
+                    </Dialog.HeaderActions>
+                </Dialog.Header>
+                <Dialog.Content></Dialog.Content>
+                <Dialog.Footer></Dialog.Footer>
+            </Dialog.Popup>
+        </Dialog.Positioner>
+    </Dialog.Portal>
+</Dialog.Root>
+```
+
+## Behavior
+
+### Motion Animation
+
+```tsx
+<Dialog.Popup motionProps={{ name: 'p-dialog', appear: true }}>...</Dialog.Popup>
+```
+
+See [Motion](/docs/primitive/components/motion) for animation phases, CSS variables, and hide strategies.
+
+### Polymorphic Rendering
+
+Use `as` on any sub-component to change the rendered HTML element.
+
+```tsx
+<Dialog.Trigger as="div">...</Dialog.Trigger>
+<Dialog.Close as="a">...</Dialog.Close>
+```
+
+Default elements: `Root`=`div`, `Trigger`=`button`, `Positioner`=`div`, `Popup`=`div`, `Header`=`div`, `Title`=`div`, `HeaderActions`=`div`, `Maximizable`=`button`, `Close`=`button`, `Content`=`div`, `Footer`=`div`.
+
+### Render Function Children
+
+Sub-components accept a render function as children, providing access to the component instance.
+
+```tsx
+<Dialog.Content>{(instance) => <div>{instance.dialog?.state.open ? 'Open' : 'Closed'}</div>}</Dialog.Content>
+```
+
+## Pass Through
+
+<DocPTViewer name="dialog-pt" components={['DialogRoot']} />
+
+## API
+
+### DialogRoot
+
+<DocTable name="DialogRoot" category="api" />
+
+| Attribute        | Value                                |
+| ---------------- | ------------------------------------ |
+| `data-open`      | Present when the dialog is open      |
+| `data-closed`    | Present when the dialog is closed    |
+| `data-maximized` | Present when the dialog is maximized |
+
+<DocTable name="DialogRoot" category="pt" />
+
+### DialogTrigger
+
+<DocTable name="DialogTrigger" category="api" />
+
+| Attribute     | Value                             |
+| ------------- | --------------------------------- |
+| `data-open`   | Present when the dialog is open   |
+| `data-closed` | Present when the dialog is closed |
+
+<DocTable name="DialogTrigger" category="pt" />
+
+### DialogPortal
+
+<DocTable name="DialogPortal" category="api" />
+
+<DocTable name="DialogPortal" category="pt" />
+
+### DialogBackdrop
+
+<DocTable name="DialogBackdrop" category="api" />
+
+Uses the [Backdrop](/docs/primitive/components/backdrop) component internally for animated overlay rendering.
+
+<DocTable name="DialogBackdrop" category="pt" />
+
+### DialogPositioner
+
+<DocTable name="DialogPositioner" category="api" />
+
+| Attribute              | Value                                                                                                                            |
+| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| `data-position`        | `"center"` \| `"top"` \| `"bottom"` \| `"left"` \| `"right"` \| `"topleft"` \| `"topright"` \| `"bottomleft"` \| `"bottomright"` |
+| `data-scroll-behavior` | `"inside"` \| `"outside"`                                                                                                        |
+| `data-open`            | Present when the dialog is open                                                                                                  |
+| `data-closed`          | Present when the dialog is closed                                                                                                |
+| `data-maximized`       | Present when the dialog is maximized                                                                                             |
+
+<DocTable name="DialogPositioner" category="pt" />
+
+### DialogPopup
+
+<DocTable name="DialogPopup" category="api" />
+
+| Attribute        | Value                                |
+| ---------------- | ------------------------------------ |
+| `data-open`      | Present when the dialog is open      |
+| `data-maximized` | Present when the dialog is maximized |
+
+Uses [VisuallyHidden](/docs/primitive/components/visuallyhidden) elements internally for focus trap boundaries.
+
+<DocTable name="DialogPopup" category="pt" />
+
+### DialogHeader
+
+<DocTable name="DialogHeader" category="api" />
+
+<DocTable name="DialogHeader" category="pt" />
+
+### DialogTitle
+
+<DocTable name="DialogTitle" category="api" />
+
+<DocTable name="DialogTitle" category="pt" />
+
+### DialogHeaderActions
+
+<DocTable name="DialogHeaderActions" category="api" />
+
+<DocTable name="DialogHeaderActions" category="pt" />
+
+### DialogMaximizable
+
+<DocTable name="DialogMaximizable" category="api" />
+
+| Attribute        | Value                                    |
+| ---------------- | ---------------------------------------- |
+| `data-maximized` | Present when the dialog is maximized     |
+| `data-minimized` | Present when the dialog is not maximized |
+
+<DocTable name="DialogMaximizable" category="pt" />
+
+### DialogClose
+
+<DocTable name="DialogClose" category="api" />
+
+<DocTable name="DialogClose" category="pt" />
+
+### DialogContent
+
+<DocTable name="DialogContent" category="api" />
+
+| Attribute        | Value                                |
+| ---------------- | ------------------------------------ |
+| `data-maximized` | Present when the dialog is maximized |
+
+<DocTable name="DialogContent" category="pt" />
+
+### DialogFooter
+
+<DocTable name="DialogFooter" category="api" />
+
+<DocTable name="DialogFooter" category="pt" />
+
+## Accessibility
+
+### Screen Reader
+
+Dialog component uses `dialog` role along with `aria-labelledby` referring to the header element however any attribute is passed to the root element so `aria-labelledby` can be used to override this default behavior. In addition `aria-modal` is added since focus is kept within the popup.
+
+Trigger element also has `aria-expanded` and `aria-controls` to indicate the dialog state.
+
+### Overlay Keyboard Support
+
+| Key           | Function                                                                                                                                           |
+| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `tab`         | Moves focus to the next the focusable element within the dialog if `modal` is true. Otherwise, the focusable element in the page tab sequence.     |
+| `shift + tab` | Moves focus to the previous the focusable element within the dialog if `modal` is true. Otherwise, the focusable element in the page tab sequence. |
+| `escape`      | Closes the dialog if `closeOnEscape` is true.                                                                                                      |
+
+### Close Button Keyboard Support
+
+| Key     | Function           |
+| ------- | ------------------ |
+| `enter` | Closes the dialog. |
+| `space` | Closes the dialog. |

package/data/llms/primitive/components/divider/api.json

@@ -0,0 +1,214 @@
+[
+  {
+    "name": "DividerRoot",
+    "source": "apps/showcase/assets/apidoc/divider.json",
+    "data": {
+      "description": "Divider is used to separate contents.",
+      "interfaces": {
+        "DividerPassThrough": {
+          "description": "Defines passthrough(pt) options of Divider component.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "root",
+              "type": "DividerPassThroughType<HTMLAttributes<HTMLDivElement>>",
+              "default": "",
+              "description": "Used to pass attributes to the root's DOM element."
+            },
+            {
+              "name": "content",
+              "type": "DividerPassThroughType<HTMLAttributes<HTMLDivElement>>",
+              "default": "",
+              "description": "Used to pass attributes to the content's DOM element."
+            }
+          ],
+          "methods": []
+        },
+        "DividerProps": {
+          "description": "Defines valid properties in Divider component.",
+          "relatedProp": "",
+          "extendedTypes": "BaseComponentProps<DividerInstance, UseDividerProps, DividerPassThrough>",
+          "props": [
+            {
+              "name": "ref",
+              "type": "Ref<unknown>",
+              "default": "",
+              "description": "The reference to the component instance."
+            },
+            {
+              "name": "pIf",
+              "type": "boolean",
+              "default": "true",
+              "description": "Whether the component should be rendered."
+            },
+            {
+              "name": "style",
+              "type": "CSSProperties | ((instance?: DividerInstance) => CSSProperties)",
+              "default": "",
+              "description": "The style to apply to the component."
+            },
+            {
+              "name": "className",
+              "type": "string | ((instance?: DividerInstance) => string)",
+              "default": "",
+              "description": "The class name to apply to the component."
+            },
+            {
+              "name": "as",
+              "type": "string | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>",
+              "default": "",
+              "description": "The component type to render."
+            },
+            {
+              "name": "asChild",
+              "type": "boolean",
+              "default": "false",
+              "description": "Whether the component should be rendered as a child component."
+            },
+            {
+              "name": "instance",
+              "type": "DividerInstance",
+              "default": "",
+              "description": "The instance to pass to the component."
+            },
+            {
+              "name": "pt",
+              "type": "SafeRecord<DividerPassThrough>",
+              "default": "",
+              "description": "The pass-through props to pass to the component."
+            },
+            {
+              "name": "ptOptions",
+              "type": "PassThroughOptions",
+              "default": "",
+              "description": "The pass-through options to pass to the component."
+            },
+            {
+              "name": "unstyled",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the component should be rendered without classes."
+            },
+            {
+              "name": "dt",
+              "type": "unknown",
+              "default": "",
+              "description": "The design token to use for the component."
+            },
+            {
+              "name": "styles",
+              "type": "StylesOptions<ComponentInstance>",
+              "default": "",
+              "description": "The styles to use for the component."
+            },
+            {
+              "name": "render",
+              "type": "(instance: DividerInstance) => ReactNode",
+              "default": "",
+              "description": "The render function to render the component with instance access."
+            },
+            {
+              "name": "children",
+              "type": "any",
+              "default": "",
+              "description": "The children to render.\n\nAccepts  `React.ReactNode`  for static content or a render function  `(instance: I) => React.ReactNode`  for instance access.\nTyped as  `any`  to avoid JSX type errors when used directly in templates."
+            },
+            {
+              "name": "align",
+              "type": "\"center\" | \"top\" | \"bottom\" | \"left\" | \"right\"",
+              "default": "",
+              "description": "Alignment of the content."
+            },
+            {
+              "name": "orientation",
+              "type": "\"horizontal\" | \"vertical\"",
+              "default": "horizontal",
+              "description": "Specifies the orientation, valid values are 'horizontal' and 'vertical'."
+            },
+            {
+              "name": "type",
+              "type": "\"solid\" | \"dashed\" | \"dotted\"",
+              "default": "solid",
+              "description": "Border style type."
+            },
+            {
+              "name": "[key: string]",
+              "type": "any",
+              "description": ""
+            },
+            {
+              "name": "pt-{optionName}-*",
+              "type": "-",
+              "default": "",
+              "description": "Pass through attributes for customizing component parts.",
+              "deprecated": false
+            }
+          ],
+          "methods": []
+        },
+        "DividerState": {
+          "description": "Defines valid state in Divider component.",
+          "relatedProp": "",
+          "extendedTypes": "UseDividerState",
+          "props": [],
+          "methods": []
+        },
+        "DividerExposes": {
+          "description": "Defines the methods and properties exposed by Divider component.",
+          "relatedProp": "",
+          "extendedTypes": "UseDividerExposes",
+          "props": [
+            {
+              "name": "rootProps",
+              "type": "UseDividerRootProps",
+              "default": "",
+              "description": "Pre-built data attribute props for the root element.\nIncludes role, aria-orientation, data-orientation, data-align."
+            },
+            {
+              "name": "contentProps",
+              "type": "UseDividerContentProps",
+              "default": "",
+              "description": "Pre-built data attribute props for the content element.\nRendered only when the consumer passes children."
+            }
+          ],
+          "methods": []
+        }
+      },
+      "types": {
+        "DividerClassNamesType": {
+          "description": "Type representing the CSS class names used in the Divider component.",
+          "values": "typeof DividerClassNames[keyof typeof DividerClassNames]"
+        },
+        "DividerPassThroughType": {
+          "description": "Defines passthrough(pt) options type in Divider component.",
+          "values": "PassThroughType<DividerInstance, E>"
+        },
+        "DividerInstance": {
+          "description": "Instance of Divider component.",
+          "values": "ComponentInstance<DividerProps, DividerState, DividerExposes>"
+        }
+      },
+      "variables": {
+        "DividerClassNames": {
+          "description": "Defines the CSS class names used in the Divider component.",
+          "variables": [
+            {
+              "name": "root",
+              "value": "p-divider",
+              "optional": false,
+              "readonly": true,
+              "description": "Class name of the root element"
+            },
+            {
+              "name": "content",
+              "value": "p-divider-content",
+              "optional": false,
+              "readonly": true,
+              "description": "Class name of the content element"
+            }
+          ]
+        }
+      }
+    }
+  }
+]

package/data/llms/primitive/components/divider.md

@@ -0,0 +1,96 @@
+# Divider
+
+An unstyled separator component for horizontal and vertical content division.
+
+<DocPrimitiveIntro description="Build fully custom content separators with complete control over layout and styling." />
+
+```tsx
+'use client';
+import { Divider } from 'primereact/divider';
+import styles from './basic-demo.module.css';
+
+export default function BasicDemo() {
+    return (
+        <div className={styles.wrapper}>
+            <div className={styles.row}>
+                <div className={styles.column}>
+                    <span className={styles.label}>Invoice No</span>
+                    <span className={styles.value}>0000123</span>
+                </div>
+                <Divider orientation="vertical" className={styles.vertical} />
+                <div className={styles.column}>
+                    <span className={styles.label}>Issued</span>
+                    <span className={styles.value}>01/01/2026</span>
+                </div>
+                <Divider orientation="vertical" className={styles.vertical} />
+                <div className={styles.column}>
+                    <span className={styles.label}>Due Date</span>
+                    <span className={styles.value}>02/02/2026</span>
+                </div>
+            </div>
+            <Divider className={styles.horizontal} />
+            <p className={styles.value}>Fast setup, no credit card required.</p>
+        </div>
+    );
+}
+```
+
+<DocPrimitiveLinks name="Divider" />
+
+## Features
+
+- Horizontal and vertical orientations
+- Three border types: `solid`, `dashed`, `dotted`
+- Content alignment within the divider line (`left`, `center`, `right` for horizontal; `top`, `center`, `bottom` for vertical)
+
+## Usage
+
+```tsx
+import { Divider } from 'primereact/divider';
+```
+
+```tsx
+<Divider />
+```
+
+## Behavior
+
+### Polymorphic Rendering
+
+Use `as` to change the rendered HTML element.
+
+```tsx
+<Divider as="hr" />
+```
+
+Default element: `div`.
+
+### Render Function Children
+
+`Divider` accepts a render function as children, providing access to the component instance.
+
+```tsx
+<Divider>{(instance) => <span>{instance.divider?.props.orientation}</span>}</Divider>
+```
+
+## Pass Through
+
+<DocPTViewer name="divider-pt" components={['DividerRoot']} />
+
+## API
+
+### DividerRoot
+
+<DocTable name="DividerRoot" category="api" />
+
+<DocTable name="DividerRoot" category="pt" />
+
+## Accessibility
+
+### Screen Reader
+
+Divider uses `role="separator"` with `aria-orientation` set to either `"horizontal"` or `"vertical"`.
+
+### Keyboard Support
+
+Component does not include any interactive elements.