doc: update jsdoc

Author: nDriaDev

src/components/ForMemoized.tsx

@@ -3,8 +3,8 @@ import { For } from "./For";
 //#IGNORE
 /**
  * **`ForMemoized`**: Memoized version of _For_ component.
- * {@link For} is wrapped with `React.memo`, preventing re-renders when his props have
- * not changed. Prefer this over {@link For} in performance-sensitive
+ * [For] is wrapped with `React.memo`, preventing re-renders when his props have not changed.
+ * Prefer this over [For](https://react-tools.ndria.dev/components/For) in performance-sensitive
  * trees where the parent re-renders frequently.
  *
  * @see [📖 Documentation](https://react-tools.ndria.dev/components/ForMemoized)

src/components/Show.tsx

@@ -106,9 +106,9 @@ function Show<T>({ when, fallback, children, mode = "unmount" }: ShowProps<T>) {
 	}
 
 	if (!when) {
-		return fallback ? <>{fallback}</> : null;
+		return fallback ?? null;
 	}
-	return <>{children}</>;
+	return children;
 }
 
 export { Show };

src/components/ShowMemoized.tsx

@@ -5,8 +5,8 @@ import { Show } from "./Show";
 
 /**
  * **`ShowMemoized`**: Memoized version of _Show_ component.
- * {@link Show} is wrapped with `React.memo`, preventing re-renders when his props have
- * not changed. Prefer this over {@link Show} in performance-sensitive
+ * [Show] is wrapped with `React.memo`, preventing re-renders when his props have not changed.
+ * Prefer this over [Show](https://react-tools.ndria.dev/components/Show) in performance-sensitive
  * trees where the parent re-renders frequently.
  *
  * @see [📖 Documentation](https://react-tools.ndria.dev/components/ShowMemoized)

src/components/SwitchCaseMemoized.tsx

@@ -6,10 +6,10 @@ import { Switch } from "./_Switch";
 
 /**
  * **`SwitchCaseMemoized`**: Memoized version of _SwitchCase_ component.
- * Both {@link Switch} and {@link Case}
- * are wrapped with `React.memo`, preventing re-renders when their props have
- * not changed. Prefer this over {@link SwitchCase} in performance-sensitive
- * trees where the parent re-renders frequently.
+ * Both [Switch] and [Case] are wrapped with `React.memo`, preventing re-renders
+ * when their props have not changed.
+ * Prefer this over [SwitchCase](https://react-tools.ndria.dev/components/SwitchCase)
+ * in performance-sensitive trees where the parent re-renders frequently.
  *
  * @see [📖 Documentation](https://react-tools.ndria.dev/components/SwitchCaseMemoized)
  */

src/components/_Case.tsx

@@ -1,13 +1,15 @@
 import { CaseProps } from "../models"
+import { Show } from "./Show";
 
 /**
  * **`Case`**: Component used inside _SwitchCase_ component to represent a case construct.
+ *
  * @see [📖 Documentation](https://react-tools.ndria.dev/components/SwitchCase)
  * @param {CaseProps} props - {@link CaseProps}
  * @returns {JSX.Element|null} element
  */
-export const Case = ({ children, when }: CaseProps) => {
-	return !when
-		? null
-		: <>{children}</>
-}
+export const Case = ({ children, when }: CaseProps) => (
+	<Show when={when} mode="unmount">
+		{children}
+	</Show>
+)

src/components/_Switch.tsx

@@ -8,10 +8,13 @@ import { SwitchProps } from "../models";
  * @returns {JSX.Element|null} element
  */
 export const Switch = ({ children, fallback }: SwitchProps) => {
-	const child = Children.toArray(children).find(el => isValidElement(el) && el.props && el.props.when)
-	return child
-		? <>{child}</>
-		: fallback !== undefined
-			? <> {fallback}</>
-			: null;
+	const activeChild = Children.toArray(children).find(
+		(el) => isValidElement(el) && el.props.when === true
+	);
+
+	if (!activeChild) {
+		return fallback ?? null;
+	}
+
+	return activeChild;
 }

src/demo/components/forMemoized/ForMemoized.md

@@ -1,3 +1,3 @@
 Memoized implementation of _For_ component.
 
-Please visit [For component](#/components/For) example to see how it works.
+Please visit [For component](https://react-tools.ndria.dev/components/For) example to see how it works.

src/demo/components/showMemoized/ShowMemoized.md

@@ -1,3 +1,3 @@
 Memoized implementation of _Show_ component.
 
-Please visit [Show component](#/components/Show) example to see how it works.
+Please visit [Show component](https://react-tools.ndria.dev/components/Show) example to see how it works.

src/demo/components/switchCaseMemoized/SwitchCaseMemoized.md

@@ -1,3 +1,3 @@
 Memoized implementation of _SwitchCase_ component.
 
-Please visit [SwitchCase component](#/components/SwitchCase) example to see how it works.
+Please visit [SwitchCase component](https://react-tools.ndria.dev/components/SwitchCase) example to see how it works.

src/hooks/api-dom/index.ts

@@ -45,4 +45,5 @@ export { usePromise } from './usePromise';
 export { useParallelPromises } from './useParallelPromises';
 export { useFetch } from './useFetch';
 export { useLock } from './useLock';
-export { useBroadcastChannel } from './useBroadcastChannel';
+export { useBroadcastChannel } from './useBroadcastChannel';
+export { use } from './use';