@recursica/adapter-mantine-v8 1.3.3 → 1.3.4

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @recursica/adapter-mantine-v8
 
+## 1.3.4
+
+### Patch Changes
+
+- f5b4ab0: Updated `@recursica/storybook-template` to 0.7.16. The Adapters page now lists the Angular Material adapter.
+- f5b4ab0: Stop publishing Storybook story files and `.storybook/commonArgTypes.ts` in the npm package.
+- f5b4ab0: Add a "Why an Adapter?" section to PHILOSOPHY.md.
+
 ## 1.3.3
 
 ### Patch Changes

package/docs/PHILOSOPHY.md

@@ -4,6 +4,10 @@ Recursica's component architecture isn't just a wrapper; it's a strict enforcing
 
 This document serves as the governing framework for why the `adapter-mantine-v8` components are built the way they are.
 
+## Why an Adapter?
+
+Most companies already have an existing component library or use an existing UI kit, and switching to a different kit means painful refactoring. Rather than replace Mantine, this adapter adapts to its API surface while enforcing the behaviors and styling Recursica defines for a consistent UX. You don't ship two separate UI kits, and you can migrate to Recursica systematically, over time.
+
 ## 1. Strict Separation of Props (The Unified Recursica Prop Layer)
 
 Recursica has a **single universal API surface** internally regardless of whether we use Mantine or another underlying UI library.

package/package.json

@@ -12,7 +12,7 @@
     "type": "git",
     "url": "git+https://github.com/borderux/recursica-adapter-mantine-v8.git"
   },
-  "version": "1.3.3",
+  "version": "1.3.4",
   "publishConfig": {
     "access": "public"
   },
@@ -31,18 +31,14 @@
   "files": [
     "dist",
     "src",
+    "!src/**/*.stories.tsx",
     "CHANGELOG.md",
-    ".storybook/commonArgTypes.ts",
     "llms.txt",
     "USAGE.md",
     "ARCHITECTURE.md",
     "SETUP.md",
     "OVERSTYLING.md",
-    "docs/PHILOSOPHY.md",
-    "recursica_variables_scoped.css",
-    "recursica_brand.json",
-    "recursica_tokens.json",
-    "recursica_ui-kit.json"
+    "docs/PHILOSOPHY.md"
   ],
   "keywords": [
     "react",
@@ -86,7 +82,7 @@
     "@playwright/test": "^1.62.1",
     "@recursica/adapter-tester": "^5.3.1",
     "@recursica/recursica-postcss-vars": "^1.5.0",
-    "@recursica/storybook-template": "^0.7.15",
+    "@recursica/storybook-template": "^0.7.16",
     "@recursica/token-analyzer": "^1.8.0",
     "@storybook/addon-a11y": "^10.3.3",
     "@storybook/addon-docs": "^10.3.3",

package/.storybook/commonArgTypes.ts

@@ -1,148 +0,0 @@
-/**
- * commonArgTypes.ts
- *
- * This file centralizes the standard Storybook Controls (ArgTypes) for all UI Kit
- * components that natively wrap or extend the `FormControlWrapper`.
- *
- * PHILOSOPHY:
- * Recursica ensures strict unified design boundaries across all form inputs (TextField,
- * CheckboxGroup, Dropdown, etc.). Because they all share the exact same label structures,
- * layout variants (stacked vs side-by-side), and assistive text bindings natively supplied
- * by the `FormControlWrapper`, their Storybook experiences should be exactly identical.
- *
- * USAGE:
- * Rather than recreating these controls inside every `Component.stories.tsx` file,
- * developers must spread this object directly into the `argTypes` of their story default block:
- *
- * ```tsx
- * import { formControlArgTypes } from "../../.storybook/commonArgTypes";
- *
- * export default {
- *   component: TextField,
- *   argTypes: {
- *     ...formControlArgTypes,
- *     // Component-specific argTypes below...
- *   }
- * }
- * ```
- */
-import type { ArgTypes } from "@storybook/react";
-
-export const formControlArgTypes: Partial<ArgTypes> = {
-  formLayout: {
-    control: "inline-radio",
-    options: ["stacked", "side-by-side"],
-    description:
-      "Determines the structural flow layout of the Label relative to the Input.",
-    table: {
-      category: "Form Layout",
-    },
-  },
-  labelSize: {
-    control: "inline-radio",
-    options: ["default", "small"],
-    description:
-      "Adjusts the typographical boundaries bounding the Label section.",
-    table: {
-      category: "Form Layout",
-    },
-  },
-  labelAlignment: {
-    control: "inline-radio",
-    options: ["left", "right"],
-    description:
-      "Adjusts the explicit text alignment axis exclusively evaluating side-by-side structures.",
-    table: {
-      category: "Form Layout",
-    },
-  },
-  labelOptionalText: {
-    control: "text",
-    description:
-      "Optional secondary stylistic text injected alongside the primary Label node.",
-    table: {
-      category: "Form Layout",
-    },
-  },
-  labelWithEditIcon: {
-    control: "boolean",
-    description:
-      "Dynamically toggles interactivity hooks revealing the Edit context icon.",
-    table: {
-      category: "Form Layout",
-    },
-  },
-  description: {
-    table: {
-      disable: true,
-    },
-  },
-  assistiveText: {
-    control: "text",
-    description:
-      "Helper instructions safely dynamically anchored below the input box natively outperforming description.",
-    table: {
-      category: "Form Layout",
-    },
-  },
-  assistiveWithIcon: {
-    control: "boolean",
-    description:
-      "Toggles native Recursica Info-styling rendering universally alongside the assistive block.",
-    table: {
-      category: "Form Layout",
-    },
-  },
-  error: {
-    control: "text",
-    description:
-      "Dynamically maps error feedback validation strings rendering explicit error states.",
-    table: {
-      category: "Form State",
-    },
-  },
-  required: {
-    control: "boolean",
-    description:
-      "Native DOM compliance flag explicitly marking the field as required natively.",
-    table: {
-      category: "Form State",
-    },
-  },
-  disabled: {
-    control: "boolean",
-    description:
-      "Globally disables interactive components bounding all click and focus logic natively.",
-    table: {
-      category: "Form State",
-    },
-  },
-  withAsterisk: {
-    control: "boolean",
-    description:
-      "Visually forces the mandatory asterisk presence completely independent of logical 'required' attribute properties.",
-    table: {
-      category: "Form State",
-    },
-  },
-  labelActionArea: {
-    table: {
-      disable: true,
-    },
-  },
-  onLabelEditClick: {
-    table: {
-      disable: true,
-    },
-  },
-  controlMaxWidth: {
-    table: {
-      disable: true,
-    },
-  },
-  controlMinWidth: {
-    table: {
-      disable: true,
-    },
-  },
-};