Document new parameters in Harness.output(), _render(), and parse()

Addresses gemini-code-assist feedback on
#3 — template_dir was
missing from the docstrings of Harness.output(), Harness._render(),
and wireviz.parse(). Expanded scope to also document the parameters
that earlier PRs in this chain added without docstring coverage:

* Harness.output(): Args section now describes filename (incl. None →
  stdout semantics), fmt (incl. str→tuple normalization), output_dir,
  output_name, and template_dir; view/cleanup are noted as kept for API
  compat.
* Harness._render(): Args + Returns sections describing fmt,
  output_dir, output_name, template_dir, and the bytes-vs-str
  per-format return contract.
* wireviz.parse(): source_path (added during PR #1's loopback fix and
  threaded through PR #2's stdin/stdout port) and template_dir (this
  PR) added to the Args section, with template-search-priority
  semantics spelled out.

No behavior change. Verified against build_examples.py: deterministic
outputs unchanged.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: SomethingNew71

src/wireviz/Harness.py

@@ -687,6 +687,26 @@ def output(
         ``filename`` is None, exactly one format must be requested and
         its bytes/text are written to stdout — supports piping the CLI
         into other tools.
+
+        Args:
+            filename: Output base path (without extension). ``None``
+                routes a single format to stdout instead of writing files.
+            fmt: One or more formats from ``html``, ``png``, ``svg``,
+                ``gv``, ``tsv``, ``csv``, ``pdf``. A bare string is
+                normalized to a one-tuple.
+            view: Reserved (unused — kept for API compatibility with the
+                pre-refactor signature).
+            cleanup: Reserved (unused — kept for API compatibility).
+            output_dir: Output directory. Used only to populate the
+                ``<!-- %filename% -->`` HTML template placeholder and to
+                resolve a custom ``metadata.template.name`` reference.
+            output_name: Output base name (without extension). Used only
+                to populate the ``<!-- %filename_stem% -->`` HTML
+                template placeholder.
+            template_dir: Explicit directory to search first when
+                resolving a ``metadata.template.name`` reference. Falls
+                through to the YAML source directory, then ``output_dir``,
+                then the built-in templates shipped with WireViz.
         """
         if isinstance(fmt, str):
             fmt = (fmt,)
@@ -737,6 +757,26 @@ def _render(
         Pipes graphviz once per binary output rather than via ``render()``
         + temporary files so the caller can write files OR pipe to stdout
         without the SVG-file roundtrip the previous implementation used.
+
+        Args:
+            fmt: One or more formats from ``html``, ``png``, ``svg``,
+                ``gv``, ``tsv``. ``csv`` and ``pdf`` are recognized at
+                the dispatch layer but not produced here. A bare string
+                is normalized to a one-tuple.
+            output_dir: Forwarded to ``generate_html_output`` for
+                ``<!-- %filename% -->`` and ``<!-- %diagram_png_b64% -->``
+                template-placeholder resolution, and as the third-priority
+                directory in the custom-template search path.
+            output_name: Forwarded to ``generate_html_output`` for
+                ``<!-- %filename_stem% -->`` resolution.
+            template_dir: Forwarded to ``generate_html_output`` as the
+                first-priority directory in the custom-template search
+                path.
+
+        Returns:
+            ``{format: bytes|str}``. Binary formats (``png``) yield
+            bytes; text formats (``svg``, ``html``, ``gv``, ``tsv``)
+            yield str.
         """
         if isinstance(fmt, str):
             fmt = (fmt,)

src/wireviz/wireviz.py

@@ -77,6 +77,17 @@ def parse(
             Paths to use when resolving any image paths included in the data.
             Note: If inp is a path to a YAML file,
             its parent directory will automatically be included in the list.
+        source_path (Path | str, optional):
+            Path of the originating YAML file when ``inp`` is a string or dict.
+            Used to: (1) resolve a custom ``metadata.template.name`` reference
+            against the source's directory, and (2) resolve relative
+            ``<image src=...>`` paths embedded in graphviz output.
+            When ``inp`` is itself a Path, this is filled in automatically.
+        template_dir (Path | str, optional):
+            Explicit first-priority directory to search when resolving a
+            ``metadata.template.name`` reference. Searched before the YAML
+            source directory and the output directory; the built-in
+            templates ship as the final fallback.
 
     Returns:
         Depending on the return_types parameter, may return: