docs: add 2nd-gen TypeScript style guide and research docs#6094
docs: add 2nd-gen TypeScript style guide and research docs#6094
Conversation
Add comprehensive TypeScript style guide for 2nd-gen component development covering file organization, class structure, decorators, types, rendering patterns, naming conventions, composition patterns (mixins, controllers, directives, interfaces), and debug validation. All guides use the Badge component as the primary reference implementation, with other 2nd-gen components shown where they demonstrate different patterns. Also includes research documents for SWC-1419 (full pattern analysis across existing 2nd-gen components) and SWC-1420 (TypeScript guide planning), plus minor fixes to existing contributor docs (TOC updates, linting-tools renumbering for new TypeScript section, field-label analysis tag fix). Made-with: Cursor
|
📚 Branch Preview Links🔍 First Generation Visual Regression Test ResultsWhen a visual regression test fails (or has previously failed while working on this branch), its results can be found in the following URLs:
Deployed to Azure Blob Storage: If the changes are expected, update the |
Remove SWC-1419 and SWC-1420 research documents and their references from the project-planning README. These are AI-generated working documents that should not be committed to the repository, per reviewer feedback from marissahuysentruyt and rubencarvalho on #6067. Made-with: Cursor
caseyisonit
added
Status:Ready for review
|
closing this as it didn't address the feedback from the original PR and would cause too much friction updating |
2 participants
Summary
Motivation
Contributors (human and AI) need clear, consistent guidance for writing 2nd-gen components. These guides provide detailed conventions based on the Badge component as the reference implementation, with other 2nd-gen components shown where they demonstrate different patterns.
Related
Test plan