Fix: Minor Storybook docs fixes, and add Disclaimer in Core utilities

Author: jeffreybernadas

.storybook/SBUrlCore.tsx

@@ -8,23 +8,26 @@ addons.register("storybook/redirect", () => {
     title: "Go to Core Components",
     type: types.TOOL,
     match: ({ viewMode }) => !!viewMode?.match(/^(story|docs)$/),
-    render: () => (
-      <IconButton
-        key="redirect"
-        title="Navigate to Core Components"
-        onClick={async () =>
-          window.open("https://core.thecodebit.digital", "_blank")
-        }
-        style={{
-          position: "absolute",
-          right: "90px",
-        }}
-      >
-        Go to Core Components
-        <ArrowUpRight
-          style={{ color: "white", width: "0.75em", height: "0.75em" }}
-        />
-      </IconButton>
-    ),
+    render: () => {
+      const isDocs = window.location.search.includes("--docs");
+      return (
+        <IconButton
+          key="redirect"
+          title="Navigate to Core Components"
+          onClick={async () =>
+            window.open("https://core.thecodebit.digital", "_blank")
+          }
+          style={{
+            position: "absolute",
+            right: isDocs ? "30px" : "100px",
+          }}
+        >
+          Go to Core Components
+          <ArrowUpRight
+            style={{ color: "white", width: "0.75em", height: "0.75em" }}
+          />
+        </IconButton>
+      );
+    },
   });
 });

.storybook/preview.ts

@@ -19,7 +19,15 @@ const preview: Preview = {
     },
     options: {
       storySort: {
-        order: ["Introduction", "FAQ", "Changelog"],
+        order: [
+          "Introduction",
+          "FAQ",
+          "Changelog",
+          "Documentation",
+          "Components",
+          "Hooks",
+          "Lib",
+        ],
       },
     },
   },

src/stories/lib/Disclaimer.mdx

@@ -0,0 +1,38 @@
+import { Meta } from "@storybook/blocks";
+
+<Meta title="Lib/Disclaimer" />
+
+# Disclaimer
+
+This utility library is intentionally minimal and focused. It contains only specific, personally crafted utilities that:
+
+- Are not readily available in established utility libraries
+- Solve unique use cases in my projects
+- Provide opinionated implementations for common patterns
+
+## 🔍 Recommended Alternatives
+
+For comprehensive utility needs, I highly recommend using established libraries:
+
+- [Ramda](https://ramdajs.com/) - Functional programming utilities
+- [Lodash](https://lodash.com/) - The gold standard for JavaScript utilities
+- [radash](https://radash-docs.vercel.app/) - Modern utility library focused on TypeScript
+- [date-fns](https://date-fns.org/) - Modern JavaScript date utility library
+- [just](https://github.com/angus-c/just) - A library of dependency-free utilities
+
+## 🎯 My Focus
+
+The utilities provided here are:
+
+- Highly specific to my use cases
+- Not meant to replace comprehensive utility libraries
+- Designed to complement existing solutions
+- Thoroughly tested and documented
+- TypeScript-first implementations
+
+## 📝 Usage Guidelines
+
+- Always check if your needed utility exists in established libraries first
+- Use my utilities only for specific use cases not covered elsewhere
+- Consider contributing to existing libraries instead of adding new utilities here
+- Follow the documentation patterns when adding new utilities