fix(core): improve api custom elements schema

Update slot descriptions across multiple components for clarity and consistency. Enhanced documentation for slots in Accordion, Avatar, Badge, Card, Chat Message, Copy Button, Dialog, Drawer, Dropdown, Grid, Menu Item, Notification, Toast, and others to specify expected content types and usage.
Signed-off-by: Cory Rylan <crylan@nvidia.com>

Author: coryrylan

projects/core/src/accordion/accordion.ts

@@ -30,7 +30,7 @@ import accordionGroupStyleSheet from './accordion-group.css?inline';
  * @documentation https://nvidia.github.io/elements/docs/elements/accordion/
  * @since 0.12.0
  * @entrypoint \@nvidia-elements/core/accordion
- * @slot - default content slot
+ * @slot - Heading text and supporting content that labels the accordion section.
  * @slot prefix - slot for prefix content
  * @slot suffix - slot for suffix content
  * @cssprop --cursor
@@ -57,6 +57,7 @@ export class AccordionHeader extends LitElement {
  `;
 }
 
+/** @private */
  @hostAttr()slot='header';
 
 connectedCallback(){
@@ -101,14 +102,13 @@ export class AccordionContent extends LitElement {
  * @command --open - use to open the accordion
  * @command --close - use to close the accordion
  * @command --toggle - use to toggle the accordion
- * @slot - This is a default/unnamed slot for accordion content
+ * @slot - Content displayed in the collapsible region, typically an `nve-accordion-content` element.
  * @slot icon-button - icon elements to display for expand/collapse
  * @slot header - header element (Use `accordion-header` or custom content)
- * @slot content - content element (Use `accordion-content` or custom content)
  * @cssprop --background
  * @cssprop --color
  * @cssprop --border-radius
- * @cssprop --header-padding
+ * @cssprop --header-padding - Padding around the header content.
  * @cssprop --cursor
  * @cssprop --transition
  * @csspart icon-button - The toggle icon button element
@@ -244,7 +244,9 @@ export class AccordionGroup extends LitElement {
  */
  @property({type: Boolean,attribute: 'behavior-expand-single'})behaviorExpandSingle=false;
 
-/** flat (Borderless, container-less accordions), full (default), or inset (Rounded corner, contained accordion) */
+/**
+ * Controls the container style applied to child accordions. `flat` removes the visual container, `inset` adds rounded containment, and omission uses the default divided presentation.
+ */
  @property({type: String,reflect: true})container?: Extract<Container,'flat'|'inset'>;
 
 staticreadonlymetadata={

projects/core/src/avatar/avatar-group.ts

@@ -10,7 +10,7 @@ import styles from './avatar-group.css?inline';
  * @description An avatar group displays a collection of user avatars in a compact and organized layout, showcasing many participants or contributors in a space-efficient way.
  * @since 1.20.0
  * @entrypoint \@nvidia-elements/core/avatar
- * @slot - default slot for content
+ * @slot - `nve-avatar` elements that represent the group members.
  * @aria https://www.w3.org/WAI/ARIA/apg/patterns/alert/
  *
  */

projects/core/src/avatar/avatar.ts

@@ -14,7 +14,7 @@ import styles from './avatar.css?inline';
  * @documentation https://nvidia.github.io/elements/docs/elements/avatar/
  * @since 1.20.0
  * @entrypoint \@nvidia-elements/core/avatar
- * @slot - default slot for content
+ * @slot - Initials, an image, or other content that identifies the represented user or bot.
  * @cssprop --background
  * @cssprop --color
  * @cssprop --border-radius

projects/core/src/badge/badge.ts

@@ -25,7 +25,7 @@ import styles from './badge.css?inline';
  * @documentation https://nvidia.github.io/elements/docs/elements/badge/
  * @since 0.11.0
  * @entrypoint \@nvidia-elements/core/badge
- * @slot - default slot for content
+ * @slot - Short text that communicates the badge status.
  * @slot prefix-icon - slot for prefix icon
  * @slot suffix-icon - slot for suffix icon
  * @cssprop --background

projects/core/src/card/card.ts

@@ -55,7 +55,7 @@ export class Card extends LitElement implements ContainerElement {
  * @documentation https://nvidia.github.io/elements/docs/elements/card/
  * @since 0.1.3
  * @entrypoint \@nvidia-elements/core/card
- * @slot - default slot
+ * @slot - Card title, supporting text, and optional action controls.
  * @cssprop --padding
  * @cssprop --border-bottom
  * @cssprop --line-height
@@ -72,6 +72,7 @@ export class CardHeader extends LitElement {
 parents: ['nve-card']
 };
 
+/** @private */
  @hostAttr()slot='header';
 
 render(){
@@ -133,6 +134,7 @@ export class CardFooter extends LitElement {
 parents: ['nve-card']
 };
 
+/** @private */
  @hostAttr()slot='footer';
 
 render(){

projects/core/src/chat-message/chat-message.ts

@@ -15,7 +15,7 @@ import globalStyles from './chat-message.global.css?inline';
  * @documentation https://nvidia.github.io/elements/docs/elements/chat-message/
  * @since 1.25.0
  * @entrypoint \@nvidia-elements/core/chat-message
- * @slot - default slot for content
+ * @slot - The message body displayed between the prefix and suffix content.
  * @slot prefix - for avatar/img content
  * @slot suffix - for avatar/img content
  * @cssprop --background
@@ -37,10 +37,12 @@ export class ChatMessage extends LitElement {
 version: '0.0.0'
 };
 
+/** Applies a transparent background and reduced horizontal padding for embedding the message in another container. */
  @property({type: String,reflect: true})container: 'flat';
 
  @property({type: String,reflect: true})color: Color;
 
+/** Removes the border radius from the selected message corner to indicate the speaker direction. */
  @property({type: String,reflect: true,attribute: 'arrow-position'})arrowPosition:
 |'top-start'
 |'top-end'

projects/core/src/copy-button/copy-button.ts

@@ -17,7 +17,7 @@ import styles from './copy-button.css?inline';
  * @documentation https://nvidia.github.io/elements/docs/elements/copy-button/
  * @since 1.1.4
  * @entrypoint \@nvidia-elements/core/copy-button
- * @slot - default
+ * @slot - Text label displayed before the copy icon.
  * @slot icon - slot for custom icon
  * @cssprop --color
  * @cssprop --background

projects/core/src/dialog/dialog.ts

@@ -29,7 +29,7 @@ import styles from './dialog.css?inline';
  * @event toggle - Dispatched on a popover element just after showing or hiding. [MDN](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/toggle_event)
  * @event open - Dispatched when the dialog opens.
  * @event close - Dispatched when the dialog closes.
- * @slot - default content slot
+ * @slot - Dialog body content displayed between the header and footer.
  * @cssprop --border
  * @cssprop --border-radius
  * @cssprop --background

projects/core/src/drawer/drawer.ts

@@ -26,7 +26,7 @@ import styles from './drawer.css?inline';
  * @event toggle - Dispatched on a popover element just after showing or hiding. [MDN](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/toggle_event)
  * @event open - Dispatched when the drawer opens.
  * @event close - Dispatched when the drawer closes.
- * @slot - default content slot
+ * @slot - Drawer body content displayed between the header and footer.
  * @cssprop --border
  * @cssprop --background
  * @cssprop --color

projects/core/src/dropdown-group/dropdown-group.ts

@@ -23,8 +23,6 @@ import globalStyles from './dropdown-group.global.css?inline';
  * @slot - default slot for dropdown content
  * @event open - Dispatched when a dropdown in the group opens
  * @event close - Dispatched when a dropdown in the group closes
- * @cssprop --nve-dropdown-group-spacing
- * @cssprop --nve-dropdown-group-transition
  * @cssprop --arrow-transform - Transform applied to the popover arrow
  * @aria https://www.w3.org/WAI/ARIA/apg/patterns/menubar/
  */
@@ -114,6 +112,7 @@ export class DropdownGroup extends LitElement {
 }
 }
 
+/** Closes every descendant dropdown in the group. */
 close(){
 this.querySelectorAll('nve-dropdown').forEach(d=>d.hidePopover());
 }