For alpha 20 by baxyz · Pull Request #54 · helpers4/typescript

baxyz · 2026-04-24T20:12:41Z

Summary

This PR covers several independent improvements targeting the v2.0.0-alpha.20 release.

CI / Release workflow

Replace app-id with client-id for actions/create-github-app-token steps (API change)
Extract website documentation refresh into a dedicated trigger-website-docs job (runs after publish, isolated failure scope)

New helpers

version/isPrerelease — detect whether a version string or ParsedVersion is a prerelease; handles build metadata (1.0.0+build-123 → false)
version/stringify — serialize a ParsedVersion back to a string
number/formatSize — human-readable byte formatting (B / KB / MB / GB)
url/parsePackageRepository — parse the repository field of package.json into a structured { host, slug, owner, repo, gistId, directory } object; supports all npm-specified formats (shorthand, SSH, HTTPS, gist)

Script improvements

scripts/version/inject-since.ts — align CLI entry-point guard with endsWith pattern used elsewhere; fix false-positive on 1.0.0+build-123 in isPrerelease
scripts/build/build-website-metadata.ts — companion-type detection now includes interface kinds (fixes ParsedVersion incorrectly getting a standalone helper page); interface typeDefinition rendering now filters by ReflectionKind.Property and handles method signatures

Tests & quality

100% coverage maintained (2868 tests)
Property-based tests with fast-check for formatSize, isPrerelease, parsePackageRepository
Dead code removed from parsePackageRepository (guards made impossible by regex structure)

- replace app-id with client-id for GitHub app token - add dedicated job for triggering website documentation refresh

Copilot

Pull request overview

Updates the release workflow to align GitHub App token generation with client-id and to move the website documentation refresh trigger into a dedicated post-publish job.

Changes:

Switched actions/create-github-app-token@v3 input from app-id to client-id for existing app-token steps.
Removed the inline docs-trigger steps from the publish job and replaced them with a separate trigger-website-docs job that runs after publish with its own concurrency key.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

github-actions · 2026-04-24T20:28:40Z

✅ PR Validation Passed

All checks passed and coverage target reached!

📋 Pipeline Status

	Job	Status
✅	🔢 Version	`passing`
✅	🏗️ Build	`passing`
✅	🧪 Tests	`passing`
✅	📝 Lint	`passing`
✅	📘 TypeCheck	`passing`
✅	🔐 Security Audit	`passing`
✅	🧾 Conventional Commits	`passing`
✅	🔗 Coherency	`passing`

📊 Code Coverage

✅ Overall Coverage: 100.0% — Target reached! 🎯

	Metric	Progress	Coverage
✅	Lines	`▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓`	100%
✅	Branches	`▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓`	100%
✅	Functions	`▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓`	100%
✅	Statements	`▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓`	100%

🧬 Mutation Testing

🟢 Mutation Score: 92.39% — excellent

	Metric	Progress	Score
🟢	Mutation Score	`▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░`	92.39%

🧬 Mutation testing is informational only and does not block the PR

📊 View full mutation report on Stryker Dashboard

🌐 Runtime Compatibility

✅ Runtime Compatibility: 3/3 — All runtimes passed!

	Runtime	Status
🟩	Node.js 24 (LTS) `v24.14.1`	✅
🦕	Deno `2.7.13`	✅
🍞	Bun `1.3.13`	✅

🔄 Runtime compatibility is informational only and does not block the PR

⏱️ Benchmarks

✅ Benchmarks: 0 suites — completed

⏱️ Benchmarks are informational only and do not block the PR

ℹ️ About this report

🎯 Coverage Target: 100% for all metrics
🧬 Mutation Testing: powered by Stryker (non-blocking)
⏱️ Benchmarks: powered by Vitest Bench (non-blocking)
🔄 This comment updates automatically with each push
📈 Coverage is measured using Vitest + v8

_{🤖 Generated by @helpers4 CI • 2026-04-25}

Copilot

Pull request overview

Copilot reviewed 20 out of 20 changed files in this pull request and generated 4 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

- add step to inject version in release workflow - update CLI entry point for version injection script

- implement parsePackageRepository function - add tests for various input formats - create example usage for documentation

- implement isPrerelease function to check version suffix - add examples for isPrerelease usage - create tests for string and ParsedVersion inputs

- implement stringify function for semantic versioning - add examples for stable and prerelease versions - include tests for stringify functionality

- build interface definition string for interfaces - update processMember to handle interface kind

Copilot

Pull request overview

Copilot reviewed 21 out of 21 changed files in this pull request and generated 2 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Co-authored-by: Copilot <copilot@github.com>

Copilot

Pull request overview

Copilot reviewed 21 out of 21 changed files in this pull request and generated 3 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@SInCE

…eases - inject @SInCE version for stable releases - upload modified helpers for stable releases - download modified helpers for stable releases

feat(workflows): ✨ add trigger for website docs update after release

4d14432

- replace app-id with client-id for GitHub app token - add dedicated job for triggering website documentation refresh

Copilot AI review requested due to automatic review settings April 24, 2026 20:12

github-actions Bot assigned baxyz Apr 24, 2026

Copilot started reviewing on behalf of baxyz April 24, 2026 20:13 View session

Copilot AI reviewed Apr 24, 2026

View reviewed changes

Comment thread .github/workflows/release.yml

baxyz requested a review from Copilot April 24, 2026 21:26

Copilot started reviewing on behalf of baxyz April 24, 2026 21:26 View session

Copilot AI reviewed Apr 24, 2026

View reviewed changes

Comment thread helpers/number/formatSize.spec.ts Outdated

Comment thread helpers/url/parsePackageRepository.ts

Comment thread helpers/version/isPrerelease.ts

Comment thread scripts/version/inject-since.ts Outdated

baxyz added 5 commits April 24, 2026 21:56

chore(release): 🔧 inject @SInCE version for stable releases

d31c694

- add step to inject version in release workflow - update CLI entry point for version injection script

feat(url): ✨ add parsePackageRepository helper with tests and examples

a9841de

- implement parsePackageRepository function - add tests for various input formats - create example usage for documentation

feat(version): ✨ add isPrerelease helper with tests and examples

9129c95

- implement isPrerelease function to check version suffix - add examples for isPrerelease usage - create tests for string and ParsedVersion inputs

feat(number): ✨ add formatSize helper with examples and tests

9e1a1a3

feat(version): ✨ add stringify helper with examples and tests

5388360

- implement stringify function for semantic versioning - add examples for stable and prerelease versions - include tests for stringify functionality

baxyz force-pushed the for-alpha-20 branch from b7bf7d5 to 5388360 Compare April 24, 2026 21:56

feat(type): ✨ add interface definition support in processMember

f21e211

- build interface definition string for interfaces - update processMember to handle interface kind

baxyz requested a review from Copilot April 24, 2026 22:12

Copilot started reviewing on behalf of baxyz April 24, 2026 22:12 View session

Copilot AI reviewed Apr 24, 2026

View reviewed changes

Comment thread helpers/url/parsePackageRepository.ts

Comment thread scripts/build/build-website-metadata.ts Outdated

baxyz and others added 3 commits April 25, 2026 17:24

ci(release): 👷 add continue-on-error for website docs trigger

83f1a46

refactor(url): ♻️ remove gist.github.com from DOMAIN_TO_HOST

7693f92

feat(type): ✨ enhance processMember to support method signatures

ad184a0

Co-authored-by: Copilot <copilot@github.com>

baxyz requested a review from Copilot April 25, 2026 17:25

Copilot started reviewing on behalf of baxyz April 25, 2026 17:25 View session

Copilot AI reviewed Apr 25, 2026

View reviewed changes

Comment thread scripts/version/inject-since.ts

Comment thread .github/workflows/release.yml Outdated

Comment thread .github/workflows/release.yml Outdated

baxyz added 2 commits April 25, 2026 17:42

feat(CI-CD): ✨ add version injection and helper upload for stable rel…

f176bf1

…eases - inject @SInCE version for stable releases - upload modified helpers for stable releases - download modified helpers for stable releases

refactor(version): ♻️ simplify script execution check

014c1c6

baxyz merged commit 00f2765 into main Apr 25, 2026
15 checks passed

baxyz deleted the for-alpha-20 branch April 25, 2026 18:03

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

For alpha 20#54

For alpha 20#54
baxyz merged 12 commits intomainfrom
for-alpha-20

baxyz commented Apr 24, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

github-actions Bot commented Apr 24, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

baxyz commented Apr 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

CI / Release workflow

New helpers

Script improvements

Tests & quality

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

github-actions Bot commented Apr 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ PR Validation Passed

📋 Pipeline Status

📊 Code Coverage

🧬 Mutation Testing

🌐 Runtime Compatibility

⏱️ Benchmarks

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

baxyz commented Apr 24, 2026 •

edited

Loading

github-actions Bot commented Apr 24, 2026 •

edited

Loading