@se-studio/core-ui 1.0.14 → 1.0.15

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

package/dist/utils/UnusedChecker.js.map

@@ -1 +1 @@
-{"version":3,"file":"UnusedChecker.js","sourceRoot":"","sources":["../../src/utils/UnusedChecker.tsx"],"names":[],"mappings":";AAMA,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IACrC,eAAe;IACf,gBAAgB;IAChB,IAAI;IACJ,MAAM;IACN,MAAM;IACN,OAAO;IACP,aAAa;IACb,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,eAAe;IACf,kBAAkB;IAClB,YAAY;IACZ,YAAY;IACZ,UAAU;IACV,kBAAkB;IAClB,0BAA0B;CAC3B,CAAC,CAAC;AAOH,SAAS,eAAe,CACtB,SAAqB,EACrB,UAAwB,EACxB,uBAAqC;IAGrC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,sBAAsB,EAAE,GAAG,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAE/F,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;SAC/C,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;SAC5C,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;SAC1C,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,IAAI,CAAC;SACrE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAEzB,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,gBAAgB,CAAC;IACzD,OAAO,SAAS,CAAC;AACnB,CAAC;AAkCD,MAAM,CAAC,MAAM,aAAa,GAQtB,CAAC,EACH,QAAQ,EACR,aAAa,EACb,SAAS,EACT,UAAU,EACV,uBAAuB,EACvB,YAAY,GAAG,IAAI,GACpB,EAAE,EAAE;IAEH,IAAI,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,QAAQ,KAAK,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QAChG,OAAO,4BAAG,QAAQ,GAAI,CAAC;IACzB,CAAC;IAED,MAAM,YAAY,GAAG,eAAe,CAAC,SAAS,EAAE,UAAU,EAAE,uBAAuB,CAAC,CAAC;IAErF,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,CACL,8BACE,eACE,KAAK,EAAE;wBACL,eAAe,EAAE,QAAQ;wBACzB,OAAO,EAAE,MAAM;wBACf,MAAM,EAAE,QAAQ;qBACjB,aAED,aACE,KAAK,EAAE;gCACL,QAAQ,EAAE,MAAM;gCAChB,KAAK,EAAE,OAAO;gCACd,MAAM,EAAE,YAAY;6BACrB,mCAEkB,aAAa,IAC9B,EACJ,aAAG,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,gCACzC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IACrC,IACA,EACL,QAAQ,IACR,CACJ,CAAC;IACJ,CAAC;IAED,OAAO,4BAAG,QAAQ,GAAI,CAAC;AACzB,CAAC,CAAC;AAKF,OAAO,EAAE,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"UnusedChecker.js","sourceRoot":"","sources":["../../src/utils/UnusedChecker.tsx"],"names":[],"mappings":";AAEA;;;GAGG;AACH,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IACrC,eAAe;IACf,gBAAgB;IAChB,IAAI;IACJ,MAAM;IACN,MAAM;IACN,OAAO;IACP,aAAa;IACb,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,eAAe;IACf,kBAAkB;IAClB,YAAY;IACZ,YAAY;IACZ,UAAU;IACV,kBAAkB;IAClB,0BAA0B;CAC3B,CAAC,CAAC;AAIH;;GAEG;AACH,SAAS,eAAe,CACtB,SAAqB,EACrB,UAAwB,EACxB,uBAAqC;IAErC,2EAA2E;IAC3E,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,sBAAsB,EAAE,GAAG,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAE/F,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;SAC/C,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,6BAA6B;SAC1E,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,qBAAqB;SAChE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,mBAAmB;SACzF,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAEzB,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,gBAAgB,CAAC;IACzD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,CAAC,MAAM,aAAa,GAQtB,CAAC,EACH,QAAQ,EACR,aAAa,EACb,SAAS,EACT,UAAU,EACV,uBAAuB,EACvB,YAAY,GAAG,IAAI,GACpB,EAAE,EAAE;IACH,iCAAiC;IACjC,IAAI,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,QAAQ,KAAK,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QAChG,OAAO,4BAAG,QAAQ,GAAI,CAAC;IACzB,CAAC;IAED,MAAM,YAAY,GAAG,eAAe,CAAC,SAAS,EAAE,UAAU,EAAE,uBAAuB,CAAC,CAAC;IAErF,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,CACL,8BACE,eACE,KAAK,EAAE;wBACL,eAAe,EAAE,QAAQ;wBACzB,OAAO,EAAE,MAAM;wBACf,MAAM,EAAE,QAAQ;qBACjB,aAED,aACE,KAAK,EAAE;gCACL,QAAQ,EAAE,MAAM;gCAChB,KAAK,EAAE,OAAO;gCACd,MAAM,EAAE,YAAY;6BACrB,mCAEkB,aAAa,IAC9B,EACJ,aAAG,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,gCACzC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IACrC,IACA,EACL,QAAQ,IACR,CACJ,CAAC;IACJ,CAAC;IAED,OAAO,4BAAG,QAAQ,GAAI,CAAC;AACzB,CAAC,CAAC;AAEF;;GAEG;AACH,OAAO,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/utils/buildPageMetadata.d.ts

@@ -1,11 +1,56 @@
 import type { IBaseModel } from '@se-studio/core-data-types';
 import type { Metadata, ResolvingMetadata } from 'next';
+/**
+ * Configuration for building page metadata.
+ */
 export interface IBuildInformation {
+    /** Base URL for the site (e.g., 'https://example.com') */
     baseUrl: string;
+    /** Whether the site is in production mode */
     isProduction: boolean;
+    /** Whether the site is in development mode */
     isDevelopment: boolean;
+    /** Customer/client name for metadata */
     customerName: string;
+    /** Optional application name (defaults to customerName) */
     applicationName?: string;
 }
+/**
+ * Builds Next.js metadata object from CMS page model.
+ *
+ * Generates comprehensive SEO metadata including:
+ * - Title and description
+ * - Open Graph tags for social sharing
+ * - Twitter Card metadata
+ * - Canonical URL
+ * - Robots directives (index/follow based on production mode)
+ * - Featured image for OG/Twitter
+ *
+ * @param model - Page model from CMS (must include title, description, featuredImage, indexed)
+ * @param path - URL path for the page (e.g., '/about-us')
+ * @param buildInfo - Build configuration (baseUrl, environment flags, customer info)
+ * @param _parent - Next.js parent metadata resolver (unused, for API compatibility)
+ * @returns Next.js Metadata object ready for use in page metadata exports
+ *
+ * @example
+ * ```tsx
+ * import { buildPageMetadata } from '@se-studio/core-ui';
+ *
+ * export async function generateMetadata({ params }): Promise<Metadata> {
+ *   const page = await contentfulPageRest(config, params.slug);
+ *   return buildPageMetadata(
+ *     page,
+ *     `/${params.slug}`,
+ *     {
+ *       baseUrl: process.env.NEXT_PUBLIC_BASE_URL!,
+ *       isProduction: process.env.NODE_ENV === 'production',
+ *       isDevelopment: process.env.NODE_ENV === 'development',
+ *       customerName: 'My Company',
+ *     },
+ *     undefined
+ *   );
+ * }
+ * ```
+ */
 export declare function buildPageMetadata(model: Omit<IBaseModel, 'textColour' | 'backgroundColour'>, path: string, { baseUrl, isProduction, customerName, applicationName }: IBuildInformation, _parent: ResolvingMetadata): Metadata;
 //# sourceMappingURL=buildPageMetadata.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"buildPageMetadata.d.ts","sourceRoot":"","sources":["../../src/utils/buildPageMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,GAAG,kBAAkB,CAAC,EAC1D,IAAI,EAAE,MAAM,EACZ,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,EAAE,iBAAiB,EAC3E,OAAO,EAAE,iBAAiB,GACzB,QAAQ,CA8CV"}
+{"version":3,"file":"buildPageMetadata.d.ts","sourceRoot":"","sources":["../../src/utils/buildPageMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,YAAY,EAAE,OAAO,CAAC;IACtB,8CAA8C;IAC9C,aAAa,EAAE,OAAO,CAAC;IACvB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,GAAG,kBAAkB,CAAC,EAC1D,IAAI,EAAE,MAAM,EACZ,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,EAAE,iBAAiB,EAC3E,OAAO,EAAE,iBAAiB,GACzB,QAAQ,CA8CV"}

package/dist/utils/buildPageMetadata.js

@@ -1,3 +1,40 @@
+/**
+ * Builds Next.js metadata object from CMS page model.
+ *
+ * Generates comprehensive SEO metadata including:
+ * - Title and description
+ * - Open Graph tags for social sharing
+ * - Twitter Card metadata
+ * - Canonical URL
+ * - Robots directives (index/follow based on production mode)
+ * - Featured image for OG/Twitter
+ *
+ * @param model - Page model from CMS (must include title, description, featuredImage, indexed)
+ * @param path - URL path for the page (e.g., '/about-us')
+ * @param buildInfo - Build configuration (baseUrl, environment flags, customer info)
+ * @param _parent - Next.js parent metadata resolver (unused, for API compatibility)
+ * @returns Next.js Metadata object ready for use in page metadata exports
+ *
+ * @example
+ * ```tsx
+ * import { buildPageMetadata } from '@se-studio/core-ui';
+ *
+ * export async function generateMetadata({ params }): Promise<Metadata> {
+ *   const page = await contentfulPageRest(config, params.slug);
+ *   return buildPageMetadata(
+ *     page,
+ *     `/${params.slug}`,
+ *     {
+ *       baseUrl: process.env.NEXT_PUBLIC_BASE_URL!,
+ *       isProduction: process.env.NODE_ENV === 'production',
+ *       isDevelopment: process.env.NODE_ENV === 'development',
+ *       customerName: 'My Company',
+ *     },
+ *     undefined
+ *   );
+ * }
+ * ```
+ */
 export function buildPageMetadata(model, path, { baseUrl, isProduction, customerName, applicationName }, _parent) {
     const { title, description, featuredImage } = model;
     const indexed = isProduction ? model.indexed : false;

package/dist/utils/buildPageMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildPageMetadata.js","sourceRoot":"","sources":["../../src/utils/buildPageMetadata.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,iBAAiB,CAC/B,KAA0D,EAC1D,IAAY,EACZ,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAqB,EAC3E,OAA0B;IAE1B,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IACpD,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAErD,MAAM,eAAe,GAAG,aAAa,EAAE,EAAE,CAAC;IAC1C,MAAM,iBAAiB,GAAG,eAAe,CAAC,CAAC,CAAC,OAAO,eAAe,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAErF,MAAM,MAAM,GAAa;QACvB,YAAY,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC;QAC9B,eAAe,EAAE,eAAe,IAAI,YAAY;QAChD,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE;YACpC,EAAE,IAAI,EAAE,gBAAgB,EAAE,GAAG,EAAE,uBAAuB,EAAE;SACzD;QACD,WAAW,EAAE;YACX,KAAK,EAAE,eAAe,IAAI,YAAY;SACvC;QACD,UAAU,EAAE;YACV,SAAS,EAAE,IAAI;SAChB;QACD,MAAM,EAAE;YACN,KAAK,EAAE,OAAO,IAAI,KAAK;YACvB,MAAM,EAAE,OAAO,IAAI,KAAK;SACzB;QACD,KAAK;QACL,WAAW;QACX,OAAO,EAAE;YACP,IAAI,EAAE,qBAAqB;YAC3B,KAAK;YACL,WAAW,EAAE,WAAW,IAAI,SAAS;YACrC,MAAM,EAAE,iBAAiB;SAC1B;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,GAAG,EAAE,IAAI;YACT,KAAK;YACL,WAAW,EAAE,WAAW,IAAI,SAAS;YACrC,MAAM,EAAE,iBAAiB;SAC1B;QACD,KAAK,EAAE;YACL,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,YAAY;SAC7C;KACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"buildPageMetadata.js","sourceRoot":"","sources":["../../src/utils/buildPageMetadata.ts"],"names":[],"mappings":"AAmBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAA0D,EAC1D,IAAY,EACZ,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAqB,EAC3E,OAA0B;IAE1B,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IACpD,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAErD,MAAM,eAAe,GAAG,aAAa,EAAE,EAAE,CAAC;IAC1C,MAAM,iBAAiB,GAAG,eAAe,CAAC,CAAC,CAAC,OAAO,eAAe,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAErF,MAAM,MAAM,GAAa;QACvB,YAAY,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC;QAC9B,eAAe,EAAE,eAAe,IAAI,YAAY;QAChD,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE;YACpC,EAAE,IAAI,EAAE,gBAAgB,EAAE,GAAG,EAAE,uBAAuB,EAAE;SACzD;QACD,WAAW,EAAE;YACX,KAAK,EAAE,eAAe,IAAI,YAAY;SACvC;QACD,UAAU,EAAE;YACV,SAAS,EAAE,IAAI;SAChB;QACD,MAAM,EAAE;YACN,KAAK,EAAE,OAAO,IAAI,KAAK;YACvB,MAAM,EAAE,OAAO,IAAI,KAAK;SACzB;QACD,KAAK;QACL,WAAW;QACX,OAAO,EAAE;YACP,IAAI,EAAE,qBAAqB;YAC3B,KAAK;YACL,WAAW,EAAE,WAAW,IAAI,SAAS;YACrC,MAAM,EAAE,iBAAiB;SAC1B;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,GAAG,EAAE,IAAI;YACT,KAAK;YACL,WAAW,EAAE,WAAW,IAAI,SAAS;YACrC,MAAM,EAAE,iBAAiB;SAC1B;QACD,KAAK,EAAE;YACL,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,YAAY;SAC7C;KACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/cn.d.ts

@@ -1,3 +1,29 @@
 import { type ClassValue } from 'clsx';
+/**
+ * Utility function for merging Tailwind CSS classes.
+ *
+ * Combines clsx for conditional class names with tailwind-merge to intelligently
+ * merge Tailwind classes, resolving conflicts by keeping the last conflicting class.
+ *
+ * @param inputs - Variable number of class name inputs (strings, objects, arrays)
+ * @returns Merged class name string
+ *
+ * @example
+ * ```tsx
+ * import { cn } from '@se-studio/core-ui';
+ *
+ * // Basic usage
+ * cn('text-lg', 'font-bold') // 'text-lg font-bold'
+ *
+ * // Conditional classes
+ * cn('text-lg', isActive && 'text-blue-500') // 'text-lg text-blue-500' or 'text-lg'
+ *
+ * // Resolving conflicts
+ * cn('text-lg', 'text-sm') // 'text-sm' (last one wins)
+ *
+ * // With Tailwind classes
+ * cn('p-4', 'p-2') // 'p-2' (conflict resolved)
+ * ```
+ */
 export declare function cn(...inputs: ClassValue[]): string;
 //# sourceMappingURL=cn.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"cn.d.ts","sourceRoot":"","sources":["../../src/utils/cn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,MAAM,CAAC;AAG7C,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC"}
+{"version":3,"file":"cn.d.ts","sourceRoot":"","sources":["../../src/utils/cn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,MAAM,CAAC;AAG7C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC"}

package/dist/utils/cn.js

@@ -1,5 +1,31 @@
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
+/**
+ * Utility function for merging Tailwind CSS classes.
+ *
+ * Combines clsx for conditional class names with tailwind-merge to intelligently
+ * merge Tailwind classes, resolving conflicts by keeping the last conflicting class.
+ *
+ * @param inputs - Variable number of class name inputs (strings, objects, arrays)
+ * @returns Merged class name string
+ *
+ * @example
+ * ```tsx
+ * import { cn } from '@se-studio/core-ui';
+ *
+ * // Basic usage
+ * cn('text-lg', 'font-bold') // 'text-lg font-bold'
+ *
+ * // Conditional classes
+ * cn('text-lg', isActive && 'text-blue-500') // 'text-lg text-blue-500' or 'text-lg'
+ *
+ * // Resolving conflicts
+ * cn('text-lg', 'text-sm') // 'text-sm' (last one wins)
+ *
+ * // With Tailwind classes
+ * cn('p-4', 'p-2') // 'p-2' (conflict resolved)
+ * ```
+ */
 export function cn(...inputs) {
     return twMerge(clsx(inputs));
 }

package/dist/utils/cn.js.map

@@ -1 +1 @@
-{"version":3,"file":"cn.js","sourceRoot":"","sources":["../../src/utils/cn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,IAAI,EAAE,MAAM,MAAM,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,MAAM,UAAU,EAAE,CAAC,GAAG,MAAoB;IACxC,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"cn.js","sourceRoot":"","sources":["../../src/utils/cn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,IAAI,EAAE,MAAM,MAAM,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,EAAE,CAAC,GAAG,MAAoB;IACxC,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/B,CAAC"}