Eve library

ISIS v2 Interior Scene Pack Web UI Controls and Validation

Guide

Revision 1

On this page

Generated At: 2026-02-28T18:00:43.401Z Report Date: 2026-02-28 Checklist: MXA-0209 Ticket: ISIS2-00407

Asset Family#

Family: interior-scene-pack Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to 2026-10-30) Owner Team: @oshun/creative-tech Priority: P1 | Severity: medium

Objective#

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

Route Path: /workflows/:workflowId

Typed Workflow IDs#

  • interior-scene-pack-baseline
  • interior-scene-pack-consistency-locked
  • interior-scene-pack-control-conditioned
  • interior-scene-pack-image-conditioned

Ergonomic Controls#

Control Label Present in WorkflowDetailsPage
Scene Program (required) yes
Design Style (required) yes
Era Influence (required) yes
Room Scale (required) yes
Occupancy State (required) yes
Circulation Pattern (required) yes
Camera Framing (required) yes
Lens Profile (required) yes
Furniture Density (required) yes
Prop Narrative Theme (required) yes
Material Stack (required) yes
Floor Finish (required) yes
Wall Finish (required) yes
Lighting Rig (required) yes
Spatial Depth Profile (required) yes
Color Palette Profile (required) yes
Clutter Budget (required) yes
Seed (required) yes
Width (required) yes
Height (required) yes
Steps (required) yes
CFG Scale (required) yes
Negative Prompt yes
Style Reference Image (required) yes
Use Composition Reference yes
Composition Reference Image yes
Reference Strength yes
Composition Strength yes
Look Treatment Preset (required) yes
Use Depth Control yes
Depth Map yes
Depth Strength yes
Use Segmentation Control yes
Segmentation Map yes
Segmentation Strength yes
Use Canny Control yes
Canny Map yes
Canny Strength yes
Continuity Profile ID yes
Continuity Profile Revision yes
Continuity Locked Dimensions yes
Scene Profile ID (required) yes
Style Profile ID (required) yes
Scene Anchor Reference Image (required) yes
Use Scene Anchor Reference yes
Use Layout Reference yes
Layout Reference Map yes
Use Lighting Reference yes
Lighting Reference Frame yes
Use Lens Reference yes
Lens Reference Frame yes
Focal Length mm (required) yes
Use Style Lock yes
Scene Anchor Lock Strength yes
Layout Lock Strength yes
Lighting Lock Strength yes
Lens Lock Strength yes
Style Lock Strength yes

Validation Rules#

Validation Rule Present in UI Utils
Interior scene pack workflows require generation type text-to-image. yes
Scene Program is required. yes
Design Style is required. yes
Era Influence is required. yes
Room Scale is required. yes
Occupancy State is required. yes
Circulation Pattern is required. yes
Camera Framing is required. yes
Lens Profile is required. yes
Furniture Density is required. yes
Prop Narrative Theme is required. yes
Material Stack is required. yes
Floor Finish is required. yes
Wall Finish is required. yes
Lighting Rig is required. yes
Spatial Depth Profile is required. yes
Color Palette Profile is required. yes
Clutter Budget is required. yes
Style Reference Image is required. yes
Look Treatment Preset is required. yes
Composition Reference Image is required when composition reference is enabled. yes
At least one control must be enabled for control-conditioned workflows. yes
Depth Map is required when depth control is enabled. yes
Segmentation Map is required when segmentation control is enabled. yes
Canny Map is required when canny control is enabled. yes
Continuity Profile ID must be scene-continuity-profile. yes
Continuity Locked Dimensions is required. yes
Scene Profile ID is required. yes
Style Profile ID is required. yes
Scene Anchor Reference Image is required. yes
Layout Reference Map is required when layout reference is enabled. yes
Lighting Reference Frame is required when lighting reference is enabled. yes
Lens Reference Frame is required when lens reference is enabled. yes

Implementation Surface#

WorkflowDetailsPage Methods#

  • renderInteriorScenePackRunForm: present
  • runWorkflow: present

UI Utils Methods#

  • resolveInteriorScenePackWorkflowId: present
  • createInitialInteriorScenePackRunFormValues: present
  • validateInteriorScenePackRunFormValues: present
  • buildInteriorScenePackRunParameters: present

Run Payload Integration#

  • workflowRunMutationIncludesGenerationType: true
  • workflowRunMutationIncludesTypeAlias: true
  • fallbackDetectionPresent: true
  • workflowRunUtilsPreserved: true

Verification Commands#

  • pnpm --filter @isis/web exec vitest run src/pages/interior-scene-pack-ui-utils.spec.ts src/pages/WorkflowDetailsPage.spec.tsx src/pages/workflow-run-utils.spec.ts
  • pnpm --filter @isis/web exec tsc -p tsconfig.json --noEmit
  • pnpm --filter @isis/web run build

Acceptance Criteria#

  • Workflow details page renders ergonomic variant-specific interior-scene-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.

References#

  • docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json
  • docs/domains/isis/remediation-v2/ISIS_V2_INTERIOR_SCENE_PACK_REQUIREMENTS_BRIEF.json
  • docs/domains/isis/remediation-v2/ISIS_V2_INTERIOR_SCENE_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/interior-scene-pack-ui-utils.ts
  • apps/isis/web/src/pages/interior-scene-pack-ui-utils.spec.ts
  • apps/isis/web/src/pages/workflow-run-utils.ts
  • ISIS_TODOS_2.md

Summary#

  • typedWorkflowIdCount: 4
  • requiredWorkflowIdCount: 4
  • ergonomicControlCount: 58
  • validationRuleCount: 33
  • verificationCommandCount: 3
  • acceptanceCriteriaCount: 4
  • webUiSpecAssertions: 66