@neeloong/form 0.8.0 → 0.9.0

package/README.md

@@ -144,7 +144,7 @@ render(store, layouts, app);
 
 ### 别名与计算值
 
-```
+```html
 <div *alias1="v1" *computed="v1 + v2"></div>
 ```
 
@@ -155,6 +155,11 @@ render(store, layouts, app);
 <div +var1="123"></div>
 ```
 
+### 增强
+```html
+<div ~en:attr="a" ~en@event="show($event)" ~en!bind="bindValue" ~en="value"></div>
+
+```
 
 ### 各用法的优先级
 

package/index.d.mts

@@ -1,5 +1,5 @@
 /*!
-* @neeloong/form v0.8.0
+* @neeloong/form v0.9.0
 * (c) 2024-2025 Fierflame
 * @license Apache-2.0
 */
@@ -23,59 +23,88 @@ declare function parse(source: string, { createCalc, createEvent, simpleTag, }?:
  */
 declare function toString(value: Node | (Node | string)[], formable?: boolean): string;
 
-type Directives = {
+type Directives = object;
+type Enhancement$1 = {
+    events: Record<string, Node.Name | Node.Event>;
+    attrs: Record<string, Node.Name | Node.Calc | Node.Value>;
+    value?: Node.Name | Node.Calc | Node.Value<any> | undefined;
+    bind?: string | boolean | undefined;
+};
+type Options = {
+    createCalc?: ((t: string) => Calc) | undefined;
+    createEvent?: ((t: string) => EventListener) | undefined;
+    simpleTag?: Set<string> | undefined;
+};
+type Node = {
+    name: string;
+    is?: string | null | undefined;
+    id?: string | undefined;
+    attrs: Record<string, Node.Name | Node.Calc | Node.Value>;
+    params: Record<string, Node.Name | Node.Calc | Node.Value>;
+    classes: Record<string, Node.Name | Node.Calc | Node.Value>;
+    styles: Record<string, Node.Name | Node.Calc | Node.Value>;
+    events: Record<string, Node.Name | Node.Event>;
+    vars: Record<string, Node.Name | Node.Calc | Node.Value>;
+    aliases: Record<string, Node.Name | Node.Calc | Node.Value>;
+    enhancements: Record<string, Enhancement$1>;
     template?: string | undefined;
     fragment?: string | boolean | undefined;
-    if?: string | Calc | undefined;
+    if?: Node.Name | Node.Calc | Node.Value<any> | undefined;
     else?: boolean | undefined;
     /**
-     * 值关联（关联为列表）
+     * 值关联
      */
     value?: string | undefined;
     /**
      * 列表属性枚举
      */
-    enum?: string | boolean | Calc | undefined;
+    enum?: Node.Name | Node.Calc | Node.Value<any> | undefined;
     bind?: string | boolean | undefined;
-    text?: string | Calc | undefined;
-    html?: string | Calc | undefined;
+    text?: Node.Name | Node.Calc | Node.Value<any> | undefined;
+    html?: Node.Name | Node.Calc | Node.Value<any> | undefined;
     /**
      * 注释
      */
     comment?: string | undefined;
-};
-type Options = {
-    createCalc?: ((t: string) => Calc) | undefined;
-    createEvent?: ((t: string) => EventListener) | undefined;
-    simpleTag?: Set<string> | undefined;
-};
-type Node = {
-    name: string;
-    is?: string | null | undefined;
-    id?: string | undefined;
-    attrs: Record<string, string | {
-        name: string;
-    } | Calc>;
-    params: Record<string, string | Calc>;
-    classes: Record<string, string | boolean | Calc>;
-    styles: Record<string, string | Calc>;
-    events: Record<string, string | EventListener>;
-    vars: Record<string, string | Calc>;
-    aliases: Record<string, string | Calc>;
-    directives: Directives;
     children: (Node | string)[];
 };
+declare namespace Node {
+    type Value<T = any> = {
+        value: T;
+        name?: undefined;
+        calc?: undefined;
+        event?: undefined;
+    };
+    type Name = {
+        name: string;
+        value?: undefined;
+        calc?: undefined;
+        event?: undefined;
+    };
+    type Event = {
+        event: EventListener;
+        name?: undefined;
+        calc?: undefined;
+        value?: undefined;
+    };
+    type Calc = {
+        calc: Calc;
+        name?: undefined;
+        value?: undefined;
+        event?: undefined;
+    };
+}
 type Calc = (env: Record<string, any>) => any;
 type EventListener = ($event: any, env: Record<string, any>) => void;
 
 type index_d_Calc = Calc;
 type index_d_Directives = Directives;
 type index_d_EventListener = EventListener;
-type index_d_Node = Node;
+declare const index_d_Node: typeof Node;
 type index_d_Options = Options;
 declare const index_d_parse: typeof parse;
 declare namespace index_d {
-  export { type index_d_Calc as Calc, type index_d_Directives as Directives, type index_d_EventListener as EventListener, type index_d_Node as Node, type index_d_Options as Options, index_d_parse as parse, toString as stringify };
+  export { type index_d_Calc as Calc, type index_d_Directives as Directives, type Enhancement$1 as Enhancement, type index_d_EventListener as EventListener, index_d_Node as Node, type index_d_Options as Options, index_d_parse as parse, toString as stringify };
 }
 
 type VerifyError = any;
@@ -108,7 +137,7 @@ declare namespace Component {
         events: [string, ($event: any) => void, AddEventListenerOptions][];
         tagAttrs: Record<string, any>;
         watchAttr: (name: any, fn: (value: any, old: any, name: string) => void) => () => void;
-        relate: (el: Element) => () => void;
+        relate: (el: Element | Relatedness) => () => void;
         destroyed: boolean;
         init: boolean;
         listen: <K extends keyof Component.Context.Events>(event: K, listener: (...p: Component.Context.Events[K]) => void) => () => void;
@@ -226,6 +255,26 @@ declare namespace Schema {
 }
 type Validator = (store: Store) => string | string[] | void | null;
 type AsyncValidator = (store: Store, signal: AbortSignal) => PromiseLike<string | string[] | void | null> | string | string[] | void | null;
+type Relatedness = {
+    focus?: (() => void) | undefined;
+    scrollIntoView?: (() => void) | undefined;
+    input?: Element | undefined;
+    root?: Element | undefined;
+};
+type Enhancement = (context: Enhancement.Context) => any;
+declare namespace Enhancement {
+    type Context = {
+        events: [string, ($event: any) => void, AddEventListenerOptions][];
+        attrs: Record<string, any>;
+        watchAttr: (name: any, fn: (value: any, old: any, name: string) => void) => () => void;
+        destroyed: boolean;
+        listen: (event: "destroy", listener: () => void) => () => void;
+        tag: any;
+        root: Element;
+        slot?: Element | null | undefined;
+        value: any;
+    };
+}
 
 declare const ref: unique symbol;
 type Ref = {
@@ -466,10 +515,11 @@ declare class Store<T = any> {
  * @param {object} [options]
  * @param {Record<string, Store | {get?(): any; set?(v: any): void; exec?(...p: any[]): any; calc?(...p: any[]): any }>} [options.global]
  * @param {(path: string[]) => Component?} [options.component]
- * @param {(store: Store, el: Element) => () => void} [options.relate]
+ * @param {(store: Store, el: Element | Relatedness) => () => void} [options.relate]
+ * @param {Record<string, Enhancement>} [options.enhancements]
  * @returns {() => void}
  */
-declare function _default(store: Store, layouts: (Node | string)[], parent: Element, { component, global, relate }?: {
+declare function _default(store: Store, layouts: (Node | string)[], parent: Element, { component, global, relate, enhancements }?: {
     global?: Record<string, Store<any> | {
         get?(): any;
         set?(v: any): void;
@@ -477,7 +527,8 @@ declare function _default(store: Store, layouts: (Node | string)[], parent: Elem
         calc?(...p: any[]): any;
     }> | undefined;
     component?: ((path: string[]) => Component | null) | undefined;
-    relate?: ((store: Store, el: Element) => () => void) | undefined;
+    relate?: ((store: Store, el: Element | Relatedness) => () => void) | undefined;
+    enhancements?: Record<string, Enhancement> | undefined;
 }): () => void;
 
 /**
@@ -497,4 +548,4 @@ declare function watch<T>(getter: () => T, callback: (value: T) => void, immedia
  */
 declare function effect(fn: () => void): () => void;
 
-export { type AsyncValidator, Component, index_d as Layout, type Ref, Schema, Store, type Validator, type VerifyError, effect, _default as render, watch };
+export { type AsyncValidator, Component, Enhancement, index_d as Layout, type Ref, type Relatedness, Schema, Store, type Validator, type VerifyError, effect, _default as render, watch };