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

package/dist/utils/componentUtils.js

@@ -0,0 +1,327 @@
+import 'server-only';
+import { contentfulAllArticleLinks, contentfulAllPersonLinks, contentfulAllTagLinks, filterRelatedArticles, isTagVisible, } from '@se-studio/contentful-rest-api';
+import { getArticleAuthors, isArticleLink, isArticleTypeLink, isPersonLink, isTagLink, } from '@se-studio/core-data-types';
+import { extractCuratedLinkIds, resolveCuratedLinksFromListing } from './linkResolution';
+/**
+ * Ambient article tags for relatedness: topical/display tags only.
+ * Matches card chip visibility (show + not hidden + not unindexed).
+ */
+function isAmbientRelatedArticleTag(tag) {
+    if (!isTagVisible(tag)) {
+        return false;
+    }
+    if (tag.hidden === true) {
+        return false;
+    }
+    if (tag.indexed === false) {
+        return false;
+    }
+    return true;
+}
+/** Multi-customer-safe defaults for {@link RelatedArticlesFallbackPolicy}. */
+export const DEFAULT_RELATED_ARTICLES_FALLBACK_POLICY = {
+    strictAuthorWhenPersonCriteria: true,
+    boostCurrentArticleAuthors: false,
+    fallbackTagsFromPageContext: true,
+    fallbackArticleTypeFromPageContext: true,
+    excludeHiddenTagsFromArticleFallback: true,
+};
+/**
+ * Merge a partial policy with package defaults.
+ */
+export function resolveRelatedArticlesFallbackPolicy(partial) {
+    return {
+        ...DEFAULT_RELATED_ARTICLES_FALLBACK_POLICY,
+        ...partial,
+    };
+}
+/**
+ * Extract filter criteria (article types, tags, authors) from collection links and contents.
+ * Internal helper for getRelatedArticles.
+ */
+function extractFilterCriteria(links, contents) {
+    const articleTypeIds = [];
+    const tagIds = [];
+    const authorIds = [];
+    const items = [...(links ?? []), ...(contents ?? [])];
+    for (const item of items) {
+        if (isArticleTypeLink(item)) {
+            articleTypeIds.push(item.internalId);
+        }
+        else if (isTagLink(item)) {
+            tagIds.push(item.internalId);
+        }
+        else if (isPersonLink(item)) {
+            authorIds.push(item.internalId);
+        }
+    }
+    return { articleTypeIds, tagIds, authorIds };
+}
+/**
+ * Apply fallback criteria from page context when no explicit criteria provided.
+ * Internal helper for getRelatedArticles.
+ */
+function applyFallbackCriteria(criteria, contentContext, policy) {
+    if (policy.fallbackArticleTypeFromPageContext && criteria.articleTypeIds.length === 0) {
+        const articleType = contentContext.pageContext?.articleType;
+        if (articleType) {
+            criteria.articleTypeIds.push(articleType.id);
+        }
+        else {
+            const article = contentContext.pageContext?.article;
+            if (article?.articleType?.id) {
+                criteria.articleTypeIds.push(article.articleType.id);
+            }
+        }
+    }
+    if (criteria.authorIds.length === 0) {
+        const person = contentContext.pageContext?.person;
+        if (person?.id) {
+            // Person / author profile pages always contribute the person as author criteria.
+            criteria.authorIds.push(person.id);
+        }
+        else if (policy.boostCurrentArticleAuthors) {
+            const article = contentContext.pageContext?.article;
+            if (article) {
+                for (const author of getArticleAuthors(article)) {
+                    if (author.id) {
+                        criteria.authorIds.push(author.id);
+                    }
+                }
+            }
+        }
+    }
+    if (policy.fallbackTagsFromPageContext && criteria.tagIds.length === 0) {
+        const tag = contentContext.pageContext?.tag;
+        if (tag?.id) {
+            // Tag index page: always use the page tag (not ambient article tags).
+            criteria.tagIds.push(tag.id);
+        }
+        else {
+            const article = contentContext.pageContext?.article;
+            const ambientTags = article?.tags ?? [];
+            const articleTagIds = (policy.excludeHiddenTagsFromArticleFallback
+                ? ambientTags.filter(isAmbientRelatedArticleTag)
+                : ambientTags)
+                .map((t) => t.id)
+                .filter((id) => Boolean(id));
+            if (articleTagIds.length > 0) {
+                criteria.tagIds.push(...articleTagIds);
+            }
+        }
+    }
+}
+/**
+ * Whether author criteria came from a person page or explicit CMS person links
+ * (not from article-author soft boost).
+ */
+function hasPersonAuthorCriteria(hadExplicitPersonCriteria, contentContext) {
+    return hadExplicitPersonCriteria || !!contentContext.pageContext?.person?.id;
+}
+/**
+ * Tag IDs to resolve when collection contents omit manual tag picks.
+ * Internal helper for getRelatedTags.
+ */
+function getRelatedTagsFallbackIds(contentContext) {
+    const pageTag = contentContext.pageContext?.tag;
+    if (pageTag?.id) {
+        return [pageTag.id];
+    }
+    const article = contentContext.pageContext?.article;
+    // Match related-articles ambient policy: skip non-display tags on article pages.
+    return (article?.tags
+        ?.filter(isAmbientRelatedArticleTag)
+        .map((t) => t.id)
+        .filter((id) => Boolean(id)) ?? []);
+}
+/**
+ * Normalize a caught error to CmsError for inclusion in CmsResponse.
+ */
+function toCmsError(error) {
+    return {
+        entryId: '',
+        message: error instanceof Error ? error.message : String(error),
+        error,
+    };
+}
+/**
+ * Determine whether we should fetch additional articles.
+ * Internal helper for getRelatedArticles.
+ */
+function shouldFetchArticles(isAll, remainingSlots, criteria) {
+    if (isAll) {
+        return true;
+    }
+    const hasSlots = remainingSlots !== undefined && remainingSlots > 0;
+    const hasFilters = criteria.articleTypeIds.length > 0 ||
+        criteria.tagIds.length > 0 ||
+        criteria.authorIds.length > 0;
+    return hasSlots && hasFilters;
+}
+/**
+ * Generic helper to get related articles for a collection.
+ *
+ * Curated article refs in `contents` provide IDs and order only; display data is always
+ * resolved from `contentfulAllArticleLinks` (or injected `fetchArticleLinks`) so the
+ * `article` cache tag revalidates when entries are published.
+ *
+ * @param policy - How CMS + pageContext map to filter options. Defaults to
+ *   {@link DEFAULT_RELATED_ARTICLES_FALLBACK_POLICY}. Partial policies are merged with defaults.
+ */
+export async function getRelatedArticles(information, contentContext, converterContext, config, count, options, fetchArticleLinks, policy) {
+    const resolvedPolicy = resolveRelatedArticlesFallbackPolicy(policy);
+    const isAll = typeof count === 'undefined';
+    const manualArticleIds = extractCuratedLinkIds(information.contents, isArticleLink);
+    if (process.env.LOG_RELATED_ARTICLES) {
+        console.log(`[RelatedArticles] manual article ids: ${manualArticleIds.length} (ids: ${manualArticleIds.join(', ') || 'none'})`);
+    }
+    if (process.env.LOG_RELATED_ARTICLES) {
+        console.log('[RelatedArticles] contents', information.contents);
+    }
+    const criteria = extractFilterCriteria(information.links, information.contents);
+    const hadExplicitPersonCriteria = criteria.authorIds.length > 0;
+    if (process.env.LOG_RELATED_ARTICLES) {
+        console.log(`[RelatedArticles] criteria (raw): articleTypes=${criteria.articleTypeIds.join(',') || 'none'} tags=${criteria.tagIds.join(',') || 'none'} authors=${criteria.authorIds.join(',') || 'none'}`);
+    }
+    applyFallbackCriteria(criteria, contentContext, resolvedPolicy);
+    if (process.env.LOG_RELATED_ARTICLES) {
+        console.log(`[RelatedArticles] criteria (after fallback): articleTypes=${criteria.articleTypeIds.join(',') || 'none'} tags=${criteria.tagIds.join(',') || 'none'} authors=${criteria.authorIds.join(',') || 'none'} policy=${JSON.stringify(resolvedPolicy)}`);
+    }
+    const currentArticle = contentContext.pageContext?.article;
+    const excludeArticleIds = [...manualArticleIds, ...(currentArticle ? [currentArticle.id] : [])];
+    const remainingSlots = isAll || count === undefined ? undefined : count - manualArticleIds.length;
+    const needsListingFetch = manualArticleIds.length > 0 || shouldFetchArticles(isAll, remainingSlots, criteria);
+    let allArticleLinks = [];
+    let fetchedArticles = [];
+    let errors = [];
+    if (needsListingFetch) {
+        if (process.env.LOG_RELATED_ARTICLES) {
+            console.log(`[RelatedArticles] fetching all article links (remainingSlots=${remainingSlots ?? 'all'}, excludeIds=${excludeArticleIds.join(',') || 'none'})`);
+        }
+        try {
+            const response = await (fetchArticleLinks ??
+                ((opts) => contentfulAllArticleLinks(converterContext, config, {
+                    ...opts,
+                    fetchProfile: opts.fetchProfile ?? 'listing',
+                })))(options);
+            errors = response.errors;
+            allArticleLinks = response.data;
+            if (shouldFetchArticles(isAll, remainingSlots, criteria)) {
+                const strictAuthorMatch = resolvedPolicy.strictAuthorWhenPersonCriteria &&
+                    hasPersonAuthorCriteria(hadExplicitPersonCriteria, contentContext);
+                const filterOptions = {
+                    excludeArticleIds,
+                    tagIds: criteria.tagIds,
+                    articleTypeIds: criteria.articleTypeIds,
+                    authorIds: criteria.authorIds,
+                    strictAuthorMatch: strictAuthorMatch || undefined,
+                    count: remainingSlots,
+                };
+                fetchedArticles = filterRelatedArticles(allArticleLinks, filterOptions);
+                if (process.env.LOG_RELATED_ARTICLES) {
+                    console.log(`[RelatedArticles] after filter: ${fetchedArticles.length} articles (strictAuthorMatch=${strictAuthorMatch})`);
+                }
+            }
+        }
+        catch (error) {
+            errors = [toCmsError(error)];
+        }
+    }
+    const resolvedManual = resolveCuratedLinksFromListing(manualArticleIds, allArticleLinks);
+    const data = [...resolvedManual, ...fetchedArticles].slice(0, count);
+    if (process.env.LOG_RELATED_ARTICLES) {
+        console.log(`[RelatedArticles] returning ${data.length} articles (${resolvedManual.length} manual + ${fetchedArticles.length} fetched)`);
+    }
+    return { data, errors };
+}
+/**
+ * Generic helper to get related people for a collection.
+ *
+ * Curated person refs in `contents` provide IDs and order only; display data is always
+ * resolved from `contentfulAllPersonLinks` so the `person` cache tag revalidates on publish.
+ */
+export async function getRelatedPeople(information, contentContext, converterContext, config, count, options, fetchPersonLinks) {
+    const manualPeopleIds = extractCuratedLinkIds(information.contents, isPersonLink);
+    const currentPerson = contentContext.pageContext?.person;
+    const excludePersonIds = new Set([
+        ...manualPeopleIds,
+        ...(currentPerson ? [currentPerson.id] : []),
+    ]);
+    const remainingSlots = count - manualPeopleIds.length;
+    const needsListingFetch = manualPeopleIds.length > 0 || remainingSlots > 0;
+    if (!needsListingFetch) {
+        return { data: [], errors: [] };
+    }
+    let errors = [];
+    let allPeople = [];
+    try {
+        const response = await (fetchPersonLinks ?? ((opts) => contentfulAllPersonLinks(converterContext, config, opts)))(options);
+        errors = response.errors;
+        allPeople = response.data;
+    }
+    catch (error) {
+        return { data: [], errors: [toCmsError(error)] };
+    }
+    const resolvedManual = resolveCuratedLinksFromListing(manualPeopleIds, allPeople);
+    const fetchedPeople = allPeople
+        .filter((person) => isPersonLink(person) && !excludePersonIds.has(person.id) && person.indexed !== false)
+        .slice(0, Math.max(0, remainingSlots));
+    const data = [...resolvedManual, ...fetchedPeople].slice(0, count);
+    return { data, errors };
+}
+/**
+ * Generic helper to get related tags for a collection.
+ *
+ * Curated tag refs in `contents` provide IDs and order only; display data is always
+ * resolved from `contentfulAllTagLinks` so the `tag` cache tag revalidates on publish.
+ *
+ * When `contents` has no tag picks, falls back to `pageContext.tag` then the current
+ * article's tags (article detail pages). When neither is set, auto-fills from the tag listing.
+ */
+export async function getRelatedTags(information, contentContext, converterContext, config, count, options, fetchTagLinks) {
+    const manualTagIds = extractCuratedLinkIds(information.contents, isTagLink);
+    const fallbackCuratedIds = manualTagIds.length > 0 ? [] : getRelatedTagsFallbackIds(contentContext);
+    const curatedIds = manualTagIds.length > 0 ? manualTagIds : fallbackCuratedIds;
+    const useListingAutofill = manualTagIds.length === 0 && fallbackCuratedIds.length === 0;
+    const currentTag = contentContext.pageContext?.tag;
+    const excludeTagIds = new Set([...curatedIds, ...(currentTag ? [currentTag.id] : [])]);
+    const remainingSlots = count - curatedIds.length;
+    const needsListingFetch = curatedIds.length > 0 || remainingSlots > 0 || useListingAutofill;
+    if (!needsListingFetch) {
+        return { data: [], errors: [] };
+    }
+    let errors = [];
+    let allTags = [];
+    try {
+        const response = await (fetchTagLinks ??
+            (async (opts) => {
+                const res = await contentfulAllTagLinks(converterContext, config, opts);
+                return {
+                    data: res.data.filter(isTagLink),
+                    errors: res.errors,
+                };
+            }))(options);
+        errors = response.errors;
+        allTags = response.data;
+    }
+    catch (error) {
+        return { data: [], errors: [toCmsError(error)] };
+    }
+    const resolvedCurated = resolveCuratedLinksFromListing(curatedIds, allTags);
+    let fetchedTags = [];
+    if (useListingAutofill && resolvedCurated.length < count) {
+        const slots = count - resolvedCurated.length;
+        fetchedTags = allTags
+            .filter((tag) => !excludeTagIds.has(tag.id) && tag.indexed !== false)
+            .slice(0, slots);
+    }
+    else if (!useListingAutofill && manualTagIds.length > 0 && resolvedCurated.length < count) {
+        const slots = count - resolvedCurated.length;
+        fetchedTags = allTags
+            .filter((tag) => !excludeTagIds.has(tag.id) && tag.indexed !== false)
+            .slice(0, slots);
+    }
+    const data = [...resolvedCurated, ...fetchedTags].slice(0, count);
+    return { data, errors };
+}
+//# sourceMappingURL=componentUtils.js.map

package/dist/utils/componentUtils.js.map

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

package/dist/utils/convertText.d.ts

@@ -0,0 +1,2 @@
+export declare function convertText(text: string): string | import("react").JSX.Element | (string | import("react").JSX.Element)[] | undefined;
+//# sourceMappingURL=convertText.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"convertText.d.ts","sourceRoot":"","sources":["../../src/utils/convertText.tsx"],"names":[],"mappings":"AAWA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,+FA+CvC"}

package/dist/utils/convertText.js

@@ -0,0 +1,35 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { decode } from 'html-entities';
+import { Fragment } from 'react';
+const specialChars = {
+    '®': 'align-super text-[0.6em]',
+    // "©": "align-super p-sm",
+    // "℠": "align-super p-sm",
+};
+const pattern = new RegExp(`(${Object.keys(specialChars).join('|')})`, 'g');
+export function convertText(text) {
+    if (text) {
+        const replaced = decode(text);
+        const split = replaced.replaceAll('\\n', '\n').replaceAll('\n', '<br>').split('<br>');
+        if (split.length === 1) {
+            const first = split[0];
+            if (first === undefined)
+                return text;
+            const result = first.split(pattern).map((part, i) => {
+                const special = specialChars[part];
+                if (special === undefined) {
+                    return part;
+                }
+                return (_jsx("span", { className: special, children: part }, i));
+            });
+            if (result.length === 1) {
+                return result[0];
+            }
+            return result;
+        }
+        const mapped = split.map((s, index) => (_jsxs(Fragment, { children: [index > 0 && _jsx("br", {}), _jsx("span", { children: s.split(new RegExp(`(${Object.keys(specialChars).join('|')})`, 'g')).map((part, i) => specialChars[part] !== undefined ? (_jsx("span", { className: specialChars[part], children: part }, i)) : (part)) })] }, index)));
+        return mapped;
+    }
+    return undefined;
+}
+//# sourceMappingURL=convertText.js.map

package/dist/utils/convertText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertText.js","sourceRoot":"","sources":["../../src/utils/convertText.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjC,MAAM,YAAY,GAA2B;IAC3C,GAAG,EAAE,0BAA0B;IAC/B,2BAA2B;IAC3B,2BAA2B;CAC5B,CAAC;AAEF,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAE5E,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEtF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACvB,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC;YACrC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;gBAClD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;gBACnC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBAC1B,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,OAAO,CAEL,eAAc,SAAS,EAAE,OAAO,YAC7B,IAAI,IADI,CAAC,CAEL,CACR,CAAC;YACJ,CAAC,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;YACnB,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAErC,MAAC,QAAQ,eACN,KAAK,GAAG,CAAC,IAAI,cAAM,EACpB,yBACG,CAAC,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CACpF,YAAY,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAEjC,eAAc,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,YACxC,IAAI,IADI,CAAC,CAEL,CACR,CAAC,CAAC,CAAC,CACF,IAAI,CACL,CACF,GACI,KAbM,KAAK,CAcT,CACZ,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/utils/createDefaultRenderText.d.ts

@@ -0,0 +1,17 @@
+import type { RenderText } from '@contentful/rich-text-react-renderer';
+import type { IContentContext, ProcessTextFn } from '@se-studio/core-data-types';
+/**
+ * Returns the default renderText handler used internally by RTF.
+ *
+ * Use this as the fallback inside a custom renderText so that unmatched text
+ * still passes through {{meta.*}} interpolation, then site processText, then convertText:
+ *
+ * @example
+ * const fallback = createDefaultRenderText(rendererConfig?.processText, contentContext);
+ * const renderText: RenderText = (text) => {
+ *   if (isShortcode(text)) return <span>{text}</span>;
+ *   return fallback(text);
+ * };
+ */
+export declare function createDefaultRenderText(processText?: ProcessTextFn, contentContext?: IContentContext): RenderText;
+//# sourceMappingURL=createDefaultRenderText.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createDefaultRenderText.d.ts","sourceRoot":"","sources":["../../src/utils/createDefaultRenderText.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAKjF;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,CAAC,EAAE,aAAa,EAC3B,cAAc,CAAC,EAAE,eAAe,GAC/B,UAAU,CAQZ"}

package/dist/utils/createDefaultRenderText.js

@@ -0,0 +1,25 @@
+import { convertText } from './convertText';
+import { composeMetaProcessText } from './interpolateMetaText';
+/**
+ * Returns the default renderText handler used internally by RTF.
+ *
+ * Use this as the fallback inside a custom renderText so that unmatched text
+ * still passes through {{meta.*}} interpolation, then site processText, then convertText:
+ *
+ * @example
+ * const fallback = createDefaultRenderText(rendererConfig?.processText, contentContext);
+ * const renderText: RenderText = (text) => {
+ *   if (isShortcode(text)) return <span>{text}</span>;
+ *   return fallback(text);
+ * };
+ */
+export function createDefaultRenderText(processText, contentContext) {
+    const composed = composeMetaProcessText(processText);
+    return (text) => {
+        if (contentContext) {
+            return composed(text, contentContext);
+        }
+        return convertText(text);
+    };
+}
+//# sourceMappingURL=createDefaultRenderText.js.map

package/dist/utils/createDefaultRenderText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDefaultRenderText.js","sourceRoot":"","sources":["../../src/utils/createDefaultRenderText.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,uBAAuB,CACrC,WAA2B,EAC3B,cAAgC;IAEhC,MAAM,QAAQ,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;IACrD,OAAO,CAAC,IAAY,EAAa,EAAE;QACjC,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAc,CAAC;QACrD,CAAC;QACD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,CAAC;AACJ,CAAC"}

package/dist/utils/errorHandling.d.ts

@@ -0,0 +1,37 @@
+import type { IBuildInformation } from './buildPageMetadata';
+interface ErrorContext {
+    type: 'page' | 'article' | 'metadata' | string;
+    params?: Record<string, unknown>;
+    preview?: boolean;
+    slug?: string;
+}
+/**
+ * Handles CMS-related errors with appropriate error display or Next.js notFound.
+ *
+ * In production, returns Next.js notFound() to show 404 page.
+ * In development, returns an error component with detailed error information.
+ *
+ * @param error - The error that occurred (any type)
+ * @param context - Error context (type, params, preview, slug)
+ * @param buildInformation - Build configuration (isProduction, etc.)
+ * @returns Next.js notFound() in production, or error component in development
+ *
+ * @example
+ * ```tsx
+ * import { handleCmsError } from '@se-studio/core-ui';
+ *
+ * try {
+ *   const page = await contentfulPageRest(config, slug);
+ *   if (!page) throw new Error('Page not found');
+ * } catch (error) {
+ *   return handleCmsError(error, {
+ *     type: 'page',
+ *     slug,
+ *     preview: false,
+ *   }, buildInfo);
+ * }
+ * ```
+ */
+export declare function handleCmsError(error: unknown, context: ErrorContext, buildInformation: IBuildInformation): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=errorHandling.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandling.d.ts","sourceRoot":"","sources":["../../src/utils/errorHandling.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,YAAY,EACrB,gBAAgB,EAAE,iBAAiB,+BA4BpC"}

package/dist/utils/errorHandling.js

@@ -0,0 +1,61 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { notFound } from 'next/navigation';
+import { CmsDataError } from '../components/CmsDataError';
+// Helper function to detect Next.js notFound errors
+function isNotFoundError(error) {
+    return (error instanceof Error &&
+        (error.message === 'NEXT_HTTP_ERROR_FALLBACK;404' ||
+            error.digest === 'NEXT_HTTP_ERROR_FALLBACK;404'));
+}
+/**
+ * Handles CMS-related errors with appropriate error display or Next.js notFound.
+ *
+ * In production, returns Next.js notFound() to show 404 page.
+ * In development, returns an error component with detailed error information.
+ *
+ * @param error - The error that occurred (any type)
+ * @param context - Error context (type, params, preview, slug)
+ * @param buildInformation - Build configuration (isProduction, etc.)
+ * @returns Next.js notFound() in production, or error component in development
+ *
+ * @example
+ * ```tsx
+ * import { handleCmsError } from '@se-studio/core-ui';
+ *
+ * try {
+ *   const page = await contentfulPageRest(config, slug);
+ *   if (!page) throw new Error('Page not found');
+ * } catch (error) {
+ *   return handleCmsError(error, {
+ *     type: 'page',
+ *     slug,
+ *     preview: false,
+ *   }, buildInfo);
+ * }
+ * ```
+ */
+export function handleCmsError(error, context, buildInformation) {
+    // Re-throw notFound errors so Next.js can handle them properly
+    if (isNotFoundError(error)) {
+        throw error;
+    }
+    // Add timestamp and default preview from buildInformation
+    const enhancedContext = {
+        ...context,
+        preview: context.preview ?? buildInformation.preview ?? false,
+        timestamp: new Date().toISOString(),
+    };
+    // Log error details
+    console.error('CMS Data Error:', {
+        error,
+        context: enhancedContext,
+        stack: error instanceof Error ? error.stack : undefined,
+    });
+    if (buildInformation.isProduction) {
+        // Send error to server for logging
+        return notFound();
+    }
+    // Return error component for non-production environments
+    return _jsx(CmsDataError, { error: error, context: enhancedContext });
+}
+//# sourceMappingURL=errorHandling.js.map

package/dist/utils/errorHandling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandling.js","sourceRoot":"","sources":["../../src/utils/errorHandling.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAU1D,oDAAoD;AACpD,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,CACL,KAAK,YAAY,KAAK;QACtB,CAAC,KAAK,CAAC,OAAO,KAAK,8BAA8B;YAC9C,KAA6B,CAAC,MAAM,KAAK,8BAA8B,CAAC,CAC5E,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAc,EACd,OAAqB,EACrB,gBAAmC;IAEnC,+DAA+D;IAC/D,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,KAAK,CAAC;IACd,CAAC;IAED,0DAA0D;IAC1D,MAAM,eAAe,GAAG;QACtB,GAAG,OAAO;QACV,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC,OAAO,IAAI,KAAK;QAC7D,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IAEF,oBAAoB;IACpB,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE;QAC/B,KAAK;QACL,OAAO,EAAE,eAAe;QACxB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;KACxD,CAAC,CAAC;IAEH,IAAI,gBAAgB,CAAC,YAAY,EAAE,CAAC;QAClC,mCAAmC;QACnC,OAAO,QAAQ,EAAE,CAAC;IACpB,CAAC;IAED,yDAAyD;IACzD,OAAO,KAAC,YAAY,IAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,GAAI,CAAC;AAClE,CAAC"}

package/dist/utils/errorMonitoring.d.ts

@@ -0,0 +1,17 @@
+interface ErrorContext {
+    componentStack?: string;
+    [key: string]: unknown;
+}
+interface ErrorReporter {
+    captureException(error: Error, context?: ErrorContext): void;
+}
+/**
+ * Initialize error monitoring with a custom reporter (e.g. Sentry, LogRocket)
+ */
+export declare function initErrorMonitoring(reporter: ErrorReporter): void;
+/**
+ * Capture an exception
+ */
+export declare function captureException(error: unknown, context?: ErrorContext): void;
+export {};
+//# sourceMappingURL=errorMonitoring.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errorMonitoring.d.ts","sourceRoot":"","sources":["../../src/utils/errorMonitoring.ts"],"names":[],"mappings":"AAAA,UAAU,YAAY;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,aAAa;IACrB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CAC9D;AAgBD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,QAE1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,QAGtE"}

package/dist/utils/errorMonitoring.js

@@ -0,0 +1,26 @@
+/**
+ * Default console reporter
+ */
+const consoleReporter = {
+    captureException(error, context) {
+        console.error('[ErrorMonitor] Exception captured:', error);
+        if (context) {
+            console.error('[ErrorMonitor] Context:', context);
+        }
+    },
+};
+let currentReporter = consoleReporter;
+/**
+ * Initialize error monitoring with a custom reporter (e.g. Sentry, LogRocket)
+ */
+export function initErrorMonitoring(reporter) {
+    currentReporter = reporter;
+}
+/**
+ * Capture an exception
+ */
+export function captureException(error, context) {
+    const err = error instanceof Error ? error : new Error(String(error));
+    currentReporter.captureException(err, context);
+}
+//# sourceMappingURL=errorMonitoring.js.map

package/dist/utils/errorMonitoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMonitoring.js","sourceRoot":"","sources":["../../src/utils/errorMonitoring.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,MAAM,eAAe,GAAkB;IACrC,gBAAgB,CAAC,KAAK,EAAE,OAAO;QAC7B,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;QAC3D,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,OAAO,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;CACF,CAAC;AAEF,IAAI,eAAe,GAAkB,eAAe,CAAC;AAErD;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAuB;IACzD,eAAe,GAAG,QAAQ,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc,EAAE,OAAsB;IACrE,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,eAAe,CAAC,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC"}

package/dist/utils/imageKitVideoHls.d.ts

@@ -0,0 +1,3 @@
+/** True when ImageKit HLS playback is enabled. MP4-only sites leave `IMAGEKIT_VIDEO_HLS` unset. */
+export declare function isImageKitHlsEnabled(): boolean;
+//# sourceMappingURL=imageKitVideoHls.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"imageKitVideoHls.d.ts","sourceRoot":"","sources":["../../src/utils/imageKitVideoHls.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C"}

package/dist/utils/imageKitVideoHls.js

@@ -0,0 +1,5 @@
+/** True when ImageKit HLS playback is enabled. MP4-only sites leave `IMAGEKIT_VIDEO_HLS` unset. */
+export function isImageKitHlsEnabled() {
+    return process.env.IMAGEKIT_VIDEO_HLS === 'true' || process.env.IMAGEKIT_VIDEO_HLS === '1';
+}
+//# sourceMappingURL=imageKitVideoHls.js.map

package/dist/utils/imageKitVideoHls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageKitVideoHls.js","sourceRoot":"","sources":["../../src/utils/imageKitVideoHls.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,MAAM,UAAU,oBAAoB;IAClC,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,GAAG,CAAC;AAC7F,CAAC"}

package/dist/utils/interpolateMetaText.d.ts

@@ -0,0 +1,9 @@
+import type { IContentContext, ProcessTextFn } from '@se-studio/core-data-types';
+/**
+ * Run `{{meta.*}}` interpolation then the site `processText` (e.g. `{{phone}}`).
+ * When no inner processor is provided, falls back to {@link convertText}.
+ */
+export declare function composeMetaProcessText(inner?: ProcessTextFn): ProcessTextFn;
+/** Interpolate `{{meta.*}}` using the current page context (no convertText). */
+export declare function interpolateMetaInText(text: string, contentContext?: IContentContext): string;
+//# sourceMappingURL=interpolateMetaText.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interpolateMetaText.d.ts","sourceRoot":"","sources":["../../src/utils/interpolateMetaText.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAIjF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,aAAa,CAS3E;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,eAAe,GAAG,MAAM,CAE5F"}