clap_types

Adds that publishes to crates.io whenever a GitHub Release is published from a tag. Also exposes a manual trigger for one-off publishes. Authentication Uses crates.io's trusted publishing via . GitHub Actions presents an OIDC token; crates.io exchanges it for a short-lived publish credential. No long-lived secret to rotate or leak. Required one-time setup on crates.io Before this workflow can succeed, a maintainer needs to register the trusted publisher on the crate at https://crates.io/crates/clap_types/settings with: Repository owner: Repository name: Workflow filename: Environment (optional): leave blank Until that's registered, the auth step fails fast with a clear error and the publish never runs. Trigger model Plus a tag-shape guard so a release made against an unrelated tag can't accidentally publish: Release flow 1. Bump in and merge. 2. Create a GitHub Release with tag (matching the Cargo.toml version). 3. Publishing this Release fires the workflow; it auths via OIDC and runs . Manual fallback: trigger from the Actions tab → Publish to crates.io → Run workflow.

This PR adds typed-configuration entry points to the public API, expands the Flow generator, and substantially broadens test coverage. It also normalizes some user-facing copy. New typed-options APIs Variants of the existing convenience functions that take an options struct, so callers can tune behavior without a new top-level function each time a knob is added: — returns the list of generated files instead of writing to disk. — takes a generator-options struct. + — parameterize reflection (hidden args, output contracts, etc.) without hardcoded defaults. Flow generator improvements Emits + docblock and on every generated module so downstream tooling recognizes the file as generated. Tightens Zod-related types: → . Replaces with for newer Flow toolchains. Adds so output-contracts mode emits per-command output type aliases. Other added as a runtime dependency (used by the generators for schema serialization). : ~200 new lines of coverage for the options-based APIs and output-contracts paths. : snapshot fixtures regenerated to match. Examples updated to demonstrate the new options APIs. Renames "type-safe" → "strongly-typed" across the user-facing copy (Cargo description, README, AGENTS, CONTRIBUTING, architecture doc) and rewords a few "safe"/"safely" phrasings in deeper docs. Verification and both pass (19 unit + 3 roundtrip + 9 doctests, all green).

Summary Add a Flow-annotated JavaScript backend with argv builders, optional Zod validation, optional Node helpers, and output-contract helpers. Wire Flow into the public API, hidden command, fixture generation, docs, npm scripts, and CI. Add Flow smoke/client tests plus a generated Flow roundtrip test through stripped JS and Node. Test plan