69 lines
9.5 KiB
Markdown
69 lines
9.5 KiB
Markdown
# 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
|
|
|
|
1. Existing compiler imports continue through re-exports.
|
|
2. Existing `.wrn` members and directives remain accepted.
|
|
3. New runtime behavior is disabled unless syntax/config opts in.
|
|
4. Source migration is conservative, backed up, idempotent, and reported.
|
|
5. Existing route syntax retains matching precedence.
|
|
6. Existing dev and production request runtimes remain shared.
|
|
7. Every bug fix receives a regression test or static verification assertion.
|