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

package/dist/components/ClientMonitor.js

@@ -0,0 +1,368 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { usePathname } from 'next/navigation';
+import Script from 'next/script';
+import { useEffect } from 'react';
+import { useDocumentVisible } from '../hooks/useDocumentVisible';
+import { findAllVideos } from './clientMonitorVideos';
+const _observers = new Map();
+// Maps to store element metadata for scroll progress calculation
+const _sectionHeights = new Map();
+const _sectionThresholds = new Map();
+// Dense thresholds for IntersectionObserver (0, 0.05, 0.1, ... 1.0)
+const SECTION_THRESHOLDS = Array.from({ length: 21 }, (_, i) => i * 0.05);
+// Tracking for tall elements that need scroll listener
+const _intersectingTallElements = new Set();
+let _scrollRAFId = null;
+let _scrollListenerAttached = false;
+const isDevelopment = process.env.NODE_ENV === 'development';
+// Module-level debug flag, set by ClientMonitor component
+let _debugEnabled = false;
+function shouldDebug(element) {
+    if (!isDevelopment)
+        return false;
+    if (_debugEnabled)
+        return true;
+    if (element?.hasAttribute('data-debug'))
+        return true;
+    return false;
+}
+// Updates scroll progress for a single element (used by scroll handler)
+function updateScrollProgress(element) {
+    const elementHeight = _sectionHeights.get(element);
+    const threshold = _sectionThresholds.get(element);
+    if (elementHeight === undefined || threshold === undefined)
+        return;
+    const rect = element.getBoundingClientRect();
+    const scrollProgress = (window.innerHeight - rect.top) / elementHeight;
+    const shouldTrigger = scrollProgress >= threshold;
+    element.dataset.visible = shouldTrigger ? 'true' : 'false';
+    if (shouldTrigger && !element.dataset.seen) {
+        element.dataset.seen = 'true';
+    }
+    if (shouldDebug(element)) {
+        element.dataset.debugScrollProgress = scrollProgress.toFixed(3);
+        element.dataset.debugElementHeight = elementHeight.toFixed(1);
+        element.dataset.debugThreshold = threshold.toFixed(3);
+        element.dataset.debugScrollY = window.scrollY.toFixed(1);
+        element.dataset.debugViewportHeight = window.innerHeight.toFixed(1);
+        element.dataset.debugShouldTrigger = shouldTrigger ? 'true' : 'false';
+        element.dataset.debugIsTallElement = 'true';
+    }
+}
+// RAF-throttled scroll handler for tall elements
+function handleScroll() {
+    if (_scrollRAFId !== null)
+        return;
+    _scrollRAFId = requestAnimationFrame(() => {
+        _scrollRAFId = null;
+        for (const element of _intersectingTallElements) {
+            updateScrollProgress(element);
+        }
+    });
+}
+// Attach scroll listener if not already attached
+function attachScrollListener() {
+    if (!_scrollListenerAttached) {
+        window.addEventListener('scroll', handleScroll, { passive: true });
+        _scrollListenerAttached = true;
+        if (shouldDebug()) {
+            console.log('[ClientMonitor] Scroll listener attached for tall elements');
+        }
+    }
+}
+// Detach scroll listener if no tall elements are being tracked
+function detachScrollListener() {
+    if (_scrollListenerAttached && _intersectingTallElements.size === 0) {
+        window.removeEventListener('scroll', handleScroll);
+        _scrollListenerAttached = false;
+        if (_scrollRAFId !== null) {
+            cancelAnimationFrame(_scrollRAFId);
+            _scrollRAFId = null;
+        }
+        if (shouldDebug()) {
+            console.log('[ClientMonitor] Scroll listener detached');
+        }
+    }
+}
+function roundThreshold(threshold) {
+    return Math.round(threshold * 10) / 10;
+}
+function getElementThreshold(element, defaultThreshold) {
+    const attrValue = element.getAttribute('data-intersection-threshold');
+    if (attrValue) {
+        const parsed = Number.parseFloat(attrValue);
+        if (!Number.isNaN(parsed) && parsed >= 0 && parsed <= 1) {
+            return roundThreshold(parsed);
+        }
+    }
+    return roundThreshold(defaultThreshold);
+}
+function handleAnimation(animation, isIntersecting) {
+    const currentState = animation.currentState;
+    // console.log('current state', currentState)
+    if (!isIntersecting) {
+        if (currentState === 'playing') {
+            animation.pause();
+        }
+    }
+    else {
+        if (currentState === 'paused') {
+            // console.log('play animation')
+            animation.play();
+        }
+        if (!currentState || currentState === 'loading') {
+            // console.log('set to autoplay')
+            if (animation.play) {
+                animation.play();
+            }
+            animation.autoplay = true;
+        }
+    }
+}
+function handleAnimatedSection(section, isIntersecting, entry) {
+    const elementHeight = _sectionHeights.get(section);
+    const threshold = _sectionThresholds.get(section);
+    if (elementHeight === undefined || threshold === undefined) {
+        // Fallback to intersection-based behavior if height/threshold not available
+        section.dataset.visible = isIntersecting ? 'true' : 'false';
+        if (isIntersecting && !section.dataset.seen) {
+            section.dataset.seen = 'true';
+        }
+        if (shouldDebug(section)) {
+            section.dataset.debugIntersectionRatio = entry.intersectionRatio.toFixed(3);
+            section.dataset.debugBoundingTop = entry.boundingClientRect.top.toFixed(1);
+            section.dataset.debugScrollY = window.scrollY.toFixed(1);
+            section.dataset.debugViewportHeight = window.innerHeight.toFixed(1);
+            section.dataset.debugShouldTrigger = isIntersecting ? 'true' : 'false';
+            delete section.dataset.debugScrollProgress;
+            delete section.dataset.debugElementHeight;
+            delete section.dataset.debugThreshold;
+        }
+        return;
+    }
+    const isTallElement = elementHeight > window.innerHeight;
+    // For tall elements, use scroll listener for continuous tracking
+    if (isTallElement) {
+        if (isIntersecting) {
+            _intersectingTallElements.add(section);
+            attachScrollListener();
+            // Immediately update scroll progress
+            updateScrollProgress(section);
+        }
+        else {
+            _intersectingTallElements.delete(section);
+            detachScrollListener();
+            // Mark as not visible when leaving viewport
+            section.dataset.visible = 'false';
+        }
+        if (shouldDebug(section)) {
+            section.dataset.debugIntersectionRatio = entry.intersectionRatio.toFixed(3);
+            section.dataset.debugBoundingTop = entry.boundingClientRect.top.toFixed(1);
+            section.dataset.debugIsTallElement = 'true';
+        }
+        return;
+    }
+    // For normal-sized elements, IntersectionObserver provides enough granularity
+    const scrollProgress = (window.innerHeight - entry.boundingClientRect.top) / elementHeight;
+    const shouldTrigger = scrollProgress >= threshold;
+    section.dataset.visible = shouldTrigger ? 'true' : 'false';
+    if (shouldTrigger && !section.dataset.seen) {
+        section.dataset.seen = 'true';
+    }
+    if (shouldDebug(section)) {
+        section.dataset.debugIntersectionRatio = entry.intersectionRatio.toFixed(3);
+        section.dataset.debugBoundingTop = entry.boundingClientRect.top.toFixed(1);
+        section.dataset.debugScrollProgress = scrollProgress.toFixed(3);
+        section.dataset.debugElementHeight = elementHeight.toFixed(1);
+        section.dataset.debugThreshold = threshold.toFixed(3);
+        section.dataset.debugScrollY = window.scrollY.toFixed(1);
+        section.dataset.debugViewportHeight = window.innerHeight.toFixed(1);
+        section.dataset.debugShouldTrigger = shouldTrigger ? 'true' : 'false';
+        section.dataset.debugIsTallElement = 'false';
+    }
+}
+function intersectionHandler(entries) {
+    for (const entry of entries) {
+        // console.log("target", entry.target.localName, entry.target);
+        const target = entry.target;
+        switch (target.localName) {
+            case 'lottie-player':
+                // Legacy JSON Lottie only. DotLottie (`.lottie`) owns play/pause in
+                // DotLottieAnimationComponent — do not observe canvas players here.
+                handleAnimation(target, entry.isIntersecting);
+                break;
+            default:
+                {
+                    const element = target;
+                    handleAnimatedSection(element, entry.isIntersecting, entry);
+                }
+                break;
+        }
+    }
+}
+function getObserver(threshold) {
+    let observer = _observers.get(threshold);
+    if (!observer) {
+        observer = new IntersectionObserver(intersectionHandler, {
+            threshold,
+        });
+        _observers.set(threshold, observer);
+    }
+    return observer;
+}
+function findAllAnimations(defaultThreshold) {
+    const observed = new Set();
+    const animationObservers = new Map();
+    function observeAnimation(animation) {
+        if (observed.has(animation))
+            return;
+        observed.add(animation);
+        const threshold = getElementThreshold(animation, defaultThreshold);
+        const observer = getObserver(threshold);
+        if (shouldDebug(animation)) {
+            animation.setAttribute('data-monitor-threshold', threshold.toString());
+            animation.setAttribute('data-monitor-observed', 'true');
+        }
+        let animationList = animationObservers.get(observer);
+        if (!animationList) {
+            animationList = [];
+            animationObservers.set(observer, animationList);
+        }
+        animationList.push(animation);
+        observer.observe(animation);
+    }
+    // Initial scan
+    const existing = document.getElementsByTagName('lottie-player');
+    if (shouldDebug()) {
+        console.log(`[ClientMonitor] Found ${existing.length} animation(s)`);
+    }
+    for (const animation of existing) {
+        observeAnimation(animation);
+    }
+    // Watch for lottie-player elements added after initial scan (e.g. via LazyAnimation)
+    const mutationObserver = new MutationObserver((mutations) => {
+        for (const mutation of mutations) {
+            for (const node of mutation.addedNodes) {
+                if (node.nodeType !== Node.ELEMENT_NODE)
+                    continue;
+                const el = node;
+                if (el.localName === 'lottie-player') {
+                    observeAnimation(el);
+                }
+                for (const child of el.getElementsByTagName('lottie-player')) {
+                    observeAnimation(child);
+                }
+            }
+        }
+    });
+    mutationObserver.observe(document.body, { childList: true, subtree: true });
+    return () => {
+        mutationObserver.disconnect();
+        for (const [observer, animationList] of animationObservers) {
+            for (const animation of animationList) {
+                observer.unobserve(animation);
+            }
+        }
+    };
+}
+function findAllAnimatedSections(defaultThreshold) {
+    const sections = document.querySelectorAll('[data-component]');
+    const sectionElements = [];
+    if (shouldDebug()) {
+        console.log(`[ClientMonitor] Found ${sections.length} animated section(s)`);
+    }
+    // Create a shared observer with dense thresholds for all sections
+    // This gives us callbacks at every 5% intersection change
+    const sectionObserver = new IntersectionObserver((entries) => {
+        for (const entry of entries) {
+            const element = entry.target;
+            handleAnimatedSection(element, entry.isIntersecting, entry);
+        }
+    }, { threshold: SECTION_THRESHOLDS });
+    // Set up ResizeObserver to track element heights
+    const resizeObserver = new ResizeObserver((entries) => {
+        for (const entry of entries) {
+            const element = entry.target;
+            _sectionHeights.set(element, entry.contentRect.height);
+        }
+    });
+    for (const section of sections) {
+        const sectionElement = section;
+        // Skip elements that are excluded from animation
+        if (sectionElement.hasAttribute('data-exclude-animation')) {
+            continue;
+        }
+        const threshold = getElementThreshold(sectionElement, defaultThreshold);
+        // Store threshold for this element
+        _sectionThresholds.set(sectionElement, threshold);
+        // Get initial height and store it
+        const height = sectionElement.offsetHeight;
+        _sectionHeights.set(sectionElement, height);
+        // Observe element for size changes
+        resizeObserver.observe(sectionElement);
+        // Track element for cleanup
+        sectionElements.push(sectionElement);
+        if (shouldDebug(sectionElement)) {
+            sectionElement.setAttribute('data-monitor-threshold', threshold.toString());
+            sectionElement.setAttribute('data-monitor-observed', 'true');
+        }
+        // Observe with shared dense-threshold observer
+        sectionObserver.observe(sectionElement);
+    }
+    return () => {
+        // Clean up IntersectionObserver
+        sectionObserver.disconnect();
+        // Clean up ResizeObserver and maps
+        for (const sectionElement of sectionElements) {
+            resizeObserver.unobserve(sectionElement);
+            _sectionHeights.delete(sectionElement);
+            _sectionThresholds.delete(sectionElement);
+            // Remove from tall element tracking if present
+            _intersectingTallElements.delete(sectionElement);
+        }
+        // Clean up scroll listener
+        if (_scrollListenerAttached) {
+            window.removeEventListener('scroll', handleScroll);
+            _scrollListenerAttached = false;
+            if (_scrollRAFId !== null) {
+                cancelAnimationFrame(_scrollRAFId);
+                _scrollRAFId = null;
+            }
+        }
+        if (shouldDebug()) {
+            console.log('[ClientMonitor] Animated sections cleanup complete');
+        }
+    };
+}
+function findAll(defaultThreshold) {
+    const videoCleanup = findAllVideos(defaultThreshold, shouldDebug);
+    const animationCleanup = findAllAnimations(defaultThreshold);
+    const animatedSectionCleanup = findAllAnimatedSections(defaultThreshold);
+    return () => {
+        videoCleanup();
+        animationCleanup();
+        animatedSectionCleanup();
+    };
+}
+export const ClientMonitor = ({ defaultThreshold = 0.2, enableDebug = false, }) => {
+    // Set module-level flag on mount/update
+    _debugEnabled = enableDebug;
+    const isDocumentVisible = useDocumentVisible();
+    const pathname = usePathname();
+    const roundedDefaultThreshold = roundThreshold(defaultThreshold);
+    useEffect(() => {
+        pathname;
+        if (isDocumentVisible) {
+            if (shouldDebug()) {
+                console.log(`[ClientMonitor] Initializing with defaultThreshold: ${roundedDefaultThreshold}`);
+            }
+            return findAll(roundedDefaultThreshold);
+        }
+        return undefined;
+    }, [pathname, isDocumentVisible, roundedDefaultThreshold]);
+    return (_jsx(Script, { id: "welcome", strategy: "afterInteractive", children: `
+console.log("%cDesigned and built by Something Else", "font-weight: bold");
+` }));
+};
+//# sourceMappingURL=ClientMonitor.js.map

package/dist/components/ClientMonitor.js.map

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

package/dist/components/CmsCollection.d.ts

@@ -0,0 +1,68 @@
+/** biome-ignore-all lint/suspicious/noExplicitAny: Any is allowed */
+import type { IContentfulCollection } from '@se-studio/contentful-rest-api';
+import type { IBaseCollection, IContentContext, ITyped } from '@se-studio/core-data-types';
+import type React from 'react';
+import type { CmsRendererConfig } from '../CmsRendererConfig';
+import type { EmbeddedRendererProps } from './CmsContent';
+export type CollectionRendererProps<TInformation extends ITyped> = {
+    information: TInformation;
+    contentContext: IContentContext;
+    rendererConfig: CmsRendererConfig;
+};
+/**
+ * Standard collection renderer type for rendering collections in the main content flow.
+ * Used for collections that appear as top-level page content.
+ *
+ * @example
+ * ```tsx
+ * const MyCollectionRenderer: CollectionRenderer<IMyCollection> = ({
+ *   information,
+ *   contentContext,
+ *   rendererConfig
+ * }) => {
+ *   return <div>{information.title}</div>;
+ * };
+ * ```
+ */
+export type CollectionRenderer<TInformation extends ITyped> = React.FC<CollectionRendererProps<TInformation>>;
+/**
+ * Embedded collection renderer type for rendering collections within rich text or other collections.
+ * Includes additional props for positioning and tracking embedded content.
+ *
+ * Use this type when defining custom collection renderers that can be embedded within RTF fields
+ * or nested inside other collections.
+ *
+ * @example
+ * ```tsx
+ * const MyEmbeddedCollectionRenderer: EmbeddedCollectionRenderer<IMyCollection> = ({
+ *   information,
+ *   contentContext,
+ *   rendererConfig,
+ *   positionClassName,
+ *   embeddedIndex,
+ *   parentIndex
+ * }) => {
+ *   return (
+ *     <div className={positionClassName}>
+ *       {information.title} (Position: {embeddedIndex})
+ *     </div>
+ *   );
+ * };
+ * ```
+ */
+export type EmbeddedCollectionRenderer<TInformation extends ITyped = ITyped> = React.FC<CollectionRendererProps<TInformation> & EmbeddedRendererProps>;
+/**
+ * Collection type mapper for rendering collections.
+ * Maps collection type strings to React components that can render them.
+ *
+ * Projects should provide their own CollectionMap when calling CmsCollection.
+ */
+export type CollectionMap<TKey extends string, TInformation extends ITyped> = Partial<Record<TKey, CollectionRenderer<TInformation>>>;
+export type EmbeddedCollectionMap<TKey extends string, TInformation extends IBaseCollection> = Partial<Record<TKey, EmbeddedCollectionRenderer<TInformation>>>;
+export declare const CmsCollection: CollectionRenderer<IContentfulCollection & {
+    collectionType: string;
+}>;
+export declare const CmsEmbeddedCollection: EmbeddedCollectionRenderer<IBaseCollection & {
+    collectionType: string;
+}>;
+//# sourceMappingURL=CmsCollection.d.ts.map

package/dist/components/CmsCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CmsCollection.d.ts","sourceRoot":"","sources":["../../src/components/CmsCollection.tsx"],"names":[],"mappings":"AAAA,qEAAqE;AAErE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAC3F,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,MAAM,uBAAuB,CAAC,YAAY,SAAS,MAAM,IAAI;IACjE,WAAW,EAAE,YAAY,CAAC;IAC1B,cAAc,EAAE,eAAe,CAAC;IAChC,cAAc,EAAE,iBAAiB,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,kBAAkB,CAAC,YAAY,SAAS,MAAM,IAAI,KAAK,CAAC,EAAE,CACpE,uBAAuB,CAAC,YAAY,CAAC,CACtC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,0BAA0B,CAAC,YAAY,SAAS,MAAM,GAAG,MAAM,IAAI,KAAK,CAAC,EAAE,CACrF,uBAAuB,CAAC,YAAY,CAAC,GAAG,qBAAqB,CAC9D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,aAAa,CAAC,IAAI,SAAS,MAAM,EAAE,YAAY,SAAS,MAAM,IAAI,OAAO,CACnF,MAAM,CAAC,IAAI,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAC/C,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAC/B,IAAI,SAAS,MAAM,EACnB,YAAY,SAAS,eAAe,IAClC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,0BAA0B,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAwFpE,eAAO,MAAM,aAAa,EAAE,kBAAkB,CAC5C,qBAAqB,GAAG;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,CAoDnD,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,0BAA0B,CAC5D,eAAe,GAAG;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,CA0E7C,CAAC"}

package/dist/components/CmsCollection.js

@@ -0,0 +1,68 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * Dev-only panel shown when a collection type has opted out of embedding via `embeddedRenderer: false`.
+ */
+const EmbedNotSupportedError = ({ typeName, id, show, }) => {
+    if (!show)
+        return null;
+    return (_jsxs("div", { style: {
+            border: '2px solid orange',
+            background: '#fff3cd',
+            padding: '1rem',
+            margin: '1rem',
+            borderRadius: '4px',
+        }, children: [_jsx("h3", { style: { color: '#856404', marginBottom: '0.5rem' }, children: "Collection Embedding Not Supported" }), _jsxs("div", { style: { fontSize: '0.875rem' }, children: [_jsxs("p", { children: [_jsx("strong", { children: "Collection Type:" }), " ", typeName] }), _jsxs("p", { children: [_jsx("strong", { children: "Collection ID:" }), " ", id] }), _jsx("p", { style: { color: '#856404', marginTop: '0.5rem' }, children: "This collection type has been explicitly marked as not embeddable in rich text. Remove the embedded block in Contentful, or add an embeddedRenderer to the registration." })] })] }));
+};
+/**
+ * Error component displayed when not in production and an unknown collection type is encountered
+ */
+const CollectionTypeError = ({ information, availableTypes, show, }) => {
+    if (!show)
+        return null;
+    return (_jsxs("div", { style: {
+            border: '2px solid orange',
+            background: '#fff3cd',
+            padding: '1rem',
+            margin: '1rem',
+            borderRadius: '4px',
+        }, children: [_jsx("h3", { style: { color: '#856404', marginBottom: '0.5rem' }, children: "Unknown Collection Type" }), _jsxs("div", { style: { fontSize: '0.875rem' }, children: [_jsxs("p", { children: [_jsx("strong", { children: "Collection Type:" }), " ", information.collectionType] }), _jsxs("p", { children: [_jsx("strong", { children: "Collection ID:" }), " ", information.id] }), _jsxs("p", { children: [_jsx("strong", { children: "Available Types:" }), " ", availableTypes.join(', ')] }), _jsx("p", { style: { color: '#856404', marginTop: '0.5rem' }, children: "This collection type is not registered in CollectionMap. Using Generic fallback." })] })] }));
+};
+export const CmsCollection = ({ information, contentContext, rendererConfig }) => {
+    const { buildInformation, collectionMap, defaultCollectionRenderer: DefaultRenderer, } = rendererConfig;
+    const Element = collectionMap[information.collectionType];
+    if (Element) {
+        const result = (_jsx(Element, { information: information, contentContext: contentContext, rendererConfig: rendererConfig }));
+        return result;
+    }
+    // Log unknown collection type for monitoring
+    const availableTypes = Object.keys(collectionMap);
+    if (process.env.LOG_CMS)
+        console.log(`Unknown collection type: ${String(information.collectionType)} (ID: ${information.id}). Available types:`, availableTypes.join(','));
+    const shouldShowError = !buildInformation.isProduction;
+    const result = (_jsxs(_Fragment, { children: [shouldShowError && (_jsx(CollectionTypeError, { information: information, availableTypes: availableTypes, show: !buildInformation.isProduction })), DefaultRenderer && (_jsx(DefaultRenderer, { information: information, contentContext: contentContext, rendererConfig: rendererConfig }))] }));
+    return result;
+};
+export const CmsEmbeddedCollection = ({ information, rendererConfig, contentContext, ...props }) => {
+    const { buildInformation, embeddedCollectionMap, collectionMap, noEmbedCollections, defaultCollectionRenderer: DefaultRenderer, } = rendererConfig;
+    // Step 1: Explicit opt-out
+    if (noEmbedCollections?.has(information.collectionType)) {
+        return (_jsx(EmbedNotSupportedError, { typeName: information.collectionType, id: information.id, show: !buildInformation.isProduction }));
+    }
+    // Step 2: Dedicated embedded renderer
+    const Element = embeddedCollectionMap[information.collectionType];
+    if (Element) {
+        return (_jsx(Element, { information: information, rendererConfig: rendererConfig, contentContext: contentContext, ...props }));
+    }
+    // Step 3: Fall back to top-level renderer
+    const FallbackElement = collectionMap[information.collectionType];
+    if (FallbackElement) {
+        return (_jsx(FallbackElement, { information: information, contentContext: contentContext, rendererConfig: rendererConfig }));
+    }
+    // Step 4: Unknown type
+    const availableTypes = Object.keys(collectionMap);
+    if (process.env.LOG_CMS)
+        console.log(`Unknown embedded collection type: ${String(information.collectionType)} (ID: ${information.id}). Available types:`, availableTypes.join(','));
+    const shouldShowError = !buildInformation.isProduction;
+    return (_jsxs(_Fragment, { children: [shouldShowError && (_jsx(CollectionTypeError, { information: information, availableTypes: availableTypes, show: !buildInformation.isProduction })), DefaultRenderer && (_jsx(DefaultRenderer, { information: information, contentContext: contentContext, rendererConfig: rendererConfig }))] }));
+};
+//# sourceMappingURL=CmsCollection.js.map

package/dist/components/CmsCollection.js.map

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

package/dist/components/CmsComponent.d.ts

@@ -0,0 +1,68 @@
+/** biome-ignore-all lint/suspicious/noExplicitAny: Any is allowed */
+import type { IContentfulComponent } from '@se-studio/contentful-rest-api';
+import type { IBaseComponent, IContentContext, ITyped } from '@se-studio/core-data-types';
+import type React from 'react';
+import type { CmsRendererConfig } from '../CmsRendererConfig';
+import type { EmbeddedRendererProps } from './CmsContent';
+export type ComponentRendererProps<TInformation extends ITyped> = {
+    information: TInformation;
+    contentContext: IContentContext;
+    rendererConfig: CmsRendererConfig;
+};
+/**
+ * Standard component renderer type for rendering components in the main content flow.
+ * Used for components that appear as top-level page content.
+ *
+ * @example
+ * ```tsx
+ * const MyComponentRenderer: ComponentRenderer<IMyComponent> = ({
+ *   information,
+ *   contentContext,
+ *   rendererConfig
+ * }) => {
+ *   return <div>{information.heading}</div>;
+ * };
+ * ```
+ */
+export type ComponentRenderer<TInformation extends ITyped> = React.FC<ComponentRendererProps<TInformation>>;
+/**
+ * Embedded component renderer type for rendering components within rich text or collections.
+ * Includes additional props for positioning and tracking embedded content.
+ *
+ * Use this type when defining custom component renderers that can be embedded within RTF fields
+ * or nested inside collections.
+ *
+ * @example
+ * ```tsx
+ * const MyEmbeddedComponentRenderer: EmbeddedComponentRenderer<IMyComponent> = ({
+ *   information,
+ *   contentContext,
+ *   rendererConfig,
+ *   positionClassName,
+ *   embeddedIndex,
+ *   parentIndex
+ * }) => {
+ *   return (
+ *     <div className={positionClassName}>
+ *       {information.heading} (Embedded #{embeddedIndex})
+ *     </div>
+ *   );
+ * };
+ * ```
+ */
+export type EmbeddedComponentRenderer<TInformation extends ITyped = ITyped> = React.FC<ComponentRendererProps<TInformation> & EmbeddedRendererProps>;
+/**
+ * Component type mapper for rendering components.
+ * Maps component type strings to React components that can render them.
+ *
+ * Projects should provide their own ComponentMap when calling CmsComponent.
+ */
+export type ComponentMap<TKey extends string, TInformation extends ITyped> = Partial<Record<TKey, ComponentRenderer<TInformation>>>;
+export type EmbeddedComponentMap<TKey extends string, TInformation extends ITyped> = Partial<Record<TKey, EmbeddedComponentRenderer<TInformation>>>;
+export declare const CmsComponent: ComponentRenderer<IContentfulComponent & {
+    componentType: string;
+}>;
+export declare const CmsEmbeddedComponent: EmbeddedComponentRenderer<IBaseComponent & {
+    componentType: string;
+}>;
+//# sourceMappingURL=CmsComponent.d.ts.map

package/dist/components/CmsComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CmsComponent.d.ts","sourceRoot":"","sources":["../../src/components/CmsComponent.tsx"],"names":[],"mappings":"AAAA,qEAAqE;AAErE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,MAAM,sBAAsB,CAAC,YAAY,SAAS,MAAM,IAAI;IAChE,WAAW,EAAE,YAAY,CAAC;IAC1B,cAAc,EAAE,eAAe,CAAC;IAChC,cAAc,EAAE,iBAAiB,CAAC;CACnC,CAAC;AACF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,iBAAiB,CAAC,YAAY,SAAS,MAAM,IAAI,KAAK,CAAC,EAAE,CACnE,sBAAsB,CAAC,YAAY,CAAC,CACrC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,yBAAyB,CAAC,YAAY,SAAS,MAAM,GAAG,MAAM,IAAI,KAAK,CAAC,EAAE,CACpF,sBAAsB,CAAC,YAAY,CAAC,GAAG,qBAAqB,CAC7D,CAAC;AACF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,CAAC,IAAI,SAAS,MAAM,EAAE,YAAY,SAAS,MAAM,IAAI,OAAO,CAClF,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAC9C,CAAC;AACF,MAAM,MAAM,oBAAoB,CAAC,IAAI,SAAS,MAAM,EAAE,YAAY,SAAS,MAAM,IAAI,OAAO,CAC1F,MAAM,CAAC,IAAI,EAAE,yBAAyB,CAAC,YAAY,CAAC,CAAC,CACtD,CAAC;AAwFF,eAAO,MAAM,YAAY,EAAE,iBAAiB,CAAC,oBAAoB,GAAG;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,CAuD5F,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,yBAAyB,CAC1D,cAAc,GAAG;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,CA2E3C,CAAC"}