assign-gingerly 0.0.36 → 0.0.38

package/object-extension.js

@@ -138,7 +138,7 @@ class ElementEnhancementContainer {
             }
             // Check if there's an enhKey
             if (registryItem.enhKey) {
-                const ctx = { config: registryItem, mountCtx };
+                const ctx = { config: registryItem, mountCtx, emc: mountCtx?.emc };
                 const self = this;
                 // Get existing initVals from enhKey
                 const existingInitVals = self[registryItem.enhKey] &&
@@ -155,7 +155,7 @@ class ElementEnhancementContainer {
             }
             else {
                 // No enhKey, still pass attrInitVals
-                const ctx = { config: registryItem, mountCtx };
+                const ctx = { config: registryItem, mountCtx, emc: mountCtx?.emc };
                 instance = new SpawnClass(element, ctx, attrInitVals);
             }
             // Store in global instance map

package/object-extension.ts

@@ -1,5 +1,5 @@
 import assignGingerly, { EnhancementRegistry, ItemscopeRegistry, IAssignGingerlyOptions, getInstanceMap, INSTANCE_MAP_GUID } from './assignGingerly.js';
-import { EnhancementConfig } from './types/assign-gingerly/types.js';
+import { EnhancementConfig, SpawnContext } from './types/assign-gingerly/types.js';
 import { parseWithAttrs } from './parseWithAttrs.js';
 
 /**
@@ -225,7 +225,7 @@ class ElementEnhancementContainer {
       
       // Check if there's an enhKey
       if (registryItem.enhKey) {
-        const ctx = { config: registryItem, mountCtx };
+        const ctx: SpawnContext = { config: registryItem, mountCtx, emc: (mountCtx as any)?.emc };
         const self = this as any;
         
         // Get existing initVals from enhKey
@@ -245,7 +245,7 @@ class ElementEnhancementContainer {
         self[registryItem.enhKey] = instance;
       } else {
         // No enhKey, still pass attrInitVals
-        const ctx = { config: registryItem, mountCtx };
+        const ctx: SpawnContext = { config: registryItem, mountCtx, emc: (mountCtx as any)?.emc };
         instance = new SpawnClass(element, ctx, attrInitVals);
       }
       

package/package.json

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

package/parseWithAttrs.js

@@ -143,10 +143,15 @@ function hasDashOrNonASCII(str) {
  * Gets attribute value with smart enh- prefix handling
  * @param element - The element to read from
  * @param attrName - The attribute name (without enh- prefix)
- * @param allowUnprefixed - Pattern (string or RegExp) that element tag name must match to allow unprefixed attributes
+ * @param allowUnprefixed - Pattern (string or RegExp) that element tag name must match to allow unprefixed attributes,
+ *                          or `true` for custom element mode (read attributes directly, no enh- prefix)
  * @returns The attribute value or null
  */
 function getAttributeValue(element, attrName, allowUnprefixed) {
+    // Custom element mode - read attribute directly, no enh- prefix
+    if (allowUnprefixed === true) {
+        return element.getAttribute(attrName);
+    }
     const { localName } = element;
     const isCustomElement = localName.includes('-');
     const isSVGElement = typeof SVGElement !== 'undefined' && element instanceof SVGElement;
@@ -222,15 +227,18 @@ function getDefaultParser(instanceOf) {
  * Parses attributes from an element based on AttrPatterns configuration
  * @param element - The DOM element to read attributes from
  * @param attrPatterns - The attribute patterns configuration
- * @param allowUnprefixed - Pattern (string or RegExp) that element tag name must match to allow unprefixed attributes
+ * @param allowUnprefixed - Pattern (string or RegExp) that element tag name must match to allow unprefixed attributes,
+ *                          or `true` for custom element mode: reads attributes directly (no enh- prefix),
+ *                          skips base attribute dash validation, and skips properties already set on the element
  * @param spawnContext - Optional spawn context containing enhancement config and synthesizer element
  * @returns Object with parsed attribute values ready for initVals
  */
 export function parseWithAttrs(element, attrPatterns, allowUnprefixed, spawnContext) {
     // Extract synthesizerElement from spawnContext for backward compatibility
     const synthesizerElement = spawnContext?.synthesizerElement;
-    // Validate base attribute if present
-    if ('base' in attrPatterns) {
+    const isCustomElementMode = allowUnprefixed === true;
+    // Validate base attribute if present (skip in custom element mode)
+    if ('base' in attrPatterns && !isCustomElementMode) {
         const baseValue = attrPatterns.base;
         if (!hasDashOrNonASCII(baseValue)) {
             throw new Error(`Invalid base attribute "${baseValue}": must contain a dash (-) or non-ASCII character. ` +
@@ -284,6 +292,13 @@ export function parseWithAttrs(element, attrPatterns, allowUnprefixed, spawnCont
     }
     // Second pass: read attributes and parse values
     for (const [key, { attrName, config }] of resolvedAttrs) {
+        // In custom element mode, skip properties already set on the element
+        if (isCustomElementMode) {
+            const mapsTo = config.mapsTo ?? (key === 'base' ? '.' : key);
+            if (mapsTo !== '.' && element[mapsTo] !== undefined) {
+                continue;
+            }
+        }
         const attrValue = getAttributeValue(element, attrName, allowUnprefixed);
         // Create parser context
         const parserContext = {

package/parseWithAttrs.ts

@@ -178,14 +178,20 @@ function hasDashOrNonASCII(str: string): boolean {
  * Gets attribute value with smart enh- prefix handling
  * @param element - The element to read from
  * @param attrName - The attribute name (without enh- prefix)
- * @param allowUnprefixed - Pattern (string or RegExp) that element tag name must match to allow unprefixed attributes
+ * @param allowUnprefixed - Pattern (string or RegExp) that element tag name must match to allow unprefixed attributes,
+ *                          or `true` for custom element mode (read attributes directly, no enh- prefix)
  * @returns The attribute value or null
  */
 function getAttributeValue(
   element: Element,
   attrName: string,
-  allowUnprefixed?: string | RegExp
+  allowUnprefixed?: string | RegExp | true
 ): string | null {
+  // Custom element mode - read attribute directly, no enh- prefix
+  if (allowUnprefixed === true) {
+    return element.getAttribute(attrName);
+  }
+  
   const { localName } = element;
   const isCustomElement = localName.includes('-');
   const isSVGElement = typeof SVGElement !== 'undefined' && element instanceof SVGElement;
@@ -261,21 +267,25 @@ function getDefaultParser(instanceOf?: string | Function): ParserFunction {
  * Parses attributes from an element based on AttrPatterns configuration
  * @param element - The DOM element to read attributes from
  * @param attrPatterns - The attribute patterns configuration
- * @param allowUnprefixed - Pattern (string or RegExp) that element tag name must match to allow unprefixed attributes
+ * @param allowUnprefixed - Pattern (string or RegExp) that element tag name must match to allow unprefixed attributes,
+ *                          or `true` for custom element mode: reads attributes directly (no enh- prefix),
+ *                          skips base attribute dash validation, and skips properties already set on the element
  * @param spawnContext - Optional spawn context containing enhancement config and synthesizer element
  * @returns Object with parsed attribute values ready for initVals
  */
 export function parseWithAttrs<T = any>(
     element: Element,
     attrPatterns: AttrPatterns<T>,
-    allowUnprefixed?: string | RegExp,
+    allowUnprefixed?: string | RegExp | true,
     spawnContext?: SpawnContext<T>
 ): Partial<T> {
     // Extract synthesizerElement from spawnContext for backward compatibility
     const synthesizerElement = spawnContext?.synthesizerElement;
     
-    // Validate base attribute if present
-    if ('base' in attrPatterns) {
+    const isCustomElementMode = allowUnprefixed === true;
+    
+    // Validate base attribute if present (skip in custom element mode)
+    if ('base' in attrPatterns && !isCustomElementMode) {
         const baseValue = attrPatterns.base as string;
         if (!hasDashOrNonASCII(baseValue)) {
             throw new Error(
@@ -341,6 +351,14 @@ export function parseWithAttrs<T = any>(
     
     // Second pass: read attributes and parse values
     for (const [key, { attrName, config }] of resolvedAttrs) {
+        // In custom element mode, skip properties already set on the element
+        if (isCustomElementMode) {
+            const mapsTo = config.mapsTo ?? (key === 'base' ? '.' : key);
+            if (mapsTo !== '.' && (element as any)[mapsTo as string] !== undefined) {
+                continue;
+            }
+        }
+        
         const attrValue = getAttributeValue(element, attrName, allowUnprefixed);
         
         // Create parser context

package/types/assign-gingerly/types.d.ts

@@ -212,6 +212,13 @@ export interface SpawnContext<T = any, TMountContext = any> {
    * Used for scoped parser registry access during attribute parsing.
    */
   synthesizerElement?: Element;
+  /**
+   * The full EMC configuration object that triggered this spawn.
+   * Passed through so enhancement classes can access their full configuration
+   * (including customData) without needing to separately import the JSON file.
+   * This avoids duplicate JSON imports when using emoji shorthand aliases.
+   */
+  emc?: any;
 }
 
 /**