lightview 1.8.2 → 2.0.0

package/docs/components/swap.html

@@ -0,0 +1,517 @@
+<!-- SEO-friendly SPA Shim -->
+<script src="/lightview-router.js"></script>
+<script>
+    if (window.LightviewRouter) {
+        LightviewRouter.base('/index.html');
+    }
+</script>
+
+<!-- Load the page-specific stylesheet -->
+<link rel="stylesheet" href="./index.css">
+
+<!-- Gallery Structure -->
+<div class="gallery-page">
+    <div class="gallery-layout">
+        <!-- Sidebar Overlay -->
+        <div id="sidebar-overlay" class="sidebar-overlay"></div>
+
+        <!-- Sidebar -->
+        <div id="gallery-sidebar" class="gallery-sidebar" style="visibility: hidden" src="./component-nav.html"></div>
+
+        <!-- Main Content -->
+        <div id="gallery-main" class="gallery-main">
+            <!-- Header Container -->
+            <div
+                style="position: sticky; top: 0; z-index: 30; background: var(--gallery-surface); border-bottom: 1px solid var(--gallery-border); backdrop-filter: blur(8px);">
+                <!-- Breadcrumbs Row -->
+                <div style="padding: 0.75rem 1.5rem 0;">
+                    <script>
+                        (() => {
+                            const { Breadcrumbs } = Lightview.tags;
+                            const breadcrumbs = Breadcrumbs({
+                                id: 'page-breadcrumbs',
+                                items: [
+                                    { label: 'Components', href: '/docs/components' },
+                                    { label: 'Swap' }
+                                ]
+                            });
+                            document.currentScript.replaceWith(breadcrumbs.domEl);
+                        })();
+                    </script>
+                </div>
+                <!-- Title Row -->
+                <div class="gallery-header"
+                    style="border-bottom: none; height: auto; padding-top: 0.5rem; padding-bottom: 0.75rem;">
+                    <button id="toggle-btn" class="toggle-btn" aria-label="Toggle Sidebar">
+                        <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" class="toggle-icon"
+                            style="stroke: currentColor; stroke-width: 2;">
+                            <path stroke-linecap="round" stroke-linejoin="round" d="M15 19l-7-7 7-7" />
+                            <path stroke-linecap="round" stroke-linejoin="round" d="M11 19l-7-7 7-7" />
+                        </svg>
+                    </button>
+                    <h1 class="gallery-title">Swap</h1>
+                </div>
+            </div>
+
+            <!-- Content -->
+            <div class="gallery-content">
+                <div class="section-content" style="max-width: 1000px;">
+                    <p class="text-lg" style="opacity: 0.7; margin-bottom: 1.5rem;">
+                        Swap toggles the visibility of two elements with a smooth transition.
+                        Perfect for toggle buttons, theme switchers, and animated icons.
+                    </p>
+
+                    <!-- Basic Example with Examplify -->
+                    <div class="card bg-base-200" style="margin-bottom: 2rem;">
+                        <div class="card-body">
+                            <h2 class="card-title">Basic Example</h2>
+                            <p class="text-sm" style="opacity: 0.7; margin-bottom: 1rem;">Swap with rotate animation</p>
+
+                            <!-- Tabs -->
+                            <script>
+                                window.switchSyntaxTab = (tabId) => {
+                                    const tabs = ['tagged', 'vdom', 'object'];
+                                    tabs.forEach(t => {
+                                        const tabEl = document.getElementById(`tab-btn-${t}`);
+                                        const contentEl = document.getElementById(`syntax-${t}`);
+                                        if (t === tabId) {
+                                            tabEl.classList.add('syntax-tab-active');
+                                            contentEl.style.display = 'block';
+                                        } else {
+                                            tabEl.classList.remove('syntax-tab-active');
+                                            contentEl.style.display = 'none';
+                                        }
+                                    });
+                                };
+                            </script>
+                            <div role="tablist" class="syntax-tabs" style="margin-bottom: 1rem;">
+                                <button id="tab-btn-tagged" role="tab" class="syntax-tab syntax-tab-active"
+                                    onclick="switchSyntaxTab('tagged')">Tagged</button>
+                                <button id="tab-btn-vdom" role="tab" class="syntax-tab"
+                                    onclick="switchSyntaxTab('vdom')">vDOM</button>
+                                <button id="tab-btn-object" role="tab" class="syntax-tab"
+                                    onclick="switchSyntaxTab('object')">Object
+                                    DOM</button>
+                            </div>
+
+                            <!-- Tagged Syntax -->
+                            <div id="syntax-tagged">
+                                <pre><script>
+                                    examplify(document.currentScript.nextElementSibling, {
+                                        at: document.currentScript.parentElement,
+                                        scripts: ['/lightview.js', '/lightview-x.js'],
+                                        styles: ['https://cdn.jsdelivr.net/npm/daisyui@3.9.4/dist/full.min.css'],
+                                        type: 'module',
+                                        minHeight: 80,
+                                        autoRun: true
+                                    });
+                                </script><code contenteditable="true">await import('/components/actions/swap.js');
+const { tags, $ } = Lightview;
+const { div, Swap } = tags;
+
+// Emoji swap with rotate effect
+const emojiSwap = Swap({ effect: 'rotate', class: 'text-4xl' },
+    Swap.On({}, '😈'),
+    Swap.Off({}, '😇')
+);
+
+// Play/Pause swap
+const playPause = Swap({ effect: 'rotate', class: 'btn btn-circle' },
+    Swap.On({}, '⏸️'),
+    Swap.Off({}, '▶️')
+);
+
+$('#example').content(
+    div({ style: 'display: flex; gap: 2rem; align-items: center' }, 
+        emojiSwap, 
+        playPause
+    )
+);</code></pre>
+                            </div>
+
+                            <!-- vDOM Syntax -->
+                            <div id="syntax-vdom" style="display: none;">
+                                <pre><script>
+                                    examplify(document.currentScript.nextElementSibling, {
+                                        at: document.currentScript.parentElement,
+                                        scripts: ['/lightview.js', '/lightview-x.js'],
+                                        styles: ['https://cdn.jsdelivr.net/npm/daisyui@3.9.4/dist/full.min.css'],
+                                        type: 'module',
+                                        minHeight: 80
+                                    });
+                                </script><code contenteditable="true">await import('/components/actions/swap.js');
+const { $, tags } = Lightview;
+const { Swap, div } = tags;
+
+const emojiSwap = {
+    tag: Swap,
+    attributes: { effect: 'rotate', class: 'text-4xl' },
+    children: [
+        { tag: Swap.On, children: ['😈'] },
+        { tag: Swap.Off, children: ['😇'] }
+    ]
+};
+
+const playPause = {
+    tag: Swap,
+    attributes: { effect: 'rotate', class: 'btn btn-circle' },
+    children: [
+        { tag: Swap.On, children: ['⏸️'] },
+        { tag: Swap.Off, children: ['▶️'] }
+    ]
+};
+
+$('#example').content({
+    tag: div,
+    attributes: { style: 'display: flex; gap: 2rem; align-items: center' },
+    children: [emojiSwap, playPause]
+});</code></pre>
+                            </div>
+
+                            <!-- Object DOM Syntax -->
+                            <div id="syntax-object" style="display: none;">
+                                <pre><script>
+                                    examplify(document.currentScript.nextElementSibling, {
+                                        at: document.currentScript.parentElement,
+                                        scripts: ['/lightview.js', '/lightview-x.js'],
+                                        styles: ['https://cdn.jsdelivr.net/npm/daisyui@3.9.4/dist/full.min.css'],
+                                        type: 'module',
+                                        minHeight: 80
+                                    });
+                                </script><code contenteditable="true">await import('/components/actions/swap.js');
+const { $ } = Lightview;
+
+const demo = {
+    div: {
+        style: 'display: flex; gap: 2rem; align-items: center',
+        children: [
+            {
+                Swap: {
+                    effect: 'rotate',
+                    class: 'text-4xl',
+                    children: [
+                        { 'Swap.On': { children: ['😈'] } },
+                        { 'Swap.Off': { children: ['😇'] } }
+                    ]
+                }
+            },
+            {
+                Swap: {
+                    effect: 'rotate',
+                    class: 'btn btn-circle',
+                    children: [
+                        { 'Swap.On': { children: ['⏸️'] } },
+                        { 'Swap.Off': { children: ['▶️'] } }
+                    ]
+                }
+            }
+        ]
+    }
+};
+
+$('#example').content(demo);</code></pre>
+                            </div>
+                        </div>
+                    </div>
+
+                    <!-- Reactive Example with Examplify -->
+                    <div class="card bg-base-200" style="margin-bottom: 2rem;">
+                        <div class="card-body">
+                            <h2 class="card-title">Reactive Toggle</h2>
+                            <p class="text-sm" style="opacity: 0.7; margin-bottom: 1rem;">Controlled swap with signal
+                                binding</p>
+
+                            <!-- Tabs -->
+                            <script>
+                                window.switchReactiveSyntaxTab = (tabId) => {
+                                    const tabs = ['tagged', 'vdom', 'object'];
+                                    tabs.forEach(t => {
+                                        const tabEl = document.getElementById(`reactive-tab-btn-${t}`);
+                                        const contentEl = document.getElementById(`reactive-syntax-${t}`);
+                                        if (t === tabId) {
+                                            tabEl.classList.add('syntax-tab-active');
+                                            contentEl.style.display = 'block';
+                                        } else {
+                                            tabEl.classList.remove('syntax-tab-active');
+                                            contentEl.style.display = 'none';
+                                        }
+                                    });
+                                };
+                            </script>
+                            <div role="tablist" class="syntax-tabs" style="margin-bottom: 1rem;">
+                                <button id="reactive-tab-btn-tagged" role="tab" class="syntax-tab syntax-tab-active"
+                                    onclick="switchReactiveSyntaxTab('tagged')">Tagged</button>
+                                <button id="reactive-tab-btn-vdom" role="tab" class="syntax-tab"
+                                    onclick="switchReactiveSyntaxTab('vdom')">vDOM</button>
+                                <button id="reactive-tab-btn-object" role="tab" class="syntax-tab"
+                                    onclick="switchReactiveSyntaxTab('object')">Object DOM</button>
+                            </div>
+
+                            <!-- Tagged Syntax -->
+                            <div id="reactive-syntax-tagged">
+                                <pre><script>
+                                    examplify(document.currentScript.nextElementSibling, {
+                                        at: document.currentScript.parentElement,
+                                        scripts: ['/lightview.js', '/lightview-x.js'],
+                                        styles: ['https://cdn.jsdelivr.net/npm/daisyui@3.9.4/dist/full.min.css'],
+                                        type: 'module',
+                                        minHeight: 180
+                                    });
+                                </script><code contenteditable="true">await import('/components/actions/swap.js');
+await import('/components/actions/button.js');
+
+const { signal, tags, $ } = Lightview;
+const { div, p, Swap, Button } = tags;
+
+const isActive = signal(false);
+
+// Controlled swap
+const swap = Swap({ 
+    effect: 'flip',
+    class: 'text-6xl',
+    active: () => isActive.value,
+    onChange: (checked) => { isActive.value = checked; }
+},
+    Swap.On({}, '🥳'),
+    Swap.Off({}, '😭')
+);
+
+// External control
+const demo = div({ style: 'display: flex; flex-direction: column; gap: 1rem; align-items: center' },
+    swap,
+    p({ class: 'text-sm' }, 
+        () => isActive.value ? 'Party time! 🎉' : 'So sad... 💔'
+    ),
+    Button({ 
+        color: 'primary',
+        size: 'sm',
+        onclick: () => { isActive.value = !isActive.value; }
+    }, 'Toggle from button')
+);
+
+$('#example').content(demo);</code></pre>
+                            </div>
+
+                            <!-- vDOM Syntax -->
+                            <div id="reactive-syntax-vdom" style="display: none;">
+                                <pre><script>
+                                    examplify(document.currentScript.nextElementSibling, {
+                                        at: document.currentScript.parentElement,
+                                        scripts: ['/lightview.js', '/lightview-x.js'],
+                                        styles: ['https://cdn.jsdelivr.net/npm/daisyui@3.9.4/dist/full.min.css'],
+                                        type: 'module',
+                                        minHeight: 180
+                                    });
+                                </script><code contenteditable="true">await import('/components/actions/swap.js');
+await import('/components/actions/button.js');
+const { signal, $, tags } = Lightview;
+const { Swap, Button, div, p } = tags;
+
+const isActive = signal(false);
+
+const demo = {
+    tag: div,
+    attributes: { style: 'display: flex; flex-direction: column; gap: 1rem; align-items: center' },
+    children: [
+        {
+            tag: Swap,
+            attributes: {
+                effect: 'flip',
+                class: 'text-6xl',
+                active: () => isActive.value,
+                onChange: (checked) => { isActive.value = checked; }
+            },
+            children: [
+                { tag: Swap.On, children: ['🥳'] },
+                { tag: Swap.Off, children: ['😭'] }
+            ]
+        },
+        {
+            tag: p,
+            attributes: { class: 'text-sm' },
+            children: [() => isActive.value ? 'Party time! 🎉' : 'So sad... 💔']
+        },
+        {
+            tag: Button,
+            attributes: {
+                color: 'primary',
+                size: 'sm',
+                onclick: () => { isActive.value = !isActive.value; }
+            },
+            children: ['Toggle from button']
+        }
+    ]
+};
+
+$('#example').content(demo);</code></pre>
+                            </div>
+
+                            <!-- Object DOM Syntax -->
+                            <div id="reactive-syntax-object" style="display: none;">
+                                <pre><script>
+                                    examplify(document.currentScript.nextElementSibling, {
+                                        at: document.currentScript.parentElement,
+                                        scripts: ['/lightview.js', '/lightview-x.js'],
+                                        styles: ['https://cdn.jsdelivr.net/npm/daisyui@3.9.4/dist/full.min.css'],
+                                        type: 'module',
+                                        minHeight: 180
+                                    });
+                                </script><code contenteditable="true">await import('/components/actions/swap.js');
+await import('/components/actions/button.js');
+const { signal, $ } = Lightview;
+
+const isActive = signal(false);
+
+const demo = {
+    div: {
+        style: 'display: flex; flex-direction: column; gap: 1rem; align-items: center',
+        children: [
+            {
+                Swap: {
+                    effect: 'flip',
+                    class: 'text-6xl',
+                    active: () => isActive.value,
+                    onChange: (checked) => { isActive.value = checked; },
+                    children: [
+                        { 'Swap.On': { children: ['🥳'] } },
+                        { 'Swap.Off': { children: ['😭'] } }
+                    ]
+                }
+            },
+            {
+                p: {
+                    class: 'text-sm',
+                    children: [() => isActive.value ? 'Party time! 🎉' : 'So sad... 💔']
+                }
+            },
+            {
+                Button: {
+                    color: 'primary',
+                    size: 'sm',
+                    onclick: () => { isActive.value = !isActive.value; },
+                    children: ['Toggle from button']
+                }
+            }
+        ]
+    }
+};
+
+$('#example').content(demo);</code></pre>
+                            </div>
+                        </div>
+                    </div>
+
+                    <!-- Props Table -->
+                    <h2 class="text-xl font-bold" style="margin-bottom: 1rem;">Props</h2>
+                    <div style="overflow-x: auto; margin-bottom: 2rem;">
+                        <table class="table table-zebra">
+                            <thead>
+                                <tr>
+                                    <th>Prop</th>
+                                    <th>Type</th>
+                                    <th>Default</th>
+                                    <th>Description</th>
+                                </tr>
+                            </thead>
+                            <tbody>
+                                <tr>
+                                    <td><code>active</code></td>
+                                    <td>boolean | function</td>
+                                    <td>false</td>
+                                    <td>Control swap state (reactive)</td>
+                                </tr>
+                                <tr>
+                                    <td><code>effect</code></td>
+                                    <td>string</td>
+                                    <td>-</td>
+                                    <td>'rotate' | 'flip'</td>
+                                </tr>
+                                <tr>
+                                    <td><code>onChange</code></td>
+                                    <td>function</td>
+                                    <td>-</td>
+                                    <td>Callback when state changes: <code>(checked) => void</code></td>
+                                </tr>
+                            </tbody>
+                        </table>
+                    </div>
+
+                    <!-- Sub-components -->
+                    <h2 class="text-xl font-bold" style="margin-bottom: 1rem;">Sub-components</h2>
+                    <div style="overflow-x: auto; margin-bottom: 2rem;">
+                        <table class="table table-zebra">
+                            <thead>
+                                <tr>
+                                    <th>Component</th>
+                                    <th>Description</th>
+                                </tr>
+                            </thead>
+                            <tbody>
+                                <tr>
+                                    <td><code>Swap.On</code></td>
+                                    <td>Content visible when active/checked</td>
+                                </tr>
+                                <tr>
+                                    <td><code>Swap.Off</code></td>
+                                    <td>Content visible when inactive/unchecked</td>
+                                </tr>
+                            </tbody>
+                        </table>
+                    </div>
+
+                    <!-- Effects -->
+                    <h2 class="text-xl font-bold" style="margin-bottom: 1rem;">Effects</h2>
+                    <div class="example-flex" style="margin-bottom: 2rem;">
+                        <div class="text-center">
+                            <p class="text-sm opacity-70 mb-2">Rotate</p>
+                            <label class="swap swap-rotate text-4xl">
+                                <input type="checkbox" />
+                                <div class="swap-on">😈</div>
+                                <div class="swap-off">😇</div>
+                            </label>
+                        </div>
+                        <div class="text-center">
+                            <p class="text-sm opacity-70 mb-2">Flip</p>
+                            <label class="swap swap-flip text-4xl">
+                                <input type="checkbox" />
+                                <div class="swap-on">🥳</div>
+                                <div class="swap-off">😭</div>
+                            </label>
+                        </div>
+                    </div>
+
+                    <!-- Hamburger Menu Icon -->
+                    <h2 class="text-xl font-bold" style="margin-bottom: 1rem;">Hamburger Menu Icon</h2>
+                    <label class="btn btn-circle swap swap-rotate" style="margin-bottom: 2rem;">
+                        <input type="checkbox" />
+                        <svg class="swap-off fill-current" xmlns="http://www.w3.org/2000/svg" width="32" height="32"
+                            viewBox="0 0 512 512">
+                            <path d="M64,384H448V341.33H64Zm0-106.67H448V234.67H64ZM64,128v42.67H448V128Z" />
+                        </svg>
+                        <svg class="swap-on fill-current" xmlns="http://www.w3.org/2000/svg" width="32" height="32"
+                            viewBox="0 0 512 512">
+                            <polygon
+                                points="400 145.49 366.51 112 256 222.51 145.49 112 112 145.49 222.51 256 112 366.51 145.49 400 256 289.49 366.51 400 400 366.51 289.49 256 400 145.49" />
+                        </svg>
+                    </label>
+
+                    <!-- Theme Toggle -->
+                    <h2 class="text-xl font-bold" style="margin-bottom: 1rem;">Theme Toggle (Sun/Moon)</h2>
+                    <label class="swap swap-rotate" style="margin-bottom: 2rem;">
+                        <input type="checkbox" class="theme-controller" value="dark" />
+                        <svg class="swap-off h-10 w-10 fill-current" xmlns="http://www.w3.org/2000/svg"
+                            viewBox="0 0 24 24">
+                            <path
+                                d="M5.64,17l-.71.71a1,1,0,0,0,0,1.41,1,1,0,0,0,1.41,0l.71-.71A1,1,0,0,0,5.64,17ZM5,12a1,1,0,0,0-1-1H3a1,1,0,0,0,0,2H4A1,1,0,0,0,5,12Zm7-7a1,1,0,0,0,1-1V3a1,1,0,0,0-2,0V4A1,1,0,0,0,12,5ZM5.64,7.05a1,1,0,0,0,.7.29,1,1,0,0,0,.71-.29,1,1,0,0,0,0-1.41l-.71-.71A1,1,0,0,0,4.93,6.34Zm12,.29a1,1,0,0,0,.7-.29l.71-.71a1,1,0,1,0-1.41-1.41L17,5.64a1,1,0,0,0,0,1.41A1,1,0,0,0,17.66,7.34ZM21,11H20a1,1,0,0,0,0,2h1a1,1,0,0,0,0-2Zm-9,8a1,1,0,0,0-1,1v1a1,1,0,0,0,2,0V20A1,1,0,0,0,12,19ZM18.36,17A1,1,0,0,0,17,18.36l.71.71a1,1,0,0,0,1.41,0,1,1,0,0,0,0-1.41ZM12,6.5A5.5,5.5,0,1,0,17.5,12,5.51,5.51,0,0,0,12,6.5Zm0,9A3.5,3.5,0,1,1,15.5,12,3.5,3.5,0,0,1,12,15.5Z" />
+                        </svg>
+                        <svg class="swap-on h-10 w-10 fill-current" xmlns="http://www.w3.org/2000/svg"
+                            viewBox="0 0 24 24">
+                            <path
+                                d="M21.64,13a1,1,0,0,0-1.05-.14,8.05,8.05,0,0,1-3.37.73A8.15,8.15,0,0,1,9.08,5.49a8.59,8.59,0,0,1,.25-2A1,1,0,0,0,8,2.36,10.14,10.14,0,1,0,22,14.05,1,1,0,0,0,21.64,13Zm-9.5,6.69A8.14,8.14,0,0,1,7.08,5.22v.27A10.15,10.15,0,0,0,17.22,15.63a9.79,9.79,0,0,0,2.1-.22A8.11,8.11,0,0,1,12.14,19.73Z" />
+                        </svg>
+                    </label>
+                </div>
+            </div>
+        </div>
+    </div>
+</div>

package/docs/components/switch.html

@@ -0,0 +1,68 @@
+<!-- SEO-friendly SPA Shim -->
+<script src="/lightview-router.js"></script>
+<script>
+    if (window.LightviewRouter) {
+        window.location.replace('/docs/components/toggle');
+    } else {
+        window.location.href = 'toggle.html';
+    }
+</script>
+
+<!-- Load the page-specific stylesheet -->
+<link rel="stylesheet" href="./index.css">
+
+<!-- Gallery Structure -->
+<div class="gallery-page">
+    <div class="gallery-layout">
+        <!-- Sidebar Overlay -->
+        <div id="sidebar-overlay" class="sidebar-overlay"></div>
+
+        <!-- Sidebar -->
+        <div id="gallery-sidebar" class="gallery-sidebar" style="visibility: hidden" src="./component-nav.html"></div>
+
+        <!-- Main Content -->
+        <div id="gallery-main" class="gallery-main">
+            <!-- Header Container -->
+            <div
+                style="position: sticky; top: 0; z-index: 30; background: var(--gallery-surface); border-bottom: 1px solid var(--gallery-border); backdrop-filter: blur(8px);">
+                <!-- Breadcrumbs Row -->
+                <div style="padding: 0.75rem 1.5rem 0;">
+                    <script>
+                        (() => {
+                            const { Breadcrumbs } = Lightview.tags;
+                            const breadcrumbs = Breadcrumbs({
+                                id: 'page-breadcrumbs',
+                                items: [
+                                    { label: 'Components', href: '/docs/components' },
+                                    { label: 'Switch' }
+                                ]
+                            });
+                            document.currentScript.replaceWith(breadcrumbs.domEl);
+                        })();
+                    </script>
+                </div>
+                <!-- Title Row -->
+                <div class="gallery-header"
+                    style="border-bottom: none; height: auto; padding-top: 0.5rem; padding-bottom: 0.75rem;">
+                    <button id="toggle-btn" class="toggle-btn" aria-label="Toggle Sidebar">
+                        <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" class="toggle-icon"
+                            style="stroke: currentColor; stroke-width: 2;">
+                            <path stroke-linecap="round" stroke-linejoin="round" d="M15 19l-7-7 7-7" />
+                            <path stroke-linecap="round" stroke-linejoin="round" d="M11 19l-7-7 7-7" />
+                        </svg>
+                    </button>
+                    <h1 class="gallery-title">Switch</h1>
+                </div>
+            </div>
+
+            <!-- Content -->
+            <div class="gallery-content">
+                <div class="section-content" style="max-width: 1000px;">
+                    <p class="text-lg" style="opacity: 0.7; margin-bottom: 1.5rem;">
+                        Redirecting to <a href="/docs/components/toggle">Toggle</a>...
+                    </p>
+                </div>
+            </div>
+        </div>
+    </div>
+</div>