@yahoo/uds-icons 2.33.0-beta.1 → 2.33.0-beta.2

package/dist/types.d.cts

@@ -17,7 +17,7 @@ interface SvgIconProps {
   variant?: IconVariant;
 }
 interface InternalSvgIconProps extends SvgIconProps {
-  /** Internal metadata carried on generated icon elements for server-safe reads. */
+  /** Internal metadata carried on icon elements for server-safe reads. */
   __iconMetadata?: IconMetadata;
 }
 type IconElement = React.ReactElement<InternalSvgIconProps> & {

package/dist/types.d.ts

@@ -17,7 +17,7 @@ interface SvgIconProps {
   variant?: IconVariant;
 }
 interface InternalSvgIconProps extends SvgIconProps {
-  /** Internal metadata carried on generated icon elements for server-safe reads. */
+  /** Internal metadata carried on icon elements for server-safe reads. */
   __iconMetadata?: IconMetadata;
 }
 type IconElement = React.ReactElement<InternalSvgIconProps> & {

package/dist/utils.cjs

@@ -1,8 +1,17 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let react = require("react");
 
 //#region src/utils.ts
+function isIconElement(icon) {
+	return (0, react.isValidElement)(icon) && Boolean(icon.props?.__iconMetadata?.isSvgIcon);
+}
+function assertIsIconElement(icon) {
+	if (!isIconElement(icon)) throw new TypeError("Expected IconElement");
+}
 const getIconVariants = (icon) => icon.props.__iconMetadata?.variants ?? [];
 
 //#endregion
-exports.getIconVariants = getIconVariants;
+exports.assertIsIconElement = assertIsIconElement;
+exports.getIconVariants = getIconVariants;
+exports.isIconElement = isIconElement;

package/dist/utils.d.cts

@@ -2,7 +2,9 @@
 import { IconElement, IconVariant } from "./types.cjs";
 
 //#region src/utils.d.ts
+declare function isIconElement(icon: unknown): icon is IconElement;
+declare function assertIsIconElement(icon: unknown): asserts icon is IconElement;
 declare const getIconVariants: (icon: IconElement) => IconVariant[];
 //#endregion
-export { getIconVariants };
+export { assertIsIconElement, getIconVariants, isIconElement };
 //# sourceMappingURL=utils.d.cts.map

package/dist/utils.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.cts","names":[],"sources":["../src/utils.ts"],"mappings":";;;;cAEM,eAAA,GAAmB,IAAA,EAAM,WAAA,KAAc,WAAA"}
+{"version":3,"file":"utils.d.cts","names":[],"sources":["../src/utils.ts"],"mappings":";;;;iBAQS,aAAA,CAAc,IAAA,YAAgB,IAAA,IAAQ,WAAA;AAAA,iBAOtC,mBAAA,CAAoB,IAAA,oBAAwB,IAAA,IAAQ,WAAA;AAAA,cAMvD,eAAA,GAAmB,IAAA,EAAM,WAAA,KAAc,WAAA"}

package/dist/utils.d.ts

@@ -2,7 +2,9 @@
 import { IconElement, IconVariant } from "./types.js";
 
 //#region src/utils.d.ts
+declare function isIconElement(icon: unknown): icon is IconElement;
+declare function assertIsIconElement(icon: unknown): asserts icon is IconElement;
 declare const getIconVariants: (icon: IconElement) => IconVariant[];
 //#endregion
-export { getIconVariants };
+export { assertIsIconElement, getIconVariants, isIconElement };
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","names":[],"sources":["../src/utils.ts"],"mappings":";;;;cAEM,eAAA,GAAmB,IAAA,EAAM,WAAA,KAAc,WAAA"}
+{"version":3,"file":"utils.d.ts","names":[],"sources":["../src/utils.ts"],"mappings":";;;;iBAQS,aAAA,CAAc,IAAA,YAAgB,IAAA,IAAQ,WAAA;AAAA,iBAOtC,mBAAA,CAAoB,IAAA,oBAAwB,IAAA,IAAQ,WAAA;AAAA,cAMvD,eAAA,GAAmB,IAAA,EAAM,WAAA,KAAc,WAAA"}

package/dist/utils.js

@@ -1,7 +1,15 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { isValidElement } from "react";
+
 //#region src/utils.ts
+function isIconElement(icon) {
+	return isValidElement(icon) && Boolean(icon.props?.__iconMetadata?.isSvgIcon);
+}
+function assertIsIconElement(icon) {
+	if (!isIconElement(icon)) throw new TypeError("Expected IconElement");
+}
 const getIconVariants = (icon) => icon.props.__iconMetadata?.variants ?? [];
 
 //#endregion
-export { getIconVariants };
+export { assertIsIconElement, getIconVariants, isIconElement };
 //# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":[],"sources":["../src/utils.ts"],"sourcesContent":["import type { IconElement, IconVariant } from './types';\n\nconst getIconVariants = (icon: IconElement): IconVariant[] =>\n  icon.props.__iconMetadata?.variants ?? [];\n\nexport { getIconVariants };\n"],"mappings":";;AAEA,MAAM,mBAAmB,SACvB,KAAK,MAAM,gBAAgB,YAAY,EAAE"}
+{"version":3,"file":"utils.js","names":[],"sources":["../src/utils.ts"],"sourcesContent":["import { isValidElement } from 'react';\n\nimport type { IconElement, IconMetadata, IconVariant } from './types';\n\ntype IconElementProps = {\n  __iconMetadata?: IconMetadata;\n};\n\nfunction isIconElement(icon: unknown): icon is IconElement {\n  return (\n    isValidElement(icon) &&\n    Boolean((icon.props as IconElementProps | undefined)?.__iconMetadata?.isSvgIcon)\n  );\n}\n\nfunction assertIsIconElement(icon: unknown): asserts icon is IconElement {\n  if (!isIconElement(icon)) {\n    throw new TypeError('Expected IconElement');\n  }\n}\n\nconst getIconVariants = (icon: IconElement): IconVariant[] =>\n  icon.props.__iconMetadata?.variants ?? [];\n\nexport { assertIsIconElement, getIconVariants, isIconElement };\n"],"mappings":";;;;AAQA,SAAS,cAAc,MAAoC;AACzD,QACE,eAAe,KAAK,IACpB,QAAS,KAAK,OAAwC,gBAAgB,UAAU;;AAIpF,SAAS,oBAAoB,MAA4C;AACvE,KAAI,CAAC,cAAc,KAAK,CACtB,OAAM,IAAI,UAAU,uBAAuB;;AAI/C,MAAM,mBAAmB,SACvB,KAAK,MAAM,gBAAgB,YAAY,EAAE"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yahoo/uds-icons",
   "description": "Yahoo Universal System Icons",
-  "version": "2.33.0-beta.1",
+  "version": "2.33.0-beta.2",
   "type": "module",
   "files": [
     "assets/**",