@cdx-ui/utils 0.0.1-beta.15 → 0.0.1-beta.151
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/LICENSE +21 -0
- package/README.md +55 -23
- package/lib/commonjs/common/cva.js +13 -0
- package/lib/commonjs/common/cva.js.map +1 -0
- package/lib/commonjs/common/index.js +7 -0
- package/lib/commonjs/common/index.js.map +1 -1
- package/lib/commonjs/common/mergeRefs.js +39 -1
- package/lib/commonjs/common/mergeRefs.js.map +1 -1
- package/lib/commonjs/context/createContext.js +7 -3
- package/lib/commonjs/context/createContext.js.map +1 -1
- package/lib/commonjs/form-control/index.js +6 -0
- package/lib/commonjs/form-control/index.js.map +1 -1
- package/lib/commonjs/form-control/useFormControl.js +33 -0
- package/lib/commonjs/form-control/useFormControl.js.map +1 -1
- package/lib/commonjs/style/index.js +0 -11
- package/lib/commonjs/style/index.js.map +1 -1
- package/lib/module/common/cva.js +4 -0
- package/lib/module/common/cva.js.map +1 -0
- package/lib/module/common/index.js +1 -0
- package/lib/module/common/index.js.map +1 -1
- package/lib/module/common/mergeRefs.js +39 -1
- package/lib/module/common/mergeRefs.js.map +1 -1
- package/lib/module/context/createContext.js +7 -3
- package/lib/module/context/createContext.js.map +1 -1
- package/lib/module/form-control/index.js +1 -1
- package/lib/module/form-control/index.js.map +1 -1
- package/lib/module/form-control/useFormControl.js +33 -0
- package/lib/module/form-control/useFormControl.js.map +1 -1
- package/lib/module/style/index.js +0 -1
- package/lib/module/style/index.js.map +1 -1
- package/lib/typescript/common/cva.d.ts +2 -0
- package/lib/typescript/common/cva.d.ts.map +1 -0
- package/lib/typescript/common/index.d.ts +1 -0
- package/lib/typescript/common/index.d.ts.map +1 -1
- package/lib/typescript/common/mergeRefs.d.ts +8 -0
- package/lib/typescript/common/mergeRefs.d.ts.map +1 -1
- package/lib/typescript/context/createContext.d.ts +16 -1
- package/lib/typescript/context/createContext.d.ts.map +1 -1
- package/lib/typescript/form-control/index.d.ts +1 -1
- package/lib/typescript/form-control/index.d.ts.map +1 -1
- package/lib/typescript/form-control/useFormControl.d.ts +28 -3
- package/lib/typescript/form-control/useFormControl.d.ts.map +1 -1
- package/lib/typescript/style/index.d.ts +0 -1
- package/lib/typescript/style/index.d.ts.map +1 -1
- package/package.json +14 -5
- package/src/common/accessibilityUtils.test.ts +12 -0
- package/src/common/cn.test.ts +19 -0
- package/src/common/composeEventHandlers.test.ts +35 -0
- package/src/common/cva.ts +1 -0
- package/src/common/getSpacedChild.test.tsx +64 -0
- package/src/common/index.ts +1 -0
- package/src/common/mergeRefs.test.ts +148 -0
- package/src/common/mergeRefs.ts +45 -2
- package/src/common/useControllableState.test.tsx +90 -0
- package/src/context/createContext.test.tsx +31 -0
- package/src/context/createContext.tsx +21 -4
- package/src/form-control/index.ts +2 -0
- package/src/form-control/useFormControl.test.tsx +214 -0
- package/src/form-control/useFormControl.tsx +48 -4
- package/src/style/context/index.test.tsx +31 -0
- package/src/style/index.tsx +0 -1
- package/lib/commonjs/style/withStyleContext/index.js +0 -33
- package/lib/commonjs/style/withStyleContext/index.js.map +0 -1
- package/lib/module/style/withStyleContext/index.js +0 -28
- package/lib/module/style/withStyleContext/index.js.map +0 -1
- package/lib/typescript/style/withStyleContext/index.d.ts +0 -6
- package/lib/typescript/style/withStyleContext/index.d.ts.map +0 -1
- package/src/style/withStyleContext/index.tsx +0 -36
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright © 2026 Digital First Holdings LLC
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
# @cdx-ui/utils
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+

|
|
4
|
+
|
|
5
|
+
Shared utilities used across FDS packages.
|
|
4
6
|
|
|
5
7
|
Provides common helpers for styling, event handling, state management, and context propagation used by [`@cdx-ui/primitives`](../primitives/) and [`@cdx-ui/components`](../components/).
|
|
6
8
|
|
|
@@ -14,44 +16,74 @@ pnpm add @cdx-ui/utils
|
|
|
14
16
|
|
|
15
17
|
### Common helpers
|
|
16
18
|
|
|
17
|
-
| Export
|
|
18
|
-
|
|
|
19
|
-
| `cn(...inputs)`
|
|
20
|
-
| `composeEventHandlers(...handlers)` | Chains multiple event callbacks into a single handler; skips `null`/`undefined` entries.
|
|
21
|
-
| `useControllableState(params)`
|
|
22
|
-
| `mergeRefs(...refs)`
|
|
23
|
-
| `flattenChildren(children)`
|
|
24
|
-
| `ariaAttr(condition)`
|
|
19
|
+
| Export | Description |
|
|
20
|
+
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
21
|
+
| `cn(...inputs)` | Merges class names with `clsx` + `tailwind-merge` — conditionals and conflict resolution in one call. |
|
|
22
|
+
| `composeEventHandlers(...handlers)` | Chains multiple event callbacks into a single handler; skips `null`/`undefined` entries. |
|
|
23
|
+
| `useControllableState(params)` | Hook that supports both controlled and uncontrolled modes for a single value. Derives `isControlled` from whether the prop is `undefined`. |
|
|
24
|
+
| `mergeRefs(...refs)` | Combines multiple refs (callback or object) into one ref callback. |
|
|
25
|
+
| `flattenChildren(children)` | Recursively flattens React `children` (including Fragments) into a flat array with re-keyed elements. |
|
|
26
|
+
| `ariaAttr(condition)` | Returns `true` (boolean) or `undefined` — shorthand for boolean ARIA attribute values. |
|
|
25
27
|
|
|
26
28
|
### Context
|
|
27
29
|
|
|
28
|
-
| Export
|
|
29
|
-
|
|
|
30
|
+
| Export | Description |
|
|
31
|
+
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
30
32
|
| `createContext(displayName)` | Wrapper around React's `createContext` that returns a `[Provider, useHook]` tuple. The hook throws a descriptive error if called outside the provider — eliminates silent `undefined` bugs. |
|
|
31
33
|
|
|
32
34
|
### Style context
|
|
33
35
|
|
|
34
36
|
Used internally by `@cdx-ui/components` to propagate variant props (size, color, etc.) from a compound root to its sub-components.
|
|
35
37
|
|
|
36
|
-
| Export
|
|
37
|
-
|
|
|
38
|
-
| `
|
|
39
|
-
| `useStyleContext(scope?)` | Reads the style context set by the nearest `
|
|
40
|
-
| `useParentContext()`
|
|
41
|
-
| `ParentContext` | The raw React context (rarely needed directly). |
|
|
38
|
+
| Export | Description |
|
|
39
|
+
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
40
|
+
| `ParentContext` | React context for propagating variant props from a compound root to sub-components. Wrap children in `<ParentContext.Provider value={...}>`. |
|
|
41
|
+
| `useStyleContext(scope?)` | Reads the style context set by the nearest `ParentContext.Provider`. |
|
|
42
|
+
| `useParentContext()` | Reads the full `StyleContextMap` from the nearest provider. |
|
|
42
43
|
|
|
43
44
|
### Form control
|
|
44
45
|
|
|
45
46
|
Low-level form-field state used by the `Field` and `Input` primitives.
|
|
46
47
|
|
|
47
|
-
| Export
|
|
48
|
-
|
|
|
49
|
-
| `useFormControlRoot(props)`
|
|
50
|
-
| `useFormControl(props)`
|
|
51
|
-
| `useFormControlContext()`
|
|
52
|
-
| `
|
|
48
|
+
| Export | Description |
|
|
49
|
+
| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
50
|
+
| `useFormControlRoot(props)` | Creates the root state object for a form field (id generation, tracks `hasFeedbackText`/`hasHelpText` for describedby assembly). |
|
|
51
|
+
| `useFormControl(props)` | Merges component-level props with inherited form-control context. Assembles `aria-describedby` from feedback/help text ids. |
|
|
52
|
+
| `useFormControlContext()` | Reads form-control state from the nearest provider. |
|
|
53
|
+
| `useReportFormControlLabelFocus(isActive)` | Reports focus/active state to the parent `FormControlContext` — used by `Input`/`Select.Trigger` to trigger `isFocused` styling on the associated label. |
|
|
54
|
+
| `FormControlContext` | The React context object for form-control state propagation. |
|
|
55
|
+
|
|
56
|
+
## Exported types
|
|
57
|
+
|
|
58
|
+
| Type | Source |
|
|
59
|
+
| ---------------------------- | ------------ |
|
|
60
|
+
| `UseControllableStateParams` | common |
|
|
61
|
+
| `Focusable` | form-control |
|
|
62
|
+
| `FormControlContextValue` | form-control |
|
|
63
|
+
| `FormControlFieldProps` | form-control |
|
|
64
|
+
| `FormControlRootProps` | form-control |
|
|
65
|
+
| `FormControlRootReturn` | form-control |
|
|
66
|
+
| `FormControlState` | form-control |
|
|
67
|
+
| `StyleContextMap` | style |
|
|
68
|
+
| `WithStyleContextProps` | style |
|
|
69
|
+
|
|
70
|
+
## Testing
|
|
71
|
+
|
|
72
|
+
Tests are colocated next to source files (`*.test.{ts,tsx}`). Run via the `utils` Jest project:
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
pnpm nx run @cdx-ui/utils:test
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
All runtime exports have test coverage using `@testing-library/react-native` (`renderHook`, `act`).
|
|
53
79
|
|
|
54
80
|
## Further reading
|
|
55
81
|
|
|
56
82
|
- [State management practices](../../docs/internal/practices/state.md) — `useControllableState` and `composeEventHandlers` patterns
|
|
57
83
|
- [Styling practices](../../docs/internal/practices/styling.md) — `cn()` and CVA variant authoring
|
|
84
|
+
|
|
85
|
+
## License
|
|
86
|
+
|
|
87
|
+
[](./LICENSE)
|
|
88
|
+
|
|
89
|
+
MIT © 2026 Digital First Holdings LLC. See [LICENSE](./LICENSE) for details.
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
|
|
3
|
+
Object.defineProperty(exports, "__esModule", {
|
|
4
|
+
value: true
|
|
5
|
+
});
|
|
6
|
+
Object.defineProperty(exports, "cva", {
|
|
7
|
+
enumerable: true,
|
|
8
|
+
get: function () {
|
|
9
|
+
return _classVarianceAuthority.cva;
|
|
10
|
+
}
|
|
11
|
+
});
|
|
12
|
+
var _classVarianceAuthority = require("class-variance-authority");
|
|
13
|
+
//# sourceMappingURL=cva.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"names":["_classVarianceAuthority","require"],"sourceRoot":"../../../src","sources":["common/cva.ts"],"mappings":";;;;;;;;;;;AAAA,IAAAA,uBAAA,GAAAC,OAAA","ignoreList":[]}
|
|
@@ -21,6 +21,12 @@ Object.defineProperty(exports, "composeEventHandlers", {
|
|
|
21
21
|
return _composeEventHandlers.composeEventHandlers;
|
|
22
22
|
}
|
|
23
23
|
});
|
|
24
|
+
Object.defineProperty(exports, "cva", {
|
|
25
|
+
enumerable: true,
|
|
26
|
+
get: function () {
|
|
27
|
+
return _cva.cva;
|
|
28
|
+
}
|
|
29
|
+
});
|
|
24
30
|
Object.defineProperty(exports, "flattenChildren", {
|
|
25
31
|
enumerable: true,
|
|
26
32
|
get: function () {
|
|
@@ -41,6 +47,7 @@ Object.defineProperty(exports, "useControllableState", {
|
|
|
41
47
|
});
|
|
42
48
|
var _accessibilityUtils = require("./accessibilityUtils");
|
|
43
49
|
var _cn = require("./cn");
|
|
50
|
+
var _cva = require("./cva");
|
|
44
51
|
var _composeEventHandlers = require("./composeEventHandlers");
|
|
45
52
|
var _getSpacedChild = require("./getSpacedChild");
|
|
46
53
|
var _mergeRefs = require("./mergeRefs");
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"names":["_accessibilityUtils","require","_cn","_composeEventHandlers","_getSpacedChild","_mergeRefs","_useControllableState"],"sourceRoot":"../../../src","sources":["common/index.ts"],"mappings":"
|
|
1
|
+
{"version":3,"names":["_accessibilityUtils","require","_cn","_cva","_composeEventHandlers","_getSpacedChild","_mergeRefs","_useControllableState"],"sourceRoot":"../../../src","sources":["common/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,mBAAA,GAAAC,OAAA;AACA,IAAAC,GAAA,GAAAD,OAAA;AACA,IAAAE,IAAA,GAAAF,OAAA;AACA,IAAAG,qBAAA,GAAAH,OAAA;AACA,IAAAI,eAAA,GAAAJ,OAAA;AACA,IAAAK,UAAA,GAAAL,OAAA;AACA,IAAAM,qBAAA,GAAAN,OAAA","ignoreList":[]}
|
|
@@ -4,15 +4,53 @@ Object.defineProperty(exports, "__esModule", {
|
|
|
4
4
|
value: true
|
|
5
5
|
});
|
|
6
6
|
exports.mergeRefs = mergeRefs;
|
|
7
|
+
/**
|
|
8
|
+
* Merges multiple refs (object or callback) into a single callback ref.
|
|
9
|
+
*
|
|
10
|
+
* Supports React 19 ref-cleanup semantics: if an inner callback ref returns a
|
|
11
|
+
* cleanup function, that cleanup is captured and invoked when the merged ref is
|
|
12
|
+
* detached — either via the returned cleanup (React 19) or via a subsequent
|
|
13
|
+
* call with `null` (React 18 backward-compat path).
|
|
14
|
+
*/
|
|
7
15
|
function mergeRefs(...refs) {
|
|
8
16
|
return value => {
|
|
17
|
+
if (value === null) {
|
|
18
|
+
for (const ref of refs) {
|
|
19
|
+
if (typeof ref === 'function') {
|
|
20
|
+
ref(null);
|
|
21
|
+
} else if (ref != null) {
|
|
22
|
+
ref.current = null;
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
return undefined;
|
|
26
|
+
}
|
|
27
|
+
const cleanups = [];
|
|
9
28
|
for (const ref of refs) {
|
|
10
29
|
if (typeof ref === 'function') {
|
|
11
|
-
ref(value);
|
|
30
|
+
cleanups.push(ref(value));
|
|
12
31
|
} else if (ref != null) {
|
|
13
32
|
ref.current = value;
|
|
33
|
+
cleanups.push(undefined);
|
|
34
|
+
} else {
|
|
35
|
+
cleanups.push(undefined);
|
|
14
36
|
}
|
|
15
37
|
}
|
|
38
|
+
return () => {
|
|
39
|
+
for (let i = 0; i < refs.length; i++) {
|
|
40
|
+
const ref = refs[i];
|
|
41
|
+
if (ref == null) continue;
|
|
42
|
+
if (typeof ref === 'function') {
|
|
43
|
+
const refCleanup = cleanups[i];
|
|
44
|
+
if (typeof refCleanup === 'function') {
|
|
45
|
+
refCleanup();
|
|
46
|
+
} else {
|
|
47
|
+
ref(null);
|
|
48
|
+
}
|
|
49
|
+
} else {
|
|
50
|
+
ref.current = null;
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
};
|
|
16
54
|
};
|
|
17
55
|
}
|
|
18
56
|
//# sourceMappingURL=mergeRefs.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"names":["mergeRefs","refs","value","ref","current"],"sourceRoot":"../../../src","sources":["common/mergeRefs.ts"],"mappings":";;;;;;
|
|
1
|
+
{"version":3,"names":["mergeRefs","refs","value","ref","current","undefined","cleanups","push","i","length","refCleanup"],"sourceRoot":"../../../src","sources":["common/mergeRefs.ts"],"mappings":";;;;;;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,SAASA,CAAI,GAAGC,IAA4B,EAAkB;EAC5E,OAAQC,KAAe,IAA4B;IACjD,IAAIA,KAAK,KAAK,IAAI,EAAE;MAClB,KAAK,MAAMC,GAAG,IAAIF,IAAI,EAAE;QACtB,IAAI,OAAOE,GAAG,KAAK,UAAU,EAAE;UAC7BA,GAAG,CAAC,IAAI,CAAC;QACX,CAAC,MAAM,IAAIA,GAAG,IAAI,IAAI,EAAE;UACtBA,GAAG,CAACC,OAAO,GAAG,IAAI;QACpB;MACF;MACA,OAAOC,SAAS;IAClB;IAEA,MAAMC,QAAmC,GAAG,EAAE;IAC9C,KAAK,MAAMH,GAAG,IAAIF,IAAI,EAAE;MACtB,IAAI,OAAOE,GAAG,KAAK,UAAU,EAAE;QAC7BG,QAAQ,CAACC,IAAI,CAACJ,GAAG,CAACD,KAAK,CAA0B,CAAC;MACpD,CAAC,MAAM,IAAIC,GAAG,IAAI,IAAI,EAAE;QACtBA,GAAG,CAACC,OAAO,GAAGF,KAAK;QACnBI,QAAQ,CAACC,IAAI,CAACF,SAAS,CAAC;MAC1B,CAAC,MAAM;QACLC,QAAQ,CAACC,IAAI,CAACF,SAAS,CAAC;MAC1B;IACF;IAEA,OAAO,MAAM;MACX,KAAK,IAAIG,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGP,IAAI,CAACQ,MAAM,EAAED,CAAC,EAAE,EAAE;QACpC,MAAML,GAAG,GAAGF,IAAI,CAACO,CAAC,CAAC;QACnB,IAAIL,GAAG,IAAI,IAAI,EAAE;QAEjB,IAAI,OAAOA,GAAG,KAAK,UAAU,EAAE;UAC7B,MAAMO,UAAU,GAAGJ,QAAQ,CAACE,CAAC,CAAC;UAC9B,IAAI,OAAOE,UAAU,KAAK,UAAU,EAAE;YACpCA,UAAU,CAAC,CAAC;UACd,CAAC,MAAM;YACLP,GAAG,CAAC,IAAI,CAAC;UACX;QACF,CAAC,MAAM;UACLA,GAAG,CAACC,OAAO,GAAG,IAAI;QACpB;MACF;IACF,CAAC;EACH,CAAC;AACH","ignoreList":[]}
|
|
@@ -6,8 +6,12 @@ Object.defineProperty(exports, "__esModule", {
|
|
|
6
6
|
exports.createContext = createContext;
|
|
7
7
|
var _react = require("react");
|
|
8
8
|
var _jsxRuntime = require("react/jsx-runtime");
|
|
9
|
-
function createContext(displayName) {
|
|
10
|
-
const
|
|
9
|
+
function createContext(displayName, options) {
|
|
10
|
+
const {
|
|
11
|
+
defaultValue,
|
|
12
|
+
strict = true
|
|
13
|
+
} = options ?? {};
|
|
14
|
+
const Context = /*#__PURE__*/(0, _react.createContext)(defaultValue);
|
|
11
15
|
const Provider = props => {
|
|
12
16
|
const {
|
|
13
17
|
children,
|
|
@@ -21,7 +25,7 @@ function createContext(displayName) {
|
|
|
21
25
|
Provider.displayName = `${displayName}Provider`;
|
|
22
26
|
function useC() {
|
|
23
27
|
const context = (0, _react.useContext)(Context);
|
|
24
|
-
if (context === undefined) {
|
|
28
|
+
if (context === undefined && strict) {
|
|
25
29
|
throw new Error(`use${displayName} must be used within a ${displayName}Provider`);
|
|
26
30
|
}
|
|
27
31
|
return context;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"names":["_react","require","_jsxRuntime","createContext","displayName","
|
|
1
|
+
{"version":3,"names":["_react","require","_jsxRuntime","createContext","displayName","options","defaultValue","strict","Context","createReactContext","Provider","props","children","value","jsx","useC","context","useContext","undefined","Error"],"sourceRoot":"../../../src","sources":["context/createContext.tsx"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAKe,IAAAC,WAAA,GAAAD,OAAA;AAiBR,SAASE,aAAaA,CAAIC,WAAmB,EAAEC,OAAiC,EAAE;EACvF,MAAM;IAAEC,YAAY;IAAEC,MAAM,GAAG;EAAK,CAAC,GAAGF,OAAO,IAAI,CAAC,CAAC;EAErD,MAAMG,OAAO,gBAAG,IAAAC,oBAAkB,EAAgBH,YAAY,CAAC;EAE/D,MAAMI,QAA0D,GAAIC,KAAK,IAAK;IAC5E,MAAM;MAAEC,QAAQ;MAAEC;IAAM,CAAC,GAAGF,KAAK;IACjC,oBAAO,IAAAT,WAAA,CAAAY,GAAA,EAACN,OAAO,CAACE,QAAQ;MAACG,KAAK,EAAEA,KAAM;MAAAD,QAAA,EAAEA;IAAQ,CAAmB,CAAC;EACtE,CAAC;EAEDF,QAAQ,CAACN,WAAW,GAAG,GAAGA,WAAW,UAAU;EAE/C,SAASW,IAAIA,CAAA,EAAM;IACjB,MAAMC,OAAO,GAAG,IAAAC,iBAAU,EAACT,OAAO,CAAC;IACnC,IAAIQ,OAAO,KAAKE,SAAS,IAAIX,MAAM,EAAE;MACnC,MAAM,IAAIY,KAAK,CAAC,MAAMf,WAAW,0BAA0BA,WAAW,UAAU,CAAC;IACnF;IACA,OAAOY,OAAO;EAChB;EAEA,OAAO,CAACN,QAAQ,EAAEK,IAAI,CAAC;AACzB","ignoreList":[]}
|
|
@@ -27,5 +27,11 @@ Object.defineProperty(exports, "useFormControlRoot", {
|
|
|
27
27
|
return _useFormControl.useFormControlRoot;
|
|
28
28
|
}
|
|
29
29
|
});
|
|
30
|
+
Object.defineProperty(exports, "useReportFormControlLabelFocus", {
|
|
31
|
+
enumerable: true,
|
|
32
|
+
get: function () {
|
|
33
|
+
return _useFormControl.useReportFormControlLabelFocus;
|
|
34
|
+
}
|
|
35
|
+
});
|
|
30
36
|
var _useFormControl = require("./useFormControl");
|
|
31
37
|
//# sourceMappingURL=index.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"names":["_useFormControl","require"],"sourceRoot":"../../../src","sources":["form-control/index.ts"],"mappings":"
|
|
1
|
+
{"version":3,"names":["_useFormControl","require"],"sourceRoot":"../../../src","sources":["form-control/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,eAAA,GAAAC,OAAA","ignoreList":[]}
|
|
@@ -7,10 +7,21 @@ exports.FormControlContext = void 0;
|
|
|
7
7
|
exports.useFormControl = useFormControl;
|
|
8
8
|
exports.useFormControlContext = void 0;
|
|
9
9
|
exports.useFormControlRoot = useFormControlRoot;
|
|
10
|
+
exports.useReportFormControlLabelFocus = useReportFormControlLabelFocus;
|
|
10
11
|
var _react = _interopRequireDefault(require("react"));
|
|
11
12
|
var _reactNative = require("react-native");
|
|
12
13
|
var _accessibilityUtils = require("../common/accessibilityUtils");
|
|
13
14
|
function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
|
|
15
|
+
/**
|
|
16
|
+
* Minimal contract for any control registered on `FormControlContextValue.inputRef`.
|
|
17
|
+
*
|
|
18
|
+
* `Field.Label` / `focusInput()` only need to call `.focus()` on the registered node;
|
|
19
|
+
* narrower control-specific shapes (`TextInput`, `HTMLInputElement`, custom focus
|
|
20
|
+
* bridges like `Select.Trigger`'s) all satisfy this contract. Consumers that need
|
|
21
|
+
* more (e.g. reading `.value`) should cast locally — keeping the context type
|
|
22
|
+
* minimal avoids a typed lie when a non-input bridge is registered.
|
|
23
|
+
*/
|
|
24
|
+
|
|
14
25
|
const FormControlContext = exports.FormControlContext = /*#__PURE__*/_react.default.createContext({});
|
|
15
26
|
|
|
16
27
|
/** Props for the FormControl root; known fields plus passthrough to the styled root box. */
|
|
@@ -46,6 +57,7 @@ function useFormControlRoot(props) {
|
|
|
46
57
|
* We use this to append its id the the `aria-describedby` of the `input`.
|
|
47
58
|
*/
|
|
48
59
|
const [hasHelpText, setHasHelpText] = _react.default.useState(false);
|
|
60
|
+
const [isLabelFocused, setIsLabelFocused] = _react.default.useState(false);
|
|
49
61
|
const inputRef = _react.default.useRef(null);
|
|
50
62
|
const focusInput = _react.default.useCallback(() => {
|
|
51
63
|
const node = inputRef.current;
|
|
@@ -68,6 +80,8 @@ function useFormControlRoot(props) {
|
|
|
68
80
|
feedbackId,
|
|
69
81
|
helpTextId,
|
|
70
82
|
htmlProps,
|
|
83
|
+
isLabelFocused,
|
|
84
|
+
setIsLabelFocused,
|
|
71
85
|
...(_reactNative.Platform.OS !== 'web' ? {
|
|
72
86
|
inputRef,
|
|
73
87
|
focusInput
|
|
@@ -76,6 +90,25 @@ function useFormControlRoot(props) {
|
|
|
76
90
|
return context;
|
|
77
91
|
}
|
|
78
92
|
|
|
93
|
+
/**
|
|
94
|
+
* Reports focus/active state from `Input` / `Select.Trigger` to the parent `Field` for label styling.
|
|
95
|
+
* No-ops outside a `Field` (no `setIsLabelFocused` on context).
|
|
96
|
+
*/
|
|
97
|
+
function useReportFormControlLabelFocus(isActive) {
|
|
98
|
+
const {
|
|
99
|
+
setIsLabelFocused
|
|
100
|
+
} = useFormControlContext();
|
|
101
|
+
_react.default.useLayoutEffect(() => {
|
|
102
|
+
if (typeof setIsLabelFocused !== 'function') {
|
|
103
|
+
return undefined;
|
|
104
|
+
}
|
|
105
|
+
setIsLabelFocused(isActive);
|
|
106
|
+
return () => {
|
|
107
|
+
setIsLabelFocused(false);
|
|
108
|
+
};
|
|
109
|
+
}, [isActive, setIsLabelFocused]);
|
|
110
|
+
}
|
|
111
|
+
|
|
79
112
|
/**
|
|
80
113
|
* Hook that merges local field props with the nearest form field context
|
|
81
114
|
* and returns normalised HTML / ARIA attributes for input elements.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"names":["_react","_interopRequireDefault","require","_reactNative","_accessibilityUtils","e","__esModule","default","FormControlContext","exports","React","createContext","useFormControlRoot","props","id","idProp","name","isRequired","isInvalid","isDisabled","isReadOnly","htmlProps","reactId","useId","labelId","feedbackId","helpTextId","hasFeedbackText","setHasFeedbackText","useState","hasHelpText","setHasHelpText","inputRef","useRef","focusInput","useCallback","node","current","focus","context","Boolean","Platform","OS","
|
|
1
|
+
{"version":3,"names":["_react","_interopRequireDefault","require","_reactNative","_accessibilityUtils","e","__esModule","default","FormControlContext","exports","React","createContext","useFormControlRoot","props","id","idProp","name","isRequired","isInvalid","isDisabled","isReadOnly","htmlProps","reactId","useId","labelId","feedbackId","helpTextId","hasFeedbackText","setHasFeedbackText","useState","hasHelpText","setHasHelpText","isLabelFocused","setIsLabelFocused","inputRef","useRef","focusInput","useCallback","node","current","focus","context","Boolean","Platform","OS","useReportFormControlLabelFocus","isActive","useFormControlContext","useLayoutEffect","undefined","useFormControl","field","describedBy","push","ariaDescribedBy","join","cleanProps","disabled","readOnly","required","ariaAttr","useContext"],"sourceRoot":"../../../src","sources":["form-control/useFormControl.tsx"],"mappings":"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","ignoreList":[]}
|
|
@@ -14,15 +14,4 @@ Object.keys(_context).forEach(function (key) {
|
|
|
14
14
|
}
|
|
15
15
|
});
|
|
16
16
|
});
|
|
17
|
-
var _withStyleContext = require("./withStyleContext");
|
|
18
|
-
Object.keys(_withStyleContext).forEach(function (key) {
|
|
19
|
-
if (key === "default" || key === "__esModule") return;
|
|
20
|
-
if (key in exports && exports[key] === _withStyleContext[key]) return;
|
|
21
|
-
Object.defineProperty(exports, key, {
|
|
22
|
-
enumerable: true,
|
|
23
|
-
get: function () {
|
|
24
|
-
return _withStyleContext[key];
|
|
25
|
-
}
|
|
26
|
-
});
|
|
27
|
-
});
|
|
28
17
|
//# sourceMappingURL=index.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"names":["_context","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get"
|
|
1
|
+
{"version":3,"names":["_context","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get"],"sourceRoot":"../../../src","sources":["style/index.tsx"],"mappings":";;;;;AAAA,IAAAA,QAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,QAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,QAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,QAAA,CAAAK,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"names":["cva"],"sourceRoot":"../../../src","sources":["common/cva.ts"],"mappings":";;AAAA,SAASA,GAAG,QAA2B,0BAA0B","ignoreList":[]}
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
export { ariaAttr } from './accessibilityUtils';
|
|
4
4
|
export { cn } from './cn';
|
|
5
|
+
export { cva } from './cva';
|
|
5
6
|
export { composeEventHandlers } from './composeEventHandlers';
|
|
6
7
|
export { flattenChildren } from './getSpacedChild';
|
|
7
8
|
export { mergeRefs } from './mergeRefs';
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"names":["ariaAttr","cn","composeEventHandlers","flattenChildren","mergeRefs","useControllableState"],"sourceRoot":"../../../src","sources":["common/index.ts"],"mappings":";;AAAA,SAASA,QAAQ,QAAQ,sBAAsB;AAC/C,SAASC,EAAE,QAAQ,MAAM;AACzB,SAASC,oBAAoB,QAAQ,wBAAwB;AAC7D,SAASC,eAAe,QAAQ,kBAAkB;AAClD,SAASC,SAAS,QAAQ,aAAa;AACvC,SAA0CC,oBAAoB,QAAQ,wBAAwB","ignoreList":[]}
|
|
1
|
+
{"version":3,"names":["ariaAttr","cn","cva","composeEventHandlers","flattenChildren","mergeRefs","useControllableState"],"sourceRoot":"../../../src","sources":["common/index.ts"],"mappings":";;AAAA,SAASA,QAAQ,QAAQ,sBAAsB;AAC/C,SAASC,EAAE,QAAQ,MAAM;AACzB,SAASC,GAAG,QAA2B,OAAO;AAC9C,SAASC,oBAAoB,QAAQ,wBAAwB;AAC7D,SAASC,eAAe,QAAQ,kBAAkB;AAClD,SAASC,SAAS,QAAQ,aAAa;AACvC,SAA0CC,oBAAoB,QAAQ,wBAAwB","ignoreList":[]}
|
|
@@ -1,14 +1,52 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
|
|
3
|
+
/**
|
|
4
|
+
* Merges multiple refs (object or callback) into a single callback ref.
|
|
5
|
+
*
|
|
6
|
+
* Supports React 19 ref-cleanup semantics: if an inner callback ref returns a
|
|
7
|
+
* cleanup function, that cleanup is captured and invoked when the merged ref is
|
|
8
|
+
* detached — either via the returned cleanup (React 19) or via a subsequent
|
|
9
|
+
* call with `null` (React 18 backward-compat path).
|
|
10
|
+
*/
|
|
3
11
|
export function mergeRefs(...refs) {
|
|
4
12
|
return value => {
|
|
13
|
+
if (value === null) {
|
|
14
|
+
for (const ref of refs) {
|
|
15
|
+
if (typeof ref === 'function') {
|
|
16
|
+
ref(null);
|
|
17
|
+
} else if (ref != null) {
|
|
18
|
+
ref.current = null;
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
return undefined;
|
|
22
|
+
}
|
|
23
|
+
const cleanups = [];
|
|
5
24
|
for (const ref of refs) {
|
|
6
25
|
if (typeof ref === 'function') {
|
|
7
|
-
ref(value);
|
|
26
|
+
cleanups.push(ref(value));
|
|
8
27
|
} else if (ref != null) {
|
|
9
28
|
ref.current = value;
|
|
29
|
+
cleanups.push(undefined);
|
|
30
|
+
} else {
|
|
31
|
+
cleanups.push(undefined);
|
|
10
32
|
}
|
|
11
33
|
}
|
|
34
|
+
return () => {
|
|
35
|
+
for (let i = 0; i < refs.length; i++) {
|
|
36
|
+
const ref = refs[i];
|
|
37
|
+
if (ref == null) continue;
|
|
38
|
+
if (typeof ref === 'function') {
|
|
39
|
+
const refCleanup = cleanups[i];
|
|
40
|
+
if (typeof refCleanup === 'function') {
|
|
41
|
+
refCleanup();
|
|
42
|
+
} else {
|
|
43
|
+
ref(null);
|
|
44
|
+
}
|
|
45
|
+
} else {
|
|
46
|
+
ref.current = null;
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
};
|
|
12
50
|
};
|
|
13
51
|
}
|
|
14
52
|
//# sourceMappingURL=mergeRefs.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"names":["mergeRefs","refs","value","ref","current"],"sourceRoot":"../../../src","sources":["common/mergeRefs.ts"],"mappings":";;
|
|
1
|
+
{"version":3,"names":["mergeRefs","refs","value","ref","current","undefined","cleanups","push","i","length","refCleanup"],"sourceRoot":"../../../src","sources":["common/mergeRefs.ts"],"mappings":";;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,SAASA,CAAI,GAAGC,IAA4B,EAAkB;EAC5E,OAAQC,KAAe,IAA4B;IACjD,IAAIA,KAAK,KAAK,IAAI,EAAE;MAClB,KAAK,MAAMC,GAAG,IAAIF,IAAI,EAAE;QACtB,IAAI,OAAOE,GAAG,KAAK,UAAU,EAAE;UAC7BA,GAAG,CAAC,IAAI,CAAC;QACX,CAAC,MAAM,IAAIA,GAAG,IAAI,IAAI,EAAE;UACtBA,GAAG,CAACC,OAAO,GAAG,IAAI;QACpB;MACF;MACA,OAAOC,SAAS;IAClB;IAEA,MAAMC,QAAmC,GAAG,EAAE;IAC9C,KAAK,MAAMH,GAAG,IAAIF,IAAI,EAAE;MACtB,IAAI,OAAOE,GAAG,KAAK,UAAU,EAAE;QAC7BG,QAAQ,CAACC,IAAI,CAACJ,GAAG,CAACD,KAAK,CAA0B,CAAC;MACpD,CAAC,MAAM,IAAIC,GAAG,IAAI,IAAI,EAAE;QACtBA,GAAG,CAACC,OAAO,GAAGF,KAAK;QACnBI,QAAQ,CAACC,IAAI,CAACF,SAAS,CAAC;MAC1B,CAAC,MAAM;QACLC,QAAQ,CAACC,IAAI,CAACF,SAAS,CAAC;MAC1B;IACF;IAEA,OAAO,MAAM;MACX,KAAK,IAAIG,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGP,IAAI,CAACQ,MAAM,EAAED,CAAC,EAAE,EAAE;QACpC,MAAML,GAAG,GAAGF,IAAI,CAACO,CAAC,CAAC;QACnB,IAAIL,GAAG,IAAI,IAAI,EAAE;QAEjB,IAAI,OAAOA,GAAG,KAAK,UAAU,EAAE;UAC7B,MAAMO,UAAU,GAAGJ,QAAQ,CAACE,CAAC,CAAC;UAC9B,IAAI,OAAOE,UAAU,KAAK,UAAU,EAAE;YACpCA,UAAU,CAAC,CAAC;UACd,CAAC,MAAM;YACLP,GAAG,CAAC,IAAI,CAAC;UACX;QACF,CAAC,MAAM;UACLA,GAAG,CAACC,OAAO,GAAG,IAAI;QACpB;MACF;IACF,CAAC;EACH,CAAC;AACH","ignoreList":[]}
|
|
@@ -2,8 +2,12 @@
|
|
|
2
2
|
|
|
3
3
|
import { createContext as createReactContext, useContext } from 'react';
|
|
4
4
|
import { jsx as _jsx } from "react/jsx-runtime";
|
|
5
|
-
export function createContext(displayName) {
|
|
6
|
-
const
|
|
5
|
+
export function createContext(displayName, options) {
|
|
6
|
+
const {
|
|
7
|
+
defaultValue,
|
|
8
|
+
strict = true
|
|
9
|
+
} = options ?? {};
|
|
10
|
+
const Context = /*#__PURE__*/createReactContext(defaultValue);
|
|
7
11
|
const Provider = props => {
|
|
8
12
|
const {
|
|
9
13
|
children,
|
|
@@ -17,7 +21,7 @@ export function createContext(displayName) {
|
|
|
17
21
|
Provider.displayName = `${displayName}Provider`;
|
|
18
22
|
function useC() {
|
|
19
23
|
const context = useContext(Context);
|
|
20
|
-
if (context === undefined) {
|
|
24
|
+
if (context === undefined && strict) {
|
|
21
25
|
throw new Error(`use${displayName} must be used within a ${displayName}Provider`);
|
|
22
26
|
}
|
|
23
27
|
return context;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"names":["createContext","createReactContext","useContext","jsx","_jsx","displayName","
|
|
1
|
+
{"version":3,"names":["createContext","createReactContext","useContext","jsx","_jsx","displayName","options","defaultValue","strict","Context","Provider","props","children","value","useC","context","undefined","Error"],"sourceRoot":"../../../src","sources":["context/createContext.tsx"],"mappings":";;AAAA,SAEEA,aAAa,IAAIC,kBAAkB,EAEnCC,UAAU,QACL,OAAO;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAiBf,OAAO,SAASJ,aAAaA,CAAIK,WAAmB,EAAEC,OAAiC,EAAE;EACvF,MAAM;IAAEC,YAAY;IAAEC,MAAM,GAAG;EAAK,CAAC,GAAGF,OAAO,IAAI,CAAC,CAAC;EAErD,MAAMG,OAAO,gBAAGR,kBAAkB,CAAgBM,YAAY,CAAC;EAE/D,MAAMG,QAA0D,GAAIC,KAAK,IAAK;IAC5E,MAAM;MAAEC,QAAQ;MAAEC;IAAM,CAAC,GAAGF,KAAK;IACjC,oBAAOP,IAAA,CAACK,OAAO,CAACC,QAAQ;MAACG,KAAK,EAAEA,KAAM;MAAAD,QAAA,EAAEA;IAAQ,CAAmB,CAAC;EACtE,CAAC;EAEDF,QAAQ,CAACL,WAAW,GAAG,GAAGA,WAAW,UAAU;EAE/C,SAASS,IAAIA,CAAA,EAAM;IACjB,MAAMC,OAAO,GAAGb,UAAU,CAACO,OAAO,CAAC;IACnC,IAAIM,OAAO,KAAKC,SAAS,IAAIR,MAAM,EAAE;MACnC,MAAM,IAAIS,KAAK,CAAC,MAAMZ,WAAW,0BAA0BA,WAAW,UAAU,CAAC;IACnF;IACA,OAAOU,OAAO;EAChB;EAEA,OAAO,CAACL,QAAQ,EAAEI,IAAI,CAAC;AACzB","ignoreList":[]}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
|
|
3
|
-
export { FormControlContext, useFormControl, useFormControlContext, useFormControlRoot } from './useFormControl';
|
|
3
|
+
export { FormControlContext, useFormControl, useFormControlContext, useFormControlRoot, useReportFormControlLabelFocus } from './useFormControl';
|
|
4
4
|
//# sourceMappingURL=index.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"names":["FormControlContext","useFormControl","useFormControlContext","useFormControlRoot"],"sourceRoot":"../../../src","sources":["form-control/index.ts"],"mappings":";;AAAA,
|
|
1
|
+
{"version":3,"names":["FormControlContext","useFormControl","useFormControlContext","useFormControlRoot","useReportFormControlLabelFocus"],"sourceRoot":"../../../src","sources":["form-control/index.ts"],"mappings":";;AAAA,SAOEA,kBAAkB,EAClBC,cAAc,EACdC,qBAAqB,EACrBC,kBAAkB,EAClBC,8BAA8B,QACzB,kBAAkB","ignoreList":[]}
|
|
@@ -3,6 +3,17 @@
|
|
|
3
3
|
import React from 'react';
|
|
4
4
|
import { Platform } from 'react-native';
|
|
5
5
|
import { ariaAttr } from '../common/accessibilityUtils';
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* Minimal contract for any control registered on `FormControlContextValue.inputRef`.
|
|
9
|
+
*
|
|
10
|
+
* `Field.Label` / `focusInput()` only need to call `.focus()` on the registered node;
|
|
11
|
+
* narrower control-specific shapes (`TextInput`, `HTMLInputElement`, custom focus
|
|
12
|
+
* bridges like `Select.Trigger`'s) all satisfy this contract. Consumers that need
|
|
13
|
+
* more (e.g. reading `.value`) should cast locally — keeping the context type
|
|
14
|
+
* minimal avoids a typed lie when a non-input bridge is registered.
|
|
15
|
+
*/
|
|
16
|
+
|
|
6
17
|
export const FormControlContext = /*#__PURE__*/React.createContext({});
|
|
7
18
|
|
|
8
19
|
/** Props for the FormControl root; known fields plus passthrough to the styled root box. */
|
|
@@ -38,6 +49,7 @@ export function useFormControlRoot(props) {
|
|
|
38
49
|
* We use this to append its id the the `aria-describedby` of the `input`.
|
|
39
50
|
*/
|
|
40
51
|
const [hasHelpText, setHasHelpText] = React.useState(false);
|
|
52
|
+
const [isLabelFocused, setIsLabelFocused] = React.useState(false);
|
|
41
53
|
const inputRef = React.useRef(null);
|
|
42
54
|
const focusInput = React.useCallback(() => {
|
|
43
55
|
const node = inputRef.current;
|
|
@@ -60,6 +72,8 @@ export function useFormControlRoot(props) {
|
|
|
60
72
|
feedbackId,
|
|
61
73
|
helpTextId,
|
|
62
74
|
htmlProps,
|
|
75
|
+
isLabelFocused,
|
|
76
|
+
setIsLabelFocused,
|
|
63
77
|
...(Platform.OS !== 'web' ? {
|
|
64
78
|
inputRef,
|
|
65
79
|
focusInput
|
|
@@ -68,6 +82,25 @@ export function useFormControlRoot(props) {
|
|
|
68
82
|
return context;
|
|
69
83
|
}
|
|
70
84
|
|
|
85
|
+
/**
|
|
86
|
+
* Reports focus/active state from `Input` / `Select.Trigger` to the parent `Field` for label styling.
|
|
87
|
+
* No-ops outside a `Field` (no `setIsLabelFocused` on context).
|
|
88
|
+
*/
|
|
89
|
+
export function useReportFormControlLabelFocus(isActive) {
|
|
90
|
+
const {
|
|
91
|
+
setIsLabelFocused
|
|
92
|
+
} = useFormControlContext();
|
|
93
|
+
React.useLayoutEffect(() => {
|
|
94
|
+
if (typeof setIsLabelFocused !== 'function') {
|
|
95
|
+
return undefined;
|
|
96
|
+
}
|
|
97
|
+
setIsLabelFocused(isActive);
|
|
98
|
+
return () => {
|
|
99
|
+
setIsLabelFocused(false);
|
|
100
|
+
};
|
|
101
|
+
}, [isActive, setIsLabelFocused]);
|
|
102
|
+
}
|
|
103
|
+
|
|
71
104
|
/**
|
|
72
105
|
* Hook that merges local field props with the nearest form field context
|
|
73
106
|
* and returns normalised HTML / ARIA attributes for input elements.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"names":["React","Platform","ariaAttr","FormControlContext","createContext","useFormControlRoot","props","id","idProp","name","isRequired","isInvalid","isDisabled","isReadOnly","htmlProps","reactId","useId","labelId","feedbackId","helpTextId","hasFeedbackText","setHasFeedbackText","useState","hasHelpText","setHasHelpText","inputRef","useRef","focusInput","useCallback","node","current","focus","context","Boolean","OS","
|
|
1
|
+
{"version":3,"names":["React","Platform","ariaAttr","FormControlContext","createContext","useFormControlRoot","props","id","idProp","name","isRequired","isInvalid","isDisabled","isReadOnly","htmlProps","reactId","useId","labelId","feedbackId","helpTextId","hasFeedbackText","setHasFeedbackText","useState","hasHelpText","setHasHelpText","isLabelFocused","setIsLabelFocused","inputRef","useRef","focusInput","useCallback","node","current","focus","context","Boolean","OS","useReportFormControlLabelFocus","isActive","useFormControlContext","useLayoutEffect","undefined","useFormControl","field","describedBy","push","ariaDescribedBy","join","cleanProps","disabled","readOnly","required","useContext"],"sourceRoot":"../../../src","sources":["form-control/useFormControl.tsx"],"mappings":"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","ignoreList":[]}
|