@livenetworks/ashlar 1.6.1 → 2.0.0

package/{js → components}/ln-form/README.md

@@ -1,264 +1,260 @@
-# ln-form
-
-A minimal **form manipulation** primitive. `ln-form` does exactly two
-things to a native `<form>`: populate it when an `ln-fill` event delivers
-a record, and rewrite `action` / `_method` for RESTful edit routing.
-Submit is entirely native HTML — `ln-form` does not listen for `submit`
-at all. Validation display and the submit gate are owned entirely by
-[`ln-validate`](../ln-validate/README.md).
-
----
-
-## 1. Philosophy
-
-1. **Populate, don't orchestrate.** `ln-form` writes values into the form
-   on `ln-fill` and dispatches synthetic `input`/`change` events so
-   reactive consumers (`ln-validate`, `ln-autoresize`) react in sync. It
-   keeps no validation state and no submit-button logic.
-2. **Native submit, always.** Forms MUST carry a real `action` and
-   `method` in HTML. Without JavaScript they do a normal native submit.
-   PUT/DELETE ride on POST via an auto-ensured hidden `_method` input
-   (Laravel method spoofing) — `ln-form` never serializes data, never
-   dispatches a submit event, and never listens for `submit` at all.
-3. **Transport is someone else's job.** Ajax interception (if wanted) is
-   a separate component's concern — it listens to the native `submit`
-   event itself. Validation is owned by the browser's constraint
-   validation plus `ln-validate` for field error display and the submit
-   gate — a form with at least one `data-ln-validate` field gets
-   `novalidate` injected automatically and the first such field attaches
-   the form's submit gate; a form with none keeps native validation as
-   the default.
-
----
-
-## 2. Minimal Blueprint
-
-```html
-<form id="user-form" data-ln-form action="/users" method="post">
-	<div class="form-element">
-		<label for="username">Username</label>
-		<input id="username" name="username" required data-ln-validate>
-		<ul data-ln-validate-errors>
-			<li hidden data-ln-validate-error="required">Username is required</li>
-		</ul>
-	</div>
-
-	<ul class="form-actions">
-		<li><button type="button" data-ln-modal-close>Cancel</button></li>
-		<li><button type="submit">Save</button></li>
-	</ul>
-</form>
-```
-
-> [!WARNING]
-> Always set `type="button"` on Cancel buttons. Otherwise the browser
-> defaults to `type="submit"` and triggers a real submit.
-
----
-
-## 3. Declarative API Contract
-
-### HTML Attributes
-
-| Attribute | Elements | Description |
-| :--- | :--- | :--- |
-| `data-ln-form` | `<form>` | Initializes the coordinator. |
-| `data-ln-form-action-edit` | `<form>` | Opt-in RESTful action routing. See below. |
-| `data-ln-form-action-method="PUT"` | `<form>` | Override verb for `_method` (default `PUT`). Requires `data-ln-form-action-edit`. |
-| `data-ln-form-scope` | `<form>` | Opt-in local-first write path. Empty = nearest ancestor `[data-ln-data-coordinator]`. Named = explicit coordinator override. Intercepts submit; incompatible with native/ajax submit on the same form. |
-
-### JS API
-
-Access the instance directly via the `lnForm` property on the form
-element:
-
-```javascript
-const form = document.getElementById('user-form');
-
-// Bulk populate fields by name (fires synthetic input/change events)
-form.lnForm.fill({ username: 'dalibor', role: 'admin' });
-
-// Clean up listeners and destroy the instance
-form.lnForm.destroy();
-```
-
----
-
-## 4. DOM Events
-
-### Emitted
-
-| Event | Bubbles | Payload | Description |
-| :--- | :--- | :--- | :--- |
-| `ln-form:destroyed` | Yes | `{ target: HTMLElement }` | Dispatched when the coordinator is torn down. |
-
-### Received
-
-| Event | Payload | Description |
-| :--- | :--- | :--- |
-| `ln-fill` | `record \| null` | Canonical fan-out fill. `detail` → `this.fill(detail)` + apply action mode; `null` → native `form.reset()`. Guarded: only handled when `e.target === self.dom`. |
-
----
-
-## 5. RESTful action routing (create vs. edit)
-
-For Laravel REST backends, `ln-form` can rewrite `form.action` and inject
-a hidden `_method` input driven off the fill record — no coordinator JS,
-no second click listener.
-
-**Opt-in:** add `data-ln-form-action-edit` to the `<form>`. Forms without
-this attribute are completely inert — this feature does not exist for
-them.
-
-### Attributes
-
-| Attribute | On | Description |
-| :--- | :--- | :--- |
-| `data-ln-form-action-edit` | `<form>` | Opt-in. Empty value = RESTful default (`baseAction + '/' + id`). Non-empty value = template with `:id` placeholder. |
-| `data-ln-form-action-edit="/path/:id"` | `<form>` | Template variant — `:id` is replaced with `encodeURIComponent(record.id)`. |
-| `data-ln-form-action-method="PUT"` | `<form>` | HTTP verb written into `_method` on edit. Default: `PUT`. |
-
-> The `<input name="_method">` is auto-ensured — do not author it
-> manually. `ln-form` creates it on first fill if absent, or reuses the
-> existing one.
-
-### Behavior
-
-| Fill state | `form.action` | `<input name="_method">` |
-| :--- | :--- | :--- |
-| Edit (record with `id`) | Rewritten to edit URL | `PUT` (or custom verb) |
-| New (`null` detail) | Restored to base action | `''` (empty — Laravel ignores) |
-
-### Examples
-
-```html
-<!-- Minimal: baseAction + '/' + id -->
-<form data-ln-form action="/packages" data-ln-form-action-edit>
-
-<!-- Custom template -->
-<form data-ln-form action="/packages" data-ln-form-action-edit="/packages/:id">
-
-<!-- Custom verb -->
-<form data-ln-form action="/packages"
-      data-ln-form-action-edit="/packages/:id"
-      data-ln-form-action-method="PATCH">
-```
-
-> [!NOTE]
-> This feature only rewrites `action`/`_method`. The actual HTTP request
-> (native submit or ajax) is out of scope for `ln-form`.
-
----
-
-## 6. What ln-form does NOT do
-
-- **No transport.** It does not make XHR/fetch requests. Submit is
-  native HTML; ajax interception (if desired) belongs to a separate
-  component that listens to the native `submit` event.
-- **No serialization, ever.** There is no `serializeForm` call inside
-  `ln-form`, no `ln-form:submit-record` event, no JSON payload — scoped
-  forms are serialized by the claiming `ln-data-coordinator`, not by
-  `ln-form`.
-- **No validation orchestration, no submit listener at all.** `ln-form`
-  never dispatches `ln-validate:request-validate`, never calls
-  `preventDefault()`, and never touches `novalidate` — all of that is
-  entirely [`ln-validate`](../ln-validate/README.md)'s job (see its
-  README §Philosophy). Claiming a valid submit for the write pipeline
-  (scoped forms only) is `ln-data-coordinator`'s job (native `submit`,
-  bubble phase, its own `preventDefault()`) — `ln-form` plays no role in
-  that decision either.
-
----
-
-## 5b. Local-first write routing (`data-ln-form-scope`)
-
-A form carrying `data-ln-form-scope` becomes the universal write entry
-point for local-first/SPA pages. The `submit` event is intercepted at
-three possible rungs, and whichever rung claims it decides the archetype:
-
-1. **Nobody** — native browser submit to `action` (+ `_method`), SSR.
-2. **`ln-ajax`** — fetch to `action`, page stays put (progressive
-   enhancement). `ln-ajax` explicitly skips forms carrying
-   `data-ln-form-scope` (see the `ln-ajax` README).
-3. **`ln-data-coordinator`** — a form with `data-ln-form-scope` has its
-   valid submit left native; `ln-form` never intercepts it beyond the
-   validation gate (§7 below). The nearest ancestor
-   `[data-ln-data-coordinator]` (or the named coordinator, if
-   `data-ln-form-scope="name"`) listens for the native `submit` on
-   `document` (bubble phase), claims it with `preventDefault()` once its
-   own scope/containment matches, serializes the form itself, and routes
-   it through the store → queue → connector write pipeline. See the
-   `ln-data-coordinator` README for the intake contract.
-
-`ln-validate`'s submit gate runs on every method — GET included, exactly
-like the native browser validation it replaces. A search form nested
-inside a coordinator with invalid `data-ln-validate` fields is blocked
-the same as any other form; a form with no `data-ln-validate` fields has
-no gate at all. `ln-data-coordinator` reads the effective method
-(`_method` input if present and non-empty, else the form's `method`
-attribute) independently, purely to decide whether to claim the native
-submit for the write pipeline (`POST` → create, `PUT`/`PATCH` → update) —
-a `GET` form is never claimed, regardless of validity. `ln-form` itself
-stays coordinator-blind and validation-blind: it never serializes, never
-dispatches a custom event, and never listens for `submit`.
-
----
-
-## 7. Common Pitfalls
-
-- **Setting `input.value` directly:** Doing `input.value = 'new'` is
-  silent in the DOM. Neither validation nor layout systems will detect
-  the change. **Always** use `form.lnForm.fill()` or manually dispatch an
-  `input`/`change` event.
-- **Expecting a submit event:** `ln-form` never dispatches anything on
-  submit — there is no `ln-form:submit` and no `ln-form:submit-record`
-  either. Listen to the form's native `submit` event, or the resulting
-  `ln-data-store:created`/`ln-data-store:updated` outcome, instead.
-
----
-
-## 8. Integration & Source Files
-
-- **Unified Bundle**: Loaded automatically with the main bundle:
-  ```html
-  <script src="dist/ln-ashlar.iife.js" defer></script>
-  ```
-- **Standalone IIFE**: For lightweight pages, load the standalone,
-  self-registering IIFE version:
-  ```html
-  <script src="js/ln-form/ln-form.js" defer></script>
-  ```
-- **Active Source (ESM)**: Development source is located at
-  [js/ln-form/src/ln-form.js](file:///c:/laragon/www/ln-ashlar/js/ln-form/src/ln-form.js).
-
----
-
-## 🔧 Internals
-
-Source: `js/ln-form/ln-form.js`. Instance state is minimal: `dom` (the form) and `_baseAction` (the `action` attribute captured once at init, restored on "new" mode). No validation index, no debounce, no submit-button bookkeeping — `ln-form` does not orchestrate submission.
-
-### `fill(data)`
-
-Iterates `form.elements` writing by `name`: checkboxes get `.checked = Boolean(value)`, radios match `el.value === String(value)`, `select-multiple` sets `options[n].selected`, everything else sets `.value`. Each written element then dispatches exactly one synthetic event — `change` for `SELECT`/checkbox/radio, `input` otherwise (the `isChangeBased` discriminator). This mirrors the same discriminator `ln-validate` and `ln-autoresize` use for their own listener registration, so every field fires the event those consumers actually listen for — no double fires, no missed reactions.
-
-### `ln-fill` handling
-
-Guarded to `e.target === self.dom` (ignores bubbled `ln-fill` from nested `[data-ln-fillable]` children). A record calls `fill()` then `_applyActionMode(record)`; `null` calls `form.reset()` — the native `reset` event that fires from that call is what actually restores the base action (see below), not the `ln-fill` handler directly.
-
-### Reset routing
-
-The native `reset` event — whether from `form.reset()` above, a `<button type="reset">`, or any other trigger — always runs `_applyActionMode(null)`, restoring `_baseAction` and clearing `_method`. There is no synthetic input/change replay on reset and no `ln-form:reset-complete` event.
-
-### Action-mode guard
-
-`_applyActionMode` exits immediately on forms without `data-ln-form-action-edit` — unrelated forms are untouched by the reset/fill listeners' side effects.
-
-### Relation to ln-validate
-
-Independent siblings, no imports between them. `ln-validate` injects `novalidate` the moment its first field initializes (authors never write it by hand); a form with zero `data-ln-validate` fields keeps native validation as the default. `ln-validate` has its own separate `reset` listener (clears field error classes / `_touched` state) — unrelated to `ln-form`'s reset listener, which only handles action/`_method`.
-
----
-
-## Related
-- **[`ln-validate`](../ln-validate/README.md)** — Field-level validation and error display.
-- **[`ln-fill`](../ln-fill/README.md)** — Fan-out fill event source.
+# ln-form
+
+> Applied to a native `<form data-ln-form action="..." method="...">`. It listens for `ln-fill` events carrying a record payload:
+> populating matching controls (`[name="key"]`) and dispatching synthetic `input`/`change` events to update dependent components.
+> On edit workflows, it updates `form.action` and ensures an `<input type="hidden" name="_method" value="PUT">` exists for RESTful
+> method spoofing, without intercepting native form submission.
+
+---
+
+## 1. Philosophy
+
+1. **Populate, don't orchestrate.** `ln-form` writes values into the form
+   on `ln-fill` and dispatches synthetic `input`/`change` events so
+   reactive consumers (`ln-validate`, `ln-autoresize`) react in sync. It
+   keeps no validation state and no submit-button logic.
+2. **Native submit, always.** Forms MUST carry a real `action` and
+   `method` in HTML. Without JavaScript they do a normal native submit.
+   PUT/DELETE ride on POST via an auto-ensured hidden `_method` input
+   (Laravel method spoofing) — `ln-form` never serializes data, never
+   dispatches a submit event, and never listens for `submit` at all.
+3. **Transport is someone else's job.** Ajax interception (if wanted) is
+   a separate component's concern — it listens to the native `submit`
+   event itself. Validation is owned by the browser's constraint
+   validation plus `ln-validate` for field error display and the submit
+   gate — a form with at least one `data-ln-validate` field gets
+   `novalidate` injected automatically and the first such field attaches
+   the form's submit gate; a form with none keeps native validation as
+   the default.
+
+---
+
+## 2. Minimal Blueprint
+
+```html
+<form id="user-form" data-ln-form action="/users" method="post">
+	<div class="form-element">
+		<label for="username">Username</label>
+		<input id="username" name="username" required data-ln-validate>
+		<ul data-ln-validate-errors>
+			<li hidden data-ln-validate-error="required">Username is required</li>
+		</ul>
+	</div>
+
+	<ul class="form-actions">
+		<li><button type="button" data-ln-modal-close>Cancel</button></li>
+		<li><button type="submit">Save</button></li>
+	</ul>
+</form>
+```
+
+> [!WARNING]
+> Always set `type="button"` on Cancel buttons. Otherwise the browser
+> defaults to `type="submit"` and triggers a real submit.
+
+---
+
+## 3. Declarative API Contract
+
+### HTML Attributes
+
+| Attribute | Elements | Description |
+| :--- | :--- | :--- |
+| `data-ln-form` | `<form>` | Initializes the coordinator. |
+| `data-ln-form-action-edit` | `<form>` | Opt-in RESTful action routing. See below. |
+| `data-ln-form-action-method="PUT"` | `<form>` | Override verb for `_method` (default `PUT`). Requires `data-ln-form-action-edit`. |
+| `data-ln-data-coordinator-scope` | `<form>` | Opt-in local-first write path, carried by the form but read by `ln-data-coordinator`. Empty = nearest ancestor `[data-ln-data-coordinator]`. Named = explicit coordinator override. Intercepts submit; incompatible with native/ajax submit on the same form. |
+
+### JS API
+
+Access the instance directly via the `lnForm` property on the form
+element:
+
+```javascript
+const form = document.getElementById('user-form');
+
+// Bulk populate fields by name (fires synthetic input/change events)
+form.lnForm.fill({ username: 'dalibor', role: 'admin' });
+
+// Clean up listeners and destroy the instance
+form.lnForm.destroy();
+```
+
+---
+
+## 4. DOM Events
+
+### Emitted
+
+`ln-form` emits no custom events.
+
+### Received
+
+| Event | Payload | Description |
+| :--- | :--- | :--- |
+| `ln-fill` | `record \| null` | Canonical fan-out fill. `detail` → `this.fill(detail)` + apply action mode; `null` → native `form.reset()`. Guarded: only handled when `e.target === self.dom`. |
+
+---
+
+## 5. RESTful action routing (create vs. edit)
+
+For Laravel REST backends, `ln-form` can rewrite `form.action` and inject
+a hidden `_method` input driven off the fill record — no coordinator JS,
+no second click listener.
+
+**Opt-in:** add `data-ln-form-action-edit` to the `<form>`. Forms without
+this attribute are completely inert — this feature does not exist for
+them.
+
+### Attributes
+
+| Attribute | On | Description |
+| :--- | :--- | :--- |
+| `data-ln-form-action-edit` | `<form>` | Opt-in. Empty value = RESTful default (`baseAction + '/' + id`). Non-empty value = template with `:id` placeholder. |
+| `data-ln-form-action-edit="/path/:id"` | `<form>` | Template variant — `:id` is replaced with `encodeURIComponent(record.id)`. |
+| `data-ln-form-action-method="PUT"` | `<form>` | HTTP verb written into `_method` on edit. Default: `PUT`. |
+
+> The `<input name="_method">` is auto-ensured — do not author it
+> manually. `ln-form` creates it on first fill if absent, or reuses the
+> existing one.
+
+### Behavior
+
+| Fill state | `form.action` | `<input name="_method">` |
+| :--- | :--- | :--- |
+| Edit (record with `id`) | Rewritten to edit URL | `PUT` (or custom verb) |
+| New (`null` detail) | Restored to base action | `''` (empty — Laravel ignores) |
+
+### Examples
+
+```html
+<!-- Minimal: baseAction + '/' + id -->
+<form data-ln-form action="/packages" data-ln-form-action-edit>
+
+<!-- Custom template -->
+<form data-ln-form action="/packages" data-ln-form-action-edit="/packages/:id">
+
+<!-- Custom verb -->
+<form data-ln-form action="/packages"
+      data-ln-form-action-edit="/packages/:id"
+      data-ln-form-action-method="PATCH">
+```
+
+> [!NOTE]
+> This feature only rewrites `action`/`_method`. The actual HTTP request
+> (native submit or ajax) is out of scope for `ln-form`.
+
+---
+
+## 6. What ln-form does NOT do
+
+- **No transport.** It does not make XHR/fetch requests. Submit is
+  native HTML; ajax interception (if desired) belongs to a separate
+  component that listens to the native `submit` event.
+- **No serialization, ever.** There is no `serializeForm` call inside
+  `ln-form`, no `ln-form:submit-record` event, no JSON payload — scoped
+  forms are serialized by the claiming `ln-data-coordinator`, not by
+  `ln-form`.
+- **No validation orchestration, no submit listener at all.** `ln-form`
+  never dispatches `ln-validate:request-validate`, never calls
+  `preventDefault()`, and never touches `novalidate` — all of that is
+  entirely [`ln-validate`](../ln-validate/README.md)'s job (see its
+  README §Philosophy). Claiming a valid submit for the write pipeline
+  (scoped forms only) is `ln-data-coordinator`'s job (native `submit`,
+  bubble phase, its own `preventDefault()`) — `ln-form` plays no role in
+  that decision either.
+
+---
+
+## 5b. Local-first write routing (`data-ln-data-coordinator-scope`)
+
+A form carrying `data-ln-data-coordinator-scope` becomes the universal write entry
+point for local-first/SPA pages. The `submit` event is intercepted at
+three possible rungs, and whichever rung claims it decides the archetype:
+
+1. **Nobody** — native browser submit to `action` (+ `_method`), SSR.
+2. **`ln-ajax`** — fetch to `action`, page stays put (progressive
+   enhancement). `ln-ajax` explicitly skips forms carrying
+   `data-ln-data-coordinator-scope` (see the `ln-ajax` README).
+3. **`ln-data-coordinator`** — a form with `data-ln-data-coordinator-scope` has its
+   valid submit left native; `ln-form` never intercepts it beyond the
+   validation gate (§7 below). The nearest ancestor
+   `[data-ln-data-coordinator]` (or the named coordinator, if
+   `data-ln-data-coordinator-scope="name"`) listens for the native `submit` on
+   `document` (bubble phase), claims it with `preventDefault()` once its
+   own scope/containment matches, serializes the form itself, and routes
+   it through the store → queue → connector write pipeline. See the
+   `ln-data-coordinator` README for the intake contract.
+
+`ln-validate`'s submit gate runs on every method — GET included, exactly
+like the native browser validation it replaces. A search form nested
+inside a coordinator with invalid `data-ln-validate` fields is blocked
+the same as any other form; a form with no `data-ln-validate` fields has
+no gate at all. `ln-data-coordinator` reads the effective method
+(`_method` input if present and non-empty, else the form's `method`
+attribute) independently, purely to decide whether to claim the native
+submit for the write pipeline (`POST` → create, `PUT`/`PATCH` → update) —
+a `GET` form is never claimed, regardless of validity. `ln-form` itself
+stays coordinator-blind and validation-blind: it never serializes, never
+dispatches a custom event, and never listens for `submit`.
+
+---
+
+## 7. Common Pitfalls
+
+- **Setting `input.value` directly:** Doing `input.value = 'new'` is
+  silent in the DOM. Neither validation nor layout systems will detect
+  the change. **Always** use `form.lnForm.fill()` or manually dispatch an
+  `input`/`change` event.
+- **Expecting a submit event:** `ln-form` never dispatches anything on
+  submit — there is no `ln-form:submit` and no `ln-form:submit-record`
+  either. Listen to the form's native `submit` event, or the resulting
+  `ln-data-store:created`/`ln-data-store:updated` outcome, instead.
+
+---
+
+## 8. Integration & Source Files
+
+- **Unified Bundle**: Loaded automatically with the main bundle:
+  ```html
+  <script src="dist/ln-ashlar.iife.js" defer></script>
+  ```
+- **Standalone IIFE**: For lightweight pages, load the standalone,
+  self-registering IIFE version:
+  ```html
+  <script src="components/ln-form/ln-form.js" defer></script>
+  ```
+- **Active Source (ESM)**: Development source is located at
+  [components/ln-form/src/ln-form.js](file:///c:/laragon/www/ln-ashlar/components/ln-form/src/ln-form.js).
+
+---
+
+## 🔧 Internals
+
+Source: `components/ln-form/ln-form.js`. Instance state is minimal: `dom` (the form) and `_baseAction` (the `action` attribute captured once at init, restored on "new" mode). No validation index, no debounce, no submit-button bookkeeping — `ln-form` does not orchestrate submission.
+
+### `fill(data)`
+
+Iterates `form.elements` writing by `name`: checkboxes get `.checked = Boolean(value)`, radios match `el.value === String(value)`, `select-multiple` sets `options[n].selected`, everything else sets `.value`. Each written element then dispatches exactly one synthetic event — `change` for `SELECT`/checkbox/radio, `input` otherwise (the `isChangeBased` discriminator). This mirrors the same discriminator `ln-validate` and `ln-autoresize` use for their own listener registration, so every field fires the event those consumers actually listen for — no double fires, no missed reactions.
+
+### `ln-fill` handling
+
+Guarded to `e.target === self.dom` (ignores bubbled `ln-fill` from nested `[data-ln-fillable]` children). A record calls `fill()` then `_applyActionMode(record)`; `null` calls `form.reset()` — the native `reset` event that fires from that call is what actually restores the base action (see below), not the `ln-fill` handler directly.
+
+### Reset routing
+
+The native `reset` event — whether from `form.reset()` above, a `<button type="reset">`, or any other trigger — always runs `_applyActionMode(null)`, restoring `_baseAction` and clearing `_method`. There is no synthetic input/change replay on reset and no `ln-form:reset-complete` event.
+
+### Action-mode guard
+
+`_applyActionMode` exits immediately on forms without `data-ln-form-action-edit` — unrelated forms are untouched by the reset/fill listeners' side effects.
+
+### Relation to ln-validate
+
+Independent siblings, no imports between them. `ln-validate` injects `novalidate` the moment its first field initializes (authors never write it by hand); a form with zero `data-ln-validate` fields keeps native validation as the default. `ln-validate` has its own separate `reset` listener (clears field error classes / `_touched` state) — unrelated to `ln-form`'s reset listener, which only handles action/`_method`.
+
+---
+
+## Related
+- **[`ln-validate`](../ln-validate/README.md)** — Field-level validation and error display.
+- **[`ln-fill`](../ln-fill/README.md)** — Fan-out fill event source.

package/components/ln-form/ln-form-dev.scss

@@ -0,0 +1,8 @@
+@use '../../theme/config/mixins' as *;
+
+[data-ln-debug] {
+	// 1. Host Element Check: data-ln-form belongs only on <form> elements
+	[data-ln-form]:not(form) {
+		@include dev-inline-error("data-ln-form belongs only on <form> elements");
+	}
+}

package/components/ln-form/ln-form.js

@@ -0,0 +1 @@
+(function(){"use strict";function E(){return typeof window>"u"?!1:window.lnDebug===!0||window.lnCore&&window.lnCore._debugSink?!0:typeof document<"u"&&document.body?document.body.hasAttribute("data-ln-debug")||document.body.querySelector("[data-ln-debug]")!==null:!1}function g(e){if(typeof window>"u")return!1;if(window.lnDebug===!0)return!0;if(window.lnCore&&window.lnCore._debugIsContained)return e?window.lnCore._debugIsContained(e):window.lnCore._debugSink!==null;if(e&&e.closest){const t=e.closest("[data-ln-debug]");return!(!t||typeof document<"u"&&t===document.documentElement)}return typeof document<"u"&&document.body?document.body.hasAttribute("data-ln-debug"):!1}if(typeof window<"u"&&(window.lnCore=window.lnCore||{},!window.lnCore._warnBound)){window.lnCore._warnBound=!0;const e=console.warn;console.warn=function(...t){if(typeof t[0]=="string"&&(t[0].startsWith("[ln-")||t[0].startsWith("[lnCore"))){let o=null;for(let l=1;l<t.length;l++)if(t[l]&&t[l].nodeType===1){o=t[l];break}if(!g(o))return}e.apply(console,t)}}function B(e,t,n){const o=n||{};window.lnCore._debugSink&&window.lnCore._debugSink("event",t,e,o),e.dispatchEvent(new CustomEvent(t,{bubbles:!0,detail:o}))}function b(e,t){if(!document.body){document.addEventListener("DOMContentLoaded",function(){b(e,t)}),console.warn("["+t+'] Script loaded before <body> — add "defer" to your <script> tag');return}e()}function j(e){if(typeof e!="string")return!!e;const t=e.trim().toLowerCase();return t!=="false"&&t!=="0"&&t!==""&&t!=="off"&&t!=="no"}function W(e,t){const n=e.elements,o=[],l={};for(let i=0;i<n.length;i++){const r=n[i];r.name&&r.type==="checkbox"&&(l[r.name]=(l[r.name]||0)+1)}for(let i=0;i<n.length;i++){const r=n[i];if(r.type==="file"||r.type==="submit"||r.type==="button")continue;const c=r.getAttribute("data-ln-fill-as")||r.name;if(!c||!(c in t))continue;const s=t[c];if(r.type==="checkbox"){if(Array.isArray(s))r.checked=s.indexOf(r.value)!==-1;else if(l[r.name]>1){const u=String(s).split(",").map(function(a){return a.trim()});r.checked=u.indexOf(r.value)!==-1}else r.checked=j(s);o.push(r)}else if(r.type==="radio")r.checked=r.value===String(s),o.push(r);else if(r.type==="select-multiple"){if(Array.isArray(s))for(let u=0;u<r.options.length;u++)r.options[u].selected=s.indexOf(r.options[u].value)!==-1;o.push(r)}else r.value=s,o.push(r)}return o}const L={};function U(e,t){L[e]=t}function H(e){return L[e]||{ingress:t=>t,egress:t=>t}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.registerDataMapper=U,window.lnCore.getDataMapper=H);function V(){typeof window>"u"||(window.lnCore=window.lnCore||{},!window.lnCore._localeObserverBound&&(window.lnCore._localeObserverBound=!0,b(function(){new MutationObserver(function(){B(document,"ln-core:locale-change",{})}).observe(document.documentElement,{attributes:!0,attributeFilter:["lang"],subtree:!0})},"ln-core")))}const T={};function P(e,t){if(!e||typeof t!="object")return;const n=e.toLowerCase().split("-")[0];T[n]=t}function K(e){if(!e)return null;const t=e.toLowerCase().split("-")[0];return T[t]||null}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.registerLocaleFallback=P,window.lnCore.getLocaleFallback=K,window.lnCore.ensureLocaleObserver=V);const m={};function Q(e,t){m[e]||(m[e]=document.querySelector('[data-ln-template="'+e+'"]'));const n=m[e];return n?n.content.cloneNode(!0):(console.warn("["+(t||"ln-core")+'] Template "'+e+'" not found'),null)}function I(e,t){if(!e||!t)return e;const n=e.querySelectorAll("[data-ln-field]");for(let r=0;r<n.length;r++){const c=n[r],s=c.getAttribute("data-ln-field");t[s]!=null&&(c.textContent=t[s])}const o=e.querySelectorAll("[data-ln-attr]");for(let r=0;r<o.length;r++){const c=o[r],s=c.getAttribute("data-ln-attr").split(",");for(let u=0;u<s.length;u++){const a=s[u].trim().split(":");if(a.length!==2)continue;const d=a[0].trim(),f=a[1].trim();t[f]!=null&&c.setAttribute(d,t[f])}}const l=e.querySelectorAll("[data-ln-show]");for(let r=0;r<l.length;r++){const c=l[r],s=c.getAttribute("data-ln-show");s in t&&c.classList.toggle("hidden",!t[s])}const i=e.querySelectorAll("[data-ln-class]");for(let r=0;r<i.length;r++){const c=i[r],s=c.getAttribute("data-ln-class").split(",");for(let u=0;u<s.length;u++){const a=s[u].trim().split(":");if(a.length!==2)continue;const d=a[0].trim(),f=a[1].trim();f in t&&c.classList.toggle(d,!!t[f])}}return e}function J(e,t){e.matches&&e.matches("[data-ln-form], [data-ln-fillable]")&&(window.lnCore._debugSink&&window.lnCore._debugSink("event","ln-fill",e,t??null),e.dispatchEvent(new CustomEvent("ln-fill",{detail:t??null,bubbles:!0})));const n=e.querySelectorAll("[data-ln-form], [data-ln-fillable]");for(let o=0;o<n.length;o++)window.lnCore._debugSink&&window.lnCore._debugSink("event","ln-fill",n[o],t??null),n[o].dispatchEvent(new CustomEvent("ln-fill",{detail:t??null,bubbles:!0}));return e}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore._fillBound||(window.lnCore._fillBound=!0,document.addEventListener("ln-fill",function(e){if(!(!e.target.matches||!e.target.matches("[data-ln-fillable]")))if(e.detail)I(e.target,e.detail);else{const t=e.target.querySelectorAll("[data-ln-field]");for(let n=0;n<t.length;n++)t[n].textContent=""}})));function $(e,t){if(!e||!t)return e;const n=document.createTreeWalker(e,NodeFilter.SHOW_TEXT);for(;n.nextNode();){const i=n.currentNode;i.textContent.indexOf("{{")!==-1&&(i.textContent=i.textContent.replace(/\{\{\s*(\w+)\s*\}\}/g,function(r,c){return t[c]!==void 0?t[c]:""}))}const o=function(i,r){return t[r]!==void 0?t[r]:""},l=Array.from(e.querySelectorAll("*"));e.nodeType===1&&l.push(e);for(let i=0;i<l.length;i++){const r=l[i],c=r.attributes;for(let s=0;s<c.length;s++){const u=c[s];u.value.indexOf("{{")!==-1&&r.setAttribute(u.name,u.value.replace(/\{\{\s*(\w+)\s*\}\}/g,o))}}return e}function G(e,t,n,o,l,i){const r={};for(let s=0;s<e.children.length;s++){const u=e.children[s],a=u.getAttribute("data-ln-render-key");a&&(r[a]=u)}const c=document.createDocumentFragment();for(let s=0;s<t.length;s++){const u=t[s],a=String(o(u));let d=r[a];if(d)l(d,u,s);else{const f=Q(n,i);if(!f||($(f,u),d=f.firstElementChild,!d))continue;d.setAttribute("data-ln-render-key",a),l(d,u,s)}c.appendChild(d)}e.textContent="",e.appendChild(c)}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.fillTemplate=$,window.lnCore.fill=I,window.lnCore.lnFill=J,window.lnCore.renderList=G);function C(e,t,n){const o=e.getAttribute(t);return o===null?n:o}function X(e,t,n){const o=parseInt(e.getAttribute(t),10);return isNaN(o)?n:o}function z(e,t,n=!1){const o=e.getAttribute(t);if(o===null)return!!n;const l=o.trim().toLowerCase();return!(l==="false"||l==="0")}function Y(e,t){return(e.getAttribute(t)||"").split(",").map(n=>n.trim()).filter(Boolean)}const y=new Map;function Z(e,t){const n=(e?e.join("|"):"")+"::"+t;if(y.has(n))return y.get(n);const o=new Set(e||[]),l=function(i,r){const c=i.getAttribute(r);return c!==null&&o.has(c)?c:t};return y.set(n,l),l}function ee(e,t,n){const o=parseFloat(e.getAttribute(t));return isNaN(o)?n:o}function te(e,t,n){const o=e.getAttribute(t);if(!o)return n;try{return JSON.parse(o)}catch{return n}}function R(e,t,n,o,l){if(!e||t===null)return!0;const i=o||"ln-component",r=e.type;if(r==="trigger"||r==="marker"||r==="string"||r==="list"||!r||t===""&&e.fallback!==void 0)return!0;const c=s=>{l?console.warn(s,l):console.warn(s)};if(r==="boolean"){const s=t.trim().toLowerCase();return s!==""&&s!=="true"&&s!=="false"&&s!=="1"&&s!=="0"?(c(`[${i}] Invalid value "${t}" for boolean attribute "${n}". Allowed: "true", "false", or presence-only.`),!1):!0}if(r==="enum"){const s=e.values||[];return s.includes(t)?!0:(c(`[${i}] Invalid value "${t}" for attribute "${n}". Allowed: ${s.join(", ")}. Fallback: "${e.fallback}".`),!1)}if(r==="integer"){if(!/^-?\d+$/.test(t))return c(`[${i}] Invalid integer "${t}" for attribute "${n}". Fallback: ${e.fallback}.`),!1;const s=parseInt(t,10);return e.min!==void 0&&s<e.min?(c(`[${i}] Value ${s} for attribute "${n}" is less than min (${e.min}).`),!1):e.max!==void 0&&s>e.max?(c(`[${i}] Value ${s} for attribute "${n}" is greater than max (${e.max}).`),!1):!0}if(r==="float")return isNaN(Number(t))?(c(`[${i}] Invalid float "${t}" for attribute "${n}". Fallback: ${e.fallback}.`),!1):!0;if(r==="json")try{return JSON.parse(t),!0}catch(s){return c(`[${i}] Invalid JSON for attribute "${n}": ${s.message}. Fallback: ${e.fallback}.`),!1}return!0}function ne(e,t,n){for(const o in n){const[l,i,r]=n[o];Object.defineProperty(e,o,{get:function(){return l(t,i,r)},enumerable:!0,configurable:!0})}return e}function oe(e){const t={};for(const n in e){const o=e[n];if(!o||!o.prop)continue;let l=o.read;if(!l&&o.type)switch(o.type){case"enum":l=Z(o.values,o.fallback);break;case"integer":l=X;break;case"float":l=ee;break;case"boolean":l=z;break;case"list":l=Y;break;case"json":l=te;break;case"string":default:l=C;break}l||(l=C),t[o.prop]=[l,n,o.fallback]}return t}function re(e){const t={};for(const n in e){const o=e[n];o&&o.effect&&(t[n]=o.effect)}return Object.keys(t).length?t:null}function ie(e){if(e.onAttrChange&&!e.declared)return null;const t=new Set;if(e.effects)for(const n in e.effects)t.add(n);if(e.onAttrChange&&e.declared)for(const n of e.declared)t.add(n);return t}function A(e,t,n,o){if(e.nodeType!==1)return;const i=t.indexOf("[")!==-1||t.indexOf(".")!==-1||t.indexOf("#")!==-1?t:"["+t+"]",r=Array.from(e.querySelectorAll(i));e.matches&&e.matches(i)&&r.push(e);for(const c of r)if(!c[n]){window.lnCore._persistSink&&c.hasAttribute("data-ln-persist")&&window.lnCore._persistSink(c,t);try{c[n]=new o(c)}catch(s){console.error("["+n+"] init failed",c,s)}}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore._bootHolds=window.lnCore._bootHolds||0,window.lnCore._bootQueue=window.lnCore._bootQueue||[]);function le(){return typeof window<"u"&&window.lnCore&&window.lnCore._bootHolds||0}function se(e){typeof window<"u"?(window.lnCore=window.lnCore||{},window.lnCore._bootHolds=window.lnCore._bootHolds||0,window.lnCore._bootQueue=window.lnCore._bootQueue||[],window.lnCore._bootHolds>0?window.lnCore._bootQueue.push(e):setTimeout(e,0)):e()}function D(){window.lnCore=window.lnCore||{};const e=window.lnCore._attrRegistry=window.lnCore._attrRegistry||{byAttr:new Map,reactive:[],persist:[]};return e.byReactive=e.byReactive||new Map,e.reactiveWildcard=e.reactiveWildcard||[],e}function ce(e){const t=D(),n=e.observed||[];for(let o=0;o<n.length;o++){const l=n[o];t.byAttr.has(l)||t.byAttr.set(l,[]),t.byAttr.get(l).push(e)}if(t.byDeclaredAttr=t.byDeclaredAttr||new Map,e.attributes)for(const o in e.attributes){t.byDeclaredAttr.has(o)||t.byDeclaredAttr.set(o,[]);const l=t.byDeclaredAttr.get(o);l.some(i=>i.componentTag===e.componentTag)||l.push({spec:e.attributes[o],componentTag:e.componentTag})}if(e.onAttrChange||e.effects){t.reactive.push(e);const o=ie(e);if(o===null)t.reactiveWildcard.push(e);else for(const l of o)t.byReactive.has(l)||t.byReactive.set(l,[]),t.byReactive.get(l).push(e)}e.persist&&t.persist.push(e)}function M(e,t,n,o){for(let l=0;l<e.length;l++){const i=e[l];if(!t[i.attribute])continue;const r=i.effects&&i.effects[n];r?r(t,n,o):i.onAttrChange&&(!i.declared||i.declared.has(n))&&i.onAttrChange(t,n,o)}}function ue(e){const t=e.target,n=e.attributeName;if(e.oldValue===t.getAttribute(n))return;const o=D(),l=o.byAttr.get(n);if(E()&&o.byDeclaredAttr&&o.byDeclaredAttr.has(n)&&g(t)){const i=o.byDeclaredAttr.get(n),r=t.getAttribute(n);for(let c=0;c<i.length;c++)R(i[c].spec,r,n,i[c].componentTag,t)}if(window.lnCore._debugSink&&(n.indexOf("data-ln-")===0||l)&&window.lnCore._debugSink("attr",n,t,{oldValue:e.oldValue,newValue:t.getAttribute(n)}),n.indexOf("data-ln-")===0){const i=o.byReactive.get(n);i&&M(i,t,n,e.oldValue),o.reactiveWildcard.length&&M(o.reactiveWildcard,t,n,e.oldValue)}if(l)for(let i=0;i<l.length;i++){const r=l[i];if(r.handler){r.handler(t,n,e.oldValue);continue}r.onAttributeChange&&t[r.attribute]?r.onAttributeChange(t,n):(A(t,r.selector,r.attribute,r.ComponentFn),r.onInit&&r.onInit(t))}}function ae(){window.lnCore=window.lnCore||{},!window.lnCore._attrObserverBound&&(window.lnCore._attrObserverBound=!0,b(function(){new MutationObserver(function(t){for(let n=0;n<t.length;n++)try{ue(t[n])}catch(o){console.error("[ln-core] mutation handler failed",t[n].target,o)}}).observe(document.body,{attributes:!0,subtree:!0,attributeOldValue:!0})},"ln-core"))}function F(){return window.lnCore=window.lnCore||{},window.lnCore._lifecycleRegistry=window.lnCore._lifecycleRegistry||[]}function de(e){const t=F();if(t.length){if(e.target)for(let n=0;n<t.length;n++){const o=t[n];if(o.onSubtreeChange){const l=o.query,i=e.target.nodeType===1?e.target.matches(l)?e.target:e.target.closest(l):e.target.parentElement?e.target.parentElement.closest(l):null;i&&o.onSubtreeChange(i,e)}}for(let n=0;n<e.addedNodes.length;n++){const o=e.addedNodes[n];if(o.nodeType===1)for(let l=0;l<t.length;l++){const i=t[l];A(o,i.selector,i.attribute,i.ComponentFn),i.onInit&&i.onInit(o)}}for(let n=0;n<e.removedNodes.length;n++){const o=e.removedNodes[n];if(o.nodeType===1)for(let l=0;l<t.length;l++){const i=t[l],r=i.query,c=Array.from(o.querySelectorAll(r));o.matches&&o.matches(r)&&c.push(o);for(let s=0;s<c.length;s++){const u=c[s];if(!document.contains(u)){const a=u[i.attribute];if(a&&typeof a.destroy=="function")try{a.destroy()}catch(d){console.error("["+i.attribute+"] destroy failed",u,d)}delete u[i.attribute]}}}}}}function fe(){window.lnCore=window.lnCore||{},!window.lnCore._lifecycleObserverBound&&(window.lnCore._lifecycleObserverBound=!0,b(function(){new MutationObserver(function(t){for(let n=0;n<t.length;n++){const o=t[n];if(o.type==="childList")try{de(o)}catch(l){console.error("[ln-core] lifecycle handler failed",o.target,l)}}}).observe(document.body,{childList:!0,subtree:!0})},"ln-core"))}function we(e,t,n,o,l={}){const i=l.extraAttributes||[],r=l.onAttributeChange||null,c=l.onSubtreeChange||null,s=l.onInit||null,u=l.onAttrChange||null,a=l.effects||null,d=l.attributes||null,f=d?re(d):a,_e=d?new Set(Object.keys(d)):null,ve=l.persist||null;function p(k){const w=k||document.body;if(A(w,e,t,n),d&&E())for(const h in d){const Se=d[h],S=Array.from(w.querySelectorAll("["+h+"]"));w.matches&&w.matches("["+h+"]")&&S.push(w);for(let O=0;O<S.length;O++){const x=S[O];g(x)&&R(Se,x.getAttribute(h),h,o,x)}}s&&s(w)}const v=[];if(e.indexOf("[")!==-1){const k=/\[([\w-]+)/g;let w;for(;(w=k.exec(e))!==null;)v.push(w[1])}else v.push(e);ce({selector:e,attribute:t,componentTag:o,attributes:d,ComponentFn:n,onInit:s,observed:v.concat(i),onAttributeChange:r,onAttrChange:u,effects:f,declared:_e,persist:ve}),ae();const ke=e.indexOf("[")!==-1||e.indexOf(".")!==-1||e.indexOf("#")!==-1?e:"["+e+"]";F().push({selector:e,attribute:t,ComponentFn:n,onInit:s,onSubtreeChange:c,query:ke}),fe(),window[t]=p;function N(){le()>0?se(function(){p(document.body)}):p(document.body)}return document.readyState==="loading"?document.addEventListener("DOMContentLoaded",N):N(),p}function q(e){return(e||"").replace(/^#/,"")}function _(e){const t=e===void 0?location.hash:e,n={},o=q(t);if(!o)return n;const l=o.split("&");for(let i=0;i<l.length;i++){const r=l[i];if(!r)continue;const c=r.indexOf(":"),s=c>-1?r.slice(0,c):r,u=c>-1?r.slice(c+1):"";if(s)try{n[s]=decodeURIComponent(u)}catch{n[s]=u}}return n}function he(e){if(!e)return null;const t=_();return e in t?t[e]:null}function be(e,t){if(!e)return;const n=_();t==null?delete n[e]:n[e]=String(t);const l=Object.keys(n).map(function(i){const r=n[i];return r===""?i:i+":"+encodeURIComponent(r)}).join("&");q(location.hash)!==l&&(location.hash=l)}function pe(e){return e.button===1||e.ctrlKey||e.metaKey||e.shiftKey?!1:(e.preventDefault(),!0)}function ge(e,t){if(!e||!e.hasAttribute("data-ln-hash"))return null;const n=e.getAttribute("data-ln-hash");if(n&&n.trim()!=="")return n.trim();const o=e.getAttribute("data-ln-sort")||e.getAttribute("data-ln-search-for")||e.getAttribute("data-ln-search")||e.getAttribute("data-ln-filter")||e.id;return o?t?o+"-"+t:o:t||null}function me(e,t){return!t||t==="none"||e===null||e===void 0?null:String(e)+"."+t}function Ce(e){return!e||typeof e!="string"?null:e.endsWith(".asc")?{fieldOrColumn:e.slice(0,-4),direction:"asc"}:e.endsWith(".desc")?{fieldOrColumn:e.slice(0,-5),direction:"desc"}:null}function ye(e,t){return!e||!Array.isArray(t)||t.length===0?null:e+":"+t.map(encodeURIComponent).join(",")}function Ae(e){if(!e||typeof e!="string")return null;const t=e.indexOf(":");if(t===-1)return null;const n=e.slice(0,t),o=e.slice(t+1),l=o?o.split(",").map(function(i){try{return decodeURIComponent(i)}catch{return i}}).filter(Boolean):[];return{key:n,values:l}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.hashParse=_,window.lnCore.hashGet=he,window.lnCore.hashSet=be,window.lnCore.hashLinkClick=pe,window.lnCore.resolveHashNamespace=ge,window.lnCore.hashSortEncode=me,window.lnCore.hashSortDecode=Ce,window.lnCore.hashFilterEncode=ye,window.lnCore.hashFilterDecode=Ae),(function(){const e="data-ln-form",t="lnForm";if(window[t]!==void 0)return;const n={"data-ln-form":{type:"marker",description:"Identifies the form element as an enhanced ln-form"},"data-ln-form-action-edit":{prop:"_actionEdit",type:"string",read:C,fallback:"",description:"URL template or endpoint used when editing an existing record"},"data-ln-form-action-method":{prop:"_actionMethod",type:"enum",values:["PUT","POST","PATCH"],fallback:"PUT",description:"HTTP method used when submitting edit action"}},o=oe(n);function l(i){this.dom=i,ne(this,i,o),this._baseAction=i.getAttribute("action")||"";const r=this;return this._onLnFill=function(c){c.target===r.dom&&(c.detail?(r.fill(c.detail),r._applyActionMode(c.detail)):r.dom.reset())},this._onReset=function(){r._applyActionMode(null)},i.addEventListener("ln-fill",this._onLnFill),i.addEventListener("reset",this._onReset),this}l.prototype.fill=function(i){const r=W(this.dom,i);for(let c=0;c<r.length;c++){const s=r[c],u=s.tagName==="SELECT"||s.type==="checkbox"||s.type==="radio";s.dispatchEvent(new Event(u?"change":"input",{bubbles:!0}))}},l.prototype._ensureMethodInput=function(){let i=this.dom.querySelector('input[name="_method"]');return i||(i=document.createElement("input"),i.type="hidden",i.name="_method",i.value="",this.dom.appendChild(i)),i},l.prototype._applyActionMode=function(i){if(!this.dom.hasAttribute("data-ln-form-action-edit"))return;const r=i&&i.id!=null&&i.id!==""?i.id:null,c=this._ensureMethodInput();if(r!==null){const s=this._actionEdit;s?this.dom.setAttribute("action",s.replace(":id",encodeURIComponent(r))):this.dom.setAttribute("action",this._baseAction.replace(/\/$/,"")+"/"+encodeURIComponent(r)),c.value=this._actionMethod||"PUT"}else this.dom.setAttribute("action",this._baseAction),c.value=""},l.prototype.destroy=function(){this.dom[t]&&(this.dom.removeEventListener("ln-fill",this._onLnFill),this.dom.removeEventListener("reset",this._onReset),delete this.dom[t])},we(e,t,l,"ln-form",{attributes:n})})()})();