@recursica/mui-adapter 0.35.0 → 0.36.0

package/package.json

@@ -13,7 +13,7 @@
     "url": "git+https://github.com/borderux/recursica.git",
     "directory": "packages/mui-adapter"
   },
-  "version": "0.35.0",
+  "version": "0.36.0",
   "publishConfig": {
     "access": "public"
   },
@@ -107,7 +107,7 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@recursica/adapter-common": "^0.25.1",
+    "@recursica/adapter-common": "^0.26.0",
     "@recursica/official-release": "^2.8.0",
     "dayjs": "^1.11.21"
   },

package/src/Introduction.stories.tsx

@@ -6,7 +6,7 @@ import { OverStylingInfo } from "./OverStyling";
 const DOCS_URL = "https://recursica.com";
 const FORGE_URL = "https://forge.recursica.com";
 
-import { Container, Box, Group, Title, Text, Link } from "./components";
+import { Container, Box, Group, Heading, Text, Link } from "./components";
 
 function IntroductionContent() {
   return (
@@ -14,9 +14,9 @@ function IntroductionContent() {
       <Group gap="rec-md" mb={2}>
         <MuiLogo width={40} height={40} />
         <Box>
-          <Title order={1} m={0}>
+          <Heading order={1} m={0}>
             Recursica Design System (MUI Adapter)
-          </Title>
+          </Heading>
           <Link href="https://mui.com" target="_blank" rel="noreferrer">
             mui.com
           </Link>
@@ -29,9 +29,9 @@ function IntroductionContent() {
       </Text>
 
       <Box component="section" sx={{ mb: 4 }}>
-        <Title order={2} mb={1}>
+        <Heading order={2} mb={1}>
           Looking for another UI Kit?
-        </Title>
+        </Heading>
         <Text>
           Are you using a different UI Kit (like Mantine)? Recursica provides
           multiple adapters for different frameworks.
@@ -85,9 +85,9 @@ function IntroductionContent() {
       </Box>
 
       <Box component="section" sx={{ mb: 4 }}>
-        <Title order={2} mb={1}>
+        <Heading order={2} mb={1}>
           Installation
-        </Title>
+        </Heading>
         <Text>To install the MUI adapter in your project, run:</Text>
         <Box
           component="pre"
@@ -107,9 +107,9 @@ function IntroductionContent() {
       </Box>
 
       <Box component="section" sx={{ mb: 4 }}>
-        <Title order={2} mb={1}>
+        <Heading order={2} mb={1}>
           Tokens
-        </Title>
+        </Heading>
         <Text>
           Raw design tokens (colors, sizes, font weights, opacities, etc.) that
           feed the theme and components. These are the primitive values defined
@@ -118,9 +118,9 @@ function IntroductionContent() {
       </Box>
 
       <Box component="section" sx={{ mb: 4 }}>
-        <Title order={2} mb={1}>
+        <Heading order={2} mb={1}>
           Theme
-        </Title>
+        </Heading>
         <Text>
           Brand and theme layer built on top of tokens. Typography types,
           dimensions, and layout grids are defined here. Theme uses the tokens
@@ -130,9 +130,9 @@ function IntroductionContent() {
       </Box>
 
       <Box component="section" sx={{ mb: 4 }}>
-        <Title order={2} mb={1}>
+        <Heading order={2} mb={1}>
           Configuring Recursica
-        </Title>
+        </Heading>
         <Text>
           To modify the Recursica configuration (tokens, brand, theme), go to{" "}
           <Link href={FORGE_URL} target="_blank" rel="noopener noreferrer">
@@ -143,9 +143,9 @@ function IntroductionContent() {
       </Box>
 
       <Box component="section" sx={{ mb: 4 }}>
-        <Title order={2} mb={1}>
+        <Heading order={2} mb={1}>
           Documentation
-        </Title>
+        </Heading>
         <Text>
           For full documentation, guides, and API reference, visit{" "}
           <Link href={DOCS_URL} target="_blank" rel="noopener noreferrer">

package/src/OverStyling.tsx

@@ -5,7 +5,7 @@ import {
   Stack,
   Box,
   Text as RawText,
-  Title,
+  Heading,
   Switch as RawSwitch,
 } from "./components";
 import { Button as RawButton } from "./components/Button/Button";
@@ -31,9 +31,9 @@ export const OverStylingInfo = () => {
 
         <Divider sx={{ my: 4 }} />
 
-        <Title order={6} mb={2}>
+        <Heading order={6} mb={2}>
           Try It Yourself
-        </Title>
+        </Heading>
 
         <Stack direction="row" alignItems="center" spacing="rec-sm" mb="rec-md">
           <Switch

package/src/Version.tsx

@@ -1,6 +1,6 @@
 import ReactMarkdown from "react-markdown";
 import { Paper, Divider } from "@mui/material";
-import { Container, Title, Group, Link, Box } from "./components";
+import { Container, Heading, Group, Link, Box } from "./components";
 import pkg from "../package.json";
 import changelog from "../CHANGELOG.md?raw";
 
@@ -8,9 +8,9 @@ export const VersionInfo = () => {
   return (
     <Container size="md" style={{ padding: "32px 0" }}>
       <Paper variant="outlined" sx={{ p: 4, borderRadius: 2 }}>
-        <Title order={1} mb={1}>
+        <Heading order={1} mb={1}>
           MUI Adapter v{pkg.version}
-        </Title>
+        </Heading>
         <Group mb={4} gap="rec-md">
           <Link
             href="https://github.com/borderux/recursica"

package/src/components/Card/USAGE.md

@@ -22,7 +22,7 @@ export default function Demo() {
   return (
     <Card>
       <Card.Header>
-        <Title order={3}>Card Title</Title>
+        <Heading order={3}>Card Title</Heading>
       </Card.Header>
       <Card.Content>
         <Text>

package/src/components/{Title/Title.stories.tsx → Heading/Heading.stories.tsx}

@@ -1,15 +1,15 @@
 import type { Meta, StoryObj } from "@storybook/react";
-import { Title } from "./Title";
+import { Heading } from "./Heading";
 
-const meta: Meta<typeof Title> = {
-  title: "UI-Kit/Title",
-  component: Title,
+const meta: Meta<typeof Heading> = {
+  title: "UI-Kit/Heading",
+  component: Heading,
   tags: ["autodocs"],
   parameters: {
     docs: {
       description: {
         component:
-          "The semantic `<Title>` abstraction intrinsically links pure `h1-h6` tag generation with exact Recursica design boundaries to preserve SEO and screen reader trees uniformly globally.",
+          "The semantic `<Heading>` abstraction intrinsically links pure `h1-h6` tag generation with exact Recursica design boundaries to preserve SEO and screen reader trees uniformly globally.",
       },
     },
   },
@@ -25,26 +25,26 @@ const meta: Meta<typeof Title> = {
 
 export default meta;
 
-type Story = StoryObj<typeof Title>;
+type Story = StoryObj<typeof Heading>;
 
 export const Default: Story = {
   args: {
     order: 1,
     children: "Semantic H1 Document Boundary",
   },
-  render: ({ ...args }) => <Title {...args} />,
+  render: ({ ...args }) => <Heading {...args} />,
 };
 
 export const StaticVariations: Story = {
   args: {},
   render: () => (
     <div style={{ display: "flex", flexDirection: "column", gap: "24px" }}>
-      <Title order={1}>H1 Title</Title>
-      <Title order={2}>H2 Title</Title>
-      <Title order={3}>H3 Title</Title>
-      <Title order={4}>H4 Title</Title>
-      <Title order={5}>H5 Title</Title>
-      <Title order={6}>H6 Title</Title>
+      <Heading order={1}>H1 Heading</Heading>
+      <Heading order={2}>H2 Heading</Heading>
+      <Heading order={3}>H3 Heading</Heading>
+      <Heading order={4}>H4 Heading</Heading>
+      <Heading order={5}>H5 Heading</Heading>
+      <Heading order={6}>H6 Heading</Heading>
     </div>
   ),
 };

package/src/components/Heading/Heading.test.tsx

@@ -0,0 +1 @@
+// Placeholder for future Heading component tests. Add tests here if/when needed.

package/src/components/{Title/Title.tsx → Heading/Heading.tsx}

@@ -2,13 +2,13 @@ import React, { forwardRef } from "react";
 import { type TypographyProps as MuiTypographyProps } from "@mui/material";
 import { Typography } from "../Typography/Typography";
 import { type RecursicaOverStyled } from "../../utils/filterStylingProps";
-import { type RecursicaTitleProps } from "@recursica/adapter-common";
+import { type RecursicaHeadingProps } from "@recursica/adapter-common";
 
-export type TitleProps = RecursicaOverStyled<
-  Omit<MuiTypographyProps, "variant" | "classes"> & RecursicaTitleProps
+export type HeadingProps = RecursicaOverStyled<
+  Omit<MuiTypographyProps, "variant" | "classes"> & RecursicaHeadingProps
 >;
 
-export const Title = forwardRef<HTMLElement, TitleProps>(function Title(
+export const Heading = forwardRef<HTMLElement, HeadingProps>(function Heading(
   { order = 1, component, ...rest },
   ref,
 ) {
@@ -25,4 +25,4 @@ export const Title = forwardRef<HTMLElement, TitleProps>(function Title(
   );
 });
 
-Title.displayName = "Title";
+Heading.displayName = "Heading";

package/src/components/{Title → Heading}/USAGE.md

@@ -1,13 +1,13 @@
-# Title - Usage Guide
+# Heading - Usage Guide
 
-This document describes how to integrate and use the `Title` component in your projects using `@recursica/mui-adapter`.
+This document describes how to integrate and use the `Heading` component in your projects using `@recursica/mui-adapter`.
 
 ---
 
 ## 1. Import Reference
 
 ```tsx
-import { Title } from "@recursica/mui-adapter";
+import { Heading } from "@recursica/mui-adapter";
 ```
 
 ---
@@ -16,10 +16,10 @@ import { Title } from "@recursica/mui-adapter";
 
 ```tsx
 import React from "react";
-import { Title } from "@recursica/mui-adapter";
+import { Heading } from "@recursica/mui-adapter";
 
 export default function Demo() {
-  return <Title order={1}>This is a Heading 1</Title>;
+  return <Heading order={1}>This is a Heading 1</Heading>;
 }
 ```
 

package/src/components/Heading/index.ts

@@ -0,0 +1 @@
+export * from "./Heading";

package/src/components/Text/Text.stories.tsx

@@ -9,7 +9,7 @@ const meta: Meta<typeof Text> = {
     docs: {
       description: {
         component:
-          "The standard `<Text>` component controls common body sizing scales and implicit paragraphs governed by the active theme layer. For semantic headings (`h1` through `h6`), use `<Title>` instead.",
+          "The standard `<Text>` component controls common body sizing scales and implicit paragraphs governed by the active theme layer. For semantic headings (`h1` through `h6`), use `<Heading>` instead.",
       },
     },
   },

package/src/components/Typography/TYPOGRAPHY_IMPLEMENTATION_NOTES.md

@@ -1,12 +1,12 @@
 # Typography – Implementation Notes
 
-`Typography` is the shared rendering base for both `Text` and `Title` in mui-adapter — anything
+`Typography` is the shared rendering base for both `Text` and `Heading` in mui-adapter — anything
 applied here reaches both components.
 
 ## `.root` `text-wrap: balance` (Matt Massey, 2026-08-28)
 
 **Decision:** Added `text-wrap: balance` via a new `Typography.module.css` `.root` class, merged
-onto the typography class alongside the caller's own `className`. Since both `Text` and `Title`
+onto the typography class alongside the caller's own `className`. Since both `Text` and `Heading`
 render through this component, it covers all `order` heading levels (h1–h6) and paragraph text in
 one place.
 

package/src/components/index.ts

@@ -19,6 +19,7 @@ export * from "./FormControlLayout";
 export * from "./FormControlWrapper";
 export * from "./Grid";
 export * from "./Group";
+export * from "./Heading";
 export * from "./HoverCard";
 export * from "./Label";
 export * from "./Link";
@@ -43,7 +44,6 @@ export * from "./TextArea";
 export * from "./TextField";
 export * from "./TimePicker";
 export * from "./Timeline";
-export * from "./Title";
 export * from "./Toast";
 export * from "./Tooltip";
 export * from "./TransferList";

package/src/index.ts

@@ -75,6 +75,9 @@ export const FormControlLayout = wrapComponent(
 export const FormControlWrapper = wrapComponent(
   rawComponents.FormControlWrapper,
 ) as typeof rawComponents.FormControlWrapper;
+export const Heading = wrapComponent(
+  rawComponents.Heading,
+) as typeof rawComponents.Heading;
 export const HoverCard = wrapComponent(
   rawComponents.HoverCard,
 ) as typeof rawComponents.HoverCard;
@@ -166,9 +169,6 @@ export const Timeline = wrapComponent(
 export const TimelineItem = wrapComponent(
   rawComponents.TimelineItem,
 ) as typeof rawComponents.TimelineItem;
-export const Title = wrapComponent(
-  rawComponents.Title,
-) as typeof rawComponents.Title;
 export const Toast = wrapComponent(
   rawComponents.Toast,
 ) as typeof rawComponents.Toast;

package/src/components/Title/Title.test.tsx

@@ -1 +0,0 @@
-// Placeholder for future Title component tests. Add tests here if/when needed.

package/src/components/Title/index.ts

@@ -1 +0,0 @@
-export * from "./Title";