@recursica/mantine-adapter 0.17.0 → 0.18.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @recursica/mantine-adapter
 
+## 0.18.0
+
+### Minor Changes
+
+- 72174fc: Add MUI adapter, reworked storybook for adapter switching
+
+### Patch Changes
+
+- 72174fc: Updated docs and README.md links
+
 ## 0.17.0
 
 ### Minor Changes

package/dist/src/OverStyling.d.ts

@@ -0,0 +1 @@
+export declare const OverStylingInfo: () => import("react/jsx-runtime").JSX.Element;

package/dist/src/Version.d.ts

@@ -0,0 +1 @@
+export declare const VersionInfo: () => import("react/jsx-runtime").JSX.Element;

package/package.json

@@ -4,14 +4,16 @@
   "private": false,
   "homepage": "https://github.com/borderux/recursica/tree/main/packages/mantine-adapter",
   "author": "hi@borderux.com",
+  "license": "MIT",
   "bugs": {
     "url": "https://github.com/borderux/recursica/issues"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/borderux/recursica.git"
+    "url": "git+https://github.com/borderux/recursica.git",
+    "directory": "packages/mantine-adapter"
   },
-  "version": "0.17.0",
+  "version": "0.18.0",
   "type": "module",
   "main": "./dist/mantine-adapter.cjs",
   "module": "./dist/mantine-adapter.js",
@@ -57,7 +59,6 @@
     "@storybook/addon-a11y": "^10.3.3",
     "@storybook/addon-docs": "^10.3.3",
     "@storybook/addon-mcp": "^0.4.2",
-    "@storybook/addon-onboarding": "^10.3.3",
     "@storybook/addon-vitest": "^10.3.3",
     "@storybook/react-vite": "^10.3.3",
     "@types/react": "^19.1.2",

package/src/Introduction.stories.tsx

@@ -0,0 +1,180 @@
+import type { Meta } from "@storybook/react-vite";
+import { AdaptersContent, MantineLogo } from "@recursica/storybook-template";
+import { Button } from "./components/Button/Button";
+import { VersionInfo } from "./Version";
+import { OverStylingInfo } from "./OverStyling";
+
+const DOCS_URL = "https://recursica.com";
+const FORGE_URL = "https://forge.recursica.com";
+
+const sectionStyle: React.CSSProperties = {
+  marginBottom: 32,
+};
+
+const headingStyle: React.CSSProperties = {
+  fontSize: 14,
+  fontWeight: 600,
+  color: "#333",
+  marginBottom: 8,
+  marginTop: 0,
+};
+
+const bodyStyle: React.CSSProperties = {
+  fontSize: 14,
+  lineHeight: 1.6,
+  color: "#444",
+  margin: 0,
+};
+
+const linkStyle: React.CSSProperties = {
+  color: "#0066cc",
+  textDecoration: "none",
+};
+
+function IntroductionContent() {
+  return (
+    <div style={{ padding: 24, maxWidth: 640 }}>
+      <div
+        style={{
+          display: "flex",
+          alignItems: "center",
+          gap: "16px",
+          marginBottom: "16px",
+        }}
+      >
+        <MantineLogo width={40} height={40} />
+        <div>
+          <h1 style={{ fontSize: 24, fontWeight: 700, margin: 0 }}>
+            Recursica Design System (Mantine Adapter)
+          </h1>
+          <a
+            href="https://mantine.dev"
+            target="_blank"
+            rel="noreferrer"
+            style={linkStyle}
+          >
+            mantine.dev
+          </a>
+        </div>
+      </div>
+      <p style={{ ...bodyStyle, marginBottom: 24 }}>
+        This Storybook showcases the Recursica design system implemented for the{" "}
+        <strong>Mantine UI Kit</strong>. It provides reusable components that
+        map our design tokens to Mantine's robust component layer.
+      </p>
+
+      <section style={sectionStyle}>
+        <h2 style={headingStyle}>Looking for another UI Kit?</h2>
+        <p style={bodyStyle}>
+          Are you using a different UI Kit (like Material UI)? Recursica
+          provides multiple adapters for different frameworks.
+        </p>
+        <div style={{ marginTop: "16px" }}>
+          <Button
+            component="a"
+            href="./?path=/story/introduction--adapters"
+            target="_parent"
+            variant="solid"
+          >
+            View Supported Adapters
+          </Button>
+        </div>
+      </section>
+
+      <section style={sectionStyle}>
+        <h2 style={headingStyle}>Installation</h2>
+        <p style={bodyStyle}>
+          To install the Mantine adapter in your project, run:
+        </p>
+        <pre
+          style={{
+            padding: 12,
+            backgroundColor: "#f5f5f5",
+            borderRadius: 6,
+            fontSize: 13,
+            marginTop: 8,
+          }}
+        >
+          <code>
+            npm install @recursica/mantine-adapter @mantine/core @mantine/hooks
+          </code>
+        </pre>
+      </section>
+
+      <section style={sectionStyle}>
+        <h2 style={headingStyle}>Tokens</h2>
+        <p style={bodyStyle}>
+          Raw design tokens (colors, sizes, font weights, opacities, etc.) that
+          feed the theme and components. These are the primitive values defined
+          in your token set and exposed as CSS custom properties.
+        </p>
+      </section>
+
+      <section style={sectionStyle}>
+        <h2 style={headingStyle}>Theme</h2>
+        <p style={bodyStyle}>
+          Brand and theme layer built on top of tokens. Typography types,
+          dimensions, and layout grids are defined here. Theme uses the tokens
+          and exposes both CSS variables and helper classes (e.g. typography
+          classes) for consistent styling across the product.
+        </p>
+      </section>
+
+      <section style={sectionStyle}>
+        <h2 style={headingStyle}>Configuring Recursica</h2>
+        <p style={bodyStyle}>
+          To modify the Recursica configuration (tokens, brand, theme), go to{" "}
+          <a
+            href={FORGE_URL}
+            target="_blank"
+            rel="noopener noreferrer"
+            style={linkStyle}
+          >
+            {FORGE_URL}
+          </a>
+          . Changes there drive the tokens and theme you see in this Storybook.
+        </p>
+      </section>
+
+      <section style={sectionStyle}>
+        <h2 style={headingStyle}>Documentation</h2>
+        <p style={bodyStyle}>
+          For full documentation, guides, and API reference, visit{" "}
+          <a
+            href={DOCS_URL}
+            target="_blank"
+            rel="noopener noreferrer"
+            style={linkStyle}
+          >
+            {DOCS_URL}
+          </a>
+          .
+        </p>
+      </section>
+    </div>
+  );
+}
+
+const meta = {
+  title: "Introduction",
+} satisfies Meta;
+
+export default meta;
+
+export const Welcome = {
+  render: () => <IntroductionContent />,
+};
+
+export const Adapters = {
+  render: () => <AdaptersContent />,
+};
+
+export const OverStyling = {
+  name: "Over Styling",
+  render: () => <OverStylingInfo />,
+};
+
+export const VersionInfoStory = {
+  name: "Version Info",
+  render: () => <VersionInfo />,
+};

package/src/{OverStyling.stories.tsx → OverStyling.tsx}

@@ -1,4 +1,3 @@
-import type { Meta, StoryObj } from "@storybook/react";
 import {
   Container,
   Paper,
@@ -11,7 +10,7 @@ import {
 } from "@mantine/core";
 import { Button } from "./components/Button/Button";
 
-const OverStylingInfo = () => {
+export const OverStylingInfo = () => {
   return (
     <Container size="md" py="xl">
       <Paper withBorder p="xl" radius="md">
@@ -185,12 +184,3 @@ const OverStylingInfo = () => {
     </Container>
   );
 };
-
-const meta: Meta<typeof OverStylingInfo> = {
-  title: "Introduction/Over Styling",
-  component: OverStylingInfo,
-};
-
-export default meta;
-
-export const Default: StoryObj<typeof OverStylingInfo> = {};

package/src/{Version.stories.tsx → Version.tsx}

@@ -1,4 +1,3 @@
-import type { Meta, StoryObj } from "@storybook/react";
 import ReactMarkdown from "react-markdown";
 import {
   Container,
@@ -12,7 +11,7 @@ import {
 import pkg from "../package.json";
 import changelog from "../CHANGELOG.md?raw";
 
-const VersionInfo = () => {
+export const VersionInfo = () => {
   return (
     <Container size="md" py="xl">
       <Paper withBorder p="xl" radius="md">
@@ -43,14 +42,3 @@ const VersionInfo = () => {
     </Container>
   );
 };
-
-const meta: Meta<typeof VersionInfo> = {
-  title: "Introduction/Version Info",
-  component: VersionInfo,
-};
-
-export default meta;
-
-type Story = StoryObj<typeof VersionInfo>;
-
-export const Default: Story = {};