mypgs 1.5.1 → 1.6.0

package/assets/javascript/components/_search.js

@@ -0,0 +1,391 @@
+const API = new WeakMap();
+const OPEN_SEARCHES = new Set();
+let searchId = 0;
+
+const DEFAULT_OPTIONS = {
+    minLength: 2,
+    debounce: 200,
+    limit: 8,
+    submitOnSelect: false,
+    searchOnFocus: true,
+    source: null,
+    onSelect: null,
+};
+
+function nextSearchId() {
+    searchId += 1;
+    return searchId;
+}
+
+function getSearches(root) {
+    const searches = root instanceof Element && pgs(root).contains("search") ? [root] : [];
+    searches.push(...pgs(root).querySelectorAll("search"));
+    return searches;
+}
+
+function directPgsChild(element, token) {
+    return Array.from(element.children).find(child => pgs(child).contains(token));
+}
+
+function normalizeItem(item) {
+    if (typeof item === "string" || typeof item === "number") {
+        const value = String(item).trim();
+        return value ? { label: value, value, disabled: false, data: item } : null;
+    }
+
+    if (!item || typeof item !== "object") return null;
+
+    const label = String(item.label ?? item.value ?? "").trim();
+    if (!label) return null;
+
+    return {
+        label,
+        value: String(item.value ?? label),
+        disabled: Boolean(item.disabled),
+        data: Object.prototype.hasOwnProperty.call(item, "data") ? item.data : item,
+    };
+}
+
+function normalizeOptions(current, options = {}) {
+    const next = { ...current, ...options };
+    next.minLength = Math.max(0, Number.parseInt(next.minLength, 10) || 0);
+    next.debounce = Math.max(0, Number.parseInt(next.debounce, 10) || 0);
+    next.limit = Math.max(1, Number.parseInt(next.limit, 10) || DEFAULT_OPTIONS.limit);
+    next.submitOnSelect = Boolean(next.submitOnSelect);
+    next.searchOnFocus = Boolean(next.searchOnFocus);
+    next.source = typeof next.source === "function" || Array.isArray(next.source) ? next.source : null;
+    next.onSelect = typeof next.onSelect === "function" ? next.onSelect : null;
+    return next;
+}
+
+function closeSearch(search) {
+    const data = API.get(search);
+    if (!data) return;
+
+    pgs(search).state.remove("open");
+    data.input.setAttribute("aria-expanded", "false");
+    data.input.removeAttribute("aria-activedescendant");
+    data.list.setAttribute("aria-hidden", "true");
+    data.setActiveIndex(-1);
+    OPEN_SEARCHES.delete(search);
+}
+
+function openSearch(search) {
+    const data = API.get(search);
+    if (!data || data.items().length === 0) return;
+
+    pgs(search).state.add("open");
+    data.input.setAttribute("aria-expanded", "true");
+    data.list.setAttribute("aria-hidden", "false");
+    OPEN_SEARCHES.add(search);
+}
+
+function PGS_search_init(root = document) {
+    getSearches(root).forEach(search => {
+        if (API.has(search)) return;
+
+        const input = search.querySelector('input[type="search"]');
+        const list = directPgsChild(search, "search-suggestions");
+        if (!input || !list) return;
+
+        const id = nextSearchId();
+        if (!input.id) input.id = `search-input-${id}`;
+        if (!list.id) list.id = `search-suggestions-${id}`;
+
+        input.setAttribute("role", "combobox");
+        input.setAttribute("aria-autocomplete", "list");
+        input.setAttribute("aria-haspopup", "listbox");
+        input.setAttribute("aria-controls", list.id);
+        input.setAttribute("aria-expanded", "false");
+        input.setAttribute("autocomplete", "off");
+        list.setAttribute("role", "listbox");
+        list.setAttribute("aria-labelledby", input.id);
+        list.setAttribute("aria-hidden", "true");
+
+
+        let options = { ...DEFAULT_OPTIONS };
+        let items = [];
+        let activeIndex = -1;
+        let timer = null;
+        let controller = null;
+        let requestNumber = 0;
+
+        function setLoading(loading) {
+            pgs(search).state.toggle("loading", loading);
+            input.setAttribute("aria-busy", String(loading));
+        }
+
+        function setActiveIndex(index) {
+            activeIndex = index;
+            const elements = Array.from(list.querySelectorAll('[pgs~="search-suggestions-item"]'));
+
+            elements.forEach((element, itemIndex) => {
+                const selected = itemIndex === activeIndex;
+                element.setAttribute("aria-selected", String(selected));
+                pgs(element).state.toggle("selected", selected);
+            });
+
+            const active = elements[activeIndex];
+            if (active) {
+                input.setAttribute("aria-activedescendant", active.id);
+                active.scrollIntoView({ block: "nearest" });
+            } else {
+                input.removeAttribute("aria-activedescendant");
+            }
+        }
+
+        function moveActive(step) {
+            if (!items.length) return;
+
+            let next = activeIndex;
+            for (let checked = 0; checked < items.length; checked += 1) {
+                next = (next + step + items.length) % items.length;
+                if (!items[next].disabled) {
+                    setActiveIndex(next);
+                    return;
+                }
+            }
+        }
+
+        function clear() {
+            items = [];
+            activeIndex = -1;
+            list.replaceChildren();
+            closeSearch(search);
+        }
+
+        function cancel() {
+            if (timer !== null) window.clearTimeout(timer);
+            timer = null;
+            if (controller) controller.abort();
+            controller = null;
+            requestNumber += 1;
+            setLoading(false);
+        }
+
+        function render(nextItems) {
+            items = Array.from(nextItems || [])
+                .map(normalizeItem)
+                .filter(Boolean)
+                .slice(0, options.limit);
+
+            const fragment = document.createDocumentFragment();
+            items.forEach((item, index) => {
+                const option = document.createElement("li");
+                pgs(option).add("search-suggestions-item");
+                pgs(option).add("flexRow");
+                option.id = `${list.id}-option-${index}`;
+                option.dataset.index = String(index);
+                option.setAttribute("role", "option");
+                option.setAttribute("aria-selected", "false");
+                option.setAttribute("aria-disabled", String(item.disabled));
+                option.innerHTML = '<i class="fa-solid fa-magnifying-glass"></i>' +  item.label;
+                fragment.append(option);
+
+            });
+
+            activeIndex = -1;
+            list.replaceChildren(fragment);
+            pgs(search).state.remove("error");
+
+            if (items.length) openSearch(search);
+            else closeSearch(search);
+
+            return items;
+        }
+
+        async function resolveSource(query, signal) {
+            if (Array.isArray(options.source)) {
+                const normalizedQuery = query.toLocaleLowerCase();
+                return options.source.filter(item => {
+                    const normalized = normalizeItem(item);
+                    return normalized && normalized.label.toLocaleLowerCase().includes(normalizedQuery);
+                });
+            }
+
+            if (typeof options.source !== "function") return [];
+            return await options.source({
+                query,
+                signal,
+                limit: options.limit,
+                element: search,
+                input,
+            });
+        }
+
+        async function runSearch(query = input.value) {
+            cancel();
+            clear();
+
+            const normalizedQuery = String(query ?? "").trim();
+            if (normalizedQuery.length < options.minLength || !options.source) return [];
+
+            const currentRequest = requestNumber;
+            controller = new AbortController();
+            const currentController = controller;
+            setLoading(true);
+
+            try {
+                const result = await resolveSource(normalizedQuery, currentController.signal);
+                if (currentRequest !== requestNumber || currentController.signal.aborted) return [];
+                return render(result);
+            } catch (error) {
+                if (error?.name === "AbortError") return [];
+                if (currentRequest !== requestNumber) return [];
+
+                clear();
+                pgs(search).state.add("error");
+                search.dispatchEvent(new CustomEvent("pgs:search:error", {
+                    bubbles: true,
+                    detail: { error, query: normalizedQuery },
+                }));
+                return [];
+            } finally {
+                if (controller === currentController) controller = null;
+                if (currentRequest === requestNumber) setLoading(false);
+            }
+        }
+
+        function schedule() {
+            cancel();
+            clear();
+            pgs(search).state.remove("error");
+
+            if (input.value.trim().length < options.minLength || !options.source) return;
+            timer = window.setTimeout(() => {
+                timer = null;
+                runSearch(input.value);
+            }, options.debounce);
+        }
+
+        function select(index = activeIndex, submit = options.submitOnSelect) {
+            const item = items[index];
+            if (!item || item.disabled) return null;
+
+            input.value = item.value;
+            cancel();
+            clear();
+
+            const detail = { item, index, value: item.value, input, element: search };
+            search.dispatchEvent(new CustomEvent("pgs:search:select", { bubbles: true, detail }));
+            options.onSelect?.(detail);
+
+            input.focus();
+            if (submit && typeof search.requestSubmit === "function") search.requestSubmit();
+            return item;
+        }
+
+        function configure(nextOptions = {}) {
+            options = normalizeOptions(options, nextOptions);
+            return api;
+        }
+
+        function onInput() {
+            schedule();
+        }
+
+        function onFocus() {
+            if (items.length) openSearch(search);
+            else if (options.searchOnFocus) schedule();
+        }
+
+        function onKeydown(event) {
+            if (event.key === "ArrowDown") {
+                if (!pgs(search).state.contains("open")) schedule();
+                if (items.length) {
+                    event.preventDefault();
+                    moveActive(1);
+                }
+                return;
+            }
+
+            if (event.key === "ArrowUp" && items.length) {
+                event.preventDefault();
+                moveActive(-1);
+                return;
+            }
+
+            if (event.key === "Enter" && activeIndex >= 0) {
+                event.preventDefault();
+                select(activeIndex);
+                return;
+            }
+
+            if (event.key === "Escape") {
+                event.preventDefault();
+                cancel();
+                closeSearch(search);
+                return;
+            }
+
+            if (event.key === "Tab") closeSearch(search);
+        }
+
+        function onListPointerDown(event) {
+            const option = event.target.closest('[pgs~="search-suggestions-item"]');
+            if (!option || !list.contains(option)) return;
+            event.preventDefault();
+            select(Number.parseInt(option.dataset.index, 10));
+        }
+
+        function onSubmit() {
+            cancel();
+            closeSearch(search);
+        }
+
+        function destroy() {
+            cancel();
+            clear();
+            input.removeEventListener("input", onInput);
+            input.removeEventListener("focus", onFocus);
+            input.removeEventListener("keydown", onKeydown);
+            list.removeEventListener("pointerdown", onListPointerDown);
+            search.removeEventListener("submit", onSubmit);
+            API.delete(search);
+        }
+
+        const api = {
+            element: search,
+            input,
+            list,
+            configure,
+            setSource: source => configure({ source }),
+            search: runSearch,
+            open: () => openSearch(search),
+            close: () => closeSearch(search),
+            clear,
+            cancel,
+            select,
+            refresh: () => runSearch(input.value),
+            destroy,
+            items: () => [...items],
+            isOpen: () => pgs(search).state.contains("open"),
+            isLoading: () => pgs(search).state.contains("loading"),
+            setActiveIndex,
+        };
+
+        input.addEventListener("input", onInput);
+        input.addEventListener("focus", onFocus);
+        input.addEventListener("keydown", onKeydown);
+        list.addEventListener("pointerdown", onListPointerDown);
+        search.addEventListener("submit", onSubmit);
+        API.set(search, api);
+    });
+}
+
+document.addEventListener("pointerdown", event => {
+    OPEN_SEARCHES.forEach(search => {
+        if (!search.contains(event.target)) closeSearch(search);
+    });
+});
+
+PGS_search_init();
+
+export function PGS_search_api(selector) {
+    return API.get(selector);
+}
+
+export const PGS_search = {
+    init: PGS_search_init,
+    api: PGS_search_api,
+};

package/assets/javascript/index.js

@@ -4,6 +4,7 @@ export { pgs } from "./_pgs.js";
 
 //= BASE
 import "./base/_darkmode.js";
+import "./base/_svg.js";
 import "./base/_object.js";
 
 //= CN 
@@ -11,6 +12,7 @@ import "./components/_accordion.js";
 import "./components/_dropdown.js";
 import "./components/_menu.js"
 import "./components/_modals.js";
+import "./components/_search.js";
 import "./components/_slides.js"
 import "./components/_steps.js";
 import "./components/_stepTabs.js";

package/assets/javascript/layout/_header.js

@@ -93,9 +93,32 @@ function headerHeight() {
     document.documentElement.style.setProperty("--heightOfHeader", `${height}px`);
     document.documentElement.style.setProperty("--heightOfHeaderScroll", `${scrollHeight}px`);
 }
-headerHeight()
-window.addEventListener("resize", headerHeight);
-window.addEventListener("scroll", headerHeight);
+
+// Il modulo può essere caricato nel footer: rimanda il primo calcolo al frame
+// successivo, quando il browser ha già composto l'header, senza aspettare il
+// caricamento completo della pagina.
+let headerHeightRafId = 0;
+function scheduleHeaderHeight() {
+    if (headerHeightRafId) return;
+
+    headerHeightRafId = requestAnimationFrame(() => {
+        headerHeightRafId = 0;
+        headerHeight();
+    });
+}
+
+if (header) {
+    const headerHeightObserver = new ResizeObserver(scheduleHeaderHeight);
+    headerHeightObserver.observe(header);
+
+    // Un font web può modificare la larghezza del menu e quindi l'altezza
+    // dell'header, anche dopo il primo frame.
+    document.fonts?.ready?.then(scheduleHeaderHeight);
+}
+
+scheduleHeaderHeight();
+window.addEventListener("resize", scheduleHeaderHeight);
+window.addEventListener("scroll", scheduleHeaderHeight, { passive: true });
 
 
 
@@ -125,7 +148,3 @@ window.addEventListener("scroll", () => {
 
 });
 
-
-
-
-

package/assets/scss/base/_color.scss

@@ -5,7 +5,7 @@
 :root {
     color-scheme: light;
 
-    &[data-darkmode=true] {
+    &[pgs-state~=darkmode] {
         color-scheme: dark;
     }
 
@@ -21,10 +21,10 @@
     --color-white-transparent: color-mix(in srgb, var(--color-white) 50%, transparent 100%);
     --color-black-transparent: color-mix(in srgb, var(--color-black) 50%, transparent 100%);
     --color-text: light-dark(#4a4a4a, #e3e3e3);
-    --color-box: light-dark(#F8F8F8, #3A3A3A);
-    --color-boxDark: light-dark(#3A3A3A, #F8F8F8);
-    --color-box-transparent: light-dark(color-mix(in srgb, #eeeeee 50%, transparent 50%), color-mix(in srgb, #3A3A3A 50%, transparent 50%));
-    --color-boxDark-transparent: light-dark(color-mix(in srgb, #3A3A3A 50%, transparent 50%), color-mix(in srgb, #eeeeee 50%, transparent 50%));
+    --color-box: light-dark(#F8F8F8, #222121);
+    --color-boxDark: light-dark(#222121, #F8F8F8);
+    --color-box-transparent: light-dark(color-mix(in srgb, #eeeeee 50%, transparent 50%), color-mix(in srgb, #222121 50%, transparent 50%));
+    --color-boxDark-transparent: light-dark(color-mix(in srgb, #222121 50%, transparent 50%), color-mix(in srgb, #eeeeee 50%, transparent 50%));
     --color-linkBackgorud: light-dark(#a0dbff, #002a44);
     --color-background: light-dark(#ffffff, #080808);
     --color-whiteFixed: #FFFFFF;

package/assets/scss/base/_variables.scss

@@ -19,7 +19,8 @@
     --text-shadow: 0px 0px 50px #000000;
     --backdrop: #0000003e;
     --blur: blur(20px);
-    --page-top: calc(var(--heightOfHeaderScroll) + (var(--gap-elements)*2));
+    --page-top: calc(var(--heightOfHeader) + (var(--gap-elements)*2));
+    --page-topScroll: calc(var(--heightOfHeaderScroll) + (var(--gap-elements)*2));
     --page-width: 1280px;
     --page-space: clamp(var(--padding-page), calc((100% - var(--section-width)) / 2 + var(--padding-page)), 100%);
     --gap-texts: 1.0rem;
@@ -32,7 +33,8 @@
     --fa-size: inherit;
     --focus-visible: 3px solid var(--color-link);
     
-    --heightOfHeader: 13.3rem; ///preload fittizio
+    --heightOfHeader: 6.8rem; ///preload fittizio
+    --heightOfHeaderScroll: 6.8rem; ///preload fittizio
 
     //- mobile 
     @media (max-width: $mobile) {

package/assets/scss/components/_dropdown.scss

@@ -3,6 +3,7 @@
     --dropdown-background: var(--color-box);
     --dropdown-color: var(--color-black);
     --dropdown-border: var(--border-complete);
+    --dropdown-borderRadius: var(--dropdown-padding);
     --dropdown-padding: 1rem;
     --dropdown-inline-size: max-content;
     --dropdown-max-inline-size: min(400px, calc(100vw - 16px));
@@ -28,7 +29,7 @@
         overflow: auto;
         padding: var(--dropdown-padding);
         border: var(--dropdown-border);
-        border-radius: calc(var(--border-radius-input) + var(--dropdown-padding));
+        border-radius:  var(--dropdown-borderRadius);
         background: var(--dropdown-background);
         color: var(--dropdown-color);
     }

package/assets/scss/components/_logo.scss

@@ -8,12 +8,12 @@
     --logo-finter: invert(1) hue-rotate(180deg) brightness(1.5);
 
     //== DARKMODE
-    @at-root [data-darkmode=true] [pgs~="logo-darkmode"] [pgs~="logo-image"] {
+    @at-root [pgs-state~=darkmode] #{&}[pgs-option~="logoDarkmode"] [pgs~="logo-image"] {
         filter: var(--logo-finter);
     }
     
     //== FIXED DARKMODE
-    &[pgs~="logo-darkmodeFixed"][pgs~="logo-darkmode"] [pgs~="logo-image"] {
+    &[pgs-option~="logoDarkmodeFixed"] [pgs~="logo-image"] {
         filter: var(--logo-finter);
     }
     

package/assets/scss/components/_menu.scss

@@ -10,10 +10,6 @@
         row-gap: 1.0rem;
         flex-wrap: nowrap;
 
-        ul {
-            display: none;
-        }
-
         //== Content
         >li {
             >a {
@@ -30,6 +26,20 @@
             li {
                 width: -webkit-fill-available;
             }
+
+            &[pgs-state~=open]>ul {
+                display: flex;
+            }
+        }
+
+        //== submenu
+        ul {
+            display: none;
+            flex-direction: column;
+            gap: var(--gap-texts);
+            --dropdown-borderRadius: calc(var(--border-radius-input) + var(--dropdown-padding));
+            --dropdown-background: var(--color-box-transparent);
+            --dropdown-display: flex;
         }
     }
 
@@ -45,8 +55,12 @@
         cursor: pointer;
         translate: -15px;
 
-        &[aria-expanded="true"] span {
-            rotate: 180deg;
+        &[aria-expanded="true"] {
+            --button-background: var(--color-primary);
+
+            span {
+                rotate: 180deg;
+            }
         }
 
         span {
@@ -67,25 +81,9 @@
 
             //=== Sub menu
             >li:has(ul) {
-                --dropdown-display: flex;
                 display: flex;
                 gap: 0.2rem;
                 flex-wrap: nowrap;
-
-                >a {
-                    border-radius: var(--border-radius-input);
-                    // box-shadow: var(--box-shadow);
-                }
-
-                ul {
-                    li a {
-                        min-width: 100% !important;
-                    }
-                }
-
-                &[pgs-state~=open]>ul {
-                    display: flex;
-                }
             }
         }
     }
@@ -112,13 +110,8 @@
                 align-items: center;
                 position: relative;
 
-                >a {
-                    max-width: calc(100% - var(--gap-texts) - 40px);
-                }
-
                 >ul {
                     flex-basis: 100%;
-                    // --dropdown-maxwidth: 100%;
                 }
 
                 &:not([pgs-state~=open]) ul {

package/assets/scss/components/_modals.scss

@@ -79,7 +79,7 @@ dialog[pgs~="modal-dialog"] {
         &:has([pgs~="modal-dialog-content-scroll"]) {
             max-height: calc(90svh - var(--heightOfHeader));
             overflow: hidden;
-            
+
             [pgs~="modal-dialog-content-scroll"] {
                 padding-top: calc(var(--padding) / 2);
                 overflow: auto;
@@ -101,6 +101,16 @@ dialog[pgs~="modal-dialog"] {
     }
 
     //#OPTION
+    //== topLevel
+    &[pgs-option~="topLevel"] {
+        align-items: center;
+        padding-inline: 1rem;
+
+        [pgs~="modal-dialog-content"] {
+            width: min(600px, 100%);
+        }
+    }
+
     //== LEFT
     &[pgs-option~="left"] {
         [pgs~="modal-dialog-content"] {