# Tasks — Add `@suaveplan/react-packer`

> Every checkbox MUST reflect work actually done in this change.

## 1. Spec authoring

- [x] 1.1 Read `../suaveplan/packages/browser/packer-browser/src/hooks/usePackedResource.ts`
- [x] 1.2 Read `../suaveplan/enterprise/packer-browser.md` §3.3
- [x] 1.3 Read `openspec/AGENTS.md` §§0c, 2b, 6a, 7, 13, 14
- [x] 1.4 Draft `proposal.md` from `openspec/templates/proposal.md`
- [x] 1.5 Source-mapping table filled in (every requirement cites upstream lines OR an enterprise-md gap)
- [x] 1.6 Draft `specs/react-packer/spec.md` from `openspec/templates/spec-delta.md`
- [x] 1.7 Every requirement carries a `**Verified by:**` line with concrete planned `it(...)` titles

## 2. Implementation

- [x] 2.1 Scaffold `packages/data/react-packer/` (package.json, tsconfig, vite, vitest, playwright)
- [x] 2.2 Add `react-packer` to `scripts/folder-reorg/assignment.yml` (data block, alphabetical between `pagination` and `serialize`)
- [x] 2.3 `src/error-codes/error-codes.ts` — `REACT_PACKER_CODES` registry + `ReactPackerError`
- [x] 2.4 `src/types/react-packer.types.ts` — `UsePackedResourceOptions`, `UsePackedResourceReturn`, `UsePackedFontReturn`, `PackedResourceProviderValue`
- [x] 2.5 `src/provider/packed-resource-provider/packed-resource-provider.tsx` — context + `usePackedResourceManager`
- [x] 2.6 `src/hooks/use-packed-resource/use-packed-resource.ts` — generic hook with AbortController, mounted-ref, reload counter
- [x] 2.7 `src/hooks/use-packed-image/use-packed-image.ts`
- [x] 2.8 `src/hooks/use-packed-audio/use-packed-audio.ts`
- [x] 2.9 `src/hooks/use-packed-video/use-packed-video.ts`
- [x] 2.10 `src/hooks/use-packed-font/use-packed-font.ts` — adds `@font-face` injection + `fontLoaded`
- [x] 2.11 `src/index.ts` barrel — explicit named re-exports only
- [x] 2.12 `src/<feature>/index.ts` feature barrels — explicit named re-exports (§6a)

## 3. Tests

- [x] 3.1 `src/error-codes/error-codes.test.ts`
- [x] 3.2 `src/provider/packed-resource-provider/packed-resource-provider.test.tsx`
- [x] 3.3 `src/hooks/use-packed-resource/use-packed-resource.test.tsx`
- [x] 3.4 `src/hooks/use-packed-image/use-packed-image.test.tsx`
- [x] 3.5 `src/hooks/use-packed-audio/use-packed-audio.test.tsx`
- [x] 3.6 `src/hooks/use-packed-video/use-packed-video.test.tsx`
- [x] 3.7 `src/hooks/use-packed-font/use-packed-font.test.tsx`
- [x] 3.8 Every `it(...)` carries `{ timeout: 5000 }` (30000 where genuinely async)
- [x] 3.9 Test files import from `@suaveplan/testing/runner` only (rule 11 / §7)
- [x] 3.10 No mocks — real `PackedResourceManager` + real `Response`+`Blob` fixtures

## 4. Documentation

- [x] 4.1 Sibling `.md` per implementation file (≥200 words, basic + advanced + API + impl notes)
- [x] 4.2 Stories `.stories.tsx` per hook + provider
- [x] 4.3 `README.md` at package root linking every co-located `.md`
- [x] 4.4 Update `CLAUDE.md` package listing under data block alongside `packer-browser`
- [x] 4.5 Update `STATUS.md` with new row

## 5. Pre-archive verification (the 5-gate triple)

- [ ] 5.1 `bun run check` — Biome 0 errors / 0 warnings
- [ ] 5.2 `bunx turbo lint typecheck test --filter=@suaveplan/react-packer` — green
- [ ] 5.3 `bunx turbo test:coverage --filter=@suaveplan/react-packer` — 100/100/100/100
- [ ] 5.4 `bun scripts/openspec-conformance.ts @suaveplan/react-packer` — exit 0
- [ ] 5.5 `bunx turbo build --filter=@suaveplan/react-packer` — green

## 6. Pre-archive 9-row checklist (AGENTS.md §13)

- [ ] 6.1 Generics threaded where appropriate; no inline shapes (rule 11)
- [ ] 6.2 No Zod boundaries declared (no untrusted inputs cross the hook surface — manager handles its own boundaries)
- [ ] 6.3 Every error code in `REACT_PACKER_CODES` thrown by at least one production path
- [ ] 6.4 `AbortSignal` propagation tested (pre-aborted + abort-on-unmount + abort-on-url-change)
- [ ] 6.5 OTel traces pass through unchanged (the manager owns them; hooks do not add counters per scope)
- [ ] 6.6 Lifecycle dedup tested — mounted-ref guard prevents `setState` after unmount
- [ ] 6.7 Singleton fallback resolves only when no provider is mounted
- [ ] 6.8 No retroactive tick — every box above reflects work in this change
- [ ] 6.9 Consumer sweep clean (no existing genesis consumers of `@suaveplan/react-packer`)

## 7. Archive

- [ ] 7.1 Fold spec delta into `openspec/specs/react-packer/spec.md` (NEW capability)
- [ ] 7.2 Move `openspec/changes/add-react-packer/` → `openspec/archive/<yyyy-mm-dd>-add-react-packer/`
- [ ] 7.3 Refresh `MANIFEST.md` via `bun scripts/folder-reorg/generate-manifest.ts`