@countriesdb/widget 0.1.20 → 0.1.22

package/dist/index.js

@@ -389,12 +389,19 @@
     /**
      * Handle API error by showing error message in select
      */
-    function handleApiError(select, errorMessage) {
+    function handleApiError(select, errorMessage, replace = false) {
         const message = errorMessage instanceof Error ? errorMessage.message : errorMessage;
         const defaultValue = select.dataset.defaultValue ?? '';
         // Add "Error: " prefix to match old widget behavior and test expectations
         const formattedMessage = message.startsWith('Error: ') ? message : `Error: ${message}`;
-        select.innerHTML += `<option value="${defaultValue}" disabled>${formattedMessage}</option>`;
+        if (replace) {
+            select.innerHTML = `<option value="${defaultValue}" disabled>${formattedMessage}</option>`;
+        }
+        else {
+            select.innerHTML += `<option value="${defaultValue}" disabled>${formattedMessage}</option>`;
+        }
+        // Ensure select is enabled so users can see the error
+        select.disabled = false;
     }
 
     /**
@@ -704,8 +711,7 @@
                 : null;
             // Check if linked country select is multi-select (not allowed)
             if (linkedCountrySelect && linkedCountrySelect.hasAttribute('multiple')) {
-                const defaultValue = select.dataset.defaultValue ?? '';
-                select.innerHTML = `<option value="${defaultValue}" disabled>Error: Cannot link to multi-select country. Use data-country-code instead.</option>`;
+                handleApiError(select, 'Cannot link to multi-select country. Use data-country-code instead.', true);
                 continue;
             }
             // No direct link → maybe data-country-code
@@ -715,8 +721,7 @@
                     await updateSubdivisionSelect(select, apiKey, backendUrl, state, config, select.dataset.countryCode);
                 }
                 else {
-                    const defaultValue = select.dataset.defaultValue ?? '';
-                    select.innerHTML += `<option value="${defaultValue}" disabled>Error: No country select present</option>`;
+                    handleApiError(select, 'No country select present');
                 }
             }
             // Always dispatch an update event for user-initiated subdivision changes
@@ -762,7 +767,8 @@
                 // Use GeoIP only if data-preselected attribute is not set at all
                 const shouldUseGeoIP = preselectedValue === undefined || preselectedValue === null;
                 // Check if this subdivision select prefers official subdivisions
-                const preferOfficial = select.hasAttribute('data-prefer-official');
+                const preferOfficial = select.hasAttribute('data-prefer-official') ||
+                    config.preferOfficialSubdivisions;
                 const languageHeaders = CountriesDBClient.getLanguageHeaders(config.forcedLanguage, config.defaultLanguage);
                 const subdivisionsResult = await CountriesDBClient.fetchSubdivisions({
                     apiKey,
@@ -859,8 +865,7 @@
         }
         else if (!select.dataset.country ||
             !document.querySelector(`.country-selection[data-name="${select.dataset.country}"]`)) {
-            const defaultValue = select.dataset.defaultValue ?? '';
-            select.innerHTML += `<option value="${defaultValue}" disabled>Error: No country select present</option>`;
+            handleApiError(select, 'No country select present');
         }
     }
     /**
@@ -889,8 +894,7 @@
             if (name && seenNames[name]) {
                 select.removeAttribute('data-name');
                 initializeSelect(select, '&mdash;');
-                const defaultValue = select.dataset.defaultValue ?? '';
-                select.innerHTML += `<option value="${defaultValue}" disabled>Error: Duplicate field</option>`;
+                handleApiError(select, 'Duplicate field');
                 continue;
             }
             if (name) {
@@ -1054,6 +1058,7 @@
                 followUpward: config.followUpward || false,
                 showSubdivisionType: config.showSubdivisionType !== false,
                 allowParentSelection: config.allowParentSelection || false,
+                preferOfficialSubdivisions: config.preferOfficialSubdivisions || false,
                 subdivisionRomanizationPreference: config.subdivisionRomanizationPreference,
                 preferLocalVariant: config.preferLocalVariant || false,
                 subdivisionNameFilter: config.subdivisionNameFilter,
@@ -1063,6 +1068,7 @@
                 followUpward: config.followUpward || false,
                 showSubdivisionType: config.showSubdivisionType !== false,
                 allowParentSelection: config.allowParentSelection || false,
+                preferOfficialSubdivisions: config.preferOfficialSubdivisions || false,
                 subdivisionRomanizationPreference: config.subdivisionRomanizationPreference,
                 preferLocalVariant: config.preferLocalVariant || false,
                 forcedLanguage: config.forcedLanguage,
@@ -1134,30 +1140,50 @@
             forcedLanguage: options.forcedLanguage ?? globalConfig?.forcedLanguage ?? scriptUrl?.searchParams.get('forced_language') ?? undefined,
             showSubdivisionType: options.showSubdivisionType !== undefined
                 ? options.showSubdivisionType
-                : parseBoolean(scriptUrl?.searchParams.get('show_subdivision_type') ?? '1'),
+                : globalConfig?.showSubdivisionType !== undefined
+                    ? globalConfig.showSubdivisionType
+                    : parseBoolean(scriptUrl?.searchParams.get('show_subdivision_type') ?? '1'),
             followRelated: options.followRelated !== undefined
                 ? options.followRelated
-                : parseBoolean(scriptUrl?.searchParams.get('follow_related') ?? 'false'),
+                : globalConfig?.followRelated !== undefined
+                    ? globalConfig.followRelated
+                    : parseBoolean(scriptUrl?.searchParams.get('follow_related') ?? 'false'),
             followUpward: options.followUpward !== undefined
                 ? options.followUpward
-                : parseBoolean(scriptUrl?.searchParams.get('follow_upward') ?? 'false'),
+                : globalConfig?.followUpward !== undefined
+                    ? globalConfig.followUpward
+                    : parseBoolean(scriptUrl?.searchParams.get('follow_upward') ?? 'false'),
             allowParentSelection: options.allowParentSelection !== undefined
                 ? options.allowParentSelection
-                : parseBoolean(scriptUrl?.searchParams.get('allow_parent_selection') ?? 'false'),
+                : globalConfig?.allowParentSelection !== undefined
+                    ? globalConfig.allowParentSelection
+                    : parseBoolean(scriptUrl?.searchParams.get('allow_parent_selection') ?? 'false'),
             isoCountryNames: options.isoCountryNames !== undefined
                 ? options.isoCountryNames
-                : parseBoolean(scriptUrl?.searchParams.get('iso_country_names') ?? 'false'),
+                : globalConfig?.isoCountryNames !== undefined
+                    ? globalConfig.isoCountryNames
+                    : parseBoolean(scriptUrl?.searchParams.get('iso_country_names') ?? 'false'),
+            preferOfficialSubdivisions: options.preferOfficialSubdivisions !== undefined
+                ? options.preferOfficialSubdivisions
+                : globalConfig?.preferOfficialSubdivisions !== undefined
+                    ? globalConfig.preferOfficialSubdivisions
+                    : parseBoolean(scriptUrl?.searchParams.get('prefer_official') ?? 'false'),
             subdivisionRomanizationPreference: options.subdivisionRomanizationPreference ||
+                globalConfig?.subdivisionRomanizationPreference ||
                 scriptUrl?.searchParams.get('subdivision_romanization_preference') ||
                 undefined,
             preferLocalVariant: options.preferLocalVariant !== undefined
                 ? options.preferLocalVariant
-                : parseBoolean(scriptUrl?.searchParams.get('prefer_local_variant') ?? 'false'),
-            countryNameFilter: options.countryNameFilter,
-            subdivisionNameFilter: options.subdivisionNameFilter,
+                : globalConfig?.preferLocalVariant !== undefined
+                    ? globalConfig.preferLocalVariant
+                    : parseBoolean(scriptUrl?.searchParams.get('prefer_local_variant') ?? 'false'),
+            countryNameFilter: options.countryNameFilter ?? globalConfig?.countryNameFilter,
+            subdivisionNameFilter: options.subdivisionNameFilter ?? globalConfig?.subdivisionNameFilter,
             autoInit: options.autoInit !== undefined
                 ? options.autoInit
-                : parseBoolean(scriptUrl?.searchParams.get('auto_init') ?? 'true'),
+                : globalConfig?.autoInit !== undefined
+                    ? globalConfig.autoInit
+                    : parseBoolean(scriptUrl?.searchParams.get('auto_init') ?? 'true'),
         };
         // Resolve filter functions from global scope if specified by name
         if (scriptUrl) {
@@ -1257,14 +1283,14 @@
      * Show error when both follow_related and follow_upward are enabled
      */
     function showParamConflictError() {
-        const errorMessage = 'Error: Cannot enable both follow_related and follow_upward';
+        const errorMessage = 'Cannot enable both follow_related and follow_upward';
         const countrySelects = Array.from(document.querySelectorAll('.country-selection'));
         for (const select of countrySelects) {
-            select.innerHTML = `<option value="${select.dataset.defaultValue ?? ''}" disabled>${errorMessage}</option>`;
+            handleApiError(select, errorMessage, true);
         }
         const subdivisionSelects = Array.from(document.querySelectorAll('.subdivision-selection'));
         for (const select of subdivisionSelects) {
-            select.innerHTML = `<option value="${select.dataset.defaultValue ?? ''}" disabled>${errorMessage}</option>`;
+            handleApiError(select, errorMessage, true);
         }
     }
     // Expose public loader
@@ -1298,7 +1324,13 @@
             }
             // Default to auto-init = true (only disable if explicitly set to false)
             let shouldAutoInit = true;
-            if (loaderScript && loaderScript.src) {
+            const globalConfig = typeof window !== 'undefined'
+                ? window.CountriesDBConfig || null
+                : null;
+            if (globalConfig && typeof globalConfig.autoInit !== 'undefined') {
+                shouldAutoInit = !!globalConfig.autoInit;
+            }
+            else if (loaderScript && loaderScript.src) {
                 try {
                     const scriptUrl = new URL(loaderScript.src);
                     const autoInit = scriptUrl.searchParams.get('auto_init');