@gridui/form 4.2.0 → 4.2.1

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,11 +1,11 @@
1
1
  # @gridui/form
2
2
 
3
- Core family. Public API: `ActionForm`, `ActionFormProps`, `Field`, `FieldGrid`, `FieldGridProps`, `FieldNote`, `FieldNoteProps`, `FieldProps`, `Fieldset`, `FieldsetProps`, `ListFieldControl`, `ListFieldControlProps`, `ListFieldProps`, `SearchForm`, `SearchFormProps`, `fieldClass`, `focusInvalidControl`, `runFormAction`, `useFormReset`, `useListField`.
3
+ Controls family. Public API: `ActionForm`, `ActionFormProps`, `Field`, `FieldGrid`, `FieldGridProps`, `FieldNote`, `FieldNoteProps`, `FieldProps`, `Fieldset`, `FieldsetProps`, `ListFieldControl`, `ListFieldControlProps`, `ListFieldProps`, `SearchForm`, `SearchFormProps`, `fieldClass`, `focusInvalidControl`, `runFormAction`, `useFormReset`, `useListField`.
4
4
 
5
5
  Import components from `@gridui/form` and load `@gridui/form/styles.css` after Theme.
6
6
  Applications own routes, labels, state persistence, and branding.
7
7
 
8
- 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/form/.changeset/history).
8
+ 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/form/.changeset/history).
9
9
 
10
10
  ## Styles
11
11
 
@@ -36,3 +36,10 @@ Read [Native form state and reset](docs/guides/form-state.md).
36
36
  [Component reference](docs/reference/README.md) contains focused API pages for each public component.
37
37
 
38
38
  Use `useField` for native label/help/error associations and `FieldCounter` for localized native-length feedback. See [fields](docs/guides/fields.md#associations-and-counters).
39
+
40
+ ## Sizing and density
41
+
42
+ Form arrangements and association helpers do not set descendant size. Choose size on rendered Input, Select, Button and other controls; keep grow/span and spacing on the arrangement. This preserves independent sizing in mixed forms.
43
+
44
+ See the [shared sizing contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/docs/usage/sizing.md)
45
+ for native attributes, scope precedence, tokens and target behavior.
package/docs/catalog.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
3
  "name": "@gridui/form",
4
- "version": "4.2.0",
5
- "category": "core",
4
+ "version": "4.2.1",
5
+ "category": "controls",
6
6
  "description": "GridUI React form",
7
7
  "usage": "Read Fields and native controls.",
8
8
  "documentation": [
@@ -149,14 +149,14 @@
149
149
  ],
150
150
  "styledImport": "@gridui/form/styled",
151
151
  "examples": [
152
- "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/form/stories/custom-controls.mdx",
153
- "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/form/stories/field-associations.mdx",
154
- "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/form/stories/filter-layouts.mdx",
155
- "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/form/stories/getting-started.mdx",
156
- "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/form/stories/submission.mdx",
157
- "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/form/stories/action-form.stories.tsx",
158
- "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/form/stories/field-counter.stories.tsx",
159
- "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/form/stories/field.stories.tsx",
160
- "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/form/stories/search-form.stories.tsx"
152
+ "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-controls/form/stories/custom-controls.mdx",
153
+ "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-controls/form/stories/field-associations.mdx",
154
+ "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-controls/form/stories/filter-layouts.mdx",
155
+ "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-controls/form/stories/getting-started.mdx",
156
+ "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-controls/form/stories/submission.mdx",
157
+ "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-controls/form/stories/action-form.stories.tsx",
158
+ "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-controls/form/stories/field-counter.stories.tsx",
159
+ "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-controls/form/stories/field.stories.tsx",
160
+ "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-controls/form/stories/search-form.stories.tsx"
161
161
  ]
162
162
  }
@@ -1,6 +1,6 @@
1
1
  # Action forms and asynchronous submission
2
2
 
3
- [`useAsyncAction` from `@gridui/button`](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/button/README.md#action-helpers)
3
+ [`useAsyncAction` from `@gridui/button`](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-controls/button/README.md#action-helpers)
4
4
  owns pending state and scheduling for caller-owned actions. `ActionForm` from
5
5
  `@gridui/form` prevents native form navigation and invokes its declared
6
6
  `onAction` unless disabled. Native form
@@ -2,7 +2,7 @@
2
2
 
3
3
  `@gridui/form` owns field presentation, ActionForm, shared form state helpers, and FieldGrid/SearchForm arrangements. Input and Label belong to `@gridui/input`; Select and Combobox belong to `@gridui/select`; FilePicker belongs to `@gridui/file-picker`.
4
4
  Inputs preserve native form constraints, refs, labels, descriptions and invalid
5
- state; controls use 2.75rem standard or 2.25rem small sizing. Select accepts explicit
5
+ state; controls use small, medium or large sizing. Select accepts explicit
6
6
  options with managed keyboard navigation, focus, and native form integration. `Field`, `Fieldset`, and
7
7
  `FieldNote` own field grouping and error presentation. Input Label owns label/icon alignment.
8
8
  Fieldset keeps native disabled propagation and legend semantics.
@@ -8,7 +8,7 @@ children retain their own sizing. Layout containers do not style arbitrary divs,
8
8
  labels, or icons. Use Input's `<Label icon={...}>` for label/icon alignment.
9
9
  Migration: add `grow` to former implicitly stretched SearchForm children and
10
10
  use Label instead of relying on FieldGrid to restyle native labels.
11
- Both forward native props and refs. The corresponding Core families own labels, constraints, invalid
11
+ Both forward native props and refs. The corresponding Controls families own labels, constraints, invalid
12
12
  state, field notes, and native fieldset semantics; applications own values,
13
13
  validation, and submission actions. These local form arrangements do not own
14
14
  page frames or shared region seams.
@@ -11,9 +11,9 @@ import "@gridui/theme/styles.css";
11
11
  import "@gridui/form/styles.css";
12
12
  ```
13
13
 
14
- Read the [package contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/form/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/form/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/form/stories/action-form.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/form/stories/action-form.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
 
@@ -11,9 +11,9 @@ import "@gridui/theme/styles.css";
11
11
  import "@gridui/form/styles.css";
12
12
  ```
13
13
 
14
- Read the [package contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/form/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/form/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/form/stories/field-counter.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/form/stories/field-counter.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
 
@@ -11,7 +11,7 @@ import "@gridui/theme/styles.css";
11
11
  import "@gridui/form/styles.css";
12
12
  ```
13
13
 
14
- Read the [package contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/form/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/form/README.md) for shared behavior and stylesheet dependencies.
15
15
 
16
16
  ## API
17
17
 
@@ -11,9 +11,9 @@ import "@gridui/theme/styles.css";
11
11
  import "@gridui/form/styles.css";
12
12
  ```
13
13
 
14
- Read the [package contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/form/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/form/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/form/stories/action-form.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/form/stories/action-form.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
 
@@ -11,9 +11,9 @@ import "@gridui/theme/styles.css";
11
11
  import "@gridui/form/styles.css";
12
12
  ```
13
13
 
14
- Read the [package contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/form/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/form/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/form/stories/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/form/stories/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
 
@@ -11,9 +11,9 @@ import "@gridui/theme/styles.css";
11
11
  import "@gridui/form/styles.css";
12
12
  ```
13
13
 
14
- Read the [package contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/form/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/form/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/form/stories/action-form.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/form/stories/action-form.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
 
@@ -11,7 +11,7 @@ import "@gridui/theme/styles.css";
11
11
  import "@gridui/form/styles.css";
12
12
  ```
13
13
 
14
- Read the [package contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/form/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/form/README.md) for shared behavior and stylesheet dependencies.
15
15
 
16
16
  ## API
17
17
 
@@ -11,9 +11,9 @@ import "@gridui/theme/styles.css";
11
11
  import "@gridui/form/styles.css";
12
12
  ```
13
13
 
14
- Read the [package contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/form/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/form/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/form/stories/search-form.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/form/stories/search-form.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
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gridui/form",
3
- "version": "4.2.0",
3
+ "version": "4.2.1",
4
4
  "description": "GridUI React form",
5
5
  "license": "UNLICENSED",
6
6
  "type": "module",
@@ -32,14 +32,14 @@
32
32
  "react-dom": "^19.2.0"
33
33
  },
34
34
  "dependencies": {
35
- "@gridui/style-utils": "^4.0.0",
36
- "@gridui/theme": "^4.0.0",
35
+ "@gridui/style-utils": "^4.1.0",
36
+ "@gridui/theme": "^5.0.0",
37
37
  "class-variance-authority": "0.7.1"
38
38
  },
39
39
  "devDependencies": {
40
40
  "@gridui-internal/configuration": "0.0.0-internal",
41
- "@gridui/button": "5.2.0",
42
- "@gridui/input": "4.1.0",
41
+ "@gridui/button": "6.0.0",
42
+ "@gridui/input": "5.0.0",
43
43
  "@jest/globals": "30.5.2",
44
44
  "@storybook/react-vite": "10.6.7",
45
45
  "@types/jest": "30.0.0",
@@ -47,7 +47,7 @@
47
47
  "@types/react": "19.3.0",
48
48
  "@types/react-dom": "19.3.0",
49
49
  "jest": "30.5.2",
50
- "lucide-react": "1.72.0",
50
+ "lucide-react": "1.73.0",
51
51
  "react": "19.3.1",
52
52
  "react-dom": "19.3.1",
53
53
  "typescript": "6.0.3"