@aparte/angular 0.16.10 → 0.17.0

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

@@ -55,7 +55,7 @@ export declare class AparteChatBubbleDirective extends AparteElementBase {
     readonly edit: EventEmitter<AparteEditEventDetail>;
     /** The `‹1/2›` picker moved between sibling versions. */
     readonly branchNavigate: EventEmitter<AparteBranchNavigateEventDetail>;
-    /** A link in the message body is about to be followed. Cancelable: `preventDefault()` keeps the browser from navigating, so a host can route the link itself. */
+    /** A link in the message body is about to be followed. Cancelable: `preventDefault()` keeps the browser from navigating, so a host can route the link itself. Angular: this Output emits the detail, so preventDefault() is not on it — bind the DOM event for that: (aparte-link-click)="$event.preventDefault()". */
     readonly linkClick: EventEmitter<AparteLinkClickEventDetail>;
     protected onAttachmentPreview(e: CustomEvent<AparteAttachmentPreviewEventDetail>): void;
     protected onAction(e: CustomEvent<AparteActionEventDetail>): void;
@@ -85,6 +85,8 @@ export declare class AparteChatViewportDirective extends AparteElementBase {
     set scrollThreshold(v: number);
     /** Caps how many bubbles stay in the DOM; older ones are released. */
     set maxRenderedBubbles(v: number);
+    /** The transcript is on its way: a conversation was chosen and its messages are being fetched. The element draws two skeleton turns, marks its scroll surface `aria-busy` and names the wait for a screen reader; `aparte-chat[center-empty]` does not count a loading viewport as empty. Set by `AparteConversationController` through its binding, or by hand from a loop of your own (`setLoading(true)`). */
+    set loading(v: boolean);
     /** The wrapper's explicit hands-off signal: set it and this element builds no wrapper of its own and relocates none of the nodes the FRAMEWORK renders into it, because the framework owns them. Not "none of its children": core's own scroll-to-bottom button is re-appended whenever it stops being last, and that path runs in this mode only. All four wrappers set it. */
     set frameworkManaged(v: boolean);
     /** Reflected BY the element while a turn streams: the transcript is read-only meanwhile, and every bubble inside reads it (at connect, and when it changes). The vanilla path derives it from the repository; a framework host sets it through `setTranscriptBusy()`. Read-only from the outside. */
@@ -99,9 +101,10 @@ export declare class AparteChatViewportDirective extends AparteElementBase {
     protected onResetDone(): void;
     protected onPathChanged(e: CustomEvent<ApartePathChangedEventDetail>): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AparteChatViewportDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<AparteChatViewportDirective, "aparte-chat-viewport", never, { "scrollThreshold": { "alias": "scrollThreshold"; "required": false; }; "maxRenderedBubbles": { "alias": "maxRenderedBubbles"; "required": false; }; "frameworkManaged": { "alias": "frameworkManaged"; "required": false; }; "dataBusy": { "alias": "dataBusy"; "required": false; }; }, { "segmentUpdate": "segmentUpdate"; "resetDone": "resetDone"; "pathChanged": "pathChanged"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<AparteChatViewportDirective, "aparte-chat-viewport", never, { "scrollThreshold": { "alias": "scrollThreshold"; "required": false; }; "maxRenderedBubbles": { "alias": "maxRenderedBubbles"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "frameworkManaged": { "alias": "frameworkManaged"; "required": false; }; "dataBusy": { "alias": "dataBusy"; "required": false; }; }, { "segmentUpdate": "segmentUpdate"; "resetDone": "resetDone"; "pathChanged": "pathChanged"; }, never, never, true, never>;
     static ngAcceptInputType_scrollThreshold: unknown;
     static ngAcceptInputType_maxRenderedBubbles: unknown;
+    static ngAcceptInputType_loading: unknown;
     static ngAcceptInputType_frameworkManaged: unknown;
     static ngAcceptInputType_dataBusy: unknown;
 }
@@ -139,7 +142,7 @@ export declare class AparteComposerDirective extends AparteElementBase {
 }
 /** `<aparte-composer-action>` — Generic action button primitive for <aparte-composer>. */
 export declare class AparteComposerActionDirective extends AparteElementBase {
-    /** Icon key for aparteGlobalConfig.getIcon(), or raw SVG/HTML starting with `<` */
+    /** Icon key for aparteGlobalConfig.getIcon(), or raw SVG/HTML starting with `<`. A key core's glyph set does not hold renders AS TEXT (`icon="star"` draws the word *star*), so bring your own set through `setIconProvider` or pass the SVG. */
     set icon(v: string | undefined);
     /** Accessible label (also used as tooltip) */
     set label(v: string | undefined);
@@ -259,36 +262,42 @@ export declare class AparteContextDirective extends AparteElementBase {
     static ngAcceptInputType_autoCompact: unknown;
     static ngAcceptInputType_dataEmpty: unknown;
 }
-/** `<aparte-conversation-list>` — Conversation-history sidebar — a framework-agnostic web component. The host sets the `conversations` JS property and the `active-id` attribute; this renders the rows and fires the user's intent, never acting on it itself. */
+/** `<aparte-conversation-list>` — Conversation-history sidebar — a framework-agnostic web component. The host sets the `conversations` JS property and the `active-id` attribute; this renders the rows and fires the user's intent. Acting on it is the host's, unless `manage` hands the row menu's writes to the registered conversation manager. */
 export declare class AparteConversationListDirective extends AparteElementBase {
     /** The id of the conversation to render as selected. */
     set activeId(v: string | undefined);
     /** Render the rows flat, in host order, with no date headings. */
-    set noGroups(v: boolean);
-    /** The same item on a pinned row; same detail shape, opposite intent. */
-    readonly unpinConversation: EventEmitter<AparteConversationPinDetail>;
-    /** The pin item was chosen on an unpinned row. */
-    readonly pinConversation: EventEmitter<AparteConversationPinDetail>;
-    /** The same item on an already-archived one; same detail shape, opposite intent. */
-    readonly unarchiveConversation: EventEmitter<AparteConversationArchiveDetail>;
-    /** The archive item was chosen on a live conversation. */
-    readonly archiveConversation: EventEmitter<AparteConversationArchiveDetail>;
-    /** The delete was confirmed. Nothing is removed here. */
-    readonly deleteConversation: EventEmitter<AparteConversationDeleteDetail>;
-    /** A rename was committed with a new, non-empty title. Nothing is renamed here. */
-    readonly renameConversation: EventEmitter<AparteConversationRenameDetail>;
+    set flat(v: boolean);
+    /** The list is on its way: six skeleton rows stand where the rows will be, the element is `aria-busy` and a visually hidden line names the wait. A list that is not there yet is not an empty list. Set it while your store answers, clear it when you assign `conversations`. */
+    set loading(v: boolean);
+    /** Let the list finish the gesture: rename, pin, unpin, archive, unarchive and delete are performed on the conversation manager registered with `setConversationManager()`, instead of leaving you six listeners to write. The event still fires first, and `preventDefault()` on it takes the gesture back. Off by default, and selecting stays yours either way. */
+    set manage(v: boolean);
     /** A row's title was activated; the host loads that conversation. */
-    readonly selectConversation: EventEmitter<AparteConversationSelectDetail>;
-    protected onUnpinConversation(e: CustomEvent<AparteConversationPinDetail>): void;
-    protected onPinConversation(e: CustomEvent<AparteConversationPinDetail>): void;
-    protected onUnarchiveConversation(e: CustomEvent<AparteConversationArchiveDetail>): void;
-    protected onArchiveConversation(e: CustomEvent<AparteConversationArchiveDetail>): void;
-    protected onDeleteConversation(e: CustomEvent<AparteConversationDeleteDetail>): void;
-    protected onRenameConversation(e: CustomEvent<AparteConversationRenameDetail>): void;
-    protected onSelectConversation(e: CustomEvent<AparteConversationSelectDetail>): void;
+    readonly conversationSelect: EventEmitter<AparteConversationSelectDetail>;
+    /** A rename was committed with a new, non-empty title. Cancelable: `preventDefault()` takes the gesture back from `manage`. Angular: this Output emits the detail, so preventDefault() is not on it — bind the DOM event for that: (aparte-conversation-rename)="$event.preventDefault()". */
+    readonly conversationRename: EventEmitter<AparteConversationRenameDetail>;
+    /** The pin item was chosen on an unpinned row. Cancelable: `preventDefault()` takes the gesture back from `manage`. Angular: this Output emits the detail, so preventDefault() is not on it — bind the DOM event for that: (aparte-conversation-pin)="$event.preventDefault()". */
+    readonly conversationPin: EventEmitter<AparteConversationPinDetail>;
+    /** The same item on a pinned row; same detail shape, opposite intent. Cancelable, like the rest. Angular: this Output emits the detail, so preventDefault() is not on it — bind the DOM event for that: (aparte-conversation-unpin)="$event.preventDefault()". */
+    readonly conversationUnpin: EventEmitter<AparteConversationPinDetail>;
+    /** The archive item was chosen on a live conversation. Cancelable: `preventDefault()` takes the gesture back from `manage`. Angular: this Output emits the detail, so preventDefault() is not on it — bind the DOM event for that: (aparte-conversation-archive)="$event.preventDefault()". */
+    readonly conversationArchive: EventEmitter<AparteConversationArchiveDetail>;
+    /** The same item on an already-archived one; same detail shape, opposite intent. Cancelable, like the rest. Angular: this Output emits the detail, so preventDefault() is not on it — bind the DOM event for that: (aparte-conversation-unarchive)="$event.preventDefault()". */
+    readonly conversationUnarchive: EventEmitter<AparteConversationArchiveDetail>;
+    /** The delete was confirmed. Cancelable: `preventDefault()` takes the gesture back from `manage`. Angular: this Output emits the detail, so preventDefault() is not on it — bind the DOM event for that: (aparte-conversation-delete)="$event.preventDefault()". */
+    readonly conversationDelete: EventEmitter<AparteConversationDeleteDetail>;
+    protected onConversationSelect(e: CustomEvent<AparteConversationSelectDetail>): void;
+    protected onConversationRename(e: CustomEvent<AparteConversationRenameDetail>): void;
+    protected onConversationPin(e: CustomEvent<AparteConversationPinDetail>): void;
+    protected onConversationUnpin(e: CustomEvent<AparteConversationPinDetail>): void;
+    protected onConversationArchive(e: CustomEvent<AparteConversationArchiveDetail>): void;
+    protected onConversationUnarchive(e: CustomEvent<AparteConversationArchiveDetail>): void;
+    protected onConversationDelete(e: CustomEvent<AparteConversationDeleteDetail>): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AparteConversationListDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<AparteConversationListDirective, "aparte-conversation-list", never, { "activeId": { "alias": "activeId"; "required": false; }; "noGroups": { "alias": "noGroups"; "required": false; }; }, { "unpinConversation": "unpinConversation"; "pinConversation": "pinConversation"; "unarchiveConversation": "unarchiveConversation"; "archiveConversation": "archiveConversation"; "deleteConversation": "deleteConversation"; "renameConversation": "renameConversation"; "selectConversation": "selectConversation"; }, never, never, true, never>;
-    static ngAcceptInputType_noGroups: unknown;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<AparteConversationListDirective, "aparte-conversation-list", never, { "activeId": { "alias": "activeId"; "required": false; }; "flat": { "alias": "flat"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "manage": { "alias": "manage"; "required": false; }; }, { "conversationSelect": "conversationSelect"; "conversationRename": "conversationRename"; "conversationPin": "conversationPin"; "conversationUnpin": "conversationUnpin"; "conversationArchive": "conversationArchive"; "conversationUnarchive": "conversationUnarchive"; "conversationDelete": "conversationDelete"; }, never, never, true, never>;
+    static ngAcceptInputType_flat: unknown;
+    static ngAcceptInputType_loading: unknown;
+    static ngAcceptInputType_manage: unknown;
 }
 /** `<aparte-elicitation>` — The default presenter for a request to the human. It renders nothing itself: it registers as the presenter for the config governing its subtree, and mounts a panel inside the nearest `<aparte-composer>` when something asks — a tool handler calling `requestUserInput`, or core's own approval gate. */
 /**
@@ -358,7 +367,7 @@ export declare class AparteScrollRailDirective extends AparteElementBase {
     set every(v: string | undefined);
     /** Reflected BY the element while it has fewer than two ticks. Read-only. */
     set dataEmpty(v: boolean);
-    /** A tick was activated. Bubbles, cancelable: `preventDefault()` leaves the transcript where it is. */
+    /** A tick was activated. Bubbles, cancelable: `preventDefault()` leaves the transcript where it is. Angular: this Output emits the detail, so preventDefault() is not on it — bind the DOM event for that: (aparte-scroll-rail-jump)="$event.preventDefault()". */
     readonly scrollRailJump: EventEmitter<AparteScrollRailJumpDetail>;
     protected onScrollRailJump(e: CustomEvent<AparteScrollRailJumpDetail>): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AparteScrollRailDirective, never>;
@@ -453,7 +462,7 @@ export declare class AparteSuggestionsDirective extends AparteElementBase {
     set emptyOnly(v: boolean);
     /** Reflected BY the element while it has no suggestion to show; the stylesheet hides it then. Read-only, do not set it yourself. */
     set dataEmpty(v: boolean);
-    /** A starter was clicked. Bubbles, and is cancelable: `preventDefault()` stops the composer from being filled or submitted. */
+    /** A starter was clicked. Bubbles, and is cancelable: `preventDefault()` stops the composer from being filled or submitted. Angular: this Output emits the detail, so preventDefault() is not on it — bind the DOM event for that: (aparte-suggestion)="$event.preventDefault()". */
     readonly suggestion: EventEmitter<AparteSuggestionEventDetail>;
     protected onSuggestion(e: CustomEvent<AparteSuggestionEventDetail>): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AparteSuggestionsDirective, never>;

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export { provideAparte, APARTE_CONFIG_TOKEN } from './lib/provide-aparte';
 export type { ProvideAparteOptions, ApartePluginLoader } from './lib/provide-aparte';
 export { AparteChatComponent } from './lib/aparte-chat.component';
 export { AparteUiComponent } from './lib/aparte-ui.component';
-export type { AparteUiHandle } from './lib/aparte-ui.component';
+export type { AparteUiHandle, AparteUiProps } from './lib/aparte-ui.component';
 export * from './generated/element.directives';
 export { AparteAiService, APARTE_CLIENT_OPTIONS } from './lib/aparte-ai.service';
 export { ConversationManagerService } from './lib/conversation-manager.service';

package/dist/lib/aparte-ai.service.d.ts

@@ -1,5 +1,5 @@
 import { OnDestroy, InjectionToken } from '@angular/core';
-import { AparteClientOptions } from '@aparte/core';
+import { AparteClient, AparteClientOptions } from '@aparte/core';
 import * as i0 from "@angular/core";
 /**
  * Injection token for AparteClient configuration. Provided by `provideAparte()`;
@@ -14,7 +14,14 @@ export declare const APARTE_CLIENT_OPTIONS: InjectionToken<AparteClientOptions>;
  */
 export declare class AparteAiService implements OnDestroy {
     private readonly _clientOptions;
-    private _client;
+    private readonly _client;
+    /**
+     * The `AparteClient` this service drives — the same object React's
+     * `useAparteClient`, Vue's and Svelte's `createAparteClient` return as
+     * `{ client, abort }`. Angular alone kept it private, so the instance was
+     * unreachable while each service's docblock called itself the others' equivalent.
+     */
+    get client(): AparteClient;
     /**
      * Start listening to `aparte-send` events globally.
      * This connects the <aparte-chat> components to the AI Providers.
@@ -25,7 +32,9 @@ export declare class AparteAiService implements OnDestroy {
      */
     connect(): void;
     /**
-     * Stop listening.
+     * Stop listening. The client also takes its `keyResolver` back off the config,
+     * so a paused bridge no longer answers for keys — a model list refreshed while
+     * disconnected sees the config's other key sources only.
      */
     disconnect(): void;
     /**

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

@@ -43,6 +43,35 @@ export declare class AparteChatComponent implements AfterViewInit, OnDestroy, Ap
      */
     set centerWhenEmptyInput(val: boolean);
     readonly centerWhenEmpty: import("@angular/core").WritableSignal<boolean>;
+    /**
+     * The conversation is on its way: the viewport draws two skeleton turns, the empty
+     * state stays off and the composer is disabled until it lands. The conversation
+     * controller sets this itself while it fetches through your adapter's `loadFull()`;
+     * the input is for a wait of your own. Off by default.
+     */
+    set loadingInput(val: boolean);
+    readonly loading: import("@angular/core").WritableSignal<boolean>;
+    /** The controller's wait (a conversation fetched through the adapter). */
+    readonly hostLoading: import("@angular/core").WritableSignal<boolean>;
+    readonly waiting: import("@angular/core").Signal<boolean>;
+    get loadingText(): string;
+    /**
+     * Class(es) merged onto the INNER `.aparte-chat-container`, not onto this
+     * component's own `<aparte-chat>` host.
+     *
+     * The other three wrappers have no such host: their root IS the container, so a
+     * consumer's `className` / `class` lands on the div that carries
+     * `.aparte-chat-container`, `[overlay-composer]` and `[data-aparte-empty]` — the
+     * three selectors core's shell recipe keys on. Here a class written on the tag
+     * lands one level above them, so overriding the shell needed a descendant
+     * selector on Angular alone. This input is that parity. Additive: the recipe's
+     * own classes stay.
+     */
+    set containerClassInput(val: string);
+    readonly containerClass: import("@angular/core").WritableSignal<string>;
+    /** Inline style for the same div — a string or a `{ prop: value }` map. */
+    set containerStyleInput(val: string | Record<string, string> | null);
+    readonly containerStyle: import("@angular/core").WritableSignal<string | Record<string, string>>;
     /**
      * Overlay the composer on the transcript (the ChatGPT anatomy): the scroll
      * surface spans the whole column, the scrollbar runs edge to edge, and the
@@ -168,8 +197,13 @@ export declare class AparteChatComponent implements AfterViewInit, OnDestroy, Ap
     appendToSegment(segmentId: string, content: string): void;
     /** Read the current message list. */
     getMessages(): AparteMessage[];
-    /** Clear all messages + reset state. */
-    clearMessages(): void;
+    /**
+     * Clear all messages + reset state. `{ revokeAttachments: false }` keeps the
+     * attachments' object URLs alive — pass it when the same messages are going back.
+     */
+    clearMessages(options?: {
+        revokeAttachments?: boolean;
+    }): void;
     /** Scroll the viewport to the latest message. */
     scrollToBottom(): void;
     /**
@@ -209,10 +243,11 @@ export declare class AparteChatComponent implements AfterViewInit, OnDestroy, Ap
     /** Handle aparte-send event from the composer Web Component. */
     onAparteSend(event: Event): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AparteChatComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AparteChatComponent, "aparte-chat", never, { "messagesInput": { "alias": "messages"; "required": false; }; "placeholderInput": { "alias": "placeholder"; "required": false; }; "disabledInput": { "alias": "disabled"; "required": false; }; "submitOnEnterInput": { "alias": "submitOnEnter"; "required": false; }; "centerWhenEmptyInput": { "alias": "centerWhenEmpty"; "required": false; }; "overlayComposerInput": { "alias": "overlayComposer"; "required": false; }; "attachmentsInput": { "alias": "attachments"; "required": false; }; "elicitationInput": { "alias": "elicitation"; "required": false; }; "isTypingInput": { "alias": "isTyping"; "required": false; }; "typingTextInput": { "alias": "typingText"; "required": false; }; "layoutTransitionMs": { "alias": "layoutTransitionMs"; "required": false; }; "conversationIdInput": { "alias": "conversationId"; "required": false; }; "config": { "alias": "config"; "required": false; }; "bubbleTemplate": { "alias": "bubbleTemplate"; "required": false; }; }, { "messageSent": "messageSent"; "action": "action"; "messagesChange": "messagesChange"; "messageAppended": "messageAppended"; "typingChange": "typingChange"; "conversationCreated": "conversationCreated"; }, never, ["[slot='empty-state']", "[slot='above-composer']", "[slot='toolbar']", "[slot='composer']"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AparteChatComponent, "aparte-chat", never, { "messagesInput": { "alias": "messages"; "required": false; }; "placeholderInput": { "alias": "placeholder"; "required": false; }; "disabledInput": { "alias": "disabled"; "required": false; }; "submitOnEnterInput": { "alias": "submitOnEnter"; "required": false; }; "centerWhenEmptyInput": { "alias": "centerWhenEmpty"; "required": false; }; "loadingInput": { "alias": "loading"; "required": false; }; "containerClassInput": { "alias": "containerClass"; "required": false; }; "containerStyleInput": { "alias": "containerStyle"; "required": false; }; "overlayComposerInput": { "alias": "overlayComposer"; "required": false; }; "attachmentsInput": { "alias": "attachments"; "required": false; }; "elicitationInput": { "alias": "elicitation"; "required": false; }; "isTypingInput": { "alias": "isTyping"; "required": false; }; "typingTextInput": { "alias": "typingText"; "required": false; }; "layoutTransitionMs": { "alias": "layoutTransitionMs"; "required": false; }; "conversationIdInput": { "alias": "conversationId"; "required": false; }; "config": { "alias": "config"; "required": false; }; "bubbleTemplate": { "alias": "bubbleTemplate"; "required": false; }; }, { "messageSent": "messageSent"; "action": "action"; "messagesChange": "messagesChange"; "messageAppended": "messageAppended"; "typingChange": "typingChange"; "conversationCreated": "conversationCreated"; }, never, ["[slot='empty-state']", "[slot='above-composer']", "[slot='toolbar']", "[slot='composer']"], true, never>;
     static ngAcceptInputType_disabledInput: unknown;
     static ngAcceptInputType_submitOnEnterInput: unknown;
     static ngAcceptInputType_centerWhenEmptyInput: unknown;
+    static ngAcceptInputType_loadingInput: unknown;
     static ngAcceptInputType_overlayComposerInput: unknown;
     static ngAcceptInputType_attachmentsInput: unknown;
     static ngAcceptInputType_elicitationInput: unknown;

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

@@ -1,12 +1,27 @@
 import { OnChanges, OnDestroy, AfterViewInit, SimpleChanges } from '@angular/core';
+import { type AparteUiHandle } from '@aparte/core';
 import * as i0 from "@angular/core";
 /**
- * The imperative surface of the `AparteUi` proxy — the same
- * `getElement`/`callMethod` contract on all four wrappers.
+ * The imperative surface of the `AparteUi` proxy — one declaration in `@aparte/core`,
+ * re-exported by all four wrappers. It used to be four hand-written copies, each
+ * promising "the same contract on all four", and it had already drifted.
  */
-export interface AparteUiHandle {
-    getElement<T extends HTMLElement = HTMLElement>(): T | null;
-    callMethod<T = unknown>(methodName: string, ...args: unknown[]): T | undefined;
+export type { AparteUiHandle } from '@aparte/core';
+/**
+ * The proxy's inputs, named for parity with React/Vue/Svelte, which all export an
+ * `AparteUiProps`. Angular's are `@Input`s on the component rather than an object, so
+ * this is the shape a caller building `[props]` programmatically writes against.
+ */
+export interface AparteUiProps {
+    /** The custom element tag name (e.g. 'aparte-model-selector'). */
+    name: string;
+    /** Props to apply. Keys starting with `--` become CSS variables. */
+    props?: Record<string, unknown>;
+    /**
+     * Which custom events to forward through `elementEvent`. Defaults to the
+     * interactive aparté surface ({@link APARTE_DEFAULT_UI_EVENTS}).
+     */
+    events?: string[];
 }
 /**
  * AparteUiComponent - Universal UI Proxy

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

@@ -2,8 +2,9 @@ import { InjectionToken, type EnvironmentProviders } from '@angular/core';
 import { type AparteAIProvider, type AparteClientOptions, type AparteIconProvider, type AparteLocale, type AparteMarkdownProvider, type AparteModelConfig } from '@aparte/core';
 /**
  * Any function that initialises a plugin — sync or async, so it can wrap a
- * dynamic `import()` of a package YOU choose:
- * `() => import('@aparte/plugin-model-selector')`.
+ * dynamic `import()` of a package YOU choose. It resolves to nothing, so `await`
+ * the import rather than returning it:
+ * `async () => { await import('@aparte/plugin-model-selector'); }`.
  */
 export type ApartePluginLoader = () => void | Promise<void>;
 /**
@@ -17,7 +18,11 @@ export interface ProvideAparteOptions {
     providers?: AparteAIProvider[];
     /** Optional plugin wiring — objects or loaders, never package-name strings. */
     plugins?: {
-        /** Action plugins, as loaders: `[() => import('@aparte/plugin-model-selector')]`. */
+        /**
+         * Action plugins, as loaders. A loader resolves to nothing, so `await` the
+         * import rather than returning it:
+         * `[async () => { await import('@aparte/plugin-model-selector'); }]`.
+         */
         actions?: ApartePluginLoader[];
         /** An icon provider object, or a loader that registers one. */
         icons?: AparteIconProvider | ApartePluginLoader;
@@ -53,8 +58,22 @@ export declare const APARTE_CONFIG_TOKEN: InjectionToken<ProvideAparteOptions>;
  * `AparteAiService.connect()` needed.
  *
  * The components (`AparteChatComponent`, `AparteUiComponent`) are standalone and
- * work WITHOUT this — it is config sugar. You can equally call `aparteGlobalConfig.*`
- * yourself, exactly like the React/Vue/Svelte wrappers do.
+ * work WITHOUT this — it is config sugar. Angular is the only wrapper that has it,
+ * and the other three lose nothing: what this provider exists for is an initializer
+ * that runs before the first component and a `DestroyRef` to release the theme
+ * listener. Everything it configures is a plain call — bar `theme: 'auto'`, which is a
+ * `matchMedia` listener you own — so React, Vue and Svelte make the same ones at module
+ * scope, before the app mounts:
+ *
+ * ```ts
+ * aparteGlobalConfig.registerAIProvider(createOpenAICompatProvider(presets.OPENROUTER));
+ * aparteGlobalConfig.setModelConfig({ defaultModel: 'openai/gpt-4o-mini' });
+ * aparteGlobalConfig.setLocale(fr);
+ * document.documentElement.setAttribute('data-aparte-theme', 'dark');
+ * // 'auto' is the one option with no one-liner: match prefers-color-scheme, rewrite the
+ * // attribute on change, and drop the listener when your app tears down.
+ * // The client stays the wrapper's own: useAparteClient(), createAparteClient().
+ * ```
  *
  * @example
  * bootstrapApplication(App, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aparte/angular",
-  "version": "0.16.10",
+  "version": "0.17.0",
   "homepage": "https://apartejs.dev/frameworks/angular/",
   "description": "Angular 19 wrapper for aparté — 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",
     "@angular/core": "^19.2.0",
-    "@aparte/core": ">=0.16.10 <1.0.0",
+    "@aparte/core": ">=0.17.0 <1.0.0",
     "rxjs": "^7.8.0"
   },
   "devDependencies": {
@@ -46,7 +46,7 @@
     "typescript": "^5.4.0",
     "vite": "^6.0.0",
     "zone.js": "~0.15.0",
-    "@aparte/core": "0.16.10"
+    "@aparte/core": "0.17.0"
   },
   "keywords": [
     "angular",