@thebes/cadmus 0.4.1 → 0.4.2

package/dist/cms/index.cjs

@@ -1271,6 +1271,45 @@ function decodeEditRef(value) {
 function editAttr(ref) {
 	return { [EDIT_ATTR]: encodeEditRef(ref) };
 }
+/** `postMessage` type carrying in-progress field values into the preview. */
+const PREVIEW_VALUES_MESSAGE = "cadmus:preview-values";
+/**
+* Patch tagged regions' text from in-progress field values. For each string
+* value, updates every `[data-cadmus-edit="collection:id:field"]` element's
+* `textContent`. Pure (takes the root to search), so it's unit-testable
+* without a live preview window.
+*/
+function applyPreviewValues(root, target, values) {
+	for (const [field, value] of Object.entries(values)) {
+		if (typeof value !== "string") continue;
+		const attr = encodeEditRef({
+			collection: target.collection,
+			id: target.id,
+			field
+		});
+		for (const el of root.querySelectorAll(`[${EDIT_ATTR}="${attr}"]`)) el.textContent = value;
+	}
+}
+/**
+* Mount the live-preview receiver on a preview page (browser-only). Listens
+* for {@link PreviewValuesMessage} from the studio window and patches tagged
+* text regions via {@link applyPreviewValues}. Returns a cleanup function.
+*/
+function mountPreviewSync(options) {
+	const root = options.root ?? document;
+	const handler = (event) => {
+		if (options.allowedOrigin && event.origin !== options.allowedOrigin) return;
+		const data = event.data;
+		if (data?.type !== "cadmus:preview-values") return;
+		if (data.collection !== options.collection || data.id !== options.id) return;
+		if (data.values) applyPreviewValues(root, {
+			collection: options.collection,
+			id: options.id
+		}, data.values);
+	};
+	window.addEventListener("message", handler);
+	return () => window.removeEventListener("message", handler);
+}
 /**
 * Mount the click-to-edit overlay. Browser-only — call from a preview page's
 * client script. Highlights `[data-cadmus-edit]` elements on hover and, on
@@ -1407,9 +1446,11 @@ async function deliverWebhookMessage(message) {
 //#endregion
 exports.DEFAULT_STUDIO_GROUP = DEFAULT_STUDIO_GROUP;
 exports.EDIT_ATTR = EDIT_ATTR;
+exports.PREVIEW_VALUES_MESSAGE = PREVIEW_VALUES_MESSAGE;
 exports.Rule = Rule;
 exports.VISUAL_EDIT_MESSAGE = VISUAL_EDIT_MESSAGE;
 exports.applyPatch = applyPatch;
+exports.applyPreviewValues = applyPreviewValues;
 exports.assertValid = assertValid;
 exports.buildStudioStructure = buildStudioStructure;
 exports.can = can;
@@ -1438,6 +1479,7 @@ exports.flattenFields = flattenFields;
 exports.generateSchemaSource = generateSchemaSource;
 exports.getCollectionsMeta = getCollectionsMeta;
 exports.getRegisteredApi = getRegisteredApi;
+exports.mountPreviewSync = mountPreviewSync;
 exports.mountVisualEditing = mountVisualEditing;
 exports.nestDoc = nestDoc;
 exports.relationshipJoinTables = relationshipJoinTables;