@se-studio/core-ui 1.0.13 → 1.0.15

package/dist/utils/componentUtils.js

@@ -1,3 +1,17 @@
+/**
+ * Extract specific component information fields that a component needs.
+ * This is used when you only need a subset of the component fields.
+ *
+ * @param information - The full component information object
+ * @param keys - Array of keys to extract from the information object
+ * @returns Object with only the specified keys
+ *
+ * @example
+ * ```tsx
+ * const props = extractComponentInfo(information, ['heading', 'body', 'links']);
+ * // props will have type { heading?: string | null, body?: unknown, links?: ReadonlyArray<ILinkProps> }
+ * ```
+ */
 export function extractComponentInfo(information, keys) {
     const result = {};
     for (const key of keys) {
@@ -7,6 +21,20 @@ export function extractComponentInfo(information, keys) {
     }
     return result;
 }
+/**
+ * Extract specific collection information fields that a collection needs.
+ * This is used when you only need a subset of the collection fields.
+ *
+ * @param information - The full collection information object
+ * @param keys - Array of keys to extract from the information object
+ * @returns Object with only the specified keys
+ *
+ * @example
+ * ```tsx
+ * const props = extractCollectionInfo(information, ['heading', 'body', 'contents']);
+ * // props will have type { heading?: string | null, body?: unknown, contents?: ReadonlyArray<CollectionContent> }
+ * ```
+ */
 export function extractCollectionInfo(information, keys) {
     const result = {};
     for (const key of keys) {
@@ -16,6 +44,18 @@ export function extractCollectionInfo(information, keys) {
     }
     return result;
 }
+/**
+ * Extract specific page context fields that a component needs.
+ *
+ * @param pageContext - The full page context object
+ * @param keys - Array of keys to extract from the page context
+ * @returns Object with only the specified keys
+ *
+ * @example
+ * ```tsx
+ * const contextProps = extractPageContext(pageContext, ['articleLink', 'pageLink']);
+ * ```
+ */
 export function extractPageContext(pageContext, keys) {
     const result = {};
     for (const key of keys) {
@@ -25,6 +65,26 @@ export function extractPageContext(pageContext, keys) {
     }
     return result;
 }
+/**
+ * Create props object for a component renderer from component information and page context.
+ * This function extracts the specified fields and combines them with additional props.
+ *
+ * @param config - Configuration specifying which props to extract
+ * @param information - The component information object
+ * @param pageContext - The page context object
+ * @param additionalProps - Additional props to include (optional)
+ * @returns Combined props object ready to pass to the component
+ *
+ * @example
+ * ```tsx
+ * const config = {
+ *   componentProps: ['heading', 'body'],
+ *   contextProps: ['pageLink'],
+ * } as const;
+ *
+ * const props = createComponentProps(config, information, pageContext);
+ * ```
+ */
 export function createComponentProps(config, information, pageContext, additionalProps) {
     const componentProps = extractComponentInfo(information, config.componentProps);
     const contextProps = extractPageContext(pageContext, config.contextProps);
@@ -34,6 +94,26 @@ export function createComponentProps(config, information, pageContext, additiona
         ...(additionalProps ?? {}),
     };
 }
+/**
+ * Create props object for a collection renderer from collection information and page context.
+ * This function extracts the specified fields and combines them with additional props.
+ *
+ * @param config - Configuration specifying which props to extract
+ * @param information - The collection information object
+ * @param pageContext - The page context object
+ * @param additionalProps - Additional props to include (optional)
+ * @returns Combined props object ready to pass to the collection
+ *
+ * @example
+ * ```tsx
+ * const config = {
+ *   collectionProps: ['heading', 'contents'],
+ *   contextProps: ['articleLink'],
+ * } as const;
+ *
+ * const props = createCollectionProps(config, information, pageContext);
+ * ```
+ */
 export function createCollectionProps(config, information, pageContext, additionalProps) {
     const collectionProps = extractCollectionInfo(information, config.collectionProps);
     const contextProps = extractPageContext(pageContext, config.contextProps);

package/dist/utils/componentUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"componentUtils.js","sourceRoot":"","sources":["../../src/utils/componentUtils.ts"],"names":[],"mappings":"AAgFA,MAAM,UAAU,oBAAoB,CAClC,WAA2B,EAC3B,IAAsB;IAEtB,MAAM,MAAM,GAAG,EAA6B,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAgBD,MAAM,UAAU,qBAAqB,CACnC,WAA4B,EAC5B,IAAsB;IAEtB,MAAM,MAAM,GAAG,EAA8B,CAAC;IAC9C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAcD,MAAM,UAAU,kBAAkB,CAChC,WAAyB,EACzB,IAAsB;IAEtB,MAAM,MAAM,GAAG,EAA2B,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAkED,MAAM,UAAU,oBAAoB,CAClC,MAAS,EACT,WAA2B,EAC3B,WAAyB,EACzB,eAAsC;IAEtC,MAAM,cAAc,GAAG,oBAAoB,CAAC,WAAW,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;IAChF,MAAM,YAAY,GAAG,kBAAkB,CAAC,WAAW,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IAE1E,OAAO;QACL,GAAG,cAAc;QACjB,GAAG,YAAY;QACf,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC;KACuB,CAAC;AACtD,CAAC;AAsBD,MAAM,UAAU,qBAAqB,CACnC,MAAS,EACT,WAA4B,EAC5B,WAAyB,EACzB,eAAsC;IAEtC,MAAM,eAAe,GAAG,qBAAqB,CAAC,WAAW,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;IACnF,MAAM,YAAY,GAAG,kBAAkB,CAAC,WAAW,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IAE1E,OAAO;QACL,GAAG,eAAe;QAClB,GAAG,YAAY;QACf,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC;KACwB,CAAC;AACvD,CAAC"}
+{"version":3,"file":"componentUtils.js","sourceRoot":"","sources":["../../src/utils/componentUtils.ts"],"names":[],"mappings":"AAkEA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAA2B,EAC3B,IAAsB;IAEtB,MAAM,MAAM,GAAG,EAA6B,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAA4B,EAC5B,IAAsB;IAEtB,MAAM,MAAM,GAAG,EAA8B,CAAC;IAC9C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAChC,WAAyB,EACzB,IAAsB;IAEtB,MAAM,MAAM,GAAG,EAA2B,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AA8CD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAS,EACT,WAA2B,EAC3B,WAAyB,EACzB,eAAsC;IAEtC,MAAM,cAAc,GAAG,oBAAoB,CAAC,WAAW,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;IAChF,MAAM,YAAY,GAAG,kBAAkB,CAAC,WAAW,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IAE1E,OAAO;QACL,GAAG,cAAc;QACjB,GAAG,YAAY;QACf,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC;KACuB,CAAC;AACtD,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAS,EACT,WAA4B,EAC5B,WAAyB,EACzB,eAAsC;IAEtC,MAAM,eAAe,GAAG,qBAAqB,CAAC,WAAW,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;IACnF,MAAM,YAAY,GAAG,kBAAkB,CAAC,WAAW,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IAE1E,OAAO;QACL,GAAG,eAAe;QAClB,GAAG,YAAY;QACf,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC;KACwB,CAAC;AACvD,CAAC"}

package/dist/utils/convertText.js

@@ -3,6 +3,8 @@ 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) {
@@ -18,14 +20,20 @@ export function convertText(text) {
                 if (special === undefined) {
                     return part;
                 }
-                return (_jsx("span", { className: special, children: part }, i));
+                return (
+                // biome-ignore lint/suspicious/noArrayIndexKey: Index is ok here
+                _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)));
+        const mapped = split.map((s, index) => (
+        // biome-ignore lint/suspicious/noArrayIndexKey: Index is ok here
+        _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 ? (
+                    // biome-ignore lint/suspicious/noArrayIndexKey: Index is ok here
+                    _jsx("span", { className: specialChars[part], children: part }, i)) : (part)) })] }, index)));
         return mapped;
     }
     return undefined;

package/dist/utils/convertText.js.map

@@ -1 +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;CAGhC,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"}
+{"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;gBACL,iEAAiE;gBACjE,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;QACrC,iEAAiE;QACjE,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;oBACjC,iEAAiE;oBACjE,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/errorHandling.d.ts

@@ -5,6 +5,33 @@ interface ErrorContext {
     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-runtime").JSX.Element;
 export {};
 //# sourceMappingURL=errorHandling.d.ts.map

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

@@ -1 +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,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,YAAY,EACrB,gBAAgB,EAAE,iBAAiB,2CA2BpC"}
+{"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,2CA2BpC"}

package/dist/utils/errorHandling.js

@@ -1,27 +1,60 @@
 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 to context
     const enhancedContext = {
         ...context,
         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

@@ -1 +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;AAW1D,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,MAAM,UAAU,cAAc,CAC5B,KAAc,EACd,OAAqB,EACrB,gBAAmC;IAGnC,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,KAAK,CAAC;IACd,CAAC;IAGD,MAAM,eAAe,GAAG;QACtB,GAAG,OAAO;QACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IAGF,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;QAElC,OAAO,QAAQ,EAAE,CAAC;IACpB,CAAC;IAGD,OAAO,KAAC,YAAY,IAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,GAAI,CAAC;AAClE,CAAC"}
+{"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,2BAA2B;IAC3B,MAAM,eAAe,GAAG;QACtB,GAAG,OAAO;QACV,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/previewUtils.js

@@ -1,3 +1,5 @@
+// Contentful preview utilities
+// These utilities help with Contentful live preview by adding data attributes
 export function getPreviewProps({ entryId, assetId, fieldId, }, draftOnly) {
     if (!draftOnly)
         return undefined;

package/dist/utils/previewUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"previewUtils.js","sourceRoot":"","sources":["../../src/utils/previewUtils.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,eAAe,CAC7B,EACE,OAAO,EACP,OAAO,EACP,OAAO,GAKR,EACD,SAAkB;IAElB,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IAEjC,OAAO;QACL,0BAA0B,EAAE,OAAO;QACnC,0BAA0B,EAAE,OAAO;QACnC,0BAA0B,EAAE,OAAO;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,EAAW,EAAE,OAAgB,EAAE,SAAS,GAAG,KAAK;IACrF,OAAO,eAAe,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAgB,EAAE,SAAS,GAAG,KAAK;IACxE,OAAO,eAAe,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,WAAwC,EAAE,SAAS,GAAG,KAAK;IAC/F,IAAI,CAAC,WAAW;QAAE,OAAO,SAAS,CAAC;IACnC,OAAO,eAAe,CACpB;QACE,OAAO,EAAE,WAAW,CAAC,QAAQ;QAC7B,OAAO,EAAE,WAAW,CAAC,aAAa;KACnC,EACD,SAAS,CACV,CAAC;AACJ,CAAC"}
+{"version":3,"file":"previewUtils.js","sourceRoot":"","sources":["../../src/utils/previewUtils.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,8EAA8E;AAO9E,MAAM,UAAU,eAAe,CAC7B,EACE,OAAO,EACP,OAAO,EACP,OAAO,GAKR,EACD,SAAkB;IAElB,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IAEjC,OAAO;QACL,0BAA0B,EAAE,OAAO;QACnC,0BAA0B,EAAE,OAAO;QACnC,0BAA0B,EAAE,OAAO;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,EAAW,EAAE,OAAgB,EAAE,SAAS,GAAG,KAAK;IACrF,OAAO,eAAe,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAgB,EAAE,SAAS,GAAG,KAAK;IACxE,OAAO,eAAe,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,WAAwC,EAAE,SAAS,GAAG,KAAK;IAC/F,IAAI,CAAC,WAAW;QAAE,OAAO,SAAS,CAAC;IACnC,OAAO,eAAe,CACpB;QACE,OAAO,EAAE,WAAW,CAAC,QAAQ;QAC7B,OAAO,EAAE,WAAW,CAAC,aAAa;KACnC,EACD,SAAS,CACV,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/core-ui",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "Shared React UI component library with Tailwind CSS v4 for SE Studio applications",
   "repository": {
     "type": "git",
@@ -25,38 +25,52 @@
     "components",
     "ui",
     "tailwind",
+    "tailwindcss",
     "design-system",
-    "typescript"
+    "typescript",
+    "contentful",
+    "cms",
+    "nextjs",
+    "next.js",
+    "ui-library",
+    "component-library",
+    "rich-text",
+    "analytics"
   ],
+  "homepage": "https://github.com/Something-Else-Studio/se-core-product#readme",
+  "bugs": {
+    "url": "https://github.com/Something-Else-Studio/se-core-product/issues"
+  },
   "peerDependencies": {
     "next": "^15.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "dependencies": {
-    "@contentful/live-preview": "^4.6.57",
+    "@contentful/live-preview": "^4.7.0",
     "@contentful/rich-text-react-renderer": "^16.1.6",
     "@contentful/rich-text-types": "^17.2.5",
     "@extractus/oembed-extractor": "^4.0.9",
+    "@radix-ui/react-slot": "^1.2.4",
     "change-case": "^5.4.4",
     "clsx": "^2.1.1",
     "html-entities": "^2.6.0",
     "tailwind-merge": "^3.4.0",
-    "@se-studio/contentful-rest-api": "1.0.13",
-    "@se-studio/core-data-types": "1.0.13"
+    "@se-studio/contentful-rest-api": "1.0.15",
+    "@se-studio/core-data-types": "1.0.15"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.3.6",
+    "@biomejs/biome": "^2.3.7",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.0",
     "@types/node": "^24.10.1",
-    "@types/react": "^19.2.6",
+    "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^5.1.1",
     "jsdom": "^27.2.0",
     "next": "^15.5.6",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.12"
+    "vitest": "^4.0.14"
   },
   "scripts": {
     "build": "tsc --project tsconfig.build.json",

package/dist/elements/UtmLinkOrDiv.d.ts

@@ -1,5 +0,0 @@
-import type { LinkProps } from 'next/link';
-import type React from 'react';
-import type { PropsWithChildren } from 'react';
-export declare const UtmLinkOrDiv: React.FC<PropsWithChildren<Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, keyof LinkProps<Record<string, unknown>>> & Omit<LinkProps<Record<string, unknown>>, 'href'> & Partial<Pick<LinkProps<Record<string, unknown>>, 'href'>> & React.RefAttributes<HTMLAnchorElement>>>;
-//# sourceMappingURL=UtmLinkOrDiv.d.ts.map

package/dist/elements/UtmLinkOrDiv.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"UtmLinkOrDiv.d.ts","sourceRoot":"","sources":["../../src/elements/UtmLinkOrDiv.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAG/C,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CACjC,iBAAiB,CACf,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,MAAM,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAC3F,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,GAChD,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GACzD,KAAK,CAAC,aAAa,CAAC,iBAAiB,CAAC,CACzC,CAcF,CAAC"}

package/dist/elements/UtmLinkOrDiv.js

@@ -1,9 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { UtmLink } from './UtmLink';
-export const UtmLinkOrDiv = ({ href, className, style, children, ...props }) => {
-    if (href) {
-        return (_jsx(UtmLink, { href: href, className: className, style: style, ...props, children: children }));
-    }
-    return (_jsx("div", { className: className, style: style, children: children }));
-};
-//# sourceMappingURL=UtmLinkOrDiv.js.map

package/dist/elements/UtmLinkOrDiv.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"UtmLinkOrDiv.js","sourceRoot":"","sources":["../../src/elements/UtmLinkOrDiv.tsx"],"names":[],"mappings":";AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,CAAC,MAAM,YAAY,GAOrB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE;IACrD,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CACL,KAAC,OAAO,IAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,KAAM,KAAK,YAC/D,QAAQ,GACD,CACX,CAAC;IACJ,CAAC;IACD,OAAO,CACL,cAAK,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,YACpC,QAAQ,GACL,CACP,CAAC;AACJ,CAAC,CAAC"}