feat(web/vue): add useStorage and useStorageAsync, separate all composables by categories

web/vue/src/composables/lifecycle/tryOnMounted/index.ts

@@ -0,0 +1,45 @@
+import { onMounted, nextTick, type ComponentInternalInstance } from 'vue';
+import { getLifeCycleTarger } from '@/utils';
+import type { VoidFunction } from '@robonen/stdlib';
+
+// TODO: tests
+
+export interface TryOnMountedOptions {
+  sync?: boolean;
+  target?: ComponentInternalInstance;
+}
+
+/**
+ * @name tryOnMounted
+ * @category Lifecycle
+ * @description Call onMounted if it's inside a component lifecycle hook, otherwise just calls it
+ * 
+ * @param {VoidFunction} fn The function to call
+ * @param {TryOnMountedOptions} options The options to use
+ * @param {boolean} [options.sync=true] If the function should be called synchronously
+ * @param {ComponentInternalInstance} [options.target] The target instance to use
+ * @returns {void}
+ * 
+ * @example
+ * tryOnMounted(() => console.log('Mounted!'));
+ * 
+ * @example
+ * tryOnMounted(() => console.log('Mounted!'), { sync: false });
+ * 
+ * @since 0.0.1
+ */
+export function tryOnMounted(fn: VoidFunction, options: TryOnMountedOptions = {}) {
+  const {
+    sync = true,
+    target,
+  } = options;
+
+  const instance = getLifeCycleTarger(target);
+
+  if (instance)  
+    onMounted(fn, instance);
+  else if (sync)
+    fn();
+  else
+    nextTick(fn);
+}