From 4fce12340774cfb076d06bc194efc32d3d28e878 Mon Sep 17 00:00:00 2001
From: chenbenzhi <chenbenzhi@huawei.com>
Date: Wed, 18 Jun 2025 22:10:04 +0800
Subject: [PATCH] add decorator.d.ets

Signed-off-by: chenbenzhi <chenbenzhi@huawei.com>
---
 api/arkui/stateManagement/decorator.d.ets | 778 ++++++++++++++++++++--
 1 file changed, 720 insertions(+), 58 deletions(-)

diff --git a/api/arkui/stateManagement/decorator.d.ets b/api/arkui/stateManagement/decorator.d.ets
index a626dc9e89..4ecd2da559 100644
--- a/api/arkui/stateManagement/decorator.d.ets
+++ b/api/arkui/stateManagement/decorator.d.ets
@@ -77,121 +77,783 @@ export declare @interface Watch {
 @Retention({policy: "SOURCE"})
 export declare @interface Require {};
 
+
+/**
+ * Define decorated variable interface.
+ *
+ * @interface IDecoratedVariable
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
 export declare interface IDecoratedVariable {
-    readonly varName: string;
+  /**
+   * Decorated variable name.
+   *
+   * @type { string }
+   * @readonly
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  readonly varName: string;
 }
 
+/**
+ * Define V1 decorated variable interface.
+ *
+ * @extends IDecoratedVariable
+ * @interface IDecoratedVariable
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
 export declare interface IDecoratedV1Variable<T> extends IDecoratedVariable {
-    registerWatchToSource(me: IDecoratedV1Variable<T>): void;
+  /**
+   * Registers the watch callback function with the data source.
+   *
+   * @param { IDecoratedV1Variable<T> } decoratedVar
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  registerWatchToSource(decoratedVar: IDecoratedV1Variable<T>): void;
 }
 
+/**
+ * Define decorated immutable variable interface.
+ *
+ * @interface IDecoratedImmutableVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
 export declare interface IDecoratedImmutableVariable<T> {
-    get(): T;
+  /**
+   * Get the state variable.
+   *
+   * @returns { T }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  get(): T;
 }
 
+/**
+ * Define decorated mutable variable interface.
+ *
+ * @interface IDecoratedMutableVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
 export declare interface IDecoratedMutableVariable<T> {
-    get(): T;
-    set(newValue: T): void;
+  /**
+   * Get the state variable.
+   *
+   * @returns { T }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  get(): T;
+  /**
+   * Set the state variable with a new Value.
+   *
+   * @param { T } newValue
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  set(newValue: T): void;
 }
 
+/**
+ * Define decorated updatable variable interface.
+ *
+ * @interface IDecoratedUpdatableVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
 export declare interface IDecoratedUpdatableVariable<T> {
-    update(newValue: T): void;
+  /**
+   * Update the state variable with a new Value.
+   *
+   * @param { T } newValue
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  update(newValue: T): void;
 }
 
-export declare interface IStateDecoratedVariable<T> extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T> {
-}
+/**
+ * Define state decoration variable interface.
+ *
+ * @extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T>
+ * @interface IStateDecoratedVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IStateDecoratedVariable<T> extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T> {}
 
-export declare interface IPropDecoratedVariable<T> extends IDecoratedMutableVariable<T>,
-    IDecoratedUpdatableVariable<T>, IDecoratedV1Variable<T> {
-}
+/**
+ * Define PropRef decoration variable interface.
+ *
+ * @extends IDecoratedMutableVariable<T>, IDecoratedUpdatableVariable<T>, IDecoratedV1Variable<T>
+ * @interface IPropRefDecoratedVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IPropRefDecoratedVariable<T> extends IDecoratedMutableVariable<T>,
+    IDecoratedUpdatableVariable<T>, IDecoratedV1Variable<T> {}
 
-export declare interface ILinkDecoratedVariable<T> extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T> {
-}
+/**
+ * Define Link decoration variable interface.
+ *
+ * @extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T>
+ * @interface ILinkDecoratedVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface ILinkDecoratedVariable<T> extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T> {}
 
-export declare interface IProvideDecoratedVariable<T> extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T> {
-}
+/**
+ * Define Provide decoration variable interface.
+ *
+ * @extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T>
+ * @interface IProvideDecoratedVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IProvideDecoratedVariable<T> extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T> {}
 
-export declare interface IConsumeDecoratedVariable<T> extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T> {
-}
+/**
+ * Define Consume decoration variable interface.
+ *
+ * @extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T>
+ * @interface IConsumeDecoratedVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IConsumeDecoratedVariable<T> extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T> {}
 
+/**
+ * Define ObjectLink decoration variable interface.
+ *
+ * @extends IDecoratedImmutableVariable<T>, IDecoratedUpdatableVariable<T>, IDecoratedV1Variable<T>
+ * @interface IObjectLinkDecoratedVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
 export declare interface IObjectLinkDecoratedVariable<T> extends IDecoratedImmutableVariable<T>,
-    IDecoratedUpdatableVariable<T>, IDecoratedV1Variable<T> {
-}
+    IDecoratedUpdatableVariable<T>, IDecoratedV1Variable<T> {}
 
-export declare interface IStorageLinkDecoratedVariable<T> extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T> {
-}
+/**
+ * Define StorageLink decoration variable interface.
+ *
+ * @extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T>
+ * @interface IStorageLinkDecoratedVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IStorageLinkDecoratedVariable<T> extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T> {}
 
-export declare interface IStoragePropDecoratedVariable<T> extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T> {
-}
+/**
+ * Define StoragePropRef decoration variable interface.
+ *
+ * @extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T>
+ * @interface IStoragePropRefDecoratedVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IStoragePropRefDecoratedVariable<T> extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T> {}
 
-export type LinkSourceType<T> = IDecoratedV1Variable<T>;
+/**
+ * Define LocalStoragePropRef decoration variable interface.
+ *
+ * @extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T>
+ * @interface ILocalStoragePropRefDecoratedVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface ILocalStoragePropRefDecoratedVariable<T> extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T> {}
+
+/**
+ * Define LocalStorageLink decoration variable interface.
+ *
+ * @extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T>
+ * @interface ILocalStorageLinkDecoratedVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface ILocalStorageLinkDecoratedVariable<T> extends IDecoratedMutableVariable<T>, IDecoratedV1Variable<T> {}
+
+/**
+ * Define Link source type.
+ *
+ * @typedef { IDecoratedV1Variable<T> } LinkSourceType<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export type LinkSourceType<T> = IStateDecoratedVariable<T> | ILinkDecoratedVariable<T> | IObjectLinkDecoratedVariable<T> | 
+  IPropRefDecoratedVariable<T> | IStorageLinkDecoratedVariable<T> | ILocalStorageLinkDecoratedVariable<T>
+  IStoragePropRefDecoratedVariable<T> | ILocalStoragePropRefDecoratedVariable<T> |
+  IProvideDecoratedVariable<T> | IConsumeDecoratedVariable<T>;
+
+/**
+ * Define Local decoration variable interface.
+ *
+ * @extends IDecoratedMutableVariable<T>, IDecoratedV2Variable
+ * @interface ILocalDecoratedVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface ILocalDecoratedVariable<T> extends IDecoratedMutableVariable<T>, IDecoratedV2Variable {}
 
+/**
+ * Define mutable state meta interface.
+ *
+ * @interface IMutableStateMeta
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
 export declare interface IMutableStateMeta {
-    addRef(): void;
-    fireChange(): void;
+  /**
+   * Collect the dependancy for UI component with state variable
+   *
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  addRef(): void;
+  /**
+   * Notify UI component to update when state variable is changed
+   *
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  fireChange(): void;
 }
 
+/**
+ * Define V2 decorated variable interface.
+ *
+ * @extends IDecoratedVariable
+ * @interface IDecoratedV2Variable
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export interface IDecoratedV2Variable extends IDecoratedVariable {}
+
+/**
+ * Define mutable state meta interface with key.
+ *
+ * @interface IMutableKeyedStateMeta
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
 export declare interface IMutableKeyedStateMeta {
-    addRef(key: string): void;
-    addRef(index: int): void;
-    fireChange(key: string): void;
-    fireChange(index: int): void;
+  /**
+   * Collect the dependancy for UI component with state variable based on given key
+   *
+   * @param { string } key
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  addRef(key: string): void;
+  /**
+   * Collect the dependancy for UI component with state variable based on given key
+   *
+   * @param { int } index
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  addRef(index: int): void;
+  /**
+   * Notify UI component with given key to update when state variable is changed
+   *
+   * @param { string } key
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  fireChange(key: string): void;
+  /**
+   * Notify UI component with given key to update when state variable is changed
+   *
+   * @param { int } index
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  fireChange(index: int): void;
 }
 
+/**
+ * Define Param decoration variable interface.
+ *
+ * @extends IDecoratedImmutableVariable<T>,  IDecoratedUpdatableVariable<T>, IDecoratedV2Variable
+ * @interface IParamV2DecoratedVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IParamV2DecoratedVariable<T> extends IDecoratedImmutableVariable<T>, IDecoratedUpdatableVariable<T>, IDecoratedV2Variable {}
+
+/**
+ * Define IObserve interface.
+ *
+ * @interface IObserve
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
 export declare interface IObserve {
-    readonly renderingComponent: number;
-    readonly renderingId: RenderIdType;
-    shouldAddRef(iObjectsRenderId: RenderIdType): boolean;
+  /**
+   * Rendering component.
+   *
+   * @type { number }
+   * @readonly
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  readonly renderingComponent: number;
+  /**
+   * Rendering component id.
+   *
+   * @type { RenderIdType }
+   * @readonly
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  readonly renderingId: RenderIdType;
+  /**
+   * Collect the dependancy for UI component with state variable
+   *
+   * @param { RenderIdType } iObjectsRenderId
+   * @returns { boolean }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  shouldAddRef(iObjectsRenderId: RenderIdType): boolean;
 }
 
+/**
+ * Define Param Once decoration variable interface.
+ *
+ * @extends IDecoratedMutableVariable<T>, IDecoratedV2Variable
+ * @interface IParamOnceV2DecoratedVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IParamOnceV2DecoratedVariable<T> extends IDecoratedMutableVariable<T>, IDecoratedV2Variable {}
+
+/**
+ * Define OBSERVED.
+ *
+ * @type { IObserve }
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
 export declare const OBSERVE: IObserve;
 
+/**
+ * Define Provider decoration variable interface.
+ *
+ * @extends IDecoratedMutableVariable<T>, IDecoratedV2Variable
+ * @interface IProviderDecoratedVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IProviderDecoratedVariable<T>  extends IDecoratedMutableVariable<T>, IDecoratedV2Variable {}
+
+/**
+ * Define int alias.
+ *
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
 export type RenderIdType = int;
 
+/**
+ * Define Consumer decoration variable interface.
+ *
+ * @extends IDecoratedMutableVariable<T>, IDecoratedV2Variable
+ * @interface IConsumerDecoratedVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IConsumerDecoratedVariable<T> extends IDecoratedMutableVariable<T>, IDecoratedV2Variable {}
+
+/**
+ * Define IObservedObject interface.
+ *
+ * @extends IWatchSubscriberRegister
+ * @interface IObservedObject
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
 export declare interface IObservedObject extends IWatchSubscriberRegister {
-    setV1RenderId(renderId: RenderIdType): void;
+  /**
+   * Set V1 renderId
+   *
+   * @param { RenderIdType } renderId
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  setV1RenderId(renderId: RenderIdType): void;
 }
 
+/**
+ * Define STATE_MGMT_FACTORY.
+ *
+ * @type { IStateMgmtFactory }
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
 export declare const STATE_MGMT_FACTORY: IStateMgmtFactory;
 
+/**
+ * Define IStateMgmtFactory interface.
+ *
+ * @interface IStateMgmtFactory
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
 export declare interface IStateMgmtFactory {
-    makeMutableStateMeta(): IMutableStateMeta;
-    makeSubscribedWatches(): ISubscribedWatches;
-    makeState<T>(owningView: ExtendableComponent, varName: string, initValue: T,
-        watchFunc?: WatchFuncType): IStateDecoratedVariable<T>;
-    makeProp<T>(owningView: ExtendableComponent, varName: string, initValue: T,
-        watchFunc?: WatchFuncType): IPropDecoratedVariable<T>;
-    makeLink<T>(owningView: ExtendableComponent, varName: string, source: LinkSourceType<T>,
-        watchFunc?: WatchFuncType): ILinkDecoratedVariable<T>;
-    makeProvide<T>(owningView: ExtendableComponent, varName: string, provideAlias: string,
-        initValue: T, allowOverride: boolean, wathcFunc?: WatchFuncType): IProvideDecoratedVariable<T>;
-    makeConsume<T>(owningView: ExtendableComponent, varName: string,
-        provideAlias: string, watchFunc?: WatchFuncType): IConsumeDecoratedVariable<T>;
-    makeObjectLink<T>(owningView: ExtendableComponent, varName: string,
-        initValue: T, wathcFunc?: WatchFuncType): IObjectLinkDecoratedVariable<T>;
-    makeStorageLink<T>(owningView: ExtendableComponent, propName: string,
-        varName: string, initValue: T, watchFunc?: WatchFuncType): IStorageLinkDecoratedVariable<T>;
-    makeStorageProp<T>(owningView: ExtendableComponent, propName: string,
-        varName: string, initValue: T, watchFunc?: WatchFuncType): IStoragePropDecoratedVariable<T>;
+  /**
+   * get mutable state meta
+   *
+   * @returns { IMutableStateMeta }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeMutableStateMeta(): IMutableStateMeta;
+  /**
+   * get subscribed watches
+   *
+   * @returns { ISubscribedWatches }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeSubscribedWatches(): ISubscribedWatches;
+  /**
+   * Create a State variable instance.
+   *
+   * @param { ExtendableComponent } owningView - custom component.
+   * @param { string } varName - state variable name.
+   * @param { T } initValue - state variable initValue.
+   * @param { WatchFuncType } [watchFunc] - watch type
+   * @returns { IStateDecoratedVariable<T> } State instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeState<T>(owningView: ExtendableComponent, varName: string, initValue: T,
+    watchFunc?: WatchFuncType): IStateDecoratedVariable<T>;
+  /**
+   * Create a PropRef variable instance.
+   *
+   * @param { ExtendableComponent } owningView - custom component.
+   * @param { string } varName - state variable name.
+   * @param { T } initValue - state variable initValue.
+   * @param { WatchFuncType } [watchFunc] - watch type
+   * @returns { IPropRefDecoratedVariable<T> } PropRef instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makePropRef<T>(owningView: ExtendableComponent, varName: string, initValue: T,
+    watchFunc?: WatchFuncType): IPropRefDecoratedVariable<T>;
+
+  /**
+   * Create a Link variable instance.
+   *
+   * @param { ExtendableComponent } owningView - custom component.
+   * @param { string } varName - state variable name.
+   * @param { LinkSourceType<T> } source - state variable sync source.
+   * @param { WatchFuncType } [watchFunc] - watch type
+   * @returns { ILinkDecoratedVariable<T> } PropRef instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeLink<T>(owningView: ExtendableComponent, varName: string, source: LinkSourceType<T>,
+    watchFunc?: WatchFuncType): ILinkDecoratedVariable<T>;
+
+  /**
+   * Create a Provide variable instance.
+   *
+   * @param { ExtendableComponent } owningView - custom component.
+   * @param { string } varName - state variable name.
+   * @param { string } provideAlias - provide alias.
+   * @param { T } initValue - init value.
+   * @param { Type } ttype - value type.
+   * @param { boolean } allowOverride - Override the @Provide of any parent or parent of parent @Component.@Provide({allowOverride: "name"}) is
+   * also allowed to be used even when there is no ancestor @Component whose @Provide would be overridden.
+   * @param { WatchFuncType } [wathcFunc] - watch type
+   * @returns { IProvideDecoratedVariable<T> } Provide instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeProvide<T>(owningView: ExtendableComponent, varName: string, provideAlias: string,
+    initValue: T, allowOverride: boolean, ttype: Type, wathcFunc?: WatchFuncType): IProvideDecoratedVariable<T>;
+
+  /**
+   * Create a Consume variable instance.
+   *
+   * @param { ExtendableComponent } owningView - custom component.
+   * @param { string } varName - state variable name.
+   * @param { string } provideAlias - provide alias.
+   * @param { Type } ttype - value type.
+   * @param { WatchFuncType } [watchFunc] - watch type
+   * @returns { IConsumeDecoratedVariable<T> } Consume instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeConsume<T>(owningView: ExtendableComponent, varName: string,
+    provideAlias: string, ttype: Type, watchFunc?: WatchFuncType): IConsumeDecoratedVariable<T>;
+
+  /**
+   * Create a ObjectLink variable instance.
+   *
+   * @param { ExtendableComponent } owningView - custom component.
+   * @param { string } varName - state variable name.
+   * @param { T } initValue - init value.
+   * @param { WatchFuncType } [wathcFunc] - watch type
+   * @returns { IObjectLinkDecoratedVariable<T> } ObjectLink instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeObjectLink<T>(owningView: ExtendableComponent, varName: string,
+    initValue: T, wathcFunc?: WatchFuncType): IObjectLinkDecoratedVariable<T>;
+
+  /**
+   * Create a StorageLink variable instance.
+   *
+   * @param { ExtendableComponent } owningView - custom component.
+   * @param { string } propName - property name.
+   * @param { string } varName - state variable name.
+   * @param { T } initValue - init value.
+   * @param { Type } ttype - value type.
+   * @param { WatchFuncType } [watchFunc] - watch type
+   * @returns { IStorageLinkDecoratedVariable<T> } StorageLink instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeStorageLink<T>(owningView: ExtendableComponent, propName: string,
+    varName: string, initValue: T, ttype: Type, watchFunc?: WatchFuncType): IStorageLinkDecoratedVariable<T>;
+
+  /**
+   * Create a StoragePropRef variable instance.
+   *
+   * @param { ExtendableComponent } owningView - custom component.
+   * @param { string } propName - property name.
+   * @param { string } varName - state variable name.
+   * @param { T } initValue - init value.
+   * @param { Type } ttype - value type.
+   * @param { WatchFuncType } [watchFunc] - watch type
+   * @returns { IStoragePropRefDecoratedVariable<T> } StoragePropRef instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeStoragePropRef<T>(owningView: ExtendableComponent, propName: string,
+    varName: string, initValue: T, ttype: Type, watchFunc?: WatchFuncType): IStoragePropRefDecoratedVariable<T>;
+
+  /**
+   * Create a LocalStoragePropRef variable instance.
+   *
+   * @param { ExtendableComponent } owningView - custom component.
+   * @param { string } propName - property name.
+   * @param { string } varName - state variable name.
+   * @param { T } initValue - init value.
+   * @param { Type } ttype - value type.
+   * @param { WatchFuncType } [watchFunc] - watch type
+   * @returns { ILocalStoragePropRefDecoratedVariable<T> } StoragePropRef instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeLocalStoragePropRef<T>(owningView: ExtendableComponent, propName: string,
+    varName: string, initValue: T, ttype: Type, watchFunc?: WatchFuncType): ILocalStoragePropRefDecoratedVariable<T>;
+
+  /**
+   * Create a LocalStorageLink variable instance.
+   *
+   * @param { ExtendableComponent } owningView - custom component.
+   * @param { string } propName - property name.
+   * @param { string } varName - state variable name.
+   * @param { T } initValue - init value.
+   * @param { Type } ttype - value type
+   * @param { WatchFuncType } [watchFunc] - watch type
+   * @returns { IStoragePropRefDecoratedVariable<T> } StoragePropRef instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeLocalStorageLink<T>(owningView: ExtendableComponent, propName: string,
+    varName: string, initValue: T, ttype: Type, watchFunc?: WatchFuncType): IStoragePropRefDecoratedVariable<T>;
+
+  /**
+   * Create a Local variable instance.
+   *
+   * @param { ExtendableComponent } owningView - custom component.
+   * @param { string } varName - state variable name.
+   * @param { T } localInitValue - state variable initValue.
+   * @returns { ILocalDecoratedVariable<T> } Local instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeLocal<T>(owningView: ExtendableComponent, varName: string, localInitValue: T): ILocalDecoratedVariable<T>;
+
+  /**
+   * Create a Param variable instance.
+   *
+   * @param { ExtendableComponent } owningView - custom component.
+   * @param { string } varName - state variable name.
+   * @param { T } initValue - param variable initValue.
+   * @returns { IParamDecoratedVariable<T> } Param instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeParam<T>(owningView: ExtendableComponent, varName: string, initValue: T): IParamDecoratedVariable<T>;
+
+  /**
+   * Create a param once variable instance.
+   *
+   * @param { ExtendableComponent } owningView - custom component.
+   * @param { string } varName - state variable name.
+   * @param { T } initValue - param once variable initValue.
+   * @returns { IParamOnceV2DecoratedVariable<T> } Param Once instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeParamOnce<T>(owningView: ExtendableComponent, varName: string, initValue: T): IParamOnceV2DecoratedVariable<T>;
+
+  /**
+   * Create a provider variable instance.
+   *
+   * @param { ExtendableComponent } owningView - custom component.
+   * @param { string } varName - provider variable name.
+   * @param { string } providerAlias - provider alias.
+   * @param { T } localInitValue - provider local variable value.
+   * @param { Type } ttype - value type.
+   * @returns { IProviderDecoratedVariable<T> } Provider instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeProvider<T>(owningView: ExtendableComponent, varName: string, providerAlias: string, localInitValue: T, ttype: Type): IProviderDecoratedVariable<T>;
+
+  /**
+   * Create a consumer variable instance.
+   *
+   * @param { ExtendableComponent } owningView - custom component.
+   * @param { string } varName - consumer variable name.
+   * @param { string } providerAlias - consumer alias.
+   * @param { T } defaultValue - consumer default value.
+   * @param { Type } ttype - value type.
+   * @returns { IConsumerDecoratedVariable<T> } Consumer instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeConsumer<T>(owningView: ExtendableComponent, varName: string, providerAlias: string, defaultValue: T, ttype: Type): IConsumerDecoratedVariable<T>;
 }
 
-export type WatchFuncType = ((propertyName: string) => void);
+/**
+ * Defines the callback that is called when state variable is change
+ * @typedef { function } WatchFuncType
+ * @param {string} propertyName - property name
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export type WatchFuncType = (propertyName: string) => void;
 
+/**
+ * Define int alias.
+ *
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
 export type WatchIdType = int;
 
+/**
+ * Define IWatchSubscriberRegister interface.
+ *
+ * @interface IWatchSubscriberRegister
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
 export declare interface IWatchSubscriberRegister {
-    addWatchSubscriber(watchId: WatchIdType): void;
-    removeWatchSubscriber(watchId: WatchIdType): boolean;
+  /**
+   * Registers the watch function callback.
+   *
+   * @param { WatchIdType } watchId - the watch function id
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  addWatchSubscriber(watchId: WatchIdType): void;
+  /**
+   * UnRegister the watch function callback.
+   *
+   * @param { WatchIdType } watchId - the watch function id
+   * @returns { boolean }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  removeWatchSubscriber(watchId: WatchIdType): boolean;
 }
 
+/**
+ * Define ISubscribedWatches interface.
+ *
+ * @extends IWatchSubscriberRegister
+ * @interface ISubscribedWatches
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
 export declare interface ISubscribedWatches extends IWatchSubscriberRegister {
-    executeOnSubscribingWatches(propertyName: string): void;
+  /**
+   * Execute the watch function callback.
+   *
+   * @param { string } propertyName - property name
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  executeOnSubscribingWatches(propertyName: string): void;
 }
 
+/**
+ * Define AbstractProperty<T> interface.
+ *
+ *  AbstractProperty can be understood as a handler or an alias
+ *  to a property inside LocalStorage / AppStorage singleton
+ *  allows to read the value with @see get and to change the
+ *  value with @see set.
+ *
+ * @extends IDecoratedMutableVariable<T>
+ * @interface AbstractProperty<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
 export declare interface AbstractProperty<T> extends IDecoratedMutableVariable<T> {
-    info(): string;
+  /**
+   * returns the name of the referenced property
+   *
+   * @returns { string } name of the referenced property
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  info(): string;
 }
 
+/**
+ *   SubscribedAbstractProperty<T> is the return value of
+ *   - AppStorage static functions Link(), Prop(), SetAndLink(), and SetAndProp()
+ *   - LocalStorage member methods link(), prop(), setAndLink(), and setAndProp()
+ *   'T' can be boolean, string, number or custom class.
+ * Main functions
+ *   see get() reads the linked AppStorage/LocalStorage property value,
+ *   see set(newValue) write a new value to the synched AppStorage/LocalStorage property
+ *   see aboutToBeDeleted() ends the sync relationship with the AppStorage/LocalStorage property
+ *        The app must call this function before the SubscribedAbstractProperty<T> object
+ *        goes out of scope.
+ *
+ * @extends AbstractProperty<T>
+ * @interface SubscribedAbstractProperty<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
 export declare interface SubscribedAbstractProperty<T> extends AbstractProperty<T> {
-    aboutToBeDeleted(): void;
+  /**
+   * An app needs to call this function before the instance of SubscribedAbstractProperty
+   * goes out of scope / is subject to garbage collection. Its purpose is to unregister the
+   * variable from the two-way/one-way sync relationship that AppStorage/LocalStorage.link()/prop()
+   * and related functions create.
+   *
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  aboutToBeDeleted(): void;
 }
\ No newline at end of file
-- 
Gitee