react-panel-layout 0.5.1 → 0.6.0

package/src/demo/components/layout/CodePanel.tsx

@@ -0,0 +1,149 @@
+/**
+ * @file CodePanel component - Modern IDE-like code display panel
+ */
+import * as React from "react";
+import type { BundledLanguage, BundledTheme } from "shiki";
+import { useShikiHighlight } from "../../hooks/useShikiHighlight";
+import styles from "./CodePanel.module.css";
+
+type CopyIconProps = {
+  copied: boolean;
+};
+
+const CopyIcon: React.FC<CopyIconProps> = ({ copied }) => {
+  if (copied) {
+    return (
+      <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2">
+        <polyline points="20 6 9 17 4 12" />
+      </svg>
+    );
+  }
+  return (
+    <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2">
+      <rect x="9" y="9" width="13" height="13" rx="2" ry="2" />
+      <path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1" />
+    </svg>
+  );
+};
+
+type CodePanelHeaderProps = {
+  title: string;
+  copied: boolean;
+  onCopy: () => void;
+};
+
+const CodePanelHeader: React.FC<CodePanelHeaderProps> = ({ title, copied, onCopy }) => {
+  const buttonClassName = copied ? `${styles.copyButton} ${styles.copied}` : styles.copyButton;
+  const ariaLabel = copied ? "Copied!" : "Copy code";
+
+  return (
+    <div className={styles.header}>
+      <div className={styles.headerLeft}>
+        <svg
+          className={styles.codeIcon}
+          width="16"
+          height="16"
+          viewBox="0 0 24 24"
+          fill="none"
+          stroke="currentColor"
+          strokeWidth="2"
+        >
+          <polyline points="16 18 22 12 16 6" />
+          <polyline points="8 6 2 12 8 18" />
+        </svg>
+        <span className={styles.title}>{title}</span>
+      </div>
+      <button onClick={onCopy} className={buttonClassName} type="button" aria-label={ariaLabel}>
+        <CopyIcon copied={copied} />
+      </button>
+    </div>
+  );
+};
+
+type LineNumbersProps = {
+  count: number;
+};
+
+const LineNumbers: React.FC<LineNumbersProps> = ({ count }) => {
+  const lineNumbers = Array.from({ length: count }, (_, i) => i + 1);
+
+  return (
+    <div className={styles.lineNumbers} aria-hidden="true">
+      {lineNumbers.map((num) => (
+        <div key={num} className={styles.lineNumber}>
+          {num}
+        </div>
+      ))}
+    </div>
+  );
+};
+
+export type CodePanelProps = {
+  code: string;
+  title?: string;
+  className?: string;
+  /** Whether to show line numbers */
+  showLineNumbers?: boolean;
+  /** Whether to show the header bar */
+  showHeader?: boolean;
+  /** Maximum height for scrollable content */
+  maxHeight?: string | number;
+  /** Language for syntax highlighting (default: typescript) */
+  language?: BundledLanguage;
+  /** Theme for syntax highlighting (default: github-dark) */
+  theme?: BundledTheme;
+};
+
+/**
+ * CodePanel component
+ * Modern IDE-like code display with syntax highlighting appearance
+ */
+export const CodePanel: React.FC<CodePanelProps> = ({
+  code,
+  title = "Code",
+  className,
+  showLineNumbers = true,
+  showHeader = true,
+  maxHeight,
+  language = "jsx",
+  theme = "github-dark",
+}) => {
+  const [copied, setCopied] = React.useState(false);
+  const lineCount = React.useMemo(() => code.split("\n").length, [code]);
+  const { html, isLoading } = useShikiHighlight({ code, language, theme });
+
+  const handleCopy = React.useCallback(() => {
+    navigator.clipboard.writeText(code);
+    setCopied(true);
+    setTimeout(() => setCopied(false), 2000);
+  }, [code]);
+
+  const containerStyle = React.useMemo(() => {
+    if (!maxHeight) {
+      return undefined;
+    }
+    const value = typeof maxHeight === "number" ? `${maxHeight}px` : maxHeight;
+    return { maxHeight: value };
+  }, [maxHeight]);
+
+  const containerClassName = className ? `${styles.container} ${className}` : styles.container;
+
+  const renderCode = (): React.ReactNode => {
+    if (isLoading) {
+      return <code className={styles.code}>{code}</code>;
+    }
+    return <div className={styles.shikiWrapper} dangerouslySetInnerHTML={{ __html: html }} />;
+  };
+
+  return (
+    <div className={containerClassName}>
+      {showHeader ? <CodePanelHeader title={title} copied={copied} onCopy={handleCopy} /> : null}
+      <div className={styles.content} style={containerStyle}>
+        <pre className={styles.pre}>
+          {showLineNumbers ? <LineNumbers count={lineCount} /> : null}
+          {renderCode()}
+        </pre>
+      </div>
+    </div>
+  );
+};

package/src/demo/components/layout/DemoPage.module.css

@@ -0,0 +1,60 @@
+.page {
+  width: 100%;
+  box-sizing: border-box;
+  font-family: var(--rpl-demo-font-family);
+  color: var(--rpl-demo-text-primary);
+}
+
+.fullHeight {
+  min-height: 100%;
+  display: flex;
+  flex-direction: column;
+}
+
+.inner {
+  width: 100%;
+  margin: 0 auto;
+  display: flex;
+  flex-direction: column;
+  gap: var(--rpl-demo-space-lg);
+  min-height: 0;
+  flex: 1;
+}
+
+.header {
+  display: flex;
+  flex-direction: column;
+  gap: var(--rpl-demo-space-sm);
+  margin-bottom: var(--rpl-demo-space-md);
+}
+
+.title {
+  margin: 0;
+  font-size: var(--rpl-demo-font-size-xl);
+  font-weight: 700;
+  letter-spacing: -0.02em;
+  background: var(--rpl-demo-gradient-text);
+  background-clip: text;
+  -webkit-background-clip: text;
+  -webkit-text-fill-color: transparent;
+  display: inline-block;
+  width: fit-content;
+}
+
+.intro {
+  color: var(--rpl-demo-text-secondary);
+  font-size: var(--rpl-demo-font-size-md);
+  line-height: 1.6;
+  max-width: 800px;
+}
+
+.body {
+  display: flex;
+  flex-direction: column;
+  gap: var(--rpl-demo-space-xl);
+}
+
+.bodyStretch {
+  flex: 1;
+  min-height: 0;
+}

package/src/demo/components/layout/DemoPage.tsx

@@ -0,0 +1,56 @@
+/**
+ * @file Shared layout wrapper for demo pages
+ */
+import * as React from "react";
+import styles from "./DemoPage.module.css";
+
+export type DemoPageProps = {
+  title: string;
+  children: React.ReactNode;
+  intro?: React.ReactNode;
+  /**
+   * Maximum width for the inner content. Defaults to 1200px.
+   */
+  maxWidth?: number | string;
+  /**
+   * Optional padding around the page content. Defaults to 1.5rem.
+   */
+  padding?: number | string;
+  /**
+   * Enable full-height layout when the page needs to stretch.
+   */
+  fullHeight?: boolean;
+};
+
+const toCssValue = (value?: number | string): string | undefined => {
+  if (typeof value === "number") {
+    return `${value}px`;
+  }
+  return value;
+};
+
+export const DemoPage: React.FC<DemoPageProps> = ({
+  title,
+  intro,
+  children,
+  maxWidth,
+  padding,
+  fullHeight = false,
+}) => {
+  const resolvedMaxWidth = toCssValue(maxWidth) ?? "1200px";
+  const resolvedPadding = toCssValue(padding) ?? "1.5rem";
+  const pageClassName = fullHeight ? `${styles.page} ${styles.fullHeight}` : styles.page;
+  const bodyClassName = fullHeight ? `${styles.body} ${styles.bodyStretch}` : styles.body;
+
+  return (
+    <div className={pageClassName} style={{ padding: resolvedPadding }}>
+      <div className={styles.inner} style={{ maxWidth: resolvedMaxWidth }}>
+        <header className={styles.header}>
+          <h1 className={styles.title}>{title}</h1>
+          {intro ? <div className={styles.intro}>{intro}</div> : null}
+        </header>
+        <div className={bodyClassName}>{children}</div>
+      </div>
+    </div>
+  );
+};

package/src/demo/components/layout/SingleSamplePage.module.css

@@ -0,0 +1,11 @@
+/**
+ * SingleSamplePage styles - Full-height layout for demo pages
+ * Acts as a passthrough container to fill the entire parent area
+ */
+
+.container {
+  width: 100%;
+  height: 100%;
+  flex: 1;
+  min-height: 0;
+}

package/src/demo/components/layout/SingleSamplePage.tsx

@@ -0,0 +1,35 @@
+/**
+ * @file Convenience component for single-sample demo pages
+ */
+import * as React from "react";
+import { SplitDemoLayout } from "./SplitDemoLayout";
+import styles from "./SingleSamplePage.module.css";
+
+export type SingleSamplePageProps = {
+  title: string;
+  code: string;
+  children: React.ReactNode;
+  codeTitle?: string;
+  previewHeight?: number | string;
+  maxWidth?: number | string;
+};
+
+/**
+ * SingleSamplePage - Full-height layout for demo pages
+ * Uses the entire right pane with left code / right preview split
+ * No extra chrome - directly renders the SplitDemoLayout
+ */
+export const SingleSamplePage: React.FC<SingleSamplePageProps> = ({
+  title,
+  code,
+  children,
+  codeTitle,
+}) => {
+  return (
+    <div className={styles.container}>
+      <SplitDemoLayout code={code} codeTitle={codeTitle ?? title}>
+        {children}
+      </SplitDemoLayout>
+    </div>
+  );
+};

package/src/demo/components/layout/SplitDemoLayout.module.css

@@ -0,0 +1,107 @@
+/**
+ * SplitDemoLayout styles
+ */
+
+.container {
+  position: relative;
+  width: 100%;
+  height: 100%;
+  overflow: hidden;
+  background: var(--rpl-color-surface-2);
+}
+
+.codeWrapper {
+  height: 100%;
+  border-right: 1px solid var(--rpl-color-border);
+  background: #1e1e2e;
+}
+
+.codeWrapper>* {
+  border-radius: 0;
+  box-shadow: none;
+}
+
+.previewWrapper {
+  height: 100%;
+  width: 100%;
+  overflow: hidden;
+  background: var(--rpl-color-surface);
+}
+
+/* Drawer content */
+.drawerContent {
+  height: 100%;
+  display: flex;
+  flex-direction: column;
+  background: #1e1e2e;
+  border-top: 1px solid rgba(255, 255, 255, 0.1);
+  box-shadow: 0 -8px 32px rgba(0, 0, 0, 0.2);
+}
+
+.drawerContent>* {
+  border-radius: 0;
+  box-shadow: none;
+  flex: 1;
+  min-height: 0;
+}
+
+/* Floating code toggle button for compact mode */
+.codeToggle {
+  position: absolute;
+  bottom: 16px;
+  right: 16px;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 10px 16px;
+  background: #1e1e2e;
+  color: #cdd6f4;
+  border: 1px solid rgba(255, 255, 255, 0.1);
+  border-radius: 10px;
+  font-size: 13px;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.2s ease;
+  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.2);
+  font-family: var(--rpl-demo-font-family);
+  z-index: 50;
+}
+
+.codeToggle:hover {
+  background: #2a2a3e;
+  border-color: rgba(255, 255, 255, 0.2);
+  transform: translateY(-2px);
+  box-shadow: 0 6px 20px rgba(0, 0, 0, 0.25);
+}
+
+.codeToggle:active {
+  transform: translateY(0);
+}
+
+.codeToggle svg {
+  opacity: 0.7;
+}
+
+/* Drawer close button */
+.drawerClose {
+  position: absolute;
+  top: calc(40% - 48px);
+  right: 16px;
+  width: 36px;
+  height: 36px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: rgba(255, 255, 255, 0.06);
+  color: rgba(255, 255, 255, 0.6);
+  border: 1px solid rgba(255, 255, 255, 0.1);
+  border-radius: 8px;
+  cursor: pointer;
+  transition: all 0.15s ease;
+  z-index: 110;
+}
+
+.drawerClose:hover {
+  background: rgba(255, 255, 255, 0.1);
+  color: rgba(255, 255, 255, 0.9);
+}

package/src/demo/components/layout/SplitDemoLayout.tsx

@@ -0,0 +1,218 @@
+/**
+ * @file SplitDemoLayout - Responsive layout with left code / right preview
+ * Uses GridLayout for desktop (side-by-side) and drawer for compact viewports
+ */
+import * as React from "react";
+import { GridLayout } from "../../../components/grid/GridLayout";
+import type { PanelLayoutConfig, LayerDefinition } from "../../../types";
+import { CodePanel } from "./CodePanel";
+import styles from "./SplitDemoLayout.module.css";
+
+const COMPACT_BREAKPOINT = 900;
+
+type CodeToggleButtonProps = {
+  onClick: () => void;
+};
+
+const CodeToggleButton: React.FC<CodeToggleButtonProps> = ({ onClick }) => {
+  return (
+    <button
+      type="button"
+      className={styles.codeToggle}
+      onClick={onClick}
+      aria-label="Show source code"
+    >
+      <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2">
+        <polyline points="16 18 22 12 16 6" />
+        <polyline points="8 6 2 12 8 18" />
+      </svg>
+      <span>Code</span>
+    </button>
+  );
+};
+
+type DrawerCloseButtonProps = {
+  onClick: () => void;
+};
+
+const DrawerCloseButton: React.FC<DrawerCloseButtonProps> = ({ onClick }) => {
+  return (
+    <button
+      type="button"
+      className={styles.drawerClose}
+      onClick={onClick}
+      aria-label="Close code panel"
+    >
+      <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2">
+        <line x1="18" y1="6" x2="6" y2="18" />
+        <line x1="6" y1="6" x2="18" y2="18" />
+      </svg>
+    </button>
+  );
+};
+
+export type SplitDemoLayoutProps = {
+  /** Source code to display */
+  code: string;
+  /** Title for the code panel */
+  codeTitle?: string;
+  /** Preview content */
+  children: React.ReactNode;
+  /** Minimum height for the preview area */
+  previewMinHeight?: number | string;
+};
+
+/**
+ * SplitDemoLayout component
+ * - Desktop: Left code panel, right preview (side-by-side)
+ * - Compact: Preview only, with bottom drawer for code
+ */
+export const SplitDemoLayout: React.FC<SplitDemoLayoutProps> = ({
+  code,
+  codeTitle = "Source Code",
+  children,
+  previewMinHeight = 400,
+}) => {
+  const containerRef = React.useRef<HTMLDivElement | null>(null);
+  const [containerWidth, setContainerWidth] = React.useState<number>(0);
+  const [drawerOpen, setDrawerOpen] = React.useState(false);
+
+  // Track container width for responsive behavior
+  React.useEffect(() => {
+    if (typeof window === "undefined") {
+      return;
+    }
+
+    const node = containerRef.current;
+    if (!node) {
+      return;
+    }
+
+    const updateWidth = () => {
+      const rect = node.getBoundingClientRect();
+      setContainerWidth(Math.round(rect.width));
+    };
+
+    updateWidth();
+
+    const observer =
+      typeof ResizeObserver !== "undefined" ? new ResizeObserver(updateWidth) : null;
+
+    if (observer) {
+      observer.observe(node);
+    }
+
+    return () => {
+      if (observer) {
+        observer.disconnect();
+      }
+    };
+  }, []);
+
+  const isCompact = containerWidth > 0 && containerWidth < COMPACT_BREAKPOINT;
+
+  // Desktop config: side-by-side layout
+  const desktopConfig = React.useMemo<PanelLayoutConfig>(
+    () => ({
+      areas: [["code", "preview"]],
+      rows: [{ size: "1fr" }],
+      columns: [
+        { size: "minmax(320px, 420px)", resizable: true, minSize: 280, maxSize: 600 },
+        { size: "1fr" },
+      ],
+      gap: "0",
+    }),
+    [],
+  );
+
+  // Compact config: preview only (code in drawer)
+  const compactConfig = React.useMemo<PanelLayoutConfig>(
+    () => ({
+      areas: [["preview"]],
+      rows: [{ size: "1fr" }],
+      columns: [{ size: "1fr" }],
+      gap: "0",
+    }),
+    [],
+  );
+
+  const previewMinHeightValue =
+    typeof previewMinHeight === "number" ? `${previewMinHeight}px` : previewMinHeight;
+
+  const desktopLayers = React.useMemo<LayerDefinition[]>(
+    () => [
+      {
+        id: "code",
+        gridArea: "code",
+        component: (
+          <div className={styles.codeWrapper}>
+            <CodePanel code={code} title={codeTitle} />
+          </div>
+        ),
+      },
+      {
+        id: "preview",
+        gridArea: "preview",
+        component: (
+          <div className={styles.previewWrapper} style={{ minHeight: previewMinHeightValue }}>
+            {children}
+          </div>
+        ),
+      },
+    ],
+    [code, codeTitle, children, previewMinHeightValue],
+  );
+
+  const compactLayers = React.useMemo<LayerDefinition[]>(
+    () => [
+      {
+        id: "preview",
+        gridArea: "preview",
+        component: (
+          <div className={styles.previewWrapper} style={{ minHeight: previewMinHeightValue }}>
+            {children}
+          </div>
+        ),
+      },
+      {
+        id: "code-drawer",
+        component: (
+          <div className={styles.drawerContent}>
+            <CodePanel code={code} title={codeTitle} showHeader={true} />
+          </div>
+        ),
+        drawer: {
+          open: drawerOpen,
+          onStateChange: setDrawerOpen,
+          dismissible: true,
+          chrome: false,
+          inline: true,
+          anchor: "bottom",
+          transitionMode: "css",
+          transitionDuration: "250ms",
+          transitionEasing: "cubic-bezier(0.16, 1, 0.3, 1)",
+          ariaLabel: "Source Code",
+        },
+        position: { bottom: 0, left: 0 },
+        width: "100%",
+        height: "60%",
+        zIndex: 100,
+      },
+    ],
+    [code, codeTitle, children, previewMinHeightValue, drawerOpen],
+  );
+
+  const config = isCompact ? compactConfig : desktopConfig;
+  const layers = isCompact ? compactLayers : desktopLayers;
+
+  const showToggleButton = isCompact ? !drawerOpen : false;
+  const showCloseButton = isCompact ? drawerOpen : false;
+
+  return (
+    <div className={styles.container} ref={containerRef}>
+      <GridLayout config={config} layers={layers} />
+      {showToggleButton ? <CodeToggleButton onClick={() => setDrawerOpen(true)} /> : null}
+      {showCloseButton ? <DrawerCloseButton onClick={() => setDrawerOpen(false)} /> : null}
+    </div>
+  );
+};

package/src/demo/components/layout/index.ts

@@ -0,0 +1,11 @@
+/**
+ * @file Barrel exports for layout components
+ */
+export { DemoPage } from "./DemoPage";
+export type { DemoPageProps } from "./DemoPage";
+export { SingleSamplePage } from "./SingleSamplePage";
+export type { SingleSamplePageProps } from "./SingleSamplePage";
+export { SplitDemoLayout } from "./SplitDemoLayout";
+export type { SplitDemoLayoutProps } from "./SplitDemoLayout";
+export { CodePanel } from "./CodePanel";
+export type { CodePanelProps } from "./CodePanel";