sh-ui-cli 0.46.0 → 0.48.0

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;
+}