@museumwnf/viewer-layout 2.15.1 → 2.16.0

package/README.md

@@ -1,20 +1,67 @@
 # @museumwnf/viewer-layout
 
-Page structure for MWNF websites: `<PageShell>` composing seven optional, token-styled sections. No data access, no routing, no theming values — websites own their `theme/tokens.css`.
-
-`PageShell` covers the needs of every website from props. A website fills the
-sections it has and leaves the rest empty; a slot is for the *content* of a
-section — the mark in the header, the active view — not for rebuilding the
-section. A website that needs something no prop expresses adds the prop
-here, so the next website has it too.
+What the pages of an MWNF website are made of: the page frame, the building
+blocks, the composed views, and the pages of the DXA family (the galleries and
+the exhibitions). Every visual value comes from a `--mwnf-*` token, and a
+website sets its own values in `theme/tokens.css`; the package defines none.
+
+## Entry points and layers
+
+Each entry point belongs to one layer of the platform's
+[architecture reference](https://github.com/museumwithnofrontiers/inventory-app/issues/1510), which says what goes where across
+all the packages:
+
+| Entry | Layer | Holds | Reads |
+| --- | --- | --- | --- |
+| `@museumwnf/viewer-layout` | building blocks | `PageShell` and its seven sections, and every block of `/content` | its props, and the texts and Markdown renderers of `@museumwnf/viewer-core` |
+| `@museumwnf/viewer-layout/content` | building blocks | the blocks alone, without the shell | the same |
+| `@museumwnf/viewer-layout/views` | composed views | whole pages driven by a spec the website declares, with slots it fills | viewer-core's data layer, the site config and the router |
+| `@museumwnf/viewer-layout/components` | composed views | `SiteShell`, the frame composed from `dataset.config.js` | the site config and the current route |
+| `@museumwnf/viewer-layout/dxa` | DXA family layer | the gallery and exhibition pages, `standardRoutes` | the entries above, `@museumwnf/viewer-core` and `@museumwnf/viewer-core/dxa` |
+| `@museumwnf/viewer-layout/style.css` | — | one stylesheet for every entry, the family styles included | — |
+| `@museumwnf/viewer-layout/tokens.reference.css` | — | every token the package reads, with its fallback | — |
+
+A block is fed by its props: a plain view-model built by viewer-core or by
+the website. Beyond its props it reads only viewer-core's texts and
+renderers, and at most the one viewer-core helper its job needs
+(`GlossaryTool` searches the glossary, `SourceCredit` builds the page's
+address). It declares no route and reads no spec: that is what a composed
+view does.
+
+**Where a new component goes:**
+
+1. **Into the lowest layer that fits.** A block comes before a composed view,
+   and a composed view before a family page. A block is promoted here when
+   several websites need the same thing; a whole page is shared only inside
+   the DXA family, under `/dxa`.
+2. **A generic component never defaults to one family's texts.** A block or a
+   composed view defaults to a shared entry (`core.*`, `record.*`,
+   `partner.*`, …) or takes the entry name as a prop; it never defaults to a
+   `gallery.*` or `exhibition.*` entry.
+3. **A component only the DXA family uses belongs under `/dxa`.**
+
+**The dependency runs one way.** The root, `/content`, `/views` and
+`/components` never import from `/dxa`. `/dxa` imports only what the other
+entries publish, and `@museumwnf/viewer-core`. A component that moves
+between entries keeps its old export as an alias until the websites have
+moved; a major release then removes the alias.
+
+Where the package does not follow these rules yet, milestone M10 moves it:
+`FeaturedPartners`, `SiblingGalleries`, `PopupLogo`, `PictureGallery`,
+`PictureNarrative` (blocks) and `RecordSheetView` (a composed view) are used
+only by the DXA family and move under `/dxa`
+([inventory-app#2017](https://github.com/museumwithnofrontiers/inventory-app/issues/2017));
+`PictureGallery`, `PictureNarrative` and `EssayView` default to
+`exhibition.*` entries, and `FeaturedPartners` to `partner.featured`, which
+does not exist.
 
 Two companion docs give a more scannable version of who-owns-what and the
 full slot list: [`docs/designer-contract.md`](docs/designer-contract.md) (the
-four roles — components, tokens/CSS, site designer, translator — and the
-token → overrides → slot → own-view decision ladder) and
-[`docs/slot-catalogue.md`](docs/slot-catalogue.md) (every prop and slot of
-`PageShell`, `SiteShell` and the ten composed views, plus a one-line purpose
-for every `/content` component).
+four roles — components, tokens/CSS, site designer, translator — the
+token → overrides → slot → own-view decision ladder, and where a new
+component goes) and [`docs/slot-catalogue.md`](docs/slot-catalogue.md)
+(every prop and slot of `PageShell`, `SiteShell` and the composed views,
+plus a one-line purpose for every `/content` component).
 
 ## Install
 
@@ -27,7 +74,7 @@ new version is published there.)
 npm install @museumwnf/viewer-layout
 ```
 
-`@museumwnf/viewer-core` (1.14.0 or later) is a peer dependency: the layout
+`@museumwnf/viewer-core` (2.1.0 or later) is a peer dependency: the layout
 reads its texts from the application's catalogue through it, and renders the
 one Markdown prop it has (the banner headline) through its pipeline.
 
@@ -81,6 +128,12 @@ own `t()`.
 
 ## PageShell
 
+`PageShell` covers the needs of every website from props. A website fills the
+sections it has and leaves the rest empty; a slot is for the *content* of a
+section — the mark in the header, the active view — not for rebuilding the
+section. A website that needs something no prop expresses adds the prop
+here, so the next website has it too.
+
 Sections render top to bottom in this fixed order. Every section is optional: it renders nothing unless its slot or driving props are set. The default slot (→ `AppContent`) is where the router-view goes.
 
 | Section | Slot | Props (on PageShell) | Events |
@@ -265,7 +318,8 @@ the application registered, without any router coupling here.
 | `MediaGallery` | `images: [{ url, alt, caption, photographer, copyright }]`, `start`, `variant: '' \| 'row'` | the current image, thumbnails, caption, a lightbox (Escape closes, arrows move, focus returns); `row` renders every image in a row |
 | `GlossaryPopover` | `term: { word, spelling, definition }`, `html`, `dir`; emits `close` | the definition of a clicked term, fixed in a corner; Escape closes, focus returns |
 | `PartnerMap` | `latitude`, `longitude`, `zoom` (15), `mapTitleEntry` ('partner.map.map'), `mapOfEntry` ('partner.map.mapOf'), `openMapLinkEntry` ('partner.map.openInOpenStreetMap'), `label` | an OpenStreetMap embed centred on coordinates with a zoom level; builds a bounding box for OSM's embed and a full-map link; uses keyless public tiles |
-| `FeaturedPartners` | `records: [{ id, name, logo, city, country, description, route }]`, `headingEntry` ('partner.featured') | a carousel of partners with bullet controls, rotated on an 8-second timer; the site provides filtered/shuffled records and routes |
+| `PartnerPanel` | `partner` (viewer-core's `partnerView()`), `variant: 'line' \| 'summary' \| 'full'`, `layout: 'tabs' \| 'sections'` (`full`), `show: { part: false }` (`logo`, `location`, `count`, `pictures`, `description`, `contact`, `persons`, `logos`, `homepage`, `map`; `actions: true` turns on the line's links, `logo: true` the summary's logo), `heading` (level of the name; 0 = none), `label` (summary: the entry before the name), `objectsLabel` ('partner.item.objectsInSite'), `emptyLabel`, `homepageLabel` ('partner.nav.homepage'), `readMoreLabel` ('partner.action.readMore'), `viewObjectsLabel` ('partner.action.viewObjects'), `dir` | one partner, wherever it appears (decisions D2/D3). `line`: a list's row — logo, the name as a link with its city, the object count or `emptyLabel`, the actions. `summary`: the line under an item's holder text — `label`, the name as a link, "city, country"; with `heading`, the name heads the page over its location. `full`: the partner page — the name and location, a band with the About · Contact · Logo tabs (accessible, arrow keys move along), the ↗ homepage link and the `actions` slot, the pictures beside the open panel, the map below; `sections` shows About, Contact and Logo one after another under their titles. The contact reads in legacy order: address, phone, fax, email, website and links, then the contact persons. Slots `badge`, `meta`, `actions`, `after`, each given `{ partner }`; tokens `--mwnf-partner-*` |
+| `FeaturedPartners` | `records: [{ id, name, logo, city, country, description, route }]`, or `partners` (view-models from viewer-core's `partnerView()`: the first picture or logo, "city, country", the description as plain text cut at `descriptionLength`, 420), `headingEntry` ('partner.featured') | a carousel of partners with bullet controls, rotated on an 8-second timer; the site provides filtered/shuffled records and routes |
 | `SiblingGalleries` | `galleries: [{ id, name, image?, route }]`, `museums: [{ name, to \| href, accent?, textColor? }]`, `galleriesHeadingEntry`, `seeMoreGalleriesEntry`, `seeMoreGalleriesHref`, `museumsHeadingEntry` | two blocks of links: sibling galleries (may be unresolved, rendering as non-clickable tiles) and MWNF virtual museums (text initials over a coloured background) |
 | `PopupLogo` | `content` (Markdown or raw HTML), `rawHtml` (false), `enabled` (true), `closeLabel` ('core.action.close') | a dismissible fixed modal for sponsor notices; renders content through `renderInline` by default (escaping, Markdown); when `rawHtml: true`, passes content as-is (for trusted HTML from the importer) |
 | `BackLink` | `label` ('core.action.back'), `to \| href` (fallback when history is unavailable) | a "back" link that calls `router.back()` when browser history is available (length > 1); falls back to the provided route |
@@ -289,16 +343,24 @@ The texts they read — `core.action.apply`, `.reset`, `.close`,
 `record.media.photograph`, `record.sheet.credits`, `.languages` — are in
 every bundle of `@museumwnf/viewer-i18n` from 1.7.0. `GlossaryTool` also reads
 `record.glossary.instructions`, `.definition` (1.7.0) and `record.glossary.tool`
-(2.3.0); `DynastyPopout` reads `record.dynasty.heading` (2.3.0) and
+(2.3.0); `PartnerPanel` reads `partner.info.about`, `.contact`, `.logo`,
+`.addresses`, `.phone`, `.fax`, `partner.nav.homepage`,
+`partner.item.objectsInSite` and `partner.action.readMore`, `.viewObjects` (4.2.0); `DynastyPopout` reads `record.dynasty.heading` (2.3.0) and
 `sheet.field.alsoKnownAs`, `.area`, `.history`. `SourceCredit` reads
 `record.source.label` (2.5.0); the footer attribution (`SiteShell`) reads
 `record.source.rightsHolder` and `.termsOfUse` (2.5.0). `PictureGallery`/
 `PictureNarrative` default to `exhibition.theme.seeItemEntry`, `.recordNotInSite`,
 `.additionalContent`, `.addRelatedWorks`, `.hideRelatedWorks` and
-`exhibition.related.items`, `.reciprocal` — already in every bundle of
-`@museumwnf/viewer-i18n`'s `exhibition` namespace, the same entries
-the-use-of-colours-in-art's and water-in-islam's `Theme.vue` already read.
-Every other text is a prop.
+`exhibition.related.items`, `.reciprocal`, which only the `exhibition` and
+`standalone` bundles of `@museumwnf/viewer-i18n` carry — a family default
+in a generic entry, which ends when the two move under `/dxa` (see
+[Entry points and layers](#entry-points-and-layers)). Every other text is a
+prop.
+
+`FeaturedPartners`, `SiblingGalleries`, `PopupLogo`, `PictureGallery` and
+`PictureNarrative` are used only by the DXA family, and move under `/dxa`
+in milestone M10; their exports here stay as aliases until the websites have
+moved.
 
 ## Content classes
 
@@ -319,9 +381,11 @@ Building blocks copied from the legacy sites' own `site.css` files, available as
 
 ## Composed views
 
-Ten whole pages, made of the content components on viewer-core's
+Whole pages, made of the content components on viewer-core's
 composables and driven by a declaration the website writes instead of a
-page. They are exported from `@museumwnf/viewer-layout/views` — and only from
+page. They are the broad page structures every kind of website shares;
+`RecordSheetView`, used only by the DXA family, moves under `/dxa` with a
+Detail name in milestone M10. They are exported from `@museumwnf/viewer-layout/views` — and only from
 there: they read the records and the engine from `@museumwnf/viewer-core`
 itself, whose entry point carries `.vue` files, and a website's test runner
 that loads this package natively would fail on the first one if the package
@@ -364,10 +428,10 @@ export default {
 | `HomeView` | `config.home` or the same as props: `title`, `intro` (Markdown), `cards: [{ title, description, action, to \| href }]`, `featured: { entity, heading, action, route, eyebrow, meta, seed }` — the pick is `useFeaturedRecord` | `before`, default, `after` |
 | `CatalogueResultsView` | `spec`: `entity`, `keys`, `facets` (viewer-core's facet spec), `facetScope: 'all' \| 'matching'`, `controls: [{ key, type: 'select' \| 'year' \| 'query' \| 'checkbox', label, placeholder, anyLabel, hideEmpty }]`, `filterMode: 'apply' \| 'immediate'`, `scope(record, filters)`, `match(record, filters)`, `narrow(list, filters, helpers)` (a rule over the whole list — a keyword index, say), `dates: { mode, begin, end }`, `sort`, `pageSize`, `variant: 'list' \| 'grid'`, `record(record, helpers)`, `recordRoute`, `summary(context)`, `title`, `filterTitle`, `empty`, `actionLabel`, `pagination` | `before`, `filters`, `actions`, `aside`, `empty`, `after` — each given `{ filters, active, apply, reset, goToPage, matching, pageInfo, options }`, enough to compose the panel in the aside or a second pagination |
 | `RecordView` | `spec` and `id`: `entity`, `translations`, `attribution`, `fields` (viewer-core's `sheetRows` spec, or a function of the context), `sections`, `layout`, `shortDescription`, `media(record, ctx)`, `mediaVariant`, `credits`, `workingNumber`, `citation: { project, permalink: true \| false \| string, heading } \| false` (the permalink is `sourceUrl(currentRoute)` — null, so no address, until the website declares `site.origin` — unless the spec disables it with `false` or overrides it with a string), `related: { variant, heading, record, route } \| false`, `back: { label, to \| href }`, `title(ctx)` | `header`, `before-sheet`, `after-sheet`, `aside`, `source` (under the citation; default `SourceCredit`), `related`, `after`, and one named after every `custom` or `link` row — each given `{ record, text, language, languages, select, dir, glossary, ready, attribution, t, tr }`; `related` also `records` (the rows) and `outside` (the related records the package does not carry) |
-| `RecordSheetView` | Every `RecordView` prop (`spec`, `id`, `entity`) plus `dataGetter(id) => record \| null \| undefined` — a website's own language-subset record lookup (an exhibition's per-build `itemById.get`); omitted, every `id` `RecordView` itself finds is treated as present (the gallery shape); supplied and it reports `id` missing, `NotFoundView` renders before `RecordView` ever mounts (the exhibition shape's per-language-build 404), and it also narrows the related block's `records`/outside-reference split the same way. The DXA gallery/exhibition item sheet's own blocks, on top of `spec`: `sourceDatabase: { label?, chipClass(record, ctx), addToCollection: { label? } \| false } \| false` (the source-database line + `backward_compatibility` code + "add to my collection" link — `chipClass` is a site's own project→colour map, the name comes from `useProjects()`), `notice: { show(record, ctx), label } \| false` (the Explore-partner notice), `museum: { route(partnerId, ctx), label(partnerId, ctx) } \| false` (the holding-museum row — a site's own partner lookup; `route` returning null renders plain text, for a hidden partner), and on `spec.related`: `title`, `description` (entries, above the block), `notInPackageLabel`, `outsideChip(ref, ctx)` (an outside reference's chip — `TODO(#1727)`, no `project_id` on a stub yet), `artisticIntroductionLabel` (with `useProjects().links(record.project_id).artisticIntroductionUrl`), `databaseLabel` (ditto, `.relatedDatabaseUrl`), `overallDatabase: { label, linkLabel } \| false` (`mwnfLinks.overallDatabase`), `onDisplayIn: { linkPendingLabel } \| false` (`record.gallery_references`, by `kind`), `download: false` (default on, `record.action.download`/`.downloadPdf`, prints), `glossary: false` (default on, `GlossaryTool`), `dynasties(record, language, ctx) => { records, tr } \| null` (`DynastyList`), `media: false` (default on, `record.media`, a `SheetSection`), `timeline(record, ctx) => TimelineInfo \| null` (`TimelineLookup` — see `docs/slot-catalogue.md`) | Every `RecordView` slot, forwarded straight through by name, unmodified, **except** `before-sheet`/`museum`/`related`: each always has this view's own default content (above), which a website's own slot still replaces entirely — "a slot fills, the default content renders otherwise" |
+| `RecordSheetView` | Every `RecordView` prop (`spec`, `id`, `entity`) plus `dataGetter(id) => record \| null \| undefined` — a website's own language-subset record lookup (an exhibition's per-build `itemById.get`); omitted, every `id` `RecordView` itself finds is treated as present (the gallery shape); supplied and it reports `id` missing, `NotFoundView` renders before `RecordView` ever mounts (the exhibition shape's per-language-build 404), and it also narrows the related block's `records`/outside-reference split the same way. The DXA gallery/exhibition item sheet's own blocks, on top of `spec`: `sourceDatabase: { label?, chipClass(record, ctx), addToCollection: { label? } \| false } \| false` (the source-database line + `backward_compatibility` code + "add to my collection" link — `chipClass` is a site's own project→colour map, the name comes from `useProjects()`), `notice: { show(record, ctx), label } \| false` (the Explore-partner notice), `museum: { route(partnerId, ctx) } \| false` (the holding-museum row: the item's holder text, then the partner as `PartnerPanel`'s `summary` — "About {name}, {city}, {country}" — linked through `route`; `route` returning null keeps the name without a link, for a hidden partner; `false` keeps the holder text alone; decision D3), and on `spec.related`: `title`, `description` (entries, above the block), `notInPackageLabel`, `outsideChip(ref, ctx)` (an outside reference's chip — `TODO(#1727)`, no `project_id` on a stub yet), `artisticIntroductionLabel` (with `useProjects().links(record.project_id).artisticIntroductionUrl`), `databaseLabel` (ditto, `.relatedDatabaseUrl`), `overallDatabase: { label, linkLabel } \| false` (`mwnfLinks.overallDatabase`), `onDisplayIn: { linkPendingLabel } \| false` (`record.gallery_references`, by `kind`), `download: false` (default on, `record.action.download`/`.downloadPdf`, prints), `glossary: false` (default on, `GlossaryTool`), `dynasties(record, language, ctx) => { records, tr } \| null` (`DynastyList`), `media: false` (default on, `record.media`, a `SheetSection`), `timeline(record, ctx) => TimelineInfo \| null` (`TimelineLookup` — see `docs/slot-catalogue.md`) | Every `RecordView` slot, forwarded straight through by name, unmodified, **except** `before-sheet`/`museum`/`related`: each always has this view's own default content (above), which a website's own slot still replaces entirely — "a slot fills, the default content renders otherwise" |
 | `EssayView` | `spec` and `id`: `tree` (a `useCollectionTree` result, or `{ purpose \| rootId, childType?, entity?, order? }` / `{ themes: true \| 'themes', childType? }` for the view to build one), `entity` (the tree's items — also the tree's own translations entity when `tree` carries none of its own, a pre-built tree or a declarative form with no `entity`/`themes`; falls back to `'collections'`), `route` (a node's own page: a route name or `(node, ctx) => to \| href`), `heading(ctx)`, `placeholder` (a regex a synthesized title matches, falling back to the English title, then the internal name), `quote` / `body` (a field of the node's translation, a dotted path into it such as `'extra.intro_text'`, or a function `(ctx) => Markdown`; default `'quote'`/`'description'`, `false` to drop), `glossary`, `items: { of(node) => ids, caption(item, node, ctx) => override, meta(item, ctx) => [string] (the grid's caption lines), badge(item, ctx) => string, route }`, `panel: { variants(item, ctx) => [{ id, image, alt, caption: { title, justification, fields: [{ label (entry name), value }] } }], fields(item, node, ctx) => [{ label, value }] (the fallback when a variant carries no fields of its own) } \| false`, `navigation: 'tree' \| 'siblings' \| false` (`tree` crosses a branch boundary, `siblings` stays inside the parent), `breadcrumb`, `tabs: true \| 'siblings' \| 'children'` (the strip: `true`/`'siblings'` — the node's own siblings, the default; `'children'` — the node's own children, e.g. a theme's chapters), `about(node) => boolean \| { panel?, navigation? }` (essay only; a plain boolean drops both the picture panel and the navigation, an object keeps the named piece instead), `aboutKeeps: ['panel' \| 'navigation']` (the spec-wide equivalent, when every about page in this spec keeps the same piece), `numbering: 'roman' \| 'decimal' \| false` (counts a node among its true siblings — for a themes-package tree, whose `root` is `null`, that's every node whose own `tree.parents(id)` is also empty, so a themes tree numbers its top-level themes I, II, III); `previous`, `next`, `backTo`, `inThisTheme`, `seeAll` (entry names, defaulting to `exhibition.theme.previous`/`.next`/`.inThisTheme`/`.seeAllInTheme` and `record.action.backToResults`) | `header`, `before-body`, `after-body`, `panel`, `thumbnails`, `aside`, `justifications`, `navigation`, `after` (default `SourceCredit` — nothing until the website declares `site.origin`) — each given `{ node, text, language, tree, items, selected, select, selectedVariant, selectVariant, breadcrumb, previous, next, t, tr }` |
 | `LinkListView` | `spec`: `title` (entry), `groups: [{ heading (entry), links: [{ label, href \| to, note? }] }] \| (ctx) => groups` (`label`/`note` are Markdown, rendered inline through `mdInline`), `back: { label, to \| href } \| false`, `empty` (entry) | `before`, `group` (given `{ group }`; the default renders the heading and its links — replace it for a citation list that is not link-shaped), `after` |
-| `PartnerListView` | `spec`: `entity` (default `'partners'`), `scope(partner, ctx)` (a site's own axis — museum/institution, a curated project — filtered before grouping), `group: { tier: 'level' \| false, order: 'country' \| 'name' }` (over viewer-core's `groupByCountry`; `'name'`: one flat, alphabetical group, no country carries this today), `orderToggle` (an A-Z/Z-A control, mirrored in the query as `order`; every tier is always sorted by name, the toggle reverses the country order or the one flat list), `nested` (an associated partner rendered under its own parent through `partnerHierarchy`, instead of the flat tier column; one whose parent is missing or in another group stays flat), `label(countryId, ctx)` (a group's own country label, required when `group.order` is `'country'`), `record(partner, ctx) => { name, city, logo, count, route }` (the row), `route` (a route name or `(partner, ctx) => to \| href`, read by the default row only), `variant: 'accordion' \| 'open'`, `count` (the "Partners found: N" line), `associatedLabel`/`foundLabel`/`objectsLabel`/`sortAscendingLabel`/`sortDescendingLabel`/`empty`/`title` (entry names, overriding the shared `partner.*` defaults) | `before`, `group-heading` (given `{ group }`; the default renders `group.label`), `row` (given `{ group, partner, row }`, once per partner — main, associated and, when nested, a child row too), `after` — every slot also given `{ t, locale, groups, orderDir, toggleOrder }` |
+| `PartnerListView` | `spec`: `entity` (default `'partners'`), `scope(partner, ctx)` (a site's own axis — museum/institution, a curated project — filtered before grouping), `group: { tier: 'level' \| false, order: 'country' \| 'name' }` (over viewer-core's `groupByCountry`; `'name'`: one flat, alphabetical group, no country carries this today), `orderToggle` (an A-Z/Z-A control, mirrored in the query as `order`; every tier is always sorted by name, the toggle reverses the country order or the one flat list), `nested` (an associated partner rendered under its own parent through `partnerHierarchy`, instead of the flat tier column; one whose parent is missing or in another group stays flat), `label(countryId, ctx)` (a group's own country label, required when `group.order` is `'country'`), `record(partner, ctx) => { name, city, logo, count, route }` (the row, when a site builds it itself), `route` (a route name or `(partner, ctx) => to \| href`, read by the default row only), `objectsRoute(partner, ctx)` (the line's View objects link), `actions: true` (the line's Read more · View objects links), `emptyLabel` (the line for a partner holding nothing), `variant: 'accordion' \| 'open'`, `count` (the "Partners found: N" line), `associatedLabel`/`foundLabel`/`objectsLabel`/`sortAscendingLabel`/`sortDescendingLabel`/`empty`/`title` (entry names, overriding the shared `partner.*` defaults) | `before`, `group-heading` (given `{ group }`; the default renders `group.label`), `row` (given `{ group, partner, row, view }`, once per partner — main, associated and, when nested, a child row too; the default is `PartnerPanel`'s `line` over `view`, viewer-core's `partnerView()`), `after` — every slot also given `{ t, locale, groups, orderDir, toggleOrder }` |
 | `TextPageView` | `spec`: `heading?` (entry), `body` (entry \| (ctx) => Markdown, `ctx` the same `{ t, tr, language }` shape `EssayView`'s spec functions read), `back: { label, to \| href } \| true \| false` | none |
 | `SearchFormView` | `spec`: `mode: 'rows' \| 'facets' \| 'radio'`, `entity` (records an entity-backed facet or `dates: 'buckets'` read), `rows` (`'rows'`: keyword-row count, default 3), `fields: [{ key, label }]` (`'rows'`: the field select), `operators: [{ key, label }]` (`'rows'`: the AND/OR select, default AND/OR), `dates: { presets } \| 'buckets' \| false` (a from/to year select — `centuryPresets`'s asymmetric boundaries, or one `yearBuckets` list used for both ends), `language: entity \| false` (the search-language select, over `useSearchLanguage`), `extras: [{ key, type: 'checkbox', label }]`, `facets: [{ key, label, type: 'select' \| 'year', options: [{ value, label }] }]` (`'facets'`/`'radio'`: options given directly, or derived from `entity`'s own records when left out; `type: 'year'` is a plain number input), `target` (the results route this form writes into), `submitLabel`, `showAllLabel`, `howTo: routeName \| false` (a link to the search-syntax essay) | `intro`, `before`, `extras`, `actions` — each given `{ mode, submit, showAll }` |
 | `TimelineResultsView` | `spec`: `scope: 'country' \| 'local' \| 'collection'` (viewer-core's `useTimelineEvents` axis), `countryLabel(id)`, `countryIdForCode(code)` (DXA's legacy 2-letter code), `collections(ctx) => [{ value, label }]` (Sharing History's exhibition/PC picker — `'pc'` is the Permanent Collection sentinel), `tr(id)` (an event's translation, the site's own), `timelinesEntity`/`eventsEntity` (data package file names), `keys` (default: every control's key), `controls: [{ key: 'country' \| 'collection' \| 'begin' \| 'end', label, placeholder, anyLabel, hideEmpty, options? }]` (`options` on `'begin'`/`'end'`: an array `[{ value, label }]` or function `(ctx) => [...]` for bucketed year selects; without `options`, a free-year number input), `pageSize`, `entrance: false \| true` (renders the form alone, with validation, navigating to `route` on submit), `route` (the entrance's own target route), `event(event, ctx) => { date, caption, description, media, actions }` (the row, see `TimelineEventList`), `gallery: { route, items(ctx) => count \| array \| boolean, label } \| false` (the "See gallery" cross-link — an item's own shape stays the site's), `summary(ctx)`, `errorSelect`, `errorPeriod` (the entrance's own validation entries), `title`, `filterTitle`, `applyLabel`, `resetLabel`, `submitLabel`, `empty`, `pagination` | `summary`, `cross-link`, `event` (replaces the whole events list), `before`, `after` — each given `{ filters, active, apply, reset, goToPage, events, pageInfo, countries, collections, gallery, t, tr }` |
@@ -425,11 +489,27 @@ except where noted:
 
 ## DXA family pages
 
-`@museumwnf/viewer-layout/dxa` ships the gallery/exhibition thin pages
-confirmed byte-identical within each DXA site pair on `origin/main` —
-11 gallery pages (from carpets/amulets), 9 exhibition pages (from
-the-use-of-colours-in-art/water-in-islam) — plus `standardRoutes(family,
-config)`, the RouteRecord factory a site spreads into `extraViews`:
+`@museumwnf/viewer-layout/dxa` is the DXA family layer: the only place
+where whole pages are shared. The galleries are one site with different
+data, and so are the exhibitions — the legacy served each family from one
+application — so a page that is the same on every site of a family lives
+here once, beside the data composables of `@museumwnf/viewer-core/dxa`.
+
+What may go here: a page, a component or a style that only the gallery or
+the exhibition family uses, and that is the same on every site of that
+family. A difference between two sites of a family is a config value or a
+token, not a second copy of the page. Nothing outside `/dxa` imports from
+it, and a website can still replace any family page with its own component
+on the same route name. Texts stay in `@museumwnf/viewer-i18n`'s `gallery`
+and `exhibition` sections.
+
+It ships each family's pages plus `standardRoutes(family, config)`, the
+RouteRecord factory a site spreads into `extraViews`. One page serves both
+families: `PartnerDetail`, the partner page (`PartnerPanel`'s `full`
+variant), fed by each family's own half — `galleryPartnerDetail` /
+`exhibitionPartnerDetail`, which `standardRoutes` passes as its `family`
+prop; `GalleryPartnerProfile`/`ExhibitionPartnerProfile` are the same page
+under their old names.
 
 ```js
 import { standardRoutes } from '@museumwnf/viewer-layout/dxa'

package/dist/BackLink-LfSIuXnL.js

@@ -0,0 +1,45 @@
+import { v as e } from "./TimelineEventList-D5Hot788.js";
+import { createBlock as t, createElementBlock as n, createTextVNode as r, openBlock as i, toDisplayString as a, withCtx as o } from "vue";
+import { useRouter as s } from "vue-router";
+//#region src/content/BackLink.vue
+var c = { class: "mwnf-back-link" }, l = {
+	__name: "BackLink",
+	props: {
+		label: {
+			type: String,
+			default: "core.action.back"
+		},
+		to: {
+			type: [String, Object],
+			default: null
+		},
+		href: {
+			type: String,
+			default: ""
+		}
+	},
+	setup(l) {
+		let u = s();
+		function d() {
+			return window.history.length > 1;
+		}
+		function f(e) {
+			d() && (e.preventDefault(), u.back());
+		}
+		return (s, u) => (i(), n("div", c, [!d() && (l.to || l.href) ? (i(), t(e, {
+			key: 0,
+			to: l.to,
+			href: l.href,
+			class: "mwnf-back-link__button"
+		}, {
+			default: o(() => [r(" ↩ " + a(s.$t(l.label)), 1)]),
+			_: 1
+		}, 8, ["to", "href"])) : (i(), n("button", {
+			key: 1,
+			class: "mwnf-back-link__button",
+			onClick: f
+		}, " ↩ " + a(s.$t(l.label)), 1))]));
+	}
+};
+//#endregion
+export { l as t };