@sarimarcus/content-sites-ui 0.31.6 → 0.32.0

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All packages in the platform release in lockstep; entries are per release version.
 
+## 0.32.0 (2026-10-09)
+
+- Optional label props, so every reader-visible string can come from the site: Pagination `ariaLabel`, `previousLabel`, `nextLabel`, `pageLabel`, `currentPageLabel`; TableOfContents `jumpLabel`, `stickyLabel`; CardCarousel `regionLabel`, `previousLabel`, `nextLabel`; SiteFooter `rightsLabel`, `legalAriaLabel`; NotFoundPage `searchShortcut`; VisitTiming `labels`. Optional `routes` on ArticleCategoryNav and on `toArticleAuthor` (4th argument). English defaults move from the templates into an internal labels module; output is byte-identical (render-diff 48/48) (SLA-2991).
+
+### Breaking
+
+- The `formats` prop is removed from `EntityCard` and `InlineImage` (deprecated in 0.24.0, ignored since) (SLA-2991).
+- `idOf` is removed from `AffiliateCarousel` and `SourceItem` from `./editorial` (use `SourceInput` from `./seo`), both deprecated in 0.31.4 (SLA-2991).
+- `pageTypeOf` is no longer re-exported from `./layout` or `./analytics`; import it from `@sarimarcus/content-sites-core/url`. It was never deprecated here; no site imports it (SLA-2991).
+- Each removal is asserted absent from every site by `scripts/platform/migrations/remove-deprecated.mjs` (SLA-2991).
+
+## 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.32.0",
   "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.32.0"
   }
 }

package/src/affiliate/AffiliateCard.astro

@@ -23,6 +23,7 @@ import Icon from '../primitives/Icon.astro';
 import type { AffiliateCardOptions } from './types';
 import { templateLine } from './templateText';
 import ResponsivePicture from '../primitives/ResponsivePicture.astro';
+import { LABELS } from '../internal/labels';
 
 interface Props extends AffiliateCardOptions {
   href: string;
@@ -65,7 +66,7 @@ const {
   reviewCount = 0,
   duration,
   index = 0,
-  pricePrefix = 'From ',
+  pricePrefix = LABELS.affiliateCard.pricePrefix,
   legacyFractionDigits = false,
   bestSellerAt = 1000,
   skipTheLineBadge = true,
@@ -80,11 +81,11 @@ const {
 } = Astro.props;
 
 const {
-  bestSeller = 'Best Seller',
-  topRated = 'Top Rated',
-  skipTheLine = 'Skip the line',
-  cta = 'Reserve Your Spot',
-  reviewCount: reviewCountLabel = (n: string) => `(${n} reviews)`,
+  bestSeller = LABELS.affiliateCard.bestSeller,
+  topRated = LABELS.affiliateCard.topRated,
+  skipTheLine = LABELS.affiliateCard.skipTheLine,
+  cta = LABELS.affiliateCard.cta,
+  reviewCount: reviewCountLabel = LABELS.affiliateCard.reviewCount,
   verified,
   booksUp,
 } = labels;

package/src/affiliate/AffiliateCardSection.astro

@@ -9,6 +9,7 @@ import AffiliateCard from './AffiliateCard.astro';
 import AffiliateBandShell from './AffiliateBandShell.astro';
 import { bandImageSizes } from './band';
 import type { AffiliateCardItem, AffiliateCardOptions } from './types';
+import { LABELS } from '../internal/labels';
 
 interface Props {
   items: AffiliateCardItem[];
@@ -25,7 +26,7 @@ interface Props {
 
 const {
   items,
-  title = "Recommended Tours & Activities",
+  title = LABELS.affiliateCardSection.title,
   subtitle,
   placement,
   imageFetchpriority,

package/src/affiliate/AffiliateCarousel.astro

@@ -11,14 +11,13 @@ import CardCarousel from '../composed/CardCarousel.astro';
 import AffiliateCard from './AffiliateCard.astro';
 import { selectActivities } from './select';
 import type { AffiliateCardItem, AffiliateCardOptions } from './types';
+import { LABELS } from '../internal/labels';
 
 type Activity = { id?: string | number; title?: string; reviewCount?: number; [key: string]: unknown };
 
 interface Props {
   activities: Activity[];
   ids?: number[];
-  /** @deprecated No site passes it; the default reading stays. Removed in the next minor (SLA-3020). */
-  idOf?: (activity: Activity) => number;
   resolve?: (activity: any) => AffiliateCardItem;
   heading?: string;
   subtitle?: string;
@@ -35,9 +34,8 @@ interface Props {
 const {
   activities,
   ids,
-  idOf = (activity) => Number(String(activity.id ?? '').replace(/^\D+-/, '')),
   resolve = (activity) => activity as AffiliateCardItem,
-  heading = 'Recommended tours',
+  heading = LABELS.affiliateCarousel.heading,
   subtitle,
   headingTag = 'h3',
   headingClass = 'font-display text-lg font-semibold text-foreground',
@@ -49,6 +47,8 @@ const {
   class: className,
 } = Astro.props;
 
+const idOf = (activity: Activity) => Number(String(activity.id ?? '').replace(/^\D+-/, ''));
+
 const shown = selectActivities(
   activities,
   ids ? { pinnedIds: ids, exclusive: true, match: (a, wanted) => idOf(a) === wanted, maxCards } : { dedupeTitles: true, maxCards },

package/src/affiliate/AffiliateComparisonTable.astro

@@ -9,6 +9,7 @@ import Icon from '../primitives/Icon.astro';
 import Badge from '../primitives/Badge.astro';
 import type { ComparisonRow, ComparisonTableLabels } from './types';
 import { providerFromHref } from './provider';
+import { LABELS } from '../internal/labels';
 
 interface Props {
   rows: ComparisonRow[];
@@ -27,9 +28,9 @@ const {
   rows = [],
   title,
   titleTag = 'p',
-  nameLabel = 'Option',
-  priceLabel = 'Price',
-  featureLabel = 'Highlight',
+  nameLabel = LABELS.affiliateComparisonTable.nameLabel,
+  priceLabel = LABELS.affiliateComparisonTable.priceLabel,
+  featureLabel = LABELS.affiliateComparisonTable.featureLabel,
   placement = 'comparison-table',
   provider,
   labels = {},
@@ -37,13 +38,13 @@ const {
 } = Astro.props;
 
 const {
-  caption = 'Comparison of options',
-  ctaColumn = 'Book or view',
-  externalCta = 'Check availability',
-  internalCta = 'View details',
-  externalAria = (cta: string, name: string) => `${cta}: ${name} (opens in a new tab)`,
-  internalAria = (cta: string, name: string) => `${cta}: ${name}`,
-  rated = (rating: number, count?: number) => `Rated ${rating} out of 5${count ? ` from ${count} reviews` : ''}`,
+  caption = LABELS.affiliateComparisonTable.caption,
+  ctaColumn = LABELS.affiliateComparisonTable.ctaColumn,
+  externalCta = LABELS.affiliateComparisonTable.externalCta,
+  internalCta = LABELS.affiliateComparisonTable.internalCta,
+  externalAria = LABELS.affiliateComparisonTable.externalAria,
+  internalAria = LABELS.affiliateComparisonTable.internalAria,
+  rated = LABELS.affiliateComparisonTable.rated,
 } = labels;
 
 const captionText = title ?? caption;

package/src/affiliate/AmazonProductCard.astro

@@ -8,6 +8,7 @@ import Badge from '../primitives/Badge.astro';
 import { CARD_LINK_CLASS, CARD_BODY_CLASS, CARD_CTA_CLASS, CARD_BADGE_CLASS } from './cardClasses';
 import Icon from '../primitives/Icon.astro';
 import { templateLine } from './templateText';
+import { LABELS } from '../internal/labels';
 
 interface Props {
   href: string;
@@ -35,7 +36,7 @@ const {
   category = 'book',
   badge,
   placement = 'card',
-  ctaLabel = 'View on Amazon',
+  ctaLabel = LABELS.amazonProductCard.ctaLabel,
   class: className,
 } = Astro.props;
 

package/src/affiliate/AmazonProductSection.astro

@@ -5,6 +5,7 @@
  */
 import AmazonProductCard from './AmazonProductCard.astro';
 import AffiliateBandShell from './AffiliateBandShell.astro';
+import { LABELS } from '../internal/labels';
 
 interface Product {
   href: string;
@@ -30,7 +31,7 @@ interface Props {
 }
 
 const {
-  title = "Recommended reading",
+  title = LABELS.amazonProductSection.title,
   subtitle,
   products,
   maxCards,

package/src/affiliate/HotelAffiliateCTA.astro

@@ -14,6 +14,7 @@ import { isBadgeLength } from '../primitives/badgeText';
 import type { HotelCtaLabels } from './types';
 import { templateLine } from './templateText';
 import { providerFromHref } from './provider';
+import { LABELS } from '../internal/labels';
 
 
 interface Props {
@@ -63,17 +64,17 @@ const {
 } = Astro.props;
 
 const {
-  headline = (n: string) => `Find the best rate for ${n}`,
-  bookCta = `Book this ${entityNoun}`,
-  searchCta = 'Check prices & availability',
-  bookSubhead = 'Check current availability and rates.',
-  searchSubhead = `Search current prices and availability for this ${entityNoun}.`,
-  from = 'from ',
-  perNight = ' / night',
-  reviews = (n: string) => `(${n} reviews)`,
-  ratingOn = (s: string) => `on ${s}`,
-  freeToSearch = 'Free to search · No sign-up needed',
-  officialSite = `Visit the ${entityNoun}'s official site`,
+  headline = LABELS.hotelAffiliateCTA.headline,
+  bookCta = LABELS.hotelAffiliateCTA.bookCta(entityNoun),
+  searchCta = LABELS.hotelAffiliateCTA.searchCta,
+  bookSubhead = LABELS.hotelAffiliateCTA.bookSubhead,
+  searchSubhead = LABELS.hotelAffiliateCTA.searchSubhead(entityNoun),
+  from = LABELS.hotelAffiliateCTA.from,
+  perNight = LABELS.hotelAffiliateCTA.perNight,
+  reviews = LABELS.hotelAffiliateCTA.reviews,
+  ratingOn = LABELS.hotelAffiliateCTA.ratingOn,
+  freeToSearch = LABELS.hotelAffiliateCTA.freeToSearch,
+  officialSite = LABELS.hotelAffiliateCTA.officialSite(entityNoun),
 } = labels;
 
 const trackProvider = provider ?? providerFromHref(href);

package/src/affiliate/InlineAffiliateCTA.astro

@@ -6,6 +6,7 @@
  * so inline clicks land in the same analytics fields. Render an AffiliateDisclosure nearby.
  */
 import Icon from '../primitives/Icon.astro';
+import { LABELS } from '../internal/labels';
 
 interface Props {
   href: string;
@@ -23,7 +24,7 @@ const {
   href,
   label,
   description,
-  cta = 'See tours',
+  cta = LABELS.inlineAffiliateCTA.cta,
   trackId,
   trackPlacement,
   provider,

package/src/affiliate/StickyCTA.astro

@@ -15,6 +15,7 @@
  * no secondary action: both only reproduce a site's earlier markup byte for byte.
  */
 import Icon from '../primitives/Icon.astro';
+import { LABELS } from '../internal/labels';
 
 interface Props {
   label?: string;
@@ -37,16 +38,16 @@ interface Props {
 }
 
 const {
-  label = 'Reserve Your Spot',
+  label = LABELS.stickyCTA.label,
   anchorId = 'affiliate-tours',
   eyebrow,
-  note = 'Found the right tour? Reserve your spot before it fills.',
+  note = LABELS.stickyCTA.note,
   icon = 'ticket',
   secondary,
   showOnDesktop = false,
   hideWhenVisible,
   dismissKey = 'affiliate-bar-dismissed',
-  dismissLabel = 'Dismiss',
+  dismissLabel = LABELS.stickyCTA.dismissLabel,
   track = true,
   trackId = 'affiliate-sticky-bar',
   inertWhenHidden = true,

package/src/affiliate/TravelpayoutsWidget.astro

@@ -14,6 +14,7 @@
  */
 import TravelpayoutsWidgetBody from './TravelpayoutsWidgetBody.astro';
 import type { WidgetKind as Kind } from './resources';
+import { LABELS } from '../internal/labels';
 
 interface Props {
   kind: Kind;
@@ -38,12 +39,7 @@ const WRAPPER: Record<Kind, string> = {
   train: 'train-search-widget min-h-[280px]',
   car: 'car-rental-widget',
 };
-const LABEL: Record<Kind, string> = {
-  hotel: 'Hotel search',
-  activity: 'Activity search',
-  train: 'Train and bus search',
-  car: 'Car rental search',
-};
+const LABEL: Record<Kind, string> = LABELS.travelpayoutsWidget;
 
 const {
   kind,

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/composed/CardCarousel.astro

@@ -11,6 +11,7 @@
  */
 import Icon from '../primitives/Icon.astro';
 import { deterministicId } from '@sarimarcus/content-sites-core/dom';
+import { LABELS } from '../internal/labels';
 
 interface Props {
   /** Section heading rendered above the track. */
@@ -29,8 +30,12 @@ interface Props {
   /** Optional "view all" link shown next to the arrows. */
   viewAllHref?: string;
   viewAllLabel?: string;
-  /** Accessible label for the scroll region (falls back to the heading). */
+  /** Accessible label for the scroll region (falls back to the heading, then `regionLabel`). */
   ariaLabel?: string;
+  regionLabel?: string;
+  /** Accessible names of the arrows, given the carousel's name (undefined when it has none). */
+  previousLabel?: (name: string | undefined) => string;
+  nextLabel?: (name: string | undefined) => string;
   class?: string;
 }
 
@@ -41,8 +46,11 @@ const {
   description,
   id,
   viewAllHref,
-  viewAllLabel = 'View all',
+  viewAllLabel = LABELS.cardCarousel.viewAllLabel,
   ariaLabel,
+  regionLabel = LABELS.cardCarousel.regionLabel,
+  previousLabel = LABELS.cardCarousel.previousLabel,
+  nextLabel = LABELS.cardCarousel.nextLabel,
   class: className,
 } = Astro.props;
 
@@ -82,7 +90,7 @@ const arrowClass =
         <button
           data-carousel-prev
           type="button"
-          aria-label={`Previous, ${ariaLabel ?? heading ?? 'carousel'}`}
+          aria-label={previousLabel(ariaLabel ?? heading)}
           aria-disabled="true"
           class={arrowClass}
         >
@@ -91,7 +99,7 @@ const arrowClass =
         <button
           data-carousel-next
           type="button"
-          aria-label={`Next, ${ariaLabel ?? heading ?? 'carousel'}`}
+          aria-label={nextLabel(ariaLabel ?? heading)}
           class={arrowClass}
         >
           <Icon name="chevron-right" class="h-4 w-4" aria-hidden="true" />
@@ -103,7 +111,7 @@ const arrowClass =
     id={trackId}
     data-carousel-track
     class="cc-track -mx-4 flex gap-4 overflow-x-auto scroll-px-4 px-4 py-1.5 snap-x snap-mandatory sm:mx-0 sm:scroll-px-0 sm:px-0"
-    aria-label={ariaLabel ?? heading ?? 'Carousel'}
+    aria-label={ariaLabel ?? heading ?? regionLabel}
     role="group"
     tabindex="0"
   >

package/src/composed/EntityCard.astro

@@ -37,8 +37,6 @@ interface Props {
   /** Shown when `image` is absent. */
   fallbackSrc?: string;
   imageAlt: string;
-  /** @deprecated Ignored: images are WebP only (SLA-2960). Removed in the next minor. */
-  formats?: Array<'avif' | 'webp' | 'png' | 'jpeg' | 'jpg' | 'svg'>;
   /** Position in the list: the first `eager` load eagerly, the first one at high priority. */
   index?: number;
   eager?: number;

package/src/composed/FAQ.astro

@@ -8,6 +8,7 @@
  */
 import Icon from '../primitives/Icon.astro';
 import type { TrustedHtml } from '../types/index.ts';
+import { LABELS } from '../internal/labels';
 
 export interface FaqItem {
   questionHtml: TrustedHtml;
@@ -27,7 +28,7 @@ interface Props {
 
 const {
   items,
-  title = 'Frequently asked questions',
+  title = LABELS.faq.title,
   icon = true,
   headingClass = 'text-2xl sm:text-3xl font-normal mb-6 flex items-center gap-3 font-display',
   id,

package/src/composed/InlineImage.astro

@@ -42,8 +42,6 @@ interface Props {
   aspectRatio?: string;
   /** Optional URL to wrap the image in a link */
   href?: string;
-  /** @deprecated Ignored: images are WebP only (SLA-2960). Removed in the next minor. */
-  formats?: 'webp'[];
   /** Additional CSS classes on the outer figure element */
   class?: string;
 }

package/src/composed/Pagination.astro

@@ -5,15 +5,32 @@
  * all agree on URLs.
  */
 import Icon from '../primitives/Icon.astro';
+import { LABELS } from '../internal/labels';
 
 interface Props {
   currentPage: number;
   totalPages: number;
   /** URL of a page number (base path included). */
   href: (page: number) => string;
+  ariaLabel?: string;
+  previousLabel?: string;
+  nextLabel?: string;
+  /** Accessible name of a link to another page. */
+  pageLabel?: (page: number) => string;
+  /** Accessible name of the current page. */
+  currentPageLabel?: (page: number) => string;
 }
 
-const { currentPage, totalPages, href } = Astro.props;
+const {
+  currentPage,
+  totalPages,
+  href,
+  ariaLabel = LABELS.pagination.ariaLabel,
+  previousLabel = LABELS.pagination.previousLabel,
+  nextLabel = LABELS.pagination.nextLabel,
+  pageLabel = LABELS.pagination.pageLabel,
+  currentPageLabel = LABELS.pagination.currentPageLabel,
+} = Astro.props;
 
 const prevPage = currentPage > 1 ? currentPage - 1 : null;
 const nextPage = currentPage < totalPages ? currentPage + 1 : null;
@@ -42,16 +59,16 @@ const edgeBase = `${linkBase} px-3`;
 ---
 
 {totalPages > 1 && (
-  <nav aria-label="Pagination" class="mt-14 flex items-center justify-center gap-2 flex-wrap">
+  <nav aria-label={ariaLabel} class="mt-14 flex items-center justify-center gap-2 flex-wrap">
     {prevPage ? (
       <a href={href(prevPage)} rel="prev" class={edgeBase}>
         <Icon name="arrow-left" class="w-3.5 h-3.5" />
-        <span>Previous</span>
+        <span>{previousLabel}</span>
       </a>
     ) : (
       <span aria-hidden="true" class={`${edgeBase} opacity-40 cursor-default pointer-events-none`}>
         <Icon name="arrow-left" class="w-3.5 h-3.5" />
-        <span>Previous</span>
+        <span>{previousLabel}</span>
       </span>
     )}
 
@@ -64,7 +81,7 @@ const edgeBase = `${linkBase} px-3`;
             <li>
               <span
                 aria-current="page"
-                aria-label={`Page ${item}, current page`}
+                aria-label={currentPageLabel(item)}
                 class={`${numberBase} border-primary bg-primary text-primary-foreground hover:text-primary-foreground`}
               >
                 {item}
@@ -72,7 +89,7 @@ const edgeBase = `${linkBase} px-3`;
             </li>
           ) : (
             <li>
-              <a href={href(item)} aria-label={`Go to page ${item}`} class={numberBase}>
+              <a href={href(item)} aria-label={pageLabel(item)} class={numberBase}>
                 {item}
               </a>
             </li>
@@ -83,12 +100,12 @@ const edgeBase = `${linkBase} px-3`;
 
     {nextPage ? (
       <a href={href(nextPage)} rel="next" class={edgeBase}>
-        <span>Next</span>
+        <span>{nextLabel}</span>
         <Icon name="arrow-right" class="w-3.5 h-3.5" />
       </a>
     ) : (
       <span aria-hidden="true" class={`${edgeBase} opacity-40 cursor-default pointer-events-none`}>
-        <span>Next</span>
+        <span>{nextLabel}</span>
         <Icon name="arrow-right" class="w-3.5 h-3.5" />
       </span>
     )}

package/src/composed/TableOfContents.astro

@@ -7,6 +7,7 @@
 // empty heading on every caller that omits one (SLA-2340); `mb-2` sits behind `title` so an eyebrow-only header does
 // not double the gap.
 import Chip from '../primitives/Chip.astro';
+import { LABELS } from '../internal/labels';
 
 interface TableOfContentsItem {
   label: string;
@@ -19,6 +20,10 @@ interface Props {
   items: TableOfContentsItem[];
   /** Defaults to the title, else 'Table of contents'. */
   ariaLabel?: string;
+  /** The mobile disclosure's summary. */
+  jumpLabel?: string;
+  /** Accessible name of the sticky copy of the nav, given `ariaLabel`. */
+  stickyLabel?: (name: string) => string;
   eyebrow?: string;
   description?: string;
   class?: string;
@@ -37,7 +42,9 @@ interface Props {
 const {
   title = '',
   items,
-  ariaLabel = title || 'Table of contents',
+  ariaLabel = title || LABELS.tableOfContents.ariaLabel,
+  jumpLabel = LABELS.tableOfContents.jumpLabel,
+  stickyLabel = LABELS.tableOfContents.stickyLabel,
   eyebrow,
   description,
   class: className = '',
@@ -74,7 +81,7 @@ const showMini = variant === 'card';
     inert
   >
     <div class="mx-auto max-w-shell px-4 sm:px-6 lg:px-8 py-2.5">
-      <nav class="flex gap-2 overflow-x-auto scrollbar-hide" aria-label={`${ariaLabel} (sticky)`}>
+      <nav class="flex gap-2 overflow-x-auto scrollbar-hide" aria-label={stickyLabel(ariaLabel)}>
         {items.map((item) => (
           <Chip
             href={item.href}
@@ -114,9 +121,7 @@ const showMini = variant === 'card';
   )}
 
   <details class="group md:hidden">
-    <summary class="flex min-h-11 cursor-pointer list-none items-center justify-between rounded-lg border border-border bg-muted/40 px-4 py-2.5 text-sm font-medium text-foreground marker:content-none">
-      Jump to a section
-      <span class="text-primary transition-transform group-open:rotate-180" aria-hidden="true">⌄</span>
+    <summary class="flex min-h-11 cursor-pointer list-none items-center justify-between rounded-lg border border-border bg-muted/40 px-4 py-2.5 text-sm font-medium text-foreground marker:content-none">{`\n${jumpLabel}\n`}<span class="text-primary transition-transform group-open:rotate-180" aria-hidden="true">⌄</span>
     </summary>
     <nav class="mt-3 grid gap-2" aria-label={ariaLabel}>
       {items.map((item) => (

package/src/editorial/AlsoExplore.astro

@@ -1,6 +1,7 @@
 ---
 /** "Also explore": up to four sibling links under a hairline, at the foot of a hub or listing page. */
 import Icon from '../primitives/Icon.astro';
+import { LABELS } from '../internal/labels';
 
 export interface AlsoExploreItem {
   href: string;
@@ -13,7 +14,7 @@ interface Props {
   class?: string;
 }
 
-const { eyebrow = 'Also explore', items, class: className } = Astro.props;
+const { eyebrow = LABELS.alsoExplore.eyebrow, items, class: className } = Astro.props;
 
 if (import.meta.env.DEV && items.length > 4) {
   console.warn(`AlsoExplore: received ${items.length} items, capping at 4.`);