@hanzogui/use-controllable-state 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+  Copyright (c) 2020 Nate Wienert
+  
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+  
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+  
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.

package/dist/cjs/index.cjs

@@ -0,0 +1,18 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+    if (from && typeof from == "object" || typeof from == "function") for (let key of __getOwnPropNames(from)) !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+    return to;
+  },
+  __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: !0
+}), mod);
+var index_exports = {};
+module.exports = __toCommonJS(index_exports);
+__reExport(index_exports, require("./useControllableState.cjs"), module.exports);

package/dist/cjs/index.native.js

@@ -0,0 +1,21 @@
+"use strict";
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+    if (from && typeof from == "object" || typeof from == "function") for (let key of __getOwnPropNames(from)) !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+    return to;
+  },
+  __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: !0
+}), mod);
+var index_exports = {};
+module.exports = __toCommonJS(index_exports);
+__reExport(index_exports, require("./useControllableState.native.js"), module.exports);
+//# sourceMappingURL=index.native.js.map

package/dist/cjs/index.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","index_exports","module","exports"],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":";;;;;;;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,GAAA,IAAAC,WAAA,CAAAC,SAAA;EAAAC,KAAA;AAAA,IAAAH,GAAA;AAAA,IAAAI,aAAA;AAAAC,MAAA,CAAAC,OAAA,GAAAP,YAAc,CAAAK,aAAA","ignoreList":[]}

package/dist/cjs/useControllableState.cjs

@@ -0,0 +1,72 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf,
+  __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+    for (var name in all) __defProp(target, name, {
+      get: all[name],
+      enumerable: !0
+    });
+  },
+  __copyProps = (to, from, except, desc) => {
+    if (from && typeof from == "object" || typeof from == "function") for (let key of __getOwnPropNames(from)) !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+    return to;
+  };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+    value: mod,
+    enumerable: !0
+  }) : target, mod)),
+  __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+    value: !0
+  }), mod);
+var useControllableState_exports = {};
+__export(useControllableState_exports, {
+  useControllableState: () => useControllableState
+});
+module.exports = __toCommonJS(useControllableState_exports);
+var import_use_event = require("@hanzogui/use-event"),
+  React = __toESM(require("react"), 1),
+  import_start_transition = require("@hanzogui/start-transition");
+const emptyCallbackFn = _ => _();
+function useControllableState({
+  prop,
+  defaultProp,
+  onChange,
+  strategy = "prop-wins",
+  preventUpdate,
+  transition
+}) {
+  const [state, setState] = React.useState(prop ?? defaultProp),
+    previous = React.useRef(state),
+    propWins = strategy === "prop-wins" && prop !== void 0,
+    value = propWins ? prop : state,
+    onChangeCb = (0, import_use_event.useEvent)(onChange || idFn),
+    transitionFn = transition ? import_start_transition.startTransition : emptyCallbackFn;
+  React.useEffect(() => {
+    prop !== void 0 && (previous.current = prop, transitionFn(() => {
+      setState(prop);
+    }));
+  }, [prop]), React.useEffect(() => {
+    propWins || state !== previous.current && (previous.current = state, onChangeCb(state));
+  }, [onChangeCb, state, propWins]);
+  const setter = (0, import_use_event.useEvent)(next => {
+    if (!preventUpdate) if (propWins) {
+      const nextValue = typeof next == "function" ? next(previous.current) : next;
+      onChangeCb(nextValue);
+    } else transitionFn(() => {
+      setState(next);
+    });
+  });
+  return [value, setter];
+}
+const idFn = () => {};

package/dist/cjs/useControllableState.native.js

@@ -0,0 +1,78 @@
+"use strict";
+
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf,
+  __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+    for (var name in all) __defProp(target, name, {
+      get: all[name],
+      enumerable: !0
+    });
+  },
+  __copyProps = (to, from, except, desc) => {
+    if (from && typeof from == "object" || typeof from == "function") for (let key of __getOwnPropNames(from)) !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+    return to;
+  };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+    value: mod,
+    enumerable: !0
+  }) : target, mod)),
+  __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+    value: !0
+  }), mod);
+var useControllableState_exports = {};
+__export(useControllableState_exports, {
+  useControllableState: () => useControllableState
+});
+module.exports = __toCommonJS(useControllableState_exports);
+var import_use_event = require("@hanzogui/use-event"),
+  React = __toESM(require("react"), 1),
+  import_start_transition = require("@hanzogui/start-transition"),
+  emptyCallbackFn = function (_) {
+    return _();
+  };
+function useControllableState(param) {
+  var {
+      prop,
+      defaultProp,
+      onChange,
+      strategy = "prop-wins",
+      preventUpdate,
+      transition
+    } = param,
+    [state, setState] = React.useState(prop ?? defaultProp),
+    previous = React.useRef(state),
+    propWins = strategy === "prop-wins" && prop !== void 0,
+    value = propWins ? prop : state,
+    onChangeCb = (0, import_use_event.useEvent)(onChange || idFn),
+    transitionFn = transition ? import_start_transition.startTransition : emptyCallbackFn;
+  React.useEffect(function () {
+    prop !== void 0 && (previous.current = prop, transitionFn(function () {
+      setState(prop);
+    }));
+  }, [prop]), React.useEffect(function () {
+    propWins || state !== previous.current && (previous.current = state, onChangeCb(state));
+  }, [onChangeCb, state, propWins]);
+  var setter = (0, import_use_event.useEvent)(function (next) {
+    if (!preventUpdate) if (propWins) {
+      var nextValue = typeof next == "function" ? next(previous.current) : next;
+      onChangeCb(nextValue);
+    } else transitionFn(function () {
+      setState(next);
+    });
+  });
+  return [value, setter];
+}
+var idFn = function () {};
+//# sourceMappingURL=useControllableState.native.js.map

package/dist/cjs/useControllableState.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","useControllableState_exports","__export","useControllableState","module","exports","import_use_event","require","React","__toESM","import_start_transition","emptyCallbackFn","_","param","prop","defaultProp","onChange","strategy","preventUpdate","transition","state","setState","useState","previous","useRef","propWins","onChangeCb","useEvent","idFn","transitionFn","startTransition","useEffect","current","setter","next","nextValue"],"sources":["../../src/useControllableState.ts"],"sourcesContent":[null],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAA;EAAAA,YAAA,GAAAC,GAAA,IAAAC,WAAA,CAAAC,SAAA;IAAAC,KAAA;EAAA,IAAAH,GAAA;AAAA,IAAAI,4BAAA;AAAAC,QAAA,CAAAD,4BAAA;EAAAE,oBAAA,EAAAA,CAAA,KAAAA;AAAA;AAAAC,MAAA,CAAAC,OAAA,GAAAT,YAAyB,CAAAK,4BACzB;AAQA,IAAAK,gBAAM,GAAAC,OAAmB,CAAM,qBAAE;EAAAC,KAAA,GAAAC,OAAA,CAAAF,OAAA;EAAAG,uBAAA,GAAAH,OAAA;EAAAI,eAAA,YAAAA,CAAAC,CAAA;IAE1B,OAASA,CAAA;EAAwB;AACtC,SACAT,qBAAAU,KAAA;EACA;MAAAC,IAAA;MAAAC,WAAA;MAAAC,QAAA;MAAAC,QAAA;MAAAC,aAAA;MAAAC;IAAA,IAAAN,KAAA;IAAA,CAAAO,KAAA,EAAAC,QAAA,IAAAb,KAAA,CAAAc,QAAA,CAAAR,IAAA,IAAAC,WAAA;IAAAQ,QAAA,GAAAf,KAAA,CAAAgB,MAAA,CAAAJ,KAAA;IAAAK,QAAA,GAAAR,QAAA,oBAAAH,IAAA;IAAAd,KAAA,GAAAyB,QAAA,GAAAX,IAAA,GAAAM,KAAA;IAAAM,UAAA,OAAApB,gBAAA,CAAAqB,QAAA,EAAAX,QAAA,IAAAY,IAAA;IAAAC,YAAA,GAAAV,UAAA,GAAAT,uBAAA,CAAAoB,eAAA,GAAAnB,eAAA;EACAH,KAAA,CAAAuB,SAAW;IACXjB,IAAA,gBAAAS,QAAA,CAAAS,OAAA,GAAAlB,IAAA,EAAAe,YAAA;MACAR,QAAA,CAAAP,IAAA;IAQ+C;EAC/C,IAQAA,IAAM,CACJ,CAAI,EAAAN,KAAA,CAAAuB,SAAS,aACJ;IAEPN,QAAA,IAASL,KAAI,KAAAG,QAAA,CAAAS,OAAA,KAAAT,QAAA,CAAAS,OAAA,GAAAZ,KAAA,EAAAM,UAAA,CAAAN,KAAA;EAAA,GACd,CACHM,UAEA,EACMN,KAAA,EAKNK,QAAI,CAEJ;EACE,IAAAQ,MAAI,OAAA3B,gBAAA,CAAAqB,QAAA,YAAAO,IAAA;IACJ,KAAAhB,aAAc,EACZ,IAAAO,QAAM;MACN,IAAAU,SAAW,UAASD,IAAA,iBAAAA,IAAA,CAAAX,QAAA,CAAAS,OAAA,IAAAE,IAAA;MACtBR,UAAA,CAAAS,SAAA;IACE,OACEN,YAAS,aAAI;MACdR,QAAA,CAAAa,IAAA;IAEJ;EAED;EACF,QAEAlC,KAAM,EAAciC,MAAA,C","ignoreList":[]}

package/dist/esm/index.js

@@ -0,0 +1,2 @@
+export * from "./useControllableState.mjs";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA,cAAc","ignoreList":[]}

package/dist/esm/index.mjs

@@ -0,0 +1,2 @@
+export * from "./useControllableState.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA,cAAc","ignoreList":[]}

package/dist/esm/index.native.js

@@ -0,0 +1,2 @@
+export * from "./useControllableState.native.js";
+//# sourceMappingURL=index.native.js.map

package/dist/esm/index.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA,cAAc","ignoreList":[]}

package/dist/esm/useControllableState.mjs

@@ -0,0 +1,38 @@
+import { useEvent } from "@hanzogui/use-event";
+import * as React from "react";
+import { startTransition } from "@hanzogui/start-transition";
+const emptyCallbackFn = _ => _();
+function useControllableState({
+  prop,
+  defaultProp,
+  onChange,
+  strategy = "prop-wins",
+  preventUpdate,
+  transition
+}) {
+  const [state, setState] = React.useState(prop ?? defaultProp),
+    previous = React.useRef(state),
+    propWins = strategy === "prop-wins" && prop !== void 0,
+    value = propWins ? prop : state,
+    onChangeCb = useEvent(onChange || idFn),
+    transitionFn = transition ? startTransition : emptyCallbackFn;
+  React.useEffect(() => {
+    prop !== void 0 && (previous.current = prop, transitionFn(() => {
+      setState(prop);
+    }));
+  }, [prop]), React.useEffect(() => {
+    propWins || state !== previous.current && (previous.current = state, onChangeCb(state));
+  }, [onChangeCb, state, propWins]);
+  const setter = useEvent(next => {
+    if (!preventUpdate) if (propWins) {
+      const nextValue = typeof next == "function" ? next(previous.current) : next;
+      onChangeCb(nextValue);
+    } else transitionFn(() => {
+      setState(next);
+    });
+  });
+  return [value, setter];
+}
+const idFn = () => {};
+export { useControllableState };
+//# sourceMappingURL=useControllableState.mjs.map

package/dist/esm/useControllableState.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEvent","React","startTransition","emptyCallbackFn","_","useControllableState","prop","defaultProp","onChange","strategy","preventUpdate","transition","state","setState","useState","previous","useRef","propWins","value","onChangeCb","idFn","transitionFn","useEffect","current","setter","next","nextValue"],"sources":["../../src/useControllableState.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,QAAA,QAAgB;AACzB,YAAYC,KAAA,MAAW;AACvB,SAASC,eAAA,QAAuB;AAOhC,MAAMC,eAAA,GAAmBC,CAAA,IAAMA,CAAA,CAAE;AAE1B,SAASC,qBAAwB;EACtCC,IAAA;EACAC,WAAA;EACAC,QAAA;EACAC,QAAA,GAAW;EACXC,aAAA;EACAC;AACF,GAOiD;EAC/C,MAAM,CAACC,KAAA,EAAOC,QAAQ,IAAIZ,KAAA,CAAMa,QAAA,CAASR,IAAA,IAAQC,WAAW;IACtDQ,QAAA,GAAWd,KAAA,CAAMe,MAAA,CAAYJ,KAAK;IAClCK,QAAA,GAAWR,QAAA,KAAa,eAAeH,IAAA,KAAS;IAChDY,KAAA,GAAQD,QAAA,GAAWX,IAAA,GAAOM,KAAA;IAC1BO,UAAA,GAAanB,QAAA,CAASQ,QAAA,IAAYY,IAAI;IAEtCC,YAAA,GAAeV,UAAA,GAAaT,eAAA,GAAkBC,eAAA;EAEpDF,KAAA,CAAMqB,SAAA,CAAU,MAAM;IAChBhB,IAAA,KAAS,WACbS,QAAA,CAASQ,OAAA,GAAUjB,IAAA,EACnBe,YAAA,CAAa,MAAM;MACjBR,QAAA,CAASP,IAAI;IACf,CAAC;EACH,GAAG,CAACA,IAAI,CAAC,GAETL,KAAA,CAAMqB,SAAA,CAAU,MAAM;IAChBL,QAAA,IACAL,KAAA,KAAUG,QAAA,CAASQ,OAAA,KACrBR,QAAA,CAASQ,OAAA,GAAUX,KAAA,EACnBO,UAAA,CAAWP,KAAK;EAEpB,GAAG,CAACO,UAAA,EAAYP,KAAA,EAAOK,QAAQ,CAAC;EAEhC,MAAMO,MAAA,GAASxB,QAAA,CAAUyB,IAAA,IAAS;IAChC,IAAI,CAAAf,aAAA,EACJ,IAAIO,QAAA,EAAU;MACZ,MAAMS,SAAA,GAAY,OAAOD,IAAA,IAAS,aAAaA,IAAA,CAAKV,QAAA,CAASQ,OAAO,IAAIE,IAAA;MACxEN,UAAA,CAAWO,SAAS;IACtB,OACEL,YAAA,CAAa,MAAM;MACjBR,QAAA,CAASY,IAAI;IACf,CAAC;EAEL,CAAC;EAED,OAAO,CAACP,KAAA,EAAYM,MAAM;AAC5B;AAEA,MAAMJ,IAAA,GAAOA,CAAA,KAAM,CAAC","ignoreList":[]}

package/dist/esm/useControllableState.native.js

@@ -0,0 +1,41 @@
+import { useEvent } from "@hanzogui/use-event";
+import * as React from "react";
+import { startTransition } from "@hanzogui/start-transition";
+var emptyCallbackFn = function (_) {
+  return _();
+};
+function useControllableState(param) {
+  var {
+      prop,
+      defaultProp,
+      onChange,
+      strategy = "prop-wins",
+      preventUpdate,
+      transition
+    } = param,
+    [state, setState] = React.useState(prop ?? defaultProp),
+    previous = React.useRef(state),
+    propWins = strategy === "prop-wins" && prop !== void 0,
+    value = propWins ? prop : state,
+    onChangeCb = useEvent(onChange || idFn),
+    transitionFn = transition ? startTransition : emptyCallbackFn;
+  React.useEffect(function () {
+    prop !== void 0 && (previous.current = prop, transitionFn(function () {
+      setState(prop);
+    }));
+  }, [prop]), React.useEffect(function () {
+    propWins || state !== previous.current && (previous.current = state, onChangeCb(state));
+  }, [onChangeCb, state, propWins]);
+  var setter = useEvent(function (next) {
+    if (!preventUpdate) if (propWins) {
+      var nextValue = typeof next == "function" ? next(previous.current) : next;
+      onChangeCb(nextValue);
+    } else transitionFn(function () {
+      setState(next);
+    });
+  });
+  return [value, setter];
+}
+var idFn = function () {};
+export { useControllableState };
+//# sourceMappingURL=useControllableState.native.js.map

package/dist/esm/useControllableState.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEvent","React","startTransition","emptyCallbackFn","_","useControllableState","param","prop","defaultProp","onChange","strategy","preventUpdate","transition","state","setState","useState","previous","useRef","propWins","value","onChangeCb","idFn","transitionFn","useEffect","current","setter","next","nextValue"],"sources":["../../src/useControllableState.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,QAAA,QAAgB;AACzB,YAAYC,KAAA,MAAW;AACvB,SAASC,eAAA,QAAuB;AAOhC,IAAAC,eAAM,YAAAA,CAAyBC,CAAA,EAAE;EAE1B,OAASA,CAAA;AAAwB;AACtC,SACAC,qBAAAC,KAAA;EACA;MAAAC,IAAA;MAAAC,WAAA;MAAAC,QAAA;MAAAC,QAAA;MAAAC,aAAA;MAAAC;IAAA,IAAAN,KAAA;IAAA,CAAAO,KAAA,EAAAC,QAAA,IAAAb,KAAA,CAAAc,QAAA,CAAAR,IAAA,IAAAC,WAAA;IAAAQ,QAAA,GAAAf,KAAA,CAAAgB,MAAA,CAAAJ,KAAA;IAAAK,QAAA,GAAAR,QAAA,oBAAAH,IAAA;IAAAY,KAAA,GAAAD,QAAA,GAAAX,IAAA,GAAAM,KAAA;IAAAO,UAAA,GAAApB,QAAA,CAAAS,QAAA,IAAAY,IAAA;IAAAC,YAAA,GAAAV,UAAA,GAAAV,eAAA,GAAAC,eAAA;EACAF,KAAA,CAAAsB,SAAW;IACXhB,IAAA,gBAAAS,QAAA,CAAAQ,OAAA,GAAAjB,IAAA,EAAAe,YAAA;MACAR,QAAA,CAAAP,IAAA;IAQ+C;EAC/C,IAQAA,IAAM,CACJ,CAAI,EAAAN,KAAA,CAAAsB,SAAS,aACJ;IAEPL,QAAA,IAASL,KAAI,KAAAG,QAAA,CAAAQ,OAAA,KAAAR,QAAA,CAAAQ,OAAA,GAAAX,KAAA,EAAAO,UAAA,CAAAP,KAAA;EAAA,GACd,CACHO,UAEA,EACMP,KAAA,EAKNK,QAAI,CAEJ;EACE,IAAAO,MAAI,GAAAzB,QAAA,WAAA0B,IAAA;IACJ,KAAAf,aAAc,EACZ,IAAAO,QAAM;MACN,IAAAS,SAAW,UAASD,IAAA,iBAAAA,IAAA,CAAAV,QAAA,CAAAQ,OAAA,IAAAE,IAAA;MACtBN,UAAA,CAAAO,SAAA;IACE,OACEL,YAAS,aAAI;MACdR,QAAA,CAAAY,IAAA;IAEJ;EAED;EACF,QAEAP,KAAM,EAAcM,MAAA,C","ignoreList":[]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@hanzogui/use-controllable-state",
+  "version": "2.0.0",
+  "gitHead": "a49cc7ea6b93ba384e77a4880ae48ac4a5635c14",
+  "source": "src/index.ts",
+  "files": [
+    "src",
+    "types",
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "dist/cjs",
+  "module": "dist/esm",
+  "types": "./types/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./types/index.d.ts",
+      "react-native": "./dist/esm/index.native.js",
+      "browser": "./dist/esm/index.mjs",
+      "module": "./dist/esm/index.mjs",
+      "import": "./dist/esm/index.mjs",
+      "require": "./dist/cjs/index.cjs",
+      "default": "./dist/esm/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "hanzo-gui-build",
+    "watch": "hanzo-gui-build --watch",
+    "clean": "hanzo-gui-build clean",
+    "clean:build": "hanzo-gui-build clean:build"
+  },
+  "dependencies": {
+    "@hanzogui/start-transition": "workspace:*",
+    "@hanzogui/use-event": "workspace:*"
+  },
+  "devDependencies": {
+    "@hanzogui/build": "workspace:*",
+    "react": ">=19"
+  },
+  "peerDependencies": {
+    "react": ">=19"
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from './useControllableState'

package/src/useControllableState.ts

@@ -0,0 +1,66 @@
+import { useEvent } from '@hanzogui/use-event'
+import * as React from 'react'
+import { startTransition } from '@hanzogui/start-transition'
+
+// can configure to allow most-recent-wins or prop-wins
+// defaults to prop-wins
+
+type ChangeCb<T> = (next: T) => void
+
+const emptyCallbackFn = (_) => _()
+
+export function useControllableState<T>({
+  prop,
+  defaultProp,
+  onChange,
+  strategy = 'prop-wins',
+  preventUpdate,
+  transition,
+}: {
+  prop?: T | undefined
+  defaultProp: T
+  onChange?: ChangeCb<T>
+  strategy?: 'prop-wins' | 'most-recent-wins'
+  preventUpdate?: boolean
+  transition?: boolean
+}): [T, React.Dispatch<React.SetStateAction<T>>] {
+  const [state, setState] = React.useState(prop ?? defaultProp)
+  const previous = React.useRef<any>(state)
+  const propWins = strategy === 'prop-wins' && prop !== undefined
+  const value = propWins ? prop : state
+  const onChangeCb = useEvent(onChange || idFn)
+
+  const transitionFn = transition ? startTransition : emptyCallbackFn
+
+  React.useEffect(() => {
+    if (prop === undefined) return
+    previous.current = prop
+    transitionFn(() => {
+      setState(prop)
+    })
+  }, [prop])
+
+  React.useEffect(() => {
+    if (propWins) return
+    if (state !== previous.current) {
+      previous.current = state
+      onChangeCb(state)
+    }
+  }, [onChangeCb, state, propWins])
+
+  const setter = useEvent((next) => {
+    if (preventUpdate) return
+    if (propWins) {
+      const nextValue = typeof next === 'function' ? next(previous.current) : next
+      onChangeCb(nextValue)
+    } else {
+      transitionFn(() => {
+        setState(next)
+      })
+    }
+  })
+
+  return [value as T, setter]
+}
+
+const idFn = () => {}

package/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from './useControllableState';
+//# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA"}

package/types/useControllableState.d.ts

@@ -0,0 +1,12 @@
+import * as React from 'react';
+type ChangeCb<T> = (next: T) => void;
+export declare function useControllableState<T>({ prop, defaultProp, onChange, strategy, preventUpdate, transition, }: {
+    prop?: T | undefined;
+    defaultProp: T;
+    onChange?: ChangeCb<T>;
+    strategy?: 'prop-wins' | 'most-recent-wins';
+    preventUpdate?: boolean;
+    transition?: boolean;
+}): [T, React.Dispatch<React.SetStateAction<T>>];
+export {};
+//# sourceMappingURL=useControllableState.d.ts.map

package/types/useControllableState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useControllableState.d.ts","sourceRoot":"","sources":["../src/useControllableState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAM9B,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAA;AAIpC,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,EACtC,IAAI,EACJ,WAAW,EACX,QAAQ,EACR,QAAsB,EACtB,aAAa,EACb,UAAU,GACX,EAAE;IACD,IAAI,CAAC,EAAE,CAAC,GAAG,SAAS,CAAA;IACpB,WAAW,EAAE,CAAC,CAAA;IACd,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;IACtB,QAAQ,CAAC,EAAE,WAAW,GAAG,kBAAkB,CAAA;IAC3C,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAsC/C"}