Skip to content

Interface: ParseOptions

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

Options for parseCssDocs.

Extended by

Properties

configuration?

ts
optional configuration?: CssDocConfiguration;

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

The tag configuration (standard + custom tags, and which are supported). Defaults to a fresh CssDocConfiguration with every standard tag enabled — i.e. the full built-in vocabulary. Supply one (e.g. from @cssdoc/config) to register custom tags or disable standard ones.


fileName?

ts
optional fileName?: string;

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

The source file name to record on each entry's CssSource, enabling source links. The parser always records line/column; supply this to also record the file.


isRecordBoundary?

ts
optional isRecordBoundary?: (commentText) => string | undefined;

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

How records are delimited. By default a new record begins at any doc comment (/** … */) that carries an @component or @name tag, which is the recommended, framework-agnostic convention. Supply a custom test to split on something else (e.g. a per-component header comment).

Parameters

commentText

string

Returns

string | undefined


modifierConvention?

ts
optional modifierConvention?: ModifierConventionInput;

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

The modifier convention — how modifier classes are spelled (BEM .button--primary by default; rscss, bare, or a custom ModifierConvention for SUIT/CUBE/etc.). Overrides the configuration's convention when both are given.


parse?

ts
optional parse?: CssParse;

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

The PostCSS parser to read css with. Defaults to postcss.parse (plain CSS). Inject a dialect parser (e.g. postcss-scss/postcss-less via @cssdoc/dialects) to document .scss/.less.

Released under the MIT License