feat: add plot/vega/base/spec2svg-file

[gururaj1512]

---

type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes. report:

• task: lint_filenames status: passed
• task: lint_editorconfig status: passed
• task: lint_markdown_pkg_readmes status: na
• task: lint_markdown_docs status: na
• task: lint_markdown status: na
• task: lint_package_json status: passed
• task: lint_repl_help status: na
• task: lint_javascript_src status: passed
• task: lint_javascript_cli status: na
• task: lint_javascript_examples status: na
• task: lint_javascript_tests status: na
• task: lint_javascript_benchmarks status: na
• task: lint_python status: na
• task: lint_r status: na
• task: lint_c_src status: na
• task: lint_c_examples status: na
• task: lint_c_benchmarks status: na
• task: lint_c_tests_fixtures status: na
• task: lint_shell status: na
• task: lint_typescript_declarations status: passed
• task: lint_typescript_tests status: na
• task: lint_license_headers status: passed ---

Resolves None

Description

What is the purpose of this pull request?

This pull request:

• feat: add plot/vega/base/spec2svg-file

Related Issues

Does this pull request have any related issues?

This pull request has the following related issues:

• None

Questions

Any questions for reviewers of this pull request?

No.

Other

Any other information relevant to this pull request? This may include screenshots, references, and/or implementation notes.

No.

Checklist

Please ensure the following tasks are completed before submitting this pull request.

• Read, understood, and followed the contributing guidelines.

AI Assistance

When authoring the changes proposed in this PR, did you use any kind of AI assistance?

• Yes
• No

If you answered "yes" above, how did you use AI assistance?

• Code generation (e.g., when writing an implementation or fixing a bug)
• Test/benchmark generation
• Documentation (including examples)
• Research and understanding

Disclosure

If you answered "yes" to using AI assistance, please provide a short disclosure indicating how you used AI assistance. This helps reviewers determine how much scrutiny to apply when reviewing your contribution. Example disclosures: "This PR was written primarily by Claude Code." or "I consulted ChatGPT to understand the codebase, but the proposed changes were fully authored manually by myself.".

I took assistance from Claude to work on this script. Thought about this approach prior and worked with claude to implement and document.

---

@stdlib-js/reviewers

[kgryte]

This is a modern Node.js API. We'll need to think about how to support in a backward-compatible way.

[kgryte]

Is there a reason why we should be creating directories at all? My sense is that should be done in user land and we shouldn't be guessing what the user wants.

If they want to create a nested directory, they can do that before they ever call this function.

[gururaj1512]

Agreed, removed the directory auto-creation logic entirely. The output directory is now expected to exist beforehand; if it doesn't, writeFileSync will return an ENOENT error.

[kgryte]

You should be using the async API here. Otherwise, you are mixing async/sync, with the latter blocking the thread.

[kgryte]

This is not ideal as, during doctesting, this file will be written and then potentially committed.

In fs/write-file (ref: https://github.com/stdlib-js/stdlib/blob/bd358c950c73dff39b26630b37fe129b5dc11afd/lib/node_modules/%40stdlib/fs/write-file/lib/index.js), we get around this, as we don't recursively make directories, so the examples always error.

Here, if we actually want to write a file, we should use os/tmpdir to write to the host's temporary directory.

That said, I am not convinced that we should be automatically recursively creating directories.

[gururaj1512]

Yup, Came across a issue where output.svg was being created automatically in root here. Now updated the example to use @stdlib/os/tmpdir so doctesting writes to the host's temporary directory rather than the working directory. Also removed the recursive directory creation entirely.

[kgryte]

Why the argument order here? This differs from fs/write-file where the output filename comes first and then the data.

[gururaj1512]

No specific reason here. Refactored accoring to fs/write-file.