@internetarchive/collection-browser 4.3.2-rc-webdev-8334.3 → 4.4.0

package/src/tiles/item-image.ts

@@ -1,187 +1,214 @@
-import { css, CSSResultGroup, html, LitElement, nothing } from 'lit';
-import { customElement, property, query, state } from 'lit/decorators.js';
-import { ClassInfo, classMap } from 'lit/directives/class-map.js';
-
-import type { TileModel } from '../models';
-
-import {
-  baseItemImageStyles,
-  waveformGradientStyles,
-} from '../styles/item-image-styles';
-import { searchIcon } from '../assets/img/icons/mediatype/search';
-
-@customElement('item-image')
-export class ItemImage extends LitElement {
-  @property({ type: Object }) model?: TileModel;
-
-  @property({ type: String }) baseImageUrl?: string;
-
-  @property({ type: Boolean }) isListTile = false;
-
-  @property({ type: Boolean }) isCompactTile = false;
-
-  @property({ type: Boolean }) loggedIn = false;
-
-  @property({ type: Boolean }) suppressBlurring = false;
-
-  @state() private isWaveform = false;
-
-  @state() private isNotFound = false;
-
-  @query('img') private baseImage!: HTMLImageElement;
-
-  render() {
-    return html`
-      <div class=${classMap(this.itemBaseClass)}>${this.imageTemplate}</div>
-    `;
-  }
-
-  private get imageTemplate() {
-    if (this.model?.mediatype === 'search') {
-      return html`${searchIcon}`;
-    }
-
-    return html`
-      <img
-        class=${classMap(this.itemImageClass)}
-        src="${this.imageSrc}"
-        alt=""
-        @load=${this.onLoad}
-        @error=${this.onError}
-      />
-    `;
-  }
-
-  /**
-   * Helpers
-   */
-  private get imageSrc() {
-    if (this.isNotFound) return this.notFoundSrc;
-
-    // Use the correct image for web capture tiles, if possible
-    if (this.model?.captureDates && this.model.identifier) {
-      try {
-        const url = new URL(this.model.identifier);
-        const domain = encodeURIComponent(url.hostname);
-        return this.baseImageUrl
-          ? `https://web.archive.org/thumb/${domain}?generate=1`
-          : nothing;
-      } catch {
-        return `${this.baseImageUrl}/images/notfound.png`;
-      }
-    }
-
-    // Use the thumbnail URL specified in the model if it exists
-    if (this.model?.thumbnailUrl) return this.model.thumbnailUrl;
-
-    // Don't try to load invalid image URLs
-    return this.baseImageUrl && this.model?.identifier
-      ? `${this.baseImageUrl}/services/img/${this.model.identifier}`
-      : nothing;
-  }
-
-  private get notFoundSrc() {
-    return this.baseImageUrl
-      ? `${this.baseImageUrl}/images/notfound.png`
-      : nothing;
-  }
-
-  private get hashBasedGradient() {
-    if (!this.model?.identifier) {
-      return 'waveform-grad0';
-    }
-    const gradient = this.hashStrToInt(this.model.identifier) % 6; // returns 0-5
-    return `waveform-grad${gradient}`;
-  }
-
-  private hashStrToInt(str: string): number {
-    return str
-      .split('')
-      .reduce((acc: number, char: string) => acc + char.charCodeAt(0), 0);
-  }
-
-  /**
-   * Classes
-   */
-  private get itemBaseClass(): ClassInfo {
-    return {
-      'drop-shadow': true,
-      'list-box': this.isListTile,
-      'search-image': this.model?.mediatype === 'search',
-      [this.hashBasedGradient]: this.isWaveform,
-    };
-  }
-
-  private get itemImageClass(): ClassInfo {
-    const hasSensitiveContent = !!(
-      this.model?.contentWarning || this.model?.loginRequired
-    );
-    const shouldBlur = hasSensitiveContent && !this.suppressBlurring;
-
-    return {
-      contain: !this.isCompactTile && !this.isWaveform,
-      cover: this.isCompactTile,
-      blur: shouldBlur,
-      waveform: this.isWaveform,
-      'account-image': this.isAccountImage, // for account tile image
-      'collection-image': this.model?.mediatype === 'collection', // for collection tile image
-    };
-  }
-
-  /**
-   * Helper function to determine if account tile image
-   */
-  private get isAccountImage() {
-    return (
-      this.model?.mediatype === 'account' &&
-      !this.isCompactTile &&
-      !this.isListTile
-    );
-  }
-
-  /**
-   * Event listener sets isWaveform true if image is waveform
-   */
-  private onLoad() {
-    if (
-      (this.model?.mediatype === 'audio' ||
-        this.model?.mediatype === 'etree') &&
-      this.baseImage.naturalWidth / this.baseImage.naturalHeight === 4
-    ) {
-      this.isWaveform = true;
-    }
-  }
-
-  private onError() {
-    this.isNotFound = true;
-  }
-
-  /**
-   * CSS
-   */
-  static get styles(): CSSResultGroup {
-    return [
-      baseItemImageStyles,
-      waveformGradientStyles,
-      css`
-        img {
-          height: var(--imgHeight, 16rem);
-          width: var(--imgWidth, 16rem);
-        }
-
-        .search-image {
-          display: flex;
-          align-items: center;
-          justify-content: center;
-          background: rgb(245, 245, 247);
-          border-radius: 4px;
-        }
-
-        svg {
-          height: 10rem;
-          width: 10rem;
-        }
-      `,
-    ];
-  }
-}
+import {
+  css,
+  CSSResultGroup,
+  html,
+  LitElement,
+  nothing,
+  PropertyValues,
+} from 'lit';
+import { customElement, property, query, state } from 'lit/decorators.js';
+import { ClassInfo, classMap } from 'lit/directives/class-map.js';
+
+import type { TileModel } from '../models';
+
+import {
+  baseItemImageStyles,
+  waveformGradientStyles,
+} from '../styles/item-image-styles';
+import { searchIcon } from '../assets/img/icons/mediatype/search';
+
+@customElement('item-image')
+export class ItemImage extends LitElement {
+  /**
+   * Map to cache which identifiers have waveform-style thumbnails, so that
+   * they can have their waveform styling applied immediately, rather than
+   * waiting for the image content to load before applying it (which can
+   * cause noticeable flicker when such tiles refresh).
+   */
+  private static readonly waveformByIdentifier = new Map<string, boolean>();
+
+  @property({ type: Object }) model?: TileModel;
+
+  @property({ type: String }) baseImageUrl?: string;
+
+  @property({ type: Boolean }) isListTile = false;
+
+  @property({ type: Boolean }) isCompactTile = false;
+
+  @property({ type: Boolean }) loggedIn = false;
+
+  @property({ type: Boolean }) suppressBlurring = false;
+
+  @state() private isWaveform = false;
+
+  @state() private isNotFound = false;
+
+  @query('img') private baseImage!: HTMLImageElement;
+
+  protected willUpdate(changed: PropertyValues): void {
+    if (changed.has('model')) {
+      // If this identifier is known to have a waveform image, then set isWaveform upfront
+      const identifier = this.model?.identifier;
+      this.isWaveform =
+        ItemImage.waveformByIdentifier.get(identifier as string) === true;
+    }
+  }
+
+  render() {
+    return html`
+      <div class=${classMap(this.itemBaseClass)}>${this.imageTemplate}</div>
+    `;
+  }
+
+  private get imageTemplate() {
+    if (this.model?.mediatype === 'search') {
+      return html`${searchIcon}`;
+    }
+
+    return html`
+      <img
+        class=${classMap(this.itemImageClass)}
+        src="${this.imageSrc}"
+        alt=""
+        @load=${this.onLoad}
+        @error=${this.onError}
+      />
+    `;
+  }
+
+  /**
+   * Helpers
+   */
+  private get imageSrc() {
+    if (this.isNotFound) return this.notFoundSrc;
+
+    // Use the correct image for web capture tiles, if possible
+    if (this.model?.captureDates && this.model.identifier) {
+      try {
+        const url = new URL(this.model.identifier);
+        const domain = encodeURIComponent(url.hostname);
+        return this.baseImageUrl
+          ? `https://web.archive.org/thumb/${domain}?generate=1`
+          : nothing;
+      } catch {
+        return `${this.baseImageUrl}/images/notfound.png`;
+      }
+    }
+
+    // Use the thumbnail URL specified in the model if it exists
+    if (this.model?.thumbnailUrl) return this.model.thumbnailUrl;
+
+    // Don't try to load invalid image URLs
+    return this.baseImageUrl && this.model?.identifier
+      ? `${this.baseImageUrl}/services/img/${this.model.identifier}`
+      : nothing;
+  }
+
+  private get notFoundSrc() {
+    return this.baseImageUrl
+      ? `${this.baseImageUrl}/images/notfound.png`
+      : nothing;
+  }
+
+  private get hashBasedGradient() {
+    if (!this.model?.identifier) {
+      return 'waveform-grad0';
+    }
+    const gradient = this.hashStrToInt(this.model.identifier) % 6; // returns 0-5
+    return `waveform-grad${gradient}`;
+  }
+
+  private hashStrToInt(str: string): number {
+    return str
+      .split('')
+      .reduce((acc: number, char: string) => acc + char.charCodeAt(0), 0);
+  }
+
+  /**
+   * Classes
+   */
+  private get itemBaseClass(): ClassInfo {
+    return {
+      'drop-shadow': true,
+      'list-box': this.isListTile,
+      'search-image': this.model?.mediatype === 'search',
+      [this.hashBasedGradient]: this.isWaveform,
+    };
+  }
+
+  private get itemImageClass(): ClassInfo {
+    const hasSensitiveContent = !!(
+      this.model?.contentWarning || this.model?.loginRequired
+    );
+    const shouldBlur = hasSensitiveContent && !this.suppressBlurring;
+
+    return {
+      contain: !this.isCompactTile && !this.isWaveform,
+      cover: this.isCompactTile,
+      blur: shouldBlur,
+      waveform: this.isWaveform,
+      'account-image': this.isAccountImage, // for account tile image
+      'collection-image': this.model?.mediatype === 'collection', // for collection tile image
+    };
+  }
+
+  /**
+   * Helper function to determine if account tile image
+   */
+  private get isAccountImage() {
+    return (
+      this.model?.mediatype === 'account' &&
+      !this.isCompactTile &&
+      !this.isListTile
+    );
+  }
+
+  /**
+   * Event listener sets isWaveform true if image is waveform
+   */
+  private onLoad() {
+    if (
+      (this.model?.mediatype === 'audio' ||
+        this.model?.mediatype === 'etree') &&
+      this.baseImage.naturalWidth / this.baseImage.naturalHeight === 4
+    ) {
+      this.isWaveform = true;
+      if (this.model?.identifier) {
+        ItemImage.waveformByIdentifier.set(this.model.identifier, true);
+      }
+    }
+  }
+
+  private onError() {
+    this.isNotFound = true;
+  }
+
+  /**
+   * CSS
+   */
+  static get styles(): CSSResultGroup {
+    return [
+      baseItemImageStyles,
+      waveformGradientStyles,
+      css`
+        img {
+          height: var(--imgHeight, 16rem);
+          width: var(--imgWidth, 16rem);
+        }
+
+        .search-image {
+          display: flex;
+          align-items: center;
+          justify-content: center;
+          background: rgb(245, 245, 247);
+          border-radius: 4px;
+        }
+
+        svg {
+          height: 10rem;
+          width: 10rem;
+        }
+      `,
+    ];
+  }
+}

package/tsconfig.json

@@ -1,25 +1,25 @@
-{
-  "compilerOptions": {
-    "target": "esnext",
-    "module": "esnext",
-    "moduleResolution": "bundler",
-    "noEmitOnError": true,
-    "lib": [
-      "ESNext",
-      "dom",
-      "dom.iterable"
-    ],
-    "strict": true,
-    "esModuleInterop": false,
-    "allowSyntheticDefaultImports": true,
-    "experimentalDecorators": true,
-    "importHelpers": true,
-    "outDir": "dist",
-    "sourceMap": true,
-    "inlineSources": true,
-    "rootDir": "./",
-    "declaration": true,
-    "useDefineForClassFields": false,
-  },
-  "include": ["src", "test", "index.ts", "types"],
-}
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "noEmitOnError": true,
+    "lib": [
+      "ESNext",
+      "dom",
+      "dom.iterable"
+    ],
+    "strict": true,
+    "esModuleInterop": false,
+    "allowSyntheticDefaultImports": true,
+    "experimentalDecorators": true,
+    "importHelpers": true,
+    "outDir": "dist",
+    "sourceMap": true,
+    "inlineSources": true,
+    "rootDir": "./",
+    "declaration": true,
+    "useDefineForClassFields": false,
+  },
+  "include": ["src", "test", "index.ts", "types"],
+}

package/web-dev-server.config.mjs

@@ -1,30 +1,30 @@
-// import { hmrPlugin, presets } from '@open-wc/dev-server-hmr';
-
-/** Use Hot Module replacement by adding --hmr to the start command */
-const hmr = process.argv.includes('--hmr');
-
-export default /** @type {import('@web/dev-server').DevServerConfig} */ ({
-  nodeResolve: true,
-  open: '/',
-  watch: !hmr,
-
-  /** Compile JS for older browsers. Requires @web/dev-server-esbuild plugin */
-  // esbuildTarget: 'auto'
-
-  /** Set appIndex to enable SPA routing */
-  // appIndex: 'demo/index.html',
-
-  /** Confgure bare import resolve plugin */
-  // nodeResolve: {
-  //   exportConditions: ['browser', 'development']
-  // },
-
-  plugins: [
-    /** Use Hot Module Replacement by uncommenting. Requires @open-wc/dev-server-hmr plugin */
-    // hmr && hmrPlugin({ exclude: ['**/*/node_modules/**/*'], presets: [presets.litElement] }),
-  ],
-
-  http2: true,
-  sslCert: './local.archive.org.cert',
-  sslKey: './local.archive.org.key',
-});
+// import { hmrPlugin, presets } from '@open-wc/dev-server-hmr';
+
+/** Use Hot Module replacement by adding --hmr to the start command */
+const hmr = process.argv.includes('--hmr');
+
+export default /** @type {import('@web/dev-server').DevServerConfig} */ ({
+  nodeResolve: true,
+  open: '/',
+  watch: !hmr,
+
+  /** Compile JS for older browsers. Requires @web/dev-server-esbuild plugin */
+  // esbuildTarget: 'auto'
+
+  /** Set appIndex to enable SPA routing */
+  // appIndex: 'demo/index.html',
+
+  /** Confgure bare import resolve plugin */
+  // nodeResolve: {
+  //   exportConditions: ['browser', 'development']
+  // },
+
+  plugins: [
+    /** Use Hot Module Replacement by uncommenting. Requires @open-wc/dev-server-hmr plugin */
+    // hmr && hmrPlugin({ exclude: ['**/*/node_modules/**/*'], presets: [presets.litElement] }),
+  ],
+
+  http2: true,
+  sslCert: './local.archive.org.cert',
+  sslKey: './local.archive.org.key',
+});

package/web-test-runner.config.mjs

@@ -1,52 +1,52 @@
-import rollupImage from '@rollup/plugin-image';
-import { rollupAdapter } from '@web/dev-server-rollup';
-// import { playwrightLauncher } from '@web/test-runner-playwright';
-
-const filteredLogs = ['Running in dev mode', 'lit-html is in dev mode'];
-
-export default /** @type {import("@web/test-runner").TestRunnerConfig} */ ({
-  /** Test files to run */
-  files: 'dist/test/**/*.test.js',
-
-  /** Resolve bare module imports */
-  nodeResolve: {
-    exportConditions: ['browser', 'development'],
-  },
-
-  mimeTypes: {
-    '**/*.scss': 'js',
-    '**/*.css': 'js',
-    '**/*.svg': 'js',
-    '**/*.json': 'js',
-  },
-
-  /** Filter out lit dev mode logs */
-  filterBrowserLogs(log) {
-    for (const arg of log.args) {
-      if (typeof arg === 'string' && filteredLogs.some(l => arg.includes(l))) {
-        return false;
-      }
-    }
-    return true;
-  },
-
-  plugins: [rollupAdapter(rollupImage())],
-
-  /** Compile JS for older browsers. Requires @web/dev-server-esbuild plugin */
-  // esbuildTarget: 'auto',
-
-  /** Amount of browsers to run concurrently */
-  // concurrentBrowsers: 2,
-
-  /** Amount of test files per browser to test concurrently */
-  // concurrency: 1,
-
-  /** Browsers to run tests on */
-  // browsers: [
-  //   playwrightLauncher({ product: 'chromium' }),
-  //   playwrightLauncher({ product: 'firefox' }),
-  //   playwrightLauncher({ product: 'webkit' }),
-  // ],
-
-  // See documentation for all available options
-});
+import rollupImage from '@rollup/plugin-image';
+import { rollupAdapter } from '@web/dev-server-rollup';
+// import { playwrightLauncher } from '@web/test-runner-playwright';
+
+const filteredLogs = ['Running in dev mode', 'lit-html is in dev mode'];
+
+export default /** @type {import("@web/test-runner").TestRunnerConfig} */ ({
+  /** Test files to run */
+  files: 'dist/test/**/*.test.js',
+
+  /** Resolve bare module imports */
+  nodeResolve: {
+    exportConditions: ['browser', 'development'],
+  },
+
+  mimeTypes: {
+    '**/*.scss': 'js',
+    '**/*.css': 'js',
+    '**/*.svg': 'js',
+    '**/*.json': 'js',
+  },
+
+  /** Filter out lit dev mode logs */
+  filterBrowserLogs(log) {
+    for (const arg of log.args) {
+      if (typeof arg === 'string' && filteredLogs.some(l => arg.includes(l))) {
+        return false;
+      }
+    }
+    return true;
+  },
+
+  plugins: [rollupAdapter(rollupImage())],
+
+  /** Compile JS for older browsers. Requires @web/dev-server-esbuild plugin */
+  // esbuildTarget: 'auto',
+
+  /** Amount of browsers to run concurrently */
+  // concurrentBrowsers: 2,
+
+  /** Amount of test files per browser to test concurrently */
+  // concurrency: 1,
+
+  /** Browsers to run tests on */
+  // browsers: [
+  //   playwrightLauncher({ product: 'chromium' }),
+  //   playwrightLauncher({ product: 'firefox' }),
+  //   playwrightLauncher({ product: 'webkit' }),
+  // ],
+
+  // See documentation for all available options
+});