App shell (<kweb-app>)

Purpose

Coordinate modules, manage routing, load/save webs, and normalize preview vs commit behavior.

The app shell is the only component allowed to “know about” other components.

Inputs

Events listened to

• kweb:navigate
• kweb:time-range-set, kweb:time-range-cleared
• kweb:search-query, kweb:search-select
• Authoring events (kweb:node-*, kweb:link-*, kweb:web-*)

Data required

• Current web package (nodes, links, trails)
• UI settings and feature flags

Attributes / properties

• web-id (optional initial)
• features (optional: spheres, inspector)

Outputs

Events emitted

• kweb:selection-changed
• kweb:hover-changed
• kweb:log (optional, for inspector)

Routing

• URL includes:
  • web=<id>
  • node=<id>
  • optional time=<start..end>
• Back/forward must restore selection and view state as far as reasonable.

Definition of done

• [ ] Loads demo web without server calls.
• [ ] URL reflects committed node.
• [ ] Hover does not change URL.
• [ ] Emits selection and hover change events consistently.