native-document 1.0.165 → 1.0.168

package/src/core/elements/control/show-if.js

@@ -1,8 +1,8 @@
-import { Observable } from "../../data/Observable";
-import Validator from "../../utils/validator";
-import DebugManager from "../../utils/debug-manager.js";
-import Anchor from "../anchor/anchor";
-import {ElementCreator} from "../../wrappers/ElementCreator";
+import { Observable } from '../../data/Observable';
+import Validator from '../../utils/validator';
+import DebugManager from '../../utils/debug-manager.js';
+import Anchor from '../anchor/anchor';
+import {ElementCreator} from '../../wrappers/ElementCreator';
 
 /**
  * Conditionally shows an element based on an observable condition.
@@ -20,11 +20,11 @@ import {ElementCreator} from "../../wrappers/ElementCreator";
  */
 export const ShowIf = function(condition, child, { comment = null, shouldKeepInCache = true} = {}) {
     if(!Validator.isObservable(condition)) {
-        if(typeof condition === "boolean") {
+        if(typeof condition === 'boolean') {
             return condition ? ElementCreator.getChild(child) : null;
         }
 
-        return DebugManager.warn('ShowIf', "ShowIf : condition must be an Observable or boolean / "+comment, condition);
+        return DebugManager.warn('ShowIf', 'ShowIf : condition must be an Observable or boolean / '+comment, condition);
     }
     const element = Anchor('Show if : '+(comment || ''));
 
@@ -47,7 +47,7 @@ export const ShowIf = function(condition, child, { comment = null, shouldKeepInC
     }
 
     condition.subscribe((value) => {
-        if(!!value) {
+        if(value) {
             element.appendChild(getChildElement());
             return;
         }
@@ -55,7 +55,7 @@ export const ShowIf = function(condition, child, { comment = null, shouldKeepInC
     });
 
     return element;
-}
+};
 
 /**
  * Conditionally hides an element when the observable condition is true.
@@ -76,7 +76,7 @@ export const HideIf = function(condition, child, configs) {
     condition.subscribe(value => hideCondition.set(!value));
 
     return ShowIf(hideCondition, child, configs);
-}
+};
 
 /**
  * Conditionally hides an element when the observable condition is false.
@@ -91,4 +91,4 @@ export const HideIf = function(condition, child, configs) {
  */
 export const HideIfNot = function(condition, child, configs) {
     return ShowIf(condition, child, configs);
-}
+};

package/src/core/elements/control/show-when.js

@@ -1,6 +1,6 @@
-import Validator from "../../utils/validator.js";
-import NativeDocumentError from "../../errors/NativeDocumentError.js";
-import {ShowIf} from "./show-if.js";
+import Validator from '../../utils/validator.js';
+import NativeDocumentError from '../../errors/NativeDocumentError.js';
+import {ShowIf} from './show-if.js';
 
 /**
  * Shows content when an observable equals a specific value.
@@ -31,7 +31,7 @@ export const ShowWhen = function() {
         if(!Validator.isObservableWhenResult(observer)) {
             throw new NativeDocumentError('showWhen observer must be an ObservableWhenResult', {
                 data: observer,
-                'help': 'Use observer.when(target) to create an ObservableWhenResult'
+                'help': 'Use observer.when(target) to create an ObservableWhenResult',
             });
         }
         return ShowIf(observer, target);
@@ -49,6 +49,6 @@ export const ShowWhen = function() {
         data: [
             'showWhen(observer, target, view)',
             'showWhen(observerWhenResult, view)',
-        ]
+        ],
     });
 };

package/src/core/elements/control/switch.js

@@ -1,7 +1,7 @@
-import NativeDocumentError from "../../errors/NativeDocumentError";
-import Validator from "../../utils/validator";
-import Anchor from "../anchor/anchor";
-import {ElementCreator} from "../../wrappers/ElementCreator";
+import NativeDocumentError from '../../errors/NativeDocumentError';
+import Validator from '../../utils/validator';
+import Anchor from '../anchor/anchor';
+import {ElementCreator} from '../../wrappers/ElementCreator';
 
 
 
@@ -28,7 +28,7 @@ import {ElementCreator} from "../../wrappers/ElementCreator";
 export const Match = function($condition, values, shouldKeepInCache = true) {
 
     if(!Validator.isObservable($condition)) {
-        throw new NativeDocumentError("Toggle : condition must be an Observable");
+        throw new NativeDocumentError('Toggle : condition must be an Observable');
     }
 
     const anchor = Anchor('Match');
@@ -48,7 +48,7 @@ export const Match = function($condition, values, shouldKeepInCache = true) {
         }
         shouldKeepInCache && cache.set(key, item);
         return item;
-    }
+    };
 
     const defaultValue = $condition.val();
     const defaultContent = getItem(defaultValue);
@@ -75,9 +75,9 @@ export const Match = function($condition, values, shouldKeepInCache = true) {
             shouldKeepInCache && cache.delete(key);
             $condition.set([...cache.keys()].at(-1) ?? '');
             delete values[key];
-        }
+        },
     });
-}
+};
 
 
 /**
@@ -97,14 +97,14 @@ export const Match = function($condition, values, shouldKeepInCache = true) {
  */
 export const Switch = function ($condition, onTrue, onFalse) {
     if(!Validator.isObservable($condition)) {
-        throw new NativeDocumentError("Toggle : condition must be an Observable");
+        throw new NativeDocumentError('Toggle : condition must be an Observable');
     }
 
     return Match($condition.toBoolean(), {
         true: onTrue,
         false: onFalse,
     });
-}
+};
 
 /**
  * Provides a fluent API for conditional rendering with show/otherwise pattern.
@@ -119,7 +119,7 @@ export const Switch = function ($condition, onTrue, onFalse) {
  */
 export const When = function($condition) {
     if(!Validator.isObservable($condition)) {
-        throw new NativeDocumentError("When : condition must be an Observable");
+        throw new NativeDocumentError('When : condition must be an Observable');
     }
 
     let $onTrue = null;
@@ -136,6 +136,6 @@ export const When = function($condition) {
         },
         toNdElement() {
             return Switch($condition, $onTrue, $onFalse);
-        }
-    }
-}
+        },
+    };
+};

package/src/core/elements/description-list.js

@@ -1,4 +1,4 @@
-import HtmlElementWrapper from "../wrappers/HtmlElementWrapper";
+import HtmlElementWrapper from '../wrappers/HtmlElementWrapper';
 
 /**
  * Creates a `<dl>` element.

package/src/core/elements/form.js

@@ -1,4 +1,4 @@
-import HtmlElementWrapper from "../wrappers/HtmlElementWrapper";
+import HtmlElementWrapper from '../wrappers/HtmlElementWrapper';
 
 
 /**
@@ -27,7 +27,7 @@ export const Form = HtmlElementWrapper('form', (el) => {
     el.multipartFormData = function() {
         this.setAttribute('enctype', 'multipart/form-data');
         return el;
-    }
+    };
     el.post = function(action) {
         this.setAttribute('method', 'post');
         this.setAttribute('action', action);

package/src/core/elements/fragment.js

@@ -1,4 +1,4 @@
-import HtmlElementWrapper from "../wrappers/HtmlElementWrapper";
+import HtmlElementWrapper from '../wrappers/HtmlElementWrapper';
 
 /**
  * Creates an empty `DocumentFragment` wrapper.

package/src/core/elements/html5-semantics.js

@@ -1,4 +1,4 @@
-import HtmlElementWrapper from "../wrappers/HtmlElementWrapper";
+import HtmlElementWrapper from '../wrappers/HtmlElementWrapper';
 
 /**
  * Creates a `<main>` element.

package/src/core/elements/img.js

@@ -1,6 +1,6 @@
-import HtmlElementWrapper from "../wrappers/HtmlElementWrapper"
-import Validator from "../utils/validator";
-import NativeDocumentError from "../errors/NativeDocumentError";
+import HtmlElementWrapper from '../wrappers/HtmlElementWrapper';
+import Validator from '../utils/validator';
+import NativeDocumentError from '../errors/NativeDocumentError';
 
 /**
  * Creates an `<img>` element.

package/src/core/elements/interactive.js

@@ -1,4 +1,4 @@
-import HtmlElementWrapper from "../wrappers/HtmlElementWrapper";
+import HtmlElementWrapper from '../wrappers/HtmlElementWrapper';
 
 /**
  * Creates a `<details>` element.

package/src/core/elements/list.js

@@ -1,4 +1,4 @@
-import HtmlElementWrapper from "../wrappers/HtmlElementWrapper";
+import HtmlElementWrapper from '../wrappers/HtmlElementWrapper';
 
 /**
  * Creates an `<ol>` element.

package/src/core/elements/medias.js

@@ -1,4 +1,4 @@
-import HtmlElementWrapper from "../wrappers/HtmlElementWrapper";
+import HtmlElementWrapper from '../wrappers/HtmlElementWrapper';
 
 /**
  * Creates an `<audio>` element.

package/src/core/elements/meta-data.js

@@ -1,4 +1,4 @@
-import HtmlElementWrapper from "../wrappers/HtmlElementWrapper";
+import HtmlElementWrapper from '../wrappers/HtmlElementWrapper';
 
 /**
  * Creates a `<time>` element.

package/src/core/elements/svg.js

@@ -1,4 +1,4 @@
-import SvgElementWrapper from "../wrappers/SvgElementWrapper";
+import SvgElementWrapper from '../wrappers/SvgElementWrapper';
 
 export const SvgSvg                 = SvgElementWrapper('svg');
 export const SvgCircle              = SvgElementWrapper('circle');

package/src/core/elements/table.js

@@ -1,4 +1,4 @@
-import HtmlElementWrapper from "../wrappers/HtmlElementWrapper";
+import HtmlElementWrapper from '../wrappers/HtmlElementWrapper';
 
 /**
  * Creates a `<caption>` element.

package/src/core/errors/ArgTypesError.js

@@ -2,6 +2,6 @@
 
 export default class ArgTypesError extends Error {
     constructor(message, errors) {
-        super(`${message}\n\n${errors.join("\n")}\n\n`);
+        super(`${message}\n\n${errors.join('\n')}\n\n`);
     }
 }

package/src/core/utils/HasEventEmitter.js

@@ -1,10 +1,30 @@
-
+/**
+ * Mixin constructor that adds a simple synchronous/async event emitter to any class.
+ * Extend or call this in your constructor to gain .on(), .trigger(), and .emit().
+ *
+ * @constructor
+ * @example
+ * function MyClass() {
+ *   HasEventEmitter.call(this);
+ * }
+ * MyClass.prototype = Object.create(HasEventEmitter.prototype);
+ * const instance = new MyClass();
+ * instance.on('ready', () => console.log('ready!'));
+ * instance.trigger('ready');
+ */
 export default function HasEventEmitter() {
 
     this.__$events = null;
 
 }
 
+/**
+ * Registers a callback for the given event name.
+ * Multiple callbacks for the same event are collected into an array.
+ *
+ * @param {string} eventName - Event identifier
+ * @param {Function} callback - Handler to register
+ */
 HasEventEmitter.prototype.on = function(eventName, callback) {
     if(!this.__$events) {
         this.__$events = new Map();
@@ -21,6 +41,12 @@ HasEventEmitter.prototype.on = function(eventName, callback) {
     existingCallback.push(callback);
 };
 
+/**
+ * Returns true if at least one callback is registered for the given event.
+ *
+ * @param {string} eventName - Event identifier
+ * @returns {boolean}
+ */
 HasEventEmitter.prototype.hasListeners = function(eventName) {
     if(!this.__$events) {
         return false;
@@ -28,6 +54,14 @@ HasEventEmitter.prototype.hasListeners = function(eventName) {
     return !!this.__$events.get(eventName);
 };
 
+/**
+ * Fires all registered callbacks for the given event name, awaiting each one in sequence.
+ * Returns the result of the last callback. Alias: .emit()
+ *
+ * @param {string} eventName - Event identifier
+ * @param {...*} args - Arguments passed to each callback
+ * @returns {Promise<*>} Result of the last callback, or undefined if none
+ */
 HasEventEmitter.prototype.trigger = async function(eventName, ...args) {
     if(!this.__$events) {
         return;
@@ -39,7 +73,7 @@ HasEventEmitter.prototype.trigger = async function(eventName, ...args) {
     }
 
     if(typeof callbacks === 'function') {
-        return await Promise.resolve(callbacks.apply(this, args))
+        return await Promise.resolve(callbacks.apply(this, args));
     }
 
     let result = null;

package/src/core/utils/args-types.js

@@ -1,6 +1,6 @@
-import Validator from "./validator";
-import ArgTypesError from "../errors/ArgTypesError";
-import NativeDocumentError from "../errors/NativeDocumentError";
+import Validator from './validator';
+import ArgTypesError from '../errors/ArgTypesError';
+import NativeDocumentError from '../errors/NativeDocumentError';
 
 let withValidation = (fn) => fn;
 let ArgTypes = {};
@@ -43,8 +43,8 @@ if(process.env.NODE_ENV === 'development') {
             name,
             type: 'oneOf',
             types: argTypes,
-            validate: (v) => argTypes.some(type => type.validate(v))
-        })
+            validate: (v) => argTypes.some(type => type.validate(v)),
+        }),
     };
 
 
@@ -84,7 +84,7 @@ if(process.env.NODE_ENV === 'development') {
         });
 
         if (errors.length > 0) {
-            throw new ArgTypesError(`Argument validation failed`, errors);
+            throw new ArgTypesError('Argument validation failed', errors);
         }
     };
 
@@ -123,7 +123,7 @@ if(process.env.NODE_ENV === 'production') {
         optional: () => true,
 
         // Union types
-        oneOf: () => true
+        oneOf: () => true,
     };
 }
 
@@ -132,9 +132,9 @@ export const normalizeComponentArgs = function(props, children = null) {
         return { props, children };
     }
     if(typeof props !== 'object' || Array.isArray(props) || props === null || props.constructor.name !== 'Object' ||  props.$hydrate) { // IF it's not a JSON
-        return { props: children, children: props }
+        return { props: children, children: props };
     }
     return { props, children };
-}
+};
 
 export { ArgTypes, withValidation };

package/src/core/utils/cache.js

@@ -1,4 +1,4 @@
-import { once as _once, autoMemoize, autoOnce } from "./memoize.js";
+import { once as _once, autoMemoize, autoOnce } from './memoize.js';
 
 export const once = fn => autoOnce(fn);
 export const singleton = fn => _once(fn);

package/src/core/utils/callback-handler.js

@@ -1,5 +1,18 @@
 
 
+/**
+ * Associates a shared callback with per-target context objects.
+ * Useful when the same event handler needs to behave differently depending on which element triggered it,
+ * without creating a new function closure per element (e.g.: in TemplateCloner).
+ *
+ * @constructor
+ * @param {(context: *, ...args: any[]) => void} callback - Handler receiving the stored context followed by event arguments
+ * @example
+ * const handler = CallbackHandler((item, event) => list.removeItem(item));
+ * handler.set(buttonElement, todoItem);
+ * buttonElement.addEventListener('click', handler.callback);
+ * // When clicked, calls callback(todoItem, event)
+ */
 export function CallbackHandler(callback) {
 
     if(!(this instanceof CallbackHandler)) {
@@ -8,10 +21,26 @@ export function CallbackHandler(callback) {
 
     const $contextSore = new WeakMap();
 
+    /**
+     * Associates a context value with a specific target (usually a DOM element).
+     * The context is retrieved and passed to the callback when .callback is invoked on that target.
+     *
+     * @param {object} target - The target object (usually an HTMLElement) used as the WeakMap key
+     * @param {*} context - The context value to store for this target
+     */
     this.set = (target, context) => {
         $contextSore.set(target, context);
     };
 
+    /**
+     * Event handler function to attach to DOM elements.
+     * When called, look up the context stored for `this` (the element) and invoke the callback.
+     * Designed to be passed directly to addEventListener.
+     *
+     * @type {EventListener}
+     * @example
+     * element.addEventListener('click', handler.callback);
+     */
     this.callback = function() {
         const context = $contextSore.get(this);
         if(context) {

package/src/core/utils/debug-manager.js

@@ -5,7 +5,7 @@ if(process.env.NODE_ENV === 'development') {
         enabled: true,
 
         enable() {
-            DebugManager.log('🔍 NativeDocument Debug Mode enabled');
+            DebugManager.log('NativeDocument Debug Mode enabled');
         },
 
         disable() {
@@ -13,19 +13,19 @@ if(process.env.NODE_ENV === 'development') {
         },
 
         log(category, message, data) {
-            console.group(`🔍 [${category}] ${message}`);
+            console.group(`[${category}] ${message}`);
             if (data) console.log(data);
             console.trace();
             console.groupEnd();
         },
 
         warn(category, message, data) {
-            console.warn(`⚠️ [${category}] ${message}`, data);
+            console.warn(`[${category}] ${message}`, data);
         },
 
         error(category, message, error) {
-            console.error(`❌ [${category}] ${message}`, error);
-        }
+            console.error(`[${category}] ${message}`, error);
+        },
     };
 
 }
@@ -34,7 +34,7 @@ if(process.env.NODE_ENV === 'production') {
         log() {},
         warn() {},
         error() {},
-        disable() {}
+        disable() {},
     };
 }
 export default DebugManager;