@embedpdf/viewer-chrome 3.0.0-next.11 → 3.0.0-next.13

package/dist/index.d.cts

@@ -1,19 +1,95 @@
 import { defaultChrome } from "./chrome.cjs";
 import { defaultCommands } from "./commands.cjs";
-import { AddItemSpec, BarChild, BarGroup, BarItem, BarSchema, BarSections, ChromeHelpers, ChromeHelpers as ChromeHelpers$1, ChromeSchema, ChromeSchema as ChromeSchema$1, CustomItem, Importance, MenuSchema, MenuSection, Variant, addItem, chromeHelpers, custom, defineChrome, group, item, removeItems, replaceItem, validateChrome } from "@embedpdf/react/toolbar";
+import { AddItemSpec, BarChild, BarGroup, BarItem, BarSchema, BarSchema as BarSchema$1, BarSections, ChromeHelpers, ChromeHelpers as ChromeHelpers$1, ChromeSchema, ChromeSchema as ChromeSchema$1, CustomItem, Importance, MenuSchema, MenuSchema as MenuSchema$1, MenuSection, Variant, addItem, chromeHelpers, custom, defineChrome, group, item, removeItems, replaceItem, validateChrome } from "@embedpdf/react/toolbar";
 import { CommandDef, CommandDef as CommandDef$1, CommandsToken, ResolvedCommand, ResolvedCommand as ResolvedCommand$1 } from "@embedpdf/react/commands";
 import { ReactNode } from "react";
 import { CapabilityToken, CapabilityToken as CapabilityToken$1, DocInfo, DocumentsCapability, DocumentsCapability as DocumentsCapability$1, DocumentsToken, Engine, Engine as Engine$1, EngineFactory, EngineFactory as EngineFactory$1, InitialDocument, InitialDocument as InitialDocument$1, Kernel, Unsubscribe, Unsubscribe as Unsubscribe$1 } from "@embedpdf/react/runtime";
 import { I18nToken, TranslationDictionary } from "@embedpdf/react/i18n";
+import { Mark, SignFieldInput, SignatureMode, SignatureMode as SignatureMode$1, SignatureToken, SignerPort, SignerPort as SignerPort$1, TrustPort, TrustPort as TrustPort$1, createTestSigner, indexedDbKeyStore, memoryKeyStore, personalSigner, remoteSigner, webCryptoSigner } from "@embedpdf/react/signature";
 import { AnnotationToken } from "@embedpdf/react/annotation";
 import { StageToken } from "@embedpdf/react/stage";
 import { SearchToken } from "@embedpdf/react/search";
 import { SelectionToken } from "@embedpdf/react/selection";
 import { FormToken } from "@embedpdf/react/form";
 import { RedactionToken } from "@embedpdf/react/redaction";
+import { StampToken } from "@embedpdf/react/stamp";
 import { InteractionToken } from "@embedpdf/react/interaction";
 import { ShellToken } from "@embedpdf/react/shell";
 import { MetadataToken } from "@embedpdf/react/metadata";
+//#region src/ui/icons.d.ts
+type PathSpec = string | {
+  d: string;
+  /** Fill paint: `true` = currentColor (a filled glyph part); a slot
+   *  name = that accent color (nothing when the accent is absent). */
+  fill?: boolean | 'primary' | 'secondary';
+  /** Stroke paint: a slot name = that accent color (currentColor when
+   *  the accent is absent). */
+  stroke?: 'primary' | 'secondary';
+};
+/** A registrable icon: 24×24 stroke path data (Tabler/Lucide-style), exactly
+ *  the shape of the built-in set — user icons are not a lesser kind. */
+type IconDef = readonly PathSpec[];
+declare const ICON_PATHS: Record<string, readonly PathSpec[]>;
+//#endregion
+//#region src/config-context.d.ts
+interface StampsCustomization {
+  /** `false`: no built-in library. A string: URL template with `{locale}`. */
+  readonly defaultLibrary?: false | string;
+  /** Library kinds the stamps sidebar lists. Default `['stamps']`. */
+  readonly sidebar?: ReadonlyArray<string>;
+  /** Quick marks in the Insert toolbar: asset ids (`library:name`) from any
+   *  library, or one library's whole set. Default none. */
+  readonly toolbar?: ReadonlyArray<string> | {
+    readonly library: string;
+  };
+}
+interface SignaturesCustomization {
+  /** Which marks a person keeps. Default both. */
+  readonly kinds?: ReadonlyArray<'signature' | 'initials'>;
+  /** `'one'`: a single person per browser (no "new signature" once one exists). Default `'many'`. */
+  readonly libraries?: 'one' | 'many';
+  /** What placing a mark on a field does; default `sign` with a signer, else `visual`. */
+  readonly mode?: SignatureMode$1;
+  /** The key holder — `webCryptoSigner`, `remoteSigner`, `personalSigner`, or a thunk resolving one per signing. */
+  readonly signer?: SignerPort$1 | (() => Promise<SignerPort$1>);
+  /** Trust anchors for validation; none → verdicts top out at "valid, signer unknown". */
+  readonly trust?: TrustPort$1;
+  /** Offer a certification (first signature, DocMDP) in the sign dialog. Default false. */
+  readonly allowCertify?: boolean;
+  /** Script faces for typed marks: registered on the viewer's engine on first use. */
+  readonly fonts?: ReadonlyArray<{
+    readonly key: string;
+    readonly url: string;
+    readonly label: string;
+  }>;
+}
+/** A font for free-text annotations beyond the standard 14. */
+interface AnnotationFontSpec {
+  /** The stable id a free-text `fontFamily` carries — the engine key AND the
+   *  CSS family the live editor renders with. Not one of the 14 standard names. */
+  readonly key: string;
+  /** Where the TTF/OTF bytes come from (same-origin or CORS-enabled). */
+  readonly url: string;
+  /** The picker's label. */
+  readonly label: string;
+  /** Family / style refinements for fallback matching; inferred from the file
+   *  when omitted. */
+  readonly familyName?: string;
+  readonly weight?: number;
+  readonly italic?: boolean;
+}
+interface AnnotationsCustomization {
+  /**
+   * Fonts the free-text style panel offers beyond the standard 14. Each is
+   * fetched once when the viewer mounts, registered on the viewer's engine
+   * under its `key`, and mounted as a `@font-face` of the same name — so the
+   * DOM editor shows the face the appearance stream will bake. A font whose
+   * URL fails is skipped with a console warning. On the cloud engine (no
+   * `engine.fonts`) they are not offered: fonts there are a server policy.
+   */
+  readonly fonts?: ReadonlyArray<AnnotationFontSpec>;
+}
+//#endregion
 //#region src/handle.d.ts
 /** `get`/`tryGet` bound to one document (see {@link ViewerHandle.forDocument}). */
 interface ScopedViewerHandle {
@@ -41,21 +117,6 @@ interface ViewerHandle extends ScopedViewerHandle {
 }
 declare function createViewerHandle(kernel: Kernel): ViewerHandle;
 //#endregion
-//#region src/ui/icons.d.ts
-type PathSpec = string | {
-  d: string;
-  /** Fill paint: `true` = currentColor (a filled glyph part); a slot
-   *  name = that accent color (nothing when the accent is absent). */
-  fill?: boolean | 'primary' | 'secondary';
-  /** Stroke paint: a slot name = that accent color (currentColor when
-   *  the accent is absent). */
-  stroke?: 'primary' | 'secondary';
-};
-/** A registrable icon: 24×24 stroke path data (Tabler/Lucide-style), exactly
- *  the shape of the built-in set — user icons are not a lesser kind. */
-type IconDef = readonly PathSpec[];
-declare const ICON_PATHS: Record<string, readonly PathSpec[]>;
-//#endregion
 //#region src/ui/theme.d.ts
 type ThemeMode = 'light' | 'dark';
 type ThemePreference = ThemeMode | 'system';
@@ -80,6 +141,18 @@ interface ViewerCustomization {
   /** The structure — a value you OWN: the default (pass nothing), a transform
    *  of it, or your own schema. Never merged. */
   chrome?: ChromeSchema$1 | ((base: ChromeSchema$1, helpers: ChromeHelpers$1) => ChromeSchema$1);
+  /** The stamps sidebar's built-in library. `false`: none (air-gapped, no
+   *  request). A string: a URL template with a `{locale}` slot for a
+   *  self-hosted copy of `@embedpdf/default-stamps`. Default: the copy that
+   *  ships with the viewer, as a lazy chunk of your own build — no CDN. */
+  stamps?: StampsCustomization;
+  /** Digital signatures: the signer, trust anchors, the mode (sign / visual /
+   *  ask), which marks a person keeps, and script faces for typed marks. With
+   *  no signer, a mark placed on a field is drawn in without sealing. */
+  signatures?: SignaturesCustomization;
+  /** Annotations: fonts the free-text style panel offers beyond the standard
+   *  14 — fetched, registered on the engine and mounted for the live editor. */
+  annotations?: AnnotationsCustomization;
   /** Light/dark preference (string shorthand), or the full theme config with
    *  `--ep-*` token overrides. Tokens are applied by the DELIVERY (the custom
    *  element adopts them into its shadow root); direct consumers of this
@@ -115,7 +188,7 @@ interface FullViewerProps extends ViewerCustomization {
    *  scoped calls simply await their document. */
   onViewer?: (viewer: ViewerHandle) => void;
 }
-declare function FullViewer({ engine, initialDocuments, fallback, commands, icons, strings, locale, disabledCategories, chrome, theme, themeTarget, onViewer }: FullViewerProps): import("react/jsx-runtime").JSX.Element;
+declare function FullViewer({ engine, initialDocuments, fallback, commands, icons, strings, locale, disabledCategories, chrome, stamps, signatures, annotations, theme, themeTarget, onViewer }: FullViewerProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
-export { type AddItemSpec, AnnotationToken, type BarChild, type BarGroup, type BarItem, type BarSchema, type BarSections, type CapabilityToken, type ChromeHelpers, type ChromeSchema, type CommandDef, CommandsToken, type CustomItem, type DocInfo, type DocumentsCapability, DocumentsToken, type Engine, type EngineFactory, FormToken, FullViewer, type FullViewerProps, I18nToken, type IconDef, type Importance, type InitialDocument, InteractionToken, type MenuSchema, type MenuSection, MetadataToken, type PathSpec, RedactionToken, type ResolvedCommand, type ScopedViewerHandle, SearchToken, SelectionToken, ShellToken, StageToken, type ThemeConfig, type ThemeMode, type ThemePreference, type ThemeTokens, type Unsubscribe, type Variant, type ViewerCustomization, type ViewerHandle, addItem, chromeHelpers, createViewerHandle, custom, defaultChrome, defaultCommands, ICON_PATHS as defaultIcons, defineChrome, group, item, removeItems, replaceItem, themeConfigOf, validateChrome };
+export { type AddItemSpec, type AnnotationFontSpec, AnnotationToken, type AnnotationsCustomization, type BarChild, type BarGroup, type BarItem, type BarSchema, type BarSections, type CapabilityToken, type ChromeHelpers, type ChromeSchema, type CommandDef, CommandsToken, type CustomItem, type DocInfo, type DocumentsCapability, DocumentsToken, type Engine, type EngineFactory, FormToken, FullViewer, type FullViewerProps, I18nToken, type IconDef, type Importance, type InitialDocument, InteractionToken, type Mark, type MenuSchema, type MenuSection, MetadataToken, type PathSpec, RedactionToken, type ResolvedCommand, type ScopedViewerHandle, SearchToken, SelectionToken, ShellToken, type SignFieldInput, type SignatureMode, SignatureToken, type SignaturesCustomization, type SignerPort, StageToken, StampToken, type StampsCustomization, type ThemeConfig, type ThemeMode, type ThemePreference, type ThemeTokens, type TrustPort, type Unsubscribe, type Variant, type ViewerCustomization, type ViewerHandle, addItem, chromeHelpers, createTestSigner, createViewerHandle, custom, defaultChrome, defaultCommands, ICON_PATHS as defaultIcons, defineChrome, group, indexedDbKeyStore, item, memoryKeyStore, personalSigner, remoteSigner, removeItems, replaceItem, themeConfigOf, validateChrome, webCryptoSigner };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -6,14 +6,90 @@ import { StageToken } from "@embedpdf/react/stage";
 import { InteractionToken } from "@embedpdf/react/interaction";
 import { SelectionToken } from "@embedpdf/react/selection";
 import { AnnotationToken } from "@embedpdf/react/annotation";
+import { StampToken } from "@embedpdf/react/stamp";
 import { RedactionToken } from "@embedpdf/react/redaction";
 import { FormToken } from "@embedpdf/react/form";
+import { Mark, SignFieldInput, SignatureMode, SignatureMode as SignatureMode$1, SignatureToken, SignerPort, SignerPort as SignerPort$1, TrustPort, TrustPort as TrustPort$1, createTestSigner, indexedDbKeyStore, memoryKeyStore, personalSigner, remoteSigner, webCryptoSigner } from "@embedpdf/react/signature";
 import { SearchToken } from "@embedpdf/react/search";
 import { I18nToken, TranslationDictionary } from "@embedpdf/react/i18n";
 import { CommandDef, CommandDef as CommandDef$1, CommandsToken, ResolvedCommand, ResolvedCommand as ResolvedCommand$1 } from "@embedpdf/react/commands";
 import { ShellToken } from "@embedpdf/react/shell";
-import { AddItemSpec, BarChild, BarGroup, BarItem, BarSchema, BarSections, ChromeHelpers, ChromeHelpers as ChromeHelpers$1, ChromeSchema, ChromeSchema as ChromeSchema$1, CustomItem, Importance, MenuSchema, MenuSection, Variant, addItem, chromeHelpers, custom, defineChrome, group, item, removeItems, replaceItem, validateChrome } from "@embedpdf/react/toolbar";
+import { AddItemSpec, BarChild, BarGroup, BarItem, BarSchema, BarSchema as BarSchema$1, BarSections, ChromeHelpers, ChromeHelpers as ChromeHelpers$1, ChromeSchema, ChromeSchema as ChromeSchema$1, CustomItem, Importance, MenuSchema, MenuSchema as MenuSchema$1, MenuSection, Variant, addItem, chromeHelpers, custom, defineChrome, group, item, removeItems, replaceItem, validateChrome } from "@embedpdf/react/toolbar";
 import { MetadataToken } from "@embedpdf/react/metadata";
+//#region src/ui/icons.d.ts
+type PathSpec = string | {
+  d: string;
+  /** Fill paint: `true` = currentColor (a filled glyph part); a slot
+   *  name = that accent color (nothing when the accent is absent). */
+  fill?: boolean | 'primary' | 'secondary';
+  /** Stroke paint: a slot name = that accent color (currentColor when
+   *  the accent is absent). */
+  stroke?: 'primary' | 'secondary';
+};
+/** A registrable icon: 24×24 stroke path data (Tabler/Lucide-style), exactly
+ *  the shape of the built-in set — user icons are not a lesser kind. */
+type IconDef = readonly PathSpec[];
+declare const ICON_PATHS: Record<string, readonly PathSpec[]>;
+//#endregion
+//#region src/config-context.d.ts
+interface StampsCustomization {
+  /** `false`: no built-in library. A string: URL template with `{locale}`. */
+  readonly defaultLibrary?: false | string;
+  /** Library kinds the stamps sidebar lists. Default `['stamps']`. */
+  readonly sidebar?: ReadonlyArray<string>;
+  /** Quick marks in the Insert toolbar: asset ids (`library:name`) from any
+   *  library, or one library's whole set. Default none. */
+  readonly toolbar?: ReadonlyArray<string> | {
+    readonly library: string;
+  };
+}
+interface SignaturesCustomization {
+  /** Which marks a person keeps. Default both. */
+  readonly kinds?: ReadonlyArray<'signature' | 'initials'>;
+  /** `'one'`: a single person per browser (no "new signature" once one exists). Default `'many'`. */
+  readonly libraries?: 'one' | 'many';
+  /** What placing a mark on a field does; default `sign` with a signer, else `visual`. */
+  readonly mode?: SignatureMode$1;
+  /** The key holder — `webCryptoSigner`, `remoteSigner`, `personalSigner`, or a thunk resolving one per signing. */
+  readonly signer?: SignerPort$1 | (() => Promise<SignerPort$1>);
+  /** Trust anchors for validation; none → verdicts top out at "valid, signer unknown". */
+  readonly trust?: TrustPort$1;
+  /** Offer a certification (first signature, DocMDP) in the sign dialog. Default false. */
+  readonly allowCertify?: boolean;
+  /** Script faces for typed marks: registered on the viewer's engine on first use. */
+  readonly fonts?: ReadonlyArray<{
+    readonly key: string;
+    readonly url: string;
+    readonly label: string;
+  }>;
+}
+/** A font for free-text annotations beyond the standard 14. */
+interface AnnotationFontSpec {
+  /** The stable id a free-text `fontFamily` carries — the engine key AND the
+   *  CSS family the live editor renders with. Not one of the 14 standard names. */
+  readonly key: string;
+  /** Where the TTF/OTF bytes come from (same-origin or CORS-enabled). */
+  readonly url: string;
+  /** The picker's label. */
+  readonly label: string;
+  /** Family / style refinements for fallback matching; inferred from the file
+   *  when omitted. */
+  readonly familyName?: string;
+  readonly weight?: number;
+  readonly italic?: boolean;
+}
+interface AnnotationsCustomization {
+  /**
+   * Fonts the free-text style panel offers beyond the standard 14. Each is
+   * fetched once when the viewer mounts, registered on the viewer's engine
+   * under its `key`, and mounted as a `@font-face` of the same name — so the
+   * DOM editor shows the face the appearance stream will bake. A font whose
+   * URL fails is skipped with a console warning. On the cloud engine (no
+   * `engine.fonts`) they are not offered: fonts there are a server policy.
+   */
+  readonly fonts?: ReadonlyArray<AnnotationFontSpec>;
+}
+//#endregion
 //#region src/handle.d.ts
 /** `get`/`tryGet` bound to one document (see {@link ViewerHandle.forDocument}). */
 interface ScopedViewerHandle {
@@ -41,21 +117,6 @@ interface ViewerHandle extends ScopedViewerHandle {
 }
 declare function createViewerHandle(kernel: Kernel): ViewerHandle;
 //#endregion
-//#region src/ui/icons.d.ts
-type PathSpec = string | {
-  d: string;
-  /** Fill paint: `true` = currentColor (a filled glyph part); a slot
-   *  name = that accent color (nothing when the accent is absent). */
-  fill?: boolean | 'primary' | 'secondary';
-  /** Stroke paint: a slot name = that accent color (currentColor when
-   *  the accent is absent). */
-  stroke?: 'primary' | 'secondary';
-};
-/** A registrable icon: 24×24 stroke path data (Tabler/Lucide-style), exactly
- *  the shape of the built-in set — user icons are not a lesser kind. */
-type IconDef = readonly PathSpec[];
-declare const ICON_PATHS: Record<string, readonly PathSpec[]>;
-//#endregion
 //#region src/ui/theme.d.ts
 type ThemeMode = 'light' | 'dark';
 type ThemePreference = ThemeMode | 'system';
@@ -80,6 +141,18 @@ interface ViewerCustomization {
   /** The structure — a value you OWN: the default (pass nothing), a transform
    *  of it, or your own schema. Never merged. */
   chrome?: ChromeSchema$1 | ((base: ChromeSchema$1, helpers: ChromeHelpers$1) => ChromeSchema$1);
+  /** The stamps sidebar's built-in library. `false`: none (air-gapped, no
+   *  request). A string: a URL template with a `{locale}` slot for a
+   *  self-hosted copy of `@embedpdf/default-stamps`. Default: the copy that
+   *  ships with the viewer, as a lazy chunk of your own build — no CDN. */
+  stamps?: StampsCustomization;
+  /** Digital signatures: the signer, trust anchors, the mode (sign / visual /
+   *  ask), which marks a person keeps, and script faces for typed marks. With
+   *  no signer, a mark placed on a field is drawn in without sealing. */
+  signatures?: SignaturesCustomization;
+  /** Annotations: fonts the free-text style panel offers beyond the standard
+   *  14 — fetched, registered on the engine and mounted for the live editor. */
+  annotations?: AnnotationsCustomization;
   /** Light/dark preference (string shorthand), or the full theme config with
    *  `--ep-*` token overrides. Tokens are applied by the DELIVERY (the custom
    *  element adopts them into its shadow root); direct consumers of this
@@ -115,7 +188,7 @@ interface FullViewerProps extends ViewerCustomization {
    *  scoped calls simply await their document. */
   onViewer?: (viewer: ViewerHandle) => void;
 }
-declare function FullViewer({ engine, initialDocuments, fallback, commands, icons, strings, locale, disabledCategories, chrome, theme, themeTarget, onViewer }: FullViewerProps): import("react/jsx-runtime").JSX.Element;
+declare function FullViewer({ engine, initialDocuments, fallback, commands, icons, strings, locale, disabledCategories, chrome, stamps, signatures, annotations, theme, themeTarget, onViewer }: FullViewerProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
-export { type AddItemSpec, AnnotationToken, type BarChild, type BarGroup, type BarItem, type BarSchema, type BarSections, type CapabilityToken, type ChromeHelpers, type ChromeSchema, type CommandDef, CommandsToken, type CustomItem, type DocInfo, type DocumentsCapability, DocumentsToken, type Engine, type EngineFactory, FormToken, FullViewer, type FullViewerProps, I18nToken, type IconDef, type Importance, type InitialDocument, InteractionToken, type MenuSchema, type MenuSection, MetadataToken, type PathSpec, RedactionToken, type ResolvedCommand, type ScopedViewerHandle, SearchToken, SelectionToken, ShellToken, StageToken, type ThemeConfig, type ThemeMode, type ThemePreference, type ThemeTokens, type Unsubscribe, type Variant, type ViewerCustomization, type ViewerHandle, addItem, chromeHelpers, createViewerHandle, custom, defaultChrome, defaultCommands, ICON_PATHS as defaultIcons, defineChrome, group, item, removeItems, replaceItem, themeConfigOf, validateChrome };
+export { type AddItemSpec, type AnnotationFontSpec, AnnotationToken, type AnnotationsCustomization, type BarChild, type BarGroup, type BarItem, type BarSchema, type BarSections, type CapabilityToken, type ChromeHelpers, type ChromeSchema, type CommandDef, CommandsToken, type CustomItem, type DocInfo, type DocumentsCapability, DocumentsToken, type Engine, type EngineFactory, FormToken, FullViewer, type FullViewerProps, I18nToken, type IconDef, type Importance, type InitialDocument, InteractionToken, type Mark, type MenuSchema, type MenuSection, MetadataToken, type PathSpec, RedactionToken, type ResolvedCommand, type ScopedViewerHandle, SearchToken, SelectionToken, ShellToken, type SignFieldInput, type SignatureMode, SignatureToken, type SignaturesCustomization, type SignerPort, StageToken, StampToken, type StampsCustomization, type ThemeConfig, type ThemeMode, type ThemePreference, type ThemeTokens, type TrustPort, type Unsubscribe, type Variant, type ViewerCustomization, type ViewerHandle, addItem, chromeHelpers, createTestSigner, createViewerHandle, custom, defaultChrome, defaultCommands, ICON_PATHS as defaultIcons, defineChrome, group, indexedDbKeyStore, item, memoryKeyStore, personalSigner, remoteSigner, removeItems, replaceItem, themeConfigOf, validateChrome, webCryptoSigner };
 //# sourceMappingURL=index.d.ts.map