☰

Google Search Custom Sidebar

Customizable Google Search sidebar: quick filters (lang, time, filetype, country, date), site search, Verbatim & Personalization tools.

  1. // ==UserScript==
  2. // @name         Google Search Custom Sidebar
  3. // @name:zh-TW   Google 搜尋自訂側邊欄
  4. // @name:ja      Google検索カスタムサイドバー
  5. // @namespace    https://gf.qytechs.cn/en/users/1467948-stonedkhajiit
  6. // @version      0.2.0
  7. // @description  Customizable Google Search sidebar: quick filters (lang, time, filetype, country, date), site search, Verbatim & Personalization tools.
  8. // @description:zh-TW Google 搜尋自訂側邊欄：快速篩選(語言、時間、檔案類型、國家、日期)、站內搜尋、一字不差與個人化工具。
  9. // @description:ja Google検索カスタムサイドバー：高速フィルター(言語,期間,ファイル形式,国,日付)、サイト検索、完全一致検索とパーソナライズツール。
  10. // @match        https://www.google.com/search*
  11. // @include      /^https:\/\/(?:ipv4|ipv6|www)\.google\.(?:[a-z\.]+)\/search\?(?:.+&)?q=[^&]+(?:&.+)?$/
  12. // @exclude      /^https:\/\/(?:ipv4|ipv6|www)\.google\.(?:[a-z\.]+)\/search\?(?:.+&)?(?:tbm=(?:isch|shop|bks|flm|fin|lcl)|udm=(?:2|28))(?:&.+)?$/
  13. // @icon         https://www.google.com/favicon.ico
  14. // @grant        GM_addStyle
  15. // @grant        GM_getValue
  16. // @grant        GM_setValue
  17. // @grant        GM_registerMenuCommand
  18. // @grant        GM_deleteValue
  19. // @run-at       document-idle
  20. // @author       StonedKhajiit
  21. // @license      MIT
  22. // @require      https://update.gf.qytechs.cn/scripts/535624/1607059/Google%20Search%20Custom%20Sidebar%20-%20i18n.js
  23. // @require      https://update.gf.qytechs.cn/scripts/535625/1607060/Google%20Search%20Custom%20Sidebar%20-%20Styles.js
  24. // ==/UserScript==
  25.  
  26. (function() {
  27.     'use strict';
  28.  
  29.     // --- Constants and Configuration ---
  30.     const SCRIPT_INTERNAL_NAME = 'GoogleSearchCustomSidebar';
  31.     const SCRIPT_VERSION = '0.2.0';
  32.     const LOG_PREFIX = `[${SCRIPT_INTERNAL_NAME} v${SCRIPT_VERSION}]`;
  33.  
  34.     const DEFAULT_SECTION_ORDER = [
  35.         'sidebar-section-language', 'sidebar-section-time', 'sidebar-section-filetype',
  36.         'sidebar-section-occurrence',
  37.         'sidebar-section-country', 'sidebar-section-date-range', 'sidebar-section-site-search', 'sidebar-section-tools'
  38.     ];
  39.  
  40.     const defaultSettings = {
  41.         sidebarPosition: { left: 0, top: 80 },
  42.         sectionStates: {},
  43.         theme: 'system',
  44.         hoverMode: false,
  45.         idleOpacity: 0.8,
  46.         sidebarWidth: 135,
  47.         fontSize: 12.5,
  48.         headerIconSize: 16,
  49.         verticalSpacingMultiplier: 0.5,
  50.         interfaceLanguage: 'auto',
  51.         visibleSections: {
  52.             'sidebar-section-language': true, 'sidebar-section-time': true, 'sidebar-section-filetype': true,
  53.             'sidebar-section-occurrence': true,
  54.             'sidebar-section-country': true, 'sidebar-section-date-range': true,
  55.             'sidebar-section-site-search': true, 'sidebar-section-tools': true
  56.         },
  57.         sectionDisplayMode: 'remember',
  58.         accordionMode: false,
  59.         resetButtonLocation: 'topBlock',
  60.         verbatimButtonLocation: 'header',
  61.         advancedSearchLinkLocation: 'header',
  62.         personalizationButtonLocation: 'tools',
  63.         googleScholarShortcutLocation: 'tools',
  64.         googleTrendsShortcutLocation: 'tools',
  65.         googleDatasetSearchShortcutLocation: 'tools',
  66.         countryDisplayMode: 'iconAndText',
  67.         customLanguages: [],
  68.         customTimeRanges: [],
  69.         customFiletypes: [
  70.             { text: "📄Documents", value: "pdf OR docx OR doc OR odt OR rtf OR txt" },
  71.             { text: "💹Spreadsheets", value: "xlsx OR xls OR ods OR csv" },
  72.             { text: "📊Presentations", value: "pptx OR ppt OR odp OR key" },
  73.         ],
  74.         customCountries: [],
  75.         displayLanguages: [],
  76.         displayCountries: [],
  77.         favoriteSites: [
  78.             // == SINGLE SITES: GENERAL KNOWLEDGE & REFERENCE ==
  79.             { text: 'Wikipedia (EN)', url: 'en.wikipedia.org' },
  80.             { text: 'Wiktionary', url: 'wiktionary.org' },
  81.             { text: 'Internet Archive', url: 'archive.org' },
  82.  
  83.             // == SINGLE SITES: DEVELOPER & TECH ==
  84.             { text: 'GitHub', url: 'github.com' },
  85.             { text: 'GitLab', url: 'gitlab.com' },
  86.             { text: 'Stack Overflow', url: 'stackoverflow.com' },
  87.             { text: 'Hacker News', url: 'news.ycombinator.com' },
  88.             { text: 'Greasy Fork镜像', url: 'gf.qytechs.cn' },
  89.  
  90.             // == SINGLE SITES: SOCIAL, FORUMS & COMMUNITIES ==
  91.             { text: 'Reddit', url: 'reddit.com' },
  92.             { text: 'X', url: 'x.com' },
  93.             { text: 'Mastodon', url: 'mastodon.social' },
  94.             { text: 'Bluesky', url: 'bsky.app' },
  95.             { text: 'Lemmy', url: 'lemmy.world' },
  96.  
  97.             // == SINGLE SITES: ENTERTAINMENT, ARTS & HOBBIES ==
  98.             { text: 'IMDb', url: 'imdb.com' },
  99.             { text: 'TMDb', url: 'themoviedb.org' },
  100.             { text: 'Letterboxd', url: 'letterboxd.com' },
  101.             { text: 'Metacritic', url: 'metacritic.com' },
  102.             { text: 'OpenCritic', url: 'opencritic.com' },
  103.             { text: 'Steam', url: 'store.steampowered.com' },
  104.             { text: 'Bandcamp', url: 'bandcamp.com' },
  105.             { text: 'Last.fm', url: 'last.fm' },
  106.  
  107.             // == COMBINED SITE GROUPS ==
  108.             {
  109.                 text: '💬Social',
  110.                 url: 'x.com OR facebook.com OR instagram.com OR threads.net OR bluesky.social OR mastodon.social OR reddit.com OR tumblr.com OR linkedin.com OR lemmy.world'
  111.             },
  112.             {
  113.                 text: '📦Repositories',
  114.                 url: 'github.com OR gitlab.com OR bitbucket.org OR codeberg.org OR sourceforge.net'
  115.             },
  116.             {
  117.                 text: '🎓Academics',
  118.                 url: 'scholar.google.com OR arxiv.org OR researchgate.net OR jstor.org OR academia.edu OR pubmed.ncbi.nlm.nih.gov OR semanticscholar.org OR core.ac.uk'
  119.             },
  120.             {
  121.                 text: '📰News',
  122.                 url: 'bbc.com/news OR reuters.com OR apnews.com OR nytimes.com OR theguardian.com OR cnn.com OR wsj.com'
  123.             },
  124.             {
  125.                 text: '🎨Creative',
  126.                 url: 'behance.net OR dribbble.com OR artstation.com OR deviantart.com'
  127.             }
  128.         ],
  129.         enableSiteSearchCheckboxMode: true,
  130.         showFaviconsForSiteSearch: true,
  131.         enableFiletypeCheckboxMode: true,
  132.         sidebarCollapsed: false,
  133.         draggableHandleEnabled: true,
  134.         enabledPredefinedOptions: {
  135.             language: ['lang_en'],
  136.             country: ['countryUS'],
  137.             time: ['d', 'w', 'm', 'y', 'h'],
  138.             filetype: ['pdf', 'docx', 'doc', 'pptx', 'ppt', 'xlsx', 'xls', 'txt']
  139.         },
  140.         sidebarSectionOrder: [...DEFAULT_SECTION_ORDER],
  141.         hideGoogleLogoWhenExpanded: false,
  142.     };
  143.  
  144.     let sidebar = null, systemThemeMediaQuery = null;
  145.     const MIN_SIDEBAR_TOP_POSITION = 5;
  146.     let debouncedSaveSettings;
  147.     let globalMessageTimeout = null;
  148.  
  149.     const IDS = {
  150.         SIDEBAR: 'customizable-search-sidebar', SETTINGS_OVERLAY: 'settings-overlay', SETTINGS_WINDOW: 'settings-window',
  151.         COLLAPSE_BUTTON: 'sidebar-collapse-button', SETTINGS_BUTTON: 'open-settings-button',
  152.         TOOL_RESET_BUTTON: 'tool-reset-button', TOOL_VERBATIM: 'tool-verbatim', TOOL_PERSONALIZE: 'tool-personalize-search',
  153.         TOOL_GOOGLE_SCHOLAR: 'tool-google-scholar',
  154.         TOOL_GOOGLE_TRENDS: 'tool-google-trends',
  155.         TOOL_GOOGLE_DATASET_SEARCH: 'tool-google-dataset-search',
  156.         APPLY_SELECTED_SITES_BUTTON: 'apply-selected-sites-button',
  157.         APPLY_SELECTED_FILETYPES_BUTTON: 'apply-selected-filetypes-button',
  158.         FIXED_TOP_BUTTONS: 'sidebar-fixed-top-buttons',
  159.         SETTINGS_MESSAGE_BAR: 'gscs-settings-message-bar',
  160.         SETTING_WIDTH: 'setting-sidebar-width', SETTING_FONT_SIZE: 'setting-font-size', SETTING_HEADER_ICON_SIZE: 'setting-header-icon-size',
  161.         SETTING_VERTICAL_SPACING: 'setting-vertical-spacing', SETTING_INTERFACE_LANGUAGE: 'setting-interface-language',
  162.         SETTING_SECTION_MODE: 'setting-section-display-mode', SETTING_ACCORDION: 'setting-accordion-mode',
  163.         SETTING_DRAGGABLE: 'setting-draggable-handle', SETTING_RESET_LOCATION: 'setting-reset-button-location',
  164.         SETTING_VERBATIM_LOCATION: 'setting-verbatim-button-location', SETTING_ADV_SEARCH_LOCATION: 'setting-adv-search-link-location',
  165.         SETTING_PERSONALIZE_LOCATION: 'setting-personalize-button-location',
  166.         SETTING_SCHOLAR_LOCATION: 'setting-scholar-shortcut-location',
  167.         SETTING_TRENDS_LOCATION: 'setting-trends-shortcut-location',
  168.         SETTING_DATASET_SEARCH_LOCATION: 'setting-dataset-search-shortcut-location',
  169.         SETTING_SITE_SEARCH_CHECKBOX_MODE: 'setting-site-search-checkbox-mode',
  170.         SETTING_SHOW_FAVICONS: 'setting-show-favicons',
  171.         SETTING_FILETYPE_SEARCH_CHECKBOX_MODE: 'setting-filetype-search-checkbox-mode',
  172.         SETTING_COUNTRY_DISPLAY_MODE: 'setting-country-display-mode', SETTING_THEME: 'setting-theme',
  173.         SETTING_HOVER: 'setting-hover-mode', SETTING_OPACITY: 'setting-idle-opacity',
  174.         SETTING_HIDE_GOOGLE_LOGO: 'setting-hide-google-logo',
  175.         TAB_PANE_GENERAL: 'tab-pane-general', TAB_PANE_APPEARANCE: 'tab-pane-appearance', TAB_PANE_FEATURES: 'tab-pane-features', TAB_PANE_CUSTOM: 'tab-pane-custom',
  176.         SITES_LIST: 'custom-sites-list', LANG_LIST: 'custom-languages-list', TIME_LIST: 'custom-time-ranges-list',
  177.         FT_LIST: 'custom-filetypes-list', COUNTRIES_LIST: 'custom-countries-list',
  178.         NEW_SITE_NAME: 'new-site-name', NEW_SITE_URL: 'new-site-url', ADD_SITE_BTN: 'add-site-button',
  179.         NEW_LANG_TEXT: 'new-lang-text', NEW_LANG_VALUE: 'new-lang-value', ADD_LANG_BTN: 'add-lang-button',
  180.         NEW_TIME_TEXT: 'new-timerange-text', NEW_TIME_VALUE: 'new-timerange-value', ADD_TIME_BTN: 'add-timerange-button',
  181.         NEW_FT_TEXT: 'new-ft-text', NEW_FT_VALUE: 'new-ft-value', ADD_FT_BTN: 'add-ft-button',
  182.         NEW_COUNTRY_TEXT: 'new-country-text', NEW_COUNTRY_VALUE: 'new-country-value', ADD_COUNTRY_BTN: 'add-country-button',
  183.         DATE_MIN: 'date-min', DATE_MAX: 'date-max', DATE_RANGE_ERROR_MSG: 'date-range-error-msg',
  184.         SIDEBAR_SECTION_ORDER_LIST: 'sidebar-section-order-list',
  185.         NOTIFICATION_CONTAINER: 'gscs-notification-container',
  186.         MODAL_ADD_NEW_OPTION_BTN: 'gscs-modal-add-new-option-btn',
  187.         MODAL_PREDEFINED_CHOOSER_CONTAINER: 'gscs-modal-predefined-chooser-container',
  188.         MODAL_PREDEFINED_CHOOSER_LIST: 'gscs-modal-predefined-chooser-list',
  189.         MODAL_PREDEFINED_CHOOSER_ADD_BTN: 'gscs-modal-predefined-chooser-add-btn',
  190.         MODAL_PREDEFINED_CHOOSER_CANCEL_BTN: 'gscs-modal-predefined-chooser-cancel-btn',
  191.         CLEAR_SITE_SEARCH_OPTION: 'clear-site-search-option',
  192.         CLEAR_FILETYPE_SEARCH_OPTION: 'clear-filetype-search-option'
  193.     };
  194.     const CSS = {
  195.         SIDEBAR_COLLAPSED: 'sidebar-collapsed', SIDEBAR_HEADER: 'sidebar-header', SIDEBAR_CONTENT_WRAPPER: 'sidebar-content-wrapper',
  196.         DRAG_HANDLE: 'sidebar-drag-handle', SETTINGS_BUTTON: 'sidebar-settings-button', HEADER_BUTTON: 'sidebar-header-button',
  197.         SIDEBAR_SECTION: 'sidebar-section', FIXED_TOP_BUTTON_ITEM: 'fixed-top-button-item', SECTION_TITLE: 'section-title',
  198.         SECTION_CONTENT: 'section-content', COLLAPSED: 'collapsed', FILTER_OPTION: 'filter-option', SELECTED: 'selected',
  199.         SITE_SEARCH_ITEM_CHECKBOX: 'site-search-item-checkbox',
  200.         FILETYPE_SEARCH_ITEM_CHECKBOX: 'filetype-search-item-checkbox',
  201.         APPLY_SITES_BUTTON: 'apply-sites-button',
  202.         APPLY_FILETYPES_BUTTON: 'apply-filetypes-button',
  203.         DATE_INPUT_LABEL: 'date-input-label', DATE_INPUT: 'date-input', TOOL_BUTTON: 'tool-button', ACTIVE: 'active',
  204.         CUSTOM_LIST: 'custom-list', ITEM_CONTROLS: 'item-controls', EDIT_CUSTOM_ITEM: 'edit-custom-item',
  205.         DELETE_CUSTOM_ITEM: 'delete-custom-item', CUSTOM_LIST_INPUT_GROUP: 'custom-list-input-group',
  206.         ADD_CUSTOM_BUTTON: 'add-custom-button', SETTINGS_HEADER: 'settings-header', SETTINGS_CLOSE_BTN: 'settings-close-button',
  207.         SETTINGS_TABS: 'settings-tabs', TAB_BUTTON: 'tab-button', SETTINGS_TAB_CONTENT: 'settings-tab-content',
  208.         TAB_PANE: 'tab-pane', SETTING_ITEM: 'setting-item', INLINE_LABEL: 'inline', SETTINGS_FOOTER: 'settings-footer',
  209.         SAVE_BUTTON: 'save-button', CANCEL_BUTTON: 'cancel-button', RESET_BUTTON: 'reset-button',
  210.         LIGHT_THEME: 'light-theme', DARK_THEME: 'dark-theme',
  211.         SIMPLE_ITEM: 'simple', RANGE_VALUE: 'range-value', RANGE_HINT: 'setting-range-hint', SECTION_ORDER_LIST: 'section-order-list',
  212.         INPUT_ERROR_MESSAGE: 'input-error-message', ERROR_VISIBLE: 'error-visible', INPUT_HAS_ERROR: 'input-has-error',
  213.         DATE_RANGE_ERROR_MSG: 'date-range-error-message',
  214.         MESSAGE_BAR: 'gscs-message-bar', MSG_INFO: 'gscs-msg-info', MSG_SUCCESS: 'gscs-msg-success',
  215.         MSG_WARNING: 'gscs-msg-warning', MSG_ERROR: 'gscs-msg-error', MANAGE_CUSTOM_BUTTON: 'manage-custom-button',
  216.         NOTIFICATION: 'gscs-notification',
  217.         NTF_INFO: 'gscs-ntf-info', NTF_SUCCESS: 'gscs-ntf-success',
  218.         NTF_WARNING: 'gscs-ntf-warning', NTF_ERROR: 'gscs-ntf-error',
  219.         DRAGGING_ITEM: 'gscs-dragging-item',
  220.         DRAG_OVER_HIGHLIGHT: 'gscs-drag-over-highlight',
  221.         DRAG_ICON: 'gscs-drag-icon',
  222.         FAVICON: 'gscs-favicon',
  223.         REMOVE_FROM_LIST_BTN: 'gscs-remove-from-list-btn',
  224.         MODAL_ADD_NEW_OPTION_BTN_CLASS: 'gscs-modal-add-new-option-button-class',
  225.         MODAL_PREDEFINED_CHOOSER_CLASS: 'gscs-modal-predefined-chooser',
  226.         MODAL_PREDEFINED_CHOOSER_ITEM: 'gscs-modal-predefined-chooser-item',
  227.         SETTING_VALUE_HINT: 'setting-value-hint'
  228.     };
  229.     const DATA_ATTR = {
  230.         FILTER_TYPE: 'filterType', FILTER_VALUE: 'filterValue', SITE_URL: 'siteUrl', SECTION_ID: 'sectionId',
  231.         FILETYPE_VALUE: 'filetypeValue',
  232.         LIST_ID: 'listId', INDEX: 'index', LISTENER_ATTACHED: 'listenerAttached', TAB: 'tab', MANAGE_TYPE: 'managetype',
  233.         ITEM_TYPE: 'itemType', ITEM_ID: 'itemId'
  234.     };
  235.     const STORAGE_KEY = 'googleSearchCustomSidebarSettings_v1';
  236.     const SVG_ICONS = {
  237.         chevronLeft: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><polyline points="15 18 9 12 15 6"></polyline></svg>`,
  238.         chevronRight: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><polyline points="9 18 15 12 9 6"></polyline></svg>`,
  239.         settings: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="3"></circle><path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 0 1 0 2.83 2 2 0 0 1-2.83 0l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-2 2 2 2 0 0 1-2-2v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 0 1-2.83 0 2 2 0 0 1 0-2.83l.06-.06a1.65 1.65 0 0 0 .33-1.82 1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1-2-2 2 2 0 0 1 2-2h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 0 1 0-2.83 2 2 0 0 1 2.83 0l.06.06a1.65 1.65 0 0 0 1.82.33H9a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 2-2 2 2 0 0 1 2 2v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 0 1 2.83 0 2 2 0 0 1 0 2.83l-.06-.06a1.65 1.65 0 0 0-.33 1.82V9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 0 1 2 2 2 2 0 0 1-2 2h-.09a1.65 1.65 0 0 0-1.51 1z"></path></svg>`,
  240.         reset: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="23 4 23 10 17 10"></polyline><polyline points="1 20 1 14 7 14"></polyline><path d="M3.51 9a9 9 0 0 1 14.85-3.36L23 10M1 14l4.64 4.36A9 9 0 0 0 20.49 15"></path></svg>`,
  241.         verbatim: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><g transform="translate(-4.3875 -3.2375) scale(1.15)"><path d="M6 17.5c0 1.5 1.5 2.5 3 2.5h1.5c1.5 0 3-1 3-2.5V9c0-1.5-1.5-2.5-3-2.5H9C7.5 6.5 6 7.5 6 9v8.5z"/><path d="M15 17.5c0 1.5 1.5 2.5 3 2.5h1.5c1.5 0 3-1 3-2.5V9c0-1.5-1.5-2.5-3-2.5H18c-1.5 0-3 1-3 2.5v8.5z"/></g></svg>`,
  242.         magnifyingGlass: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="11" cy="11" r="8"></circle><line x1="21" y1="21" x2="16.65" y2="16.65"></line></svg>`,
  243.         close: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>`,
  244.         edit: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7"></path><path d="M18.5 2.5a2.121 2.121 0 0 1 3 3L12 15l-4 1 1-4 9.5-9.5z"></path></svg>`,
  245.         delete: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="3 6 5 6 21 6"></polyline><path d="M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6m3 0V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2"></path><line x1="10" y1="11" x2="10" y2="17"></line><line x1="14" y1="11" x2="14" y2="17"></line></svg>`,
  246.         add: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><line x1="12" y1="5" x2="12" y2="19"></line><line x1="5" y1="12" x2="19" y2="12"></line></svg>`,
  247.         update: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"><polyline points="20 6 9 17 4 12"></polyline></svg>`,
  248.         personalization: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M20 21v-2a4 4 0 0 0-4-4H8a4 4 0 0 0-4 4v2"></path><circle cx="12" cy="7" r="4"></circle></svg>`,
  249.         dragGrip: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="1em" height="1em" fill="currentColor"><circle cx="9" cy="6" r="1.5"/><circle cx="15" cy="6" r="1.5"/><circle cx="9" cy="12" r="1.5"/><circle cx="15" cy="12" r="1.5"/><circle cx="9" cy="18" r="1.5"/><circle cx="15" cy="18" r="1.5"/></svg>`,
  250.         removeFromList: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>`,
  251.         googleScholar: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" width="1em" height="1em"><path d="M12 3L1 9l11 6 9-4.91V17h2V9L12 3zm0 11.24L3.62 9 12 5.11 20.38 9 12 14.24zM5 13.18V17.5a1.5 1.5 0 001.5 1.5h11A1.5 1.5 0 0019 17.5v-4.32l-7 3.82-7-3.82z"/></svg>`,
  252.         googleTrends: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" width="1em" height="1em"><path d="M16 6l2.29 2.29-4.88 4.88-4-4L2 16.59 3.41 18l6-6 4 4 6.3-6.29L22 12V6h-6z"/></svg>`,
  253.         googleDatasetSearch: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" width="1em" height="1em"><path d="M3 18v-2h18v2H3Zm0-5v-2h18v2H3Zm0-5V6h18v2H3Z"/></svg>`
  254.     };
  255.     const PREDEFINED_OPTIONS = {
  256.         language: [ { textKey: 'predefined_lang_en', value: 'lang_en' }, { textKey: 'predefined_lang_ja', value: 'lang_ja' }, { textKey: 'predefined_lang_ko', value: 'lang_ko' }, { textKey: 'predefined_lang_fr', value: 'lang_fr' }, { textKey: 'predefined_lang_de', value: 'lang_de' }, { textKey: 'predefined_lang_es', value: 'lang_es' }, { textKey: 'predefined_lang_it', value: 'lang_it' }, { textKey: 'predefined_lang_pt', value: 'lang_pt' }, { textKey: 'predefined_lang_ru', value: 'lang_ru' }, { textKey: 'predefined_lang_ar', value: 'lang_ar' }, { textKey: 'predefined_lang_hi', value: 'lang_hi' }, { textKey: 'predefined_lang_nl', value: 'lang_nl' }, { textKey: 'predefined_lang_tr', value: 'lang_tr' }, { textKey: 'predefined_lang_vi', value: 'lang_vi' }, { textKey: 'predefined_lang_th', value: 'lang_th' }, { textKey: 'predefined_lang_id', value: 'lang_id' }, { textKey: 'predefined_lang_zh_tw', value: 'lang_zh-TW' }, { textKey: 'predefined_lang_zh_cn', value: 'lang_zh-CN' }, { textKey: 'predefined_lang_zh_all', value: 'lang_zh-TW|lang_zh-CN' }, ],
  257.         country: [ { textKey: 'predefined_country_us', value: 'countryUS' }, { textKey: 'predefined_country_gb', value: 'countryGB' }, { textKey: 'predefined_country_ca', value: 'countryCA' }, { textKey: 'predefined_country_au', value: 'countryAU' }, { textKey: 'predefined_country_de', value: 'countryDE' }, { textKey: 'predefined_country_fr', value: 'countryFR' }, { textKey: 'predefined_country_jp', value: 'countryJP' }, { textKey: 'predefined_country_kr', value: 'countryKR' }, { textKey: 'predefined_country_cn', value: 'countryCN' }, { textKey: 'predefined_country_in', value: 'countryIN' }, { textKey: 'predefined_country_br', value: 'countryBR' }, { textKey: 'predefined_country_mx', value: 'countryMX' }, { textKey: 'predefined_country_es', value: 'countryES' }, { textKey: 'predefined_country_it', value: 'countryIT' }, { textKey: 'predefined_country_ru', value: 'countryRU' }, { textKey: 'predefined_country_nl', value: 'countryNL' }, { textKey: 'predefined_country_sg', value: 'countrySG' }, { textKey: 'predefined_country_hk', value: 'countryHK' }, { textKey: 'predefined_country_tw', value: 'countryTW' }, { textKey: 'predefined_country_my', value: 'countryMY' }, { textKey: 'predefined_country_vn', value: 'countryVN' }, { textKey: 'predefined_country_ph', value: 'countryPH' }, { textKey: 'predefined_country_th', value: 'countryTH' }, { textKey: 'predefined_country_za', value: 'countryZA' }, { textKey: 'predefined_country_tr', value: 'countryTR' }, ],
  258.         time: [ { textKey: 'predefined_time_h', value: 'h' }, { textKey: 'predefined_time_h2', value: 'h2' }, { textKey: 'predefined_time_h6', value: 'h6' }, { textKey: 'predefined_time_h12', value: 'h12' }, { textKey: 'predefined_time_d', value: 'd' }, { textKey: 'predefined_time_d2', value: 'd2' }, { textKey: 'predefined_time_d3', value: 'd3' }, { textKey: 'predefined_time_w', value: 'w' }, { textKey: 'predefined_time_m', value: 'm' }, { textKey: 'predefined_time_y', value: 'y' }, ],
  259.         filetype: [ { textKey: 'predefined_filetype_pdf', value: 'pdf' }, { textKey: 'predefined_filetype_docx', value: 'docx' }, { textKey: 'predefined_filetype_doc', value: 'doc' }, { textKey: 'predefined_filetype_xlsx', value: 'xlsx' }, { textKey: 'predefined_filetype_xls', value: 'xls' }, { textKey: 'predefined_filetype_pptx', value: 'pptx' }, { textKey: 'predefined_filetype_ppt', value: 'ppt' }, { textKey: 'predefined_filetype_txt', value: 'txt' }, { textKey: 'predefined_filetype_rtf', value: 'rtf' }, { textKey: 'predefined_filetype_html', value: 'html' }, { textKey: 'predefined_filetype_htm', value: 'htm' }, { textKey: 'predefined_filetype_xml', value: 'xml' }, { textKey: 'predefined_filetype_jpg', value: 'jpg' }, { textKey: 'predefined_filetype_png', value: 'png' }, { textKey: 'predefined_filetype_gif', value: 'gif' }, { textKey: 'predefined_filetype_svg', value: 'svg' }, { textKey: 'predefined_filetype_bmp', value: 'bmp' }, { textKey: 'predefined_filetype_js', value: 'js' }, { textKey: 'predefined_filetype_css', value: 'css' }, { textKey: 'predefined_filetype_py', value: 'py' }, { textKey: 'predefined_filetype_java', value: 'java' }, { textKey: 'predefined_filetype_cpp', value: 'cpp' }, { textKey: 'predefined_filetype_cs', value: 'cs' }, { textKey: 'predefined_filetype_kml', value: 'kml'}, { textKey: 'predefined_filetype_kmz', value: 'kmz'}, ]
  260.     };
  261.     const ALL_SECTION_DEFINITIONS = [
  262.         { id: 'sidebar-section-language', type: 'filter', titleKey: 'section_language', scriptDefined: [{textKey:'filter_any_language',v:''}], param: 'lr', predefinedOptionsKey: 'language', customItemsKey: 'customLanguages', displayItemsKey: 'displayLanguages' },
  263.         { id: 'sidebar-section-time', type: 'filter', titleKey: 'section_time', scriptDefined: [{textKey:'filter_any_time',v:''}], param: 'qdr', predefinedOptionsKey: 'time', customItemsKey: 'customTimeRanges' },
  264.         { id: 'sidebar-section-filetype', type: 'filetype', titleKey: 'section_filetype', scriptDefined: [{ textKey: 'filter_any_format', v: '' }], param: 'as_filetype', predefinedOptionsKey: 'filetype', customItemsKey: 'customFiletypes' },
  265.         {
  266.             id: 'sidebar-section-occurrence',
  267.             type: 'filter',
  268.             titleKey: 'section_occurrence',
  269.             scriptDefined: [
  270.                 { textKey: 'filter_occurrence_any', v: 'any' },
  271.                 { textKey: 'filter_occurrence_title', v: 'title' },
  272.                 { textKey: 'filter_occurrence_text', v: 'body' },
  273.                 { textKey: 'filter_occurrence_url', v: 'url' },
  274.                 { textKey: 'filter_occurrence_links', v: 'links' }
  275.             ],
  276.             param: 'as_occt'
  277.         },
  278.         { id: 'sidebar-section-country', type: 'filter', titleKey: 'section_country', scriptDefined: [{textKey:'filter_any_country',v:''}], param: 'cr', predefinedOptionsKey: 'country', customItemsKey: 'customCountries', displayItemsKey: 'displayCountries' },
  279.         { id: 'sidebar-section-date-range', type: 'date', titleKey: 'section_date_range' },
  280.         { id: 'sidebar-section-site-search', type: 'site', titleKey: 'section_site_search', scriptDefined: [{ textKey: 'filter_any_site', v:''}] },
  281.         { id: 'sidebar-section-tools', type: 'tools', titleKey: 'section_tools' }
  282.     ];
  283.  
  284.     const LocalizationService = (function() {
  285.         const builtInTranslations = {
  286.             'en': {
  287.                 scriptName: 'Google Search Custom Sidebar', settingsTitle: 'Google Search Custom Sidebar Settings', manageOptionsTitle: 'Manage Options', manageSitesTitle: 'Manage Favorite Sites', manageLanguagesTitle: 'Manage Language Options', manageCountriesTitle: 'Manage Country/Region Options', manageTimeRangesTitle: 'Manage Time Ranges', manageFileTypesTitle: 'Manage File Types', section_language: 'Language', section_time: 'Time', section_filetype: 'File Type', section_country: 'Country/Region', section_date_range: 'Date Range', section_site_search: 'Site Search', section_tools: 'Tools',
  288.                 section_occurrence: 'Keyword Location',
  289.                 filter_any_language: 'Any Language', filter_any_time: 'Any Time', filter_any_format: 'Any Format', filter_any_country: 'Any Country/Region', filter_any_site: 'Any Site',
  290.                 filter_occurrence_any: 'Anywhere in the page', filter_occurrence_title: 'In the title of the page', filter_occurrence_text: 'In the text of the page', filter_occurrence_url: 'In the URL of the page',
  291.                 filter_occurrence_links: 'In links to the page',
  292.                 filter_clear_site_search: 'Clear Site Search', filter_clear_tooltip_suffix: '(Clear)', predefined_lang_zh_tw: 'Traditional Chinese', predefined_lang_zh_cn: 'Simplified Chinese', predefined_lang_zh_all: 'All Chinese', predefined_lang_en: 'English', predefined_lang_ja: 'Japanese', predefined_lang_ko: 'Korean', predefined_lang_fr: 'French', predefined_lang_de: 'German', predefined_lang_es: 'Spanish', predefined_lang_it: 'Italian', predefined_lang_pt: 'Portuguese', predefined_lang_ru: 'Russian', predefined_lang_ar: 'Arabic', predefined_lang_hi: 'Hindi', predefined_lang_nl: 'Dutch', predefined_lang_tr: 'Turkish', predefined_lang_vi: 'Vietnamese', predefined_lang_th: 'Thai', predefined_lang_id: 'Indonesian', predefined_country_tw: '🇹🇼 Taiwan', predefined_country_jp: '🇯🇵 Japan', predefined_country_kr: '🇰🇷 South Korea', predefined_country_cn: '🇨🇳 China', predefined_country_hk: '🇭🇰 Hong Kong', predefined_country_sg: '🇸🇬 Singapore', predefined_country_my: '🇲🇾 Malaysia', predefined_country_vn: '🇻🇳 Vietnam', predefined_country_ph: '🇵🇭 Philippines', predefined_country_th: '🇹🇭 Thailand', predefined_country_us: '🇺🇸 United States', predefined_country_ca: '🇨🇦 Canada', predefined_country_br: '🇧🇷 Brazil', predefined_country_mx: '🇲🇽 Mexico', predefined_country_gb: '🇬🇧 United Kingdom', predefined_country_de: '🇩🇪 Germany', predefined_country_fr: '🇫🇷 France', predefined_country_it: '🇮🇹 Italy', predefined_country_es: '🇪🇸 Spain', predefined_country_ru: '🇷🇺 Russia', predefined_country_nl: '🇳🇱 Netherlands', predefined_country_au: '🇦🇺 Australia', predefined_country_in: '🇮🇳 India', predefined_country_za: '🇿🇦 South Africa', predefined_country_tr: '🇹🇷 Turkey', predefined_time_h: 'Past hour', predefined_time_h2: 'Past 2 hours', predefined_time_h6: 'Past 6 hours', predefined_time_h12: 'Past 12 hours', predefined_time_d: 'Past 24 hours', predefined_time_d2: 'Past 2 days', predefined_time_d3: 'Past 3 days', predefined_time_w: 'Past week', predefined_time_m: 'Past month', predefined_time_y: 'Past year', predefined_filetype_pdf: 'PDF', predefined_filetype_docx: 'Word (docx)', predefined_filetype_doc: 'Word (doc)', predefined_filetype_xlsx: 'Excel (xlsx)', predefined_filetype_xls: 'Excel (xls)', predefined_filetype_pptx: 'PowerPoint (pptx)', predefined_filetype_ppt: 'PowerPoint (ppt)', predefined_filetype_txt: 'Plain Text', predefined_filetype_rtf: 'Rich Text Format', predefined_filetype_html: 'Web Page (html)', predefined_filetype_htm: 'Web Page (htm)', predefined_filetype_xml: 'XML', predefined_filetype_jpg: 'JPEG Image', predefined_filetype_png: 'PNG Image', predefined_filetype_gif: 'GIF Image', predefined_filetype_svg: 'SVG Image', predefined_filetype_bmp: 'BMP Image', predefined_filetype_js: 'JavaScript', predefined_filetype_css: 'CSS', predefined_filetype_py: 'Python', predefined_filetype_java: 'Java', predefined_filetype_cpp: 'C++', predefined_filetype_cs: 'C#', predefined_filetype_kml: 'Google Earth (kml)', predefined_filetype_kmz: 'Google Earth (kmz)',
  293.                 tool_reset_filters: 'Reset Filters', tool_verbatim_search: 'Verbatim Search', tool_advanced_search: 'Advanced Search', tool_apply_date: 'Apply Dates',
  294.                 tool_personalization_toggle: 'Personalization', tool_apply_selected_sites: 'Apply Selected',
  295.                 tool_apply_selected_filetypes: 'Apply Selected',
  296.                 tool_google_scholar: 'Scholar',
  297.                 tooltip_google_scholar_search: 'Search keywords on Google Scholar',
  298.                 service_name_google_scholar: 'Google Scholar',
  299.                 tool_google_trends: 'Trends',
  300.                 tooltip_google_trends_search: 'Explore keywords on Google Trends',
  301.                 service_name_google_trends: 'Google Trends',
  302.                 tool_google_dataset_search: 'Dataset Search',
  303.                 tooltip_google_dataset_search: 'Search keywords on Google Dataset Search',
  304.                 service_name_google_dataset_search: 'Google Dataset Search',
  305.                 link_advanced_search_title: 'Open Google Advanced Search page', tooltip_site_search: 'Search within {siteUrl}', tooltip_clear_site_search: 'Remove site: restriction', tooltip_toggle_personalization_on: 'Click to turn Personalization ON (Results tailored to you)', tooltip_toggle_personalization_off: 'Click to turn Personalization OFF (More generic results)', settings_tab_general: 'General', settings_tab_appearance: 'Appearance', settings_tab_features: 'Features', settings_tab_custom: 'Custom', settings_close_button_title: 'Close', settings_interface_language: 'Interface Language:', settings_language_auto: 'Auto (Browser Default)', settings_section_mode: 'Section Collapse Mode:', settings_section_mode_remember: 'Remember State', settings_section_mode_expand: 'Expand All', settings_section_mode_collapse: 'Collapse All',
  306.                 settings_accordion_mode: 'Accordion Mode (only when "Remember State" is active)',
  307.                 settings_accordion_mode_hint_desc: 'When enabled, expanding one section will automatically collapse other open sections.',
  308.                 settings_enable_drag: 'Enable Dragging', settings_reset_button_location: 'Reset Button Location:', settings_verbatim_button_location: 'Verbatim Button Location:', settings_adv_search_location: '"Advanced Search" Link Location:', settings_personalize_button_location: 'Personalization Button Location:',
  309.                 settings_scholar_location: 'Google Scholar Shortcut Location:',
  310.                 settings_trends_location: 'Google Trends Shortcut Location:',
  311.                 settings_dataset_search_location: 'Dataset Search Shortcut Location:',
  312.                 settings_enable_site_search_checkbox_mode: 'Enable Checkbox Mode for Site Search',
  313.                 settings_enable_site_search_checkbox_mode_hint: 'Allows selecting multiple favorite sites for a combined (OR) search.',
  314.                 settings_show_favicons: 'Show Favicons for Site Search',
  315.                 settings_show_favicons_hint: 'Displays a website icon next to single-site entries for better identification.',
  316.                 settings_enable_filetype_search_checkbox_mode: 'Enable Checkbox Mode for Filetype Search',
  317.                 settings_enable_filetype_search_checkbox_mode_hint: 'Allows selecting multiple filetypes for a combined (OR) search.',
  318.                 settings_location_tools: 'Tools Section', settings_location_top: 'Top Block', settings_location_header: 'Sidebar Header', settings_location_hide: 'Hide', settings_sidebar_width: 'Sidebar Width (px)', settings_width_range_hint: '(Range: 90-270, Step: 5)', settings_font_size: 'Base Font Size (px)', settings_font_size_range_hint: '(Range: 8-24, Step: 0.5)', settings_header_icon_size: 'Header Icon Size (px)', settings_header_icon_size_range_hint: '(Range: 8-32, Step: 0.5)', settings_vertical_spacing: 'Vertical Spacing', settings_vertical_spacing_range_hint: '(Multiplier Range: 0.05-1.5, Step: 0.05)', settings_theme: 'Theme:', settings_theme_system: 'Follow System', settings_theme_light: 'Light', settings_theme_dark: 'Dark', settings_theme_minimal_light: 'Minimal (Light)', settings_theme_minimal_dark: 'Minimal (Dark)', settings_hover_mode: 'Hover Mode', settings_idle_opacity: 'Idle Opacity:', settings_opacity_range_hint: '(Range: 0.1-1.0, Step: 0.05)', settings_country_display: 'Country/Region Display:', settings_country_display_icontext: 'Icon & Text', settings_country_display_text: 'Text Only', settings_country_display_icon: 'Icon Only', settings_visible_sections: 'Visible Sections:', settings_section_order: 'Adjust Sidebar Section Order (Drag & Drop):',
  319.                 settings_section_order_hint: '(Drag items to reorder. Only affects checked sections)',
  320.                 settings_no_orderable_sections: 'No visible sections to order.',
  321.                 settings_move_up_title: 'Move Up',
  322.                 settings_move_down_title: 'Move Down',
  323.                 settings_hide_google_logo: 'Hide Google Logo when sidebar is expanded',
  324.                 settings_hide_google_logo_hint: 'Useful if the sidebar is placed in the top-left corner with a minimal theme.',
  325.                 settings_custom_intro: 'Manage filter options for each section:',
  326.                 settings_manage_sites_button: 'Manage Favorite Sites...', settings_manage_languages_button: 'Manage Language Options...', settings_manage_countries_button: 'Manage Country/Region Options...', settings_manage_time_ranges_button: 'Manage Time Ranges...', settings_manage_file_types_button: 'Manage File Types...', settings_save_button: 'Save Settings', settings_cancel_button: 'Cancel', settings_reset_all_button: 'Reset All',
  327.                 modal_label_enable_predefined: 'Enable Predefined {type}:',
  328.                 modal_label_my_custom: 'My Custom {type}:',
  329.                 modal_label_display_options_for: 'Display Options for {type} (Drag to Sort):',
  330.                 modal_button_add_new_option: 'Add New Option...',
  331.                 modal_button_add_predefined_option: 'Add Predefined...',
  332.                 modal_button_add_custom_option: 'Add Custom...',
  333.                 modal_placeholder_name: 'Name', modal_placeholder_domain: 'Domain (e.g., site.com OR example.net/path)',
  334.                 modal_placeholder_text: 'Text', modal_placeholder_value: 'Value (e.g., pdf OR docx)',
  335.                 modal_hint_domain: 'Format: domain/path (e.g., `wikipedia.org/wiki/Page` or `site.com`). Use `OR` (case-insensitive, space separated) for multiple.',
  336.                 modal_hint_language: 'Format: starts with `lang_`, e.g., `lang_ja`, `lang_zh-TW`. Use `|` for multiple.', modal_hint_country: 'Format: `country` + 2-letter uppercase code, e.g., `countryDE`', modal_hint_time: 'Format: `h`, `d`, `w`, `m`, `y`, optionally followed by numbers, e.g., `h1`, `d7`, `w`',
  337.                 modal_hint_filetype: 'Format: extension (e.g., `pdf`). Use `OR` (case-insensitive, space separated) for multiple (e.g., `docx OR xls`).',
  338.                 modal_tooltip_domain: 'Enter domain(s) with optional path(s). Use OR for multiple, e.g., site.com/path OR example.org',
  339.                 modal_tooltip_language: 'Format: lang_xx or lang_xx-XX, separate multiple with |', modal_tooltip_country: 'Format: countryXX (XX = uppercase country code)', modal_tooltip_time: 'Format: h, d, w, m, y, optionally followed by numbers',
  340.                 modal_tooltip_filetype: 'File extension(s). Use OR for multiple, e.g., pdf OR docx',
  341.                 modal_button_add_title: 'Add', modal_button_update_title: 'Update Item', modal_button_cancel_edit_title: 'Cancel Edit', modal_button_edit_title: 'Edit', modal_button_delete_title: 'Delete', modal_button_remove_from_list_title: 'Remove from list', modal_button_complete: 'Done', value_empty: '(empty)', date_range_from: 'From:', date_range_to: 'To:', sidebar_collapse_title: 'Collapse', sidebar_expand_title: 'Expand', sidebar_drag_title: 'Drag', sidebar_settings_title: 'Settings',
  342.                 alert_invalid_start_date: 'Invalid start date', alert_invalid_end_date: 'Invalid end date', alert_end_before_start: 'End date cannot be earlier than start date', alert_start_in_future: 'Start date cannot be in the future', alert_end_in_future: 'End date cannot be in the future', alert_select_date: 'Please select a date', alert_error_applying_date: 'Error applying date range', alert_error_applying_filter: 'Error applying filter {type}={value}', alert_error_applying_site_search: 'Error applying site search for {site}', alert_error_clearing_site_search: 'Error clearing site search', alert_error_resetting_filters: 'Error resetting filters', alert_error_toggling_verbatim: 'Error toggling Verbatim search', alert_error_toggling_personalization: 'Error toggling Personalization search', alert_enter_display_name: 'Please enter the display name for {type}.', alert_enter_value: 'Please enter the corresponding value for {type}.', alert_invalid_value_format: 'The value format for {type} is incorrect. {hint}', alert_duplicate_name: 'Custom item display name "{name}" already exists. Please use a different name.', alert_update_failed_invalid_index: 'Update failed: Invalid item index.', alert_edit_failed_missing_fields: 'Cannot edit: Input or button fields not found.',
  343.                 alert_no_more_predefined_to_add: 'No more predefined {type} options available to add.',
  344.                 alert_no_keywords_for_shortcut: 'No keywords found in current search to use for {service_name}.',
  345.                 alert_error_opening_link: 'Error opening link for {service_name}.',
  346.                 alert_generic_error: 'An unexpected error occurred. Please check the console or try again. Context: {context}',
  347.                 confirm_delete_item: 'Are you sure you want to delete the custom item "{name}"?', confirm_remove_item_from_list: 'Are you sure you want to remove "{name}" from this display list?', confirm_reset_settings: 'Are you sure you want to reset all settings to their default values?', alert_settings_reset_success: 'Settings have been reset to default. You can continue editing or click "Save Settings" to confirm.', confirm_reset_all_menu: 'Are you sure you want to reset all settings to their default values?\nThis cannot be undone and requires a page refresh to take effect.', alert_reset_all_menu_success: 'All settings have been reset to defaults.\nPlease refresh the page to apply the changes.', alert_reset_all_menu_fail: 'Failed to reset settings via menu command! Please check the console.', alert_init_fail: '{scriptName} initialization failed. Some features may not work. Please check the console for technical details.\nTechnical Error: {error}', menu_open_settings: '⚙️ Open Settings', menu_reset_all_settings: '🚨 Reset All Settings',
  348.             },
  349.         };
  350.         let effectiveTranslations = JSON.parse(JSON.stringify(builtInTranslations));
  351.         let _currentLocale = 'en';
  352.  
  353.         function _mergeExternalTranslations() {
  354.             if (typeof window.GSCS_Namespace !== 'undefined' && typeof window.GSCS_Namespace.i18nPack === 'object' && typeof window.GSCS_Namespace.i18nPack.translations === 'object') {
  355.                 const externalTranslations = window.GSCS_Namespace.i18nPack.translations;
  356.                 for (const langCode in externalTranslations) {
  357.                     if (Object.prototype.hasOwnProperty.call(externalTranslations, langCode)) {
  358.                         if (!effectiveTranslations[langCode]) {
  359.                             effectiveTranslations[langCode] = {};
  360.                         }
  361.                         for (const key in externalTranslations[langCode]) {
  362.                             if (Object.prototype.hasOwnProperty.call(externalTranslations[langCode], key)) {
  363.                                 effectiveTranslations[langCode][key] = externalTranslations[langCode][key];
  364.                             }
  365.                         }
  366.                     }
  367.                 }
  368.                  // After merging, ensure 'en' from builtInTranslations acts as a fallback for all known languages
  369.                 const englishDefaults = builtInTranslations.en;
  370.                 for (const langCode in effectiveTranslations) {
  371.                     if (langCode !== 'en' && Object.prototype.hasOwnProperty.call(effectiveTranslations, langCode)) {
  372.                         for (const key in englishDefaults) {
  373.                             if (Object.prototype.hasOwnProperty.call(englishDefaults, key) && typeof effectiveTranslations[langCode][key] === 'undefined') {
  374.                                 effectiveTranslations[langCode][key] = englishDefaults[key];
  375.                             }
  376.                         }
  377.                     }
  378.                 }
  379.  
  380.             } else {
  381.                 console.warn(`${LOG_PREFIX} [i18n] External i18n pack (window.GSCS_Namespace.i18nPack) not found or invalid. Using built-in translations only.`);
  382.             }
  383.             // Ensure all keys from builtInTranslations.en exist in 'en' to prevent errors
  384.             // if i18n.js is older or missing keys.
  385.             const ensureKeys = (lang, defaults) => {
  386.                 if (!effectiveTranslations[lang]) effectiveTranslations[lang] = {};
  387.                 for (const key in defaults) {
  388.                     if (!effectiveTranslations[lang][key]) {
  389.                         effectiveTranslations[lang][key] = defaults[key]; // Fallback to built-in English if key is missing in target lang
  390.                     }
  391.                 }
  392.             };
  393.             ensureKeys('en', builtInTranslations.en); // Ensure English is complete based on built-in
  394.         }
  395.  
  396.         function _detectBrowserLocale() {
  397.             let locale = 'en'; // Default
  398.             try {
  399.                 if (navigator.languages && navigator.languages.length) {
  400.                     locale = navigator.languages[0];
  401.                 } else if (navigator.language) {
  402.                     locale = navigator.language;
  403.                 }
  404.             } catch (e) {
  405.                 console.warn(`${LOG_PREFIX} [i18n] Error accessing navigator.language(s):`, e);
  406.             }
  407.  
  408.             // Try to match full locale (e.g., "zh-TW")
  409.             if (effectiveTranslations[locale]) return locale;
  410.  
  411.             // Try to match generic part (e.g., "zh" from "zh-TW")
  412.             if (locale.includes('-')) {
  413.                 const parts = locale.split('-');
  414.                 if (parts.length > 0 && effectiveTranslations[parts[0]]) return parts[0];
  415.                 // Try "language-Script" (e.g., "zh-Hant") if applicable, though less common for userscripts
  416.                 if (parts.length > 2 && effectiveTranslations[`${parts[0]}-${parts[1]}`]) return `${parts[0]}-${parts[1]}`;
  417.             }
  418.             return 'en'; // Fallback to English
  419.         }
  420.  
  421.         function _updateActiveLocale(settingsToUse) {
  422.             let newLocale = 'en'; // Default
  423.             const langSettingSource = (settingsToUse && Object.keys(settingsToUse).length > 0 && typeof settingsToUse.interfaceLanguage === 'string')
  424.                 ? settingsToUse
  425.                 : defaultSettings; // Fallback to defaultSettings if settingsToUse is empty/invalid
  426.  
  427.             const userSelectedLang = langSettingSource.interfaceLanguage;
  428.  
  429.             if (userSelectedLang && userSelectedLang !== 'auto') {
  430.                 if (effectiveTranslations[userSelectedLang]) {
  431.                     newLocale = userSelectedLang;
  432.                 } else if (userSelectedLang.includes('-')) {
  433.                     const genericLang = userSelectedLang.split('-')[0];
  434.                     if (effectiveTranslations[genericLang]) {
  435.                         newLocale = genericLang;
  436.                     } else {
  437.                         newLocale = _detectBrowserLocale(); // Fallback to browser if specific parts aren't found
  438.                     }
  439.                 } else {
  440.                     newLocale = _detectBrowserLocale(); // Fallback if selected lang doesn't exist
  441.                 }
  442.             } else { // 'auto' or undefined
  443.                 newLocale = _detectBrowserLocale();
  444.             }
  445.  
  446.             if (_currentLocale !== newLocale) {
  447.                 _currentLocale = newLocale;
  448.                 // console.log(`${LOG_PREFIX} [i18n] Locale updated to: ${_currentLocale}`);
  449.             }
  450.              // Warn if the chosen language isn't exactly what was set (e.g. "fr-CA" setting becomes "fr" due to availability)
  451.             if (userSelectedLang && userSelectedLang !== 'auto' && _currentLocale !== userSelectedLang && !userSelectedLang.startsWith(_currentLocale.split('-')[0])) {
  452.                 console.warn(`${LOG_PREFIX} [i18n] User selected language "${userSelectedLang}" was not fully available or matched. Using best match: "${_currentLocale}".`);
  453.             }
  454.         }
  455.  
  456.         _mergeExternalTranslations(); // Merge external translations once at service creation
  457.  
  458.         function getString(key, replacements = {}) {
  459.             let str = `[ERR: ${key} @ ${_currentLocale}]`; // Default error string
  460.             let found = false;
  461.  
  462.             // 1. Try current locale
  463.             if (effectiveTranslations[_currentLocale] && typeof effectiveTranslations[_currentLocale][key] !== 'undefined') {
  464.                 str = effectiveTranslations[_currentLocale][key];
  465.                 found = true;
  466.             }
  467.             // 2. If current locale has a generic part (e.g., "zh" from "zh-TW"), try that
  468.             else if (_currentLocale.includes('-')) {
  469.                 const genericLang = _currentLocale.split('-')[0];
  470.                 if (effectiveTranslations[genericLang] && typeof effectiveTranslations[genericLang][key] !== 'undefined') {
  471.                     str = effectiveTranslations[genericLang][key];
  472.                     found = true;
  473.                 }
  474.             }
  475.  
  476.             // 3. If not found and current locale is not English, fallback to English
  477.             if (!found && _currentLocale !== 'en') {
  478.                 if (effectiveTranslations['en'] && typeof effectiveTranslations['en'][key] !== 'undefined') {
  479.                     str = effectiveTranslations['en'][key];
  480.                     found = true;
  481.                     // console.warn(`${LOG_PREFIX} [i18n] Missing translation for key: "${key}" in locale: "${_currentLocale}". Fell back to "en".`);
  482.                 }
  483.             }
  484.  
  485.             // 4. If still not found (even in English), it's a critical miss
  486.             if (!found) {
  487.                 if (!(effectiveTranslations['en'] && typeof effectiveTranslations['en'][key] !== 'undefined')) {
  488.                     console.error(`${LOG_PREFIX} [i18n] CRITICAL: Missing translation for key: "${key}" in BOTH locale: "${_currentLocale}" AND default locale "en".`);
  489.                 } else {
  490.                     // This case should ideally not be hit if English is complete in builtInTranslations
  491.                     str = effectiveTranslations['en'][key]; // Should have been caught by step 3 if _currentLocale wasn't 'en'
  492.                     found = true;
  493.                 }
  494.                 if(!found) str = `[ERR_NF: ${key}]`; // Final error if truly not found anywhere
  495.             }
  496.  
  497.             // Replace placeholders
  498.             if (typeof str === 'string') {
  499.                 for (const placeholder in replacements) {
  500.                     if (Object.prototype.hasOwnProperty.call(replacements, placeholder)) {
  501.                         str = str.replace(new RegExp(`\\{${placeholder}\\}`, 'g'), replacements[placeholder]);
  502.                     }
  503.                 }
  504.             } else {
  505.                  console.error(`${LOG_PREFIX} [i18n] CRITICAL: Translation for key "${key}" is not a string:`, str);
  506.                  return `[INVALID_TYPE_FOR_KEY: ${key}]`;
  507.             }
  508.             return str;
  509.         }
  510.  
  511.         return {
  512.             getString: getString,
  513.             getCurrentLocale: function() { return _currentLocale; },
  514.             getTranslationsForLocale: function(locale = 'en') { return effectiveTranslations[locale] || effectiveTranslations['en']; },
  515.             initializeBaseLocale: function() { _updateActiveLocale(defaultSettings); }, // Initialize with defaults
  516.             updateActiveLocale: function(activeSettings) { _updateActiveLocale(activeSettings); },
  517.             getAvailableLocales: function() {
  518.                 const locales = new Set(['auto', 'en']); // 'auto' and 'en' are always options
  519.                 Object.keys(effectiveTranslations).forEach(lang => {
  520.                     // Only add if it's a valid language pack (not just an empty object)
  521.                     if (Object.keys(effectiveTranslations[lang]).length > 0) {
  522.                         locales.add(lang);
  523.                     }
  524.                 });
  525.                 return Array.from(locales).sort((a, b) => {
  526.                     if (a === 'auto') return -1;
  527.                     if (b === 'auto') return 1;
  528.                     if (a === 'en' && b !== 'auto') return -1;
  529.                     if (b === 'en' && a !== 'auto') return 1;
  530.  
  531.                     let nameA = a, nameB = b;
  532.                     try { nameA = new Intl.DisplayNames([a],{type:'language'}).of(a); } catch(e){}
  533.                     try { nameB = new Intl.DisplayNames([b],{type:'language'}).of(b); } catch(e){}
  534.                     return nameA.localeCompare(nameB);
  535.                 });
  536.             }
  537.         };
  538.     })();
  539. 	
  540.     const _ = LocalizationService.getString; // Shortcut
  541.  
  542.     const Utils = {
  543.         debounce: function(func, wait) {
  544.             let timeout;
  545.             return function executedFunction(...args) {
  546.                 const context = this;
  547.                 const later = () => {
  548.                     timeout = null;
  549.                     func.apply(context, args);
  550.                 };
  551.                 clearTimeout(timeout);
  552.                 timeout = setTimeout(later, wait);
  553.             };
  554.         },
  555.         mergeDeep: function(target, source) {
  556.             if (!source) return target; // If source is undefined or null, return target as is.
  557.             target = target || {}; // Ensure target is an object if it's initially null/undefined.
  558.  
  559.             for (const key in source) {
  560.                 if (Object.prototype.hasOwnProperty.call(source, key)) {
  561.                     const targetValue = target[key];
  562.                     const sourceValue = source[key];
  563.  
  564.                     if (sourceValue && typeof sourceValue === 'object' && !Array.isArray(sourceValue)) {
  565.                         // Recurse for nested objects
  566.                         target[key] = Utils.mergeDeep(targetValue, sourceValue);
  567.                     } else if (typeof sourceValue !== 'undefined') {
  568.                         // Assign if sourceValue is a primitive, array, or explicitly undefined
  569.                         target[key] = sourceValue;
  570.                     }
  571.                     // If sourceValue is undefined, target[key] remains unchanged (implicit else)
  572.                 }
  573.             }
  574.             return target;
  575.         },
  576.         clamp: function(num, min, max) {
  577.             return Math.min(Math.max(num, min), max);
  578.         },
  579.         parseIconAndText: function(fullText) {
  580.             // Regex to match one or more non-letter, non-number characters at the beginning, followed by optional whitespace
  581.             // \P{L} matches any character that is not a letter.
  582.             // \P{N} matches any character that is not a number.
  583.             // Using [^\p{L}\p{N}\s] might be too restrictive if icons can be complex symbols.
  584.             // This regex tries to capture common emoji/symbol patterns for icons.
  585.             const match = fullText.match(/^(\P{L}\P{N}\s*)+/u);
  586.             let icon = '';
  587.             let text = fullText;
  588.  
  589.             if (match && match[0].trim() !== '') {
  590.                 icon = match[0].trim(); // Trim to remove trailing spaces from the icon part
  591.                 text = fullText.substring(icon.length).trim(); // Trim to remove leading spaces from the text part
  592.             }
  593.             return { icon, text };
  594.         },
  595.         getCurrentURL: function() {
  596.             try {
  597.                 return new URL(window.location.href);
  598.             } catch (e) {
  599.                 console.error(`${LOG_PREFIX} Error creating URL object:`, e);
  600.                 return null;
  601.             }
  602.         },
  603.         parseCombinedValue: function(valueString) {
  604.             if (typeof valueString !== 'string' || !valueString.trim()) {
  605.                 return [];
  606.             }
  607.             // Split by " OR " (case-insensitive, with spaces around OR)
  608.             return valueString.split(/\s+OR\s+/i).map(s => s.trim()).filter(s => s.length > 0);
  609.         }
  610.     };
  611.     const NotificationManager = (function() {
  612.         let container = null;
  613.  
  614.         function init() {
  615.             if (document.getElementById(IDS.NOTIFICATION_CONTAINER)) {
  616.                 container = document.getElementById(IDS.NOTIFICATION_CONTAINER);
  617.                 return;
  618.             }
  619.             container = document.createElement('div');
  620.             container.id = IDS.NOTIFICATION_CONTAINER;
  621.             if (document.body) {
  622.                 document.body.appendChild(container);
  623.             } else {
  624.                 // This case should be rare as script runs at document-idle
  625.                 console.error(LOG_PREFIX + " NotificationManager.init(): document.body is not available!");
  626.                 container = null; // Ensure container is null if append fails
  627.             }
  628.         }
  629.  
  630.         function show(messageKey, messageArgs = {}, type = 'info', duration = 3000) {
  631.             if (!container) {
  632.                 // Fallback to alert if container isn't initialized
  633.                 const alertMsg = (typeof _ === 'function' && _(messageKey, messageArgs) && !(_(messageKey, messageArgs).startsWith('[ERR:')))
  634.                     ? _(messageKey, messageArgs)
  635.                     : `${messageKey} (args: ${JSON.stringify(messageArgs)})`; // Basic fallback if _ is not ready
  636.                 alert(alertMsg);
  637.                 return null;
  638.             }
  639.  
  640.             const notificationElement = document.createElement('div');
  641.             notificationElement.classList.add(CSS.NOTIFICATION);
  642.  
  643.             const typeClass = CSS[`NTF_${type.toUpperCase()}`] || CSS.NTF_INFO; // Fallback to info type
  644.             notificationElement.classList.add(typeClass);
  645.  
  646.             notificationElement.textContent = _(messageKey, messageArgs);
  647.  
  648.             if (duration <= 0) { // Persistent notification, add a close button
  649.                 const closeButton = document.createElement('span');
  650.                 closeButton.innerHTML = '×'; // Simple 'x'
  651.                 closeButton.style.cursor = 'pointer';
  652.                 closeButton.style.marginLeft = '10px';
  653.                 closeButton.style.float = 'right'; // Position to the right
  654.                 closeButton.onclick = () => notificationElement.remove();
  655.                 notificationElement.appendChild(closeButton);
  656.             }
  657.  
  658.             container.appendChild(notificationElement);
  659.  
  660.             if (duration > 0) {
  661.                 setTimeout(() => {
  662.                     notificationElement.style.opacity = '0'; // Start fade out
  663.                     setTimeout(() => notificationElement.remove(), 500); // Remove after fade out
  664.                 }, duration);
  665.             }
  666.             return notificationElement; // Return the element for potential further manipulation
  667.         }
  668.  
  669.         return { init: init, show: show };
  670.     })();
  671.  
  672.     // --- UI Element Creation and Management ---
  673.     // (createGenericListItem, populateListInModal, getListMapping etc. are complex and related to ModalManager now)
  674.     // Simplified here as they are mostly within ModalManager's scope or specific to section building
  675.  
  676.     function createGenericListItem(index, item, listId, mapping) {
  677.         // ... (implementation as provided, assuming it's largely correct for modal context)
  678.         const listItem = document.createElement('li');
  679.         listItem.dataset[DATA_ATTR.INDEX] = index;
  680.         listItem.dataset[DATA_ATTR.LIST_ID] = listId;
  681.         listItem.dataset[DATA_ATTR.ITEM_ID] = item.id || item.value || item.url; // Unique ID for the item itself
  682.         listItem.draggable = true; // All modal list items are draggable
  683.  
  684.         const dragIconSpan = document.createElement('span');
  685.         dragIconSpan.classList.add(CSS.DRAG_ICON);
  686.         dragIconSpan.innerHTML = SVG_ICONS.dragGrip;
  687.         listItem.appendChild(dragIconSpan);
  688.         
  689. const textSpan = document.createElement('span');
  690.  
  691. // Favicon logic for Site Search list in the modal
  692. const currentSettings = SettingsManager.getCurrentSettings();
  693. if (listId === IDS.SITES_LIST && currentSettings.showFaviconsForSiteSearch && item.url && !item.url.includes(' OR ')) {
  694.     const favicon = document.createElement('img');
  695.     favicon.src = `https://www.google.com/s2/favicons?sz=32&domain_url=${item.url}`;
  696.     favicon.classList.add(CSS.FAVICON);
  697.     favicon.loading = 'lazy';
  698.     textSpan.prepend(favicon);
  699. }
  700.  
  701. let displayText = item.text;
  702.         let paramName = ''; // To show "param=value"
  703.  
  704.         if (item.type === 'predefined' && item.originalKey) {
  705.             displayText = _(item.originalKey);
  706.             if (listId === IDS.COUNTRIES_LIST) { // Special handling for country icon+text
  707.                 const parsed = Utils.parseIconAndText(displayText);
  708.                 displayText = `${parsed.icon} ${parsed.text}`.trim();
  709.             }
  710.         }
  711.  
  712.         // Determine param name for display
  713.         if (mapping) { // Mapping comes from getListMapping
  714.             if (listId === IDS.LANG_LIST) paramName = ALL_SECTION_DEFINITIONS.find(s=>s.id === 'sidebar-section-language').param;
  715.             else if (listId === IDS.COUNTRIES_LIST) paramName = ALL_SECTION_DEFINITIONS.find(s=>s.id === 'sidebar-section-country').param;
  716.             else if (listId === IDS.SITES_LIST) paramName = 'site'; // Site search uses `site:` in query
  717.             else if (listId === IDS.TIME_LIST) paramName = ALL_SECTION_DEFINITIONS.find(s=>s.id === 'sidebar-section-time').param;
  718.             else if (listId === IDS.FT_LIST) {
  719.                 const ftSection = ALL_SECTION_DEFINITIONS.find(s => s.id === 'sidebar-section-filetype');
  720.                 if (ftSection) paramName = ftSection.param;
  721.             }
  722.         }
  723.  
  724. const valueForDisplay = item.value || item.url || _('value_empty');
  725. const fullTextContent = `${displayText} (${paramName}=${valueForDisplay})`;
  726. textSpan.appendChild(document.createTextNode(fullTextContent));
  727. textSpan.title = fullTextContent;
  728. listItem.appendChild(textSpan);
  729.  
  730.         const controlsSpan = document.createElement('span');
  731.         controlsSpan.classList.add(CSS.ITEM_CONTROLS);
  732.  
  733.         // Determine if item is "custom" or "predefined" for button display
  734.         if (item.type === 'custom' || listId === IDS.SITES_LIST || listId === IDS.TIME_LIST || listId === IDS.FT_LIST) {
  735.             // Sites, Time, Filetype lists are always treated as "custom" in terms of editability
  736.             controlsSpan.innerHTML =
  737.                 `<button class="${CSS.EDIT_CUSTOM_ITEM}" title="${_('modal_button_edit_title')}">${SVG_ICONS.edit}</button> ` +
  738.                 `<button class="${CSS.DELETE_CUSTOM_ITEM}" title="${_('modal_button_delete_title')}">${SVG_ICONS.delete}</button>`;
  739.             listItem.dataset[DATA_ATTR.ITEM_TYPE] = 'custom';
  740.         } else if (item.type === 'predefined') {
  741.             // Languages, Countries in mixed mode can have predefined items that can be removed (not deleted from source)
  742.             controlsSpan.innerHTML =
  743.                 `<button class="${CSS.REMOVE_FROM_LIST_BTN}" title="${_('modal_button_remove_from_list_title')}">${SVG_ICONS.removeFromList}</button>`;
  744.             listItem.dataset[DATA_ATTR.ITEM_TYPE] = 'predefined';
  745.         }
  746.         listItem.appendChild(controlsSpan);
  747.         return listItem;
  748.     }
  749.  
  750.     function populateListInModal(listId, items, contextElement = document) {
  751.         const listElement = contextElement.querySelector(`#${listId}`);
  752.         if (!listElement) {
  753.             console.warn(`${LOG_PREFIX} List element not found: #${listId} in context`, contextElement);
  754.             return;
  755.         }
  756.         listElement.innerHTML = ''; // Clear existing items
  757.         const fragment = document.createDocumentFragment();
  758.         const mapping = getListMapping(listId); // Get mapping for param name display
  759.  
  760.         if (!Array.isArray(items)) items = []; // Ensure items is an array
  761.  
  762.         items.forEach((item, index) => {
  763.             fragment.appendChild(createGenericListItem(index, item, listId, mapping));
  764.         });
  765.         listElement.appendChild(fragment);
  766.     }
  767.  
  768.     function getListMapping(listId) {
  769.         // Centralized configuration for custom lists in modals
  770.         const listMappings = {
  771.             [IDS.SITES_LIST]:     { itemsArrayKey: 'favoriteSites',           customItemsMasterKey: null,                 valueKey: 'url',   populateFn: populateListInModal, textInput: `#${IDS.NEW_SITE_NAME}`,    valueInput: `#${IDS.NEW_SITE_URL}`,    addButton: `#${IDS.ADD_SITE_BTN}`,    nameKey: 'section_site_search', isSortableMixed: false, predefinedSourceKey: null },
  772.             [IDS.LANG_LIST]:      { itemsArrayKey: 'displayLanguages',        customItemsMasterKey: 'customLanguages',    valueKey: 'value', populateFn: populateListInModal, textInput: `#${IDS.NEW_LANG_TEXT}`,    valueInput: `#${IDS.NEW_LANG_VALUE}`,    addButton: `#${IDS.ADD_LANG_BTN}`,    nameKey: 'section_language',    isSortableMixed: true,  predefinedSourceKey: 'language' },
  773.             [IDS.COUNTRIES_LIST]: { itemsArrayKey: 'displayCountries',      customItemsMasterKey: 'customCountries',  valueKey: 'value', populateFn: populateListInModal, textInput: `#${IDS.NEW_COUNTRY_TEXT}`, valueInput: `#${IDS.NEW_COUNTRY_VALUE}`, addButton: `#${IDS.ADD_COUNTRY_BTN}`, nameKey: 'section_country',   isSortableMixed: true,  predefinedSourceKey: 'country' },
  774.             [IDS.TIME_LIST]:      { itemsArrayKey: 'customTimeRanges',        customItemsMasterKey: null,                 valueKey: 'value', populateFn: populateListInModal, textInput: `#${IDS.NEW_TIME_TEXT}`,    valueInput: `#${IDS.NEW_TIME_VALUE}`,    addButton: `#${IDS.ADD_TIME_BTN}`,    nameKey: 'section_time',        isSortableMixed: false, predefinedSourceKey: 'time' }, // predefinedSourceKey for enabling checkbox list
  775.             [IDS.FT_LIST]:        { itemsArrayKey: 'customFiletypes',         customItemsMasterKey: null,                 valueKey: 'value', populateFn: populateListInModal, textInput: `#${IDS.NEW_FT_TEXT}`,      valueInput: `#${IDS.NEW_FT_VALUE}`,      addButton: `#${IDS.ADD_FT_BTN}`,      nameKey: 'section_filetype',    isSortableMixed: false, predefinedSourceKey: 'filetype' },// predefinedSourceKey for enabling checkbox list
  776.         };
  777.         return listMappings[listId] || null;
  778.     }
  779.  
  780.     function validateCustomInput(inputElement) {
  781.         if (!inputElement) return false; // Should not happen if called correctly
  782.         const value = inputElement.value.trim();
  783.         const id = inputElement.id;
  784.         let isValid = false;
  785.         let isEmpty = value === '';
  786.  
  787.         // Basic validation: name/text fields cannot be empty
  788.         if (id === IDS.NEW_SITE_NAME || id === IDS.NEW_LANG_TEXT || id === IDS.NEW_TIME_TEXT || id === IDS.NEW_FT_TEXT || id === IDS.NEW_COUNTRY_TEXT) {
  789.             isValid = !isEmpty;
  790.         } else if (id === IDS.NEW_SITE_URL) {
  791.             // Allow domains with paths, or TLD/SLD
  792.             // Updated regex to support paths:
  793.             // - Domain part: (?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)+[a-zA-Z]{2,}
  794.             // - Optional path part: (/[a-zA-Z0-9_.\-~%!$&'()*+,;=:@/']*)?  (Note: removed ' from allowed chars in path based on common practice)
  795.             // - TLD/SLD: (?:^\.(?:[a-zA-Z0-9-]{1,63}\.)*[a-zA-Z]{2,63}$)
  796.             const singleSiteRegex = /^(?:(?:(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)+[a-zA-Z]{2,})(?:\/[a-zA-Z0-9_.\-~%!$&()*+,;=:@/]+)*\/?)$|(?:^\.(?:[a-zA-Z0-9-]{1,63}\.)*[a-zA-Z]{2,63}$)/;
  797.             const parts = Utils.parseCombinedValue(value); // Handles " OR " separation
  798.             if (isEmpty) isValid = true;
  799.             else if (parts.length > 0) isValid = parts.every(part => singleSiteRegex.test(part));
  800.             else isValid = false;
  801.         } else if (id === IDS.NEW_LANG_VALUE) {
  802.             // Language code format: lang_xx or lang_xx-XX, multiple with |
  803.             isValid = isEmpty || /^lang_[a-zA-Z]{2,3}(?:-[a-zA-Z0-9]{2,4})?(?:\|lang_[a-zA-Z]{2,3}(?:-[a-zA-Z0-9]{2,4})?)*$/.test(value);
  804.         } else if (id === IDS.NEW_TIME_VALUE) {
  805.             // Time value format: h, d, w, m, y, optionally followed by numbers
  806.             isValid = isEmpty || /^[hdwmy]\d*$/.test(value);
  807.         } else if (id === IDS.NEW_FT_VALUE) {
  808.             // Filetype format: extension, multiple with " OR "
  809.             const singleFiletypeRegex = /^[a-zA-Z0-9]+$/;
  810.             const parts = Utils.parseCombinedValue(value);
  811.             if (isEmpty) isValid = true;
  812.             else if (parts.length > 0) isValid = parts.every(part => singleFiletypeRegex.test(part));
  813.             else isValid = false;
  814.         } else if (id === IDS.NEW_COUNTRY_VALUE) {
  815.             // Country code format: countryXX (XX = uppercase country code)
  816.             isValid = isEmpty || /^country[A-Z]{2}$/.test(value);
  817.         }
  818.  
  819.         // Visual feedback
  820.         inputElement.classList.remove('input-valid', 'input-invalid', CSS.INPUT_HAS_ERROR); // Clear previous states
  821.         _clearInputError(inputElement); // Clear any existing error message for this input
  822.  
  823.         if (!isEmpty) { // Only add validation classes if not empty
  824.             inputElement.classList.add(isValid ? 'input-valid' : 'input-invalid');
  825.             if (!isValid) inputElement.classList.add(CSS.INPUT_HAS_ERROR); // Red border for error
  826.         }
  827.  
  828.         return isValid || isEmpty; // Return true if format is valid OR if it's empty (emptiness check is separate)
  829.     }
  830.  
  831.     function _getInputErrorElement(inputElement) {
  832.         if (!inputElement || !inputElement.id) return null;
  833.         // Try to find the specific error message span for this input
  834.         let errorEl = inputElement.nextElementSibling;
  835.         if (errorEl && errorEl.classList.contains(CSS.INPUT_ERROR_MESSAGE) && errorEl.id === `${inputElement.id}-error-msg`) {
  836.             return errorEl;
  837.         }
  838.         // Fallback: search within parent div if structured that way
  839.         const parentDiv = inputElement.parentElement;
  840.         if (parentDiv) {
  841.             return parentDiv.querySelector(`#${inputElement.id}-error-msg`);
  842.         }
  843.         return null;
  844.     }
  845.     function _showInputError(inputElement, messageKey, messageArgs = {}) {
  846.         if (!inputElement) return;
  847.         const errorElement = _getInputErrorElement(inputElement);
  848.         if (errorElement) {
  849.             errorElement.textContent = _(messageKey, messageArgs);
  850.             errorElement.classList.add(CSS.ERROR_VISIBLE);
  851.         }
  852.         inputElement.classList.add(CSS.INPUT_HAS_ERROR);
  853.         inputElement.classList.remove('input-valid'); // Remove valid class if error
  854.     }
  855.     function _clearInputError(inputElement) {
  856.         if (!inputElement) return;
  857.         const errorElement = _getInputErrorElement(inputElement);
  858.         if (errorElement) {
  859.             errorElement.textContent = '';
  860.             errorElement.classList.remove(CSS.ERROR_VISIBLE);
  861.         }
  862.         inputElement.classList.remove(CSS.INPUT_HAS_ERROR, 'input-invalid');
  863.     }
  864.     function _clearAllInputErrorsInGroup(inputGroupElement) {
  865.         if (!inputGroupElement) return;
  866.         inputGroupElement.querySelectorAll(`input[type="text"]`).forEach(input => {
  867.             _clearInputError(input);
  868.             input.classList.remove('input-valid', 'input-invalid'); // Also clear validation classes
  869.         });
  870.     }
  871.     function _showGlobalMessage(messageKey, messageArgs = {}, type = 'info', duration = 3000, targetElementId = IDS.SETTINGS_MESSAGE_BAR) {
  872.         const messageBar = document.getElementById(targetElementId);
  873.         if (!messageBar) {
  874.             // If specific target (like modal message bar) not found, try general notification or alert
  875.             if (targetElementId !== IDS.SETTINGS_MESSAGE_BAR && NotificationManager && typeof NotificationManager.show === 'function') {
  876.                 NotificationManager.show(messageKey, messageArgs, type, duration > 0 ? duration : 5000); // Longer for notifications if persistent
  877.             } else {
  878.                  const alertMsg = (typeof _ === 'function' && _(messageKey, messageArgs) && !(_(messageKey, messageArgs).startsWith('[ERR:')))
  879.                     ? _(messageKey, messageArgs)
  880.                     : `${messageKey} (args: ${JSON.stringify(messageArgs)})`;
  881.                 alert(alertMsg);
  882.             }
  883.             return;
  884.         }
  885.  
  886.         if (globalMessageTimeout && targetElementId === IDS.SETTINGS_MESSAGE_BAR) { // Clear previous timeout for main settings bar
  887.             clearTimeout(globalMessageTimeout);
  888.             globalMessageTimeout = null;
  889.         }
  890.  
  891.         messageBar.textContent = _(messageKey, messageArgs);
  892.         messageBar.className = `${CSS.MESSAGE_BAR}`; // Reset classes
  893.         messageBar.classList.add(CSS[`MSG_${type.toUpperCase()}`] || CSS.MSG_INFO); // Add type-specific class
  894.         messageBar.style.display = 'block';
  895.  
  896.         if (duration > 0 && targetElementId === IDS.SETTINGS_MESSAGE_BAR) {
  897.             globalMessageTimeout = setTimeout(() => {
  898.                 messageBar.style.display = 'none';
  899.                 messageBar.textContent = '';
  900.                 messageBar.className = CSS.MESSAGE_BAR; // Reset classes
  901.             }, duration);
  902.         }
  903.     }
  904.     // Validates and prepares custom item data from input fields
  905.     function _validateAndPrepareCustomItemData(textInput, valueInput, itemTypeName, listId) {
  906.         if (!textInput || !valueInput) {
  907.             _showGlobalMessage('alert_edit_failed_missing_fields', {}, 'error', 0); // Persistent error
  908.             return { isValid: false };
  909.         }
  910.         _clearInputError(textInput);
  911.         _clearInputError(valueInput);
  912.  
  913.         const text = textInput.value.trim();
  914.         const value = valueInput.value.trim();
  915.         let hint = '';
  916.  
  917.         if (text === '') {
  918.             _showInputError(textInput, 'alert_enter_display_name', { type: itemTypeName });
  919.             textInput.focus();
  920.             return { isValid: false, errorField: textInput };
  921.         } else {
  922.              // If text is not empty, ensure no lingering error style
  923.             textInput.classList.remove(CSS.INPUT_HAS_ERROR);
  924.             // validateCustomInput(textInput); // No need to re-validate text if non-empty for basic types
  925.         }
  926.  
  927.  
  928.         if (value === '') {
  929.             _showInputError(valueInput, 'alert_enter_value', { type: itemTypeName });
  930.             valueInput.focus();
  931.             return { isValid: false, errorField: valueInput };
  932.         } else {
  933.             const isValueFormatValid = validateCustomInput(valueInput); // This also handles visual feedback
  934.             if (!isValueFormatValid) { // validateCustomInput already showed error if !isValid and not empty
  935.                  if (valueInput.classList.contains('input-invalid')) { // Error was shown by validateCustomInput
  936.                      valueInput.focus();
  937.                      return { isValid: false, errorField: valueInput };
  938.                  }
  939.                  // If not marked invalid by validateCustomInput but still failed (e.g. more complex logic not in regex)
  940.                 if (listId === IDS.COUNTRIES_LIST) hint = _('modal_tooltip_country');
  941.                 else if (listId === IDS.LANG_LIST) hint = _('modal_tooltip_language');
  942.                 else if (listId === IDS.TIME_LIST) hint = _('modal_tooltip_time');
  943.                 else if (listId === IDS.FT_LIST) hint = _('modal_tooltip_filetype');
  944.                 else if (listId === IDS.SITES_LIST) hint = _('modal_tooltip_domain');
  945.  
  946.                 _showInputError(valueInput, 'alert_invalid_value_format', { type: itemTypeName, hint: hint });
  947.                 valueInput.focus();
  948.                 return { isValid: false, errorField: valueInput };
  949.             }
  950.         }
  951.         return { isValid: true, text: text, value: value };
  952.     }
  953.     function _isDuplicateCustomItem(text, itemsToCheck, listId, editingIndex, editingItemInfoRef) {
  954.         const lowerText = text.toLowerCase();
  955.         return itemsToCheck.some((item, idx) => {
  956.             // Only check custom-type items for name duplication, or all items in SITES/TIME/FT lists
  957.             const itemIsCustom = item.type === 'custom' ||
  958.                                  listId === IDS.SITES_LIST ||
  959.                                  listId === IDS.TIME_LIST ||
  960.                                  listId === IDS.FT_LIST;
  961.             if (!itemIsCustom) return false; // Don't check predefined display names for duplication
  962.  
  963.             // If editing, allow saving if the name hasn't changed from its original
  964.             if (editingItemInfoRef && editingItemInfoRef.listId === listId && editingIndex === idx) {
  965.                 if (editingItemInfoRef.originalText?.toLowerCase() === lowerText) {
  966.                     return false; // Not a duplicate if it's the same item and name hasn't changed
  967.                 }
  968.             }
  969.             return item.text.toLowerCase() === lowerText;
  970.         });
  971.     }
  972.     function applyThemeToElement(element, themeSetting) {
  973.         if (!element) return;
  974.         // Remove all potential theme classes first
  975.         element.classList.remove(
  976.             CSS.LIGHT_THEME, CSS.DARK_THEME,
  977.             'minimal-theme', 'minimal-light', 'minimal-dark' // From styles.js
  978.         );
  979.  
  980.         let effectiveTheme = themeSetting;
  981.         // Settings window/modals should not use minimal theme directly, but fall back to light/dark
  982.         const isSettingsOrModal = element.id === IDS.SETTINGS_WINDOW ||
  983.                                   element.id === IDS.SETTINGS_OVERLAY ||
  984.                                   element.classList.contains('settings-modal-content') || // Modal content itself
  985.                                   element.classList.contains('settings-modal-overlay');   // Modal overlay
  986.  
  987.         if (isSettingsOrModal) {
  988.             if (themeSetting === 'minimal-light') effectiveTheme = 'light';
  989.             else if (themeSetting === 'minimal-dark') effectiveTheme = 'dark';
  990.         }
  991.  
  992.         switch (effectiveTheme) {
  993.             case 'dark':
  994.                 element.classList.add(CSS.DARK_THEME);
  995.                 break;
  996.             case 'minimal-light':
  997.                 element.classList.add('minimal-theme', 'minimal-light');
  998.                 break;
  999.             case 'minimal-dark':
  1000.                 element.classList.add('minimal-theme', 'minimal-dark');
  1001.                 break;
  1002.             case 'system':
  1003.                 const systemIsDark = systemThemeMediaQuery && systemThemeMediaQuery.matches;
  1004.                 element.classList.add(systemIsDark ? CSS.DARK_THEME : CSS.LIGHT_THEME);
  1005.                 break;
  1006.             case 'light':
  1007.             default:
  1008.                 element.classList.add(CSS.LIGHT_THEME);
  1009.                 break;
  1010.         }
  1011.     }
  1012.  
  1013.     const PredefinedOptionChooser = (function() {
  1014.         let _chooserContainer = null;
  1015.         let _currentListId = null;
  1016.         let _currentPredefinedSourceKey = null;
  1017.         let _currentDisplayItemsArrayRef = null; // Reference to the array like settings.displayLanguages
  1018.         let _currentModalContentContext = null; // The modal body where this chooser is shown
  1019.         let _onAddCallback = null;
  1020.  
  1021.         function _buildChooserHTML(listId, predefinedSourceKey, displayItemsArrayRef) {
  1022.             const allPredefinedSystemOptions = PREDEFINED_OPTIONS[predefinedSourceKey] || [];
  1023.  
  1024.             // Get values of predefined items already in the display list
  1025.             const currentDisplayedValues = new Set(
  1026.                 displayItemsArrayRef.filter(item => item.type === 'predefined').map(item => item.value)
  1027.             );
  1028.  
  1029.             const availablePredefinedToAdd = allPredefinedSystemOptions.filter(
  1030.                 opt => !currentDisplayedValues.has(opt.value)
  1031.             );
  1032.  
  1033.             if (availablePredefinedToAdd.length === 0) {
  1034.                 const itemTypeName = getListMapping(listId)?.nameKey ? _(getListMapping(listId).nameKey) : predefinedSourceKey;
  1035.                 _showGlobalMessage('alert_no_more_predefined_to_add', { type: itemTypeName }, 'info', 3000, IDS.SETTINGS_MESSAGE_BAR); // Show in main settings message bar
  1036.                 return null; // No HTML if nothing to add
  1037.             }
  1038.  
  1039.             let listHTML = `<ul id="${IDS.MODAL_PREDEFINED_CHOOSER_LIST}">`;
  1040.             availablePredefinedToAdd.forEach(opt => {
  1041.                 let displayText = _(opt.textKey);
  1042.                  if (listId === IDS.COUNTRIES_LIST) { // Special handling for country display
  1043.                     const parsed = Utils.parseIconAndText(displayText);
  1044.                     displayText = `${parsed.icon} ${parsed.text}`.trim();
  1045.                 }
  1046.                 const sanitizedValueForId = opt.value.replace(/[^a-zA-Z0-9-_]/g, ''); // Make value safe for ID
  1047.                 listHTML += `<li class="${CSS.MODAL_PREDEFINED_CHOOSER_ITEM}"><input type="checkbox" value="${opt.value}" id="chooser-${sanitizedValueForId}"><label for="chooser-${sanitizedValueForId}">${displayText}</label></li>`;
  1048.             });
  1049.             listHTML += `</ul>`;
  1050.  
  1051.             const buttonsHTML = `
  1052.                 <div class="chooser-buttons" style="text-align: right; margin-top: 10px;">
  1053.                     <button id="${IDS.MODAL_PREDEFINED_CHOOSER_ADD_BTN}" class="${CSS.TOOL_BUTTON}" style="margin-right: 5px;">${_('modal_button_add_title')}</button>
  1054.                     <button id="${IDS.MODAL_PREDEFINED_CHOOSER_CANCEL_BTN}" class="${CSS.TOOL_BUTTON}">${_('settings_cancel_button')}</button>
  1055.                 </div>`; // Use TOOL_BUTTON class for consistency
  1056.  
  1057.             return listHTML + buttonsHTML;
  1058.         }
  1059.  
  1060.         function _handleAdd() {
  1061.             if (!_chooserContainer) return;
  1062.             const selectedValues = [];
  1063.             _chooserContainer.querySelectorAll(`#${IDS.MODAL_PREDEFINED_CHOOSER_LIST} input[type="checkbox"]:checked`).forEach(cb => {
  1064.                 selectedValues.push(cb.value);
  1065.             });
  1066.  
  1067.             if (selectedValues.length > 0 && typeof _onAddCallback === 'function') {
  1068.                 _onAddCallback(selectedValues, _currentPredefinedSourceKey, _currentDisplayItemsArrayRef, _currentListId, _currentModalContentContext);
  1069.             }
  1070.             hide(); // Close the chooser after adding
  1071.         }
  1072.  
  1073.         function show(manageType, listId, predefinedSourceKey, displayItemsArrayRef, contextElement, onAddCb) {
  1074.             hide(); // Ensure any previous chooser is closed
  1075.  
  1076.             _currentListId = listId;
  1077.             _currentPredefinedSourceKey = predefinedSourceKey;
  1078.             _currentDisplayItemsArrayRef = displayItemsArrayRef;
  1079.             _currentModalContentContext = contextElement; // The modal's body
  1080.             _onAddCallback = onAddCb;
  1081.  
  1082.             const chooserHTML = _buildChooserHTML(listId, predefinedSourceKey, displayItemsArrayRef);
  1083.             if (!chooserHTML) return; // Nothing to show
  1084.  
  1085.             _chooserContainer = document.createElement('div');
  1086.             _chooserContainer.id = IDS.MODAL_PREDEFINED_CHOOSER_CONTAINER;
  1087.             _chooserContainer.classList.add(CSS.MODAL_PREDEFINED_CHOOSER_CLASS); // Apply specific styling
  1088.             _chooserContainer.innerHTML = chooserHTML;
  1089.  
  1090.             // Insert the chooser UI into the modal
  1091.             // Typically after the "Add New Option..." button or before the main custom list
  1092.             const addNewBtn = contextElement.querySelector(`#${IDS.MODAL_ADD_NEW_OPTION_BTN}`);
  1093.             if (addNewBtn && addNewBtn.parentNode) {
  1094.                 addNewBtn.insertAdjacentElement('afterend', _chooserContainer);
  1095.             } else {
  1096.                 // Fallback: insert before the main list if the "Add New" button isn't there (e.g., if it was hidden)
  1097.                 const mainListElement = contextElement.querySelector(`#${listId}`);
  1098.                 mainListElement?.insertAdjacentElement('beforebegin', _chooserContainer);
  1099.             }
  1100.             _chooserContainer.style.display = 'block'; // Make it visible
  1101.  
  1102.             // Add event listeners for the chooser's buttons
  1103.             _chooserContainer.querySelector(`#${IDS.MODAL_PREDEFINED_CHOOSER_ADD_BTN}`).addEventListener('click', _handleAdd);
  1104.             _chooserContainer.querySelector(`#${IDS.MODAL_PREDEFINED_CHOOSER_CANCEL_BTN}`).addEventListener('click', hide);
  1105.         }
  1106.  
  1107.         function hide() {
  1108.             if (_chooserContainer) {
  1109.                 _chooserContainer.remove();
  1110.                 _chooserContainer = null;
  1111.             }
  1112.             // Clear state
  1113.             _currentListId = null;
  1114.             _currentPredefinedSourceKey = null;
  1115.             _currentDisplayItemsArrayRef = null;
  1116.             _currentModalContentContext = null;
  1117.             _onAddCallback = null;
  1118.         }
  1119.  
  1120.         return {
  1121.             show: show,
  1122.             hide: hide,
  1123.             isOpen: function() { return !!_chooserContainer; }
  1124.         };
  1125.     })();
  1126.  
  1127.  
  1128.     const ModalManager = (function() {
  1129.         let _currentModal = null;
  1130.         let _currentModalContent = null; // Reference to the modal's content div for event binding
  1131.         let _editingItemInfo = null; // { listId, index, originalValue, originalText, addButton, cancelButton, arrayKey }
  1132.         let _draggedListItem = null; // For drag-and-drop within modal lists
  1133.  
  1134.         // Configuration for different types of custom options modals
  1135.         const modalConfigsData = {
  1136.             'site':     { modalTitleKey: 'manageSitesTitle',     listId: IDS.SITES_LIST,     itemsArrayKey: 'favoriteSites',           customItemsMasterKey: null,                 textPKey: 'modal_placeholder_name',   valPKey: 'modal_placeholder_domain', hintKey: 'modal_hint_domain',   fmtKey: 'modal_tooltip_domain',   isSortableMixed: false, predefinedSourceKey: null,       hasPredefinedToggles: false, manageType: 'site' },
  1137.             'language': { modalTitleKey: 'manageLanguagesTitle', listId: IDS.LANG_LIST,      itemsArrayKey: 'displayLanguages',        customItemsMasterKey: 'customLanguages',    textPKey: 'modal_placeholder_text',   valPKey: 'modal_placeholder_value',  hintKey: 'modal_hint_language', fmtKey: 'modal_tooltip_language', predefinedSourceKey: 'language', isSortableMixed: true,         hasPredefinedToggles: false, manageType: 'language' }, // displayLanguages is sortable, can mix predefined/custom
  1138.             'country':  { modalTitleKey: 'manageCountriesTitle', listId: IDS.COUNTRIES_LIST, itemsArrayKey: 'displayCountries',      customItemsMasterKey: 'customCountries',  textPKey: 'modal_placeholder_text',   valPKey: 'modal_placeholder_value',  hintKey: 'modal_hint_country',  fmtKey: 'modal_tooltip_country',  predefinedSourceKey: 'country',  isSortableMixed: true,         hasPredefinedToggles: false, manageType: 'country'  }, // displayCountries is sortable
  1139.             'time':     { modalTitleKey: 'manageTimeRangesTitle',listId: IDS.TIME_LIST,      itemsArrayKey: 'customTimeRanges',        customItemsMasterKey: null,                 textPKey: 'modal_placeholder_text',   valPKey: 'modal_placeholder_value',  hintKey: 'modal_hint_time',     fmtKey: 'modal_tooltip_time',     predefinedSourceKey: 'time',     isSortableMixed: false,        hasPredefinedToggles: true, manageType: 'time' }, // customTimeRanges only, but has predefined toggles
  1140.             'filetype': { modalTitleKey: 'manageFileTypesTitle', listId: IDS.FT_LIST,        itemsArrayKey: 'customFiletypes',         customItemsMasterKey: null,                 textPKey: 'modal_placeholder_text',   valPKey: 'modal_placeholder_value',  hintKey: 'modal_hint_filetype', fmtKey: 'modal_tooltip_filetype', predefinedSourceKey: 'filetype', isSortableMixed: false,        hasPredefinedToggles: true, manageType: 'filetype' }, // customFiletypes only, but has predefined toggles
  1141.         };
  1142.  
  1143.  
  1144.         function _createPredefinedOptionsSectionHTML(currentOptionType, typeNameKey, predefinedOptionsSource, enabledPredefinedValues) {
  1145.             const label = _(typeNameKey); // e.g., "Time", "File Type"
  1146.             const optionsHTML = (predefinedOptionsSource[currentOptionType] || []).map(option => {
  1147.                 const checkboxId = `predefined-${currentOptionType}-${option.value.replace(/[^a-zA-Z0-9-_]/g, '')}`; // Sanitize value for ID
  1148.                 const translatedOptionText = _(option.textKey);
  1149.                 const isChecked = enabledPredefinedValues.has(option.value);
  1150.                 return `<li><input type="checkbox" id="${checkboxId}" value="${option.value}" data-option-type="${currentOptionType}" ${isChecked ? 'checked' : ''}><label for="${checkboxId}">${translatedOptionText}</label></li>`;
  1151.             }).join('');
  1152.  
  1153.             return `<label style="font-weight: bold;">${_('modal_label_enable_predefined', { type: label })}</label><ul class="predefined-options-list" data-option-type="${currentOptionType}">${optionsHTML}</ul>`;
  1154.         }
  1155.  
  1156.  
  1157.         function _createModalListAndInputHTML(currentListId, textPlaceholderKey, valuePlaceholderKey, hintKey, formatTooltipKey, itemTypeName, isSortableMixed = false) {
  1158.             const mapping = getListMapping(currentListId); // To get input IDs
  1159.             const typeNameToDisplay = itemTypeName || (mapping ? _(mapping.nameKey) : 'Items'); // Fallback if itemTypeName isn't directly passed
  1160.  
  1161.             let headerHTML = '';
  1162.             let addNewOptionButtonHTML = '';
  1163.  
  1164.             if (isSortableMixed) {
  1165.                 // For Language/Country, where predefined and custom are mixed and sorted
  1166.                 headerHTML = `<label style="font-weight: bold; margin-top: 0.5em; display: block;">${_('modal_label_display_options_for', {type: typeNameToDisplay})}</label>`;
  1167.                 // Button to open the PredefinedOptionChooser or focus custom input
  1168.                 addNewOptionButtonHTML = `<div style="margin-bottom: 0.5em;"><button id="${IDS.MODAL_ADD_NEW_OPTION_BTN}" class="${CSS.MODAL_ADD_NEW_OPTION_BTN_CLASS} ${CSS.TOOL_BUTTON}">${_('modal_button_add_new_option')}</button></div>`;
  1169.             } else {
  1170.                  // For Sites, Time, Filetype (custom items only in the sortable list part)
  1171.                  headerHTML = `<label style="font-weight: bold; margin-top: 0.5em; display: block;">${_('modal_label_my_custom', { type: typeNameToDisplay })}</label>`;
  1172.             }
  1173.  
  1174.             // Get input IDs from mapping
  1175.             const textInputId = mapping ? mapping.textInput.substring(1) : `new-custom-${currentListId}-text`; // remove #
  1176.             const valueInputId = mapping ? mapping.valueInput.substring(1) : `new-custom-${currentListId}-value`;
  1177.             const addButtonId = mapping ? mapping.addButton.substring(1) : `add-custom-${currentListId}-button`;
  1178.  
  1179.             const inputGroupHTML = `
  1180.                 <div class="${CSS.CUSTOM_LIST_INPUT_GROUP}">
  1181.                     <div><input type="text" id="${textInputId}" placeholder="${_(textPlaceholderKey)}"><span id="${textInputId}-error-msg" class="${CSS.INPUT_ERROR_MESSAGE}"></span></div>
  1182.                     <div><input type="text" id="${valueInputId}" placeholder="${_(valuePlaceholderKey)}" title="${_(formatTooltipKey)}"><span id="${valueInputId}-error-msg" class="${CSS.INPUT_ERROR_MESSAGE}"></span></div>
  1183.                     <button id="${addButtonId}" class="${CSS.ADD_CUSTOM_BUTTON} custom-list-action-button" data-list-id="${currentListId}" title="${_('modal_button_add_title')}">${SVG_ICONS.add}</button>
  1184.                     <button class="cancel-edit-button" style="display: none;" title="${_('modal_button_cancel_edit_title')}">${SVG_ICONS.close}</button>
  1185.                 </div>`;
  1186.             const hintHTML = `<span class="setting-value-hint">${_(hintKey)}</span>`;
  1187.  
  1188.             return `${addNewOptionButtonHTML}${headerHTML}<ul id="${currentListId}" class="${CSS.CUSTOM_LIST}"></ul>${inputGroupHTML}${hintHTML}`;
  1189.         }
  1190.  
  1191.  
  1192.         // Resets the input fields and button states when an edit is cancelled or completed
  1193.         function _resetEditStateInternal(contextElement = _currentModalContent) {
  1194.             if (_editingItemInfo) {
  1195.                 const mapping = getListMapping(_editingItemInfo.listId);
  1196.                 if (_editingItemInfo.addButton) {
  1197.                     _editingItemInfo.addButton.innerHTML = SVG_ICONS.add;
  1198.                     _editingItemInfo.addButton.title = _('modal_button_add_title');
  1199.                     _editingItemInfo.addButton.classList.remove('update-mode'); // Visual cue for update mode
  1200.                 }
  1201.                 if (_editingItemInfo.cancelButton) {
  1202.                     _editingItemInfo.cancelButton.style.display = 'none';
  1203.                 }
  1204.  
  1205.                 // Clear input fields if mapping and context are available
  1206.                 if (mapping && contextElement) {
  1207.                     const textInput = contextElement.querySelector(mapping.textInput);
  1208.                     const valueInput = contextElement.querySelector(mapping.valueInput);
  1209.                     const inputGroup = textInput?.closest(`.${CSS.CUSTOM_LIST_INPUT_GROUP}`);
  1210.                     if(inputGroup) _clearAllInputErrorsInGroup(inputGroup);
  1211.  
  1212.                     if (textInput) { textInput.value = ''; textInput.classList.remove('input-valid', 'input-invalid', CSS.INPUT_HAS_ERROR); _clearInputError(textInput); }
  1213.                     if (valueInput) { valueInput.value = ''; valueInput.classList.remove('input-valid', 'input-invalid', CSS.INPUT_HAS_ERROR); _clearInputError(valueInput); }
  1214.                 }
  1215.             }
  1216.             _editingItemInfo = null;
  1217.         }
  1218.  
  1219.         function _prepareEditItemActionInternal(item, index, listId, mapping, contextElement) {
  1220.             const textInput = contextElement.querySelector(mapping.textInput);
  1221.             const valueInput = contextElement.querySelector(mapping.valueInput);
  1222.             const addButton = contextElement.querySelector(mapping.addButton); // Should be the "Add/Update" button
  1223.             const cancelButton = addButton?.parentElement?.querySelector('.cancel-edit-button');
  1224.  
  1225.             if (textInput && valueInput && addButton && cancelButton) {
  1226.                 // If already editing another item, reset that state first
  1227.                 if (_editingItemInfo && (_editingItemInfo.listId !== listId || _editingItemInfo.index !== index)) {
  1228.                     _resetEditStateInternal(contextElement);
  1229.                 }
  1230.  
  1231.                 textInput.value = item.text;
  1232.                 valueInput.value = item[mapping.valueKey] || item.value; // Use specific valueKey if defined (e.g., 'url' for sites)
  1233.  
  1234.                 _editingItemInfo = {
  1235.                     listId,
  1236.                     index,
  1237.                     originalValue: item[mapping.valueKey] || item.value, // Store original for comparison on save
  1238.                     originalText: item.text,
  1239.                     addButton,
  1240.                     cancelButton,
  1241.                     arrayKey: mapping.itemsArrayKey || mapping.displayArrayKey // Which array in settings this list maps to
  1242.                 };
  1243.  
  1244.                 addButton.innerHTML = SVG_ICONS.update; // Change icon to "update"
  1245.                 addButton.title = _('modal_button_update_title');
  1246.                 addButton.classList.add('update-mode');
  1247.                 cancelButton.style.display = 'inline-block'; // Show cancel button
  1248.  
  1249.                 // Validate initially loaded values (might be invalid if manually edited in storage)
  1250.                 validateCustomInput(valueInput);
  1251.                 validateCustomInput(textInput); // Although text is usually just non-empty
  1252.                 textInput.focus();
  1253.             } else {
  1254.                 // This indicates a problem with the modal's HTML structure or selectors
  1255.                 const errorSourceInput = textInput || valueInput || addButton?.closest(`.${CSS.CUSTOM_LIST_INPUT_GROUP}`)?.querySelector('input[type="text"]');
  1256.                 if (errorSourceInput) _showInputError(errorSourceInput, 'alert_edit_failed_missing_fields');
  1257.                 else _showGlobalMessage('alert_edit_failed_missing_fields', {}, 'error', 0, _currentModalContent?.querySelector(`#${IDS.SETTINGS_MESSAGE_BAR}`) ? IDS.SETTINGS_MESSAGE_BAR : null);
  1258.  
  1259.             }
  1260.         }
  1261.  
  1262.         function _handleCustomListActionsInternal(event, contextElement, itemsArrayRef) {
  1263.             const button = event.target.closest(`button.${CSS.EDIT_CUSTOM_ITEM}, button.${CSS.DELETE_CUSTOM_ITEM}, button.${CSS.REMOVE_FROM_LIST_BTN}`);
  1264.             if (!button) return;
  1265.  
  1266.             const listItem = button.closest(`li[data-${DATA_ATTR.INDEX}][data-list-id]`);
  1267.             if (!listItem) return;
  1268.  
  1269.             const index = parseInt(listItem.dataset[DATA_ATTR.INDEX], 10);
  1270.             const listId = listItem.getAttribute('data-list-id'); // e.g., IDS.SITES_LIST
  1271.  
  1272.             if (isNaN(index) || !listId || index < 0 || index >= itemsArrayRef.length) return;
  1273.  
  1274.             const mapping = getListMapping(listId);
  1275.             if (!mapping) return;
  1276.  
  1277.             const item = itemsArrayRef[index];
  1278.             if (!item) return; // Should not happen
  1279.  
  1280.             const itemIsTrulyCustom = item.type === 'custom' ||
  1281.                                      (!item.type && (listId === IDS.SITES_LIST || listId === IDS.TIME_LIST || listId === IDS.FT_LIST));
  1282.  
  1283.  
  1284.             if (button.classList.contains(CSS.DELETE_CUSTOM_ITEM) && itemIsTrulyCustom) {
  1285.                 if (confirm(_('confirm_delete_item', { name: item.text }))) {
  1286.                     // If deleting the item currently being edited, reset edit state
  1287.                     if (_editingItemInfo && _editingItemInfo.listId === listId && _editingItemInfo.index === index) {
  1288.                         _resetEditStateInternal(contextElement);
  1289.                     }
  1290.                     itemsArrayRef.splice(index, 1);
  1291.                     mapping.populateFn(listId, itemsArrayRef, contextElement); // Re-render list
  1292.                 }
  1293.             } else if (button.classList.contains(CSS.REMOVE_FROM_LIST_BTN) && item.type === 'predefined') {
  1294.                 // For sortable mixed lists (Lang, Country), predefined items can be removed from display
  1295.                 if (confirm(_('confirm_remove_item_from_list', { name: (item.originalKey ? _(item.originalKey) : item.text) }))) {
  1296.                     itemsArrayRef.splice(index, 1);
  1297.                     mapping.populateFn(listId, itemsArrayRef, contextElement);
  1298.                 }
  1299.             } else if (button.classList.contains(CSS.EDIT_CUSTOM_ITEM) && itemIsTrulyCustom) {
  1300.                 _prepareEditItemActionInternal(item, index, listId, mapping, contextElement);
  1301.             }
  1302.         }
  1303.  
  1304.         function _handleCustomItemSubmitInternal(listId, contextElement, itemsArrayRef) {
  1305.             const mapping = getListMapping(listId);
  1306.             if (!mapping) return;
  1307.  
  1308.             const itemTypeName = _(mapping.nameKey); // For error messages
  1309.             const textInput = contextElement.querySelector(mapping.textInput);
  1310.             const valueInput = contextElement.querySelector(mapping.valueInput);
  1311.  
  1312.             // Clear previous errors for this group before re-validating
  1313.             const inputGroup = textInput?.closest(`.${CSS.CUSTOM_LIST_INPUT_GROUP}`);
  1314.             if (inputGroup) _clearAllInputErrorsInGroup(inputGroup);
  1315.  
  1316.  
  1317.             const validationResult = _validateAndPrepareCustomItemData(textInput, valueInput, itemTypeName, listId);
  1318.             if (!validationResult.isValid) {
  1319.                 if (validationResult.errorField) validationResult.errorField.focus(); // Focus the first problematic field
  1320.                 return;
  1321.             }
  1322.  
  1323.             const { text, value } = validationResult;
  1324.             const editingIdx = (_editingItemInfo && _editingItemInfo.listId === listId) ? _editingItemInfo.index : -1;
  1325.  
  1326.             // Check for duplicate display names (only for custom items or all in non-mixed lists)
  1327.             let isDuplicate;
  1328.             if (mapping.isSortableMixed) { // Lang, Country - check against other custom items in the display list
  1329.                 isDuplicate = _isDuplicateCustomItem(text, itemsArrayRef, listId, editingIdx, _editingItemInfo);
  1330.             } else { // Sites, Time, Filetypes - all items are effectively "custom" in editability
  1331.                 isDuplicate = itemsArrayRef.some((item, idx) => {
  1332.                     if (editingIdx === idx && (_editingItemInfo?.originalText?.toLowerCase() === text.toLowerCase())) return false; // Allow saving if name unchanged
  1333.                     return item.text.toLowerCase() === text.toLowerCase();
  1334.                 });
  1335.             }
  1336.  
  1337.             if (isDuplicate) {
  1338.                 if (textInput) _showInputError(textInput, 'alert_duplicate_name', { name: text });
  1339.                 textInput?.focus();
  1340.                 return;
  1341.             }
  1342.  
  1343.             // Prepare new item data
  1344.             let newItemData;
  1345.             if (listId === IDS.SITES_LIST) {
  1346.                 newItemData = { text: text, url: value }; // Sites use 'url'
  1347.             } else if (mapping.isSortableMixed) { // Lang, Country
  1348.                 newItemData = { id: value, text: text, value: value, type: 'custom' }; // Ensure type is 'custom'
  1349.             } else { // Time, Filetype
  1350.                 newItemData = { text: text, value: value };
  1351.             }
  1352.  
  1353.             // Determine if this item being edited is actually of a type that *can* be edited
  1354.             // (e.g., a predefined item in a mixed list should not be "updated" this way)
  1355.             const itemBeingEdited = (editingIdx > -1) ? itemsArrayRef[editingIdx] : null;
  1356.             const itemBeingEditedIsCustom = itemBeingEdited &&
  1357.                                            (itemBeingEdited.type === 'custom' || // Explicitly custom
  1358.                                             listId === IDS.SITES_LIST ||         // Or one of these list types
  1359.                                             listId === IDS.TIME_LIST ||
  1360.                                             listId === IDS.FT_LIST);
  1361.  
  1362.             if (editingIdx > -1 && itemBeingEditedIsCustom) { // Update existing custom item
  1363.                 // Merge new data into existing, preserving other properties if any
  1364.                 itemsArrayRef[editingIdx] = {...itemsArrayRef[editingIdx], ...newItemData };
  1365.                 _resetEditStateInternal(contextElement); // Reset inputs and button
  1366.             } else { // Add as new custom item
  1367.                 itemsArrayRef.push(newItemData);
  1368.             }
  1369.  
  1370.             mapping.populateFn(listId, itemsArrayRef, contextElement); // Re-render the list
  1371.  
  1372.             // Clear inputs if not in edit mode (or if edit was just completed for a different list)
  1373.             if (!_editingItemInfo || _editingItemInfo.listId !== listId) {
  1374.                 if (textInput) { textInput.value = ''; _clearInputError(textInput); textInput.focus(); }
  1375.                 if (valueInput) { valueInput.value = ''; _clearInputError(valueInput); }
  1376.             }
  1377.         }
  1378.  
  1379.  
  1380.         // --- Drag and Drop for Modal Lists ---
  1381.         function _getDragAfterModalListItem(container, y) {
  1382.             const draggableElements = [...container.querySelectorAll(`li[draggable="true"]:not(.${CSS.DRAGGING_ITEM})`)];
  1383.             return draggableElements.reduce((closest, child) => {
  1384.                 const box = child.getBoundingClientRect();
  1385.                 const offset = y - box.top - box.height / 2;
  1386.                 if (offset < 0 && offset > closest.offset) {
  1387.                     return { offset: offset, element: child };
  1388.                 } else {
  1389.                     return closest;
  1390.                 }
  1391.             }, { offset: Number.NEGATIVE_INFINITY }).element;
  1392.         }
  1393.  
  1394.         function _handleModalListDragStart(event) {
  1395.             if (!event.target.matches('li[draggable="true"]')) return;
  1396.             _draggedListItem = event.target;
  1397.             event.dataTransfer.effectAllowed = 'move';
  1398.             event.dataTransfer.setData('text/plain', _draggedListItem.dataset.index); // Store original index
  1399.             _draggedListItem.classList.add(CSS.DRAGGING_ITEM);
  1400.  
  1401.             // Disable pointer events on other items to prevent interference during dragover
  1402.             const list = _draggedListItem.closest('ul');
  1403.             if (list) { list.querySelectorAll('li:not(.gscs-dragging-item)').forEach(li => li.style.pointerEvents = 'none'); }
  1404.         }
  1405.  
  1406.         function _handleModalListDragOver(event) {
  1407.             event.preventDefault(); // Necessary to allow drop
  1408.             const listElement = event.currentTarget; // The UL element
  1409.             // Clear previous highlights
  1410.             listElement.querySelectorAll(`li.${CSS.DRAG_OVER_HIGHLIGHT}`).forEach(li => li.classList.remove(CSS.DRAG_OVER_HIGHLIGHT));
  1411.  
  1412.             const targetItem = event.target.closest('li[draggable="true"]');
  1413.             if (targetItem && targetItem !== _draggedListItem) {
  1414.                 targetItem.classList.add(CSS.DRAG_OVER_HIGHLIGHT); // Highlight item being dragged over
  1415.             } else {
  1416.                 // If not directly over an item, find where it would be inserted
  1417.                 const afterElement = _getDragAfterModalListItem(listElement, event.clientY);
  1418.                 if (afterElement) {
  1419.                     afterElement.classList.add(CSS.DRAG_OVER_HIGHLIGHT); // Highlight element it would go before
  1420.                 }
  1421.             }
  1422.         }
  1423.         function _handleModalListDragLeave(event) {
  1424.             const listElement = event.currentTarget;
  1425.             // Only remove highlight if leaving the list container itself, not just moving between items
  1426.             if (event.relatedTarget && listElement.contains(event.relatedTarget)) return;
  1427.             listElement.querySelectorAll(`li.${CSS.DRAG_OVER_HIGHLIGHT}`).forEach(li => li.classList.remove(CSS.DRAG_OVER_HIGHLIGHT));
  1428.         }
  1429.  
  1430.  
  1431.         function _handleModalListDrop(event, listId, itemsArrayRef) {
  1432.             event.preventDefault();
  1433.             if (!_draggedListItem) return;
  1434.  
  1435.             const draggedIndexOriginal = parseInt(event.dataTransfer.getData('text/plain'), 10);
  1436.             if (isNaN(draggedIndexOriginal) || draggedIndexOriginal < 0 || draggedIndexOriginal >= itemsArrayRef.length) {
  1437.                 _handleModalListDragEnd(event.currentTarget); // Pass the list element
  1438.                 return;
  1439.             }
  1440.  
  1441.             const listElement = event.currentTarget; // The UL
  1442.             const mapping = getListMapping(listId);
  1443.             if (!mapping) { _handleModalListDragEnd(listElement); return; }
  1444.  
  1445.  
  1446.             const draggedItemData = itemsArrayRef[draggedIndexOriginal]; // Get the actual data object
  1447.             if (!draggedItemData) { _handleModalListDragEnd(listElement); return; }
  1448.  
  1449.  
  1450.             // Create a new array without the dragged item to calculate new position correctly
  1451.             const itemsWithoutDragged = itemsArrayRef.filter((item, index) => index !== draggedIndexOriginal);
  1452.  
  1453.             const afterElement = _getDragAfterModalListItem(listElement, event.clientY);
  1454.             let newIndexInSplicedArray;
  1455.  
  1456.             if (afterElement) {
  1457.                 const originalIndexOfAfterElement = parseInt(afterElement.dataset.index, 10);
  1458.                 // Find the index of 'afterElement' in the 'itemsWithoutDragged' array
  1459.                 let countSkipped = 0; newIndexInSplicedArray = -1;
  1460.                 for(let i=0; i < itemsArrayRef.length; i++) {
  1461.                     if (i === draggedIndexOriginal) continue; // Skip the one we are dragging
  1462.                     if (i === originalIndexOfAfterElement) {
  1463.                         newIndexInSplicedArray = countSkipped;
  1464.                         break;
  1465.                     }
  1466.                     countSkipped++;
  1467.                 }
  1468.                  // If afterElement was the last visible item and dragged item was before it
  1469.                  if (newIndexInSplicedArray === -1 && originalIndexOfAfterElement === itemsArrayRef.length -1 && draggedIndexOriginal < originalIndexOfAfterElement) {
  1470.                     newIndexInSplicedArray = itemsWithoutDragged.length;
  1471.                 } else if (newIndexInSplicedArray === -1) { // Fallback: if not found (e.g. dragging to end)
  1472.                     newIndexInSplicedArray = itemsWithoutDragged.length;
  1473.                 }
  1474.  
  1475.             } else {
  1476.                 // Dropped at the end of the list
  1477.                 newIndexInSplicedArray = itemsWithoutDragged.length;
  1478.             }
  1479.  
  1480.             // Insert the dragged item data into the new position in the temporary array
  1481.             itemsWithoutDragged.splice(newIndexInSplicedArray, 0, draggedItemData);
  1482.  
  1483.             // Update the original itemsArrayRef with the new order
  1484.             itemsArrayRef.length = 0; // Clear original array
  1485.             itemsWithoutDragged.forEach(item => itemsArrayRef.push(item)); // Push items in new order
  1486.  
  1487.             _handleModalListDragEnd(listElement); // Cleanup drag styles
  1488.             mapping.populateFn(listId, itemsArrayRef, _currentModalContent); // Re-render the list
  1489.  
  1490.             // Update dataset.index on all li elements after re-rendering
  1491.             const newLiElements = listElement.querySelectorAll('li');
  1492.             newLiElements.forEach((li, idx) => {
  1493.                 li.dataset.index = idx;
  1494.             });
  1495.         }
  1496.  
  1497.  
  1498.         function _handleModalListDragEnd(listElement) { // listElement is the UL
  1499.             if (_draggedListItem) {
  1500.                 _draggedListItem.classList.remove(CSS.DRAGGING_ITEM);
  1501.             }
  1502.             _draggedListItem = null;
  1503.             (listElement || _currentModalContent)?.querySelectorAll(`li.${CSS.DRAG_OVER_HIGHLIGHT}`).forEach(li => li.classList.remove(CSS.DRAG_OVER_HIGHLIGHT));
  1504.              // Re-enable pointer events on list items
  1505.              _currentModalContent?.querySelectorAll('ul.custom-list li[draggable="true"]').forEach(li => li.style.pointerEvents = '');
  1506.         }
  1507.  
  1508.  
  1509.         function _addPredefinedItemsToModalList(selectedValues, predefinedSourceKey, displayItemsArrayRef, listIdToUpdate, modalContentContext) {
  1510.             const mapping = getListMapping(listIdToUpdate);
  1511.             if (!mapping) return;
  1512.  
  1513.             selectedValues.forEach(value => {
  1514.                 const predefinedOpt = PREDEFINED_OPTIONS[predefinedSourceKey]?.find(p => p.value === value);
  1515.                 if (predefinedOpt && !displayItemsArrayRef.some(item => item.value === value && item.type === 'predefined')) {
  1516.                     displayItemsArrayRef.push({
  1517.                         id: predefinedOpt.value, // Use value as ID for predefined
  1518.                         text: _(predefinedOpt.textKey), // Store original text key for re-translation if lang changes
  1519.                         value: predefinedOpt.value,
  1520.                         type: 'predefined',
  1521.                         originalKey: predefinedOpt.textKey // Store the key
  1522.                     });
  1523.                 }
  1524.             });
  1525.             // No sort here, rely on user to sort if needed, or initial sort if it's a mixed list.
  1526.             // Or, sort them by their translated text if that's desired for newly added ones.
  1527.             // For now, just append.
  1528.             mapping.populateFn(listIdToUpdate, displayItemsArrayRef, modalContentContext);
  1529.         }
  1530.  
  1531.         // Binds events to the content within the modal
  1532.         function _bindModalContentEventsInternal(modalContent, itemsArrayRef, listIdForDragDrop = null) {
  1533.             if (!modalContent) return;
  1534.  
  1535.             // Prevent re-binding if already bound for this specific list setup
  1536.             if (modalContent.dataset.modalEventsBound === 'true' && listIdForDragDrop === modalContent.dataset.boundListId) return;
  1537.  
  1538.  
  1539.             // General click listener for the modal body (delegated)
  1540.             modalContent.addEventListener('click', (event) => {
  1541.                 const target = event.target;
  1542.                 // Determine which list this action pertains to (can be complex if multiple lists in one modal, but not current design)
  1543.                 let listIdForAction = listIdForDragDrop || target.closest('[data-list-id]')?.dataset.listId || target.closest(`.${CSS.ADD_CUSTOM_BUTTON}`)?.dataset.listId;
  1544.  
  1545.                 const addNewOptionButton = target.closest(`#${IDS.MODAL_ADD_NEW_OPTION_BTN}`);
  1546.                 if (addNewOptionButton && listIdForAction) {
  1547.                     // This button is for mixed lists (Lang/Country) to add predefined or custom items
  1548.                     const mapping = getListMapping(listIdForAction);
  1549.                     const configForModal = modalConfigsData[Object.keys(modalConfigsData).find(key => modalConfigsData[key].listId === listIdForAction)];
  1550.  
  1551.                     if (mapping && configForModal && configForModal.predefinedSourceKey && configForModal.isSortableMixed) {
  1552.                          PredefinedOptionChooser.show(
  1553.                             configForModal.manageType,
  1554.                             listIdForAction,
  1555.                             configForModal.predefinedSourceKey,
  1556.                             itemsArrayRef, // Pass the live array
  1557.                             modalContent,
  1558.                             _addPredefinedItemsToModalList
  1559.                         );
  1560.                     } else if (mapping) { // If not a mixed list with predefined chooser, just focus input
  1561.                          const textInput = modalContent.querySelector(mapping.textInput);
  1562.                          textInput?.focus();
  1563.                     }
  1564.                     return; // Handled
  1565.                 }
  1566.  
  1567.  
  1568.                 const addButton = target.closest(`.${CSS.ADD_CUSTOM_BUTTON}.custom-list-action-button`);
  1569.                 const itemControlButton = target.closest(`button.${CSS.EDIT_CUSTOM_ITEM}, button.${CSS.DELETE_CUSTOM_ITEM}, button.${CSS.REMOVE_FROM_LIST_BTN}`);
  1570.                 const cancelEditButton = target.closest('.cancel-edit-button');
  1571.  
  1572.                 if (itemControlButton && listIdForAction) { _handleCustomListActionsInternal(event, modalContent, itemsArrayRef); return; }
  1573.                 if (addButton && listIdForAction) { _handleCustomItemSubmitInternal(listIdForAction, modalContent, itemsArrayRef); return; }
  1574.                 if (cancelEditButton) { _resetEditStateInternal(modalContent); return; }
  1575.             });
  1576.             modalContent.dataset.modalEventsBound = 'true';
  1577.             modalContent.dataset.boundListId = listIdForDragDrop; // Store which list drag events are bound to
  1578.  
  1579.  
  1580.             // Input validation listener
  1581.             modalContent.addEventListener('input', (event) => {
  1582.                 const target = event.target;
  1583.                 // Validate relevant input fields on input
  1584.                 if (target.matches(`#${IDS.NEW_SITE_NAME}, #${IDS.NEW_SITE_URL}, #${IDS.NEW_LANG_TEXT}, #${IDS.NEW_LANG_VALUE}, #${IDS.NEW_TIME_TEXT}, #${IDS.NEW_TIME_VALUE}, #${IDS.NEW_FT_TEXT}, #${IDS.NEW_FT_VALUE}, #${IDS.NEW_COUNTRY_TEXT}, #${IDS.NEW_COUNTRY_VALUE}`)) {
  1585.                     _clearInputError(target); // Clear previous error first
  1586.                     validateCustomInput(target);
  1587.                 }
  1588.             });
  1589.  
  1590.             // Bind drag-and-drop listeners if a specific listId is provided for it
  1591.             if (listIdForDragDrop) {
  1592.                 const draggableListElement = modalContent.querySelector(`#${listIdForDragDrop}`);
  1593.                 if (draggableListElement) {
  1594.                     if (draggableListElement.dataset.dragEventsBound !== 'true') { // Prevent multiple bindings
  1595.                         draggableListElement.dataset.dragEventsBound = 'true';
  1596.                         draggableListElement.addEventListener('dragstart', _handleModalListDragStart);
  1597.                         draggableListElement.addEventListener('dragover', _handleModalListDragOver);
  1598.                         draggableListElement.addEventListener('dragleave', _handleModalListDragLeave);
  1599.                         draggableListElement.addEventListener('drop', (event) => _handleModalListDrop(event, listIdForDragDrop, itemsArrayRef));
  1600.                         draggableListElement.addEventListener('dragend', (event) => _handleModalListDragEnd(draggableListElement));
  1601.                     }
  1602.                 }
  1603.             }
  1604.         }
  1605.  
  1606.         return {
  1607.             show: function(titleKey, contentHTML, onCompleteCallback, currentTheme) {
  1608.                 this.hide(); // Hide any existing modal
  1609.  
  1610.                 _currentModal = document.createElement('div');
  1611.                 _currentModal.className = 'settings-modal-overlay';
  1612.                 applyThemeToElement(_currentModal, currentTheme); // Apply theme to overlay
  1613.  
  1614.                 _currentModalContent = document.createElement('div');
  1615.                 _currentModalContent.className = 'settings-modal-content';
  1616.                 applyThemeToElement(_currentModalContent, currentTheme); // Apply theme to content
  1617.  
  1618.                 const header = document.createElement('div');
  1619.                 header.className = 'settings-modal-header';
  1620.                 header.innerHTML = `<h4>${_(titleKey)}</h4><button class="settings-modal-close-btn" title="${_('settings_close_button_title')}">${SVG_ICONS.close}</button>`;
  1621.  
  1622.                 const body = document.createElement('div');
  1623.                 body.className = 'settings-modal-body';
  1624.                 body.innerHTML = contentHTML;
  1625.  
  1626.                 const footer = document.createElement('div');
  1627.                 footer.className = 'settings-modal-footer';
  1628.                 footer.innerHTML = `<button class="modal-complete-btn">${_('modal_button_complete')}</button>`;
  1629.  
  1630.                 _currentModalContent.appendChild(header);
  1631.                 _currentModalContent.appendChild(body);
  1632.                 _currentModalContent.appendChild(footer);
  1633.                 _currentModal.appendChild(_currentModalContent);
  1634.  
  1635.                 // Event listeners for closing
  1636.                 let closeModalHandlerInstance = null; // To store the event handler for removal
  1637.                 let completeModalHandlerInstance = null;
  1638.                 const self = this; // For context in handlers
  1639.  
  1640.                 closeModalHandlerInstance = (event) => {
  1641.                     // Close if clicking overlay directly or the close button
  1642.                     if (event.target === _currentModal || event.target.closest('.settings-modal-close-btn')) {
  1643.                         self.hide(true); // true for cancel
  1644.                         // Clean up listeners to prevent memory leaks
  1645.                         _currentModal?.removeEventListener('click', closeModalHandlerInstance, true); // Use capture for overlay click
  1646.                         header.querySelector('.settings-modal-close-btn')?.removeEventListener('click', closeModalHandlerInstance);
  1647.                         footer.querySelector('.modal-complete-btn')?.removeEventListener('click', completeModalHandlerInstance);
  1648.                     }
  1649.                 };
  1650.                 completeModalHandlerInstance = () => {
  1651.                     if (onCompleteCallback && typeof onCompleteCallback === 'function') {
  1652.                         onCompleteCallback(_currentModalContent); // Pass content for data extraction
  1653.                     }
  1654.                      // Clean up listeners
  1655.                     _currentModal?.removeEventListener('click', closeModalHandlerInstance, true);
  1656.                     header.querySelector('.settings-modal-close-btn')?.removeEventListener('click', closeModalHandlerInstance);
  1657.                     footer.querySelector('.modal-complete-btn')?.removeEventListener('click', completeModalHandlerInstance);
  1658.                     self.hide(false); // false for complete
  1659.                 };
  1660.  
  1661.                 _currentModal.addEventListener('click', closeModalHandlerInstance, true); // Overlay click (capture phase)
  1662.                 header.querySelector('.settings-modal-close-btn').addEventListener('click', closeModalHandlerInstance);
  1663.                 footer.querySelector('.modal-complete-btn').addEventListener('click', completeModalHandlerInstance);
  1664.  
  1665.                 // Prevent clicks inside the modal content from closing it via overlay click
  1666.                 _currentModalContent.addEventListener('click', (event) => event.stopPropagation());
  1667.  
  1668.                 document.body.appendChild(_currentModal);
  1669.                 return _currentModalContent; // Return the content div for further population/binding
  1670.             },
  1671.             hide: function(isCancel = false) {
  1672.                 PredefinedOptionChooser.hide(); // Ensure chooser is also hidden
  1673.                 if (_currentModal) {
  1674.                     // Clear any specific states tied to the modal content before removing
  1675.                     const inputGroup = _currentModalContent?.querySelector(`.${CSS.CUSTOM_LIST_INPUT_GROUP}`);
  1676.                     if (inputGroup) _clearAllInputErrorsInGroup(inputGroup);
  1677.                     _resetEditStateInternal(); // Clear editing state
  1678.  
  1679.                     _currentModal.remove(); // Remove from DOM
  1680.                 }
  1681.                 _currentModal = null;
  1682.                 _currentModalContent = null;
  1683.                 _handleModalListDragEnd(); // Clean up general drag state if any
  1684.             },
  1685.             openManageCustomOptions: function(manageType, currentSettingsRef, PREDEFINED_OPTIONS_REF, onModalCompleteCallback) {
  1686.                 const config = modalConfigsData[manageType];
  1687.                 if (!config) { console.error("Error: Could not get config for manageType:", manageType); return; }
  1688.  
  1689.                 const mapping = getListMapping(config.listId); // For input IDs etc.
  1690.                 if (!mapping) { console.error("Error: Could not get mapping for listId:", config.listId); return; }
  1691.  
  1692.                 // Create a deep copy of the items to be managed in the modal, so direct modifications
  1693.                 // don't affect the main settings until "Done" is clicked.
  1694.                 const tempItems = JSON.parse(JSON.stringify(currentSettingsRef[config.itemsArrayKey] || []));
  1695.                 let contentHTML = '';
  1696.                 const itemTypeNameForDisplay = _(mapping.nameKey); // e.g., "Languages", "Favorite Sites"
  1697.  
  1698.                 if (config.isSortableMixed) { // For Language, Country
  1699.                     contentHTML += _createModalListAndInputHTML(config.listId, config.textPKey, config.valPKey, config.hintKey, config.fmtKey, itemTypeNameForDisplay, true);
  1700.                 } else if (config.hasPredefinedToggles && config.predefinedSourceKey && PREDEFINED_OPTIONS_REF[config.predefinedSourceKey]) {
  1701.                     // For Time, Filetype - which have a list of predefined checkboxes AND a custom list
  1702.                     const enabledValues = new Set(currentSettingsRef.enabledPredefinedOptions[config.predefinedSourceKey] || []);
  1703.                     contentHTML += _createPredefinedOptionsSectionHTML(config.predefinedSourceKey, mapping.nameKey, PREDEFINED_OPTIONS_REF, enabledValues);
  1704.                     contentHTML += '<hr style="margin: 1em 0;">'; // Separator
  1705.                     contentHTML += _createModalListAndInputHTML(config.listId, config.textPKey, config.valPKey, config.hintKey, config.fmtKey, itemTypeNameForDisplay, false);
  1706.                 } else { // For Sites (no predefined toggles, only custom list)
  1707.                     contentHTML += _createModalListAndInputHTML(config.listId, config.textPKey, config.valPKey, config.hintKey, config.fmtKey, itemTypeNameForDisplay, false);
  1708.                 }
  1709.  
  1710.                 const modalContentElement = this.show(
  1711.                     config.modalTitleKey,
  1712.                     contentHTML,
  1713.                     (modalContent) => { // onCompleteCallback
  1714.                         let newEnabledPredefs = null;
  1715.                         if (config.hasPredefinedToggles && config.predefinedSourceKey) {
  1716.                             newEnabledPredefs = [];
  1717.                             modalContent.querySelectorAll(`.predefined-options-list input[data-option-type="${config.predefinedSourceKey}"]:checked`).forEach(cb => newEnabledPredefs.push(cb.value));
  1718.                         }
  1719.                         onModalCompleteCallback(tempItems, newEnabledPredefs, config.itemsArrayKey, config.predefinedSourceKey, config.customItemsMasterKey, config.isSortableMixed, manageType);
  1720.                     },
  1721.                     currentSettingsRef.theme // Pass current theme for modal styling
  1722.                 );
  1723.  
  1724.                 // Populate the list within the modal and bind events
  1725.                 if (modalContentElement) {
  1726.                     if (mapping && mapping.populateFn) {
  1727.                         mapping.populateFn(config.listId, tempItems, modalContentElement);
  1728.                     }
  1729.                     _bindModalContentEventsInternal(modalContentElement, tempItems, config.listId); // Pass tempItems for direct modification
  1730.                 }
  1731.             },
  1732.             resetEditStateGlobally: function() { _resetEditStateInternal(_currentModalContent || document); },
  1733.             isModalOpen: function() { return !!_currentModal; }
  1734.         };
  1735.     })();
  1736.  
  1737.     const SettingsUIPaneGenerator = (function() {
  1738.         function createGeneralPaneHTML() {
  1739.             let langOpts = LocalizationService.getAvailableLocales().map(lc => {
  1740.                 let dn;
  1741.                 if (lc === 'auto') dn = _('settings_language_auto');
  1742.                 else { try { dn = new Intl.DisplayNames([lc],{type:'language'}).of(lc); dn = dn.charAt(0).toUpperCase() + dn.slice(1); } catch(e){ dn = lc; } dn = `${dn} (${lc})`; }
  1743.                 return `<option value="${lc}">${dn}</option>`;
  1744.             }).join('');
  1745.             const accordionHintHTML = `<div class="${CSS.SETTING_VALUE_HINT}" style="margin-top:0.3em; margin-left:1.7em; font-weight:normal;">${_('settings_accordion_mode_hint_desc')}</div>`;
  1746.             const locationOptionsHTML = `
  1747.                 <option value="tools">${_('settings_location_tools')}</option>
  1748.                 <option value="topBlock">${_('settings_location_top')}</option>
  1749.                 <option value="header">${_('settings_location_header')}</option>
  1750.                 <option value="none">${_('settings_location_hide')}</option>`;
  1751.  
  1752.             return `<div class="${CSS.SETTING_ITEM}"><label for="${IDS.SETTING_INTERFACE_LANGUAGE}">${_('settings_interface_language')}</label><select id="${IDS.SETTING_INTERFACE_LANGUAGE}">${langOpts}</select></div>` +
  1753.                    `<div class="${CSS.SETTING_ITEM}"><label for="${IDS.SETTING_SECTION_MODE}">${_('settings_section_mode')}</label><select id="${IDS.SETTING_SECTION_MODE}"><option value="remember">${_('settings_section_mode_remember')}</option><option value="expandAll">${_('settings_section_mode_expand')}</option><option value="collapseAll">${_('settings_section_mode_collapse')}</option></select><div style="margin-top:0.6em;"><input type="checkbox" id="${IDS.SETTING_ACCORDION}"><label for="${IDS.SETTING_ACCORDION}" class="${CSS.INLINE_LABEL}">${_('settings_accordion_mode')}</label>${accordionHintHTML}</div></div>` +
  1754.                    `<div class="${CSS.SETTING_ITEM}"><input type="checkbox" id="${IDS.SETTING_DRAGGABLE}"><label for="${IDS.SETTING_DRAGGABLE}" class="${CSS.INLINE_LABEL}">${_('settings_enable_drag')}</label></div>` +
  1755.                    `<div class="${CSS.SETTING_ITEM}"><label for="${IDS.SETTING_RESET_LOCATION}">${_('settings_reset_button_location')}</label><select id="${IDS.SETTING_RESET_LOCATION}">${locationOptionsHTML}</select></div>` +
  1756.                    `<div class="${CSS.SETTING_ITEM}"><label for="${IDS.SETTING_VERBATIM_LOCATION}">${_('settings_verbatim_button_location')}</label><select id="${IDS.SETTING_VERBATIM_LOCATION}">${locationOptionsHTML}</select></div>` +
  1757.                    `<div class="${CSS.SETTING_ITEM}"><label for="${IDS.SETTING_ADV_SEARCH_LOCATION}">${_('settings_adv_search_location')}</label><select id="${IDS.SETTING_ADV_SEARCH_LOCATION}">${locationOptionsHTML}</select></div>`+
  1758.                    `<div class="${CSS.SETTING_ITEM}"><label for="${IDS.SETTING_PERSONALIZE_LOCATION}">${_('settings_personalize_button_location')}</label><select id="${IDS.SETTING_PERSONALIZE_LOCATION}">${locationOptionsHTML}</select></div>` +
  1759.                    `<div class="${CSS.SETTING_ITEM}"><label for="${IDS.SETTING_SCHOLAR_LOCATION}">${_('settings_scholar_location')}</label><select id="${IDS.SETTING_SCHOLAR_LOCATION}">${locationOptionsHTML}</select></div>` +
  1760.                    `<div class="${CSS.SETTING_ITEM}"><label for="${IDS.SETTING_TRENDS_LOCATION}">${_('settings_trends_location')}</label><select id="${IDS.SETTING_TRENDS_LOCATION}">${locationOptionsHTML}</select></div>` +
  1761.                    `<div class="${CSS.SETTING_ITEM}"><label for="${IDS.SETTING_DATASET_SEARCH_LOCATION}">${_('settings_dataset_search_location')}</label><select id="${IDS.SETTING_DATASET_SEARCH_LOCATION}">${locationOptionsHTML}</select></div>`;
  1762.         }
  1763.         function createAppearancePaneHTML() {
  1764.             // New HTML for hideGoogleLogo setting
  1765.             const hideLogoSettingHTML =
  1766.                 `<div class="${CSS.SETTING_ITEM}">` +
  1767.                 `<input type="checkbox" id="${IDS.SETTING_HIDE_GOOGLE_LOGO}"><label for="${IDS.SETTING_HIDE_GOOGLE_LOGO}" class="${CSS.INLINE_LABEL}">${_('settings_hide_google_logo')}</label>` +
  1768.                 `<div class="${CSS.SETTING_VALUE_HINT}" style="margin-top:0.3em; margin-left:1.7em; font-weight:normal;">${_('settings_hide_google_logo_hint')}</div>` +
  1769.                 `</div>`;
  1770.  
  1771.             return `<div class="${CSS.SETTING_ITEM}"><label for="${IDS.SETTING_WIDTH}">${_('settings_sidebar_width')}</label><span class="${CSS.RANGE_HINT}">${_('settings_width_range_hint')}</span><input type="range" id="${IDS.SETTING_WIDTH}" min="90" max="270" step="5"><span class="${CSS.RANGE_VALUE}"></span></div>` +
  1772.                    `<div class="${CSS.SETTING_ITEM}"><label for="${IDS.SETTING_FONT_SIZE}">${_('settings_font_size')}</label><span class="${CSS.RANGE_HINT}">${_('settings_font_size_range_hint')}</span><input type="range" id="${IDS.SETTING_FONT_SIZE}" min="8" max="24" step="0.5"><span class="${CSS.RANGE_VALUE}"></span></div>` +
  1773.                    `<div class="${CSS.SETTING_ITEM}"><label for="${IDS.SETTING_HEADER_ICON_SIZE}">${_('settings_header_icon_size')}</label><span class="${CSS.RANGE_HINT}">${_('settings_header_icon_size_range_hint')}</span><input type="range" id="${IDS.SETTING_HEADER_ICON_SIZE}" min="8" max="32" step="0.5"><span class="${CSS.RANGE_VALUE}"></span></div>` +
  1774.                    `<div class="${CSS.SETTING_ITEM}"><label for="${IDS.SETTING_VERTICAL_SPACING}">${_('settings_vertical_spacing')}</label><span class="${CSS.RANGE_HINT}">${_('settings_vertical_spacing_range_hint')}</span><input type="range" id="${IDS.SETTING_VERTICAL_SPACING}" min="0.05" max="1.5" step="0.05"><span class="${CSS.RANGE_VALUE}"></span></div>` +
  1775.                    `<div class="${CSS.SETTING_ITEM}"><label for="${IDS.SETTING_THEME}">${_('settings_theme')}</label><select id="${IDS.SETTING_THEME}"><option value="system">${_('settings_theme_system')}</option><option value="light">${_('settings_theme_light')}</option><option value="dark">${_('settings_theme_dark')}</option><option value="minimal-light">${_('settings_theme_minimal_light')}</option><option value="minimal-dark">${_('settings_theme_minimal_dark')}</option></select></div><div class="${CSS.SETTING_ITEM}"><input type="checkbox" id="${IDS.SETTING_HOVER}"><label for="${IDS.SETTING_HOVER}" class="${CSS.INLINE_LABEL}">${_('settings_hover_mode')}</label><div style="margin-top:0.8em;padding-left:1.5em;"><label for="${IDS.SETTING_OPACITY}" style="display:block;margin-bottom:0.4em;font-weight:normal;">${_('settings_idle_opacity')}</label><span class="${CSS.RANGE_HINT}" style="width:auto;display:inline-block;margin-right:1em;">${_('settings_opacity_range_hint')}</span><input type="range" id="${IDS.SETTING_OPACITY}" min="0.1" max="1.0" step="0.05" style="width:calc(100% - 18em);vertical-align:middle;display:inline-block;"><span class="${CSS.RANGE_VALUE}" style="display:inline-block;min-width:3em;text-align:right;vertical-align:middle;"></span></div></div><div class="${CSS.SETTING_ITEM}"><label for="${IDS.SETTING_COUNTRY_DISPLAY_MODE}">${_('settings_country_display')}</label><select id="${IDS.SETTING_COUNTRY_DISPLAY_MODE}"><option value="iconAndText">${_('settings_country_display_icontext')}</option><option value="textOnly">${_('settings_country_display_text')}</option><option value="iconOnly">${_('settings_country_display_icon')}</option></select></div>` +
  1776.                    hideLogoSettingHTML;
  1777.         }
  1778.         function createFeaturesPaneHTML() {
  1779.             const visItemsHTML = ALL_SECTION_DEFINITIONS.map(def=>{ const dn=_(def.titleKey)||def.id; return `<div class="${CSS.SETTING_ITEM} ${CSS.SIMPLE_ITEM}"><input type="checkbox" id="setting-visible-${def.id}" data-${DATA_ATTR.SECTION_ID}="${def.id}"><label for="setting-visible-${def.id}" class="${CSS.INLINE_LABEL}">${dn}</label></div>`; }).join('');
  1780.             const siteSearchCheckboxModeHTML =
  1781.                 `<div class="${CSS.SETTING_ITEM}">` +
  1782.                 `<input type="checkbox" id="${IDS.SETTING_SITE_SEARCH_CHECKBOX_MODE}"><label for="${IDS.SETTING_SITE_SEARCH_CHECKBOX_MODE}" class="${CSS.INLINE_LABEL}">${_('settings_enable_site_search_checkbox_mode')}</label>` +
  1783.                 `<div class="${CSS.SETTING_VALUE_HINT}" style="margin-top:0.3em; margin-left:1.7em; font-weight:normal;">${_('settings_enable_site_search_checkbox_mode_hint')}</div>` +
  1784.                 `</div>`;
  1785.             const showFaviconsHTML =
  1786.                 `<div class="${CSS.SETTING_ITEM}">` + // Indent this setting
  1787.                 `<input type="checkbox" id="${IDS.SETTING_SHOW_FAVICONS}"><label for="${IDS.SETTING_SHOW_FAVICONS}" class="${CSS.INLINE_LABEL}">${_('settings_show_favicons')}</label>` +
  1788.                 `<div class="${CSS.SETTING_VALUE_HINT}" style="margin-top:0.3em; margin-left:1.7em; font-weight:normal;">${_('settings_show_favicons_hint')}</div>` +
  1789.                 `</div>`;
  1790.             const filetypeSearchCheckboxModeHTML =
  1791.                 `<div class="${CSS.SETTING_ITEM}">` +
  1792.                 `<input type="checkbox" id="${IDS.SETTING_FILETYPE_SEARCH_CHECKBOX_MODE}"><label for="${IDS.SETTING_FILETYPE_SEARCH_CHECKBOX_MODE}" class="${CSS.INLINE_LABEL}">${_('settings_enable_filetype_search_checkbox_mode')}</label>` +
  1793.                 `<div class="${CSS.SETTING_VALUE_HINT}" style="margin-top:0.3em; margin-left:1.7em; font-weight:normal;">${_('settings_enable_filetype_search_checkbox_mode_hint')}</div>` +
  1794.                 `</div>`;
  1795.             return `<p>${_('settings_visible_sections')}</p>${visItemsHTML}` +
  1796.                    `${siteSearchCheckboxModeHTML}${showFaviconsHTML}${filetypeSearchCheckboxModeHTML}<hr style="margin:1.2em 0;">` +
  1797.                    `<p style="font-weight:bold;margin-bottom:0.5em;">${_('settings_section_order')}</p><p class="${CSS.SETTING_VALUE_HINT}" style="font-size:0.9em;margin-top:-0.3em;margin-bottom:0.7em;">${_('settings_section_order_hint')}</p><ul id="${IDS.SIDEBAR_SECTION_ORDER_LIST}" class="${CSS.SECTION_ORDER_LIST}"></ul>`;
  1798.         }
  1799.         function createCustomPaneHTML() {
  1800.             return `<div class="${CSS.SETTING_ITEM}"><p>${_('settings_custom_intro')}</p><button class="${CSS.MANAGE_CUSTOM_BUTTON}" data-${DATA_ATTR.MANAGE_TYPE}="site">${_('settings_manage_sites_button')}</button></div><div class="${CSS.SETTING_ITEM}"><button class="${CSS.MANAGE_CUSTOM_BUTTON}" data-${DATA_ATTR.MANAGE_TYPE}="language">${_('settings_manage_languages_button')}</button></div><div class="${CSS.SETTING_ITEM}"><button class="${CSS.MANAGE_CUSTOM_BUTTON}" data-${DATA_ATTR.MANAGE_TYPE}="country">${_('settings_manage_countries_button')}</button></div><div class="${CSS.SETTING_ITEM}"><button class="${CSS.MANAGE_CUSTOM_BUTTON}" data-${DATA_ATTR.MANAGE_TYPE}="time">${_('settings_manage_time_ranges_button')}</button></div><div class="${CSS.SETTING_ITEM}"><button class="${CSS.MANAGE_CUSTOM_BUTTON}" data-${DATA_ATTR.MANAGE_TYPE}="filetype">${_('settings_manage_file_types_button')}</button></div>`;
  1801.         }
  1802.         return { createGeneralPaneHTML, createAppearancePaneHTML, createFeaturesPaneHTML, createCustomPaneHTML };
  1803.     })();
  1804. 	
  1805.     const SectionOrderDragHandler = (function() {
  1806.         let _draggedItem = null; let _listElement = null; let _settingsRef = null; let _onOrderUpdateCallback = null;
  1807.         function getDragAfterElement(container, y) { const draggableElements = [...container.querySelectorAll(`li[draggable="true"]:not(.${CSS.DRAGGING_ITEM})`)]; return draggableElements.reduce((closest, child) => { const box = child.getBoundingClientRect(); const offset = y - box.top - box.height / 2; if (offset < 0 && offset > closest.offset) { return { offset: offset, element: child }; } else { return closest; } }, { offset: Number.NEGATIVE_INFINITY }).element; }
  1808.         function handleDragStart(event) { _draggedItem = event.target; event.dataTransfer.effectAllowed = 'move'; event.dataTransfer.setData('text/plain', _draggedItem.dataset.sectionId); _draggedItem.classList.add(CSS.DRAGGING_ITEM); if (_listElement) { _listElement.querySelectorAll('li:not(.gscs-dragging-item)').forEach(li => li.style.pointerEvents = 'none'); } }
  1809.         function handleDragOver(event) { event.preventDefault(); if (!_listElement) return; _listElement.querySelectorAll(`li.${CSS.DRAG_OVER_HIGHLIGHT}`).forEach(li => { li.classList.remove(CSS.DRAG_OVER_HIGHLIGHT); }); const targetItem = event.target.closest('li[draggable="true"]'); if (targetItem && targetItem !== _draggedItem) { targetItem.classList.add(CSS.DRAG_OVER_HIGHLIGHT); } else if (!targetItem && _listElement.contains(event.target)) { const afterElement = getDragAfterElement(_listElement, event.clientY); if (afterElement) { afterElement.classList.add(CSS.DRAG_OVER_HIGHLIGHT); } } }
  1810.         function handleDragLeave(event) { const relatedTarget = event.relatedTarget; if (_listElement && (!relatedTarget || !_listElement.contains(relatedTarget))) { _listElement.querySelectorAll(`li.${CSS.DRAG_OVER_HIGHLIGHT}`).forEach(li => { li.classList.remove(CSS.DRAG_OVER_HIGHLIGHT); }); } }
  1811.         function handleDrop(event) {
  1812.             event.preventDefault(); if (!_draggedItem || !_listElement || !_settingsRef || !_onOrderUpdateCallback) return;
  1813.             const draggedSectionId = event.dataTransfer.getData('text/plain');
  1814.             let currentVisibleOrder = _settingsRef.sidebarSectionOrder.filter(id => _settingsRef.visibleSections[id]);
  1815.             const oldIndexInVisible = currentVisibleOrder.indexOf(draggedSectionId);
  1816.             if (oldIndexInVisible > -1) { currentVisibleOrder.splice(oldIndexInVisible, 1); } else { handleDragEnd(); return; } // Should not happen if drag started correctly
  1817.             const afterElement = getDragAfterElement(_listElement, event.clientY);
  1818.             if (afterElement) { const targetId = afterElement.dataset.sectionId; const newIndexInVisible = currentVisibleOrder.indexOf(targetId); if (newIndexInVisible > -1) { currentVisibleOrder.splice(newIndexInVisible, 0, draggedSectionId); } else { currentVisibleOrder.push(draggedSectionId); } // Fallback if targetId not in currentVisibleOrder (should be rare)
  1819.             } else { currentVisibleOrder.push(draggedSectionId); } // Dropped at the end
  1820.             const hiddenSectionOrder = _settingsRef.sidebarSectionOrder.filter(id => !_settingsRef.visibleSections[id]); // Keep hidden sections at the end
  1821.             _settingsRef.sidebarSectionOrder = [...currentVisibleOrder, ...hiddenSectionOrder];
  1822.             handleDragEnd(); _onOrderUpdateCallback();
  1823.         }
  1824.         function handleDragEnd() { if (_draggedItem) { _draggedItem.classList.remove(CSS.DRAGGING_ITEM); } _draggedItem = null; if (_listElement) { _listElement.querySelectorAll('li').forEach(li => { li.classList.remove(CSS.DRAG_OVER_HIGHLIGHT); li.style.pointerEvents = ''; }); } }
  1825.         function initialize(listEl, currentSettings, orderUpdateCallback) { _listElement = listEl; _settingsRef = currentSettings; _onOrderUpdateCallback = orderUpdateCallback; if (_listElement && _listElement.dataset.sectionOrderDragBound !== 'true') { _listElement.addEventListener('dragstart', handleDragStart); _listElement.addEventListener('dragover', handleDragOver); _listElement.addEventListener('dragleave', handleDragLeave); _listElement.addEventListener('drop', handleDrop); _listElement.addEventListener('dragend', handleDragEnd); _listElement.dataset.sectionOrderDragBound = 'true'; } }
  1826.         function destroy() { if (_listElement && _listElement.dataset.sectionOrderDragBound === 'true') { _listElement.removeEventListener('dragstart', handleDragStart); _listElement.removeEventListener('dragover', handleDragOver); _listElement.removeEventListener('dragleave', handleDragLeave); _listElement.removeEventListener('drop', handleDrop); _listElement.removeEventListener('dragend', handleDragEnd); delete _listElement.dataset.sectionOrderDragBound; } _listElement = null; _settingsRef = null; _onOrderUpdateCallback = null; }
  1827.         return { initialize, destroy };
  1828.     })();
  1829.  
  1830.     // SettingsManager - Manages loading, saving, applying settings, and settings UI
  1831.     const SettingsManager = (function() {
  1832.         let _settingsWindow = null; let _settingsOverlay = null; let _currentSettings = {};
  1833.         let _settingsBackup = {}; let _defaultSettingsRef = null; let _isInitialized = false;
  1834.         let _applySettingsToSidebar_cb = ()=>{}; let _buildSidebarUI_cb = ()=>{};
  1835.         let _applySectionCollapseStates_cb = ()=>{}; let _initMenuCommands_cb = ()=>{};
  1836.         let _renderSectionOrderList_ext_cb = ()=>{}; // External callback for rendering order list
  1837.  
  1838.         // Internal helper to populate a slider and its value display
  1839.         function _populateSliderSetting_internal(win,id,value,formatFn=(val)=>val){const i=win.querySelector(`#${id}`);if(i){i.value=value;let vs=i.parentNode.querySelector(`.${CSS.RANGE_VALUE}`);if(vs&&vs.classList.contains(CSS.RANGE_VALUE)){vs.textContent=formatFn(value);}}}
  1840.         // Internal helper to populate general settings tab
  1841.         function _populateGeneralSettings_internal(win,s){ const lS=win.querySelector(`#${IDS.SETTING_INTERFACE_LANGUAGE}`);if(lS)lS.value=s.interfaceLanguage;const sMS=win.querySelector(`#${IDS.SETTING_SECTION_MODE}`),acC=win.querySelector(`#${IDS.SETTING_ACCORDION}`);if(sMS&&acC){sMS.value=s.sectionDisplayMode;const iRM=s.sectionDisplayMode==='remember';acC.disabled=!iRM;acC.checked=iRM?s.accordionMode:false; const accordionHint = acC.parentElement.querySelector(`.${CSS.SETTING_VALUE_HINT}`); if(accordionHint) accordionHint.style.color = iRM ? '' : 'grey';} const dC=win.querySelector(`#${IDS.SETTING_DRAGGABLE}`);if(dC)dC.checked=s.draggableHandleEnabled;const rLS=win.querySelector(`#${IDS.SETTING_RESET_LOCATION}`);if(rLS)rLS.value=s.resetButtonLocation;const vLS=win.querySelector(`#${IDS.SETTING_VERBATIM_LOCATION}`);if(vLS)vLS.value=s.verbatimButtonLocation;const aSLS=win.querySelector(`#${IDS.SETTING_ADV_SEARCH_LOCATION}`);if(aSLS)aSLS.value=s.advancedSearchLinkLocation; const pznLS = win.querySelector(`#${IDS.SETTING_PERSONALIZE_LOCATION}`); if (pznLS) pznLS.value = s.personalizationButtonLocation; const schLS = win.querySelector(`#${IDS.SETTING_SCHOLAR_LOCATION}`); if (schLS) schLS.value = s.googleScholarShortcutLocation; const trnLS = win.querySelector(`#${IDS.SETTING_TRENDS_LOCATION}`); if (trnLS) trnLS.value = s.googleTrendsShortcutLocation; const dsLS = win.querySelector(`#${IDS.SETTING_DATASET_SEARCH_LOCATION}`); if (dsLS) dsLS.value = s.googleDatasetSearchShortcutLocation;}
  1842.         // Internal helper to populate appearance settings tab
  1843.         function _populateAppearanceSettings_internal(win,s){_populateSliderSetting_internal(win,IDS.SETTING_WIDTH,s.sidebarWidth);_populateSliderSetting_internal(win,IDS.SETTING_FONT_SIZE,s.fontSize,v=>parseFloat(v).toFixed(1));_populateSliderSetting_internal(win,IDS.SETTING_HEADER_ICON_SIZE,s.headerIconSize,v=>parseFloat(v).toFixed(1));_populateSliderSetting_internal(win,IDS.SETTING_VERTICAL_SPACING,s.verticalSpacingMultiplier,v=>`x ${parseFloat(v).toFixed(2)}`);_populateSliderSetting_internal(win,IDS.SETTING_OPACITY,s.idleOpacity,v=>parseFloat(v).toFixed(2));const tS=win.querySelector(`#${IDS.SETTING_THEME}`);if(tS)tS.value=s.theme;const cDS=win.querySelector(`#${IDS.SETTING_COUNTRY_DISPLAY_MODE}`);if(cDS)cDS.value=s.countryDisplayMode;const hC=win.querySelector(`#${IDS.SETTING_HOVER}`),oI=win.querySelector(`#${IDS.SETTING_OPACITY}`);if(hC&&oI){hC.checked=s.hoverMode;const iHE=s.hoverMode;oI.disabled=!iHE;const oC=oI.closest('div');if(oC){oC.style.opacity=iHE?'1':'0.6';oC.style.pointerEvents=iHE?'auto':'none';}} const hideLogoCb = win.querySelector(`#${IDS.SETTING_HIDE_GOOGLE_LOGO}`); if (hideLogoCb) hideLogoCb.checked = s.hideGoogleLogoWhenExpanded; }
  1844.         // Internal helper to populate features settings tab
  1845.         function _populateFeatureSettings_internal(win,s,renderFn){win.querySelectorAll(`#${IDS.TAB_PANE_FEATURES} input[type="checkbox"][data-${DATA_ATTR.SECTION_ID}]`)?.forEach(cb=>{const sId=cb.getAttribute(`data-${DATA_ATTR.SECTION_ID}`);if(sId&&s.visibleSections.hasOwnProperty(sId)){cb.checked=s.visibleSections[sId];}else if(sId&&_defaultSettingsRef.visibleSections.hasOwnProperty(sId)){cb.checked=_defaultSettingsRef.visibleSections[sId]??false;}}); const siteSearchCheckboxModeEl = win.querySelector(`#${IDS.SETTING_SITE_SEARCH_CHECKBOX_MODE}`); if(siteSearchCheckboxModeEl) siteSearchCheckboxModeEl.checked = s.enableSiteSearchCheckboxMode; const showFaviconsEl = win.querySelector(`#${IDS.SETTING_SHOW_FAVICONS}`); if(showFaviconsEl) showFaviconsEl.checked = s.showFaviconsForSiteSearch; const filetypeSearchCheckboxModeEl = win.querySelector(`#${IDS.SETTING_FILETYPE_SEARCH_CHECKBOX_MODE}`); if(filetypeSearchCheckboxModeEl) filetypeSearchCheckboxModeEl.checked = s.enableFiletypeCheckboxMode; renderFn(s);}
  1846.         // Internal helper to set the active settings tab
  1847.         function _initializeActiveSettingsTab_internal(){if(!_settingsWindow)return;const tC=_settingsWindow.querySelector(`.${CSS.SETTINGS_TABS}`),cC=_settingsWindow.querySelector(`.${CSS.SETTINGS_TAB_CONTENT}`);if(!tC||!cC)return;const aTB=tC.querySelector(`.${CSS.TAB_BUTTON}.${CSS.ACTIVE}`);const tT=(aTB&&aTB.dataset[DATA_ATTR.TAB])?aTB.dataset[DATA_ATTR.TAB]:'general';tC.querySelectorAll(`.${CSS.TAB_BUTTON}`).forEach(b=>b.classList.toggle(CSS.ACTIVE,b.dataset[DATA_ATTR.TAB]===tT));cC.querySelectorAll(`.${CSS.TAB_PANE}`).forEach(p=>p.classList.toggle(CSS.ACTIVE,p.dataset[DATA_ATTR.TAB]===tT));}
  1848.         // Load settings from GM_storage
  1849.         function _loadFromStorage(){try{const s=GM_getValue(STORAGE_KEY,'{}');return JSON.parse(s||'{}');}catch(e){console.error(`${LOG_PREFIX} Error loading/parsing settings:`,e);return{};}}
  1850.         // Migrate settings from older versions if necessary (specific to displayLanguages/Countries)
  1851.         function _migrateToDisplayArraysIfNecessary(settings) {
  1852.             const displayTypes = [
  1853.                 { displayKey: 'displayLanguages', predefinedKey: 'language', customKey: 'customLanguages', defaultEnabled: defaultSettings.enabledPredefinedOptions.language },
  1854.                 { displayKey: 'displayCountries', predefinedKey: 'country', customKey: 'customCountries', defaultEnabled: defaultSettings.enabledPredefinedOptions.country }
  1855.             ];
  1856.             let migrationPerformed = false;
  1857.             displayTypes.forEach(typeInfo => {
  1858.                 // Check if migration is needed: displayKey array is missing/empty AND there are old-style predefined/custom options
  1859.                 if ((!settings[typeInfo.displayKey] || settings[typeInfo.displayKey].length === 0) &&
  1860.                     (
  1861.                         (settings.enabledPredefinedOptions && settings.enabledPredefinedOptions[typeInfo.predefinedKey]?.length > 0) ||
  1862.                         (settings[typeInfo.customKey] && settings[typeInfo.customKey]?.length > 0)
  1863.                     )
  1864.                 ) {
  1865.                     console.log(`${LOG_PREFIX} Migrating settings for ${typeInfo.displayKey}`);
  1866.                     migrationPerformed = true;
  1867.                     const newDisplayArray = [];
  1868.                     const addedValues = new Set(); // To avoid duplicates if a value exists in both predefined and custom
  1869.  
  1870.                     // 1. Add enabled predefined options first
  1871.                     const enabledPredefined = settings.enabledPredefinedOptions?.[typeInfo.predefinedKey] || typeInfo.defaultEnabled || [];
  1872.                     enabledPredefined.forEach(val => {
  1873.                         const predefinedOpt = PREDEFINED_OPTIONS[typeInfo.predefinedKey]?.find(p => p.value === val);
  1874.                         if (predefinedOpt && !addedValues.has(predefinedOpt.value)) {
  1875.                             newDisplayArray.push({
  1876.                                 id: predefinedOpt.value, // Use value as a unique ID for predefined
  1877.                                 text: _(predefinedOpt.textKey), // Store original text key
  1878.                                 value: predefinedOpt.value,
  1879.                                 type: 'predefined',
  1880.                                 originalKey: predefinedOpt.textKey
  1881.                             });
  1882.                             addedValues.add(predefinedOpt.value);
  1883.                         }
  1884.                     });
  1885.                     // Sort predefined items by their translated text (current locale)
  1886.                     newDisplayArray.sort((a,b) => {
  1887.                         const textA = a.originalKey ? _(a.originalKey) : a.text;
  1888.                         const textB = b.originalKey ? _(b.originalKey) : b.text;
  1889.                         return textA.localeCompare(textB, LocalizationService.getCurrentLocale(), {sensitivity: 'base'})
  1890.                     });
  1891.  
  1892.  
  1893.                     // 2. Add custom options
  1894.                     const customItems = settings[typeInfo.customKey] || [];
  1895.                     customItems.forEach(customOpt => {
  1896.                         if (customOpt.value && !addedValues.has(customOpt.value)) { // Ensure custom value wasn't already added as predefined
  1897.                             newDisplayArray.push({
  1898.                                 id: customOpt.value, // Use value as ID for custom, assume unique among customs
  1899.                                 text: customOpt.text,
  1900.                                 value: customOpt.value,
  1901.                                 type: 'custom'
  1902.                                 // No originalKey for custom items
  1903.                             });
  1904.                             addedValues.add(customOpt.value);
  1905.                         }
  1906.                     });
  1907.                     settings[typeInfo.displayKey] = newDisplayArray;
  1908.                     // Clear old enabledPredefinedOptions for this type as they are now in displayKey
  1909.                     if (settings.enabledPredefinedOptions) {
  1910.                         settings.enabledPredefinedOptions[typeInfo.predefinedKey] = [];
  1911.                     }
  1912.                 } else if (!settings[typeInfo.displayKey]) { // Ensure array exists if no migration needed
  1913.                     settings[typeInfo.displayKey] = JSON.parse(JSON.stringify(defaultSettings[typeInfo.displayKey] || []));
  1914.                 }
  1915.             });
  1916.             if (migrationPerformed) console.log(`${LOG_PREFIX} Migration to display arrays complete.`);
  1917.         }
  1918.         // Validate and merge saved settings with defaults
  1919.         function _validateAndMergeSettings(saved){
  1920.             let newSettings = JSON.parse(JSON.stringify(_defaultSettingsRef)); // Start with a deep copy of defaults
  1921.             newSettings = Utils.mergeDeep(newSettings, saved); // Merge saved settings into the new copy
  1922.  
  1923.             _validateAndMergeCoreSettings_internal(newSettings, saved, _defaultSettingsRef);
  1924.             _validateAndMergeAppearanceSettings_internal(newSettings, saved, _defaultSettingsRef);
  1925.             _validateAndMergeFeatureSettings_internal(newSettings, saved, _defaultSettingsRef);
  1926.             _validateAndMergeCustomLists_internal(newSettings, saved, _defaultSettingsRef);
  1927.  
  1928.             _migrateToDisplayArraysIfNecessary(newSettings); // IMPORTANT: Migrate before validating display arrays
  1929.  
  1930.             // Validate displayLanguages and displayCountries (after potential migration)
  1931.             ['displayLanguages', 'displayCountries'].forEach(displayKey => {
  1932.                 if (!Array.isArray(newSettings[displayKey])) {
  1933.                     newSettings[displayKey] = JSON.parse(JSON.stringify(_defaultSettingsRef[displayKey])) || [];
  1934.                 }
  1935.                 // Filter out invalid items
  1936.                 newSettings[displayKey] = newSettings[displayKey].filter(item =>
  1937.                     item && typeof item.id === 'string' &&
  1938.                     (item.type === 'predefined' ? (typeof item.text === 'string' && typeof item.originalKey === 'string') : typeof item.text === 'string') && // Text is always string, originalKey for predefined
  1939.                     typeof item.value === 'string' &&
  1940.                     (item.type === 'predefined' || item.type === 'custom') // Valid type
  1941.                 );
  1942.             });
  1943.  
  1944.  
  1945.             _validateAndMergePredefinedOptions_internal(newSettings, saved, _defaultSettingsRef); // Validate other predefined options
  1946.             _finalizeSectionOrder_internal(newSettings, saved, _defaultSettingsRef); // Finalize section order
  1947.  
  1948.             return newSettings;
  1949.         }
  1950.         // Sub-validation functions
  1951.         function _validateAndMergeCoreSettings_internal(target,source,defaults){if(typeof target.sidebarPosition!=='object'||target.sidebarPosition===null||Array.isArray(target.sidebarPosition)){target.sidebarPosition=JSON.parse(JSON.stringify(defaults.sidebarPosition));}target.sidebarPosition.left=parseInt(target.sidebarPosition.left,10)||defaults.sidebarPosition.left;target.sidebarPosition.top=parseInt(target.sidebarPosition.top,10)||defaults.sidebarPosition.top;if(typeof target.sectionStates!=='object'||target.sectionStates===null||Array.isArray(target.sectionStates)){target.sectionStates={};}target.sidebarCollapsed=!!target.sidebarCollapsed;target.draggableHandleEnabled=typeof target.draggableHandleEnabled==='boolean'?target.draggableHandleEnabled:defaults.draggableHandleEnabled;target.interfaceLanguage=typeof source.interfaceLanguage==='string'?source.interfaceLanguage:defaults.interfaceLanguage;}
  1952.         function _validateAndMergeAppearanceSettings_internal(target,source,defaults){target.sidebarWidth=Utils.clamp(parseInt(target.sidebarWidth,10)||defaults.sidebarWidth,90,270);target.fontSize=Utils.clamp(parseFloat(target.fontSize)||defaults.fontSize,8,24);target.headerIconSize=Utils.clamp(parseFloat(target.headerIconSize)||defaults.headerIconSize,8,32);target.verticalSpacingMultiplier=Utils.clamp(parseFloat(target.verticalSpacingMultiplier)||defaults.verticalSpacingMultiplier,0.05,1.5);target.idleOpacity=Utils.clamp(parseFloat(target.idleOpacity)||defaults.idleOpacity,0.1,1.0);target.hoverMode=!!target.hoverMode;const validThemes=['system','light','dark','minimal-light','minimal-dark'];if(target.theme==='minimal')target.theme='minimal-light';else if(!validThemes.includes(target.theme))target.theme=defaults.theme; target.hideGoogleLogoWhenExpanded = typeof source.hideGoogleLogoWhenExpanded === 'boolean' ? source.hideGoogleLogoWhenExpanded : defaults.hideGoogleLogoWhenExpanded;}
  1953.         function _validateAndMergeFeatureSettings_internal(target,source,defaults){if(typeof target.visibleSections!=='object'||target.visibleSections===null||Array.isArray(target.visibleSections)){target.visibleSections=JSON.parse(JSON.stringify(defaults.visibleSections));}const validSectionIDs=new Set(ALL_SECTION_DEFINITIONS.map(def=>def.id));Object.keys(defaults.visibleSections).forEach(id=>{if(!validSectionIDs.has(id)){console.warn(`${LOG_PREFIX} Invalid section ID in defaultSettings.visibleSections: ${id}`);}else if(typeof target.visibleSections[id]!=='boolean'){target.visibleSections[id]=defaults.visibleSections[id]??true;}});const validSectionModes=['remember','expandAll','collapseAll'];if(!validSectionModes.includes(target.sectionDisplayMode))target.sectionDisplayMode=defaults.sectionDisplayMode;target.accordionMode=!!target.accordionMode; target.enableSiteSearchCheckboxMode = typeof target.enableSiteSearchCheckboxMode === 'boolean' ? target.enableSiteSearchCheckboxMode : defaults.enableSiteSearchCheckboxMode; target.showFaviconsForSiteSearch = typeof target.showFaviconsForSiteSearch === 'boolean' ? target.showFaviconsForSiteSearch : defaults.showFaviconsForSiteSearch; target.enableFiletypeCheckboxMode = typeof target.enableFiletypeCheckboxMode === 'boolean' ? target.enableFiletypeCheckboxMode : defaults.enableFiletypeCheckboxMode; const validButtonLocations=['header','topBlock','tools','none'];if(!validButtonLocations.includes(target.resetButtonLocation))target.resetButtonLocation=defaults.resetButtonLocation;if(!validButtonLocations.includes(target.verbatimButtonLocation))target.verbatimButtonLocation=defaults.verbatimButtonLocation;if(!validButtonLocations.includes(target.advancedSearchLinkLocation))target.advancedSearchLinkLocation=defaults.advancedSearchLinkLocation; if (!validButtonLocations.includes(target.personalizationButtonLocation)) { target.personalizationButtonLocation = defaults.personalizationButtonLocation; } if (!validButtonLocations.includes(target.googleScholarShortcutLocation)) { target.googleScholarShortcutLocation = defaults.googleScholarShortcutLocation; } if (!validButtonLocations.includes(target.googleTrendsShortcutLocation)) { target.googleTrendsShortcutLocation = defaults.googleTrendsShortcutLocation; } if (!validButtonLocations.includes(target.googleDatasetSearchShortcutLocation)) { target.googleDatasetSearchShortcutLocation = defaults.googleDatasetSearchShortcutLocation; } const validCountryDisplayModes=['iconAndText','textOnly','iconOnly'];if(!validCountryDisplayModes.includes(target.countryDisplayMode))target.countryDisplayMode=defaults.countryDisplayMode;}
  1954.         function _validateAndMergeCustomLists_internal(target,source,defaults){const listKeys=['favoriteSites','customLanguages','customTimeRanges','customFiletypes','customCountries'];listKeys.forEach(key=>{target[key]=Array.isArray(target[key])?target[key].filter(item=>item&&typeof item.text==='string'&&typeof item[key==='favoriteSites'?'url':'value']==='string'&&item.text.trim()!==''&&item[key==='favoriteSites'?'url':'value'].trim()!==''):JSON.parse(JSON.stringify(defaults[key]));});}
  1955.         function _validateAndMergePredefinedOptions_internal(target,source,defaults){
  1956.             // This function now primarily handles 'time' and 'filetype' enabledPredefinedOptions,
  1957.             // as 'language' and 'country' are managed via their displayArrays.
  1958.             target.enabledPredefinedOptions = target.enabledPredefinedOptions || {};
  1959.             ['time', 'filetype'].forEach(type => {
  1960.                 if (!target.enabledPredefinedOptions[type] || !Array.isArray(target.enabledPredefinedOptions[type])) {
  1961.                     target.enabledPredefinedOptions[type] = JSON.parse(JSON.stringify(defaults.enabledPredefinedOptions[type] || []));
  1962.                 }
  1963.                 const savedTypeOptions = source.enabledPredefinedOptions?.[type];
  1964.                 if (PREDEFINED_OPTIONS[type] && Array.isArray(savedTypeOptions)) {
  1965.                     const validValues = new Set(PREDEFINED_OPTIONS[type].map(opt => opt.value));
  1966.                     target.enabledPredefinedOptions[type] = savedTypeOptions.filter(val => typeof val === 'string' && validValues.has(val));
  1967.                 } else if (!PREDEFINED_OPTIONS[type]) { // If this type has no predefined options in the script
  1968.                     target.enabledPredefinedOptions[type] = [];
  1969.                 }
  1970.                 // If savedTypeOptions is undefined or not an array, it keeps the default or already merged value.
  1971.             });
  1972.             // Ensure language and country are empty in enabledPredefinedOptions as they use display arrays
  1973.             if (target.displayLanguages && target.enabledPredefinedOptions) target.enabledPredefinedOptions.language = [];
  1974.             if (target.displayCountries && target.enabledPredefinedOptions) target.enabledPredefinedOptions.country = [];
  1975.         }
  1976.         function _finalizeSectionOrder_internal(target,source,defaults){const finalOrder=[];const currentVisibleOrderSet=new Set();const validSectionIDs=new Set(ALL_SECTION_DEFINITIONS.map(def=>def.id));const orderSource=(Array.isArray(source.sidebarSectionOrder)&&source.sidebarSectionOrder.length>0)?source.sidebarSectionOrder:defaults.sidebarSectionOrder;orderSource.forEach(id=>{if(typeof id==='string'&&validSectionIDs.has(id)&&target.visibleSections[id]===true&&!currentVisibleOrderSet.has(id)){finalOrder.push(id);currentVisibleOrderSet.add(id);}});defaults.sidebarSectionOrder.forEach(id=>{if(typeof id==='string'&&validSectionIDs.has(id)&&target.visibleSections[id]===true&&!currentVisibleOrderSet.has(id)){finalOrder.push(id);}});target.sidebarSectionOrder=finalOrder;}
  1977.         // Event handlers for live updates in settings UI (put in an object for organization)
  1978.         const _sEH_internal = {
  1979.             // Sliders
  1980.             [IDS.SETTING_WIDTH]:(t,vS)=>_hSLI(t,'sidebarWidth',vS,90,270,5),
  1981.             [IDS.SETTING_FONT_SIZE]:(t,vS)=>_hSLI(t,'fontSize',vS,8,24,0.5,v=>parseFloat(v).toFixed(1)),
  1982.             [IDS.SETTING_HEADER_ICON_SIZE]:(t,vS)=>_hSLI(t,'headerIconSize',vS,8,32,0.5,v=>parseFloat(v).toFixed(1)),
  1983.             [IDS.SETTING_VERTICAL_SPACING]:(t,vS)=>_hSLI(t,'verticalSpacingMultiplier',vS,0.05,1.5,0.05,v=>`x ${parseFloat(v).toFixed(2)}`),
  1984.             [IDS.SETTING_OPACITY]:(t,vS)=>_hSLI(t,'idleOpacity',vS,0.1,1.0,0.05,v=>parseFloat(v).toFixed(2)),
  1985.             // Selects & Checkboxes
  1986.             [IDS.SETTING_INTERFACE_LANGUAGE]:(t)=>{const nL=t.value;if(_currentSettings.interfaceLanguage!==nL){_currentSettings.interfaceLanguage=nL;LocalizationService.updateActiveLocale(_currentSettings);_initMenuCommands_cb();publicApi.populateWindow();_buildSidebarUI_cb();}}, // Re-populate and re-build for language change
  1987.             [IDS.SETTING_THEME]:(t)=>{_currentSettings.theme=t.value;_applySettingsToSidebar_cb(_currentSettings);}, // Apply theme change
  1988.             [IDS.SETTING_HOVER]:(t)=>{_currentSettings.hoverMode=t.checked;const oI=_settingsWindow.querySelector(`#${IDS.SETTING_OPACITY}`);if(oI){const iHE=_currentSettings.hoverMode;oI.disabled=!iHE;const oC=oI.closest('div');if(oC){oC.style.opacity=iHE?'1':'0.6';oC.style.pointerEvents=iHE?'auto':'none';}}_applySettingsToSidebar_cb(_currentSettings);},
  1989.             [IDS.SETTING_DRAGGABLE]:(t)=>{_currentSettings.draggableHandleEnabled=t.checked;_applySettingsToSidebar_cb(_currentSettings);DragManager.setDraggable(t.checked, sidebar, sidebar?.querySelector(`.${CSS.DRAG_HANDLE}`), _currentSettings, debouncedSaveSettings);},
  1990.             [IDS.SETTING_ACCORDION]:(t)=>{const sMS=_settingsWindow.querySelector(`#${IDS.SETTING_SECTION_MODE}`);if(sMS?.value==='remember')_currentSettings.accordionMode=t.checked;else{t.checked=false;_currentSettings.accordionMode=false;}_applySettingsToSidebar_cb(_currentSettings);_applySectionCollapseStates_cb();},
  1991.             [IDS.SETTING_SECTION_MODE]:(t)=>{_currentSettings.sectionDisplayMode=t.value;const aC=_settingsWindow.querySelector(`#${IDS.SETTING_ACCORDION}`);if(aC){const iRM=t.value==='remember';aC.disabled=!iRM; if(aC.parentElement.querySelector(`.${CSS.SETTING_VALUE_HINT}`)) aC.parentElement.querySelector(`.${CSS.SETTING_VALUE_HINT}`).style.color = iRM ? '' : 'grey'; if(!iRM){aC.checked=false;_currentSettings.accordionMode=false;}else{/* Restore previous accordion state if switching back to remember */ aC.checked=_settingsBackup?.accordionMode??_currentSettings.accordionMode??_defaultSettingsRef.accordionMode;_currentSettings.accordionMode=aC.checked;}}_applySettingsToSidebar_cb(_currentSettings);_applySectionCollapseStates_cb();},
  1992.             [IDS.SETTING_RESET_LOCATION]:(t)=>{_currentSettings.resetButtonLocation=t.value;_buildSidebarUI_cb();},
  1993.             [IDS.SETTING_VERBATIM_LOCATION]:(t)=>{_currentSettings.verbatimButtonLocation=t.value;_buildSidebarUI_cb();},
  1994.             [IDS.SETTING_ADV_SEARCH_LOCATION]:(t)=>{_currentSettings.advancedSearchLinkLocation=t.value;_buildSidebarUI_cb();},
  1995.             [IDS.SETTING_PERSONALIZE_LOCATION]: (target) => { _currentSettings.personalizationButtonLocation = target.value; _buildSidebarUI_cb(); },
  1996.             [IDS.SETTING_SCHOLAR_LOCATION]: (target) => { _currentSettings.googleScholarShortcutLocation = target.value; _buildSidebarUI_cb(); },
  1997.             [IDS.SETTING_TRENDS_LOCATION]: (target) => { _currentSettings.googleTrendsShortcutLocation = target.value; _buildSidebarUI_cb(); },
  1998.             [IDS.SETTING_DATASET_SEARCH_LOCATION]: (target) => { _currentSettings.googleDatasetSearchShortcutLocation = target.value; _buildSidebarUI_cb(); },
  1999.             [IDS.SETTING_SITE_SEARCH_CHECKBOX_MODE]: (target) => { _currentSettings.enableSiteSearchCheckboxMode = target.checked; _buildSidebarUI_cb(); },
  2000.             [IDS.SETTING_SHOW_FAVICONS]: (target) => { _currentSettings.showFaviconsForSiteSearch = target.checked; _buildSidebarUI_cb(); },
  2001.             [IDS.SETTING_FILETYPE_SEARCH_CHECKBOX_MODE]: (target) => { _currentSettings.enableFiletypeCheckboxMode = target.checked; _buildSidebarUI_cb(); },
  2002.             [IDS.SETTING_COUNTRY_DISPLAY_MODE]:(t)=>{_currentSettings.countryDisplayMode=t.value;_buildSidebarUI_cb();},
  2003.             [IDS.SETTING_HIDE_GOOGLE_LOGO]:(t)=>{_currentSettings.hideGoogleLogoWhenExpanded=t.checked;_applySettingsToSidebar_cb(_currentSettings);},
  2004.         };
  2005.         // Helper for handling slider input event
  2006.         function _hSLI(t,sK,vS,min,max,step,fFn=v=>v){const v=Utils.clamp((step===1||step===5)?parseInt(t.value,10):parseFloat(t.value),min,max);if(isNaN(v))_currentSettings[sK]=_defaultSettingsRef[sK];else _currentSettings[sK]=v;if(vS)vS.textContent=fFn(_currentSettings[sK]);_applySettingsToSidebar_cb(_currentSettings);}
  2007.         // Unified live update handler
  2008.         function _lUH_internal(e){const t=e.target;if(!t)return;const sI=t.id;const vS=(t.type==='range')?t.parentNode.querySelector(`.${CSS.RANGE_VALUE}`):null;if(_sEH_internal[sI]){if(t.type==='range')_sEH_internal[sI](t,vS);else _sEH_internal[sI](t);}}
  2009.  
  2010.         const publicApi = {
  2011.             initialize: function(defaultSettingsObj, applyCb, buildCb, collapseCb, menuCb, renderOrderCb) { if(_isInitialized) return; _defaultSettingsRef = defaultSettingsObj; _applySettingsToSidebar_cb = applyCb; _buildSidebarUI_cb = buildCb; _applySectionCollapseStates_cb = collapseCb; _initMenuCommands_cb = menuCb; _renderSectionOrderList_ext_cb = renderOrderCb; this.load(); this.buildSkeleton(); _isInitialized = true; },
  2012.             load: function(){ const s=_loadFromStorage(); _currentSettings=_validateAndMergeSettings(s); LocalizationService.updateActiveLocale(_currentSettings);},
  2013.             save: function(logContext='SaveBtn'){
  2014.                 try {
  2015.                     // Consolidate custom items from displayLanguages/Countries back to customLanguages/Countries master lists
  2016.                     ['displayLanguages', 'displayCountries'].forEach(displayKey => {
  2017.                         const mapping = getListMapping(displayKey === 'displayLanguages' ? IDS.LANG_LIST : IDS.COUNTRIES_LIST);
  2018.                         if (mapping && mapping.customItemsMasterKey && _currentSettings[displayKey] && Array.isArray(_currentSettings[mapping.customItemsMasterKey])) {
  2019.                             const displayItems = _currentSettings[displayKey];
  2020.                             const currentDisplayCustomItems = displayItems.filter(item => item.type === 'custom');
  2021.                             const currentDisplayCustomItemValues = new Set(currentDisplayCustomItems.map(item => item.value));
  2022.  
  2023.                             // Filter master list: keep only those custom items that are still in the display list
  2024.                             const newMasterList = (_currentSettings[mapping.customItemsMasterKey] || [])
  2025.                                 .filter(masterItem => currentDisplayCustomItemValues.has(masterItem.value))
  2026.                                 .map(oldMasterItem => { // Update text from display item if it changed
  2027.                                     const correspondingDisplayItem = currentDisplayCustomItems.find(d => d.value === oldMasterItem.value);
  2028.                                     return correspondingDisplayItem ? { text: correspondingDisplayItem.text, value: oldMasterItem.value } : oldMasterItem;
  2029.                                 });
  2030.  
  2031.                             // Add new custom items from display list to master if not already there
  2032.                             currentDisplayCustomItems.forEach(dispItem => {
  2033.                                 if (!newMasterList.find(mi => mi.value === dispItem.value)) {
  2034.                                     newMasterList.push({ text: dispItem.text, value: dispItem.value });
  2035.                                 }
  2036.                             });
  2037.                             _currentSettings[mapping.customItemsMasterKey] = newMasterList;
  2038.                         }
  2039.                     });
  2040.  
  2041.                     GM_setValue(STORAGE_KEY, JSON.stringify(_currentSettings));
  2042.                     console.log(`${LOG_PREFIX} Settings saved by SM${logContext ? ` (${logContext})` : ''}.`);
  2043.                     _settingsBackup = JSON.parse(JSON.stringify(_currentSettings)); // Update backup after successful save
  2044.                 } catch (e) {
  2045.                     console.error(`${LOG_PREFIX} SM save error:`, e);
  2046.                     NotificationManager.show('alert_generic_error', { context: 'saving settings' }, 'error', 5000);
  2047.                 }
  2048.             },
  2049.             reset: function(){ if(confirm(_('confirm_reset_settings'))){ _currentSettings = JSON.parse(JSON.stringify(_defaultSettingsRef)); _migrateToDisplayArraysIfNecessary(_currentSettings); /* Ensure section order is reset if empty */ if(!_currentSettings.sidebarSectionOrder||_currentSettings.sidebarSectionOrder.length===0){ _currentSettings.sidebarSectionOrder = [..._defaultSettingsRef.sidebarSectionOrder]; } LocalizationService.updateActiveLocale(_currentSettings); this.populateWindow(); _applySettingsToSidebar_cb(_currentSettings); _buildSidebarUI_cb(); _initMenuCommands_cb(); _showGlobalMessage('alert_settings_reset_success',{},'success',4000);}},
  2050.             resetAllFromMenu: function(){ if(confirm(_('confirm_reset_all_menu'))){ try{ GM_setValue(STORAGE_KEY,JSON.stringify(_defaultSettingsRef)); alert(_('alert_reset_all_menu_success')); }catch(e){ _showGlobalMessage('alert_reset_all_menu_fail',{},'error',0); /* Use alert as NotificationManager might not be ready */ }}},
  2051.             getCurrentSettings: function(){ return _currentSettings;},
  2052.             buildSkeleton: function(){ if(_settingsWindow)return; _settingsOverlay=document.createElement('div');_settingsOverlay.id=IDS.SETTINGS_OVERLAY;_settingsWindow=document.createElement('div');_settingsWindow.id=IDS.SETTINGS_WINDOW;const h=document.createElement('div');h.classList.add(CSS.SETTINGS_HEADER);h.innerHTML=`<h3>${_('settingsTitle')}</h3><button class="${CSS.SETTINGS_CLOSE_BTN}" title="${_('settings_close_button_title')}">${SVG_ICONS.close}</button>`;const mB=document.createElement('div');mB.id=IDS.SETTINGS_MESSAGE_BAR;mB.classList.add(CSS.MESSAGE_BAR);mB.style.display='none';const ts=document.createElement('div');ts.classList.add(CSS.SETTINGS_TABS);ts.innerHTML=`<button class="${CSS.TAB_BUTTON} ${CSS.ACTIVE}" data-${DATA_ATTR.TAB}="general">${_('settings_tab_general')}</button> <button class="${CSS.TAB_BUTTON}" data-${DATA_ATTR.TAB}="appearance">${_('settings_tab_appearance')}</button> <button class="${CSS.TAB_BUTTON}" data-${DATA_ATTR.TAB}="features">${_('settings_tab_features')}</button> <button class="${CSS.TAB_BUTTON}" data-${DATA_ATTR.TAB}="custom">${_('settings_tab_custom')}</button>`;const c=document.createElement('div');c.classList.add(CSS.SETTINGS_TAB_CONTENT);c.innerHTML=`<div class="${CSS.TAB_PANE} ${CSS.ACTIVE}" data-${DATA_ATTR.TAB}="general" id="${IDS.TAB_PANE_GENERAL}"></div><div class="${CSS.TAB_PANE}" data-${DATA_ATTR.TAB}="appearance" id="${IDS.TAB_PANE_APPEARANCE}"></div><div class="${CSS.TAB_PANE}" data-${DATA_ATTR.TAB}="features" id="${IDS.TAB_PANE_FEATURES}"></div><div class="${CSS.TAB_PANE}" data-${DATA_ATTR.TAB}="custom" id="${IDS.TAB_PANE_CUSTOM}"></div>`;const f=document.createElement('div');f.classList.add(CSS.SETTINGS_FOOTER);f.innerHTML=`<button class="${CSS.RESET_BUTTON}">${_('settings_reset_all_button')}</button><button class="${CSS.CANCEL_BUTTON}">${_('settings_cancel_button')}</button><button class="${CSS.SAVE_BUTTON}">${_('settings_save_button')}</button>`;_settingsWindow.appendChild(h);_settingsWindow.appendChild(mB);_settingsWindow.appendChild(ts);_settingsWindow.appendChild(c);_settingsWindow.appendChild(f);_settingsOverlay.appendChild(_settingsWindow);document.body.appendChild(_settingsOverlay);this.bindEvents();},
  2053.             populateWindow: function(){
  2054.                 if(!_settingsWindow)return;
  2055.                 try {
  2056.                     // Update translatable texts first
  2057.                     _settingsWindow.querySelector(`.${CSS.SETTINGS_HEADER} h3`).textContent=_( 'settingsTitle');
  2058.                     _settingsWindow.querySelector(`.${CSS.SETTINGS_CLOSE_BTN}`).title=_( 'settings_close_button_title');
  2059.                     _settingsWindow.querySelector(`button[data-${DATA_ATTR.TAB}="general"]`).textContent=_( 'settings_tab_general');
  2060.                     _settingsWindow.querySelector(`button[data-${DATA_ATTR.TAB}="appearance"]`).textContent=_( 'settings_tab_appearance');
  2061.                     _settingsWindow.querySelector(`button[data-${DATA_ATTR.TAB}="features"]`).textContent=_( 'settings_tab_features');
  2062.                     _settingsWindow.querySelector(`button[data-${DATA_ATTR.TAB}="custom"]`).textContent=_( 'settings_tab_custom');
  2063.                     _settingsWindow.querySelector(`.${CSS.RESET_BUTTON}`).textContent=_( 'settings_reset_all_button');
  2064.                     _settingsWindow.querySelector(`.${CSS.CANCEL_BUTTON}`).textContent=_( 'settings_cancel_button');
  2065.                     _settingsWindow.querySelector(`.${CSS.SAVE_BUTTON}`).textContent=_( 'settings_save_button');
  2066.  
  2067.                     // Re-generate tab content HTML to reflect any language changes in labels
  2068.                     const paneGeneral = _settingsWindow.querySelector(`#${IDS.TAB_PANE_GENERAL}`); if(paneGeneral) paneGeneral.innerHTML = SettingsUIPaneGenerator.createGeneralPaneHTML();
  2069.                     const paneAppearance = _settingsWindow.querySelector(`#${IDS.TAB_PANE_APPEARANCE}`); if(paneAppearance) paneAppearance.innerHTML = SettingsUIPaneGenerator.createAppearancePaneHTML();
  2070.                     const paneFeatures = _settingsWindow.querySelector(`#${IDS.TAB_PANE_FEATURES}`); if(paneFeatures) paneFeatures.innerHTML = SettingsUIPaneGenerator.createFeaturesPaneHTML();
  2071.                     const paneCustom = _settingsWindow.querySelector(`#${IDS.TAB_PANE_CUSTOM}`); if(paneCustom) paneCustom.innerHTML = SettingsUIPaneGenerator.createCustomPaneHTML();
  2072.  
  2073.                     // Populate values into the newly generated/updated UI
  2074.                     _populateGeneralSettings_internal(_settingsWindow, _currentSettings);
  2075.                     _populateAppearanceSettings_internal(_settingsWindow, _currentSettings);
  2076.                     _populateFeatureSettings_internal(_settingsWindow, _currentSettings, _renderSectionOrderList_ext_cb); // Pass callback
  2077.                     ModalManager.resetEditStateGlobally(); // Reset modal edit state if any was active
  2078.                     _initializeActiveSettingsTab_internal(); // Ensure correct tab is active
  2079.                     this.bindLiveUpdateEvents(); // Re-bind for dynamic elements if panes were rebuilt
  2080.                     this.bindFeaturesTabEvents(); // Specifically for features tab dynamic elements
  2081.                 }catch(e){ _showGlobalMessage('alert_init_fail',{scriptName:SCRIPT_INTERNAL_NAME,error:"Settings UI pop err"},'error',0); }
  2082.             },
  2083.             show: function(){ if(!_settingsOverlay||!_settingsWindow)return;_settingsBackup = JSON.parse(JSON.stringify(_currentSettings));LocalizationService.updateActiveLocale(_currentSettings);this.populateWindow();applyThemeToElement(_settingsWindow, _currentSettings.theme);applyThemeToElement(_settingsOverlay, _currentSettings.theme);_settingsOverlay.style.display = 'flex';},
  2084.             hide: function(isCancel = false){ if(!_settingsOverlay)return;ModalManager.resetEditStateGlobally();if(ModalManager.isModalOpen()) ModalManager.hide(true);_settingsOverlay.style.display = 'none';const messageBar = document.getElementById(IDS.SETTINGS_MESSAGE_BAR);if(messageBar) messageBar.style.display = 'none';if(isCancel && _settingsBackup && Object.keys(_settingsBackup).length > 0){ _currentSettings = JSON.parse(JSON.stringify(_settingsBackup));LocalizationService.updateActiveLocale(_currentSettings);this.populateWindow();_applySettingsToSidebar_cb(_currentSettings);_buildSidebarUI_cb();_initMenuCommands_cb();} else if(isCancel) { console.warn(`${LOG_PREFIX} SM: Cancelled, no backup to restore or backup was identical.`); }},
  2085.             bindEvents: function(){
  2086.                 if(!_settingsWindow || _settingsWindow.dataset.eventsBound === 'true') return; // Prevent multiple bindings
  2087.                 _settingsWindow.querySelector(`.${CSS.SETTINGS_CLOSE_BTN}`)?.addEventListener('click', () => this.hide(true));
  2088.                 _settingsWindow.querySelector(`.${CSS.CANCEL_BUTTON}`)?.addEventListener('click', () => this.hide(true));
  2089.                 _settingsWindow.querySelector(`.${CSS.SAVE_BUTTON}`)?.addEventListener('click', () => { this.save(); LocalizationService.updateActiveLocale(_currentSettings); _initMenuCommands_cb(); _buildSidebarUI_cb(); this.hide(false); });
  2090.                 _settingsWindow.querySelector(`.${CSS.RESET_BUTTON}`)?.addEventListener('click', () => this.reset());
  2091.                 const tabsContainer = _settingsWindow.querySelector(`.${CSS.SETTINGS_TABS}`);
  2092.                 if(tabsContainer){ tabsContainer.addEventListener('click', e => { const targetButton = e.target.closest(`.${CSS.TAB_BUTTON}`); if(targetButton && !targetButton.classList.contains(CSS.ACTIVE)){ ModalManager.resetEditStateGlobally(); const tabToActivate = targetButton.dataset[DATA_ATTR.TAB]; if(!tabToActivate) return; tabsContainer.querySelectorAll(`.${CSS.TAB_BUTTON}`).forEach(b => b.classList.remove(CSS.ACTIVE)); targetButton.classList.add(CSS.ACTIVE); _settingsWindow.querySelector(`.${CSS.SETTINGS_TAB_CONTENT}`)?.querySelectorAll(`.${CSS.TAB_PANE}`)?.forEach(p => p.classList.remove(CSS.ACTIVE)); _settingsWindow.querySelector(`.${CSS.SETTINGS_TAB_CONTENT} .${CSS.TAB_PANE}[data-${DATA_ATTR.TAB}="${tabToActivate}"]`)?.classList.add(CSS.ACTIVE); } }); }
  2093.                 _settingsWindow.dataset.eventsBound = 'true';
  2094.                 // Bind "Manage..." buttons in Custom tab
  2095.                 const customTabPane = _settingsWindow.querySelector(`#${IDS.TAB_PANE_CUSTOM}`);
  2096.                 if(customTabPane){ customTabPane.addEventListener('click', (e) => { const manageButton = e.target.closest(`button.${CSS.MANAGE_CUSTOM_BUTTON}`); if(manageButton){ const manageType = manageButton.dataset[DATA_ATTR.MANAGE_TYPE]; if(manageType){ ModalManager.openManageCustomOptions( manageType, _currentSettings, PREDEFINED_OPTIONS, (updatedItemsArray, newEnabledPredefs, itemsArrayKey, predefinedOptKey, customItemsMasterKey, isSortableMixed, manageTypeFromCallback) => { if (itemsArrayKey) { _currentSettings[itemsArrayKey] = updatedItemsArray; } if (predefinedOptKey && newEnabledPredefs) { if (!_currentSettings.enabledPredefinedOptions) _currentSettings.enabledPredefinedOptions = {}; _currentSettings.enabledPredefinedOptions[predefinedOptKey] = newEnabledPredefs; } _buildSidebarUI_cb(); } ); } } }); }
  2097.             },
  2098.             bindLiveUpdateEvents: function(){ if(!_settingsWindow)return; _settingsWindow.querySelectorAll('input[type="range"]').forEach(el=>{ el.removeEventListener('input',_lUH_internal); el.addEventListener('input',_lUH_internal); }); _settingsWindow.querySelectorAll('select, input[type="checkbox"]:not([data-section-id])').forEach(el=>{ if(_sEH_internal[el.id]){ el.removeEventListener('change',_lUH_internal); el.addEventListener('change',_lUH_internal); } }); },
  2099.             bindFeaturesTabEvents: function() { // For elements specific to the features tab that might be rebuilt
  2100.                 const featuresPane = _settingsWindow?.querySelector(`#${IDS.TAB_PANE_FEATURES}`); if (!featuresPane) return;
  2101.                 // Section visibility checkboxes
  2102.                 featuresPane.querySelectorAll(`input[type="checkbox"][data-${DATA_ATTR.SECTION_ID}]`).forEach(checkbox => { checkbox.removeEventListener('change', this._handleVisibleSectionChange); checkbox.addEventListener('change', this._handleVisibleSectionChange.bind(this)); });
  2103.                 // Site search checkbox mode
  2104.                 const siteSearchCheckboxModeEl = featuresPane.querySelector(`#${IDS.SETTING_SITE_SEARCH_CHECKBOX_MODE}`);
  2105.                 if (siteSearchCheckboxModeEl && _sEH_internal[IDS.SETTING_SITE_SEARCH_CHECKBOX_MODE]) {
  2106.                     siteSearchCheckboxModeEl.removeEventListener('change', _lUH_internal);
  2107.                     siteSearchCheckboxModeEl.addEventListener('change', _lUH_internal);
  2108.                 }
  2109.                 const showFaviconsEl = featuresPane.querySelector(`#${IDS.SETTING_SHOW_FAVICONS}`);
  2110.                 if (showFaviconsEl && _sEH_internal[IDS.SETTING_SHOW_FAVICONS]) {
  2111.                     showFaviconsEl.removeEventListener('change', _lUH_internal);
  2112.                     showFaviconsEl.addEventListener('change', _lUH_internal);
  2113.                 }
  2114.                 // Filetype search checkbox mode
  2115.                 const filetypeSearchCheckboxModeEl = featuresPane.querySelector(`#${IDS.SETTING_FILETYPE_SEARCH_CHECKBOX_MODE}`);
  2116.                 if (filetypeSearchCheckboxModeEl && _sEH_internal[IDS.SETTING_FILETYPE_SEARCH_CHECKBOX_MODE]) {
  2117.                     filetypeSearchCheckboxModeEl.removeEventListener('change', _lUH_internal);
  2118.                     filetypeSearchCheckboxModeEl.addEventListener('change', _lUH_internal);
  2119.                 }
  2120.  
  2121.                 // Section order list drag handler
  2122.                 const orderListElement = featuresPane.querySelector(`#${IDS.SIDEBAR_SECTION_ORDER_LIST}`);
  2123.                 if (orderListElement) { SectionOrderDragHandler.initialize(orderListElement, _currentSettings, () => { _renderSectionOrderList_ext_cb(_currentSettings); _buildSidebarUI_cb(); }); }
  2124.             },
  2125.             _handleVisibleSectionChange: function(e){ const target = e.target; const sectionId = target.getAttribute(`data-${DATA_ATTR.SECTION_ID}`); if (sectionId && _currentSettings.visibleSections.hasOwnProperty(sectionId)) { _currentSettings.visibleSections[sectionId] = target.checked; _finalizeSectionOrder_internal(_currentSettings, _currentSettings, _defaultSettingsRef); _renderSectionOrderList_ext_cb(_currentSettings); _buildSidebarUI_cb(); } },
  2126.         };
  2127.         return publicApi;
  2128.     })();
  2129.  
  2130.     // --- DragManager for sidebar positioning ---
  2131.     const DragManager = (function() {
  2132.         let _isDragging = false; let _dragStartX, _dragStartY, _sidebarStartX, _sidebarStartY;
  2133.         let _sidebarElement, _handleElement; let _settingsManagerRef, _saveCallbackRef;
  2134.  
  2135.         function _getEventCoordinates(e) { return (e.touches && e.touches.length > 0) ? { x: e.touches[0].clientX, y: e.touches[0].clientY } : { x: e.clientX, y: e.clientY }; }
  2136.         function _startDrag(e) {
  2137.             const currentSettings = _settingsManagerRef.getCurrentSettings();
  2138.             if (!currentSettings.draggableHandleEnabled || currentSettings.sidebarCollapsed || (e.type === 'mousedown' && e.button !== 0)) { // Only main mouse button
  2139.                 return;
  2140.             }
  2141.             e.preventDefault(); // Prevent text selection, etc.
  2142.             _isDragging = true;
  2143.             const coords = _getEventCoordinates(e);
  2144.             _dragStartX = coords.x;
  2145.             _dragStartY = coords.y;
  2146.             _sidebarStartX = _sidebarElement.offsetLeft;
  2147.             _sidebarStartY = _sidebarElement.offsetTop;
  2148.             _sidebarElement.style.cursor = 'grabbing';
  2149.             _sidebarElement.style.userSelect = 'none'; // Prevent text selection during drag
  2150.             document.body.style.cursor = 'grabbing'; // Change cursor for the whole body
  2151.         }
  2152.         function _drag(e) {
  2153.             if (!_isDragging) return;
  2154.             e.preventDefault();
  2155.             const coords = _getEventCoordinates(e);
  2156.             const dx = coords.x - _dragStartX;
  2157.             const dy = coords.y - _dragStartY;
  2158.             let newLeft = _sidebarStartX + dx;
  2159.             let newTop = _sidebarStartY + dy;
  2160.  
  2161.             // Constrain within viewport
  2162.             const maxLeft = window.innerWidth - (_sidebarElement?.offsetWidth ?? 0); // Use offsetWidth if available
  2163.             const maxTop = window.innerHeight - (_sidebarElement?.offsetHeight ?? 0);
  2164.             newLeft = Utils.clamp(newLeft, 0, maxLeft);
  2165.             newTop = Utils.clamp(newTop, MIN_SIDEBAR_TOP_POSITION, maxTop); // MIN_SIDEBAR_TOP_POSITION from global
  2166.  
  2167.             if (_sidebarElement) {
  2168.                 _sidebarElement.style.left = `${newLeft}px`;
  2169.                 _sidebarElement.style.top = `${newTop}px`;
  2170.             }
  2171.         }
  2172.         function _stopDrag() {
  2173.             if (_isDragging) {
  2174.                 _isDragging = false;
  2175.                 if (_sidebarElement) {
  2176.                     _sidebarElement.style.cursor = 'default'; // Reset cursor on sidebar
  2177.                     _sidebarElement.style.userSelect = ''; // Re-enable text selection
  2178.                 }
  2179.                 document.body.style.cursor = ''; // Reset body cursor
  2180.  
  2181.                 const currentSettings = _settingsManagerRef.getCurrentSettings();
  2182.                 if (!currentSettings.sidebarPosition) currentSettings.sidebarPosition = {};
  2183.                 currentSettings.sidebarPosition.left = _sidebarElement.offsetLeft;
  2184.                 currentSettings.sidebarPosition.top = _sidebarElement.offsetTop;
  2185.  
  2186.                 if (typeof _saveCallbackRef === 'function') {
  2187.                     _saveCallbackRef('Drag Stop'); // Save settings
  2188.                 }
  2189.             }
  2190.         }
  2191.         return {
  2192.             init: function(sidebarEl, handleEl, settingsMgr, saveCb) {
  2193.                 _sidebarElement = sidebarEl;
  2194.                 _handleElement = handleEl;
  2195.                 _settingsManagerRef = settingsMgr;
  2196.                 _saveCallbackRef = saveCb;
  2197.  
  2198.                 if (_handleElement) {
  2199.                     _handleElement.addEventListener('mousedown', _startDrag);
  2200.                     _handleElement.addEventListener('touchstart', _startDrag, { passive: false }); // Use passive: false for preventDefault
  2201.                 }
  2202.                 document.addEventListener('mousemove', _drag);
  2203.                 document.addEventListener('touchmove', _drag, { passive: false });
  2204.                 document.addEventListener('mouseup', _stopDrag);
  2205.                 document.addEventListener('touchend', _stopDrag);
  2206.                 document.addEventListener('touchcancel', _stopDrag); // Handle cancellation (e.g. system interruption)
  2207.             },
  2208.             setDraggable: function(isEnabled, sidebarEl, handleEl) { // Update references if sidebar/handle changes
  2209.                 _sidebarElement = sidebarEl;
  2210.                 _handleElement = handleEl;
  2211.                 if (_handleElement) {
  2212.                     _handleElement.style.display = isEnabled ? 'block' : 'none'; // Show/hide handle based on setting
  2213.                 }
  2214.             }
  2215.         };
  2216.     })();
  2217.  
  2218.     // --- URLActionManager for applying filters via URL manipulation ---
  2219.     const URLActionManager = (function() {
  2220.         function _getURLObject() { try { return new URL(window.location.href); } catch (e) { console.error(`${LOG_PREFIX} Error creating URL object: `, e); return null; }}
  2221.         function _navigateTo(url) { const urlString = url.toString(); window.location.href = urlString; }
  2222.         function _setSearchParam(urlObj, paramName, value) { urlObj.searchParams.set(paramName, value); }
  2223.         function _deleteSearchParam(urlObj, paramName) { urlObj.searchParams.delete(paramName); }
  2224.         function _getTbsParts(urlObj) { const tbs = urlObj.searchParams.get('tbs'); return tbs ? tbs.split(',').filter(p => p.trim() !== '') : []; }
  2225.         function _setTbsParam(urlObj, tbsPartsArray) { const newTbsValue = tbsPartsArray.join(','); if (newTbsValue) { _setSearchParam(urlObj, 'tbs', newTbsValue); } else { _deleteSearchParam(urlObj, 'tbs'); }}
  2226.  
  2227.         return {
  2228.             triggerResetFilters: function() {
  2229.                 try {
  2230.                     const u = _getURLObject(); if (!u) return;
  2231.                     const q = u.searchParams.get('q') || '';
  2232.                     const nP = new URLSearchParams(); // Start with fresh params
  2233.  
  2234.                     // Clean query: remove existing site: and filetype: operators
  2235.                     let cQ = q.replace(/\s*(?:\(\s*)?(?:(?:site|filetype):[\w.:\/~%?#=&+-]+(?:\s+OR\s+|$))+[^)]*\)?\s*/gi, ' ');
  2236.                     cQ = cQ.replace(/\s*(?:site|filetype):[\w.:\/~%?#=&+-]+\s*/gi, ' ');
  2237.                     cQ = cQ.replace(/\s\s+/g, ' ').trim();
  2238.  
  2239.                     if (cQ) { nP.set('q', cQ); }
  2240.                     u.search = nP.toString();
  2241.  
  2242.                     _deleteSearchParam(u, 'tbs'); _deleteSearchParam(u, 'lr'); _deleteSearchParam(u, 'cr');
  2243.                     _deleteSearchParam(u, 'as_filetype'); _deleteSearchParam(u, 'as_occt');
  2244.                     _navigateTo(u);
  2245.                 } catch (e) {
  2246.                     NotificationManager.show('alert_error_resetting_filters', {}, 'error', 5000);
  2247.                 }
  2248.             },
  2249.             triggerToggleVerbatim: function() { try { const u = _getURLObject(); if (!u) return; let tP = _getTbsParts(u); const vP = 'li:1'; const iCA = tP.includes(vP); tP = tP.filter(p => p !== vP); if (!iCA) { tP.push(vP); } _setTbsParam(u, tP); _navigateTo(u); } catch (e) { NotificationManager.show('alert_error_toggling_verbatim', {}, 'error', 5000); }},
  2250.             isPersonalizationActive: function() { try { const currentUrl = _getURLObject(); if (!currentUrl) { return true; } return currentUrl.searchParams.get('pws') !== '0'; } catch (e) { console.warn(`${LOG_PREFIX} [URLActionManager.isPersonalizationActive] Error checking personalization status:`, e); return true; /* Assume active on error */ } },
  2251.             triggerTogglePersonalization: function() { try { const u = _getURLObject(); if (!u) { return; } const personalizationCurrentlyActive = URLActionManager.isPersonalizationActive(); if (personalizationCurrentlyActive) { _setSearchParam(u, 'pws', '0'); } else { _deleteSearchParam(u, 'pws'); } _navigateTo(u); } catch (e) { NotificationManager.show('alert_error_toggling_personalization', {}, 'error', 5000); console.error(`${LOG_PREFIX} [URLActionManager.triggerTogglePersonalization] Error:`, e); } },
  2252.             applyFilter: function(type, value) {
  2253.                 try {
  2254.                     const u = _getURLObject(); if (!u) return;
  2255.                     let tbsParts = _getTbsParts(u);
  2256.                     let processedTbsParts;
  2257.  
  2258.                     const isTimeFilter = type === 'qdr';
  2259.                     const isStandaloneParam = ['lr', 'cr', 'as_occt'].includes(type);
  2260.  
  2261.                     if (isTimeFilter) {
  2262.                         processedTbsParts = tbsParts.filter(p => !p.startsWith(`qdr:`) && !p.startsWith('cdr:') && !p.startsWith('cd_min:') && !p.startsWith('cd_max:'));
  2263.                         if (value !== '') processedTbsParts.push(`qdr:${value}`);
  2264.                         _setTbsParam(u, processedTbsParts);
  2265.                     } else if (isStandaloneParam) {
  2266.                         _deleteSearchParam(u, type);
  2267.                         if (value !== '' && !(type === 'as_occt' && value === 'any')) {
  2268.                             _setSearchParam(u, type, value);
  2269.                         }
  2270.                     } else if (type === 'as_filetype') {
  2271.                         const filetypesToApply = Utils.parseCombinedValue(value);
  2272.                         if (filetypesToApply.length > 1) {
  2273.                             this.applyCombinedFiletypeSearch(filetypesToApply);
  2274.                             return;
  2275.                         }
  2276.                         let currentQuery = u.searchParams.get('q') || '';
  2277.                         currentQuery = currentQuery.replace(/\s*(?:\(\s*)?(?:filetype:[\w.:\/~%?#=&+-]+(?:\s+OR\s+|$))+[^)]*\)?\s*/gi, ' ');
  2278.                         currentQuery = currentQuery.replace(/\s*filetype:[\w.:\/~%?#=&+-]+\s*/gi, ' ');
  2279.                         currentQuery = currentQuery.replace(/\s\s+/g, ' ').trim();
  2280.  
  2281.                         if (value !== '') {
  2282.                             _setSearchParam(u, 'q', (currentQuery + ` filetype:${filetypesToApply[0]}`).trim());
  2283.                         } else {
  2284.                             if(currentQuery) _setSearchParam(u, 'q', currentQuery);
  2285.                             else _deleteSearchParam(u, 'q');
  2286.                         }
  2287.                         _deleteSearchParam(u, 'as_filetype');
  2288.                     }
  2289.                     _navigateTo(u);
  2290.                 } catch (e) {
  2291.                     NotificationManager.show('alert_error_applying_filter', { type: type, value: value }, 'error', 5000);
  2292.                 }
  2293.             },
  2294.  
  2295.             applySiteSearch: function(siteCriteria) {
  2296.                 const sitesToSearch = Array.isArray(siteCriteria)
  2297.                     ? siteCriteria.flatMap(sc => Utils.parseCombinedValue(sc))
  2298.                     : Utils.parseCombinedValue(siteCriteria);
  2299.                 const uniqueSites = [...new Set(sitesToSearch.map(s => s.toLowerCase()))];
  2300.  
  2301.                 if (uniqueSites.length === 0) {
  2302.                     this.clearSiteSearch(); return;
  2303.                 }
  2304.                 try {
  2305.                     const u = _getURLObject(); if (!u) return;
  2306.                     let q = u.searchParams.get('q') || '';
  2307.  
  2308.                     q = q.replace(/\s*(?:\(\s*)?(?:(?:site|filetype):[\w.:\/~%?#=&+-]+(?:\s+OR\s+|$))+[^)]*\)?\s*/gi, ' ');
  2309.                     q = q.replace(/\s*(?:site|filetype):[\w.:\/~%?#=&+-]+\s*/gi, ' ');
  2310.                     q = q.replace(/\s\s+/g, ' ').trim();
  2311.  
  2312.                     let siteQueryPart = uniqueSites.map(s => `site:${s}`).join(' OR '); // Corrected to join with ' OR '
  2313.  
  2314.                     const nQ = `${q} ${siteQueryPart}`.trim();
  2315.                     _setSearchParam(u, 'q', nQ);
  2316.                     _deleteSearchParam(u, 'tbs'); _deleteSearchParam(u, 'lr'); _deleteSearchParam(u, 'cr');
  2317.                     _deleteSearchParam(u, 'as_filetype'); _deleteSearchParam(u, 'as_occt');
  2318.                     _navigateTo(u);
  2319.                 } catch (e) {
  2320.                     const siteForError = uniqueSites.join(', ');
  2321.                     NotificationManager.show('alert_error_applying_site_search', { site: siteForError }, 'error', 5000);
  2322.                 }
  2323.             },
  2324.             applyCombinedFiletypeSearch: function(filetypeCriteria) {
  2325.                 const filetypesToSearch = Array.isArray(filetypeCriteria)
  2326.                     ? filetypeCriteria.flatMap(fc => Utils.parseCombinedValue(fc))
  2327.                     : Utils.parseCombinedValue(filetypeCriteria);
  2328.                 const uniqueFiletypes = [...new Set(filetypesToSearch.map(f => f.toLowerCase()))];
  2329.  
  2330.                 if (uniqueFiletypes.length === 0) {
  2331.                     this.clearFiletypeSearch();
  2332.                     return;
  2333.                 }
  2334.                 try {
  2335.                     const u = _getURLObject(); if (!u) return;
  2336.                     let q = u.searchParams.get('q') || '';
  2337.  
  2338.                     q = q.replace(/\s*(?:\(\s*)?(?:(?:filetype|site):[\w.:\/~%?#=&+-]+(?:\s+OR\s+|$))+[^)]*\)?\s*/gi, ' ');
  2339.                     q = q.replace(/\s*(?:filetype|site):[\w.:\/~%?#=&+-]+\s*/gi, ' ');
  2340.                     q = q.replace(/\s\s+/g, ' ').trim();
  2341.  
  2342.                     let filetypeQueryPart = uniqueFiletypes.map(ft => `filetype:${ft}`).join(' OR '); // Corrected to join with ' OR '
  2343.  
  2344.                     const nQ = `${q} ${filetypeQueryPart}`.trim();
  2345.                     _setSearchParam(u, 'q', nQ);
  2346.                     _deleteSearchParam(u, 'as_filetype');
  2347.                     _navigateTo(u);
  2348.                 } catch (e) {
  2349.                     const ftForError = uniqueFiletypes.join(', ');
  2350.                     NotificationManager.show('alert_error_applying_filter', { type: 'filetype (combined)', value: ftForError }, 'error', 5000);
  2351.                 }
  2352.             },
  2353.             clearSiteSearch: function() {
  2354.                 try {
  2355.                     const u = _getURLObject(); if (!u) return;
  2356.                     const q = u.searchParams.get('q') || '';
  2357.                     let nQ = q.replace(/\s*(?:\(\s*)?(?:site:[\w.:\/~%?#=&+-]+(?:\s+OR\s+|$))+[^)]*\)?\s*/gi, ' ');
  2358.                     nQ = nQ.replace(/\s*site:[\w.:\/~%?#=&+-]+\s*/gi, ' ');
  2359.                     nQ = nQ.replace(/\s\s+/g, ' ').trim();
  2360.                     if (nQ) { _setSearchParam(u, 'q', nQ); } else { _deleteSearchParam(u, 'q'); }
  2361.                     _navigateTo(u);
  2362.                 } catch (e) {
  2363.                     NotificationManager.show('alert_error_clearing_site_search', {}, 'error', 5000);
  2364.                 }
  2365.             },
  2366.             clearFiletypeSearch: function() {
  2367.                 try {
  2368.                     const u = _getURLObject(); if (!u) return;
  2369.                     let q = u.searchParams.get('q') || '';
  2370.                     q = q.replace(/\s*(?:\(\s*)?(?:filetype:[\w.:\/~%?#=&+-]+(?:\s+OR\s+|$))+[^)]*\)?\s*/gi, ' ');
  2371.                     q = q.replace(/\s*filetype:[\w.:\/~%?#=&+-]+\s*/gi, ' ');
  2372.                     q = q.replace(/\s\s+/g, ' ').trim();
  2373.                     if (q) { _setSearchParam(u, 'q', q); } else { _deleteSearchParam(u, 'q'); }
  2374.                     _deleteSearchParam(u, 'as_filetype');
  2375.                     _navigateTo(u);
  2376.                 } catch (e) {
  2377.                     NotificationManager.show('alert_error_applying_filter', { type: 'filetype', value: '(clear)' }, 'error', 5000);
  2378.                 }
  2379.             },
  2380.             isVerbatimActive: function() { try { const currentUrl = _getURLObject(); if (!currentUrl) return false; return /li:1/.test(currentUrl.searchParams.get('tbs') || ''); } catch (e) { console.warn(`${LOG_PREFIX} Error checking verbatim status:`, e); return false; }},
  2381.             applyDateRange: function(dateMinStr, dateMaxStr) { try { const url = _getURLObject(); if (!url) return; let dateTbsPart = 'cdr:1'; if (dateMinStr) { const [y, m, d] = dateMinStr.split('-'); dateTbsPart += `,cd_min:${m}/${d}/${y}`; } if (dateMaxStr) { const [y, m, d] = dateMaxStr.split('-'); dateTbsPart += `,cd_max:${m}/${d}/${y}`; } let tbsParts = _getTbsParts(url); let preservedTbsParts = tbsParts.filter(p => !p.startsWith('qdr:') && !p.startsWith('cdr:') && !p.startsWith('cd_min:') && !p.startsWith('cd_max:')); let newTbsParts = [...preservedTbsParts, dateTbsPart]; _setTbsParam(url, newTbsParts); _navigateTo(url); } catch (e) { NotificationManager.show('alert_error_applying_date', {}, 'error', 5000); }}
  2382.         };
  2383.     })();
  2384.  
  2385.     // --- Global Style Injection ---
  2386.     function addGlobalStyles() { if (typeof window.GSCS_Namespace !== 'undefined' && typeof window.GSCS_Namespace.stylesText === 'string') { const cleanedCSS = window.GSCS_Namespace.stylesText.replace(/\/\*[\s\S]*?\*\/|([^\\:]|^)\/\/.*$/gm, '$1').replace(/\n\s*\n/g, '\n'); GM_addStyle(cleanedCSS); } else { console.error(`${LOG_PREFIX} CRITICAL: CSS styles provider not found.`); if (typeof IDS !== 'undefined' && IDS.SIDEBAR) { GM_addStyle(`#${IDS.SIDEBAR} { border: 3px dashed red !important; padding: 15px !important; background: white !important; color: red !important; } #${IDS.SIDEBAR}::before { content: "Error: CSS Missing!"; }`);} } }
  2387.     // --- System Theme Listener ---
  2388.     function setupSystemThemeListener() { if (systemThemeMediaQuery && systemThemeMediaQuery._sidebarThemeListener) { try { systemThemeMediaQuery.removeEventListener('change', systemThemeMediaQuery._sidebarThemeListener); } catch (e) {} systemThemeMediaQuery._sidebarThemeListener = null; } if (window.matchMedia) { systemThemeMediaQuery = window.matchMedia('(prefers-color-scheme: dark)'); const listener = () => { const cs = SettingsManager.getCurrentSettings(); if (sidebar && cs.theme === 'system') { applyThemeToElement(sidebar, 'system'); } }; systemThemeMediaQuery.addEventListener('change', listener); systemThemeMediaQuery._sidebarThemeListener = listener; } }
  2389.     // --- Sidebar Skeleton and UI Building ---
  2390.     function buildSidebarSkeleton() { sidebar = document.createElement('div'); sidebar.id = IDS.SIDEBAR; const header = document.createElement('div'); header.classList.add(CSS.SIDEBAR_HEADER); const collapseBtn = document.createElement('button'); collapseBtn.id = IDS.COLLAPSE_BUTTON; collapseBtn.innerHTML = SVG_ICONS.chevronLeft; collapseBtn.title = _('sidebar_collapse_title'); const dragHandle = document.createElement('div'); dragHandle.classList.add(CSS.DRAG_HANDLE); dragHandle.title = _('sidebar_drag_title'); const settingsBtn = document.createElement('button'); settingsBtn.id = IDS.SETTINGS_BUTTON; settingsBtn.classList.add(CSS.SETTINGS_BUTTON); settingsBtn.innerHTML = SVG_ICONS.settings; settingsBtn.title = _('sidebar_settings_title'); header.appendChild(collapseBtn); header.appendChild(dragHandle); header.appendChild(settingsBtn); sidebar.appendChild(header); document.body.appendChild(sidebar); }
  2391.     function applySettings(settingsToApply) {
  2392.         if (!sidebar) return;
  2393.         const currentSettings = settingsToApply || SettingsManager.getCurrentSettings();
  2394.         let targetTop = currentSettings.sidebarPosition.top;
  2395.         targetTop = Math.max(MIN_SIDEBAR_TOP_POSITION, targetTop);
  2396.         sidebar.style.left = `${currentSettings.sidebarPosition.left}px`;
  2397.         sidebar.style.top = `${targetTop}px`;
  2398.         sidebar.style.setProperty('--sidebar-font-base-size', `${currentSettings.fontSize}px`);
  2399.         sidebar.style.setProperty('--sidebar-header-icon-base-size', `${currentSettings.headerIconSize}px`);
  2400.         sidebar.style.setProperty('--sidebar-spacing-multiplier', currentSettings.verticalSpacingMultiplier);
  2401.         if (!currentSettings.sidebarCollapsed) { sidebar.style.width = `${currentSettings.sidebarWidth}px`; }
  2402.         else { sidebar.style.width = '40px';}
  2403.         applyThemeToElement(sidebar, currentSettings.theme);
  2404.         if (sidebar._hoverListeners) { sidebar.removeEventListener('mouseenter', sidebar._hoverListeners.enter); sidebar.removeEventListener('mouseleave', sidebar._hoverListeners.leave); sidebar._hoverListeners = null; sidebar.style.opacity = '1';}
  2405.         if (currentSettings.hoverMode && !currentSettings.sidebarCollapsed) { const idleOpacityValue = currentSettings.idleOpacity; sidebar.style.opacity = idleOpacityValue.toString(); const enterL = () => { if (!currentSettings.sidebarCollapsed) sidebar.style.opacity = '1'; }; const leaveL = () => { if (!currentSettings.sidebarCollapsed) sidebar.style.opacity = idleOpacityValue.toString(); }; sidebar.addEventListener('mouseenter', enterL); sidebar.addEventListener('mouseleave', leaveL); sidebar._hoverListeners = { enter: enterL, leave: leaveL }; }
  2406.         else { sidebar.style.opacity = '1'; }
  2407.         applySidebarCollapseVisuals(currentSettings.sidebarCollapsed);
  2408.  
  2409.         // Apply Google Logo hiding logic
  2410.         const googleLogo = document.querySelector('#logo'); // Updated selector
  2411.         if (googleLogo) {
  2412.             if (currentSettings.hideGoogleLogoWhenExpanded && !currentSettings.sidebarCollapsed) {
  2413.                 googleLogo.style.visibility = 'hidden';
  2414.             } else {
  2415.                 googleLogo.style.visibility = 'visible';
  2416.             }
  2417.         }
  2418.     }
  2419.     function _parseTimeValueToMinutes(timeValue) { if (!timeValue || typeof timeValue !== 'string') return Infinity; const match = timeValue.match(/^([hdwmy])(\d*)$/i); if (!match) return Infinity; const unit = match[1].toLowerCase(); const number = parseInt(match[2] || '1', 10); if (isNaN(number)) return Infinity; switch (unit) { case 'h': return number * 60; case 'd': return number * 24 * 60; case 'w': return number * 7 * 24 * 60; case 'm': return number * 30 * 24 * 60; case 'y': return number * 365 * 24 * 60; default: return Infinity; } }
  2420.  
  2421.     function _prepareFilterOptions(sectionId, scriptDefinedOptions, currentSettings, predefinedOptionsSource) {
  2422.         const finalOptions = [];
  2423.         const tempAddedValues = new Set(); // To track values already added to finalOptions
  2424.         const sectionDef = ALL_SECTION_DEFINITIONS.find(s => s.id === sectionId);
  2425.         if (!sectionDef) return [];
  2426.  
  2427.         const isSortableMixedType = sectionDef.displayItemsKey && Array.isArray(currentSettings[sectionDef.displayItemsKey]);
  2428.         const isFiletypeCheckboxModeActive = sectionId === 'sidebar-section-filetype' && currentSettings.enableFiletypeCheckboxMode;
  2429.         const isSiteCheckboxModeActive = sectionId === 'sidebar-section-site-search' && currentSettings.enableSiteSearchCheckboxMode;
  2430.         const isOccurrenceSection = sectionId === 'sidebar-section-occurrence';
  2431.  
  2432.         // 1. Add "Any" type script-defined options or all script-defined for occurrence
  2433.         if (scriptDefinedOptions) {
  2434.             scriptDefinedOptions.forEach(opt => {
  2435.                 if (opt && typeof opt.textKey === 'string' && typeof opt.v === 'string') {
  2436.                     if (isOccurrenceSection) { // For occurrence, add all scriptDefined options in their defined order
  2437.                         const translatedText = _(opt.textKey);
  2438.                         finalOptions.push({ text: translatedText, value: opt.v, originalText: translatedText, isCustom: false, isAnyOption: (opt.v === '') });
  2439.                         tempAddedValues.add(opt.v);
  2440.                     } else if (opt.v === '') { // For other sections, only add "Any" option here
  2441.                         if (!((isFiletypeCheckboxModeActive && sectionId === 'sidebar-section-filetype') ||
  2442.                               (isSiteCheckboxModeActive && sectionId === 'sidebar-section-site-search'))) {
  2443.                             const translatedText = (sectionId === 'sidebar-section-site-search') ? _('filter_any_site') : _(opt.textKey);
  2444.                             finalOptions.push({ text: translatedText, value: opt.v, originalText: translatedText, isCustom: false, isAnyOption: true });
  2445.                             tempAddedValues.add(opt.v);
  2446.                         }
  2447.                     }
  2448.                 }
  2449.             });
  2450.         }
  2451.         if (isOccurrenceSection) return finalOptions; // Occurrence section is fully prepared now
  2452.  
  2453.  
  2454.         if (isSortableMixedType) { // For Language, Country (options come from displayLanguages/displayCountries)
  2455.             const displayItems = currentSettings[sectionDef.displayItemsKey] || [];
  2456.             displayItems.forEach(item => {
  2457.                 if (!tempAddedValues.has(item.value)) {
  2458.                     let displayText = item.text;
  2459.                     if (item.type === 'predefined' && item.originalKey) {
  2460.                         displayText = _(item.originalKey);
  2461.                         if (sectionId === 'sidebar-section-country') {
  2462.                             const parsed = Utils.parseIconAndText(displayText);
  2463.                             displayText = `${parsed.icon} ${parsed.text}`.trim();
  2464.                         }
  2465.                     }
  2466.                     finalOptions.push({ text: displayText, value: item.value, originalText: displayText, isCustom: item.type === 'custom' });
  2467.                     tempAddedValues.add(item.value);
  2468.                 }
  2469.             });
  2470.         } else { // For Time, Filetype (if not checkbox mode)
  2471.             const predefinedKey = sectionDef.predefinedOptionsKey;
  2472.             const customKey = sectionDef.customItemsKey;
  2473.             const predefinedOptsFromSource = predefinedOptionsSource && predefinedKey ? (predefinedOptionsSource[predefinedKey] || []) : [];
  2474.             const customOptsFromSettings = customKey ? (currentSettings[customKey] || []) : [];
  2475.             let enabledPredefinedSystemVals;
  2476.  
  2477.             if (isFiletypeCheckboxModeActive && sectionId === 'sidebar-section-filetype') {
  2478.                 enabledPredefinedSystemVals = currentSettings.enabledPredefinedOptions[predefinedKey] || [];
  2479.             } else {
  2480.                 enabledPredefinedSystemVals = predefinedKey ? (currentSettings.enabledPredefinedOptions[predefinedKey] || []) : [];
  2481.             }
  2482.  
  2483.             const itemsForThisSection = [];
  2484.             const enabledSet = new Set(enabledPredefinedSystemVals);
  2485.  
  2486.             if (Array.isArray(predefinedOptsFromSource)) {
  2487.                 predefinedOptsFromSource.forEach(opt => {
  2488.                     if (opt && typeof opt.textKey === 'string' && typeof opt.value === 'string' && enabledSet.has(opt.value) && !tempAddedValues.has(opt.value)) {
  2489.                         const translatedText = _(opt.textKey);
  2490.                         itemsForThisSection.push({ text: translatedText, value: opt.value, originalText: translatedText, isCustom: false });
  2491.                     }
  2492.                 });
  2493.             }
  2494.  
  2495.             const validCustomOptions = Array.isArray(customOptsFromSettings) ? customOptsFromSettings.filter(cOpt => cOpt && typeof cOpt.text === 'string' && typeof cOpt.value === 'string') : [];
  2496.             validCustomOptions.forEach(opt => {
  2497.                 if (!tempAddedValues.has(opt.value)){
  2498.                     itemsForThisSection.push({ text: opt.text, value: opt.value, originalText: opt.text, isCustom: true });
  2499.                 }
  2500.             });
  2501.  
  2502.             itemsForThisSection.forEach(opt => {
  2503.                  if (!tempAddedValues.has(opt.value)){
  2504.                     finalOptions.push(opt);
  2505.                     tempAddedValues.add(opt.value);
  2506.                 }
  2507.             });
  2508.         }
  2509.  
  2510.         if (scriptDefinedOptions && !isOccurrenceSection) { // Add other non-empty script-defined if not occurrence
  2511.             scriptDefinedOptions.forEach(opt => {
  2512.                 if (opt && typeof opt.textKey === 'string' && typeof opt.v === 'string' && opt.v !== '' && !tempAddedValues.has(opt.v)) {
  2513.                     const translatedText = _(opt.textKey);
  2514.                     finalOptions.push({ text: translatedText, value: opt.v, originalText: translatedText, isCustom: false });
  2515.                     tempAddedValues.add(opt.v);
  2516.                 }
  2517.             });
  2518.         }
  2519.  
  2520.         // Sorting logic, skip for occurrence (already ordered) and mixed types
  2521.         if (!isSortableMixedType && !isOccurrenceSection) {
  2522.             let anyOptionToSortSeparately = null;
  2523.             const anyOptionIdx = finalOptions.findIndex(opt => opt.isAnyOption === true);
  2524.  
  2525.             if (anyOptionIdx !== -1) {
  2526.                 anyOptionToSortSeparately = finalOptions.splice(anyOptionIdx, 1)[0];
  2527.             }
  2528.  
  2529.             finalOptions.sort((a, b) => {
  2530.                 const isTimeSection = (sectionId === 'sidebar-section-time');
  2531.                 if (isTimeSection) {
  2532.                     const timeA = _parseTimeValueToMinutes(a.value);
  2533.                     const timeB = _parseTimeValueToMinutes(b.value);
  2534.                     if (timeA !== Infinity || timeB !== Infinity) {
  2535.                         if (timeA !== timeB) return timeA - timeB;
  2536.                     }
  2537.                 }
  2538.                 const sTA = a.originalText || a.text;
  2539.                 const sTB = b.originalText || b.text;
  2540.                 const sL = LocalizationService.getCurrentLocale() === 'en' ? undefined : LocalizationService.getCurrentLocale();
  2541.                 return sTA.localeCompare(sTB, sL, { numeric: true, sensitivity: 'base' });
  2542.             });
  2543.  
  2544.             if (anyOptionToSortSeparately) {
  2545.                 finalOptions.unshift(anyOptionToSortSeparately);
  2546.             }
  2547.         }
  2548.         return finalOptions;
  2549.     }
  2550.     function _createFilterOptionElement(optionData, filterParam, isCountrySection, countryDisplayMode) { const optionElement = document.createElement('div'); optionElement.classList.add(CSS.FILTER_OPTION); const displayText = optionData.text; if (isCountrySection) { const { icon, text: countryTextOnly } = Utils.parseIconAndText(displayText); switch (countryDisplayMode) { case 'textOnly': optionElement.textContent = countryTextOnly || displayText; break; case 'iconOnly': if (icon) { optionElement.innerHTML = `<span class="country-icon-container">${icon}</span>`; } else { optionElement.textContent = countryTextOnly || displayText; } break; case 'iconAndText': default: if (icon) { const textPart = countryTextOnly || displayText.substring(icon.length).trim(); optionElement.innerHTML = `<span class="country-icon-container">${icon}</span>${textPart}`; } else { optionElement.textContent = displayText; } break; } } else { optionElement.textContent = displayText; } optionElement.title = `${displayText} (${filterParam}=${optionData.value || _('filter_clear_tooltip_suffix')})`; optionElement.dataset[DATA_ATTR.FILTER_TYPE] = filterParam; optionElement.dataset[DATA_ATTR.FILTER_VALUE] = optionData.value; return optionElement; }
  2551.     function buildSidebarUI() { if (!sidebar) { console.error("Sidebar element not ready for buildSidebarUI"); return; } const currentSettings = SettingsManager.getCurrentSettings(); const header = sidebar.querySelector(`.${CSS.SIDEBAR_HEADER}`); if (!header) { console.error("Sidebar header not found in buildSidebarUI"); return; } sidebar.querySelectorAll(`#${IDS.FIXED_TOP_BUTTONS}, .${CSS.SIDEBAR_CONTENT_WRAPPER}`).forEach(el => el.remove()); header.querySelectorAll(`.${CSS.HEADER_BUTTON}:not(#${IDS.SETTINGS_BUTTON}):not(#${IDS.COLLAPSE_BUTTON}), a.${CSS.HEADER_BUTTON}`).forEach(el => el.remove()); const rBL = currentSettings.resetButtonLocation; const vBL = currentSettings.verbatimButtonLocation; const aSL = currentSettings.advancedSearchLinkLocation; const pznBL = currentSettings.personalizationButtonLocation; const schL = currentSettings.googleScholarShortcutLocation; const trnL = currentSettings.googleTrendsShortcutLocation; const dsL = currentSettings.googleDatasetSearchShortcutLocation; const settingsButtonRef = header.querySelector(`#${IDS.SETTINGS_BUTTON}`); _buildSidebarHeaderControls(header, settingsButtonRef, rBL, vBL, aSL, pznBL, schL, trnL, dsL, _createAdvancedSearchElementHTML, _createPersonalizationButtonHTML, _createScholarShortcutHTML, _createTrendsShortcutHTML, _createDatasetSearchShortcutHTML, currentSettings); const fixedTopControlsContainer = _buildSidebarFixedTopControls(rBL, vBL, aSL, pznBL, schL, trnL, dsL, _createAdvancedSearchElementHTML, _createPersonalizationButtonHTML, _createScholarShortcutHTML, _createTrendsShortcutHTML, _createDatasetSearchShortcutHTML, currentSettings); if (fixedTopControlsContainer) { header.after(fixedTopControlsContainer); } const contentWrapper = document.createElement('div'); contentWrapper.classList.add(CSS.SIDEBAR_CONTENT_WRAPPER); const sectionDefinitionsMap = new Map(ALL_SECTION_DEFINITIONS.map(def => [def.id, def])); const sectionsFragment = _buildSidebarSections(sectionDefinitionsMap, rBL, vBL, aSL, pznBL, schL, trnL, dsL, _createAdvancedSearchElementHTML, _createPersonalizationButtonHTML, _createScholarShortcutHTML, _createTrendsShortcutHTML, _createDatasetSearchShortcutHTML, currentSettings, PREDEFINED_OPTIONS); contentWrapper.appendChild(sectionsFragment); sidebar.appendChild(contentWrapper); _initializeSidebarEventListenersAndStates(); }
  2552.     function _buildSidebarSections(sectionDefinitionMap, rBL, vBL, aSL, pznBL, schL, trnL, dsL, advSearchFn, personalizeBtnFn, scholarFn, trendsFn, datasetSearchFn, currentSettings, PREDEFINED_OPTIONS_REF) { const contentFragment = document.createDocumentFragment(); currentSettings.sidebarSectionOrder.forEach(sectionId => { if (!currentSettings.visibleSections[sectionId]) return; const sectionData = sectionDefinitionMap.get(sectionId); if (!sectionData) { console.warn(`${LOG_PREFIX} No definition for section ID: ${sectionId}`); return; } let sectionElement = null; const sectionTitleKey = sectionData.titleKey; const sectionIdForDisplay = sectionData.id; switch (sectionData.type) { case 'filter': sectionElement = createFilterSection(sectionIdForDisplay, sectionTitleKey, sectionData.scriptDefined, sectionData.param, currentSettings, PREDEFINED_OPTIONS_REF, currentSettings.countryDisplayMode); break; case 'filetype': sectionElement = _createFiletypeSectionElement(sectionIdForDisplay, sectionTitleKey, sectionData.scriptDefined, sectionData.param, currentSettings, PREDEFINED_OPTIONS_REF); break; case 'date': sectionElement = _createDateSectionElement(sectionIdForDisplay, sectionTitleKey); break; case 'site': sectionElement = _createSiteSearchSectionElement(sectionIdForDisplay, sectionTitleKey, currentSettings); break; case 'tools': sectionElement = _createToolsSectionElement( sectionIdForDisplay, sectionTitleKey, rBL, vBL, aSL, pznBL, schL, trnL, dsL, advSearchFn, personalizeBtnFn, scholarFn, trendsFn, datasetSearchFn ); break; default: console.warn(`${LOG_PREFIX} Unknown section type: ${sectionData.type} for ID: ${sectionIdForDisplay}`); break; } if (sectionElement) contentFragment.appendChild(sectionElement); }); return contentFragment; }
  2553.     function createFilterSection(id, titleKey, scriptDefinedOptions, filterParam, currentSettings, predefinedOptionsSource, countryDisplayMode) { if (!sidebar) return null; const { section, sectionContent, sectionTitle } = _createSectionShell(id, titleKey); sectionTitle.textContent = _(titleKey); const fragment = document.createDocumentFragment(); const isCountrySection = (id === 'sidebar-section-country'); const combinedOptions = _prepareFilterOptions(id, scriptDefinedOptions, currentSettings, predefinedOptionsSource); combinedOptions.forEach(option => { fragment.appendChild(_createFilterOptionElement(option, filterParam, isCountrySection, countryDisplayMode)); }); sectionContent.innerHTML = ''; sectionContent.appendChild(fragment); if (!sectionContent.dataset.filterClickListenerAttached) { sectionContent.addEventListener('click', function(event) { const target = event.target.closest(`.${CSS.FILTER_OPTION}`); if (target && target.classList.contains(CSS.FILTER_OPTION)) { event.preventDefault(); const clickedFilterType = target.dataset[DATA_ATTR.FILTER_TYPE]; const clickedFilterValue = target.dataset[DATA_ATTR.FILTER_VALUE]; if (typeof clickedFilterType !== 'undefined' && typeof clickedFilterValue !== 'undefined') { this.querySelectorAll(`.${CSS.FILTER_OPTION}`).forEach(opt => opt.classList.remove(CSS.SELECTED)); target.classList.add(CSS.SELECTED); if (clickedFilterValue === '' || (clickedFilterType === 'as_occt' && clickedFilterValue === 'any') ) { const defaultVal = (clickedFilterType === 'as_occt') ? 'any' : ''; const anyOpt = this.querySelector(`.${CSS.FILTER_OPTION}[data-${DATA_ATTR.FILTER_VALUE}="${defaultVal}"]`); if (anyOpt) anyOpt.classList.add(CSS.SELECTED); } URLActionManager.applyFilter(clickedFilterType, clickedFilterValue); } } }); sectionContent.dataset.filterClickListenerAttached = 'true'; } return section; }
  2554.  
  2555.     function _createSiteSearchSectionElement(sectionId, titleKey, currentSettings) {
  2556.         const { section, sectionContent, sectionTitle } = _createSectionShell(sectionId, titleKey);
  2557.         sectionTitle.textContent = _(titleKey);
  2558.         populateSiteSearchList(sectionContent, currentSettings.favoriteSites, currentSettings.enableSiteSearchCheckboxMode, currentSettings.showFaviconsForSiteSearch);
  2559.         return section;
  2560.     }
  2561.  
  2562.     function populateSiteSearchList(sectionContentElement, favoriteSitesArray, checkboxModeEnabled, showFaviconsEnabled) {
  2563.         if (!sectionContentElement) { console.error("Site search section content element missing"); return; }
  2564.         sectionContentElement.innerHTML = ''; // Clear previous content
  2565.  
  2566.         const sites = Array.isArray(favoriteSitesArray) ? favoriteSitesArray : [];
  2567.         const listFragment = document.createDocumentFragment(); // For LIs
  2568.  
  2569.         // "Any Site" option (always a div, not part of UL)
  2570.         const clearOptDiv = document.createElement('div');
  2571.         clearOptDiv.classList.add(CSS.FILTER_OPTION);
  2572.         clearOptDiv.id = IDS.CLEAR_SITE_SEARCH_OPTION;
  2573.         clearOptDiv.title = _('tooltip_clear_site_search');
  2574.         clearOptDiv.textContent = _('filter_any_site');
  2575.         clearOptDiv.dataset[DATA_ATTR.FILTER_TYPE] = 'site_clear'; // Special type for click handler
  2576.         sectionContentElement.appendChild(clearOptDiv);
  2577.  
  2578.         const listElement = document.createElement('ul');
  2579.         listElement.classList.add(CSS.CUSTOM_LIST);
  2580.         if (checkboxModeEnabled) {
  2581.             listElement.classList.add('checkbox-mode-enabled');
  2582.         }
  2583.  
  2584.         sites.forEach((site, index) => {
  2585.             if (site?.text && site?.url) {
  2586.                 const li = document.createElement('li');
  2587.                 const siteValue = site.url; // Can be "site.com" or "site.com OR example.org"
  2588.  
  2589. const isGroup = siteValue.includes(' OR ');
  2590.  
  2591. if (checkboxModeEnabled) {
  2592.     const checkbox = document.createElement('input');
  2593.     const uniqueId = `site-cb-${index}-${Date.now()}`;
  2594.     checkbox.id = uniqueId;
  2595.     checkbox.type = 'checkbox';
  2596.     checkbox.value = siteValue;
  2597.     checkbox.classList.add(CSS.SITE_SEARCH_ITEM_CHECKBOX);
  2598.     checkbox.dataset[DATA_ATTR.SITE_URL] = siteValue;
  2599.     li.appendChild(checkbox);
  2600.  
  2601.     const label = document.createElement('label');
  2602.     label.htmlFor = uniqueId;
  2603.     if (showFaviconsEnabled && !isGroup) {
  2604.         const favicon = document.createElement('img');
  2605.         favicon.src = `https://www.google.com/s2/favicons?sz=32&domain_url=${siteValue}`;
  2606.         favicon.classList.add(CSS.FAVICON);
  2607.         favicon.loading = 'lazy';
  2608.         label.appendChild(favicon);
  2609.     }
  2610.     label.appendChild(document.createTextNode(site.text));
  2611.     label.dataset[DATA_ATTR.SITE_URL] = siteValue;
  2612.     label.title = _('tooltip_site_search', { siteUrl: siteValue.replace(/\s+OR\s+/gi, ', ') });
  2613.     li.appendChild(label);
  2614. } else {
  2615.     const divOpt = document.createElement('div');
  2616.     divOpt.classList.add(CSS.FILTER_OPTION);
  2617.     if (showFaviconsEnabled && !isGroup) {
  2618.         const favicon = document.createElement('img');
  2619.         favicon.src = `https://www.google.com/s2/favicons?sz=32&domain_url=${siteValue}`;
  2620.         favicon.classList.add(CSS.FAVICON);
  2621.         favicon.loading = 'lazy';
  2622.         divOpt.appendChild(favicon);
  2623.     }
  2624.     divOpt.appendChild(document.createTextNode(site.text));
  2625.     divOpt.dataset[DATA_ATTR.SITE_URL] = siteValue;
  2626.     divOpt.title = _('tooltip_site_search', { siteUrl: siteValue.replace(/\s+OR\s+/gi, ', ') });
  2627.     li.appendChild(divOpt);
  2628. }
  2629.  
  2630.                 listFragment.appendChild(li);
  2631.             }
  2632.         });
  2633.         listElement.appendChild(listFragment);
  2634.         sectionContentElement.appendChild(listElement);
  2635.  
  2636.         if (checkboxModeEnabled) {
  2637.             let applyButton = sectionContentElement.querySelector(`#${IDS.APPLY_SELECTED_SITES_BUTTON}`);
  2638.             if (!applyButton) {
  2639.                 applyButton = document.createElement('button');
  2640.                 applyButton.id = IDS.APPLY_SELECTED_SITES_BUTTON;
  2641.                 applyButton.classList.add(CSS.TOOL_BUTTON, CSS.APPLY_SITES_BUTTON);
  2642.                 applyButton.textContent = _('tool_apply_selected_sites');
  2643.                 sectionContentElement.appendChild(applyButton);
  2644.             }
  2645.             applyButton.disabled = true; // Initially disabled
  2646.             applyButton.style.display = 'none'; // Initially hidden
  2647.         }
  2648. 		
  2649.         // Attach event listener if not already attached
  2650.         if (!sectionContentElement.dataset.siteSearchClickListenerAttached) {
  2651.             sectionContentElement.dataset.siteSearchClickListenerAttached = 'true';
  2652.             sectionContentElement.addEventListener('click', (event) => {
  2653.                 const target = event.target;
  2654.                 const currentSettings = SettingsManager.getCurrentSettings(); // Get current settings
  2655.                 const isCheckboxMode = currentSettings.enableSiteSearchCheckboxMode;
  2656.                 const clearSiteOpt = target.closest(`#${IDS.CLEAR_SITE_SEARCH_OPTION}`);
  2657.  
  2658.                 if (clearSiteOpt) {
  2659.                     URLActionManager.clearSiteSearch();
  2660.                     // Update UI: deselect all, select "Any Site"
  2661.                     sectionContentElement.querySelectorAll(`.${CSS.FILTER_OPTION}.${CSS.SELECTED}, label.${CSS.SELECTED}`).forEach(o => o.classList.remove(CSS.SELECTED));
  2662.                     clearSiteOpt.classList.add(CSS.SELECTED);
  2663.                     if (isCheckboxMode) {
  2664.                         sectionContentElement.querySelectorAll(`input[type="checkbox"].${CSS.SITE_SEARCH_ITEM_CHECKBOX}`).forEach(cb => cb.checked = false);
  2665.                         _updateApplySitesButtonState(sectionContentElement);
  2666.                     }
  2667.                 } else if (isCheckboxMode) {
  2668.                     const labelElement = target.closest('label');
  2669.                     if (labelElement && labelElement.dataset[DATA_ATTR.SITE_URL]) {
  2670.                         event.preventDefault(); // Prevent default label behavior which might toggle checkbox twice
  2671.                         const siteUrlOrCombined = labelElement.dataset[DATA_ATTR.SITE_URL];
  2672.                         // Single-select behavior when clicking a label in checkbox mode
  2673.                         sectionContentElement.querySelectorAll(`input[type="checkbox"].${CSS.SITE_SEARCH_ITEM_CHECKBOX}`).forEach(cb => {
  2674.                             const correspondingLabel = sectionContentElement.querySelector(`label[for="${cb.id}"]`);
  2675.                             cb.checked = (cb.value === siteUrlOrCombined); // Check only the clicked one
  2676.                             if(correspondingLabel) correspondingLabel.classList.toggle(CSS.SELECTED, cb.checked);
  2677.                         });
  2678.                         URLActionManager.applySiteSearch(siteUrlOrCombined);
  2679.                         _updateApplySitesButtonState(sectionContentElement); // Update button based on single selection
  2680.                         sectionContentElement.querySelector(`#${IDS.CLEAR_SITE_SEARCH_OPTION}`)?.classList.remove(CSS.SELECTED);
  2681.                     }
  2682.                 } else { // Not checkbox mode, or click was not on a label in checkbox mode
  2683.                     const siteOptionDiv = target.closest(`div.${CSS.FILTER_OPTION}:not(#${IDS.CLEAR_SITE_SEARCH_OPTION})`);
  2684.                     if (siteOptionDiv && siteOptionDiv.dataset[DATA_ATTR.SITE_URL]) {
  2685.                         const siteUrlOrCombined = siteOptionDiv.dataset[DATA_ATTR.SITE_URL];
  2686.                         sectionContentElement.querySelectorAll(`.${CSS.FILTER_OPTION}.${CSS.SELECTED}`).forEach(o => o.classList.remove(CSS.SELECTED));
  2687.                         URLActionManager.applySiteSearch(siteUrlOrCombined);
  2688.                         siteOptionDiv.classList.add(CSS.SELECTED);
  2689.                         sectionContentElement.querySelector(`#${IDS.CLEAR_SITE_SEARCH_OPTION}`)?.classList.remove(CSS.SELECTED);
  2690.                     }
  2691.                 }
  2692.             });
  2693.  
  2694.             // Change listener for checkboxes in checkbox mode
  2695.             if (checkboxModeEnabled) {
  2696.                 sectionContentElement.addEventListener('change', (event) => {
  2697.                     if (event.target.matches(`input[type="checkbox"].${CSS.SITE_SEARCH_ITEM_CHECKBOX}`)) {
  2698.                         _updateApplySitesButtonState(sectionContentElement); // Update button visibility/state
  2699.                         const label = sectionContentElement.querySelector(`label[for="${event.target.id}"]`);
  2700.                         if (label) label.classList.toggle(CSS.SELECTED, event.target.checked);
  2701.                         if (event.target.checked) { // If any checkbox is checked, "Any Site" is no longer selected
  2702.                             sectionContentElement.querySelector(`#${IDS.CLEAR_SITE_SEARCH_OPTION}`)?.classList.remove(CSS.SELECTED);
  2703.                         }
  2704.                     }
  2705.                 });
  2706.                 // Listener for the "Apply Selected Sites" button
  2707.                 const applyBtn = sectionContentElement.querySelector(`#${IDS.APPLY_SELECTED_SITES_BUTTON}`);
  2708.                 if(applyBtn && !applyBtn.dataset[DATA_ATTR.LISTENER_ATTACHED]){
  2709.                     applyBtn.dataset[DATA_ATTR.LISTENER_ATTACHED] = 'true';
  2710.                     applyBtn.addEventListener('click', () => {
  2711.                         const selectedValuesFromCheckboxes = [];
  2712.                         sectionContentElement.querySelectorAll(`input[type="checkbox"].${CSS.SITE_SEARCH_ITEM_CHECKBOX}:checked`).forEach(cb => {
  2713.                             selectedValuesFromCheckboxes.push(cb.value); // cb.value contains the site URL or combined "OR" string
  2714.                         });
  2715.                         if (selectedValuesFromCheckboxes.length > 0) {
  2716.                             URLActionManager.applySiteSearch(selectedValuesFromCheckboxes);
  2717.                             sectionContentElement.querySelector(`#${IDS.CLEAR_SITE_SEARCH_OPTION}`)?.classList.remove(CSS.SELECTED);
  2718.                         }
  2719.                     });
  2720.                 }
  2721.             }
  2722.         }
  2723.     }
  2724.  
  2725.     function _createFiletypeSectionElement(sectionId, titleKey, scriptDefinedOptions, filterParam, currentSettings, predefinedOptionsSource) {
  2726.         const { section, sectionContent, sectionTitle } = _createSectionShell(sectionId, titleKey);
  2727.         sectionTitle.textContent = _(titleKey);
  2728.         populateFiletypeList(sectionContent, scriptDefinedOptions, currentSettings, predefinedOptionsSource, filterParam);
  2729.         return section;
  2730.     }
  2731.  
  2732.     function populateFiletypeList(sectionContentElement, scriptDefinedOpts, currentSettings, predefinedOptsSource, filterParam) {
  2733.         if (!sectionContentElement) { console.error("Filetype section content element missing"); return; }
  2734.         sectionContentElement.innerHTML = ''; // Clear previous content
  2735.  
  2736.         const checkboxModeEnabled = currentSettings.enableFiletypeCheckboxMode;
  2737.         // Get all options (script-defined "Any", enabled predefined, custom)
  2738.         const combinedOptions = _prepareFilterOptions('sidebar-section-filetype', scriptDefinedOpts, currentSettings, predefinedOptsSource);
  2739.         const listFragment = document.createDocumentFragment(); // For LIs
  2740.  
  2741.         // "Any Format" option (always a div, not part of UL)
  2742.         const clearOptDiv = document.createElement('div');
  2743.         clearOptDiv.classList.add(CSS.FILTER_OPTION);
  2744.         clearOptDiv.id = IDS.CLEAR_FILETYPE_SEARCH_OPTION;
  2745.         clearOptDiv.title = _('filter_clear_tooltip_suffix'); // Generic clear tooltip
  2746.         clearOptDiv.textContent = _('filter_any_format');
  2747.         clearOptDiv.dataset[DATA_ATTR.FILTER_TYPE] = 'filetype_clear'; // Special type for click handler
  2748.         sectionContentElement.appendChild(clearOptDiv);
  2749.  
  2750.         const listElement = document.createElement('ul');
  2751.         listElement.classList.add(CSS.CUSTOM_LIST);
  2752.         if (checkboxModeEnabled) {
  2753.             listElement.classList.add('checkbox-mode-enabled');
  2754.         }
  2755.  
  2756.         combinedOptions.forEach((option, index) => {
  2757.             if (option.isAnyOption) return; // "Any Format" is handled by the div above
  2758.  
  2759.             const li = document.createElement('li');
  2760.             const filetypeValue = option.value; // Can be single "pdf" or combined "pdf OR docx"
  2761.  
  2762.             if (checkboxModeEnabled) {
  2763.                 const checkbox = document.createElement('input');
  2764.                 checkbox.type = 'checkbox';
  2765.                 checkbox.id = `ft-cb-${index}-${Date.now()}`; // Unique ID
  2766.                 checkbox.value = filetypeValue;
  2767.                 checkbox.classList.add(CSS.FILETYPE_SEARCH_ITEM_CHECKBOX);
  2768.                 checkbox.dataset[DATA_ATTR.FILETYPE_VALUE] = filetypeValue;
  2769.                 li.appendChild(checkbox);
  2770.  
  2771.                 const label = document.createElement('label');
  2772.                 label.htmlFor = checkbox.id; // Match checkbox ID
  2773.                 label.dataset[DATA_ATTR.FILETYPE_VALUE] = filetypeValue;
  2774.                 label.title = `${option.text} (${filterParam}=${filetypeValue.replace(/\s+OR\s+/gi, ', ')})`;
  2775.                 label.textContent = option.text;
  2776.                 li.appendChild(label);
  2777.             } else { // Radio-button like behavior with divs
  2778.                 const divOpt = document.createElement('div');
  2779.                 divOpt.classList.add(CSS.FILTER_OPTION);
  2780.                 divOpt.dataset[DATA_ATTR.FILTER_TYPE] = filterParam; // e.g., "as_filetype"
  2781.                 divOpt.dataset[DATA_ATTR.FILTER_VALUE] = filetypeValue;
  2782.                 divOpt.title = `${option.text} (${filterParam}=${filetypeValue.replace(/\s+OR\s+/gi, ', ')})`;
  2783.                 divOpt.textContent = option.text;
  2784.                 li.appendChild(divOpt);
  2785.             }
  2786.             listFragment.appendChild(li);
  2787.         });
  2788.         listElement.appendChild(listFragment);
  2789.         sectionContentElement.appendChild(listElement);
  2790.  
  2791.         if (checkboxModeEnabled) {
  2792.             let applyButton = sectionContentElement.querySelector(`#${IDS.APPLY_SELECTED_FILETYPES_BUTTON}`);
  2793.             if(!applyButton) { // Create if doesn't exist
  2794.                 applyButton = document.createElement('button');
  2795.                 applyButton.id = IDS.APPLY_SELECTED_FILETYPES_BUTTON;
  2796.                 applyButton.classList.add(CSS.TOOL_BUTTON, CSS.APPLY_FILETYPES_BUTTON);
  2797.                 applyButton.textContent = _('tool_apply_selected_filetypes');
  2798.                 sectionContentElement.appendChild(applyButton);
  2799.             }
  2800.             applyButton.disabled = true; // Initially disabled
  2801.             applyButton.style.display = 'none'; // Initially hidden
  2802.         }
  2803.  
  2804.         // Attach event listener if not already attached
  2805.         if (!sectionContentElement.dataset.filetypeClickListenerAttached) {
  2806.             sectionContentElement.dataset.filetypeClickListenerAttached = 'true';
  2807.             sectionContentElement.addEventListener('click', (event) => {
  2808.                 const target = event.target;
  2809.                 const isCheckboxMode = SettingsManager.getCurrentSettings().enableFiletypeCheckboxMode;
  2810.                 const clearFiletypeOpt = target.closest(`#${IDS.CLEAR_FILETYPE_SEARCH_OPTION}`);
  2811.  
  2812.                 if (clearFiletypeOpt) {
  2813.                     URLActionManager.clearFiletypeSearch();
  2814.                     sectionContentElement.querySelectorAll(`.${CSS.FILTER_OPTION}.${CSS.SELECTED}, label.${CSS.SELECTED}`).forEach(o => o.classList.remove(CSS.SELECTED));
  2815.                     clearFiletypeOpt.classList.add(CSS.SELECTED);
  2816.                     if (isCheckboxMode) {
  2817.                         sectionContentElement.querySelectorAll(`input[type="checkbox"].${CSS.FILETYPE_SEARCH_ITEM_CHECKBOX}`).forEach(cb => cb.checked = false);
  2818.                         _updateApplyFiletypesButtonState(sectionContentElement);
  2819.                     }
  2820.                 } else if (isCheckboxMode) {
  2821.                     const labelElement = target.closest('label');
  2822.                     if (labelElement && labelElement.dataset[DATA_ATTR.FILETYPE_VALUE]) {
  2823.                         event.preventDefault();
  2824.                         const filetypeValueOrCombined = labelElement.dataset[DATA_ATTR.FILETYPE_VALUE];
  2825.                         // Single-select behavior when clicking a label in checkbox mode
  2826.                         sectionContentElement.querySelectorAll(`input[type="checkbox"].${CSS.FILETYPE_SEARCH_ITEM_CHECKBOX}`).forEach(cb => {
  2827.                             const correspondingLabel = sectionContentElement.querySelector(`label[for="${cb.id}"]`);
  2828.                             cb.checked = (cb.value === filetypeValueOrCombined);
  2829.                              if(correspondingLabel) correspondingLabel.classList.toggle(CSS.SELECTED, cb.checked);
  2830.                         });
  2831.                         URLActionManager.applyCombinedFiletypeSearch(filetypeValueOrCombined);
  2832.                         _updateApplyFiletypesButtonState(sectionContentElement);
  2833.                         sectionContentElement.querySelector(`#${IDS.CLEAR_FILETYPE_SEARCH_OPTION}`)?.classList.remove(CSS.SELECTED);
  2834.                     }
  2835.                 } else { // Not checkbox mode
  2836.                     const optionDiv = target.closest(`div.${CSS.FILTER_OPTION}:not(#${IDS.CLEAR_FILETYPE_SEARCH_OPTION})`);
  2837.                     if (optionDiv && optionDiv.dataset[DATA_ATTR.FILTER_VALUE]) {
  2838.                         const clickedFilterType = optionDiv.dataset[DATA_ATTR.FILTER_TYPE]; // Should be "as_filetype"
  2839.                         const clickedFilterValueOrCombined = optionDiv.dataset[DATA_ATTR.FILTER_VALUE];
  2840.                         sectionContentElement.querySelectorAll(`.${CSS.FILTER_OPTION}.${CSS.SELECTED}`).forEach(o => o.classList.remove(CSS.SELECTED));
  2841.                         optionDiv.classList.add(CSS.SELECTED);
  2842.                         URLActionManager.applyFilter(clickedFilterType, clickedFilterValueOrCombined); // applyFilter handles single or combined
  2843.                         sectionContentElement.querySelector(`#${IDS.CLEAR_FILETYPE_SEARCH_OPTION}`)?.classList.remove(CSS.SELECTED);
  2844.                     }
  2845.                 }
  2846.             });
  2847.  
  2848.             // Change listener for checkboxes in checkbox mode
  2849.             if (checkboxModeEnabled) {
  2850.                 sectionContentElement.addEventListener('change', (event) => {
  2851.                     if (event.target.matches(`input[type="checkbox"].${CSS.FILETYPE_SEARCH_ITEM_CHECKBOX}`)) {
  2852.                         _updateApplyFiletypesButtonState(sectionContentElement);
  2853.                         const label = sectionContentElement.querySelector(`label[for="${event.target.id}"]`);
  2854.                         if (label) label.classList.toggle(CSS.SELECTED, event.target.checked);
  2855.                         if (event.target.checked) {
  2856.                             sectionContentElement.querySelector(`#${IDS.CLEAR_FILETYPE_SEARCH_OPTION}`)?.classList.remove(CSS.SELECTED);
  2857.                         }
  2858.                     }
  2859.                 });
  2860.                 // Listener for the "Apply Selected" button
  2861.                 const applyBtn = sectionContentElement.querySelector(`#${IDS.APPLY_SELECTED_FILETYPES_BUTTON}`);
  2862.                 if (applyBtn && !applyBtn.dataset[DATA_ATTR.LISTENER_ATTACHED]) {
  2863.                     applyBtn.dataset[DATA_ATTR.LISTENER_ATTACHED] = 'true';
  2864.                     applyBtn.addEventListener('click', () => {
  2865.                         const selectedValuesFromCheckboxes = [];
  2866.                         sectionContentElement.querySelectorAll(`input[type="checkbox"].${CSS.FILETYPE_SEARCH_ITEM_CHECKBOX}:checked`).forEach(cb => {
  2867.                             selectedValuesFromCheckboxes.push(cb.value); // cb.value contains the filetype or combined "OR" string
  2868.                         });
  2869.                         if (selectedValuesFromCheckboxes.length > 0) {
  2870.                             URLActionManager.applyCombinedFiletypeSearch(selectedValuesFromCheckboxes);
  2871.                             sectionContentElement.querySelector(`#${IDS.CLEAR_FILETYPE_SEARCH_OPTION}`)?.classList.remove(CSS.SELECTED);
  2872.                         }
  2873.                     });
  2874.                 }
  2875.             }
  2876.         }
  2877.     }
  2878.  
  2879.     function _updateApplySitesButtonState(sectionContentElement) {
  2880.         if (!sectionContentElement) return;
  2881.         const applyButton = sectionContentElement.querySelector(`#${IDS.APPLY_SELECTED_SITES_BUTTON}`);
  2882.         if (!applyButton) return;
  2883.         const checkedCount = sectionContentElement.querySelectorAll(`input[type="checkbox"].${CSS.SITE_SEARCH_ITEM_CHECKBOX}:checked`).length;
  2884.         applyButton.disabled = checkedCount === 0;
  2885.         applyButton.style.display = checkedCount > 0 ? 'inline-flex' : 'none'; // Use inline-flex if that's how tool-buttons are displayed
  2886.     }
  2887.  
  2888.     function _updateApplyFiletypesButtonState(sectionContentElement) {
  2889.         if (!sectionContentElement) return;
  2890.         const applyButton = sectionContentElement.querySelector(`#${IDS.APPLY_SELECTED_FILETYPES_BUTTON}`);
  2891.         if (!applyButton) return;
  2892.         const checkedCount = sectionContentElement.querySelectorAll(`input[type="checkbox"].${CSS.FILETYPE_SEARCH_ITEM_CHECKBOX}:checked`).length;
  2893.         applyButton.disabled = checkedCount === 0;
  2894.         applyButton.style.display = checkedCount > 0 ? 'inline-flex' : 'none';
  2895.     }
  2896.  
  2897.     // Render the sortable list of sections in the settings UI
  2898.     function renderSectionOrderList(settingsRef) { const settingsWindowEl = document.getElementById(IDS.SETTINGS_WINDOW); const orderListElement = settingsWindowEl?.querySelector(`#${IDS.SIDEBAR_SECTION_ORDER_LIST}`); if (!orderListElement) return; orderListElement.innerHTML = ''; const currentSettings = settingsRef || SettingsManager.getCurrentSettings(); const visibleOrderedSections = currentSettings.sidebarSectionOrder.filter(id => currentSettings.visibleSections[id]); if (visibleOrderedSections.length === 0) { orderListElement.innerHTML = `<li><span style="font-style:italic;color:var(--settings-tab-color);">${_('settings_no_orderable_sections')}</span></li>`; return; } const fragment = document.createDocumentFragment(); visibleOrderedSections.forEach((sectionId) => { const definition = ALL_SECTION_DEFINITIONS.find(def => def.id === sectionId); const displayName = definition ? _(definition.titleKey) : sectionId; const listItem = document.createElement('li'); listItem.dataset.sectionId = sectionId; listItem.draggable = true; const dragIconSpan = document.createElement('span'); dragIconSpan.classList.add(CSS.DRAG_ICON); dragIconSpan.innerHTML = SVG_ICONS.dragGrip; listItem.appendChild(dragIconSpan); const nameSpan = document.createElement('span'); nameSpan.textContent = displayName; listItem.appendChild(nameSpan); fragment.appendChild(listItem); }); orderListElement.appendChild(fragment); }
  2899.     function _initMenuCommands() { if (typeof GM_registerMenuCommand === 'function') { const openSettingsText = _('menu_open_settings'); const resetAllText = _('menu_reset_all_settings'); if (typeof GM_unregisterMenuCommand === 'function') { try { GM_unregisterMenuCommand(openSettingsText); } catch (e) {} try { GM_unregisterMenuCommand(resetAllText);   } catch (e) {} } GM_registerMenuCommand(openSettingsText, SettingsManager.show.bind(SettingsManager)); GM_registerMenuCommand(resetAllText, SettingsManager.resetAllFromMenu.bind(SettingsManager)); } }
  2900.     function _createSectionShell(id, titleKey) { const section = document.createElement('div'); section.id = id; section.classList.add(CSS.SIDEBAR_SECTION); const sectionTitle = document.createElement('div'); sectionTitle.classList.add(CSS.SECTION_TITLE); sectionTitle.textContent = _(titleKey); section.appendChild(sectionTitle); const sectionContent = document.createElement('div'); sectionContent.classList.add(CSS.SECTION_CONTENT); section.appendChild(sectionContent); return { section, sectionContent, sectionTitle }; }
  2901.     function _createDateSectionElement(sectionId, titleKey) { const { section, sectionContent, sectionTitle } = _createSectionShell(sectionId, titleKey); sectionTitle.textContent = _(titleKey); const today = new Date(); const yyyy = today.getFullYear(); const mm = String(today.getMonth() + 1).padStart(2, '0'); const dd = String(today.getDate()).padStart(2, '0'); const todayString = `${yyyy}-${mm}-${dd}`; sectionContent.innerHTML = `<label class="${CSS.DATE_INPUT_LABEL}" for="${IDS.DATE_MIN}">${_('date_range_from')}</label>` + `<input type="date" class="${CSS.DATE_INPUT}" id="${IDS.DATE_MIN}" max="${todayString}">` + `<label class="${CSS.DATE_INPUT_LABEL}" for="${IDS.DATE_MAX}">${_('date_range_to')}</label>` + `<input type="date" class="${CSS.DATE_INPUT}" id="${IDS.DATE_MAX}" max="${todayString}">` + `<span id="${IDS.DATE_RANGE_ERROR_MSG}" class="${CSS.DATE_RANGE_ERROR_MSG} ${CSS.INPUT_ERROR_MESSAGE}"></span>` + `<button class="${CSS.TOOL_BUTTON} apply-date-range">${_('tool_apply_date')}</button>`; return section; }
  2902.     function _createStandardButton({ id = null, className, svgIcon, textContent = null, title, clickHandler, isActive = false }) { const button = document.createElement('button'); if (id) button.id = id; button.classList.add(className); if (isActive) button.classList.add(CSS.ACTIVE); button.title = title; let content = svgIcon || ''; if (textContent) { content = svgIcon ? `${svgIcon} ${textContent}` : textContent; } button.innerHTML = content.trim(); if (clickHandler) { if (!button.dataset[DATA_ATTR.LISTENER_ATTACHED]) { button.addEventListener('click', clickHandler); button.dataset[DATA_ATTR.LISTENER_ATTACHED] = 'true'; } } return button; }
  2903.     function _createPersonalizationButtonHTML(forLocation = 'tools') { const personalizationActive = URLActionManager.isPersonalizationActive(); const isIconOnlyLocation = (forLocation === 'header'); const svgIcon = SVG_ICONS.personalization || ''; const displayText = !isIconOnlyLocation ? _('tool_personalization_toggle') : ''; const titleKey = personalizationActive ? 'tooltip_toggle_personalization_off' : 'tooltip_toggle_personalization_on'; return _createStandardButton({ id: IDS.TOOL_PERSONALIZE, className: (forLocation === 'header') ? CSS.HEADER_BUTTON : CSS.TOOL_BUTTON, svgIcon: svgIcon, textContent: displayText, title: _(titleKey), clickHandler: () => URLActionManager.triggerTogglePersonalization(), isActive: personalizationActive }); }
  2904.     function _createAdvancedSearchElementHTML(isButtonLike = false) { const el = document.createElement('a'); let iconHTML = SVG_ICONS.magnifyingGlass || ''; if (isButtonLike) { el.classList.add(CSS.TOOL_BUTTON); el.innerHTML = `${iconHTML} ${_('tool_advanced_search')}`; } else { el.classList.add(CSS.HEADER_BUTTON); el.innerHTML = iconHTML; } const baseUrl = "https://www.google.com/advanced_search"; let finalUrl = baseUrl; try { const currentFullUrl = Utils.getCurrentURL(); if (currentFullUrl) { const currentQuery = currentFullUrl.searchParams.get('q'); if (currentQuery) { let queryWithoutSite = currentQuery.replace(/\s*(?:\(\s*)?(?:site:[\w.:\/~%?#=&+-]+(?:\s+OR\s+|$))+[^)]*\)?\s*/gi, ' '); queryWithoutSite = queryWithoutSite.replace(/\s*site:[\w.:\/~%?#=&+-]+\s*/gi, ' '); queryWithoutSite = queryWithoutSite.replace(/\s\s+/g, ' ').trim(); if (queryWithoutSite) { finalUrl = `${baseUrl}?as_q=${encodeURIComponent(queryWithoutSite)}`; } } } } catch (e) { console.warn(`${LOG_PREFIX} Error constructing advanced search URL with query:`, e); } el.href = finalUrl; el.target = "_blank"; el.rel = "noopener noreferrer"; el.title = _('link_advanced_search_title'); return el; }
  2905.     function _createScholarShortcutHTML(forLocation = 'tools') { const isIconOnlyLocation = (forLocation === 'header'); const svgIcon = SVG_ICONS.googleScholar || ''; const displayText = !isIconOnlyLocation ? _('tool_google_scholar') : ''; return _createStandardButton({ id: IDS.TOOL_GOOGLE_SCHOLAR, className: (forLocation === 'header') ? CSS.HEADER_BUTTON : CSS.TOOL_BUTTON, svgIcon: svgIcon, textContent: displayText, title: _('tooltip_google_scholar_search'), clickHandler: () => { try { const currentUrl = Utils.getCurrentURL(); if (currentUrl) { const query = currentUrl.searchParams.get('q'); if (query) { const scholarUrl = `https://scholar.google.com/scholar?q=${encodeURIComponent(query)}`; window.open(scholarUrl, '_blank'); } else { window.open('https://scholar.google.com/', '_blank'); NotificationManager.show('alert_no_keywords_for_shortcut', { service_name: _('service_name_google_scholar') }, 'info'); } } } catch (e) { console.error(`${LOG_PREFIX} Error opening Google Scholar:`, e); NotificationManager.show('alert_error_opening_link', { service_name: _('service_name_google_scholar') }, 'error'); } } }); }
  2906.     function _createTrendsShortcutHTML(forLocation = 'tools') { const isIconOnlyLocation = (forLocation === 'header'); const svgIcon = SVG_ICONS.googleTrends || ''; const displayText = !isIconOnlyLocation ? _('tool_google_trends') : ''; return _createStandardButton({ id: IDS.TOOL_GOOGLE_TRENDS, className: (forLocation === 'header') ? CSS.HEADER_BUTTON : CSS.TOOL_BUTTON, svgIcon: svgIcon, textContent: displayText, title: _('tooltip_google_trends_search'), clickHandler: () => { try { const currentUrl = Utils.getCurrentURL(); if (currentUrl) { const query = currentUrl.searchParams.get('q'); if (query) { const trendsUrl = `https://trends.google.com/trends/explore?q=${encodeURIComponent(query)}`; window.open(trendsUrl, '_blank'); } else { window.open('https://trends.google.com/trends/', '_blank'); NotificationManager.show('alert_no_keywords_for_shortcut', { service_name: _('service_name_google_trends') }, 'info'); } } } catch (e) { console.error(`${LOG_PREFIX} Error opening Google Trends:`, e); NotificationManager.show('alert_error_opening_link', { service_name: _('service_name_google_trends') }, 'error'); } } }); }
  2907.     function _createDatasetSearchShortcutHTML(forLocation = 'tools') { const isIconOnlyLocation = (forLocation === 'header'); const svgIcon = SVG_ICONS.googleDatasetSearch || ''; const displayText = !isIconOnlyLocation ? _('tool_google_dataset_search') : ''; return _createStandardButton({ id: IDS.TOOL_GOOGLE_DATASET_SEARCH, className: (forLocation === 'header') ? CSS.HEADER_BUTTON : CSS.TOOL_BUTTON, svgIcon: svgIcon, textContent: displayText, title: _('tooltip_google_dataset_search'), clickHandler: () => { try { const currentUrl = Utils.getCurrentURL(); if (currentUrl) { const query = currentUrl.searchParams.get('q'); if (query) { const datasetSearchUrl = `https://datasetsearch.research.google.com/search?query=${encodeURIComponent(query)}`; window.open(datasetSearchUrl, '_blank'); } else { window.open('https://datasetsearch.research.google.com/', '_blank'); NotificationManager.show('alert_no_keywords_for_shortcut', { service_name: _('service_name_google_dataset_search') }, 'info'); } } } catch (e) { console.error(`${LOG_PREFIX} Error opening Google Dataset Search:`, e); NotificationManager.show('alert_error_opening_link', { service_name: _('service_name_google_dataset_search') }, 'error'); } } }); }
  2908.     function _buildSidebarHeaderControls(headerEl, settingsBtnRef, rBL, vBL, aSL, pznBL, schL, trnL, dsL, advSearchFn, personalizeBtnFn, scholarFn, trendsFn, datasetSearchFn, settings) { const verbatimActive = URLActionManager.isVerbatimActive(); const buttonsInOrder = []; if (aSL === 'header' && advSearchFn && settings.advancedSearchLinkLocation !== 'none') { buttonsInOrder.push(advSearchFn(false)); } if (schL === 'header' && scholarFn && settings.googleScholarShortcutLocation !== 'none') { buttonsInOrder.push(scholarFn('header')); } if (trnL === 'header' && trendsFn && settings.googleTrendsShortcutLocation !== 'none') { buttonsInOrder.push(trendsFn('header')); } if (dsL === 'header' && datasetSearchFn && settings.googleDatasetSearchShortcutLocation !== 'none') { buttonsInOrder.push(datasetSearchFn('header')); } if (vBL === 'header' && settings.verbatimButtonLocation !== 'none') { buttonsInOrder.push(_createStandardButton({ id: IDS.TOOL_VERBATIM, className: CSS.HEADER_BUTTON, svgIcon: SVG_ICONS.verbatim, title: _('tool_verbatim_search'), clickHandler: URLActionManager.triggerToggleVerbatim, isActive: verbatimActive })); } if (pznBL === 'header' && personalizeBtnFn && settings.personalizationButtonLocation !== 'none') { buttonsInOrder.push(personalizeBtnFn('header')); } if (rBL === 'header' && settings.resetButtonLocation !== 'none') { buttonsInOrder.push(_createStandardButton({ id: IDS.TOOL_RESET_BUTTON, className: CSS.HEADER_BUTTON, svgIcon: SVG_ICONS.reset, title: _('tool_reset_filters'), clickHandler: URLActionManager.triggerResetFilters })); } buttonsInOrder.forEach(btn => { if (settingsBtnRef) { headerEl.insertBefore(btn, settingsBtnRef); } else { headerEl.appendChild(btn); } }); }
  2909.     function _buildSidebarFixedTopControls(rBL, vBL, aSL, pznBL, schL, trnL, dsL, advSearchFn, personalizeBtnFn, scholarFn, trendsFn, datasetSearchFn, settings) { const fTBC = document.createElement('div'); fTBC.id = IDS.FIXED_TOP_BUTTONS; const fTF = document.createDocumentFragment(); const verbatimActive = URLActionManager.isVerbatimActive(); if (rBL === 'topBlock' && settings.resetButtonLocation !== 'none') { const btn = _createStandardButton({ id: IDS.TOOL_RESET_BUTTON, className: CSS.TOOL_BUTTON, svgIcon: SVG_ICONS.reset, textContent: _('tool_reset_filters'), title: _('tool_reset_filters'), clickHandler: URLActionManager.triggerResetFilters }); const bD = document.createElement('div'); bD.classList.add(CSS.FIXED_TOP_BUTTON_ITEM); bD.appendChild(btn); fTF.appendChild(bD); } if (pznBL === 'topBlock' && personalizeBtnFn && settings.personalizationButtonLocation !== 'none') { const btnPzn = personalizeBtnFn('topBlock'); const bDPzn = document.createElement('div'); bDPzn.classList.add(CSS.FIXED_TOP_BUTTON_ITEM); bDPzn.appendChild(btnPzn); fTF.appendChild(bDPzn); } if (vBL === 'topBlock' && settings.verbatimButtonLocation !== 'none') { const btnVerbatim = _createStandardButton({ id: IDS.TOOL_VERBATIM, className: CSS.TOOL_BUTTON, svgIcon: SVG_ICONS.verbatim, textContent: _('tool_verbatim_search'), title: _('tool_verbatim_search'), clickHandler: URLActionManager.triggerToggleVerbatim, isActive: verbatimActive }); const bDVerbatim = document.createElement('div'); bDVerbatim.classList.add(CSS.FIXED_TOP_BUTTON_ITEM); bDVerbatim.appendChild(btnVerbatim); fTF.appendChild(bDVerbatim); } if (aSL === 'topBlock' && advSearchFn && settings.advancedSearchLinkLocation !== 'none') { const linkEl = advSearchFn(true); const bDAdv = document.createElement('div'); bDAdv.classList.add(CSS.FIXED_TOP_BUTTON_ITEM); bDAdv.appendChild(linkEl); fTF.appendChild(bDAdv); } if (schL === 'topBlock' && scholarFn && settings.googleScholarShortcutLocation !== 'none') { const btnSch = scholarFn('topBlock'); const bDSch = document.createElement('div'); bDSch.classList.add(CSS.FIXED_TOP_BUTTON_ITEM); bDSch.appendChild(btnSch); fTF.appendChild(bDSch); } if (trnL === 'topBlock' && trendsFn && settings.googleTrendsShortcutLocation !== 'none') { const btnTrn = trendsFn('topBlock'); const bDTrn = document.createElement('div'); bDTrn.classList.add(CSS.FIXED_TOP_BUTTON_ITEM); bDTrn.appendChild(btnTrn); fTF.appendChild(bDTrn); } if (dsL === 'topBlock' && datasetSearchFn && settings.googleDatasetSearchShortcutLocation !== 'none') { const btnDs = datasetSearchFn('topBlock'); const bDDs = document.createElement('div'); bDDs.classList.add(CSS.FIXED_TOP_BUTTON_ITEM); bDDs.appendChild(btnDs); fTF.appendChild(bDDs); } if (fTF.childElementCount > 0) { fTBC.appendChild(fTF); return fTBC; } return null; }
  2910.     function _createToolsSectionElement(sectionId, titleKey, rBL, vBL, aSL, pznBL, schL, trnL, dsL, advSearchFn, personalizeBtnFn, scholarFn, trendsFn, datasetSearchFn) { const { section, sectionContent, sectionTitle } = _createSectionShell(sectionId, titleKey); sectionTitle.textContent = _(titleKey); const frag = document.createDocumentFragment(); const verbatimActive = URLActionManager.isVerbatimActive(); const currentSettings = SettingsManager.getCurrentSettings(); if (rBL === 'tools' && currentSettings.resetButtonLocation !== 'none') { const btn = _createStandardButton({ id: IDS.TOOL_RESET_BUTTON, className: CSS.TOOL_BUTTON, svgIcon: SVG_ICONS.reset, textContent: _('tool_reset_filters'), title: _('tool_reset_filters'), clickHandler: URLActionManager.triggerResetFilters }); frag.appendChild(btn); } if (pznBL === 'tools' && personalizeBtnFn && currentSettings.personalizationButtonLocation !== 'none') { const btnPzn = personalizeBtnFn('tools'); frag.appendChild(btnPzn); } if (vBL === 'tools' && currentSettings.verbatimButtonLocation !== 'none') { const btnVerbatim = _createStandardButton({ id: IDS.TOOL_VERBATIM, className: CSS.TOOL_BUTTON, svgIcon: SVG_ICONS.verbatim, textContent: _('tool_verbatim_search'), title: _('tool_verbatim_search'), clickHandler: URLActionManager.triggerToggleVerbatim, isActive: verbatimActive }); frag.appendChild(btnVerbatim); } if (aSL === 'tools' && advSearchFn && currentSettings.advancedSearchLinkLocation !== 'none') { frag.appendChild(advSearchFn(true)); } if (schL === 'tools' && scholarFn && currentSettings.googleScholarShortcutLocation !== 'none') { frag.appendChild(scholarFn('tools')); } if (trnL === 'tools' && trendsFn && currentSettings.googleTrendsShortcutLocation !== 'none') { frag.appendChild(trendsFn('tools')); } if (dsL === 'tools' && datasetSearchFn && currentSettings.googleDatasetSearchShortcutLocation !== 'none') { frag.appendChild(datasetSearchFn('tools')); } if (frag.childElementCount > 0) { sectionContent.appendChild(frag); return section; } return null; }
  2911.     function _validateDateInputs(minInput, maxInput, errorMsgElement) { _clearElementMessage(errorMsgElement, CSS.ERROR_VISIBLE); minInput.classList.remove(CSS.INPUT_HAS_ERROR); maxInput.classList.remove(CSS.INPUT_HAS_ERROR); let isValid = true; const today = new Date(); today.setHours(0, 0, 0, 0); const startDateStr = minInput.value; const endDateStr = maxInput.value; let startDate = null; let endDate = null; if (startDateStr) { startDate = new Date(startDateStr); startDate.setHours(0,0,0,0); if (startDate > today) { _showElementMessage(errorMsgElement, 'alert_start_in_future', {}, CSS.ERROR_VISIBLE); minInput.classList.add(CSS.INPUT_HAS_ERROR); isValid = false; } } if (endDateStr) { endDate = new Date(endDateStr); endDate.setHours(0,0,0,0); if (endDate > today && !maxInput.getAttribute('max')) { /* Check only if max is not today (which it is by default) */ if (isValid) _showElementMessage(errorMsgElement, 'alert_end_in_future', {}, CSS.ERROR_VISIBLE); else errorMsgElement.textContent += " " + _('alert_end_in_future'); maxInput.classList.add(CSS.INPUT_HAS_ERROR); isValid = false; } } if (startDate && endDate && startDate > endDate) { if (isValid) _showElementMessage(errorMsgElement, 'alert_end_before_start', {}, CSS.ERROR_VISIBLE); else errorMsgElement.textContent += " " + _('alert_end_before_start'); minInput.classList.add(CSS.INPUT_HAS_ERROR); maxInput.classList.add(CSS.INPUT_HAS_ERROR); isValid = false; } return isValid; }
  2912.     function addDateRangeListener() { const dateRangeSection = sidebar?.querySelector('#sidebar-section-date-range'); if (!dateRangeSection) return; const applyButton = dateRangeSection.querySelector('.apply-date-range'); const errorMsgElement = dateRangeSection.querySelector(`#${IDS.DATE_RANGE_ERROR_MSG}`); const dateMinInput = dateRangeSection.querySelector(`#${IDS.DATE_MIN}`); const dateMaxInput = dateRangeSection.querySelector(`#${IDS.DATE_MAX}`); if (!applyButton || !errorMsgElement || !dateMinInput || !dateMaxInput) { console.warn(`${LOG_PREFIX} Date range elements not found for listener setup.`); return; } const handleDateValidation = () => { const isValid = _validateDateInputs(dateMinInput, dateMaxInput, errorMsgElement); applyButton.disabled = !isValid; }; if (!dateMinInput.dataset[DATA_ATTR.LISTENER_ATTACHED]) { dateMinInput.addEventListener('input', handleDateValidation); dateMinInput.addEventListener('change', handleDateValidation); dateMinInput.dataset[DATA_ATTR.LISTENER_ATTACHED] = 'true'; } if (!dateMaxInput.dataset[DATA_ATTR.LISTENER_ATTACHED]) { dateMaxInput.addEventListener('input', handleDateValidation); dateMaxInput.addEventListener('change', handleDateValidation); dateMaxInput.dataset[DATA_ATTR.LISTENER_ATTACHED] = 'true'; } if (!applyButton.dataset[DATA_ATTR.LISTENER_ATTACHED]) { applyButton.dataset[DATA_ATTR.LISTENER_ATTACHED] = 'true'; applyButton.addEventListener('click', () => { if (!_validateDateInputs(dateMinInput, dateMaxInput, errorMsgElement)) return; URLActionManager.applyDateRange(dateMinInput.value, dateMaxInput.value); }); } handleDateValidation(); /* Initial validation */ }
  2913.     function _initializeSidebarEventListenersAndStates() { addDateRangeListener(); addToolButtonListeners(); initializeSelectedFilters(); applySectionCollapseStates(); }
  2914.     function _clearElementMessage(element, visibleClass = CSS.ERROR_VISIBLE) { if(!element)return; element.textContent=''; element.classList.remove(visibleClass);}
  2915.     function _showElementMessage(element, messageKey, messageArgs = {}, visibleClass = CSS.ERROR_VISIBLE) { if(!element)return; element.textContent=_(messageKey,messageArgs); element.classList.add(visibleClass);}
  2916.     // --- Tool Button Listeners (for buttons not handled elsewhere like date apply) ---
  2917.     function addToolButtonListeners() { const queryAreas = [ sidebar?.querySelector(`.${CSS.SIDEBAR_HEADER}`), sidebar?.querySelector(`#${IDS.FIXED_TOP_BUTTONS}`), sidebar?.querySelector(`#sidebar-section-tools .${CSS.SECTION_CONTENT}`) ].filter(Boolean); queryAreas.forEach(area => { area.querySelectorAll(`#${IDS.TOOL_VERBATIM}:not([data-${DATA_ATTR.LISTENER_ATTACHED}])`).forEach(b => { b.addEventListener('click', URLActionManager.triggerToggleVerbatim); b.dataset[DATA_ATTR.LISTENER_ATTACHED] = 'true'; }); area.querySelectorAll(`#${IDS.TOOL_RESET_BUTTON}:not([data-${DATA_ATTR.LISTENER_ATTACHED}])`).forEach(b => { b.addEventListener('click', URLActionManager.triggerResetFilters); b.dataset[DATA_ATTR.LISTENER_ATTACHED] = 'true'; }); }); }
  2918.     // --- Sidebar Collapse/Expand and Section State Application ---
  2919.     function applySidebarCollapseVisuals(isCollapsed) { if(!sidebar)return; const collapseButton = sidebar.querySelector(`#${IDS.COLLAPSE_BUTTON}`); if(isCollapsed){ sidebar.classList.add(CSS.SIDEBAR_COLLAPSED); if(collapseButton){ collapseButton.innerHTML = SVG_ICONS.chevronRight; collapseButton.title = _('sidebar_expand_title');}} else{ sidebar.classList.remove(CSS.SIDEBAR_COLLAPSED); if(collapseButton){ collapseButton.innerHTML = SVG_ICONS.chevronLeft; collapseButton.title = _('sidebar_collapse_title');}} }
  2920.     function applySectionCollapseStates() { if(!sidebar)return; const currentSettings = SettingsManager.getCurrentSettings(); const sections = sidebar.querySelectorAll(`.${CSS.SIDEBAR_CONTENT_WRAPPER} .${CSS.SIDEBAR_SECTION}`); sections.forEach(section => { const content = section.querySelector(`.${CSS.SECTION_CONTENT}`); const title = section.querySelector(`.${CSS.SECTION_TITLE}`); const sectionId = section.id; if (content && title && sectionId) { let shouldBeCollapsed = false; if (currentSettings.sectionDisplayMode === 'collapseAll') { shouldBeCollapsed = true; } else if (currentSettings.sectionDisplayMode === 'expandAll') { shouldBeCollapsed = false; } else { /* remember state */ shouldBeCollapsed = currentSettings.sectionStates?.[sectionId] === true; } content.classList.toggle(CSS.COLLAPSED, shouldBeCollapsed); title.classList.toggle(CSS.COLLAPSED, shouldBeCollapsed); if (currentSettings.sectionDisplayMode === 'remember') { if (!currentSettings.sectionStates) currentSettings.sectionStates = {}; currentSettings.sectionStates[sectionId] = shouldBeCollapsed; } } }); }
  2921.  
  2922.     // --- Initialize Selected Filters based on URL ---
  2923.     function initializeSelectedFilters() {
  2924.         if (!sidebar) return;
  2925.         try {
  2926.             const currentUrl = URLActionManager._getURLObject ? URLActionManager._getURLObject() : Utils.getCurrentURL(); // Use URLActionManager's internal helper if possible
  2927.             if (!currentUrl) return; // Should not happen if script is running on a valid page
  2928.             const params = currentUrl.searchParams;
  2929.             const currentTbs = params.get('tbs') || '';
  2930.             const currentQuery = params.get('q') || '';
  2931.  
  2932.             // Handle standalone params like lr, cr, as_occt
  2933.             ALL_SECTION_DEFINITIONS.forEach(sectionDef => {
  2934.                 if (sectionDef.type === 'filter' && sectionDef.param && sectionDef.id !== 'sidebar-section-filetype' && sectionDef.id !== 'sidebar-section-site-search') { // Exclude filetype/site as they use 'q'
  2935.                      _initializeStandaloneFilterState(params, sectionDef.id, sectionDef.param);
  2936.                 }
  2937.             });
  2938.             _initializeTimeFilterState(currentTbs);
  2939.             _initializeVerbatimState();
  2940.             _initializePersonalizationState();
  2941.             _initializeDateRangeInputs(currentTbs);
  2942.             _initializeSiteSearchState(currentQuery); // Pass only query for site search
  2943.             _initializeFiletypeSearchState(currentQuery, params.get('as_filetype')); // Pass query and as_filetype
  2944.         } catch (e) {
  2945.             console.error(`${LOG_PREFIX} Error initializing filter highlights:`, e);
  2946.         }
  2947.     }
  2948.  
  2949.     function _initializeStandaloneFilterState(params, sectionId, paramToGetFromURL) {
  2950.         const sectionElement = sidebar?.querySelector(`#${sectionId}`);
  2951.         if (!sectionElement) return;
  2952.         const urlValue = params.get(paramToGetFromURL);
  2953.         const options = sectionElement.querySelectorAll(`.${CSS.FILTER_OPTION}`);
  2954.         let anOptionWasSelectedBasedOnUrl = false;
  2955.  
  2956.         options.forEach(opt => {
  2957.             const optionValue = opt.dataset[DATA_ATTR.FILTER_VALUE];
  2958.             const isSelected = (urlValue !== null && urlValue === optionValue); // Strict check for value presence
  2959.             opt.classList.toggle(CSS.SELECTED, isSelected);
  2960.             if (isSelected) anOptionWasSelectedBasedOnUrl = true;
  2961.         });
  2962.  
  2963.         // If no option was selected based on URL (e.g., param not present or value doesn't match), select the default
  2964.         if (!anOptionWasSelectedBasedOnUrl) {
  2965.             // For as_occt, default is 'any'. For others (lr, cr), default is empty string value.
  2966.             const defaultOptionQuery = (paramToGetFromURL === 'as_occt')
  2967.                 ? `.${CSS.FILTER_OPTION}[data-${DATA_ATTR.FILTER_VALUE}="any"]`
  2968.                 : `.${CSS.FILTER_OPTION}[data-${DATA_ATTR.FILTER_VALUE}=""]`;
  2969.             const defaultOpt = sectionElement.querySelector(defaultOptionQuery);
  2970.             if (defaultOpt) {
  2971.                 defaultOpt.classList.add(CSS.SELECTED);
  2972.             }
  2973.         }
  2974.     }
  2975.  
  2976.     function _initializeTimeFilterState(currentTbs){ const timeSection = sidebar?.querySelector('#sidebar-section-time'); if(!timeSection) return; const qdrMatch = currentTbs.match(/qdr:([^,]+)/); const activeQdrValue = qdrMatch ? qdrMatch[1] : null; const hasDateRange = /cdr:1/.test(currentTbs); const timeOptions = timeSection.querySelectorAll(`.${CSS.FILTER_OPTION}`); timeOptions.forEach(opt => { const optionValue = opt.dataset[DATA_ATTR.FILTER_VALUE]; let shouldBeSelected = false; if(hasDateRange){ shouldBeSelected = (optionValue === '');/* If custom date range, select "Any Time" */ } else if(activeQdrValue){ shouldBeSelected = (optionValue === activeQdrValue); } else { shouldBeSelected = (optionValue === ''); /* Default to "Any Time" */ } opt.classList.toggle(CSS.SELECTED, shouldBeSelected); }); }
  2977.     function _initializeVerbatimState(){ const isVerbatimActiveNow = URLActionManager.isVerbatimActive(); sidebar?.querySelectorAll(`#${IDS.TOOL_VERBATIM}`).forEach(b=>b.classList.toggle(CSS.ACTIVE, isVerbatimActiveNow)); }
  2978.     function _initializePersonalizationState() { const isActive = URLActionManager.isPersonalizationActive(); sidebar?.querySelectorAll(`#${IDS.TOOL_PERSONALIZE}`).forEach(button => { button.classList.toggle(CSS.ACTIVE, isActive); const titleKey = isActive ? 'tooltip_toggle_personalization_off' : 'tooltip_toggle_personalization_on'; button.title = _(titleKey); /* Update icon/text if needed based on state - already done by _createPersonalizationButtonHTML */ const svgIcon = SVG_ICONS.personalization || ''; const isIconOnly = button.classList.contains(CSS.HEADER_BUTTON) && !button.classList.contains(CSS.TOOL_BUTTON); const currentText = !isIconOnly ? _('tool_personalization_toggle') : ''; let newHTML = ''; if(svgIcon) newHTML += svgIcon; if(currentText) newHTML += (svgIcon && currentText ? ' ' : '') + currentText; button.innerHTML = newHTML.trim(); }); }
  2979.     function _initializeDateRangeInputs(currentTbs){ const dateSection = sidebar?.querySelector('#sidebar-section-date-range'); if (!dateSection) return; const dateMinInput = dateSection.querySelector(`#${IDS.DATE_MIN}`); const dateMaxInput = dateSection.querySelector(`#${IDS.DATE_MAX}`); const errorMsgElement = dateSection.querySelector(`#${IDS.DATE_RANGE_ERROR_MSG}`); const applyButton = dateSection.querySelector('.apply-date-range'); if (errorMsgElement) _clearElementMessage(errorMsgElement, CSS.ERROR_VISIBLE); if (/cdr:1/.test(currentTbs)) { const minMatch = currentTbs.match(/cd_min:(\d{1,2})\/(\d{1,2})\/(\d{4})/); const maxMatch = currentTbs.match(/cd_max:(\d{1,2})\/(\d{1,2})\/(\d{4})/); if (dateMinInput) dateMinInput.value = minMatch ? `${minMatch[3]}-${minMatch[1].padStart(2, '0')}-${minMatch[2].padStart(2, '0')}` : ''; if (dateMaxInput) dateMaxInput.value = maxMatch ? `${maxMatch[3]}-${maxMatch[1].padStart(2, '0')}-${maxMatch[2].padStart(2, '0')}` : ''; } else { if (dateMinInput) dateMinInput.value = ''; if (dateMaxInput) dateMaxInput.value = ''; } if (dateMinInput && dateMaxInput && errorMsgElement && applyButton) { const isValid = _validateDateInputs(dateMinInput, dateMaxInput, errorMsgElement); applyButton.disabled = !isValid; } }
  2980.  
  2981.     function _initializeSiteSearchState(currentQuery){
  2982.         const siteSearchSectionContent = sidebar?.querySelector('#sidebar-section-site-search .'+CSS.SECTION_CONTENT);
  2983.         if (!siteSearchSectionContent) return;
  2984.  
  2985.         const clearSiteOptDiv = siteSearchSectionContent.querySelector(`#${IDS.CLEAR_SITE_SEARCH_OPTION}`);
  2986.         const listElement = siteSearchSectionContent.querySelector('ul.' + CSS.CUSTOM_LIST);
  2987.         const currentSettings = SettingsManager.getCurrentSettings();
  2988.         const checkboxModeEnabled = currentSettings.enableSiteSearchCheckboxMode;
  2989.  
  2990.         // Reset all selections first
  2991.         siteSearchSectionContent.querySelectorAll(`.${CSS.FILTER_OPTION}.${CSS.SELECTED}, label.${CSS.SELECTED}`).forEach(opt => opt.classList.remove(CSS.SELECTED));
  2992.         if (checkboxModeEnabled && listElement) {
  2993.             listElement.querySelectorAll(`input[type="checkbox"].${CSS.SITE_SEARCH_ITEM_CHECKBOX}`).forEach(cb => cb.checked = false);
  2994.         }
  2995.  
  2996.         // Extract all site: operators from the query
  2997.         const siteMatches = [...currentQuery.matchAll(/(?<!\S)site:([\w.:\/~%?#=&+-]+)(?!\S)/gi)];
  2998.         let activeSiteUrlsFromQuery = siteMatches.map(match => match[1].toLowerCase());
  2999.         activeSiteUrlsFromQuery.sort();
  3000.  
  3001.         if (activeSiteUrlsFromQuery.length > 0) {
  3002.             if(clearSiteOptDiv) clearSiteOptDiv.classList.remove(CSS.SELECTED);
  3003.             let customOptionFullyMatched = false;
  3004.  
  3005.             if (listElement) {
  3006.                 const customSiteOptions = Array.from(listElement.querySelectorAll(checkboxModeEnabled ? 'label' : `div.${CSS.FILTER_OPTION}`));
  3007.                 for (const optElement of customSiteOptions) {
  3008.                     const customSiteValue = optElement.dataset[DATA_ATTR.SITE_URL];
  3009.                     if (!customSiteValue) continue;
  3010.  
  3011.                     const definedCustomSites = Utils.parseCombinedValue(customSiteValue).map(s => s.toLowerCase()).sort();
  3012.                     if (definedCustomSites.length > 0 && definedCustomSites.length === activeSiteUrlsFromQuery.length && definedCustomSites.every((val, index) => val === activeSiteUrlsFromQuery[index])) {
  3013.                         if (checkboxModeEnabled) {
  3014.                             const checkbox = listElement.querySelector(`input[type="checkbox"][value="${customSiteValue}"]`);
  3015.                             if (checkbox) checkbox.checked = true;
  3016.                         }
  3017.                         optElement.classList.add(CSS.SELECTED);
  3018.                         customOptionFullyMatched = true;
  3019.                         break;
  3020.                     }
  3021.                 }
  3022.             }
  3023.  
  3024.             if (!customOptionFullyMatched && listElement && checkboxModeEnabled) { // Only check individual checkboxes if not a full match and in checkbox mode
  3025.                 activeSiteUrlsFromQuery.forEach(url => {
  3026.                     const checkbox = listElement.querySelector(`input[type="checkbox"].${CSS.SITE_SEARCH_ITEM_CHECKBOX}[value="${url}"]`);
  3027.                     if (checkbox) {
  3028.                         checkbox.checked = true;
  3029.                         const label = listElement.querySelector(`label[for="${checkbox.id}"]`);
  3030.                         if(label) label.classList.add(CSS.SELECTED);
  3031.                     }
  3032.                 });
  3033.             } else if (!customOptionFullyMatched && listElement && !checkboxModeEnabled && activeSiteUrlsFromQuery.length === 1) {
  3034.                  // If not checkbox mode, and only a single site is in query, try to select its div option
  3035.                 const singleSiteInQuery = activeSiteUrlsFromQuery[0];
  3036.                 const optionDiv = listElement.querySelector(`div.${CSS.FILTER_OPTION}[data-${DATA_ATTR.SITE_URL}="${singleSiteInQuery}"]`);
  3037.                 if (optionDiv) optionDiv.classList.add(CSS.SELECTED);
  3038.             }
  3039.  
  3040.  
  3041.         } else {
  3042.             if (clearSiteOptDiv) clearSiteOptDiv.classList.add(CSS.SELECTED);
  3043.         }
  3044.  
  3045.         if (checkboxModeEnabled) {
  3046.             _updateApplySitesButtonState(siteSearchSectionContent);
  3047.         }
  3048.     }
  3049.  
  3050.     function _initializeFiletypeSearchState(currentQuery, asFiletypeParam) {
  3051.         const filetypeSectionContent = sidebar?.querySelector('#sidebar-section-filetype .'+CSS.SECTION_CONTENT);
  3052.         if (!filetypeSectionContent) return;
  3053.  
  3054.         const clearFiletypeOptDiv = filetypeSectionContent.querySelector(`#${IDS.CLEAR_FILETYPE_SEARCH_OPTION}`);
  3055.         const listElement = filetypeSectionContent.querySelector('ul.' + CSS.CUSTOM_LIST);
  3056.         const currentSettings = SettingsManager.getCurrentSettings();
  3057.         const checkboxModeEnabled = currentSettings.enableFiletypeCheckboxMode;
  3058.  
  3059.         // Reset all selections first
  3060.         filetypeSectionContent.querySelectorAll(`.${CSS.FILTER_OPTION}.${CSS.SELECTED}, label.${CSS.SELECTED}`).forEach(opt => opt.classList.remove(CSS.SELECTED));
  3061.         if (checkboxModeEnabled && listElement) {
  3062.             listElement.querySelectorAll(`input[type="checkbox"].${CSS.FILETYPE_SEARCH_ITEM_CHECKBOX}`).forEach(cb => cb.checked = false);
  3063.         }
  3064.  
  3065.         let activeFiletypesFromQuery = [];
  3066.         const filetypeMatches = [...currentQuery.matchAll(/(?<!\S)filetype:([\w.:\/~%?#=&+-]+)(?!\S)/gi)];
  3067.  
  3068.         if (filetypeMatches.length > 0) {
  3069.             activeFiletypesFromQuery = filetypeMatches.map(match => match[1].toLowerCase());
  3070.         } else if (asFiletypeParam && !currentQuery.includes('filetype:')) {
  3071.              activeFiletypesFromQuery = Utils.parseCombinedValue(asFiletypeParam).map(ft => ft.toLowerCase());
  3072.         }
  3073.         activeFiletypesFromQuery.sort();
  3074.  
  3075.         if (activeFiletypesFromQuery.length > 0) {
  3076.             if(clearFiletypeOptDiv) clearFiletypeOptDiv.classList.remove(CSS.SELECTED);
  3077.             let customOptionFullyMatched = false;
  3078.  
  3079.             if (listElement) {
  3080.                 const customFiletypeOptions = Array.from(listElement.querySelectorAll(checkboxModeEnabled ? 'label' : `div.${CSS.FILTER_OPTION}`));
  3081.                 for (const optElement of customFiletypeOptions) {
  3082.                     const customFtValueAttr = checkboxModeEnabled ? optElement.dataset[DATA_ATTR.FILETYPE_VALUE] : optElement.dataset[DATA_ATTR.FILTER_VALUE];
  3083.                     if (!customFtValueAttr) continue;
  3084.  
  3085.                     const definedCustomFiletypes = Utils.parseCombinedValue(customFtValueAttr).map(s => s.toLowerCase()).sort();
  3086.                      if (definedCustomFiletypes.length > 0 && definedCustomFiletypes.length === activeFiletypesFromQuery.length && definedCustomFiletypes.every((val, index) => val === activeFiletypesFromQuery[index])) {
  3087.                         if (checkboxModeEnabled) {
  3088.                             const checkbox = listElement.querySelector(`input[type="checkbox"][value="${customFtValueAttr}"]`);
  3089.                             if (checkbox) checkbox.checked = true;
  3090.                         }
  3091.                         optElement.classList.add(CSS.SELECTED);
  3092.                         customOptionFullyMatched = true;
  3093.                         break;
  3094.                     }
  3095.                 }
  3096.             }
  3097.  
  3098.             if (!customOptionFullyMatched && listElement && checkboxModeEnabled) {
  3099.                 activeFiletypesFromQuery.forEach(ft => {
  3100.                     const checkbox = listElement.querySelector(`input[type="checkbox"].${CSS.FILETYPE_SEARCH_ITEM_CHECKBOX}[value="${ft}"]`);
  3101.                     if (checkbox) {
  3102.                          checkbox.checked = true;
  3103.                          const label = listElement.querySelector(`label[for="${checkbox.id}"]`);
  3104.                          if(label) label.classList.add(CSS.SELECTED);
  3105.                     }
  3106.                 });
  3107.             } else if (!customOptionFullyMatched && listElement && !checkboxModeEnabled && activeFiletypesFromQuery.length === 1) {
  3108.                 const singleFtInQuery = activeFiletypesFromQuery[0];
  3109.                 const optionDiv = listElement.querySelector(`div.${CSS.FILTER_OPTION}[data-${DATA_ATTR.FILTER_VALUE}="${singleFtInQuery}"]`);
  3110.                 if (optionDiv) optionDiv.classList.add(CSS.SELECTED);
  3111.             }
  3112.         } else {
  3113.              if (clearFiletypeOptDiv) clearFiletypeOptDiv.classList.add(CSS.SELECTED);
  3114.         }
  3115.         if (checkboxModeEnabled) {
  3116.             _updateApplyFiletypesButtonState(filetypeSectionContent);
  3117.         }
  3118.     }
  3119.  
  3120.     // --- Event Binding for Sidebar ---
  3121.     function bindSidebarEvents() { if (!sidebar) return; const collapseButton = sidebar.querySelector(`#${IDS.COLLAPSE_BUTTON}`); const settingsButton = sidebar.querySelector(`#${IDS.SETTINGS_BUTTON}`); if (collapseButton) collapseButton.title = _('sidebar_collapse_title'); if (settingsButton) settingsButton.title = _('sidebar_settings_title'); sidebar.addEventListener('click', (e) => { const settingsBtnTarget = e.target.closest(`#${IDS.SETTINGS_BUTTON}`); if (settingsBtnTarget) { SettingsManager.show(); return; } const collapseBtnTarget = e.target.closest(`#${IDS.COLLAPSE_BUTTON}`); if (collapseBtnTarget) { toggleSidebarCollapse(); return; } const sectionTitleTarget = e.target.closest(`.${CSS.SIDEBAR_CONTENT_WRAPPER} .${CSS.SECTION_TITLE}`); if (sectionTitleTarget && !sidebar.classList.contains(CSS.SIDEBAR_COLLAPSED)) { handleSectionCollapse(e); return; } }); }
  3122.     // --- Sidebar and Section Collapse Logic ---
  3123.     function toggleSidebarCollapse() { const cs = SettingsManager.getCurrentSettings(); cs.sidebarCollapsed = !cs.sidebarCollapsed; applySettings(cs); SettingsManager.save('Sidebar Collapse');}
  3124.     function handleSectionCollapse(event) { const title = event.target.closest(`.${CSS.SECTION_TITLE}`); if (!title || sidebar?.classList.contains(CSS.SIDEBAR_COLLAPSED) || title.closest(`#${IDS.FIXED_TOP_BUTTONS}`)) return; const section = title.closest(`.${CSS.SIDEBAR_SECTION}`); if (!section) return; const content = section.querySelector(`.${CSS.SECTION_CONTENT}`); const sectionId = section.id; if (!content || !sectionId) return; const currentSettings = SettingsManager.getCurrentSettings(); const isCurrentlyCollapsed = content.classList.contains(CSS.COLLAPSED); const shouldBeCollapsedAfterClick = !isCurrentlyCollapsed; let overallStateChanged = false; if (currentSettings.accordionMode && !shouldBeCollapsedAfterClick) { const sectionsContainer = section.parentElement; if (_applyAccordionEffectToSections(sectionId, sectionsContainer, currentSettings)) overallStateChanged = true; } if (_toggleSectionVisualState(section, title, content, sectionId, shouldBeCollapsedAfterClick, currentSettings)) overallStateChanged = true; if (overallStateChanged && currentSettings.sectionDisplayMode === 'remember') { debouncedSaveSettings('Section Collapse/Accordion'); } }
  3125.     function _applyAccordionEffectToSections(clickedSectionId, allSectionsContainer, currentSettings) { let stateChangedForAccordion = false; allSectionsContainer?.querySelectorAll(`.${CSS.SIDEBAR_SECTION}`)?.forEach(otherSection => { if (otherSection.id !== clickedSectionId) { const otherContent = otherSection.querySelector(`.${CSS.SECTION_CONTENT}`); const otherTitle = otherSection.querySelector(`.${CSS.SECTION_TITLE}`); if (otherContent && !otherContent.classList.contains(CSS.COLLAPSED)) { otherContent.classList.add(CSS.COLLAPSED); otherTitle?.classList.add(CSS.COLLAPSED); if (currentSettings.sectionDisplayMode === 'remember') { if (!currentSettings.sectionStates) currentSettings.sectionStates = {}; if (currentSettings.sectionStates[otherSection.id] !== true) { currentSettings.sectionStates[otherSection.id] = true; stateChangedForAccordion = true; } } } } }); return stateChangedForAccordion; }
  3126.     function _toggleSectionVisualState(sectionEl, titleEl, contentEl, sectionId, newCollapsedState, currentSettings) { let sectionStateActuallyChanged = false; const isCurrentlyCollapsed = contentEl.classList.contains(CSS.COLLAPSED); if (isCurrentlyCollapsed !== newCollapsedState) { contentEl.classList.toggle(CSS.COLLAPSED, newCollapsedState); titleEl.classList.toggle(CSS.COLLAPSED, newCollapsedState); sectionStateActuallyChanged = true; } if (currentSettings.sectionDisplayMode === 'remember') { if (!currentSettings.sectionStates) currentSettings.sectionStates = {}; if (currentSettings.sectionStates[sectionId] !== newCollapsedState) { currentSettings.sectionStates[sectionId] = newCollapsedState; if (!sectionStateActuallyChanged) sectionStateActuallyChanged = true; /* Mark changed even if visual was already matching if state obj differs */ } } return sectionStateActuallyChanged; }
  3127.  
  3128.     // --- Initialization ---
  3129.     function initializeScript() {
  3130.         console.log(LOG_PREFIX + " Initializing script...");
  3131.         debouncedSaveSettings = Utils.debounce(() => SettingsManager.save('Debounced Save'), 800);
  3132.         try {
  3133.             addGlobalStyles(); NotificationManager.init(); LocalizationService.initializeBaseLocale();
  3134.             SettingsManager.initialize( defaultSettings, applySettings, buildSidebarUI, applySectionCollapseStates, _initMenuCommands, renderSectionOrderList );
  3135.             setupSystemThemeListener(); buildSidebarSkeleton();
  3136.             DragManager.init( sidebar, sidebar.querySelector(`.${CSS.DRAG_HANDLE}`), SettingsManager, debouncedSaveSettings );
  3137.             const initialSettings = SettingsManager.getCurrentSettings();
  3138.             DragManager.setDraggable(initialSettings.draggableHandleEnabled, sidebar, sidebar.querySelector(`.${CSS.DRAG_HANDLE}`));
  3139.             applySettings(initialSettings); buildSidebarUI(); bindSidebarEvents(); _initMenuCommands();
  3140.             console.log(`${LOG_PREFIX} Script initialization complete. Final effective locale: ${LocalizationService.getCurrentLocale()}`);
  3141.         } catch (error) {
  3142.             console.error(`${LOG_PREFIX} [initializeScript] CRITICAL ERROR DURING INITIALIZATION:`, error, error.stack);
  3143.             const scriptNameForAlert = (typeof _ === 'function' && _('scriptName') && !(_('scriptName').startsWith('[ERR:'))) ? _('scriptName') : SCRIPT_INTERNAL_NAME;
  3144.             // Try to use NotificationManager if available, otherwise alert
  3145.             if (typeof NotificationManager !== 'undefined' && NotificationManager.show) { NotificationManager.show('alert_init_fail', { scriptName: scriptNameForAlert, error: error.message }, 'error', 0); }
  3146.             else { _showGlobalMessage('alert_init_fail', { scriptName: scriptNameForAlert, error: error.message }, 'error', 0); } // Fallback
  3147.             // Attempt to clean up UI elements if init fails badly
  3148.             if(sidebar && sidebar.remove) sidebar.remove(); const settingsOverlayEl = document.getElementById(IDS.SETTINGS_OVERLAY); if(settingsOverlayEl) settingsOverlayEl.remove(); ModalManager.hide();
  3149.         }
  3150.     }
  3151.  
  3152.     // --- Script Entry Point (Dependency Loading Logic) ---
  3153.     if (document.getElementById(IDS.SIDEBAR)) { console.warn(`${LOG_PREFIX} Sidebar with ID "${IDS.SIDEBAR}" already exists. Skipping initialization.`); return; }
  3154.     const dependenciesReady = { styles: false, i18n: false }; let initializationAttempted = false; let timeoutFallback;
  3155.     function checkDependenciesAndInitialize() { if (initializationAttempted) return; if (dependenciesReady.styles && dependenciesReady.i18n) { console.log(`${LOG_PREFIX} All dependencies ready. Initializing script.`); clearTimeout(timeoutFallback); initializationAttempted = true; if (document.readyState === 'complete' || document.readyState === 'interactive' || document.readyState === 'loaded') { initializeScript(); } else { window.addEventListener('DOMContentLoaded', initializeScript, { once: true }); } } }
  3156.     document.addEventListener('gscsStylesLoaded', function stylesLoadedHandler() { console.log(`${LOG_PREFIX} Event "gscsStylesLoaded" received.`); dependenciesReady.styles = true; checkDependenciesAndInitialize(); }, { once: true });
  3157.     document.addEventListener('gscsi18nLoaded', function i18nLoadedHandler() { console.log(`${LOG_PREFIX} Event "gscsi18nLoaded" received.`); dependenciesReady.i18n = true; checkDependenciesAndInitialize(); }, { once: true });
  3158.     timeoutFallback = setTimeout(() => { if (initializationAttempted) return; console.log(`${LOG_PREFIX} Fallback: Checking dependencies after timeout.`); if (typeof window.GSCS_Namespace !== 'undefined') { if (typeof window.GSCS_Namespace.stylesText === 'string' && window.GSCS_Namespace.stylesText.trim() !== '' && !dependenciesReady.styles) { console.log(`${LOG_PREFIX} Fallback: Styles found via namespace.`); dependenciesReady.styles = true; } if (typeof window.GSCS_Namespace.i18nPack === 'object' && Object.keys(window.GSCS_Namespace.i18nPack.translations || {}).length > 0 && !dependenciesReady.i18n) { console.log(`${LOG_PREFIX} Fallback: i18n pack found via namespace.`); dependenciesReady.i18n = true; } } if (dependenciesReady.styles && dependenciesReady.i18n) { checkDependenciesAndInitialize(); } else { console.error(`${LOG_PREFIX} Fallback: Dependencies still not fully loaded after timeout. Styles: ${dependenciesReady.styles}, i18n: ${dependenciesReady.i18n}.`); if (!initializationAttempted) { console.warn(`${LOG_PREFIX} Attempting to initialize with potentially incomplete dependencies due to fallback timeout.`); if (!dependenciesReady.styles) { console.warn(`${LOG_PREFIX} Styles dependency forced true in fallback.`); dependenciesReady.styles = true; } if (!dependenciesReady.i18n) { console.warn(`${LOG_PREFIX} i18n dependency forced true in fallback.`); dependenciesReady.i18n = true; } checkDependenciesAndInitialize(); } } }, 2000);
  3159.     // Additional check for cases where scripts load very fast and events might be missed if this script's DOMContentLoaded is later
  3160.     if (document.readyState === 'complete' || document.readyState === 'interactive' || document.readyState === 'loaded') {
  3161.         if (typeof window.GSCS_Namespace !== 'undefined') {
  3162.             if (typeof window.GSCS_Namespace.stylesText === 'string' && window.GSCS_Namespace.stylesText.trim() !== '' && !dependenciesReady.styles) {
  3163.                 // console.log(`${LOG_PREFIX} Post-load check: Styles found via namespace.`);
  3164.                 dependenciesReady.styles = true;
  3165.             }
  3166.             if (typeof window.GSCS_Namespace.i18nPack === 'object' && Object.keys(window.GSCS_Namespace.i18nPack.translations || {}).length > 0 && !dependenciesReady.i18n) {
  3167.                 // console.log(`${LOG_PREFIX} Post-load check: i18n pack found via namespace.`);
  3168.                 dependenciesReady.i18n = true;
  3169.             }
  3170.         }
  3171.         if (dependenciesReady.styles && dependenciesReady.i18n && !initializationAttempted) {
  3172.             // console.log(`${LOG_PREFIX} Post-load check: All dependencies ready. Initializing script.`);
  3173.             checkDependenciesAndInitialize();
  3174.         }
  3175.     }
  3176. })();

欢迎访问Greasy Fork镜像

土豆服务器，请按需使用

镜像地址随时可能被墙，建议加群获取最新地址

加入Q群

QingJ © 2025

镜像随时可能失效，请加Q群300939539或关注我们的公众号极客氢云获取最新地址