@cogenta/theme-canonical 0.2.0 → 1.1.0

package/src/styles/base.css

@@ -176,6 +176,64 @@ img {
   padding-inline: var(--cg-gutter);
 }
 
+/* --- per-block visual variant (blocks@2.0, RFC 0002) ----------------------
+   `withBlockVariant` (`@cogenta/theme-kit`) stamps one `data-variant-<axis>`
+   attribute per axis an author actually set — never all four, never one this
+   theme does not resolve. Two attribute selectors give every rule here the
+   same specificity, (0,2,0), which is what lets it override `.cg-block`
+   above regardless of source order, without `!important` anywhere.
+
+   `background: 'image'` has no theme mechanism to attach an actual image to
+   a block instance (RFC 0002 adds only the semantic token, not a media
+   field) — resolved to the same tinted surface as the closest honest
+   approximation this theme has, rather than silently doing nothing with a
+   stated author intent.
+   ------------------------------------------------------------------------- */
+
+[data-block][data-variant-background="muted"],
+[data-block][data-variant-background="image"] {
+  padding-block: var(--cg-s10);
+  border-radius: var(--cg-radius-lg);
+}
+
+[data-block][data-variant-background="muted"] {
+  background: var(--cg-surface-sunken);
+}
+
+[data-block][data-variant-background="image"] {
+  background: var(--cg-surface-tinted);
+}
+
+[data-block][data-variant-spacing="compact"] {
+  margin-block: calc(var(--cg-section-y) / 2);
+}
+
+/* No rule for "comfortable": it names this theme's existing default, so an
+   author who picks it explicitly gets exactly what an absent `variant`
+   already gave them — the whole point of "theme default" being a real,
+   selectable option and not only the absence of a choice. */
+
+[data-block][data-variant-spacing="spacious"] {
+  margin-block: calc(var(--cg-section-y) * 1.6);
+}
+
+[data-block][data-variant-align="start"] {
+  text-align: start;
+}
+
+[data-block][data-variant-align="center"] {
+  text-align: center;
+}
+
+[data-block][data-variant-align="end"] {
+  text-align: end;
+}
+
+[data-block][data-variant-width="full"] {
+  max-inline-size: none;
+  padding-inline: 0;
+}
+
 .cg-page__title {
   max-inline-size: var(--cg-page);
   margin-inline: auto;
@@ -188,15 +246,100 @@ img {
   text-wrap: balance;
 }
 
+/* --------------------------------------------------------------------------
+   Entry header (`renderEntryHeader`, `@cogenta/theme-kit`, contract D
+   `theme@1.4`) — the article furniture (`PageContent.entry`) a `richText`
+   entry carries beyond its blocks: an eyebrow of taxonomy terms, the title
+   (replacing the bare `.cg-page__title` this same page would otherwise get
+   — `render-block.ts` renders exactly one of the two), an excerpt, a meta
+   line, a cover image.
+   -------------------------------------------------------------------------- */
+
+.cg-entry-header {
+  max-inline-size: var(--cg-page);
+  margin-inline: auto;
+  margin-block: var(--cg-section-y) var(--cg-s6);
+  padding-inline: var(--cg-gutter);
+}
+
+.cg-entry-header__terms {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--cg-s2);
+  margin: 0 0 var(--cg-s3);
+  padding: 0;
+  list-style: none;
+  font-size: var(--cg-text-sm);
+  font-weight: var(--cg-weight-semibold);
+  letter-spacing: var(--cg-tracking-wide);
+  text-transform: uppercase;
+  color: var(--cg-accent);
+}
+
+.cg-entry-header__terms a {
+  color: inherit;
+  text-decoration: none;
+}
+
+.cg-entry-header__terms li:not(:last-child)::after {
+  content: "·";
+  margin-inline-start: var(--cg-s2);
+  color: var(--cg-ink-muted);
+}
+
+.cg-entry-header__title {
+  margin: 0 0 var(--cg-s4);
+  font-size: var(--cg-text-3xl);
+  line-height: var(--cg-leading-tight);
+  letter-spacing: var(--cg-tracking-tight);
+  font-weight: var(--cg-weight-bold);
+  text-wrap: balance;
+}
+
+.cg-entry-header__excerpt {
+  margin: 0 0 var(--cg-s4);
+  font-size: var(--cg-text-lg);
+  color: var(--cg-ink-muted);
+  text-wrap: pretty;
+}
+
+.cg-entry-header__meta {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--cg-s3);
+  margin: 0 0 var(--cg-s6);
+  font-size: var(--cg-text-sm);
+  color: var(--cg-ink-muted);
+}
+
+.cg-entry-header__meta > :not(:last-child)::after {
+  content: "·";
+  margin-inline-start: var(--cg-s3);
+  color: var(--cg-line-strong);
+}
+
+.cg-entry-header__cover {
+  margin: 0;
+}
+
+.cg-entry-header__cover img,
+.cg-entry-header__cover video {
+  inline-size: 100%;
+  aspect-ratio: 16 / 9;
+  border-radius: var(--cg-radius-lg);
+  object-fit: cover;
+}
+
 .cg-site-header {
   position: sticky;
   inset-block-start: 0;
   z-index: 5;
   padding: var(--cg-s4) var(--cg-gutter);
-  background: color-mix(in oklab, var(--cg-canvas) 82%, transparent);
+  /* Flat and fully opaque, not a frosted-glass blur: a sticky header reads
+     as a solid plane sitting above the page, with a hairline marking where
+     it ends. */
+  background: var(--cg-canvas);
   border-block-end: 1px solid var(--cg-line-soft);
-  /* Progressive: a browser without it simply gets the translucent ground. */
-  backdrop-filter: saturate(1.4) blur(12px);
 }
 
 .cg-site-header__inner,
@@ -218,6 +361,19 @@ img {
   margin-inline-end: auto;
 }
 
+/* The uploaded site logo, when there is one. Height-constrained rather than
+   width-constrained: a wordmark logo and a square mark have wildly different
+   aspect ratios, and only a fixed height keeps the header bar the same
+   height for both. `max-inline-size` is the guard against a very wide
+   wordmark pushing the navigation off the row. */
+.cg-site-header__logo {
+  display: block;
+  block-size: 2rem;
+  inline-size: auto;
+  max-inline-size: 14rem;
+  object-fit: contain;
+}
+
 .cg-site-footer {
   padding: var(--cg-s12) var(--cg-gutter);
   background: var(--cg-surface-sunken);
@@ -226,6 +382,173 @@ img {
   font-size: var(--cg-text-sm);
 }
 
+/* `theme@1.4` (L25 D2) — a button-styled link at the end of the header nav.
+   Reuses `.cg-action`'s own look (see "Actions" below) rather than a second
+   button style. */
+.cg-site-header__action {
+  margin-inline-start: var(--cg-s2);
+}
+
+/* The manual light/dark/system control (`renderThemeToggle`, `@cogenta/
+   theme-kit`) — a plain icon button, not the block vocabulary's `.cg-action`
+   style, so it never reads as a call-to-action competing with a real one. */
+.cg-theme-toggle {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  block-size: 2.25rem;
+  inline-size: 2.25rem;
+  flex-shrink: 0;
+  border-radius: var(--cg-radius-pill);
+  border: 1px solid var(--cg-line-soft);
+  background: transparent;
+  color: var(--cg-ink);
+  cursor: pointer;
+}
+
+.cg-theme-toggle:hover {
+  background: var(--cg-surface-sunken);
+}
+
+.cg-theme-toggle__icon {
+  block-size: 1.1rem;
+  inline-size: 1.1rem;
+}
+
+.cg-theme-toggle__icon--moon {
+  display: none;
+}
+
+/* Icon reflects the *current* effective appearance — sun while light, moon
+   while dark — from the same `[data-theme]`/`prefers-color-scheme` signals
+   `tokens.css` already keys the whole palette on. */
+@media (prefers-color-scheme: dark) {
+  :where(:root:not([data-theme='light'])) .cg-theme-toggle__icon--sun {
+    display: none;
+  }
+  :where(:root:not([data-theme='light'])) .cg-theme-toggle__icon--moon {
+    display: block;
+  }
+}
+
+:where(:root[data-theme='dark']) .cg-theme-toggle__icon--sun {
+  display: none;
+}
+
+:where(:root[data-theme='dark']) .cg-theme-toggle__icon--moon {
+  display: block;
+}
+
+/* `general.tagline`, shown right after the site name in the footer — prose,
+   never a heading, so it stays the same visual weight as the credit line
+   beside it. */
+.cg-site-footer__tagline {
+  margin: var(--cg-s1) 0 0;
+  max-inline-size: 28rem;
+}
+
+.cg-site-footer__social {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--cg-s3);
+  margin: var(--cg-s4) 0 0;
+  padding: 0;
+  list-style: none;
+}
+
+.cg-site-footer__social-item a {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  inline-size: 2.25rem;
+  block-size: 2.25rem;
+  border-radius: var(--cg-radius-md);
+  color: var(--cg-ink-muted);
+  background: var(--cg-surface);
+  box-shadow: var(--cg-ring);
+  transition:
+    color var(--cg-duration-fast) var(--cg-ease),
+    background-color var(--cg-duration-fast) var(--cg-ease);
+}
+
+.cg-site-footer__social-item a:hover,
+.cg-site-footer__social-item a:focus-visible {
+  color: var(--cg-accent-fg);
+  background: var(--cg-accent);
+}
+
+.cg-social__icon {
+  inline-size: 1.1rem;
+  block-size: 1.1rem;
+}
+
+/* `general.footerNote` — a short "about" column, visually distinct from the
+   tagline (which sits with the site name) and from Cogenta's own credit
+   (which stays pinned to the far end of the row, see
+   `.cg-site-footer__branding` above). */
+.cg-site-footer__about {
+  margin-inline-end: auto;
+  max-inline-size: 24rem;
+}
+
+.cg-site-footer__about p {
+  margin: 0;
+}
+
+/* The standard clip-to-1px technique — visible to assistive tech, invisible
+   on screen, unlike `display:none` (which removes it from both). Every
+   social icon link's own text label (`renderSocialLinks`,
+   `@cogenta/theme-kit`) depends on this class existing here: theme-kit ships
+   no CSS of its own (contract D, R5 — a theme owns its own stylesheet). */
+.cg-visually-hidden {
+  position: absolute;
+  inline-size: 1px;
+  block-size: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border: 0;
+}
+
+/* Cogenta's own credit, or its white-label replacement (fiche L21 task 8) —
+   pushed to the far end of the footer row, after the site name and its own
+   navigation, never competing with either for space. */
+.cg-site-footer__branding {
+  margin-inline-start: auto;
+  display: flex;
+  align-items: center;
+}
+
+.cg-site-footer__branding a {
+  display: flex;
+  align-items: center;
+  gap: 0.4em;
+  opacity: 0.7;
+  transition: opacity 0.15s ease;
+}
+
+/* `@cogenta/core`'s package version, next to the logo (fiche 22 tâche 8) — only rendered at all when Cogenta's own credit is on. */
+.cg-site-footer__version {
+  font-variant-numeric: tabular-nums;
+  font-size: 0.9em;
+}
+
+.cg-site-footer__branding a:hover,
+.cg-site-footer__branding a:focus-visible {
+  opacity: 1;
+}
+
+.cg-site-footer__brand-logo {
+  display: block;
+  /* Explicit pixels, not `em`: a footer's own small font-size cascaded into
+     this and made the credit mark unreadably tiny — the same class of bug
+     the admin shell's own logo had before its fix. */
+  block-size: 25px;
+  inline-size: auto;
+}
+
 /* --------------------------------------------------------------------------
    Actions — the theme's only control
    -------------------------------------------------------------------------- */
@@ -339,3 +662,202 @@ img {
   padding-block: var(--cg-s2);
   margin-block: calc(var(--cg-s2) * -1);
 }
+
+/* --------------------------------------------------------------------------
+   Search, forms, comments — public utility pages and post-content furniture
+
+   `/search` (`search-page.ts`), `/forms/{name}` (`forms-page.ts`) and the
+   comment thread appended after an entry page (`comments.ts`) all render
+   real markup with real `cg-*` classes, but none of it had a single rule
+   here (L20 audit, points 8-9) — the stylesheet loaded, the class names were
+   right there in the HTML, and nothing matched. These three follow the same
+   page-width measure `.cg-page__title` already sets, so a search result list
+   or a form lines up under its own heading rather than running edge to edge.
+   -------------------------------------------------------------------------- */
+
+.cg-search__form,
+.cg-search__results,
+.cg-search__empty,
+.cg-search__error,
+.cg-form,
+.cg-form__confirmation,
+.cg-comments {
+  max-inline-size: var(--cg-page);
+  margin-inline: auto;
+  padding-inline: var(--cg-gutter);
+}
+
+.cg-search__form {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: end;
+  gap: var(--cg-s3);
+  margin-block-end: var(--cg-s8);
+}
+
+.cg-search__form label {
+  display: block;
+  font-size: var(--cg-text-sm);
+  font-weight: var(--cg-weight-semibold);
+  margin-block-end: var(--cg-s2);
+}
+
+.cg-search__form input[type="search"] {
+  flex: 1 1 16rem;
+}
+
+.cg-search__results {
+  margin: 0 auto;
+  padding-inline-start: var(--cg-gutter);
+  display: grid;
+  gap: var(--cg-s4);
+  font-size: var(--cg-text-lg);
+}
+
+.cg-search__empty,
+.cg-comments__empty,
+.cg-comments__closed {
+  color: var(--cg-ink-muted);
+}
+
+/* No skin exposes a "danger" colour (contract D has none), so an error reads
+   through weight and a stronger border rather than a hue no skin can change —
+   the same constraint that keeps every other value in this file a function of
+   a token. */
+.cg-search__error,
+.cg-form__error,
+.cg-form__field-error {
+  color: var(--cg-ink);
+  font-weight: var(--cg-weight-bold);
+}
+
+/* Text controls, shared by `/forms/{name}` and the comment form — the same
+   input surface `.cg-search__form input` above uses. */
+.cg-search__form input,
+.cg-form__field input,
+.cg-form__field select,
+.cg-form__field textarea,
+.cg-comment__form input,
+.cg-comment__form textarea {
+  inline-size: 100%;
+  padding: var(--cg-s3) var(--cg-s4);
+  border: 1px solid var(--cg-line);
+  border-radius: var(--cg-radius-md);
+  background: var(--cg-surface);
+  color: var(--cg-ink);
+  font: inherit;
+}
+
+.cg-form__field input[aria-invalid="true"],
+.cg-form__field select[aria-invalid="true"],
+.cg-form__field textarea[aria-invalid="true"] {
+  border-width: 2px;
+  border-color: var(--cg-line-strong);
+}
+
+.cg-search__form button,
+.cg-form button[type="submit"],
+.cg-comment__form button[type="submit"] {
+  padding: var(--cg-s3) var(--cg-s6);
+  border: 0;
+  border-radius: var(--cg-radius-md);
+  background: var(--cg-accent);
+  color: var(--cg-accent-fg);
+  font-weight: var(--cg-weight-semibold);
+  cursor: pointer;
+  transition: background-color var(--cg-duration) var(--cg-ease);
+}
+
+.cg-search__form button:hover,
+.cg-form button[type="submit"]:hover,
+.cg-comment__form button[type="submit"]:hover {
+  background: var(--cg-accent-hover);
+}
+
+.cg-form__field,
+.cg-comment__form p {
+  display: block;
+  margin-block-end: var(--cg-s5);
+}
+
+.cg-form__field label,
+.cg-comment__form label {
+  display: block;
+  font-size: var(--cg-text-sm);
+  font-weight: var(--cg-weight-semibold);
+  margin-block-end: var(--cg-s2);
+}
+
+.cg-form__help {
+  margin: var(--cg-s2) 0 0;
+  font-size: var(--cg-text-sm);
+  color: var(--cg-ink-muted);
+}
+
+.cg-form__choice {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--cg-s2);
+  margin-inline-end: var(--cg-s4);
+  font-weight: normal;
+}
+
+/* Visually hidden, not `display:none`: the honeypot must stay reachable by a
+   naive bot's "fill every input" script while never appearing for anyone
+   else — the same reasoning the inline style already carried before this
+   class existed to do it declaratively for `comments.ts`. */
+.cg-form__honeypot,
+.cg-comment__honeypot {
+  position: absolute;
+  inline-size: 1px;
+  block-size: 1px;
+  overflow: hidden;
+  inset-inline-start: -9999px;
+}
+
+.cg-comments {
+  margin-block-start: var(--cg-section-y);
+  padding-block-start: var(--cg-s8);
+  padding-block-end: var(--cg-section-y);
+  border-block-start: 1px solid var(--cg-line-soft);
+}
+
+.cg-comments__list,
+.cg-comment__replies {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+.cg-comment {
+  padding-block: var(--cg-s5);
+  border-block-end: 1px solid var(--cg-line-soft);
+}
+
+.cg-comment__replies {
+  padding-block-start: var(--cg-s5);
+}
+
+.cg-comment__replies .cg-comment {
+  padding-inline-start: var(--cg-s6);
+  border-inline-start: 2px solid var(--cg-line-soft);
+  border-block-end: 0;
+}
+
+.cg-comment__meta {
+  display: flex;
+  gap: var(--cg-s3);
+  align-items: baseline;
+  font-size: var(--cg-text-sm);
+  color: var(--cg-ink-muted);
+  margin-block-end: var(--cg-s2);
+}
+
+.cg-comment__author {
+  font-weight: var(--cg-weight-semibold);
+  color: var(--cg-ink);
+}
+
+.cg-comment__body {
+  margin: 0;
+}