@jungherz-de/notionkit-elements 1.6.0 → 1.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jungherz-de/notionkit-elements",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "Vanilla JavaScript Web Components wrapping the NotionKit CSS foundation – <nk-*> custom elements with Shadow DOM, automatic theme sync and native form participation.",
   "license": "MIT",
   "author": "Jungherz GmbH <info@jungherz.com> (https://www.jungherz.com)",
@@ -59,15 +59,15 @@
     "dark-mode"
   ],
   "peerDependencies": {
-    "@jungherz-de/notionkit": ">=1.6.0"
+    "@jungherz-de/notionkit": ">=1.8.0"
   },
   "devDependencies": {
-    "@jungherz-de/notionkit": "^1.6.0",
+    "@jungherz-de/notionkit": "^1.8.0",
+    "@playwright/test": "^1.50.0",
     "@rollup/plugin-node-resolve": "^15.0.0",
     "@rollup/plugin-terser": "^0.4.0",
-    "rollup": "^4.0.0",
-    "@playwright/test": "^1.50.0",
+    "pixelmatch": "^7.0.0",
     "pngjs": "^7.0.0",
-    "pixelmatch": "^7.0.0"
+    "rollup": "^4.0.0"
   }
 }

package/src/components/content/nk-bookmark.js

@@ -0,0 +1,67 @@
+import { NkElement } from '../../base.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/src/components/data/nk-database.js

@@ -6,16 +6,24 @@ import { NkElement } from '../../base.js';
 // </nk-database>
 // db.columns = [{ key: 'name', label: 'Name', type: 'text', icon: '📄', title: true }, { key: 'status', type: 'select', options: [...] }, …];
 // db.rows = [{ id: 1, icon: '🧭', name: '…', status: 'done', … }];
-// → <div class="nk-database"><div class="nk-db-tabs">…</div>…active view…</div>
+// <nk-btn slot="tools" variant="tool">Filter</nk-btn> … sit right of the tabs,
+// <nk-filter-bar slot="filters"> under them (NotionKit 1.7.0's toolbar).
+// → <div class="nk-database"><div class="nk-db-toolbar"><div class="nk-db-tabs">…</div>
+//     <div class="tools">…</div></div>…filters…active view…</div>
 // The tabs come from the child views; data is pushed into every view.
 class NkDatabase extends NkElement {
   static get observedAttributes() { return ['view', 'add-view']; }
 
   render() {
     this._box = this.createElement('div', ['nk-database']);
+    this._toolbar = this.createElement('div', ['nk-db-toolbar']);
     this._tabs = this.createElement('div', ['nk-db-tabs'], { role: 'tablist' });
+    const tools = this.createElement('div', ['tools']);
+    this._toolsSlot = this.createElement('slot', [], { name: 'tools' });
+    tools.appendChild(this._toolsSlot);
+    this._toolbar.append(this._tabs, tools);
     this._slot = document.createElement('slot');
-    this._box.append(this._tabs, this._slot);
+    this._box.append(this._toolbar, this.createElement('slot', [], { name: 'filters' }), this._slot);
     this._wrapper.appendChild(this._box);
     this._columns = []; this._rows = [];
     this._sync();
@@ -43,12 +51,11 @@ class NkDatabase extends NkElement {
       v.setData?.(this._columns, this._rows);
     }
     if (this.getBoolAttr('add-view')) {
-      const add = this.createElement('span', ['nk-db-tab'], { role: 'button', 'data-add': '', tabindex: '0' });
-      add.style.color = 'var(--nk-text-tertiary)';
+      const add = this.createElement('span', ['nk-db-tab', 'add'], { role: 'button', 'data-add': '', tabindex: '0' });
       add.textContent = '＋';
       this._tabs.appendChild(add);
     }
-    this._tabs.style.display = views.length ? '' : 'none';
+    this._toolbar.hidden = !views.length && !this._toolsSlot.assignedElements().length;
     this._current = current;
   }
 
@@ -70,6 +77,7 @@ class NkDatabase extends NkElement {
     this._tabs.addEventListener('click', this._onClick);
     this._tabs.addEventListener('keydown', this._onKey);
     this._slot.addEventListener('slotchange', this._onSlot);
+    this._toolsSlot.addEventListener('slotchange', this._onSlot);
     this._sync();
   }
 
@@ -77,6 +85,7 @@ class NkDatabase extends NkElement {
     this._tabs?.removeEventListener('click', this._onClick);
     this._tabs?.removeEventListener('keydown', this._onKey);
     this._slot?.removeEventListener('slotchange', this._onSlot);
+    this._toolsSlot?.removeEventListener('slotchange', this._onSlot);
   }
 
   onAttributeChanged(name) {

package/src/components/data/nk-filter-bar.js

@@ -1,60 +1,76 @@
 import { NkElement } from '../../base.js';
 
-// <nk-filter-bar search placeholder="Search rows …"></nk-filter-bar>
-// bar.filters = [{ key: 'status', label: 'Status: Done', value: 'done' }];
-// Composed from existing classes (nk-btn secondary small, nk-input, nk-tag):
-// filter / sort buttons fire nk-action, chips remove on ×, search and chip
-// changes fire nk-change { filters, search }. The wrapper is layout only.
+// <nk-filter-bar add no-filter no-sort></nk-filter-bar>
+// bar.filters = [{ key: 'status', value: 'done', op: 'is-not', label: 'Status: Open' }];
+// The filters in effect as NotionKit's filter pills (1.7.0), no inline style:
+// → <div class="nk-filter-row">[Filter][Sort]
+//     <span class="nk-filter-pill active"><button>Status: Open</button><button class="fp-remove">×</button></span>…
+//     <button class="nk-filter-pill add">＋ Filter</button> …slot… [search]</div>
+// Filter and Sort are .nk-db-tool buttons (hide them with no-filter / no-sort
+// when the database toolbar carries its own); they fire nk-action. A pill's
+// label fires nk-action { action: 'edit', index, filter }, the add pill
+// nk-action { action: 'add' } – each with the clicked button as `anchor`, to
+// open a menu under it. × removes the filter; every change to filters or
+// search fires nk-change { filters, search }. In slot="filters" of
+// <nk-database> the row sits right under the view tabs. The texts are
+// attributes, for other languages: filter-label, sort-label, add-label,
+// remove-label (the × reads "<remove-label>: <pill>") and placeholder.
 class NkFilterBar extends NkElement {
-  static get observedAttributes() { return ['search', 'placeholder', 'no-filter', 'no-sort', 'value']; }
+  static get observedAttributes() { return ['search', 'placeholder', 'no-filter', 'no-sort', 'value', 'add', 'add-label', 'filter-label', 'sort-label', 'remove-label']; }
 
   render() {
-    this._bar = document.createElement('div');
-    this._bar.style.cssText = 'display:flex;align-items:center;gap:6px;flex-wrap:wrap;margin:8px 0';
-    this._filterBtn = this.createElement('button', ['nk-btn', 'secondary', 'small'], { type: 'button', 'data-action': 'filter' });
-    this._filterBtn.textContent = '⚲ Filter';
-    this._sortBtn = this.createElement('button', ['nk-btn', 'secondary', 'small'], { type: 'button', 'data-action': 'sort' });
-    this._sortBtn.textContent = '↕ Sort';
-    this._chips = document.createElement('span');
-    this._chips.style.cssText = 'display:inline-flex;gap:4px;flex-wrap:wrap';
+    this._row = this.createElement('div', ['nk-filter-row']);
+    this._filterBtn = this.createElement('button', ['nk-db-tool'], { type: 'button', 'data-action': 'filter' });
+    this._sortBtn = this.createElement('button', ['nk-db-tool'], { type: 'button', 'data-action': 'sort' });
+    this._pillStart = document.createComment('pills');
+    this._addBtn = this.createElement('button', ['nk-filter-pill', 'add'], { type: 'button', 'data-action': 'add' });
     this._input = this.createElement('input', ['nk-input'], { type: 'search', autocomplete: 'off' });
-    this._input.style.marginLeft = 'auto';
-    this._bar.append(this._filterBtn, this._sortBtn, this._chips, document.createElement('slot'), this._input);
-    this._wrapper.appendChild(this._bar);
+    this._row.append(this._filterBtn, this._sortBtn, this._pillStart, this._addBtn, document.createElement('slot'), this._input);
+    this._wrapper.appendChild(this._row);
     this._filters = [];
     this._sync();
   }
 
   _sync() {
-    this._filterBtn.style.display = this.getBoolAttr('no-filter') ? 'none' : '';
-    this._sortBtn.style.display = this.getBoolAttr('no-sort') ? 'none' : '';
-    this._input.style.display = this.getBoolAttr('search') ? '' : 'none';
+    this._filterBtn.textContent = this.getAttribute('filter-label') || 'Filter';
+    this._filterBtn.hidden = this.getBoolAttr('no-filter');
+    this._filterBtn.classList.toggle('active', this._filters.length > 0);
+    this._sortBtn.textContent = this.getAttribute('sort-label') || 'Sort';
+    this._sortBtn.hidden = this.getBoolAttr('no-sort');
+    this._addBtn.textContent = this.getAttribute('add-label') || '＋ Filter';
+    this._addBtn.hidden = !this.getBoolAttr('add');
+    this._input.hidden = !this.getBoolAttr('search');
     this._input.placeholder = this.getAttribute('placeholder') || 'Search …';
     if (this.hasAttribute('value') && this._input.value !== this.getAttribute('value')) this._input.value = this.getAttribute('value');
-    this._chips.replaceChildren();
-    this._filters.forEach((f, i) => {
-      const chip = this.createElement('span', ['nk-tag', f.color || 'blue'], { 'data-index': i });
-      chip.style.cursor = 'pointer';
-      chip.textContent = `${f.label ?? `${f.key}: ${f.value}`} ×`;
-      chip.title = 'Remove filter';
-      this._chips.appendChild(chip);
-    });
+    for (const old of this._row.querySelectorAll('[data-pill]')) old.remove();
+    const removeLabel = this.getAttribute('remove-label') || 'Remove filter';
+    this._pillStart.after(...this._filters.map((f, i) => {
+      const pill = this.createElement('span', ['nk-filter-pill', 'active'], { 'data-pill': i });
+      const label = this.createElement('button', [], { type: 'button', 'data-edit': i });
+      label.textContent = f.label ?? `${f.key}: ${f.value}`;
+      const remove = this.createElement('button', ['fp-remove'], { type: 'button', 'data-remove': i, 'aria-label': `${removeLabel}: ${label.textContent}` });
+      remove.textContent = '×';
+      pill.append(label, remove);
+      return pill;
+    }));
   }
 
   setupEvents() {
     this._onClick = (e) => {
+      const remove = e.target.closest('[data-remove]');
+      if (remove) { this._filters.splice(Number(remove.dataset.remove), 1); this._sync(); this._emitChange(); return; }
+      const edit = e.target.closest('[data-edit]');
+      if (edit) { const index = Number(edit.dataset.edit); this.emit('nk-action', { action: 'edit', index, filter: this._filters[index], anchor: edit }); return; }
       const btn = e.target.closest('[data-action]');
-      if (btn) { this.emit('nk-action', { action: btn.dataset.action }); return; }
-      const chip = e.target.closest('[data-index]');
-      if (chip) { this._filters.splice(Number(chip.dataset.index), 1); this._sync(); this._emitChange(); }
+      if (btn) this.emit('nk-action', { action: btn.dataset.action, anchor: btn });
     };
     this._onInput = () => { clearTimeout(this._debounce); this._debounce = setTimeout(() => this._emitChange(), 150); };
-    this._bar.addEventListener('click', this._onClick);
+    this._row.addEventListener('click', this._onClick);
     this._input.addEventListener('input', this._onInput);
   }
 
   teardownEvents() {
-    this._bar?.removeEventListener('click', this._onClick);
+    this._row?.removeEventListener('click', this._onClick);
     this._input?.removeEventListener('input', this._onInput);
     clearTimeout(this._debounce);
   }
@@ -63,13 +79,18 @@ class NkFilterBar extends NkElement {
   onAttributeChanged() { this._sync(); }
 
   get filters() { return this._filters; }
-  set filters(v) { this._filters = Array.isArray(v) ? v : []; this._sync(); }
+  set filters(v) { this._filters = Array.isArray(v) ? v : []; if (this._row) this._sync(); }
   get value() { return this._input?.value ?? ''; }
   set value(v) { if (this._input) this._input.value = v ?? ''; }
-  /** Applies filters + search to rows: equality per filter key, substring search over every string field. */
+  /**
+   * Applies filters and search to rows: a filter keeps rows where row[key]
+   * equals value – or differs from it with op: 'is-not'; the search looks
+   * for the text in every string field (a person's name).
+   */
   apply(rows) {
     const q = this.value.trim().toLowerCase();
-    return rows.filter(r => this._filters.every(f => r[f.key] === f.value) && (!q || Object.values(r).some(v => String(typeof v === 'object' && v ? v.name ?? '' : v ?? '').toLowerCase().includes(q))));
+    return rows.filter(r => this._filters.every(f => (f.op === 'is-not' ? r[f.key] !== f.value : r[f.key] === f.value))
+      && (!q || Object.values(r).some(v => String(typeof v === 'object' && v ? v.name ?? '' : v ?? '').toLowerCase().includes(q))));
   }
 }
 

package/src/components/forms/nk-btn.js

@@ -3,13 +3,16 @@ import { NkElement } from '../../base.js';
 // <nk-btn variant="primary" small>Save</nk-btn>   →  <button class="nk-btn primary small">
 // <nk-btn href="/docs" variant="secondary">Docs</nk-btn>  →  <a class="nk-btn secondary">
 // <nk-btn variant="topbar">⭐</nk-btn>  →  <button class="nk-topbar-btn">
+// <nk-btn variant="tool" active>Filter</nk-btn>  →  <button class="nk-db-tool active">  (slot="tools" of nk-database)
+// <nk-btn variant="sidebar" aria-label="Menu">☰</nk-btn>  →  <button class="nk-topbar-btn nk-sidebar-toggle">:
+//   shown on phones only, it opens the page's <nk-sidebar> as a drawer.
 //
 // Modifier classes become attributes. A slotted <svg> is sized by the
 // `.nk-btn ::slotted(svg)` twin; pass the icon itself, never wrapped.
 const VARIANTS = ['primary', 'secondary', 'danger', 'danger-solid', 'topbar', 'share'];
 
 class NkBtn extends NkElement {
-  static get observedAttributes() { return ['variant', 'small', 'disabled', 'type', 'href', 'title', 'aria-label']; }
+  static get observedAttributes() { return ['variant', 'small', 'disabled', 'type', 'href', 'title', 'aria-label', 'aria-haspopup', 'active']; }
 
   render() {
     this._build();
@@ -37,13 +40,22 @@ class NkBtn extends NkElement {
     else el.setAttribute('aria-disabled', disabled ? 'true' : 'false');
     const title = this.getAttribute('title');
     title ? el.setAttribute('title', title) : el.removeAttribute('title');
-    const label = this.getAttribute('aria-label');
-    label ? el.setAttribute('aria-label', label) : el.removeAttribute('aria-label');
+    // The accessible name and the popup hint belong on the button itself.
+    for (const name of ['aria-label', 'aria-haspopup']) {
+      const v = this.getAttribute(name);
+      v ? el.setAttribute(name, v) : el.removeAttribute(name);
+    }
+    if (this.getAttribute('variant') === 'sidebar') el.setAttribute('aria-expanded', this._sidebar()?.open ? 'true' : 'false');
+    else el.removeAttribute('aria-expanded');
   }
 
+  /** The sidebar the ☰ opens: the one in its own app, else the page's. */
+  _sidebar() { return this.closest('nk-app')?.querySelector('nk-sidebar') ?? document.querySelector('nk-sidebar'); }
+
   setupEvents() {
     this._onClick = (e) => {
       if (this.getBoolAttr('disabled')) { e.preventDefault(); e.stopPropagation(); return; }
+      if (this.getAttribute('variant') === 'sidebar') { this._sidebar()?.toggle?.(); return; }
       // A button inside a shadow root is not a submit button of the outer
       // form; forward the intent to the form the host sits in.
       const type = this.getAttribute('type');
@@ -52,11 +64,17 @@ class NkBtn extends NkElement {
         if (form) type === 'submit' ? form.requestSubmit() : form.reset();
       }
     };
+    // The ☰ says whether its drawer is open, however the drawer closed.
+    this._onToggle = (e) => {
+      if (this.getAttribute('variant') === 'sidebar' && e.target === this._sidebar()) this._btn.setAttribute('aria-expanded', e.detail.open ? 'true' : 'false');
+    };
     this._btn.addEventListener('click', this._onClick);
+    document.addEventListener('nk-toggle', this._onToggle);
   }
 
   teardownEvents() {
     this._btn?.removeEventListener('click', this._onClick);
+    document.removeEventListener('nk-toggle', this._onToggle);
   }
 
   onAttributeChanged(name) {
@@ -66,7 +84,11 @@ class NkBtn extends NkElement {
         this._build();
         break;
       case 'variant':
+        this._btn.className = this._computeClasses().join(' ');
+        this._applyState(this._btn);
+        break;
       case 'small':
+      case 'active':
         this._btn.className = this._computeClasses().join(' ');
         break;
       case 'type':
@@ -81,6 +103,8 @@ class NkBtn extends NkElement {
     const variant = this.getAttribute('variant');
     if (variant === 'topbar') return ['nk-topbar-btn'];
     if (variant === 'share') return ['nk-topbar-btn', 'nk-share-btn'];
+    if (variant === 'sidebar') return ['nk-topbar-btn', 'nk-sidebar-toggle'];
+    if (variant === 'tool') return this.getBoolAttr('active') ? ['nk-db-tool', 'active'] : ['nk-db-tool'];
     const classes = ['nk-btn'];
     if (VARIANTS.includes(variant)) classes.push(variant);
     if (this.getBoolAttr('small')) classes.push('small');
@@ -92,6 +116,8 @@ class NkBtn extends NkElement {
 
   get variant() { return this.getAttribute('variant'); }
   set variant(v) { v ? this.setAttribute('variant', v) : this.removeAttribute('variant'); }
+  get active() { return this.getBoolAttr('active'); }
+  set active(v) { this.setBoolAttr('active', v); }
   get small() { return this.getBoolAttr('small'); }
   set small(v) { this.setBoolAttr('small', v); }
   get disabled() { return this.getBoolAttr('disabled'); }

package/src/components/forms/nk-copy-field.js

@@ -0,0 +1,86 @@
+import { NkElement } from '../../base.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/src/components/forms/nk-image-picker.js

@@ -0,0 +1,128 @@
+import { NkElement } from '../../base.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 };