@primereact/mcp 11.0.0-rc.2

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

@@ -0,0 +1,148 @@
+# Knob
+
+An unstyled circular dial component for numeric input with SVG-based rendering.
+
+<DocPrimitiveIntro description="Build fully custom circular dial controls with complete control over layout and styling." />
+
+```tsx
+'use client';
+import { Knob } from 'primereact/knob';
+import styles from './basic-demo.module.css';
+
+export default function BasicDemo() {
+    return (
+        <div className={styles.wrapper}>
+            <Knob.Root defaultValue={50} ariaLabel="Volume" className={styles.root}>
+                <Knob.Range className={styles.range} />
+                <Knob.Value className={styles.value} />
+                <Knob.Text className={styles.text} />
+            </Knob.Root>
+        </div>
+    );
+}
+```
+
+<DocPrimitiveLinks name="Knob" />
+
+## Features
+
+- Compound component API with four sub-components: `Root`, `Range`, `Value`, `Text`
+- SVG-based arc rendering with computed paths
+- Mouse drag, touch drag, and click-to-set interaction
+- Full keyboard navigation (arrows, Home, End, PageUp, PageDown)
+- Configurable min, max, step, size, and stroke width
+
+## Usage
+
+```tsx
+import { Knob } from 'primereact/knob';
+```
+
+```tsx
+<Knob.Root>
+    <Knob.Range />
+    <Knob.Value />
+    <Knob.Text />
+</Knob.Root>
+```
+
+## Behavior
+
+### Polymorphic Rendering
+
+Use `as` on any sub-component to change the rendered element.
+
+```tsx
+<Knob.Root as="section"></Knob.Root>
+```
+
+Default elements: `Root`=`div`, `Range`=`path`, `Value`=`path`, `Text`=`text`. The SVG container is rendered automatically by Root.
+
+### Render Function Children
+
+`Knob.Text` accepts a render function as children, providing access to the component instance for custom value formatting.
+
+```tsx
+<Knob.Text>{(instance) => <>{instance.knob?.state.value}%</>}</Knob.Text>
+```
+
+## Pass Through
+
+<DocPTViewer name="knob-pt" components={['KnobRoot']} />
+
+## API
+
+### KnobRoot
+
+<DocTable name="KnobRoot" category="api" />
+
+| Attribute       | Value                  |
+| --------------- | ---------------------- |
+| `data-scope`    | `"knob"`               |
+| `data-part`     | `"root"`               |
+| `data-disabled` | Present when disabled  |
+| `data-readonly` | Present when read-only |
+
+<DocTable name="KnobRoot" category="pt" />
+
+### KnobRange
+
+<DocTable name="KnobRange" category="api" />
+
+| Attribute    | Value     |
+| ------------ | --------- |
+| `data-scope` | `"knob"`  |
+| `data-part`  | `"range"` |
+
+<DocTable name="KnobRange" category="pt" />
+
+### KnobValue
+
+<DocTable name="KnobValue" category="api" />
+
+| Attribute    | Value     |
+| ------------ | --------- |
+| `data-scope` | `"knob"`  |
+| `data-part`  | `"value"` |
+
+<DocTable name="KnobValue" category="pt" />
+
+### KnobText
+
+<DocTable name="KnobText" category="api" />
+
+| Attribute    | Value    |
+| ------------ | -------- |
+| `data-scope` | `"knob"` |
+| `data-part`  | `"text"` |
+
+<DocTable name="KnobText" category="pt" />
+
+## Accessibility
+
+### Screen Reader
+
+Knob renders an SVG element with `role="slider"` and sets `aria-valuemin`, `aria-valuemax`, and `aria-valuenow` to communicate the current state. Provide an accessible name with `ariaLabel` or `ariaLabelledby`. When disabled or read-only, the respective `aria-disabled` and `aria-readonly` states are applied.
+
+```tsx
+<Knob.Root ariaLabel="Volume" defaultValue={50}></Knob.Root>
+```
+
+If you already render a visible label, connect it using `ariaLabelledby`.
+
+```tsx
+<span id="volume-label">Volume</span>
+<Knob.Root ariaLabelledby="volume-label" defaultValue={50}></Knob.Root>
+```
+
+### Keyboard Support
+
+| Key               | Function                      |
+| ----------------- | ----------------------------- |
+| `tab`             | Moves focus to the knob.      |
+| `left/down arrow` | Decrements the value.         |
+| `right/up arrow`  | Increments the value.         |
+| `home`            | Sets the value to `min`.      |
+| `end`             | Sets the value to `max`.      |
+| `page up`         | Increments the value by `10`. |
+| `page down`       | Decrements the value by `10`. |

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

@@ -0,0 +1,177 @@
+[
+  {
+    "name": "Label",
+    "source": "apps/showcase/assets/apidoc/label.json",
+    "data": {
+      "description": "Label can be used standalone or in conjunction with form components to provide accessible labeling.",
+      "interfaces": {
+        "LabelPassThrough": {
+          "description": "Defines passthrough(pt) options of Label component.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "root",
+              "type": "LabelPassThroughType<LabelHTMLAttributes<HTMLLabelElement>>",
+              "default": "",
+              "description": "Used to pass attributes to the root's DOM element."
+            }
+          ],
+          "methods": []
+        },
+        "LabelProps": {
+          "description": "Defines valid properties in Label component.",
+          "relatedProp": "",
+          "extendedTypes": "BaseComponentProps<LabelInstance, UseLabelProps, LabelPassThrough>",
+          "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?: LabelInstance) => CSSProperties)",
+              "default": "",
+              "description": "The style to apply to the component."
+            },
+            {
+              "name": "className",
+              "type": "string | ((instance?: LabelInstance) => 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": "LabelInstance",
+              "default": "",
+              "description": "The instance to pass to the component."
+            },
+            {
+              "name": "pt",
+              "type": "SafeRecord<LabelPassThrough>",
+              "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: LabelInstance) => 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": "[key: string]",
+              "type": "any",
+              "description": ""
+            },
+            {
+              "name": "pt-{optionName}-*",
+              "type": "-",
+              "default": "",
+              "description": "Pass through attributes for customizing component parts.",
+              "deprecated": false
+            }
+          ],
+          "methods": []
+        },
+        "LabelState": {
+          "description": "Defines valid state in Label component.",
+          "relatedProp": "",
+          "extendedTypes": "UseLabelState",
+          "props": [],
+          "methods": []
+        },
+        "LabelExposes": {
+          "description": "Defines the methods and properties exposed by Label component.",
+          "relatedProp": "",
+          "extendedTypes": "UseLabelExposes",
+          "props": [
+            {
+              "name": "rootProps",
+              "type": "UseLabelRootProps",
+              "default": "",
+              "description": "Pre-built data attribute props for the root element."
+            }
+          ],
+          "methods": []
+        }
+      },
+      "types": {
+        "LabelPassThroughType": {
+          "description": "Defines passthrough(pt) options type in Label component.",
+          "values": "PassThroughType<LabelInstance, E>"
+        },
+        "LabelClassNamesType": {
+          "description": "Type representing the CSS class names used in the Label component.",
+          "values": "typeof LabelClassNames[keyof typeof LabelClassNames]"
+        },
+        "LabelInstance": {
+          "description": "Instance of Label component.",
+          "values": "ComponentInstance<LabelProps, LabelState, LabelExposes>"
+        }
+      },
+      "variables": {
+        "LabelClassNames": {
+          "description": "Defines the CSS class names used in the Label component.",
+          "variables": [
+            {
+              "name": "root",
+              "value": "p-label",
+              "optional": false,
+              "readonly": true,
+              "description": "Class name of the root element"
+            }
+          ]
+        }
+      }
+    }
+  }
+]

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

@@ -0,0 +1,44 @@
+# Label
+
+An unstyled, accessible label element for form controls.
+
+<DocPrimitiveIntro description="Build accessible text labels for form controls with complete control over layout and styling." />
+
+## Features
+
+- Renders a native `label` element
+- Associate with a control via `htmlFor`, or wrap the control to associate it implicitly
+- Reflects the disabled state of an associated control automatically
+
+## Usage
+
+```tsx
+import { Label } from 'primereact/label';
+import { InputText } from 'primereact/inputtext';
+```
+
+```tsx
+<Label htmlFor="username">Username</Label>
+<InputText id="username" />
+```
+
+## API
+
+### Label
+
+<DocTable name="Label" category="api" />
+
+| Attribute    | Value     |
+| ------------ | --------- |
+| `data-scope` | `"label"` |
+| `data-part`  | `"root"`  |
+
+## Accessibility
+
+### Screen Reader
+
+`Label` renders a native `label` element. Use `htmlFor` to associate it with a form control id, or wrap the form control inside the label.
+
+### Keyboard Support
+
+Component does not include any interactive elements.