@se-studio/core-ui 1.0.45 → 1.0.47

package/dist/utils/componentUtils.d.ts

@@ -1,147 +1,40 @@
-import type { IBaseCollection, IBaseComponent, IPageContext } from '@se-studio/core-data-types';
-import type React from 'react';
-export type ArrayToUnion<T extends ReadonlyArray<unknown>> = T[number];
-/**
- * Since we've moved to non-generic base types, component utilities now work
- * with the base types directly. Projects can extend these base types with
- * additional properties and use type assertions at the component level.
- */
-export interface ComponentConfig<TAdditional = Record<string, unknown>> {
-    componentProps: ReadonlyArray<keyof IBaseComponent>;
-    contextProps: ReadonlyArray<keyof IPageContext>;
-    additionalProps?: TAdditional;
-}
-export interface CollectionConfig<TAdditional = Record<string, unknown>> {
-    collectionProps: ReadonlyArray<keyof IBaseCollection>;
-    contextProps: ReadonlyArray<keyof IPageContext>;
-    additionalProps?: TAdditional;
-}
-export type ComponentPropsFromConfig<T extends ComponentConfig> = T['componentProps'] extends ReadonlyArray<keyof IBaseComponent> ? Pick<IBaseComponent, ArrayToUnion<T['componentProps']>> : never;
-export type CollectionPropsFromConfig<T extends CollectionConfig> = T['collectionProps'] extends ReadonlyArray<keyof IBaseCollection> ? Pick<IBaseCollection, ArrayToUnion<T['collectionProps']>> : never;
-export type ContextPropsFromConfig<T extends ComponentConfig | CollectionConfig> = Pick<IPageContext, ArrayToUnion<T['contextProps']>>;
-export type GeneratePropsFromComponentConfig<T extends ComponentConfig> = ComponentPropsFromConfig<T> & ContextPropsFromConfig<T> & (T['additionalProps'] extends Record<string, unknown> ? T['additionalProps'] : Record<string, never>);
-export type GeneratePropsFromCollectionConfig<T extends CollectionConfig> = CollectionPropsFromConfig<T> & ContextPropsFromConfig<T> & (T['additionalProps'] extends Record<string, unknown> ? T['additionalProps'] : Record<string, never>);
-/**
- * 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 declare function extractComponentInfo<K extends keyof IBaseComponent>(information: IBaseComponent, keys: ReadonlyArray<K>): Pick<IBaseComponent, K>;
-/**
- * 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 declare function extractCollectionInfo<K extends keyof IBaseCollection>(information: IBaseCollection, keys: ReadonlyArray<K>): Pick<IBaseCollection, K>;
-/**
- * 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 declare function extractPageContext<K extends keyof IPageContext>(pageContext: IPageContext, keys: ReadonlyArray<K>): Pick<IPageContext, K>;
-/**
- * Helper type to create a component renderer function with specific prop requirements.
- * This provides better type safety when defining component renderers.
- *
- * @example
- * ```tsx
- * const config = {
- *   componentProps: ['heading', 'body', 'links'],
- *   contextProps: ['pageLink'],
- *   additionalProps: { theme: 'dark' as const }
- * } as const satisfies ComponentConfig;
- *
- * const MyComponent: ComponentRenderer<typeof config> = ({ heading, body, links, pageLink, theme }) => {
- *   // All props are properly typed
- *   return <div>{heading}</div>;
- * };
- * ```
- */
-export type ComponentRenderer<T extends ComponentConfig> = (props: GeneratePropsFromComponentConfig<T>) => React.ReactElement | null;
-/**
- * Helper type to create a collection renderer function with specific prop requirements.
- * This provides better type safety when defining collection renderers.
- *
- * @example
- * ```tsx
- * const config = {
- *   collectionProps: ['heading', 'body', 'contents'],
- *   contextProps: ['articleLink'],
- *   additionalProps: { layout: 'grid' as const }
- * } as const satisfies CollectionConfig;
- *
- * const MyCollection: CollectionRenderer<typeof config> = ({ heading, body, contents, articleLink, layout }) => {
- *   // All props are properly typed
- *   return <div>{heading}</div>;
- * };
- * ```
- */
-export type CollectionRenderer<T extends CollectionConfig> = (props: GeneratePropsFromCollectionConfig<T>) => React.ReactElement | null;
-/**
- * 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 declare function createComponentProps<T extends ComponentConfig>(config: T, information: IBaseComponent, pageContext: IPageContext, additionalProps?: T['additionalProps']): GeneratePropsFromComponentConfig<T>;
-/**
- * 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 declare function createCollectionProps<T extends CollectionConfig>(config: T, information: IBaseCollection, pageContext: IPageContext, additionalProps?: T['additionalProps']): GeneratePropsFromCollectionConfig<T>;
+import { type BaseConverterContext, type ContentfulConfig, type FetchOptions, type IContentfulCollection } from '@se-studio/contentful-rest-api';
+import { type BaseCollectionContent, type IArticleLink, type IContentContext, type IPersonLink } from '@se-studio/core-data-types';
+/**
+ * Generic helper to get related articles for a collection.
+ *
+ * This function orchestrates the fetching of related articles by:
+ * 1. Extracting hard-coded articles from collection contents
+ * 2. Extracting filter criteria from collection links (tags, article type)
+ * 3. Extracting fallback criteria from page context (article type, current article)
+ * 4. Fetching additional articles if needed to reach the requested count
+ * 5. Returning manual articles followed by fetched articles
+ *
+ * @param information - The collection information containing contents and links
+ * @param contentContext - The content context containing page context
+ * @param converterContext - The project-specific converter context (contains URL rules)
+ * @param config - Contentful configuration
+ * @param count - Maximum number of articles to return (optional)
+ * @param options - Optional fetch options for preview mode and caching
+ * @returns Array of article links (manual articles first, then fetched)
+ */
+export declare function getRelatedArticles<T extends BaseCollectionContent>(information: IContentfulCollection<T>, contentContext: IContentContext, converterContext: BaseConverterContext, config: ContentfulConfig, count: number | undefined, options: FetchOptions): Promise<IArticleLink[]>;
+/**
+ * Generic helper to get related people for a collection.
+ *
+ * This function orchestrates the fetching of related people by:
+ * 1. Extracting hard-coded people from collection contents
+ * 2. Fetching additional people if needed to reach the requested count
+ * 3. Excluding the current person (if on a person page) and manually added people
+ * 4. Returning manual people followed by fetched people
+ *
+ * @param information - The collection information containing contents
+ * @param contentContext - The content context containing page context
+ * @param converterContext - The project-specific converter context
+ * @param config - Contentful configuration
+ * @param count - Maximum number of people to return (default: 4)
+ * @param options - Optional fetch options for preview mode and caching
+ * @returns Array of person links (manual people first, then fetched)
+ */
+export declare function getRelatedPeople<T extends BaseCollectionContent>(information: IContentfulCollection<T>, contentContext: IContentContext, converterContext: BaseConverterContext, config: ContentfulConfig, count: number, options: FetchOptions): Promise<IPersonLink[]>;
 //# sourceMappingURL=componentUtils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"componentUtils.d.ts","sourceRoot":"","sources":["../../src/utils/componentUtils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"componentUtils.d.ts","sourceRoot":"","sources":["../../src/utils/componentUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EAGrB,KAAK,YAAY,EAEjB,KAAK,qBAAqB,EAE3B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EAEjB,KAAK,eAAe,EACpB,KAAK,WAAW,EAKjB,MAAM,4BAA4B,CAAC;AA8EpC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,SAAS,qBAAqB,EACtE,WAAW,EAAE,qBAAqB,CAAC,CAAC,CAAC,EACrC,cAAc,EAAE,eAAe,EAC/B,gBAAgB,EAAE,oBAAoB,EACtC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,YAAY,EAAE,CAAC,CA6CzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,qBAAqB,EACpE,WAAW,EAAE,qBAAqB,CAAC,CAAC,CAAC,EACrC,cAAc,EAAE,eAAe,EAC/B,gBAAgB,EAAE,oBAAoB,EACtC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,EAAE,CAAC,CAmCxB"}

package/dist/utils/componentUtils.js

@@ -1,126 +1,167 @@
+import { contentfulAllArticleLinks, contentfulAllPersonLinks, filterRelatedArticles, } from '@se-studio/contentful-rest-api';
+import { isArticleLink, isArticleTypeLink, isPersonLink, isTagLink, } from '@se-studio/core-data-types';
 /**
- * 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> }
- * ```
+ * Extract filter criteria (article types, tags, authors) from collection links.
+ * Internal helper for getRelatedArticles.
  */
-export function extractComponentInfo(information, keys) {
-    const result = {};
-    for (const key of keys) {
-        if (key in information) {
-            result[key] = information[key];
+function extractFilterCriteria(links) {
+    const articleTypeIds = [];
+    const tagIds = [];
+    const authorIds = [];
+    if (links) {
+        for (const link of links) {
+            if (isArticleTypeLink(link)) {
+                articleTypeIds.push(link.id);
+            }
+            else if (isTagLink(link)) {
+                tagIds.push(link.id);
+            }
+            else if (isPersonLink(link)) {
+                authorIds.push(link.id);
+            }
         }
     }
-    return result;
+    return { articleTypeIds, tagIds, authorIds };
 }
 /**
- * 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> }
- * ```
+ * Apply fallback criteria from page context when no explicit criteria provided.
+ * Internal helper for getRelatedArticles.
  */
-export function extractCollectionInfo(information, keys) {
-    const result = {};
-    for (const key of keys) {
-        if (key in information) {
-            result[key] = information[key];
+function applyFallbackCriteria(criteria, contentContext) {
+    if (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) {
+            criteria.authorIds.push(person.id);
         }
     }
-    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']);
- * ```
+ * Determine whether we should fetch additional articles.
+ * Internal helper for getRelatedArticles.
  */
-export function extractPageContext(pageContext, keys) {
-    const result = {};
-    for (const key of keys) {
-        if (key in pageContext) {
-            result[key] = pageContext[key];
-        }
+function shouldFetchArticles(isAll, remainingSlots, criteria) {
+    if (isAll) {
+        return true;
     }
-    return result;
+    const hasSlots = remainingSlots !== undefined && remainingSlots > 0;
+    const hasFilters = criteria.articleTypeIds.length > 0 ||
+        criteria.tagIds.length > 0 ||
+        criteria.authorIds.length > 0;
+    return hasSlots && hasFilters;
 }
 /**
- * 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.
+ * Generic helper to get related articles for a collection.
  *
- * @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
+ * This function orchestrates the fetching of related articles by:
+ * 1. Extracting hard-coded articles from collection contents
+ * 2. Extracting filter criteria from collection links (tags, article type)
+ * 3. Extracting fallback criteria from page context (article type, current article)
+ * 4. Fetching additional articles if needed to reach the requested count
+ * 5. Returning manual articles followed by fetched articles
  *
- * @example
- * ```tsx
- * const config = {
- *   componentProps: ['heading', 'body'],
- *   contextProps: ['pageLink'],
- * } as const;
- *
- * const props = createComponentProps(config, information, pageContext);
- * ```
+ * @param information - The collection information containing contents and links
+ * @param contentContext - The content context containing page context
+ * @param converterContext - The project-specific converter context (contains URL rules)
+ * @param config - Contentful configuration
+ * @param count - Maximum number of articles to return (optional)
+ * @param options - Optional fetch options for preview mode and caching
+ * @returns Array of article links (manual articles first, then fetched)
  */
-export function createComponentProps(config, information, pageContext, additionalProps) {
-    const componentProps = extractComponentInfo(information, config.componentProps);
-    const contextProps = extractPageContext(pageContext, config.contextProps);
-    return {
-        ...componentProps,
-        ...contextProps,
-        ...(additionalProps ?? {}),
-    };
+export async function getRelatedArticles(information, contentContext, converterContext, config, count, options) {
+    const isAll = typeof count === 'undefined';
+    // Step 1: Extract hard-coded articles from contents
+    const manualArticles = information.contents?.filter((item) => isArticleLink(item)) ?? [];
+    // Early return if we have enough manual articles
+    if (!isAll && count !== undefined && manualArticles.length >= count) {
+        return manualArticles.slice(0, count);
+    }
+    // Step 2: Extract and apply filter criteria
+    const criteria = extractFilterCriteria(information.links);
+    applyFallbackCriteria(criteria, contentContext);
+    // Step 3: Build exclusion list
+    const currentArticle = contentContext.pageContext?.article;
+    const excludeArticleIds = [
+        ...manualArticles.map((article) => article.id),
+        ...(currentArticle ? [currentArticle.id] : []),
+    ];
+    // Step 4: Fetch additional articles if needed
+    const remainingSlots = isAll || count === undefined ? undefined : count - manualArticles.length;
+    let fetchedArticles = [];
+    if (shouldFetchArticles(isAll, remainingSlots, criteria)) {
+        try {
+            const response = await contentfulAllArticleLinks(converterContext, config, options);
+            const filterOptions = {
+                excludeArticleIds,
+                tagIds: criteria.tagIds,
+                articleTypeIds: criteria.articleTypeIds,
+                authorIds: criteria.authorIds,
+                count: remainingSlots,
+            };
+            fetchedArticles = filterRelatedArticles(response.data, filterOptions);
+        }
+        catch (error) {
+            console.error('[getRelatedArticles] Error fetching articles:', error);
+        }
+    }
+    // Step 5: Return manual articles followed by fetched articles
+    return [...manualArticles, ...fetchedArticles].slice(0, count);
 }
 /**
- * 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.
+ * Generic helper to get related people for a collection.
  *
- * @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
+ * This function orchestrates the fetching of related people by:
+ * 1. Extracting hard-coded people from collection contents
+ * 2. Fetching additional people if needed to reach the requested count
+ * 3. Excluding the current person (if on a person page) and manually added people
+ * 4. Returning manual people followed by fetched people
  *
- * @example
- * ```tsx
- * const config = {
- *   collectionProps: ['heading', 'contents'],
- *   contextProps: ['articleLink'],
- * } as const;
- *
- * const props = createCollectionProps(config, information, pageContext);
- * ```
+ * @param information - The collection information containing contents
+ * @param contentContext - The content context containing page context
+ * @param converterContext - The project-specific converter context
+ * @param config - Contentful configuration
+ * @param count - Maximum number of people to return (default: 4)
+ * @param options - Optional fetch options for preview mode and caching
+ * @returns Array of person links (manual people first, then fetched)
  */
-export function createCollectionProps(config, information, pageContext, additionalProps) {
-    const collectionProps = extractCollectionInfo(information, config.collectionProps);
-    const contextProps = extractPageContext(pageContext, config.contextProps);
-    return {
-        ...collectionProps,
-        ...contextProps,
-        ...(additionalProps ?? {}),
-    };
+export async function getRelatedPeople(information, contentContext, converterContext, config, count, options) {
+    // Step 1: Extract hard-coded people from contents
+    const manualPeople = information.contents?.filter((item) => isPersonLink(item)) ?? [];
+    // Early return if we have enough manual people
+    if (manualPeople.length >= count) {
+        return manualPeople.slice(0, count);
+    }
+    // Step 2: Build exclusion list
+    const currentPerson = contentContext.pageContext?.person;
+    const excludePersonIds = new Set([
+        ...manualPeople.map((person) => person.id),
+        ...(currentPerson ? [currentPerson.id] : []),
+    ]);
+    // Step 3: Fetch additional people if needed
+    const remainingSlots = count - manualPeople.length;
+    let fetchedPeople = [];
+    try {
+        const response = await contentfulAllPersonLinks(converterContext, config, options);
+        // Filter out excluded people
+        fetchedPeople = response.data
+            .filter((person) => isPersonLink(person) && !excludePersonIds.has(person.id))
+            .slice(0, remainingSlots);
+    }
+    catch (error) {
+        console.error('[getRelatedPeople] Error fetching people:', error);
+    }
+    // Step 4: Return manual people followed by fetched people
+    return [...manualPeople, ...fetchedPeople].slice(0, count);
 }
 //# sourceMappingURL=componentUtils.js.map

package/dist/utils/componentUtils.js.map

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

package/dist/utils/urlUtils.d.ts

@@ -1,2 +1,7 @@
 export declare function isAbsoluteUrl(url: string): boolean;
+/**
+ * Utility function to get the current page URL safely.
+ * Returns an empty string when running on the server.
+ */
+export declare function getCurrentPageUrl(): string;
 //# sourceMappingURL=urlUtils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"urlUtils.d.ts","sourceRoot":"","sources":["../../src/utils/urlUtils.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOlD"}
+{"version":3,"file":"urlUtils.d.ts","sourceRoot":"","sources":["../../src/utils/urlUtils.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOlD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C"}

package/dist/utils/urlUtils.js

@@ -7,4 +7,14 @@ export function isAbsoluteUrl(url) {
         return false;
     }
 }
+/**
+ * Utility function to get the current page URL safely.
+ * Returns an empty string when running on the server.
+ */
+export function getCurrentPageUrl() {
+    if (typeof window !== 'undefined') {
+        return window.location.href;
+    }
+    return '';
+}
 //# sourceMappingURL=urlUtils.js.map

package/dist/utils/urlUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"urlUtils.js","sourceRoot":"","sources":["../../src/utils/urlUtils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"urlUtils.js","sourceRoot":"","sources":["../../src/utils/urlUtils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/core-ui",
-  "version": "1.0.45",
+  "version": "1.0.47",
   "description": "Shared React UI component library with Tailwind CSS v4 for SE Studio applications",
   "repository": {
     "type": "git",
@@ -18,7 +18,9 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "*.md",
+    "src/showcase/README.md"
   ],
   "keywords": [
     "react",
@@ -58,19 +60,20 @@
     "html-entities": "^2.6.0",
     "mustache": "4.2.0",
     "tailwind-merge": "^3.4.0",
-    "@se-studio/contentful-rest-api": "1.0.45",
-    "@se-studio/core-data-types": "1.0.45"
+    "@se-studio/contentful-rest-api": "1.0.47",
+    "@se-studio/core-data-types": "1.0.47"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.10",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.1",
-    "@types/node": "^24.10.4",
+    "@types/node": "^22.19.3",
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^5.1.2",
-    "jsdom": "^27.3.0",
+    "jsdom": "^27.4.0",
     "next": "^15.5.9",
+    "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^4.0.16"
   },