@ethlete/contentful 4.0.0-next.1 → 4.0.0-next.11

package/types/ethlete-contentful.d.ts

@@ -1,19 +1,21 @@
 import * as _angular_core from '@angular/core';
-import { ViewContainerRef, ElementRef, ComponentRef, InputSignal, InjectionToken } from '@angular/core';
+import { Type, InputSignal, InjectionToken, Provider } from '@angular/core';
+import * as _ethlete_core from '@ethlete/core';
 import { NgClassType } from '@ethlete/core';
-import * as _ethlete_query from '@ethlete/query';
-import { ComponentType } from '@angular/cdk/portal';
+import { GQL } from '@ethlete/query';
 import { Mark, BLOCKS, INLINES, NodeData, Block } from '@contentful/rich-text-types';
 import * as _ethlete_contentful from '@ethlete/contentful';
-import * as _ethlete_cdk from '@ethlete/cdk';
-import { PictureSource } from '@ethlete/cdk';
+import * as _ethlete_components from '@ethlete/components';
+import { PictureSource } from '@ethlete/components';
+import * as _angular_router from '@angular/router';
 
-declare const GQL_FRAGMENT_CONTENTFUL_ASSET: _ethlete_query.GQL;
+declare const GQL_FRAGMENT_CONTENTFUL_ASSET: GQL;
 type ContentfulGqlAsset = {
     sys: {
         id: string;
     };
     title: string | null;
+    fileName?: string | null;
     contentType: string | null;
     url: string | null;
     description: string | null;
@@ -86,111 +88,17 @@ type ContentfulGqlCollectionFilterVariables<TCustomWhere extends Record<string,
     locale?: string;
 };
 
-declare const RENDER_COMMAND_TYPE: {
-    readonly HTML_OPEN: 0;
-    readonly HTML_CLOSE: 1;
-    readonly TEXT: 2;
-    readonly COMPONENT: 3;
-};
-declare const RENDER_COMMAND_POSITION: {
-    readonly TYPE: 0;
-    readonly NESTING_LEVEL: 1;
-    readonly DOM_POSITION: 2;
-    readonly INDEX: 3;
-};
-declare const HTML_OPEN_RENDER_COMMAND_POSITION: {
-    readonly ATTRIBUTES: 4;
-    readonly TAG_NAME: 5;
-    readonly ELEMENT_ID: 6;
-};
-declare const HTML_CLOSE_RENDER_COMMAND_POSITION: {
-    readonly TAG_NAME: 4;
-    readonly ELEMENT_ID: 5;
-};
-declare const TEXT_RENDER_COMMAND_POSITION: {
-    readonly ATTRIBUTES: 4;
-    readonly TEXT: 5;
-    readonly TEXT_ID: 6;
-};
-declare const COMPONENT_RENDER_COMMAND_POSITION: {
-    readonly ATTRIBUTES: 4;
-    readonly COMPONENT: 5;
-    readonly INPUTS: 6;
-    readonly COMPONENT_ID: 7;
-};
-type HtmlOpenRenderCommand = [
-    type: typeof RENDER_COMMAND_TYPE.HTML_OPEN,
-    nestingLevel: number,
-    domPosition: number,
-    index: number,
-    attributes: Record<string, string>,
-    tagName: keyof HTMLElementTagNameMap,
-    textId: string
-];
-type HtmlCloseRenderCommand = [
-    type: typeof RENDER_COMMAND_TYPE.HTML_CLOSE,
-    nestingLevel: number,
-    domPosition: number,
-    index: number,
-    tagName: keyof HTMLElementTagNameMap,
-    elementId: string
-];
-type TextRenderCommand = [
-    type: typeof RENDER_COMMAND_TYPE.TEXT,
-    nestingLevel: number,
-    domPosition: number,
-    index: number,
-    attributes: Record<string, string>,
-    text: string,
-    elementId: string
-];
-type ComponentRenderCommand = [
-    type: typeof RENDER_COMMAND_TYPE.COMPONENT,
-    nestingLevel: number,
-    domPosition: number,
-    index: number,
-    attributes: Record<string, string>,
-    component: ComponentType<unknown>,
-    inputs: Record<string, unknown>,
-    componentId: string
-];
-type RenderCommand = HtmlOpenRenderCommand | HtmlCloseRenderCommand | TextRenderCommand | ComponentRenderCommand;
-declare const RENDER_INSTRUCTION_POSITION: {
-    readonly TYPE: 0;
-    readonly COMMAND: 1;
-};
-declare const RENDER_INSTRUCTION_TYPE: {
-    readonly CREATE: 0;
-    readonly UPDATE: 1;
-    readonly DELETE: 2;
-    readonly MOVE: 3;
-};
-type RenderInstructionTypeValue = (typeof RENDER_INSTRUCTION_TYPE)[keyof typeof RENDER_INSTRUCTION_TYPE];
-type RenderInstruction = [RenderInstructionTypeValue, RenderCommand];
+type MarkTagName = 'strong' | 'em' | 'u' | 'code' | 's' | 'sub' | 'sup';
+/**
+ * Translates contentful text marks into the semantic html elements the marked text is
+ * wrapped in, outermost first. Unknown marks are skipped (with a dev-mode warning).
+ */
+declare const marksToTags: (marks: Mark[]) => MarkTagName[];
+/**
+ * The classes marked text inside a hyperlink is rendered with, since the link component
+ * receives its text as a plain string.
+ */
 declare const marksToClass: (marks: Mark[]) => string;
-declare const isHtmlOpenRenderCommand: (command: RenderCommand) => command is HtmlOpenRenderCommand;
-declare const isHtmlCloseRenderCommand: (command: RenderCommand) => command is HtmlCloseRenderCommand;
-declare const isTextRenderCommand: (command: RenderCommand) => command is TextRenderCommand;
-declare const isComponentRenderCommand: (command: RenderCommand) => command is ComponentRenderCommand;
-declare const getRenderCommandId: (command: RenderCommand) => string;
-type ExecutedCommandCacheItemBase = {
-    element: HTMLElement;
-};
-type ExecutedComponentCommandCacheItem = {
-    command: ComponentRenderCommand;
-    componentRef: ComponentRef<unknown>;
-} & ExecutedCommandCacheItemBase;
-type ExecutedHtmlCommandCacheItem = {
-    command: HtmlOpenRenderCommand | HtmlCloseRenderCommand;
-} & ExecutedCommandCacheItemBase;
-type ExecutedTextCommandCacheItem = {
-    command: TextRenderCommand;
-    textNode: unknown;
-} & ExecutedCommandCacheItemBase;
-type ExecutedCommandCacheItem = ExecutedComponentCommandCacheItem | ExecutedHtmlCommandCacheItem | ExecutedTextCommandCacheItem;
-declare const isExecutedComponentCommandCacheItem: (cache: ExecutedCommandCacheItem) => cache is ExecutedComponentCommandCacheItem;
-declare const isExecutedHtmlOrTextCommandCacheItem: (cache: ExecutedCommandCacheItem) => cache is ExecutedHtmlCommandCacheItem;
-declare const isExecutedTextCommandCacheItem: (cache: ExecutedCommandCacheItem) => cache is ExecutedTextCommandCacheItem;
 declare const ET_CONTENTFUL_ANY_ENTRY_CONTENT_TYPE_SYS_ID = "$$$_et-contentful-any-entry-content-type-sys-id";
 type ContentfulIncludeMap = {
     /**
@@ -236,49 +144,11 @@ type CreateContentfulIncludeMapConfig = {
  */
 declare const createContentfulIncludeMap: (config: CreateContentfulIncludeMapConfig) => ContentfulIncludeMap;
 declare class ContentfulRichTextRendererComponent {
-    _viewContainerRef: ViewContainerRef;
-    _renderer: {
-        addClass: (element: HTMLElement, ...classes: string[]) => void;
-        removeClass: (element: HTMLElement, ...classes: string[]) => void;
-        toggleClass: (element: HTMLElement, className: string, force?: boolean) => boolean;
-        setStyle: (element: HTMLElement, style: Partial<Record<keyof CSSStyleDeclaration, string | null>>, flags?: _angular_core.RendererStyleFlags2) => void;
-        removeStyle: (element: HTMLElement, style: keyof CSSStyleDeclaration | string, flags?: _angular_core.RendererStyleFlags2) => void;
-        removeStyles: (element: HTMLElement, ...styles: (keyof CSSStyleDeclaration | string)[]) => void;
-        setAttribute: (element: HTMLElement, name: string, value: string | null, namespace?: string | null) => void;
-        removeAttribute: (element: HTMLElement, ...names: string[]) => void;
-        setProperty: (element: HTMLElement, name: string, value: unknown) => void;
-        setProperties: (element: HTMLElement, properties: Record<string, unknown>) => void;
-        createElement: <K extends keyof HTMLElementTagNameMap>(tagName: K, namespace?: string | null) => HTMLElementTagNameMap[K];
-        createText: (value: string) => globalThis.Text;
-        createComment: (value: string) => Comment;
-        appendChild: (parent: HTMLElement, newChild: Node) => void;
-        insertBefore: (parent: Node, newChild: Node, refChild: Node | null) => void;
-        removeChild: (parent: Node, oldChild: Node, isHostElement?: boolean) => void;
-        selectRootElement: (selectorOrNode: string | HTMLElement, preserveContent?: boolean) => HTMLElement;
-        parentNode: (node: Node) => Node | null;
-        nextSibling: (node: Node) => Node | null;
-        setValue: (node: Node, value: string) => void;
-        listen: (target: HTMLElement | Window | Document | "window" | "document" | "body", eventName: string, callback: (event: Event) => boolean | void) => (() => void);
-        destroyNode: (node: Node) => void;
-        replaceChild: (parent: Node, newChild: Node, oldChild: Node) => void;
-        empty: (element: HTMLElement) => void;
-        setTextContent: (element: HTMLElement, text: string) => void;
-        setInnerHTML: (element: HTMLElement, html: string) => void;
-        setAttributes: (element: HTMLElement, attributes: Record<string, string | null>, namespace?: string | null) => void;
-        setDataAttributes: (element: HTMLElement, data: Record<string, string | null>) => void;
-        setCssProperty: (element: HTMLElement, name: string, value: string | null) => void;
-        setCssProperties: (element: HTMLElement, properties: Record<string, string | null>) => void;
-        renderer: _angular_core.Renderer2;
-    };
-    _elementRef: ElementRef<HTMLElement>;
-    _document: Document;
-    _config: _ethlete_contentful.ContentfulConfig;
-    /**
-     * A cache for all executed commands that are not deleted.
-     * This is used to keep track of all rendered elements and components.
-     * The key is the render command element ID.
-     */
-    _executedCommandsCache: Map<string, ExecutedCommandCacheItem>;
+    private viewContainerRef;
+    private renderer;
+    private elementRef;
+    private config;
+    private document;
     /**
      * The contentful response gotten via their REST api.
      * @see https://www.contentful.com/developers/docs/references/content-delivery-api/#/reference/entries/entries-collection
@@ -289,60 +159,56 @@ declare class ContentfulRichTextRendererComponent {
      * @example "items[0].fields.html"
      */
     richTextPath: _angular_core.InputSignal<string>;
-    /**
-     * A map of all includes in the contentful response.
-     * This is useful for looking up assets and entries that are referenced in the rich text without having to use loops.
-     */
-    contentIncludesMap: _angular_core.Signal<ContentfulIncludeMap>;
-    /**
-     * The rich text data that should be rendered.
-     */
-    richTextData: _angular_core.Signal<RichTextResponse | null>;
-    renderCommands: _angular_core.Signal<RenderCommand[]>;
-    renderCommandHistory: _angular_core.Signal<[RenderCommand[], RenderCommand[]]>;
-    previousRenderCommandMap: _angular_core.Signal<Map<string | number, RenderCommand>>;
-    renderInstructions: _angular_core.Signal<RenderInstruction[]>;
+    private readonly executedCommandsCache;
+    private contentIncludesMap;
+    private richTextData;
+    private renderCommands;
+    private renderInstructions;
     constructor();
-    private _createRenderCommands;
-    private _execInstructions;
-    private _runCreateInstruction;
-    private _runUpdateInstruction;
-    private _runMoveInstruction;
-    private _runDeleteInstruction;
-    private _getComponentRootNode;
-    private _updateComponentInputs;
-    private _findParent;
-    private _findFollowingElement;
-    private _renderInsertOrAppend;
+    private createRenderCommands;
+    private execInstructions;
+    private runCreateInstruction;
+    private runUpdateInstruction;
+    private runMoveInstruction;
+    private runDeleteInstruction;
+    private getComponentRootNode;
+    private findParent;
+    private renderInsertAfter;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ContentfulRichTextRendererComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ContentfulRichTextRendererComponent, "et-contentful-rich-text-renderer", never, { "content": { "alias": "content"; "required": true; "isSignal": true; }; "richTextPath": { "alias": "richTextPath"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare const isRichTextRootNode: (node: unknown) => node is RichTextResponse;
-declare const translateContentfulNodeTypeToHtmlTag: (nodeType: "text" | BLOCKS | INLINES) => "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "p" | "ul" | "ol" | "li" | "hr" | "blockquote" | "table" | "tr" | "td" | "th" | "div" | "a" | "span";
+/**
+ * The html element a structural rich text node renders as. A node type without an element
+ * (an unsupported inline or block) falls back to `span` for inlines and `div` otherwise,
+ * with a dev-mode warning.
+ */
+declare const translateContentfulNodeTypeToHtmlTag: (nodeType: "text" | BLOCKS | INLINES) => keyof HTMLElementTagNameMap;
 
 type ContentfulImageResizeBehavior = 'pad' | 'crop' | 'fill' | 'scale' | 'thumb' | 'fit';
 type ContentfulImageFocusArea = 'top' | 'bottom' | 'left' | 'right' | 'center' | 'top_left' | 'top_right' | 'bottom_left' | 'bottom_right' | 'face' | 'faces';
-type ComponentLikeWithAsset = ComponentType<{
+type ComponentLikeWithAsset = Type<{
     asset: InputSignal<ContentfulRestAsset | ContentfulGqlAsset | null | undefined>;
 }>;
-type ComponentLikeWithLink = ComponentType<{
+type ComponentLikeWithLink = Type<{
     href: InputSignal<string>;
     text: InputSignal<string>;
     textClass: InputSignal<string>;
+    anchorClass?: InputSignal<string>;
 }>;
-type ComponentLikeWithContentfulRendererInputs = ComponentType<{
+type ComponentLikeWithContentfulRendererInputs = Type<{
     fields?: InputSignal<any>;
     includes?: InputSignal<ContentfulIncludeMap>;
     metadata?: InputSignal<ContentfulMetadata>;
     sys?: InputSignal<ContentfulEntrySys>;
 }>;
 type ContentfulAssetComponents = {
-    file: ComponentLikeWithAsset;
-    image: ComponentLikeWithAsset;
-    video: ComponentLikeWithAsset;
-    audio: ComponentLikeWithAsset;
-    link: ComponentLikeWithLink;
+    file?: ComponentLikeWithAsset;
+    image?: ComponentLikeWithAsset;
+    video?: ComponentLikeWithAsset;
+    audio?: ComponentLikeWithAsset;
+    link?: ComponentLikeWithLink;
 };
 type ContentfulConfig = {
     /**
@@ -353,15 +219,11 @@ type ContentfulConfig = {
      * Component for rendering embedded entries
      */
     customComponents: Record<string, ComponentLikeWithContentfulRendererInputs>;
-    /**
-     * Determines if the contentful rich text renderer should render the contentful rich text with tailwind css classes
-     */
-    useTailwindClasses: boolean;
     /**
      * Additional hostnames that should be treated as internal links (in addition to the current page's host).
      * Useful when the app runs on localhost during development but Contentful content references the production domain.
-     * Comparison is done by primary domain (last two hostname labels), so adding "example.com" is sufficient
-     * to also treat "foo.example.com" as internal.
+     * A configured hostname also covers its subdomains, so adding "example.com" treats
+     * "foo.example.com" as internal without matching unrelated public-suffix siblings.
      *
      * @example ['example.com']
      */
@@ -375,7 +237,7 @@ type ContentfulConfig = {
          * - `"400"` - 400px width
          * - `"400x300"` - 400px width and 300px height
          * - `"400w"` - 400px width
-         * - `"400h"` - 400px height
+         * - `"400h"` - 400px height (requires image dimensions to derive a valid width descriptor)
          * - `"400wx300h"` - 400px width and 300px height
          **/
         srcsetSizes: string[];
@@ -453,7 +315,7 @@ type ContentfulRestAsset = {
     fields: {
         title: string;
         description: string;
-        file: ContentfulAssetFileData;
+        file?: ContentfulAssetFileData;
     };
     metadata: ContentfulMetadata;
 };
@@ -465,9 +327,9 @@ type ContentfulEntry<T = {
     metadata: ContentfulMetadata;
 };
 type ContentfulCollection = {
-    includes: {
-        Asset: ContentfulRestAsset[];
-        Entry: ContentfulEntry[];
+    includes?: {
+        Asset?: ContentfulRestAsset[];
+        Entry?: ContentfulEntry[];
     };
     items: ContentfulEntry[];
     limit: number;
@@ -488,20 +350,38 @@ declare class ContentfulAudioComponent {
     audioClass: _angular_core.InputSignal<NgClassType>;
     figureClass: _angular_core.InputSignal<NgClassType>;
     figcaptionClass: _angular_core.InputSignal<NgClassType>;
-    data: _angular_core.Signal<{
-        url: string | null;
+    protected data: _angular_core.Signal<{
+        url: string;
         title: string | null;
     } | null>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ContentfulAudioComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ContentfulAudioComponent, "et-contentful-audio", never, { "asset": { "alias": "asset"; "required": true; "isSignal": true; }; "audioClass": { "alias": "audioClass"; "required": false; "isSignal": true; }; "figureClass": { "alias": "figureClass"; "required": false; "isSignal": true; }; "figcaptionClass": { "alias": "figcaptionClass"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Every string `et-contentful-file` renders itself. Override them app-wide with {@link provideContentfulFileLabels}. */
+type ContentfulFileLabels = {
+    /** The size shown after the file title, e.g. `'(1.5 MB)'`. */
+    fileSize: (bytes: number) => string;
+};
+/** The built-in English labels. */
+declare const DEFAULT_CONTENTFUL_FILE_LABELS: ContentfulFileLabels;
+/**
+ * Localize `et-contentful-file` for everything below this injector, and read the set in effect here as a signal.
+ * Partial - whatever you leave out keeps its {@link DEFAULT_CONTENTFUL_FILE_LABELS} value.
+ *
+ * @example
+ * provideContentfulFileLabels({ fileSize: (bytes) => `(${new Intl.NumberFormat('de').format(bytes)} Byte)` });
+ */
+declare const provideContentfulFileLabels: (labels: _ethlete_core.LabelsSource<ContentfulFileLabels>) => _angular_core.Provider;
+declare const injectContentfulFileLabels: () => _angular_core.Signal<ContentfulFileLabels>;
+declare const CONTENTFUL_FILE_LABELS: _angular_core.InjectionToken<_ethlete_core.LabelsSource<ContentfulFileLabels>>;
+
 declare class ContentfulFileComponent {
+    protected labels: _angular_core.Signal<_ethlete_contentful.ContentfulFileLabels>;
     asset: _angular_core.InputSignal<ContentfulGqlAsset | ContentfulRestAsset | null | undefined>;
     fileClass: _angular_core.InputSignal<NgClassType>;
-    data: _angular_core.Signal<{
-        url: string | null;
-        contentType: string | null;
+    protected data: _angular_core.Signal<{
+        url: string;
         size: number | null;
         title: string | null;
     } | null>;
@@ -510,29 +390,25 @@ declare class ContentfulFileComponent {
 }
 
 declare class ContentfulImageComponent {
-    _contentfulConfig: _ethlete_contentful.ContentfulConfig;
+    private contentfulConfig;
     asset: _angular_core.InputSignal<ContentfulGqlAsset | ContentfulRestAsset | null | undefined>;
     backgroundColor: _angular_core.InputSignal<string | null>;
     srcsetSizes: _angular_core.InputSignal<string[]>;
     quality: _angular_core.InputSignalWithTransform<number | null, unknown>;
     focusArea: _angular_core.InputSignal<ContentfulImageFocusArea | null>;
     resizeBehavior: _angular_core.InputSignal<ContentfulImageResizeBehavior | null>;
-    hasPriority: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    imgClass: _angular_core.InputSignal<NgClassType>;
-    figureClass: _angular_core.InputSignal<NgClassType>;
-    figcaptionClass: _angular_core.InputSignal<NgClassType>;
-    pictureClass: _angular_core.InputSignal<NgClassType>;
+    priority: _angular_core.InputSignalWithTransform<boolean, unknown>;
     sizes: _angular_core.InputSignalWithTransform<string | null, string | string[] | null>;
-    normalizedAsset: _angular_core.Signal<{
+    protected normalizedAsset: _angular_core.Signal<{
         alt: string | null;
         figcaption: string | null;
         width: number | null;
         height: number | null;
     }>;
-    _sources: _angular_core.Signal<_ethlete_cdk.PictureSource[]>;
-    _defaultSrc: _angular_core.Signal<_ethlete_cdk.PictureSource | null>;
+    protected sourcesValue: _angular_core.Signal<_ethlete_components.PictureSource[]>;
+    protected defaultSrcValue: _angular_core.Signal<_ethlete_components.PictureSource | null>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ContentfulImageComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ContentfulImageComponent, "et-contentful-image", never, { "asset": { "alias": "asset"; "required": true; "isSignal": true; }; "backgroundColor": { "alias": "backgroundColor"; "required": false; "isSignal": true; }; "srcsetSizes": { "alias": "srcsetSizes"; "required": false; "isSignal": true; }; "quality": { "alias": "quality"; "required": false; "isSignal": true; }; "focusArea": { "alias": "focusArea"; "required": false; "isSignal": true; }; "resizeBehavior": { "alias": "resizeBehavior"; "required": false; "isSignal": true; }; "hasPriority": { "alias": "hasPriority"; "required": false; "isSignal": true; }; "imgClass": { "alias": "imgClass"; "required": false; "isSignal": true; }; "figureClass": { "alias": "figureClass"; "required": false; "isSignal": true; }; "figcaptionClass": { "alias": "figcaptionClass"; "required": false; "isSignal": true; }; "pictureClass": { "alias": "pictureClass"; "required": false; "isSignal": true; }; "sizes": { "alias": "sizes"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ContentfulImageComponent, "et-contentful-image", never, { "asset": { "alias": "asset"; "required": true; "isSignal": true; }; "backgroundColor": { "alias": "backgroundColor"; "required": false; "isSignal": true; }; "srcsetSizes": { "alias": "srcsetSizes"; "required": false; "isSignal": true; }; "quality": { "alias": "quality"; "required": false; "isSignal": true; }; "focusArea": { "alias": "focusArea"; "required": false; "isSignal": true; }; "resizeBehavior": { "alias": "resizeBehavior"; "required": false; "isSignal": true; }; "priority": { "alias": "priority"; "required": false; "isSignal": true; }; "sizes": { "alias": "sizes"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare const generateDefaultContentfulImageSource: (data: ContentfulRestAsset | ContentfulGqlAsset) => PictureSource;
@@ -548,27 +424,44 @@ declare const parseContentfulImageSize: (size: string) => {
     width: number | null;
     height: number | null;
 };
-declare const generateContentfulImageSources: (data: ContentfulRestAsset | ContentfulGqlAsset, srcsetSizes: string[], backgroundColor: string | null, quality: number | null, focusArea: ContentfulImageFocusArea | null, resizeBehavior: ContentfulImageResizeBehavior | null) => PictureSource[];
+type ContentfulImageSourcesOptions = {
+    srcsetSizes?: string[];
+    backgroundColor?: string | null;
+    quality?: number | null;
+    focusArea?: ContentfulImageFocusArea | null;
+    resizeBehavior?: ContentfulImageResizeBehavior | null;
+};
+/**
+ * Builds AVIF and WebP `<source>` entries for a Contentful asset through the Contentful Images API.
+ *
+ * @example
+ * generateContentfulImageSources(asset, { srcsetSizes: ['400w', '800w'], quality: 80 });
+ */
+declare const generateContentfulImageSources: (data: ContentfulRestAsset | ContentfulGqlAsset, options?: ContentfulImageSourcesOptions) => PictureSource[];
 
 declare class ContentfulLinkComponent {
-    private readonly _document;
-    private readonly _config;
+    private document;
+    private router;
+    private config;
+    private url;
     href: _angular_core.InputSignal<string>;
     text: _angular_core.InputSignal<string>;
     textClass: _angular_core.InputSignal<string>;
-    isExternal: _angular_core.Signal<boolean>;
-    openInNewTab: _angular_core.Signal<boolean>;
-    internalPath: _angular_core.Signal<string>;
-    linkClass: _angular_core.Signal<string>;
+    anchorClass: _angular_core.InputSignal<string>;
+    protected usesRouterLink: _angular_core.Signal<boolean>;
+    protected openInNewTab: _angular_core.Signal<boolean>;
+    protected internalPath: _angular_core.Signal<string>;
+    protected internalUrlTree: _angular_core.Signal<_angular_router.UrlTree>;
+    protected linkClass: _angular_core.Signal<string | null>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ContentfulLinkComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ContentfulLinkComponent, "et-contentful-link", never, { "href": { "alias": "href"; "required": true; "isSignal": true; }; "text": { "alias": "text"; "required": true; "isSignal": true; }; "textClass": { "alias": "textClass"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ContentfulLinkComponent, "et-contentful-link", never, { "href": { "alias": "href"; "required": true; "isSignal": true; }; "text": { "alias": "text"; "required": true; "isSignal": true; }; "textClass": { "alias": "textClass"; "required": false; "isSignal": true; }; "anchorClass": { "alias": "anchorClass"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class ContentfulVideoComponent {
     asset: _angular_core.InputSignal<ContentfulGqlAsset | ContentfulRestAsset | null | undefined>;
     videoClass: _angular_core.InputSignal<NgClassType>;
-    data: _angular_core.Signal<{
-        url: string | null;
+    protected data: _angular_core.Signal<{
+        url: string;
         contentType: string | null;
     } | null>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ContentfulVideoComponent, never>;
@@ -579,13 +472,15 @@ declare const CONTENTFUL_CONFIG: InjectionToken<ContentfulConfig>;
 
 declare const ContentfulImports: readonly [typeof ContentfulAudioComponent, typeof ContentfulFileComponent, typeof ContentfulImageComponent, typeof ContentfulVideoComponent, typeof ContentfulRichTextRendererComponent];
 
-declare const createContentfulConfig: (config?: Partial<ContentfulConfig> | null | undefined) => ContentfulConfig;
+declare const createContentfulConfig: (config?: Partial<ContentfulConfig> | null) => ContentfulConfig;
+/**
+ * Reads the contentful config from the current injector. Falls back to a config without
+ * any `components` when none was provided via `provideContentfulConfig()`.
+ */
+declare const injectContentfulConfig: () => ContentfulConfig;
 
-declare const provideContentfulConfig: (contentfulConfig?: Partial<ContentfulConfig> | null | undefined) => {
-    provide: _angular_core.InjectionToken<ContentfulConfig>;
-    useValue: ContentfulConfig;
-};
+declare const provideContentfulConfig: (contentfulConfig?: Partial<ContentfulConfig> | null) => Provider;
 declare const isContentfulEntryType: <T extends ContentfulEntry>(entry: ContentfulEntry, type: string) => entry is T;
 
-export { COMPONENT_RENDER_COMMAND_POSITION, CONTENTFUL_CONFIG, ContentfulAudioComponent, ContentfulFileComponent, ContentfulImageComponent, ContentfulImports, ContentfulLinkComponent, ContentfulRichTextRendererComponent, ContentfulVideoComponent, ET_CONTENTFUL_ANY_ENTRY_CONTENT_TYPE_SYS_ID, GQL_FRAGMENT_CONTENTFUL_ASSET, HTML_CLOSE_RENDER_COMMAND_POSITION, HTML_OPEN_RENDER_COMMAND_POSITION, RENDER_COMMAND_POSITION, RENDER_COMMAND_TYPE, RENDER_INSTRUCTION_POSITION, RENDER_INSTRUCTION_TYPE, TEXT_RENDER_COMMAND_POSITION, createContentfulConfig, createContentfulIncludeMap, generateContentfulImageSources, generateDefaultContentfulImageSource, getRenderCommandId, isComponentRenderCommand, isContentfulEntryType, isContentfulGqlAsset, isExecutedComponentCommandCacheItem, isExecutedHtmlOrTextCommandCacheItem, isExecutedTextCommandCacheItem, isHtmlCloseRenderCommand, isHtmlOpenRenderCommand, isRichTextRootNode, isTextRenderCommand, marksToClass, parseContentfulImageSize, provideContentfulConfig, translateContentfulNodeTypeToHtmlTag };
-export type { ComponentLikeWithAsset, ComponentLikeWithContentfulRendererInputs, ComponentLikeWithLink, ContentfulAssetComponents, ContentfulAssetFileData, ContentfulAssetImageData, ContentfulAssetLink, ContentfulAssetLinkItem, ContentfulCollection, ContentfulConfig, ContentfulContentTypeLink, ContentfulEntry, ContentfulEntryLink, ContentfulEntryLinkItem, ContentfulEntrySys, ContentfulEnvironmentLink, ContentfulGqlAsset, ContentfulGqlCollectionFilterVariables, ContentfulGqlOrder, ContentfulGqlWhereFilter, ContentfulImageFocusArea, ContentfulImageResizeBehavior, ContentfulIncludeMap, ContentfulLink, ContentfulLinkType, ContentfulMetadata, ContentfulRestAsset, ContentfulSpaceLink, ContentfulSys, ContentfulTagLink, ContentfulTagLinkItem, CreateContentfulIncludeMapConfig, RichTextResponse };
+export { CONTENTFUL_CONFIG, CONTENTFUL_FILE_LABELS, ContentfulAudioComponent, ContentfulFileComponent, ContentfulImageComponent, ContentfulImports, ContentfulLinkComponent, ContentfulRichTextRendererComponent, ContentfulVideoComponent, DEFAULT_CONTENTFUL_FILE_LABELS, ET_CONTENTFUL_ANY_ENTRY_CONTENT_TYPE_SYS_ID, GQL_FRAGMENT_CONTENTFUL_ASSET, createContentfulConfig, createContentfulIncludeMap, generateContentfulImageSources, generateDefaultContentfulImageSource, injectContentfulConfig, injectContentfulFileLabels, isContentfulEntryType, isContentfulGqlAsset, isRichTextRootNode, marksToClass, marksToTags, parseContentfulImageSize, provideContentfulConfig, provideContentfulFileLabels, translateContentfulNodeTypeToHtmlTag };
+export type { ComponentLikeWithAsset, ComponentLikeWithContentfulRendererInputs, ComponentLikeWithLink, ContentfulAssetComponents, ContentfulAssetFileData, ContentfulAssetImageData, ContentfulAssetLink, ContentfulAssetLinkItem, ContentfulCollection, ContentfulConfig, ContentfulContentTypeLink, ContentfulEntry, ContentfulEntryLink, ContentfulEntryLinkItem, ContentfulEntrySys, ContentfulEnvironmentLink, ContentfulFileLabels, ContentfulGqlAsset, ContentfulGqlCollectionFilterVariables, ContentfulGqlOrder, ContentfulGqlWhereFilter, ContentfulImageFocusArea, ContentfulImageResizeBehavior, ContentfulImageSourcesOptions, ContentfulIncludeMap, ContentfulLink, ContentfulLinkType, ContentfulMetadata, ContentfulRestAsset, ContentfulSpaceLink, ContentfulSys, ContentfulTagLink, ContentfulTagLinkItem, CreateContentfulIncludeMapConfig, RichTextResponse };