@se-studio/core-ui 1.0.45 → 1.0.47

package/ANALYTICS.md

@@ -0,0 +1,136 @@
+# Analytics Integration Guide
+
+Core UI provides a flexible, provider-agnostic analytics system with built-in consent management support.
+
+## Overview
+
+The analytics system consists of three parts:
+1. **AnalyticsProvider**: React context for analytics
+2. **Adapters**: Implementations for specific providers (GTM, Segment, etc.)
+3. **Consent Management**: Integration with Orejime for GDPR compliance
+
+## Usage
+
+### 1. Setup Provider
+
+Wrap your application with `ConsentProvider` and `AnalyticsProvider`.
+
+```tsx
+// src/components/AnalyticsProviderWrapper.tsx
+'use client';
+
+import { 
+  AnalyticsProvider, 
+  ConsentProvider, 
+  ConsentAwareAdapter,
+  GoogleTagManagerAdapter,
+  useConsent 
+} from '@se-studio/core-ui';
+import { useMemo } from 'react';
+
+function AnalyticsProviderInner({ children, containerId }) {
+  const { hasConsent } = useConsent();
+
+  const adapter = useMemo(() => {
+    // 1. Create base adapter
+    const gtmAdapter = new GoogleTagManagerAdapter({
+      containerId
+    });
+
+    // 2. Wrap with consent awareness
+    return new ConsentAwareAdapter(gtmAdapter, 'google-tag-manager', hasConsent);
+  }, [hasConsent, containerId]);
+
+  return <AnalyticsProvider adapter={adapter}>{children}</AnalyticsProvider>;
+}
+
+export function AnalyticsProviderWrapper({ children, gtmContainerId }) {
+  return (
+    <ConsentProvider>
+      <AnalyticsProviderInner containerId={gtmContainerId}>{children}</AnalyticsProviderInner>
+    </ConsentProvider>
+  );
+}
+```
+
+### 2. Tracking Events
+
+Use the `useAnalytics` hook to track events.
+
+```tsx
+import { useAnalytics } from '@se-studio/core-ui';
+
+function SubscribeButton() {
+  const { trackClick, trackEvent } = useAnalytics();
+
+  return (
+    <button onClick={() => trackClick('Button', 'Subscribe', { location: 'footer' })}>
+      Subscribe
+    </button>
+  );
+}
+```
+
+## Google Tag Manager (GTM)
+
+The `GoogleTagManagerAdapter` supports both GTM Container ID and GA4 Measurement ID.
+
+```tsx
+const adapter = new GoogleTagManagerAdapter({
+  containerId: 'GTM-XXXXXXX', // Loads GTM script
+  // OR
+  measurementId: 'G-XXXXXXXX', // Loads gtag.js directly
+});
+```
+
+### GTM Data Layer Events
+
+The adapter pushes events to `window.dataLayer`:
+
+- **Page View**:
+  ```json
+  {
+    "event": "page_view",
+    "page_location": "https://...",
+    "page_path": "/about",
+    "page_title": "About Us"
+  }
+  ```
+
+- **Click**:
+  ```json
+  {
+    "event": "click",
+    "componentType": "Button",
+    "linkText": "Subscribe",
+    "location": "footer"
+  }
+  ```
+
+- **Custom Event**:
+  ```json
+  {
+    "event": "custom_event_name",
+    "property": "value"
+  }
+  ```
+
+## Custom Adapters
+
+Implement the `AnalyticsAdapter` interface to support other providers.
+
+```typescript
+import type { AnalyticsAdapter, ClickTrackingProperties, PageTrackingProperties } from '@se-studio/core-ui';
+
+export class MyCustomAdapter implements AnalyticsAdapter {
+  trackEvent(event: string, properties: Record<string, unknown>) {
+    // Send to provider
+  }
+  trackPage(url: string, properties: PageTrackingProperties) {
+    // Send page view
+  }
+  trackClick(properties: ClickTrackingProperties) {
+    // Send click
+  }
+}
+```

package/CHANGELOG.md

@@ -0,0 +1,466 @@
+# @se-studio/core-ui
+
+## 1.0.47
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.47
+  - @se-studio/core-data-types@1.0.47
+
+## 1.0.46
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.46
+  - @se-studio/core-data-types@1.0.46
+
+## 1.0.45
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.45
+  - @se-studio/core-data-types@1.0.45
+
+## 1.0.44
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.44
+  - @se-studio/core-data-types@1.0.44
+
+## 1.0.43
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.43
+  - @se-studio/core-data-types@1.0.43
+
+## 1.0.42
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.42
+  - @se-studio/core-data-types@1.0.42
+
+## 1.0.41
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.41
+  - @se-studio/core-data-types@1.0.41
+
+## 1.0.40
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.40
+  - @se-studio/core-data-types@1.0.40
+
+## 1.0.39
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.39
+  - @se-studio/core-data-types@1.0.39
+
+## 1.0.38
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.38
+  - @se-studio/core-data-types@1.0.38
+
+## 1.0.37
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.37
+  - @se-studio/core-data-types@1.0.37
+
+## 1.0.36
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.36
+  - @se-studio/core-data-types@1.0.36
+
+## 1.0.35
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.35
+  - @se-studio/core-data-types@1.0.35
+
+## 1.0.34
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.34
+  - @se-studio/core-data-types@1.0.34
+
+## 1.0.33
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.33
+  - @se-studio/core-data-types@1.0.33
+
+## 1.0.32
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.32
+  - @se-studio/core-data-types@1.0.32
+
+## 1.0.31
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.31
+  - @se-studio/core-data-types@1.0.31
+
+## 1.0.30
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.30
+  - @se-studio/core-data-types@1.0.30
+
+## 1.0.29
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.29
+  - @se-studio/core-data-types@1.0.29
+
+## 1.0.28
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.28
+  - @se-studio/core-data-types@1.0.28
+
+## 1.0.27
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.27
+  - @se-studio/core-data-types@1.0.27
+
+## 1.0.26
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.26
+  - @se-studio/core-data-types@1.0.26
+
+## 1.0.25
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.25
+  - @se-studio/core-data-types@1.0.25
+
+## 1.0.24
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.24
+  - @se-studio/core-data-types@1.0.24
+
+## 1.0.23
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.23
+  - @se-studio/core-data-types@1.0.23
+
+## 1.0.22
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.22
+  - @se-studio/core-data-types@1.0.22
+
+## 1.0.21
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.21
+  - @se-studio/core-data-types@1.0.21
+
+## 1.0.20
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.20
+  - @se-studio/core-data-types@1.0.20
+
+## 1.0.19
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.19
+  - @se-studio/core-data-types@1.0.19
+
+## 1.0.18
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.18
+  - @se-studio/core-data-types@1.0.18
+
+## 1.0.17
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.17
+  - @se-studio/core-data-types@1.0.17
+
+## 1.0.16
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.16
+  - @se-studio/core-data-types@1.0.16
+
+## 1.0.15
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.15
+  - @se-studio/core-data-types@1.0.15
+
+## 1.0.14
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.14
+  - @se-studio/core-data-types@1.0.14
+
+## 1.0.13
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.13
+  - @se-studio/core-data-types@1.0.13
+
+## 1.0.12
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.12
+  - @se-studio/core-data-types@1.0.12
+
+## 1.0.11
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.11
+  - @se-studio/core-data-types@1.0.11
+
+## 1.0.10
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.10
+  - @se-studio/core-data-types@1.0.10
+
+## 1.0.9
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.9
+  - @se-studio/core-data-types@1.0.9
+
+## 1.0.8
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.8
+  - @se-studio/core-data-types@1.0.8
+
+## 1.0.7
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.7
+  - @se-studio/core-data-types@1.0.7
+
+## 1.0.6
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.6
+  - @se-studio/core-data-types@1.0.6
+
+## 1.0.5
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.5
+  - @se-studio/core-data-types@1.0.5
+
+## 1.0.4
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.4
+  - @se-studio/core-data-types@1.0.4
+
+## 1.0.3
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.3
+  - @se-studio/core-data-types@1.0.3
+
+## 1.0.2
+
+### Patch Changes
+
+- 586f4d2: Bulk version bump: patch for all packages
+- 448db28: Bulk version bump: patch for all packages
+- Bulk version bump: patch for all packages
+- Updated dependencies [586f4d2]
+- Updated dependencies [448db28]
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.2
+  - @se-studio/core-data-types@1.0.2
+
+## 1.0.1
+
+### Patch Changes
+
+- fc16426: Bulk version bump: patch for all packages
+- a2f6df8: Bulk version bump: patch for all packages
+- 344beae: Bulk version bump: patch for all packages
+- Updated dependencies [fc16426]
+- Updated dependencies [a2f6df8]
+- Updated dependencies [344beae]
+  - @se-studio/contentful-rest-api@1.0.1
+  - @se-studio/core-data-types@1.0.1
+
+## 1.0.0
+
+### Patch Changes
+
+- b3a13b9: Bulk version bump: patch for all packages
+- 86b76aa: Bulk version bump: patch for all packages
+- Updated dependencies [b3a13b9]
+- Updated dependencies [86b76aa]
+  - @se-studio/contentful-rest-api@1.0.0
+  - @se-studio/core-data-types@1.0.0
+
+## 0.0.0-alpha-20251110080939
+
+### Minor Changes
+
+- Dev updates
+
+### Patch Changes
+
+- Updated dependencies
+  - @se-studio/contentful-rest-api@0.0.0-alpha-20251110080939
+  - @se-studio/core-data-types@0.0.0-alpha-20251110080939
+
+## 0.1.1
+
+### Patch Changes
+
+- Dev update
+- Dev updates
+- Updated dependencies
+- Updated dependencies
+  - @se-studio/contentful-rest-api@0.1.1
+  - @se-studio/core-data-types@0.1.1