@aparte/angular 0.25.0 → 0.27.0

package/dist/generated/element.directives.d.ts

@@ -11,7 +11,7 @@
  * a plain host listener when you need `stopPropagation`.
  */
 import { ElementRef, EventEmitter } from '@angular/core';
-import type { AparteActionClickEventDetail, AparteActionEventDetail, AparteAttachmentPreviewEventDetail, AparteBranchNavigateEventDetail, AparteCompactEventDetail, AparteComposerChangeEventDetail, AparteContextThresholdEventDetail, AparteConversationArchiveDetail, AparteConversationDeleteDetail, AparteConversationListItem, AparteConversationPinDetail, AparteConversationRenameDetail, AparteConversationSelectDetail, AparteEditEventDetail, AparteFeedbackEventDetail, AparteLinkClickEventDetail, AparteMessageInfoEventDetail, AparteOptgroupToggleEventDetail, ApartePathChangedEventDetail, AparteRetryEventDetail, AparteScrollRailJumpDetail, AparteSegmentUpdateEventDetail, AparteSelectChangeDetail, AparteSendEventDetail, AparteSidebarToggleDetail, AparteSplitResizeDetail, AparteSuggestionEventDetail } from '@aparte/core';
+import type { AparteActionClickEventDetail, AparteActionEventDetail, AparteAttachmentPreviewEventDetail, AparteBranchNavigateEventDetail, AparteCompactEventDetail, AparteComposerChangeEventDetail, AparteContextThresholdEventDetail, AparteConversationArchiveDetail, AparteConversationDeleteDetail, AparteConversationListItem, AparteConversationPinDetail, AparteConversationRenameDetail, AparteConversationSelectDetail, AparteEditEventDetail, AparteFeedbackEventDetail, AparteLauncherToggleDetail, AparteLinkClickEventDetail, AparteMessageInfoEventDetail, AparteOptgroupToggleEventDetail, ApartePathChangedEventDetail, AparteRetryEventDetail, AparteScrollRailJumpDetail, AparteSegmentUpdateEventDetail, AparteSelectChangeDetail, AparteSendEventDetail, AparteSidebarToggleDetail, AparteSplitResizeDetail, AparteSuggestionEventDetail } from '@aparte/core';
 import * as i0 from "@angular/core";
 /**
  * Writes one declared attribute onto the host element.
@@ -41,6 +41,8 @@ export declare class AparteChatBubbleDirective extends AparteElementBase {
     set streaming(v: boolean);
     /** Who wrote the message: shown in the header, and the message's accessible name ("Message from {name}"). Leave it out for the reader and the assistant, whose names come from the locale. */
     set name(v: string | undefined);
+    /** Why the compaction failed, beside `data-checkpoint="failed"`: the separator gives it as the failure's tooltip and to screen readers. Set and cleared with `data-checkpoint`; read it, do not write it. */
+    set dataCheckpointReason(v: string | undefined);
     /** An attached image was clicked, asking the app to open it full-size. */
     readonly attachmentPreview: EventEmitter<AparteAttachmentPreviewEventDetail>;
     /** A custom action-bar button was pressed. */
@@ -66,7 +68,7 @@ export declare class AparteChatBubbleDirective extends AparteElementBase {
     protected onBranchNavigate(e: CustomEvent<AparteBranchNavigateEventDetail>): void;
     protected onLinkClick(e: CustomEvent<AparteLinkClickEventDetail>): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AparteChatBubbleDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<AparteChatBubbleDirective, "aparte-chat-bubble", never, { "messageRole": { "alias": "messageRole"; "required": false; }; "content": { "alias": "content"; "required": false; }; "timestamp": { "alias": "timestamp"; "required": false; }; "messageId": { "alias": "messageId"; "required": false; }; "streaming": { "alias": "streaming"; "required": false; }; "name": { "alias": "name"; "required": false; }; }, { "attachmentPreview": "attachmentPreview"; "action": "action"; "retry": "retry"; "feedback": "feedback"; "messageInfo": "messageInfo"; "edit": "edit"; "branchNavigate": "branchNavigate"; "linkClick": "linkClick"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<AparteChatBubbleDirective, "aparte-chat-bubble", never, { "messageRole": { "alias": "messageRole"; "required": false; }; "content": { "alias": "content"; "required": false; }; "timestamp": { "alias": "timestamp"; "required": false; }; "messageId": { "alias": "messageId"; "required": false; }; "streaming": { "alias": "streaming"; "required": false; }; "name": { "alias": "name"; "required": false; }; "dataCheckpointReason": { "alias": "dataCheckpointReason"; "required": false; }; }, { "attachmentPreview": "attachmentPreview"; "action": "action"; "retry": "retry"; "feedback": "feedback"; "messageInfo": "messageInfo"; "edit": "edit"; "branchNavigate": "branchNavigate"; "linkClick": "linkClick"; }, never, never, true, never>;
     static ngAcceptInputType_streaming: unknown;
 }
 /** `<aparte-chat-status>` — A standalone status line — a light-DOM indicator the APP owns. Nothing in core turns it on: the framework host only ever flips it back OFF (on the first streamed token), and the four wrappers render one inside the viewport driven by their own `isTyping` prop. */
@@ -159,7 +161,7 @@ export declare class AparteComposerActionDirective extends AparteElementBase {
 }
 /** `<aparte-composer-add-attachment>` — File picker button for `<aparte-composer>`. */
 export declare class AparteComposerAddAttachmentDirective extends AparteElementBase {
-    /** MIME types / extensions passed to the file input (e.g. "image/*,.pdf") */
+    /** MIME types / extensions the composer admits (e.g. "image/*,.pdf"): the file input's filter, and checked again on a pick, a drop and a pasted image, so a file outside it is not attached however it arrives. */
     set accept(v: string | undefined);
     /** Allow multiple file selection (default: true) */
     set multiple(v: boolean);
@@ -230,7 +232,7 @@ export declare class AparteComposerToolbarDirective {
     static ɵfac: i0.ɵɵFactoryDeclaration<AparteComposerToolbarDirective, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<AparteComposerToolbarDirective, "aparte-composer-toolbar", never, {}, {}, never, never, true, never>;
 }
-/** `<aparte-context>` — A gauge of the model's context window: how much of it the conversation uses. */
+/** `<aparte-context>` — A gauge of the model's context window: how much of it the conversation uses, and what fills it. */
 export declare class AparteContextDirective extends AparteElementBase {
     /** The context window, in tokens. Overrides the current model's `contextWindow`. */
     set window(v: number);
@@ -244,20 +246,22 @@ export declare class AparteContextDirective extends AparteElementBase {
     set variant(v: string | undefined);
     /** Tokens in use before a turn of this page has reported any: a restored conversation's last usage. The next turn's usage replaces it. */
     set used(v: number);
-    /** Dispatch `aparte-compact` on each turn that ends in `danger`, one request at a time. */
+    /** Deprecated, still works. Dispatch `aparte-compact` (with `auto: true`) on each turn that ends in `danger`, one request at a time. `@aparte/plugin-compaction` decides when to compact by itself now, so leave this off. */
     set autoCompact(v: boolean);
     /** Reflected BY the element: `ok`, `warn` or `danger`. Read-only. */
     set dataLevel(v: string | undefined);
     /** Reflected BY the element while it has nothing to show. Read-only. */
     set dataEmpty(v: boolean);
+    /** Reflected BY the element while this chat is being compacted (`running`) and after a compaction failed (`failed`). Read-only. */
+    set dataCompact(v: string | undefined);
     /** The level changed. Bubbles. */
     readonly contextThreshold: EventEmitter<AparteContextThresholdEventDetail>;
-    /** Dispatched on `window` when `auto-compact` is set and a turn ends in `danger`: compact this target's transcript. One request at a time — the next turn in `danger` asks again once the plugin has answered — and only while the attribute is present. `@aparte/plugin-compaction` answers it; with no listener nothing happens. */
+    /** Dispatched on `window` when the deprecated `auto-compact` is set and a turn ends in `danger` (`auto: true`, with the `window` it measured against), and by Retry in the panel when no compactor is registered. One automatic request at a time — the next turn in `danger` asks again once the plugin has answered. `@aparte/plugin-compaction` answers it; with no listener nothing happens. */
     readonly compact: EventEmitter<AparteCompactEventDetail>;
     protected onContextThreshold(e: CustomEvent<AparteContextThresholdEventDetail>): void;
     protected onCompact(e: CustomEvent<AparteCompactEventDetail>): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AparteContextDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<AparteContextDirective, "aparte-context", never, { "window": { "alias": "window"; "required": false; }; "warn": { "alias": "warn"; "required": false; }; "danger": { "alias": "danger"; "required": false; }; "target": { "alias": "target"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "used": { "alias": "used"; "required": false; }; "autoCompact": { "alias": "autoCompact"; "required": false; }; "dataLevel": { "alias": "dataLevel"; "required": false; }; "dataEmpty": { "alias": "dataEmpty"; "required": false; }; }, { "contextThreshold": "contextThreshold"; "compact": "compact"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<AparteContextDirective, "aparte-context", never, { "window": { "alias": "window"; "required": false; }; "warn": { "alias": "warn"; "required": false; }; "danger": { "alias": "danger"; "required": false; }; "target": { "alias": "target"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "used": { "alias": "used"; "required": false; }; "autoCompact": { "alias": "autoCompact"; "required": false; }; "dataLevel": { "alias": "dataLevel"; "required": false; }; "dataEmpty": { "alias": "dataEmpty"; "required": false; }; "dataCompact": { "alias": "dataCompact"; "required": false; }; }, { "contextThreshold": "contextThreshold"; "compact": "compact"; }, never, never, true, never>;
     static ngAcceptInputType_window: unknown;
     static ngAcceptInputType_warn: unknown;
     static ngAcceptInputType_danger: unknown;
@@ -322,6 +326,21 @@ export declare class AparteIconDirective extends AparteElementBase {
     static ɵfac: i0.ɵɵFactoryDeclaration<AparteIconDirective, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<AparteIconDirective, "aparte-icon", never, { "name": { "alias": "name"; "required": false; }; }, {}, never, never, true, never>;
 }
+/** `<aparte-launcher>` — A chat that floats in a corner of the page — the support widget every product site has, as an element. A round button sits at the bottom of the window, on the inline-end side; a click opens the chat above it as a card, and a second click, Escape or any control marked `data-aparte-launcher-close` inside closes it again. */
+export declare class AparteLauncherDirective extends AparteElementBase {
+    /** The chat is open. Reflected; set it to start open. */
+    set open(v: boolean);
+    /** Text shown beside the bubble on the closed button, which then reads as a pill. Without it the button is round and named by the locale. */
+    set label(v: string | undefined);
+    /** The window width under which the open chat fills the window: a length, or `none` for a card at any size. Unset, a window under 30rem wide or 30rem high. */
+    set breakpoint(v: string | undefined);
+    /** The chat opened or closed, by the button, by Escape, by a close control or by `open` being set — or, while it is open, turned into a sheet or back as the window crossed the breakpoint. Bubbles. */
+    readonly launcherToggle: EventEmitter<AparteLauncherToggleDetail>;
+    protected onLauncherToggle(e: CustomEvent<AparteLauncherToggleDetail>): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AparteLauncherDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<AparteLauncherDirective, "aparte-launcher", never, { "open": { "alias": "open"; "required": false; }; "label": { "alias": "label"; "required": false; }; "breakpoint": { "alias": "breakpoint"; "required": false; }; }, { "launcherToggle": "launcherToggle"; }, never, never, true, never>;
+    static ngAcceptInputType_open: unknown;
+}
 /** `<aparte-optgroup>` — AparteOptgroup */
 export declare class AparteOptgroupDirective extends AparteElementBase {
     /** Group label */
@@ -482,5 +501,5 @@ export declare class AparteSuggestionsDirective extends AparteElementBase {
  * @Component({ imports: [...APARTE_ELEMENT_DIRECTIVES], template: `…` })
  * ```
  */
-export declare const APARTE_ELEMENT_DIRECTIVES: readonly [typeof AparteChatBubbleDirective, typeof AparteChatStatusDirective, typeof AparteChatViewportDirective, typeof AparteComposerDirective, typeof AparteComposerActionDirective, typeof AparteComposerAddAttachmentDirective, typeof AparteComposerAttachmentsDirective, typeof AparteComposerCancelDirective, typeof AparteComposerInputDirective, typeof AparteComposerSendDirective, typeof AparteComposerToolbarDirective, typeof AparteContextDirective, typeof AparteConversationListDirective, typeof AparteElicitationDirective, typeof AparteIconDirective, typeof AparteOptgroupDirective, typeof AparteOptionDirective, typeof AparteProgressSpinnerDirective, typeof AparteScrollRailDirective, typeof AparteSelectDirective, typeof AparteSidebarDirective, typeof AparteSplitDirective, typeof AparteSuggestionsDirective];
+export declare const APARTE_ELEMENT_DIRECTIVES: readonly [typeof AparteChatBubbleDirective, typeof AparteChatStatusDirective, typeof AparteChatViewportDirective, typeof AparteComposerDirective, typeof AparteComposerActionDirective, typeof AparteComposerAddAttachmentDirective, typeof AparteComposerAttachmentsDirective, typeof AparteComposerCancelDirective, typeof AparteComposerInputDirective, typeof AparteComposerSendDirective, typeof AparteComposerToolbarDirective, typeof AparteContextDirective, typeof AparteConversationListDirective, typeof AparteElicitationDirective, typeof AparteIconDirective, typeof AparteLauncherDirective, typeof AparteOptgroupDirective, typeof AparteOptionDirective, typeof AparteProgressSpinnerDirective, typeof AparteScrollRailDirective, typeof AparteSelectDirective, typeof AparteSidebarDirective, typeof AparteSplitDirective, typeof AparteSuggestionsDirective];
 export {};

package/dist/lib/aparte-chat.component.d.ts

@@ -87,9 +87,9 @@ export declare class AparteChatComponent implements AfterViewInit, OnDestroy, Ap
      * selector on Angular alone. This input is that parity. Additive: the recipe's
      * own classes stay.
      */
-    readonly containerClass: import("@angular/core").InputSignalWithTransform<string, string>;
+    readonly containerClass: import("@angular/core").InputSignalWithTransform<string, string | null | undefined>;
     /** Inline style for the same div — a string or a `{ prop: value }` map. */
-    readonly containerStyle: import("@angular/core").InputSignalWithTransform<string | Record<string, string>, string | Record<string, string>>;
+    readonly containerStyle: import("@angular/core").InputSignalWithTransform<string | Record<string, string> | null, string | Record<string, string> | null | undefined>;
     /**
      * Overlay the composer on the transcript (the ChatGPT anatomy): the scroll
      * surface spans the whole column, the scrollbar runs edge to edge, and the
@@ -121,7 +121,7 @@ export declare class AparteChatComponent implements AfterViewInit, OnDestroy, Ap
     readonly isTypingInput: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     readonly isTyping: import("@angular/core").WritableSignal<boolean>;
     /** Text to show in the typing status */
-    readonly typingText: import("@angular/core").InputSignal<string>;
+    readonly typingText: import("@angular/core").InputSignal<string | undefined>;
     /** The status line's word: the input, else the locale's, like the rest of the chat. */
     get typingLabel(): string;
     /** Duration in ms to freeze spacer recalculation after a conversation swap. Read when the host is created. */
@@ -132,7 +132,7 @@ export declare class AparteChatComponent implements AfterViewInit, OnDestroy, Ap
      * `AparteConversationManager` registered in `aparteGlobalConfig`. Setting a different id
      * mid-stream aborts the previous request; `null` deselects.
      */
-    readonly conversationIdInput: import("@angular/core").InputSignal<string>;
+    readonly conversationIdInput: import("@angular/core").InputSignal<string | null | undefined>;
     private _conversationId;
     /**
      * Instance {@link AparteConfig} for this chat. When set, aparté components
@@ -140,7 +140,7 @@ export declare class AparteChatComponent implements AfterViewInit, OnDestroy, Ap
      * several independently-configured chats can coexist on one page. Omit for the
      * global config. Read once, when the host is created after the first render.
      */
-    readonly config: import("@angular/core").InputSignal<AparteConfig>;
+    readonly config: import("@angular/core").InputSignal<AparteConfig | undefined>;
     /**
      * Render your OWN element per message in place of `<aparte-chat-bubble>`.
      * Opt-in — provide a `<ng-template let-message>` and pass its ref, or write the
@@ -154,9 +154,9 @@ export declare class AparteChatComponent implements AfterViewInit, OnDestroy, Ap
      */
     readonly bubbleTemplate: import("@angular/core").InputSignal<TemplateRef<{
         $implicit: AparteMessage;
-    }>>;
+    }> | undefined>;
     /** The `<ng-template aparteBubble>` written as content, if any. */
-    readonly bubbleDirective: import("@angular/core").Signal<AparteBubbleDirective>;
+    readonly bubbleDirective: import("@angular/core").Signal<AparteBubbleDirective | undefined>;
     /**
      * User submitted a message from the composer. It is **appended to the thread
      * automatically** (optimistic UI) before this fires — do NOT add it again in

package/dist/lib/aparte-tool-ui.directive.d.ts

@@ -23,7 +23,7 @@ export declare class AparteToolUIDirective {
     /** The tool this draws: a name, a `RegExp`, or `'*'` for every tool. */
     readonly name: import("@angular/core").InputSignal<AparteToolMatcher>;
     /** The config to declare it on. Defaults to the global one. */
-    readonly config: import("@angular/core").InputSignal<AparteConfig>;
+    readonly config: import("@angular/core").InputSignal<AparteConfig | undefined>;
     private readonly template;
     private readonly container;
     constructor();
@@ -51,7 +51,7 @@ export declare class AparteSegmentUIDirective {
     /** The segment `type` this draws. */
     readonly type: import("@angular/core").InputSignal<string>;
     /** The config to declare it on. Defaults to the global one. */
-    readonly config: import("@angular/core").InputSignal<AparteConfig>;
+    readonly config: import("@angular/core").InputSignal<AparteConfig | undefined>;
     private readonly template;
     private readonly container;
     constructor();

package/dist/lib/conversation-manager.service.d.ts

@@ -30,9 +30,9 @@ export declare class ConversationManagerService implements OnDestroy {
     /** Archived conversations, newest first. */
     readonly archivedConversations: import("@angular/core").Signal<AparteConversation[]>;
     /** Currently active conversation id. */
-    readonly activeId: import("@angular/core").WritableSignal<string>;
+    readonly activeId: import("@angular/core").WritableSignal<string | null>;
     /** The active conversation object (null when no conv is selected). */
-    readonly activeConversation: import("@angular/core").Signal<AparteConversation>;
+    readonly activeConversation: import("@angular/core").Signal<AparteConversation | null>;
     /**
      * Initialise the service with a storage adapter.
      * Call once in your root component or app initialiser.

package/dist/lib/provide-aparte.d.ts

@@ -33,7 +33,7 @@ export interface ProvideAparteOptions {
     };
     /** Model selection configuration. */
     modelConfig?: AparteModelConfig;
-    /** A locale OBJECT (e.g. `fr` from `@aparte/locale-fr`) — not a package-name string. */
+    /** A locale OBJECT (e.g. `fr` from `@aparte/locales/fr`) — not a package-name string. */
     locale?: AparteLocale;
     /** Theme mode; `'auto'` follows the system preference. */
     themeMode?: 'light' | 'dark' | 'auto';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aparte/angular",
-  "version": "0.25.0",
+  "version": "0.27.0",
   "homepage": "https://apartejs.dev/frameworks/angular/",
   "description": "Angular wrapper for aparté (Angular 19.2 to 21, zone or zoneless) — an ergonomic <aparte-chat> component plus services over the framework-agnostic web components.",
   "type": "module",
@@ -30,7 +30,7 @@
   "peerDependencies": {
     "@angular/common": "^19.2.0 || ^20.0.0 || ^21.0.0",
     "@angular/core": "^19.2.0 || ^20.0.0 || ^21.0.0",
-    "@aparte/core": ">=0.25.0 <1.0.0",
+    "@aparte/core": ">=0.27.0 <1.0.0",
     "rxjs": "^7.8.0"
   },
   "devDependencies": {
@@ -46,8 +46,8 @@
     "typescript": "^5.4.0",
     "vite": "^6.0.0",
     "zone.js": "~0.15.0",
-    "@aparte/core": "0.25.0",
-    "@aparte/provider-scenario": "0.25.0"
+    "@aparte/core": "0.27.0",
+    "@aparte/provider-scenario": "0.27.0"
   },
   "keywords": [
     "angular",
@@ -68,7 +68,7 @@
     "url": "https://github.com/apartejs/aparte/issues"
   },
   "scripts": {
-    "build": "ng-packagr -p ng-package.json && node ../../../scripts/stamp-dist.mjs",
+    "build": "ng-packagr -p ng-package.json -c tsconfig.lib.json && node ../../../scripts/stamp-dist.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "typecheck:tests": "tsc -p tsconfig.spec.json --noEmit",
     "test": "vitest",