@mintjamsinc/ichigojs 0.1.9 → 0.1.11

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

@@ -42,7 +42,13 @@ export declare class VApplication {
     get functionDependencies(): Record<string, string[]>;
     /**
      * Mounts the application.
-     * @param selectors The CSS selectors to identify the root element.
+     * @param target The CSS selector string or HTMLElement to mount the application to.
      */
-    mount(selectors: string): void;
+    mount(target: string | HTMLElement): void;
+    /**
+     * Creates a child application instance with the same registries.
+     * @param options The application options for the child.
+     * @returns The created child application instance.
+     */
+    createChildApp(options: VApplicationOptions): VApplication;
 }

package/dist/types/ichigo/components/VComponent.d.ts

@@ -1,2 +1,25 @@
+/**
+ * Represents a reusable component definition.
+ */
 export declare class VComponent {
+    /**
+     * The unique identifier for the component.
+     */
+    readonly id: string;
+    /**
+     * The function that creates a new instance of the component.
+     */
+    readonly createInstance: (props?: any) => any;
+    /**
+     * The optional template ID for the component.
+     * If not specified, defaults to the component ID.
+     */
+    readonly templateID?: string;
+    /**
+     * Creates a new component definition.
+     * @param id The unique identifier for the component.
+     * @param createInstance The function that creates a new instance of the component.
+     * @param templateID The optional template ID for the component.
+     */
+    constructor(id: string, createInstance: (props?: any) => any, templateID?: string);
 }

package/dist/types/ichigo/components/VComponentRegistry.d.ts

@@ -1,2 +1,37 @@
+import { VComponent } from './VComponent';
+/**
+ * A registry for managing component definitions.
+ */
 export declare class VComponentRegistry {
+    #private;
+    /**
+     * Registers a new component.
+     * @param id The unique identifier for the component.
+     * @param createInstance The function that creates a new instance of the component.
+     * @param templateID The optional template ID for the component.
+     * @returns True if the component was registered, false if a component with the same ID already exists.
+     */
+    register(id: string, createInstance: (props?: any) => any, templateID?: string): boolean;
+    /**
+     * Checks if a component with the given ID exists.
+     * @param id The component ID to check.
+     * @returns True if the component exists, false otherwise.
+     */
+    has(id: string): boolean;
+    /**
+     * Gets a component by its ID.
+     * @param id The component ID to retrieve.
+     * @returns The component definition, or undefined if not found.
+     */
+    get(id: string): VComponent | undefined;
+    /**
+     * Removes a component from the registry.
+     * @param id The component ID to remove.
+     * @returns True if the component was removed, false if it didn't exist.
+     */
+    unregister(id: string): boolean;
+    /**
+     * Clears all registered components.
+     */
+    clear(): void;
 }

package/dist/types/ichigo/directives/StandardDirectiveName.d.ts

@@ -18,8 +18,12 @@ export declare enum StandardDirectiveName {
     V_BIND = "v-bind",
     /** Two-way data binding directives. */
     V_MODEL = "v-model",
-    /** Slot content insertion directives. */
+    /** Resize observer directives. */
     V_RESIZE = "v-resize",
     /** Intersection observer directives. */
-    V_INTERSECTION = "v-intersection"
+    V_INTERSECTION = "v-intersection",
+    /** Performance observer directives. */
+    V_PERFORMANCE = "v-performance",
+    /** Component directive. */
+    V_COMPONENT = "v-component"
 }

package/dist/types/ichigo/directives/VComponentDirective.d.ts

@@ -0,0 +1,81 @@
+import { VDirective } from './VDirective';
+import { VNode } from '../VNode';
+import { VDirectiveParseContext } from './VDirectiveParseContext';
+import { VBindingsPreparer } from '../VBindingsPreparer';
+import { VDOMUpdater } from '../VDOMUpdater';
+/**
+ * Directive for rendering components.
+ * Usage: <div v-component="componentId" :options="props"></div>
+ *
+ * The :options binding is used to pass properties to the component.
+ * Example:
+ *   <div v-component="my-component" :options="{message: 'Hello'}"></div>
+ */
+export declare class VComponentDirective implements VDirective {
+    #private;
+    constructor(context: VDirectiveParseContext);
+    /**
+     * @inheritdoc
+     */
+    get name(): string;
+    /**
+     * @inheritdoc
+     */
+    get vNode(): VNode;
+    /**
+     * @inheritdoc
+     */
+    get needsAnchor(): boolean;
+    /**
+     * @inheritdoc
+     */
+    get bindingsPreparer(): VBindingsPreparer | undefined;
+    /**
+     * @inheritdoc
+     */
+    get domUpdater(): VDOMUpdater | undefined;
+    /**
+     * @inheritdoc
+     */
+    get templatize(): boolean;
+    /**
+     * @inheritdoc
+     */
+    get dependentIdentifiers(): string[];
+    /**
+     * @inheritdoc
+     */
+    get onMount(): (() => void) | undefined;
+    /**
+     * @inheritdoc
+     */
+    get onMounted(): (() => void) | undefined;
+    /**
+     * @inheritdoc
+     */
+    get onUpdate(): (() => void) | undefined;
+    /**
+     * @inheritdoc
+     */
+    get onUpdated(): (() => void) | undefined;
+    /**
+     * @inheritdoc
+     */
+    get onUnmount(): (() => void) | undefined;
+    /**
+     * @inheritdoc
+     */
+    get onUnmounted(): (() => void) | undefined;
+    /**
+     * @inheritdoc
+     */
+    destroy(): void;
+    /**
+     * Renders the component.
+     */
+    private renderComponent;
+    /**
+     * Cleans up the component.
+     */
+    private cleanupComponent;
+}

package/dist/types/ichigo/directives/VPerformanceDirective.d.ts

@@ -4,41 +4,31 @@ import { VDirective } from "./VDirective";
 import { VDirectiveParseContext } from "./VDirectiveParseContext";
 import { VDOMUpdater } from "../VDOMUpdater";
 /**
- * Configuration options for the v-performance directive.
- */
-export interface VPerformanceOptions {
-    /**
-     * The type(s) of performance entries to observe.
-     * Can be a single type or an array of types.
-     * Common types: 'mark', 'measure', 'navigation', 'resource', 'paint', 'element', 'largest-contentful-paint', 'layout-shift'
-     */
-    entryTypes?: string | string[];
-    /**
-     * Whether to include buffered entries (entries that occurred before the observer was created).
-     * Default: false
-     */
-    buffered?: boolean;
-}
-/**
- * Directive for observing performance entries using PerformanceObserver.
- * The `v-performance` directive allows you to monitor various performance metrics.
+ * Directive for observing performance metrics using PerformanceObserver.
+ * The `v-performance` directive allows you to monitor various performance entries.
  *
  * Example usage:
  *     <div v-performance="handlePerformance">Performance monitoring</div>
- *     <div v-performance="{ handler: handlePerformance, options: { entryTypes: ['measure', 'mark'], buffered: true } }">
- *       Advanced monitoring
- *     </div>
+ *     <div v-performance="handlePerformance" :options.performance="{entryTypes: ['measure']}">Performance monitoring</div>
  *
- * The handler receives PerformanceObserverEntryList and PerformanceObserver as the first two arguments,
- * and $ctx as the third:
- *     handlePerformance(list, observer, $ctx) {
- *       list.getEntries().forEach(entry => {
- *         console.log(`${entry.entryType}: ${entry.name} - ${entry.duration}ms`);
+ * By default (without options), it observes 'mark' and 'measure' entry types.
+ *
+ * The handler receives PerformanceObserverEntryList, PerformanceObserver, options (with droppedEntriesCount), and $ctx as arguments:
+ *     handlePerformance(entries, observer, options, $ctx) {
+ *       entries.getEntries().forEach(entry => {
+ *         console.log(`${entry.name}: ${entry.duration}ms`);
  *       });
+ *       if (options?.droppedEntriesCount) {
+ *         console.log(`Dropped entries: ${options.droppedEntriesCount}`);
+ *       }
  *     }
  *
- * This directive is useful for monitoring application performance, custom metrics,
- * and identifying performance bottlenecks.
+ * Options can be provided via :options or :options.performance attribute:
+ *     :options="{entryTypes: ['measure', 'mark']}"
+ *     :options.performance="{type: 'navigation', buffered: true}"
+ *
+ * This directive is useful for performance monitoring, profiling, and identifying
+ * performance bottlenecks in your application.
  */
 export declare class VPerformanceDirective implements VDirective {
     #private;

package/dist/types/index.d.ts

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

package/package.json

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