flowgrid-sdk 1.7.1 → 1.7.3

package/dist/index.d.ts

@@ -46,7 +46,7 @@ export { getCookie, getVisitorId, getSessionId, getWebId, getUTM, getUTMHistory,
 export type { FlowGridUTM, FlowGridUTMHistoryEntry, } from "./lib/utils/storage";
 export { IdentityManager } from "./lib/utils/identity";
 export type { IdentityConfig, ServerCookieReader, } from "./lib/utils/identity";
-export { ConsentManager } from "./lib/consent";
-export type { ConsentConfig, ConsentPreferences, ConsentCategory as ConsentCategoryType, ConsentChangeEvent, CookieBannerConfig, CookieBannerTheme, } from "./lib/consent";
-export { getOrCreateAnonId, getOrCreateCartId, resetCartId, setupConsent, attachConsentBanner, } from "./lib/helpers";
-export type { ConsentBannerOptions, ConsentBannerHandle, } from "./lib/helpers";
+export { ConsentManager, wireDeclarativeBanners } from "./lib/consent";
+export type { ConsentConfig, ConsentPreferences, ConsentCategory as ConsentCategoryType, ConsentChangeEvent, CookieBannerConfig, CookieBannerTheme, WireDeclarativeBannersOptions, DeclarativeBannersHandle, } from "./lib/consent";
+export { getOrCreateAnonId, getOrCreateCartId, resetCartId, setupConsent, attachConsentBanner, renderConsentBanner, } from "./lib/helpers";
+export type { ConsentBannerOptions, ConsentBannerHandle, RenderConsentBannerOptions, } from "./lib/helpers";

package/dist/index.js

@@ -31,8 +31,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resetCartId = exports.getOrCreateCartId = exports.getOrCreateAnonId = exports.ConsentManager = exports.IdentityManager = exports.getUTMHistory = exports.getUTM = exports.getWebId = exports.getSessionId = exports.getVisitorId = exports.getCookie = exports.Forecasting = exports.SecurityAnalytics = exports.AlertsAnalytics = exports.PathAnalytics = exports.AcquisitionAnalytics = exports.SupportAnalytics = exports.MultiPathFunnels = exports.Monetization = exports.ChurnAnalytics = exports.Cohorts = exports.Engagement = exports.FlowGridTransport = exports.Subscriptions = exports.SearchAnalytics = exports.CustomerLTV = exports.WishlistTracking = exports.Promotions = exports.Refunds = exports.Purchases = exports.Checkout = exports.CartTracking = exports.Products = exports.SessionReplay = exports.Performance = exports.PerformanceTracking = exports.Heatmaps = exports.Attribution = exports.Retention = exports.Funnels = exports.Identify = exports.Events = exports.Sessions = exports.PageViews = exports.Experiment = exports.TrackPrompt = exports.TrackFeature = exports.Activation = exports.default = exports.FlowGrid = void 0;
-exports.attachConsentBanner = exports.setupConsent = void 0;
+exports.getOrCreateCartId = exports.getOrCreateAnonId = exports.wireDeclarativeBanners = exports.ConsentManager = exports.IdentityManager = exports.getUTMHistory = exports.getUTM = exports.getWebId = exports.getSessionId = exports.getVisitorId = exports.getCookie = exports.Forecasting = exports.SecurityAnalytics = exports.AlertsAnalytics = exports.PathAnalytics = exports.AcquisitionAnalytics = exports.SupportAnalytics = exports.MultiPathFunnels = exports.Monetization = exports.ChurnAnalytics = exports.Cohorts = exports.Engagement = exports.FlowGridTransport = exports.Subscriptions = exports.SearchAnalytics = exports.CustomerLTV = exports.WishlistTracking = exports.Promotions = exports.Refunds = exports.Purchases = exports.Checkout = exports.CartTracking = exports.Products = exports.SessionReplay = exports.Performance = exports.PerformanceTracking = exports.Heatmaps = exports.Attribution = exports.Retention = exports.Funnels = exports.Identify = exports.Events = exports.Sessions = exports.PageViews = exports.Experiment = exports.TrackPrompt = exports.TrackFeature = exports.Activation = exports.default = exports.FlowGrid = void 0;
+exports.renderConsentBanner = exports.attachConsentBanner = exports.setupConsent = exports.resetCartId = void 0;
 // ============================================================================
 // UNIFIED SDK CLASS
 // ============================================================================
@@ -116,6 +116,7 @@ Object.defineProperty(exports, "IdentityManager", { enumerable: true, get: funct
 // ============================================================================
 var consent_1 = require("./lib/consent");
 Object.defineProperty(exports, "ConsentManager", { enumerable: true, get: function () { return consent_1.ConsentManager; } });
+Object.defineProperty(exports, "wireDeclarativeBanners", { enumerable: true, get: function () { return consent_1.wireDeclarativeBanners; } });
 // ============================================================================
 // DROP-IN HELPERS
 //
@@ -128,4 +129,5 @@ Object.defineProperty(exports, "getOrCreateCartId", { enumerable: true, get: fun
 Object.defineProperty(exports, "resetCartId", { enumerable: true, get: function () { return helpers_1.resetCartId; } });
 Object.defineProperty(exports, "setupConsent", { enumerable: true, get: function () { return helpers_1.setupConsent; } });
 Object.defineProperty(exports, "attachConsentBanner", { enumerable: true, get: function () { return helpers_1.attachConsentBanner; } });
+Object.defineProperty(exports, "renderConsentBanner", { enumerable: true, get: function () { return helpers_1.renderConsentBanner; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;;;;;AAEH,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,2CAA0C;AAAjC,oGAAA,QAAQ,OAAA;AACjB,2CAAyC;AAAhC,oHAAA,OAAO,OAAA;AAGhB,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,4CAK6B;AAJ3B,kGAAA,UAAU,OAAA;AACV,oGAAA,YAAY,OAAA;AACZ,mGAAA,WAAW,OAAA;AACX,kGAAA,UAAU,OAAA;AA8BZ,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAE/E,sDAYkC;AAXhC,sGAAA,SAAS,OAAA;AACT,qGAAA,QAAQ,OAAA;AACR,mGAAA,MAAM,OAAA;AACN,qGAAA,QAAQ,OAAA;AACR,oGAAA,OAAO,OAAA;AACP,sGAAA,SAAS,OAAA;AACT,wGAAA,WAAW,OAAA;AACX,qGAAA,QAAQ,OAAA;AACR,gHAAA,mBAAmB,OAAA;AACnB,wGAAA,mBAAmB,OAAe;AAClC,0GAAA,aAAa,OAAA;AAiEf,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,sDAWkC;AAVhC,qGAAA,QAAQ,OAAA;AACR,yGAAA,YAAY,OAAA;AACZ,qGAAA,QAAQ,OAAA;AACR,sGAAA,SAAS,OAAA;AACT,oGAAA,OAAO,OAAA;AACP,uGAAA,UAAU,OAAA;AACV,6GAAA,gBAAgB,OAAA;AAChB,wGAAA,WAAW,OAAA;AACX,4GAAA,eAAe,OAAA;AACf,0GAAA,aAAa,OAAA;AAqDf,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E,sDAAsD;AACtD,oDAA2D;AAAlD,8GAAA,iBAAiB,OAAA;AAG1B,wDAYmC;AAXjC,wGAAA,UAAU,OAAA;AACV,qGAAA,OAAO,OAAA;AACP,4GAAA,cAAc,OAAA;AACd,0GAAA,YAAY,OAAA;AACZ,8GAAA,gBAAgB,OAAA;AAChB,8GAAA,gBAAgB,OAAA;AAChB,kHAAA,oBAAoB,OAAA;AACpB,2GAAA,aAAa,OAAA;AACb,6GAAA,eAAe,OAAA;AACf,+GAAA,iBAAiB,OAAA;AACjB,yGAAA,WAAW,OAAA;AAwNb,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,kFAAkF;AAClF,+CAO6B;AAN3B,oGAAA,SAAS,OAAA;AACT,uGAAA,YAAY,OAAA;AACZ,uGAAA,YAAY,OAAA;AACZ,mGAAA,QAAQ,OAAA;AACR,iGAAA,MAAM,OAAA;AACN,wGAAA,aAAa,OAAA;AAQf,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,iDAAuD;AAA9C,2GAAA,eAAe,OAAA;AAOxB,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,yCAA+C;AAAtC,yGAAA,cAAc,OAAA;AAWvB,+EAA+E;AAC/E,kBAAkB;AAClB,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,+EAA+E;AAE/E,yCAMuB;AALrB,4GAAA,iBAAiB,OAAA;AACjB,4GAAA,iBAAiB,OAAA;AACjB,sGAAA,WAAW,OAAA;AACX,uGAAA,YAAY,OAAA;AACZ,8GAAA,mBAAmB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;;;;;AAEH,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,2CAA0C;AAAjC,oGAAA,QAAQ,OAAA;AACjB,2CAAyC;AAAhC,oHAAA,OAAO,OAAA;AAGhB,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,4CAK6B;AAJ3B,kGAAA,UAAU,OAAA;AACV,oGAAA,YAAY,OAAA;AACZ,mGAAA,WAAW,OAAA;AACX,kGAAA,UAAU,OAAA;AA8BZ,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAE/E,sDAYkC;AAXhC,sGAAA,SAAS,OAAA;AACT,qGAAA,QAAQ,OAAA;AACR,mGAAA,MAAM,OAAA;AACN,qGAAA,QAAQ,OAAA;AACR,oGAAA,OAAO,OAAA;AACP,sGAAA,SAAS,OAAA;AACT,wGAAA,WAAW,OAAA;AACX,qGAAA,QAAQ,OAAA;AACR,gHAAA,mBAAmB,OAAA;AACnB,wGAAA,mBAAmB,OAAe;AAClC,0GAAA,aAAa,OAAA;AAiEf,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,sDAWkC;AAVhC,qGAAA,QAAQ,OAAA;AACR,yGAAA,YAAY,OAAA;AACZ,qGAAA,QAAQ,OAAA;AACR,sGAAA,SAAS,OAAA;AACT,oGAAA,OAAO,OAAA;AACP,uGAAA,UAAU,OAAA;AACV,6GAAA,gBAAgB,OAAA;AAChB,wGAAA,WAAW,OAAA;AACX,4GAAA,eAAe,OAAA;AACf,0GAAA,aAAa,OAAA;AAqDf,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E,sDAAsD;AACtD,oDAA2D;AAAlD,8GAAA,iBAAiB,OAAA;AAG1B,wDAYmC;AAXjC,wGAAA,UAAU,OAAA;AACV,qGAAA,OAAO,OAAA;AACP,4GAAA,cAAc,OAAA;AACd,0GAAA,YAAY,OAAA;AACZ,8GAAA,gBAAgB,OAAA;AAChB,8GAAA,gBAAgB,OAAA;AAChB,kHAAA,oBAAoB,OAAA;AACpB,2GAAA,aAAa,OAAA;AACb,6GAAA,eAAe,OAAA;AACf,+GAAA,iBAAiB,OAAA;AACjB,yGAAA,WAAW,OAAA;AAwNb,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,kFAAkF;AAClF,+CAO6B;AAN3B,oGAAA,SAAS,OAAA;AACT,uGAAA,YAAY,OAAA;AACZ,uGAAA,YAAY,OAAA;AACZ,mGAAA,QAAQ,OAAA;AACR,iGAAA,MAAM,OAAA;AACN,wGAAA,aAAa,OAAA;AAQf,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,iDAAuD;AAA9C,2GAAA,eAAe,OAAA;AAOxB,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,yCAAuE;AAA9D,yGAAA,cAAc,OAAA;AAAE,iHAAA,sBAAsB,OAAA;AAa/C,+EAA+E;AAC/E,kBAAkB;AAClB,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,+EAA+E;AAE/E,yCAOuB;AANrB,4GAAA,iBAAiB,OAAA;AACjB,4GAAA,iBAAiB,OAAA;AACjB,sGAAA,WAAW,OAAA;AACX,uGAAA,YAAY,OAAA;AACZ,8GAAA,mBAAmB,OAAA;AACnB,8GAAA,mBAAmB,OAAA"}

package/dist/lib/consent/declarativeBanner.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @fileoverview Declarative, attribute-driven cookie-consent banner (no-code).
+ * @module consent/declarativeBanner
+ *
+ * @description
+ * The no-code front door to the FlowGrid consent stack. A customer drops a
+ * single element on the page:
+ *
+ * ```html
+ * <div data-cookie-ccbanner></div>
+ * ```
+ *
+ * …and this layer initialises a fully styled, GDPR/CCPA-friendly consent banner.
+ * It defaults to opt-out (nothing is blocked — FlowGrid collects data unless the
+ * visitor declines); set `data-cc-mode="opt-in"` to block analytics, marketing and
+ * session-replay tracking until the visitor accepts — with zero JavaScript. It
+ * contains **no consent logic of its
+ * own**: it reads config off the page and delegates to the shipped engine
+ * ({@link renderConsentBanner} for the default styled banner, or
+ * {@link attachConsentBanner} when the customer supplied their own inner markup),
+ * mirroring how `declarativeExperiments.ts` wires `data-fg-*` experiments.
+ *
+ * @attributes
+ *   data-cookie-ccbanner            Marker. Presence = initialise a banner here.
+ *   data-cc-mode                    "opt-out" (default) | "opt-in".
+ *   data-cc-title / -description    Copy overrides.
+ *   data-cc-accept-label / ...      Button label overrides.
+ *   data-cc-privacy-url             Adds a "Learn more" privacy link.
+ *   data-cc-position / -primary /   Theme: position, colours, radius, font, z.
+ *     -bg / -text / -radius / -font / -z
+ *   data-cc-categories              Comma list of visible toggles (analytics,marketing).
+ *   data-cc-cookie-name / -days /   Cookie persistence overrides.
+ *     -domain
+ *   data-cc-respect-dnt="false"     Ignore DNT/GPC (defaults to honouring it).
+ *   data-cc-theme                   Named preset bundle: flowgrid | light | dark.
+ *   data-cc-unstyled                Drop default CSS (Tier 2 BYO-CSS).
+ *   data-cc-manage-selector         CSS selector whose clicks re-open the banner.
+ *   data-cc-manual                  Skip auto-init for this element.
+ *
+ * Robust to dynamically-injected DOM: a MutationObserver re-scans on changes, so
+ * page builders and SPA route changes keep working with zero extra calls. Init
+ * is idempotent per element via a `data-cc-wired` marker.
+ */
+import type { RenderConsentBannerOptions } from "../helpers/consent";
+/** Options for {@link wireDeclarativeBanners}. */
+export interface WireDeclarativeBannersOptions {
+    /**
+     * Global defaults, normally read from `window.FlowGridConfig.consentBanner`.
+     * Per-element `data-cc-*` attributes override these.
+     */
+    globalConfig?: RenderConsentBannerOptions;
+}
+/** Handle returned by {@link wireDeclarativeBanners}. */
+export interface DeclarativeBannersHandle {
+    /** Re-scan the DOM for new `[data-cookie-ccbanner]` markers. Idempotent. */
+    rescan: () => void;
+    /** Stop the MutationObserver and tear down every wired banner. */
+    disconnect: () => void;
+}
+/**
+ * Scan the document for `[data-cookie-ccbanner]` markers and initialise a
+ * consent banner for each: the default styled banner via {@link renderConsentBanner}
+ * when the element is empty, or the customer's own markup via
+ * {@link attachConsentBanner} when it has children. Watches for late-mounted
+ * markers via a MutationObserver. Each element is marked `data-cc-wired` so
+ * re-scans never double-init.
+ *
+ * SSR-safe: a no-op (returns inert handle) when there's no `document`.
+ *
+ * @param options - Optional global defaults to layer beneath `data-cc-*`.
+ * @returns A {@link DeclarativeBannersHandle} for manual rescans / teardown.
+ */
+export declare function wireDeclarativeBanners(options?: WireDeclarativeBannersOptions): DeclarativeBannersHandle;

package/dist/lib/consent/declarativeBanner.js

@@ -0,0 +1,260 @@
+"use strict";
+/**
+ * @fileoverview Declarative, attribute-driven cookie-consent banner (no-code).
+ * @module consent/declarativeBanner
+ *
+ * @description
+ * The no-code front door to the FlowGrid consent stack. A customer drops a
+ * single element on the page:
+ *
+ * ```html
+ * <div data-cookie-ccbanner></div>
+ * ```
+ *
+ * …and this layer initialises a fully styled, GDPR/CCPA-friendly consent banner.
+ * It defaults to opt-out (nothing is blocked — FlowGrid collects data unless the
+ * visitor declines); set `data-cc-mode="opt-in"` to block analytics, marketing and
+ * session-replay tracking until the visitor accepts — with zero JavaScript. It
+ * contains **no consent logic of its
+ * own**: it reads config off the page and delegates to the shipped engine
+ * ({@link renderConsentBanner} for the default styled banner, or
+ * {@link attachConsentBanner} when the customer supplied their own inner markup),
+ * mirroring how `declarativeExperiments.ts` wires `data-fg-*` experiments.
+ *
+ * @attributes
+ *   data-cookie-ccbanner            Marker. Presence = initialise a banner here.
+ *   data-cc-mode                    "opt-out" (default) | "opt-in".
+ *   data-cc-title / -description    Copy overrides.
+ *   data-cc-accept-label / ...      Button label overrides.
+ *   data-cc-privacy-url             Adds a "Learn more" privacy link.
+ *   data-cc-position / -primary /   Theme: position, colours, radius, font, z.
+ *     -bg / -text / -radius / -font / -z
+ *   data-cc-categories              Comma list of visible toggles (analytics,marketing).
+ *   data-cc-cookie-name / -days /   Cookie persistence overrides.
+ *     -domain
+ *   data-cc-respect-dnt="false"     Ignore DNT/GPC (defaults to honouring it).
+ *   data-cc-theme                   Named preset bundle: flowgrid | light | dark.
+ *   data-cc-unstyled                Drop default CSS (Tier 2 BYO-CSS).
+ *   data-cc-manage-selector         CSS selector whose clicks re-open the banner.
+ *   data-cc-manual                  Skip auto-init for this element.
+ *
+ * Robust to dynamically-injected DOM: a MutationObserver re-scans on changes, so
+ * page builders and SPA route changes keep working with zero extra calls. Init
+ * is idempotent per element via a `data-cc-wired` marker.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wireDeclarativeBanners = wireDeclarativeBanners;
+const consent_1 = require("../helpers/consent");
+const MARKER_ATTR = "data-cookie-ccbanner";
+const WIRED_ATTR = "data-cc-wired";
+const MANUAL_ATTR = "data-cc-manual";
+/**
+ * Named theme presets reachable from `data-cc-theme` / `theme: "<name>"`.
+ * Explicit `data-cc-*` colour attributes still override the preset.
+ */
+const THEME_PRESETS = {
+    flowgrid: { primaryColor: "#4F46E5", backgroundColor: "#FFFFFF", textColor: "#1F2937" },
+    light: { primaryColor: "#4F46E5", backgroundColor: "#FFFFFF", textColor: "#1F2937" },
+    dark: { primaryColor: "#818CF8", backgroundColor: "#111827", textColor: "#F9FAFB" },
+};
+/** Parse a numeric attribute, returning `undefined` when absent or invalid. */
+function num(raw) {
+    if (raw == null || raw.trim() === "")
+        return undefined;
+    const n = Number(raw);
+    return Number.isFinite(n) ? n : undefined;
+}
+/**
+ * Read `data-cc-*` attributes off an element into a partial banner config.
+ * Only present attributes are emitted, so this object can be layered over
+ * `window.FlowGridConfig.consentBanner` without clobbering it with defaults.
+ */
+function parseElementConfig(el) {
+    const attr = (name) => el.getAttribute(name);
+    const cfg = {};
+    const theme = {};
+    // Named preset first so explicit colour attributes below override it.
+    const preset = attr("data-cc-theme");
+    if (preset && THEME_PRESETS[preset])
+        Object.assign(theme, THEME_PRESETS[preset]);
+    const mode = attr("data-cc-mode");
+    if (mode === "opt-in" || mode === "opt-out")
+        cfg.mode = mode;
+    const title = attr("data-cc-title");
+    if (title != null)
+        cfg.title = title;
+    const description = attr("data-cc-description");
+    if (description != null)
+        cfg.description = description;
+    const acceptLabel = attr("data-cc-accept-label");
+    if (acceptLabel != null)
+        cfg.acceptAllLabel = acceptLabel;
+    const rejectLabel = attr("data-cc-reject-label");
+    if (rejectLabel != null)
+        cfg.rejectAllLabel = rejectLabel;
+    const customizeLabel = attr("data-cc-customize-label");
+    if (customizeLabel != null)
+        cfg.customizeLabel = customizeLabel;
+    const saveLabel = attr("data-cc-save-label");
+    if (saveLabel != null)
+        cfg.saveLabel = saveLabel;
+    const privacyUrl = attr("data-cc-privacy-url");
+    if (privacyUrl != null)
+        cfg.privacyPolicyUrl = privacyUrl;
+    // Theme appearance
+    const position = attr("data-cc-position");
+    if (position)
+        theme.position = position;
+    const primary = attr("data-cc-primary");
+    if (primary != null)
+        theme.primaryColor = primary;
+    const bg = attr("data-cc-bg");
+    if (bg != null)
+        theme.backgroundColor = bg;
+    const text = attr("data-cc-text");
+    if (text != null)
+        theme.textColor = text;
+    const radius = attr("data-cc-radius");
+    if (radius != null)
+        theme.borderRadius = radius;
+    const font = attr("data-cc-font");
+    if (font != null)
+        theme.fontFamily = font;
+    const z = num(attr("data-cc-z"));
+    if (z !== undefined)
+        theme.zIndex = z;
+    if (Object.keys(theme).length > 0)
+        cfg.theme = theme;
+    // Categories (comma list of visible non-essential toggles).
+    const categories = attr("data-cc-categories");
+    if (categories != null) {
+        cfg.categories = categories
+            .split(",")
+            .map((s) => s.trim())
+            .filter((s) => s.length > 0);
+    }
+    // Cookie persistence (ConsentConfig fields).
+    const cookieName = attr("data-cc-cookie-name");
+    if (cookieName != null)
+        cfg.cookieName = cookieName;
+    const cookieDays = num(attr("data-cc-cookie-days"));
+    if (cookieDays !== undefined)
+        cfg.cookieDays = cookieDays;
+    const cookieDomain = attr("data-cc-cookie-domain");
+    if (cookieDomain != null)
+        cfg.cookieDomain = cookieDomain;
+    const respectDNT = attr("data-cc-respect-dnt");
+    if (respectDNT != null)
+        cfg.respectDNT = respectDNT !== "false";
+    if (el.hasAttribute("data-cc-unstyled"))
+        cfg.unstyled = true;
+    const manageSelector = attr("data-cc-manage-selector");
+    if (manageSelector != null)
+        cfg.manageSelector = manageSelector;
+    return cfg;
+}
+/**
+ * Merge global config (`window.FlowGridConfig.consentBanner`) with the
+ * per-element `data-cc-*` config. Precedence (low → high, per the plan):
+ *   1. global object
+ *   2. element attributes
+ * `theme` is merged field-by-field so an element can tweak one colour without
+ * dropping the rest of the global theme.
+ */
+function mergeConfig(global, element) {
+    if (!global)
+        return element;
+    return {
+        ...global,
+        ...element,
+        theme: global.theme || element.theme ? { ...global.theme, ...element.theme } : undefined,
+    };
+}
+/** Whether an element already contains author markup (Tier 3 BYO-markup). */
+function hasChildMarkup(el) {
+    return el.children.length > 0;
+}
+/**
+ * Scan the document for `[data-cookie-ccbanner]` markers and initialise a
+ * consent banner for each: the default styled banner via {@link renderConsentBanner}
+ * when the element is empty, or the customer's own markup via
+ * {@link attachConsentBanner} when it has children. Watches for late-mounted
+ * markers via a MutationObserver. Each element is marked `data-cc-wired` so
+ * re-scans never double-init.
+ *
+ * SSR-safe: a no-op (returns inert handle) when there's no `document`.
+ *
+ * @param options - Optional global defaults to layer beneath `data-cc-*`.
+ * @returns A {@link DeclarativeBannersHandle} for manual rescans / teardown.
+ */
+function wireDeclarativeBanners(options) {
+    if (typeof document === "undefined") {
+        return { rescan: () => { }, disconnect: () => { } };
+    }
+    const globalConfig = options?.globalConfig;
+    const handles = [];
+    const wireElement = (el) => {
+        if (el.hasAttribute(WIRED_ATTR) || el.hasAttribute(MANUAL_ATTR))
+            return;
+        el.setAttribute(WIRED_ATTR, "");
+        const config = mergeConfig(globalConfig, parseElementConfig(el));
+        let handle = null;
+        try {
+            if (hasChildMarkup(el)) {
+                // Tier 3 — bind the customer's own buttons by data-role, never inject DOM.
+                handle = (0, consent_1.attachConsentBanner)({ ...config, container: el });
+            }
+            else {
+                // Tiers 1 & 2 — render the default styled banner (the marker is just an
+                // anchor; the banner is position:fixed so DOM placement doesn't matter).
+                handle = (0, consent_1.renderConsentBanner)(config);
+            }
+        }
+        catch {
+            /* never throw from auto-init — leave the page untouched on failure */
+        }
+        if (handle)
+            handles.push(handle);
+    };
+    const scan = (root = document) => {
+        const sel = `[${MARKER_ATTR}]:not([${WIRED_ATTR}])`;
+        // The root node itself may be a marker (e.g. a single injected element).
+        if (root instanceof Element && root.matches(sel))
+            wireElement(root);
+        root.querySelectorAll(sel).forEach(wireElement);
+    };
+    scan();
+    // Re-scan when the DOM changes (page builders, SPA navigation, lazy content).
+    const observer = typeof MutationObserver !== "undefined"
+        ? new MutationObserver((mutations) => {
+            for (const m of mutations) {
+                m.addedNodes.forEach((node) => {
+                    if (node.nodeType === 1)
+                        scan(node);
+                });
+            }
+        })
+        : null;
+    observer?.observe(document.documentElement, { childList: true, subtree: true });
+    return {
+        rescan: () => scan(),
+        disconnect: () => {
+            try {
+                observer?.disconnect();
+            }
+            catch {
+                /* ignore */
+            }
+            for (const h of handles) {
+                try {
+                    h.destroy();
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+            handles.length = 0;
+        },
+    };
+}
+//# sourceMappingURL=declarativeBanner.js.map

package/dist/lib/consent/declarativeBanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declarativeBanner.js","sourceRoot":"","sources":["../../../src/lib/consent/declarativeBanner.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;;AA6JH,wDAsEC;AAjOD,gDAA8E;AAI9E,MAAM,WAAW,GAAG,sBAAsB,CAAC;AAC3C,MAAM,UAAU,GAAG,eAAe,CAAC;AACnC,MAAM,WAAW,GAAG,gBAAgB,CAAC;AAErC;;;GAGG;AACH,MAAM,aAAa,GAA+C;IAChE,QAAQ,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE;IACvF,KAAK,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE;IACpF,IAAI,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE;CACpF,CAAC;AAEF,+EAA+E;AAC/E,SAAS,GAAG,CAAC,GAAkB;IAC7B,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACvD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,EAAW;IACrC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAiB,EAAE,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACpE,MAAM,GAAG,GAA+B,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAsB,EAAE,CAAC;IAEpC,sEAAsE;IACtE,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;IACrC,IAAI,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC;QAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;IAEjF,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;IAClC,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS;QAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;IAE7D,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;IACpC,IAAI,KAAK,IAAI,IAAI;QAAE,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;IACrC,MAAM,WAAW,GAAG,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAChD,IAAI,WAAW,IAAI,IAAI;QAAE,GAAG,CAAC,WAAW,GAAG,WAAW,CAAC;IACvD,MAAM,WAAW,GAAG,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACjD,IAAI,WAAW,IAAI,IAAI;QAAE,GAAG,CAAC,cAAc,GAAG,WAAW,CAAC;IAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACjD,IAAI,WAAW,IAAI,IAAI;QAAE,GAAG,CAAC,cAAc,GAAG,WAAW,CAAC;IAC1D,MAAM,cAAc,GAAG,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACvD,IAAI,cAAc,IAAI,IAAI;QAAE,GAAG,CAAC,cAAc,GAAG,cAAc,CAAC;IAChE,MAAM,SAAS,GAAG,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC7C,IAAI,SAAS,IAAI,IAAI;QAAE,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;IACjD,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC/C,IAAI,UAAU,IAAI,IAAI;QAAE,GAAG,CAAC,gBAAgB,GAAG,UAAU,CAAC;IAE1D,mBAAmB;IACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAyC,CAAC;IAClF,IAAI,QAAQ;QAAE,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACxC,IAAI,OAAO,IAAI,IAAI;QAAE,KAAK,CAAC,YAAY,GAAG,OAAO,CAAC;IAClD,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9B,IAAI,EAAE,IAAI,IAAI;QAAE,KAAK,CAAC,eAAe,GAAG,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;IAClC,IAAI,IAAI,IAAI,IAAI;QAAE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACtC,IAAI,MAAM,IAAI,IAAI;QAAE,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;IAClC,IAAI,IAAI,IAAI,IAAI;QAAE,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;IAC1C,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK,SAAS;QAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACtC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;IAErD,4DAA4D;IAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC9C,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;QACvB,GAAG,CAAC,UAAU,GAAG,UAAU;aACxB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,CAAC,CAAC,EAAgE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/F,CAAC;IAED,6CAA6C;IAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC/C,IAAI,UAAU,IAAI,IAAI;QAAE,GAAG,CAAC,UAAU,GAAG,UAAU,CAAC;IACpD,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC;IACpD,IAAI,UAAU,KAAK,SAAS;QAAE,GAAG,CAAC,UAAU,GAAG,UAAU,CAAC;IAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACnD,IAAI,YAAY,IAAI,IAAI;QAAE,GAAG,CAAC,YAAY,GAAG,YAAY,CAAC;IAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC/C,IAAI,UAAU,IAAI,IAAI;QAAE,GAAG,CAAC,UAAU,GAAG,UAAU,KAAK,OAAO,CAAC;IAEhE,IAAI,EAAE,CAAC,YAAY,CAAC,kBAAkB,CAAC;QAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC7D,MAAM,cAAc,GAAG,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACvD,IAAI,cAAc,IAAI,IAAI;QAAE,GAAG,CAAC,cAAc,GAAG,cAAc,CAAC;IAEhE,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,WAAW,CAClB,MAA8C,EAC9C,OAAmC;IAEnC,IAAI,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC;IAC5B,OAAO;QACL,GAAG,MAAM;QACT,GAAG,OAAO;QACV,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS;KACzF,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,SAAS,cAAc,CAAC,EAAW;IACjC,OAAO,EAAE,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;AAChC,CAAC;AAmBD;;;;;;;;;;;;GAYG;AACH,SAAgB,sBAAsB,CAAC,OAAuC;IAC5E,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;IACpD,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;IAC3C,MAAM,OAAO,GAA0B,EAAE,CAAC;IAE1C,MAAM,WAAW,GAAG,CAAC,EAAW,EAAE,EAAE;QAClC,IAAI,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,WAAW,CAAC;YAAE,OAAO;QACxE,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAEhC,MAAM,MAAM,GAAG,WAAW,CAAC,YAAY,EAAE,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC;QAEjE,IAAI,MAAM,GAA+B,IAAI,CAAC;QAC9C,IAAI,CAAC;YACH,IAAI,cAAc,CAAC,EAAE,CAAC,EAAE,CAAC;gBACvB,2EAA2E;gBAC3E,MAAM,GAAG,IAAA,6BAAmB,EAAC,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,EAAiB,EAAE,CAAC,CAAC;YAC5E,CAAC;iBAAM,CAAC;gBACN,wEAAwE;gBACxE,yEAAyE;gBACzE,MAAM,GAAG,IAAA,6BAAmB,EAAC,MAAM,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,sEAAsE;QACxE,CAAC;QACD,IAAI,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,CAAC,OAAmB,QAAQ,EAAE,EAAE;QAC3C,MAAM,GAAG,GAAG,IAAI,WAAW,UAAU,UAAU,IAAI,CAAC;QACpD,yEAAyE;QACzE,IAAI,IAAI,YAAY,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;YAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QACpE,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC,CAAC;IAEF,IAAI,EAAE,CAAC;IAEP,8EAA8E;IAC9E,MAAM,QAAQ,GACZ,OAAO,gBAAgB,KAAK,WAAW;QACrC,CAAC,CAAC,IAAI,gBAAgB,CAAC,CAAC,SAAS,EAAE,EAAE;YACjC,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;gBAC1B,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;oBAC5B,IAAI,IAAI,CAAC,QAAQ,KAAK,CAAC;wBAAE,IAAI,CAAC,IAAe,CAAC,CAAC;gBACjD,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC;QACJ,CAAC,CAAC,IAAI,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhF,OAAO;QACL,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE;QACpB,UAAU,EAAE,GAAG,EAAE;YACf,IAAI,CAAC;gBACH,QAAQ,EAAE,UAAU,EAAE,CAAC;YACzB,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,IAAI,CAAC;oBACH,CAAC,CAAC,OAAO,EAAE,CAAC;gBACd,CAAC;gBAAC,MAAM,CAAC;oBACP,YAAY;gBACd,CAAC;YACH,CAAC;YACD,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/consent/index.d.ts

@@ -29,4 +29,6 @@
  * @see {@link ConsentManager} for the core API.
  */
 export { ConsentManager } from './manager';
+export { wireDeclarativeBanners } from './declarativeBanner';
+export type { WireDeclarativeBannersOptions, DeclarativeBannersHandle, } from './declarativeBanner';
 export type { ConsentCategory, ConsentPreferences, ConsentConfig, ConsentChangeEvent, CookieBannerConfig, CookieBannerTheme, } from './types';

package/dist/lib/consent/index.js

@@ -30,7 +30,9 @@
  * @see {@link ConsentManager} for the core API.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConsentManager = void 0;
+exports.wireDeclarativeBanners = exports.ConsentManager = void 0;
 var manager_1 = require("./manager");
 Object.defineProperty(exports, "ConsentManager", { enumerable: true, get: function () { return manager_1.ConsentManager; } });
+var declarativeBanner_1 = require("./declarativeBanner");
+Object.defineProperty(exports, "wireDeclarativeBanners", { enumerable: true, get: function () { return declarativeBanner_1.wireDeclarativeBanners; } });
 //# sourceMappingURL=index.js.map

package/dist/lib/consent/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/consent/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;;;AAEH,qCAA2C;AAAlC,yGAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/consent/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;;;AAEH,qCAA2C;AAAlC,yGAAA,cAAc,OAAA;AAEvB,yDAA6D;AAApD,2HAAA,sBAAsB,OAAA"}

package/dist/lib/consent/manager.js

@@ -118,7 +118,12 @@ class ConsentManager {
             cookieDays: config?.cookieDays ?? DEFAULT_COOKIE_DAYS,
             cookieDomain: config?.cookieDomain,
             respectDNT: config?.respectDNT ?? true,
-            requireExplicitConsent: config?.requireExplicitConsent ?? true,
+            // Permissive by default: FlowGrid collects data unless the customer
+            // explicitly opts into a consent gate (`requireExplicitConsent: true` or
+            // the banner's `mode: 'opt-in'`). Implementing consent is the customer's
+            // responsibility — the SDK does not block essential or analytics data,
+            // including session replay, out of the box.
+            requireExplicitConsent: config?.requireExplicitConsent ?? false,
             onChange: config?.onChange,
             defaultPreferences: {
                 ...DEFAULT_PREFERENCES,

package/dist/lib/consent/manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../src/lib/consent/manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../src/lib/consent/manager.ts"],"names":[],"mappings":"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"}

package/dist/lib/consent/types.d.ts

@@ -69,7 +69,12 @@ export interface ConsentConfig {
     onChange?: (preferences: ConsentPreferences) => void;
     /** Respect `navigator.doNotTrack` / `globalPrivacyControl`. Defaults to `true`. */
     respectDNT?: boolean;
-    /** Auto-block analytics/marketing before consent is given. Defaults to `true`. */
+    /**
+     * Auto-block analytics/marketing (and session-replay chunks) until the visitor
+     * explicitly consents. Defaults to `false` — FlowGrid is permissive by default
+     * and it's up to the customer to opt into a consent gate. Set `true` for a
+     * GDPR-style opt-in flow.
+     */
     requireExplicitConsent?: boolean;
 }
 /**
@@ -122,6 +127,31 @@ export interface CookieBannerTheme {
  * framework-agnostic.
  */
 export interface CookieBannerConfig {
+    /**
+     * Consent mode. `'opt-out'` (default) lets analytics/marketing — including
+     * session-replay chunks — run until the visitor declines; FlowGrid collects
+     * data unless the customer chooses otherwise. `'opt-in'` (GDPR-safe) blocks
+     * non-essential tracking until the visitor accepts.
+     * Maps to {@link ConsentConfig.requireExplicitConsent}.
+     */
+    mode?: 'opt-in' | 'opt-out';
+    /**
+     * Which non-essential categories to show as toggles in the customize panel.
+     * `necessary` is always shown locked-on and never listed here.
+     * Defaults to `['analytics', 'marketing']`.
+     */
+    categories?: ConsentCategory[];
+    /**
+     * Drop FlowGrid's default inline styling and emit only the stable `.fg-cc-*`
+     * class hooks + CSS variables, so the banner can be fully styled from the
+     * page's own stylesheet (Tier 2 "bring your own CSS").
+     */
+    unstyled?: boolean;
+    /**
+     * CSS selector for a "Manage cookies" re-open control (e.g. a footer link).
+     * Clicks on matching elements re-open the banner via the handle's `show()`.
+     */
+    manageSelector?: string;
     /** Banner title. Defaults to `"Cookie Preferences"`. */
     title?: string;
     /** Banner description text. */

package/dist/lib/features/core/activation.d.ts

@@ -212,5 +212,15 @@ export declare class Activation extends FlowGridTransport {
      * @returns Promise resolving to activation response
      */
     trackSignup(userId: string, method: 'email' | 'google' | 'github' | 'apple' | 'sso' | string, source?: string, properties?: Record<string, unknown>): Promise<ActivationResponse>;
+    /**
+     * Tracks a user login (returning-user signal — recorded as an event, not a
+     * funnel conversion).
+     *
+     * @param userId - User ID
+     * @param method - Login method (email, google, etc.)
+     * @param properties - Additional properties
+     * @returns Promise resolving to activation response
+     */
+    trackLogin(userId: string, method?: 'email' | 'google' | 'github' | 'apple' | 'sso' | string, properties?: Record<string, unknown>): Promise<ActivationResponse>;
 }
 export default Activation;

package/dist/lib/features/core/activation.js

@@ -173,6 +173,25 @@ class Activation extends transport_1.FlowGridTransport {
             timestamp: new Date().toISOString()
         });
     }
+    /**
+     * Tracks a user login (returning-user signal — recorded as an event, not a
+     * funnel conversion).
+     *
+     * @param userId - User ID
+     * @param method - Login method (email, google, etc.)
+     * @param properties - Additional properties
+     * @returns Promise resolving to activation response
+     */
+    async trackLogin(userId, method, properties) {
+        return await this.init("login_completed", {
+            type: "activation",
+            subtype: "login",
+            userId,
+            method,
+            ...properties,
+            timestamp: new Date().toISOString()
+        });
+    }
 }
 exports.Activation = Activation;
 exports.default = Activation;

package/dist/lib/features/core/activation.js.map

@@ -1 +1 @@
-{"version":3,"file":"activation.js","sourceRoot":"","sources":["../../../../src/lib/features/core/activation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"activation.js","sourceRoot":"","sources":["../../../../src/lib/features/core/activation.ts"],"names":[],"mappings":"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"}

package/dist/lib/features/core/declarativeExperiments.d.ts

@@ -45,6 +45,10 @@ export interface DeclarativeExperimentHost {
         getAssignments(): Record<string, string>;
     };
     track(eventName: string, properties?: Record<string, unknown>): unknown;
+    /** Record a signup (used by `data-fg-signup`). */
+    signup?(userId: string, method: string, source?: string, properties?: Record<string, unknown>): unknown;
+    /** Record a login (used by `data-fg-login`). */
+    login?(userId: string, method?: string, properties?: Record<string, unknown>): unknown;
 }
 /**
  * Wire every `[data-fg-goal]` / `[data-fg-event]` element under `root` that

package/dist/lib/features/core/declarativeExperiments.js

@@ -44,6 +44,8 @@ exports.wireDeclarativeExperiments = wireDeclarativeExperiments;
 const WIRED_ATTR = "data-fg-wired";
 const GOAL_ATTR = "data-fg-goal";
 const EVENT_ATTR = "data-fg-event";
+const SIGNUP_ATTR = "data-fg-signup";
+const LOGIN_ATTR = "data-fg-login";
 function parseTrigger(raw) {
     switch ((raw || "").toLowerCase()) {
         case "load": return "load";
@@ -93,6 +95,26 @@ function fire(host, el) {
         }
         catch { /* ignore */ }
     }
+    // No-code signup/login: <button data-fg-signup="google">.  The attribute
+    // value (or data-fg-method) is the method; data-fg-userid is optional (the
+    // funnel keys on the auto-attached visitor_id, so userId is just metadata).
+    if (el.hasAttribute(SIGNUP_ATTR) && host.signup) {
+        const method = el.getAttribute(SIGNUP_ATTR) || el.getAttribute("data-fg-method") || "unknown";
+        const userId = el.getAttribute("data-fg-userid") || "";
+        const source = el.getAttribute("data-fg-source") || undefined;
+        try {
+            void host.signup(userId, method, source, { source: "declarative" });
+        }
+        catch { /* ignore */ }
+    }
+    if (el.hasAttribute(LOGIN_ATTR) && host.login) {
+        const method = el.getAttribute(LOGIN_ATTR) || el.getAttribute("data-fg-method") || undefined;
+        const userId = el.getAttribute("data-fg-userid") || "";
+        try {
+            void host.login(userId, method, { source: "declarative" });
+        }
+        catch { /* ignore */ }
+    }
 }
 /**
  * Wire every `[data-fg-goal]` / `[data-fg-event]` element under `root` that
@@ -152,7 +174,7 @@ function wireDeclarativeExperiments(host) {
         }
     };
     const scan = (root = document) => {
-        const sel = `[${GOAL_ATTR}]:not([${WIRED_ATTR}]),[${EVENT_ATTR}]:not([${WIRED_ATTR}])`;
+        const sel = `[${GOAL_ATTR}]:not([${WIRED_ATTR}]),[${EVENT_ATTR}]:not([${WIRED_ATTR}]),[${SIGNUP_ATTR}]:not([${WIRED_ATTR}]),[${LOGIN_ATTR}]:not([${WIRED_ATTR}])`;
         root.querySelectorAll(sel).forEach(wireElement);
     };
     scan();