Skip to content

docs: add directive incompatibility limitations and LSP diagnostics - #66

Merged
ErickXavier merged 2 commits into
mainfrom
fix/NOJS-244-NOJS-260
Jul 8, 2026
Merged

docs: add directive incompatibility limitations and LSP diagnostics#66
ErickXavier merged 2 commits into
mainfrom
fix/NOJS-244-NOJS-260

Conversation

@ErickXavier

Copy link
Copy Markdown
Collaborator

Summary

  • Add limitation notes to 6 directive reference files for incompatible combinations (NOJS-244 Wave 5)
  • Add new validation.md section documenting 6 LSP diagnostics with examples and fixes
  • Add SKILL.md section 6.5 Directive Compatibility table for quick reference

Findings documented:

  • Finding 5: case/default + loop (switch becomes inert)
  • Finding 9: if + loop on same element (condition cannot filter items)
  • Finding 10: ref on looped element (last clone wins)
  • Finding 13: bind-value + model (redundant two-way bindings)
  • Finding 19: watch + on:change on form controls (event conflict)
  • Finding 20: t + bind (double text-writer)

Test plan

  • All markdown files render correctly
  • No broken internal links
  • Hold as DRAFT until Core v1.18.0 releases

Part of NOJS-244 (Directive Incompatibility Remediation)

Add limitation notes for 6 documented directive incompatibilities:

- conditionals.md: if+loop, case/default+loop edge cases
- loops.md: new Directive Compatibility Notes section
- binding.md: bind+t, bind-value+model, model+bind-value notes
- state.md: watch+on:change on form controls
- i18n.md: t+bind double text-writer
- validation.md: new section 4 with all 6 LSP diagnostics
- SKILL.md: new section 6.5 Directive Compatibility table
@ErickXavier
ErickXavier marked this pull request as ready for review July 8, 2026 12:52
@ErickXavier
ErickXavier merged commit 131ed28 into main Jul 8, 2026
1 check passed
@ErickXavier
ErickXavier deleted the fix/NOJS-244-NOJS-260 branch July 8, 2026 13:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant