docs: update docs for v7

Author: shellscape

.npmrc

@@ -0,0 +1,4 @@
+//registry.npmjs.org/:_authToken=${NPM_TOKEN}
+
+# npm options
+auth-type=legacy

README.md

@@ -14,6 +14,8 @@
 A CSS property value parser built upon [PostCSS](https://github.com/postcss/postcss),
 following the same node and traversal patterns as PostCSS.
 
+This package powers part of [Prettier](https://prettier.io/). Please consider becoming a sponsor if you find this package useful or are a Prettier user. https://github.com/sponsors/shellscape
+
 ## Install
 
 Using npm:
@@ -22,12 +24,6 @@ Using npm:
 npm install postcss-values-parser --save-dev
 ```
 
-<a href="https://www.patreon.com/shellscape">
-  <img src="https://c5.patreon.com/external/logo/become_a_patron_button@2x.png" width="160">
-</a>
-
-Please consider [becoming a patron](https://www.patreon.com/shellscape) if you find this module useful.
-
 ## Requirements
 
 `postcss-values-parser` Node version v6.14.0+ and PostCSS v7.0.0+.
@@ -44,26 +40,7 @@ Please consider [becoming a patron](https://www.patreon.com/shellscape) if you f
 
 ## Usage
 
-Using the parser is straightforward and minimalistic:
-
-```js
-const { parse } = require('postcss-values-parser');
-
-const root = parse('#fff');
-const node = root.first;
-
-// → Word {
-//     raws: { before: '', after: '' },
-//     value: '#fff',
-//     type: 'word',
-//     isHex: true,
-//     isColor: true,
-//     isVariable: false,
-//     ...
-//   }
-```
-
-Please see the [Documentation](./docs/README.md) for further information on using the module.
+Please see the [Documentation](./docs/README.md) for general use and further information on using the package.
 
 ## Meta
 

dist/index.d.ts

@@ -1,5 +1,6 @@
 import { ParseOptions } from './parser.js';
 import { stringify } from './stringify.js';
+export { ParseError, AstError } from './errors.js';
 export { registerWalkers } from './walker.js';
 export { ParseOptions } from './parser.js';
 export * from './nodes/index.js';

dist/index.js

@@ -1,6 +1,6 @@
 # Comment Node
 
-The `Comment` node inherits directly from `Comment` in PostCSS. This node represents a CSS comment; either inline (`//`) or block (`/* */`).
+The `Comment` node inherits directly from `Node` in PostCSS. This node represents a CSS comment; either inline (`//`) or block (`/* */`).
 
 ## Properties
 
@@ -10,6 +10,12 @@ Type: `Boolean`<br>
 
 If `true`, indicates that the type of comment is "inline," or a comment that begins with `//`. If `false`, indicates that the comment is a traditional block comment.
 
+### `text`
+
+Type: `String`<br>
+
+A `String` representation of the body of the comment, with comment markers removed and trimmed.
+
 ### `type`
 
 Type: `String`
@@ -19,7 +25,7 @@ Value: `'comment'`
 
 Type: `String`<br>
 
-A `String` representation of the body of the comment.
+A `String` representation of the original comment including comment markers.
 
 ## Example Values
 

dist/index.js.map

@@ -0,0 +1,112 @@
+# Container Node
+
+The `Container` node inherits directly from `Container` in PostCSS. This node serves as a base class for nodes that can contain other nodes as children. It provides functionality for managing child nodes and traversing the AST.
+
+## Properties
+
+### `nodes`
+
+Type: `Array`<br>
+
+An array of child nodes contained within this container. These can be any type of node including other containers.
+
+### `type`
+
+Type: `String`<br>
+
+The type of the container node. This is set by the specific container implementation.
+
+### `value`
+
+Type: `String`<br>
+
+A `String` representation of the container's value. This is typically set during construction and provides context about the container's content.
+
+## Methods
+
+### `add(node)`
+
+Adds a child node to this container.
+
+#### Parameters
+
+#### `node`
+
+Type: `Node|Container`<br>
+_Required_
+
+The node to add as a child of this container.
+
+### `toString(stringifier)`
+
+Converts the container and all its children to a string representation.
+
+#### Parameters
+
+#### `stringifier`
+
+Type: `Stringifier`<br>
+_Optional_
+
+A custom stringifier function. If not provided, uses the default stringify function.
+
+## Inherited Properties
+
+This class inherits all properties and methods from PostCSS's `Container` class. Please see the [PostCSS Documentation](https://github.com/postcss/postcss/tree/master/docs) for additional methods and properties.
+
+## Example Usage
+
+```js
+const { parse } = require('postcss-values-parser');
+
+const root = parse('calc(100px + 20%)');
+const func = root.nodes[0]; // This is a Func node, which extends Container
+
+// Access child nodes
+console.log(func.nodes); // Array of nodes representing the calc() parameters
+
+// Add a new node
+const word = new Word({ value: 'test' });
+func.add(word);
+```
+
+## Walker Methods
+
+Container nodes have access to all walker methods for traversing their child nodes and descendants. These methods allow you to find and iterate over specific node types within the container:
+
+- `walkFuncs(callback)` - Walk through all function nodes
+- `walkWords(callback)` - Walk through all word nodes
+- `walkNumerics(callback)` - Walk through all numeric nodes
+- `walkOperators(callback)` - Walk through all operator nodes
+- `walkQuoteds(callback)` - Walk through all quoted string nodes
+- `walkUnicodeRanges(callback)` - Walk through all unicode range nodes
+- `walkComments(callback)` - Walk through all comment nodes
+- `walkPunctuations(callback)` - Walk through all punctuation nodes
+- `walkType(type, callback)` - Walk through all nodes of a specific type
+
+```js
+const { parse } = require('postcss-values-parser');
+
+const root = parse('calc(100px + 20%) url("image.jpg")');
+const func = root.nodes[0]; // calc function
+
+// Walk through numeric nodes within the function
+func.walkNumerics((node) => {
+  console.log(`${node.value}${node.unit}`);
+});
+
+// Walk through all words in the entire tree
+root.walkWords((node) => {
+  console.log(`Word: ${node.value}`);
+});
+```
+
+See the [Walker](./Walker.md) documentation for more details on walker methods.
+
+## Notes
+
+- Container nodes automatically handle source mapping and position tracking when nodes are added
+- Child nodes maintain references to their parent container
+- The Container class provides the foundation for complex nodes like `Func`, `Root`, and `Parentheses`
+- Walker methods are registered automatically when the module is loaded
+- Walker methods traverse all descendants, not just direct children