@mwakidenis/logx-react 0.0.0-stage → 0.1.0

package/dist/providers/LogxProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/logx.ts","../../src/providers/LogxProvider.tsx"],"names":["addDays","camelCase","capitalize","chunk","clamp","clone","compact","logxDebounce","deepClone","difference","drop","entries","escapeHtml","first","flatten","flattenDeep","get","has","logxHasLocalStorage","logxHasSessionStorage","inRange","intersection","invert","isArray","isBoolean","logxIsBrowser","isEmail","isEmpty","isFunction","isNil","logxIsNode","isNull","isNumber","isObject","isString","isURL","isValidDate","kebabCase","keys","last","logxLocalStorageHelpers","mapKeys","mapValues","merge","omit","partition","pascalCase","percentage","pick","randomInt","retry","round","logxSafeStorage","sample","logxSessionStorageHelpers","set","shuffle","sleep","snakeCase","take","logxThrottle","timeout","trim","truncate","union","unique","values","withTimeout","createContext","jsx","useContext"],"mappings":"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","file":"LogxProvider.js","sourcesContent":["/**\r\n * LOGX integration layer.\r\n *\r\n * This module is the single place where @mwakidenis/logx is imported. Every hook,\r\n * component or utility that needs a LOGX capability imports it from here rather\r\n * than importing @mwakidenis/logx directly. That keeps React-specific behaviour\r\n * separate from core utility behaviour and makes the dependency boundary obvious.\r\n *\r\n * Only confirmed, publicly exported LOGX functions are re-exported. No LOGX\r\n * internals are copied into this project and the parent repository is not modified.\r\n */\r\n\r\nimport {\r\n  debounce as logxDebounce,\r\n  throttle as logxThrottle,\r\n  type Cancelable,\r\n} from \"@mwakidenis/logx/function\";\r\nimport {\r\n  isBrowser as logxIsBrowser,\r\n  isNode as logxIsNode,\r\n  hasLocalStorage as logxHasLocalStorage,\r\n  hasSessionStorage as logxHasSessionStorage,\r\n  localStorageHelpers as logxLocalStorageHelpers,\r\n  sessionStorageHelpers as logxSessionStorageHelpers,\r\n  safeStorage as logxSafeStorage,\r\n  type StorageHelpers,\r\n} from \"@mwakidenis/logx/browser\";\r\nimport {\r\n  isArray,\r\n  isBoolean,\r\n  isEmail,\r\n  isEmpty,\r\n  isFunction,\r\n  isNil,\r\n  isNull,\r\n  isNumber,\r\n  isObject,\r\n  isString,\r\n  isURL,\r\n} from \"@mwakidenis/logx/validation\";\r\nimport {\r\n  clone,\r\n  deepClone,\r\n  entries,\r\n  get,\r\n  has,\r\n  invert,\r\n  keys,\r\n  mapKeys,\r\n  mapValues,\r\n  merge,\r\n  omit,\r\n  pick,\r\n  set,\r\n  values,\r\n} from \"@mwakidenis/logx/object\";\r\nimport {\r\n  clamp,\r\n  inRange,\r\n  percentage,\r\n  randomInt,\r\n  round,\r\n} from \"@mwakidenis/logx/number\";\r\nimport {\r\n  unique,\r\n  partition,\r\n  compact,\r\n  first,\r\n  last,\r\n  take,\r\n  drop,\r\n  shuffle,\r\n  sample,\r\n  chunk,\r\n  flatten,\r\n  flattenDeep,\r\n  difference,\r\n  intersection,\r\n  union,\r\n} from \"@mwakidenis/logx/array\";\r\nimport { sleep, retry, withTimeout, timeout } from \"@mwakidenis/logx/async\";\r\nimport { addDays, isValidDate } from \"@mwakidenis/logx/date\";\r\nimport {\r\n  escapeHtml,\r\n  trim,\r\n  truncate,\r\n  camelCase,\r\n  capitalize,\r\n  kebabCase,\r\n  pascalCase,\r\n  snakeCase,\r\n} from \"@mwakidenis/logx/string\";\r\n\r\nexport {\r\n  logxDebounce as debounce,\r\n  logxThrottle as throttle,\r\n  type Cancelable,\r\n  logxIsBrowser as isBrowser,\r\n  logxIsNode as isNode,\r\n  logxHasLocalStorage as hasLocalStorage,\r\n  logxHasSessionStorage as hasSessionStorage,\r\n  logxLocalStorageHelpers as localStorageHelpers,\r\n  logxSessionStorageHelpers as sessionStorageHelpers,\r\n  logxSafeStorage as safeStorage,\r\n  type StorageHelpers,\r\n  isNil,\r\n  isString,\r\n  isNumber,\r\n  isBoolean,\r\n  isArray,\r\n  isObject,\r\n  isEmpty,\r\n  isEmail,\r\n  isFunction,\r\n  isNull,\r\n  isURL,\r\n  clone,\r\n  deepClone,\r\n  get,\r\n  set,\r\n  pick,\r\n  omit,\r\n  merge,\r\n  entries,\r\n  keys,\r\n  values,\r\n  has,\r\n  invert,\r\n  mapKeys,\r\n  mapValues,\r\n  clamp,\r\n  inRange,\r\n  round,\r\n  percentage,\r\n  randomInt,\r\n  unique,\r\n  partition,\r\n  compact,\r\n  first,\r\n  last,\r\n  take,\r\n  drop,\r\n  shuffle,\r\n  sample,\r\n  chunk,\r\n  flatten,\r\n  flattenDeep,\r\n  difference,\r\n  intersection,\r\n  union,\r\n  sleep,\r\n  retry,\r\n  withTimeout,\r\n  timeout,\r\n  addDays,\r\n  isValidDate,\r\n  escapeHtml,\r\n  trim,\r\n  truncate,\r\n  camelCase,\r\n  capitalize,\r\n  kebabCase,\r\n  pascalCase,\r\n  snakeCase,\r\n};\r\n\r\n/**\r\n * React-friendly wrapper around LOGX debounce that exposes a stable Cancelable\r\n * and validates the wait argument. Leading edge is not invoked by LOGX debounce\r\n * (trailing edge only); document this in hooks that use it.\r\n */\r\nexport interface LogxDebounceResult<F extends (...args: unknown[]) => unknown> {\r\n  fn: F & Cancelable;\r\n  cancel: () => void;\r\n  flush: () => void;\r\n  pending: () => boolean;\r\n}\r\n\r\nexport function createLogxDebounce<F extends (...args: unknown[]) => unknown>(\r\n  func: F,\r\n  wait: number,\r\n): LogxDebounceResult<F> {\r\n  if (!Number.isFinite(wait) || wait < 0) {\r\n    throw new RangeError(\"debounce: wait must be a non-negative number\");\r\n  }\r\n  const debounced = logxDebounce(func, wait);\r\n  return {\r\n    fn: debounced,\r\n    cancel: () => debounced.cancel(),\r\n    flush: () => debounced.flush(),\r\n    pending: () => debounced.pending(),\r\n  };\r\n}\r\n","import { createContext, useContext, ReactNode } from \"react\";\r\nimport * as logx from \"../internal/logx\";\r\n\r\nexport interface LogxContextValue {\r\n  logx: typeof logx;\r\n}\r\n\r\nconst LogxContext = createContext<LogxContextValue | null>(null);\r\n\r\n/**\r\n * Provider that exposes the LOGX integration layer via React context.\r\n *\r\n * Wrap your application (or a subtree) so components and hooks can access\r\n * LOGX utilities through context instead of importing @mwakidenis/logx\r\n * directly. This is optional; all hooks and components work standalone.\r\n *\r\n * @param props - Component props\r\n */\r\nexport function LogxProvider({ children }: { children: ReactNode }): JSX.Element {\r\n  return (\r\n    <LogxContext.Provider value={{ logx }}>\r\n      {children}\r\n    </LogxContext.Provider>\r\n  );\r\n}\r\n\r\n/**\r\n * Consume the LOGX integration layer from context.\r\n * Returns null when used outside a LogxProvider.\r\n */\r\nexport function useLogx(): LogxContextValue | null {\r\n  return useContext(LogxContext);\r\n}\r\n"]}

package/dist/providers/LogxProvider.mjs

@@ -0,0 +1,114 @@
+import { createContext, useContext } from 'react';
+import { throttle, debounce } from '@mwakidenis/logx/function';
+import { sessionStorageHelpers, safeStorage, localStorageHelpers, isNode, isBrowser, hasSessionStorage, hasLocalStorage } from '@mwakidenis/logx/browser';
+import { isURL, isString, isObject, isNumber, isNull, isNil, isFunction, isEmpty, isEmail, isBoolean, isArray } from '@mwakidenis/logx/validation';
+import { values, set, pick, omit, merge, mapValues, mapKeys, keys, invert, has, get, entries, deepClone, clone } from '@mwakidenis/logx/object';
+import { round, randomInt, percentage, inRange, clamp } from '@mwakidenis/logx/number';
+import { unique, union, take, shuffle, sample, partition, last, intersection, flattenDeep, flatten, first, drop, difference, compact, chunk } from '@mwakidenis/logx/array';
+import { withTimeout, timeout, sleep, retry } from '@mwakidenis/logx/async';
+import { isValidDate, addDays } from '@mwakidenis/logx/date';
+import { truncate, trim, snakeCase, pascalCase, kebabCase, escapeHtml, capitalize, camelCase } from '@mwakidenis/logx/string';
+import { jsx } from 'react/jsx-runtime';
+
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/internal/logx.ts
+var logx_exports = {};
+__export(logx_exports, {
+  addDays: () => addDays,
+  camelCase: () => camelCase,
+  capitalize: () => capitalize,
+  chunk: () => chunk,
+  clamp: () => clamp,
+  clone: () => clone,
+  compact: () => compact,
+  createLogxDebounce: () => createLogxDebounce,
+  debounce: () => debounce,
+  deepClone: () => deepClone,
+  difference: () => difference,
+  drop: () => drop,
+  entries: () => entries,
+  escapeHtml: () => escapeHtml,
+  first: () => first,
+  flatten: () => flatten,
+  flattenDeep: () => flattenDeep,
+  get: () => get,
+  has: () => has,
+  hasLocalStorage: () => hasLocalStorage,
+  hasSessionStorage: () => hasSessionStorage,
+  inRange: () => inRange,
+  intersection: () => intersection,
+  invert: () => invert,
+  isArray: () => isArray,
+  isBoolean: () => isBoolean,
+  isBrowser: () => isBrowser,
+  isEmail: () => isEmail,
+  isEmpty: () => isEmpty,
+  isFunction: () => isFunction,
+  isNil: () => isNil,
+  isNode: () => isNode,
+  isNull: () => isNull,
+  isNumber: () => isNumber,
+  isObject: () => isObject,
+  isString: () => isString,
+  isURL: () => isURL,
+  isValidDate: () => isValidDate,
+  kebabCase: () => kebabCase,
+  keys: () => keys,
+  last: () => last,
+  localStorageHelpers: () => localStorageHelpers,
+  mapKeys: () => mapKeys,
+  mapValues: () => mapValues,
+  merge: () => merge,
+  omit: () => omit,
+  partition: () => partition,
+  pascalCase: () => pascalCase,
+  percentage: () => percentage,
+  pick: () => pick,
+  randomInt: () => randomInt,
+  retry: () => retry,
+  round: () => round,
+  safeStorage: () => safeStorage,
+  sample: () => sample,
+  sessionStorageHelpers: () => sessionStorageHelpers,
+  set: () => set,
+  shuffle: () => shuffle,
+  sleep: () => sleep,
+  snakeCase: () => snakeCase,
+  take: () => take,
+  throttle: () => throttle,
+  timeout: () => timeout,
+  trim: () => trim,
+  truncate: () => truncate,
+  union: () => union,
+  unique: () => unique,
+  values: () => values,
+  withTimeout: () => withTimeout
+});
+function createLogxDebounce(func, wait) {
+  if (!Number.isFinite(wait) || wait < 0) {
+    throw new RangeError("debounce: wait must be a non-negative number");
+  }
+  const debounced = debounce(func, wait);
+  return {
+    fn: debounced,
+    cancel: () => debounced.cancel(),
+    flush: () => debounced.flush(),
+    pending: () => debounced.pending()
+  };
+}
+var LogxContext = createContext(null);
+function LogxProvider({ children }) {
+  return /* @__PURE__ */ jsx(LogxContext.Provider, { value: { logx: logx_exports }, children });
+}
+function useLogx() {
+  return useContext(LogxContext);
+}
+
+export { LogxProvider, useLogx };
+//# sourceMappingURL=LogxProvider.mjs.map
+//# sourceMappingURL=LogxProvider.mjs.map

package/dist/providers/LogxProvider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/logx.ts","../../src/providers/LogxProvider.tsx"],"names":["logxDebounce","logxHasLocalStorage","logxHasSessionStorage","logxIsBrowser","logxIsNode","logxLocalStorageHelpers","logxSafeStorage","logxSessionStorageHelpers","logxThrottle"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA,IAAA,YAAA,GAAA,EAAA;AAAA,QAAA,CAAA,YAAA,EAAA;AAAA,EAAA,OAAA,EAAA,MAAA,OAAA;AAAA,EAAA,SAAA,EAAA,MAAA,SAAA;AAAA,EAAA,UAAA,EAAA,MAAA,UAAA;AAAA,EAAA,KAAA,EAAA,MAAA,KAAA;AAAA,EAAA,KAAA,EAAA,MAAA,KAAA;AAAA,EAAA,KAAA,EAAA,MAAA,KAAA;AAAA,EAAA,OAAA,EAAA,MAAA,OAAA;AAAA,EAAA,kBAAA,EAAA,MAAA,kBAAA;AAAA,EAAA,QAAA,EAAA,MAAAA,QAAA;AAAA,EAAA,SAAA,EAAA,MAAA,SAAA;AAAA,EAAA,UAAA,EAAA,MAAA,UAAA;AAAA,EAAA,IAAA,EAAA,MAAA,IAAA;AAAA,EAAA,OAAA,EAAA,MAAA,OAAA;AAAA,EAAA,UAAA,EAAA,MAAA,UAAA;AAAA,EAAA,KAAA,EAAA,MAAA,KAAA;AAAA,EAAA,OAAA,EAAA,MAAA,OAAA;AAAA,EAAA,WAAA,EAAA,MAAA,WAAA;AAAA,EAAA,GAAA,EAAA,MAAA,GAAA;AAAA,EAAA,GAAA,EAAA,MAAA,GAAA;AAAA,EAAA,eAAA,EAAA,MAAAC,eAAA;AAAA,EAAA,iBAAA,EAAA,MAAAC,iBAAA;AAAA,EAAA,OAAA,EAAA,MAAA,OAAA;AAAA,EAAA,YAAA,EAAA,MAAA,YAAA;AAAA,EAAA,MAAA,EAAA,MAAA,MAAA;AAAA,EAAA,OAAA,EAAA,MAAA,OAAA;AAAA,EAAA,SAAA,EAAA,MAAA,SAAA;AAAA,EAAA,SAAA,EAAA,MAAAC,SAAA;AAAA,EAAA,OAAA,EAAA,MAAA,OAAA;AAAA,EAAA,OAAA,EAAA,MAAA,OAAA;AAAA,EAAA,UAAA,EAAA,MAAA,UAAA;AAAA,EAAA,KAAA,EAAA,MAAA,KAAA;AAAA,EAAA,MAAA,EAAA,MAAAC,MAAA;AAAA,EAAA,MAAA,EAAA,MAAA,MAAA;AAAA,EAAA,QAAA,EAAA,MAAA,QAAA;AAAA,EAAA,QAAA,EAAA,MAAA,QAAA;AAAA,EAAA,QAAA,EAAA,MAAA,QAAA;AAAA,EAAA,KAAA,EAAA,MAAA,KAAA;AAAA,EAAA,WAAA,EAAA,MAAA,WAAA;AAAA,EAAA,SAAA,EAAA,MAAA,SAAA;AAAA,EAAA,IAAA,EAAA,MAAA,IAAA;AAAA,EAAA,IAAA,EAAA,MAAA,IAAA;AAAA,EAAA,mBAAA,EAAA,MAAAC,mBAAA;AAAA,EAAA,OAAA,EAAA,MAAA,OAAA;AAAA,EAAA,SAAA,EAAA,MAAA,SAAA;AAAA,EAAA,KAAA,EAAA,MAAA,KAAA;AAAA,EAAA,IAAA,EAAA,MAAA,IAAA;AAAA,EAAA,SAAA,EAAA,MAAA,SAAA;AAAA,EAAA,UAAA,EAAA,MAAA,UAAA;AAAA,EAAA,UAAA,EAAA,MAAA,UAAA;AAAA,EAAA,IAAA,EAAA,MAAA,IAAA;AAAA,EAAA,SAAA,EAAA,MAAA,SAAA;AAAA,EAAA,KAAA,EAAA,MAAA,KAAA;AAAA,EAAA,KAAA,EAAA,MAAA,KAAA;AAAA,EAAA,WAAA,EAAA,MAAAC,WAAA;AAAA,EAAA,MAAA,EAAA,MAAA,MAAA;AAAA,EAAA,qBAAA,EAAA,MAAAC,qBAAA;AAAA,EAAA,GAAA,EAAA,MAAA,GAAA;AAAA,EAAA,OAAA,EAAA,MAAA,OAAA;AAAA,EAAA,KAAA,EAAA,MAAA,KAAA;AAAA,EAAA,SAAA,EAAA,MAAA,SAAA;AAAA,EAAA,IAAA,EAAA,MAAA,IAAA;AAAA,EAAA,QAAA,EAAA,MAAAC,QAAA;AAAA,EAAA,OAAA,EAAA,MAAA,OAAA;AAAA,EAAA,IAAA,EAAA,MAAA,IAAA;AAAA,EAAA,QAAA,EAAA,MAAA,QAAA;AAAA,EAAA,KAAA,EAAA,MAAA,KAAA;AAAA,EAAA,MAAA,EAAA,MAAA,MAAA;AAAA,EAAA,MAAA,EAAA,MAAA,MAAA;AAAA,EAAA,WAAA,EAAA,MAAA;AAAA,CAAA,CAAA;AAkLO,SAAS,kBAAA,CACd,MACA,IAAA,EACuB;AACvB,EAAA,IAAI,CAAC,MAAA,CAAO,QAAA,CAAS,IAAI,CAAA,IAAK,OAAO,CAAA,EAAG;AACtC,IAAA,MAAM,IAAI,WAAW,8CAA8C,CAAA;AAAA,EACrE;AACA,EAAA,MAAM,SAAA,GAAYR,QAAA,CAAa,IAAA,EAAM,IAAI,CAAA;AACzC,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,SAAA;AAAA,IACJ,MAAA,EAAQ,MAAM,SAAA,CAAU,MAAA,EAAO;AAAA,IAC/B,KAAA,EAAO,MAAM,SAAA,CAAU,KAAA,EAAM;AAAA,IAC7B,OAAA,EAAS,MAAM,SAAA,CAAU,OAAA;AAAQ,GACnC;AACF;ACzLA,IAAM,WAAA,GAAc,cAAuC,IAAI,CAAA;AAWxD,SAAS,YAAA,CAAa,EAAE,QAAA,EAAS,EAAyC;AAC/E,EAAA,uBACE,GAAA,CAAC,YAAY,QAAA,EAAZ,EAAqB,OAAO,EAAE,IAAA,EAAA,YAAA,IAC5B,QAAA,EACH,CAAA;AAEJ;AAMO,SAAS,OAAA,GAAmC;AACjD,EAAA,OAAO,WAAW,WAAW,CAAA;AAC/B","file":"LogxProvider.mjs","sourcesContent":["/**\r\n * LOGX integration layer.\r\n *\r\n * This module is the single place where @mwakidenis/logx is imported. Every hook,\r\n * component or utility that needs a LOGX capability imports it from here rather\r\n * than importing @mwakidenis/logx directly. That keeps React-specific behaviour\r\n * separate from core utility behaviour and makes the dependency boundary obvious.\r\n *\r\n * Only confirmed, publicly exported LOGX functions are re-exported. No LOGX\r\n * internals are copied into this project and the parent repository is not modified.\r\n */\r\n\r\nimport {\r\n  debounce as logxDebounce,\r\n  throttle as logxThrottle,\r\n  type Cancelable,\r\n} from \"@mwakidenis/logx/function\";\r\nimport {\r\n  isBrowser as logxIsBrowser,\r\n  isNode as logxIsNode,\r\n  hasLocalStorage as logxHasLocalStorage,\r\n  hasSessionStorage as logxHasSessionStorage,\r\n  localStorageHelpers as logxLocalStorageHelpers,\r\n  sessionStorageHelpers as logxSessionStorageHelpers,\r\n  safeStorage as logxSafeStorage,\r\n  type StorageHelpers,\r\n} from \"@mwakidenis/logx/browser\";\r\nimport {\r\n  isArray,\r\n  isBoolean,\r\n  isEmail,\r\n  isEmpty,\r\n  isFunction,\r\n  isNil,\r\n  isNull,\r\n  isNumber,\r\n  isObject,\r\n  isString,\r\n  isURL,\r\n} from \"@mwakidenis/logx/validation\";\r\nimport {\r\n  clone,\r\n  deepClone,\r\n  entries,\r\n  get,\r\n  has,\r\n  invert,\r\n  keys,\r\n  mapKeys,\r\n  mapValues,\r\n  merge,\r\n  omit,\r\n  pick,\r\n  set,\r\n  values,\r\n} from \"@mwakidenis/logx/object\";\r\nimport {\r\n  clamp,\r\n  inRange,\r\n  percentage,\r\n  randomInt,\r\n  round,\r\n} from \"@mwakidenis/logx/number\";\r\nimport {\r\n  unique,\r\n  partition,\r\n  compact,\r\n  first,\r\n  last,\r\n  take,\r\n  drop,\r\n  shuffle,\r\n  sample,\r\n  chunk,\r\n  flatten,\r\n  flattenDeep,\r\n  difference,\r\n  intersection,\r\n  union,\r\n} from \"@mwakidenis/logx/array\";\r\nimport { sleep, retry, withTimeout, timeout } from \"@mwakidenis/logx/async\";\r\nimport { addDays, isValidDate } from \"@mwakidenis/logx/date\";\r\nimport {\r\n  escapeHtml,\r\n  trim,\r\n  truncate,\r\n  camelCase,\r\n  capitalize,\r\n  kebabCase,\r\n  pascalCase,\r\n  snakeCase,\r\n} from \"@mwakidenis/logx/string\";\r\n\r\nexport {\r\n  logxDebounce as debounce,\r\n  logxThrottle as throttle,\r\n  type Cancelable,\r\n  logxIsBrowser as isBrowser,\r\n  logxIsNode as isNode,\r\n  logxHasLocalStorage as hasLocalStorage,\r\n  logxHasSessionStorage as hasSessionStorage,\r\n  logxLocalStorageHelpers as localStorageHelpers,\r\n  logxSessionStorageHelpers as sessionStorageHelpers,\r\n  logxSafeStorage as safeStorage,\r\n  type StorageHelpers,\r\n  isNil,\r\n  isString,\r\n  isNumber,\r\n  isBoolean,\r\n  isArray,\r\n  isObject,\r\n  isEmpty,\r\n  isEmail,\r\n  isFunction,\r\n  isNull,\r\n  isURL,\r\n  clone,\r\n  deepClone,\r\n  get,\r\n  set,\r\n  pick,\r\n  omit,\r\n  merge,\r\n  entries,\r\n  keys,\r\n  values,\r\n  has,\r\n  invert,\r\n  mapKeys,\r\n  mapValues,\r\n  clamp,\r\n  inRange,\r\n  round,\r\n  percentage,\r\n  randomInt,\r\n  unique,\r\n  partition,\r\n  compact,\r\n  first,\r\n  last,\r\n  take,\r\n  drop,\r\n  shuffle,\r\n  sample,\r\n  chunk,\r\n  flatten,\r\n  flattenDeep,\r\n  difference,\r\n  intersection,\r\n  union,\r\n  sleep,\r\n  retry,\r\n  withTimeout,\r\n  timeout,\r\n  addDays,\r\n  isValidDate,\r\n  escapeHtml,\r\n  trim,\r\n  truncate,\r\n  camelCase,\r\n  capitalize,\r\n  kebabCase,\r\n  pascalCase,\r\n  snakeCase,\r\n};\r\n\r\n/**\r\n * React-friendly wrapper around LOGX debounce that exposes a stable Cancelable\r\n * and validates the wait argument. Leading edge is not invoked by LOGX debounce\r\n * (trailing edge only); document this in hooks that use it.\r\n */\r\nexport interface LogxDebounceResult<F extends (...args: unknown[]) => unknown> {\r\n  fn: F & Cancelable;\r\n  cancel: () => void;\r\n  flush: () => void;\r\n  pending: () => boolean;\r\n}\r\n\r\nexport function createLogxDebounce<F extends (...args: unknown[]) => unknown>(\r\n  func: F,\r\n  wait: number,\r\n): LogxDebounceResult<F> {\r\n  if (!Number.isFinite(wait) || wait < 0) {\r\n    throw new RangeError(\"debounce: wait must be a non-negative number\");\r\n  }\r\n  const debounced = logxDebounce(func, wait);\r\n  return {\r\n    fn: debounced,\r\n    cancel: () => debounced.cancel(),\r\n    flush: () => debounced.flush(),\r\n    pending: () => debounced.pending(),\r\n  };\r\n}\r\n","import { createContext, useContext, ReactNode } from \"react\";\r\nimport * as logx from \"../internal/logx\";\r\n\r\nexport interface LogxContextValue {\r\n  logx: typeof logx;\r\n}\r\n\r\nconst LogxContext = createContext<LogxContextValue | null>(null);\r\n\r\n/**\r\n * Provider that exposes the LOGX integration layer via React context.\r\n *\r\n * Wrap your application (or a subtree) so components and hooks can access\r\n * LOGX utilities through context instead of importing @mwakidenis/logx\r\n * directly. This is optional; all hooks and components work standalone.\r\n *\r\n * @param props - Component props\r\n */\r\nexport function LogxProvider({ children }: { children: ReactNode }): JSX.Element {\r\n  return (\r\n    <LogxContext.Provider value={{ logx }}>\r\n      {children}\r\n    </LogxContext.Provider>\r\n  );\r\n}\r\n\r\n/**\r\n * Consume the LOGX integration layer from context.\r\n * Returns null when used outside a LogxProvider.\r\n */\r\nexport function useLogx(): LogxContextValue | null {\r\n  return useContext(LogxContext);\r\n}\r\n"]}

package/dist/types/index.d.mts

@@ -0,0 +1,87 @@
+/**
+ * Shared TypeScript types for the LOGX React Toolkit.
+ */
+type Unsubscribe = () => void;
+type SetValue<T> = T | ((prev: T) => T);
+interface AsyncState<T> {
+    data: T | null;
+    error: Error | null;
+    isLoading: boolean;
+    isSuccess: boolean;
+    isError: boolean;
+}
+interface DebouncedValueOptions {
+    /** Delay in milliseconds before the debounced value updates. Default: 300 */
+    delay?: number;
+    /** Invoke immediately on mount/first change (leading edge). Default: false */
+    leading?: boolean;
+}
+interface ThrottleOptions {
+    /** Delay in milliseconds between invocations. Default: 300 */
+    wait?: number;
+    /** Invoke on leading edge. Default: true */
+    leading?: boolean;
+    /** Invoke on trailing edge. Default: true */
+    trailing?: boolean;
+}
+interface UseLocalStorageOptions<T> {
+    /** Custom serializer. Default: JSON.stringify/JSON.parse */
+    serializer?: {
+        serialize: (value: T) => string;
+        deserialize: (raw: string | null) => T | null;
+    };
+}
+interface CopyButtonProps {
+    text: string;
+    label?: string;
+    copyingLabel?: string;
+    successLabel?: string;
+    errorLabel?: string;
+    className?: string;
+    onCopy?: (text: string) => void;
+    onError?: (error: unknown) => void;
+    timeout?: number;
+}
+interface PasswordInputProps {
+    value?: string;
+    defaultValue?: string;
+    onChange?: (value: string) => void;
+    label?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    required?: boolean;
+    name?: string;
+    id?: string;
+    showToggle?: boolean;
+    className?: string;
+}
+interface DebouncedInputProps {
+    value?: string;
+    defaultValue?: string;
+    onChange?: (value: string) => void;
+    onDebouncedChange?: (value: string) => void;
+    delay?: number;
+    placeholder?: string;
+    disabled?: boolean;
+    name?: string;
+    id?: string;
+    className?: string;
+}
+interface ResponsiveProps {
+    children: (matches: boolean) => React.ReactNode;
+    query: string;
+    fallback?: React.ReactNode;
+}
+interface ErrorBoundaryProps {
+    children?: React.ReactNode;
+    fallback?: React.ReactNode | ((error: Error, info: React.ErrorInfo) => React.ReactNode);
+    onError?: (error: Error, info: React.ErrorInfo) => void;
+    resetKeys?: unknown[];
+}
+interface ErrorBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+    info: React.ErrorInfo | null;
+}
+
+export type { AsyncState, CopyButtonProps, DebouncedInputProps, DebouncedValueOptions, ErrorBoundaryProps, ErrorBoundaryState, PasswordInputProps, ResponsiveProps, SetValue, ThrottleOptions, Unsubscribe, UseLocalStorageOptions };

package/dist/types/index.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Shared TypeScript types for the LOGX React Toolkit.
+ */
+type Unsubscribe = () => void;
+type SetValue<T> = T | ((prev: T) => T);
+interface AsyncState<T> {
+    data: T | null;
+    error: Error | null;
+    isLoading: boolean;
+    isSuccess: boolean;
+    isError: boolean;
+}
+interface DebouncedValueOptions {
+    /** Delay in milliseconds before the debounced value updates. Default: 300 */
+    delay?: number;
+    /** Invoke immediately on mount/first change (leading edge). Default: false */
+    leading?: boolean;
+}
+interface ThrottleOptions {
+    /** Delay in milliseconds between invocations. Default: 300 */
+    wait?: number;
+    /** Invoke on leading edge. Default: true */
+    leading?: boolean;
+    /** Invoke on trailing edge. Default: true */
+    trailing?: boolean;
+}
+interface UseLocalStorageOptions<T> {
+    /** Custom serializer. Default: JSON.stringify/JSON.parse */
+    serializer?: {
+        serialize: (value: T) => string;
+        deserialize: (raw: string | null) => T | null;
+    };
+}
+interface CopyButtonProps {
+    text: string;
+    label?: string;
+    copyingLabel?: string;
+    successLabel?: string;
+    errorLabel?: string;
+    className?: string;
+    onCopy?: (text: string) => void;
+    onError?: (error: unknown) => void;
+    timeout?: number;
+}
+interface PasswordInputProps {
+    value?: string;
+    defaultValue?: string;
+    onChange?: (value: string) => void;
+    label?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    required?: boolean;
+    name?: string;
+    id?: string;
+    showToggle?: boolean;
+    className?: string;
+}
+interface DebouncedInputProps {
+    value?: string;
+    defaultValue?: string;
+    onChange?: (value: string) => void;
+    onDebouncedChange?: (value: string) => void;
+    delay?: number;
+    placeholder?: string;
+    disabled?: boolean;
+    name?: string;
+    id?: string;
+    className?: string;
+}
+interface ResponsiveProps {
+    children: (matches: boolean) => React.ReactNode;
+    query: string;
+    fallback?: React.ReactNode;
+}
+interface ErrorBoundaryProps {
+    children?: React.ReactNode;
+    fallback?: React.ReactNode | ((error: Error, info: React.ErrorInfo) => React.ReactNode);
+    onError?: (error: Error, info: React.ErrorInfo) => void;
+    resetKeys?: unknown[];
+}
+interface ErrorBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+    info: React.ErrorInfo | null;
+}
+
+export type { AsyncState, CopyButtonProps, DebouncedInputProps, DebouncedValueOptions, ErrorBoundaryProps, ErrorBoundaryState, PasswordInputProps, ResponsiveProps, SetValue, ThrottleOptions, Unsubscribe, UseLocalStorageOptions };

package/dist/types/index.js

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/types/index.mjs

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/types/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}

package/dist/utilities/index.d.mts

@@ -0,0 +1,140 @@
+import { chunk as chunk$1, compact as compact$1, difference as difference$1, drop as drop$1, flatten as flatten$1, flattenDeep as flattenDeep$1, intersection as intersection$1, last as last$1, partition as partition$1, sample as sample$1, shuffle as shuffle$1, take as take$1, union as union$1, unique as unique$1 } from '@mwakidenis/logx/array';
+import { clone as clone$1, deepClone as deepClone$1, entries as entries$1, get as get$1, has as has$1, keys as keys$1, mapKeys as mapKeys$1, mapValues as mapValues$1, merge as merge$1, omit as omit$1, pick as pick$1, set as set$1, values as values$1 } from '@mwakidenis/logx/object';
+import { camelCase as camelCase$1, capitalize as capitalize$1, escapeHtml as escapeHtml$1, kebabCase as kebabCase$1, pascalCase as pascalCase$1, snakeCase as snakeCase$1, trim as trim$1, truncate as truncate$1 } from '@mwakidenis/logx/string';
+import { clamp as clamp$1, inRange as inRange$1, percentage as percentage$1, randomInt as randomInt$1, round as round$1 } from '@mwakidenis/logx/number';
+import { isArray as isArray$1, isBoolean as isBoolean$1, isEmail as isEmail$1, isEmpty as isEmpty$1, isFunction as isFunction$1, isNil as isNil$1, isNull as isNull$1, isNumber as isNumber$1, isObject as isObject$1, isString as isString$1, isURL as isURL$1 } from '@mwakidenis/logx/validation';
+import { addDays as addDays$1, isValidDate as isValidDate$1 } from '@mwakidenis/logx/date';
+
+/**
+ * Array utilities.
+ *
+ * Pure, tree-shakable wrappers around @mwakidenis/logx array functions plus a
+ * few React-oriented helpers. LOGX provides the core transformations; this
+ * module exposes them with stable, documented signatures.
+ */
+
+declare const chunk: typeof chunk$1;
+declare const compact: typeof compact$1;
+declare const difference: typeof difference$1;
+declare const drop: typeof drop$1;
+declare const flatten: typeof flatten$1;
+declare const flattenDeep: typeof flattenDeep$1;
+declare const intersection: typeof intersection$1;
+declare const last: typeof last$1;
+declare const partition: typeof partition$1;
+declare const sample: typeof sample$1;
+declare const shuffle: typeof shuffle$1;
+declare const take: typeof take$1;
+declare const union: typeof union$1;
+declare const unique: typeof unique$1;
+/**
+ * Return the first element of an array, or undefined.
+ */
+declare function first<T>(array: readonly T[]): T | undefined;
+/**
+ * Remove duplicates from an array using LOGX unique.
+ */
+declare function distinct<T>(array: readonly T[]): T[];
+
+/**
+ * Object utilities.
+ *
+ * Wrappers around @mwakidenis/logx object functions with stable signatures.
+ */
+
+declare const clone: typeof clone$1;
+declare const deepClone: typeof deepClone$1;
+declare const entries: typeof entries$1;
+declare const get: typeof get$1;
+declare const has: typeof has$1;
+declare const keys: typeof keys$1;
+declare const mapKeys: typeof mapKeys$1;
+declare const mapValues: typeof mapValues$1;
+declare const merge: typeof merge$1;
+declare const omit: typeof omit$1;
+declare const pick: typeof pick$1;
+declare const set: typeof set$1;
+declare const values: typeof values$1;
+/**
+ * Safely get a nested value, returning undefined when the path is missing.
+ */
+declare function safeGet<T>(object: unknown, path: string | Array<string | number>): T | undefined;
+
+/**
+ * String utilities.
+ *
+ * Wrappers around @mwakidenis/logx string functions plus a React-oriented
+ * HTML escaper for safe rendering.
+ */
+
+declare const camelCase: typeof camelCase$1;
+declare const capitalize: typeof capitalize$1;
+declare const escapeHtml: typeof escapeHtml$1;
+declare const kebabCase: typeof kebabCase$1;
+declare const pascalCase: typeof pascalCase$1;
+declare const snakeCase: typeof snakeCase$1;
+declare const trim: typeof trim$1;
+declare const truncate: typeof truncate$1;
+/**
+ * Escape HTML special characters so a string can be interpolated safely.
+ * Delegates to @mwakidenis/logx escapeHtml.
+ */
+declare function htmlEscape(input: string): string;
+
+/**
+ * Number utilities.
+ *
+ * Wrappers around @mwakidenis/logx number functions.
+ */
+
+declare const clamp: typeof clamp$1;
+declare const inRange: typeof inRange$1;
+declare const round: typeof round$1;
+declare const percentage: typeof percentage$1;
+declare const randomInt: typeof randomInt$1;
+
+/**
+ * Validation utilities.
+ *
+ * Wrappers around @mwakidenis/logx validation functions with type-guard
+ * signatures preserved, plus React-oriented helpers.
+ */
+
+declare const isArray: typeof isArray$1;
+declare const isBoolean: typeof isBoolean$1;
+declare const isEmail: typeof isEmail$1;
+declare const isEmpty: typeof isEmpty$1;
+declare const isFunction: typeof isFunction$1;
+declare const isNil: typeof isNil$1;
+declare const isNull: typeof isNull$1;
+declare const isNumber: typeof isNumber$1;
+declare const isObject: typeof isObject$1;
+declare const isString: typeof isString$1;
+declare const isURL: typeof isURL$1;
+/**
+ * Required-field validator: returns an error message when the value is nil or
+ * an empty string, otherwise null.
+ */
+declare function required(value: unknown, fieldName?: string): string | null;
+
+/**
+ * Date utilities.
+ *
+ * Wrappers around @mwakidenis/logx date functions.
+ */
+
+declare const addDays: typeof addDays$1;
+declare const isValidDate: typeof isValidDate$1;
+
+/**
+ * Browser environment utilities.
+ *
+ * Re-exports @mwakidenis/logx browser detection helpers so consumers can
+ * write SSR-safe code without importing @mwakidenis/logx directly.
+ */
+declare const hasLocalStorage: boolean;
+declare const hasSessionStorage: boolean;
+declare const isBrowser: boolean;
+declare const isNode: boolean;
+
+export { addDays, camelCase, capitalize, chunk, clamp, clone, compact, deepClone, difference, distinct, drop, entries, escapeHtml, first, flatten, flattenDeep, get, has, hasLocalStorage, hasSessionStorage, htmlEscape, inRange, intersection, isArray, isBoolean, isBrowser, isEmail, isEmpty, isFunction, isNil, isNode, isNull, isNumber, isObject, isString, isURL, isValidDate, kebabCase, keys, last, mapKeys, mapValues, merge, omit, partition, pascalCase, percentage, pick, randomInt, required, round, safeGet, sample, set, shuffle, snakeCase, take, trim, truncate, union, unique, values };

package/dist/utilities/index.d.ts

@@ -0,0 +1,140 @@
+import { chunk as chunk$1, compact as compact$1, difference as difference$1, drop as drop$1, flatten as flatten$1, flattenDeep as flattenDeep$1, intersection as intersection$1, last as last$1, partition as partition$1, sample as sample$1, shuffle as shuffle$1, take as take$1, union as union$1, unique as unique$1 } from '@mwakidenis/logx/array';
+import { clone as clone$1, deepClone as deepClone$1, entries as entries$1, get as get$1, has as has$1, keys as keys$1, mapKeys as mapKeys$1, mapValues as mapValues$1, merge as merge$1, omit as omit$1, pick as pick$1, set as set$1, values as values$1 } from '@mwakidenis/logx/object';
+import { camelCase as camelCase$1, capitalize as capitalize$1, escapeHtml as escapeHtml$1, kebabCase as kebabCase$1, pascalCase as pascalCase$1, snakeCase as snakeCase$1, trim as trim$1, truncate as truncate$1 } from '@mwakidenis/logx/string';
+import { clamp as clamp$1, inRange as inRange$1, percentage as percentage$1, randomInt as randomInt$1, round as round$1 } from '@mwakidenis/logx/number';
+import { isArray as isArray$1, isBoolean as isBoolean$1, isEmail as isEmail$1, isEmpty as isEmpty$1, isFunction as isFunction$1, isNil as isNil$1, isNull as isNull$1, isNumber as isNumber$1, isObject as isObject$1, isString as isString$1, isURL as isURL$1 } from '@mwakidenis/logx/validation';
+import { addDays as addDays$1, isValidDate as isValidDate$1 } from '@mwakidenis/logx/date';
+
+/**
+ * Array utilities.
+ *
+ * Pure, tree-shakable wrappers around @mwakidenis/logx array functions plus a
+ * few React-oriented helpers. LOGX provides the core transformations; this
+ * module exposes them with stable, documented signatures.
+ */
+
+declare const chunk: typeof chunk$1;
+declare const compact: typeof compact$1;
+declare const difference: typeof difference$1;
+declare const drop: typeof drop$1;
+declare const flatten: typeof flatten$1;
+declare const flattenDeep: typeof flattenDeep$1;
+declare const intersection: typeof intersection$1;
+declare const last: typeof last$1;
+declare const partition: typeof partition$1;
+declare const sample: typeof sample$1;
+declare const shuffle: typeof shuffle$1;
+declare const take: typeof take$1;
+declare const union: typeof union$1;
+declare const unique: typeof unique$1;
+/**
+ * Return the first element of an array, or undefined.
+ */
+declare function first<T>(array: readonly T[]): T | undefined;
+/**
+ * Remove duplicates from an array using LOGX unique.
+ */
+declare function distinct<T>(array: readonly T[]): T[];
+
+/**
+ * Object utilities.
+ *
+ * Wrappers around @mwakidenis/logx object functions with stable signatures.
+ */
+
+declare const clone: typeof clone$1;
+declare const deepClone: typeof deepClone$1;
+declare const entries: typeof entries$1;
+declare const get: typeof get$1;
+declare const has: typeof has$1;
+declare const keys: typeof keys$1;
+declare const mapKeys: typeof mapKeys$1;
+declare const mapValues: typeof mapValues$1;
+declare const merge: typeof merge$1;
+declare const omit: typeof omit$1;
+declare const pick: typeof pick$1;
+declare const set: typeof set$1;
+declare const values: typeof values$1;
+/**
+ * Safely get a nested value, returning undefined when the path is missing.
+ */
+declare function safeGet<T>(object: unknown, path: string | Array<string | number>): T | undefined;
+
+/**
+ * String utilities.
+ *
+ * Wrappers around @mwakidenis/logx string functions plus a React-oriented
+ * HTML escaper for safe rendering.
+ */
+
+declare const camelCase: typeof camelCase$1;
+declare const capitalize: typeof capitalize$1;
+declare const escapeHtml: typeof escapeHtml$1;
+declare const kebabCase: typeof kebabCase$1;
+declare const pascalCase: typeof pascalCase$1;
+declare const snakeCase: typeof snakeCase$1;
+declare const trim: typeof trim$1;
+declare const truncate: typeof truncate$1;
+/**
+ * Escape HTML special characters so a string can be interpolated safely.
+ * Delegates to @mwakidenis/logx escapeHtml.
+ */
+declare function htmlEscape(input: string): string;
+
+/**
+ * Number utilities.
+ *
+ * Wrappers around @mwakidenis/logx number functions.
+ */
+
+declare const clamp: typeof clamp$1;
+declare const inRange: typeof inRange$1;
+declare const round: typeof round$1;
+declare const percentage: typeof percentage$1;
+declare const randomInt: typeof randomInt$1;
+
+/**
+ * Validation utilities.
+ *
+ * Wrappers around @mwakidenis/logx validation functions with type-guard
+ * signatures preserved, plus React-oriented helpers.
+ */
+
+declare const isArray: typeof isArray$1;
+declare const isBoolean: typeof isBoolean$1;
+declare const isEmail: typeof isEmail$1;
+declare const isEmpty: typeof isEmpty$1;
+declare const isFunction: typeof isFunction$1;
+declare const isNil: typeof isNil$1;
+declare const isNull: typeof isNull$1;
+declare const isNumber: typeof isNumber$1;
+declare const isObject: typeof isObject$1;
+declare const isString: typeof isString$1;
+declare const isURL: typeof isURL$1;
+/**
+ * Required-field validator: returns an error message when the value is nil or
+ * an empty string, otherwise null.
+ */
+declare function required(value: unknown, fieldName?: string): string | null;
+
+/**
+ * Date utilities.
+ *
+ * Wrappers around @mwakidenis/logx date functions.
+ */
+
+declare const addDays: typeof addDays$1;
+declare const isValidDate: typeof isValidDate$1;
+
+/**
+ * Browser environment utilities.
+ *
+ * Re-exports @mwakidenis/logx browser detection helpers so consumers can
+ * write SSR-safe code without importing @mwakidenis/logx directly.
+ */
+declare const hasLocalStorage: boolean;
+declare const hasSessionStorage: boolean;
+declare const isBrowser: boolean;
+declare const isNode: boolean;
+
+export { addDays, camelCase, capitalize, chunk, clamp, clone, compact, deepClone, difference, distinct, drop, entries, escapeHtml, first, flatten, flattenDeep, get, has, hasLocalStorage, hasSessionStorage, htmlEscape, inRange, intersection, isArray, isBoolean, isBrowser, isEmail, isEmpty, isFunction, isNil, isNode, isNull, isNumber, isObject, isString, isURL, isValidDate, kebabCase, keys, last, mapKeys, mapValues, merge, omit, partition, pascalCase, percentage, pick, randomInt, required, round, safeGet, sample, set, shuffle, snakeCase, take, trim, truncate, union, unique, values };