@ts-graphviz/ast 2.0.7 → 3.0.1

package/CHANGELOG.md

@@ -1,5 +1,172 @@
 # @ts-graphviz/ast
 
+## 3.0.1
+
+### Patch Changes
+
+- [#1480](https://github.com/ts-graphviz/ts-graphviz/pull/1480) [`ab5d0c7`](https://github.com/ts-graphviz/ts-graphviz/commit/ab5d0c75620a0fd1bf36373716b26c2d433a0bc6) Thanks [@kamiazya](https://github.com/kamiazya)! - Fix CI workflow to prevent publishing stable releases with @next tag
+
+- Updated dependencies [[`ab5d0c7`](https://github.com/ts-graphviz/ts-graphviz/commit/ab5d0c75620a0fd1bf36373716b26c2d433a0bc6)]:
+  - @ts-graphviz/common@3.0.1
+
+## 3.0.0
+
+### Major Changes
+
+- [#1363](https://github.com/ts-graphviz/ts-graphviz/pull/1363) [`9328563`](https://github.com/ts-graphviz/ts-graphviz/commit/932856396ed0dede1dfc6737344a628f9667d07c) Thanks [@kamiazya](https://github.com/kamiazya)! - 🚨 Breaking Changes: Drop Node.js 18 support
+
+  Minimum required version is now Node.js 20+
+
+  ### ESM-Only Distribution
+
+  - **Remove CommonJS builds**: All packages now distribute only ESM (ECMAScript Modules)
+  - **Package exports**: Removed `require` fields from `package.json` exports
+  - **Module type**: All packages are now `"type": "module"`
+
+  ## 🔄 Migration Guide
+
+  ### For ESM Projects (Recommended)
+
+  ```json
+  {
+    "type": "module"
+  }
+  ```
+
+  ```typescript
+  // Import syntax remains unchanged
+  import { Digraph, Node, Edge, toDot } from "ts-graphviz";
+  import { toFile } from "ts-graphviz/adapter";
+  import { parse } from "ts-graphviz/ast";
+  ```
+
+  ### For CommonJS Projects
+
+  If you are using CommonJS (CJS) and need to migrate to ESM, you will need to update your project to support dynamic imports. This is necessary because the packages no longer provide CommonJS builds.
+
+  ### Before (CJS)
+
+  ```javascript
+  // JavaScript (CommonJS)
+  function createGraph() {
+    // Dynamic import is required because the packages no longer provide CommonJS builds.
+    const { Digraph, Node, Edge, toDot } = require("ts-graphviz");
+    const graph = new Digraph();
+    return toDot(graph);
+  }
+  ```
+
+  ### After (ESM)
+
+  ```javascript
+  async function createGraph() {
+    const { Digraph, Node, Edge, toDot } = await import("ts-graphviz");
+
+    const graph = new Digraph();
+    // Create your graph...
+    return toDot(graph);
+  }
+  ```
+
+  ```typescript
+  // TypeScript (CommonJS)
+  // Update tsconfig.json
+  {
+    "compilerOptions": {
+      "module": "Node16",
+      "moduleResolution": "Node16"
+    }
+  }
+
+  // Use dynamic imports
+  async function createGraph() {
+    const tsGraphviz = await import('ts-graphviz');
+    const { Digraph, Node, Edge, toDot } = tsGraphviz;
+
+    const graph = new Digraph();
+    // Create your graph...
+    return toDot(graph);
+  }
+  ```
+
+  ## 🎯 Benefits
+
+  - **Modern JavaScript**: Leveraging native ES modules for better performance
+  - **Smaller bundle sizes**: ESM enables better tree-shaking
+  - **Future-proof**: Aligning with the JavaScript ecosystem direction
+  - **Better TypeScript support**: Enhanced module resolution
+
+- [#1363](https://github.com/ts-graphviz/ts-graphviz/pull/1363) [`9328563`](https://github.com/ts-graphviz/ts-graphviz/commit/932856396ed0dede1dfc6737344a628f9667d07c) Thanks [@kamiazya](https://github.com/kamiazya)! - Adjust HTML label AST handling for consistent behavior #1335
+
+  Improves the handling of HTML-like labels in the `fromDot` and `toDot` functions to ensure valid Dot output.
+
+### Minor Changes
+
+- [#1363](https://github.com/ts-graphviz/ts-graphviz/pull/1363) [`9328563`](https://github.com/ts-graphviz/ts-graphviz/commit/932856396ed0dede1dfc6737344a628f9667d07c) Thanks [@kamiazya](https://github.com/kamiazya)! - Define Supported environment and Support levels
+
+  To provide clarity on the environments in which ts-graphviz operates, we have categorized support levels:
+
+  ## Support Levels
+
+  ### Tier 1: Full Support
+
+  - **Definition**: Environments that are fully supported, with comprehensive automated testing and maintenance.
+  - **Environments**:
+    - **Node.js LTS versions**: All active Long-Term Support (LTS) versions.
+      - If a Node.js LTS version is released, we will ensure compatibility with it.
+      - If a Node.js LTS version is deprecated, we will drop support for it in the next major release.
+  - **Details**:
+    - We run automated tests on all LTS versions of Node.js.
+    - Full compatibility and performance are ensured.
+    - Critical issues are prioritized for fixes.
+
+  ### Tier 2: Active Support
+
+  - **Definition**: Environments that receive active support with limited automated testing.
+  - **Environments**:
+    - **Deno Latest LTS version**: The latest Long-Term Support (LTS) version of Deno.
+      - If a new Deno LTS version is released, we will ensure compatibility with it.
+      - If a Deno LTS version is deprecated, we will drop support for it in the next minor release.
+    - **Node.js Current Release**: The latest Node.js release outside the LTS schedule.
+      - If a new Node.js current release is available, we will ensure compatibility with it.
+      - If a Node.js current release is deprecated, we will drop support for it in the next minor release.
+  - **Details**:
+    - Compatibility is maintained, and issues are addressed.
+
+  ### Tier 3: Community Support
+
+  - **Definition**: Environments that are not officially tested but are supported on a best-effort basis.
+  - **Environments**:
+    - **Modern Browsers**: Latest versions of major browsers, including:
+      - Google Chrome
+      - Mozilla Firefox
+      - Microsoft Edge
+      - Apple Safari
+    - **Deno Current Release**: The latest Deno release outside the LTS schedule.
+  - **Details**:
+    - Installation methods are provided.
+    - No automated testing is performed.
+    - Issues reported by users will be addressed.
+    - Targeting the latest versions ensures compatibility with modern web standards.
+    - We will not actively test or maintain compatibility with older versions of browsers.
+
+### Patch Changes
+
+- [#1363](https://github.com/ts-graphviz/ts-graphviz/pull/1363) [`9328563`](https://github.com/ts-graphviz/ts-graphviz/commit/932856396ed0dede1dfc6737344a628f9667d07c) Thanks [@kamiazya](https://github.com/kamiazya)! - Update Develop Environment
+
+  - Drop turbo
+  - Upgrade biome to 2.0
+  - Upgrade TypeScript to 5.8
+  - Upgrade Vite to 7.0
+  - Upgrade Vitest to 3.2
+  - Upgrade Peggy to 5.0 and drop ts-pegjs
+  - Implement new E2E test workflow
+
+- [#1363](https://github.com/ts-graphviz/ts-graphviz/pull/1363) [`9328563`](https://github.com/ts-graphviz/ts-graphviz/commit/932856396ed0dede1dfc6737344a628f9667d07c) Thanks [@kamiazya](https://github.com/kamiazya)! - New GitHub Action main workflow and tests
+
+- Updated dependencies [[`9328563`](https://github.com/ts-graphviz/ts-graphviz/commit/932856396ed0dede1dfc6737344a628f9667d07c), [`9328563`](https://github.com/ts-graphviz/ts-graphviz/commit/932856396ed0dede1dfc6737344a628f9667d07c), [`9328563`](https://github.com/ts-graphviz/ts-graphviz/commit/932856396ed0dede1dfc6737344a628f9667d07c), [`9328563`](https://github.com/ts-graphviz/ts-graphviz/commit/932856396ed0dede1dfc6737344a628f9667d07c), [`9328563`](https://github.com/ts-graphviz/ts-graphviz/commit/932856396ed0dede1dfc6737344a628f9667d07c)]:
+  - @ts-graphviz/common@3.0.0
+
 ## 2.0.7
 
 ### Patch Changes

package/README.md

@@ -1,42 +1,147 @@
-# @ts-graphviz/ast
+<div align="center">
 
-> It is part of the ts-graphviz library, which is split into modular packages to improve maintainability, flexibility, and ease of use.
+[![Main](https://github.com/ts-graphviz/ts-graphviz/actions/workflows/main.yaml/badge.svg)](https://github.com/ts-graphviz/ts-graphviz/actions/workflows/main.yaml)
+[![CodeQL](https://github.com/ts-graphviz/ts-graphviz/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/ts-graphviz/ts-graphviz/actions/workflows/codeql-analysis.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/ts-graphviz/ts-graphviz/blob/main/LICENSE)
+[![All Contributors](https://img.shields.io/github/all-contributors/ts-graphviz/ts-graphviz?color=orange)](#contributors-)
+
+[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/8396/badge)](https://www.bestpractices.dev/projects/8396)
+[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/ts-graphviz/ts-graphviz/badge)](https://scorecard.dev/viewer/?uri=github.com/ts-graphviz/ts-graphviz)
+[![Tidelift](https://tidelift.com/badges/package/npm/ts-graphviz?style=flat)](https://tidelift.com/subscription/pkg/npm-ts-graphviz?utm_source=npm-ts-graphviz&utm_medium=readme)
+
+[![npm version](https://badge.fury.io/js/ts-graphviz.svg)](https://badge.fury.io/js/ts-graphviz)
+![node version](https://img.shields.io/node/v/ts-graphviz)
+[![deno version](https://img.shields.io/badge/deno-lts-black?logo=deno)](https://github.com/denoland/deno)
+[![npm](https://img.shields.io/npm/dm/ts-graphviz)](https://npmtrends.com/ts-graphviz)
+
+# @ts-graphviz/ast
 
 This package contains the module for processing the DOT language at the **A**bstract **S**yntax **T**ree (AST) level for the ts-graphviz library.
 
-## Features
+🔗
 
-- Parsing and generating DOT language ASTs
-- Functions for manipulating and transforming ASTs
-- Support for custom AST nodes and attributes
+[![GitHub](https://img.shields.io/badge/-GitHub-181717?logo=GitHub&style=flat)](https://github.com/ts-graphviz/ts-graphviz)
+[![npm](https://img.shields.io/badge/-npm-CB3837?logo=npm&style=flat)](https://www.npmjs.com/package/ts-graphviz)
+[![Reference](https://img.shields.io/badge/-API_Reference-3178C6?logo=TypeScript&style=flat&logoColor=fff)](https://ts-graphviz.github.io/ts-graphviz/)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/ts-graphviz/ts-graphviz)
 
-## Usage
+[![Sponsor](https://img.shields.io/badge/-GitHub%20Sponsor-fff?logo=GitHub%20Sponsors&style=flat)](https://github.com/sponsors/ts-graphviz)
+[![OpenCollective](https://img.shields.io/badge/-OpenCollective-7FADF2?logo=opencollective&style=flat&logoColor=white)](https://opencollective.com/ts-graphviz)
 
-Import the necessary functions and classes from the `@ts-graphviz/ast` package:
+[![format: Biome](https://img.shields.io/badge/format%20with-Biome-F7B911?logo=biome&style=flat)](https://biomejs.dev/)
+[![test: Vitest](https://img.shields.io/badge/tested%20with-Vitest-6E9F18?logo=vitest&style=flat)](https://vitest.dev/)
+[![build: Vite](https://img.shields.io/badge/build%20with-Vite-646CFF?logo=vite&style=flat)](https://rollupjs.org/)
 
-```ts
-import { parse, stringify } from '@ts-graphviz/ast';
-```
+</div>
 
-Use the imported items in your project to work with DOT language ASTs:
+---
 
-```ts
-const dotString = 'digraph G { A -> B; }';
-const ast = parse(dotString);
+> It is part of the ts-graphviz library, which is split into modular packages to improve maintainability, flexibility, and ease of use.
 
-const outputDotString = stringify(ast);
-console.log('Output DOT string:', outputDotString);
-```
 
-For more examples and usage details, please refer to the ts-graphviz documentation.
+## Overview
 
+This package is a foundational component of the ts-graphviz library that enables low-level manipulation of DOT language structures.
+It provides a parser that converts DOT language strings into AST nodes and a stringifier that converts AST nodes back to DOT language.
 
-## Contributing
+## Main Functions
 
-Contributions to the ts-graphviz project are welcome.
+The AST package provides several key functions:
 
-Please refer to the main ts-graphviz repository for guidelines on how to contribute.
+- `parse(input: string, options?)`: Parses a DOT language string into an AST structure
+- `stringify(ast: ASTNode)`: Converts an AST structure to a DOT language string
+- `fromModel(model)`: Converts a Graph Model to an AST structure
+- `toModel(ast)`: Converts an AST structure to a Graph Model
 
-## License
+## Usage Examples
+
+### Parsing DOT Language
+
+```ts
+import { parse } from "@ts-graphviz/ast";
+
+const dotString = "digraph G { A -> B; }";
+const ast = parse(dotString);
+console.log(ast);
+// Output: A DotASTNode representing the DOT structure
+```
+
+### Generating DOT Language
+
+```ts
+import { parse, stringify } from "@ts-graphviz/ast";
+
+const dotString = "digraph G { A -> B; }";
+const ast = parse(dotString);
+// Modify the AST if needed
+const outputDotString = stringify(ast);
+console.log(outputDotString);
+// Output: "digraph G { A -> B; }"
+```
 
-This package is released under the MIT License.
+## Error Handling
+
+The package provides a specialized error class for handling syntax errors during parsing.
+
+When a parsing error occurs, the parser throws a `DotSyntaxError` with detailed information about the issue, which helps in debugging DOT language syntax problems.
+
+## Contributors 👥
+
+Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
+
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tbody>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="http://blog.kamiazya.tech/"><img src="https://avatars0.githubusercontent.com/u/35218186?v=4?s=100" width="100px;" alt="Yuki Yamazaki"/><br /><sub><b>Yuki Yamazaki</b></sub></a><br /><a href="https://github.com/ts-graphviz/ts-graphviz/commits?author=kamiazya" title="Code">💻</a> <a href="https://github.com/ts-graphviz/ts-graphviz/commits?author=kamiazya" title="Tests">⚠️</a> <a href="https://github.com/ts-graphviz/ts-graphviz/commits?author=kamiazya" title="Documentation">📖</a> <a href="#ideas-kamiazya" title="Ideas, Planning, & Feedback">🤔</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://laysent.com"><img src="https://avatars2.githubusercontent.com/u/1191606?v=4?s=100" width="100px;" alt="LaySent"/><br /><sub><b>LaySent</b></sub></a><br /><a href="https://github.com/ts-graphviz/ts-graphviz/issues?q=author%3Alaysent" title="Bug reports">🐛</a> <a href="https://github.com/ts-graphviz/ts-graphviz/commits?author=laysent" title="Tests">⚠️</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/elasticdotventures"><img src="https://avatars0.githubusercontent.com/u/35611074?v=4?s=100" width="100px;" alt="elasticdotventures"/><br /><sub><b>elasticdotventures</b></sub></a><br /><a href="https://github.com/ts-graphviz/ts-graphviz/commits?author=elasticdotventures" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/ChristianMurphy"><img src="https://avatars.githubusercontent.com/u/3107513?v=4?s=100" width="100px;" alt="Christian Murphy"/><br /><sub><b>Christian Murphy</b></sub></a><br /><a href="https://github.com/ts-graphviz/ts-graphviz/commits?author=ChristianMurphy" title="Code">💻</a> <a href="#ideas-ChristianMurphy" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/ts-graphviz/ts-graphviz/commits?author=ChristianMurphy" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/ArtemAdamenko"><img src="https://avatars.githubusercontent.com/u/2178516?v=4?s=100" width="100px;" alt="Artem"/><br /><sub><b>Artem</b></sub></a><br /><a href="https://github.com/ts-graphviz/ts-graphviz/issues?q=author%3AArtemAdamenko" title="Bug reports">🐛</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/fredericohpandolfo"><img src="https://avatars.githubusercontent.com/u/24229136?v=4?s=100" width="100px;" alt="fredericohpandolfo"/><br /><sub><b>fredericohpandolfo</b></sub></a><br /><a href="https://github.com/ts-graphviz/ts-graphviz/issues?q=author%3Afredericohpandolfo" title="Bug reports">🐛</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/diegoquinteiro"><img src="https://avatars.githubusercontent.com/u/1878108?v=4?s=100" width="100px;" alt="diegoquinteiro"/><br /><sub><b>diegoquinteiro</b></sub></a><br /><a href="https://github.com/ts-graphviz/ts-graphviz/issues?q=author%3Adiegoquinteiro" title="Bug reports">🐛</a></td>
+    </tr>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/robross0606"><img src="https://avatars.githubusercontent.com/u/2965467?v=4?s=100" width="100px;" alt="robross0606"/><br /><sub><b>robross0606</b></sub></a><br /><a href="#ideas-robross0606" title="Ideas, Planning, & Feedback">🤔</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://blake-regalia.net"><img src="https://avatars.githubusercontent.com/u/1456400?v=4?s=100" width="100px;" alt="Blake Regalia"/><br /><sub><b>Blake Regalia</b></sub></a><br /><a href="https://github.com/ts-graphviz/ts-graphviz/issues?q=author%3Ablake-regalia" title="Bug reports">🐛</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/bigbug"><img src="https://avatars.githubusercontent.com/u/27259?v=4?s=100" width="100px;" alt="bigbug"/><br /><sub><b>bigbug</b></sub></a><br /><a href="#question-bigbug" title="Answering Questions">💬</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/murawakimitsuhiro"><img src="https://avatars.githubusercontent.com/u/13833242?v=4?s=100" width="100px;" alt="mrwk"/><br /><sub><b>mrwk</b></sub></a><br /><a href="#question-murawakimitsuhiro" title="Answering Questions">💬</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/svdvonde"><img src="https://avatars.githubusercontent.com/u/2751783?v=4?s=100" width="100px;" alt="svdvonde"/><br /><sub><b>svdvonde</b></sub></a><br /><a href="#question-svdvonde" title="Answering Questions">💬</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/seethroughdev"><img src="https://avatars.githubusercontent.com/u/203779?v=4?s=100" width="100px;" alt="Adam"/><br /><sub><b>Adam</b></sub></a><br /><a href="#question-seethroughdev" title="Answering Questions">💬</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/trevor-scheer"><img src="https://avatars.githubusercontent.com/u/29644393?v=4?s=100" width="100px;" alt="Trevor Scheer"/><br /><sub><b>Trevor Scheer</b></sub></a><br /><a href="#a11y-trevor-scheer" title="Accessibility">️️️️♿️</a></td>
+    </tr>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://pre.ms"><img src="https://avatars.githubusercontent.com/u/238277?v=4?s=100" width="100px;" alt="Prem Pillai"/><br /><sub><b>Prem Pillai</b></sub></a><br /><a href="https://github.com/ts-graphviz/ts-graphviz/issues?q=author%3Acloud-on-prem" title="Bug reports">🐛</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/nagasawaryoya"><img src="https://avatars.githubusercontent.com/u/53528726?v=4?s=100" width="100px;" alt="nagasawaryoya"/><br /><sub><b>nagasawaryoya</b></sub></a><br /><a href="https://github.com/ts-graphviz/ts-graphviz/commits?author=nagasawaryoya" title="Code">💻</a> <a href="https://github.com/ts-graphviz/ts-graphviz/commits?author=nagasawaryoya" title="Tests">⚠️</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/tokidrill"><img src="https://avatars.githubusercontent.com/u/42460318?v=4?s=100" width="100px;" alt="YukiSasaki"/><br /><sub><b>YukiSasaki</b></sub></a><br /><a href="https://github.com/ts-graphviz/ts-graphviz/commits?author=tokidrill" title="Code">💻</a> <a href="https://github.com/ts-graphviz/ts-graphviz/commits?author=tokidrill" title="Tests">⚠️</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Madd0g"><img src="https://avatars.githubusercontent.com/u/1171003?v=4?s=100" width="100px;" alt="Madd0g"/><br /><sub><b>Madd0g</b></sub></a><br /><a href="https://github.com/ts-graphviz/ts-graphviz/issues?q=author%3AMadd0g" title="Bug reports">🐛</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/j4k0xb"><img src="https://avatars.githubusercontent.com/u/55899582?v=4?s=100" width="100px;" alt="j4k0xb"/><br /><sub><b>j4k0xb</b></sub></a><br /><a href="https://github.com/ts-graphviz/ts-graphviz/issues?q=author%3Aj4k0xb" title="Bug reports">🐛</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/haved"><img src="https://avatars.githubusercontent.com/u/3748845?v=4?s=100" width="100px;" alt="HKrogstie"/><br /><sub><b>HKrogstie</b></sub></a><br /><a href="https://github.com/ts-graphviz/ts-graphviz/issues?q=author%3Ahaved" title="Bug reports">🐛</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/septatrix"><img src="https://avatars.githubusercontent.com/u/24257556?v=4?s=100" width="100px;" alt="Nils K"/><br /><sub><b>Nils K</b></sub></a><br /><a href="https://github.com/ts-graphviz/ts-graphviz/issues?q=author%3Aseptatrix" title="Bug reports">🐛</a></td>
+    </tr>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/hao2013"><img src="https://avatars.githubusercontent.com/u/67059492?v=4?s=100" width="100px;" alt="hao2013"/><br /><sub><b>hao2013</b></sub></a><br /><a href="#maintenance-hao2013" title="Maintenance">🚧</a> <a href="https://github.com/ts-graphviz/ts-graphviz/pulls?q=is%3Apr+reviewed-by%3Ahao2013" title="Reviewed Pull Requests">👀</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="http://www.walterra.dev"><img src="https://avatars.githubusercontent.com/u/230104?v=4?s=100" width="100px;" alt="Walter Rafelsberger"/><br /><sub><b>Walter Rafelsberger</b></sub></a><br /><a href="#question-walterra" title="Answering Questions">💬</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/grsjst"><img src="https://avatars.githubusercontent.com/u/4739018?v=4?s=100" width="100px;" alt="grsjst"/><br /><sub><b>grsjst</b></sub></a><br /><a href="https://github.com/ts-graphviz/ts-graphviz/issues?q=author%3Agrsjst" title="Bug reports">🐛</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/stephenirven"><img src="https://avatars.githubusercontent.com/u/4293560?v=4?s=100" width="100px;" alt="Steve"/><br /><sub><b>Steve</b></sub></a><br /><a href="https://github.com/ts-graphviz/ts-graphviz/issues?q=author%3Astephenirven" title="Bug reports">🐛</a></td>
+    </tr>
+  </tbody>
+</table>
+
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->
+
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+
+This project follows the [all-contributors](https://github.com/all-contributors/all-contributors)
+specification. Contributions of any kind welcome!
+
+## Changelog 📜
+
+See [CHANGELOG.md](https://github.com/ts-graphviz/ts-graphviz/blob/main/packages/ast/CHANGELOG.md) for more details.
+
+## License ⚖️
+
+This software is released under the MIT License, see [LICENSE](https://github.com/ts-graphviz/ts-graphviz/blob/main/LICENSE).

package/lib/ast.d.ts

@@ -6,6 +6,7 @@ import { EdgeModel } from '@ts-graphviz/common';
 import { ModelsContext } from '@ts-graphviz/common';
 import { NodeModel } from '@ts-graphviz/common';
 import { RootGraphModel } from '@ts-graphviz/common';
+import { StartRuleNames } from './_parse.js';
 import { SubgraphModel } from '@ts-graphviz/common';
 
 /**
@@ -759,7 +760,6 @@ export declare interface NodeRefGroupASTPropaties extends ASTCommonPropaties {
       * @param context PrintContext object
       * @param ast an ASTNode
       * @returns printed string
-      * @memberof PrintPlugin
       */
      print(context: PrintContext, ast: T): Generator<string>;
  }
@@ -767,7 +767,7 @@ export declare interface NodeRefGroupASTPropaties extends ASTCommonPropaties {
  /**
   * @group Convert DOT to AST
   */
- export declare type Rule = 'Dot' | 'Graph' | 'Node' | 'Edge' | 'AttributeList' | 'Attribute' | 'Subgraph' | 'ClusterStatements';
+ export declare type Rule = StartRuleNames;
 
  /**
   * @group AST