@dotcms/angular 1.5.2-next.28 → 1.5.3-next.2118

package/lib/components/dotcms-block-editor-renderer/dotcms-block-editor-renderer.component.d.ts

@@ -24,6 +24,15 @@ export type CustomRenderer = Record<string, DynamicComponentEntity>;
  *   [customRenderers]="myCustomRenderers">
  * </dotcms-block-editor-renderer>
  * ```
+ *
+ * @deprecated Use {@link DotCMSBlockEditorRendererNativeComponent}
+ * (`<dotcms-block-editor-renderer-native>`) for accessible, semantic DOM output.
+ * This component wraps every semantic tag in a custom element (e.g. a dispatcher
+ * element sits between `<ul>` and its `<li>` children), which breaks the
+ * `list → listitem` relationship required by the HTML spec and assistive technology.
+ * The native renderer keeps the identical public input API — migration is just
+ * swapping the tag and import. This component is retained for backward compatibility
+ * and will be removed in a future major version.
  */
 export declare class DotCMSBlockEditorRendererComponent {
     blocks: BlockEditorNode;

package/lib/components/dotcms-block-editor-renderer/dotcms-block-editor-renderer.component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dotcms-block-editor-renderer.component.d.ts","sourceRoot":"","sources":["../../../../../../../libs/sdk/angular/src/lib/components/dotcms-block-editor-renderer/dotcms-block-editor-renderer.component.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,eAAe,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAM1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;;AAEtD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,qBAMa,kCAAkC;IAClC,MAAM,EAAG,eAAe,CAAC;IACzB,eAAe,EAAE,cAAc,GAAG,SAAS,CAAC;IAC5C,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAE5D,iBAAiB,2DAA6C;IAC9D,aAAa,kDAAiD;IAE9D,QAAQ;yCATC,kCAAkC;2CAAlC,kCAAkC;CAkB9C"}
+{"version":3,"file":"dotcms-block-editor-renderer.component.d.ts","sourceRoot":"","sources":["../../../../../../../libs/sdk/angular/src/lib/components/dotcms-block-editor-renderer/dotcms-block-editor-renderer.component.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,eAAe,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAM1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;;AAEtD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAMa,kCAAkC;IAClC,MAAM,EAAG,eAAe,CAAC;IACzB,eAAe,EAAE,cAAc,GAAG,SAAS,CAAC;IAC5C,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAE5D,iBAAiB,2DAA6C;IAC9D,aAAa,kDAAiD;IAE9D,QAAQ;yCATC,kCAAkC;2CAAlC,kCAAkC;CAkB9C"}

package/lib/components/dotcms-block-editor-renderer-semantic/blocks/semantic-blocks.component.d.ts

@@ -0,0 +1,40 @@
+import * as i0 from "@angular/core";
+/**
+ * Internal semantic block components for the accessible Block Editor renderer.
+ *
+ * Each component uses an **attribute selector** so the host element *is* the real
+ * semantic tag (`<ul>`, `<ol>`, `<li>`, ...). The template is just `<ng-content />`,
+ * so no extra wrapper element is added to the DOM and the
+ * `list → listitem` relationship required by the HTML spec and assistive
+ * technology is preserved.
+ *
+ * These are not exported from the SDK; they are an implementation detail of
+ * {@link DotCMSBlockEditorRendererNativeComponent}.
+ *
+ * @internal
+ */
+export declare class DotSemanticBulletList {
+    static ɵfac: i0.ɵɵFactoryDeclaration<DotSemanticBulletList, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DotSemanticBulletList, "ul[dotBulletList]", never, {}, {}, never, ["*"], true, never>;
+}
+export declare class DotSemanticOrderedList {
+    static ɵfac: i0.ɵɵFactoryDeclaration<DotSemanticOrderedList, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DotSemanticOrderedList, "ol[dotOrderedList]", never, {}, {}, never, ["*"], true, never>;
+}
+export declare class DotSemanticListItem {
+    static ɵfac: i0.ɵɵFactoryDeclaration<DotSemanticListItem, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DotSemanticListItem, "li[dotListItem]", never, {}, {}, never, ["*"], true, never>;
+}
+export declare class DotSemanticParagraph {
+    static ɵfac: i0.ɵɵFactoryDeclaration<DotSemanticParagraph, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DotSemanticParagraph, "p[dotParagraph]", never, {}, {}, never, ["*"], true, never>;
+}
+export declare class DotSemanticBlockQuote {
+    static ɵfac: i0.ɵɵFactoryDeclaration<DotSemanticBlockQuote, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DotSemanticBlockQuote, "blockquote[dotBlockQuote]", never, {}, {}, never, ["*"], true, never>;
+}
+export declare class DotSemanticCodeBlock {
+    static ɵfac: i0.ɵɵFactoryDeclaration<DotSemanticCodeBlock, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DotSemanticCodeBlock, "pre[dotCodeBlock]", never, {}, {}, never, ["*"], true, never>;
+}
+//# sourceMappingURL=semantic-blocks.component.d.ts.map

package/lib/components/dotcms-block-editor-renderer-semantic/blocks/semantic-blocks.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-blocks.component.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/sdk/angular/src/lib/components/dotcms-block-editor-renderer-semantic/blocks/semantic-blocks.component.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;GAaG;AACH,qBAOa,qBAAqB;yCAArB,qBAAqB;2CAArB,qBAAqB;CAAG;AAErC,qBAOa,sBAAsB;yCAAtB,sBAAsB;2CAAtB,sBAAsB;CAAG;AAEtC,qBAOa,mBAAmB;yCAAnB,mBAAmB;2CAAnB,mBAAmB;CAAG;AAEnC,qBAOa,oBAAoB;yCAApB,oBAAoB;2CAApB,oBAAoB;CAAG;AAEpC,qBAOa,qBAAqB;yCAArB,qBAAqB;2CAArB,qBAAqB;CAAG;AAErC,qBAOa,oBAAoB;yCAApB,oBAAoB;2CAApB,oBAAoB;CAAG"}

package/lib/components/dotcms-block-editor-renderer-semantic/dotcms-block-editor-renderer-native.component.d.ts

@@ -0,0 +1,73 @@
+import { OnInit } from '@angular/core';
+import { BlockEditorNode, BlockEditorMark } from '@dotcms/types';
+import { BlockEditorState, BlockEditorDefaultBlocks } from '@dotcms/types/internal';
+import { CustomRenderer } from '../dotcms-block-editor-renderer/dotcms-block-editor-renderer.component';
+import * as i0 from "@angular/core";
+/**
+ * An accessible component that renders content from DotCMS's Block Editor field.
+ *
+ * This is the semantic-DOM successor to {@link DotCMSBlockEditorRendererComponent}.
+ * It emits clean semantic HTML — `<ul><li><p>…</p></li></ul>` — with no custom
+ * wrapper elements between semantic tags, so the `list → listitem` relationship
+ * required by the HTML spec and assistive technology is preserved. The recursive
+ * dispatch is performed with `ng-template` outlets, whose host `<ng-container>`s
+ * render as HTML comment nodes (invisible to the accessibility tree).
+ *
+ * It exposes the **identical public input API** and the same `customRenderers`
+ * contract as the deprecated renderer, so migration is just swapping the tag and
+ * import.
+ *
+ * For more information about Block Editor, see {@link https://dev.dotcms.com/docs/block-editor}
+ *
+ * @example
+ * ```html
+ * <dotcms-block-editor-renderer-native
+ *   [blocks]="myBlockEditorContent"
+ *   [customRenderers]="myCustomRenderers">
+ * </dotcms-block-editor-renderer-native>
+ * ```
+ */
+export declare class DotCMSBlockEditorRendererNativeComponent implements OnInit {
+    /** The Block Editor `doc` node to render. */
+    readonly blocks: import("@angular/core").InputSignal<BlockEditorNode | undefined>;
+    /** Map of `node.type` → component to override the built-in render path. */
+    readonly customRenderers: import("@angular/core").InputSignal<CustomRenderer | undefined>;
+    /**
+     * CSS class on the wrapper element. Aliased as `class` so consumers can
+     * pass `[class]="…"` like a normal Angular class binding.
+     */
+    readonly cssClass: import("@angular/core").InputSignal<string | undefined>;
+    /** Inline style on the wrapper element. */
+    readonly style: import("@angular/core").InputSignal<string | Record<string, string> | undefined>;
+    $blockEditorState: import("@angular/core").WritableSignal<BlockEditorState>;
+    $isInEditMode: import("@angular/core").WritableSignal<boolean>;
+    protected readonly BLOCKS: typeof BlockEditorDefaultBlocks;
+    ngOnInit(): void;
+    /**
+     * Normalizes a heading `level` attribute (which may be a number such as `6`
+     * or a string such as `'6'`) to a string for use in the heading `@switch`.
+     * Returns `''` for missing or out-of-range levels so the template falls
+     * through to the safe `@default` case (`<h2>`).
+     */
+    asLevel(level: number | string | undefined): string;
+    /** The marks after the current (outermost) one — used to recurse inward. */
+    restMarks(marks: BlockEditorMark[] | undefined): BlockEditorMark[];
+    /** The attributes of the current (outermost) mark. */
+    markAttrs(marks: BlockEditorMark[] | undefined): Record<string, string>;
+    /**
+     * Wrapper style for a `dotImage` `<figure>`, derived from the node's
+     * `textWrap` (float left/right) or `textAlign` attribute.
+     */
+    imageStyle(attrs: BlockEditorNode['attrs']): Record<string, string>;
+    /** Poster URL for a `dotVideo` `<video>` (from `attrs.data.thumbnail`). */
+    videoPoster(attrs: BlockEditorNode['attrs']): string | undefined;
+    /**
+     * The column span (1–12) for a grid column. Falls back to `6` for malformed
+     * `columns` attrs or for an out-of-range column index, matching the legacy
+     * renderer.
+     */
+    columnSpan(attrs: BlockEditorNode['attrs'], index: number): number;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DotCMSBlockEditorRendererNativeComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DotCMSBlockEditorRendererNativeComponent, "dotcms-block-editor-renderer-native", never, { "blocks": { "alias": "blocks"; "required": false; "isSignal": true; }; "customRenderers": { "alias": "customRenderers"; "required": false; "isSignal": true; }; "cssClass": { "alias": "class"; "required": false; "isSignal": true; }; "style": { "alias": "style"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+//# sourceMappingURL=dotcms-block-editor-renderer-native.component.d.ts.map

package/lib/components/dotcms-block-editor-renderer-semantic/dotcms-block-editor-renderer-native.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dotcms-block-editor-renderer-native.component.d.ts","sourceRoot":"","sources":["../../../../../../../libs/sdk/angular/src/lib/components/dotcms-block-editor-renderer-semantic/dotcms-block-editor-renderer-native.component.ts"],"names":[],"mappings":"AACA,OAAO,EAA6C,MAAM,EAAU,MAAM,eAAe,CAAC;AAE1F,OAAO,EAAY,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAepF,OAAO,EAAE,cAAc,EAAE,MAAM,wEAAwE,CAAC;;AAExG;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAkBa,wCAAyC,YAAW,MAAM;IACnE,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,mEAA4B;IAC3C,2EAA2E;IAC3E,QAAQ,CAAC,eAAe,kEAAgD;IACxE;;;OAGG;IACH,QAAQ,CAAC,QAAQ,0DAA4D;IAC7E,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,mFAAiE;IAE/E,iBAAiB,2DAA6C;IAC9D,aAAa,kDAAiD;IAE9D,SAAS,CAAC,QAAQ,CAAC,MAAM,kCAA4B;IAErD,QAAQ;IAaR;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM;IAKnD,4EAA4E;IAC5E,SAAS,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,SAAS,GAAG,eAAe,EAAE;IAIlE,sDAAsD;IACtD,SAAS,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIvE;;;OAGG;IACH,UAAU,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAiBnE,2EAA2E;IAC3E,WAAW,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS;IAIhE;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;yCAnFzD,wCAAwC;2CAAxC,wCAAwC;CA2FpD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotcms/angular",
-  "version": "1.5.2-next.28",
+  "version": "1.5.3-next.2118",
   "peerDependencies": {
     "rxjs": ">=7.0.0",
     "@angular/common": ">=17.0.0",

package/public_api.d.ts

@@ -3,6 +3,7 @@ export { provideDotCMSImageLoader } from './lib/providers/dotcms-image-loader/do
 export { provideDotCMSClient, DotCMSClient } from './lib/providers/dotcms-client/dotcms-client.provider';
 export { DotCMSEditableTextComponent } from './lib/components/dotcms-editable-text/dotcms-editable-text.component';
 export { DotCMSBlockEditorRendererComponent } from './lib/components/dotcms-block-editor-renderer/dotcms-block-editor-renderer.component';
+export { DotCMSBlockEditorRendererNativeComponent } from './lib/components/dotcms-block-editor-renderer-semantic/dotcms-block-editor-renderer-native.component';
 export { DotCMSLayoutBodyComponent } from './lib/components/dotcms-layout-body/dotcms-layout-body.component';
 export { DotCMSEditablePageService } from './lib/services/dotcms-editable-page.service';
 export { DynamicComponentEntity } from './lib/models';

package/public_api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public_api.d.ts","sourceRoot":"","sources":["../../../../libs/sdk/angular/src/public_api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8DAA8D,CAAC;AAEvG,OAAO,EAAE,wBAAwB,EAAE,MAAM,yDAAyD,CAAC;AAEnG,OAAO,EACH,mBAAmB,EACnB,YAAY,EACf,MAAM,sDAAsD,CAAC;AAE9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sEAAsE,CAAC;AAEnH,OAAO,EAAE,kCAAkC,EAAE,MAAM,sFAAsF,CAAC;AAE1I,OAAO,EAAE,yBAAyB,EAAE,MAAM,kEAAkE,CAAC;AAE7G,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AAExF,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"public_api.d.ts","sourceRoot":"","sources":["../../../../libs/sdk/angular/src/public_api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8DAA8D,CAAC;AAEvG,OAAO,EAAE,wBAAwB,EAAE,MAAM,yDAAyD,CAAC;AAEnG,OAAO,EACH,mBAAmB,EACnB,YAAY,EACf,MAAM,sDAAsD,CAAC;AAE9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sEAAsE,CAAC;AAEnH,OAAO,EAAE,kCAAkC,EAAE,MAAM,sFAAsF,CAAC;AAE1I,OAAO,EAAE,wCAAwC,EAAE,MAAM,sGAAsG,CAAC;AAEhK,OAAO,EAAE,yBAAyB,EAAE,MAAM,kEAAkE,CAAC;AAE7G,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AAExF,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}