@aceshooting/lyra-ui 3.0.0 → 3.2.0

package/llms-full.txt

@@ -34,6 +34,7 @@ composition without registration; for example, `components/empty/empty.class.js`
   `lyra-thinking-panel`, `lyra-generation-status`, `lyra-code-block`, `lyra-tool-approval-dialog`,
   `lyra-tool-param-form`, `lyra-menu`/`lyra-menu-item`, `lyra-chip`/`lyra-chip-group`,
   `lyra-model-settings-panel`, `lyra-context-meter`, `lyra-dock-panel`, `lyra-document-preview`,
+  `lyra-document-viewer`, `lyra-docx-viewer`, `lyra-email-viewer`, `lyra-calendar-viewer`, `lyra-archive-viewer`,
   `lyra-media-card`, `lyra-attachment-trigger`, `lyra-kbd`, `lyra-result-card`/`lyra-result-field`,
   `lyra-avatar`, `lyra-card`, `lyra-stepper`, `lyra-segmented`, `lyra-diff-view`, `lyra-poll-status`,
   `lyra-code-block-core` (needs the optional peer `shiki`)
@@ -4874,7 +4875,8 @@ to populate it: set `file` to a real `File` (fresh from a picker/drop), from whi
 `mime-type` and the image thumbnail are all auto-derived; or set the plain `name`/`size`/
 `mime-type`/`thumbnail-src` props instead, for reconstructing a chip from server-persisted
 attachment metadata after a page reload, when no real `File` object exists any more. `file` always
-wins when both are present.
+wins when both are present. When a real `File` or `preview-src` is available, the chip also offers
+a localized preview action that opens `<lyra-document-viewer>` using the same effective MIME type.
 
 **Properties:**
 - `file?: File` (attribute `false`, i.e. property-only) — when set, `name`/`size`/`mimeType`/the
@@ -4885,6 +4887,10 @@ wins when both are present.
 - `thumbnailSrc: string = ''` (attribute `thumbnail-src`) — thumbnail image URL, used only while
   `file` is unset; rendered whenever present regardless of `mimeType` (no `file`-derived equivalent
   exists for a non-image file)
+- `previewSrc: string = ''` (attribute `preview-src`) — source URL used for preview and download when
+  `file` is unset; a real `File` takes precedence and uses a temporary blob URL
+- `previewable: boolean = true` (reflected) — shows the preview action whenever a `file` or
+  `preview-src` is available
 - `status: AttachmentChipStatus = 'pending'` (reflected) — `'pending' | 'uploading' | 'error' |
   'done'`; drives the accent tint and which of `progress`/`spinner`/`retry-button` renders
 - `progress: number = 0` — upload completion, 0-100; only meaningful while `status="uploading"`, a
@@ -4916,12 +4922,13 @@ derived from `` `${file.name}:${file.size}:${file.lastModified}` ``; when neithe
 generated internal id is used as a last resort.
 
 **Events:** `lyra-remove` (`detail: { id }`, only rendered while `removable`), `lyra-retry`
-(`detail: { id }`, only rendered while `status="error"`)
+(`detail: { id }`, only rendered while `status="error"`), `lyra-preview` (`detail: { id, name,
+mimeType, src }`, emitted when the preview action opens the document viewer)
 
 **Slots:** none.
 
 **CSS parts:** `base`, `thumbnail`, `meta`, `name`, `size`, `status-text`, `progress`,
-`progress-fill`, `spinner`, `retry-button`, `remove-button`
+`progress-fill`, `spinner`, `retry-button`, `preview-button`, `remove-button`
 
 **Themeable custom properties:** `--lyra-attachment-chip-accent` (default
 `var(--lyra-color-text-quiet)`), `--lyra-attachment-chip-bg` (default `var(--lyra-color-surface)`),
@@ -4953,6 +4960,7 @@ size renders nothing instead of `"NaN B"`.
   chip.file = pickedFile; // name/size/mime-type/thumbnail all derived from the File
   chip.addEventListener('lyra-remove', (e) => removeAttachment(e.detail.id));
   chip.addEventListener('lyra-retry', (e) => retryUpload(e.detail.id));
+  chip.addEventListener('lyra-preview', (e) => console.log(e.detail));
   console.log(formatFileSize(pickedFile.size));
 </script>
 ```
@@ -4973,6 +4981,9 @@ leaks URLs that were created but never shown.
   (`uploading` with no known progress).
 - `thumbnailSrc` is used whenever present regardless of `mimeType` — pass a URL that's already known
   to be an image; there's no non-image fallback check for it the way there is for `file`.
+- `previewSrc` is used only when `file` is unset. A preview action is omitted when neither a real
+  `File` nor `preview-src` supplies a source. The viewer's footer omits its download link for unsafe
+  source schemes.
 
 ---
 
@@ -6597,9 +6608,10 @@ something that announces state *transitions* instead. The Stop button gets a nor
 ## `lyra-code-block`
 
 Fenced code display with optional lazy syntax highlighting and a copy button. First-party invention
-(no Web Awesome equivalent). No highlighting grammar ships in the component itself — it lazy-loads
-the optional peer dependency `shiki` (see `code-loader.ts`) for the actual tokenizing, and degrades
-to a plain `<pre><code>` when that peer isn't installed or `language` is unset/unrecognized. That
+(no Web Awesome equivalent). It lazy-loads the optional peer dependency `shiki` (see
+`code-loader.ts`) for the actual tokenizing, and includes a compact GreyCat/GCL grammar because
+Shiki does not bundle one. It falls back to a plain `<pre><code>` when that peer isn't installed or
+`language` is unset/unrecognized. That
 fallback is the *default* rendering path, not a degraded one: unhighlighted code is perfectly usable,
 and it's what every instance renders at zero extra bytes until shiki resolves.
 
@@ -6607,7 +6619,10 @@ and it's what every instance renders at zero extra bytes until shiki resolves.
 - `code: string = ''` — the raw source text
 - `language: string = ''` — a shiki-recognized language id or alias (e.g. `"javascript"`, `"python"`,
   `"json"`); when unset, or when shiki doesn't recognize it, the code renders as plain unhighlighted
-  text regardless of whether shiki itself is available
+  text regardless of whether shiki itself is available. Shiki's bundled catalog covers most common
+  programming, markup, data, and configuration languages, including Python, C, C++, C#, Java,
+  JavaScript, TypeScript, HTML, CSS, JSON, SQL, Go, Rust, YAML, Markdown, and shell scripts. Lyra
+  also includes a built-in GreyCat grammar; use `"gcl"` or `"greycat"` for GreyCat source.
 - `filename: string = ''` — shown in the header, when set
 - `accessibleLabel: string = ''` (attribute `aria-label`) — names the internal focusable code-body
   region; otherwise a localized filename/language description is generated
@@ -6619,6 +6634,8 @@ and it's what every instance renders at zero extra bytes until shiki resolves.
   cannot override a true default)
 - `maxHeight: string = ''` (attribute `max-height`) — a CSS length (e.g. `"20rem"`); once set, the
   code scrolls internally past this height instead of growing the page
+- `lineNumbers: boolean = false` (attribute `line-numbers`, reflected) — displays one-based line
+  numbers for both highlighted output and the plain-text fallback
 - `languages?: Record<string, ShikiLanguageInput>` (attribute: false) — a map of language id to an
   already-imported shiki grammar module (e.g. `{ bash: bashGrammar }` from a module-scope
   `import bash from 'shiki/langs/bash.mjs'`). When `language` matches a key here, highlighting is
@@ -6668,6 +6685,9 @@ highlighting).
 ></lyra-code-block>
 ```
 
+Set `line-numbers` when source context benefits from numbered lines. The option does not change the
+raw `code` value or the `lyra-copy` event payload.
+
 A `<lyra-skeleton variant="rect">` placeholder (with `aria-busy="true"` on the host) stands in only
 while shiki itself is loading for the very first time on the page and `language` is set — it is
 deliberately *not* shown again for a later per-language grammar fetch (that's typically fast, and the
@@ -6731,6 +6751,8 @@ toggle, the loading-skeleton behavior while the fine-grained highlighter resolve
 - `copyable: boolean = true` (reflected) — shows the copy-to-clipboard button.
 - `maxHeight: string = ''` (attribute `max-height`) — a CSS length (e.g. `"20rem"`); once set, the
   code scrolls internally past this height instead of growing the page.
+- `lineNumbers: boolean = false` (attribute `line-numbers`, reflected) — displays one-based line
+  numbers for highlighted and plain output.
 - `languages: Record<string, ShikiLanguageInput> = {}` (attribute: false) — grammar definitions this
   instance can highlight, e.g. `{ json: jsonGrammar }` (import from `shiki/langs/<name>.mjs`). Empty
   (the default) never highlights at all — every `language` renders the plain-text fallback.
@@ -7780,6 +7802,307 @@ available, the region becomes a standard `role="progressbar"` instead, self-desc
 
 ---
 
+## `lyra-document-viewer`
+
+A dialog-hosted, format-dispatching full viewer for one document or attachment. It uses a pluggable
+renderer registry and falls back to `<lyra-document-preview>` when no renderer matches the file's MIME
+type. First-party invention.
+
+**Properties:**
+- `open: boolean = false` (reflected) — opens or closes the viewer dialog.
+- `name: string = ''` — display name passed to the renderer and used as the dialog heading.
+- `mimeType: string = ''` (attribute `mime-type`) — MIME type used for exact renderer dispatch.
+- `src: string = ''` — source URL passed to the selected renderer or the fallback preview.
+- `registry?: DocumentRendererRegistry` (attribute: false) — optional per-instance registry override;
+  the module-level registry is used when unset.
+
+**Events:**
+- `lyra-close` — `detail: DocumentViewerCloseReason`, the nested dialog's dismissal reason. The
+  event is emitted after the viewer sets `open` to `false`.
+- `lyra-download` — `detail: { src, filename }`, emitted when the native safe download action is
+  activated. The browser download itself is handled by the link.
+
+**CSS parts:** `body` — wrapper around the active renderer, loading/error state, or fallback preview;
+`download-link` — the native download action, rendered when `src` passes Lyra's safe-link policy.
+
+**Renderer registry exports:**
+- `DocumentFile` — `{ name: string; mimeType: string; src: string }`, the value passed to renderers.
+- `DocumentRendererDefinition` — optional `render(file)`, `matches(file)`, and lazy `load()` hooks.
+- `DocumentRendererRegistry` — `Map<string, DocumentRendererDefinition>`.
+- `registerDocumentRenderer(key, definition)` — adds or replaces a default-registry entry.
+- `findDocumentRenderer(file, registry?)` — checks an exact MIME-type key, then the first matching
+  `matches()` entry in registration order.
+- `loadDocumentRenderer(definition)` — resolves and identity-caches a lazy definition; rejected loads
+  are retried on the next call.
+
+```html
+<lyra-document-viewer
+  open
+  name="report.pdf"
+  mime-type="application/pdf"
+  src="/files/report.pdf"
+></lyra-document-viewer>
+```
+
+Register a renderer once during application setup. The definition may load a heavy optional viewer
+only when a matching document is opened:
+
+```ts
+import { registerDocumentRenderer } from '@aceshooting/lyra-ui';
+
+registerDocumentRenderer('application/x-example', {
+  render: (file) => `Preview: ${file.name}`,
+});
+```
+
+When no renderer matches, the viewer renders `<lyra-document-preview>`, which handles text and images
+inline and provides a safe generic fallback for other formats.
+
+## `lyra-docx-viewer`
+
+Fetches a `.docx` Word document as an `ArrayBuffer`, converts it to semantic HTML with the optional
+`mammoth` peer, sanitizes that HTML through the optional `dompurify` peer, and renders the result.
+Mammoth preserves document structure such as headings, paragraphs, lists, tables, and images; it is
+not intended to reproduce pixel-exact Word page layout. There is no unsanitized rendering escape
+hatch: if `dompurify` is unavailable, rendering is blocked even when Mammoth converted successfully.
+
+**Properties:** `src`, `name`, and `maxHeight` (attribute `max-height`) are strings. `maxHeight` caps
+the scrollable document body.
+
+**Events:** `lyra-render-error` with `detail.error` when fetching, conversion, sanitization, or a
+non-fatal Mammoth conversion message occurs.
+
+**CSS parts:** `base`, `body`, `content`, `spinner`, and `error`.
+
+**Optional peer dependencies:** install `mammoth` and `dompurify` with `pnpm add mammoth dompurify`.
+The component registers a lazy `application/vnd.openxmlformats-officedocument.wordprocessingml.document`
+renderer with `<lyra-document-viewer>` and matches `.docx` filenames when the MIME type is generic.
+
+```html
+<lyra-docx-viewer src="/files/report.docx" name="report.docx" max-height="32rem"></lyra-docx-viewer>
+```
+
+## `lyra-email-viewer`
+
+Fetches and parses `.eml` messages with the optional `postal-mime` peer. HTML message bodies are
+sanitized through the existing optional `dompurify` peer before rendering; plain-text messages
+remain available without DOMPurify. Attachments are listed as filename/type/size metadata and their
+content is never rendered by this component.
+
+**Properties:** `src`, `name`, and `maxHeight` (attribute `max-height`) are strings.
+
+**Events:** `lyra-render-error` with `detail.error` when fetching or parsing fails.
+
+**CSS parts:** `base`, `headers`, `from-label`, `from`, `to-label`, `to`, `subject-label`, `subject`,
+`date-label`, `date`, `body`, `body-html`, `body-text`, `attachments`, `attachments-label`,
+`attachment-list`, `attachment-item`, `spinner`, and `error`.
+
+**Optional peer dependencies:** install `postal-mime` and `dompurify` with
+`pnpm add postal-mime dompurify`. The component registers `message/rfc822` and falls back to
+matching `.eml` filenames in `<lyra-document-viewer>`.
+
+## `lyra-calendar-viewer`
+
+Fetches and parses `.ics` calendars with the optional `ical.js` peer and renders each VEVENT as
+plain text, including its title, start/end time, location, and description. No HTML is injected.
+
+**Properties:** `src`, `name`, and `maxHeight` (attribute `max-height`) are strings.
+
+**Events:** `lyra-render-error` with `detail.error` when fetching or parsing fails.
+
+**CSS parts:** `base`, `body`, `event-list`, `event`, `event-summary`, `event-time`, `event-location`,
+`event-description`, `spinner`, and `error`.
+
+**Optional peer dependency:** install `ical.js` with `pnpm add ical.js`. The component registers
+`text/calendar` and falls back to matching `.ics` filenames in `<lyra-document-viewer>`.
+
+## `lyra-archive-viewer`
+
+Lists entry names and human-readable uncompressed sizes inside a `.zip` archive using the optional
+`jszip` peer. It is listing-only: entry content is never rendered or previewed. Files are measured
+through JSZip's public async API, so every file is decompressed once up front to obtain its size;
+there is no cheaper public uncompressed-size API. The list composes `<lyra-virtual-list>` for large
+archives.
+
+**Properties:** `src` and `name` are strings.
+
+**Events:** `lyra-render-error` with `detail.error` when fetching or parsing fails.
+
+**CSS parts:** `base`, `entry`, `entry-icon`, `entry-name`, `entry-size`, `spinner`, and `error`.
+
+**Exports:** `ArchiveEntry` — `{ name: string; dir: boolean; size: number }`.
+
+**Optional peer dependency:** install `jszip` with `pnpm add jszip`. The lazy registry registers
+`application/zip` and `application/x-zip-compressed`, with a `.zip` filename fallback, and imports
+the viewer only when a matching archive is opened. `.tar`, `.rar`, and other archive formats fall
+through to `<lyra-document-preview>`'s generic download fallback.
+
+## `lyra-ebook-viewer`
+
+Renders EPUB ebooks through the optional `epubjs` peer. `src` is fetched as an `ArrayBuffer`, and
+epub.js renders the reading area into its stable `mount` element, using an internal iframe for
+chapter content.
+
+**Properties:** `src` and `name` are strings. `accessibleLabel` (attribute `aria-label`) overrides
+the reading region's accessible name.
+
+**Events:** `lyra-render-error` with `detail.error` when fetching, opening, or rendering fails.
+
+**CSS parts:** `base`, `toolbar`, `previous-button`, `next-button`, `previous-icon`, `next-icon`,
+`mount`, and `error`.
+
+**Optional peer dependency:** install `epubjs` with `pnpm add epubjs`. The document-viewer registry
+matches `application/epub+zip` and `.epub` filenames.
+
+## `lyra-pptx-viewer`
+
+Best-effort client-side PPTX viewer backed by the optional `@aiden0z/pptx-renderer` peer. A
+localized fidelity notice is always visible because animations, equations, embedded objects,
+speaker notes, and several advanced effects are not rendered.
+
+**Properties:** `src`, `name`, and `label` are strings. A host `aria-label` also names the viewer
+region when `label` is unset.
+
+**Methods:** `goToSlide(index)` returns a promise and navigates the mounted presentation.
+
+**Events:** `lyra-load` (`detail: { slideCount }`), `lyra-slide-change` (`detail: { index, count }`),
+and `lyra-render-error` with `detail.error`.
+
+**CSS parts:** `base`, `header`, `name`, `notice`, `error`, `nav`, `previous-button`,
+`previous-icon`, `slide-count`, `next-button`, `next-icon`, and `container`.
+
+**Optional peer dependency:** install `@aiden0z/pptx-renderer` with
+`pnpm add @aiden0z/pptx-renderer`. The registry matches the official PPTX MIME type and `.pptx`
+filenames.
+
+## `lyra-file-icon`
+
+Localized, tokenized file-format badge for surrounding upload rows, cards, selectors, and viewer
+headers. The companion `getFileTypeMetadata(mimeType, fileName?)` utility covers common document,
+spreadsheet, presentation, code, archive, image, audio, and video formats. An explicit known MIME
+type wins; filename extension fallback is used only for an empty or `application/octet-stream`
+MIME type. Unknown values return a generic file result.
+
+**Properties:** `mimeType` (attribute `mime-type`), `name`, `label`, `decorative`, and
+`variant: 'icon' | 'label'`.
+
+**CSS parts:** `base`, `icon`, and `label`.
+
+**Exports:** `LyraFileTypeMetadata`, `LyraFileTypeIcon`, `LyraFileTypeCategory`,
+`getFileTypeMetadata()`, and `registerFileTypeMetadata()` for application-specific mappings.
+
+```html
+<lyra-file-icon mime-type="application/pdf" variant="label"></lyra-file-icon>
+```
+
+## `lyra-svg-viewer`
+
+Fetches an SVG document, sanitizes it with the optional `dompurify` peer, and renders it inline.
+
+**Properties:** `src`, `name`, and `maxHeight` (attribute `max-height`) are strings. `maxHeight` caps
+the scrollable body.
+
+**Events:** `lyra-render-error` with `detail.error` when fetching or sanitizing fails.
+
+**CSS parts:** `base`, `body`, `svg`, `spinner`, and `error`.
+
+**Optional peer dependency:** `dompurify`.
+
+## `lyra-html-viewer`
+
+Fetches an HTML document, sanitizes it with the optional `dompurify` peer, and renders the safe markup
+inside a bounded, scrollable body.
+
+**Properties:** `src`, `name`, and `maxHeight` (attribute `max-height`) are strings.
+
+**Events:** `lyra-render-error` with `detail.error` when fetching or sanitizing fails.
+
+**CSS parts:** `base`, `body`, `html`, `spinner`, and `error`.
+
+**Optional peer dependency:** `dompurify`.
+
+## `lyra-dataset-viewer`
+
+Fetches tab-, pipe-, or delimiter-separated text and renders an accessible table using the optional
+`papaparse` peer. The document registry matches `.tsv`, `.psv`, and `.dat` filenames.
+
+**Properties:** `src`, `name`, and `maxHeight` (attribute `max-height`) are strings.
+
+**Events:** `lyra-render-error` with `detail.error` when fetching or parsing fails.
+
+**CSS parts:** `base`, `body`, `table`, `spinner`, and `error`.
+
+**Exports:** `DatasetTable` is `{ fields: string[]; rows: Record<string, string>[] }`.
+
+**Optional peer dependency:** `papaparse`.
+
+## `lyra-contact-viewer`
+
+Fetches a vCard document and renders one accessible card per contact. The document registry matches
+`.vcf` filenames and common `FN`, `N`, `ORG`, `TEL`, `EMAIL`, and `ADR` fields are displayed.
+
+**Properties:** `src`, `name`, and `maxHeight` (attribute `max-height`) are strings.
+
+**Events:** `lyra-render-error` with `detail.error` when fetching or parsing fails.
+
+**CSS parts:** `base`, `body`, `contact`, `contact-name`, `contact-org`, `contact-tel`,
+`contact-email`, `contact-adr`, `spinner`, and `error`.
+
+**Exports:** `parseVCards()` and the `VCardName`, `VCardTypedValue`, `VCardAddress`, and `VCardContact`
+types.
+
+## `lyra-pdf-viewer`
+
+Fetches a PDF and renders its pages with the optional `pdfjs-dist` peer. Pages are virtualized through
+`lyra-virtual-list`, and PDF.js's selectable text layer is positioned over each rendered canvas.
+
+**Properties:** `src` and `name` are strings. `page: number = 1` is the one-based current page and
+`zoom: number = 1` is clamped to `0.25`–`4`.
+
+**Events:** `lyra-render-error` with `detail.error` when fetching, parsing, or rendering fails;
+`lyra-page-change` with `{ page, pageCount }`; and `lyra-zoom-change` with `{ zoom }`.
+
+**Methods:** `nextPage()`, `previousPage()`, `zoomIn()`, and `zoomOut()` update the corresponding
+controlled state within its supported range.
+
+**CSS parts:** `base`, `toolbar`, `page-indicator`, `zoom-indicator`, `pages`, `page`, `text-layer`,
+`spinner`, and `error`.
+
+**Optional peer dependency:** install `pdfjs-dist` with `pnpm add pdfjs-dist`. The component registers
+a lazy `application/pdf` renderer with `<lyra-document-viewer>` so the PDF library is loaded only when
+a PDF is opened.
+
+## `lyra-spreadsheet-viewer`
+
+Fetches and renders `.xlsx` and `.xls` workbooks with the optional `xlsx` (SheetJS) peer. Multiple
+worksheets render through a `<lyra-tabs>` switcher, and body rows use `<lyra-virtual-list>`.
+
+**Properties:** `src` and `name` are strings.
+
+**Events:** `lyra-render-error` with `detail.error` when fetching or parsing fails.
+
+**CSS parts:** `base`, `tabs`, `sheet`, `header-row`, `data-row`, `cell`, `rows`, `spinner`, and
+`error`.
+
+**Optional peer dependency:** install `xlsx` with `pnpm add xlsx`. The registry matches the official
+`.xlsx` and `.xls` MIME types and filename extensions.
+
+## `lyra-csv-viewer`
+
+Fetches CSV text, parses quoted fields with the optional `papaparse` peer, and virtualizes body rows.
+
+**Properties:** `src` and `name` are strings. `hasHeaderRow: boolean = true` (attribute
+`has-header-row`) controls whether the first parsed row is rendered as a sticky header.
+
+**Events:** `lyra-render-error` with `detail.error` when fetching or parsing reports an error.
+
+**CSS parts:** `base`, `sheet`, `header-row`, `data-row`, `cell`, `rows`, `spinner`, and `error`.
+
+**Optional peer dependency:** install `papaparse` with `pnpm add papaparse`. The registry matches
+`text/csv` and `.csv` filenames.
+
+---
+
 ## `lyra-media-card`
 
 A lightweight inline preview for one already-sent, already-available attachment inside a rendered
@@ -8360,7 +8683,7 @@ These apply across the whole library rather than to any one component:
 - **Independence and migration.** Lyra has no runtime, theme, or design-token dependency on
   Shoelace or Web Awesome. The documented `wa-*` comparisons are migration references only; Lyra's
   own `lyra-*` tokens, events, localization runtime, and implementation are the source of truth.
-  For a staged Web Awesome migration, map existing `--wa-*` values to `--lyra-theme-*` explicitly
+  For a staged Web Awesome migration, map existing external theme-input values to `--lyra-theme-*` explicitly
   in application CSS instead of relying on an implicit compatibility layer.
 
 - **Internationalization.** Built-in UI copy, accessible names, descriptions, validation messages,

package/llms.txt

@@ -74,7 +74,8 @@ The catalog is grouped by capability; `llms-full.txt` follows the same consumer-
   `lyra-thinking-panel`, `lyra-generation-status`, `lyra-code-block` (needs the optional peer
   `shiki`), `lyra-tool-approval-dialog`, `lyra-tool-param-form`, `lyra-menu`/`lyra-menu-item`,
   `lyra-chip`/`lyra-chip-group`, `lyra-model-settings-panel`, `lyra-context-meter`,
-  `lyra-dock-panel`, `lyra-document-preview`, `lyra-media-card`, `lyra-attachment-trigger`,
+  `lyra-dock-panel`, `lyra-document-preview`, `lyra-document-viewer`, `lyra-svg-viewer`, `lyra-html-viewer`,
+  `lyra-dataset-viewer`, `lyra-contact-viewer`, `lyra-pdf-viewer`, `lyra-spreadsheet-viewer`, `lyra-csv-viewer`, `lyra-docx-viewer`, `lyra-email-viewer`, `lyra-calendar-viewer`, `lyra-archive-viewer`, `lyra-ebook-viewer`, `lyra-pptx-viewer`, `lyra-file-icon`, `lyra-media-card`, `lyra-attachment-trigger`,
   `lyra-kbd`, `lyra-result-card`/`lyra-result-field`, `lyra-avatar`, `lyra-card`, `lyra-stepper`,
   `lyra-segmented`, `lyra-diff-view`, `lyra-poll-status`, `lyra-code-block-core` (needs the
   optional peer `shiki`).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aceshooting/lyra-ui",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "description": "Free, independent Lit web components: an open-source alternative to Shoelace and Web Awesome with accessible forms, dashboards, charts, and agent UI.",
   "keywords": [
     "web-components",
@@ -64,6 +64,8 @@
     "./dist/components/attachment-chip/attachment-chip.js",
     "./dist/components/attachment-trigger/attachment-trigger.js",
     "./dist/components/avatar/avatar.js",
+    "./dist/components/archive-viewer/archive-viewer.js",
+    "./dist/components/archive-viewer/archive-viewer-register.js",
     "./dist/components/button/button.js",
     "./dist/components/button-group/button-group.js",
     "./dist/components/card/card.js",
@@ -101,6 +103,21 @@
     "./dist/components/diff-view/diff-view.js",
     "./dist/components/dock-panel/dock-panel.js",
     "./dist/components/document-preview/document-preview.js",
+    "./dist/components/document-viewer/document-viewer.js",
+    "./dist/components/ebook-viewer/ebook-viewer.js",
+    "./dist/components/ebook-viewer/ebook-viewer-register.js",
+    "./dist/components/pptx-viewer/pptx-viewer.js",
+    "./dist/components/file-icon/file-icon.js",
+    "./dist/components/contact-viewer/contact-viewer.js",
+    "./dist/components/dataset-viewer/dataset-viewer.js",
+    "./dist/components/html-viewer/html-viewer.js",
+    "./dist/components/pdf-viewer/pdf-viewer.js",
+    "./dist/components/spreadsheet-viewer/spreadsheet-viewer.js",
+    "./dist/components/csv-viewer/csv-viewer.js",
+    "./dist/components/docx-viewer/docx-viewer.js",
+    "./dist/components/email-viewer/email-viewer.js",
+    "./dist/components/calendar-viewer/calendar-viewer.js",
+    "./dist/components/svg-viewer/svg-viewer.js",
     "./dist/components/details/details.js",
     "./dist/components/details/accordion.js",
     "./dist/components/details/accordion-item.js",
@@ -198,6 +215,8 @@
     "./src/components/attachment-chip/attachment-chip.ts",
     "./src/components/attachment-trigger/attachment-trigger.ts",
     "./src/components/avatar/avatar.ts",
+    "./src/components/archive-viewer/archive-viewer.ts",
+    "./src/components/archive-viewer/archive-viewer-register.ts",
     "./src/components/button/button.ts",
     "./src/components/button-group/button-group.ts",
     "./src/components/card/card.ts",
@@ -235,6 +254,21 @@
     "./src/components/diff-view/diff-view.ts",
     "./src/components/dock-panel/dock-panel.ts",
     "./src/components/document-preview/document-preview.ts",
+    "./src/components/document-viewer/document-viewer.ts",
+    "./src/components/ebook-viewer/ebook-viewer.ts",
+    "./src/components/ebook-viewer/ebook-viewer-register.ts",
+    "./src/components/pptx-viewer/pptx-viewer.ts",
+    "./src/components/file-icon/file-icon.ts",
+    "./src/components/contact-viewer/contact-viewer.ts",
+    "./src/components/dataset-viewer/dataset-viewer.ts",
+    "./src/components/html-viewer/html-viewer.ts",
+    "./src/components/pdf-viewer/pdf-viewer.ts",
+    "./src/components/spreadsheet-viewer/spreadsheet-viewer.ts",
+    "./src/components/csv-viewer/csv-viewer.ts",
+    "./src/components/docx-viewer/docx-viewer.ts",
+    "./src/components/email-viewer/email-viewer.ts",
+    "./src/components/calendar-viewer/calendar-viewer.ts",
+    "./src/components/svg-viewer/svg-viewer.ts",
     "./src/components/details/details.ts",
     "./src/components/details/accordion.ts",
     "./src/components/details/accordion-item.ts",
@@ -338,6 +372,7 @@
   },
   "peerDependencies": {
     "@aceshooting/lyra-flags": "^1.3.0",
+    "@aiden0z/pptx-renderer": "^1.2.4",
     "@sgratzl/chartjs-chart-boxplot": "^4.4.0",
     "chart.js": "^4.5.0",
     "chartjs-plugin-zoom": "^2.2.0",
@@ -346,10 +381,18 @@
     "d3-selection": "^3.0.0",
     "d3-zoom": "^3.0.0",
     "dompurify": "^3.4.12",
+    "epubjs": "^0.3.93",
+    "ical.js": "^2.2.1",
+    "jszip": "^3.10.1",
     "libphonenumber-js": ">=1.11.0 <2",
+    "mammoth": "^1.12.0",
     "maplibre-gl": "^5.24.0",
     "marked": "^18.0.6",
-    "shiki": "^4.3.1"
+    "papaparse": "^5.5.3",
+    "pdfjs-dist": "^6.1.200",
+    "postal-mime": "^2.7.5",
+    "shiki": "^4.3.1",
+    "xlsx": "^0.18.5"
   },
   "peerDependenciesMeta": {
     "@aceshooting/lyra-flags": {
@@ -358,6 +401,9 @@
     "@sgratzl/chartjs-chart-boxplot": {
       "optional": true
     },
+    "@aiden0z/pptx-renderer": {
+      "optional": true
+    },
     "d3-force": {
       "optional": true
     },
@@ -379,21 +425,46 @@
     "dompurify": {
       "optional": true
     },
+    "epubjs": {
+      "optional": true
+    },
+    "ical.js": {
+      "optional": true
+    },
+    "jszip": {
+      "optional": true
+    },
     "libphonenumber-js": {
       "optional": true
     },
+    "mammoth": {
+      "optional": true
+    },
     "maplibre-gl": {
       "optional": true
     },
     "marked": {
       "optional": true
     },
+    "postal-mime": {
+      "optional": true
+    },
+    "papaparse": {
+      "optional": true
+    },
+    "pdfjs-dist": {
+      "optional": true
+    },
     "shiki": {
       "optional": true
+    },
+    "xlsx": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@aceshooting/lyra-flags": "^1.3.0",
+    "@aiden0z/pptx-renderer": "^1.2.4",
     "@custom-elements-manifest/analyzer": "^0.11.0",
     "@open-wc/testing": "^4.0.0",
     "@sgratzl/chartjs-chart-boxplot": "^4.4.5",
@@ -402,6 +473,7 @@
     "@types/d3-force": "^3.0.10",
     "@types/d3-selection": "^3.0.11",
     "@types/d3-zoom": "^3.0.8",
+    "@types/papaparse": "^5.5.2",
     "@types/sinonjs__fake-timers": "^15.0.1",
     "@web/dev-server-esbuild": "^2.0.0",
     "@web/test-runner": "^1.0.0",
@@ -413,11 +485,19 @@
     "d3-selection": "^3.0.0",
     "d3-zoom": "^3.0.0",
     "dompurify": "^3.4.12",
+    "epubjs": "^0.3.93",
+    "ical.js": "^2.2.1",
+    "jszip": "^3.10.1",
+    "mammoth": "^1.12.0",
     "maplibre-gl": "^5.24.0",
     "marked": "^18.0.6",
+    "papaparse": "^5.5.3",
+    "pdfjs-dist": "^6.1.200",
     "playwright": "^1.61.1",
+    "postal-mime": "^2.7.5",
     "shiki": "^4.3.1",
-    "typescript": "^7.0.2"
+    "typescript": "^7.0.2",
+    "xlsx": "^0.18.5"
   },
   "customElements": "custom-elements.json",
   "scripts": {