/*!
 * Project Name: Convivial GovCMS Morphos
 * File: css/css-layers.css
 * Copyright (c) 2026 Morpht Pty Ltd
 *
 * Pins the CSS cascade-layer order ahead of every other theme stylesheet.
 * Layer order is set by first appearance; declaring it here (loaded first)
 * stops component-group CSS from establishing a different order.
 *
 * The layers (low -> high priority for normal declarations):
 *   properties  - Tailwind v4 fallbacks for --tw-* custom properties
 *   theme       - design tokens / :root variables
 *   base        - preflight reset + element defaults
 *   components  - class-based component styles
 *   utilities   - utility classes
 *
 * `theme, base, components, utilities` are Tailwind's defaults (from
 * `@import "tailwindcss"`); `properties` is the extra layer v4 adds.
 *
 * Why `properties` is first: it carries the --tw-* resets used on browsers
 * without @property support. If it lands after `utilities` it becomes the
 * highest layer and its resets override real utility values (breaking
 * transforms, gradients, shadows, ... on older Safari / iOS).
 *
 * Why hand-authored + unaggregated (preprocess: false): a bare
 * `@layer name, ...;` with no matching blocks is dropped by CSS minifiers
 * (Lightning CSS), so this must NOT go through the Vite/Tailwind build.
 */
@layer properties, theme, base, components, utilities;