@nuxt/scripts 1.1.1 → 1.2.1

package/dist/runtime/registry/schemas.js

@@ -1,4 +1,4 @@
-import { any, array, boolean, custom, literal, minLength, number, object, optional, pipe, record, string, union } from "valibot";
+import { any, array, boolean, custom, function_, literal, maxValue, minLength, minValue, number, object, optional, pipe, record, string, union } from "valibot";
 const consentCategoryValue = union([literal("granted"), literal("denied")]);
 export const gcmConsentState = object({
   ad_storage: optional(consentCategoryValue),
@@ -947,6 +947,79 @@ export const InitObjectPropertiesSchema = object({
    */
   age: optional(string())
 });
+export const SpeedCurveOptions = object({
+  // -- Composable-only options (consumed by useScriptSpeedCurve, not forwarded to LUX) --
+  /**
+   * Your SpeedCurve customer ID.
+   * @see https://support.speedcurve.com/docs/add-rum-to-your-site
+   */
+  id: pipe(string(), minLength(1)),
+  /**
+   * Enable SPA (single-page application) mode.
+   * When true, lux.js tracks soft navigations instead of full page loads.
+   * @see https://support.speedcurve.com/docs/single-page-applications
+   */
+  spaMode: optional(boolean()),
+  /**
+   * Automatically wire Vue Router hooks for SPA tracking when spaMode is true.
+   * Set to false to instrument navigations manually.
+   * @default true (when spaMode is true)
+   */
+  autoTrackSpaNavigations: optional(boolean()),
+  // -- LUX UserConfig passthrough (forwarded onto window.LUX before lux.js loads) --
+  // Property names match upstream LUX UserConfig casing exactly. Keep this list in
+  // sync with the LUX_USER_CONFIG_KEYS filter in speedcurve.ts.
+  /**
+   * Page label shown in the SpeedCurve dashboard.
+   * Accepts a static string, a function `(to) => string | false` for per-navigation labels,
+   * or `false` to disable labeling entirely. A callback returning `false` skips updating
+   * the label for that navigation.
+   * @default String(to.name ?? to.path)
+   */
+  label: optional(union([string(), function_(), literal(false)])),
+  /**
+   * Sampling rate (0–100). Percentage of sessions that send beacons.
+   * Upstream spelling is lowercase — matches LUX UserConfig.
+   */
+  samplerate: optional(pipe(number(), minValue(0), maxValue(100))),
+  /**
+   * Send the beacon when the page is hidden (pagehide event).
+   * @default true
+   */
+  sendBeaconOnPageHidden: optional(boolean()),
+  /**
+   * Track JavaScript errors.
+   * @default true
+   */
+  trackErrors: optional(boolean()),
+  /**
+   * Maximum number of errors to track per page view.
+   * @default 5
+   */
+  maxErrors: optional(number()),
+  /**
+   * Minimum time (ms) before a beacon can be sent.
+   */
+  minMeasureTime: optional(number()),
+  /**
+   * Maximum time (ms) after which the beacon is sent regardless of load state.
+   * @default 60000
+   */
+  maxMeasureTime: optional(number()),
+  /**
+   * Start a new beacon when the page becomes visible after being hidden.
+   */
+  newBeaconOnPageShow: optional(boolean()),
+  /**
+   * Track pages loaded in background tabs.
+   * @default false
+   */
+  trackHiddenPages: optional(boolean()),
+  /**
+   * Cookie domain for cross-subdomain session tracking.
+   */
+  cookieDomain: optional(string())
+});
 export const SnapTrPixelOptions = object({
   /**
    * Your Snapchat Pixel ID.
@@ -966,7 +1039,14 @@ export const StripeOptions = object({
    * @default true
    * @see https://docs.stripe.com/disputes/prevention/advanced-fraud-detection
    */
-  advancedFraudSignals: optional(boolean())
+  advancedFraudSignals: optional(boolean()),
+  /**
+   * The Stripe.js SDK version to load.
+   * Named releases get autocomplete; any future codename is also accepted.
+   * @default 'basil'
+   * @see https://docs.stripe.com/sdks/stripejs-versioning
+   */
+  version: optional(union([literal("v3"), literal("acacia"), literal("basil"), literal("clover"), literal("dahlia"), string()]))
 });
 export const TikTokPixelOptions = object({
   /**

package/dist/runtime/registry/speedcurve.d.ts

@@ -0,0 +1,21 @@
+import type { LuxGlobal, UserConfig } from '@speedcurve/lux';
+import type { RouteLocationNormalized } from 'vue-router';
+import type { RegistryScriptInput, UseScriptContext } from '#nuxt-scripts/types';
+import { SpeedCurveOptions } from './schemas.js';
+export { SpeedCurveOptions };
+export interface SpeedCurveApi {
+    LUX: LuxGlobal;
+}
+declare global {
+    interface Window {
+        LUX?: LuxGlobal;
+        LUX_ae?: ErrorEvent[];
+        LUX_al?: PerformanceEntry[];
+    }
+}
+export type SpeedCurveInput = Omit<RegistryScriptInput<typeof SpeedCurveOptions>, 'label'> & Omit<UserConfig, 'label'> & {
+    label?: string | ((to: RouteLocationNormalized) => string | false) | false;
+};
+export declare function useScriptSpeedCurve<T extends SpeedCurveApi>(_options?: SpeedCurveInput): UseScriptContext<T>;
+export declare function applyConfig(options: SpeedCurveInput): void;
+export declare function installAutoTracker(options?: SpeedCurveInput): void;

package/dist/runtime/registry/speedcurve.js

@@ -0,0 +1,95 @@
+import { useHead, useNuxtApp, useRouter } from "nuxt/app";
+import { speedcurveLuxSnippet } from "#build/nuxt-scripts-snippets";
+import { useRegistryScript } from "../utils.js";
+import { afterNextPaint } from "../utils/after-next-paint.js";
+import { SpeedCurveOptions } from "./schemas.js";
+export { SpeedCurveOptions };
+const LUX_USER_CONFIG_KEYS = Object.keys(SpeedCurveOptions.entries).filter(
+  (k) => k !== "id" && k !== "autoTrackSpaNavigations" && k !== "spaMode"
+);
+let luxWired = false;
+export function useScriptSpeedCurve(_options) {
+  return useRegistryScript("speedcurve", (options) => ({
+    scriptInput: {
+      src: `https://cdn.speedcurve.com/js/lux.js?id=${options.id}`,
+      crossorigin: "anonymous"
+    },
+    schema: import.meta.dev ? SpeedCurveOptions : void 0,
+    scriptOptions: {
+      trigger: "client",
+      use: () => ({ LUX: window.LUX }),
+      beforeInit: () => {
+        if (!speedcurveLuxSnippet)
+          return;
+        useHead({
+          script: [{
+            key: "speedcurve-lux-primer",
+            tagPosition: "head",
+            tagPriority: "critical",
+            innerHTML: speedcurveLuxSnippet
+          }]
+        });
+      }
+    },
+    clientInit: import.meta.server ? void 0 : () => {
+      const input = options;
+      applyConfig(input);
+      if (options.spaMode && options.autoTrackSpaNavigations !== false)
+        installAutoTracker(input);
+    }
+  }), _options);
+}
+export function applyConfig(options) {
+  const lux = window.LUX;
+  if (!lux)
+    return;
+  for (const k of LUX_USER_CONFIG_KEYS) {
+    const v = options[k];
+    if (v === void 0)
+      continue;
+    if (k === "label" && typeof v !== "string")
+      continue;
+    lux[k] = v;
+  }
+}
+export function installAutoTracker(options) {
+  if (luxWired)
+    return;
+  luxWired = true;
+  const router = useRouter();
+  const nuxt = useNuxtApp();
+  let pendingInitial = nuxt.payload?.serverRendered === false;
+  const label = options?.label === false ? null : typeof options?.label === "function" ? options.label : (to) => String(to.name ?? to.path);
+  router.beforeEach((to) => {
+    const lux = window.LUX;
+    if (!lux)
+      return;
+    if (pendingInitial) {
+      pendingInitial = false;
+      if (label) {
+        const nextLabel = label(to);
+        if (nextLabel !== false)
+          lux.label = nextLabel;
+      }
+      return;
+    }
+    lux.startSoftNavigation();
+    if (label) {
+      const nextLabel = label(to);
+      if (nextLabel !== false)
+        lux.label = nextLabel;
+    }
+  });
+  router.afterEach((_to, _from, failure) => {
+    if (!failure)
+      return;
+    const lux = window.LUX;
+    if (!lux)
+      return;
+    lux.markLoadTime();
+    lux.addData("luxNavFailed", "1");
+  });
+  nuxt.hook("page:finish", () => {
+    afterNextPaint(() => window.LUX?.markLoadTime());
+  });
+}

package/dist/runtime/registry/stripe.js

@@ -6,7 +6,7 @@ export function useScriptStripe(_options) {
   return useRegistryScript("stripe", (options) => ({
     scriptInput: {
       src: withQuery(
-        `https://js.stripe.com/basil/stripe.js`,
+        `https://js.stripe.com/${options?.version || "basil"}/stripe.js`,
         typeof options?.advancedFraudSignals === "boolean" && !options?.advancedFraudSignals ? { advancedFraudSignals: false } : {}
       ),
       // opt-out of privacy defaults

package/dist/runtime/server/instagram-embed.js

@@ -1,16 +1,41 @@
 import { createError, defineEventHandler, getQuery, setHeader } from "h3";
-import { useRuntimeConfig } from "nitropack/runtime";
+import { defineCachedFunction, useRuntimeConfig } from "nitropack/runtime";
+import { $fetch } from "ofetch";
 import { ELEMENT_NODE, parse, renderSync, TEXT_NODE, walkSync } from "ultrahtml";
 import { createCachedJsonFetch } from "./utils/cached-upstream.js";
-import { proxyAssetUrl, rewriteUrl, rewriteUrlsInText, RSRC_RE, scopeCss } from "./utils/instagram-embed.js";
+import { isEmbedShell, proxyAssetUrl, rewriteUrl, rewriteUrlsInText, RSRC_RE, scopeCss } from "./utils/instagram-embed.js";
 import { withSigning } from "./utils/withSigning.js";
 export { proxyAssetUrl, proxyImageUrl, rewriteUrl, rewriteUrlsInText, scopeCss } from "./utils/instagram-embed.js";
 const EMBED_INSTAGRAM_SUFFIX_RE = /\/embed\/instagram$/;
 const SRCSET_SPLIT_RE = /\s+/;
-const cachedEmbedFetch = createCachedJsonFetch(
-  "nuxt-scripts-instagram-embed",
-  600,
-  (url) => url
+const cachedEmbedFetch = defineCachedFunction(
+  async (url, headers) => {
+    const html = await $fetch(url, { timeout: 1e4, headers });
+    if (isEmbedShell(html)) {
+      throw createError({
+        statusCode: 502,
+        statusMessage: "Instagram returned an empty embed shell (post unavailable or upstream rate-limiting)"
+      });
+    }
+    return html;
+  },
+  {
+    // v2 — bump to evict any v1 entries that cached the empty JS shell
+    // before the shell-detection / UA fix landed.
+    name: "nuxt-scripts-instagram-embed-v2",
+    maxAge: 600,
+    swr: true,
+    staleMaxAge: 600,
+    // Vary on headers too — Instagram's response is UA-dependent, so
+    // different callers (e.g. unit tests, future UA changes) must not
+    // collide on the same key.
+    getKey: (url, headers) => {
+      const parts = [url];
+      for (const [k, v] of Object.entries(headers).sort(([a], [b]) => a.localeCompare(b)))
+        parts.push(`${k}=${v}`);
+      return parts.join("|");
+    }
+  }
 );
 const cachedCssFetch = createCachedJsonFetch(
   "nuxt-scripts-instagram-css",
@@ -56,10 +81,12 @@ export default withSigning(defineEventHandler(async (event) => {
   const cleanUrl = parsedUrl.origin + pathname;
   const embedUrl = `${cleanUrl}embed/${captions ? "captioned/" : ""}`;
   const html = await cachedEmbedFetch(embedUrl, {
-    headers: {
-      "Accept": "text/html",
-      "User-Agent": "Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)"
-    }
+    "Accept": "text/html",
+    // Meta's own crawler UA. Googlebot's UA is also accepted by Instagram
+    // but is IP-verified, so it fails from hosts outside Google's ranges
+    // (e.g. Cloudflare/Vercel) and Instagram serves the JS shell instead
+    // of the SSR'd post.
+    "User-Agent": "facebookexternalhit/1.1 (+http://www.facebook.com/externalhit_uatext.php)"
   }).catch((error) => {
     throw createError({
       statusCode: error.statusCode || 500,

package/dist/runtime/server/proxy-handler.d.ts

@@ -1,3 +1,4 @@
+export declare const SKIP_REQUEST_HEADERS: Set<string>;
 /**
  * Privacy-aware proxy handler for first-party script collection endpoints.
  * Routes requests to third-party analytics while protecting user privacy.

package/dist/runtime/server/proxy-handler.js

@@ -13,6 +13,16 @@ import {
 const COMPRESSION_RE = /gzip|deflate|br|compress|base64/i;
 const CLIENT_HINT_VERSION_RE = /;v="(\d+)\.[^"]*"/g;
 const SKIP_RESPONSE_HEADERS = /* @__PURE__ */ new Set(["set-cookie", "transfer-encoding", "content-encoding", "content-length"]);
+export const SKIP_REQUEST_HEADERS = /* @__PURE__ */ new Set([
+  "connection",
+  "keep-alive",
+  "proxy-authenticate",
+  "proxy-authorization",
+  "te",
+  "trailer",
+  "transfer-encoding",
+  "upgrade"
+]);
 function stripQueryFingerprinting(query, privacy) {
   const stripped = stripPayloadFingerprinting(query, privacy);
   const params = new URLSearchParams();
@@ -88,12 +98,18 @@ export default defineEventHandler(async (event) => {
     }
   }
   const headers = {};
+  const connectionHeaderValue = originalHeaders.connection;
+  const connectionNamedHeaders = connectionHeaderValue ? new Set(connectionHeaderValue.split(",").map((h) => h.trim().toLowerCase()).filter(Boolean)) : null;
   for (const [key, value] of Object.entries(originalHeaders)) {
     if (!value)
       continue;
     const lowerKey = key.toLowerCase();
     if (lowerKey === "host")
       continue;
+    if (SKIP_REQUEST_HEADERS.has(lowerKey))
+      continue;
+    if (connectionNamedHeaders?.has(lowerKey))
+      continue;
     if (SENSITIVE_HEADERS.includes(lowerKey))
       continue;
     if (lowerKey === "content-length") {

package/dist/runtime/server/utils/instagram-embed.d.ts

@@ -1,4 +1,5 @@
 export declare const RSRC_RE: RegExp;
+export declare function isEmbedShell(html: string): boolean;
 export declare const AMP_RE: RegExp;
 export declare const SCONTENT_RE: RegExp;
 export declare const STATIC_CDN_RE: RegExp;

package/dist/runtime/server/utils/instagram-embed.js

@@ -1,5 +1,10 @@
 import { buildProxyUrl } from "./proxy-url.js";
 export const RSRC_RE = /url\(\/rsrc\.php([^)]+)\)/g;
+const SHELL_BODY_RE = /id=["'](?:splash-screen|has-finished-comet-page)["']/;
+const HAS_POST_CONTENT_RE = /\bclass=(["'])[^"']*\b(?:Embed|EmbeddedMedia|EmbeddedMediaImage)\b[^"']*\1/i;
+export function isEmbedShell(html) {
+  return SHELL_BODY_RE.test(html) && !HAS_POST_CONTENT_RE.test(html);
+}
 export const AMP_RE = /&/g;
 export const SCONTENT_RE = /https:\/\/scontent[^"'\s),]+\.cdninstagram\.com[^"'\s),]+/g;
 export const STATIC_CDN_RE = /https:\/\/static\.cdninstagram\.com[^"'\s),]+/g;

package/dist/runtime/types.d.ts

@@ -35,6 +35,7 @@ import type { RedditPixelInput } from './registry/reddit-pixel.js';
 import type { RybbitAnalyticsInput } from './registry/rybbit-analytics.js';
 import type { SegmentInput } from './registry/segment.js';
 import type { SnapTrPixelInput } from './registry/snapchat-pixel.js';
+import type { SpeedCurveInput } from './registry/speedcurve.js';
 import type { StripeInput } from './registry/stripe.js';
 import type { TikTokPixelInput } from './registry/tiktok-pixel.js';
 import type { UmamiAnalyticsInput } from './registry/umami-analytics.js';
@@ -263,6 +264,7 @@ export interface ScriptRegistry {
     rybbitAnalytics?: RybbitAnalyticsInput;
     redditPixel?: RedditPixelInput;
     segment?: SegmentInput;
+    speedcurve?: SpeedCurveInput;
     stripe?: StripeInput;
     tiktokPixel?: TikTokPixelInput;
     xEmbed?: XEmbedInput;
@@ -281,7 +283,7 @@ export interface ScriptRegistry {
  * Built-in registry script keys — not affected by module augmentation.
  * Use this to type-check records that must enumerate all built-in scripts (logos, meta, etc.).
  */
-export type BuiltInRegistryScriptKey = 'ahrefsAnalytics' | 'bingUet' | 'blueskyEmbed' | 'calendly' | 'carbonAds' | 'crisp' | 'clarity' | 'cloudflareWebAnalytics' | 'databuddyAnalytics' | 'metaPixel' | 'fathomAnalytics' | 'instagramEmbed' | 'plausibleAnalytics' | 'googleAdsense' | 'googleAnalytics' | 'googleMaps' | 'googleRecaptcha' | 'googleSignIn' | 'lemonSqueezy' | 'googleTagManager' | 'hotjar' | 'intercom' | 'linkedinInsight' | 'paypal' | 'posthog' | 'matomoAnalytics' | 'mixpanelAnalytics' | 'rybbitAnalytics' | 'redditPixel' | 'segment' | 'stripe' | 'tiktokPixel' | 'xEmbed' | 'xPixel' | 'snapchatPixel' | 'youtubePlayer' | 'vercelAnalytics' | 'vimeoPlayer' | 'umamiAnalytics' | 'usercentrics' | 'gravatar' | 'npm';
+export type BuiltInRegistryScriptKey = 'ahrefsAnalytics' | 'bingUet' | 'blueskyEmbed' | 'calendly' | 'carbonAds' | 'crisp' | 'clarity' | 'cloudflareWebAnalytics' | 'databuddyAnalytics' | 'metaPixel' | 'fathomAnalytics' | 'instagramEmbed' | 'plausibleAnalytics' | 'googleAdsense' | 'googleAnalytics' | 'googleMaps' | 'googleRecaptcha' | 'googleSignIn' | 'lemonSqueezy' | 'googleTagManager' | 'hotjar' | 'intercom' | 'linkedinInsight' | 'paypal' | 'posthog' | 'matomoAnalytics' | 'mixpanelAnalytics' | 'rybbitAnalytics' | 'redditPixel' | 'segment' | 'stripe' | 'tiktokPixel' | 'xEmbed' | 'xPixel' | 'snapchatPixel' | 'speedcurve' | 'youtubePlayer' | 'vercelAnalytics' | 'vimeoPlayer' | 'umamiAnalytics' | 'usercentrics' | 'gravatar' | 'npm';
 /**
  * Union of all explicit registry script keys (excludes npm pattern).
  * Includes both built-in and augmented keys.

package/dist/runtime/utils/after-next-paint.d.ts

@@ -0,0 +1 @@
+export declare function afterNextPaint(callback: () => void): void;

package/dist/runtime/utils/after-next-paint.js

@@ -0,0 +1,3 @@
+export function afterNextPaint(callback) {
+  requestAnimationFrame(() => requestAnimationFrame(callback));
+}

package/dist/stats.d.mts

@@ -1,4 +1,4 @@
-type TrackedDataType = 'page-views' | 'events' | 'conversions' | 'user-identity' | 'session-replay' | 'heatmaps' | 'clicks' | 'scrolls' | 'retargeting' | 'audiences' | 'form-submissions' | 'video-engagement' | 'transactions' | 'errors' | 'tag-injection' | 'ab-testing';
+type TrackedDataType = 'page-views' | 'events' | 'conversions' | 'user-identity' | 'session-replay' | 'heatmaps' | 'clicks' | 'scrolls' | 'retargeting' | 'audiences' | 'form-submissions' | 'video-engagement' | 'transactions' | 'errors' | 'tag-injection' | 'ab-testing' | 'performance-timings';
 
 interface ScriptPrivacy {
     ip: boolean;

package/dist/stats.d.ts

@@ -1,4 +1,4 @@
-type TrackedDataType = 'page-views' | 'events' | 'conversions' | 'user-identity' | 'session-replay' | 'heatmaps' | 'clicks' | 'scrolls' | 'retargeting' | 'audiences' | 'form-submissions' | 'video-engagement' | 'transactions' | 'errors' | 'tag-injection' | 'ab-testing';
+type TrackedDataType = 'page-views' | 'events' | 'conversions' | 'user-identity' | 'session-replay' | 'heatmaps' | 'clicks' | 'scrolls' | 'retargeting' | 'audiences' | 'form-submissions' | 'video-engagement' | 'transactions' | 'errors' | 'tag-injection' | 'ab-testing' | 'performance-timings';
 
 interface ScriptPrivacy {
     ip: boolean;

package/dist/stats.mjs

@@ -198,6 +198,11 @@ const scriptMeta = {
   gravatar: {
     urls: ["https://secure.gravatar.com/js/gprofiles.js"],
     trackedData: []
+  },
+  // Performance monitoring
+  speedcurve: {
+    urls: ["https://cdn.speedcurve.com/js/lux.js"],
+    trackedData: ["page-views", "performance-timings", "errors"]
   }
 };
 

package/dist/types-source.mjs

@@ -382,7 +382,7 @@ const types = {
 		{
 			name: "ScriptGoogleMapsHeatmapLayerProps",
 			kind: "interface",
-			code: "interface ScriptGoogleMapsHeatmapLayerProps {\n  /**\n   * Configuration options for the heatmap layer visualization.\n   * @see https://developers.google.com/maps/documentation/javascript/reference/visualization#HeatmapLayerOptions\n   */\n  options?: Omit<google.maps.visualization.HeatmapLayerOptions, 'map'>\n}"
+			code: "interface ScriptGoogleMapsHeatmapLayerProps {\n  /**\n   * Configuration options for the heatmap layer visualization.\n   * @deprecated Google deprecated the Maps JavaScript API `HeatmapLayer` (May 2025) and removed it in v3.65 (May 2026). Consider [deck.gl HeatmapLayer](https://deck.gl/docs/api-reference/aggregation-layers/heatmap-layer) instead.\n   * @see https://developers.google.com/maps/documentation/javascript/reference/visualization#HeatmapLayerOptions\n   */\n  options?: Omit<HeatmapLayerOptions, 'map'>\n}"
 		},
 		{
 			name: "ScriptGoogleMapsInfoWindowProps",
@@ -965,11 +965,23 @@ const types = {
 			code: "export interface SnapPixelApi {\n  snaptr: SnapTrFns & {\n    push: SnapTrFns\n    loaded: boolean\n    version: string\n    queue: any[]\n  }\n  _snaptr: SnapPixelApi['snaptr']\n  handleRequest?: SnapTrFns\n}"
 		}
 	],
+	speedcurve: [
+		{
+			name: "SpeedCurveOptions",
+			kind: "const",
+			code: "export const SpeedCurveOptions = object({\n  // -- Composable-only options (consumed by useScriptSpeedCurve, not forwarded to LUX) --\n  /**\n   * Your SpeedCurve customer ID.\n   * @see https://support.speedcurve.com/docs/add-rum-to-your-site\n   */\n  id: pipe(string(), minLength(1)),\n  /**\n   * Enable SPA (single-page application) mode.\n   * When true, lux.js tracks soft navigations instead of full page loads.\n   * @see https://support.speedcurve.com/docs/single-page-applications\n   */\n  spaMode: optional(boolean()),\n  /**\n   * Automatically wire Vue Router hooks for SPA tracking when spaMode is true.\n   * Set to false to instrument navigations manually.\n   * @default true (when spaMode is true)\n   */\n  autoTrackSpaNavigations: optional(boolean()),\n\n  // -- LUX UserConfig passthrough (forwarded onto window.LUX before lux.js loads) --\n  // Property names match upstream LUX UserConfig casing exactly. Keep this list in\n  // sync with the LUX_USER_CONFIG_KEYS filter in speedcurve.ts.\n  /**\n   * Page label shown in the SpeedCurve dashboard.\n   * Accepts a static string, a function `(to) => string | false` for per-navigation labels,\n   * or `false` to disable labeling entirely. A callback returning `false` skips updating\n   * the label for that navigation.\n   * @default String(to.name ?? to.path)\n   */\n  label: optional(union([string(), function_(), literal(false)])),\n  /**\n   * Sampling rate (0–100). Percentage of sessions that send beacons.\n   * Upstream spelling is lowercase — matches LUX UserConfig.\n   */\n  samplerate: optional(pipe(number(), minValue(0), maxValue(100))),\n  /**\n   * Send the beacon when the page is hidden (pagehide event).\n   * @default true\n   */\n  sendBeaconOnPageHidden: optional(boolean()),\n  /**\n   * Track JavaScript errors.\n   * @default true\n   */\n  trackErrors: optional(boolean()),\n  /**\n   * Maximum number of errors to track per page view.\n   * @default 5\n   */\n  maxErrors: optional(number()),\n  /**\n   * Minimum time (ms) before a beacon can be sent.\n   */\n  minMeasureTime: optional(number()),\n  /**\n   * Maximum time (ms) after which the beacon is sent regardless of load state.\n   * @default 60000\n   */\n  maxMeasureTime: optional(number()),\n  /**\n   * Start a new beacon when the page becomes visible after being hidden.\n   */\n  newBeaconOnPageShow: optional(boolean()),\n  /**\n   * Track pages loaded in background tabs.\n   * @default false\n   */\n  trackHiddenPages: optional(boolean()),\n  /**\n   * Cookie domain for cross-subdomain session tracking.\n   */\n  cookieDomain: optional(string()),\n})"
+		},
+		{
+			name: "SpeedCurveApi",
+			kind: "interface",
+			code: "export interface SpeedCurveApi {\n  LUX: LuxGlobal\n}"
+		}
+	],
 	stripe: [
 		{
 			name: "StripeOptions",
 			kind: "const",
-			code: "export const StripeOptions = object({\n  /**\n   * Whether to load Stripe's advanced fraud detection signals.\n   * Set to `false` to opt out.\n   * @default true\n   * @see https://docs.stripe.com/disputes/prevention/advanced-fraud-detection\n   */\n  advancedFraudSignals: optional(boolean()),\n})"
+			code: "export const StripeOptions = object({\n  /**\n   * Whether to load Stripe's advanced fraud detection signals.\n   * Set to `false` to opt out.\n   * @default true\n   * @see https://docs.stripe.com/disputes/prevention/advanced-fraud-detection\n   */\n  advancedFraudSignals: optional(boolean()),\n  /**\n   * The Stripe.js SDK version to load.\n   * Named releases get autocomplete; any future codename is also accepted.\n   * @default 'basil'\n   * @see https://docs.stripe.com/sdks/stripejs-versioning\n   */\n  version: optional(union([literal('v3'), literal('acacia'), literal('basil'), literal('clover'), literal('dahlia'), string()])),\n})"
 		},
 		{
 			name: "StripeApi",
@@ -2374,6 +2386,93 @@ const schemaFields = {
 			description: "The user's age."
 		}
 	],
+	SpeedCurveOptions: [
+		{
+			name: "id",
+			type: "string",
+			required: true,
+			description: "Your SpeedCurve customer ID."
+		},
+		{
+			name: "spaMode",
+			type: "boolean",
+			required: false,
+			description: "Enable SPA (single-page application) mode. When true, lux.js tracks soft navigations instead of full page loads."
+		},
+		{
+			name: "autoTrackSpaNavigations",
+			type: "boolean",
+			required: false,
+			description: "Automatically wire Vue Router hooks for SPA tracking when spaMode is true. Set to false to instrument navigations manually.",
+			defaultValue: "true (when spaMode is true)"
+		},
+		{
+			name: "label",
+			type: "string | Function | false",
+			required: false,
+			description: "Page label shown in the SpeedCurve dashboard. Accepts a static string, a function `(to) => string | false` for per-navigation labels, or `false` to disable labeling entirely. A callback returning `false` skips updating the label for that navigation.",
+			defaultValue: "String(to.name ?? to.path)"
+		},
+		{
+			name: "samplerate",
+			type: "number",
+			required: false,
+			description: "Sampling rate (0–100). Percentage of sessions that send beacons. Upstream spelling is lowercase — matches LUX UserConfig."
+		},
+		{
+			name: "sendBeaconOnPageHidden",
+			type: "boolean",
+			required: false,
+			description: "Send the beacon when the page is hidden (pagehide event).",
+			defaultValue: "true"
+		},
+		{
+			name: "trackErrors",
+			type: "boolean",
+			required: false,
+			description: "Track JavaScript errors.",
+			defaultValue: "true"
+		},
+		{
+			name: "maxErrors",
+			type: "number",
+			required: false,
+			description: "Maximum number of errors to track per page view.",
+			defaultValue: "5"
+		},
+		{
+			name: "minMeasureTime",
+			type: "number",
+			required: false,
+			description: "Minimum time (ms) before a beacon can be sent."
+		},
+		{
+			name: "maxMeasureTime",
+			type: "number",
+			required: false,
+			description: "Maximum time (ms) after which the beacon is sent regardless of load state.",
+			defaultValue: "60000"
+		},
+		{
+			name: "newBeaconOnPageShow",
+			type: "boolean",
+			required: false,
+			description: "Start a new beacon when the page becomes visible after being hidden."
+		},
+		{
+			name: "trackHiddenPages",
+			type: "boolean",
+			required: false,
+			description: "Track pages loaded in background tabs.",
+			defaultValue: "false"
+		},
+		{
+			name: "cookieDomain",
+			type: "string",
+			required: false,
+			description: "Cookie domain for cross-subdomain session tracking."
+		}
+	],
 	SnapTrPixelOptions: [
 		{
 			name: "id",
@@ -2395,6 +2494,13 @@ const schemaFields = {
 			required: false,
 			description: "Whether to load Stripe's advanced fraud detection signals. Set to `false` to opt out.",
 			defaultValue: "true"
+		},
+		{
+			name: "version",
+			type: "'v3' | 'acacia' | 'basil' | 'clover' | 'dahlia' | string",
+			required: false,
+			description: "The Stripe.js SDK version to load. Named releases get autocomplete; any future codename is also accepted.",
+			defaultValue: "'basil'"
 		}
 	],
 	TikTokPixelOptions: [
@@ -2747,7 +2853,7 @@ const schemaFields = {
 	ScriptGoogleMapsHeatmapLayerProps: [
 		{
 			name: "options",
-			type: "Omit<google.maps.visualization.HeatmapLayerOptions, 'map'>",
+			type: "Omit<HeatmapLayerOptions, 'map'>",
 			required: false,
 			description: "Configuration options for the heatmap layer visualization."
 		}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nuxt/scripts",
   "type": "module",
-  "version": "1.1.1",
+  "version": "1.2.1",
   "description": "Load third-party scripts with better performance, privacy and DX in Nuxt Apps.",
   "author": {
     "name": "Harlan Wilton",
@@ -71,11 +71,12 @@
   "peerDependencies": {
     "@googlemaps/markerclusterer": "^2.6.2",
     "@paypal/paypal-js": "^8.1.2 || ^9.0.0",
+    "@speedcurve/lux": "^4.4.3",
     "@stripe/stripe-js": "^7.0.0 || ^8.0.0 || ^9.0.0",
     "@types/google.maps": "^3.58.1",
     "@types/vimeo__player": "^2.18.3",
     "@types/youtube": "^0.1.0",
-    "@unhead/vue": "^2.0.3",
+    "@unhead/vue": "^2.0.3 || ^3.0.0",
     "posthog-js": "^1.0.0"
   },
   "peerDependenciesMeta": {
@@ -85,6 +86,9 @@
     "@paypal/paypal-js": {
       "optional": true
     },
+    "@speedcurve/lux": {
+      "optional": true
+    },
     "@stripe/stripe-js": {
       "optional": true
     },
@@ -111,7 +115,7 @@
     "magic-string": "^0.30.21",
     "ofetch": "^1.5.1",
     "ohash": "^2.0.11",
-    "oxc-parser": "^0.132.0",
+    "oxc-parser": "^0.134.0",
     "oxc-walker": "^1.0.0",
     "pathe": "^2.0.3",
     "pkg-types": "^2.3.1",
@@ -121,11 +125,12 @@
     "ultrahtml": "^1.6.0",
     "unplugin": "^3.0.0",
     "unstorage": "^1.17.5",
-    "valibot": "^1.4.0"
+    "valibot": "^1.4.1"
   },
   "devDependencies": {
     "@nuxt/kit": "^4.4.6",
     "@nuxt/module-builder": "^1.0.2",
+    "@speedcurve/lux": "^4.4.3",
     "rollup": "^4.60.4",
     "unbuild": "^3.6.1",
     "unimport": "^6.3.0"