@blackbaud/skyux-lib-addin-client 14.1.0 → 15.0.0

package/fesm2022/blackbaud-skyux-lib-addin-client.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"blackbaud-skyux-lib-addin-client.mjs","sources":["../../../projects/addin-client/src/src/addin-client-config.service.ts","../../../projects/addin-client/src/src/events/addin-event.ts","../../../projects/addin-client/src/src/events/addin-event-handler-instance.ts","../../../projects/addin-client/src/src/addin-client.service.ts","../../../projects/addin-client/src/src/help-service/addin-client-help.service.ts","../../../projects/addin-client/src/blackbaud-skyux-lib-addin-client.ts"],"sourcesContent":["import { AddinClientConfig } from \"@blackbaud/sky-addin-client\";\n\n/**\n * Implement this class with your own data to initialize the add-in client service. \n */ \nexport abstract class AddinClientConfigService {\n  /**\n   * Gets the AddinClientConfig object that will be injected the\n   * AddinClient instance when instantiated.\n   */\n  public getAddinClientConfig(): AddinClientConfig {\n    return {};\n  }\n}\n","/**\n * Contains data for an add-in event and allows you to indicate that an event\n * has been processed\n */\nexport class AddinEvent {\n\n  /**\n   * The data that an add-in event has returned.\n   */\n  public context: any;\n\n  /**\n   * A function to call indicating that the add-in event is processed.\n   * Returning any necessary data back to the host.\n   */\n  public done?: (data?: any) => void;\n}\n","import {\n  EventEmitter\n} from '@angular/core';\n\nimport {\n  AddinEvent\n} from './addin-event';\n\n/**\n * Allows you to process events from an event handler.\n */\nexport class AddinEventHandlerInstance {\n\n  /**\n   * An event that emits when a new add-in event has occurred.\n   */\n  public addinEvent: EventEmitter<AddinEvent>;\n}\n","import {\n  EventEmitter,\n  Injectable,\n  RendererFactory2,\n  inject\n} from '@angular/core';\nimport {\n  AddinClient,\n  AddinClientCloseModalArgs,\n  AddinClientEventArgs,\n  AddinClientInitArgs,\n  AddinClientNavigateArgs,\n  AddinClientOpenHelpArgs,\n  AddinClientShowConfirmArgs,\n  AddinClientShowErrorArgs,\n  AddinClientShowFlyoutArgs,\n  AddinClientShowFlyoutResult,\n  AddinClientShowModalArgs,\n  AddinClientShowModalResult,\n  AddinClientShowToastArgs,\n  AddinClientThemeSettings,\n  AddinEventCallback\n} from '@blackbaud/sky-addin-client';\nimport {\n  SkyAppConfig, SkyuxConfigAppSupportedTheme\n} from '@skyux/config';\nimport {\n  SkyTheme,\n  SkyThemeMode,\n  SkyThemeService,\n  SkyThemeSettings\n} from '@skyux/theme';\nimport {\n  AsyncSubject,\n  Observable,\n  from\n} from 'rxjs';\nimport { AddinClientConfigService } from './addin-client-config.service';\nimport {\n  AddinEvent,\n  AddinEventHandlerInstance\n} from './events';\n\n@Injectable({\n  providedIn: 'root'\n})\nexport class AddinClientService {\n  public readonly addinClient: AddinClient;\n\n  // Init args\n  private _args: AsyncSubject<AddinClientInitArgs> = new AsyncSubject<AddinClientInitArgs>();\n  public args: Observable<AddinClientInitArgs> = this._args.asObservable();\n\n  // Addin Client Events\n  /**\n   * Event emitted for box add-ins indicating that a control action button was clicked.\n   */\n  public actionClick: EventEmitter<string> = new EventEmitter(true);\n\n  /**\n   * Event emitted for button add-ins indicating that the button was clicked.\n   */\n  public buttonClick: EventEmitter<any> = new EventEmitter(true);\n\n  /**\n   * Event emitted for add-ins when context information has been updated\n   */\n  public updateContext: EventEmitter<any> = new EventEmitter();\n\n  /**\n   * Event emitted for flyout add-ins indicating that the next button was clicked.\n   */\n  public flyoutNextClick: EventEmitter<any> = new EventEmitter(true);\n\n  /**\n   * Event emitted for flyout add-ins indicating that the previous button was clicked.\n   */\n  public flyoutPreviousClick: EventEmitter<any> = new EventEmitter(true);\n\n  /**\n   * Event emitted for tile add-ins indicating that the help button was clicked.\n   * @deprecated Use tile inline help instead and handle the {@link inlineHelpClick} emitter.\n   */\n  public helpClick: EventEmitter<any> = new EventEmitter(true);\n\n  /**\n   * Event emitted indicating that the inline help button was clicked.\n   */\n  public inlineHelpClick: EventEmitter<any> = new EventEmitter(true);\n\n  /**\n   * Event emitted for tile add-ins indicating that the settings button was clicked.\n   */\n  public settingsClick: EventEmitter<any> = new EventEmitter(true);\n\n  #config = inject(SkyAppConfig, { optional: true });\n  #rendererFactory = inject(RendererFactory2);\n  #themeService = inject(SkyThemeService);\n  #addinClientConfigService = inject(AddinClientConfigService, { optional: true });\n\n  constructor() {\n    this.addinClient = new AddinClient({\n      callbacks: {\n        init: (args: AddinClientInitArgs) => {\n          this.initializeTheme(args?.themeSettings);\n\n          this._args.next(args);\n          this._args.complete();\n        },\n        actionClick: (action: string) => {\n          this.actionClick.emit(action);\n        },\n        buttonClick: () => {\n          this.buttonClick.emit();\n        },\n        flyoutNextClick: () => {\n          this.flyoutNextClick.emit();\n        },\n        flyoutPreviousClick: () => {\n          this.flyoutPreviousClick.emit();\n        },\n        helpClick: () => {\n          this.helpClick.emit();\n        },\n        inlineHelpClick: () => {\n          this.inlineHelpClick.emit();\n        },\n        settingsClick: () => {\n          this.settingsClick.emit();\n        },\n        updateContext: (context: any) => {\n          this.updateContext.emit(context);\n        },\n        themeChange: (settings: AddinClientThemeSettings) => {\n          this.setTheme(settings);\n        }\n      },\n      config: this.#addinClientConfigService?.getAddinClientConfig()\n    });\n  }\n\n  /**\n   * Informs the host to close this modal add-in.\n   * Should only be used from within the modal add-in and not the parent add-in.\n   * @param args Arguments to provide a context object back to the parent add-in.\n   */\n  public closeModal(args: AddinClientCloseModalArgs): void {\n    this.addinClient.closeModal(args);\n  }\n\n  /**\n   * Requests the host page to launch a modal add-in.\n   * @param args Arguments for launching the modal.\n   * @returns Returns an observable that will publish a value when the modal add-in is closed.\n   * Observables will publish values with context data passed from the modal add-in's closeModal call.\n   */\n  public showModal(args: AddinClientShowModalArgs): Observable<any> {\n    let modalReturn: AddinClientShowModalResult = this.addinClient.showModal(args);\n    return from(modalReturn.modalClosed);\n  }\n\n  /**\n   * Cleans up the AddinClient, releasing all resources.\n   */\n  public destroy(): void {\n    this.addinClient.destroy();\n  }\n\n  /**\n   * Requests the host page to navigate.\n   * @param args Arguments describing the navigation request.\n   */\n  public navigate(args: AddinClientNavigateArgs): void {\n    this.addinClient.navigate(args);\n  }\n\n  /**\n   * Informs the host to open the help tab with the specified help key.\n   * @param args Arguments for launching the help tab.\n   */\n  public openHelp(args: AddinClientOpenHelpArgs): void {\n    this.addinClient.openHelp(args);\n  }\n\n  /**\n   * Requests a user identity token for the current user.\n   * @returns Returns an observable which will publish the token value.\n   */\n  public getUserIdentityToken(): Observable<string> {\n    return from(this.addinClient.getUserIdentityToken());\n  }\n\n  /**\n   * @deprecated Use getUserIdentityToken\n   */\n  public getAuthToken(): Observable<string> {\n    return from(this.addinClient.getUserIdentityToken());\n  }\n\n  /**\n   * Informs the host to show a toast message.\n   * @param args Arguments for showing a toast.\n   */\n  public showToast(args: AddinClientShowToastArgs): void {\n    this.addinClient.showToast(args);\n  }\n\n  /**\n   * Requests the host page to launch a flyout add-in.\n   * @param args Arguments for launching the flyout.\n   * @returns Returns an observable that will notify when the flyout add-in is closed.\n   */\n  public showFlyout(args: AddinClientShowFlyoutArgs): Observable<void> {\n    const flyoutReturn: AddinClientShowFlyoutResult = this.addinClient.showFlyout(args);\n    return from(flyoutReturn.flyoutClosed);\n  }\n\n  /**\n   * Requests the host page to close the flyout add-in.\n   */\n  public closeFlyout(): void {\n    this.addinClient.closeFlyout();\n  }\n\n  /**\n   * Requests the host page to show a confirm dialog.\n   * @param args Arguments for showing a confirm dialog.\n   * @returns Returns an observable which will publish the confirm action value.\n   */\n  public showConfirm(args: AddinClientShowConfirmArgs): Observable<string> {\n    return from(this.addinClient.showConfirm(args));\n  }\n\n  /**\n   * Informs the host to show an error dialog.\n   * @param args Arguments for showing an error dialog.\n   */\n  public showError(args: AddinClientShowErrorArgs): void {\n    this.addinClient.showError(args);\n  }\n\n  /**\n   * Requests the host page to show a page blocking wait indicator.\n   */\n  public showWait(): void {\n    this.addinClient.showWait();\n  }\n\n  /**\n   * Requests the host page to hide a page blocking wait indicator.\n   */\n  public hideWait(): void {\n    this.addinClient.hideWait();\n  }\n\n  /**\n   * Registers an event handler for the provided event type.\n   * @param eventType The event type to register.\n   * @returns AddinEventHandlerInstance\n   */\n  public addEventHandler(eventType: string): AddinEventHandlerInstance {\n    let eventHandlerInstance = new AddinEventHandlerInstance();\n    eventHandlerInstance.addinEvent = new EventEmitter<AddinEvent>();\n\n    const eventCallback: AddinEventCallback = (context, done) => {\n      eventHandlerInstance.addinEvent.emit({\n        context,\n        done\n      });\n    };\n    this.addinClient.addEventHandler(eventType, eventCallback);\n\n    return eventHandlerInstance;\n  }\n\n  /**\n   * Sends an event to be handled by the host page.\n   * @param args The event arguments to be sent to the host page.\n   * @returns Returns an observable which will complete when the add-in host page receives the\n   * message. The request will fail if a subsequent event occurs, for the same event type, within\n   * 200 milliseconds. A failure can also occur if an event type is not one of the supported types\n   * from the host page.\n   * @see AddinClientInitArgs#supportedEventTypes\n   */\n  public sendEvent(args: AddinClientEventArgs): Observable<void> {\n    return from(this.addinClient.sendEvent(args));\n  }\n\n  private initializeTheme(themeSettings: AddinClientThemeSettings): void {\n    if (!themeSettings) {\n      return;\n    }\n\n    const hostThemeSettings = AddinClientService.toSkyThemeSettings(themeSettings);\n\n    if (!this.#config) {\n      // no app config, initialize host theme\n      this.initializeTheme_(hostThemeSettings);\n      return;\n    }\n\n    const themingConfig = this.#config.skyux.app?.theming;\n\n    if (\n      themingConfig?.supportedThemes &&\n      themingConfig.supportedThemes.indexOf(themeSettings.theme as SkyuxConfigAppSupportedTheme) !== -1\n    ) {\n      // app supports host theme, initialize host theme\n      this.initializeTheme_(hostThemeSettings);\n      return;\n    }\n\n    // app does not support host theme, do nothing to initialize the app's default theme\n  }\n\n  private initializeTheme_(themeSettings: SkyThemeSettings): void {\n    this.#themeService.init(\n      document.body,\n      this.#rendererFactory.createRenderer(undefined, undefined),\n      themeSettings\n    );\n  }\n\n  private setTheme(settings: AddinClientThemeSettings): void {\n    if (!settings) {\n      return;\n    }\n\n    const hostThemeSettings = AddinClientService.toSkyThemeSettings(settings);\n\n    this.#themeService.setTheme(hostThemeSettings);\n  }\n\n  private static toSkyThemeSettings(settings: AddinClientThemeSettings): SkyThemeSettings {\n    if (settings.skyThemeSettings) {\n      // If the settings contain a serialized SkyThemeSettings object, deserialize it.\n      return SkyThemeSettings.deserialize(settings.skyThemeSettings);\n    }\n\n    return new SkyThemeSettings(\n      AddinClientService.toSkyTheme(settings.theme),\n      AddinClientService.toSkyThemeMode(settings.mode)\n    );\n  }\n\n  private static toSkyTheme(theme: string): SkyTheme {\n    switch (theme) {\n      case 'modern':\n        return SkyTheme.presets.modern;\n      default:\n        return SkyTheme.presets.default;\n    }\n  }\n\n  private static toSkyThemeMode(mode: string): SkyThemeMode {\n    switch (mode) {\n      case 'dark':\n        return SkyThemeMode.presets.dark;\n      default:\n        return SkyThemeMode.presets.light;\n    }\n  }\n}\n","import { inject, Injectable, Provider } from '@angular/core';\nimport { SkyHelpOpenArgs, SkyHelpService } from '@skyux/core';\nimport { AddinClientService } from '../addin-client.service';\n\n@Injectable({ providedIn: 'root' })\nexport class AddinClientHelpService extends SkyHelpService {\n  private skyAddinClientService = inject(AddinClientService);\n\n  /** @inheritdoc */\n  public override openHelp(args?: SkyHelpOpenArgs): void {\n    if (!args) {\n      return;\n    }\n\n    this.skyAddinClientService.openHelp(args);\n  }\n\n  /** @inheritdoc */\n  public override updateHelp(): void {\n    throw new Error('Not implemented');\n  }\n}\n\n/** Provide addin client help service */\nexport function provideAddinClientHelp(): Provider[] {\n  return [{ provide: SkyHelpService, useClass: AddinClientHelpService }];\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"blackbaud-skyux-lib-addin-client.mjs","names":[],"sources":["../../../projects/addin-client/src/src/addin-client-config.service.ts","../../../projects/addin-client/src/src/events/addin-event.ts","../../../projects/addin-client/src/src/events/addin-event-handler-instance.ts","../../../projects/addin-client/src/src/hosted-surface-resolver.ts","../../../projects/addin-client/src/src/hosted-surface-style-controller.ts","../../../projects/addin-client/src/src/addin-client.service.ts","../../../projects/addin-client/src/src/help-service/addin-client-help.service.ts"],"sourcesContent":["import {\n  AddinClientConfig,\n  AddinClientReadyArgs,\n  AddinType\n} from \"@blackbaud/sky-addin-client\";\n\n/**\n * How the add-in client styles the add-in document for its hosted surface.\n * - `'automatic'`: adapts the document background to the hosted surface.\n * - `'preserve'`: leaves the add-in's own background styling unchanged.\n * - `'container'`: uses the SKY UX container background, whatever the hosted surface.\n */\nexport type AddinClientHostedSurfaceMode = 'automatic' | 'preserve' | 'container';\n\n/**\n * What the add-in client knows about the hosted surface when it asks for the\n * hosted surface mode.\n */\nexport interface AddinClientHostedSurfaceContext {\n  /**\n   * The add-in type the host reported, or `undefined` when the host doesn't report one\n   * or reports a type this client doesn't recognize.\n   */\n  readonly addinType: AddinType | undefined;\n\n  /**\n   * The arguments the add-in passed to `ready()`.\n   */\n  readonly readyArgs: AddinClientReadyArgs;\n}\n\n/**\n * Implement this class with your own data to initialize the add-in client service.\n */\nexport abstract class AddinClientConfigService {\n  /**\n   * Gets the AddinClientConfig object that will be injected the\n   * AddinClient instance when instantiated.\n   */\n  public getAddinClientConfig(): AddinClientConfig {\n    return {};\n  }\n\n  /**\n   * Gets how the add-in client styles the add-in document for its hosted surface. The\n   * client asks on every `ready()` call, so an add-in can choose per add-in type, per\n   * route, or per `ready()` call. Return `'preserve'` to keep the add-in's own background\n   * styling, or `'container'` to use the SKY UX container background.\n   * @param context The hosted surface the add-in is being made ready for.\n   */\n  public getHostedSurfaceMode(\n    context: AddinClientHostedSurfaceContext\n  ): AddinClientHostedSurfaceMode {\n    return 'automatic';\n  }\n}\n","/**\n * Contains data for an add-in event and allows you to indicate that an event\n * has been processed\n */\nexport class AddinEvent {\n\n  /**\n   * The data that an add-in event has returned.\n   */\n  public context: any;\n\n  /**\n   * A function to call indicating that the add-in event is processed.\n   * Returning any necessary data back to the host.\n   */\n  public done?: (data?: any) => void;\n}\n","import {\n  EventEmitter\n} from '@angular/core';\n\nimport {\n  AddinEvent\n} from './addin-event';\n\n/**\n * Allows you to process events from an event handler.\n */\nexport class AddinEventHandlerInstance {\n\n  /**\n   * An event that emits when a new add-in event has occurred.\n   */\n  public addinEvent = new EventEmitter<AddinEvent>();\n}\n","import {\n  AddinClientReadyArgs,\n  AddinModalStyle,\n  AddinType,\n} from '@blackbaud/sky-addin-client';\n\nimport { AddinClientHostedSurfaceMode } from './addin-client-config.service';\n\nexport type HostedSurfaceTreatment =\n  'container' | 'full-page' | 'modal' | 'preserve';\n\nexport type HostedSurfaceBackdrop = 'normal' | 'preserve' | 'transparent';\n\nexport interface HostedSurfaceModalState {\n  readonly fullPageModalOpen: boolean;\n  readonly modalDepth: number;\n  readonly modalOpen: boolean;\n}\n\nexport interface HostedSurfaceResolverInput {\n  /**\n   * The add-in type reported by the host. The vanilla client passes `undefined` both for\n   * an older host that omits the type and for a type it doesn't recognize, so either host\n   * is resolved as an older host.\n   */\n  readonly addinType: AddinType | undefined;\n  readonly modalState: HostedSurfaceModalState;\n  /**\n   * The mode the add-in requested. `'preserve'` and `'container'` replace the resolved\n   * treatment; `'automatic'` or `undefined` resolves one.\n   */\n  readonly mode?: AddinClientHostedSurfaceMode;\n  readonly readyArgs: AddinClientReadyArgs;\n}\n\nexport interface HostedSurfaceResolution {\n  readonly backdrop: HostedSurfaceBackdrop;\n  /**\n   * Modal style to send to the vanilla client's `ready()`. Set only when the treatment\n   * can't change after `ready()`: the vanilla client applies it as inline `!important`\n   * declarations that the controller can't undo when live modal state changes.\n   */\n  readonly inferredModalStyle?: AddinModalStyle;\n  /**\n   * Whether the controller may override a historical consumer's `display:none` backdrop\n   * styling. This is a distinct policy axis from `backdrop` (which governs color/opacity):\n   * automatic modal treatment is currently the only path that owns display, but display\n   * ownership and backdrop color ownership are independent and may diverge for future\n   * treatments.\n   */\n  readonly restoreBackdropDisplay: boolean;\n  readonly treatment: HostedSurfaceTreatment;\n}\n\n/**\n * Modal depth at which a legacy/older host's backdrop is treated as opaque (\"normal\")\n * rather than transparent, since a nested modal stacked atop another modal already has\n * an intervening backdrop providing contrast.\n */\nconst NESTED_MODAL_BACKDROP_DEPTH = 2;\n\nfunction resolveModalBackdrop(\n  modalDepth: number,\n  forceNormal: boolean,\n): HostedSurfaceBackdrop {\n  return forceNormal || modalDepth >= NESTED_MODAL_BACKDROP_DEPTH\n    ? 'normal'\n    : 'transparent';\n}\n\n/**\n * Canonical treatment for every `AddinType`, whether a compatible host reports it or it is\n * inferred from `ready()`. `'modal'` is resolved separately because it also depends on\n * `fullPage`, modal depth, and whether the host reports types. Declaring this as\n * `Readonly<Record<AddinType, ...>>` forces any future `AddinType` addition to be given an\n * explicit mapping at compile time.\n *\n * SKY UX boxes, tiles, and flyouts give their content the container background, so add-ins\n * in them get it too. SKY UX tabs don't, so tab content shows whatever is behind the tabset,\n * usually the page, and a tab add-in keeps its own page background. A host reports `generic`\n * for an add-in it embeds without a more specific type, typically as part of a page, so a\n * generic add-in keeps its own background too.\n */\nconst CANONICAL_ADDIN_TYPE_TREATMENT: Readonly<\n  Record<AddinType, HostedSurfaceTreatment>\n> = {\n  'action-button': 'preserve',\n  box: 'container',\n  button: 'preserve',\n  dataset: 'preserve',\n  flyout: 'container',\n  generic: 'preserve',\n  modal: 'modal',\n  page: 'preserve',\n  tab: 'preserve',\n  tile: 'container',\n  'vertical-tab-form': 'container',\n};\n\n/**\n * The `ready()` configuration fields that identify an add-in type when the host does not\n * report one, in precedence order. An inferred type is resolved exactly like a reported\n * one, so the two paths cannot drift apart.\n */\nconst READY_ARGS_ADDIN_TYPES: ReadonlyArray<\n  readonly [keyof AddinClientReadyArgs, AddinType]\n> = [\n  ['modalConfig', 'modal'],\n  ['boxConfig', 'box'],\n  ['tabConfig', 'tab'],\n  ['tileConfig', 'tile'],\n  ['buttonConfig', 'button'],\n  ['actionButtonConfig', 'action-button'],\n];\n\n/**\n * The resolution for an add-in that neither the host nor `ready()` identifies. Only an\n * older host leaves an add-in unidentified, and the tiles and flyouts such a host can't\n * identify need the container background.\n */\nconst UNIDENTIFIED_RESOLUTION: HostedSurfaceResolution = {\n  backdrop: 'preserve',\n  restoreBackdropDisplay: false,\n  treatment: 'container',\n};\n\nconst FULL_PAGE_RESOLUTION: HostedSurfaceResolution = {\n  backdrop: 'preserve',\n  restoreBackdropDisplay: false,\n  treatment: 'full-page',\n};\n\nfunction inferAddinType(\n  readyArgs: AddinClientReadyArgs,\n): AddinType | undefined {\n  return READY_ARGS_ADDIN_TYPES.find(\n    ([field]) => readyArgs[field] !== undefined,\n  )?.[1];\n}\n\n/**\n * Resolves the treatment for an add-in type, whether the host reported it or it was\n * inferred from `ready()`. Only modal treatment depends on whether the host reports types,\n * because only such a host honors `hostOverlay`.\n */\nfunction resolveAddinType(\n  addinType: AddinType,\n  readyArgs: AddinClientReadyArgs,\n  modalDepth: number,\n  hostReportsType: boolean,\n): HostedSurfaceResolution {\n  if (addinType === 'modal') {\n    return readyArgs.modalConfig?.fullPage === true\n      ? FULL_PAGE_RESOLUTION\n      : modalResolution(hostReportsType, modalDepth);\n  }\n\n  return {\n    backdrop: 'preserve',\n    restoreBackdropDisplay: false,\n    treatment: CANONICAL_ADDIN_TYPE_TREATMENT[addinType],\n  };\n}\n\nfunction modalResolution(\n  compatibleHost: boolean,\n  modalDepth: number,\n): HostedSurfaceResolution {\n  return {\n    backdrop: resolveModalBackdrop(modalDepth, compatibleHost),\n    inferredModalStyle: compatibleHost\n      ? {\n          hostOverlay: false,\n          transparentBackground: true,\n        }\n      : { transparentBackground: true },\n    restoreBackdropDisplay: true,\n    treatment: 'modal',\n  };\n}\n\nexport function resolveHostedSurface(\n  input: HostedSurfaceResolverInput,\n): HostedSurfaceResolution {\n  const { addinType, modalState, mode, readyArgs } = input;\n\n  // A requested treatment replaces every resolved one, including the older-host fallback\n  // for an explicit modal style.\n  if (mode === 'preserve' || mode === 'container') {\n    return {\n      backdrop: 'preserve',\n      restoreBackdropDisplay: false,\n      treatment: mode,\n    };\n  }\n\n  const style = readyArgs.modalConfig?.style;\n\n  if (style !== undefined) {\n    const explicitOlderHostFallback =\n      addinType === undefined &&\n      style.hostOverlay === false &&\n      style.transparentBackground === true;\n\n    return {\n      backdrop: explicitOlderHostFallback\n        ? resolveModalBackdrop(modalState.modalDepth, false)\n        : 'preserve',\n      restoreBackdropDisplay: false,\n      treatment: 'preserve',\n    };\n  }\n\n  if (addinType !== undefined) {\n    return resolveAddinType(addinType, readyArgs, modalState.modalDepth, true);\n  }\n\n  const inferredAddinType = inferAddinType(readyArgs);\n\n  if (inferredAddinType !== undefined) {\n    return resolveAddinType(\n      inferredAddinType,\n      readyArgs,\n      modalState.modalDepth,\n      false,\n    );\n  }\n\n  if (modalState.fullPageModalOpen) {\n    return FULL_PAGE_RESOLUTION;\n  }\n\n  if (modalState.modalOpen) {\n    // Live modal markers can change after ready(), so the controller alone owns this\n    // treatment and the vanilla client receives no style.\n    return {\n      backdrop: resolveModalBackdrop(modalState.modalDepth, false),\n      restoreBackdropDisplay: true,\n      treatment: 'modal',\n    };\n  }\n\n  return UNIDENTIFIED_RESOLUTION;\n}\n\nexport function withInferredModalStyle(\n  readyArgs: AddinClientReadyArgs,\n  style: AddinModalStyle | undefined,\n): AddinClientReadyArgs {\n  if (style === undefined) {\n    return readyArgs;\n  }\n\n  return {\n    ...readyArgs,\n    modalConfig: {\n      ...readyArgs.modalConfig,\n      style,\n    },\n  };\n}\n","import { AddinClientReadyArgs, AddinType } from '@blackbaud/sky-addin-client';\nimport { AddinClientHostedSurfaceMode } from './addin-client-config.service';\nimport {\n  HostedSurfaceResolution,\n  resolveHostedSurface,\n} from './hosted-surface-resolver';\n\nexport const HOSTED_SURFACE_CLASSES = {\n  container: 'bb-skyux-addin-client-container-background',\n  restoreBackdrop: 'bb-skyux-addin-client-modal-backdrop-rendered',\n  transparent: 'bb-skyux-addin-client-modal-background-transparent',\n  transparentBackdrop: 'bb-skyux-addin-client-modal-backdrop-transparent',\n} as const;\n\n/**\n * Marks the style element owned by a controller. An attribute rather than an ID, so it\n * doesn't need to be unique in the document.\n */\nexport const HOSTED_SURFACE_STYLE_ATTRIBUTE =\n  'data-bb-skyux-addin-client-hosted-surface';\n\n/**\n * Body classes that feed `resolveHostedSurface`'s live modal state. A mutation observer\n * refresh is only warranted when one of these markers' presence actually changes; every\n * other body class (including the controller's own {@link HOSTED_SURFACE_CLASSES}) is\n * irrelevant to resolution and must not trigger a refresh.\n */\nconst MODAL_MARKER_CLASSES = [\n  'sky-modal-body-open',\n  'sky-modal-body-full-page',\n] as const;\n\n// SKY UX styles the body as a page; container add-ins use SKY UX's container color for\n// the theme and mode on the body instead. SKY UX defines the documented theme token once\n// a theme is set up, and the root-level variable covers a body without a theme.\nconst STYLE_TEXT = `\nbody.${HOSTED_SURFACE_CLASSES.container} {\n  background-color: var(\n    --sky-theme-color-background-container-default,\n    var(--sky-background-color-container-default)\n  ) !important;\n}\n\nbody.${HOSTED_SURFACE_CLASSES.transparent} {\n  background-color: transparent !important;\n}\n\nbody.${HOSTED_SURFACE_CLASSES.restoreBackdrop}\n  .sky-modal-host-backdrop:not([hidden]) {\n  display: block !important;\n}\n\nbody.${HOSTED_SURFACE_CLASSES.transparentBackdrop}\n  .sky-modal-host-backdrop {\n  --sky-override-modal-host-backdrop-color: transparent;\n}\n`;\n\ninterface ControllerInput {\n  readonly addinType: AddinType | undefined;\n  readonly mode: AddinClientHostedSurfaceMode;\n  readonly readyArgs: AddinClientReadyArgs;\n}\n\nexport class HostedSurfaceStyleController {\n  readonly #document: Document;\n  readonly #nonce: string | null;\n  readonly #ownedClasses = new Set<string>();\n\n  #input: ControllerInput | undefined;\n  #observer: MutationObserver | undefined;\n  #styleElement: HTMLStyleElement | undefined;\n\n  /**\n   * @param documentRef The add-in document.\n   * @param nonce The Content Security Policy nonce for the injected style element, as\n   * provided to Angular through `CSP_NONCE` or the `ngCspNonce` attribute.\n   */\n  constructor(documentRef: Document, nonce: string | null = null) {\n    this.#document = documentRef;\n    this.#nonce = nonce;\n  }\n\n  public update(\n    addinType: AddinType | undefined,\n    readyArgs: AddinClientReadyArgs,\n    mode: AddinClientHostedSurfaceMode = 'automatic',\n  ): HostedSurfaceResolution {\n    const input: ControllerInput = { addinType, mode, readyArgs };\n\n    this.#input = input;\n    this.#observe();\n\n    return this.#applyResolution(input);\n  }\n\n  public refresh(): void {\n    if (this.#input !== undefined) {\n      this.#applyResolution(this.#input);\n    }\n  }\n\n  public destroy(): void {\n    this.#observer?.disconnect();\n    this.#observer = undefined;\n    this.#input = undefined;\n\n    for (const className of this.#ownedClasses) {\n      this.#document.body.classList.remove(className);\n    }\n\n    this.#ownedClasses.clear();\n    this.#styleElement?.remove();\n    this.#styleElement = undefined;\n  }\n\n  #applyResolution(input: ControllerInput): HostedSurfaceResolution {\n    const resolution = resolveHostedSurface({\n      ...input,\n      modalState: {\n        fullPageModalOpen: this.#document.body.classList.contains(\n          'sky-modal-body-full-page',\n        ),\n        modalDepth: this.#document.body.querySelectorAll('sky-modal').length,\n        modalOpen: this.#document.body.classList.contains(\n          'sky-modal-body-open',\n        ),\n      },\n    });\n\n    this.#setClass(\n      HOSTED_SURFACE_CLASSES.container,\n      resolution.treatment === 'container',\n    );\n    this.#setClass(\n      HOSTED_SURFACE_CLASSES.transparent,\n      resolution.treatment === 'modal',\n    );\n    this.#setClass(\n      HOSTED_SURFACE_CLASSES.restoreBackdrop,\n      resolution.restoreBackdropDisplay,\n    );\n    this.#setClass(\n      HOSTED_SURFACE_CLASSES.transparentBackdrop,\n      resolution.backdrop === 'transparent',\n    );\n\n    const needsStyle =\n      resolution.treatment === 'container' ||\n      resolution.treatment === 'modal' ||\n      resolution.restoreBackdropDisplay ||\n      resolution.backdrop === 'transparent';\n\n    if (needsStyle) {\n      this.#ensureStyle();\n    } else {\n      this.#styleElement?.remove();\n      this.#styleElement = undefined;\n    }\n\n    return resolution;\n  }\n\n  #ensureStyle(): void {\n    if (this.#styleElement?.parentNode) {\n      return;\n    }\n\n    const style = this.#document.createElement('style');\n    style.setAttribute(HOSTED_SURFACE_STYLE_ATTRIBUTE, '');\n\n    if (this.#nonce) {\n      style.setAttribute('nonce', this.#nonce);\n    }\n\n    style.textContent = STYLE_TEXT;\n    this.#document.head.appendChild(style);\n    this.#styleElement = style;\n  }\n\n  #observe(): void {\n    if (this.#observer !== undefined) {\n      return;\n    }\n\n    this.#observer = new MutationObserver((records) =>\n      this.#handleMutations(records),\n    );\n    this.#observer.observe(this.#document.body, {\n      attributeFilter: ['class'],\n      attributeOldValue: true,\n      attributes: true,\n      childList: true,\n      subtree: true,\n    });\n  }\n\n  #handleMutations(records: MutationRecord[]): void {\n    for (const record of records) {\n      if (this.#isRelevantMutation(record)) {\n        this.refresh();\n        return;\n      }\n    }\n  }\n\n  /**\n   * Only two mutation shapes can change what `resolveHostedSurface` computes:\n   * - the body's own `class` attribute gaining or losing a {@link MODAL_MARKER_CLASSES}\n   *   marker (checked against `oldValue`, so the controller's own class writes and\n   *   unrelated consumer classes are both ignored); and\n   * - a `childList` change whose added/removed node is a `sky-modal` element or contains\n   *   one anywhere in its subtree (nested modals affect `modalDepth`).\n   * Attribute mutations on descendants (subtree class changes) and childList changes\n   * that touch unrelated DOM are deliberately excluded.\n   */\n  #isRelevantMutation(record: MutationRecord): boolean {\n    if (record.type === 'attributes') {\n      return (\n        record.target === this.#document.body &&\n        this.#modalMarkerPresenceChanged(record.oldValue)\n      );\n    }\n\n    // The observer only watches attributes and child lists, so this is a childList record.\n    return (\n      this.#containsModalNode(record.addedNodes) ||\n      this.#containsModalNode(record.removedNodes)\n    );\n  }\n\n  #modalMarkerPresenceChanged(oldValue: string | null): boolean {\n    const previousClasses = new Set(\n      (oldValue ?? '').split(/\\s+/).filter((value) => value.length > 0),\n    );\n    const currentClasses = this.#document.body.classList;\n\n    return MODAL_MARKER_CLASSES.some(\n      (marker) => previousClasses.has(marker) !== currentClasses.contains(marker),\n    );\n  }\n\n  #containsModalNode(nodes: NodeList): boolean {\n    for (let index = 0; index < nodes.length; index++) {\n      const node = nodes[index];\n\n      if (node.nodeType !== Node.ELEMENT_NODE) {\n        continue;\n      }\n\n      const element = node as Element;\n\n      if (element.localName === 'sky-modal' || element.querySelector('sky-modal')) {\n        return true;\n      }\n    }\n\n    return false;\n  }\n\n  #setClass(className: string, enabled: boolean): void {\n    if (enabled) {\n      if (!this.#document.body.classList.contains(className)) {\n        this.#document.body.classList.add(className);\n        this.#ownedClasses.add(className);\n      }\n\n      return;\n    }\n\n    if (this.#ownedClasses.delete(className)) {\n      this.#document.body.classList.remove(className);\n    }\n  }\n}\n","import { DOCUMENT } from '@angular/common';\nimport {\n  CSP_NONCE,\n  EventEmitter,\n  Injectable,\n  RendererFactory2,\n  inject\n} from '@angular/core';\nimport {\n  AddinClient,\n  AddinClientCloseModalArgs,\n  AddinClientEventArgs,\n  AddinClientInitArgs,\n  AddinClientNavigateArgs,\n  AddinClientOpenHelpArgs,\n  AddinClientReadyArgs,\n  AddinClientShowConfirmArgs,\n  AddinClientShowErrorArgs,\n  AddinClientShowFlyoutArgs,\n  AddinClientShowFlyoutResult,\n  AddinClientShowModalArgs,\n  AddinClientShowModalResult,\n  AddinClientShowToastArgs,\n  AddinClientThemeSettings,\n  AddinEventCallback\n} from '@blackbaud/sky-addin-client';\nimport {\n  SkyAppConfig, SkyuxConfigAppSupportedTheme\n} from '@skyux/config';\nimport {\n  SkyTheme,\n  SkyThemeMode,\n  SkyThemeService,\n  SkyThemeSettings\n} from '@skyux/theme';\nimport {\n  AsyncSubject,\n  Observable,\n  from\n} from 'rxjs';\nimport {\n  AddinClientConfigService,\n  AddinClientHostedSurfaceContext,\n  AddinClientHostedSurfaceMode\n} from './addin-client-config.service';\nimport {\n  AddinEventHandlerInstance\n} from './events';\nimport { HostedSurfaceStyleController } from './hosted-surface-style-controller';\nimport { withInferredModalStyle } from './hosted-surface-resolver';\n\n@Injectable({\n  providedIn: 'root'\n})\nexport class AddinClientService {\n  public readonly addinClient: AddinClient;\n\n  // Init args\n  private _args: AsyncSubject<AddinClientInitArgs> = new AsyncSubject<AddinClientInitArgs>();\n  public args: Observable<AddinClientInitArgs> = this._args.asObservable();\n\n  // Addin Client Events\n  /**\n   * Event emitted for box add-ins indicating that a control action button was clicked.\n   */\n  public actionClick: EventEmitter<string> = new EventEmitter(true);\n\n  /**\n   * Event emitted for button add-ins indicating that the button was clicked.\n   */\n  public buttonClick: EventEmitter<any> = new EventEmitter(true);\n\n  /**\n   * Event emitted for add-ins when context information has been updated\n   */\n  public updateContext: EventEmitter<any> = new EventEmitter();\n\n  /**\n   * Event emitted for flyout add-ins indicating that the next button was clicked.\n   */\n  public flyoutNextClick: EventEmitter<any> = new EventEmitter(true);\n\n  /**\n   * Event emitted for flyout add-ins indicating that the previous button was clicked.\n   */\n  public flyoutPreviousClick: EventEmitter<any> = new EventEmitter(true);\n\n  /**\n   * Event emitted for tile add-ins indicating that the help button was clicked.\n   * @deprecated Use tile inline help instead and handle the {@link inlineHelpClick} emitter.\n   */\n  public helpClick: EventEmitter<any> = new EventEmitter(true);\n\n  /**\n   * Event emitted indicating that the inline help button was clicked.\n   */\n  public inlineHelpClick: EventEmitter<any> = new EventEmitter(true);\n\n  /**\n   * Event emitted for tile add-ins indicating that the settings button was clicked.\n   */\n  public settingsClick: EventEmitter<any> = new EventEmitter(true);\n\n  #config = inject(SkyAppConfig, { optional: true });\n  #document = inject(DOCUMENT);\n  #rendererFactory = inject(RendererFactory2);\n  #themeService = inject(SkyThemeService);\n  #addinClientConfigService = inject(AddinClientConfigService, { optional: true });\n\n  private destroyed = false;\n  private readonly hostedSurfaceController =\n    new HostedSurfaceStyleController(\n      this.#document,\n      inject(CSP_NONCE, { optional: true })\n    );\n\n  constructor() {\n    this.addinClient = new AddinClient({\n      callbacks: {\n        init: (args: AddinClientInitArgs) => {\n          const preparedArgs = this.prepareInitArgs(args);\n\n          this.initializeTheme(preparedArgs.themeSettings);\n          this._args.next(preparedArgs);\n          this._args.complete();\n        },\n        actionClick: (action: string) => {\n          this.actionClick.emit(action);\n        },\n        buttonClick: () => {\n          this.buttonClick.emit();\n        },\n        flyoutNextClick: () => {\n          this.flyoutNextClick.emit();\n        },\n        flyoutPreviousClick: () => {\n          this.flyoutPreviousClick.emit();\n        },\n        helpClick: () => {\n          this.helpClick.emit();\n        },\n        inlineHelpClick: () => {\n          this.inlineHelpClick.emit();\n        },\n        settingsClick: () => {\n          this.settingsClick.emit();\n        },\n        updateContext: (context: any) => {\n          this.updateContext.emit(context);\n        },\n        themeChange: (settings: AddinClientThemeSettings) => {\n          this.setTheme(settings);\n        }\n      },\n      config: this.#addinClientConfigService?.getAddinClientConfig()\n    });\n  }\n\n  /**\n   * Informs the host to close this modal add-in.\n   * Should only be used from within the modal add-in and not the parent add-in.\n   * @param args Arguments to provide a context object back to the parent add-in.\n   */\n  public closeModal(args: AddinClientCloseModalArgs): void {\n    this.addinClient.closeModal(args);\n  }\n\n  /**\n   * Requests the host page to launch a modal add-in.\n   * @param args Arguments for launching the modal.\n   * @returns Returns an observable that will publish a value when the modal add-in is closed.\n   * Observables will publish values with context data passed from the modal add-in's closeModal call.\n   */\n  public showModal(args: AddinClientShowModalArgs): Observable<any> {\n    let modalReturn: AddinClientShowModalResult = this.addinClient.showModal(args);\n    return from(modalReturn.modalClosed);\n  }\n\n  /**\n   * Cleans up the AddinClient, releasing all resources.\n   */\n  public destroy(): void {\n    if (this.destroyed) {\n      return;\n    }\n\n    this.destroyed = true;\n    this.hostedSurfaceController.destroy();\n    this.addinClient.destroy();\n  }\n\n  private prepareInitArgs(args: AddinClientInitArgs): AddinClientInitArgs {\n    const ready = args.ready;\n\n    args.ready = (readyArgs: AddinClientReadyArgs) => {\n      // Pass ready() through untouched when the body doesn't exist yet, so addin-ready\n      // is still posted.\n      if (this.destroyed || !this.#document.body) {\n        ready(readyArgs);\n        return;\n      }\n\n      // Keep application-owned args as the source for later DOM-driven inference.\n      const resolution = this.hostedSurfaceController.update(\n        args.addinType,\n        readyArgs,\n        this.getHostedSurfaceMode({ addinType: args.addinType, readyArgs })\n      );\n\n      ready(\n        withInferredModalStyle(\n          readyArgs,\n          resolution.inferredModalStyle\n        )\n      );\n    };\n\n    return args;\n  }\n\n  private getHostedSurfaceMode(\n    context: AddinClientHostedSurfaceContext\n  ): AddinClientHostedSurfaceMode {\n    // A config provided as a plain object may predate getHostedSurfaceMode().\n    return (\n      this.#addinClientConfigService?.getHostedSurfaceMode?.(context) ??\n      'automatic'\n    );\n  }\n\n  /**\n   * Requests the host page to navigate.\n   * @param args Arguments describing the navigation request.\n   */\n  public navigate(args: AddinClientNavigateArgs): void {\n    this.addinClient.navigate(args);\n  }\n\n  /**\n   * Informs the host to open the help tab with the specified help key.\n   * @param args Arguments for launching the help tab.\n   */\n  public openHelp(args: AddinClientOpenHelpArgs): void {\n    this.addinClient.openHelp(args);\n  }\n\n  /**\n   * Requests a user identity token for the current user.\n   * @returns Returns an observable which will publish the token value.\n   */\n  public getUserIdentityToken(): Observable<string> {\n    return from(this.addinClient.getUserIdentityToken());\n  }\n\n  /**\n   * @deprecated Use getUserIdentityToken\n   */\n  public getAuthToken(): Observable<string> {\n    return from(this.addinClient.getUserIdentityToken());\n  }\n\n  /**\n   * Informs the host to show a toast message.\n   * @param args Arguments for showing a toast.\n   */\n  public showToast(args: AddinClientShowToastArgs): void {\n    this.addinClient.showToast(args);\n  }\n\n  /**\n   * Requests the host page to launch a flyout add-in.\n   * @param args Arguments for launching the flyout.\n   * @returns Returns an observable that will notify when the flyout add-in is closed.\n   */\n  public showFlyout(args: AddinClientShowFlyoutArgs): Observable<void> {\n    const flyoutReturn: AddinClientShowFlyoutResult = this.addinClient.showFlyout(args);\n    return from(flyoutReturn.flyoutClosed);\n  }\n\n  /**\n   * Requests the host page to close the flyout add-in.\n   */\n  public closeFlyout(): void {\n    this.addinClient.closeFlyout();\n  }\n\n  /**\n   * Requests the host page to show a confirm dialog.\n   * @param args Arguments for showing a confirm dialog.\n   * @returns Returns an observable which will publish the confirm action value.\n   */\n  public showConfirm(args: AddinClientShowConfirmArgs): Observable<string> {\n    return from(this.addinClient.showConfirm(args));\n  }\n\n  /**\n   * Informs the host to show an error dialog.\n   * @param args Arguments for showing an error dialog.\n   */\n  public showError(args: AddinClientShowErrorArgs): void {\n    this.addinClient.showError(args);\n  }\n\n  /**\n   * Requests the host page to show a page blocking wait indicator.\n   */\n  public showWait(): void {\n    this.addinClient.showWait();\n  }\n\n  /**\n   * Requests the host page to hide a page blocking wait indicator.\n   */\n  public hideWait(): void {\n    this.addinClient.hideWait();\n  }\n\n  /**\n   * Registers an event handler for the provided event type.\n   * @param eventType The event type to register.\n   * @returns AddinEventHandlerInstance\n   */\n  public addEventHandler(eventType: string): AddinEventHandlerInstance {\n    let eventHandlerInstance = new AddinEventHandlerInstance();\n\n    const eventCallback: AddinEventCallback = (context, done) => {\n      eventHandlerInstance.addinEvent.emit({\n        context,\n        done\n      });\n    };\n    this.addinClient.addEventHandler(eventType, eventCallback);\n\n    return eventHandlerInstance;\n  }\n\n  /**\n   * Sends an event to be handled by the host page.\n   * @param args The event arguments to be sent to the host page.\n   * @returns Returns an observable which will complete when the add-in host page receives the\n   * message. The request will fail if a subsequent event occurs, for the same event type, within\n   * 200 milliseconds. A failure can also occur if an event type is not one of the supported types\n   * from the host page.\n   * @see AddinClientInitArgs#supportedEventTypes\n   */\n  public sendEvent(args: AddinClientEventArgs): Observable<void> {\n    return from(this.addinClient.sendEvent(args));\n  }\n\n  private initializeTheme(\n    themeSettings: AddinClientThemeSettings | undefined\n  ): void {\n    if (!themeSettings || !this.supportsHostTheme(themeSettings)) {\n      // app does not support host theme, do nothing to initialize the app's default theme\n      return;\n    }\n\n    this.initializeTheme_(AddinClientService.toSkyThemeSettings(themeSettings));\n  }\n\n  private initializeTheme_(themeSettings: SkyThemeSettings): void {\n    this.#themeService.init(\n      document.body,\n      this.#rendererFactory.createRenderer(null, null),\n      themeSettings\n    );\n  }\n\n  private setTheme(settings: AddinClientThemeSettings): void {\n    // A host theme change follows the same rule as initialization, so the app is\n    // never switched to a theme it does not support.\n    if (!settings || !this.supportsHostTheme(settings)) {\n      return;\n    }\n\n    this.#themeService.setTheme(AddinClientService.toSkyThemeSettings(settings));\n  }\n\n  /**\n   * Whether the app supports the host's theme. An app without SKY UX app config supports\n   * any host theme; otherwise the theme must be listed in `app.theming.supportedThemes`.\n   */\n  private supportsHostTheme(settings: AddinClientThemeSettings): boolean {\n    if (!this.#config) {\n      return true;\n    }\n\n    const supportedThemes = this.#config.skyux.app?.theming?.supportedThemes;\n\n    return !!supportedThemes &&\n      supportedThemes.indexOf(settings.theme as SkyuxConfigAppSupportedTheme) !== -1;\n  }\n\n  private static toSkyThemeSettings(settings: AddinClientThemeSettings): SkyThemeSettings {\n    if (settings.skyThemeSettings) {\n      // If the settings contain a serialized SkyThemeSettings object, deserialize it.\n      return SkyThemeSettings.deserialize(settings.skyThemeSettings);\n    }\n\n    return new SkyThemeSettings(\n      AddinClientService.toSkyTheme(settings.theme),\n      AddinClientService.toSkyThemeMode(settings.mode)\n    );\n  }\n\n  private static toSkyTheme(theme: string): SkyTheme {\n    switch (theme) {\n      case 'modern':\n        return SkyTheme.presets.modern;\n      default:\n        return SkyTheme.presets.default;\n    }\n  }\n\n  private static toSkyThemeMode(mode: string): SkyThemeMode {\n    switch (mode) {\n      case 'dark':\n        return SkyThemeMode.presets.dark;\n      default:\n        return SkyThemeMode.presets.light;\n    }\n  }\n}\n","import { inject, Injectable, Provider } from '@angular/core';\nimport { SkyHelpOpenArgs, SkyHelpService } from '@skyux/core';\nimport { AddinClientService } from '../addin-client.service';\n\n@Injectable({ providedIn: 'root' })\nexport class AddinClientHelpService extends SkyHelpService {\n  private skyAddinClientService = inject(AddinClientService);\n\n  /** @inheritdoc */\n  public override openHelp(args?: SkyHelpOpenArgs): void {\n    if (!args) {\n      return;\n    }\n\n    this.skyAddinClientService.openHelp(args);\n  }\n\n  /** @inheritdoc */\n  public override updateHelp(): void {\n    throw new Error('Not implemented');\n  }\n}\n\n/** Provide addin client help service */\nexport function provideAddinClientHelp(): Provider[] {\n  return [{ provide: SkyHelpService, useClass: AddinClientHelpService }];\n}\n"],"mappings":"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"}

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@blackbaud/skyux-lib-addin-client",
-  "version": "14.1.0",
+  "version": "15.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/blackbaud/skyux-lib-addin-client.git"
   },
   "peerDependencies": {
-    "@angular/common": "^21.2.8",
-    "@angular/core": "^21.2.8",
-    "@skyux/config": "^14.0.1",
-    "@skyux/theme": "^14.0.1"
+    "@angular/common": "^22.1.2",
+    "@angular/core": "^22.1.2",
+    "@skyux/config": "^15.2.0",
+    "@skyux/theme": "^15.2.0"
   },
   "dependencies": {
     "@blackbaud/sky-addin-client": "^1.8.0",

package/types/blackbaud-skyux-lib-addin-client.d.ts

@@ -1,191 +1,223 @@
-import * as i0 from '@angular/core';
-import { EventEmitter, Provider } from '@angular/core';
-import { AddinClient, AddinClientInitArgs, AddinClientCloseModalArgs, AddinClientShowModalArgs, AddinClientNavigateArgs, AddinClientOpenHelpArgs, AddinClientShowToastArgs, AddinClientShowFlyoutArgs, AddinClientShowConfirmArgs, AddinClientShowErrorArgs, AddinClientEventArgs, AddinClientConfig } from '@blackbaud/sky-addin-client';
-import { Observable } from 'rxjs';
-import { SkyHelpService, SkyHelpOpenArgs } from '@skyux/core';
-
+import * as i0 from "@angular/core";
+import { EventEmitter, Provider } from "@angular/core";
+import { AddinClient, AddinClientCloseModalArgs, AddinClientConfig, AddinClientEventArgs, AddinClientInitArgs, AddinClientNavigateArgs, AddinClientOpenHelpArgs, AddinClientReadyArgs, AddinClientShowConfirmArgs, AddinClientShowErrorArgs, AddinClientShowFlyoutArgs, AddinClientShowModalArgs, AddinClientShowToastArgs, AddinType } from "@blackbaud/sky-addin-client";
+import { Observable } from "rxjs";
+import { SkyHelpOpenArgs, SkyHelpService } from "@skyux/core";
 /**
  * Contains data for an add-in event and allows you to indicate that an event
  * has been processed
  */
-declare class AddinEvent {
-    /**
-     * The data that an add-in event has returned.
-     */
-    context: any;
-    /**
-     * A function to call indicating that the add-in event is processed.
-     * Returning any necessary data back to the host.
-     */
-    done?: (data?: any) => void;
+export declare class AddinEvent {
+  /**
+   * The data that an add-in event has returned.
+   */
+  context: any;
+  /**
+   * A function to call indicating that the add-in event is processed.
+   * Returning any necessary data back to the host.
+   */
+  done?: (data?: any) => void;
 }
-
 /**
  * Allows you to process events from an event handler.
  */
-declare class AddinEventHandlerInstance {
-    /**
-     * An event that emits when a new add-in event has occurred.
-     */
-    addinEvent: EventEmitter<AddinEvent>;
+export declare class AddinEventHandlerInstance {
+  /**
+   * An event that emits when a new add-in event has occurred.
+   */
+  addinEvent: EventEmitter<AddinEvent>;
 }
-
-declare class AddinClientService {
-    #private;
-    readonly addinClient: AddinClient;
-    private _args;
-    args: Observable<AddinClientInitArgs>;
-    /**
-     * Event emitted for box add-ins indicating that a control action button was clicked.
-     */
-    actionClick: EventEmitter<string>;
-    /**
-     * Event emitted for button add-ins indicating that the button was clicked.
-     */
-    buttonClick: EventEmitter<any>;
-    /**
-     * Event emitted for add-ins when context information has been updated
-     */
-    updateContext: EventEmitter<any>;
-    /**
-     * Event emitted for flyout add-ins indicating that the next button was clicked.
-     */
-    flyoutNextClick: EventEmitter<any>;
-    /**
-     * Event emitted for flyout add-ins indicating that the previous button was clicked.
-     */
-    flyoutPreviousClick: EventEmitter<any>;
-    /**
-     * Event emitted for tile add-ins indicating that the help button was clicked.
-     * @deprecated Use tile inline help instead and handle the {@link inlineHelpClick} emitter.
-     */
-    helpClick: EventEmitter<any>;
-    /**
-     * Event emitted indicating that the inline help button was clicked.
-     */
-    inlineHelpClick: EventEmitter<any>;
-    /**
-     * Event emitted for tile add-ins indicating that the settings button was clicked.
-     */
-    settingsClick: EventEmitter<any>;
-    constructor();
-    /**
-     * Informs the host to close this modal add-in.
-     * Should only be used from within the modal add-in and not the parent add-in.
-     * @param args Arguments to provide a context object back to the parent add-in.
-     */
-    closeModal(args: AddinClientCloseModalArgs): void;
-    /**
-     * Requests the host page to launch a modal add-in.
-     * @param args Arguments for launching the modal.
-     * @returns Returns an observable that will publish a value when the modal add-in is closed.
-     * Observables will publish values with context data passed from the modal add-in's closeModal call.
-     */
-    showModal(args: AddinClientShowModalArgs): Observable<any>;
-    /**
-     * Cleans up the AddinClient, releasing all resources.
-     */
-    destroy(): void;
-    /**
-     * Requests the host page to navigate.
-     * @param args Arguments describing the navigation request.
-     */
-    navigate(args: AddinClientNavigateArgs): void;
-    /**
-     * Informs the host to open the help tab with the specified help key.
-     * @param args Arguments for launching the help tab.
-     */
-    openHelp(args: AddinClientOpenHelpArgs): void;
-    /**
-     * Requests a user identity token for the current user.
-     * @returns Returns an observable which will publish the token value.
-     */
-    getUserIdentityToken(): Observable<string>;
-    /**
-     * @deprecated Use getUserIdentityToken
-     */
-    getAuthToken(): Observable<string>;
-    /**
-     * Informs the host to show a toast message.
-     * @param args Arguments for showing a toast.
-     */
-    showToast(args: AddinClientShowToastArgs): void;
-    /**
-     * Requests the host page to launch a flyout add-in.
-     * @param args Arguments for launching the flyout.
-     * @returns Returns an observable that will notify when the flyout add-in is closed.
-     */
-    showFlyout(args: AddinClientShowFlyoutArgs): Observable<void>;
-    /**
-     * Requests the host page to close the flyout add-in.
-     */
-    closeFlyout(): void;
-    /**
-     * Requests the host page to show a confirm dialog.
-     * @param args Arguments for showing a confirm dialog.
-     * @returns Returns an observable which will publish the confirm action value.
-     */
-    showConfirm(args: AddinClientShowConfirmArgs): Observable<string>;
-    /**
-     * Informs the host to show an error dialog.
-     * @param args Arguments for showing an error dialog.
-     */
-    showError(args: AddinClientShowErrorArgs): void;
-    /**
-     * Requests the host page to show a page blocking wait indicator.
-     */
-    showWait(): void;
-    /**
-     * Requests the host page to hide a page blocking wait indicator.
-     */
-    hideWait(): void;
-    /**
-     * Registers an event handler for the provided event type.
-     * @param eventType The event type to register.
-     * @returns AddinEventHandlerInstance
-     */
-    addEventHandler(eventType: string): AddinEventHandlerInstance;
-    /**
-     * Sends an event to be handled by the host page.
-     * @param args The event arguments to be sent to the host page.
-     * @returns Returns an observable which will complete when the add-in host page receives the
-     * message. The request will fail if a subsequent event occurs, for the same event type, within
-     * 200 milliseconds. A failure can also occur if an event type is not one of the supported types
-     * from the host page.
-     * @see AddinClientInitArgs#supportedEventTypes
-     */
-    sendEvent(args: AddinClientEventArgs): Observable<void>;
-    private initializeTheme;
-    private initializeTheme_;
-    private setTheme;
-    private static toSkyThemeSettings;
-    private static toSkyTheme;
-    private static toSkyThemeMode;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AddinClientService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AddinClientService>;
+export declare class AddinClientService {
+  #private;
+  readonly addinClient: AddinClient;
+  private _args;
+  args: Observable<AddinClientInitArgs>;
+  /**
+   * Event emitted for box add-ins indicating that a control action button was clicked.
+   */
+  actionClick: EventEmitter<string>;
+  /**
+   * Event emitted for button add-ins indicating that the button was clicked.
+   */
+  buttonClick: EventEmitter<any>;
+  /**
+   * Event emitted for add-ins when context information has been updated
+   */
+  updateContext: EventEmitter<any>;
+  /**
+   * Event emitted for flyout add-ins indicating that the next button was clicked.
+   */
+  flyoutNextClick: EventEmitter<any>;
+  /**
+   * Event emitted for flyout add-ins indicating that the previous button was clicked.
+   */
+  flyoutPreviousClick: EventEmitter<any>;
+  /**
+   * Event emitted for tile add-ins indicating that the help button was clicked.
+   * @deprecated Use tile inline help instead and handle the {@link inlineHelpClick} emitter.
+   */
+  helpClick: EventEmitter<any>;
+  /**
+   * Event emitted indicating that the inline help button was clicked.
+   */
+  inlineHelpClick: EventEmitter<any>;
+  /**
+   * Event emitted for tile add-ins indicating that the settings button was clicked.
+   */
+  settingsClick: EventEmitter<any>;
+  private destroyed;
+  private readonly hostedSurfaceController;
+  constructor();
+  /**
+   * Informs the host to close this modal add-in.
+   * Should only be used from within the modal add-in and not the parent add-in.
+   * @param args Arguments to provide a context object back to the parent add-in.
+   */
+  closeModal(args: AddinClientCloseModalArgs): void;
+  /**
+   * Requests the host page to launch a modal add-in.
+   * @param args Arguments for launching the modal.
+   * @returns Returns an observable that will publish a value when the modal add-in is closed.
+   * Observables will publish values with context data passed from the modal add-in's closeModal call.
+   */
+  showModal(args: AddinClientShowModalArgs): Observable<any>;
+  /**
+   * Cleans up the AddinClient, releasing all resources.
+   */
+  destroy(): void;
+  private prepareInitArgs;
+  private getHostedSurfaceMode;
+  /**
+   * Requests the host page to navigate.
+   * @param args Arguments describing the navigation request.
+   */
+  navigate(args: AddinClientNavigateArgs): void;
+  /**
+   * Informs the host to open the help tab with the specified help key.
+   * @param args Arguments for launching the help tab.
+   */
+  openHelp(args: AddinClientOpenHelpArgs): void;
+  /**
+   * Requests a user identity token for the current user.
+   * @returns Returns an observable which will publish the token value.
+   */
+  getUserIdentityToken(): Observable<string>;
+  /**
+   * @deprecated Use getUserIdentityToken
+   */
+  getAuthToken(): Observable<string>;
+  /**
+   * Informs the host to show a toast message.
+   * @param args Arguments for showing a toast.
+   */
+  showToast(args: AddinClientShowToastArgs): void;
+  /**
+   * Requests the host page to launch a flyout add-in.
+   * @param args Arguments for launching the flyout.
+   * @returns Returns an observable that will notify when the flyout add-in is closed.
+   */
+  showFlyout(args: AddinClientShowFlyoutArgs): Observable<void>;
+  /**
+   * Requests the host page to close the flyout add-in.
+   */
+  closeFlyout(): void;
+  /**
+   * Requests the host page to show a confirm dialog.
+   * @param args Arguments for showing a confirm dialog.
+   * @returns Returns an observable which will publish the confirm action value.
+   */
+  showConfirm(args: AddinClientShowConfirmArgs): Observable<string>;
+  /**
+   * Informs the host to show an error dialog.
+   * @param args Arguments for showing an error dialog.
+   */
+  showError(args: AddinClientShowErrorArgs): void;
+  /**
+   * Requests the host page to show a page blocking wait indicator.
+   */
+  showWait(): void;
+  /**
+   * Requests the host page to hide a page blocking wait indicator.
+   */
+  hideWait(): void;
+  /**
+   * Registers an event handler for the provided event type.
+   * @param eventType The event type to register.
+   * @returns AddinEventHandlerInstance
+   */
+  addEventHandler(eventType: string): AddinEventHandlerInstance;
+  /**
+   * Sends an event to be handled by the host page.
+   * @param args The event arguments to be sent to the host page.
+   * @returns Returns an observable which will complete when the add-in host page receives the
+   * message. The request will fail if a subsequent event occurs, for the same event type, within
+   * 200 milliseconds. A failure can also occur if an event type is not one of the supported types
+   * from the host page.
+   * @see AddinClientInitArgs#supportedEventTypes
+   */
+  sendEvent(args: AddinClientEventArgs): Observable<void>;
+  private initializeTheme;
+  private initializeTheme_;
+  private setTheme;
+  /**
+   * Whether the app supports the host's theme. An app without SKY UX app config supports
+   * any host theme; otherwise the theme must be listed in `app.theming.supportedThemes`.
+   */
+  private supportsHostTheme;
+  private static toSkyThemeSettings;
+  private static toSkyTheme;
+  private static toSkyThemeMode;
+  static ɵfac: i0.ɵɵFactoryDeclaration<AddinClientService, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<AddinClientService>;
+}
+/**
+ * How the add-in client styles the add-in document for its hosted surface.
+ * - `'automatic'`: adapts the document background to the hosted surface.
+ * - `'preserve'`: leaves the add-in's own background styling unchanged.
+ * - `'container'`: uses the SKY UX container background, whatever the hosted surface.
+ */
+export type AddinClientHostedSurfaceMode = 'automatic' | 'preserve' | 'container';
+/**
+ * What the add-in client knows about the hosted surface when it asks for the
+ * hosted surface mode.
+ */
+export interface AddinClientHostedSurfaceContext {
+  /**
+   * The add-in type the host reported, or `undefined` when the host doesn't report one
+   * or reports a type this client doesn't recognize.
+   */
+  readonly addinType: AddinType | undefined;
+  /**
+   * The arguments the add-in passed to `ready()`.
+   */
+  readonly readyArgs: AddinClientReadyArgs;
 }
-
 /**
  * Implement this class with your own data to initialize the add-in client service.
  */
-declare abstract class AddinClientConfigService {
-    /**
-     * Gets the AddinClientConfig object that will be injected the
-     * AddinClient instance when instantiated.
-     */
-    getAddinClientConfig(): AddinClientConfig;
+export declare abstract class AddinClientConfigService {
+  /**
+   * Gets the AddinClientConfig object that will be injected the
+   * AddinClient instance when instantiated.
+   */
+  getAddinClientConfig(): AddinClientConfig;
+  /**
+   * Gets how the add-in client styles the add-in document for its hosted surface. The
+   * client asks on every `ready()` call, so an add-in can choose per add-in type, per
+   * route, or per `ready()` call. Return `'preserve'` to keep the add-in's own background
+   * styling, or `'container'` to use the SKY UX container background.
+   * @param context The hosted surface the add-in is being made ready for.
+   */
+  getHostedSurfaceMode(context: AddinClientHostedSurfaceContext): AddinClientHostedSurfaceMode;
 }
-
-declare class AddinClientHelpService extends SkyHelpService {
-    private skyAddinClientService;
-    /** @inheritdoc */
-    openHelp(args?: SkyHelpOpenArgs): void;
-    /** @inheritdoc */
-    updateHelp(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AddinClientHelpService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AddinClientHelpService>;
+export declare class AddinClientHelpService extends SkyHelpService {
+  private skyAddinClientService;
+  /** @inheritdoc */
+  openHelp(args?: SkyHelpOpenArgs): void;
+  /** @inheritdoc */
+  updateHelp(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<AddinClientHelpService, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<AddinClientHelpService>;
 }
 /** Provide addin client help service */
-declare function provideAddinClientHelp(): Provider[];
-
-export { AddinClientConfigService, AddinClientHelpService, AddinClientService, AddinEvent, AddinEventHandlerInstance, provideAddinClientHelp };
+export declare function provideAddinClientHelp(): Provider[];