@h-k-dev/angular-email-editor 0.0.5 → 0.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h-k-dev/angular-email-editor",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "An email editor for Angular on ProseMirror — a visual composer and an HTML source editor over one schema that is the vocabulary of email HTML.",
   "license": "MIT",
   "author": "h-k-dev",

package/types/h-k-dev-angular-email-editor-actions.d.ts

@@ -2,6 +2,7 @@ import * as _angular_core from '@angular/core';
 import { Signal, Injector } from '@angular/core';
 import { EditorState } from 'prosemirror-state';
 import { EditorAction, Editor } from '@h-k-dev/angular-email-editor';
+import * as _h_k_dev_angular_email_editor_actions from '@h-k-dev/angular-email-editor/actions';
 
 /**
  * An editor's state as a signal: the text, the selection, the stored marks —
@@ -81,7 +82,7 @@ interface EditorActions {
  *
  *     readonly actions = injectActions(() => this.editor());
  *
- *     <button [emailAction]="actions.get('bold')">…</button>
+ *     <button emailAction="bold" [emailActionFrom]="actions">…</button>
  *
  * `editor` is read reactively: when it changes — a composer switching to its
  * code view — the actions are the new editor's. Its kit decides what exists:
@@ -103,11 +104,15 @@ declare function injectActions(editor: () => Editor | undefined, options?: {
  * Makes the host's own control the trigger of an editor action: a click runs
  * it, and the control says what the action's state is.
  *
- *     <button mat-icon-button [emailAction]="actions.get('bold')" #bold="emailAction"
- *             [disabled]="bold.disabled()">
+ *     <button mat-icon-button emailAction="bold" [emailActionFrom]="actions"
+ *             #bold="emailAction" [disabled]="bold.disabled()">
  *       <mat-icon>format_bold</mat-icon>
  *     </button>
  *
+ * The action is named by its id, and looked up in the list it is from
+ * (`injectActions`) here, in a `computed`: a template binds values and reads
+ * signals, it calls no lookup of its own.
+ *
  * Behaviour only, and ARIA only where the host's widget has not spoken:
  * - `aria-pressed` for a toggle, and `aria-disabled` when it cannot run —
  *   both off with `[emailActionAria]="false"` for a widget that writes its own
@@ -124,9 +129,13 @@ declare function injectActions(editor: () => Editor | undefined, options?: {
  * dialog, a picker) never has focus taken from what it opened.
  */
 declare class ActionTrigger {
-    /** The action to trigger — `actions.get(id)`. `undefined` (no editor yet,
-        or a kit without it) is a trigger with nothing to do: disabled. */
-    readonly action: _angular_core.InputSignal<BoundAction | undefined>;
+    /** The id of the action to trigger. */
+    readonly id: _angular_core.InputSignal<string>;
+    /** The actions it is one of — what `injectActions` returned. */
+    readonly from: _angular_core.InputSignal<EditorActions>;
+    /** The action itself. `undefined` (no editor yet, or a kit without it) is a
+        trigger with nothing to do: disabled. */
+    readonly action: _angular_core.Signal<_h_k_dev_angular_email_editor_actions.BoundAction | undefined>;
     /** Whether this directive writes `aria-pressed` and `aria-disabled`. */
     readonly aria: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Whether the caret returns to the editor after the action ran. */
@@ -140,7 +149,7 @@ declare class ActionTrigger {
     /** Runs the action, as a click does. False when it did not apply. */
     run(): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ActionTrigger, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ActionTrigger, "[emailAction]", ["emailAction"], { "action": { "alias": "emailAction"; "required": true; "isSignal": true; }; "aria": { "alias": "emailActionAria"; "required": false; "isSignal": true; }; "returnFocus": { "alias": "emailActionFocus"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ActionTrigger, "[emailAction]", ["emailAction"], { "id": { "alias": "emailAction"; "required": true; "isSignal": true; }; "from": { "alias": "emailActionFrom"; "required": true; "isSignal": true; }; "aria": { "alias": "emailActionAria"; "required": false; "isSignal": true; }; "returnFocus": { "alias": "emailActionFocus"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 export { ActionTrigger, editorState, injectActions };

package/types/h-k-dev-angular-email-editor-address-input.d.ts

@@ -242,9 +242,10 @@ declare class AddressInput implements FormValueControl<string[]> {
     select(address: string | null): void;
     /** The chips as rendered, for the commands that are the chip's own. */
     protected readonly chips: _angular_core.Signal<readonly AddressChip[]>;
+    /** What a chip's id starts with; its index ends it. */
+    protected readonly chipIdPrefix: string;
     /** The active chip's id, for the input's `aria-activedescendant`. */
     protected readonly activeId: _angular_core.Signal<string | null>;
-    protected chipId(index: number): string;
     /** The cap is reached: a further address is refused. */
     readonly full: _angular_core.Signal<boolean>;
     /** Full, and nothing in it to fix: the input hides — the chips say

package/types/h-k-dev-angular-email-editor-suggestion-menu.d.ts

@@ -156,14 +156,14 @@ declare class SuggestionMenuItem {
 
 /**
  * A heading in a suggestion menu's list: the words of a section
- * (`SuggestionItem.section`, worded by the state's `sectionTitle`), shown
- * where the section changes from one row to the next. Never an option: it
- * takes no highlight, no click, and no place in the count — presentation,
- * the way a chat's slash menu heads its groups.
+ * (`SuggestionItem.section`), shown where the section changes from one row
+ * to the next — the state says where, and in which words, as each item's
+ * `heading`. Never an option: it takes no highlight, no click, and no place
+ * in the count — presentation, the way a chat's slash menu heads its groups.
  *
  *     @for (item of state.items; track item.id) {
- *       @if (item.section && item.section !== state.items[$index - 1]?.section) {
- *         <div email-suggestion-menu-section>{{ state.sectionTitle(item.section) }}</div>
+ *       @if (item.heading; as heading) {
+ *         <div email-suggestion-menu-section>{{ heading }}</div>
  *       }
  *       <div email-suggestion-menu-item [item]="item">…</div>
  *     }