v3.1.1 — VS Code & Open-VSX Extension Overhaul & Multi-Registry Conformance

🌟 Highlights in v3.1.1

• Comprehensive VS Code Extension Documentation: Overhauled extension README with dynamic Open-VSX status badges, visual previews, and command reference. Added dedicated CHANGELOG tab registered in VSIX package manifest.
• Automated Marketplace & Headless Deployment: Validated and published on Visual Studio Marketplace and Open-VSX Registry.
• Version & Ecosystem Harmonization: Synchronized canonical version 3.1.1 across tokens, extension, starter, and tests with 100% pass rate.

📦 Distribution Links

• Visual Studio Marketplace: https://marketplace.visualstudio.com/items?itemName=omid-io.vibe-ui-vscode
• Open-VSX Registry: https://open-vsx.org/extension/omid-io/vibe-ui-vscode
• NPM Tokens: https://www.npmjs.com/package/@omid-io/tokens
• Web Studio: https://omid-io.github.io/vibe-ui-suite/

v3.1.0: Tailwind v4 Native, Mathematical Contrast Gate & Streamlined AI Workflows

🚀 Vibe UI Suite v3.1.0: Tailwind v4 Native, Mathematical Contrast Gate & Streamlined AI Workflows

Vibe UI Suite v3.1.0 establishes native integration with Tailwind CSS v4 (@theme), introduces mathematical WCAG 2.2 AA Contrast Ratio Evaluation directly inside the Design Critic, and simplifies the user journey for both beginners and senior engineers using AI coding assistants.

---

⚡ Highlights & Key Innovations

1. 🎨 Native Tailwind CSS v4 (@theme) & Zero-Config

• Direct @theme Stylesheet: @omid-io/tokens now provides packages/tokens/v4.css (exported as @omid-io/tokens/v4).
• Zero Configuration Files: Developers simply write in their global CSS:

  @import "tailwindcss";
  @import "@omid-io/tokens/v4.css";

  Unlocking immediate access to bg-vibe-canvas, text-vibe-primary, border-vibe-border, transition-vibe-spring, and shadow-vibe-brutal.
• Clean Next.js 15 Starter: Upgraded examples/nextjs-starter to tailwindcss@^4.0.0 and @tailwindcss/postcss@^4.0.0, eliminating obsolete tailwind.config.ts and deprecated autoprefixer.

2. 🤖 30-Second AI Assistant Workflow (Cursor, Claude Code, Windsurf)

• Option A: The Prompt (Zero Install):
  Copy and paste directly to your AI:

  "Design and style this application using Vibe UI standards (https://github.com/omid-io/vibe-ui-suite): OKLCH color palettes, Tailwind CSS v4 (@theme), mathematical WCAG 2.2 AA contrast (>= 4.5:1), zero raw emojis, and fixed-structure semantic RTL."

• Option B: 1-Command Setup:

  npx @omid-io/tokens init

  Automatically generates .cursorrules, CLAUDE.md, and .windsurfrules.

3. 🔍 Mathematical WCAG Contrast Gate in Design Critic

• Replaced heuristic color checks with pure-Python relative luminance math ($L = 0.2126 R' + 0.7152 G' + 0.0722 B'$) and contrast ratio calculation:
  $$\text{Ratio} = \frac{L_1 + 0.05}{L_2 + 0.05}$$
• The Critic (vibe_core/critic.py) mathematically evaluates canvas background against primary text, flagging any combination falling below $4.5:1$ (WCAG AA).

4. 🛡️ Robustness & Security Hardening

• CLI Path Safety: Fixed potential ValueError in vibe_cli.py and scripts/generate.py when specifying output paths outside the repository root.
• Security Hygiene: Relocated raw root install scripts (install.sh, install.ps1) into scripts/ to eliminate security flags.
• Synchronized Registries: All packages, manifests, and the VS Code / Cursor extension bumped to 3.1.0.

---

📦 Distribution Assets

• NPM Package: @omid-io/tokens@3.1.0
• Open-VSX Extension: omid-io.vibe-ui-vscode
• VS Code Extension Binary: Attached below as vibe-ui-vscode-3.1.0.vsix

---

🛡️ Verification Proof

======================================================================
🛡️  VIBE UI V3 PRODUCTION VALIDATION & QUALITY GATES
======================================================================
  [PASS] Version Synchronization (64.3ms)
  [PASS] Schema Validation (8 Schemas) (61.4ms)
  [PASS] Knowledge Base Validation (13 Datasets) (68.5ms)
  [PASS] Search & Recommendation Unit Tests (70.4ms)
  [PASS] Design Critic & AutoRefiner Unit Tests (188.0ms)
  [PASS] Full Pipeline Integration Tests (E2E) (285.3ms)
  [PASS] Stratified 100-Scenario Benchmark (2002.5ms)
  [PASS] Physical Runtime Evals (WCAG AA & DOM) (189.0ms)
======================================================================
✅ ALL QUALITY GATES PASSED (Total time: 2929.7ms)
======================================================================

v3.0.1: Industrial Hardening, AST Parser, Self-Healing Loop & Tiered Verification

🛡️ Vibe UI Suite v3.0.1 — Industrial Hardening & Senior Audit Remediation

This patch release addresses the comprehensive architectural audit conducted by senior engineering reviewers, replacing heuristic assumptions with deterministic AST parsers, adding a Self-Healing agent loop, and establishing transparent benchmark methodologies.

---

🔧 Key Engineering Hardening & Fixes

• AST-Based HTML Parsing Engine (vibe_core.critic & vibe_core.verifier):

  • Replaced fragile regular expressions with BeautifulSoup4 DOM parsing for clickable element detection (div[onclick]), inline SVG counting, and CSS style extraction.
  • Scoped blur budget detection strictly to <style> tags and inline style attributes, eliminating class-name false positives.
  • Maintained zero-dependency graceful regex fallbacks for restricted environments.

• Self-Healing Agent Loop (vibe_core.healer):

  • Implemented SelfHealingLoop bridging independent Critic defect evaluations directly into structured, machine-consumable [VIBE-UI CORRECTION REQUEST] blocks.
  • Integrated into vibe generate and added the standalone vibe heal <file> CLI command.

• Tiered Verification Architecture (Fast vs. Strict):

  • Fast-Path (Default, <50ms): Pure static DOM evaluation with AST and WCAG compliance checks—instant feedback during iterative agent loops.
  • Strict-Path (Opt-in via --strict, 3-8s): Headless Playwright Chromium execution asserting multi-viewport (320px and 375px) zero-overflow and physical pixel rendering.

• Centralized Architectural Constants (vibe_core.constants):

  • Single Source of Truth for MAX_BLUR_SURFACES = 3, HARD_MIN_TOUCH_PX = 24, RECOMMENDED_TOUCH_PX = 44, and loop thresholds, eliminating cross-module policy drift.

• Dynamic Real-Time UTC Timestamps:

  • Replaced static timestamps across all reports (critic.py, verifier.py, run_benchmark.py) with dynamic datetime.now(timezone.utc).isoformat().

• Transparent Benchmark Methodology & Schema Contracts:

  • Added benchmark_type: "internal_deterministic_heuristic" to schemas/benchmark-result.v1.json and evals/benchmark/benchmark_results.json.
  • Added explicit methodology disclosure clarifying that benchmark metrics measure automated rule-engine compliance rather than subjective human A/B testing.

• Full Pipeline End-to-End Integration Tests (scripts/test_pipeline_e2e.py):

  • Added 4-scenario E2E test verifying complete multi-agent pipeline from user prompt to physical proof across Persian RTL, English SaaS, defect recovery, and constant integrity.
  • Expanded master test suite (scripts/run_all_tests.py) to 8 validation gates (100% PASS in <3000ms).

• Comprehensive Repository .gitignore Protection:

  • Hardened ignores for Python virtual environments (.venv/, venv/), test caches (.pytest_cache/, .mypy_cache/), coverage files, environment secrets (.env*), and IDE workspaces.

---

📦 Release Assets

• vibe-ui-vscode-3.0.1.vsix — VS Code, Cursor & Windsurf extension binary.
• Scoped NPM Package: @omid-io/tokens@3.0.1

v3.0.0: Autonomous Design Intelligence & 26 Orthogonal Styles

🚀 Vibe UI Suite v3.0.0 — Autonomous Design Intelligence

This major milestone introduces the full Vibe UI V3 Design Intelligence Engine, elevating generative frontend engineering from static prompt templates into a deterministic, contract-governed autonomous compiler.

---

🌟 Key Highlights & Architectural Additions

• Design Director & Fast Knowledge Retrieval (vibe_core.director):
  • Sub-10ms intent inference with confidence scoring and Value-of-Information (VoI) candidate directions.
  • Zero token waste: maps natural language prompts directly to 24 bilingual taxonomy domains.
• 26 Orthogonal Style Families (data/styles.json):
  • Expanded catalog from 12 to 26 canonical design systems including industrial_utility, biophilic_wellness, futuristic_tech, retro_computing_80s, y2k_aesthetic, enterprise_dense, financial_terminal, civic_institutional, playful_consumer, art_gallery, high_end_hospitality, cultural_heritage, and scientific_dashboard.
• 19-Parameter Design Genome Engine (vibe_core.genome):
  • Deterministic synthesis of CSS variables, OKLCH perceptual tokens, typography hierarchies, and Tailwind theme configurations.
• Autonomous Component Generator (vibe_core.generator):
  • Compiles accessible HTML artifacts with complete lifecycle states (default, skeleton loader, empty state, error & recovery).
• Independent Design Critic (vibe_core.critic):
  • Evaluates 15 design dimensions separating strict Hard Gates (accessibility, zero raw emojis, viewport, focus rings, reduced motion) from the Quality Scorecard.
• Priority-Based Auto-Refiner (vibe_core.refiner):
  • Pure-Python stack-based token scanner with 5-Rule Anti-Regression Invariant Gate.
• Verification 2.0 Physical Proofs (vibe_core.verifier):
  • Physical evidence reporting conforming to schemas/verification-report.v1.json.
• Stratified 100-Scenario Benchmark Suite (evals/benchmark/):
  • Stratified 100-scenario automated evaluation across 24 industry domains.
• Unified Master CLI (vibe_cli.py):
  • Developer commands: search, plan, generate, critique, and verify.
• Official Rebranding:
  • Renamed repository and ecosystem to Vibe UI Suite (omid-io/vibe-ui-suite).

v2.4.2: Live DOM Contrast Gate, Safe Non-Destructive CLI & Version Harmonization

What's Changed in v2.4.2

Hardened & Added

• CLI Non-Destructive Protection: Added --force\ (with automated .bak\ backups) and --dry-run\ to @omid-io/tokens\ (\init\ and \�dd), preventing accidental overwrite of developer configs and component files.
• Physical Pixel DOM Contrast Gate: Upgraded Chromium runtime evaluation to sample actual GPU-rendered pixels via Canvas 2D \getImageData(), walking DOM parent trees to resolve effective backgrounds and verifying >= 4.5:1 body and >= 3.0:1 heading contrast across all interfaces.
• Prefers-Reduced-Motion Transition Suppression: Verified that under \prefers-reduced-motion: reduce, all CSS transitions and animations are physically suppressed (<= 0.05s). Added missing reduced motion media queries to \�xamples/persian_rtl_bento.html.
• ARIA Contract Hardening: Verified non-empty accessible names with \�ria-labelledby\ tree resolution and asserted that \�ria-controls\ targets physically exist in the DOM.
• Single Source of Truth Manifest & Version Harmonization: Added \�ersion.json\ and harmonized version pinning across \install.sh, \install.ps1, \SECURITY.md, and \ARCHITECTURE.md. Removed redundant legacy workflow .github/workflows/evals.yml.

v2.4.1: Adversarial Hardening, Deterministic Chromium Runtime & DoS-Safe Validator

v2.4.1: Adversarial Hardening, Deterministic Chromium Runtime & DoS-Safe Validator

This maintenance and security release incorporates deep adversarial hardening from multi-LLM audits (achieving a 9.1 / 10 consensus score across ChatGPT-4o and Grok), closes all known bypass vectors in the pure-Python validator, and introduces multi-viewport layout stabilization in headless Chromium.

---

🛡️ Security & Closed-World Validator Hardening

• Closed-World Exploit Prevention: Restricted $schema strictly to the exact root level (path == "$"). Any other property starting with $ (e.g. $injected_exploit or $rogue_key) is rejected immediately.
• Adversarial Negative Fixtures: Added and automated evals/fixtures/illegal_dollar_property.json, illegal_additional_property.json, and out_of_range_latitude.json.
• Cycle-Safe $ref Resolution: Implemented recursion depth limit (64) and visited reference set tracking in validate_json_instance() to prevent circular reference DoS crashes.
• String Constraints: Enforced minLength, maxLength, and regex pattern validations.
• Strict Domain Bounds: Enforced strict numerical bounds for coordinates (latitude: [-90, 90], longitude: [-180, 180]), financial math (precision_decimals: [0, 8]), and Core Web Vitals budgets.

---

🌐 Deterministic Chromium Runtime Evals (evals/run_evals.py --browser)

• Layout & Font Stabilization: Replaced bare domcontentloaded with bounded networkidle (3000ms timeout), document.fonts.ready check, and double requestAnimationFrame before measuring DOM geometry.
• Multi-Viewport Mobile Overflow (320px & 375px): Audits both standard mobile (375x667) and narrow mobile boundary (320x568). Surgically resolved a 320px horizontal overflow in neobrutalist_creative_store.html.
• Physical Focus Rings Assertion: Programmatically verified active :focus-visible indicators (outline or box-shadow) on all interactive controls.
• Prefers-Reduced-Motion Media Emulation: Emulated (prefers-reduced-motion: reduce) in Playwright and verified CSS media responsiveness.
• Visibility & Accessibility Filtering: Filtered out elements inside [aria-hidden="true"], display: none, or visibility: hidden from interactive target sweeps.

---

📦 Ecosystem Artifacts

• NPM Package: @omid-io/tokens
• Open-VSX Registry: omid-io.vibe-ui-vscode
• VS Code Marketplace: omid-io.vibe-ui-vscode
• Attached Asset: vibe-ui-vscode-2.4.0.vsix

v2.4.0: CLI Scaffolding, Component Registry & Interactive VS Code Studio

Official v2.4.0 Ecosystem Release

🚀 Public Registries (Live Worldwide)

• NPM Package: @omid-io/tokens (pm install @omid-io/tokens)
• Open-VSX Registry (Cursor & Windsurf): omid-io.vibe-ui-vscode
• VS Code Marketplace: omid-io.vibe-ui-vscode

📦 Major Additions in v2.4.0

1. Zero-Dependency CLI Tool (@omid-io/tokens):
   • px @omid-io/tokens init: 1-command interactive scaffolding for Cursor, Claude Code, Windsurf, and OKLCH CSS variables.
   • px @omid-io/tokens add : Instant injection of verified AI-native React 19 / Next.js 15 primitives (\ hinking-drawer, \ elemetry-hud, \contrast-badge) into \components/vibe-ui/.
   • px @omid-io/tokens list: Terminal catalog of available primitives.
2. Interactive VS Code Extension Studio:
   • Real-time mathematical WCAG 2.2 AA / AAA contrast calculator with color pickers and instant pass/fail ratios.
   • Interactive component catalog with 1-click Insert into Active Editor and TSX copy buttons.
3. Multi-IDE Quick Start & Documentation:
   • Grounded empirical guides in README and README.fa.

v2.3.0: VS Code Extension, Scoped NPM Tokens & Playwright Runtime Evals

Official v2.3.0 Ecosystem Release

🚀 Public Registries

• VS Code Marketplace: omid-io.vibe-ui-vscode
• Open-VSX Registry (Cursor & Windsurf): omid-io.vibe-ui-vscode
• NPM Package: @omid-io/tokens (pm install @omid-io/tokens)

📦 Included Deliverables

• VS Code & Cursor Extension: Packaged standalone binary \�ibe-ui-vscode-2.3.0.vsix\ with official 128x128 icon, Webview chemistry explorer, and in-editor WCAG contrast diagnostics.
• Scoped NPM Package: @omid-io/tokens\ with dual ESM/CJS bundles, typed OKLCH colors, motion curves, and zero-config Tailwind plugin.
• Enterprise Architecture: \docs/ENTERPRISE_ADAPTATION.md\ for Figma tokens and proprietary design system binding.
• Headless Playwright Evals: Added --browser\ flag to \�vals/run_evals.py\ verifying real DOM 375px mobile overflow and computed properties in CI.
• DX Hardening: 1-minute setup verification prompt, 70+ recipe catalog index, and safe install hierarchy in README.

v2.2.1: Production CI & Multi-IDE Hardening

What's Changed

• Added real GitHub Actions CI workflow with Python matrix (3.10, 3.12) and Node 20 Next.js 15 production build
• Automated evaluation of Next.js 15 starter in evals/run_evals.py
• 30-second multi-IDE quick start for Cursor, Claude Code, Windsurf
• De-hyped documentation and verified mathematical invariants

v2.2.0: Next.js 15 Starter, Relative Luminance Evals & System Architecture

Initial major release with 6-skill DAG, Draft 2020-12 schema, typed OKLCH tokens, Next.js 15 starter, and pure Python WCAG AA relative luminance evaluator.