@museumwnf/viewer-core 2.16.0 → 2.17.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@museumwnf/viewer-core",
-  "version": "2.16.0",
+  "version": "2.17.0",
   "description": "Application engine for MWNF websites: turns a dataset.config.js into a mounted Vue application.",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE.md",

package/src/conventions.js

@@ -18,6 +18,7 @@ import { resolveRecordLanguage } from './composables/useRecordLanguage.js'
 //     site_url: 'https://…' | null,
 //     related_database_url: 'https://…' | null,
 //     artistic_introduction_url: 'https://…' | null,
+//     home_site: '<site slug>' | null,          // the site home to its records
 //   }
 //
 // A data package built before this phase simply has no `projects` key at
@@ -49,10 +50,12 @@ export function projectLabel(manifest, projectId, lang) {
 }
 
 /**
- * The three URLs `manifest.projects[projectId]` carries. `null` for the
- * whole result (not per field) when the package predates the section or
- * does not carry `projectId`; each field is `null` on its own when the
- * project simply has no value for it (import time never invents one).
+ * The three URLs `manifest.projects[projectId]` carries, and `homeSite`, the
+ * slug of the site home to the project's records (`siblingSiteUrl` turns it
+ * into an address). `null` for the whole result (not per field) when the
+ * package predates the section or does not carry `projectId`; each field is
+ * `null` on its own when the project simply has no value for it (import
+ * time never invents one).
  */
 export function projectLinks(manifest, projectId) {
   const entry = projectEntry(manifest, projectId)
@@ -61,6 +64,7 @@ export function projectLinks(manifest, projectId) {
     siteUrl: entry.site_url ?? null,
     relatedDatabaseUrl: entry.related_database_url ?? null,
     artisticIntroductionUrl: entry.artistic_introduction_url ?? null,
+    homeSite: entry.home_site ?? null,
   }
 }
 

package/src/index.js

@@ -19,7 +19,7 @@ export { languageLabels, offeredLanguages } from './languages.js'
 export { defaultScrollBehavior, resolveViews } from './router/index.js'
 export { mediaUrl, useSiteConfig } from './siteConfig.js'
 export { bindDisplayLanguage, displayLanguage } from './displayLanguage.js'
-export { sourceUrl, useSiteRights } from './rights.js'
+export { siblingSiteUrl, sourceUrl, useSiteRights } from './rights.js'
 
 // The list pages: query state, pagination, facets, dates, keyword search.
 export { useListQuery } from './catalogue/listQuery.js'

package/src/rights.js

@@ -30,7 +30,13 @@ export function useSiteRights() {
   }
 }
 
-const TRAILING_SLASHES = /\/+$/
+// The declared origin without the trailing slashes a site may have put on it
+// (a loop, not a regular expression: an origin is the site's own input).
+function siteOrigin() {
+  let origin = String(useSiteConfig().site?.origin ?? '')
+  while (origin.endsWith('/')) origin = origin.slice(0, -1)
+  return origin
+}
 
 /**
  * The address of `route` on this deployment: the declared `site.origin`
@@ -43,7 +49,7 @@ const TRAILING_SLASHES = /\/+$/
  * same way a `<router-link>` would.
  */
 export function sourceUrl(route) {
-  const origin = String(useSiteConfig().site?.origin ?? '').replace(TRAILING_SLASHES, '')
+  const origin = siteOrigin()
   if (!origin) return null
   const fullPath =
     typeof route === 'object' && route !== null && typeof route.fullPath === 'string'
@@ -51,3 +57,16 @@ export function sourceUrl(route) {
       : useRouter().resolve(route).fullPath
   return `${origin}/#${fullPath}`
 }
+
+/**
+ * The address of `path` (a router path, e.g. `/item/<id>`) on the sibling
+ * site `slug`: every site is deployed beside the others, one path segment
+ * under a common parent, so a sibling's origin is this site's with its last
+ * segment swapped. Null when the site declares no origin, or no slug is given.
+ */
+export function siblingSiteUrl(slug, path) {
+  const origin = siteOrigin()
+  if (!origin || !slug) return null
+  const parent = origin.slice(0, origin.lastIndexOf('/'))
+  return `${parent}/${slug}/#${path}`
+}