File size: 1,747 Bytes
5befefa
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
import Container from './container.js'
import Node, { NodeProps } from './node.js'

declare namespace Comment {
  export interface CommentRaws extends Record<string, unknown> {
    /**

     * 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 {
    /** Information used to generate byte-to-byte equal node string as it was in the origin input. */
    raws?: CommentRaws
    /** Content of the comment. */
    text: string
  }

  export { Comment_ as default }
}

/**

 * It represents a class that handles

 * [CSS comments](https://developer.mozilla.org/en-US/docs/Web/CSS/Comments)

 *

 * ```js

 * Once (root, { Comment }) {

 *   const note = new Comment({ text: 'Note: …' })

 *   root.append(note)

 * }

 * ```

 *

 * Remember that CSS comments inside selectors, at-rule parameters,

 * or declaration values will be stored in the `raws` properties

 * explained above.

 */
declare class Comment_ extends Node {
  parent: Container | undefined
  raws: Comment.CommentRaws
  type: 'comment'
  /**

   * The comment's text.

   */
  get text(): string

  set text(value: string)

  constructor(defaults?: Comment.CommentProps)
  assign(overrides: Comment.CommentProps | object): this
  clone(overrides?: Partial<Comment.CommentProps>): this
  cloneAfter(overrides?: Partial<Comment.CommentProps>): this
  cloneBefore(overrides?: Partial<Comment.CommentProps>): this
}

declare class Comment extends Comment_ {}

export = Comment