@common-origin/design-system 1.16.0 → 2.0.0

package/README.md

@@ -1,10 +1,49 @@
 # Common Origin Design System
 
-A production-ready design system built with atomic design principles, design tokens, and WCAG 2.2 AA accessibility compliance. This package provides reusable React components and design tokens for building consistent user interfaces.
+A production-ready, **framework-agnostic** design system built with atomic design principles, design tokens, and WCAG 2.2 AA accessibility compliance. This package provides reusable React components and design tokens for building consistent user interfaces.
+
+## ⚠️ Version 2.0 Breaking Changes
+
+**Version 2.0.0** removes Next.js dependencies, making the design system work in **any React application** (Next.js, Create React App, Vite, etc.).
+
+If you're upgrading from v1.x, see **[MIGRATION-V2.md](./MIGRATION-V2.md)** for the complete migration guide.
+
+**Quick summary:** Components like `Button`, `Breadcrumbs`, and `CardSmall` now accept an optional `linkComponent` prop. Pass your framework's Link component (e.g., Next.js Link, React Router Link) for client-side navigation, or omit it to use standard HTML links.
 
 ## 🚀 Getting Started
 
+### Installation
+
+```bash
+npm install @common-origin/design-system styled-components
+```
+
+### Usage
+
+```tsx
+import { Button, Typography, Stack } from '@common-origin/design-system'
+
+// For Next.js apps, pass Link component for client-side routing
+import Link from 'next/link'
+
+function App() {
+  return (
+    <Stack direction="column" gap="md">
+      <Typography variant="h1">Welcome</Typography>
+      <Button 
+        purpose="link" 
+        url="/about" 
+        linkComponent={Link}
+      >
+        Learn More
+      </Button>
+    </Stack>
+  )
+}
+```
+
 ### Development
+
 ```bash
 # Install dependencies
 npm install

package/dist/components/atoms/Button/Button.d.ts

@@ -10,6 +10,12 @@ export interface BaseButtonProps {
     iconName?: IconName;
     id?: string;
     'data-testid'?: string;
+    /**
+     * Custom link component (e.g., Next.js Link, React Router Link)
+     * Receives href, children, and other props
+     * @example linkComponent={NextLink} or linkComponent={ReactRouterLink}
+     */
+    linkComponent?: React.ComponentType<any>;
 }
 export interface ButtonProps extends BaseButtonProps, Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, keyof BaseButtonProps> {
     purpose?: 'button';

package/dist/components/molecules/Breadcrumbs/Breadcrumbs.d.ts

@@ -6,6 +6,11 @@ interface Breadcrumb {
 interface BreadcrumbsProps {
     breadcrumbs: Breadcrumb[];
     'data-testid'?: string;
+    /**
+     * Custom link component (e.g., Next.js Link)
+     * @example linkComponent={NextLink}
+     */
+    linkComponent?: React.ComponentType<any>;
 }
 export declare const Breadcrumbs: React.FC<BreadcrumbsProps>;
 export {};

package/dist/components/molecules/CardSmall/CardSmall.d.ts

@@ -5,5 +5,10 @@ export type CardSmallProps = {
     subtitle?: string;
     meta?: string;
     href?: string;
+    /**
+     * Custom link component (e.g., Next.js Link)
+     * @example linkComponent={NextLink}
+     */
+    linkComponent?: React.ComponentType<any>;
 };
 export declare const CardSmall: React.FC<CardSmallProps>;

package/dist/index.esm.js

@@ -1,6 +1,5 @@
 import React, { useState, forwardRef, useId, useRef, useEffect, useCallback } from 'react';
 import styled, { keyframes, css } from 'styled-components';
-import Link from 'next/link';
 import { parseISO, format } from 'date-fns';
 
 function _extends() {
@@ -745,7 +744,7 @@ var semantic$a = {
 		h1: "700 3rem/3rem 'Inter', sans-serif",
 		h2: "700 2rem/2.5rem 'Inter', sans-serif",
 		h3: "700 1.75rem/2.25rem 'Inter', sans-serif",
-		h4: "500 1.5rem/2rem 'Inter', sans-serif",
+		h4: "700 1.5rem/2rem 'Inter', sans-serif",
 		h5: "500 1.25rem/1.75rem 'Inter', sans-serif",
 		h6: "500 1.125rem/1.5rem 'Inter', sans-serif",
 		subtitle: "500 1rem/1.5rem 'Inter', sans-serif",
@@ -804,7 +803,7 @@ var AvatarInitials = styled.span.withConfig({
   },
   displayName: "Avatar__AvatarInitials",
   componentId: "sc-ezn4ax-2"
-})(templateObject_3$i || (templateObject_3$i = __makeTemplateObject(["\n  font-family: ", ";\n  font-weight: ", ";\n  font-size: ", ";\n  color: ", ";\n  line-height: 1;\n  text-transform: uppercase;\n  user-select: none;\n"], ["\n  font-family: ", ";\n  font-weight: ", ";\n  font-size: ", ";\n  color: ", ";\n  line-height: 1;\n  text-transform: uppercase;\n  user-select: none;\n"
+})(templateObject_3$h || (templateObject_3$h = __makeTemplateObject(["\n  font-family: ", ";\n  font-weight: ", ";\n  font-size: ", ";\n  color: ", ";\n  line-height: 1;\n  text-transform: uppercase;\n  user-select: none;\n"], ["\n  font-family: ", ";\n  font-weight: ", ";\n  font-size: ", ";\n  color: ", ";\n  line-height: 1;\n  text-transform: uppercase;\n  user-select: none;\n"
 // Helper function to get initials from name
 ])), tokensData.base.fontFamily.body, tokensData.base.fontWeight[3], function (_a) {
   var $size = _a.$size;
@@ -867,7 +866,7 @@ var Avatar = function Avatar(_a) {
     "aria-hidden": "true"
   }, initials));
 };
-var templateObject_1$y, templateObject_2$l, templateObject_3$i;
+var templateObject_1$y, templateObject_2$l, templateObject_3$h;
 
 React.createElement;
 var _a$5 = tokensData.semantic,
@@ -1018,7 +1017,7 @@ var BadgeIndicator = styled.span.withConfig({
   },
   displayName: "Badge__BadgeIndicator",
   componentId: "sc-tjz4pp-1"
-})(templateObject_3$h || (templateObject_3$h = __makeTemplateObject(["\n  position: absolute;\n  top: 0;\n  right: 0;\n  transform: translate(50%, -50%);\n  display: ", ";\n  align-items: center;\n  justify-content: center;\n  min-width: ", ";\n  height: ", ";\n  padding: ", ";\n  border-radius: ", ";\n  line-height: 1;\n  white-space: nowrap;\n  box-shadow: 0 0 0 2px ", ";\n  animation: ", " 0.2s ease-out;\n  \n  ", "\n"], ["\n  position: absolute;\n  top: 0;\n  right: 0;\n  transform: translate(50%, -50%);\n  display: ", ";\n  align-items: center;\n  justify-content: center;\n  min-width: ", ";\n  height: ", ";\n  padding: ", ";\n  border-radius: ", ";\n  line-height: 1;\n  white-space: nowrap;\n  box-shadow: 0 0 0 2px ", ";\n  animation: ", " 0.2s ease-out;\n  \n  ", "\n"])), function (props) {
+})(templateObject_3$g || (templateObject_3$g = __makeTemplateObject(["\n  position: absolute;\n  top: 0;\n  right: 0;\n  transform: translate(50%, -50%);\n  display: ", ";\n  align-items: center;\n  justify-content: center;\n  min-width: ", ";\n  height: ", ";\n  padding: ", ";\n  border-radius: ", ";\n  line-height: 1;\n  white-space: nowrap;\n  box-shadow: 0 0 0 2px ", ";\n  animation: ", " 0.2s ease-out;\n  \n  ", "\n"], ["\n  position: absolute;\n  top: 0;\n  right: 0;\n  transform: translate(50%, -50%);\n  display: ", ";\n  align-items: center;\n  justify-content: center;\n  min-width: ", ";\n  height: ", ";\n  padding: ", ";\n  border-radius: ", ";\n  line-height: 1;\n  white-space: nowrap;\n  box-shadow: 0 0 0 2px ", ";\n  animation: ", " 0.2s ease-out;\n  \n  ", "\n"])), function (props) {
   return props.$isVisible ? 'flex' : 'none';
 }, function (props) {
   return props.$isDot ? '8px' : '16px';
@@ -1074,7 +1073,7 @@ var Badge = function Badge(_a) {
     color: "inverse"
   }, displayCount), /*#__PURE__*/React.createElement(ScreenReaderOnly, null, label)));
 };
-var templateObject_1$w, templateObject_2$k, templateObject_3$h, templateObject_4$e;
+var templateObject_1$w, templateObject_2$k, templateObject_3$g, templateObject_4$e;
 
 React.createElement;
 var StyledBox = styled.div.withConfig({
@@ -1090,7 +1089,7 @@ var StyledBox = styled.div.withConfig({
 }, function (props) {
   return props.$flexDirection && css(templateObject_2$j || (templateObject_2$j = __makeTemplateObject(["flex-direction: ", ";"], ["flex-direction: ", ";"])), props.$flexDirection);
 }, function (props) {
-  return props.$justifyContent && css(templateObject_3$g || (templateObject_3$g = __makeTemplateObject(["justify-content: ", ";"], ["justify-content: ", ";"])), props.$justifyContent);
+  return props.$justifyContent && css(templateObject_3$f || (templateObject_3$f = __makeTemplateObject(["justify-content: ", ";"], ["justify-content: ", ";"])), props.$justifyContent);
 }, function (props) {
   return props.$alignItems && css(templateObject_4$d || (templateObject_4$d = __makeTemplateObject(["align-items: ", ";"], ["align-items: ", ";"])), props.$alignItems);
 }, function (props) {
@@ -1276,7 +1275,7 @@ var BoxTransform = function BoxTransform(props) {
   }, rest), children);
 };
 var Box = BoxTransform;
-var templateObject_1$v, templateObject_2$j, templateObject_3$g, templateObject_4$d, templateObject_5$a, templateObject_6$9, templateObject_7$7, templateObject_8$3, templateObject_9$2, templateObject_10$2, templateObject_11$2, templateObject_12$2, templateObject_13$2, templateObject_14$1, templateObject_15$1, templateObject_16$1, templateObject_17$1, templateObject_18$1, templateObject_19$1, templateObject_20$1, templateObject_21$1, templateObject_22$1, templateObject_23$1, templateObject_24$1, templateObject_25$1, templateObject_26$1, templateObject_27$1, templateObject_28$1, templateObject_29$1, templateObject_30$1, templateObject_31$1, templateObject_32$1, templateObject_33$1, templateObject_34$1, templateObject_35$1, templateObject_36, templateObject_37, templateObject_38, templateObject_39, templateObject_40, templateObject_41, templateObject_42, templateObject_43;
+var templateObject_1$v, templateObject_2$j, templateObject_3$f, templateObject_4$d, templateObject_5$a, templateObject_6$9, templateObject_7$7, templateObject_8$3, templateObject_9$2, templateObject_10$2, templateObject_11$2, templateObject_12$2, templateObject_13$2, templateObject_14$1, templateObject_15$1, templateObject_16$1, templateObject_17$1, templateObject_18$1, templateObject_19$1, templateObject_20$1, templateObject_21$1, templateObject_22$1, templateObject_23$1, templateObject_24$1, templateObject_25$1, templateObject_26$1, templateObject_27$1, templateObject_28$1, templateObject_29$1, templateObject_30$1, templateObject_31$1, templateObject_32$1, templateObject_33$1, templateObject_34$1, templateObject_35$1, templateObject_36, templateObject_37, templateObject_38, templateObject_39, templateObject_40, templateObject_41, templateObject_42, templateObject_43;
 
 var add = {
 	path: "M13 11H19V13H13V19H11V13H5V11H11V5H13V11Z",
@@ -1303,7 +1302,7 @@ var arrowRight = {
 	name: "arrowRight"
 };
 var bell = {
-	path: "M12.0001 2C15.3561 2 18.1753 4.52384 18.546 7.85938L18.7979 10.125C18.8012 10.1546 18.8024 10.1676 18.8038 10.1797C18.9166 11.1628 19.2372 12.1106 19.7432 12.9609C19.7494 12.9714 19.7553 12.9824 19.7706 13.0078L20.3487 13.9707C20.5997 14.3891 20.829 14.7681 20.9795 15.0879C21.1276 15.4024 21.2852 15.8285 21.209 16.3115C21.1337 16.789 20.8882 17.2229 20.5176 17.5332C20.1426 17.8471 19.6956 17.931 19.3497 17.9658C18.998 18.0012 18.5554 18 18.0674 18H5.93268C5.44476 18 5.00211 18.0012 4.65045 17.9658C4.30456 17.931 3.85755 17.8471 3.48248 17.5332C3.1119 17.2229 2.86641 16.789 2.79107 16.3115C2.7149 15.8285 2.87247 15.4024 3.02057 15.0879C3.17116 14.7681 3.40038 14.3891 3.65143 13.9707L4.22955 13.0078C4.24481 12.9824 4.25068 12.9714 4.25689 12.9609C4.76296 12.1106 5.08348 11.1628 5.19635 10.1797C5.19773 10.1676 5.19892 10.1546 5.20221 10.125L5.45416 7.85938C5.82477 4.52384 8.644 2 12.0001 2ZM12.0001 4C9.6631 4 7.69954 5.75741 7.44146 8.08008L7.18951 10.3457C7.18638 10.3739 7.18457 10.3907 7.18268 10.4072C7.03761 11.6714 6.62638 12.8909 5.97564 13.9844C5.96724 13.9985 5.95885 14.013 5.94439 14.0371L5.36627 15C5.09277 15.4558 4.92766 15.7334 4.83014 15.9404C4.82533 15.9506 4.82155 15.9606 4.81744 15.9697C4.82787 15.971 4.83877 15.9744 4.85064 15.9756C5.07838 15.9985 5.40111 16 5.93268 16H18.0674C18.599 16 18.9217 15.9985 19.1495 15.9756C19.161 15.9744 19.1716 15.9709 19.1817 15.9697C19.1776 15.9607 19.1747 15.9505 19.17 15.9404C19.0725 15.7334 18.9074 15.4558 18.6338 15L18.0557 14.0371C18.0413 14.013 18.0329 13.9985 18.0245 13.9844C17.3737 12.8909 16.9625 11.6714 16.8174 10.4072C16.8155 10.3907 16.8137 10.3739 16.8106 10.3457L16.5587 8.08008C16.3006 5.75741 14.337 4 12.0001 4Z M12.0001 22C10.9897 22 10.0894 21.4972 9.419 20.7256C8.75348 19.9595 8.31404 18.9367 8.11822 17.8408C8.0211 17.2971 8.38314 16.7778 8.92682 16.6807C9.47038 16.5837 9.98987 16.9457 10.087 17.4893C10.233 18.3066 10.5467 18.9742 10.9288 19.4141C11.3063 19.8486 11.6896 20 12.0001 20C12.3106 20 12.6938 19.8486 13.0713 19.4141C13.4535 18.9742 13.7671 18.3066 13.9131 17.4893C14.0102 16.9457 14.5297 16.5837 15.0733 16.6807C15.617 16.7778 15.979 17.2971 15.8819 17.8408C15.6861 18.9367 15.2466 19.9595 14.5811 20.7256C13.9108 21.4972 13.0104 22 12.0001 22Z",
+	path: "M12 2C17.5228 2 22 6.47715 22 12C22 17.5228 17.5228 22 12 22C6.47715 22 2 17.5228 2 12C2 6.47715 6.47715 2 12 2ZM12 4C7.58172 4 4 7.58172 4 12C4 16.4183 7.58172 20 12 20C16.4183 20 20 16.4183 20 12C20 7.58172 16.4183 4 12 4ZM15.707 9.70703L13.4141 12L15.707 14.293L14.293 15.707L12 13.4141L9.70703 15.707L8.29297 14.293L10.5859 12L8.29297 9.70703L9.70703 8.29297L12 10.5859L14.293 8.29297L15.707 9.70703Z",
 	name: "bell"
 };
 var back = {
@@ -1606,16 +1605,6 @@ var StyledLink = styled.a.withConfig({
   displayName: "Button__StyledLink",
   componentId: "sc-1eiuum9-1"
 })(templateObject_2$i || (templateObject_2$i = __makeTemplateObject(["\n  ", "\n  border-radius: ", ";\n  \n  ", "\n  ", "\n"], ["\n  ", "\n  border-radius: ", ";\n  \n  ", "\n  ", "\n"
-// Styled Next.js Link component (modern API without legacyBehavior)
-])), baseButtonStyles, button.primary.borderRadius, getVariantStyles, getSizeStyles);
-// Styled Next.js Link component (modern API without legacyBehavior)
-var StyledNextLink = styled(Link).withConfig({
-  shouldForwardProp: function shouldForwardProp(prop) {
-    return !prop.startsWith('$');
-  },
-  displayName: "Button__StyledNextLink",
-  componentId: "sc-1eiuum9-2"
-})(templateObject_3$f || (templateObject_3$f = __makeTemplateObject(["\n  ", "\n  border-radius: ", ";\n  \n  ", "\n  ", "\n"], ["\n  ", "\n  border-radius: ", ";\n  \n  ", "\n  ", "\n"
 // Helper function to get icon size based on button size
 ])), baseButtonStyles, button.primary.borderRadius, getVariantStyles, getSizeStyles);
 // Helper function to get icon size based on button size
@@ -1652,18 +1641,21 @@ var Button = function Button(_a) {
     children = _a.children,
     target = _a.target,
     iconName = _a.iconName,
+    LinkComponent = _a.linkComponent,
     dataTestId = _a["data-testid"],
-    rest = __rest(_a, ["variant", "size", "url", "purpose", "children", "target", "iconName", 'data-testid']);
-  // For internal links, use Next.js Link (modern API without legacyBehavior)
-  if (purpose === 'link' && url && !url.startsWith('http') && !target) {
-    return /*#__PURE__*/React.createElement(StyledNextLink, {
-      href: url,
+    rest = __rest(_a, ["variant", "size", "url", "purpose", "children", "target", "iconName", "linkComponent", 'data-testid']);
+  // For links with custom link component (e.g., Next.js Link, React Router Link)
+  if (purpose === 'link' && url && LinkComponent) {
+    return /*#__PURE__*/React.createElement(LinkComponent, {
+      href: url
+    }, /*#__PURE__*/React.createElement(StyledLink, {
+      as: "span",
       $variant: variant,
       $size: size,
       "data-testid": dataTestId
-    }, renderButtonContent(children, iconName, size));
+    }, renderButtonContent(children, iconName, size)));
   }
-  // For external links or links with target
+  // For standard links (external or without custom component)
   if (purpose === 'link' && url) {
     var linkProps = rest;
     return /*#__PURE__*/React.createElement(StyledLink, _extends({
@@ -1704,7 +1696,7 @@ var Button = function Button(_a) {
     "data-testid": dataTestId
   }, buttonProps), renderButtonContent(children, iconName, size));
 };
-var templateObject_1$t, templateObject_2$i, templateObject_3$f;
+var templateObject_1$t, templateObject_2$i;
 
 var chip = tokensData.component.chip;
 // Helper function to get variant styles as objects for CSS custom properties
@@ -2735,7 +2727,8 @@ var isInternalUrl = function isInternalUrl(url) {
   return url.startsWith('/') && !url.startsWith('http');
 };
 var Breadcrumbs = function Breadcrumbs(_a) {
-  var breadcrumbs = _a.breadcrumbs;
+  var breadcrumbs = _a.breadcrumbs,
+    LinkComponent = _a.linkComponent;
   return /*#__PURE__*/React.createElement(Container, null, /*#__PURE__*/React.createElement(BreadcrumbNavStyled, {
     "aria-label": "breadcrumb"
   }, /*#__PURE__*/React.createElement("ol", null, breadcrumbs.map(function (breadcrumb, index) {
@@ -2743,15 +2736,16 @@ var Breadcrumbs = function Breadcrumbs(_a) {
       key: index
     }, index === breadcrumbs.length - 1 ? /*#__PURE__*/React.createElement(Typography, {
       variant: "caption"
-    }, breadcrumb.label) : isInternalUrl(breadcrumb.url) ? /*#__PURE__*/React.createElement(Link, {
+    }, breadcrumb.label) : LinkComponent && isInternalUrl(breadcrumb.url) ? /*#__PURE__*/React.createElement(LinkComponent, {
       href: breadcrumb.url
     }, /*#__PURE__*/React.createElement(Typography, {
       variant: "caption"
-    }, breadcrumb.label)) : /*#__PURE__*/React.createElement("a", {
-      href: breadcrumb.url,
+    }, breadcrumb.label)) : /*#__PURE__*/React.createElement("a", _extends({
+      href: breadcrumb.url
+    }, !isInternalUrl(breadcrumb.url) && {
       target: "_blank",
       rel: "noopener noreferrer"
-    }, /*#__PURE__*/React.createElement(Typography, {
+    }), /*#__PURE__*/React.createElement(Typography, {
       variant: "caption"
     }, breadcrumb.label)));
   }))));
@@ -2768,14 +2762,12 @@ var CardSmall = function CardSmall(_a) {
     picture = _a.picture,
     subtitle = _a.subtitle,
     meta = _a.meta,
-    href = _a.href;
+    href = _a.href,
+    LinkComponent = _a.linkComponent;
   if (!picture || !meta) {
     return null;
   }
-  return /*#__PURE__*/React.createElement(CardSmallStyled, null, /*#__PURE__*/React.createElement(Link, {
-    href: href || '#',
-    "aria-label": title
-  }, /*#__PURE__*/React.createElement(Stack, {
+  var content = /*#__PURE__*/React.createElement(Stack, {
     direction: "column",
     gap: "sm"
   }, /*#__PURE__*/React.createElement(Picture, {
@@ -2797,7 +2789,14 @@ var CardSmall = function CardSmall(_a) {
   }, subtitle), meta && /*#__PURE__*/React.createElement(Typography, {
     variant: "label",
     color: "subdued"
-  }, meta))))));
+  }, meta))));
+  return /*#__PURE__*/React.createElement(CardSmallStyled, null, LinkComponent && href ? /*#__PURE__*/React.createElement(LinkComponent, {
+    href: href,
+    "aria-label": title
+  }, content) : /*#__PURE__*/React.createElement("a", {
+    href: href || '#',
+    "aria-label": title
+  }, content));
 };
 var templateObject_1$h;