Đồ thị topo
Topology graph — hiển thị IR đã biên dịch của Release đang chọn dưới dạng đồ thị tương tác: các vùng chứa ranh giới và hệ thống con, trong đó mỗi ranh giới hoặc hệ thống con được khai báo bên trong một cái khác được vẽ bên trong cái đó, các cạnh được tạo kiểu theo nguồn gốc, kéo và thu phóng, nhấp vào một nút để chọn nó và nhấp đúp để mở tệp nguồn của nó, và nhấp vào một cạnh để chọn kết nối mà cạnh đó vẽ.

Tiêu đề của mỗi vùng chứa nêu cả loại lẫn nhóm của nó, nên hộp ngoài và hộp trong vẫn phân biệt được ngay cả trong một workspace không khai báo cái nào — nơi mà nếu không thì cả hai sẽ mang cùng một tên. Một nhóm không ai khai báo, do trình biên dịch tạo ra cho các thành phần mà một Release hoặc một Aggregate liệt kê ở cấp cao nhất, có tiêu đề cho biết không có nhóm nào được khai báo, và hộp của nó được vẽ khác với hộp của một nhóm đã khai báo — với đường viền chấm trung tính — để nó không bị đọc như một nhóm mang tên đó; một nhóm do bạn khai báo giữ nguyên tên của nó dù tên đó là gì, kể cả default.
Mỗi cạnh có một đầu mũi tên ở đầu mà nó trỏ tới: một cạnh đi từ thành phần sử dụng đến đích của nó, và đầu mũi tên được vẽ bằng chính màu và kiểu nét đứt của cạnh. Hộp của một nút được định kích thước bằng cách đo văn bản mà nó vẽ, cả tên của nút lẫn thành phần bên dưới, nên không cái nào tràn ra ngoài đường viền dù tên thành phần dài đến đâu.
Chú giải ở góc dưới bên trái gọi tên mỗi nhóm theo tài liệu khai báo nó — một ranh giới theo Release, một hệ thống con theo Aggregate — và, nếu bản vẽ có, hộp chứa các nút không thuộc nhóm nào, cùng với những gì nó chứa; chú giải cho biết đầu nào của một cạnh là đích của cạnh; và gọi tên thanh màu dọc theo mép đầu của một nút cùng mỗi màu mà bản vẽ gán cho nó, bên cạnh giá trị component.aggrega.ai/type mà màu đó đại diện, đúng như nhãn được viết, với một hàng cho các nút không mang nhãn đó nếu có. Chú giải cũng nói rõ những màu đó không mang ý nghĩa gì: chúng được gán mỗi khi đồ thị được vẽ, nên chúng nhóm các nút theo loại trong một đồ thị, và cùng một màu trong đồ thị khác không phải là cùng một loại. Chú giải giữ nguyên vị trí dù bạn làm gì với bản vẽ, nên mỗi khi bản vẽ được khớp vào bảng — lần vẽ đầu tiên, và mỗi lần bạn yêu cầu đồ thị — nó được khớp vào phần bảng phía trên chú giải: trong toàn bộ chiều rộng của bảng và chiều cao còn lại phía trên chú giải, căn giữa theo chiều ngang, nên chú giải không che phần nào của bản vẽ dù có bao nhiêu hàng. Trong một bảng quá thấp để còn chỗ phía trên chú giải, bản vẽ được khớp vào toàn bộ bảng.
Chọn một nút sẽ mở một bảng liệt kê những gì được gắn vào nó: với mỗi mục gắn, Feature và phiên bản đã phân giải, khe mà nó lấp hoặc việc nó không lấp khe đã khai báo nào, FeatureRecipe hiện thực hóa nó, theo tên và phiên bản, khi đồ thị đã biên dịch nêu tên một FeatureRecipe, nguồn gốc của nó, các nhãn nó khai báo, và các giá trị do tác giả của nó viết. Một mục gắn được viết trên một trong các kết nối của thành phần — dưới features: trên một mục uses, trong Aggregate hoặc Release — không nằm trong danh sách đó: nó được vẽ trên kết nối mà nó thuộc về, như đồ thị đã biên dịch ghi lại, và bảng của nút cho biết khi các kết nối của nút có mục gắn.
Nhấp vào một cạnh sẽ chọn kết nối mà cạnh đó vẽ và mở bảng cho kết nối đó, với tiêu đề là thành phần sử dụng và đích của nó, nêu tên socket và bí danh, với các mục gắn của kết nối đó được hiển thị giống như của một nút — với mỗi mục, Feature và phiên bản đã phân giải, khe mà nó lấp, FeatureRecipe hiện thực hóa nó khi đồ thị đã biên dịch nêu tên một FeatureRecipe, và các giá trị của nó — hoặc một câu cho biết không có gì được gắn vào. Chọn một nút sẽ bỏ chọn kết nối đang chọn và ngược lại; Escape hoặc nút đóng của bảng sẽ bỏ chọn cái nào cũng được, và việc vẽ lại giữ nguyên lựa chọn trong khi đồ thị dựng lại vẫn vẽ nút đó, hoặc kết nối từ cùng thành phần qua cùng socket với cùng bí danh.
Bên dưới các mục gắn của một nút, trong May attach, bảng liệt kê các Features có phạm vi áp dụng đã khai báo được các nhãn của nút đó thỏa mãn trên đồ thị của Release mà bảng hiển thị — các Features được khai báo bởi các tài liệu trong workspace mà Release đó đọc, tất cả trừ những Features nằm trong một thư mục danh mục chỉ các Releases khác đọc, và những Features nằm trong các thư mục danh mục mà Release đó được build dựa vào — mỗi Feature được nêu tên cùng loại của nó và tệp workspace khai báo nó hoặc danh mục đã cấu hình mà nó được phân giải từ đó. Danh sách đó là những gì các Features đó khai báo là áp dụng cho, không phải một quyết định rằng việc gắn một Feature sẽ build thành công — và khi danh sách trống, nó cho biết rằng không có phạm vi áp dụng đã khai báo của Feature nào khớp với các nhãn đó, đây là một khẳng định hẹp hơn so với việc không có gì có thể gắn. Một yêu cầu mà máy chủ ngôn ngữ không thể trả lời sẽ cho biết điều đó ở vị trí của danh sách thay vì để trống. Một Feature được khai báo phía sau một liên kết dẫn ra ngoài workspace — một liên kết tới một thư mục bên ngoài, hoặc một liên kết được đặt tên như một tệp YAML dẫn tới một tệp bên ngoài — sẽ không được đề xuất, vì máy chủ ngôn ngữ không đọc thực thể nào qua một liên kết như vậy, dù cây tệp của trình soạn thảo của bạn vẫn hiển thị Feature đó. Khi workspace chứa một liên kết như vậy, một dòng bên dưới danh sách, hoặc bên dưới câu thay thế cho danh sách trống, sẽ cho biết điều đó: Features reached through this link are not offered, because it leads outside the Aggrega workspace: (Các Features truy cập qua liên kết này không được đề xuất, vì liên kết này dẫn ra ngoài workspace Aggrega:) theo sau là đường dẫn của liên kết tương đối với workspace — hoặc Features reached through these links are not offered, because each leads outside the Aggrega workspace: (Các Features truy cập qua các liên kết này không được đề xuất, vì mỗi liên kết dẫn ra ngoài workspace Aggrega:) khi có nhiều liên kết, các liên kết tới thư mục đứng trước. Dòng đó nêu tên các liên kết mà máy chủ ngôn ngữ báo cáo theo Release mà bảng hiển thị, giống như bảng Catalog làm theo Release đang chọn. Khi không thể đọc báo cáo đó, danh sách được vẽ không có dòng này và lý do được ghi vào kênh đầu ra Aggrega; một danh sách không thể tạo ra thì không có dòng này.

Mỗi hàng có một điều khiển Attach để xác nhận hàng đó: trình biên dịch được hỏi tài liệu nào khai báo thành phần đang chọn và một mục gắn như vậy thuộc về chỗ nào trong tài liệu đó, rồi mục được ghi vào đó thông qua trình soạn thảo — nhờ vậy nó đi vào lịch sử hoàn tác, nằm trên bộ đệm bạn đang xem thay vì trên phiên bản cuối cùng đã lưu xuống đĩa, và giữ nguyên các chú thích và định dạng xung quanh như bạn đã viết. Không có gì được lưu thay bạn; chỉnh sửa này là một thay đổi như mọi thay đổi khác, và trình biên dịch xác thực lại nó như sau bất kỳ chỉnh sửa nào. Đồ thị được vẽ lại khi bạn lưu, vì topo được biên dịch từ các tài liệu như chúng đang có trên đĩa, và một mục gắn vẫn còn nằm trong bộ đệm thì chưa phải là một phần của chúng. Mục gắn được đặt tên theo Feature, và việc gắn một Feature đã được gắn dưới tên đó sẽ bị từ chối thay vì được ghi hai lần. Một thành phần được khai báo bên trong một hệ thống con được gắn bằng cùng một thao tác nhấn như một thành phần được khai báo ở cấp cao nhất, và cả hai đều hoạt động vì cùng một lý do: đồ thị nhận diện một thành phần theo vị trí của nó trong topo đã biên dịch, vị trí đó không cho biết tác giả của thành phần đã viết những khóa nào, nên tiện ích mở rộng hỏi thay vì tự dựng lại — câu trả lời nêu tên tài liệu và đường dẫn tới khối bên trong nó, và cả hai được đưa vào chỉnh sửa đúng như khi nhận được. Khi không có chỗ nào như vậy để nêu tên — một id mà đồ thị không mang, một nút mà đồ thị không ghi nhận tài liệu nào, hoặc một thành phần mà khối riêng của nó không thể nêu tên trong tài liệu nơi nó được viết — thứ mà bảng hiển thị là lý do trình biên dịch đưa ra, chứ không phải cách diễn đạt riêng của tiện ích mở rộng này.
Bảng của một kết nối được chọn có phần May attach riêng: các slot mà socket của kết nối đó khai báo, theo thứ tự thành phần khai báo chúng, mỗi slot kèm theo việc nó có bắt buộc hay không, thứ lấp đầy nó có xử lý dữ liệu nhạy cảm hay không, phương thức chuyển giao mà nó cho phép, bộ chọn và mô tả của nó, và dưới mỗi slot là các Features mà máy chủ ngôn ngữ trả lời là có thể lấp đầy slot đó trên kết nối này — những Feature có khả năng áp dụng đã khai báo được các nhãn của thành phần tiêu thụ thỏa mãn và có nhãn riêng thỏa mãn bộ chọn của slot. Khi không có slot nào có thể được lấp đầy, bảng cho biết lý do theo cách diễn đạt của máy chủ ngôn ngữ — một Feature đã vẽ kết nối, socket không phải là socket mà thành phần khai báo, hoặc socket không khai báo slot nào — và không đưa ra gì để gắn. Nhấn Attach dưới một slot sẽ ghi Feature dưới tên của slot, là một mục <slot>: có type: chỉ định Feature, vào mục của kết nối đó trong tài liệu đã vẽ kết nối: Release đối với kết nối do Release vẽ, còn lại là Aggregate. Một kết nối được chọn từ mục của nó trong một tài liệu, bằng Aggrega: Attach a Feature to the connection at the cursor, thì thay vào đó được ghi vào tài liệu đó — Release, đối với mục riêng của Release cho một kết nối do Aggregate vẽ — và khi đó dòng của bảng dưới May attach cho biết Feature được ghi vào mục của kết nối đó trong tài liệu nơi lệnh được chạy. Trình biên dịch được hỏi mục đó nằm ở đâu trong tài liệu, mọi phần của đường dẫn mà tài liệu chưa có sẽ được ghi cùng với nó, và chỉnh sửa xuất hiện trong trình soạn thảo giống như của một nút, ở trạng thái chưa lưu. Một slot mà đồ thị đã hiển thị là được lấp đầy trên kết nối đó sẽ bị từ chối trước khi hỏi bất cứ điều gì, và lời từ chối từ trình biên dịch được hiển thị bằng chính lời của nó.
Một giá trị mà trình biên dịch báo cáo là nhạy cảm sẽ bị máy chủ ngôn ngữ giữ lại khỏi đồ thị mà nó gửi, và bị tiện ích mở rộng giữ lại một lần nữa trước khi đồ thị được chuyển đến khung nhìn, vì vậy nó không có trong khung nhìn để hiển thị — bảng nêu tên trường và cho biết lý do nó bị giữ lại, và một mục gắn có dấu đánh dấu độ nhạy cảm ở dạng mà bảng không nhận ra sẽ giữ lại mọi giá trị thay vì phỏng đoán. Một mục gắn được vẽ trên một kết nối bị giữ lại theo đúng quy tắc giống như một mục gắn được vẽ trên một nút, theo cùng một thiết lập. aggrega.graph.showSensitiveValues tắt việc giữ lại cho tác giả cần đọc lại những gì mình đã viết: chỉ khi thiết lập này bật thì yêu cầu đồ thị mới hỏi máy chủ ngôn ngữ về các giá trị đó, và trang cài đặt cho biết điều đó hiển thị gì.
Các nút được bố trí theo thứ tự các đợt của Release được khởi động, vì vậy một boundary khai báo syncWave: sẽ xuất hiện trước các boundary chờ nó. Di chuột qua một nút sẽ hiển thị thành phần và phiên bản đã phân giải của nó, các nhãn, đợt đã khai báo, và siêu dữ liệu riêng của thực thể danh mục — giấy phép, kho mã, trang chủ, từ khóa và người bảo trì — chỉ hiển thị những trường mà thực thể thực sự khai báo.
Một đồ thị đang mở sẽ tự kết xuất lại mỗi khi một tài liệu được soạn trong không gian làm việc được lưu, vì vậy nó theo kịp các chỉnh sửa của bạn mà không cần mở lại; nó vẽ lại khi lưu chứ không phải mỗi lần gõ phím vì topology được biên dịch từ những gì có trên đĩa. Nó cũng vẽ lại khi lockfile của Release được chọn được ghi — bởi Aggrega: Pull, bởi một bản build có Auto pull, hoặc bởi aggrega pull trong terminal — vì đồ thị được ghim theo lockfile đó, và nó cũng vẽ lại khi máy chủ ngôn ngữ có thể trả lời trở lại, nên một đồ thị để mở qua một lần khởi động lại sẽ tự phục hồi.
Một lần vẽ lại mà bạn không yêu cầu sẽ giữ khung nhìn ở nơi bạn đặt nó: thao tác kéo và thu phóng bạn đang có được giữ nguyên, dù topology được dựng lại có khác hay không, vì vậy một nút mà bố cục dựng lại đặt ở chỗ cũ vẫn nằm dưới cùng phần của bảng, còn một nút được đặt ở chỗ khác — một thành phần được thêm vào có thể đẩy các thành phần xung quanh — sẽ di chuyển trong khung nhìn bạn đã giữ thay vì kéo khung nhìn theo. Điều này bao gồm cả lần vẽ lại xảy ra khi đồ thị nằm sau một thẻ khác, mà khi quay lại bạn sẽ thấy nó như lúc rời đi.
Aggrega: Show topology graph khớp lại hình vẽ với bảng, đây là cách quay về toàn bộ hình dạng sau khi phóng to vào một phần. Một topology lớn được khớp toàn bộ thay vì bị cắt, vì vậy một topology lớn sẽ hiện ra nhỏ: bạn thấy nó được ghép như thế nào, và xem được các tên bằng cách phóng to. Khi hai hoặc nhiều nhóm nằm trong một hộp được bố trí cao hơn rộng, chúng được vẽ cạnh nhau thay vì xếp chồng trong một cột, vì vậy một topology lớn tận dụng chiều rộng của bảng và lần khớp đầu tiên vẽ nó lớn hơn mức một cột duy nhất cho phép.
Một lần dựng lại bị trình biên dịch từ chối sẽ giữ hình vẽ bạn đang có thay vì xóa trắng nó — topology vẫn đáng đọc và vẫn là nơi bạn đang làm việc — và làm mờ nó, để một hình vẽ không còn cập nhật không bị nhầm với một hình vẽ đang cập nhật; thông báo phía trên nó nêu lý do của chính trình biên dịch. Hình vẽ trở lại độ rõ đầy đủ ngay khi một hình vẽ mới được dựng. Bố cục được tính trong khung nhìn; trình biên dịch cung cấp topology, không bao giờ cung cấp tọa độ.