@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 +9 -2
- package/docs/catalog.json +11 -11
- package/docs/guides/action-form.md +1 -1
- package/docs/guides/fields.md +1 -1
- package/docs/guides/search-form.md +1 -1
- package/docs/reference/action-form.md +2 -2
- package/docs/reference/field-counter.md +2 -2
- package/docs/reference/field-grid.md +1 -1
- package/docs/reference/field-note.md +2 -2
- package/docs/reference/field.md +2 -2
- package/docs/reference/fieldset.md +2 -2
- package/docs/reference/list-field-control.md +1 -1
- package/docs/reference/search-form.md +2 -2
- package/package.json +6 -6
package/README.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# @gridui/form
|
|
2
2
|
|
|
3
|
-
|
|
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-
|
|
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.
|
|
5
|
-
"category": "
|
|
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-
|
|
153
|
-
"https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-
|
|
154
|
-
"https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-
|
|
155
|
-
"https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-
|
|
156
|
-
"https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-
|
|
157
|
-
"https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-
|
|
158
|
-
"https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-
|
|
159
|
-
"https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-
|
|
160
|
-
"https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-
|
|
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-
|
|
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
|
package/docs/guides/fields.md
CHANGED
|
@@ -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
|
|
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
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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
|
|
package/docs/reference/field.md
CHANGED
|
@@ -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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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.
|
|
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.
|
|
36
|
-
"@gridui/theme": "^
|
|
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": "
|
|
42
|
-
"@gridui/input": "
|
|
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.
|
|
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"
|