@papernote/ui 1.0.0 → 1.2.0

package/src/components/Modal.tsx

@@ -30,6 +30,7 @@ export default function Modal({
   animation = 'scale',
 }: ModalProps) {
   const modalRef = useRef<HTMLDivElement>(null);
+  const mouseDownOnBackdrop = useRef(false);
   const titleId = useId();
 
   // Handle escape key
@@ -51,11 +52,22 @@ export default function Modal({
     };
   }, [isOpen, onClose]);
 
-  // Handle click outside
-  const handleBackdropClick = (e: React.MouseEvent<HTMLDivElement>) => {
+  // Track if mousedown originated on the backdrop
+  const handleBackdropMouseDown = (e: React.MouseEvent<HTMLDivElement>) => {
     if (e.target === e.currentTarget) {
+      mouseDownOnBackdrop.current = true;
+    } else {
+      mouseDownOnBackdrop.current = false;
+    }
+  };
+
+  // Handle click outside - only close if both mousedown and click happened on backdrop
+  const handleBackdropClick = (e: React.MouseEvent<HTMLDivElement>) => {
+    if (e.target === e.currentTarget && mouseDownOnBackdrop.current) {
       onClose();
     }
+    // Reset the flag after handling click
+    mouseDownOnBackdrop.current = false;
   };
 
   const getAnimationClass = () => {
@@ -80,6 +92,7 @@ export default function Modal({
   return (
     <div
       className="fixed inset-0 z-50 flex items-center justify-center p-4 bg-ink-900 bg-opacity-50 backdrop-blur-sm animate-fade-in"
+      onMouseDown={handleBackdropMouseDown}
       onClick={handleBackdropClick}
     >
       <div

package/src/components/Page.stories.tsx

@@ -278,3 +278,79 @@ export const SettingsPage: Story = {
     </Page>
   ),
 };
+
+export const ResponsiveLayout: Story = {
+  render: () => (
+    <Page>
+      <Card style={{ marginBottom: '1.5rem', backgroundColor: '#dbeafe', border: '1px solid #3b82f6' }}>
+        <CardContent>
+          <h3 style={{ fontWeight: 600, marginBottom: '0.75rem', fontSize: '0.875rem', color: '#1e40af' }}>
+            📐 Responsive Layout (Default)
+          </h3>
+          <p style={{ fontSize: '0.875rem', marginBottom: '0.5rem' }}>
+            Try resizing your browser window! The page keeps <strong>left and top margins/padding fixed</strong>,
+            but <strong>right and bottom resize responsively</strong>:
+          </p>
+          <ul style={{ marginLeft: '1.5rem', fontSize: '0.875rem' }}>
+            <li>• Small screens: Minimal right/bottom padding for more content space</li>
+            <li>• Medium screens: Increased right/bottom padding</li>
+            <li>• Large screens (1024px+): Maximum spacing with centered layout</li>
+          </ul>
+        </CardContent>
+      </Card>
+      <Card>
+        <CardHeader>
+          <CardTitle>Content Adapts to Screen Size</CardTitle>
+        </CardHeader>
+        <CardContent>
+          <p style={{ marginBottom: '1rem' }}>
+            This is the default responsive behavior. The notebook aesthetic is maintained
+            across all screen sizes while optimizing for available space.
+          </p>
+          <p>
+            The left binding edge and top margin stay consistent (maintaining the notebook look),
+            while right and bottom spacing adjusts for comfort on different devices.
+          </p>
+        </CardContent>
+      </Card>
+    </Page>
+  ),
+};
+
+export const FixedLayout: Story = {
+  render: () => (
+    <Page fixed={true}>
+      <Card style={{ marginBottom: '1.5rem', backgroundColor: '#fef3c7', border: '1px solid #f59e0b' }}>
+        <CardContent>
+          <h3 style={{ fontWeight: 600, marginBottom: '0.75rem', fontSize: '0.875rem', color: '#92400e' }}>
+            📌 Fixed Layout (fixed=true)
+          </h3>
+          <p style={{ fontSize: '0.875rem', marginBottom: '0.5rem' }}>
+            This page uses <code style={{ backgroundColor: '#fff', padding: '0.125rem 0.375rem', borderRadius: '0.25rem' }}>fixed=true</code>.
+            All margins and padding stay <strong>constant regardless of screen size</strong>:
+          </p>
+          <ul style={{ marginLeft: '1.5rem', fontSize: '0.875rem' }}>
+            <li>• Left, right, top, and bottom spacing never changes</li>
+            <li>• Consistent appearance on all devices</li>
+            <li>• May use more horizontal space on large screens</li>
+          </ul>
+        </CardContent>
+      </Card>
+      <Card>
+        <CardHeader>
+          <CardTitle>Consistent Spacing Everywhere</CardTitle>
+        </CardHeader>
+        <CardContent>
+          <p style={{ marginBottom: '1rem' }}>
+            Use the <code style={{ backgroundColor: '#f5f5f5', padding: '0.25rem 0.5rem', borderRadius: '0.25rem' }}>fixed</code> prop
+            when you need absolute consistency across all screen sizes, or when the responsive
+            behavior doesn't match your design requirements.
+          </p>
+          <p>
+            Try resizing your browser - the spacing around this page content remains identical.
+          </p>
+        </CardContent>
+      </Card>
+    </Page>
+  ),
+};

package/src/components/Page.tsx

@@ -12,6 +12,8 @@ export interface PageProps {
   className?: string;
   /** Padding size around the content (default: 'normal') */
   padding?: 'none' | 'sm' | 'normal' | 'lg';
+  /** Fix all margins/padding instead of responsive (default: false) */
+  fixed?: boolean;
 }
 
 /**
@@ -47,14 +49,44 @@ export interface PageProps {
  */
 export const Page: React.FC<PageProps> = ({
   children,
-  maxWidth: _maxWidth = '7xl',
+  maxWidth = '7xl',
   className = '',
-  padding: _padding = 'normal'
+  padding = 'normal',
+  fixed = false
 }) => {
+  // Max width classes
+  const maxWidthClasses = {
+    '4xl': 'max-w-4xl',
+    '5xl': 'max-w-5xl',
+    '6xl': 'max-w-6xl',
+    '7xl': 'max-w-7xl',
+    'full': 'max-w-full',
+  };
+
+  // Padding classes - responsive (fixed left/top, responsive right/bottom) vs all fixed
+  const paddingClasses = {
+    none: fixed ? 'p-0' : 'pt-0 pl-0 pr-0 pb-0',
+    sm: fixed ? 'p-4' : 'pt-4 pl-4 pr-4 pb-4 sm:pr-6 md:pr-8 sm:pb-6 md:pb-8',
+    normal: fixed ? 'pt-12 pl-20 pr-16 pb-12' : 'pt-12 pl-20 pr-4 pb-4 sm:pr-8 md:pr-12 lg:pr-16 sm:pb-8 md:pb-12 lg:pb-16',
+    lg: fixed ? 'pt-16 pl-24 pr-20 pb-16' : 'pt-16 pl-24 pr-6 pb-6 sm:pr-12 md:pr-16 lg:pr-20 sm:pb-12 md:pb-16 lg:pb-20',
+  };
+
+  // Margin classes - responsive (fixed left/top, responsive right/bottom) vs all fixed
+  const marginClasses = fixed
+    ? 'mt-4 ml-4 mr-4 mb-4'
+    : 'mt-4 ml-4 mr-4 mb-4 sm:mr-6 md:mr-8 lg:mr-auto sm:mb-6 md:mb-8';
 
   return (
     <div className="min-h-screen bg-paper-100">
-      <div className={`notebook-page notebook-margin notebook-ruled ${className}`}>
+      <div className={`
+        bg-white bg-subtle-grain rounded-sm shadow-lg border-l-4 border-paper-300
+        min-h-[calc(100vh-2rem)] relative
+        notebook-margin notebook-ruled
+        ${maxWidthClasses[maxWidth]}
+        ${paddingClasses[padding]}
+        ${marginClasses}
+        ${className}
+      `.trim().replace(/\s+/g, ' ')}>
         {children}
       </div>
     </div>

package/src/components/PageLayout.stories.tsx

@@ -586,3 +586,78 @@ export const WithSidebarAndGutter: Story = {
     );
   },
 };
+
+export const ResponsiveLayout: Story = {
+  render: () => (
+    <PageLayout
+      title="Responsive PageLayout"
+      description="Default responsive behavior - resize your browser to see the right and bottom padding adapt"
+    >
+      <Card style={{ marginBottom: '1.5rem', backgroundColor: '#dbeafe', border: '1px solid #3b82f6' }}>
+        <CardContent>
+          <h3 style={{ fontWeight: 600, marginBottom: '0.75rem', fontSize: '0.875rem', color: '#1e40af' }}>
+            📐 Responsive Layout (Default)
+          </h3>
+          <p style={{ fontSize: '0.875rem', marginBottom: '0.5rem' }}>
+            Try resizing your browser window! PageLayout keeps <strong>left and top padding fixed</strong>,
+            but <strong>right and bottom resize responsively</strong>:
+          </p>
+          <ul style={{ marginLeft: '1.5rem', fontSize: '0.875rem' }}>
+            <li>• Small screens: Minimal right/bottom padding (pr-2 pb-8)</li>
+            <li>• Medium screens (640px+): Increased padding (pr-4 pb-12)</li>
+            <li>• Large screens (768px+): More padding (pr-6 pb-16)</li>
+            <li>• XL screens (1024px+): Maximum padding (pb-20)</li>
+          </ul>
+        </CardContent>
+      </Card>
+      <Card>
+        <CardHeader>
+          <CardTitle>Content Adapts to Screen Size</CardTitle>
+        </CardHeader>
+        <CardContent>
+          <p>
+            This is perfect for applications where you want the notebook aesthetic to be
+            maintained while optimizing for different device sizes.
+          </p>
+        </CardContent>
+      </Card>
+    </PageLayout>
+  ),
+};
+
+export const FixedLayout: Story = {
+  render: () => (
+    <PageLayout
+      title="Fixed PageLayout"
+      description="All padding remains constant regardless of screen size"
+      fixed={true}
+    >
+      <Card style={{ marginBottom: '1.5rem', backgroundColor: '#fef3c7', border: '1px solid #f59e0b' }}>
+        <CardContent>
+          <h3 style={{ fontWeight: 600, marginBottom: '0.75rem', fontSize: '0.875rem', color: '#92400e' }}>
+            📌 Fixed Layout (fixed=true)
+          </h3>
+          <p style={{ fontSize: '0.875rem', marginBottom: '0.5rem' }}>
+            This page uses <code style={{ backgroundColor: '#fff', padding: '0.125rem 0.375rem', borderRadius: '0.25rem' }}>fixed=true</code>.
+            All padding stays <strong>constant regardless of screen size</strong>:
+          </p>
+          <ul style={{ marginLeft: '1.5rem', fontSize: '0.875rem' }}>
+            <li>• Same padding on mobile and desktop</li>
+            <li>• Predictable layout at all viewport sizes</li>
+            <li>• Use when you need absolute consistency</li>
+          </ul>
+        </CardContent>
+      </Card>
+      <Card>
+        <CardHeader>
+          <CardTitle>Consistent Everywhere</CardTitle>
+        </CardHeader>
+        <CardContent>
+          <p>
+            Try resizing your browser - the spacing remains identical at all screen sizes.
+          </p>
+        </CardContent>
+      </Card>
+    </PageLayout>
+  ),
+};

package/src/components/PageLayout.tsx

@@ -12,6 +12,10 @@ export interface PageLayoutProps {
   className?: string;
   /** Optional content to render before the title (e.g., breadcrumbs, alerts, control bars) */
   headerContent?: ReactNode;
+  /** Maximum width constraint for the page content (default: '7xl' = 1400px) */
+  maxWidth?: '4xl' | '5xl' | '6xl' | '7xl' | 'full';
+  /** Fix all margins/padding instead of responsive (default: false) */
+  fixed?: boolean;
 }
 
 /**
@@ -51,19 +55,34 @@ export interface PageLayoutProps {
  * </Layout>
  * ```
  */
-export function PageLayout({ 
-  title, 
-  description, 
-  children, 
+export function PageLayout({
+  title,
+  description,
+  children,
   className = '',
-  headerContent
+  headerContent,
+  maxWidth = '7xl',
+  fixed = false
 }: PageLayoutProps) {
+  // Responsive padding classes - fixed left/top, responsive right/bottom
+  const paddingClasses = fixed
+    ? 'p-6 pb-20'
+    : 'pt-6 pl-6 pr-2 pb-8 sm:pr-4 md:pr-6 sm:pb-12 md:pb-16 lg:pb-20';
+
+  const maxWidthClasses = {
+    '4xl': 'max-w-4xl',
+    '5xl': 'max-w-5xl',
+    '6xl': 'max-w-6xl',
+    '7xl': 'max-w-7xl',
+    'full': 'max-w-full',
+  };
+
   return (
-    <Page>
+    <Page padding="none" maxWidth={maxWidth} fixed={fixed}>
       {/* Content before title (e.g., ControlBar) */}
       {headerContent}
-      
-      <div className={`p-6 max-w-7xl mx-auto pb-20 ${className}`}>
+
+      <div className={`${paddingClasses} ${maxWidthClasses[maxWidth]} mx-auto ${className}`}>
         {/* Header */}
         <div className="mb-8">
           <h1 className="text-3xl font-bold text-ink-900 mb-2">{title}</h1>
@@ -71,7 +90,7 @@ export function PageLayout({
             <p className="text-ink-600">{description}</p>
           )}
         </div>
-        
+
         {children}
       </div>
     </Page>

package/src/components/RoleManager.css

@@ -1,10 +1,10 @@
-/* RoleManager.css - Styles for RoleManager component */
-
-.role-manager-permission-grid {
-  grid-template-columns: repeat(auto-fill, minmax(250px, 1fr));
-}
-
-.role-manager-list {
-  height: var(--role-manager-height, 400px);
-  min-height: 200px;
-}
+/* RoleManager.css - Styles for RoleManager component */
+
+.role-manager-permission-grid {
+  grid-template-columns: repeat(auto-fill, minmax(250px, 1fr));
+}
+
+.role-manager-list {
+  height: var(--role-manager-height, 400px);
+  min-height: 200px;
+}

package/src/components/Spreadsheet.css

@@ -0,0 +1,216 @@
+/**
+ * Spreadsheet Component Styles
+ *
+ * Custom styling for react-spreadsheet to match notebook-ui's paper aesthetic
+ */
+
+/* Container */
+.spreadsheet-container {
+  width: 100%;
+  overflow: auto;
+  background-color: #fafaf9; /* paper-50 */
+  border-radius: 0.5rem;
+  border: 1px solid #e7e5e4; /* stone-200 */
+}
+
+/* Spreadsheet base */
+.notebook-spreadsheet {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+  font-size: 0.875rem;
+  color: #1c1917; /* ink-900 */
+}
+
+/* Table styling */
+.notebook-spreadsheet table {
+  border-collapse: separate;
+  border-spacing: 0;
+  background-color: #ffffff;
+  width: 100%;
+}
+
+/* Cell styling */
+.notebook-spreadsheet td {
+  border: 1px solid #e7e5e4; /* stone-200 */
+  padding: 0;
+  background-color: #ffffff;
+  transition: background-color 0.15s ease;
+}
+
+/* Cell hover */
+.notebook-spreadsheet td:hover {
+  background-color: #fafaf9; /* paper-50 */
+}
+
+/* Selected cell */
+.notebook-spreadsheet td.Spreadsheet__active-cell {
+  border: 2px solid #334155; /* primary-700 */
+  box-shadow: 0 0 0 1px #334155;
+  background-color: #ffffff;
+  z-index: 10;
+}
+
+/* Header cells (row/column labels) */
+.notebook-spreadsheet th {
+  background-color: #f5f5f4; /* stone-100 */
+  color: #57534e; /* ink-600 */
+  border: 1px solid #e7e5e4; /* stone-200 */
+  padding: 0.5rem;
+  font-weight: 600;
+  font-size: 0.75rem;
+  text-align: center;
+  position: sticky;
+  z-index: 5;
+}
+
+/* Column headers */
+.notebook-spreadsheet thead th {
+  top: 0;
+  z-index: 10;
+}
+
+/* Row headers */
+.notebook-spreadsheet tbody th {
+  left: 0;
+  z-index: 5;
+}
+
+/* Corner header (top-left cell) */
+.notebook-spreadsheet thead th:first-child {
+  left: 0;
+  z-index: 15;
+}
+
+/* Cell input */
+.notebook-spreadsheet .Spreadsheet__data-editor {
+  width: 100%;
+  height: 100%;
+  border: none;
+  outline: none;
+  padding: 0.5rem;
+  font-family: inherit;
+  font-size: inherit;
+  color: inherit;
+  background-color: #ffffff;
+  box-sizing: border-box;
+}
+
+.notebook-spreadsheet .Spreadsheet__data-editor:focus {
+  background-color: #ffffff;
+  border: 2px solid #334155; /* primary-700 */
+  padding: calc(0.5rem - 1px);
+}
+
+/* Cell with formula indicator */
+.notebook-spreadsheet .Spreadsheet__cell--formula {
+  font-style: italic;
+  background-color: #f0fdf4; /* success-50 */
+}
+
+/* Read-only cells */
+.notebook-spreadsheet .Spreadsheet__cell--readonly {
+  background-color: #f5f5f4; /* stone-100 */
+  color: #78716c; /* ink-500 */
+}
+
+/* Selection highlight */
+.notebook-spreadsheet .Spreadsheet__cell--selected {
+  background-color: #e0f2fe; /* primary-100 */
+}
+
+/* Cell error state */
+.notebook-spreadsheet .Spreadsheet__cell--error {
+  background-color: #fef2f2; /* error-50 */
+  color: #991b1b; /* error-800 */
+}
+
+/* Cell value display */
+.notebook-spreadsheet .Spreadsheet__value {
+  padding: 0.5rem;
+  min-height: 2rem;
+  display: flex;
+  align-items: center;
+}
+
+/* Number cells - align right */
+.notebook-spreadsheet .Spreadsheet__cell--number .Spreadsheet__value {
+  justify-content: flex-end;
+  font-variant-numeric: tabular-nums;
+}
+
+/* Empty cells */
+.notebook-spreadsheet .Spreadsheet__cell--empty .Spreadsheet__value {
+  color: #a8a29e; /* ink-400 */
+}
+
+/* Copy/paste indicator */
+.notebook-spreadsheet .Spreadsheet__floating-rect {
+  border: 2px dashed #334155; /* primary-700 */
+  background-color: rgba(51, 65, 85, 0.1);
+  pointer-events: none;
+}
+
+/* Scrollbar styling for webkit browsers */
+.spreadsheet-container::-webkit-scrollbar {
+  width: 12px;
+  height: 12px;
+}
+
+.spreadsheet-container::-webkit-scrollbar-track {
+  background-color: #fafaf9; /* paper-50 */
+  border-radius: 0.5rem;
+}
+
+.spreadsheet-container::-webkit-scrollbar-thumb {
+  background-color: #d6d3d1; /* stone-300 */
+  border-radius: 0.5rem;
+  border: 2px solid #fafaf9;
+}
+
+.spreadsheet-container::-webkit-scrollbar-thumb:hover {
+  background-color: #a8a29e; /* ink-400 */
+}
+
+/* Loading state */
+.spreadsheet-container.loading {
+  opacity: 0.6;
+  pointer-events: none;
+}
+
+/* Responsive adjustments */
+@media (max-width: 768px) {
+  .notebook-spreadsheet {
+    font-size: 0.75rem;
+  }
+
+  .notebook-spreadsheet .Spreadsheet__value {
+    padding: 0.375rem;
+    min-height: 1.75rem;
+  }
+
+  .notebook-spreadsheet .Spreadsheet__data-editor {
+    padding: 0.375rem;
+  }
+
+  .notebook-spreadsheet th {
+    padding: 0.375rem;
+    font-size: 0.6875rem;
+  }
+}
+
+/* Print styles */
+@media print {
+  .spreadsheet-container {
+    border: none;
+    overflow: visible;
+  }
+
+  .notebook-spreadsheet td,
+  .notebook-spreadsheet th {
+    border-color: #000;
+  }
+
+  .notebook-spreadsheet .Spreadsheet__active-cell {
+    border: 1px solid #000;
+    box-shadow: none;
+  }
+}