@datocms/svelte 2.0.0 → 2.0.2

package/package/components/Image/README.md

@@ -1,19 +1,10 @@
-## Progressive responsive image
+# Progressive responsive image
 
-`<Image>` is a Svelte component specially designed to work seamlessly with DatoCMS’s [`responsiveImage` GraphQL query](https://www.datocms.com/docs/content-delivery-api/uploads#responsive-images) that optimizes image loading for your sites.
+`<Image>` and `<NakedImage />` are Svelte component specially designed to work seamlessly with DatoCMS’s [`responsiveImage` GraphQL query](https://www.datocms.com/docs/content-delivery-api/uploads#responsive-images) which optimizes image loading for your websites.
 
-### Table of contents
-
-- [Progressive responsive image](#progressive-responsive-image)
-  - [Table of contents](#table-of-contents)
-  - [Out-of-the-box features](#out-of-the-box-features)
-- [Intersection Observer](#intersection-observer)
-  - [Setup](#setup)
-  - [Usage](#usage)
-  - [Example](#example)
-  - [Props](#props)
-    - [Layout mode](#layout-mode)
-    - [The `ResponsiveImage` object](#the-responsiveimage-object)
+- TypeScript ready;
+- Usable both client and server side;
+- Compatible with vanilla Svelte and Sveltekit;
 
 ### Out-of-the-box features
 
@@ -23,28 +14,50 @@
 - Holds the image position so your page doesn’t jump while images load
 - Uses either blur-up or background color techniques to show a preview of the image while it loads
 
-## Intersection Observer
+### Table of contents
 
-Intersection Observer is the API used to determine if the image is inside the viewport or not. [Browser support is really good](https://caniuse.com/intersectionobserver) - With Safari adding support in 12.1, all major browsers now support Intersection Observers natively.
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
 
-If the IntersectionObserver object is not available, the component treats the image as it's always visible in the viewport. Feel free to add a [polyfill](https://www.npmjs.com/package/intersection-observer) so that it will also 100% work on older versions of iOS and IE11.
+  - [Setup](#setup)
+- [Usage](#usage)
+- [`<Image />` vs `<NakedImage />`](#image--vs-nakedimage-)
+- [Example](#example)
+- [The `ResponsiveImage` object](#the-responsiveimage-object)
+- [`<NakedImage />`](#nakedimage-)
+  - [Props](#props)
+  - [Events](#events)
+- [`<Image />`](#image-)
+  - [Props](#props-1)
+  - [Events](#events-1)
+  - [Layout mode](#layout-mode)
+  - [Intersection Observer](#intersection-observer)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
 
 ### Setup
 
 You can import the components like this:
 
 ```js
-import { Image } from '@datocms/svelte';
+import { Image, NakedImage } from '@datocms/svelte';
 ```
 
-### Usage
+## Usage
 
-1. Use `<Image>` it in place of the regular `<img />` tag
+1. Use `<Image>` or `<NakedImage />` in place of the regular `<img />` tag
 2. Write a GraphQL query to your DatoCMS project using the [`responsiveImage` query](https://www.datocms.com/docs/content-delivery-api/images-and-videos#responsive-images)
 
-The GraphQL query returns multiple thumbnails with optimized compression. The `<Image>` component automatically sets up the "blur-up" effect as well as lazy loading of images further down the screen.
+The GraphQL query returns multiple thumbnails with optimized compression. The components automatically set up the "blur-up" effect as well as lazy loading of images further down the screen.
+
+## `<Image />` vs `<NakedImage />`
 
-### Example
+Even though their purpose is the same, there are some significant differences between these two components. Depending on your specific needs, you can choose to use one or the other:
+
+- `<NakedImage />` generates minimum JS footprint, outputs a single `<picture />` element and implements lazy-loading using the native [`loading="lazy"` attribute](https://web.dev/articles/browser-level-image-lazy-loading). The placeholder is set as the background to the image itself.
+- `<Image />` has the ability to set a cross-fade effect between the placeholder and the original image, but at the cost of generating more complex HTML output composed of multiple elements around the main `<picture />` element. It also implements lazy-loading through `IntersectionObserver`, which allows customization of the thresholds at which lazy loading occurs.
+
+## Example
 
 For a fully working example take a look at [`routes` directory](https://github.com/datocms/datocms-svelte/tree/main/src/routes/image/+page.svelte).
 
@@ -55,7 +68,7 @@ Here is a minimal starting point:
 
 import { onMount } from 'svelte';
 
-import { Image } from '@datocms/svelte';
+import { Image, NakedImage } from '@datocms/svelte';
 
 const query = gql`
   query {
@@ -104,10 +117,60 @@ onMount(async () => {
 </script>
 
 {#if data}
-  <Image data={data.blogPost.cover.responsiveImage} />
+	<Image data={data.blogPost.cover.responsiveImage} />
+	<NakedImage data={data.blogPost.cover.responsiveImage} />
 {/if}
 ```
 
+## The `ResponsiveImage` object
+
+The `data` prop of both components expects an object with the same shape as the one returned by `responsiveImage` GraphQL call. It's up to you to make a GraphQL query that will return the properties you need for a specific use of the `<datocms-image>` component.
+
+- The minimum required properties for `data` are: `src`, `width` and `height`;
+- `alt` and `title`, while not mandatory, are all highly suggested, so remember to use them!
+- If you don't request `srcSet`, the component will auto-generate an `srcset` based on `src` + the `srcSetCandidates` prop (it can help reducing the GraphQL response size drammatically when many images are returned);
+- We strongly to suggest to always specify [`{ auto: format }`](https://docs.imgix.com/apis/rendering/auto/auto#format) in your `imgixParams`, instead of requesting `webpSrcSet`, so that you can also take advantage of more performant optimizations (AVIF), without increasing GraphQL response size;
+- If you request both the `bgColor` and `base64` property, the latter will take precedence, so just avoid querying both fields at the same time, as it will only make the GraphQL response bigger :wink:;
+- You can avoid requesting `sizes` and directly pass a `sizes` prop to the component to reduce the GraphQL response size;
+
+Here's a complete recap of what `responsiveImage` offers:
+
+| property    | type    | required           | description                                                                                                                                                                                    |
+| ----------- | ------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| src         | string  | :white_check_mark: | The `src` attribute for the image                                                                                                                                                              |
+| width       | integer | :white_check_mark: | The width of the image                                                                                                                                                                         |
+| height      | integer | :white_check_mark: | The height of the image                                                                                                                                                                        |
+| alt         | string  | :x:                | Alternate text (`alt`) for the image (not required, but strongly suggested!)                                                                                                                   |
+| title       | string  | :x:                | Title attribute (`title`) for the image (not required, but strongly suggested!)                                                                                                                |
+| sizes       | string  | :x:                | The HTML5 `sizes` attribute for the image (omit it if you're already passing a `sizes` prop to the Image component)                                                                            |
+| base64      | string  | :x:                | A base64-encoded thumbnail to offer during image loading                                                                                                                                       |
+| bgColor     | string  | :x:                | The background color for the image placeholder (omit it if you're already requesting `base64`)                                                                                                 |
+| srcSet      | string  | :x:                | The HTML5 `srcSet` attribute for the image (can be omitted, the Image component knows how to build it based on `src`)                                                                          |
+| webpSrcSet  | string  | :x:                | The HTML5 `srcSet` attribute for the image in WebP format (deprecated, it's better to use the [`auto=format`](https://docs.imgix.com/apis/rendering/auto/auto#format) Imgix transform instead) |
+| aspectRatio | float   | :x:                | The aspect ratio (width/height) of the image                                                                                                                                                   |
+
+## `<NakedImage />`
+
+### Props
+
+| prop             | type                     | default                            | required           | description                                                                                                                                          |
+| ---------------- | ------------------------ | ---------------------------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
+| data             | `ResponsiveImage` object |                                    | :white_check_mark: | The actual response you get from a DatoCMS `responsiveImage` GraphQL query \*\*\*\*                                                                  |
+| class            | string                   | null                               | :x:                | Additional CSS class for image                                                                                                                       |
+| style            | CSS properties           | null                               | :x:                | Additional CSS rules to add to the image                                                                                                             |
+| priority         | Boolean                  | false                              | :x:                | Disables lazy loading, and sets the image [fetchPriority](https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/fetchPriority) to "high" |
+| sizes            | string                   | undefined                          | :x:                | The HTML5 [`sizes`](https://web.dev/learn/design/responsive-images/#sizes) attribute for the image (will be used `data.sizes` as a fallback)         |
+| usePlaceholder   | Boolean                  | true                               | :x:                | Whether the image should use a blurred image placeholder                                                                                             |
+| srcSetCandidates | Array<number>            | [0.25, 0.5, 0.75, 1, 1.5, 2, 3, 4] | :x:                | If `data` does not contain `srcSet`, the candidates for the `srcset` attribute of the image will be auto-generated based on these width multipliers  |
+
+### Events
+
+| prop  | description                                 |
+| ----- | ------------------------------------------- |
+| @load | Emitted when the image has finished loading |
+
+## `<Image />`
+
 ### Props
 
 | prop                  | type                                             | default                            | required           | description                                                                                                                                                                                                                                                                                   |
@@ -131,7 +194,15 @@ onMount(async () => {
 | onLoad                | () => void                                       | undefined                          | :x:                | Function triggered when the image has finished loading                                                                                                                                                                                                                                        |
 | usePlaceholder        | Boolean                                          | true                               | :x:                | Whether the component should use a blurred image placeholder                                                                                                                                                                                                                                  |
 
-#### Layout mode
+### Events
+
+| prop  | description                                 |
+| ----- | ------------------------------------------- |
+| @load | Emitted when the image has finished loading |
+
+---
+
+### Layout mode
 
 With the `layout` property, you can configure the behavior of the image as the viewport changes size:
 
@@ -142,29 +213,8 @@ With the `layout` property, you can configure the behavior of the image as the v
   - This is usually paired with the `objectFit` and `objectPosition` properties.
   - Ensure the parent element has `position: relative` in their stylesheet.
 
-#### The `ResponsiveImage` object
-
-The `data` prop expects an object with the same shape as the one returned by `responsiveImage` GraphQL call. It's up to you to make a GraphQL query that will return the properties you need for a specific use of the `<datocms-image>` component.
-
-- The minimum required properties for `data` are: `src`, `width` and `height`;
-- `alt` and `title`, while not mandatory, are all highly suggested, so remember to use them!
-- If you don't request `srcSet`, the component will auto-generate an `srcset` based on `src` + the `srcSetCandidates` prop (it can help reducing the GraphQL response size drammatically when many images are returned);
-- We strongly to suggest to always specify [`{ auto: format }`](https://docs.imgix.com/apis/rendering/auto/auto#format) in your `imgixParams`, instead of requesting `webpSrcSet`, so that you can also take advantage of more performant optimizations (AVIF), without increasing GraphQL response size;
-- If you request both the `bgColor` and `base64` property, the latter will take precedence, so just avoid querying both fields at the same time, as it will only make the GraphQL response bigger :wink:;
-- You can avoid requesting `sizes` and directly pass a `sizes` prop to the component to reduce the GraphQL response size;
+### Intersection Observer
 
-Here's a complete recap of what `responsiveImage` offers:
+`IntersectionObserver` is the API used to determine if the image is inside the viewport or not. [Browser support is really good](https://caniuse.com/intersectionobserver): with Safari adding support in 12.1, all major browsers now support `IntersectionObserver` natively.
 
-| property    | type    | required           | description                                                                                                                                                                                    |
-| ----------- | ------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| src         | string  | :white_check_mark: | The `src` attribute for the image                                                                                                                                                              |
-| width       | integer | :white_check_mark: | The width of the image                                                                                                                                                                         |
-| height      | integer | :white_check_mark: | The height of the image                                                                                                                                                                        |
-| alt         | string  | :x:                | Alternate text (`alt`) for the image (not required, but strongly suggested!)                                                                                                                   |
-| title       | string  | :x:                | Title attribute (`title`) for the image (not required, but strongly suggested!)                                                                                                                |
-| sizes       | string  | :x:                | The HTML5 `sizes` attribute for the image (omit it if you're already passing a `sizes` prop to the Image component)                                                                            |
-| base64      | string  | :x:                | A base64-encoded thumbnail to offer during image loading                                                                                                                                       |
-| bgColor     | string  | :x:                | The background color for the image placeholder (omit it if you're already requesting `base64`)                                                                                                 |
-| srcSet      | string  | :x:                | The HTML5 `srcSet` attribute for the image (can be omitted, the Image component knows how to build it based on `src`)                                                                          |
-| webpSrcSet  | string  | :x:                | The HTML5 `srcSet` attribute for the image in WebP format (deprecated, it's better to use the [`auto=format`](https://docs.imgix.com/apis/rendering/auto/auto#format) Imgix transform instead) |
-| aspectRatio | float   | :x:                | The aspect ratio (width/height) of the image                                                                                                                                                   |
+If `IntersectionObserver` object is not available, the component treats the image as it's always visible in the viewport. Feel free to add a [polyfill](https://www.npmjs.com/package/intersection-observer) so that it will also 100% work on older versions of iOS and IE11.

package/package/components/Image/utils.d.ts

@@ -0,0 +1,13 @@
+import type * as CSS from 'csstype';
+export declare const isSsr: () => boolean;
+export declare const isIntersectionObserverAvailable: () => boolean;
+export declare const universalBtoa: (str: string) => string;
+type State = {
+    priority: boolean;
+    inView: boolean;
+    loaded: boolean;
+};
+export declare const imageAddStrategy: ({ priority, inView, loaded }: State) => boolean;
+export declare const imageShowStrategy: ({ priority, loaded }: State) => boolean;
+export declare const absolutePositioning: CSS.PropertiesHyphen;
+export {};

package/package/components/Image/utils.js

@@ -0,0 +1,36 @@
+export const isSsr = () => typeof window === 'undefined';
+export const isIntersectionObserverAvailable = () => isSsr() ? false : !!window.IntersectionObserver;
+export const universalBtoa = (str) => isSsr() ? Buffer.from(str.toString(), 'binary').toString('base64') : window.btoa(str);
+export const imageAddStrategy = ({ priority, inView, loaded }) => {
+    if (priority) {
+        return true;
+    }
+    if (isSsr()) {
+        return false;
+    }
+    if (isIntersectionObserverAvailable()) {
+        return inView || loaded;
+    }
+    return true;
+};
+export const imageShowStrategy = ({ priority, loaded }) => {
+    if (priority) {
+        return true;
+    }
+    if (isSsr()) {
+        return false;
+    }
+    if (isIntersectionObserverAvailable()) {
+        return loaded;
+    }
+    return true;
+};
+export const absolutePositioning = {
+    position: 'absolute',
+    left: '0px',
+    top: '0px',
+    width: '100%',
+    height: '100%',
+    'max-width': 'none',
+    'max-height': 'none'
+};

package/package/components/NakedImage/NakedImage.svelte

@@ -0,0 +1,71 @@
+<script>import { createEventDispatcher } from "svelte";
+import {
+  buildSrcSet,
+  dumpStyleAttributes,
+  noTypeCheck,
+  parseStyleAttributes
+} from "./utils";
+export let data;
+let rootClass = null;
+export { rootClass as class };
+export let style = null;
+export let usePlaceholder = true;
+export let sizes = null;
+export let priority = false;
+export let srcSetCandidates = [0.25, 0.5, 0.75, 1, 1.5, 2, 3, 4];
+const dispatch = createEventDispatcher();
+let loaded = false;
+let placeholderStyle;
+$:
+  placeholderStyle = usePlaceholder && !loaded && data.base64 ? {
+    "background-image": `url("${data.base64}")`,
+    "background-size": "cover",
+    "background-repeat": "no-repeat",
+    "background-position": "50% 50%",
+    color: "transparent"
+  } : usePlaceholder && !loaded && data.bgColor ? { "background-color": data.bgColor ?? void 0, color: "transparent" } : void 0;
+$:
+  ({ width } = data);
+$:
+  height = data.height ?? Math.round(data.aspectRatio ? width / data.aspectRatio : 0);
+let sizingStyle;
+$:
+  sizingStyle = {
+    "aspect-ratio": `${width} / ${height}`,
+    width: "100%",
+    "max-width": `${width}px`,
+    height: "auto"
+  };
+</script>
+
+<picture data-testid="picture">
+	{#if data.webpSrcSet}
+		<source srcset={data.webpSrcSet} sizes={sizes ?? data.sizes ?? null} type="image/webp" />
+	{/if}
+	<source
+		srcset={data.srcSet ?? buildSrcSet(data.src, data.width, srcSetCandidates) ?? null}
+		sizes={sizes ?? data.sizes ?? null}
+	/>
+	{#if data.src}
+		<img
+			src={data.src}
+			alt={data.alt ?? ''}
+			title={data.title ?? null}
+			on:load={() => {
+				dispatch('load');
+				loaded = true;
+			}}
+			{...noTypeCheck({
+				fetchpriority: priority ? 'high' : undefined
+			})}
+			loading={priority ? undefined : 'lazy'}
+			class={rootClass}
+			style={dumpStyleAttributes({
+				...placeholderStyle,
+				...sizingStyle,
+				...parseStyleAttributes(style)
+			})}
+			data-testid="img"
+		/>
+	{/if}
+</picture>

package/package/components/NakedImage/NakedImage.svelte.d.ts

@@ -0,0 +1,39 @@
+import { SvelteComponentTyped } from "svelte";
+import { type ResponsiveImageType } from './utils';
+declare const __propDef: {
+    props: {
+        /** The actual response you get from a DatoCMS `responsiveImage` GraphQL query */ data: ResponsiveImageType;
+        /** Additional CSS className for root node */ class?: string | null | undefined;
+        /** Additional CSS rules to add to the root node */ style?: string | null | undefined;
+        /** Whether the component should use a blurred image placeholder */ usePlaceholder?: boolean | undefined;
+        /**
+             * The HTML5 `sizes` attribute for the image
+             *
+             * Learn more about srcset and sizes:
+             * -> https://web.dev/learn/design/responsive-images/#sizes
+             * -> https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img#attr-sizes
+             **/ sizes?: string | null | undefined;
+        /**
+             * When true, the image will be considered high priority. Lazy loading is automatically disabled, and fetchpriority="high" is added to the image.
+             * You should use the priority property on any image detected as the Largest Contentful Paint (LCP) element. It may be appropriate to have multiple priority images, as different images may be the LCP element for different viewport sizes.
+             * Should only be used when the image is visible above the fold.
+             **/ priority?: boolean | undefined;
+        /**
+             * If `data` does not contain `srcSet`, the candidates for the `srcset` of the image will be auto-generated based on these width multipliers
+             *
+             * Default candidate multipliers are [0.25, 0.5, 0.75, 1, 1.5, 2, 3, 4]
+             **/ srcSetCandidates?: number[] | undefined;
+    };
+    events: {
+        load: CustomEvent<any>;
+    } & {
+        [evt: string]: CustomEvent<any>;
+    };
+    slots: {};
+};
+export type NakedImageProps = typeof __propDef.props;
+export type NakedImageEvents = typeof __propDef.events;
+export type NakedImageSlots = typeof __propDef.slots;
+export default class NakedImage extends SvelteComponentTyped<NakedImageProps, NakedImageEvents, NakedImageSlots> {
+}
+export {};

package/package/components/NakedImage/utils.d.ts

@@ -0,0 +1,31 @@
+import type * as CSS from 'csstype';
+type Maybe<T> = T | null;
+export type ResponsiveImageType = {
+    /** A base64-encoded thumbnail to offer during image loading */
+    base64?: Maybe<string>;
+    /** The height of the image */
+    height?: Maybe<number>;
+    /** The width of the image */
+    width: number;
+    /** The aspect ratio (width/height) of the image */
+    aspectRatio?: number;
+    /** The HTML5 `sizes` attribute for the image */
+    sizes?: Maybe<string>;
+    /** The fallback `src` attribute for the image */
+    src?: Maybe<string>;
+    /** The HTML5 `srcSet` attribute for the image */
+    srcSet?: Maybe<string>;
+    /** The HTML5 `srcSet` attribute for the image in WebP format, for browsers that support the format */
+    webpSrcSet?: Maybe<string>;
+    /** The background color for the image placeholder */
+    bgColor?: Maybe<string>;
+    /** Alternate text (`alt`) for the image */
+    alt?: Maybe<string>;
+    /** Title attribute (`title`) for the image */
+    title?: Maybe<string>;
+};
+export declare const parseStyleAttributes: (styleString: string | null) => CSS.PropertiesHyphen;
+export declare const dumpStyleAttributes: (style: CSS.PropertiesHyphen) => string;
+export declare const noTypeCheck: (x: object) => object;
+export declare const buildSrcSet: (src: string | null | undefined, width: number | undefined, candidateMultipliers: number[]) => string | undefined;
+export {};

package/package/components/NakedImage/utils.js

@@ -0,0 +1,48 @@
+export const parseStyleAttributes = (styleString) => {
+    const styleRules = {};
+    if (styleString) {
+        for (const rule of styleString.split(';')) {
+            const [key, value] = rule.split(':').map((part) => part.trim());
+            if (key && value) {
+                styleRules[key] = value;
+            }
+        }
+    }
+    return styleRules;
+};
+export const dumpStyleAttributes = (style) => {
+    return Object.entries(style)
+        .map(([key, value]) => typeof value !== 'undefined' && value !== 'null' ? `${key}: ${value};` : undefined)
+        .filter(Boolean)
+        .join(' ');
+};
+// See: https://github.com/sveltejs/language-tools/issues/1026#issuecomment-1002839154
+export const noTypeCheck = (x) => x;
+const bogusBaseUrl = 'https://example.com/';
+export const buildSrcSet = (src, width, candidateMultipliers) => {
+    if (!(src && width)) {
+        return undefined;
+    }
+    return candidateMultipliers
+        .map((multiplier) => {
+        const url = new URL(src, bogusBaseUrl);
+        if (multiplier !== 1) {
+            url.searchParams.set('dpr', `${multiplier}`);
+            const maxH = url.searchParams.get('max-h');
+            const maxW = url.searchParams.get('max-w');
+            if (maxH) {
+                url.searchParams.set('max-h', `${Math.floor(Number.parseInt(maxH) * multiplier)}`);
+            }
+            if (maxW) {
+                url.searchParams.set('max-w', `${Math.floor(Number.parseInt(maxW) * multiplier)}`);
+            }
+        }
+        const finalWidth = Math.floor(width * multiplier);
+        if (finalWidth < 50) {
+            return null;
+        }
+        return `${url.toString().replace(bogusBaseUrl, '/')} ${finalWidth}w`;
+    })
+        .filter(Boolean)
+        .join(',');
+};

package/package/components/StructuredText/README.md

@@ -4,11 +4,18 @@
 
 ### Table of contents
 
-- [Setup](#setup)
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+
+  - [Setup](#setup)
 - [Basic usage](#basic-usage)
-- [Custom renderers](#custom-renderers)
+- [Customization](#customization)
+  - [Custom components for blocks](#custom-components-for-blocks)
+  - [Override default rendering of nodes](#override-default-rendering-of-nodes)
 - [Props](#props)
 
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
 ### Setup
 
 Import the component like this:

package/package/components/StructuredText/StructuredText.svelte

@@ -1,4 +1,6 @@
-<script>import { isStructuredText } from "datocms-structured-text-utils";
+<script>import {
+  isStructuredText
+} from "datocms-structured-text-utils";
 import Node from "./Node.svelte";
 export let data = null;
 export let components = [];

package/package/components/StructuredText/nodes/ThematicBreak.svelte

@@ -2,4 +2,4 @@
 node;
 </script>
 
-<hr />
+<hr />

package/package/components/VideoPlayer/README.md

@@ -17,10 +17,22 @@ optimal videos to your users.
 
 - Offers optimized streaming so smartphones and tablets don’t request desktop-sized videos
 - Lazy loads the underlying video player web component and the video to be
-   played to speed initial page load and save bandwidth
+  played to speed initial page load and save bandwidth
 - Holds the video position so your page doesn’t jump while the player loads
 - Uses blur-up technique to show a placeholder of the video while it loads
 
+### Table of contents
+
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+
+- [Installation](#installation)
+- [Usage](#usage)
+- [Example](#example)
+- [Props](#props)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
 ## Installation
 
 ```sh {"id":"01HP46D8MDP5Y76HY788MWNDMX"}
@@ -118,10 +130,10 @@ inner `<mux-player />`.
 `<VideoPlayer />` generate some default attributes:
 
 - when not declared, the `disableCookies` prop is true, unless you explicitly
-   set the prop to `false` (therefore it generates a `disable-cookies` attribute)
+  set the prop to `false` (therefore it generates a `disable-cookies` attribute)
 - `preload` defaults to `metadata`, for an optimal UX experience together with saved bandwidth
 - the video height and width, when available in the `data` props, are used to
-   set a default `aspect-ratio: [width] / [height];` for the `<mux-player />`'s
-   `style` attribute
+  set a default `aspect-ratio: [width] / [height];` for the `<mux-player />`'s
+  `style` attribute
 
 All the other props are forwarded to the `<mux-player />` web component that is used internally.

package/package/components/VideoPlayer/VideoPlayer.svelte

@@ -70,7 +70,6 @@ const toHTMLAttrs = (props = {}) => {
 </script>
 
 <script>import { onMount } from "svelte";
-import mux from "mux-embed";
 export let data = {};
 export let style = void 0;
 export let preload = "metadata";

package/package/components/VideoPlayer/VideoPlayer.svelte.d.ts

@@ -1,5 +1,5 @@
 import { SvelteComponentTyped } from "svelte";
-import type { CmcdTypes, MaxResolutionValue, MinResolutionValue, PlaybackTypes, RenditionOrderValue, StreamTypes } from '@mux/playback-core/.';
+import type { CmcdTypes, MaxResolutionValue, MinResolutionValue, PlaybackTypes, RenditionOrderValue, StreamTypes } from '@mux/playback-core';
 import type { Tokens } from '@mux/mux-player';
 type ValueOf<T> = T[keyof T];
 type Maybe<T> = T | null;
@@ -119,8 +119,8 @@ declare const __propDef: {
         suspend: Event;
         ended: Event;
         error: ErrorEvent;
-        cuepointchange: Event | UIEvent | ProgressEvent<EventTarget> | ErrorEvent | MouseEvent | FocusEvent | AnimationEvent | InputEvent | CompositionEvent | ClipboardEvent | DragEvent | FormDataEvent | PointerEvent | KeyboardEvent | SecurityPolicyViolationEvent | SubmitEvent | TouchEvent | TransitionEvent | WheelEvent;
-        cuepointschange: Event | UIEvent | ProgressEvent<EventTarget> | ErrorEvent | MouseEvent | FocusEvent | AnimationEvent | InputEvent | CompositionEvent | ClipboardEvent | DragEvent | FormDataEvent | PointerEvent | KeyboardEvent | SecurityPolicyViolationEvent | SubmitEvent | TouchEvent | TransitionEvent | WheelEvent;
+        cuepointchange: Event | UIEvent | ProgressEvent<EventTarget> | ErrorEvent | ClipboardEvent | DragEvent | MouseEvent | FocusEvent | AnimationEvent | InputEvent | CompositionEvent | FormDataEvent | PointerEvent | KeyboardEvent | SecurityPolicyViolationEvent | SubmitEvent | TouchEvent | TransitionEvent | WheelEvent;
+        cuepointschange: Event | UIEvent | ProgressEvent<EventTarget> | ErrorEvent | ClipboardEvent | DragEvent | MouseEvent | FocusEvent | AnimationEvent | InputEvent | CompositionEvent | FormDataEvent | PointerEvent | KeyboardEvent | SecurityPolicyViolationEvent | SubmitEvent | TouchEvent | TransitionEvent | WheelEvent;
     } & {
         [evt: string]: CustomEvent<any>;
     };

package/package/components/VideoPlayer/__tests__/VideoPlayer.svelte.test.js

@@ -54,13 +54,13 @@ describe('VideoPlayer', () => {
             });
             describe('and `preload` is passed', () => {
                 it('uses it for the <mux-player /> element', () => {
-                    const props = { data, preload: "auto" };
+                    const props = { data, preload: 'auto' };
                     const { container } = render(VideoPlayer, { props });
                     expect(container).toMatchSnapshot();
                 });
                 describe('with value `none`', () => {
                     it("doesn't use it for the <mux-player /> element", () => {
-                        const props = { data, preload: "none" };
+                        const props = { data, preload: 'none' };
                         const { container } = render(VideoPlayer, { props });
                         expect(container).toMatchSnapshot();
                     });

package/package/index.d.ts

@@ -1,8 +1,10 @@
 import type { Node } from 'datocms-structured-text-utils';
 import type { SvelteComponent } from 'svelte';
-export { default as StructuredText } from './components/StructuredText/StructuredText.svelte';
-export { default as Image } from './components/Image/Image.svelte';
+export { default as NakedImage } from './components/NakedImage/NakedImage.svelte';
+export type { ResponsiveImageType } from './components/NakedImage/utils';
 export { default as Head } from './components/Head/Head.svelte';
+export { default as Image } from './components/Image/Image.svelte';
+export { default as StructuredText } from './components/StructuredText/StructuredText.svelte';
 export { default as VideoPlayer } from './components/VideoPlayer/VideoPlayer.svelte';
 export type PredicateComponentTuple = [
     (n: Node) => boolean,

package/package/index.js

@@ -1,4 +1,5 @@
-export { default as StructuredText } from './components/StructuredText/StructuredText.svelte';
-export { default as Image } from './components/Image/Image.svelte';
+export { default as NakedImage } from './components/NakedImage/NakedImage.svelte';
 export { default as Head } from './components/Head/Head.svelte';
+export { default as Image } from './components/Image/Image.svelte';
+export { default as StructuredText } from './components/StructuredText/StructuredText.svelte';
 export { default as VideoPlayer } from './components/VideoPlayer/VideoPlayer.svelte';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@datocms/svelte",
-	"version": "2.0.0",
+	"version": "2.0.2",
 	"description": "A set of components and utilities to work faster with DatoCMS in Svelte",
 	"license": "MIT",
 	"repository": {
@@ -22,7 +22,8 @@
 		"test:unit": "vitest",
 		"test": "npm run test:unit",
 		"lint": "prettier --plugin-search-dir . --check . && eslint .",
-		"format": "prettier --plugin-search-dir . --write ."
+		"format": "npm run toc && prettier --plugin-search-dir . --write .",
+		"toc": "doctoc --github src README.md"
 	},
 	"peerDependencies": {
 		"@mux/mux-player": "*",
@@ -59,13 +60,13 @@
 		"tslib": "^2.6.2",
 		"typescript": "^5.0.0",
 		"vite": "^5.0.0",
-		"vitest": "^1.0.0"
+		"vitest": "^1.0.0",
+		"doctoc": "^2.0.0"
 	},
 	"type": "module",
 	"dependencies": {
 		"datocms-structured-text-utils": "^2.0.4",
-		"svelte-intersection-observer": "^1.0.0",
-		"universal-base64": "^2.1.0"
+		"svelte-intersection-observer": "^1.0.0"
 	},
 	"exports": {
 		"./package.json": "./package.json",