diff --git a/library/components/poster/PosterWall.vue b/library/components/poster/PosterWall.vue
index 7a2068462..3c0e77771 100644
--- a/library/components/poster/PosterWall.vue
+++ b/library/components/poster/PosterWall.vue
@@ -41,6 +41,8 @@
*/
import { computed, ref } from 'vue'
import { useShadowStyles } from '@map/composables/useShadowStyles.js'
+import { usePosterPrints } from '@map/composables/usePosterPrints.js'
+import { useI18n } from 'vue-i18n'
// Export-modal geometry. A fixed;inset:0 scrim covers only the CONTENT PANE in the cap-5 shell
// (contain:layout on .vtl-content). Measured 1024x793 @ (256,107) at 1280x900 — rail clickable
// behind the "modal". See library/utils/viewportScrim.js for the measurements and rejected fixes.
@@ -77,6 +79,17 @@ const props = defineProps({
// prayer list for each country generated.")
prayerListSoonMessage: { type: String,
default: 'Coming soon — the prayer list for each people group is in build.' },
+ // ★ RECORDS PROVIDER — the seam that makes the print actions shareable.
+ // The PRINT ACTIONS are common to every wall; the RECORD FETCHING is not. The
+ // 100-list resolves its rows through the people-groups API, the selector
+ // evaluator and a pg_slugs special case; Key Cities and Country Posters have
+ // entirely different data shapes. So a bundle that CAN supply rows passes this
+ // and gets the list + card-deck prints; one that cannot simply omits it and
+ // those buttons stay hidden, rather than failing at click time.
+ records: { type: Function, default: null },
+ // Card stock for the deck print, when this wall offers one. See card-render.js
+ // STOCK — both orientations are available.
+ cardStock: { type: String, default: 'poker' },
// EMBEDDED mode (added 2026-09-24 for the regions-tab poster dropdown). The wall's root is
// `position:absolute;inset:0` because in country-posters and my-upg-100-list it IS a pane and
// fills it. Dropped inside another component — a region card, say — that absolute root covers
@@ -208,11 +221,43 @@ async function exportPoster(item) {
}
}
+// ── SHARED PRINT ACTIONS ──────────────────────────────────────────────────
+// The list and card-deck prints live in the shared composable so every wall gets
+// the same documents. They need ROWS, which only the bundle can fetch — hence the
+// `records` prop. Without it the buttons are hidden and this stays honest rather
+// than offering an action that cannot work.
+// The wall follows the app's locale: the card deck and its QR codes are localised,
+// and packet-strings.json falls back per key.
+const { locale: wallLocale } = useI18n()
+// ⚠ ONE exportState, not two. The composable owns a ref of its own; if the HUD
+// keeps rendering the wall's while the print actions write to the composable's, a
+// card-deck print shows NO progress and its errors vanish silently — the mechanism
+// works and the feedback does not. Hand the composable this wall's ref so both
+// write to the surface the reader is actually looking at.
+const prints = usePosterPrints({
+ state: exportState,
+ records: props.records ? (item) => props.records(item) : null,
+ // useI18n()'s locale can be a ref or a plain string depending on how the host
+ // installed it, so normalise rather than assume.
+ lang: () => {
+ const l = wallLocale && (wallLocale.value ?? wallLocale)
+ return (typeof l === 'string' && l) || 'en'
+ },
+ stock: () => props.cardStock,
+ label: (item) => item?.label || item?.id || '',
+})
+const canPrintRows = computed(() => typeof props.records === 'function')
+
function downloadPacket(item) {
- // NOT an error — unbuilt, not broken. phase:'error' reads to a user as
- // "something went wrong" rather than "not yet".
- exportState.value = { label: item.label, kind: 'Prayer List', phase: 'soon',
- message: props.prayerListSoonMessage, pct: 0 }
+ // Still the honest "not yet" when this wall has no records provider: NOT an
+ // error — unbuilt, not broken. phase:'error' reads to a user as "something went
+ // wrong" rather than "not yet".
+ if (!canPrintRows.value) {
+ exportState.value = { label: item.label, kind: 'Prayer List', phase: 'soon',
+ message: props.prayerListSoonMessage, pct: 0 }
+ return
+ }
+ prints.printList(item)
}
function download(blob, name) {
@@ -422,6 +467,11 @@ useShadowStyles(
diff --git a/library/composables/usePosterPrints.js b/library/composables/usePosterPrints.js
new file mode 100644
index 000000000..34741dfc8
--- /dev/null
+++ b/library/composables/usePosterPrints.js
@@ -0,0 +1,168 @@
+// usePosterPrints.js — THE print actions every poster wall shares.
+//
+// ★ WHY THIS EXISTS. The poster wall was generalised into
+// library/components/poster/PosterWall.vue and two bundles were migrated onto it —
+// but the ORIGINAL, my-upg-100-list/poster-wall.vue (903 lines), was left behind.
+// So the one wall carrying the real print actions is the one wall nothing else can
+// benefit from, and the shared component's packet path is still a "coming soon"
+// stub. Every print fix made in the 100-list is invisible to the three bundles on
+// the shared component, and vice versa. That divergence is the bug.
+//
+// ── THE SEAM ────────────────────────────────────────────────────────────────
+// The PRINT ACTIONS are shareable; the RECORD FETCHING is not. fetchListRecords in
+// the 100-list knows the people-groups API, the selector evaluator and the pg_slugs
+// special case; Key Cities and Country Posters have entirely different data shapes.
+// So this composable takes a `records(item)` PROVIDER and owns everything after it:
+// the HUD state machine, the in-place print frame, and the three documents.
+//
+// That is also what keeps the bundles honest — a wall that cannot supply records
+// simply does not pass a provider, and the actions that need them stay hidden
+// rather than failing at click time.
+//
+// ⚠ PRINTS IN PLACE, never window.open(). A popup is blockable and drops the reader
+// out of the map; the shared openPrintFrame mounts a hidden same-page iframe. This
+// is the mechanism the Driver asked for by name: "not supposed to open up a new
+// browser, but should open up the print dialog directly in the browser".
+
+import { ref } from 'vue';
+import { openPrintFrame } from './printInPlace.js';
+
+const esc = (s) => String(s ?? '')
+ .replace(/&/g, '&').replace(//g, '>')
+ .replace(/"/g, '"').replace(/'/g, ''');
+
+/**
+ * @param {object} opts
+ * records async (item) => rows[] — REQUIRED for the list and deck prints.
+ * strings () => Promise