@swiftwc/ui 0.0.0-dev.66 → 0.0.0-dev.68

package/generated/client/index.d.ts

@@ -11,7 +11,10 @@ export declare const alert: (title?: string, message?: string, actions?: {
     role?: string;
 }[], options?: {
     titleVisibility?: boolean;
-}) => Promise<string>;
+    signal?: AbortSignal;
+}) => Promise<string | undefined> & {
+    dismiss: (reason?: unknown) => void;
+};
 export declare const confirmationDialog: (trigger: HTMLElement, title: string, message?: string, actions?: {
     label?: string;
     image?: string;

package/generated/client/index.js

@@ -5,6 +5,7 @@ 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)) {
@@ -174,47 +175,61 @@ if (mediaQueryList.matches)
     ])
         document.addEventListener(k, v, { passive: true });
 //#region fns
-export const alert = async (title, message, actions, options) => {
-    return await navigator.locks.request('alert:', async () => {
-        const dialog = $(`<dialog is="alert-dialog"></dialog>`, '>1'), vStack = dialog.querySelector(':scope>v-stack') ?? dialog.appendChild($(`<v-stack spacing="1" alignment="fill"></v-stack>`, '>1'));
-        if (title) {
-            const label = $(`<label-view font="headline"></label-view>`, '>1');
-            label.setAttribute('title', title);
-            vStack.insertAdjacentElement('beforeend', label);
-        }
-        if (message) {
-            const label = $(`<label-view foreground="secondary" font="callout"></label-view>`, '>1');
-            label.setAttribute('title', message);
-            vStack.insertAdjacentElement('beforeend', label);
-        }
-        for (const [index, action] of (actions ?? [
-            {
-                role: 'close',
-            },
-        ]).entries()) {
-            const btn = $(`<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 = $(`<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);
-        }
+// 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
+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();
-        const { promise, resolve } = Promise.withResolvers(), off = onoff('alert:return', (evt) => {
+        off = onoff('alert:return', (evt) => {
             const { detail } = evt;
-            off();
+            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()}`;

package/generated/components/h-stack.d.ts

@@ -2,6 +2,10 @@
  *
  * @attr {@spacingSet} spacing - The gap between the primary axis
  *
+ * @attr {@alignmentSet} alignment - The cross-axis alignment
+ * @attr {@distributionSet} distribution - The main-axis alignment
+ * @attr {@placementSet} placement - The main-axis alignment
+ *
  */
 export declare class HStack extends HTMLElement {
     constructor();

package/generated/components/h-stack.js

@@ -3,6 +3,10 @@ import { devFlags } from '../internal/utils';
  *
  * @attr {@spacingSet} spacing - The gap between the primary axis
  *
+ * @attr {@alignmentSet} alignment - The cross-axis alignment
+ * @attr {@distributionSet} distribution - The main-axis alignment
+ * @attr {@placementSet} placement - The main-axis alignment
+ *
  */
 export class HStack extends HTMLElement {
     constructor() {

package/generated/components/index.d.ts

@@ -39,6 +39,7 @@ export * from './tab-item';
 export * from './tab-view';
 export * from './table-view';
 export * from './text-field';
+export * from './toggle-view';
 export * from './tool-bar-item-group';
 export * from './tool-bar-item';
 export * from './tool-bar';

package/generated/components/index.js

@@ -39,6 +39,7 @@ export * from './tab-item';
 export * from './tab-view';
 export * from './table-view';
 export * from './text-field';
+export * from './toggle-view';
 export * from './tool-bar-item-group';
 export * from './tool-bar-item';
 export * from './tool-bar';

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

@@ -1,3 +1,8 @@
+/**
+ *
+ * @attr {@fontSet} font - Sets the default font for text in this view.
+ *
+ */
 export declare class LabelView extends HTMLElement {
     #private;
     static get observedAttributes(): string[];

package/generated/components/label-view.js

@@ -1,4 +1,9 @@
 import { $, devFlags, renderLabelIcon, renderLabelTitle } from '../internal/utils';
+/**
+ *
+ * @attr {@fontSet} font - Sets the default font for text in this view.
+ *
+ */
 export class LabelView extends HTMLElement {
     static get observedAttributes() {
         return ['system-image', 'title', 'line-limit', 'truncation-mode'];

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

@@ -0,0 +1,28 @@
+import { FormAssociatedBase } from '../internal/class/form-associated-base';
+declare const toggleStyles: readonly ["switch", "button"];
+export type ToggleStyle = (typeof toggleStyles)[number];
+/**
+ * @slot label
+ * @slot validity-options
+ */
+export declare class ToggleView extends FormAssociatedBase {
+    #private;
+    static get observedAttributes(): string[];
+    static get template(): DocumentFragment;
+    constructor();
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    disconnectedCallback(): void;
+    connectedCallback(): void;
+    get toggleStyle(): ToggleStyle;
+    get isOn(): boolean;
+    set isOn(v: boolean);
+    get name(): string;
+    get value(): string | null;
+    set value(v: string | null);
+    setValidity: (flags?: ValidityStateFlags, message?: string, anchor?: HTMLElement) => void;
+    setCustomValidity: (message: string) => void;
+    formAssociatedCallback: (form: HTMLFormElement) => void;
+    formDisabledCallback: (disabled: boolean) => void;
+    formResetCallback: () => void;
+}
+export {};

package/generated/components/toggle-view.js

@@ -0,0 +1,222 @@
+var _a;
+import { CleanupRegistry } from '../internal/class/cleanup-registry';
+import { FormAssociatedBase, getInternals } from '../internal/class/form-associated-base';
+import { MutationObserverSet } from '../internal/class/mutation-observer-set';
+import { $, devFlags, kebabCase, onoff, renderLabel } from '../internal/utils';
+const toggleStyles = ['switch', 'button'];
+/**
+ * @slot label
+ * @slot validity-options
+ */
+export class ToggleView extends FormAssociatedBase {
+    static get observedAttributes() {
+        return ['label', 'name', 'value', 'is-on', 'keyboard-type', 'required', 'disabled'];
+    }
+    static #template;
+    static get template() {
+        return (this.#template ??= $(String.raw `
+    <label part="root toggle-stack">
+    <div part="root toggle-label-stack">
+      <slot name="label"></slot>
+    </div>
+    <div part="root toggle-input-stack">
+      <!--<input type="checkbox" part="root input toggle-form-input">-->
+      <div part="root toggle-form-input" tabindex="0"></div>
+    </div>
+    <slot name="validity-options" hidden></slot>
+  </label>`));
+    }
+    #renderValidityMsgs = (entries) => {
+        if (devFlags.debug)
+            console.debug(`${_a.name} ⚡️ mutation`);
+        this.setValidity(this.validity, this.validationMessage);
+    };
+    #shadowRoot;
+    #customValidity = '';
+    #slots = new Map();
+    #validityObservers = new MutationObserverSet(this.#renderValidityMsgs);
+    #input;
+    #value = 'on';
+    #isOn = false;
+    #connected = false;
+    get #internals() {
+        return getInternals(this);
+    }
+    constructor() {
+        super();
+        this.#shadowRoot = this.attachShadow({ mode: 'closed' });
+        this.#shadowRoot.appendChild(document.importNode(this.constructor.template, true));
+        for (const slot of this.#shadowRoot.querySelectorAll('slot'))
+            this.#slots?.set(slot.name, slot);
+        CleanupRegistry.register(this, () => {
+            this.#slots = new Map();
+        });
+        CleanupRegistry.unregister(this, 'validities');
+        CleanupRegistry.register(this, onoff('slotchange', this.#handleValiditiesSlotchange, this.#slots?.get('validity-options')).on(), 'validities');
+        this.#input = this.#shadowRoot.querySelector('[part*=toggle-form-input]') ?? undefined;
+        this.#input?.addEventListener('click', () => {
+            this.isOn = !this.isOn;
+            this.#sendValueToForm(this.#connected);
+        });
+        CleanupRegistry.register(this, onoff([{ types: 'focusin', listener: this.#handleFocusin }], this).on());
+        CleanupRegistry.register(this, onoff([{ types: 'keydown', listener: this.#handleInputKeydown }], this.#input).on());
+        // CleanupRegistry.register(this, onoff([{ types: 'input', listener: this.#handleInputInput }], this.#input).on())
+    }
+    attributeChangedCallback(name, oldValue, newValue) {
+        if (devFlags.debug)
+            console.debug(`${_a.name} ⚡️ attr-change [${name}] ("${oldValue}" → "${newValue}")`);
+        switch (name) {
+            case 'value':
+                this.value = String(newValue); // this.#input?.setAttribute('checked', newValue ?? '')
+                this.#sendValueToForm(this.#connected);
+                break;
+            case 'is-on':
+                this.isOn = newValue !== null; // this.#input?.setAttribute('checked', newValue ?? '')
+                this.#sendValueToForm(this.#connected);
+                break;
+            case 'required':
+                // this.#input?.setAttribute(name, newValue ?? '')
+                this.#sendValueToForm(this.#connected);
+                break;
+            case 'name':
+                this.#sendValueToForm(this.#connected);
+                break;
+            case 'label':
+                renderLabel(':scope>label-view[slot=label]', `<label-view slot="label" foreground="secondary"><span></span></label-view>`, this, newValue);
+                break;
+            case 'disabled':
+                for (const el of this.#shadowRoot.querySelectorAll('input'))
+                    el.toggleAttribute('disabled', !newValue);
+                break;
+        }
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        this.#validityObservers.unobserveAll();
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        // finally
+        // if (this.hasAttribute('value')) this.value = this.getAttribute('value') ?? ''
+        if (this.hasAttribute('is-on'))
+            this.isOn = this.hasAttribute('is-on');
+        this.#sendValueToForm(false);
+        this.#connected = true;
+    }
+    get toggleStyle() {
+        return toggleStyles.includes(this.getAttribute('toggle-style') ?? '') ? this.getAttribute('toggle-style') : 'switch';
+    }
+    get isOn() {
+        return this.#isOn;
+    }
+    set isOn(v) {
+        this.#isOn = Boolean(v);
+        this.#value = this.#isOn ? (this.getAttribute('value') ?? 'on') : null;
+        this.ariaChecked = `${this.#isOn}`;
+    }
+    #handleValiditiesSlotchange = ({ type, target: slot }) => {
+        if (devFlags.debug)
+            console.debug(`${_a.name} ⚡️ ${type}`);
+        if (!(slot instanceof HTMLSlotElement))
+            return;
+        const assigned = slot.assignedElements();
+        this.#validityObservers.syncObservations(assigned, ['value', 'label']);
+        this.#renderValidityMsgs([]);
+    };
+    #handleFocusin = ({ type, target }) => {
+        if (devFlags.debug)
+            console.debug(`${_a.name} ⚡️ ${type}`);
+        if (target === this)
+            this.#input?.focus();
+    };
+    #sendValueToForm = (dispatchEvent = true) => {
+        // input.value has already been updated/synced !!
+        if (this.matches(':disabled'))
+            return this.setValidity({});
+        if (this.hasAttribute('required') && !this.isOn) {
+            this.setValidity({ valueMissing: true });
+        }
+        else {
+            this.setValidity({});
+        }
+        const entries = new FormData();
+        if (this.value)
+            entries.append(this.name, this.value);
+        this.#internals.setFormValue(entries);
+        if (dispatchEvent)
+            this.dispatchEvent(new CustomEvent('commit', { detail: { value: this.value, isOn: this.isOn }, bubbles: true, composed: true }));
+    };
+    #handleInputKeydown = (evt) => {
+        if (devFlags.debug)
+            console.debug(`${_a.name} ⚡️ ${evt?.type}`);
+        this.isOn = !this.isOn;
+        this.#sendValueToForm();
+    };
+    #handleInputInput = (evt) => {
+        if (devFlags.debug)
+            console.debug(`${_a.name} ⚡️ ${evt?.type}`);
+        this.#sendValueToForm();
+    };
+    // Optional: form participation properties
+    get name() {
+        return this.getAttribute('name') ?? this.getAttribute('label') ?? this.querySelector(':scope>[slot=label]')?.textContent ?? '';
+    }
+    get value() {
+        return this.#value;
+    }
+    set value(v) {
+        this.#value = this.isOn ? String(v) : null;
+    }
+    setValidity = (flags, message, anchor) => {
+        // let msg
+        // if (message)
+        for (const k in flags) {
+            const key = k; // ✅ type-safe cast
+            if (true !== flags[key])
+                continue;
+            for (const el of this.#slots?.get('validity-options')?.assignedElements({ flatten: true }) ?? []) {
+                if (!el.matches('option'))
+                    continue;
+                const { label, value } = el;
+                if (`${kebabCase(key)}` === value) {
+                    message = label;
+                    break;
+                }
+                else if (`${kebabCase(key)}:${message}` === value) {
+                    message = label;
+                    break;
+                }
+            }
+        }
+        if (!message)
+            for (const k in flags) {
+                const key = k; // ✅ type-safe cast
+                if (true !== flags[key])
+                    continue;
+                message = kebabCase(key);
+                break;
+            }
+        if (devFlags.debug)
+            console.debug(`${_a.name} ⚡️ validity-change`);
+        return this.#internals.setValidity(flags, this.#customValidity || message, anchor ?? this.#input);
+    };
+    setCustomValidity = (message) => {
+        this.#customValidity = message;
+        if (this.#customValidity)
+            this.#internals.setValidity({ ...this.#internals.validity, customError: true }, message);
+        else
+            this.#sendValueToForm(false);
+    };
+    formAssociatedCallback = (form) => {
+        this.#sendValueToForm();
+    };
+    formDisabledCallback = (disabled) => {
+        for (const el of this.#shadowRoot.querySelectorAll('input'))
+            el.toggleAttribute('disabled', !disabled);
+    };
+    formResetCallback = () => {
+        this.value = '';
+        this.#sendValueToForm();
+    };
+}
+_a = ToggleView;

package/generated/components/v-stack.d.ts

@@ -5,6 +5,10 @@
  *
  * @attr {@spacingSet} spacing - The gap between the primary axis
  *
+ * @attr {@alignmentSet} alignment - The cross-axis alignment
+ * @attr {@distributionSet} distribution - The main-axis alignment
+ * @attr {@placementSet} placement - The main-axis alignment
+ *
  */
 export declare class VStack extends HTMLElement {
     constructor();

package/generated/components/v-stack.js

@@ -6,6 +6,10 @@ import { devFlags } from '../internal/utils';
  *
  * @attr {@spacingSet} spacing - The gap between the primary axis
  *
+ * @attr {@alignmentSet} alignment - The cross-axis alignment
+ * @attr {@distributionSet} distribution - The main-axis alignment
+ * @attr {@placementSet} placement - The main-axis alignment
+ *
  */
 export class VStack extends HTMLElement {
     constructor() {