@zag-js/utils 0.9.1 → 0.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zag-js/utils",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "description": "",
   "keywords": [
     "js",
@@ -13,7 +13,8 @@
   "repository": "https://github.com/chakra-ui/zag/tree/main/packages/utilities/core",
   "sideEffects": false,
   "files": [
-    "dist/**/*"
+    "dist",
+    "src"
   ],
   "publishConfig": {
     "access": "public"

package/src/array.ts

@@ -0,0 +1,66 @@
+export function toArray<T>(v: T | T[] | undefined | null): T[] {
+  if (!v) return []
+  return Array.isArray(v) ? v : [v]
+}
+
+export const fromLength = (length: number) => Array.from(Array(length).keys())
+
+export const first = <T>(v: T[]): T | undefined => v[0]
+
+export const last = <T>(v: T[]): T | undefined => v[v.length - 1]
+
+export const isEmpty = <T>(v: T[]): boolean => v.length === 0
+
+export const has = <T>(v: T[], t: any): boolean => v.indexOf(t) !== -1
+
+export const add = <T>(v: T[], ...items: T[]): T[] => v.concat(items)
+
+export const remove = <T>(v: T[], item: T): T[] => removeAt(v, v.indexOf(item))
+
+export const removeAt = <T>(v: T[], i: number): T[] => {
+  if (i > -1) v.splice(i, 1)
+  return v
+}
+
+export function clear<T>(v: T[]): T[] {
+  while (v.length > 0) v.pop()
+  return v
+}
+
+export type IndexOptions = {
+  step?: number
+  loop?: boolean
+}
+
+export function nextIndex<T>(v: T[], idx: number, opts: IndexOptions = {}): number {
+  const { step = 1, loop = true } = opts
+  const next = idx + step
+  const len = v.length
+  const last = len - 1
+  if (idx === -1) return step > 0 ? 0 : last
+  if (next < 0) return loop ? last : 0
+  if (next >= len) return loop ? 0 : idx > len ? len : idx
+  return next
+}
+
+export function next<T>(v: T[], idx: number, opts: IndexOptions = {}): T | undefined {
+  return v[nextIndex(v, idx, opts)]
+}
+
+export function prevIndex<T>(v: T[], idx: number, opts: IndexOptions = {}): number {
+  const { step = 1, loop = true } = opts
+  return nextIndex(v, idx, { step: -step, loop })
+}
+
+export function prev<T>(v: T[], index: number, opts: IndexOptions = {}): T | undefined {
+  return v[prevIndex(v, index, opts)]
+}
+
+export const chunk = <T>(v: T[], size: number): T[][] => {
+  const res: T[][] = []
+  return v.reduce((rows, value, index) => {
+    if (index % size === 0) rows.push([value])
+    else last(rows)?.push(value)
+    return rows
+  }, res)
+}

package/src/functions.ts

@@ -0,0 +1,27 @@
+export const runIfFn = <T>(
+  v: T | undefined,
+  ...a: T extends (...a: any[]) => void ? Parameters<T> : never
+): T extends (...a: any[]) => void ? NonNullable<ReturnType<T>> : NonNullable<T> => {
+  const res = typeof v === "function" ? v(...a) : v
+  return res ?? undefined
+}
+
+export const cast = <T>(v: unknown): T => v as T
+
+export const noop = () => {}
+
+export const callAll =
+  <T extends (...a: any[]) => void>(...fns: (T | undefined)[]) =>
+  (...a: Parameters<T>) => {
+    fns.forEach(function (fn) {
+      fn?.(...a)
+    })
+  }
+
+export const uuid = /*#__PURE__*/ (() => {
+  let id = 0
+  return () => {
+    id++
+    return id.toString(36)
+  }
+})()

package/src/guard.ts

@@ -0,0 +1,10 @@
+export const isDev = () => process.env.NODE_ENV !== "production"
+export const isArray = (v: any): v is any[] => Array.isArray(v)
+export const isBoolean = (v: any): v is boolean => v === true || v === false
+export const isObject = (v: any): v is Record<string, any> => !(v == null || typeof v !== "object" || isArray(v))
+export const isNumber = (v: any): v is number => typeof v === "number" && !Number.isNaN(v)
+export const isString = (v: any): v is string => typeof v === "string"
+export const isFunction = (v: any): v is Function => typeof v === "function"
+
+export const hasProp = <T extends string>(obj: any, prop: T): obj is Record<T, any> =>
+  Object.prototype.hasOwnProperty.call(obj, prop)

package/src/index.ts

@@ -0,0 +1,5 @@
+export * from "./array"
+export * from "./functions"
+export * from "./guard"
+export * from "./object"
+export * from "./warning"

package/src/object.ts

@@ -0,0 +1,23 @@
+export function compact<T extends Record<string, unknown> | undefined>(obj: T): T {
+  if (!isPlainObject(obj) || obj === undefined) {
+    return obj
+  }
+
+  const keys = Reflect.ownKeys(obj).filter((key) => typeof key === "string")
+  const filtered: Partial<T> = {}
+  for (const key of keys) {
+    const value = (obj as any)[key]
+    if (value !== undefined) {
+      filtered[key as keyof T] = compact(value)
+    }
+  }
+  return filtered as T
+}
+
+export function json(value: any) {
+  return JSON.parse(JSON.stringify(value))
+}
+
+const isPlainObject = (value: any) => {
+  return value && typeof value === "object" && value.constructor === Object
+}

package/src/warning.ts

@@ -0,0 +1,19 @@
+export function warn(m: string): void
+export function warn(c: boolean, m: string): void
+export function warn(...a: any[]): void {
+  const m = a.length === 1 ? a[0] : a[1]
+  const c = a.length === 2 ? a[0] : true
+  if (c && process.env.NODE_ENV !== "production") {
+    console.warn(m)
+  }
+}
+
+export function invariant(m: string): void
+export function invariant(c: boolean, m: string): void
+export function invariant(...a: any[]): void {
+  const m = a.length === 1 ? a[0] : a[1]
+  const c = a.length === 2 ? a[0] : true
+  if (c && process.env.NODE_ENV !== "production") {
+    throw new Error(m)
+  }
+}