lightview 1.8.2 → 2.0.0

package/docs/components/sidebar-setup.js

@@ -0,0 +1,93 @@
+/* eslint-env browser */
+/* global Lightview */
+/**
+ * Sidebar Setup Utility
+ * Initializes the slide-out drawer functionality for component documentation pages
+ */
+
+/**
+ * Initialize the sidebar drawer functionality
+ * This should be called after the DOM is loaded and Lightview is available
+ * 
+ * @example
+ * <script type="module">
+ *   import { initSidebar } from './sidebar-setup.js';
+ *   initSidebar();
+ * </script>
+ */
+export function initSidebar() {
+    const { signal } = Lightview;
+
+    // Sidebar state
+    const sidebarOpen = signal(false);
+
+    // Get DOM elements
+    const sidebar = document.getElementById('gallery-sidebar');
+    const main = document.getElementById('gallery-main');
+    const overlay = document.getElementById('sidebar-overlay');
+    const toggleBtn = document.getElementById('toggle-btn');
+    const toggleIcon = toggleBtn?.querySelector('svg');
+
+    // Validate required elements exist
+    if (!sidebar || !main || !overlay || !toggleBtn || !toggleIcon) {
+        console.error('Sidebar elements not found. Required elements:', {
+            sidebar: !!sidebar,
+            main: !!main,
+            overlay: !!overlay,
+            toggleBtn: !!toggleBtn,
+            toggleIcon: !!toggleIcon
+        });
+        return;
+    }
+
+    /**
+     * Update the UI based on sidebar state
+     */
+    function updateSidebarUI() {
+        sidebar.className = `gallery-sidebar ${sidebarOpen.value ? 'open' : 'closed'}`;
+        main.className = `gallery-main ${sidebarOpen.value ? '' : 'sidebar-closed'}`;
+        overlay.className = `sidebar-overlay ${sidebarOpen.value ? 'active' : ''}`;
+        toggleIcon.setAttribute('class', `toggle-icon ${sidebarOpen.value ? '' : 'rotated'}`);
+    }
+
+    /**
+     * Toggle sidebar open/closed
+     */
+    function toggleSidebar() {
+        sidebar.style.visibility = ''; // Remove initial hidden state
+        sidebarOpen.value = !sidebarOpen.value;
+        updateSidebarUI();
+    }
+
+    /**
+     * Close sidebar
+     */
+    function closeSidebar() {
+        sidebarOpen.value = false;
+        updateSidebarUI();
+    }
+
+    // Attach event listeners
+    toggleBtn.onclick = toggleSidebar;
+    overlay.onclick = closeSidebar;
+
+    // Initial UI update
+    updateSidebarUI();
+
+    // Mark layout as ready - enables sidebar visibility after initial state is set
+    const galleryLayout = document.querySelector('.gallery-layout');
+    if (galleryLayout) {
+        galleryLayout.classList.add('js-ready');
+    }
+
+    // Return API for programmatic control if needed
+    return {
+        open: () => {
+            sidebarOpen.value = true;
+            updateSidebarUI();
+        },
+        close: closeSidebar,
+        toggle: toggleSidebar,
+        isOpen: () => sidebarOpen.value
+    };
+}

package/docs/components/skeleton.html

@@ -0,0 +1,447 @@
+<!-- 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: 'Skeleton' }
+                                ]
+                            });
+                            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">Skeleton</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;">
+                        Skeleton is used as placeholder while content is loading.
+                        Provides visual feedback during data fetching.
+                    </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;">Card skeleton layout</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'],
+                                        type: 'module',
+                                        minHeight: 200,
+                                        autoRun: true
+                                    });
+                                </script><code contenteditable="true">const { default: Skeleton } = await import('/components/data-display/skeleton.js');
+const { tags, $ } = Lightview;
+const { div } = tags;
+
+const cardSkeleton = div({ style: 'display: flex; flex-direction: column; gap: 1rem; width: 13rem' },
+    Skeleton({ class: 'h-32 w-full' }),
+    Skeleton({ class: 'h-4 w-28' }),
+    Skeleton({ class: 'h-4 w-full' }),
+    Skeleton({ class: 'h-4 w-full' })
+);
+
+$('#example').content(cardSkeleton);</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'],
+                                        type: 'module',
+                                        minHeight: 200
+                                    });
+                                </script><code contenteditable="true">const { default: Skeleton } = await import('/components/data-display/skeleton.js');
+const { $ } = Lightview;
+
+const cardSkeleton = {
+    tag: 'div',
+    attributes: { style: 'display: flex; flex-direction: column; gap: 1rem; width: 13rem' },
+    children: [
+        { tag: Skeleton, attributes: { class: 'h-32 w-full' } },
+        { tag: Skeleton, attributes: { class: 'h-4 w-28' } },
+        { tag: Skeleton, attributes: { class: 'h-4 w-full' } },
+        { tag: Skeleton, attributes: { class: 'h-4 w-full' } }
+    ]
+};
+
+$('#example').content(cardSkeleton);</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'],
+                                        type: 'module',
+                                        minHeight: 200
+                                    });
+                                </script><code contenteditable="true">const { default: Skeleton } = await import('/components/data-display/skeleton.js');
+const { tags, $ } = Lightview;
+tags.Skeleton = Skeleton;
+
+$('#example').content({
+    div: {
+        style: 'display: flex; flex-direction: column; gap: 1rem; width: 13rem',
+        children: [
+            { Skeleton: { class: 'h-32 w-full' } },
+            { Skeleton: { class: 'h-4 w-28' } },
+            { Skeleton: { class: 'h-4 w-full' } },
+            { Skeleton: { class: 'h-4 w-full' } }
+        ]
+    }
+});</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">Loading State</h2>
+                            <p class="text-sm" style="opacity: 0.7; margin-bottom: 1rem;">Toggle between skeleton and
+                                content</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'],
+                                        type: 'module',
+                                        minHeight: 380
+                                    });
+                                </script><code contenteditable="true">const { default: Skeleton } = await import('/components/data-display/skeleton.js');
+const { default: Button } = await import('/components/actions/button.js');
+const { default: Card } = await import('/components/data-display/card.js');
+
+const { signal, tags, $ } = Lightview;
+const { div, p, h3, img } = tags;
+
+const loading = signal(true);
+
+// Simulate data loading
+setTimeout(() => { loading.value = false; }, 2000);
+
+const demo = div({ class: 'w-64' },
+    () => loading.value
+        ? div({ style: 'display: flex; flex-direction: column; gap: 1rem' },
+            Skeleton({ class: 'h-40 w-full rounded-lg' }),
+            Skeleton({ class: 'h-6 w-3/4' }),
+            Skeleton({ class: 'h-4 w-full' }),
+            Skeleton({ class: 'h-10 w-24' })
+        )
+        : Card({},
+            Card.Figure({ 
+                src: 'https://picsum.photos/300/200?random=20',
+                alt: 'Loaded content'
+            }),
+            Card.Body({},
+                Card.Title({}, 'Content Loaded'),
+                p({}, 'This is the actual content!'),
+                Button({ color: 'primary', size: 'sm' }, 'Action')
+            )
+        ),
+    Button({ 
+        class: 'mt-4',
+        size: 'sm',
+        onclick: () => { loading.value = true; setTimeout(() => { loading.value = false; }, 2000); }
+    }, 'Reload')
+);
+
+$('#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'],
+                                        type: 'module',
+                                        minHeight: 380
+                                    });
+                                </script><code contenteditable="true">const { default: Skeleton } = await import('/components/data-display/skeleton.js');
+const { default: Button } = await import('/components/actions/button.js');
+const { default: Card } = await import('/components/data-display/card.js');
+const { signal, $ } = Lightview;
+
+const loading = signal(true);
+
+setTimeout(() => { loading.value = false; }, 2000);
+
+const demo = {
+    tag: 'div',
+    attributes: { class: 'w-64' },
+    children: [
+        () => loading.value
+            ? {
+                tag: 'div',
+                attributes: { style: 'display: flex; flex-direction: column; gap: 1rem' },
+                children: [
+                    { tag: Skeleton, attributes: { class: 'h-40 w-full rounded-lg' } },
+                    { tag: Skeleton, attributes: { class: 'h-6 w-3/4' } },
+                    { tag: Skeleton, attributes: { class: 'h-4 w-full' } },
+                    { tag: Skeleton, attributes: { class: 'h-10 w-24' } }
+                ]
+            }
+            : {
+                tag: Card,
+                children: [
+                    {
+                        tag: Card.Figure,
+                        attributes: { 
+                            src: 'https://picsum.photos/300/200?random=20',
+                            alt: 'Loaded content'
+                        }
+                    },
+                    {
+                        tag: Card.Body,
+                        children: [
+                            { tag: Card.Title, children: ['Content Loaded'] },
+                            { tag: 'p', children: ['This is the actual content!'] },
+                            { tag: Button, attributes: { color: 'primary', size: 'sm' }, children: ['Action'] }
+                        ]
+                    }
+                ]
+            },
+        {
+            tag: Button,
+            attributes: { 
+                class: 'mt-4',
+                size: 'sm',
+                onclick: () => { loading.value = true; setTimeout(() => { loading.value = false; }, 2000); }
+            },
+            children: ['Reload']
+        }
+    ]
+};
+
+$('#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'],
+                                        type: 'module',
+                                        minHeight: 380
+                                    });
+                                </script><code contenteditable="true">const { default: Skeleton } = await import('/components/data-display/skeleton.js');
+const { default: Button } = await import('/components/actions/button.js');
+const { default: Card } = await import('/components/data-display/card.js');
+const { signal, tags, $ } = Lightview;
+tags.Skeleton = Skeleton;
+tags.Button = Button;
+tags.Card = Card;
+
+const loading = signal(true);
+
+setTimeout(() => { loading.value = false; }, 2000);
+
+const demo = {
+    div: {
+        class: 'w-64',
+        children: [
+            () => loading.value
+                ? {
+                    div: {
+                        style: 'display: flex; flex-direction: column; gap: 1rem',
+                        children: [
+                            { Skeleton: { class: 'h-40 w-full rounded-lg' } },
+                            { Skeleton: { class: 'h-6 w-3/4' } },
+                            { Skeleton: { class: 'h-4 w-full' } },
+                            { Skeleton: { class: 'h-10 w-24' } }
+                        ]
+                    }
+                }
+                : {
+                    Card: {
+                        children: [
+                            {
+                                'Card.Figure': { 
+                                    src: 'https://picsum.photos/300/200?random=20',
+                                    alt: 'Loaded content'
+                                }
+                            },
+                            {
+                                'Card.Body': {
+                                    children: [
+                                        { 'Card.Title': { text: 'Content Loaded' } },
+                                        { p: { text: 'This is the actual content!' } },
+                                        { Button: { color: 'primary', size: 'sm', text: 'Action' } }
+                                    ]
+                                }
+                            }
+                        ]
+                    }
+                },
+            {
+                Button: { 
+                    class: 'mt-4',
+                    size: 'sm',
+                    onclick: () => { loading.value = true; setTimeout(() => { loading.value = false; }, 2000); },
+                    text: 'Reload'
+                }
+            }
+        ]
+    }
+};
+
+$('#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>class</code></td>
+                                    <td>string</td>
+                                    <td>-</td>
+                                    <td>Width/height classes (h-32 w-full, rounded-full, etc.)</td>
+                                </tr>
+                            </tbody>
+                        </table>
+                    </div>
+
+                    <!-- Examples -->
+                    <h2 class="text-xl font-bold" style="margin-bottom: 1rem;">Card Skeleton</h2>
+                    <div style="display: flex; width: 13rem; flex-direction: column; gap: 1rem; margin-bottom: 2rem;">
+                        <div class="skeleton h-32 w-full"></div>
+                        <div class="skeleton h-4 w-28"></div>
+                        <div class="skeleton h-4 w-full"></div>
+                        <div class="skeleton h-4 w-full"></div>
+                    </div>
+
+                    <h2 class="text-xl font-bold" style="margin-bottom: 1rem;">With Avatar</h2>
+                    <div style="display: flex; align-items: center; gap: 1rem; margin-bottom: 2rem;">
+                        <div class="skeleton h-16 w-16 shrink-0 rounded-full"></div>
+                        <div style="display: flex; flex-direction: column; gap: 1rem">
+                            <div class="skeleton h-4 w-20"></div>
+                            <div class="skeleton h-4 w-28"></div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+</div>
+</div>
+</div>

package/docs/components/spinner.html

@@ -0,0 +1,68 @@
+<!-- SEO-friendly SPA Shim -->
+<script src="/lightview-router.js"></script>
+<script>
+    if (window.LightviewRouter) {
+        window.location.replace('/docs/components/loading');
+    } else {
+        window.location.href = 'loading.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: 'Spinner' }
+                                ]
+                            });
+                            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">Spinner</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/loading">Loading</a>...
+                    </p>
+                </div>
+            </div>
+        </div>
+    </div>
+</div>