@se-studio/core-ui 1.0.55 → 1.0.58

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @se-studio/core-ui
 
+## 1.0.58
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.58
+  - @se-studio/core-data-types@1.0.58
+
+## 1.0.57
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.57
+  - @se-studio/core-data-types@1.0.57
+
+## 1.0.56
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.56
+  - @se-studio/core-data-types@1.0.56
+
 ## 1.0.55
 
 ### Patch Changes

package/CMS_INFRASTRUCTURE.md

@@ -110,9 +110,7 @@ export const rendererConfig = createCmsRendererConfig<MyProjectConfig>({
   },
   visualComponentRenderer: VisualRenderer,
   internalLinkRenderer: InternalLinkRenderer,
-  // Show errors in development mode
-  showUnknownTypeErrors: process.env.NODE_ENV === 'development',
-  showRenderErrors: process.env.NODE_ENV === 'development',
+  buildInformation,
 });
 ```
 
@@ -180,10 +178,9 @@ import { mergeCmsRendererConfig } from "@se-studio/core-ui";
 
 const baseConfig = createCmsRendererConfig({ ... });
 
-// Preview config with all errors displayed
+// Preview config: use buildInformation with isProduction: false to show errors
 export const previewConfig = mergeCmsRendererConfig(baseConfig, {
-  showUnknownTypeErrors: true,
-  showRenderErrors: true,
+  buildInformation: { ...baseConfig.buildInformation, isProduction: false },
 });
 
 // Use in preview routes
@@ -194,15 +191,13 @@ export const previewConfig = mergeCmsRendererConfig(baseConfig, {
 
 ```tsx
 const productionConfig = createCmsRendererConfig({
+  buildInformation: { ...buildInfo, isProduction: true },
   componentMap: { ... },
   collectionMap: { ... },
-  showUnknownTypeErrors: false,
-  showRenderErrors: false,
 });
 
 const developmentConfig = mergeCmsRendererConfig(productionConfig, {
-  showUnknownTypeErrors: true,
-  showRenderErrors: true,
+  buildInformation: { ...buildInfo, isProduction: false },
 });
 
 export const rendererConfig =
@@ -247,16 +242,17 @@ The main configuration type that bundles all renderer maps:
 
 ```tsx
 interface CmsRendererConfig<TConfig extends BaseCmsConfig> {
+  buildInformation: IBuildInformation;
   componentMap: ComponentMap<TConfig>;
   collectionMap: CollectionMap<TConfig>;
   externalComponentMap?: ExternalComponentMap<TConfig>;
   visualComponentRenderer?: VisualComponentRenderer<TConfig>;
   internalLinkRenderer?: InternalLinkRenderer<TConfig>;
-  showUnknownTypeErrors?: boolean;
-  showRenderErrors?: boolean;
 }
 ```
 
+Error panels (unknown types, render errors) are shown when `!buildInformation.isProduction`.
+
 ### Context Types
 
 - `IPageContext<TConfig>`: Page-level context (article, page, tag links)
@@ -268,7 +264,7 @@ interface CmsRendererConfig<TConfig extends BaseCmsConfig> {
 
 ### Unknown Type Warnings
 
-In development mode, the infrastructure displays visual warnings for:
+When not in production (`!buildInformation.isProduction`), the infrastructure displays visual warnings for:
 - Unmapped component/collection types
 - Rendering errors
 - Unused CMS properties
@@ -277,7 +273,7 @@ In development mode, the infrastructure displays visual warnings for:
 
 When a component/collection type isn't mapped:
 1. A warning is logged to console
-2. In dev mode, an error panel is displayed
+2. When not in production, an error panel is displayed
 3. A generic fallback renderer is used
 4. The page continues to render (no crashes)
 
@@ -301,7 +297,7 @@ To migrate an existing project:
 1. Install core-ui: `pnpm add @se-studio/core-ui`
 2. Create ComponentMap and CollectionMap
 3. Replace direct component rendering with CmsContent
-4. Test with `showUnknownTypeErrors={true}` to find missing mappings
+4. Use a non-production build (e.g. `buildInformation.isProduction: false`) to see error panels for missing mappings
 
 ## Examples
 
@@ -320,8 +316,7 @@ See the example apps in this monorepo for complete working implementations:
 - `externalComponentMap`: Map of external component types to renderers (optional)
 - `visualComponentRenderer`: Renderer for Visual content types (optional)
 - `internalLinkRenderer`: Renderer for Internal Link content types (optional)
-- `showUnknownTypeErrors`: Show error panels for unknown types (default: false)
-- `showRenderErrors`: Show error panels for rendering errors (default: false)
+- `buildInformation`: Build config (isProduction, baseUrl, etc.). Error panels are shown when `!buildInformation.isProduction`
 
 ## Future Enhancements
 

package/dist/CmsRendererConfig.d.ts

@@ -5,13 +5,14 @@ import type { CollectionMap, CollectionRenderer, EmbeddedCollectionMap } from '.
 import type { ComponentMap, ComponentRenderer, EmbeddedComponentMap } from './components/CmsComponent';
 import type { InternalLinkRenderer, VisualComponentRenderer } from './components/CmsContent';
 import type { EmbeddedExternalComponentMap, ExternalComponentMap } from './components/CmsExternalComponent';
+import type { IBuildInformation } from './utils/buildPageMetadata';
 export type CmsRendererTypes = {
-    ComponentNameType: string;
-    ComponentType: any;
-    CollectionNameType: string;
-    CollectionType: any;
-    ExternalComponentNameType: string;
-    ExternalComponentType: any;
+    componentNameType: string;
+    componentType: any;
+    collectionNameType: string;
+    collectionType: any;
+    externalComponentNameType: string;
+    externalComponentType: any;
 };
 /**
  * Configuration object that bundles all CMS renderer maps and display options.
@@ -22,7 +23,8 @@ export type CmsRendererTypes = {
  *
  * @example Basic configuration
  * ```tsx
- * const rendererConfig = createCmsRendererConfig<MyProjectConfig>({
+ * const rendererConfig = {
+ *   buildInformation,
  *   componentMap: {
  *     "Hero": HeroComponent,
  *     "CTA": CTAComponent,
@@ -32,25 +34,11 @@ export type CmsRendererTypes = {
  *     "FAQs": FAQCollection,
  *     "Related Articles": RelatedArticles,
  *   },
- *   showUnknownTypeErrors: process.env.NODE_ENV === 'development',
- * });
+ *   // ... other required fields
+ * };
  * ```
  *
- * @example With all renderer types
- * ```tsx
- * const rendererConfig = createCmsRendererConfig<MyProjectConfig>({
- *   componentMap: { ... },
- *   collectionMap: { ... },
- *   externalComponentMap: {
- *     "Contact Form": ContactFormRenderer,
- *     "Newsletter": NewsletterRenderer,
- *   },
- *   visualComponentRenderer: VisualRenderer,
- *   internalLinkRenderer: InternalLinkRenderer,
- *   showUnknownTypeErrors: true,
- *   showRenderErrors: true,
- * });
- * ```
+ * Error panels (unknown types, render errors) are shown when `!buildInformation.isProduction`.
  */
 export interface CmsRendererConfig<TConfig extends CmsRendererTypes = CmsRendererTypes> {
     /**
@@ -65,8 +53,8 @@ export interface CmsRendererConfig<TConfig extends CmsRendererTypes = CmsRendere
      * }
      * ```
      */
-    componentMap: ComponentMap<TConfig['ComponentNameType'], TConfig['ComponentType']>;
-    embeddedComponentMap: EmbeddedComponentMap<TConfig['ComponentNameType'], TConfig['ComponentType']>;
+    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.
@@ -79,8 +67,8 @@ export interface CmsRendererConfig<TConfig extends CmsRendererTypes = CmsRendere
      * }
      * ```
      */
-    collectionMap: CollectionMap<TConfig['CollectionNameType'], TConfig['CollectionType']>;
-    embeddedCollectionMap: EmbeddedCollectionMap<TConfig['CollectionNameType'], TConfig['CollectionType']>;
+    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.
@@ -93,8 +81,8 @@ export interface CmsRendererConfig<TConfig extends CmsRendererTypes = CmsRendere
      * }
      * ```
      */
-    externalComponentMap: ExternalComponentMap<TConfig['ExternalComponentNameType'], TConfig['ExternalComponentType']>;
-    embeddedExternalComponentMap: EmbeddedExternalComponentMap<TConfig['ExternalComponentNameType'], TConfig['ExternalComponentType']>;
+    externalComponentMap: ExternalComponentMap<TConfig['externalComponentNameType'], TConfig['externalComponentType']>;
+    embeddedExternalComponentMap: EmbeddedExternalComponentMap<TConfig['externalComponentNameType'], TConfig['externalComponentType']>;
     /**
      * Renderer for Visual content types (optional).
      * Use this to define how images, videos, and other visual assets are rendered.
@@ -136,19 +124,10 @@ export interface CmsRendererConfig<TConfig extends CmsRendererTypes = CmsRendere
         contentContext: IContentContext;
     }>>>;
     /**
-     * Show error panels for unknown content types in development mode (default: false).
-     * When true, displays a visual warning when a component/collection type is not mapped.
-     *
-     * Recommended: Set to `process.env.NODE_ENV === 'development'`
-     */
-    showUnknownTypeErrors: boolean;
-    /**
-     * Show error panels for rendering errors (default: false).
-     * When true, displays error details when a component throws during rendering.
-     *
-     * Recommended: Set to `process.env.NODE_ENV === 'development'`
+     * Build configuration (isProduction, baseUrl, etc.).
+     * Error panels (unknown types, render errors) are shown when `!buildInformation.isProduction`.
      */
-    showRenderErrors: boolean;
+    buildInformation: IBuildInformation;
     defaultComponentRenderer: ComponentRenderer<any>;
     defaultCollectionRenderer: CollectionRenderer<any>;
 }

package/dist/CmsRendererConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CmsRendererConfig.d.ts","sourceRoot":"","sources":["../src/CmsRendererConfig.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kEAAkE,CAAC;AAC9F,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC7F,OAAO,KAAK,EACV,4BAA4B,EAC5B,oBAAoB,EACrB,MAAM,mCAAmC,CAAC;AAE3C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,GAAG,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,GAAG,CAAC;IACpB,yBAAyB,EAAE,MAAM,CAAC;IAClC,qBAAqB,EAAE,GAAG,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,WAAW,iBAAiB,CAAC,OAAO,SAAS,gBAAgB,GAAG,gBAAgB;IACpF;;;;;;;;;;;OAWG;IACH,YAAY,EAAE,YAAY,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC;IAEnF,oBAAoB,EAAE,oBAAoB,CACxC,OAAO,CAAC,mBAAmB,CAAC,EAC5B,OAAO,CAAC,eAAe,CAAC,CACzB,CAAC;IAEF;;;;;;;;;;;OAWG;IACH,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACvF,qBAAqB,EAAE,qBAAqB,CAC1C,OAAO,CAAC,oBAAoB,CAAC,EAC7B,OAAO,CAAC,gBAAgB,CAAC,CAC1B,CAAC;IAEF;;;;;;;;;;;OAWG;IACH,oBAAoB,EAAE,oBAAoB,CACxC,OAAO,CAAC,2BAA2B,CAAC,EACpC,OAAO,CAAC,uBAAuB,CAAC,CACjC,CAAC;IACF,4BAA4B,EAAE,4BAA4B,CACxD,OAAO,CAAC,2BAA2B,CAAC,EACpC,OAAO,CAAC,uBAAuB,CAAC,CACjC,CAAC;IAEF;;;;;;;;;;OAUG;IACH,uBAAuB,EAAE,uBAAuB,CAAC;IAEjD;;;;;;;;;;OAUG;IACH,oBAAoB,EAAE,oBAAoB,CAAC;IAE3C;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,EAAE,OAAO,CACxB,MAAM,CACJ,MAAM,EACN,KAAK,CAAC,EAAE,CAAC;QACP,WAAW,EAAE,GAAG,CAAC;QACjB,cAAc,EAAE,eAAe,CAAC;KACjC,CAAC,CACH,CACF,CAAC;IAEF;;;;;OAKG;IACH,qBAAqB,EAAE,OAAO,CAAC;IAE/B;;;;;OAKG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAE1B,wBAAwB,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACjD,yBAAyB,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC;CACpD"}
+{"version":3,"file":"CmsRendererConfig.d.ts","sourceRoot":"","sources":["../src/CmsRendererConfig.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kEAAkE,CAAC;AAC9F,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC7F,OAAO,KAAK,EACV,4BAA4B,EAC5B,oBAAoB,EACrB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,GAAG,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,GAAG,CAAC;IACpB,yBAAyB,EAAE,MAAM,CAAC;IAClC,qBAAqB,EAAE,GAAG,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,iBAAiB,CAAC,OAAO,SAAS,gBAAgB,GAAG,gBAAgB;IACpF;;;;;;;;;;;OAWG;IACH,YAAY,EAAE,YAAY,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC;IAEnF,oBAAoB,EAAE,oBAAoB,CACxC,OAAO,CAAC,mBAAmB,CAAC,EAC5B,OAAO,CAAC,eAAe,CAAC,CACzB,CAAC;IAEF;;;;;;;;;;;OAWG;IACH,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACvF,qBAAqB,EAAE,qBAAqB,CAC1C,OAAO,CAAC,oBAAoB,CAAC,EAC7B,OAAO,CAAC,gBAAgB,CAAC,CAC1B,CAAC;IAEF;;;;;;;;;;;OAWG;IACH,oBAAoB,EAAE,oBAAoB,CACxC,OAAO,CAAC,2BAA2B,CAAC,EACpC,OAAO,CAAC,uBAAuB,CAAC,CACjC,CAAC;IACF,4BAA4B,EAAE,4BAA4B,CACxD,OAAO,CAAC,2BAA2B,CAAC,EACpC,OAAO,CAAC,uBAAuB,CAAC,CACjC,CAAC;IAEF;;;;;;;;;;OAUG;IACH,uBAAuB,EAAE,uBAAuB,CAAC;IAEjD;;;;;;;;;;OAUG;IACH,oBAAoB,EAAE,oBAAoB,CAAC;IAE3C;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,EAAE,OAAO,CACxB,MAAM,CACJ,MAAM,EACN,KAAK,CAAC,EAAE,CAAC;QACP,WAAW,EAAE,GAAG,CAAC;QACjB,cAAc,EAAE,eAAe,CAAC;KACjC,CAAC,CACH,CACF,CAAC;IAEF;;;OAGG;IACH,gBAAgB,EAAE,iBAAiB,CAAC;IAEpC,wBAAwB,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACjD,yBAAyB,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC;CACpD"}

package/dist/analytics/types.d.ts

@@ -1,4 +1,4 @@
-import type { IAnalyticsContext } from '@se-studio/core-data-types';
+import type { IAnalyticsContext, ILinkTrackingInfo } from '@se-studio/core-data-types';
 /**
  * Properties for tracking a click event
  */
@@ -8,6 +8,7 @@ export interface ClickTrackingProperties extends IAnalyticsContext {
     targetUrl?: string;
     linkText: string;
     location?: string;
+    trackingInfo?: ILinkTrackingInfo;
 }
 /**
  * Properties for tracking a page view

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/analytics/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAErE;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAEjE;;;OAGG;IACH,UAAU,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI,CAAC;CACvD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/analytics/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAErE;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAEjE;;;OAGG;IACH,UAAU,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI,CAAC;CACvD"}

package/dist/analytics/useAnalytics.d.ts

@@ -1,4 +1,4 @@
-import type { IAnalyticsContext } from '@se-studio/core-data-types';
+import type { IAnalyticsContext, ILinkTrackingInfo } from '@se-studio/core-data-types';
 /**
  * Hook for accessing analytics functions.
  *
@@ -40,6 +40,7 @@ export declare function useAnalytics(): {
     trackClick: (componentType: string, linkText: string, analyticsContext: IAnalyticsContext, options?: {
         targetUrl?: string;
         location?: string;
+        trackingInfo?: ILinkTrackingInfo;
     }) => void;
 };
 //# sourceMappingURL=useAnalytics.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useAnalytics.d.ts","sourceRoot":"","sources":["../../src/analytics/useAnalytics.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAKpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,YAAY;wBAIhB,MAAM,cAAc,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;qBAO7C,MAAM,YAAY,MAAM,oBAAoB,iBAAiB;gCAalD,MAAM,YACX,MAAM,oBACE,iBAAiB,YACzB;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;EAqBN"}
+{"version":3,"file":"useAnalytics.d.ts","sourceRoot":"","sources":["../../src/analytics/useAnalytics.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAKvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,YAAY;wBAIhB,MAAM,cAAc,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;qBAO7C,MAAM,YAAY,MAAM,oBAAoB,iBAAiB;gCAalD,MAAM,YACX,MAAM,oBACE,iBAAiB,YACzB;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,iBAAiB,CAAC;KAClC;EAsBN"}

package/dist/analytics/useAnalytics.js

@@ -57,6 +57,7 @@ export function useAnalytics() {
             linkText,
             location: options?.location,
             targetUrl: options?.targetUrl,
+            trackingInfo: options?.trackingInfo,
             ...analyticsContext,
         };
         adapter.trackClick(properties);

package/dist/analytics/useAnalytics.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAnalytics.js","sourceRoot":"","sources":["../../src/analytics/useAnalytics.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IAEtC,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,KAAa,EAAE,UAAmC,EAAE,EAAE;QACrD,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACxC,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,GAAW,EAAE,QAAgB,EAAE,gBAAmC,EAAE,EAAE;QACrE,MAAM,UAAU,GAA2B;YACzC,GAAG;YACH,QAAQ;YACR,GAAG,gBAAgB;SACpB,CAAC;QACF,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,MAAM,UAAU,GAAG,WAAW,CAC5B,CACE,aAAqB,EACrB,QAAgB,EAChB,gBAAmC,EACnC,OAGC,EACD,EAAE;QACF,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,MAAM,UAAU,GAA4B;YAC1C,aAAa;YACb,GAAG;YACH,QAAQ;YACR,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,SAAS,EAAE,OAAO,EAAE,SAAS;YAC7B,GAAG,gBAAgB;SACpB,CAAC;QACF,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO;QACL,UAAU;QACV,SAAS;QACT,UAAU;KACX,CAAC;AACJ,CAAC"}
+{"version":3,"file":"useAnalytics.js","sourceRoot":"","sources":["../../src/analytics/useAnalytics.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IAEtC,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,KAAa,EAAE,UAAmC,EAAE,EAAE;QACrD,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACxC,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,GAAW,EAAE,QAAgB,EAAE,gBAAmC,EAAE,EAAE;QACrE,MAAM,UAAU,GAA2B;YACzC,GAAG;YACH,QAAQ;YACR,GAAG,gBAAgB;SACpB,CAAC;QACF,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,MAAM,UAAU,GAAG,WAAW,CAC5B,CACE,aAAqB,EACrB,QAAgB,EAChB,gBAAmC,EACnC,OAIC,EACD,EAAE;QACF,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,MAAM,UAAU,GAA4B;YAC1C,aAAa;YACb,GAAG;YACH,QAAQ;YACR,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,SAAS,EAAE,OAAO,EAAE,SAAS;YAC7B,YAAY,EAAE,OAAO,EAAE,YAAY;YACnC,GAAG,gBAAgB;SACpB,CAAC;QACF,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO;QACL,UAAU;QACV,SAAS;QACT,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/app-helpers.d.ts

@@ -0,0 +1,124 @@
+/**
+ * App-level helper functions for Contentful CMS integration.
+ *
+ * This module provides a factory function that creates commonly-used helper functions
+ * for Next.js apps using the Contentful REST API. These helpers wrap the low-level
+ * API functions with project-specific configuration.
+ *
+ * @example
+ * ```typescript
+ * import { createAppHelpers } from '@se-studio/core-ui';
+ *
+ * const helpers = createAppHelpers({
+ *   converterContext,
+ *   getConfig: getContentfulConfig,
+ *   buildOptions: (options) => buildFetchOptions(options, draftOnly),
+ * });
+ *
+ * export const {
+ *   getAllPageLinks,
+ *   getPageWithErrors,
+ *   getPreviewFieldIdProps,
+ *   // ... etc
+ * } = helpers;
+ * ```
+ */
+import type { ArticleTypeFetchOptions, BaseConverterContext, CmsResponse, ContentfulConfig, FetchOptions, IContentfulCollection, IContentfulPerson, IFetchedTemplate, TagFetchOptions } from '@se-studio/contentful-rest-api';
+import type { BaseCollectionContent, IArticleLink, IArticleTypeLink, IBanner, IBaseArticle, IBaseArticleType, IBaseCustomType, IBasePage, IBaseTag, IContentContext, IInternalLink, IPersonLink } from '@se-studio/core-data-types';
+import type { IContent as IPreviewContent } from './utils/previewUtils';
+/**
+ * Configuration for creating app helpers
+ */
+export interface AppHelpersConfig {
+    /** The converter context with URL calculators and other project-specific settings */
+    converterContext: BaseConverterContext;
+    /** Function to get Contentful config based on preview mode */
+    getConfig: (preview: boolean) => ContentfulConfig;
+    /** Function to build fetch options with project-specific defaults */
+    buildOptions: (options?: Partial<FetchOptions>) => FetchOptions;
+}
+/**
+ * Return type for createAppHelpers factory function.
+ * Contains all the helper functions for fetching content and managing preview.
+ */
+export interface AppHelpers<TPage, TArticle, TArticleType, TTag, TPerson, TCustomType, TCollection> {
+    getAllPageLinks: (options?: FetchOptions) => Promise<IInternalLink[]>;
+    getAllArticleLinks: (options?: FetchOptions) => Promise<IArticleLink[]>;
+    getAllTagLinks: (options?: FetchOptions) => Promise<IInternalLink[]>;
+    getAllPersonLinks: (options?: FetchOptions) => Promise<IInternalLink[]>;
+    getAllArticleTypeLinks: (options?: FetchOptions) => Promise<IArticleTypeLink[]>;
+    getRelatedArticles: (information: TCollection, contentContext: IContentContext, count: number | undefined, options?: FetchOptions) => Promise<IArticleLink[]>;
+    getRelatedPeople: (information: TCollection, contentContext: IContentContext, count: number, options?: FetchOptions) => Promise<IPersonLink[]>;
+    getBannersWithErrors: (options?: FetchOptions) => Promise<CmsResponse<IBanner[] | null>>;
+    getPageWithErrors: (slug: string, options?: FetchOptions) => Promise<CmsResponse<TPage | null>>;
+    getArticleWithErrors: (articleTypeSlug: string, slug: string, options?: FetchOptions) => Promise<CmsResponse<TArticle | null>>;
+    getArticleTypeWithErrors: (slug: string, options?: Partial<ArticleTypeFetchOptions>) => Promise<CmsResponse<TArticleType | null>>;
+    getTagWithErrors: (slug: string, options?: Partial<TagFetchOptions>) => Promise<CmsResponse<TTag | null>>;
+    getPersonWithErrors: (slug: string, options?: Partial<FetchOptions> & {
+        customType?: string;
+    }) => Promise<CmsResponse<TPerson | null>>;
+    getCustomTypeWithErrors: (slug: string, options?: FetchOptions) => Promise<CmsResponse<TCustomType | null>>;
+    getTemplateWithErrors: (cmsLabel: string, options?: FetchOptions) => Promise<CmsResponse<IFetchedTemplate | null>>;
+    getPreviewFieldIdProps: (id?: string, fieldId?: string) => {
+        'data-contentful-entry-id': string | undefined;
+        'data-contentful-asset-id': string | undefined;
+        'data-contentful-field-id': string | undefined;
+    } | undefined;
+    getPreviewAssetIdProps: (assetId?: string) => {
+        'data-contentful-entry-id': string | undefined;
+        'data-contentful-asset-id': string | undefined;
+        'data-contentful-field-id': string | undefined;
+    } | undefined;
+    getPreviewParentProps: (information: IPreviewContent | null | undefined) => {
+        'data-contentful-entry-id': string | undefined;
+        'data-contentful-asset-id': string | undefined;
+        'data-contentful-field-id': string | undefined;
+    } | undefined;
+    getPreviewResponsiveVisualFieldIdProps: (id?: string, visualFieldId?: string, mobileVisualFieldId?: string) => {
+        visualPreviewProps: {
+            'data-contentful-entry-id': string | undefined;
+            'data-contentful-asset-id': string | undefined;
+            'data-contentful-field-id': string | undefined;
+        } | undefined;
+        mobileVisualPreviewProps: {
+            'data-contentful-entry-id': string | undefined;
+            'data-contentful-asset-id': string | undefined;
+            'data-contentful-field-id': string | undefined;
+        } | undefined;
+    };
+}
+/**
+ * Creates a set of helper functions for working with Contentful in Next.js apps.
+ *
+ * This factory function accepts project-specific configuration and returns
+ * a collection of pre-configured helper functions for:
+ * - Fetching links (pages, articles, tags, people, article types)
+ * - Fetching related content (articles, people)
+ * - Fetching full content (pages, articles, article types, tags, people, custom types, templates, banners)
+ * - Preview mode utilities (field IDs, asset IDs, parent props)
+ *
+ * All functions use the provided configuration to automatically handle:
+ * - Converter context for transforming Contentful entries
+ * - Config selection based on preview mode
+ * - Options building with project-specific defaults
+ * - Error logging and handling
+ *
+ * @param config - Configuration object with converter context, config getter, and options builder
+ * @returns Object containing all helper functions
+ *
+ * @example
+ * ```typescript
+ * const helpers = createAppHelpers({
+ *   converterContext: myConverterContext,
+ *   getConfig: getContentfulConfig,
+ *   buildOptions: (options) => buildFetchOptions(options, draftOnly),
+ * });
+ *
+ * // Use the helpers
+ * const pages = await helpers.getAllPageLinks();
+ * const page = await helpers.getPageWithErrors('home');
+ * const previewProps = helpers.getPreviewFieldIdProps(id, 'title');
+ * ```
+ */
+export declare function createAppHelpers<TPage extends IBasePage = IBasePage, TArticle extends IBaseArticle = IBaseArticle, TArticleType extends IBaseArticleType = IBaseArticleType, TTag extends IBaseTag = IBaseTag, TPerson extends IContentfulPerson = IContentfulPerson, TCustomType extends IBaseCustomType = IBaseCustomType, TCollection extends IContentfulCollection<BaseCollectionContent> = IContentfulCollection<BaseCollectionContent>>(config: AppHelpersConfig): AppHelpers<TPage, TArticle, TArticleType, TTag, TPerson, TCustomType, TCollection>;
+//# sourceMappingURL=app-helpers.d.ts.map

package/dist/app-helpers.d.ts.map

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