npm - assign-gingerly - Versions diffs - 0.0.92 → 0.0.93 - Mend

assign-gingerly 0.0.92 → 0.0.93

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/inferencer/inferencer.js +43 -0
package/inferencer/inferencer.ts +42 -0
package/inferencer/types/inferencer/types.d.ts +19 -1
package/package.json +1 -1

package/inferencer/inferencer.js CHANGED Viewed

@@ -89,6 +89,16 @@ export class Infer {
     get valueProperty() {
         return inferValueProperty(this.enhancedElement);
     }
+    /**
+     * The effective language for this element, honoring `lang` / `xml:lang`
+     * inheritance up through ancestors and shadow-root hosts, then
+     * `<html lang>` and finally `navigator.language`.
+     * @returns a BCP-47 tag, or undefined if nothing is resolvable
+     */
+    get lang() {
+        const el = this.#weakRef.deref();
+        return el === undefined ? undefined : resolveLang(el);
+    }
     ['|'](itempropAttr, scopeBoundary = '[itemscope]') {
         return this.#queryScoped(`[itemprop="${itempropAttr}"]`, itempropAttr, scopeBoundary);
     }
@@ -244,6 +254,39 @@ export function serializeForProperty(propName, nv) {
         return JSON.stringify(nv);
     return nv;
 }
+/**
+ * Resolve the effective language ("computed lang") for an element.
+ *
+ * There is no DOM accessor for this, so we walk: nearest ancestor element with a
+ * `lang` / `xml:lang` attribute, crossing shadow-root boundaries via the host
+ * (matching how `:lang()` behaves in modern browsers), then `<html lang>`, then
+ * `navigator.language`. Slot reprojection is intentionally not followed — HTML
+ * language inheritance is defined over the real node tree, not the flat tree.
+ *
+ * @returns a BCP-47 tag, or undefined if nothing is resolvable
+ */
+export function resolveLang(element) {
+    let node = element;
+    while (node != null) {
+        if (node.nodeType === 1 /* ELEMENT_NODE */) {
+            const el = node;
+            const lang = el.getAttribute('lang') || el.getAttribute('xml:lang');
+            if (lang)
+                return lang;
+            node = node.parentNode;
+        }
+        else if (node.nodeType === 11 /* DOCUMENT_FRAGMENT_NODE, incl. ShadowRoot */) {
+            node = node.host ?? null;
+        }
+        else {
+            node = null; // Document (9) or detached — stop
+        }
+    }
+    if (typeof document !== 'undefined' && document.documentElement.lang) {
+        return document.documentElement.lang;
+    }
+    return (typeof navigator !== 'undefined' && navigator.language) || undefined;
+}
 /**
  * Infer the most appropriate display property for an element
  * @param element - The element to infer the property for

package/inferencer/inferencer.ts CHANGED Viewed

@@ -110,6 +110,17 @@ export class Infer<TValue = any, TDisplay = any> {
         return inferValueProperty(this.enhancedElement);
     }
+    /**
+     * The effective language for this element, honoring `lang` / `xml:lang`
+     * inheritance up through ancestors and shadow-root hosts, then
+     * `<html lang>` and finally `navigator.language`.
+     * @returns a BCP-47 tag, or undefined if nothing is resolvable
+     */
+    get lang(): string | undefined {
+        const el = this.#weakRef.deref();
+        return el === undefined ? undefined : resolveLang(el);
+    }
     ['|'](itempropAttr: string, scopeBoundary: string = '[itemscope]'){
         return this.#queryScoped(`[itemprop="${itempropAttr}"]`, itempropAttr, scopeBoundary);
     }
@@ -277,6 +288,37 @@ export function serializeForProperty(propName: string, nv: any): any {
     return nv;
 }
+/**
+ * Resolve the effective language ("computed lang") for an element.
+ *
+ * There is no DOM accessor for this, so we walk: nearest ancestor element with a
+ * `lang` / `xml:lang` attribute, crossing shadow-root boundaries via the host
+ * (matching how `:lang()` behaves in modern browsers), then `<html lang>`, then
+ * `navigator.language`. Slot reprojection is intentionally not followed — HTML
+ * language inheritance is defined over the real node tree, not the flat tree.
+ *
+ * @returns a BCP-47 tag, or undefined if nothing is resolvable
+ */
+export function resolveLang(element: Element): string | undefined {
+    let node: Node | null = element;
+    while (node != null) {
+        if (node.nodeType === 1 /* ELEMENT_NODE */) {
+            const el = node as Element;
+            const lang = el.getAttribute('lang') || el.getAttribute('xml:lang');
+            if (lang) return lang;
+            node = node.parentNode;
+        } else if (node.nodeType === 11 /* DOCUMENT_FRAGMENT_NODE, incl. ShadowRoot */) {
+            node = (node as ShadowRoot).host ?? null;
+        } else {
+            node = null; // Document (9) or detached — stop
+        }
+    }
+    if (typeof document !== 'undefined' && document.documentElement.lang) {
+        return document.documentElement.lang;
+    }
+    return (typeof navigator !== 'undefined' && navigator.language) || undefined;
+}
 /**
  * Infer the most appropriate display property for an element
  * @param element - The element to infer the property for

package/inferencer/types/inferencer/types.d.ts CHANGED Viewed

@@ -15,14 +15,32 @@ export declare const display: symbol;
  */
 export declare class Infer<TValue = any, TDisplay = any> {
     get enhancedElement(): Element;
-    constructor(enhancedElement?: Element);
+    constructor(enhancedElement?: Element, propName?: string);
+    /** Live, type-coerced read of the element's inferred value property. */
     get value(): TValue | undefined;
     set value(nv: TValue);
     get display(): TDisplay | undefined;
     set display(nv: TDisplay);
     get eventType(): string;
+    /** The inferred value property name (e.g. 'value', 'checked', 'dateTime'). */
+    get valueProperty(): string;
+    get defaultRemoteBindingPropName(): string;
+    /**
+     * EventTarget that emits an event named after the changed property.
+     * Custom elements with a native propagator return that; otherwise an
+     * InferencedPropagator using best-effort change detection.
+     */
+    getPropagator(): Promise<EventTarget>;
+    setDisplay(vm: any): void;
 }
+/**
+ * Read the inferred value property off an element and coerce it to a natural
+ * JavaScript type (Date for <time>, number/boolean via JSON parse for <data>,
+ * schema.org itemtype hints honored, textContent verbatim).
+ */
+export declare function coerceElementValue(element: Element, propName?: string): any;
 /**
  * Registry item for the Infer enhancement
  */

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "assign-gingerly",
-  "version": "0.0.92",
+  "version": "0.0.93",
   "description": "This package provides a utility function for carefully merging one object into another.",
   "homepage": "https://github.com/bahrus/assign-gingerly#readme",
   "bugs": {