feat: add ml/base/sgd/params/struct-factory

[nakul-krishnakumar]

---

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: passed
• task: lint_markdown_docs status: na
• task: lint_markdown status: na
• task: lint_package_json status: passed
• task: lint_repl_help status: passed
• task: lint_javascript_src status: passed
• task: lint_javascript_cli status: na
• task: lint_javascript_examples status: passed
• task: lint_javascript_tests status: passed
• task: lint_javascript_benchmarks status: passed
• 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: passed
• task: lint_license_headers status: passed ---

Resolves a part of #12875.

Description

What is the purpose of this pull request?

This pull request:

• Adds ml/base/sgd/params/struct-factory.

Related Issues

Does this pull request have any related issues?

This pull request has the following related issues:

• [RFC]: Add batch machine learning algorithms in Javascript and C (tracking issue) #12875

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.".

{{TODO: add disclosure if applicable}}

---

@stdlib-js/reviewers

[nakul-krishnakumar]

Currently blocked by #13712.

[stdlib-bot]

Coverage Report

No coverage information available.

[kgryte]

Here, you just need to link out to the package.

[loss function][@stdlib/ml/sgd/loss-functions] to be used.

We shouldn't explicitly enumerate as it just increases maintenance burden. What happens if we add a new loss function? Then we need to remember to come to this README to update. That is a recipe for drift.

[nakul-krishnakumar]

Yeah makes sense, thank you for pointing it out.

[kgryte]

Other than the README, this is coming along.

[kgryte]

Suggested change

	- **penaltyParams**: parameters specific to the regularization function being used. Must be a list having length `2`, with any unused elements set to zero. The expected list contents depend on `penalty`:
	- **penaltyParams**: parameters specific to the regularization function being used. Must be an array having length `2`, with any unused elements set to zero. The expected array contents depend on `penalty`:

[kgryte]

LGTM after another round of clean-up.