@justeattakeaway/pie-thumbnail 0.2.0 → 0.4.0

package/custom-elements.json

@@ -20,13 +20,34 @@
           },
           "default": "[\n    'default', 'outline',\n]"
         },
+        {
+          "kind": "variable",
+          "name": "backgroundColors",
+          "type": {
+            "text": "[\n    'default', 'subtle', 'strong', 'dark', 'inverse', 'inverse-alternative'\n]"
+          },
+          "default": "[\n    'default', 'subtle', 'strong', 'dark', 'inverse', 'inverse-alternative'\n]"
+        },
+        {
+          "kind": "variable",
+          "name": "backgroundColorClassNames",
+          "type": {
+            "text": "Record<typeof backgroundColors[number], string>"
+          },
+          "default": "{\n    default: 'c-thumbnail--backgroundDefault',\n    subtle: 'c-thumbnail--backgroundSubtle',\n    strong: 'c-thumbnail--backgroundStrong',\n    dark: 'c-thumbnail--backgroundDark',\n    inverse: 'c-thumbnail--backgroundInverse',\n    'inverse-alternative': 'c-thumbnail--backgroundInverseAlternative',\n}"
+        },
+        {
+          "kind": "variable",
+          "name": "sizes",
+          "default": "Object.freeze(Array.from(\n    { length: (SIZE_MAX - SIZE_MIN) / SIZE_INCREMENT_BY + 1 },\n    (_, i) => SIZE_MIN + i * SIZE_INCREMENT_BY,\n))"
+        },
         {
           "kind": "variable",
           "name": "defaultProps",
           "type": {
             "text": "DefaultProps"
           },
-          "default": "{\n    variant: 'default',\n    src: '',\n    alt: '',\n}"
+          "default": "{\n    variant: 'default',\n    size: 48,\n    src: '',\n    alt: '',\n    disabled: false,\n    hasPadding: false,\n    backgroundColor: 'default',\n    placeholder: {\n        src: '',\n        alt: '',\n    },\n}"
         }
       ],
       "exports": [
@@ -38,6 +59,30 @@
             "module": "src/defs.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "backgroundColors",
+          "declaration": {
+            "name": "backgroundColors",
+            "module": "src/defs.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "backgroundColorClassNames",
+          "declaration": {
+            "name": "backgroundColorClassNames",
+            "module": "src/defs.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "sizes",
+          "declaration": {
+            "name": "sizes",
+            "module": "src/defs.js"
+          }
+        },
         {
           "kind": "js",
           "name": "defaultProps",
@@ -63,6 +108,12 @@
               "privacy": "public",
               "attribute": "variant"
             },
+            {
+              "kind": "field",
+              "name": "size",
+              "privacy": "public",
+              "attribute": "size"
+            },
             {
               "kind": "field",
               "name": "src",
@@ -74,6 +125,63 @@
               "name": "alt",
               "privacy": "public",
               "attribute": "alt"
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "privacy": "public",
+              "attribute": "disabled"
+            },
+            {
+              "kind": "field",
+              "name": "hasPadding",
+              "privacy": "public",
+              "attribute": "hasPadding"
+            },
+            {
+              "kind": "field",
+              "name": "backgroundColor",
+              "privacy": "public",
+              "attribute": "backgroundColor"
+            },
+            {
+              "kind": "field",
+              "name": "placeholder",
+              "type": {
+                "text": "ThumbnailProps['placeholder']"
+              },
+              "privacy": "public",
+              "attribute": "placeholder"
+            },
+            {
+              "kind": "field",
+              "name": "img",
+              "type": {
+                "text": "HTMLImageElement"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_generateSizeStyles",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_handleImageError",
+              "privacy": "private",
+              "description": "Handles image load errors by replacing the src and alt props\nwith the placeholder props."
+            },
+            {
+              "kind": "method",
+              "name": "_checkImageError",
+              "privacy": "private",
+              "description": "Detects image load status and applies the placeholder on failure.\nThis is needed as the `onerror` event is not triggered in SSR."
             }
           ],
           "attributes": [
@@ -81,6 +189,10 @@
               "name": "variant",
               "fieldName": "variant"
             },
+            {
+              "name": "size",
+              "fieldName": "size"
+            },
             {
               "name": "src",
               "fieldName": "src"
@@ -88,6 +200,25 @@
             {
               "name": "alt",
               "fieldName": "alt"
+            },
+            {
+              "name": "disabled",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "hasPadding",
+              "fieldName": "hasPadding"
+            },
+            {
+              "name": "backgroundColor",
+              "fieldName": "backgroundColor"
+            },
+            {
+              "name": "placeholder",
+              "type": {
+                "text": "ThumbnailProps['placeholder']"
+              },
+              "fieldName": "placeholder"
             }
           ],
           "superclass": {

package/dist/index.d.ts

@@ -3,7 +3,11 @@ import type { CSSResult } from 'lit';
 import type { LitElement } from 'lit';
 import type { TemplateResult } from 'lit-html';
 
-export declare type DefaultProps = ComponentDefaultProps<ThumbnailProps, 'variant' | 'src' | 'alt'>;
+export declare const backgroundColorClassNames: Record<typeof backgroundColors[number], string>;
+
+export declare const backgroundColors: readonly ["default", "subtle", "strong", "dark", "inverse", "inverse-alternative"];
+
+export declare type DefaultProps = ComponentDefaultProps<ThumbnailProps>;
 
 export declare const defaultProps: DefaultProps;
 
@@ -12,16 +16,70 @@ export declare const defaultProps: DefaultProps;
  */
 export declare class PieThumbnail extends LitElement implements ThumbnailProps {
     variant: "default" | "outline";
+    size: number;
     src: string;
     alt: string;
+    disabled: boolean;
+    hasPadding: boolean;
+    backgroundColor: "default" | "subtle" | "strong" | "dark" | "inverse" | "inverse-alternative";
+    placeholder: ThumbnailProps['placeholder'];
+    private img;
+    private _generateSizeStyles;
+    /**
+     * Handles image load errors by replacing the src and alt props
+     * with the placeholder props.
+     */
+    private _handleImageError;
+    /**
+     * Detects image load status and applies the placeholder on failure.
+     * This is needed as the `onerror` event is not triggered in SSR.
+     */
+    private _checkImageError;
+    protected firstUpdated(): void;
     render(): TemplateResult<1>;
     static styles: CSSResult;
 }
 
+declare type PlaceholderProps = {
+    src?: string;
+    alt?: string;
+};
+
+export declare const sizes: readonly number[];
+
 export declare interface ThumbnailProps {
+    /**
+     * What style variant the thumbnail should be such as default or outline.
+     */
     variant?: typeof variants[number];
+    /**
+     * Specify the size as a number between 24 and 128 (inclusive) and a multiple of 8.
+     */
+    size?: typeof sizes[number];
+    /**
+     * The src attribute for the underlying image tag.
+     */
     src?: string;
+    /**
+     * The alt attribute for the underlying image tag.
+     */
     alt?: string;
+    /**
+     * When true, the disabled styles are applied.
+     */
+    disabled?: boolean;
+    /**
+     * When true, an extra spacing around the thumbnail container is applied.
+     */
+    hasPadding?: boolean;
+    /**
+     * What background color the thumbnail should be.
+     */
+    backgroundColor?: typeof backgroundColors[number];
+    /**
+     * What placeholder should be used when the image fails to load.
+     */
+    placeholder?: PlaceholderProps;
 }
 
 export declare const variants: readonly ["default", "outline"];

package/dist/index.js

@@ -1,55 +1,146 @@
-import { LitElement as m, html as h, unsafeCSS as p } from "lit";
-import { validPropertyValues as v, defineCustomElement as f } from "@justeattakeaway/pie-webc-core";
-import { classMap as g } from "lit/directives/class-map.js";
-import { property as n } from "lit/decorators.js";
-const y = [
+import { LitElement as f, html as y, unsafeCSS as k } from "lit";
+import { validPropertyValues as b, defineCustomElement as S } from "@justeattakeaway/pie-webc-core";
+import { classMap as z } from "lit/directives/class-map.js";
+import { property as o, query as _ } from "lit/decorators.js";
+const C = [
   "default",
   "outline"
-], e = {
+], E = [
+  "default",
+  "subtle",
+  "strong",
+  "dark",
+  "inverse",
+  "inverse-alternative"
+], I = {
+  default: "c-thumbnail--backgroundDefault",
+  subtle: "c-thumbnail--backgroundSubtle",
+  strong: "c-thumbnail--backgroundStrong",
+  dark: "c-thumbnail--backgroundDark",
+  inverse: "c-thumbnail--backgroundInverse",
+  "inverse-alternative": "c-thumbnail--backgroundInverseAlternative"
+}, m = 8, g = 24, x = 128, $ = Object.freeze(Array.from(
+  { length: (x - g) / m + 1 },
+  (c, t) => g + t * m
+)), e = {
   variant: "default",
+  size: 48,
   src: "",
-  alt: ""
-}, S = ".c-thumbnail{--thumbnail-size: var(--dt-spacing-g);--thumbnail-border-radius: var(--dt-radius-rounded-b);--thumbnail-bg-color: var(--dt-color-container-default);--thumbnail-border-color: transparent;box-sizing:border-box;overflow:hidden;width:var(--thumbnail-size);height:var(--thumbnail-size);border-radius:var(--thumbnail-border-radius);border:1px solid var(--thumbnail-border-color);background-color:var(--thumbnail-bg-color)}.c-thumbnail.c-thumbnail--outline{--thumbnail-border-color: var(--dt-color-border-default)}.c-thumbnail .c-thumbnail-img{width:100%;height:100%;object-fit:contain;display:block}";
-var x = Object.defineProperty, l = (d, a, i, u) => {
-  for (var t = void 0, o = d.length - 1, c; o >= 0; o--)
-    (c = d[o]) && (t = c(a, i, t) || t);
-  return t && x(a, i, t), t;
+  alt: "",
+  disabled: !1,
+  hasPadding: !1,
+  backgroundColor: "default",
+  placeholder: {
+    src: "",
+    alt: ""
+  }
+}, P = ".c-thumbnail{--thumbnail-size: 48px;--thumbnail-border-radius: var(--dt-radius-rounded-b);--thumbnail-bg-color: var(--dt-color-container-default);--thumbnail-border-color: transparent;--thumbnail-padding: calc(var(--dt-spacing-a) / 2);display:flex;justify-content:center;align-items:center;box-sizing:border-box;overflow:hidden;width:var(--thumbnail-size);height:var(--thumbnail-size);border-radius:var(--thumbnail-border-radius);border:1px solid var(--thumbnail-border-color);background-color:var(--thumbnail-bg-color)}.c-thumbnail.c-thumbnail--outline{--thumbnail-border-color: var(--dt-color-border-default)}.c-thumbnail.c-thumbnail--disabled{opacity:.5}.c-thumbnail.c-thumbnail--backgroundSubtle{--thumbnail-bg-color: var(--dt-color-container-subtle)}.c-thumbnail.c-thumbnail--backgroundStrong{--thumbnail-bg-color: var(--dt-color-container-strong)}.c-thumbnail.c-thumbnail--backgroundDark{--thumbnail-bg-color: var(--dt-color-container-dark)}.c-thumbnail.c-thumbnail--backgroundInverse{--thumbnail-bg-color: var(--dt-color-container-inverse)}.c-thumbnail.c-thumbnail--backgroundInverseAlternative{--thumbnail-bg-color: var(--dt-color-container-inverse-alternative)}.c-thumbnail.c-thumbnail--padding{padding:var(--thumbnail-padding)}.c-thumbnail .c-thumbnail-img{width:100%;height:auto}";
+var A = Object.defineProperty, i = (c, t, r, u) => {
+  for (var n = void 0, l = c.length - 1, s; l >= 0; l--)
+    (s = c[l]) && (n = s(t, r, n) || n);
+  return n && A(t, r, n), n;
 };
-const b = "pie-thumbnail", s = class s extends m {
+const d = "pie-thumbnail", h = class h extends f {
   constructor() {
-    super(...arguments), this.variant = e.variant, this.src = e.src, this.alt = e.alt;
+    super(...arguments), this.variant = e.variant, this.size = e.size, this.src = e.src, this.alt = e.alt, this.disabled = e.disabled, this.hasPadding = e.hasPadding, this.backgroundColor = e.backgroundColor, this.placeholder = e.placeholder;
+  }
+  _generateSizeStyles() {
+    const { size: t } = this;
+    let r = "--dt-radius-rounded-c";
+    return t <= 40 ? r = "--dt-radius-rounded-a" : t <= 56 && (r = "--dt-radius-rounded-b"), `
+            --thumbnail-size: ${t}px;
+            --thumbnail-border-radius: var(${r});
+        `;
+  }
+  /**
+   * Handles image load errors by replacing the src and alt props
+   * with the placeholder props.
+   */
+  _handleImageError() {
+    var t, r;
+    (t = this.placeholder) != null && t.src && this.setAttribute("src", this.placeholder.src), (r = this.placeholder) != null && r.alt && this.setAttribute("alt", this.placeholder.alt);
+  }
+  /**
+   * Detects image load status and applies the placeholder on failure.
+   * This is needed as the `onerror` event is not triggered in SSR.
+   */
+  _checkImageError() {
+    if (this.img) {
+      const { complete: t, naturalHeight: r } = this.img;
+      t && r === 0 && this._handleImageError.call(this);
+    }
+  }
+  firstUpdated() {
+    this._checkImageError();
   }
   render() {
     const {
-      variant: a,
-      src: i,
-      alt: u
-    } = this, t = {
+      variant: t,
+      src: r,
+      alt: u,
+      disabled: n,
+      hasPadding: l,
+      backgroundColor: s
+    } = this, p = {
       "c-thumbnail": !0,
-      [`c-thumbnail--${a}`]: !0
-    };
-    return h`
-            <div data-test-id="pie-thumbnail" class="${g(t)}">
-                <img data-test-id="pie-thumbnail-img" src="${i}" class="c-thumbnail-img" alt="${u}">
+      [`c-thumbnail--${t}`]: !0,
+      [I[s]]: !0,
+      "c-thumbnail--disabled": n,
+      "c-thumbnail--padding": l
+    }, v = this._generateSizeStyles();
+    return y`
+            <div data-test-id="pie-thumbnail"
+             class="${z(p)}"
+             style="${v}">
+                <img
+                    data-test-id="pie-thumbnail-img"
+                    src="${r}"
+                    class="c-thumbnail-img"
+                    alt="${u}"
+                    @error="${this._handleImageError}"
+                />
             </div>
         `;
   }
 };
-s.styles = p(S);
-let r = s;
-l([
-  n({ type: String }),
-  v(b, y, e.variant)
-], r.prototype, "variant");
-l([
-  n({ type: String })
-], r.prototype, "src");
-l([
-  n({ type: String })
-], r.prototype, "alt");
-f(b, r);
+h.styles = k(P);
+let a = h;
+i([
+  o({ type: String }),
+  b(d, C, e.variant)
+], a.prototype, "variant");
+i([
+  o({ type: Number }),
+  b(d, $, e.size)
+], a.prototype, "size");
+i([
+  o({ type: String })
+], a.prototype, "src");
+i([
+  o({ type: String })
+], a.prototype, "alt");
+i([
+  o({ type: Boolean })
+], a.prototype, "disabled");
+i([
+  o({ type: Boolean })
+], a.prototype, "hasPadding");
+i([
+  o({ type: String }),
+  b(d, E, e.backgroundColor)
+], a.prototype, "backgroundColor");
+i([
+  o({ type: Object })
+], a.prototype, "placeholder");
+i([
+  _("img")
+], a.prototype, "img");
+S(d, a);
 export {
-  r as PieThumbnail,
+  a as PieThumbnail,
+  I as backgroundColorClassNames,
+  E as backgroundColors,
   e as defaultProps,
-  y as variants
+  $ as sizes,
+  C as variants
 };

package/dist/react.d.ts

@@ -4,7 +4,11 @@ import type { LitElement } from 'lit';
 import * as React_2 from 'react';
 import type { TemplateResult } from 'lit-html';
 
-export declare type DefaultProps = ComponentDefaultProps<ThumbnailProps, 'variant' | 'src' | 'alt'>;
+export declare const backgroundColorClassNames: Record<typeof backgroundColors[number], string>;
+
+export declare const backgroundColors: readonly ["default", "subtle", "strong", "dark", "inverse", "inverse-alternative"];
+
+export declare type DefaultProps = ComponentDefaultProps<ThumbnailProps>;
 
 export declare const defaultProps: DefaultProps;
 
@@ -15,18 +19,72 @@ export declare const PieThumbnail: React_2.ForwardRefExoticComponent<ThumbnailPr
  */
 declare class PieThumbnail_2 extends LitElement implements ThumbnailProps {
     variant: "default" | "outline";
+    size: number;
     src: string;
     alt: string;
+    disabled: boolean;
+    hasPadding: boolean;
+    backgroundColor: "default" | "subtle" | "strong" | "dark" | "inverse" | "inverse-alternative";
+    placeholder: ThumbnailProps['placeholder'];
+    private img;
+    private _generateSizeStyles;
+    /**
+     * Handles image load errors by replacing the src and alt props
+     * with the placeholder props.
+     */
+    private _handleImageError;
+    /**
+     * Detects image load status and applies the placeholder on failure.
+     * This is needed as the `onerror` event is not triggered in SSR.
+     */
+    private _checkImageError;
+    protected firstUpdated(): void;
     render(): TemplateResult<1>;
     static styles: CSSResult;
 }
 
+declare type PlaceholderProps = {
+    src?: string;
+    alt?: string;
+};
+
 declare type ReactBaseType = React_2.HTMLAttributes<HTMLElement>;
 
+export declare const sizes: readonly number[];
+
 export declare interface ThumbnailProps {
+    /**
+     * What style variant the thumbnail should be such as default or outline.
+     */
     variant?: typeof variants[number];
+    /**
+     * Specify the size as a number between 24 and 128 (inclusive) and a multiple of 8.
+     */
+    size?: typeof sizes[number];
+    /**
+     * The src attribute for the underlying image tag.
+     */
     src?: string;
+    /**
+     * The alt attribute for the underlying image tag.
+     */
     alt?: string;
+    /**
+     * When true, the disabled styles are applied.
+     */
+    disabled?: boolean;
+    /**
+     * When true, an extra spacing around the thumbnail container is applied.
+     */
+    hasPadding?: boolean;
+    /**
+     * What background color the thumbnail should be.
+     */
+    backgroundColor?: typeof backgroundColors[number];
+    /**
+     * What placeholder should be used when the image fails to load.
+     */
+    placeholder?: PlaceholderProps;
 }
 
 export declare const variants: readonly ["default", "outline"];

package/dist/react.js

@@ -1,16 +1,19 @@
-import * as e from "react";
-import { createComponent as a } from "@lit/react";
-import { PieThumbnail as t } from "./index.js";
-import { defaultProps as s, variants as p } from "./index.js";
-const i = a({
+import * as a from "react";
+import { createComponent as e } from "@lit/react";
+import { PieThumbnail as o } from "./index.js";
+import { backgroundColorClassNames as l, backgroundColors as p, defaultProps as u, sizes as b, variants as c } from "./index.js";
+const i = e({
   displayName: "PieThumbnail",
-  elementClass: t,
-  react: e,
+  elementClass: o,
+  react: a,
   tagName: "pie-thumbnail",
   events: {}
-}), n = i;
+}), r = i;
 export {
-  n as PieThumbnail,
-  s as defaultProps,
-  p as variants
+  r as PieThumbnail,
+  l as backgroundColorClassNames,
+  p as backgroundColors,
+  u as defaultProps,
+  b as sizes,
+  c as variants
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@justeattakeaway/pie-thumbnail",
   "description": "PIE Design System Thumbnail built using Web Components",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -36,7 +36,7 @@
   "devDependencies": {
     "@custom-elements-manifest/analyzer": "0.9.0",
     "@justeattakeaway/pie-components-config": "0.18.0",
-    "@justeattakeaway/pie-css": "0.14.0",
+    "@justeattakeaway/pie-css": "0.14.1",
     "cem-plugin-module-file-extensions": "0.0.5"
   },
   "dependencies": {

package/src/defs.ts

@@ -4,16 +4,80 @@ export const variants = [
     'default', 'outline',
 ] as const;
 
+export const backgroundColors = [
+    'default', 'subtle', 'strong', 'dark', 'inverse', 'inverse-alternative'
+] as const;
+
+export const backgroundColorClassNames: Record<typeof backgroundColors[number], string> = {
+    default: 'c-thumbnail--backgroundDefault',
+    subtle: 'c-thumbnail--backgroundSubtle',
+    strong: 'c-thumbnail--backgroundStrong',
+    dark: 'c-thumbnail--backgroundDark',
+    inverse: 'c-thumbnail--backgroundInverse',
+    'inverse-alternative': 'c-thumbnail--backgroundInverseAlternative',
+};
+
+const SIZE_INCREMENT_BY = 8;
+const SIZE_MIN = 24;
+const SIZE_MAX = 128;
+
+export const sizes = Object.freeze(Array.from(
+    { length: (SIZE_MAX - SIZE_MIN) / SIZE_INCREMENT_BY + 1 },
+    (_, i) => SIZE_MIN + i * SIZE_INCREMENT_BY,
+)) as readonly number[];
+
+type PlaceholderProps = {
+    src?: string;
+    alt?: string;
+}
+
 export interface ThumbnailProps {
+    /**
+     * What style variant the thumbnail should be such as default or outline.
+     */
     variant?: typeof variants[number];
+    /**
+     * Specify the size as a number between 24 and 128 (inclusive) and a multiple of 8.
+     */
+    size?: typeof sizes[number];
+    /**
+     * The src attribute for the underlying image tag.
+     */
     src?: string;
+    /**
+     * The alt attribute for the underlying image tag.
+     */
     alt?: string;
+    /**
+     * When true, the disabled styles are applied.
+     */
+    disabled?: boolean;
+    /**
+     * When true, an extra spacing around the thumbnail container is applied.
+     */
+    hasPadding?: boolean;
+    /**
+     * What background color the thumbnail should be.
+     */
+    backgroundColor?: typeof backgroundColors[number];
+    /**
+     * What placeholder should be used when the image fails to load.
+     */
+    placeholder?: PlaceholderProps;
 }
 
-export type DefaultProps = ComponentDefaultProps<ThumbnailProps, 'variant' | 'src' | 'alt'>;
+export type DefaultProps = ComponentDefaultProps<ThumbnailProps>;
 
 export const defaultProps: DefaultProps = {
     variant: 'default',
+    size: 48,
     src: '',
     alt: '',
+    disabled: false,
+    hasPadding: false,
+    backgroundColor: 'default',
+    placeholder: {
+        src: '',
+        alt: '',
+    },
 };

package/src/index.ts

@@ -1,11 +1,19 @@
 import {
-    LitElement, html, unsafeCSS,
+    LitElement,
+    html,
+    unsafeCSS,
 } from 'lit';
-
 import { defineCustomElement, validPropertyValues } from '@justeattakeaway/pie-webc-core';
 import { classMap } from 'lit/directives/class-map.js';
-import { property } from 'lit/decorators.js';
-import { type ThumbnailProps, defaultProps, variants } from './defs';
+import { property, query } from 'lit/decorators.js';
+import {
+    type ThumbnailProps,
+    defaultProps,
+    variants,
+    backgroundColors,
+    backgroundColorClassNames,
+    sizes,
+} from './defs';
 import styles from './thumbnail.scss?inline';
 
 // Valid values available to consumers
@@ -21,27 +29,103 @@ export class PieThumbnail extends LitElement implements ThumbnailProps {
     @validPropertyValues(componentSelector, variants, defaultProps.variant)
     public variant = defaultProps.variant;
 
+    @property({ type: Number })
+    @validPropertyValues(componentSelector, sizes, defaultProps.size)
+    public size = defaultProps.size;
+
     @property({ type: String })
     public src = defaultProps.src;
 
     @property({ type: String })
     public alt = defaultProps.alt;
 
+    @property({ type: Boolean })
+    public disabled = defaultProps.disabled;
+
+    @property({ type: Boolean })
+    public hasPadding = defaultProps.hasPadding;
+
+    @property({ type: String })
+    @validPropertyValues(componentSelector, backgroundColors, defaultProps.backgroundColor)
+    public backgroundColor = defaultProps.backgroundColor;
+
+    @property({ type: Object })
+    public placeholder: ThumbnailProps['placeholder'] = defaultProps.placeholder;
+
+    @query('img')
+    private img!: HTMLImageElement;
+
+    private _generateSizeStyles (): string {
+        const { size } = this;
+        let borderRadius = '--dt-radius-rounded-c';
+        if (size <= 40) {
+            borderRadius = '--dt-radius-rounded-a';
+        } else if (size <= 56) {
+            borderRadius = '--dt-radius-rounded-b';
+        }
+
+        return `
+            --thumbnail-size: ${size}px;
+            --thumbnail-border-radius: var(${borderRadius});
+        `;
+    }
+
+    /**
+     * Handles image load errors by replacing the src and alt props
+     * with the placeholder props.
+     */
+    private _handleImageError () {
+        if (this.placeholder?.src) this.setAttribute('src', this.placeholder.src);
+        if (this.placeholder?.alt) this.setAttribute('alt', this.placeholder.alt);
+    }
+
+    /**
+     * Detects image load status and applies the placeholder on failure.
+     * This is needed as the `onerror` event is not triggered in SSR.
+     */
+    private _checkImageError () {
+        if (this.img) {
+            const { complete, naturalHeight } = this.img;
+            const hasError = complete && naturalHeight === 0;
+            if (hasError) this._handleImageError.call(this);
+        }
+    }
+
+    protected firstUpdated (): void {
+        this._checkImageError();
+    }
+
     render () {
         const {
             variant,
             src,
             alt,
+            disabled,
+            hasPadding,
+            backgroundColor,
         } = this;
 
         const wrapperClasses = {
             'c-thumbnail': true,
             [`c-thumbnail--${variant}`]: true,
+            [backgroundColorClassNames[backgroundColor]]: true,
+            'c-thumbnail--disabled': disabled,
+            'c-thumbnail--padding': hasPadding,
         };
 
+        const sizeStyles = this._generateSizeStyles();
+
         return html`
-            <div data-test-id="pie-thumbnail" class="${classMap(wrapperClasses)}">
-                <img data-test-id="pie-thumbnail-img" src="${src}" class="c-thumbnail-img" alt="${alt}">
+            <div data-test-id="pie-thumbnail"
+             class="${classMap(wrapperClasses)}"
+             style="${sizeStyles}">
+                <img
+                    data-test-id="pie-thumbnail-img"
+                    src="${src}"
+                    class="c-thumbnail-img"
+                    alt="${alt}"
+                    @error="${this._handleImageError}"
+                />
             </div>
         `;
     }

package/src/thumbnail.scss

@@ -1,9 +1,13 @@
 .c-thumbnail {
-  --thumbnail-size: var(--dt-spacing-g);
+  --thumbnail-size: 48px;
   --thumbnail-border-radius: var(--dt-radius-rounded-b);
   --thumbnail-bg-color: var(--dt-color-container-default);
   --thumbnail-border-color: transparent;
+  --thumbnail-padding: calc(var(--dt-spacing-a) / 2);
 
+  display: flex;
+  justify-content: center;
+  align-items: center;
   box-sizing: border-box;
   overflow: hidden;
   width: var(--thumbnail-size);
@@ -16,10 +20,36 @@
     --thumbnail-border-color: var(--dt-color-border-default);
   }
 
+  &.c-thumbnail--disabled {
+    opacity: 0.5;
+  }
+
+  &.c-thumbnail--backgroundSubtle {
+    --thumbnail-bg-color: var(--dt-color-container-subtle);
+  }
+
+  &.c-thumbnail--backgroundStrong {
+    --thumbnail-bg-color: var(--dt-color-container-strong);
+  }
+
+  &.c-thumbnail--backgroundDark {
+    --thumbnail-bg-color: var(--dt-color-container-dark);
+  }
+
+  &.c-thumbnail--backgroundInverse {
+    --thumbnail-bg-color: var(--dt-color-container-inverse);
+  }
+
+  &.c-thumbnail--backgroundInverseAlternative {
+    --thumbnail-bg-color: var(--dt-color-container-inverse-alternative);
+  }
+
+  &.c-thumbnail--padding {
+    padding: var(--thumbnail-padding);
+  }
+
   .c-thumbnail-img {
     width: 100%;
-    height: 100%;
-    object-fit: contain;
-    display: block;
+    height: auto;
   }
 }