@jadeja/ts 1.0.0-alpha.0 → 1.0.0-alpha.2

package/dist/configs/vite/lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.js","names":[],"sources":["../../../src/configs/vite/lib.ts"],"sourcesContent":["// oxlint-disable import/no-relative-parent-imports\n\nimport { relative, resolve } from \"node:path\";\n\nimport { glob } from \"glob\";\n\nimport { freshRegex } from \"../../lib/operations.ts\";\nimport { extractExtensions } from \"../../lib/utils.ts\";\n\nimport viteBase from \"./base.ts\";\n\nimport type { UserConfig } from \"vite\";\n\n/* ============================================================================================= */\n\nexport interface CreateInputEntriesOptions {\n  /**\n   * `import.meta.dirname`\n   */\n  dirname: string;\n\n  /**\n   * paths to create input entry\n   */\n  entries: string[];\n}\n\nexport const createInputEntries = ({ dirname, entries }: CreateInputEntriesOptions) => {\n  //\n  const paths: Record<string, string> = {};\n\n  for (const entry of entries) {\n    for (const file of glob.sync(entry)) {\n      // 1. get path relative to 'src' (e.g., 'components/button.tsx')\n      // 2. remove the extension\n      const key = relative(\"src\", file).replace(\n        freshRegex(`\\\\.(${extractExtensions(file).join(\"|\")})$`),\n        \"\",\n      );\n\n      // the absolute path to the file\n      const value = resolve(dirname, file);\n\n      paths[key] = value;\n    }\n  }\n\n  return paths;\n};\n\n/* ============================================================================================= */\n\nexport type ViteLib = (options: { peerDependencies: Record<string, string> }) => UserConfig;\n\nexport const viteLib: ViteLib = ({ peerDependencies }) => {\n  //\n\n  return {\n    //\n\n    /* ============================================================================================\n\t\t  BASE\n\t  ============================================================================================ */\n\n    ...viteBase,\n\n    /* ============================================================================================\n      BUILD\n    ============================================================================================ */\n\n    build: {\n      //\n      ...viteBase.build,\n\n      sourcemap: true,\n\n      // mark as library\n      lib: {\n        // using `config.build.rolldownOptions.input`\n        entry: \"\",\n\n        // minify whitespace is disabled for es format\n        // https://vite.dev/config/build-options#build-minify\n        formats: [\"es\"],\n      },\n\n      // tansformer options\n      rolldownOptions: {\n        //\n        ...viteBase.build?.rolldownOptions,\n\n        // force these to be external (don't bundle them)\n        external: [\n          //\n          // @ts-expect-error  iterator issue\n          // oxlint-disable-next-line typescript/no-misused-spread\n          ...(viteBase.build?.rolldownOptions?.external ?? []),\n\n          // exclude all peerDependencies (as strings or Regex)\n          ...Object.keys(peerDependencies).flatMap((dep) => {\n            return [dep, freshRegex(`^${dep}/`)];\n          }),\n        ],\n\n        // input will be added in actual `vite.config.ts`\n        // input: createInputEntries({dirname: import.meta.dirname, entries: []})\n\n        output: {\n          //\n          // oxlint-disable-next-line typescript/no-misused-spread\n          ...viteBase.build?.rolldownOptions?.output,\n\n          preserveModules: true,\n          preserveModulesRoot: \"src\",\n          entryFileNames: \"[name].js\",\n        },\n      },\n    },\n  };\n};\n\n/* ============================================================================================= */\n\nexport default viteLib;\n"],"mappings":";;;;;;AA2BA,IAAa,KAAsB,EAAE,YAAS,iBAAyC;CAErF,IAAM,IAAgC,CAAC;CAEvC,KAAK,IAAM,KAAS,GAClB,KAAK,IAAM,KAAQ,EAAK,KAAK,CAAK,GAAG;EAGnC,IAAM,IAAM,EAAS,OAAO,CAAI,EAAE,QAChC,EAAW,OAAO,EAAkB,CAAI,EAAE,KAAK,GAAG,EAAE,GAAG,GACvD,EACF;EAKA,EAAM,KAFQ,EAAQ,GAAS,CAElB;CACf;CAGF,OAAO;AACT,GAMa,KAAoB,EAAE,2BAG1B;CAOL,GAAG;CAMH,OAAO;EAEL,GAAG,EAAS;EAEZ,WAAW;EAGX,KAAK;GAEH,OAAO;GAIP,SAAS,CAAC,IAAI;EAChB;EAGA,iBAAiB;GAEf,GAAG,EAAS,OAAO;GAGnB,UAAU,CAIR,GAAI,EAAS,OAAO,iBAAiB,YAAY,CAAC,GAGlD,GAAG,OAAO,KAAK,CAAgB,EAAE,SAAS,MACjC,CAAC,GAAK,EAAW,IAAI,EAAI,EAAE,CAAC,CACpC,CACH;GAKA,QAAQ;IAGN,GAAG,EAAS,OAAO,iBAAiB;IAEpC,iBAAiB;IACjB,qBAAqB;IACrB,gBAAgB;GAClB;EACF;CACF;AACF"}

package/dist/lib/debounce.js

@@ -0,0 +1,10 @@
+//#region src/lib/debounce.ts
+var e, t = (t, n = 1e3) => {
+	clearTimeout(e), e = setTimeout(() => {
+		t(), clearTimeout(e);
+	}, n);
+};
+//#endregion
+export { t as default };
+
+//# sourceMappingURL=debounce.js.map

package/dist/lib/debounce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.js","names":[],"sources":["../../src/lib/debounce.ts"],"sourcesContent":["// global variable for this module instance\nlet timer: ReturnType<typeof setTimeout>;\n\n/**\n * prevent duplicate function call in specified time period\n *\n * @param fn - an anonymous function to delay execution\n * @param delay - delay for provided function execution (default `1000` in milliseconds)\n */\nconst debounce = (fn: () => void, delay = 1000) => {\n  //\n  clearTimeout(timer);\n\n  timer = setTimeout(() => {\n    fn();\n    clearTimeout(timer);\n  }, delay);\n};\n\n/* ============================================================================================= */\n\nexport default debounce;\n"],"mappings":";AACA,IAAI,GAQE,KAAY,GAAgB,IAAQ,QAAS;CAIjD,AAFA,aAAa,CAAK,GAElB,IAAQ,iBAAiB;EAEvB,AADA,EAAG,GACH,aAAa,CAAK;CACpB,GAAG,CAAK;AACV"}

package/dist/lib/logger.js

@@ -0,0 +1,15 @@
+//#region src/lib/logger.ts
+var e = (e) => {
+	let t;
+	throw t = e instanceof Error ? e.message : typeof e == "string" ? e : String(e), Error(t);
+}, { log: t } = console, n = (e = "-", n = 50) => {
+	t(e.repeat(n));
+}, r = (e) => {
+	t(`\n${e}\n`);
+}, { warn: i } = console, a = (e) => {
+	i(`\n${e}\n`);
+};
+//#endregion
+export { t as log, n as logDivider, r as logNewLine, e as throwError, i as warn, a as warnNewLine };
+
+//# sourceMappingURL=logger.js.map

package/dist/lib/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","names":[],"sources":["../../src/lib/logger.ts"],"sourcesContent":["/**\n * throws an error with the provided message.\n *\n * @param err - The error message to throw.\n */\nexport const throwError = <T>(err: T) => {\n  //\n  let errMsg: string;\n\n  if (err instanceof Error) {\n    errMsg = err.message;\n  } else if (typeof err === \"string\") {\n    errMsg = err;\n  } else {\n    errMsg = String(err);\n  }\n\n  throw new Error(errMsg);\n};\n\n/* ============================================================================================= */\n\n/**\n * logs a message to the console.\n *\n * @param msg - The message to log.\n */\nexport const { log } = console;\n\n/* ============================================================================================= */\n\n/**\n * logs a divider line to the console.\n *\n * @param divider - The character to use for the divider (default is \"-\").\n * @param count - The number of times to repeat the divider character (default is 50).\n */\nexport const logDivider = (divider = \"-\", count = 50) => {\n  log(divider.repeat(count));\n};\n\n/* ============================================================================================= */\n\n/**\n * logs a new line with an optional message to the console.\n *\n * @param msg - The message to include in the new line (optional).\n */\nexport const logNewLine = <T>(msg?: T) => {\n  log(`\\n${msg}\\n`);\n};\n\n/* ============================================================================================= */\n\n/**\n * logs a warning message to the console.\n *\n * @param msg - The warning message to log.\n */\nexport const { warn } = console;\n\n/* ============================================================================================= */\n\n/**\n * logs a new line with an optional warning message to the console.\n *\n * @param msg - The warning message to include in the new line (optional).\n */\nexport const warnNewLine = <T>(msg?: T) => {\n  warn(`\\n${msg}\\n`);\n};\n"],"mappings":";AAKA,IAAa,KAAiB,MAAW;CAEvC,IAAI;CAUJ,MARA,AAKE,IALE,aAAe,QACR,EAAI,UACJ,OAAO,KAAQ,WACf,IAEA,OAAO,CAAG,GAGX,MAAM,CAAM;AACxB,GASa,EAAE,WAAQ,SAUV,KAAc,IAAU,KAAK,IAAQ,OAAO;CACvD,EAAI,EAAQ,OAAO,CAAK,CAAC;AAC3B,GASa,KAAiB,MAAY;CACxC,EAAI,KAAK,EAAI,GAAG;AAClB,GASa,EAAE,YAAS,SASX,KAAkB,MAAY;CACzC,EAAK,KAAK,EAAI,GAAG;AACnB"}

package/dist/{src/lib → lib}/operations.d.ts

@@ -6,7 +6,7 @@
  *
  * @returns `source` object deep (nested) merge into `target` object.
  *
- * @throws If either `target` or `source` is not an object.
+ * @throws { Error } If either `target` or `source` is not an object.
  */
 export declare const deepMergeObj: <T, U>(target: T, source: U) => T & U;
 /**
@@ -18,7 +18,7 @@ export declare const deepMergeObj: <T, U>(target: T, source: U) => T & U;
  *
  * @returns A deep copy of the input data.
  *
- * @throws If any part of the input data is not serializable.
+ * @throws { Error } If any part of the input data is not serializable.
  */
 export declare const deepCopy: <T>(data: T) => T;
 /**
@@ -37,5 +37,5 @@ export declare const deepCopy: <T>(data: T) => T;
  *
  * @returns A new RegExp instance with identical pattern and flags.
  */
-export declare const freshRegex: (regex: RegExp) => RegExp;
+export declare const freshRegex: (regex: RegExp | string) => RegExp;
 //# sourceMappingURL=operations.d.ts.map

package/dist/{src/lib → lib}/operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../../src/lib/operations.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,UAqBtD,CAAC;AAIF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,MAAM,CAAC,KAAG,CAgBrC,CAAC;AAIF;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,WAAsB,CAAC"}
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../../src/lib/operations.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,UAmBtD,CAAC;AAIF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,MAAM,CAAC,KAAG,CAgBrC,CAAC;AAIF;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,GAAG,MAAM,WAEhD,CAAC"}

package/dist/lib/operations.js

@@ -0,0 +1,21 @@
+import { log as e, throwError as t } from "./logger.js";
+import { isArr as n, isObj as r } from "./types.js";
+//#region src/lib/operations.ts
+var i = (e, n) => {
+	if (!r(e)) return t("target must be an object");
+	if (!r(n)) return t("source must be an object");
+	for (let t in n) t in e && r(e[t]) && r(n[t]) ? i(e[t], n[t]) : e[t] = n[t];
+	return e;
+}, a = (i) => {
+	try {
+		if (r(i)) return { ...structuredClone(i) };
+		if (n(i)) return [...structuredClone(i)];
+	} catch (n) {
+		e("Any part of the input data is not serializable."), t(n);
+	}
+	return i;
+}, o = (e) => new RegExp(e);
+//#endregion
+export { a as deepCopy, i as deepMergeObj, o as freshRegex };
+
+//# sourceMappingURL=operations.js.map

package/dist/lib/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","names":[],"sources":["../../src/lib/operations.ts"],"sourcesContent":["import { log, throwError } from \"./logger.ts\";\nimport { isArr, isObj } from \"./types.ts\";\n\n/* ============================================================================================= */\n\n/**\n * recursively merges the properties of the source object into the target object.\n *\n * @param target - The target object to merge into. Must be an object.\n * @param source - The source object to merge from. Must be an object.\n *\n * @returns `source` object deep (nested) merge into `target` object.\n *\n * @throws { Error } If either `target` or `source` is not an object.\n */\nexport const deepMergeObj = <T, U>(target: T, source: U) => {\n  //\n  if (!isObj(target)) {\n    return throwError(\"target must be an object\");\n  }\n  if (!isObj(source)) {\n    return throwError(\"source must be an object\");\n  }\n\n  for (const key in source) {\n    if (key in (target as never) && isObj((target as never)[key]) && isObj(source[key])) {\n      deepMergeObj<typeof target, typeof source>((target as never)[key], (source as never)[key]);\n    } else {\n      // oxlint-disable-next-line typescript/no-explicit-any, typescript/no-unsafe-member-access\n      (target as any)[key] = source[key];\n    }\n  }\n\n  return target as T & U;\n};\n\n/* ============================================================================================= */\n\n/**\n * creates a deep copy of the given data using `structuredClone`.\n *\n * If the input is not an object or array, the original data is returned.\n *\n * @param data - The data to be copied. Can be an object or array.\n *\n * @returns A deep copy of the input data.\n *\n * @throws { Error } If any part of the input data is not serializable.\n */\nexport const deepCopy = <T>(data: T): T => {\n  //\n  try {\n    //\n    if (isObj(data)) {\n      return { ...structuredClone(data) };\n    } else if (isArr(data)) {\n      return [...structuredClone(data)] as T;\n    }\n    //\n  } catch (error) {\n    log(\"Any part of the input data is not serializable.\");\n    throwError(error);\n  }\n\n  return data;\n};\n\n/* ============================================================================================= */\n\n/**\n * returns a fresh RegExp instance cloned from the provided input. This ensures the internal\n * `lastIndex` state is reset to `0`, making the regex safe to reuse with stateful flags like `g` or\n * `y` across multiple operations (e.g. `test`, `replace`, `exec`), particularly in long-lived\n * runtimes such as HMR or shared modules.\n *\n * The returned RegExp preserves: - pattern source - flags (g, i, m, s, u, y, d, etc.)\n *\n * @example\n *   -fresh(LCH_COLOR_FORMAT_PATTERN).test(rawColor);\n *   -text.replace(fresh(LCH_COLOR_FORMAT_PATTERN), transformer);\n *\n * @param regex - The RegExp instance to clone.\n *\n * @returns A new RegExp instance with identical pattern and flags.\n */\n// reset lastIndex via new instance\nexport const freshRegex = (regex: RegExp | string) => {\n  return new RegExp(regex);\n};\n"],"mappings":";;;AAeA,IAAa,KAAsB,GAAW,MAAc;CAE1D,IAAI,CAAC,EAAM,CAAM,GACf,OAAO,EAAW,0BAA0B;CAE9C,IAAI,CAAC,EAAM,CAAM,GACf,OAAO,EAAW,0BAA0B;CAG9C,KAAK,IAAM,KAAO,GAChB,AAAI,KAAQ,KAAoB,EAAO,EAAiB,EAAI,KAAK,EAAM,EAAO,EAAI,IAChF,EAA4C,EAAiB,IAAO,EAAiB,EAAI,IAGzF,EAAgB,KAAO,EAAO;CAIlC,OAAO;AACT,GAea,KAAe,MAAe;CAEzC,IAAI;EAEF,IAAI,EAAM,CAAI,GACZ,OAAO,EAAE,GAAG,gBAAgB,CAAI,EAAE;EAC7B,IAAI,EAAM,CAAI,GACnB,OAAO,CAAC,GAAG,gBAAgB,CAAI,CAAC;CAGpC,SAAS,GAAO;EAEd,AADA,EAAI,iDAAiD,GACrD,EAAW,CAAK;CAClB;CAEA,OAAO;AACT,GAqBa,KAAc,MAClB,IAAI,OAAO,CAAK"}

package/dist/lib/singleton.d.ts

@@ -0,0 +1,12 @@
+/**
+ * single instance for a unique key
+ */
+export declare class Singleton {
+    private static readonly instances;
+    static get<T extends Singleton>(key: string): T;
+    set<K extends keyof this>(key: K, value: (typeof this)[K]): void;
+    get<K extends keyof this>(key: K): this[K];
+    register<T>(instance: T, method: string): void;
+    registerMethods<T>(instance: T, methods: string[]): void;
+}
+//# sourceMappingURL=singleton.d.ts.map

package/dist/lib/singleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../../../src/lib/singleton.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,SAAS;IAEpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAgC;WAEnD,GAAG,CAAC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC;IAiB/C,GAAG,CAAC,CAAC,SAAS,MAAM,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;IAIzD,GAAG,CAAC,CAAC,SAAS,MAAM,IAAI,EAAE,GAAG,EAAE,CAAC;IAQhC,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM;IASvC,eAAe,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE;CAMzD"}

package/dist/lib/singleton.js

@@ -0,0 +1,25 @@
+//#region src/lib/singleton.ts
+var e = class e {
+	static instances = /* @__PURE__ */ new Map();
+	static get(t) {
+		let n = e.instances.get(t);
+		return n || (n = new this(), e.instances.set(t, n)), n;
+	}
+	set(e, t) {
+		this[e] = t;
+	}
+	get(e) {
+		return this[e];
+	}
+	register(e, t) {
+		let n = e[t];
+		typeof n == "function" && this.set(t, n.bind(this));
+	}
+	registerMethods(e, t) {
+		for (let n of t) this.register(e, n);
+	}
+};
+//#endregion
+export { e as Singleton };
+
+//# sourceMappingURL=singleton.js.map

package/dist/lib/singleton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.js","names":[],"sources":["../../src/lib/singleton.ts"],"sourcesContent":["/**\n * single instance for a unique key\n */\nexport class Singleton {\n  //\n  private static readonly instances = new Map<string, Singleton>();\n\n  public static get<T extends Singleton>(key: string): T {\n    //\n    let instance = Singleton.instances.get(key);\n\n    if (!instance) {\n      instance = new this();\n\n      Singleton.instances.set(key, instance);\n    }\n\n    return instance as T;\n  }\n\n  /* =========================\n\t\tHANDLE PROPERTIES\n\t========================= */\n\n  public set<K extends keyof this>(key: K, value: (typeof this)[K]) {\n    this[key] = value;\n  }\n\n  public get<K extends keyof this>(key: K) {\n    return this[key];\n  }\n\n  /* =========================\n\t\tHANDLE METHODS\n\t========================= */\n\n  public register<T>(instance: T, method: string) {\n    //\n    const fn = instance[method as keyof T];\n\n    if (typeof fn === \"function\") {\n      this.set(method as keyof this, fn.bind(this) as this[keyof this]);\n    }\n  }\n\n  public registerMethods<T>(instance: T, methods: string[]) {\n    for (const method of methods) {\n      //\n      this.register(instance, method);\n    }\n  }\n}\n"],"mappings":";AAGA,IAAa,IAAb,MAAa,EAAU;CAErB,OAAwB,4BAAY,IAAI,IAAuB;CAE/D,OAAc,IAAyB,GAAgB;EAErD,IAAI,IAAW,EAAU,UAAU,IAAI,CAAG;EAQ1C,OANK,MACH,IAAW,IAAI,KAAK,GAEpB,EAAU,UAAU,IAAI,GAAK,CAAQ,IAGhC;CACT;CAMA,IAAiC,GAAQ,GAAyB;EAChE,KAAK,KAAO;CACd;CAEA,IAAiC,GAAQ;EACvC,OAAO,KAAK;CACd;CAMA,SAAmB,GAAa,GAAgB;EAE9C,IAAM,IAAK,EAAS;EAEpB,AAAI,OAAO,KAAO,cAChB,KAAK,IAAI,GAAsB,EAAG,KAAK,IAAI,CAAqB;CAEpE;CAEA,gBAA0B,GAAa,GAAmB;EACxD,KAAK,IAAM,KAAU,GAEnB,KAAK,SAAS,GAAU,CAAM;CAElC;AACF"}

package/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,KAAK,CAAC,sBAE9B,CAAC;AAIF;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,KAAK,CAAC,sBAE9B,CAAC;AAIF;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,KAAK,CAAC,wBAE7B,CAAC;AAIF;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,KAAK,CAAC,qBAE9B,CAAC;AAIF;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,KAAK,CAAC,YAE9B,CAAC"}

package/dist/lib/types.js

@@ -0,0 +1,6 @@
+//#region src/lib/types.ts
+var e = (e) => typeof e == "string", t = (e) => typeof e == "number", n = (e) => typeof e == "function", r = (e) => Array.isArray(e), i = (e) => !!e && typeof e == "object" && !r(e);
+//#endregion
+export { r as isArr, n as isFn, t as isNum, i as isObj, e as isStr };
+
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../src/lib/types.ts"],"sourcesContent":["/**\n * checks if the provided data is a string.\n *\n * @param arg - The data to check.\n *\n * @returns `true` if the data is a string, otherwise `false`.\n */\nexport const isStr = <T>(arg: T) => {\n  return typeof arg === \"string\";\n};\n\n/* ============================================================================================= */\n\n/**\n * checks if the provided data is a number.\n *\n * @param arg - The data to check.\n *\n * @returns `true` if the data is a number, otherwise `false`.\n */\nexport const isNum = <T>(arg: T) => {\n  return typeof arg === \"number\";\n};\n\n/* ============================================================================================= */\n\n/**\n * checks if the provided data is a function.\n *\n * @param arg - The data to check.\n *\n * @returns `true` if the data is a function, otherwise `false`.\n */\nexport const isFn = <T>(arg: T) => {\n  return typeof arg === \"function\";\n};\n\n/* ============================================================================================= */\n\n/**\n * checks if the provided data is an array.\n *\n * @param arg - The data to check.\n *\n * @returns `true` if the data is an array, otherwise `false`.\n */\nexport const isArr = <T>(arg: T) => {\n  return Array.isArray(arg);\n};\n\n/* ============================================================================================= */\n\n/**\n * checks if the provided data is an object (not an array, or null).\n *\n * @param arg - The data to check.\n *\n * @returns `true` if the data is an object, otherwise `false`.\n */\nexport const isObj = <T>(arg: T) => {\n  return Boolean(arg) && typeof arg === \"object\" && !isArr(arg);\n};\n"],"mappings":";AAOA,IAAa,KAAY,MAChB,OAAO,KAAQ,UAYX,KAAY,MAChB,OAAO,KAAQ,UAYX,KAAW,MACf,OAAO,KAAQ,YAYX,KAAY,MAChB,MAAM,QAAQ,CAAG,GAYb,KAAY,MAChB,EAAQ,KAAQ,OAAO,KAAQ,YAAY,CAAC,EAAM,CAAG"}

package/dist/lib/utils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * put the app to sleep for defined time for artificial delay to improve the UX
+ *
+ * @param time - time for artificial delay (default `250)
+ */
+export declare const sleep: (time?: number) => Promise<void>;
+/**
+ * extracts extensions from a string pattern like ".ext" or ".{ext1,ext2}"
+ *
+ * @param str - The pattern string (e.g., "*.{ts,tsx}")
+ */
+export declare const extractExtensions: (str: string) => string[];
+//# sourceMappingURL=utils.d.ts.map

package/dist/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAEH,eAAO,MAAM,KAAK,GAAU,aAAU,KAAG,OAAO,CAAC,IAAI,CAOpD,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,aAgB5C,CAAC"}

package/dist/lib/utils.js

@@ -0,0 +1,14 @@
+import { throwError as e } from "./logger.js";
+//#region src/lib/utils.ts
+var t = async (e = 250) => new Promise((t) => {
+	setTimeout(() => {
+		t();
+	}, e);
+}), n = (t) => {
+	let n = /\.(\{?[\w,]+\}?)$/.exec(t);
+	return n ? n[1].replaceAll(/[{}]/g, "").split(",") : e(`extension(s) are required! :: ${t}`);
+};
+//#endregion
+export { n as extractExtensions, t as sleep };
+
+//# sourceMappingURL=utils.js.map

package/dist/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":[],"sources":["../../src/lib/utils.ts"],"sourcesContent":["import { throwError } from \"./logger.ts\";\n\n/* ============================================================================================= */\n\n/**\n * put the app to sleep for defined time for artificial delay to improve the UX\n *\n * @param time - time for artificial delay (default `250)\n */\n// oxlint-disable-next-line require-await\nexport const sleep = async (time = 250): Promise<void> => {\n  //\n  return new Promise<void>((resolve) => {\n    setTimeout(() => {\n      resolve();\n    }, time);\n  });\n};\n\n/* ============================================================================================= */\n\n/**\n * extracts extensions from a string pattern like \".ext\" or \".{ext1,ext2}\"\n *\n * @param str - The pattern string (e.g., \"*.{ts,tsx}\")\n */\nexport const extractExtensions = (str: string) => {\n  // regex explanation:\n  // 1. \\.          : Match a literal dot\n  // 2. \\{?         : Optionally match an opening curly brace\n  // 3. ([\\w,]+)    : Capture group for the extensions (alphanumeric and commas)\n  // 4. \\}?         : Optionally match a closing curly brace\n  // 5. $           : Ensure we are at the end of the string\n  const match = /\\.(\\{?[\\w,]+\\}?)$/.exec(str);\n\n  if (!match) {\n    return throwError(`extension(s) are required! :: ${str}`);\n  }\n\n  // match[1] contains the extension part (e.g., \"ts\" or \"{ts,tsx}\")\n  // we remove '{' and '}' and split by comma\n  return match[1].replaceAll(/[{}]/g, \"\").split(\",\");\n};\n"],"mappings":";;AAUA,IAAa,IAAQ,OAAO,IAAO,QAE1B,IAAI,SAAe,MAAY;CACpC,iBAAiB;EACf,EAAQ;CACV,GAAG,CAAI;AACT,CAAC,GAUU,KAAqB,MAAgB;CAOhD,IAAM,IAAQ,oBAAoB,KAAK,CAAG;CAQ1C,OANK,IAME,EAAM,GAAG,WAAW,SAAS,EAAE,EAAE,MAAM,GAAG,IALxC,EAAW,iCAAiC,GAAK;AAM5D"}