@se-studio/contentful-rest-api 0.0.0-next16-20260822103555

package/dist/converters/iconCollector.js

@@ -0,0 +1,309 @@
+import { isSvgImage } from '@se-studio/core-data-types';
+import { fetchSvgContent, processSvgForSprite } from './svgProcessor.js';
+/**
+ * Extract SVG image from a visual if it's marked as an icon.
+ * Only returns SVG images that have isIcon: true (set during conversion from icon fields).
+ *
+ * @param visual - Visual to check
+ * @returns SVG image if visual contains an icon SVG, undefined otherwise
+ */
+function extractIconFromVisual(visual) {
+    if (!visual?.image) {
+        return undefined;
+    }
+    // Only return SVG images that are marked as icons
+    if (isSvgImage(visual.image) && visual.image.isIcon) {
+        return visual.image;
+    }
+    return undefined;
+}
+/**
+ * Extract icon SVG images from a responsive visual (both desktop and mobile).
+ * Only returns SVG images that have isIcon: true.
+ *
+ * @param visual - Responsive visual to check
+ * @returns Array of icon SVG images found (may contain 0, 1, or 2 items)
+ */
+function extractIconsFromResponsiveVisual(visual) {
+    const icons = [];
+    if (visual?.visual) {
+        const svg = extractIconFromVisual(visual.visual);
+        if (svg) {
+            icons.push(svg);
+        }
+    }
+    if (visual?.mobileVisual) {
+        const svg = extractIconFromVisual(visual.mobileVisual);
+        if (svg) {
+            icons.push(svg);
+        }
+    }
+    return icons;
+}
+/**
+ * Collect icon SVG from a component's icon field.
+ *
+ * @param component - Component to check
+ * @returns Array of icon SVGs found
+ */
+function collectIconsFromComponent(component) {
+    if (!component) {
+        return [];
+    }
+    const icon = extractIconFromVisual(component.icon);
+    return icon ? [icon] : [];
+}
+/**
+ * Collect icon SVG from a collection's icon field.
+ *
+ * @param collection - Collection to check
+ * @returns Array of icon SVGs found
+ */
+function collectIconsFromCollection(collection) {
+    if (!collection) {
+        return [];
+    }
+    const icon = extractIconFromVisual(collection.icon);
+    return icon ? [icon] : [];
+}
+/**
+ * Recursively collect all SVG icons from navigation structures.
+ * This includes icons from navigation item links and nested navigation entries.
+ *
+ * @param navigation - Navigation structure to scan
+ * @returns Array of all SVG icons found
+ */
+export function collectIconsFromNavigation(navigation) {
+    if (!navigation) {
+        return [];
+    }
+    const icons = [];
+    const seenIds = new Set();
+    function addIcon(icon) {
+        // Deduplicate by ID
+        if (!seenIds.has(icon.id)) {
+            seenIds.add(icon.id);
+            icons.push(icon);
+        }
+    }
+    function processNavItem(item) {
+        // Check link icon
+        if (item.link?.icon) {
+            const linkIcons = extractIconsFromResponsiveVisual(item.link.icon);
+            for (const icon of linkIcons) {
+                addIcon(icon);
+            }
+        }
+        // Recursively process nested entries
+        if (item.entries) {
+            for (const nestedItem of item.entries) {
+                processNavItem(nestedItem);
+            }
+        }
+    }
+    for (const item of navigation.entries) {
+        processNavItem(item);
+    }
+    return icons;
+}
+/**
+ * Traverse a rich text document and collect icons from embedded entries.
+ * This handles embedded-entry-block and embedded-entry-inline nodes that contain
+ * resolved content (Components, Collections, etc.) with potential icons.
+ *
+ * @param richText - Rich text document to traverse
+ * @param processContent - Callback to process embedded content items
+ */
+function collectIconsFromRichText(richText, processContent) {
+    if (!richText?.json) {
+        return;
+    }
+    const traverseNode = (node) => {
+        // Check for embedded entry in data.target (resolved by resolveRichTextDocument)
+        if (node.data?.target &&
+            typeof node.data.target === 'object' &&
+            'type' in node.data.target &&
+            'id' in node.data.target) {
+            processContent(node.data.target);
+        }
+        // Recurse into child content
+        if ('content' in node && Array.isArray(node.content)) {
+            for (const child of node.content) {
+                if (typeof child === 'object' && child !== null && 'nodeType' in child) {
+                    traverseNode(child);
+                }
+            }
+        }
+    };
+    // Start traversal from the document root
+    traverseNode(richText.json);
+}
+/**
+ * Recursively collect all SVG icons from page content.
+ * This includes icons from components, collections, CTA `links` (desktop +
+ * mobile via IResponsiveVisual), nested content, external-component
+ * internalLink, and embedded entries within rich text fields.
+ *
+ * @param contents - Array of content items to scan
+ * @returns Array of all SVG icons found
+ */
+export function collectIconsFromContent(contents) {
+    if (!contents) {
+        return [];
+    }
+    const icons = [];
+    const seenIds = new Set();
+    // Track processed content IDs to avoid infinite loops with circular references
+    const processedIds = new Set();
+    function addIcon(icon) {
+        // Deduplicate by ID
+        if (!seenIds.has(icon.id)) {
+            seenIds.add(icon.id);
+            icons.push(icon);
+        }
+    }
+    // Process a single content item (used by both main loop and rich text traversal)
+    function processContentItem(content) {
+        // Skip if already processed (prevents infinite loops)
+        if (processedIds.has(content.id)) {
+            return;
+        }
+        processedIds.add(content.id);
+        // Check component icon field
+        if (content.type === 'Component') {
+            const componentIcons = collectIconsFromComponent(content);
+            for (const icon of componentIcons) {
+                addIcon(icon);
+            }
+            // Type for component with optional rich text and contents fields
+            const component = content;
+            // Recursively check nested content if component has contents
+            if (component.contents) {
+                for (const nested of component.contents) {
+                    processContentItem(nested);
+                }
+            }
+            // CTA links on the component (icon + mobileIcon → responsive visual)
+            if (component.links) {
+                for (const link of component.links) {
+                    if (typeof link === 'object' && link !== null && 'type' in link && 'id' in link) {
+                        processContentItem(link);
+                    }
+                }
+            }
+            // Check rich text fields for embedded content
+            collectIconsFromRichText(component.body, processContentItem);
+            collectIconsFromRichText(component.additionalCopy, processContentItem);
+        }
+        // Check collection icon field
+        if (content.type === 'Collection') {
+            const collectionIcons = collectIconsFromCollection(content);
+            for (const icon of collectionIcons) {
+                addIcon(icon);
+            }
+            // Type for collection with optional rich text fields
+            const collection = content;
+            // Recursively check collection contents
+            if (collection.contents) {
+                for (const nested of collection.contents) {
+                    if (typeof nested === 'object' && nested !== null && 'type' in nested && 'id' in nested) {
+                        processContentItem(nested);
+                    }
+                }
+            }
+            // CTA links on the collection (icon + mobileIcon → responsive visual)
+            if (collection.links) {
+                for (const link of collection.links) {
+                    if (typeof link === 'object' && link !== null && 'type' in link && 'id' in link) {
+                        processContentItem(link);
+                    }
+                }
+            }
+            // Check rich text fields for embedded content
+            collectIconsFromRichText(collection.body, processContentItem);
+            collectIconsFromRichText(collection.additionalCopy, processContentItem);
+        }
+        if (content.type === 'External component') {
+            const external = content;
+            collectIconsFromRichText(external.copy, processContentItem);
+            collectIconsFromRichText(external.additionalCopy, processContentItem);
+            collectIconsFromRichText(external.extraCopy, processContentItem);
+            // internalLink may carry icon / mobileIcon
+            if (external.internalLink) {
+                processContentItem(external.internalLink);
+            }
+        }
+        // Check links for icon fields (IResponsiveVisual)
+        if (content.type === 'Internal link' ||
+            content.type === 'External link' ||
+            content.type === 'Download link' ||
+            content.type === 'Blank link') {
+            const link = content;
+            if (link.icon) {
+                const linkIcons = extractIconsFromResponsiveVisual(link.icon);
+                for (const icon of linkIcons) {
+                    addIcon(icon);
+                }
+            }
+        }
+    }
+    // Process all top-level content items
+    for (const content of contents) {
+        processContentItem(content);
+    }
+    return icons;
+}
+/**
+ * Deduplicate icons by ID, preserving order of first occurrence.
+ * Takes any number of icon arrays and returns a single deduplicated array.
+ *
+ * @param iconArrays - Arrays of icons to merge and deduplicate
+ * @returns Deduplicated array of icons, or undefined if empty
+ */
+export function deduplicateIcons(...iconArrays) {
+    const seenIds = new Set();
+    const icons = [];
+    for (const arr of iconArrays) {
+        for (const icon of arr) {
+            if (!seenIds.has(icon.id)) {
+                seenIds.add(icon.id);
+                icons.push(icon);
+            }
+        }
+    }
+    return icons.length > 0 ? icons : undefined;
+}
+/**
+ * Process icons by fetching SVG content and generating sprite symbols.
+ * This runs during data conversion to pre-process icons for the sprite sheet.
+ *
+ * @param icons - Array of icon SVG images to process
+ * @returns Array of icons with symbolContent populated
+ */
+export async function processIconsForSprite(icons) {
+    if (icons.length === 0) {
+        return [];
+    }
+    // Process all icons in parallel
+    const processedIcons = await Promise.all(icons.map(async (icon) => {
+        try {
+            // Fetch SVG content (uses parent request's cache tags)
+            const svgContent = await fetchSvgContent(icon.svgSrc);
+            // Process into symbol format
+            const symbolContent = processSvgForSprite(svgContent, icon.id);
+            // Return icon with symbolContent populated
+            return {
+                ...icon,
+                symbolContent,
+            };
+        }
+        catch (error) {
+            if (process.env.LOG_SVG_SPRITE) {
+                console.error(`Failed to process icon ${icon.id}:`, error);
+            }
+            return icon;
+        }
+    }));
+    return processedIcons;
+}
+//# sourceMappingURL=iconCollector.js.map

package/dist/converters/iconCollector.js.map

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

package/dist/converters/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Converters module
+ *
+ * Provides functional composition pattern for converting Contentful entries
+ * to typed objects. Use the base converters and compose with enhancers to
+ * create custom converters for your specific needs.
+ */
+export type { IContentfulArticle, IContentfulArticleLink } from './article';
+export { animationFormatFromFile, createResponsiveVisual } from './asset';
+export type { IContentfulCollection } from './collection';
+export { baseCollectionConverter } from './collection';
+export type { IContentfulComponent } from './component';
+export { baseComponentConverter } from './component';
+export { baseDocumentConverter } from './document';
+export type { IContentfulExternalComponent } from './externalComponent';
+export { baseExternalComponentConverter } from './externalComponent';
+export { type BaseConverterContext, type ContentResolverFunction, type ConverterContext, lookupAsset, type UrlCalculators, } from './helpers';
+export { baseHtmlComponentConverter } from './htmlComponent';
+export { baseNavigationItemConverter, navigationStubFromLink, resolveNavigation, resolveNavigationOrStub, } from './navigationItem';
+export { basePageConverter, calculatePageHref, calculatePageVariantHref, } from './page';
+export { mergeAlternatePageContentsInTree, resolveAlternateReplacements, } from './pageVariantMerge';
+export type { IContentfulPerson } from './person';
+export { baseRedirectConverter } from './redirect';
+export { resolveLink, resolveLinks, resolveRichTextDocument, } from './resolver';
+export { baseTagTypeConverter, baseTagTypeLinkConverter } from './tagType';
+//# sourceMappingURL=index.d.ts.map

package/dist/converters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/converters/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAC1E,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,YAAY,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,8BAA8B,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,WAAW,EACX,KAAK,cAAc,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,gCAAgC,EAChC,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EACL,WAAW,EACX,YAAY,EACZ,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC"}

package/dist/converters/index.js

@@ -0,0 +1,21 @@
+/**
+ * Converters module
+ *
+ * Provides functional composition pattern for converting Contentful entries
+ * to typed objects. Use the base converters and compose with enhancers to
+ * create custom converters for your specific needs.
+ */
+export { animationFormatFromFile, createResponsiveVisual } from './asset.js';
+export { baseCollectionConverter } from './collection.js';
+export { baseComponentConverter } from './component.js';
+export { baseDocumentConverter } from './document.js';
+export { baseExternalComponentConverter } from './externalComponent.js';
+export { lookupAsset, } from './helpers.js';
+export { baseHtmlComponentConverter } from './htmlComponent.js';
+export { baseNavigationItemConverter, navigationStubFromLink, resolveNavigation, resolveNavigationOrStub, } from './navigationItem.js';
+export { basePageConverter, calculatePageHref, calculatePageVariantHref, } from './page.js';
+export { mergeAlternatePageContentsInTree, resolveAlternateReplacements, } from './pageVariantMerge.js';
+export { baseRedirectConverter } from './redirect.js';
+export { resolveLink, resolveLinks, resolveRichTextDocument, } from './resolver.js';
+export { baseTagTypeConverter, baseTagTypeLinkConverter } from './tagType.js';
+//# sourceMappingURL=index.js.map

package/dist/converters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/converters/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAE1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,EAAE,8BAA8B,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAIL,WAAW,GAEZ,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,gCAAgC,EAChC,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EACL,WAAW,EACX,YAAY,EACZ,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC"}

package/dist/converters/link.d.ts

@@ -0,0 +1,11 @@
+import type { IBlankLink, IDownloadLink, IExternalLink, IInternalLink } from '@se-studio/core-data-types';
+import type { Entry } from 'contentful';
+import type { DefaultChainModifier } from '../api';
+import type { BaseLinkSkeleton } from '../baseTypes/baseLink';
+import type { ConverterContext } from './helpers';
+/**
+ * Converts a Contentful link entry to an ILinkProps object
+ * Handles all link types: internal, external, download, and blank
+ */
+export declare function baseLinkConverter(context: ConverterContext, entry: Entry<BaseLinkSkeleton, DefaultChainModifier, string>): IInternalLink | IExternalLink | IDownloadLink | IBlankLink;
+//# sourceMappingURL=link.d.ts.map

package/dist/converters/link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/converters/link.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAUlD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,KAAK,CAAC,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,CAAC,GAC3D,aAAa,GAAG,aAAa,GAAG,aAAa,GAAG,UAAU,CA6G5D"}

package/dist/converters/link.js

@@ -0,0 +1,109 @@
+import { createResponsiveVisual } from './asset.js';
+import { lookupAsset, lookupDownloadAsset, lookupIconAsset, makeContentfulTitle, resolveBuildYear, } from './helpers.js';
+import { resolveLink } from './resolver.js';
+/**
+ * Converts a Contentful link entry to an ILinkProps object
+ * Handles all link types: internal, external, download, and blank
+ */
+export function baseLinkConverter(context, entry) {
+    const { sys, fields } = entry;
+    if (sys.contentType.sys.id !== 'link') {
+        throw new Error(`Invalid content type: expected "link", got "${sys.contentType.sys.id}"`);
+    }
+    const id = sys.id;
+    const name = fields.name;
+    const useName = fields.useName;
+    const text = resolveBuildYear(useName
+        ? name
+        : (fields.linkText ?? makeContentfulTitle(fields.linkText, id, 'Link text for ')));
+    const icon = createResponsiveVisual(lookupIconAsset(context, fields.icon), lookupIconAsset(context, fields.mobileIcon));
+    const backgroundColour = fields.backgroundColour ?? null;
+    const textColour = fields.textColour ?? null;
+    const variant = fields.variant;
+    const size = fields.size;
+    const hasTrackingFields = fields.trackingEventName || fields.conversionId || fields.conversionLabel;
+    const trackingInfo = hasTrackingFields
+        ? {
+            trackingEventName: fields.trackingEventName ?? null,
+            conversionId: fields.conversionId ?? null,
+            conversionLabel: fields.conversionLabel ?? null,
+        }
+        : undefined;
+    // Common base properties
+    const baseProps = {
+        id,
+        useName,
+        name,
+        text,
+        icon,
+        backgroundColour,
+        textColour,
+        variant,
+        size,
+        trackingInfo,
+        accessibilityLabel: fields.accessibilityLabel ?? null,
+    };
+    // Determine link type based on field priority: internal > external > download > blank
+    if (fields.internal) {
+        // Internal link: resolve the target entry to get its href
+        const internalTarget = resolveLink(context, id, fields.internal);
+        if (internalTarget) {
+            return {
+                ...baseProps,
+                id: internalTarget.id,
+                linkEntryId: id,
+                lastModified: internalTarget.lastModified,
+                internalId: internalTarget.id,
+                type: 'Internal link',
+                internalType: internalTarget.internalType,
+                href: internalTarget.href,
+                slug: internalTarget.slug,
+                indexed: internalTarget.indexed,
+                hidden: internalTarget.hidden,
+                tags: internalTarget.tags,
+                title: internalTarget.title,
+                description: internalTarget.description,
+            };
+        }
+        // If the internal target couldn't be resolved, fall through to next priority
+    }
+    if (fields.external) {
+        // External link: use the external URL
+        return {
+            ...baseProps,
+            type: 'External link',
+            href: fields.external,
+        };
+    }
+    if (fields.downloadAsset) {
+        const asset = lookupAsset(context, fields.downloadAsset);
+        const downloadAsset = lookupDownloadAsset(context, fields.downloadAsset);
+        let href = downloadAsset?.href ?? null;
+        if (href === null && asset) {
+            if (asset.image?.type === 'Picture')
+                href = asset.image.src;
+            else if (asset.image?.type === 'Svg image')
+                href = asset.image.svgSrc;
+            else if (asset.video?.type === 'Local video')
+                href = asset.video.preview.videoUrl;
+            else if (asset.video?.type === 'Full video')
+                href = asset.video.full.videoUrl;
+            else if (asset.video?.type === 'External video')
+                href = asset.video.external;
+        }
+        return {
+            ...baseProps,
+            type: 'Download link',
+            href: href ?? '',
+            visual: asset,
+            download: downloadAsset ?? undefined,
+        };
+    }
+    // Blank link: no href
+    return {
+        ...baseProps,
+        type: 'Blank link',
+        href: null,
+    };
+}
+//# sourceMappingURL=link.js.map

package/dist/converters/link.js.map

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

package/dist/converters/navigationItem.d.ts

@@ -0,0 +1,17 @@
+import type { INavigation, INavigationItem } from '@se-studio/core-data-types';
+import type { Entry, UnresolvedLink } from 'contentful';
+import type { DefaultChainModifier } from '../api';
+import type { BaseNavigationItemSkeleton } from '../baseTypes/baseNavigationItem';
+import { type ConverterContext } from './helpers';
+export declare function baseNavigationItemConverter(context: ConverterContext, entry: Entry<BaseNavigationItemSkeleton, DefaultChainModifier, string>): INavigationItem;
+/** Minimal nav root for flat resolution — full tree assembled post-convert via registry. */
+export declare function navigationStubFromLink(link: UnresolvedLink<'Entry'> | undefined): INavigation | undefined;
+/**
+ * Resolves bundled navigation or returns a stub root id when flat nav is enabled.
+ */
+export declare function resolveNavigationOrStub(context: ConverterContext, link: UnresolvedLink<'Entry'> | undefined): INavigation | undefined;
+/**
+ * Resolves a navigation entry from an unresolved link
+ */
+export declare function resolveNavigation(context: ConverterContext, link: UnresolvedLink<'Entry'>): INavigation | undefined;
+//# sourceMappingURL=navigationItem.d.ts.map

package/dist/converters/navigationItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigationItem.d.ts","sourceRoot":"","sources":["../../src/converters/navigationItem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,WAAW,EACX,eAAe,EAChB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAEnD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAElF,OAAO,EACL,KAAK,gBAAgB,EAKtB,MAAM,WAAW,CAAC;AA0FnB,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,KAAK,CAAC,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,CAAC,GACrE,eAAe,CAqBjB;AAED,4FAA4F;AAC5F,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,SAAS,GACxC,WAAW,GAAG,SAAS,CASzB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,SAAS,GACxC,WAAW,GAAG,SAAS,CAQzB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,GAC5B,WAAW,GAAG,SAAS,CA4BzB"}

package/dist/converters/navigationItem.js

@@ -0,0 +1,126 @@
+import { createResponsiveVisual } from './asset.js';
+import { lookupIconAsset, makeContentfulTitle, resolveBuildYear, shouldResolveNavigation, } from './helpers.js';
+import { resolveLink, resolveNavigationItem, resolveRichTextDocument } from './resolver.js';
+function createLink(context, entry) {
+    const { sys: { id }, fields, } = entry;
+    const { title, link, text, internal, icon: navIcon, mobileIcon: mobileNavIcon, useTitle, ...otherFields } = fields;
+    const { variant, size, trackingEventName, navigationItems: _navigationItems, longText: longTextField, adminLabel: _adminLabel, // captured to exclude from ...remainingOtherFields; surfaced on the parent INavigationItem instead (see baseNavigationItemConverter)
+    ...remainingOtherFields } = otherFields;
+    const longText = resolveRichTextDocument(context, id, longTextField);
+    const trackingInfo = trackingEventName ? { trackingEventName } : undefined;
+    const icon = createResponsiveVisual(lookupIconAsset(context, navIcon), lookupIconAsset(context, mobileNavIcon));
+    const realText = useTitle ? resolveBuildYear(title) : text ? resolveBuildYear(text) : undefined;
+    if (link) {
+        return {
+            type: 'External link',
+            id,
+            href: link,
+            icon,
+            name: makeContentfulTitle(title, id),
+            ...remainingOtherFields,
+            longText,
+            variant,
+            size,
+            text: realText,
+            ...(trackingInfo && { trackingInfo }),
+        };
+    }
+    if (internal) {
+        const resolved = resolveLink(context, id, internal);
+        if (resolved) {
+            return {
+                ...resolved,
+                ...remainingOtherFields,
+                longText,
+                icon,
+                visual: icon?.visual ?? resolved.visual,
+                id,
+                text: realText,
+                variant,
+                size,
+                ...(trackingInfo && {
+                    trackingInfo: { ...resolved.trackingInfo, ...trackingInfo },
+                }),
+            };
+        }
+    }
+    const blank = {
+        type: 'Blank link',
+        nick: true,
+        id,
+        name: makeContentfulTitle(title, id),
+        ...remainingOtherFields,
+        longText,
+        variant,
+        size,
+        icon,
+        text: realText,
+        ...(trackingInfo && { trackingInfo }),
+    };
+    return blank;
+}
+export function baseNavigationItemConverter(context, entry) {
+    const { sys: { id }, fields, } = entry;
+    const { navigationItems, adminLabel } = fields;
+    const link = createLink(context, entry);
+    const resolvedNavigationItems = navigationItems
+        ?.map((item) => resolveNavigationItem(context, id, item))
+        .filter((item) => item !== undefined);
+    const result = {
+        id,
+        link,
+        entries: resolvedNavigationItems,
+        ...(adminLabel ? { adminLabel } : {}),
+    };
+    return result;
+}
+/** Minimal nav root for flat resolution — full tree assembled post-convert via registry. */
+export function navigationStubFromLink(link) {
+    if (!link) {
+        return undefined;
+    }
+    return {
+        id: link.sys.id,
+        name: '',
+        entries: [],
+    };
+}
+/**
+ * Resolves bundled navigation or returns a stub root id when flat nav is enabled.
+ */
+export function resolveNavigationOrStub(context, link) {
+    if (!link) {
+        return undefined;
+    }
+    if (!shouldResolveNavigation(context)) {
+        return navigationStubFromLink(link);
+    }
+    return resolveNavigation(context, link);
+}
+/**
+ * Resolves a navigation entry from an unresolved link
+ */
+export function resolveNavigation(context, link) {
+    const id = link.sys.id;
+    const possibleEntry = context.includes.get(id);
+    if (possibleEntry?.type !== 'navigation') {
+        return undefined;
+    }
+    const entry = possibleEntry.entry;
+    const { fields } = entry;
+    if (!fields) {
+        return undefined;
+    }
+    // Resolve navigation item entries
+    const { name, entries: fieldEntries, ...rest } = fields;
+    const entries = fieldEntries
+        ?.map((item) => resolveNavigationItem(context, id, item))
+        .filter((item) => item != null) ?? [];
+    return {
+        id,
+        name,
+        entries,
+        ...rest,
+    };
+}
+//# sourceMappingURL=navigationItem.js.map