umaki 0.7.5 → 0.8.0

package/README.md

@@ -18,6 +18,18 @@
 
 Umaki is your one-stop solution for web development utilities, bringing together a carefully curated collection of powerful tools in a single, easy-to-use package. Crafted from real-world development experience, these utilities solve common challenges and streamline your workflow. Have a utility in mind that would make your development easier? Feel free to open an issue—I'm actively expanding this collection!
 
+**👨‍💻 Related Projects**
+
+| Project                                           | Description                                   | Use Case                      |
+| ------------------------------------------------- | --------------------------------------------- | ----------------------------- |
+| [piiiQcy](https://github.com/TsubasaHiga/piiiqcy) | WordPress theme development boilerplate       | WordPress site development    |
+| [Acty](https://github.com/TsubasaHiga/acty)       | Static site boilerplate                       | Static HTML/CSS site creation |
+| [Quicint](https://github.com/TsubasaHiga/Quicint) | EJS-based static HTML5 boilerplate            | Mass-production static pages  |
+| [vnl](https://github.com/TsubasaHiga/vnl)         | Vite-based npm library development boilerplate | npm package development       |
+| [umaki](https://github.com/TsubasaHiga/umaki)     | Web development utility library               | Common utility functions      |
+
+---
+
 ## Usage
 
 ```ts
@@ -64,6 +76,9 @@ console.log(breakpoint); // e.g. 768 (default) or custom value if set
 
 ## List of Utilities
 
+- [Callback](#callback)
+  - [tap](#tap)
+  - [tapAsync](#tapasync)
 - [Control](#control)
   - [bgScrollStop](#bgscrollstop)
   - [pd](#pd)
@@ -124,6 +139,69 @@ console.log(breakpoint); // e.g. 768 (default) or custom value if set
   - [waitForAllMediaLoaded](#waitforallmedialoaded)
 - [Security](#security)
   - [sanitizeHtml](#sanitizehtml)
+- [Advanced Usage](#advanced-usage)
+  - [Using tap / tapAsync with umaki functions](#using-tap--tapasync-with-umaki-functions)
+
+## Callback
+
+### tap
+
+A function that executes a callback with the given value and returns the original value unchanged. Useful for performing side effects (logging, caching, analytics, etc.) without modifying the value.
+
+**Note:** This function does not accept Promise values. For async operations, use `tapAsync` instead.
+
+```ts
+import { tap, removeAllHtmlTags } from "umaki";
+
+const input = "<p>Hello <strong>World</strong>!</p>";
+const output = tap(removeAllHtmlTags(input), (result) => {
+  console.log("Sanitized:", result);
+});
+// Logs: 'Sanitized: Hello World!'
+// output = 'Hello World!'
+
+// Caching example
+const data = tap(processData(raw), (result) => {
+  cache.set("processed", result);
+});
+
+// Works with higher-order functions
+const debouncedFn = tap(debounce(handler, 100), () => {
+  console.log("Debounced function created");
+});
+```
+
+[View file →](src/libs/callback/tap.ts)
+
+### tapAsync (Promise)
+
+A function that awaits a Promise, executes a callback with the resolved value, and returns the original value. Useful for performing side effects on async values without modifying them.
+
+```ts
+import { tapAsync } from "umaki";
+
+// Logging async results
+const data = await tapAsync(fetchData(), (result) => {
+  console.log("Fetched:", result);
+});
+
+// Caching async results
+const getData = () =>
+  tapAsync(fetchFromServer(), (data) => cache.set("data", data));
+
+// Parallel execution with individual completion tracking
+await Promise.all([
+  tapAsync(fetchUserData(), (user) => console.log("user loaded")),
+  tapAsync(fetchProductData(), (products) => console.log("products loaded")),
+  tapAsync(fetchOrderData(), (orders) => console.log("orders loaded")),
+]);
+
+// Event emission on async completion
+const loadUser = () =>
+  tapAsync(fetchUser(), (user) => eventEmitter.emit("userLoaded", user));
+```
+
+[View file →](src/libs/callback/tap-async.ts)
 
 ## Control
 
@@ -916,6 +994,144 @@ This function uses `isomorphic-dompurify` and has the following features:
 
 [View file →](src/libs/security/htmlSanitize.ts)
 
+## Advanced Usage
+
+This section provides tips and patterns for getting the most out of umaki utilities.
+
+### Using `tap` / `tapAsync` with umaki functions
+
+The `tap` and `tapAsync` functions allow you to add callbacks to any umaki function without modifying its behavior. This is useful for logging, analytics, caching, and more.
+
+#### Basic Pattern
+
+| Function Type | Use | Example |
+|---------------|-----|---------|
+| Sync (returns value) | `tap` | `tap(removeAllHtmlTags(input), callback)` |
+| Sync (returns void) | `tap` | `tap(set100vh(), callback)` |
+| Async (returns Promise) | `tapAsync` | `tapAsync(sleep(1), callback)` |
+
+> [!TIP]
+> `tap` prevents Promise values at the type level. If you accidentally pass a Promise, TypeScript will show an error.
+
+#### Examples with umaki functions
+
+<details>
+<summary><strong>📝 Logging & Debugging</strong></summary>
+
+```ts
+import { tap, removeAllHtmlTags, getUaData } from "umaki";
+
+// Log sanitized HTML output
+const clean = tap(removeAllHtmlTags(dirtyHtml), (result) => {
+  console.log("[DEBUG] Sanitized HTML:", result);
+});
+
+// Log user agent data
+const ua = tap(getUaData(), (data) => {
+  console.log("[DEBUG] UA:", data.browserName, data.osName);
+});
+```
+
+</details>
+
+<details>
+<summary><strong>📊 Analytics & Tracking</strong></summary>
+
+```ts
+import { tap, tapAsync, getUaData, waitForAllMediaLoaded } from "umaki";
+
+// Track device information
+const uaData = tap(getUaData(), (data) => {
+  analytics.track("device_detected", {
+    browser: data.browserName,
+    os: data.osName,
+    type: data.type,
+  });
+});
+
+// Track media load completion
+await tapAsync(waitForAllMediaLoaded(), (success) => {
+  analytics.track("media_loaded", { success, timestamp: Date.now() });
+});
+```
+
+</details>
+
+<details>
+<summary><strong>💾 Caching</strong></summary>
+
+```ts
+import { tap, tapAsync, getScrollbarWidth } from "umaki";
+
+// Cache scrollbar width (useful for repeated access)
+const scrollbarWidth = tap(getScrollbarWidth(), (width) => {
+  sessionStorage.setItem("scrollbarWidth", String(width));
+});
+
+// Cache async fetch results
+const getData = () =>
+  tapAsync(fetchFromAPI(), (data) => {
+    localStorage.setItem("cachedData", JSON.stringify(data));
+  });
+```
+
+</details>
+
+<details>
+<summary><strong>🎯 Event Emission</strong></summary>
+
+```ts
+import { tap, tapAsync, checkDeviceSize, waitForAllMediaLoaded } from "umaki";
+
+// Emit event on device size check
+const deviceSize = tap(checkDeviceSize(), (size) => {
+  window.dispatchEvent(new CustomEvent("deviceSizeChecked", { detail: size }));
+});
+
+// Emit event when all media is loaded
+await tapAsync(waitForAllMediaLoaded(true), () => {
+  window.dispatchEvent(new CustomEvent("firstViewMediaReady"));
+});
+```
+
+</details>
+
+<details>
+<summary><strong>⚡ Parallel Async Operations</strong></summary>
+
+```ts
+import { tapAsync, sleep, waitForAllMediaLoaded } from "umaki";
+
+// Track multiple async operations independently
+const [_, mediaLoaded] = await Promise.all([
+  tapAsync(sleep(1), () => console.log("⏱️ 1 second elapsed")),
+  tapAsync(waitForAllMediaLoaded(), (ok) => console.log("🖼️ Media:", ok ? "ready" : "failed")),
+]);
+```
+
+</details>
+
+#### Working with void functions
+
+> [!NOTE]
+> When using `tap` with functions that return `void` (like `set100vh`, `bgScrollStop`), the callback receives `undefined`. This is still useful for completion notifications.
+
+```ts
+import { tap, set100vh, bgScrollStop } from "umaki";
+
+// Notification when viewport units are set
+tap(set100vh(), () => {
+  console.log("✅ 100vh CSS variable has been set");
+});
+
+// Notification when scroll is stopped
+tap(bgScrollStop(true), () => {
+  console.log("🔒 Background scroll locked");
+});
+```
+
+---
+
 ## Using for framework and tools
 
 Specific usage for frameworks or various tools is described below.

package/dist/index.cjs.js

@@ -1,57 +1,61 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const defaultConfig = require("./libs/config/defaultConfig.cjs.js");
-const getConfig = require("./libs/config/getConfig.cjs.js");
-const setConfig = require("./libs/config/setConfig.cjs.js");
-const bgScrollStop = require("./libs/control/bgScrollStop.cjs.js");
+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 pd = require("./libs/control/pd.cjs.js");
-const scrollToHash = require("./libs/control/scrollToHash.cjs.js");
-const videoPlayControl = require("./libs/control/videoPlayControl.cjs.js");
-const changeDateStringToSpecificFormat = require("./libs/convert/changeDateStringToSpecificFormat.cjs.js");
-const jsonStringToJsonObject = require("./libs/convert/jsonStringToJsonObject.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 jsonStringToJsonObject = require("./libs/convert/json-string-to-json-object.cjs.js");
 const debounce = require("./libs/eventControl/debounce.cjs.js");
 const throttle = require("./libs/eventControl/throttle.cjs.js");
-const getAspectRatio = require("./libs/get/getAspectRatio.cjs.js");
-const getClassNames = require("./libs/get/getClassNames.cjs.js");
-const getDocumentHeight = require("./libs/get/getDocumentHeight.cjs.js");
-const getEventPaths = require("./libs/get/getEventPaths.cjs.js");
-const getGcd = require("./libs/get/getGcd.cjs.js");
-const getGravatarUrl = require("./libs/get/getGravatarUrl.cjs.js");
-const getOrientation = require("./libs/get/getOrientation.cjs.js");
-const getParentList = require("./libs/get/getParentList.cjs.js");
-const getQueryParams = require("./libs/get/getQueryParams.cjs.js");
-const getRem = require("./libs/get/getRem.cjs.js");
-const getScrollbarWidth = require("./libs/get/getScrollbarWidth.cjs.js");
-const getSessionStorage = require("./libs/get/getSessionStorage.cjs.js");
-const getStringLength = require("./libs/get/getStringLength.cjs.js");
-const getStylePropertyValue = require("./libs/get/getStylePropertyValue.cjs.js");
-const getStylePropertyValueToNumber = require("./libs/get/getStylePropertyValueToNumber.cjs.js");
-const getUaData = require("./libs/get/getUaData.cjs.js");
-const checkDeviceSize = require("./libs/is/checkDeviceSize.cjs.js");
-const isAfterDateTime = require("./libs/is/isAfterDateTime.cjs.js");
-const isBetweenDateTime = require("./libs/is/isBetweenDateTime.cjs.js");
-const isExistAllElements = require("./libs/is/isExistAllElements.cjs.js");
-const isIpad = require("./libs/is/isIpad.cjs.js");
-const isKeyExists = require("./libs/is/isKeyExists.cjs.js");
-const isSafari = require("./libs/is/isSafari.cjs.js");
-const isScrollable = require("./libs/is/isScrollable.cjs.js");
-const isTouchSupport = require("./libs/is/isTouchSupport.cjs.js");
-const removeAllHtmlTags = require("./libs/remove/removeAllHtmlTags.cjs.js");
-const removeAttribute = require("./libs/remove/removeAttribute.cjs.js");
-const removeSessionStorage = require("./libs/remove/removeSessionStorage.cjs.js");
-const removeStylePropertyValue = require("./libs/remove/removeStylePropertyValue.cjs.js");
-const htmlSanitize = require("./libs/security/htmlSanitize.cjs.js");
-const set100vh = require("./libs/set/set100vh.cjs.js");
-const set100vw = require("./libs/set/set100vw.cjs.js");
-const setAttribute = require("./libs/set/setAttribute.cjs.js");
-const setScrollPositionToCenter = require("./libs/set/setScrollPositionToCenter.cjs.js");
-const setSessionStorage = require("./libs/set/setSessionStorage.cjs.js");
-const setStylePropertyValue = require("./libs/set/setStylePropertyValue.cjs.js");
-const toBoolean = require("./libs/to/toBoolean.cjs.js");
-const toPositiveNumber = require("./libs/to/toPositiveNumber.cjs.js");
-const wrapTextWithSpans = require("./libs/transform/wrapTextWithSpans.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 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 isIpad = require("./libs/is/is-ipad.cjs.js");
+const isKeyExists = require("./libs/is/is-key-exists.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/waitForAllMediaLoaded.cjs.js");
+const waitForAllMediaLoaded = require("./libs/wait/wait-for-all-media-loaded.cjs.js");
+exports.tap = tap.tap;
+exports.tapAsync = tapAsync.tapAsync;
 exports.defaultConfig = defaultConfig.defaultConfig;
 exports.getConfig = getConfig.getConfig;
 exports.getConfigValue = getConfig.getConfigValue;

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from './libs/callback';
 export * from './libs/config';
 export * from './libs/control';
 export * from './libs/convert';

package/dist/index.es.js

@@ -1,55 +1,57 @@
-import { defaultConfig } from "./libs/config/defaultConfig.es.js";
-import { getConfig, getConfigValue } from "./libs/config/getConfig.es.js";
-import { setConfig } from "./libs/config/setConfig.es.js";
-import { bgScrollStop } from "./libs/control/bgScrollStop.es.js";
+import { tap } from "./libs/callback/tap.es.js";
+import { tapAsync } from "./libs/callback/tap-async.es.js";
+import { defaultConfig } from "./libs/config/default-config.es.js";
+import { 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 { pd } from "./libs/control/pd.es.js";
-import { scrollToHash } from "./libs/control/scrollToHash.es.js";
-import { videoPlayControl } from "./libs/control/videoPlayControl.es.js";
-import { changeDateStringToSpecificFormat } from "./libs/convert/changeDateStringToSpecificFormat.es.js";
-import { jsonStringToJsonObject } from "./libs/convert/jsonStringToJsonObject.es.js";
+import { scrollToHash } from "./libs/control/scroll-to-hash.es.js";
+import { videoPlayControl } from "./libs/control/video-play-control.es.js";
+import { changeDateStringToSpecificFormat } from "./libs/convert/change-date-string-to-specific-format.es.js";
+import { jsonStringToJsonObject } from "./libs/convert/json-string-to-json-object.es.js";
 import { debounce } from "./libs/eventControl/debounce.es.js";
 import { throttle } from "./libs/eventControl/throttle.es.js";
-import { getAspectRatio } from "./libs/get/getAspectRatio.es.js";
-import { getClassNames } from "./libs/get/getClassNames.es.js";
-import { getDocumentHeight } from "./libs/get/getDocumentHeight.es.js";
-import { getEventPaths } from "./libs/get/getEventPaths.es.js";
-import { getGcd } from "./libs/get/getGcd.es.js";
-import { getGravatarUrl } from "./libs/get/getGravatarUrl.es.js";
-import { getOrientation } from "./libs/get/getOrientation.es.js";
-import { getParentList } from "./libs/get/getParentList.es.js";
-import { getQueryParams } from "./libs/get/getQueryParams.es.js";
-import { getRem } from "./libs/get/getRem.es.js";
-import { getScrollbarWidth } from "./libs/get/getScrollbarWidth.es.js";
-import { getSessionStorage } from "./libs/get/getSessionStorage.es.js";
-import { getStringLength } from "./libs/get/getStringLength.es.js";
-import { getStylePropertyValue } from "./libs/get/getStylePropertyValue.es.js";
-import { getStylePropertyValueToNumber } from "./libs/get/getStylePropertyValueToNumber.es.js";
-import { getUaData } from "./libs/get/getUaData.es.js";
-import { checkDeviceSize } from "./libs/is/checkDeviceSize.es.js";
-import { isAfterDateTime } from "./libs/is/isAfterDateTime.es.js";
-import { isBetweenDateTime } from "./libs/is/isBetweenDateTime.es.js";
-import { isExistAllElements } from "./libs/is/isExistAllElements.es.js";
-import { isIpad } from "./libs/is/isIpad.es.js";
-import { isKeyExists } from "./libs/is/isKeyExists.es.js";
-import { isSafari } from "./libs/is/isSafari.es.js";
-import { isScrollable } from "./libs/is/isScrollable.es.js";
-import { isTouchSupport } from "./libs/is/isTouchSupport.es.js";
-import { removeAllHtmlTags } from "./libs/remove/removeAllHtmlTags.es.js";
-import { removeAttribute } from "./libs/remove/removeAttribute.es.js";
-import { removeSessionStorage } from "./libs/remove/removeSessionStorage.es.js";
-import { removeStylePropertyValue } from "./libs/remove/removeStylePropertyValue.es.js";
-import { htmlSanitize } from "./libs/security/htmlSanitize.es.js";
-import { set100vh } from "./libs/set/set100vh.es.js";
-import { set100vw } from "./libs/set/set100vw.es.js";
-import { setAttribute } from "./libs/set/setAttribute.es.js";
-import { setScrollPositionToCenter } from "./libs/set/setScrollPositionToCenter.es.js";
-import { setSessionStorage } from "./libs/set/setSessionStorage.es.js";
-import { setStylePropertyValue } from "./libs/set/setStylePropertyValue.es.js";
-import { toBoolean } from "./libs/to/toBoolean.es.js";
-import { toPositiveNumber } from "./libs/to/toPositiveNumber.es.js";
-import { wrapTextWithSpans } from "./libs/transform/wrapTextWithSpans.es.js";
+import { getAspectRatio } from "./libs/get/get-aspect-ratio.es.js";
+import { getClassNames } from "./libs/get/get-class-names.es.js";
+import { getDocumentHeight } from "./libs/get/get-document-height.es.js";
+import { getEventPaths } from "./libs/get/get-event-paths.es.js";
+import { getGcd } from "./libs/get/get-gcd.es.js";
+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 { 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";
+import { getStringLength } from "./libs/get/get-string-length.es.js";
+import { getStylePropertyValue } from "./libs/get/get-style-property-value.es.js";
+import { getStylePropertyValueToNumber } from "./libs/get/get-style-property-value-to-number.es.js";
+import { getUaData } from "./libs/get/get-ua-data.es.js";
+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 { isIpad } from "./libs/is/is-ipad.es.js";
+import { isKeyExists } from "./libs/is/is-key-exists.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";
+import { removeAllHtmlTags } from "./libs/remove/remove-all-html-tags.es.js";
+import { removeAttribute } from "./libs/remove/remove-attribute.es.js";
+import { removeSessionStorage } from "./libs/remove/remove-session-storage.es.js";
+import { removeStylePropertyValue } from "./libs/remove/remove-style-property-value.es.js";
+import { htmlSanitize } from "./libs/security/html-sanitize.es.js";
+import { set100vh } from "./libs/set/set-100vh.es.js";
+import { set100vw } from "./libs/set/set-100vw.es.js";
+import { setAttribute } from "./libs/set/set-attribute.es.js";
+import { setScrollPositionToCenter } from "./libs/set/set-scroll-position-to-center.es.js";
+import { setSessionStorage } from "./libs/set/set-session-storage.es.js";
+import { setStylePropertyValue } from "./libs/set/set-style-property-value.es.js";
+import { toBoolean } from "./libs/to/to-boolean.es.js";
+import { toPositiveNumber } from "./libs/to/to-positive-number.es.js";
+import { wrapTextWithSpans } from "./libs/transform/wrap-text-with-spans.es.js";
 import { sleep } from "./libs/wait/sleep.es.js";
-import { waitForAllMediaLoaded } from "./libs/wait/waitForAllMediaLoaded.es.js";
+import { waitForAllMediaLoaded } from "./libs/wait/wait-for-all-media-loaded.es.js";
 export {
   bgScrollStop,
   changeDateStringToSpecificFormat,
@@ -98,6 +100,8 @@ export {
   setSessionStorage,
   setStylePropertyValue,
   sleep,
+  tap,
+  tapAsync,
   throttle,
   toBoolean,
   toPositiveNumber,

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

@@ -0,0 +1,5 @@
+/**
+ * Callback functions
+ */
+export { tap } from './tap';
+export { tapAsync } from './tap-async';

package/dist/libs/callback/tap-async.cjs.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const tapAsync = async (promise, callback) => {
+  const value = await promise;
+  callback(value);
+  return value;
+};
+exports.tapAsync = tapAsync;

package/dist/libs/callback/tap-async.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Awaits a Promise, executes a callback with the resolved value, and returns the original value.
+ * Useful for performing side effects (logging, caching, analytics, etc.) on async values without modifying them.
+ *
+ * @param promise - The Promise to await.
+ * @param callback - A function that receives the resolved value. Its return value is ignored.
+ * @returns A Promise that resolves to the original value.
+ *
+ * @example
+ * ```ts
+ * import { tapAsync } from 'umaki'
+ *
+ * // Logging async results
+ * const data = await tapAsync(fetchData(), (result) => {
+ *   console.log('Fetched:', result)
+ * })
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Caching async results
+ * const getData = () => tapAsync(
+ *   fetchFromServer(),
+ *   (data) => cache.set('data', data)
+ * )
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Parallel execution with individual completion tracking
+ * await Promise.all([
+ *   tapAsync(fetchUserData(), (user) => console.log('user loaded')),
+ *   tapAsync(fetchProductData(), (products) => console.log('products loaded')),
+ *   tapAsync(fetchOrderData(), (orders) => console.log('orders loaded'))
+ * ])
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Event emission on async completion
+ * const loadUser = () => tapAsync(
+ *   fetchUser(),
+ *   (user) => eventEmitter.emit('userLoaded', user)
+ * )
+ * ```
+ */
+export declare const tapAsync: <T>(promise: Promise<T>, callback: (value: T) => void) => Promise<T>;

package/dist/libs/callback/tap-async.es.js

@@ -0,0 +1,8 @@
+const tapAsync = async (promise, callback) => {
+  const value = await promise;
+  callback(value);
+  return value;
+};
+export {
+  tapAsync
+};

package/dist/libs/callback/tap.cjs.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const tap = (value, callback) => {
+  callback(value);
+  return value;
+};
+exports.tap = tap;

package/dist/libs/callback/tap.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Type that excludes Promise types.
+ * Used to prevent passing async values to synchronous tap function.
+ */
+type NotPromise<T> = T extends Promise<unknown> ? never : T;
+/**
+ * Executes a callback with the given value and returns the original value unchanged.
+ * Useful for performing side effects (logging, analytics, etc.) in a pipeline without modifying the value.
+ *
+ * @param value - The value to pass to the callback. Must not be a Promise (use tapAsync for async values).
+ * @param callback - A function that receives the value. Its return value is ignored.
+ * @returns The original value unchanged.
+ *
+ * @example
+ * ```ts
+ * import { tap, removeAllHtmlTags } from 'umaki'
+ *
+ * const input = '<p>Hello <strong>World</strong>!</p>'
+ * const output = tap(removeAllHtmlTags(input), (result) => {
+ *   console.log('Sanitized:', result)
+ * })
+ * // Logs: 'Sanitized: Hello World!'
+ * // output = 'Hello World!'
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Caching example
+ * const data = tap(processData(raw), (result) => {
+ *   cache.set('processed', result)
+ * })
+ * ```
+ */
+export declare const tap: <T>(value: NotPromise<T>, callback: (value: T) => void) => T;
+export {};

package/dist/libs/callback/tap.es.js

@@ -0,0 +1,7 @@
+const tap = (value, callback) => {
+  callback(value);
+  return value;
+};
+export {
+  tap
+};

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

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

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

@@ -1,4 +1,4 @@
-import { defaultConfig } from "./defaultConfig.es.js";
+import { defaultConfig } from "./default-config.es.js";
 const currentConfig = { ...defaultConfig };
 const getConfig = () => {
   return { ...currentConfig };

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

@@ -1,7 +1,7 @@
 /**
  * Configuration functions
  */
-export { defaultConfig } from './defaultConfig';
-export { getConfig, getConfigValue } from './getConfig';
-export { setConfig } from './setConfig';
+export { defaultConfig } from './default-config';
+export { getConfig, getConfigValue } from './get-config';
+export { setConfig } from './set-config';
 export type { UmakiConfig } from './types';

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

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