feat(experiment): named tuples by tmm · Pull Request #281 · wevm/abitype

tmm · 2025-11-01T00:39:15Z

Since TypeScript can't dynamically generate tuple labels and labels would drastically improve the developer experience of positional arguments, this PR explores a strategy for adding tuple labels for common ABI parameter names.

Before	After

Performance is a bit worse, since we have to use tail recursion instead of a mapped type, but it's not so bad that this isn't a viable approach.

changeset-bot · 2025-11-01T00:39:18Z

🦋 Changeset detected

Latest commit: d186346

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
abitype	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

vercel · 2025-11-01T00:39:21Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
abitype	Ready	Preview	Comment	Nov 21, 2025 0:37am

codecov · 2025-11-01T00:39:58Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 99.90%. Comparing base (e2c7e84) to head (d186346).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #281   +/-   ##
=======================================
  Coverage   99.90%   99.90%           
=======================================
  Files          26       26           
  Lines        6166     6166           
  Branches      195      195           
=======================================
  Hits         6160     6160           
  Misses          5        5           
  Partials        1        1

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

tmm · 2025-11-03T15:18:28Z

spreading individual named tuples might be a better strategy

https://www.typescriptlang.org/play/?#code/C4TwDgpgBAYg9nKBeKBtAhgLigZ2AJwEsA7AcwF0AoUSKAIXX2TQCNtiBXAWxYnyprQAShBzNUAOinw4AGihSJDfkA

tmm · 2025-11-19T00:40:56Z

spreading individual named tuples might be a better strategy

it is!

github-actions · 2025-11-19T00:41:32Z

Size Change: +1.4 kB (+1.2%)

Total Size: 118 kB

Filename	Size	Change
`packages/abitype/dist/cjs/register.js`	14.3 kB	-3 B (-0.02%)
`packages/abitype/dist/esm/register.js`	15.5 kB	-3 B (-0.02%)
`packages/abitype/dist/types`	2.84 kB	+1 kB (+54.55%)	🆘
`packages/abitype/dist/types/regex.d.ts`	1.14 kB	+94 B (+9.01%)	🔍
`packages/abitype/dist/types/types.d.ts`	2.72 kB	+318 B (+13.23%)	⚠️
`packages/abitype/dist/types/version.d.ts`	2.13 kB	-5 B (-0.23%)

ℹ️ View Unchanged

Filename	Size
`packages/abitype/dist`	0 B	🆕
`packages/abitype/dist/cjs`	123 B
`packages/abitype/dist/cjs/abi.js`	0 B	🆕
`packages/abitype/dist/cjs/abis`	3.59 kB
`packages/abitype/dist/cjs/abis/human-readable.js`	5.91 kB
`packages/abitype/dist/cjs/abis/json.js`	575 B
`packages/abitype/dist/cjs/errors.js`	0 B	🆕
`packages/abitype/dist/cjs/exports`	588 B
`packages/abitype/dist/cjs/exports/abis.js`	744 B
`packages/abitype/dist/cjs/exports/index.js`	567 B
`packages/abitype/dist/cjs/exports/zod.js`	0 B	🆕
`packages/abitype/dist/cjs/human-readable`	0 B	🆕
`packages/abitype/dist/cjs/human-readable/errors`	531 B
`packages/abitype/dist/cjs/human-readable/errors/abiItem.js`	801 B
`packages/abitype/dist/cjs/human-readable/errors/abiParameter.js`	425 B
`packages/abitype/dist/cjs/human-readable/errors/signature.js`	403 B
`packages/abitype/dist/cjs/human-readable/errors/splitParameters.js`	336 B
`packages/abitype/dist/cjs/human-readable/errors/struct.js`	286 B
`packages/abitype/dist/cjs/human-readable/formatAbi.js`	410 B
`packages/abitype/dist/cjs/human-readable/formatAbiItem.js`	477 B
`packages/abitype/dist/cjs/human-readable/formatAbiParameter.js`	300 B
`packages/abitype/dist/cjs/human-readable/formatAbiParameters.js`	339 B
`packages/abitype/dist/cjs/human-readable/parseAbi.js`	429 B
`packages/abitype/dist/cjs/human-readable/parseAbiItem.js`	460 B
`packages/abitype/dist/cjs/human-readable/parseAbiParameter.js`	519 B
`packages/abitype/dist/cjs/human-readable/parseAbiParameters.js`	0 B	🆕
`packages/abitype/dist/cjs/human-readable/runtime`	749 B
`packages/abitype/dist/cjs/human-readable/runtime/cache.js`	759 B
`packages/abitype/dist/cjs/human-readable/runtime/signatures.js`	1.02 kB
`packages/abitype/dist/cjs/human-readable/runtime/structs.js`	2.23 kB
`packages/abitype/dist/cjs/human-readable/runtime/utils.js`	0 B	🆕
`packages/abitype/dist/cjs/human-readable/types`	127 B
`packages/abitype/dist/cjs/human-readable/types/signatures.js`	125 B
`packages/abitype/dist/cjs/human-readable/types/structs.js`	124 B
`packages/abitype/dist/cjs/human-readable/types/utils.js`	160 B
`packages/abitype/dist/cjs/narrow.js`	40 B
`packages/abitype/dist/cjs/package.json`	369 B
`packages/abitype/dist/cjs/regex.js`	125 B
`packages/abitype/dist/cjs/tsconfig.build.tsbuildinfo`	124 B
`packages/abitype/dist/cjs/types.js`	124 B
`packages/abitype/dist/cjs/utils.js`	149 B
`packages/abitype/dist/cjs/version.js`	2.13 kB
`packages/abitype/dist/cjs/zod.js`	0 B	🆕
`packages/abitype/dist/esm`	62 B
`packages/abitype/dist/esm/abi.js`	0 B	🆕
`packages/abitype/dist/esm/abis`	3.95 kB
`packages/abitype/dist/esm/abis/human-readable.js`	6.26 kB
`packages/abitype/dist/esm/abis/json.js`	522 B
`packages/abitype/dist/esm/errors.js`	0 B	🆕
`packages/abitype/dist/esm/exports`	297 B
`packages/abitype/dist/esm/exports/abis.js`	403 B
`packages/abitype/dist/esm/exports/index.js`	279 B
`packages/abitype/dist/esm/exports/zod.js`	0 B	🆕
`packages/abitype/dist/esm/human-readable`	0 B	🆕
`packages/abitype/dist/esm/human-readable/errors`	448 B
`packages/abitype/dist/esm/human-readable/errors/abiItem.js`	670 B
`packages/abitype/dist/esm/human-readable/errors/abiParameter.js`	338 B
`packages/abitype/dist/esm/human-readable/errors/signature.js`	343 B
`packages/abitype/dist/esm/human-readable/errors/splitParameters.js`	280 B
`packages/abitype/dist/esm/human-readable/errors/struct.js`	271 B
`packages/abitype/dist/esm/human-readable/formatAbi.js`	404 B
`packages/abitype/dist/esm/human-readable/formatAbiItem.js`	568 B
`packages/abitype/dist/esm/human-readable/formatAbiParameter.js`	377 B
`packages/abitype/dist/esm/human-readable/formatAbiParameters.js`	479 B
`packages/abitype/dist/esm/human-readable/parseAbi.js`	593 B
`packages/abitype/dist/esm/human-readable/parseAbiItem.js`	560 B
`packages/abitype/dist/esm/human-readable/parseAbiParameter.js`	636 B
`packages/abitype/dist/esm/human-readable/parseAbiParameters.js`	0 B	🆕
`packages/abitype/dist/esm/human-readable/runtime`	1.06 kB
`packages/abitype/dist/esm/human-readable/runtime/cache.js`	629 B
`packages/abitype/dist/esm/human-readable/runtime/signatures.js`	1.01 kB
`packages/abitype/dist/esm/human-readable/runtime/structs.js`	2.33 kB
`packages/abitype/dist/esm/human-readable/runtime/utils.js`	0 B	🆕
`packages/abitype/dist/esm/human-readable/types`	69 B
`packages/abitype/dist/esm/human-readable/types/signatures.js`	66 B
`packages/abitype/dist/esm/human-readable/types/structs.js`	64 B
`packages/abitype/dist/esm/human-readable/types/utils.js`	264 B
`packages/abitype/dist/esm/narrow.js`	58 B
`packages/abitype/dist/esm/package.json`	504 B
`packages/abitype/dist/esm/regex.js`	67 B
`packages/abitype/dist/esm/tsconfig.build.tsbuildinfo`	64 B
`packages/abitype/dist/esm/types.js`	64 B
`packages/abitype/dist/esm/utils.js`	82 B
`packages/abitype/dist/esm/version.js`	2.5 kB
`packages/abitype/dist/esm/zod.js`	0 B	🆕
`packages/abitype/dist/types/abi.d.ts`	0 B	🆕
`packages/abitype/dist/types/abis`	3.88 kB
`packages/abitype/dist/types/abis/human-readable.d.ts`	5.96 kB
`packages/abitype/dist/types/abis/json.d.ts`	273 B
`packages/abitype/dist/types/errors.d.ts`	0 B	🆕
`packages/abitype/dist/types/exports`	260 B
`packages/abitype/dist/types/exports/abis.d.ts`	655 B
`packages/abitype/dist/types/exports/index.d.ts`	244 B
`packages/abitype/dist/types/exports/zod.d.ts`	0 B	🆕
`packages/abitype/dist/types/human-readable`	0 B	🆕
`packages/abitype/dist/types/human-readable/errors`	227 B
`packages/abitype/dist/types/human-readable/errors/abiItem.d.ts`	376 B
`packages/abitype/dist/types/human-readable/errors/abiParameter.d.ts`	245 B
`packages/abitype/dist/types/human-readable/errors/signature.d.ts`	203 B
`packages/abitype/dist/types/human-readable/errors/splitParameters.d.ts`	174 B
`packages/abitype/dist/types/human-readable/errors/struct.d.ts`	314 B
`packages/abitype/dist/types/human-readable/formatAbi.d.ts`	640 B
`packages/abitype/dist/types/human-readable/formatAbiItem.d.ts`	663 B
`packages/abitype/dist/types/human-readable/formatAbiParameter.d.ts`	452 B
`packages/abitype/dist/types/human-readable/formatAbiParameters.d.ts`	641 B
`packages/abitype/dist/types/human-readable/parseAbi.d.ts`	756 B
`packages/abitype/dist/types/human-readable/parseAbiItem.d.ts`	735 B
`packages/abitype/dist/types/human-readable/parseAbiParameter.d.ts`	990 B
`packages/abitype/dist/types/human-readable/parseAbiParameters.d.ts`	0 B	🆕
`packages/abitype/dist/types/human-readable/runtime`	575 B
`packages/abitype/dist/types/human-readable/runtime/cache.d.ts`	379 B
`packages/abitype/dist/types/human-readable/runtime/signatures.d.ts`	155 B
`packages/abitype/dist/types/human-readable/runtime/structs.d.ts`	710 B
`packages/abitype/dist/types/human-readable/runtime/utils.d.ts`	0 B	🆕
`packages/abitype/dist/types/human-readable/types`	1.83 kB
`packages/abitype/dist/types/human-readable/types/signatures.d.ts`	725 B
`packages/abitype/dist/types/human-readable/types/structs.d.ts`	2.11 kB
`packages/abitype/dist/types/human-readable/types/utils.d.ts`	422 B
`packages/abitype/dist/types/narrow.d.ts`	161 B
`packages/abitype/dist/types/register.d.ts`	1.9 kB
`packages/abitype/dist/types/utils.d.ts`	92 B
`packages/abitype/dist/types/zod.d.ts`	0 B	🆕

_{compressed-size-action}

pkg-pr-new · 2025-11-19T05:44:11Z

Open in StackBlitz

npm i https://pkg.pr.new/abitype@281

commit: d186346

…named-tuples

feat(experiment): named tuples

e45fe0f

vercel Bot had a problem deploying to Preview November 19, 2025 00:39 Failure

tmm force-pushed the tmm/named-tuples branch from ca740b2 to 1099e41 Compare November 19, 2025 00:40

vercel Bot deployed to Preview November 19, 2025 00:41 View deployment

tmm force-pushed the tmm/named-tuples branch from 1099e41 to 33d0b80 Compare November 19, 2025 04:13

vercel Bot deployed to Preview November 19, 2025 04:14 View deployment

refactor: use tail recursion instead

42ea6a7

tmm force-pushed the tmm/named-tuples branch from 33d0b80 to 42ea6a7 Compare November 19, 2025 04:26

vercel Bot deployed to Preview November 19, 2025 04:27 View deployment

vercel Bot deployed to Preview November 19, 2025 05:42 View deployment

chore: tweaks

79115a7

tmm force-pushed the tmm/named-tuples branch from 794aca9 to 79115a7 Compare November 19, 2025 05:50

vercel Bot deployed to Preview November 19, 2025 05:51 View deployment

vercel Bot deployed to Preview November 19, 2025 06:10 View deployment

chore: mv names

33d59da

tmm force-pushed the tmm/named-tuples branch from aecc9d9 to 33d59da Compare November 19, 2025 06:11

vercel Bot deployed to Preview November 19, 2025 06:11 View deployment

tmm marked this pull request as ready for review November 19, 2025 22:27

vercel Bot deployed to Preview November 19, 2025 22:28 View deployment

tmm force-pushed the tmm/named-tuples branch from 18d0457 to ed96f39 Compare November 19, 2025 22:30

vercel Bot deployed to Preview November 19, 2025 22:32 View deployment

chore: changeset

d104da1

tmm force-pushed the tmm/named-tuples branch from ed96f39 to d104da1 Compare November 19, 2025 22:48

vercel Bot deployed to Preview November 19, 2025 22:49 View deployment

chore: gen

351d927

tmm force-pushed the tmm/named-tuples branch from 325a2f4 to 351d927 Compare November 20, 2025 01:56

ci: apply automated fixes

e7891de

vercel Bot deployed to Preview November 20, 2025 01:58 View deployment

Merge branch 'main' of https://github.com/wagmi-dev/abitype into tmm/…

0e9db23

…named-tuples

vercel Bot deployed to Preview November 20, 2025 03:02 View deployment

vercel Bot deployed to Preview November 20, 2025 23:47 View deployment

tmm force-pushed the tmm/named-tuples branch from 3f28f0c to 4be7ef8 Compare November 20, 2025 23:49

vercel Bot deployed to Preview November 20, 2025 23:50 View deployment

tmm force-pushed the tmm/named-tuples branch from 4be7ef8 to e56c1fa Compare November 21, 2025 00:04

vercel Bot deployed to Preview November 21, 2025 00:04 View deployment

chore: perf tweaks

d186346

tmm force-pushed the tmm/named-tuples branch from e56c1fa to d186346 Compare November 21, 2025 00:36

vercel Bot deployed to Preview November 21, 2025 00:37 View deployment

tmm merged commit 1a5121b into main Nov 21, 2025
24 checks passed

tmm deleted the tmm/named-tuples branch November 21, 2025 00:39

github-actions Bot mentioned this pull request Nov 21, 2025

chore: version packages #285

Merged

tmm mentioned this pull request Nov 21, 2025

feat: abi parameter named tuples wevm/viem#4107

Merged

tmm mentioned this pull request Dec 3, 2025

feat: abi parameter named tuples wevm/wagmi#4896

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(experiment): named tuples#281

feat(experiment): named tuples#281
tmm merged 9 commits into
mainfrom
tmm/named-tuples

tmm commented Nov 1, 2025 •

edited

Loading

Uh oh!

changeset-bot Bot commented Nov 1, 2025 •

edited

Loading

Uh oh!

vercel Bot commented Nov 1, 2025 •

edited

Loading

Uh oh!

codecov Bot commented Nov 1, 2025 •

edited

Loading

Uh oh!

tmm commented Nov 3, 2025

Uh oh!

tmm commented Nov 19, 2025

Uh oh!

github-actions Bot commented Nov 19, 2025 •

edited

Loading

Uh oh!

pkg-pr-new Bot commented Nov 19, 2025 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

tmm commented Nov 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot Bot commented Nov 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

vercel Bot commented Nov 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

codecov Bot commented Nov 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

tmm commented Nov 3, 2025

Uh oh!

tmm commented Nov 19, 2025

Uh oh!

github-actions Bot commented Nov 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pkg-pr-new Bot commented Nov 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

tmm commented Nov 1, 2025 •

edited

Loading

changeset-bot Bot commented Nov 1, 2025 •

edited

Loading

vercel Bot commented Nov 1, 2025 •

edited

Loading

codecov Bot commented Nov 1, 2025 •

edited

Loading

github-actions Bot commented Nov 19, 2025 •

edited

Loading

pkg-pr-new Bot commented Nov 19, 2025 •

edited

Loading