@conorroberts/utils 0.0.111 → 0.0.116

package/dist/react.mjs

@@ -1,5 +1,4 @@
 import { useCallback, useEffect, useRef } from "react";
-
 //#region src/react/useStableCallback.ts
 /**
 * Creates a stable callback that always calls the latest version of the function.
@@ -13,7 +12,6 @@ const useStableCallback = (callback) => {
 		return callbackRef.current(...args);
 	}, []);
 };
-
 //#endregion
 //#region src/react/useOnce.ts
 /**
@@ -41,7 +39,6 @@ const useOnce = (condition, callback) => {
 		}
 	}, [condition, stableCallback]);
 };
-
 //#endregion
 //#region src/react/useLocalOnce.ts
 /**
@@ -70,7 +67,6 @@ const useLocalOnce = (condition, callback) => {
 		stableCallback();
 	}
 };
-
 //#endregion
 //#region src/react/useOnMount.ts
 /**
@@ -121,7 +117,6 @@ const useAsyncOnMount = (callback) => {
 		}
 	}, [stableCallback]);
 };
-
 //#endregion
 //#region src/react/useOnUnmount.ts
 /**
@@ -136,7 +131,7 @@ const useOnUnmount = (callback) => {
 		};
 	}, [stableCallback]);
 };
-
 //#endregion
 export { useAsyncOnMount, useLocalOnce, useOnMount, useOnUnmount, useOnce, useStableCallback };
+
 //# sourceMappingURL=react.mjs.map

package/dist/react.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"react.mjs","names":[],"sources":["../src/react/useStableCallback.ts","../src/react/useOnce.ts","../src/react/useLocalOnce.ts","../src/react/useOnMount.ts","../src/react/useOnUnmount.ts"],"sourcesContent":["// oxlint-disable no-explicit-any\n\nimport { useCallback, useRef } from \"react\";\n\ntype AnyFunction = (...args: any[]) => any;\ntype AnyArgs = any[];\n\n/**\n * Creates a stable callback that always calls the latest version of the function.\n * Useful for callbacks that need to be used in dependency arrays but should always\n * execute the most recent version of the callback.\n */\nexport const useStableCallback = <T extends AnyFunction>(callback: T): T => {\n  const callbackRef = useRef(callback);\n\n  // Update the ref on every render\n  callbackRef.current = callback;\n\n  return useCallback((...args: AnyArgs) => {\n    return callbackRef.current(...args);\n  }, []) as T;\n};\n","import { useEffect, useRef } from \"react\";\nimport { useStableCallback } from \"./useStableCallback\";\n\n/**\n * Runs a callback only once when a condition becomes truthy.\n * The callback is stabilized internally to always reference the latest version.\n *\n * @param condition - When truthy (evaluated via Boolean()), the callback will be executed (only once).\n * @param callback - The function to run once when the condition is met.\n *\n * @example\n * ```tsx\n * const isReady = true;\n * useOnce(isReady, () => {\n *   console.log(\"Ready!\");\n * });\n * ```\n */\nexport const useOnce = (condition: unknown, callback: () => void): void => {\n  const hasRunRef = useRef(false);\n  const stableCallback = useStableCallback(callback);\n\n  useEffect(() => {\n    if (Boolean(condition) && !hasRunRef.current) {\n      hasRunRef.current = true;\n      stableCallback();\n    }\n  }, [condition, stableCallback]);\n};\n","import { useRef } from \"react\";\nimport { useStableCallback } from \"./useStableCallback\";\n\n/**\n * Runs a callback only once when a condition becomes truthy, executing synchronously\n * during render. The callback is stabilized internally to always reference the latest version.\n *\n * Unlike `useOnce`, this runs at the top level of the hook (not in useEffect),\n * making it suitable for state updates that need to happen synchronously during render.\n *\n * @param condition - When truthy (evaluated via Boolean()), the callback will be executed (only once).\n * @param callback - The function to run once when the condition is met.\n *\n * @example\n * ```tsx\n * const user: User | null = getUser();\n * useLocalOnce(user, () => {\n *   setState(user.name);\n * });\n * ```\n */\nexport const useLocalOnce = (condition: unknown, callback: () => void): void => {\n  const hasRunRef = useRef(false);\n  const stableCallback = useStableCallback(callback);\n\n  if (Boolean(condition) && !hasRunRef.current) {\n    hasRunRef.current = true;\n    stableCallback();\n  }\n};\n","import { useEffect, useRef } from \"react\";\nimport { useStableCallback } from \"./useStableCallback\";\n\n/**\n * Calls the given callback when the component mounts.\n * Uses useStableCallback internally to ensure the latest version is called.\n *\n * @param callback - The function to run when the component mounts.\n *\n * @example\n * ```tsx\n * useOnMount(() => {\n *   console.log(\"Component mounted!\");\n * });\n * ```\n */\nexport const useOnMount = (callback: React.EffectCallback): void => {\n  const stableCallback = useStableCallback(callback);\n  const isRun = useRef(false);\n\n  useEffect(() => {\n    if (!isRun.current) {\n      isRun.current = true;\n      return stableCallback();\n    }\n  }, [stableCallback]);\n};\n\n/**\n * Calls the given async callback when the component mounts.\n * Uses useStableCallback internally to ensure the latest version is called.\n * Unlike useOnMount, this does not support cleanup functions.\n *\n * @param callback - The async function to run when the component mounts.\n *\n * @example\n * ```tsx\n * useAsyncOnMount(async () => {\n *   const data = await fetchData();\n *   console.log(\"Data loaded:\", data);\n * });\n * ```\n */\nexport const useAsyncOnMount = (callback: () => Promise<void>): void => {\n  const stableCallback = useStableCallback(callback);\n  const isRun = useRef(false);\n\n  useEffect(() => {\n    if (!isRun.current) {\n      isRun.current = true;\n      stableCallback();\n    }\n  }, [stableCallback]);\n};\n","import { useEffect } from \"react\";\nimport { useStableCallback } from \"./useStableCallback\";\n\n/**\n * Calls the given callback when the component unmounts.\n * Uses useStableCallback internally to ensure the latest version is called.\n */\nexport const useOnUnmount = (callback: () => void): void => {\n  const stableCallback = useStableCallback(callback);\n\n  useEffect(() => {\n    return () => {\n      stableCallback();\n    };\n  }, [stableCallback]);\n};\n"],"mappings":";;;;;;;;AAYA,MAAa,qBAA4C,aAAmB;CAC1E,MAAM,cAAc,OAAO,SAAS;AAGpC,aAAY,UAAU;AAEtB,QAAO,aAAa,GAAG,SAAkB;AACvC,SAAO,YAAY,QAAQ,GAAG,KAAK;IAClC,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;ACFR,MAAa,WAAW,WAAoB,aAA+B;CACzE,MAAM,YAAY,OAAO,MAAM;CAC/B,MAAM,iBAAiB,kBAAkB,SAAS;AAElD,iBAAgB;AACd,MAAI,QAAQ,UAAU,IAAI,CAAC,UAAU,SAAS;AAC5C,aAAU,UAAU;AACpB,mBAAgB;;IAEjB,CAAC,WAAW,eAAe,CAAC;;;;;;;;;;;;;;;;;;;;;;;ACNjC,MAAa,gBAAgB,WAAoB,aAA+B;CAC9E,MAAM,YAAY,OAAO,MAAM;CAC/B,MAAM,iBAAiB,kBAAkB,SAAS;AAElD,KAAI,QAAQ,UAAU,IAAI,CAAC,UAAU,SAAS;AAC5C,YAAU,UAAU;AACpB,kBAAgB;;;;;;;;;;;;;;;;;;;ACXpB,MAAa,cAAc,aAAyC;CAClE,MAAM,iBAAiB,kBAAkB,SAAS;CAClD,MAAM,QAAQ,OAAO,MAAM;AAE3B,iBAAgB;AACd,MAAI,CAAC,MAAM,SAAS;AAClB,SAAM,UAAU;AAChB,UAAO,gBAAgB;;IAExB,CAAC,eAAe,CAAC;;;;;;;;;;;;;;;;;AAkBtB,MAAa,mBAAmB,aAAwC;CACtE,MAAM,iBAAiB,kBAAkB,SAAS;CAClD,MAAM,QAAQ,OAAO,MAAM;AAE3B,iBAAgB;AACd,MAAI,CAAC,MAAM,SAAS;AAClB,SAAM,UAAU;AAChB,mBAAgB;;IAEjB,CAAC,eAAe,CAAC;;;;;;;;;AC7CtB,MAAa,gBAAgB,aAA+B;CAC1D,MAAM,iBAAiB,kBAAkB,SAAS;AAElD,iBAAgB;AACd,eAAa;AACX,mBAAgB;;IAEjB,CAAC,eAAe,CAAC"}
+{"version":3,"file":"react.mjs","names":[],"sources":["../src/react/useStableCallback.ts","../src/react/useOnce.ts","../src/react/useLocalOnce.ts","../src/react/useOnMount.ts","../src/react/useOnUnmount.ts"],"sourcesContent":["// oxlint-disable no-explicit-any\n\nimport { useCallback, useRef } from \"react\";\n\ntype AnyFunction = (...args: any[]) => any;\ntype AnyArgs = any[];\n\n/**\n * Creates a stable callback that always calls the latest version of the function.\n * Useful for callbacks that need to be used in dependency arrays but should always\n * execute the most recent version of the callback.\n */\nexport const useStableCallback = <T extends AnyFunction>(callback: T): T => {\n  const callbackRef = useRef(callback);\n\n  // Update the ref on every render\n  callbackRef.current = callback;\n\n  return useCallback((...args: AnyArgs) => {\n    return callbackRef.current(...args);\n  }, []) as T;\n};\n","import { useEffect, useRef } from \"react\";\nimport { useStableCallback } from \"./useStableCallback\";\n\n/**\n * Runs a callback only once when a condition becomes truthy.\n * The callback is stabilized internally to always reference the latest version.\n *\n * @param condition - When truthy (evaluated via Boolean()), the callback will be executed (only once).\n * @param callback - The function to run once when the condition is met.\n *\n * @example\n * ```tsx\n * const isReady = true;\n * useOnce(isReady, () => {\n *   console.log(\"Ready!\");\n * });\n * ```\n */\nexport const useOnce = (condition: unknown, callback: () => void): void => {\n  const hasRunRef = useRef(false);\n  const stableCallback = useStableCallback(callback);\n\n  useEffect(() => {\n    if (Boolean(condition) && !hasRunRef.current) {\n      hasRunRef.current = true;\n      stableCallback();\n    }\n  }, [condition, stableCallback]);\n};\n","import { useRef } from \"react\";\nimport { useStableCallback } from \"./useStableCallback\";\n\n/**\n * Runs a callback only once when a condition becomes truthy, executing synchronously\n * during render. The callback is stabilized internally to always reference the latest version.\n *\n * Unlike `useOnce`, this runs at the top level of the hook (not in useEffect),\n * making it suitable for state updates that need to happen synchronously during render.\n *\n * @param condition - When truthy (evaluated via Boolean()), the callback will be executed (only once).\n * @param callback - The function to run once when the condition is met.\n *\n * @example\n * ```tsx\n * const user: User | null = getUser();\n * useLocalOnce(user, () => {\n *   setState(user.name);\n * });\n * ```\n */\nexport const useLocalOnce = (condition: unknown, callback: () => void): void => {\n  const hasRunRef = useRef(false);\n  const stableCallback = useStableCallback(callback);\n\n  if (Boolean(condition) && !hasRunRef.current) {\n    hasRunRef.current = true;\n    stableCallback();\n  }\n};\n","import { useEffect, useRef } from \"react\";\nimport { useStableCallback } from \"./useStableCallback\";\n\n/**\n * Calls the given callback when the component mounts.\n * Uses useStableCallback internally to ensure the latest version is called.\n *\n * @param callback - The function to run when the component mounts.\n *\n * @example\n * ```tsx\n * useOnMount(() => {\n *   console.log(\"Component mounted!\");\n * });\n * ```\n */\nexport const useOnMount = (callback: React.EffectCallback): void => {\n  const stableCallback = useStableCallback(callback);\n  const isRun = useRef(false);\n\n  useEffect(() => {\n    if (!isRun.current) {\n      isRun.current = true;\n      return stableCallback();\n    }\n  }, [stableCallback]);\n};\n\n/**\n * Calls the given async callback when the component mounts.\n * Uses useStableCallback internally to ensure the latest version is called.\n * Unlike useOnMount, this does not support cleanup functions.\n *\n * @param callback - The async function to run when the component mounts.\n *\n * @example\n * ```tsx\n * useAsyncOnMount(async () => {\n *   const data = await fetchData();\n *   console.log(\"Data loaded:\", data);\n * });\n * ```\n */\nexport const useAsyncOnMount = (callback: () => Promise<void>): void => {\n  const stableCallback = useStableCallback(callback);\n  const isRun = useRef(false);\n\n  useEffect(() => {\n    if (!isRun.current) {\n      isRun.current = true;\n      stableCallback();\n    }\n  }, [stableCallback]);\n};\n","import { useEffect } from \"react\";\nimport { useStableCallback } from \"./useStableCallback\";\n\n/**\n * Calls the given callback when the component unmounts.\n * Uses useStableCallback internally to ensure the latest version is called.\n */\nexport const useOnUnmount = (callback: () => void): void => {\n  const stableCallback = useStableCallback(callback);\n\n  useEffect(() => {\n    return () => {\n      stableCallback();\n    };\n  }, [stableCallback]);\n};\n"],"mappings":";;;;;;;AAYA,MAAa,qBAA4C,aAAmB;CAC1E,MAAM,cAAc,OAAO,SAAS;AAGpC,aAAY,UAAU;AAEtB,QAAO,aAAa,GAAG,SAAkB;AACvC,SAAO,YAAY,QAAQ,GAAG,KAAK;IAClC,EAAE,CAAC;;;;;;;;;;;;;;;;;;;ACFR,MAAa,WAAW,WAAoB,aAA+B;CACzE,MAAM,YAAY,OAAO,MAAM;CAC/B,MAAM,iBAAiB,kBAAkB,SAAS;AAElD,iBAAgB;AACd,MAAI,QAAQ,UAAU,IAAI,CAAC,UAAU,SAAS;AAC5C,aAAU,UAAU;AACpB,mBAAgB;;IAEjB,CAAC,WAAW,eAAe,CAAC;;;;;;;;;;;;;;;;;;;;;;ACNjC,MAAa,gBAAgB,WAAoB,aAA+B;CAC9E,MAAM,YAAY,OAAO,MAAM;CAC/B,MAAM,iBAAiB,kBAAkB,SAAS;AAElD,KAAI,QAAQ,UAAU,IAAI,CAAC,UAAU,SAAS;AAC5C,YAAU,UAAU;AACpB,kBAAgB;;;;;;;;;;;;;;;;;;ACXpB,MAAa,cAAc,aAAyC;CAClE,MAAM,iBAAiB,kBAAkB,SAAS;CAClD,MAAM,QAAQ,OAAO,MAAM;AAE3B,iBAAgB;AACd,MAAI,CAAC,MAAM,SAAS;AAClB,SAAM,UAAU;AAChB,UAAO,gBAAgB;;IAExB,CAAC,eAAe,CAAC;;;;;;;;;;;;;;;;;AAkBtB,MAAa,mBAAmB,aAAwC;CACtE,MAAM,iBAAiB,kBAAkB,SAAS;CAClD,MAAM,QAAQ,OAAO,MAAM;AAE3B,iBAAgB;AACd,MAAI,CAAC,MAAM,SAAS;AAClB,SAAM,UAAU;AAChB,mBAAgB;;IAEjB,CAAC,eAAe,CAAC;;;;;;;;AC7CtB,MAAa,gBAAgB,aAA+B;CAC1D,MAAM,iBAAiB,kBAAkB,SAAS;AAElD,iBAAgB;AACd,eAAa;AACX,mBAAgB;;IAEjB,CAAC,eAAe,CAAC"}

package/dist/vscode/settings.json

@@ -0,0 +1,47 @@
+{
+  "files.watcherExclude": {
+    "**/routeTree.gen.ts": true,
+    "packages/*/dist": true,
+    "packages/*/.react-router": true,
+    "packages/*/.turbo": true
+  },
+  "search.exclude": {
+    "**/routeTree.gen.ts": true,
+    "packages/*/dist": true,
+    "packages/*/.react-router": true,
+    "packages/*/.turbo": true
+  },
+  "files.readonlyInclude": {
+    "**/routeTree.gen.ts": true,
+    "packages/*/dist": true,
+    "packages/*/.react-router": true,
+    "packages/*/.turbo": true
+  },
+  "oxc.lint.run": "onType",
+  "oxc.typeAware": true,
+  "oxc.fixKind": "safe_fix_or_suggestion",
+  "editor.codeActionsOnSave": {
+    "source.organizeImports": "always",
+    "source.fixAll.oxc": "always"
+  },
+  "editor.defaultFormatter": "oxc.oxc-vscode",
+  "editor.formatOnSave": true,
+  "[typescript]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[javascript]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[javascriptreact]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@conorroberts/utils",
-  "version": "0.0.111",
+  "version": "0.0.116",
   "private": false,
   "description": "",
   "license": "ISC",
@@ -27,6 +27,9 @@
     "./oxfmt/config": {
       "default": "./dist/oxfmt/config.json"
     },
+    "./vscode/settings": {
+      "default": "./dist/vscode/settings.json"
+    },
     "./oxlint": {
       "types": "./dist/oxlint/index.d.mts",
       "default": "./dist/oxlint/index.mjs"
@@ -41,29 +44,32 @@
     }
   },
   "dependencies": {
+    "@oxlint/plugins": "1.58.0",
     "dayjs": "1.11.19",
     "nanoid": "5.1.6",
     "ofetch": "1.5.1",
-    "oxlint": "1.43.0",
-    "remeda": "2.32.0",
-    "valibot": "1.1.0"
+    "remeda": "2.32.0"
   },
   "devDependencies": {
     "@testing-library/react": "16.3.0",
     "@types/node": "25.0.1",
     "@types/react": "19.2.7",
     "jsdom": "27.4.0",
-    "oxfmt": "0.28.0",
+    "oxfmt": "0.43.0",
+    "oxlint": "1.58.0",
     "react": "19.2.3",
-    "tsdown": "0.18.2",
-    "typescript": "5.9.3",
+    "tsdown": "0.21.7",
+    "typescript": "6.0.2",
+    "valibot": "1.1.0",
     "vitest": "4.0.15"
   },
   "peerDependencies": {
     "consola": ">=3.0.0",
     "drizzle-orm": ">=0.44.0",
+    "oxlint": ">=1.58.0",
     "react": ">=18.0.0",
-    "react-dom": ">=18.0.0"
+    "react-dom": ">=18.0.0",
+    "valibot": ">=1.3.1"
   },
   "scripts": {
     "dev": "tsdown --watch",