Specification: Phase 3.4 — Design System Publish

Build, verify, and publish @arda-cards/design-system to GitHub Packages with the lifecycle types and updated components from Phases 3.2 and 3.3.

Entry Criteria

Phase 3.2 complete: lifecycle types and useDraft<T> hook
Phase 3.3 complete: 5 image components updated
All checks pass: make check, make test, make build

Tasks

T-1: Full library build

make build-lib   # LIB_BUILD=true vite build + copy-dist-assets

Verify dist/ contains:

canary.js, canary.cjs, canary.d.ts — updated with lifecycle exports
types-canary.js, types-canary.cjs, types-canary.d.ts — updated with lifecycle types
All other existing exports unchanged

T-2: CHANGELOG update

Add entries per the release-lifecycle skill conventions:

Added: ValidationResult, FieldError, EditLifecycleCallbacks<T>, EditableComponentProps<T>, EditPhase, Validator<T> types. useDraft<T> hook. UploadError state in ImageUploadDialog. contextErrors prop on ImageFormField. Expanded ItemGridLookups. Typed provider hook support in ImageCellEditor factory.
Changed: ImageUploadDialog progress indicator changed from simulated percentage to indeterminate.

T-3: Version bump

Bump version in package.json per changelog category rules (Added → minor).

T-4: Final checks

make check       # lint + typecheck
make test        # unit tests
make build       # Storybook build
make build-lib   # library build with declarations

T-5: Commit, push, PR

Commit all changes including CHANGELOG and version bump
Push to branch
Create PR to main
Run /pr-steward <pr-url> to monitor CI checks, surface reviewer comments, implement fixes, reply to threads, and resolve conversations
Merge after approval

T-6: Verify publication

After merge, verify the package is published:

npm view @arda-cards/design-system versions --registry=https://npm.pkg.github.com

Verify the new version includes the lifecycle exports:

npm pack @arda-cards/design-system@<version> --registry=https://npm.pkg.github.com
tar -tf arda-cards-design-system-<version>.tgz | grep -E "canary|types-canary"

T-7: Documentation checks and commit

Update session log / byproducts in the documentation worktree.

# In the documentation worktree
make pr-checks

Commit documentation changes referencing Phase 3.4.

Exit Criteria

Package published to GitHub Packages at new version
New version includes lifecycle types and updated components
All CI checks passed
PR merged to main
Documentation worktree: make pr-checks passes, changes committed

STOP: Verify package is consumable by arda-frontend-app before proceeding to Phase 3.5.

Open Questions and Decisions

#	Question	Options	Recommendation	Decision
—	None	—	—	—