@omerdlw/base-framework 1.0.0 → 1.0.1

package/dist/index.js

@@ -1,7 +1,7 @@
 "use client";
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
-import React2, { memo, createContext, createElement, isValidElement, cloneElement, Suspense, useState, useRef, useEffect, useMemo, useCallback, use, useSyncExternalStore, useContext, useTransition, useId, Fragment as Fragment$1, useLayoutEffect, useInsertionEffect, Children, useReducer, lazy } from 'react';
+import React2, { memo, createContext, createElement, isValidElement, cloneElement, Suspense, useState, useRef, useEffect, useMemo, useCallback, use, useSyncExternalStore, useContext, useId, Fragment as Fragment$1, useLayoutEffect, useInsertionEffect, Children, useReducer, lazy } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { usePathname, useRouter } from 'next/navigation';
 import { Icon as Icon$1 } from '@iconify-icon/react';
@@ -91,43 +91,6 @@ var init_cn = __esm({
   }
 });
 
-// src/utils/string.ts
-function trimToNull(value) {
-  if (value === null || value === void 0) return null;
-  const trimmed = String(value).trim();
-  return trimmed.length > 0 ? trimmed : null;
-}
-function stripTrailingSlash(url) {
-  if (typeof url !== "string") return "";
-  return url.replace(/\/+$/, "");
-}
-function normalizePath(path) {
-  const trimmed = trimToNull(path);
-  if (!trimmed) return "";
-  if (trimmed === "/") return "/";
-  return stripTrailingSlash(trimmed);
-}
-function isImageIconSource(icon) {
-  return typeof icon === "string" && (icon.startsWith("http://") || icon.startsWith("https://") || icon.startsWith("/") || icon.startsWith("data:image/"));
-}
-function truncate(text, maxLength = 100, suffix = "...") {
-  if (typeof text !== "string") return "";
-  if (text.length <= maxLength) return text;
-  return `${text.slice(0, maxLength).trimEnd()}${suffix}`;
-}
-function capitalize(str) {
-  if (typeof str !== "string" || !str) return "";
-  return str.charAt(0).toUpperCase() + str.slice(1);
-}
-function slugify(str) {
-  if (typeof str !== "string" || !str) return "";
-  return str.toLowerCase().trim().replace(/[^\w\s-]/g, "").replace(/[\s_-]+/g, "-").replace(/^-+|-+$/g, "");
-}
-var init_string = __esm({
-  "src/utils/string.ts"() {
-  }
-});
-
 // src/utils/dom.ts
 function acquireGlobalScrollLock() {
   if (typeof document === "undefined") return () => {
@@ -158,25 +121,39 @@ function acquireGlobalScrollLock() {
     globalScrollLockStyles = null;
   };
 }
-function getSiteUrl() {
-  return stripTrailingSlash(
-    process.env.NEXT_PUBLIC_SITE_URL || "http://localhost:3000"
-  );
-}
-function getCurrentPath() {
-  if (!isBrowser) return "/";
-  return `${window.location.pathname}${window.location.search}`;
-}
 var isBrowser, globalScrollLockCount, globalScrollLockStyles;
 var init_dom = __esm({
   "src/utils/dom.ts"() {
-    init_string();
     isBrowser = typeof window !== "undefined";
     globalScrollLockCount = 0;
     globalScrollLockStyles = null;
   }
 });
 
+// src/utils/string.ts
+function trimToNull(value) {
+  if (value === null || value === void 0) return null;
+  const trimmed = String(value).trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function stripTrailingSlash(url) {
+  if (typeof url !== "string") return "";
+  return url.replace(/\/+$/, "");
+}
+function normalizePath(path) {
+  const trimmed = trimToNull(path);
+  if (!trimmed) return "";
+  if (trimmed === "/") return "/";
+  return stripTrailingSlash(trimmed);
+}
+function isImageIconSource(icon) {
+  return typeof icon === "string" && (icon.startsWith("http://") || icon.startsWith("https://") || icon.startsWith("/") || icon.startsWith("data:image/"));
+}
+var init_string = __esm({
+  "src/utils/string.ts"() {
+  }
+});
+
 // src/utils/number.ts
 function clamp(value, min, max) {
   const num = Number(value);
@@ -187,11 +164,6 @@ function toFiniteNumber(value, fallback = 0) {
   const parsed = Number(value);
   return Number.isFinite(parsed) ? parsed : fallback;
 }
-function randomBetween(min, max) {
-  const lower = Math.ceil(min);
-  const upper = Math.floor(max);
-  return Math.floor(Math.random() * (upper - lower + 1)) + lower;
-}
 var init_number = __esm({
   "src/utils/number.ts"() {
   }
@@ -206,13 +178,6 @@ function isPlainObject(value) {
   const proto = Object.getPrototypeOf(value);
   return proto === Object.prototype || proto === null;
 }
-function isEmpty(value) {
-  if (value === null || value === void 0) return true;
-  if (typeof value === "string" || Array.isArray(value))
-    return value.length === 0;
-  if (isObject(value)) return Object.keys(value).length === 0;
-  return false;
-}
 function shallowEqual(a, b) {
   if (Object.is(a, b)) return true;
   if (typeof a !== "object" || a === null || typeof b !== "object" || b === null) {
@@ -235,26 +200,12 @@ function toArray(value) {
   if (value === null || value === void 0) return [];
   return Array.isArray(value) ? value : [value];
 }
-function dedupe(array, keyFn = null) {
-  if (!Array.isArray(array)) return [];
-  if (!keyFn) return [...new Set(array)];
-  const seen = /* @__PURE__ */ new Set();
-  return array.filter((item) => {
-    const key = keyFn(item);
-    if (seen.has(key)) return false;
-    seen.add(key);
-    return true;
-  });
-}
 var init_object = __esm({
   "src/utils/object.ts"() {
   }
 });
 
 // src/utils/timing.ts
-function sleep(ms = 0) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
 function debounce(func, wait = 300) {
   let timeoutId = null;
   function debounced(...args) {
@@ -303,27 +254,6 @@ var init_timing = __esm({
   }
 });
 
-// src/utils/json.ts
-function safeJsonParse(text, fallback = null) {
-  if (typeof text !== "string") return fallback;
-  try {
-    return JSON.parse(text);
-  } catch {
-    return fallback;
-  }
-}
-function safeJsonStringify(value, fallback = "") {
-  try {
-    return JSON.stringify(value) ?? fallback;
-  } catch {
-    return fallback;
-  }
-}
-var init_json = __esm({
-  "src/utils/json.ts"() {
-  }
-});
-
 // src/utils/report.ts
 function report(scope, error, level = "error") {
   if (sink) {
@@ -621,7 +551,6 @@ var init_utils = __esm({
     init_number();
     init_object();
     init_timing();
-    init_json();
     init_report();
     init_user_message();
     init_store();
@@ -1233,170 +1162,6 @@ var init_use_isomorphic_layout_effect = __esm({
     useIsomorphicLayoutEffect = isBrowser ? useLayoutEffect : useEffect;
   }
 });
-function useDebounce(value, delay = 300) {
-  const [debouncedValue, setDebouncedValue] = useState(value);
-  useEffect(() => {
-    const timer = setTimeout(() => setDebouncedValue(value), delay);
-    return () => clearTimeout(timer);
-  }, [value, delay]);
-  return debouncedValue;
-}
-var init_use_debounce = __esm({
-  "src/hooks/use-debounce.ts"() {
-    "use client";
-  }
-});
-function useMounted() {
-  return useSyncExternalStore(
-    emptySubscribe,
-    () => true,
-    () => false
-  );
-}
-var emptySubscribe;
-var init_use_mounted = __esm({
-  "src/hooks/use-mounted.ts"() {
-    "use client";
-    emptySubscribe = () => () => {
-    };
-  }
-});
-function useMediaQuery(query, serverFallback = false) {
-  const subscribe2 = useCallback(
-    (onStoreChange) => {
-      if (!isBrowser || !query || typeof window.matchMedia !== "function") {
-        return () => {
-        };
-      }
-      const mediaQueryList = window.matchMedia(query);
-      mediaQueryList.addEventListener("change", onStoreChange);
-      return () => mediaQueryList.removeEventListener("change", onStoreChange);
-    },
-    [query]
-  );
-  const getSnapshot2 = useCallback(() => {
-    if (!isBrowser || !query || typeof window.matchMedia !== "function") {
-      return serverFallback;
-    }
-    return window.matchMedia(query).matches;
-  }, [query, serverFallback]);
-  const getServerSnapshot = useCallback(() => serverFallback, [serverFallback]);
-  return useSyncExternalStore(subscribe2, getSnapshot2, getServerSnapshot);
-}
-var init_use_media_query = __esm({
-  "src/hooks/use-media-query.ts"() {
-    "use client";
-    init_utils();
-  }
-});
-function useControllableState({
-  defaultValue,
-  onChange,
-  value
-}) {
-  const [uncontrolledValue, setUncontrolledValue] = useState(defaultValue);
-  const isControlled = value !== void 0;
-  const currentValue = isControlled ? value : uncontrolledValue;
-  const valueRef = useRef(currentValue);
-  const onChangeRef = useRef(onChange);
-  useIsomorphicLayoutEffect(() => {
-    valueRef.current = currentValue;
-    onChangeRef.current = onChange;
-  });
-  const setValue = useCallback(
-    (next) => {
-      const resolvedNext = typeof next === "function" ? next(valueRef.current) : next;
-      if (!Object.is(valueRef.current, resolvedNext)) {
-        if (!isControlled) {
-          setUncontrolledValue(resolvedNext);
-        }
-        onChangeRef.current?.(resolvedNext);
-      }
-    },
-    [isControlled]
-  );
-  return [currentValue, setValue];
-}
-var init_use_controllable_state = __esm({
-  "src/hooks/use-controllable-state.ts"() {
-    "use client";
-    init_use_isomorphic_layout_effect();
-  }
-});
-function isEditableElement(target) {
-  if (!target || typeof target.tagName !== "string") {
-    return false;
-  }
-  const element = target;
-  const tagName = element.tagName.toLowerCase();
-  if (tagName === "input" || tagName === "textarea" || tagName === "select") {
-    return true;
-  }
-  return Boolean(element.isContentEditable);
-}
-function matchesKeyCombo(event, combo) {
-  const parts = combo.toLowerCase().split("+").map((p) => p.trim()).filter(Boolean);
-  if (parts.length === 0) return false;
-  const keyPart = parts[parts.length - 1];
-  const modifiers = new Set(parts.slice(0, -1));
-  const wantsMod = modifiers.has("mod") || modifiers.has("cmd") || modifiers.has("meta");
-  const wantsCtrl = modifiers.has("ctrl") || modifiers.has("control");
-  const wantsAlt = modifiers.has("alt") || modifiers.has("option");
-  const wantsShift = modifiers.has("shift");
-  const isModPressed = event.metaKey || event.ctrlKey;
-  if (wantsMod && !isModPressed) return false;
-  if (!wantsMod && !wantsCtrl && (event.metaKey || event.ctrlKey)) return false;
-  if (wantsCtrl && !event.ctrlKey) return false;
-  if (wantsAlt !== event.altKey) return false;
-  if (wantsShift !== event.shiftKey) return false;
-  const pressedKey = event.key.toLowerCase();
-  if (keyPart === "esc" || keyPart === "escape") {
-    return pressedKey === "escape" || pressedKey === "esc";
-  }
-  if (keyPart === "space") {
-    return pressedKey === " " || pressedKey === "spacebar";
-  }
-  return pressedKey === keyPart;
-}
-function useHotkey(combo, callback, options) {
-  const callbackRef = useRef(callback);
-  useIsomorphicLayoutEffect(() => {
-    callbackRef.current = callback;
-  });
-  const enabled = options?.enabled ?? true;
-  const enableOnFormTags = options?.enableOnFormTags ?? false;
-  const preventDefault = options?.preventDefault ?? true;
-  const stopPropagation = options?.stopPropagation ?? false;
-  useEffect(() => {
-    if (!isBrowser || !enabled || !combo) return;
-    const combos = (Array.isArray(combo) ? combo : [combo]).filter(Boolean);
-    if (combos.length === 0) return;
-    const handleKeyDown = (event) => {
-      if (!enableOnFormTags && isEditableElement(event.target)) return;
-      const matched = combos.some((c) => matchesKeyCombo(event, c));
-      if (!matched) return;
-      if (preventDefault) event.preventDefault();
-      if (stopPropagation) event.stopPropagation();
-      callbackRef.current?.(event);
-    };
-    window.addEventListener("keydown", handleKeyDown);
-    return () => window.removeEventListener("keydown", handleKeyDown);
-  }, [combo, enabled, enableOnFormTags, preventDefault, stopPropagation]);
-}
-function useEscapeKey(callback, enabled = true) {
-  useHotkey("escape", callback, {
-    enabled,
-    enableOnFormTags: true,
-    preventDefault: false
-  });
-}
-var init_use_hotkey = __esm({
-  "src/hooks/use-hotkey.ts"() {
-    "use client";
-    init_utils();
-    init_use_isomorphic_layout_effect();
-  }
-});
 
 // src/events.ts
 var EVENT_TYPES, EventEmitter, GLOBAL_EVENTS_KEY, _global, globalEvents;
@@ -1540,48 +1305,6 @@ function useGlobalEvent(event, callback, options) {
     };
   }, [event, debounceMs, throttleMs]);
 }
-function useEventState(event, initialValue, reducer) {
-  const storeRef = useRef(null);
-  if (storeRef.current == null) {
-    storeRef.current = {
-      value: initialValue,
-      listeners: /* @__PURE__ */ new Set(),
-      reducer
-    };
-  }
-  useIsomorphicLayoutEffect(() => {
-    if (storeRef.current != null) {
-      storeRef.current.reducer = reducer;
-    }
-  });
-  const subscribe2 = useCallback(
-    (onStoreChange) => {
-      if (!event || !storeRef.current) return () => {
-      };
-      storeRef.current.listeners.add(onStoreChange);
-      const unsub = globalEvents.subscribe(event, (payload) => {
-        if (!storeRef.current) return;
-        const next = storeRef.current.reducer(storeRef.current.value, payload);
-        if (!Object.is(storeRef.current.value, next)) {
-          storeRef.current.value = next;
-          storeRef.current.listeners.forEach((listener) => listener());
-        }
-      });
-      return () => {
-        storeRef.current?.listeners.delete(onStoreChange);
-        unsub();
-      };
-    },
-    [event]
-  );
-  const getSnapshot2 = useCallback(() => {
-    return storeRef.current?.value ?? initialValue;
-  }, [initialValue]);
-  const getServerSnapshot = useCallback(() => {
-    return initialValue;
-  }, [initialValue]);
-  return useSyncExternalStore(subscribe2, getSnapshot2, getServerSnapshot);
-}
 var init_use_global_event = __esm({
   "src/hooks/use-global-event.ts"() {
     "use client";
@@ -1589,420 +1312,6 @@ var init_use_global_event = __esm({
     init_use_isomorphic_layout_effect();
   }
 });
-
-// src/result.ts
-function ok(data, code) {
-  return { data, success: true, ...code ? { code } : {} };
-}
-function err(error, code) {
-  return { error, success: false, ...code ? { code } : {} };
-}
-function isResult(value) {
-  return typeof value === "object" && value !== null && "success" in value && typeof value.success === "boolean" && ("data" in value && value.success === true || "error" in value && value.success === false);
-}
-function isOk(result) {
-  return result.success === true;
-}
-function isErr(result) {
-  return result.success === false;
-}
-function unwrap(result) {
-  if (result.success) {
-    return result.data;
-  }
-  if (result.error instanceof Error) {
-    throw result.error;
-  }
-  throw new Error(
-    typeof result.error === "string" ? result.error : String(result.error)
-  );
-}
-function unwrapOr(result, fallback) {
-  return result.success ? result.data : fallback;
-}
-function map(result, fn) {
-  return result.success ? ok(fn(result.data), result.code) : result;
-}
-function mapErr(result, fn) {
-  return result.success ? result : err(fn(result.error), result.code);
-}
-function match(result, branches) {
-  return result.success ? branches.ok(result.data) : branches.err(result.error);
-}
-function mapCaught(error, mapError) {
-  if (!(error instanceof UserError)) report("Result", error);
-  return mapError ? mapError(error) : toUserMessage(error);
-}
-async function tryCatch(promiseOrFn, mapError) {
-  try {
-    const data = typeof promiseOrFn === "function" ? await promiseOrFn() : await promiseOrFn;
-    return ok(data);
-  } catch (error) {
-    return err(mapCaught(error, mapError));
-  }
-}
-function createSafeAction(handler, options = {}) {
-  const { errorCode, mapError, schema, validate } = options;
-  return async (...args) => {
-    try {
-      let effectiveArgs = args;
-      if (schema) {
-        const parsed = schema.safeParse(args[0]);
-        if (!parsed.success) {
-          const issueMessage = parsed.error?.issues?.[0]?.message || parsed.error?.message || "Invalid input";
-          return err(
-            mapError ? mapError(issueMessage) : issueMessage,
-            errorCode ?? "VALIDATION_ERROR"
-          );
-        }
-        effectiveArgs = [parsed.data, ...args.slice(1)];
-      }
-      if (validate) {
-        const validationResult = validate(...effectiveArgs);
-        if (isResult(validationResult)) {
-          if (isErr(validationResult)) {
-            return validationResult;
-          }
-        } else if (validationResult === false) {
-          return err(
-            mapError ? mapError("Validation failed") : "Validation failed",
-            errorCode ?? "VALIDATION_ERROR"
-          );
-        } else if (typeof validationResult === "string" && validationResult.length > 0) {
-          return err(
-            mapError ? mapError(validationResult) : validationResult,
-            errorCode ?? "VALIDATION_ERROR"
-          );
-        }
-      }
-      const output = await handler(...effectiveArgs);
-      if (isResult(output)) {
-        return output;
-      }
-      return ok(output);
-    } catch (error) {
-      return err(mapCaught(error, mapError), errorCode);
-    }
-  };
-}
-var init_result = __esm({
-  "src/result.ts"() {
-    init_user_message();
-    init_report();
-  }
-});
-function useAsyncAction(actionFn, options = {}) {
-  const {
-    errorMessage = null,
-    onError = null,
-    onSuccess = null,
-    successMessage = null,
-    toast = null
-  } = options;
-  const [isPending, setIsPending] = useState(false);
-  const [error, setError] = useState(null);
-  const execute = useCallback(
-    async (...args) => {
-      setIsPending(true);
-      setError(null);
-      try {
-        const result = await actionFn(...args);
-        if (isResult(result) && isErr(result)) {
-          setError(result.error);
-          const resolvedMessage = errorMessage || toUserMessage(result.error);
-          if (typeof toast === "function") {
-            toast(resolvedMessage);
-          }
-          globalEvents.emit(EVENT_TYPES.APP_ERROR, {
-            error: result.error,
-            message: resolvedMessage,
-            notify: toast === true
-          });
-          await onError?.(result.error);
-          return result;
-        }
-        if (successMessage) {
-          if (typeof toast === "function") {
-            toast(successMessage);
-          }
-          globalEvents.emit(EVENT_TYPES.STATE_CHANGE, {
-            message: successMessage,
-            notify: toast === true,
-            status: "success"
-          });
-        }
-        await onSuccess?.(result);
-        return result;
-      } catch (err2) {
-        setError(err2);
-        const resolvedMessage = errorMessage || toUserMessage(err2);
-        if (typeof toast === "function") {
-          toast(resolvedMessage);
-        }
-        globalEvents.emit(EVENT_TYPES.APP_ERROR, {
-          error: err2,
-          message: resolvedMessage,
-          notify: toast === true
-        });
-        await onError?.(err2);
-        throw err2;
-      } finally {
-        setIsPending(false);
-      }
-    },
-    [actionFn, errorMessage, onError, onSuccess, successMessage, toast]
-  );
-  return { error, execute, isPending };
-}
-var init_use_async_action = __esm({
-  "src/hooks/use-async-action.ts"() {
-    "use client";
-    init_events();
-    init_result();
-    init_utils();
-  }
-});
-function useServerAction(actionFn, options = {}) {
-  const {
-    errorMessage = null,
-    onError = null,
-    onSuccess = null,
-    successMessage = null,
-    toast = null
-  } = options;
-  const [isPending, startTransition] = useTransition();
-  const [data, setData] = useState(null);
-  const [error, setError] = useState(null);
-  const reset = useCallback(() => {
-    setData(null);
-    setError(null);
-  }, []);
-  const execute = useCallback(
-    (...args) => {
-      return new Promise((resolve) => {
-        startTransition(async () => {
-          setError(null);
-          try {
-            const result = await actionFn(...args);
-            if (isErr(result)) {
-              setError(result.error);
-              const resolvedMessage = errorMessage || toUserMessage(result.error);
-              if (typeof toast === "function") {
-                toast(resolvedMessage);
-              }
-              globalEvents.emit(EVENT_TYPES.APP_ERROR, {
-                error: result.error,
-                message: resolvedMessage,
-                notify: toast === true
-              });
-              await onError?.(result.error);
-              resolve(result);
-              return;
-            }
-            setData(result.data);
-            if (successMessage) {
-              if (typeof toast === "function") {
-                toast(successMessage);
-              }
-              globalEvents.emit(EVENT_TYPES.STATE_CHANGE, {
-                message: successMessage,
-                notify: toast === true,
-                status: "success"
-              });
-            }
-            await onSuccess?.(result.data);
-            resolve(result);
-          } catch (err2) {
-            const mappedError = toUserMessage(err2);
-            setError(mappedError);
-            const resolvedMessage = errorMessage || mappedError;
-            if (typeof toast === "function") {
-              toast(resolvedMessage);
-            }
-            globalEvents.emit(EVENT_TYPES.APP_ERROR, {
-              error: err2,
-              message: resolvedMessage,
-              notify: toast === true
-            });
-            await onError?.(mappedError);
-            resolve(err(mappedError));
-          }
-        });
-      });
-    },
-    [actionFn, errorMessage, onError, onSuccess, successMessage, toast]
-  );
-  return { data, error, execute, isPending, reset };
-}
-var init_use_server_action = __esm({
-  "src/hooks/use-server-action.ts"() {
-    "use client";
-    init_events();
-    init_result();
-    init_utils();
-  }
-});
-function getStorageInstance(type) {
-  if (!isBrowser) return null;
-  try {
-    return type === "session" ? window.sessionStorage : window.localStorage;
-  } catch {
-    return null;
-  }
-}
-function useStorageState(key, initialValue, options = {}) {
-  const storageType = options.storage ?? "local";
-  const serialize = options.serialize ?? JSON.stringify;
-  const deserialize = options.deserialize ?? JSON.parse;
-  const cacheRef = useRef({
-    parsed: initialValue,
-    raw: null
-  });
-  const getSnapshot2 = useCallback(() => {
-    const storage = getStorageInstance(storageType);
-    if (!storage) return initialValue;
-    try {
-      const raw = storage.getItem(key);
-      if (raw === null) {
-        cacheRef.current = { parsed: initialValue, raw: null };
-        return initialValue;
-      }
-      if (cacheRef.current.raw === raw) {
-        return cacheRef.current.parsed;
-      }
-      const parsed = deserialize(raw);
-      cacheRef.current = { parsed, raw };
-      return parsed;
-    } catch {
-      return initialValue;
-    }
-  }, [deserialize, initialValue, key, storageType]);
-  const getServerSnapshot = useCallback(() => initialValue, [initialValue]);
-  const subscribe2 = useCallback(
-    (onStoreChange) => {
-      if (!isBrowser) return () => {
-      };
-      const handleStorage = (event) => {
-        if (event.key === key && event.storageArea === getStorageInstance(storageType)) {
-          onStoreChange();
-        }
-      };
-      const handleCustomSync = (event) => {
-        const detail = event.detail;
-        if (detail?.key === key && detail?.storageType === storageType) {
-          onStoreChange();
-        }
-      };
-      window.addEventListener("storage", handleStorage);
-      window.addEventListener(STORAGE_SYNC_EVENT, handleCustomSync);
-      return () => {
-        window.removeEventListener("storage", handleStorage);
-        window.removeEventListener(STORAGE_SYNC_EVENT, handleCustomSync);
-      };
-    },
-    [key, storageType]
-  );
-  const state = useSyncExternalStore(subscribe2, getSnapshot2, getServerSnapshot);
-  const stateRef = useRef(state);
-  useIsomorphicLayoutEffect(() => {
-    stateRef.current = state;
-  });
-  const setValue = useCallback(
-    (next) => {
-      const resolvedNext = typeof next === "function" ? next(stateRef.current) : next;
-      stateRef.current = resolvedNext;
-      const storage = getStorageInstance(storageType);
-      if (!storage) return;
-      try {
-        const raw = serialize(resolvedNext);
-        cacheRef.current = { parsed: resolvedNext, raw };
-        storage.setItem(key, raw);
-        window.dispatchEvent(
-          new CustomEvent(STORAGE_SYNC_EVENT, {
-            detail: { key, storageType }
-          })
-        );
-      } catch {
-      }
-    },
-    [key, serialize, storageType]
-  );
-  const removeValue = useCallback(() => {
-    stateRef.current = initialValue;
-    cacheRef.current = { parsed: initialValue, raw: null };
-    const storage = getStorageInstance(storageType);
-    if (!storage) return;
-    try {
-      storage.removeItem(key);
-      window.dispatchEvent(
-        new CustomEvent(STORAGE_SYNC_EVENT, {
-          detail: { key, storageType }
-        })
-      );
-    } catch {
-    }
-  }, [initialValue, key, storageType]);
-  return [state, setValue, removeValue];
-}
-function useLocalStorage(key, initialValue, options) {
-  return useStorageState(key, initialValue, { ...options, storage: "local" });
-}
-function useSessionStorage(key, initialValue, options) {
-  return useStorageState(key, initialValue, { ...options, storage: "session" });
-}
-var STORAGE_SYNC_EVENT;
-var init_use_storage_state = __esm({
-  "src/hooks/use-storage-state.ts"() {
-    "use client";
-    init_utils();
-    init_use_isomorphic_layout_effect();
-    STORAGE_SYNC_EVENT = "base-framework:storage-sync";
-  }
-});
-function useIntersectionObserver(targetRef, options = {}) {
-  const {
-    enabled = true,
-    freezeOnceVisible = false,
-    onChange,
-    root = null,
-    rootMargin = "0px",
-    threshold = 0
-  } = options;
-  const [entry, setEntry] = useState(null);
-  const onChangeRef = useRef(onChange);
-  useIsomorphicLayoutEffect(() => {
-    onChangeRef.current = onChange;
-  });
-  const frozen = Boolean(entry?.isIntersecting && freezeOnceVisible);
-  useEffect(() => {
-    if (!isBrowser || !enabled || frozen || typeof IntersectionObserver === "undefined") {
-      return;
-    }
-    const node = targetRef?.current;
-    if (!node) return;
-    const observer = new IntersectionObserver(
-      ([nextEntry]) => {
-        if (!nextEntry) return;
-        setEntry(nextEntry);
-        onChangeRef.current?.(nextEntry);
-      },
-      { root, rootMargin, threshold }
-    );
-    observer.observe(node);
-    return () => observer.disconnect();
-  }, [enabled, frozen, root, rootMargin, targetRef, threshold]);
-  return {
-    entry,
-    isIntersecting: Boolean(entry?.isIntersecting)
-  };
-}
-var init_use_intersection_observer = __esm({
-  "src/hooks/use-intersection-observer.ts"() {
-    "use client";
-    init_utils();
-    init_use_isomorphic_layout_effect();
-  }
-});
 function getDomSnapshot() {
   if (typeof document === "undefined") {
     return activeFullscreenStateIds.size > 0;
@@ -2080,16 +1389,7 @@ var init_hooks = __esm({
     init_use_store();
     init_use_click_outside();
     init_use_isomorphic_layout_effect();
-    init_use_debounce();
-    init_use_mounted();
-    init_use_media_query();
-    init_use_controllable_state();
-    init_use_hotkey();
     init_use_global_event();
-    init_use_async_action();
-    init_use_server_action();
-    init_use_storage_state();
-    init_use_intersection_observer();
     init_use_fullscreen_state();
   }
 });
@@ -3253,7 +2553,7 @@ function PageControllerProvider({ children }) {
 function usePageController() {
   const scopedContext = use(PageControllerContext);
   const controllerStore = use(PageControllerStoreContext);
-  const storeSubscribe = scopedContext ? emptySubscribe2 : controllerStore.subscribe;
+  const storeSubscribe = scopedContext ? emptySubscribe : controllerStore.subscribe;
   const storeSnapshot = scopedContext ? getNullSnapshot : controllerStore.getSnapshot;
   const storeController = useSyncExternalStore(
     storeSubscribe,
@@ -3327,7 +2627,7 @@ function usePage(pageConfig = EMPTY_OBJECT, options) {
   }, [controllerStore, instanceId]);
   return controller;
 }
-var EMPTY_OBJECT, fallbackStandaloneStore, noopHook, PassthroughProvider, PageControllerContext, PageControllerStoreContext, emptySubscribe2, getNullSnapshot, FALLBACK_PAGE_CONTROLLER;
+var EMPTY_OBJECT, fallbackStandaloneStore, noopHook, PassthroughProvider, PageControllerContext, PageControllerStoreContext, emptySubscribe, getNullSnapshot, FALLBACK_PAGE_CONTROLLER;
 var init_page_controller = __esm({
   "src/kernel/page-controller.tsx"() {
     "use client";
@@ -3351,7 +2651,7 @@ var init_page_controller = __esm({
       "PageControllerStoreContext",
       fallbackStandaloneStore
     );
-    emptySubscribe2 = () => () => {
+    emptySubscribe = () => () => {
     };
     getNullSnapshot = () => null;
     FALLBACK_PAGE_CONTROLLER = Object.freeze({
@@ -4696,7 +3996,7 @@ function useModalModel() {
   const topModalEntry = visibleModalStack[visibleModalStack.length - 1] || null;
   const isModalVisible = Boolean(isOpen && topModalEntry);
   const mounted = useSyncExternalStore(
-    emptySubscribe5,
+    emptySubscribe4,
     () => true,
     () => false
   );
@@ -4755,7 +4055,7 @@ function useModalModel() {
     theme: useTheme(modalTheme)
   };
 }
-var emptySubscribe5;
+var emptySubscribe4;
 var init_hooks3 = __esm({
   "src/modules/modal/hooks.ts"() {
     "use client";
@@ -4765,7 +4065,7 @@ var init_hooks3 = __esm({
     init_constants2();
     init_utils3();
     init_context();
-    emptySubscribe5 = () => () => {
+    emptySubscribe4 = () => () => {
     };
   }
 });
@@ -5094,7 +4394,106 @@ var init_overlay = __esm({
 
 // src/index.ts
 init_kernel();
-init_result();
+
+// src/result.ts
+init_user_message();
+init_report();
+function ok(data, code) {
+  return { data, success: true, ...code ? { code } : {} };
+}
+function err(error, code) {
+  return { error, success: false, ...code ? { code } : {} };
+}
+function isResult(value) {
+  return typeof value === "object" && value !== null && "success" in value && typeof value.success === "boolean" && ("data" in value && value.success === true || "error" in value && value.success === false);
+}
+function isOk(result) {
+  return result.success === true;
+}
+function isErr(result) {
+  return result.success === false;
+}
+function unwrap(result) {
+  if (result.success) {
+    return result.data;
+  }
+  if (result.error instanceof Error) {
+    throw result.error;
+  }
+  throw new Error(
+    typeof result.error === "string" ? result.error : String(result.error)
+  );
+}
+function unwrapOr(result, fallback) {
+  return result.success ? result.data : fallback;
+}
+function map(result, fn) {
+  return result.success ? ok(fn(result.data), result.code) : result;
+}
+function mapErr(result, fn) {
+  return result.success ? result : err(fn(result.error), result.code);
+}
+function match(result, branches) {
+  return result.success ? branches.ok(result.data) : branches.err(result.error);
+}
+function mapCaught(error, mapError) {
+  if (!(error instanceof UserError)) report("Result", error);
+  return mapError ? mapError(error) : toUserMessage(error);
+}
+async function tryCatch(promiseOrFn, mapError) {
+  try {
+    const data = typeof promiseOrFn === "function" ? await promiseOrFn() : await promiseOrFn;
+    return ok(data);
+  } catch (error) {
+    return err(mapCaught(error, mapError));
+  }
+}
+function createSafeAction(handler, options = {}) {
+  const { errorCode, mapError, schema, validate } = options;
+  return async (...args) => {
+    try {
+      let effectiveArgs = args;
+      if (schema) {
+        const parsed = schema.safeParse(args[0]);
+        if (!parsed.success) {
+          const issueMessage = parsed.error?.issues?.[0]?.message || parsed.error?.message || "Invalid input";
+          return err(
+            mapError ? mapError(issueMessage) : issueMessage,
+            errorCode ?? "VALIDATION_ERROR"
+          );
+        }
+        effectiveArgs = [parsed.data, ...args.slice(1)];
+      }
+      if (validate) {
+        const validationResult = validate(...effectiveArgs);
+        if (isResult(validationResult)) {
+          if (isErr(validationResult)) {
+            return validationResult;
+          }
+        } else if (validationResult === false) {
+          return err(
+            mapError ? mapError("Validation failed") : "Validation failed",
+            errorCode ?? "VALIDATION_ERROR"
+          );
+        } else if (typeof validationResult === "string" && validationResult.length > 0) {
+          return err(
+            mapError ? mapError(validationResult) : validationResult,
+            errorCode ?? "VALIDATION_ERROR"
+          );
+        }
+      }
+      const output = await handler(...effectiveArgs);
+      if (isResult(output)) {
+        return output;
+      }
+      return ok(output);
+    } catch (error) {
+      return err(mapCaught(error, mapError), errorCode);
+    }
+  };
+}
+
+// src/index.ts
 init_events();
 init_theme();
 init_tokens2();
@@ -8933,7 +8332,7 @@ function useMenuDismissal(menuRef, onClose) {
     };
   }, [menuRef, onClose]);
 }
-var emptySubscribe3 = () => () => {
+var emptySubscribe2 = () => () => {
 };
 function useContextMenuContentModel({
   config,
@@ -9012,7 +8411,7 @@ function useContextMenuContentModel({
 function useContextMenuRendererModel() {
   const { closeMenu, config, context, isOpen, items, position } = useContextMenu();
   const isMounted = useSyncExternalStore(
-    emptySubscribe3,
+    emptySubscribe2,
     () => true,
     () => false
   );
@@ -9431,11 +8830,11 @@ function useControlsLayout() {
   }, []);
   return layout;
 }
-var emptySubscribe4 = () => () => {
+var emptySubscribe3 = () => () => {
 };
 function useControlsModel() {
   const portalTarget = useSyncExternalStore(
-    emptySubscribe4,
+    emptySubscribe3,
     () => typeof document !== "undefined" ? document.body : null,
     () => null
   );
@@ -20132,9 +19531,6 @@ function useNotificationState() {
   );
   return useStore(store);
 }
-
-// src/modules/notification/hooks.ts
-init_result();
 init_utils();
 init_events();
 init_hooks();
@@ -20209,7 +19605,7 @@ function useToast(defaultDuration) {
     [dismiss, dismissAllNotifications, fromResult, promise, triggerToast]
   );
 }
-var emptySubscribe6 = () => () => {
+var emptySubscribe5 = () => () => {
 };
 function NotificationListener() {
   const { showNotification } = useNotificationActions();
@@ -20237,7 +19633,7 @@ function useNotificationContainerModel() {
   const { notifications } = useNotificationState();
   const { dismissNotification } = useNotificationActions();
   const isHydrated = useSyncExternalStore(
-    emptySubscribe6,
+    emptySubscribe5,
     () => true,
     () => false
   );
@@ -20410,6 +19806,6 @@ var defaultModules = Object.freeze([
   notificationModule
 ]);
 
-export { ACTION_TONE_CLASS, Button, COMPOSITOR_GPU_STYLE, ComponentError, Compose, CoreProvider, DEFAULT_DEDUPE_WINDOW, DURATION_TOKENS, EASING_CURVES, ERROR_LISTENER_CONFIG, ERROR_MESSAGES, EVENT_TYPES, ErrorBoundaryCore, EventEmitter, GlobalError, GlobalErrorListener, Icon, MAX_CONTEXT, MAX_FINGERPRINTS, MOTION_EASINGS, MOTION_TIERS, ModuleBoundary, ModuleError, ModuleHost, PageControllerProvider, REDUCED_MOTION_TRANSITION, REGISTRY_SOURCES, RegistryProvider, SPRING_PRESETS, SURFACE_CLASSES, Spinner, TAP_SCALE_SUBTLE, ThemeProvider, Tooltip, USER_MESSAGES, UserError, Z_INDEX, acquireGlobalScrollLock, ambientModule, applyRegistryConfig, backgroundModule, capitalize, chip, clamp, cn, contentSwap, contentSwapTransitions, contextMenuModule, controlsModule, createConsoleHandler, createErrorContext, createModuleRegistryDefinitions, createRegistryApplyContext, createRegistryOperations, createRegistryStore, createReport, createSafeAction, createScheduler, createSentryHandler, createStore, debounce, dedupe, defaultModules, defineModule, definePeer, defineTheme, defineThemeSpec, dockModule, dragDismiss, durationForDistance, err, errorTheme, fingerprint, getBrowserEnvironment, getCurrentPath, getErrorMessage, getErrorReporter, getRuntimePath, getSiteUrl, getUserAgent, globalEvents, gpuTransform, hasOwnProperty, isBrowser, isEmpty, isErr, isImageIconSource, isObject, isOk, isPlainObject, isResult, loadingModule, map, mapErr, match, mediaModule, modalModule, normalizeDedupeWindow, normalizePath, normalizeSampleRate, notificationModule, ok, overlaySurface, press, randomBetween, report, safeJsonParse, safeJsonStringify, setReportSink, shallowEqual, shouldIgnoreError, sleep, slugify, sortModules, staggerDelay, staggerItem, stripTrailingSlash, surfaceResizeTransition, throttle, toArray, toFiniteNumber, toUserMessage, trimToNull, truncate, tryCatch, unwrap, unwrapOr, useAsyncAction, useClickOutside, useControllableState, useDebounce, useEscapeKey, useEventState, useGlobalEvent, useHotkey, useIntersectionObserver, useIsFullscreenStateActive, useIsModuleInstalled, useIsomorphicLayoutEffect, useLocalStorage, useMediaQuery, useModule, useModuleRegistration, useModuleState, useMounted, usePage, usePageController, useRegistryEntries, useRegistryValue, useRequiredContext, useServerAction, useSessionStorage, useStorageState, useStore, useTheme };
+export { ACTION_TONE_CLASS, Button, COMPOSITOR_GPU_STYLE, ComponentError, Compose, CoreProvider, DEFAULT_DEDUPE_WINDOW, DURATION_TOKENS, EASING_CURVES, ERROR_LISTENER_CONFIG, ERROR_MESSAGES, EVENT_TYPES, ErrorBoundaryCore, EventEmitter, GlobalError, GlobalErrorListener, Icon, MAX_CONTEXT, MAX_FINGERPRINTS, MOTION_EASINGS, MOTION_TIERS, ModuleBoundary, ModuleError, ModuleHost, PageControllerProvider, REDUCED_MOTION_TRANSITION, REGISTRY_SOURCES, RegistryProvider, SPRING_PRESETS, SURFACE_CLASSES, Spinner, TAP_SCALE_SUBTLE, ThemeProvider, Tooltip, USER_MESSAGES, UserError, Z_INDEX, acquireGlobalScrollLock, ambientModule, applyRegistryConfig, backgroundModule, chip, clamp, cn, contentSwap, contentSwapTransitions, contextMenuModule, controlsModule, createConsoleHandler, createErrorContext, createModuleRegistryDefinitions, createRegistryApplyContext, createRegistryOperations, createRegistryStore, createReport, createSafeAction, createScheduler, createSentryHandler, createStore, debounce, defaultModules, defineModule, definePeer, defineTheme, defineThemeSpec, dockModule, dragDismiss, durationForDistance, err, errorTheme, fingerprint, getBrowserEnvironment, getErrorMessage, getErrorReporter, getRuntimePath, getUserAgent, globalEvents, gpuTransform, hasOwnProperty, isBrowser, isErr, isImageIconSource, isObject, isOk, isPlainObject, isResult, loadingModule, map, mapErr, match, mediaModule, modalModule, normalizeDedupeWindow, normalizePath, normalizeSampleRate, notificationModule, ok, overlaySurface, press, report, setReportSink, shallowEqual, shouldIgnoreError, sortModules, staggerDelay, staggerItem, stripTrailingSlash, surfaceResizeTransition, throttle, toArray, toFiniteNumber, toUserMessage, trimToNull, tryCatch, unwrap, unwrapOr, useClickOutside, useGlobalEvent, useIsFullscreenStateActive, useIsModuleInstalled, useIsomorphicLayoutEffect, useModule, useModuleRegistration, useModuleState, usePage, usePageController, useRegistryEntries, useRegistryValue, useRequiredContext, useStore, useTheme };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map