@acorex/components 22.4.13 → 22.4.15

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@acorex/components",
-  "version": "22.4.13",
+  "version": "22.4.15",
   "peerDependencies": {
-    "@acorex/core": "22.4.13",
-    "@acorex/cdk": "22.4.13",
+    "@acorex/core": "22.4.15",
+    "@acorex/cdk": "22.4.15",
     "@angular/aria": ">=22.1.0",
     "polytype": ">=0.17.0",
     "hammerjs": ">=2.0.8",

package/types/acorex-components-comment.d.ts

@@ -1,10 +1,14 @@
-import * as i0 from '@angular/core';
-import { AXAvatarComponent } from '@acorex/components/avatar';
+import * as _angular_core from '@angular/core';
+import { TemplateRef } from '@angular/core';
+import { AXEvent, AXStyleColorType, AXItemClickEvent } from '@acorex/cdk/common';
+import { AXMenuItem } from '@acorex/components/menu';
+import * as i4 from '@acorex/components/button';
+import { AXButtonItemListItem, AXButtonItemComponent } from '@acorex/components/button';
 import * as i1 from '@acorex/components/decorators';
 import * as i2 from '@acorex/components/wysiwyg';
-import * as i3 from '@acorex/components/button';
-import * as i4 from '@acorex/components/text-area';
-import * as i5 from '@acorex/core/translation';
+import * as i3 from '@acorex/components/badge';
+import * as i5 from '@acorex/components/text-area';
+import * as i6 from '@acorex/core/translation';
 
 /**
  * A container component for displaying and managing comments.
@@ -14,14 +18,109 @@ import * as i5 from '@acorex/core/translation';
 declare class AXCommentContainerComponent {
     private document;
     private platformID;
+    protected readonly projectedHeader: _angular_core.Signal<unknown>;
+    protected readonly projectedFooter: _angular_core.Signal<unknown>;
     /**
      * Scrolls to a specific comment reply by its ID and highlights it temporarily.
      *
      * @param id - The ID of the comment reply to scroll to
      */
     scrollToReply(id: string): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXCommentContainerComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXCommentContainerComponent, "ax-comment-container", never, {}, {}, never, ["*"], true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXCommentContainerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXCommentContainerComponent, "ax-comment-container", never, {}, {}, ["projectedHeader", "projectedFooter"], ["ax-header", "*", "ax-footer"], true, never>;
+}
+
+/**
+ * Default comment item shape used by `ax-comment-view`.
+ *
+ * Nested replies can be provided eagerly via `replies`, or loaded lazily when
+ * `replyCount` is set and `datasource` is a callback.
+ */
+interface AXCommentItem {
+    id: string | number;
+    author: string;
+    avatar?: string;
+    initials?: string;
+    color?: AXStyleColorType;
+    date?: string;
+    content?: string;
+    likes?: number;
+    liked?: boolean;
+    isYou?: boolean;
+    repliesExpanded?: boolean;
+    replies?: AXCommentItem[];
+    replyCount?: number;
+    /** Overflow menu items rendered with `ax-menu`, same shape as `AXMenuItem`. */
+    actions?: AXMenuItem[];
+    data?: unknown;
+}
+/**
+ * Lazy-loading callback. Called without an id to load root comments,
+ * and with a parent id to load that comment's replies.
+ */
+type AXCommentCallback = (id?: string) => AXCommentItem[] | Promise<AXCommentItem[]>;
+/**
+ * Data source — a static array or a lazy-loading function.
+ */
+type AXCommentDataSource = AXCommentItem[] | AXCommentCallback;
+/**
+ * Context passed to a custom `itemTemplate` / `ng-template axCommentItem`.
+ * If no template is provided, the built-in default layout is used.
+ */
+interface AXCommentItemTemplateContext {
+    $implicit: AXCommentItem;
+    item: AXCommentItem;
+    level: number;
+    repliesExpanded: boolean;
+    replyCount: number;
+    loading: boolean;
+    liked: boolean;
+    likes: number;
+    toggleReplies: () => void;
+    toggleLike: () => void;
+    reply: (event?: Event) => void;
+}
+interface AXCommentReplyEvent extends AXEvent {
+    item: AXCommentItem;
+    nativeEvent?: Event;
+}
+interface AXCommentLikeChangeEvent extends AXEvent {
+    item: AXCommentItem;
+    liked: boolean;
+    likes: number;
+}
+interface AXCommentRepliesToggleEvent extends AXEvent {
+    item: AXCommentItem;
+    expanded: boolean;
+}
+interface AXCommentActionEvent extends AXEvent {
+    item: AXCommentItem;
+    action: AXMenuItem;
+}
+
+/**
+ * Marks an `ng-template` as a custom comment item renderer.
+ * When omitted, `ax-comment-view` uses the built-in layout.
+ * Like and reply stay in the item actions row either way.
+ *
+ * @example
+ * ```html
+ * <ax-comment-view [datasource]="comments">
+ *   <ng-template axCommentItem let-item>
+ *     <ax-avatar [color]="item.color" look="twotone" shape="rounded">
+ *       <ax-text>{{ item.initials }}</ax-text>
+ *     </ax-avatar>
+ *     <ax-title>{{ item.author }}</ax-title>
+ *     <ax-content>{{ item.content }}</ax-content>
+ *   </ng-template>
+ * </ax-comment-view>
+ * ```
+ */
+declare class AXCommentItemTemplateDirective {
+    readonly template: TemplateRef<AXCommentItemTemplateContext>;
+    constructor(template: TemplateRef<AXCommentItemTemplateContext>);
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXCommentItemTemplateDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AXCommentItemTemplateDirective, "ng-template[axCommentItem]", never, {}, {}, never, never, true, never>;
 }
 
 /**
@@ -30,16 +129,55 @@ declare class AXCommentContainerComponent {
  * @category Components
  */
 declare class AXCommentItemComponent {
-    protected avatar: i0.Signal<AXAvatarComponent>;
-    readonly replyCount: i0.InputSignal<number>;
+    private readonly parentComment;
+    protected readonly isReply: boolean;
+    private readonly projectedAvatar;
+    private readonly viewAvatar;
+    /** Data item used by `ax-comment-view`. When set, the default layout is rendered internally. */
+    readonly item: _angular_core.InputSignal<AXCommentItem>;
+    readonly replyCount: _angular_core.InputSignal<number>;
     /** Two-way bindable state controlling whether nested replies are visible. */
-    readonly repliesExpanded: i0.ModelSignal<boolean>;
+    readonly repliesExpanded: _angular_core.ModelSignal<boolean>;
+    /** Whether replies for this item are currently being loaded. */
+    readonly loading: _angular_core.InputSignal<boolean>;
+    /**
+     * Custom renderer for the item body. When omitted, the default layout
+     * (or projected slots) is used.
+     */
+    readonly itemTemplate: _angular_core.InputSignal<TemplateRef<AXCommentItemTemplateContext>>;
+    /** Context passed to `itemTemplate`. */
+    readonly itemContext: _angular_core.InputSignal<AXCommentItemTemplateContext>;
+    readonly likeChange: _angular_core.OutputEmitterRef<boolean>;
+    readonly replyClick: _angular_core.OutputEmitterRef<Event>;
+    readonly actionClick: _angular_core.OutputEmitterRef<AXMenuItem>;
+    protected readonly avatarSize = 48;
+    protected readonly showDefaultDataLayout: _angular_core.Signal<boolean>;
+    protected readonly useProjectedSlots: _angular_core.Signal<boolean>;
+    protected readonly itemActions: _angular_core.Signal<AXMenuItem[]>;
+    protected readonly showOverflowMenu: _angular_core.Signal<boolean>;
+    protected readonly overflowItems: _angular_core.Signal<AXButtonItemListItem[]>;
     constructor();
+    protected getColor(data: AXCommentItem): AXStyleColorType;
+    protected getInitials(data: AXCommentItem): string;
+    protected handleLike(liked: boolean): void;
+    protected handleReply(event: Event): void;
+    protected handleOverflowClick(event: AXItemClickEvent<AXButtonItemComponent>): void;
+    private toButtonItems;
+    private findAction;
+    /**
+     * Toggles the collapse state of the comment replies section.
+     */
     toggleReplies(): void;
+    /**
+     * Expands the nested replies section.
+     */
     showReplies(): void;
+    /**
+     * Collapses the nested replies section.
+     */
     hideReplies(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXCommentItemComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXCommentItemComponent, "ax-comment-item", never, { "replyCount": { "alias": "replyCount"; "required": false; "isSignal": true; }; "repliesExpanded": { "alias": "repliesExpanded"; "required": false; "isSignal": true; }; }, { "repliesExpanded": "repliesExpandedChange"; }, ["avatar"], ["ax-avatar", "ax-title", "ax-comment-date", "ax-comment-menu-options", "ax-content", "ax-comment-like", "ax-comment-reply-text", "ax-comment-item", "ax-comment-reply-more"], true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXCommentItemComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXCommentItemComponent, "ax-comment-item", never, { "item": { "alias": "item"; "required": false; "isSignal": true; }; "replyCount": { "alias": "replyCount"; "required": false; "isSignal": true; }; "repliesExpanded": { "alias": "repliesExpanded"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "itemTemplate": { "alias": "itemTemplate"; "required": false; "isSignal": true; }; "itemContext": { "alias": "itemContext"; "required": false; "isSignal": true; }; }, { "repliesExpanded": "repliesExpandedChange"; "likeChange": "likeChange"; "replyClick": "replyClick"; "actionClick": "actionClick"; }, ["projectedAvatar"], ["ax-avatar", "ax-title", "ax-subtitle", "ax-badge", "ax-comment-date", "ax-comment-menu-options", "ax-content", "ax-comment-like", "ax-comment-reply-text", "ax-comment-item", "ax-comment-reply-more", "*"], true, never>;
 }
 
 /**
@@ -48,8 +186,8 @@ declare class AXCommentItemComponent {
  * @category Components
  */
 declare class AXCommentDateComponent {
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXCommentDateComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXCommentDateComponent, "ax-comment-date", never, {}, {}, never, ["*"], true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXCommentDateComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXCommentDateComponent, "ax-comment-date", never, {}, {}, never, ["*"], true, never>;
 }
 
 /**
@@ -58,10 +196,10 @@ declare class AXCommentDateComponent {
  * @category Components
  */
 declare class AXCommentLikeComponent {
-    like: i0.ModelSignal<boolean>;
+    like: _angular_core.ModelSignal<boolean>;
     protected toggleLike(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXCommentLikeComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXCommentLikeComponent, "ax-comment-like", never, { "like": { "alias": "like"; "required": true; "isSignal": true; }; }, { "like": "likeChange"; }, never, ["*"], true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXCommentLikeComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXCommentLikeComponent, "ax-comment-like", never, { "like": { "alias": "like"; "required": true; "isSignal": true; }; }, { "like": "likeChange"; }, never, ["*"], true, never>;
 }
 
 /**
@@ -70,8 +208,35 @@ declare class AXCommentLikeComponent {
  * @category Components
  */
 declare class AXMenuOptionsComponent {
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXMenuOptionsComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXMenuOptionsComponent, "ax-comment-menu-options", never, {}, {}, never, ["*"], true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMenuOptionsComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMenuOptionsComponent, "ax-comment-menu-options", never, {}, {}, never, ["*"], true, never>;
+}
+
+/**
+ * Composer chrome shown while writing a reply. Projects the editor below a
+ * compact reply-context bar; hide the bar by leaving `item` empty.
+ *
+ * @category Components
+ */
+declare class AXCommentReplyComponent {
+    private readonly document;
+    private readonly platformId;
+    private readonly destroyRef;
+    private highlightTimer;
+    constructor();
+    /** Comment currently being replied to. When null, only the projected composer is shown. */
+    readonly item: _angular_core.InputSignal<AXCommentItem>;
+    /** Emitted when the close control on the reply banner is clicked. */
+    readonly onClose: _angular_core.OutputEmitterRef<void>;
+    /** Emitted when the banner is clicked to jump to the target comment. */
+    readonly onTargetClick: _angular_core.OutputEmitterRef<string>;
+    protected readonly preview: _angular_core.Signal<string>;
+    protected close(): void;
+    protected revealTarget(): void;
+    private scrollToComment;
+    private toPreview;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXCommentReplyComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXCommentReplyComponent, "ax-comment-reply", never, { "item": { "alias": "item"; "required": false; "isSignal": true; }; }, { "onClose": "onClose"; "onTargetClick": "onTargetClick"; }, never, ["*"], true, never>;
 }
 
 /**
@@ -80,34 +245,129 @@ declare class AXMenuOptionsComponent {
  * @category Components
  */
 declare class AXCommentReplyMoreComponent {
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXCommentReplyMoreComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXCommentReplyMoreComponent, "ax-comment-reply-more", never, {}, {}, never, ["*"], true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXCommentReplyMoreComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXCommentReplyMoreComponent, "ax-comment-reply-more", never, {}, {}, never, ["*"], true, never>;
 }
 
 /**
- * A component for displaying the reply action text on a comment.
+ * A component for displaying the reply action on a comment.
  *
  * @category Components
  */
 declare class AXCommentReplyTextComponent {
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXCommentReplyTextComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXCommentReplyTextComponent, "ax-comment-reply-text", never, {}, {}, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXCommentReplyTextComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXCommentReplyTextComponent, "ax-comment-reply-text", never, {}, {}, never, never, true, never>;
 }
 
 /**
- * A component for viewing comments with their details.
+ * Renders a comment thread from a datasource (array or lazy callback).
+ * Provide `itemTemplate` or `<ng-template axCommentItem>` to customize item UI;
+ * otherwise the built-in layout is used.
  *
  * @category Components
  */
 declare class AXCommentViewComponent {
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXCommentViewComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXCommentViewComponent, "ax-comment-view", never, {}, {}, never, ["ax-comment-item"], true, never>;
+    /** Comment data — a static array or a lazy-loading function. */
+    readonly datasource: _angular_core.ModelSignal<AXCommentDataSource>;
+    /**
+     * Custom item template. When omitted, the default comment layout is used.
+     * You can also project `<ng-template axCommentItem>`.
+     */
+    readonly itemTemplate: _angular_core.InputSignal<TemplateRef<AXCommentItemTemplateContext>>;
+    readonly onReply: _angular_core.OutputEmitterRef<AXCommentReplyEvent>;
+    readonly onLikeChange: _angular_core.OutputEmitterRef<AXCommentLikeChangeEvent>;
+    readonly onRepliesToggle: _angular_core.OutputEmitterRef<AXCommentRepliesToggleEvent>;
+    readonly onAction: _angular_core.OutputEmitterRef<AXCommentActionEvent>;
+    private readonly projectedItemTemplate;
+    protected readonly items: _angular_core.WritableSignal<AXCommentItem[]>;
+    private readonly loadingIds;
+    private readonly _isLoading;
+    readonly isLoading: _angular_core.Signal<boolean>;
+    private loadGeneration;
+    private syncingFromDatasource;
+    private readonly isLazyDataSource;
+    protected readonly hasDatasource: _angular_core.Signal<boolean>;
+    protected readonly resolvedTemplate: _angular_core.Signal<TemplateRef<AXCommentItemTemplateContext>>;
+    constructor();
+    /**
+     * Reloads root comments from the datasource.
+     *
+     * @returns Promise that resolves when the reload is complete.
+     */
+    reloadData(): Promise<void>;
+    /**
+     * Appends a comment to the current root list.
+     *
+     * @param item - The comment to append.
+     * @returns void
+     */
+    appendItem(item: AXCommentItem): void;
+    /**
+     * Appends a reply under a loaded comment and expands that thread.
+     *
+     * @param parentId - The parent comment id.
+     * @param item - The reply to append.
+     * @returns Promise that resolves when any needed lazy load and the append are complete.
+     */
+    appendReply(parentId: string, item: AXCommentItem): Promise<void>;
+    /**
+     * Finds a comment by id in the loaded tree.
+     *
+     * @param id - The comment id.
+     * @returns The matching item, or null if it is not loaded.
+     */
+    findItem(id: string): AXCommentItem | null;
+    /**
+     * Removes a comment from the loaded tree. Nested replies are removed with it.
+     *
+     * @param id - The comment id.
+     * @returns True when the comment was found and removed.
+     */
+    removeItem(id: string): boolean;
+    /**
+     * Patches a loaded comment in place.
+     *
+     * @param id - The comment id.
+     * @param patch - Fields to merge onto the existing item. The original id is kept.
+     * @returns The updated item, or null if it is not loaded.
+     */
+    updateItem(id: string, patch: Partial<AXCommentItem>): AXCommentItem | null;
+    /**
+     * Expands or collapses replies for a comment, loading them when needed.
+     *
+     * @param id - The comment id.
+     * @param expanded - Whether replies should be visible.
+     * @returns Promise that resolves when expansion and any lazy load are complete.
+     */
+    setExpanded(id: string, expanded: boolean): Promise<void>;
+    protected getId(item: AXCommentItem): string;
+    protected getReplies(item: AXCommentItem): AXCommentItem[];
+    protected getReplyCount(item: AXCommentItem): number;
+    protected isExpanded(item: AXCommentItem): boolean;
+    protected isItemLoading(item: AXCommentItem): boolean;
+    protected getTemplateContext(item: AXCommentItem, level: number): AXCommentItemTemplateContext;
+    protected onRepliesExpandedChange(item: AXCommentItem, expanded: boolean): Promise<void>;
+    protected toggleLike(item: AXCommentItem, liked?: boolean): void;
+    protected replyTo(item: AXCommentItem, event?: Event): void;
+    protected emitAction(item: AXCommentItem, action: AXMenuItem): void;
+    private applyDatasource;
+    private loadRootItems;
+    private hydrateExpanded;
+    private canLazyLoad;
+    private setItemExpanded;
+    private loadReplies;
+    private refreshItems;
+    private findInTree;
+    private findParent;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXCommentViewComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXCommentViewComponent, "ax-comment-view", never, { "datasource": { "alias": "datasource"; "required": false; "isSignal": true; }; "itemTemplate": { "alias": "itemTemplate"; "required": false; "isSignal": true; }; }, { "datasource": "datasourceChange"; "onReply": "onReply"; "onLikeChange": "onLikeChange"; "onRepliesToggle": "onRepliesToggle"; "onAction": "onAction"; }, ["projectedItemTemplate"], ["ax-comment-item"], true, never>;
 }
 
 declare class AXCommentModule {
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXCommentModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<AXCommentModule, never, [typeof i1.AXDecoratorModule, typeof i2.AXWysiwygModule, typeof i3.AXButtonModule, typeof i4.AXTextAreaModule, typeof i5.AXTranslationModule, typeof AXCommentViewComponent, typeof AXCommentContainerComponent, typeof AXCommentItemComponent, typeof AXCommentLikeComponent, typeof AXMenuOptionsComponent, typeof AXCommentReplyTextComponent, typeof AXCommentDateComponent, typeof AXCommentReplyMoreComponent], [typeof AXCommentViewComponent, typeof AXCommentContainerComponent, typeof AXCommentItemComponent, typeof AXCommentLikeComponent, typeof AXMenuOptionsComponent, typeof AXCommentReplyTextComponent, typeof AXCommentDateComponent, typeof AXCommentReplyMoreComponent]>;
-    static ɵinj: i0.ɵɵInjectorDeclaration<AXCommentModule>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXCommentModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<AXCommentModule, never, [typeof i1.AXDecoratorModule, typeof i2.AXWysiwygModule, typeof i3.AXBadgeModule, typeof i4.AXButtonModule, typeof i5.AXTextAreaModule, typeof i6.AXTranslationModule, typeof AXCommentViewComponent, typeof AXCommentContainerComponent, typeof AXCommentItemComponent, typeof AXCommentLikeComponent, typeof AXMenuOptionsComponent, typeof AXCommentReplyComponent, typeof AXCommentReplyTextComponent, typeof AXCommentDateComponent, typeof AXCommentReplyMoreComponent, typeof AXCommentItemTemplateDirective], [typeof AXCommentViewComponent, typeof AXCommentContainerComponent, typeof AXCommentItemComponent, typeof AXCommentLikeComponent, typeof AXMenuOptionsComponent, typeof AXCommentReplyComponent, typeof AXCommentReplyTextComponent, typeof AXCommentDateComponent, typeof AXCommentReplyMoreComponent, typeof AXCommentItemTemplateDirective]>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<AXCommentModule>;
 }
 
-export { AXCommentContainerComponent, AXCommentDateComponent, AXCommentItemComponent, AXCommentLikeComponent, AXCommentModule, AXCommentReplyMoreComponent, AXCommentReplyTextComponent, AXCommentViewComponent, AXMenuOptionsComponent };
+export { AXCommentContainerComponent, AXCommentDateComponent, AXCommentItemComponent, AXCommentItemTemplateDirective, AXCommentLikeComponent, AXCommentModule, AXCommentReplyComponent, AXCommentReplyMoreComponent, AXCommentReplyTextComponent, AXCommentViewComponent, AXMenuOptionsComponent };
+export type { AXCommentActionEvent, AXCommentCallback, AXCommentDataSource, AXCommentItem, AXCommentItemTemplateContext, AXCommentLikeChangeEvent, AXCommentRepliesToggleEvent, AXCommentReplyEvent };

package/types/acorex-components-text-editor.d.ts

@@ -123,7 +123,13 @@ declare class AXTextEditorComponent extends AXTextEditorComponent_base {
     private syncingFromEditor;
     readonly placeHolder: _angular_core.InputSignal<string>;
     readonly outputFormat: _angular_core.InputSignal<AXTextEditorOutputFormat>;
-    readonly initialLine: _angular_core.InputSignal<number>;
+    /**
+     * Minimum height of the editable surface, measured in text lines.
+     *
+     * @defaultValue 6
+     */
+    readonly initialLine: _angular_core.InputSignalWithTransform<number, unknown>;
+    protected readonly initialLineCss: _angular_core.Signal<string>;
     protected readonly zoomFactor: _angular_core.Signal<number>;
     constructor();
     protected readonly projectedContent: _angular_core.Signal<boolean>;
@@ -131,6 +137,14 @@ declare class AXTextEditorComponent extends AXTextEditorComponent_base {
     getEditorService(): AXTextEditorService;
     focus(): void;
     blur(): void;
+    /**
+     * Replaces the editor content. Optionally focuses the editor afterward.
+     *
+     * @param value - HTML, JSON, or null to clear.
+     * @param focus - When true, moves the caret into the editor after the content is applied.
+     * @returns void
+     */
+    setContent(value: AXTextEditorValue, focus?: boolean): void;
     /** @ignore */
     notifyEditorFocus(event?: FocusEvent): void;
     /** @ignore */