@gridui/number-field 1.0.8 → 1.0.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -15,3 +15,11 @@ Input supplies the native control presentation; Button supplies the stepper acti
15
15
  Applications own routes, labels, state persistence, and branding.
16
16
 
17
17
  See [component ownership](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/docs/component-ownership.md) and [release history](https://github.com/sudo-ui/GridUI-React-Monorepo/tree/main/packages-core/number-field/.changeset/history).
18
+
19
+ Uncontrolled fields retain their initial native value attribute, which supplies
20
+ HTML's step base when `min` is omitted. Editing does not change that base. The
21
+ browser owns the uncontrolled input value; the component tracks it for stepper
22
+ availability and restores the initial value on an uncanceled form reset.
23
+ Controlled fields continue to follow `value` and can reject change requests.
24
+
25
+ [Component reference](docs/reference/README.md) contains focused API pages for each public component.
package/dist/index.js CHANGED
@@ -98,7 +98,8 @@ var NumberField = (props) => {
98
98
  min,
99
99
  max,
100
100
  step,
101
- value: current ?? "",
101
+ value: value === void 0 ? void 0 : value ?? "",
102
+ defaultValue: value === void 0 ? initial.current ?? "" : void 0,
102
103
  className: cn(controlVariants({ size: controlSize }), "gridui-number-field gridui-u-number-field--flex-1", className),
103
104
  onChange: (event) => {
104
105
  onChange?.(event);
package/dist/index.js.map CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../src/number-field/number-field.tsx"],
4
- "sourcesContent": ["/**\n * @author WMXPY\n * @package Number Field\n * @namespace NumberField\n * @description Number Field\n */\n\nimport { Button } from \"@gridui/button\";\nimport { useFormReset } from \"@gridui/form\";\nimport { controlVariants } from \"@gridui/input\";\nimport { cn } from \"@gridui/style-utils\";\nimport { Minus, Plus } from \"lucide-react\";\nimport { type ComponentPropsWithRef, type FC, useImperativeHandle, useRef, useState } from \"react\";\n\nexport type NumberFieldProps = Omit<ComponentPropsWithRef<\"input\">, \"type\" | \"value\" | \"defaultValue\" | \"min\" | \"max\" | \"step\" | \"size\"> & {\n readonly value?: number | null;\n readonly defaultValue?: number | null;\n readonly min?: number;\n readonly max?: number;\n readonly step?: number;\n readonly controlSize?: \"standard\" | \"small\";\n readonly incrementLabel: string;\n readonly decrementLabel: string;\n readonly onValueChange?: (value: number | null) => void;\n};\n\nexport const NumberField: FC<NumberFieldProps> = (props: NumberFieldProps) => {\n const { value, defaultValue = null, min, max, step = 1, controlSize = \"standard\", incrementLabel, decrementLabel,\n onValueChange, onChange, className, ref, ...restProps } = props;\n if (!Number.isFinite(step) || step <= 0 || (min !== undefined && !Number.isFinite(min)) || (max !== undefined && !Number.isFinite(max))\n || (min !== undefined && max !== undefined && min > max)\n || (value !== undefined && value !== null && !Number.isFinite(value))\n || (defaultValue !== null && !Number.isFinite(defaultValue))) {\n throw new RangeError(\"NumberField requires finite values and bounds, an ordered range, and a positive step.\");\n }\n const [\n local,\n setLocal,\n ] = useState<number | null>(defaultValue);\n const input = useRef<HTMLInputElement>(null);\n const initial = useRef(defaultValue);\n const current = value === undefined ? local : value;\n useImperativeHandle(ref, () => {\n return input.current as HTMLInputElement;\n });\n useFormReset(input, () => {\n if (value === undefined) {\n setLocal(initial.current);\n }\n }, restProps.form);\n const change = (next: number | null) => {\n if (restProps.readOnly || restProps.disabled || input.current?.matches(\":disabled\")) {\n return;\n }\n if (value === undefined) {\n setLocal(next);\n }\n if (next !== current) {\n onValueChange?.(next);\n }\n };\n const move = (direction: number) => {\n const element = input.current;\n if (!element || restProps.readOnly || element.matches(\":disabled\")) {\n return;\n }\n element.stepUp(direction);\n const next = element.valueAsNumber;\n change(Number.isFinite(next) ? next : null);\n // A controlled consumer can reject the requested value.\n if (value !== undefined) {\n element.value = current === null ? \"\" : String(current);\n }\n element.focus();\n };\n return (<div\n className=\"gridui-u-number-field--flex gridui-u-number-field--min-w-0 gridui-u-number-field--items-stretch gridui-u-number-field--gap-gridui-4\"\n dir={restProps.dir}\n >\n <Button\n variant=\"secondary\"\n layout=\"icon\"\n size={controlSize}\n aria-label={decrementLabel}\n disabled={restProps.disabled || restProps.readOnly || (current !== null && min !== undefined && current <= min)}\n onClick={() => {\n move(-1);\n }}\n >\n <Minus\n aria-hidden=\"true\"\n />\n </Button>\n <input\n {...restProps}\n ref={input}\n type=\"number\"\n min={min}\n max={max}\n step={step}\n value={current ?? \"\"}\n className={cn(controlVariants({ size: controlSize }), \"gridui-number-field gridui-u-number-field--flex-1\", className)}\n onChange={(event) => {\n onChange?.(event);\n if (!event.defaultPrevented) {\n change(Number.isFinite(event.currentTarget.valueAsNumber) ? event.currentTarget.valueAsNumber : null);\n }\n }}\n />\n <Button\n variant=\"secondary\"\n layout=\"icon\"\n size={controlSize}\n aria-label={incrementLabel}\n disabled={restProps.disabled || restProps.readOnly || (current !== null && max !== undefined && current >= max)}\n onClick={() => {\n move(1);\n }}\n >\n <Plus\n aria-hidden=\"true\"\n />\n </Button>\n </div>);\n};\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["/**\n * @author WMXPY\n * @package Number Field\n * @namespace NumberField\n * @description Number Field\n */\n\nimport { Button } from \"@gridui/button\";\nimport { useFormReset } from \"@gridui/form\";\nimport { controlVariants } from \"@gridui/input\";\nimport { cn } from \"@gridui/style-utils\";\nimport { Minus, Plus } from \"lucide-react\";\nimport { type ComponentPropsWithRef, type FC, useImperativeHandle, useRef, useState } from \"react\";\n\nexport type NumberFieldProps = Omit<ComponentPropsWithRef<\"input\">, \"type\" | \"value\" | \"defaultValue\" | \"min\" | \"max\" | \"step\" | \"size\"> & {\n readonly value?: number | null;\n readonly defaultValue?: number | null;\n readonly min?: number;\n readonly max?: number;\n readonly step?: number;\n readonly controlSize?: \"standard\" | \"small\";\n readonly incrementLabel: string;\n readonly decrementLabel: string;\n readonly onValueChange?: (value: number | null) => void;\n};\n\nexport const NumberField: FC<NumberFieldProps> = (props: NumberFieldProps) => {\n const { value, defaultValue = null, min, max, step = 1, controlSize = \"standard\", incrementLabel, decrementLabel,\n onValueChange, onChange, className, ref, ...restProps } = props;\n if (!Number.isFinite(step) || step <= 0 || (min !== undefined && !Number.isFinite(min)) || (max !== undefined && !Number.isFinite(max))\n || (min !== undefined && max !== undefined && min > max)\n || (value !== undefined && value !== null && !Number.isFinite(value))\n || (defaultValue !== null && !Number.isFinite(defaultValue))) {\n throw new RangeError(\"NumberField requires finite values and bounds, an ordered range, and a positive step.\");\n }\n const [\n local,\n setLocal,\n ] = useState<number | null>(defaultValue);\n const input = useRef<HTMLInputElement>(null);\n const initial = useRef(defaultValue);\n const current = value === undefined ? local : value;\n useImperativeHandle(ref, () => {\n return input.current as HTMLInputElement;\n });\n useFormReset(input, () => {\n if (value === undefined) {\n setLocal(initial.current);\n }\n }, restProps.form);\n const change = (next: number | null) => {\n if (restProps.readOnly || restProps.disabled || input.current?.matches(\":disabled\")) {\n return;\n }\n if (value === undefined) {\n setLocal(next);\n }\n if (next !== current) {\n onValueChange?.(next);\n }\n };\n const move = (direction: number) => {\n const element = input.current;\n if (!element || restProps.readOnly || element.matches(\":disabled\")) {\n return;\n }\n element.stepUp(direction);\n const next = element.valueAsNumber;\n change(Number.isFinite(next) ? next : null);\n // A controlled consumer can reject the requested value.\n if (value !== undefined) {\n element.value = current === null ? \"\" : String(current);\n }\n element.focus();\n };\n return (<div\n className=\"gridui-u-number-field--flex gridui-u-number-field--min-w-0 gridui-u-number-field--items-stretch gridui-u-number-field--gap-gridui-4\"\n dir={restProps.dir}\n >\n <Button\n variant=\"secondary\"\n layout=\"icon\"\n size={controlSize}\n aria-label={decrementLabel}\n disabled={restProps.disabled || restProps.readOnly || (current !== null && min !== undefined && current <= min)}\n onClick={() => {\n move(-1);\n }}\n >\n <Minus\n aria-hidden=\"true\"\n />\n </Button>\n <input\n {...restProps}\n ref={input}\n type=\"number\"\n min={min}\n max={max}\n step={step}\n value={value === undefined ? undefined : value ?? \"\"}\n defaultValue={value === undefined ? initial.current ?? \"\" : undefined}\n className={cn(controlVariants({ size: controlSize }), \"gridui-number-field gridui-u-number-field--flex-1\", className)}\n onChange={(event) => {\n onChange?.(event);\n if (!event.defaultPrevented) {\n change(Number.isFinite(event.currentTarget.valueAsNumber) ? event.currentTarget.valueAsNumber : null);\n }\n }}\n />\n <Button\n variant=\"secondary\"\n layout=\"icon\"\n size={controlSize}\n aria-label={incrementLabel}\n disabled={restProps.disabled || restProps.readOnly || (current !== null && max !== undefined && current >= max)}\n onClick={() => {\n move(1);\n }}\n >\n <Plus\n aria-hidden=\"true\"\n />\n </Button>\n </div>);\n};\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
package/docs/catalog.json CHANGED
@@ -1,12 +1,14 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
3
  "name": "@gridui/number-field",
4
- "version": "1.0.8",
4
+ "version": "1.0.10",
5
5
  "category": "core",
6
6
  "description": "GridUI React number field",
7
7
  "usage": "Input supplies the native control presentation; Button supplies the stepper actions. Applications own routes, labels, state persistence, and branding.",
8
8
  "documentation": [
9
- "README.md"
9
+ "README.md",
10
+ "docs/reference/README.md",
11
+ "docs/reference/number-field.md"
10
12
  ],
11
13
  "exports": [
12
14
  {
@@ -29,6 +31,7 @@
29
31
  "@gridui/number-field/styles.css"
30
32
  ],
31
33
  "examples": [
34
+ "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/number-field/stories/numeric-entry.mdx",
32
35
  "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/number-field/stories/number-field.stories.tsx"
33
36
  ]
34
37
  }
@@ -0,0 +1,4 @@
1
+ <!-- Generated by pnpm docs:storybook. -->
2
+ # Component reference
3
+
4
+ - [NumberField](number-field.md)
@@ -0,0 +1,105 @@
1
+ <!-- Generated from public Props and owned stories. Run pnpm docs:storybook. -->
2
+ # NumberField
3
+
4
+ Edits a numeric value with increment and decrement controls. Use it when bounds and step sizes matter.
5
+
6
+ Import from ``@gridui/number-field`` and load Theme before this family's stylesheet.
7
+
8
+ ```tsx
9
+ import { NumberField } from "@gridui/number-field";
10
+ import "@gridui/theme/styles.css";
11
+ import "@gridui/number-field/styles.css";
12
+ ```
13
+
14
+ Read the [package contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/number-field/README.md) for shared behavior and stylesheet dependencies.
15
+
16
+ The [working composition](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/number-field/stories/number-field.stories.tsx) demonstrates required context, state, and related components. Use View code in Storybook to inspect the actual implementation.
17
+
18
+ ## API
19
+
20
+ The public Props type is the source of these signatures. Defaults below are explicit implementation defaults; story presets are separate. Native attributes remain available through the exported Props type.
21
+
22
+ ### children
23
+
24
+ ``ReactNode`` · Optional
25
+
26
+ Content rendered inside the component.
27
+
28
+ ### onFocus
29
+
30
+ ``(event: FocusEvent<HTMLInputElement, Element>): void`` · Optional
31
+
32
+ Called when the corresponding interaction occurs; inspect the arguments in Actions.
33
+
34
+ ### onBlur
35
+
36
+ ``(event: FocusEvent<HTMLInputElement, Element>): void`` · Optional
37
+
38
+ Called when the corresponding interaction occurs; inspect the arguments in Actions.
39
+
40
+ ### onChange
41
+
42
+ ``(event: ChangeEvent<HTMLInputElement, HTMLInputElement>): void`` · Optional
43
+
44
+ Called when the corresponding interaction occurs; inspect the arguments in Actions.
45
+
46
+ ### onSubmit
47
+
48
+ ``(event: SubmitEvent<HTMLInputElement>): void`` · Optional
49
+
50
+ Called when the corresponding interaction occurs; inspect the arguments in Actions.
51
+
52
+ ### onClick
53
+
54
+ ``(event: MouseEvent<HTMLInputElement, MouseEvent>): void`` · Optional
55
+
56
+ Called when the corresponding interaction occurs; inspect the arguments in Actions.
57
+
58
+ ### value
59
+
60
+ ``number | null | undefined`` · Optional
61
+
62
+ Controlled value. Pair with the corresponding change callback.
63
+
64
+ ### defaultValue
65
+
66
+ ``number | null | undefined`` · Optional
67
+
68
+ Default: ``null``
69
+
70
+ Initial uncontrolled value. Reset the story after changing it.
71
+
72
+ ### min
73
+
74
+ ``number | undefined`` · Optional
75
+
76
+ ### max
77
+
78
+ ``number | undefined`` · Optional
79
+
80
+ ### step
81
+
82
+ ``number | undefined`` · Optional
83
+
84
+ Default: ``1``
85
+
86
+ ### controlSize
87
+
88
+ ``"small" | "standard" | undefined`` · Optional
89
+
90
+ Default: ``"standard"``
91
+
92
+ ### incrementLabel
93
+
94
+ ``string`` · Required
95
+
96
+ ### decrementLabel
97
+
98
+ ``string`` · Required
99
+
100
+ ### onValueChange
101
+
102
+ ``(value: number | null): void`` · Optional
103
+
104
+ Called when the corresponding interaction occurs; inspect the arguments in Actions.
105
+
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gridui/number-field",
3
- "version": "1.0.8",
3
+ "version": "1.0.10",
4
4
  "description": "GridUI React number field",
5
5
  "license": "UNLICENSED",
6
6
  "type": "module",
@@ -27,10 +27,10 @@
27
27
  "react-dom": "^19.2.0"
28
28
  },
29
29
  "dependencies": {
30
- "@gridui/button": "^4.0.0",
31
- "@gridui/form": "^4.0.0",
32
- "@gridui/input": "^2.0.0",
33
- "@gridui/style-utils": "^3.0.0",
30
+ "@gridui/button": "^4.1.0",
31
+ "@gridui/form": "^4.1.1",
32
+ "@gridui/input": "^3.0.1",
33
+ "@gridui/style-utils": "^4.0.0",
34
34
  "@gridui/theme": "^2.5.3",
35
35
  "lucide-react": "1.70.0"
36
36
  },