@mintjamsinc/ichigojs 0.1.59 → 0.1.61

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

@@ -1,5 +1,13 @@
 import { LogLevel } from "./util/LogLevel";
 import { WatcherDictionary } from "./VWatcherOptions";
+/**
+ * Definition of a computed property. Either a getter function, or an object exposing both
+ * a getter and a setter (writable computed).
+ */
+export type VComputedDefinition = (() => unknown) | {
+    get: () => unknown;
+    set: (value: any) => void;
+};
 export interface VApplicationOptions {
     /**
      * A function that returns the initial data for the application.
@@ -8,10 +16,15 @@ export interface VApplicationOptions {
     data: () => unknown;
     /**
      * A dictionary of computed properties for the application.
-     * Each key is the name of the computed property, and the value is a function that computes its value.
+     * Each key is the name of the computed property, and the value is either:
+     *  - a getter function that computes its value (read-only computed), or
+     *  - an object `{ get, set }` that exposes both a getter and a setter (writable computed).
+     *
+     * Writable computed properties allow expressions like `v-model="myComputed"` to assign through
+     * the `set` function, while reads still go through `get`.
      */
     computed?: {
-        [key: string]: () => unknown;
+        [key: string]: VComputedDefinition;
     };
     /**
      * A dictionary of methods for the application.

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

@@ -63,6 +63,14 @@ export declare class VBindings {
      * @param value The binding value.
      */
     setSilent(key: string, value: any): void;
+    /**
+     * Registers a setter for a writable computed property. When the given key is assigned
+     * through the bindings proxy, the setter will be invoked instead of writing directly to
+     * the local store.
+     * @param key The computed property name.
+     * @param setter The setter function to invoke on assignment.
+     */
+    registerWritableComputed(key: string, setter: (value: any) => void): void;
     /**
      * Manually adds an identifier to the set of changed identifiers.
      * This is useful for computed properties that need to mark themselves as changed

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

@@ -29,5 +29,7 @@ export declare enum StandardDirectiveName {
     /** Raw HTML content directive. */
     V_HTML = "v-html",
     /** Text content directive. */
-    V_TEXT = "v-text"
+    V_TEXT = "v-text",
+    /** Focus management directive. */
+    V_FOCUS = "v-focus"
 }

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

@@ -0,0 +1,87 @@
+import { VNode } from "../VNode";
+import { VBindingsPreparer } from "../VBindingsPreparer";
+import { VDirective } from "./VDirective";
+import { VDirectiveParseContext } from "./VDirectiveParseContext";
+import { VDOMUpdater } from "../VDOMUpdater";
+/**
+ * Directive for managing focus on form elements.
+ *
+ * Usage:
+ *     <input v-focus>                           Focus once on mount.
+ *     <input v-focus.select>                    Focus + select all on mount.
+ *     <input v-focus="isOpen">                  Focus when expression transitions from falsy to truthy.
+ *     <input v-focus.select="isOpen">           Conditional focus + select all.
+ *     <input v-focus.cursor-end="isOpen">       Conditional focus + place caret at end.
+ *
+ * Behavior notes:
+ * - Without an expression, the element is focused exactly once after mount.
+ * - With an expression, focus fires only on the falsy -> truthy edge,
+ *   so the user is not repeatedly re-focused on every reactive update.
+ * - If the value is already truthy on mount, the element is focused.
+ * - Focus is deferred via requestAnimationFrame so that elements which
+ *   become visible just before this directive runs (e.g. inside v-if /
+ *   display:none containers) can still receive focus reliably.
+ */
+export declare class VFocusDirective implements VDirective {
+    #private;
+    /**
+     * @param context The context for parsing the directive.
+     */
+    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;
+}

package/package.json

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