@mintjamsinc/ichigojs 0.1.53 → 0.1.55

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

@@ -11,6 +11,7 @@ export declare class VDOM {
     /**
      * Gets the component registry.
      * @return {VComponentRegistry} The component registry.
+     * @deprecated This method is deprecated and will be removed in a future release. Please use the new component registration system instead.
      */
     static get componentRegistry(): VComponentRegistry;
     /**

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

@@ -0,0 +1,19 @@
+import { VApplicationOptions } from '../VApplicationOptions';
+/**
+ * Options for defining a Web Component backed by ichigo.js reactivity.
+ * Extends VApplicationOptions with component-specific settings.
+ */
+export interface IchigoComponentOptions extends VApplicationOptions {
+    /**
+     * List of property names to receive from the parent via attribute/property binding.
+     * Each name in this list will be exposed as a property setter on the custom element.
+     * When the parent updates a bound value (e.g., :items="items"), the component's
+     * reactive bindings are updated automatically.
+     */
+    props?: string[];
+    /**
+     * CSS selector for the <template> element that defines this component's markup.
+     * Example: '#my-card' targets <template id="my-card">.
+     */
+    template: string;
+}

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

@@ -0,0 +1,43 @@
+import { VApplicationOptions } from '../VApplicationOptions';
+/**
+ * Base class for ichigo.js-backed Web Components (Light DOM, no Shadow DOM).
+ *
+ * Mount timing:
+ *  - If the component declares no props, the VApplication is mounted synchronously
+ *    at the end of connectedCallback (the template is known, no props to wait for).
+ *  - If the component declares props, the VApplication is mounted the first time
+ *    _setProp() is called after connectedCallback has prepared the DOM. This
+ *    guarantees that the parent framework (e.g. ichigo.js VBindDirective) has
+ *    already delivered at least one prop value before data() is evaluated.
+ *
+ * Subclasses must set the static fields _template, _props and _buildOptions before
+ * calling customElements.define(). defineComponent() handles this automatically.
+ */
+export declare class IchigoElement extends HTMLElement {
+    #private;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Called by the property setters generated by defineComponent().
+     * Before mount: stores the value and schedules a mount microtask.
+     * After mount: pushes the value directly into the reactive bindings.
+     */
+    _setProp(name: string, value: any): void;
+    /**
+     * Called by the property getters generated by defineComponent().
+     */
+    _getProp(name: string): any;
+    /**
+     * CSS selector for the component's <template> element (e.g. '#my-card').
+     */
+    static _template: string;
+    /**
+     * List of declared prop names. Used to decide whether to defer mounting.
+     */
+    static _props: string[];
+    /**
+     * Factory that builds VApplicationOptions from the current prop values.
+     * Implemented by defineComponent() as a closure that captures the user's options.
+     */
+    static _buildOptions: (propValues: Record<string, any>) => VApplicationOptions;
+}

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

@@ -1,5 +1,6 @@
 /**
  * Represents a reusable component definition.
+ * @deprecated This class is deprecated and will be removed in a future release. Please use the new component registration system instead.
  */
 export declare class VComponent {
     /**

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

@@ -1,6 +1,7 @@
 import { VComponent } from './VComponent';
 /**
  * A registry for managing component definitions.
+ * @deprecated This class is deprecated and will be removed in a future release. Please use the new component registration system instead.
  */
 export declare class VComponentRegistry {
     #private;

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

@@ -0,0 +1,34 @@
+import { IchigoComponentOptions } from './IchigoComponentOptions';
+/**
+ * Defines and registers a custom element backed by ichigo.js reactivity.
+ *
+ * Usage:
+ * ```html
+ * <template id="my-list">
+ *   <div>
+ *     <ul v-if="items.length > 0">
+ *       <li v-for="item of items">{{item.name}}</li>
+ *     </ul>
+ *     <slot></slot>
+ *   </div>
+ * </template>
+ * ```
+ * ```typescript
+ * defineComponent('my-list', {
+ *   template: '#my-list',
+ *   props: ['items'],
+ *   data() {
+ *     return { items: this.items ?? [] };
+ *   },
+ * });
+ * ```
+ * ```html
+ * <my-list :items="searchResults">
+ *   <span slot="empty">No results.</span>
+ * </my-list>
+ * ```
+ *
+ * @param tagName  Custom element tag name (must contain a hyphen, e.g. 'my-card').
+ * @param options  Component options including template selector and optional props.
+ */
+export declare function defineComponent(tagName: string, options: IchigoComponentOptions): void;

package/dist/types/index.d.ts

@@ -3,3 +3,6 @@ export { VComponent } from './ichigo/components/VComponent';
 export { VComponentRegistry } from './ichigo/components/VComponentRegistry';
 export { ReactiveProxy } from './ichigo/util/ReactiveProxy';
 export { ExpressionUtils } from './ichigo/util/ExpressionUtils';
+export { defineComponent } from './ichigo/components/defineComponent';
+export type { IchigoComponentOptions } from './ichigo/components/IchigoComponentOptions';
+export { IchigoElement } from './ichigo/components/IchigoElement';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintjamsinc/ichigojs",
-  "version": "0.1.53",
+  "version": "0.1.55",
   "description": "ichigo.js - Simple and intuitive reactive framework. Lightweight, fast, and user-friendly virtual DOM library",
   "main": "./dist/ichigo.cjs",
   "module": "./dist/ichigo.esm.js",