Eve library

ISIS v2 Environment Tileset Pack Web UI Controls and Validation

Guide

Revision 1

On this page

Generated: 2026-02-28T12:59:56.453Z Checklist: MXA-0173 (ISIS2-00371) Asset Family: environment-tileset-pack Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to 2026-10-30)

Objective#

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

Ergonomic Controls#

  • Tileset Theme (required): present
  • Biome Context (required): present
  • Architectural Style (required): present
  • Tile Set Scope (required): present
  • Tileable Axes (required): present
  • Seam Blend Strategy (required): present
  • Edge Transition Profile (required): present
  • Atlas Layout (required): present
  • Texel Density Class (required): present
  • Material Response Profile (required): present
  • Lighting Reference (required): present
  • Color Palette 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
  • Use Depth Control: present
  • Depth Map: present
  • Depth Strength: present
  • Use Segmentation Control: present
  • Segmentation Map: present
  • Segmentation Strength: present
  • Use Canny Control: present
  • Canny Map: present
  • Canny Strength: present
  • Continuity Profile ID: present
  • Continuity Profile Revision: present
  • Continuity Locked Dimensions: present
  • Scene Profile ID (required): present
  • Style Profile ID (required): present
  • Scene Anchor Reference Image (required): present
  • Use Scene Anchor Reference: present
  • Use Layout Reference: present
  • Layout Reference Map: present
  • Use Lighting Reference: present
  • Lighting Reference Frame: present
  • Use Lens Reference: present
  • Lens Reference Frame: present
  • Focal Length mm (required): present
  • Use Style Lock: present
  • Scene Anchor Lock Strength: present
  • Layout Lock Strength: present
  • Lighting Lock Strength: present
  • Lens Lock Strength: present
  • Style Lock Strength: present

Validation Rules#

  • present: Environment tileset pack workflows require generation type text-to-image.
  • present: Tileset Theme is required.
  • present: Biome Context is required.
  • present: Architectural Style is required.
  • present: Tile Set Scope is required.
  • present: Tileable Axes is required.
  • present: Seam Blend Strategy is required.
  • present: Edge Transition Profile is required.
  • present: Atlas Layout is required.
  • present: Texel Density Class is required.
  • present: Material Response Profile is required.
  • present: Lighting Reference is required.
  • present: Color Palette 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: At least one control must be enabled for control-conditioned workflows.
  • present: Depth Map is required when depth control is enabled.
  • present: Segmentation Map is required when segmentation control is enabled.
  • present: Canny Map is required when canny control is enabled.
  • present: Continuity Profile ID must be scene-continuity-profile.
  • present: Continuity Locked Dimensions is required.
  • present: Scene Profile ID is required.
  • present: Style Profile ID is required.
  • present: Scene Anchor Reference Image is required.
  • present: Layout Reference Map is required when layout 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/environment-tileset-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 environment-tileset-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-0173
  • Ticket key: ISIS2-00371
  • Source references:
    • docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json
    • docs/domains/isis/remediation-v2/ISIS_V2_ENVIRONMENT_TILESET_PACK_REQUIREMENTS_BRIEF.json
    • docs/domains/isis/remediation-v2/ISIS_V2_ENVIRONMENT_TILESET_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/environment-tileset-pack-ui-utils.ts
    • apps/isis/web/src/pages/environment-tileset-pack-ui-utils.spec.ts
    • apps/isis/web/src/pages/workflow-run-utils.ts
    • ISIS_TODOS_2.md