@se-studio/core-ui 0.0.0-next16-20260822103555

package/dist/utils/interpolateMetaText.js

@@ -0,0 +1,21 @@
+import { interpolateMetaTokens, resolveMetaFromPageContext } from '@se-studio/core-data-types';
+import { convertText } from './convertText';
+/**
+ * Run `{{meta.*}}` interpolation then the site `processText` (e.g. `{{phone}}`).
+ * When no inner processor is provided, falls back to {@link convertText}.
+ */
+export function composeMetaProcessText(inner) {
+    return (text, contentContext) => {
+        const meta = resolveMetaFromPageContext(contentContext?.pageContext);
+        const interpolated = interpolateMetaTokens(text, meta);
+        if (inner) {
+            return inner(interpolated, contentContext);
+        }
+        return convertText(interpolated);
+    };
+}
+/** Interpolate `{{meta.*}}` using the current page context (no convertText). */
+export function interpolateMetaInText(text, contentContext) {
+    return interpolateMetaTokens(text, resolveMetaFromPageContext(contentContext?.pageContext));
+}
+//# sourceMappingURL=interpolateMetaText.js.map

package/dist/utils/interpolateMetaText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolateMetaText.js","sourceRoot":"","sources":["../../src/utils/interpolateMetaText.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAqB;IAC1D,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,0BAA0B,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QACrE,MAAM,YAAY,GAAG,qBAAqB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvD,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,WAAW,CAAC,YAAY,CAAC,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,cAAgC;IAClF,OAAO,qBAAqB,CAAC,IAAI,EAAE,0BAA0B,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC;AAC9F,CAAC"}

package/dist/utils/linkAccessibility.d.ts

@@ -0,0 +1,13 @@
+import type { ILinkProps } from '@se-studio/core-data-types';
+/**
+ * Returns the accessibility label for a link, preferring the CMS-provided
+ * accessibilityLabel when set, otherwise using the fallback.
+ *
+ * Use for aria-label on links, especially icon-only or generic-text links.
+ *
+ * @param link - Link with optional accessibilityLabel
+ * @param fallback - Fallback when accessibilityLabel is not set (e.g. link.text ?? link.name)
+ * @returns The label to use for aria-label
+ */
+export declare function getLinkAriaLabel(link: ILinkProps, fallback?: string): string | undefined;
+//# sourceMappingURL=linkAccessibility.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linkAccessibility.d.ts","sourceRoot":"","sources":["../../src/utils/linkAccessibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExF"}

package/dist/utils/linkAccessibility.js

@@ -0,0 +1,14 @@
+/**
+ * Returns the accessibility label for a link, preferring the CMS-provided
+ * accessibilityLabel when set, otherwise using the fallback.
+ *
+ * Use for aria-label on links, especially icon-only or generic-text links.
+ *
+ * @param link - Link with optional accessibilityLabel
+ * @param fallback - Fallback when accessibilityLabel is not set (e.g. link.text ?? link.name)
+ * @returns The label to use for aria-label
+ */
+export function getLinkAriaLabel(link, fallback) {
+    return link.accessibilityLabel ?? fallback;
+}
+//# sourceMappingURL=linkAccessibility.js.map

package/dist/utils/linkAccessibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkAccessibility.js","sourceRoot":"","sources":["../../src/utils/linkAccessibility.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAgB,EAAE,QAAiB;IAClE,OAAO,IAAI,CAAC,kBAAkB,IAAI,QAAQ,CAAC;AAC7C,CAAC"}

package/dist/utils/linkResolution.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Extract curated entry IDs from collection contents (order preserved).
+ * Used by getRelated* helpers — contents provide selection/order only, not display data.
+ */
+export declare function extractCuratedLinkIds<T extends {
+    id: string;
+}>(contents: readonly unknown[] | undefined, isLink: (item: unknown) => item is T): string[];
+/**
+ * Resolve curated IDs to fresh link objects from a listing fetch (getAll*Links).
+ * Omits IDs not found in the listing (unpublished, unindexed, or conversion errors).
+ */
+export declare function resolveCuratedLinksFromListing<T extends {
+    id: string;
+}>(curatedIds: readonly string[], allLinks: readonly T[]): T[];
+//# sourceMappingURL=linkResolution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linkResolution.d.ts","sourceRoot":"","sources":["../../src/utils/linkResolution.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAC5D,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,EACxC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,GACnC,MAAM,EAAE,CAEV;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACrE,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,QAAQ,EAAE,SAAS,CAAC,EAAE,GACrB,CAAC,EAAE,CAML"}

package/dist/utils/linkResolution.js

@@ -0,0 +1,19 @@
+/**
+ * Extract curated entry IDs from collection contents (order preserved).
+ * Used by getRelated* helpers — contents provide selection/order only, not display data.
+ */
+export function extractCuratedLinkIds(contents, isLink) {
+    return (contents ?? []).filter(isLink).map((item) => item.id);
+}
+/**
+ * Resolve curated IDs to fresh link objects from a listing fetch (getAll*Links).
+ * Omits IDs not found in the listing (unpublished, unindexed, or conversion errors).
+ */
+export function resolveCuratedLinksFromListing(curatedIds, allLinks) {
+    if (curatedIds.length === 0) {
+        return [];
+    }
+    const byId = new Map(allLinks.map((link) => [link.id, link]));
+    return curatedIds.map((id) => byId.get(id)).filter((link) => link !== undefined);
+}
+//# sourceMappingURL=linkResolution.js.map

package/dist/utils/linkResolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkResolution.js","sourceRoot":"","sources":["../../src/utils/linkResolution.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAwC,EACxC,MAAoC;IAEpC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAC5C,UAA6B,EAC7B,QAAsB;IAEtB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9D,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAa,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AAC9F,CAAC"}

package/dist/utils/listing-page-heading.d.ts

@@ -0,0 +1,16 @@
+export type ListingScope = 'globalTag' | 'articleTypeTag';
+export interface ListingPageContext {
+    tag?: {
+        title?: string;
+    } | null;
+    articleType?: {
+        name?: string;
+        title?: string;
+    } | null;
+}
+/**
+ * Resolves the visible H1 for CMS listing pages (tag hubs, article-type tag hubs).
+ * CMS hero heading wins; otherwise a scope-aware default is used on the first block only.
+ */
+export declare function resolveListingPageHeading(cmsHeading: string | null | undefined, pageContext: ListingPageContext, index: number, listingScope?: ListingScope): string | undefined;
+//# sourceMappingURL=listing-page-heading.d.ts.map

package/dist/utils/listing-page-heading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listing-page-heading.d.ts","sourceRoot":"","sources":["../../src/utils/listing-page-heading.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,gBAAgB,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAChC,WAAW,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACxD;AAMD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACrC,WAAW,EAAE,kBAAkB,EAC/B,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,YAAY,GAC1B,MAAM,GAAG,SAAS,CAgBpB"}

package/dist/utils/listing-page-heading.js

@@ -0,0 +1,24 @@
+function articleTypeLabel(articleType) {
+    return articleType.name ?? articleType.title ?? '';
+}
+/**
+ * Resolves the visible H1 for CMS listing pages (tag hubs, article-type tag hubs).
+ * CMS hero heading wins; otherwise a scope-aware default is used on the first block only.
+ */
+export function resolveListingPageHeading(cmsHeading, pageContext, index, listingScope) {
+    if (cmsHeading) {
+        return cmsHeading;
+    }
+    if (index !== 0) {
+        return undefined;
+    }
+    const tagTitle = pageContext.tag?.title;
+    if (listingScope === 'articleTypeTag' && tagTitle && pageContext.articleType) {
+        return `${tagTitle} — ${articleTypeLabel(pageContext.articleType)}`;
+    }
+    if (tagTitle) {
+        return tagTitle;
+    }
+    return pageContext.articleType ? articleTypeLabel(pageContext.articleType) : undefined;
+}
+//# sourceMappingURL=listing-page-heading.js.map

package/dist/utils/listing-page-heading.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listing-page-heading.js","sourceRoot":"","sources":["../../src/utils/listing-page-heading.ts"],"names":[],"mappings":"AAOA,SAAS,gBAAgB,CAAC,WAA2D;IACnF,OAAO,WAAW,CAAC,IAAI,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,UAAqC,EACrC,WAA+B,EAC/B,KAAa,EACb,YAA2B;IAE3B,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC;IACxC,IAAI,YAAY,KAAK,gBAAgB,IAAI,QAAQ,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC;QAC7E,OAAO,GAAG,QAAQ,MAAM,gBAAgB,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;IACtE,CAAC;IACD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,gBAAgB,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACzF,CAAC"}

package/dist/utils/listingStructuredData.d.ts

@@ -0,0 +1,28 @@
+import 'server-only';
+import type { IBaseModel } from '@se-studio/core-data-types';
+import type { FetchHelpers } from '../CmsRendererConfig';
+import type { IBuildInformation } from './buildPageMetadata';
+import { type BuildStructuredDataContextOptions, type StructuredDataContext } from './structuredDataUtils';
+/** One entry in an ItemList JSON-LD template (`listing.items`). */
+export interface ListingStructuredDataItem {
+    position: number;
+    name: string;
+    url: string;
+    /** When false, Mustache templates emit a trailing comma between ListItems. */
+    last: boolean;
+}
+export interface BuildListingItemsOptions {
+    /** Maximum items in the list. Default 12. */
+    maxItems?: number;
+}
+export type ListingFetchHelpers = Pick<FetchHelpers, 'getAllArticleLinks'>;
+/**
+ * Resolves ItemList entries for article type index, tag, and person profile pages.
+ * Returns an empty array when the model type is unsupported or fetch helpers are missing.
+ */
+export declare function buildListingItems(model: IBaseModel, baseUrl: string, helpers: ListingFetchHelpers, options?: BuildListingItemsOptions): Promise<ListingStructuredDataItem[]>;
+/**
+ * Builds structured data context with optional `listing.items` for ItemList Mustache templates.
+ */
+export declare function buildListingStructuredDataContext(model: IBaseModel, config: IBuildInformation, helpers: ListingFetchHelpers, extraOptions?: BuildStructuredDataContextOptions, listingOptions?: BuildListingItemsOptions): Promise<StructuredDataContext>;
+//# sourceMappingURL=listingStructuredData.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"listingStructuredData.d.ts","sourceRoot":"","sources":["../../src/utils/listingStructuredData.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EACL,KAAK,iCAAiC,EAEtC,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAE/B,mEAAmE;AACnE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAC;AAoB3E;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAkCtC;AAED;;GAEG;AACH,wBAAsB,iCAAiC,CACrD,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,mBAAmB,EAC5B,YAAY,CAAC,EAAE,iCAAiC,EAChD,cAAc,CAAC,EAAE,wBAAwB,GACxC,OAAO,CAAC,qBAAqB,CAAC,CAOhC"}

package/dist/utils/listingStructuredData.js

@@ -0,0 +1,65 @@
+import 'server-only';
+import { filterRelatedArticles } from '@se-studio/contentful-rest-api';
+import { buildStructuredDataContext, } from './structuredDataUtils';
+const DEFAULT_MAX_ITEMS = 12;
+function articleLinksToListingItems(articles, baseUrl) {
+    const items = articles.map((article, index) => {
+        const href = article.href.startsWith('http') ? article.href : `${baseUrl}${article.href}`;
+        return {
+            position: index + 1,
+            name: article.title ?? article.name,
+            url: href,
+            last: index === articles.length - 1,
+        };
+    });
+    return items;
+}
+/**
+ * Resolves ItemList entries for article type index, tag, and person profile pages.
+ * Returns an empty array when the model type is unsupported or fetch helpers are missing.
+ */
+export async function buildListingItems(model, baseUrl, helpers, options) {
+    const getAllArticleLinks = helpers.getAllArticleLinks;
+    if (!getAllArticleLinks) {
+        return [];
+    }
+    const maxItems = options?.maxItems ?? DEFAULT_MAX_ITEMS;
+    const response = await getAllArticleLinks({ fetchProfile: 'listing' });
+    const articles = response.data ?? [];
+    if (articles.length === 0) {
+        return [];
+    }
+    let filtered = [];
+    if (model.type === 'Article type') {
+        filtered = filterRelatedArticles(articles, {
+            articleTypeSlugs: [model.slug],
+            count: maxItems,
+        });
+    }
+    else if (model.type === 'Tag') {
+        filtered = filterRelatedArticles(articles, {
+            tagSlugs: [model.slug],
+            count: maxItems,
+        });
+    }
+    else if (model.type === 'Person') {
+        filtered = filterRelatedArticles(articles, {
+            authorSlugs: [model.slug],
+            strictAuthorMatch: true,
+            count: maxItems,
+        });
+    }
+    return articleLinksToListingItems(filtered, baseUrl);
+}
+/**
+ * Builds structured data context with optional `listing.items` for ItemList Mustache templates.
+ */
+export async function buildListingStructuredDataContext(model, config, helpers, extraOptions, listingOptions) {
+    const items = await buildListingItems(model, config.baseUrl, helpers, listingOptions);
+    const listing = items.length > 0 ? { items } : undefined;
+    return buildStructuredDataContext(model, config, {
+        ...extraOptions,
+        ...(listing ? { listing } : {}),
+    });
+}
+//# sourceMappingURL=listingStructuredData.js.map

package/dist/utils/listingStructuredData.js.map

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

package/dist/utils/marketingSiteSitemap.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Marketing site sitemap entry generation.
+ * Used by createAppHelpers when marketingSiteSitemap config is provided.
+ */
+import type { BaseConverterContext, ContentfulConfig, FetchOptions } from '@se-studio/contentful-rest-api';
+import type { IArticleLink, IArticleTypeLink, IInternalLink, IPersonLink } from '@se-studio/core-data-types';
+import type { LinkFetchOptions } from '../CmsRendererConfig';
+import type { LocaleConfig } from './buildPageMetadata';
+import type { SitemapEntry } from './sitemap';
+/** Sitemap source: async function returning entries. */
+export type MarketingSiteSitemapSource = () => Promise<SitemapEntry[]>;
+export interface MarketingSiteSitemapConfig {
+    /** Slug for the article types index page. Required when enableArticleTypeIndex is true. */
+    articlesSlug?: string;
+    tagsSlug: string;
+    enableArticleTypeIndex: boolean;
+    enableArticleTypeTagIndex: boolean;
+    enablePeopleIndex: boolean;
+    enablePerson: boolean;
+    enableTag: boolean;
+    enableTagsIndex: boolean;
+    /**
+     * Slug of the Custom Type entry that backs individual person pages (e.g. 'people').
+     * When provided together with enablePerson, person sitemap entries (main path) are emitted only
+     * when *both* the individual person's indexed/hidden *and* the backing custom type's indexed/hidden
+     * allow inclusion. This matches the effective `indexed` logic used for person page metadata in
+     * route handlers (person.indexed && customType.indexed). Optional for backwards compatibility with
+     * existing configs; supply it (and wire the getter) to prevent people from appearing in the main
+     * sitemap when their custom type has indexed=false (or hidden=true).
+     */
+    peopleSlug?: string;
+    /**
+     * When true, articles that have a download asset but no body content are included as page URL
+     * entries in the sitemap (in addition to their /download/... entry). Default: false.
+     */
+    includeDownloadArticles?: boolean;
+    /**
+     * When true, articles whose href resolves to an external URL (no body content, has externalLink)
+     * are included as page URL entries with the internal URL reconstructed from articleType + slug.
+     * Default: false.
+     */
+    includeExternalHrefArticles?: boolean;
+    /** Optional custom entry sources (e.g. drive pages). Merged into main sitemap only, not unindexed. */
+    additionalSources?: MarketingSiteSitemapSource[];
+    /** Optional multi-locale config; when set, sitemap entries are emitted per locale with hreflang alternates. */
+    localeConfig?: LocaleConfig;
+}
+type ArticleInclusionConfig = Pick<MarketingSiteSitemapConfig, 'includeDownloadArticles' | 'includeExternalHrefArticles'>;
+/**
+ * Determines whether an article should appear as a page URL entry in the sitemap.
+ * When skipIndexedCheck is true the indexed/hidden guards are omitted (used for the unindexed path).
+ */
+export declare function shouldIncludeArticlePageUrl(link: IArticleLink, config: ArticleInclusionConfig, skipIndexedCheck?: boolean): boolean;
+/**
+ * Builds (articleTypeSlug → tagSlug → latest lastModified) for article-type tag index sitemap URLs.
+ * Only considers articles that pass {@link shouldIncludeArticlePageUrl} and CMS-indexed, non-hidden tags.
+ */
+export declare function collectArticleTypeTagLastModified(articleLinks: IArticleLink[], config: ArticleInclusionConfig): Map<string, Map<string, Date>>;
+interface CreateMarketingSiteSitemapEntriesDeps {
+    converterContext: BaseConverterContext;
+    getConfig: (preview: boolean) => ContentfulConfig;
+    buildOptions: (options?: Partial<FetchOptions>) => FetchOptions;
+    getAllPageLinks: (options?: LinkFetchOptions) => Promise<{
+        data: IInternalLink[];
+    }>;
+    getAllArticleLinks: (options?: LinkFetchOptions) => Promise<{
+        data: IArticleLink[];
+    }>;
+    getAllArticleTypeLinks: (options?: LinkFetchOptions) => Promise<{
+        data: IArticleTypeLink[];
+    }>;
+    getAllTagLinks: (options?: LinkFetchOptions) => Promise<{
+        data: IInternalLink[];
+    }>;
+    getAllPersonLinks: (options?: LinkFetchOptions) => Promise<{
+        data: IPersonLink[];
+    }>;
+    /**
+     * Optional getter for a single custom type by slug (used to enforce the combined indexed/hidden
+     * gate for person entries when peopleSlug is configured). Mirrors the shape returned by
+     * getCustomTypeWithErrors but only the indexed/hidden fields are inspected.
+     */
+    getCustomType?: (slug: string) => Promise<{
+        data: {
+            indexed?: boolean | null;
+            hidden?: boolean | null;
+        } | null;
+    } | null>;
+}
+/**
+ * Creates a getSitemapEntries function for marketing sites with articles, tags, people.
+ * When includeUnindexed is true, returns only pages with indexed === false.
+ * When includeUnindexed is false, returns full sitemap and merges additionalSources.
+ *
+ * Heavily parameterized by MarketingSiteSitemapConfig (enables for indexes, include* for download/external articles,
+ * localeConfig, additionalSources). The injected urlCalculators from converterContext are used both for
+ * reconstructing some article hrefs and for emitting index / tag-type / people listing entries.
+ */
+export declare function createMarketingSiteSitemapEntries(deps: CreateMarketingSiteSitemapEntriesDeps, config: MarketingSiteSitemapConfig): (options: {
+    includeUnindexed?: boolean;
+}) => Promise<SitemapEntry[]>;
+export {};
+//# sourceMappingURL=marketingSiteSitemap.d.ts.map

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

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