agent-zero/webui/components/modals/AGENTS.md
Alessandro ffddc3ebcb Promote Files into shared canvas surface
Add Files to the universal canvas rail and sidebar flow, with a reusable floating surface modal chrome that matches Browser/Desktop behavior.

Make the File Browser modal draggable/resizable with Focus mode, keep Editor on the same draggable modal helper, and preserve dock/undock handoff state.

Harden File Browser startup so empty paths resolve to the default workdir, restyle the Up control, compact New file/New folder actions, and hide Modified before Name/Size in narrow containers.

Update DOX contracts and focused regression coverage for the new Files surface, modal chrome, default-path fallback, and compact layout behavior.
2026-06-23 11:19:58 +02:00

1.1 KiB

Modal Components DOX

Purpose

  • Own WebUI modal component content loaded through the shared modal stack.

Ownership

  • Each direct child folder owns one modal workflow and its store.
  • Modal HTML files own body content, titles, scoped styles, and data-modal-footer content.
  • Modal store files own modal-local state and cleanup.

Local Contracts

  • Use openModal(path) and closeModal() from /js/modals.js.
  • Keep footer content marked with data-modal-footer when using pinned modal actions.
  • Do not introduce a parallel overlay, backdrop, or teleport modal system.

Work Guidance

  • Keep modal state cleanup explicit because stores may outlive DOM nodes.
  • Preserve stacked modal, Escape, click-outside, scroll, and footer behavior.

Verification

  • Smoke-test open, close, Escape, click-outside, scrolling, stacked modals, and pinned footers after modal changes.

Child DOX Index

Direct child DOX files:

Child Scope
file-browser/AGENTS.md File browser modal and right-canvas Files surface workflow.