chore: 🤖 remove leaked styling library types from public api

.changeset/cool-onions-wink.md

@@ -0,0 +1,43 @@
+---
+'@clickhouse/click-ui': patch
+---
+
+Deprecated StyledLinkProps and linkStyles in the public API. These will be removed in a future release to prevent leaking styled-components implementation details, e.g. $size and $weight transient props in the Public API
+
+## Migration Guide (Recommended)
+
+The Link component already:
+- Accepts a component prop to render as any element type
+- Accepts size and weight props
+- Passes through all other props, e.g. onClick, etc.
+
+We recommend migrating away from the deprecated APIs:
+- Replace StyledLinkProps and linkStyles usage
+- Remove the CuiStyledLink styled component definition
+- Use `<Link component={RouterLink} size="md" weight="normal" ...>` directly
+
+Current common consumer pattern uses the deprecated internal styling APIs:
+
+```tsx
+import { Link } from 'react-router-dom';
+import { linkStyles, StyledLinkProps } from '@clickhouse/click-ui';
+
+const CuiStyledLink = styled(Link)<StyledLinkProps>`
+  ${linkStyles}
+`;
+
+<CuiStyledLink $size="md" $weight="normal"
+  to="/path">text</CuiStyledLink>
+```
+
+Recommended Pattern:
+
+```tsx
+import { Link as RouterLink } from 'react-router-dom';
+import { Link } from '@clickhouse/click-ui';
+
+<Link component={RouterLink} size="md" weight="normal"
+to="/path">text</Link>
+```
+
+**Note:** These deprecated APIs will be removed in a future major release. Please migrate before then to avoid breaking changes.

src/index.ts

@@ -153,10 +153,8 @@
 // Label & Link
 export { Label } from './components/Label';
 export { Link } from './components/Link';
-// TODO: This linkStyles require investigation
-export { linkStyles } from './components/Link/common';
 export type { LabelProps } from './components/Label';
-export type { StyledLinkProps } from './components/Link/common';
+export type { LinkProps } from './components/Link';
 
 // Multi Accordion
 export { MultiAccordion } from './components/MultiAccordion';
@@ -217,7 +215,7 @@
 export { Table } from './components/Table';
 export type {
   TableColumnConfigProps,
   TableHeaderType,
   TableProps,
   TableRowType,
 } from './components/Table';
@@ -299,3 +297,22 @@
 export type { DialogProps, DialogTriggerProps } from '@radix-ui/react-dialog';
 export type { HoverCardProps } from '@radix-ui/react-hover-card';
 export type { PopoverProps } from '@radix-ui/react-popover';
+
+// ================================================
+// Deprecated Exports
+// These exports are deprecated and will be removed in a future version.
+// They are kept here temporarily for backward compatibility.
+// ================================================
+
+/**
+ * @deprecated Use the `Link` component with the `component` prop instead.
+ * Example: `<Link component={RouterLink} size="md" weight="normal" to="/path">text</Link>`
+ */
+export { linkStyles } from './components/Link/common';
+
+/**
+ * @deprecated Use the `Link` component with the `component` prop instead.
+ * This type exposes internal styled-components implementation details.
+ * Example: `<Link component={RouterLink} size="md" weight="normal" to="/path">text</Link>`
+ */
+export type { StyledLinkProps } from './components/Link/common';