@livenetworks/ashlar 1.6.0 → 2.0.0

package/components/ln-data-store/src/window-index.js

@@ -0,0 +1,119 @@
+// ─── Windowed Store Position Index ────────────────────────────
+//
+// In-memory sliding-window index mapping logical positions to record IDs
+// for server-side virtualization. Holds logical/grand totals, request dedup,
+// stale-guard queryGen, and LRU eviction using JS Map insertion order.
+
+export function createWindowIndex(config = {}) {
+	let windowSize = config.windowSize > 0 ? config.windowSize : 1000;
+	let pageSize = config.pageSize > 0 ? config.pageSize : 200;
+	let fetchDebounce = config.fetchDebounce != null ? config.fetchDebounce : 120;
+	const requestPage = typeof config.requestPage === 'function' ? config.requestPage : () => {};
+
+	const map = new Map();       // logicalIndex → id (LRU by insertion order)
+	const inflight = new Set();  // offsets currently requested
+	let logicalTotal = 0, grandTotal = 0, queryGen = 0, hasLoaded = false, debounceId = null;
+
+	function touch(i, id) {
+		map.delete(i);
+		map.set(i, id);
+	}
+
+	// Returns the ids that left residency, so the store can drop them from
+	// IndexedDB and windowSize bounds the records held, not just the positions.
+	// Only ids this index itself placed can ever be returned — a locally created
+	// record the server has not positioned is never in the map, so eviction can
+	// not reach it.
+	function evict() {
+		if (map.size <= windowSize) return [];
+		const dropped = [];
+		while (map.size > windowSize) {
+			const key = map.keys().next().value;
+			dropped.push(map.get(key));
+			map.delete(key);
+		}
+		// One id can occupy more than one position; it has only left residency
+		// once no remaining position refers to it.
+		const remaining = new Set(map.values());
+		return dropped.filter(id => !remaining.has(id));
+	}
+
+	function fire(offset, query) {
+		inflight.add(offset);
+		clearTimeout(debounceId);
+		debounceId = setTimeout(() => requestPage(offset, pageSize, query), fetchDebounce);
+	}
+
+	return {
+		get logicalTotal() { return logicalTotal; },
+		set logicalTotal(val) { logicalTotal = val; },
+		get grandTotal() { return grandTotal; },
+		set grandTotal(val) { grandTotal = val; },
+		get queryGen() { return queryGen; },
+		set queryGen(val) { queryGen = val; },
+		get size() { return map.size; },
+		// Whether a server ordering exists for the current query at all — false
+		// from reset() until the first ingest(). Distinct from a missing page.
+		get hasLoaded() { return hasLoaded; },
+
+		getId: i => {
+			if (!map.has(i)) return undefined;
+			const id = map.get(i);
+			touch(i, id);
+			return id;
+		},
+
+		ensure: (startRow, endRow, query) => {
+			if (!hasLoaded && !inflight.has(0)) return fire(0, query);
+			if (logicalTotal <= 0) return;
+
+			const start = Math.max(0, startRow);
+			const end = Math.min(logicalTotal, endRow);
+
+			for (let i = start; i < end; i++) {
+				if (!map.has(i)) {
+					const pageOffset = Math.floor(i / pageSize) * pageSize;
+					if (!inflight.has(pageOffset)) return fire(pageOffset, query);
+				}
+			}
+		},
+
+		ingest: (offset, ids, total, filtered, qGen) => {
+			if (qGen != null && qGen !== queryGen) return [];
+			hasLoaded = true;
+			if (total != null) grandTotal = total;
+			if (filtered != null) logicalTotal = filtered;
+
+			for (let i = 0; i < ids.length; i++) {
+				touch(offset + i, ids[i]);
+			}
+			inflight.delete(offset);
+			return evict();
+		},
+
+		reset: function () {
+			queryGen++;
+			this.clear();
+		},
+
+		clear: () => {
+			hasLoaded = false;
+			map.clear();
+			inflight.clear();
+			clearTimeout(debounceId);
+		},
+
+		// Returns the ids evicted by a window shrink, same contract as ingest() —
+		// the caller must purge them from storage.
+		configure: (partial = {}) => {
+			let evicted = [];
+			if (partial.windowSize > 0 && partial.windowSize !== windowSize) {
+				windowSize = partial.windowSize;
+				evicted = evict();
+			}
+			if (partial.pageSize > 0) pageSize = partial.pageSize;
+			if (partial.fetchDebounce >= 0) fetchDebounce = partial.fetchDebounce;
+			return evicted;
+		}
+	};
+}

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

@@ -1,6 +1,9 @@
 # ln-date
 
-Locale-aware date formatting with native browser picker.
+> Applied to an `<input type="date" data-ln-date name="...">`. On initialization, it wraps the element in a
+> `<span data-ln-date-field>` containing a visible text input, a hidden native date picker, a hidden `<input type="hidden" name="...">`
+> for form submission, and a calendar button. On button `click`, it calls `showPicker()` on the date picker; on text input `blur`,
+> it parses the entered string, updates the hidden ISO input, and reformats the visible text.
 
 ## Usage
 
@@ -59,7 +62,9 @@ The hidden input holds the ISO date string (YYYY-MM-DD) for form submission.
 
 | Attribute | On | Description |
 |-----------|-----|-------------|
-| `data-ln-date` | `<input>` | Enables date formatting. Value = format (keyword or pattern). Default: `medium` |
+| `data-ln-date` | `<input>`, `<time>`, `<td>` | Enables date formatting. Value = format (keyword or pattern). Default: `medium` |
+| `datetime` | `<time>` | Native machine-readable date attribute; primary observable SSOT on `<time>` elements. |
+| `data-ln-value` | `<td>`, `<span>`, `<input>` | Raw ISO date string or timestamp; acts as raw machine value for non-`<time>` elements. |
 | `data-ln-date-label` | `<input>` | Optional. Translated `aria-label` for the injected calendar button. Default: `Open date picker` (dev fallback only). |
 
 ### Format Keywords (locale-aware via Intl.DateTimeFormat)
@@ -94,7 +99,6 @@ The hidden input holds the ISO date string (YYYY-MM-DD) for form submission.
 | Event | Bubbles | Cancelable | Detail |
 |-------|---------|------------|--------|
 | `ln-date:change` | yes | no | `{ value: String (ISO), formatted: String, date: Date }` |
-| `ln-date:destroyed` | yes | no | `{ target: Element }` |
 
 ## API
 
@@ -146,6 +150,12 @@ Locale is detected by walking up the DOM tree to find the nearest `[lang]` attri
     <label for="hired">Hire Date</label>
     <input type="date" id="hired" name="hired" value="2024-03-15" data-ln-date>
 </div>
+
+<!-- Semantic HTML5 time element (observable datetime SSOT, no data-ln-value needed) -->
+<time datetime="2026-07-25" data-ln-date="medium">2026-07-25</time>
+
+<!-- Table cell with explicit raw machine value -->
+<td data-ln-value="2026-07-25" data-ln-date="dd.MM.yyyy">2026-07-25</td>
 ```
 
 ## Integration with ln-form
@@ -165,18 +175,18 @@ Include the main Ashlar bundle in your HTML. This bundle registers all Ashlar co
 ### 2. Standalone (Zero-Dependency IIFE)
 If you only need date-formatting functionality without the rest of the Ashlar library, load the component's standalone IIFE script:
 ```html
-<script src="js/ln-date/ln-date.js" defer></script>
+<script src="components/ln-date/ln-date.js" defer></script>
 ```
 
 ### 3. Source & Reference
-* **Active Development Source**: [js/ln-date/src/ln-date.js](file:///c:/laragon/www/ln-ashlar/js/ln-date/src/ln-date.js) — The source of truth containing the ES module implementation.
-* **Compiled Standalone Release**: [js/ln-date/ln-date.js](file:///c:/laragon/www/ln-ashlar/js/ln-date/ln-date.js) — The compiled IIFE distribution file.
+* **Active Development Source**: [components/ln-date/src/ln-date.js](file:///c:/laragon/www/ln-ashlar/components/ln-date/src/ln-date.js) — The source of truth containing the ES module implementation.
+* **Compiled Standalone Release**: [components/ln-date/ln-date.js](file:///c:/laragon/www/ln-ashlar/components/ln-date/ln-date.js) — The compiled IIFE distribution file.
 
 ---
 
 ## 🔧 Internals
 
-Source: `js/ln-date/ln-date.js`. Each `[data-ln-date]` gets a `_component` instance at `element.lnDate` (`dom` visible input, `_wrapper`, `_hidden` form input, `_picker` hidden native date input, `_btn` calendar button, `_lastISO` — the last known valid ISO value, used to revert on invalid typed input).
+Source: `components/ln-date/ln-date.js`. Each `[data-ln-date]` gets a `_component` instance at `element.lnDate` (`dom` visible input, `_wrapper`, `_hidden` form input, `_picker` hidden native date input, `_btn` calendar button, `_lastISO` — the last known valid ISO value, used to revert on invalid typed input).
 
 ### Format resolution
 

package/{js → components}/ln-date/ln-date-dev.scss

@@ -1,14 +1,14 @@
-@use '../../scss/config/mixins' as *;
-
-[data-ln-debug] {
-	// 1. Date element misuse: data-ln-date belongs on <input>, <span>, <time>, or <td>
-	[data-ln-date]:not(input, span, time, td, p, div, b, strong, data) {
-		@include dev-inline-error("data-ln-date belongs on <input>, <span>, <time>, or <td>");
-	}
-
-	// 2. Date input missing ID: input[data-ln-date] must have an id for proper labeling/association
-	input[data-ln-date]:not([id]) {
-		@include dev-inline-error("data-ln-date is missing required 'id' attribute");
-	}
-}
-
+@use '../../theme/config/mixins' as *;
+
+[data-ln-debug] {
+	// 1. Date element misuse: data-ln-date belongs on <input>, <span>, <time>, or <td>
+	[data-ln-date]:not(input, span, time, td, p, div, b, strong, data) {
+		@include dev-inline-error("data-ln-date belongs on <input>, <span>, <time>, or <td>");
+	}
+
+	// 2. Date input missing ID: input[data-ln-date] must have an id for proper labeling/association
+	input[data-ln-date]:not([id]) {
+		@include dev-inline-error("data-ln-date is missing required 'id' attribute");
+	}
+}
+

package/components/ln-date/ln-date.js

@@ -0,0 +1 @@
+(function(){"use strict";function q(){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 N(t){if(typeof window>"u")return!1;if(window.lnDebug===!0)return!0;if(window.lnCore&&window.lnCore._debugIsContained)return t?window.lnCore._debugIsContained(t):window.lnCore._debugSink!==null;if(t&&t.closest){const e=t.closest("[data-ln-debug]");return!(!e||typeof document<"u"&&e===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 t=console.warn;console.warn=function(...e){if(typeof e[0]=="string"&&(e[0].startsWith("[ln-")||e[0].startsWith("[lnCore"))){let r=null;for(let o=1;o<e.length;o++)if(e[o]&&e[o].nodeType===1){r=e[o];break}if(!N(r))return}t.apply(console,e)}}function P(t,e,n){const r=n||{};window.lnCore._debugSink&&window.lnCore._debugSink("event",e,t,r),t.dispatchEvent(new CustomEvent(e,{bubbles:!0,detail:r}))}function M(t,e){if(!document.body){document.addEventListener("DOMContentLoaded",function(){M(t,e)}),console.warn("["+e+'] Script loaded before <body> — add "defer" to your <script> tag');return}t()}function Z(t,e,{get:n,set:r}){Object.defineProperty(t,"value",{get:function(){return n?n.call(this):e.get.call(this)},set:function(o){r?r.call(this,o,l=>e.set.call(this,l)):e.set.call(this,o)},configurable:!0})}const j={};function tt(t,e){j[t]=e}function et(t){return j[t]||{ingress:e=>e,egress:e=>e}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.registerDataMapper=tt,window.lnCore.getDataMapper=et);function L(t){const e=t?t.closest("[lang]"):null,n=(e?e.getAttribute("lang")||e.lang:null)||(typeof document<"u"&&document.documentElement?document.documentElement.getAttribute("lang")||document.documentElement.lang:null)||(typeof navigator<"u"?navigator.language:null);return n?n.trim():"en-US"}function H(){typeof window>"u"||(window.lnCore=window.lnCore||{},!window.lnCore._localeObserverBound&&(window.lnCore._localeObserverBound=!0,M(function(){new MutationObserver(function(){P(document,"ln-core:locale-change",{})}).observe(document.documentElement,{attributes:!0,attributeFilter:["lang"],subtree:!0})},"ln-core")))}const W={};function U(t,e){if(!t||typeof e!="object")return;const n=t.toLowerCase().split("-")[0];W[n]=e}function T(t){if(!t)return null;const e=t.toLowerCase().split("-")[0];return W[e]||null}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.registerLocaleFallback=U,window.lnCore.getLocaleFallback=T,window.lnCore.ensureLocaleObserver=H);const F={};function nt(t,e){F[t]||(F[t]=document.querySelector('[data-ln-template="'+t+'"]'));const n=F[t];return n?n.content.cloneNode(!0):(console.warn("["+(e||"ln-core")+'] Template "'+t+'" not found'),null)}function K(t,e){if(!t||!e)return t;const n=t.querySelectorAll("[data-ln-field]");for(let s=0;s<n.length;s++){const u=n[s],c=u.getAttribute("data-ln-field");e[c]!=null&&(u.textContent=e[c])}const r=t.querySelectorAll("[data-ln-attr]");for(let s=0;s<r.length;s++){const u=r[s],c=u.getAttribute("data-ln-attr").split(",");for(let i=0;i<c.length;i++){const a=c[i].trim().split(":");if(a.length!==2)continue;const d=a[0].trim(),h=a[1].trim();e[h]!=null&&u.setAttribute(d,e[h])}}const o=t.querySelectorAll("[data-ln-show]");for(let s=0;s<o.length;s++){const u=o[s],c=u.getAttribute("data-ln-show");c in e&&u.classList.toggle("hidden",!e[c])}const l=t.querySelectorAll("[data-ln-class]");for(let s=0;s<l.length;s++){const u=l[s],c=u.getAttribute("data-ln-class").split(",");for(let i=0;i<c.length;i++){const a=c[i].trim().split(":");if(a.length!==2)continue;const d=a[0].trim(),h=a[1].trim();h in e&&u.classList.toggle(d,!!e[h])}}return t}function it(t,e){t.matches&&t.matches("[data-ln-form], [data-ln-fillable]")&&(window.lnCore._debugSink&&window.lnCore._debugSink("event","ln-fill",t,e??null),t.dispatchEvent(new CustomEvent("ln-fill",{detail:e??null,bubbles:!0})));const n=t.querySelectorAll("[data-ln-form], [data-ln-fillable]");for(let r=0;r<n.length;r++)window.lnCore._debugSink&&window.lnCore._debugSink("event","ln-fill",n[r],e??null),n[r].dispatchEvent(new CustomEvent("ln-fill",{detail:e??null,bubbles:!0}));return t}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore._fillBound||(window.lnCore._fillBound=!0,document.addEventListener("ln-fill",function(t){if(!(!t.target.matches||!t.target.matches("[data-ln-fillable]")))if(t.detail)K(t.target,t.detail);else{const e=t.target.querySelectorAll("[data-ln-field]");for(let n=0;n<e.length;n++)e[n].textContent=""}})));function Y(t,e){if(!t||!e)return t;const n=document.createTreeWalker(t,NodeFilter.SHOW_TEXT);for(;n.nextNode();){const l=n.currentNode;l.textContent.indexOf("{{")!==-1&&(l.textContent=l.textContent.replace(/\{\{\s*(\w+)\s*\}\}/g,function(s,u){return e[u]!==void 0?e[u]:""}))}const r=function(l,s){return e[s]!==void 0?e[s]:""},o=Array.from(t.querySelectorAll("*"));t.nodeType===1&&o.push(t);for(let l=0;l<o.length;l++){const s=o[l],u=s.attributes;for(let c=0;c<u.length;c++){const i=u[c];i.value.indexOf("{{")!==-1&&s.setAttribute(i.name,i.value.replace(/\{\{\s*(\w+)\s*\}\}/g,r))}}return t}function rt(t,e,n,r,o,l){const s={};for(let c=0;c<t.children.length;c++){const i=t.children[c],a=i.getAttribute("data-ln-render-key");a&&(s[a]=i)}const u=document.createDocumentFragment();for(let c=0;c<e.length;c++){const i=e[c],a=String(r(i));let d=s[a];if(d)o(d,i,c);else{const h=nt(n,l);if(!h||(Y(h,i),d=h.firstElementChild,!d))continue;d.setAttribute("data-ln-render-key",a),o(d,i,c)}u.appendChild(d)}t.textContent="",t.appendChild(u)}function ot(t,e){const n={},r=t.querySelectorAll("["+e+"]");for(let o=0;o<r.length;o++)n[r[o].getAttribute(e)]=r[o].textContent,r[o].remove();return n}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.fillTemplate=Y,window.lnCore.fill=K,window.lnCore.lnFill=it,window.lnCore.renderList=rt);function Q(t,e,n,r,o){if(!t||e===null)return!0;const l=r||"ln-component",s=t.type;if(s==="trigger"||s==="marker"||s==="string"||s==="list"||!s||e===""&&t.fallback!==void 0)return!0;const u=c=>{o?console.warn(c,o):console.warn(c)};if(s==="boolean"){const c=e.trim().toLowerCase();return c!==""&&c!=="true"&&c!=="false"&&c!=="1"&&c!=="0"?(u(`[${l}] Invalid value "${e}" for boolean attribute "${n}". Allowed: "true", "false", or presence-only.`),!1):!0}if(s==="enum"){const c=t.values||[];return c.includes(e)?!0:(u(`[${l}] Invalid value "${e}" for attribute "${n}". Allowed: ${c.join(", ")}. Fallback: "${t.fallback}".`),!1)}if(s==="integer"){if(!/^-?\d+$/.test(e))return u(`[${l}] Invalid integer "${e}" for attribute "${n}". Fallback: ${t.fallback}.`),!1;const c=parseInt(e,10);return t.min!==void 0&&c<t.min?(u(`[${l}] Value ${c} for attribute "${n}" is less than min (${t.min}).`),!1):t.max!==void 0&&c>t.max?(u(`[${l}] Value ${c} for attribute "${n}" is greater than max (${t.max}).`),!1):!0}if(s==="float")return isNaN(Number(e))?(u(`[${l}] Invalid float "${e}" for attribute "${n}". Fallback: ${t.fallback}.`),!1):!0;if(s==="json")try{return JSON.parse(e),!0}catch(c){return u(`[${l}] Invalid JSON for attribute "${n}": ${c.message}. Fallback: ${t.fallback}.`),!1}return!0}function lt(t){const e={};for(const n in t){const r=t[n];r&&r.effect&&(e[n]=r.effect)}return Object.keys(e).length?e:null}function st(t){if(t.onAttrChange&&!t.declared)return null;const e=new Set;if(t.effects)for(const n in t.effects)e.add(n);if(t.onAttrChange&&t.declared)for(const n of t.declared)e.add(n);return e}function R(t,e,n,r){if(t.nodeType!==1)return;const l=e.indexOf("[")!==-1||e.indexOf(".")!==-1||e.indexOf("#")!==-1?e:"["+e+"]",s=Array.from(t.querySelectorAll(l));t.matches&&t.matches(l)&&s.push(t);for(const u of s)if(!u[n]){window.lnCore._persistSink&&u.hasAttribute("data-ln-persist")&&window.lnCore._persistSink(u,e);try{u[n]=new r(u)}catch(c){console.error("["+n+"] init failed",u,c)}}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore._bootHolds=window.lnCore._bootHolds||0,window.lnCore._bootQueue=window.lnCore._bootQueue||[]);function at(){return typeof window<"u"&&window.lnCore&&window.lnCore._bootHolds||0}function ct(t){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(t):setTimeout(t,0)):t()}function G(){window.lnCore=window.lnCore||{};const t=window.lnCore._attrRegistry=window.lnCore._attrRegistry||{byAttr:new Map,reactive:[],persist:[]};return t.byReactive=t.byReactive||new Map,t.reactiveWildcard=t.reactiveWildcard||[],t}function ut(t){const e=G(),n=t.observed||[];for(let r=0;r<n.length;r++){const o=n[r];e.byAttr.has(o)||e.byAttr.set(o,[]),e.byAttr.get(o).push(t)}if(e.byDeclaredAttr=e.byDeclaredAttr||new Map,t.attributes)for(const r in t.attributes){e.byDeclaredAttr.has(r)||e.byDeclaredAttr.set(r,[]);const o=e.byDeclaredAttr.get(r);o.some(l=>l.componentTag===t.componentTag)||o.push({spec:t.attributes[r],componentTag:t.componentTag})}if(t.onAttrChange||t.effects){e.reactive.push(t);const r=st(t);if(r===null)e.reactiveWildcard.push(t);else for(const o of r)e.byReactive.has(o)||e.byReactive.set(o,[]),e.byReactive.get(o).push(t)}t.persist&&e.persist.push(t)}function J(t,e,n,r){for(let o=0;o<t.length;o++){const l=t[o];if(!e[l.attribute])continue;const s=l.effects&&l.effects[n];s?s(e,n,r):l.onAttrChange&&(!l.declared||l.declared.has(n))&&l.onAttrChange(e,n,r)}}function dt(t){const e=t.target,n=t.attributeName;if(t.oldValue===e.getAttribute(n))return;const r=G(),o=r.byAttr.get(n);if(q()&&r.byDeclaredAttr&&r.byDeclaredAttr.has(n)&&N(e)){const l=r.byDeclaredAttr.get(n),s=e.getAttribute(n);for(let u=0;u<l.length;u++)Q(l[u].spec,s,n,l[u].componentTag,e)}if(window.lnCore._debugSink&&(n.indexOf("data-ln-")===0||o)&&window.lnCore._debugSink("attr",n,e,{oldValue:t.oldValue,newValue:e.getAttribute(n)}),n.indexOf("data-ln-")===0){const l=r.byReactive.get(n);l&&J(l,e,n,t.oldValue),r.reactiveWildcard.length&&J(r.reactiveWildcard,e,n,t.oldValue)}if(o)for(let l=0;l<o.length;l++){const s=o[l];if(s.handler){s.handler(e,n,t.oldValue);continue}s.onAttributeChange&&e[s.attribute]?s.onAttributeChange(e,n):(R(e,s.selector,s.attribute,s.ComponentFn),s.onInit&&s.onInit(e))}}function ft(){window.lnCore=window.lnCore||{},!window.lnCore._attrObserverBound&&(window.lnCore._attrObserverBound=!0,M(function(){new MutationObserver(function(e){for(let n=0;n<e.length;n++)try{dt(e[n])}catch(r){console.error("[ln-core] mutation handler failed",e[n].target,r)}}).observe(document.body,{attributes:!0,subtree:!0,attributeOldValue:!0})},"ln-core"))}function X(){return window.lnCore=window.lnCore||{},window.lnCore._lifecycleRegistry=window.lnCore._lifecycleRegistry||[]}function ht(t){const e=X();if(e.length){if(t.target)for(let n=0;n<e.length;n++){const r=e[n];if(r.onSubtreeChange){const o=r.query,l=t.target.nodeType===1?t.target.matches(o)?t.target:t.target.closest(o):t.target.parentElement?t.target.parentElement.closest(o):null;l&&r.onSubtreeChange(l,t)}}for(let n=0;n<t.addedNodes.length;n++){const r=t.addedNodes[n];if(r.nodeType===1)for(let o=0;o<e.length;o++){const l=e[o];R(r,l.selector,l.attribute,l.ComponentFn),l.onInit&&l.onInit(r)}}for(let n=0;n<t.removedNodes.length;n++){const r=t.removedNodes[n];if(r.nodeType===1)for(let o=0;o<e.length;o++){const l=e[o],s=l.query,u=Array.from(r.querySelectorAll(s));r.matches&&r.matches(s)&&u.push(r);for(let c=0;c<u.length;c++){const i=u[c];if(!document.contains(i)){const a=i[l.attribute];if(a&&typeof a.destroy=="function")try{a.destroy()}catch(d){console.error("["+l.attribute+"] destroy failed",i,d)}delete i[l.attribute]}}}}}}function mt(){window.lnCore=window.lnCore||{},!window.lnCore._lifecycleObserverBound&&(window.lnCore._lifecycleObserverBound=!0,M(function(){new MutationObserver(function(e){for(let n=0;n<e.length;n++){const r=e[n];if(r.type==="childList")try{ht(r)}catch(o){console.error("[ln-core] lifecycle handler failed",r.target,o)}}}).observe(document.body,{childList:!0,subtree:!0})},"ln-core"))}function gt(t,e,n,r,o={}){const l=o.extraAttributes||[],s=o.onAttributeChange||null,u=o.onSubtreeChange||null,c=o.onInit||null,i=o.onAttrChange||null,a=o.effects||null,d=o.attributes||null,h=d?lt(d):a,b=d?new Set(Object.keys(d)):null,p=o.persist||null;function w(m){const g=m||document.body;if(R(g,t,e,n),d&&q())for(const y in d){const A=d[y],v=Array.from(g.querySelectorAll("["+y+"]"));g.matches&&g.matches("["+y+"]")&&v.push(g);for(let D=0;D<v.length;D++){const k=v[D];N(k)&&Q(A,k.getAttribute(y),y,r,k)}}c&&c(g)}const C=[];if(t.indexOf("[")!==-1){const m=/\[([\w-]+)/g;let g;for(;(g=m.exec(t))!==null;)C.push(g[1])}else C.push(t);ut({selector:t,attribute:e,componentTag:r,attributes:d,ComponentFn:n,onInit:c,observed:C.concat(l),onAttributeChange:s,onAttrChange:i,effects:h,declared:b,persist:p}),ft();const O=t.indexOf("[")!==-1||t.indexOf(".")!==-1||t.indexOf("#")!==-1?t:"["+t+"]";X().push({selector:t,attribute:e,ComponentFn:n,onInit:c,onSubtreeChange:u,query:O}),mt(),window[e]=w;function f(){at()>0?ct(function(){w(document.body)}):w(document.body)}return document.readyState==="loading"?document.addEventListener("DOMContentLoaded",f):f(),w}function z(t){return(t||"").replace(/^#/,"")}function $(t){const e=t===void 0?location.hash:t,n={},r=z(e);if(!r)return n;const o=r.split("&");for(let l=0;l<o.length;l++){const s=o[l];if(!s)continue;const u=s.indexOf(":"),c=u>-1?s.slice(0,u):s,i=u>-1?s.slice(u+1):"";if(c)try{n[c]=decodeURIComponent(i)}catch{n[c]=i}}return n}function pt(t){if(!t)return null;const e=$();return t in e?e[t]:null}function wt(t,e){if(!t)return;const n=$();e==null?delete n[t]:n[t]=String(e);const o=Object.keys(n).map(function(l){const s=n[l];return s===""?l:l+":"+encodeURIComponent(s)}).join("&");z(location.hash)!==o&&(location.hash=o)}function bt(t){return t.button===1||t.ctrlKey||t.metaKey||t.shiftKey?!1:(t.preventDefault(),!0)}function yt(t,e){if(!t||!t.hasAttribute("data-ln-hash"))return null;const n=t.getAttribute("data-ln-hash");if(n&&n.trim()!=="")return n.trim();const r=t.getAttribute("data-ln-sort")||t.getAttribute("data-ln-search-for")||t.getAttribute("data-ln-search")||t.getAttribute("data-ln-filter")||t.id;return r?e?r+"-"+e:r:e||null}function Ct(t,e){return!e||e==="none"||t===null||t===void 0?null:String(t)+"."+e}function _t(t){return!t||typeof t!="string"?null:t.endsWith(".asc")?{fieldOrColumn:t.slice(0,-4),direction:"asc"}:t.endsWith(".desc")?{fieldOrColumn:t.slice(0,-5),direction:"desc"}:null}function At(t,e){return!t||!Array.isArray(e)||e.length===0?null:t+":"+e.map(encodeURIComponent).join(",")}function vt(t){if(!t||typeof t!="string")return null;const e=t.indexOf(":");if(e===-1)return null;const n=t.slice(0,e),r=t.slice(e+1),o=r?r.split(",").map(function(l){try{return decodeURIComponent(l)}catch{return l}}).filter(Boolean):[];return{key:n,values:o}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.hashParse=$,window.lnCore.hashGet=pt,window.lnCore.hashSet=wt,window.lnCore.hashLinkClick=bt,window.lnCore.resolveHashNamespace=yt,window.lnCore.hashSortEncode=Ct,window.lnCore.hashSortDecode=_t,window.lnCore.hashFilterEncode=At,window.lnCore.hashFilterDecode=vt);function _(t){if(t==null||t==="")return null;if(t instanceof Date)return isNaN(t.getTime())?null:t;const e=Number(t);if(!isNaN(e)&&e>0){const n=e<1e11?e*1e3:e,r=new Date(n);return isNaN(r.getTime())?null:r}if(typeof t=="string"){const n=t.trim();if(!n)return null;const r=/^(\d{4})-(\d{2})-(\d{2})$/.exec(n);if(r){const l=+r[1],s=+r[2],u=+r[3],c=new Date(l,s-1,u);return c.getFullYear()!==l||c.getMonth()!==s-1||c.getDate()!==u?null:c}const o=new Date(n);return isNaN(o.getTime())?null:o}return null}function E(t){if(!t||!(t instanceof Date)||isNaN(t.getTime()))return"";const e=t.getFullYear(),n=String(t.getMonth()+1).padStart(2,"0"),r=String(t.getDate()).padStart(2,"0");return e+"-"+n+"-"+r}const B=/^(short|medium|long)(\s+datetime)?$/,St={short:{dateStyle:"short"},medium:{dateStyle:"medium"},long:{dateStyle:"long"},"short datetime":{dateStyle:"short",timeStyle:"short"},"medium datetime":{dateStyle:"medium",timeStyle:"short"},"long datetime":{dateStyle:"long",timeStyle:"short"}};function Et(t){return!t||t===""?{dateStyle:"medium"}:String(t).trim().match(B)?St[t.trim()]:null}function x(t){if(!t||typeof t!="string")return null;const e=t.trim();if(e.length<6)return null;let n,r;if(e.indexOf(".")!==-1)n=".",r=e.split(".");else if(e.indexOf("/")!==-1)n="/",r=e.split("/");else if(e.indexOf("-")!==-1)n="-",r=e.split("-");else return null;if(r.length!==3)return null;const o=[];for(let i=0;i<3;i++){const a=parseInt(r[i],10);if(isNaN(a))return null;o.push(a)}let l,s,u;n==="."?(l=o[0],s=o[1],u=o[2]):n==="/"?(s=o[0],l=o[1],u=o[2]):r[0].length===4?(u=o[0],s=o[1],l=o[2]):(l=o[0],s=o[1],u=o[2]),u<100&&(u+=u<50?2e3:1900);const c=new Date(u,s-1,l);return c.getFullYear()!==u||c.getMonth()!==s-1||c.getDate()!==l?null:c}function V(t,e,n,r){if(!t||!(t instanceof Date)||isNaN(t.getTime())||!e||typeof e!="string")return"";const o=t.getDate(),l=t.getMonth(),s=t.getFullYear(),u=t.getHours(),c=t.getMinutes();let i,a;const d=(n||"").toLowerCase().split("-")[0];let h=!1;try{const w=new Intl.DateTimeFormat(n,{month:"long"}).resolvedOptions().locale.toLowerCase().split("-")[0];h=!!(r&&w!==d)}catch{h=!!r}if(h&&r&&r.monthsLong)i=r.monthsLong[l];else try{i=new Intl.DateTimeFormat(n,{month:"long"}).format(t)}catch{i=String(l+1)}if(h&&r&&r.monthsShort)a=r.monthsShort[l];else try{a=new Intl.DateTimeFormat(n,{month:"short"}).format(t)}catch{a=String(l+1)}const b={yyyy:String(s),yy:String(s).slice(-2),MMMM:i,MMM:a,MM:String(l+1).padStart(2,"0"),M:String(l+1),dd:String(o).padStart(2,"0"),d:String(o),HH:String(u).padStart(2,"0"),mm:String(c).padStart(2,"0")};return e.replace(/yyyy|yy|MMMM|MMM|MM|M|dd|d|HH|mm/g,function(p){return b[p]!==void 0?b[p]:p})}function I(t,e,n,r){if(!t||!(t instanceof Date)||isNaN(t.getTime()))return"";const o=Et(e);if(o)try{const l=new Intl.DateTimeFormat(n,o),s=(n||"").toLowerCase().split("-")[0],u=l.resolvedOptions().locale.toLowerCase().split("-")[0];return r&&u!==s?V(t,"dd.MM.yyyy",n,r):l.format(t)}catch{return V(t,"dd.MM.yyyy",n,r)}return V(t,e||"dd.MM.yyyy",n,r)}(function(){const t="data-ln-date",e="lnDate";if(window[e]!==void 0)return;function n(i){const a=i[e];if(a){if(a.isTextElement)a._initTextElement();else if(a.value){const d=_(a.value);d&&a._displayFormatted(d)}}}const r={"data-ln-date":{type:"enum",values:["short","medium","long","full","iso"],fallback:"medium",effect:n,description:"Date display style preset or activator"},"data-ln-date-format":{type:"string",effect:n,description:"Custom Intl.DateTimeFormat pattern or options"},"data-ln-date-locale":{type:"string",effect:n,description:"BCP 47 language tag override for date formatting"},"data-ln-value":{type:"string",effect:n,description:"Raw ISO date string or timestamp for non-time elements (td, span)"},"data-ln-date-dict":{type:"marker",description:"Container for date translation dictionary"},"data-ln-date-dict-key":{type:"string",description:"Dictionary key for relative time or custom date formatting"},"data-ln-date-field":{type:"string",description:"Field name mapping for date record binding"},"data-ln-date-label":{type:"string",description:"Accessible label text for the date input"}},o=Object.getOwnPropertyDescriptor(HTMLInputElement.prototype,"value");function l(i,a,d){P(i.dom,"ln-date:change",{value:a,formatted:i.dom.value,date:d}),i.dom.dispatchEvent(new Event("change",{bubbles:!0}))}function s(i,a,d,h){i._setHiddenRaw(a),o.set.call(i._picker,a),i._lastISO=a,h!==void 0?(i._isFormatting=!0,i.dom.value=h,i._isFormatting=!1):d&&i._displayFormatted(d),l(i,a,d)}function u(i){i._setHiddenRaw(""),o.set.call(i._picker,""),i._isFormatting=!0,i.dom.value="",i._isFormatting=!1,i._lastISO="",l(i,"",null)}function c(i){if(i[e])return i[e];i[e]=this,this.dom=i;const a=this;if(this._onLocaleChange=function(){if(a.isTextElement)a._formatTextContent();else if(a.value){const f=_(a.value);f&&a._displayFormatted(f)}},H(),document.addEventListener("ln-core:locale-change",this._onLocaleChange),i.tagName!=="INPUT")return this.isTextElement=!0,this._initTextElement(),this;this.isTextElement=!1;const d=i.value,h=i.name,b=i.closest(".form-element, form")||i.parentNode;if(b){const f=b.querySelectorAll("[data-ln-date-dict]");for(let m=0;m<f.length;m++){const g=f[m].getAttribute("data-ln-date-dict");if(g){const y=ot(f[m],"data-ln-date-dict-key");y["months-long"]&&(y.monthsLong=y["months-long"].split(",").map(A=>A.trim())),y["months-short"]&&(y.monthsShort=y["months-short"].split(",").map(A=>A.trim())),U(g,y)}}}const p=document.createElement("span");p.setAttribute("data-ln-date-field",""),i.parentNode.insertBefore(p,i),p.appendChild(i),this._wrapper=p;const w=document.createElement("input");w.type="hidden",w.name=h,i.removeAttribute("name"),i.hasAttribute("data-ln-fill-as")&&w.setAttribute("data-ln-fill-as",i.getAttribute("data-ln-fill-as")),i.insertAdjacentElement("afterend",w),this._hidden=w;const C=document.createElement("input");C.type="date",C.tabIndex=-1,C.setAttribute("tabindex","-1"),C.setAttribute("aria-hidden","true"),C.setAttribute("aria-label",i.getAttribute("data-ln-date-label")||"Date picker"),C.style.cssText="position:absolute;opacity:0;width:0;height:0;overflow:hidden;pointer-events:none",w.insertAdjacentElement("afterend",C),this._picker=C,i.type="text";const S=document.createElement("button");S.type="button",S.setAttribute("aria-label",i.getAttribute("data-ln-date-label")||"Open date picker"),S.innerHTML='<svg class="ln-icon" aria-hidden="true"><use href="#ln-icon-calendar"></use></svg>',C.insertAdjacentElement("afterend",S),this._btn=S,this._lastISO="",Object.defineProperty(w,"value",{get:function(){return o.get.call(w)},set:function(f){if(o.set.call(w,f),f&&f!==""){const m=_(f);m&&s(a,f,m)}else f===""&&u(a)}}),Z(i,o,{get:function(){return o.get.call(i)},set:function(f,m){if(a._isFormatting){m(f);return}if(!f||f===""){m(""),u(a);return}const g=_(f)||x(f);if(g){const y=E(g),A=i.getAttribute(t)||"",v=L(i),D=T(v),k=I(g,A,v,D);m(k),s(a,y,g,k)}else m(String(f)),u(a)}}),this._onPickerChange=function(){const f=C.value;if(f){const m=_(f);m&&s(a,f,m)}else u(a)},C.addEventListener("change",this._onPickerChange),this._onBlur=function(){const f=a.dom.value.trim();if(f===""){a._lastISO!==""&&u(a);return}if(a._lastISO){const g=_(a._lastISO);if(g){const y=a.dom.getAttribute(t)||"",A=L(a.dom),v=T(A);if(f===I(g,y,A,v))return}}const m=x(f);if(m){const g=E(m);s(a,g,m)}else if(a._lastISO){const g=_(a._lastISO);g&&a._displayFormatted(g)}else a.dom.value=""},i.addEventListener("blur",this._onBlur),this._onBtnClick=function(){a._openPicker()},S.addEventListener("click",this._onBtnClick);const O=i.form;if(O&&(this._form=O,this._onFormReset=function(){setTimeout(function(){const f=a.dom.value;if(f){const m=_(f)||x(f);if(m){const g=E(m);s(a,g,m);return}}u(a)},0)},O.addEventListener("reset",this._onFormReset)),d&&d!==""){const f=_(d);f&&s(a,d,f)}return this}c.prototype._initTextElement=function(){const i=this.dom,a=i.getAttribute("data-ln-value"),d=i.getAttribute("data-ln-date"),h=i.getAttribute("datetime");let b=null;i.tagName==="TIME"&&h!==null&&h!==""?b=h:a!==null&&a!==""?b=a:h!==null&&h!==""?b=h:d!==null&&d!==""&&d!=="true"&&!B.test(d)?b=d:b=i.textContent.trim();const p=_(b)||x(b);if(p&&!isNaN(p.getTime())){const w=E(p);this._rawValue=w,i.tagName!=="TIME"&&!i.hasAttribute("data-ln-value")&&i.setAttribute("data-ln-value",w),this._formatTextContent()}else this._rawValue=null},c.prototype._formatTextContent=function(){if(this._rawValue){const i=_(this._rawValue);if(i){let d=this.dom.getAttribute("data-ln-date-format");if(!d){const p=this.dom.getAttribute("data-ln-date");p&&B.test(p)&&(d=p)}const h=L(this.dom),b=T(h);this.dom.textContent=I(i,d||"medium",h,b)}}},c.prototype._openPicker=function(){if(typeof this._picker.showPicker=="function")try{this._picker.showPicker()}catch{this._picker.click()}else this._picker.click()},c.prototype._setHiddenRaw=function(i){o.set.call(this._hidden,i)},c.prototype._displayFormatted=function(i){const a=this.dom.getAttribute(t)||"",d=L(this.dom),h=T(d);this._isFormatting=!0,this.dom.value=I(i,a,d,h),this._isFormatting=!1},Object.defineProperty(c.prototype,"value",{get:function(){return this.isTextElement?this._rawValue||"":o.get.call(this._hidden)},set:function(i){if(this.isTextElement){if(!i||i===""){this._rawValue=null,this.dom.removeAttribute("data-ln-value"),this.dom.tagName==="TIME"&&this.dom.removeAttribute("datetime"),this.dom.textContent="";return}const d=_(i)||x(i);if(!d)return;const h=E(d);this._rawValue=h,this.dom.tagName==="TIME"?this.dom.setAttribute("datetime",h):this.dom.setAttribute("data-ln-value",h),this._formatTextContent();return}if(!i||i===""){u(this);return}const a=_(i);a&&s(this,i,a)}}),Object.defineProperty(c.prototype,"date",{get:function(){const i=this.value;return i?_(i):null},set:function(i){if(!i||!(i instanceof Date)||isNaN(i.getTime())){this.value="";return}this.value=E(i)}}),Object.defineProperty(c.prototype,"formatted",{get:function(){return this.isTextElement?this.dom.textContent:this.dom.value}}),c.prototype.destroy=function(){if(!this.dom[e])return;if(this.isTextElement){delete this.dom[e];return}this._form&&this._onFormReset&&this._form.removeEventListener("reset",this._onFormReset),this._picker.removeEventListener("change",this._onPickerChange),this.dom.removeEventListener("blur",this._onBlur),this._btn.removeEventListener("click",this._onBtnClick);const i=this.value;this._hidden.remove(),this._picker.remove(),this._btn.remove(),this._wrapper&&this._wrapper.parentNode&&(this._wrapper.parentNode.insertBefore(this.dom,this._wrapper),this._wrapper.remove()),delete this.dom.value,this.dom.name=this._hidden.name,this.dom.type="date",i&&(this.dom.value=i),this._onLocaleChange&&document.removeEventListener("ln-core:locale-change",this._onLocaleChange),delete this.dom[e]},gt(t,e,c,"ln-date",{attributes:r,extraAttributes:["datetime","lang"],onAttributeChange:n})})()})();

package/components/ln-date/ln-date.schema.json

@@ -0,0 +1,92 @@
+{
+	"$comment": "This file is partly generated. The $comment, component, generator, and each attribute's direction, sources, type, values, fallback, and description keys are owned by the generator and synchronized from JS source code. All other keys are preserved and safe to hand-author. Regenerate with `npm run sync:ln-schemas`.",
+	"component": "ln-date",
+	"generator": "scripts/sync-ln-schemas.mjs",
+	"attributes": {
+		"data-ln-date": {
+			"direction": "author",
+			"sources": [
+				"ln-date-dev.scss",
+				"src/ln-date.js"
+			],
+			"type": "enum",
+			"values": [
+				"short",
+				"medium",
+				"long",
+				"full",
+				"iso"
+			],
+			"fallback": "medium",
+			"description": "Date display style preset or activator"
+		},
+		"data-ln-date-dict": {
+			"direction": "author",
+			"sources": [
+				"src/ln-date.js"
+			],
+			"type": "marker",
+			"description": "Container for date translation dictionary"
+		},
+		"data-ln-date-dict-key": {
+			"direction": null,
+			"sources": [
+				"src/ln-date.js"
+			],
+			"type": "string",
+			"description": "Dictionary key for relative time or custom date formatting"
+		},
+		"data-ln-date-field": {
+			"direction": "runtime",
+			"sources": [
+				"src/ln-date.js"
+			],
+			"type": "string",
+			"description": "Field name mapping for date record binding"
+		},
+		"data-ln-date-format": {
+			"direction": "author",
+			"sources": [
+				"src/ln-date.js"
+			],
+			"type": "string",
+			"description": "Custom Intl.DateTimeFormat pattern or options"
+		},
+		"data-ln-date-label": {
+			"direction": "both",
+			"sources": [
+				"src/ln-date.js"
+			],
+			"type": "string",
+			"description": "Accessible label text for the date input"
+		},
+		"data-ln-date-locale": {
+			"direction": null,
+			"sources": [
+				"src/ln-date.js"
+			],
+			"type": "string",
+			"description": "BCP 47 language tag override for date formatting"
+		},
+		"data-ln-debug": {
+			"direction": null,
+			"sources": [
+				"ln-date-dev.scss"
+			]
+		},
+		"data-ln-fill-as": {
+			"direction": "both",
+			"sources": [
+				"src/ln-date.js"
+			]
+		},
+		"data-ln-value": {
+			"direction": "both",
+			"sources": [
+				"src/ln-date.js"
+			],
+			"type": "string",
+			"description": "Raw ISO date string or timestamp for non-time elements (td, span)"
+		}
+	}
+}

package/components/ln-date/src/date-model.js

@@ -0,0 +1,186 @@
+export const KEYWORD_RE = /^(short|medium|long)(\s+datetime)?$/;
+
+export const KEYWORD_OPTIONS = {
+	'short':          { dateStyle: 'short' },
+	'medium':         { dateStyle: 'medium' },
+	'long':           { dateStyle: 'long' },
+	'short datetime':  { dateStyle: 'short', timeStyle: 'short' },
+	'medium datetime': { dateStyle: 'medium', timeStyle: 'short' },
+	'long datetime':   { dateStyle: 'long', timeStyle: 'short' }
+};
+
+/**
+ * Returns Intl.DateTimeFormat options if format is a recognized keyword, or null for custom patterns.
+ * @param {string} format
+ * @returns {Intl.DateTimeFormatOptions|null}
+ */
+export function getIntlDateOptions(format) {
+	if (!format || format === '') return { dateStyle: 'medium' };
+	const match = String(format).trim().match(KEYWORD_RE);
+	if (match) {
+		return KEYWORD_OPTIONS[format.trim()];
+	}
+	return null;
+}
+
+/**
+ * Parses user typed date strings (e.g. DD.MM.YYYY, MM/DD/YYYY, YYYY-MM-DD) into a valid Date object.
+ * @param {string} str
+ * @returns {Date|null}
+ */
+export function parseTypedDate(str) {
+	if (!str || typeof str !== 'string') return null;
+	const trimmed = str.trim();
+	if (trimmed.length < 6) return null;
+
+	let sep, parts;
+	if (trimmed.indexOf('.') !== -1) {
+		sep = '.';
+		parts = trimmed.split('.');
+	} else if (trimmed.indexOf('/') !== -1) {
+		sep = '/';
+		parts = trimmed.split('/');
+	} else if (trimmed.indexOf('-') !== -1) {
+		sep = '-';
+		parts = trimmed.split('-');
+	} else {
+		return null;
+	}
+
+	if (parts.length !== 3) return null;
+	const nums = [];
+	for (let i = 0; i < 3; i++) {
+		const n = parseInt(parts[i], 10);
+		if (isNaN(n)) return null;
+		nums.push(n);
+	}
+
+	let day, month, year;
+	if (sep === '.') {
+		day = nums[0];
+		month = nums[1];
+		year = nums[2];
+	} else if (sep === '/') {
+		month = nums[0];
+		day = nums[1];
+		year = nums[2];
+	} else {
+		if (parts[0].length === 4) {
+			year = nums[0];
+			month = nums[1];
+			day = nums[2];
+		} else {
+			day = nums[0];
+			month = nums[1];
+			year = nums[2];
+		}
+	}
+
+	if (year < 100) {
+		year += (year < 50) ? 2000 : 1900;
+	}
+
+	const date = new Date(year, month - 1, day);
+	if (date.getFullYear() !== year || date.getMonth() !== month - 1 || date.getDate() !== day) {
+		return null;
+	}
+	return date;
+}
+
+/**
+ * Formats a Date object using a custom pattern with token replacements.
+ * @param {Date} date
+ * @param {string} pattern Pattern with tokens (yyyy, yy, MMMM, MMM, MM, M, dd, d, HH, mm)
+ * @param {string} [locale]
+ * @param {object} [fallback] Custom locale fallback dictionary
+ * @returns {string}
+ */
+export function formatCustomDate(date, pattern, locale, fallback) {
+	if (!date || !(date instanceof Date) || isNaN(date.getTime())) return '';
+	if (!pattern || typeof pattern !== 'string') return '';
+
+	const day = date.getDate();
+	const month = date.getMonth();
+	const year = date.getFullYear();
+	const hours = date.getHours();
+	const minutes = date.getMinutes();
+
+	let mmmmVal, mmmVal;
+	const langPrefix = (locale || '').toLowerCase().split('-')[0];
+
+	let isFallbackNeeded = false;
+	try {
+		const fmt = new Intl.DateTimeFormat(locale, { month: 'long' });
+		const resolvedLocale = fmt.resolvedOptions().locale.toLowerCase().split('-')[0];
+		isFallbackNeeded = Boolean(fallback && resolvedLocale !== langPrefix);
+	} catch (e) {
+		isFallbackNeeded = Boolean(fallback);
+	}
+
+	if (isFallbackNeeded && fallback && fallback.monthsLong) {
+		mmmmVal = fallback.monthsLong[month];
+	} else {
+		try {
+			mmmmVal = new Intl.DateTimeFormat(locale, { month: 'long' }).format(date);
+		} catch (e) {
+			mmmmVal = String(month + 1);
+		}
+	}
+
+	if (isFallbackNeeded && fallback && fallback.monthsShort) {
+		mmmVal = fallback.monthsShort[month];
+	} else {
+		try {
+			mmmVal = new Intl.DateTimeFormat(locale, { month: 'short' }).format(date);
+		} catch (e) {
+			mmmVal = String(month + 1);
+		}
+	}
+
+	const tokens = {
+		'yyyy': String(year),
+		'yy':   String(year).slice(-2),
+		'MMMM': mmmmVal,
+		'MMM':  mmmVal,
+		'MM':   String(month + 1).padStart(2, '0'),
+		'M':    String(month + 1),
+		'dd':   String(day).padStart(2, '0'),
+		'd':    String(day),
+		'HH':   String(hours).padStart(2, '0'),
+		'mm':   String(minutes).padStart(2, '0')
+	};
+
+	return pattern.replace(/yyyy|yy|MMMM|MMM|MM|M|dd|d|HH|mm/g, function (m) {
+		return tokens[m] !== undefined ? tokens[m] : m;
+	});
+}
+
+/**
+ * Formats a date value using either standard Intl options or a custom pattern.
+ * @param {Date} date
+ * @param {string} [format='medium']
+ * @param {string} [locale]
+ * @param {object} [fallback]
+ * @returns {string}
+ */
+export function formatDateValue(date, format, locale, fallback) {
+	if (!date || !(date instanceof Date) || isNaN(date.getTime())) return '';
+
+	const intlOptions = getIntlDateOptions(format);
+	if (intlOptions) {
+		try {
+			const formatter = new Intl.DateTimeFormat(locale, intlOptions);
+			const langPrefix = (locale || '').toLowerCase().split('-')[0];
+			const resolvedLocale = formatter.resolvedOptions().locale.toLowerCase().split('-')[0];
+
+			if (fallback && resolvedLocale !== langPrefix) {
+				return formatCustomDate(date, 'dd.MM.yyyy', locale, fallback);
+			}
+			return formatter.format(date);
+		} catch (e) {
+			return formatCustomDate(date, 'dd.MM.yyyy', locale, fallback);
+		}
+	}
+
+	return formatCustomDate(date, format || 'dd.MM.yyyy', locale, fallback);
+}