Skip to content

fix(types): complete Phase 1 cleanup of types-hierarchy-refactor#420

Merged
perasperaactual merged 1 commit into
devfrom
fix/types-hierarchy-refactor-phase1-cleanup
May 15, 2026
Merged

fix(types): complete Phase 1 cleanup of types-hierarchy-refactor#420
perasperaactual merged 1 commit into
devfrom
fix/types-hierarchy-refactor-phase1-cleanup

Conversation

@perasperaactual
Copy link
Copy Markdown
Contributor

Summary

Three items from Phase 1 of the types-hierarchy-refactor (#408) that were identified as incomplete during a post-merge audit.

Changes

1. collections/src/types.ts zombie removed

The original CollectionProvider interface definitions were left in place after being moved to @stackwright/types. types.ts is now a re-export shim so any downstream imports remain backward-compatible. file-collection-provider.ts now imports directly from @stackwright/types.

2. HookHandler forwarded through hooks-registry and scaffold-core

HookHandler was canonical in @stackwright/types and re-exported by hooks-registry/src/hooks.ts but not forwarded through index.ts, making import type { HookHandler } from '@stackwright/hooks-registry' fail silently. Both @stackwright/hooks-registry and @stackwright/scaffold-core now re-export it alongside the other scaffold hook types.

3. generate-agent-docs extended with interface contracts table (Phase 1 step 8)

A new auto-generated section in both AGENTS.md files documents the TypeScript interface contracts from @stackwright/types. The section is delimited by <!-- stackwright:interface-table:start/end --> markers and updated by pnpm stackwright -- generate-agent-docs alongside the existing content-type-table.

Testing

  • pnpm test — 864/864 passing
  • pnpm build — all 15 packages clean
  • pnpm stackwright -- generate-agent-docs — both AGENTS.md files confirmed in sync

Changesets

  • collections-types-cleanup — patch for @stackwright/collections
  • hookhandler-reexport — patch for @stackwright/hooks-registry, @stackwright/scaffold-core
  • generate-agent-docs-interfaces — patch for @stackwright/cli

@github-actions
Copy link
Copy Markdown
Contributor

✅ Visual Regression Test Results

Status: ✅ All visual tests passed!

All screenshots match the baseline. No visual regressions detected! 🎉

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 15, 2026

⚡ Performance Benchmark Results

✅ Build Time Benchmarks: PASSED

✅ Bundle Size Benchmarks: PASSED

❌ Runtime Vitals Benchmarks: FAILED

📝 Note: Detailed results are available in the job logs.

🎯 Performance Budgets:

  • Build time: <70s total
  • First-load JS: <100KB gzipped
  • FCP: <1.5s, LCP: <2.5s, TTI: <3s

Updated: 2026-05-15T17:06:28.720Z

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 15, 2026

♿ Accessibility Test Results

Overall Status: ✅ 0/0 tests passed

🦮 WCAG 2.1 AA Compliance

No WCAG test results available

⌨️ Keyboard Navigation

No keyboard navigation test results available


⚠️ No accessibility tests were executed. Check the workflow logs for setup issues.

📊 Detailed Report

Download the full HTML accessibility report from the workflow artifacts for:

  • Detailed WCAG violation descriptions
  • Specific element selectors and fixes
  • Color contrast issues
  • Keyboard navigation flow analysis

🔍 Testing Checklist

Our accessibility tests verify:

  • ✅ WCAG 2.1 Level AA compliance
  • ✅ Color contrast in light and dark modes
  • ✅ Tab key navigation through all interactive elements
  • ✅ Focus indicators are visible
  • ✅ No keyboard traps
  • ✅ Skip links and ARIA landmarks
  • ✅ Screen reader compatibility

Powered by @axe-core/playwright and Playwright

Three items from Phase 1 of the types-hierarchy-refactor that were missed
when PR #408 merged:

1. collections/src/types.ts zombie removed
   The original CollectionProvider interface definitions were left in place
   after being moved to @stackwright/types. types.ts is now a re-export
   shim; file-collection-provider.ts imports directly from @stackwright/types.

2. HookHandler forwarded through hooks-registry and scaffold-core
   HookHandler was canonical in @stackwright/types and re-exported by
   hooks-registry/src/hooks.ts but not forwarded through index.ts, making
   it unavailable via public import paths. Both packages now re-export it
   alongside the other scaffold hook types.

3. generate-agent-docs extended with interface contracts table (step 8)
   A new auto-generated section in both AGENTS.md files documents the
   TypeScript interface contracts from @stackwright/types: CollectionProvider,
   CollectionEntry, CollectionListOptions, CollectionListResult,
   ScaffoldHookContext, ScaffoldHook, HookHandler, ScaffoldHookType.
   Delimited by stackwright:interface-table:start/end markers, updated by
   the existing generate-agent-docs command alongside the content-type-table.

Changesets: collections-types-cleanup (patch), hookhandler-reexport (patch
for hooks-registry + scaffold-core), generate-agent-docs-interfaces (patch
for cli).
@perasperaactual perasperaactual force-pushed the fix/types-hierarchy-refactor-phase1-cleanup branch from 5bb4603 to 18f44a6 Compare May 15, 2026 17:03
@github-actions
Copy link
Copy Markdown
Contributor

✅ Visual Regression Test Results

Status: ✅ All visual tests passed!

All screenshots match the baseline. No visual regressions detected! 🎉

@perasperaactual perasperaactual merged commit e6b3459 into dev May 15, 2026
14 of 15 checks passed
@perasperaactual perasperaactual deleted the fix/types-hierarchy-refactor-phase1-cleanup branch May 15, 2026 17:08
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