9.5 KiB
9.5 KiB
WRNexusJS 0.3 — 40-Point Implementation Matrix
Legend:
- Existing + hardened: capability already existed and was preserved or extended
- Implemented: new usable public API/runtime behavior in 0.3
- Foundation / experimental: contract and integration seam exist; advanced provider-specific implementations should remain opt-in until they receive production soak testing
| # | Improvement | 0.3 implementation | Level |
|---|---|---|---|
| 1 | Formal language specification | Canonical spec constants, stable diagnostics, and docs/WRN-LANGUAGE-SPEC-1.0.md |
Implemented |
| 2 | Shared parser and AST | New @wrnexus/syntax; compiler compatibility re-exports |
Implemented |
| 3 | Compile-time/runtime separation | Runtime metadata, server-only suppression, compile-time diagnostics and transforms | Existing + hardened |
| 4 | Fine-grained reactivity | Batched signals, dependency-tracked computed/effects, coalesced renderers | Implemented |
| 5 | Deterministic SSR/hydration | Stable hydration IDs, runtime/strategy metadata, mismatch diagnostics, keyed data-for reconciliation and keyed {#each} syntax |
Implemented |
| 6 | Partial hydration/islands | load/idle/visible/interaction/media/none strategies | Implemented |
| 7 | Server-only execution | runtime = "server", load server, browser-interactivity rejection |
Implemented |
| 8 | Data-loading model | defineLoader, defineAction, request-local dedupe, WRN loaders/actions |
Foundation / experimental |
| 9 | Streaming SSR | Promise and AsyncIterable document streams and response helper |
Implemented |
| 10 | Routing | groups, optional and catch-all params, conflict checks, typed builders | Implemented |
| 11 | Middleware | Existing ordered middleware plus tracing and tenancy middleware | Existing + hardened |
| 12 | Typed API/RPC | validated endpoint definitions, typed RPC client, structured errors | Implemented |
| 13 | Security defaults | Existing CSP/CSRF/cookies/CORS/body guards plus WRN security metadata | Existing + hardened |
| 14 | DevToolbar | Runtime diagnostic bridge and existing accessibility/performance/SEO/security rules | Existing + hardened |
| 15 | Optimization reports | dist/build-report.json, CLI analyzer, route/assets/budget measurements |
Implemented |
| 16 | Error messages | Stable WRN codes, positions, code frames, hints | Implemented |
| 17 | Language server/editor | VS Code diagnostics/completion/grammar/snippets aligned to 0.3 syntax | Existing + hardened |
| 18 | Schemas/validation | Existing shared form/API validation retained; endpoint schema contract added | Existing + hardened |
| 19 | Authentication primitives | Existing auth/session/OAuth/passkey-related packages retained; security metadata seam | Existing + hardened |
| 20 | Multi-tenancy | tenant context, resolver/middleware, subdomain/domain/path runtime config | Implemented |
| 21 | Jobs/cron/workflows | priority, concurrency, idempotency, cancellation, job/workflow/cron helpers | Implemented |
| 22 | Realtime | Existing rooms/pub-sub/Redis bridge retained with shared runtime | Existing + hardened |
| 23 | Plugin system | deterministic lifecycle, AST/code transforms, diagnostics, server/build hooks | Implemented |
| 24 | Infrastructure adapters | portable fetch handler and existing Bun/Node seams; adapter config/reporting | Foundation / experimental |
| 25 | Build caching/monorepo | Existing compile cache and targeted HMR retained; build cache config seam | Existing + hardened |
| 26 | Compatibility/migrations | reversible 0.3 migration, source backup/report, doctor, unique versions |
Implemented |
| 27 | Testing | new syntax/core/compiler/router/queue/SSR/update/editor regressions | Implemented |
| 28 | Performance budgets | configurable route JS/CSS, HTML, image, hydration, and SSR budgets | Implemented |
| 29 | Observability | tracer/span APIs, request middleware, Server-Timing, console exporter | Implemented |
| 30 | Component architecture | Existing @wrnexus/ui inventory retained; syntax metadata supports typed tooling |
Existing + hardened |
| 31 | Design tokens | Existing --wire-* system and theme resolution retained |
Existing + hardened |
| 32 | Accessibility | compile-time missing-alt diagnostic plus existing DevToolbar scanning | Implemented |
| 33 | Motion/transitions | Existing CSR/lifecycle foundation retained; strategy can be plugin/runtime extended | Foundation / experimental |
| 34 | Documentation | language, architecture, upgrade, implementation, test checklist docs | Implemented |
| 35 | AI-friendly framework | machine-readable spec/AST/diagnostics/build report and existing AI package | Implemented |
| 36 | Feature flags/experimental APIs | async context-aware feature flags and typed config gates | Implemented |
| 37 | Public API boundaries | syntax/compiler separation and explicit package exports | Implemented |
| 38 | Configuration | typed validation, source explanation, profile/env visibility | Implemented |
| 39 | Gateway | existing host routing/auth/WebSocket/security gateway preserved; internal contracts unchanged | Existing + hardened |
| 40 | Focused roadmap/release gates | 0.3 stability levels, verification script, audit and test matrix | Implemented |
Important release distinction
This matrix records code present in the 0.3 source tree. “Foundation / experimental” does not mean absent; it means the API or adapter seam is implemented but should not be advertised as provider-complete until the relevant deployment, animation, cache, or server-component adapters receive real production tests.
Backward-compatibility gates
- Existing compiler imports continue through re-exports.
- Existing
.wrnmembers and directives remain accepted. - New runtime behavior is disabled unless syntax/config opts in.
- Source migration is conservative, backed up, idempotent, and reported.
- Existing route syntax retains matching precedence.
- Existing dev and production request runtimes remain shared.
- Every bug fix receives a regression test or static verification assertion.