@contember/utilities 1.2.0-rc.9 → 1.2.1

package/src/css-utilities/px.ts

@@ -12,5 +12,5 @@ export function px<V extends number | false | null | undefined>(value?: V): stri
  * @returns Returns a string in the format '10px' or '' when value is falsy.
  */
 export function px<V extends number | false | null | undefined>(value?: V): string {
-	return typeof value === 'number' && !isNaN(value) ? value + 'px' : ''
+	return typeof value === 'number' && !(isNaN(value) || value === Infinity || value === -Infinity) ? value + 'px' : ''
 }

package/src/deprecate/deprecate.ts

@@ -5,7 +5,7 @@ import { SemverString } from './types'
  * @internal
  *
  * @param removal - Version when the deprecated feature will be removed
- * @param assertion - Condition that must be true to avoid the deprecation warning
+ * @param condition - Condition under which the deprecation warning will be logged
  * @param deprecated - Name of the deprecated feature
  * @param replacement - Name of the feature that replaces the deprecated feature
  *
@@ -16,15 +16,15 @@ import { SemverString } from './types'
  * // Logs: Use of "default" is deprecated and might be removed in the next release. Use "hidden" instead.
  * ```
  */
-export function deprecate(removal: SemverString, assertion: boolean, deprecated: string, replacement: string): void {
-	if (assertion === false) {
+export function deprecate(removal: SemverString, condition: boolean, deprecated: string, replacement: string | null): void {
+	if (condition === true) {
 		if (import.meta.env.DEV) {
 			const shouldThrow = Boolean(import.meta.env.VITE_CONTEMBER_ADMIN_STRICT_DEPRECATIONS)
 
 			if (shouldThrow) {
-				throw new Error(`Support for ${deprecated} was planned to be removed in the ${removal} release. Replace it with ${replacement} instead.`)
+				throw new Error(`Support for ${deprecated} was planned to be removed in the ${removal} release.${replacement ? ` Replace it with ${replacement} instead.` : 'Remove it.'}`)
 			} else {
-				console.warn(`Use of ${deprecated} is deprecated and might be removed in the next release. Use ${replacement} instead.`)
+				console.warn(`Use of ${deprecated} is deprecated and might be removed in the next release.${replacement ? ` Use ${replacement} instead.` : 'There is no replacement.'}`)
 			}
 		}
 	}

package/src/deprecate/fallback.ts

@@ -0,0 +1,7 @@
+export function fallback<R>(current: R, condition: boolean, mapped: R): R {
+	if (condition === true) {
+		return mapped
+	} else {
+		return current
+	}
+}

package/src/deprecate/index.ts

@@ -1,3 +1,3 @@
-export * from './currentOrDeprecated'
 export * from './deprecate'
+export * from './fallback'
 export * from './types'

package/src/deprecate/types.ts

@@ -1,2 +1,2 @@
 
-export type SemverString = `${number}.${number}.${number}` | `v${number}.${number}.${number}`
+export type SemverString = `${number}.${number}.${number}`

package/src/functional/extend.ts

@@ -0,0 +1,37 @@
+/** @internal */
+export function extend<B, E>(
+	base: B,
+	extension: E,
+) {
+	base = Object.freeze(base)
+	extension = Object.freeze(extension)
+
+	if (typeof base !== typeof extension) {
+		return extension === undefined ? base : extension
+	} else {
+		if (typeof base === 'object' && typeof extension === 'object') {
+			if (Array.isArray(base) && Array.isArray(extension)) {
+				return Object.freeze([...base, ...extension])
+			} else if (base && extension) {
+				if ('$$typeof' in extension) {
+					return extension
+				}
+
+				const keys = [...new Set([
+					...Object.keys(base),
+					...Object.keys(extension),
+				])]
+
+				const entries: [string, unknown][] = keys.map(
+					key => [key, extend((base as Record<string, unknown>)[key], (extension as Record<string, unknown>)[key])],
+				)
+
+				return Object.freeze(Object.fromEntries(entries))
+			} else {
+				return extension
+			}
+		} else {
+			return extension
+		}
+	}
+}

package/src/functional/index.ts

@@ -1,3 +1,5 @@
+export * from './extend'
 export * from './omit'
 export * from './pick'
+export * from './range'
 export * from './setHasOneOf'

package/src/functional/range.ts

@@ -0,0 +1,11 @@
+
+/**
+ * Get a list of numbers between start and end, inclusive, with the given step size (defaulting to 1)
+ * @param start - The starting number.
+ * @param end - The ending number.
+ * @param step - The step size, optional, defaults to 1.
+ * @returns A list of numbers between start and end, inclusive, with the given step size (defaulting to 1)
+ */
+export function range(start: number, end: number, step = 1): number[] {
+	return Array.from({ length: Math.floor(Math.abs(end - start) / step) + 1 }, (_, i) => start + i * (end > start ? 1 : -1) * Math.abs(step))
+}

package/src/types/Any.ts

@@ -0,0 +1,3 @@
+export type KeyofBase = keyof any;
+export type AnyArray<Type = any> = Array<Type> | ReadonlyArray<Type>;
+export type AnyRecord<T = any> = Record<KeyofBase, T>;

package/src/types/Narrow.ts

@@ -0,0 +1,21 @@
+import { Try } from './Try'
+
+/**
+ * Describes types that can be narrowed
+ */
+export type Narrowable =
+	| string
+	| number
+	| bigint
+	| boolean
+
+
+type NarrowRaw<A> =
+	| (A extends [] ? [] : never)
+	| (A extends Narrowable ? A : never)
+	| ({ [K in keyof A]: A[K] extends Function
+		? A[K]
+		: NarrowRaw<A[K]> })
+
+// eslint-disable-next-line @typescript-eslint/no-unnecessary-type-constraint
+export type Narrow<A extends any> = Try<A, [], NarrowRaw<A>>

package/src/types/PolymorphicRefs.ts

@@ -56,3 +56,13 @@ export type PolymorphicComponentPropsWithRef<
 	C extends React.ElementType,
 	Props = {}
 > = PolymorphicComponentProps<C, Props> & { ref?: PolymorphicRef<C> }
+
+/**
+ * A polymorphic component is a component that can be rendered as different
+ * HTML elements or other React components by specifying the `as` prop.
+ * This type allows for specifying the component (`C`) and the props (`P`)
+ * that the component accepts.
+ */
+export type PolymorphicComponent<T extends React.ElementType, P = {}> =
+	& (<C extends React.ElementType = T>(props: PolymorphicComponentPropsWithRef<C, P>) => React.ReactElement | null)
+	& { displayName?: string | undefined }

package/src/types/index.ts

@@ -3,13 +3,17 @@ export type {
 	DelimiterCase,
 	KebabCase,
 	LiteralToPrimitiveDeep,
+	MergeExclusive,
 	Opaque,
 	PascalCase,
 	Replace,
+	Simplify,
 	UnionToIntersection,
 	UnwrapOpaque,
 } from 'type-fest'
+export * from './Any'
 export * from './DeepPartial'
+export * from './Narrow'
 export * from './NonNullableRequired'
 export * from './NonOptional'
 export * from './ObjectKeyValue'

package/dist/development/deprecate/currentOrDeprecated.js

@@ -1,20 +0,0 @@
-function currentOrDeprecated(current, deprecated, shouldThrow = false) {
-  if (deprecated !== void 0) {
-    if (current !== void 0 && false) {
-      console.error("Current value:", current);
-      console.error("Deprecated value:", deprecated);
-      if (shouldThrow) {
-        throw new Error(`You are using deprecated together with current value which is mutually exclusive. Use only one of them.`);
-      } else {
-        console.error(`You are using deprecated together with current value which is mutually exclusive. Use only one of them.`);
-      }
-    }
-    return deprecated;
-  } else {
-    return current;
-  }
-}
-export {
-  currentOrDeprecated
-};
-//# sourceMappingURL=currentOrDeprecated.js.map

package/dist/development/deprecate/currentOrDeprecated.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"currentOrDeprecated.js","sources":["../../../src/deprecate/currentOrDeprecated.ts"],"sourcesContent":["/**\n * Resolves current or deprecated value. If both are defined, it will throw an error in development mode.\n *\n * @internal\n *\n * Errors are thrown only in development mode. In production mode, the deprecated value is returned.\n *\n * @param current - Current value that replaces deprecated value\n * @param deprecated - Deprecated value that will be removed in the next release\n * @param shouldThrow - Whether to throw an error if both current and deprecated are defined\n * @returns Deprecated value if it is defined, otherwise current value\n * @throws Error if both current and deprecated are defined\n *\n * @example\n * ```ts\n * const current = 'current'\n * const deprecated = 'deprecated'\n *\n * const value = currentOrDeprecated(current, deprecated)\n *\n * console.log(value) // 'deprecated'\n * ```\n *\n * @example\n * ```ts\n * const current = 'current'\n * const deprecated = undefined\n *\n * const value = currentOrDeprecated(current, deprecated)\n *\n * console.log(value) // 'current'\n * ```\n */\nexport function currentOrDeprecated<R, D>(current: R, deprecated: D, shouldThrow: boolean = false): R | D {\n\tif (deprecated !== undefined) {\n\t\tif (current !== undefined && import.meta.env.DEV) {\n\t\t\tconsole.error('Current value:', current)\n\t\t\tconsole.error('Deprecated value:', deprecated)\n\n\t\t\tif (shouldThrow) {\n\t\t\t\tthrow new Error(`You are using deprecated together with current value which is mutually exclusive. Use only one of them.`)\n\t\t\t} else {\n\t\t\t\tconsole.error(`You are using deprecated together with current value which is mutually exclusive. Use only one of them.`)\n\t\t\t}\n\t\t}\n\n\t\treturn deprecated\n\t} else {\n\t\treturn current\n\t}\n}\n"],"names":[],"mappings":"AAiCO,SAAS,oBAA0B,SAAY,YAAe,cAAuB,OAAc;AACzG,MAAI,eAAe,QAAW;AAC7B,QAAI,YAAY,UAAa,OAAqB;AACzC,cAAA,MAAM,kBAAkB,OAAO;AAC/B,cAAA,MAAM,qBAAqB,UAAU;AAE7C,UAAI,aAAa;AACV,cAAA,IAAI,MAAM,yGAAyG;AAAA,MAAA,OACnH;AACN,gBAAQ,MAAM,yGAAyG;AAAA,MACxH;AAAA,IACD;AAEO,WAAA;AAAA,EAAA,OACD;AACC,WAAA;AAAA,EACR;AACD;"}

package/dist/production/deprecate/currentOrDeprecated.js

@@ -1,20 +0,0 @@
-function currentOrDeprecated(current, deprecated, shouldThrow = false) {
-  if (deprecated !== void 0) {
-    if (current !== void 0 && false) {
-      console.error("Current value:", current);
-      console.error("Deprecated value:", deprecated);
-      if (shouldThrow) {
-        throw new Error(`You are using deprecated together with current value which is mutually exclusive. Use only one of them.`);
-      } else {
-        console.error(`You are using deprecated together with current value which is mutually exclusive. Use only one of them.`);
-      }
-    }
-    return deprecated;
-  } else {
-    return current;
-  }
-}
-export {
-  currentOrDeprecated
-};
-//# sourceMappingURL=currentOrDeprecated.js.map

package/dist/production/deprecate/currentOrDeprecated.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"currentOrDeprecated.js","sources":["../../../src/deprecate/currentOrDeprecated.ts"],"sourcesContent":["/**\n * Resolves current or deprecated value. If both are defined, it will throw an error in development mode.\n *\n * @internal\n *\n * Errors are thrown only in development mode. In production mode, the deprecated value is returned.\n *\n * @param current - Current value that replaces deprecated value\n * @param deprecated - Deprecated value that will be removed in the next release\n * @param shouldThrow - Whether to throw an error if both current and deprecated are defined\n * @returns Deprecated value if it is defined, otherwise current value\n * @throws Error if both current and deprecated are defined\n *\n * @example\n * ```ts\n * const current = 'current'\n * const deprecated = 'deprecated'\n *\n * const value = currentOrDeprecated(current, deprecated)\n *\n * console.log(value) // 'deprecated'\n * ```\n *\n * @example\n * ```ts\n * const current = 'current'\n * const deprecated = undefined\n *\n * const value = currentOrDeprecated(current, deprecated)\n *\n * console.log(value) // 'current'\n * ```\n */\nexport function currentOrDeprecated<R, D>(current: R, deprecated: D, shouldThrow: boolean = false): R | D {\n\tif (deprecated !== undefined) {\n\t\tif (current !== undefined && import.meta.env.DEV) {\n\t\t\tconsole.error('Current value:', current)\n\t\t\tconsole.error('Deprecated value:', deprecated)\n\n\t\t\tif (shouldThrow) {\n\t\t\t\tthrow new Error(`You are using deprecated together with current value which is mutually exclusive. Use only one of them.`)\n\t\t\t} else {\n\t\t\t\tconsole.error(`You are using deprecated together with current value which is mutually exclusive. Use only one of them.`)\n\t\t\t}\n\t\t}\n\n\t\treturn deprecated\n\t} else {\n\t\treturn current\n\t}\n}\n"],"names":[],"mappings":"AAiCO,SAAS,oBAA0B,SAAY,YAAe,cAAuB,OAAc;AACzG,MAAI,eAAe,QAAW;AAC7B,QAAI,YAAY,UAAa,OAAqB;AACzC,cAAA,MAAM,kBAAkB,OAAO;AAC/B,cAAA,MAAM,qBAAqB,UAAU;AAE7C,UAAI,aAAa;AACV,cAAA,IAAI,MAAM,yGAAyG;AAAA,MAAA,OACnH;AACN,gBAAQ,MAAM,yGAAyG;AAAA,MACxH;AAAA,IACD;AAEO,WAAA;AAAA,EAAA,OACD;AACC,WAAA;AAAA,EACR;AACD;"}

package/dist/types/deprecate/currentOrDeprecated.d.ts

@@ -1,35 +0,0 @@
-/**
- * Resolves current or deprecated value. If both are defined, it will throw an error in development mode.
- *
- * @internal
- *
- * Errors are thrown only in development mode. In production mode, the deprecated value is returned.
- *
- * @param current - Current value that replaces deprecated value
- * @param deprecated - Deprecated value that will be removed in the next release
- * @param shouldThrow - Whether to throw an error if both current and deprecated are defined
- * @returns Deprecated value if it is defined, otherwise current value
- * @throws Error if both current and deprecated are defined
- *
- * @example
- * ```ts
- * const current = 'current'
- * const deprecated = 'deprecated'
- *
- * const value = currentOrDeprecated(current, deprecated)
- *
- * console.log(value) // 'deprecated'
- * ```
- *
- * @example
- * ```ts
- * const current = 'current'
- * const deprecated = undefined
- *
- * const value = currentOrDeprecated(current, deprecated)
- *
- * console.log(value) // 'current'
- * ```
- */
-export declare function currentOrDeprecated<R, D>(current: R, deprecated: D, shouldThrow?: boolean): R | D;
-//# sourceMappingURL=currentOrDeprecated.d.ts.map

package/dist/types/deprecate/currentOrDeprecated.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"currentOrDeprecated.d.ts","sourceRoot":"","sources":["../../../src/deprecate/currentOrDeprecated.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,GAAE,OAAe,GAAG,CAAC,GAAG,CAAC,CAiBxG"}

package/src/deprecate/currentOrDeprecated.ts

@@ -1,51 +0,0 @@
-/**
- * Resolves current or deprecated value. If both are defined, it will throw an error in development mode.
- *
- * @internal
- *
- * Errors are thrown only in development mode. In production mode, the deprecated value is returned.
- *
- * @param current - Current value that replaces deprecated value
- * @param deprecated - Deprecated value that will be removed in the next release
- * @param shouldThrow - Whether to throw an error if both current and deprecated are defined
- * @returns Deprecated value if it is defined, otherwise current value
- * @throws Error if both current and deprecated are defined
- *
- * @example
- * ```ts
- * const current = 'current'
- * const deprecated = 'deprecated'
- *
- * const value = currentOrDeprecated(current, deprecated)
- *
- * console.log(value) // 'deprecated'
- * ```
- *
- * @example
- * ```ts
- * const current = 'current'
- * const deprecated = undefined
- *
- * const value = currentOrDeprecated(current, deprecated)
- *
- * console.log(value) // 'current'
- * ```
- */
-export function currentOrDeprecated<R, D>(current: R, deprecated: D, shouldThrow: boolean = false): R | D {
-	if (deprecated !== undefined) {
-		if (current !== undefined && import.meta.env.DEV) {
-			console.error('Current value:', current)
-			console.error('Deprecated value:', deprecated)
-
-			if (shouldThrow) {
-				throw new Error(`You are using deprecated together with current value which is mutually exclusive. Use only one of them.`)
-			} else {
-				console.error(`You are using deprecated together with current value which is mutually exclusive. Use only one of them.`)
-			}
-		}
-
-		return deprecated
-	} else {
-		return current
-	}
-}