@imansi/templates 0.1.0

package/src/marketing/DocsPage.jsx

@@ -0,0 +1,256 @@
+import { useState } from 'react';
+import { Link } from 'react-router-dom';
+import { Badge, Button, Input, ScrollArea, cn } from '@imansi/ui';
+import { MarketingLayout } from '../layouts/MarketingLayout.jsx';
+
+export function DocsPage({
+  brandName = 'Imansi',
+  brandLogo,
+  navLinks = [],
+  headerCTA,
+  footerColumns = [],
+
+  sidebarTitle = 'Documentación',
+  sidebarSearchPlaceholder = 'Buscar...',
+  sections = [],
+  // sections: [{ title, items: [{ label, href, badge }] }]
+
+  breadcrumb = [],
+  title = 'Introducción',
+  description = '',
+  badges = [],
+
+  tocItems = [],
+  // tocItems: [{ label, href, level? }]
+
+  prevPage,
+  nextPage,
+  // { label, href }
+
+  children,
+  onEditClick,
+}) {
+  const [mobileSidebarOpen, setMobileSidebarOpen] = useState(false);
+  const [search, setSearch] = useState('');
+
+  const filteredSections = search
+    ? sections
+        .map((section) => ({
+          ...section,
+          items: section.items.filter((item) =>
+            item.label.toLowerCase().includes(search.toLowerCase())
+          ),
+        }))
+        .filter((section) => section.items.length > 0)
+    : sections;
+
+  const Sidebar = (
+    <div className="space-y-6">
+      <div className="space-y-3">
+        <p className="text-caption uppercase tracking-wider font-semibold text-muted-foreground">
+          {sidebarTitle}
+        </p>
+        <Input
+          type="search"
+          placeholder={sidebarSearchPlaceholder}
+          value={search}
+          onChange={(e) => setSearch(e.target.value)}
+          className="h-9"
+        />
+      </div>
+
+      <nav className="space-y-6">
+        {filteredSections.map((section, i) => (
+          <div key={i} className="space-y-2">
+            <p className="text-caption uppercase tracking-wider font-semibold text-foreground">
+              {section.title}
+            </p>
+            <ul className="space-y-1">
+              {section.items.map((item, j) => {
+                const isActive = item.href === window?.location?.pathname;
+                return (
+                  <li key={j}>
+                    <Link
+                      to={item.href}
+                      onClick={() => setMobileSidebarOpen(false)}
+                      className={cn(
+                        'flex items-center justify-between gap-2 rounded-md px-3 py-1.5 text-small transition-colors',
+                        isActive
+                          ? 'bg-primary/10 text-primary font-medium'
+                          : 'text-muted-foreground hover:bg-muted hover:text-foreground'
+                      )}
+                    >
+                      <span className="truncate">{item.label}</span>
+                      {item.badge && (
+                        <Badge variant="outline" className="text-[10px]">
+                          {item.badge}
+                        </Badge>
+                      )}
+                    </Link>
+                  </li>
+                );
+              })}
+            </ul>
+          </div>
+        ))}
+      </nav>
+    </div>
+  );
+
+  return (
+    <MarketingLayout
+      brandName={brandName}
+      brandLogo={brandLogo}
+      navLinks={navLinks}
+      headerCTA={headerCTA}
+      footerColumns={footerColumns}
+    >
+      <div className="imansi-container py-8 lg:py-12">
+        <div className="grid gap-10 lg:grid-cols-[260px_1fr_200px]">
+          {/* Sidebar desktop */}
+          <aside className="hidden lg:block">
+            <div className="sticky top-24">
+              <ScrollArea className="h-[calc(100vh-8rem)] pr-2">
+                {Sidebar}
+              </ScrollArea>
+            </div>
+          </aside>
+
+          {/* Contenido principal */}
+          <main className="min-w-0">
+            {/* Mobile: abrir sidebar */}
+            <div className="lg:hidden mb-6">
+              <Button
+                variant="outline"
+                size="sm"
+                onClick={() => setMobileSidebarOpen((v) => !v)}
+              >
+                <svg width="14" height="14" viewBox="0 0 20 20" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" className="mr-2">
+                  <line x1="3" y1="6" x2="17" y2="6" />
+                  <line x1="3" y1="10" x2="17" y2="10" />
+                  <line x1="3" y1="14" x2="17" y2="14" />
+                </svg>
+                {mobileSidebarOpen ? 'Cerrar menú' : 'Abrir menú'}
+              </Button>
+            </div>
+
+            {mobileSidebarOpen && (
+              <div className="lg:hidden mb-8 rounded-lg border border-border bg-card p-5">
+                {Sidebar}
+              </div>
+            )}
+
+            {/* Breadcrumb */}
+            {breadcrumb.length > 0 && (
+              <nav className="flex flex-wrap items-center gap-1.5 text-caption text-muted-foreground mb-6">
+                {breadcrumb.map((crumb, i) => (
+                  <span key={i} className="flex items-center gap-1.5">
+                    {i > 0 && <span className="opacity-50">/</span>}
+                    {crumb.href ? (
+                      <Link
+                        to={crumb.href}
+                        className="hover:text-foreground transition-colors"
+                      >
+                        {crumb.label}
+                      </Link>
+                    ) : (
+                      <span className="text-foreground">{crumb.label}</span>
+                    )}
+                  </span>
+                ))}
+              </nav>
+            )}
+
+            {/* Título */}
+            <header className="space-y-4 pb-8 border-b border-border">
+              <div className="flex flex-wrap items-center gap-2">
+                <h1 className="text-h1 font-bold tracking-tight">{title}</h1>
+                {badges.map((b, i) => (
+                  <Badge key={i} variant="outline">{b}</Badge>
+                ))}
+              </div>
+              {description && (
+                <p className="text-body text-muted-foreground leading-relaxed">
+                  {description}
+                </p>
+              )}
+              {onEditClick && (
+                <button
+                  type="button"
+                  onClick={onEditClick}
+                  className="text-caption text-muted-foreground hover:text-foreground transition-colors inline-flex items-center gap-1.5"
+                >
+                  <svg width="12" height="12" viewBox="0 0 12 12" fill="none" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round">
+                    <path d="M8.5 1.5l2 2L4 10H2v-2z" />
+                  </svg>
+                  Editar esta página
+                </button>
+              )}
+            </header>
+
+            {/* Contenido */}
+            <div className="prose-imansi py-8 space-y-6">{children}</div>
+
+            {/* Navegación prev/next */}
+            {(prevPage || nextPage) && (
+              <nav className="grid gap-4 sm:grid-cols-2 pt-8 border-t border-border">
+                {prevPage ? (
+                  <Link
+                    to={prevPage.href}
+                    className="group rounded-lg border border-border bg-card p-4 hover:border-primary/40 transition-colors"
+                  >
+                    <p className="text-caption text-muted-foreground mb-1">
+                      ← Anterior
+                    </p>
+                    <p className="text-small font-medium group-hover:text-primary transition-colors">
+                      {prevPage.label}
+                    </p>
+                  </Link>
+                ) : <div />}
+
+                {nextPage && (
+                  <Link
+                    to={nextPage.href}
+                    className="group rounded-lg border border-border bg-card p-4 text-right hover:border-primary/40 transition-colors"
+                  >
+                    <p className="text-caption text-muted-foreground mb-1">
+                      Siguiente →
+                    </p>
+                    <p className="text-small font-medium group-hover:text-primary transition-colors">
+                      {nextPage.label}
+                    </p>
+                  </Link>
+                )}
+              </nav>
+            )}
+          </main>
+
+          {/* TOC desktop */}
+          <aside className="hidden xl:block">
+            {tocItems.length > 0 && (
+              <div className="sticky top-24 space-y-3">
+                <p className="text-caption uppercase tracking-wider font-semibold text-muted-foreground">
+                  En esta página
+                </p>
+                <nav className="space-y-1.5 border-l border-border">
+                  {tocItems.map((item, i) => (
+                    <a
+                      key={i}
+                      href={item.href}
+                      className={cn(
+                        'block pl-3 text-caption text-muted-foreground hover:text-foreground transition-colors border-l-2 border-transparent hover:border-primary -ml-px',
+                        item.level === 3 && 'pl-6'
+                      )}
+                    >
+                      {item.label}
+                    </a>
+                  ))}
+                </nav>
+              </div>
+            )}
+          </aside>
+        </div>
+      </div>
+    </MarketingLayout>
+  );
+}