@internetarchive/collection-browser 4.7.0 → 4.8.0

package/.claude/worktrees/WEBDEV-9127-fix-publish-dist-tag/src/tiles/tile-dispatcher.ts

@@ -1,637 +0,0 @@
-import { css, html, nothing, PropertyValues } from 'lit';
-import { customElement, property, query } from 'lit/decorators.js';
-import { classMap } from 'lit/directives/class-map.js';
-import { ifDefined } from 'lit/directives/if-defined.js';
-import { msg } from '@lit/localize';
-import type {
-  SharedResizeObserverInterface,
-  SharedResizeObserverResizeHandlerInterface,
-} from '@internetarchive/shared-resize-observer';
-import type { TileDisplayMode } from '../models';
-import type { CollectionTitles } from '../data-source/models';
-import './grid/collection-tile';
-import './grid/item-tile';
-import './grid/account-tile';
-import './grid/search-tile';
-import './hover/tile-hover-pane';
-import './list/tile-list';
-import './list/tile-list-compact';
-import './list/tile-list-compact-header';
-import type { TileHoverPane } from './hover/tile-hover-pane';
-import { BaseTileComponent } from './base-tile-component';
-import { LayoutType } from './models';
-import {
-  HoverPaneController,
-  HoverPaneControllerInterface,
-  HoverPaneProperties,
-  HoverPaneProviderInterface,
-} from './hover/hover-pane-controller';
-import { srOnlyStyle } from '../styles/sr-only';
-import { tileActionStyles } from '../styles/tile-action-styles';
-
-@customElement('tile-dispatcher')
-export class TileDispatcher
-  extends BaseTileComponent
-  implements
-    SharedResizeObserverResizeHandlerInterface,
-    HoverPaneProviderInterface
-{
-  /*
-   * Reactive properties inherited from BaseTileComponent:
-   *  - model?: TileModel;
-   *  - tileActions: TileAction[] = [];
-   *  - currentWidth?: number;
-   *  - currentHeight?: number;
-   *  - baseNavigationUrl?: string;
-   *  - baseImageUrl?: string;
-   *  - collectionPagePath?: string;
-   *  - sortParam: SortParam | null = null;
-   *  - defaultSortParam: SortParam | null = null;
-   *  - creatorFilter?: string;
-   *  - mobileBreakpoint?: number;
-   *  - loggedIn = false;
-   *  - suppressTileBlurring = false;
-   *  - useLocalTime = false;
-   */
-
-  @property({ type: String }) tileDisplayMode?: TileDisplayMode;
-
-  @property({ type: Boolean }) isManageView = false;
-
-  @property({ type: Object }) resizeObserver?: SharedResizeObserverInterface;
-
-  @property({ type: Object })
-  collectionTitles?: CollectionTitles;
-
-  @property({ type: Boolean }) showTvClips = false;
-
-  /** What type of simplified layout to use in grid mode, if any */
-  @property({ type: String }) layoutType: LayoutType = 'default';
-
-  /** Whether this tile should include a hover pane at all (for applicable tile modes) */
-  @property({ type: Boolean }) enableHoverPane = false;
-
-  @property({ type: String }) manageCheckTitle = msg(
-    'Remove this item from the list',
-  );
-
-  private hoverPaneController?: HoverPaneControllerInterface;
-
-  @query('#container')
-  private container!: HTMLDivElement;
-
-  @query('tile-hover-pane')
-  private hoverPane?: TileHoverPane;
-
-  @query('.tile-link')
-  private tileLinkElement?: HTMLAnchorElement;
-
-  acquireFocus(): void {
-    this.tileLinkElement?.focus();
-  }
-
-  releaseFocus(): void {
-    this.tileLinkElement?.blur();
-  }
-
-  /** Maps each display mode to whether hover panes should appear in that mode */
-  private static readonly HOVER_PANE_DISPLAY_MODES: Record<
-    TileDisplayMode,
-    boolean
-  > = {
-    grid: true,
-    'list-compact': true,
-    'list-detail': false,
-    'list-header': false,
-  };
-
-  render() {
-    const isGridMode = this.tileDisplayMode === 'grid';
-    const hasTileActions = isGridMode && this.showGridTileActions;
-    const hoverPaneTemplate =
-      this.hoverPaneController?.getTemplate() ?? nothing;
-    const containerClasses = classMap({
-      hoverable: isGridMode,
-      'has-tile-actions': hasTileActions,
-    });
-    return html`
-      <div id="container" class=${containerClasses}>
-        ${this.tileDisplayMode === 'list-header'
-          ? this.headerTemplate
-          : this.tileTemplate}
-        ${this.gridTileActionsTemplate} ${this.manageCheckTemplate}
-        ${hoverPaneTemplate}
-      </div>
-    `;
-  }
-
-  protected firstUpdated(): void {
-    if (this.shouldPrepareHoverPane) {
-      this.hoverPaneController = new HoverPaneController(this, {
-        mobileBreakpoint: this.mobileBreakpoint,
-        enableLongPress: false,
-      });
-    }
-  }
-
-  private get headerTemplate() {
-    const { currentWidth, sortParam, defaultSortParam, mobileBreakpoint } =
-      this;
-    return html`
-      <tile-list-compact-header
-        class="header"
-        .currentWidth=${currentWidth}
-        .sortParam=${sortParam ?? defaultSortParam}
-        .mobileBreakpoint=${mobileBreakpoint}
-        .tileActions=${this.tileActions}
-      >
-      </tile-list-compact-header>
-    `;
-  }
-
-  private get tileTemplate() {
-    return html`
-      ${this.tileDisplayMode === 'list-detail'
-        ? this.tile
-        : this.linkTileTemplate}
-    `;
-  }
-
-  private get linkTileTemplate() {
-    return html`
-      <a
-        href=${this.linkTileHref}
-        aria-label=${this.model?.title ?? 'Untitled item'}
-        aria-describedby="link-aria-description"
-        aria-haspopup=${this.shouldPrepareHoverPane ? 'dialog' : 'false'}
-        title=${this.shouldPrepareHoverPane
-          ? nothing // Don't show title tooltips when we have the tile info popups
-          : ifDefined(this.model?.title)}
-        @click=${this.handleLinkClicked}
-        @contextmenu=${this.handleLinkContextMenu}
-        class="tile-link"
-      >
-        ${this.tile}
-      </a>
-      <div id="link-aria-description" class="sr-only">
-        ${msg('Press Down Arrow to preview item details')}
-      </div>
-    `;
-  }
-
-  private get linkTileHref(): string | typeof nothing {
-    if (!this.model?.identifier || this.baseNavigationUrl == null)
-      return nothing;
-
-    // Use the server-specified href if available.
-    // Otherwise, construct a details page URL from the item identifier.
-    if (this.model.href) {
-      return `${this.baseNavigationUrl}${this.model.href}`;
-    }
-
-    return this.displayValueProvider.itemPageUrl(
-      this.model.identifier,
-      this.model.mediatype === 'collection',
-    );
-  }
-
-  private get manageCheckTemplate() {
-    if (!this.isManageView || this.tileDisplayMode !== 'grid') return nothing;
-
-    return html`
-      <div class="manage-check">
-        <input
-          type="checkbox"
-          title=${this.manageCheckTitle}
-          ?checked=${this.model?.checked}
-          @change=${this.handleLinkClicked}
-        />
-      </div>
-    `;
-  }
-
-  /**
-   * Whether hover pane behavior should be prepared for this tile
-   * (e.g., whether mouse listeners should be attached, etc.)
-   */
-  private get shouldPrepareHoverPane(): boolean {
-    return (
-      this.enableHoverPane &&
-      !!this.tileDisplayMode &&
-      TileDispatcher.HOVER_PANE_DISPLAY_MODES[this.tileDisplayMode] &&
-      this.model?.mediatype !== 'search' && // don't show hover panes on search tiles
-      !this.model?.captureDates // don't show hover panes on web archive tiles
-    );
-  }
-
-  private get isHoverEnabled(): boolean {
-    return window.matchMedia('(hover: hover)').matches;
-  }
-
-  /**
-   * Whether the info button should be shown on this tile.
-   * Only shown on touch/non-hover devices where a hover pane is available,
-   * so the button always has something to toggle.
-   */
-  private get shouldShowInfoButton(): boolean {
-    return !this.isHoverEnabled && this.shouldPrepareHoverPane;
-  }
-
-  /** @inheritdoc */
-  getHoverPane(): TileHoverPane | undefined {
-    return this.hoverPane;
-  }
-
-  /** @inheritdoc */
-  getHoverPaneProps(): HoverPaneProperties {
-    return this;
-  }
-
-  handleResize(entry: ResizeObserverEntry): void {
-    this.currentWidth = entry.contentRect.width;
-    this.currentHeight = entry.contentRect.height;
-  }
-
-  disconnectedCallback(): void {
-    this.stopResizeObservation(this.resizeObserver);
-  }
-
-  private stopResizeObservation(observer?: SharedResizeObserverInterface) {
-    observer?.removeObserver({
-      handler: this,
-      target: this.container,
-    });
-  }
-
-  private startResizeObservation() {
-    this.stopResizeObservation(this.resizeObserver);
-    this.resizeObserver?.addObserver({
-      handler: this,
-      target: this.container,
-    });
-  }
-
-  updated(props: PropertyValues) {
-    if (props.has('resizeObserver')) {
-      const previousObserver = props.get(
-        'resizeObserver',
-      ) as SharedResizeObserverInterface;
-      this.stopResizeObservation(previousObserver);
-      this.startResizeObservation();
-    }
-  }
-
-  /**
-   * Handler for when the tile link is left-clicked. Emits the `resultSelected` event.
-   * In manage view, it also checks/unchecks the tile.
-   */
-  private handleLinkClicked(e: Event): void {
-    if (this.isManageView) {
-      e.preventDefault();
-      if (this.model) this.model.checked = !this.model.checked;
-    }
-
-    this.dispatchEvent(
-      new CustomEvent('resultSelected', { detail: this.model }),
-    );
-  }
-
-  /**
-   * Handler for when the tile link is right-clicked.
-   * In manage view, it opens the item in a new tab. Otherwise, does nothing.
-   */
-  private handleLinkContextMenu(e: Event): void {
-    if (this.isManageView && this.linkTileHref !== nothing) {
-      e.preventDefault();
-      window.open(this.linkTileHref, '_blank');
-    }
-  }
-
-  private tileInfoButtonPressed(
-    e: CustomEvent<{ x: number; y: number }>,
-  ): void {
-    this.hoverPaneController?.toggleHoverPane({
-      coords: e.detail,
-      enableTouchBackdrop: true,
-    });
-  }
-
-  /** Whether tile action buttons should be rendered in grid mode */
-  private get showGridTileActions(): boolean {
-    return (
-      this.tileActions.length > 0 &&
-      !this.isManageView &&
-      this.tileDisplayMode === 'grid'
-    );
-  }
-
-  /**
-   * Template for the grid-mode action buttons. Rendered alongside the inner
-   * tile link inside the dispatcher's shadow root so the action buttons can
-   * suppress the hover pane on hover.
-   */
-  private get gridTileActionsTemplate() {
-    if (!this.showGridTileActions) return nothing;
-
-    return html`
-      <div
-        class="tile-actions grid-tile-actions"
-        @mouseenter=${this.handleGridActionsMouseEnter}
-        @mousemove=${(e: Event) => e.stopPropagation()}
-      >
-        ${this.tileActions.map(
-          action => html`
-            <button
-              class="tile-action-btn"
-              @click=${(e: Event) => this.handleTileActionClick(e, action)}
-            >
-              ${action.label}
-            </button>
-          `,
-        )}
-      </div>
-    `;
-  }
-
-  /**
-   * When the mouse enters the grid-mode tile actions area, dispatch a
-   * synthetic mouseleave on the host to cancel the hover pane's show timer
-   * and hide any visible pane.
-   */
-  private handleGridActionsMouseEnter = (): void => {
-    this.dispatchEvent(new MouseEvent('mouseleave', { bubbles: false }));
-  };
-
-  private get tile() {
-    const {
-      model,
-      collectionPagePath,
-      baseNavigationUrl,
-      currentWidth,
-      currentHeight,
-      sortParam,
-      creatorFilter,
-      mobileBreakpoint,
-      defaultSortParam,
-    } = this;
-
-    if (!model) return nothing;
-
-    switch (this.tileDisplayMode) {
-      case 'grid':
-        switch (model.mediatype) {
-          case 'collection':
-            return html`<collection-tile
-              .model=${model}
-              .collectionPagePath=${collectionPagePath}
-              .baseImageUrl=${this.baseImageUrl}
-              .currentWidth=${currentWidth}
-              .currentHeight=${currentHeight}
-              .creatorFilter=${creatorFilter}
-              .suppressBlurring=${this.suppressBlurring}
-              .isManageView=${this.isManageView}
-              .layoutType=${this.layoutType}
-              ?showInfoButton=${this.shouldShowInfoButton}
-              @infoButtonPressed=${this.tileInfoButtonPressed}
-            >
-            </collection-tile>`;
-          case 'account':
-            return html`<account-tile
-              .model=${model}
-              .collectionPagePath=${collectionPagePath}
-              .baseImageUrl=${this.baseImageUrl}
-              .currentWidth=${currentWidth}
-              .currentHeight=${currentHeight}
-              .creatorFilter=${creatorFilter}
-              .suppressBlurring=${this.suppressBlurring}
-              .isManageView=${this.isManageView}
-              ?showInfoButton=${this.shouldShowInfoButton}
-              @infoButtonPressed=${this.tileInfoButtonPressed}
-            >
-            </account-tile>`;
-          case 'search':
-            return html`<search-tile
-              .model=${model}
-              .collectionPagePath=${collectionPagePath}
-              .baseImageUrl=${this.baseImageUrl}
-              .currentWidth=${currentWidth}
-              .currentHeight=${currentHeight}
-              .creatorFilter=${creatorFilter}
-              .suppressBlurring=${this.suppressBlurring}
-              .isManageView=${this.isManageView}
-              ?showInfoButton=${false}
-              @infoButtonPressed=${this.tileInfoButtonPressed}
-            >
-            </search-tile>`;
-          default:
-            return html`<item-tile
-              .model=${model}
-              .collectionPagePath=${collectionPagePath}
-              .currentWidth=${this.currentWidth}
-              .currentHeight=${this.currentHeight}
-              .baseImageUrl=${this.baseImageUrl}
-              .sortParam=${sortParam}
-              .defaultSortParam=${defaultSortParam}
-              .creatorFilter=${creatorFilter}
-              .loggedIn=${this.loggedIn}
-              .suppressBlurring=${this.suppressBlurring}
-              .isManageView=${this.isManageView}
-              .layoutType=${this.layoutType}
-              ?showTvClips=${this.showTvClips}
-              ?showInfoButton=${this.shouldShowInfoButton}
-              ?useLocalTime=${this.useLocalTime}
-              @infoButtonPressed=${this.tileInfoButtonPressed}
-            >
-            </item-tile>`;
-        }
-      case 'list-compact':
-        return html`<tile-list-compact
-          .model=${model}
-          .collectionPagePath=${collectionPagePath}
-          .currentWidth=${currentWidth}
-          .currentHeight=${currentHeight}
-          .baseNavigationUrl=${baseNavigationUrl}
-          .sortParam=${sortParam}
-          .defaultSortParam=${defaultSortParam}
-          .creatorFilter=${creatorFilter}
-          .mobileBreakpoint=${mobileBreakpoint}
-          .baseImageUrl=${this.baseImageUrl}
-          .loggedIn=${this.loggedIn}
-          .suppressBlurring=${this.suppressBlurring}
-          .tileActions=${this.isManageView ? [] : this.tileActions}
-          ?useLocalTime=${this.useLocalTime}
-        >
-        </tile-list-compact>`;
-      case 'list-detail':
-        return html`<tile-list
-          .model=${model}
-          .collectionPagePath=${collectionPagePath}
-          .collectionTitles=${this.collectionTitles}
-          .currentWidth=${currentWidth}
-          .currentHeight=${currentHeight}
-          .baseNavigationUrl=${baseNavigationUrl}
-          .sortParam=${sortParam}
-          .defaultSortParam=${defaultSortParam}
-          .creatorFilter=${creatorFilter}
-          .mobileBreakpoint=${mobileBreakpoint}
-          .baseImageUrl=${this.baseImageUrl}
-          .loggedIn=${this.loggedIn}
-          .suppressBlurring=${this.suppressBlurring}
-          .tileActions=${this.isManageView ? [] : this.tileActions}
-          ?useLocalTime=${this.useLocalTime}
-        >
-        </tile-list>`;
-      default:
-        return nothing;
-    }
-  }
-
-  static get styles() {
-    return [
-      srOnlyStyle,
-      tileActionStyles,
-      css`
-        :host {
-          display: block;
-          height: 100%;
-        }
-
-        collection-tile {
-          --tileBorderColor: #555555;
-          --tileBackgroundColor: #666666;
-          --imageBlockBackgroundColor: #666666;
-        }
-
-        account-tile {
-          --tileBorderColor: #dddddd;
-          --imageBlockBackgroundColor: #fcf5e6;
-        }
-
-        item-tile {
-          --tileBorderColor: #dddddd;
-          --imageBlockBackgroundColor: #f1f1f4;
-        }
-
-        search-tile {
-          --tileBorderColor: #555555;
-          --tileBackgroundColor: #666666;
-          --imageBlockBackgroundColor: #666666;
-          --iconFillColor: #2c2c2c;
-        }
-
-        #container {
-          position: relative;
-          height: 100%;
-          border-radius: 4px;
-        }
-
-        /*
-         * When tile actions are present, the container takes on the role of
-         * the tile's visual card so the tile content and action row appear
-         * as a single unified element. The inner tile's own shadow/radius
-         * are disabled via CSS variable overrides to avoid visual
-         * duplication, and the action row sits as a footer inside the same
-         * card.
-         */
-        #container.has-tile-actions {
-          display: flex;
-          flex-direction: column;
-          overflow: hidden;
-          box-shadow: var(--tileShadow, 1px 1px 2px 0);
-          --tileBoxShadow: none;
-          --tileCornerRadius: 0;
-        }
-
-        #container.has-tile-actions .tile-link {
-          flex: 1;
-          min-height: 0;
-          overflow: hidden;
-          border-radius: 0;
-        }
-
-        /* Normal hover shadow lives on the inner anchor for plain tiles */
-        #container.hoverable:not(.has-tile-actions) a:focus,
-        #container.hoverable:not(.has-tile-actions) a:hover {
-          box-shadow: var(
-            --tileHoverBoxShadow,
-            0 0 6px 2px rgba(8, 8, 32, 0.8)
-          );
-          transition: box-shadow 0.1s ease;
-        }
-
-        /*
-         * When the container owns the card visuals, the hover shadow needs
-         * to move up to the container so it wraps the action row too.
-         */
-        #container.hoverable.has-tile-actions:hover {
-          box-shadow: var(
-            --tileHoverBoxShadow,
-            0 0 6px 2px rgba(8, 8, 32, 0.8)
-          );
-          transition: box-shadow 0.1s ease;
-        }
-
-        a {
-          display: block;
-          height: 100%;
-          color: unset;
-          text-decoration: none;
-          transition: transform 0.05s ease;
-          border-radius: 4px;
-          outline: none;
-        }
-
-        a :first-child {
-          display: block;
-          height: 100%;
-        }
-
-        .manage-check {
-          position: absolute;
-          right: 0;
-          top: 0;
-          border: 5px solid #2c2c2c;
-          border-radius: 3px;
-          background-color: #2c2c2c;
-          z-index: 1;
-        }
-
-        .manage-check > input[type='checkbox'] {
-          display: block;
-          margin: 0;
-        }
-
-        #touch-backdrop {
-          position: fixed;
-          width: 100vw;
-          height: 100vh;
-          top: 0;
-          left: 0;
-          z-index: 2;
-          background: transparent;
-        }
-
-        tile-hover-pane {
-          position: absolute;
-          top: 0;
-          left: -9999px;
-          z-index: 2;
-        }
-
-        /*
-         * Grid-mode action row sits flush against the bottom of the card —
-         * the buttons' own borders form the visible bottom edge. The outer
-         * buttons get rounded bottom corners to match the container so the
-         * red border traces cleanly around the card's bottom corners.
-         */
-        .grid-tile-actions .tile-action-btn:first-child {
-          border-bottom-left-radius: 4px;
-        }
-
-        .grid-tile-actions .tile-action-btn:last-child {
-          border-bottom-right-radius: 4px;
-        }
-      `,
-    ];
-  }
-}