lightview 1.8.2 → 2.0.1

package/docs/components/button.html

@@ -0,0 +1,579 @@
+<!-- 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: 'Button' }
+                                ]
+                            });
+                            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">Button</h1>
+                </div>
+            </div>
+
+            <!-- Content -->
+            <div class="gallery-content">
+                <div class="section-content" style="max-width: 1000px;">
+                    <p>
+                        Buttons allow the user to take actions or make choices.
+                        Available in multiple variants, colors, and sizes with reactive state support.
+                    </p>
+
+                    <!-- Interactive Examples -->
+                    <!-- Interactive Examples -->
+
+                    <!-- Basic Usage -->
+                    <div class="card bg-base-200" style="margin-bottom: 2rem;">
+                        <div class="card-body">
+                            <h2 class="card-title">Basic Usage</h2>
+                            <p class="text-sm" style="opacity: 0.7; margin-bottom: 1rem;">Standard buttons with default
+                                styling.</p>
+
+                            <!-- Tabs -->
+                            <script>
+                                window.switchSyntaxTab = (tabId) => {
+                                    const tabs = ['tagged', 'vdom', 'object', 'html'];
+                                    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>
+                                <button id="tab-btn-html" role="tab" class="syntax-tab"
+                                    onclick="switchSyntaxTab('html')">HTML</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',
+                                        height: '100px',
+                                        autoRun: true
+                                    });
+                                </script><code contenteditable="true">await import('/components/actions/button.js');
+const { tags, $ } = Lightview;
+const { div, Button } = tags;
+
+const buttons = div({ style: 'display: flex; gap: 0.5rem;' },
+    Button({}, 'Default'),
+    Button({ color: 'primary' }, 'Primary'),
+    Button({ color: 'secondary' }, 'Secondary')
+);
+
+$('#example').content(buttons);</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',
+                                        height: '100px'
+                                    });
+                                </script><code contenteditable="true">await import('/components/actions/button.js');
+const { $, tags } = Lightview;
+const { div, Button } = tags;
+
+const buttons = {
+    tag: div,
+    attributes: { style: 'display: flex; gap: 0.5rem;' },
+    children: [
+        { tag: Button, children: ['Default'] },
+        { tag: Button, attributes: { color: 'primary' }, children: ['Primary'] },
+        { tag: Button, attributes: { color: 'secondary' }, children: ['Secondary'] }
+    ]
+};
+
+$('#example').content(buttons);</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',
+                                        height: '100px'
+                                    });
+                                </script><code contenteditable="true">// Object DOM syntax now requires lightview-x.js
+await import('/components/actions/button.js');
+const { $ } = Lightview;
+
+const buttons = {
+    div: {
+        style: 'display: flex; gap: 0.5rem;',
+        children: [
+            { Button: { children: ['Default'] } },
+            { Button: { color: 'primary', children: ['Primary'] } },
+            { Button: { color: 'secondary', children: ['Secondary'] } }
+        ]
+    }
+};
+
+$('#example').content(buttons);</code></pre>
+                            </div>
+
+                            <!-- HTML Syntax -->
+                            <div id="syntax-html" 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',
+                                        language: 'html',
+                                        height: '100px'
+                                    });
+                                </script><code contenteditable="true" class="language-html">&lt;!-- Import the component (registers lv-button) --&gt;
+&lt;script type="module" src="/components/actions/button.js"&gt;&lt;/script&gt;
+
+&lt;div style="display: flex; gap: 0.5rem;"&gt;
+    &lt;lv-button&gt;Default&lt;/lv-button&gt;
+    &lt;lv-button color="primary"&gt;Primary&lt;/lv-button&gt;
+    &lt;lv-button color="secondary"&gt;Secondary&lt;/lv-button&gt;
+&lt;/div&gt;</code></pre>
+                            </div>
+                        </div>
+                    </div>
+
+                    <!-- Reactive State -->
+                    <div class="card bg-base-200" style="margin-bottom: 2rem;">
+                        <div class="card-body">
+                            <h2 class="card-title">Reactive State</h2>
+                            <p class="text-sm" style="opacity: 0.7; margin-bottom: 1rem;">Buttons with built-in loading
+                                and state
+                                handling.</p>
+
+                            <!-- Tabs -->
+                            <script>
+                                window.switchReactiveSyntaxTab = (tabId) => {
+                                    const tabs = ['tagged', 'vdom', 'object', 'html'];
+                                    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>
+                                <button id="reactive-tab-btn-html" role="tab" class="syntax-tab"
+                                    onclick="switchReactiveSyntaxTab('html')">HTML</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',
+                                        height: '80px'
+                                    });
+                                </script><code contenteditable="true">await import('/components/actions/button.js');
+const { signal, tags, $ } = Lightview;
+const { div, span, Button } = tags;
+
+const isLoading = signal(false);
+
+const button = div({ style: 'display: flex; gap: 1rem; align-items: center;' },
+    Button({ 
+        color: 'primary',
+        loading: () => isLoading.value,
+        onclick: async () => {
+            isLoading.value = true;
+            await new Promise(r => setTimeout(r, 2000));
+            isLoading.value = false;
+        }
+    }, 'Save Changes'),
+    span({ style: 'opacity: 0.7;' },
+        () => isLoading.value ? '⏳ Saving...' : 'Click to test'
+    )
+);
+
+$('#example').content(button);</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: '80px'
+                                    });
+                                </script><code contenteditable="true">await import('/components/actions/button.js');
+const { signal, tags, $ } = Lightview;
+const { div, span, Button } = tags;
+
+const isLoading = signal(false);
+
+const button = {
+    tag: 'div',
+    attributes: { style: 'display: flex; gap: 1rem; align-items: center;' },
+    children: [
+        { 
+            tag: Button, 
+            attributes: { 
+                color: 'primary',
+                loading: () => isLoading.value,
+                onclick: async () => {
+                    isLoading.value = true;
+                    await new Promise(r => setTimeout(r, 2000));
+                    isLoading.value = false;
+                }
+            }, 
+            children: ['Save Changes'] 
+        },
+        { 
+            tag: 'span', 
+            attributes: { style: 'opacity: 0.7;' }, 
+            children: [() => isLoading.value ? '⏳ Saving...' : 'Click to test'] 
+        }
+    ]
+};
+
+$('#example').content(button);</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: 100
+                                    });
+                                </script><code contenteditable="true">await import('/components/actions/button.js');
+const { signal, tags, $ } = Lightview;
+const { div, span, Button } = tags;
+
+const isLoading = signal(false);
+
+const button = {
+    div: {
+        style: 'display: flex; gap: 1rem; align-items: center;',
+        children: [
+            { 
+                Button: { 
+                    color: 'primary',
+                    loading: () => isLoading.value,
+                    onclick: async () => {
+                        isLoading.value = true;
+                        await new Promise(r => setTimeout(r, 2000));
+                        isLoading.value = false;
+                    },
+                    children: ['Save Changes'] 
+                } 
+            },
+            { 
+                span: { 
+                    style: 'opacity: 0.7;', 
+                    children: [() => isLoading.value ? '⏳ Saving...' : 'Click to test'] 
+                } 
+            }
+        ]
+    }
+};
+
+$('#example').content(button);</code></pre>
+                            </div>
+
+                            <!-- HTML Syntax -->
+                            <div id="reactive-syntax-html" 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',
+                                        language: 'html',
+                                        height: '100px'
+                                    });
+                                </script><code contenteditable="true" class="language-html">&lt;!-- Define a named signal globally --&gt;
+&lt;script&gt;
+window.signal = Lightview.signal;
+signal(false, 'btnLoading');
+&lt;/script&gt;
+
+&lt;!-- Import Button --&gt;
+&lt;script type="module" src="/components/actions/button.js"&gt;&lt;/script&gt;
+
+&lt;div style="display: flex; gap: 1rem; align-items: center;"&gt;
+    &lt;lv-button 
+        color="primary"
+        loading="${signal.get('btnLoading').value}"
+        onclick="signal.get('btnLoading').value = true; setTimeout(() => signal.get('btnLoading').value = false, 2000)"
+    &gt;
+        Save Changes
+    &lt;/lv-button&gt;
+    
+    &lt;span style="opacity: 0.7;"&gt;
+        ${signal.get('btnLoading').value ? '⏳ Saving...' : 'Click to test'}
+    &lt;/span&gt;
+&lt;/div&gt;</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>color</code></td>
+                                    <td>string</td>
+                                    <td>-</td>
+                                    <td>'primary' | 'secondary' | 'accent' | 'neutral' | 'info' | 'success' | 'warning'
+                                        | 'error' |
+                                        'ghost' | 'link'</td>
+                                </tr>
+                                <tr>
+                                    <td><code>size</code></td>
+                                    <td>string</td>
+                                    <td>'md'</td>
+                                    <td>'xs' | 'sm' | 'md' | 'lg'</td>
+                                </tr>
+                                <tr>
+                                    <td><code>variant</code></td>
+                                    <td>string</td>
+                                    <td>-</td>
+                                    <td>'outline' | 'soft' | 'dash' | 'wide' | 'block' | 'square' | 'circle'</td>
+                                </tr>
+                                <tr>
+                                    <td><code>disabled</code></td>
+                                    <td>boolean | function</td>
+                                    <td>false</td>
+                                    <td>Disable the button (supports reactive function)</td>
+                                </tr>
+                                <tr>
+                                    <td><code>loading</code></td>
+                                    <td>boolean | function</td>
+                                    <td>false</td>
+                                    <td>Show loading spinner (supports reactive function)</td>
+                                </tr>
+                                <tr>
+                                    <td><code>active</code></td>
+                                    <td>boolean</td>
+                                    <td>false</td>
+                                    <td>Force active/pressed state</td>
+                                </tr>
+                                <tr>
+                                    <td><code>glass</code></td>
+                                    <td>boolean</td>
+                                    <td>false</td>
+                                    <td>Glass morphism effect</td>
+                                </tr>
+                                <tr>
+                                    <td><code>noAnimation</code></td>
+                                    <td>boolean</td>
+                                    <td>false</td>
+                                    <td>Disable click animation</td>
+                                </tr>
+                            </tbody>
+                        </table>
+                    </div>
+
+                    <!-- Visual Gallery (Static) -->
+
+                    <!-- Colors -->
+                    <h2 class="text-xl font-bold" style="margin-bottom: 1rem;">Colors</h2>
+                    <div id="colors-demo" style="display: flex; flex-wrap: wrap; gap: 0.5rem; margin-bottom: 2rem;">
+                    </div>
+
+                    <!-- Variants -->
+                    <h2 class="text-xl font-bold" style="margin-bottom: 1rem;">Variants</h2>
+                    <div id="variants-demo" style="margin-bottom: 2rem;"></div>
+
+                    <!-- Sizes -->
+                    <h2 class="text-xl font-bold" style="margin-bottom: 1rem;">Sizes</h2>
+                    <div id="sizes-demo"
+                        style="display: flex; flex-wrap: wrap; align-items: flex-end; gap: 0.5rem; margin-bottom: 2rem;">
+                    </div>
+
+                    <!-- States -->
+                    <h2 class="text-xl font-bold" style="margin-bottom: 1rem;">States</h2>
+                    <div id="states-demo" style="display: flex; flex-wrap: wrap; gap: 0.5rem; margin-bottom: 2rem;">
+                    </div>
+
+                    <!-- Special Shapes -->
+                    <h2 class="text-xl font-bold" style="margin-bottom: 1rem;">Special Shapes</h2>
+                    <div id="shapes-demo" style="display: flex; flex-wrap: wrap; gap: 0.5rem; margin-bottom: 2rem;">
+                    </div>
+
+                    <script type="module">
+                        await import('/components/actions/button.js');
+                        const { tags, $ } = Lightview;
+                        const { div, h3, svg, path, Button } = tags;
+
+                        // Helper to create X icon SVG Component
+                        const XIcon = () => svg(
+                            { xmlns: "http://www.w3.org/2000/svg", fill: "none", viewBox: "0 0 24 24", style: "width: 1.5rem; height: 1.5rem; stroke: currentColor;" },
+                            path({ "stroke-linecap": "round", "stroke-linejoin": "round", "stroke-width": "2", d: "M6 18L18 6M6 6l12 12" })
+                        );
+
+                        // Colors Demo
+                        $('#colors-demo').content([
+                            Button({ useShadow: true }, "Default"),
+                            Button({ color: "neutral" }, "Neutral"),
+                            Button({ color: "primary" }, "Primary"),
+                            Button({ color: "secondary" }, "Secondary"),
+                            Button({ color: "accent" }, "Accent"),
+                            Button({ color: "info" }, "Info"),
+                            Button({ color: "success" }, "Success"),
+                            Button({ color: "warning" }, "Warning"),
+                            Button({ color: "error" }, "Error")
+                        ]);
+
+                        // Variants Demo
+                        $('#variants-demo').content([
+                            div({ style: "margin-bottom: 1rem;" },
+                                h3({ class: "font-semibold", style: "margin-bottom: 0.5rem;" }, "Outline"),
+                                div({ style: "display: flex; flex-wrap: wrap; gap: 0.5rem;" },
+                                    Button({ variant: "outline" }, "Default"),
+                                    Button({ variant: "outline", color: "primary" }, "Primary"),
+                                    Button({ variant: "outline", color: "secondary" }, "Secondary"),
+                                    Button({ variant: "outline", color: "accent" }, "Accent")
+                                )
+                            ),
+                            div({ style: "margin-bottom: 1rem;" },
+                                h3({ class: "font-semibold", style: "margin-bottom: 0.5rem;" }, "Soft"),
+                                div({ style: "display: flex; flex-wrap: wrap; gap: 0.5rem;" },
+                                    Button({ variant: "soft" }, "Default"),
+                                    Button({ variant: "soft", color: "primary" }, "Primary"),
+                                    Button({ variant: "soft", color: "secondary" }, "Secondary"),
+                                    Button({ variant: "soft", color: "accent" }, "Accent")
+                                )
+                            ),
+                            div({},
+                                h3({ class: "font-semibold", style: "margin-bottom: 0.5rem;" }, "Ghost & Link"),
+                                div({ style: "display: flex; flex-wrap: wrap; gap: 0.5rem;" },
+                                    Button({ color: "ghost" }, "Ghost"),
+                                    Button({ color: "link" }, "Link")
+                                )
+                            )
+                        ]);
+
+                        // Sizes Demo
+                        $('#sizes-demo').content([
+                            Button({ color: "primary", size: "xs" }, "Extra Small"),
+                            Button({ color: "primary", size: "sm" }, "Small"),
+                            Button({ color: "primary" }, "Medium"),
+                            Button({ color: "primary", size: "lg" }, "Large")
+                        ]);
+
+                        // States Demo
+                        $('#states-demo').content([
+                            Button({ color: "primary" }, "Normal"),
+                            Button({ color: "primary", active: true }, "Active"),
+                            Button({ color: "primary", disabled: true }, "Disabled"),
+                            Button({ color: "primary", loading: true }, "Loading")
+                        ]);
+
+                        // Special Shapes Demo
+                        $('#shapes-demo').content([
+                            Button({ variant: "wide" }, "Wide"),
+                            Button({ variant: "block" }, "Block (Full Width)"),
+                            Button({ variant: "square" }, XIcon()),
+                            Button({ variant: "circle" }, XIcon())
+                        ]);
+                    </script>
+
+
+
+                </div>
+            </div>
+        </div>
+    </div>
+</div>