52 lines
1.1 KiB
TypeScript
52 lines
1.1 KiB
TypeScript
|
import Node, { NodeProps } from './node.js'
|
|||
|
|
|
|||
|
|
interface CommentRaws {
|
|||
|
|
/**
|
|||
|
|
* The space symbols before the node.
|
|||
|
|
*/
|
|||
|
|
before?: string
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* The space symbols between `/*` and the comment’s text.
|
|||
|
|
*/
|
|||
|
|
left?: string
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* The space symbols between the comment’s text.
|
|||
|
|
*/
|
|||
|
|
right?: string
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
export interface CommentProps extends NodeProps {
|
|||
|
|
text: string
|
|||
|
|
raws?: CommentRaws
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Represents a comment between declarations or statements (rule and at-rules).
|
|||
|
|
*
|
|||
|
|
* ```js
|
|||
|
|
* Once (root, { Comment }) {
|
|||
|
|
* let note = new Comment({ text: 'Note: …' })
|
|||
|
|
* root.append(note)
|
|||
|
|
* }
|
|||
|
|
* ```
|
|||
|
|
*
|
|||
|
|
* Comments inside selectors, at-rule parameters, or declaration values
|
|||
|
|
* will be stored in the `raws` properties explained above.
|
|||
|
|
*/
|
|||
|
|
export default class Comment extends Node {
|
|||
|
|
type: 'comment'
|
|||
|
|
raws: CommentRaws
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* The comment's text.
|
|||
|
|
*/
|
|||
|
|
text: string
|
|||
|
|
|
|||
|
|
constructor(defaults?: CommentProps)
|
|||
|
|
clone(overrides?: Partial<CommentProps>): this
|
|||
|
|
cloneBefore(overrides?: Partial<CommentProps>): this
|
|||
|
|
cloneAfter(overrides?: Partial<CommentProps>): this
|
|||
|
|
}
|