@swiftwc/ui 0.0.0-dev.1 → 0.0.0-dev.101

package/README.md

@@ -0,0 +1,15 @@
+# @swiftwc/ui
+
+[README](https://github.com/swiftwc/ui/blob/main/README.md)
+
+## Documentation
+
+Visit [swiftwc.github.io/ui/](https://swiftwc.github.io/ui/) to view the documentation.
+
+## Contributing
+
+Please read the [contributing guide](https://github.com/swiftwc/ui/blob/main/CONTRIBUTING.md).
+
+## License
+
+Licensed under the [MIT license](https://github.com/swiftwc/ui/blob/main/LICENSE.md).

package/generated/buses/alert-dialog.d.ts

@@ -0,0 +1,2 @@
+declare const _default: EventTarget;
+export default _default;

package/generated/buses/alert-dialog.js

@@ -0,0 +1 @@
+export default new EventTarget();

package/generated/buses/confirmation-dialog.d.ts

@@ -0,0 +1,2 @@
+declare const _default: EventTarget;
+export default _default;

package/generated/buses/confirmation-dialog.js

@@ -0,0 +1 @@
+export default new EventTarget();

package/generated/buses/index.d.ts

@@ -0,0 +1,6 @@
+export { default as alertDialog } from './alert-dialog';
+export * from './alert-dialog';
+export { default as confirmationDialog } from './confirmation-dialog';
+export * from './confirmation-dialog';
+export { default as lifecycleObserver } from './lifecycle-observer';
+export * from './lifecycle-observer';

package/generated/buses/index.js

@@ -0,0 +1,6 @@
+export { default as alertDialog } from './alert-dialog';
+export * from './alert-dialog';
+export { default as confirmationDialog } from './confirmation-dialog';
+export * from './confirmation-dialog';
+export { default as lifecycleObserver } from './lifecycle-observer';
+export * from './lifecycle-observer';

package/generated/buses/lifecycle-observer.d.ts

@@ -0,0 +1,2 @@
+declare const _default: EventTarget;
+export default _default;

package/generated/buses/lifecycle-observer.js

@@ -0,0 +1 @@
+export default new EventTarget();

package/generated/client/index.d.ts

@@ -1,2 +1,30 @@
-import { Snapshot } from "../internal/snapshot";
-export { Snapshot };
+import { lifecycleObserver } from '../buses';
+import { I18n } from '../i18n';
+import { NavigationPath } from '../internal/class/navigation-path';
+import { type NavigationHost, queryInsertPosition, startViewTransition } from '../internal/privateNamespace';
+import { type WebComponentCtor } from '../namespace-browser';
+import { Snapshot } from '../snapshot';
+export declare const polyfills: Map<string, WebComponentCtor>;
+/**
+ * Presents an alert with a message using the given data to produce the alert’s content and a string variable as a title.
+ */
+export declare const alert: (title?: string, message?: string, actions?: {
+    label?: string;
+    image?: string;
+    role?: string;
+}[], options?: {
+    titleVisibility?: boolean;
+    signal?: AbortSignal;
+}) => Promise<string | undefined> & {
+    dismiss: (reason?: unknown) => void;
+};
+export declare const confirmationDialog: (trigger: HTMLElement, title: string, message?: string, actions?: {
+    label?: string;
+    image?: string;
+    role?: string;
+}[], options?: {
+    controller?: AbortController;
+    titleVisibility?: boolean;
+}) => Promise<string>;
+export { I18n, lifecycleObserver, NavigationPath, queryInsertPosition, Snapshot, startViewTransition };
+export { type NavigationHost };

package/generated/client/index.js

@@ -1,8 +1,279 @@
-import { kebabCase } from "../internal/utils";
-console.log(kebabCase(`Hello client!`));
-import { Snapshot } from "../internal/snapshot";
-console.log(77, Snapshot);
-console.log(88, Snapshot.count);
-Snapshot.getSnapshot();
-console.log(99, Snapshot);
-export { Snapshot };
+import { alertDialog, confirmationDialog as confirmationDialogBus, lifecycleObserver } from '../buses';
+import * as Components from '../components';
+import { I18n } from '../i18n';
+import { NavigationPath } from '../internal/class/navigation-path';
+import { queryInsertPosition, startViewTransition } from '../internal/privateNamespace';
+import { $, devFlags, kebabCase, onoff } from '../internal/utils';
+import { Snapshot } from '../snapshot';
+import { html, render } from '../tpl';
+//#region polyfills
+export const polyfills = new Map();
+for (const [k, Ctor] of Object.entries(Components)) {
+    const is = kebabCase(k);
+    if ('polyfillExtends' in Ctor && 'string' === typeof Ctor.polyfillExtends) {
+        if (customElements.get(is))
+            continue;
+        customElements.define(is, Ctor, { extends: Ctor.polyfillExtends });
+        if (!(document.createElement(Ctor.polyfillExtends, { is }) instanceof Ctor))
+            polyfills.set(is, Ctor);
+        // const testEl = document.createElement('template')
+        // testEl.innerHTML = `<${Ctor.polyfillExtends} is="${is}"></${Ctor.polyfillExtends}>`
+        // const testNode = testEl.content.firstElementChild,
+        if (!($(html `<${Ctor.polyfillExtends} is="${is}"></${Ctor.polyfillExtends}>`, '>1') instanceof Ctor))
+            polyfills.set(is, Ctor);
+        continue;
+    }
+    if (!customElements.get(is))
+        customElements.define(is, Ctor);
+}
+if (devFlags.debug)
+    console.debug(polyfills);
+if (0 < polyfills.size) {
+    const polyfillTagNamesCache = new Set([...polyfills.values()].map((v) => String(v.polyfillExtends ?? '').toUpperCase()).filter(Boolean)); // ['TAG-NAME1', 'TAG-NAME2', ...]
+    const handlers = new WeakMap();
+    const observe = (el, polyfill) => {
+        if (!Array.isArray(polyfill.observedAttributes))
+            return;
+        if (0 === polyfill?.observedAttributes.length)
+            return;
+        if (!polyfill.polyfillAttributeChangedCallback)
+            return;
+        const observer = new MutationObserver(polyfill.polyfillAttributeChangedCallback);
+        observer.observe(el, {
+            attributes: true,
+            attributeFilter: polyfill.observedAttributes,
+            attributeOldValue: true,
+        });
+        handlers.set(el, observer);
+        for (const attributeName of polyfill.observedAttributes)
+            if (el.hasAttribute(attributeName)) {
+                const entry = {
+                    attributeName,
+                    oldValue: null,
+                    target: el,
+                };
+                polyfill.polyfillAttributeChangedCallback([entry]);
+            }
+    }, unobserve = (el) => {
+        handlers.delete(el);
+    }, polyfillTagNamesCacheSelector = [...polyfillTagNamesCache.values()].map((v) => `${v}`.toLowerCase()).join(','), flatten = (node) => [node, ...(node.querySelectorAll?.(polyfillTagNamesCacheSelector) ?? [])];
+    if (devFlags.debug)
+        console.debug(polyfillTagNamesCache, polyfillTagNamesCacheSelector);
+    for (const [is, polyfill] of polyfills)
+        for (const el of document.querySelectorAll(`${polyfill.polyfillExtends}[is="${CSS.escape(is)}"]`)) {
+            polyfill.polyfillConnectedCallback(el);
+            observe(el, polyfill);
+        }
+    // observer callback
+    const observer = new MutationObserver((mutations) => {
+        for (const { addedNodes, removedNodes } of mutations) {
+            for (const root of addedNodes) {
+                if (!(root instanceof HTMLElement))
+                    continue;
+                for (const node of flatten(root)) {
+                    if (!(node instanceof HTMLElement))
+                        continue;
+                    if (!polyfillTagNamesCache.has(node.tagName))
+                        continue;
+                    const is = node?.getAttribute('is') ?? '';
+                    if (!polyfills.has(is))
+                        continue;
+                    polyfills.get(is)?.polyfillConnectedCallback(node);
+                    observe(node, polyfills.get(is));
+                }
+            }
+            for (const root of removedNodes) {
+                if (!(root instanceof HTMLElement))
+                    continue;
+                for (const node of flatten(root)) {
+                    if (!(node instanceof HTMLElement))
+                        continue;
+                    if (!polyfillTagNamesCache.has(node.tagName))
+                        continue;
+                    const is = node?.getAttribute('is') ?? '';
+                    if (!polyfills.has(is))
+                        continue;
+                    polyfills.get(is)?.polyfillDisconnectedCallback(node);
+                    unobserve(node);
+                }
+            }
+        }
+    });
+    observer.observe(document.body, {
+        childList: true,
+        subtree: true,
+    });
+}
+// SECTION: Safari polyfill
+document.addEventListener('touchstart', () => { }, { passive: true });
+//#endregion
+// SECTION
+const handleHelp = ({ target, relatedTarget }) => {
+    if (!(target instanceof HTMLElement))
+        return;
+    const trigger = target.closest('[help]');
+    if (!trigger)
+        return;
+    if (['PICKER-VIEW'].includes(trigger.tagName))
+        return;
+    if (relatedTarget instanceof HTMLElement && trigger.contains(relatedTarget))
+        return;
+    const newAnchorName = `--help-${self.crypto.randomUUID()}`;
+    const tooltip = $(html `<fine-tooltip></fine-tooltip>`, '>1');
+    trigger.style.setProperty('anchor-name', newAnchorName);
+    tooltip.style.setProperty('position-anchor', newAnchorName);
+    document.body.appendChild(tooltip);
+    // setInterval(() => {
+    //   trigger.setAttribute('help', trigger.getAttribute('help') + 'h')
+    // }, 2000)
+    // console.log(999, trigger)
+}, handleDone = ({ target, relatedTarget }) => {
+    if (!(target instanceof HTMLElement))
+        return;
+    const trigger = target.closest('[help]');
+    if (!trigger)
+        return;
+    if (['PICKER-VIEW'].includes(trigger.tagName))
+        return;
+    if (relatedTarget instanceof HTMLElement && trigger.contains(relatedTarget))
+        return;
+    const anchorName = trigger.style.anchorName;
+    if (!anchorName.startsWith('--help-'))
+        return;
+    // for (const el of document.querySelectorAll<HTMLElement>(`[style*="--help-${CSS.escape(anchorName)}"][help]`)) el.style.removeProperty('anchor-name') //trigger.style.removeProperty('anchor-name')
+    // for (const el of document.querySelectorAll(`[style*="${CSS.escape(anchorName)}"]:not([help])`)) el.remove()
+    //   return
+    // }
+    const tooltip = document.querySelector(`[style*="${CSS.escape(anchorName)}"]:not([help])`);
+    if (!tooltip)
+        return;
+    // for (const el of document.querySelectorAll<HTMLElement>(`[style*="--help-${CSS.escape(anchorName)}"][help]`)) el.style.removeProperty('anchor-name') //trigger.style.removeProperty('anchor-name')
+    // for (const el of document.querySelectorAll(`[style*="${CSS.escape(anchorName)}"]:not([help])`)) el.remove()
+    //   return
+    // }
+    // trigger.style.removeProperty('anchor-name')
+    tooltip.hidePopover(); // tooltip.remove?.()
+};
+const mediaQueryList = self.matchMedia(`(pointer: fine)`);
+mediaQueryList.addEventListener('change', ({ matches }) => {
+    for (const [k, v] of [
+        ['pointerover', handleHelp],
+        ['pointerout', handleDone],
+    ])
+        document.removeEventListener(k, v);
+    if (matches)
+        for (const [k, v] of [
+            ['pointerover', handleHelp],
+            ['pointerout', handleDone],
+        ])
+            document.addEventListener(k, v, { passive: true });
+});
+if (mediaQueryList.matches)
+    for (const [k, v] of [
+        ['pointerover', handleHelp],
+        ['pointerout', handleDone],
+    ])
+        document.addEventListener(k, v, { passive: true });
+//#region fns
+// const a = alert('Saving…', 'Please wait')
+// // later, e.g. save completed early
+// a.dismiss()          // silently resolves undefined, closes+removes dialog
+// // or
+// a.dismiss(new Error('cancelled')) // rejects instead
+// const result = await a // still works normally if not dismissed
+// const ac = new AbortController()
+// const a = alert('Uploading…', 'Please wait', undefined, { signal: ac.signal })
+// // elsewhere, e.g. upload finished before the user dismissed
+// ac.abort() // dialog closes silently, a rejects with AbortError
+// // or still works standalone
+// a.dismiss() // same effect, no signal needed
+/**
+ * Presents an alert with a message using the given data to produce the alert’s content and a string variable as a title.
+ */
+export const alert = (title, message, actions, options) => {
+    const { promise, resolve, reject } = Promise.withResolvers();
+    let dialog;
+    let off;
+    const dismiss = (reason) => {
+        off?.();
+        dialog?.close();
+        // dialog?.remove()
+        reason === undefined ? resolve(undefined) : reject(reason instanceof Error ? reason : new DOMException('Alert dismissed', 'AbortError'));
+    };
+    if (options?.signal)
+        if (options.signal.aborted)
+            dismiss(options.signal.reason); // already aborted before we even started — settle immediately, skip showing anything
+        else
+            options.signal.addEventListener('abort', () => dismiss(options.signal.reason), { once: true });
+    navigator.locks
+        .request('alert:', async () => {
+        if (options?.signal?.aborted)
+            return; // in case it was aborted while queued behind another lock holder
+        const mount = document.createElement('div');
+        render(html `<dialog is="alert-dialog">
+          <v-stack spacing="1" alignment="fill">
+            ${title ? html `<label-view font="headline" title="${title}"></label-view>` : null}
+            ${message ? html `<label-view foreground="secondary" font="callout" title="${message}"></label-view>` : null}
+          </v-stack>
+          ${(actions ?? [{ role: 'close' }]).map((action, index) => html `
+              <button type="button" tabindex="0" is="bordered-button" value="${index}" role="${action.role ?? null}">
+                ${action.label || action.image ? html `<label-view title="${action.label ?? null}" system-image="${action.image ?? null}"></label-view>` : null}
+              </button>
+            `)}
+        </dialog>`, mount);
+        dialog = mount.firstElementChild;
+        document.body.insertAdjacentElement('beforeend', dialog);
+        dialog.showModal();
+        off = onoff('alert:return', (evt) => {
+            const { detail } = evt;
+            off?.();
+            resolve(detail.returnValue);
+        }, alertDialog, { once: true }).on();
+        return promise;
+    })
+        .catch(() => { });
+    return Object.assign(promise, { dismiss });
+};
+export const confirmationDialog = async (trigger, title, message, actions, options) => {
+    const newAnchorName = `--confirmation-dialog-${self.crypto.randomUUID()}`;
+    const dialog = $(html `<dialog is="confirmation-dialog"></dialog>`, '>1'), vStack = dialog.querySelector(':scope>v-stack') ?? dialog.appendChild($(html `<v-stack spacing="1" alignment="fill"></v-stack>`, '>1'));
+    trigger.style.setProperty('anchor-name', newAnchorName, 'important'); //$.prop('anchor-name', newAnchorName, trigger, 'important')
+    dialog.style.setProperty('position-anchor', newAnchorName); //$.prop('position-anchor', newAnchorName, dialog)
+    if (title && false !== options?.titleVisibility) {
+        const label = $(html `<label-view font="headline"></label-view>`, '>1');
+        label.setAttribute('title', title);
+        vStack.insertAdjacentElement('beforeend', label);
+    }
+    if (message && false !== options?.titleVisibility) {
+        const label = $(html `<label-view foreground="secondary" font="callout"></label-view>`, '>1');
+        label.setAttribute('title', message);
+        vStack.insertAdjacentElement('beforeend', label);
+    }
+    for (const [index, action] of (actions ?? []).entries()) {
+        const btn = $(html `<button type="button" tabindex="0" is="bordered-button"></button>`, '>1');
+        btn.setAttribute('value', `${index}`);
+        if (action?.role)
+            btn.setAttribute('role', action.role);
+        if (action.label || action.image) {
+            const label = $(html `<label-view></label-view>`, '>1');
+            if (action.label)
+                label.setAttribute('title', action.label);
+            if (action.image)
+                label.setAttribute('system-image', action.image);
+            btn.appendChild(label);
+        }
+        dialog.insertAdjacentElement('beforeend', btn);
+    }
+    trigger.closest('body-view,dialog')?.insertAdjacentElement('beforeend', dialog); // dialog.showModal()
+    const { promise, resolve } = Promise.withResolvers(), off = onoff('confirmation:return', (evt) => {
+        const { detail } = evt;
+        off();
+        resolve(detail.returnValue);
+    }, confirmationDialogBus, { once: true }).on();
+    return promise;
+};
+//#endregion
+void Snapshot.waitReady;
+//#region exports
+export { I18n, lifecycleObserver, NavigationPath, queryInsertPosition, Snapshot, startViewTransition };
+//#endregion

package/generated/components/alert-dialog.d.ts

@@ -0,0 +1,11 @@
+import { DialogBase } from '../namespace-browser/base';
+/**
+ * @summary A dialog that shows a message. Use it from the client module like `void alert('Save failed.')`.
+ */
+export declare class AlertDialog extends DialogBase {
+    #private;
+    constructor();
+    static polyfillDisconnectedCallback(el: AlertDialog): void;
+    static polyfillConnectedCallback(el: AlertDialog): void;
+    static polyfillAttributeChangedCallback([{ attributeName, target, oldValue }]: Pick<MutationRecord, 'attributeName' | 'oldValue' | 'target'>[]): void;
+}

package/generated/components/alert-dialog.js

@@ -0,0 +1,102 @@
+import { alertDialog } from '../buses';
+import { CleanupRegistry } from '../internal/class/cleanup-registry';
+import { devFlags, onoff, touchGlass } from '../internal/utils';
+import { DialogBase } from '../namespace-browser/base';
+/**
+ * @summary A dialog that shows a message. Use it from the client module like `void alert('Save failed.')`.
+ */
+export class AlertDialog extends DialogBase {
+    constructor() {
+        super();
+    }
+    static polyfillDisconnectedCallback(el) {
+        if (devFlags.debug)
+            console.debug(`${AlertDialog.name} ⚡️ disconnect`);
+        CleanupRegistry.unregister(el);
+        alertDialog.dispatchEvent(new CustomEvent('alert:return', {
+            detail: { returnValue: el.returnValue },
+            bubbles: true,
+            composed: true,
+        }));
+    }
+    static polyfillConnectedCallback(el) {
+        if (devFlags.debug)
+            console.debug(`${AlertDialog.name} ⚡️ connect`);
+        CleanupRegistry.register(el, onoff([
+            { types: 'click', listener: this.#handleDialogClick },
+            { types: 'close', listener: this.#handleDialogClose },
+            { types: 'cancel', listener: this.#handleDialogCancel },
+        ], el).on());
+        CleanupRegistry.register(el, onoff(touchGlass(el, (t) => t, ({ target }) => {
+            if (!(target instanceof HTMLElement))
+                return true;
+            if (target.matches('[is=alert-dialog]'))
+                return false;
+            return true;
+        }), el).on());
+        if (devFlags.debug)
+            console.debug(`${AlertDialog.name} ⚡️ will-open`);
+        el.removeAttribute('closing');
+        el.scrollTop = 0;
+        el.returnValue = '';
+        el.autofocus = true;
+        el.showModal();
+    }
+    static polyfillAttributeChangedCallback([{ attributeName, target, oldValue }]) {
+        if (devFlags.debug)
+            console.debug(`${AlertDialog.name} ⚡️ attr-change [${attributeName}] ("${oldValue}" → "${target.getAttribute(attributeName ?? '')}")`);
+        switch (attributeName) {
+            case 'label':
+                //
+                break;
+        }
+    }
+    static #handleDialogClick = (evt) => {
+        if (devFlags.debug)
+            console.debug(`${AlertDialog.name} ⚡️ ${evt?.type}`);
+        const { target, currentTarget: dialog } = evt;
+        if (!(dialog instanceof HTMLDialogElement))
+            return;
+        if (!(target instanceof HTMLElement))
+            return;
+        const button = target.closest('button');
+        if (!button)
+            return;
+        button.scrollIntoView({
+            behavior: self.matchMedia('(prefers-reduced-motion: no-preference)').matches ? 'smooth' : 'instant',
+            block: 'nearest',
+            inline: 'nearest',
+        });
+        dialog.returnValue = button.value;
+        dialog.requestClose(button.value);
+        evt.stopPropagation();
+        evt.stopImmediatePropagation();
+    };
+    static #handleDialogCancel = (evt) => {
+        if (devFlags.debug)
+            console.debug(`${AlertDialog.name} ⚡️ ${evt?.type}`);
+        if (!evt.cancelable)
+            return;
+        const { target } = evt;
+        if (!(target instanceof HTMLDialogElement))
+            return;
+        evt.preventDefault();
+        target.inert = true;
+        if (devFlags.debug)
+            console.debug(`${AlertDialog.name} ⚡️ will-close`);
+        target.setAttribute('closing', '');
+        Promise.allSettled(target.getAnimations().map(({ finished }) => finished)).then(() => {
+            if (!target.hasAttribute('closing'))
+                return;
+            target?.close(target?.returnValue);
+            target.removeAttribute('closing');
+        });
+    };
+    static #handleDialogClose = ({ type, target }) => {
+        if (devFlags.debug)
+            console.debug(`${AlertDialog.name} ⚡️ ${type}`);
+        if (!(target instanceof HTMLDialogElement))
+            return;
+        target.remove();
+    };
+}

package/generated/components/body-view.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @summary A container view that wraps a scroll view, marking it as a screen your app can navigate to.
+ */
+export declare class BodyView extends HTMLElement {
+    constructor();
+    disconnectedCallback(): void;
+    connectedCallback(): void;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'body-view': BodyView;
+    }
+}

package/generated/components/body-view.js

@@ -0,0 +1,17 @@
+import { devFlags } from '../internal/utils';
+/**
+ * @summary A container view that wraps a scroll view, marking it as a screen your app can navigate to.
+ */
+export class BodyView extends HTMLElement {
+    constructor() {
+        super();
+    }
+    disconnectedCallback() {
+        if (devFlags.debug)
+            console.debug(`${BodyView.name} ⚡️ disconnect`);
+    }
+    connectedCallback() {
+        if (devFlags.debug)
+            console.debug(`${BodyView.name} ⚡️ connect`);
+    }
+}

package/generated/components/bordered-button.d.ts

@@ -0,0 +1,17 @@
+import { ButtonBase } from '../namespace-browser/base';
+/**
+ * @summary A control that starts an action. Styled with a standard border, adapting to the button’s surroundings.
+ *
+ * @example <button is="bordered-button"><label-view system-image="hand-tap" title="Tap Me"></label-view></button> — Creating a bordered button
+ *
+ * @slot overlay
+ *
+ */
+export declare class BorderedButton extends ButtonBase {
+    #private;
+    static get observedAttributes(): string[];
+    constructor();
+    static polyfillDisconnectedCallback(el: BorderedButton): void;
+    static polyfillConnectedCallback(el: BorderedButton): void;
+    static polyfillAttributeChangedCallback([{ attributeName, target, oldValue }]: Pick<MutationRecord, 'attributeName' | 'oldValue' | 'target'>[]): void;
+}

package/generated/components/bordered-button.js

@@ -0,0 +1,56 @@
+import { CleanupRegistry } from '../internal/class/cleanup-registry';
+import { devFlags, ensurePlaceholder, onoff } from '../internal/utils';
+import { ButtonBase } from '../namespace-browser/base';
+import { Snapshot } from '../snapshot';
+/**
+ * @summary A control that starts an action. Styled with a standard border, adapting to the button’s surroundings.
+ *
+ * @example <button is="bordered-button"><label-view system-image="hand-tap" title="Tap Me"></label-view></button> — Creating a bordered button
+ *
+ * @slot overlay
+ *
+ */
+export class BorderedButton extends ButtonBase {
+    static get observedAttributes() {
+        return [
+            /**
+             * A value that describes the purpose of a button
+             * @type {destructive|confirm}
+             */
+            'role',
+            'title-key',
+        ];
+    }
+    constructor() {
+        super();
+    }
+    static polyfillDisconnectedCallback(el) {
+        if (devFlags.debug)
+            console.debug(`${BorderedButton.name} ⚡️ disconnect`);
+        CleanupRegistry.unregister(el);
+    }
+    static polyfillConnectedCallback(el) {
+        if (devFlags.debug)
+            console.debug(`${BorderedButton.name} ⚡️ connect`);
+        el.tabIndex = 0;
+        CleanupRegistry.register(el, onoff('click', BorderedButton.#handleClick, el).on());
+    }
+    static polyfillAttributeChangedCallback([{ attributeName, target, oldValue }]) {
+        if (devFlags.debug)
+            console.debug(`${BorderedButton.name} ⚡️ attr-change [${attributeName}] ("${oldValue}" → "${target.getAttribute(attributeName ?? '')}")`);
+        const node = target instanceof HTMLButtonElement;
+        if (!node)
+            return;
+        switch (attributeName) {
+            case 'title-key':
+            case 'role':
+                Snapshot.waitReady.then(() => {
+                    ensurePlaceholder(target, target.getAttribute('role'), target.getAttribute('title-key'), Snapshot.config);
+                });
+                break;
+        }
+    }
+    static #handleClick = async (evt) => {
+        //
+    };
+}

package/generated/components/bordered-prominent-button.d.ts

@@ -0,0 +1,17 @@
+import { ButtonBase } from '../namespace-browser/base';
+/**
+ * @summary A control that starts an action. Styled with a prominent border, adapting to the button’s surroundings.
+ *
+ * @example <button is="bordered-prominent-button"><label-view system-image="hand-tap" title="Tap Me"></label-view></button> — Creating a prominent bordered button
+ *
+ * @slot overlay
+ *
+ */
+export declare class BorderedProminentButton extends ButtonBase {
+    #private;
+    static get observedAttributes(): string[];
+    constructor();
+    static polyfillDisconnectedCallback(el: BorderedProminentButton): void;
+    static polyfillConnectedCallback(el: BorderedProminentButton): void;
+    static polyfillAttributeChangedCallback([{ attributeName, target, oldValue }]: Pick<MutationRecord, 'attributeName' | 'oldValue' | 'target'>[]): void;
+}