umaki 0.9.2 → 0.10.0

package/dist/index.cjs.js

@@ -6,6 +6,7 @@ const defaultConfig = require("./libs/config/default-config.cjs.js");
 const getConfig = require("./libs/config/get-config.cjs.js");
 const setConfig = require("./libs/config/set-config.cjs.js");
 const bgScrollStop = require("./libs/control/bg-scroll-stop.cjs.js");
+const copyToClipboard = require("./libs/control/copy-to-clipboard.cjs.js");
 const pd = require("./libs/control/pd.cjs.js");
 const scrollToHash = require("./libs/control/scroll-to-hash.cjs.js");
 const videoPlayControl = require("./libs/control/video-play-control.cjs.js");
@@ -22,6 +23,8 @@ const getGravatarUrl = require("./libs/get/get-gravatar-url.cjs.js");
 const getOrientation = require("./libs/get/get-orientation.cjs.js");
 const getParentList = require("./libs/get/get-parent-list.cjs.js");
 const getQueryParams = require("./libs/get/get-query-params.cjs.js");
+const getRelativeTime = require("./libs/get/get-relative-time.cjs.js");
+const getRandomInt = require("./libs/get/get-random-int.cjs.js");
 const getRem = require("./libs/get/get-rem.cjs.js");
 const getScrollbarWidth = require("./libs/get/get-scrollbar-width.cjs.js");
 const getSessionStorage = require("./libs/get/get-session-storage.cjs.js");
@@ -33,8 +36,10 @@ const checkDeviceSize = require("./libs/is/check-device-size.cjs.js");
 const isAfterDateTime = require("./libs/is/is-after-date-time.cjs.js");
 const isBetweenDateTime = require("./libs/is/is-between-date-time.cjs.js");
 const isExistAllElements = require("./libs/is/is-exist-all-elements.cjs.js");
+const isInViewport = require("./libs/is/is-in-viewport.cjs.js");
 const isIpad = require("./libs/is/is-ipad.cjs.js");
 const isKeyExists = require("./libs/is/is-key-exists.cjs.js");
+const isOnline = require("./libs/is/is-online.cjs.js");
 const isSafari = require("./libs/is/is-safari.cjs.js");
 const isScrollable = require("./libs/is/is-scrollable.cjs.js");
 const isTouchSupport = require("./libs/is/is-touch-support.cjs.js");
@@ -62,6 +67,7 @@ exports.getConfig = getConfig.getConfig;
 exports.getConfigValue = getConfig.getConfigValue;
 exports.setConfig = setConfig.setConfig;
 exports.bgScrollStop = bgScrollStop.bgScrollStop;
+exports.copyToClipboard = copyToClipboard.copyToClipboard;
 exports.pd = pd.pd;
 exports.scrollToHash = scrollToHash.scrollToHash;
 exports.videoPlayControl = videoPlayControl.videoPlayControl;
@@ -78,6 +84,8 @@ exports.getGravatarUrl = getGravatarUrl.getGravatarUrl;
 exports.getOrientation = getOrientation.getOrientation;
 exports.getParentList = getParentList.getParentList;
 exports.getQueryParams = getQueryParams.getQueryParams;
+exports.getRelativeTime = getRelativeTime.getRelativeTime;
+exports.getRandomInt = getRandomInt.getRandomInt;
 exports.getRem = getRem.getRem;
 exports.getScrollbarWidth = getScrollbarWidth.getScrollbarWidth;
 exports.getSessionStorage = getSessionStorage.getSessionStorage;
@@ -89,8 +97,10 @@ exports.checkDeviceSize = checkDeviceSize.checkDeviceSize;
 exports.isAfterDateTime = isAfterDateTime.isAfterDateTime;
 exports.isBetweenDateTime = isBetweenDateTime.isBetweenDateTime;
 exports.isExistAllElements = isExistAllElements.isExistAllElements;
+exports.isInViewport = isInViewport.isInViewport;
 exports.isIpad = isIpad.isIpad;
 exports.isKeyExists = isKeyExists.isKeyExists;
+exports.isOnline = isOnline.isOnline;
 exports.isSafari = isSafari.isSafari;
 exports.isScrollable = isScrollable.isScrollable;
 exports.isTouchSupport = isTouchSupport.isTouchSupport;

package/dist/index.es.js

@@ -4,6 +4,7 @@ import { defaultConfig } from "./libs/config/default-config.es.js";
 import { currentConfig, getConfig, getConfigValue } from "./libs/config/get-config.es.js";
 import { setConfig } from "./libs/config/set-config.es.js";
 import { bgScrollStop } from "./libs/control/bg-scroll-stop.es.js";
+import { copyToClipboard } from "./libs/control/copy-to-clipboard.es.js";
 import { pd } from "./libs/control/pd.es.js";
 import { scrollToHash } from "./libs/control/scroll-to-hash.es.js";
 import { videoPlayControl } from "./libs/control/video-play-control.es.js";
@@ -20,6 +21,8 @@ import { getGravatarUrl } from "./libs/get/get-gravatar-url.es.js";
 import { getOrientation } from "./libs/get/get-orientation.es.js";
 import { getParentList } from "./libs/get/get-parent-list.es.js";
 import { getQueryParams } from "./libs/get/get-query-params.es.js";
+import { getRelativeTime } from "./libs/get/get-relative-time.es.js";
+import { getRandomInt } from "./libs/get/get-random-int.es.js";
 import { getRem } from "./libs/get/get-rem.es.js";
 import { getScrollbarWidth } from "./libs/get/get-scrollbar-width.es.js";
 import { getSessionStorage } from "./libs/get/get-session-storage.es.js";
@@ -31,8 +34,10 @@ import { checkDeviceSize } from "./libs/is/check-device-size.es.js";
 import { isAfterDateTime } from "./libs/is/is-after-date-time.es.js";
 import { isBetweenDateTime } from "./libs/is/is-between-date-time.es.js";
 import { isExistAllElements } from "./libs/is/is-exist-all-elements.es.js";
+import { isInViewport } from "./libs/is/is-in-viewport.es.js";
 import { isIpad } from "./libs/is/is-ipad.es.js";
 import { isKeyExists } from "./libs/is/is-key-exists.es.js";
+import { isOnline } from "./libs/is/is-online.es.js";
 import { isSafari } from "./libs/is/is-safari.es.js";
 import { isScrollable } from "./libs/is/is-scrollable.es.js";
 import { isTouchSupport } from "./libs/is/is-touch-support.es.js";
@@ -56,6 +61,7 @@ export {
   bgScrollStop,
   changeDateStringToSpecificFormat,
   checkDeviceSize,
+  copyToClipboard,
   currentConfig,
   debounce,
   defaultConfig,
@@ -70,6 +76,8 @@ export {
   getOrientation,
   getParentList,
   getQueryParams,
+  getRandomInt,
+  getRelativeTime,
   getRem,
   getScrollbarWidth,
   getSessionStorage,
@@ -81,8 +89,10 @@ export {
   isAfterDateTime,
   isBetweenDateTime,
   isExistAllElements,
+  isInViewport,
   isIpad,
   isKeyExists,
+  isOnline,
   isSafari,
   isScrollable,
   isTouchSupport,

package/dist/libs/control/bg-scroll-stop.cjs.js

@@ -3,11 +3,6 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const getScrollbarWidth = require("../get/get-scrollbar-width.cjs.js");
 const bgScrollStop = (isStop = true) => {
   document.body.style.paddingRight = isStop ? `${getScrollbarWidth.getScrollbarWidth()}px` : "";
-  if (isStop) {
-    document.body.style.overflow = "hidden";
-  }
-  if (!isStop) {
-    document.body.style.overflow = "";
-  }
+  document.body.style.overflow = isStop ? "hidden" : "";
 };
 exports.bgScrollStop = bgScrollStop;

package/dist/libs/control/bg-scroll-stop.es.js

@@ -1,12 +1,7 @@
 import { getScrollbarWidth } from "../get/get-scrollbar-width.es.js";
 const bgScrollStop = (isStop = true) => {
   document.body.style.paddingRight = isStop ? `${getScrollbarWidth()}px` : "";
-  if (isStop) {
-    document.body.style.overflow = "hidden";
-  }
-  if (!isStop) {
-    document.body.style.overflow = "";
-  }
+  document.body.style.overflow = isStop ? "hidden" : "";
 };
 export {
   bgScrollStop

package/dist/libs/control/copy-to-clipboard.cjs.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const copyToClipboard = async (text) => {
+  if (typeof navigator === "undefined" || !navigator.clipboard) {
+    return false;
+  }
+  try {
+    await navigator.clipboard.writeText(text);
+    return true;
+  } catch {
+    return false;
+  }
+};
+exports.copyToClipboard = copyToClipboard;

package/dist/libs/control/copy-to-clipboard.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Copies the specified text to the clipboard.
+ *
+ * Uses the modern Clipboard API (navigator.clipboard.writeText).
+ * Returns a promise that resolves to true on success, false on failure.
+ *
+ * @param text - The text to copy to the clipboard.
+ * @returns A promise that resolves to `true` if the copy was successful, `false` otherwise.
+ *
+ * @example
+ * ```ts
+ * // Basic usage
+ * const success = await copyToClipboard('Hello, World!')
+ * if (success) {
+ *   console.log('Copied to clipboard!')
+ * } else {
+ *   console.log('Failed to copy')
+ * }
+ *
+ * // With async/await error handling
+ * try {
+ *   await copyToClipboard('Some text')
+ * } catch (error) {
+ *   console.error('Copy failed:', error)
+ * }
+ * ```
+ */
+export declare const copyToClipboard: (text: string) => Promise<boolean>;

package/dist/libs/control/copy-to-clipboard.es.js

@@ -0,0 +1,14 @@
+const copyToClipboard = async (text) => {
+  if (typeof navigator === "undefined" || !navigator.clipboard) {
+    return false;
+  }
+  try {
+    await navigator.clipboard.writeText(text);
+    return true;
+  } catch {
+    return false;
+  }
+};
+export {
+  copyToClipboard
+};

package/dist/libs/control/copy-to-clipboard.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/libs/control/index.cjs.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const bgScrollStop = require("./bg-scroll-stop.cjs.js");
+const copyToClipboard = require("./copy-to-clipboard.cjs.js");
 const pd = require("./pd.cjs.js");
 const scrollToHash = require("./scroll-to-hash.cjs.js");
 const videoPlayControl = require("./video-play-control.cjs.js");
 exports.bgScrollStop = bgScrollStop.bgScrollStop;
+exports.copyToClipboard = copyToClipboard.copyToClipboard;
 exports.pd = pd.pd;
 exports.scrollToHash = scrollToHash.scrollToHash;
 exports.videoPlayControl = videoPlayControl.videoPlayControl;

package/dist/libs/control/index.d.ts

@@ -2,6 +2,7 @@
  * Control functions
  */
 export * from './bg-scroll-stop';
+export * from './copy-to-clipboard';
 export * from './pd';
 export * from './scroll-to-hash';
 export * from './video-play-control';

package/dist/libs/control/index.es.js

@@ -1,9 +1,11 @@
 import { bgScrollStop } from "./bg-scroll-stop.es.js";
+import { copyToClipboard } from "./copy-to-clipboard.es.js";
 import { pd } from "./pd.es.js";
 import { scrollToHash } from "./scroll-to-hash.es.js";
 import { videoPlayControl } from "./video-play-control.es.js";
 export {
   bgScrollStop,
+  copyToClipboard,
   pd,
   scrollToHash,
   videoPlayControl

package/dist/libs/control/video-play-control.cjs.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const toBoolean = require("../to/to-boolean.cjs.js");
 const videoPlayControl = async (videoElement, state, currentTime) => {
   if (state && videoElement.paused) {
-    const isPlaying = toBoolean.toBoolean(videoElement.dataset.playing);
+    const isPlaying = toBoolean.toBoolean(videoElement.dataset.playing ?? "");
     if (isPlaying) return;
     const playPromise = videoElement.play();
     if (playPromise === void 0) return;

package/dist/libs/control/video-play-control.es.js

@@ -1,7 +1,7 @@
 import { toBoolean } from "../to/to-boolean.es.js";
 const videoPlayControl = async (videoElement, state, currentTime) => {
   if (state && videoElement.paused) {
-    const isPlaying = toBoolean(videoElement.dataset.playing);
+    const isPlaying = toBoolean(videoElement.dataset.playing ?? "");
     if (isPlaying) return;
     const playPromise = videoElement.play();
     if (playPromise === void 0) return;

package/dist/libs/convert/change-date-string-to-specific-format.cjs.js

@@ -3,10 +3,10 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const dayjs = require("dayjs");
 const timezone = require("../../_virtual/timezone.cjs.js");
 const utc = require("../../_virtual/utc.cjs.js");
+dayjs.extend(utc.default);
+dayjs.extend(timezone.default);
 const changeDateStringToSpecificFormat = (date, format = "YYYY年MM月DD日", tz) => {
   if (tz) {
-    dayjs.extend(utc.default);
-    dayjs.extend(timezone.default);
     return dayjs(date).tz(tz).format(format);
   }
   return dayjs(date).format(format);

package/dist/libs/convert/change-date-string-to-specific-format.es.js

@@ -1,10 +1,10 @@
 import dayjs from "dayjs";
 import timezone from "../../_virtual/timezone.es.js";
 import utc from "../../_virtual/utc.es.js";
+dayjs.extend(utc);
+dayjs.extend(timezone);
 const changeDateStringToSpecificFormat = (date, format = "YYYY年MM月DD日", tz) => {
   if (tz) {
-    dayjs.extend(utc);
-    dayjs.extend(timezone);
     return dayjs(date).tz(tz).format(format);
   }
   return dayjs(date).format(format);

package/dist/libs/convert/json-string-to-json-object.cjs.js

@@ -3,7 +3,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const jsonStringToJsonObject = (string) => {
   try {
     return JSON.parse(string);
-  } catch (error) {
+  } catch {
+    return void 0;
   }
 };
 exports.jsonStringToJsonObject = jsonStringToJsonObject;

package/dist/libs/convert/json-string-to-json-object.d.ts

@@ -4,4 +4,4 @@
  * @param string - The JSON string to be parsed.
  * @returns The parsed JSON object, or undefined if parsing fails.
  */
-export declare const jsonStringToJsonObject: (string: string) => any;
+export declare const jsonStringToJsonObject: (string: string) => unknown;

package/dist/libs/convert/json-string-to-json-object.es.js

@@ -1,7 +1,8 @@
 const jsonStringToJsonObject = (string) => {
   try {
     return JSON.parse(string);
-  } catch (error) {
+  } catch {
+    return void 0;
   }
 };
 export {

package/dist/libs/get/get-event-paths.cjs.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const getEventPaths = (evt) => {
   let path = evt.composedPath?.() || null;
   const target = evt.target;
-  if (path != null) {
+  if (path !== null) {
     path = path.indexOf(window) < 0 ? path.concat([window]) : path;
     return path;
   }

package/dist/libs/get/get-event-paths.es.js

@@ -1,7 +1,7 @@
 const getEventPaths = (evt) => {
   let path = evt.composedPath?.() || null;
   const target = evt.target;
-  if (path != null) {
+  if (path !== null) {
     path = path.indexOf(window) < 0 ? path.concat([window]) : path;
     return path;
   }

package/dist/libs/get/get-gcd.cjs.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const toPositiveNumber = require("../to/to-positive-number.cjs.js");
 const getGcd = (a, b) => {
-  const positiveA = toPositiveNumber.toPositiveNumber(Math.abs(a));
-  const positiveB = toPositiveNumber.toPositiveNumber(Math.abs(b));
+  const positiveA = toPositiveNumber.toPositiveNumber(a);
+  const positiveB = toPositiveNumber.toPositiveNumber(b);
   if (positiveB === 0) return positiveA;
   return getGcd(positiveB, positiveA % positiveB);
 };

package/dist/libs/get/get-gcd.es.js

@@ -1,7 +1,7 @@
 import { toPositiveNumber } from "../to/to-positive-number.es.js";
 const getGcd = (a, b) => {
-  const positiveA = toPositiveNumber(Math.abs(a));
-  const positiveB = toPositiveNumber(Math.abs(b));
+  const positiveA = toPositiveNumber(a);
+  const positiveB = toPositiveNumber(b);
   if (positiveB === 0) return positiveA;
   return getGcd(positiveB, positiveA % positiveB);
 };

package/dist/libs/get/get-random-int.cjs.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const getRandomInt = (min, max) => {
+  if (min > max) {
+    throw new Error("min must be less than or equal to max");
+  }
+  const minCeiled = Math.ceil(min);
+  const maxFloored = Math.floor(max);
+  return Math.floor(Math.random() * (maxFloored - minCeiled + 1)) + minCeiled;
+};
+exports.getRandomInt = getRandomInt;

package/dist/libs/get/get-random-int.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Returns a random integer between min (inclusive) and max (inclusive).
+ *
+ * @param min - The minimum value (inclusive).
+ * @param max - The maximum value (inclusive).
+ * @returns A random integer between min and max.
+ * @throws If min is greater than max.
+ *
+ * @example
+ * ```ts
+ * getRandomInt(1, 10) // Returns a random integer from 1 to 10
+ * getRandomInt(0, 100) // Returns a random integer from 0 to 100
+ * ```
+ */
+export declare const getRandomInt: (min: number, max: number) => number;

package/dist/libs/get/get-random-int.es.js

@@ -0,0 +1,11 @@
+const getRandomInt = (min, max) => {
+  if (min > max) {
+    throw new Error("min must be less than or equal to max");
+  }
+  const minCeiled = Math.ceil(min);
+  const maxFloored = Math.floor(max);
+  return Math.floor(Math.random() * (maxFloored - minCeiled + 1)) + minCeiled;
+};
+export {
+  getRandomInt
+};

package/dist/libs/get/get-random-int.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/libs/get/get-relative-time.cjs.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const TIME_INTERVALS = [
+  { unit: "year", seconds: 31536e3 },
+  { unit: "month", seconds: 2592e3 },
+  { unit: "week", seconds: 604800 },
+  { unit: "day", seconds: 86400 },
+  { unit: "hour", seconds: 3600 },
+  { unit: "minute", seconds: 60 },
+  { unit: "second", seconds: 1 }
+];
+const getRelativeTime = (date, locale = "ja", baseDate = /* @__PURE__ */ new Date()) => {
+  const targetDate = date instanceof Date ? date : new Date(date);
+  const base = baseDate instanceof Date ? baseDate : new Date(baseDate);
+  const diffInSeconds = Math.floor(
+    (targetDate.getTime() - base.getTime()) / 1e3
+  );
+  const absDiff = Math.abs(diffInSeconds);
+  const rtf = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
+  for (const interval of TIME_INTERVALS) {
+    if (absDiff >= interval.seconds) {
+      const value = Math.floor(absDiff / interval.seconds);
+      return rtf.format(diffInSeconds >= 0 ? value : -value, interval.unit);
+    }
+  }
+  return rtf.format(diffInSeconds >= 0 ? absDiff : -absDiff, "second");
+};
+exports.getRelativeTime = getRelativeTime;

package/dist/libs/get/get-relative-time.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Returns a human-readable relative time string (e.g., "3 minutes ago", "2 days ago").
+ *
+ * Uses the browser's Intl.RelativeTimeFormat API for localization.
+ *
+ * @param date - The date to compare against the current time (or baseDate if provided).
+ *               Can be a Date object, timestamp number, or ISO date string.
+ * @param locale - The locale to use for formatting. Defaults to 'ja' (Japanese).
+ * @param baseDate - The base date to compare against. Defaults to current time.
+ * @returns A localized relative time string.
+ *
+ * @example
+ * ```ts
+ * // Japanese (default)
+ * getRelativeTime(new Date(Date.now() - 3 * 60 * 1000)) // "3分前"
+ * getRelativeTime(new Date(Date.now() - 2 * 24 * 60 * 60 * 1000)) // "2日前"
+ *
+ * // English
+ * getRelativeTime(new Date(Date.now() - 3 * 60 * 1000), 'en') // "3 minutes ago"
+ *
+ * // Future dates
+ * getRelativeTime(new Date(Date.now() + 5 * 60 * 1000)) // "5分後"
+ * ```
+ */
+export declare const getRelativeTime: (date: Date | number | string, locale?: string, baseDate?: Date | number | string) => string;

package/dist/libs/get/get-relative-time.es.js

@@ -0,0 +1,28 @@
+const TIME_INTERVALS = [
+  { unit: "year", seconds: 31536e3 },
+  { unit: "month", seconds: 2592e3 },
+  { unit: "week", seconds: 604800 },
+  { unit: "day", seconds: 86400 },
+  { unit: "hour", seconds: 3600 },
+  { unit: "minute", seconds: 60 },
+  { unit: "second", seconds: 1 }
+];
+const getRelativeTime = (date, locale = "ja", baseDate = /* @__PURE__ */ new Date()) => {
+  const targetDate = date instanceof Date ? date : new Date(date);
+  const base = baseDate instanceof Date ? baseDate : new Date(baseDate);
+  const diffInSeconds = Math.floor(
+    (targetDate.getTime() - base.getTime()) / 1e3
+  );
+  const absDiff = Math.abs(diffInSeconds);
+  const rtf = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
+  for (const interval of TIME_INTERVALS) {
+    if (absDiff >= interval.seconds) {
+      const value = Math.floor(absDiff / interval.seconds);
+      return rtf.format(diffInSeconds >= 0 ? value : -value, interval.unit);
+    }
+  }
+  return rtf.format(diffInSeconds >= 0 ? absDiff : -absDiff, "second");
+};
+export {
+  getRelativeTime
+};

package/dist/libs/get/get-relative-time.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/libs/get/get-session-storage.d.ts

@@ -4,4 +4,4 @@
  * @param key - The key of the session storage item to retrieve.
  * @returns The value associated with the key, or null if the key does not exist.
  */
-export declare const getSessionStorage: (key: string) => unknown | null;
+export declare const getSessionStorage: (key: string) => unknown;

package/dist/libs/get/index.cjs.js

@@ -9,6 +9,8 @@ const getGravatarUrl = require("./get-gravatar-url.cjs.js");
 const getOrientation = require("./get-orientation.cjs.js");
 const getParentList = require("./get-parent-list.cjs.js");
 const getQueryParams = require("./get-query-params.cjs.js");
+const getRelativeTime = require("./get-relative-time.cjs.js");
+const getRandomInt = require("./get-random-int.cjs.js");
 const getRem = require("./get-rem.cjs.js");
 const getScrollbarWidth = require("./get-scrollbar-width.cjs.js");
 const getSessionStorage = require("./get-session-storage.cjs.js");
@@ -25,6 +27,8 @@ exports.getGravatarUrl = getGravatarUrl.getGravatarUrl;
 exports.getOrientation = getOrientation.getOrientation;
 exports.getParentList = getParentList.getParentList;
 exports.getQueryParams = getQueryParams.getQueryParams;
+exports.getRelativeTime = getRelativeTime.getRelativeTime;
+exports.getRandomInt = getRandomInt.getRandomInt;
 exports.getRem = getRem.getRem;
 exports.getScrollbarWidth = getScrollbarWidth.getScrollbarWidth;
 exports.getSessionStorage = getSessionStorage.getSessionStorage;

package/dist/libs/get/index.d.ts

@@ -10,6 +10,8 @@ export * from './get-gravatar-url';
 export * from './get-orientation';
 export * from './get-parent-list';
 export * from './get-query-params';
+export * from './get-relative-time';
+export * from './get-random-int';
 export * from './get-rem';
 export * from './get-scrollbar-width';
 export * from './get-session-storage';

package/dist/libs/get/index.es.js

@@ -7,6 +7,8 @@ import { getGravatarUrl } from "./get-gravatar-url.es.js";
 import { getOrientation } from "./get-orientation.es.js";
 import { getParentList } from "./get-parent-list.es.js";
 import { getQueryParams } from "./get-query-params.es.js";
+import { getRelativeTime } from "./get-relative-time.es.js";
+import { getRandomInt } from "./get-random-int.es.js";
 import { getRem } from "./get-rem.es.js";
 import { getScrollbarWidth } from "./get-scrollbar-width.es.js";
 import { getSessionStorage } from "./get-session-storage.es.js";
@@ -24,6 +26,8 @@ export {
   getOrientation,
   getParentList,
   getQueryParams,
+  getRandomInt,
+  getRelativeTime,
   getRem,
   getScrollbarWidth,
   getSessionStorage,

package/dist/libs/is/index.cjs.js

@@ -4,8 +4,10 @@ const checkDeviceSize = require("./check-device-size.cjs.js");
 const isAfterDateTime = require("./is-after-date-time.cjs.js");
 const isBetweenDateTime = require("./is-between-date-time.cjs.js");
 const isExistAllElements = require("./is-exist-all-elements.cjs.js");
+const isInViewport = require("./is-in-viewport.cjs.js");
 const isIpad = require("./is-ipad.cjs.js");
 const isKeyExists = require("./is-key-exists.cjs.js");
+const isOnline = require("./is-online.cjs.js");
 const isSafari = require("./is-safari.cjs.js");
 const isScrollable = require("./is-scrollable.cjs.js");
 const isTouchSupport = require("./is-touch-support.cjs.js");
@@ -13,8 +15,10 @@ exports.checkDeviceSize = checkDeviceSize.checkDeviceSize;
 exports.isAfterDateTime = isAfterDateTime.isAfterDateTime;
 exports.isBetweenDateTime = isBetweenDateTime.isBetweenDateTime;
 exports.isExistAllElements = isExistAllElements.isExistAllElements;
+exports.isInViewport = isInViewport.isInViewport;
 exports.isIpad = isIpad.isIpad;
 exports.isKeyExists = isKeyExists.isKeyExists;
+exports.isOnline = isOnline.isOnline;
 exports.isSafari = isSafari.isSafari;
 exports.isScrollable = isScrollable.isScrollable;
 exports.isTouchSupport = isTouchSupport.isTouchSupport;

package/dist/libs/is/index.d.ts

@@ -5,8 +5,10 @@ export * from './check-device-size';
 export * from './is-after-date-time';
 export * from './is-between-date-time';
 export * from './is-exist-all-elements';
+export * from './is-in-viewport';
 export * from './is-ipad';
 export * from './is-key-exists';
+export * from './is-online';
 export * from './is-safari';
 export * from './is-scrollable';
 export * from './is-touch-support';

package/dist/libs/is/index.es.js

@@ -2,8 +2,10 @@ import { checkDeviceSize } from "./check-device-size.es.js";
 import { isAfterDateTime } from "./is-after-date-time.es.js";
 import { isBetweenDateTime } from "./is-between-date-time.es.js";
 import { isExistAllElements } from "./is-exist-all-elements.es.js";
+import { isInViewport } from "./is-in-viewport.es.js";
 import { isIpad } from "./is-ipad.es.js";
 import { isKeyExists } from "./is-key-exists.es.js";
+import { isOnline } from "./is-online.es.js";
 import { isSafari } from "./is-safari.es.js";
 import { isScrollable } from "./is-scrollable.es.js";
 import { isTouchSupport } from "./is-touch-support.es.js";
@@ -12,8 +14,10 @@ export {
   isAfterDateTime,
   isBetweenDateTime,
   isExistAllElements,
+  isInViewport,
   isIpad,
   isKeyExists,
+  isOnline,
   isSafari,
   isScrollable,
   isTouchSupport

package/dist/libs/is/is-in-viewport.cjs.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const parseRootMargin = (rootMargin) => {
+  const parts = rootMargin.trim().split(/\s+/);
+  const parseValue = (value) => {
+    if (value.endsWith("%")) {
+      const percent = Number.parseFloat(value) / 100;
+      return window.innerHeight * percent;
+    }
+    return Number.parseFloat(value) || 0;
+  };
+  if (parts.length === 1) {
+    const value = parseValue(parts[0]);
+    return { top: value, right: value, bottom: value, left: value };
+  }
+  if (parts.length === 2) {
+    const vertical = parseValue(parts[0]);
+    const horizontal = parseValue(parts[1]);
+    return {
+      top: vertical,
+      right: horizontal,
+      bottom: vertical,
+      left: horizontal
+    };
+  }
+  if (parts.length === 3) {
+    return {
+      top: parseValue(parts[0]),
+      right: parseValue(parts[1]),
+      bottom: parseValue(parts[2]),
+      left: parseValue(parts[1])
+    };
+  }
+  return {
+    top: parseValue(parts[0]),
+    right: parseValue(parts[1]),
+    bottom: parseValue(parts[2]),
+    left: parseValue(parts[3])
+  };
+};
+const isInViewport = (element, options = {}) => {
+  const { threshold = 0, rootMargin = "0px" } = options;
+  const rect = element.getBoundingClientRect();
+  const margins = parseRootMargin(rootMargin);
+  const viewportTop = 0 - margins.top;
+  const viewportLeft = 0 - margins.left;
+  const viewportBottom = window.innerHeight + margins.bottom;
+  const viewportRight = window.innerWidth + margins.right;
+  if (threshold === 0) {
+    return rect.bottom > viewportTop && rect.right > viewportLeft && rect.top < viewportBottom && rect.left < viewportRight;
+  }
+  const elementHeight = rect.height;
+  const elementWidth = rect.width;
+  const visibleTop = Math.max(rect.top, viewportTop);
+  const visibleBottom = Math.min(rect.bottom, viewportBottom);
+  const visibleLeft = Math.max(rect.left, viewportLeft);
+  const visibleRight = Math.min(rect.right, viewportRight);
+  const visibleHeight = Math.max(0, visibleBottom - visibleTop);
+  const visibleWidth = Math.max(0, visibleRight - visibleLeft);
+  const visibleArea = visibleHeight * visibleWidth;
+  const elementArea = elementHeight * elementWidth;
+  if (elementArea === 0) return false;
+  const visibleRatio = visibleArea / elementArea;
+  return visibleRatio >= threshold;
+};
+exports.isInViewport = isInViewport;

package/dist/libs/is/is-in-viewport.d.ts

@@ -0,0 +1,38 @@
+interface IsInViewportOptions {
+    /**
+     * Threshold for how much of the element must be visible (0-1).
+     * 0 = any part visible, 1 = entire element visible.
+     * @default 0
+     */
+    threshold?: number;
+    /**
+     * Root margin to expand or shrink the viewport bounds.
+     * Uses CSS-like syntax (e.g., "10px", "10px 20px", "10% 20px 30px 40px").
+     * @default "0px"
+     */
+    rootMargin?: string;
+}
+/**
+ * Determines if an element is currently visible within the viewport.
+ *
+ * @param element - The HTML element to check.
+ * @param options - Configuration options for the viewport check.
+ * @returns `true` if the element is visible in the viewport according to the options, otherwise `false`.
+ *
+ * @example
+ * ```ts
+ * // Check if any part of the element is visible
+ * isInViewport(element) // true if any part is visible
+ *
+ * // Check if the entire element is visible
+ * isInViewport(element, { threshold: 1 }) // true only if fully visible
+ *
+ * // Check with expanded viewport bounds (trigger earlier)
+ * isInViewport(element, { rootMargin: '100px' }) // 100px buffer around viewport
+ *
+ * // Check if at least 50% of the element is visible
+ * isInViewport(element, { threshold: 0.5 })
+ * ```
+ */
+export declare const isInViewport: (element: HTMLElement, options?: IsInViewportOptions) => boolean;
+export {};

package/dist/libs/is/is-in-viewport.es.js

@@ -0,0 +1,66 @@
+const parseRootMargin = (rootMargin) => {
+  const parts = rootMargin.trim().split(/\s+/);
+  const parseValue = (value) => {
+    if (value.endsWith("%")) {
+      const percent = Number.parseFloat(value) / 100;
+      return window.innerHeight * percent;
+    }
+    return Number.parseFloat(value) || 0;
+  };
+  if (parts.length === 1) {
+    const value = parseValue(parts[0]);
+    return { top: value, right: value, bottom: value, left: value };
+  }
+  if (parts.length === 2) {
+    const vertical = parseValue(parts[0]);
+    const horizontal = parseValue(parts[1]);
+    return {
+      top: vertical,
+      right: horizontal,
+      bottom: vertical,
+      left: horizontal
+    };
+  }
+  if (parts.length === 3) {
+    return {
+      top: parseValue(parts[0]),
+      right: parseValue(parts[1]),
+      bottom: parseValue(parts[2]),
+      left: parseValue(parts[1])
+    };
+  }
+  return {
+    top: parseValue(parts[0]),
+    right: parseValue(parts[1]),
+    bottom: parseValue(parts[2]),
+    left: parseValue(parts[3])
+  };
+};
+const isInViewport = (element, options = {}) => {
+  const { threshold = 0, rootMargin = "0px" } = options;
+  const rect = element.getBoundingClientRect();
+  const margins = parseRootMargin(rootMargin);
+  const viewportTop = 0 - margins.top;
+  const viewportLeft = 0 - margins.left;
+  const viewportBottom = window.innerHeight + margins.bottom;
+  const viewportRight = window.innerWidth + margins.right;
+  if (threshold === 0) {
+    return rect.bottom > viewportTop && rect.right > viewportLeft && rect.top < viewportBottom && rect.left < viewportRight;
+  }
+  const elementHeight = rect.height;
+  const elementWidth = rect.width;
+  const visibleTop = Math.max(rect.top, viewportTop);
+  const visibleBottom = Math.min(rect.bottom, viewportBottom);
+  const visibleLeft = Math.max(rect.left, viewportLeft);
+  const visibleRight = Math.min(rect.right, viewportRight);
+  const visibleHeight = Math.max(0, visibleBottom - visibleTop);
+  const visibleWidth = Math.max(0, visibleRight - visibleLeft);
+  const visibleArea = visibleHeight * visibleWidth;
+  const elementArea = elementHeight * elementWidth;
+  if (elementArea === 0) return false;
+  const visibleRatio = visibleArea / elementArea;
+  return visibleRatio >= threshold;
+};
+export {
+  isInViewport
+};

package/dist/libs/is/is-in-viewport.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/libs/is/is-online.cjs.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const isOnline = () => {
+  if (typeof navigator === "undefined") {
+    return true;
+  }
+  return navigator.onLine;
+};
+exports.isOnline = isOnline;

package/dist/libs/is/is-online.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Determines if the browser is currently online.
+ *
+ * Uses the Navigator.onLine API to check the online status.
+ * Note: This only indicates network connectivity, not actual internet access.
+ *
+ * @returns `true` if the browser is online, `false` if offline.
+ *
+ * @example
+ * ```ts
+ * if (isOnline()) {
+ *   // Perform network request
+ *   fetchData()
+ * } else {
+ *   // Show offline message
+ *   showOfflineMessage()
+ * }
+ * ```
+ */
+export declare const isOnline: () => boolean;

package/dist/libs/is/is-online.es.js

@@ -0,0 +1,9 @@
+const isOnline = () => {
+  if (typeof navigator === "undefined") {
+    return true;
+  }
+  return navigator.onLine;
+};
+export {
+  isOnline
+};

package/dist/libs/is/is-online.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/libs/is/is-touch-support.cjs.js

@@ -5,7 +5,7 @@ const isTouchSupport = () => {
   const hasTouchStart = "ontouchstart" in window && window.ontouchstart !== void 0;
   const hasTouchPoints = typeof navigator !== "undefined" && typeof navigator.maxTouchPoints === "number" && navigator.maxTouchPoints > 0;
   const hasMsTouchPoints = typeof navigator !== "undefined" && // We need to use type assertion since msMaxTouchPoints is not in standard Navigator type
-  typeof navigator.msMaxTouchPoints === "number" && navigator.msMaxTouchPoints > 0;
+  typeof navigator.msMaxTouchPoints === "number" && (navigator.msMaxTouchPoints ?? 0) > 0;
   return hasTouchStart || hasTouchPoints || hasMsTouchPoints;
 };
 exports.isTouchSupport = isTouchSupport;

package/dist/libs/is/is-touch-support.es.js

@@ -3,7 +3,7 @@ const isTouchSupport = () => {
   const hasTouchStart = "ontouchstart" in window && window.ontouchstart !== void 0;
   const hasTouchPoints = typeof navigator !== "undefined" && typeof navigator.maxTouchPoints === "number" && navigator.maxTouchPoints > 0;
   const hasMsTouchPoints = typeof navigator !== "undefined" && // We need to use type assertion since msMaxTouchPoints is not in standard Navigator type
-  typeof navigator.msMaxTouchPoints === "number" && navigator.msMaxTouchPoints > 0;
+  typeof navigator.msMaxTouchPoints === "number" && (navigator.msMaxTouchPoints ?? 0) > 0;
   return hasTouchStart || hasTouchPoints || hasMsTouchPoints;
 };
 export {

package/dist/libs/security/html-sanitize.cjs.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const DOMPurify = require("isomorphic-dompurify");
-function htmlSanitize(html, config = {}) {
+const htmlSanitize = (html, config = {}) => {
   return DOMPurify.sanitize(html, config);
-}
+};
 exports.htmlSanitize = htmlSanitize;

package/dist/libs/security/html-sanitize.d.ts

@@ -6,4 +6,4 @@ import { default as DOMPurify } from 'isomorphic-dompurify';
  * @param config - Optional configuration for DOMPurify.
  * @returns The sanitized HTML string.
  */
-export declare function htmlSanitize(html: string, config?: Parameters<typeof DOMPurify.sanitize>[1]): string;
+export declare const htmlSanitize: (html: string, config?: Parameters<typeof DOMPurify.sanitize>[1]) => string;

package/dist/libs/security/html-sanitize.es.js

@@ -1,7 +1,7 @@
 import DOMPurify from "isomorphic-dompurify";
-function htmlSanitize(html, config = {}) {
+const htmlSanitize = (html, config = {}) => {
   return DOMPurify.sanitize(html, config);
-}
+};
 export {
   htmlSanitize
 };

package/dist/libs/set/set-scroll-position-to-center.cjs.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const setScrollPositionToCenter = (rootElement, targetElement, behavior = "smooth") => {
   const rootHalfW = rootElement.getBoundingClientRect().width / 2;
-  const buttonHalfW = targetElement.getBoundingClientRect().width / 2;
-  const currentPosLeft = targetElement.offsetLeft + buttonHalfW;
+  const targetHalfW = targetElement.getBoundingClientRect().width / 2;
+  const currentPosLeft = targetElement.offsetLeft + targetHalfW;
   const posLeft = currentPosLeft - rootHalfW;
   rootElement.scrollTo({ left: posLeft, behavior });
 };

package/dist/libs/set/set-scroll-position-to-center.es.js

@@ -1,7 +1,7 @@
 const setScrollPositionToCenter = (rootElement, targetElement, behavior = "smooth") => {
   const rootHalfW = rootElement.getBoundingClientRect().width / 2;
-  const buttonHalfW = targetElement.getBoundingClientRect().width / 2;
-  const currentPosLeft = targetElement.offsetLeft + buttonHalfW;
+  const targetHalfW = targetElement.getBoundingClientRect().width / 2;
+  const currentPosLeft = targetElement.offsetLeft + targetHalfW;
   const posLeft = currentPosLeft - rootHalfW;
   rootElement.scrollTo({ left: posLeft, behavior });
 };

package/dist/libs/wait/sleep.cjs.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const sleep = (time) => {
-  return new Promise((resolve) => setTimeout(resolve, time * 1e3, "foo"));
+  return new Promise((resolve) => setTimeout(resolve, time * 1e3));
 };
 exports.sleep = sleep;

package/dist/libs/wait/sleep.es.js

@@ -1,5 +1,5 @@
 const sleep = (time) => {
-  return new Promise((resolve) => setTimeout(resolve, time * 1e3, "foo"));
+  return new Promise((resolve) => setTimeout(resolve, time * 1e3));
 };
 export {
   sleep

package/dist/libs/wait/wait-for-all-media-loaded.cjs.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const waitForAllMediaLoaded = async (firstViewOnly = false) => {
-  if (!document.images) return Promise.resolve(true);
-  if (document.images.length === 0) return Promise.resolve(true);
+  if (!document.images) return true;
+  if (document.images.length === 0) return true;
   const images = Array.from(document.images).filter(
     (img) => img.getAttribute("loading") !== "lazy"
   );
@@ -20,7 +20,7 @@ const waitForAllMediaLoaded = async (firstViewOnly = false) => {
       return rect.top < firstViewHeight && rect.bottom > 0;
     });
   }
-  if (mediaElements.length === 0) return Promise.resolve(true);
+  if (mediaElements.length === 0) return true;
   await Promise.all(
     mediaElements.map((media) => {
       if (media instanceof HTMLImageElement && media.complete)

package/dist/libs/wait/wait-for-all-media-loaded.es.js

@@ -1,6 +1,6 @@
 const waitForAllMediaLoaded = async (firstViewOnly = false) => {
-  if (!document.images) return Promise.resolve(true);
-  if (document.images.length === 0) return Promise.resolve(true);
+  if (!document.images) return true;
+  if (document.images.length === 0) return true;
   const images = Array.from(document.images).filter(
     (img) => img.getAttribute("loading") !== "lazy"
   );
@@ -18,7 +18,7 @@ const waitForAllMediaLoaded = async (firstViewOnly = false) => {
       return rect.top < firstViewHeight && rect.bottom > 0;
     });
   }
-  if (mediaElements.length === 0) return Promise.resolve(true);
+  if (mediaElements.length === 0) return true;
   await Promise.all(
     mediaElements.map((media) => {
       if (media instanceof HTMLImageElement && media.complete)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "umaki",
-  "version": "0.9.2",
+  "version": "0.10.0",
   "description": "A utility that is often used in web production.",
   "author": "TsubasaHiga",
   "homepage": "https://github.com/TsubasaHiga/umaki",