@apia/util 1.0.4 → 2.0.0

package/dist/propsStore/usePropsSelector.js

@@ -0,0 +1,92 @@
+import React__default, { useRef } from 'react';
+import { propsStore, PropsSelectorUndefinedObject } from './propsStore.js';
+
+const defaultComparator = (a, b) => {
+  return a === b;
+};
+function getDefaultSelector() {
+  return (current) => {
+    return current;
+  };
+}
+function isPropsConfigurationObject(value) {
+  return typeof value === "object" && value && ("selector" in value || "comparator" in value || "initialValue" in value);
+}
+function usePropsSelector(fieldId, par1, par2, par3) {
+  const selector = React__default.useMemo(
+    () => {
+      return isPropsConfigurationObject(par1) ? par1.selector : par1;
+    },
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    []
+  );
+  const comparator = React__default.useMemo(
+    () => {
+      return isPropsConfigurationObject(par1) ? par1.comparator : par2;
+    },
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    []
+  );
+  const initialValue = React__default.useMemo(
+    () => {
+      return isPropsConfigurationObject(par1) ? par1.initialValue : void 0;
+    },
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    []
+  );
+  const actualPropsStore = React__default.useMemo(
+    () => {
+      return par3 ?? (isPropsConfigurationObject(par1) ? par1.propsStore : propsStore) ?? propsStore;
+    },
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [
+      // eslint-disable-next-line react-hooks/exhaustive-deps
+      par3 ?? (isPropsConfigurationObject(par1) ? par1.propsStore : propsStore) ?? propsStore
+    ]
+  );
+  const getCurrentProps = React__default.useCallback(() => {
+    const currentProps = actualPropsStore.getFieldProps(fieldId);
+    const willSetInitialValue = currentProps !== void 0 && initialValue !== void 0;
+    if (willSetInitialValue) {
+      actualPropsStore.updateField(
+        fieldId,
+        initialValue
+      );
+    }
+    return (selector ?? getDefaultSelector())(
+      currentProps ?? PropsSelectorUndefinedObject
+    );
+  }, []);
+  const [props, setProps] = React__default.useState(getCurrentProps);
+  const prevProps = useRef(props);
+  const prevFieldId = useRef(fieldId);
+  React__default.useEffect(() => {
+    const unsuscribe = actualPropsStore.suscribe(
+      fieldId,
+      (newProps, isUrgent) => {
+        const newSelectedProps = (selector ?? getDefaultSelector())(
+          newProps
+        );
+        if (!(comparator ?? defaultComparator)(
+          prevProps.current,
+          newSelectedProps
+        ) || prevFieldId.current !== fieldId) {
+          if (isUrgent)
+            setProps(newSelectedProps);
+          else
+            React__default.startTransition(() => {
+              setProps(newSelectedProps);
+            });
+        }
+        prevProps.current = newSelectedProps;
+      }
+    );
+    return () => {
+      unsuscribe();
+    };
+  }, [fieldId, actualPropsStore, selector, comparator]);
+  return props;
+}
+
+export { isPropsConfigurationObject, usePropsSelector };
+//# sourceMappingURL=usePropsSelector.js.map

package/dist/propsStore/usePropsSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePropsSelector.js","sources":["../../src/propsStore/usePropsSelector.ts"],"sourcesContent":["import React, { useRef } from 'react';\nimport {\n  PropsSelectorUndefinedObject,\n  propsStore,\n  PropsStore,\n} from './propsStore';\nimport {\n  TProperties,\n  TPropsComparator,\n  TPropsConfiguration,\n  TPropsSelector,\n} from './types';\nimport { TId } from '../types';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst defaultComparator: TPropsComparator<any> = (a, b) => {\n  return a === b;\n};\nfunction getDefaultSelector<Selected, PropsType = TProperties>() {\n  return (current: PropsType) => {\n    return current as unknown as Selected;\n  };\n}\n\nexport function isPropsConfigurationObject<\n  Selected,\n  PropsType extends Record<string, unknown> = TProperties,\n>(\n  value?:\n    | TPropsSelector<Selected, PropsType>\n    | TPropsConfiguration<Selected, PropsType>,\n): value is TPropsConfiguration<Selected, PropsType> {\n  return (\n    typeof value === 'object' &&\n    value &&\n    ('selector' in value || 'comparator' in value || 'initialValue' in value)\n  );\n}\n\n/**\n *\n * Este hook permite escuchar los cambios en las propiedades\n * de un campo en particular.\n *\n * @param configuration\n * Este objeto permite pasar las siguientes propiedades para ser\n * determinar el comportamiento del hook:\n *\n * **selector:** La función selectora es una función equivalente\n * a la que se utiliza en el useAppSelector de redux. Con ella\n * se puede seleccionar una porción de las props, evitando\n * re-renderizados innecesarios. Esto se debe a que el renderizado\n * solamente ocurrirá cuando la función selectora devuelva un valor\n * que sea distinto del anterior.\n *\n * El concepto de distinto es: si existe una función comparadora,\n * se determinará mediante la ejecución de dicha función, a la que\n * se le pasan como parámetros el objeto anterior y el nuevo.\n *\n * En caso de que no haya función comparadora, se comparará que\n * las props seleccionadas y las nuevas sean exactamente las mismas\n * (la referencia al mismo objeto).\n *\n * **comparator:** La función comparadora de la que estamos\n * hablando.\n *\n * **initialValue:** Un valor para setearlo al inicio, el mismo\n * solamente será seteado en caso de que ya no exista un valor\n * en el store.\n * @returns\n */\nexport function usePropsSelector<\n  Selected = TProperties,\n  PropsType extends Record<string, unknown> = TProperties,\n>(\n  fieldId: TId,\n  configuration?: TPropsConfiguration<Selected, PropsType>,\n): Selected;\n/**\n *\n * Este hook permite escuchar los cambios en las propiedades\n * de un campo en particular.\n *\n * @param selector La función selectora es una función equivalente\n * a la que se utiliza en el useAppSelector de redux. Con ella\n * se puede seleccionar una porción de las props, evitando\n * re-renderizados innecesarios. Esto se debe a que el renderizado\n * solamente ocurrirá cuando la función selectora devuelva un valor\n * que sea distinto del anterior.\n *\n * El concepto de distinto es: si existe una función comparadora,\n * se determinará mediante la ejecución de dicha función, a la que\n * se le pasan como parámetros el objeto anterior y el nuevo.\n *\n * En caso de que no haya función comparadora, se comparará que\n * las props seleccionadas y las nuevas sean exactamente las mismas\n * (la referencia al mismo objeto).\n *\n * @param comparator La función comparadora de la que estamos\n * hablando.\n *\n * @returns\n */\nexport function usePropsSelector<\n  Selected = TProperties,\n  PropsType extends Record<string, unknown> = TProperties,\n>(\n  fieldId: TId,\n  selector?:\n    | TPropsSelector<Selected, PropsType>\n    | TPropsConfiguration<Selected, PropsType>,\n  comparator?: TPropsComparator<Selected>,\n  anotherPropsStore?: PropsStore<PropsType>,\n): Selected;\nexport function usePropsSelector<\n  Selected = TProperties,\n  PropsType extends Record<string, unknown> = TProperties,\n>(\n  fieldId: TId,\n  par1?:\n    | TPropsSelector<Selected, PropsType>\n    | TPropsConfiguration<Selected, PropsType>,\n  par2?: TPropsComparator<Selected>,\n  par3?: PropsStore<PropsType>,\n): Selected {\n  const selector = React.useMemo(\n    () => {\n      return isPropsConfigurationObject(par1) ? par1.selector : par1;\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [],\n  );\n  const comparator = React.useMemo(\n    () => {\n      return isPropsConfigurationObject(par1) ? par1.comparator : par2;\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [],\n  );\n  const initialValue = React.useMemo(\n    () => {\n      return isPropsConfigurationObject(par1) ? par1.initialValue : undefined;\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [],\n  );\n  const actualPropsStore = React.useMemo(\n    () => {\n      return (\n        par3 ??\n        (isPropsConfigurationObject(par1) ? par1.propsStore : propsStore) ??\n        propsStore\n      );\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n      par3 ??\n        (isPropsConfigurationObject(par1) ? par1.propsStore : propsStore) ??\n        propsStore,\n    ],\n  );\n\n  const getCurrentProps = React.useCallback(() => {\n    const currentProps = actualPropsStore.getFieldProps<PropsType>(fieldId);\n    const willSetInitialValue =\n      currentProps !== undefined && initialValue !== undefined;\n    if (willSetInitialValue) {\n      actualPropsStore.updateField(\n        fieldId,\n        initialValue as unknown as TProperties,\n      );\n    }\n    return (selector ?? getDefaultSelector())(\n      currentProps ?? (PropsSelectorUndefinedObject as PropsType),\n    );\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  const [props, setProps] = React.useState<Selected>(getCurrentProps);\n\n  const prevProps = useRef(props);\n  const prevFieldId = useRef(fieldId);\n\n  React.useEffect(() => {\n    const unsuscribe = actualPropsStore.suscribe(\n      fieldId,\n      (newProps, isUrgent) => {\n        const newSelectedProps = (selector ?? getDefaultSelector())(\n          newProps as unknown as PropsType,\n        );\n\n        if (\n          !(comparator ?? defaultComparator)(\n            prevProps.current,\n            newSelectedProps,\n          ) ||\n          prevFieldId.current !== fieldId\n        ) {\n          if (isUrgent) setProps(newSelectedProps);\n          else\n            React.startTransition(() => {\n              setProps(newSelectedProps);\n            });\n        }\n        prevProps.current = newSelectedProps;\n      },\n    );\n\n    return () => {\n      unsuscribe();\n    };\n  }, [fieldId, actualPropsStore, selector, comparator]);\n\n  return props;\n}\n"],"names":["React"],"mappings":"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"}

package/dist/screenLock/screenLocker.d.ts

@@ -0,0 +1,60 @@
+import { EventEmitter } from '../events/EventEmitter.js';
+
+declare class ScreenLocker extends EventEmitter<{
+    forcedStateChange: {
+        hasReleasedFirstTime: boolean;
+        isForced: boolean;
+    };
+    lockStateChange: {
+        hasReleasedFirstTime: boolean;
+        isLocked: boolean;
+        lockName: string;
+    };
+    releaseForFirstTime: null;
+    ready: null;
+}> {
+    #private;
+    get hasReleasedFirstTime(): boolean;
+    get isForced(): boolean;
+    /**
+     * Permite saber si un bloqueo determinado está activo o si la clase tiene
+     * forceLock activo.
+     */
+    isLocked(lockName?: string): boolean;
+    constructor();
+    lock(lockName?: string): void;
+    unlock(lockName?: string): void;
+    force(): void;
+    releaseForced(): void;
+}
+/**
+ * Esta clase no implementa ninguna funcionalidad de bloqueo, sino solamente se
+ * encarga de la lógica y de los eventos.
+ *
+ * El concepto es que hay n niveles de bloqueo y además existe el bloqueo
+ * forzado. Cada uno de los niveles recibe un nombre, por defecto se realizan
+ * operaciones contra el bloque 'common' si no se pasa ninguno, pero
+ * podría utilizarse cualquier otro. Esto es así con el fin de implementar
+ * varios bloqueos en la misma clase, ejemplos: el bloqueo común, el bloqueo
+ * lineal de las tablas, bloque con pantalla blanca en el inicio de formularios,
+ * o cualquier otro que se desee. Para los bloqueos estándar se utilizan los
+ * métodos lock y unlock.
+ *
+ * El bloqueo forzado por otra parte es un estado general que se puede alterar
+ * mediante los métodos force y releaseForced. Cada vez que se bloquee o
+ * desbloquee la pantalla, se lanzará un evento lockStateChange sin lockName y
+ * con forced = true.
+ *
+ * Además, provee un evento para saber cuándo se desbloquea la pantalla
+ * efectivamente por primera vez para cada tipo de bloqueo. Es posible a su vez
+ * resetear la clase para que este evento sea lanzado nuevamente en el próximo
+ * desbloqueo mediante resetRefreshFirstTime.
+ *
+ * El evento releasForFirstTime se dispara únicamente para el bloqueo 'common'.
+ * Esto es así ya que sino podría dar lugar a confusión en situaciones donde no
+ * se controle el nombre del bloqueo.
+ */
+declare const screenLocker: ScreenLocker;
+
+export { screenLocker };
+//# sourceMappingURL=screenLocker.d.ts.map

package/dist/screenLock/screenLocker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenLocker.d.ts","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/screenLock/screenLocker.js

@@ -0,0 +1,95 @@
+import { EventEmitter } from '../events/EventEmitter.js';
+
+var __accessCheck = (obj, member, msg) => {
+  if (!member.has(obj))
+    throw TypeError("Cannot " + msg);
+};
+var __privateGet = (obj, member, getter) => {
+  __accessCheck(obj, member, "read from private field");
+  return getter ? getter.call(obj) : member.get(obj);
+};
+var __privateAdd = (obj, member, value) => {
+  if (member.has(obj))
+    throw TypeError("Cannot add the same private member more than once");
+  member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+};
+var __privateSet = (obj, member, value, setter) => {
+  __accessCheck(obj, member, "write to private field");
+  setter ? setter.call(obj, value) : member.set(obj, value);
+  return value;
+};
+var __privateMethod = (obj, member, method) => {
+  __accessCheck(obj, member, "access private method");
+  return method;
+};
+var _hasReleasedFirstTime, _wasReleasedFirstTime, _isForced, _locks, _shoutLockState, shoutLockState_fn;
+class ScreenLocker extends EventEmitter {
+  constructor() {
+    super();
+    __privateAdd(this, _shoutLockState);
+    __privateAdd(this, _hasReleasedFirstTime, false);
+    __privateAdd(this, _wasReleasedFirstTime, false);
+    __privateAdd(this, _isForced, false);
+    __privateAdd(this, _locks, {
+      common: false
+    });
+    this.emit("ready", null);
+  }
+  get hasReleasedFirstTime() {
+    return __privateGet(this, _hasReleasedFirstTime);
+  }
+  get isForced() {
+    return __privateGet(this, _isForced);
+  }
+  /**
+   * Permite saber si un bloqueo determinado está activo o si la clase tiene
+   * forceLock activo.
+   */
+  isLocked(lockName = "common") {
+    return __privateGet(this, _locks)[lockName] || __privateGet(this, _isForced);
+  }
+  lock(lockName = "common") {
+    __privateGet(this, _locks)[lockName] = true;
+    __privateMethod(this, _shoutLockState, shoutLockState_fn).call(this, lockName);
+  }
+  unlock(lockName = "common") {
+    if (lockName === "common")
+      __privateSet(this, _hasReleasedFirstTime, true);
+    __privateGet(this, _locks)[lockName] = false;
+    __privateMethod(this, _shoutLockState, shoutLockState_fn).call(this, lockName);
+  }
+  force() {
+    __privateSet(this, _isForced, true);
+    __privateMethod(this, _shoutLockState, shoutLockState_fn).call(this);
+  }
+  releaseForced() {
+    __privateSet(this, _isForced, false);
+    __privateMethod(this, _shoutLockState, shoutLockState_fn).call(this);
+  }
+}
+_hasReleasedFirstTime = new WeakMap();
+_wasReleasedFirstTime = new WeakMap();
+_isForced = new WeakMap();
+_locks = new WeakMap();
+_shoutLockState = new WeakSet();
+shoutLockState_fn = function(lockName) {
+  if (__privateGet(this, _isForced) || lockName === void 0) {
+    this.emit("forcedStateChange", {
+      isForced: __privateGet(this, _isForced),
+      hasReleasedFirstTime: __privateGet(this, _hasReleasedFirstTime)
+    });
+  } else {
+    if (lockName === "common" && !__privateGet(this, _wasReleasedFirstTime) && __privateGet(this, _hasReleasedFirstTime)) {
+      this.emit("releaseForFirstTime", null);
+    }
+    this.emit("lockStateChange", {
+      lockName,
+      hasReleasedFirstTime: __privateGet(this, _hasReleasedFirstTime),
+      isLocked: __privateGet(this, _locks)[lockName]
+    });
+  }
+};
+const screenLocker = new ScreenLocker();
+
+export { screenLocker };
+//# sourceMappingURL=screenLocker.js.map

package/dist/screenLock/screenLocker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenLocker.js","sources":["../../src/screenLock/screenLocker.ts"],"sourcesContent":["import { EventEmitter } from '../events/EventEmitter';\nclass ScreenLocker extends EventEmitter<{\n  forcedStateChange: {\n    hasReleasedFirstTime: boolean;\n    isForced: boolean;\n  };\n  lockStateChange: {\n    hasReleasedFirstTime: boolean;\n    isLocked: boolean;\n    lockName: string;\n  };\n  releaseForFirstTime: null;\n  ready: null;\n}> {\n  #hasReleasedFirstTime = false;\n\n  #wasReleasedFirstTime = false;\n\n  #isForced = false;\n\n  #locks: Record<string, boolean> = {\n    common: false,\n  };\n\n  get hasReleasedFirstTime() {\n    return this.#hasReleasedFirstTime;\n  }\n\n  get isForced() {\n    return this.#isForced;\n  }\n\n  /**\n   * Permite saber si un bloqueo determinado está activo o si la clase tiene\n   * forceLock activo.\n   */\n  isLocked(lockName = 'common') {\n    return this.#locks[lockName] || this.#isForced;\n  }\n\n  constructor() {\n    super();\n\n    this.emit('ready', null);\n  }\n\n  #shoutLockState(lockName?: string) {\n    if (this.#isForced || lockName === undefined) {\n      this.emit('forcedStateChange', {\n        isForced: this.#isForced,\n        hasReleasedFirstTime: this.#hasReleasedFirstTime,\n      });\n    } else {\n      if (\n        lockName === 'common' &&\n        !this.#wasReleasedFirstTime &&\n        this.#hasReleasedFirstTime\n      ) {\n        this.emit('releaseForFirstTime', null);\n      }\n\n      this.emit('lockStateChange', {\n        lockName,\n        hasReleasedFirstTime: this.#hasReleasedFirstTime,\n        isLocked: this.#locks[lockName],\n      });\n    }\n  }\n\n  lock(lockName = 'common') {\n    this.#locks[lockName] = true;\n    this.#shoutLockState(lockName);\n  }\n\n  unlock(lockName = 'common') {\n    if (lockName === 'common') this.#hasReleasedFirstTime = true;\n    this.#locks[lockName] = false;\n    this.#shoutLockState(lockName);\n  }\n\n  force() {\n    this.#isForced = true;\n    this.#shoutLockState();\n  }\n\n  releaseForced() {\n    this.#isForced = false;\n    this.#shoutLockState();\n  }\n}\n\n/**\n * Esta clase no implementa ninguna funcionalidad de bloqueo, sino solamente se\n * encarga de la lógica y de los eventos.\n *\n * El concepto es que hay n niveles de bloqueo y además existe el bloqueo\n * forzado. Cada uno de los niveles recibe un nombre, por defecto se realizan\n * operaciones contra el bloque 'common' si no se pasa ninguno, pero\n * podría utilizarse cualquier otro. Esto es así con el fin de implementar\n * varios bloqueos en la misma clase, ejemplos: el bloqueo común, el bloqueo\n * lineal de las tablas, bloque con pantalla blanca en el inicio de formularios,\n * o cualquier otro que se desee. Para los bloqueos estándar se utilizan los\n * métodos lock y unlock.\n *\n * El bloqueo forzado por otra parte es un estado general que se puede alterar\n * mediante los métodos force y releaseForced. Cada vez que se bloquee o\n * desbloquee la pantalla, se lanzará un evento lockStateChange sin lockName y\n * con forced = true.\n *\n * Además, provee un evento para saber cuándo se desbloquea la pantalla\n * efectivamente por primera vez para cada tipo de bloqueo. Es posible a su vez\n * resetear la clase para que este evento sea lanzado nuevamente en el próximo\n * desbloqueo mediante resetRefreshFirstTime.\n *\n * El evento releasForFirstTime se dispara únicamente para el bloqueo 'common'.\n * Esto es así ya que sino podría dar lugar a confusión en situaciones donde no\n * se controle el nombre del bloqueo.\n */\nconst screenLocker = new ScreenLocker();\n\nexport { screenLocker };\n"],"names":[],"mappings":"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"}

package/dist/states/useDebouncedState.d.ts

@@ -0,0 +1,10 @@
+import { SetStateAction } from 'react';
+
+/**
+ * Permite manejar un estado que se actualizará únicamente siguiendo el
+ * comportamiento esperado de un debounce
+ */
+declare function useDebouncedState<T>(timeout: number, initialState?: T): [T | undefined, (state: SetStateAction<T>, immediate?: boolean) => unknown];
+
+export { useDebouncedState };
+//# sourceMappingURL=useDebouncedState.d.ts.map

package/dist/states/useDebouncedState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedState.d.ts","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/states/useDebouncedState.js

@@ -0,0 +1,22 @@
+import { useState, useRef, useCallback } from 'react';
+
+function useDebouncedState(timeout, initialState) {
+  const [state, innerSetState] = useState(initialState);
+  const t = useRef(-1);
+  const setState = useCallback(
+    (newState, immediate) => {
+      clearTimeout(t.current);
+      if (immediate)
+        innerSetState(newState);
+      else
+        t.current = setTimeout(() => {
+          innerSetState(newState);
+        }, timeout);
+    },
+    [timeout]
+  );
+  return [state, setState];
+}
+
+export { useDebouncedState };
+//# sourceMappingURL=useDebouncedState.js.map

package/dist/states/useDebouncedState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedState.js","sources":["../../src/states/useDebouncedState.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { SetStateAction, useCallback, useRef } from 'react';\nimport { useState } from 'react';\n\n/**\n * Permite manejar un estado que se actualizará únicamente siguiendo el\n * comportamiento esperado de un debounce\n */\nexport function useDebouncedState<T>(\n  timeout: number,\n  initialState?: T,\n): [T | undefined, (state: SetStateAction<T>, immediate?: boolean) => unknown] {\n  const [state, innerSetState] = useState<T>(initialState as T);\n\n  const t = useRef<number>(-1);\n\n  const setState = useCallback<\n    (state: SetStateAction<T>, immediate?: boolean) => unknown\n  >(\n    (newState, immediate?: boolean) => {\n      clearTimeout(t.current);\n\n      if (immediate) innerSetState(newState);\n      else\n        t.current = setTimeout(() => {\n          innerSetState(newState);\n        }, timeout) as any;\n    },\n    [timeout],\n  );\n\n  return [state, setState];\n}\n"],"names":[],"mappings":";;AAQgB,SAAA,iBAAA,CACd,SACA,YAC6E,EAAA;AAC7E,EAAA,MAAM,CAAC,KAAA,EAAO,aAAa,CAAA,GAAI,SAAY,YAAiB,CAAA,CAAA;AAE5D,EAAM,MAAA,CAAA,GAAI,OAAe,CAAE,CAAA,CAAA,CAAA;AAE3B,EAAA,MAAM,QAAW,GAAA,WAAA;AAAA,IAGf,CAAC,UAAU,SAAwB,KAAA;AACjC,MAAA,YAAA,CAAa,EAAE,OAAO,CAAA,CAAA;AAEtB,MAAI,IAAA,SAAA;AAAW,QAAA,aAAA,CAAc,QAAQ,CAAA,CAAA;AAAA;AAEnC,QAAE,CAAA,CAAA,OAAA,GAAU,WAAW,MAAM;AAC3B,UAAA,aAAA,CAAc,QAAQ,CAAA,CAAA;AAAA,WACrB,OAAO,CAAA,CAAA;AAAA,KACd;AAAA,IACA,CAAC,OAAO,CAAA;AAAA,GACV,CAAA;AAEA,EAAO,OAAA,CAAC,OAAO,QAAQ,CAAA,CAAA;AACzB;;;;"}

package/dist/states/useDomState.d.ts

@@ -0,0 +1,86 @@
+import { HTMLAttributes } from 'react';
+
+/**
+ * El hook useDomState permite aplicar propiedades a un
+ * elemento del DOM de la forma más eficiente posible.
+ *
+ * Este hook no permite el uso de sx ya que por las características
+ * del sx, el re-renderizado es necesario.
+ *
+ * @example
+ *
+ *
+ * const TestComponent = () => {
+  const { domProps, setDomProps } = useDomState<BoxProps>({
+    style: {
+      position: 'fixed',
+      left: 0,
+      top: 0,
+      width: '150px',
+      height: '150px',
+      backgroundColor: '#ccc',
+    },
+  });
+  const initialPosition = React.useRef({ boxX: 0, boxY: 0, x: 0, y: 0 });
+  const isDragging = React.useRef(false);
+  const [state, setState] = React.useState(1);
+
+  React.useEffect(() => {
+    const move = (ev: MouseEvent) => {
+      if (isDragging.current) {
+        const moveX = ev.clientX - initialPosition.current.x;
+        const moveY = ev.clientY - initialPosition.current.y;
+        const newLeft = initialPosition.current.boxX + moveX;
+        const newTop = initialPosition.current.boxY + moveY;
+        setDomProps({
+          style: {
+            left: `${newLeft}px`,
+            top: `${newTop}px`,
+          },
+        });
+      }
+    };
+
+    const removeSuscription = () => {
+      isDragging.current = false;
+    };
+
+    document.addEventListener('mousemove', move);
+    document.addEventListener('mouseup', removeSuscription);
+
+    return () => {
+      document.removeEventListener('mousemove', move);
+      document.removeEventListener('mouseup', removeSuscription);
+    };
+  }, [setDomProps]);
+
+  return (
+    <Box
+      {...domProps}
+      onMouseDown={(ev) => {
+        initialPosition.current = {
+          boxX: Number.parseInt(domProps.style?.left as string, 10),
+          boxY: Number.parseInt(domProps.style?.top as string, 10),
+          x: ev.clientX,
+          y: ev.clientY,
+        };
+        isDragging.current = true;
+      }}
+    >
+      Esta caja es arrastrable. Renderizados: {state}
+      <Button onClick={() => setState((current) => current + 1)}>
+        Renderizar
+      </Button>
+    </Box>
+  );
+};
+ */
+declare function useDomState<T extends HTMLAttributes<HTMLElement>>(initialDomProps?: T): {
+    domProps: T & {
+        ref: (el: HTMLElement) => void;
+    };
+    setDomProps: ({ style, ...newDomProps }: Partial<T>) => void;
+};
+
+export { useDomState };
+//# sourceMappingURL=useDomState.d.ts.map

package/dist/states/useDomState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDomState.d.ts","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/states/useDomState.js

@@ -0,0 +1,35 @@
+import React__default from 'react';
+
+function assignProps(el, { style, ...props }) {
+  if (style) {
+    Object.entries(style).forEach(([name, value]) => {
+      el.style[name] = value;
+    });
+  }
+  Object.assign(el, props);
+}
+function useDomState(initialDomProps) {
+  const domProps = React__default.useRef({
+    ...initialDomProps ?? {},
+    ref: React__default.useCallback((el) => {
+      ref.current = el;
+      assignProps(ref.current, domProps.current);
+    }, [])
+  });
+  const ref = React__default.useRef(null);
+  return {
+    domProps: domProps.current,
+    setDomProps: React__default.useCallback(({ style, ...newDomProps }) => {
+      if (style) {
+        const newStyles = { ...domProps.current.style, ...style };
+        domProps.current.style = newStyles;
+      }
+      Object.assign(domProps.current, newDomProps);
+      if (ref.current)
+        assignProps(ref.current, domProps.current);
+    }, [])
+  };
+}
+
+export { useDomState };
+//# sourceMappingURL=useDomState.js.map

package/dist/states/useDomState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDomState.js","sources":["../../src/states/useDomState.tsx"],"sourcesContent":["import React, { HTMLAttributes, HTMLProps } from 'react';\n\nfunction assignProps<T extends HTMLProps<HTMLElement>>(\n  el: HTMLElement,\n  { style, ...props }: T,\n) {\n  if (style) {\n    Object.entries(style).forEach(([name, value]) => {\n      // eslint-disable-next-line no-param-reassign, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment\n      (el as any).style[name] = value;\n    });\n  }\n  Object.assign(el, props);\n}\n\n/**\n * El hook useDomState permite aplicar propiedades a un\n * elemento del DOM de la forma más eficiente posible.\n *\n * Este hook no permite el uso de sx ya que por las características\n * del sx, el re-renderizado es necesario.\n *\n * @example\n *\n *\n * const TestComponent = () => {\n  const { domProps, setDomProps } = useDomState<BoxProps>({\n    style: {\n      position: 'fixed',\n      left: 0,\n      top: 0,\n      width: '150px',\n      height: '150px',\n      backgroundColor: '#ccc',\n    },\n  });\n  const initialPosition = React.useRef({ boxX: 0, boxY: 0, x: 0, y: 0 });\n  const isDragging = React.useRef(false);\n  const [state, setState] = React.useState(1);\n\n  React.useEffect(() => {\n    const move = (ev: MouseEvent) => {\n      if (isDragging.current) {\n        const moveX = ev.clientX - initialPosition.current.x;\n        const moveY = ev.clientY - initialPosition.current.y;\n        const newLeft = initialPosition.current.boxX + moveX;\n        const newTop = initialPosition.current.boxY + moveY;\n        setDomProps({\n          style: {\n            left: `${newLeft}px`,\n            top: `${newTop}px`,\n          },\n        });\n      }\n    };\n\n    const removeSuscription = () => {\n      isDragging.current = false;\n    };\n\n    document.addEventListener('mousemove', move);\n    document.addEventListener('mouseup', removeSuscription);\n\n    return () => {\n      document.removeEventListener('mousemove', move);\n      document.removeEventListener('mouseup', removeSuscription);\n    };\n  }, [setDomProps]);\n\n  return (\n    <Box\n      {...domProps}\n      onMouseDown={(ev) => {\n        initialPosition.current = {\n          boxX: Number.parseInt(domProps.style?.left as string, 10),\n          boxY: Number.parseInt(domProps.style?.top as string, 10),\n          x: ev.clientX,\n          y: ev.clientY,\n        };\n        isDragging.current = true;\n      }}\n    >\n      Esta caja es arrastrable. Renderizados: {state}\n      <Button onClick={() => setState((current) => current + 1)}>\n        Renderizar\n      </Button>\n    </Box>\n  );\n};\n */\nexport function useDomState<T extends HTMLAttributes<HTMLElement>>(\n  initialDomProps?: T,\n) {\n  const domProps = React.useRef<T & { ref: (el: HTMLElement) => void }>({\n    ...(initialDomProps ?? ({} as T)),\n    ref: React.useCallback((el: HTMLElement) => {\n      ref.current = el;\n      assignProps(ref.current, domProps.current);\n    }, []),\n  });\n  const ref = React.useRef<HTMLElement | null>(null);\n  return {\n    domProps: domProps.current,\n    setDomProps: React.useCallback(({ style, ...newDomProps }: Partial<T>) => {\n      if (style) {\n        const newStyles = { ...domProps.current.style, ...style };\n        domProps.current.style = newStyles;\n      }\n      Object.assign(domProps.current, newDomProps);\n      if (ref.current) assignProps(ref.current, domProps.current);\n    }, []),\n  };\n}\n"],"names":["React"],"mappings":";;AAEA,SAAS,YACP,EACA,EAAA,EAAE,KAAO,EAAA,GAAG,OACZ,EAAA;AACA,EAAA,IAAI,KAAO,EAAA;AACT,IAAO,MAAA,CAAA,OAAA,CAAQ,KAAK,CAAE,CAAA,OAAA,CAAQ,CAAC,CAAC,IAAA,EAAM,KAAK,CAAM,KAAA;AAE/C,MAAC,EAAA,CAAW,KAAM,CAAA,IAAI,CAAI,GAAA,KAAA,CAAA;AAAA,KAC3B,CAAA,CAAA;AAAA,GACH;AACA,EAAO,MAAA,CAAA,MAAA,CAAO,IAAI,KAAK,CAAA,CAAA;AACzB,CAAA;AA6EO,SAAS,YACd,eACA,EAAA;AACA,EAAM,MAAA,QAAA,GAAWA,eAAM,MAA+C,CAAA;AAAA,IACpE,GAAI,mBAAoB,EAAC;AAAA,IACzB,GAAK,EAAAA,cAAA,CAAM,WAAY,CAAA,CAAC,EAAoB,KAAA;AAC1C,MAAA,GAAA,CAAI,OAAU,GAAA,EAAA,CAAA;AACd,MAAY,WAAA,CAAA,GAAA,CAAI,OAAS,EAAA,QAAA,CAAS,OAAO,CAAA,CAAA;AAAA,KAC3C,EAAG,EAAE,CAAA;AAAA,GACN,CAAA,CAAA;AACD,EAAM,MAAA,GAAA,GAAMA,cAAM,CAAA,MAAA,CAA2B,IAAI,CAAA,CAAA;AACjD,EAAO,OAAA;AAAA,IACL,UAAU,QAAS,CAAA,OAAA;AAAA,IACnB,WAAA,EAAaA,eAAM,WAAY,CAAA,CAAC,EAAE,KAAO,EAAA,GAAG,aAA8B,KAAA;AACxE,MAAA,IAAI,KAAO,EAAA;AACT,QAAA,MAAM,YAAY,EAAE,GAAG,SAAS,OAAQ,CAAA,KAAA,EAAO,GAAG,KAAM,EAAA,CAAA;AACxD,QAAA,QAAA,CAAS,QAAQ,KAAQ,GAAA,SAAA,CAAA;AAAA,OAC3B;AACA,MAAO,MAAA,CAAA,MAAA,CAAO,QAAS,CAAA,OAAA,EAAS,WAAW,CAAA,CAAA;AAC3C,MAAA,IAAI,GAAI,CAAA,OAAA;AAAS,QAAY,WAAA,CAAA,GAAA,CAAI,OAAS,EAAA,QAAA,CAAS,OAAO,CAAA,CAAA;AAAA,KAC5D,EAAG,EAAE,CAAA;AAAA,GACP,CAAA;AACF;;;;"}