@mintjamsinc/ichigojs 0.1.65 → 0.1.67

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

@@ -39,6 +39,13 @@ export interface VApplicationOptions {
      * and the value is either a callback function or an options object with handler, deep, and immediate properties.
      */
     watch?: WatcherDictionary;
+    /**
+     * Optional list of event names this application/component is expected to emit via `$emit`.
+     * When declared, emitting an event whose name is not in this list logs a development warning.
+     * When omitted, `$emit` accepts any event name without warning. This is documentation/validation
+     * only and never blocks dispatch.
+     */
+    emits?: string[];
     /**
      * The log level for the application.
      * This property determines the verbosity of logging output.

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

@@ -0,0 +1,27 @@
+/**
+ * Options for `$emit`, controlling how the underlying CustomEvent is dispatched.
+ */
+export interface VEmitOptions {
+    /**
+     * Whether the event bubbles up through the DOM. Default is true.
+     * Bubbling lets a parent component listen with `v-on` / `@` on the component tag,
+     * because the application root is dispatched from inside the host custom element.
+     */
+    bubbles?: boolean;
+    /**
+     * Whether the event is cancelable (i.e. `preventDefault()` has an effect).
+     * Default is true. `$emit` returns false when a listener called `preventDefault()`.
+     */
+    cancelable?: boolean;
+    /**
+     * Whether the event propagates across shadow DOM boundaries. Default is false.
+     * ichigo.js components use Light DOM, so this is rarely needed.
+     */
+    composed?: boolean;
+    /**
+     * The target the event is dispatched on. Defaults to the application root element.
+     * Set this to `document` or `window` to use a global event bus, or to a specific
+     * element for element-scoped dispatch.
+     */
+    target?: EventTarget;
+}

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

@@ -18,6 +18,15 @@ import { VDOMUpdater } from "../VDOMUpdater";
  * Mouse button modifiers (MouseEvent): `.left`, `.middle`, `.right`.
  * System modifiers (KeyboardEvent and MouseEvent): `.shift`, `.ctrl`, `.alt`, `.meta`, plus `.exact` to require that no other system modifiers are held.
  *
+ * Listen target and filter modifiers (two orthogonal axes):
+ *   - Listen target (where the listener is attached): `.window`, `.document`. When omitted the listener
+ *     is attached to the bound element. This is useful for global / cross-component events, e.g.
+ *     `@webtop-message.document="onMessage"`, and the listener is removed automatically on unmount.
+ *   - Filter (whether the handler runs): `.self` fires only when `event.target` is the bound element;
+ *     `.outside` fires only when `event.target` is outside the bound element (e.g. click-outside to
+ *     close a popup). `.outside` implies listening on `document` (capture phase) even without `.document`,
+ *     and `.self` / `.outside` are mutually exclusive.
+ *
  * Additionally, this directive supports lifecycle hooks:
  *     @mount="onMount"       - Called before the VNode is mounted to the DOM element
  *     @mounted="onMounted"   - Called after the VNode is mounted to the DOM element

package/dist/types/index.d.ts

@@ -6,3 +6,4 @@ 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';
+export type { VEmitOptions } from './ichigo/VEmitOptions';

package/package.json

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