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

package/dist/converters/customType.js

@@ -0,0 +1,93 @@
+import { resolvedMeta } from '@se-studio/core-data-types';
+import { addPositionMetadata, createInternalLink, lookupAsset, makeContentfulDescription, makeContentfulTitle, shouldResolveContents, shouldResolveNavigation, } from './helpers.js';
+import { collectIconsFromContent, collectIconsFromNavigation, deduplicateIcons, } from './iconCollector.js';
+import { resolveNavigationOrStub } from './navigationItem.js';
+import { resolvePageContent, resolveSchema } from './resolver.js';
+import { resolveTemplate } from './template.js';
+/**
+ * Base converter for Contentful Custom Type entries to IBaseCustomType
+ *
+ * Custom types represent index pages for categories like Topics or Resources.
+ * They provide configuration for both the main index page and potentially
+ * individual entry pages.
+ *
+ * @param context - Converter context containing includes and assets
+ * @param entry - Contentful entry to convert
+ * @returns IBaseCustomType object
+ *
+ * @example
+ * ```ts
+ * const customType = baseCustomTypeConverter(context, contentfulEntry);
+ * ```
+ */
+export function baseCustomTypeConverter(context, entry) {
+    const { sys, fields } = entry;
+    const { id } = sys;
+    const { name, slug, indexPageName, indexPageTitle, indexPageDescription, featuredImage, menu: menuLink, footer: footerLink, indexPageTemplate: templateLink, indexPageTopContent: topContentLinks, structuredData: _entryStructuredData, indexPageStructuredData, meta: customTypeMeta, backgroundColour: customTypeBackgroundColour, textColour: customTypeTextColour, ...other } = fields;
+    const title = makeContentfulTitle(indexPageName ?? indexPageTitle, sys.id);
+    const description = makeContentfulDescription(indexPageDescription, sys.id);
+    if (!shouldResolveNavigation(context) && !shouldResolveContents(context)) {
+        return {
+            type: 'Custom type',
+            id,
+            slug,
+            name,
+            title,
+            description,
+            featuredImage: lookupAsset(context, featuredImage),
+            href: context.urlCalculators.customType(slug),
+            contentCount: 0,
+            ...other,
+            backgroundColour: customTypeBackgroundColour,
+            textColour: customTypeTextColour,
+            meta: resolvedMeta(customTypeMeta),
+        };
+    }
+    const template = templateLink ? resolveTemplate(context, templateLink) : null;
+    const menu = menuLink ? resolveNavigationOrStub(context, menuLink) : template?.menu;
+    const footer = footerLink ? resolveNavigationOrStub(context, footerLink) : template?.footer;
+    const topContent = shouldResolveContents(context)
+        ? (topContentLinks
+            ?.map((c) => resolvePageContent(context, id, c))
+            .filter((item) => item !== null) ?? [])
+        : [];
+    const preContent = shouldResolveContents(context) ? (template?.preContent ?? []) : [];
+    const postContent = shouldResolveContents(context) ? (template?.postContent ?? []) : [];
+    const contents = shouldResolveContents(context)
+        ? addPositionMetadata([...topContent, ...preContent, ...postContent])
+        : [];
+    const icons = deduplicateIcons(collectIconsFromContent(contents), collectIconsFromNavigation(menu), collectIconsFromNavigation(footer));
+    const customType = {
+        type: 'Custom type',
+        id,
+        slug,
+        name,
+        title,
+        description: description,
+        featuredImage: lookupAsset(context, featuredImage),
+        href: context.urlCalculators.customType(slug),
+        contentCount: 0,
+        contents,
+        icons,
+        structuredData: shouldResolveContents(context)
+            ? [
+                ...(indexPageStructuredData?.map((link) => resolveSchema(context, id, link)) ?? []),
+            ].filter((item) => item !== null)
+            : undefined,
+        menu,
+        footer,
+        backgroundColour: customTypeBackgroundColour ?? template?.backgroundColour,
+        textColour: customTypeTextColour ?? template?.textColour,
+        meta: resolvedMeta(template?.meta, customTypeMeta),
+        ...other,
+    };
+    return customType;
+}
+export function baseCustomTypeLinkConverter(context, entry) {
+    const { sys: { id, contentType }, fields, } = entry;
+    if (contentType.sys.id !== 'customType') {
+        throw new Error(`Invalid content type: expected "customType", got "${contentType.sys.id}"`);
+    }
+    return createInternalLink(id, fields, context, context.urlCalculators.customType(fields.slug), 'CustomType');
+}
+//# sourceMappingURL=customType.js.map

package/dist/converters/customType.js.map

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

package/dist/converters/document.d.ts

@@ -0,0 +1,14 @@
+import type { IBaseDocument } from '@se-studio/core-data-types';
+import type { Entry } from 'contentful';
+import type { DefaultChainModifier } from '../api';
+import type { BaseDocumentSkeleton } from '../baseTypes/baseDocument';
+import { type ConverterContext } from './helpers';
+/**
+ * Converts a Contentful document entry to {@link IBaseDocument}.
+ *
+ * Public file links always go through `urlCalculators.download` (site proxy).
+ * Optional hop-page href uses `urlCalculators.document(slug)` when provided;
+ * otherwise falls back to the file proxy href, then `#`.
+ */
+export declare function baseDocumentConverter(context: ConverterContext, entry: Entry<BaseDocumentSkeleton, DefaultChainModifier, string>): IBaseDocument;
+//# sourceMappingURL=document.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/converters/document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EACL,KAAK,gBAAgB,EAItB,MAAM,WAAW,CAAC;AAmBnB;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,KAAK,CAAC,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,CAAC,GAC/D,aAAa,CAwCf"}

package/dist/converters/document.js

@@ -0,0 +1,51 @@
+import { lookupDownloadAsset, makeContentfulDescription, makeContentfulTitle, } from './helpers.js';
+const DOCUMENT_TYPES = new Set([
+    'Compliance',
+    'Marketing',
+    'Fact Sheet',
+    'Report',
+    'Prospectus',
+    'Holdings',
+    'Regulatory',
+    'Other',
+]);
+function normalizeDocumentType(raw) {
+    if (typeof raw !== 'string' || raw.length === 0)
+        return null;
+    if (DOCUMENT_TYPES.has(raw))
+        return raw;
+    return raw;
+}
+/**
+ * Converts a Contentful document entry to {@link IBaseDocument}.
+ *
+ * Public file links always go through `urlCalculators.download` (site proxy).
+ * Optional hop-page href uses `urlCalculators.document(slug)` when provided;
+ * otherwise falls back to the file proxy href, then `#`.
+ */
+export function baseDocumentConverter(context, entry) {
+    const { sys: { id, contentType }, fields, } = entry;
+    if (contentType.sys.id !== 'document') {
+        throw new Error(`Invalid content type: expected "document", got "${contentType.sys.id}"`);
+    }
+    const { name, slug, description, title, documentType: rawDocumentType, file: fileLink, publishDate, ...rest } = fields;
+    const file = lookupDownloadAsset(context, fileLink) ?? null;
+    const displayTitle = makeContentfulTitle(title ?? name, id);
+    const hopHref = context.urlCalculators.document?.(slug);
+    const href = hopHref ?? file?.href ?? '#';
+    return {
+        type: 'Document',
+        id,
+        slug,
+        name: name ?? displayTitle,
+        title: displayTitle,
+        description: makeContentfulDescription(description, id),
+        href,
+        contentCount: 0,
+        documentType: normalizeDocumentType(rawDocumentType),
+        file,
+        publishDate: publishDate ?? null,
+        ...rest,
+    };
+}
+//# sourceMappingURL=document.js.map

package/dist/converters/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/converters/document.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAEnB,MAAM,cAAc,GAAG,IAAI,GAAG,CAAS;IACrC,YAAY;IACZ,WAAW;IACX,YAAY;IACZ,QAAQ;IACR,YAAY;IACZ,UAAU;IACV,YAAY;IACZ,OAAO;CACR,CAAC,CAAC;AAEH,SAAS,qBAAqB,CAAC,GAAY;IACzC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7D,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,GAA2B,CAAC;IAChE,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAyB,EACzB,KAAgE;IAEhE,MAAM,EACJ,GAAG,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,EACxB,MAAM,GACP,GAAG,KAAK,CAAC;IAEV,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,KAAK,UAAU,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,mDAAmD,WAAW,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,EACJ,IAAI,EACJ,IAAI,EACJ,WAAW,EACX,KAAK,EACL,YAAY,EAAE,eAAe,EAC7B,IAAI,EAAE,QAAQ,EACd,WAAW,EACX,GAAG,IAAI,EACR,GAAG,MAAM,CAAC;IAEX,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC;IAC5D,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,OAAO,IAAI,IAAI,EAAE,IAAI,IAAI,GAAG,CAAC;IAE1C,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,EAAE;QACF,IAAI;QACJ,IAAI,EAAE,IAAI,IAAI,YAAY;QAC1B,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,yBAAyB,CAAC,WAAW,EAAE,EAAE,CAAC;QACvD,IAAI;QACJ,YAAY,EAAE,CAAC;QACf,YAAY,EAAE,qBAAqB,CAAC,eAAe,CAAC;QACpD,IAAI;QACJ,WAAW,EAAE,WAAW,IAAI,IAAI;QAChC,GAAG,IAAI;KACR,CAAC;AACJ,CAAC"}

package/dist/converters/enrichAssets.d.ts

@@ -0,0 +1,19 @@
+import type { IVideoEmbed, IVisual } from '@se-studio/core-data-types';
+import type { PossibleResolvedEntry } from '../api/types';
+import type { FetchOptions } from '../types';
+/**
+ * Runs asset-enrichment steps in parallel and returns the map of pre-fetched oEmbed data for
+ * ConverterContext.
+ *
+ * - seEnrichVideoAssets / imagekitEnrichVideoAssets: R2 mute-loop pack or ImageKit dimensions
+ * - enrichAnimationAssets: fetches Lottie SVG placeholders (mutates assets)
+ * - enrichExternalVideoEmbeds: fetches oEmbed data for external video entries
+ * - enrichPictureBlurPlaceholders: optional; when `fetchOptions.enrichPictureBlurPlaceholders`,
+ *   fetches tiny JPEGs and sets IPicture.blurDataURL (mutates assets)
+ *
+ * @param assets   - Map<assetId, IVisual> built by convertAllAssets
+ * @param includes - Map<entryId, PossibleResolvedEntry> built by convertAllIncludes
+ * @param fetchOptions - When `enrichPictureBlurPlaceholders` is true, picture blur enrichment runs
+ */
+export declare function enrichAllAssets(assets: Map<string, IVisual>, includes: Map<string, PossibleResolvedEntry>, fetchOptions?: Pick<FetchOptions, 'enrichPictureBlurPlaceholders'>): Promise<Map<string, IVideoEmbed>>;
+//# sourceMappingURL=enrichAssets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enrichAssets.d.ts","sourceRoot":"","sources":["../../src/converters/enrichAssets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAQ7C;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,EAC5C,YAAY,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,+BAA+B,CAAC,GACjE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAiBnC"}

package/dist/converters/enrichAssets.js

@@ -0,0 +1,36 @@
+import { enrichAnimationAssets } from './animationEnricher.js';
+import { enrichExternalVideoEmbeds } from './externalVideoEnricher.js';
+import { seEnrichVideoAssets } from './heroVideoEnricher.js';
+import { readHeroVideoEnv } from './heroVideoEnv.js';
+import { enrichPictureBlurPlaceholders } from './pictureBlurEnricher.js';
+import { imagekitEnrichVideoAssets } from './videoEnricher.js';
+/**
+ * Runs asset-enrichment steps in parallel and returns the map of pre-fetched oEmbed data for
+ * ConverterContext.
+ *
+ * - seEnrichVideoAssets / imagekitEnrichVideoAssets: R2 mute-loop pack or ImageKit dimensions
+ * - enrichAnimationAssets: fetches Lottie SVG placeholders (mutates assets)
+ * - enrichExternalVideoEmbeds: fetches oEmbed data for external video entries
+ * - enrichPictureBlurPlaceholders: optional; when `fetchOptions.enrichPictureBlurPlaceholders`,
+ *   fetches tiny JPEGs and sets IPicture.blurDataURL (mutates assets)
+ *
+ * @param assets   - Map<assetId, IVisual> built by convertAllAssets
+ * @param includes - Map<entryId, PossibleResolvedEntry> built by convertAllIncludes
+ * @param fetchOptions - When `enrichPictureBlurPlaceholders` is true, picture blur enrichment runs
+ */
+export async function enrichAllAssets(assets, includes, fetchOptions) {
+    const pictureBlur = fetchOptions?.enrichPictureBlurPlaceholders === true
+        ? enrichPictureBlurPlaceholders(assets)
+        : Promise.resolve();
+    const videoEnrichment = readHeroVideoEnv()
+        ? seEnrichVideoAssets(assets)
+        : imagekitEnrichVideoAssets(assets);
+    const [, , externalVideoEmbeds] = await Promise.all([
+        videoEnrichment,
+        enrichAnimationAssets(assets),
+        enrichExternalVideoEmbeds(includes),
+        pictureBlur,
+    ]);
+    return externalVideoEmbeds;
+}
+//# sourceMappingURL=enrichAssets.js.map

package/dist/converters/enrichAssets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichAssets.js","sourceRoot":"","sources":["../../src/converters/enrichAssets.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAE5D;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAA4B,EAC5B,QAA4C,EAC5C,YAAkE;IAElE,MAAM,WAAW,GACf,YAAY,EAAE,6BAA6B,KAAK,IAAI;QAClD,CAAC,CAAC,6BAA6B,CAAC,MAAM,CAAC;QACvC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAExB,MAAM,eAAe,GAAG,gBAAgB,EAAE;QACxC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC;QAC7B,CAAC,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAEtC,MAAM,CAAC,EAAE,AAAD,EAAG,mBAAmB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAClD,eAAe;QACf,qBAAqB,CAAC,MAAM,CAAC;QAC7B,yBAAyB,CAAC,QAAQ,CAAC;QACnC,WAAW;KACZ,CAAC,CAAC;IACH,OAAO,mBAAmB,CAAC;AAC7B,CAAC"}

package/dist/converters/externalComponent.d.ts

@@ -0,0 +1,27 @@
+import type { IBaseExternalComponent } from '@se-studio/core-data-types';
+import type { Entry } from 'contentful';
+import type { DefaultChainModifier, IContentfulRichText } from '../api';
+import type { BaseExternalComponentSkeleton } from '../baseTypes/baseExternalComponent';
+import { type ConverterContext } from './helpers';
+export type IContentfulExternalComponent = IBaseExternalComponent & {
+    copy?: IContentfulRichText | null;
+    additionalCopy?: IContentfulRichText | null;
+    extraCopy?: IContentfulRichText | null;
+};
+/**
+ * Base converter for Contentful ExternalComponent entries to IExternalComponent type
+ *
+ * This is a minimal implementation that can be extended using
+ * the functional composition pattern.
+ *
+ * @param context - Converter context containing assets, includes, and resolvers
+ * @param entry - Contentful entry to convert
+ * @returns IExternalComponent object
+ *
+ * @example
+ * ```ts
+ * const externalComponent = baseExternalComponentConverter(context, contentfulEntry);
+ * ```
+ */
+export declare function baseExternalComponentConverter(context: ConverterContext, entry: Entry<BaseExternalComponentSkeleton, DefaultChainModifier, string>): IContentfulExternalComponent;
+//# sourceMappingURL=externalComponent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"externalComponent.d.ts","sourceRoot":"","sources":["../../src/converters/externalComponent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AACxE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAExF,OAAO,EACL,KAAK,gBAAgB,EAKtB,MAAM,WAAW,CAAC;AAGnB,MAAM,MAAM,4BAA4B,GAAG,sBAAsB,GAAG;IAClE,IAAI,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClC,cAAc,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC5C,SAAS,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACxC,CAAC;AACF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,KAAK,CAAC,6BAA6B,EAAE,oBAAoB,EAAE,MAAM,CAAC,GACxE,4BAA4B,CA8C9B"}

package/dist/converters/externalComponent.js

@@ -0,0 +1,46 @@
+import { applyHideMobileBackgroundFlag, createResponsiveVisual } from './asset.js';
+import { DEFAULT_POSITION_FIELDS, lookupAsset, lookupDownloadAsset, makeContentfulTitle, } from './helpers.js';
+import { resolveLink, resolveRichTextDocument } from './resolver.js';
+/**
+ * Base converter for Contentful ExternalComponent entries to IExternalComponent type
+ *
+ * This is a minimal implementation that can be extended using
+ * the functional composition pattern.
+ *
+ * @param context - Converter context containing assets, includes, and resolvers
+ * @param entry - Contentful entry to convert
+ * @returns IExternalComponent object
+ *
+ * @example
+ * ```ts
+ * const externalComponent = baseExternalComponentConverter(context, contentfulEntry);
+ * ```
+ */
+export function baseExternalComponentConverter(context, entry) {
+    const { sys, fields } = entry;
+    const { id } = sys;
+    const { cmsLabel, backgroundVisual: bgVisual, mobileBackgroundVisual: mobileBgVisual, internalLink: internalLinkField, attachment: attachmentField, copy: copyField, additionalCopy: additionalCopyField, extraCopy: extraCopyField, flags, ...simpleFields } = fields;
+    // Convert background visuals to responsive visual
+    const backgroundVisual = applyHideMobileBackgroundFlag(createResponsiveVisual(lookupAsset(context, bgVisual), lookupAsset(context, mobileBgVisual)), flags);
+    const internalLink = internalLinkField ? resolveLink(context, id, internalLinkField) : null;
+    const attachment = attachmentField ? lookupDownloadAsset(context, attachmentField) : null;
+    const copy = resolveRichTextDocument(context, id, copyField);
+    const additionalCopy = resolveRichTextDocument(context, id, additionalCopyField);
+    const extraCopy = resolveRichTextDocument(context, id, extraCopyField);
+    const externalComponent = {
+        type: 'External component',
+        id,
+        name: makeContentfulTitle(cmsLabel, id),
+        cmsLabel: cmsLabel,
+        ...DEFAULT_POSITION_FIELDS,
+        ...simpleFields,
+        backgroundVisual,
+        copy,
+        additionalCopy,
+        extraCopy,
+        internalLink: internalLink ?? undefined,
+        attachment: attachment ?? undefined,
+    };
+    return externalComponent;
+}
+//# sourceMappingURL=externalComponent.js.map

package/dist/converters/externalComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"externalComponent.js","sourceRoot":"","sources":["../../src/converters/externalComponent.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAChF,OAAO,EAEL,uBAAuB,EACvB,WAAW,EACX,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAOlE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,8BAA8B,CAC5C,OAAyB,EACzB,KAAyE;IAEzE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAC9B,MAAM,EAAE,EAAE,EAAE,GAAG,GAAG,CAAC;IAEnB,MAAM,EACJ,QAAQ,EACR,gBAAgB,EAAE,QAAQ,EAC1B,sBAAsB,EAAE,cAAc,EACtC,YAAY,EAAE,iBAAiB,EAC/B,UAAU,EAAE,eAAe,EAC3B,IAAI,EAAE,SAAS,EACf,cAAc,EAAE,mBAAmB,EACnC,SAAS,EAAE,cAAc,EACzB,KAAK,EACL,GAAG,YAAY,EAChB,GAAG,MAAM,CAAC;IAEX,kDAAkD;IAClD,MAAM,gBAAgB,GAAG,6BAA6B,CACpD,sBAAsB,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,EAC5F,KAAK,CACN,CAAC;IAEF,MAAM,YAAY,GAAG,iBAAiB,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE5F,MAAM,UAAU,GAAG,eAAe,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE1F,MAAM,IAAI,GAAG,uBAAuB,CAAC,OAAO,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;IAC7D,MAAM,cAAc,GAAG,uBAAuB,CAAC,OAAO,EAAE,EAAE,EAAE,mBAAmB,CAAC,CAAC;IACjF,MAAM,SAAS,GAAG,uBAAuB,CAAC,OAAO,EAAE,EAAE,EAAE,cAAc,CAAC,CAAC;IAEvE,MAAM,iBAAiB,GAAiC;QACtD,IAAI,EAAE,oBAAoB;QAC1B,EAAE;QACF,IAAI,EAAE,mBAAmB,CAAC,QAAQ,EAAE,EAAE,CAAC;QACvC,QAAQ,EAAE,QAAQ;QAClB,GAAG,uBAAuB;QAC1B,GAAG,YAAY;QACf,gBAAgB;QAChB,IAAI;QACJ,cAAc;QACd,SAAS;QACT,YAAY,EAAE,YAAY,IAAI,SAAS;QACvC,UAAU,EAAE,UAAU,IAAI,SAAS;KACpC,CAAC;IACF,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}

package/dist/converters/externalVideoEnricher.d.ts

@@ -0,0 +1,12 @@
+import type { IVideoEmbed } from '@se-studio/core-data-types';
+import type { PossibleResolvedEntry } from '../api/types';
+/**
+ * Pre-fetches oEmbed data for all external video entries in the includes map.
+ * Returns a Map<entryId, IVideoEmbed> so converters can attach embed data
+ * synchronously without making async calls at render time. The results are
+ * serialised into the ISR cache as part of the converted page data.
+ *
+ * @param includes - The Map<entryId, PossibleResolvedEntry> built by convertAllIncludes
+ */
+export declare function enrichExternalVideoEmbeds(includes: Map<string, PossibleResolvedEntry>): Promise<Map<string, IVideoEmbed>>;
+//# sourceMappingURL=externalVideoEnricher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"externalVideoEnricher.d.ts","sourceRoot":"","sources":["../../src/converters/externalVideoEnricher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AA8D1D;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAC3C,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAsBnC"}

package/dist/converters/externalVideoEnricher.js

@@ -0,0 +1,70 @@
+/**
+ * Returns the oEmbed endpoint URL for a known video provider, or undefined for
+ * unrecognised URLs. Using hardcoded patterns (rather than HTML discovery) lets
+ * us use Next.js native fetch with cache tags instead of delegating to a
+ * library whose internal fetch call bypasses the ISR cache.
+ */
+function getOEmbedEndpoint(url) {
+    if (/youtube\.com|youtu\.be/.test(url)) {
+        return `https://www.youtube.com/oembed?url=${encodeURIComponent(url)}&format=json`;
+    }
+    if (/vimeo\.com/.test(url)) {
+        return `https://vimeo.com/api/oembed.json?url=${encodeURIComponent(url)}`;
+    }
+    return undefined;
+}
+/**
+ * Fetches oEmbed data for a known external video URL using Next.js native fetch
+ * so the response is cached via `force-cache`. Returns undefined for unrecognised
+ * providers or on any fetch failure.
+ */
+async function fetchOEmbedData(url) {
+    const endpoint = getOEmbedEndpoint(url);
+    if (!endpoint)
+        return undefined;
+    try {
+        const response = await fetch(endpoint, {
+            cache: 'force-cache',
+        });
+        if (!response.ok)
+            return undefined;
+        const data = (await response.json());
+        if (data.type !== 'video' || !data.html)
+            return undefined;
+        return {
+            html: data.html,
+            width: data.width,
+            height: data.height,
+            thumbnailUrl: data.thumbnail_url,
+            title: data.title,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Pre-fetches oEmbed data for all external video entries in the includes map.
+ * Returns a Map<entryId, IVideoEmbed> so converters can attach embed data
+ * synchronously without making async calls at render time. The results are
+ * serialised into the ISR cache as part of the converted page data.
+ *
+ * @param includes - The Map<entryId, PossibleResolvedEntry> built by convertAllIncludes
+ */
+export async function enrichExternalVideoEmbeds(includes) {
+    const result = new Map();
+    const externalVideoEntries = Array.from(includes.values()).filter((item) => item.type === 'externalVideo');
+    if (externalVideoEntries.length === 0)
+        return result;
+    await Promise.all(externalVideoEntries.map(async (item) => {
+        const url = item.entry.fields.url;
+        if (!url)
+            return;
+        const embed = await fetchOEmbedData(url);
+        if (embed) {
+            result.set(item.id, embed);
+        }
+    }));
+    return result;
+}
+//# sourceMappingURL=externalVideoEnricher.js.map

package/dist/converters/externalVideoEnricher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"externalVideoEnricher.js","sourceRoot":"","sources":["../../src/converters/externalVideoEnricher.ts"],"names":[],"mappings":"AAgBA;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,GAAW;IACpC,IAAI,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,OAAO,sCAAsC,kBAAkB,CAAC,GAAG,CAAC,cAAc,CAAC;IACrF,CAAC;IACD,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,yCAAyC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;IAC5E,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,eAAe,CAAC,GAAW;IACxC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;YACrC,KAAK,EAAE,aAAa;SACN,CAAC,CAAC;QAElB,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,SAAS,CAAC;QAEnC,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAwB,CAAC;QAC5D,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAE1D,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,YAAY,EAAE,IAAI,CAAC,aAAa;YAChC,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,QAA4C;IAE5C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE9C,MAAM,oBAAoB,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAC/D,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe,CACxC,CAAC;IAEF,IAAI,oBAAoB,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAErD,MAAM,OAAO,CAAC,GAAG,CACf,oBAAoB,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACtC,MAAM,GAAG,GAAI,IAAI,CAAC,KAAK,CAAC,MAA8B,CAAC,GAAG,CAAC;QAC3D,IAAI,CAAC,GAAG;YAAE,OAAO;QAEjB,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/converters/helpers.d.ts

@@ -0,0 +1,173 @@
+import type { IDownloadAsset, IInternalLink, InternalType, ITyped, IVideoEmbed, IVisual } from '@se-studio/core-data-types';
+import type { Asset, Entry, UnresolvedLink } from 'contentful';
+import type { DefaultChainModifier, PossibleResolvedEntry } from '../api';
+import { type ConverterResolutionScope } from '../api/listing-fetch-params';
+import type { BaseContent, BaseLink } from '../baseTypes/baseShared';
+import type { CmsError } from '../types';
+import type { PrimaryTagSelector } from '../utils/tags';
+import type { baseArticleConverter, baseArticleTypeConverter } from './article';
+import type { baseBannerConverter } from './banner';
+import type { baseCollectionConverter } from './collection';
+import type { baseComponentConverter } from './component';
+import type { baseCustomTypeConverter } from './customType';
+import type { baseDocumentConverter } from './document';
+import type { baseNavigationItemConverter } from './navigationItem';
+import type { basePageConverter } from './page';
+import type { baseTagConverter } from './tag';
+import type { baseTagTypeConverter } from './tagType';
+export declare function resolveBuildYear(value: string | null | undefined): string | undefined;
+export declare function makeContentfulTitle(title: string | undefined | null, id: string, prefix?: string): string;
+export declare function stringOrUndefined(value: string | null | undefined): string | undefined;
+export declare function makeContentfulDescription(description: string | undefined | null, id: string): string;
+export declare function lookupAsset(context: ConverterContext, asset: UnresolvedLink<'Asset'> | undefined): IVisual | undefined;
+/**
+ * Looks up entries from a list of unresolved links
+ */
+export declare function lookupEntries(context: ConverterContext, entries: UnresolvedLink<'Entry'>[] | undefined): PossibleResolvedEntry[];
+/**
+ * Looks up an asset that is used as an icon.
+ * If the asset is an SVG image, it marks it with isIcon: true so it uses the sprite system.
+ */
+export declare function lookupIconAsset(context: ConverterContext, asset: UnresolvedLink<'Asset'> | undefined): IVisual | undefined;
+/**
+ * Looks up a raw asset and converts it to IDownloadAsset for download functionality.
+ * Returns undefined if the asset doesn't exist or doesn't have a valid file.
+ */
+export declare function buildDownloadAssetFromRawAsset(context: BaseConverterContext, rawAsset: Asset): IDownloadAsset | undefined;
+export declare function lookupDownloadAsset(context: ConverterContext, asset: UnresolvedLink<'Asset'> | undefined): IDownloadAsset | undefined;
+/**
+ * Default positioning fields for content items before they are processed
+ */
+export declare const DEFAULT_POSITION_FIELDS: {
+    readonly index: 0;
+    readonly isFirst: false;
+    readonly isLast: false;
+    readonly indexOfType: 0;
+};
+/**
+ * Creates an internal link object with common fields
+ * Used by multiple converters (tag, page, article, person) to reduce duplication
+ */
+export declare function createInternalLink(id: string, fields: {
+    cmsLabel?: string | null;
+    name: string | null;
+    useName?: boolean | null;
+    title?: string | null;
+    breadcrumbTitle?: string | null;
+    featuredImage?: UnresolvedLink<'Asset'>;
+    backgroundColour?: string | null;
+    textColour?: string | null;
+    indexed?: boolean | null;
+    hidden?: boolean | null;
+    slug: string;
+    description?: string | null;
+}, context: ConverterContext, href: string, internalType: InternalType, additionalProps?: any): IInternalLink;
+export type ContentResolverFunction = (context: ConverterContext, entry: Entry<BaseContent, DefaultChainModifier, string>) => unknown;
+export type ContentResolverMap = Map<string, ContentResolverFunction>;
+export type LinkResolverFunction<TResult extends IInternalLink = IInternalLink> = (context: ConverterContext, entry: Entry<BaseLink, DefaultChainModifier, string>) => TResult;
+export type LinkResolverMap = Map<string, LinkResolverFunction>;
+/**
+ * URL calculators for each content type.
+ * Apps can (and must) override these to customize URL patterns for their project.
+ *
+ * These are called by link converters, sitemap generators, preview, breadcrumbs,
+ * markdown canonicals, and search indexing. All consuming projects (see docs/RELATED_PROJECTS.md
+ * and docs/routing.md) provide their own implementations matching their app routes and
+ * MarketingSiteSitemapConfig.
+ *
+ * Return values should typically include a trailing slash for page-like paths (except downloads).
+ */
+export type UrlCalculators = {
+    page: (slug: string) => string;
+    pageVariant: (slug: string) => string;
+    article: (articleTypeSlug: string, slug: string, primaryTagSlug?: string) => string;
+    articleType: (slug: string) => string;
+    articleTypeTag: (articleTypeSlug: string, tagSlug: string) => string;
+    tag: (slug: string) => string;
+    person: (slug: string) => string;
+    team: () => string;
+    customType: (slug: string) => string;
+    tagType: (slug: string) => string;
+    download: (assetId: string, filename: string) => string;
+    /**
+     * Optional hop-page URL for Document entries (e.g. `/documents/${slug}/`).
+     * When omitted, document `href` falls back to the download-proxy path for the file.
+     */
+    document?: (slug: string) => string;
+};
+export type BaseConverterContext = {
+    videoPrefix: string;
+    /**
+     * Resolves a mask dropdown value (e.g., 'Rounded diamond') to a URL.
+     * Each project provides its own implementation with project-specific masks.
+     */
+    maskResolver?: (maskName: string) => string | undefined;
+    /**
+     * Resolves a gradient dropdown value to a CSS gradient string.
+     * Each project provides its own implementation with project-specific gradients.
+     */
+    gradientResolver?: (gradientName: string) => string | undefined;
+    /**
+     * URL calculators for each content type.
+     * Apps can override these to customize URL patterns for links, sitemaps, and preview.
+     */
+    urlCalculators: UrlCalculators;
+    /**
+     * Optional project resolvers for Contentful Live Preview entry → URL lookup.
+     * Keys are Contentful content type ids (e.g. `location`). Used by
+     * getPreviewEntryInfo when the content type is not a built-in type.
+     * See {@link import('../api/preview-types').PreviewEntryResolver}.
+     */
+    previewEntryResolvers?: Readonly<Record<string, import('../api/preview-types').PreviewEntryResolver>>;
+    linkResolver: LinkResolverMap;
+    contentResolver: Map<string, (context: ConverterContext, entry: Entry<BaseContent, DefaultChainModifier, string>) => unknown>;
+    navigationItemResolver: typeof baseNavigationItemConverter;
+    pageResolver: typeof basePageConverter;
+    articleResolver: typeof baseArticleConverter;
+    articleTypeResolver: typeof baseArticleTypeConverter;
+    tagResolver: typeof baseTagConverter;
+    tagTypeResolver: typeof baseTagTypeConverter;
+    personResolver: typeof import('./person').basePersonConverter;
+    customTypeResolver: typeof baseCustomTypeConverter;
+    componentResolver: typeof baseComponentConverter;
+    collectionResolver: typeof baseCollectionConverter;
+    bannerResolver: typeof baseBannerConverter;
+    documentResolver: typeof baseDocumentConverter;
+    redirectResolver: typeof import('./redirect').baseRedirectConverter;
+    /**
+     * Optional selector to determine the primary tag for URL generation.
+     * Receives each tag and the article type; return true for the desired primary tag.
+     * Falls back to tags[0] when omitted or no match found.
+     */
+    primaryTagSelector?: PrimaryTagSelector;
+};
+export type ConverterContext = BaseConverterContext & {
+    includes: Map<string, PossibleResolvedEntry>;
+    assets: Map<string, IVisual>;
+    rawAssets: Map<string, Asset>;
+    errors: CmsError[];
+    externalVideoEmbeds: Map<string, IVideoEmbed>;
+    /** When omitted, treated as full page resolution (nav + contents). */
+    resolutionScope?: ConverterResolutionScope;
+};
+export declare function getResolutionScope(context: ConverterContext): ConverterResolutionScope;
+export declare function shouldResolveNavigation(context: ConverterContext): boolean;
+export declare function shouldResolveContents(context: ConverterContext): boolean;
+/**
+ * Adds position metadata to an array of content items
+ * Each item gets: index, isFirst, isLast, indexOfType
+ *
+ * indexOfType is keyed by CMS-facing type (componentType, collectionType, etc.),
+ * not structural item.type.
+ *
+ * @param items - Array of content items to add metadata to
+ * @returns New array with position metadata added to each item
+ */
+export declare function addPositionMetadata<T extends ITyped & {
+    index?: number;
+    isFirst?: boolean;
+    isLast?: boolean;
+    indexOfType?: number;
+}>(items: T[]): T[];
+export declare function calculateContentCount(...contents: ITyped[][]): number;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/converters/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,MAAM,EACN,WAAW,EACX,OAAO,EACR,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAC;AAC1E,OAAO,EAAE,KAAK,wBAAwB,EAAyB,MAAM,6BAA6B,CAAC;AACnG,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEtD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAMrF;AACD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAChC,EAAE,EAAE,MAAM,EACV,MAAM,SAAe,UAGtB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,sBAKjE;AACD,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,UAE3F;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,SAAS,uBAGhG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,GAAG,SAAS,GAC7C,qBAAqB,EAAE,CAWzB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,SAAS,GACzC,OAAO,GAAG,SAAS,CAgBrB;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,EAAE,KAAK,GACd,cAAc,GAAG,SAAS,CAmB5B;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,SAAS,GACzC,cAAc,GAAG,SAAS,CAO5B;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;CAK1B,CAAC;AAEX;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE;IACN,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,EACD,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,YAAY,EAE1B,eAAe,CAAC,EAAE,GAAG,GACpB,aAAa,CAqCf;AAED,MAAM,MAAM,uBAAuB,GAAG,CACpC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,oBAAoB,EAAE,MAAM,CAAC,KACpD,OAAO,CAAC;AACb,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;AACtE,MAAM,MAAM,oBAAoB,CAAC,OAAO,SAAS,aAAa,GAAG,aAAa,IAAI,CAChF,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,oBAAoB,EAAE,MAAM,CAAC,KACjD,OAAO,CAAC;AACb,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAEhE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/B,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACtC,OAAO,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACpF,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACtC,cAAc,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACrE,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACjC,IAAI,EAAE,MAAM,MAAM,CAAC;IACnB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACrC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAClC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IACxD;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACxD;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAChE;;;OAGG;IACH,cAAc,EAAE,cAAc,CAAC;IAC/B;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,QAAQ,CAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,sBAAsB,EAAE,oBAAoB,CAAC,CACpE,CAAC;IACF,YAAY,EAAE,eAAe,CAAC;IAC9B,eAAe,EAAE,GAAG,CAClB,MAAM,EACN,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,oBAAoB,EAAE,MAAM,CAAC,KAAK,OAAO,CAChG,CAAC;IACF,sBAAsB,EAAE,OAAO,2BAA2B,CAAC;IAC3D,YAAY,EAAE,OAAO,iBAAiB,CAAC;IACvC,eAAe,EAAE,OAAO,oBAAoB,CAAC;IAC7C,mBAAmB,EAAE,OAAO,wBAAwB,CAAC;IACrD,WAAW,EAAE,OAAO,gBAAgB,CAAC;IACrC,eAAe,EAAE,OAAO,oBAAoB,CAAC;IAC7C,cAAc,EAAE,cAAc,UAAU,EAAE,mBAAmB,CAAC;IAC9D,kBAAkB,EAAE,OAAO,uBAAuB,CAAC;IACnD,iBAAiB,EAAE,OAAO,sBAAsB,CAAC;IACjD,kBAAkB,EAAE,OAAO,uBAAuB,CAAC;IACnD,cAAc,EAAE,OAAO,mBAAmB,CAAC;IAC3C,gBAAgB,EAAE,OAAO,qBAAqB,CAAC;IAC/C,gBAAgB,EAAE,cAAc,YAAY,EAAE,qBAAqB,CAAC;IACpE;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG;IACpD,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC7C,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9B,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC9C,sEAAsE;IACtE,eAAe,CAAC,EAAE,wBAAwB,CAAC;CAC5C,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,wBAAwB,CAEtF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAE1E;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAExE;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,CAAC,SAAS,MAAM,GAAG;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,EACD,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAkBjB;AAED,wBAAgB,qBAAqB,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAErE"}