Specification & Compiler Source release: v1.1.0 • SHA: cee51abe

CoherynUI — Stable 1.0 Release Readiness Report

Date: October 27, 2026
Document ID: COH-REL-1.0-READY
Status: All Acceptance Gates Green


1. Executive Summary

All five mandatory advanced subsystems and the core Rust-native compiler have been implemented, tested, and verified under the canonical CoherynUI product identity and coherynui native CLI binary. Zero mandatory subsystems are deferred.


2. Mandatory Stable 1.0 Quality Gates

Quality GateAcceptance CriteriaSubsystems & EvidenceStatus
Gate 1: CorrectnessDeterministic cascade layer generation, clean build ≡ cached build@layer hierarchy verified in first_acceptance_test.rs and cache_equivalence_test.rs.✅ PASSED
Gate 2: AccessibilityWAI-ARIA 1.2 / WCAG 2.2 AA interaction patterns, focus trap, roving tabindexaccessibility-contracts.md and accessibility_primitives.test.ts.✅ PASSED
Gate 3: Browser Fallback3-tier cascade for optical effects (WebGPU → WebGL2 → CSS Glass → Opaque)Verified in refraction_pipeline.test.ts and browsers.md.✅ PASSED
Gate 4: SecurityZero ambient authority in WASM plugins, fuel instruction metering, memory capsVerified in security_sandbox_test.rs and capabilities-and-security.md.✅ PASSED
Gate 5: OptimizationAggressive class renaming preserves DOM, SSR parity, and fail-closed dynamic safetyVerified in class_renaming_test.rs and conformance_benchmark_test.rs.✅ PASSED
Gate 6: PerformanceAnalytical spring solver with zero frame-rate jitter; sub-50ms cold compilesVerified in spring_solver.test.ts and conformance_benchmark_test.rs.✅ PASSED
Gate 7: DistributionRust Edition 2024 Cargo Resolver 3 workspace, dual MIT/Apache-2.0 licensingConfigured in Cargo.toml, .github/workflows/ci.yml, LICENSE-MIT, LICENSE-APACHE.✅ PASSED

3. Subsystem Release Verification Matrix

  1. CoherynUI CSS Engine & Native CLI (coherynui):
    • Full canonical utility registry with display, flexbox, alignment, grid, typography, sizing, spacing, positioning, borders, shadows, opacity, and transitions.
    • Arbitrary value brackets (p-[27px], w-[calc(100%_-_2rem)], bg-[#172033]).
    • Container Queries (cq-root, cq:, cq-sm:, cq-md:, cq-lg:).
    • Adaptive Layout Primitives (stack, cluster, grid-auto, center, sidebar, flow, cover, switcher).
  2. CoherynUI Components:
  3. CoherynUI Motion:
    • Analytical harmonic oscillator spring physics ($m \cdot x'' + c \cdot x' + k \cdot x = 0$) (@coheryn/coherynui-motion).
    • Interruptible retargeting without velocity snaps, sequential timelines, FLIP layout transitions.
  4. CoherynUI GPU Materials:
    • Real WGSL optical refraction shader (shaders/wgsl/refraction.wgsl).
    • Normal mapping, chromatic dispersion, pointer ripple disturbance, 3-tier fallback.
  5. CoherynUI Class Optimizer:
    • Whole-project AST rewriter across markup and CSS (crates/coherynui-class-opt).
    • Bidirectional manifest generation (coherynui.manifest.json), reserved word shielding, fail-closed dynamic checking.
  6. CoherynUI Plugin Host: