umaki 0.9.3 → 0.10.1

package/README.md

@@ -78,11 +78,12 @@ console.log(breakpoint); // e.g. 768 (default) or custom value if set
 
 - [Callback](#callback)
   - [tap](#tap)
-  - [tapAsync](#tapasync)
+  - [tapAsync](#tapasync-promise)
 - [Control](#control)
   - [bgScrollStop](#bgscrollstop)
+  - [copyToClipboard](#copytoclipboard-promise)
   - [pd](#pd)
-  - [scrollToHash](#scrolltohash)
+  - [scrollToHash](#scrolltohash-promise)
   - [videoPlayControl](#videoplaycontrol)
 - [Convert](#convert)
   - [changeDateStringToSpecificFormat](#changedatestringtospecificformat)
@@ -100,6 +101,8 @@ console.log(breakpoint); // e.g. 768 (default) or custom value if set
   - [getOrientation](#getorientation)
   - [getParentList](#getparentlist)
   - [getQueryParams](#getqueryparams)
+  - [getRandomInt](#getrandomint)
+  - [getRelativeTime](#getrelativetime)
   - [getRem](#getrem)
   - [getScrollbarWidth](#getscrollbarwidth)
   - [getSessionStorage](#getsessionstorage)
@@ -111,8 +114,10 @@ console.log(breakpoint); // e.g. 768 (default) or custom value if set
   - [isAfterDateTime](#isafterdatetime)
   - [isBetweenDateTime](#isbetweendatetime)
   - [isExistAllElements](#isexistallelements)
+  - [isInViewport](#isinviewport)
   - [isIpad](#isipad)
   - [isKeyExists](#iskeyexists)
+  - [isOnline](#isonline)
   - [isSafari](#issafari)
   - [isScrollable](#isscrollable)
   - [isTouchSupport](#istouchsupport)
@@ -135,8 +140,8 @@ console.log(breakpoint); // e.g. 768 (default) or custom value if set
 - [Transform](#transform)
   - [wrapTextWithSpans](#wraptextwithspans)
 - [Wait](#wait)
-  - [sleep](#sleep)
-  - [waitForAllMediaLoaded](#waitforallmedialoaded)
+  - [sleep](#sleep-promise)
+  - [waitForAllMediaLoaded](#waitforallmedialoaded-promise)
 - [Security](#security)
   - [sanitizeHtml](#sanitizehtml)
 - [Advanced Usage](#advanced-usage)
@@ -218,6 +223,30 @@ bgScrollStop(false); // scroll start
 
 [View file →](src/libs/control/bg-scroll-stop.ts)
 
+### copyToClipboard (Promise)
+
+A function that copies text to the clipboard using the modern Clipboard API.
+
+```ts
+import { copyToClipboard } from "umaki";
+
+// Basic usage
+const success = await copyToClipboard("Hello, World!");
+if (success) {
+  console.log("Copied to clipboard!");
+} else {
+  console.log("Failed to copy");
+}
+
+// Use in click handler
+button.addEventListener("click", async () => {
+  const copied = await copyToClipboard(textToCopy);
+  showToast(copied ? "Copied!" : "Copy failed");
+});
+```
+
+[View file →](src/libs/control/copy-to-clipboard.ts)
+
 ### pd
 
 A function that prevents the default event behavior.
@@ -497,6 +526,53 @@ const customParamWithOptions = getQueryParams("id", {
 
 [View file →](src/libs/get/get-query-params.ts)
 
+### getRandomInt
+
+A function that returns a random integer between min (inclusive) and max (inclusive).
+
+```ts
+import { getRandomInt } from "umaki";
+
+// Basic usage
+const random = getRandomInt(1, 10);
+console.log(random); // Random integer from 1 to 10
+
+// Use for array index
+const items = ["apple", "banana", "orange"];
+const randomItem = items[getRandomInt(0, items.length - 1)];
+
+// Generate random delay
+const delay = getRandomInt(100, 500);
+await sleep(delay / 1000);
+```
+
+[View file →](src/libs/get/get-random-int.ts)
+
+### getRelativeTime
+
+A function that returns a human-readable relative time string (e.g., "3 minutes ago", "2 days ago") using the Intl.RelativeTimeFormat API.
+
+```ts
+import { getRelativeTime } from "umaki";
+
+// Basic usage (Japanese locale by default)
+const pastDate = new Date(Date.now() - 5 * 60 * 1000);
+console.log(getRelativeTime(pastDate)); // "5 分前"
+
+// English locale
+console.log(getRelativeTime(pastDate, "en")); // "5 minutes ago"
+
+// Future dates
+const futureDate = new Date(Date.now() + 2 * 24 * 60 * 60 * 1000);
+console.log(getRelativeTime(futureDate)); // "2 日後"
+
+// With timestamp or ISO string
+console.log(getRelativeTime(1702800000000, "en")); // relative to now
+console.log(getRelativeTime("2024-01-15T12:00:00Z", "en"));
+```
+
+[View file →](src/libs/get/get-relative-time.ts)
+
 ### getRem
 
 A function that converts a pixel value to rem units.
@@ -650,6 +726,31 @@ console.log(result); // true or false
 
 [View file →](src/libs/is/is-exist-all-elements.ts)
 
+### isInViewport
+
+A function that checks if an element is currently visible within the viewport.
+
+```ts
+import { isInViewport } from "umaki";
+
+const element = document.getElementById("target");
+
+// Check if any part of the element is visible
+const isVisible = isInViewport(element);
+console.log(isVisible); // true or false
+
+// Check if the entire element is visible
+const isFullyVisible = isInViewport(element, { threshold: 1 });
+
+// Check if at least 50% of the element is visible
+const isHalfVisible = isInViewport(element, { threshold: 0.5 });
+
+// With expanded viewport bounds (trigger 100px before element enters viewport)
+const isNearViewport = isInViewport(element, { rootMargin: "100px" });
+```
+
+[View file →](src/libs/is/is-in-viewport.ts)
+
 ### isIpad
 
 A function that checks if the device is an iPad.
@@ -677,6 +778,32 @@ console.log(result); // true or false
 
 [View file →](src/libs/is/is-key-exists.ts)
 
+### isOnline
+
+A function that checks if the browser is currently online using the Navigator.onLine API.
+
+```ts
+import { isOnline } from "umaki";
+
+// Basic usage
+if (isOnline()) {
+  // Perform network request
+  fetchData();
+} else {
+  // Show offline message
+  showOfflineMessage();
+}
+
+// Use with event listeners for online/offline detection
+window.addEventListener("online", () => {
+  if (isOnline()) {
+    console.log("Back online!");
+  }
+});
+```
+
+[View file →](src/libs/is/is-online.ts)
+
 ### isSafari
 
 A function that checks if the browser is Safari.

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/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/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-style-property-value-to-number.cjs.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const getStylePropertyValue = require("./get-style-property-value.cjs.js");
-const getStylePropertyValueToNumber = (key) => Number.parseInt(getStylePropertyValue.getStylePropertyValue(key), 10) || 0;
+const getStylePropertyValueToNumber = (key) => Number.parseFloat(getStylePropertyValue.getStylePropertyValue(key)) || 0;
 exports.getStylePropertyValueToNumber = getStylePropertyValueToNumber;

package/dist/libs/get/get-style-property-value-to-number.es.js

@@ -1,5 +1,5 @@
 import { getStylePropertyValue } from "./get-style-property-value.es.js";
-const getStylePropertyValueToNumber = (key) => Number.parseInt(getStylePropertyValue(key), 10) || 0;
+const getStylePropertyValueToNumber = (key) => Number.parseFloat(getStylePropertyValue(key)) || 0;
 export {
   getStylePropertyValueToNumber
 };

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/package.json

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