# @excom

> Nucleus Stack. Guides first, then each element or mixin reference (API, prose, demo source).

## Docs

### Getting Started

- [The Nucleus Stack](./docs/introduction.md) — Rich HTML apps - implementing the novel [ASO architectural pattern](.
- [Quick Start](./docs/quick_start.md) — One HTML file is enough.
- [Core Concepts](./docs/core_concepts.md) — The Nucleus Stack implements an application architecture named ASO: Adapter, State, Orchestrator.

### Guides

- [Using Nucleus Kit Elements](./docs/using_elements.md) — Every Nucleus Kit element obeys the same contract: it is an [Adapter](.
- [Orchestrating](./docs/orchestrating.md) — Quark is the Orchestrator — a derivative of CSS that observes the document and writes back into it.
- [Styling](./docs/styling.md) — Style the state, not the script.
- [Building Views](./docs/building_views.md) — The Nucleus Stack has no components.
- [Business Logic](./docs/business_logic.md) — Pricing, eligibility, entitlements, approvals — the proprietary behaviour nobody can ship for you.
- [Creating Elements](./docs/creating_elements.md) — Most apps won't need to define any of their own custom elements.
- [Best Practices](./docs/best_practices.md) — Short rules with rationale.
- [Troubleshooting](./docs/troubleshooting.md) — Symptom first, then cause, then fix.
- [Debugging with Agents](./docs/debugging_with_agents.md) — An LLM agent can troubleshoot a Nucleus Stack app the way you would in DevTools: read the State, ask why an attribute has its value, test an expression, then edit the sheet.
- [Glossary](./docs/glossary.md) — One definition per term.

### Advanced

- [Diving Deeper](./docs/diving_deeper.md) — This section is for technically curious deep-divers.
- [Quark's origin story](./docs/origin_story.md) — The web platform has always lacked a critical native feature: a way to declaratively map data to the document.
- [Adapter, State, Orchestrator](./docs/adapter_state_orchestrator.md) — ASO is an application architecture where the live document is the program's state — not a depiction of it.
- [Prior Art](./docs/prior_art.md) — ASO was worked out in practice, not derived from theory — but most ideas it contains already have a name.
- [Limitations](./docs/limitations.md) — Below are the costs the Nucleus Stack currently accepts, stated directly, with the rationale for each and the practical response.
- [Roadmap](./docs/roadmap.md) — What is being worked on, what is queued behind it, and what is only an idea.
- [Contributing - help wanted!](./docs/contributing.md) — How to get the monorepo running, what the conventions are, and what a reviewable pull request looks like.

## Elements

- [abortable-element](./abortable-element.md) — AbortController ownership for Neutron elements.
- [content-carousel](./content-carousel.md) — Slide rotator — auto-play, manual nav, slide or fade transition.
- [content-carousel-slide](./content-carousel-slide.md) — One rotating slide of a content-carousel.
- [content-drawer](./content-drawer.md) — Slide-in drawer / sheet — bottom, top, left, or right, with peek stages.
- [content-tabs](./content-tabs.md) — Tabs / accordion — single, multi, or toggle selection.
- [content-tabs-body](./content-tabs-body.md) — Tab panel — visible when its paired header is open.
- [content-tabs-header](./content-tabs-header.md) — Tab header — opens its paired body on click.
- [data-table](./data-table.md) — Sortable / filterable data table — plain tags, one behavior owner.
- [data-th](./data-th.md) — Sortable column header — click toggles sort direction.
- [detect-browser](./detect-browser.md) — CSS-selectable browser, OS, and device metadata.
- [detect-features](./detect-features.md) — CSS-selectable feature support tokens.
- [detect-media](./detect-media.md) — Live media query reflected as `is-matched`.
- [dialog-anchor](./dialog-anchor.md) — Open/close a `<dialog>` — by selector or nearest ancestor.
- [dismiss-watcher](./dismiss-watcher.md) — Escape / back-gesture and outside-click dismissal for any panel.
- [dom-observer](./dom-observer.md)
- [event-handler](./event-handler.md) — Rewire clicks / inputs into events or commands.
- [fetchable-element](./fetchable-element.md)
- [gesture-handler](./gesture-handler.md) — Swipe / pan / pinch / tap recognition as events + CSS variables.
- [include-content](./include-content.md) — Declarative view rendering — lazy (un)load, idle, conditional.
- [listenable-element](./listenable-element.md) — Declarative event / lifecycle listening for Neutron elements.
- [loadable-element](./loadable-element.md) — Loading / success / error state + provision + events, once.
- [mapbox-view](./mapbox-view.md)
- [mapbox-view-marker](./mapbox-view-marker.md)
- [network-status](./network-status.md)
- [provider-fetch](./provider-fetch.md)
- [provider-geolocation](./provider-geolocation.md)
- [provider-orientation](./provider-orientation.md)
- [provider-storage](./provider-storage.md)
- [quark-sheet](./quark-sheet.md) — Load / own a Quark sheet for sibling markup.
- [renderable-element](./renderable-element.md)
- [routable-element](./routable-element.md) — URL matching for Neutron elements.
- [scroll-into-view](./scroll-into-view.md) — Scroll an element into view — on connect, click, or any event.
- [service-worker](./service-worker.md) — Observes `navigator.serviceWorker` — does not register a SW.
- [spa-a](./spa-a.md) — Declarative SPA link with active-state styling.
- [spa-manager](./spa-manager.md) — SPA shell — view transitions, swipe nav, route orchestration.
- [spa-route](./spa-route.md) — Declarative SPA screen — URL match → render.
- [super-form](./super-form.md) — Zero-JS `fetch()` submit for a plain `<form>`.
- [super-img](./super-img.md)
- [super-input](./super-input.md)
- [web-authn](./web-authn.md) — Passkey register / authenticate wired to a `<form>`.