@jadeja/ts 1.0.0-alpha.0

package/dist/src/lib/operations.d.ts

@@ -0,0 +1,41 @@
+/**
+ * recursively merges the properties of the source object into the target object.
+ *
+ * @param target - The target object to merge into. Must be an object.
+ * @param source - The source object to merge from. Must be an object.
+ *
+ * @returns `source` object deep (nested) merge into `target` object.
+ *
+ * @throws If either `target` or `source` is not an object.
+ */
+export declare const deepMergeObj: <T, U>(target: T, source: U) => T & U;
+/**
+ * creates a deep copy of the given data using `structuredClone`.
+ *
+ * If the input is not an object or array, the original data is returned.
+ *
+ * @param data - The data to be copied. Can be an object or array.
+ *
+ * @returns A deep copy of the input data.
+ *
+ * @throws If any part of the input data is not serializable.
+ */
+export declare const deepCopy: <T>(data: T) => T;
+/**
+ * returns a fresh RegExp instance cloned from the provided input. This ensures the internal
+ * `lastIndex` state is reset to `0`, making the regex safe to reuse with stateful flags like `g` or
+ * `y` across multiple operations (e.g. `test`, `replace`, `exec`), particularly in long-lived
+ * runtimes such as HMR or shared modules.
+ *
+ * The returned RegExp preserves: - pattern source - flags (g, i, m, s, u, y, d, etc.)
+ *
+ * @example
+ *   -fresh(LCH_COLOR_FORMAT_PATTERN).test(rawColor);
+ *   -text.replace(fresh(LCH_COLOR_FORMAT_PATTERN), transformer);
+ *
+ * @param regex - The RegExp instance to clone.
+ *
+ * @returns A new RegExp instance with identical pattern and flags.
+ */
+export declare const freshRegex: (regex: RegExp) => RegExp;
+//# sourceMappingURL=operations.d.ts.map

package/dist/src/lib/operations.d.ts.map

@@ -0,0 +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"}

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

@@ -0,0 +1,41 @@
+/**
+ * checks if the provided data is a string.
+ *
+ * @param arg - The data to check.
+ *
+ * @returns `true` if the data is a string, otherwise `false`.
+ */
+export declare const isStr: <T>(arg: T) => arg is T & string;
+/**
+ * checks if the provided data is a number.
+ *
+ * @param arg - The data to check.
+ *
+ * @returns `true` if the data is a number, otherwise `false`.
+ */
+export declare const isNum: <T>(arg: T) => arg is T & number;
+/**
+ * checks if the provided data is a function.
+ *
+ * @param arg - The data to check.
+ *
+ * @returns `true` if the data is a function, otherwise `false`.
+ */
+export declare const isFn: <T>(arg: T) => arg is T & Function;
+/**
+ * checks if the provided data is an array.
+ *
+ * @param arg - The data to check.
+ *
+ * @returns `true` if the data is an array, otherwise `false`.
+ */
+export declare const isArr: <T>(arg: T) => arg is T & any[];
+/**
+ * checks if the provided data is an object (not an array, or null).
+ *
+ * @param arg - The data to check.
+ *
+ * @returns `true` if the data is an object, otherwise `false`.
+ */
+export declare const isObj: <T>(arg: T) => boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/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,sBAA4B,CAAC;AAI5D;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,KAAK,CAAC,sBAA4B,CAAC;AAI5D;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,KAAK,CAAC,wBAA8B,CAAC;AAI7D;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,KAAK,CAAC,qBAAuB,CAAC;AAIvD;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,KAAK,CAAC,YAA2D,CAAC"}

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

@@ -0,0 +1,8 @@
+export { default as debounce } from './debounce.ts';
+/**
+ * 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>;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEpD;;;;GAIG;AAEH,eAAO,MAAM,KAAK,GAAU,aAAU,KAAG,OAAO,CAAC,IAAI,CAKjD,CAAC"}

package/dist/src/plugins/vite/copy-folders.d.ts

@@ -0,0 +1,17 @@
+/**
+ * copies entire folders and its contents to a destination folders (post build)
+ *
+ * @param dirname - `import.meta.dirname`
+ * @param folders - an array of folder object containing `src` and `dest` property
+ */
+declare const vitePluginCopyFolders: (dirname: string, folders: {
+    src: string;
+    dest: string;
+}[]) => {
+    name: string;
+    apply: string;
+    enforce: string;
+    closeBundle(): void;
+};
+export default vitePluginCopyFolders;
+//# sourceMappingURL=copy-folders.d.ts.map

package/dist/src/plugins/vite/copy-folders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-folders.d.ts","sourceRoot":"","sources":["../../../../src/plugins/vite/copy-folders.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,QAAA,MAAM,qBAAqB,GAAI,SAAS,MAAM,EAAE,SAAS;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE;;;;;CAUtF,CAAC;AAkCH,eAAe,qBAAqB,CAAC"}

package/dist/src/plugins/vite/index.d.ts

@@ -0,0 +1,2 @@
+export { default as copyFolders } from './copy-folders.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/plugins/vite/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/vite/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/types/index.d.ts

@@ -0,0 +1,2 @@
+export type * from './shared';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,gBAAgB,CAAC"}

package/dist/src/types/shared.d.ts

@@ -0,0 +1,34 @@
+/**
+ * recursive object where each key maps to a nested object or a final value.
+ */
+export interface NestedObject<T> {
+    /**
+     * dynamic key for a nested branch or leaf value.
+     */
+    [key: string]: NestedObject<T> | T;
+}
+/**
+ * primitive data types
+ */
+export type Primitive = string | number | boolean | bigint | symbol | null | undefined;
+/**
+ * widen any type to primitive
+ */
+export type WidenPrimitive<T> = T extends string ? string : T extends number ? number : T extends boolean ? boolean : T extends bigint ? bigint : T extends symbol ? symbol : T;
+/**
+ * enhance auto-complete
+ *
+ * TODO: fina a better and correct way
+ */
+export type PrimitiveWithAutocomplete<T> = T extends string ? T | (string & {}) : T extends number ? T | (number & {}) : T extends boolean ? T : T extends bigint ? T | (bigint & {}) : T extends symbol ? T | (symbol & {}) : T;
+/**
+ * extend the narrow types
+ *
+ * TODO: find a better and correct way
+ */
+export type Extend<T> = T extends (...args: any[]) => any ? T : T extends (infer U)[] ? Extend<U>[] : T extends object ? {
+    -readonly [K in keyof T]?: Extend<T[K]>;
+} & {
+    [key: string]: Extend<WidenPrimitive<T[keyof T]>> | Primitive;
+} : PrimitiveWithAutocomplete<T>;
+//# sourceMappingURL=shared.d.ts.map

package/dist/src/types/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/types/shared.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAEvF;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAC5C,MAAM,GACN,CAAC,SAAS,MAAM,GACd,MAAM,GACN,CAAC,SAAS,OAAO,GACf,OAAO,GACP,CAAC,SAAS,MAAM,GACd,MAAM,GACN,CAAC,SAAS,MAAM,GACd,MAAM,GACN,CAAC,CAAC;AAEd;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAGrD,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,GACnB,CAAC,SAAS,MAAM,GAGZ,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,GACnB,CAAC,SAAS,OAAO,GACf,CAAC,GACD,CAAC,SAAS,MAAM,GAGZ,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,GACnB,CAAC,SAAS,MAAM,GAGZ,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,GACnB,CAAC,CAAC;AACd;;;;GAIG;AAEH,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GACrD,CAAC,GACD,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GACnB,MAAM,CAAC,CAAC,CAAC,EAAE,GACX,CAAC,SAAS,MAAM,GACd;IACE,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACxC,GAAG;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;CAC/D,GACD,yBAAyB,CAAC,CAAC,CAAC,CAAC"}

package/dist/vite-plugins.js

@@ -0,0 +1,22 @@
+import { copyFileSync as e, existsSync as t, mkdirSync as n, readdirSync as r } from "node:fs";
+import { join as i, resolve as a } from "node:path";
+//#region src/plugins/vite/copy-folders.ts
+var o = (e, t) => ({
+	name: "vite-plugin-copy-folders",
+	apply: "build",
+	enforce: "post",
+	closeBundle() {
+		for (let n of t) s(a(e, n.src), a(e, n.dest));
+	}
+}), s = (a, o) => {
+	t(o) || n(o, { recursive: !0 });
+	let c = r(a, { withFileTypes: !0 });
+	for (let t of c) {
+		let n = i(a, t.name), r = i(o, t.name);
+		t.isDirectory() ? s(n, r) : e(n, r);
+	}
+};
+//#endregion
+export { o as copyFolders };
+
+//# sourceMappingURL=vite-plugins.js.map

package/dist/vite-plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugins.js","names":[],"sources":["../src/plugins/vite/copy-folders.ts"],"sourcesContent":["import { existsSync, mkdirSync, readdirSync, copyFileSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\n\n/* ============================================================================================= */\n\n/**\n * copies entire folders and its contents to a destination folders (post build)\n *\n * @param dirname - `import.meta.dirname`\n * @param folders - an array of folder object containing `src` and `dest` property\n */\nconst vitePluginCopyFolders = (dirname: string, folders: { src: string; dest: string }[]) => ({\n  name: \"vite-plugin-copy-folders\",\n  apply: \"build\",\n  enforce: \"post\",\n\n  closeBundle() {\n    for (const folder of folders) {\n      copyFolderSync(resolve(dirname, folder.src), resolve(dirname, folder.dest));\n    }\n  },\n});\n\n/* ============================================================================================= */\n\n/**\n * copies an entire folder and its contents to a destination folder\n *\n * If the destination directory does not exist, it will be created automatically.\n *\n * @param src - The source directory path.\n * @param dest - The destination directory path.\n */\nconst copyFolderSync = (src: string, dest: string) => {\n  //\n  if (!existsSync(dest)) {\n    mkdirSync(dest, { recursive: true });\n  }\n\n  const entries = readdirSync(src, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const srcPath = join(src, entry.name);\n    const destPath = join(dest, entry.name);\n\n    if (entry.isDirectory()) {\n      copyFolderSync(srcPath, destPath);\n    } else {\n      copyFileSync(srcPath, destPath);\n    }\n  }\n};\n\n/* ============================================================================================= */\n\nexport default vitePluginCopyFolders;\n"],"mappings":";;;AAWA,IAAM,KAAyB,GAAiB,OAA8C;CAC5F,MAAM;CACN,OAAO;CACP,SAAS;CAET,cAAc;EACZ,KAAK,IAAM,KAAU,GACnB,EAAe,EAAQ,GAAS,EAAO,IAAI,EAAE,EAAQ,GAAS,EAAO,KAAK,CAAC;;CAGhF,GAYK,KAAkB,GAAa,MAAiB;CAEpD,AAAK,EAAW,EAAK,IACnB,EAAU,GAAM,EAAE,WAAW,IAAM,CAAC;CAGtC,IAAM,IAAU,EAAY,GAAK,EAAE,eAAe,IAAM,CAAC;CAEzD,KAAK,IAAM,KAAS,GAAS;EAC3B,IAAM,IAAU,EAAK,GAAK,EAAM,KAAK,EAC/B,IAAW,EAAK,GAAM,EAAM,KAAK;EAEvC,AAAI,EAAM,aAAa,GACrB,EAAe,GAAS,EAAS,GAEjC,EAAa,GAAS,EAAS"}

package/package.json

@@ -0,0 +1,119 @@
+{
+  "name": "@jadeja/ts",
+  "description": "an opinionated TypeScript toolkit",
+  "version": "1.0.0-alpha.0",
+  "type": "module",
+  "exports": {
+    "./configs/oxfmt": {
+      "types": "./dist/src/configs/oxfmt/index.d.ts",
+      "import": "./dist/oxfmt.js",
+      "default": "./dist/oxfmt.js",
+      "require": "./dist/oxfmt.js"
+    },
+    "./configs/oxfmt/types": {
+      "types": "./dist/src/configs/oxfmt/types.d.ts"
+    },
+    "./configs/oxlint": {
+      "types": "./dist/src/configs/oxlint/index.d.ts",
+      "import": "./dist/oxlint.js",
+      "default": "./dist/oxlint.js",
+      "require": "./dist/oxlint.js"
+    },
+    "./configs/oxlint/types": {
+      "types": "./dist/src/configs/oxlint/types.d.ts"
+    },
+    "./configs/ts/*": {
+      "import": "./dist/src/configs/ts/*.json",
+      "default": "./dist/src/configs/ts/*.json",
+      "require": "./dist/src/configs/ts/*.json"
+    },
+    "./lib": {
+      "types": "./dist/src/lib/index.d.ts",
+      "import": "./dist/lib.js",
+      "default": "./dist/lib.js",
+      "require": "./dist/lib.js"
+    },
+    "./plugins/vite": {
+      "types": "./dist/src/plugins/vite/index.d.ts",
+      "import": "./dist/vite-plugins.js",
+      "default": "./dist/vite-plugins.js",
+      "require": "./dist/vite-plugins.js"
+    },
+    "./types": {
+      "types": "./dist/src/types/index.d.ts"
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.2",
+    "husky": "^9.1.7",
+    "lint-staged": "^17.0.5",
+    "oxfmt": "^0.48.0",
+    "oxlint": "^1.63.0",
+    "oxlint-tsgolint": "^0.22.1",
+    "typescript": "^6.0.3",
+    "unplugin-dts": "^1.0.0",
+    "vite": "^8.0.8"
+  },
+  "peerDependencies": {
+    "@types/node": "^24.6.2",
+    "typescript": "^6.0.3"
+  },
+  "keywords": [
+    "ts",
+    "tools",
+    "typescript",
+    "configs",
+    "oxfmt",
+    "oxlint",
+    "tsconfig",
+    "lib",
+    "plugins"
+  ],
+  "files": [
+    "CHANGELOG.md",
+    "CODE_OF_CONDUCT.md",
+    "CONTRIBUTING.md",
+    "SECURITY.md",
+    "dist"
+  ],
+  "homepage": "https://github.com/JadejaHQ/ts",
+  "bugs": "https://github.com/JadejaHQ/ts/issues",
+  "license": "MIT",
+  "author": {
+    "name": "Pradipsinh Jadeja",
+    "email": "224366804+jadeja97@users.noreply.github.com",
+    "url": "https://x.com/jadeja97_"
+  },
+  "contributors": [
+    {
+      "name": "Pradipsinh Jadeja",
+      "email": "224366804+jadeja97@users.noreply.github.com",
+      "url": "https://x.com/jadeja97_"
+    }
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JadejaHQ/ts.git"
+  },
+  "engines": {
+    "node": ">=24",
+    "pnpm": ">=10",
+    "turbo": ">=2",
+    "npm": "please-use-pnpm",
+    "yarn": "please-use-pnpm",
+    "bun": "please-use-pnpm"
+  },
+  "devEngines": {
+    "runtime": {
+      "name": "node",
+      "version": ">=24",
+      "onFail": "error"
+    }
+  },
+  "scripts": {
+    "check": "tsc && oxfmt --check --disable-nested-config && oxlint --disable-nested-config",
+    "fix": "oxlint --fix --disable-nested-config && oxfmt --disable-nested-config",
+    "build": "vite build",
+    "publish-it": "pnpm publish --tag alpha --access public --no-git-checks"
+  }
+}