@se-studio/core-ui 0.0.0-next16-20260822103555

package/dist/CmsRendererConfig.d.ts

@@ -0,0 +1,259 @@
+/** biome-ignore-all lint/suspicious/noExplicitAny: Any is allowed */
+import type { CmsResponse, FetchOptions } from '@se-studio/contentful-rest-api';
+import type { IArticleLink, IContentContext, IInternalLink, IPersonLink, ITagLink } from '@se-studio/core-data-types';
+import type * as React from 'react';
+import type { CollectionMap, CollectionRenderer, EmbeddedCollectionMap } from './components/CmsCollection';
+import type { ComponentMap, ComponentRenderer, EmbeddedComponentMap } from './components/CmsComponent';
+import type { EmbeddedBlockInternalLinkRenderer, InternalLinkRenderer, VisualComponentRenderer } from './components/CmsContent';
+import type { EmbeddedExternalComponentMap, ExternalComponentMap } from './components/CmsExternalComponent';
+import type { IBuildInformation } from './utils/buildPageMetadata';
+import type { IContent as IPreviewContent } from './utils/previewUtils';
+/** Preview data attribute props for Contentful live preview */
+export type PreviewDataAttributes = {
+    'data-contentful-entry-id': string | undefined;
+    'data-contentful-asset-id': string | undefined;
+    'data-contentful-field-id': string | undefined;
+} | undefined;
+/** Preview helpers passed via renderer config to avoid circular imports from cms-server */
+export type PreviewHelpers = {
+    getPreviewFieldIdProps: (id?: string, fieldId?: string) => PreviewDataAttributes;
+    getPreviewAssetIdProps: (assetId?: string) => PreviewDataAttributes;
+    getPreviewParentProps: (information: IPreviewContent | null | undefined) => PreviewDataAttributes;
+    getPreviewResponsiveVisualFieldIdProps: (id?: string, visualFieldId?: string, mobileVisualFieldId?: string) => {
+        visualPreviewProps: PreviewDataAttributes;
+        mobileVisualPreviewProps: PreviewDataAttributes;
+    };
+};
+/**
+ * Options for link fetcher functions.
+ * All FetchOptions fields are optional (buildOptions fills defaults internally).
+ * Pass `allowUnindexed` to opt in to receiving entries with indexed === false.
+ *
+ * Note: Article filter criteria fields (articleType*, tag*, author*, tagType*, strictAuthorMatch,
+ * excludeArticleIds, before, after, count) only affect getAllArticleLinks (via filterRelatedArticles).
+ * They are accepted (for convenience) on other getAll*Links signatures but are ignored there.
+ */
+export type LinkFetchOptions = Partial<FetchOptions> & {
+    /** Pass `allowUnindexed: true` to opt in to receiving entries with indexed === false. */
+    allowUnindexed?: boolean;
+    /** Filter to articles matching any of these article type IDs (OR). Only affects getAllArticleLinks. */
+    articleTypeIds?: string[];
+    /** Filter to articles matching any of these article type slugs (OR). Only affects getAllArticleLinks. */
+    articleTypeSlugs?: string[];
+    /** Filter to articles matching any of these tag IDs (OR); articles with more matches rank higher. Only affects getAllArticleLinks. */
+    tagIds?: string[];
+    /** Filter to articles matching any of these tag slugs (OR); articles with more matches rank higher. Only affects getAllArticleLinks. */
+    tagSlugs?: string[];
+    /** Filter to articles that have at least one tag belonging to any of these tag type IDs. Only affects getAllArticleLinks. */
+    tagTypeIds?: string[];
+    /** Filter to articles that have at least one tag belonging to any of these tag type slugs. Only affects getAllArticleLinks. */
+    tagTypeSlugs?: string[];
+    /** Filter/rank by author IDs - articles with matching authors are ranked higher. Only affects getAllArticleLinks. */
+    authorIds?: string[];
+    /** Filter/rank by author slugs - articles with matching authors are ranked higher. Only affects getAllArticleLinks. */
+    authorSlugs?: string[];
+    /** When true, authorIds/authorSlugs become a hard filter (exclude non-matching) rather than just a ranking boost. Only affects getAllArticleLinks. */
+    strictAuthorMatch?: boolean;
+    /** Articles to exclude from results. Only affects getAllArticleLinks. */
+    excludeArticleIds?: string[];
+    /** Only include articles published before this date. Only affects getAllArticleLinks. */
+    before?: Date;
+    /** Only include articles published after this date. Only affects getAllArticleLinks. */
+    after?: Date;
+    /** Maximum number of results to return (after filter/score/sort; undefined = all). Only affects getAllArticleLinks. */
+    count?: number;
+    /**
+     * CMS fetch profile for bulk link fetches. `listing` omits nav/content trees (smaller payloads).
+     * Only affects getAllArticleLinks. Default `listing`.
+     */
+    fetchProfile?: 'page' | 'listing';
+    /** Pagination page size for getAllArticleLinks. Default 100. */
+    pageSize?: number;
+};
+/** Fetch helpers for components that need to load data (avoids circular cms-server imports) */
+export type FetchHelpers = {
+    getAllArticleLinks?: (options?: LinkFetchOptions) => Promise<CmsResponse<IArticleLink[]>>;
+    getAllTagLinks?: (options?: LinkFetchOptions) => Promise<CmsResponse<IInternalLink[]>>;
+    getAllPersonLinks?: (options?: LinkFetchOptions) => Promise<CmsResponse<IPersonLink[]>>;
+    /** Uses `any` for information to accept project-specific collection types */
+    getRelatedArticles?: (information: any, contentContext: IContentContext, count?: number) => Promise<CmsResponse<IArticleLink[]>>;
+    getRelatedPeople?: (information: any, contentContext: IContentContext, count: number) => Promise<CmsResponse<IPersonLink[]>>;
+    getRelatedTags?: (information: any, contentContext: IContentContext, count: number) => Promise<CmsResponse<ITagLink[]>>;
+};
+export type CmsRendererTypes = {
+    componentNameType: string;
+    componentType: any;
+    collectionNameType: string;
+    collectionType: any;
+    externalComponentNameType: string;
+    externalComponentType: any;
+};
+/**
+ * Configuration object that bundles all CMS renderer maps and display options.
+ * Create this once at the project level and pass it to CmsContent.
+ *
+ * This provides a clean, extensible API for configuring how CMS content is rendered,
+ * making it easy to add new renderer types without breaking existing code.
+ *
+ * @example Basic configuration
+ * ```tsx
+ * const rendererConfig = {
+ *   buildInformation,
+ *   componentMap: {
+ *     "Hero": HeroComponent,
+ *     "CTA": CTAComponent,
+ *     "Content Block": ContentBlock,
+ *   },
+ *   collectionMap: {
+ *     "FAQs": FAQCollection,
+ *     "Related Articles": RelatedArticles,
+ *   },
+ *   // ... other required fields
+ * };
+ * ```
+ *
+ * Error panels (unknown types, render errors) are shown when `!buildInformation.isProduction`.
+ */
+export interface CmsRendererConfig<TConfig extends CmsRendererTypes = CmsRendererTypes> {
+    /**
+     * Map of component types to their renderers.
+     * Each key should match a ComponentType from your CMS configuration.
+     *
+     * @example
+     * ```tsx
+     * componentMap: {
+     *   "Hero": HeroComponent,
+     *   "CTA": CTAComponent,
+     * }
+     * ```
+     */
+    componentMap: ComponentMap<TConfig['componentNameType'], TConfig['componentType']>;
+    embeddedComponentMap: EmbeddedComponentMap<TConfig['componentNameType'], TConfig['componentType']>;
+    /**
+     * Map of collection types to their renderers.
+     * Each key should match a CollectionType from your CMS configuration.
+     *
+     * @example
+     * ```tsx
+     * collectionMap: {
+     *   "FAQs": FAQCollection,
+     *   "Related Articles": RelatedArticles,
+     * }
+     * ```
+     */
+    collectionMap: CollectionMap<TConfig['collectionNameType'], TConfig['collectionType']>;
+    embeddedCollectionMap: EmbeddedCollectionMap<TConfig['collectionNameType'], TConfig['collectionType']>;
+    /**
+     * Map of external component types to their renderers (optional).
+     * Use this for third-party integrations, forms, widgets, etc.
+     *
+     * @example
+     * ```tsx
+     * externalComponentMap: {
+     *   "Contact Form": ContactFormRenderer,
+     *   "Newsletter": NewsletterRenderer,
+     * }
+     * ```
+     */
+    externalComponentMap: ExternalComponentMap<TConfig['externalComponentNameType'], TConfig['externalComponentType']>;
+    embeddedExternalComponentMap: EmbeddedExternalComponentMap<TConfig['externalComponentNameType'], TConfig['externalComponentType']>;
+    /**
+     * Set of component type names that have explicitly opted out of embedding
+     * (registered with `embeddedRenderer: false`). When a type is in this set,
+     * `CmsEmbeddedComponent` shows a "not supported" warning in dev instead of
+     * falling back to the top-level renderer.
+     */
+    noEmbedComponents?: Set<string>;
+    /** Set of collection type names that have explicitly opted out of embedding. */
+    noEmbedCollections?: Set<string>;
+    /** Set of external component type names that have explicitly opted out of embedding. */
+    noEmbedExternalComponents?: Set<string>;
+    /**
+     * Renderer for Visual content types (optional).
+     * Use this to define how images, videos, and other visual assets are rendered.
+     * When `embedded` is true (e.g. in RTF or inside a collection), render a compact
+     * variant; when false or omitted (standalone page content), render with full section layout.
+     *
+     * @example
+     * ```tsx
+     * visualComponentRenderer: ({ information, contentContext, embedded }) => (
+     *   embedded ? (
+     *     <Visual visual={information} className="w-full" />
+     *   ) : (
+     *     <Section><Visual visual={information} /></Section>
+     *   )
+     * )
+     * ```
+     */
+    visualComponentRenderer: VisualComponentRenderer;
+    /**
+     * Renderer for Internal Link content types (optional).
+     * Use this to define how internal navigation links are rendered.
+     *
+     * @example
+     * ```tsx
+     * internalLinkRenderer: ({ information }) => (
+     *   <Link href={information.href}>{information.text}</Link>
+     * )
+     * ```
+     */
+    internalLinkRenderer: InternalLinkRenderer;
+    /**
+     * Optional renderer for Internal link entries embedded as a **block** in rich text
+     * (`BLOCKS.EMBEDDED_ENTRY`). Use for block-level presentation (e.g. CTA button) that
+     * differs from inline links. Inline embeds and entry hyperlinks still use `internalLinkRenderer`.
+     * When omitted, block embeds fall back to `internalLinkRenderer` inside the position wrapper
+     * (non-breaking for existing projects).
+     */
+    embeddedBlockInternalLinkRenderer?: EmbeddedBlockInternalLinkRenderer;
+    /**
+     * Map of custom content types to their renderers (optional).
+     * Use this for project-specific content types that extend the base CMS content model.
+     *
+     * @example
+     * ```tsx
+     * customContentMap: {
+     *   "pricingPlan": PricingPlanRenderer,
+     *   "testimonial": TestimonialRenderer,
+     * }
+     * ```
+     */
+    customContentMap?: Partial<Record<string, React.FC<{
+        information: any;
+        contentContext: IContentContext;
+    }>>>;
+    /**
+     * Tailwind (or other) classes applied to the `HtmlComponent` root when `fullWidth` is true.
+     * Omit for the built-in viewport-breakout default. Use project-specific classes for your grid.
+     */
+    htmlComponentFullWidthClassName?: string;
+    /**
+     * Map of type → types it defers to. Built from defaultOf in component/collection registrations.
+     * When an item's type is a key here, it is not rendered if any of the listed types exist in the page.
+     */
+    defaultsMap?: Record<string, string[]>;
+    /**
+     * Optional custom text processor for both rich text and plain text.
+     * When provided, used instead of default convertText (e.g. for {{phone}} placeholders).
+     */
+    processText?: (text: string, contentContext?: IContentContext) => React.ReactNode;
+    /**
+     * Preview helpers for Contentful live preview.
+     * Pass these from cms-server to avoid circular imports (cms-server → cms → registrations → components → cms-server).
+     * Components use rendererConfig.previewHelpers?.getPreviewFieldIdProps(id, fieldId) instead of importing from cms-server.
+     */
+    previewHelpers: PreviewHelpers;
+    /**
+     * Fetch helpers for components that need to load data (getAllArticleLinks, getRelatedArticles, etc.).
+     * Pass from cms-server to avoid circular imports in collection/component renderers.
+     */
+    fetchHelpers: FetchHelpers;
+    /**
+     * Build configuration (isProduction, baseUrl, etc.).
+     * Error panels (unknown types, render errors) are shown when `!buildInformation.isProduction`.
+     */
+    buildInformation: IBuildInformation;
+    defaultComponentRenderer: ComponentRenderer<any>;
+    defaultCollectionRenderer: CollectionRenderer<any>;
+}
+//# sourceMappingURL=CmsRendererConfig.d.ts.map

package/dist/CmsRendererConfig.d.ts.map

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

package/dist/CmsRendererConfig.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=CmsRendererConfig.js.map

package/dist/CmsRendererConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CmsRendererConfig.js","sourceRoot":"","sources":["../src/CmsRendererConfig.ts"],"names":[],"mappings":""}

package/dist/__mocks__/server-only.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server-only.d.ts.map

package/dist/__mocks__/server-only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-only.d.ts","sourceRoot":"","sources":["../../src/__mocks__/server-only.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC"}

package/dist/__mocks__/server-only.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server-only.js.map

package/dist/__mocks__/server-only.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-only.js","sourceRoot":"","sources":["../../src/__mocks__/server-only.ts"],"names":[],"mappings":""}

package/dist/analytics/AnalyticsPageTracker.d.ts

@@ -0,0 +1,11 @@
+import type { IAnalyticsContext } from '@se-studio/core-data-types';
+export interface AnalyticsPageTrackerProps {
+    /** Merged into page view properties (e.g. content type from CMS). */
+    analyticsContext?: IAnalyticsContext;
+}
+/**
+ * Tracks soft navigations via the analytics adapter (HubSpot Mode B).
+ * Skips the first mount so the initial page view is handled by HubSpot auto-track.
+ */
+export declare function AnalyticsPageTracker({ analyticsContext }: AnalyticsPageTrackerProps): null;
+//# sourceMappingURL=AnalyticsPageTracker.d.ts.map

package/dist/analytics/AnalyticsPageTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsPageTracker.d.ts","sourceRoot":"","sources":["../../src/analytics/AnalyticsPageTracker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAKpE,MAAM,WAAW,yBAAyB;IACxC,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,gBAAgB,EAAE,EAAE,yBAAyB,QAoBnF"}

package/dist/analytics/AnalyticsPageTracker.js

@@ -0,0 +1,26 @@
+'use client';
+import { usePathname } from 'next/navigation';
+import { useEffect, useRef } from 'react';
+import { useAnalytics } from './useAnalytics';
+/**
+ * Tracks soft navigations via the analytics adapter (HubSpot Mode B).
+ * Skips the first mount so the initial page view is handled by HubSpot auto-track.
+ */
+export function AnalyticsPageTracker({ analyticsContext }) {
+    const pathname = usePathname();
+    const { trackPage } = useAnalytics();
+    const isFirstMount = useRef(true);
+    useEffect(() => {
+        if (typeof window === 'undefined') {
+            return;
+        }
+        if (isFirstMount.current) {
+            isFirstMount.current = false;
+            return;
+        }
+        const context = analyticsContext ?? { slug: pathname };
+        trackPage(window.location.href, pathname, context);
+    }, [pathname, trackPage, analyticsContext]);
+    return null;
+}
+//# sourceMappingURL=AnalyticsPageTracker.js.map

package/dist/analytics/AnalyticsPageTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsPageTracker.js","sourceRoot":"","sources":["../../src/analytics/AnalyticsPageTracker.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAO9C;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAE,gBAAgB,EAA6B;IAClF,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,EAAE,CAAC;IACrC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAElC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;YACzB,YAAY,CAAC,OAAO,GAAG,KAAK,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAsB,gBAAgB,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC1E,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAE5C,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/analytics/AnalyticsProvider.d.ts

@@ -0,0 +1,18 @@
+import type { ReactNode } from 'react';
+import type { AnalyticsAdapter } from './types';
+interface AnalyticsProviderProps {
+    adapter: AnalyticsAdapter;
+    children: ReactNode;
+}
+/**
+ * Provider component that makes analytics adapter available to child components
+ */
+export declare function AnalyticsProvider({ adapter, children }: AnalyticsProviderProps): import("react").JSX.Element;
+/**
+ * Hook to access the analytics adapter from context.
+ * Returns a no-op adapter when no provider is present so client components never crash
+ * the React tree (SSR prerender and defensive client fallback).
+ */
+export declare function useAnalyticsContext(): AnalyticsAdapter;
+export {};
+//# sourceMappingURL=AnalyticsProvider.d.ts.map

package/dist/analytics/AnalyticsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsProvider.d.ts","sourceRoot":"","sources":["../../src/analytics/AnalyticsProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,SAAS,EAAE,MAAM,OAAO,CAAC;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAgChD,UAAU,sBAAsB;IAC9B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,sBAAsB,+BAE9E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAYtD"}

package/dist/analytics/AnalyticsProvider.js

@@ -0,0 +1,48 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from 'react';
+/** Stable global key so duplicate package instances share one React context identity. */
+const GLOBAL_CONTEXT_KEY = '__SE_STUDIO_ANALYTICS_CONTEXT__';
+/**
+ * Share one React context identity even when `@se-studio/core-ui` is duplicated in the
+ * client bundle (pnpm peer isolation / multi-chunk). Separate module evaluations that each
+ * call `createContext()` would otherwise break the provider tree and crash the site with
+ * "useAnalyticsContext must be used within an AnalyticsProvider".
+ */
+function getAnalyticsContext() {
+    const globalStore = globalThis;
+    if (!globalStore[GLOBAL_CONTEXT_KEY]) {
+        globalStore[GLOBAL_CONTEXT_KEY] = createContext(null);
+    }
+    return globalStore[GLOBAL_CONTEXT_KEY];
+}
+const AnalyticsContext = getAnalyticsContext();
+/** Silent no-op when provider is missing (SSR prerender, or no layout provider). */
+const NOOP_ANALYTICS_FALLBACK = {
+    trackEvent() { },
+    trackPage() { },
+    trackClick() { },
+};
+/**
+ * Provider component that makes analytics adapter available to child components
+ */
+export function AnalyticsProvider({ adapter, children }) {
+    return _jsx(AnalyticsContext.Provider, { value: adapter, children: children });
+}
+/**
+ * Hook to access the analytics adapter from context.
+ * Returns a no-op adapter when no provider is present so client components never crash
+ * the React tree (SSR prerender and defensive client fallback).
+ */
+export function useAnalyticsContext() {
+    const adapter = useContext(AnalyticsContext);
+    if (adapter) {
+        return adapter;
+    }
+    // Dev-only signal that tracking is a no-op (missing layout provider or mis-wiring).
+    if (process.env.NODE_ENV !== 'production' && typeof window !== 'undefined') {
+        console.warn('[analytics] useAnalyticsContext used without AnalyticsProvider; tracking is a no-op.');
+    }
+    return NOOP_ANALYTICS_FALLBACK;
+}
+//# sourceMappingURL=AnalyticsProvider.js.map

package/dist/analytics/AnalyticsProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsProvider.js","sourceRoot":"","sources":["../../src/analytics/AnalyticsProvider.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAGlD,yFAAyF;AACzF,MAAM,kBAAkB,GAAG,iCAAiC,CAAC;AAM7D;;;;;GAKG;AACH,SAAS,mBAAmB;IAC1B,MAAM,WAAW,GAAG,UAAwC,CAAC;IAC7D,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACrC,WAAW,CAAC,kBAAkB,CAAC,GAAG,aAAa,CAA0B,IAAI,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,WAAW,CAAC,kBAAkB,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,gBAAgB,GAAG,mBAAmB,EAAE,CAAC;AAE/C,oFAAoF;AACpF,MAAM,uBAAuB,GAAqB;IAChD,UAAU,KAAI,CAAC;IACf,SAAS,KAAI,CAAC;IACd,UAAU,KAAI,CAAC;CAChB,CAAC;AAOF;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAA0B;IAC7E,OAAO,KAAC,gBAAgB,CAAC,QAAQ,IAAC,KAAK,EAAE,OAAO,YAAG,QAAQ,GAA6B,CAAC;AAC3F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,OAAO,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC7C,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,oFAAoF;IACpF,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAC3E,OAAO,CAAC,IAAI,CACV,sFAAsF,CACvF,CAAC;IACJ,CAAC;IACD,OAAO,uBAAuB,CAAC;AACjC,CAAC"}

package/dist/analytics/adapters/CompositeAnalyticsAdapter.d.ts

@@ -0,0 +1,13 @@
+import type { AnalyticsAdapter, ClickTrackingProperties, PageTrackingProperties } from '../types';
+/**
+ * Fans out analytics calls to multiple adapters (e.g. GTM + HubSpot).
+ */
+export declare class CompositeAnalyticsAdapter implements AnalyticsAdapter {
+    private readonly adapters;
+    constructor(adapters: AnalyticsAdapter[]);
+    initialize(): void;
+    trackEvent(event: string, properties: Record<string, unknown>): void;
+    trackPage(url: string, properties: PageTrackingProperties): void;
+    trackClick(properties: ClickTrackingProperties): void;
+}
+//# sourceMappingURL=CompositeAnalyticsAdapter.d.ts.map

package/dist/analytics/adapters/CompositeAnalyticsAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeAnalyticsAdapter.d.ts","sourceRoot":"","sources":["../../../src/analytics/adapters/CompositeAnalyticsAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAQlG;;GAEG;AACH,qBAAa,yBAA0B,YAAW,gBAAgB;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,gBAAgB,EAAE;IAEzD,UAAU,IAAI,IAAI;IAMlB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMpE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,sBAAsB,GAAG,IAAI;IAMhE,UAAU,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI;CAKtD"}

package/dist/analytics/adapters/CompositeAnalyticsAdapter.js

@@ -0,0 +1,35 @@
+function callInitialize(adapter) {
+    if ('initialize' in adapter && typeof adapter.initialize === 'function') {
+        adapter.initialize();
+    }
+}
+/**
+ * Fans out analytics calls to multiple adapters (e.g. GTM + HubSpot).
+ */
+export class CompositeAnalyticsAdapter {
+    adapters;
+    constructor(adapters) {
+        this.adapters = adapters;
+    }
+    initialize() {
+        for (const adapter of this.adapters) {
+            callInitialize(adapter);
+        }
+    }
+    trackEvent(event, properties) {
+        for (const adapter of this.adapters) {
+            adapter.trackEvent(event, properties);
+        }
+    }
+    trackPage(url, properties) {
+        for (const adapter of this.adapters) {
+            adapter.trackPage(url, properties);
+        }
+    }
+    trackClick(properties) {
+        for (const adapter of this.adapters) {
+            adapter.trackClick(properties);
+        }
+    }
+}
+//# sourceMappingURL=CompositeAnalyticsAdapter.js.map

package/dist/analytics/adapters/CompositeAnalyticsAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeAnalyticsAdapter.js","sourceRoot":"","sources":["../../../src/analytics/adapters/CompositeAnalyticsAdapter.ts"],"names":[],"mappings":"AAEA,SAAS,cAAc,CAAC,OAAyB;IAC/C,IAAI,YAAY,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QACxE,OAAO,CAAC,UAAU,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,yBAAyB;IACP;IAA7B,YAA6B,QAA4B;QAA5B,aAAQ,GAAR,QAAQ,CAAoB;IAAG,CAAC;IAE7D,UAAU;QACR,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,UAAU,CAAC,KAAa,EAAE,UAAmC;QAC3D,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,SAAS,CAAC,GAAW,EAAE,UAAkC;QACvD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,UAAU,CAAC,UAAmC;QAC5C,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;CACF"}

package/dist/analytics/adapters/ConsentAwareAdapter.d.ts

@@ -0,0 +1,20 @@
+import type { AnalyticsAdapter, ClickTrackingProperties, PageTrackingProperties } from '../types';
+/**
+ * Adapter that wraps another analytics adapter and checks for consent before tracking.
+ *
+ * @example
+ * ```tsx
+ * const gtmAdapter = new GoogleTagManagerAdapter(...);
+ * const consentAwareAdapter = new ConsentAwareAdapter(gtmAdapter, 'google-tag-manager');
+ * ```
+ */
+export declare class ConsentAwareAdapter implements AnalyticsAdapter {
+    private adapter;
+    private consentName;
+    private getConsent;
+    constructor(adapter: AnalyticsAdapter, consentName: string, getConsent: (name: string) => boolean);
+    trackEvent(event: string, properties: Record<string, unknown>): void;
+    trackPage(url: string, properties: PageTrackingProperties): void;
+    trackClick(properties: ClickTrackingProperties): void;
+}
+//# sourceMappingURL=ConsentAwareAdapter.d.ts.map

package/dist/analytics/adapters/ConsentAwareAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsentAwareAdapter.d.ts","sourceRoot":"","sources":["../../../src/analytics/adapters/ConsentAwareAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAElG;;;;;;;;GAQG;AACH,qBAAa,mBAAoB,YAAW,gBAAgB;IAExD,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,UAAU;gBAFV,OAAO,EAAE,gBAAgB,EACzB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO;IAG/C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMpE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,sBAAsB,GAAG,IAAI;IAMhE,UAAU,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI;CAKtD"}

package/dist/analytics/adapters/ConsentAwareAdapter.js

@@ -0,0 +1,35 @@
+/**
+ * Adapter that wraps another analytics adapter and checks for consent before tracking.
+ *
+ * @example
+ * ```tsx
+ * const gtmAdapter = new GoogleTagManagerAdapter(...);
+ * const consentAwareAdapter = new ConsentAwareAdapter(gtmAdapter, 'google-tag-manager');
+ * ```
+ */
+export class ConsentAwareAdapter {
+    adapter;
+    consentName;
+    getConsent;
+    constructor(adapter, consentName, getConsent) {
+        this.adapter = adapter;
+        this.consentName = consentName;
+        this.getConsent = getConsent;
+    }
+    trackEvent(event, properties) {
+        if (this.getConsent(this.consentName)) {
+            this.adapter.trackEvent(event, properties);
+        }
+    }
+    trackPage(url, properties) {
+        if (this.getConsent(this.consentName)) {
+            this.adapter.trackPage(url, properties);
+        }
+    }
+    trackClick(properties) {
+        if (this.getConsent(this.consentName)) {
+            this.adapter.trackClick(properties);
+        }
+    }
+}
+//# sourceMappingURL=ConsentAwareAdapter.js.map

package/dist/analytics/adapters/ConsentAwareAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsentAwareAdapter.js","sourceRoot":"","sources":["../../../src/analytics/adapters/ConsentAwareAdapter.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,OAAO,mBAAmB;IAEpB;IACA;IACA;IAHV,YACU,OAAyB,EACzB,WAAmB,EACnB,UAAqC;QAFrC,YAAO,GAAP,OAAO,CAAkB;QACzB,gBAAW,GAAX,WAAW,CAAQ;QACnB,eAAU,GAAV,UAAU,CAA2B;IAC5C,CAAC;IAEJ,UAAU,CAAC,KAAa,EAAE,UAAmC;QAC3D,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,SAAS,CAAC,GAAW,EAAE,UAAkC;QACvD,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,UAAU,CAAC,UAAmC;QAC5C,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;CACF"}

package/dist/analytics/adapters/ConsoleAnalyticsAdapter.d.ts

@@ -0,0 +1,12 @@
+import type { AnalyticsAdapter, ClickTrackingProperties, PageTrackingProperties } from '../types';
+/**
+ * Console adapter used as the default/example implementation.
+ * Customer projects should provide their own adapter that satisfies `AnalyticsAdapter`.
+ */
+export declare class ConsoleAnalyticsAdapter implements AnalyticsAdapter {
+    private log;
+    trackEvent(event: string, properties: Record<string, unknown>): void;
+    trackPage(url: string, properties: PageTrackingProperties): void;
+    trackClick(properties: ClickTrackingProperties): void;
+}
+//# sourceMappingURL=ConsoleAnalyticsAdapter.d.ts.map

package/dist/analytics/adapters/ConsoleAnalyticsAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleAnalyticsAdapter.d.ts","sourceRoot":"","sources":["../../../src/analytics/adapters/ConsoleAnalyticsAdapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAElG;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,OAAO,CAAC,GAAG;IAKX,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIpE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,sBAAsB,GAAG,IAAI;IAIhE,UAAU,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI;CAItD"}

package/dist/analytics/adapters/ConsoleAnalyticsAdapter.js

@@ -0,0 +1,22 @@
+'use client';
+/**
+ * Console adapter used as the default/example implementation.
+ * Customer projects should provide their own adapter that satisfies `AnalyticsAdapter`.
+ */
+export class ConsoleAnalyticsAdapter {
+    log(...args) {
+        // eslint-disable-next-line no-console -- intentional logging adapter
+        console.log('[Analytics]', ...args);
+    }
+    trackEvent(event, properties) {
+        this.log('event', event, properties);
+    }
+    trackPage(url, properties) {
+        this.log('page', { ...properties, url });
+    }
+    trackClick(properties) {
+        const eventName = properties.trackingInfo?.trackingEventName?.trim() || 'click';
+        this.log(eventName, properties);
+    }
+}
+//# sourceMappingURL=ConsoleAnalyticsAdapter.js.map

package/dist/analytics/adapters/ConsoleAnalyticsAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleAnalyticsAdapter.js","sourceRoot":"","sources":["../../../src/analytics/adapters/ConsoleAnalyticsAdapter.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAIb;;;GAGG;AACH,MAAM,OAAO,uBAAuB;IAC1B,GAAG,CAAC,GAAG,IAAe;QAC5B,qEAAqE;QACrE,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,UAAU,CAAC,KAAa,EAAE,UAAmC;QAC3D,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IACvC,CAAC;IAED,SAAS,CAAC,GAAW,EAAE,UAAkC;QACvD,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,UAAU,CAAC,UAAmC;QAC5C,MAAM,SAAS,GAAG,UAAU,CAAC,YAAY,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC;QAChF,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dist/analytics/adapters/GoogleTagManagerAdapter.d.ts

@@ -0,0 +1,53 @@
+import type { AnalyticsAdapter, ClickTrackingProperties, PageTrackingProperties } from '../types';
+declare global {
+    interface Window {
+        dataLayer: unknown[];
+    }
+}
+/**
+ * Consent state for GTM Consent Mode v2
+ */
+interface ConsentState {
+    /** Controls analytics_storage */
+    analytics?: boolean;
+    /** Controls ad_storage, ad_user_data, ad_personalization */
+    advertising?: boolean;
+}
+interface GoogleTagManagerConfig {
+    /**
+     * GTM Container ID (e.g., GTM-XXXXXXX)
+     */
+    containerId?: string;
+    /**
+     * GA4 Measurement ID (e.g., G-XXXXXXXXXX)
+     * If provided, it will be initialized via gtag.js if GTM is not used,
+     * or can be used alongside GTM if needed.
+     */
+    measurementId?: string;
+}
+export declare class GoogleTagManagerAdapter implements AnalyticsAdapter {
+    private initialized;
+    private config;
+    constructor(config: GoogleTagManagerConfig);
+    /**
+     * Push gtag commands to dataLayer
+     */
+    private gtag;
+    /**
+     * Initialize consent mode with all consent types granted by default
+     */
+    private initializeConsentMode;
+    initialize(): void;
+    /**
+     * Update consent state for specific purposes.
+     * Call this when user grants or revokes consent.
+     *
+     * @param consent - Object with analytics and/or advertising consent state
+     */
+    updateConsent(consent: ConsentState): void;
+    trackEvent(event: string, properties: Record<string, unknown>): void;
+    trackPage(url: string, properties: PageTrackingProperties): void;
+    trackClick(properties: ClickTrackingProperties): void;
+}
+export {};
+//# sourceMappingURL=GoogleTagManagerAdapter.d.ts.map