@jungherz-de/notionkit-elements 1.7.0 → 1.8.0

package/README.md

@@ -1,17 +1,17 @@
 <h1 align="center">🧩 NotionKit Elements</h1>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/@jungherz-de/notionkit-elements"><img src="https://img.shields.io/badge/version-1.7.0-2383e2?style=flat-square" alt="Version"></a>
+  <a href="https://www.npmjs.com/package/@jungherz-de/notionkit-elements"><img src="https://img.shields.io/badge/version-1.8.0-2383e2?style=flat-square" alt="Version"></a>
   <a href="#"><img src="https://img.shields.io/badge/vanilla_JS-no_dependencies-448361?style=flat-square" alt="Vanilla JS"></a>
-  <a href="#"><img src="https://img.shields.io/badge/elements-79-529cca?style=flat-square" alt="79 Elements"></a>
+  <a href="#"><img src="https://img.shields.io/badge/elements-83-529cca?style=flat-square" alt="83 Elements"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-9065b0?style=flat-square" alt="MIT License"></a>
-  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/changelog-v1.7.0-lightgrey?style=flat-square" alt="Changelog"></a>
+  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/changelog-v1.8.0-lightgrey?style=flat-square" alt="Changelog"></a>
   <a href="https://www.npmjs.com/package/@jungherz-de/notionkit-elements"><img src="https://img.shields.io/badge/npm-%40jungherz--de%2Fnotionkit--elements-cb3837?style=flat-square&logo=npm" alt="npm"></a>
 </p>
 
 <p align="center">
   <strong>Drop-in Web Components for <a href="https://github.com/JUNGHERZ/NotionKit">NotionKit CSS</a></strong><br>
-  79 vanilla JavaScript custom elements wrapping NotionKit's calm, document-centric workspace look.<br>
+  83 vanilla JavaScript custom elements wrapping NotionKit's calm, document-centric workspace look.<br>
   Shadow DOM &middot; Native form participation &middot; Pixel parity with the class markup &middot; Zero dependencies.
 </p>
 
@@ -28,7 +28,7 @@
 
 ## ✨ What is NotionKit Elements?
 
-NotionKit Elements is the companion library to [NotionKit CSS](https://github.com/JUNGHERZ/NotionKit). It provides **79 Web Components** – from buttons and form controls over the sidebar, page tree and page shell with its properties to the settings modal, the bottom sheet, ⌘K palette, database views with Notion’s toolbar and AI thread – that encapsulate the class markup of the foundation into simple, declarative custom elements.
+NotionKit Elements is the companion library to [NotionKit CSS](https://github.com/JUNGHERZ/NotionKit). It provides **83 Web Components** – from buttons and form controls over the sidebar, page tree and page shell with its properties to the settings modal, the bottom sheet, the side peek, ⌘K palette, database views with Notion’s toolbar and AI thread – that encapsulate the class markup of the foundation into simple, declarative custom elements.
 
 It is the **app layer** of the NotionKit family – three layers, one design language: [NotionKit](https://notionkit.jungherz.com) is the pure-CSS foundation, NotionKit Elements wraps it into web components for application UIs, and [NotionKit Web](https://notionkit-web.jungherz.com) is the Astro template for complete websites on top of the same foundation. The word stem stays the same across the layers: `.nk-callout` becomes `<nk-callout>`, a modifier class becomes an attribute, a state class becomes a boolean attribute.
 
@@ -56,10 +56,10 @@ It is the **app layer** of the NotionKit family – three layers, one design lan
 |---|---|
 | 🎯 **Pixel parity** | Every element renders identically to its class markup – verified by a Playwright pixel test in light and dark; the reference app differs by 0.00 % from the class version |
 | 🔌 **Shadow DOM** | Each root adopts the NotionKit *components* sheet via `adoptedStyleSheets`; tokens are inherited from the document, so one `:root { --nk-accent: … }` re-brands everything |
-| 🧩 **79 Elements** | Forms, content blocks, app shell & tree with the ☰ drawer, page shell with properties, panels, avatars and steps, overlays (modal, sheet, ⌘K palette, menus that float in and become sheets on a phone, popover, emoji picker, toast), database table, board & list with toolbar and filter pills, comments, AI thread |
+| 🧩 **83 Elements** | Forms with copy field and image picker, content blocks with bookmarks, app shell & tree with the ☰ drawer, page shell with properties, panels, avatars and steps, overlays (modal, sheet, side peek, ⌘K palette, menus that float in and become sheets on a phone, popover, emoji picker, toast), database table, board & list with toolbar and filter pills, comments, AI thread |
 | 🎛️ **Form participation** | Input, textarea, select, switch, check, radio, slider, segmented and model card work natively with `<form>` via `ElementInternals`; radios group across shadow roots |
 | 🌗 **Theme sync** | One observer mirrors `data-theme` on `<html>` into every element |
-| 🪶 **Lightweight** | 211 KB minified / 41 KB gzipped (IIFE, foundation sheet included), no external dependencies |
+| 🪶 **Lightweight** | 225 KB minified / 44 KB gzipped (IIFE, foundation sheet included), no external dependencies |
 | 📦 **Four bundle shapes** | IIFE, minified IIFE, ESM, and per-component ESM entries on a stable `base.js`, which import NotionKit's sheet instead of carrying a copy |
 | 🤖 **AI-ready** | `SKILL.md` with copy-paste markup, six app skeletons and the rules – an agent given only that file built a working app in the release test |
 
@@ -71,8 +71,8 @@ It is the **app layer** of the NotionKit family – three layers, one design lan
 <!DOCTYPE html>
 <html lang="en" data-theme="light">
 <head>
-  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@jungherz-de/notionkit@1.7.1/notionkit.min.css">
-  <script src="https://cdn.jsdelivr.net/npm/@jungherz-de/notionkit-elements@1.7.0/dist/notionkit-elements.min.js"></script>
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@jungherz-de/notionkit@1.8.0/notionkit.min.css">
+  <script src="https://cdn.jsdelivr.net/npm/@jungherz-de/notionkit-elements@1.8.0/dist/notionkit-elements.min.js"></script>
 </head>
 <body class="nk-body">
   <nk-field label="Display name" desc="Shown next to your comments">
@@ -102,17 +102,17 @@ The per-component files import NotionKit's sheet as `@jungherz-de/notionkit/noti
 
 Do not mix the full bundle with the per-component files: each brings its own `NkElement`. With the bundle, take `componentsSheet` and `NkElement` from the bundle (`NotionKitElements.componentsSheet` from the `<script>` build).
 
-Two prerequisites, always: `notionkit.css` on the document (the peer dependency, `>= 1.7.1`; 1.7.0 brings the sheet, menus that float in and become sheets on a phone, the sidebar drawer, the database toolbar with filter pills and the steps, 1.7.1 minified files that carry all of it, 1.6.0 page properties, page options, list view, panels, prose and the avatar, 1.5.1 the safe areas, 1.5.0 the Notion-2025 tokens, the nine tag colours and the filled inputs; from 1.5.0 on, Elements and the foundation share one version number – the elements are built and tested against the same release) and `class="nk-body"` on `<body>`. The elements ship no visual CSS of their own – every rule comes from the foundation. The bundle injects the design tokens once as `@layer notionkit-defaults`, so any plain `:root { --nk-accent: … }` of yours re-brands every element in both themes.
+Two prerequisites, always: `notionkit.css` on the document (the peer dependency, `>= 1.8.0`; 1.8.0 brings the side peek, the bookmark, the copy field and pictures on the profile row, 1.7.0 the sheet, menus that float in and become sheets on a phone, the sidebar drawer, the database toolbar with filter pills and the steps, 1.7.1 minified files that carry all of it, 1.6.0 page properties, page options, list view, panels, prose and the avatar, 1.5.1 the safe areas, 1.5.0 the Notion-2025 tokens, the nine tag colours and the filled inputs; from 1.5.0 on, Elements and the foundation share one version number – the elements are built and tested against the same release) and `class="nk-body"` on `<body>`. The elements ship no visual CSS of their own – every rule comes from the foundation. The bundle injects the design tokens once as `@layer notionkit-defaults`, so any plain `:root { --nk-accent: … }` of yours re-brands every element in both themes.
 
 ## Elements
 
 | Group | Elements |
 |---|---|
-| Forms & controls | `nk-btn` `nk-input` `nk-textarea` `nk-select` `nk-switch` `nk-check` `nk-radio` `nk-slider` `nk-field` `nk-fields` |
-| Content | `nk-tag` `nk-progress` `nk-callout` `nk-divider` `nk-heading` `nk-toggle` `nk-todo` `nk-kbd` `nk-code` `nk-quote` |
+| Forms & controls | `nk-btn` `nk-input` `nk-textarea` `nk-select` `nk-switch` `nk-check` `nk-radio` `nk-slider` `nk-field` `nk-fields` `nk-copy-field` `nk-image-picker` |
+| Content | `nk-tag` `nk-progress` `nk-callout` `nk-bookmark` `nk-divider` `nk-heading` `nk-toggle` `nk-todo` `nk-kbd` `nk-code` `nk-quote` |
 | App shell & navigation | `nk-app` `nk-sidebar` `nk-workspace-switcher` `nk-section-label` `nk-tree` `nk-tree-item` `nk-topbar` `nk-breadcrumb` `nk-theme-toggle` `nk-tab-bar` `nk-tab-bar-item` |
 | Page shell & blocks | `nk-page` `nk-page-cover` `nk-page-title` `nk-page-actions` `nk-props` `nk-prop` `nk-panels` `nk-panel` `nk-avatar` `nk-block-host` `nk-banner` `nk-empty` `nk-skeleton` `nk-synced` `nk-tabs` `nk-tab` `nk-segmented` `nk-steps` `nk-stats` `nk-stat` `nk-avatar-group` `nk-mention` `nk-template-btn` `nk-model-card` `nk-profile-row` `nk-danger-zone` `nk-member-list` `nk-member-row` |
-| Overlays | `nk-modal` `nk-sheet` `nk-settings-pane` `nk-settings-user` `nk-cmdk` `nk-menu` `nk-menu-item` `nk-pop` `nk-emoji-picker` `nk-toast` |
+| Overlays | `nk-modal` `nk-sheet` `nk-peek` `nk-settings-pane` `nk-settings-user` `nk-cmdk` `nk-menu` `nk-menu-item` `nk-pop` `nk-emoji-picker` `nk-toast` |
 | Data & collaboration | `nk-database` `nk-table-view` `nk-board-view` `nk-list-view` `nk-filter-bar` `nk-comments` `nk-comment` `nk-ai-thread` `nk-ai-msg` `nk-ai-input-row` (+ the exported `renderPropertyCell()`) |
 
 Static content goes in through attributes and slots, dynamic data through properties (`tree.data`, `database.rows`, `palette.commands`). Interactions fire custom events with fixed names: `nk-select`, `nk-change`, `nk-view-change`, `nk-command`, `nk-toggle`, `nk-submit`, `nk-action`. No fetching, no two-way binding – the elements render what they get.
@@ -124,7 +124,7 @@ Static content goes in through attributes and slots, dynamic data through proper
 - Form controls are form-associated custom elements: `FormData`, `reset`, `required` and `<fieldset disabled>` just work. `<nk-radio>`s with the same `name` form a real group across shadow roots, with one tab stop and arrow keys.
 - Elements that copy light-DOM children (`nk-select` options, breadcrumb crumbs) watch them; `element.refresh()` is the escape hatch. Listeners are re-armed on every connect, so a moved element keeps working.
 - `::slotted()` matches only the assigned node: pass icons directly (`<span slot="icon">📁</span>`), never wrapped. For the same reason there is no `<nk-prose>`: rendered Markdown goes into a light-DOM `<div class="nk-prose">`, which reads the same rules as the editor adapter.
-- Overlays (`nk-modal`, `nk-sheet`, `nk-cmdk`, `nk-toast`, a floating `nk-menu`) go directly under `<body>`. The modal, the sheet and the palette lock scroll and make the rest of the page `inert`; they and the floating menu return focus to the control that had it.
+- Overlays (`nk-modal`, `nk-sheet`, `nk-peek`, `nk-cmdk`, `nk-toast`, a floating `nk-menu`) go directly under `<body>`. The modal, the sheet and the palette lock scroll and make the rest of the page `inert` – the side peek only as a sheet on a phone, beside the page it leaves it usable; all of them return focus to the control that had it.
 - The editor stays an adapter: `nk-block-host` is the shell, `docs-editor.js` the TipTap recipe (used in the demo app). `<nk-editor>` follows in v1.1 as an optional import, never in the core bundle.
 
 ## Development

package/dist/components/nk-bookmark.js

@@ -0,0 +1,69 @@
+import { NkElement } from './base.js';
+import '@jungherz-de/notionkit/notionkit-styles.js';
+
+// <nk-bookmark href="https://notionkit.jungherz.com" title="NotionKit" desc="…"
+//              favicon="favicon.svg" cover="og.jpg"></nk-bookmark>
+// → <a class="nk-bookmark" href="…" target="_blank" rel="noopener">
+//     <span class="bm-text"><span class="bm-title">…</span><span class="bm-desc">…</span>
+//       <span class="bm-url"><img class="bm-favicon"><span>…</span></span></span>
+//     <span class="bm-cover"><img></span></a>
+// Notion's link block (NotionKit 1.8.0), filled from what you know of the
+// page: og:title, og:description, og:image. `title` is the heading, never a
+// tooltip – see NkElement.takeTitle(); without it the host name stands in.
+// The address shown is `href`, or `url` where it should read differently. A
+// part without a value is left out, not hidden – the stylesheet gives the
+// description its own display. Opens in a new tab unless `target` says so.
+class NkBookmark extends NkElement {
+  static get observedAttributes() { return ['href', 'title', 'desc', 'favicon', 'cover', 'target', 'url']; }
+
+  render() {
+    this.takeTitle();
+    this._a = this.createElement('a', ['nk-bookmark']);
+    this._wrapper.appendChild(this._a);
+    this._sync();
+  }
+
+  _sync() {
+    if (!this._a) return;
+    const href = this.getAttribute('href') || '';
+    this._a.setAttribute('href', href);
+    const target = this.getAttribute('target') || '_blank';
+    this._a.setAttribute('target', target);
+    if (target === '_blank') this._a.setAttribute('rel', 'noopener'); else this._a.removeAttribute('rel');
+    let host = href;
+    try { host = new URL(href, location.href).host; } catch { /* keep the text */ }
+
+    const text = this.createElement('span', ['bm-text']);
+    const title = this.createElement('span', ['bm-title']);
+    title.textContent = this._titleText || host;
+    text.appendChild(title);
+    const desc = this.getAttribute('desc');
+    if (desc) { const d = this.createElement('span', ['bm-desc']); d.textContent = desc; text.appendChild(d); }
+    const url = this.createElement('span', ['bm-url']);
+    const favicon = this.getAttribute('favicon');
+    if (favicon) url.appendChild(this.createElement('img', ['bm-favicon'], { src: favicon, alt: '' }));
+    const address = document.createElement('span');
+    address.textContent = this.getAttribute('url') || href;
+    url.appendChild(address);
+    text.appendChild(url);
+    const parts = [text];
+    const cover = this.getAttribute('cover');
+    if (cover) { const c = this.createElement('span', ['bm-cover']); c.appendChild(this.createElement('img', [], { src: cover, alt: '' })); parts.push(c); }
+    this._a.replaceChildren(...parts);
+  }
+
+  onAttributeChanged(name, _old, value) {
+    if (name === 'title' && !this.takeTitle(value)) return;
+    this._sync();
+  }
+
+  focus(o) { this._a?.focus(o); }
+  get title() { return this._titleText ?? ''; }
+  set title(v) { this._titleText = v == null ? '' : String(v); this._sync(); }
+  get href() { return this.getAttribute('href') || ''; }
+  set href(v) { this.setAttribute('href', v); }
+}
+
+customElements.define('nk-bookmark', NkBookmark);
+
+export { NkBookmark };

package/dist/components/nk-copy-field.js

@@ -0,0 +1,88 @@
+import { NkElement } from './base.js';
+import '@jungherz-de/notionkit/notionkit-styles.js';
+
+// <nk-copy-field value="https://monahilft.notionkit.app"></nk-copy-field>
+// <nk-copy-field value="ntn_4f2…" secret mono></nk-copy-field>
+// → <div class="nk-copy-field mono"><span class="cf-value">…</span>
+//     <button class="cf-btn">Show</button><button class="cf-btn">Copy</button></div>
+// A value to take along – a link, an address, a key (NotionKit 1.8.0). Copy
+// writes it to the clipboard and says "Copied" in green for a moment; where
+// the clipboard is not allowed, the value is shown and selected instead, for
+// ⌘C. `secret` masks it behind a Show/Hide toggle; Copy still copies the
+// real value. `value` set as a property is not reflected, so a key never
+// lands in the markup. Fires nk-action { action: 'copy', value, ok }. The
+// texts are attributes: copy-label, copied-label, show-label, hide-label.
+class NkCopyField extends NkElement {
+  static get observedAttributes() { return ['value', 'mono', 'wrap', 'wide', 'secret', 'copy-label', 'copied-label', 'show-label', 'hide-label']; }
+
+  render() {
+    this._val ??= this.getAttribute('value') ?? '';
+    this._box = this.createElement('div', ['nk-copy-field']);
+    this._text = this.createElement('span', ['cf-value']);
+    this._show = this.createElement('button', ['cf-btn'], { type: 'button' });
+    this._copy = this.createElement('button', ['cf-btn'], { type: 'button' });
+    this._box.append(this._text, this._copy);
+    this._wrapper.appendChild(this._box);
+    this._sync();
+  }
+
+  _sync() {
+    if (!this._box) return;
+    for (const m of ['mono', 'wrap', 'wide']) this._box.classList.toggle(m, this.getBoolAttr(m));
+    const secret = this.getBoolAttr('secret');
+    this._text.textContent = secret && !this._revealed ? '•'.repeat(Math.min(this._val.length, 24)) : this._val;
+    // Not `hidden`: .cf-btn sets no display of its own that could lose to it,
+    // but a button that is not there cannot be tabbed to either.
+    if (secret && !this._show.isConnected) this._copy.before(this._show);
+    if (!secret) this._show.remove();
+    this._show.textContent = this._revealed ? (this.getAttribute('hide-label') || 'Hide') : (this.getAttribute('show-label') || 'Show');
+    this._show.setAttribute('aria-pressed', String(!!this._revealed));
+    this._copy.textContent = this._copied ? (this.getAttribute('copied-label') || 'Copied') : (this.getAttribute('copy-label') || 'Copy');
+    this._copy.classList.toggle('copied', !!this._copied);
+  }
+
+  setupEvents() {
+    this._onCopy = () => this.copy();
+    this._onShow = () => { this._revealed = !this._revealed; this._sync(); };
+    this._copy.addEventListener('click', this._onCopy);
+    this._show.addEventListener('click', this._onShow);
+  }
+
+  teardownEvents() {
+    this._copy?.removeEventListener('click', this._onCopy);
+    this._show?.removeEventListener('click', this._onShow);
+    clearTimeout(this._timer);
+  }
+
+  onAttributeChanged(name, _old, value) {
+    if (name === 'value') this._val = value ?? '';
+    this._sync();
+  }
+
+  /** Copies the value; resolves to whether the clipboard took it. */
+  async copy() {
+    const value = this._val;
+    let ok = true;
+    try { await navigator.clipboard.writeText(value); } catch { ok = false; }
+    if (ok) {
+      this._copied = true;
+      clearTimeout(this._timer);
+      this._timer = setTimeout(() => { this._copied = false; this._sync(); }, 1500);
+    } else {
+      this._revealed = true;
+    }
+    this._sync();
+    if (!ok) getSelection()?.selectAllChildren(this._text);
+    this.emit('nk-action', { action: 'copy', value, ok });
+    return ok;
+  }
+
+  get value() { return this._val ?? this.getAttribute('value') ?? ''; }
+  set value(v) { this._val = v == null ? '' : String(v); this._sync(); }
+  get secret() { return this.getBoolAttr('secret'); }
+  set secret(v) { this.setBoolAttr('secret', v); }
+}
+
+customElements.define('nk-copy-field', NkCopyField);
+
+export { NkCopyField };

package/dist/components/nk-image-picker.js

@@ -0,0 +1,130 @@
+import { NkElement } from './base.js';
+import '@jungherz-de/notionkit/notionkit-styles.js';
+
+// <nk-image-picker initials="MK" label="Profile picture"></nk-image-picker>
+// <nk-image-picker square initials="M" max="256" type="image/png"></nk-image-picker>
+// → <div class="nk-profile-row"><div class="big-avatar">MK | <img></div>
+//     <div class="pr-actions"><button class="nk-btn secondary small">Upload image</button>
+//       <button class="nk-btn secondary small pr-remove">Remove</button><input type="file" hidden></div></div>
+//
+// A picture for a person or a workspace (NotionKit 1.8.0): the profile row
+// with its actions, round – or `square`, a workspace icon. Ported from
+// GlassKit Elements' glk-image-picker: the file goes through
+// createImageBitmap with imageOrientation 'from-image' – the EXIF rotation
+// of a phone photo without a library – onto a canvas no larger than `max`
+// (default 512), out as `type` (default image/jpeg, on white; image/png
+// keeps transparency) at `quality` (0.82). The file input is hidden and
+// opened from a real button, and cleared after every pick, so the same file
+// can be chosen again. Not form-associated: listen to nk-change and upload
+// the data URL. `src` set as a property is not reflected, so megabytes of
+// data URL never land in the DOM.
+// Events: nk-change { dataUrl, width, height, size } after a pick, and on
+//         remove with an empty dataUrl; nk-error { message, name } when the
+//         file cannot be decoded (HEIC outside Safari, a broken file).
+// Texts:  choose-label, change-label, remove-label; label names the group.
+
+function dataUrlBytes(url) {
+  const b64 = url.slice(url.indexOf(',') + 1);
+  const padding = b64.endsWith('==') ? 2 : b64.endsWith('=') ? 1 : 0;
+  return Math.floor((b64.length * 3) / 4) - padding;
+}
+
+class NkImagePicker extends NkElement {
+  static get observedAttributes() { return ['src', 'initials', 'square', 'label', 'max', 'type', 'quality', 'accept', 'choose-label', 'change-label', 'remove-label']; }
+
+  render() {
+    this._src ??= this.getAttribute('src') || '';
+    this._row = this.createElement('div', ['nk-profile-row'], { role: 'group' });
+    this._avatar = this.createElement('div', ['big-avatar']);
+    const actions = this.createElement('div', ['pr-actions']);
+    this._choose = this.createElement('button', ['nk-btn', 'secondary', 'small'], { type: 'button' });
+    this._remove = this.createElement('button', ['nk-btn', 'secondary', 'small', 'pr-remove'], { type: 'button' });
+    this._input = this.createElement('input', [], { type: 'file', tabindex: '-1' });
+    this._input.hidden = true;
+    actions.append(this._choose, this._remove, this._input);
+    this._row.append(this._avatar, actions);
+    this._wrapper.appendChild(this._row);
+    this._sync();
+  }
+
+  get _max() { return Math.max(1, Math.floor(Number(this.getAttribute('max'))) || 512); }
+  get _type() { return this.getAttribute('type') || 'image/jpeg'; }
+  get _quality() { const q = Number(this.getAttribute('quality')); return this.hasAttribute('quality') && q >= 0 && q <= 1 ? q : 0.82; }
+
+  _sync() {
+    if (!this._row) return;
+    this._avatar.classList.toggle('square', this.getBoolAttr('square'));
+    if (!this._src) {
+      this._img = null;
+      this._avatar.textContent = this.getAttribute('initials') || '';
+    } else if (!this._img || this._img.getAttribute('src') !== this._src) {
+      this._img = this.createElement('img', [], { src: this._src, alt: '' });
+      this._avatar.replaceChildren(this._img);
+    }
+    const label = this.getAttribute('label');
+    if (label) this._row.setAttribute('aria-label', label); else this._row.removeAttribute('aria-label');
+    this._choose.textContent = this._src ? (this.getAttribute('change-label') || 'Change image') : (this.getAttribute('choose-label') || 'Upload image');
+    this._remove.textContent = this.getAttribute('remove-label') || 'Remove';
+    this._remove.hidden = !this._src;
+    this._input.accept = this.getAttribute('accept') || 'image/*';
+  }
+
+  async _pick(file) {
+    if (!file) return;
+    try {
+      const bitmap = await createImageBitmap(file, { imageOrientation: 'from-image' });
+      const scale = Math.min(1, this._max / Math.max(bitmap.width, bitmap.height));
+      const canvas = document.createElement('canvas');
+      canvas.width = Math.max(1, Math.round(bitmap.width * scale));
+      canvas.height = Math.max(1, Math.round(bitmap.height * scale));
+      const ctx = canvas.getContext('2d');
+      if (this._type === 'image/jpeg') {
+        // JPEG has no alpha; without this a transparent PNG comes out on black.
+        ctx.fillStyle = '#fff';
+        ctx.fillRect(0, 0, canvas.width, canvas.height);
+      }
+      ctx.drawImage(bitmap, 0, 0, canvas.width, canvas.height);
+      bitmap.close();
+      const dataUrl = canvas.toDataURL(this._type, this._quality);
+      this.src = dataUrl;
+      this.emit('nk-change', { dataUrl, width: canvas.width, height: canvas.height, size: dataUrlBytes(dataUrl) });
+    } catch (error) {
+      this.emit('nk-error', { message: error?.message || String(error), name: file.name });
+    }
+  }
+
+  setupEvents() {
+    this._onChoose = () => this._input.click();
+    this._onChange = (e) => { const file = e.target.files?.[0]; e.target.value = ''; this._pick(file); };
+    this._onRemove = () => {
+      this.src = '';
+      this._choose.focus();   // the remove button just went away under the focus
+      this.emit('nk-change', { dataUrl: '', width: 0, height: 0, size: 0 });
+    };
+    this._choose.addEventListener('click', this._onChoose);
+    this._input.addEventListener('change', this._onChange);
+    this._remove.addEventListener('click', this._onRemove);
+  }
+
+  teardownEvents() {
+    this._choose?.removeEventListener('click', this._onChoose);
+    this._input?.removeEventListener('change', this._onChange);
+    this._remove?.removeEventListener('click', this._onRemove);
+  }
+
+  onAttributeChanged(name, _old, value) {
+    if (name === 'src') this._src = value || '';
+    this._sync();
+  }
+
+  /** Opens the file dialog, as the button does. */
+  choose() { this._input?.click(); }
+  get src() { return this._src ?? this.getAttribute('src') ?? ''; }
+  set src(v) { this._src = v || ''; this._sync(); }
+  get square() { return this.getBoolAttr('square'); }
+  set square(v) { this.setBoolAttr('square', v); }
+}
+
+customElements.define('nk-image-picker', NkImagePicker);
+
+export { NkImagePicker };

package/dist/components/nk-peek.js

@@ -0,0 +1,122 @@
+import { NkElement } from './base.js';
+import { d as deepActiveElement, l as lockScroll, i as inertOutside, u as unlockScroll } from './shared/focus-BNAChOXO.js';
+import '@jungherz-de/notionkit/notionkit-styles.js';
+
+// <nk-peek id="peek" label="Database Table-View">
+//   <nk-btn slot="actions" variant="topbar" aria-label="Open as page"><svg …></svg></nk-btn>
+//   <nk-page-title>🗃️ Database Table-View</nk-page-title>
+//   <nk-props>…</nk-props>
+//   <div class="nk-prose">…</div>
+//   <nk-comments>…</nk-comments>
+// </nk-peek>
+// → <div class="nk-peek-backdrop open"><aside class="nk-peek" role="dialog">
+//     <div class="pk-bar"><button class="nk-topbar-btn">»</button>…actions…</div>
+//     <div class="pk-body">…</div></aside></div>
+//
+// Notion's side peek (NotionKit 1.8.0): a row beside the table, which stays
+// usable – no scrim, nothing inert. show() slides it in and moves focus to
+// it; », Escape and a click elsewhere on the page close it, and Escape and »
+// hand focus back. A click that calls show() again – on another row – only
+// swaps the content, and clicks inside other overlays (a menu opened from
+// the peek) leave it open. Below 860px it is a bottom sheet over a dimmed
+// page; there it is modal: the page is inert and scroll-locked, the dimmed
+// page takes the tap that closes it. Put it directly under <body>.
+const CLOSE_ICON = '<svg viewBox="0 0 24 24" aria-hidden="true"><path d="m6 17 5-5-5-5M13 17l5-5-5-5"/></svg>';
+const OVERLAYS = new Set(['nk-menu', 'nk-pop', 'nk-modal', 'nk-sheet', 'nk-cmdk', 'nk-toast']);
+const OVERLAY_CLASSES = ['nk-pop', 'nk-modal-backdrop', 'nk-sheet-backdrop', 'nk-cmdk-backdrop'];
+const phone = () => matchMedia('(max-width: 860px)').matches;
+
+class NkPeek extends NkElement {
+  static get observedAttributes() { return ['open', 'label', 'close-label']; }
+
+  render() {
+    this._backdrop = this.createElement('div', ['nk-peek-backdrop']);
+    this._box = this.createElement('aside', ['nk-peek'], { role: 'dialog', tabindex: '-1' });
+    const bar = this.createElement('div', ['pk-bar']);
+    this._close = this.createElement('button', ['nk-topbar-btn'], { type: 'button' });
+    this._close.innerHTML = CLOSE_ICON;
+    bar.append(this._close, this.createElement('slot', [], { name: 'actions' }));
+    const body = this.createElement('div', ['pk-body']);
+    body.appendChild(document.createElement('slot'));
+    this._box.append(bar, body);
+    this._backdrop.appendChild(this._box);
+    this._wrapper.appendChild(this._backdrop);
+    this._syncLabels();
+    this._syncOpen();
+  }
+
+  _syncLabels() {
+    const label = this.getAttribute('label');
+    if (label) this._box.setAttribute('aria-label', label); else this._box.removeAttribute('aria-label');
+    this._close.setAttribute('aria-label', this.getAttribute('close-label') || 'Close');
+  }
+
+  _syncOpen() {
+    const open = this.getBoolAttr('open');
+    this._backdrop.classList.toggle('open', open);
+    if (open === this._wasOpen) return;
+    this._wasOpen = open;
+    if (open) {
+      this._returnFocus = deepActiveElement();
+      if (phone()) {
+        this._modal = true;
+        this._box.setAttribute('aria-modal', 'true');
+        lockScroll();
+        this._undoInert = inertOutside(this);
+      }
+      requestAnimationFrame(() => this._box.focus({ preventScroll: true }));
+    } else {
+      if (this._modal) { this._modal = false; this._box.removeAttribute('aria-modal'); unlockScroll(); this._undoInert?.(); this._undoInert = null; }
+      const active = deepActiveElement();
+      const inside = active && (this.contains(active) || this._shadow.contains(active) || active === document.body);
+      const back = this._returnFocus;
+      this._returnFocus = null;
+      if (inside && back?.isConnected && typeof back.focus === 'function') back.focus({ preventScroll: true });
+    }
+  }
+
+  setupEvents() {
+    this._onClose = () => this.close();
+    this._onBackdrop = (e) => { if (e.target === this._backdrop) this.close(); };
+    this._onKey = (e) => { if (e.key === 'Escape' && this.getBoolAttr('open')) this.close(); };
+    // Bubble phase, after the page's own handlers: a click that showed the
+    // peek again (another row) must not close it.
+    this._onOutside = (e) => {
+      if (!this.getBoolAttr('open') || this._shownAt >= e.timeStamp) return;
+      const path = e.composedPath();
+      if (path.includes(this)) return;
+      if (path.some(n => n.nodeType === 1 && (OVERLAYS.has(n.localName) || OVERLAY_CLASSES.some(c => n.classList.contains(c))))) return;
+      this.close();
+    };
+    this._close.addEventListener('click', this._onClose);
+    this._backdrop.addEventListener('click', this._onBackdrop);
+    document.addEventListener('keydown', this._onKey);
+    document.addEventListener('click', this._onOutside);
+  }
+
+  teardownEvents() {
+    this._close?.removeEventListener('click', this._onClose);
+    this._backdrop?.removeEventListener('click', this._onBackdrop);
+    document.removeEventListener('keydown', this._onKey);
+    document.removeEventListener('click', this._onOutside);
+    if (this._modal) { this._modal = false; unlockScroll(); this._undoInert?.(); this._undoInert = null; }
+    this._wasOpen = false;
+  }
+
+  onAttributeChanged(name) {
+    if (name !== 'open') { this._syncLabels(); return; }
+    this._syncOpen();
+    this.emit('nk-toggle', { open: this.getBoolAttr('open') });
+  }
+
+  show() { this._shownAt = performance.now(); this.setBoolAttr('open', true); }
+  close() { this.setBoolAttr('open', false); }
+  toggle() { this.getBoolAttr('open') ? this.close() : this.show(); }
+
+  get open() { return this.getBoolAttr('open'); }
+  set open(v) { v ? this.show() : this.close(); }
+}
+
+customElements.define('nk-peek', NkPeek);
+
+export { NkPeek };