@mindlogic-ai/logician-ui 2.0.0 → 3.0.0-alpha.1

package/src/components/Tag/Tag.stories.tsx

@@ -1,13 +1,26 @@
+import { Box, Flex, Text, VStack } from '@chakra-ui/react';
 import { Meta, StoryObj } from '@storybook/react';
 
-import { Tag } from './Tag';
+import { Tag, tagColorPalettes, tagVariants } from '.';
 import { TagCloseButton } from './TagCloseButton';
 
 const meta = {
   title: 'Components/Tag',
   component: Tag,
   args: {
-    children: 'Insert your tag',
+    children: 'Tag',
+  },
+  argTypes: {
+    colorPalette: {
+      control: 'select',
+      options: tagColorPalettes,
+      description: 'Semantic color of the tag',
+    },
+    variant: {
+      control: 'select',
+      options: tagVariants,
+      description: 'Visual style of the tag',
+    },
   },
 } satisfies Meta<typeof Tag>;
 
@@ -15,17 +28,196 @@ export default meta;
 
 type Story = StoryObj<typeof meta>;
 
-export const Default: Story = {
-  render: (args) => <Tag {...args} />,
+export const Basic: Story = {};
+
+export const Primary: Story = {
+  args: {
+    colorPalette: 'primary',
+    children: 'Primary',
+  },
 };
 
-export const Closable: Story = {
+export const Secondary: Story = {
+  args: {
+    colorPalette: 'secondary',
+    children: 'Secondary',
+  },
+};
+
+export const Success: Story = {
   args: {
-    children: (
-      <>
-        Insert your tag
-        <TagCloseButton />
-      </>
-    ),
+    colorPalette: 'success',
+    children: 'Success',
   },
 };
+
+export const Warning: Story = {
+  args: {
+    colorPalette: 'warning',
+    children: 'Warning',
+  },
+};
+
+export const Danger: Story = {
+  args: {
+    colorPalette: 'danger',
+    children: 'Danger',
+  },
+};
+
+export const Neutral: Story = {
+  args: {
+    colorPalette: 'neutral',
+    children: 'Neutral',
+  },
+};
+
+export const Soft: Story = {
+  args: {
+    colorPalette: 'primary',
+    variant: 'soft',
+    children: 'Soft',
+  },
+};
+
+export const Solid: Story = {
+  args: {
+    colorPalette: 'primary',
+    variant: 'solid',
+    children: 'Solid',
+  },
+};
+
+export const Outline: Story = {
+  args: {
+    colorPalette: 'primary',
+    variant: 'outline',
+    children: 'Outline',
+  },
+};
+
+/**
+ * Tags with close button for removable items.
+ */
+export const Closable: Story = {
+  render: () => (
+    <Flex gap={2} wrap="wrap">
+      {tagColorPalettes.map((colorPalette) => (
+        <Tag key={colorPalette} colorPalette={colorPalette} variant="soft">
+          {colorPalette}
+          <TagCloseButton />
+        </Tag>
+      ))}
+    </Flex>
+  ),
+};
+
+/**
+ * Shows all combinations of colorPalette × variant in a matrix layout.
+ */
+export const AllCombinations: Story = {
+  render: () => (
+    <Box>
+      {/* Header row */}
+      <Flex mb={4} gap={4} align="center">
+        <Box w="100px" />
+        {tagVariants.map((variant) => (
+          <Box key={variant} w="100px" textAlign="center">
+            <Text fontWeight="bold" textStyle="subtext">
+              {variant}
+            </Text>
+          </Box>
+        ))}
+      </Flex>
+
+      {/* Color scheme rows */}
+      {tagColorPalettes.map((colorPalette) => (
+        <Flex key={colorPalette} mb={4} gap={4} align="center">
+          <Box w="100px">
+            <Text fontWeight="medium" textStyle="subtext">
+              {colorPalette}
+            </Text>
+          </Box>
+          {tagVariants.map((variant) => (
+            <Box key={`${colorPalette}-${variant}`} w="100px" textAlign="center">
+              <Tag colorPalette={colorPalette} variant={variant}>
+                Tag
+              </Tag>
+            </Box>
+          ))}
+        </Flex>
+      ))}
+    </Box>
+  ),
+};
+
+/**
+ * Example use case: categorization tags
+ */
+export const Categories: Story = {
+  render: () => (
+    <VStack align="start" gap={4}>
+      <Box>
+        <Text fontWeight="bold" mb={2}>
+          Article Categories
+        </Text>
+        <Flex gap={2} wrap="wrap">
+          <Tag colorPalette="primary" variant="soft">Technology</Tag>
+          <Tag colorPalette="secondary" variant="soft">Design</Tag>
+          <Tag colorPalette="success" variant="soft">Business</Tag>
+          <Tag colorPalette="warning" variant="soft">Opinion</Tag>
+        </Flex>
+      </Box>
+
+      <Box>
+        <Text fontWeight="bold" mb={2}>
+          Task Status
+        </Text>
+        <Flex gap={2} wrap="wrap">
+          <Tag colorPalette="neutral" variant="outline">Draft</Tag>
+          <Tag colorPalette="primary" variant="solid">In Progress</Tag>
+          <Tag colorPalette="warning" variant="soft">Review</Tag>
+          <Tag colorPalette="success" variant="solid">Completed</Tag>
+          <Tag colorPalette="danger" variant="soft">Blocked</Tag>
+        </Flex>
+      </Box>
+
+      <Box>
+        <Text fontWeight="bold" mb={2}>
+          Priority Labels
+        </Text>
+        <Flex gap={2} wrap="wrap">
+          <Tag colorPalette="danger" variant="solid">Critical</Tag>
+          <Tag colorPalette="warning" variant="solid">High</Tag>
+          <Tag colorPalette="primary" variant="soft">Medium</Tag>
+          <Tag colorPalette="neutral" variant="soft">Low</Tag>
+        </Flex>
+      </Box>
+    </VStack>
+  ),
+};
+
+/**
+ * Removable filter tags
+ */
+export const FilterTags: Story = {
+  render: () => (
+    <VStack align="start" gap={4}>
+      <Text fontWeight="bold">Active Filters</Text>
+      <Flex gap={2} wrap="wrap">
+        <Tag colorPalette="primary" variant="soft">
+          Category: Design
+          <TagCloseButton />
+        </Tag>
+        <Tag colorPalette="primary" variant="soft">
+          Status: Active
+          <TagCloseButton />
+        </Tag>
+        <Tag colorPalette="primary" variant="soft">
+          Date: Last 7 days
+          <TagCloseButton />
+        </Tag>
+      </Flex>
+    </VStack>
+  ),
+};

package/src/components/Tag/Tag.styles.ts

@@ -1,12 +1,151 @@
-export const variantStyles = {
-  default: {
-    bgColor: 'gray.50',
-    borderColor: 'gray.400',
-    color: 'gray.1200',
+import { BoxProps } from '@chakra-ui/react';
+
+import { TagColorPalette, TagVariant } from './Tag.types';
+
+/**
+ * Tag styles using a two-dimensional variant system.
+ *
+ * Structure: tagColorPaletteStyles[colorPalette][variant]
+ *
+ * Uses semantic color tokens from the Golden Ratio color system.
+ */
+export const tagColorPaletteStyles: Record<
+  TagColorPalette,
+  Record<TagVariant, BoxProps>
+> = {
+  primary: {
+    soft: {
+      bgColor: 'primary.lightest',
+      borderColor: 'primary.light',
+      color: 'primary.dark',
+    },
+    solid: {
+      bgColor: 'primary.main',
+      borderColor: 'primary.main',
+      color: 'white',
+    },
+    outline: {
+      bgColor: 'transparent',
+      borderColor: 'primary.main',
+      color: 'primary.main',
+    },
   },
-  active: {
-    bgColor: 'primary.light',
-    borderColor: 'primary.main',
-    color: 'primary.dark',
+  secondary: {
+    soft: {
+      bgColor: 'secondary.lightest',
+      borderColor: 'secondary.light',
+      color: 'secondary.dark',
+    },
+    solid: {
+      bgColor: 'secondary.main',
+      borderColor: 'secondary.main',
+      color: 'white',
+    },
+    outline: {
+      bgColor: 'transparent',
+      borderColor: 'secondary.main',
+      color: 'secondary.main',
+    },
   },
+  danger: {
+    soft: {
+      bgColor: 'danger.lightest',
+      borderColor: 'danger.light',
+      color: 'danger.dark',
+    },
+    solid: {
+      bgColor: 'danger.main',
+      borderColor: 'danger.main',
+      color: 'white',
+    },
+    outline: {
+      bgColor: 'transparent',
+      borderColor: 'danger.main',
+      color: 'danger.main',
+    },
+  },
+  success: {
+    soft: {
+      bgColor: 'success.lightest',
+      borderColor: 'success.light',
+      color: 'success.dark',
+    },
+    solid: {
+      bgColor: 'success.main',
+      borderColor: 'success.main',
+      color: 'white',
+    },
+    outline: {
+      bgColor: 'transparent',
+      borderColor: 'success.main',
+      color: 'success.main',
+    },
+  },
+  warning: {
+    soft: {
+      bgColor: 'warning.lightest',
+      borderColor: 'warning.light',
+      color: 'warning.dark',
+    },
+    solid: {
+      bgColor: 'warning.main',
+      borderColor: 'warning.main',
+      color: 'white',
+    },
+    outline: {
+      bgColor: 'transparent',
+      borderColor: 'warning.main',
+      color: 'warning.main',
+    },
+  },
+  neutral: {
+    soft: {
+      bgColor: 'gray.100',
+      borderColor: 'gray.300',
+      color: 'gray.800',
+    },
+    solid: {
+      bgColor: 'gray.800',
+      borderColor: 'gray.800',
+      color: 'white',
+    },
+    outline: {
+      bgColor: 'transparent',
+      borderColor: 'gray.500',
+      color: 'gray.700',
+    },
+  },
+};
+
+/**
+ * Helper function to get tag styles for a given colorPalette and variant.
+ */
+export const getTagStyles = (
+  colorPalette: TagColorPalette = 'neutral',
+  variant: TagVariant = 'soft'
+): BoxProps => {
+  return tagColorPaletteStyles[colorPalette][variant];
 };
+
+/** All available color palettes */
+export const tagColorPalettes: TagColorPalette[] = [
+  'primary',
+  'secondary',
+  'danger',
+  'success',
+  'warning',
+  'neutral',
+];
+
+/**
+ * @deprecated Use tagColorPalettes instead. Will be removed in next major version.
+ */
+export const tagColorSchemes = tagColorPalettes;
+
+/**
+ * @deprecated Use tagColorPaletteStyles instead. Will be removed in next major version.
+ */
+export const tagColorSchemeStyles = tagColorPaletteStyles;
+
+/** All available variants */
+export const tagVariants: TagVariant[] = ['soft', 'solid', 'outline'];

package/src/components/Tag/Tag.tsx

@@ -1,21 +1,47 @@
 import { ForwardedRef, forwardRef } from 'react';
 import { Tag as ChakraTag } from '@chakra-ui/react';
 
-import { variantStyles } from './Tag.styles';
+import { getTagStyles } from './Tag.styles';
 import { TagProps } from './Tag.types';
 
+/**
+ * Tag component for categorization, filtering, and labeling.
+ *
+ * Uses a two-dimensional variant system:
+ * - `colorPalette`: What semantic color (primary, secondary, danger, etc.)
+ * - `variant`: How it looks visually (soft, solid, outline)
+ *
+ * Supports close button via TagCloseButton sub-component.
+ *
+ * @example
+ * ```tsx
+ * <Tag colorPalette="primary">Category</Tag>
+ * <Tag colorPalette="danger" variant="solid">Error</Tag>
+ * <Tag colorPalette="success" variant="outline">
+ *   Completed
+ *   <TagCloseButton />
+ * </Tag>
+ * ```
+ */
 export const Tag = forwardRef(
   (
-    { variant = 'default', ...rest }: TagProps,
+    { colorPalette = 'neutral', variant = 'soft', children, ...rest }: TagProps,
     ref?: ForwardedRef<HTMLDivElement>
   ) => {
+    const styles = getTagStyles(colorPalette, variant);
+
     return (
-      <ChakraTag
+      <ChakraTag.Root
         border="1px solid"
-        {...variantStyles[variant]}
+        borderRadius="md"
+        boxShadow="none"
+        fontSize="sm"
+        {...styles}
         {...rest}
         ref={ref}
-      />
+      >
+        {children}
+      </ChakraTag.Root>
     );
   }
 );

package/src/components/Tag/Tag.types.ts

@@ -1,5 +1,46 @@
-import { TagProps as ChakraTagProps } from '@chakra-ui/react';
+import { BoxProps } from '@chakra-ui/react';
 
-export interface TagProps extends ChakraTagProps {
-  variant?: 'default' | 'active';
+/**
+ * Tag color schemes - determines the semantic color of the tag.
+ *
+ * This prop overrides Chakra UI's native `colorPalette` prop to provide
+ * a controlled set of color options that align with our design system.
+ */
+export type TagColorPalette =
+  | 'primary'
+  | 'secondary'
+  | 'danger'
+  | 'success'
+  | 'warning'
+  | 'neutral';
+
+/**
+ * Tag variants - determines the visual style of the tag.
+ *
+ * - soft: Light background tint with darker text (default)
+ * - solid: Filled background with contrasting text
+ * - outline: Transparent background with colored border
+ */
+export type TagVariant = 'soft' | 'solid' | 'outline';
+
+/**
+ * TagProps uses a two-dimensional variant system:
+ * - `colorPalette`: What semantic color (primary, secondary, danger, etc.)
+ * - `variant`: How it looks visually (soft, solid, outline)
+ *
+ * This matches the Button and Chip component architecture for consistency.
+ *
+ * @example
+ * ```tsx
+ * <Tag colorPalette="primary" variant="soft">Category</Tag>
+ * <Tag colorPalette="danger" variant="solid">Error</Tag>
+ * <Tag colorPalette="success" variant="outline">
+ *   Completed
+ *   <TagCloseButton />
+ * </Tag>
+ * ```
+ */
+export interface TagProps extends Omit<BoxProps, 'colorPalette' | 'variant'> {
+  colorPalette?: TagColorPalette;
+  variant?: TagVariant;
 }

package/src/components/Tag/TagCloseButton/TagCloseButton.tsx

@@ -1,11 +1,15 @@
 import { ForwardedRef, forwardRef } from 'react';
-import { TagCloseButton as ChakraTagCloseButton } from '@chakra-ui/react';
+import { Tag } from '@chakra-ui/react';
 
 import { TagCloseButtonProps } from './TagCloseButton.types';
 
 export const TagCloseButton = forwardRef(
-  ({ ...rest }: TagCloseButtonProps, ref?: ForwardedRef<HTMLDivElement>) => {
-    return <ChakraTagCloseButton {...rest} ref={ref} />;
+  ({ ...rest }: TagCloseButtonProps, ref?: ForwardedRef<HTMLButtonElement>) => {
+    return (
+      <Tag.EndElement>
+        <Tag.CloseTrigger {...rest} ref={ref} />
+      </Tag.EndElement>
+    );
   }
 );
 

package/src/components/Tag/TagCloseButton/TagCloseButton.types.ts

@@ -1,3 +1,3 @@
-import { TagCloseButtonProps as ChakraTagCloseButtonProps } from '@chakra-ui/react';
+import { CloseButtonProps } from '@chakra-ui/react';
 
-export interface TagCloseButtonProps extends ChakraTagCloseButtonProps {}
+export interface TagCloseButtonProps extends CloseButtonProps {}

package/src/components/Tag/TagLabel/TagLabel.tsx

@@ -1,11 +1,11 @@
 import { ForwardedRef, forwardRef } from 'react';
-import { TagLabel as ChakraTagLabel } from '@chakra-ui/react';
+import { Tag } from '@chakra-ui/react';
 
 import { TagLabelProps } from './TagLabel.types';
 
 export const TagLabel = forwardRef(
   ({ ...rest }: TagLabelProps, ref?: ForwardedRef<HTMLDivElement>) => {
-    return <ChakraTagLabel {...rest} ref={ref} />;
+    return <Tag.Label {...rest} ref={ref} />;
   }
 );
 

package/src/components/Tag/TagLeftIcon/TagLeftIcon.tsx

@@ -1,11 +1,14 @@
 import { ForwardedRef, forwardRef } from 'react';
-import { TagLeftIcon as ChakraTagLeftIcon } from '@chakra-ui/react';
+import { Icon } from '@chakra-ui/react';
 
 import { TagLeftIconProps } from './TagLeftIcon.types';
 
+/**
+ * @deprecated In Chakra UI v3, use Icon component directly inside Tag
+ */
 export const TagLeftIcon = forwardRef(
   ({ ...rest }: TagLeftIconProps, ref?: ForwardedRef<SVGSVGElement>) => {
-    return <ChakraTagLeftIcon {...rest} ref={ref} />;
+    return <Icon {...rest} ref={ref} />;
   }
 );
 

package/src/components/Tag/TagRightIcon/TagRightIcon.tsx

@@ -1,12 +1,8 @@
-import { ForwardedRef, forwardRef } from 'react';
-import { TagRightIcon as ChakraTagRightIcon } from '@chakra-ui/react';
+import { Icon } from '@chakra-ui/react';
 
-import { TagRightIconProps } from './TagRightIcon.types';
-
-export const TagRightIcon = forwardRef(
-  ({ ...rest }: TagRightIconProps, ref?: ForwardedRef<SVGSVGElement>) => {
-    return <ChakraTagRightIcon {...rest} ref={ref} />;
-  }
-);
+/**
+ * @deprecated In Chakra UI v3, use Icon component directly inside Tag
+ */
+export const TagRightIcon = Icon;
 
 TagRightIcon.displayName = 'TagRightIcon';

package/src/components/Tag/index.ts

@@ -1,5 +1,11 @@
-export * from './Tag';
-export type * from './Tag.types';
+export { Tag } from './Tag';
+export {
+  getTagStyles,
+  tagColorPalettes,
+  tagColorPaletteStyles,
+  tagVariants,
+} from './Tag.styles';
+export type { TagColorPalette, TagProps, TagVariant } from './Tag.types';
 export * from './TagCloseButton';
 export * from './TagLabel';
 export * from './TagLeftIcon';

package/src/components/Textarea/Textarea.stories.tsx

@@ -1,7 +1,7 @@
 import { Meta, StoryObj } from '@storybook/react';
 import { useState } from 'react';
 
-import { AutosizeTextarea, Textarea } from '.';
+import { Textarea } from '.';
 
 const meta = {
   title: 'Components/Textarea',
@@ -14,12 +14,8 @@ const meta = {
         options: ['sm', 'md', 'lg'],
       },
     },
-    isDisabled: { control: 'boolean' },
-    isInvalid: { control: 'boolean' },
+    disabled: { control: 'boolean' },
     maxLength: { control: 'number' },
-    minRows: { control: 'number' },
-    maxRows: { control: 'number' },
-    preFocusMaxRows: { control: 'number' },
   },
   render: (args) => {
     const [value, setValue] = useState('');
@@ -42,42 +38,37 @@ type Story = StoryObj<typeof Textarea>;
 export const Basic: Story = {
   args: {
     size: 'md',
-    isDisabled: false,
-    isInvalid: false,
+    disabled: false,
     maxLength: 200,
   },
 };
 
 export const Disabled: Story = {
   args: {
-    isDisabled: true,
+    disabled: true,
     placeholder: 'Disabled textarea',
   },
 };
 
 export const Invalid: Story = {
   args: {
-    isInvalid: true,
     placeholder: 'Invalid state',
-  },
-};
-
-export const Autosize: Story = {
-  args: {
-    minRows: 6,
-    preFocusMaxRows: 8,
-    maxRows: 12,
+    invalid: true,
   },
   render: (args) => {
     const [value, setValue] = useState('');
 
     return (
-      <AutosizeTextarea
-        {...args}
-        value={value}
-        onChange={(e) => setValue(e.target.value)}
-        placeholder={args.placeholder ?? 'Autosize textarea...'}
-      />
+      <div style={{ display: 'flex', flexDirection: 'column', gap: '8px' }}>
+        <Textarea
+          {...args}
+          value={value}
+          onChange={(e) => setValue(e.target.value)}
+        />
+        <span style={{ color: '#D01721', fontSize: '14px' }}>
+          This field contains an error. Please fix it.
+        </span>
+      </div>
     );
   },
 };