@bettercms-ai/kit 0.1.0

package/src/core/primitives/card/card.tsx

@@ -0,0 +1,128 @@
+import {ThemeColorSchemeKey} from '@bettercms-ai/kit/theme'
+import {forwardRef} from 'react'
+import {isValidElementType} from 'react-is'
+import {styled} from 'styled-components'
+
+import {_getArrayProp} from '../../styles'
+import {
+  responsiveBorderStyle,
+  ResponsiveBorderStyleProps,
+  responsiveRadiusStyle,
+  ResponsiveRadiusStyleProps,
+  responsiveShadowStyle,
+  ResponsiveShadowStyleProps,
+} from '../../styles/internal'
+import {ThemeColorProvider, useRootTheme} from '../../theme'
+import {CardTone, ElementType, Props} from '../../types'
+import {Box, BoxOwnProps} from '../box'
+import {ResponsiveBorderProps, ResponsiveRadiusProps, ResponsiveShadowProps} from '../types'
+import {cardStyle} from './styles'
+import {CardStyleProps} from './types'
+
+/**
+ * @public
+ */
+export interface CardOwnProps
+  extends BoxOwnProps,
+    ResponsiveBorderProps,
+    ResponsiveRadiusProps,
+    ResponsiveShadowProps {
+  /**
+   * Do not use in production.
+   * @beta
+   */
+  __unstable_checkered?: boolean
+  /**
+   * Do not use in production.
+   * @beta
+   */
+  __unstable_focusRing?: boolean
+  disabled?: boolean
+  muted?: boolean
+  pressed?: boolean
+  scheme?: ThemeColorSchemeKey
+  selected?: boolean
+  tone?: CardTone
+}
+
+/**
+ * @public
+ */
+export type CardProps<E extends ElementType = 'div'> = Props<CardOwnProps, E>
+
+const StyledCard = styled(Box)<
+  CardStyleProps &
+    ResponsiveRadiusStyleProps &
+    ResponsiveBorderStyleProps &
+    ResponsiveShadowStyleProps
+>(responsiveBorderStyle, responsiveRadiusStyle, responsiveShadowStyle, cardStyle)
+
+const CardComponent = forwardRef(function Card(
+  props: CardOwnProps & {as?: ElementType} & Omit<React.HTMLProps<HTMLDivElement>, 'as' | 'height'>,
+  ref: React.ForwardedRef<HTMLDivElement>,
+) {
+  const {
+    __unstable_checkered: checkered = false,
+    __unstable_focusRing: focusRing = false,
+    as: asProp,
+    border,
+    borderTop,
+    borderRight,
+    borderBottom,
+    borderLeft,
+    muted,
+    pressed,
+    radius = 0,
+    scheme,
+    selected,
+    shadow,
+    tone: toneProp = 'default',
+    ...restProps
+  } = props
+
+  const as = isValidElementType(asProp) ? asProp : 'div'
+  const rootTheme = useRootTheme()
+  const tone = toneProp === 'inherit' ? rootTheme.tone : toneProp
+
+  // eslint-disable-next-line no-warning-comments
+  // todo: Consider adding the wrapper approach for nested cards in which the tones are not changing, avoid unnecessary ThemeColorProvider
+  return (
+    <ThemeColorProvider scheme={scheme} tone={tone}>
+      <StyledCard
+        data-as={typeof as === 'string' ? as : undefined}
+        data-scheme={rootTheme.scheme}
+        data-ui="Card"
+        data-tone={tone}
+        {...restProps}
+        $border={_getArrayProp(border)}
+        $borderTop={_getArrayProp(borderTop)}
+        $borderRight={_getArrayProp(borderRight)}
+        $borderBottom={_getArrayProp(borderBottom)}
+        $borderLeft={_getArrayProp(borderLeft)}
+        $checkered={checkered}
+        $focusRing={focusRing}
+        $muted={muted}
+        $radius={_getArrayProp(radius)}
+        $shadow={_getArrayProp(shadow)}
+        $tone={tone}
+        data-checkered={checkered ? '' : undefined}
+        data-pressed={pressed ? '' : undefined}
+        data-selected={selected ? '' : undefined}
+        forwardedAs={as}
+        ref={ref}
+        selected={selected}
+      />
+    </ThemeColorProvider>
+  )
+})
+CardComponent.displayName = 'ForwardRef(Card)'
+
+/**
+ * The `Card` component acts much like a `Box`, but with a background and foreground color.
+ * Components within a `Card` inherit its colors.
+ *
+ * @public
+ */
+export const Card = CardComponent as unknown as <E extends ElementType = 'div'>(
+  props: CardProps<E>,
+) => React.JSX.Element

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

@@ -0,0 +1,2 @@
+export * from './card'
+export * from './types'

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

@@ -0,0 +1,147 @@
+import {getTheme_v2} from '@bettercms-ai/kit/theme'
+import {css} from 'styled-components'
+
+import {ThemeProps} from '../../styles'
+import {_cardColorStyle} from '../../styles/card'
+import {focusRingStyle} from '../../styles/focusRing'
+import {CardStyleProps} from './types'
+
+export function cardStyle(
+  props: CardStyleProps & ThemeProps,
+): Array<ReturnType<typeof css> | (() => ReturnType<typeof css>)> {
+  return [cardBaseStyle(props), cardColorStyle(props)]
+}
+
+export function cardBaseStyle(props: CardStyleProps & ThemeProps): ReturnType<typeof css> {
+  const {$checkered} = props
+  const {space} = getTheme_v2(props.theme)
+
+  return css`
+    ${$checkered &&
+    css`
+      background-size: ${space[3]}px ${space[3]}px;
+      background-position: 50% 50%;
+      background-image: var(--card-bg-image);
+    `}
+
+    &[data-as='button'] {
+      -webkit-font-smoothing: inherit;
+      appearance: none;
+      outline: none;
+      font: inherit;
+      text-align: inherit;
+      border: 0;
+      width: -moz-available;
+      width: -webkit-fill-available;
+      width: stretch;
+    }
+
+    /* &:is(a) */
+    &[data-as='a'] {
+      outline: none;
+      text-decoration: none;
+    }
+
+    /* &:is(pre) */
+    &[data-as='pre'] {
+      font: inherit;
+    }
+  `
+}
+
+export function cardColorStyle(props: CardStyleProps & ThemeProps): ReturnType<typeof css> {
+  const {$checkered, $focusRing, $muted} = props
+  const {card, color, style} = getTheme_v2(props.theme)
+  const border = {width: card.border.width, color: 'var(--card-border-color)'}
+
+  return css`
+    color-scheme: ${color._dark ? 'dark' : 'light'};
+
+    ${_cardColorStyle(color, color, $checkered)}
+
+    background-color: ${$muted ? 'var(--card-muted-bg-color)' : 'var(--card-bg-color)'};
+    color: var(--card-fg-color);
+
+    /* &:is(button) */
+    &[data-as='button'] {
+      --card-focus-ring-box-shadow: none;
+
+      cursor: default;
+      box-shadow: var(--card-focus-ring-box-shadow);
+
+      &:disabled {
+        ${_cardColorStyle(color, color.selectable.default.disabled, $checkered)}
+      }
+
+      &:not(:disabled) {
+        &[data-pressed] {
+          ${_cardColorStyle(color, color.selectable.default.pressed, $checkered)}
+        }
+
+        &[data-selected] {
+          ${_cardColorStyle(color, color.selectable.default.selected, $checkered)}
+        }
+
+        @media (hover: hover) {
+          &:not([data-pressed]):not([data-selected]) {
+            &[data-hovered],
+            &:hover {
+              ${_cardColorStyle(color, color.selectable.default.hovered, $checkered)}
+            }
+
+            &:active {
+              ${_cardColorStyle(color, color.selectable.default.pressed, $checkered)}
+            }
+          }
+        }
+
+        &:focus-visible {
+          --card-focus-ring-box-shadow: ${$focusRing
+            ? focusRingStyle({base: color, border, focusRing: card.focusRing})
+            : undefined};
+        }
+      }
+    }
+
+    /* &:is(a) */
+    &[data-as='a'] {
+      cursor: pointer;
+      box-shadow: var(--card-focus-ring-box-shadow);
+
+      &[data-disabled] {
+        ${_cardColorStyle(color, color.selectable.default.disabled, $checkered)}
+      }
+
+      &:not([data-disabled]) {
+        &[data-pressed] {
+          ${_cardColorStyle(color, color.selectable.default.pressed, $checkered)}
+        }
+
+        &[data-selected] {
+          ${_cardColorStyle(color, color.selectable.default.selected, $checkered)}
+        }
+
+        @media (hover: hover) {
+          &:not([data-pressed]):not([data-selected]) {
+            &[data-hovered],
+            &:hover {
+              ${_cardColorStyle(color, color.selectable.default.hovered, $checkered)}
+            }
+
+            &:active {
+              ${_cardColorStyle(color, color.selectable.default.pressed, $checkered)}
+            }
+          }
+        }
+
+        &:focus-visible {
+          --card-focus-ring-box-shadow: ${$focusRing
+            ? focusRingStyle({base: color, border, focusRing: card.focusRing})
+            : undefined};
+        }
+      }
+    }
+
+    ${style?.card?.root}
+  `
+}

package/src/core/primitives/card/types.ts

@@ -0,0 +1,11 @@
+import {ThemeColorToneKey} from '@bettercms-ai/kit/theme'
+
+/**
+ * @internal
+ */
+export interface CardStyleProps {
+  $checkered: boolean
+  $focusRing: boolean
+  $muted: boolean
+  $tone: ThemeColorToneKey
+}

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

@@ -0,0 +1,25 @@
+import {Box, Checkbox, Flex, Text} from '@bettercms-ai/kit'
+import {useCallback, useState} from 'react'
+
+export default function ExampleStory() {
+  const [checked, setChecked] = useState<boolean | undefined>(undefined)
+  const [indeterminate] = useState(checked === undefined)
+  const handleChange = useCallback(() => setChecked((val) => !val), [])
+
+  return (
+    <Flex align="center" height="fill" justify="center" padding={[4, 5, 6]} sizing="border">
+      <Flex align="center" as="label">
+        <Checkbox
+          checked={checked || false}
+          indeterminate={indeterminate}
+          onChange={handleChange}
+        />
+        <Box marginLeft={2}>
+          <Text size={1} weight="medium">
+            Toggle
+          </Text>
+        </Box>
+      </Flex>
+    </Flex>
+  )
+}

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

@@ -0,0 +1,13 @@
+import {defineScope} from '@bettercms-ai/kit-workshop'
+import {lazy} from 'react'
+
+export default defineScope({
+  name: 'primitives/checkbox',
+  title: 'Checkbox',
+  stories: [
+    {name: 'props', title: 'Props', component: lazy(() => import('./props'))},
+    {name: 'example', title: 'Example', component: lazy(() => import('./example'))},
+    {name: 'read-only', title: 'Read-only', component: lazy(() => import('./readOnly'))},
+    {name: 'multiple-tones', title: 'Multiple tones', component: lazy(() => import('./tones'))},
+  ],
+})

package/src/core/primitives/checkbox/__workshop__/props.tsx

@@ -0,0 +1,33 @@
+import {Box, Checkbox, Flex, Text} from '@bettercms-ai/kit'
+import {useAction, useBoolean} from '@bettercms-ai/kit-workshop'
+
+export default function PropsStory() {
+  const checked = useBoolean('Checked', false, 'Props')
+  const disabled = useBoolean('Disabled', false, 'Props')
+  const indeterminate = useBoolean('Indeterminate', false, 'Props')
+  const onChange = useAction('onChange')
+  const onFocus = useAction('onFocus')
+  const onBlur = useAction('onBlur')
+  const readOnly = useBoolean('Read only', false, 'Props')
+
+  return (
+    <Flex align="center" height="fill" justify="center" padding={[4, 5, 6]} sizing="border">
+      <Flex align="center" as="label">
+        <Checkbox
+          checked={checked}
+          disabled={disabled}
+          indeterminate={indeterminate}
+          onChange={onChange}
+          onFocus={onFocus}
+          onBlur={onBlur}
+          readOnly={readOnly}
+        />
+        <Box marginLeft={2}>
+          <Text size={1} weight="medium">
+            Toggle
+          </Text>
+        </Box>
+      </Flex>
+    </Flex>
+  )
+}

package/src/core/primitives/checkbox/__workshop__/readOnly.tsx

@@ -0,0 +1,16 @@
+import {Box, Checkbox, Flex, Text} from '@bettercms-ai/kit'
+
+export default function ReadOnlyStory() {
+  return (
+    <Flex align="center" height="fill" justify="center" padding={[4, 5, 6]} sizing="border">
+      <Flex align="center" as="label">
+        <Checkbox id="checkbox-example" readOnly />
+        <Box marginLeft={2}>
+          <Text size={1} weight="medium">
+            Toggle
+          </Text>
+        </Box>
+      </Flex>
+    </Flex>
+  )
+}

package/src/core/primitives/checkbox/__workshop__/tones.tsx

@@ -0,0 +1,28 @@
+import {Card, Checkbox, Flex, Stack} from '@bettercms-ai/kit'
+
+export default function MultipleTonesStory() {
+  return (
+    <Flex align="center" height="fill" justify="center" padding={[4, 5, 6]} sizing="border">
+      <Stack>
+        <Card padding={3} tone="neutral">
+          <Checkbox />
+        </Card>
+        <Card padding={3} tone="primary">
+          <Checkbox />
+        </Card>
+        <Card padding={3} tone="suggest">
+          <Checkbox />
+        </Card>
+        <Card padding={3} tone="positive">
+          <Checkbox />
+        </Card>
+        <Card padding={3} tone="caution">
+          <Checkbox />
+        </Card>
+        <Card padding={3} tone="critical">
+          <Checkbox />
+        </Card>
+      </Stack>
+    </Flex>
+  )
+}

package/src/core/primitives/checkbox/checkbox.tsx

@@ -0,0 +1,73 @@
+import {CheckmarkIcon, RemoveIcon} from '@bettercms-ai/icons'
+import {forwardRef, useEffect, useImperativeHandle, useRef} from 'react'
+import {styled} from 'styled-components'
+
+import {useCustomValidity} from '../../hooks'
+import {checkboxBaseStyles, inputElementStyles} from './styles'
+
+/**
+ * @public
+ */
+export interface CheckboxProps {
+  indeterminate?: boolean
+  customValidity?: string
+}
+
+const StyledCheckbox = styled.div(checkboxBaseStyles)
+const Input = styled.input(inputElementStyles)
+
+/**
+ * Checkboxes allow the user to select one or more items from a set.
+ *
+ * @public
+ */
+export const Checkbox = forwardRef(function Checkbox(
+  props: Omit<React.HTMLProps<HTMLInputElement>, 'as' | 'type'> & CheckboxProps,
+  forwardedRef: React.ForwardedRef<HTMLInputElement>,
+) {
+  const {
+    checked,
+    className,
+    disabled,
+    indeterminate,
+    customValidity,
+    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])
+
+  useCustomValidity(ref, customValidity)
+
+  return (
+    <StyledCheckbox className={className} data-ui="Checkbox" style={style}>
+      <Input
+        data-read-only={!disabled && readOnly ? '' : undefined}
+        data-error={customValidity ? '' : undefined}
+        {...restProps}
+        checked={checked}
+        disabled={disabled || readOnly}
+        type="checkbox"
+        readOnly={readOnly}
+        ref={ref}
+      />
+      <span>
+        <CheckmarkIcon />
+        <RemoveIcon />
+      </span>
+    </StyledCheckbox>
+  )
+})
+Checkbox.displayName = 'ForwardRef(Checkbox)'

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

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

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

@@ -0,0 +1,128 @@
+import {getTheme_v2} from '@bettercms-ai/kit/theme'
+import {css} from 'styled-components'
+
+import {rem, ThemeProps} from '../../styles'
+import {focusRingBorderStyle, focusRingStyle} from '../../styles/internal'
+
+export function checkboxBaseStyles(): ReturnType<typeof css> {
+  return css`
+    position: relative;
+    display: inline-block;
+  `
+}
+
+export function inputElementStyles(props: ThemeProps): ReturnType<typeof css> {
+  const {color, input, radius} = getTheme_v2(props.theme)
+  const {focusRing} = input.checkbox
+
+  return css`
+    position: absolute;
+    top: 0;
+    left: 0;
+    width: 100%;
+    height: 100%;
+    outline: none;
+    opacity: 0;
+    z-index: 1;
+    padding: 0;
+    margin: 0;
+
+    & + span {
+      position: relative;
+      display: block;
+      height: ${rem(input.checkbox.size)};
+      width: ${rem(input.checkbox.size)};
+      box-sizing: border-box;
+      box-shadow: ${focusRingBorderStyle({
+        color: color.input.default.enabled.border,
+        width: input.border.width,
+      })};
+      border-radius: ${rem(radius[2])};
+      line-height: 1;
+      background-color: ${color.input.default.enabled.bg};
+
+      & > svg {
+        display: block;
+        position: absolute;
+        opacity: 0;
+        height: 100%;
+        width: 100%;
+
+        & > path {
+          vector-effect: non-scaling-stroke;
+          stroke-width: 1.5px !important;
+        }
+      }
+    }
+
+    &:checked + span {
+      background: ${color.input.default.enabled.fg};
+      box-shadow: ${focusRingBorderStyle({
+        color: color.input.default.enabled.fg,
+        width: input.border.width,
+      })};
+      color: ${color.input.default.enabled.bg};
+    }
+
+    /* focus */
+    &:not(:disabled):focus:focus-visible + span {
+      box-shadow: ${focusRingStyle({focusRing})};
+    }
+
+    /* focus when checked - uses a different offset */
+    &:not(:disabled):focus:focus-visible&:checked + span {
+      box-shadow: ${focusRingStyle({focusRing: {width: 1, offset: 1}})};
+    }
+
+    &[data-error] + span {
+      background-color: ${color.input.invalid.enabled.border};
+      box-shadow: ${focusRingBorderStyle({
+        width: input.border.width,
+        color: color.input.invalid.enabled.muted.bg,
+      })};
+      color: ${color.input.default.disabled.fg};
+    }
+    &[data-error]&:checked + span {
+      background-color: ${color.input.invalid.enabled.muted.bg};
+      color: ${color.input.default.enabled.bg};
+    }
+    &[data-error]&:checked&:not(:disabled):focus:focus-visible + span {
+      box-shadow: ${focusRingStyle({
+        border: {width: input.border.width, color: color.input.invalid.readOnly.muted.bg},
+        focusRing: {width: 1, offset: 1},
+      })};
+    }
+
+    &:disabled + span {
+      background-color: ${color.input.default.disabled.bg};
+      box-shadow: ${focusRingBorderStyle({
+        width: input.border.width,
+        color: color.input.default.disabled.border,
+      })};
+      color: ${color.input.default.disabled.fg};
+    }
+    &:disabled&:checked + span {
+      background-color: ${color.input.default.disabled.muted.bg};
+    }
+
+    &[data-read-only] + span {
+      background-color: ${color.input.default.readOnly.bg};
+      box-shadow: ${focusRingBorderStyle({
+        width: input.border.width,
+        color: color.input.default.readOnly.border,
+      })};
+      color: ${color.input.default.readOnly.fg};
+    }
+
+    &[data-read-only]&:checked + span {
+      background-color: ${color.input.default.readOnly.muted.bg};
+    }
+
+    &:checked + span > svg:first-child {
+      opacity: 1;
+    }
+    &:indeterminate + span > svg:last-child {
+      opacity: 1;
+    }
+  `
+}

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

@@ -0,0 +1,19 @@
+import {defineScope} from '@bettercms-ai/kit-workshop'
+import {lazy} from 'react'
+
+export default defineScope({
+  name: 'primitives/code',
+  title: 'Code',
+  stories: [
+    {
+      name: 'props',
+      title: 'Props',
+      component: lazy(() => import('./props')),
+    },
+    {
+      name: 'optical-alignment',
+      title: 'Optical alignment',
+      component: lazy(() => import('./opticalAlignment')),
+    },
+  ],
+})

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

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