@recursica/mantine-adapter 0.51.0 → 0.53.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @recursica/mantine-adapter
 
+## 0.53.0
+
+### Minor Changes
+
+- 786d870: Version bumped
+
+## 0.52.0
+
+### Minor Changes
+
+- f618b38: Renamed the `Title` component to `Heading` (and `RecursicaTitleProps` to `RecursicaHeadingProps`) to match designers' semantic vocabulary. `Text` is unchanged. Breaking: update imports from `Title`/`TitleProps` to `Heading`/`HeadingProps`.
+
+### Patch Changes
+
+- Updated dependencies [f618b38]
+  - @recursica/adapter-common@0.26.0
+
 ## 0.51.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

@@ -99,7 +99,7 @@ import { TextProps as TextProps_2 } from '@mantine/core';
 import { TimelineItemProps as TimelineItemProps_2 } from '@mantine/core';
 import { TimelineProps as TimelineProps_2 } from '@mantine/core';
 import { TimePickerProps } from '@mantine/dates';
-import { TitleProps as TitleProps_2 } from '@mantine/core';
+import { TitleProps } from '@mantine/core';
 import { Tooltip as Tooltip_3 } from '@mantine/core';
 import { TooltipFloatingProps as TooltipFloatingProps_2 } from '@mantine/core';
 import { TooltipProps as TooltipProps_2 } from '@mantine/core';
@@ -757,6 +757,15 @@ spacing?: string | number | RecursicaSpacing;
  */
 declare type GroupProps = WithRecursicaSpacing<GroupProps_2>;
 
+export declare const Heading: typeof rawComponents.Heading;
+
+/**
+ * Enforces highly accessible structural markup utilizing semantic `<h1>` through `<h6>` tags securely bound directly to Recursica typographic scales.
+ */
+declare const Heading_2: ForwardRefExoticComponent<HeadingProps & RefAttributes<HTMLHeadingElement>>;
+
+declare type HeadingProps = RecursicaOverStyled<Omit<TitleProps, "size"> & RecursicaHeadingProps>;
+
 export declare const HoverCard: typeof rawComponents.HoverCard;
 
 declare const HoverCard_2: HoverCardComponent;
@@ -1488,6 +1497,8 @@ declare namespace rawComponents {
         Grid_2 as Grid,
         GroupProps,
         Group_2 as Group,
+        HeadingProps,
+        Heading_2 as Heading,
         HoverCardProps,
         HoverCardTargetProps,
         HoverCardDropdownProps,
@@ -1625,8 +1636,6 @@ declare namespace rawComponents {
         Timeline_2 as Timeline,
         TimelineItemProps,
         TimelineItem_2 as TimelineItem,
-        TitleProps,
-        Title_2 as Title,
         ToastProps,
         Toast_2 as Toast,
         TooltipProps,
@@ -1689,7 +1698,7 @@ declare type ReadOnlyTextFieldProps = RecursicaOverStyled<RecursicaReadOnlyTextF
 /**
  * Official list of all components in Recursica.
  */
-export declare const RECURSICA_COMPONENTS: readonly ["Accordion", "AssistiveElement", "Autocomplete", "Avatar", "Badge", "Box", "Breadcrumb", "Button", "Card", "Checkbox", "CheckboxGroup", "Chip", "Container", "DatePicker", "Dropdown", "EmptyValueRenderer", "FileInput", "FileUpload", "Flex", "FormControlLayout", "FormControlWrapper", "Grid", "Group", "HoverCard", "Label", "Layer", "Link", "Loader", "Menu", "Modal", "NumberInput", "Pagination", "Panel", "Popover", "Radio", "ReadOnlyField", "SegmentedControl", "Slider", "Stack", "Stepper", "Switch", "Table", "Tabs", "Text", "TextArea", "TextField", "TimePicker", "Timeline", "Title", "Toast", "Tooltip", "TransferList", "Tree", "Typography"];
+export declare const RECURSICA_COMPONENTS: readonly ["Accordion", "AssistiveElement", "Autocomplete", "Avatar", "Badge", "Box", "Breadcrumb", "Button", "Card", "Checkbox", "CheckboxGroup", "Chip", "Container", "DatePicker", "Dropdown", "EmptyValueRenderer", "FileInput", "FileUpload", "Flex", "FormControlLayout", "FormControlWrapper", "Grid", "Group", "Heading", "HoverCard", "Label", "Layer", "Link", "Loader", "Menu", "Modal", "NumberInput", "Pagination", "Panel", "Popover", "Radio", "ReadOnlyField", "SegmentedControl", "Slider", "Stack", "Stepper", "Switch", "Table", "Tabs", "Text", "TextArea", "TextField", "TimePicker", "Timeline", "Toast", "Tooltip", "TransferList", "Tree", "Typography"];
 
 /**
  * Props for the Recursica Accordion Control component.
@@ -2223,6 +2232,18 @@ export declare interface RecursicaFormControlWrapperProps extends RecursicaLabel
     controlMinWidth?: string | undefined;
 }
 
+/**
+ * Props for the Recursica Heading component.
+ */
+export declare interface RecursicaHeadingProps extends default_2.HTMLAttributes<HTMLHeadingElement> {
+    /** Heading ordering hierarchies (1 represents H1, 6 represents H6) */
+    order?: 1 | 2 | 3 | 4 | 5 | 6;
+    /** Heading contents */
+    children?: default_2.ReactNode;
+    /** Polymorphic component override */
+    component?: default_2.ElementType;
+}
+
 /**
  * Props for the Recursica HoverCard component.
  */
@@ -2728,18 +2749,6 @@ declare interface RecursicaTimePickerProps_2 {
     maxTime?: string;
 }
 
-/**
- * Props for the Recursica Title component.
- */
-export declare interface RecursicaTitleProps extends default_2.HTMLAttributes<HTMLHeadingElement> {
-    /** Heading ordering hierarchies (1 represents H1, 6 represents H6) */
-    order?: 1 | 2 | 3 | 4 | 5 | 6;
-    /** Title contents */
-    children?: default_2.ReactNode;
-    /** Polymorphic component override */
-    component?: default_2.ElementType;
-}
-
 /**
  * Props for the Recursica Toast notification component.
  */
@@ -3108,7 +3117,7 @@ export { Text_2 as Text }
 
 /**
  * A generalized typographical wrapper limiting text properties to bounded Recursica UI-kit tokens inherently.
- * Do not use for semantic headings; use the explicit `<Title>` component for `<h1>` - `<h6>`.
+ * Do not use for semantic headings; use the explicit `<Heading>` component for `<h1>` - `<h6>`.
  *
  * Supports polymorphism via the `component` prop or `renderRoot` for custom element rendering.
  * @example
@@ -3181,15 +3190,6 @@ declare const TimePicker_2: default_2.ForwardRefExoticComponent<TimePickerProps_
 
 declare type TimePickerProps_2 = RecursicaOverStyled<RecursicaTimePickerProps>;
 
-export declare const Title: typeof rawComponents.Title;
-
-/**
- * Enforces highly accessible structural markup utilizing semantic `<h1>` through `<h6>` tags securely bound directly to Recursica typographic scales.
- */
-declare const Title_2: ForwardRefExoticComponent<TitleProps & RefAttributes<HTMLHeadingElement>>;
-
-declare type TitleProps = RecursicaOverStyled<Omit<TitleProps_2, "size"> & RecursicaTitleProps>;
-
 export declare const Toast: typeof rawComponents.Toast;
 
 declare const Toast_2: default_2.ForwardRefExoticComponent<ToastProps & default_2.RefAttributes<HTMLDivElement>>;