@hina-ui/vue 1.5.0 → 1.6.0

package/src/components/tree/composables/useTree.ts

@@ -0,0 +1,81 @@
+import { computed, type Ref } from 'vue'
+import type { TreeNode, TreeNodeState, TreeValue } from '../types'
+import { checkedState, indexTree, toggleChecked } from '../utils/selection'
+
+interface Options {
+  items: TreeNode[]
+  multiple?: boolean
+  defaultExpanded: TreeValue[]
+}
+
+export function useTree(
+  props: Options,
+  model: Ref<TreeValue | TreeValue[] | null | undefined>,
+  expandedModel: Ref<TreeValue[] | undefined>,
+  disabled: Ref<boolean>,
+) {
+  const initialExpanded = [...props.defaultExpanded]
+  const index = computed(() => indexTree(props.items))
+  const states = computed(() => {
+    if (props.multiple)
+      return checkedState(index.value, Array.isArray(model.value) ? model.value : [])
+    return new Map(
+      [...index.value.entries].map(([value, entry]) => [
+        value,
+        {
+          selected: value === model.value,
+          indeterminate: false,
+          disabled: entry.disabled,
+        },
+      ]),
+    )
+  })
+  const selected = computed(() =>
+    [...index.value.entries.values()]
+      .filter(entry => states.value.get(entry.node.value)?.selected)
+      .map(entry => entry.node),
+  )
+  const keys = computed(
+    () => new Map([...index.value.entries].map(([value, entry]) => [key(entry.node), value])),
+  )
+  const expanded = computed({
+    get: () => (expandedModel.value ?? initialExpanded).map(value => key({ value })),
+    set: value => {
+      expandedModel.value = value.flatMap(key =>
+        keys.value.has(key) ? [keys.value.get(key)!] : [],
+      )
+    },
+  })
+
+  function key(node: Pick<TreeNode, 'value'>) {
+    return `${typeof node.value}:${node.value}`
+  }
+  function getChildren(node: TreeNode) {
+    return node.children?.length ? node.children : undefined
+  }
+  function state(node: TreeNode): TreeNodeState {
+    const value = states.value.get(node.value)!
+    return { ...value, disabled: disabled.value || value.disabled }
+  }
+  function select(event: CustomEvent<{ value?: TreeNode }>) {
+    event.preventDefault()
+    const node = event.detail.value
+    if (!node || state(node).disabled) return
+    model.value = props.multiple
+      ? toggleChecked(index.value, Array.isArray(model.value) ? model.value : [], node.value)
+      : model.value === node.value
+        ? null
+        : node.value
+  }
+  function toggle(node: TreeNode) {
+    if (state(node).disabled || !getChildren(node)) return
+    const value = key(node)
+    expanded.value = expanded.value.includes(value)
+      ? expanded.value.filter(key => key !== value)
+      : [...expanded.value, value]
+  }
+  function keepRowClick(event: CustomEvent<{ originalEvent: Event }>) {
+    if (event.detail.originalEvent.type === 'click') event.preventDefault()
+  }
+  return { selected, expanded, key, getChildren, state, select, toggle, keepRowClick }
+}

package/src/components/tree/tree.variants.ts

@@ -0,0 +1,22 @@
+import { tv } from '../../lib/tv'
+
+export const tree = tv({
+  base: 'flex w-full min-w-0 flex-col outline-none',
+})
+
+export const treeRow = tv({
+  base: [
+    'hn-interactive hn-state-layer hn-press-none relative isolate flex w-full cursor-pointer',
+    'items-center gap-(--hn-control-gap) rounded-md py-2 pe-2.5 text-start text-sm select-none',
+    'ps-[calc(0.375rem+var(--hn-tree-level)*1.25rem)] text-fg outline-none',
+    'data-disabled:pointer-events-none data-disabled:opacity-50',
+  ],
+})
+
+export const treeToggle = tv({
+  base: 'text-muted flex size-5 shrink-0 cursor-pointer items-center justify-center rounded-sm rtl:-scale-x-100 [&>span>svg]:size-3.5',
+})
+
+export const treeEmpty = tv({
+  base: 'text-muted px-2.5 py-2 text-sm',
+})

package/src/components/tree/types.ts

@@ -0,0 +1,20 @@
+export type TreeValue = string | number
+
+export interface TreeNode {
+  value: TreeValue
+  label: string
+  description?: string
+  disabled?: boolean
+  children?: TreeNode[]
+}
+
+export interface TreeNodeState {
+  selected: boolean
+  indeterminate: boolean
+  disabled: boolean
+}
+
+export interface TreeNodeSlot extends TreeNodeState {
+  node: TreeNode
+  expanded: boolean
+}

package/src/components/tree/utils/selection.ts

@@ -0,0 +1,78 @@
+import type { TreeNode, TreeNodeState, TreeValue } from '../types'
+
+interface Entry {
+  node: TreeNode
+  parent?: TreeValue
+  children: TreeValue[]
+  disabled: boolean
+}
+
+export interface TreeIndex {
+  roots: TreeValue[]
+  entries: Map<TreeValue, Entry>
+}
+
+export function indexTree(nodes: TreeNode[]): TreeIndex {
+  const entries = new Map<TreeValue, Entry>()
+  function visit(node: TreeNode, parent?: TreeValue, disabled = false) {
+    const entry = {
+      node,
+      parent,
+      disabled: disabled || !!node.disabled,
+      children: node.children?.map(child => child.value) ?? [],
+    }
+    entries.set(node.value, entry)
+    node.children?.forEach(child => visit(child, node.value, entry.disabled))
+  }
+  nodes.forEach(node => visit(node))
+  return { roots: nodes.map(node => node.value), entries }
+}
+
+export function checkedState(tree: TreeIndex, values: TreeValue[]) {
+  const checked = new Set(values)
+  const states = new Map<TreeValue, TreeNodeState>()
+  function visit(value: TreeValue, inherited = false): TreeNodeState {
+    const entry = tree.entries.get(value)!
+    const own = checked.has(value) || (!entry.disabled && inherited)
+    const children = entry.children.map(child => visit(child, !entry.disabled && own))
+    const enabled = children.filter(child => !child.disabled)
+    const selected =
+      entry.disabled || enabled.length === 0 ? own : enabled.every(child => child.selected)
+    const indeterminate =
+      !entry.disabled && !selected && enabled.some(child => child.selected || child.indeterminate)
+    const state = { selected, indeterminate, disabled: entry.disabled }
+    states.set(value, state)
+    return state
+  }
+  tree.roots.forEach(value => visit(value))
+  return states
+}
+
+export function toggleChecked(tree: TreeIndex, values: TreeValue[], value: TreeValue): TreeValue[] {
+  const entry = tree.entries.get(value)
+  if (!entry || entry.disabled) return values
+  const states = checkedState(tree, values)
+  const checked = new Set(values.filter(value => !tree.entries.has(value)))
+  states.forEach((state, value) => {
+    if (state.selected) checked.add(value)
+  })
+  const selected = !states.get(value)!.selected
+  function visit(value: TreeValue) {
+    const entry = tree.entries.get(value)!
+    if (entry.disabled) return
+    if (selected) checked.add(value)
+    else checked.delete(value)
+    entry.children.forEach(visit)
+  }
+  visit(value)
+  let parent = entry.parent
+  while (parent !== undefined) {
+    checked.delete(parent)
+    parent = tree.entries.get(parent)!.parent
+  }
+  const next = checkedState(tree, [...checked])
+  return [
+    ...[...checked].filter(value => !tree.entries.has(value)),
+    ...[...tree.entries.keys()].filter(value => next.get(value)!.selected),
+  ]
+}

package/src/index.ts

@@ -62,6 +62,8 @@ export { default as CommandPalette } from './components/command-palette/CommandP
 export type { CommandItem, CommandGroup, CommandItems } from './components/command-palette/types'
 export { default as Listbox } from './components/listbox/Listbox.vue'
 export type { ListboxVariants } from './components/listbox/listbox.variants'
+export { default as Tree } from './components/tree/Tree.vue'
+export type { TreeNode, TreeNodeSlot, TreeValue } from './components/tree/types'
 export { default as TreeSelect } from './components/tree-select/TreeSelect.vue'
 export type { TreeSelectNode } from './components/tree-select/types'
 export { default as Checkbox } from './components/checkbox/Checkbox.vue'
@@ -197,6 +199,7 @@ export { default as AccordionTrigger } from './components/accordion/AccordionTri
 export { default as AccordionContent } from './components/accordion/AccordionContent.vue'
 export { default as NavLink } from './components/nav-link/NavLink.vue'
 export { default as Sidebar } from './components/sidebar/Sidebar.vue'
+export { default as SidebarLabel } from './components/sidebar/SidebarLabel.vue'
 export { default as SidebarGroup } from './components/sidebar/SidebarGroup.vue'
 export { default as AppShell } from './components/app-shell/AppShell.vue'
 export { default as Page } from './components/page/Page.vue'

package/src/locale/en-US.ts

@@ -105,6 +105,7 @@ export const enUS: UiMessages = {
     show: 'Show password',
     hide: 'Hide password',
   },
+  tree: { empty: 'No nodes' },
   treeSelect: {
     search: 'Search nodes',
   },

package/src/locale/index.ts

@@ -36,6 +36,7 @@ function merge(base: UiMessages, patch: PartialUiMessages): UiMessages {
     chip: { ...base.chip, ...patch.chip },
     numberInput: { ...base.numberInput, ...patch.numberInput },
     passwordInput: { ...base.passwordInput, ...patch.passwordInput },
+    tree: { ...base.tree, ...patch.tree },
     treeSelect: { ...base.treeSelect, ...patch.treeSelect },
     combobox: { ...base.combobox, ...patch.combobox },
     slider: { ...base.slider, ...patch.slider },

package/src/locale/types.ts

@@ -102,6 +102,9 @@ export interface UiMessages {
     show: string
     hide: string
   }
+  tree: {
+    empty: string
+  }
   treeSelect: {
     search: string
   }

package/src/locale/zh-CN.ts

@@ -105,6 +105,7 @@ export const zhCN: UiMessages = {
     show: '显示密码',
     hide: '隐藏密码',
   },
+  tree: { empty: '暂无节点' },
   treeSelect: {
     search: '搜索节点',
   },

package/src/styles/motion.css

@@ -616,3 +616,43 @@
     }
   }
 }
+
+@utility hn-sidebar {
+  transition:
+    width var(--hn-duration-base) var(--hn-ease-move),
+    border-color var(--hn-duration-base) var(--hn-ease-move),
+    visibility 0s;
+
+  &[data-state='hidden'] {
+    visibility: hidden;
+    transition:
+      width var(--hn-duration-base) var(--hn-ease-move),
+      border-color var(--hn-duration-base) var(--hn-ease-move),
+      visibility 0s var(--hn-duration-base);
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    transition: none;
+  }
+}
+
+@utility hn-sidebar-label {
+  opacity: 1;
+  visibility: visible;
+  transition:
+    opacity var(--hn-duration-fast) var(--hn-ease-enter) var(--hn-duration-fast),
+    visibility 0s var(--hn-duration-fast);
+
+  &[data-collapsed] {
+    opacity: 0;
+    visibility: hidden;
+    pointer-events: none;
+    transition:
+      opacity calc(var(--hn-duration-fast) / 2) var(--hn-ease-exit),
+      visibility 0s calc(var(--hn-duration-fast) / 2);
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    transition: none;
+  }
+}