pith-ui 0.1.0 → 0.1.4

package/dist/files/panels.js

@@ -1,8 +1,13 @@
 import { dialogHeading, escape, icon, uniqueId, setText } from '../dom.js';
 import { createPagedPreview } from '../content/paged-preview.js';
+import { adoptProductParts } from '../foundations.js';
+import { createButton } from '../primitives.js';
+import { bindContentClose, installAnchoredSurface } from '../surface.js';
+import { reconcileKeyed } from '../reconcile.js';
 export function fileActionsMarkup(options) {
-    const attributes = `data-file-kind="${escape(options.kind)}" data-file-owner="${escape(options.ownerId)}" data-file-path="${escape(options.path)}"`;
-    const preview = options.preview ? `<button type="button" class="pui-secondary-button" data-preview-path="${escape(options.path)}" data-preview-id="${escape(options.ownerId)}">Preview</button>` : '';
+    const scope = `data-idle-action ${options.kind === 'resource' ? 'data-idle-workspace' : 'data-idle-conversation'}="${escape(options.ownerId)}"`;
+    const attributes = `${scope} data-file-kind="${escape(options.kind)}" data-file-owner="${escape(options.ownerId)}" data-file-path="${escape(options.path)}"`;
+    const preview = options.preview ? `<button type="button" class="pui-secondary-button" ${scope} data-preview-path="${escape(options.path)}" data-preview-id="${escape(options.ownerId)}">Preview</button>` : '';
     const copy = options.copyMode && options.copyMode !== 'none' ? `<button type="button" class="pui-secondary-button" ${attributes} data-file-action="${options.copyMode === 'file' ? 'copy' : 'copy-path'}">${options.copyMode === 'file' ? 'Copy file' : 'Copy path'}</button>` : '';
     return `<div class="pui-file-actions">${preview}<button type="button" class="pui-secondary-button" ${attributes} data-file-action="open">Open</button><button type="button" class="pui-secondary-button" ${attributes} data-file-action="reveal">Reveal</button>${copy}</div>`;
 }
@@ -10,14 +15,25 @@ export function createFileActions(options) {
     const template = document.createElement('template');
     template.innerHTML = fileActionsMarkup(options);
     const element = template.content.firstElementChild;
+    const parts = adoptProductParts(element);
+    let destroyed = false;
     const click = (event) => {
         const target = event.target.closest('button');
-        if (target && !target.disabled)
+        if (target && element.contains(target) && !target.disabled) {
+            event.stopPropagation();
             options.onAction?.(target.dataset.fileAction || 'preview');
+        }
     };
     if (options.onAction)
         element.addEventListener('click', click);
-    return { element, destroy() { element.removeEventListener('click', click); element.remove(); } };
+    return {
+        element,
+        setDisabled(disabled) { if (!destroyed)
+            for (const button of element.querySelectorAll('button'))
+                parts.action(button).update({ disabled }); },
+        destroy() { if (destroyed)
+            return; destroyed = true; parts.destroy(); element.removeEventListener('click', click); element.remove(); },
+    };
 }
 export function createArtifactPanel(options) {
     const { container: element, control, toggle, count } = options;
@@ -26,26 +42,37 @@ export function createArtifactPanel(options) {
     const loading = element.querySelector('[role="status"]');
     const rows = element.querySelector('[data-file-rows]');
     const error = element.querySelector('[role="alert"]');
+    const parts = adoptProductParts(element);
     const entries = new Map();
-    let open = false;
     let destroyed = false;
+    const surface = installAnchoredSurface({
+        trigger: toggle,
+        panel: element,
+        position: false,
+        closeOnFocusOut: true,
+        exclusions: [control, ...(options.dismissExclusions ?? [])],
+        canOpen: () => !control.hidden,
+        canEscape: () => !document.querySelector('dialog[open]'),
+        onToggle(open) { if (open)
+            element.focus(); },
+    });
     function setOpen(value, restoreFocus = false) {
         if (destroyed)
             return;
-        open = value && !control.hidden;
-        element.hidden = !open;
-        toggle.setAttribute('aria-expanded', String(open));
-        if (open)
-            element.focus();
-        else if (restoreFocus && !control.hidden)
-            toggle.focus();
+        if (value)
+            surface.open();
+        else
+            surface.close(restoreFocus && !control.hidden);
     }
+    const abort = new AbortController();
+    toggle.addEventListener('click', () => setOpen(!surface.isOpen()), { signal: abort.signal });
+    element.addEventListener('click', event => { if (event.target.closest('[data-artifacts-close]'))
+        setOpen(false, true); }, { signal: abort.signal });
     return {
-        element, setOpen, get open() { return open; },
+        element, setOpen, get open() { return surface.isOpen(); },
         update(state) {
             if (destroyed)
                 return;
-            const focused = document.activeElement;
             control.hidden = !state.ownerId || (!state.files.length && !state.error);
             if (control.hidden)
                 setOpen(false);
@@ -57,149 +84,218 @@ export function createArtifactPanel(options) {
             total.textContent = number;
             loading.hidden = !state.loading;
             error.hidden = !state.error;
-            error.textContent = state.error;
-            const keep = new Set(state.files.map(file => `${state.ownerId}/${file.path}`));
-            for (const [key, entry] of entries)
-                if (!keep.has(key)) {
-                    entry.element.remove();
-                    entries.delete(key);
-                }
-            let cursor = rows.firstElementChild;
-            for (const file of state.files) {
-                const key = `${state.ownerId}/${file.path}`;
-                let entry = entries.get(key);
-                if (!entry) {
+            parts.feedback(error).update({ message: state.error, tone: 'error' });
+            reconcileKeyed(rows, entries, state.files, {
+                key: file => `${state.ownerId}/${file.path}`,
+                element: entry => entry.element,
+                create(file) {
                     const article = document.createElement('article');
                     article.className = 'pui-file-card';
                     article.innerHTML = `${icon('file')}<div class="pui-file-info"><strong></strong><span class="pui-file-path">${escape(file.path)}</span></div>${fileActionsMarkup({ kind: 'artifact', ownerId: state.ownerId, path: file.path, preview: true, copyMode: state.copyMode })}`;
-                    entry = { element: article, name: article.querySelector('strong'), copy: article.querySelector('[data-file-action="copy"], [data-file-action="copy-path"]') };
-                    entries.set(key, entry);
-                }
-                setText(entry.name, file.name);
-                const copyAction = state.copyMode === 'file' ? 'copy' : 'copy-path';
-                if (entry.copy.dataset.fileAction !== copyAction)
-                    entry.copy.dataset.fileAction = copyAction;
-                if (entry.copy.dataset.copyPending !== 'true')
-                    setText(entry.copy, state.copyMode === 'file' ? 'Copy file' : 'Copy path');
-                if (entry.element !== cursor)
-                    rows.insertBefore(entry.element, cursor);
-                cursor = entry.element.nextElementSibling;
-            }
-            if (focused instanceof HTMLElement && element.contains(focused) && document.activeElement !== focused)
-                focused.focus({ preventScroll: true });
+                    return { element: article, name: article.querySelector('strong'), copy: article.querySelector('[data-file-action="copy"], [data-file-action="copy-path"]') };
+                },
+                update(entry, file) {
+                    setText(entry.name, file.name);
+                    const copyAction = state.copyMode === 'file' ? 'copy' : 'copy-path';
+                    if (entry.copy.dataset.fileAction !== copyAction)
+                        entry.copy.dataset.fileAction = copyAction;
+                    if (entry.copy.dataset.copyPending !== 'true')
+                        setText(entry.copy, state.copyMode === 'file' ? 'Copy file' : 'Copy path');
+                },
+                destroy() { },
+            });
+            parts.update();
         },
-        destroy() { destroyed = true; entries.clear(); element.replaceChildren(); },
+        destroy() { destroyed = true; surface.destroy(); abort.abort(); parts.destroy(); entries.clear(); element.replaceChildren(); },
     };
 }
 export function createResourcesPanel(options = {}) {
     const element = options.container || document.createElement('div');
     const ids = { titleId: options.titleId || uniqueId('pui-resources-title'), dialogId: options.dialogId || uniqueId('pui-resources-dialog'), listId: options.listId || uniqueId('pui-resources-list'), errorId: options.errorId || uniqueId('pui-resources-error') };
-    const close = (event) => {
-        if (!event.target.closest('[data-close]'))
-            return;
-        if (options.onClose)
-            options.onClose();
-        else {
-            const dialog = element.closest('dialog');
-            if (dialog?.open)
-                dialog.close();
-            else
-                element.hidden = true;
-        }
-    };
-    element.addEventListener('click', close);
+    const close = bindContentClose(element, { dialogId: ids.dialogId, onClose: options.onClose });
     let list, error;
     let destroyed = false;
-    function row(entry, type) {
+    const parts = adoptProductParts(element);
+    const buttons = [];
+    const rowButtons = [];
+    const sections = new Map();
+    let diagnostics;
+    let instructionButton;
+    const createActions = new Map();
+    let createDisabled = false;
+    const button = (label, onAction, row = false, create = false) => { const block = createButton({ label, appearance: 'secondary', onAction, disabled: create && createDisabled }); (row ? rowButtons : buttons).push(block); if (create)
+        createActions.set(block, label); return block.element; };
+    const clearButtons = (list = buttons) => { for (const block of list.splice(0)) {
+        createActions.delete(block);
+        block.destroy();
+    } };
+    function updateSlot(parent, slot, source) {
+        if (slot.source === source)
+            return;
+        for (const node of slot.nodes)
+            if (node.parentNode === parent)
+                node.remove();
+        slot.source = source;
+        slot.nodes = source ? source instanceof DocumentFragment ? [...source.childNodes] : [source] : [];
+    }
+    function row(type) {
         const outer = document.createElement('article');
         outer.className = type === 'instructions' ? 'pui-resource-card' : 'pui-file-card';
         const body = type === 'instructions' ? document.createElement('div') : outer;
         if (type === 'instructions')
             body.className = 'pui-file-card';
-        body.innerHTML = `${type === 'template' ? '' : icon('file')}<div class="pui-file-info"><strong>${escape(entry.name)}</strong>${type !== 'instructions' ? `<p>${escape(entry.description || '')}</p>` : ''}<span class="pui-file-path">${escape(entry.path)}</span></div>`;
-        if (entry.fileActions)
-            body.append(entry.fileActions);
-        if (entry.actions)
-            body.append(entry.actions);
+        body.innerHTML = `${type === 'template' ? '' : icon('file')}<div class="pui-file-info"><strong></strong>${type !== 'instructions' ? '<p></p>' : ''}<span class="pui-file-path"></span></div>`;
+        let content;
         if (type === 'instructions') {
             outer.append(body);
             const details = document.createElement('details');
             details.className = 'pui-resource-preview';
-            details.innerHTML = `<summary>View instructions</summary><pre>${escape(entry.content || '')}</pre>`;
+            details.innerHTML = '<summary>View instructions</summary><pre></pre>';
             outer.append(details);
+            content = details.querySelector('pre');
+        }
+        return { element: outer, body, name: body.querySelector('strong'), description: body.querySelector('p') || undefined, path: body.querySelector('.pui-file-path'), content, slots: [{ nodes: [] }, { nodes: [] }] };
+    }
+    function updateRow(row, entry) {
+        setText(row.name, entry.name);
+        setText(row.path, entry.path);
+        if (row.description)
+            setText(row.description, entry.description || '');
+        if (row.content)
+            setText(row.content, entry.content || '');
+        updateSlot(row.body, row.slots[0], entry.fileActions);
+        updateSlot(row.body, row.slots[1], entry.actions);
+        let cursor = row.body.querySelector('.pui-file-info').nextSibling;
+        for (const node of row.slots.flatMap(slot => slot.nodes)) {
+            if (node !== cursor)
+                row.body.insertBefore(node, cursor);
+            cursor = node.nextSibling;
         }
-        return outer;
+    }
+    function section() {
+        const element = document.createElement('section');
+        element.className = 'pui-resource-section';
+        return { element, rows: new Map(), create: { nodes: [] } };
     }
     return {
         element,
         open(workspaceName, toolbar) {
             if (destroyed)
                 return;
+            clearButtons();
+            clearButtons(rowButtons);
+            instructionButton = undefined;
+            sections.clear();
+            diagnostics = undefined;
             element.hidden = false;
             element.innerHTML = `${dialogHeading('Workspace resources', ids.titleId, ids.dialogId, workspaceName)}<p class="pui-modal-description">Instructions, skills and prompt templates are loaded by Pith for each task. Edit them here or open their Markdown files.</p><div class="pui-feature-toolbar" data-resources-toolbar></div><div id="${escape(ids.listId)}" data-resources-list><p class="pui-feature-hint">Loading workspace resources…</p></div><div id="${escape(ids.errorId)}" data-resources-error class="pui-form-error" role="alert"></div>`;
-            element.querySelector('[data-resources-toolbar]').append(toolbar);
+            const actions = element.querySelector('[data-resources-toolbar]');
+            if (toolbar)
+                actions.append(toolbar);
+            else
+                actions.append(button('Refresh', () => options.onRefresh?.()), button('Add skill', () => options.onCreate?.('skill'), false, true), button('Add prompt template', () => options.onCreate?.('template'), false, true));
             list = element.querySelector('[data-resources-list]');
             error = element.querySelector('[data-resources-error]');
+            parts.layout(actions, 'toolbar').update({});
         },
         setError(message) { if (!destroyed && error)
-            error.textContent = message; },
+            parts.feedback(error).update({ message, tone: 'error' }); },
+        setCreateDisabled(disabled) { if (destroyed)
+            return; createDisabled = disabled; for (const [block, label] of createActions)
+            block.update({ label, appearance: 'secondary', disabled }); },
         update(state) {
             if (destroyed || !list)
                 return;
-            list.replaceChildren();
+            if (!sections.size)
+                list.replaceChildren();
             for (const [title, entries, type, empty] of [
                 ['Instructions', state.instructions, 'instructions', 'No workspace instructions found.'],
                 ['Skills', state.skills, 'skill', 'No skills found. Add .pi/skills/<skill-name>/SKILL.md in this workspace, then refresh.'],
                 ['Prompt templates', state.templates, 'template', 'No prompt templates yet.'],
             ]) {
-                const section = document.createElement('section');
-                section.className = 'pui-resource-section';
-                const heading = document.createElement('h3');
-                heading.textContent = title;
-                section.append(heading);
-                if (entries.length)
-                    entries.forEach((entry) => section.append(row(entry, type)));
-                else {
-                    const hint = document.createElement('p');
-                    hint.className = 'pui-feature-hint';
-                    hint.textContent = empty;
-                    section.append(hint);
+                let current = sections.get(type);
+                if (!current) {
+                    current = section();
+                    sections.set(type, current);
+                    list.append(current.element);
+                }
+                const items = [{ key: 'heading', kind: 'heading' }, ...entries.map(entry => ({ key: `entry:${entry.path}`, kind: 'entry', entry }))];
+                if (!entries.length)
+                    items.push({ key: 'empty', kind: 'empty' });
+                reconcileKeyed(current.element, current.rows, items, {
+                    key: item => item.key, element: row => row.element,
+                    create(item) {
+                        if (item.kind === 'entry')
+                            return row(type);
+                        const element = document.createElement(item.kind === 'heading' ? 'h3' : 'p');
+                        if (item.kind === 'empty')
+                            element.className = 'pui-feature-hint';
+                        return { element };
+                    },
+                    update(row, item) { if (item.entry)
+                        updateRow(row, item.entry);
+                    else
+                        setText(row.element, item.kind === 'heading' ? title : empty); },
+                    destroy() { },
+                });
+                if (type === 'instructions') {
+                    let create = state.createInstructions;
+                    if (!create && state.canCreateInstructions) {
+                        if (!instructionButton) {
+                            const element = button('Create AGENTS.md in this workspace', () => options.onCreate?.('instructions'), true, true);
+                            instructionButton = rowButtons.find(block => block.element === element);
+                        }
+                        create = instructionButton.element;
+                    }
+                    updateSlot(current.element, current.create, create);
+                    for (const node of current.create.nodes)
+                        if (node.parentNode !== current.element)
+                            current.element.append(node);
                 }
-                if (type === 'instructions' && state.createInstructions)
-                    section.append(state.createInstructions);
-                list.append(section);
             }
             if (state.diagnostics.length) {
-                const section = document.createElement('section');
-                section.className = 'pui-resource-section pui-resource-diagnostics';
-                section.innerHTML = `<h3>Resource notes</h3>${state.diagnostics.map((note) => `<p>${escape(note)}</p>`).join('')}`;
-                list.append(section);
+                if (!diagnostics) {
+                    diagnostics = section();
+                    diagnostics.element.classList.add('pui-resource-diagnostics');
+                    list.append(diagnostics.element);
+                }
+                reconcileKeyed(diagnostics.element, diagnostics.rows, [{ key: 'heading', text: 'Resource notes' }, ...state.diagnostics.map((text, index) => ({ key: `note:${index}`, text }))], {
+                    key: value => value.key, element: row => row.element,
+                    create(value) { return { element: document.createElement(value.key === 'heading' ? 'h3' : 'p') }; },
+                    update(row, value) { setText(row.element, value.text); }, destroy() { },
+                });
+            }
+            else if (diagnostics) {
+                diagnostics.element.remove();
+                diagnostics = undefined;
             }
+            parts.update();
         },
-        destroy() { destroyed = true; element.removeEventListener('click', close); element.replaceChildren(); },
+        destroy() { if (destroyed)
+            return; destroyed = true; clearButtons(); clearButtons(rowButtons); sections.clear(); diagnostics = undefined; parts.destroy(); close.destroy(); element.replaceChildren(); },
     };
 }
 export function createFilePreview(options = {}) {
     const element = options.container || document.createElement('div');
     const ids = { titleId: options.titleId || uniqueId('pui-preview-title'), dialogId: options.dialogId || uniqueId('pui-preview-dialog'), bodyId: options.bodyId || uniqueId('pui-preview-body') };
-    const close = (event) => {
-        if (!event.target.closest('[data-close]'))
-            return;
-        if (options.onClose)
-            options.onClose();
-        else {
-            const dialog = element.closest('dialog');
-            if (dialog?.open)
-                dialog.close();
-            else
-                element.hidden = true;
-        }
-    };
-    element.addEventListener('click', close);
+    const close = bindContentClose(element, { dialogId: ids.dialogId, onClose: options.onClose });
     let body;
     let page;
+    let image;
+    let note;
+    let mode;
     let destroyed = false;
-    function clear() { page?.destroy(); page = undefined; element.replaceChildren(); body = undefined; }
+    function clear() {
+        if (destroyed)
+            return;
+        page?.destroy();
+        page = undefined;
+        image = undefined;
+        note = undefined;
+        mode = undefined;
+        element.replaceChildren();
+        body = undefined;
+    }
     return {
         element, clear,
         open(input) {
@@ -214,32 +310,51 @@ export function createFilePreview(options = {}) {
         update(state) {
             if (destroyed || !body)
                 return;
-            page?.destroy();
-            page = undefined;
-            body.replaceChildren();
+            const nextMode = state.error ? 'error' : state.kind;
+            if (mode !== nextMode) {
+                page?.destroy();
+                page = undefined;
+                image = undefined;
+                note = undefined;
+                body.replaceChildren();
+                mode = nextMode;
+            }
             if (state.error)
-                body.textContent = state.error;
+                setText(body, state.error);
             else if (state.kind === 'image') {
-                const image = document.createElement('img');
-                image.className = 'pui-file-preview-image';
-                image.src = state.imageSrc || '';
-                image.alt = state.imageAlt || '';
-                image.setAttribute('role', 'button');
-                image.tabIndex = 0;
-                image.title = 'Click to enlarge';
-                body.append(image);
+                if (!image) {
+                    image = document.createElement('img');
+                    image.className = 'pui-file-preview-image';
+                    image.setAttribute('role', 'button');
+                    image.tabIndex = 0;
+                    image.title = 'Click to enlarge';
+                    body.append(image);
+                }
+                if (image.getAttribute('src') !== (state.imageSrc || ''))
+                    image.src = state.imageSrc || '';
+                if (image.alt !== (state.imageAlt || ''))
+                    image.alt = state.imageAlt || '';
             }
+            else if (page)
+                page.update({ text: state.text || '', kind: state.kind });
             else
-                page = createPagedPreview({ container: body, text: state.text || '', kind: state.kind });
+                page = createPagedPreview({ container: body, text: state.text || '', kind: state.kind, onCopyCode: options.onCopyCode });
             if (state.truncated) {
-                const note = document.createElement('p');
-                note.className = 'pui-preview-note';
-                note.textContent = 'Showing the first 8 MiB. Use Open for the complete file.';
-                body.append(note);
+                if (!note) {
+                    note = document.createElement('p');
+                    note.className = 'pui-preview-note';
+                    note.textContent = 'Showing the first 8 MiB. Use Open for the complete file.';
+                }
+                if (note.parentElement !== body)
+                    body.append(note);
+            }
+            else {
+                note?.remove();
+                note = undefined;
             }
         },
         destroy() { if (destroyed)
-            return; clear(); element.removeEventListener('click', close); destroyed = true; },
+            return; clear(); close.destroy(); destroyed = true; },
     };
 }
 //# sourceMappingURL=panels.js.map