Eve library

ISIS v2 Material PBR Pack Web UI Controls and Validation

Guide

Revision 1

On this page

Generated: 2026-08-02T16:03:34.715Z Checklist: MXA-0335 (ISIS2-00533) Asset Family: material-pbr-pack Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to 2026-10-30)

Objective#

Expose material-pbr-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
material-pbr-pack-baseline yes
material-pbr-pack-image-conditioned yes
material-pbr-pack-control-conditioned yes
material-pbr-pack-consistency-locked yes

Ergonomic Controls#

  • Material Category (required): present
  • Surface Age Profile (required): present
  • Albedo Palette Profile (required): present
  • Roughness Profile (required): present
  • Metallic Profile (required): present
  • Normal Intensity Profile (required): present
  • Microdetail Profile (required): present
  • Macro Pattern Scale (required): present
  • Tileability Mode (required): present
  • UV Repeat Target (required): present
  • Displacement Intent (required): present
  • Render Lighting Context (required): present
  • Platform Target (required): present
  • Render Intent (required): present
  • Material Subtype (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
  • Material Finish Preset (required): present
  • Style Reference Image (required): present
  • Use Composition Reference: present
  • Composition Reference Image: present
  • Reference Strength: present
  • Composition Strength: present
  • Material 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
  • Use Normal Control: present
  • Normal Map: present
  • Normal Strength: present
  • Use Canny Control: present
  • Canny Map: present
  • Canny Strength: present
  • Use Lineart Control: present
  • Lineart Map: present
  • Lineart Strength: present
  • Use Mask Region Guide: present
  • Mask Region Map: present
  • Mask Guide Strength: present
  • Control Blend Precedence: present
  • Control Blend Conflict Policy: present
  • Control Blend ControlNet Scale: present
  • Control Blend IPAdapter Scale: present
  • Control Blend InstantID Scale: present
  • Control Blend ControlNet Schedule Start: present
  • Control Blend ControlNet Schedule End: present
  • Control Blend ControlNet Schedule Curve: present
  • Control Blend IPAdapter Schedule Start: present
  • Control Blend IPAdapter Schedule End: present
  • Control Blend IPAdapter Schedule Curve: present
  • Control Blend InstantID Schedule Start: present
  • Control Blend InstantID Schedule End: present
  • Control Blend InstantID Schedule Curve: present
  • Continuity Profile ID: present
  • Continuity Profile Revision: present
  • Continuity Locked Dimensions: present
  • Material Scene Profile ID (required): present
  • Material Anchor Reference Image (required): present
  • Use Material Anchor Reference: present
  • Use Roughness Reference: present
  • Roughness Reference Map: present
  • Use Normal Reference: present
  • Normal Reference Map: present
  • Use Lens Reference: present
  • Lens Reference Frame: present
  • Texture Resolution Tier (required): present
  • Channel Pack Profile (required): present
  • Seam Suppression Profile (required): present
  • Use Style Lock: present
  • Material Anchor Lock Strength: present
  • Roughness Lock Strength: present
  • Normal Lock Strength: present
  • Lens Lock Strength: present
  • Style Lock Strength: present

Validation Rules#

  • present: Material PBR pack workflows require generation type text-to-image.
  • present: Material Category is required.
  • present: Material Subtype is required.
  • present: Surface Age Profile is required.
  • present: Albedo Palette Profile is required.
  • present: Roughness Profile is required.
  • present: Metallic Profile is required.
  • present: Normal Intensity Profile is required.
  • present: Microdetail Profile is required.
  • present: Macro Pattern Scale is required.
  • present: Tileability Mode is required.
  • present: UV Repeat Target is required.
  • present: Displacement Intent is required.
  • present: Render Lighting Context 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: Material Finish Preset is required.
  • present: Style Reference Image is required.
  • present: Composition Reference Image is required when composition reference is enabled.
  • present: Material 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: Normal Map is required when normal control is enabled.
  • present: Canny Map is required when canny control is enabled.
  • present: Lineart Map is required when lineart control is enabled.
  • present: Mask Region Map is required when mask region guide is enabled.
  • present: Control Blend Precedence entries must be unique.
  • present: Control Blend ControlNet Scale must be between 0 and 2.
  • present: Control Blend IPAdapter Scale must be between 0 and 2.
  • present: Control Blend InstantID Scale must be between 0 and 2.
  • present: Control Blend ControlNet schedule start must be less than or equal to end.
  • present: Control Blend IPAdapter schedule start must be less than or equal to end.
  • present: Control Blend InstantID schedule start must be less than or equal to end.
  • present: Continuity Profile ID must be scene-continuity-profile.
  • present: Continuity Locked Dimensions is required.
  • present: Material Scene Profile ID is required.
  • present: Material Anchor Reference Image is required.
  • present: Texture Resolution Tier is required.
  • present: Channel Pack Profile is required.
  • present: Seam Suppression Profile is required.
  • present: Roughness Reference Map is required when roughness reference is enabled.
  • present: Normal Reference Map is required when normal 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/material-pbr-pack-ui-utils.spec.ts
  • pnpm --filter @isis/web exec vitest run src/pages/WorkflowDetailsPage.spec.tsx -t "material pbr pack"
  • pnpm --filter @isis/web exec vitest run src/pages/workflow-run-utils.spec.ts
  • pnpm --filter @isis/web exec playwright test e2e/material-pbr-pack-controls.spec.ts --project=chromium

Acceptance Criteria#

  • Workflow details page renders ergonomic variant-specific material-pbr-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-0335
  • Ticket key: ISIS2-00533
  • Source references:
    • docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json
    • docs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_PACK_REQUIREMENTS_BRIEF.json
    • docs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_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/WorkflowControlBlendPanel.tsx
    • apps/isis/web/src/pages/material-pbr-pack-ui-utils.ts
    • apps/isis/web/src/pages/material-pbr-pack-ui-utils.spec.ts
    • apps/isis/web/src/pages/workflow-control-blend-ui-utils.ts
    • apps/isis/web/src/pages/workflow-run-utils.ts
    • ISIS_TODOS_2.md