Merge pull request #2 from OpenDucks/fix-docs-parser

v1.3.0

Author: bryan-ente

CHANGELOG.md

@@ -1,5 +1,47 @@
 # CHANGELOG.md
 
+## v1.3.0
+
+- Added support for `@title "..."` in shared `@tags_import` files so tag statistics outputs (`statistics`, `json`, `html`, `pdf`) can use a custom report title instead of the file path.
+- Added full tag statistics support for `@tag_sources` with structured outputs via:
+  - `protoparser tags <tags_file> statistics`
+  - `protoparser tags <tags_file> json`
+  - `protoparser tags <tags_file> html`
+  - `protoparser tags <tags_file> pdf`
+- Added support for cross-file tag statistics using multiple shared tag files with nested `@tags_import` references.
+- Updated tag statistics so local tag overrides inside referenced source `.pml` files are preserved and shown in the task entries.
+- Added general `.pml` cross-reference analysis via `protoparser analyze <pml_file> <format>` with local stats, resolved stats, content imports, tag imports and recursive reference trees.
+- Added output directory support via `protoparser <file> <format> <output_dir>` e.g. `protoparser test.pml html ./html`
+- Added automatic output subdirectories for documents that use `@import ... html` or `@import ... pml` so rendered files are written to folders like `html/test.html` instead of cluttering the source directory.
+- Added a complete example and feature test set under `examples/feature-suite/` including:
+  - 2 shared tag files
+  - 2 `.pml` files
+  - 1 imported `.html` file
+  - macro usage, imports, tags, nested tag analysis and local tag overrides
+- Updated `README.md` to document the new tag analysis, output handling and example usage.
+
+## v1.2.0
+
+- Added full parser support for `@tags` and `@tags_import`, including external tag merging and task tag resolution
+- Added `@protocol "..."` to customize the HTML document title and top page heading, with placeholder support such as `{{date}}`
+- Added `@meeting "..."` as a shorthand to set a custom rendered meeting section title while still opening the `@meeting` block
+- Added support for `@import` command to include external `.pml` or `.html` files into the current file. Example usage:
+  - Import file: `@import reference "fileName" type` e.g. `@import header "header.pml" pml`
+  - Output contents: `@@import=header` or `@@output=header`
+- When using the `@import` command, the imported `.pml` content will be merged into the current file and processed as if it were part of the original file. This allows for modularization and reuse of common components across multiple files.
+- Added support for `@protocol` and `@meeting` commands to allow customization.
+  - Example usage:
+    - `@protocol "Custom Protocol Title {{date}}"` to set a custom title for the protocol document, with support for placeholders like `{{date}}` which will be replaced with the current date.
+    - `@meeting "Custom Meeting Title"` to set a custom title for the meeting section while still opening the `@meeting` block for content.
+- Fixed an issue with the `@macro` loading command and the `--listMacros` command that could not properly process the `{{macro_dir}}` placeholder for loading macros from the default macro directory.
+
+## v1.1.2
+
+- Added `image` macro for embedding images. Supports local and remote images. Example usage:
+  - `@@macro=image:src=assets/logo.png`
+  - `@@macro=image:src=https://example.com/image.jpg`
+- Fixed an issue with comments being incorrectly or unintentionally parsed as content. Comments are now properly ignored or filtered during parsing.
+
 ## v1.1.1
 
 - Fixed an issue with the `--docs` command where it would not display documentation correctly.
@@ -14,4 +56,4 @@
 
 ## prior v1.0.6
 
-There was no CHANGELOG.md file before v1.0.6.
+There was no CHANGELOG.md file before v1.0.6.