@contember/utilities 2.0.0-alpha.19 → 2.0.0-alpha.20

package/src/functional/range.ts

@@ -1,11 +0,0 @@
-
-/**
- * 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/string-utilities/index.ts

@@ -1 +0,0 @@
-export * from './kebabCase'

package/src/string-utilities/kebabCase.ts

@@ -1,5 +0,0 @@
-const UPPER_CASE_REG_EXP = /([A-Z])/g
-
-export function toKebabCase(value: string) {
-	return value.replace(UPPER_CASE_REG_EXP, '-$1').toLowerCase()
-}

package/src/types/PolymorphicRefs.ts

@@ -1,70 +0,0 @@
-// Source: https://www.benmvp.com/blog/forwarding-refs-polymorphic-react-component-typescript/
-
-// Source: https://github.com/emotion-js/emotion/blob/master/packages/styled-base/types/helper.d.ts
-// A more precise version of just React.ComponentPropsWithoutRef on its own
-import { ReactNode } from 'react'
-
-export type PropsOf<
-	C extends keyof JSX.IntrinsicElements | React.JSXElementConstructor<any>
-> = JSX.LibraryManagedAttributes<C, React.ComponentPropsWithoutRef<C>>
-
-export type AsProp<C extends React.ElementType> = {
-	/**
-	 * An override of the default HTML tag.
-	 * Can also be another React component.
-	 */
-	as?: C
-}
-
-/**
- * Allows for extending a set of props (`ExtendedProps`) by an overriding set of props
- * (`OverrideProps`), ensuring that any duplicates are overridden by the overriding
- * set of props.
- */
-export type ExtendableProps<
-	ExtendedProps = {},
-	OverrideProps = {}
-> = OverrideProps & Omit<ExtendedProps, keyof OverrideProps>
-
-/**
- * Allows for inheriting the props from the specified element type so that
- * props like children, className & style work, as well as element-specific
- * attributes like aria roles. The component (`C`) must be passed in.
- */
-export type InheritableElementProps<
-	C extends React.ElementType,
-	Props = {}
-> = ExtendableProps<PropsOf<C>, Props>
-
-/**
- * A more sophisticated version of `InheritableElementProps` where
- * the passed in `as` prop will determine which props can be included
- */
-export type PolymorphicComponentProps<
-	C extends React.ElementType,
-	Props = {}
-> = InheritableElementProps<C, Props & AsProp<C>>
-
-/**
- * Utility type to extract the `ref` prop from a polymorphic component
- */
-export type PolymorphicRef<C extends React.ElementType> = React.ComponentPropsWithRef<C>['ref']
-
-/**
- * A wrapper of `PolymorphicComponentProps` that also includes the `ref`
- * prop for the polymorphic component
- */
-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>) => ReactNode)
-	& { displayName?: string | undefined }

package/tests/css-utilities/px.test.ts

@@ -1,12 +0,0 @@
-import { describe, expect, test } from 'vitest'
-import { px } from '../../src'
-
-describe('@contember/utilities', function () {
-	test('@contember/utilities.px', function () {
-		expect(px(100)).equals('100px')
-		expect(px(false)).equals('')
-		expect(px(null)).equals('')
-		expect(px(undefined)).equals('')
-		expect(px(NaN)).equals('')
-	})
-})

package/tests/deprecate/deprecate.test.ts

@@ -1,53 +0,0 @@
-import { describe, expect, it, vitest } from 'vitest'
-import { deprecate } from '../../src'
-
-describe('@contember/utilities.deprecate', () => {
-	it('logs a warning if the condition is true', () => {
-		const spy = vitest.spyOn(console, 'warn').mockImplementation(() => { })
-		deprecate('2.0.0', true, 'oldFeature', 'newFeature')
-		expect(spy).toHaveBeenCalledWith('Use of oldFeature is deprecated and might be removed in the next release. Use newFeature instead.')
-		spy.mockRestore()
-	})
-
-	it('throws an error if strict deprecations are enabled and the condition is true', () => {
-		const originalEnv = process.env
-		process.env = { ...originalEnv, VITE_CONTEMBER_ADMIN_STRICT_DEPRECATIONS: 'true' }
-		expect(() => {
-			deprecate('2.0.0', true, 'oldFeature', 'newFeature')
-		}).toThrow('Support for oldFeature was planned to be removed in the 2.0.0 release. Replace it with newFeature instead.')
-		process.env = originalEnv
-	})
-
-	it('does not log a warning if the condition is false', () => {
-		const spy = vitest.spyOn(console, 'warn').mockImplementation(() => { })
-		deprecate('2.0.0', false, 'oldFeature', 'newFeature')
-		expect(spy).not.toHaveBeenCalled()
-		spy.mockRestore()
-	})
-
-	it('does not throw an error if strict deprecations are enabled and the condition is false', () => {
-		const originalEnv = process.env
-		process.env = { ...originalEnv, VITE_CONTEMBER_ADMIN_STRICT_DEPRECATIONS: 'true' }
-		expect(() => {
-			deprecate('2.0.0', false, 'oldFeature', 'newFeature')
-		}).not.toThrow()
-		process.env = originalEnv
-	})
-
-	it('does not log a warning if the condition is true but the environment is not development', () => {
-		const originalEnv = process.env
-		process.env = { ...originalEnv, DEV: '' }
-		const spy = vitest.spyOn(console, 'warn').mockImplementation(() => { })
-		deprecate('2.0.0', true, 'oldFeature', 'newFeature')
-		expect(spy).not.toHaveBeenCalled()
-		spy.mockRestore()
-		process.env = originalEnv
-	})
-
-	it('logs a warning if the condition is true and replacement is null', () => {
-		const spy = vitest.spyOn(console, 'warn').mockImplementation(() => { })
-		deprecate('2.0.0', true, 'oldFeature', null)
-		expect(spy).toHaveBeenCalledWith('Use of oldFeature is deprecated and might be removed in the next release. There is no replacement.')
-		spy.mockRestore()
-	})
-})

package/tests/functional/omit.test.ts

@@ -1,20 +0,0 @@
-import { describe, expect, test } from 'vitest'
-import { omit } from '../../src'
-
-describe('@contember/utilities', function() {
-	test('@contember/utilities.omit', function() {
-		let obj = {
-			a: 1,
-			b: 2,
-			c: 3,
-			d: 4,
-			e: 5,
-		}
-
-		expect(omit(obj, ['a'])).toEqual({ b: 2, c: 3, d: 4, e: 5 })
-		expect(omit(obj, ['a', 'b'])).toEqual({ c: 3, d: 4, e: 5 })
-		expect(omit(obj, ['a', 'b', 'c'])).toEqual({ d: 4, e: 5 })
-		expect(omit(obj, ['a', 'b', 'c', 'd'])).toEqual({ e: 5 })
-		expect(omit(obj, ['a', 'b', 'c', 'd', 'e'])).toEqual({})
-	})
-})

package/tests/functional/pick.test.ts

@@ -1,12 +0,0 @@
-import { describe, expect, test } from 'vitest'
-import { pick } from '../../src'
-
-describe('@contember/utilities', function () {
-	test('@contember/utilities.pick', function () {
-		const from = { a: 1, b: 2 }
-
-		expect(pick(from, ['a'])).toEqual({ a: 1 })
-		// @ts-expect-error - 'c' does not exist in { a: 1, b: 2 }
-		expect(() => pick(from, ['c'])).throws('Key "c" does not exist in object {"a":1,"b":2}')
-	})
-})

package/tests/functional/range.test.ts

@@ -1,12 +0,0 @@
-import { describe, expect, test } from 'vitest'
-import { range } from '../../src'
-
-describe('@contember/utilities', function () {
-	test('@contember/utilities.range', function () {
-		expect(range(1, 1)).toEqual([1])
-		expect(range(1, 4)).toEqual([1, 2, 3, 4])
-		expect(range(0, 4, 2)).toEqual([0, 2, 4])
-		expect(range(5, 2)).toEqual([5, 4, 3, 2])
-		expect(range(5, 2, 2)).toEqual([5, 3])
-	})
-})