@gtcx/utils 0.1.0

package/dist/index.cjs

@@ -0,0 +1,150 @@
+"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, {
+  cn: () => cn,
+  debounce: () => debounce,
+  formatDate: () => formatDate,
+  formatDateTime: () => formatDateTime,
+  getHeight: () => getHeight,
+  getInitials: () => getInitials,
+  noop: () => noop,
+  throttle: () => throttle,
+  timeAgo: () => timeAgo,
+  toAbsoluteUrl: () => toAbsoluteUrl,
+  uid: () => uid
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/cn.ts
+var import_clsx = require("clsx");
+var import_tailwind_merge = require("tailwind-merge");
+function cn(...inputs) {
+  return (0, import_tailwind_merge.twMerge)((0, import_clsx.clsx)(inputs));
+}
+
+// src/dom.ts
+function getHeight(element) {
+  if (!element) return 0;
+  const styles = window.getComputedStyle(element);
+  const height = element.getBoundingClientRect().height;
+  const marginTop = parseFloat(styles.marginTop);
+  const marginBottom = parseFloat(styles.marginBottom);
+  return height + marginTop + marginBottom;
+}
+
+// src/helpers.ts
+function throttle(func, limit) {
+  let lastFunc = null;
+  let lastRan = null;
+  return function(...args) {
+    if (lastRan === null) {
+      func.apply(this, args);
+      lastRan = Date.now();
+    } else {
+      if (lastFunc !== null) {
+        clearTimeout(lastFunc);
+      }
+      lastFunc = setTimeout(
+        () => {
+          if (Date.now() - lastRan >= limit) {
+            func.apply(this, args);
+            lastRan = Date.now();
+          }
+        },
+        limit - (Date.now() - lastRan)
+      );
+    }
+  };
+}
+function debounce(func, wait) {
+  let timeout = null;
+  return function(...args) {
+    if (timeout) {
+      clearTimeout(timeout);
+    }
+    timeout = setTimeout(() => {
+      func.apply(this, args);
+    }, wait);
+  };
+}
+function uid() {
+  return (Date.now() + Math.floor(Math.random() * 1e3)).toString();
+}
+function getInitials(name, count) {
+  if (!name || typeof name !== "string") {
+    return "";
+  }
+  const initials = name.split(" ").filter(Boolean).map((part) => part[0].toUpperCase());
+  return count && count > 0 ? initials.slice(0, count).join("") : initials.join("");
+}
+function toAbsoluteUrl(pathname) {
+  return pathname;
+}
+function timeAgo(date) {
+  const now = /* @__PURE__ */ new Date();
+  const inputDate = typeof date === "string" ? new Date(date) : date;
+  const diff = Math.floor((now.getTime() - inputDate.getTime()) / 1e3);
+  if (diff < 60) return "just now";
+  if (diff < 3600) return `${Math.floor(diff / 60)} minute${Math.floor(diff / 60) > 1 ? "s" : ""} ago`;
+  if (diff < 86400) return `${Math.floor(diff / 3600)} hour${Math.floor(diff / 3600) > 1 ? "s" : ""} ago`;
+  if (diff < 604800) return `${Math.floor(diff / 86400)} day${Math.floor(diff / 86400) > 1 ? "s" : ""} ago`;
+  if (diff < 2592e3) return `${Math.floor(diff / 604800)} week${Math.floor(diff / 604800) > 1 ? "s" : ""} ago`;
+  if (diff < 31536e3) return `${Math.floor(diff / 2592e3)} month${Math.floor(diff / 2592e3) > 1 ? "s" : ""} ago`;
+  return `${Math.floor(diff / 31536e3)} year${Math.floor(diff / 31536e3) > 1 ? "s" : ""} ago`;
+}
+function formatDate(input) {
+  const date = new Date(input);
+  return date.toLocaleDateString("en-US", {
+    month: "long",
+    day: "numeric",
+    year: "numeric"
+  });
+}
+function formatDateTime(input) {
+  const date = new Date(input);
+  return date.toLocaleString("en-US", {
+    month: "long",
+    day: "numeric",
+    year: "numeric",
+    hour: "numeric",
+    minute: "numeric",
+    hour12: true
+  });
+}
+
+// src/index.ts
+function noop() {
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  cn,
+  debounce,
+  formatDate,
+  formatDateTime,
+  getHeight,
+  getInitials,
+  noop,
+  throttle,
+  timeAgo,
+  toAbsoluteUrl,
+  uid
+});

package/dist/index.d.cts

@@ -0,0 +1,27 @@
+import { ClassValue } from 'clsx';
+
+/**
+ * Merges Tailwind class names, resolving any conflicts.
+ */
+declare function cn(...inputs: ClassValue[]): string;
+
+/**
+ * DOM utility functions.
+ */
+declare function getHeight(element: HTMLElement | null): number;
+
+/**
+ * General helper utility functions.
+ */
+declare function throttle<T extends (...args: unknown[]) => void>(func: T, limit: number): T;
+declare function debounce<T extends (...args: unknown[]) => void>(func: T, wait: number): T;
+declare function uid(): string;
+declare function getInitials(name: string, count?: number): string;
+declare function toAbsoluteUrl(pathname: string): string;
+declare function timeAgo(date: string | Date): string;
+declare function formatDate(input: string | Date): string;
+declare function formatDateTime(input: string | Date): string;
+
+declare function noop(): void;
+
+export { cn, debounce, formatDate, formatDateTime, getHeight, getInitials, noop, throttle, timeAgo, toAbsoluteUrl, uid };

package/dist/index.d.mts

@@ -0,0 +1,28 @@
+import { ClassValue } from 'clsx';
+
+/**
+ * Merges Tailwind class names, resolving any conflicts.
+ */
+declare function cn(...inputs: ClassValue[]): string;
+
+/**
+ * DOM utility functions.
+ */
+declare function getHeight(element: HTMLElement | null): number;
+
+/**
+ * General helper utility functions.
+ */
+declare function throttle<T extends (...args: unknown[]) => void>(func: T, limit: number): T;
+declare function debounce<T extends (...args: unknown[]) => void>(func: T, wait: number): T;
+declare function uid(): string;
+declare function getInitials(name: string, count?: number): string;
+declare function toAbsoluteUrl(pathname: string): string;
+
+declare function timeAgo(date: string | Date): string;
+declare function formatDate(input: string | Date): string;
+declare function formatDateTime(input: string | Date): string;
+
+declare function noop(): void;
+
+export { cn, debounce, formatDate, formatDateTime, getHeight, getInitials, noop, throttle, timeAgo, toAbsoluteUrl, uid };

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+import { ClassValue } from 'clsx';
+
+/**
+ * Merges Tailwind class names, resolving any conflicts.
+ */
+declare function cn(...inputs: ClassValue[]): string;
+
+/**
+ * DOM utility functions.
+ */
+declare function getHeight(element: HTMLElement | null): number;
+
+/**
+ * General helper utility functions.
+ */
+declare function throttle<T extends (...args: unknown[]) => void>(func: T, limit: number): T;
+declare function debounce<T extends (...args: unknown[]) => void>(func: T, wait: number): T;
+declare function uid(): string;
+declare function getInitials(name: string, count?: number): string;
+declare function toAbsoluteUrl(pathname: string): string;
+
+declare function timeAgo(date: string | Date): string;
+declare function formatDate(input: string | Date): string;
+declare function formatDateTime(input: string | Date): string;
+
+declare function noop(): void;
+
+export { cn, debounce, formatDate, formatDateTime, getHeight, getInitials, noop, throttle, timeAgo, toAbsoluteUrl, uid };

package/dist/index.js

@@ -0,0 +1,157 @@
+"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, {
+  cn: () => cn,
+  debounce: () => debounce,
+  formatDate: () => formatDate,
+  formatDateTime: () => formatDateTime,
+  getHeight: () => getHeight,
+  getInitials: () => getInitials,
+  noop: () => noop,
+  throttle: () => throttle,
+  timeAgo: () => timeAgo,
+  toAbsoluteUrl: () => toAbsoluteUrl,
+  uid: () => uid
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/cn.ts
+var import_clsx = require("clsx");
+var import_tailwind_merge = require("tailwind-merge");
+function cn(...inputs) {
+  return (0, import_tailwind_merge.twMerge)((0, import_clsx.clsx)(inputs));
+}
+
+// src/dom.ts
+function getHeight(element) {
+  if (!element) return 0;
+  const styles = window.getComputedStyle(element);
+  const height = element.getBoundingClientRect().height;
+  const marginTop = parseFloat(styles.marginTop);
+  const marginBottom = parseFloat(styles.marginBottom);
+  return height + marginTop + marginBottom;
+}
+
+// src/helpers.ts
+function throttle(func, limit) {
+  let lastFunc = null;
+  let lastRan = null;
+  return function(...args) {
+    if (lastRan === null) {
+      func.apply(this, args);
+      lastRan = Date.now();
+    } else {
+      if (lastFunc !== null) {
+        clearTimeout(lastFunc);
+      }
+      lastFunc = setTimeout(
+        () => {
+          if (Date.now() - lastRan >= limit) {
+            func.apply(this, args);
+            lastRan = Date.now();
+          }
+        },
+        limit - (Date.now() - lastRan)
+      );
+    }
+  };
+}
+function debounce(func, wait) {
+  let timeout = null;
+  return function(...args) {
+    if (timeout) {
+      clearTimeout(timeout);
+    }
+    timeout = setTimeout(() => {
+      func.apply(this, args);
+    }, wait);
+  };
+}
+function uid() {
+  return (Date.now() + Math.floor(Math.random() * 1e3)).toString();
+}
+function getInitials(name, count) {
+  if (!name || typeof name !== "string") {
+    return "";
+  }
+  const initials = name.split(" ").filter(Boolean).map((part) => part[0].toUpperCase());
+  return count && count > 0 ? initials.slice(0, count).join("") : initials.join("");
+}
+function toAbsoluteUrl(pathname) {
+  return pathname;
+}
+
+// src/date.ts
+function timeAgo(date) {
+  const now = /* @__PURE__ */ new Date();
+  const inputDate = typeof date === "string" ? new Date(date) : date;
+  const diff = Math.floor((now.getTime() - inputDate.getTime()) / 1e3);
+  if (diff < 60) return "just now";
+  if (diff < 3600)
+    return `${Math.floor(diff / 60)} minute${Math.floor(diff / 60) > 1 ? "s" : ""} ago`;
+  if (diff < 86400)
+    return `${Math.floor(diff / 3600)} hour${Math.floor(diff / 3600) > 1 ? "s" : ""} ago`;
+  if (diff < 604800)
+    return `${Math.floor(diff / 86400)} day${Math.floor(diff / 86400) > 1 ? "s" : ""} ago`;
+  if (diff < 2592e3)
+    return `${Math.floor(diff / 604800)} week${Math.floor(diff / 604800) > 1 ? "s" : ""} ago`;
+  if (diff < 31536e3)
+    return `${Math.floor(diff / 2592e3)} month${Math.floor(diff / 2592e3) > 1 ? "s" : ""} ago`;
+  return `${Math.floor(diff / 31536e3)} year${Math.floor(diff / 31536e3) > 1 ? "s" : ""} ago`;
+}
+function formatDate(input) {
+  const date = new Date(input);
+  return date.toLocaleDateString("en-US", {
+    month: "long",
+    day: "numeric",
+    year: "numeric"
+  });
+}
+function formatDateTime(input) {
+  const date = new Date(input);
+  return date.toLocaleString("en-US", {
+    month: "long",
+    day: "numeric",
+    year: "numeric",
+    hour: "numeric",
+    minute: "numeric",
+    hour12: true
+  });
+}
+
+// src/noop.ts
+function noop() {
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  cn,
+  debounce,
+  formatDate,
+  formatDateTime,
+  getHeight,
+  getInitials,
+  noop,
+  throttle,
+  timeAgo,
+  toAbsoluteUrl,
+  uid
+});

package/dist/index.mjs

@@ -0,0 +1,120 @@
+// src/cn.ts
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+
+// src/dom.ts
+function getHeight(element) {
+  if (!element) return 0;
+  const styles = window.getComputedStyle(element);
+  const height = element.getBoundingClientRect().height;
+  const marginTop = parseFloat(styles.marginTop);
+  const marginBottom = parseFloat(styles.marginBottom);
+  return height + marginTop + marginBottom;
+}
+
+// src/helpers.ts
+function throttle(func, limit) {
+  let lastFunc = null;
+  let lastRan = null;
+  return function(...args) {
+    if (lastRan === null) {
+      func.apply(this, args);
+      lastRan = Date.now();
+    } else {
+      if (lastFunc !== null) {
+        clearTimeout(lastFunc);
+      }
+      lastFunc = setTimeout(
+        () => {
+          if (Date.now() - lastRan >= limit) {
+            func.apply(this, args);
+            lastRan = Date.now();
+          }
+        },
+        limit - (Date.now() - lastRan)
+      );
+    }
+  };
+}
+function debounce(func, wait) {
+  let timeout = null;
+  return function(...args) {
+    if (timeout) {
+      clearTimeout(timeout);
+    }
+    timeout = setTimeout(() => {
+      func.apply(this, args);
+    }, wait);
+  };
+}
+function uid() {
+  return (Date.now() + Math.floor(Math.random() * 1e3)).toString();
+}
+function getInitials(name, count) {
+  if (!name || typeof name !== "string") {
+    return "";
+  }
+  const initials = name.split(" ").filter(Boolean).map((part) => part[0].toUpperCase());
+  return count && count > 0 ? initials.slice(0, count).join("") : initials.join("");
+}
+function toAbsoluteUrl(pathname) {
+  return pathname;
+}
+
+// src/date.ts
+function timeAgo(date) {
+  const now = /* @__PURE__ */ new Date();
+  const inputDate = typeof date === "string" ? new Date(date) : date;
+  const diff = Math.floor((now.getTime() - inputDate.getTime()) / 1e3);
+  if (diff < 60) return "just now";
+  if (diff < 3600)
+    return `${Math.floor(diff / 60)} minute${Math.floor(diff / 60) > 1 ? "s" : ""} ago`;
+  if (diff < 86400)
+    return `${Math.floor(diff / 3600)} hour${Math.floor(diff / 3600) > 1 ? "s" : ""} ago`;
+  if (diff < 604800)
+    return `${Math.floor(diff / 86400)} day${Math.floor(diff / 86400) > 1 ? "s" : ""} ago`;
+  if (diff < 2592e3)
+    return `${Math.floor(diff / 604800)} week${Math.floor(diff / 604800) > 1 ? "s" : ""} ago`;
+  if (diff < 31536e3)
+    return `${Math.floor(diff / 2592e3)} month${Math.floor(diff / 2592e3) > 1 ? "s" : ""} ago`;
+  return `${Math.floor(diff / 31536e3)} year${Math.floor(diff / 31536e3) > 1 ? "s" : ""} ago`;
+}
+function formatDate(input) {
+  const date = new Date(input);
+  return date.toLocaleDateString("en-US", {
+    month: "long",
+    day: "numeric",
+    year: "numeric"
+  });
+}
+function formatDateTime(input) {
+  const date = new Date(input);
+  return date.toLocaleString("en-US", {
+    month: "long",
+    day: "numeric",
+    year: "numeric",
+    hour: "numeric",
+    minute: "numeric",
+    hour12: true
+  });
+}
+
+// src/noop.ts
+function noop() {
+}
+export {
+  cn,
+  debounce,
+  formatDate,
+  formatDateTime,
+  getHeight,
+  getInitials,
+  noop,
+  throttle,
+  timeAgo,
+  toAbsoluteUrl,
+  uid
+};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@gtcx/utils",
+  "version": "0.1.0",
+  "description": "GTCX shared utilities — cn, DOM helpers, debounce, throttle, date formatting",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "clsx": "^2.1.0",
+    "tailwind-merge": "^2.2.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}