@ceed/ads 1.35.1 → 1.37.0

package/dist/components/data-display/InfoSign.md

@@ -26,9 +26,7 @@ function MyComponent() {
   return (
     <label>
       Complex Setting
-      <InfoSign
-        message="This setting affects overall system performance. Consult an administrator before making changes."
-      />
+      <InfoSign message="This setting affects overall system performance. Consult an administrator before making changes." />
     </label>
   );
 }

package/dist/components/data-display/Markdown.md

@@ -33,13 +33,7 @@ Markdown is a component that renders markdown-formatted text as styled React com
 import { Markdown } from '@ceed/ads';
 
 function ArticleContent({ content }) {
-  return (
-    <Markdown
-      content={content}
-      defaultLevel="body-md"
-      defaultLinkAction="_blank"
-    />
-  );
+  return <Markdown content={content} defaultLevel="body-md" defaultLinkAction="_blank" />;
 }
 ```
 
@@ -59,14 +53,14 @@ Control the base typography level for the content.
 
 ```tsx
 <Stack spacing={2}>
-  <Markdown {...args} defaultLevel="title-lg" />
-  <Markdown {...args} defaultLevel="title-md" />
-  <Markdown {...args} defaultLevel="title-sm" />
-  <Markdown {...args} defaultLevel="body-lg" />
-  <Markdown {...args} defaultLevel="body-md" />
-  <Markdown {...args} defaultLevel="body-sm" />
-  <Markdown {...args} defaultLevel="body-xs" />
-</Stack>
+    <Markdown {...args} defaultLevel="title-lg" />
+    <Markdown {...args} defaultLevel="title-md" />
+    <Markdown {...args} defaultLevel="title-sm" />
+    <Markdown {...args} defaultLevel="body-lg" />
+    <Markdown {...args} defaultLevel="body-md" />
+    <Markdown {...args} defaultLevel="body-sm" />
+    <Markdown {...args} defaultLevel="body-xs" />
+  </Stack>
 ```
 
 ## Text Alignment
@@ -86,12 +80,12 @@ Apply different color themes to the markdown content.
 
 ```tsx
 <div>
-  <Markdown {...args} color="primary" />
-  <Markdown {...args} color="danger" />
-  <Markdown {...args} color="neutral" />
-  <Markdown {...args} color="success" />
-  <Markdown {...args} color="warning" />
-</div>
+    <Markdown {...args} color="primary" />
+    <Markdown {...args} color="danger" />
+    <Markdown {...args} color="neutral" />
+    <Markdown {...args} color="success" />
+    <Markdown {...args} color="warning" />
+  </div>
 ```
 
 ## Text Color
@@ -100,10 +94,10 @@ Use specific text colors from the theme palette.
 
 ```tsx
 <Stack>
-  <Markdown {...args} textColor="common.black" />
-  <Markdown {...args} textColor="danger.400" />
-  <Markdown {...args} textColor="primary.500" />
-</Stack>
+    <Markdown {...args} textColor="common.black" />
+    <Markdown {...args} textColor="danger.400" />
+    <Markdown {...args} textColor="primary.500" />
+  </Stack>
 ```
 
 ## Accent Color
@@ -112,9 +106,9 @@ Highlight text with custom accent color using `||text||` syntax.
 
 ```tsx
 <Stack spacing={2}>
-  <Markdown {...args} />
-  <Markdown {...args} fontWeight={600} />
-</Stack>
+    <Markdown {...args} />
+    <Markdown {...args} fontWeight={600} />
+  </Stack>
 ```
 
 ## Bold Font Weight
@@ -123,18 +117,18 @@ Customize the weight of bold text.
 
 ```tsx
 <Stack spacing={2}>
-  <Typography fontWeight="normal">Normal:</Typography>
-  <Markdown {...args} />
+    <Typography fontWeight="normal">Normal:</Typography>
+    <Markdown {...args} />
 
-  <Typography fontWeight="sm">SM:</Typography>
-  <Markdown {...args} boldFontWeight="sm" />
-  <Typography fontWeight="md">MD:</Typography>
-  <Markdown {...args} boldFontWeight="md" />
-  <Typography fontWeight="lg">LG:</Typography>
-  <Markdown {...args} boldFontWeight="lg" />
-  <Typography fontWeight="xl">XL:</Typography>
-  <Markdown {...args} boldFontWeight="xl" />
-</Stack>
+    <Typography fontWeight="sm">SM:</Typography>
+    <Markdown {...args} boldFontWeight="sm" />
+    <Typography fontWeight="md">MD:</Typography>
+    <Markdown {...args} boldFontWeight="md" />
+    <Typography fontWeight="lg">LG:</Typography>
+    <Markdown {...args} boldFontWeight="lg" />
+    <Typography fontWeight="xl">XL:</Typography>
+    <Markdown {...args} boldFontWeight="xl" />
+  </Stack>
 ```
 
 ## Strikethrough
@@ -210,28 +204,41 @@ Full demonstration of all GFM features.
 Override the built-in anchor renderer via `markdownOptions.components.a` to detect external links by origin comparison, open them in a new tab, and prepend an `OpenInNew` icon so users can tell external links apart at a glance. Internal links keep `defaultLinkAction` behavior and render without the icon.
 
 ```tsx
-<Markdown {...args} markdownOptions={{
-  components: {
-    a: ({
-      href,
-      children
-    }) => {
-      const isExternal = (() => {
-        if (!href || typeof window === 'undefined') return false;
-        try {
-          return new URL(href, window.location.href).origin !== window.location.origin;
-        } catch {
-          return false;
+<Markdown
+    {...args}
+    markdownOptions={{
+      components: {
+        a: ({ href, children }) => {
+          const isExternal = (() => {
+            if (!href || typeof window === "undefined") return false;
+            try {
+              return new URL(href, window.location.href).origin !== window.location.origin;
+            } catch {
+              return false;
+            }
+          })();
+          return (
+            <Link
+              href={href}
+              target={isExternal ? "_blank" : "_self"}
+              rel={isExternal ? "noopener noreferrer" : undefined}
+              startDecorator={
+                isExternal ? (
+                  <OpenInNew
+                    sx={{
+                      fontSize: "1em"
+                    }}
+                  />
+                ) : undefined
+              }
+            >
+              {children}
+            </Link>
+          );
         }
-      })();
-      return <Link href={href} target={isExternal ? '_blank' : '_self'} rel={isExternal ? 'noopener noreferrer' : undefined} startDecorator={isExternal ? <OpenInNew sx={{
-        fontSize: '1em'
-      }} /> : undefined}>
-      {children}
-    </Link>;
-  }
-}
-}} />
+      }
+    }}
+  />
 ```
 
 ```tsx
@@ -264,7 +271,7 @@ import { Markdown, Link } from '@ceed/ads';
       },
     },
   }}
-/>
+/>;
 ```
 
 ## When to Use
@@ -305,11 +312,7 @@ function ArticlePage({ article }) {
         </Typography>
       </Stack>
       <Divider sx={{ mb: 3 }} />
-      <Markdown
-        content={article.body}
-        defaultLevel="body-md"
-        defaultLinkAction="_blank"
-      />
+      <Markdown content={article.body} defaultLevel="body-md" defaultLinkAction="_blank" />
     </Box>
   );
 }
@@ -331,10 +334,7 @@ function Comment({ comment }) {
             </Typography>
           </Box>
         </Stack>
-        <Markdown
-          content={comment.body}
-          defaultLevel="body-sm"
-        />
+        <Markdown content={comment.body} defaultLevel="body-sm" />
       </CardContent>
     </Card>
   );
@@ -350,11 +350,7 @@ function ReleaseNotes({ version, notes }) {
       <Typography level="h2" sx={{ mb: 2 }}>
         Version {version}
       </Typography>
-      <Markdown
-        content={notes}
-        defaultLevel="body-md"
-        accentColor="success.500"
-      />
+      <Markdown content={notes} defaultLevel="body-md" accentColor="success.500" />
     </Box>
   );
 }
@@ -388,11 +384,7 @@ function HelpArticle({ title, content }) {
       <Typography level="h1" sx={{ mb: 3 }}>
         {title}
       </Typography>
-      <Markdown
-        content={content}
-        defaultLevel="body-md"
-        defaultLinkAction="_blank"
-      />
+      <Markdown content={content} defaultLevel="body-md" defaultLinkAction="_blank" />
     </Container>
   );
 }
@@ -437,10 +429,7 @@ function TaskDetails({ task }) {
         <Typography level="title-lg" sx={{ mb: 2 }}>
           {task.title}
         </Typography>
-        <Markdown
-          content={task.description}
-          defaultLevel="body-sm"
-        />
+        <Markdown content={task.description} defaultLevel="body-sm" />
       </CardContent>
     </Card>
   );
@@ -469,10 +458,7 @@ Make sure to follow the ||coding standards|| and add proper error handling.
 ```tsx
 function NotificationDetail({ notification }) {
   return (
-    <Alert
-      color={notification.type}
-      sx={{ mb: 2 }}
-    >
+    <Alert color={notification.type} sx={{ mb: 2 }}>
       <Markdown
         content={notification.message}
         defaultLevel="body-sm"
@@ -500,11 +486,7 @@ function EmailPreview({ subject, body }) {
           {subject}
         </Typography>
         <Divider sx={{ mb: 2 }} />
-        <Markdown
-          content={body}
-          defaultLevel="body-md"
-          defaultLinkAction="_blank"
-        />
+        <Markdown content={body} defaultLevel="body-md" defaultLinkAction="_blank" />
       </CardContent>
     </Card>
   );
@@ -521,10 +503,7 @@ function APIDocumentation({ endpoint }) {
       <Chip color="primary" sx={{ mb: 2 }}>
         {endpoint.method}
       </Chip>
-      <Markdown
-        content={endpoint.description}
-        defaultLevel="body-md"
-      />
+      <Markdown content={endpoint.description} defaultLevel="body-md" />
     </Box>
   );
 }
@@ -580,7 +559,7 @@ curl -X POST https://api.example.com/users \\
 ## Text Formatting
 
 **Bold text** using `**text**`
-*Italic text* using `*text*`
+_Italic text_ using `*text*`
 ~Strikethrough~ using `~text~`
 `Inline code` using backticks
 ||Accent color|| using `||text||`
@@ -588,7 +567,9 @@ curl -X POST https://api.example.com/users \\
 ## Headings
 
 # Heading 1
+
 ## Heading 2
+
 ### Heading 3
 
 ## Links
@@ -599,16 +580,19 @@ https://auto-linked-url.com
 ## Lists
 
 ### Unordered
+
 - Item 1
 - Item 2
   - Nested item
 
 ### Ordered
+
 1. First
 2. Second
 3. Third
 
 ### Task List
+
 - [x] Completed
 - [ ] Pending
 
@@ -621,6 +605,7 @@ https://auto-linked-url.com
 
 ```javascript
 const code = 'highlighted';
+```
 ````
 
 ## Tables
@@ -705,10 +690,7 @@ Markdown renders semantic HTML elements with proper accessibility:
 ```tsx
 // Links opening in new tabs should have proper attributes
 // The component handles rel="noopener noreferrer" automatically
-<Markdown
-  content="[External link](https://example.com)"
-  defaultLinkAction="_blank"
-/>
+<Markdown content="[External link](https://example.com)" defaultLinkAction="_blank" />
 ```
 
 ### Screen Reader Considerations
@@ -723,7 +705,7 @@ Markdown renders semantic HTML elements with proper accessibility:
 // Ensure sufficient contrast with text colors
 <Markdown
   content="..."
-  textColor="neutral.800"  // Good contrast
+  textColor="neutral.800" // Good contrast
 />
 ```
 
@@ -737,7 +719,7 @@ Markdown renders semantic HTML elements with proper accessibility:
 // ✅ Good: Sanitize before rendering
 import sanitize from 'sanitize-html';
 
-<Markdown content={sanitize(userContent)} />
+<Markdown content={sanitize(userContent)} />;
 ```
 
 2. **Match typography to context**: Use appropriate levels for the content type
@@ -752,20 +734,14 @@ import sanitize from 'sanitize-html';
 
 ```tsx
 // ✅ Good: External links in new tab
-<Markdown
-  content={externalContent}
-  defaultLinkAction="_blank"
-/>
+<Markdown content={externalContent} defaultLinkAction="_blank" />
 ```
 
 4. **Use accent colors meaningfully**: Highlight important information
 
 ```tsx
 // ✅ Good: Highlight key information
-<Markdown
-  content="Your balance is ||$1,234.56||"
-  accentColor="success.500"
-/>
+<Markdown content="Your balance is ||$1,234.56||" accentColor="success.500" />
 ```
 
 ### ❌ Don't
@@ -820,9 +796,7 @@ import sanitize from 'sanitize-html';
 For frequently re-rendering parents, memoize the Markdown component:
 
 ```tsx
-const MemoizedMarkdown = memo(({ content, ...props }) => (
-  <Markdown content={content} {...props} />
-));
+const MemoizedMarkdown = memo(({ content, ...props }) => <Markdown content={content} {...props} />);
 
 function ParentComponent({ content }) {
   return (
@@ -850,7 +824,7 @@ function LazyMarkdown({ content }) {
           observer.disconnect();
         }
       },
-      { threshold: 0.1 }
+      { threshold: 0.1 },
     );
 
     if (ref.current) {
@@ -861,13 +835,7 @@ function LazyMarkdown({ content }) {
   }, []);
 
   return (
-    <Box ref={ref}>
-      {isVisible ? (
-        <Markdown content={content} />
-      ) : (
-        <Skeleton variant="rectangular" height={200} />
-      )}
-    </Box>
+    <Box ref={ref}>{isVisible ? <Markdown content={content} /> : <Skeleton variant="rectangular" height={200} />}</Box>
   );
 }
 ```
@@ -897,11 +865,11 @@ Keep content stable when possible:
 
 ```tsx
 // ❌ Bad: Creating new string on each render
-<Markdown content={`Hello, ${name}!`} />
+<Markdown content={`Hello, ${name}!`} />;
 
 // ✅ Good: Memoize dynamic content
 const content = useMemo(() => `Hello, ${name}!`, [name]);
-<Markdown content={content} />
+<Markdown content={content} />;
 ```
 
 Markdown provides a powerful way to render formatted text content in your application. Use it for documentation, user-generated content, and any scenario requiring rich text display. Always sanitize untrusted content, match typography levels to your context, and consider performance for large documents.