@conorroberts/utils 0.0.44 → 0.0.46

package/dist/env.mjs

@@ -13,7 +13,7 @@ const createEnv = (args) => {
 	const serverEnv = /* @__PURE__ */ new Map();
 	const invalidKeys = [];
 	for (const [key, value] of pairs) {
-		const result = v.safeParse(value, args.env[key] ?? null);
+		const result = v.safeParse(value, args.env[key]);
 		if (!result.success) invalidKeys.push(key);
 		serverEnv.set(key, result.output);
 	}

package/dist/env.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"env.mjs","names":["invalidKeys: string[]","pairs"],"sources":["../src/env.ts"],"sourcesContent":["import { pipe } from \"remeda\";\nimport * as v from \"valibot\";\n\nconst PUBLIC_ENV_PREFIX = \"PUBLIC_\" as const;\n\n/**\n * Validates your environment variables against the given Valibot schema;\n * @param args\n * @returns An object containing client environment variables and another containing server environment variables\n */\nexport const createEnv = <\n  Schema extends Record<string, v.GenericSchema>,\n  Env = {\n    [K in keyof Schema]: v.InferOutput<Schema[K]>;\n  },\n>(args: {\n  schema: Schema;\n  // oxlint-disable-next-line no-explicit-any\n  env: any;\n}) => {\n  const pairs = Object.entries(args.schema);\n  const serverEnv = new Map();\n  const invalidKeys: string[] = [];\n\n  for (const [key, value] of pairs) {\n    const result = v.safeParse(value, args.env[key] ?? null);\n\n    if (!result.success) {\n      invalidKeys.push(key);\n    }\n\n    serverEnv.set(key, result.output);\n  }\n\n  if (invalidKeys.length > 0) {\n    console.error(`Invalid environment variable(s): ${invalidKeys.map((e) => `\"${e}\"`).join(\", \")}`);\n    process.exit(1);\n  }\n\n  type ClientEnvKeys = Exclude<\n    {\n      [K in keyof Env]: K extends `${typeof PUBLIC_ENV_PREFIX}${string}` ? K : never;\n    }[keyof Env],\n    undefined\n  >;\n\n  type ClientEnv = {\n    [B in ClientEnvKeys]: Env[B];\n  };\n\n  const clientEnv = pipe(\n    serverEnv,\n    (obj) => Array.from(obj.entries()),\n    (pairs) => pairs.filter(([k]) => k.startsWith(PUBLIC_ENV_PREFIX)),\n    (pairs) => Object.fromEntries(pairs),\n  ) as ClientEnv;\n\n  return {\n    client: clientEnv,\n    server: Object.fromEntries(serverEnv.entries()) as Env,\n  };\n};\n"],"mappings":";;;;AAGA,MAAM,oBAAoB;;;;;;AAO1B,MAAa,aAKX,SAII;CACJ,MAAM,QAAQ,OAAO,QAAQ,KAAK,OAAO;CACzC,MAAM,4BAAY,IAAI,KAAK;CAC3B,MAAMA,cAAwB,EAAE;AAEhC,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO;EAChC,MAAM,SAAS,EAAE,UAAU,OAAO,KAAK,IAAI,QAAQ,KAAK;AAExD,MAAI,CAAC,OAAO,QACV,aAAY,KAAK,IAAI;AAGvB,YAAU,IAAI,KAAK,OAAO,OAAO;;AAGnC,KAAI,YAAY,SAAS,GAAG;AAC1B,UAAQ,MAAM,oCAAoC,YAAY,KAAK,MAAM,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,GAAG;AAChG,UAAQ,KAAK,EAAE;;AAqBjB,QAAO;EACL,QARgB,KAChB,YACC,QAAQ,MAAM,KAAK,IAAI,SAAS,CAAC,GACjC,YAAUC,QAAM,QAAQ,CAAC,OAAO,EAAE,WAAW,kBAAkB,CAAC,GAChE,YAAU,OAAO,YAAYA,QAAM,CACrC;EAIC,QAAQ,OAAO,YAAY,UAAU,SAAS,CAAC;EAChD"}
+{"version":3,"file":"env.mjs","names":["invalidKeys: string[]","pairs"],"sources":["../src/env.ts"],"sourcesContent":["import { pipe } from \"remeda\";\nimport * as v from \"valibot\";\n\nconst PUBLIC_ENV_PREFIX = \"PUBLIC_\" as const;\n\n/**\n * Validates your environment variables against the given Valibot schema;\n * @param args\n * @returns An object containing client environment variables and another containing server environment variables\n */\nexport const createEnv = <\n  Schema extends Record<string, v.GenericSchema>,\n  Env = {\n    [K in keyof Schema]: v.InferOutput<Schema[K]>;\n  },\n>(args: {\n  schema: Schema;\n  // oxlint-disable-next-line no-explicit-any\n  env: any;\n}) => {\n  const pairs = Object.entries(args.schema);\n  const serverEnv = new Map();\n  const invalidKeys: string[] = [];\n\n  for (const [key, value] of pairs) {\n    const result = v.safeParse(value, args.env[key]);\n\n    if (!result.success) {\n      invalidKeys.push(key);\n    }\n\n    serverEnv.set(key, result.output);\n  }\n\n  if (invalidKeys.length > 0) {\n    console.error(`Invalid environment variable(s): ${invalidKeys.map((e) => `\"${e}\"`).join(\", \")}`);\n    process.exit(1);\n  }\n\n  type ClientEnvKeys = Exclude<\n    {\n      [K in keyof Env]: K extends `${typeof PUBLIC_ENV_PREFIX}${string}` ? K : never;\n    }[keyof Env],\n    undefined\n  >;\n\n  type ClientEnv = {\n    [B in ClientEnvKeys]: Env[B];\n  };\n\n  const clientEnv = pipe(\n    serverEnv,\n    (obj) => Array.from(obj.entries()),\n    (pairs) => pairs.filter(([k]) => k.startsWith(PUBLIC_ENV_PREFIX)),\n    (pairs) => Object.fromEntries(pairs),\n  ) as ClientEnv;\n\n  return {\n    client: clientEnv,\n    server: Object.fromEntries(serverEnv.entries()) as Env,\n  };\n};\n"],"mappings":";;;;AAGA,MAAM,oBAAoB;;;;;;AAO1B,MAAa,aAKX,SAII;CACJ,MAAM,QAAQ,OAAO,QAAQ,KAAK,OAAO;CACzC,MAAM,4BAAY,IAAI,KAAK;CAC3B,MAAMA,cAAwB,EAAE;AAEhC,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO;EAChC,MAAM,SAAS,EAAE,UAAU,OAAO,KAAK,IAAI,KAAK;AAEhD,MAAI,CAAC,OAAO,QACV,aAAY,KAAK,IAAI;AAGvB,YAAU,IAAI,KAAK,OAAO,OAAO;;AAGnC,KAAI,YAAY,SAAS,GAAG;AAC1B,UAAQ,MAAM,oCAAoC,YAAY,KAAK,MAAM,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,GAAG;AAChG,UAAQ,KAAK,EAAE;;AAqBjB,QAAO;EACL,QARgB,KAChB,YACC,QAAQ,MAAM,KAAK,IAAI,SAAS,CAAC,GACjC,YAAUC,QAAM,QAAQ,CAAC,OAAO,EAAE,WAAW,kBAAkB,CAAC,GAChE,YAAU,OAAO,YAAYA,QAAM,CACrC;EAIC,QAAQ,OAAO,YAAY,UAAU,SAAS,CAAC;EAChD"}

package/dist/oxlint/jsx-component-pascal-case.d.mts

@@ -1,20 +1,20 @@
-import * as oxlint24 from "oxlint";
+import * as oxlint4 from "oxlint";
 
 //#region src/oxlint-plugins/jsx-component-pascal-case.d.ts
-declare const jsxComponentPascalCaseRule: oxlint24.Rule;
+declare const jsxComponentPascalCaseRule: oxlint4.Rule;
 declare namespace _default {
   namespace meta {
     let name: string;
   }
   let rules: {
-    "jsx-component-pascal-case": oxlint24.Rule;
+    "jsx-component-pascal-case": oxlint4.Rule;
   };
 }
-type RuleContext = oxlint24.Context;
-type ESTNode = oxlint24.ESTree.Node;
-type ESTExpression = oxlint24.ESTree.Expression;
-type ReturnStatementNode = oxlint24.ESTree.ReturnStatement;
-type FunctionLikeNode = oxlint24.ESTree.Function | oxlint24.ESTree.ArrowFunctionExpression;
+type RuleContext = oxlint4.Context;
+type ESTNode = oxlint4.ESTree.Node;
+type ESTExpression = oxlint4.ESTree.Expression;
+type ReturnStatementNode = oxlint4.ESTree.ReturnStatement;
+type FunctionLikeNode = oxlint4.ESTree.Function | oxlint4.ESTree.ArrowFunctionExpression;
 type FunctionContext = {
   node: FunctionLikeNode;
   name: string;

package/dist/oxlint/no-component-date-instantiation.d.mts

@@ -1,20 +1,20 @@
-import * as oxlint32 from "oxlint";
+import * as oxlint12 from "oxlint";
 
 //#region src/oxlint-plugins/no-component-date-instantiation.d.ts
-declare const noComponentDateInstantiationRule: oxlint32.Rule;
+declare const noComponentDateInstantiationRule: oxlint12.Rule;
 declare namespace _default {
   namespace meta {
     let name: string;
   }
   let rules: {
-    "no-component-date-instantiation": oxlint32.Rule;
+    "no-component-date-instantiation": oxlint12.Rule;
   };
 }
-type RuleContext = oxlint32.Context;
-type ESTNode = oxlint32.ESTree.Node;
-type NewExpressionNode = oxlint32.ESTree.NewExpression;
-type ReturnStatementNode = oxlint32.ESTree.ReturnStatement;
-type FunctionLikeNode = oxlint32.ESTree.Function | oxlint32.ESTree.ArrowFunctionExpression;
+type RuleContext = oxlint12.Context;
+type ESTNode = oxlint12.ESTree.Node;
+type NewExpressionNode = oxlint12.ESTree.NewExpression;
+type ReturnStatementNode = oxlint12.ESTree.ReturnStatement;
+type FunctionLikeNode = oxlint12.ESTree.Function | oxlint12.ESTree.ArrowFunctionExpression;
 type FunctionContext = {
   node: FunctionLikeNode;
   parent: FunctionContext | null;

package/dist/oxlint/no-emoji.d.mts

@@ -1,16 +1,16 @@
-import * as oxlint10 from "oxlint";
+import * as oxlint40 from "oxlint";
 
 //#region src/oxlint-plugins/no-emoji.d.ts
-declare const noEmojiRule: oxlint10.Rule;
+declare const noEmojiRule: oxlint40.Rule;
 declare namespace _default {
   namespace meta {
     let name: string;
   }
   let rules: {
-    "no-emoji": oxlint10.Rule;
+    "no-emoji": oxlint40.Rule;
   };
 }
-type ESTNode = oxlint10.ESTree.Node;
+type ESTNode = oxlint40.ESTree.Node;
 //#endregion
 export { ESTNode, _default as default, noEmojiRule };
 //# sourceMappingURL=no-emoji.d.mts.map

package/dist/oxlint/no-finally.d.mts

@@ -1,16 +1,16 @@
-import * as oxlint18 from "oxlint";
+import * as oxlint34 from "oxlint";
 
 //#region src/oxlint-plugins/no-finally.d.ts
-declare const noFinallyRule: oxlint18.Rule;
+declare const noFinallyRule: oxlint34.Rule;
 declare namespace _default {
   namespace meta {
     let name: string;
   }
   let rules: {
-    "no-finally": oxlint18.Rule;
+    "no-finally": oxlint34.Rule;
   };
 }
-type ESTNode = oxlint18.ESTree.Node;
+type ESTNode = oxlint34.ESTree.Node;
 //#endregion
 export { ESTNode, _default as default, noFinallyRule };
 //# sourceMappingURL=no-finally.d.mts.map

package/dist/oxlint/no-inline-components.d.mts

@@ -1,27 +1,27 @@
-import * as oxlint0 from "oxlint";
+import * as oxlint23 from "oxlint";
 
 //#region src/oxlint-plugins/no-inline-components.d.ts
 declare function isComponentName(name: unknown): name is string;
 declare function isHookName(name: unknown): name is string;
 declare function getEnclosingFunction(node: ESTNode | null | undefined): FunctionLikeNode | null;
 declare function getFunctionName(node: FunctionLikeNode): string;
-declare const noInlineComponentsRule: oxlint0.Rule;
+declare const noInlineComponentsRule: oxlint23.Rule;
 declare namespace _default {
   namespace meta {
     let name: string;
   }
   let rules: {
-    "no-inline-components": oxlint0.Rule;
+    "no-inline-components": oxlint23.Rule;
   };
 }
-type RuleContext = oxlint0.Context;
-type ESTNode = oxlint0.ESTree.Node;
-type ESTExpression = oxlint0.ESTree.Expression;
-type ESTPattern = oxlint0.ESTree.Pattern;
-type ReturnStatementNode = oxlint0.ESTree.ReturnStatement;
-type VariableDeclaratorNode = oxlint0.ESTree.VariableDeclarator;
-type AssignmentExpressionNode = oxlint0.ESTree.AssignmentExpression;
-type FunctionLikeNode = oxlint0.ESTree.Function | oxlint0.ESTree.ArrowFunctionExpression;
+type RuleContext = oxlint23.Context;
+type ESTNode = oxlint23.ESTree.Node;
+type ESTExpression = oxlint23.ESTree.Expression;
+type ESTPattern = oxlint23.ESTree.Pattern;
+type ReturnStatementNode = oxlint23.ESTree.ReturnStatement;
+type VariableDeclaratorNode = oxlint23.ESTree.VariableDeclarator;
+type AssignmentExpressionNode = oxlint23.ESTree.AssignmentExpression;
+type FunctionLikeNode = oxlint23.ESTree.Function | oxlint23.ESTree.ArrowFunctionExpression;
 type RecordedAssignment = {
   node: ESTExpression;
   names: string[];

package/dist/oxlint/no-react-namespace.d.mts

@@ -1,16 +1,16 @@
-import * as oxlint21 from "oxlint";
+import * as oxlint0 from "oxlint";
 
 //#region src/oxlint-plugins/no-react-namespace.d.ts
-declare const noReactNamespaceRule: oxlint21.Rule;
+declare const noReactNamespaceRule: oxlint0.Rule;
 declare namespace _default {
   namespace meta {
     let name: string;
   }
   let rules: {
-    "no-react-namespace": oxlint21.Rule;
+    "no-react-namespace": oxlint0.Rule;
   };
 }
-type ESTNode = oxlint21.ESTree.Node;
+type ESTNode = oxlint0.ESTree.Node;
 //#endregion
 export { ESTNode, _default as default, noReactNamespaceRule };
 //# sourceMappingURL=no-react-namespace.d.mts.map

package/dist/oxlint/no-switch-plugin.d.mts

@@ -1,4 +1,4 @@
-import * as oxlint16 from "oxlint";
+import * as oxlint2 from "oxlint";
 
 //#region src/oxlint-plugins/no-switch-plugin.d.ts
 declare namespace _default {
@@ -6,10 +6,10 @@ declare namespace _default {
     let name: string;
   }
   let rules: {
-    "no-switch": oxlint16.Rule;
+    "no-switch": oxlint2.Rule;
   };
 }
-type ESTNode = oxlint16.ESTree.Node;
+type ESTNode = oxlint2.ESTree.Node;
 //#endregion
 export { ESTNode, _default as default };
 //# sourceMappingURL=no-switch-plugin.d.mts.map

package/dist/oxlint/no-top-level-let.d.mts

@@ -1,16 +1,16 @@
-import * as oxlint13 from "oxlint";
+import * as oxlint20 from "oxlint";
 
 //#region src/oxlint-plugins/no-top-level-let.d.ts
-declare const noTopLevelLetRule: oxlint13.Rule;
+declare const noTopLevelLetRule: oxlint20.Rule;
 declare namespace _default {
   namespace meta {
     let name: string;
   }
   let rules: {
-    "no-top-level-let": oxlint13.Rule;
+    "no-top-level-let": oxlint20.Rule;
   };
 }
-type ESTNode = oxlint13.ESTree.Node;
+type ESTNode = oxlint20.ESTree.Node;
 //#endregion
 export { ESTNode, _default as default, noTopLevelLetRule };
 //# sourceMappingURL=no-top-level-let.d.mts.map

package/dist/oxlint/no-type-cast.d.mts

@@ -1,16 +1,16 @@
-import * as oxlint40 from "oxlint";
+import * as oxlint37 from "oxlint";
 
 //#region src/oxlint-plugins/no-type-cast.d.ts
-declare const noTypeCastRule: oxlint40.Rule;
+declare const noTypeCastRule: oxlint37.Rule;
 declare namespace _default {
   namespace meta {
     let name: string;
   }
   let rules: {
-    "no-type-cast": oxlint40.Rule;
+    "no-type-cast": oxlint37.Rule;
   };
 }
-type ESTNode = oxlint40.ESTree.Node;
+type ESTNode = oxlint37.ESTree.Node;
 //#endregion
 export { ESTNode, _default as default, noTypeCastRule };
 //# sourceMappingURL=no-type-cast.d.mts.map

package/dist/react.d.mts

@@ -46,6 +46,22 @@ declare const useOnce: (condition: unknown, callback: () => void) => void;
  */
 declare const useLocalOnce: (condition: unknown, callback: () => void) => void;
 //#endregion
+//#region src/react/useOnMount.d.ts
+/**
+ * Calls the given callback when the component mounts.
+ * Uses useStableCallback internally to ensure the latest version is called.
+ *
+ * @param callback - The function to run when the component mounts.
+ *
+ * @example
+ * ```tsx
+ * useOnMount(() => {
+ *   console.log("Component mounted!");
+ * });
+ * ```
+ */
+declare const useOnMount: (callback: () => void) => void;
+//#endregion
 //#region src/react/useOnUnmount.d.ts
 /**
  * Calls the given callback when the component unmounts.
@@ -53,5 +69,5 @@ declare const useLocalOnce: (condition: unknown, callback: () => void) => void;
  */
 declare const useOnUnmount: (callback: () => void) => void;
 //#endregion
-export { useLocalOnce, useOnUnmount, useOnce, useStableCallback };
+export { useLocalOnce, useOnMount, useOnUnmount, useOnce, useStableCallback };
 //# sourceMappingURL=react.d.mts.map

package/dist/react.mjs

@@ -71,6 +71,28 @@ const useLocalOnce = (condition, callback) => {
 	}
 };
 
+//#endregion
+//#region src/react/useOnMount.ts
+/**
+* Calls the given callback when the component mounts.
+* Uses useStableCallback internally to ensure the latest version is called.
+*
+* @param callback - The function to run when the component mounts.
+*
+* @example
+* ```tsx
+* useOnMount(() => {
+*   console.log("Component mounted!");
+* });
+* ```
+*/
+const useOnMount = (callback) => {
+	const stableCallback = useStableCallback(callback);
+	useEffect(() => {
+		stableCallback();
+	}, [stableCallback]);
+};
+
 //#endregion
 //#region src/react/useOnUnmount.ts
 /**
@@ -87,5 +109,5 @@ const useOnUnmount = (callback) => {
 };
 
 //#endregion
-export { useLocalOnce, useOnUnmount, useOnce, useStableCallback };
+export { 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/useOnUnmount.ts"],"sourcesContent":["// oxlint-disable no-explicit-any\r\n\r\nimport { useCallback, useRef } from \"react\";\r\n\r\ntype AnyFunction = (...args: any[]) => any;\r\ntype AnyArgs = any[];\r\n\r\n/**\r\n * Creates a stable callback that always calls the latest version of the function.\r\n * Useful for callbacks that need to be used in dependency arrays but should always\r\n * execute the most recent version of the callback.\r\n */\r\nexport const useStableCallback = <T extends AnyFunction>(callback: T): T => {\r\n  const callbackRef = useRef(callback);\r\n\r\n  // Update the ref on every render\r\n  callbackRef.current = callback;\r\n\r\n  return useCallback((...args: AnyArgs) => {\r\n    return callbackRef.current(...args);\r\n  }, []) as T;\r\n};\r\n","import { useEffect, useRef } from \"react\";\r\nimport { useStableCallback } from \"./useStableCallback\";\r\n\r\n/**\r\n * Runs a callback only once when a condition becomes truthy.\r\n * The callback is stabilized internally to always reference the latest version.\r\n *\r\n * @param condition - When truthy (evaluated via Boolean()), the callback will be executed (only once).\r\n * @param callback - The function to run once when the condition is met.\r\n *\r\n * @example\r\n * ```tsx\r\n * const isReady = true;\r\n * useOnce(isReady, () => {\r\n *   console.log(\"Ready!\");\r\n * });\r\n * ```\r\n */\r\nexport const useOnce = (condition: unknown, callback: () => void): void => {\r\n  const hasRunRef = useRef(false);\r\n  const stableCallback = useStableCallback(callback);\r\n\r\n  useEffect(() => {\r\n    if (Boolean(condition) && !hasRunRef.current) {\r\n      hasRunRef.current = true;\r\n      stableCallback();\r\n    }\r\n  }, [condition, stableCallback]);\r\n};\r\n","import { useRef } from \"react\";\r\nimport { useStableCallback } from \"./useStableCallback\";\r\n\r\n/**\r\n * Runs a callback only once when a condition becomes truthy, executing synchronously\r\n * during render. The callback is stabilized internally to always reference the latest version.\r\n *\r\n * Unlike `useOnce`, this runs at the top level of the hook (not in useEffect),\r\n * making it suitable for state updates that need to happen synchronously during render.\r\n *\r\n * @param condition - When truthy (evaluated via Boolean()), the callback will be executed (only once).\r\n * @param callback - The function to run once when the condition is met.\r\n *\r\n * @example\r\n * ```tsx\r\n * const user: User | null = getUser();\r\n * useLocalOnce(user, () => {\r\n *   setState(user.name);\r\n * });\r\n * ```\r\n */\r\nexport const useLocalOnce = (condition: unknown, callback: () => void): void => {\r\n  const hasRunRef = useRef(false);\r\n  const stableCallback = useStableCallback(callback);\r\n\r\n  if (Boolean(condition) && !hasRunRef.current) {\r\n    hasRunRef.current = true;\r\n    stableCallback();\r\n  }\r\n};\r\n","import { useEffect } from \"react\";\r\nimport { useStableCallback } from \"./useStableCallback\";\r\n\r\n/**\r\n * Calls the given callback when the component unmounts.\r\n * Uses useStableCallback internally to ensure the latest version is called.\r\n */\r\nexport const useOnUnmount = (callback: () => void): void => {\r\n  const stableCallback = useStableCallback(callback);\r\n\r\n  useEffect(() => {\r\n    return () => {\r\n      stableCallback();\r\n    };\r\n  }, [stableCallback]);\r\n};\r\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;;;;;;;;;;ACpBpB,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\r\n\r\nimport { useCallback, useRef } from \"react\";\r\n\r\ntype AnyFunction = (...args: any[]) => any;\r\ntype AnyArgs = any[];\r\n\r\n/**\r\n * Creates a stable callback that always calls the latest version of the function.\r\n * Useful for callbacks that need to be used in dependency arrays but should always\r\n * execute the most recent version of the callback.\r\n */\r\nexport const useStableCallback = <T extends AnyFunction>(callback: T): T => {\r\n  const callbackRef = useRef(callback);\r\n\r\n  // Update the ref on every render\r\n  callbackRef.current = callback;\r\n\r\n  return useCallback((...args: AnyArgs) => {\r\n    return callbackRef.current(...args);\r\n  }, []) as T;\r\n};\r\n","import { useEffect, useRef } from \"react\";\r\nimport { useStableCallback } from \"./useStableCallback\";\r\n\r\n/**\r\n * Runs a callback only once when a condition becomes truthy.\r\n * The callback is stabilized internally to always reference the latest version.\r\n *\r\n * @param condition - When truthy (evaluated via Boolean()), the callback will be executed (only once).\r\n * @param callback - The function to run once when the condition is met.\r\n *\r\n * @example\r\n * ```tsx\r\n * const isReady = true;\r\n * useOnce(isReady, () => {\r\n *   console.log(\"Ready!\");\r\n * });\r\n * ```\r\n */\r\nexport const useOnce = (condition: unknown, callback: () => void): void => {\r\n  const hasRunRef = useRef(false);\r\n  const stableCallback = useStableCallback(callback);\r\n\r\n  useEffect(() => {\r\n    if (Boolean(condition) && !hasRunRef.current) {\r\n      hasRunRef.current = true;\r\n      stableCallback();\r\n    }\r\n  }, [condition, stableCallback]);\r\n};\r\n","import { useRef } from \"react\";\r\nimport { useStableCallback } from \"./useStableCallback\";\r\n\r\n/**\r\n * Runs a callback only once when a condition becomes truthy, executing synchronously\r\n * during render. The callback is stabilized internally to always reference the latest version.\r\n *\r\n * Unlike `useOnce`, this runs at the top level of the hook (not in useEffect),\r\n * making it suitable for state updates that need to happen synchronously during render.\r\n *\r\n * @param condition - When truthy (evaluated via Boolean()), the callback will be executed (only once).\r\n * @param callback - The function to run once when the condition is met.\r\n *\r\n * @example\r\n * ```tsx\r\n * const user: User | null = getUser();\r\n * useLocalOnce(user, () => {\r\n *   setState(user.name);\r\n * });\r\n * ```\r\n */\r\nexport const useLocalOnce = (condition: unknown, callback: () => void): void => {\r\n  const hasRunRef = useRef(false);\r\n  const stableCallback = useStableCallback(callback);\r\n\r\n  if (Boolean(condition) && !hasRunRef.current) {\r\n    hasRunRef.current = true;\r\n    stableCallback();\r\n  }\r\n};\r\n","import { useEffect } 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: () => void): void => {\n  const stableCallback = useStableCallback(callback);\n\n  useEffect(() => {\n    stableCallback();\n  }, [stableCallback]);\n};\n","import { useEffect } from \"react\";\r\nimport { useStableCallback } from \"./useStableCallback\";\r\n\r\n/**\r\n * Calls the given callback when the component unmounts.\r\n * Uses useStableCallback internally to ensure the latest version is called.\r\n */\r\nexport const useOnUnmount = (callback: () => void): void => {\r\n  const stableCallback = useStableCallback(callback);\r\n\r\n  useEffect(() => {\r\n    return () => {\r\n      stableCallback();\r\n    };\r\n  }, [stableCallback]);\r\n};\r\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,aAA+B;CACxD,MAAM,iBAAiB,kBAAkB,SAAS;AAElD,iBAAgB;AACd,kBAAgB;IACf,CAAC,eAAe,CAAC;;;;;;;;;ACdtB,MAAa,gBAAgB,aAA+B;CAC1D,MAAM,iBAAiB,kBAAkB,SAAS;AAElD,iBAAgB;AACd,eAAa;AACX,mBAAgB;;IAEjB,CAAC,eAAe,CAAC"}

package/package.json

@@ -82,7 +82,7 @@
     "typescript": "5.9.3",
     "vitest": "4.0.15"
   },
-  "version": "0.0.44",
+  "version": "0.0.46",
   "scripts": {
     "dev": "tsdown --watch",
     "build": "tsc --noEmit && tsdown",