# ISIS v2 UI Icon Pack Side-by-Side Comparison Tools

Generated: 2026-08-02T18:38:29.450Z Checklist: `MXA-0300` (ISIS2-00498) Asset
Family: `ui-icon-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Deliver side-by-side comparison tools specialized for ui-icon-pack outputs with
profile-aware workflow filtering, recommended dimension presets, and
icon-concept/domain/style/shape/stroke/grid/perspective/lighting/material/state/contrast/background/palette/platform/render/color/lens/viewport/continuity/control/reference/seed
scoring layered over generic style/identity consistency checks.

## Comparison Profile Modes

- `auto`
- `general`
- `architecture-kitbash-pack`
- `interior-scene-pack`
- `prop-pack-general`
- `environment-tileset-pack`
- `environment-matte-painting`
- `environment-concept-art`
- `creature-concept-art`
- `character-concept-art`
- `character-turnaround-sheet`
- `character-expression-sheet`
- `character-costume-variant-pack`
- `character-prop-interaction-sheet`
- `npc-crowd-variation-pack`
- `weapon-pack`
- `vehicle-exterior-pack`
- `vehicle-interior-pack`
- `ui-icon-pack`

## UI-Icon-Specific Metrics

- `UI Icon Pack Family Match`: present
- `Workflow Variant Alignment`: present
- `Icon Concept Match`: present
- `Semantic Domain Match`: present
- `Icon Style Family Match`: present
- `Shape Language Match`: present
- `Stroke Weight Profile Match`: present
- `Grid System Match`: present
- `Perspective Mode Match`: present
- `Lighting Profile Match`: present
- `Material Finish Match`: present
- `State Variant Match`: present
- `Accessibility Contrast Target Match`: present
- `Background Mode Match`: present
- `Palette Profile Match`: present
- `Platform Target Match`: present
- `Render Intent Match`: present
- `Color Script Match`: present
- `Style Preset Match`: present
- `Scene Profile Match`: present
- `Style Profile Match`: present
- `Continuity Profile Match`: present
- `Continuity Revision Match`: present
- `Continuity Locked Dimensions Match`: present
- `Lens Profile Match`: present
- `Icon Viewport Scale Match`: present
- `Control Toggle Alignment`: present
- `Control Strength Alignment`: present
- `Reference Toggle Alignment`: present
- `Reference Strength Alignment`: present
- `Style Lock Alignment`: present
- `Continuity Lock Strength Alignment`: present
- `Seed Alignment`: present

## Implementation Surface

| Group                         | Method/Signal                                   | Present |
| ----------------------------- | ----------------------------------------------- | ------- |
| output-consistency-utils      | `readComparisonWorkspaceStateFromSearch`        | yes     |
| output-consistency-utils      | `buildComparisonWorkspacePath`                  | yes     |
| output-consistency-utils      | `calculateAverageConsistencyScore`              | yes     |
| ui-icon-pack-comparison-utils | `isUIIconPackOutput`                            | yes     |
| ui-icon-pack-comparison-utils | `buildUIIconPackComparisonContext`              | yes     |
| ui-icon-pack-comparison-utils | `resolveUIIconPackComparisonProfileFromOutputs` | yes     |
| ui-icon-pack-comparison-utils | `buildUIIconPackConsistencyReport`              | yes     |
| OutputComparisonWorkspacePage | `comparisonProfileState`                        | yes     |
| OutputComparisonWorkspacePage | `profileSelectorRendered`                       | yes     |
| OutputComparisonWorkspacePage | `profileOptionRendered`                         | yes     |
| OutputComparisonWorkspacePage | `profilePresetActionRendered`                   | yes     |
| OutputComparisonWorkspacePage | `profileMismatchGuard`                          | yes     |
| OutputComparisonWorkspacePage | `profileAwareMetrics`                           | yes     |

## Verification Commands

- `pnpm --filter @isis/web exec vitest run src/pages/ui-icon-pack-comparison-utils.spec.ts src/pages/output-consistency-utils.spec.ts`
- `pnpm --filter @isis/web exec vitest run src/pages/OutputComparisonWorkspacePage.spec.tsx -t "ui-icon-pack"`

## Acceptance Criteria

- Comparison workspace supports explicit ui-icon-pack profile selection with
  query-string persistence and auto-detect fallback.
- UI icon pack profile exposes recommended comparison dimensions and narrows
  selectable outputs to ui-icon-pack candidates.
- UI icon pack side-by-side report adds icon family and icon
  metadata/control/reference/continuity alignment metrics in addition to base
  consistency metrics.
- Web tests validate ui-icon profile URL state, specialized metric rendering,
  mismatch guarding, and preset dimension behavior.

## Traceability

- Checklist item: `MXA-0300`
- Ticket key: `ISIS2-00498`
- Source TODO: `ISIS_TODOS_2.md`

## References

- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_UI_ICON_PACK_REQUIREMENTS_BRIEF.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_UI_ICON_PACK_WEB_UI_CONTROLS_VALIDATION.json`
- `apps/isis/web/src/pages/OutputComparisonWorkspacePage.tsx`
- `apps/isis/web/src/pages/OutputComparisonWorkspacePage.spec.tsx`
- `apps/isis/web/src/pages/output-consistency-utils.ts`
- `apps/isis/web/src/pages/output-consistency-utils.spec.ts`
- `apps/isis/web/src/pages/ui-icon-pack-comparison-utils.ts`
- `apps/isis/web/src/pages/ui-icon-pack-comparison-utils.spec.ts`
- `ISIS_TODOS_2.md`
