/*
 * Stylesheet order is decided HERE, not by file names.
 *
 * `stylesheet_link_tag :app` links every file in this folder alphabetically, so
 * tokens.css would load last and components.css before layout.css. Each file
 * wraps itself in a cascade layer, and this declaration fixes the priority of
 * those layers whatever order the files arrive in. Later layers win.
 *
 *   vendor      Trix / Action Text defaults (actiontext.css)
 *   tokens      custom properties — the ONLY place a colour literal may appear
 *   base        element defaults, fonts, focus, accessibility helpers
 *   components  the reusable parts in app/views/components/
 *   layout      page frame: container, sections, header, footer, drawer
 *   pages       the odd page-specific rule (keep this small; a big one is a smell)
 *   utilities   single-purpose helpers that must beat everything else
 *
 * components comes BEFORE layout on purpose: a component's defaults (.button,
 * .icon) must lose to the place it is used (.header-cta hidden on phones,
 * .nav-toggle .icon sized up), whatever the specificity. A layer later in the
 * list beats an earlier one outright, so the context has to be the later one.
 *
 * Do not write any rule outside a layer: unlayered CSS beats every layer and
 * would quietly override the whole system.
 */
@layer vendor, tokens, base, components, layout, pages, utilities;
