@nimbus-ds/typings 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 This package is intended for internal use in creating components with polymorphic typing.
 
+## 2025-07-29 `1.3.0`
+
+#### 🎉 New features
+
+- Added `SVGElementProps` type to support SVG element props in gradient applications and icon components. ([#321](https://github.com/TiendaNube/nimbus-design-system/pull/321) by [@joacotornello](https://github.com/joacotornello))
+
+## 2025-03-20 `1.2.1`
+
+#### 🐛 Bug fixes
+
+- Rebuild after failed release. ([#277](https://github.com/TiendaNube/nimbus-design-system/pull/277) by [@joacotornello](https://github.com/joacotornello))
+
 ## 2025-03-18 `1.2.0`
 
 #### 🎉 New features

package/dist/CHANGELOG.md

@@ -0,0 +1,37 @@
+# Changelog
+
+This package is intended for internal use in creating components with polymorphic typing.
+
+## 2025-07-29 `1.3.0`
+
+#### 🎉 New features
+
+- Added `SVGElementProps` type to support SVG element props in gradient applications and icon components. ([#321](https://github.com/TiendaNube/nimbus-design-system/pull/321) by [@joacotornello](https://github.com/joacotornello))
+
+## 2025-03-20 `1.2.1`
+
+#### 🐛 Bug fixes
+
+- Rebuild after failed release. ([#277](https://github.com/TiendaNube/nimbus-design-system/pull/277) by [@joacotornello](https://github.com/joacotornello))
+
+## 2025-03-18 `1.2.0`
+
+#### 🎉 New features
+
+- Adds `use-client` directive to the build output in order to support NextJS applications. ([#276](https://github.com/TiendaNube/nimbus-design-system/pull/276) by [@joacotornello](https://github.com/joacotornello))
+
+### 💡 Others
+
+- Rebuild after build process changes to add support for modular imports and Server Components. ([#276](https://github.com/TiendaNube/nimbus-design-system/pull/276) by [@joacotornello](https://github.com/joacotornello))
+
+## 2023-03-24 `1.1.0`
+
+### 🎉 New features
+
+- Added useRefObjectAsForwardedRef hook used to sync ref object with forwarded ref and allow local access to instance reference with `.current`. ([#134](https://github.com/TiendaNube/nimbus-design-system/pull/134) by [@juniorconquista](https://github.com/juniorconquista))
+
+## 2023-02-08 `1.0.0`
+
+### 🎉 New features
+
+- Added types that support dynamic typing of polymorphic components. ([#81](https://github.com/TiendaNube/nimbus-design-system/pull/81) by [@juniorconquista](https://github.com/juniorconquista))

package/dist/README.md

@@ -0,0 +1,17 @@
+# `@nimbus-ds/typings`
+
+[![@nimbus-ds/typings](https://img.shields.io/npm/v/@nimbus-ds/typings?label=%40nimbus-ds%2Ftypings)](https://www.npmjs.com/package/@nimbus-ds/typings)
+
+This package is intended for internal use in creating components with polymorphic typing.
+
+## Installation
+
+```sh
+$ yarn add @nimbus-ds/typings
+# or
+$ npm install @nimbus-ds/typings
+```
+
+## Usage
+
+This is an internal utility, not intended for public usage.

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+// Generated by dts-bundle-generator v7.2.0
+
+import React from 'react';
+import { ForwardedRef, ReactNode, RefObject } from 'react';
+
+export type Merge<P1 = {}, P2 = {}> = Omit<P1, keyof P2> & P2;
+/**
+ * Properties for SVG elements including common attributes and flexible extension.
+ * Used for typing SVG element props in gradient applications and icon components.
+ */
+export type SVGElementProps = {
+	fill?: string;
+	stroke?: string;
+	children?: ReactNode;
+	[key: string]: unknown;
+};
+/**
+ * Infers the OwnProps if E is a ForwardRefExoticComponentWithAs
+ */
+export type OwnProps<E> = E extends PolymorphicForwardRefComponent<any, infer P> ? P : {};
+/**
+ * Infers the JSX.IntrinsicElement if E is a ForwardRefExoticComponentWithAs
+ */
+export type IntrinsicElement<E> = E extends PolymorphicForwardRefComponent<infer I, any> ? I : never;
+export type ForwardRefExoticComponent<E, OwnProps> = React.ForwardRefExoticComponent<Merge<E extends React.ElementType ? React.ComponentPropsWithRef<E> : never, OwnProps & {
+	as?: E;
+}>>;
+export interface PolymorphicForwardRefComponent<IntrinsicElementString, OwnProps = {}
+/**
+ * Extends original type to ensure built in React types play nice
+ * with polymorphic components still e.g. `React.ElementRef` etc.
+ */
+> extends ForwardRefExoticComponent<IntrinsicElementString, OwnProps> {
+	/**
+	 * When `as` prop is passed, use this overload.
+	 * Merges original own props (without DOM props) and the inferred props
+	 * from `as` element with the own props taking precendence.
+	 *
+	 * We explicitly avoid `React.ElementType` and manually narrow the prop types
+	 * so that events are typed when using JSX.IntrinsicElements.
+	 */
+	<As = IntrinsicElementString>(props: As extends "" ? {
+		as: keyof JSX.IntrinsicElements;
+	} : As extends React.ComponentType<infer P> ? Merge<P, OwnProps & {
+		as: As;
+	}> : As extends keyof JSX.IntrinsicElements ? Merge<JSX.IntrinsicElements[As], OwnProps & {
+		as: As;
+	}> : never): React.ReactElement | null;
+}
+/**
+ * Use a ref object as the imperative handle for a forwarded ref. This can be used to
+ * synchronize the ref object with the forwarded ref and allow local access the reference
+ * instance with `.current`.
+ *
+ * **NOTE**: The `refObject` should be passed to the underlying element, NOT the `forwardedRef`.
+ */
+export declare function useRefObjectAsForwardedRef<T>(forwardedRef: ForwardedRef<T>, refObject: RefObject<T>): void;
+
+export {};

package/dist/index.js

@@ -0,0 +1,2 @@
+"use client";
+!function(e,r){"object"==typeof exports&&"object"==typeof module?module.exports=r(require("react")):"function"==typeof define&&define.amd?define(["react"],r):"object"==typeof exports?exports["@nimbus-ds/typings"]=r(require("react")):e["@nimbus-ds/typings"]=r(e.react)}(global,(e=>(()=>{"use strict";var r={155:r=>{r.exports=e}},t={};function o(e){var s=t[e];if(void 0!==s)return s.exports;var n=t[e]={exports:{}};return r[e](n,n.exports,o),n.exports}var s={};return(()=>{var e=s;Object.defineProperty(e,"__esModule",{value:!0}),e.useRefObjectAsForwardedRef=void 0;const r=o(155);e.useRefObjectAsForwardedRef=function(e,t){(0,r.useImperativeHandle)(e,(()=>t.current))}})(),s})()));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nimbus-ds/typings",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "license": "MIT",
   "main": "dist/index.js",
   "files": [
@@ -22,6 +22,6 @@
     "url": "https://github.com/TiendaNube/nimbus-design-system/issues"
   },
   "devDependencies": {
-    "@nimbus-ds/webpack": "^1.5.0"
+    "@nimbus-ds/webpack": "^1.5.1"
   }
 }