@se-studio/core-ui 1.14.7 → 1.14.8

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @se-studio/core-ui
 
+## 1.14.8
+
+### Patch Changes
+
+- Share a singleton Analytics React context across duplicate package instances and fall back to a no-op adapter instead of throwing, so client hydration no longer white-screens when core-ui is bundled more than once.
+
 ## 1.14.7
 
 ### Patch Changes

package/dist/analytics/AnalyticsProvider.d.ts

@@ -1,16 +1,17 @@
-import type React from 'react';
+import type { ReactNode } from 'react';
 import type { AnalyticsAdapter } from './types';
 interface AnalyticsProviderProps {
     adapter: AnalyticsAdapter;
-    children: React.ReactNode;
+    children: ReactNode;
 }
 /**
  * Provider component that makes analytics adapter available to child components
  */
-export declare function AnalyticsProvider({ adapter, children }: AnalyticsProviderProps): React.JSX.Element;
+export declare function AnalyticsProvider({ adapter, children }: AnalyticsProviderProps): import("react").JSX.Element;
 /**
- * Hook to access the analytics adapter from context
- * @throws Error if used outside of AnalyticsProvider
+ * 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 {};

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

@@ -1 +1 @@
-{"version":3,"file":"AnalyticsProvider.d.ts","sourceRoot":"","sources":["../../src/analytics/AnalyticsProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAWhD,UAAU,sBAAsB;IAC9B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,sBAAsB,qBAE9E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAYtD"}
+{"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

@@ -1,9 +1,24 @@
 'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useContext } from 'react';
-const AnalyticsContext = createContext(null);
-/** Silent adapter for SSR when provider context is not in the same bundle (e.g. static / prerender). */
-const SSR_ANALYTICS_FALLBACK = {
+/** 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() { },
@@ -15,20 +30,19 @@ export function AnalyticsProvider({ adapter, children }) {
     return _jsx(AnalyticsContext.Provider, { value: adapter, children: children });
 }
 /**
- * Hook to access the analytics adapter from context
- * @throws Error if used outside of AnalyticsProvider
+ * 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;
     }
-    // App Router can prerender client components (e.g. TrackedLink on /) in a server
-    // chunk separate from the layout AnalyticsProvider client bundle. Avoid failing the build;
-    // the hydrated client render uses the real provider.
-    if (typeof window === 'undefined') {
-        return SSR_ANALYTICS_FALLBACK;
+    // 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.');
     }
-    throw new Error('useAnalyticsContext must be used within an AnalyticsProvider');
+    return NOOP_ANALYTICS_FALLBACK;
 }
 //# sourceMappingURL=AnalyticsProvider.js.map

package/dist/analytics/AnalyticsProvider.js.map

@@ -1 +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,MAAM,gBAAgB,GAAG,aAAa,CAA0B,IAAI,CAAC,CAAC;AAEtE,wGAAwG;AACxG,MAAM,sBAAsB,GAAqB;IAC/C,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;;;GAGG;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,iFAAiF;IACjF,2FAA2F;IAC3F,qDAAqD;IACrD,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,sBAAsB,CAAC;IAChC,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;AAClF,CAAC"}
+{"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/useAnalytics.d.ts

@@ -2,16 +2,14 @@ import type { IAnalyticsContext, ILinkTrackingInfo } from '@se-studio/core-data-
 /**
  * Hook for accessing analytics functions.
  *
- * Provides a clean API for tracking events, pages, and clicks. Must be used
- * within an AnalyticsProvider context.
+ * Provides a clean API for tracking events, pages, and clicks. Prefer using
+ * inside an `AnalyticsProvider`; without one, calls are silent no-ops.
  *
  * @returns Object with tracking functions:
  * - `trackEvent` - Track custom events
  * - `trackPage` - Track page views
  * - `trackClick` - Track click interactions
  *
- * @throws {Error} If used outside of AnalyticsProvider
- *
  * @example Basic usage
  * ```tsx
  * import { useAnalytics } from '@se-studio/core-ui';

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,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAKvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,YAAY;wBAGhB,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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,YAAY;wBAGhB,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

@@ -4,16 +4,14 @@ import { useAnalyticsContext } from './AnalyticsProvider';
 /**
  * Hook for accessing analytics functions.
  *
- * Provides a clean API for tracking events, pages, and clicks. Must be used
- * within an AnalyticsProvider context.
+ * Provides a clean API for tracking events, pages, and clicks. Prefer using
+ * inside an `AnalyticsProvider`; without one, calls are silent no-ops.
  *
  * @returns Object with tracking functions:
  * - `trackEvent` - Track custom events
  * - `trackPage` - Track page views
  * - `trackClick` - Track click interactions
  *
- * @throws {Error} If used outside of AnalyticsProvider
- *
  * @example Basic usage
  * ```tsx
  * import { useAnalytics } from '@se-studio/core-ui';

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;IACtC,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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IACtC,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/core-ui",
-  "version": "1.14.7",
+  "version": "1.14.8",
   "description": "Shared React UI component library with Tailwind CSS v4 for SE Studio applications",
   "repository": {
     "type": "git",
@@ -64,7 +64,7 @@
     }
   },
   "dependencies": {
-    "@contentful/live-preview": "^4.10.10",
+    "@contentful/live-preview": "^4.10.12",
     "@contentful/rich-text-react-renderer": "^16.2.1",
     "@contentful/rich-text-types": "^17.2.7",
     "@radix-ui/react-slot": "^1.3.0",
@@ -79,14 +79,14 @@
     "@se-studio/core-data-types": "1.6.1"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.5.2",
-    "@types/node": "^24.13.2",
+    "@biomejs/biome": "^2.5.5",
+    "@types/node": "^24.13.3",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "jsdom": "^29.1.1",
-    "next": "^15.5.20",
+    "next": "^15.5.21",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.9"
+    "vitest": "^4.1.10"
   },
   "scripts": {
     "build": "tsc --project tsconfig.build.json",