@h-k-dev/angular-email-editor 0.0.0-stage → 0.0.1

package/README.md

@@ -1,3 +1,128 @@
-# Temporary Holding Version
+# Angular Email Editor
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![npm version](https://img.shields.io/npm/v/@h-k-dev/angular-email-editor.svg)](https://www.npmjs.com/package/@h-k-dev/angular-email-editor)
+[![license](https://img.shields.io/npm/l/@h-k-dev/angular-email-editor.svg)](https://github.com/h-k-dev/angular-email-editor/blob/main/LICENSE)
+
+An email editor for Angular, built on [ProseMirror](https://prosemirror.net): a visual
+composer and an HTML source editor over **one schema that is the vocabulary of email
+HTML** — what Gmail, Outlook and Apple Mail apply survives, nothing else is emitted.
+Headless where it can be: you own the markup and the pixels; the library brings the
+engine, the behaviour and accessible building blocks.
+
+**[Try the live demo →](https://h-k-dev.github.io/angular-email-editor/)**
+
+> **Pre-1.0.** The API still moves between `0.x` versions; releases are deliberate, not
+> per commit. Pin a version and read the release notes before upgrading.
+
+## What you get
+
+- **Email-safe by construction** — markup is parsed into the email vocabulary and
+  re-emitted deterministically: inline styles, `<div>` lines, tables that render in
+  Outlook. Builder exports (MJML) keep their structure; pasted Word/Docs markup is cleaned.
+- **Corrects what other editors stored** — opening HTML saved by WYSIWYG editors such as
+  Summernote repairs `mailto://` links, `http://{{placeholder}}` links, Word's `<o:p>`,
+  Bootstrap-only table borders and formatting wrapped around block lines, without losing
+  the author's intent.
+- **Two editors, one document** — the visual composer and an HTML source pane
+  (highlighting, lint, formatter) run the same commands over the same schema.
+- **Placeholders** — `{{ expression }}` tokens as merge-tag pills, an optional AngularJS
+  expression dialect with live syntax diagnostics, and **placeholder filling**
+  (`createMergeTagResolution`, <kbd>Ctrl</kbd>/<kbd>⌘</kbd>+<kbd>Shift</kbd>+<kbd>Enter</kbd>):
+  your evaluator gets each expression raw, the values go back in as text, in one undo step.
+- **Compose workflow** — reply/forward seeds with localized labels, quoted history kept
+  beside the body, inline images (`cid:`), a send intent with `text/plain` alternative.
+- **Address fields that implement the RFCs** — RFC 5322/5321/6531 parsing and
+  formatting behind a pluggable rule, chips, signal-forms validation, placeholders as
+  pending (not invalid) addresses, and an Angular Material form-field adapter.
+- **Attachment chips** with upload stages (Uppy/tus vocabulary) and progress.
+
+## Installation
+
+```bash
+npm install @h-k-dev/angular-email-editor prosemirror-commands prosemirror-gapcursor prosemirror-history prosemirror-inputrules prosemirror-keymap prosemirror-model prosemirror-schema-list prosemirror-state prosemirror-tables prosemirror-transform prosemirror-view
+```
+
+Requires Angular `22`. The ProseMirror packages are peers so your app holds exactly one
+copy of each.
+
+| Optional peer | Needed for |
+| --- | --- |
+| `@angular/forms` | `/address-input`, `/attachment-chips` (signal-forms controls) |
+| `@angular/material`, `rxjs` | `/material` (the `mat-form-field` adapter) |
+| `@chenglou/pretext` `^1.0.0` | `/metrics` (word, line and height metrics) |
+
+## Quick start
+
+```ts
+import { Component, DestroyRef, ElementRef, afterNextRender, inject, signal, viewChild } from '@angular/core';
+import { Editor, createEditor, emailExtensions } from '@h-k-dev/angular-email-editor';
+
+@Component({
+  selector: 'app-mail-body',
+  template: `<div #host></div>`,
+})
+export class MailBody {
+  readonly html = signal('<div>Hello</div>');
+  private readonly host = viewChild.required<ElementRef<HTMLElement>>('host');
+  #editor?: Editor;
+
+  constructor() {
+    afterNextRender(() => {
+      this.#editor = createEditor({
+        parent: this.host().nativeElement,
+        extensions: emailExtensions,
+        content: this.html(),
+        onUpdate: (editor) => this.html.set(editor.getHTML()),
+      });
+    });
+    inject(DestroyRef).onDestroy(() => this.#editor?.destroy());
+  }
+}
+```
+
+`emailExtensions` is the full email kit; add extensions next to it (`createSendIntent`,
+`createMergeTagResolution`, `createSuggestionMenu`, …) or build a kit of your own.
+
+## Entry points
+
+Every UI piece is its own secondary entry point, so you only bundle what you import.
+
+| Import | What it is |
+| --- | --- |
+| `@h-k-dev/angular-email-editor` | The engine: `createEditor`, kits, schema, HTML parse/serialize, extensions |
+| `…/actions` | Editor actions as signals — `injectActions`, `[emailAction]` for your own buttons |
+| `…/address` | The address rule (RFC 5322/5321/6531): parse, format, split, join, `ADDRESS_RULES` |
+| `…/address-input` | The address field: chips, `FormValueControl<string[]>`, `addressList` validator |
+| `…/address-chip` | One address chip |
+| `…/attachment-chips` | The attachment strip, a `FormValueControl` over the list |
+| `…/attachment-chip` | One attachment chip with upload stages and progress |
+| `…/suggestion-menu` | The `/` and `{{` menus' floating box, with roles and ids |
+| `…/palette` | The colour palette (readable on light and dark) |
+| `…/proposal` | A streamed proposal's state for your panel (accept / discard) |
+| `…/chat-input` | A chat-style prompt input on the same engine |
+| `…/image` | `[emailImageAlt]` — your text field as the selected image's alt text |
+| `…/anchor` | `[emailAnchor]` — position an overlay at a rect |
+| `…/focus` | `[emailKeepFocus]` — controls that keep the caret in the editor |
+| `…/material` | `[emailMatFormField]` — an address input inside `mat-form-field` |
+| `…/metrics` | Live text metrics (`createTextMetrics`), measured without DOM reads |
+
+## Styling
+
+The components theme through a token cascade: their own `--email-*` tokens first, then
+Material's `--mat-sys-*` system tokens, then a built-in light/dark fallback — a Material 3
+app is themed out of the box.
+
+The editable surface is yours to style; it carries the `aee-editor` class. Include
+ProseMirror's required CSS (`prosemirror-view/style/prosemirror.css`, and
+`prosemirror-tables/style/tables.css` for tables). The shared scrollbar look is a Sass mixin:
+
+```scss
+@use '@h-k-dev/angular-email-editor/styles/scroll';
+```
+
+The [demo app](https://github.com/h-k-dev/angular-email-editor/tree/main/projects/app) is
+the reference composer — toolbar, menus, compose windows — built only on this public API.
+
+## License
+
+[MIT](https://github.com/h-k-dev/angular-email-editor/blob/main/LICENSE)

package/fesm2022/h-k-dev-angular-email-editor-actions.mjs

@@ -0,0 +1,179 @@
+import * as i0 from '@angular/core';
+import { signal, effect, inject, Injector, computed, untracked, input, booleanAttribute, Directive } from '@angular/core';
+import { isActionEnabled } from '@h-k-dev/angular-email-editor';
+
+/**
+ * An editor's state as a signal: the text, the selection, the stored marks —
+ * whatever changed, the signal has the new one. It follows the editor it is
+ * given, so handing it "the source pane in code view, the email editor
+ * otherwise" is one `computed`; `undefined` while there is none.
+ *
+ * It listens through `editor.subscribe`, so the editor can already exist:
+ * nothing has to be in the kit before the editor is made.
+ *
+ * Call in an injection context, or hand it an injector.
+ */
+function editorState(editor, options = {}) {
+    const state = signal(undefined, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "state" }] : /* istanbul ignore next */ []));
+    effect((onCleanup) => {
+        const current = editor();
+        state.set(current?.state);
+        if (current)
+            onCleanup(current.subscribe(() => state.set(current.state)));
+    }, { injector: options.injector });
+    return state.asReadonly();
+}
+/**
+ * The actions of an editor, bound and live — for a toolbar, a bubble menu,
+ * a menu:
+ *
+ *     readonly actions = injectActions(() => this.editor());
+ *
+ *     <button [emailAction]="actions.get('bold')">…</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:
+ * the source pane offers the marks, so there a list button has no action
+ * and shows disabled, with no routing written anywhere.
+ *
+ * `host` and `override` bring in the host's own — see {@link HostAction} — so
+ * that one list serves a surface whose buttons are not all the editor's.
+ *
+ * Call in an injection context, or hand it an injector.
+ */
+function injectActions(editor, options = {}) {
+    const injector = options.injector ?? inject(Injector);
+    const state = editorState(editor, { injector });
+    const bind = (current, action, over) => {
+        const isActive = over?.isActive ?? action?.isActive;
+        const isEnabled = (now) => over?.isEnabled ? over.isEnabled(now) : action ? isActionEnabled(action, now) : true;
+        return {
+            action,
+            id: (over ?? action).id,
+            external: !!over,
+            toggles: !!isActive,
+            pressed: computed(() => {
+                const now = state();
+                return !!now && !!isActive?.(now);
+            }),
+            disabled: computed(() => {
+                const now = state();
+                return !now || !isEnabled(now);
+            }),
+            run: () => {
+                if (!over)
+                    return current.exec(action.command);
+                over.run();
+                return true;
+            },
+            focus: () => current.focus(),
+        };
+    };
+    const bound = computed(() => {
+        const current = editor();
+        const byId = new Map();
+        // Binding reads no state: only the editor decides which actions exist.
+        if (!current)
+            return byId;
+        const hosted = new Map((options.host ?? []).map((over) => [over.id, over]));
+        for (const action of current.actions) {
+            const given = options.override?.[action.id];
+            // A host action under a kit's id is an override by another name.
+            const over = given ? { id: action.id, ...given } : hosted.get(action.id);
+            hosted.delete(action.id);
+            byId.set(action.id, untracked(() => bind(current, action, over)));
+        }
+        // What stands alone comes after the kit's own, in the order given.
+        for (const over of hosted.values()) {
+            byId.set(over.id, untracked(() => bind(current, undefined, over)));
+        }
+        return byId;
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "bound" }] : /* istanbul ignore next */ []));
+    return {
+        get: (id) => bound().get(id),
+        all: computed(() => [...bound().values()]),
+        state,
+    };
+}
+
+/**
+ * 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()">
+ *       <mat-icon>format_bold</mat-icon>
+ *     </button>
+ *
+ * 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
+ *   (a Material button toggle);
+ * - never the native `disabled`, a class or a style: how disabled *looks* is
+ *   the host's, bound from `disabled()` as above. A control that is only
+ *   `aria-disabled` stays reachable by keyboard, which is what a toolbar wants;
+ * - a click on a disabled trigger runs nothing.
+ *
+ * After running, the caret goes back to the editor the action ran on — a
+ * no-op for a pointer press under `emailKeepFocus`, the way back for a key
+ * press in a toolbar. `[emailActionFocus]="false"` leaves focus on the
+ * control, as the ARIA toolbar pattern has it. A host's own action (a link
+ * dialog, a picker) never has focus taken from what it opened.
+ */
+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. */
+    action = input.required({ ...(ngDevMode ? { debugName: "action" } : /* istanbul ignore next */ {}), alias: 'emailAction' });
+    /** Whether this directive writes `aria-pressed` and `aria-disabled`. */
+    aria = input(true, { ...(ngDevMode ? { debugName: "aria" } : /* istanbul ignore next */ {}), alias: 'emailActionAria', transform: booleanAttribute });
+    /** Whether the caret returns to the editor after the action ran. */
+    returnFocus = input(true, { ...(ngDevMode ? { debugName: "returnFocus" } : /* istanbul ignore next */ {}), alias: 'emailActionFocus', transform: booleanAttribute });
+    /** On at the selection. */
+    pressed = computed(() => this.action()?.pressed() ?? false, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "pressed" }] : /* istanbul ignore next */ []));
+    /** Cannot run right now — or has no action at all. */
+    disabled = computed(() => this.action()?.disabled() ?? true, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
+    ariaPressed = computed(() => this.aria() && this.action()?.toggles ? this.pressed() : null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "ariaPressed" }] : /* istanbul ignore next */ []));
+    ariaDisabled = computed(() => (this.aria() && this.disabled() ? true : null), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "ariaDisabled" }] : /* istanbul ignore next */ []));
+    /** Runs the action, as a click does. False when it did not apply. */
+    run() {
+        const action = this.action();
+        if (!action || this.disabled())
+            return false;
+        const applied = action.run();
+        // A host's own action opened something of the host's: focus is its now.
+        if (this.returnFocus() && !action.external)
+            action.focus();
+        return applied;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.6", ngImport: i0, type: ActionTrigger, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.1.6", type: ActionTrigger, isStandalone: true, selector: "[emailAction]", inputs: { action: { classPropertyName: "action", publicName: "emailAction", isSignal: true, isRequired: true, transformFunction: null }, aria: { classPropertyName: "aria", publicName: "emailActionAria", isSignal: true, isRequired: false, transformFunction: null }, returnFocus: { classPropertyName: "returnFocus", publicName: "emailActionFocus", isSignal: true, isRequired: false, transformFunction: null } }, host: { listeners: { "click": "run()" }, properties: { "attr.aria-pressed": "ariaPressed()", "attr.aria-disabled": "ariaDisabled()" } }, exportAs: ["emailAction"], ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.6", ngImport: i0, type: ActionTrigger, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[emailAction]',
+                    exportAs: 'emailAction',
+                    host: {
+                        '[attr.aria-pressed]': 'ariaPressed()',
+                        '[attr.aria-disabled]': 'ariaDisabled()',
+                        '(click)': 'run()',
+                    },
+                }]
+        }], propDecorators: { action: [{ type: i0.Input, args: [{ isSignal: true, alias: "emailAction", required: true }] }], aria: [{ type: i0.Input, args: [{ isSignal: true, alias: "emailActionAria", required: false }] }], returnFocus: [{ type: i0.Input, args: [{ isSignal: true, alias: "emailActionFocus", required: false }] }] } });
+
+/*
+ * Public API Surface of @h-k-dev/angular-email-editor/actions
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { ActionTrigger, editorState, injectActions };
+//# sourceMappingURL=h-k-dev-angular-email-editor-actions.mjs.map

package/fesm2022/h-k-dev-angular-email-editor-actions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"h-k-dev-angular-email-editor-actions.mjs","sources":["../../../projects/angular-email-editor/actions/actions.ts","../../../projects/angular-email-editor/actions/action-trigger.ts","../../../projects/angular-email-editor/actions/public-api.ts","../../../projects/angular-email-editor/actions/h-k-dev-angular-email-editor-actions.ts"],"sourcesContent":["import { Injector, Signal, computed, effect, inject, signal, untracked } from '@angular/core';\nimport { EditorState } from 'prosemirror-state';\nimport { Editor, EditorAction, isActionEnabled } from '@h-k-dev/angular-email-editor';\n\n/**\n * An editor's state as a signal: the text, the selection, the stored marks —\n * whatever changed, the signal has the new one. It follows the editor it is\n * given, so handing it \"the source pane in code view, the email editor\n * otherwise\" is one `computed`; `undefined` while there is none.\n *\n * It listens through `editor.subscribe`, so the editor can already exist:\n * nothing has to be in the kit before the editor is made.\n *\n * Call in an injection context, or hand it an injector.\n */\nexport function editorState(\n  editor: () => Editor | undefined,\n  options: { injector?: Injector } = {},\n): Signal<EditorState | undefined> {\n  const state = signal<EditorState | undefined>(undefined);\n  effect(\n    (onCleanup) => {\n      const current = editor();\n      state.set(current?.state);\n      if (current) onCleanup(current.subscribe(() => state.set(current.state)));\n    },\n    { injector: options.injector },\n  );\n  return state.asReadonly();\n}\n\n/**\n * An action of the host's own: something that opens its UI — a link dialog,\n * a colour or table picker — rather than running a command. It has a `run`,\n * not a `command`, on purpose: a command is *asked* whether it would apply\n * (called without a dispatch), and a function that opens a dialog must never\n * be called to ask.\n *\n * Two ways in, by what it is:\n * - `host` — an action of its own, there for every editor: \"Link\", which\n *   no extension can offer because it needs the host's dialog;\n * - `override` — the host's `run` *over* an action the kit declares, by its\n *   id: a toolbar's \"Insert table\" that opens a size picker instead of\n *   inserting one. It exists only where the kit's action does (so not in a\n *   code view), and what it leaves out — when it is on, whether it can run —\n *   is still the extension's answer.\n */\nexport interface HostAction {\n  id: string;\n  /** What triggering it does. Focus is the host's from here on: the caret\n      is not sent back to the editor after it. */\n  run: () => void;\n  /** On at the selection — makes it a toggle. */\n  isActive?: (state: EditorState) => boolean;\n  /** Can run right now. Absent: the extension action's answer when it\n      stands over one, else yes. */\n  isEnabled?: (state: EditorState) => boolean;\n}\n\n/** An action bound to a live editor: what a button needs. */\nexport interface BoundAction {\n  /** The action as its extension declared it — id, title, icon, keywords;\n      `undefined` for a {@link HostAction} that stands alone. */\n  readonly action: EditorAction | undefined;\n  readonly id: string;\n  /** It is the host's `run`: what happens after — where focus goes — is the\n      host's too. */\n  readonly external: boolean;\n  /** On at the selection. Always false for an action with no \"on\". */\n  readonly pressed: Signal<boolean>;\n  /** Whether it is a toggle at all — whether `pressed` means anything. */\n  readonly toggles: boolean;\n  /** Cannot run right now. */\n  readonly disabled: Signal<boolean>;\n  /** Runs it on the editor; false when it did not apply. */\n  run(): boolean;\n  /** Puts the caret back in the editor it acts on. */\n  focus(): void;\n}\n\n/** The actions of the editor being watched. */\nexport interface EditorActions {\n  /** The action of that id — `undefined` while there is no editor, and when\n      the editor's kit has no such action: a button for it has nothing to do.\n      Reactive: it follows the editor. */\n  get(id: string): BoundAction | undefined;\n  /** Every action of the current editor, in kit order. */\n  readonly all: Signal<readonly BoundAction[]>;\n  /** The watched editor's state. */\n  readonly state: Signal<EditorState | undefined>;\n}\n\n/**\n * The actions of an editor, bound and live — for a toolbar, a bubble menu,\n * a menu:\n *\n *     readonly actions = injectActions(() => this.editor());\n *\n *     <button [emailAction]=\"actions.get('bold')\">…</button>\n *\n * `editor` is read reactively: when it changes — a composer switching to its\n * code view — the actions are the new editor's. Its kit decides what exists:\n * the source pane offers the marks, so there a list button has no action\n * and shows disabled, with no routing written anywhere.\n *\n * `host` and `override` bring in the host's own — see {@link HostAction} — so\n * that one list serves a surface whose buttons are not all the editor's.\n *\n * Call in an injection context, or hand it an injector.\n */\nexport function injectActions(\n  editor: () => Editor | undefined,\n  options: {\n    host?: readonly HostAction[];\n    override?: Readonly<Record<string, Omit<HostAction, 'id'>>>;\n    injector?: Injector;\n  } = {},\n): EditorActions {\n  const injector = options.injector ?? inject(Injector);\n  const state = editorState(editor, { injector });\n\n  const bind = (current: Editor, action?: EditorAction, over?: HostAction): BoundAction => {\n    const isActive = over?.isActive ?? action?.isActive;\n    const isEnabled = (now: EditorState) =>\n      over?.isEnabled ? over.isEnabled(now) : action ? isActionEnabled(action, now) : true;\n    return {\n      action,\n      id: (over ?? action)!.id,\n      external: !!over,\n      toggles: !!isActive,\n      pressed: computed(() => {\n        const now = state();\n        return !!now && !!isActive?.(now);\n      }),\n      disabled: computed(() => {\n        const now = state();\n        return !now || !isEnabled(now);\n      }),\n      run: () => {\n        if (!over) return current.exec(action!.command);\n        over.run();\n        return true;\n      },\n      focus: () => current.focus(),\n    };\n  };\n\n  const bound = computed(() => {\n    const current = editor();\n    const byId = new Map<string, BoundAction>();\n    // Binding reads no state: only the editor decides which actions exist.\n    if (!current) return byId;\n    const hosted = new Map((options.host ?? []).map((over) => [over.id, over]));\n    for (const action of current.actions) {\n      const given = options.override?.[action.id];\n      // A host action under a kit's id is an override by another name.\n      const over = given ? { id: action.id, ...given } : hosted.get(action.id);\n      hosted.delete(action.id);\n      byId.set(\n        action.id,\n        untracked(() => bind(current, action, over)),\n      );\n    }\n    // What stands alone comes after the kit's own, in the order given.\n    for (const over of hosted.values()) {\n      byId.set(\n        over.id,\n        untracked(() => bind(current, undefined, over)),\n      );\n    }\n    return byId;\n  });\n\n  return {\n    get: (id) => bound().get(id),\n    all: computed(() => [...bound().values()]),\n    state,\n  };\n}\n","import { Directive, booleanAttribute, computed, input } from '@angular/core';\nimport { BoundAction } from './actions';\n\n/**\n * Makes the host's own control the trigger of an editor action: a click runs\n * it, and the control says what the action's state is.\n *\n *     <button mat-icon-button [emailAction]=\"actions.get('bold')\" #bold=\"emailAction\"\n *             [disabled]=\"bold.disabled()\">\n *       <mat-icon>format_bold</mat-icon>\n *     </button>\n *\n * Behaviour only, and ARIA only where the host's widget has not spoken:\n * - `aria-pressed` for a toggle, and `aria-disabled` when it cannot run —\n *   both off with `[emailActionAria]=\"false\"` for a widget that writes its own\n *   (a Material button toggle);\n * - never the native `disabled`, a class or a style: how disabled *looks* is\n *   the host's, bound from `disabled()` as above. A control that is only\n *   `aria-disabled` stays reachable by keyboard, which is what a toolbar wants;\n * - a click on a disabled trigger runs nothing.\n *\n * After running, the caret goes back to the editor the action ran on — a\n * no-op for a pointer press under `emailKeepFocus`, the way back for a key\n * press in a toolbar. `[emailActionFocus]=\"false\"` leaves focus on the\n * control, as the ARIA toolbar pattern has it. A host's own action (a link\n * dialog, a picker) never has focus taken from what it opened.\n */\n@Directive({\n  selector: '[emailAction]',\n  exportAs: 'emailAction',\n  host: {\n    '[attr.aria-pressed]': 'ariaPressed()',\n    '[attr.aria-disabled]': 'ariaDisabled()',\n    '(click)': 'run()',\n  },\n})\nexport class ActionTrigger {\n  /** The action to trigger — `actions.get(id)`. `undefined` (no editor yet,\n      or a kit without it) is a trigger with nothing to do: disabled. */\n  readonly action = input.required<BoundAction | undefined>({ alias: 'emailAction' });\n\n  /** Whether this directive writes `aria-pressed` and `aria-disabled`. */\n  readonly aria = input(true, { alias: 'emailActionAria', transform: booleanAttribute });\n\n  /** Whether the caret returns to the editor after the action ran. */\n  readonly returnFocus = input(true, { alias: 'emailActionFocus', transform: booleanAttribute });\n\n  /** On at the selection. */\n  readonly pressed = computed(() => this.action()?.pressed() ?? false);\n\n  /** Cannot run right now — or has no action at all. */\n  readonly disabled = computed(() => this.action()?.disabled() ?? true);\n\n  protected readonly ariaPressed = computed(() =>\n    this.aria() && this.action()?.toggles ? this.pressed() : null,\n  );\n\n  protected readonly ariaDisabled = computed(() => (this.aria() && this.disabled() ? true : null));\n\n  /** Runs the action, as a click does. False when it did not apply. */\n  run(): boolean {\n    const action = this.action();\n    if (!action || this.disabled()) return false;\n    const applied = action.run();\n    // A host's own action opened something of the host's: focus is its now.\n    if (this.returnFocus() && !action.external) action.focus();\n    return applied;\n  }\n}\n","/*\n * Public API Surface of @h-k-dev/angular-email-editor/actions\n */\n\nexport * from './actions';\nexport * from './action-trigger';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}