@cdx-ui/components 0.0.1-beta.40 → 0.0.1-beta.42

package/README.md

@@ -1,6 +1,6 @@
 # @cdx-ui/components
 
-Styled, theme-aware UI components for the Candescent Design System.
+Styled, theme-aware UI components for the Forge Design System.
 
 Built on top of [`@cdx-ui/primitives`](../primitives/) and [`@cdx-ui/styles`](../styles/), styled via [Uniwind](https://uniwind.dev) + [CVA](https://cva.style).
 
@@ -42,18 +42,18 @@ AlertDialog, Avatar, BottomSheet, Button, Card, Checkbox, Chip, Dialog, Field, F
 
 ### Metro configuration helper
 
-The package ships a `withCdxMetroConfig` helper that wraps your Metro config with CDX UI's styling-layer setup. This abstracts the underlying Uniwind configuration so consuming Metro configs stay stable if the styling layer changes.
+The package ships a `withForgeMetroConfig` helper that wraps your Metro config with Forge UI's styling-layer setup. This abstracts the underlying Uniwind configuration so consuming Metro configs stay stable if the styling layer changes.
 
 ```js
-const { withCdxMetroConfig } = require('@cdx-ui/components/metro');
+const { withForgeMetroConfig } = require('@cdx-ui/components/metro');
 
-module.exports = withCdxMetroConfig(config, {
+module.exports = withForgeMetroConfig(config, {
   cssEntryFile: './global.css',
   generatedTypesFile: './uniwind-types.d.ts', // optional
 });
 ```
 
-`withCdxMetroConfig` must be the **outermost** wrapper if you compose multiple Metro config helpers.
+`withForgeMetroConfig` must be the **outermost** wrapper if you compose multiple Metro config helpers.
 
 ### React Native re-exports
 
@@ -69,7 +69,7 @@ For convenience, the package re-exports several core RN components and hooks wit
 
 ## Figma Code Connect
 
-Template files in [`src/figma/`](./src/figma/) map Figma component variants to production CDX UI snippets shown in Figma Dev Mode. These files are excluded from the npm tarball (`!src/figma` in `files`) and published to Figma via CI on pushes to `main`.
+Template files in [`src/figma/`](./src/figma/) map Figma component variants to production Forge UI snippets shown in Figma Dev Mode. These files are excluded from the npm tarball (`!src/figma` in `files`) and published to Figma via CI on pushes to `main`.
 
 See the **[Code Connect authoring guide](../../docs/internal/practices/code-connect.md)** for conventions, property mapping patterns, and local workflow.
 

package/lib/commonjs/components/Icon/index.js

@@ -41,10 +41,10 @@ const StyledIcon = (0, _uniwind.withUniwind)(IconImpl, {
  * <Icon as={ArrowRight} className="text-red-500 size-4" />
  * ```
  *
- * @param {CdxIcon} as - The CDX icon component to render.
+ * @param {ForgeIcon} as - The Forge icon component to render.
  * @param {string} className - Utility classes to style the icon using Uniwind.
  * @param {number} size - Icon size (overrides the size class).
- * @param {...CdxIconProps} ...props - Additional icon props passed to the "as" icon.
+ * @param {...ForgeIconProps} ...props - Additional icon props passed to the "as" icon.
  */
 function Icon({
   as: IconComponent,

package/lib/commonjs/components/IconButton/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","require","_reactNative","_primitives","_utils","_Icon","_styles","_jsxRuntime","IconButtonPrimitive","createButton","Root","Pressable","Text","Group","View","Spinner","ActivityIndicator","Icon","IconButtonGlyph","as","IconComponent","className","hover","focus","active","disabled","focusVisible","useButtonContext","jsx","dataAttributes","IconButtonRoot","forwardRef","variant","color","size","style","iconClassName","accessibilityRole","props","ref","rootClassName","cn","iconButtonRootVariants","glyphClassName","iconButtonGlyphVariants","iconButtonIconColorVariants","children","displayName","IconButton","exports"],"sourceRoot":"../../../../src","sources":["components/IconButton/index.tsx"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AACA,IAAAE,WAAA,GAAAF,OAAA;AAOA,IAAAG,MAAA,GAAAH,OAAA;AACA,IAAAI,KAAA,GAAAJ,OAAA;AACA,IAAAK,OAAA,GAAAL,OAAA;AAKkB,IAAAM,WAAA,GAAAN,OAAA;AAElB,MAAMO,mBAAmB,GAAG,IAAAC,wBAAY,EAAC;EACvCC,IAAI,EAAEC,sBAAS;EACfC,IAAI,EAAJA,iBAAI;EACJC,KAAK,EAAEC,iBAAI;EACXC,OAAO,EAAEC,8BAAiB;EAC1BC,IAAI,EAAEH;AACR,CAAC,CAAC;AAEF,SAASI,eAAeA,CAAC;EAAEC,EAAE,EAAEC,aAAa;EAAEC;AAA8C,CAAC,EAAE;EAC7F,MAAM;IAAEC,KAAK;IAAEC,KAAK;IAAEC,MAAM;IAAEC,QAAQ;IAAEC;EAAa,CAAC,GAAG,IAAAC,4BAAgB,EAAC,CAAC;EAC3E,oBACE,IAAApB,WAAA,CAAAqB,GAAA,EAACvB,KAAA,CAAAY,IAAI;IACHE,EAAE,EAAEC,aAAc;IAClBC,SAAS,EAAEA,SAAU;IAAA,GACjB,IAAAQ,0BAAc,EAAC;MACjBP,KAAK;MACLC,KAAK;MACLC,MAAM;MACNC,QAAQ;MACRC;IACF,CAAC;EAAC,CACH,CAAC;AAEN;AAUA,MAAMI,cAAc,gBAAG,IAAAC,iBAAU,EAC/B,CACE;EACEC,OAAO,GAAG,OAAO;EACjBC,KAAK,GAAG,SAAS;EACjBC,IAAI,GAAG,SAAS;EAChBb,SAAS;EACTc,KAAK;EACLhB,EAAE,EAAEC,aAAa;EACjBgB,aAAa;EACbC,iBAAiB,GAAG,QAAQ;EAC5B,GAAGC;AACL,CAAC,EACDC,GAAG,KACA;EACH,MAAMC,aAAa,GAAG,IAAAC,SAAE,EAAC,IAAAC,8BAAsB,EAAC;IAAEV,OAAO;IAAEC,KAAK;IAAEC;EAAK,CAAC,CAAC,EAAEb,SAAS,CAAC;EAErF,MAAMsB,cAAc,GAAG,IAAAF,SAAE,EACvB,IAAAG,+BAAuB,EAAC;IAAEV;EAAK,CAAC,CAAC,EACjC,IAAAW,mCAA2B,EAAC;IAAEb,OAAO;IAAEC;EAAM,CAAC,CAAC,EAC/CG,aACF,CAAC;EAED,oBACE,IAAA7B,WAAA,CAAAqB,GAAA,EAACpB,mBAAmB;IAClB+B,GAAG,EAAEA,GAAI;IACTF,iBAAiB,EAAEA,iBAAkB;IACrChB,SAAS,EAAEmB,aAAc;IACzBL,KAAK,EAAEA,KAAM;IAAA,GACTG,KAAK;IAAAQ,QAAA,eAET,IAAAvC,WAAA,CAAAqB,GAAA,EAACV,eAAe;MAACC,EAAE,EAAEC,aAAc;MAACC,SAAS,EAAEsB;IAAe,CAAE;EAAC,CAC9C,CAAC;AAE1B,CACF,CAAC;AAEDb,cAAc,CAACiB,WAAW,GAAG,YAAY;AAElC,MAAMC,UAAU,GAAAC,OAAA,CAAAD,UAAA,GAAGlB,cAAc","ignoreList":[]}
+{"version":3,"names":["_react","require","_reactNative","_primitives","_utils","_Icon","_styles","_jsxRuntime","IconButtonPrimitive","createButton","Root","Pressable","Text","Group","View","Spinner","ActivityIndicator","Icon","IconButtonGlyph","as","IconComponent","className","hover","focus","active","disabled","focusVisible","useButtonContext","jsx","dataAttributes","IconButtonRoot","forwardRef","variant","color","size","style","iconClassName","accessibilityRole","props","ref","rootClassName","cn","iconButtonRootVariants","glyphClassName","iconButtonGlyphVariants","iconButtonIconColorVariants","children","displayName","IconButton","exports"],"sourceRoot":"../../../../src","sources":["components/IconButton/index.tsx"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AACA,IAAAE,WAAA,GAAAF,OAAA;AAOA,IAAAG,MAAA,GAAAH,OAAA;AACA,IAAAI,KAAA,GAAAJ,OAAA;AACA,IAAAK,OAAA,GAAAL,OAAA;AAKkB,IAAAM,WAAA,GAAAN,OAAA;AAElB,MAAMO,mBAAmB,GAAG,IAAAC,wBAAY,EAAC;EACvCC,IAAI,EAAEC,sBAAS;EACfC,IAAI,EAAJA,iBAAI;EACJC,KAAK,EAAEC,iBAAI;EACXC,OAAO,EAAEC,8BAAiB;EAC1BC,IAAI,EAAEH;AACR,CAAC,CAAC;AAEF,SAASI,eAAeA,CAAC;EAAEC,EAAE,EAAEC,aAAa;EAAEC;AAAgD,CAAC,EAAE;EAC/F,MAAM;IAAEC,KAAK;IAAEC,KAAK;IAAEC,MAAM;IAAEC,QAAQ;IAAEC;EAAa,CAAC,GAAG,IAAAC,4BAAgB,EAAC,CAAC;EAC3E,oBACE,IAAApB,WAAA,CAAAqB,GAAA,EAACvB,KAAA,CAAAY,IAAI;IACHE,EAAE,EAAEC,aAAc;IAClBC,SAAS,EAAEA,SAAU;IAAA,GACjB,IAAAQ,0BAAc,EAAC;MACjBP,KAAK;MACLC,KAAK;MACLC,MAAM;MACNC,QAAQ;MACRC;IACF,CAAC;EAAC,CACH,CAAC;AAEN;AAUA,MAAMI,cAAc,gBAAG,IAAAC,iBAAU,EAC/B,CACE;EACEC,OAAO,GAAG,OAAO;EACjBC,KAAK,GAAG,SAAS;EACjBC,IAAI,GAAG,SAAS;EAChBb,SAAS;EACTc,KAAK;EACLhB,EAAE,EAAEC,aAAa;EACjBgB,aAAa;EACbC,iBAAiB,GAAG,QAAQ;EAC5B,GAAGC;AACL,CAAC,EACDC,GAAG,KACA;EACH,MAAMC,aAAa,GAAG,IAAAC,SAAE,EAAC,IAAAC,8BAAsB,EAAC;IAAEV,OAAO;IAAEC,KAAK;IAAEC;EAAK,CAAC,CAAC,EAAEb,SAAS,CAAC;EAErF,MAAMsB,cAAc,GAAG,IAAAF,SAAE,EACvB,IAAAG,+BAAuB,EAAC;IAAEV;EAAK,CAAC,CAAC,EACjC,IAAAW,mCAA2B,EAAC;IAAEb,OAAO;IAAEC;EAAM,CAAC,CAAC,EAC/CG,aACF,CAAC;EAED,oBACE,IAAA7B,WAAA,CAAAqB,GAAA,EAACpB,mBAAmB;IAClB+B,GAAG,EAAEA,GAAI;IACTF,iBAAiB,EAAEA,iBAAkB;IACrChB,SAAS,EAAEmB,aAAc;IACzBL,KAAK,EAAEA,KAAM;IAAA,GACTG,KAAK;IAAAQ,QAAA,eAET,IAAAvC,WAAA,CAAAqB,GAAA,EAACV,eAAe;MAACC,EAAE,EAAEC,aAAc;MAACC,SAAS,EAAEsB;IAAe,CAAE;EAAC,CAC9C,CAAC;AAE1B,CACF,CAAC;AAEDb,cAAc,CAACiB,WAAW,GAAG,YAAY;AAElC,MAAMC,UAAU,GAAAC,OAAA,CAAAD,UAAA,GAAGlB,cAAc","ignoreList":[]}

package/lib/commonjs/figma/Avatar.figma.js

@@ -31,7 +31,7 @@ const type = instance.getEnum('type', {
   icon: 'icon'
 });
 
-// icon: INSTANCE_SWAP → Avatar.Icon `as` prop (CdxIcon identifier).
+// icon: INSTANCE_SWAP → Avatar.Icon `as` prop (ForgeIcon identifier).
 // Prefer metadata.props.componentName exposed by icon Code Connect templates.
 // Falls back to executeTemplate().example (placeholder pill) when the icon lacks Code Connect.
 const iconResult = instance.getInstanceSwap('icon')?.executeTemplate();

package/lib/commonjs/figma/CLAUDE.md

@@ -2,7 +2,7 @@
 
 Auto-loaded when working in `packages/components/src/figma/**` (`*.figma.ts`, `*.figma.batch.ts`, `*.figma.batch.json`).
 
-Template files connect CDX UI components to Figma Dev Mode snippets. Read the full guide before making changes:
+Template files connect Forge UI components to Figma Dev Mode snippets. Read the full guide before making changes:
 
 - `docs/internal/practices/code-connect.md` — complete workflow, mapping patterns, publishing, troubleshooting
 

package/lib/commonjs/figma/IconButton.figma.js

@@ -33,7 +33,7 @@ const isDisabled = instance.getEnum('isDisabled', {
 });
 const isDisabledProp = _figma.default.helpers.react.renderProp('isDisabled', isDisabled);
 
-// icon: INSTANCE_SWAP → IconButton `as` (CdxIcon). Prefer metadata.props.componentName from icon Code Connect.
+// icon: INSTANCE_SWAP → IconButton `as` (ForgeIcon). Prefer metadata.props.componentName from icon Code Connect.
 const iconResult = instance.getInstanceSwap('icon')?.executeTemplate();
 const iconName = iconResult?.metadata?.props?.componentName;
 const iconSnippet = iconName ?? iconResult?.example;

package/lib/commonjs/metro/withCdxMetroConfig.js

@@ -3,22 +3,11 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.withCdxMetroConfig = withCdxMetroConfig;
-var _metro = require("uniwind/metro");
-/**
- * Wraps a Metro config with CDX UI's styling-layer configuration.
- *
- * Today this delegates to Uniwind. If the styling layer is swapped (see
- * `docs/research/uniwind-to-nativewind-contingency.md`), only the internals
- * of this function change — consuming Metro configs stay the same.
- *
- * Must be the **outermost** Metro config wrapper (after any other wrappers
- * like `withStorybook`).
- */
-function withCdxMetroConfig(config, options) {
-  return (0, _metro.withUniwindConfig)(config, {
-    cssEntryFile: options.cssEntryFile,
-    dtsFile: options.generatedTypesFile
-  });
-}
+Object.defineProperty(exports, "withCdxMetroConfig", {
+  enumerable: true,
+  get: function () {
+    return _withForgeMetroConfig.withForgeMetroConfig;
+  }
+});
+var _withForgeMetroConfig = require("./withForgeMetroConfig");
 //# sourceMappingURL=withCdxMetroConfig.js.map

package/lib/commonjs/metro/withCdxMetroConfig.js.map

@@ -1 +1 @@
-{"version":3,"names":["_metro","require","withCdxMetroConfig","config","options","withUniwindConfig","cssEntryFile","dtsFile","generatedTypesFile"],"sourceRoot":"../../../src","sources":["metro/withCdxMetroConfig.ts"],"mappings":";;;;;;AACA,IAAAA,MAAA,GAAAC,OAAA;AASA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,kBAAkBA,CAChCC,MAAS,EACTC,OAA8B,EAC3B;EACH,OAAO,IAAAC,wBAAiB,EAACF,MAAM,EAAE;IAC/BG,YAAY,EAAEF,OAAO,CAACE,YAAY;IAClCC,OAAO,EAAEH,OAAO,CAACI;EACnB,CAAC,CAAC;AACJ","ignoreList":[]}
+{"version":3,"names":["_withForgeMetroConfig","require"],"sourceRoot":"../../../src","sources":["metro/withCdxMetroConfig.ts"],"mappings":";;;;;;;;;;;AACA,IAAAA,qBAAA,GAAAC,OAAA","ignoreList":[]}

package/lib/commonjs/metro/withForgeMetroConfig.js

@@ -0,0 +1,24 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.withForgeMetroConfig = withForgeMetroConfig;
+var _metro = require("uniwind/metro");
+/**
+ * Wraps a Metro config with Forge UI's styling-layer configuration.
+ *
+ * Today this delegates to Uniwind. If the styling layer is swapped (see
+ * `docs/research/uniwind-to-nativewind-contingency.md`), only the internals
+ * of this function change — consuming Metro configs stay the same.
+ *
+ * Must be the **outermost** Metro config wrapper (after any other wrappers
+ * like `withStorybook`).
+ */
+function withForgeMetroConfig(config, options) {
+  return (0, _metro.withUniwindConfig)(config, {
+    cssEntryFile: options.cssEntryFile,
+    dtsFile: options.generatedTypesFile
+  });
+}
+//# sourceMappingURL=withForgeMetroConfig.js.map

package/lib/commonjs/metro/withForgeMetroConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_metro","require","withForgeMetroConfig","config","options","withUniwindConfig","cssEntryFile","dtsFile","generatedTypesFile"],"sourceRoot":"../../../src","sources":["metro/withForgeMetroConfig.ts"],"mappings":";;;;;;AACA,IAAAA,MAAA,GAAAC,OAAA;AASA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,oBAAoBA,CAClCC,MAAS,EACTC,OAAgC,EAC7B;EACH,OAAO,IAAAC,wBAAiB,EAACF,MAAM,EAAE;IAC/BG,YAAY,EAAEF,OAAO,CAACE,YAAY;IAClCC,OAAO,EAAEH,OAAO,CAACI;EACnB,CAAC,CAAC;AACJ","ignoreList":[]}

package/lib/commonjs/styles/primitives.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.TRANSITION_COLORS = exports.SIZE_SCALE = exports.SHADOW_SM = exports.SHADOW_MD = exports.SEMANTIC_COLORS = exports.RADIUS_SM = exports.RADIUS_MD = exports.RADIUS_FULL = exports.FOCUS_RING = exports.DISABLED_OPACITY = exports.DISABLED_CURSOR = exports.COLOR_TEXT_SECONDARY = exports.COLOR_TEXT_PRIMARY = exports.COLOR_TEXT_PLACEHOLDER = exports.COLOR_TEXT_MUTED = exports.COLOR_TEXT_INVERSE = exports.COLOR_TEXT_INVALID = exports.COLOR_BRAND_HOVER = exports.COLOR_BRAND_DEFAULT = exports.COLOR_BRAND_ACTIVE = exports.COLOR_BORDER_STRONG = exports.COLOR_BORDER_INVALID = exports.COLOR_BORDER_FOCUS = exports.COLOR_BORDER_DEFAULT = exports.COLOR_BG_SUBTLE = exports.COLOR_BG_PRIMARY = exports.COLOR_BG_MUTED = exports.COLOR_BG_INVERSE = exports.COLOR_ACCENT_DEFAULT = exports.COLOR_ACCENT_BORDER = void 0;
 // packages/components/src/styles/primitives.ts
-// Semantic constants for CDX UI component styling.
+// Semantic constants for Forge UI component styling.
 
 // ─── Colors ──────────────────────────────────────────────
 // Surface & background

package/lib/module/components/Icon/index.js

@@ -37,10 +37,10 @@ const StyledIcon = withUniwind(IconImpl, {
  * <Icon as={ArrowRight} className="text-red-500 size-4" />
  * ```
  *
- * @param {CdxIcon} as - The CDX icon component to render.
+ * @param {ForgeIcon} as - The Forge icon component to render.
  * @param {string} className - Utility classes to style the icon using Uniwind.
  * @param {number} size - Icon size (overrides the size class).
- * @param {...CdxIconProps} ...props - Additional icon props passed to the "as" icon.
+ * @param {...ForgeIconProps} ...props - Additional icon props passed to the "as" icon.
  */
 export function Icon({
   as: IconComponent,

package/lib/module/components/IconButton/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["forwardRef","ActivityIndicator","Pressable","Text","View","createButton","dataAttributes","useButtonContext","cn","Icon","iconButtonGlyphVariants","iconButtonIconColorVariants","iconButtonRootVariants","jsx","_jsx","IconButtonPrimitive","Root","Group","Spinner","IconButtonGlyph","as","IconComponent","className","hover","focus","active","disabled","focusVisible","IconButtonRoot","variant","color","size","style","iconClassName","accessibilityRole","props","ref","rootClassName","glyphClassName","children","displayName","IconButton"],"sourceRoot":"../../../../src","sources":["components/IconButton/index.tsx"],"mappings":";;AAAA,SAASA,UAAU,QAAQ,OAAO;AAClC,SAASC,iBAAiB,EAAEC,SAAS,EAAEC,IAAI,EAAEC,IAAI,QAA6B,cAAc;AAC5F,SACEC,YAAY,EACZC,cAAc,EAEdC,gBAAgB,QACX,oBAAoB;AAE3B,SAASC,EAAE,QAAQ,eAAe;AAClC,SAASC,IAAI,QAAwB,SAAS;AAC9C,SAEEC,uBAAuB,EACvBC,2BAA2B,EAC3BC,sBAAsB,QACjB,UAAU;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAElB,MAAMC,mBAAmB,GAAGV,YAAY,CAAC;EACvCW,IAAI,EAAEd,SAAS;EACfC,IAAI;EACJc,KAAK,EAAEb,IAAI;EACXc,OAAO,EAAEjB,iBAAiB;EAC1BQ,IAAI,EAAEL;AACR,CAAC,CAAC;AAEF,SAASe,eAAeA,CAAC;EAAEC,EAAE,EAAEC,aAAa;EAAEC;AAA8C,CAAC,EAAE;EAC7F,MAAM;IAAEC,KAAK;IAAEC,KAAK;IAAEC,MAAM;IAAEC,QAAQ;IAAEC;EAAa,CAAC,GAAGpB,gBAAgB,CAAC,CAAC;EAC3E,oBACEO,IAAA,CAACL,IAAI;IACHW,EAAE,EAAEC,aAAc;IAClBC,SAAS,EAAEA,SAAU;IAAA,GACjBhB,cAAc,CAAC;MACjBiB,KAAK;MACLC,KAAK;MACLC,MAAM;MACNC,QAAQ;MACRC;IACF,CAAC;EAAC,CACH,CAAC;AAEN;AAUA,MAAMC,cAAc,gBAAG5B,UAAU,CAC/B,CACE;EACE6B,OAAO,GAAG,OAAO;EACjBC,KAAK,GAAG,SAAS;EACjBC,IAAI,GAAG,SAAS;EAChBT,SAAS;EACTU,KAAK;EACLZ,EAAE,EAAEC,aAAa;EACjBY,aAAa;EACbC,iBAAiB,GAAG,QAAQ;EAC5B,GAAGC;AACL,CAAC,EACDC,GAAG,KACA;EACH,MAAMC,aAAa,GAAG7B,EAAE,CAACI,sBAAsB,CAAC;IAAEiB,OAAO;IAAEC,KAAK;IAAEC;EAAK,CAAC,CAAC,EAAET,SAAS,CAAC;EAErF,MAAMgB,cAAc,GAAG9B,EAAE,CACvBE,uBAAuB,CAAC;IAAEqB;EAAK,CAAC,CAAC,EACjCpB,2BAA2B,CAAC;IAAEkB,OAAO;IAAEC;EAAM,CAAC,CAAC,EAC/CG,aACF,CAAC;EAED,oBACEnB,IAAA,CAACC,mBAAmB;IAClBqB,GAAG,EAAEA,GAAI;IACTF,iBAAiB,EAAEA,iBAAkB;IACrCZ,SAAS,EAAEe,aAAc;IACzBL,KAAK,EAAEA,KAAM;IAAA,GACTG,KAAK;IAAAI,QAAA,eAETzB,IAAA,CAACK,eAAe;MAACC,EAAE,EAAEC,aAAc;MAACC,SAAS,EAAEgB;IAAe,CAAE;EAAC,CAC9C,CAAC;AAE1B,CACF,CAAC;AAEDV,cAAc,CAACY,WAAW,GAAG,YAAY;AAEzC,OAAO,MAAMC,UAAU,GAAGb,cAAc","ignoreList":[]}
+{"version":3,"names":["forwardRef","ActivityIndicator","Pressable","Text","View","createButton","dataAttributes","useButtonContext","cn","Icon","iconButtonGlyphVariants","iconButtonIconColorVariants","iconButtonRootVariants","jsx","_jsx","IconButtonPrimitive","Root","Group","Spinner","IconButtonGlyph","as","IconComponent","className","hover","focus","active","disabled","focusVisible","IconButtonRoot","variant","color","size","style","iconClassName","accessibilityRole","props","ref","rootClassName","glyphClassName","children","displayName","IconButton"],"sourceRoot":"../../../../src","sources":["components/IconButton/index.tsx"],"mappings":";;AAAA,SAASA,UAAU,QAAQ,OAAO;AAClC,SAASC,iBAAiB,EAAEC,SAAS,EAAEC,IAAI,EAAEC,IAAI,QAA6B,cAAc;AAC5F,SACEC,YAAY,EACZC,cAAc,EAEdC,gBAAgB,QACX,oBAAoB;AAE3B,SAASC,EAAE,QAAQ,eAAe;AAClC,SAASC,IAAI,QAAwB,SAAS;AAC9C,SAEEC,uBAAuB,EACvBC,2BAA2B,EAC3BC,sBAAsB,QACjB,UAAU;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAElB,MAAMC,mBAAmB,GAAGV,YAAY,CAAC;EACvCW,IAAI,EAAEd,SAAS;EACfC,IAAI;EACJc,KAAK,EAAEb,IAAI;EACXc,OAAO,EAAEjB,iBAAiB;EAC1BQ,IAAI,EAAEL;AACR,CAAC,CAAC;AAEF,SAASe,eAAeA,CAAC;EAAEC,EAAE,EAAEC,aAAa;EAAEC;AAAgD,CAAC,EAAE;EAC/F,MAAM;IAAEC,KAAK;IAAEC,KAAK;IAAEC,MAAM;IAAEC,QAAQ;IAAEC;EAAa,CAAC,GAAGpB,gBAAgB,CAAC,CAAC;EAC3E,oBACEO,IAAA,CAACL,IAAI;IACHW,EAAE,EAAEC,aAAc;IAClBC,SAAS,EAAEA,SAAU;IAAA,GACjBhB,cAAc,CAAC;MACjBiB,KAAK;MACLC,KAAK;MACLC,MAAM;MACNC,QAAQ;MACRC;IACF,CAAC;EAAC,CACH,CAAC;AAEN;AAUA,MAAMC,cAAc,gBAAG5B,UAAU,CAC/B,CACE;EACE6B,OAAO,GAAG,OAAO;EACjBC,KAAK,GAAG,SAAS;EACjBC,IAAI,GAAG,SAAS;EAChBT,SAAS;EACTU,KAAK;EACLZ,EAAE,EAAEC,aAAa;EACjBY,aAAa;EACbC,iBAAiB,GAAG,QAAQ;EAC5B,GAAGC;AACL,CAAC,EACDC,GAAG,KACA;EACH,MAAMC,aAAa,GAAG7B,EAAE,CAACI,sBAAsB,CAAC;IAAEiB,OAAO;IAAEC,KAAK;IAAEC;EAAK,CAAC,CAAC,EAAET,SAAS,CAAC;EAErF,MAAMgB,cAAc,GAAG9B,EAAE,CACvBE,uBAAuB,CAAC;IAAEqB;EAAK,CAAC,CAAC,EACjCpB,2BAA2B,CAAC;IAAEkB,OAAO;IAAEC;EAAM,CAAC,CAAC,EAC/CG,aACF,CAAC;EAED,oBACEnB,IAAA,CAACC,mBAAmB;IAClBqB,GAAG,EAAEA,GAAI;IACTF,iBAAiB,EAAEA,iBAAkB;IACrCZ,SAAS,EAAEe,aAAc;IACzBL,KAAK,EAAEA,KAAM;IAAA,GACTG,KAAK;IAAAI,QAAA,eAETzB,IAAA,CAACK,eAAe;MAACC,EAAE,EAAEC,aAAc;MAACC,SAAS,EAAEgB;IAAe,CAAE;EAAC,CAC9C,CAAC;AAE1B,CACF,CAAC;AAEDV,cAAc,CAACY,WAAW,GAAG,YAAY;AAEzC,OAAO,MAAMC,UAAU,GAAGb,cAAc","ignoreList":[]}

package/lib/module/figma/Avatar.figma.js

@@ -25,7 +25,7 @@ const type = instance.getEnum('type', {
   icon: 'icon'
 });
 
-// icon: INSTANCE_SWAP → Avatar.Icon `as` prop (CdxIcon identifier).
+// icon: INSTANCE_SWAP → Avatar.Icon `as` prop (ForgeIcon identifier).
 // Prefer metadata.props.componentName exposed by icon Code Connect templates.
 // Falls back to executeTemplate().example (placeholder pill) when the icon lacks Code Connect.
 const iconResult = instance.getInstanceSwap('icon')?.executeTemplate();

package/lib/module/figma/CLAUDE.md

@@ -2,7 +2,7 @@
 
 Auto-loaded when working in `packages/components/src/figma/**` (`*.figma.ts`, `*.figma.batch.ts`, `*.figma.batch.json`).
 
-Template files connect CDX UI components to Figma Dev Mode snippets. Read the full guide before making changes:
+Template files connect Forge UI components to Figma Dev Mode snippets. Read the full guide before making changes:
 
 - `docs/internal/practices/code-connect.md` — complete workflow, mapping patterns, publishing, troubleshooting
 

package/lib/module/figma/IconButton.figma.js

@@ -27,7 +27,7 @@ const isDisabled = instance.getEnum('isDisabled', {
 });
 const isDisabledProp = figma.helpers.react.renderProp('isDisabled', isDisabled);
 
-// icon: INSTANCE_SWAP → IconButton `as` (CdxIcon). Prefer metadata.props.componentName from icon Code Connect.
+// icon: INSTANCE_SWAP → IconButton `as` (ForgeIcon). Prefer metadata.props.componentName from icon Code Connect.
 const iconResult = instance.getInstanceSwap('icon')?.executeTemplate();
 const iconName = iconResult?.metadata?.props?.componentName;
 const iconSnippet = iconName ?? iconResult?.example;

package/lib/module/metro/withCdxMetroConfig.js

@@ -1,20 +1,6 @@
 "use strict";
 
-import { withUniwindConfig } from 'uniwind/metro';
-/**
- * Wraps a Metro config with CDX UI's styling-layer configuration.
- *
- * Today this delegates to Uniwind. If the styling layer is swapped (see
- * `docs/research/uniwind-to-nativewind-contingency.md`), only the internals
- * of this function change — consuming Metro configs stay the same.
- *
- * Must be the **outermost** Metro config wrapper (after any other wrappers
- * like `withStorybook`).
- */
-export function withCdxMetroConfig(config, options) {
-  return withUniwindConfig(config, {
-    cssEntryFile: options.cssEntryFile,
-    dtsFile: options.generatedTypesFile
-  });
-}
+/** @deprecated Use `withForgeMetroConfig` instead. Will be removed in a future major release. */
+export { withForgeMetroConfig as withCdxMetroConfig } from './withForgeMetroConfig';
+/** @deprecated Use `ForgeMetroConfigOptions` instead. Will be removed in a future major release. */
 //# sourceMappingURL=withCdxMetroConfig.js.map

package/lib/module/metro/withCdxMetroConfig.js.map

@@ -1 +1 @@
-{"version":3,"names":["withUniwindConfig","withCdxMetroConfig","config","options","cssEntryFile","dtsFile","generatedTypesFile"],"sourceRoot":"../../../src","sources":["metro/withCdxMetroConfig.ts"],"mappings":";;AACA,SAASA,iBAAiB,QAAQ,eAAe;AASjD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAChCC,MAAS,EACTC,OAA8B,EAC3B;EACH,OAAOH,iBAAiB,CAACE,MAAM,EAAE;IAC/BE,YAAY,EAAED,OAAO,CAACC,YAAY;IAClCC,OAAO,EAAEF,OAAO,CAACG;EACnB,CAAC,CAAC;AACJ","ignoreList":[]}
+{"version":3,"names":["withForgeMetroConfig","withCdxMetroConfig"],"sourceRoot":"../../../src","sources":["metro/withCdxMetroConfig.ts"],"mappings":";;AAAA;AACA,SAASA,oBAAoB,IAAIC,kBAAkB,QAAQ,wBAAwB;AACnF","ignoreList":[]}

package/lib/module/metro/withForgeMetroConfig.js

@@ -0,0 +1,20 @@
+"use strict";
+
+import { withUniwindConfig } from 'uniwind/metro';
+/**
+ * Wraps a Metro config with Forge UI's styling-layer configuration.
+ *
+ * Today this delegates to Uniwind. If the styling layer is swapped (see
+ * `docs/research/uniwind-to-nativewind-contingency.md`), only the internals
+ * of this function change — consuming Metro configs stay the same.
+ *
+ * Must be the **outermost** Metro config wrapper (after any other wrappers
+ * like `withStorybook`).
+ */
+export function withForgeMetroConfig(config, options) {
+  return withUniwindConfig(config, {
+    cssEntryFile: options.cssEntryFile,
+    dtsFile: options.generatedTypesFile
+  });
+}
+//# sourceMappingURL=withForgeMetroConfig.js.map

package/lib/module/metro/withForgeMetroConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["withUniwindConfig","withForgeMetroConfig","config","options","cssEntryFile","dtsFile","generatedTypesFile"],"sourceRoot":"../../../src","sources":["metro/withForgeMetroConfig.ts"],"mappings":";;AACA,SAASA,iBAAiB,QAAQ,eAAe;AASjD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CAClCC,MAAS,EACTC,OAAgC,EAC7B;EACH,OAAOH,iBAAiB,CAACE,MAAM,EAAE;IAC/BE,YAAY,EAAED,OAAO,CAACC,YAAY;IAClCC,OAAO,EAAEF,OAAO,CAACG;EACnB,CAAC,CAAC;AACJ","ignoreList":[]}

package/lib/module/styles/primitives.js

@@ -1,7 +1,7 @@
 "use strict";
 
 // packages/components/src/styles/primitives.ts
-// Semantic constants for CDX UI component styling.
+// Semantic constants for Forge UI component styling.
 
 // ─── Colors ──────────────────────────────────────────────
 // Surface & background

package/lib/typescript/components/Icon/index.d.ts

@@ -1,7 +1,7 @@
-import type { CdxIcon, CdxIconProps } from '@cdx-ui/icons';
-export type IconProps = CdxIconProps & {
+import type { ForgeIcon, ForgeIconProps } from '@cdx-ui/icons';
+export type IconProps = ForgeIconProps & {
     className?: string;
-    as: CdxIcon;
+    as: ForgeIcon;
 };
 /**
  * A wrapper component for CDX icons with Uniwind `className` support via `withUniwind`.
@@ -18,10 +18,10 @@ export type IconProps = CdxIconProps & {
  * <Icon as={ArrowRight} className="text-red-500 size-4" />
  * ```
  *
- * @param {CdxIcon} as - The CDX icon component to render.
+ * @param {ForgeIcon} as - The Forge icon component to render.
  * @param {string} className - Utility classes to style the icon using Uniwind.
  * @param {number} size - Icon size (overrides the size class).
- * @param {...CdxIconProps} ...props - Additional icon props passed to the "as" icon.
+ * @param {...ForgeIconProps} ...props - Additional icon props passed to the "as" icon.
  */
 export declare function Icon({ as: IconComponent, className, ...props }: IconProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/components/Icon/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/Icon/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;CACb,CAAC;AAiBF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,IAAI,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,SAAS,2CAQzE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/Icon/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/D,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,SAAS,CAAC;CACf,CAAC;AAiBF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,IAAI,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,SAAS,2CAQzE"}

package/lib/typescript/components/IconButton/index.d.ts

@@ -1,12 +1,12 @@
 import { View, type PressableProps } from 'react-native';
 import { type IButtonProps } from '@cdx-ui/primitives';
-import type { CdxIcon } from '@cdx-ui/icons';
+import type { ForgeIcon } from '@cdx-ui/icons';
 import { type IconProps } from '../Icon';
 import { type IconButtonVariantProps } from './styles';
 export interface IconButtonProps extends PressableProps, IButtonProps, IconButtonVariantProps {
     className?: string;
-    /** CDX icon component to render (icon-only control). */
-    as: CdxIcon;
+    /** Forge icon component to render (icon-only control). */
+    as: ForgeIcon;
     /** Passed through to the underlying `Icon`. */
     iconClassName?: IconProps['className'];
 }

package/lib/typescript/components/IconButton/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/IconButton/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAsC,IAAI,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC7F,OAAO,EAGL,KAAK,YAAY,EAElB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EACL,KAAK,sBAAsB,EAI5B,MAAM,UAAU,CAAC;AA2BlB,MAAM,WAAW,eAAgB,SAAQ,cAAc,EAAE,YAAY,EAAE,sBAAsB;IAC3F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,EAAE,EAAE,OAAO,CAAC;IACZ,+CAA+C;IAC/C,aAAa,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;CACxC;AAyCD,eAAO,MAAM,UAAU,kGAAiB,CAAC;AAEzC,YAAY,EAAE,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/IconButton/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAsC,IAAI,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC7F,OAAO,EAGL,KAAK,YAAY,EAElB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EACL,KAAK,sBAAsB,EAI5B,MAAM,UAAU,CAAC;AA2BlB,MAAM,WAAW,eAAgB,SAAQ,cAAc,EAAE,YAAY,EAAE,sBAAsB;IAC3F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,EAAE,EAAE,SAAS,CAAC;IACd,+CAA+C;IAC/C,aAAa,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;CACxC;AAyCD,eAAO,MAAM,UAAU,kGAAiB,CAAC;AAEzC,YAAY,EAAE,sBAAsB,EAAE,CAAC"}

package/lib/typescript/metro/withCdxMetroConfig.d.ts

@@ -1,19 +1,5 @@
-import type { MetroConfig } from 'metro-config';
-export interface CdxMetroConfigOptions {
-    /** Path to the CSS entry file (e.g., `'./global.css'`). */
-    cssEntryFile: string;
-    /** Path where generated Tailwind class type definitions are written. */
-    generatedTypesFile?: string;
-}
-/**
- * Wraps a Metro config with CDX UI's styling-layer configuration.
- *
- * Today this delegates to Uniwind. If the styling layer is swapped (see
- * `docs/research/uniwind-to-nativewind-contingency.md`), only the internals
- * of this function change — consuming Metro configs stay the same.
- *
- * Must be the **outermost** Metro config wrapper (after any other wrappers
- * like `withStorybook`).
- */
-export declare function withCdxMetroConfig<T extends MetroConfig>(config: T, options: CdxMetroConfigOptions): T;
+/** @deprecated Use `withForgeMetroConfig` instead. Will be removed in a future major release. */
+export { withForgeMetroConfig as withCdxMetroConfig } from './withForgeMetroConfig';
+/** @deprecated Use `ForgeMetroConfigOptions` instead. Will be removed in a future major release. */
+export type { ForgeMetroConfigOptions as CdxMetroConfigOptions } from './withForgeMetroConfig';
 //# sourceMappingURL=withCdxMetroConfig.d.ts.map

package/lib/typescript/metro/withCdxMetroConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withCdxMetroConfig.d.ts","sourceRoot":"","sources":["../../../src/metro/withCdxMetroConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,WAAW,EACtD,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,qBAAqB,GAC7B,CAAC,CAKH"}
+{"version":3,"file":"withCdxMetroConfig.d.ts","sourceRoot":"","sources":["../../../src/metro/withCdxMetroConfig.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,OAAO,EAAE,oBAAoB,IAAI,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACpF,oGAAoG;AACpG,YAAY,EAAE,uBAAuB,IAAI,qBAAqB,EAAE,MAAM,wBAAwB,CAAC"}

package/lib/typescript/metro/withForgeMetroConfig.d.ts

@@ -0,0 +1,19 @@
+import type { MetroConfig } from 'metro-config';
+export interface ForgeMetroConfigOptions {
+    /** Path to the CSS entry file (e.g., `'./global.css'`). */
+    cssEntryFile: string;
+    /** Path where generated Tailwind class type definitions are written. */
+    generatedTypesFile?: string;
+}
+/**
+ * Wraps a Metro config with Forge UI's styling-layer configuration.
+ *
+ * Today this delegates to Uniwind. If the styling layer is swapped (see
+ * `docs/research/uniwind-to-nativewind-contingency.md`), only the internals
+ * of this function change — consuming Metro configs stay the same.
+ *
+ * Must be the **outermost** Metro config wrapper (after any other wrappers
+ * like `withStorybook`).
+ */
+export declare function withForgeMetroConfig<T extends MetroConfig>(config: T, options: ForgeMetroConfigOptions): T;
+//# sourceMappingURL=withForgeMetroConfig.d.ts.map

package/lib/typescript/metro/withForgeMetroConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withForgeMetroConfig.d.ts","sourceRoot":"","sources":["../../../src/metro/withForgeMetroConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,uBAAuB;IACtC,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,WAAW,EACxD,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,uBAAuB,GAC/B,CAAC,CAKH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cdx-ui/components",
-  "version": "0.0.1-beta.40",
+  "version": "0.0.1-beta.42",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
   "react-native": "src/index.ts",
@@ -16,10 +16,10 @@
     },
     "./styles.css": "./src/styles.css",
     "./metro": {
-      "types": "./lib/typescript/metro/withCdxMetroConfig.d.ts",
-      "require": "./lib/commonjs/metro/withCdxMetroConfig.js",
-      "import": "./lib/module/metro/withCdxMetroConfig.js",
-      "default": "./lib/commonjs/metro/withCdxMetroConfig.js"
+      "types": "./lib/typescript/metro/withForgeMetroConfig.d.ts",
+      "require": "./lib/commonjs/metro/withForgeMetroConfig.js",
+      "import": "./lib/module/metro/withForgeMetroConfig.js",
+      "default": "./lib/commonjs/metro/withForgeMetroConfig.js"
     }
   },
   "files": [
@@ -67,9 +67,9 @@
     "@gorhom/bottom-sheet": "^5.2.6",
     "class-variance-authority": "^0.7.1",
     "uniwind": "1.6.1",
-    "@cdx-ui/primitives": "0.0.1-beta.40",
-    "@cdx-ui/utils": "0.0.1-beta.40",
-    "@cdx-ui/icons": "0.0.1-beta.40"
+    "@cdx-ui/icons": "0.0.1-beta.42",
+    "@cdx-ui/utils": "0.0.1-beta.42",
+    "@cdx-ui/primitives": "0.0.1-beta.42"
   },
   "devDependencies": {
     "@types/react": "*",

package/src/components/Icon/index.tsx

@@ -1,10 +1,10 @@
 import { withUniwind } from 'uniwind';
 import { cn } from '@cdx-ui/utils';
-import type { CdxIcon, CdxIconProps } from '@cdx-ui/icons';
+import type { ForgeIcon, ForgeIconProps } from '@cdx-ui/icons';
 
-export type IconProps = CdxIconProps & {
+export type IconProps = ForgeIconProps & {
   className?: string; // TODO: Why does this need to specified manually?
-  as: CdxIcon;
+  as: ForgeIcon;
 };
 
 function IconImpl({ as: IconComponent, ...props }: IconProps) {
@@ -37,10 +37,10 @@ const StyledIcon = withUniwind(IconImpl, {
  * <Icon as={ArrowRight} className="text-red-500 size-4" />
  * ```
  *
- * @param {CdxIcon} as - The CDX icon component to render.
+ * @param {ForgeIcon} as - The Forge icon component to render.
  * @param {string} className - Utility classes to style the icon using Uniwind.
  * @param {number} size - Icon size (overrides the size class).
- * @param {...CdxIconProps} ...props - Additional icon props passed to the "as" icon.
+ * @param {...ForgeIconProps} ...props - Additional icon props passed to the "as" icon.
  */
 export function Icon({ as: IconComponent, className, ...props }: IconProps) {
   return (

package/src/components/IconButton/index.tsx

@@ -6,7 +6,7 @@ import {
   type IButtonProps,
   useButtonContext,
 } from '@cdx-ui/primitives';
-import type { CdxIcon } from '@cdx-ui/icons';
+import type { ForgeIcon } from '@cdx-ui/icons';
 import { cn } from '@cdx-ui/utils';
 import { Icon, type IconProps } from '../Icon';
 import {
@@ -24,7 +24,7 @@ const IconButtonPrimitive = createButton({
   Icon: View,
 });
 
-function IconButtonGlyph({ as: IconComponent, className }: { as: CdxIcon; className: string }) {
+function IconButtonGlyph({ as: IconComponent, className }: { as: ForgeIcon; className: string }) {
   const { hover, focus, active, disabled, focusVisible } = useButtonContext();
   return (
     <Icon
@@ -43,8 +43,8 @@ function IconButtonGlyph({ as: IconComponent, className }: { as: CdxIcon; classN
 
 export interface IconButtonProps extends PressableProps, IButtonProps, IconButtonVariantProps {
   className?: string;
-  /** CDX icon component to render (icon-only control). */
-  as: CdxIcon;
+  /** Forge icon component to render (icon-only control). */
+  as: ForgeIcon;
   /** Passed through to the underlying `Icon`. */
   iconClassName?: IconProps['className'];
 }

package/src/metro/withCdxMetroConfig.ts

@@ -1,29 +1,4 @@
-import type { MetroConfig } from 'metro-config';
-import { withUniwindConfig } from 'uniwind/metro';
-
-export interface CdxMetroConfigOptions {
-  /** Path to the CSS entry file (e.g., `'./global.css'`). */
-  cssEntryFile: string;
-  /** Path where generated Tailwind class type definitions are written. */
-  generatedTypesFile?: string;
-}
-
-/**
- * Wraps a Metro config with CDX UI's styling-layer configuration.
- *
- * Today this delegates to Uniwind. If the styling layer is swapped (see
- * `docs/research/uniwind-to-nativewind-contingency.md`), only the internals
- * of this function change — consuming Metro configs stay the same.
- *
- * Must be the **outermost** Metro config wrapper (after any other wrappers
- * like `withStorybook`).
- */
-export function withCdxMetroConfig<T extends MetroConfig>(
-  config: T,
-  options: CdxMetroConfigOptions,
-): T {
-  return withUniwindConfig(config, {
-    cssEntryFile: options.cssEntryFile,
-    dtsFile: options.generatedTypesFile,
-  }) as T;
-}
+/** @deprecated Use `withForgeMetroConfig` instead. Will be removed in a future major release. */
+export { withForgeMetroConfig as withCdxMetroConfig } from './withForgeMetroConfig';
+/** @deprecated Use `ForgeMetroConfigOptions` instead. Will be removed in a future major release. */
+export type { ForgeMetroConfigOptions as CdxMetroConfigOptions } from './withForgeMetroConfig';

package/src/metro/withForgeMetroConfig.ts

@@ -0,0 +1,29 @@
+import type { MetroConfig } from 'metro-config';
+import { withUniwindConfig } from 'uniwind/metro';
+
+export interface ForgeMetroConfigOptions {
+  /** Path to the CSS entry file (e.g., `'./global.css'`). */
+  cssEntryFile: string;
+  /** Path where generated Tailwind class type definitions are written. */
+  generatedTypesFile?: string;
+}
+
+/**
+ * Wraps a Metro config with Forge UI's styling-layer configuration.
+ *
+ * Today this delegates to Uniwind. If the styling layer is swapped (see
+ * `docs/research/uniwind-to-nativewind-contingency.md`), only the internals
+ * of this function change — consuming Metro configs stay the same.
+ *
+ * Must be the **outermost** Metro config wrapper (after any other wrappers
+ * like `withStorybook`).
+ */
+export function withForgeMetroConfig<T extends MetroConfig>(
+  config: T,
+  options: ForgeMetroConfigOptions,
+): T {
+  return withUniwindConfig(config, {
+    cssEntryFile: options.cssEntryFile,
+    dtsFile: options.generatedTypesFile,
+  }) as T;
+}

package/src/styles/primitives.ts

@@ -1,5 +1,5 @@
 // packages/components/src/styles/primitives.ts
-// Semantic constants for CDX UI component styling.
+// Semantic constants for Forge UI component styling.
 
 // ─── Colors ──────────────────────────────────────────────
 // Surface & background