sh-ui-cli 0.115.0 → 0.117.0

package/data/registry/react/components/tree/index.tailwind.tsx

@@ -0,0 +1,224 @@
+import * as React from "react";
+import { cn } from "@SH_UI_UTILS@";
+import type { TreeNode, TreeProps } from "./types";
+export type { TreeNode, TreeProps, TreeSize } from "./types";
+import { flattenVisible, nextFocusable, prevFocusable, findByTypeahead } from "./flatten";
+
+function useControllableSet(
+  controlled: string[] | undefined,
+  defaultValue: string[] | undefined,
+  onChange?: (ids: string[]) => void,
+) {
+  const [internal, setInternal] = React.useState<Set<string>>(
+    () => new Set(controlled ?? defaultValue ?? []),
+  );
+  const set = controlled ? new Set(controlled) : internal;
+  const update = (next: Set<string>) => {
+    if (!controlled) setInternal(next);
+    onChange?.([...next]);
+  };
+  return [set, update] as const;
+}
+
+export const Tree = React.forwardRef<HTMLDivElement, TreeProps>(function Tree(
+  {
+    nodes,
+    expandedIds,
+    defaultExpandedIds,
+    onExpandedChange,
+    selectedId,
+    defaultSelectedId,
+    onSelect,
+    renderLabel,
+    size = "md",
+    className,
+  },
+  ref,
+) {
+  const [expanded, setExpanded] = useControllableSet(
+    expandedIds,
+    defaultExpandedIds,
+    onExpandedChange,
+  );
+
+  const isSelectedControlled = selectedId !== undefined;
+  const [selInternal, setSelInternal] = React.useState<string | null>(
+    defaultSelectedId ?? null,
+  );
+  const selected = isSelectedControlled ? selectedId! : selInternal;
+  const selectNode = (id: string | null) => {
+    if (!isSelectedControlled) setSelInternal(id);
+    onSelect?.(id);
+  };
+
+  const visible = flattenVisible(nodes, expanded);
+  const visibleMap = React.useMemo(() => new Map(visible.map((v) => [v.id, v])), [visible]);
+  const [focusId, setFocusId] = React.useState<string | null>(visible[0]?.id ?? null);
+
+  React.useEffect(() => {
+    if (focusId && !visibleMap.has(focusId)) {
+      setFocusId(visible[0]?.id ?? null);
+    }
+  }, [visibleMap, focusId, visible]);
+
+  const toggle = (id: string) => {
+    const next = new Set(expanded);
+    if (next.has(id)) next.delete(id);
+    else next.add(id);
+    setExpanded(next);
+  };
+
+  const onItemClick = (n: TreeNode, hasChildren: boolean) => {
+    if (n.disabled) return;
+    setFocusId(n.id);
+    if (hasChildren) toggle(n.id);
+    selectNode(n.id);
+  };
+
+  const itemRefs = React.useRef<Map<string, HTMLDivElement>>(new Map());
+  const focusNode = (id: string) => {
+    setFocusId(id);
+    itemRefs.current.get(id)?.focus();
+  };
+
+  const onItemKeyDown = (e: React.KeyboardEvent, n: TreeNode, hasChildren: boolean) => {
+    switch (e.key) {
+      case "ArrowDown": {
+        e.preventDefault();
+        const nx = nextFocusable(visible, n.id);
+        if (nx) focusNode(nx.id);
+        break;
+      }
+      case "ArrowUp": {
+        e.preventDefault();
+        const pv = prevFocusable(visible, n.id);
+        if (pv) focusNode(pv.id);
+        break;
+      }
+      case "ArrowRight": {
+        e.preventDefault();
+        if (hasChildren && !expanded.has(n.id)) toggle(n.id);
+        else if (hasChildren) {
+          const first = n.children!.find((c) => !c.disabled);
+          if (first) focusNode(first.id);
+        }
+        break;
+      }
+      case "ArrowLeft": {
+        e.preventDefault();
+        if (hasChildren && expanded.has(n.id)) toggle(n.id);
+        else {
+          const meta = visibleMap.get(n.id);
+          if (meta?.parentId) focusNode(meta.parentId);
+        }
+        break;
+      }
+      case "Home": {
+        e.preventDefault();
+        const first = visible.find((v) => !v.disabled);
+        if (first) focusNode(first.id);
+        break;
+      }
+      case "End": {
+        e.preventDefault();
+        for (let i = visible.length - 1; i >= 0; i--)
+          if (!visible[i].disabled) {
+            focusNode(visible[i].id);
+            break;
+          }
+        break;
+      }
+      case "Enter":
+      case " ": {
+        e.preventDefault();
+        if (!n.disabled) selectNode(n.id);
+        break;
+      }
+      default: {
+        if (e.key.length === 1 && /\S/.test(e.key)) {
+          const hit = findByTypeahead(visible, e.key, n.id);
+          if (hit) focusNode(hit.id);
+        }
+      }
+    }
+  };
+
+  const renderNodes = (siblings: TreeNode[], level: number): React.ReactNode => (
+    <div role={level === 0 ? undefined : "group"} className="flex flex-col">
+      {siblings.map((n) => {
+        const hasChildren = !!n.children?.length;
+        const isExpanded = hasChildren && expanded.has(n.id);
+        const meta = visibleMap.get(n.id);
+        const depth = meta?.level ?? level;
+        return (
+          <div key={n.id}>
+            <div
+              role="treeitem"
+              ref={(el) => {
+                if (el) itemRefs.current.set(n.id, el);
+                else itemRefs.current.delete(n.id);
+              }}
+              aria-level={depth + 1}
+              aria-setsize={meta?.setSize}
+              aria-posinset={meta?.posInSet}
+              aria-expanded={hasChildren ? isExpanded : undefined}
+              aria-selected={selected === n.id}
+              aria-disabled={n.disabled || undefined}
+              aria-label={typeof n.label === "string" ? n.label : undefined}
+              tabIndex={focusId === n.id ? 0 : -1}
+              data-disabled={n.disabled || undefined}
+              className={cn(
+                "flex items-center gap-[var(--space-2)] px-[var(--space-2)] py-[var(--space-2)] rounded-[calc(var(--radius)-2px)] cursor-pointer select-none transition-[background-color] duration-[var(--duration-fast)] hover:not-data-[disabled]:bg-background-muted focus-visible:outline-[length:var(--border-width-strong)] focus-visible:outline-ring focus-visible:outline-offset-[-2px] data-[disabled]:text-foreground-muted data-[disabled]:cursor-not-allowed motion-reduce:transition-none",
+                selected === n.id && "bg-background-muted font-medium",
+              )}
+              onClick={() => onItemClick(n, hasChildren)}
+              onKeyDown={(e) => onItemKeyDown(e, n, hasChildren)}
+            >
+              <span
+                style={{ width: `calc(var(--space-4) * ${depth})` }}
+                aria-hidden
+              />
+              {hasChildren ? (
+                <span
+                  className="inline-flex w-[var(--space-4)] justify-center transition-transform duration-[var(--duration-fast)] data-[expanded]:rotate-90 motion-reduce:transition-none"
+                  data-expanded={isExpanded || undefined}
+                  aria-hidden
+                >
+                  ▸
+                </span>
+              ) : (
+                <span
+                  className="inline-flex w-[var(--space-4)] justify-center transition-transform duration-[var(--duration-fast)] data-[expanded]:rotate-90 motion-reduce:transition-none invisible"
+                  aria-hidden
+                />
+              )}
+              {n.icon ? (
+                <span className="inline-flex" aria-hidden>
+                  {n.icon}
+                </span>
+              ) : null}
+              <span className="min-w-0 [overflow-wrap:anywhere]">
+                {renderLabel ? renderLabel(n) : n.label}
+              </span>
+            </div>
+            {isExpanded ? renderNodes(n.children!, level + 1) : null}
+          </div>
+        );
+      })}
+    </div>
+  );
+
+  return (
+    <div
+      ref={ref}
+      role="tree"
+      data-size={size}
+      className={cn(
+        "flex flex-col w-full text-foreground text-[0.9375rem] data-[size=sm]:text-[length:var(--text-xs)]",
+        className,
+      )}
+    >
+      {renderNodes(nodes, 0)}
+    </div>
+  );
+});

package/data/registry/react/components/tree/index.tsx

@@ -0,0 +1,215 @@
+import * as React from "react";
+import "./styles.css";
+import { cn } from "@SH_UI_UTILS@";
+import type { TreeNode, TreeProps } from "./types";
+export type { TreeNode, TreeProps, TreeSize } from "./types";
+import { flattenVisible, nextFocusable, prevFocusable, findByTypeahead } from "./flatten";
+
+function useControllableSet(
+  controlled: string[] | undefined,
+  defaultValue: string[] | undefined,
+  onChange?: (ids: string[]) => void,
+) {
+  const [internal, setInternal] = React.useState<Set<string>>(
+    () => new Set(controlled ?? defaultValue ?? []),
+  );
+  const set = controlled ? new Set(controlled) : internal;
+  const update = (next: Set<string>) => {
+    if (!controlled) setInternal(next);
+    onChange?.([...next]);
+  };
+  return [set, update] as const;
+}
+
+export const Tree = React.forwardRef<HTMLDivElement, TreeProps>(function Tree(
+  {
+    nodes,
+    expandedIds,
+    defaultExpandedIds,
+    onExpandedChange,
+    selectedId,
+    defaultSelectedId,
+    onSelect,
+    renderLabel,
+    size = "md",
+    className,
+  },
+  ref,
+) {
+  const [expanded, setExpanded] = useControllableSet(
+    expandedIds,
+    defaultExpandedIds,
+    onExpandedChange,
+  );
+
+  const isSelectedControlled = selectedId !== undefined;
+  const [selInternal, setSelInternal] = React.useState<string | null>(
+    defaultSelectedId ?? null,
+  );
+  const selected = isSelectedControlled ? selectedId! : selInternal;
+  const selectNode = (id: string | null) => {
+    if (!isSelectedControlled) setSelInternal(id);
+    onSelect?.(id);
+  };
+
+  const visible = flattenVisible(nodes, expanded);
+  const visibleMap = React.useMemo(() => new Map(visible.map((v) => [v.id, v])), [visible]);
+  const [focusId, setFocusId] = React.useState<string | null>(visible[0]?.id ?? null);
+
+  React.useEffect(() => {
+    if (focusId && !visibleMap.has(focusId)) {
+      setFocusId(visible[0]?.id ?? null);
+    }
+  }, [visibleMap, focusId, visible]);
+
+  const toggle = (id: string) => {
+    const next = new Set(expanded);
+    if (next.has(id)) next.delete(id);
+    else next.add(id);
+    setExpanded(next);
+  };
+
+  const onItemClick = (n: TreeNode, hasChildren: boolean) => {
+    if (n.disabled) return;
+    setFocusId(n.id);
+    if (hasChildren) toggle(n.id);
+    selectNode(n.id);
+  };
+
+  const itemRefs = React.useRef<Map<string, HTMLDivElement>>(new Map());
+  const focusNode = (id: string) => {
+    setFocusId(id);
+    itemRefs.current.get(id)?.focus();
+  };
+
+  const onItemKeyDown = (e: React.KeyboardEvent, n: TreeNode, hasChildren: boolean) => {
+    switch (e.key) {
+      case "ArrowDown": {
+        e.preventDefault();
+        const nx = nextFocusable(visible, n.id);
+        if (nx) focusNode(nx.id);
+        break;
+      }
+      case "ArrowUp": {
+        e.preventDefault();
+        const pv = prevFocusable(visible, n.id);
+        if (pv) focusNode(pv.id);
+        break;
+      }
+      case "ArrowRight": {
+        e.preventDefault();
+        if (hasChildren && !expanded.has(n.id)) toggle(n.id);
+        else if (hasChildren) {
+          const first = n.children!.find((c) => !c.disabled);
+          if (first) focusNode(first.id);
+        }
+        break;
+      }
+      case "ArrowLeft": {
+        e.preventDefault();
+        if (hasChildren && expanded.has(n.id)) toggle(n.id);
+        else {
+          const meta = visibleMap.get(n.id);
+          if (meta?.parentId) focusNode(meta.parentId);
+        }
+        break;
+      }
+      case "Home": {
+        e.preventDefault();
+        const first = visible.find((v) => !v.disabled);
+        if (first) focusNode(first.id);
+        break;
+      }
+      case "End": {
+        e.preventDefault();
+        for (let i = visible.length - 1; i >= 0; i--)
+          if (!visible[i].disabled) {
+            focusNode(visible[i].id);
+            break;
+          }
+        break;
+      }
+      case "Enter":
+      case " ": {
+        e.preventDefault();
+        if (!n.disabled) selectNode(n.id);
+        break;
+      }
+      default: {
+        if (e.key.length === 1 && /\S/.test(e.key)) {
+          const hit = findByTypeahead(visible, e.key, n.id);
+          if (hit) focusNode(hit.id);
+        }
+      }
+    }
+  };
+
+  const renderNodes = (siblings: TreeNode[], level: number): React.ReactNode => (
+    <div role={level === 0 ? undefined : "group"} className="sh-ui-tree__group">
+      {siblings.map((n) => {
+        const hasChildren = !!n.children?.length;
+        const isExpanded = hasChildren && expanded.has(n.id);
+        const meta = visibleMap.get(n.id);
+        const depth = meta?.level ?? level;
+        return (
+          <div key={n.id}>
+            <div
+              role="treeitem"
+              ref={(el) => {
+                if (el) itemRefs.current.set(n.id, el);
+                else itemRefs.current.delete(n.id);
+              }}
+              aria-level={depth + 1}
+              aria-setsize={meta?.setSize}
+              aria-posinset={meta?.posInSet}
+              aria-expanded={hasChildren ? isExpanded : undefined}
+              aria-selected={selected === n.id}
+              aria-disabled={n.disabled || undefined}
+              aria-label={typeof n.label === "string" ? n.label : undefined}
+              tabIndex={focusId === n.id ? 0 : -1}
+              data-disabled={n.disabled || undefined}
+              className={cn(
+                "sh-ui-tree__item",
+                selected === n.id && "sh-ui-tree__item--selected",
+              )}
+              onClick={() => onItemClick(n, hasChildren)}
+              onKeyDown={(e) => onItemKeyDown(e, n, hasChildren)}
+            >
+              <span
+                className="sh-ui-tree__indent"
+                style={{ width: `calc(var(--space-4) * ${depth})` }}
+                aria-hidden
+              />
+              {hasChildren ? (
+                <span
+                  className="sh-ui-tree__chevron"
+                  data-expanded={isExpanded || undefined}
+                  aria-hidden
+                >
+                  ▸
+                </span>
+              ) : (
+                <span className="sh-ui-tree__chevron sh-ui-tree__chevron--leaf" aria-hidden />
+              )}
+              {n.icon ? (
+                <span className="sh-ui-tree__icon" aria-hidden>
+                  {n.icon}
+                </span>
+              ) : null}
+              <span className="sh-ui-tree__label">
+                {renderLabel ? renderLabel(n) : n.label}
+              </span>
+            </div>
+            {isExpanded ? renderNodes(n.children!, level + 1) : null}
+          </div>
+        );
+      })}
+    </div>
+  );
+
+  return (
+    <div ref={ref} role="tree" data-size={size} className={cn("sh-ui-tree", className)}>
+      {renderNodes(nodes, 0)}
+    </div>
+  );
+});

package/data/registry/react/components/tree/styles.css

@@ -0,0 +1,69 @@
+.sh-ui-tree {
+  display: flex;
+  flex-direction: column;
+  width: 100%;
+  color: var(--foreground);
+  font-size: 0.9375rem;
+}
+.sh-ui-tree[data-size="sm"] {
+  font-size: var(--text-xs);
+}
+
+.sh-ui-tree__group {
+  display: flex;
+  flex-direction: column;
+}
+
+.sh-ui-tree__item {
+  display: flex;
+  align-items: center;
+  gap: var(--space-2);
+  padding: var(--space-2) var(--space-2);
+  border-radius: calc(var(--radius) - 2px);
+  cursor: pointer;
+  user-select: none;
+  transition: background-color var(--duration-fast) var(--ease-standard);
+}
+.sh-ui-tree__item:not([data-disabled]):hover {
+  background: var(--background-muted);
+}
+.sh-ui-tree__item:focus-visible {
+  outline: var(--border-width-strong) solid var(--ring);
+  outline-offset: -2px;
+}
+.sh-ui-tree__item--selected {
+  background: var(--background-muted);
+  font-weight: var(--weight-medium);
+}
+.sh-ui-tree__item[data-disabled] {
+  color: var(--foreground-muted);
+  cursor: not-allowed;
+}
+
+.sh-ui-tree__chevron {
+  display: inline-flex;
+  width: var(--space-4);
+  justify-content: center;
+  transition: transform var(--duration-fast) var(--ease-standard);
+}
+.sh-ui-tree__chevron[data-expanded] {
+  transform: rotate(90deg);
+}
+.sh-ui-tree__chevron--leaf {
+  visibility: hidden;
+}
+
+.sh-ui-tree__icon {
+  display: inline-flex;
+}
+.sh-ui-tree__label {
+  min-width: 0;
+  overflow-wrap: anywhere;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .sh-ui-tree__item,
+  .sh-ui-tree__chevron {
+    transition: none;
+  }
+}

package/data/registry/react/components/tree/styles.module.css

@@ -0,0 +1,69 @@
+.tree {
+  display: flex;
+  flex-direction: column;
+  width: 100%;
+  color: var(--foreground);
+  font-size: 0.9375rem;
+}
+.tree[data-size="sm"] {
+  font-size: var(--text-xs);
+}
+
+.tree__group {
+  display: flex;
+  flex-direction: column;
+}
+
+.tree__item {
+  display: flex;
+  align-items: center;
+  gap: var(--space-2);
+  padding: var(--space-2) var(--space-2);
+  border-radius: calc(var(--radius) - 2px);
+  cursor: pointer;
+  user-select: none;
+  transition: background-color var(--duration-fast) var(--ease-standard);
+}
+.tree__item:not([data-disabled]):hover {
+  background: var(--background-muted);
+}
+.tree__item:focus-visible {
+  outline: var(--border-width-strong) solid var(--ring);
+  outline-offset: -2px;
+}
+.tree__item--selected {
+  background: var(--background-muted);
+  font-weight: var(--weight-medium);
+}
+.tree__item[data-disabled] {
+  color: var(--foreground-muted);
+  cursor: not-allowed;
+}
+
+.tree__chevron {
+  display: inline-flex;
+  width: var(--space-4);
+  justify-content: center;
+  transition: transform var(--duration-fast) var(--ease-standard);
+}
+.tree__chevron[data-expanded] {
+  transform: rotate(90deg);
+}
+.tree__chevron--leaf {
+  visibility: hidden;
+}
+
+.tree__icon {
+  display: inline-flex;
+}
+.tree__label {
+  min-width: 0;
+  overflow-wrap: anywhere;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .tree__item,
+  .tree__chevron {
+    transition: none;
+  }
+}

package/data/registry/react/components/tree/tree.test.tsx

@@ -0,0 +1,110 @@
+import { describe, it, expect, vi } from "vitest";
+import { render, screen, fireEvent } from "@testing-library/react";
+import * as React from "react";
+import { Tree } from "./index";
+import type { TreeNode } from "./types";
+
+const nodes: TreeNode[] = [
+  { id: "a", label: "Apple", children: [{ id: "a1", label: "Ant" }] },
+  { id: "b", label: "Banana" },
+];
+
+describe("Tree 렌더 + 상태", () => {
+  it("role=tree 와 최상위 treeitem 을 렌더", () => {
+    render(<Tree nodes={nodes} />);
+    expect(screen.getByRole("tree")).toBeTruthy();
+    const items = screen.getAllByRole("treeitem");
+    expect(items.length).toBe(2);
+  });
+
+  it("부모 toggle 클릭으로 비제어 확장 → 자식 노출", () => {
+    render(<Tree nodes={nodes} />);
+    fireEvent.click(screen.getByText("Apple"));
+    expect(screen.getByText("Ant")).toBeTruthy();
+    expect(screen.getByRole("treeitem", { name: /Apple/ }).getAttribute("aria-expanded")).toBe("true");
+  });
+
+  it("제어 selectedId 가 aria-selected 로 반영", () => {
+    render(<Tree nodes={nodes} selectedId="b" />);
+    expect(screen.getByRole("treeitem", { name: /Banana/ }).getAttribute("aria-selected")).toBe("true");
+  });
+
+  it("노드 클릭이 onSelect 를 호출", () => {
+    const onSelect = vi.fn();
+    render(<Tree nodes={nodes} onSelect={onSelect} />);
+    fireEvent.click(screen.getByText("Banana"));
+    expect(onSelect).toHaveBeenCalledWith("b");
+  });
+
+  it("aria-level 이 깊이를 반영", () => {
+    render(<Tree nodes={nodes} defaultExpandedIds={["a"]} />);
+    expect(screen.getByRole("treeitem", { name: /Ant/ }).getAttribute("aria-level")).toBe("2");
+  });
+
+  it("aria-setsize / aria-posinset 가 형제 집합을 반영", () => {
+    render(<Tree nodes={nodes} />);
+    const apple = screen.getByRole("treeitem", { name: /Apple/ });
+    const banana = screen.getByRole("treeitem", { name: /Banana/ });
+    expect(apple.getAttribute("aria-setsize")).toBe("2");
+    expect(apple.getAttribute("aria-posinset")).toBe("1");
+    expect(banana.getAttribute("aria-posinset")).toBe("2");
+  });
+
+  it("제어 expandedIds 는 외부 값이 우선 (클릭 무관)", () => {
+    const { rerender } = render(<Tree nodes={nodes} expandedIds={["a"]} />);
+    expect(screen.getByText("Ant")).toBeTruthy();
+    rerender(<Tree nodes={nodes} expandedIds={[]} />);
+    expect(screen.queryByText("Ant")).toBeNull();
+  });
+
+  it("disabled 노드 클릭은 onSelect 를 호출하지 않는다", () => {
+    const onSelect = vi.fn();
+    const dnodes = [
+      { id: "x", label: "Xenon", disabled: true },
+      { id: "y", label: "Yttrium" },
+    ];
+    render(<Tree nodes={dnodes} onSelect={onSelect} />);
+    fireEvent.click(screen.getByText("Xenon"));
+    expect(onSelect).not.toHaveBeenCalled();
+  });
+});
+
+describe("Tree 키보드", () => {
+  function setup() {
+    render(<Tree nodes={nodes} defaultExpandedIds={["a"]} defaultSelectedId="a" />);
+    return screen.getByRole("tree");
+  }
+
+  it("ArrowDown 이 다음 가시 노드로 포커스 이동", () => {
+    setup();
+    const a = screen.getByRole("treeitem", { name: /Apple/ });
+    a.focus();
+    fireEvent.keyDown(a, { key: "ArrowDown" });
+    expect(screen.getByRole("treeitem", { name: /Ant/ }).getAttribute("tabindex")).toBe("0");
+  });
+
+  it("ArrowLeft 가 열린 부모를 축소", () => {
+    setup();
+    const a = screen.getByRole("treeitem", { name: /Apple/ });
+    a.focus();
+    fireEvent.keyDown(a, { key: "ArrowLeft" });
+    expect(a.getAttribute("aria-expanded")).toBe("false");
+  });
+
+  it("ArrowRight 가 닫힌 부모를 확장", () => {
+    render(<Tree nodes={nodes} />);
+    const a = screen.getByRole("treeitem", { name: /Apple/ });
+    a.focus();
+    fireEvent.keyDown(a, { key: "ArrowRight" });
+    expect(a.getAttribute("aria-expanded")).toBe("true");
+  });
+
+  it("Enter 가 포커스 노드를 선택", () => {
+    const onSelect = vi.fn();
+    render(<Tree nodes={nodes} onSelect={onSelect} />);
+    const b = screen.getByRole("treeitem", { name: /Banana/ });
+    b.focus();
+    fireEvent.keyDown(b, { key: "Enter" });
+    expect(onSelect).toHaveBeenCalledWith("b");
+  });
+});