@bettercms-ai/kit 0.1.0

package/src/core/primitives/switch/switch.tsx

@@ -0,0 +1,68 @@
+import {forwardRef, useEffect, useImperativeHandle, useRef} from 'react'
+import {styled} from 'styled-components'
+
+import {
+  switchBaseStyles,
+  switchInputStyles,
+  switchRepresentationStyles,
+  switchThumbStyles,
+  switchTrackStyles,
+} from './styles'
+
+/**
+ * @public
+ */
+export interface SwitchProps {
+  indeterminate?: boolean
+}
+
+const StyledSwitch = styled.span(switchBaseStyles)
+const Input = styled.input(switchInputStyles)
+const Representation = styled.span(switchRepresentationStyles)
+const Track = styled.span(switchTrackStyles)
+const Thumb = styled.span<{$checked?: boolean; $indeterminate?: boolean}>(switchThumbStyles)
+
+/**
+ * The `Switch` component allows the user to toggle a setting on and off.
+ *
+ * Extends all properties of an `<input type="checkbox" />` element, except type.
+ *
+ * @public
+ */
+export const Switch = forwardRef(function Switch(
+  props: Omit<React.HTMLProps<HTMLInputElement>, 'as' | 'type'> & SwitchProps,
+  forwardedRef: React.ForwardedRef<HTMLInputElement>,
+) {
+  const {checked, className, disabled, indeterminate, readOnly, style, ...restProps} = props
+  const ref = useRef<HTMLInputElement | null>(null)
+
+  useImperativeHandle<HTMLInputElement | null, HTMLInputElement | null>(
+    forwardedRef,
+    () => ref.current,
+  )
+
+  useEffect(() => {
+    if (ref.current) {
+      // Set the indeterminate state
+      ref.current.indeterminate = indeterminate || false
+    }
+  }, [indeterminate])
+
+  return (
+    <StyledSwitch className={className} data-ui="Switch" style={style}>
+      <Input
+        data-read-only={!disabled && readOnly ? '' : undefined}
+        {...restProps}
+        checked={indeterminate !== true && checked}
+        disabled={disabled || readOnly}
+        type="checkbox"
+        ref={ref}
+      />
+      <Representation aria-hidden data-name="representation">
+        <Track />
+        <Thumb $checked={checked} $indeterminate={indeterminate} />
+      </Representation>
+    </StyledSwitch>
+  )
+})
+Switch.displayName = 'ForwardRef(Switch)'

package/src/core/primitives/text/__workshop__/colored.tsx

@@ -0,0 +1,30 @@
+import {Flex, Text, ThemeProps} from '@bettercms-ai/kit'
+import {getTheme_v2, ThemeColorAvatarColorKey, ThemeColorSpotKey} from '@bettercms-ai/kit/theme'
+import {useSelect} from '@bettercms-ai/kit-workshop'
+import {css, styled} from 'styled-components'
+
+import {WORKSHOP_SPOT_COLOR_OPTIONS} from '../../../__workshop__/constants'
+
+const ColoredText = styled(Text)<{$color?: ThemeColorSpotKey}>((
+  props: {
+    $color?: ThemeColorAvatarColorKey
+  } & ThemeProps,
+) => {
+  const {color} = getTheme_v2(props.theme)
+
+  return css`
+    color: ${color.avatar[props.$color || 'gray'].bg};
+  `
+})
+
+export default function ColoredTextStory() {
+  const color = useSelect('Color', WORKSHOP_SPOT_COLOR_OPTIONS, 'gray')
+
+  return (
+    <Flex align="center" height="fill" justify="center" padding={[4, 5, 6]} sizing="border">
+      <ColoredText align="center" $color={color} size={4} weight="bold">
+        {color}
+      </ColoredText>
+    </Flex>
+  )
+}

package/src/core/primitives/text/__workshop__/example.tsx

@@ -0,0 +1,39 @@
+import {Container, Flex, Text} from '@bettercms-ai/kit'
+import {useBoolean, useSelect, useText} from '@bettercms-ai/kit-workshop'
+
+import {
+  WORKSHOP_TEXT_ALIGN_OPTIONS,
+  WORKSHOP_TEXT_OVERFLOW_OPTIONS,
+  WORKSHOP_TEXT_SIZE_OPTIONS,
+  WORKSHOP_TEXT_WEIGHT_OPTIONS,
+} from '../../../__workshop__/constants'
+
+export default function TextStory() {
+  const accent = useBoolean('Accent', false, 'Props')
+  const align = useSelect('Align', WORKSHOP_TEXT_ALIGN_OPTIONS, '', 'Props') || undefined
+  const muted = useBoolean('Muted', false, 'Props')
+  const size = useSelect('Size', WORKSHOP_TEXT_SIZE_OPTIONS, 1, 'Props')
+  const text = useText('Text', 'Hello, world', 'Props')
+
+  const textOverflow =
+    useSelect('Text overflow', WORKSHOP_TEXT_OVERFLOW_OPTIONS, undefined, 'Props') || undefined
+
+  const weight = useSelect('Weight', WORKSHOP_TEXT_WEIGHT_OPTIONS, '', 'Props') || undefined
+
+  return (
+    <Flex align="center" height="fill" justify="center" padding={4} sizing="border">
+      <Container width={0}>
+        <Text
+          accent={accent}
+          align={align}
+          muted={muted}
+          size={size}
+          textOverflow={textOverflow}
+          weight={weight}
+        >
+          {text}
+        </Text>
+      </Container>
+    </Flex>
+  )
+}

package/src/core/primitives/text/__workshop__/index.ts

@@ -0,0 +1,24 @@
+import {defineScope} from '@bettercms-ai/kit-workshop'
+import {lazy} from 'react'
+
+export default defineScope({
+  name: 'primitives/text',
+  title: 'Text',
+  stories: [
+    {
+      name: 'default',
+      title: 'Text',
+      component: lazy(() => import('./example')),
+    },
+    {
+      name: 'colored',
+      title: 'Colored text',
+      component: lazy(() => import('./colored')),
+    },
+    {
+      name: 'optical-alignment',
+      title: 'Optical alignment',
+      component: lazy(() => import('./opticalAlignment')),
+    },
+  ],
+})

package/src/core/primitives/text/__workshop__/opticalAlignment.tsx

@@ -0,0 +1,48 @@
+import {AddCircleIcon} from '@bettercms-ai/icons'
+import {Box, Card, Flex, Stack, Text} from '@bettercms-ai/kit'
+
+export default function OpticalAlignment() {
+  return (
+    <Box padding={[4, 5, 6]}>
+      <Stack space={1}>
+        <Flex>
+          <Card padding={0} tone="neutral">
+            <Text size={4}>Hamburgefonstiv M</Text>
+          </Card>
+        </Flex>
+
+        <Flex>
+          <Card padding={0} tone="neutral">
+            <Text size={3}>Hamburgefonstiv M</Text>
+          </Card>
+        </Flex>
+
+        <Flex>
+          <Card padding={0} tone="neutral">
+            <Text size={2}>Hamburgefonstiv M</Text>
+          </Card>
+        </Flex>
+
+        <Flex>
+          <Card padding={0} tone="neutral">
+            <Text size={1}>Hamburgefonstiv M</Text>
+          </Card>
+        </Flex>
+
+        <Flex>
+          <Card padding={0} tone="neutral">
+            <Text size={0}>Hamburgefonstiv M</Text>
+          </Card>
+        </Flex>
+
+        <Flex>
+          <Card padding={2} tone="neutral">
+            <Text>
+              <AddCircleIcon />
+            </Text>
+          </Card>
+        </Flex>
+      </Stack>
+    </Box>
+  )
+}

package/src/core/primitives/text/index.ts

@@ -0,0 +1 @@
+export * from './text'

package/src/core/primitives/text/styles.ts

@@ -0,0 +1,74 @@
+import {getTheme_v2} from '@bettercms-ai/kit/theme'
+import {css} from 'styled-components'
+
+import {ThemeProps} from '../../styles'
+
+export function textBaseStyle(
+  props: {$accent?: boolean; $muted?: boolean} & ThemeProps,
+): ReturnType<typeof css> {
+  const {$accent, $muted} = props
+  const {font} = getTheme_v2(props.theme)
+
+  return css`
+    color: var(--card-fg-color);
+
+    ${$accent &&
+    css`
+      color: var(--card-accent-fg-color);
+    `}
+
+    ${$muted &&
+    css`
+      color: var(--card-muted-fg-color);
+    `}
+
+    & code {
+      font-family: ${font.code.family};
+      border-radius: 1px;
+      background-color: var(--card-code-bg-color);
+      color: var(--card-code-fg-color);
+    }
+
+    & a {
+      text-decoration: none;
+      border-radius: 1px;
+      color: var(--card-link-color);
+      outline: none;
+
+      @media (hover: hover) {
+        &:hover {
+          text-decoration: underline;
+        }
+      }
+
+      &:focus {
+        box-shadow:
+          0 0 0 1px var(--card-bg-color),
+          0 0 0 3px var(--card-focus-ring-color);
+      }
+
+      &:focus:not(:focus-visible) {
+        box-shadow: none;
+      }
+    }
+
+    & strong {
+      font-weight: ${font.text.weights.bold};
+    }
+
+    & svg {
+      /* Certain popular CSS libraries changes the defaults for SVG display */
+      /* Make sure SVGs are rendered as inline elements */
+      display: inline;
+    }
+
+    & [data-bcms-icon] {
+      vertical-align: baseline;
+      color: var(--card-icon-color);
+
+      & path {
+        vector-effect: non-scaling-stroke !important;
+      }
+    }
+  `
+}

package/src/core/primitives/text/text.tsx

@@ -0,0 +1,89 @@
+import {ThemeFontWeightKey} from '@bettercms-ai/kit/theme'
+import {forwardRef} from 'react'
+import {styled} from 'styled-components'
+
+import {_getArrayProp} from '../../styles'
+import {
+  ResponsiveFontStyleProps,
+  responsiveTextAlignStyle,
+  responsiveTextFont,
+} from '../../styles/internal'
+import {ElementType, Props, TextAlign} from '../../types'
+import {SpanWithTextOverflow} from '../../utils/spanWithTextOverflow'
+import {textBaseStyle} from './styles'
+
+/**
+ * @public
+ */
+export interface TextOwnProps {
+  accent?: boolean
+  align?: TextAlign | TextAlign[]
+  /** When `true` the text color will be muted. */
+  muted?: boolean
+  size?: number | number[]
+  /**
+   * Controls how overflowing text is treated.
+   * Use `textOverflow="ellipsis"` to render text as a single line which is concatenated with a `…` symbol.
+   * @beta
+   */
+  textOverflow?: 'ellipsis'
+  weight?: ThemeFontWeightKey
+}
+
+/**
+ * @public
+ */
+export type TextProps<E extends ElementType = 'div'> = Props<TextOwnProps, E>
+
+const StyledText = styled.div<ResponsiveFontStyleProps>(
+  responsiveTextFont,
+  responsiveTextAlignStyle,
+  textBaseStyle,
+)
+
+const TextComponent = forwardRef(function Text(
+  props: TextOwnProps & {as?: ElementType} & Omit<React.HTMLProps<HTMLDivElement>, 'as' | 'size'>,
+  ref: React.ForwardedRef<HTMLDivElement>,
+) {
+  const {
+    accent = false,
+    align,
+    children: childrenProp,
+    muted = false,
+    size = 2,
+    textOverflow,
+    weight,
+    ...restProps
+  } = props
+
+  let children = childrenProp
+
+  if (textOverflow === 'ellipsis') {
+    children = <SpanWithTextOverflow>{children}</SpanWithTextOverflow>
+  }
+
+  return (
+    <StyledText
+      data-ui="Text"
+      {...restProps}
+      $accent={accent}
+      $align={_getArrayProp(align)}
+      $muted={muted}
+      ref={ref}
+      $size={_getArrayProp(size)}
+      $weight={weight}
+    >
+      <span>{children}</span>
+    </StyledText>
+  )
+})
+TextComponent.displayName = 'ForwardRef(Text)'
+
+/**
+ * The `Text` component is an agile, themed typographic element.
+ *
+ * @public
+ */
+export const Text = TextComponent as unknown as <E extends ElementType = 'div'>(
+  props: TextProps<E>,
+) => React.JSX.Element

package/src/core/primitives/textArea/__workshop__/index.ts

@@ -0,0 +1,14 @@
+import {defineScope} from '@bettercms-ai/kit-workshop'
+import {lazy} from 'react'
+
+export default defineScope({
+  name: 'primitives/text-area',
+  title: 'TextArea',
+  stories: [
+    {
+      name: 'plain',
+      title: 'Plain',
+      component: lazy(() => import('./plain')),
+    },
+  ],
+})

package/src/core/primitives/textArea/__workshop__/plain.tsx

@@ -0,0 +1,50 @@
+import {Card, Container, Flex, Stack, Text, TextArea} from '@bettercms-ai/kit'
+import {useBoolean, useSelect, useText} from '@bettercms-ai/kit-workshop'
+
+import {
+  WORKSHOP_CARD_TONE_OPTIONS,
+  WORKSHOP_FONT_WEIGHT_OPTIONS,
+  WORKSHOP_RADIUS_OPTIONS,
+  WORKSHOP_SPACE_OPTIONS,
+  WORKSHOP_TEXT_FONT_SIZE_OPTIONS,
+} from '../../../__workshop__/constants'
+
+export default function PlainStory() {
+  const tone = useSelect('Tone', WORKSHOP_CARD_TONE_OPTIONS)
+
+  const border = useBoolean('Border', true, 'Props')
+  const customValidity = useText('Custom validity', '', 'Props') || undefined
+  const disabled = useBoolean('Disabled', false, 'Props')
+  const fontSize = useSelect('Font size', WORKSHOP_TEXT_FONT_SIZE_OPTIONS, 2, 'Props')
+  const padding = useSelect('Padding', WORKSHOP_SPACE_OPTIONS, 3, 'Props')
+  const placeholder = useText('Placeholder', '', 'Props') || undefined
+  const radius = useSelect('Radius', WORKSHOP_RADIUS_OPTIONS, 2, 'Props')
+  const readOnly = useBoolean('Read only', false, 'Props')
+  const weight = useSelect('Weight', WORKSHOP_FONT_WEIGHT_OPTIONS, undefined, 'Props')
+
+  return (
+    <Flex align="center" height="fill" justify="center" padding={[4, 5, 6]} sizing="border">
+      <Container width={0}>
+        <Card padding={3} tone={tone}>
+          <Stack space={3}>
+            <Text as="label" htmlFor="text-area-example" size={1} weight="medium">
+              TextArea
+            </Text>
+            <TextArea
+              border={border}
+              customValidity={customValidity}
+              disabled={disabled}
+              fontSize={fontSize}
+              id="text-area-example"
+              padding={padding}
+              placeholder={placeholder}
+              radius={radius}
+              readOnly={readOnly}
+              weight={weight}
+            />
+          </Stack>
+        </Card>
+      </Container>
+    </Flex>
+  )
+}

package/src/core/primitives/textArea/index.ts

@@ -0,0 +1 @@
+export * from './textArea'

package/src/core/primitives/textArea/textArea.tsx

@@ -0,0 +1,120 @@
+import {ThemeFontWeightKey} from '@bettercms-ai/kit/theme'
+import {forwardRef, useImperativeHandle, useRef} from 'react'
+import {styled} from 'styled-components'
+
+import {useCustomValidity} from '../../hooks'
+import {_getArrayProp} from '../../styles'
+import {
+  responsiveInputPaddingStyle,
+  responsiveRadiusStyle,
+  ResponsiveRadiusStyleProps,
+  textInputBaseStyle,
+  textInputFontSizeStyle,
+  TextInputInputStyleProps,
+  textInputRepresentationStyle,
+  TextInputRepresentationStyleProps,
+  TextInputResponsivePaddingStyleProps,
+  textInputRootStyle,
+} from '../../styles/internal'
+import {useRootTheme} from '../../theme'
+import {ResponsiveRadiusProps} from '../types'
+
+/**
+ * @public
+ */
+export interface TextAreaProps extends ResponsiveRadiusProps {
+  /**
+   * @beta
+   */
+  __unstable_disableFocusRing?: boolean
+  border?: boolean
+  customValidity?: string
+  fontSize?: number | number[]
+  padding?: number | number[]
+  weight?: ThemeFontWeightKey
+}
+
+const StyledTextArea = styled.span(textInputRootStyle)
+
+const InputRoot = styled.span`
+  flex: 1;
+  min-width: 0;
+  display: block;
+  position: relative;
+`
+
+const Input = styled.textarea<TextInputResponsivePaddingStyleProps & TextInputInputStyleProps>(
+  responsiveInputPaddingStyle,
+  textInputBaseStyle,
+  textInputFontSizeStyle,
+)
+
+const Presentation = styled.div<ResponsiveRadiusStyleProps & TextInputRepresentationStyleProps>(
+  responsiveRadiusStyle,
+  textInputRepresentationStyle,
+)
+
+/**
+ * A multiline text input.
+ *
+
+ * @public
+ */
+export const TextArea = forwardRef(function TextArea(
+  props: TextAreaProps & Omit<React.HTMLProps<HTMLTextAreaElement>, 'as'>,
+  forwardedRef: React.ForwardedRef<HTMLTextAreaElement>,
+) {
+  const {
+    border = true,
+    customValidity,
+    disabled = false,
+    fontSize = 2,
+    padding = 3,
+    radius = 2,
+    weight,
+    __unstable_disableFocusRing,
+    ...restProps
+  } = props
+
+  const ref = useRef<HTMLTextAreaElement | null>(null)
+
+  const rootTheme = useRootTheme()
+
+  useImperativeHandle<HTMLTextAreaElement | null, HTMLTextAreaElement | null>(
+    forwardedRef,
+    () => ref.current,
+  )
+
+  useCustomValidity(ref, customValidity)
+
+  return (
+    <StyledTextArea data-ui="TextArea">
+      <InputRoot>
+        <Input
+          data-as="textarea"
+          data-scheme={rootTheme.scheme}
+          data-tone={rootTheme.tone}
+          {...restProps}
+          $fontSize={_getArrayProp(fontSize)}
+          $padding={_getArrayProp(padding)}
+          $scheme={rootTheme.scheme}
+          $space={_getArrayProp(0)}
+          $tone={rootTheme.tone}
+          $weight={weight}
+          disabled={disabled}
+          ref={ref}
+        />
+        <Presentation
+          $radius={_getArrayProp(radius)}
+          $unstableDisableFocusRing={__unstable_disableFocusRing}
+          $scheme={rootTheme.scheme}
+          $tone={rootTheme.tone}
+          data-border={border ? '' : undefined}
+          data-scheme={rootTheme.scheme}
+          data-tone={rootTheme.tone}
+        />
+      </InputRoot>
+    </StyledTextArea>
+  )
+})
+TextArea.displayName = 'ForwardRef(TextArea)'

package/src/core/primitives/textInput/__workshop__/clearButton.tsx

@@ -0,0 +1,30 @@
+import {Box, TextInput} from '@bettercms-ai/kit'
+import {useText} from '@bettercms-ai/kit-workshop'
+import {useCallback, useState} from 'react'
+
+export default function ClearButtonStory() {
+  const customValidity = useText('Custom validitiy')
+
+  const [value, setValue] = useState('')
+
+  const handleChange = useCallback((event: React.ChangeEvent<HTMLInputElement>) => {
+    setValue(event.currentTarget.value)
+  }, [])
+
+  const handleClear = useCallback(() => {
+    setValue('')
+  }, [])
+
+  return (
+    <Box padding={4}>
+      <TextInput
+        clearButton
+        customValidity={customValidity}
+        onChange={handleChange}
+        onClear={handleClear}
+        placeholder="Enter text"
+        value={value}
+      />
+    </Box>
+  )
+}

package/src/core/primitives/textInput/__workshop__/customValidity.tsx

@@ -0,0 +1,17 @@
+import {Button, Card, Container, Stack, TextInput} from '@bettercms-ai/kit'
+import {useText} from '@bettercms-ai/kit-workshop'
+
+export default function CustomValidityStory() {
+  const customValidity = useText('Custom validity', 'Invalid value', 'Props') || undefined
+
+  return (
+    <Container as="form" onSubmit={(event) => event.preventDefault()} width={0}>
+      <Card padding={4}>
+        <Stack space={4}>
+          <TextInput customValidity={customValidity} />
+          <Button text="Submit" type="submit" />
+        </Stack>
+      </Card>
+    </Container>
+  )
+}

package/src/core/primitives/textInput/__workshop__/index.ts

@@ -0,0 +1,44 @@
+import {defineScope} from '@bettercms-ai/kit-workshop'
+import {lazy} from 'react'
+
+export default defineScope({
+  name: 'primitives/text-input',
+  title: 'TextInput',
+  stories: [
+    {
+      name: 'plain',
+      title: 'Plain',
+      component: lazy(() => import('./plain')),
+    },
+    {
+      name: 'custom-validity',
+      title: 'Custom validity',
+      component: lazy(() => import('./customValidity')),
+    },
+    {
+      name: 'typed',
+      title: 'Typed',
+      component: lazy(() => import('./typed')),
+    },
+    {
+      name: 'tones',
+      title: 'Tones',
+      component: lazy(() => import('./tones')),
+    },
+    {
+      name: 'clear-button',
+      title: 'Clear button',
+      component: lazy(() => import('./clearButton')),
+    },
+    {
+      name: 'read-only',
+      title: 'Read only',
+      component: lazy(() => import('./readOnly')),
+    },
+    {
+      name: 'states',
+      title: 'States',
+      component: lazy(() => import('./states')),
+    },
+  ],
+})