[laurenic0l]

PR for the new expanded elementcomposite section

closes #710
closes #378
closes #376

[gosteenBASIS]

Generally in good shape I think, but I left a couple comments where I think some clarification/edits would help.
The only big thing is that Shoelace is being converted to Web Awesome, so I think it would be a good idea to update all the examples/prose to use Web Awesome instead, so as to be up to date with the latest developments in that area. That would be a moderate overhaul of all the examples, so I'll leave it up to Lauren or Hyyan to decide if that's the right call!

[hyyan]

@MatthewHawkins please review this and leave your comments, then assign it back to me.

[laurenic0l]

Pushed updates addressing the review feedback.

Property and attribute descriptors

• Added explicit factory method syntax for PropertyDescriptor.property() and PropertyDescriptor.attribute()
• Added full declaration syntax to the Typing properties subsection
• Rewrote set()/get() to explain the protected primitives, the server-side cache, and the Type resolution order

Article structure

• Wrapped event content under a single ## Events heading
• Nested Testing properties under Property and attribute descriptors
• Restructured Interacting with slots to lead with adding content and ElementCompositeContainer, demoted inspection methods to a short subsection at the end
• Narrowed Built-in event classes to ElementClickEvent and the HasElementClickListener concern

CardView demo

• Replaced the nonexistent --dwc-color-neutral-600 with --dwc-color-default-text-light
• Applied ButtonTheme.PRIMARY to the CTA button
• Centered the cards vertically and fixed dark-mode background through the Shoelace shadow DOM

Follow-up

Shoelace has been sunset in favor of Web Awesome, so the demos will need to migrate. I'll open a separate issue to track that since it touches all four demo files and needs the current Web Awesome release status verified.

[hyyan]

@laurenic0l Looks great! Could you link the issues that this PR will close before we merge it?

[MatthewHawkins]

@laurenic0l My mistake - I merged this after reading Hyyan's email but before I read his comment to close out the issues. Go ahead and list the issues here and manually close them out, sorry!