lightview 1.8.2 → 2.0.0

package/.agent/workflows/daisyui-component-migration.md

@@ -0,0 +1,155 @@
+---
+description: Migrate all components to DaisyUI styling pattern with examplify docs
+---
+
+# DaisyUI Component Migration Plan
+
+## Overview
+Migrate all Lightview components to use DaisyUI styling (like the reference `input.js` pattern):
+- Use DaisyUI classes directly (no BEM `.lv-*` classes)
+- Remove parallel `.css` files where possible
+- Use custom CSS only for advanced features not in DaisyUI
+- All components support Shadow DOM (global setting with local override)
+- Remove `getIcon()` usage - use inline SVGs or children
+- Update all `.html` docs to use `examplify()` with basic + reactive examples
+- Match DaisyUI directory structure (delete `components/core/`)
+
+## Reference Pattern (from input.js)
+```javascript
+// Key patterns:
+// 1. No CSS import - uses DaisyUI classes directly
+// 2. Uses fieldset/legend pattern for form fields
+// 3. Signal-based reactive state
+// 4. Controlled/uncontrolled modes
+// 5. Validation support
+// 6. Shadow DOM support with useShadow prop
+// 7. Auto-register with LightviewX
+```
+
+## Component Status Tracker
+
+### Batch 1: Form Inputs ✅ COMPLETE
+- [x] 1. Input (data-input/input.js) - DONE
+- [x] 2. Textarea (data-input/textarea.js) - DONE
+- [x] 3. Select (data-input/select.js) - DONE
+- [x] 4. Checkbox (data-input/checkbox.js) - DONE
+- [x] 5. Radio (data-input/radio.js) - DONE (also added RadioGroup)
+- [x] 6. Toggle (data-input/toggle.js) - DONE
+- [x] 7. Range (data-input/range.js) - DONE
+- [x] 8. Rating (data-input/rating.js) - DONE
+- [x] 9. File Input (data-input/file-input.js) - DONE
+
+### Batch 2: Actions & Feedback ✅ COMPLETE
+- [x] 10. Button (actions/button.js) - DONE (docs updated with examplify)
+- [x] 11. Modal (actions/modal.js) - DONE (docs updated with examplify)
+- [x] 12. Drawer (layout/drawer.js) - DONE (docs updated with examplify)
+- [x] 13. Dropdown (actions/dropdown.js) - DONE (docs updated with examplify)
+- [x] 14. Swap (actions/swap.js) - DONE (docs updated with examplify)
+- [x] 15. Alert (data-display/alert.js) - DONE (docs updated with examplify)
+- [x] 16. Toast (data-display/toast.js) - DONE (docs updated with examplify)
+- [x] 17. Loading (data-display/loading.js) - DONE (docs updated with examplify)
+- [x] 18. Progress (data-display/progress.js) - DONE (docs updated with examplify)
+- [x] 19. Tooltip (data-display/tooltip.js) - DONE (docs updated with examplify)
+
+### Batch 3: Data Display ✅ COMPLETE
+- [x] 20. Badge (data-display/badge.js) - DONE (docs updated with examplify)
+- [x] 21. Card (data-display/card.js) - DONE (docs updated with examplify)
+- [x] 22. Avatar (data-display/avatar.js) - DONE (docs updated with examplify)
+- [x] 23. Table (data-display/table.js) - DONE (docs updated with examplify)
+- [x] 24. Accordion (data-display/accordion.js) - DONE (docs updated with examplify)
+- [x] 25. Collapse (data-display/collapse.js) - DONE (docs updated with examplify)
+- [x] 26. Carousel (data-display/carousel.js) - DONE (docs updated with examplify)
+- [x] 27. Chat (data-display/chat.js) - DONE (docs updated with examplify)
+- [x] 28. Countdown (data-display/countdown.js) - DONE (docs updated with examplify)
+- [x] 29. Diff (data-display/diff.js) - DONE (docs updated with examplify)
+- [x] 30. Kbd (data-display/kbd.js) - DONE (docs updated with examplify)
+- [x] 31. Stats (data-display/stats.js) - DONE (docs updated with examplify)
+- [x] 32. Timeline (data-display/timeline.js) - DONE (docs updated with examplify)
+- [x] 33. Skeleton (data-display/skeleton.js) - DONE (docs updated with examplify)
+
+### Batch 4: Navigation & Layout ✅ COMPLETE
+- [x] 34. Tabs (navigation/tabs.js) - DONE (docs updated with examplify)
+- [x] 35. Menu (navigation/menu.js) - DONE (docs updated with examplify)
+- [x] 36. Breadcrumbs (navigation/breadcrumbs.js) - DONE (docs updated with examplify)
+- [x] 37. Pagination (navigation/pagination.js) - DONE (docs updated with examplify)
+- [x] 38. Steps (navigation/steps.js) - DONE (docs updated with examplify)
+- [x] 39. Dock (navigation/dock.js) - DONE (docs updated with examplify)
+- [x] 40. Navbar (layout/navbar.js) - DONE (docs updated with examplify)
+- [x] 41. Footer (layout/footer.js) - DONE (docs updated with examplify)
+- [x] 42. Hero (layout/hero.js) - DONE (docs updated with examplify)
+- [x] 43. Divider (layout/divider.js) - DONE (docs updated with examplify)
+- [x] 44. Indicator (layout/indicator.js) - DONE (docs updated with examplify)
+- [x] 45. Join (layout/join.js) - DONE (docs updated with examplify)
+
+### Batch 5: Specialized ✅ COMPLETE
+- [x] 46. Theme Controller (actions/theme-controller.js) - DONE (docs updated with examplify)
+- [x] 47. Chart (data-display/chart.js) - DONE (docs updated with examplify)
+- [x] 48. Radial Progress (data-display/radial-progress.js) - DONE (docs updated with examplify)
+
+### Batch 6: Shadow DOM Support
+Add `useShadow` prop and Shadow DOM rendering to all components following the `input.js` pattern:
+- Check `LightviewX.shouldUseShadow(useShadow)` to determine if shadow DOM should be used
+- Get adopted stylesheets via `LightviewX.getAdoptedStyleSheets()`
+- Get current theme from `document.documentElement.getAttribute('data-theme')`
+- Wrap component in `shadowDOM({ mode: 'open', adoptedStyleSheets }, div({ 'data-theme': currentTheme }, componentEl))`
+
+Components to update:
+- [x] Button (actions/button.js) - DONE
+- [x] Dropdown (actions/dropdown.js)
+- [x] Modal (actions/modal.js)
+- [x] Swap (actions/swap.js)
+- [x] Alert (data-display/alert.js)
+- [x] Toast (data-display/toast.js)
+- [x] Loading (data-display/loading.js)
+- [x] Progress (data-display/progress.js)
+- [x] Drawer (layout/drawer.js)
+- [x] Tooltip (data-display/tooltip.js)
+- [x] Badge (data-display/badge.js)
+- [x] Card (data-display/card.js)
+- [x] Avatar (data-display/avatar.js)
+- [x] Table (data-display/table.js)
+- [x] Accordion (data-display/accordion.js)
+- [x] Collapse (data-display/collapse.js)
+- [x] Carousel (data-display/carousel.js)
+- [x] Chat (data-display/chat.js)
+- [x] Countdown (data-display/countdown.js)
+- [x] Diff (data-display/diff.js)
+- [x] Kbd (data-display/kbd.js)
+- [x] Stats (data-display/stats.js)
+- [x] Timeline (data-display/timeline.js)
+- [x] Skeleton (data-display/skeleton.js)
+- [x] Tabs (navigation/tabs.js)
+- [x] Menu (navigation/menu.js)
+- [x] Breadcrumbs (navigation/breadcrumbs.js)
+- [x] Pagination (navigation/pagination.js)
+- [x] Steps (navigation/steps.js)
+- [x] Dock (navigation/dock.js)
+- [x] Navbar (layout/navbar.js)
+- [x] Footer (layout/footer.js)
+- [x] Hero (layout/hero.js)
+- [x] Divider (layout/divider.js)
+- [x] Indicator (layout/indicator.js)
+- [x] Join (layout/join.js)
+- [x] Theme Controller (actions/theme-controller.js)
+- [x] Chart (data-display/chart.js)
+- [x] Radial Progress (data-display/radial-progress.js)
+
+
+## Cleanup Tasks
+- [x] Delete components/core/ directory
+- [x] Delete components/display/ directory (after consolidation)
+- [x] Delete components/feedback/ directory (after consolidation)
+- [x] Delete unused .css files
+- [x] Delete components/utils/icons.js
+- [x] Update components/index.js exports
+
+## Per-Component Checklist
+For each component:
+1. [ ] Refactor .js to use DaisyUI classes
+2. [ ] Add Shadow DOM support (useShadow prop)
+3. [ ] Add validation/error support where applicable
+4. [ ] Add controlled/uncontrolled state support
+5. [ ] Remove getIcon() usage
+6. [ ] Update .html docs with examplify (basic + reactive examples)
+7. [ ] Delete old .css file if no longer needed
+8. [ ] Test in browser

package/.codacy/cli.sh

@@ -0,0 +1,149 @@
+#!/usr/bin/env bash
+
+
+set -e +o pipefail
+
+# Set up paths first
+bin_name="codacy-cli-v2"
+
+# Determine OS-specific paths
+os_name=$(uname)
+arch=$(uname -m)
+
+case "$arch" in
+"x86_64")
+  arch="amd64"
+  ;;
+"x86")
+  arch="386"
+  ;;
+"aarch64"|"arm64")
+  arch="arm64"
+  ;;
+esac
+
+if [ -z "$CODACY_CLI_V2_TMP_FOLDER" ]; then
+    if [ "$(uname)" = "Linux" ]; then
+        CODACY_CLI_V2_TMP_FOLDER="$HOME/.cache/codacy/codacy-cli-v2"
+    elif [ "$(uname)" = "Darwin" ]; then
+        CODACY_CLI_V2_TMP_FOLDER="$HOME/Library/Caches/Codacy/codacy-cli-v2"
+    else
+        CODACY_CLI_V2_TMP_FOLDER=".codacy-cli-v2"
+    fi
+fi
+
+version_file="$CODACY_CLI_V2_TMP_FOLDER/version.yaml"
+
+
+get_version_from_yaml() {
+    if [ -f "$version_file" ]; then
+        local version=$(grep -o 'version: *"[^"]*"' "$version_file" | cut -d'"' -f2)
+        if [ -n "$version" ]; then
+            echo "$version"
+            return 0
+        fi
+    fi
+    return 1
+}
+
+get_latest_version() {
+    local response
+    if [ -n "$GH_TOKEN" ]; then
+        response=$(curl -Lq --header "Authorization: Bearer $GH_TOKEN" "https://api.github.com/repos/codacy/codacy-cli-v2/releases/latest" 2>/dev/null)
+    else
+        response=$(curl -Lq "https://api.github.com/repos/codacy/codacy-cli-v2/releases/latest" 2>/dev/null)
+    fi
+
+    handle_rate_limit "$response"
+    local version=$(echo "$response" | grep -m 1 tag_name | cut -d'"' -f4)
+    echo "$version"
+}
+
+handle_rate_limit() {
+    local response="$1"
+    if echo "$response" | grep -q "API rate limit exceeded"; then
+          fatal "Error: GitHub API rate limit exceeded. Please try again later"
+    fi
+}
+
+download_file() {
+    local url="$1"
+
+    echo "Downloading from URL: ${url}"
+    if command -v curl > /dev/null 2>&1; then
+        curl -# -LS "$url" -O
+    elif command -v wget > /dev/null 2>&1; then
+        wget "$url"
+    else
+        fatal "Error: Could not find curl or wget, please install one."
+    fi
+}
+
+download() {
+    local url="$1"
+    local output_folder="$2"
+
+    ( cd "$output_folder" && download_file "$url" )
+}
+
+download_cli() {
+    # OS name lower case
+    suffix=$(echo "$os_name" | tr '[:upper:]' '[:lower:]')
+
+    local bin_folder="$1"
+    local bin_path="$2"
+    local version="$3"
+
+    if [ ! -f "$bin_path" ]; then
+        echo "📥 Downloading CLI version $version..."
+
+        remote_file="codacy-cli-v2_${version}_${suffix}_${arch}.tar.gz"
+        url="https://github.com/codacy/codacy-cli-v2/releases/download/${version}/${remote_file}"
+
+        download "$url" "$bin_folder"
+        tar xzfv "${bin_folder}/${remote_file}" -C "${bin_folder}"
+    fi
+}
+
+# Warn if CODACY_CLI_V2_VERSION is set and update is requested
+if [ -n "$CODACY_CLI_V2_VERSION" ] && [ "$1" = "update" ]; then
+    echo "⚠️  Warning: Performing update with forced version $CODACY_CLI_V2_VERSION"
+    echo "    Unset CODACY_CLI_V2_VERSION to use the latest version"
+fi
+
+# Ensure version.yaml exists and is up to date
+if [ ! -f "$version_file" ] || [ "$1" = "update" ]; then
+    echo "ℹ️  Fetching latest version..."
+    version=$(get_latest_version)
+    mkdir -p "$CODACY_CLI_V2_TMP_FOLDER"
+    echo "version: \"$version\"" > "$version_file"
+fi
+
+# Set the version to use
+if [ -n "$CODACY_CLI_V2_VERSION" ]; then
+    version="$CODACY_CLI_V2_VERSION"
+else
+    version=$(get_version_from_yaml)
+fi
+
+
+# Set up version-specific paths
+bin_folder="${CODACY_CLI_V2_TMP_FOLDER}/${version}"
+
+mkdir -p "$bin_folder"
+bin_path="$bin_folder"/"$bin_name"
+
+# Download the tool if not already installed
+download_cli "$bin_folder" "$bin_path" "$version"
+chmod +x "$bin_path"
+
+run_command="$bin_path"
+if [ -z "$run_command" ]; then
+    fatal "Codacy cli v2 binary could not be found."
+fi
+
+if [ "$#" -eq 1 ] && [ "$1" = "download" ]; then
+    echo "Codacy cli v2 download succeeded"
+else
+    eval "$run_command $*"
+fi

package/.codacy/codacy.yaml

@@ -0,0 +1,15 @@
+runtimes:
+    - dart@3.7.2
+    - go@1.22.3
+    - java@17.0.10
+    - node@22.2.0
+    - python@3.11.11
+tools:
+    - dartanalyzer@3.7.2
+    - eslint@8.57.0
+    - lizard@1.17.31
+    - pmd@7.11.0
+    - pylint@3.3.6
+    - revive@1.7.0
+    - semgrep@1.78.0
+    - trivy@0.66.0

package/.github/instructions/codacy.instructions.md

@@ -0,0 +1,72 @@
+---
+    description: Configuration for AI behavior when interacting with Codacy's MCP Server
+    applyTo: '**'
+---
+---
+# Codacy Rules
+Configuration for AI behavior when interacting with Codacy's MCP Server
+
+## CRITICAL: After ANY successful `edit_file` or `reapply` operation
+- YOU MUST IMMEDIATELY run the `codacy_cli_analyze` tool from Codacy's MCP Server for each file that was edited, with:
+ - `rootPath`: set to the workspace path
+ - `file`: set to the path of the edited file
+ - `tool`: leave empty or unset
+- If any issues are found in the new edits, propose and apply fixes for them.
+- > NOTE: Failure to follow this rule is considered a critical error.
+
+## When you tried to run the `codacy_cli_analyze` tool and the Codacy CLI is not installed
+- Ask the user 'Codacy CLI is not installed. Would you like me to install it now?'
+- If the user responds with "yes", run the `codacy_cli_install` tool and then continue with the original task
+- If the user responds with "no", instruct the user that they can disable automatic analysis in the extension settings
+- Wait for the user to respond before proceeding with any other actions
+
+## After every response
+- If you made any file edits in this conversation, verify you ran `codacy_cli_analyze` tool from Codacy's MCP Server 
+
+## When there are no Codacy MCP Server tools available, or the MCP Server is not reachable
+- Suggest the user the following troubleshooting steps:
+ - Try to reset the MCP on the extension
+ - If the user is using VSCode, suggest them to review their Copilot > MCP settings in Github, under their organization or personal account. Refer them to Settings > Copilot > Enable MCP servers in Copilot. Suggested URL (https://github.com/settings/copilot/features) or https://github.com/organizations/{organization-name}/settings/copilot/features (This can only be done by their organization admins / owners)
+- If none of the above steps work, suggest the user to contact Codacy support
+
+## Trying to call a tool that needs a rootPath as a parameter
+- Always use the standard, non-URL-encoded file system path
+
+## CRITICAL: Dependencies and Security Checks
+- IMMEDIATELY after ANY of these actions:
+ - Running npm/yarn/pnpm install
+ - Adding dependencies to package.json
+ - Adding requirements to requirements.txt
+ - Adding dependencies to pom.xml
+ - Adding dependencies to build.gradle
+ - Any other package manager operations
+- You MUST run the `codacy_cli_analyze` tool with:
+ - `rootPath`: set to the workspace path
+ - `tool`: set to "trivy"
+ - `file`: leave empty or unset
+- If any vulnerabilities are found because of the newly added packages:
+ - Stop all other operations
+ - Propose and apply fixes for the security issues
+ - Only continue with the original task after security issues are resolved
+- EXAMPLE:
+ - After: npm install react-markdown
+ - Do: Run codacy_cli_analyze with trivy
+ - Before: Continuing with any other tasks
+
+## General
+- Repeat the relevant steps for each modified file.
+- "Propose fixes" means to both suggest and, if possible, automatically apply the fixes.
+- You MUST NOT wait for the user to ask for analysis or remind you to run the tool.
+- Do not run `codacy_cli_analyze` looking for changes in duplicated code or code complexity metrics.
+- Complexity metrics are different from complexity issues. When trying to fix complexity in a repository or file, focus on solving the complexity issues and ignore the complexity metric.
+- Do not run `codacy_cli_analyze` looking for changes in code coverage.
+- Do not try to manually install Codacy CLI using either brew, npm, npx, or any other package manager.
+- If the Codacy CLI is not installed, just run the `codacy_cli_analyze` tool from Codacy's MCP Server.
+- When calling `codacy_cli_analyze`, only send provider, organization and repository if the project is a git repository.
+
+## Whenever a call to a Codacy tool that uses `repository` or `organization` as a parameter returns a 404 error
+- Offer to run the `codacy_setup_repository` tool to add the repository to Codacy
+- If the user accepts, run the `codacy_setup_repository` tool
+- Do not ever try to run the `codacy_setup_repository` tool on your own
+- After setup, immediately retry the action that failed (only retry once)
+---

package/.wranglerignore

@@ -0,0 +1,21 @@
+# Exclude node_modules and dependencies
+node_modules/
+
+# Exclude version control
+.git/
+.github/
+
+# Exclude documentation (if you don't need it deployed)
+# Remove the line below if you want to deploy your docs
+# *.md
+
+# Exclude package files
+package.json
+package-lock.json
+
+# Exclude configuration files
+wrangler.toml
+
+# Exclude log files
+*.log
+.wrangler/