kompkit-core 0.2.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 KompKit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,54 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  debounce: () => debounce,
+  formatCurrency: () => formatCurrency,
+  isEmail: () => isEmail
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/debounce.ts
+function debounce(fn, wait = 250) {
+  let t = null;
+  return (...args) => {
+    if (t) clearTimeout(t);
+    t = setTimeout(() => fn(...args), wait);
+  };
+}
+
+// src/validate.ts
+var EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+function isEmail(v) {
+  return EMAIL_RE.test(v.trim());
+}
+
+// src/format.ts
+function formatCurrency(amount, currency = "EUR", locale = "es-ES") {
+  return new Intl.NumberFormat(locale, { style: "currency", currency }).format(amount);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  debounce,
+  formatCurrency,
+  isEmail
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/debounce.ts","../src/validate.ts","../src/format.ts"],"sourcesContent":["// KompKit Core - Cross-platform utilities\nexport * from \"./debounce\";\nexport * from \"./validate\";\nexport * from \"./format\";\n","/**\n * Debounces a function call by delaying its execution until after a specified wait period.\n * Subsequent calls within the wait period reset the timer.\n * \n * @param fn - The function to debounce.\n * @param wait - Milliseconds to wait before invoking the function. Defaults to 250ms.\n * @returns A debounced version of the function.\n * \n * @example\n * ```ts\n * const search = debounce((query: string) => {\n *   console.log('Searching:', query);\n * }, 300);\n * \n * search('hello'); // Will execute after 300ms if no other calls are made\n * ```\n */\nexport function debounce<T extends (...args: any[]) => any>(fn: T, wait = 250) {\n  let t: ReturnType<typeof setTimeout> | null = null;\n  return (...args: Parameters<T>) => {\n    if (t) clearTimeout(t);\n    t = setTimeout(() => fn(...args), wait);\n  };\n}\n","const EMAIL_RE = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\n\n/**\n * Validates whether a string matches a basic email pattern.\n * \n * @param v - The string to validate.\n * @returns `true` if the string is a valid email format, `false` otherwise.\n * \n * @example\n * ```ts\n * isEmail('user@example.com'); // true\n * isEmail('invalid@'); // false\n * isEmail('  test@domain.org  '); // true (whitespace is trimmed)\n * ```\n */\nexport function isEmail(v: string): boolean {\n  return EMAIL_RE.test(v.trim());\n}\n","/**\n * Formats a number as a localized currency string.\n * \n * @param amount - The numeric amount to format.\n * @param currency - The currency code (e.g., \"USD\", \"EUR\", \"JPY\"). Defaults to \"EUR\".\n * @param locale - The locale string (e.g., \"en-US\", \"es-ES\"). Defaults to \"es-ES\".\n * @returns A formatted currency string.\n * \n * @example\n * ```ts\n * formatCurrency(1234.56); // \"1.234,56 €\" (es-ES default)\n * formatCurrency(1234.56, \"USD\", \"en-US\"); // \"$1,234.56\"\n * formatCurrency(1000, \"JPY\", \"ja-JP\"); // \"¥1,000\"\n * ```\n */\nexport function formatCurrency(\n  amount: number,\n  currency = \"EUR\",\n  locale = \"es-ES\"\n): string {\n  return new Intl.NumberFormat(locale, { style: \"currency\", currency }).format(amount);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACiBO,SAAS,SAA4C,IAAO,OAAO,KAAK;AAC7E,MAAI,IAA0C;AAC9C,SAAO,IAAI,SAAwB;AACjC,QAAI,EAAG,cAAa,CAAC;AACrB,QAAI,WAAW,MAAM,GAAG,GAAG,IAAI,GAAG,IAAI;AAAA,EACxC;AACF;;;ACvBA,IAAM,WAAW;AAeV,SAAS,QAAQ,GAAoB;AAC1C,SAAO,SAAS,KAAK,EAAE,KAAK,CAAC;AAC/B;;;ACFO,SAAS,eACd,QACA,WAAW,OACX,SAAS,SACD;AACR,SAAO,IAAI,KAAK,aAAa,QAAQ,EAAE,OAAO,YAAY,SAAS,CAAC,EAAE,OAAO,MAAM;AACrF;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,52 @@
+/**
+ * Debounces a function call by delaying its execution until after a specified wait period.
+ * Subsequent calls within the wait period reset the timer.
+ *
+ * @param fn - The function to debounce.
+ * @param wait - Milliseconds to wait before invoking the function. Defaults to 250ms.
+ * @returns A debounced version of the function.
+ *
+ * @example
+ * ```ts
+ * const search = debounce((query: string) => {
+ *   console.log('Searching:', query);
+ * }, 300);
+ *
+ * search('hello'); // Will execute after 300ms if no other calls are made
+ * ```
+ */
+declare function debounce<T extends (...args: any[]) => any>(fn: T, wait?: number): (...args: Parameters<T>) => void;
+
+/**
+ * Validates whether a string matches a basic email pattern.
+ *
+ * @param v - The string to validate.
+ * @returns `true` if the string is a valid email format, `false` otherwise.
+ *
+ * @example
+ * ```ts
+ * isEmail('user@example.com'); // true
+ * isEmail('invalid@'); // false
+ * isEmail('  test@domain.org  '); // true (whitespace is trimmed)
+ * ```
+ */
+declare function isEmail(v: string): boolean;
+
+/**
+ * Formats a number as a localized currency string.
+ *
+ * @param amount - The numeric amount to format.
+ * @param currency - The currency code (e.g., "USD", "EUR", "JPY"). Defaults to "EUR".
+ * @param locale - The locale string (e.g., "en-US", "es-ES"). Defaults to "es-ES".
+ * @returns A formatted currency string.
+ *
+ * @example
+ * ```ts
+ * formatCurrency(1234.56); // "1.234,56 €" (es-ES default)
+ * formatCurrency(1234.56, "USD", "en-US"); // "$1,234.56"
+ * formatCurrency(1000, "JPY", "ja-JP"); // "¥1,000"
+ * ```
+ */
+declare function formatCurrency(amount: number, currency?: string, locale?: string): string;
+
+export { debounce, formatCurrency, isEmail };

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Debounces a function call by delaying its execution until after a specified wait period.
+ * Subsequent calls within the wait period reset the timer.
+ *
+ * @param fn - The function to debounce.
+ * @param wait - Milliseconds to wait before invoking the function. Defaults to 250ms.
+ * @returns A debounced version of the function.
+ *
+ * @example
+ * ```ts
+ * const search = debounce((query: string) => {
+ *   console.log('Searching:', query);
+ * }, 300);
+ *
+ * search('hello'); // Will execute after 300ms if no other calls are made
+ * ```
+ */
+declare function debounce<T extends (...args: any[]) => any>(fn: T, wait?: number): (...args: Parameters<T>) => void;
+
+/**
+ * Validates whether a string matches a basic email pattern.
+ *
+ * @param v - The string to validate.
+ * @returns `true` if the string is a valid email format, `false` otherwise.
+ *
+ * @example
+ * ```ts
+ * isEmail('user@example.com'); // true
+ * isEmail('invalid@'); // false
+ * isEmail('  test@domain.org  '); // true (whitespace is trimmed)
+ * ```
+ */
+declare function isEmail(v: string): boolean;
+
+/**
+ * Formats a number as a localized currency string.
+ *
+ * @param amount - The numeric amount to format.
+ * @param currency - The currency code (e.g., "USD", "EUR", "JPY"). Defaults to "EUR".
+ * @param locale - The locale string (e.g., "en-US", "es-ES"). Defaults to "es-ES".
+ * @returns A formatted currency string.
+ *
+ * @example
+ * ```ts
+ * formatCurrency(1234.56); // "1.234,56 €" (es-ES default)
+ * formatCurrency(1234.56, "USD", "en-US"); // "$1,234.56"
+ * formatCurrency(1000, "JPY", "ja-JP"); // "¥1,000"
+ * ```
+ */
+declare function formatCurrency(amount: number, currency?: string, locale?: string): string;
+
+export { debounce, formatCurrency, isEmail };

package/dist/index.js

@@ -0,0 +1,25 @@
+// src/debounce.ts
+function debounce(fn, wait = 250) {
+  let t = null;
+  return (...args) => {
+    if (t) clearTimeout(t);
+    t = setTimeout(() => fn(...args), wait);
+  };
+}
+
+// src/validate.ts
+var EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+function isEmail(v) {
+  return EMAIL_RE.test(v.trim());
+}
+
+// src/format.ts
+function formatCurrency(amount, currency = "EUR", locale = "es-ES") {
+  return new Intl.NumberFormat(locale, { style: "currency", currency }).format(amount);
+}
+export {
+  debounce,
+  formatCurrency,
+  isEmail
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/debounce.ts","../src/validate.ts","../src/format.ts"],"sourcesContent":["/**\n * Debounces a function call by delaying its execution until after a specified wait period.\n * Subsequent calls within the wait period reset the timer.\n * \n * @param fn - The function to debounce.\n * @param wait - Milliseconds to wait before invoking the function. Defaults to 250ms.\n * @returns A debounced version of the function.\n * \n * @example\n * ```ts\n * const search = debounce((query: string) => {\n *   console.log('Searching:', query);\n * }, 300);\n * \n * search('hello'); // Will execute after 300ms if no other calls are made\n * ```\n */\nexport function debounce<T extends (...args: any[]) => any>(fn: T, wait = 250) {\n  let t: ReturnType<typeof setTimeout> | null = null;\n  return (...args: Parameters<T>) => {\n    if (t) clearTimeout(t);\n    t = setTimeout(() => fn(...args), wait);\n  };\n}\n","const EMAIL_RE = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\n\n/**\n * Validates whether a string matches a basic email pattern.\n * \n * @param v - The string to validate.\n * @returns `true` if the string is a valid email format, `false` otherwise.\n * \n * @example\n * ```ts\n * isEmail('user@example.com'); // true\n * isEmail('invalid@'); // false\n * isEmail('  test@domain.org  '); // true (whitespace is trimmed)\n * ```\n */\nexport function isEmail(v: string): boolean {\n  return EMAIL_RE.test(v.trim());\n}\n","/**\n * Formats a number as a localized currency string.\n * \n * @param amount - The numeric amount to format.\n * @param currency - The currency code (e.g., \"USD\", \"EUR\", \"JPY\"). Defaults to \"EUR\".\n * @param locale - The locale string (e.g., \"en-US\", \"es-ES\"). Defaults to \"es-ES\".\n * @returns A formatted currency string.\n * \n * @example\n * ```ts\n * formatCurrency(1234.56); // \"1.234,56 €\" (es-ES default)\n * formatCurrency(1234.56, \"USD\", \"en-US\"); // \"$1,234.56\"\n * formatCurrency(1000, \"JPY\", \"ja-JP\"); // \"¥1,000\"\n * ```\n */\nexport function formatCurrency(\n  amount: number,\n  currency = \"EUR\",\n  locale = \"es-ES\"\n): string {\n  return new Intl.NumberFormat(locale, { style: \"currency\", currency }).format(amount);\n}\n"],"mappings":";AAiBO,SAAS,SAA4C,IAAO,OAAO,KAAK;AAC7E,MAAI,IAA0C;AAC9C,SAAO,IAAI,SAAwB;AACjC,QAAI,EAAG,cAAa,CAAC;AACrB,QAAI,WAAW,MAAM,GAAG,GAAG,IAAI,GAAG,IAAI;AAAA,EACxC;AACF;;;ACvBA,IAAM,WAAW;AAeV,SAAS,QAAQ,GAAoB;AAC1C,SAAO,SAAS,KAAK,EAAE,KAAK,CAAC;AAC/B;;;ACFO,SAAS,eACd,QACA,WAAW,OACX,SAAS,SACD;AACR,SAAO,IAAI,KAAK,aAAa,QAAQ,EAAE,OAAO,YAAY,SAAS,CAAC,EAAE,OAAO,MAAM;AACrF;","names":[]}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "kompkit-core",
+  "version": "0.2.0-alpha.0",
+  "description": "Cross-platform utility functions for web applications. Part of the KompKit ecosystem.",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Kompkit/KompKit.git",
+    "directory": "packages/core/web"
+  },
+  "homepage": "https://github.com/Kompkit/KompKit",
+  "bugs": "https://github.com/Kompkit/KompKit/issues",
+  "keywords": [
+    "utilities",
+    "debounce",
+    "validation",
+    "email",
+    "currency",
+    "format",
+    "cross-platform"
+  ],
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "docs": "typedoc"
+  },
+  "devDependencies": {
+    "typedoc": "^0.28.16",
+    "vitest": "^3.0.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.7.0"
+  }
+}