Advanced

Parser Internals

The parser entry is:

src/parser/parseCurveaScriptFile.js

The exported function is:

parseCurveaScriptFile(source)

Returned structure

The parser returns an object with fields such as:

{
  kind,
  name,
  props,
  layout,
  imports,
  loads,
  paginate,
  data,
  seo,
  styles,
  scripts,
  body
}

The parser recognizes:

@page
@layout Name(...)
@component Name(...)
@document

Only one declaration is allowed.

The parser recognizes page layout usage through:

@use Main(title=page.title)

Only one @use directive is allowed in a page.

The parser only treats several directives specially when flowDepth === 0.

This prevents directives inside @if and @for blocks from being incorrectly extracted as file-level directives.

The parser handles block directives such as:

@data
@end

@seo
@end

@style
@end

@script
@end

The parser preserves @code ... @endcode blocks in the body so the resolver can protect them later.

The parser throws errors for:

1 min read