@ni/spright-components 6.20.3 → 6.21.0

package/dist/esm/chat/conversation/testing/chat-conversation.pageobject.d.ts

@@ -0,0 +1,55 @@
+import type { ChatConversation } from '..';
+/**
+ * Page object for the `spright-chat-conversation`
+ */
+export declare class ChatConversationPageObject {
+    protected readonly element: ChatConversation;
+    constructor(element: ChatConversation);
+    hasDefaultSlot(): boolean;
+    hasNamedSlot(name: string): boolean;
+    getNamedSlotAssignedElementCount(name: string): number;
+    getMessageCount(): number;
+    getMessageTextByIndex(index: number): string;
+    getLastMessageText(): string;
+    isMessageOutboundByIndex(index: number): boolean;
+    getScrollTop(): number;
+    getScrollHeight(): number;
+    getClientHeight(): number;
+    isAnchorRegionReserved(): boolean;
+    getHistoryRegionMessageCount(): number;
+    getAnchoredRegionMessageCount(): number;
+    getMessageSlotByIndex(index: number): string;
+    getAnchoredRegionHeight(): number;
+    getMessageViewportTop(index: number): number;
+    isMessagePinnedNearTop(index: number, tolerance?: number): boolean;
+    getDistanceFromBottom(): number;
+    isScrolledToBottom(threshold?: number): boolean;
+    isAutoScrollEnabled(): boolean;
+    isAutoScrollConnected(): boolean;
+    isAutoScrollEngaged(): boolean;
+    isMessageScrollAnchorByIndex(index: number): boolean;
+    getProgrammaticScrollTarget(): number | undefined;
+    setProgrammaticScrollTarget(target: number): void;
+    dispatchScroll(): void;
+    private get autoScrollManagerInternals();
+    appendOutboundMessage(text: string): Promise<void>;
+    appendInboundMessage(text: string): Promise<void>;
+    appendSystemMessage(text: string): Promise<void>;
+    appendTextToLastMessage(text: string): Promise<void>;
+    setViewportHeight(height: number): Promise<void>;
+    setAutoScrollEnabled(enabled: boolean): Promise<void>;
+    scrollToOffset(offset: number): Promise<void>;
+    scrollByOffset(delta: number): Promise<void>;
+    scrollToBottom(): Promise<void>;
+    /**
+     * Waits for FAST updates plus two animation frames so reactions driven by
+     * `requestAnimationFrame` and `ResizeObserver` (used by scroll management)
+     * have settled.
+     */
+    waitForScrollUpdateAsync(): Promise<void>;
+    private nextAnimationFrameAsync;
+    private appendMessage;
+    private getMessages;
+    private getScrollContainer;
+    private queryShadow;
+}

package/dist/esm/chat/conversation/testing/chat-conversation.pageobject.js

@@ -0,0 +1,194 @@
+import { waitForUpdatesAsync } from '@ni/nimble-components/dist/esm/testing/async-helpers';
+import { chatMessageInboundTag } from '../../message/inbound';
+import { chatMessageOutboundTag } from '../../message/outbound';
+import { chatMessageSystemTag } from '../../message/system';
+/**
+ * Page object for the `spright-chat-conversation`
+ */
+export class ChatConversationPageObject {
+    constructor(element) {
+        this.element = element;
+    }
+    // --- slots ---
+    hasDefaultSlot() {
+        return this.queryShadow('.messages slot:not([name])') !== undefined;
+    }
+    hasNamedSlot(name) {
+        return this.queryShadow(`slot[name="${name}"]`) !== undefined;
+    }
+    getNamedSlotAssignedElementCount(name) {
+        const slot = this.queryShadow(`slot[name="${name}"]`);
+        return slot?.assignedElements().length ?? 0;
+    }
+    // --- messages ---
+    getMessageCount() {
+        return this.getMessages().length;
+    }
+    getMessageTextByIndex(index) {
+        const message = this.getMessages()[index];
+        if (message === undefined) {
+            throw new Error(`No message at index ${index}`);
+        }
+        return message.textContent?.trim() ?? '';
+    }
+    getLastMessageText() {
+        return this.getMessageTextByIndex(this.getMessageCount() - 1);
+    }
+    isMessageOutboundByIndex(index) {
+        const message = this.getMessages()[index];
+        return message?.tagName.toLowerCase() === chatMessageOutboundTag;
+    }
+    // --- scroll metrics ---
+    getScrollTop() {
+        return this.getScrollContainer().scrollTop;
+    }
+    getScrollHeight() {
+        return this.getScrollContainer().scrollHeight;
+    }
+    getClientHeight() {
+        return this.getScrollContainer().clientHeight;
+    }
+    isAnchorRegionReserved() {
+        return this.element.autoScrollManager.anchorActive;
+    }
+    getHistoryRegionMessageCount() {
+        return this.getNamedSlotAssignedElementCount('history');
+    }
+    getAnchoredRegionMessageCount() {
+        const slot = this.queryShadow('.messages-anchored slot');
+        return slot?.assignedElements().length ?? 0;
+    }
+    getMessageSlotByIndex(index) {
+        const message = this.getMessages()[index];
+        return message?.getAttribute('slot') ?? '';
+    }
+    getAnchoredRegionHeight() {
+        const region = this.queryShadow('.messages-anchored');
+        return region?.clientHeight ?? 0;
+    }
+    getMessageViewportTop(index) {
+        const message = this.getMessages()[index];
+        if (message === undefined) {
+            throw new Error(`No message at index ${index}`);
+        }
+        const container = this.getScrollContainer();
+        return (message.getBoundingClientRect().top
+            - container.getBoundingClientRect().top);
+    }
+    isMessagePinnedNearTop(index, tolerance = 48) {
+        return Math.abs(this.getMessageViewportTop(index)) <= tolerance;
+    }
+    getDistanceFromBottom() {
+        const container = this.getScrollContainer();
+        return (container.scrollHeight - container.scrollTop - container.clientHeight);
+    }
+    isScrolledToBottom(threshold = 10) {
+        return this.getDistanceFromBottom() <= threshold;
+    }
+    // --- auto-scroll state ---
+    isAutoScrollEnabled() {
+        return this.element.autoScroll;
+    }
+    isAutoScrollConnected() {
+        return this.element.autoScrollManager.isActive;
+    }
+    isAutoScrollEngaged() {
+        return this.element.autoScrollManager.autoScrollEngaged;
+    }
+    isMessageScrollAnchorByIndex(index) {
+        const message = this.getMessages()[index];
+        return message?.messageInternals?.isScrollAnchor ?? false;
+    }
+    // --- programmatic scroll handling (test seams) ---
+    getProgrammaticScrollTarget() {
+        return this.autoScrollManagerInternals.programmaticScrollTarget;
+    }
+    setProgrammaticScrollTarget(target) {
+        this.autoScrollManagerInternals.programmaticScrollTarget = target;
+    }
+    dispatchScroll() {
+        this.getScrollContainer().dispatchEvent(new Event('scroll'));
+    }
+    get autoScrollManagerInternals() {
+        return this.element.autoScrollManager;
+    }
+    // --- actions ---
+    async appendOutboundMessage(text) {
+        await this.appendMessage(chatMessageOutboundTag, text);
+    }
+    async appendInboundMessage(text) {
+        await this.appendMessage(chatMessageInboundTag, text);
+    }
+    async appendSystemMessage(text) {
+        await this.appendMessage(chatMessageSystemTag, text);
+    }
+    async appendTextToLastMessage(text) {
+        const messages = this.getMessages();
+        const lastMessage = messages[messages.length - 1];
+        if (lastMessage === undefined) {
+            throw new Error('No message to append text to');
+        }
+        lastMessage.textContent = `${lastMessage.textContent ?? ''}${text}`;
+        await this.waitForScrollUpdateAsync();
+    }
+    async setViewportHeight(height) {
+        this.element.style.height = `${height}px`;
+        await this.waitForScrollUpdateAsync();
+    }
+    async setAutoScrollEnabled(enabled) {
+        this.element.autoScroll = enabled;
+        await this.waitForScrollUpdateAsync();
+    }
+    async scrollToOffset(offset) {
+        this.getScrollContainer().scrollTop = offset;
+        await this.waitForScrollUpdateAsync();
+    }
+    async scrollByOffset(delta) {
+        this.getScrollContainer().scrollTop += delta;
+        await this.waitForScrollUpdateAsync();
+    }
+    async scrollToBottom() {
+        await this.scrollToOffset(this.getScrollHeight());
+    }
+    /**
+     * Waits for FAST updates plus two animation frames so reactions driven by
+     * `requestAnimationFrame` and `ResizeObserver` (used by scroll management)
+     * have settled.
+     */
+    async waitForScrollUpdateAsync() {
+        await waitForUpdatesAsync();
+        await this.nextAnimationFrameAsync();
+        await this.nextAnimationFrameAsync();
+        await waitForUpdatesAsync();
+    }
+    async nextAnimationFrameAsync() {
+        await new Promise(resolve => {
+            requestAnimationFrame(() => resolve());
+        });
+    }
+    async appendMessage(tag, text) {
+        const message = document.createElement(tag);
+        message.textContent = text;
+        this.element.appendChild(message);
+        await this.waitForScrollUpdateAsync();
+    }
+    getMessages() {
+        const history = this.queryShadow('slot[name="history"]');
+        const anchored = this.queryShadow('.messages-anchored slot');
+        return [
+            ...(history?.assignedElements({ flatten: true }) ?? []),
+            ...(anchored?.assignedElements({ flatten: true }) ?? [])
+        ];
+    }
+    getScrollContainer() {
+        const container = this.queryShadow('.messages');
+        if (container === undefined) {
+            throw new Error('Scroll container not found');
+        }
+        return container;
+    }
+    queryShadow(selector) {
+        return this.element.shadowRoot?.querySelector(selector) ?? undefined;
+    }
+}
+//# sourceMappingURL=chat-conversation.pageobject.js.map

package/dist/esm/chat/conversation/testing/chat-conversation.pageobject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-conversation.pageobject.js","sourceRoot":"","sources":["../../../../../src/chat/conversation/testing/chat-conversation.pageobject.ts"],"names":[],"mappings":"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","sourcesContent":["import { waitForUpdatesAsync } from '@ni/nimble-components/dist/esm/testing/async-helpers';\nimport type { ChatConversation } from '..';\nimport { chatMessageInboundTag } from '../../message/inbound';\nimport { chatMessageOutboundTag } from '../../message/outbound';\nimport { chatMessageSystemTag } from '../../message/system';\n\n/**\n * Page object for the `spright-chat-conversation`\n */\nexport class ChatConversationPageObject {\n    public constructor(protected readonly element: ChatConversation) {}\n\n    // --- slots ---\n\n    public hasDefaultSlot(): boolean {\n        return this.queryShadow('.messages slot:not([name])') !== undefined;\n    }\n\n    public hasNamedSlot(name: string): boolean {\n        return this.queryShadow(`slot[name=\"${name}\"]`) !== undefined;\n    }\n\n    public getNamedSlotAssignedElementCount(name: string): number {\n        const slot = this.queryShadow(`slot[name=\"${name}\"]`) as\n            | HTMLSlotElement\n            | undefined;\n        return slot?.assignedElements().length ?? 0;\n    }\n\n    // --- messages ---\n\n    public getMessageCount(): number {\n        return this.getMessages().length;\n    }\n\n    public getMessageTextByIndex(index: number): string {\n        const message = this.getMessages()[index];\n        if (message === undefined) {\n            throw new Error(`No message at index ${index}`);\n        }\n        return message.textContent?.trim() ?? '';\n    }\n\n    public getLastMessageText(): string {\n        return this.getMessageTextByIndex(this.getMessageCount() - 1);\n    }\n\n    public isMessageOutboundByIndex(index: number): boolean {\n        const message = this.getMessages()[index];\n        return message?.tagName.toLowerCase() === chatMessageOutboundTag;\n    }\n\n    // --- scroll metrics ---\n\n    public getScrollTop(): number {\n        return this.getScrollContainer().scrollTop;\n    }\n\n    public getScrollHeight(): number {\n        return this.getScrollContainer().scrollHeight;\n    }\n\n    public getClientHeight(): number {\n        return this.getScrollContainer().clientHeight;\n    }\n\n    public isAnchorRegionReserved(): boolean {\n        return this.element.autoScrollManager.anchorActive;\n    }\n\n    public getHistoryRegionMessageCount(): number {\n        return this.getNamedSlotAssignedElementCount('history');\n    }\n\n    public getAnchoredRegionMessageCount(): number {\n        const slot = this.queryShadow('.messages-anchored slot') as\n            | HTMLSlotElement\n            | undefined;\n        return slot?.assignedElements().length ?? 0;\n    }\n\n    public getMessageSlotByIndex(index: number): string {\n        const message = this.getMessages()[index];\n        return message?.getAttribute('slot') ?? '';\n    }\n\n    public getAnchoredRegionHeight(): number {\n        const region = this.queryShadow('.messages-anchored') as\n            | HTMLElement\n            | undefined;\n        return region?.clientHeight ?? 0;\n    }\n\n    public getMessageViewportTop(index: number): number {\n        const message = this.getMessages()[index];\n        if (message === undefined) {\n            throw new Error(`No message at index ${index}`);\n        }\n        const container = this.getScrollContainer();\n        return (\n            message.getBoundingClientRect().top\n            - container.getBoundingClientRect().top\n        );\n    }\n\n    public isMessagePinnedNearTop(index: number, tolerance = 48): boolean {\n        return Math.abs(this.getMessageViewportTop(index)) <= tolerance;\n    }\n\n    public getDistanceFromBottom(): number {\n        const container = this.getScrollContainer();\n        return (\n            container.scrollHeight - container.scrollTop - container.clientHeight\n        );\n    }\n\n    public isScrolledToBottom(threshold = 10): boolean {\n        return this.getDistanceFromBottom() <= threshold;\n    }\n\n    // --- auto-scroll state ---\n\n    public isAutoScrollEnabled(): boolean {\n        return this.element.autoScroll;\n    }\n\n    public isAutoScrollConnected(): boolean {\n        return this.element.autoScrollManager.isActive;\n    }\n\n    public isAutoScrollEngaged(): boolean {\n        return this.element.autoScrollManager.autoScrollEngaged;\n    }\n\n    public isMessageScrollAnchorByIndex(index: number): boolean {\n        const message = this.getMessages()[index] as unknown as\n            | { messageInternals?: { isScrollAnchor: boolean } }\n            | undefined;\n        return message?.messageInternals?.isScrollAnchor ?? false;\n    }\n\n    // --- programmatic scroll handling (test seams) ---\n\n    public getProgrammaticScrollTarget(): number | undefined {\n        return this.autoScrollManagerInternals.programmaticScrollTarget;\n    }\n\n    public setProgrammaticScrollTarget(target: number): void {\n        this.autoScrollManagerInternals.programmaticScrollTarget = target;\n    }\n\n    public dispatchScroll(): void {\n        this.getScrollContainer().dispatchEvent(new Event('scroll'));\n    }\n\n    private get autoScrollManagerInternals(): {\n        programmaticScrollTarget?: number\n    } {\n        return this.element.autoScrollManager as unknown as {\n            programmaticScrollTarget?: number\n        };\n    }\n\n    // --- actions ---\n\n    public async appendOutboundMessage(text: string): Promise<void> {\n        await this.appendMessage(chatMessageOutboundTag, text);\n    }\n\n    public async appendInboundMessage(text: string): Promise<void> {\n        await this.appendMessage(chatMessageInboundTag, text);\n    }\n\n    public async appendSystemMessage(text: string): Promise<void> {\n        await this.appendMessage(chatMessageSystemTag, text);\n    }\n\n    public async appendTextToLastMessage(text: string): Promise<void> {\n        const messages = this.getMessages();\n        const lastMessage = messages[messages.length - 1];\n        if (lastMessage === undefined) {\n            throw new Error('No message to append text to');\n        }\n        lastMessage.textContent = `${lastMessage.textContent ?? ''}${text}`;\n        await this.waitForScrollUpdateAsync();\n    }\n\n    public async setViewportHeight(height: number): Promise<void> {\n        this.element.style.height = `${height}px`;\n        await this.waitForScrollUpdateAsync();\n    }\n\n    public async setAutoScrollEnabled(enabled: boolean): Promise<void> {\n        this.element.autoScroll = enabled;\n        await this.waitForScrollUpdateAsync();\n    }\n\n    public async scrollToOffset(offset: number): Promise<void> {\n        this.getScrollContainer().scrollTop = offset;\n        await this.waitForScrollUpdateAsync();\n    }\n\n    public async scrollByOffset(delta: number): Promise<void> {\n        this.getScrollContainer().scrollTop += delta;\n        await this.waitForScrollUpdateAsync();\n    }\n\n    public async scrollToBottom(): Promise<void> {\n        await this.scrollToOffset(this.getScrollHeight());\n    }\n\n    /**\n     * Waits for FAST updates plus two animation frames so reactions driven by\n     * `requestAnimationFrame` and `ResizeObserver` (used by scroll management)\n     * have settled.\n     */\n    public async waitForScrollUpdateAsync(): Promise<void> {\n        await waitForUpdatesAsync();\n        await this.nextAnimationFrameAsync();\n        await this.nextAnimationFrameAsync();\n        await waitForUpdatesAsync();\n    }\n\n    private async nextAnimationFrameAsync(): Promise<void> {\n        await new Promise<void>(resolve => {\n            requestAnimationFrame(() => resolve());\n        });\n    }\n\n    private async appendMessage(tag: string, text: string): Promise<void> {\n        const message = document.createElement(tag);\n        message.textContent = text;\n        this.element.appendChild(message);\n        await this.waitForScrollUpdateAsync();\n    }\n\n    private getMessages(): Element[] {\n        const history = this.queryShadow('slot[name=\"history\"]') as\n            | HTMLSlotElement\n            | undefined;\n        const anchored = this.queryShadow('.messages-anchored slot') as\n            | HTMLSlotElement\n            | undefined;\n        return [\n            ...(history?.assignedElements({ flatten: true }) ?? []),\n            ...(anchored?.assignedElements({ flatten: true }) ?? [])\n        ];\n    }\n\n    private getScrollContainer(): HTMLElement {\n        const container = this.queryShadow('.messages') as\n            | HTMLElement\n            | undefined;\n        if (container === undefined) {\n            throw new Error('Scroll container not found');\n        }\n        return container;\n    }\n\n    private queryShadow(selector: string): Element | undefined {\n        return this.element.shadowRoot?.querySelector(selector) ?? undefined;\n    }\n}\n"]}

package/dist/esm/chat/message/inbound/index.d.ts

@@ -1,4 +1,5 @@
 import { FoundationElement, type FoundationElementDefinition, type StartEndOptions } from '@ni/fast-foundation';
+import { ChatMessageInternals } from '../models/chat-message-internals';
 declare global {
     interface HTMLElementTagNameMap {
         'spright-chat-message-inbound': ChatMessageInbound;
@@ -13,6 +14,8 @@ export type ChatMessageInboundOptions = FoundationElementDefinition & StartEndOp
  * A Spright component for displaying a chat message
  */
 export declare class ChatMessageInbound extends FoundationElement {
+    /** @internal */
+    readonly messageInternals: ChatMessageInternals;
     /** @internal */
     footerActionsIsEmpty: boolean;
     /** @internal */

package/dist/esm/chat/message/inbound/index.js

@@ -3,6 +3,7 @@ import { observable } from '@ni/fast-element';
 import { applyMixins, DesignSystem, FoundationElement, StartEnd } from '@ni/fast-foundation';
 import { styles } from './styles';
 import { template } from './template';
+import { ChatMessageInternals } from '../models/chat-message-internals';
 /**
  * A Spright component for displaying a chat message
  */
@@ -10,6 +11,8 @@ export class ChatMessageInbound extends FoundationElement {
     constructor() {
         super(...arguments);
         /** @internal */
+        this.messageInternals = new ChatMessageInternals(this);
+        /** @internal */
         this.footerActionsIsEmpty = true;
     }
     slottedFooterActionsElementsChanged(_prev, next) {

package/dist/esm/chat/message/inbound/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/chat/message/inbound/index.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EACH,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,QAAQ,EAGX,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AActC;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,iBAAiB;IAAzD;;QACI,gBAAgB;QAET,yBAAoB,GAAG,IAAI,CAAC;IAYvC,CAAC;IANU,mCAAmC,CACtC,KAAgC,EAChC,IAA+B;QAE/B,IAAI,CAAC,oBAAoB,GAAG,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;IACxE,CAAC;CACJ;AAZU;IADN,UAAU;gEACwB;AAInB;IADf,UAAU;wEACkD;AASjE,WAAW,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;AAE1C,MAAM,yBAAyB,GAAG,kBAAkB,CAAC,OAAO,CAAC;IACzD,QAAQ,EAAE,sBAAsB;IAChC,QAAQ;IACR,MAAM;CACT,CAAC,CAAC;AAEH,YAAY,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,yBAAyB,EAAE,CAAC,CAAC;AACvF,MAAM,CAAC,MAAM,qBAAqB,GAAG,8BAA8B,CAAC","sourcesContent":["import { observable } from '@ni/fast-element';\nimport {\n    applyMixins,\n    DesignSystem,\n    FoundationElement,\n    StartEnd,\n    type FoundationElementDefinition,\n    type StartEndOptions\n} from '@ni/fast-foundation';\nimport { styles } from './styles';\nimport { template } from './template';\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'spright-chat-message-inbound': ChatMessageInbound;\n    }\n}\n\n/**\n * SprightChatMessageInbound configuration options\n * @public\n */\nexport type ChatMessageInboundOptions = FoundationElementDefinition & StartEndOptions;\n\n/**\n * A Spright component for displaying a chat message\n */\nexport class ChatMessageInbound extends FoundationElement {\n    /** @internal */\n    @observable\n    public footerActionsIsEmpty = true;\n\n    /** @internal */\n    @observable\n    public readonly slottedFooterActionsElements?: HTMLElement[];\n\n    public slottedFooterActionsElementsChanged(\n        _prev: HTMLElement[] | undefined,\n        next: HTMLElement[] | undefined\n    ): void {\n        this.footerActionsIsEmpty = next === undefined || next.length === 0;\n    }\n}\napplyMixins(ChatMessageInbound, StartEnd);\n\nconst sprightChatMessageInbound = ChatMessageInbound.compose({\n    baseName: 'chat-message-inbound',\n    template,\n    styles\n});\n\nDesignSystem.getOrCreate().withPrefix('spright').register(sprightChatMessageInbound());\nexport const chatMessageInboundTag = 'spright-chat-message-inbound';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/chat/message/inbound/index.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EACH,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,QAAQ,EAGX,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAcxE;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,iBAAiB;IAAzD;;QACI,gBAAgB;QACA,qBAAgB,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAElE,gBAAgB;QAET,yBAAoB,GAAG,IAAI,CAAC;IAYvC,CAAC;IANU,mCAAmC,CACtC,KAAgC,EAChC,IAA+B;QAE/B,IAAI,CAAC,oBAAoB,GAAG,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;IACxE,CAAC;CACJ;AAZU;IADN,UAAU;gEACwB;AAInB;IADf,UAAU;wEACkD;AASjE,WAAW,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;AAE1C,MAAM,yBAAyB,GAAG,kBAAkB,CAAC,OAAO,CAAC;IACzD,QAAQ,EAAE,sBAAsB;IAChC,QAAQ;IACR,MAAM;CACT,CAAC,CAAC;AAEH,YAAY,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,yBAAyB,EAAE,CAAC,CAAC;AACvF,MAAM,CAAC,MAAM,qBAAqB,GAAG,8BAA8B,CAAC","sourcesContent":["import { observable } from '@ni/fast-element';\nimport {\n    applyMixins,\n    DesignSystem,\n    FoundationElement,\n    StartEnd,\n    type FoundationElementDefinition,\n    type StartEndOptions\n} from '@ni/fast-foundation';\nimport { styles } from './styles';\nimport { template } from './template';\nimport { ChatMessageInternals } from '../models/chat-message-internals';\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'spright-chat-message-inbound': ChatMessageInbound;\n    }\n}\n\n/**\n * SprightChatMessageInbound configuration options\n * @public\n */\nexport type ChatMessageInboundOptions = FoundationElementDefinition & StartEndOptions;\n\n/**\n * A Spright component for displaying a chat message\n */\nexport class ChatMessageInbound extends FoundationElement {\n    /** @internal */\n    public readonly messageInternals = new ChatMessageInternals(this);\n\n    /** @internal */\n    @observable\n    public footerActionsIsEmpty = true;\n\n    /** @internal */\n    @observable\n    public readonly slottedFooterActionsElements?: HTMLElement[];\n\n    public slottedFooterActionsElementsChanged(\n        _prev: HTMLElement[] | undefined,\n        next: HTMLElement[] | undefined\n    ): void {\n        this.footerActionsIsEmpty = next === undefined || next.length === 0;\n    }\n}\napplyMixins(ChatMessageInbound, StartEnd);\n\nconst sprightChatMessageInbound = ChatMessageInbound.compose({\n    baseName: 'chat-message-inbound',\n    template,\n    styles\n});\n\nDesignSystem.getOrCreate().withPrefix('spright').register(sprightChatMessageInbound());\nexport const chatMessageInboundTag = 'spright-chat-message-inbound';\n"]}

package/dist/esm/chat/message/models/chat-message-internals.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Options for configuring a `ChatMessageInternals` instance.
+ * @internal
+ */
+export interface ChatMessageInternalsOptions {
+    /** When true, the conversation anchors to this message when it is inserted. */
+    anchorOnInsert?: boolean;
+}
+/**
+ * Internal state for a chat message
+ * @internal
+ */
+export declare class ChatMessageInternals {
+    /**
+     * Declares that the conversation should anchor to this message (pin it near
+     * the top of the viewport) when it is inserted.
+     */
+    readonly anchorOnInsert: boolean;
+    /**
+     * True when this message is the one the conversation anchors to while
+     * auto-scrolling.
+     */
+    isScrollAnchor: boolean;
+    private readonly host;
+    private slotName?;
+    constructor(host: HTMLElement, options?: ChatMessageInternalsOptions);
+    get slot(): string | undefined;
+    set slot(value: string | undefined);
+    static elementHasMessageInternals(element: Element): element is ChatMessage;
+}
+/**
+ * An element that exposes `ChatMessageInternals` for the conversation to read and
+ * coordinate scroll management.
+ * @internal
+ */
+export interface ChatMessage extends HTMLElement {
+    readonly messageInternals: ChatMessageInternals;
+}

package/dist/esm/chat/message/models/chat-message-internals.js

@@ -0,0 +1,39 @@
+import { __decorate } from "tslib";
+import { observable } from '@ni/fast-element';
+/**
+ * Internal state for a chat message
+ * @internal
+ */
+export class ChatMessageInternals {
+    constructor(host, options) {
+        /**
+         * True when this message is the one the conversation anchors to while
+         * auto-scrolling.
+         */
+        this.isScrollAnchor = false;
+        this.host = host;
+        this.anchorOnInsert = options?.anchorOnInsert ?? false;
+    }
+    get slot() {
+        return this.slotName;
+    }
+    set slot(value) {
+        if (value === this.slotName) {
+            return;
+        }
+        this.slotName = value;
+        if (value === undefined) {
+            this.host.removeAttribute('slot');
+        }
+        else {
+            this.host.setAttribute('slot', value);
+        }
+    }
+    static elementHasMessageInternals(element) {
+        return element.messageInternals instanceof ChatMessageInternals;
+    }
+}
+__decorate([
+    observable
+], ChatMessageInternals.prototype, "isScrollAnchor", void 0);
+//# sourceMappingURL=chat-message-internals.js.map

package/dist/esm/chat/message/models/chat-message-internals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-message-internals.js","sourceRoot":"","sources":["../../../../../src/chat/message/models/chat-message-internals.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAW9C;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IAiB7B,YAAmB,IAAiB,EAAE,OAAqC;QAV3E;;;WAGG;QAEI,mBAAc,GAAG,KAAK,CAAC;QAM1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,KAAK,CAAC;IAC3D,CAAC;IAED,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,IAAW,IAAI,CAAC,KAAyB;QACrC,IAAI,KAAK,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1B,OAAO;QACX,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;IACL,CAAC;IAEM,MAAM,CAAC,0BAA0B,CACpC,OAAgB;QAEhB,OAAQ,OAAgC,CAAC,gBAAgB,YAAY,oBAAoB,CAAC;IAC9F,CAAC;CACJ;AA/BU;IADN,UAAU;4DACmB","sourcesContent":["import { observable } from '@ni/fast-element';\n\n/**\n * Options for configuring a `ChatMessageInternals` instance.\n * @internal\n */\nexport interface ChatMessageInternalsOptions {\n    /** When true, the conversation anchors to this message when it is inserted. */\n    anchorOnInsert?: boolean;\n}\n\n/**\n * Internal state for a chat message\n * @internal\n */\nexport class ChatMessageInternals {\n    /**\n     * Declares that the conversation should anchor to this message (pin it near\n     * the top of the viewport) when it is inserted.\n     */\n    public readonly anchorOnInsert: boolean;\n\n    /**\n     * True when this message is the one the conversation anchors to while\n     * auto-scrolling.\n     */\n    @observable\n    public isScrollAnchor = false;\n\n    private readonly host: HTMLElement;\n    private slotName?: string;\n\n    public constructor(host: HTMLElement, options?: ChatMessageInternalsOptions) {\n        this.host = host;\n        this.anchorOnInsert = options?.anchorOnInsert ?? false;\n    }\n\n    public get slot(): string | undefined {\n        return this.slotName;\n    }\n\n    public set slot(value: string | undefined) {\n        if (value === this.slotName) {\n            return;\n        }\n        this.slotName = value;\n        if (value === undefined) {\n            this.host.removeAttribute('slot');\n        } else {\n            this.host.setAttribute('slot', value);\n        }\n    }\n\n    public static elementHasMessageInternals(\n        element: Element\n    ): element is ChatMessage {\n        return (element as Partial<ChatMessage>).messageInternals instanceof ChatMessageInternals;\n    }\n}\n\n/**\n * An element that exposes `ChatMessageInternals` for the conversation to read and\n * coordinate scroll management.\n * @internal\n */\nexport interface ChatMessage extends HTMLElement {\n    readonly messageInternals: ChatMessageInternals;\n}\n"]}

package/dist/esm/chat/message/outbound/index.d.ts

@@ -1,4 +1,5 @@
 import { FoundationElement } from '@ni/fast-foundation';
+import { ChatMessageInternals } from '../models/chat-message-internals';
 declare global {
     interface HTMLElementTagNameMap {
         'spright-chat-message-outbound': ChatMessageOutbound;
@@ -8,5 +9,7 @@ declare global {
  * A Spright component for displaying an outbound chat message
  */
 export declare class ChatMessageOutbound extends FoundationElement {
+    /** @internal */
+    readonly messageInternals: ChatMessageInternals;
 }
 export declare const chatMessageOutboundTag = "spright-chat-message-outbound";

package/dist/esm/chat/message/outbound/index.js

@@ -1,10 +1,18 @@
 import { DesignSystem, FoundationElement, } from '@ni/fast-foundation';
 import { styles } from './styles';
 import { template } from './template';
+import { ChatMessageInternals } from '../models/chat-message-internals';
 /**
  * A Spright component for displaying an outbound chat message
  */
 export class ChatMessageOutbound extends FoundationElement {
+    constructor() {
+        super(...arguments);
+        /** @internal */
+        this.messageInternals = new ChatMessageInternals(this, {
+            anchorOnInsert: true
+        });
+    }
 }
 const sprightChatMessageOutbound = ChatMessageOutbound.compose({
     baseName: 'chat-message-outbound',

package/dist/esm/chat/message/outbound/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/chat/message/outbound/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,YAAY,EACZ,iBAAiB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAQtC;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,iBAAiB;CACzD;AAED,MAAM,0BAA0B,GAAG,mBAAmB,CAAC,OAAO,CAAC;IAC3D,QAAQ,EAAE,uBAAuB;IACjC,QAAQ;IACR,MAAM;CACT,CAAC,CAAC;AAEH,YAAY,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,0BAA0B,EAAE,CAAC,CAAC;AACxF,MAAM,CAAC,MAAM,sBAAsB,GAAG,+BAA+B,CAAC","sourcesContent":["import {\n    DesignSystem,\n    FoundationElement,\n} from '@ni/fast-foundation';\nimport { styles } from './styles';\nimport { template } from './template';\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'spright-chat-message-outbound': ChatMessageOutbound;\n    }\n}\n\n/**\n * A Spright component for displaying an outbound chat message\n */\nexport class ChatMessageOutbound extends FoundationElement {\n}\n\nconst sprightChatMessageOutbound = ChatMessageOutbound.compose({\n    baseName: 'chat-message-outbound',\n    template,\n    styles\n});\n\nDesignSystem.getOrCreate().withPrefix('spright').register(sprightChatMessageOutbound());\nexport const chatMessageOutboundTag = 'spright-chat-message-outbound';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/chat/message/outbound/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,YAAY,EACZ,iBAAiB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAQxE;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,iBAAiB;IAA1D;;QACI,gBAAgB;QACA,qBAAgB,GAAG,IAAI,oBAAoB,CAAC,IAAI,EAAE;YAC9D,cAAc,EAAE,IAAI;SACvB,CAAC,CAAC;IACP,CAAC;CAAA;AAED,MAAM,0BAA0B,GAAG,mBAAmB,CAAC,OAAO,CAAC;IAC3D,QAAQ,EAAE,uBAAuB;IACjC,QAAQ;IACR,MAAM;CACT,CAAC,CAAC;AAEH,YAAY,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,0BAA0B,EAAE,CAAC,CAAC;AACxF,MAAM,CAAC,MAAM,sBAAsB,GAAG,+BAA+B,CAAC","sourcesContent":["import {\n    DesignSystem,\n    FoundationElement,\n} from '@ni/fast-foundation';\nimport { styles } from './styles';\nimport { template } from './template';\nimport { ChatMessageInternals } from '../models/chat-message-internals';\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'spright-chat-message-outbound': ChatMessageOutbound;\n    }\n}\n\n/**\n * A Spright component for displaying an outbound chat message\n */\nexport class ChatMessageOutbound extends FoundationElement {\n    /** @internal */\n    public readonly messageInternals = new ChatMessageInternals(this, {\n        anchorOnInsert: true\n    });\n}\n\nconst sprightChatMessageOutbound = ChatMessageOutbound.compose({\n    baseName: 'chat-message-outbound',\n    template,\n    styles\n});\n\nDesignSystem.getOrCreate().withPrefix('spright').register(sprightChatMessageOutbound());\nexport const chatMessageOutboundTag = 'spright-chat-message-outbound';\n"]}

package/dist/esm/chat/message/system/index.d.ts

@@ -1,4 +1,5 @@
 import { FoundationElement } from '@ni/fast-foundation';
+import { ChatMessageInternals } from '../models/chat-message-internals';
 declare global {
     interface HTMLElementTagNameMap {
         'spright-chat-message-system': ChatMessageSystem;
@@ -8,5 +9,7 @@ declare global {
  * A Spright component for displaying an system chat message
  */
 export declare class ChatMessageSystem extends FoundationElement {
+    /** @internal */
+    readonly messageInternals: ChatMessageInternals;
 }
 export declare const chatMessageSystemTag = "spright-chat-message-system";

package/dist/esm/chat/message/system/index.js

@@ -1,10 +1,16 @@
 import { DesignSystem, FoundationElement, } from '@ni/fast-foundation';
 import { styles } from './styles';
 import { template } from './template';
+import { ChatMessageInternals } from '../models/chat-message-internals';
 /**
  * A Spright component for displaying an system chat message
  */
 export class ChatMessageSystem extends FoundationElement {
+    constructor() {
+        super(...arguments);
+        /** @internal */
+        this.messageInternals = new ChatMessageInternals(this);
+    }
 }
 const sprightChatMessageSystem = ChatMessageSystem.compose({
     baseName: 'chat-message-system',

package/dist/esm/chat/message/system/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/chat/message/system/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,YAAY,EACZ,iBAAiB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAQtC;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,iBAAiB;CACvD;AAED,MAAM,wBAAwB,GAAG,iBAAiB,CAAC,OAAO,CAAC;IACvD,QAAQ,EAAE,qBAAqB;IAC/B,QAAQ;IACR,MAAM;CACT,CAAC,CAAC;AAEH,YAAY,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,wBAAwB,EAAE,CAAC,CAAC;AACtF,MAAM,CAAC,MAAM,oBAAoB,GAAG,6BAA6B,CAAC","sourcesContent":["import {\n    DesignSystem,\n    FoundationElement,\n} from '@ni/fast-foundation';\nimport { styles } from './styles';\nimport { template } from './template';\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'spright-chat-message-system': ChatMessageSystem;\n    }\n}\n\n/**\n * A Spright component for displaying an system chat message\n */\nexport class ChatMessageSystem extends FoundationElement {\n}\n\nconst sprightChatMessageSystem = ChatMessageSystem.compose({\n    baseName: 'chat-message-system',\n    template,\n    styles\n});\n\nDesignSystem.getOrCreate().withPrefix('spright').register(sprightChatMessageSystem());\nexport const chatMessageSystemTag = 'spright-chat-message-system';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/chat/message/system/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,YAAY,EACZ,iBAAiB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAQxE;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,iBAAiB;IAAxD;;QACI,gBAAgB;QACA,qBAAgB,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;CAAA;AAED,MAAM,wBAAwB,GAAG,iBAAiB,CAAC,OAAO,CAAC;IACvD,QAAQ,EAAE,qBAAqB;IAC/B,QAAQ;IACR,MAAM;CACT,CAAC,CAAC;AAEH,YAAY,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,wBAAwB,EAAE,CAAC,CAAC;AACtF,MAAM,CAAC,MAAM,oBAAoB,GAAG,6BAA6B,CAAC","sourcesContent":["import {\n    DesignSystem,\n    FoundationElement,\n} from '@ni/fast-foundation';\nimport { styles } from './styles';\nimport { template } from './template';\nimport { ChatMessageInternals } from '../models/chat-message-internals';\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'spright-chat-message-system': ChatMessageSystem;\n    }\n}\n\n/**\n * A Spright component for displaying an system chat message\n */\nexport class ChatMessageSystem extends FoundationElement {\n    /** @internal */\n    public readonly messageInternals = new ChatMessageInternals(this);\n}\n\nconst sprightChatMessageSystem = ChatMessageSystem.compose({\n    baseName: 'chat-message-system',\n    template,\n    styles\n});\n\nDesignSystem.getOrCreate().withPrefix('spright').register(sprightChatMessageSystem());\nexport const chatMessageSystemTag = 'spright-chat-message-system';\n"]}

package/dist/esm/chat/message/testing/chat-message.pageobject.d.ts

@@ -0,0 +1,18 @@
+import type { ChatMessageInbound } from '../inbound';
+import type { ChatMessageOutbound } from '../outbound';
+import type { ChatMessageSystem } from '../system';
+type ChatMessageElement = ChatMessageInbound | ChatMessageOutbound | ChatMessageSystem;
+/**
+ * Page object for the chat message components (`spright-chat-message-inbound`,
+ * `spright-chat-message-outbound`, and `spright-chat-message-system`) to provide
+ * consistent ways of querying the component during tests.
+ */
+export declare class ChatMessagePageObject {
+    protected readonly element: ChatMessageElement;
+    constructor(element: ChatMessageElement);
+    getRenderedText(): string;
+    isContentRendered(): boolean;
+    isScrollAnchor(): boolean;
+    private getContentSlot;
+}
+export {};

package/dist/esm/chat/message/testing/chat-message.pageobject.js

@@ -0,0 +1,27 @@
+/**
+ * Page object for the chat message components (`spright-chat-message-inbound`,
+ * `spright-chat-message-outbound`, and `spright-chat-message-system`) to provide
+ * consistent ways of querying the component during tests.
+ */
+export class ChatMessagePageObject {
+    constructor(element) {
+        this.element = element;
+    }
+    getRenderedText() {
+        const assigned = this.getContentSlot()?.assignedNodes({ flatten: true }) ?? [];
+        return assigned
+            .map(node => node.textContent ?? '')
+            .join('')
+            .trim();
+    }
+    isContentRendered() {
+        return this.getRenderedText().length > 0;
+    }
+    isScrollAnchor() {
+        return this.element.messageInternals.isScrollAnchor;
+    }
+    getContentSlot() {
+        return (this.element.shadowRoot?.querySelector('.message-content slot') ?? null);
+    }
+}
+//# sourceMappingURL=chat-message.pageobject.js.map

package/dist/esm/chat/message/testing/chat-message.pageobject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-message.pageobject.js","sourceRoot":"","sources":["../../../../../src/chat/message/testing/chat-message.pageobject.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,OAAO,qBAAqB;IAC9B,YAAsC,OAA2B;QAA3B,YAAO,GAAP,OAAO,CAAoB;IAAG,CAAC;IAE9D,eAAe;QAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,EAAE,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;QAC/E,OAAO,QAAQ;aACV,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;aACnC,IAAI,CAAC,EAAE,CAAC;aACR,IAAI,EAAE,CAAC;IAChB,CAAC;IAEM,iBAAiB;QACpB,OAAO,IAAI,CAAC,eAAe,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7C,CAAC;IAEM,cAAc;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,cAAc,CAAC;IACxD,CAAC;IAEO,cAAc;QAClB,OAAO,CACH,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,aAAa,CAClC,uBAAuB,CAC1B,IAAI,IAAI,CACZ,CAAC;IACN,CAAC;CACJ","sourcesContent":["import type { ChatMessageInbound } from '../inbound';\nimport type { ChatMessageOutbound } from '../outbound';\nimport type { ChatMessageSystem } from '../system';\n\ntype ChatMessageElement = ChatMessageInbound | ChatMessageOutbound | ChatMessageSystem;\n\n/**\n * Page object for the chat message components (`spright-chat-message-inbound`,\n * `spright-chat-message-outbound`, and `spright-chat-message-system`) to provide\n * consistent ways of querying the component during tests.\n */\nexport class ChatMessagePageObject {\n    public constructor(protected readonly element: ChatMessageElement) {}\n\n    public getRenderedText(): string {\n        const assigned = this.getContentSlot()?.assignedNodes({ flatten: true }) ?? [];\n        return assigned\n            .map(node => node.textContent ?? '')\n            .join('')\n            .trim();\n    }\n\n    public isContentRendered(): boolean {\n        return this.getRenderedText().length > 0;\n    }\n\n    public isScrollAnchor(): boolean {\n        return this.element.messageInternals.isScrollAnchor;\n    }\n\n    private getContentSlot(): HTMLSlotElement | null {\n        return (\n            this.element.shadowRoot?.querySelector<HTMLSlotElement>(\n                '.message-content slot'\n            ) ?? null\n        );\n    }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ni/spright-components",
-  "version": "6.20.3",
+  "version": "6.21.0",
   "description": "NI Spright Components",
   "scripts": {
     "build": "npm run build:components && npm run build:cem",
@@ -42,7 +42,7 @@
     "@ni/fast-element": "^10.1.1",
     "@ni/fast-foundation": "^10.2.3",
     "@ni/fast-web-utilities": "^10.0.0",
-    "@ni/nimble-components": "^35.10.0",
+    "@ni/nimble-components": "^35.11.0",
     "@ni/nimble-tokens": "^8.18.1",
     "tslib": "^2.2.0"
   },