ywana-core8 0.1.78 → 0.1.80

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ywana-core8",
-  "version": "0.1.78",
+  "version": "0.1.80",
   "description": "ywana-core8",
   "homepage": "https://ywana.github.io/workspace",
   "author": "Ernesto Roldan Garcia",

package/src/html/ExampleLayout.css

@@ -0,0 +1,401 @@
+/* ExampleLayout - Sidebar navigation for example pages */
+
+.example-layout {
+    display: flex;
+    max-height: 100vh;
+    position: relative;
+    overflow: hidden;
+}
+
+/* Sidebar */
+.example-sidebar {
+    position: fixed;
+    top: 0;
+    left: 0;
+    height: 100vh;
+    background: var(--surface-color, #f8f9fa);
+    border-right: 1px solid var(--divider-color, #e0e0e0);
+    z-index: 1000;
+    transition: all 0.3s ease;
+    overflow-y: auto;
+}
+
+.example-sidebar.open {
+    width: 280px;
+    transform: translateX(0);
+}
+
+.example-sidebar.closed {
+    width: 60px;
+    transform: translateX(0);
+}
+
+.example-sidebar__header {
+    padding: 1rem;
+    border-bottom: 1px solid var(--divider-color, #e0e0e0);
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    background: var(--primary-color, #2196f3);
+    color: white;
+    position: sticky;
+    top: 0;
+    z-index: 10;
+}
+
+.example-sidebar__title {
+    margin: 0;
+    font-size: 1.1rem;
+    font-weight: 600;
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+}
+
+.example-sidebar__toggle {
+    background: none;
+    border: none;
+    color: white;
+    cursor: pointer;
+    padding: 0.25rem;
+    border-radius: 4px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    transition: background-color 0.2s ease;
+}
+
+.example-sidebar__toggle:hover {
+    background: rgba(255, 255, 255, 0.1);
+}
+
+/* Navigation */
+.example-sidebar__nav {
+    padding: 1rem 0;
+}
+
+.example-sidebar__list {
+    list-style: none;
+    margin: 0;
+    padding: 0;
+}
+
+.example-sidebar__item {
+    margin-bottom: 0.25rem;
+}
+
+.example-sidebar__link {
+    display: flex;
+    align-items: center;
+    gap: 0.75rem;
+    padding: 0.75rem 1rem;
+    background: none;
+    border: none;
+    color: var(--text-color, #333);
+    text-decoration: none;
+    cursor: pointer;
+    transition: all 0.2s ease;
+    width: 100%;
+    text-align: left;
+    font-size: 0.875rem;
+    border-radius: 0;
+}
+
+.example-sidebar__link:hover {
+    background: var(--hover-color, rgba(33, 150, 243, 0.08));
+    color: var(--primary-color, #2196f3);
+}
+
+.example-sidebar__link.active {
+    background: var(--primary-color, #2196f3);
+    color: white;
+    font-weight: 500;
+}
+
+.example-sidebar__link span {
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+}
+
+/* Subsections */
+.example-sidebar__subsections {
+    list-style: none;
+    margin: 0;
+    padding: 0;
+    margin-left: 1rem;
+    border-left: 2px solid var(--divider-color-light, #f0f0f0);
+}
+
+.example-sidebar__subsection {
+    margin-bottom: 0.125rem;
+}
+
+.example-sidebar__sublink {
+    display: block;
+    padding: 0.5rem 1rem;
+    background: none;
+    border: none;
+    color: var(--text-color-secondary, #666);
+    text-decoration: none;
+    cursor: pointer;
+    transition: all 0.2s ease;
+    width: 100%;
+    text-align: left;
+    font-size: 0.75rem;
+    border-radius: 0;
+}
+
+.example-sidebar__sublink:hover {
+    background: var(--hover-color, rgba(33, 150, 243, 0.05));
+    color: var(--primary-color, #2196f3);
+}
+
+.example-sidebar__sublink.active {
+    background: var(--selection-color, rgba(33, 150, 243, 0.1));
+    color: var(--primary-color, #2196f3);
+    font-weight: 500;
+}
+
+/* Main content */
+.example-content {
+    flex: 1;
+    transition: margin-left 0.3s ease;
+    overflow: auto;
+}
+
+.example-content.with-sidebar {
+    margin-left: 280px;
+}
+
+.example-content.full-width {
+    margin-left: 60px;
+}
+
+.example-content__inner {
+    padding: 2rem;
+    max-width: 1200px;
+    margin: 0 auto;
+}
+
+/* Example sections */
+.example-section {
+    margin-bottom: 3rem;
+    scroll-margin-top: 2rem;
+}
+
+.example-section__header {
+    display: flex;
+    align-items: center;
+    gap: 0.75rem;
+    margin-bottom: 1.5rem;
+    padding-bottom: 0.75rem;
+    border-bottom: 2px solid var(--divider-color, #e0e0e0);
+}
+
+.example-section__title {
+    margin: 0;
+    font-size: 1.75rem;
+    font-weight: 600;
+    color: var(--text-color, #333);
+}
+
+.example-section__content {
+    /* Content styles handled by individual components */
+}
+
+/* Example subsections */
+.example-subsection {
+    margin-bottom: 2rem;
+    scroll-margin-top: 2rem;
+}
+
+.example-subsection__title {
+    margin: 0 0 1rem 0;
+    font-size: 1.25rem;
+    font-weight: 500;
+    color: var(--text-color, #333);
+}
+
+.example-subsection__content {
+    /* Content styles handled by individual components */
+}
+
+/* Code snippets */
+.code-snippet {
+    background: var(--surface-color, #f8f9fa);
+    border: 1px solid var(--divider-color, #e0e0e0);
+    border-radius: 8px;
+    margin: 1rem 0;
+    overflow: hidden;
+}
+
+.code-snippet__header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 0.75rem 1rem;
+    background: var(--surface-color-dark, #e9ecef);
+    border-bottom: 1px solid var(--divider-color, #e0e0e0);
+}
+
+.code-snippet__title {
+    margin: 0;
+    font-size: 0.875rem;
+    font-weight: 500;
+    color: var(--text-color, #333);
+}
+
+.code-snippet__copy {
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    padding: 0.25rem 0.5rem;
+    background: none;
+    border: 1px solid var(--divider-color, #e0e0e0);
+    border-radius: 4px;
+    color: var(--text-color-secondary, #666);
+    cursor: pointer;
+    font-size: 0.75rem;
+    transition: all 0.2s ease;
+}
+
+.code-snippet__copy:hover {
+    background: var(--hover-color, rgba(33, 150, 243, 0.05));
+    border-color: var(--primary-color, #2196f3);
+    color: var(--primary-color, #2196f3);
+}
+
+.code-snippet__content {
+    padding: 1rem;
+    margin: 0;
+    background: white;
+    overflow-x: auto;
+    font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;
+    font-size: 0.75rem;
+    line-height: 1.5;
+}
+
+.code-snippet__content code {
+    color: var(--text-color, #333);
+}
+
+/* Mobile overlay */
+.example-overlay {
+    position: fixed;
+    top: 0;
+    left: 0;
+    right: 0;
+    bottom: 0;
+    background: rgba(0, 0, 0, 0.5);
+    z-index: 999;
+    display: none;
+}
+
+/* Responsive design */
+@media (max-width: 768px) {
+    .example-sidebar.open {
+        width: 100%;
+        max-width: 320px;
+    }
+    
+    .example-sidebar.closed {
+        transform: translateX(-100%);
+        width: 280px;
+    }
+    
+    .example-content.with-sidebar,
+    .example-content.full-width {
+        margin-left: 0;
+    }
+    
+    .example-content__inner {
+        padding: 1rem;
+    }
+    
+    .example-overlay {
+        display: block;
+    }
+    
+    .example-section__title {
+        font-size: 1.5rem;
+    }
+    
+    .example-subsection__title {
+        font-size: 1.125rem;
+    }
+}
+
+/* Dark theme support */
+@media (prefers-color-scheme: dark) {
+    .example-sidebar {
+        background: #2c1810;
+        border-color: #5d4037;
+    }
+    
+    .example-sidebar__header {
+        background: #3e2723;
+        border-color: #5d4037;
+    }
+    
+    .example-sidebar__link {
+        color: #f4e6d7;
+    }
+    
+    .example-sidebar__link:hover {
+        background: rgba(141, 110, 99, 0.2);
+        color: #8d6e63;
+    }
+    
+    .example-sidebar__link.active {
+        background: #8d6e63;
+        color: #f4e6d7;
+    }
+    
+    .example-sidebar__sublink {
+        color: #d7ccc8;
+    }
+    
+    .example-sidebar__sublink:hover {
+        background: rgba(141, 110, 99, 0.1);
+        color: #8d6e63;
+    }
+    
+    .example-sidebar__sublink.active {
+        background: rgba(141, 110, 99, 0.2);
+        color: #8d6e63;
+    }
+    
+    .code-snippet {
+        background: #3e2723;
+        border-color: #5d4037;
+    }
+    
+    .code-snippet__header {
+        background: #4e342e;
+        border-color: #5d4037;
+    }
+    
+    .code-snippet__title {
+        color: #f4e6d7;
+    }
+    
+    .code-snippet__copy {
+        border-color: #5d4037;
+        color: #d7ccc8;
+    }
+    
+    .code-snippet__copy:hover {
+        background: rgba(141, 110, 99, 0.2);
+        border-color: #8d6e63;
+        color: #8d6e63;
+    }
+    
+    .code-snippet__content {
+        background: #2c1810;
+    }
+    
+    .code-snippet__content code {
+        color: #f4e6d7;
+    }
+}

package/src/html/ExampleLayout.js

@@ -0,0 +1,192 @@
+import React, { useState, useEffect } from 'react'
+import { Icon } from './icon'
+import './ExampleLayout.css'
+
+/**
+ * ExampleLayout - Layout component with sidebar navigation for example pages
+ */
+export const ExampleLayout = ({ title, children, sections = [] }) => {
+    const [sidebarOpen, setSidebarOpen] = useState(true)
+    const [activeSection, setActiveSection] = useState('')
+
+    // Handle scroll to update active section
+    useEffect(() => {
+        const handleScroll = () => {
+            const scrollPosition = window.scrollY + 100 // Offset for better UX
+
+            for (let i = sections.length - 1; i >= 0; i--) {
+                const section = sections[i]
+                const element = document.getElementById(section.id)
+                if (element && element.offsetTop <= scrollPosition) {
+                    setActiveSection(section.id)
+                    break
+                }
+            }
+        }
+
+        window.addEventListener('scroll', handleScroll)
+        handleScroll() // Initial check
+
+        return () => window.removeEventListener('scroll', handleScroll)
+    }, [sections])
+
+    // Smooth scroll to section
+    const scrollToSection = (sectionId) => {
+        const element = document.getElementById(sectionId)
+        if (element) {
+            element.scrollIntoView({
+                behavior: 'smooth',
+                block: 'start'
+            })
+        }
+    }
+
+    return (
+        <div className="example-layout">
+            {/* Sidebar */}
+            <div className={`example-sidebar ${sidebarOpen ? 'open' : 'closed'}`}>
+                <div className="example-sidebar__header">
+                    <h3 className="example-sidebar__title">{title}</h3>
+                    <button
+                        className="example-sidebar__toggle"
+                        onClick={() => setSidebarOpen(!sidebarOpen)}
+                        aria-label={sidebarOpen ? 'Cerrar menú' : 'Abrir menú'}
+                    >
+                        <Icon icon={sidebarOpen ? 'menu_open' : 'menu'} size="small" />
+                    </button>
+                </div>
+
+                {sidebarOpen && (
+                    <nav className="example-sidebar__nav">
+                        <ul className="example-sidebar__list">
+                            {sections.map((section) => (
+                                <li key={section.id} className="example-sidebar__item">
+                                    <button
+                                        className={`example-sidebar__link ${
+                                            activeSection === section.id ? 'active' : ''
+                                        }`}
+                                        onClick={() => scrollToSection(section.id)}
+                                    >
+                                        {section.icon && (
+                                            <Icon icon={section.icon} size="small" />
+                                        )}
+                                        <span>{section.title}</span>
+                                    </button>
+                                    
+                                    {section.subsections && section.subsections.length > 0 && (
+                                        <ul className="example-sidebar__subsections">
+                                            {section.subsections.map((subsection) => (
+                                                <li key={subsection.id} className="example-sidebar__subsection">
+                                                    <button
+                                                        className={`example-sidebar__sublink ${
+                                                            activeSection === subsection.id ? 'active' : ''
+                                                        }`}
+                                                        onClick={() => scrollToSection(subsection.id)}
+                                                    >
+                                                        {subsection.title}
+                                                    </button>
+                                                </li>
+                                            ))}
+                                        </ul>
+                                    )}
+                                </li>
+                            ))}
+                        </ul>
+                    </nav>
+                )}
+            </div>
+
+            {/* Main content */}
+            <div className={`example-content ${sidebarOpen ? 'with-sidebar' : 'full-width'}`}>
+                <div className="example-content__inner">
+                    {children}
+                </div>
+            </div>
+
+            {/* Mobile overlay */}
+            {sidebarOpen && (
+                <div 
+                    className="example-overlay"
+                    onClick={() => setSidebarOpen(false)}
+                />
+            )}
+        </div>
+    )
+}
+
+/**
+ * ExampleSection - Wrapper component for sections with automatic ID
+ */
+export const ExampleSection = ({ id, title, icon, children, className = '' }) => {
+    return (
+        <section id={id} className={`example-section ${className}`}>
+            {title && (
+                <div className="example-section__header">
+                    {icon && <Icon icon={icon} size="medium" />}
+                    <h2 className="example-section__title">{title}</h2>
+                </div>
+            )}
+            <div className="example-section__content">
+                {children}
+            </div>
+        </section>
+    )
+}
+
+/**
+ * ExampleSubsection - Wrapper component for subsections
+ */
+export const ExampleSubsection = ({ id, title, children, className = '' }) => {
+    return (
+        <div id={id} className={`example-subsection ${className}`}>
+            {title && (
+                <h3 className="example-subsection__title">{title}</h3>
+            )}
+            <div className="example-subsection__content">
+                {children}
+            </div>
+        </div>
+    )
+}
+
+/**
+ * CodeSnippet - Component for displaying code examples
+ */
+export const CodeSnippet = ({ title, code, language = 'jsx' }) => {
+    const [copied, setCopied] = useState(false)
+
+    const copyToClipboard = async () => {
+        try {
+            await navigator.clipboard.writeText(code)
+            setCopied(true)
+            setTimeout(() => setCopied(false), 2000)
+        } catch (err) {
+            console.error('Failed to copy code:', err)
+        }
+    }
+
+    return (
+        <div className="code-snippet">
+            <div className="code-snippet__header">
+                <h5 className="code-snippet__title">
+                    📋 {title}
+                </h5>
+                <button
+                    className="code-snippet__copy"
+                    onClick={copyToClipboard}
+                    title="Copiar código"
+                >
+                    <Icon icon={copied ? 'check' : 'content_copy'} size="small" />
+                    {copied ? 'Copiado!' : 'Copiar'}
+                </button>
+            </div>
+            <pre className="code-snippet__content">
+                <code className={`language-${language}`}>
+                    {code}
+                </code>
+            </pre>
+        </div>
+    )
+}
+
+export default ExampleLayout