@hanzo/ui 5.0.0 → 5.0.1

package/blocks/components/card-block/index.tsx

@@ -0,0 +1,171 @@
+import React from 'react'
+
+import type { LinkDef, TShirtDimensions  } from  '../../../types'
+
+import {
+  ApplyTypography,  
+  Card,
+  CardContent,
+  CardDescription,
+  CardFooter,
+  CardHeader,
+  CardTitle,
+  type TypographySize
+} from '../../../primitives/index-common'
+
+import type { CardBlock, VideoBlock } from '../../def'
+
+import ImageBlockComponent from '../image-block'
+import VideoBlockComponent from '../video-block'
+import CTABlockComponent from '../cta-block'
+import type BlockComponentProps from '../block-component-props'
+import { cn } from '../../../util'
+
+import { getTypographySize } from './util'
+import LinkOutButton from './link-out-button'
+
+const CardBlockComponent: React.FC<BlockComponentProps & {
+  contentClassName?: string
+}> = ({
+  block,
+  className='',
+  contentClassName=''
+}) => {
+
+  if (block.blockType !== 'card') {
+    return <>card block required</>
+  }
+
+  const card = block as CardBlock
+  const has = (s: string) => (card.specifiers?.includes(s))  
+
+  const ghost = has('ghost') // no outer padding, no borders, larger title, all left-aligned bg is same (default)
+
+  const contentclx = (has('content-left') ? 'items-start ' : ' items-center ') + (has('content-top') ? '!justify-start' : '') + contentClassName
+  const disabledBorder = (has('appear-disabled' ) ? ' border-muted-4' : ' border-muted-3')
+  const outerBorder = ((has('no-outer-border') || ghost) ? ' border-0' : '')
+  const innerBorder = (ghost ? ' border-0' : '')
+  const paddingclx = ghost ? ' px-0 py-0' : ' px-6 py-3'
+  const mainGap = ghost ? ' gap-2' : ''
+  const disabledText = (has('appear-disabled') ? ' text-muted-2' : '')
+  const disabledTypoText = (has('appear-disabled') ? ' typography-p:text-muted-2' : '')
+  const bgclx = (has('bg-card') ? ' bg-level-1' : '')
+  const titleclx = (has('heading-style-title') ? ' font-heading text-base leading-tight' : '') + 
+    (ghost ? ' text-left md:text-xl' : '') 
+  
+  const typoSize: TypographySize = (card.specifiers) ? getTypographySize(card.specifiers) : 'responsive'
+  const typoclx = (typoSize === 'sm') ? 'typography-sm typography-p:text-sm ' : (typoSize === 'lg') ? 'typography-lg ' : '' 
+
+  const contentBefore = has('content-before')
+  const iconInline = has('icon-inline')
+  const contentOnHover = has('reveal-content-on-hover')
+  //const smallIconDim = (contentOnHover && card.specifiers) ? getSmallIconDim(card.specifiers) : undefined
+  
+  const Header: React.FC<{
+    inContent?: boolean
+    className?: string
+  }> = ({
+    inContent=false,
+    className=''
+  }) => (
+    (card.title || card.byline || card.icon) ? (
+      <CardHeader className={'not-typography' + ' text-accent' + disabledText + paddingclx + innerBorder + className}>
+      <div className={(iconInline || inContent) ? 'flex flex-row justify-start items-end my-3' : ''}>        
+      {(card.icon && !card.iconAfter ) && (<div className={iconInline ? 'mr-1' : 'mb-2'}>{card.icon}</div>)}
+      {card.title && (
+        <CardTitle className={'text-center text-lg font-medium' + titleclx + (iconInline ? ' md:text-xl/none' : '') }>
+          {card.title}
+        </CardTitle>
+      )}
+      {(card.icon && card.iconAfter) && (<div className={iconInline ? 'ml-1' : 'my-1'}>{card.icon}</div>)}
+      </div>
+      {card.byline && (<CardDescription>{card.byline}</CardDescription>)}
+      </CardHeader>      
+    ) : null
+  )
+
+  const MediaAndContent: React.FC<{
+    className?: string
+  }> = ({
+    className=''
+  }) => (has('media-left') ? ( 
+    // media left layout
+    <CardContent className={'flex flex-row justify-start items-stretch p-0 grow ' + disabledBorder + bgclx + contentclx + className}>
+    {card.media && (
+      <div className={'box-content grow-0 not-typography' + paddingclx} style={{
+          // If this layout has been specified, assume media is video, and that the 'sm' dim exists.
+        width: (card.media as VideoBlock).dim.sm!.w 
+      }}>
+        <VideoBlockComponent 
+          block={card.media} 
+          usePoster={has('video-use-poster')} 
+          size='sm' 
+          className={has('appear-disabled') ? 'opacity-[0.6]' : ''}
+        />
+      </div>
+    )}
+    {card.content && (
+      <ApplyTypography className={'grow border-l flex flex-col justify-center '  + disabledTypoText + paddingclx + disabledBorder + contentclx} size={typoSize}>
+        {(typeof card.content === 'string') ? (<p>{card.content}</p>) : card.content} 
+      </ApplyTypography>
+    )}
+    </CardContent>
+  ) : ( // default layout
+    <CardContent className={
+      'grow typography flex flex-col justify-center ' + 
+      typoclx + disabledTypoText + bgclx + paddingclx + contentclx + (has('full-width') ? ' p-0 ' : ' ') +
+      className
+    }>
+      {contentOnHover && (<Header inContent/>)}
+      {card.content && contentBefore && (
+        (typeof card.content === 'string') ? (<p>{card.content}</p>) : card.content
+      )}
+      {card.media && (card.media.blockType === 'image' ? (
+        <ImageBlockComponent block={card.media} />
+      ) : (
+        <VideoBlockComponent block={card.media} />
+      ))}
+      {card.content && !contentBefore && (
+        (typeof card.content === 'string') ? (<p>{card.content}</p>) : card.content
+      )}
+    </CardContent>
+  ))
+
+  const Footer: React.FC = () => ( !card.cta ? null : (has('links-w-arrow') ? (
+      // links w arrow
+    <CardFooter className={
+      'typography typography-a:text-muted-2 typography-a:hover:text-muted-1 typography-a:text-xs typography-a:no-underline typography-a:hover:underline ' + 
+      'flex flex-col justify-start items-stretch ' + paddingclx
+    }>
+      <CTABlockComponent 
+        block={card.cta} 
+        renderLink={(def: LinkDef, key: any) => (<LinkOutButton def={def} key={key} />)}
+      />
+    </CardFooter>
+  ) : ( // default 
+    <CardFooter className={'grid grid-cols-1 gap-2 md:flex md:flex-row md:justify-center ' + paddingclx} >
+      <CTABlockComponent block={card.cta} />
+    </CardFooter>
+  )))
+
+  return (
+    <Card className={cn(
+      'flex flex-col self-stretch ' + 
+      (contentOnHover ? 'group relative' : '') + 
+      disabledBorder + 
+      outerBorder + 
+      bgclx + 
+      mainGap, 
+      className
+    )}>
+      <Header className={(contentOnHover ? ' absolute top-[0px] left-[0px] w-full hidden ' : '')}/>
+      <MediaAndContent className={(contentOnHover ? 
+        ' bg-gradient-to-t from-secondary to-65%' + 
+        ' items-start justify-start rounded-lg p-4' + 
+        ' transition-opacity duration-500 ease-out opacity-100  ' : '')}/>
+      <Footer />
+    </Card>  
+  )
+}
+
+export default CardBlockComponent

package/blocks/components/card-block/link-out-button.tsx

@@ -0,0 +1,20 @@
+import React from 'react'
+
+import type { LinkDef } from '../../../types'
+import { LinkElement, Icons } from '../../../primitives/index-next'
+
+const ArrowLinkElement: React.FC<{
+  def: LinkDef,
+}> = ({
+  def
+}) => (
+  <LinkElement
+    def={def}
+    className='justify-between'
+    variant='link'
+    icon={<Icons.linkOut className='w-[18px] h-[18px]' />}
+    iconAfter
+  />
+) 
+
+export default ArrowLinkElement

package/blocks/components/card-block/util.ts

@@ -0,0 +1,28 @@
+import type { Dimensions } from  '../../../types'
+import type {TypographySize } from '../../../primitives/index-common'
+import {
+  getSpecifierData, 
+  getPrimaryStartingWith, 
+  getDim, 
+} from '../../../util/specifier'
+
+export const getTypographySize = (s: string): TypographySize => (
+  getSpecifierData<TypographySize>(
+    s,
+    (s: string) => (getPrimaryStartingWith(s, 'typography')),
+    (s: string): TypographySize | undefined => {
+      const subTokenArray = s.split('-')
+      return subTokenArray[subTokenArray.length - 1] as TypographySize
+    },
+    'responsive'
+  ) as TypographySize
+)
+
+export const getSmallIconDim = (s: string): Dimensions | undefined => (
+  getSpecifierData<Dimensions>(
+    s,
+    (s: string) => (getPrimaryStartingWith(s, 'small-icon')),
+    getDim,
+  ) 
+)
+

package/blocks/components/carte-blanche-block/index.tsx

@@ -0,0 +1,127 @@
+import React from 'react'
+
+import {
+  Card,
+  CardContent,
+  CardFooter,
+  CardHeader,
+} from '../../../primitives/index-common'
+
+import { cn, containsToken } from '../../../util'
+
+import {
+  getSpecifierData, 
+  getPrimaryStartingWith, 
+  getDim, 
+} from '../../../util/specifier'
+
+import type CarteBlancheBlock from '../../def/carte-blanche-block'
+
+import CTABlockComponent from '../cta-block'
+import Content from '../content'
+import type BlockComponentProps from '../block-component-props'
+import { EnhHeadingBlockComponent } from '..'
+import VariantContentLeft from './variant-content-left'
+
+type CardSection = 'entire' | 'header' | 'content' | 'footer'
+
+const _getClx = (specifier: string, section: CardSection): string => {
+  let result = ''
+  if (specifier === 'big-padding') {
+    switch (section) {
+        // defaults: p-4 lg:p-6 xl:p-8 
+      case 'header': {
+        result = 'md:p-8 lg:p-12 xl:p-16'
+      } break
+    }
+  }
+  if (specifier === 'big-padding-content') {
+    switch (section) {
+      case 'content': {
+        result = 'md:p-8 lg:p-12 xl:p-16'
+      } break
+    }
+  }
+  else if (specifier === 'no-inner-borders') {
+    switch (section) {
+      case 'header': {
+        result = 'border-none'
+      } break
+      case 'footer': {
+        result = 'border-t-0'
+      } break
+    }
+  }
+
+  return result
+}
+
+const CarteBlancheBlockComponent: React.FC<
+  BlockComponentProps 
+> = ({
+  block,
+  className='',
+  agent,
+}) => {
+
+  if (block.blockType !== 'carte-blanche') {
+    return <>carte blanche block required</>
+  }
+
+  const b = block as CarteBlancheBlock
+
+  const specified = (s: string): boolean => (containsToken(b.specifiers, s))
+  const getClx = (specifier: string, section: CardSection): string => (
+    (specified(specifier)) ? _getClx(specifier, section) : ''
+  )
+
+  //const bigPadding = specified('big-padding')
+  
+  const headingclx = [
+    getClx('big-padding', 'header'),
+    getClx('no-inner-borders', 'header'),
+  ].join(' ')
+
+  const contentclx = [
+    getClx('big-padding-content', 'content'),
+  ].join(' ')
+
+  const footerclx = [
+    getClx('no-inner-borders', 'footer'),
+  ].join(' ')
+
+  const noOuterBorders = specified('no-outer-borders')
+  const contentLeft = specified('variant-content-left')
+  const mobileContentLeft = specified('variant-mobile-content-left')
+
+  return (
+    <Card className={cn('flex flex-col', className, noOuterBorders ? 'border-none' : '')} >
+      {contentLeft || (mobileContentLeft && agent === 'phone') ? (
+        <VariantContentLeft block={b} agent={agent} className={className} headingclx={headingclx} contentclx={contentclx} footerclx={footerclx}/>
+      ) : (<>
+        {(b.heading || b.topContent) && (
+          <CardHeader className={cn('typography-img:m-0', headingclx)} >
+            {b.topContent && (
+              <Content blocks={b.topContent} agent={agent} className=''/>
+            )}
+            {b.heading && (
+              <EnhHeadingBlockComponent block={b.heading} className='text-accent' agent={agent}/>
+            )}
+          </CardHeader>
+        )}
+        {b.content && (
+          <CardContent className={cn('typography flex flex-col justify-center', contentclx, className)}>
+            <Content blocks={b.content} agent={agent}/>
+          </CardContent>
+        )}
+        {b.cta && (
+          <CardFooter className={cn('grid grid-cols-1 gap-2 md:flex md:flex-row md:justify-center', footerclx)} >
+            <CTABlockComponent block={b.cta} agent={agent}/>
+          </CardFooter>
+        )}
+      </>)}
+    </Card> 
+  )
+}
+
+export default CarteBlancheBlockComponent

package/blocks/components/carte-blanche-block/variant-content-left.tsx

@@ -0,0 +1,49 @@
+import { EnhHeadingBlockComponent, type CarteBlancheBlock, CTABlockComponent } from '../..'
+import {
+  CardContent,
+  CardFooter,
+  CardHeader,
+} from '../../../primitives/index-common'
+import { cn } from '../../../util'
+import Content from '../content'
+
+const VariantContentLeft: React.FC<{
+  block: CarteBlancheBlock,
+  agent?: string
+  className?: string
+  headingclx?: string
+  contentclx?: string
+  footerclx?: string
+}> = ({
+  block,
+  agent,
+  className,
+  headingclx,
+  contentclx,
+  footerclx,
+}) => {
+  return (<>
+    <div className='flex gap-2'>
+      {block.topContent && <Content blocks={block.topContent} agent={agent} className='self-center ml-6 mt-6'/>}
+      <div className='flex flex-col'>
+        {block.heading && (
+          <CardHeader className={cn('typography-img:m-0', headingclx)} >
+            <EnhHeadingBlockComponent block={block.heading} className='text-accent' agent={agent}/>
+          </CardHeader>
+        )}
+        {block.content && (
+          <CardContent className={cn('typography flex flex-col justify-start', contentclx, className)}>
+            <Content blocks={block.content} agent={agent}/>
+          </CardContent>
+        )}
+      </div>
+    </div>
+    {block.cta && (
+      <CardFooter className={cn('grid grid-cols-1 gap-2 md:flex md:flex-row md:justify-center mx-auto', footerclx)}>
+        <CTABlockComponent block={block.cta} agent={agent}/>
+      </CardFooter>
+    )}
+  </>)
+}
+
+export default VariantContentLeft

package/blocks/components/content.tsx

@@ -0,0 +1,70 @@
+import React, { ComponentType, type ReactNode} from 'react'
+
+import type * as B from '../def'
+
+import AccordianBlockComponent from './accordian-block'
+import BulletCardsBlockComponent from './bullet-cards-block'
+import CTABlockComponent from './cta-block'
+import CardBlockComponent from './card-block'
+import CarteBlancheBlockComponent from './carte-blanche-block'
+import EnhHeadingBlockComponent from './enh-heading-block'
+import HeadingBlockComponent from './heading-block'
+import GroupBlockComponent from './group-block'
+import GridBlockComponent from './grid-block'
+import ImageBlockComponent from './image-block'
+import SpaceBlockComponent from './space-block'
+import VideoBlockComponent from './video-block'
+
+import type BlockComponentProps from './block-component-props'
+
+const map = new Map<string, ComponentType<BlockComponentProps>>()
+map.set('accordian', AccordianBlockComponent)
+map.set('bullet-cards', BulletCardsBlockComponent)
+map.set('card', CardBlockComponent)
+map.set('carte-blanche', CarteBlancheBlockComponent)
+map.set('cta', CTABlockComponent)
+map.set('heading', HeadingBlockComponent)
+map.set('enh-heading', EnhHeadingBlockComponent as ComponentType<BlockComponentProps>)
+map.set('space', SpaceBlockComponent)
+map.set('image', ImageBlockComponent)
+map.set('video', VideoBlockComponent)
+map.set('group', GroupBlockComponent)
+map.set('grid', GridBlockComponent)
+
+const registerBlockType = (key: string, type: ComponentType<BlockComponentProps>): void => {
+  map.set(key, type)
+}
+
+const renderBlock = (block: B.Block, className: string, agent?: string, keyStr?: string): ReactNode => {
+  if (block.blockType === 'element') {
+    return (block as B.ElementBlock).element
+  }
+  const CompType = map.get(block.blockType)
+  if (!CompType) return null
+  return <CompType block={block} className={className} agent={agent} key={keyStr ?? ''} /> 
+}
+
+const ContentComponent: React.FC<{
+  blocks: B.Block | B.Block[] | undefined
+  className?: string
+  agent?: string
+}> = ({
+  blocks,
+  className='',
+  agent
+}) => {
+  if (!blocks) return null
+  if (Array.isArray(blocks)) {
+    return (
+      blocks.map((block, index) => (
+        renderBlock(block, className, agent, `content-block-${block.blockType}-${index}`)
+      ))
+    )
+  }
+  return renderBlock(blocks, className, agent)
+}
+
+export {
+  ContentComponent as default,
+  registerBlockType
+}

package/blocks/components/cta-block.tsx

@@ -0,0 +1,115 @@
+import React from 'react'
+
+import type { LinkDef, ButtonDef} from '../../types'
+import  { buttonVariants, ActionButton, LinkElement } from '../../primitives/index-next'
+import type { CTABlock } from '../def'
+import { cn, containsToken, type VariantProps } from '../../util'
+
+import type BlockComponentProps from './block-component-props'
+
+const CtaBlockComponent: React.FC<BlockComponentProps & {
+  itemClasses?: string
+  itemSize?: VariantProps<typeof buttonVariants>['size'],
+  renderLink?: (def: LinkDef, key: any) => JSX.Element
+  renderButton?: (def: ButtonDef, key: any) => JSX.Element
+}> = ({
+  block,
+  className='', // assigned to each item
+  itemClasses='',
+  itemSize, // do not provide default.  this is an override to the def
+  renderLink,
+  renderButton,
+  agent
+}) => {
+  
+  if (block.blockType !== 'cta') {
+    return <>cta block required</>
+  }
+
+  const { elements, specifiers } = block as CTABlock
+  let wrapperClasses = ''
+  let itemclx = ''
+  if (containsToken(specifiers, 'fill')) {
+    wrapperClasses += 'w-full '
+    itemclx += 'grow shrink !min-w-0' 
+  }
+  else if (containsToken(specifiers, 'left')) {
+    wrapperClasses += 'md:justify-start '
+  }
+  else if (containsToken(specifiers, 'right')) {
+    wrapperClasses += 'md:justify-end '
+  }
+  else {
+    wrapperClasses += 'md:justify-center '
+  }
+
+  const mobile2Columns = containsToken(specifiers, 'mobile-2-columns')
+    // normally 'default' buttons have a min width only at > lg.
+    // generally if more than one we don't want this and override it,
+    // but this specifier asks to observe the default behavior.
+  const fillEvenly = !containsToken(specifiers, 'desktop-dont-fill')
+  const mobileCenterFirstIfOdd = containsToken(specifiers, 'mobile-center-first-if-odd')
+  const mobileOddFullWidth = containsToken(specifiers, 'mobile-odd-full-width')
+  
+  let layoutclx: string | undefined = undefined
+  if (elements.length > 1) {
+    let resetMinWidth = false
+    if (mobile2Columns) {
+      layoutclx = 'grid grid-cols-2 gap-2 self-stretch '   
+      resetMinWidth = true 
+    }
+    if (fillEvenly) {
+      layoutclx = (layoutclx ?? 'grid grid-cols-2 gap-2 self-stretch') 
+      resetMinWidth = true 
+    }
+    else {
+      layoutclx = layoutclx ? (layoutclx + 'md:flex md:flex-row md:justify-center ') : 'flex flex-row justify-center '    
+    }
+    itemclx += resetMinWidth ? '!min-w-0 ' : ''
+  }
+  layoutclx = layoutclx ?? 'flex flex-col items-stretch gap-2 self-stretch md:flex-row sm:justify-center '  
+
+  const getMobileColSpanClx = (index: number, total: number) => {
+    const indexToCenter = (total % 2 === 0) ? -1 : (mobileCenterFirstIfOdd) ? 0 : total - 1
+    const widthclx = mobileOddFullWidth ? 'w-full ' : 'w-3/5 mx-auto '
+    return (
+      (agent === 'phone' && mobile2Columns && (index === indexToCenter)) ? ('col-span-2 ' + widthclx) : ''  
+    )
+  } 
+
+  return (
+    <div className={cn(
+      layoutclx, 
+      wrapperClasses,
+      className
+    )}>
+    {elements.map((element, index) => {
+      const twoColClx = getMobileColSpanClx(index, elements.length)
+      if ((element as any).title) {
+        const def = element as LinkDef
+        return renderLink ? renderLink(def, index) : (
+          <LinkElement 
+            def={def}
+            key={index}
+            size={itemSize}
+            className={cn(itemclx, itemClasses, twoColClx)}
+          />
+        )
+      } 
+      else {
+        const def = element as ButtonDef
+        return renderButton ? renderButton(def, index) : (
+          <ActionButton 
+            def={def}
+            key={index}
+            size={itemSize}
+            className={cn(itemclx, itemClasses, twoColClx)}
+          />
+        ) 
+      }
+    })}
+    </div>
+  )
+}
+
+export default CtaBlockComponent