lightview 1.8.2 → 2.0.0

package/docs/components/tooltip.html

@@ -0,0 +1,423 @@
+<!-- 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: 'Tooltip' }
+                                ]
+                            });
+                            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">Tooltip</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;">
+                        Tooltip displays informative text when users hover, focus, or tap an element.
+                        Supports multiple positions and colors.
+                    </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;">Tooltips with different
+                                positions</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: 100,
+                                        autoRun: true,
+                                        html: '<div id="demo" class="p-8"></div>'
+                                    });
+                                </script><code contenteditable="true">await import('/components/data-display/tooltip.js');
+await import('/components/actions/button.js');
+
+const { tags, $ } = Lightview;
+const { div, Tooltip, Button } = tags;
+
+const tooltips = div({ style: 'display: flex; flex-wrap: wrap; gap: 1rem' },
+    Tooltip({ tip: 'Tooltip on top', position: 'top' },
+        Button({}, 'Top')
+    ),
+    Tooltip({ tip: 'Tooltip on bottom', position: 'bottom' },
+        Button({}, 'Bottom')
+    ),
+    Tooltip({ tip: 'Tooltip on left', position: 'left' },
+        Button({}, 'Left')
+    ),
+    Tooltip({ tip: 'Tooltip on right', position: 'right' },
+        Button({}, 'Right')
+    )
+);
+
+$('#demo').content(tooltips);</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: 100,
+                                        html: '<div id="demo" class="p-8"></div>'
+                                    });
+                                </script><code contenteditable="true">await import('/components/data-display/tooltip.js');
+await import('/components/actions/button.js');
+const { $, tags } = Lightview;
+const { Tooltip, Button, div } = tags;
+
+const tooltips = {
+    tag: div,
+    attributes: { style: 'display: flex; flex-wrap: wrap; gap: 1rem' },
+    children: [
+        {
+            tag: Tooltip,
+            attributes: { tip: 'Tooltip on top', position: 'top' },
+            children: [{ tag: Button, children: ['Top'] }]
+        },
+        {
+            tag: Tooltip,
+            attributes: { tip: 'Tooltip on bottom', position: 'bottom' },
+            children: [{ tag: Button, children: ['Bottom'] }]
+        },
+        {
+            tag: Tooltip,
+            attributes: { tip: 'Tooltip on left', position: 'left' },
+            children: [{ tag: Button, children: ['Left'] }]
+        },
+        {
+            tag: Tooltip,
+            attributes: { tip: 'Tooltip on right', position: 'right' },
+            children: [{ tag: Button, children: ['Right'] }]
+        }
+    ]
+};
+
+$('#demo').content(tooltips);</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: 100,
+                                        html: '<div id="demo" class="p-8"></div>'
+                                    });
+                                </script><code contenteditable="true">await import('/components/data-display/tooltip.js');
+await import('/components/actions/button.js');
+const { $ } = Lightview;
+
+const tooltips = {
+    div: {
+        style: 'display: flex; flex-wrap: wrap; gap: 1rem',
+        children: [
+            { Tooltip: { tip: 'Tooltip on top', position: 'top', children: [{ Button: { children: ['Top'] } }] } },
+            { Tooltip: { tip: 'Tooltip on bottom', position: 'bottom', children: [{ Button: { children: ['Bottom'] } }] } },
+            { Tooltip: { tip: 'Tooltip on left', position: 'left', children: [{ Button: { children: ['Left'] } }] } },
+            { Tooltip: { tip: 'Tooltip on right', position: 'right', children: [{ Button: { children: ['Right'] } }] } }
+        ]
+    }
+};
+
+$('#demo').content(tooltips);</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">Colored Tooltips</h2>
+                            <p class="text-sm" style="opacity: 0.7; margin-bottom: 1rem;">Tooltips with semantic colors
+                            </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: 100,
+                                        html: '<div id="demo" class="p-8"></div>'
+                                    });
+                                </script><code contenteditable="true">await import('/components/data-display/tooltip.js');
+await import('/components/actions/button.js');
+
+const { tags, $ } = Lightview;
+const { div, Tooltip, Button } = tags;
+
+const colors = ['primary', 'secondary', 'accent', 'info', 'success', 'warning', 'error'];
+
+const tooltips = div({ style: 'display: flex; flex-wrap: wrap; gap: 1rem' },
+    ...colors.map(color => 
+        Tooltip({ tip: `${color.charAt(0).toUpperCase() + color.slice(1)} tooltip`, color },
+            Button({ color, size: 'sm' }, color)
+        )
+    )
+);
+
+$('#demo').content(tooltips);</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: 100,
+                                        html: '<div id="demo" class="p-8"></div>'
+                                    });
+                                </script><code contenteditable="true">await import('/components/data-display/tooltip.js');
+await import('/components/actions/button.js');
+const { $, tags } = Lightview;
+const { Tooltip, Button, div } = tags;
+
+const colors = ['primary', 'secondary', 'accent', 'info', 'success', 'warning', 'error'];
+
+const tooltips = {
+    tag: div,
+    attributes: { style: 'display: flex; flex-wrap: wrap; gap: 1rem' },
+    children: colors.map(color => ({
+        tag: Tooltip,
+        attributes: { tip: `${color.charAt(0).toUpperCase() + color.slice(1)} tooltip`, color },
+        children: [{ tag: Button, attributes: { color, size: 'sm' }, children: [color] }]
+    }))
+};
+
+$('#demo').content(tooltips);</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,
+                                        html: '<div id="demo" class="p-8"></div>'
+                                    });
+                                </script><code contenteditable="true">await import('/components/data-display/tooltip.js');
+await import('/components/actions/button.js');
+const { $ } = Lightview;
+
+const colors = ['primary', 'secondary', 'accent', 'info', 'success', 'warning', 'error'];
+
+const tooltips = {
+    div: {
+        style: 'display: flex; flex-wrap: wrap; gap: 1rem',
+        children: colors.map(color => ({
+            Tooltip: {
+                tip: `${color.charAt(0).toUpperCase() + color.slice(1)} tooltip`,
+                color,
+                children: [
+                    { Button: { color, size: 'sm', children: [color] } }
+                ]
+            }
+        }))
+    }
+};
+
+$('#demo').content(tooltips);</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>tip</code></td>
+                                    <td>string</td>
+                                    <td>-</td>
+                                    <td>Tooltip text content</td>
+                                </tr>
+                                <tr>
+                                    <td><code>position</code></td>
+                                    <td>string</td>
+                                    <td>'top'</td>
+                                    <td>'top' | 'bottom' | 'left' | 'right'</td>
+                                </tr>
+                                <tr>
+                                    <td><code>color</code></td>
+                                    <td>string</td>
+                                    <td>-</td>
+                                    <td>'primary' | 'secondary' | 'accent' | 'info' | 'success' | 'warning' | 'error'
+                                    </td>
+                                </tr>
+                                <tr>
+                                    <td><code>open</code></td>
+                                    <td>boolean</td>
+                                    <td>false</td>
+                                    <td>Force tooltip to stay open</td>
+                                </tr>
+                            </tbody>
+                        </table>
+                    </div>
+
+                    <!-- Positions -->
+                    <h2 class="text-xl font-bold" style="margin-bottom: 1rem;">Positions</h2>
+                    <div style="display: flex; flex-wrap: wrap; gap: 1rem; padding: 2rem; margin-bottom: 2rem;">
+                        <div class="tooltip tooltip-top" data-tip="Top"><button class="btn">Top</button></div>
+                        <div class="tooltip tooltip-bottom" data-tip="Bottom"><button class="btn">Bottom</button></div>
+                        <div class="tooltip tooltip-left" data-tip="Left"><button class="btn">Left</button></div>
+                        <div class="tooltip tooltip-right" data-tip="Right"><button class="btn">Right</button></div>
+                    </div>
+
+                    <!-- Colors -->
+                    <h2 class="text-xl font-bold" style="margin-bottom: 1rem;">Colors</h2>
+                    <div class="example-flex" style="margin-bottom: 2rem;">
+                        <div class="tooltip tooltip-primary" data-tip="Primary"><button class="btn">Primary</button>
+                        </div>
+                        <div class="tooltip tooltip-secondary" data-tip="Secondary"><button
+                                class="btn">Secondary</button></div>
+                        <div class="tooltip tooltip-accent" data-tip="Accent"><button class="btn">Accent</button></div>
+                        <div class="tooltip tooltip-info" data-tip="Info"><button class="btn">Info</button></div>
+                        <div class="tooltip tooltip-success" data-tip="Success"><button class="btn">Success</button>
+                        </div>
+                        <div class="tooltip tooltip-warning" data-tip="Warning"><button class="btn">Warning</button>
+                        </div>
+                        <div class="tooltip tooltip-error" data-tip="Error"><button class="btn">Error</button></div>
+                    </div>
+
+                    <!-- Force Open -->
+                    <h2 class="text-xl font-bold" style="margin-bottom: 1rem;">Force Open</h2>
+                    <div style="margin-bottom: 2rem;">
+                        <div class="tooltip tooltip-open tooltip-primary" data-tip="Always visible">
+                            <button class="btn btn-primary">Always Open</button>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+</div>
+</div>
+</div>

package/docs/examples/getting-started-example.html

@@ -0,0 +1,40 @@
+<!-- SEO-friendly SPA Shim -->
+<script src="/lightview-router.js"></script>
+<script>
+    if (window.LightviewRouter) {
+        LightviewRouter.base('/index.html');
+    }
+</script>
+
+<!DOCTYPE html>
+<html>
+
+<head>
+    <title>My First Lightview App</title>
+    <script src="lightview.js"></script>
+</head>
+
+<body>
+    <div id="app"></div>
+
+    <script>
+        // Get the tools we need
+        const { signal, tags } = Lightview;
+        const { div, h1, p, button } = tags;
+
+        // Create reactive state
+        const count = signal(0);
+
+        // Build the UI
+        const app = div(
+            h1('Hello Lightview! 👋'),
+            p(() => `You clicked ${count.value} times`),
+            button({ onclick: () => count.value++ }, 'Click me!')
+        );
+
+        // Mount to the DOM
+        document.getElementById('app').appendChild(app.domEl);
+    </script>
+</body>
+
+</html>

package/docs/examples/index.html

@@ -0,0 +1,93 @@
+<!-- SEO-friendly SPA Shim -->
+<script src="/lightview-router.js"></script>
+<script>
+    if (window.LightviewRouter) {
+        LightviewRouter.base('/index.html');
+    }
+</script>
+
+<div class="section">
+    <div class="section-content">
+        <h1>Examples</h1>
+        <p class="text-secondary" style="font-size: 1.125rem;">
+            Learn by example. Click any card to open it in the playground.
+        </p>
+
+        <div class="example-grid" style="margin-top: 2rem;">
+            <a href="/docs/playground" class="example-card"
+                onclick="localStorage.setItem('playground-example', 'counter')">
+                <div class="example-card-preview" style="background: linear-gradient(135deg, #e0e7ff, #c7d2fe);">
+                    <span style="font-size: 3rem;">🎯</span>
+                </div>
+                <div class="example-card-content">
+                    <h3 class="example-card-title">Counter</h3>
+                    <p class="example-card-description">The classic. Learn signals with increment/decrement buttons.</p>
+                </div>
+            </a>
+
+            <a href="/docs/playground" class="example-card"
+                onclick="localStorage.setItem('playground-example', 'todo')">
+                <div class="example-card-preview" style="background: linear-gradient(135deg, #d1fae5, #a7f3d0);">
+                    <span style="font-size: 3rem;">✅</span>
+                </div>
+                <div class="example-card-content">
+                    <h3 class="example-card-title">Todo List</h3>
+                    <p class="example-card-description">State management with arrays. Add, toggle, and delete tasks.</p>
+                </div>
+            </a>
+
+            <a href="/docs/playground" class="example-card"
+                onclick="localStorage.setItem('playground-example', 'form')">
+                <div class="example-card-preview" style="background: linear-gradient(135deg, #fef3c7, #fde68a);">
+                    <span style="font-size: 3rem;">📝</span>
+                </div>
+                <div class="example-card-content">
+                    <h3 class="example-card-title">Form Validation</h3>
+                    <p class="example-card-description">Computed values for real-time validation feedback.</p>
+                </div>
+            </a>
+
+            <a href="/docs/playground" class="example-card"
+                onclick="localStorage.setItem('playground-example', 'fetch')">
+                <div class="example-card-preview" style="background: linear-gradient(135deg, #dbeafe, #bfdbfe);">
+                    <span style="font-size: 3rem;">👥</span>
+                </div>
+                <div class="example-card-content">
+                    <h3 class="example-card-title">Fetch Data</h3>
+                    <p class="example-card-description">Async data loading with loading states and error handling.</p>
+                </div>
+            </a>
+
+            <a href="/docs/playground" class="example-card"
+                onclick="localStorage.setItem('playground-example', 'tabs')">
+                <div class="example-card-preview" style="background: linear-gradient(135deg, #f3e8ff, #e9d5ff);">
+                    <span style="font-size: 3rem;">📑</span>
+                </div>
+                <div class="example-card-content">
+                    <h3 class="example-card-title">Tabs</h3>
+                    <p class="example-card-description">Tab navigation pattern with reactive content switching.</p>
+                </div>
+            </a>
+
+            <a href="/docs/playground" class="example-card"
+                onclick="localStorage.setItem('playground-example', 'theme')">
+                <div class="example-card-preview" style="background: linear-gradient(135deg, #1e293b, #334155);">
+                    <span style="font-size: 3rem;">🌙</span>
+                </div>
+                <div class="example-card-content">
+                    <h3 class="example-card-title">Theme Toggle</h3>
+                    <p class="example-card-description">Dark/light mode with effects for side effects.</p>
+                </div>
+            </a>
+        </div>
+
+        <div
+            style="margin-top: 3rem; padding: 2rem; background: var(--site-bg-alt); border-radius: var(--site-radius-lg); text-align: center;">
+            <h3 style="margin: 0 0 0.5rem;">Want to experiment?</h3>
+            <p style="color: var(--site-text-secondary); margin: 0 0 1rem;">
+                Open the playground and write your own code.
+            </p>
+            <a href="/docs/playground" class="btn btn-primary">Open Playground</a>
+        </div>
+    </div>
+</div>