@thi.ng/rdom-forms 0.3.33 → 0.4.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-09-19T21:09:34Z
+- **Last updated**: 2024-10-05T12:12:32Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,15 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [0.4.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/rdom-forms@0.4.0) (2024-10-05)
+
+#### 🚀 Features
+
+- update attrib & value config handling ([7495584](https://github.com/thi-ng/umbrella/commit/7495584))
+  - allow reactive attributes in more places
+  - don't generate event handlers if widget spec has no `value` option
+  - always apply user provided attribs (incl. event handlers) last
+
 ### [0.3.1](https://github.com/thi-ng/umbrella/tree/@thi.ng/rdom-forms@0.3.1) (2024-03-28)
 
 #### 🩹 Bug fixes

package/README.md

@@ -132,7 +132,7 @@ Browser ESM import:
 
 [JSDelivr documentation](https://www.jsdelivr.com/)
 
-Package sizes (brotli'd, pre-treeshake): ESM: 2.28 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 2.30 KB
 
 ## Dependencies
 

package/api.d.ts

@@ -33,14 +33,22 @@ export interface Custom extends Pick<FormItem, "type"> {
 export interface Group extends FormItem {
     type: "group";
     items: FormItem[];
-    label?: string | false;
+    label?: StringAttrib | false;
 }
 export interface Value extends FormItem, Partial<CommonAttribs> {
     id: string;
     name?: string;
-    label?: string | false;
+    /**
+     * If false, no `<label>` element will be generated for this control and the
+     * {@link Value.desc} value will be unused.
+     */
+    label?: StringAttrib | false;
     desc?: any;
     required?: boolean;
+    /**
+     * If true, no input/change event handlers will be generated and the
+     * `readonly` attribute will be set on the input DOM element.
+     */
     readonly?: boolean;
     attribs?: Partial<InputAttribs>;
 }
@@ -59,7 +67,7 @@ export interface Num extends Value, WithPresets<number> {
     type: "num";
     min?: number;
     max?: number;
-    placeholder?: string;
+    placeholder?: StringAttrib;
     size?: number;
     step?: number;
     value?: ISubscription<number, number>;
@@ -74,7 +82,7 @@ export interface Str extends Value, WithPresets<string> {
     min?: number;
     max?: number;
     pattern?: string | RegExp | Predicate<string>;
-    placeholder?: string;
+    placeholder?: StringAttrib;
     size?: number;
     value?: ISubscription<string, string>;
     attribs?: Partial<InputTextAttribs>;
@@ -98,7 +106,7 @@ export interface Text extends Value {
     type: "text";
     cols?: number;
     rows?: number;
-    placeholder?: string;
+    placeholder?: StringAttrib;
     value?: ISubscription<string, string>;
     attribs?: Partial<TextAreaAttribs>;
 }
@@ -164,18 +172,18 @@ export interface Toggle extends Value {
 }
 export interface Trigger extends Value {
     type: "trigger";
-    title: string;
+    title: StringAttrib;
     value?: ISubscriber<boolean>;
 }
 export interface Submit extends Omit<Value, "required" | "readonly"> {
     type: "submit";
-    title: string;
+    title: StringAttrib;
     value?: ISubscriber<boolean>;
     attribs?: Partial<InputSubmitAttribs>;
 }
 export interface Reset extends Omit<Value, "required" | "readonly"> {
     type: "submit";
-    title: string;
+    title: StringAttrib;
     value?: ISubscriber<boolean>;
 }
 export interface Radio<T> extends Value {
@@ -268,7 +276,8 @@ export interface BehaviorOpts {
      */
     labels: boolean;
     /**
-     * If false, no `value` attributes and event handlers will be generated.
+     * If false, no `value` attributes and event handlers will be generated,
+     * even if a `value` option has been specified.
      *
      * @defaultValue true
      */

package/compile.js

@@ -112,25 +112,22 @@ const __genCommon = (val, opts) => {
 };
 const __attribs = (attribs, events, val, opts, value = "value") => {
   const id = __genID(val.id, opts);
-  Object.assign(
-    attribs,
-    {
-      id,
-      name: val.name || val.id,
-      list: val.list ? id + "--list" : void 0,
-      required: val.required,
-      readonly: val.readonly
-    },
-    val.attribs
-  );
+  Object.assign(attribs, {
+    id,
+    name: val.name || val.id,
+    list: val.list ? id + "--list" : void 0,
+    required: val.required,
+    readonly: val.readonly
+  });
   if (__useValues(opts)) {
-    if (!val.readonly) {
+    if (!val.readonly && val.value !== void 0) {
       Object.assign(attribs, events);
     }
     if (value !== false) {
       attribs[value] = val.value;
     }
   }
+  if (val.attribs) Object.assign(attribs, val.attribs);
   return attribs;
 };
 const __component = (val, opts, el, attribs, events, value = "value", ...body) => div(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/rdom-forms",
-  "version": "0.3.33",
+  "version": "0.4.1",
   "description": "Data-driven declarative & extensible HTML form generation",
   "type": "module",
   "module": "./index.js",
@@ -36,16 +36,16 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.10",
-    "@thi.ng/checks": "^3.6.12",
-    "@thi.ng/defmulti": "^3.0.48",
-    "@thi.ng/hiccup-html": "^2.7.7",
-    "@thi.ng/rdom": "^1.7.5",
-    "@thi.ng/rstream": "^9.0.4"
+    "@thi.ng/api": "^8.11.11",
+    "@thi.ng/checks": "^3.6.13",
+    "@thi.ng/defmulti": "^3.0.49",
+    "@thi.ng/hiccup-html": "^2.7.8",
+    "@thi.ng/rdom": "^1.7.7",
+    "@thi.ng/rstream": "^9.0.6"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.47.9",
-    "esbuild": "^0.23.1",
+    "esbuild": "^0.24.0",
     "typedoc": "^0.26.7",
     "typescript": "^5.6.2"
   },
@@ -96,5 +96,5 @@
     "status": "alpha",
     "year": 2023
   },
-  "gitHead": "dadc6e71940c091e50fbf9f88ea3ba115d3937df\n"
+  "gitHead": "241df2019d93359c34da1a11a94e416b6ea73f32\n"
 }