Skip to content

Interface: CssDocEntry

Defined in: packages/core/src/model.ts:343

One documented CSS record: its base class plus everything derived from the CSS + doc comments.

Properties

accessibility?

ts
optional accessibility?: string;

Defined in: packages/core/src/model.ts:365

Accessibility guidance, from @a11y/@accessibility.


animations

ts
animations: CssAnimation[];

Defined in: packages/core/src/model.ts:402

Animations (@keyframes) this component exposes.


annotations

ts
annotations: CssAnnotation[];

Defined in: packages/core/src/model.ts:431

Local annotation legend rows from @annotations, in author order.


className

ts
className: string;

Defined in: packages/core/src/model.ts:351

The base CSS selector — a class (.button), attribute ([data-layout="x"]), ID (#foo), or shadow-DOM pseudo (:host) — inferred from the first bare-class rule or set explicitly via @selector. Always non-empty (falls back to .${name} when inference fails).


compat

ts
compat: string[];

Defined in: packages/core/src/model.ts:437

Browser-support / feature-compatibility notes from @compat.


conditions

ts
conditions: CssCondition[];

Defined in: packages/core/src/model.ts:406

Conditional-support blocks (@container/@supports/@media) the rules sit under.


cssPropertiesConsumed

ts
cssPropertiesConsumed: CssTokenConsumed[];

Defined in: packages/core/src/model.ts:396

Design tokens this component consumes: every --* custom property referenced via var(...) inside its rules, each annotated with @tokens prose where authored (and including any @tokens-declared token not literally found via var()).


cssPropertiesDeclared

ts
cssPropertiesDeclared: CssPropertyDeclared[];

Defined in: packages/core/src/model.ts:398

Custom properties this component declares (@property) or documents (@cssproperty).


customBlocks?

ts
optional customBlocks?: Record<string, string[]>;

Defined in: packages/core/src/model.ts:455

Content of registered custom (block) tags, keyed by tag name without its @. Populated only for tags added via configuration; unregistered unknown tags are ignored. Absent when none were found.


decorators

ts
decorators: CssDecorator[];

Defined in: packages/core/src/model.ts:435

Record-level object-model decorators.


demo?

ts
optional demo?: string;

Defined in: packages/core/src/model.ts:423

@demo <spec> (e.g. self:button), when authored.


deprecated?

ts
optional deprecated?: string;

Defined in: packages/core/src/model.ts:425

Component-level deprecation replacement text, when authored (the argument to a @deprecated tag).


elements?

ts
optional elements?: CssElementConstraints;

Defined in: packages/core/src/model.ts:385

Allowed HTML elements from @element (default + optional named profiles).


examples

ts
examples: string[];

Defined in: packages/core/src/model.ts:408

@example blocks, verbatim.


functions

ts
functions: CssFunction[];

Defined in: packages/core/src/model.ts:400

CSS custom functions (@function) this component defines.


global?

ts
optional global?: boolean;

Defined in: packages/core/src/model.ts:371

Set when this record carries a @global tag — its modifiers (and per-modifier @global flags) apply to any component/layout/rule/declaration, not just this record's base class. Used during validation and consumption checks to resolve modifier matches globally.


group?

ts
optional group?: string;

Defined in: packages/core/src/model.ts:363

A documentation group/category, from @group/@category.


kind

ts
kind: CssRecordKind;

Defined in: packages/core/src/model.ts:347

Which kind of CSS surface this documents (defaults to component).


layers

ts
layers: CssLayer[];

Defined in: packages/core/src/model.ts:404

Cascade layers (@layer) this component participates in.


memberDeclarations?

ts
optional memberDeclarations?: CssMemberDeclaration[];

Defined in: packages/core/src/model.ts:448

Structured parent-side member declarations from repeated @member tags.


memberOf?

ts
optional memberOf?: CssMemberOf;

Defined in: packages/core/src/model.ts:444

Declared family membership from @memberOf — this record is a member of another named record, optionally private (must only ever appear inside that parent). Absent when not authored.


members?

ts
optional members?: string[];

Defined in: packages/core/src/model.ts:446

Member record names from @members — the inverse direction, declared on the parent.


modifiers

ts
modifiers: CssModifier[];

Defined in: packages/core/src/model.ts:373

AST-extracted modifiers, annotated with @modifier prose where authored.


name

ts
name: string;

Defined in: packages/core/src/model.ts:345

The record name from @component/@utility/@rule/@declaration/@name, e.g. button.


parts

ts
parts: CssPart[];

Defined in: packages/core/src/model.ts:375

AST-extracted sub-element parts (class-based), annotated with @part prose where authored.


privateRemarks?

ts
optional privateRemarks?: string;

Defined in: packages/core/src/model.ts:357

Internal-only prose from @privateRemarks (emitters may choose to omit it from public output).


pseudoElements

ts
pseudoElements: CssPseudoElement[];

Defined in: packages/core/src/model.ts:379

Native pseudo-elements the component styles (::before, ::marker, …), from @pseudo or a selector.


refs

ts
refs: number[];

Defined in: packages/core/src/model.ts:433

Local annotation references from @ref, in author order.


ts
related: CssRelated[];

Defined in: packages/core/src/model.ts:439

Related components from @related.


releaseStage?

ts
optional releaseStage?: CssReleaseStage;

Defined in: packages/core/src/model.ts:359

The release stage from a modifier flag tag (@alpha/@beta/@experimental/@internal/@public).


remarks?

ts
optional remarks?: string;

Defined in: packages/core/src/model.ts:355

Extended prose from @remarks.


see

ts
see: string[];

Defined in: packages/core/src/model.ts:427

@see <ref> cross-references.


shadowParts

ts
shadowParts: CssPart[];

Defined in: packages/core/src/model.ts:377

Shadow-DOM exposed parts (::part(name)), from @csspart or a ::part() selector.


since?

ts
optional since?: string;

Defined in: packages/core/src/model.ts:361

Version introduced, from @since.


slots

ts
slots: CssSlot[];

Defined in: packages/core/src/model.ts:383

Named slots the component shell exposes, from @slot.


source?

ts
optional source?: CssSource;

Defined in: packages/core/src/model.ts:450

Where the record was authored, when position info is available (for source links).


states

ts
states: CssState[];

Defined in: packages/core/src/model.ts:381

States the component reacts to, from @cssstate, :state(), pseudo-classes, or state classes.


structure?

ts
optional structure?: StructureNode[];

Defined in: packages/core/src/model.ts:414

The authored @structure element tree (top-level nodes), when present. When the @structure body uses @variant blocks (see structureVariants), this holds the first variant's nodes only, for back-compat with any code that hasn't been updated to read structureVariants.


structureDescription?

ts
optional structureDescription?: string;

Defined in: packages/core/src/model.ts:421

An optional prose description leading the @structure body, when authored.


structureVariants?

ts
optional structureVariants?: StructureVariant[];

Defined in: packages/core/src/model.ts:419

Alternative DOM shapes for this component, when the authored @structure body contains one or more top-level @variant blocks — absent for the common case of a single, non-variant structure.


summary?

ts
optional summary?: string;

Defined in: packages/core/src/model.ts:353

One-line summary from @summary.


todos

ts
todos: string[];

Defined in: packages/core/src/model.ts:390

Internal to-do notes, from @todo tags and /* @todo … */ inline comments. Development notes, not public API — emitters may omit them (like CssDocEntry.privateRemarks).


usage?

ts
optional usage?: string;

Defined in: packages/core/src/model.ts:429

Usage prose from @usage — how to include the stylesheet / use the component.

Released under the MIT License