@mintjamsinc/ichigojs 0.1.1 → 0.1.3

package/dist/types/ichigo/VBindingsInit.d.ts

@@ -1,3 +1,4 @@
+import { VApplication } from "./VApplication";
 import { VBindings } from "./VBindings";
 /**
  * Initialization arguments for bindings.
@@ -12,4 +13,8 @@ export interface VBindingsInit {
      * @param identifier The identifier that changed.
      */
     onChange?: (identifier: string) => void;
+    /**
+     * The virtual application instance, if any.
+     */
+    vApplication?: VApplication;
 }

package/dist/types/ichigo/VNode.d.ts

@@ -84,6 +84,14 @@ export declare class VNode {
      */
     get dependentIdentifiers(): string[];
     get preparableIdentifiers(): string[];
+    /**
+     * The DOM path of this virtual node.
+     * This is a string representation of the path from the root to this node,
+     * using the node names and their indices among siblings with the same name.
+     * For example: "DIV[0]/SPAN[1]/#text[0]"
+     * @return The DOM path as a string.
+     */
+    get domPath(): string;
     /**
      * Updates the virtual node and its children based on the current bindings.
      * This method evaluates any expressions in text nodes and applies effectors from directives.
@@ -107,9 +115,11 @@ export declare class VNode {
     /**
      * Adds a dependent virtual node that relies on this node's bindings.
      * @param dependent The dependent virtual node to add.
+     * @param dependentIdentifiers The identifiers that the dependent node relies on.
+     * If not provided, the dependent node's own identifiers will be used.
      * @returns A list of closers to unregister the dependency, or undefined if no dependency was added.
      */
-    addDependent(dependent: VNode): VCloser[] | undefined;
+    addDependent(dependent: VNode, dependentIdentifiers?: string[] | undefined): VCloser[] | undefined;
     /**
      * Cleans up any resources used by this virtual node.
      * This method is called when the virtual node is no longer needed.

package/dist/types/ichigo/VNodeInit.d.ts

@@ -22,4 +22,9 @@ export interface VNodeInit {
      * This is optional and may be undefined if there are no bindings.
      */
     bindings?: VBindings;
+    /**
+     * The set of identifiers that this node depends on.
+     * This is optional and may be undefined if there are no dependent identifiers.
+     */
+    dependentIdentifiers?: string[];
 }

package/dist/types/ichigo/util/ReactiveProxy.d.ts

@@ -3,19 +3,20 @@
  */
 export declare class ReactiveProxy {
     /**
-     * A WeakMap to store the original target for each proxy.
-     * This allows us to avoid creating multiple proxies for the same object.
+     * A WeakMap to store the proxy for each target object and path combination.
+     * This prevents creating multiple proxies for the same object accessed from different paths.
      */
-    private static proxyMap;
+    private static proxyCache;
     /**
      * Creates a reactive proxy for the given object.
      * The proxy will call the onChange callback whenever a property is modified.
      *
      * @param target The object to make reactive.
-     * @param onChange Callback function to call when the object changes. Receives the changed key name.
+     * @param onChange Callback function to call when the object changes. Receives the full path of the changed property.
+     * @param path The current path in the object tree (used internally for nested objects).
      * @returns A reactive proxy of the target object.
      */
-    static create<T extends object>(target: T, onChange: (changedKey?: string) => void): T;
+    static create<T extends object>(target: T, onChange: (changedPath?: string) => void, path?: string): T;
     /**
      * Checks if the given object is a reactive proxy.
      *

package/dist/types/ichigo/util/VLogManager.d.ts

@@ -1,9 +1,24 @@
 import { VLogger } from "./VLogger";
 import { LogLevel } from "./LogLevel";
+/**
+ * Manages loggers and their log levels.
+ */
 export declare class VLogManager {
     #private;
     constructor(logLevel?: LogLevel);
+    /**
+     * Sets the log level for all loggers.
+     * @param level The log level to set.
+     */
     set logLevel(level: LogLevel);
+    /**
+     * Gets the current log level.
+     */
     get logLevel(): LogLevel;
+    /**
+     * Gets a logger by name, creating it if it doesn't exist.
+     * @param name The name of the logger.
+     * @returns The logger instance.
+     */
     getLogger(name: string): VLogger;
 }

package/dist/types/ichigo/util/VLogger.d.ts

@@ -1,9 +1,40 @@
 import { VLogManager } from "./VLogManager";
+/**
+ * A simple logger class for virtual applications.
+ */
 export declare class VLogger {
     #private;
     constructor(name: string, logManager: VLogManager);
+    /**
+     * Indicates whether the debug level is enabled.
+     */
+    get isDebugEnabled(): boolean;
+    /**
+     * Indicates whether the info level is enabled.
+     */
+    get isInfoEnabled(): boolean;
+    /**
+     * Indicates whether the warn level is enabled.
+     */
+    get isWarnEnabled(): boolean;
+    /**
+     * Logs a debug message.
+     * @param message The message to log.
+     */
     debug(message: string): void;
+    /**
+     * Logs an info message.
+     * @param message The message to log.
+     */
     info(message: string): void;
+    /**
+     * Logs a warn message.
+     * @param message The message to log.
+     */
     warn(message: string): void;
+    /**
+     * Logs an error message.
+     * @param message The message to log.
+     */
     error(message: string): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintjamsinc/ichigojs",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "ichigo.js - Simple and intuitive reactive framework. Lightweight, fast, and user-friendly virtual DOM library",
   "main": "./dist/ichigo.umd.js",
   "module": "./dist/ichigo.esm.js",
@@ -11,7 +11,7 @@
   "homepage": "https://github.com/mintjamsinc/ichigojs#readme",
   "repository": {
     "type": "git",
-    "url": "https://github.com/mintjamsinc/ichigojs.git"
+    "url": "git+https://github.com/mintjamsinc/ichigojs.git"
   },
   "bugs": {
     "url": "https://github.com/mintjamsinc/ichigojs/issues"