@likec4/diagram 1.34.2 → 1.36.0

package/src/navigationpanel/NavigationPanelDropdown.tsx

@@ -0,0 +1,539 @@
+import { type LikeC4ViewsFolder, LikeC4ViewModel, normalizeViewPath, VIEW_FOLDERS_SEPARATOR } from '@likec4/core/model'
+import type { ViewId } from '@likec4/core/types'
+import { compareNaturalHierarchically, ifilter, ifirst, nonexhaustive, toArray } from '@likec4/core/utils'
+import { css, cx } from '@likec4/styles/css'
+import { Box, HStack, VStack } from '@likec4/styles/jsx'
+import { hstack, vstack } from '@likec4/styles/patterns'
+import {
+  Breadcrumbs,
+  Button,
+  createScopedKeydownHandler,
+  Divider,
+  Highlight,
+  Input,
+  PopoverDropdown,
+  rem,
+  ScrollAreaAutosize,
+  UnstyledButton,
+} from '@mantine/core'
+import { useThrottledCallback, useUncontrolled } from '@mantine/hooks'
+import {
+  IconChevronRight,
+  IconFolderFilled,
+  IconSearch,
+  IconStack2,
+  IconStarFilled,
+  IconZoomScan,
+} from '@tabler/icons-react'
+import { useSelector } from '@xstate/react'
+import { deepEqual } from 'fast-equals'
+import type { ComponentPropsWithoutRef, KeyboardEventHandler } from 'react'
+import { isArray, isEmpty, pipe, sort } from 'remeda'
+import { type NavigationLinkProps, NavigationLink } from '../components/NavigationLink'
+import { useLikeC4Model } from '../likec4model/useLikeC4Model'
+import type { NavigationPanelActorContext } from './actor'
+import { ProjectsMenu } from './dropdown/ProjectsMenu'
+import { useNavigationActor, useNavigationActorContext, useNavigationActorRef } from './hooks'
+import { breadcrumbTitle } from './styles.css'
+
+const scopedKeydownHandler = createScopedKeydownHandler({
+  siblingSelector: '[data-likec4-focusable]',
+  parentSelector: '[data-likec4-breadcrumbs-dropdown]',
+  activateOnFocus: false,
+  loop: true,
+  orientation: 'vertical',
+})
+
+export function NavigationPanelDropdown() {
+  const actor = useNavigationActor()
+  const searchQuery = useSelector(actor.actorRef, s => s.context.searchQuery)
+
+  const setSearchQuery = useThrottledCallback((value: string) => {
+    actor.send({ type: 'searchQuery.change', value })
+  }, 250)
+
+  const hasSearchQuery = searchQuery.trim().length >= 2
+
+  return (
+    <PopoverDropdown
+      className={cx(
+        'nowheel',
+        vstack({
+          layerStyle: 'likec4.dropdown',
+          gap: 'xs',
+          pointerEvents: 'all',
+        }),
+      )}
+      data-likec4-breadcrumbs-dropdown
+      onMouseLeave={() => actor.send({ type: 'dropdown.mouseLeave' })}
+      onMouseEnter={() => actor.send({ type: 'dropdown.mouseEnter' })}
+    >
+      <ProjectsMenu />
+      <HStack gap="xs">
+        <SearchInput
+          value={searchQuery}
+          onChange={setSearchQuery}
+          data-likec4-focusable
+          onKeyDown={scopedKeydownHandler}
+        />
+        {
+          /* <Button
+          variant="default"
+          size={'xs'}
+          onClick={(e) => {
+            e.stopPropagation()
+            actor.send({ type: 'dropdown.dismiss' })
+          }}
+        >
+          Close
+        </Button> */
+        }
+      </HStack>
+      <ScrollAreaAutosize
+        scrollbars="xy"
+        type="auto"
+        offsetScrollbars="present"
+        classNames={{
+          root: css({
+            maxWidth: [
+              'calc(100vw - 50px)',
+              'calc(100cqw - 50px)',
+            ],
+          }),
+        }}
+      >
+        {hasSearchQuery
+          ? <SearchResults searchQuery={normalizeViewPath(searchQuery).toLowerCase()} />
+          : <FolderColumns />}
+      </ScrollAreaAutosize>
+    </PopoverDropdown>
+  )
+}
+
+const compare = compareNaturalHierarchically(VIEW_FOLDERS_SEPARATOR)
+function SearchResults({ searchQuery }: { searchQuery: string }) {
+  const likec4model = useLikeC4Model()
+  const actor = useNavigationActor()
+  const isSearchByPath = searchQuery.includes(VIEW_FOLDERS_SEPARATOR)
+
+  const found = pipe(
+    likec4model.views(),
+    ifilter(v => {
+      // if search query contains folder separator, search in view data
+      if (isSearchByPath && v.$view.title) {
+        return normalizeViewPath(v.$view.title).toLowerCase().includes(searchQuery)
+      }
+      return v.id.toLowerCase().includes(searchQuery) || !!v.title?.toLowerCase().includes(searchQuery)
+    }),
+    ifirst(20),
+    toArray(),
+    sort((a, b) => compare(a.folder.path, b.folder.path)),
+  )
+  if (found.length === 0) return <div>no results</div>
+
+  const highlight = isSearchByPath ? searchQuery.split(VIEW_FOLDERS_SEPARATOR) : searchQuery
+
+  return (
+    <ScrollAreaAutosize
+      scrollbars="xy"
+      offsetScrollbars={false}
+      className={css({
+        width: '100%',
+        maxWidth: [
+          'calc(100vw - 250px)',
+          'calc(100cqw - 250px)',
+        ],
+        maxHeight: [
+          'calc(100vh - 200px)',
+          'calc(100cqh - 200px)',
+        ],
+      })}>
+      <VStack gap="[1px]">
+        {found.map(v => (
+          <FoundedView
+            key={v.id}
+            view={v}
+            highlight={highlight}
+            onClick={e => {
+              console.log('click')
+              e.stopPropagation()
+              actor.selectView(v.id)
+            }}
+            data-likec4-focusable
+            onKeyDown={scopedKeydownHandler}
+          />
+        ))}
+      </VStack>
+    </ScrollAreaAutosize>
+  )
+}
+interface FoundedViewProps {
+  view: LikeC4ViewModel
+  highlight: string | string[]
+}
+
+const foundedViewClass = hstack({
+  gap: 'xxs',
+  rounded: 'sm',
+  px: 'xs',
+  py: 'xxs',
+  _hover: {
+    backgroundColor: {
+      base: 'mantine.colors.gray[1]',
+      _dark: 'mantine.colors.dark[5]',
+    },
+  },
+  _focus: {
+    outline: 'none',
+    color: 'mantine.colors.primary.lightColor!',
+    backgroundColor: 'mantine.colors.primary.lightHover!',
+  },
+})
+const inheritColor = css({
+  _groupFocus: {
+    color: '[inherit!]',
+    transition: 'none',
+  },
+})
+
+function FoundedView(
+  { view, highlight, ...props }: FoundedViewProps & Omit<ComponentPropsWithoutRef<'button'>, keyof FoundedViewProps>,
+) {
+  const folder = view.folder
+
+  const viewIcon = ViewTypeIcon[view.id === 'index' ? 'index' : view._type]
+  const viewLabel = (
+    <Highlight
+      key={view.id}
+      component={'div'}
+      className={cx(
+        inheritColor,
+        breadcrumbTitle({ truncate: true }),
+        css({
+          '& > mark': {
+            backgroundColor: {
+              base: 'mantine.colors.yellow[2]/90',
+              _dark: 'mantine.colors.yellow[5]/80',
+              _groupFocus: '[transparent]',
+            },
+            color: {
+              _groupFocus: '[inherit!]',
+            },
+          },
+        }),
+      )}
+      maw={350}
+      highlight={highlight}
+    >
+      {view.title ?? view.id}
+    </Highlight>
+  )
+  const className = cx(
+    props.className,
+    'group',
+    foundedViewClass,
+  )
+
+  if (folder.isRoot) {
+    return (
+      <UnstyledButton
+        {...props}
+        className={className}
+      >
+        {viewIcon}
+        {viewLabel}
+      </UnstyledButton>
+    )
+  }
+
+  const breadcrumbs = folder.breadcrumbs.map(b => (
+    <Highlight
+      key={b.path}
+      component={'div'}
+      className={cx(
+        css({
+          _groupHover: {
+            color: 'mantine.colors.dimmed',
+          },
+        }),
+        inheritColor,
+        breadcrumbTitle({ dimmed: true, truncate: true }),
+      )}
+      maw={170}
+      highlight={isArray(highlight) ? highlight : []}
+    >
+      {b.title}
+    </Highlight>
+  ))
+  breadcrumbs.push(
+    <HStack gap="[4px]">
+      {viewIcon}
+      {viewLabel}
+    </HStack>,
+  )
+
+  return (
+    <UnstyledButton
+      {...props}
+      className={className}
+    >
+      {folderIcon}
+      <Breadcrumbs separator={<IconChevronRight size={12} stroke={1.5} />} separatorMargin={3}>
+        {breadcrumbs}
+      </Breadcrumbs>
+    </UnstyledButton>
+  )
+}
+
+const btnRightSection = <IconChevronRight size={12} stroke={1.5} className="mantine-rotate-rtl" />
+const folderIcon = (
+  <IconFolderFilled
+    size={16}
+    // stroke={1.5}
+    className={css({
+      opacity: {
+        base: 0.3,
+        _groupHover: 0.5,
+        _groupActive: 0.5,
+        _groupFocus: 0.5,
+      },
+    })} />
+)
+
+const viewTypeIconCss = css({
+  opacity: {
+    base: 0.3,
+    _dark: 0.5,
+    _groupHover: 0.8,
+    _groupActive: 0.8,
+    _groupFocus: 0.8,
+  },
+})
+const ViewTypeIcon = {
+  index: <IconStarFilled size={16} className={viewTypeIconCss} />,
+  element: (
+    <IconZoomScan
+      size={18}
+      stroke={2}
+      className={viewTypeIconCss} />
+  ),
+  deployment: <IconStack2 size={16} stroke={1.5} className={viewTypeIconCss} />,
+  dynamic: <IconStack2 size={16} stroke={1.5} className={viewTypeIconCss} />,
+}
+
+const ColumnScrollArea = ScrollAreaAutosize.withProps({
+  scrollbars: 'y',
+  className: css({
+    maxHeight: [
+      'calc(100vh - 160px)',
+      'calc(100cqh - 160px)',
+    ],
+  }),
+})
+
+type ColumnItem =
+  | {
+    type: 'folder'
+    folderPath: string
+    title: string
+    selected: boolean
+  }
+  | {
+    type: 'view'
+    viewType: 'element' | 'deployment' | 'dynamic' | 'index'
+    viewId: ViewId
+    title: string
+    description: string | null
+    selected: boolean
+  }
+type FolderColumnData = {
+  folderPath: string
+  items: Array<ColumnItem>
+}
+
+function folderColumn(
+  folder: LikeC4ViewsFolder,
+  context: Pick<NavigationPanelActorContext, 'selectedFolder' | 'viewModel'>,
+): FolderColumnData {
+  return {
+    folderPath: folder.path,
+    items: [
+      ...folder.folders.map(s => ({
+        type: 'folder' as const,
+        folderPath: s.path,
+        title: s.title,
+        selected: context.selectedFolder.startsWith(s.path),
+      })),
+      ...folder.views.map(s => ({
+        type: 'view' as const,
+        viewType: s.id === 'index' ? 'index' as const : s._type,
+        viewId: s.id,
+        title: s.title ?? s.id,
+        description: s.description.nonEmpty && s.description.text || null,
+        selected: s.id === context.viewModel.id,
+      })),
+    ],
+  }
+}
+
+const selectColumns = (context: NavigationPanelActorContext): FolderColumnData[] => {
+  const viewModel = context.viewModel
+  const likec4model = viewModel.$model
+  const columns = [
+    folderColumn(likec4model.rootViewFolder, context),
+  ]
+  const folder = likec4model.viewFolder(context.selectedFolder)
+  if (!folder.isRoot) {
+    for (const b of folder.breadcrumbs) {
+      columns.push(folderColumn(b, context))
+    }
+  }
+  return columns
+}
+
+function FolderColumns() {
+  const columns = useNavigationActorContext(selectColumns, deepEqual)
+  return (
+    <HStack gap="xs" alignItems="stretch">
+      {columns.flatMap((column, i) => [
+        i > 0 && <Divider orientation="vertical" key={'divider' + i} />,
+        <FolderColumn key={column.folderPath} data={column} />,
+      ])}
+    </HStack>
+  )
+}
+
+function FolderColumn({ data }: { data: FolderColumnData }) {
+  const actor = useNavigationActorRef()
+
+  const onItemClicked = (item: ColumnItem) => (e: React.MouseEvent) => {
+    e.stopPropagation()
+    if (item.type === 'folder') {
+      actor.send({ type: 'select.folder', folderPath: item.folderPath })
+    } else {
+      actor.send({ type: 'select.view', viewId: item.viewId })
+    }
+  }
+
+  return (
+    <Box mb={'1'}>
+      <ColumnScrollArea>
+        <VStack gap="[1px]">
+          {data.items.map((item, i) => (
+            <FolderColumnItem
+              key={`${data.folderPath}/${item.type}/${i}`}
+              columnItem={item}
+              onClick={onItemClicked(item)}
+            />
+          ))}
+        </VStack>
+      </ColumnScrollArea>
+    </Box>
+  )
+}
+
+function FolderColumnItem({ columnItem, ...props }: { columnItem: ColumnItem } & NavigationLinkProps) {
+  switch (columnItem.type) {
+    case 'folder':
+      return (
+        <NavigationLink
+          key={columnItem.folderPath}
+          variant="light"
+          active={columnItem.selected}
+          label={columnItem.title}
+          leftSection={folderIcon}
+          rightSection={btnRightSection}
+          maw="300px"
+          miw="200px"
+          {...props}
+        />
+      )
+    case 'view':
+      return (
+        <NavigationLink
+          key={columnItem.viewId}
+          variant="filled"
+          active={columnItem.selected}
+          label={columnItem.title}
+          description={columnItem.description}
+          leftSection={ViewTypeIcon[columnItem.viewType]}
+          maw="300px"
+          miw="200px"
+          {...props}
+        />
+      )
+    default:
+      nonexhaustive(columnItem)
+  }
+}
+
+function SearchInput({ onKeyDown, ...props }: {
+  value?: string
+  defaultValue?: string
+  onChange?: (value: string) => void
+  onKeyDown?: KeyboardEventHandler<HTMLElement>
+}) {
+  const [_value, handleChange] = useUncontrolled({
+    ...props,
+    finalValue: '',
+  })
+  return (
+    <Input
+      size="xs"
+      placeholder="Search by title or id"
+      variant="unstyled"
+      height={rem(26)}
+      value={_value}
+      onKeyDown={onKeyDown}
+      onChange={e => handleChange(e.currentTarget.value)}
+      classNames={{
+        wrapper: css({
+          flexGrow: 1,
+          backgroundColor: {
+            base: 'mantine.colors.gray[1]',
+            _dark: 'mantine.colors.dark[5]/80',
+            _hover: {
+              base: 'mantine.colors.gray[2]',
+              _dark: 'mantine.colors.dark[4]',
+            },
+            _focus: {
+              base: 'mantine.colors.gray[2]',
+              _dark: 'mantine.colors.dark[4]',
+            },
+          },
+          rounded: 'sm',
+        }),
+        input: css({
+          _placeholder: {
+            color: 'mantine.colors.dimmed',
+          },
+          _focus: {
+            outline: 'none',
+          },
+        }),
+      }}
+      style={{
+        ['--input-fz']: 'var(--mantine-font-size-sm)',
+      }}
+      leftSection={<IconSearch size={14} />}
+      rightSectionPointerEvents="all"
+      rightSectionWidth={'min-content'}
+      rightSection={!props.value || isEmpty(props.value)
+        ? null
+        : (
+          <Button
+            variant="subtle"
+            h="100%"
+            size={'compact-xs'}
+            color="gray"
+            onClick={(e) => {
+              e.stopPropagation()
+              handleChange('')
+            }}
+          >
+            clear
+          </Button>
+        )}
+    />
+  )
+}

package/src/navigationpanel/_common.tsx

@@ -0,0 +1,84 @@
+import { css, cx } from '@likec4/styles/css'
+import {
+  type NavigationPanelActionIconVariant,
+  navigationPanelActionIcon,
+} from '@likec4/styles/recipes'
+import {
+  type ActionIconProps,
+  ActionIcon,
+  Breadcrumbs as MantineBreadcrumbs,
+  ThemeIcon,
+  Tooltip as MantineTooltip,
+} from '@mantine/core'
+import { IconChevronRight } from '@tabler/icons-react'
+import type { HTMLMotionProps } from 'motion/react'
+import * as m from 'motion/react-m'
+import { forwardRef } from 'react'
+
+export const Tooltip = MantineTooltip.withProps({
+  color: 'dark',
+  fz: 'xs',
+  openDelay: 600,
+  closeDelay: 120,
+  label: '',
+  children: null,
+  offset: 8,
+  withinPortal: false,
+})
+
+export const BreadcrumbsSeparator = () => (
+  <ThemeIcon
+    variant="transparent"
+    size={16}
+    className={css({
+      display: {
+        base: 'none',
+        '@/md': 'flex',
+      },
+      color: {
+        base: 'mantine.colors.gray[5]',
+        _dark: 'mantine.colors.dark[3]',
+      },
+    })}>
+    <IconChevronRight />
+  </ThemeIcon>
+)
+
+export const Breadcrumbs = MantineBreadcrumbs.withProps({
+  separator: <BreadcrumbsSeparator />,
+  separatorMargin: 4,
+})
+
+export type PanelActionIconProps =
+  & Partial<NavigationPanelActionIconVariant>
+  & Omit<ActionIconProps, keyof NavigationPanelActionIconVariant>
+  & HTMLMotionProps<'button'>
+
+export const PanelActionIcon = forwardRef<HTMLButtonElement, PanelActionIconProps>(({
+  variant = 'default',
+  className,
+  disabled = false,
+  ...others
+}, ref) => (
+  <ActionIcon
+    size="md"
+    variant="transparent"
+    radius="sm"
+    component={m.button}
+    {...!disabled && {
+      whileHover: {
+        scale: 1.085,
+      },
+      whileTap: {
+        scale: 1,
+        translateY: 1,
+      },
+    }}
+    disabled={disabled}
+    {...others}
+    className={cx(
+      className,
+      navigationPanelActionIcon({ variant }),
+    )}
+    ref={ref} />
+))