@recursica/mantine-adapter 0.52.0 → 0.54.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @recursica/mantine-adapter
 
+## 0.54.0
+
+### Minor Changes
+
+- c31d5ae: Added an `animate` prop to `Loader` (default `true`) — set `false` to freeze its CSS animation for a deterministic render, e.g. a visual-regression snapshot. The `Static*` Loader stories now use it, and the animated `Default`/`LayerTwoOval` stories are excluded from adapter-tester's visual regression.
+
+### Patch Changes
+
+- c31d5ae: Wired up unused design tokens (Accordion open state, Modal header/footer background, stacked Label width, TimePicker leading icon + placeholder opacity) and added `recursica-ignore` exemptions for tokens confirmed inapplicable by design.
+- c31d5ae: Fixed `Table` currency columns so header and footer cells right-align to match value cells. `Table.Th`/`Table.Cell` header context now supports `variant="currency"`.
+- Updated dependencies [c31d5ae]
+- Updated dependencies [c31d5ae]
+- Updated dependencies [c31d5ae]
+  - @recursica/adapter-common@0.27.0
+
+## 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/dist/index.d.ts

@@ -2330,6 +2330,12 @@ export declare interface RecursicaLoaderProps {
     variant?: "oval" | "bars" | "dots";
     /** Map to Recursica sizes */
     size?: "sm" | "md" | "lg" | RecursicaSize;
+    /** Freezes the loader's CSS animation when `false` — the loader still
+     * renders its normal shape, just without motion. Defaults to `true` (the
+     * normal, animated loader). Use `false` for a deterministic rendering,
+     * e.g. a visual-regression snapshot, where a moving animation would
+     * otherwise diff differently every run. */
+    animate?: boolean;
 }
 
 /**
@@ -2613,6 +2619,8 @@ export declare interface RecursicaTableHeaderCellProps {
     sorted?: "asc" | "desc" | false;
     /** Disables the header cell, dimming it and applying the disabled cell colors */
     disabled?: boolean;
+    /** `"currency"` right-aligns the header cell to match a currency column's value cells */
+    variant?: "default" | "currency";
 }
 
 /**
@@ -2747,6 +2755,8 @@ declare interface RecursicaTimePickerProps_2 {
     minTime?: string;
     /** Maximum possible time string. Format is `HH:mm` normally, or `HH:mm:ss` when `withSeconds` is true. */
     maxTime?: string;
+    /** Section rendered inside the time field on the left (e.g. icon). Naming rationale: see `RecursicaTextFieldProps.leftSection`. */
+    leftSection?: default_2.ReactNode;
 }
 
 /**