@papernote/ui 1.1.0 → 1.3.0

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