Elonn Docs Platform Documentation

window

spatial reserved authority: world.elonn.local

Window

An independently managed spatial container with z-order, resizing, overlap, focus management, and independent lifecycle.

Window is reserved. It is not a current Elonn primitive.

"Window" implies a desktop OS model (macOS, Windows, visionOS, X11, Wayland). Using it prematurely collapses the surface-oriented spatial runtime into a desktop window manager metaphor.

When window becomes valid:

  • Elonn supports multiple simultaneous movable surfaces
  • Independent positioning exists
  • Surfaces can overlap
  • Persistent spatial placement per surface is supported
  • Simultaneous focus across surfaces is possible

Future evolution path: A surface may detach to become a window (surface → detach → window). Window should emerge from surfaces, not replace them.

Example of correct future usage:

Nearby Surface detached into floating map window

Allowed (future only):

  • window
  • [name] window (e.g., map window, chat window)
  • floating window

Forbidden (now):

  • Do not use window as a synonym for surface, deck, panel, or any current Elonn spatial primitive.
  • Do not use window to describe any current runtime container.

Notes:

  • The moment "window" appears in product copy or architecture diagrams, users expect macOS/Windows/visionOS behavior: z-order, resizing, overlap. Reserve it until the runtime genuinely supports that model.
  • Elonn is building a surface-oriented spatial runtime, not a desktop window manager.

Related:

  • surface (current contextual layer; window may emerge from surface)
  • deck (current navigation structure)
  • panel (distinct; carry-layer content surface)
  • region (distinct; persistent spatial zone)