@autobusal/common 1.27.4 → 1.27.5

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+
+## 1.27.5
+
+### Added
+
+- **`placeholder` on a `select`** — a leading empty option, for "nothing
+  chosen".
+
+  A select whose value matches no option silently displays the first one and
+  the browser submits it as though it had been picked. That is exactly how
+  every profile whose owner never touched the country field was saved as
+  **Afghanistan**: it sorts first, and nothing had ever been selected.
+  Changing the default from `0` to `''` did not help on its own — neither
+  value exists as an option, so the browser fell back either way.
+
+  Rendered only when placeholder text is supplied, so a select with a real
+  default (sex, status, a type) does not grow an empty row it never wanted.
+
 ## 1.27.4
 
 ### Fixed

package/Viewer/Items/Dropdown.tsx

@@ -30,9 +30,27 @@ const Dropdown = ({ item, refs, t }: Props): (JSX.Element | null) => {
       { item.name }
     </option>
   ));
-  
+
+  /**
+   * Edited: Ferjolt Ozuni - Date: 2026-08-06
+   *
+   * A select whose value matches NO option silently shows the first one, and
+   * the browser then submits it as though it had been chosen. That is how
+   * every profile whose owner did not touch the country field was saved as
+   * Afghanistan - it sorts first, and nothing had ever been selected.
+   *
+   * An empty leading option gives "nothing chosen" somewhere to live, so the
+   * field reads as unanswered and a `required` rule can say so. Rendered
+   * only when the caller supplies placeholder text: a select with a real
+   * default (sex, status, a type) should not grow an empty row it does not
+   * want.
+   */
   return (
-    <select defaultValue={ item?.value } { ...refs(item.name, rules) }>
+    <select defaultValue={ item?.value ?? '' } { ...refs(item.name, rules) }>
+      { item.placeholder !== undefined && (
+        <option value="">{ item.placeholder }</option>
+      ) }
+
       { values }
     </select>
   );

package/Viewer/types.ts

@@ -5,6 +5,14 @@ export interface ViewData {
   name?: string
   type?: 'text' | 'select' | 'date' | 'dob' | 'picker' | 'textarea' | 'textarea-html' | 'file' | 'files' | 'email' | 'password' | 'display' | 'component' | 'checkbox' | 'checkbox-list' | 'checkbox-list-all' | 'link' | 'number' | 'float' | 'date-picker'
   value?: string | number | JSX.Element
+  /**
+   * Edited: Ferjolt Ozuni - Date: 2026-08-06
+   * Leading empty option for a select, for "nothing chosen". Without one a
+   * select whose value matches no option silently shows - and submits - the
+   * first, which is how profiles were being saved as Afghanistan.
+   */
+  placeholder?: string
+
   values?: DropdownData[]
   selected?: any[]
   rules?: string

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autobusal/common",
-  "version": "1.27.4",
+  "version": "1.27.5",
   "author": "Ferjolt Ozuni",
   "type": "module",
   "main": "index.ts"