microui-wc 0.1.0 → 0.1.2

package/package.json

@@ -1,17 +1,29 @@
 {
     "name": "microui-wc",
-    "version": "0.1.0",
+    "version": "0.1.2",
     "type": "module",
-    "description": "AI-Optimized UI Framework - Web Components Edition",
-    "main": "dist/microui.js",
-    "module": "src/index.js",
+    "description": "AI-First Web Components Framework - 49 Material Design 3 components optimized for AI agents",
+    "main": "dist/microui.esm.js",
+    "module": "dist/microui.esm.js",
+    "types": "dist/microui.d.ts",
+    "files": [
+        "dist/",
+        "src/",
+        "docs/",
+        "AGENTS.md",
+        "README.md",
+        "CHANGELOG.md",
+        "LICENSE"
+    ],
     "exports": {
         ".": {
-            "import": "./src/index.js",
-            "require": "./dist/microui.cjs"
+            "import": "./dist/microui.esm.js",
+            "types": "./dist/microui.d.ts"
         },
-        "./components/*": "./src/components/*.js",
-        "./styles/*": "./src/styles/*"
+        "./css": "./dist/microui.css",
+        "./components/*": "./dist/components/*.js",
+        "./styles/*": "./dist/styles/*",
+        "./src/*": "./src/*"
     },
     "scripts": {
         "dev": "bun server.js",
@@ -25,11 +37,27 @@
         "build:app": "bun run scripts/build-app.js"
     },
     "keywords": [
-        "ui",
+        "ai-agents",
+        "ai-first",
         "web-components",
         "material-design-3",
-        "ai-optimized"
+        "ui-framework",
+        "light-dom",
+        "zero-dependencies",
+        "accessibility",
+        "wcag",
+        "custom-elements",
+        "md3",
+        "design-system"
     ],
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/GiuseppeScottoLavina/microUI.git"
+    },
+    "homepage": "https://giuseppescottolavina.github.io/microUI/",
+    "bugs": {
+        "url": "https://github.com/GiuseppeScottoLavina/microUI/issues"
+    },
     "author": "Giuseppe Scotto Lavina",
     "license": "Apache-2.0",
     "devDependencies": {

package/src/components/mu-schema-form.js

@@ -21,7 +21,7 @@
  *     };
  *     
  *     form.addEventListener('mu-submit', (e) => {
- *         console.log('Form data:', e.detail);
+ *         console.log('Form data:', e.detail); // debug
  *     });
  * </script>
  */

package/src/styles/components/switch.css

@@ -33,15 +33,15 @@
 }
 
 .mu-spinner--md .mu-spinner__circle {
-    width: 48px;
-    /* MD3: 48dp standard circular diameter */
-    height: 48px;
-    border-width: 4px;
+    width: 32px;
+    height: 32px;
+    border-width: 3px;
 }
 
 .mu-spinner--lg .mu-spinner__circle {
-    width: 40px;
-    height: 40px;
+    width: 48px;
+    /* MD3: 48dp standard circular diameter */
+    height: 48px;
     border-width: 4px;
 }
 
@@ -65,5 +65,4 @@
 
 .mu-spinner--white {
     color: white;
-}
-
+}

package/src/styles/components.css

@@ -1344,15 +1344,15 @@ mu-alert mu-icon:first-child {
 }
 
 .mu-spinner--md .mu-spinner__circle {
-    width: 48px;
-    /* MD3: 48dp standard circular diameter */
-    height: 48px;
-    border-width: 4px;
+    width: 32px;
+    height: 32px;
+    border-width: 3px;
 }
 
 .mu-spinner--lg .mu-spinner__circle {
-    width: 40px;
-    height: 40px;
+    width: 48px;
+    /* MD3: 48dp standard circular diameter */
+    height: 48px;
     border-width: 4px;
 }
 

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,40 +0,0 @@
----
-name: Bug Report
-about: Report a bug to help us improve
-title: '[BUG] '
-labels: bug
-assignees: ''
----
-
-## 🐛 Bug Description
-
-A clear and concise description of the bug.
-
-## 📋 Steps to Reproduce
-
-1. Go to '...'
-2. Click on '...'
-3. Scroll down to '...'
-4. See error
-
-## ✅ Expected Behavior
-
-What you expected to happen.
-
-## ❌ Actual Behavior
-
-What actually happened.
-
-## 🖥️ Environment
-
-- **Browser**: [e.g., Chrome 120, Safari 17]
-- **OS**: [e.g., macOS 14, Windows 11]
-- **microUI Version**: [e.g., 0.1.0]
-
-## 📸 Screenshots
-
-If applicable, add screenshots to help explain your problem.
-
-## 📝 Additional Context
-
-Add any other context about the problem here.

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,33 +0,0 @@
----
-name: Feature Request
-about: Suggest an idea for microUI
-title: '[FEATURE] '
-labels: enhancement
-assignees: ''
----
-
-## 🚀 Feature Description
-
-A clear and concise description of the feature you'd like.
-
-## 💡 Use Case
-
-Describe the problem this feature would solve.
-
-**Example:** "As a developer, I want [...] so that [...]"
-
-## 📝 Proposed Solution
-
-Describe how you envision this working.
-
-## 🔄 Alternatives Considered
-
-Any alternative solutions or features you've considered.
-
-## 📸 Examples
-
-Links to similar features in other libraries, mockups, or code examples.
-
-## ➕ Additional Context
-
-Add any other context about the feature request here.

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -1,28 +0,0 @@
-# Pull Request
-
-## 📝 Description
-
-Brief description of the changes.
-
-## 🔗 Related Issue
-
-Fixes #(issue number)
-
-## 🧪 Testing
-
-- [ ] Unit tests added/updated
-- [ ] E2E tests added/updated (if UI changes)
-- [ ] All tests passing (`bun run test:full`)
-
-## 📋 Checklist
-
-- [ ] My code follows the project's style guidelines
-- [ ] I have performed a self-review of my code
-- [ ] I have commented my code where necessary
-- [ ] I have updated the documentation (if needed)
-- [ ] My changes generate no new warnings
-- [ ] I have added tests that prove my fix/feature works
-
-## 📸 Screenshots (if applicable)
-
-Add screenshots for UI changes.

package/.github/workflows/ci.yml

@@ -1,42 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [ main, master ]
-  pull_request:
-    branches: [ main, master ]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    
-    steps:
-    - uses: actions/checkout@v4
-    
-    - name: Setup Bun
-      uses: oven-sh/setup-bun@v1
-      with:
-        bun-version: latest
-    
-    - name: Install dependencies
-      run: bun install
-    
-    - name: Run unit tests
-      run: bun run test:isolated
-    
-    - name: Build framework
-      run: bun run build:framework
-
-  lint:
-    runs-on: ubuntu-latest
-    
-    steps:
-    - uses: actions/checkout@v4
-    
-    - name: Check for console.log in components
-      run: |
-        if grep -r "console\.log" src/components/*.js --include="*.js" | grep -v "// debug"; then
-          echo "⚠️ Found console.log statements in components"
-          exit 1
-        fi
-        echo "✅ No stray console.log found"

package/.github/workflows/deploy-pages.yml

@@ -1,112 +0,0 @@
-name: Deploy Demo to GitHub Pages
-
-on:
-  push:
-    branches: [ main, master ]
-  workflow_dispatch:
-
-# Sets permissions of the GITHUB_TOKEN
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-
-# Allow only one concurrent deployment
-concurrency:
-  group: "pages"
-  cancel-in-progress: false
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v1
-        with:
-          bun-version: "1.3.6"
-
-      - name: Install dependencies
-        run: |
-          echo "=== Starting dependency installation ==="
-          bun install --verbose
-          echo "=== Installed packages ==="
-          ls -la node_modules/ | head -20
-          echo "=== Checking crossbus ==="
-          ls -la node_modules/crossbus/ || echo "crossbus not found!"
-
-      - name: Build framework
-        run: |
-          echo "=== Starting build ==="
-          bun run build:framework
-
-      - name: Prepare demo for static hosting
-        run: |
-          # Create _site with preserved structure
-          mkdir -p _site/demo
-          
-          # Copy demo files (preserving structure)
-          cp -r demo/* _site/demo/
-          
-          # Copy dist (framework bundles) - one level up from demo
-          cp -r dist _site/
-          
-          # Copy assets to root level (shell.html uses ../assets/)
-          cp -r assets _site/
-          
-          # Copy source for development imports
-          cp -r src _site/
-          
-          # Copy root files needed
-          cp package.json _site/
-          
-          # Create 404.html for SPA routing (redirect to shell.html)
-          cat > _site/404.html << 'EOF'
-          <!DOCTYPE html>
-          <html lang="en">
-          <head>
-            <meta charset="UTF-8">
-            <meta http-equiv="refresh" content="0;url=/microUI/demo/shell.html">
-            <title>Redirecting...</title>
-          </head>
-          <body>
-            <p>Redirecting to <a href="/microUI/demo/shell.html">microUI Demo</a>...</p>
-          </body>
-          </html>
-          EOF
-          
-          # Create index.html redirect at root
-          cat > _site/index.html << 'EOF'
-          <!DOCTYPE html>
-          <html lang="en">
-          <head>
-            <meta charset="UTF-8">
-            <meta http-equiv="refresh" content="0;url=demo/shell.html">
-            <title>microUI Demo</title>
-          </head>
-          <body>
-            <p>Redirecting to <a href="demo/shell.html">microUI Demo</a>...</p>
-          </body>
-          </html>
-          EOF
-
-      - name: Setup Pages
-        uses: actions/configure-pages@v4
-
-      - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
-        with:
-          path: '_site'
-
-  deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    needs: build
-    steps:
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4

package/CODE_OF_CONDUCT.md

@@ -1,59 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-We as members, contributors, and leaders pledge to make participation in our
-community a harassment-free experience for everyone, regardless of age, body
-size, visible or invisible disability, ethnicity, sex characteristics, gender
-identity and expression, level of experience, education, socio-economic status,
-nationality, personal appearance, race, religion, or sexual identity
-and orientation.
-
-We pledge to act and interact in ways that contribute to an open, welcoming,
-diverse, inclusive, and healthy community.
-
-## Our Standards
-
-Examples of behavior that contributes to a positive environment:
-
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
-
-Examples of unacceptable behavior:
-
-* The use of sexualized language or imagery, and sexual attention or advances
-* Trolling, insulting or derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information without explicit permission
-* Other conduct which could reasonably be considered inappropriate
-
-## Enforcement Responsibilities
-
-Community leaders are responsible for clarifying and enforcing our standards of
-acceptable behavior and will take appropriate and fair corrective action in
-response to any behavior that they deem inappropriate, threatening, offensive,
-or harmful.
-
-## Scope
-
-This Code of Conduct applies within all community spaces, and also applies when
-an individual is officially representing the community in public spaces.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported to the community leaders responsible for enforcement.
-
-All complaints will be reviewed and investigated promptly and fairly.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage],
-version 2.1, available at
-[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
-
-[homepage]: https://www.contributor-covenant.org
-[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html

package/CONTRIBUTING.md

@@ -1,156 +0,0 @@
-# Contributing to microUI
-
-First off, thank you for considering contributing to microUI! 🎉
-
-## 📋 Table of Contents
-
-- [Code of Conduct](#code-of-conduct)
-- [How Can I Contribute?](#how-can-i-contribute)
-- [Development Setup](#development-setup)
-- [Pull Request Process](#pull-request-process)
-- [Style Guide](#style-guide)
-
----
-
-## Code of Conduct
-
-This project follows the [Contributor Covenant Code of Conduct](./CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code.
-
----
-
-## How Can I Contribute?
-
-### 🐛 Reporting Bugs
-
-Before creating a bug report, please check existing issues to avoid duplicates.
-
-**Great bug reports include:**
-- A clear, descriptive title
-- Steps to reproduce the issue
-- Expected vs actual behavior
-- Browser/OS version
-- Code snippets or screenshots if applicable
-
-### 💡 Suggesting Features
-
-Feature requests are welcome! Please:
-- Check if the feature already exists or is planned
-- Describe the use case clearly
-- Explain why this would benefit other users
-
-### 🔧 Code Contributions
-
-1. Fork the repository
-2. Create a feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes (`git commit -m 'feat: add amazing feature'`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
-
----
-
-## Development Setup
-
-```bash
-# Clone your fork
-git clone https://github.com/YOUR_USERNAME/microUI.git
-cd microUI
-
-# Install dependencies (Bun recommended)
-bun install
-
-# Start development server
-bun run dev
-
-# Run tests
-bun run test:full
-
-# Build the framework
-bun run build:framework
-```
-
-### Project Structure
-
-```
-microUI/
-├── src/                # Framework source code
-│   ├── components/     # Web Components (49 total)
-│   ├── core/           # Core utilities (MuElement, CrossBus)
-│   └── styles/         # CSS and design tokens
-├── tests/              # Test suites
-│   ├── components/     # Unit tests
-│   └── e2e/            # End-to-end tests (Puppeteer)
-├── demo/               # Demo application
-├── docs/               # Documentation
-└── dist/               # Build output
-```
-
----
-
-## Pull Request Process
-
-1. **Tests Required**: All PRs must include tests. Run `bun run test:full` before submitting.
-
-2. **Documentation**: Update relevant documentation if you're changing APIs or adding features.
-
-3. **Commit Messages**: Follow [Conventional Commits](https://www.conventionalcommits.org/):
-   - `feat:` New feature
-   - `fix:` Bug fix
-   - `docs:` Documentation only
-   - `style:` Formatting, no code change
-   - `refactor:` Code change that neither fixes a bug nor adds a feature
-   - `test:` Adding tests
-   - `chore:` Maintenance tasks
-
-4. **One PR, One Feature**: Keep PRs focused. Split large changes into smaller PRs.
-
-5. **Review Process**: PRs require review before merging. Be patient and responsive to feedback.
-
----
-
-## Style Guide
-
-### JavaScript
-
-- ES Modules (`import`/`export`)
-- No TypeScript (vanilla JS with JSDoc comments)
-- Use `escapeHTML()` for any dynamic content in templates
-- Prefer `this.listen()` over `addEventListener` in components
-
-### CSS
-
-- CSS Custom Properties for theming
-- BEM-like naming: `.mu-component__element--modifier`
-- Mobile-first responsive design
-
-### Components
-
-- Extend `MuElement` base class
-- Use Light DOM (no Shadow DOM)
-- Export via `define()` for registration
-- Include accessibility attributes (ARIA)
-
-### Example Component
-
-```javascript
-import { MuElement, define } from '../core/mu-element.js';
-import { escapeHTML } from '../core/utils.js';
-
-export class MuExample extends MuElement {
-    static observedAttributes = ['label'];
-    
-    render() {
-        const label = escapeHTML(this.attr('label', ''));
-        this.innerHTML = `<div class="mu-example">${label}</div>`;
-    }
-}
-
-export const define = () => customElements.define('mu-example', MuExample);
-```
-
----
-
-## Questions?
-
-Feel free to open an issue with the `question` label or reach out directly.
-
-Thank you for helping make microUI better! 🚀

package/SECURITY.md

@@ -1,58 +0,0 @@
-# Security Policy
-
-## Supported Versions
-
-| Version | Supported          |
-| ------- | ------------------ |
-| 0.1.x   | ✅ Actively maintained |
-
-## Security Features
-
-microUI is designed with security in mind:
-
-### Content Security Policy (CSP)
-
-Demo pages include strict CSP headers:
-
-```html
-<meta http-equiv="Content-Security-Policy"
-    content="default-src 'self'; 
-             script-src 'self' 'unsafe-inline'; 
-             style-src 'self' 'unsafe-inline' https://fonts.googleapis.com; 
-             font-src 'self' https://fonts.gstatic.com; 
-             img-src 'self' data:; 
-             connect-src 'self';
-             frame-ancestors 'none';">
-```
-
-**Features**:
-- `frame-ancestors 'none'` - Prevents clickjacking
-- `connect-src 'self'` - Prevents data exfiltration
-- No `'unsafe-eval'` - Blocks dynamic code execution
-
-### Zero Dependencies
-
-The production bundle has **zero runtime dependencies**, eliminating supply chain risks.
-
-### Safe Code Patterns
-
-- ✅ No `eval()` or `Function()` calls
-- ✅ No `document.write` or `insertAdjacentHTML`
-- ✅ No prototype pollution patterns (`__proto__`)
-- ✅ innerHTML uses static templates only (no user input)
-- ✅ No hardcoded secrets or credentials
-
-## Reporting a Vulnerability
-
-Please report security vulnerabilities by opening an issue with the `security` label, or contact the maintainer directly.
-
-**Response Time**: We aim to respond within 48 hours.
-
-## Security Audit
-
-Last audit: **2026-02-02** (v0.1.0)
-
-- Full codebase review completed
-- CVE research for all technologies
-- XSS vulnerabilities identified and **fully remediated**
-- Centralized `escapeHTML()` utility applied to all dynamic content

package/app/.generated/routes/alerts.js

@@ -1,8 +0,0 @@
-/**
- * Auto-generated route for: alerts
- * Dependencies: mu-alert, mu-stack, mu-example, mu-code
- */
-import '../../../dist/components/mu-alert.js';
-import '../../../dist/components/mu-stack.js';
-import '../../../dist/components/mu-example.js';
-import '../../../dist/components/mu-code.js';

package/app/.generated/routes/avatars.js

@@ -1,8 +0,0 @@
-/**
- * Auto-generated route for: avatars
- * Dependencies: mu-avatar, mu-stack, mu-example, mu-code
- */
-import '../../../dist/components/mu-avatar.js';
-import '../../../dist/components/mu-stack.js';
-import '../../../dist/components/mu-example.js';
-import '../../../dist/components/mu-code.js';

package/app/.generated/routes/badges.js

@@ -1,8 +0,0 @@
-/**
- * Auto-generated route for: badges
- * Dependencies: mu-badge, mu-stack, mu-example, mu-code
- */
-import '../../../dist/components/mu-badge.js';
-import '../../../dist/components/mu-stack.js';
-import '../../../dist/components/mu-example.js';
-import '../../../dist/components/mu-code.js';