Skip to content

docs: make all npx examples use the scoped @juspay/ name consistently#10

Merged
jagguji merged 1 commit into
mainfrom
fix-readme-consistency
Jun 9, 2026
Merged

docs: make all npx examples use the scoped @juspay/ name consistently#10
jagguji merged 1 commit into
mainfrom
fix-readme-consistency

Conversation

@jagguji

@jagguji jagguji commented Jun 9, 2026

Copy link
Copy Markdown
Collaborator

What

Follow-up to #9. The preview-build snippet still used bare npx rescript-bindgen while every other example uses npx @juspay/rescript-bindgen. This makes all npx examples consistent.

Why it matters

npx rescript-bindgen (unscoped) resolves a different package from npm — the exact trap a forum user hit. After a local install the bare bin works, but mixing the two forms in the README just reads as a mistake.

Verification — every README example run verbatim via the published 1.0.2

Installed @juspay/rescript-bindgen into a clean project and ran each example command:

Command Result
--help
--pkg @radix-ui/react-dialog --out generated --report ✅ 17 bindings + report
--pkg react-day-picker --out generated ✅ 27 bindings
--pkg @mui/material@7.0.0 --only Button --out generated ✅ Button, 79 props
--file <.d.ts> --stdout ✅ runs
--dir <folder> --out generated ✅ runs
--pkg @mui/material --out generated --report ✅ 132 bindings + report

Confirmed: every npx @juspay/rescript-bindgen … command resolves and runs correctly.

The preview-build snippet still used bare 'npx rescript-bindgen' while every
other example uses 'npx @juspay/rescript-bindgen'. Scope it too so all npx
examples are consistent (after a local install npx still resolves the local
bin, so it works either way; consistency avoids confusion).
@pkg-pr-new

pkg-pr-new Bot commented Jun 9, 2026

Copy link
Copy Markdown

Open in StackBlitz

npm i https://pkg.pr.new/@juspay/rescript-bindgen@10

commit: 9b7c125

@jagguji jagguji merged commit f72f34b into main Jun 9, 2026
7 checks passed
@jagguji jagguji deleted the fix-readme-consistency branch June 9, 2026 16:15
@jagguji jagguji mentioned this pull request Jun 9, 2026
jagguji added a commit that referenced this pull request Jun 9, 2026
## Release 1.0.3 — docs-only

Refreshes the npm package page README, which only updates on a new
publish.

### What's included (already merged to main via #9, #10)
- All `npx` examples use the scoped `@juspay/rescript-bindgen` name
(consistent) — fixes the forum copy-paste failure where bare `npx
rescript-bindgen` resolved a different package.
- "Scope today" note clarifying the tool currently targets React
component packages (general TS is on the roadmap).
- `@mui/material` example pinned to a React-19-compatible version that
installs cleanly.

### Release mechanics
On merge, push tag `v1.0.3` → `publish-npm.yml` publishes to npm under
dist-tag `latest`.

No code changes — generator behavior is identical to 1.0.2.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant