@countriesdb/widget 0.1.23 → 0.1.24

package/dist/initialization.js

@@ -3,7 +3,7 @@
  */
 import { CountriesDBClient } from '@countriesdb/widget-core';
 import { initializeSelect, populateCountrySelect, buildSubdivisionOptionsHTML, applyPreselectedValue, handleApiError, } from './dom-manipulation';
-import { dispatchUpdateEvent, isWidgetInitiatedEvent } from './event-system';
+import { dispatchReadyEvent, dispatchUpdateEvent, isWidgetInitiatedEvent, } from './event-system';
 import { triggerFollowLogic, handleFollowRelatedFromSubdivision, handleFollowUpwardFromSubdivision, handleFollowUpwardFromCountry, } from './follow-logic';
 /**
  * Setup subdivision selection elements
@@ -20,7 +20,8 @@ export async function setupSubdivisionSelection(apiKey, backendUrl, state, confi
             : null;
         // Check if linked country select is multi-select (not allowed)
         if (linkedCountrySelect && linkedCountrySelect.hasAttribute('multiple')) {
-            handleApiError(select, 'Cannot link to multi-select country. Use data-country-code instead.', true);
+            const defaultValue = select.dataset.defaultValue ?? '';
+            select.innerHTML = `<option value="${defaultValue}" disabled>Error: Cannot link to multi-select country. Use data-country-code instead.</option>`;
             continue;
         }
         // No direct link → maybe data-country-code
@@ -30,7 +31,8 @@ export async function setupSubdivisionSelection(apiKey, backendUrl, state, confi
                 await updateSubdivisionSelect(select, apiKey, backendUrl, state, config, select.dataset.countryCode);
             }
             else {
-                handleApiError(select, 'No country select present');
+                const defaultValue = select.dataset.defaultValue ?? '';
+                select.innerHTML += `<option value="${defaultValue}" disabled>Error: No country select present</option>`;
             }
         }
         // Always dispatch an update event for user-initiated subdivision changes
@@ -76,8 +78,10 @@ export async function updateSubdivisionSelect(select, apiKey, backendUrl, state,
             // 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') ||
-                config.preferOfficialSubdivisions;
+            // Use data attribute if present, otherwise use config
+            const preferOfficial = select.hasAttribute('data-prefer-official')
+                ? true
+                : config.preferOfficialSubdivisions;
             const languageHeaders = CountriesDBClient.getLanguageHeaders(config.forcedLanguage, config.defaultLanguage);
             const subdivisionsResult = await CountriesDBClient.fetchSubdivisions({
                 apiKey,
@@ -163,6 +167,10 @@ export async function updateSubdivisionSelect(select, apiKey, backendUrl, state,
         finally {
             // Mark initialization as complete
             state.isInitializing.delete(select);
+            dispatchReadyEvent(select, {
+                type: 'subdivision',
+                phase: isReload ? 'reload' : 'initial',
+            });
             // Only fire 'reload' if this is a reload, not initial load
             if (isReload && !valueSetByWidget) {
                 dispatchUpdateEvent(select, {
@@ -174,7 +182,8 @@ export async function updateSubdivisionSelect(select, apiKey, backendUrl, state,
     }
     else if (!select.dataset.country ||
         !document.querySelector(`.country-selection[data-name="${select.dataset.country}"]`)) {
-        handleApiError(select, 'No country select present');
+        const defaultValue = select.dataset.defaultValue ?? '';
+        select.innerHTML += `<option value="${defaultValue}" disabled>Error: No country select present</option>`;
     }
 }
 /**
@@ -203,7 +212,8 @@ export async function setupCountrySelection(apiKey, backendUrl, state, config, s
         if (name && seenNames[name]) {
             select.removeAttribute('data-name');
             initializeSelect(select, '&mdash;');
-            handleApiError(select, 'Duplicate field');
+            const defaultValue = select.dataset.defaultValue ?? '';
+            select.innerHTML += `<option value="${defaultValue}" disabled>Error: Duplicate field</option>`;
             continue;
         }
         if (name) {
@@ -304,6 +314,10 @@ export async function setupCountrySelection(apiKey, backendUrl, state, config, s
         finally {
             // Mark initialization as complete
             state.isInitializing.delete(select);
+            dispatchReadyEvent(select, {
+                type: 'country',
+                phase: 'initial',
+            });
             // If no preselected and no geoip selection happened, emit a regular update
             if (!valueSetByWidget) {
                 dispatchUpdateEvent(select, { type: 'country', reason: 'regular' });

package/dist/types.d.ts

@@ -27,6 +27,9 @@ export interface UpdateEventDetail {
     type?: 'country' | 'subdivision';
     reason?: 'regular' | 'geoip' | 'preselected' | 'reload' | 'follow';
 }
+export interface ReadyEventDetail extends UpdateEventDetail {
+    phase: 'initial' | 'reload';
+}
 export interface WidgetState {
     countriesMap: WeakMap<SelectElement, Country[]>;
     subdivisionsMap: WeakMap<SelectElement, Subdivision[]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@countriesdb/widget",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "description": "Country and state/province select widget with ISO 3166-1 and ISO 3166-2 codes. Auto-populates dropdowns with up-to-date country and subdivision data in multiple languages. Easy integration for forms, location selection, and address validation.",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",