sh-ui-cli 0.45.3 → 0.47.0

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

@@ -0,0 +1,75 @@
+/* ───────────── Checkbox ───────────── */
+
+.checkbox {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 1.125rem;
+  height: 1.125rem;
+  border: 1px solid var(--border-strong);
+  border-radius: calc(var(--radius) - 2px);
+  background: var(--background);
+  color: var(--primary-foreground);
+  cursor: pointer;
+  flex-shrink: 0;
+  transition: background-color var(--duration-fast), border-color var(--duration-fast);
+  -webkit-tap-highlight-color: transparent;
+}
+
+.checkbox:hover:not([data-disabled]) {
+  border-color: var(--foreground);
+}
+
+.checkbox:focus-visible {
+  outline: var(--border-width-strong) solid var(--foreground);
+  outline-offset: 2px;
+}
+
+.checkbox[data-checked],
+.checkbox[data-indeterminate] {
+  background: var(--primary);
+  border-color: var(--primary);
+}
+
+.checkbox[data-disabled] {
+  opacity: var(--opacity-disabled);
+  cursor: not-allowed;
+}
+
+/* 모바일/터치: 최소 탭 영역 */
+@media (hover: none) and (pointer: coarse) {
+  .checkbox {
+    width: 1.25rem;
+    height: 1.25rem;
+  }
+}
+
+/* ───────────── Indicator ───────────── */
+
+.checkbox__indicator {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+}
+
+/* ───────────── CheckboxGroup ───────────── */
+
+.checkbox-group {
+  display: flex;
+  gap: 0.625rem;
+}
+
+.checkbox-group[data-orientation="vertical"] {
+  flex-direction: column;
+}
+
+.checkbox-group[data-orientation="horizontal"] {
+  flex-direction: row;
+  flex-wrap: wrap;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .checkbox {
+    transition: none;
+  }
+}

package/data/registry/react/components/code-editor/index.module.tsx

@@ -0,0 +1,230 @@
+"use client";
+
+import { useEffect, useMemo, useRef } from "react";
+import { Compartment, EditorState, type Extension } from "@codemirror/state";
+import { EditorView, placeholder as placeholderExt } from "@codemirror/view";
+import { basicSetup } from "codemirror";
+import { javascript } from "@codemirror/lang-javascript";
+import { json } from "@codemirror/lang-json";
+import { css as cssLang } from "@codemirror/lang-css";
+import { html } from "@codemirror/lang-html";
+import { markdown } from "@codemirror/lang-markdown";
+import styles from "./styles.module.css";
+
+import { cn } from "@SH_UI_UTILS@";
+export type CodeEditorLanguage =
+  | "text"
+  | "javascript"
+  | "typescript"
+  | "jsx"
+  | "tsx"
+  | "json"
+  | "css"
+  | "html"
+  | "markdown";
+
+export interface CodeEditorProps {
+  /**
+   * Controlled — 현재 코드. 명시 시 value 가 진실원천이 되고 onChange 로 외부에서 갱신해야 한다.
+   * 미지정이면 uncontrolled — 에디터가 자체 내부 문서로 동작.
+   */
+  value?: string;
+  /**
+   * Uncontrolled 초기값. value 미지정 시에만 사용된다.
+   * @default ""
+   */
+  defaultValue?: string;
+  /** 코드가 바뀔 때마다 호출 (controlled · uncontrolled 모두). */
+  onChange?: (value: string) => void;
+  /**
+   * 신택스 하이라이팅 언어.
+   * @default "text"
+   */
+  language?: CodeEditorLanguage;
+  /** 비어 있을 때 표시할 placeholder. */
+  placeholder?: string;
+  /** 읽기 전용. 키 입력은 막지만 선택·복사는 가능. */
+  readOnly?: boolean;
+  /**
+   * 좌측 줄 번호 표시 여부.
+   * @default true
+   */
+  showLineNumbers?: boolean;
+  /** 에디터 최소 높이 (CSS 길이 단위). */
+  minHeight?: string;
+  /** 에디터 최대 높이 (CSS 길이 단위). 초과 시 내부 스크롤. */
+  maxHeight?: string;
+  className?: string;
+  id?: string;
+  "aria-label"?: string;
+  "aria-labelledby"?: string;
+}
+
+
+function languageExtension(language: CodeEditorLanguage): Extension {
+  switch (language) {
+    case "javascript":
+      return javascript();
+    case "typescript":
+      return javascript({ typescript: true });
+    case "jsx":
+      return javascript({ jsx: true });
+    case "tsx":
+      return javascript({ jsx: true, typescript: true });
+    case "json":
+      return json();
+    case "css":
+      return cssLang();
+    case "html":
+      return html();
+    case "markdown":
+      return markdown();
+    case "text":
+    default:
+      return [];
+  }
+}
+
+/**
+ * CodeMirror 6 기반 인라인 코드 에디터.
+ *
+ * Controlled (value/onChange) · Uncontrolled (defaultValue + 선택 onChange) 모두 지원.
+ * 라우터·외부 상태와 동기화할 게 없는 경우 defaultValue 한 줄로 끝 — useState 불필요.
+ *
+ * 신택스 하이라이팅·자동 들여쓰기·괄호 매칭 등은 CodeMirror `basicSetup` 을 그대로 사용,
+ * 컬러·여백은 sh-ui 토큰(`--background`, `--foreground`, `--border` 등)으로 매핑돼 테마에 자동 추종.
+ */
+export function CodeEditor({
+  value: valueProp,
+  defaultValue,
+  onChange,
+  language = "text",
+  placeholder,
+  readOnly = false,
+  showLineNumbers = true,
+  minHeight,
+  maxHeight,
+  className,
+  id,
+  "aria-label": ariaLabel,
+  "aria-labelledby": ariaLabelledBy,
+}: CodeEditorProps) {
+  const isControlled = valueProp !== undefined;
+  const hostRef = useRef<HTMLDivElement>(null);
+  const viewRef = useRef<EditorView | null>(null);
+  const onChangeRef = useRef(onChange);
+  onChangeRef.current = onChange;
+  const initialDocRef = useRef(valueProp ?? defaultValue ?? "");
+
+  const compartments = useMemo(
+    () => ({
+      language: new Compartment(),
+      readOnly: new Compartment(),
+      lineNumbers: new Compartment(),
+      placeholder: new Compartment(),
+    }),
+    [],
+  );
+
+  useEffect(() => {
+    if (!hostRef.current) return;
+
+    const extensions: Extension[] = [
+      basicSetup,
+      EditorView.lineWrapping,
+      EditorView.updateListener.of((update) => {
+        if (update.docChanged) {
+          onChangeRef.current?.(update.state.doc.toString());
+        }
+      }),
+      compartments.language.of(languageExtension(language)),
+      compartments.readOnly.of(EditorState.readOnly.of(readOnly)),
+      compartments.lineNumbers.of(
+        showLineNumbers
+          ? []
+          : EditorView.theme({ ".cm-gutters": { display: "none" } }),
+      ),
+      compartments.placeholder.of(placeholder ? placeholderExt(placeholder) : []),
+    ];
+
+    const view = new EditorView({
+      state: EditorState.create({ doc: initialDocRef.current, extensions }),
+      parent: hostRef.current,
+    });
+    viewRef.current = view;
+
+    return () => {
+      view.destroy();
+      viewRef.current = null;
+    };
+    // 초기 마운트 1회만 — 후속 동기화는 별도 이펙트가 처리
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
+  // controlled 모드에서만 외부 value 를 에디터 doc 에 동기화. uncontrolled 면 에디터가 자체 source-of-truth.
+  useEffect(() => {
+    if (!isControlled) return;
+    const view = viewRef.current;
+    if (!view) return;
+    const current = view.state.doc.toString();
+    if (current === valueProp) return;
+    view.dispatch({
+      changes: { from: 0, to: current.length, insert: valueProp ?? "" },
+    });
+  }, [isControlled, valueProp]);
+
+  useEffect(() => {
+    viewRef.current?.dispatch({
+      effects: compartments.language.reconfigure(languageExtension(language)),
+    });
+  }, [language, compartments.language]);
+
+  useEffect(() => {
+    viewRef.current?.dispatch({
+      effects: compartments.readOnly.reconfigure(EditorState.readOnly.of(readOnly)),
+    });
+  }, [readOnly, compartments.readOnly]);
+
+  useEffect(() => {
+    viewRef.current?.dispatch({
+      effects: compartments.lineNumbers.reconfigure(
+        showLineNumbers
+          ? []
+          : EditorView.theme({ ".cm-gutters": { display: "none" } }),
+      ),
+    });
+  }, [showLineNumbers, compartments.lineNumbers]);
+
+  useEffect(() => {
+    viewRef.current?.dispatch({
+      effects: compartments.placeholder.reconfigure(
+        placeholder ? placeholderExt(placeholder) : [],
+      ),
+    });
+  }, [placeholder, compartments.placeholder]);
+
+  useEffect(() => {
+    const view = viewRef.current;
+    if (!view) return;
+    const node = view.contentDOM;
+    if (id) node.id = id;
+    if (ariaLabel) node.setAttribute("aria-label", ariaLabel);
+    else node.removeAttribute("aria-label");
+    if (ariaLabelledBy) node.setAttribute("aria-labelledby", ariaLabelledBy);
+    else node.removeAttribute("aria-labelledby");
+  }, [id, ariaLabel, ariaLabelledBy]);
+
+  return (
+    <div
+      ref={hostRef}
+      className={cn(styles["code-editor"], className)}
+      data-readonly={readOnly || undefined}
+      style={
+        {
+          "--sh-ui-code-editor-min-height": minHeight,
+          "--sh-ui-code-editor-max-height": maxHeight,
+        } as React.CSSProperties
+      }
+    />
+  );
+}

package/data/registry/react/components/code-editor/styles.module.css

@@ -0,0 +1,76 @@
+.code-editor {
+  position: relative;
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  background: var(--background);
+  font-size: 0.8125rem;
+  line-height: 1.6;
+  overflow: hidden;
+  transition: border-color var(--duration-fast);
+}
+.code-editor:focus-within {
+  border-color: var(--foreground);
+  outline: var(--border-width-strong) solid var(--foreground);
+  outline-offset: 2px;
+}
+.code-editor[data-readonly] {
+  background: var(--background-subtle);
+}
+
+.code-editor .cm-editor {
+  background: transparent;
+  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+}
+.code-editor .cm-editor.cm-focused {
+  outline: none;
+}
+.code-editor .cm-scroller {
+  font-family: inherit;
+  min-height: var(--sh-ui-code-editor-min-height, 7.5rem);
+  max-height: var(--sh-ui-code-editor-max-height, 25rem);
+}
+.code-editor .cm-content {
+  caret-color: var(--foreground);
+  color: var(--foreground);
+  padding: var(--space-3) 0;
+}
+.code-editor .cm-line {
+  padding: 0 var(--space-3);
+}
+.code-editor .cm-gutters {
+  background: var(--background-subtle);
+  color: var(--foreground-muted);
+  border-right: 1px solid var(--border);
+}
+.code-editor .cm-activeLineGutter,
+.code-editor .cm-activeLine {
+  background: var(--background-muted);
+}
+.code-editor .cm-cursor,
+.code-editor .cm-dropCursor {
+  border-left-color: var(--foreground);
+}
+.code-editor .cm-selectionBackground,
+.code-editor .cm-editor .cm-selectionBackground,
+.code-editor .cm-editor.cm-focused > .cm-scroller > .cm-selectionLayer .cm-selectionBackground,
+.code-editor ::selection {
+  background: var(--background-muted) !important;
+}
+.code-editor .cm-placeholder {
+  color: var(--foreground-muted);
+}
+.code-editor .cm-tooltip {
+  background: var(--background);
+  border: 1px solid var(--border);
+  color: var(--foreground);
+  border-radius: calc(var(--radius) - 2px);
+}
+.code-editor .cm-tooltip-autocomplete > ul > li[aria-selected] {
+  background: var(--background-muted);
+  color: var(--foreground);
+}
+.code-editor .cm-matchingBracket,
+.code-editor .cm-nonmatchingBracket {
+  background: var(--background-muted);
+  color: var(--foreground);
+}

package/data/registry/react/components/code-panel/index.module.tsx

@@ -0,0 +1,191 @@
+import { codeToHtml } from "shiki";
+import { CodePanelCopyButton } from "./copy";
+import styles from "./styles.module.css";
+
+
+import { cn } from "@SH_UI_UTILS@";
+export interface CodePanelProps
+  extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+  /** 하이라이팅할 코드 문자열. children을 제공하지 않을 때 필수. */
+  code?: string;
+  /**
+   * shiki가 지원하는 언어 ID (예: `"tsx"`, `"typescript"`, `"bash"`, `"json"`).
+   * 미지원 언어면 plain text로 폴백.
+   *
+   * @default "text"
+   */
+  language?: string;
+  /**
+   * 상단 헤더에 표시할 파일명. 지정하면 헤더가 그려지고 그 안에 복사 버튼이 들어가며,
+   * 미지정 시 우상단에 floating 복사 버튼만 표시된다.
+   */
+  filename?: string;
+  /**
+   * 좌측 줄 번호 표시 여부.
+   * @default true
+   */
+  showLineNumbers?: boolean;
+  /**
+   * 복사 버튼 숨기기. 코드 발췌가 클립보드 복사용이 아닐 때 사용.
+   * @default false
+   */
+  hideCopy?: boolean;
+  /**
+   * compound 모드. 직접 `CodePanelHeader`/`CodePanelFilename`/`CodePanelCopy`/`CodePanelBody`를
+   * 조합해 헤더 액션 추가나 복사 버튼 위치 변경 등을 한다. 지정 시 `code`/`language` 등은 무시.
+   */
+  children?: React.ReactNode;
+}
+
+/**
+ * 코드 블록 + 복사 버튼 패널. shiki로 SSR에서 하이라이팅.
+ *
+ * 기본 사용(자식 생략) — `code` prop만 넘기면 기본 레이아웃을 렌더한다.
+ * 커스텀 구성 — `CodePanelHeader`, `CodePanelFilename`, `CodePanelCopy`,
+ * `CodePanelBody`를 직접 조합하여 헤더 액션 추가·복사 버튼 위치 변경 등이 가능하다.
+ */
+export async function CodePanel({
+  code,
+  language = "text",
+  filename,
+  showLineNumbers = true,
+  hideCopy,
+  className,
+  children,
+  ...rest
+}: CodePanelProps) {
+  const classes = cn(styles.code, className);
+
+  if (children !== undefined) {
+    return (
+      <div className={classes} {...rest}>
+        {children}
+      </div>
+    );
+  }
+
+  if (code === undefined) {
+    throw new Error("CodePanel: `code` prop 또는 children 중 하나가 필요합니다.");
+  }
+
+  const trimmed = code.replace(/\n$/, "");
+
+  return (
+    <div className={classes} {...rest}>
+      {filename ? (
+        <CodePanelHeader>
+          <CodePanelFilename>{filename}</CodePanelFilename>
+          {!hideCopy && <CodePanelCopy code={trimmed} />}
+        </CodePanelHeader>
+      ) : (
+        !hideCopy && (
+          <div className={styles["code__copy-floating"]}>
+            <CodePanelCopy code={trimmed} />
+          </div>
+        )
+      )}
+      <CodePanelBody
+        code={trimmed}
+        language={language}
+        showLineNumbers={showLineNumbers}
+      />
+    </div>
+  );
+}
+
+/* ───────── CodePanelHeader ───────── */
+
+/** 파일명·복사 버튼 등을 담는 코드 블록 상단 바. CodePanel 자식으로 사용. */
+export function CodePanelHeader({
+  className,
+  children,
+  ...props
+}: React.HTMLAttributes<HTMLDivElement>) {
+  return (
+    <div className={cn(styles.code__header, className)} {...props}>
+      {children}
+    </div>
+  );
+}
+
+/* ───────── CodePanelFilename ───────── */
+
+/** CodePanelHeader 안에 표시되는 파일명 라벨. */
+export function CodePanelFilename({
+  className,
+  children,
+  ...props
+}: React.HTMLAttributes<HTMLSpanElement>) {
+  return (
+    <span className={cn(styles.code__filename, className)} {...props}>
+      {children}
+    </span>
+  );
+}
+
+/* ───────── CodePanelCopy ─────────
+ * 클립보드 복사 버튼. 내부적으로 client 컴포넌트를 사용한다.
+ */
+
+export interface CodePanelCopyProps {
+  /** 클립보드에 복사할 코드 문자열. 부모(주로 CodePanel)가 명시적으로 전달한다. */
+  code: string;
+}
+
+/** 클립보드 복사 버튼. 부모가 복사할 코드 문자열을 명시적으로 전달한다. */
+export function CodePanelCopy({ code }: CodePanelCopyProps) {
+  return <CodePanelCopyButton code={code} />;
+}
+
+/* ───────── CodePanelBody ─────────
+ * shiki로 코드를 하이라이팅하여 렌더하는 async 컴포넌트.
+ */
+
+export interface CodePanelBodyProps
+  extends Omit<
+    React.HTMLAttributes<HTMLDivElement>,
+    "children" | "dangerouslySetInnerHTML"
+  > {
+  /** 하이라이팅할 코드 문자열. */
+  code: string;
+  /**
+   * shiki 언어 ID.
+   * @default "text"
+   */
+  language?: string;
+  /**
+   * 좌측 줄 번호 표시 여부.
+   * @default true
+   */
+  showLineNumbers?: boolean;
+}
+
+/**
+ * shiki로 코드를 SSR 하이라이팅하여 렌더하는 async 컴포넌트.
+ * 라이트/다크 테마는 `github-light`/`github-dark`를 사용하며, 부모 테마 클래스에 따라 자동 전환된다.
+ */
+export async function CodePanelBody({
+  code,
+  language = "text",
+  showLineNumbers = true,
+  className,
+  ...rest
+}: CodePanelBodyProps) {
+  const trimmed = code.replace(/\n$/, "");
+  const html = await codeToHtml(trimmed, {
+    lang: language,
+    themes: { light: "github-light", dark: "github-dark" },
+    defaultColor: false,
+  });
+
+  return (
+    <div
+      className={cn(styles.code__body, className)}
+      data-line-numbers={showLineNumbers || undefined}
+      dangerouslySetInnerHTML={{ __html: html }}
+      {...rest}
+    />
+  );
+}
+
+export { CodePanelCopyButton };

package/data/registry/react/components/code-panel/styles.module.css

@@ -0,0 +1,124 @@
+.code {
+  position: relative;
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  background: var(--background-subtle);
+  overflow: hidden;
+  font-size: 0.8125rem;
+  line-height: 1.6;
+  margin: var(--space-4) 0;
+}
+@media (max-width: 640px) {
+  .code { font-size: var(--text-xs); }
+}
+
+/* 헤더 (filename 있을 때) */
+.code__header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--space-2);
+  padding: var(--space-2) var(--space-3) var(--space-2) var(--space-4);
+  border-bottom: 1px solid var(--border);
+  background: var(--background-muted);
+  font-size: var(--text-xs);
+  color: var(--foreground-muted);
+}
+.code__filename {
+  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  color: var(--foreground);
+}
+
+/* 헤더 없을 때 우상단에 떠있는 복사 버튼 */
+.code__copy-floating {
+  position: absolute;
+  top: var(--space-2);
+  right: var(--space-2);
+  z-index: 1;
+  opacity: 0;
+  transition: opacity var(--duration-fast);
+}
+.code:hover .code__copy-floating,
+.code:focus-within .code__copy-floating {
+  opacity: 1;
+}
+
+/* 복사 버튼 */
+.code__copy {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.375rem;
+  padding: var(--space-1) var(--space-2);
+  background: var(--background);
+  color: var(--foreground-muted);
+  border: 1px solid var(--border);
+  border-radius: calc(var(--radius) - 2px);
+  font-size: var(--text-xs);
+  line-height: 1;
+  cursor: pointer;
+  transition: color var(--duration-fast), border-color var(--duration-fast), background-color var(--duration-fast);
+  -webkit-tap-highlight-color: transparent;
+}
+.code__copy:hover {
+  color: var(--foreground);
+  border-color: var(--border-strong);
+}
+.code__copy:focus-visible {
+  outline: var(--border-width-strong) solid var(--foreground);
+  outline-offset: 2px;
+}
+.code__copy-label {
+  font-size: var(--text-xs);
+}
+
+/* 코드 본문 — shiki 출력(<pre class="shiki">...) */
+.code__body {
+  overflow-x: auto;
+}
+.code__body pre {
+  margin: 0;
+  padding: var(--space-3) var(--space-4);
+  background: transparent !important;
+  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  font-size: inherit;
+  line-height: inherit;
+  border: none;
+  border-radius: 0;
+}
+.code__body code {
+  background: transparent;
+  padding: 0;
+  font-size: inherit;
+  display: block;
+}
+
+/* shiki dual theme — 기본은 light, .dark 스코프에선 dark.
+   span에는 color만 주고 background-color는 절대 강제하지 않는다.
+   (강제하면 --shiki-*-bg 변수가 상속돼 라인마다 띠가 생긴다.) */
+.code__body .shiki,
+.code__body .shiki span {
+  color: var(--shiki-light) !important;
+  background-color: transparent !important;
+}
+.dark .code__body .shiki,
+.dark .code__body .shiki span {
+  color: var(--shiki-dark) !important;
+  background-color: transparent !important;
+}
+
+/* 라인 번호 */
+.code__body[data-line-numbers] pre code {
+  counter-reset: step;
+  counter-increment: step 0;
+}
+.code__body[data-line-numbers] pre code .line::before {
+  content: counter(step);
+  counter-increment: step;
+  display: inline-block;
+  width: 1.75rem;
+  margin-right: var(--space-4);
+  text-align: right;
+  color: var(--foreground-muted);
+  opacity: 0.7;
+  user-select: none;
+}