Class HomeAppPinService

constructor

• new HomeAppPinService(): HomeAppPinService

  Returns HomeAppPinService

ReadonlyPins$

AddPin

• AddPin(input: HomeAppPinInput): boolean

  Add a new pin. Returns false if a duplicate already exists.

  Parameters

  • input: HomeAppPinInput

  Returns boolean

CaptureThumbnail

• CaptureThumbnail(element: HTMLElement): Promise<string | undefined>

  Capture a thumbnail of a DOM element using html-to-image. Uses SVG foreignObject so the browser's own CSS engine handles modern features like color-mix() that html2canvas can't parse. Returns a base64 JPEG data URL (~5-15KB) or undefined on failure.

  Parameters

  • element: HTMLElement

  Returns Promise<string | undefined>

FindPin

• FindPin(
      resourceType: string,
      config: Record<string, unknown>,
  ): HomeAppPinnedItem | undefined

  Find the pin for a given resource, if it exists

  Parameters

  • resourceType: string
  • config: Record<string, unknown>

  Returns HomeAppPinnedItem | undefined

GetGroups

• GetGroups(): string[]

  Get unique group names in display order (ordered by lowest Sequence in group)

  Returns string[]

GetPinsInGroup

• GetPinsInGroup(groupName: string): HomeAppPinnedItem[]

  Get pins in a specific group

  Parameters

  • groupName: string

  Returns HomeAppPinnedItem[]

GetUngroupedPins

• GetUngroupedPins(): HomeAppPinnedItem[]

  Get ungrouped pins (Group is null/undefined/empty)

  Returns HomeAppPinnedItem[]

IsPinned

• IsPinned(resourceType: string, config: Record<string, unknown>): boolean

  Check if a resource is already pinned

  Parameters

  • resourceType: string
  • config: Record<string, unknown>

  Returns boolean

LoadPins

• LoadPins(): Promise<void>

  Load pins from UserSettings. Safe to call multiple times (loads only once).

  Returns Promise<void>

ReloadPins

• ReloadPins(): Promise<void>

  Force reload from UserSettings (e.g. after external changes)

  Returns Promise<void>

RemovePin

• RemovePin(pinId: string): void

  Remove a pin by ID

  Parameters

  • pinId: string

  Returns void

ReorderPins

• ReorderPins(pins: HomeAppPinnedItem[]): void

  Reorder pins. Accepts full reordered array with updated Sequence values.

  Parameters

  • pins: HomeAppPinnedItem[]

  Returns void

UpdatePin

• UpdatePin(pinId: string, updates: HomeAppPinUpdate): void

  Update pin properties (name, description, icon, group, thumbnail)

  Parameters

  • pinId: string
  • updates: HomeAppPinUpdate

  Returns void