@se-studio/core-ui 1.0.14 → 1.0.16

package/dist/framework/componentErrors.d.ts

@@ -1,3 +1,4 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console is ok */
 interface ComponentError {
     type: 'validation' | 'parsing' | 'render' | 'data';
     message: string;
@@ -5,7 +6,14 @@ interface ComponentError {
     id?: string;
     details?: unknown;
 }
+/**
+ * Shows a component error indicator in non-production environments
+ * Returns the error element to be included in the component's render
+ */
 export declare function showComponentError(error: ComponentError, isProduction?: boolean): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Shows an inline error indicator (smaller, embedded version)
+ */
 export declare function showInlineError(error: ComponentError, isProduction?: boolean): import("react/jsx-runtime").JSX.Element | null;
 export {};
 //# sourceMappingURL=componentErrors.d.ts.map

package/dist/framework/componentErrors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"componentErrors.d.ts","sourceRoot":"","sources":["../../src/framework/componentErrors.tsx"],"names":[],"mappings":"AAIA,UAAU,cAAc;IACtB,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAOD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,EAAE,YAAY,UAAQ,kDAU7E;AAKD,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,YAAY,UAAQ,kDAU1E"}
+{"version":3,"file":"componentErrors.d.ts","sourceRoot":"","sources":["../../src/framework/componentErrors.tsx"],"names":[],"mappings":"AAAA,gEAAgE;AAIhE,UAAU,cAAc;IACtB,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AAEH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,EAAE,YAAY,UAAQ,kDAU7E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,YAAY,UAAQ,kDAU1E"}

package/dist/framework/componentErrors.js

@@ -1,17 +1,27 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+/** biome-ignore-all lint/suspicious/noConsole: Console is ok */
 import { ComponentErrorIndicator } from './ComponentErrorIndicator';
+/**
+ * Shows a component error indicator in non-production environments
+ * Returns the error element to be included in the component's render
+ */
 export function showComponentError(error, isProduction = false) {
     if (isProduction)
         return null;
+    // Also log to console for debugging
     console.error(`Component Error [${error.component || 'Unknown'}]:`, {
         ...error,
         timestamp: new Date().toISOString(),
     });
     return _jsx(ComponentErrorIndicator, { ...error, isProduction: isProduction });
 }
+/**
+ * Shows an inline error indicator (smaller, embedded version)
+ */
 export function showInlineError(error, isProduction = false) {
     if (isProduction)
         return null;
+    // Also log to console for debugging
     console.warn(`Component Warning [${error.component || 'Unknown'}]:`, {
         ...error,
         timestamp: new Date().toISOString(),

package/dist/framework/componentErrors.js.map

@@ -1 +1 @@
-{"version":3,"file":"componentErrors.js","sourceRoot":"","sources":["../../src/framework/componentErrors.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAepE,MAAM,UAAU,kBAAkB,CAAC,KAAqB,EAAE,YAAY,GAAG,KAAK;IAC5E,IAAI,YAAY;QAAE,OAAO,IAAI,CAAC;IAG9B,OAAO,CAAC,KAAK,CAAC,oBAAoB,KAAK,CAAC,SAAS,IAAI,SAAS,IAAI,EAAE;QAClE,GAAG,KAAK;QACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,CAAC;IAEH,OAAO,KAAC,uBAAuB,OAAK,KAAK,EAAE,YAAY,EAAE,YAAY,GAAI,CAAC;AAC5E,CAAC;AAKD,MAAM,UAAU,eAAe,CAAC,KAAqB,EAAE,YAAY,GAAG,KAAK;IACzE,IAAI,YAAY;QAAE,OAAO,IAAI,CAAC;IAG9B,OAAO,CAAC,IAAI,CAAC,sBAAsB,KAAK,CAAC,SAAS,IAAI,SAAS,IAAI,EAAE;QACnE,GAAG,KAAK;QACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,CAAC;IAEH,OAAO,KAAC,uBAAuB,OAAK,KAAK,EAAE,MAAM,QAAC,YAAY,EAAE,YAAY,GAAI,CAAC;AACnF,CAAC"}
+{"version":3,"file":"componentErrors.js","sourceRoot":"","sources":["../../src/framework/componentErrors.tsx"],"names":[],"mappings":";AAAA,gEAAgE;AAEhE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAUpE;;;GAGG;AAEH,MAAM,UAAU,kBAAkB,CAAC,KAAqB,EAAE,YAAY,GAAG,KAAK;IAC5E,IAAI,YAAY;QAAE,OAAO,IAAI,CAAC;IAE9B,oCAAoC;IACpC,OAAO,CAAC,KAAK,CAAC,oBAAoB,KAAK,CAAC,SAAS,IAAI,SAAS,IAAI,EAAE;QAClE,GAAG,KAAK;QACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,CAAC;IAEH,OAAO,KAAC,uBAAuB,OAAK,KAAK,EAAE,YAAY,EAAE,YAAY,GAAI,CAAC;AAC5E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAqB,EAAE,YAAY,GAAG,KAAK;IACzE,IAAI,YAAY;QAAE,OAAO,IAAI,CAAC;IAE9B,oCAAoC;IACpC,OAAO,CAAC,IAAI,CAAC,sBAAsB,KAAK,CAAC,SAAS,IAAI,SAAS,IAAI,EAAE;QACnE,GAAG,KAAK;QACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,CAAC;IAEH,OAAO,KAAC,uBAAuB,OAAK,KAAK,EAAE,MAAM,QAAC,YAAY,EAAE,YAAY,GAAI,CAAC;AACnF,CAAC"}

package/dist/hooks/useClickTracking.d.ts

@@ -1,10 +1,19 @@
 import type { IAnalyticsContext } from '@se-studio/core-data-types';
+/**
+ * Props for the useClickTracking hook.
+ */
 interface UseClickTrackingProps {
+    /** Type of component being tracked (e.g., 'Button', 'Link', 'Card') */
     componentType: string;
+    /** Optional target URL for the click */
     targetUrl?: string;
+    /** Text content of the link/button */
     linkText: string;
+    /** Location label from CMS (optional) */
     location: string | null | undefined;
+    /** Optional analytics context for enhanced tracking */
     analytics?: IAnalyticsContext;
+    /** Function to call when tracking a click */
     trackClick: (props: {
         componentType: string;
         url: string;
@@ -12,8 +21,38 @@ interface UseClickTrackingProps {
         linkText: string;
         location?: string;
     } & IAnalyticsContext) => void;
+    /** Function to get the current page URL */
     getCurrentPageUrl: () => string;
 }
+/**
+ * Hook for tracking click events with analytics.
+ *
+ * Returns a click handler function that automatically tracks clicks with
+ * component type, link text, URLs, and analytics context.
+ *
+ * @param props - Click tracking configuration
+ * @returns Click handler function to attach to onClick events
+ *
+ * @example
+ * ```tsx
+ * import { useClickTracking, useAnalytics } from '@se-studio/core-ui';
+ *
+ * function MyButton() {
+ *   const { trackClick } = useAnalytics();
+ *   const handleClick = useClickTracking({
+ *     componentType: 'Button',
+ *     targetUrl: '/signup',
+ *     linkText: 'Sign up',
+ *     location: 'hero',
+ *     analytics: { page_title: 'Home' },
+ *     trackClick,
+ *     getCurrentPageUrl: () => window.location.href,
+ *   });
+ *
+ *   return <button onClick={handleClick}>Sign up</button>;
+ * }
+ * ```
+ */
 export declare function useClickTracking({ componentType, targetUrl, linkText, location, analytics, trackClick, getCurrentPageUrl, }: UseClickTrackingProps): () => void;
 export {};
 //# sourceMappingURL=useClickTracking.d.ts.map

package/dist/hooks/useClickTracking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useClickTracking.d.ts","sourceRoot":"","sources":["../../src/hooks/useClickTracking.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,UAAU,qBAAqB;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,UAAU,EAAE,CACV,KAAK,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,iBAAiB,KAClB,IAAI,CAAC;IACV,iBAAiB,EAAE,MAAM,MAAM,CAAC;CACjC;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,aAAa,EACb,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,iBAAiB,GAClB,EAAE,qBAAqB,cAiBvB"}
+{"version":3,"file":"useClickTracking.d.ts","sourceRoot":"","sources":["../../src/hooks/useClickTracking.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE;;GAEG;AACH,UAAU,qBAAqB;IAC7B,uEAAuE;IACvE,aAAa,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,uDAAuD;IACvD,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,6CAA6C;IAC7C,UAAU,EAAE,CACV,KAAK,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,iBAAiB,KAClB,IAAI,CAAC;IACV,2CAA2C;IAC3C,iBAAiB,EAAE,MAAM,MAAM,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,aAAa,EACb,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,iBAAiB,GAClB,EAAE,qBAAqB,cAiBvB"}

package/dist/hooks/useClickTracking.js

@@ -1,5 +1,34 @@
 'use client';
 import { useCallback } from 'react';
+/**
+ * Hook for tracking click events with analytics.
+ *
+ * Returns a click handler function that automatically tracks clicks with
+ * component type, link text, URLs, and analytics context.
+ *
+ * @param props - Click tracking configuration
+ * @returns Click handler function to attach to onClick events
+ *
+ * @example
+ * ```tsx
+ * import { useClickTracking, useAnalytics } from '@se-studio/core-ui';
+ *
+ * function MyButton() {
+ *   const { trackClick } = useAnalytics();
+ *   const handleClick = useClickTracking({
+ *     componentType: 'Button',
+ *     targetUrl: '/signup',
+ *     linkText: 'Sign up',
+ *     location: 'hero',
+ *     analytics: { page_title: 'Home' },
+ *     trackClick,
+ *     getCurrentPageUrl: () => window.location.href,
+ *   });
+ *
+ *   return <button onClick={handleClick}>Sign up</button>;
+ * }
+ * ```
+ */
 export function useClickTracking({ componentType, targetUrl, linkText, location, analytics, trackClick, getCurrentPageUrl, }) {
     const handleClick = useCallback(() => {
         const url = getCurrentPageUrl();

package/dist/hooks/useClickTracking.js.map

@@ -1 +1 @@
-{"version":3,"file":"useClickTracking.js","sourceRoot":"","sources":["../../src/hooks/useClickTracking.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAoBpC,MAAM,UAAU,gBAAgB,CAAC,EAC/B,aAAa,EACb,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,iBAAiB,GACK;IACtB,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE;QACnC,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;QAEhC,IAAI,SAAS,EAAE,CAAC;YACd,UAAU,CAAC;gBACT,aAAa;gBACb,GAAG,SAAS;gBACZ,GAAG;gBACH,SAAS;gBACT,QAAQ;gBACR,QAAQ,EAAE,QAAQ,IAAI,SAAS;aAChC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,EAAE,CAAC,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAE7F,OAAO,WAAW,CAAC;AACrB,CAAC"}
+{"version":3,"file":"useClickTracking.js","sourceRoot":"","sources":["../../src/hooks/useClickTracking.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AA8BpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,aAAa,EACb,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,iBAAiB,GACK;IACtB,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE;QACnC,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;QAEhC,IAAI,SAAS,EAAE,CAAC;YACd,UAAU,CAAC;gBACT,aAAa;gBACb,GAAG,SAAS;gBACZ,GAAG;gBACH,SAAS;gBACT,QAAQ;gBACR,QAAQ,EAAE,QAAQ,IAAI,SAAS;aAChC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,EAAE,CAAC,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAE7F,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,38 @@
+/**
+ * @se-studio/core-ui
+ *
+ * Shared React UI component library with Tailwind CSS v4 and CMS infrastructure
+ * for SE Studio applications.
+ *
+ * This package provides:
+ * - CMS content rendering system with type-safe component mapping
+ * - React components for images, videos, animations, and rich text
+ * - Analytics integration hooks and providers
+ * - Utility functions for page metadata, error handling, and content extraction
+ * - Type-safe configuration system for CMS renderers
+ *
+ * @example Basic usage
+ * ```tsx
+ * import { CmsContent, Visual } from '@se-studio/core-ui';
+ * import { contentfulPageRest } from '@se-studio/contentful-rest-api';
+ *
+ * const page = await contentfulPageRest(config, 'home');
+ *
+ * export default function Page() {
+ *   return <CmsContent content={page} config={rendererConfig} />;
+ * }
+ * ```
+ *
+ * @example Using Visual component
+ * ```tsx
+ * import { Visual } from '@se-studio/core-ui';
+ * import type { IVisual } from '@se-studio/core-data-types';
+ *
+ * <Visual visual={visualData} className="w-full" priority />
+ * ```
+ *
+ * @packageDocumentation
+ */
 export { AnalyticsProvider, useAnalyticsContext } from './analytics/AnalyticsProvider';
 export { ConsoleAnalyticsAdapter } from './analytics/adapters';
 export type { AnalyticsAdapter, ClickTrackingProperties, PageTrackingProperties, } from './analytics/types';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,4 +1,42 @@
+/**
+ * @se-studio/core-ui
+ *
+ * Shared React UI component library with Tailwind CSS v4 and CMS infrastructure
+ * for SE Studio applications.
+ *
+ * This package provides:
+ * - CMS content rendering system with type-safe component mapping
+ * - React components for images, videos, animations, and rich text
+ * - Analytics integration hooks and providers
+ * - Utility functions for page metadata, error handling, and content extraction
+ * - Type-safe configuration system for CMS renderers
+ *
+ * @example Basic usage
+ * ```tsx
+ * import { CmsContent, Visual } from '@se-studio/core-ui';
+ * import { contentfulPageRest } from '@se-studio/contentful-rest-api';
+ *
+ * const page = await contentfulPageRest(config, 'home');
+ *
+ * export default function Page() {
+ *   return <CmsContent content={page} config={rendererConfig} />;
+ * }
+ * ```
+ *
+ * @example Using Visual component
+ * ```tsx
+ * import { Visual } from '@se-studio/core-ui';
+ * import type { IVisual } from '@se-studio/core-data-types';
+ *
+ * <Visual visual={visualData} className="w-full" priority />
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Component and Collection Mapping Infrastructure
+// Analytics
 export { AnalyticsProvider, useAnalyticsContext } from './analytics/AnalyticsProvider';
+// Analytics Adapters
 export { ConsoleAnalyticsAdapter } from './analytics/adapters';
 export { useAnalytics } from './analytics/useAnalytics';
 export { ClientMonitor } from './components/ClientMonitor.js';
@@ -8,24 +46,30 @@ export { CmsContent } from './components/CmsContent';
 export { CmsConversionErrors } from './components/CmsConversionErrors';
 export { CmsEmbeddedContent } from './components/CmsEmbeddedContent';
 export { Preview } from './components/Preview.js';
+// Visual Components
 export { calculateCropDetails, calculateImagePriority, calculateImageWidthStyleVariable, } from './components/Visual';
 export { Visual } from './components/VisualComponent';
 export { RtfOrString } from './elements/RtfOrString';
 export { TrackedLink } from './elements/TrackedLink';
+// Elements
 export { UtmLink } from './elements/UtmLink';
 export { BackgroundMedia } from './framework/BackgroundMedia';
+// Framework Components
 export { ComponentErrorIndicator } from './framework/ComponentErrorIndicator';
 export { showComponentError, showInlineError } from './framework/componentErrors';
 export { default as ResponsiveVisual } from './framework/ResponsiveVisual';
+// Shared Hooks
 export { useClickTracking } from './hooks/useClickTracking';
 export { RTF } from './rtf/rtf';
 export { buildPageMetadata } from './utils/buildPageMetadata';
+// Shared Utilities
 export { cn } from './utils/cn';
 export { createCollectionProps, createComponentProps, extractCollectionInfo, extractComponentInfo, extractPageContext, } from './utils/componentUtils';
 export { convertText } from './utils/convertText';
 export { handleCmsError } from './utils/errorHandling';
 export { getPreviewAssetIdProps, getPreviewFieldIdProps, getPreviewParentProps, getPreviewProps, } from './utils/previewUtils';
 export { UnsupportedWarning } from './utils/UnsupportedWarning';
+// Development Utilities
 export { DEFAULT_ALLOWED_UNUSED, UnusedChecker } from './utils/UnusedChecker';
 export { isAbsoluteUrl } from './utils/urlUtils';
 export { calculateHorizontalPositionClassName } from './utils/visualPositions';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAM/D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAS9D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAQ3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAKzD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAQrE,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGlD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,gCAAgC,GACjC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAE3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AAYhC,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,oCAAoC,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,kDAAkD;AAElD,YAAY;AACZ,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACvF,qBAAqB;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAM/D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAS9D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAQ3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAKzD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAQrE,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,oBAAoB;AACpB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,gCAAgC,GACjC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,WAAW;AACX,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,uBAAuB;AACvB,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAC3E,eAAe;AACf,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,mBAAmB;AACnB,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AAYhC,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,wBAAwB;AACxB,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,oCAAoC,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/rtf/rtf.d.ts

@@ -2,11 +2,52 @@ import { type Document } from '@contentful/rich-text-types';
 import type { IContentContext } from '@se-studio/core-data-types';
 import type { HTMLAttributes } from 'react';
 import type { CmsRendererConfig } from '../CmsRendererConfig';
+/**
+ * Props for the RTF (Rich Text Field) component.
+ */
 export type RTFProps = {
+    /** Contentful rich text document to render */
     content: Document;
+    /** Optional CMS renderer configuration for embedded content */
     rendererConfig?: CmsRendererConfig;
+    /** Optional content context for embedded components */
     contentContext?: IContentContext;
+    /** Optional CSS class for positioning embedded content */
     embeddedPositionClassName?: string;
 } & Omit<HTMLAttributes<HTMLElement>, 'content'>;
+/**
+ * Renders Contentful rich text fields with support for embedded entries and assets.
+ *
+ * This component handles:
+ * - Standard rich text formatting (headings, paragraphs, lists, etc.)
+ * - Embedded entries (components, collections) via renderer config
+ * - Embedded assets (images, videos) via visual component renderer
+ * - Hyperlinks (internal and external)
+ * - Entry hyperlinks (links to CMS entries)
+ *
+ * @param content - Contentful rich text document
+ * @param rendererConfig - Optional CMS renderer configuration for embedded content
+ * @param contentContext - Optional content context for embedded components
+ * @param embeddedPositionClassName - Optional CSS class for positioning embedded content
+ * @param className - Additional CSS classes
+ * @param style - Additional inline styles
+ *
+ * @example Basic usage
+ * ```tsx
+ * import { RTF } from '@se-studio/core-ui';
+ *
+ * <RTF content={richTextField} />
+ * ```
+ *
+ * @example With embedded content
+ * ```tsx
+ * <RTF
+ *   content={richTextField}
+ *   rendererConfig={rendererConfig}
+ *   contentContext={contentContext}
+ *   embeddedPositionClassName="w-full col-span-full"
+ * />
+ * ```
+ */
 export declare function RTF({ content, className, style, rendererConfig, contentContext, embeddedPositionClassName, ...other }: RTFProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=rtf.d.ts.map

package/dist/rtf/rtf.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rtf.d.ts","sourceRoot":"","sources":["../../src/rtf/rtf.tsx"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,QAAQ,EAGd,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAW,MAAM,4BAA4B,CAAC;AAE3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AA6F9D,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,QAAQ,CAAC;IAClB,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,CAAC;AAEjD,wBAAgB,GAAG,CAAC,EAClB,OAAO,EACP,SAAS,EACT,KAAK,EACL,cAAc,EACd,cAAc,EACd,yBAAyB,EACzB,GAAG,KAAK,EACT,EAAE,QAAQ,2CAOV"}
+{"version":3,"file":"rtf.d.ts","sourceRoot":"","sources":["../../src/rtf/rtf.tsx"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,QAAQ,EAGd,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAW,MAAM,4BAA4B,CAAC;AAE3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AA6F9D;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,8CAA8C;IAC9C,OAAO,EAAE,QAAQ,CAAC;IAClB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,uDAAuD;IACvD,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,0DAA0D;IAC1D,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,GAAG,CAAC,EAClB,OAAO,EACP,SAAS,EACT,KAAK,EACL,cAAc,EACd,cAAc,EACd,yBAAyB,EACzB,GAAG,KAAK,EACT,EAAE,QAAQ,2CAOV"}

package/dist/rtf/rtf.js

@@ -8,6 +8,7 @@ function createComplexLinksRenderer(rendererConfig, contentContext, embeddedPosi
     if (!rendererConfig || !contentContext) {
         return {};
     }
+    // Track the position of embedded entries within this RTF document
     let embeddedEntryCounter = 0;
     return {
         [INLINES.EMBEDDED_ENTRY]: (node) => {
@@ -36,6 +37,7 @@ function createComplexLinksRenderer(rendererConfig, contentContext, embeddedPosi
         [BLOCKS.EMBEDDED_ENTRY]: (node) => {
             const target = node.data.target;
             if (target) {
+                // Capture the current index before incrementing for the next embedded entry
                 const currentIndex = embeddedEntryCounter++;
                 return (_jsx(CmsEmbeddedContent, { information: target, contentContext: contentContext, rendererConfig: rendererConfig, positionClassName: embeddedPositionClassName ?? 'w-full col-span-full', parentIndex: 0, embeddedIndex: currentIndex }));
             }
@@ -59,6 +61,40 @@ function buildOptions(rendererConfig, contentContext, embeddedPositionClassName)
         },
     };
 }
+/**
+ * Renders Contentful rich text fields with support for embedded entries and assets.
+ *
+ * This component handles:
+ * - Standard rich text formatting (headings, paragraphs, lists, etc.)
+ * - Embedded entries (components, collections) via renderer config
+ * - Embedded assets (images, videos) via visual component renderer
+ * - Hyperlinks (internal and external)
+ * - Entry hyperlinks (links to CMS entries)
+ *
+ * @param content - Contentful rich text document
+ * @param rendererConfig - Optional CMS renderer configuration for embedded content
+ * @param contentContext - Optional content context for embedded components
+ * @param embeddedPositionClassName - Optional CSS class for positioning embedded content
+ * @param className - Additional CSS classes
+ * @param style - Additional inline styles
+ *
+ * @example Basic usage
+ * ```tsx
+ * import { RTF } from '@se-studio/core-ui';
+ *
+ * <RTF content={richTextField} />
+ * ```
+ *
+ * @example With embedded content
+ * ```tsx
+ * <RTF
+ *   content={richTextField}
+ *   rendererConfig={rendererConfig}
+ *   contentContext={contentContext}
+ *   embeddedPositionClassName="w-full col-span-full"
+ * />
+ * ```
+ */
 export function RTF({ content, className, style, rendererConfig, contentContext, embeddedPositionClassName, ...other }) {
     const options = buildOptions(rendererConfig, contentContext, embeddedPositionClassName);
     return (_jsx("div", { className: className, style: style, ...other, children: documentToReactComponents(content, options) }));

package/dist/rtf/rtf.js.map

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

package/dist/utils/UnsupportedWarning.d.ts

@@ -1,4 +1,27 @@
 import type { CSSProperties, PropsWithChildren } from 'react';
+/**
+ * Development utility component that displays a warning message for unsupported features or configurations.
+ *
+ * This helps identify areas where content or features are not yet supported,
+ * making it easier to spot missing functionality during development.
+ *
+ * Only shows warnings in development mode (NODE_ENV !== 'production').
+ *
+ * @example
+ * ```tsx
+ * const MyComponent = ({ data }) => {
+ *   if (data.type === 'unsupported') {
+ *     return (
+ *       <UnsupportedWarning className="my-warning">
+ *         This content type is not yet supported
+ *       </UnsupportedWarning>
+ *     );
+ *   }
+ *
+ *   return <div>{data.content}</div>;
+ * };
+ * ```
+ */
 export declare const UnsupportedWarning: React.FC<PropsWithChildren<{
     className?: string;
     style?: CSSProperties;

package/dist/utils/UnsupportedWarning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UnsupportedWarning.d.ts","sourceRoot":"","sources":["../../src/utils/UnsupportedWarning.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAyB9D,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CACvC,iBAAiB,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC,CA0BH,CAAC"}
+{"version":3,"file":"UnsupportedWarning.d.ts","sourceRoot":"","sources":["../../src/utils/UnsupportedWarning.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CACvC,iBAAiB,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC,CA0BH,CAAC"}

package/dist/utils/UnsupportedWarning.js

@@ -1,5 +1,29 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Development utility component that displays a warning message for unsupported features or configurations.
+ *
+ * This helps identify areas where content or features are not yet supported,
+ * making it easier to spot missing functionality during development.
+ *
+ * Only shows warnings in development mode (NODE_ENV !== 'production').
+ *
+ * @example
+ * ```tsx
+ * const MyComponent = ({ data }) => {
+ *   if (data.type === 'unsupported') {
+ *     return (
+ *       <UnsupportedWarning className="my-warning">
+ *         This content type is not yet supported
+ *       </UnsupportedWarning>
+ *     );
+ *   }
+ *
+ *   return <div>{data.content}</div>;
+ * };
+ * ```
+ */
 export const UnsupportedWarning = ({ children, className, style, showWarnings = true }) => {
+    // Only show in development mode
     if ((typeof process !== 'undefined' && process.env?.NODE_ENV === 'production') || !showWarnings) {
         return null;
     }

package/dist/utils/UnsupportedWarning.js.map

@@ -1 +1 @@
-{"version":3,"file":"UnsupportedWarning.js","sourceRoot":"","sources":["../../src/utils/UnsupportedWarning.tsx"],"names":[],"mappings":";AAyBA,MAAM,CAAC,MAAM,kBAAkB,GAM3B,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,EAAE,EAAE,EAAE;IAE1D,IAAI,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,QAAQ,KAAK,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QAChG,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAkB;QAClC,eAAe,EAAE,SAAS;QAC1B,MAAM,EAAE,mBAAmB;QAC3B,YAAY,EAAE,KAAK;QACnB,OAAO,EAAE,cAAc;QACvB,MAAM,EAAE,UAAU;QAClB,KAAK,EAAE,SAAS;QAChB,UAAU,EAAE,MAAM;QAClB,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,cAAc;KACxB,CAAC;IAEF,MAAM,WAAW,GAAG,EAAE,GAAG,YAAY,EAAE,GAAG,KAAK,EAAE,CAAC;IAElD,OAAO,CACL,cAAK,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,YAC1C,QAAQ,GACL,CACP,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"UnsupportedWarning.js","sourceRoot":"","sources":["../../src/utils/UnsupportedWarning.tsx"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAM3B,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,EAAE,EAAE,EAAE;IAC1D,gCAAgC;IAChC,IAAI,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,QAAQ,KAAK,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QAChG,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAkB;QAClC,eAAe,EAAE,SAAS;QAC1B,MAAM,EAAE,mBAAmB;QAC3B,YAAY,EAAE,KAAK;QACnB,OAAO,EAAE,cAAc;QACvB,MAAM,EAAE,UAAU;QAClB,KAAK,EAAE,SAAS;QAChB,UAAU,EAAE,MAAM;QAClB,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,cAAc;KACxB,CAAC;IAEF,MAAM,WAAW,GAAG,EAAE,GAAG,YAAY,EAAE,GAAG,KAAK,EAAE,CAAC;IAElD,OAAO,CACL,cAAK,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,YAC1C,QAAQ,GACL,CACP,CAAC;AACJ,CAAC,CAAC"}

package/dist/utils/UnusedChecker.d.ts

@@ -1,6 +1,42 @@
 import type { PropsWithChildren } from 'react';
+/**
+ * Set of property names that are commonly unused and should not trigger warnings.
+ * Projects can extend this list by wrapping UnusedChecker or using their own implementation.
+ */
 declare const DEFAULT_ALLOWED_UNUSED: Set<string>;
 type FieldsType = Record<string, unknown>;
+/**
+ * Development utility component that warns about unused component/collection properties.
+ *
+ * This helps catch cases where CMS content includes fields that aren't being rendered,
+ * which could indicate missing functionality or unnecessary data fetching.
+ *
+ * Only shows warnings in development mode (NODE_ENV !== 'production').
+ *
+ * @example
+ * ```tsx
+ * const USED_FIELDS = new Set(['heading', 'body', 'visual']);
+ *
+ * const MyComponent = ({ information }) => {
+ *   const { componentType, ...allFields } = information;
+ *
+ *   return (
+ *     <UnusedChecker
+ *       componentName="MyComponent"
+ *       allFields={allFields}
+ *       usedFields={USED_FIELDS}
+ *       additionalAllowedUnused={new Set(['customField'])}
+ *       showWarnings={true}
+ *     >
+ *       <div>
+ *         <h2>{information.heading}</h2>
+ *         <p>{information.body}</p>
+ *       </div>
+ *     </UnusedChecker>
+ *   );
+ * };
+ * ```
+ */
 export declare const UnusedChecker: React.FC<PropsWithChildren<{
     componentName: string;
     allFields: FieldsType;
@@ -8,5 +44,8 @@ export declare const UnusedChecker: React.FC<PropsWithChildren<{
     additionalAllowedUnused?: Set<string>;
     showWarnings?: boolean;
 }>>;
+/**
+ * Export the default allowed unused set so projects can extend it
+ */
 export { DEFAULT_ALLOWED_UNUSED };
 //# sourceMappingURL=UnusedChecker.d.ts.map

package/dist/utils/UnusedChecker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UnusedChecker.d.ts","sourceRoot":"","sources":["../../src/utils/UnusedChecker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAM/C,QAAA,MAAM,sBAAsB,aAmB1B,CAAC;AAEH,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAuD1C,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAClC,iBAAiB,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,UAAU,CAAC;IACtB,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,uBAAuB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC,CA6CH,CAAC;AAKF,OAAO,EAAE,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"UnusedChecker.d.ts","sourceRoot":"","sources":["../../src/utils/UnusedChecker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAE/C;;;GAGG;AACH,QAAA,MAAM,sBAAsB,aAmB1B,CAAC;AAEH,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAuB1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAClC,iBAAiB,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,UAAU,CAAC;IACtB,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,uBAAuB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC,CA6CH,CAAC;AAEF;;GAEG;AACH,OAAO,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/utils/UnusedChecker.js

@@ -1,4 +1,8 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Set of property names that are commonly unused and should not trigger warnings.
+ * Projects can extend this list by wrapping UnusedChecker or using their own implementation.
+ */
 const DEFAULT_ALLOWED_UNUSED = new Set([
     'componentType',
     'CollectionType',
@@ -19,18 +23,55 @@ const DEFAULT_ALLOWED_UNUSED = new Set([
     'backgroundVisual',
     'backgroundOverlayOpacity',
 ]);
+/**
+ * Get fields that have values but are not in the allowed sets or used fields
+ */
 function getUnusedFields(allFields, usedFields, additionalAllowedUnused) {
+    // Combine default allowed unused with any additional project-specific ones
     const allowedUnused = new Set([...DEFAULT_ALLOWED_UNUSED, ...(additionalAllowedUnused || [])]);
     const fieldsWithValues = Object.entries(allFields)
-        .filter(([name]) => !allowedUnused.has(name))
-        .filter(([name]) => !usedFields?.has(name))
-        .filter(([, value]) => typeof value !== 'undefined' && value !== null)
+        .filter(([name]) => !allowedUnused.has(name)) // Not in allowed unused sets
+        .filter(([name]) => !usedFields?.has(name)) // Not in used fields
+        .filter(([, value]) => typeof value !== 'undefined' && value !== null) // Has actual value
         .map(([name]) => name);
     if (fieldsWithValues.length > 0)
         return fieldsWithValues;
     return undefined;
 }
+/**
+ * Development utility component that warns about unused component/collection properties.
+ *
+ * This helps catch cases where CMS content includes fields that aren't being rendered,
+ * which could indicate missing functionality or unnecessary data fetching.
+ *
+ * Only shows warnings in development mode (NODE_ENV !== 'production').
+ *
+ * @example
+ * ```tsx
+ * const USED_FIELDS = new Set(['heading', 'body', 'visual']);
+ *
+ * const MyComponent = ({ information }) => {
+ *   const { componentType, ...allFields } = information;
+ *
+ *   return (
+ *     <UnusedChecker
+ *       componentName="MyComponent"
+ *       allFields={allFields}
+ *       usedFields={USED_FIELDS}
+ *       additionalAllowedUnused={new Set(['customField'])}
+ *       showWarnings={true}
+ *     >
+ *       <div>
+ *         <h2>{information.heading}</h2>
+ *         <p>{information.body}</p>
+ *       </div>
+ *     </UnusedChecker>
+ *   );
+ * };
+ * ```
+ */
 export const UnusedChecker = ({ children, componentName, allFields, usedFields, additionalAllowedUnused, showWarnings = true, }) => {
+    // Only check in development mode
     if ((typeof process !== 'undefined' && process.env?.NODE_ENV === 'production') || !showWarnings) {
         return _jsx(_Fragment, { children: children });
     }
@@ -48,5 +89,8 @@ export const UnusedChecker = ({ children, componentName, allFields, usedFields,
     }
     return _jsx(_Fragment, { children: children });
 };
+/**
+ * Export the default allowed unused set so projects can extend it
+ */
 export { DEFAULT_ALLOWED_UNUSED };
 //# sourceMappingURL=UnusedChecker.js.map