Skip to content

Interface: ParseOptions ​

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

Options for parseCssDocs.

Extended by ​

Properties ​

configuration? ​

ts
optional configuration?: CssDocConfiguration;

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

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:497

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:475

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:487

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:492

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