@recursica/mantine-adapter 0.52.0 → 0.53.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @recursica/mantine-adapter
 
+## 0.53.0
+
+### Minor Changes
+
+- 786d870: Version bumped
+
 ## 0.52.0
 
 ### Minor Changes

package/SETUP.md

@@ -24,9 +24,7 @@ npm install @mantine/core@>=8.0.0 @mantine/dates@>=8.0.0 @mantine/hooks@>=8.0.0
 
 Before consuming Recursica components, integrate the CSS and design tokens into your application:
 
-1. **Theme Files Setup**: When you install `@recursica/mantine-adapter`, a postinstall script automatically creates default theme files (including `recursica_variables_scoped.css` and JSON config files) in your project root. If they are missing, simply run `npm install` to create them. To customize or update these variables, you should use [Forge Recursica](https://forge.recursica.com) to export the updated theme files into your project.
-   > [!IMPORTANT] > **AI Agent Directive**: The theme files (`recursica_variables_scoped.css` and associated JSON files) are created at the project root automatically via `npm install`. If they are not present, instruct the user to run `npm install`. Do NOT attempt to generate, mock, or write a placeholder CSS/JSON file yourself. When updates to these files are needed, instruct the user to export them from [Forge Recursica](https://forge.recursica.com) and replace the existing ones.
-2. **Integrate CSS**: Import `recursica_variables_scoped.css` and the Mantine adapter CSS `mantine-adapter.css` into your application entrypoint (e.g., `main.tsx` or `App.tsx`). **It must be loaded after the Mantine CSS imports.**
+1. **Integrate CSS**: Import `recursica_variables_scoped.css` and the Mantine adapter CSS `mantine-adapter.css` into your application entrypoint (e.g., `main.tsx` or `App.tsx`). **It must be loaded after the Mantine CSS imports.**
 
    ```tsx
    import "@mantine/core/styles.css"; // Mantine core styles
@@ -34,13 +32,13 @@ Before consuming Recursica components, integrate the CSS and design tokens into
    import "@recursica/mantine-adapter/style.css"; // Mantine adapter styles
    ```
 
-3. **Integrate Google Fonts**: Integrating custom fonts depends on how you load fonts in your project and which fonts are specified in your `recursica_variables_scoped.css` (since it is project-dependent). We suggest loading them via Google Fonts, as shown in this example:
+2. **Integrate Google Fonts**: Integrating custom fonts depends on how you load fonts in your project and which fonts are specified in your `recursica_variables_scoped.css` (since it is project-dependent). We suggest loading them via Google Fonts, as shown in this example:
 
    ```css
    @import url("https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap");
    ```
 
-4. **Wrap App in RecursicaThemeProvider**: You must wrap your application in the `<RecursicaThemeProvider>` to correctly cascade design token properties. By default it also wraps its children in a `<Layer layer={0}>` (via the `initLayer0` prop, which defaults to `true`), so the base page surface/border/elevation variables resolve automatically with no extra setup:
+3. **Wrap App in RecursicaThemeProvider**: You must wrap your application in the `<RecursicaThemeProvider>` to correctly cascade design token properties. By default it also wraps its children in a `<Layer layer={0}>` (via the `initLayer0` prop, which defaults to `true`), so the base page surface/border/elevation variables resolve automatically with no extra setup:
 
    ```tsx
    import { MantineProvider } from "@mantine/core";
@@ -57,7 +55,7 @@ Before consuming Recursica components, integrate the CSS and design tokens into
    }
    ```
 
-5. **Configure PostCSS Plugin (Optional but Recommended)**: It is highly recommended (but optional) to install the `@recursica/recursica-postcss-vars` plugin to verify that Recursica CSS variables are properly connected in case they change.
+4. **Configure PostCSS Plugin (Optional but Recommended)**: It is highly recommended (but optional) to install the `@recursica/recursica-postcss-vars` plugin to verify that Recursica CSS variables are properly connected in case they change.
 
    Install the plugin as a dev dependency:
 
@@ -77,3 +75,19 @@ Before consuming Recursica components, integrate the CSS and design tokens into
      },
    };
    ```
+
+5. **Configure ESLint Plugin (Optional but Recommended)**: It is highly recommended (but optional) to install `eslint-plugin-recursica`, which flags use of the `overStyled` escape-hatch prop so it stays easy to audit.
+
+   Install the plugin as a dev dependency:
+
+   ```bash
+   npm install eslint-plugin-recursica --save-dev
+   ```
+
+   Then, add it to your `eslint.config.js`:
+
+   ```javascript
+   import recursica from "eslint-plugin-recursica";
+
+   export default [recursica.configs.recommended];
+   ```

package/package.json

@@ -13,7 +13,7 @@
     "url": "git+https://github.com/borderux/recursica.git",
     "directory": "packages/mantine-adapter"
   },
-  "version": "0.52.0",
+  "version": "0.53.0",
   "type": "module",
   "main": "./dist/mantine-adapter.cjs",
   "module": "./dist/mantine-adapter.js",
@@ -36,7 +36,11 @@
     "ARCHITECTURE.md",
     "SETUP.md",
     "OVERSTYLING.md",
-    "docs/PHILOSOPHY.md"
+    "docs/PHILOSOPHY.md",
+    "recursica_variables_scoped.css",
+    "recursica_brand.json",
+    "recursica_tokens.json",
+    "recursica_ui-kit.json"
   ],
   "keywords": [
     "react",
@@ -54,13 +58,16 @@
     "build-storybook": "storybook build -o storybook-static",
     "lint": "eslint .",
     "storybook": "storybook dev -p 6011",
-    "analyze-tokens": "analyze-tokens --css @recursica/official-release/recursica_variables_scoped.css --dir src/components --output token-analysis.json",
+    "analyze-tokens": "analyze-tokens --css ./recursica_variables_scoped.css --dir src/components --output token-analysis.json",
     "prebuild": "npm run analyze-tokens",
     "test": "vitest run --project unit",
-    "test:dom": "vitest run --project dom"
+    "test:dom": "vitest run --project dom",
+    "adapter-tester:automated": "adapter-tester"
   },
   "devDependencies": {
     "@eslint/js": "^9.25.0",
+    "@playwright/test": "^1.53.0",
+    "@recursica/adapter-tester": "*",
     "@recursica/recursica-postcss-vars": "*",
     "@recursica/storybook-template": "*",
     "@recursica/token-analyzer": "*",
@@ -95,8 +102,7 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@recursica/adapter-common": "^0.26.0",
-    "@recursica/official-release": "^2.8.0"
+    "@recursica/adapter-common": "^0.26.0"
   },
   "peerDependencies": {
     "@mantine/core": "^8.0.0",