/**
 * LAYOUT: FRAMED (opt-in; agilehomedesign.com's "framed", from its look 3,
 * Editorial Plate). Each piece on its own screen: the photo whole in a mat on
 * paper, the words in a narrow column beside it. The description, when a
 * piece has one, slides up in a tray (a popover: no script). On a portrait or
 * narrow screen the words run under the photo.
 * Built to dist/fluid-layout-framed.min.css (export "./layout-framed"); link
 * it after core. Contract: _docs/layouts.md.
 *
 *   <div class="layout-framed">
 *     <section class="layout-framed__plate" id="oak-table" aria-label="Oak table">
 *       <figure class="layout-framed__photo">
 *         <picture> <source media="(orientation: landscape)" srcset="oak-wide.jpg" …> <img src="oak.jpg" alt="…" width="1200" height="900"> </picture>
 *       </figure>
 *       <div class="layout-framed__text piece-words">
 *         <p class="layout-framed__intro">We build in solid wood.</p>   (first piece only, optional)
 *         <p class="layout-framed__n">01 <span>/ 12</span></p>
 *         <p class="piece-words__kind">Tables</p>
 *         <h2 class="piece-words__name">Oak table</h2>
 *         <p class="piece-words__shown">Shown: white oak, oiled</p>          (optional)
 *         <p class="piece-words__links">
 *           <a href="/inquiries/?about=oak-table">Inquire →</a>
 *           <button type="button" popovertarget="about-oak-table">About this piece</button>   (only with a description)
 *           <button type="button" data-photos="oak-table">3 photos</button>                 (2+ photos; assets/js/layouts.js)
 *         </p>
 *       </div>
 *       <div class="layout-framed__tray" id="about-oak-table" popover>     (only with a description)
 *         <div class="layout-framed__tray-inner">
 *           <p class="piece-words__kind">Tables</p>
 *           <h3 class="layout-framed__tray-title">Oak table</h3>
 *           <div class="prose">…</div>
 *           <button type="button" class="layout-framed__close" popovertarget="about-oak-table" popovertargetaction="hide">Close</button>
 *         </div>
 *       </div>
 *       <ul data-lightbox data-for="oak-table" hidden> … </ul>              (2+ photos)
 *     </section>
 *   </div>
 *
 * A piece with no photo is left out. A sticky site header is the site's job;
 * tell the layout its height with --layout-bar so a plate fits under it.
 * Look hooks, read with fallbacks and never declared: --layout-bar (the
 * header's height, default 4rem), --layout-mat (the mat colour),
 * --layout-name-font.
 */
@layer components {
  :root:has(.layout-framed) { scroll-snap-type: y proximity; }

  .layout-framed picture { display: contents; }

  .layout-framed__plate {
    box-sizing: border-box;
    display: grid;
    grid-template-columns: minmax(0, 1fr) clamp(13.75rem, 22vw, 20rem);
    gap: clamp(1.5rem, 4vw, 4.5rem);
    align-items: center;
    min-block-size: calc(100svh - var(--layout-bar, 4rem));
    padding: clamp(1rem, 3vh, 2.5rem) var(--page-edge) clamp(1.5rem, 5vh, 3.5rem);
    scroll-snap-align: end;
    scroll-margin-block-start: var(--layout-bar, 4rem);
  }

  .layout-framed__photo {
    display: flex;
    justify-content: center;
    align-items: center;
    min-inline-size: 0;
    margin: 0;
  }

  .layout-framed__photo img {
    display: block;
    box-sizing: border-box;
    inline-size: auto;
    block-size: auto;
    max-inline-size: 100%;
    max-block-size: calc(100svh - var(--layout-bar, 4rem) - clamp(2.5rem, 8vh, 6rem));
    padding: clamp(0.625rem, 1.3vw, 1.375rem);
    border: 1px solid var(--color-border-subtle);
    border-radius: 0;
    background: var(--layout-mat, light-dark(oklch(98.5% 0.006 80), oklch(26% 0.008 75)));
    box-shadow: 0 1px 2px rgb(29 25 21 / 0.05), 0 22px 48px -30px rgb(29 25 21 / 0.45);
  }

  .layout-framed__text { gap: var(--space-2); align-self: end; padding-block-end: clamp(0.5rem, 4vh, 3rem); }

  .layout-framed__intro {
    margin: 0 0 clamp(1.5rem, 8vh, 6rem);
    font-family: var(--layout-name-font, var(--font-display));
    font-weight: var(--weight-light);
    font-size: var(--step-1);
    line-height: 1.45;
  }

  .layout-framed__n {
    margin: 0 0 var(--space-1);
    font-size: var(--step--2);
    letter-spacing: var(--tracking-caps);
    font-weight: var(--weight-semibold);
    font-variant-numeric: tabular-nums;
  }

  .layout-framed__n span { font-weight: var(--weight-normal); color: var(--color-text-muted); }

  .layout-framed :is(.piece-words__kind, .piece-words__shown) { color: var(--color-text-muted); opacity: 1; }
  .layout-framed .piece-words__links button { color: var(--color-text-muted); opacity: 1; }
  .layout-framed .piece-words__links button:is(:hover, :focus-visible) { color: var(--color-text); }

  /* The description: a tray that slides up from the bottom. */
  .layout-framed__tray {
    position: fixed;
    inset: auto 0 0;
    inline-size: auto;
    max-inline-size: none;
    max-block-size: min(70svh, 40rem);
    margin: 0;
    padding: 0;
    border: 0;
    border-block-start: 1px solid var(--color-border-subtle);
    background: var(--color-background);
    color: var(--color-text);
    overflow: auto;
    box-shadow: 0 -24px 60px -30px rgb(0 0 0 / 0.4);
    translate: 0 0;
  }

  @media (prefers-reduced-motion: no-preference) {
    .layout-framed__tray {
      transition: translate var(--duration-slow) var(--ease-settle),
        display var(--duration-slow) allow-discrete,
        overlay var(--duration-slow) allow-discrete;
    }
  }

  @starting-style { .layout-framed__tray:popover-open { translate: 0 100%; } }
  .layout-framed__tray:not(:popover-open) { translate: 0 100%; }
  .layout-framed__tray::backdrop { background: rgb(29 25 21 / 0.25); }

  .layout-framed__tray-inner {
    display: grid;
    gap: var(--space-2);
    max-inline-size: 68ch;
    margin-inline: auto;
    padding: clamp(1.75rem, 5vh, 3.5rem) var(--page-edge);
  }

  .layout-framed__tray-title {
    margin: 0;
    font-family: var(--layout-name-font, var(--font-display));
    font-weight: var(--weight-light);
    font-size: var(--step-3);
    line-height: 1.1;
  }

  .layout-framed__close {
    all: unset;
    /* core's button hover paints the accent; these stay text */
    --_btn-bg-hover: transparent;
    --_btn-color-hover: currentColor;
    justify-self: start;
    margin-block-start: var(--space-2);
    cursor: pointer;
    font-size: var(--step--2);
    letter-spacing: var(--tracking-caps);
    text-transform: uppercase;
    border-block-end: 1px solid currentColor;
    padding-block-end: 2px;
  }

  .layout-framed__close:focus-visible { outline: 2px solid var(--color-focus); outline-offset: 4px; }

  /* Portrait or narrow: the words run under the photo; the intro goes above the first. */
  @media (orientation: portrait), (max-width: 47.5rem) {
    .layout-framed__plate {
      grid-template-columns: 1fr;
      gap: var(--space-2);
      align-items: start;
      min-block-size: 0;
      padding-block: 1.25rem 3rem;
      scroll-snap-align: none;
    }

    .layout-framed__photo { margin-block-end: var(--space-3); }
    .layout-framed__photo img { max-block-size: 72svh; }
    .layout-framed__text { display: contents; }
    .layout-framed__intro { order: -1; margin: 0 0 var(--space-4); }
  }

  /* ---------- Piece words (every layout file carries this block) ---------- */
  .piece-words { display: grid; gap: var(--space-1); font-style: normal; text-align: start; }

  .piece-words__kind {
    margin: 0;
    font-size: var(--step--2);
    letter-spacing: var(--tracking-caps);
    text-transform: uppercase;
    opacity: 0.85;
  }

  .piece-words__name {
    margin: 0;
    font-family: var(--layout-name-font, var(--font-display));
    font-weight: var(--weight-light);
    font-size: clamp(1.6rem, 1.1rem + 1.6vw, 2.6rem);
    line-height: 1.05;
  }

  .piece-words__shown { margin: 0; font-size: var(--step--1); opacity: 0.9; }

  .piece-words__links {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-2) var(--space-5);
    align-items: center;
    margin: var(--space-2) 0 0;
    font-size: var(--step--2);
    letter-spacing: var(--tracking-caps);
    text-transform: uppercase;
  }

  .piece-words__links a { color: inherit; text-decoration: none; border-block-end: 1px solid currentColor; padding-block-end: 2px; }

  .piece-words__links button {
    all: unset;
    /* core's button hover paints the accent; these stay text */
    --_btn-bg-hover: transparent;
    --_btn-color-hover: currentColor;
    cursor: pointer;
    opacity: 0.85;
    border-block-end: 1px solid transparent;
    padding-block-end: 2px;
  }

  .piece-words__links button:is(:hover, :focus-visible) { opacity: 1; border-block-end-color: currentColor; }
  /* The ring is the words' own colour: light over photos, ink on paper. */
  .piece-words__links :is(a, button):focus-visible { outline: 2px solid currentColor; outline-offset: 4px; }
}
