@privaty/ui-forms 0.3.2 → 0.4.0

package/README.md

@@ -102,10 +102,17 @@ everywhere else.
 // Checkboxes: unchecked submits NOTHING — the schema supplies the false.
 inStock: v.optional(v.boolean(), false),
 
-// Placeholder selects: the disabled placeholder is skipped by submission —
-// default "" so YOUR message fires instead of a raw missing-key error.
+// REQUIRED placeholder selects: the disabled prompt is skipped by
+// submission — default "" so YOUR message fires instead of a raw
+// missing-key error. (Optional selects are clearable instead: the empty
+// pick SUBMITS "", so a plain v.optional(v.string()) receives it.)
 category: v.pipe(v.optional(v.string(), ""), v.picklist(categories, "required")),
 
+// Optional selects, when the handler prefers undefined over "": FormData
+// cannot carry an absent value from an enabled option, so normalize at
+// the schema boundary — the designed seam for exactly this.
+categoryId: v.optional(v.pipe(v.string(), v.transform((value) => value || undefined))),
+
 // Month inputs submit "YYYY-MM"; empty submits "".
 availableFrom: v.pipe(v.string(), v.nonEmpty("required"), v.regex(/^\d{4}-\d{2}$/, "invalid-month")),
 ```

package/dist/inputs/select-input.svelte

@@ -27,8 +27,11 @@ instead of disabling — a disabled select is excluded from FormData.
      * `{ value: s, label: s }`; values must be unique — they key the
      * rendered list. */
     options: readonly (string | SelectOption)[];
-    /** Rendered as a disabled empty option, shown until a value is chosen.
-     * Its presence also makes "" the default seed for an unseeded field. */
+    /** The empty option's label — a disabled prompt on required fields, a
+     * selectable "none" row on optional ones (see Select's `clearable`;
+     * this input derives it from `required`, which never becomes the
+     * native attribute). Its presence also makes "" the default seed for
+     * an unseeded field. */
     placeholder?: string;
 
     /** Label placement: "top" (default), "left", or "hidden" — floating is
@@ -139,6 +142,7 @@ instead of disabling — a disabled select is excluded from FormData.
   {labelStyle}
   {options}
   {placeholder}
+  clearable={!required}
   errors={wired.errors}
   marker={wired.marker}
   aria-invalid={wired.errors.length > 0 ? true : undefined}

package/dist/inputs/select-input.svelte.d.ts

@@ -11,8 +11,11 @@ interface Props {
      * `{ value: s, label: s }`; values must be unique — they key the
      * rendered list. */
     options: readonly (string | SelectOption)[];
-    /** Rendered as a disabled empty option, shown until a value is chosen.
-     * Its presence also makes "" the default seed for an unseeded field. */
+    /** The empty option's label — a disabled prompt on required fields, a
+     * selectable "none" row on optional ones (see Select's `clearable`;
+     * this input derives it from `required`, which never becomes the
+     * native attribute). Its presence also makes "" the default seed for
+     * an unseeded field. */
     placeholder?: string;
     /** Label placement: "top" (default), "left", or "hidden" — floating is
      * not offered for selects. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@privaty/ui-forms",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -39,25 +39,25 @@
     "access": "public"
   },
   "peerDependencies": {
+    "@privaty/ui": "^0.4.0",
     "@sveltejs/kit": "^3.0.0-next.0",
-    "svelte": "^5.29.0",
-    "@privaty/ui": "^0.3.2"
+    "svelte": "^5.29.0"
   },
   "dependencies": {
-    "@lucide/svelte": "^1.34.0",
+    "@lucide/svelte": "^1.39.0",
     "@standard-schema/spec": "^1.1.0"
   },
   "devDependencies": {
+    "@config/eslint": "0.0.0",
+    "@config/typescript": "0.0.0",
+    "@privaty/ui": "0.4.0",
     "@sveltejs/kit": "3.0.0-next.25",
     "@sveltejs/package": "^2.5.8",
     "eslint": "^10.9.1",
-    "publint": "^0.3.21",
-    "svelte": "^5.56.10",
+    "publint": "^0.3.24",
+    "svelte": "^5.57.0",
     "svelte-check": "^4.7.6",
-    "typescript": "^6.0.3",
-    "@config/eslint": "0.0.0",
-    "@config/typescript": "0.0.0",
-    "@privaty/ui": "0.3.2"
+    "typescript": "^6.0.3"
   },
   "scripts": {
     "check": "svelte-check --tsconfig ./tsconfig.json",