@mintjamsinc/ichigojs 0.1.21 → 0.1.23

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

@@ -2,8 +2,9 @@ import { VLogManager } from "./util/VLogManager";
 import { VApplicationOptions } from "./VApplicationOptions";
 import { VBindings } from "./VBindings";
 import { VNode } from "./VNode";
-import type { VDirectiveParserRegistry } from "./directives/VDirectiveParserRegistry";
+import { VDirectiveParserRegistry } from "./directives/VDirectiveParserRegistry";
 import { VComponentRegistry } from "./components/VComponentRegistry";
+import { VApplicationInit } from "./VApplicationInit";
 /**
  * Represents a virtual application instance.
  */
@@ -11,11 +12,13 @@ export declare class VApplication {
     #private;
     /**
      * Creates an instance of the virtual application.
-     * @param options The application options.
-     * @param directiveParserRegistry The global directive parser registry.
-     * @param componentRegistry The global component registry.
+     * @param args The initialization arguments for the application.
      */
-    constructor(options: VApplicationOptions, directiveParserRegistry: VDirectiveParserRegistry, componentRegistry: VComponentRegistry);
+    constructor(args: VApplicationInit);
+    /**
+     * Gets the parent application, if any.
+     */
+    get parentApplication(): VApplication | undefined;
     /**
      * Gets the global directive parser registry.
      */
@@ -55,4 +58,12 @@ export declare class VApplication {
      * @returns The created child application instance.
      */
     createChildApp(options: VApplicationOptions): VApplication;
+    /**
+     * Computes dependent identifiers for a given computed property and value.
+     * This is used to track dependencies in directives like v-for.
+     * @param computedName The name of the computed property.
+     * @param value The value to check for dependencies.
+     * @returns An array of dependent identifiers.
+     */
+    resolveDependentIdentifiers(computedName: string, value: any): string[];
 }

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

@@ -0,0 +1,25 @@
+import { VComponentRegistry } from "./components/VComponentRegistry";
+import { VDirectiveParserRegistry } from "./directives/VDirectiveParserRegistry";
+import { VApplication } from "./VApplication";
+import { VApplicationOptions } from "./VApplicationOptions";
+/**
+ * The interface for initializing a VApplication instance.
+ */
+export interface VApplicationInit {
+    /**
+     * The options for initializing the application.
+     */
+    options: VApplicationOptions;
+    /**
+     * The parent application, if any.
+     */
+    parentApplication?: VApplication;
+    /**
+     * The global directive parser registry.
+     */
+    directiveParserRegistry: VDirectiveParserRegistry;
+    /**
+     * The global component registry.
+     */
+    componentRegistry: VComponentRegistry;
+}

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

@@ -56,4 +56,11 @@ export declare class VBindings {
      * @param key The binding name.
      */
     remove(key: string): void;
+    /**
+     * Sets a binding value without triggering onChange callback.
+     * This is useful for internal updates that shouldn't trigger reactivity.
+     * @param key The binding name.
+     * @param value The binding value.
+     */
+    setSilent(key: string, value: any): void;
 }

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

@@ -7,6 +7,16 @@ export declare class ReactiveProxy {
      * This prevents creating multiple proxies for the same object accessed from different paths.
      */
     private static proxyCache;
+    /**
+     * A WeakMap to track which objects are proxies, mapping proxy -> original target.
+     * This prevents double-wrapping of already proxied objects.
+     */
+    private static proxyToTarget;
+    /**
+     * A WeakSet to track objects marked as "raw" (non-reactive).
+     * These objects will not be wrapped with Proxy.
+     */
+    private static rawObjects;
     /**
      * Creates a reactive proxy for the given object.
      * The proxy will call the onChange callback whenever a property is modified.
@@ -32,4 +42,23 @@ export declare class ReactiveProxy {
      * @returns The original object.
      */
     static unwrap<T>(obj: T): T;
+    /**
+     * Marks an object as "raw" (non-reactive).
+     * Objects marked as raw will not be wrapped with Proxy when accessed from reactive objects.
+     * This is useful for objects that should not be reactive, such as:
+     * - Objects with private fields (class instances with # fields)
+     * - Third-party library instances
+     * - Objects used only for method calls
+     *
+     * @param obj The object to mark as raw.
+     * @returns The same object (for chaining).
+     */
+    static markRaw<T extends object>(obj: T): T;
+    /**
+     * Checks if an object is marked as raw (non-reactive).
+     *
+     * @param obj The object to check.
+     * @returns True if the object is marked as raw, false otherwise.
+     */
+    static isRaw(obj: any): boolean;
 }

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
 export { VDOM } from './ichigo/VDOM';
 export { VComponent } from './ichigo/components/VComponent';
 export { VComponentRegistry } from './ichigo/components/VComponentRegistry';
+export { ReactiveProxy } from './ichigo/util/ReactiveProxy';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintjamsinc/ichigojs",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "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",