@embedpdf/angular 3.0.0-next.13 → 3.0.0-next.15

package/dist/fesm2022/embedpdf-angular-shell.mjs

@@ -0,0 +1,177 @@
+import { shellState, ShellToken, shellPlugin } from '@embedpdf/plugin-shell';
+export * from '@embedpdf/plugin-shell';
+import * as i0 from '@angular/core';
+import { untracked, Injectable, input, inject, Directive, booleanAttribute, ElementRef, afterRenderEffect } from '@angular/core';
+import { pluginService, CapabilityBinding, injectKernelHost, injectDocumentScope } from '@embedpdf/angular/runtime';
+import { createSurfaceFocusFollower } from '@embedpdf/web';
+
+/**
+ * The shell plugin's service, feature and directives: which panels, dialogs and menus are open.
+ * The app draws them; these bind their open state to the viewer, so a command, a button and
+ * your code open the same panel, and the layout can be stored and restored.
+ *
+ *   withShell()                           the plugin, for provideEmbedPdf()
+ *   inject(EpdfShell)                     `openSurfaces()`, `openMenus()`, `open()`, `toggle()`, …
+ *   shell.surface('comments')             one panel: `isOpen()`, `props()`, `open()`, `close()`
+ *   <button epdfPanelToggle="comments">   a button that opens and closes one
+ *   <input epdfSurfaceFocus="search">     an element that takes the cursor when its panel asks
+ *
+ * Without a document every panel reads as closed, no menu as open, and a surface's verbs do
+ * nothing, so chrome outside `*epdfDocumentGate` can use them. The service's own methods then
+ * refuse with `not-ready`, like every document plugin's.
+ */
+const NO_PROPS = Object.freeze({});
+/**
+ * The panels, dialogs and menus of this part of the template's document: `openSurfaces()` and
+ * `openMenus()` as signals, the shell's methods, `surfaceOpened$` and the other events, and
+ * `surface(id)` for one panel.
+ */
+class EpdfShell extends pluginService({
+    name: 'EpdfShell',
+    feature: 'withShell()',
+    token: ShellToken,
+    state: shellState,
+    methods: [
+        'isOpen',
+        'getSurface',
+        'listOpenSurfaces',
+        'open',
+        'close',
+        'toggle',
+        'updateSurfaceProps',
+        'closeAll',
+        'isMenuOpen',
+        'listOpenMenus',
+        'openMenu',
+        'closeMenu',
+        'toggleMenu',
+        'closeAllMenus',
+        'getSnapshot',
+        'applySnapshot',
+    ],
+    events: ['onSurfaceOpened', 'onSurfaceClosed', 'onMenuOpened', 'onMenuClosed'],
+}) {
+    /**
+     * One panel, dialog or overlay: `isOpen()` and `props()` as signals, and `open()`, `close()`
+     * and `toggle()`. Pass a function for an id that changes (a component's input). Without a
+     * document it reads as closed and its verbs do nothing.
+     *
+     *   protected readonly panel = inject(EpdfShell).surface('comments');
+     */
+    surface(id) {
+        const idOf = typeof id === 'function' ? id : () => id;
+        const shell = this.binding.capability;
+        // The verbs act on the document current when they're called, and on none without one.
+        const now = () => untracked(shell);
+        return {
+            isOpen: this.binding.select((shell) => shell.isOpen(idOf()), false, Object.is),
+            props: this.binding.select((shell) => shell.getSurface(idOf())?.props ?? NO_PROPS, NO_PROPS, Object.is),
+            open: (options) => now()?.open(untracked(idOf), options),
+            close: () => now()?.close(untracked(idOf)),
+            toggle: (options) => now()?.toggle(untracked(idOf), options),
+        };
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.2.4", ngImport: i0, type: EpdfShell, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.2.4", ngImport: i0, type: EpdfShell, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.2.4", ngImport: i0, type: EpdfShell, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+/** The shell plugin: which panels, dialogs and menus are open, per document. */
+function withShell() {
+    return { plugins: [shellPlugin()], services: [EpdfShell] };
+}
+/**
+ * A button of yours that opens and closes a panel, and says whether it's open
+ * (`aria-expanded`). `epdfPanelToggleExclusive` gives the panel its group, so opening it
+ * closes the group's other panel:
+ *
+ *   <button epdfPanelToggle="comments" epdfPanelToggleExclusive="right">Comments</button>
+ *
+ * The template reference has `isOpen()`: `#comments="epdfPanelToggle"`.
+ */
+class EpdfPanelToggle {
+    /** The panel's name. */
+    id = input.required(...(ngDevMode ? [{ debugName: "id", alias: 'epdfPanelToggle' }] : [{ alias: 'epdfPanelToggle' }]));
+    /** Its group: opening it closes the other open panel of the same group. */
+    exclusive = input(undefined, ...(ngDevMode ? [{ debugName: "exclusive", alias: 'epdfPanelToggleExclusive' }] : [{ alias: 'epdfPanelToggleExclusive' }]));
+    panel = inject(EpdfShell).surface(() => this.id());
+    /** Whether the panel is open. */
+    isOpen = this.panel.isOpen;
+    /** Open the panel when it's closed, close it when it's open. */
+    toggle() {
+        const exclusive = this.exclusive();
+        this.panel.toggle(exclusive === undefined ? undefined : { exclusive });
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.2.4", ngImport: i0, type: EpdfPanelToggle, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "20.2.4", type: EpdfPanelToggle, isStandalone: true, selector: "[epdfPanelToggle]", inputs: { id: { classPropertyName: "id", publicName: "epdfPanelToggle", isSignal: true, isRequired: true, transformFunction: null }, exclusive: { classPropertyName: "exclusive", publicName: "epdfPanelToggleExclusive", isSignal: true, isRequired: false, transformFunction: null } }, host: { listeners: { "click": "toggle()" }, properties: { "attr.aria-expanded": "isOpen()" } }, exportAs: ["epdfPanelToggle"], ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.2.4", ngImport: i0, type: EpdfPanelToggle, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[epdfPanelToggle]',
+                    exportAs: 'epdfPanelToggle',
+                    host: {
+                        '(click)': 'toggle()',
+                        '[attr.aria-expanded]': 'isOpen()',
+                    },
+                }]
+        }] });
+/**
+ * An element of yours that takes the cursor when the panel `epdfSurfaceFocus` names asks for it:
+ * on every `open(id, { focus: true })`, a command whose panel says `focus` among them, and when
+ * the element appears while the request is up (the panel opened, or its code loaded, because of
+ * it). A plain open never moves it. `epdfSurfaceFocusSelect` selects an input's text, so typing
+ * replaces it:
+ *
+ *   <input epdfSurfaceFocus="search" epdfSurfaceFocusSelect [(ngModel)]="query" />
+ *
+ * It reads the panel of this part of the template's document.
+ */
+class EpdfSurfaceFocus {
+    /** The panel's name. */
+    id = input.required(...(ngDevMode ? [{ debugName: "id", alias: 'epdfSurfaceFocus' }] : [{ alias: 'epdfSurfaceFocus' }]));
+    /** Select the text of an input or a text area as it takes focus. */
+    select = input(false, ...(ngDevMode ? [{ debugName: "select", alias: 'epdfSurfaceFocusSelect', transform: booleanAttribute }] : [{ alias: 'epdfSurfaceFocusSelect', transform: booleanAttribute }]));
+    constructor() {
+        // The service's own checks: a viewer above, with withShell() in it.
+        inject(EpdfShell);
+        const element = inject(ElementRef).nativeElement;
+        const shell = new CapabilityBinding(injectKernelHost('epdfSurfaceFocus'), () => ShellToken, injectDocumentScope());
+        const request = shell.select((current) => current.getSurface(this.id())?.focusRequest ?? 0, 0, Object.is);
+        const follower = createSurfaceFocusFollower();
+        // After rendering, so an element that has just appeared is in place to take focus.
+        afterRenderEffect({
+            write: () => {
+                const current = shell.capability();
+                const value = request();
+                const select = this.select();
+                untracked(() => follower.follow(element, current, value, { select }));
+            },
+        });
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.2.4", ngImport: i0, type: EpdfSurfaceFocus, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "20.2.4", type: EpdfSurfaceFocus, isStandalone: true, selector: "[epdfSurfaceFocus]", inputs: { id: { classPropertyName: "id", publicName: "epdfSurfaceFocus", isSignal: true, isRequired: true, transformFunction: null }, select: { classPropertyName: "select", publicName: "epdfSurfaceFocusSelect", isSignal: true, isRequired: false, transformFunction: null } }, ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.2.4", ngImport: i0, type: EpdfSurfaceFocus, decorators: [{
+            type: Directive,
+            args: [{ selector: '[epdfSurfaceFocus]' }]
+        }], ctorParameters: () => [] });
+
+/**
+ * @embedpdf/angular/shell: which panels, dialogs and menus are open.
+ *
+ *   withShell()                            the plugin, for provideEmbedPdf()
+ *   inject(EpdfShell), shell.surface(id)   the open panels and menus, as signals and calls
+ *   <button epdfPanelToggle="comments">    a button that opens and closes a panel
+ *   <input epdfSurfaceFocus="search">      an element that takes the cursor when its panel asks
+ */
+// The plugin's types and helpers, so app code has one import for the feature.
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { EpdfPanelToggle, EpdfShell, EpdfSurfaceFocus, withShell };
+//# sourceMappingURL=embedpdf-angular-shell.mjs.map

package/dist/fesm2022/embedpdf-angular-shell.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedpdf-angular-shell.mjs","sources":["../../shell/src/shell.ts","../../shell/src/public_api.ts","../../shell/src/embedpdf-angular-shell.ts"],"sourcesContent":["/**\n * The shell plugin's service, feature and directives: which panels, dialogs and menus are open.\n * The app draws them; these bind their open state to the viewer, so a command, a button and\n * your code open the same panel, and the layout can be stored and restored.\n *\n *   withShell()                           the plugin, for provideEmbedPdf()\n *   inject(EpdfShell)                     `openSurfaces()`, `openMenus()`, `open()`, `toggle()`, …\n *   shell.surface('comments')             one panel: `isOpen()`, `props()`, `open()`, `close()`\n *   <button epdfPanelToggle=\"comments\">   a button that opens and closes one\n *   <input epdfSurfaceFocus=\"search\">     an element that takes the cursor when its panel asks\n *\n * Without a document every panel reads as closed, no menu as open, and a surface's verbs do\n * nothing, so chrome outside `*epdfDocumentGate` can use them. The service's own methods then\n * refuse with `not-ready`, like every document plugin's.\n */\nimport {\n  afterRenderEffect,\n  booleanAttribute,\n  Directive,\n  ElementRef,\n  inject,\n  Injectable,\n  input,\n  untracked,\n  type Signal,\n} from '@angular/core';\nimport {\n  CapabilityBinding,\n  injectDocumentScope,\n  injectKernelHost,\n  pluginService,\n  type EmbedPdfFeature,\n} from '@embedpdf/angular/runtime';\nimport { shellPlugin, shellState, ShellToken } from '@embedpdf/plugin-shell';\nimport type { OpenSurfaceOptions, SurfaceProps } from '@embedpdf/plugin-shell';\nimport { createSurfaceFocusFollower } from '@embedpdf/web';\n\n/** One named panel, dialog or overlay of the service's document. */\nexport interface EpdfSurface {\n  /** Whether it's open; false without a document. */\n  readonly isOpen: Signal<boolean>;\n  /** The props it was opened with, or updated to; empty when it has none. */\n  readonly props: Signal<SurfaceProps>;\n  /** Open it: `exclusive` closes the others of that group, `props` travel with it. */\n  open(options?: OpenSurfaceOptions): void;\n  close(): void;\n  /** Open it when it's closed, close it when it's open. */\n  toggle(options?: OpenSurfaceOptions): void;\n}\n\nconst NO_PROPS: SurfaceProps = Object.freeze({});\n\n/**\n * The panels, dialogs and menus of this part of the template's document: `openSurfaces()` and\n * `openMenus()` as signals, the shell's methods, `surfaceOpened$` and the other events, and\n * `surface(id)` for one panel.\n */\n@Injectable({ providedIn: 'root' })\nexport class EpdfShell extends pluginService({\n  name: 'EpdfShell',\n  feature: 'withShell()',\n  token: ShellToken,\n  state: shellState,\n  methods: [\n    'isOpen',\n    'getSurface',\n    'listOpenSurfaces',\n    'open',\n    'close',\n    'toggle',\n    'updateSurfaceProps',\n    'closeAll',\n    'isMenuOpen',\n    'listOpenMenus',\n    'openMenu',\n    'closeMenu',\n    'toggleMenu',\n    'closeAllMenus',\n    'getSnapshot',\n    'applySnapshot',\n  ],\n  events: ['onSurfaceOpened', 'onSurfaceClosed', 'onMenuOpened', 'onMenuClosed'],\n}) {\n  /**\n   * One panel, dialog or overlay: `isOpen()` and `props()` as signals, and `open()`, `close()`\n   * and `toggle()`. Pass a function for an id that changes (a component's input). Without a\n   * document it reads as closed and its verbs do nothing.\n   *\n   *   protected readonly panel = inject(EpdfShell).surface('comments');\n   */\n  surface(id: string | (() => string)): EpdfSurface {\n    const idOf = typeof id === 'function' ? id : () => id;\n    const shell = this.binding.capability;\n    // The verbs act on the document current when they're called, and on none without one.\n    const now = () => untracked(shell);\n    return {\n      isOpen: this.binding.select((shell) => shell.isOpen(idOf()), false, Object.is),\n      props: this.binding.select(\n        (shell) => shell.getSurface(idOf())?.props ?? NO_PROPS,\n        NO_PROPS,\n        Object.is,\n      ),\n      open: (options) => now()?.open(untracked(idOf), options),\n      close: () => now()?.close(untracked(idOf)),\n      toggle: (options) => now()?.toggle(untracked(idOf), options),\n    };\n  }\n}\n\n/** The shell plugin: which panels, dialogs and menus are open, per document. */\nexport function withShell(): EmbedPdfFeature {\n  return { plugins: [shellPlugin()], services: [EpdfShell] };\n}\n\n/**\n * A button of yours that opens and closes a panel, and says whether it's open\n * (`aria-expanded`). `epdfPanelToggleExclusive` gives the panel its group, so opening it\n * closes the group's other panel:\n *\n *   <button epdfPanelToggle=\"comments\" epdfPanelToggleExclusive=\"right\">Comments</button>\n *\n * The template reference has `isOpen()`: `#comments=\"epdfPanelToggle\"`.\n */\n@Directive({\n  selector: '[epdfPanelToggle]',\n  exportAs: 'epdfPanelToggle',\n  host: {\n    '(click)': 'toggle()',\n    '[attr.aria-expanded]': 'isOpen()',\n  },\n})\nexport class EpdfPanelToggle {\n  /** The panel's name. */\n  readonly id = input.required<string>({ alias: 'epdfPanelToggle' });\n  /** Its group: opening it closes the other open panel of the same group. */\n  readonly exclusive = input<string | undefined>(undefined, { alias: 'epdfPanelToggleExclusive' });\n\n  private readonly panel = inject(EpdfShell).surface(() => this.id());\n\n  /** Whether the panel is open. */\n  readonly isOpen: Signal<boolean> = this.panel.isOpen;\n\n  /** Open the panel when it's closed, close it when it's open. */\n  toggle(): void {\n    const exclusive = this.exclusive();\n    this.panel.toggle(exclusive === undefined ? undefined : { exclusive });\n  }\n}\n\n/**\n * An element of yours that takes the cursor when the panel `epdfSurfaceFocus` names asks for it:\n * on every `open(id, { focus: true })`, a command whose panel says `focus` among them, and when\n * the element appears while the request is up (the panel opened, or its code loaded, because of\n * it). A plain open never moves it. `epdfSurfaceFocusSelect` selects an input's text, so typing\n * replaces it:\n *\n *   <input epdfSurfaceFocus=\"search\" epdfSurfaceFocusSelect [(ngModel)]=\"query\" />\n *\n * It reads the panel of this part of the template's document.\n */\n@Directive({ selector: '[epdfSurfaceFocus]' })\nexport class EpdfSurfaceFocus {\n  /** The panel's name. */\n  readonly id = input.required<string>({ alias: 'epdfSurfaceFocus' });\n  /** Select the text of an input or a text area as it takes focus. */\n  readonly select = input(false, { alias: 'epdfSurfaceFocusSelect', transform: booleanAttribute });\n\n  constructor() {\n    // The service's own checks: a viewer above, with withShell() in it.\n    inject(EpdfShell);\n    const element = inject<ElementRef<HTMLElement>>(ElementRef).nativeElement;\n    const shell = new CapabilityBinding(\n      injectKernelHost('epdfSurfaceFocus'),\n      () => ShellToken,\n      injectDocumentScope(),\n    );\n    const request = shell.select(\n      (current) => current.getSurface(this.id())?.focusRequest ?? 0,\n      0,\n      Object.is,\n    );\n    const follower = createSurfaceFocusFollower();\n    // After rendering, so an element that has just appeared is in place to take focus.\n    afterRenderEffect({\n      write: () => {\n        const current = shell.capability();\n        const value = request();\n        const select = this.select();\n        untracked(() => follower.follow(element, current, value, { select }));\n      },\n    });\n  }\n}\n","/**\n * @embedpdf/angular/shell: which panels, dialogs and menus are open.\n *\n *   withShell()                            the plugin, for provideEmbedPdf()\n *   inject(EpdfShell), shell.surface(id)   the open panels and menus, as signals and calls\n *   <button epdfPanelToggle=\"comments\">    a button that opens and closes a panel\n *   <input epdfSurfaceFocus=\"search\">      an element that takes the cursor when its panel asks\n */\n\n// The plugin's types and helpers, so app code has one import for the feature.\nexport * from '@embedpdf/plugin-shell';\nexport * from './shell';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public_api';\n"],"names":[],"mappings":"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"}

package/dist/fesm2022/embedpdf-angular-signature.mjs

@@ -0,0 +1,120 @@
+import { signatureState, SignatureToken, SIGNATURES_LIBRARY_KIND, signerRowsOf, signaturePlugin } from '@embedpdf/plugin-signature';
+export * from '@embedpdf/plugin-signature';
+import * as i0 from '@angular/core';
+import { computed, Injectable } from '@angular/core';
+import { pluginService, CapabilityBinding, injectDocumentScope } from '@embedpdf/angular/runtime';
+import { StampToken } from '@embedpdf/plugin-stamp/contract';
+
+/**
+ * The signature plugin's service and feature:
+ *
+ *   withSignature(config)      the plugin, for provideEmbedPdf(), with the key to sign with
+ *   inject(EpdfSignature)      sign, fill and check signature fields: `sign()`, `placeMark()`,
+ *                              `signatures()`, the events as streams (`invalidationPredicted$`),
+ *                              and the people whose marks this browser holds, `signerRows()`
+ *
+ * Signing needs the form plugin (the fields) and the stamp plugin (a person's marks):
+ * `provideEmbedPdf(config, withForm(), withStamp(), withSignature({ key }))`.
+ */
+const NO_LIBRARIES = Object.freeze([]);
+const NO_ASSETS = Object.freeze([]);
+/**
+ * Signatures: `signatures()`, `protection()`, `target()`, `busy()`, `pending()` and `status()`
+ * as signals; signing, filling and checking as methods (`sign()`, `placeMark()`,
+ * `fillField()`, `validate()`, …, the Signatures page's Methods table); the events as streams
+ * (`signed$`, `invalidationPredicted$`, `targetChanged$`, …); and the settings. Without a
+ * document, `signatures()` is empty and a method refuses with `not-ready`.
+ */
+class EpdfSignature extends pluginService({
+    name: 'EpdfSignature',
+    feature: 'withSignature()',
+    token: SignatureToken,
+    state: signatureState,
+    methods: [
+        'getSnapshot',
+        'getStatus',
+        'listSignatures',
+        'listUnsignedFields',
+        'getSignature',
+        'listVerdicts',
+        'getVerdict',
+        'getProtection',
+        'getPending',
+        'isBusy',
+        'getMode',
+        'getTarget',
+        'sign',
+        'prepareSignature',
+        'completeSignature',
+        'cancelPending',
+        'fillField',
+        'clearField',
+        'placeMark',
+        'setTarget',
+        'requestInspection',
+        'refresh',
+        'validate',
+        'validateField',
+        'analyzeChanges',
+        'readRevision',
+        'canSign',
+        'canFill',
+        'canCertify',
+        'canReadRevision',
+    ],
+    events: [
+        'onSigned',
+        'onFilled',
+        'onCleared',
+        'onValidated',
+        'onProtectionChanged',
+        'onInvalidationPredicted',
+        'onTargetChanged',
+        'onSignRequested',
+        'onInspectionRequested',
+    ],
+}) {
+    /** The stamp plugin, where a person's marks are kept; absent without `withStamp()`. */
+    stamp = new CapabilityBinding(this.binding.host, () => StampToken, injectDocumentScope());
+    libraries = this.stamp.select((stamp) => stamp.listLibraries({ kind: SIGNATURES_LIBRARY_KIND }), NO_LIBRARIES);
+    assets = this.stamp.select((stamp) => stamp.listAssets(), NO_ASSETS);
+    /**
+     * The people whose marks this browser holds, one row per stamp library of kind
+     * `signatures`, each with its signatures and its initials, for a picker. Empty without the
+     * stamp plugin. Rename, delete and export a person with the stamp plugin's library methods.
+     */
+    signerRows = computed(() => signerRowsOf(this.libraries(), this.assets()), ...(ngDevMode ? [{ debugName: "signerRows" }] : []));
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.2.4", ngImport: i0, type: EpdfSignature, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.2.4", ngImport: i0, type: EpdfSignature, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.2.4", ngImport: i0, type: EpdfSignature, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+/**
+ * The signature plugin, with its settings: the `key` to sign with (a signer, or a function that
+ * gives one when someone signs), the `mode`, the certificates you `trust`, and `allowCertify`.
+ */
+function withSignature(config) {
+    return { plugins: [signaturePlugin(config)], services: [EpdfSignature] };
+}
+
+/**
+ * @embedpdf/angular/signature: sign PDF signature fields with a mark and a key you control,
+ * check the signatures a document has, and hear before an edit breaks one.
+ *
+ *   withSignature(config)      the plugin, for provideEmbedPdf(), with the key to sign with
+ *   inject(EpdfSignature)      signing, filling and checking, as signals, methods and streams;
+ *                              `signerRows()`, the people whose marks this browser holds
+ *
+ * The signers (`webCryptoSigner`, `remoteSigner`, `personalSigner` with `indexedDbKeyStore`,
+ * `createTestSigner`) come with the plugin's exports below.
+ */
+// The plugin's types, helpers and signers, so app code has one import for the feature.
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { EpdfSignature, withSignature };
+//# sourceMappingURL=embedpdf-angular-signature.mjs.map

package/dist/fesm2022/embedpdf-angular-signature.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedpdf-angular-signature.mjs","sources":["../../signature/src/signature.ts","../../signature/src/public_api.ts","../../signature/src/embedpdf-angular-signature.ts"],"sourcesContent":["/**\n * The signature plugin's service and feature:\n *\n *   withSignature(config)      the plugin, for provideEmbedPdf(), with the key to sign with\n *   inject(EpdfSignature)      sign, fill and check signature fields: `sign()`, `placeMark()`,\n *                              `signatures()`, the events as streams (`invalidationPredicted$`),\n *                              and the people whose marks this browser holds, `signerRows()`\n *\n * Signing needs the form plugin (the fields) and the stamp plugin (a person's marks):\n * `provideEmbedPdf(config, withForm(), withStamp(), withSignature({ key }))`.\n */\nimport { computed, Injectable, type Signal } from '@angular/core';\nimport {\n  CapabilityBinding,\n  injectDocumentScope,\n  pluginService,\n  type EmbedPdfFeature,\n} from '@embedpdf/angular/runtime';\nimport {\n  signaturePlugin,\n  signatureState,\n  signerRowsOf,\n  SIGNATURES_LIBRARY_KIND,\n  SignatureToken,\n  type SignatureConfig,\n  type SignerRow,\n} from '@embedpdf/plugin-signature';\nimport {\n  StampToken,\n  type StampAsset,\n  type StampLibrary,\n} from '@embedpdf/plugin-stamp/contract';\n\nconst NO_LIBRARIES: readonly StampLibrary[] = Object.freeze([]);\nconst NO_ASSETS: readonly StampAsset[] = Object.freeze([]);\n\n/**\n * Signatures: `signatures()`, `protection()`, `target()`, `busy()`, `pending()` and `status()`\n * as signals; signing, filling and checking as methods (`sign()`, `placeMark()`,\n * `fillField()`, `validate()`, …, the Signatures page's Methods table); the events as streams\n * (`signed$`, `invalidationPredicted$`, `targetChanged$`, …); and the settings. Without a\n * document, `signatures()` is empty and a method refuses with `not-ready`.\n */\n@Injectable({ providedIn: 'root' })\nexport class EpdfSignature extends pluginService({\n  name: 'EpdfSignature',\n  feature: 'withSignature()',\n  token: SignatureToken,\n  state: signatureState,\n  methods: [\n    'getSnapshot',\n    'getStatus',\n    'listSignatures',\n    'listUnsignedFields',\n    'getSignature',\n    'listVerdicts',\n    'getVerdict',\n    'getProtection',\n    'getPending',\n    'isBusy',\n    'getMode',\n    'getTarget',\n    'sign',\n    'prepareSignature',\n    'completeSignature',\n    'cancelPending',\n    'fillField',\n    'clearField',\n    'placeMark',\n    'setTarget',\n    'requestInspection',\n    'refresh',\n    'validate',\n    'validateField',\n    'analyzeChanges',\n    'readRevision',\n    'canSign',\n    'canFill',\n    'canCertify',\n    'canReadRevision',\n  ],\n  events: [\n    'onSigned',\n    'onFilled',\n    'onCleared',\n    'onValidated',\n    'onProtectionChanged',\n    'onInvalidationPredicted',\n    'onTargetChanged',\n    'onSignRequested',\n    'onInspectionRequested',\n  ],\n}) {\n  /** The stamp plugin, where a person's marks are kept; absent without `withStamp()`. */\n  private readonly stamp = new CapabilityBinding(\n    this.binding.host,\n    () => StampToken,\n    injectDocumentScope(),\n  );\n  private readonly libraries = this.stamp.select(\n    (stamp) => stamp.listLibraries({ kind: SIGNATURES_LIBRARY_KIND }),\n    NO_LIBRARIES,\n  );\n  private readonly assets = this.stamp.select((stamp) => stamp.listAssets(), NO_ASSETS);\n\n  /**\n   * The people whose marks this browser holds, one row per stamp library of kind\n   * `signatures`, each with its signatures and its initials, for a picker. Empty without the\n   * stamp plugin. Rename, delete and export a person with the stamp plugin's library methods.\n   */\n  readonly signerRows: Signal<readonly SignerRow[]> = computed(() =>\n    signerRowsOf(this.libraries(), this.assets()),\n  );\n}\n\n/**\n * The signature plugin, with its settings: the `key` to sign with (a signer, or a function that\n * gives one when someone signs), the `mode`, the certificates you `trust`, and `allowCertify`.\n */\nexport function withSignature(config?: SignatureConfig): EmbedPdfFeature {\n  return { plugins: [signaturePlugin(config)], services: [EpdfSignature] };\n}\n","/**\n * @embedpdf/angular/signature: sign PDF signature fields with a mark and a key you control,\n * check the signatures a document has, and hear before an edit breaks one.\n *\n *   withSignature(config)      the plugin, for provideEmbedPdf(), with the key to sign with\n *   inject(EpdfSignature)      signing, filling and checking, as signals, methods and streams;\n *                              `signerRows()`, the people whose marks this browser holds\n *\n * The signers (`webCryptoSigner`, `remoteSigner`, `personalSigner` with `indexedDbKeyStore`,\n * `createTestSigner`) come with the plugin's exports below.\n */\n\n// The plugin's types, helpers and signers, so app code has one import for the feature.\nexport * from '@embedpdf/plugin-signature';\nexport { EpdfSignature, withSignature } from './signature';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public_api';\n"],"names":[],"mappings":";;;;;;;AAAA;;;;;;;;;;AAUG;AAuBH,MAAM,YAAY,GAA4B,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AAC/D,MAAM,SAAS,GAA0B,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AAE1D;;;;;;AAMG;AAEG,MAAO,aAAc,SAAQ,aAAa,CAAC;AAC/C,IAAA,IAAI,EAAE,eAAe;AACrB,IAAA,OAAO,EAAE,iBAAiB;AAC1B,IAAA,KAAK,EAAE,cAAc;AACrB,IAAA,KAAK,EAAE,cAAc;AACrB,IAAA,OAAO,EAAE;QACP,aAAa;QACb,WAAW;QACX,gBAAgB;QAChB,oBAAoB;QACpB,cAAc;QACd,cAAc;QACd,YAAY;QACZ,eAAe;QACf,YAAY;QACZ,QAAQ;QACR,SAAS;QACT,WAAW;QACX,MAAM;QACN,kBAAkB;QAClB,mBAAmB;QACnB,eAAe;QACf,WAAW;QACX,YAAY;QACZ,WAAW;QACX,WAAW;QACX,mBAAmB;QACnB,SAAS;QACT,UAAU;QACV,eAAe;QACf,gBAAgB;QAChB,cAAc;QACd,SAAS;QACT,SAAS;QACT,YAAY;QACZ,iBAAiB;AAClB,KAAA;AACD,IAAA,MAAM,EAAE;QACN,UAAU;QACV,UAAU;QACV,WAAW;QACX,aAAa;QACb,qBAAqB;QACrB,yBAAyB;QACzB,iBAAiB;QACjB,iBAAiB;QACjB,uBAAuB;AACxB,KAAA;CACF,CAAC,CAAA;;AAEiB,IAAA,KAAK,GAAG,IAAI,iBAAiB,CAC5C,IAAI,CAAC,OAAO,CAAC,IAAI,EACjB,MAAM,UAAU,EAChB,mBAAmB,EAAE,CACtB;IACgB,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAC5C,CAAC,KAAK,KAAK,KAAK,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC,EACjE,YAAY,CACb;AACgB,IAAA,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,CAAC;AAErF;;;;AAIG;AACM,IAAA,UAAU,GAAiC,QAAQ,CAAC,MAC3D,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,sDAC9C;uGApEU,aAAa,EAAA,IAAA,EAAA,IAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA;AAAb,IAAA,OAAA,KAAA,GAAA,EAAA,CAAA,qBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,aAAa,cADA,MAAM,EAAA,CAAA;;2FACnB,aAAa,EAAA,UAAA,EAAA,CAAA;kBADzB,UAAU;mBAAC,EAAE,UAAU,EAAE,MAAM,EAAE;;AAwElC;;;AAGG;AACG,SAAU,aAAa,CAAC,MAAwB,EAAA;AACpD,IAAA,OAAO,EAAE,OAAO,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,aAAa,CAAC,EAAE;AAC1E;;ACzHA;;;;;;;;;;AAUG;AAEH;;ACZA;;AAEG;;;;"}