@malva-ui/core 0.1.12

package/chat/lib/chat/chat.d.ts

@@ -0,0 +1,133 @@
+import { type ElementRef } from '@angular/core';
+import type { BooleanInput } from '@angular/cdk/coercion';
+import type { MlvChatAttachment, MlvChatMessageData, MlvChatUser } from '../chat.types';
+import { MlvChatAuthorDef } from '../defs/chat-author-def';
+import { MlvChatDateDef } from '../defs/chat-date-def';
+import { MlvChatMessageDef } from '../defs/chat-message-def';
+import * as i0 from "@angular/core";
+import * as i1 from "@malva-ui/cdk/density";
+/**
+ * Scrollable chat surface. Renders an oldest→newest `messages` array as author
+ * groups with date separators, delivery statuses, replies, media, and audio.
+ * Grouping is computed internally — consumers only supply flat data.
+ */
+export declare class MlvChat {
+    /** @private Distance from the bottom under which the view counts as pinned. */
+    private static readonly _PIN_THRESHOLD;
+    /** @private Distance from the top under which the window grows / `loadOlder` fires. */
+    private static readonly _TOP_THRESHOLD;
+    /** @private Number of messages the render window grows by per step. */
+    private static readonly _WINDOW_STEP;
+    /** Messages ordered oldest → newest. */
+    readonly messages: import("@angular/core").InputSignal<MlvChatMessageData<unknown>[]>;
+    /** Id of the current user; messages authored by it render as own messages. */
+    readonly selfId: import("@angular/core").InputSignal<string>;
+    /** Known participants, used for avatars and author names. */
+    readonly users: import("@angular/core").InputSignal<MlvChatUser[]>;
+    /** Renders skeleton bubbles instead of content while the first page loads. */
+    readonly loading: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /** Shows the top loader while an older page is being fetched. */
+    readonly loadingOlder: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /** Whether more history exists; gates the `loadOlder` output. */
+    readonly hasOlder: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /** Ids of users currently composing a message. */
+    readonly typingUsers: import("@angular/core").InputSignal<string[]>;
+    /** Maximum gap in minutes between messages of one author group. */
+    readonly groupWindow: import("@angular/core").InputSignal<number>;
+    /** Author slot visibility; `'auto'` shows it once more than two users are known. */
+    readonly showAuthors: import("@angular/core").InputSignal<boolean | "auto">;
+    /** Whether calendar-day separators are rendered. */
+    readonly dateSeparators: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /** Number of newest messages kept in the DOM. */
+    readonly windowSize: import("@angular/core").InputSignal<number>;
+    /** Emits when the user scrolls past the oldest rendered message and more history exists. */
+    readonly loadOlder: import("@angular/core").OutputEmitterRef<void>;
+    /** Emits the failed message whose retry action was activated. */
+    readonly retry: import("@angular/core").OutputEmitterRef<MlvChatMessageData<unknown>>;
+    /** Emits the message and attachment of an activated media cell. */
+    readonly mediaClick: import("@angular/core").OutputEmitterRef<{
+        message: MlvChatMessageData;
+        attachment: MlvChatAttachment;
+    }>;
+    /** Emits the message and its embedded original when a reply quote is activated. */
+    readonly replyClick: import("@angular/core").OutputEmitterRef<{
+        message: MlvChatMessageData;
+        replyTo: MlvChatMessageData;
+    }>;
+    /** @internal Chat i18n strings. */
+    protected readonly _i18n: import("@angular/core").Signal<import("@malva-ui/i18n").MlvChatI18n>;
+    /** @internal Author slot template, when a consumer provides one. */
+    protected readonly authorDef: import("@angular/core").Signal<MlvChatAuthorDef | undefined>;
+    /** @internal Date separator template, when a consumer provides one. */
+    protected readonly dateDef: import("@angular/core").Signal<MlvChatDateDef | undefined>;
+    /** @private Custom message-type templates projected by the consumer. */
+    private readonly _messageDefs;
+    /** @internal id → user map, provided to bubbles through `MLV_CHAT_USERS`. */
+    readonly _usersMap: import("@angular/core").Signal<Map<string, MlvChatUser>>;
+    /** @internal type → def map, provided to bubbles through `MLV_CHAT_MESSAGE_DEFS`. */
+    readonly _defsMap: import("@angular/core").Signal<Map<string, MlvChatMessageDef>>;
+    /** @internal Number of newest messages currently rendered; grown by the scroll engine. */
+    protected readonly _renderCount: import("@angular/core").WritableSignal<number>;
+    /** @internal Newest slice of `messages` kept in the DOM. */
+    protected readonly _windowed: import("@angular/core").Signal<MlvChatMessageData<unknown>[]>;
+    /** @internal Flattened author groups and date separators of the render window. */
+    protected readonly _renderItems: import("@angular/core").Signal<import("@malva-ui/core/chat").MlvChatRenderItem[]>;
+    /** @internal Whether the author slot renders above other-authored groups. */
+    protected readonly _authorsVisible: import("@angular/core").Signal<boolean>;
+    /** @internal Typing users resolved against the known participants. */
+    protected readonly _typingUserObjects: import("@angular/core").Signal<MlvChatUser[]>;
+    /** @internal Placeholder rows rendered while `loading` is set. */
+    protected readonly _skeletonRows: readonly {
+        own: boolean;
+        width: string;
+    }[];
+    /** @internal The scroll container; measured by the scroll engine. */
+    protected readonly _viewport: import("@angular/core").Signal<ElementRef<HTMLElement> | undefined>;
+    /** @private Inner content wrapper; its height changes drive re-pinning. */
+    private readonly _content;
+    /** @private Shared resize observer used to follow content height changes. */
+    private readonly _resizeObserver;
+    /** @internal True while the view sits at (or near) the newest message. */
+    protected readonly _pinned: import("@angular/core").WritableSignal<boolean>;
+    /** @internal Messages appended while unpinned; drives the new-messages pill. */
+    protected readonly _newCount: import("@angular/core").WritableSignal<number>;
+    /** @internal Ids of messages that arrived live, so only those animate in. */
+    protected readonly _liveIds: import("@angular/core").WritableSignal<ReadonlySet<string>>;
+    /** @private First/last ids of the previous `messages` value, to classify changes. */
+    private _edgeIds;
+    /** @private Distance from the viewport bottom captured before a prepend renders. */
+    private _pendingCompensation;
+    constructor();
+    /** @internal Re-reads the viewport metrics after a scroll event. */
+    protected _onScroll(): void;
+    /**
+     * @internal Updates pinning and top-edge behavior from raw scroll metrics.
+     * Split from `_onScroll` so the logic is testable without layout.
+     */
+    protected _evaluateScroll(scrollTop: number, scrollHeight: number, clientHeight: number): void;
+    /** @internal Grows the render window, or asks for an older page once it is exhausted. */
+    protected _growWindow(): void;
+    /** @internal Scrolls to the newest message and clears the pill counter. */
+    protected _scrollToBottom(behavior?: ScrollBehavior): void;
+    /**
+     * @private Records every message newer than the previous last id so only
+     * live arrivals animate in — initial load, window growth, and prepended
+     * history render instantly.
+     */
+    private _markLiveMessages;
+    /** @private Records the distance from the bottom so a prepend keeps the view still. */
+    private _captureCompensation;
+    /**
+     * @private Restores the captured distance once the taller content has rendered.
+     * Returns true when a compensation was applied, so the caller skips pinning.
+     */
+    private _applyCompensation;
+    /** @private Jumps the viewport to the newest message without animation. */
+    private _stickToBottom;
+    /** @internal Composes the accessible label of one message article. */
+    protected _messageLabel(message: MlvChatMessageData, own: boolean): string;
+    /** @private Maps a delivery status to its translated label. */
+    private _statusLabel;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvChat, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvChat, "mlv-chat", never, { "messages": { "alias": "messages"; "required": true; "isSignal": true; }; "selfId": { "alias": "selfId"; "required": true; "isSignal": true; }; "users": { "alias": "users"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "loadingOlder": { "alias": "loadingOlder"; "required": false; "isSignal": true; }; "hasOlder": { "alias": "hasOlder"; "required": false; "isSignal": true; }; "typingUsers": { "alias": "typingUsers"; "required": false; "isSignal": true; }; "groupWindow": { "alias": "groupWindow"; "required": false; "isSignal": true; }; "showAuthors": { "alias": "showAuthors"; "required": false; "isSignal": true; }; "dateSeparators": { "alias": "dateSeparators"; "required": false; "isSignal": true; }; "windowSize": { "alias": "windowSize"; "required": false; "isSignal": true; }; }, { "loadOlder": "loadOlder"; "retry": "retry"; "mediaClick": "mediaClick"; "replyClick": "replyClick"; }, ["authorDef", "dateDef", "_messageDefs"], never, true, [{ directive: typeof i1.MlvDensityDirective; inputs: { "mlvDensity": "mlvDensity"; }; outputs: {}; }]>;
+}

package/chat/lib/chat-audio/chat-audio.d.ts

@@ -0,0 +1,51 @@
+import { InjectionToken } from '@angular/core';
+import { type MlvSliderValue } from '@malva-ui/core/slider';
+import type { MlvChatAttachment } from '../chat.types';
+import { formatChatDuration } from '../chat-format';
+import { type MlvChatAudioHandle } from './chat-audio.service';
+import * as i0 from "@angular/core";
+/** Creates the `HTMLAudioElement` a player drives; overridable in tests. */
+export declare const MLV_CHAT_AUDIO_FACTORY: InjectionToken<(src: string) => HTMLAudioElement>;
+/**
+ * Internal player for an audio attachment: play/pause, a seek slider, and the
+ * elapsed/total time. Playback is exclusive per `mlv-chat` when the container
+ * provides {@link MlvChatAudioService}.
+ */
+export declare class MlvChatAudio implements MlvChatAudioHandle {
+    /** The audio attachment to play. */
+    readonly attachment: import("@angular/core").InputSignal<MlvChatAttachment>;
+    /** @internal Chat i18n strings. */
+    protected readonly _i18n: import("@angular/core").Signal<import("@malva-ui/i18n").MlvChatI18n>;
+    /** @private Creates the underlying audio element on first playback. */
+    private readonly _audioFactory;
+    /** @private Container-scoped playback coordinator; null for a standalone player. */
+    private readonly _playback;
+    /** @private Lazily created audio element; null until the first play. */
+    private _audio;
+    /** @internal True while the element is playing. */
+    protected readonly _playing: import("@angular/core").WritableSignal<boolean>;
+    /** @internal Playback position in seconds. */
+    protected readonly _currentTime: import("@angular/core").WritableSignal<number>;
+    /** @private Duration reported by the element once metadata has loaded. */
+    private readonly _metadataDuration;
+    /** @internal Total duration: element metadata wins over the declared value. */
+    protected readonly _duration: import("@angular/core").Signal<number>;
+    /** @internal True while the attachment is still uploading; playback is blocked. */
+    protected readonly _uploading: import("@angular/core").Signal<boolean>;
+    /** @internal Formats seconds as `m:ss` for the elapsed/total readout. */
+    protected readonly _formatDuration: typeof formatChatDuration;
+    constructor();
+    /** Pauses playback. Called by the container coordinator when another player starts. */
+    pause(): void;
+    /** @internal Toggles between play and pause. */
+    protected _toggle(): void;
+    /**
+     * @internal Seeks to the given position in seconds. The slider emits the shared
+     * `MlvSliderValue` union; only the scalar form is used here (no range thumbs).
+     */
+    protected _seek(value: MlvSliderValue): void;
+    /** @private Creates the audio element and wires its listeners on first use. */
+    private _ensureAudio;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvChatAudio, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvChatAudio, "mlv-chat-audio", never, { "attachment": { "alias": "attachment"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}

package/chat/lib/chat-audio/chat-audio.service.d.ts

@@ -0,0 +1,21 @@
+import * as i0 from "@angular/core";
+/** Minimal contract an audio player exposes to the playback coordinator. */
+export interface MlvChatAudioHandle {
+    /** Stops playback of this player. */
+    pause(): void;
+}
+/**
+ * Coordinates one-at-a-time playback across the audio bubbles of a single
+ * `mlv-chat`. Provided by the container, never `providedIn: 'root'` — two
+ * chats on one page keep independent playback.
+ */
+export declare class MlvChatAudioService {
+    /** @private The player currently allowed to play. */
+    private _current;
+    /** Registers `player` as the active one, pausing the previously active player. */
+    requestPlay(player: MlvChatAudioHandle): void;
+    /** Clears the active slot when a player pauses or ends on its own. */
+    release(player: MlvChatAudioHandle): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvChatAudioService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MlvChatAudioService>;
+}

package/chat/lib/chat-date/chat-date.d.ts

@@ -0,0 +1,16 @@
+import * as i0 from "@angular/core";
+/**
+ * Internal default renderer of a date separator. Shows Today/Yesterday for the
+ * two most recent days and a formatted date otherwise. Consumers override the
+ * whole slot with `[mlvChatDateDef]`.
+ */
+export declare class MlvChatDate {
+    /** Start of the calendar day this separator introduces. */
+    readonly date: import("@angular/core").InputSignal<Date>;
+    /** @internal Chat i18n strings. */
+    protected readonly _i18n: import("@angular/core").Signal<import("@malva-ui/i18n").MlvChatI18n>;
+    /** @internal Relative label, or null when the template should format the date. */
+    protected readonly _label: import("@angular/core").Signal<string | null>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvChatDate, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvChatDate, "mlv-chat-date", never, { "date": { "alias": "date"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}

package/chat/lib/chat-format.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Formats a duration in seconds as `m:ss` (e.g. 75 → '1:15').
+ * Negative or non-finite input renders as '0:00'.
+ */
+export declare function formatChatDuration(seconds: number): string;

package/chat/lib/chat-media-grid/chat-media-grid.d.ts

@@ -0,0 +1,32 @@
+import type { BooleanInput } from '@angular/cdk/coercion';
+import type { MlvChatAttachment } from '../chat.types';
+import { formatChatDuration } from '../chat-format';
+import * as i0 from "@angular/core";
+/**
+ * Internal renderer for the image/gif/video attachments of a chat message.
+ * Not exported from the package barrel — `mlv-chat-message` owns it.
+ */
+export declare class MlvChatMediaGrid {
+    /** Visual attachments to render; audio entries must be filtered out by the caller. */
+    readonly attachments: import("@angular/core").InputSignal<MlvChatAttachment[]>;
+    /** Condensed rendering inside a reply quote: a single small thumbnail. */
+    readonly quote: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /** Emits the attachment whose cell was activated. */
+    readonly mediaClick: import("@angular/core").OutputEmitterRef<MlvChatAttachment>;
+    /** @internal Chat i18n strings. */
+    protected readonly _i18n: import("@angular/core").Signal<import("@malva-ui/i18n").MlvChatI18n>;
+    /** @internal Ids of images whose load event fired, so their skeleton is removed. */
+    protected readonly _loaded: import("@angular/core").WritableSignal<ReadonlySet<string>>;
+    /** @internal Cells rendered to the DOM: one in quote mode, otherwise the first four. */
+    protected readonly _visible: import("@angular/core").Signal<MlvChatAttachment[]>;
+    /** @internal Count of attachments hidden behind the +N overlay. */
+    protected readonly _extra: import("@angular/core").Signal<number>;
+    /** @internal Formats a duration in seconds as `m:ss` for the video chip. */
+    protected readonly _formatDuration: typeof formatChatDuration;
+    /** @internal True while an attachment carries upload progress, so the overlay shows. */
+    protected _isUploading(attachment: MlvChatAttachment): boolean;
+    /** @internal Marks an image as loaded so its skeleton placeholder is removed. */
+    protected _onLoad(id: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvChatMediaGrid, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvChatMediaGrid, "mlv-chat-media-grid", never, { "attachments": { "alias": "attachments"; "required": true; "isSignal": true; }; "quote": { "alias": "quote"; "required": false; "isSignal": true; }; }, { "mediaClick": "mediaClick"; }, never, never, true, never>;
+}

package/chat/lib/chat-message/chat-message.d.ts

@@ -0,0 +1,45 @@
+import type { BooleanInput } from '@angular/cdk/coercion';
+import type { MlvChatAttachment, MlvChatGroupPosition, MlvChatMessageData } from '../chat.types';
+import { formatChatDuration } from '../chat-format';
+import * as i0 from "@angular/core";
+/**
+ * A single chat bubble. Normally rendered internally by `mlv-chat`, but usable
+ * standalone. Renders text, reply quotes, delivery status ticks, and the meta
+ * row; media/audio attachments are rendered by internal sub-components.
+ */
+export declare class MlvChatMessage {
+    /** The message to render. */
+    readonly message: import("@angular/core").InputSignal<MlvChatMessageData<unknown>>;
+    /** True when authored by the current user (right-aligned, accent bubble, status ticks). */
+    readonly own: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /** Position inside the consecutive-author group; drives corner-tail radii. */
+    readonly groupPosition: import("@angular/core").InputSignal<MlvChatGroupPosition>;
+    /** Condensed quote rendering (inside a reply block): clamped text, no meta row. */
+    readonly quote: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /** Emits when the retry button of a failed own message is activated. */
+    readonly retry: import("@angular/core").OutputEmitterRef<void>;
+    /** Emits the clicked media attachment (image/video cell). */
+    readonly mediaClick: import("@angular/core").OutputEmitterRef<MlvChatAttachment>;
+    /** Emits the embedded replied-to message when the quote block is activated. */
+    readonly replyClick: import("@angular/core").OutputEmitterRef<MlvChatMessageData<unknown>>;
+    /** @internal Chat i18n strings. */
+    protected readonly _i18n: import("@angular/core").Signal<import("@malva-ui/i18n").MlvChatI18n>;
+    /** @private Users map provided by the surrounding `mlv-chat`; null when standalone. */
+    private readonly _users;
+    /** @internal Custom message-type templates provided by the surrounding `mlv-chat`. */
+    protected readonly _defs: import("@angular/core").Signal<ReadonlyMap<string, import("@malva-ui/core/chat").MlvChatMessageDefRef>> | null;
+    /** @internal Normalized timestamp for the DatePipe. */
+    protected readonly _date: import("@angular/core").Signal<Date>;
+    /** @internal Image/gif/video attachments, rendered by the media grid. */
+    protected readonly _mediaAttachments: import("@angular/core").Signal<MlvChatAttachment[]>;
+    /** @internal Audio attachments, each rendered by its own player. */
+    protected readonly _audioAttachments: import("@angular/core").Signal<MlvChatAttachment[]>;
+    /** @internal Formats seconds as `m:ss` for the condensed audio chip in quote mode. */
+    protected readonly _formatDuration: typeof formatChatDuration;
+    /** @internal Template for this message's custom type, if registered. */
+    protected readonly _typeTemplate: import("@angular/core").Signal<import("@angular/core").TemplateRef<import("@malva-ui/core/chat").MlvChatMessageDefContext> | null>;
+    /** @internal Resolves an author display name from the container-provided users map. */
+    protected _userName(id: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvChatMessage, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvChatMessage, "mlv-chat-message", never, { "message": { "alias": "message"; "required": true; "isSignal": true; }; "own": { "alias": "own"; "required": false; "isSignal": true; }; "groupPosition": { "alias": "groupPosition"; "required": false; "isSignal": true; }; "quote": { "alias": "quote"; "required": false; "isSignal": true; }; }, { "retry": "retry"; "mediaClick": "mediaClick"; "replyClick": "replyClick"; }, never, never, true, never>;
+}

package/chat/lib/chat-render-list.d.ts

@@ -0,0 +1,16 @@
+import type { MlvChatMessageData, MlvChatRenderItem } from './chat.types';
+/** Normalizes the {@link MlvChatMessageData.timestamp} union to a Date. */
+export declare function toChatDate(timestamp: Date | number | string): Date;
+/** True when both dates fall on the same calendar day (local time). */
+export declare function isSameChatDay(a: Date, b: Date): boolean;
+/**
+ * Flattens an oldest→newest message array into date separators + author groups.
+ * A group breaks on author change, on a gap larger than `groupWindowMinutes`,
+ * and always at a calendar-day boundary.
+ *
+ * @param messages Messages ordered oldest → newest.
+ * @param selfId Current user id; groups authored by it are flagged `own`.
+ * @param groupWindowMinutes Maximum gap between consecutive messages of one group.
+ * @param dateSeparators Whether `kind: 'date'` items are emitted at day boundaries.
+ */
+export declare function buildChatRenderList(messages: readonly MlvChatMessageData[], selfId: string, groupWindowMinutes: number, dateSeparators: boolean): MlvChatRenderItem[];

package/chat/lib/chat-tokens.d.ts

@@ -0,0 +1,25 @@
+import { InjectionToken, type Signal, type TemplateRef } from '@angular/core';
+import type { MlvChatGroupPosition, MlvChatMessageData, MlvChatUser } from './chat.types';
+/** Template context of an `[mlvChatMessageDef]` custom message renderer. */
+export interface MlvChatMessageDefContext {
+    /** The message being rendered. */
+    $implicit: MlvChatMessageData;
+    /** True when the message is authored by the current user. */
+    isOwn: boolean;
+    /** Position inside the consecutive-author group. */
+    groupPosition: MlvChatGroupPosition;
+    /** True when rendered condensed inside a reply quote. */
+    quote: boolean;
+}
+/** Reference to a registered custom message-type template. */
+export interface MlvChatMessageDefRef {
+    /** The template to render for messages of the registered type. */
+    templateRef: TemplateRef<MlvChatMessageDefContext>;
+}
+/**
+ * Users map (id → user) provided by `mlv-chat` so bubbles can resolve author
+ * display names (reply quotes). Optional — standalone bubbles render without it.
+ */
+export declare const MLV_CHAT_USERS: InjectionToken<Signal<ReadonlyMap<string, MlvChatUser>>>;
+/** Custom message-type templates (type → def) provided by `mlv-chat`. */
+export declare const MLV_CHAT_MESSAGE_DEFS: InjectionToken<Signal<ReadonlyMap<string, MlvChatMessageDefRef>>>;

package/chat/lib/chat-typing/chat-typing.d.ts

@@ -0,0 +1,16 @@
+import type { MlvChatUser } from '../chat.types';
+import * as i0 from "@angular/core";
+/**
+ * Internal three-dot typing bubble. Rendered by `mlv-chat` at the bottom of the
+ * transcript while `typingUsers` is non-empty.
+ */
+export declare class MlvChatTyping {
+    /** Users currently composing a message. */
+    readonly users: import("@angular/core").InputSignal<MlvChatUser[]>;
+    /** @internal Chat i18n strings. */
+    protected readonly _i18n: import("@angular/core").Signal<import("@malva-ui/i18n").MlvChatI18n>;
+    /** @internal Accessible label naming the typing users when they are known. */
+    protected readonly _ariaLabel: import("@angular/core").Signal<string | null>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvChatTyping, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvChatTyping, "mlv-chat-typing", never, { "users": { "alias": "users"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}

package/chat/lib/chat.types.d.ts

@@ -0,0 +1,80 @@
+/** Delivery lifecycle of an own message; rendered as tick icons in the meta row. */
+export type MlvChatMessageStatus = 'sending' | 'sent' | 'delivered' | 'read' | 'failed';
+/** Participant referenced by {@link MlvChatMessageData.authorId}. */
+export interface MlvChatUser {
+    /** Stable unique id, matched against `message.authorId` and the `mlv-chat` `selfId` input. */
+    id: string;
+    /** Display name; also drives the initials + `mlvColorFromText` avatar fallback. */
+    name: string;
+    /** Optional avatar image URL. */
+    avatarSrc?: string;
+}
+/** A single media/audio attachment inside a message. */
+export interface MlvChatAttachment {
+    /** Stable unique id (track key inside the media grid). */
+    id: string;
+    /** Renderer selection. */
+    kind: 'image' | 'gif' | 'video' | 'audio';
+    /** Media source URL (object URLs are fine while uploading). */
+    src: string;
+    /** Image alt text; an i18n fallback is used when absent. */
+    alt?: string;
+    /** Intrinsic width in px; reserves the aspect-ratio before load. */
+    width?: number;
+    /** Intrinsic height in px; reserves the aspect-ratio before load. */
+    height?: number;
+    /**
+     * Duration in seconds. Shown as a chip on video cells and as the audio total.
+     * Audio falls back to element metadata when absent.
+     */
+    duration?: number;
+    /** Video poster URL; falls back to the first frame via `preload="metadata"`. */
+    poster?: string;
+    /** 0–100 while uploading → progress overlay; omit/undefined once done. */
+    uploadProgress?: number;
+}
+/**
+ * One chat message. The `mlv-chat` `messages` input is ordered oldest → newest.
+ *
+ * Named `MlvChatMessageData` because the bubble component claims the
+ * `MlvChatMessage` class name.
+ */
+export interface MlvChatMessageData<TData = unknown> {
+    /** Stable unique id (track key, animation gating, edge detection). */
+    id: string;
+    /** Author reference; `=== selfId` ⇒ own message (right-aligned, accent). */
+    authorId: string;
+    /** Plain text body. */
+    text?: string;
+    /** Media/audio attachments. */
+    attachments?: MlvChatAttachment[];
+    /** Message time; accepts Date, epoch millis, or an ISO string. */
+    timestamp: Date | number | string;
+    /** Delivery status; ticks are rendered on own messages only. */
+    status?: MlvChatMessageStatus;
+    /** Full embedded replied-to message → condensed quote render (one level deep). */
+    replyTo?: MlvChatMessageData;
+    /** Matches an `[mlvChatMessageDef]` `mlvChatMessageDefType` for custom rendering. */
+    type?: string;
+    /** Consumer payload for custom templates. */
+    data?: TData;
+}
+/** Position of a message inside its consecutive-author group. */
+export type MlvChatGroupPosition = 'single' | 'first' | 'middle' | 'last';
+/** A message paired with its computed group position. */
+export interface MlvChatRenderMessage {
+    message: MlvChatMessageData;
+    position: MlvChatGroupPosition;
+}
+/** Item of the flattened render list produced by {@link buildChatRenderList}. */
+export type MlvChatRenderItem = {
+    kind: 'date';
+    id: string;
+    date: Date;
+} | {
+    kind: 'group';
+    id: string;
+    authorId: string;
+    own: boolean;
+    messages: MlvChatRenderMessage[];
+};

package/chat/lib/defs/chat-author-def.d.ts

@@ -0,0 +1,30 @@
+import { TemplateRef } from '@angular/core';
+import type { MlvChatMessageData, MlvChatUser } from '../chat.types';
+import * as i0 from "@angular/core";
+/** Template context of an `[mlvChatAuthorDef]` author slot. */
+export interface MlvChatAuthorDefContext {
+    /** The group's author, or undefined when the id is missing from `users`. */
+    $implicit: MlvChatUser | undefined;
+    /** True when the group is authored by the current user. */
+    isOwn: boolean;
+    /** First message of the group, for timestamps or role badges. */
+    firstMessage: MlvChatMessageData;
+}
+/**
+ * Replaces the default author name shown above a group of other-authored
+ * messages — for example to render an avatar plus a role badge.
+ *
+ * @example
+ * <ng-template mlvChatAuthorDef let-user>
+ *   <mlv-avatar size="xs" [name]="user.name" [src]="user.avatarSrc ?? null" />
+ *   {{ user.name }}
+ * </ng-template>
+ */
+export declare class MlvChatAuthorDef {
+    /** The template rendered in the author slot. */
+    readonly templateRef: TemplateRef<MlvChatAuthorDefContext>;
+    /** Type guard giving template variables their concrete types. */
+    static ngTemplateContextGuard(_dir: MlvChatAuthorDef, _ctx: unknown): _ctx is MlvChatAuthorDefContext;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvChatAuthorDef, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvChatAuthorDef, "[mlvChatAuthorDef]", never, {}, {}, never, never, true, never>;
+}

package/chat/lib/defs/chat-date-def.d.ts

@@ -0,0 +1,22 @@
+import { TemplateRef } from '@angular/core';
+import * as i0 from "@angular/core";
+/** Template context of an `[mlvChatDateDef]` date separator. */
+export interface MlvChatDateDefContext {
+    /** Start of the calendar day the separator introduces. */
+    $implicit: Date;
+}
+/**
+ * Replaces the default Today/Yesterday/date pill rendered between messages of
+ * different calendar days.
+ *
+ * @example
+ * <ng-template mlvChatDateDef let-date>{{ date | date: 'fullDate' }}</ng-template>
+ */
+export declare class MlvChatDateDef {
+    /** The template rendered for each date separator. */
+    readonly templateRef: TemplateRef<MlvChatDateDefContext>;
+    /** Type guard giving template variables their concrete types. */
+    static ngTemplateContextGuard(_dir: MlvChatDateDef, _ctx: unknown): _ctx is MlvChatDateDefContext;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvChatDateDef, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvChatDateDef, "[mlvChatDateDef]", never, {}, {}, never, never, true, never>;
+}

package/chat/lib/defs/chat-message-def.d.ts

@@ -0,0 +1,23 @@
+import { TemplateRef } from '@angular/core';
+import type { MlvChatMessageDefContext } from '../chat-tokens';
+import * as i0 from "@angular/core";
+/**
+ * Marks an `<ng-template>` as the renderer for chat messages whose `type`
+ * matches `mlvChatMessageDefType`. The template replaces the bubble body;
+ * alignment, meta row, and animations stay owned by the chat.
+ *
+ * @example
+ * <ng-template mlvChatMessageDef mlvChatMessageDefType="poll" let-message let-isOwn="isOwn">
+ *   <app-poll [poll]="message.data" />
+ * </ng-template>
+ */
+export declare class MlvChatMessageDef {
+    /** The message `type` this template renders. Templates without a type are ignored. */
+    readonly mlvChatMessageDefType: import("@angular/core").InputSignal<string>;
+    /** The template rendered for matching messages. */
+    readonly templateRef: TemplateRef<MlvChatMessageDefContext>;
+    /** Type guard giving template variables their concrete types. */
+    static ngTemplateContextGuard(_dir: MlvChatMessageDef, _ctx: unknown): _ctx is MlvChatMessageDefContext;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvChatMessageDef, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvChatMessageDef, "[mlvChatMessageDef]", never, { "mlvChatMessageDefType": { "alias": "mlvChatMessageDefType"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}

package/chat/malva-ui-core-chat.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generated bundle index. Do not edit.
+ */
+/// <amd-module name="@malva-ui/core/chat" />
+export * from './index';

package/checkbox/index.d.ts

@@ -0,0 +1,3 @@
+export * from './lib/checkbox-group-token';
+export * from './lib/checkbox-group/checkbox-group';
+export * from './lib/checkbox/checkbox';