@sarimarcus/content-sites-ui 0.31.6 → 0.31.7

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All packages in the platform release in lockstep; entries are per release version.
 
+## 0.31.7 (2026-10-09)
+
+- `./primitives` exports `ArrowGlyph`, the bare right-arrow svg that `ArrowLabel` and `LinkArrow` draw, for components that lay out their own label; `class` is emitted verbatim (SLA-3024).
+- `./layout`: `EntityDetailShell`, the frame of an entity detail page. It renders the breadcrumb band, a `data-pagefind-body` wrapper typed by `pagefindType` around the `hero` slot with one sr-only `audience:` span per `audiences` entry, then `<main>` (`mainClass`) holding the default slot in a Container (`column`: `measure` | `content` | `false`), `after-column`, and `closer`. `pagefindScope="page"` wraps `<main>` too; `breadcrumbIgnore={false}` keeps the band indexed (SLA-3025).
+- `./layout`: `BreadcrumbBand` takes `class`, which replaces the band's own classes (keep `pt-16`), and `ListingShell` takes `breadcrumbClass`. Default output is unchanged (SLA-3025).
+- `./affiliate`: `HotelAffiliateCTA` and `AffiliateComparisonTable` derive `data-track-affiliate-provider="amazon"` from Amazon hosts (amazon.<tld>, amzn.to), as they already derived `booking`; an explicit provider still wins. Pages: 5 Dark Skies guides with Amazon comparison rows (SLA-3026).
+
 ## 0.31.6 (2026-10-08)
 
 - No changes; lockstep release with core (SLA-3023).

package/README.md

@@ -12,7 +12,7 @@ text arrives through props and slots.
 ## Primitives
 
 ```ts
-import { Icon, Badge, Chip, ArrowLabel, SectionDivider, LinkArrow, Button, Callout, FeatureList, Blockquote, SectionHeader, ResponsiveImage, ResponsivePicture, PILL_BASE, isBadgeLength, PRICE_LABEL_MAX } from '@sarimarcus/content-sites-ui/primitives';
+import { Icon, Badge, Chip, ArrowLabel, ArrowGlyph, SectionDivider, LinkArrow, Button, Callout, FeatureList, Blockquote, SectionHeader, ResponsiveImage, ResponsivePicture, PILL_BASE, isBadgeLength, PRICE_LABEL_MAX } from '@sarimarcus/content-sites-ui/primitives';
 ```
 
 - `Icon`: any Lucide icon by kebab-case name.
@@ -25,6 +25,8 @@ import { Icon, Badge, Chip, ArrowLabel, SectionDivider, LinkArrow, Button, Callo
   attributes pass through last, so markers such as `data-section-link` reach the element.
 - `ArrowLabel`: a label followed by an arrow that shifts right on `group-hover`. It carries no colour: the caller's
   `class` sets it; `arrowClass` sizes the arrow (default `h-4 w-4`).
+- `ArrowGlyph`: the bare right arrow svg that `ArrowLabel` and `LinkArrow` draw, for a component that lays out its own
+  label. `class` (required) is emitted verbatim, motion included.
 - `SectionDivider`: a break between sections. `variant` is `dots` (default), `line`, or `quote` (with `quote` and
   an optional `source`).
 - `LinkArrow`: a text link with a trailing arrow. `color` is `primary` (default), `secondary`, `accent` or `onImage`;
@@ -88,7 +90,7 @@ state and one bundled controller (idempotent on `astro:page-load`, any number of
 
 ```ts
 import { StaticProsePage, NotFoundPage, ArticlesListingPage, ArticleFeatureCard } from '@sarimarcus/content-sites-ui/editorial';
-import { ListingShell } from '@sarimarcus/content-sites-ui/layout';
+import { EntityDetailShell, ListingShell } from '@sarimarcus/content-sites-ui/layout';
 ```
 
 The route file keeps `getStaticPaths`, queries, URLs, `<Layout title description>` (the SEO length gate reads it) and
@@ -105,7 +107,12 @@ prose stay in the route so the site's link and outbound-domain scanners still se
   `overview-byline`. The overview and the author cards are props. A page above 1 renders only the nav, grid and
   pagination. `rankByCount` ranks a topic's authors or collections by article count.
 - `ListingShell`: listing hubs (breadcrumb, `hero`, `before-main`, Container'd `<main>`, `after-main`), one outer
-  `data-pagefind-ignore`.
+  `data-pagefind-ignore`. `breadcrumbClass` replaces the band's classes (`BreadcrumbBand` `class`).
+- `EntityDetailShell`: entity detail pages. Breadcrumb band, then a `data-pagefind-body` wrapper typed by
+  `pagefindType` around the `hero` slot (with an sr-only `audience:` filter span per `audiences` entry), then `<main>`
+  with the default slot in a measure Container, `after-column`, and `closer` in a default Container.
+  `pagefindScope="page"` wraps `<main>` too; no `pagefindType` means no wrapper; `column={false}` drops the column
+  Container; `closer` defaults to whether the slot was passed. The hero, body and closer stay site markup.
 
 A component exported from a barrel must not carry a `<style>` block: Astro ships it to every page that imports the
 barrel. Put such rules in a stylesheet entry the one route imports.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sarimarcus/content-sites-ui",
-  "version": "0.31.6",
+  "version": "0.31.7",
   "description": "Universal Astro UI components, layout shell and design tokens shared by the content sites.",
   "type": "module",
   "license": "MIT",
@@ -49,6 +49,6 @@
     "@lucide/astro": "^1.23.0",
     "astro": "^7.0.6",
     "tailwindcss": "^4.1.18",
-    "@sarimarcus/content-sites-core": "0.31.6"
+    "@sarimarcus/content-sites-core": "0.31.7"
   }
 }

package/src/affiliate/provider.ts

@@ -2,5 +2,7 @@
 export function providerFromHref(href: string | undefined): string | undefined {
   const host = /^https?:\/\/([^/?#:]+)/i.exec(href ?? '')?.[1]?.toLowerCase();
   if (!host) return undefined;
-  return host === 'booking.com' || host.endsWith('.booking.com') ? 'booking' : undefined;
+  if (host === 'booking.com' || host.endsWith('.booking.com')) return 'booking';
+  if (host === 'amzn.to' || /(?:^|\.)amazon\.(?:com|co\.[a-z]{2}|com\.[a-z]{2}|[a-z]{2})$/.test(host)) return 'amazon';
+  return undefined;
 }

package/src/layout/BreadcrumbBand.astro

@@ -1,18 +1,19 @@
 ---
 /**
  * BreadcrumbBand — the muted strip under the fixed header that holds a page's breadcrumb trail (default slot).
- * `ignore` keeps it out of the Pagefind body.
+ * `ignore` keeps it out of the Pagefind body. `class` replaces the band's own classes (keep `pt-16`, the header offset).
  */
 import Container from './Container.astro';
 
 interface Props {
   ignore?: boolean;
+  class?: string;
 }
 
-const { ignore = true } = Astro.props;
+const { ignore = true, class: className = 'pt-16 bg-muted/50 border-b border-border' } = Astro.props;
 ---
 
-<div class="pt-16 bg-muted/50 border-b border-border" data-pagefind-ignore={ignore ? '' : undefined}>
+<div class={className} data-pagefind-ignore={ignore ? '' : undefined}>
   <Container class="py-3">
     <slot />
   </Container>

package/src/layout/EntityDetailShell.astro

@@ -0,0 +1,84 @@
+---
+/**
+ * EntityDetailShell — the frame of an entity detail page: breadcrumb band, a Pagefind body wrapper around the hero
+ * (`data-pagefind-meta="type:<pagefindType>"`, with one sr-only `audience:<a>` filter span per `audiences` entry
+ * before the hero), then <main> holding the column (default slot), `after-column` and the `closer` Container.
+ * The route keeps Layout, StructuredData (a direct Layout child), the data, the hero and every body block.
+ *
+ * - `pagefindType` omitted: no wrapper; a route that indexes its body puts its own wrapper in the default slot.
+ * - `pagefindScope="page"`: the wrapper also holds <main>, for a page whose whole body is indexed.
+ * - `column={false}`: the default slot goes into <main> as is, for a body that leaves the column.
+ * - `closer`: renders the `closer` slot in a default Container; it defaults to whether that slot was passed.
+ */
+import BreadcrumbBand from './BreadcrumbBand.astro';
+import Container from './Container.astro';
+
+interface Props {
+  pagefindType?: string;
+  pagefindScope?: 'hero' | 'page';
+  audiences?: readonly string[];
+  /** `false` keeps the breadcrumb band in the Pagefind body. */
+  breadcrumbIgnore?: boolean;
+  mainClass?: string;
+  column?: 'measure' | 'content' | false;
+  closer?: boolean;
+}
+
+const {
+  pagefindType,
+  pagefindScope = 'hero',
+  audiences = [],
+  breadcrumbIgnore = true,
+  mainClass = 'pt-6 pb-12 lg:pt-8 lg:pb-20',
+  column = 'measure',
+  closer = Astro.slots.has('closer'),
+} = Astro.props;
+const meta = `type:${pagefindType}`;
+const wrapsPage = Boolean(pagefindType) && pagefindScope === 'page';
+---
+
+<BreadcrumbBand ignore={breadcrumbIgnore}><slot name="breadcrumb" /></BreadcrumbBand>
+
+{/* <main> is spelled out per branch: a dynamic wrapper tag buffers its children and moved hoisted scripts above it. */}
+{wrapsPage ? (
+  <div data-pagefind-body data-pagefind-meta={meta}>
+    {audiences.map((a) => <span class="sr-only" data-pagefind-filter={`audience:${a}`}>{a}</span>)}
+    <slot name="hero" />
+    <main class={mainClass}>
+      {column ? (
+        <Container size={column}><slot /></Container>
+      ) : (
+        <slot />
+      )}
+      <slot name="after-column" />
+      {closer && (
+        <Container><slot name="closer" /></Container>
+      )}
+    </main>
+  </div>
+) : (
+  <Fragment>
+    {pagefindType ? (
+      <div data-pagefind-body data-pagefind-meta={meta}>
+        {audiences.map((a) => <span class="sr-only" data-pagefind-filter={`audience:${a}`}>{a}</span>)}
+        <slot name="hero" />
+      </div>
+    ) : (
+      <Fragment>
+        {audiences.map((a) => <span class="sr-only" data-pagefind-filter={`audience:${a}`}>{a}</span>)}
+        <slot name="hero" />
+      </Fragment>
+    )}
+    <main class={mainClass}>
+      {column ? (
+        <Container size={column}><slot /></Container>
+      ) : (
+        <slot />
+      )}
+      <slot name="after-column" />
+      {closer && (
+        <Container><slot name="closer" /></Container>
+      )}
+    </main>
+  </Fragment>
+)}

package/src/layout/ListingShell.astro

@@ -15,13 +15,15 @@ interface Props {
   contained?: boolean;
   /** `false` keeps the page indexable, for a listing whose bands carry `data-pagefind-body` prose. */
   pagefindIgnore?: boolean;
+  /** Replaces the breadcrumb band's own classes, for a hub whose band takes the hero's colour. */
+  breadcrumbClass?: string;
 }
 
-const { mainClass = 'py-12 lg:py-20', contained = true, pagefindIgnore = true } = Astro.props;
+const { mainClass = 'py-12 lg:py-20', contained = true, pagefindIgnore = true, breadcrumbClass } = Astro.props;
 ---
 
 <div data-pagefind-ignore={pagefindIgnore ? '' : undefined}>
-  <BreadcrumbBand ignore={false}>
+  <BreadcrumbBand ignore={false} class={breadcrumbClass}>
     <slot name="breadcrumb" />
   </BreadcrumbBand>
 

package/src/layout/index.ts

@@ -2,6 +2,7 @@
 export { default as Container } from './Container.astro';
 export { default as BreadcrumbBand } from './BreadcrumbBand.astro';
 export { default as ListingShell } from './ListingShell.astro';
+export { default as EntityDetailShell } from './EntityDetailShell.astro';
 export { default as AsyncStylesheet } from './AsyncStylesheet.astro';
 export { default as DocumentShell } from './DocumentShell.astro';
 export { default as ConsentAnalytics } from './ConsentAnalytics.astro';

package/src/primitives/index.ts

@@ -3,6 +3,7 @@ export { default as Icon } from './Icon.astro';
 export { default as Badge } from './Badge.astro';
 export { default as Chip } from './Chip.astro';
 export { default as ArrowLabel } from './ArrowLabel.astro';
+export { default as ArrowGlyph } from './ArrowGlyph.astro';
 export { default as RatingStars } from './RatingStars.astro';
 export { default as SectionDivider } from './SectionDivider.astro';
 export { default as LinkArrow } from './LinkArrow.astro';