feat!: finalize v22 library APIs

[rdlabo]

Summary

• make photo editor and viewer toolbar color schemes explicit for iOS 26
• split photo editor, viewer, file, TUI, and Capacitor adapters into focused secondary entry points
• remove deprecated APIs, polling utilities, and accidental public component internals
• modernize browser file selection, Signal queries, CSS fallbacks, accessibility, and typed modal results
• replace the generic migration document with a v21 to v22 library migration guide and expand package documentation
• raise the native iOS and iPadOS deployment target to 16.4 after the WebKit file-input fix
• add broad unit, E2E, packed-consumer, and release-gate coverage

Breaking changes

• photo component selectors now use the rdlabo prefix
• the new toolbarColorScheme prop is required for editor and viewer modals
• PhotoViewerProps.imageUrls is now required
• photo features move to /editor, /viewer, and /file secondary entry points
• optional implementations use /editor/tui and /file/capacitor adapters
• typed dismiss payloads replace legacy result interfaces
• PhotoFileService.photoMaxSize and labels setters are removed; configure defaults with providePhotoEditor
• PhotoFileService.loadPhoto(number) changes to loadPhoto(options)
• the static #browserPhotoUploader element is removed; the service creates a temporary input per request
• photo selection failures now use the typed PhotoLoadError code contract
• deprecated kit autofill mode, including value-less kitAuthInput usage, is removed
• deprecated scroll-strategy calcIndex and internal strategy exports are removed
• native consumers must target iOS and iPadOS 16.4 or later

See docs/migration.md for consumer updates.

Validation

• npm run lint
• npm test: 1,050 tests passed
• npm run prebuild
• npx ng build demo --configuration=production
• npm run test:package-consumer
• npm run test:offline-types:nonstrict
• Playwright photo editor iOS 26 suite: 3 passed, including real TUI canvas initialization
• GitHub Angular 21 compatibility, E2E, tests, lint, and CodeQL passed on the initial review commit
• git diff --check

Reviews

• Manager review: APPROVE
• OSS maintainer review: APPROVE
• Third-party acceptance review: ACCEPT