@primereact/mcp 11.0.0-rc.2

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

@@ -0,0 +1,469 @@
+[
+  {
+    "name": "InputNumberRoot",
+    "source": "apps/showcase/assets/apidoc/inputnumberroot.json",
+    "data": {
+      "description": "InputNumber is an input component to provide numerical input.",
+      "interfaces": {
+        "InputNumberRootPassThrough": {
+          "description": "Defines passthrough(pt) options of InputNumberRoot component.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "root",
+              "type": "InputNumberRootPassThroughType<HTMLAttributes<HTMLDivElement>>",
+              "default": "",
+              "description": "Used to pass attributes to the root's DOM element."
+            },
+            {
+              "name": "input",
+              "type": "InputNumberRootPassThroughType<InputHTMLAttributes<HTMLInputElement>>",
+              "default": "",
+              "description": "Used to pass attributes to the input's DOM element."
+            },
+            {
+              "name": "group",
+              "type": "InputNumberRootPassThroughType<HTMLAttributes<HTMLDivElement>>",
+              "default": "",
+              "description": "Used to pass attributes to the button group's DOM element."
+            },
+            {
+              "name": "increment",
+              "type": "InputNumberRootPassThroughType<ButtonHTMLAttributes<HTMLButtonElement>>",
+              "default": "",
+              "description": "Used to pass attributes to the increment button's DOM element."
+            },
+            {
+              "name": "decrement",
+              "type": "InputNumberRootPassThroughType<ButtonHTMLAttributes<HTMLButtonElement>>",
+              "default": "",
+              "description": "Used to pass attributes to the decrement button's DOM element."
+            }
+          ],
+          "methods": []
+        },
+        "InputNumberRootValueChangeEvent": {
+          "description": "Event fired when the input number's value changes.",
+          "relatedProp": "",
+          "extendedTypes": "UseInputNumberValueChangeEvent",
+          "props": [
+            {
+              "name": "originalEvent",
+              "type": "PointerEvent<HTMLButtonElement> | ChangeEvent<HTMLInputElement, Element> | KeyboardEvent<HTMLInputElement> | FormEvent<HTMLInputElement> | MouseEvent<HTMLInputElement, MouseEvent>",
+              "default": "",
+              "description": "Original browser event."
+            },
+            {
+              "name": "value",
+              "type": "number",
+              "default": "",
+              "description": "New value."
+            }
+          ],
+          "methods": []
+        },
+        "InputNumberRootProps": {
+          "description": "Defines valid properties in InputNumberRoot component.",
+          "relatedProp": "",
+          "extendedTypes": "BaseComponentProps<InputNumberRootInstance, UseInputNumberProps, InputNumberRootPassThrough>",
+          "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?: InputNumberRootInstance) => CSSProperties)",
+              "default": "",
+              "description": "The style to apply to the component."
+            },
+            {
+              "name": "className",
+              "type": "string | ((instance?: InputNumberRootInstance) => 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": "InputNumberRootInstance",
+              "default": "",
+              "description": "The instance to pass to the component."
+            },
+            {
+              "name": "pt",
+              "type": "SafeRecord<InputNumberRootPassThrough>",
+              "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: InputNumberRootInstance) => 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": "value",
+              "type": "number",
+              "default": "",
+              "description": "Specifies whether a inputnumber should be checked or not."
+            },
+            {
+              "name": "defaultValue",
+              "type": "number",
+              "default": "",
+              "description": "Specifies whether a inputnumber should be checked or not."
+            },
+            {
+              "name": "name",
+              "type": "string",
+              "default": "",
+              "description": "The name attribute for the element, typically used in form submissions."
+            },
+            {
+              "name": "format",
+              "type": "boolean",
+              "default": "true",
+              "description": "Whether to format the value."
+            },
+            {
+              "name": "locale",
+              "type": "string",
+              "default": "",
+              "description": "Locale to be used in formatting."
+            },
+            {
+              "name": "localeMatcher",
+              "type": "\"lookup\" | \"best fit\"",
+              "default": "'best fit'",
+              "description": "The locale matching algorithm to use. Possible values are 'lookup' and 'best fit'; the default is 'best fit'.\nSee [Locale Negotation](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl#locale_negotiation) for details."
+            },
+            {
+              "name": "mode",
+              "type": "\"decimal\" | \"currency\"",
+              "default": "decimal",
+              "description": "Defines the behavior of the component."
+            },
+            {
+              "name": "prefix",
+              "type": "string",
+              "default": "",
+              "description": "Text to display before the value."
+            },
+            {
+              "name": "suffix",
+              "type": "string",
+              "default": "",
+              "description": "Text to display after the value."
+            },
+            {
+              "name": "currency",
+              "type": "string",
+              "default": "",
+              "description": "The currency to use in currency formatting. Possible values are the [ISO 4217 currency codes](https://www.six-group.com/en/products-services/financial-information/data-standards.html#scrollTo=maintenance-agency), such as 'USD' for the US dollar, 'EUR' for the euro, or 'CNY' for the Chinese RMB.\nThere is no default value; if the style is 'currency', the currency property must be provided."
+            },
+            {
+              "name": "currencyDisplay",
+              "type": "\"symbol\" | \"code\" | \"name\" | \"narrowSymbol\"",
+              "default": "",
+              "description": "How to display the currency in currency formatting. Possible values are 'symbol' to use a localized currency symbol such as €, 'code' to use the ISO currency code, 'name' to use a localized currency name such as 'dollar'."
+            },
+            {
+              "name": "useGrouping",
+              "type": "boolean",
+              "default": "true",
+              "description": "Whether to use grouping separators, such as thousands separators or thousand/lakh/crore separators."
+            },
+            {
+              "name": "minFractionDigits",
+              "type": "number",
+              "default": "",
+              "description": "The minimum number of fraction digits to use. Possible values are from 0 to 20; the default for plain number and percent formatting is 0;\nthe default for currency formatting is the number of minor unit digits provided by the [ISO 4217 currency code](https://www.six-group.com/en/products-services/financial-information/data-standards.html#scrollTo=maintenance-agency) list (2 if the list doesn't provide that information)."
+            },
+            {
+              "name": "maxFractionDigits",
+              "type": "number",
+              "default": "",
+              "description": "The maximum number of fraction digits to use. Possible values are from 0 to 20; the default for plain number formatting is the larger of minimumFractionDigits and 3;\nthe default for currency formatting is the larger of minimumFractionDigits and the number of minor unit digits provided by the [ISO 4217 currency code](https://www.six-group.com/en/products-services/financial-information/data-standards.html#scrollTo=maintenance-agency) list (2 if the list doesn't provide that information)."
+            },
+            {
+              "name": "roundingMode",
+              "type": "\"expand\" | \"ceil\" | \"floor\" | \"trunc\" | \"halfCeil\" | \"halfFloor\" | \"halfExpand\" | \"halfTrunc\" | \"halfEven\"",
+              "default": "",
+              "description": "How decimals should be rounded.\n[further information](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat#roundingmode)."
+            },
+            {
+              "name": "min",
+              "type": "number",
+              "default": "",
+              "description": "Minimum boundary value."
+            },
+            {
+              "name": "max",
+              "type": "number",
+              "default": "",
+              "description": "Maximum boundary value."
+            },
+            {
+              "name": "step",
+              "type": "number",
+              "default": "1",
+              "description": "Step factor to increment/decrement the value."
+            },
+            {
+              "name": "allowEmpty",
+              "type": "boolean",
+              "default": "true",
+              "description": "Determines whether the input field is empty."
+            },
+            {
+              "name": "highlightOnFocus",
+              "type": "boolean",
+              "default": "false",
+              "description": "Highlights automatically the input value."
+            },
+            {
+              "name": "invalid",
+              "type": "boolean",
+              "default": "false",
+              "description": "When present, it specifies that the component should have invalid state style."
+            },
+            {
+              "name": "disabled",
+              "type": "boolean",
+              "default": "false",
+              "description": "When present, it specifies that the component should be disabled."
+            },
+            {
+              "name": "readOnly",
+              "type": "boolean",
+              "default": "false",
+              "description": "When present, it specifies that an input field is read-only."
+            },
+            {
+              "name": "onChange",
+              "type": "(event: UseInputNumberValueChangeEvent) => void",
+              "default": "",
+              "description": "Callback to invoke when value changes."
+            },
+            {
+              "name": "size",
+              "type": "\"small\" | \"large\"",
+              "default": "",
+              "description": "Defines the size of the component."
+            },
+            {
+              "name": "variant",
+              "type": "\"outlined\" | \"filled\"",
+              "default": "null",
+              "description": "Specifies the input variant of the component."
+            },
+            {
+              "name": "fluid",
+              "type": "boolean",
+              "default": "null",
+              "description": "Spans 100% width of the container when enabled."
+            },
+            {
+              "name": "layout",
+              "type": "\"horizontal\" | \"vertical\" | \"stacked\"",
+              "default": "undefined",
+              "description": "Layout of the increment/decrement buttons."
+            },
+            {
+              "name": "onValueChange",
+              "type": "(event: InputNumberRootValueChangeEvent) => void",
+              "default": "",
+              "description": "Callback fired when the input number's value changes."
+            },
+            {
+              "name": "[key: string]",
+              "type": "any",
+              "description": ""
+            },
+            {
+              "name": "pt-{optionName}-*",
+              "type": "-",
+              "default": "",
+              "description": "Pass through attributes for customizing component parts.",
+              "deprecated": false
+            }
+          ],
+          "methods": []
+        },
+        "InputNumberRootState": {
+          "description": "Defines valid state in InputNumberRoot component.",
+          "relatedProp": "",
+          "extendedTypes": "UseInputNumberState",
+          "props": [
+            {
+              "name": "value",
+              "type": "number",
+              "default": "",
+              "description": "Current value."
+            },
+            {
+              "name": "formattedValue",
+              "type": "string",
+              "default": "",
+              "description": "Formatted value."
+            }
+          ],
+          "methods": []
+        },
+        "InputNumberRootExposes": {
+          "description": "Defines the methods and properties exposed by InputNumberRoot component.",
+          "relatedProp": "",
+          "extendedTypes": "UseInputNumberExposes",
+          "props": [
+            {
+              "name": "state",
+              "type": "UseInputNumberState",
+              "default": "",
+              "description": "State of the input number."
+            },
+            {
+              "name": "rootProps",
+              "type": "UseInputNumberRootProps",
+              "default": "",
+              "description": "Pre-built props for the root element."
+            },
+            {
+              "name": "inputProps",
+              "type": "UseInputNumberInputProps",
+              "default": "",
+              "description": "Pre-built props for the input element."
+            },
+            {
+              "name": "incrementProps",
+              "type": "UseInputNumberIncrementProps",
+              "default": "",
+              "description": "Pre-built event handler props for the increment button."
+            },
+            {
+              "name": "decrementProps",
+              "type": "UseInputNumberDecrementProps",
+              "default": "",
+              "description": "Pre-built event handler props for the decrement button."
+            },
+            {
+              "name": "maxBoundry",
+              "type": "() => boolean",
+              "default": "",
+              "description": "Checks if the maximum boundary is reached."
+            },
+            {
+              "name": "minBoundry",
+              "type": "() => boolean",
+              "default": "",
+              "description": "Checks if the minimum boundary is reached."
+            },
+            {
+              "name": "increment",
+              "type": "(event: PointerEvent<HTMLButtonElement> | KeyboardEvent<HTMLInputElement> | MouseEvent<HTMLInputElement, MouseEvent>, dir: number) => void",
+              "default": "",
+              "description": "Increments the input number value (requires event from input element)."
+            },
+            {
+              "name": "decrement",
+              "type": "(event: PointerEvent<HTMLButtonElement> | KeyboardEvent<HTMLInputElement> | MouseEvent<HTMLInputElement, MouseEvent>, dir: number) => void",
+              "default": "",
+              "description": "Decrements the input number value (requires event from input element)."
+            },
+            {
+              "name": "stepUp",
+              "type": "() => void",
+              "default": "",
+              "description": "Increments the input number value without requiring an event. Use this for external buttons."
+            },
+            {
+              "name": "stepDown",
+              "type": "() => void",
+              "default": "",
+              "description": "Decrements the input number value without requiring an event. Use this for external buttons."
+            },
+            {
+              "name": "stopSpin",
+              "type": "() => void",
+              "default": "",
+              "description": "Stops the spinning/repeating increment/decrement actions."
+            },
+            {
+              "name": "_registerGroup",
+              "type": "() => void",
+              "default": "",
+              "description": "Called by InputNumberGroup on mount."
+            },
+            {
+              "name": "_unregisterGroup",
+              "type": "() => void",
+              "default": "",
+              "description": "Called by InputNumberGroup on unmount."
+            }
+          ],
+          "methods": []
+        }
+      },
+      "types": {
+        "InputNumberRootPassThroughType": {
+          "description": "Defines passthrough(pt) options type in InputNumberRoot component.",
+          "values": "PassThroughType<InputNumberRootInstance, E>"
+        },
+        "InputNumberRootInstance": {
+          "description": "Instance of InputNumberRoot component.",
+          "values": "ComponentInstance<InputNumberRootProps, InputNumberRootState, InputNumberRootExposes>"
+        }
+      },
+      "variables": {}
+    }
+  }
+]

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

@@ -0,0 +1,99 @@
+# InputNumber
+
+An unstyled numeric input with formatting, locale support, and spin button behavior.
+
+<DocPrimitiveIntro description="Build fully custom numeric inputs with complete control over layout and styling." />
+
+```tsx
+'use client';
+import { AngleDown } from '@primeicons/react/angle-down';
+import { AngleUp } from '@primeicons/react/angle-up';
+import { InputNumber } from 'primereact/inputnumber';
+import styles from './basic-demo.module.css';
+
+export default function BasicDemo() {
+    return (
+        <div className={styles.wrapper}>
+            <InputNumber.Root defaultValue={42723} className={styles.root}>
+                <InputNumber.Input className={styles.input} />
+                <InputNumber.Increment className={styles.button}>
+                    <AngleUp />
+                </InputNumber.Increment>
+                <InputNumber.Decrement className={styles.button}>
+                    <AngleDown />
+                </InputNumber.Decrement>
+            </InputNumber.Root>
+        </div>
+    );
+}
+```
+
+<DocPrimitiveLinks name="InputNumber" />
+
+## Features
+
+- Locale-aware number formatting with decimal, currency, and custom prefix/suffix modes
+- Boundary enforcement via `min` and `max` with keyboard-driven increment and decrement
+- Configurable fraction digit precision and rounding modes
+- Auto-repeating spin on pointer hold with accelerating intervals
+
+## Usage
+
+```tsx
+import { InputNumber } from 'primereact/inputnumber';
+```
+
+```tsx
+<InputNumber defaultValue={42723} />
+```
+
+## Behavior
+
+### Polymorphic Rendering
+
+Use `as` to change the rendered input element.
+
+```tsx
+<InputNumber as="input" defaultValue={0} />
+```
+
+### Render Function Children
+
+`InputNumber` accepts a render function providing access to the component instance.
+
+```tsx
+<InputNumber>{(instance) => <span>{instance.state.formattedValue}</span>}</InputNumber>
+```
+
+## Pass Through
+
+<DocPTViewer name="inputnumber-pt" components={['InputNumber']} />
+
+## API
+
+### InputNumber
+
+<DocTable name="InputNumberRoot" category="api" />
+
+| Attribute    | Value           |
+| ------------ | --------------- |
+| `data-scope` | `"inputnumber"` |
+| `data-part`  | `"root"`        |
+
+<DocTable name="InputNumber" category="pt" />
+
+## Accessibility
+
+### Screen Reader
+
+Value to describe the component can be provided with a label tag and `id`, or by using `aria-labelledby` and `aria-label`. The input element uses the `spinbutton` role and includes `aria-valuemin`, `aria-valuemax`, and `aria-valuenow`.
+
+### Keyboard Support
+
+| Key          | Function                           |
+| ------------ | ---------------------------------- |
+| `tab`        | Moves focus to the input.          |
+| `up arrow`   | Increments the value.              |
+| `down arrow` | Decrements the value.              |
+| `home`       | Set the minimum value if provided. |
+| `end`        | Set the maximum value if provided. |