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

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