# ISIS v2 Decal Pack Web UI Controls and Validation

Generated: 2026-03-01T22:51:11.810Z Checklist: `MXA-0353` (ISIS2-00551) Asset
Family: `decal-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Expose decal-pack workflows in Isis web UI with ergonomic variant-specific
controls and deterministic validation aligned to API and SDK typed contracts.

## Workflow Coverage

| Workflow ID                      | Covered |
| -------------------------------- | ------- |
| `decal-pack-baseline`            | yes     |
| `decal-pack-image-conditioned`   | yes     |
| `decal-pack-control-conditioned` | yes     |
| `decal-pack-consistency-locked`  | yes     |

## Ergonomic Controls

- `Decal Category (required)`: present
- `Decal Style Family (required)`: present
- `Silhouette Profile (required)`: present
- `Edge Treatment (required)`: present
- `Wear Profile (required)`: present
- `Substrate Target (required)`: present
- `Adhesion Context (required)`: present
- `Transparency Mode (required)`: present
- `Print Process (required)`: present
- `Contrast Target (required)`: present
- `Roughness Profile (required)`: present
- `Metallic Profile (required)`: present
- `Normal Intensity Profile (required)`: present
- `Tileability Mode (required)`: present
- `Scale Class (required)`: present
- `Color Palette Profile (required)`: present
- `Platform Target (required)`: present
- `Render Intent (required)`: present
- `Decal Subject (required)`: present
- `Checkpoint ID (required)`: present
- `Prompt Template ID (required)`: present
- `Style Profile ID (required)`: present
- `Color Script (required)`: present
- `Lens Profile (required)`: present
- `Seed (required)`: present
- `Width (required)`: present
- `Height (required)`: present
- `Steps (required)`: present
- `CFG Scale (required)`: present
- `Negative Prompt`: present
- `Style Preset (required)`: present
- `Style Reference Image (required)`: present
- `Use Composition Reference`: present
- `Composition Reference Image`: present
- `Reference Strength`: present
- `Composition Strength`: present
- `Decal Control Preset (required)`: present
- `Use Pose Control`: present
- `Pose Map`: present
- `Pose Strength`: present
- `Use Depth Control`: present
- `Depth Map`: present
- `Depth Strength`: present
- `Use Segmentation Control`: present
- `Segmentation Map`: present
- `Segmentation Strength`: present
- `Continuity Profile ID`: present
- `Continuity Profile Revision`: present
- `Continuity Locked Dimensions`: present
- `Decal Scene Profile ID (required)`: present
- `Decal Scale Reference (required)`: present
- `Decal Finish Preset (required)`: present
- `Decal Anchor Reference Image (required)`: present
- `Use Decal Anchor Reference`: present
- `Use Placement Reference`: present
- `Placement Reference Map`: present
- `Use Lighting Reference`: present
- `Lighting Reference Frame`: present
- `Use Lens Reference`: present
- `Lens Reference Frame`: present
- `Use Style Lock`: present
- `Decal Anchor Lock Strength`: present
- `Placement Lock Strength`: present
- `Lighting Lock Strength`: present
- `Lens Lock Strength`: present
- `Style Lock Strength`: present

## Validation Rules

- present: Decal pack workflows require generation type text-to-image.
- present: Decal Subject is required.
- present: Decal Category is required.
- present: Decal Style Family is required.
- present: Silhouette Profile is required.
- present: Edge Treatment is required.
- present: Wear Profile is required.
- present: Substrate Target is required.
- present: Adhesion Context is required.
- present: Transparency Mode is required.
- present: Print Process is required.
- present: Contrast Target is required.
- present: Roughness Profile is required.
- present: Metallic Profile is required.
- present: Normal Intensity Profile is required.
- present: Tileability Mode is required.
- present: Scale Class is required.
- present: Color Palette Profile is required.
- present: Platform Target is required.
- present: Render Intent is required.
- present: Checkpoint ID is required.
- present: Prompt Template ID is required.
- present: Style Profile ID is required.
- present: Color Script is required.
- present: Lens Profile is required.
- present: Style Preset is required.
- present: Style Reference Image is required.
- present: Composition Reference Image is required when composition reference is
  enabled.
- present: Decal Control Preset is required.
- present: At least one control must be enabled for control-conditioned
  workflows.
- present: Pose Map is required when pose control is enabled.
- present: Depth Map is required when depth control is enabled.
- present: Segmentation Map is required when segmentation control is enabled.
- present: Continuity Profile ID must be scene-continuity-profile.
- present: Continuity Locked Dimensions is required.
- present: Decal Scene Profile ID is required.
- present: Decal Scale Reference is required.
- present: Decal Finish Preset is required.
- present: Decal Anchor Reference Image is required.
- present: Placement Reference Map is required when placement reference is
  enabled.
- present: Lighting Reference Frame is required when lighting reference is
  enabled.
- present: Lens Reference Frame is required when lens reference is enabled.

## Verification Commands

- `pnpm --filter @isis/web exec vitest run src/pages/decal-pack-ui-utils.spec.ts`
- `pnpm --filter @isis/web exec vitest run src/pages/WorkflowDetailsPage.spec.tsx -t "decal pack"`
- `pnpm --filter @isis/web exec vitest run src/pages/workflow-run-utils.spec.ts`

## Acceptance Criteria

- Workflow details page renders ergonomic variant-specific decal-pack controls
  for all four workflow IDs.
- Web UI validation enforces typed contract constraints (generation type lock,
  required fields, control toggles, and conditional map/reference requirements).
- Workflow run dispatch includes explicit generationType/type fields for typed
  API contract alignment.
- Web UI tests cover ergonomic form rendering, validation errors, and successful
  workflow run payload dispatch.

## Traceability

- Checklist item: `MXA-0353`
- Ticket key: `ISIS2-00551`
- Source references:
  - `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_DECAL_PACK_REQUIREMENTS_BRIEF.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_DECAL_PACK_SDK_END_TO_END_EXAMPLES.json`
  - `apps/isis/web/src/pages/WorkflowDetailsPage.tsx`
  - `apps/isis/web/src/pages/WorkflowDetailsPage.spec.tsx`
  - `apps/isis/web/src/pages/decal-pack-ui-utils.ts`
  - `apps/isis/web/src/pages/decal-pack-ui-utils.spec.ts`
  - `apps/isis/web/src/pages/workflow-run-utils.ts`
  - `ISIS_TODOS_2.md`
