react-panel-layout 0.5.2 → 0.6.1

package/src/demo/components/Story.tsx

@@ -0,0 +1,54 @@
+/**
+ * @file Common Story components for preview pages
+ */
+import * as React from "react";
+import styles from "./Story.module.css";
+
+export type SectionProps = {
+  title: string;
+  children: React.ReactNode;
+};
+
+export const Section: React.FC<SectionProps> = ({ title, children }) => (
+  <div className={styles.section}>
+    <h2 className={styles.sectionTitle}>{title}</h2>
+    {children}
+  </div>
+);
+
+export type StoryProps = {
+  title: string;
+  description?: string;
+  children: React.ReactNode;
+  actions?: React.ReactNode;
+};
+
+export const Story: React.FC<StoryProps> = ({ title, description, children, actions }) => (
+  <div className={styles.story}>
+    <div className={styles.storyHeader}>
+      <h3 className={styles.storyTitle}>{title}</h3>
+      {description ? <p className={styles.storyDescription}>{description}</p> : null}
+    </div>
+    <div className={styles.storyPreview}>{children}</div>
+    {actions ? <div className={styles.storyActions}>{actions}</div> : null}
+  </div>
+);
+
+export type StoryActionButtonProps = {
+  onClick?: () => void;
+  children: React.ReactNode;
+  variant?: "primary" | "secondary";
+};
+
+export const StoryActionButton: React.FC<StoryActionButtonProps> = ({
+  onClick,
+  children,
+  variant = "primary",
+}) => (
+  <button
+    onClick={onClick}
+    className={variant === "primary" ? styles.actionButton : `${styles.actionButton} ${styles.actionButtonSecondary}`}
+  >
+    {children}
+  </button>
+);

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

@@ -0,0 +1,183 @@
+/**
+ * CodePanel styles - Modern IDE-like appearance
+ */
+
+.container {
+  display: flex;
+  flex-direction: column;
+  background: #1e1e2e;
+  border-radius: var(--rpl-demo-radius-md);
+  overflow: hidden;
+  box-shadow: var(--rpl-demo-shadow-md);
+  height: 100%;
+  min-height: 0;
+}
+
+.header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 10px 14px;
+  background: #181825;
+  border-bottom: 1px solid rgba(255, 255, 255, 0.06);
+  flex-shrink: 0;
+}
+
+.headerLeft {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+.codeIcon {
+  color: rgba(255, 255, 255, 0.4);
+  flex-shrink: 0;
+}
+
+.title {
+  font-size: var(--rpl-demo-font-size-xs);
+  font-weight: 500;
+  color: rgba(255, 255, 255, 0.5);
+  font-family: var(--rpl-demo-font-family);
+  letter-spacing: 0.02em;
+}
+
+.copyButton {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  padding: 5px 10px;
+  background: rgba(255, 255, 255, 0.06);
+  border: 1px solid rgba(255, 255, 255, 0.08);
+  border-radius: 6px;
+  color: rgba(255, 255, 255, 0.6);
+  font-size: 11px;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.15s ease;
+  font-family: var(--rpl-demo-font-family);
+}
+
+.copyButton:hover {
+  background: rgba(255, 255, 255, 0.1);
+  color: rgba(255, 255, 255, 0.85);
+}
+
+.copyButton.copied {
+  background: rgba(40, 200, 64, 0.15);
+  border-color: rgba(40, 200, 64, 0.3);
+  color: #28c840;
+}
+
+.content {
+  flex: 1;
+  overflow: auto;
+  min-height: 0;
+}
+
+.pre {
+  display: flex;
+  margin: 0;
+  padding: 0;
+  font-family: "JetBrains Mono", "Fira Code", "Monaco", "Menlo", "Ubuntu Mono", monospace;
+  font-size: 13px;
+  line-height: 1.6;
+  tab-size: 2;
+}
+
+.lineNumbers {
+  position: sticky;
+  left: 0;
+  padding: 14px 0;
+  padding-right: 12px;
+  padding-left: 14px;
+  background: #1e1e2e;
+  border-right: 1px solid rgba(255, 255, 255, 0.06);
+  user-select: none;
+  text-align: right;
+  flex-shrink: 0;
+}
+
+.lineNumber {
+  color: rgba(255, 255, 255, 0.2);
+  font-size: 12px;
+  line-height: 1.6;
+}
+
+.code {
+  flex: 1;
+  padding: 14px 16px;
+  color: #cdd6f4;
+  white-space: pre;
+  overflow-x: auto;
+}
+
+.shikiWrapper {
+  flex: 1;
+  overflow-x: auto;
+}
+
+.shikiWrapper :global(pre.shiki) {
+  margin: 0;
+  padding: 14px 16px;
+  background: transparent !important;
+  font-family: inherit;
+  font-size: inherit;
+  line-height: inherit;
+}
+
+.shikiWrapper :global(pre.shiki code) {
+  display: block;
+  font-family: inherit;
+  font-size: inherit;
+  line-height: inherit;
+}
+
+/* Syntax highlighting colors (Catppuccin Mocha inspired) */
+.code :global(.keyword) {
+  color: #cba6f7;
+}
+
+.code :global(.string) {
+  color: #a6e3a1;
+}
+
+.code :global(.number) {
+  color: #fab387;
+}
+
+.code :global(.comment) {
+  color: #6c7086;
+  font-style: italic;
+}
+
+.code :global(.function) {
+  color: #89b4fa;
+}
+
+.code :global(.type) {
+  color: #f9e2af;
+}
+
+/* Scrollbar styling */
+.content::-webkit-scrollbar {
+  width: 8px;
+  height: 8px;
+}
+
+.content::-webkit-scrollbar-track {
+  background: transparent;
+}
+
+.content::-webkit-scrollbar-thumb {
+  background: rgba(255, 255, 255, 0.12);
+  border-radius: 4px;
+}
+
+.content::-webkit-scrollbar-thumb:hover {
+  background: rgba(255, 255, 255, 0.2);
+}
+
+.content::-webkit-scrollbar-corner {
+  background: transparent;
+}

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