cynx-lib 1.3.34 → 1.3.36

package/utils/utils/tz.js

@@ -592,6 +592,112 @@ export function tashkentMonth() {
   return getCurrentMonth('Asia/Tashkent');
 }
 
+export function tashkentTimeStr() {
+  const p = getTimezoneParts(new Date(), 'Asia/Tashkent');
+  return `${pad(p.hour)}:${pad(p.minute)}`;
+}
+
+// ─── COMPATIBILITY & REGIONAL HELPERS ──────────────────────────────────────────
+
+export const DEFAULT_TIMEZONE = 'Asia/Tashkent';
+export const DEFAULT_OFFSET = '+05:00';
+export const DEFAULT_TZ_LABEL = 'GMT+5';
+
+/**
+ * Format date in standard custom format with timezone label.
+ */
+export function formatCustomDateTz(date, timeZone = DEFAULT_TIMEZONE) {
+  if (!date) return '';
+  const d = new Date(date);
+  if (isNaN(d.getTime())) return '';
+
+  const dtf = new Intl.DateTimeFormat('en-US', {
+    timeZone,
+    month: 'short',
+    day: 'numeric',
+    year: 'numeric',
+    hour: 'numeric',
+    minute: '2-digit',
+    hour12: true,
+  });
+
+  const parts = dtf.formatToParts(d);
+  const partMap = {};
+  for (const p of parts) {
+    partMap[p.type] = p.value;
+  }
+
+  return `${partMap.month} ${partMap.day}, ${partMap.year}, ${partMap.hour}:${partMap.minute} ${partMap.dayPeriod || ''} ${DEFAULT_TZ_LABEL}`.replace(/\s+/g, ' ').trim();
+}
+
+/**
+ * Format a Date to YYYY-MM-DD in the configured timezone.
+ */
+export function formatDateKeyTz(date = new Date(), timeZone = DEFAULT_TIMEZONE) {
+  const d = new Date(date);
+  if (isNaN(d.getTime())) return '';
+  const dtf = new Intl.DateTimeFormat('en-CA', {
+    timeZone,
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+  });
+  return dtf.format(d);
+}
+
+/**
+ * Extract date (YYYY-MM-DD) and time (HH:mm) parts in the configured timezone.
+ */
+export function getPartsInTz(date, timeZone = DEFAULT_TIMEZONE) {
+  if (!date) return { date: '', time: '' };
+  const d = new Date(date);
+  if (isNaN(d.getTime())) return { date: '', time: '' };
+
+  const dtf = new Intl.DateTimeFormat('en-GB', {
+    timeZone,
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    hour12: false,
+  });
+
+  const parts = dtf.formatToParts(d);
+  const map = {};
+  for (const p of parts) map[p.type] = p.value;
+
+  return {
+    date: `${map.year}-${map.month}-${map.day}`,
+    time: `${map.hour}:${map.minute}`,
+  };
+}
+
+/**
+ * Combine date (YYYY-MM-DD) and time (HH:mm) into an ISO string with timezone offset.
+ */
+export function combineToTzIso(dateStr, timeStr = '00:00', offset = DEFAULT_OFFSET) {
+  if (!dateStr || !dateStr.trim()) return null;
+  const t = timeStr && timeStr.trim() ? timeStr.trim() : '00:00';
+  const fullTime = t.length === 5 ? `${t}:00` : t;
+  return `${dateStr.trim()}T${fullTime}${offset}`;
+}
+
+/**
+ * Safely parse an incoming date input ensuring timezone offset is respected.
+ */
+export function parseInputDate(input, defaultOffset = DEFAULT_OFFSET) {
+  if (!input) return null;
+  if (input instanceof Date) return isNaN(input.getTime()) ? null : input;
+  let s = String(input).trim();
+  if (!s) return null;
+  if (!/[zZ]$/.test(s) && !/[+-]\d{2}(:?\d{2})?$/.test(s)) {
+    s = `${s}${defaultOffset}`;
+  }
+  const d = new Date(s);
+  return isNaN(d.getTime()) ? null : d;
+}
+
 // ─── MAIN EXPORT ────────────────────────────────────────────────────────────────
 
 export default {
@@ -622,4 +728,13 @@ export default {
   tashkentNow,
   tashkentToday,
   tashkentMonth,
+  tashkentTimeStr,
+  DEFAULT_TIMEZONE,
+  DEFAULT_OFFSET,
+  DEFAULT_TZ_LABEL,
+  formatCustomDateTz,
+  formatDateKeyTz,
+  getPartsInTz,
+  combineToTzIso,
+  parseInputDate,
 };

package/utils/utils/ui.js

@@ -0,0 +1,111 @@
+/**
+ * cynx/utils — UI and Formatting Helpers (ui.js)
+ *
+ * Universal classname merger (cn), clipboard helper, and friendly date/byte formatters.
+ */
+
+/**
+ * Universal class names combiner / merger (zero-dependency clsx replacement).
+ * Handles strings, arrays, objects, booleans, and null/undefined values.
+ *
+ * @param {...any} inputs
+ * @returns {string} Combined class string
+ */
+export function cn(...inputs) {
+  const classes = [];
+
+  for (let i = 0; i < inputs.length; i++) {
+    const arg = inputs[i];
+    if (!arg) continue;
+
+    const argType = typeof arg;
+    if (argType === 'string' || argType === 'number') {
+      classes.push(arg);
+    } else if (Array.isArray(arg)) {
+      if (arg.length) {
+        const inner = cn(...arg);
+        if (inner) classes.push(inner);
+      }
+    } else if (argType === 'object') {
+      for (const key in arg) {
+        if (Object.prototype.hasOwnProperty.call(arg, key) && arg[key]) {
+          classes.push(key);
+        }
+      }
+    }
+  }
+
+  return classes.join(' ');
+}
+
+/**
+ * Safely copy text to clipboard with modern Clipboard API and legacy fallback.
+ *
+ * @param {string} text
+ * @returns {Promise<boolean>}
+ */
+export async function copyToClipboard(text) {
+  if (typeof navigator !== 'undefined' && navigator.clipboard?.writeText) {
+    try {
+      await navigator.clipboard.writeText(text);
+      return true;
+    } catch {}
+  }
+
+  if (typeof document !== 'undefined') {
+    try {
+      const el = document.createElement('textarea');
+      el.value = text;
+      el.setAttribute('readonly', '');
+      el.style.position = 'absolute';
+      el.style.left = '-9999px';
+      document.body.appendChild(el);
+      el.select();
+      const successful = document.execCommand('copy');
+      document.body.removeChild(el);
+      return successful;
+    } catch {}
+  }
+
+  return false;
+}
+
+/**
+ * Format relative time (e.g. "5s ago", "12m ago", "3h ago", "2d ago").
+ *
+ * @param {Date|string|number} d
+ * @returns {string}
+ */
+export function fmtAgo(d) {
+  if (!d) return '—';
+  const s = Math.floor((Date.now() - new Date(d).getTime()) / 1000);
+  if (isNaN(s)) return '—';
+  if (s < 60) return `${Math.max(0, s)}s ago`;
+  if (s < 3600) return `${Math.floor(s / 60)}m ago`;
+  if (s < 86400) return `${Math.floor(s / 3600)}h ago`;
+  return `${Math.floor(s / 86400)}d ago`;
+}
+
+/**
+ * Format localized date or return fallback dash.
+ *
+ * @param {Date|string|number} d
+ * @param {string} [locale='ru-RU']
+ * @returns {string}
+ */
+export function fmtDate(d, locale = 'ru-RU') {
+  if (!d) return '—';
+  try {
+    const date = new Date(d);
+    return isNaN(date.getTime()) ? '—' : date.toLocaleString(locale);
+  } catch {
+    return '—';
+  }
+}
+
+export default {
+  cn,
+  copyToClipboard,
+  fmtAgo,
+  fmtDate,
+};