# @maggioli-design-system/mds-author

> mds-author is a web-component from Magma Design System, built with StencilJS, TypeScript, Storybook. It's based on the web-component standard and it's designed to be agnostic from the JavaScript framework you are using.

Latest version **4.4.5** (published 2026-02-19) · MIT license · 0 weekly downloads

## Install

```sh
npm install @maggioli-design-system/mds-author
pnpm add @maggioli-design-system/mds-author
yarn add @maggioli-design-system/mds-author
bun add @maggioli-design-system/mds-author
```

## Health

**Score 60/100 (C)** — status: stable.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 4.4.5 |
| Published | 2026-02-19 |
| First published | 2021-12-31 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 3 |
| Unpacked size | 873 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Vittorio Vittori |
| Maintainers | vitto, moodysmiles, nicola.tamburini.maggioli |

## Links

- npm: https://www.npmjs.com/package/@maggioli-design-system/mds-author
- npm.io page: https://npm.io/package/@maggioli-design-system/mds-author

## Dependencies (3)

- [@stencil/core](https://npm.io/package/@stencil/core.md) 4.27.2
- [@maggioli-design-system/styles](https://npm.io/package/@maggioli-design-system/styles.md) 15.11.0
- [@maggioli-design-system/mds-avatar](https://npm.io/package/@maggioli-design-system/mds-avatar.md) 4.5.4

## Recent versions

- 4.4.5 (latest) — 2026-02-19
- 4.4.4 — 2026-01-16
- 4.4.3 — 2025-06-03
- 4.4.2 — 2025-05-14
- 4.4.1 — 2025-04-18
- 4.4.0 — 2025-04-02
- 4.3.1 — 2025-03-10
- 4.3.0 — 2025-03-05
- 4.2.0 — 2025-02-25
- 4.1.1 — 2025-02-06
- 4.1.0 — 2024-12-04
- 4.0.0 — 2024-11-25
- 3.9.13 — 2024-10-17
- 3.9.12 — 2024-10-16
- 3.9.11 — 2024-10-14
- … 40 more at https://npm.io/package/@maggioli-design-system/mds-author/versions

## README

# mds-author


# Installation

Install the component via `npm` by running the following command:

```bash
npm i @maggioli-design-system/mds-author
```

This package works also with yarn:

```bash
yarn add @maggioli-design-system/mds-author
```

#### Import

Import the component in your project via `TypeScript` as follows:

```typescript
import { defineCustomElements as dceMdsAuthor } from '@maggioli-design-system/mds-author/loader'

dceMdsAuthor()
```

If you need to support older browsers (i.e. IE or early version of Edge), you can wrap the `defineCustomElements` in another utility available in the same package:

```typescript
import { applyPolyfills as apMdsAuthor, defineCustomElements as dceMdsAuthor } from '@maggioli-design-system/mds-author/loader'

apMdsAuthor().then(dceMdsAuthor())
```

Use alias for `defineCustomElements` method to initialize multiple web components in the same place:

```typescript
import { defineCustomElements as dceMdsComponentOne } from '@maggioli-design-system/mds-component-one/loader'
import { defineCustomElements as dceMdsComponentTwo } from '@maggioli-design-system/mds-component-two/loader'

dceMdsComponentOne()
dceMdsComponentTwo()
```

You can check how browser support works at [this page][stencil-browser-support].

---

# Integration

#### How to use it in HTML

`MdsAuthor` accepts a specific slot named `avatar` which is used to display an element on the left side (usually an image, or the initials of the author if no `src` is provided), while accepts multiple slots to be displayed on the right side for author's name and description. An example follow:

```html
<mds-author>
  <mds-avatar slot="avatar" initials="jd" src="<some-url>"></mds-avatar>
  <mds-text typography="h6">John Doe</mds-text>
  <mds-text typography="caption">Associated professor</mds-text>
</mds-author>
```

You can try it out on the component's [Storybook website][storybook]!

[storybook]: https://magma.maggiolicloud.it/storybook/?path=/story/ui-author--default
[stencil-browser-support]: https://stenciljs.com/docs/browser-support

This is a web-component from Maggioli Design System [Magma](https://magma.maggiolicloud.it), built with StencilJS, TypeScript, Storybook. It's based on the web-component standard and it's designed to be agnostic from the JavaScript framework you are using.

<!-- Auto Generated Below -->


## Slots

| Slot        | Description                                                                                                                          |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `"avatar"`  | Insert an avatar image, it is **recommended** to add `mds-avatar` element.                                                           |
| `"default"` | Add `text string`, `HTML elements` or `components` to this slot. Insert author information, name, role or other useful author infos. |


----------------------------------------------

Built with love @ [Gruppo Maggioli](https://www.maggioli.com) from [R&D Department](https://www.maggioli.com/it-it/chi-siamo/ricerca-sviluppo)

---
_Source: https://npm.io/package/@maggioli-design-system/mds-author · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
