@tale-ui/utils 0.0.3

package/useStableCallback.js

@@ -0,0 +1,49 @@
+"use strict";
+'use client';
+
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useStableCallback = useStableCallback;
+var React = _interopRequireWildcard(require("react"));
+var _useRefWithInit = require("./useRefWithInit");
+// https://github.com/mui/material-ui/issues/41190#issuecomment-2040873379
+const useInsertionEffect = React[`useInsertionEffect${Math.random().toFixed(1)}`.slice(0, -3)];
+const useSafeInsertionEffect =
+// React 17 doesn't have useInsertionEffect.
+useInsertionEffect &&
+// Preact replaces useInsertionEffect with useLayoutEffect and fires too late.
+useInsertionEffect !== React.useLayoutEffect ? useInsertionEffect : fn => fn();
+/**
+ * Stabilizes the function passed so it's always the same between renders.
+ *
+ * The function becomes non-reactive to any values it captures.
+ * It can safely be passed as a dependency of `React.useMemo` and `React.useEffect` without re-triggering them if its captured values change.
+ *
+ * The function must only be called inside effects and event handlers, never during render (which throws an error).
+ *
+ * This hook is a more permissive version of React 19.2's `React.useEffectEvent` in that it can be passed through contexts and called in event handler props, not just effects.
+ */
+function useStableCallback(callback) {
+  const stable = (0, _useRefWithInit.useRefWithInit)(createStableCallback).current;
+  stable.next = callback;
+  useSafeInsertionEffect(stable.effect);
+  return stable.trampoline;
+}
+function createStableCallback() {
+  const stable = {
+    next: undefined,
+    callback: assertNotCalled,
+    trampoline: (...args) => stable.callback?.(...args),
+    effect: () => {
+      stable.callback = stable.next;
+    }
+  };
+  return stable;
+}
+function assertNotCalled() {
+  if (process.env.NODE_ENV !== 'production') {
+    throw /* minify-error-disabled */new Error('Tale UI: Cannot call an event handler while rendering.');
+  }
+}

package/useTimeout.d.ts

@@ -0,0 +1,17 @@
+type TimeoutId = number;
+export declare class Timeout {
+  static create(): Timeout;
+  currentId: TimeoutId;
+  /**
+   * Executes `fn` after `delay`, clearing any previously scheduled call.
+   */
+  start(delay: number, fn: Function): void;
+  isStarted(): boolean;
+  clear: () => void;
+  disposeEffect: () => () => void;
+}
+/**
+ * A `setTimeout` with automatic cleanup and guard.
+ */
+export declare function useTimeout(): Timeout;
+export {};

package/useTimeout.js

@@ -0,0 +1,50 @@
+"use strict";
+'use client';
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Timeout = void 0;
+exports.useTimeout = useTimeout;
+var _useRefWithInit = require("./useRefWithInit");
+var _useOnMount = require("./useOnMount");
+const EMPTY = 0;
+class Timeout {
+  static create() {
+    return new Timeout();
+  }
+  currentId = EMPTY;
+
+  /**
+   * Executes `fn` after `delay`, clearing any previously scheduled call.
+   */
+  start(delay, fn) {
+    this.clear();
+    this.currentId = setTimeout(() => {
+      this.currentId = EMPTY;
+      fn();
+    }, delay); /* Node.js types are enabled in development */
+  }
+  isStarted() {
+    return this.currentId !== EMPTY;
+  }
+  clear = () => {
+    if (this.currentId !== EMPTY) {
+      clearTimeout(this.currentId);
+      this.currentId = EMPTY;
+    }
+  };
+  disposeEffect = () => {
+    return this.clear;
+  };
+}
+
+/**
+ * A `setTimeout` with automatic cleanup and guard.
+ */
+exports.Timeout = Timeout;
+function useTimeout() {
+  const timeout = (0, _useRefWithInit.useRefWithInit)(Timeout.create).current;
+  (0, _useOnMount.useOnMount)(timeout.disposeEffect);
+  return timeout;
+}

package/useValueAsRef.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Untracks the provided value by turning it into a ref to remove its reactivity.
+ *
+ * Used to access the passed value inside `React.useEffect` without causing the effect to re-run when the value changes.
+ */
+export declare function useValueAsRef<T>(value: T): {
+  current: T;
+  next: T;
+  effect: () => void;
+};

package/useValueAsRef.js

@@ -0,0 +1,32 @@
+"use strict";
+'use client';
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useValueAsRef = useValueAsRef;
+var _useIsoLayoutEffect = require("./useIsoLayoutEffect");
+var _useRefWithInit = require("./useRefWithInit");
+/**
+ * Untracks the provided value by turning it into a ref to remove its reactivity.
+ *
+ * Used to access the passed value inside `React.useEffect` without causing the effect to re-run when the value changes.
+ */
+function useValueAsRef(value) {
+  const latest = (0, _useRefWithInit.useRefWithInit)(createLatestRef, value).current;
+  latest.next = value;
+
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  (0, _useIsoLayoutEffect.useIsoLayoutEffect)(latest.effect);
+  return latest;
+}
+function createLatestRef(value) {
+  const latest = {
+    current: value,
+    next: value,
+    effect: () => {
+      latest.current = latest.next;
+    }
+  };
+  return latest;
+}

package/visuallyHidden.d.ts

@@ -0,0 +1,3 @@
+import * as React from 'react';
+export declare const visuallyHidden: React.CSSProperties;
+export declare const visuallyHiddenInput: React.CSSProperties;

package/visuallyHidden.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.visuallyHiddenInput = exports.visuallyHidden = void 0;
+const visuallyHiddenBase = {
+  clipPath: 'inset(50%)',
+  overflow: 'hidden',
+  whiteSpace: 'nowrap',
+  border: 0,
+  padding: 0,
+  width: 1,
+  height: 1,
+  margin: -1
+};
+const visuallyHidden = exports.visuallyHidden = {
+  ...visuallyHiddenBase,
+  position: 'fixed',
+  top: 0,
+  left: 0
+};
+const visuallyHiddenInput = exports.visuallyHiddenInput = {
+  ...visuallyHiddenBase,
+  position: 'absolute'
+};

package/warn.d.ts

@@ -0,0 +1 @@
+export declare function warn(...messages: string[]): void;

package/warn.js

@@ -0,0 +1,19 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.warn = warn;
+let set;
+if (process.env.NODE_ENV !== 'production') {
+  set = new Set();
+}
+function warn(...messages) {
+  if (process.env.NODE_ENV !== 'production') {
+    const messageKey = messages.join(' ');
+    if (!set.has(messageKey)) {
+      set.add(messageKey);
+      console.warn(`Tale UI: ${messageKey}`);
+    }
+  }
+}