@xenterprises/nuxt-x-marketing 1.4.13 → 1.4.15

package/CHANGELOG.md

@@ -30,6 +30,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   section and its sample product data were dropped with them. Every other section of the
   demo page is unchanged.
 
+## [1.4.15] - 2026-10-12
+
+### Fixed
+
+- Scroll reveal never initialized from the global `marketing.client.ts` plugin. `useScrollReveal()` returned a no-op stub outside a component instance, so `.xFadeUp` / `.xFadeIn` / `[data-reveal]` content (including hero text) stayed at opacity 0. The composable now returns working `initScrollReveal` / `cleanup` outside components (lifecycle hooks are still only registered inside one), and the plugin runs it on `page:finish`, re-scanning on every client navigation. Consumers who added an `app.vue` workaround can remove it.
+
+## [1.4.14] - 2026-09-06
+
+### Added
+
+- `XMarkPricingPlans` `freeTrial` prop for an honest free-trial callout (default off; enable only when the product has a trial).
+
 ## [1.4.13] - 2026-09-06
 
 ### Changed

package/app/components/X/Mark/Pricing/Plans.vue

@@ -33,6 +33,26 @@
 			</div>
 		</div>
 
+		<!-- Free trial callout (opt-in; never invent a trial) -->
+		<div
+			v-if="trialCallout"
+			class="flex justify-center mb-8"
+			data-testid="x-mark-pricing-free-trial"
+		>
+			<div
+				class="inline-flex items-center gap-2 rounded-full border border-primary-200 bg-primary-50 px-4 py-2 text-sm text-primary-800 dark:border-primary-800 dark:bg-primary-950 dark:text-primary-200"
+			>
+				<UIcon name="i-lucide-gift" class="size-4 shrink-0" />
+				<span class="font-medium">{{ trialCallout.label }}</span>
+				<span
+					v-if="trialCallout.description"
+					class="text-primary-700/80 dark:text-primary-300/80"
+				>
+					{{ trialCallout.description }}
+				</span>
+			</div>
+		</div>
+
 		<!-- Badges (top position) -->
 		<div
 			v-if="badges?.length && badgesPosition === 'top'"
@@ -165,12 +185,54 @@ const props = defineProps({
 		default: "center",
 		validator: (v) => ["left", "center", "right"].includes(v),
 	},
+	/**
+	 * Free trial callout. Default off (honest; do not invent trials).
+	 * true → "Free trial available"
+	 * number → "Free {n}-day trial"
+	 * string → custom label
+	 * { days?, label?, description? }
+	 */
+	freeTrial: {
+		type: [Boolean, Number, String, Object],
+		default: false,
+	},
 });
 
 const emit = defineEmits(["select"]);
 
 const billingPeriod = ref("monthly");
 
+const trialCallout = computed(() => {
+	const v = props.freeTrial;
+	if (v === false || v === null || v === undefined || v === "") return null;
+	if (v === true) {
+		return { label: "Free trial available", description: "" };
+	}
+	if (typeof v === "number" && Number.isFinite(v) && v > 0) {
+		const days = Math.floor(v);
+		return {
+			label: `Free ${days}-day trial`,
+			description: "",
+		};
+	}
+	if (typeof v === "string") {
+		return { label: v, description: "" };
+	}
+	if (typeof v === "object") {
+		const days = Number(v.days);
+		const label =
+			v.label
+				|| (Number.isFinite(days) && days > 0
+					? `Free ${Math.floor(days)}-day trial`
+					: "Free trial available");
+		return {
+			label,
+			description: v.description || "",
+		};
+	}
+	return null;
+});
+
 function normalizePeriod(period) {
 	if (!period) return period;
 	const trimmed = String(period).trim().toLowerCase();

package/app/composables/useScrollReveal.js

@@ -9,9 +9,9 @@
  * - .xFadeUp-stagger for staggered child animations
  */
 export const useScrollReveal = (options = {}) => {
-  // Only register lifecycle hooks when inside a component instance
+  // Lifecycle hooks are only registered inside a component instance.
+  // Outside one (e.g. a plugin) the caller drives initScrollReveal/cleanup itself.
   const instance = getCurrentInstance();
-  if (!instance) return { initScrollReveal: () => {}, cleanup: () => {} };
 
   const defaultOptions = {
     threshold: 0.15,
@@ -33,7 +33,8 @@ export const useScrollReveal = (options = {}) => {
   ].join(', ');
 
   const initScrollReveal = () => {
-    if (import.meta.client) {
+    if (import.meta.client && typeof IntersectionObserver !== 'undefined') {
+      if (observer.value) observer.value.disconnect();
       observer.value = new IntersectionObserver((entries) => {
         entries.forEach((entry) => {
           if (entry.isIntersecting) {
@@ -62,7 +63,7 @@ export const useScrollReveal = (options = {}) => {
     }
   };
 
-  if (import.meta.client) {
+  if (import.meta.client && instance) {
     onMounted(() => {
       // Small delay to ensure DOM is ready
       setTimeout(initScrollReveal, 100);

package/app/plugins/marketing.client.ts

@@ -4,9 +4,15 @@
  *
  * From spec-prompt.md specification
  */
-export default defineNuxtPlugin(() => {
-  // Initialize scroll reveal globally
-  useScrollReveal();
+export default defineNuxtPlugin((nuxtApp) => {
+  // Initialize scroll reveal globally. A plugin has no component instance,
+  // so drive the observer from page lifecycle hooks: initial hydration and
+  // every client-side navigation re-scan the DOM for reveal elements.
+  const { initScrollReveal, cleanup } = useScrollReveal();
+  nuxtApp.hook('page:finish', () => {
+    cleanup();
+    nextTick(() => setTimeout(initScrollReveal, 100));
+  });
 
   // Initialize parallax globally
   useParallax();

package/package.json

@@ -2,7 +2,7 @@
   "name": "@xenterprises/nuxt-x-marketing",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
-  "version": "1.4.13",
+  "version": "1.4.15",
   "main": "./nuxt.config.ts",
   "scripts": {
     "dev": "nuxi dev .playground",