@glw907/cairn-cms 0.57.0 → 0.58.0

package/dist/components/EditPage.svelte

@@ -1572,6 +1572,7 @@ count, the Prose/Markup posture pair, the focus and typewriter toggles, and the
             bind:this={heroFieldRefs[field.name]}
             field={{ name: field.name, label: field.label }}
             value={heroValue}
+            decorative={heroValue?.decorative ?? false}
             mediaLibrary={mediaLibrary}
             conceptId={data.conceptId}
             id={data.id}

package/dist/components/MediaHeroField.svelte

@@ -2,14 +2,21 @@
 @component
 The hero image frontmatter field: the persistent details-panel field that sets a concept's lead
 picture, the one image that both leads the page and becomes the social card. It edits the structured
-value `{ src, alt, caption }` and writes it to three hidden form inputs the save path's decode arm
-reads. cairn stays markdown-first, so this is a structured-data form field, never a WYSIWYG canvas.
+value `{ src, alt, caption, decorative }` and writes it to four hidden form inputs the save path's
+decode arm reads. cairn stays markdown-first, so this is a structured-data form field, never a
+WYSIWYG canvas.
 
 The field renders inside the edit form (the EditPage details loop). A nested <form> would break SSR,
 so the field carries no <form> of its own: the working inputs in the dialog (the alt input, the
-caption input) carry no name and never submit, and the committed value rides three named hidden
-inputs (`<name>.src`, `<name>.alt`, `<name>.caption`). "Use this image" copies the dialog's working
-state into those hidden inputs; the form's own Save commits them.
+caption input) carry no name and never submit, and the committed value rides four named hidden
+inputs (`<name>.src`, `<name>.alt`, `<name>.caption`, `<name>.decorative`). "Use this image" copies
+the dialog's working state into those hidden inputs; the form's own Save commits them.
+
+The decorative choice persists for the frontmatter hero because the hero value is an object with a
+slot for it. A reload then tells a deliberately decorative hero apart from a left-blank alt, so a
+decorative hero no longer trips the needs-alt notice. A decorative body image (`![](media:...)`)
+cannot persist the same choice, since markdown alt has no slot for it, so a decorative body image
+still reads as needs-alt on reload.
 
 At rest, when a hero is set, the field is one row at sibling weight: the resolved thumbnail, the
 display name, an alt-status chip (Described, Needs alt, or Decorative, each a glyph plus a label,
@@ -49,7 +56,7 @@ popover's runUpload but resolves to this field, not an editor placeholder.
     /** The field descriptor: the form input name base and the visible label. */
     field: { name: string; label: string };
     /** The initial committed value, from `data.frontmatter[field.name]`. */
-    value?: { src: string; alt: string; caption?: string };
+    value?: { src: string; alt: string; caption?: string; decorative?: boolean };
     /** Whether the initial hero is an explicit decorative choice (an empty alt that is not debt).
      *  Defaults false; a fresh field with an empty alt reads as needs-alt. */
     decorative?: boolean;
@@ -444,12 +451,14 @@ popover's runUpload but resolves to this field, not an editor placeholder.
     </p>
   {/if}
 
-  <!-- The committed value rides three named hidden inputs the save path's decode arm reads. They sit
+  <!-- The committed value rides four named hidden inputs the save path's decode arm reads. They sit
        inside the edit form (this component renders in the detailFields loop), so they submit; the
-       dialog's working inputs carry no name and never submit. -->
+       dialog's working inputs carry no name and never submit. The decorative input persists the
+       explicit decorative choice so a reload tells it apart from a left-blank alt. -->
   <input type="hidden" name="{field.name}.src" value={committedSrc} />
   <input type="hidden" name="{field.name}.alt" value={committedAlt} />
   <input type="hidden" name="{field.name}.caption" value={committedCaption} />
+  <input type="hidden" name="{field.name}.decorative" value={committedDecorative ? 'true' : ''} />
 </div>
 
 <!-- The edit dialog: a native modal (focus trap and Escape for free). It sits at the end of the

package/dist/components/MediaHeroField.svelte.d.ts

@@ -11,6 +11,7 @@ interface Props {
         src: string;
         alt: string;
         caption?: string;
+        decorative?: boolean;
     };
     /** Whether the initial hero is an explicit decorative choice (an empty alt that is not debt).
      *  Defaults false; a fresh field with an empty alt reads as needs-alt. */
@@ -36,14 +37,21 @@ interface Props {
 /**
  * The hero image frontmatter field: the persistent details-panel field that sets a concept's lead
  * picture, the one image that both leads the page and becomes the social card. It edits the structured
- * value `{ src, alt, caption }` and writes it to three hidden form inputs the save path's decode arm
- * reads. cairn stays markdown-first, so this is a structured-data form field, never a WYSIWYG canvas.
+ * value `{ src, alt, caption, decorative }` and writes it to four hidden form inputs the save path's
+ * decode arm reads. cairn stays markdown-first, so this is a structured-data form field, never a
+ * WYSIWYG canvas.
  *
  * The field renders inside the edit form (the EditPage details loop). A nested <form> would break SSR,
  * so the field carries no <form> of its own: the working inputs in the dialog (the alt input, the
- * caption input) carry no name and never submit, and the committed value rides three named hidden
- * inputs (`<name>.src`, `<name>.alt`, `<name>.caption`). "Use this image" copies the dialog's working
- * state into those hidden inputs; the form's own Save commits them.
+ * caption input) carry no name and never submit, and the committed value rides four named hidden
+ * inputs (`<name>.src`, `<name>.alt`, `<name>.caption`, `<name>.decorative`). "Use this image" copies
+ * the dialog's working state into those hidden inputs; the form's own Save commits them.
+ *
+ * The decorative choice persists for the frontmatter hero because the hero value is an object with a
+ * slot for it. A reload then tells a deliberately decorative hero apart from a left-blank alt, so a
+ * decorative hero no longer trips the needs-alt notice. A decorative body image (`![](media:...)`)
+ * cannot persist the same choice, since markdown alt has no slot for it, so a decorative body image
+ * still reads as needs-alt on reload.
  *
  * At rest, when a hero is set, the field is one row at sibling weight: the resolved thumbnail, the
  * display name, an alt-status chip (Described, Needs alt, or Decorative, each a glyph plus a label,

package/dist/components/admin-icons.d.ts

@@ -23,3 +23,7 @@ export { default as CopyIcon } from '@lucide/svelte/icons/copy';
 export { default as FileTextIcon } from '@lucide/svelte/icons/file-text';
 export { default as ClockIcon } from '@lucide/svelte/icons/clock';
 export { default as Link2OffIcon } from '@lucide/svelte/icons/link-2-off';
+export { default as RefreshCwIcon } from '@lucide/svelte/icons/refresh-cw';
+export { default as GitBranchIcon } from '@lucide/svelte/icons/git-branch';
+export { default as ArrowRightIcon } from '@lucide/svelte/icons/arrow-right';
+export { default as MegaphoneIcon } from '@lucide/svelte/icons/megaphone';

package/dist/components/admin-icons.js

@@ -25,3 +25,7 @@ export { default as CopyIcon } from '@lucide/svelte/icons/copy';
 export { default as FileTextIcon } from '@lucide/svelte/icons/file-text';
 export { default as ClockIcon } from '@lucide/svelte/icons/clock';
 export { default as Link2OffIcon } from '@lucide/svelte/icons/link-2-off';
+export { default as RefreshCwIcon } from '@lucide/svelte/icons/refresh-cw';
+export { default as GitBranchIcon } from '@lucide/svelte/icons/git-branch';
+export { default as ArrowRightIcon } from '@lucide/svelte/icons/arrow-right';
+export { default as MegaphoneIcon } from '@lucide/svelte/icons/megaphone';

package/dist/components/cairn-admin.css

@@ -2030,6 +2030,120 @@
     }
   }
 
+  @layer daisyui.l1.l2.l3 {
+    :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .\!range {
+      appearance: none !important;
+      webkit-appearance: none !important;
+      --range-thumb: var(--color-base-100) !important;
+      --range-thumb-size: calc(var(--size-selector, .25rem) * 6) !important;
+      --range-progress: currentColor !important;
+      --range-fill: 1 !important;
+      --range-p: .25rem !important;
+      --range-bg: currentColor !important;
+    }
+
+    @supports (color: color-mix(in lab, red, red)) {
+      :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .\!range {
+        --range-bg: color-mix(in oklab, currentColor 10%, #0000) !important;
+      }
+    }
+
+    :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .\!range {
+      cursor: pointer !important;
+      vertical-align: middle !important;
+      --radius-selector-max: calc(var(--radius-selector) + var(--radius-selector) + var(--radius-selector)) !important;
+      border-radius: calc(var(--radius-selector) + min(var(--range-p), var(--radius-selector-max))) !important;
+      width: clamp(3rem, 20rem, 100%) !important;
+      height: var(--range-thumb-size) !important;
+      background-color: #0000 !important;
+      border: none !important;
+      overflow: hidden !important;
+    }
+
+    :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) [dir="rtl"] .\!range {
+      --range-dir: -1 !important;
+    }
+
+    :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .\!range:focus {
+      outline: none !important;
+    }
+
+    :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .\!range:focus-visible {
+      outline-offset: 2px !important;
+      outline: 2px solid !important;
+    }
+
+    :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .\!range::-webkit-slider-runnable-track {
+      background-color: var(--range-bg) !important;
+      border-radius: var(--radius-selector) !important;
+      width: 100% !important;
+      height: calc(var(--range-thumb-size) * .5) !important;
+    }
+
+    @media (forced-colors: active) {
+      :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .\!range::-webkit-slider-runnable-track {
+        border: 1px solid !important;
+      }
+
+      :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .\!range::-moz-range-track {
+        border: 1px solid !important;
+      }
+    }
+
+    :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .\!range::-webkit-slider-thumb {
+      box-sizing: border-box !important;
+      border-radius: calc(var(--radius-selector) + min(var(--range-p), var(--radius-selector-max))) !important;
+      background-color: var(--range-thumb) !important;
+      height: var(--range-thumb-size) !important;
+      width: var(--range-thumb-size) !important;
+      border: var(--range-p) solid !important;
+      appearance: none !important;
+      webkit-appearance: none !important;
+      color: var(--range-progress) !important;
+      box-shadow: 0 -1px oklch(0% 0 0 / calc(var(--depth) * .1)) inset, 0 8px 0 -4px oklch(100% 0 0 / calc(var(--depth) * .1)) inset, 0 1px currentColor, 0 0 0 2rem var(--range-thumb) inset, calc((var(--range-dir, 1) * -100cqw) - (var(--range-dir, 1) * var(--range-thumb-size) / 2)) 0 0 calc(100cqw * var(--range-fill)) !important;
+      position: relative !important;
+      top: 50% !important;
+      transform: translateY(-50%) !important;
+    }
+
+    @supports (color: color-mix(in lab, red, red)) {
+      :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .\!range::-webkit-slider-thumb {
+        box-shadow: 0 -1px oklch(0% 0 0 / calc(var(--depth) * .1)) inset, 0 8px 0 -4px oklch(100% 0 0 / calc(var(--depth) * .1)) inset, 0 1px color-mix(in oklab, currentColor calc(var(--depth) * 10%), #0000), 0 0 0 2rem var(--range-thumb) inset, calc((var(--range-dir, 1) * -100cqw) - (var(--range-dir, 1) * var(--range-thumb-size) / 2)) 0 0 calc(100cqw * var(--range-fill)) !important;
+      }
+    }
+
+    :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .\!range::-moz-range-track {
+      background-color: var(--range-bg) !important;
+      border-radius: var(--radius-selector) !important;
+      width: 100% !important;
+      height: calc(var(--range-thumb-size) * .5) !important;
+    }
+
+    :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .\!range::-moz-range-thumb {
+      box-sizing: border-box !important;
+      border-radius: calc(var(--radius-selector) + min(var(--range-p), var(--radius-selector-max))) !important;
+      height: var(--range-thumb-size) !important;
+      width: var(--range-thumb-size) !important;
+      border: var(--range-p) solid !important;
+      color: var(--range-progress) !important;
+      box-shadow: 0 -1px oklch(0% 0 0 / calc(var(--depth) * .1)) inset, 0 8px 0 -4px oklch(100% 0 0 / calc(var(--depth) * .1)) inset, 0 1px currentColor, 0 0 0 2rem var(--range-thumb) inset, calc((var(--range-dir, 1) * -100cqw) - (var(--range-dir, 1) * var(--range-thumb-size) / 2)) 0 0 calc(100cqw * var(--range-fill)) !important;
+      background-color: currentColor !important;
+      position: relative !important;
+      top: 50% !important;
+    }
+
+    @supports (color: color-mix(in lab, red, red)) {
+      :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .\!range::-moz-range-thumb {
+        box-shadow: 0 -1px oklch(0% 0 0 / calc(var(--depth) * .1)) inset, 0 8px 0 -4px oklch(100% 0 0 / calc(var(--depth) * .1)) inset, 0 1px color-mix(in oklab, currentColor calc(var(--depth) * 10%), #0000), 0 0 0 2rem var(--range-thumb) inset, calc((var(--range-dir, 1) * -100cqw) - (var(--range-dir, 1) * var(--range-thumb-size) / 2)) 0 0 calc(100cqw * var(--range-fill)) !important;
+      }
+    }
+
+    :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .\!range:disabled {
+      cursor: not-allowed !important;
+      opacity: .3 !important;
+    }
+  }
+
   @layer daisyui.l1.l2.l3 {
     :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .range {
       appearance: none;
@@ -3250,6 +3364,10 @@
     order: 2;
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .col-span-3 {
+    grid-column: span 3 / span 3;
+  }
+
   @layer daisyui.l1.l2.l3 {
     :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .hero {
       background-position: center;
@@ -3574,6 +3692,10 @@
     margin-top: calc(var(--spacing) * 1);
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .mt-1\.5 {
+    margin-top: calc(var(--spacing) * 1.5);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .mt-2 {
     margin-top: calc(var(--spacing) * 2);
   }
@@ -3614,6 +3736,10 @@
     margin-right: calc(var(--spacing) * 1);
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .mr-auto {
+    margin-right: auto;
+  }
+
   @layer daisyui.l1.l2.l3 {
     :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .fieldset-legend {
       color: var(--color-base-content);
@@ -3631,6 +3757,10 @@
     margin-bottom: calc(var(--spacing) * 1);
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .mb-1\.5 {
+    margin-bottom: calc(var(--spacing) * 1.5);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .mb-2 {
     margin-bottom: calc(var(--spacing) * 2);
   }
@@ -4163,6 +4293,10 @@
     height: .6875rem;
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .h-\[26px\] {
+    height: 26px;
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .h-\[70vh\] {
     height: 70vh;
   }
@@ -4179,6 +4313,10 @@
     max-height: calc(var(--spacing) * 44);
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .max-h-56 {
+    max-height: calc(var(--spacing) * 56);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .max-h-72 {
     max-height: calc(var(--spacing) * 72);
   }
@@ -4351,6 +4489,10 @@
     width: 19rem;
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .w-\[26px\] {
+    width: 26px;
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .w-\[calc\(100\%-1\.5rem\)\] {
     width: calc(100% - 1.5rem);
   }
@@ -4553,6 +4695,10 @@
     grid-template-columns: repeat(2, minmax(0, 1fr));
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .grid-cols-\[1fr_auto_1fr\] {
+    grid-template-columns: 1fr auto 1fr;
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .grid-cols-\[auto_1fr\] {
     grid-template-columns: auto 1fr;
   }
@@ -4889,6 +5035,16 @@
     border-color: var(--cairn-card-border);
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .border-\[var\(--cairn-card-border\)\]\/70 {
+    border-color: var(--cairn-card-border);
+  }
+
+  @supports (color: color-mix(in lab, red, red)) {
+    :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .border-\[var\(--cairn-card-border\)\]\/70 {
+      border-color: color-mix(in oklab, var(--cairn-card-border) 70%, transparent);
+    }
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .border-\[var\(--cairn-error-border\)\] {
     border-color: var(--cairn-error-border);
   }
@@ -4901,6 +5057,16 @@
     border-color: currentColor;
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .border-primary\/25 {
+    border-color: var(--color-primary);
+  }
+
+  @supports (color: color-mix(in lab, red, red)) {
+    :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .border-primary\/25 {
+      border-color: color-mix(in oklab, var(--color-primary) 25%, transparent);
+    }
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .border-transparent {
     border-color: #0000;
   }
@@ -4981,6 +5147,16 @@
     background-color: var(--cairn-error-tint);
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .bg-\[var\(--cairn-warning-ink\)\]\/10 {
+    background-color: var(--cairn-warning-ink);
+  }
+
+  @supports (color: color-mix(in lab, red, red)) {
+    :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .bg-\[var\(--cairn-warning-ink\)\]\/10 {
+      background-color: color-mix(in oklab, var(--cairn-warning-ink) 10%, transparent);
+    }
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .bg-base-100 {
     background-color: var(--color-base-100);
   }
@@ -5049,6 +5225,16 @@
     }
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .bg-base-content\/\[0\.06\] {
+    background-color: var(--color-base-content);
+  }
+
+  @supports (color: color-mix(in lab, red, red)) {
+    :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .bg-base-content\/\[0\.06\] {
+      background-color: color-mix(in oklab, var(--color-base-content) 6%, transparent);
+    }
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .bg-base-content\/\[0\.07\] {
     background-color: var(--color-base-content);
   }
@@ -5087,6 +5273,16 @@
     }
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .bg-primary\/\[0\.05\] {
+    background-color: var(--color-primary);
+  }
+
+  @supports (color: color-mix(in lab, red, red)) {
+    :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .bg-primary\/\[0\.05\] {
+      background-color: color-mix(in oklab, var(--color-primary) 5%, transparent);
+    }
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .bg-primary\/\[0\.06\] {
     background-color: var(--color-primary);
   }
@@ -5244,6 +5440,10 @@
     }
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .px-0\.5 {
+    padding-inline: calc(var(--spacing) * .5);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .px-1 {
     padding-inline: calc(var(--spacing) * 1);
   }
@@ -5356,6 +5556,10 @@
     padding-top: calc(var(--spacing) * 1);
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .pt-2\.5 {
+    padding-top: calc(var(--spacing) * 2.5);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .pt-3 {
     padding-top: calc(var(--spacing) * 3);
   }
@@ -5549,6 +5753,11 @@
     letter-spacing: .02em;
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .tracking-\[0\.06em\] {
+    --tw-tracking: .06em;
+    letter-spacing: .06em;
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .tracking-\[0\.08em\] {
     --tw-tracking: .08em;
     letter-spacing: .08em;
@@ -5717,6 +5926,16 @@
     }
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .decoration-\[var\(--color-muted\)\]\/55 {
+    text-decoration-color: var(--color-muted);
+  }
+
+  @supports (color: color-mix(in lab, red, red)) {
+    :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .decoration-\[var\(--color-muted\)\]\/55 {
+      text-decoration-color: color-mix(in oklab, var(--color-muted) 55%, transparent);
+    }
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .\[text-underline-offset\:2px\], :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .underline-offset-2 {
     text-underline-offset: 2px;
   }
@@ -5741,6 +5960,10 @@
     opacity: .6;
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .opacity-65 {
+    opacity: .65;
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .opacity-70 {
     opacity: .7;
   }
@@ -5749,6 +5972,10 @@
     opacity: .8;
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .opacity-90 {
+    opacity: .9;
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .opacity-\[0\.62\] {
     opacity: .62;
   }
@@ -6031,9 +6258,9 @@
     }
   }
 
-  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .outline-none {
-    --tw-outline-style: none;
-    outline-style: none;
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .select-all {
+    -webkit-user-select: all;
+    user-select: all;
   }
 
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .select-none {
@@ -6055,6 +6282,19 @@
     margin-top: calc(var(--spacing) * 0);
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .first\:border-t-0:first-child {
+    border-top-style: var(--tw-border-style);
+    border-top-width: 0;
+  }
+
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .checked\:border-\[var\(--cairn-error-ink\)\]:checked {
+    border-color: var(--cairn-error-ink);
+  }
+
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .checked\:bg-\[var\(--cairn-error-ink\)\]:checked {
+    background-color: var(--cairn-error-ink);
+  }
+
   @media (hover: hover) {
     :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .hover\:border-\[color-mix\(in_oklab\,var\(--color-primary\)_45\%\,transparent\)\]:hover {
       border-color: var(--color-primary);
@@ -6181,6 +6421,18 @@
     }
   }
 
+  @media (hover: hover) {
+    :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .hover\:bg-primary\/\[0\.08\]:hover {
+      background-color: var(--color-primary);
+    }
+
+    @supports (color: color-mix(in lab, red, red)) {
+      :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .hover\:bg-primary\/\[0\.08\]:hover {
+        background-color: color-mix(in oklab, var(--color-primary) 8%, transparent);
+      }
+    }
+  }
+
   @media (hover: hover) {
     :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .hover\:text-\[var\(--color-primary\)\]:hover {
       color: var(--color-primary);

package/dist/content/frontmatter.js

@@ -37,6 +37,11 @@ export function frontmatterFromForm(fields, form) {
                 const caption = String(form.get(`${field.name}.caption`) ?? '').trim();
                 if (caption !== '')
                     value.caption = caption;
+                // An explicit decorative choice persists so a reload tells it apart from a left-blank alt.
+                // The key is dropped otherwise to keep committed frontmatter minimal.
+                const decorative = String(form.get(`${field.name}.decorative`) ?? '');
+                if (decorative === 'true')
+                    value.decorative = true;
                 data[field.name] = value;
                 break;
             }

package/dist/content/media-rewrite.d.ts

@@ -0,0 +1,65 @@
+/** One repointed reference: which surface it lived on, the old token as written, and the new token. */
+export interface RepointPlacement {
+    kind: 'body' | 'figure' | 'hero';
+    /** The old `media:` token exactly as it was written in the source. */
+    before: string;
+    /** The new asset's canonical `media:` token (the same value for every placement). */
+    after: string;
+}
+/** The rewritten markdown plus the per-placement diff, in document order (hero first, then body). */
+export interface RepointResult {
+    markdown: string;
+    placements: RepointPlacement[];
+}
+/**
+ * Rewrite every reference to `oldHash` in one entry's raw markdown to `newToken`, and return the
+ * rewritten markdown plus a per-placement diff. Only an image-field `src:` line is rewritten in the
+ * frontmatter: the image-like keys are read via gray-matter and each key's `src:` line is located
+ * structurally within its own block, so a `media:` token that merely appears in a plain-text value (a
+ * `title:` or `description:`) is left untouched, matching extractMediaRefs. Body and figure images are
+ * matched by mdast offset over the body slice. The output is byte-for-byte identical to the input
+ * apart from the replaced token substrings, so the rest of the entry (alt text, captions, the
+ * `:::figure` fences, every other frontmatter key) is preserved exactly. A non-matching hash returns
+ * the markdown unchanged with an empty placement list; a malformed `media:` reference is left
+ * untouched. Pure and node-safe.
+ */
+export declare function repointMediaRef(markdown: string, oldHash: string, newToken: string): RepointResult;
+/** Which alt bucket a placement falls in: an empty alt always gets filled, a non-empty (custom) alt is
+ *  reported and only overwritten on opt-in, and a decorative hero is never touched. */
+export type AltBucket = 'will-fill' | 'customized' | 'decorative-skipped';
+/** One placement of the target hash and what the alt-fill does to it: which surface it lives on, its
+ *  bucket, the existing alt, and the alt after the transform (unchanged for a customized alt left as
+ *  is and for a decorative hero). */
+export interface AltPlacement {
+    kind: 'body' | 'figure' | 'hero';
+    bucket: AltBucket;
+    /** The existing alt, empty string when there is none. */
+    before: string;
+    /** The alt after the transform; equals `before` when nothing changed. */
+    after: string;
+}
+/** The alt-filled markdown plus the per-placement diff, in document order (hero first, then body). */
+export interface AltFillResult {
+    markdown: string;
+    placements: AltPlacement[];
+}
+/**
+ * Set the alt at each placement of `hash` in one entry's raw markdown, and return the rewritten
+ * markdown plus a per-placement diff. An empty alt is filled with `defaultAlt` (bucket will-fill). A
+ * non-empty alt is overwritten with `defaultAlt` only when `opts.overwrite` is true (bucket
+ * customized; otherwise left unchanged but still reported, so the preview can show it and offer the
+ * opt-in). A frontmatter hero with `decorative: true` is bucket decorative-skipped and never changed.
+ * A body or figure image has no decorative slot, so its empty alt is always will-fill.
+ *
+ * The output is byte-for-byte identical to the input apart from the alt text it actually changes. The
+ * hero alt is edited inside the frontmatter block by string splice (no gray-matter serialize round
+ * trip, which would reformat the YAML); the structure read uses gray-matter only to classify buckets
+ * and read the hero alt and decorative flag. A body alt is written escaped (the way insertImage
+ * escapes it) so a `]` in the alt cannot break the image; a hero alt is written as a JSON-quoted YAML
+ * scalar so a colon, a quote, or an empty value is robust. Placements read in document order (hero
+ * first, then body in source order). A non-matching hash returns the markdown unchanged with an empty
+ * placement list. Pure and node-safe.
+ */
+export declare function fillAltForHash(markdown: string, hash: string, defaultAlt: string, opts: {
+    overwrite: boolean;
+}): AltFillResult;