@cdx-ui/utils 0.0.1-beta.98 → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright © 2026 Digital First Holdings LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,7 @@
 # @cdx-ui/utils
 
+![coverage](https://unpkg.com/@cdx-ui/utils/coverage.svg)
+
 Shared utilities used across FDS packages.
 
 Provides common helpers for styling, event handling, state management, and context propagation used by [`@cdx-ui/primitives`](../primitives/) and [`@cdx-ui/components`](../components/).
@@ -22,6 +24,7 @@ pnpm add @cdx-ui/utils
 | `mergeRefs(...refs)`                | Combines multiple refs (callback or object) into one ref callback.                                                                         |
 | `flattenChildren(children)`         | Recursively flattens React `children` (including Fragments) into a flat array with re-keyed elements.                                      |
 | `ariaAttr(condition)`               | Returns `true` (boolean) or `undefined` — shorthand for boolean ARIA attribute values.                                                     |
+| `cva(base, config)`                 | Class Variance Authority helper for authoring variant-driven `className` builders. `VariantProps<typeof fn>` derives the prop type.         |
 
 ### Context
 
@@ -33,11 +36,11 @@ pnpm add @cdx-ui/utils
 
 Used internally by `@cdx-ui/components` to propagate variant props (size, color, etc.) from a compound root to its sub-components.
 
-| Export                                | Description                                                                        |
-| ------------------------------------- | ---------------------------------------------------------------------------------- |
-| `ParentContext`                       | React context for propagating variant props from a compound root to sub-components. Wrap children in `<ParentContext.Provider value={...}>`. |
-| `useStyleContext(scope?)`             | Reads the style context set by the nearest `ParentContext.Provider`.               |
-| `useParentContext()`                  | Reads the full `StyleContextMap` from the nearest provider.                        |
+| Export                    | Description                                                                                                                                  |
+| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| `ParentContext`           | React context for propagating variant props from a compound root to sub-components. Wrap children in `<ParentContext.Provider value={...}>`. |
+| `useStyleContext(scope?)` | Reads the style context set by the nearest `ParentContext.Provider`.                                                                         |
+| `useParentContext()`      | Reads the full `StyleContextMap` from the nearest provider.                                                                                  |
 
 ### Form control
 
@@ -56,6 +59,7 @@ Low-level form-field state used by the `Field` and `Input` primitives.
 | Type                         | Source       |
 | ---------------------------- | ------------ |
 | `UseControllableStateParams` | common       |
+| `VariantProps`               | common       |
 | `Focusable`                  | form-control |
 | `FormControlContextValue`    | form-control |
 | `FormControlFieldProps`      | form-control |
@@ -63,7 +67,6 @@ Low-level form-field state used by the `Field` and `Input` primitives.
 | `FormControlRootReturn`      | form-control |
 | `FormControlState`           | form-control |
 | `StyleContextMap`            | style        |
-| `WithStyleContextProps`      | style        |
 
 ## Testing
 
@@ -79,3 +82,9 @@ All runtime exports have test coverage using `@testing-library/react-native` (`r
 
 - [State management practices](../../docs/internal/practices/state.md) — `useControllableState` and `composeEventHandlers` patterns
 - [Styling practices](../../docs/internal/practices/styling.md) — `cn()` and CVA variant authoring
+
+## License
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+
+MIT © 2026 Digital First Holdings LLC. See [LICENSE](./LICENSE) for details.

package/coverage.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="114" height="20" role="img" aria-label="coverage: 100.0%"><title>coverage: 100.0%</title><filter id="blur"><feGaussianBlur stdDeviation="16"/></filter><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="114" height="20" rx="3"/></clipPath><g clip-path="url(#r)"><rect width="61" height="20" fill="#555"/><rect x="61" width="53" height="20" fill="#4b0"/><rect width="114" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="315" y="150" fill-opacity=".8" filter="url(#blur)" textLength="510">coverage</text><text x="315" y="150" fill-opacity=".3" textLength="510">coverage</text></g><text x="315" y="140" textLength="510">coverage</text></g><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="865" y="150" fill-opacity=".8" filter="url(#blur)" textLength="430">100.0%</text><text x="865" y="150" fill-opacity=".3" textLength="430">100.0%</text></g><text x="865" y="140" textLength="430">100.0%</text></g></g></svg>

package/lib/commonjs/common/cva.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "cva", {
+  enumerable: true,
+  get: function () {
+    return _classVarianceAuthority.cva;
+  }
+});
+var _classVarianceAuthority = require("class-variance-authority");
+//# sourceMappingURL=cva.js.map

package/lib/commonjs/common/cva.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_classVarianceAuthority","require"],"sourceRoot":"../../../src","sources":["common/cva.ts"],"mappings":";;;;;;;;;;;AAAA,IAAAA,uBAAA,GAAAC,OAAA","ignoreList":[]}

package/lib/commonjs/common/index.js

@@ -21,6 +21,12 @@ Object.defineProperty(exports, "composeEventHandlers", {
     return _composeEventHandlers.composeEventHandlers;
   }
 });
+Object.defineProperty(exports, "cva", {
+  enumerable: true,
+  get: function () {
+    return _cva.cva;
+  }
+});
 Object.defineProperty(exports, "flattenChildren", {
   enumerable: true,
   get: function () {
@@ -41,6 +47,7 @@ Object.defineProperty(exports, "useControllableState", {
 });
 var _accessibilityUtils = require("./accessibilityUtils");
 var _cn = require("./cn");
+var _cva = require("./cva");
 var _composeEventHandlers = require("./composeEventHandlers");
 var _getSpacedChild = require("./getSpacedChild");
 var _mergeRefs = require("./mergeRefs");

package/lib/commonjs/common/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_accessibilityUtils","require","_cn","_composeEventHandlers","_getSpacedChild","_mergeRefs","_useControllableState"],"sourceRoot":"../../../src","sources":["common/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,mBAAA,GAAAC,OAAA;AACA,IAAAC,GAAA,GAAAD,OAAA;AACA,IAAAE,qBAAA,GAAAF,OAAA;AACA,IAAAG,eAAA,GAAAH,OAAA;AACA,IAAAI,UAAA,GAAAJ,OAAA;AACA,IAAAK,qBAAA,GAAAL,OAAA","ignoreList":[]}
+{"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":[]}

package/lib/module/common/cva.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export { cva } from 'class-variance-authority';
+//# sourceMappingURL=cva.js.map

package/lib/module/common/cva.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["cva"],"sourceRoot":"../../../src","sources":["common/cva.ts"],"mappings":";;AAAA,SAASA,GAAG,QAA2B,0BAA0B","ignoreList":[]}

package/lib/module/common/index.js

@@ -2,6 +2,7 @@
 
 export { ariaAttr } from './accessibilityUtils';
 export { cn } from './cn';
+export { cva } from './cva';
 export { composeEventHandlers } from './composeEventHandlers';
 export { flattenChildren } from './getSpacedChild';
 export { mergeRefs } from './mergeRefs';

package/lib/module/common/index.js.map

@@ -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":[]}
+{"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":[]}

package/lib/typescript/common/cva.d.ts

@@ -0,0 +1,2 @@
+export { cva, type VariantProps } from 'class-variance-authority';
+//# sourceMappingURL=cva.d.ts.map

package/lib/typescript/common/cva.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cva.d.ts","sourceRoot":"","sources":["../../../src/common/cva.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC"}

package/lib/typescript/common/index.d.ts

@@ -1,5 +1,6 @@
 export { ariaAttr } from './accessibilityUtils';
 export { cn } from './cn';
+export { cva, type VariantProps } from './cva';
 export { composeEventHandlers } from './composeEventHandlers';
 export { flattenChildren } from './getSpacedChild';
 export { mergeRefs } from './mergeRefs';

package/lib/typescript/common/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,KAAK,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,KAAK,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/package.json

@@ -1,6 +1,12 @@
 {
   "name": "@cdx-ui/utils",
-  "version": "0.0.1-beta.98",
+  "version": "0.1.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dfh-candescent-ui/ui-component-framework",
+    "directory": "packages/utils"
+  },
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
   "react-native": "src/index.ts",
@@ -17,7 +23,8 @@
   },
   "files": [
     "lib",
-    "src"
+    "src",
+    "coverage.svg"
   ],
   "react-native-builder-bob": {
     "source": "src",
@@ -30,6 +37,7 @@
     ]
   },
   "dependencies": {
+    "class-variance-authority": "^0.7.1",
     "clsx": "2.1.1",
     "tailwind-merge": "3.5.0"
   },
@@ -47,10 +55,10 @@
     }
   },
   "devDependencies": {
-    "@types/react": "*",
+    "@types/react": "19.1.17",
     "@types/react-dom": "*",
-    "react": "*",
-    "react-dom": "*",
+    "react": "19.1.0",
+    "react-dom": "19.1.0",
     "react-native": "*",
     "react-native-builder-bob": "*",
     "react-native-web": "*",

package/src/common/cva.ts

@@ -0,0 +1 @@
+export { cva, type VariantProps } from 'class-variance-authority';

package/src/common/index.ts

@@ -1,5 +1,6 @@
 export { ariaAttr } from './accessibilityUtils';
 export { cn } from './cn';
+export { cva, type VariantProps } from './cva';
 export { composeEventHandlers } from './composeEventHandlers';
 export { flattenChildren } from './getSpacedChild';
 export { mergeRefs } from './mergeRefs';