@se-studio/core-ui 1.0.45 → 1.0.46

package/README.md

@@ -397,17 +397,12 @@ const previewConfig = mergeCmsRendererConfig(
 #### Utilities
 - **`buildPageMetadata`** - Generates Next.js metadata object from CMS page model
 - **`handleCmsError`** - Error handling utility for CMS operations
-- **`extractComponentInfo`** - Extract specific component information fields
-- **`extractCollectionInfo`** - Extract specific collection information fields
-- **`extractPageContext`** - Extract specific page context fields
+- **`getRelatedArticles`** - Utility to fetch related articles for collections
+- **`getRelatedPeople`** - Utility to fetch related people for collections
 - **`cn`** - Utility function for merging Tailwind CSS classes
 
 #### Types
 - **`CmsRendererConfig`** - Complete renderer configuration type
-- **`ComponentRenderer<T>`** - Type for component renderer functions
-- **`CollectionRenderer<T>`** - Type for collection renderer functions
-- **`ComponentConfig<T>`** - Type-safe component configuration
-- **`CollectionConfig<T>`** - Type-safe collection configuration
 
 For detailed JSDoc documentation on all exports, see the TypeScript declaration files (`.d.ts`) in the package.
 
@@ -417,7 +412,6 @@ For advanced CMS infrastructure usage, including:
 - Configuration composition patterns
 - Embeddable components
 - Context passing
-- Type-safe prop extraction
 - Preview mode setup
 
 See the [CMS Infrastructure Guide](./CMS_INFRASTRUCTURE.md).

package/dist/index.d.ts

@@ -67,10 +67,9 @@ export { default as ResponsiveVisual } from './framework/ResponsiveVisual';
 export { useClickTracking } from './hooks/useClickTracking';
 export { RTF } from './rtf/rtf';
 export type { IBuildInformation } from './utils/buildPageMetadata';
-export { buildPageMetadata } from './utils/buildPageMetadata';
+export { buildPageMetadata, calculateTitleAndDescription } from './utils/buildPageMetadata';
 export { cn } from './utils/cn';
-export type { ArrayToUnion, CollectionConfig, CollectionPropsFromConfig, ComponentConfig, ComponentPropsFromConfig, ContextPropsFromConfig, GeneratePropsFromCollectionConfig, GeneratePropsFromComponentConfig, } from './utils/componentUtils';
-export { createCollectionProps, createComponentProps, extractCollectionInfo, extractComponentInfo, extractPageContext, } from './utils/componentUtils';
+export { getRelatedArticles, getRelatedPeople, } from './utils/componentUtils';
 export { convertText } from './utils/convertText';
 export { handleCmsError } from './utils/errorHandling';
 export { captureException, initErrorMonitoring } from './utils/errorMonitoring';
@@ -84,7 +83,7 @@ export type { StructuredDataConfig, StructuredDataContext } from './utils/struct
 export { buildStructuredDataContext } from './utils/structuredDataUtils';
 export { UnsupportedWarning } from './utils/UnsupportedWarning';
 export { DEFAULT_ALLOWED_UNUSED, UnusedChecker } from './utils/UnusedChecker';
-export { isAbsoluteUrl } from './utils/urlUtils';
+export { getCurrentPageUrl, isAbsoluteUrl } from './utils/urlUtils';
 export { calculateHorizontalPositionClassName } from './utils/visualPositions';
 export { calculateVisualSizes } from './utils/visualSizes';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -66,10 +66,10 @@ export { default as ResponsiveVisual } from './framework/ResponsiveVisual';
 // Shared Hooks
 export { useClickTracking } from './hooks/useClickTracking';
 export { RTF } from './rtf/rtf';
-export { buildPageMetadata } from './utils/buildPageMetadata';
+export { buildPageMetadata, calculateTitleAndDescription } from './utils/buildPageMetadata';
 // Shared Utilities
 export { cn } from './utils/cn';
-export { createCollectionProps, createComponentProps, extractCollectionInfo, extractComponentInfo, extractPageContext, } from './utils/componentUtils';
+export { getRelatedArticles, getRelatedPeople, } from './utils/componentUtils';
 export { convertText } from './utils/convertText';
 export { handleCmsError } from './utils/errorHandling';
 export { captureException, initErrorMonitoring } from './utils/errorMonitoring';
@@ -80,7 +80,7 @@ export { buildStructuredDataContext } from './utils/structuredDataUtils';
 export { UnsupportedWarning } from './utils/UnsupportedWarning';
 // Development Utilities
 export { DEFAULT_ALLOWED_UNUSED, UnusedChecker } from './utils/UnusedChecker';
-export { isAbsoluteUrl } from './utils/urlUtils';
+export { getCurrentPageUrl, isAbsoluteUrl } from './utils/urlUtils';
 export { calculateHorizontalPositionClassName } from './utils/visualPositions';
 export { calculateVisualSizes } from './utils/visualSizes';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/utils/buildPageMetadata.d.ts

@@ -1,4 +1,4 @@
-import type { IBaseModel } from '@se-studio/core-data-types';
+import type { IBaseArticle, IBaseArticleType, IBaseCustomType, IBaseModel, IBaseTag } from '@se-studio/core-data-types';
 import type { Metadata, ResolvingMetadata } from 'next';
 /**
  * Configuration for building page metadata.
@@ -57,4 +57,23 @@ export interface IBuildInformation {
  * ```
  */
 export declare function buildPageMetadata(model: Pick<IBaseModel, 'title' | 'description' | 'featuredImage' | 'indexed'>, path: string, { baseUrl, isProduction, customerName, applicationName }: IBuildInformation, _parent: ResolvingMetadata): Metadata;
+/**
+ * Utility function to calculate title and description for various content types.
+ *
+ * This provides a standard way to generate SEO text for resource index pages,
+ * topic pages, and individual articles. Projects can use this in their
+ * metadata generation logic.
+ *
+ * @param params - Objects representing the context (article, tag, articleType, customType)
+ * @returns Object with title and description strings
+ */
+export declare function calculateTitleAndDescription({ articleType, customType, tag, article, }: {
+    articleType?: IBaseArticleType;
+    customType?: IBaseCustomType;
+    tag?: IBaseTag;
+    article?: IBaseArticle;
+}): {
+    title: string;
+    description: string;
+};
 //# 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;;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;IACzB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,aAAa,GAAG,eAAe,GAAG,SAAS,CAAC,EAC9E,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,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,QAAQ,EACT,MAAM,4BAA4B,CAAC;AACpC,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;IACzB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,aAAa,GAAG,eAAe,GAAG,SAAS,CAAC,EAC9E,IAAI,EAAE,MAAM,EACZ,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,EAAE,iBAAiB,EAC3E,OAAO,EAAE,iBAAiB,GACzB,QAAQ,CA8CV;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAAC,EAC3C,WAAW,EACX,UAAU,EACV,GAAG,EACH,OAAO,GACR,EAAE;IACD,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;;;EA0BA"}

package/dist/utils/buildPageMetadata.js

@@ -79,4 +79,41 @@ export function buildPageMetadata(model, path, { baseUrl, isProduction, customer
     };
     return result;
 }
+/**
+ * Utility function to calculate title and description for various content types.
+ *
+ * This provides a standard way to generate SEO text for resource index pages,
+ * topic pages, and individual articles. Projects can use this in their
+ * metadata generation logic.
+ *
+ * @param params - Objects representing the context (article, tag, articleType, customType)
+ * @returns Object with title and description strings
+ */
+export function calculateTitleAndDescription({ articleType, customType, tag, article, }) {
+    if (article) {
+        return { title: article.title, description: article.description };
+    }
+    if (tag && articleType) {
+        return {
+            title: `${tag.title}`,
+            description: `Browse the latest ${articleType.name.toLowerCase()} resources related to ${tag.name.toLowerCase()}.`,
+        };
+    }
+    if (tag && customType) {
+        return {
+            title: `${tag.title}`,
+            description: `Browse the latest ${customType.name.toLowerCase()} resources related to ${tag.name.toLowerCase()}.`,
+        };
+    }
+    if (tag) {
+        return { title: tag.title, description: tag.description };
+    }
+    if (articleType) {
+        return { title: articleType.title, description: articleType.description };
+    }
+    if (customType) {
+        return { title: customType.title, description: customType.description };
+    }
+    return { title: '', description: '' };
+}
 //# sourceMappingURL=buildPageMetadata.js.map

package/dist/utils/buildPageMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildPageMetadata.js","sourceRoot":"","sources":["../../src/utils/buildPageMetadata.ts"],"names":[],"mappings":"AAuBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAA8E,EAC9E,IAAY,EACZ,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAqB,EAC3E,OAA0B;IAE1B,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC;IAC3E,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC;IAEpD,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":"AA6BA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAA8E,EAC9E,IAAY,EACZ,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAqB,EAC3E,OAA0B;IAE1B,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC;IAC3E,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC;IAEpD,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;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,4BAA4B,CAAC,EAC3C,WAAW,EACX,UAAU,EACV,GAAG,EACH,OAAO,GAMR;IACC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;IACpE,CAAC;IACD,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;QACvB,OAAO;YACL,KAAK,EAAE,GAAG,GAAG,CAAC,KAAK,EAAE;YACrB,WAAW,EAAE,qBAAqB,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,yBAAyB,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG;SACnH,CAAC;IACJ,CAAC;IACD,IAAI,GAAG,IAAI,UAAU,EAAE,CAAC;QACtB,OAAO;YACL,KAAK,EAAE,GAAG,GAAG,CAAC,KAAK,EAAE;YACrB,WAAW,EAAE,qBAAqB,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,yBAAyB,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG;SAClH,CAAC;IACJ,CAAC;IACD,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC;IAC5D,CAAC;IACD,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC;IAC5E,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,CAAC,WAAW,EAAE,CAAC;IAC1E,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;AACxC,CAAC"}

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.46",
   "description": "Shared React UI component library with Tailwind CSS v4 for SE Studio applications",
   "repository": {
     "type": "git",
@@ -58,8 +58,8 @@
     "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.46",
+    "@se-studio/core-data-types": "1.0.46"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.10",
@@ -69,7 +69,7 @@
     "@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",
     "typescript": "^5.9.3",
     "vitest": "^4.0.16"