{ "schemaVersion": "2.1.0", "readme": "", "modules": [ { "kind": "javascript-module", "path": "components/design-system/nav-link-card/run-nav-link-card.js", "declarations": [ { "kind": "class", "name": "RunNavLinkCard", "tagName": "run-nav-link-card", "superclass": { "name": "RunElement", "module": "shared/run-element.js" }, "summary": "Host-is-Element-simple web component: ", "attributes": [ { "name": "href", "type": { "text": "string" }, "default": "''", "description": "Navigation target URL. When empty, the card is non-navigable: internal anchor has no `href`, anchor receives `tabindex=\"-1\"`, no `run-navigate` event is dispatched.", "fieldName": "href" }, { "name": "target", "type": { "text": "string" }, "default": "''", "description": "Anchor target attribute (`'_self'`, `'_blank'`, `'_parent'`, `'_top'`, or a frame name). When `'_blank'` and no consumer `rel` is set, `'noopener'` is auto-appended on the internal anchor. `'noreferrer'` is never appended.", "fieldName": "target" }, { "name": "rel", "type": { "text": "string" }, "default": "''", "description": "Anchor `rel` attribute. When set by consumer, passes through to the internal anchor untouched (no merge). When empty and `target=\"_blank\"`, the component sets `rel=\"noopener\"` on the internal anchor only.", "fieldName": "rel" }, { "name": "variant", "type": { "text": "string" }, "default": "'default'", "description": "Visual variant. One of: `NAV_LINK_CARD_VARIANTS`.", "fieldName": "variant" }, { "name": "orientation", "type": { "text": "string" }, "default": "'vertical'", "description": "Layout orientation. One of: `NAV_LINK_CARD_ORIENTATIONS`. Unknown values fall back to `'vertical'`.", "fieldName": "orientation" }, { "name": "current", "type": { "text": "boolean" }, "default": "false", "description": "Boolean shorthand for marking this card as the current page. When true and consumer has not set `aria-current`, the host gains `aria-current=\"page\"`.", "fieldName": "current" }, { "name": "aria-current", "type": { "text": "string \\| null" }, "default": "null", "description": "Consumer-controlled `aria-current` value. When non-empty, wins over the `current` boolean shorthand. Valid ARIA values: `'page'`, `'step'`, `'location'`, `'date'`, `'time'`, `'true'`, `'false'`. Set to `null` (or remove the attribute) to clear.", "fieldName": "ariaCurrent" } ], "members": [ { "kind": "field", "name": "href", "type": { "text": "string" }, "default": "''", "description": "Navigation target URL. When empty, the card is non-navigable: internal anchor has no `href`, anchor receives `tabindex=\"-1\"`, no `run-navigate` event is dispatched.", "attribute": "href", "reflects": true }, { "kind": "field", "name": "target", "type": { "text": "string" }, "default": "''", "description": "Anchor target attribute (`'_self'`, `'_blank'`, `'_parent'`, `'_top'`, or a frame name). When `'_blank'` and no consumer `rel` is set, `'noopener'` is auto-appended on the internal anchor. `'noreferrer'` is never appended.", "attribute": "target", "reflects": true }, { "kind": "field", "name": "rel", "type": { "text": "string" }, "default": "''", "description": "Anchor `rel` attribute. When set by consumer, passes through to the internal anchor untouched (no merge). When empty and `target=\"_blank\"`, the component sets `rel=\"noopener\"` on the internal anchor only.", "attribute": "rel", "reflects": true }, { "kind": "field", "name": "variant", "type": { "text": "string" }, "default": "'default'", "description": "Visual variant. One of: `NAV_LINK_CARD_VARIANTS`.", "attribute": "variant", "reflects": true }, { "kind": "field", "name": "orientation", "type": { "text": "string" }, "default": "'vertical'", "description": "Layout orientation. One of: `NAV_LINK_CARD_ORIENTATIONS`. Unknown values fall back to `'vertical'`.", "attribute": "orientation", "reflects": true }, { "kind": "field", "name": "current", "type": { "text": "boolean" }, "default": "false", "description": "Boolean shorthand for marking this card as the current page. When true and consumer has not set `aria-current`, the host gains `aria-current=\"page\"`.", "attribute": "current", "reflects": true }, { "kind": "field", "name": "ariaCurrent", "type": { "text": "string \\| null" }, "default": "null", "description": "Consumer-controlled `aria-current` value. When non-empty, wins over the `current` boolean shorthand. Valid ARIA values: `'page'`, `'step'`, `'location'`, `'date'`, `'time'`, `'true'`, `'false'`. Set to `null` (or remove the attribute) to clear.", "attribute": "aria-current", "reflects": true } ], "events": [ { "name": "run-navigate", "description": "Fired when the user activates the card (click on internal anchor or `Enter` keydown) and `href` is non-empty. Cancelable: calling `preventDefault()` on the dispatched event suppresses native navigation (the internal click's `originalEvent.preventDefault()` is called). Not fired in non-navigable mode (`href` empty). Not fired on `Space` keydown. Not fired when a slotted interactive element in `trailing` calls `stopPropagation()` on the underlying click.", "type": { "text": "{ href: string, target: string, originalEvent: Event }" } } ], "slots": [ { "name": "leading", "description": "Optional leading-edge content (typically ``, avatar, or small media). One element expected." }, { "name": "title", "description": "Primary card label. Plain text or inline elements. The card has no implicit title — consumers must supply one." }, { "name": "description", "description": "Optional secondary descriptive text. When non-empty, the first slotted element receives a stable generated `id` and the internal anchor's `aria-describedby` references it. When the slot empties, `aria-describedby` is cleared." }, { "name": "trailing", "description": "Optional trailing-edge content (badge, chevron, or interactive control such as ``). Slotted interactive children that call `stopPropagation()` on click prevent card activation; the component itself does not intercept trailing-slot clicks." } ], "cssProperties": [ { "name": "--------------", "default": "", "description": "" }, { "name": "--run-space-semantic-*", "default": "", "description": "" }, { "name": "--run-color-surface-*", "default": "", "description": "" }, { "name": "--run-color-text-primary", "default": "", "description": "" }, { "name": "--run-color-text-secondary", "default": "", "description": "" }, { "name": "--run-color-intent-primary-*", "default": "", "description": "" }, { "name": "--run-color-border-*", "default": "", "description": "" }, { "name": "--run-radius-*", "default": "", "description": "" }, { "name": "--run-motion-semantic-micro-*", "default": "", "description": "" }, { "name": "--run-text-*", "default": "", "description": "" } ], "cssParts": [ { "name": "surface", "description": "The full card surface. Targets backgrounds, borders, padding, focus-ring, and interactive state styling." }, { "name": "leading", "description": "The leading-region container. Hidden when slot is empty." }, { "name": "content", "description": "The main content column wrapping title and description." }, { "name": "title", "description": "The title region. Targets typography of the card label." }, { "name": "description", "description": "The description region. Hidden when slot is empty." }, { "name": "trailing", "description": "The trailing-region container. Hidden when slot is empty." } ] } ], "exports": [ { "kind": "js", "name": "RunNavLinkCard", "declaration": { "name": "RunNavLinkCard", "module": "components/design-system/nav-link-card/run-nav-link-card.js" } }, { "kind": "custom-element-definition", "name": "run-nav-link-card", "declaration": { "name": "RunNavLinkCard", "module": "components/design-system/nav-link-card/run-nav-link-card.js" } } ] }, { "kind": "javascript-module", "path": "components/design-system/nav-link-group/run-nav-link-group.js", "declarations": [ { "kind": "class", "name": "RunNavLinkGroup", "tagName": "run-nav-link-group", "superclass": { "name": "RunElement", "module": "shared/run-element.js" }, "summary": "Host-is-Element-simple web component: ", "attributes": [ { "name": "orientation", "type": { "text": "string" }, "default": "'vertical'", "description": "Layout axis of the group's items. One of: `NAV_LINK_GROUP_ORIENTATIONS`. Invalid values are silently coerced to `'vertical'` in both the property setter and `attributeChangedCallback`.", "fieldName": "orientation" }, { "name": "disabled", "type": { "text": "boolean" }, "default": "false", "description": "Visual-only disabled state for the group. Applies reduced opacity via `--run-opacity-state-disabled`. Does NOT cascade to slotted children — per-link `aria-disabled` and interactivity gating are consumer-owned.", "fieldName": "disabled" } ], "members": [ { "kind": "field", "name": "label", "type": { "text": "string" }, "default": "''", "description": "Accessible label text for the group. When set, renders a visible label region and wires `aria-labelledby` to a uniquely-IDed internal label element. Named slot `label` content takes visual precedence; the property remains the accessible-name fallback.", "attribute": "label", "reflects": false }, { "kind": "field", "name": "orientation", "type": { "text": "string" }, "default": "'vertical'", "description": "Layout axis of the group's items. One of: `NAV_LINK_GROUP_ORIENTATIONS`. Invalid values are silently coerced to `'vertical'` in both the property setter and `attributeChangedCallback`.", "attribute": "orientation", "reflects": true }, { "kind": "field", "name": "disabled", "type": { "text": "boolean" }, "default": "false", "description": "Visual-only disabled state for the group. Applies reduced opacity via `--run-opacity-state-disabled`. Does NOT cascade to slotted children — per-link `aria-disabled` and interactivity gating are consumer-owned.", "attribute": "disabled", "reflects": true } ], "events": [], "slots": [ { "name": "", "description": "Child navigation link elements. Triggers `slotchange` to recompute the `[empty]` state attribute (whitespace-only text nodes are filtered)." }, { "name": "label", "description": "Optional rich label content. When the slot has assigned nodes, they render in place of the `label` property value. The slot's presence (slot or property) toggles `[has-label]` and `aria-labelledby` wiring." } ], "cssProperties": [ { "name": "--run-nav-link-group-padding-block", "default": "var(--run-space-semantic-sm)", "description": "Block-axis padding inside the group container." }, { "name": "--run-nav-link-group-padding-inline", "default": "var(--run-space-semantic-sm)", "description": "Inline-axis padding inside the group container." }, { "name": "--run-nav-link-group-gap", "default": "var(--run-space-semantic-xs)", "description": "Gap between child link elements in the items region." }, { "name": "--run-nav-link-group-label-gap", "default": "var(--run-space-semantic-xs)", "description": "Block-end margin between the label and the items region." }, { "name": "--run-nav-link-group-label-color", "default": "var(--run-color-text-tertiary)", "description": "Label text color." }, { "name": "--run-nav-link-group-label-font-size", "default": "var(--run-font-size-xs)", "description": "Label text size." }, { "name": "--run-nav-link-group-label-font-weight", "default": "var(--run-font-semantic-weight-strong)", "description": "Label font weight." }, { "name": "--run-nav-link-group-label-letter-spacing", "default": "0.05em", "description": "Label letter-spacing. No system semantic token exists; escape hatch with literal fallback." }, { "name": "--run-nav-link-group-label-text-transform", "default": "uppercase", "description": "Label `text-transform`. Default skin applies uppercase; wireframe skin overrides to `none` directly within skin scope." }, { "name": "--run-nav-link-group-background", "default": "transparent", "description": "Group container background. Default is transparent; consumer-owned filled-surface theming hook." }, { "name": "--run-nav-link-group-divider-color", "default": "var(--run-color-border-subtle)", "description": "Divider color token EXPOSED for consumer use. The component itself does NOT apply `border-block-start` — adjacent-group dividers are consumer-owned." } ], "cssParts": [ { "name": "label", "description": "The group's accessible-name region. Present in shadow DOM only when `[has-label]` is set. Targetable for typography overrides." }, { "name": "items", "description": "The flex container that lays out slotted child link elements. Always present in shadow DOM, even when `[empty]`. Targetable for layout overrides." } ] } ], "exports": [ { "kind": "js", "name": "RunNavLinkGroup", "declaration": { "name": "RunNavLinkGroup", "module": "components/design-system/nav-link-group/run-nav-link-group.js" } }, { "kind": "custom-element-definition", "name": "run-nav-link-group", "declaration": { "name": "RunNavLinkGroup", "module": "components/design-system/nav-link-group/run-nav-link-group.js" } } ] }, { "kind": "javascript-module", "path": "components/design-system/nav-mega-nav/run-mega-nav.js", "declarations": [ { "kind": "class", "name": "RunMegaNav", "tagName": "run-mega-nav", "superclass": { "name": "RunElement", "module": "shared/run-element.js" }, "summary": "Compound-Interactive web component: ", "attributes": [ { "name": "expanded-panel", "type": { "text": "string \\| null" }, "default": "null", "description": "ID of currently expanded panel. Unmatched IDs coerce silently to `null`. Single-panel-open invariant enforced.", "fieldName": "expandedPanel" }, { "name": "mode", "type": { "text": "string" }, "default": "'auto'", "description": "Display mode. One of: `MEGA_NAV_MODES`. Unrecognized values coerce to `'auto'`.", "fieldName": "mode" }, { "name": "sticky", "type": { "text": "boolean" }, "default": "false", "description": "When true, the bar sticks to the viewport top on scroll.", "fieldName": "sticky" }, { "name": "elevated", "type": { "text": "boolean" }, "default": "false", "description": "When true, applies an elevation shadow to the bar.", "fieldName": "elevated" }, { "name": "trigger", "type": { "text": "string" }, "default": "'hover-and-click'", "description": "Panel activation behavior. One of: `MEGA_NAV_TRIGGERS`. Unrecognized values coerce to `'hover-and-click'`.", "fieldName": "trigger" }, { "name": "close-on-route-change", "type": { "text": "boolean" }, "default": "true", "description": "When true, closes any open panel/drawer on navigation (`popstate`/`pushstate`).", "fieldName": "closeOnRouteChange" }, { "name": "label", "type": { "text": "string" }, "default": "''", "description": "Accessible label for the inner `