@xyd-js/components 0.1.0-xyd.6 → 0.1.0-xyd.64

package/src/writer/Table/Table.tsx

@@ -1,45 +1,155 @@
 import React from "react"
 
-import {$table} from "./Table.styles";
+import cn from "./Table.styles";
 
+/**
+ * Props for the Table component
+ */
 export interface TableProps {
+    /** The content to be rendered inside the table */
+    children: React.ReactNode;
+
+    /** Optional CSS class name to be applied to the table */
+    className?: string;
+}
+
+/**
+ * A table component that provides a structured way to display tabular data.
+ * It supports custom styling through className prop and can contain various table elements.
+ * 
+ * @category Component
+ */
+export function Table({ children, className }: TableProps) {
+    return (
+        <table className={`${cn.Host} ${className || ''}`}>
+            {children}
+        </table>
+    );
+}
+
+/**
+ * Props for the TableHead component
+ */
+export interface TableHeadProps {
+    /** The content to be rendered inside the table header */
     children: React.ReactNode;
 }
 
-export function Table({children}: TableProps) {
-    return <table className={$table.host}>
+/**
+ * Represents the header section of a table.
+ * Use this component to group header content at the top of the table.
+ */
+Table.Head = function TableHead({ children }: TableHeadProps) {
+    return <thead className={cn.Thead}>
         {children}
-    </table>
+    </thead>
 }
 
+/**
+ * Props for the TableTh component
+ */
 export interface TableThProps {
+    /** The content to be rendered inside the table header cell */
     children: React.ReactNode;
+    
+    /** Whether the cell content should be right-aligned (for numeric values) */
+    numeric?: boolean;
 }
 
-Table.Th = function TableTh({children}: TableThProps) {
-    return <th className={$table.th}>
+/**
+ * Represents a header cell in the table.
+ * Use this component for column headers in the table.
+ */
+Table.Th = function TableTh({ children, numeric }: TableThProps) {
+    return <th className={`${cn.Th} ${numeric ? 'numeric' : ''}`}>
         {children}
     </th>
 }
 
+/**
+ * Props for the TableTr component
+ */
 export interface TableTrProps {
+    /** The content to be rendered inside the table row */
     children: React.ReactNode;
 }
 
-Table.Tr = function TableTr({children}: TableTrProps) {
-    return <tr className={$table.tr}>
+/**
+ * Represents a row in the table.
+ * Use this component to create rows in the table body or header.
+ */
+Table.Tr = function TableTr({ children }: TableTrProps) {
+    return <tr className={cn.Tr}>
         {children}
     </tr>
+}
+
+/**
+ * Props for the TableBody component
+ */
+export interface TableBodyProps {
+    /** The content to be rendered inside the table body */
+    children: React.ReactNode;
+}
 
+/**
+ * Represents the main content area of the table.
+ * Use this component to group the main content rows of the table.
+ */
+Table.Body = function TableBody({ children }: TableBodyProps) {
+    return <tbody className={cn.Tbody}>
+        {children}
+    </tbody>
 }
 
+/**
+ * Props for the TableTd component
+ */
 export interface TableTdProps {
+    /** The content to be rendered inside the table cell */
     children: React.ReactNode;
+
+    /** Whether the cell content should be right-aligned (for numeric values) */
+    numeric?: boolean;
+    
+    /** Whether the cell should have a muted appearance */
+    muted?: boolean;
 }
 
-Table.Td = function TableTd({children}: TableTdProps) {
-    return <td className={$table.td}>
+/**
+ * Represents a data cell in the table.
+ * Use this component for regular data cells in the table body.
+ */
+Table.Td = function TableTd({ children, numeric, muted }: TableTdProps) {
+    return <td className={`${cn.Td} ${numeric ? 'numeric' : ''} ${muted ? 'muted' : ''}`}>
         {children}
     </td>
+}
+
+/**
+ * Props for the TableCell component
+ */
+export interface TableCellProps {
+    /** The content to be rendered inside the table cell */
+    children: React.ReactNode;
+}
+
+/**
+ * A custom table cell component that wraps content in a div with specific styling.
+ * Use this component when you need a custom-styled cell with additional structure.
+ */
+Table.Cell = function TableCell({ children }: TableCellProps) {
+    return <xyd-table-cell className={cn.Cell}>
+        <div part="child">
+            {children}
+        </div>
+    </xyd-table-cell>
+}
 
-}
+/**
+ * Props for the TableModelCell component
+ */
+export interface TableModelCellProps {
+    /** The content to be rendered inside the model cell */
+    children: React.ReactNode;
+}

package/src/writer/Table/index.ts

@@ -1,10 +1,3 @@
 export {
     Table
 } from "./Table"
-
-export type {
-    TableProps,
-    TableThProps,
-    TableTrProps,
-    TableTdProps
-} from "./Table"

package/src/writer/Tabs/Tabs.styles.tsx

@@ -1,77 +1,70 @@
 import {css} from "@linaria/core";
 
-export const $sample = {
-    host: css`
+export const TabsSampleHost = css`
+    @layer defaults {
+        display: block;
         position: relative;
         max-width: 100%;
-    `,
-    buttons: css`
-        display: flex;
-        align-items: center;
-    `,
-    content: css`
-        margin-top: 16px;
-    `
-}
-
-export const $arrow = {
-    host: css`
-        padding: 8px;
-        background-color: #ffffff;
-        box-shadow: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
-    `,
-    icon: css`
-        width: 16px;
-        height: 16px;
-    `
-}
-
-export const $scroller = {
-    host: css`
-        overflow-x: auto;
-        flex-grow: 1;
-    `,
-    container: css`
-        display: inline-flex;
-        gap: 4px;
-
-        border-radius: 8px;
-        background-color: #F3F4F6;
-        
-        padding: 4px;
-        margin-left: 4px;
-    `
-}
-
-export const $button = {
-    host: css`
-        padding: 0.5rem 1rem;
-
-        border-radius: 0.375rem;
-        font-size: 0.875rem;
-        line-height: 1.25rem;
-        font-weight: 500;
-        white-space: nowrap;
-
-        transition-property: color, background-color, border-color, text-decoration-color, fill, stroke;
-        transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
-        transition-duration: 300ms;
-
-        color: #6B7280;
-
-        &:hover {
-            color: #111827;
+
+        [part="buttons"] {
+            display: flex;
+            align-items: center;
+        }
+
+        [part="arrow"] {
+            padding: 8px;
+            background-color: var(--xyd-tabs-arrow-bgcolor);
+            box-shadow: 0 1px 2px 0 var(--xyd-tabs-shadow-color--active);
+        }
+
+        [part="arrow-icon"] {
+            width: 16px;
+            height: 16px;
         }
 
-        &[data-state="active"] {
-            color: #111827;
-            background-color: #ffffff;
-            box-shadow: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
+        [part="scroller"] {
+            overflow-x: auto;
+            flex-grow: 1;
         }
-    `,
-    $$active: css`
-        color: #111827;
-        background-color: #ffffff;
-        box-shadow: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
-    `
-}
+
+        [part="scroller-container"] {
+            display: inline-flex;
+            gap: 4px;
+
+            border-radius: 8px;
+            background-color: var(--xyd-tabs-bgcolor);
+            
+            padding: 4px;
+            margin-left: 4px;
+        }
+
+        [part="button"] {
+            padding: 5px 16px;
+
+            border-radius: 0.375rem;
+            white-space: nowrap;
+
+            transition-property: color, background-color, border-color, text-decoration-color, fill, stroke;
+            transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
+            transition-duration: 300ms;
+
+            color: var(--xyd-tabs-color);
+
+            &:hover {
+                color: var(--xyd-tabs-color--active);
+            }
+
+            &[data-state="active"] {
+                color: var(--xyd-tabs-color--active);
+                background-color: var(--xyd-tabs-bgcolor--active);
+                box-shadow: 0 1px 2px 0 var(--xyd-tabs-shadow-color--active);
+            }
+        }
+
+        [part="content"] {
+            margin-top: 16px;
+        }
+    }
+`;
+
+

package/src/writer/Tabs/Tabs.tsx

@@ -1,21 +1,17 @@
-import React, {useState, useRef, useEffect} from 'react'
-import * as RadixTabs from "@radix-ui/react-tabs"
-import {ChevronLeft, ChevronRight} from "lucide-react"
+import React, { useState, useRef, useEffect } from 'react'
+import {Tabs as RadixTabs} from "radix-ui"; // TODO: remove and use separation
+import { ChevronLeft, ChevronRight } from "lucide-react"
 
-import {
-    $sample,
-    $arrow,
-    $scroller,
-    $button
-} from "./Tabs.styles";
+import * as cn from "./Tabs.styles";
 
 export interface TabsProps {
     children: React.ReactNode;
     items: string[];
     tabIndex?: number;
+    className?: string;
 }
 
-export function Tabs({children, items, tabIndex}: TabsProps) {
+export function Tabs({ children, items, tabIndex, className }: TabsProps) {
     const [showLeftArrow, setShowLeftArrow] = useState(false)
     const [showRightArrow, setShowRightArrow] = useState(false)
     const scrollContainerRef = useRef<HTMLDivElement>(null)
@@ -24,7 +20,7 @@ export function Tabs({children, items, tabIndex}: TabsProps) {
 
     const handleScroll = () => {
         if (scrollContainerRef.current) {
-            const {scrollLeft, scrollWidth, clientWidth} = scrollContainerRef.current
+            const { scrollLeft, scrollWidth, clientWidth } = scrollContainerRef.current
             setShowLeftArrow(scrollLeft > 0)
             setShowRightArrow(scrollLeft < scrollWidth - clientWidth)
         }
@@ -39,33 +35,37 @@ export function Tabs({children, items, tabIndex}: TabsProps) {
     const scroll = (direction: 'left' | 'right') => {
         if (scrollContainerRef.current) {
             const scrollAmount = direction === 'left' ? -200 : 200
-            scrollContainerRef.current.scrollBy({left: scrollAmount, behavior: 'smooth'})
+            scrollContainerRef.current.scrollBy({ left: scrollAmount, behavior: 'smooth' })
         }
     }
 
     return (
         <RadixTabs.Root asChild value={value} onValueChange={setActiveTab}>
-            <div className={$sample.host}>
-                <div className={$sample.buttons}>
+            <xyd-tabs
+                className={`${cn.TabsSampleHost} ${className || ""}`}
+            >
+                <div part="buttons">
                     {showLeftArrow && (
                         <button
                             onClick={() => scroll('left')}
-                            className={$arrow.host}
+                            part="arrow"
                         >
-                            <ChevronLeft className={$arrow.icon}/>
+                            <ChevronLeft part="arrow-icon" />
                         </button>
                     )}
 
                     <div
                         ref={scrollContainerRef}
                         onScroll={handleScroll}
-                        className={$scroller.host}
+                        part="scroller"
                     >
-                        <div className={$scroller.container}>
+                        <div
+                            part="scroller-container"
+                        >
                             <RadixTabs.List>
-                                {items.map((item, index) => <TabsItem key={index} value={item}>
-                                        {item}
-                                    </TabsItem>
+                                {items.map((item, index) => <$TabsItem key={index} value={item}>
+                                    {item}
+                                </$TabsItem>
                                 )}
                             </RadixTabs.List>
                         </div>
@@ -74,31 +74,33 @@ export function Tabs({children, items, tabIndex}: TabsProps) {
                     {showRightArrow && (
                         <button
                             onClick={() => scroll('right')}
-                            className={$arrow.host}
+                            part="arrow"
                         >
-                            <ChevronRight className={$arrow.icon}/>
+                            <ChevronRight part="arrow-icon" />
                         </button>
                     )}
                 </div>
 
-                <div className={$sample.content}>
+                <div part="content">
                     {children}
                 </div>
-            </div>
+            </xyd-tabs>
         </RadixTabs.Root>
     )
 }
 
-function TabsItem({children, value}) {
+function $TabsItem({ children, value }) {
     return <RadixTabs.Trigger asChild value={value}>
-        <button className={`${$button.host}`}>
+        <button part="button">
             {children}
         </button>
     </RadixTabs.Trigger>
 }
 
-Tabs.Content = function TabsContent({children, value}) {
+Tabs.Content = function TabsContent({ children, value }) {
     return <RadixTabs.Content asChild value={value}>
-        {children}
+        <div>
+            {children}
+        </div>
     </RadixTabs.Content>
 }

package/src/writer/Text/Text.styles.tsx

@@ -0,0 +1,66 @@
+import { css } from "@linaria/core";
+
+export const TextHost = css`
+    @layer defaults {
+        display: inline-block;
+        margin: 0;
+
+        &[data-size="xsmall"] { 
+            font-size: var(--xyd-font-size-xsmall);
+            line-height: var(--xyd-line-height-xsmall);
+        }
+        &[data-size="small"] { 
+            font-size: var(--xyd-font-size-small);
+            line-height: var(--xyd-line-height-small);
+        }
+        &[data-size="medium"] { 
+            font-size: var(--xyd-font-size-medium);
+            line-height: var(--xyd-line-height-medium);
+        }
+        &[data-size="large"] { 
+            font-size: var(--xyd-font-size-large);
+            line-height: var(--xyd-line-height-large);
+        }
+        &[data-size="xlarge"] { 
+            font-size: var(--xyd-font-size-xlarge);
+            line-height: var(--xyd-line-height-xlarge);
+        }
+        &[data-size="xxlarge"] { 
+            font-size: var(--xyd-font-size-xxlarge);
+            line-height: var(--xyd-line-height-xxlarge);
+        }
+
+        &[data-kind="default"] { 
+            color: var(--xyd-text-color--default);
+        }
+        &[data-kind="ghost"] { 
+            color: var(--xyd-text-color--ghost);
+        }
+        &[data-kind="success"] { 
+            color: var(--xyd-text-color--success);
+        }
+        &[data-kind="warn"] { 
+            color: var(--xyd-text-color--warn);
+        }
+        &[data-kind="error"] { 
+            color: var(--xyd-text-color--error);
+        }
+        &[data-kind="primary"] { 
+            color: var(--xyd-text-color--primary);
+        }
+        &[data-kind="secondary"] { 
+            color: var(--xyd-text-color--secondary);
+        }
+
+        &[data-weight="normal"] { 
+            font-weight: var(--xyd-font-weight-normal);
+        }
+        &[data-weight="bold"] { 
+            font-weight: var(--xyd-font-weight-medium);
+        }
+        &[data-weight="extra-bold"] { 
+            font-weight: var(--xyd-font-weight-semibold);
+        }
+    }
+`;
+

package/src/writer/Text/Text.tsx

@@ -0,0 +1,79 @@
+import React from "react"
+
+import * as cn from "./Text.styles";
+
+/**
+ * Available font sizes for the Text component
+ */
+export type TextFontSizes = "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge";
+
+/**
+ * Available text styles/kinds for the Text component
+ */
+export type TextKindTypes = "default" | "ghost" | "success" | "warn" | "error" | "primary" | "secondary";
+
+/**
+ * Available font weights for the Text component
+ */
+export type TextFontWeights = "normal" | "bold" | "extra-bold";
+
+/**
+ * Props for the Text component
+ */
+export interface TextProps {
+    /** Font size of the text */
+    size?: TextFontSizes
+
+    /** Visual style/kind of the text */
+    kind?: TextKindTypes
+
+    /** Font weight of the text */
+    weight?: TextFontWeights
+
+    /** Content to be rendered inside the text component */
+    children?: React.ReactNode
+
+    /** Additional CSS class name */
+    className?: string
+
+    /** HTML id attribute */
+    id?: string
+    
+    /** Click event handler */
+    onClick?: () => void
+    
+    /** HTML tag to render the text as */
+    as?: "span" | "p"
+}
+
+/**
+ * A flexible text component that supports different sizes, styles, and weights.
+ * 
+ * @category Component
+ */
+export function Text({
+    size = "medium",
+    kind = "default",
+    weight = "normal",
+    children,
+    className,
+    id,
+    onClick,
+    as = "p"
+}: TextProps) {
+    const Tag = as || "p";
+
+    return (
+        <Tag
+            className={`${cn.TextHost} ${className || ''}`}
+            data-size={size}
+            data-kind={kind}
+            data-weight={weight}
+            onClick={onClick}
+            id={id}
+        >
+            {children}
+        </Tag>
+    )
+}
+

package/src/writer/Text/index.ts

@@ -0,0 +1,3 @@
+export {
+    Text
+} from "./Text";

package/src/writer/TocCard/TocCard.module.css

@@ -0,0 +1,44 @@
+@layer defaults {
+    .TocCardHost {
+        display: block;
+        max-width: 250px;
+    
+        [part="container"] {
+        }
+    
+        [part="description"] {
+            color: var(--xyd-toccard-color);
+            letter-spacing: 0;
+        }
+    
+        [part="link"] {
+            display: block;
+            border: 1px solid var(--xyd-toccard-border-color);
+            border-radius: 6px;
+            padding: 8px 16px 12px;
+            text-decoration: none;
+    
+            &:hover {
+                border-color: var(--xyd-toccard-border-color--active);
+            }
+        }
+    
+        [part="title-container"] {
+            display: flex;
+            align-items: center;
+            justify-content: space-between;
+        }
+    
+        [part="title"] {
+            color: var(--xyd-toccard-title-color);
+            margin-bottom: 2px;
+        }
+    
+        [part="link-icon"] {
+            width: 1em;
+            height: 1em;
+            object-fit: contain;
+            color: var(--xyd-toccard-icon-color);
+        }
+    }
+}

package/src/writer/TocCard/TocCard.tsx

@@ -0,0 +1,42 @@
+import React from "react";
+
+import cn from "./TocCard.module.css";
+import { Icon } from "writer";
+
+interface TocCardProps {
+    title: string;
+    description: string;
+    href: string;
+    className?: string;
+    icon?: string;
+    as?: React.ElementType;
+}
+
+export function TocCard({ title, description, href, className, icon, as }: TocCardProps) {
+    const Link = as || $Link;
+
+    return <xyd-toccard
+        className={`${cn.TocCardHost} ${className || ""}`}
+    >
+        <div part="container">
+            <Link
+                part="link"
+                href={href}
+                target="_blank"
+                rel="noreferrer"
+            >
+                <div part="title-container">
+                    <div part="title">{title}</div>
+                    {icon && <Icon name={icon} size={16} />}
+                </div>
+                <div part="description">
+                    {description}
+                </div>
+            </Link>
+        </div>
+    </xyd-toccard>
+}
+
+function $Link({ children, href, ...props }: React.ComponentProps<'a'>) {
+    return <a href={href} {...props}>{children}</a>
+}

package/src/writer/TocCard/index.ts

@@ -0,0 +1,3 @@
+export {
+    TocCard
+} from "./TocCard";