@gridui/number-field 1.1.0 → 2.0.0

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
@@ -1,6 +1,6 @@
1
1
  # @gridui/number-field
2
2
 
3
- Core family. Public API: `NumberField`, `NumberFieldProps`.
3
+ Controls family. Public API: `NumberField`, `NumberFieldProps`.
4
4
 
5
5
  Import components from `@gridui/number-field` and load these styles in order.
6
6
 
@@ -22,7 +22,7 @@ dependency styles; Theme/reset remain separate. See the
22
22
  for static HTML loading, SSR limits, and avoiding duplicate CSS.
23
23
 
24
24
 
25
- 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).
25
+ 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-controls/number-field/.changeset/history).
26
26
 
27
27
  Uncontrolled fields retain their initial native value attribute, which supplies
28
28
  HTML's step base when `min` is omitted. Editing does not change that base. The
@@ -31,3 +31,10 @@ availability and restores the initial value on an uncanceled form reset.
31
31
  Controlled fields continue to follow `value` and can reject change requests.
32
32
 
33
33
  [Component reference](docs/reference/README.md) contains focused API pages for each public component.
34
+
35
+ ## Sizing and density
36
+
37
+ size accepts small, medium (default) or large and coordinates the visible numeric field and stepper actions. Bounds, parsing, stepping and native form values are independent of presentation. Native numeric input size is not a visual-size API.
38
+
39
+ See the [shared sizing contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/docs/usage/sizing.md)
40
+ for native attributes, scope precedence, tokens and target behavior.
package/dist/index.js CHANGED
@@ -13,7 +13,7 @@ var NumberField = (props) => {
13
13
  min,
14
14
  max,
15
15
  step = 1,
16
- controlSize = "standard",
16
+ size = "medium",
17
17
  incrementLabel,
18
18
  decrementLabel,
19
19
  onValueChange,
@@ -75,7 +75,7 @@ var NumberField = (props) => {
75
75
  {
76
76
  variant: "secondary",
77
77
  layout: "icon",
78
- size: controlSize,
78
+ size,
79
79
  "aria-label": decrementLabel,
80
80
  disabled: restProps.disabled || restProps.readOnly || current !== null && min !== void 0 && current <= min,
81
81
  onClick: () => {
@@ -100,7 +100,7 @@ var NumberField = (props) => {
100
100
  step,
101
101
  value: value === void 0 ? void 0 : value ?? "",
102
102
  defaultValue: value === void 0 ? initial.current ?? "" : void 0,
103
- className: cn(controlVariants({ size: controlSize }), "gridui-number-field gridui-u-number-field--flex-1", className),
103
+ className: cn(controlVariants({ size }), "gridui-number-field gridui-u-number-field--flex-1", className),
104
104
  onChange: (event) => {
105
105
  onChange?.(event);
106
106
  if (!event.defaultPrevented) {
@@ -114,7 +114,7 @@ var NumberField = (props) => {
114
114
  {
115
115
  variant: "secondary",
116
116
  layout: "icon",
117
- size: controlSize,
117
+ size,
118
118
  "aria-label": incrementLabel,
119
119
  disabled: restProps.disabled || restProps.readOnly || current !== null && max !== void 0 && current >= max,
120
120
  onClick: () => {
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={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": ";AAOA,SAAS,cAAc;AACvB,SAAS,oBAAoB;AAC7B,SAAS,uBAAuB;AAChC,SAAS,UAAU;AACnB,SAAS,OAAO,YAAY;AAC5B,SAA8C,qBAAqB,QAAQ,gBAAgB;AA+D/E,SAcA,KAdA;AAjDL,IAAM,cAAoC,CAAC,UAA4B;AAC1E,QAAM;AAAA,IAAE;AAAA,IAAO,eAAe;AAAA,IAAM;AAAA,IAAK;AAAA,IAAK,OAAO;AAAA,IAAG,cAAc;AAAA,IAAY;AAAA,IAAgB;AAAA,IAC9F;AAAA,IAAe;AAAA,IAAU;AAAA,IAAW;AAAA,IAAK,GAAG;AAAA,EAAU,IAAI;AAC9D,MAAI,CAAC,OAAO,SAAS,IAAI,KAAK,QAAQ,KAAM,QAAQ,UAAa,CAAC,OAAO,SAAS,GAAG,KAAO,QAAQ,UAAa,CAAC,OAAO,SAAS,GAAG,KAC7H,QAAQ,UAAa,QAAQ,UAAa,MAAM,OAChD,UAAU,UAAa,UAAU,QAAQ,CAAC,OAAO,SAAS,KAAK,KAC/D,iBAAiB,QAAQ,CAAC,OAAO,SAAS,YAAY,GAAI;AAC9D,UAAM,IAAI,WAAW,uFAAuF;AAAA,EAChH;AACA,QAAM;AAAA,IACF;AAAA,IACA;AAAA,EACJ,IAAI,SAAwB,YAAY;AACxC,QAAM,QAAQ,OAAyB,IAAI;AAC3C,QAAM,UAAU,OAAO,YAAY;AACnC,QAAM,UAAU,UAAU,SAAY,QAAQ;AAC9C,sBAAoB,KAAK,MAAM;AAC3B,WAAO,MAAM;AAAA,EACjB,CAAC;AACD,eAAa,OAAO,MAAM;AACtB,QAAI,UAAU,QAAW;AACrB,eAAS,QAAQ,OAAO;AAAA,IAC5B;AAAA,EACJ,GAAG,UAAU,IAAI;AACjB,QAAM,SAAS,CAAC,SAAwB;AACpC,QAAI,UAAU,YAAY,UAAU,YAAY,MAAM,SAAS,QAAQ,WAAW,GAAG;AACjF;AAAA,IACJ;AACA,QAAI,UAAU,QAAW;AACrB,eAAS,IAAI;AAAA,IACjB;AACA,QAAI,SAAS,SAAS;AAClB,sBAAgB,IAAI;AAAA,IACxB;AAAA,EACJ;AACA,QAAM,OAAO,CAAC,cAAsB;AAChC,UAAM,UAAU,MAAM;AACtB,QAAI,CAAC,WAAW,UAAU,YAAY,QAAQ,QAAQ,WAAW,GAAG;AAChE;AAAA,IACJ;AACA,YAAQ,OAAO,SAAS;AACxB,UAAM,OAAO,QAAQ;AACrB,WAAO,OAAO,SAAS,IAAI,IAAI,OAAO,IAAI;AAE1C,QAAI,UAAU,QAAW;AACrB,cAAQ,QAAQ,YAAY,OAAO,KAAK,OAAO,OAAO;AAAA,IAC1D;AACA,YAAQ,MAAM;AAAA,EAClB;AACA,SAAQ;AAAA,IAAC;AAAA;AAAA,MACL,WAAU;AAAA,MACV,KAAK,UAAU;AAAA,MAEf;AAAA;AAAA,UAAC;AAAA;AAAA,YACG,SAAQ;AAAA,YACR,QAAO;AAAA,YACP,MAAM;AAAA,YACN,cAAY;AAAA,YACZ,UAAU,UAAU,YAAY,UAAU,YAAa,YAAY,QAAQ,QAAQ,UAAa,WAAW;AAAA,YAC3G,SAAS,MAAM;AACX,mBAAK,EAAE;AAAA,YACX;AAAA,YAEA;AAAA,cAAC;AAAA;AAAA,gBACG,eAAY;AAAA;AAAA,YAChB;AAAA;AAAA,QACJ;AAAA,QACA;AAAA,UAAC;AAAA;AAAA,YACI,GAAG;AAAA,YACJ,KAAK;AAAA,YACL,MAAK;AAAA,YACL;AAAA,YACA;AAAA,YACA;AAAA,YACA,OAAO,UAAU,SAAY,SAAY,SAAS;AAAA,YAClD,cAAc,UAAU,SAAY,QAAQ,WAAW,KAAK;AAAA,YAC5D,WAAW,GAAG,gBAAgB,EAAE,MAAM,YAAY,CAAC,GAAG,qDAAqD,SAAS;AAAA,YACpH,UAAU,CAAC,UAAU;AACjB,yBAAW,KAAK;AAChB,kBAAI,CAAC,MAAM,kBAAkB;AACzB,uBAAO,OAAO,SAAS,MAAM,cAAc,aAAa,IAAI,MAAM,cAAc,gBAAgB,IAAI;AAAA,cACxG;AAAA,YACJ;AAAA;AAAA,QACJ;AAAA,QACA;AAAA,UAAC;AAAA;AAAA,YACG,SAAQ;AAAA,YACR,QAAO;AAAA,YACP,MAAM;AAAA,YACN,cAAY;AAAA,YACZ,UAAU,UAAU,YAAY,UAAU,YAAa,YAAY,QAAQ,QAAQ,UAAa,WAAW;AAAA,YAC3G,SAAS,MAAM;AACX,mBAAK,CAAC;AAAA,YACV;AAAA,YAEA;AAAA,cAAC;AAAA;AAAA,gBACG,eAAY;AAAA;AAAA,YAChB;AAAA;AAAA,QACJ;AAAA;AAAA;AAAA,EACJ;AACJ;",
4
+ "sourcesContent": ["/**\n * @author WMXPY\n * @package Number Field\n * @namespace NumberField\n * @description Number Field\n */\n\nimport type { Size } from \"@gridui/theme\";\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 size?: Size;\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, size = \"medium\", 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={size}\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 }), \"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={size}\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
  }
@@ -4,6 +4,7 @@
4
4
  * @namespace NumberField
5
5
  * @description Number Field
6
6
  */
7
+ import type { Size } from "@gridui/theme";
7
8
  import { type ComponentPropsWithRef, type FC } from "react";
8
9
  export type NumberFieldProps = Omit<ComponentPropsWithRef<"input">, "type" | "value" | "defaultValue" | "min" | "max" | "step" | "size"> & {
9
10
  readonly value?: number | null;
@@ -11,7 +12,7 @@ export type NumberFieldProps = Omit<ComponentPropsWithRef<"input">, "type" | "va
11
12
  readonly min?: number;
12
13
  readonly max?: number;
13
14
  readonly step?: number;
14
- readonly controlSize?: "standard" | "small";
15
+ readonly size?: Size;
15
16
  readonly incrementLabel: string;
16
17
  readonly decrementLabel: string;
17
18
  readonly onValueChange?: (value: number | null) => void;
package/dist/styles.css CHANGED
@@ -1,11 +1,6 @@
1
1
  /*! tailwindcss v4.3.5 | MIT License | https://tailwindcss.com */
2
2
  @layer properties;
3
3
  @layer theme, base, components, utilities;
4
- @layer theme {
5
- :root, :host {
6
- --spacing: 0.25rem;
7
- }
8
- }
9
4
  @layer utilities {
10
5
  .gridui-u-button--pointer-events-none {
11
6
  pointer-events: none;
@@ -13,24 +8,13 @@
13
8
  .gridui-u-button--inline-flex {
14
9
  display: inline-flex;
15
10
  }
11
+ .gridui-u-button--size-\(--_gridui-button-min\) {
12
+ width: var(--_gridui-button-min);
13
+ height: var(--_gridui-button-min);
14
+ }
16
15
  .gridui-u-button--h-full {
17
16
  height: 100%;
18
17
  }
19
- .gridui-u-button--h-gridui-control {
20
- height: var(--gridui-control-min-height);
21
- }
22
- .gridui-u-button--min-h-18 {
23
- min-height: calc(var(--spacing) * 18);
24
- }
25
- .gridui-u-button--min-h-gridui-control {
26
- min-height: var(--gridui-control-min-height);
27
- }
28
- .gridui-u-button--min-h-gridui-control-large {
29
- min-height: var(--gridui-control-min-height-large);
30
- }
31
- .gridui-u-button--min-h-gridui-control-small {
32
- min-height: var(--gridui-control-min-height-small);
33
- }
34
18
  .gridui-u-button--w-fit {
35
19
  width: fit-content;
36
20
  }
@@ -40,14 +24,14 @@
40
24
  .gridui-u-button--w-gridui-64 {
41
25
  width: var(--gridui-space-64);
42
26
  }
43
- .gridui-u-button--w-gridui-control {
44
- width: var(--gridui-control-min-height);
45
- }
46
27
  .gridui-u-button--w-gridui-control-large {
47
- width: var(--gridui-control-min-height-large);
28
+ width: max(var(--gridui-control-min-height-large), var(--gridui-target-min-size));
29
+ }
30
+ .gridui-u-button--w-gridui-control-medium {
31
+ width: max(var(--gridui-control-min-height-medium), var(--gridui-target-min-size));
48
32
  }
49
33
  .gridui-u-button--w-gridui-control-small {
50
- width: var(--gridui-control-min-height-small);
34
+ width: max(var(--gridui-control-min-height-small), var(--gridui-target-min-size));
51
35
  }
52
36
  .gridui-u-button--max-w-full {
53
37
  max-width: 100%;
@@ -253,35 +237,10 @@
253
237
  .gridui-u-button--\[\&_svg\]\:shrink-0 svg {
254
238
  flex-shrink: 0;
255
239
  }
256
- .gridui-u-button--\[\&\.gridui-button-extra-large\]\:h-18.gridui-button-extra-large {
257
- height: calc(var(--spacing) * 18);
258
- }
259
- .gridui-u-button--\[\&\.gridui-button-extra-large\]\:w-18.gridui-button-extra-large {
260
- width: calc(var(--spacing) * 18);
261
- }
262
- .gridui-u-button--\[\&\.gridui-button-large\]\:h-gridui-control-large.gridui-button-large {
263
- height: var(--gridui-control-min-height-large);
264
- }
265
- .gridui-u-button--\[\&\.gridui-button-large\]\:w-gridui-control-large.gridui-button-large {
266
- width: var(--gridui-control-min-height-large);
267
- }
268
- .gridui-u-button--\[\&\.gridui-button-small\]\:h-gridui-control-small.gridui-button-small {
269
- height: var(--gridui-control-min-height-small);
270
- }
271
- .gridui-u-button--\[\&\.gridui-button-small\]\:w-gridui-control-small.gridui-button-small {
272
- width: var(--gridui-control-min-height-small);
273
- }
274
- @media (pointer: coarse) {
275
- .gridui-u-button--pointer-coarse\:\[\&\.gridui-button-small\]\:h-gridui-control.gridui-button-small {
276
- height: var(--gridui-control-min-height);
277
- }
278
- .gridui-u-button--pointer-coarse\:\[\&\.gridui-button-small\]\:w-gridui-control.gridui-button-small {
279
- width: var(--gridui-control-min-height);
280
- }
281
- }
282
240
  }
283
241
  @layer components {
284
242
  .gridui-button {
243
+ min-height: var(--_gridui-button-min);
285
244
  border: 1px solid transparent;
286
245
  }
287
246
  .gridui-button-cell {
@@ -327,8 +286,27 @@
327
286
  transform: var(--gridui-motion-transform, translate(calc(-1 * var(--gridui-space-4)), calc(-1 * var(--gridui-space-4))));
328
287
  }
329
288
  }
289
+ .gridui-button-medium {
290
+ --_gridui-button-min: max(var(--gridui-control-min-height-medium), var(--gridui-target-min-size));
291
+ padding-block: var(--gridui-space-8);
292
+ padding-inline: var(--gridui-space-16);
293
+ }
294
+ .gridui-button-small {
295
+ --_gridui-button-min: max(var(--gridui-control-min-height-small), var(--gridui-target-min-size));
296
+ padding-block: var(--gridui-space-4);
297
+ padding-inline: var(--gridui-space-8);
298
+ }
299
+ .gridui-button-large {
300
+ --_gridui-button-min: max(var(--gridui-control-min-height-large), var(--gridui-target-min-size));
301
+ padding-block: var(--gridui-space-8);
302
+ padding-inline: var(--gridui-space-24);
303
+ }
304
+ .gridui-button-extra-large {
305
+ --_gridui-button-min: max(var(--gridui-control-min-height-extra-large), var(--gridui-target-min-size));
306
+ padding-block: var(--gridui-space-16);
307
+ padding-inline: var(--gridui-space-24);
308
+ }
330
309
  .gridui-button-group {
331
- --gridui-button-group-padding-block: var(--gridui-space-24);
332
310
  container: gridui-button-group / inline-size;
333
311
  min-width: 0;
334
312
  }
@@ -371,12 +349,19 @@
371
349
  min-width: 0;
372
350
  }
373
351
  .gridui-button-group-items[data-layout="cells"] > [data-gridui-button-group-item] {
374
- min-height: 2.75rem;
375
- padding: var(--gridui-button-group-padding-block) var(--gridui-space-24);
352
+ padding-block: var(--gridui-button-group-padding-block, var(--_gridui-button-group-block, var(--gridui-space-8)));
376
353
  border: 0;
377
354
  border-radius: 0;
378
355
  }
379
356
  }
357
+ @layer components {
358
+ .gridui-button-group-items > [data-size="small"] {
359
+ --_gridui-button-group-block: var(--gridui-space-4);
360
+ }
361
+ .gridui-button-group-items > [data-size="extra-large"] {
362
+ --_gridui-button-group-block: var(--gridui-space-16);
363
+ }
364
+ }
380
365
  @property --tw-border-style {
381
366
  syntax: "*";
382
367
  inherits: false;
@@ -505,11 +490,6 @@
505
490
  /*! tailwindcss v4.3.5 | MIT License | https://tailwindcss.com */
506
491
  @layer properties;
507
492
  @layer theme, base, components, utilities;
508
- @layer theme {
509
- :root, :host {
510
- --spacing: 0.25rem;
511
- }
512
- }
513
493
  @layer utilities {
514
494
  .gridui-u-overlay--z-\(--gridui-z-popover\) {
515
495
  z-index: var(--gridui-z-popover);
@@ -524,9 +504,6 @@
524
504
  width: var(--gridui-space-16);
525
505
  height: var(--gridui-space-16);
526
506
  }
527
- .gridui-u-overlay--min-h-10 {
528
- min-height: calc(var(--spacing) * 10);
529
- }
530
507
  .gridui-u-overlay--min-w-0 {
531
508
  min-width: 0px;
532
509
  }
@@ -565,15 +542,9 @@
565
542
  .gridui-u-overlay--p-0 {
566
543
  padding: 0px;
567
544
  }
568
- .gridui-u-overlay--p-gridui-8 {
569
- padding: var(--gridui-space-8);
570
- }
571
545
  .gridui-u-overlay--px-gridui-8 {
572
546
  padding-inline: var(--gridui-space-8);
573
547
  }
574
- .gridui-u-overlay--py-gridui-8 {
575
- padding-block: var(--gridui-space-8);
576
- }
577
548
  .gridui-u-overlay--type-data {
578
549
  font: var(--gridui-type-data);
579
550
  font-family: var(--gridui-font-body);
@@ -680,6 +651,25 @@
680
651
  animation: none;
681
652
  }
682
653
  }
654
+ .gridui-overlay-list {
655
+ --gridui-overlay-row-min: var(--gridui-control-min-height-medium);
656
+ --gridui-overlay-row-padding: var(--gridui-space-8);
657
+ }
658
+ .gridui-overlay-density-compact {
659
+ --gridui-overlay-row-min: var(--gridui-control-min-height-small);
660
+ --gridui-overlay-row-padding: var(--gridui-space-4);
661
+ }
662
+ .gridui-overlay-density-comfortable {
663
+ --gridui-overlay-row-min: var(--gridui-control-min-height-medium);
664
+ --gridui-overlay-row-padding: var(--gridui-space-8);
665
+ }
666
+ .gridui-overlay-list-item {
667
+ min-block-size: max(var(--gridui-overlay-row-min, var(--gridui-control-min-height-medium)), var(--gridui-target-min-size));
668
+ padding-block: var(--gridui-overlay-row-padding, var(--gridui-space-8));
669
+ }
670
+ .gridui-overlay-list-label {
671
+ padding-block: var(--gridui-overlay-row-padding, var(--gridui-space-8));
672
+ }
683
673
  }
684
674
  @property --tw-border-style {
685
675
  syntax: "*";
@@ -704,11 +694,14 @@
704
694
  .gridui-u-input--inline-flex {
705
695
  display: inline-flex;
706
696
  }
707
- .gridui-u-input--min-h-gridui-control {
708
- min-height: var(--gridui-control-min-height);
697
+ .gridui-u-input--min-h-gridui-control-large {
698
+ min-height: max(var(--gridui-control-min-height-large), var(--gridui-target-min-size));
699
+ }
700
+ .gridui-u-input--min-h-gridui-control-medium {
701
+ min-height: max(var(--gridui-control-min-height-medium), var(--gridui-target-min-size));
709
702
  }
710
703
  .gridui-u-input--min-h-gridui-control-small {
711
- min-height: var(--gridui-control-min-height-small);
704
+ min-height: max(var(--gridui-control-min-height-small), var(--gridui-target-min-size));
712
705
  }
713
706
  .gridui-u-input--w-0 {
714
707
  width: 0px;
@@ -767,9 +760,15 @@
767
760
  .gridui-u-input--px-gridui-8 {
768
761
  padding-inline: var(--gridui-space-8);
769
762
  }
763
+ .gridui-u-input--px-gridui-16 {
764
+ padding-inline: var(--gridui-space-16);
765
+ }
770
766
  .gridui-u-input--py-gridui-4 {
771
767
  padding-block: var(--gridui-space-4);
772
768
  }
769
+ .gridui-u-input--py-gridui-8 {
770
+ padding-block: var(--gridui-space-8);
771
+ }
773
772
  .gridui-u-input--type-input {
774
773
  font: var(--gridui-type-input);
775
774
  font-family: var(--gridui-font-body);
@@ -783,6 +782,21 @@
783
782
  .gridui-u-input--text-foreground {
784
783
  color: var(--gridui-foreground);
785
784
  }
785
+ .gridui-u-input--\[--gridui-control-icon\:var\(--gridui-icon-size\)\] {
786
+ --gridui-control-icon: var(--gridui-icon-size);
787
+ }
788
+ .gridui-u-input--\[--gridui-control-icon\:var\(--gridui-icon-size-large\)\] {
789
+ --gridui-control-icon: var(--gridui-icon-size-large);
790
+ }
791
+ .gridui-u-input--\[--gridui-control-size\:max\(var\(--gridui-control-min-height-large\)\,var\(--gridui-target-min-size\)\)\] {
792
+ --gridui-control-size: max(var(--gridui-control-min-height-large), var(--gridui-target-min-size));
793
+ }
794
+ .gridui-u-input--\[--gridui-control-size\:max\(var\(--gridui-control-min-height-medium\)\,var\(--gridui-target-min-size\)\)\] {
795
+ --gridui-control-size: max(var(--gridui-control-min-height-medium), var(--gridui-target-min-size));
796
+ }
797
+ .gridui-u-input--\[--gridui-control-size\:max\(var\(--gridui-control-min-height-small\)\,var\(--gridui-target-min-size\)\)\] {
798
+ --gridui-control-size: max(var(--gridui-control-min-height-small), var(--gridui-target-min-size));
799
+ }
786
800
  .gridui-u-input--disabled\:cursor-not-allowed:disabled {
787
801
  cursor: not-allowed;
788
802
  }
@@ -792,6 +806,10 @@
792
806
  .gridui-u-input--aria-invalid\:border-status-danger-border[aria-invalid="true"] {
793
807
  border-color: var(--gridui-status-danger-border);
794
808
  }
809
+ .gridui-u-input--\[\&_svg\]\:size-\(--gridui-control-icon\) svg {
810
+ width: var(--gridui-control-icon);
811
+ height: var(--gridui-control-icon);
812
+ }
795
813
  .gridui-u-input--\[\&\>svg\]\:size-gridui-16 > svg {
796
814
  width: var(--gridui-space-16);
797
815
  height: var(--gridui-space-16);
@@ -799,7 +817,7 @@
799
817
  }
800
818
  @layer components {
801
819
  .gridui-input-group {
802
- --_gridui-input-height: var(--gridui-control-min-height);
820
+ --_gridui-input-height: max(var(--gridui-control-min-height-medium), var(--gridui-target-min-size));
803
821
  position: relative;
804
822
  display: flex;
805
823
  flex-wrap: wrap;
@@ -812,8 +830,8 @@
812
830
  border-radius: var(--gridui-control-radius);
813
831
  color: var(--gridui-foreground);
814
832
  background: var(--gridui-background);
815
- &[data-control-size="small"] {
816
- --_gridui-input-height: var(--gridui-control-min-height-small);
833
+ &[data-size="small"] {
834
+ --_gridui-input-height: max(var(--gridui-control-min-height-small), var(--gridui-target-min-size));
817
835
  }
818
836
  > .gridui-control {
819
837
  flex: 1;
@@ -869,9 +887,12 @@
869
887
  .gridui-input-group-button {
870
888
  flex: none;
871
889
  }
890
+ .gridui-input-group[data-size="large"] {
891
+ --_gridui-input-height: max(var(--gridui-control-min-height-large), var(--gridui-target-min-size));
892
+ }
872
893
  .gridui-textarea-frame {
873
894
  --_gridui-textarea-padding: var(--gridui-space-8);
874
- --_gridui-textarea-control-minimum: var(--gridui-control-min-height);
895
+ --_gridui-textarea-control-minimum: max(var(--gridui-control-min-height-medium), var(--gridui-target-min-size));
875
896
  --_gridui-textarea-resize-height: 0px;
876
897
  --_gridui-textarea-footer-height: 0px;
877
898
  --_gridui-textarea-border: 2px;
@@ -882,9 +903,9 @@
882
903
  flex-direction: column;
883
904
  min-height: calc(var(--_gridui-textarea-min-body) + var(--_gridui-textarea-chrome));
884
905
  padding: 0;
885
- &[data-control-size="small"] {
906
+ &[data-size="small"] {
886
907
  --_gridui-textarea-padding: var(--gridui-space-4);
887
- --_gridui-textarea-control-minimum: var(--gridui-control-min-height-small);
908
+ --_gridui-textarea-control-minimum: max(var(--gridui-control-min-height-small), var(--gridui-target-min-size));
888
909
  }
889
910
  &[data-grouped] {
890
911
  --_gridui-textarea-border: 0px;
@@ -896,7 +917,7 @@
896
917
  --_gridui-textarea-resize-height: var(--gridui-space-32);
897
918
  }
898
919
  &:is([data-resize-handle="footer"], [data-footer]) {
899
- --_gridui-textarea-footer-height: var(--gridui-control-min-height);
920
+ --_gridui-textarea-footer-height: max(var(--gridui-control-min-height-medium), var(--gridui-target-min-size));
900
921
  }
901
922
  &[data-max-rows] {
902
923
  max-height: calc(var(--_gridui-textarea-max-rows) * 1lh + 2 * var(--_gridui-textarea-padding) + var(--_gridui-textarea-chrome));
@@ -952,7 +973,7 @@
952
973
  display: flex;
953
974
  flex: none;
954
975
  align-items: stretch;
955
- min-height: var(--gridui-control-min-height);
976
+ min-height: max(var(--gridui-control-min-height-medium), var(--gridui-target-min-size));
956
977
  border-top: 1px solid;
957
978
  border-color: inherit;
958
979
  background: var(--gridui-surface);
@@ -972,7 +993,7 @@
972
993
  flex: none;
973
994
  align-items: center;
974
995
  justify-content: center;
975
- width: var(--gridui-control-min-height);
996
+ width: max(var(--gridui-control-min-height-medium), var(--gridui-target-min-size));
976
997
  margin: 0;
977
998
  padding: 0;
978
999
  border: 0;
@@ -1011,9 +1032,12 @@
1011
1032
  }
1012
1033
  @media (pointer: coarse) {
1013
1034
  .gridui-textarea-frame:is([data-resize-handle="corner"], [data-resize-handle="edge"]) {
1014
- --_gridui-textarea-resize-height: var(--gridui-control-min-height);
1035
+ --_gridui-textarea-resize-height: max(var(--gridui-control-min-height-medium), var(--gridui-target-min-size));
1015
1036
  }
1016
1037
  }
1038
+ .gridui-textarea-frame[data-size="large"] {
1039
+ --_gridui-textarea-control-minimum: max(var(--gridui-control-min-height-large), var(--gridui-target-min-size));
1040
+ }
1017
1041
  .gridui-input-group > input[type="search"]::-webkit-search-cancel-button {
1018
1042
  appearance: none;
1019
1043
  }
package/docs/catalog.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
3
  "name": "@gridui/number-field",
4
- "version": "1.1.0",
5
- "category": "core",
4
+ "version": "2.0.0",
5
+ "category": "controls",
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": [
@@ -32,8 +32,8 @@
32
32
  ],
33
33
  "styledImport": "@gridui/number-field/styled",
34
34
  "examples": [
35
- "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/number-field/stories/getting-started.mdx",
36
- "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/number-field/stories/numeric-entry.mdx",
37
- "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/number-field/stories/number-field.stories.tsx"
35
+ "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-controls/number-field/stories/getting-started.mdx",
36
+ "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-controls/number-field/stories/numeric-entry.mdx",
37
+ "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-controls/number-field/stories/number-field.stories.tsx"
38
38
  ]
39
39
  }
@@ -11,9 +11,9 @@ import "@gridui/theme/styles.css";
11
11
  import "@gridui/number-field/styles.css";
12
12
  ```
13
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.
14
+ Read the [package contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-controls/number-field/README.md) for shared behavior and stylesheet dependencies.
15
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.
16
+ The [working composition](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-controls/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
17
 
18
18
  ## API
19
19
 
@@ -83,11 +83,13 @@ Initial uncontrolled value. Reset the story after changing it.
83
83
 
84
84
  Default: ``1``
85
85
 
86
- ### controlSize
86
+ ### size
87
87
 
88
- ``"small" | "standard" | undefined`` · Optional
88
+ ``Size | undefined`` · Optional
89
89
 
90
- Default: ``"standard"``
90
+ Default: ``"medium"``
91
+
92
+ Component size preset.
91
93
 
92
94
  ### incrementLabel
93
95
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gridui/number-field",
3
- "version": "1.1.0",
3
+ "version": "2.0.0",
4
4
  "description": "GridUI React number field",
5
5
  "license": "UNLICENSED",
6
6
  "type": "module",
@@ -32,12 +32,12 @@
32
32
  "react-dom": "^19.2.0"
33
33
  },
34
34
  "dependencies": {
35
- "@gridui/button": "^5.2.0",
36
- "@gridui/form": "^4.2.0",
37
- "@gridui/input": "^4.1.0",
38
- "@gridui/style-utils": "^4.0.0",
39
- "@gridui/theme": "^4.0.0",
40
- "lucide-react": "1.72.0"
35
+ "@gridui/button": "^6.0.0",
36
+ "@gridui/form": "^4.2.1",
37
+ "@gridui/input": "^5.0.0",
38
+ "@gridui/style-utils": "^4.1.0",
39
+ "@gridui/theme": "^5.0.0",
40
+ "lucide-react": "1.73.0"
41
41
  },
42
42
  "devDependencies": {
43
43
  "@gridui-internal/configuration": "0.0.0-internal",