cotomy 1.0.2 → 1.0.4

package/README.md

@@ -50,7 +50,8 @@ The View layer provides thin wrappers around DOM elements and window events.
 - Identity & matching
   - `instanceId: string` — Always returns the element's `data-cotomy-instance` (generated when missing, respects existing values)
   - `id: string | null | undefined`
-  - `attached: boolean` — True when the element is connected to a document
+  - `attached: boolean` — True when the element belongs to the current window document
+  - `isConnected: boolean` — True when the element is connected to any document tree (Node.isConnected)
   - `generateId(prefix = "__cotomy_elem__"): this`
   - `is(selector: string): boolean` — Parent-aware matching helper
   - `empty: boolean` — True for tags that cannot have children or have no content
@@ -242,7 +243,7 @@ The Form layer builds on `CotomyElement` for common form flows.
   - `loadActionUrl: string` — Defaults to `actionUrl`; override or set for custom endpoints
   - `canLoad: boolean` — Defaults to `hasEntityKey`
 - Naming & binding
-  - `bindNameGenerator(): ICotomyBindNameGenerator` — Defaults to `CotomyBracketBindNameGenerator` (`user[name]`)
+  - `bindNameGenerator(): ICotomyBindNameGenerator` — Defaults to `CotomyViewRenderer.defaultBindNameGenerator` (initial value: `CotomyBracketBindNameGenerator`, `user[name]`)
   - `renderer(): CotomyViewRenderer` — Applies `[data-cotomy-bind]` to view elements
 - `filler(type, (input, value))` — Register fillers; defaults provided for `datetime-local`, `checkbox`, `radio`
   - Fills non-array, non-object fields by matching input/select/textarea `name`
@@ -261,8 +262,7 @@ Example:
 
 ```ts
 const view = new CotomyViewRenderer(
-  new CotomyElement(document.querySelector("#profile")!),
-  new CotomyBracketBindNameGenerator()
+  new CotomyElement(document.querySelector("#profile")!)
 );
 
 await view.applyAsync(apiResponse); // apiResponse is CotomyApiResponse from CotomyApi
@@ -288,6 +288,24 @@ form.apiFailed(e => console.error("API failed", e.response.status));
 form.submitFailed(e => console.warn("Submit failed", e.response.status));
 ```
 
+To switch the default bind naming style for a page, set it from your page controller:
+
+```ts
+import {
+  CotomyDotBindNameGenerator,
+  CotomyEntityFillApiForm,
+  CotomyPageController
+} from "cotomy";
+
+CotomyPageController.set(class extends CotomyPageController {
+  protected override async initializeAsync(): Promise<void> {
+    this.defaultBindNameGenerator = new CotomyDotBindNameGenerator();
+
+    this.setForm(CotomyEntityFillApiForm.byId("profile-form", CotomyEntityFillApiForm)!);
+  }
+});
+```
+
 ### Entity API forms
 
 `CotomyEntityApiForm` targets REST endpoints that identify records with a single surrogate key.  

package/dist/browser/cotomy.js

@@ -1113,6 +1113,9 @@ class CotomyElement {
             || this._element.innerHTML.trim() === "";
     }
     get attached() {
+        return document.contains(this.element);
+    }
+    get isConnected() {
         return this.element.isConnected;
     }
     get readonly() {
@@ -2448,8 +2451,28 @@ class CotomyDotBindNameGenerator {
         return parent ? `${parent}[${index}]` : `[${index}]`;
     }
 }
+class CotomyBindNameGeneratorProvider {
+    static getDefault() {
+        return this._default ?? (this._default = new CotomyBracketBindNameGenerator());
+    }
+    static setDefault(generator) {
+        this._default = generator;
+    }
+    static resetDefault() {
+        this._default = undefined;
+    }
+}
 class CotomyViewRenderer {
-    constructor(element, bindNameGenerator) {
+    static get defaultBindNameGenerator() {
+        return CotomyBindNameGeneratorProvider.getDefault();
+    }
+    static set defaultBindNameGenerator(generator) {
+        CotomyBindNameGeneratorProvider.setDefault(generator);
+    }
+    static resetDefaultBindNameGenerator() {
+        CotomyBindNameGeneratorProvider.resetDefault();
+    }
+    constructor(element, bindNameGenerator = CotomyViewRenderer.defaultBindNameGenerator) {
         this.element = element;
         this.bindNameGenerator = bindNameGenerator;
         this._renderers = {};
@@ -3045,7 +3068,7 @@ class CotomyEntityFillApiForm extends CotomyEntityApiForm {
         return this.actionUrl;
     }
     bindNameGenerator() {
-        return new CotomyBracketBindNameGenerator();
+        return CotomyViewRenderer.defaultBindNameGenerator;
     }
     renderer() {
         return new CotomyViewRenderer(this, this.bindNameGenerator());
@@ -3149,6 +3172,7 @@ var utc_default = /*#__PURE__*/__webpack_require__.n(utc);
 
 
 
+
 dayjs_min_default().extend((utc_default()));
 dayjs_min_default().extend((timezone_default()));
 class CotomyUrl {
@@ -3210,6 +3234,12 @@ class CotomyPageController {
         }
         return this._instance;
     }
+    get defaultBindNameGenerator() {
+        return CotomyViewRenderer.defaultBindNameGenerator;
+    }
+    set defaultBindNameGenerator(value) {
+        CotomyViewRenderer.defaultBindNameGenerator = value;
+    }
     setForm(form) {
         if (!form.id) {
             form.generateId();