umaki 0.12.0 → 0.13.1

package/README.md

@@ -36,6 +36,14 @@ Umaki is your one-stop solution for web development utilities, bringing together
 import { foo } from "umaki";
 ```
 
+Category subpaths are also available to keep bundles small:
+
+```ts
+import { debounce } from "umaki/eventControl";
+```
+
+CommonJS (`require("umaki")`) is supported as well. Some dependencies are ESM-only, so loading umaki with `require` from Node.js needs a version that supports `require(esm)` (Node.js 20.19+ or 22.12+).
+
 ## Configuration
 
 ### setConfig
@@ -106,6 +114,7 @@ console.log(breakpoint); // e.g. 768 (default) or custom value if set
   - [getRandomInt](#getrandomint)
   - [getRelativeTime](#getrelativetime)
   - [getRem](#getrem)
+  - [getRenderedLineHeight](#getrenderedlineheight)
   - [getScrollbarWidth](#getscrollbarwidth)
   - [getSessionStorage](#getsessionstorage)
   - [getStringLength](#getstringlength)
@@ -619,6 +628,48 @@ console.log(remValue); // '1rem'
 
 [View file →](src/libs/get/get-rem.ts)
 
+### getRenderedLineHeight
+
+Measures the line-height **as it is actually rendered** (in CSS pixels) for a target element by inserting a hidden probe element with the same font-related styles and dividing its multi-line height by the sample line count.
+
+This works around an iOS Safari quirk ([WebKit Bug #225695](https://bugs.webkit.org/show_bug.cgi?id=225695)) where fractional `line-height` values are floored to integer pixels at paint time. Stacking-line UIs that rely on `1lh` (e.g. `mask-image: repeating-linear-gradient` rules) drift on iOS Safari but match `getRenderedLineHeight` output. Returns `NaN` in SSR environments or when the probe cannot be measured.
+
+The caller is responsible for awaiting `document.fonts.ready` before measuring when font-loaded accuracy matters.
+
+```ts
+import { getRenderedLineHeight } from "umaki";
+
+const textEl = document.querySelector<HTMLElement>(".text");
+if (!textEl) return;
+
+await document.fonts.ready;
+
+const lh = getRenderedLineHeight(textEl);
+if (Number.isFinite(lh)) {
+  textEl.style.setProperty("--text-line-height", `${lh}px`);
+}
+```
+
+```css
+.text {
+  mask-image: repeating-linear-gradient(
+    to bottom,
+    transparent 0,
+    transparent calc(var(--text-line-height, 1lh) - 0.5px),
+    #000 calc(var(--text-line-height, 1lh) - 0.5px),
+    #000 var(--text-line-height, 1lh)
+  );
+}
+```
+
+You can adjust the sampling resolution via `sampleLines` (default `20`, minimum `2`):
+
+```ts
+const lh = getRenderedLineHeight(textEl, { sampleLines: 40 });
+```
+
+[View file →](src/libs/get/get-rendered-line-height.ts)
+
 ### getScrollbarWidth
 
 A function that retrieves the width of the scrollbar.
@@ -912,6 +963,9 @@ const output = removeAllHtmlTags(input);
 console.log(output); // 'Hello World!'
 ```
 
+> [!NOTE]
+> The result is an HTML string, not plain text. When the input contains `<`, special characters are escaped (e.g. `removeAllHtmlTags("Tom & Jerry <b>!</b>")` returns `'Tom &amp; Jerry !'`). It is safe to insert as HTML, but do not decode it and insert it as HTML. To keep safe markup instead, use [`sanitizeHtml`](#sanitizehtml).
+
 [View file →](src/libs/remove/remove-all-html-tags.ts)
 
 ### removeAttribute
@@ -1151,6 +1205,10 @@ This function uses `isomorphic-dompurify` and has the following features:
 - Removes dangerous HTML tags and attributes by default
 - Allows flexible control through custom configuration
 - Can be used on both server-side and client-side
+- Always returns a string (`RETURN_DOM`, `RETURN_DOM_FRAGMENT`, `RETURN_TRUSTED_TYPE` and `IN_PLACE` are ignored)
+
+> [!WARNING]
+> The result is safe only as HTML element content (e.g. `innerHTML`). Do not use it for attribute values, URLs, `<script>` or CSS. Options such as `ALLOWED_URI_REGEXP`, `ADD_TAGS` and `ALLOW_UNKNOWN_PROTOCOLS` can weaken the protection.
 
 [View file →](src/libs/security/html-sanitize.ts)
 

package/dist/LICENSE.txt

@@ -1,32 +1 @@
-Name: dayjs
-Version: 1.11.19
-License: MIT
-Private: false
-Description: 2KB immutable date time library alternative to Moment.js with the same modern API 
-Repository: https://github.com/iamkun/dayjs.git
-Homepage: https://day.js.org
-Author: iamkun
-License Copyright:
-===
-
-MIT License
-
-Copyright (c) 2018-present, iamkun
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+No third parties dependencies

package/dist/{index.cjs.js → index.cjs}

@@ -1,66 +1,67 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const tap = require("./libs/callback/tap.cjs.js");
-const tapAsync = require("./libs/callback/tap-async.cjs.js");
-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");
-const changeDateStringToSpecificFormat = require("./libs/convert/change-date-string-to-specific-format.cjs.js");
-const hexToRgb = require("./libs/convert/hex-to-rgb.cjs.js");
-const jsonStringToJsonObject = require("./libs/convert/json-string-to-json-object.cjs.js");
-const rgbToHex = require("./libs/convert/rgb-to-hex.cjs.js");
-const debounce = require("./libs/eventControl/debounce.cjs.js");
-const throttle = require("./libs/eventControl/throttle.cjs.js");
-const getAspectRatio = require("./libs/get/get-aspect-ratio.cjs.js");
-const getClassNames = require("./libs/get/get-class-names.cjs.js");
-const getDocumentHeight = require("./libs/get/get-document-height.cjs.js");
-const getEventPaths = require("./libs/get/get-event-paths.cjs.js");
-const getGcd = require("./libs/get/get-gcd.cjs.js");
-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");
-const getStringLength = require("./libs/get/get-string-length.cjs.js");
-const getStylePropertyValue = require("./libs/get/get-style-property-value.cjs.js");
-const getStylePropertyValueToNumber = require("./libs/get/get-style-property-value-to-number.cjs.js");
-const getUaData = require("./libs/get/get-ua-data.cjs.js");
-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");
-const removeAllHtmlTags = require("./libs/remove/remove-all-html-tags.cjs.js");
-const removeAttribute = require("./libs/remove/remove-attribute.cjs.js");
-const removeSessionStorage = require("./libs/remove/remove-session-storage.cjs.js");
-const removeStylePropertyValue = require("./libs/remove/remove-style-property-value.cjs.js");
-const htmlSanitize = require("./libs/security/html-sanitize.cjs.js");
-const set100vh = require("./libs/set/set-100vh.cjs.js");
-const set100vw = require("./libs/set/set-100vw.cjs.js");
-const setAttribute = require("./libs/set/set-attribute.cjs.js");
-const setScrollPositionToCenter = require("./libs/set/set-scroll-position-to-center.cjs.js");
-const setSessionStorage = require("./libs/set/set-session-storage.cjs.js");
-const setStylePropertyValue = require("./libs/set/set-style-property-value.cjs.js");
-const toBoolean = require("./libs/to/to-boolean.cjs.js");
-const toPositiveNumber = require("./libs/to/to-positive-number.cjs.js");
-const wrapTextWithSpans = require("./libs/transform/wrap-text-with-spans.cjs.js");
-const sleep = require("./libs/wait/sleep.cjs.js");
-const waitForAllMediaLoaded = require("./libs/wait/wait-for-all-media-loaded.cjs.js");
+const tap = require("./libs/callback/tap.cjs");
+const tapAsync = require("./libs/callback/tap-async.cjs");
+const defaultConfig = require("./libs/config/default-config.cjs");
+const getConfig = require("./libs/config/get-config.cjs");
+const setConfig = require("./libs/config/set-config.cjs");
+const bgScrollStop = require("./libs/control/bg-scroll-stop.cjs");
+const copyToClipboard = require("./libs/control/copy-to-clipboard.cjs");
+const pd = require("./libs/control/pd.cjs");
+const scrollToHash = require("./libs/control/scroll-to-hash.cjs");
+const videoPlayControl = require("./libs/control/video-play-control.cjs");
+const changeDateStringToSpecificFormat = require("./libs/convert/change-date-string-to-specific-format.cjs");
+const hexToRgb = require("./libs/convert/hex-to-rgb.cjs");
+const jsonStringToJsonObject = require("./libs/convert/json-string-to-json-object.cjs");
+const rgbToHex = require("./libs/convert/rgb-to-hex.cjs");
+const debounce = require("./libs/eventControl/debounce.cjs");
+const throttle = require("./libs/eventControl/throttle.cjs");
+const getAspectRatio = require("./libs/get/get-aspect-ratio.cjs");
+const getClassNames = require("./libs/get/get-class-names.cjs");
+const getDocumentHeight = require("./libs/get/get-document-height.cjs");
+const getEventPaths = require("./libs/get/get-event-paths.cjs");
+const getGcd = require("./libs/get/get-gcd.cjs");
+const getGravatarUrl = require("./libs/get/get-gravatar-url.cjs");
+const getOrientation = require("./libs/get/get-orientation.cjs");
+const getParentList = require("./libs/get/get-parent-list.cjs");
+const getQueryParams = require("./libs/get/get-query-params.cjs");
+const getRandomInt = require("./libs/get/get-random-int.cjs");
+const getRelativeTime = require("./libs/get/get-relative-time.cjs");
+const getRem = require("./libs/get/get-rem.cjs");
+const getRenderedLineHeight = require("./libs/get/get-rendered-line-height.cjs");
+const getScrollbarWidth = require("./libs/get/get-scrollbar-width.cjs");
+const getSessionStorage = require("./libs/get/get-session-storage.cjs");
+const getStringLength = require("./libs/get/get-string-length.cjs");
+const getStylePropertyValue = require("./libs/get/get-style-property-value.cjs");
+const getStylePropertyValueToNumber = require("./libs/get/get-style-property-value-to-number.cjs");
+const getUaData = require("./libs/get/get-ua-data.cjs");
+const checkDeviceSize = require("./libs/is/check-device-size.cjs");
+const isAfterDateTime = require("./libs/is/is-after-date-time.cjs");
+const isBetweenDateTime = require("./libs/is/is-between-date-time.cjs");
+const isExistAllElements = require("./libs/is/is-exist-all-elements.cjs");
+const isInViewport = require("./libs/is/is-in-viewport.cjs");
+const isIpad = require("./libs/is/is-ipad.cjs");
+const isKeyExists = require("./libs/is/is-key-exists.cjs");
+const isOnline = require("./libs/is/is-online.cjs");
+const isSafari = require("./libs/is/is-safari.cjs");
+const isScrollable = require("./libs/is/is-scrollable.cjs");
+const isTouchSupport = require("./libs/is/is-touch-support.cjs");
+const removeAllHtmlTags = require("./libs/remove/remove-all-html-tags.cjs");
+const removeAttribute = require("./libs/remove/remove-attribute.cjs");
+const removeSessionStorage = require("./libs/remove/remove-session-storage.cjs");
+const removeStylePropertyValue = require("./libs/remove/remove-style-property-value.cjs");
+const htmlSanitize = require("./libs/security/html-sanitize.cjs");
+const set100vh = require("./libs/set/set-100vh.cjs");
+const set100vw = require("./libs/set/set-100vw.cjs");
+const setAttribute = require("./libs/set/set-attribute.cjs");
+const setScrollPositionToCenter = require("./libs/set/set-scroll-position-to-center.cjs");
+const setSessionStorage = require("./libs/set/set-session-storage.cjs");
+const setStylePropertyValue = require("./libs/set/set-style-property-value.cjs");
+const toBoolean = require("./libs/to/to-boolean.cjs");
+const toPositiveNumber = require("./libs/to/to-positive-number.cjs");
+const wrapTextWithSpans = require("./libs/transform/wrap-text-with-spans.cjs");
+const sleep = require("./libs/wait/sleep.cjs");
+const waitForAllMediaLoaded = require("./libs/wait/wait-for-all-media-loaded.cjs");
 exports.tap = tap.tap;
 exports.tapAsync = tapAsync.tapAsync;
 exports.defaultConfig = defaultConfig.defaultConfig;
@@ -87,9 +88,10 @@ 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.getRelativeTime = getRelativeTime.getRelativeTime;
 exports.getRem = getRem.getRem;
+exports.getRenderedLineHeight = getRenderedLineHeight.getRenderedLineHeight;
 exports.getScrollbarWidth = getScrollbarWidth.getScrollbarWidth;
 exports.getSessionStorage = getSessionStorage.getSessionStorage;
 exports.getStringLength = getStringLength.getStringLength;

package/dist/index.es.js

@@ -23,9 +23,10 @@ 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 { getRelativeTime } from "./libs/get/get-relative-time.es.js";
 import { getRem } from "./libs/get/get-rem.es.js";
+import { getRenderedLineHeight } from "./libs/get/get-rendered-line-height.es.js";
 import { getScrollbarWidth } from "./libs/get/get-scrollbar-width.es.js";
 import { getSessionStorage } from "./libs/get/get-session-storage.es.js";
 import { getStringLength } from "./libs/get/get-string-length.es.js";
@@ -80,6 +81,7 @@ export {
   getRandomInt,
   getRelativeTime,
   getRem,
+  getRenderedLineHeight,
   getScrollbarWidth,
   getSessionStorage,
   getStringLength,

package/dist/libs/callback/{index.cjs.js → index.cjs}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const tap = require("./tap.cjs.js");
-const tapAsync = require("./tap-async.cjs.js");
+const tap = require("./tap.cjs");
+const tapAsync = require("./tap-async.cjs");
 exports.tap = tap.tap;
 exports.tapAsync = tapAsync.tapAsync;

package/dist/libs/config/{_internal.cjs.js → _internal.cjs}

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const defaultConfig = require("./default-config.cjs.js");
+const defaultConfig = require("./default-config.cjs");
 const currentConfig = { ...defaultConfig.defaultConfig };
 exports.currentConfig = currentConfig;

package/dist/libs/config/{get-config.cjs.js → get-config.cjs}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const _internal = require("./_internal.cjs.js");
+const _internal = require("./_internal.cjs");
 const getConfig = () => {
   return { ..._internal.currentConfig };
 };

package/dist/libs/config/{index.cjs.js → index.cjs}

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const defaultConfig = require("./default-config.cjs.js");
-const getConfig = require("./get-config.cjs.js");
-const setConfig = require("./set-config.cjs.js");
+const defaultConfig = require("./default-config.cjs");
+const getConfig = require("./get-config.cjs");
+const setConfig = require("./set-config.cjs");
 exports.defaultConfig = defaultConfig.defaultConfig;
 exports.getConfig = getConfig.getConfig;
 exports.getConfigValue = getConfig.getConfigValue;

package/dist/libs/config/set-config.cjs

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const _internal = require("./_internal.cjs");
+const UNSAFE_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
+const setConfig = (config) => {
+  for (const [key, value] of Object.entries(config)) {
+    if (UNSAFE_KEYS.has(key)) continue;
+    _internal.currentConfig[key] = value;
+  }
+  return { ..._internal.currentConfig };
+};
+exports.setConfig = setConfig;

package/dist/libs/config/set-config.d.ts

@@ -3,5 +3,6 @@ import { UmakiConfig } from './types';
  * Set or update the configuration
  * @param config - Configuration object with values to update
  * @returns The updated configuration object
+ * `__proto__`, `constructor` and `prototype` keys are ignored.
  */
 export declare const setConfig: (config: Partial<UmakiConfig>) => UmakiConfig;

package/dist/libs/config/set-config.es.js

@@ -1,6 +1,10 @@
 import { currentConfig } from "./_internal.es.js";
+const UNSAFE_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
 const setConfig = (config) => {
-  Object.assign(currentConfig, config);
+  for (const [key, value] of Object.entries(config)) {
+    if (UNSAFE_KEYS.has(key)) continue;
+    currentConfig[key] = value;
+  }
   return { ...currentConfig };
 };
 export {

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

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const getScrollbarWidth = require("../get/get-scrollbar-width.cjs.js");
+const getScrollbarWidth = require("../get/get-scrollbar-width.cjs");
 const bgScrollStop = (isStop = true) => {
+  if (typeof window === "undefined") return;
   document.body.style.paddingRight = isStop ? `${getScrollbarWidth.getScrollbarWidth()}px` : "";
   document.body.style.overflow = isStop ? "hidden" : "";
 };

package/dist/libs/control/bg-scroll-stop.d.ts

@@ -11,5 +11,6 @@
  * When `isStop` is false, the function:
  * - Resets the body's `paddingRight` style.
  * - Resets the body's `overflow` style to allow background scrolling.
+ * Does nothing in SSR environments where window is undefined.
  */
 export declare const bgScrollStop: (isStop?: boolean) => void;

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

@@ -1,5 +1,6 @@
 import { getScrollbarWidth } from "../get/get-scrollbar-width.es.js";
 const bgScrollStop = (isStop = true) => {
+  if (typeof window === "undefined") return;
   document.body.style.paddingRight = isStop ? `${getScrollbarWidth()}px` : "";
   document.body.style.overflow = isStop ? "hidden" : "";
 };

package/dist/libs/control/{index.cjs.js → index.cjs}

@@ -1,10 +1,10 @@
 "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");
+const bgScrollStop = require("./bg-scroll-stop.cjs");
+const copyToClipboard = require("./copy-to-clipboard.cjs");
+const pd = require("./pd.cjs");
+const scrollToHash = require("./scroll-to-hash.cjs");
+const videoPlayControl = require("./video-play-control.cjs");
 exports.bgScrollStop = bgScrollStop.bgScrollStop;
 exports.copyToClipboard = copyToClipboard.copyToClipboard;
 exports.pd = pd.pd;

package/dist/libs/control/{scroll-to-hash.cjs.js → scroll-to-hash.cjs}

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const scrollToHash = async (hash, isSmooth = true, manualOffset) => {
+  if (typeof window === "undefined") return false;
   const hashWithoutSharp = hash.replace("#", "");
   const targetElement = document.getElementById(hashWithoutSharp);
   if (!targetElement) return false;

package/dist/libs/control/scroll-to-hash.d.ts

@@ -5,5 +5,6 @@
  * @param isSmooth - Determines if the scroll behavior should be smooth. Defaults to true.
  * @param manualOffset - An optional manual offset to adjust the scroll position.
  * @returns A Promise that resolves to true if the scroll was successful, or false if the target element was not found or the scroll did not complete within the timeout.
+ * Resolves to false in SSR environments where window is undefined.
  */
 export declare const scrollToHash: (hash: string, isSmooth?: boolean, manualOffset?: number) => Promise<boolean>;

package/dist/libs/control/scroll-to-hash.es.js

@@ -1,4 +1,5 @@
 const scrollToHash = async (hash, isSmooth = true, manualOffset) => {
+  if (typeof window === "undefined") return false;
   const hashWithoutSharp = hash.replace("#", "");
   const targetElement = document.getElementById(hashWithoutSharp);
   if (!targetElement) return false;

package/dist/libs/control/{video-play-control.cjs.js → video-play-control.cjs}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const toBoolean = require("../to/to-boolean.cjs.js");
+const toBoolean = require("../to/to-boolean.cjs");
 const videoPlayControl = async (videoElement, state, currentTime) => {
   if (state && videoElement.paused) {
     const isPlaying = toBoolean.toBoolean(videoElement.dataset.playing ?? "");

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

@@ -1,10 +1,10 @@
 "use strict";
 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 timezone = require("dayjs/plugin/timezone.js");
+const utc = require("dayjs/plugin/utc.js");
+dayjs.extend(utc);
+dayjs.extend(timezone);
 const changeDateStringToSpecificFormat = (date, format = "YYYY年MM月DD日", tz) => {
   if (tz) {
     return dayjs(date).tz(tz).format(format);

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

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

package/dist/libs/convert/{index.cjs.js → index.cjs}

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const changeDateStringToSpecificFormat = require("./change-date-string-to-specific-format.cjs.js");
-const hexToRgb = require("./hex-to-rgb.cjs.js");
-const jsonStringToJsonObject = require("./json-string-to-json-object.cjs.js");
-const rgbToHex = require("./rgb-to-hex.cjs.js");
+const changeDateStringToSpecificFormat = require("./change-date-string-to-specific-format.cjs");
+const hexToRgb = require("./hex-to-rgb.cjs");
+const jsonStringToJsonObject = require("./json-string-to-json-object.cjs");
+const rgbToHex = require("./rgb-to-hex.cjs");
 exports.changeDateStringToSpecificFormat = changeDateStringToSpecificFormat.changeDateStringToSpecificFormat;
 exports.hexToRgb = hexToRgb.hexToRgb;
 exports.jsonStringToJsonObject = jsonStringToJsonObject.jsonStringToJsonObject;

package/dist/libs/eventControl/{index.cjs.js → index.cjs}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const debounce = require("./debounce.cjs.js");
-const throttle = require("./throttle.cjs.js");
+const debounce = require("./debounce.cjs");
+const throttle = require("./throttle.cjs");
 exports.debounce = debounce.debounce;
 exports.throttle = throttle.throttle;

package/dist/libs/get/{get-aspect-ratio.cjs.js → get-aspect-ratio.cjs}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const getGcd = require("./get-gcd.cjs.js");
+const getGcd = require("./get-gcd.cjs");
 const getAspectRatio = (w, h) => {
   if (w <= 0 || h <= 0 || !Number.isFinite(w) || !Number.isFinite(h)) {
     throw new Error("Width and height must be positive finite numbers");

package/dist/libs/get/get-document-height.cjs

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const getDocumentHeight = () => {
+  if (typeof window === "undefined") return 0;
+  return document.body.clientHeight - window.innerHeight;
+};
+exports.getDocumentHeight = getDocumentHeight;

package/dist/libs/get/get-document-height.d.ts

@@ -2,5 +2,6 @@
  * Retrieves the height of the document.
  *
  * @returns {number} The height of the document, calculated as the difference between the body's client height and the window's inner height.
+ * Returns 0 in SSR environments where window is undefined.
  */
 export declare const getDocumentHeight: () => number;

package/dist/libs/get/get-document-height.es.js

@@ -1,4 +1,7 @@
-const getDocumentHeight = () => document.body.clientHeight - window.innerHeight;
+const getDocumentHeight = () => {
+  if (typeof window === "undefined") return 0;
+  return document.body.clientHeight - window.innerHeight;
+};
 export {
   getDocumentHeight
 };

package/dist/libs/get/{get-gcd.cjs.js → get-gcd.cjs}

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const toPositiveNumber = require("../to/to-positive-number.cjs.js");
+const toPositiveNumber = require("../to/to-positive-number.cjs");
 const getGcd = (a, b) => {
+  if (!Number.isFinite(a) || !Number.isFinite(b)) {
+    throw new Error("Arguments must be finite numbers");
+  }
   const positiveA = toPositiveNumber.toPositiveNumber(a);
   const positiveB = toPositiveNumber.toPositiveNumber(b);
   if (positiveB === 0) return positiveA;

package/dist/libs/get/get-gcd.d.ts

@@ -7,5 +7,6 @@
  * @param a - The first number.
  * @param b - The second number.
  * @returns The greatest common divisor of the two numbers.
+ * @throws {Error} If a or b is not a finite number.
  */
 export declare const getGcd: (a: number, b: number) => number;

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

@@ -1,5 +1,8 @@
 import { toPositiveNumber } from "../to/to-positive-number.es.js";
 const getGcd = (a, b) => {
+  if (!Number.isFinite(a) || !Number.isFinite(b)) {
+    throw new Error("Arguments must be finite numbers");
+  }
   const positiveA = toPositiveNumber(a);
   const positiveB = toPositiveNumber(b);
   if (positiveB === 0) return positiveA;

package/dist/libs/get/{get-gravatar-url.cjs.js → get-gravatar-url.cjs}

@@ -2,6 +2,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const md5 = require("md5");
 const getGravatarUrl = (email, size) => {
+  if (!Number.isInteger(size) || size <= 0) {
+    throw new Error("size must be a positive integer");
+  }
   const normalizedEmail = email.trim().toLowerCase();
   const gravatarUrl = `https://www.gravatar.com/avatar/${md5(normalizedEmail)}?s=${size}&d=404`;
   return gravatarUrl;

package/dist/libs/get/get-gravatar-url.d.ts

@@ -5,8 +5,12 @@
  * and converting to lowercase), generating an MD5 hash, and appending the size
  * parameter with a 404 fallback.
  *
+ * MD5 is used only because Gravatar requires it; do not use it for security purposes.
+ * Note that the hash in the URL can be used to look up or enumerate email addresses.
+ *
  * @param email - The email address to generate the Gravatar URL for.
  * @param size - The size of the avatar image in pixels.
  * @returns The Gravatar avatar image URL.
+ * @throws {Error} If size is not a positive integer.
  */
 export declare const getGravatarUrl: (email: string, size: number) => string;

package/dist/libs/get/get-gravatar-url.es.js

@@ -1,5 +1,8 @@
 import md5 from "md5";
 const getGravatarUrl = (email, size) => {
+  if (!Number.isInteger(size) || size <= 0) {
+    throw new Error("size must be a positive integer");
+  }
   const normalizedEmail = email.trim().toLowerCase();
   const gravatarUrl = `https://www.gravatar.com/avatar/${md5(normalizedEmail)}?s=${size}&d=404`;
   return gravatarUrl;

package/dist/libs/get/{get-query-params.cjs.js → get-query-params.cjs}

@@ -6,7 +6,10 @@ const queryStringOptions = {
   parseNumbers: true
 };
 const getQueryParams = (query, options = {}) => {
-  const { searchString = window.location.search, parseOptions } = options;
+  const {
+    searchString = typeof window === "undefined" ? "" : window.location.search,
+    parseOptions
+  } = options;
   const queryOptions = {
     ...queryStringOptions,
     ...parseOptions

package/dist/libs/get/get-query-params.d.ts

@@ -10,5 +10,6 @@ export type GetQueryParamsOptions = {
  * @param query - The name of the query parameter to retrieve.
  * @param options - Optional. An object containing searchString and parseOptions.
  * @returns The value of the query parameter, which can be a string, number, array of strings or numbers, or null if the parameter is not found.
+ * In SSR environments where window is undefined, `searchString` defaults to an empty string.
  */
 export declare const getQueryParams: (query: string, options?: GetQueryParamsOptions) => GetQueryParamsReturnType;