From b3c611110deb8b9d0585f542ea5af6ca535df87a Mon Sep 17 00:00:00 2001
From: s10021109 <chenbenzhi@huawei.com>
Date: Tue, 19 Aug 2025 09:34:25 +0800
Subject: [PATCH 1/3] =?UTF-8?q?ArkTS1.2=20storage=E6=9C=80=E6=96=B0?=
 =?UTF-8?q?=E7=9A=84API?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: s10021109 <chenbenzhi@huawei.com>
---
 .../stateManagement/decorator.static.d.ets    | 1148 +++++++++++++++++
 .../storage/appStorage.static.d.ets           |   32 +
 .../storage/environment.static.d.ets          |   93 ++
 .../storage/localStorage.static.d.ets         |  192 +++
 .../storage/persistentStorage.static.d.ets    |  147 +++
 .../storage/storageProperty.static.d.ets      |  169 +++
 6 files changed, 1781 insertions(+)
 create mode 100644 api/arkui/stateManagement/decorator.static.d.ets
 create mode 100644 api/arkui/stateManagement/storage/appStorage.static.d.ets
 create mode 100644 api/arkui/stateManagement/storage/environment.static.d.ets
 create mode 100644 api/arkui/stateManagement/storage/localStorage.static.d.ets
 create mode 100644 api/arkui/stateManagement/storage/persistentStorage.static.d.ets
 create mode 100644 api/arkui/stateManagement/storage/storageProperty.static.d.ets

diff --git a/api/arkui/stateManagement/decorator.static.d.ets b/api/arkui/stateManagement/decorator.static.d.ets
new file mode 100644
index 0000000000..c062d2d5ef
--- /dev/null
+++ b/api/arkui/stateManagement/decorator.static.d.ets
@@ -0,0 +1,1148 @@
+
+/*
+ * Copyright (C) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @file
+ * @kit ArkUI
+ * @arkts 1.2
+ */
+
+/**
+ * Define decorated variable interface.
+ *
+ * @interface IDecoratedVariable
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IDecoratedVariable {
+  /**
+   * Decorated variable name.
+   *
+   * @type { string }
+   * @readonly
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  readonly varName: string;
+}
+
+/**
+ * Defining State annotation
+ * State variable that holds the state property and is used to render the owning custom component.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface State {}
+
+/**
+ * Define V1 decorated variable interface.
+ *
+ * @extends IDecoratedVariable
+ * @interface IDecoratedVariable
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IDecoratedV1Variable<T> extends IDecoratedVariable {
+  /**
+   * 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;
+}
+
+/**
+ * Defining PropRef annotation
+ * PropRef is an annotation which is mutable.
+ * Any object property modifications made through PropRef are visible in the
+ * parent component, which is different from Prop.
+ * In order to prevent this, need to take a deep copy of the parent data.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface PropRef {}
+
+/**
+ * Define decorated immutable variable interface.
+ *
+ * @interface IDecoratedImmutableVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IDecoratedImmutableVariable<T> {
+  /**
+   * Get the state variable.
+   *
+   * @returns { T }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  get(): T;
+}
+
+/**
+ * Defining Link annotation
+ * Link decorated variable creates two-way synchronization with a variable of its parent component.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface Link {}
+
+/**
+ * Define decorated mutable variable interface.
+ *
+ * @interface IDecoratedMutableVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IDecoratedMutableVariable<T> {
+  /**
+   * 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;
+}
+
+/**
+ * Defining Observed annotation
+ * Observed is used to decorate a class.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface Observed {}
+
+/**
+ * Define decorated updatable variable interface.
+ *
+ * @interface IDecoratedUpdatableVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IDecoratedUpdatableVariable<T> {
+  /**
+   * Update the state variable with a new Value.
+   *
+   * @param { T } newValue
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  update(newValue: T): void;
+}
+
+/**
+ * Defining Track annotation
+ * Track is a decorator used to decorate properties of class objects.
+ * Any changes to the properties decorated by Track will trigger only updates to the UI associated with those properties.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface Track {}
+
+/**
+ * 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> {}
+
+/**
+ * Defining ObjectLink annotation
+ * ObjectLink is used to observe property changes in nested class objects.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface ObjectLink {}
+
+/**
+ * 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> {}
+
+/**
+ * Defining StoragePropRef annotation
+ * StoragePropRef is an annotation which is mutable.
+ * Any object property modifications made through StoragePropRef are visible in the
+ * AppStorage, which is different from StorageProp.
+ * In order to prevent this, need to take a deep copy of AppStorage instance data.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface StoragePropRef {}
+
+/**
+ * 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> {}
+
+/**
+ * Defining StorageLink annotation
+ * StorageLink is used to create a two-way data synchronization between the variable
+ * it decorates and the attribute with the given key in AppStorage.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface StorageLink {}
+
+/**
+ * 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> {}
+
+/**
+ * Defining LocalStoragePropRef annotation
+ * LocalStoragePropRef is an annotation which is mutable.
+ * Any object property modifications made through LocalStoragePropRef are visible in the
+ * LocalStorage, which is different from LocalStorageProp.
+ * In order to prevent this, need to take a deep copy of LocalStorage data.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface LocalStoragePropRef {}
+
+/**
+ * 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> {}
+
+/**
+ * Defining LocalStorageLink annotation
+ * LocalStorageLink is used to create a two-way data synchronization with the attribute
+ * in LocalStorage.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface LocalStorageLink {}
+
+/**
+ * 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> {}
+
+/**
+ * Defining Provide annotation
+ * Provide is used for two-way data synchronization with descendant components when
+ * state data needs to be transferred between multiple levels. An @Provide decorated state
+ * variable exists in the ancestor component and is said to be "provided" to descendent components.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface Provide {}
+
+/**
+ * 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> {}
+
+/**
+ * Defining Consume annotation
+ * Consume is used to access the provided state variable for a descendent component
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface Consume {}
+
+/**
+ * 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> {}
+
+/**
+ * Defining Watch annotation
+ * Watch is used to listen for state variables.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface Watch {}
+
+/**
+ * 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> {}
+
+/**
+ * Defining Require annotation
+ * Require is a decorator for declaring that parameters ¨C regular variables.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface Require {}
+
+/**
+ * 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> {}
+
+/**
+ * Defining Local annotation
+ * Local is the internal state of a component, which enables the variables in the
+ * custom component to observe changes.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface Local {}
+
+/**
+ * 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 {}
+
+/**
+ * Defining Param annotation
+ * Param indicates the state passed in from the external, ensuring that
+ * data can be synchronized between the parent and child components.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface Param {}
+
+/**
+ * Define V2 decorated variable interface.
+ *
+ * @extends IDecoratedVariable
+ * @interface IDecoratedV2Variable
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export interface IDecoratedV2Variable extends IDecoratedVariable {}
+
+/**
+ * Defining Once annotation
+ * Once annotation accepts values passed in only during variable initialization
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface Once {}
+
+/**
+ * Define Param decoration variable interface.
+ *
+ * @extends IDecoratedImmutableVariable<T>,  IDecoratedUpdatableVariable<T>, IDecoratedV2Variable
+ * @interface IParamDecoratedVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IParamDecoratedVariable<T> extends IDecoratedImmutableVariable<T>, IDecoratedUpdatableVariable<T>, IDecoratedV2Variable {}
+
+/**
+ * Defining Event annotation
+ * Event is used to decorate the callback method is a standard, indicating that the
+ * child component needs to pass in the callback for updating the data source.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface Event {}
+
+/**
+ * Define Param Once decoration variable interface.
+ *
+ * @extends IDecoratedMutableVariable<T>, IDecoratedV2Variable
+ * @interface IParamOnceDecoratedVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IParamOnceDecoratedVariable<T> extends IDecoratedMutableVariable<T>, IDecoratedV2Variable {}
+
+/**
+ * Defining Provider annotation
+ * Provider is used for two-way data synchronization with descendant components when
+ * state data needs to be transferred between multiple levels. An @Provider decorated state
+ * variable exists in the ancestor component and is said to be "provider" to descendent components.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface Provider {}
+
+/**
+ * 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 {}
+
+/**
+ * Defining Consumer annotation
+ * Consumer is used to access the provided state variable for a descendent component
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface Consumer {}
+
+/**
+ * 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 {}
+
+/**
+ * Defining ObservedV2 annotation
+ * ObservedV2 is used to decorate with class.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface ObservedV2 {}
+
+/**
+ * Define Link source type.
+ *
+ * @typedef { IDecoratedV1Variable<T> } LinkSourceType<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export type LinkSourceType<T> = IDecoratedV1Variable<T>;
+
+/**
+ * Defining Trace annotation
+ * Trace is used to directly observe the property changes of nested objects
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface Trace {}
+
+/**
+ * Define mutable state meta interface.
+ *
+ * @interface IMutableStateMeta
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IMutableStateMeta {
+  /**
+   * 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;
+}
+
+/**
+ * Defining Computed annotation
+ * Computed is a method decorator that decorates the getter method.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface Computed {}
+
+/**
+ * Define mutable state meta interface with key.
+ *
+ * @interface IMutableKeyedStateMeta
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IMutableKeyedStateMeta {
+  /**
+   * 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;
+}
+
+/**
+ * Defining Monitor annotation
+ * Monitor provides the capability of listening for state variables of V2.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+@Retention({policy: "SOURCE"})
+export declare @interface Monitor {}
+
+/**
+ * Define IObserve interface.
+ *
+ * @interface IObserve
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IObserve {
+  /**
+   * 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 OBSERVED.
+ *
+ * @type { IObserve }
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare const OBSERVE: IObserve;
+
+/**
+ * Define int alias.
+ *
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export type RenderIdType = int;
+
+/**
+ * Define IObservedObject interface.
+ *
+ * @extends IWatchSubscriberRegister
+ * @interface IObservedObject
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IObservedObject extends IWatchSubscriberRegister {
+  /**
+   * 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 {
+  /**
+   * 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 { boolean } allowOverride - Override the @Provide of any parent
+   * @param { WatchFuncType } [watchFunc] - 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, watchFunc?: 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 { WatchFuncType } [watchFunc] - watch type
+   * @returns { IConsumeDecoratedVariable<T> } Consume instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeConsume<T>(owningView: ExtendableComponent, varName: string,
+    provideAlias: string, 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 { 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, 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 { 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, watchFunc?: WatchFuncType): IStoragePropRefDecoratedVariable<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 { WatchFuncType } [watchFunc] - watch type
+   * @returns { ILocalStorageLinkDecoratedVariable<T> } LocalStorageLink instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeLocalStorageLink<T>(owningView: ExtendableComponent, propName: string,
+        varName: string, initValue: T, watchFunc?: WatchFuncType): ILocalStorageLinkDecoratedVariable<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 { WatchFuncType } [watchFunc] - watch type
+   * @returns { ILocalStoragePropRefDecoratedVariable<T> } LocalStoragePropRef instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeLocalStoragePropRef<T>(owningView: ExtendableComponent, propName: string, varName: string, initValue: T, watchFunc?: WatchFuncType): ILocalStoragePropRefDecoratedVariable<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 static local variable instance.
+   *
+   * @param { string } varName - state variable name.
+   * @param { T } localInitValue - state variable initValue.
+   * @returns { ILocalDecoratedVariable<T> } Local instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeStaticLocal<T>(varName: string, localInitValue: T): ILocalDecoratedVariable<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 { IParamOnceDecoratedVariable<T> } Param Once instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeParamOnce<T>(owningView: ExtendableComponent, varName: string, initValue: T): IParamOnceDecoratedVariable<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.
+   * @returns { IProviderDecoratedVariable<T> } Provider instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeProvider<T>(owningView: ExtendableComponent, varName: string, providerAlias: string, 
+                  localInitValue: T): 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.
+   * @returns { IConsumerDecoratedVariable<T> } Consumer instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeConsumer<T>(owningView: ExtendableComponent, varName: string, providerAlias: string, defaultValue: T): IConsumerDecoratedVariable<T>;
+
+  /**
+   * Create a computed variable instance.
+   *
+   * @param { ComputedCallback<T> } computedCallback - computed callback function
+   * @param { string } computeName - name of the computed function
+   * @returns { IComputedDecoratedVariable<T> } Computed instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeComputed<T>(computedCallback: ComputedCallback<T>, computeName: string): IComputedDecoratedVariable<T>;
+
+  /**
+   * Create a monitored variable instance.
+   *
+   * @param { Array<IMonitorPathInfo> } pathInfos - monitor path to its accessor
+   * @param { MonitorCallback } monitorCallback - callback when then monitor triggers
+   * @returns { IMonitorDecoratedVariable } Monitor variable instance
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  makeMonitor(pathInfos: Array<IMonitorPathInfo>, monitorCallback: MonitorCallback): IMonitorDecoratedVariable;
+}
+
+/**
+ * Defines computed callback funciton
+ * @typedef { function } ComputeCallback<T>
+ * @returns { T }
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+type ComputedCallback<T> = () => T;
+
+/**
+ * Defines IMonitor callback funciton
+ * @typedef { function } MonitorCallback
+ * @param { IMonitor } iMonitor Monitor value
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+type MonitorCallback = (iMonitor: IMonitor) => void;
+
+/**
+ * Defines IMonitor value callback funciton
+ * @typedef { function } MonitorValueCallback
+ * @returns { Any }
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+type MonitorValueCallback = () => Any;
+
+/**
+ * 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 {
+  /**
+   * 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 {
+  /**
+   * Execute the watch function callback.
+   *
+   * @param { string } propertyName - property name
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  executeOnSubscribingWatches(propertyName: string): void;
+}
+
+
+/**
+ * Define IMonitor interface
+ *
+ * @interface IMonitor
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IMonitor {
+  /**
+   * Array of changed paths(keys)
+   *
+   * @type { Array<string> }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  dirty: Array<string>;
+
+  /**
+   * Return the pair of the value before the most recent change and current value for given path.
+   * If path does not exist, return undefined; If path is not specified, return the value pair
+   * corresponding to the first path in dirty.
+   *
+   * @param { string } [path] Listened property name
+   * @returns { IMonitorValue<T> | undefined }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  value<T>(path?: string): IMonitorValue<T> | undefined;
+}
+
+/**
+ * Define IMonitorValue interface
+ *
+ * @interface IMonitorValue<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IMonitorValue<T> {
+  /**
+   * Get the previous value.
+   *
+   * @type { T }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  before: T;
+  /**
+   * Get current value.
+   *
+   * @type { T }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  now: T;
+  /**
+   * Monitored path input by the user.
+   *
+   * @type { string }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  path: string;
+}
+
+/**
+ * Defines computed decoration variable interface.
+ *
+ * @interface IComputedDecoratedVariable<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IComputedDecoratedVariable<T> {
+  /**
+   * Get the computed variable.
+   *
+   * @returns { T }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  get(): T;
+}
+
+/**
+ * Defines @Monitor decorated variable interface.
+ *
+ * @interface IMonitorDecoratedVariable
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IMonitorDecoratedVariable {}
+
+/**
+ * Defines Monitor path with its accessor interface.
+ *
+ * @interface IMonitorPathInfo
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface IMonitorPathInfo {
+  /**
+   * Changed paths(keys)
+   *
+   * @type { string }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  path: string;
+
+  /**
+   * Callback function to access monitored value.
+   *
+   * @type { MonitorValueCallback }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  valueCallback: MonitorValueCallback;
+}
\ No newline at end of file
diff --git a/api/arkui/stateManagement/storage/appStorage.static.d.ets b/api/arkui/stateManagement/storage/appStorage.static.d.ets
new file mode 100644
index 0000000000..11d9966132
--- /dev/null
+++ b/api/arkui/stateManagement/storage/appStorage.static.d.ets
@@ -0,0 +1,32 @@
+
+/*
+ * Copyright (C) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @file
+ * @kit ArkUI
+ * @arkts 1.2
+ */
+
+import { LocalStorage } from './localStorage';
+
+/**
+ * AppStorage singleton is sub-class of see LocalStorage for
+ * UI state of app-wide access and same life cycle as the app.
+ * @type { LocalStorage }
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare const AppStorage: LocalStorage;
\ No newline at end of file
diff --git a/api/arkui/stateManagement/storage/environment.static.d.ets b/api/arkui/stateManagement/storage/environment.static.d.ets
new file mode 100644
index 0000000000..e8cc5fe9ed
--- /dev/null
+++ b/api/arkui/stateManagement/storage/environment.static.d.ets
@@ -0,0 +1,93 @@
+
+/*
+ * Copyright (c) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License"),
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @file
+ * @kit ArkUI
+ * @arkts 1.2
+ */
+
+/**
+ * Defining the EnvPropsOptions interface
+ *
+ * @interface EnvPropsOptions
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface EnvPropsOptions {
+
+  /**
+   * Property name of Environment variable
+   *
+   * @type { string }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  key: string;
+
+  /**
+   * DefaultValue is the default value if cannot get the environment property value
+   *
+   * @type { number | string | boolean }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  defaultValue: number | string | boolean;
+}
+
+/**
+ * Defines the Environment interface.
+ *
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare class Environment {
+
+  /**
+   * Creates a new property in AppStorage. The UI framework implementation takes care of updating
+   * its value whenever the named device environment property changes. Recommended use is at app startup.
+   * The function call fails and returns false if a property with given name exists in AppStorage already.
+   * It is wrong API use to access a property with given name in AppStorage before calling Environment.envProp.
+   *
+   * @param { string } key - environment property
+   * @param { T } value - is the default value if cannot get the environment property value
+   * @returns { boolean } false if method failed
+   * @static
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  static envProp<T>(key: string, value: T): boolean;
+
+  /**
+   * Called when multiple property values are added to Environment.
+   *
+   * @param { EnvPropsOptions[] } props environment parameter
+   * @static
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  static envProps(props: EnvPropsOptions[]): void;
+
+  /**
+   * returns an array of all environment property keys
+   *
+   * @returns { Array<string> } all environment property keys
+   * @static
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  static keys(): Array<string>;
+}
\ No newline at end of file
diff --git a/api/arkui/stateManagement/storage/localStorage.static.d.ets b/api/arkui/stateManagement/storage/localStorage.static.d.ets
new file mode 100644
index 0000000000..7fd93f5bcf
--- /dev/null
+++ b/api/arkui/stateManagement/storage/localStorage.static.d.ets
@@ -0,0 +1,192 @@
+
+/*
+ * Copyright (C) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @file
+ * @kit ArkUI
+ * @arkts 1.2
+ */
+
+import { AbstractProperty, SubscribedAbstractProperty } from './storageProperty';
+
+/**
+ * LocalStorage
+ * Class implements a Map of ObservableObjectBase UI state variables.
+ * Instances can be created to manage UI state within a limited "local"
+ * access, and life cycle as defined by the app.
+ * AppStorage singleton is sub-class of LocalStorage for
+ * UI state of app-wide access and same life cycle as the app.
+ *
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare class LocalStorage {
+  /**
+   * Construct new instance of LocalStorage
+   * initialize with all properties and their values that Object.keys(params) returns
+   * Property values must not be undefined.
+   *
+   * @param { Record<string, Any> } [initializingProperties] - initializing Properties
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  public constructor(initializingProperties?: Record<string, Any>);
+  /**
+   * Obtain a handler or an alias to LocalStorage property with given name.
+   *
+   * @param { string } propName LocalStorage property name
+   * @returns { AbstractProperty<T> | undefined } AbstractProperty object if property with given name exists
+   *     return undefined otherwise.
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  public ref<T>(propName: string): AbstractProperty<T> | undefined;
+  /**
+   * Obtain a handler or an alias to LocalStorage property with given name.
+   *
+   * If property does not exist in LocalStorage, create it with given default value.
+   *
+   * @param { string } propName LocalStorage property name
+   * @param { T } defaultValue If property does not exist in LocalStorage, create it with given default value.
+   * @returns { AbstractProperty<T> } AbstractProperty object
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  public setAndRef<T>(propName: string, defaultValue: T): AbstractProperty<T>;
+
+  /**
+   * Create and return a two-way sync "(link") to named property
+   *
+   * @param { string } propName - name of source property in LocalStorage
+   * @returns { SubscribedAbstractProperty<T> | undefined } instance of
+   *     SubscribedAbstractProperty<T>, return undefined if named property does not already exist in LocalStorage.
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  public link<T>(propName: string): SubscribedAbstractProperty<T> | undefined;
+
+  /**
+   * Like see link(), but will create and initialize a new source property in LocalStorage if missing
+   *
+   * @param { string } propName - name of source property in LocalStorage
+   * @param { T } defaultValue - value to be used for initializing new property in LocalStorage
+   *     default value must be of type T, can be undefined or null.
+   * @returns { SubscribedAbstractProperty<T> } instance of SubscribedAbstractProperty<T>
+   *     Apps can use SDK functions of base class SubscribedAbstractProperty<T>
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  public setAndLink<T>(propName: string, defaultValue: T): SubscribedAbstractProperty<T>;
+
+  /**
+   * Check if LocalStorage has a property with given name
+   * return true if property with given name exists
+   * same as ES6 Map.prototype.has()
+   *
+   * @param { string } propName - searched property
+   * @returns { boolean } true if property with such name exists in LocalStorage
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  public has(propName: string): boolean;
+
+  /**
+   * Returns value of given property
+   * return undefined if no property with this name
+   *
+   * @param { string } propName - property name
+   * @returns { T | undefined } property value if found or undefined
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  public get<T>(propName: string): T | undefined;
+
+  /**
+   * Set value of given property in LocalStorage
+   * Method sets nothing and returns false if property with this name does not exist in LocalStorage
+   * newValue can be undefined or null from API 20.
+   *
+   * @param { string } propName
+   * @param { T } newValue - must be of type T, can be undefined or null
+   * @returns { boolean } true on success, i.e. when above conditions are satisfied, otherwise false
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  public set<T>(propName: string, newValue: T): boolean;
+
+  /**
+   * Set value of given property, if it exists, see set() .
+   * Add property if no property with given name and initialize with given value.
+   * newValue can be undefined or null from API 12
+   *
+   * @param { string } propName
+   * @param { T } newValue - must be of type T, can be undefined or null
+   * @returns { boolean } true on success, i.e. when above conditions are satisfied, otherwise false
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  public setOrCreate<T>(propName: string, newValue: T): boolean;
+
+  /**
+   * Provide names of all properties in LocalStorage
+   * same as ES6 Map.prototype.keys()
+   *
+   * @returns { IterableIterator<string> } return a Map Iterator
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  public keys(): IterableIterator<string>;
+  /**
+   * Returns number of properties in LocalStorage
+   * same as Map.prototype.size()
+   *
+   * @returns { number } return number of properties
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  public size(): number;
+  /**
+   * Delete property from StorageBase
+   * Use with caution:
+   * Before deleting a prop from LocalStorage all its subscribers need to
+   * unsubscribe from the property.
+   * This method fails and returns false if given property still has subscribers
+   * Another reason for failing is unknown property.
+   * Developer advise:
+   * Subscribers are created with see link(), see prop()
+   * and also via @LocalStorageLink and @LocalStorageProp state variable decorators.
+   * That means as long as their is a @Component instance that uses such decorated variable
+   * or a sync relationship with a SubscribedAbstractProperty variable the property can nit
+   * (and also should not!) be deleted from LocalStorage.
+   *
+   * @param { string } propName
+   * @returns { boolean } false if method failed
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  public delete(propName: string): boolean;
+  /**
+   * Delete all properties from the LocalStorage instance
+   * Precondition is that there are no subscribers.
+   * method returns false and deletes no properties if there is any property
+   * that still has subscribers
+   *
+   * @returns { boolean }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  public clear(): boolean;
+}
\ No newline at end of file
diff --git a/api/arkui/stateManagement/storage/persistentStorage.static.d.ets b/api/arkui/stateManagement/storage/persistentStorage.static.d.ets
new file mode 100644
index 0000000000..193f0ce02c
--- /dev/null
+++ b/api/arkui/stateManagement/storage/persistentStorage.static.d.ets
@@ -0,0 +1,147 @@
+
+/*
+ * Copyright (c) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License"),
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @file
+ * @kit ArkUI
+ * @arkts 1.2
+ */
+
+/**
+ * Defines the PersistentStorage interface.
+ *
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare class PersistentStorage {
+
+  /**
+   * Add property 'key' to AppStorage properties whose current value will be
+   * persistent.
+   * If AppStorage does not include this property it will be added and initializes
+   * with given value
+   *
+   * @param { string } key - property name
+   * @param { T } defaultValue - If AppStorage does not include this property it will be initialized with this value
+   * @param { ToJSONType<T> } [toJson] - serialization function
+   * @param { FromJSONType<T> } [fromJson] - deserialization function
+   * @returns { boolean }
+   * @static
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  static persistProp<T>(key: string, defaultValue: T, toJson?: ToJSONType<T>, fromJson?: FromJSONType<T>): boolean;
+
+  /**
+   * Reverse of @see persistProp
+   *
+   * @param { string } key - no longer persist the property named key
+   * @static
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  static deleteProp(key: string): void;
+
+  /**
+   * Persist given AppStorage properties with given names.
+   * If a property does not exist in AppStorage, add it and initialize it with given value
+   * works as @see persistProp for multiple properties.
+   *
+   * @param { PersistPropsOptions[] } props persistent parameter
+   * @static
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  static persistProps(props: PersistPropsOptions[]): void;
+
+  /**
+   * Inform persisted AppStorage property names
+   *
+   * @returns { Array<string> } array of AppStorage keys
+   * @static
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  static keys(): Array<string>;
+}
+
+/**
+ * Defining PersistPropsOptions interface
+ *
+ * @interface PersistPropsOptions
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+declare interface PersistPropsOptions<T> {
+
+  /**
+   * Property name
+   *
+   * @type { string }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  key: string;
+
+  /**
+   * If AppStorage does not include this property it will be initialized with this value
+   *
+   * @type { T }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  defaultValue: T;
+
+  /**
+   * Used to serialize data
+   *
+   * @type { ?ToJSONType<T> }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  toJson?: ToJSONType<T>;
+
+  /**
+   * Used to deserialize data
+   *
+   * @type { ?FromJSONType<T> }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  fromJson?: FromJSONType<T>;
+}
+
+/**
+ * Define toJson type function.
+ *
+ * @typedef { function } ToJSONType<T>
+ * @param { T } value  toJson value
+ * @returns { jsonx.JsonElement } Json stringify element object
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare type ToJSONType<T> = (value: T) => jsonx.JsonElement;
+
+/**
+ * Define fromJson type function.
+ *
+ * @typedef { function } FromJSONType<T>
+ * @param { jsonx.JsonElement } element  json element
+ * @returns { T } deserialization result
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare type FromJSONType<T> = (element: jsonx.JsonElement) => T;
\ No newline at end of file
diff --git a/api/arkui/stateManagement/storage/storageProperty.static.d.ets b/api/arkui/stateManagement/storage/storageProperty.static.d.ets
new file mode 100644
index 0000000000..1e0d3b1c77
--- /dev/null
+++ b/api/arkui/stateManagement/storage/storageProperty.static.d.ets
@@ -0,0 +1,169 @@
+
+/*
+ * Copyright (C) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @file
+ * @kit ArkUI
+ * @arkts 1.2
+ */
+
+/**
+ * Defines the callback that is called when state variable with value is change
+ * @typedef { function } OnChangeType
+ * @param { string } propertyName - property name
+ * @param { T } newValue - the new value of state variable
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export type OnChangeType<T> = (propertyName: string, newValue: T) => 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.
+ *
+ * @interface AbstractProperty<T>
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export interface AbstractProperty<T> {
+  /**
+   * Returns the name of the referenced property
+   *
+   * @returns { string } name of the referenced property
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  info(): string { return ""; };
+
+  /**
+   * Reads value of the referenced AppStorage/LocalStorage property.
+   *
+   * @returns { T } value of the referenced AppStorage/LocalStorage property.
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  get(): T;
+
+  /**
+   * Assign a new value to the referenced property
+   *
+   * @param {T} newValue - a new value of the referenced property
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  set(newValue: T): void {};
+  /**
+   * Register callback function to be called on value change of the referenced property
+   * calling with value undefined clear the callback.
+   *
+   * @param {OnChangeType<T> | undefined} onChangeFunc - register callback function
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  onChange(onChangeFunc: OnChangeType<T> | undefined): void {};
+}
+
+/**
+ * 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 interface SubscribedAbstractProperty<T> extends AbstractProperty<T> {
+  /**
+   * 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 {};
+}
+
+/**
+ * Defines the ColorMode of device.
+ *
+ * @enum { number }
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+declare enum ColorMode {
+  /**
+   * Light mode.
+   *
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  LIGHT = 0
+
+  /**
+   * Dark mode.
+   *
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  DARK = 1
+}
+
+/**
+ * Defines the LayoutDirection of device.
+ *
+ * @enum { number }
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+declare enum LayoutDirection {
+  /**
+   * Elements are laid out from left to right.
+   *
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  LTR = 0
+
+  /**
+   * Elements are laid out from right to left.
+   *
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  RTL = 1,
+
+  /**
+   * Elements are laid out from auto.
+   *
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  Auto = 2
+}
\ No newline at end of file
-- 
Gitee


From bdc73c75a5e778df9196d63d1c47ee2a9ab1945b Mon Sep 17 00:00:00 2001
From: s10021109 <chenbenzhi@huawei.com>
Date: Mon, 8 Sep 2025 11:35:26 +0800
Subject: [PATCH 2/3] ArkTS1.2 Adds AppStorageV2 & PersistenceV2

Signed-off-by: s10021109 <chenbenzhi@huawei.com>
---
 api/@ohos.arkui.stateManagement.d.ets         | 102 ++++---
 .../storage/appStorageV2.static.d.ets         |  91 ++++++
 .../storage/persistenceV2.static.d.ets        | 261 ++++++++++++++++++
 3 files changed, 416 insertions(+), 38 deletions(-)
 create mode 100644 api/arkui/stateManagement/storage/appStorageV2.static.d.ets
 create mode 100644 api/arkui/stateManagement/storage/persistenceV2.static.d.ets

diff --git a/api/@ohos.arkui.stateManagement.d.ets b/api/@ohos.arkui.stateManagement.d.ets
index 7bfe12e22c..67b9b9fe74 100644
--- a/api/@ohos.arkui.stateManagement.d.ets
+++ b/api/@ohos.arkui.stateManagement.d.ets
@@ -1,38 +1,64 @@
-/*
- * Copyright (C) 2025 Huawei Device Co., Ltd.
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
- 
-/**
- * @file State management API file
- * @kit ArkUI
- * @arkts 1.2
- */
- 
-export * from './arkui/stateManagement/common';
-export * from './arkui/stateManagement/runtime';
-export * from './arkui/stateManagement/base/backingValue';
-export * from './arkui/stateManagement/base/decoratorBase';
-export * from './arkui/stateManagement/base/iObservedObject';
-export * from './arkui/stateManagement/base/mutableStateMeta';
-export * from './arkui/stateManagement/decorators/decoratorState';
-export * from './arkui/stateManagement/decorators/decoratorLink';
-export * from './arkui/stateManagement/decorators/decoratorObjectLink';
-export * from './arkui/stateManagement/decorators/decoratorProp';
-export * from './arkui/stateManagement/decorators/decoratorProvide';
-export * from './arkui/stateManagement/decorators/decoratorConsume';
-export * from './arkui/stateManagement/decorators/decoratorStorageLink';
-export * from './arkui/stateManagement/decorators/decoratorStorageProp';
-export * from './arkui/stateManagement/decorators/decoratorWatch';
-export * from './arkui/stateManagement/storages/appStorage';
-export * from './arkui/stateManagement/storages/localStorage';
+/*
+ * Copyright (C) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @file State management API file
+ * @kit ArkUI
+ * @arkts 1.2
+ */
+
+export * from './arkui/stateManagement/decorator';
+export * from './arkui/stateManagement/runtime';
+export * from './arkui/stateManagement/storage/appStorage';
+export * from './arkui/stateManagement/storage/appStorageV2';
+export * from './arkui/stateManagement/storage/environment';
+export * from './arkui/stateManagement/storage/localStorage';
+export * from './arkui/stateManagement/storage/persistenceV2';
+export * from './arkui/stateManagement/storage/persistentStorage';
+export * from './arkui/stateManagement/storage/storageProperty';
+export * from './arkui/stateManagement/utils';
+
+export * from './arkui/stateManagement/common';
+
+export * from './arkui/stateManagement/base/backingValue';
+
+export * from './arkui/stateManagement/base/decoratorBase';
+
+export * from './arkui/stateManagement/base/iObservedObject';
+
+export * from './arkui/stateManagement/base/mutableStateMeta';
+
+export * from './arkui/stateManagement/decorators/decoratorState';
+
+export * from './arkui/stateManagement/decorators/decoratorLink';
+
+export * from './arkui/stateManagement/decorators/decoratorObjectLink';
+
+export * from './arkui/stateManagement/decorators/decoratorProp';
+
+export * from './arkui/stateManagement/decorators/decoratorProvide';
+
+export * from './arkui/stateManagement/decorators/decoratorConsume';
+
+export * from './arkui/stateManagement/decorators/decoratorStorageLink';
+
+export * from './arkui/stateManagement/decorators/decoratorStorageProp';
+
+export * from './arkui/stateManagement/decorators/decoratorWatch';
+
+export * from './arkui/stateManagement/storages/appStorage';
+
+export * from './arkui/stateManagement/storages/localStorage';
+export * from './arkui/stateManagement/remember';
\ No newline at end of file
diff --git a/api/arkui/stateManagement/storage/appStorageV2.static.d.ets b/api/arkui/stateManagement/storage/appStorageV2.static.d.ets
new file mode 100644
index 0000000000..5b1e31dea1
--- /dev/null
+++ b/api/arkui/stateManagement/storage/appStorageV2.static.d.ets
@@ -0,0 +1,91 @@
+
+/*
+ * Copyright (c) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License"),
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @file
+ * @kit ArkUI
+ * @arkts 1.2
+ */
+
+import { StorageDefaultCreator } from './persistenceV2';
+
+'use static';
+
+/**
+ * AppStorageV2 is for UI state of app-wide access, has same life cycle as the app,
+ * and saves database content only in memory.
+ *
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare class AppStorageV2 {
+
+  /**
+   * If used by persistenceV2, module-level storage path, different modules will have their own storage paths.
+   * If the value for the given key is already available, return the value.
+   * If not, add the key with value generated by calling defaultFunc and return it to caller.
+   *
+   * @param { Type } ttype class type of the stored value.
+   * @param { string } key alias name of the key
+   * @param { StorageDefaultCreator<T> } [defaultCreator] the function generating the default value
+   * @returns { T | undefined } the value of the existed key or the default value
+   * @static
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  static connect<T extends object>(
+      ttype: Type,
+      key: string,
+      defaultCreator?: StorageDefaultCreator<T>
+  ): T | undefined;
+
+  /**
+   * If used by persistenceV2, module-level storage path, different modules will have their own storage paths.
+   * If the value for the given key is already available, return the value.
+   * If not, add the key with value generated by calling defaultFunc and return it to caller.
+   *
+   * @param { Type } ttype class type of the stored value.
+   * @param { StorageDefaultCreator<T> } [defaultCreator] the function generating the default value
+   * @returns { T | undefined } the value of the existed key or the default value
+   * @static
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  static connect<T extends object>(
+    ttype: Type,
+    defaultCreator?: StorageDefaultCreator<T>
+  ): T | undefined;
+
+  /**
+   * Removes data with the given key or given class type.
+   *
+   * @param { string | Type } keyOrType key or class type removing
+   * @static
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  static remove(keyOrType: string | Type): void;
+
+  /**
+   * Return the array of all keys.
+   *
+   * @returns { Array<string> } the array of all keys
+   * @static
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  static keys(): Array<string>;
+}
\ No newline at end of file
diff --git a/api/arkui/stateManagement/storage/persistenceV2.static.d.ets b/api/arkui/stateManagement/storage/persistenceV2.static.d.ets
new file mode 100644
index 0000000000..8162069507
--- /dev/null
+++ b/api/arkui/stateManagement/storage/persistenceV2.static.d.ets
@@ -0,0 +1,261 @@
+
+/*
+ * Copyright (c) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License"),
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @file
+ * @kit ArkUI
+ * @arkts 1.2
+ */
+
+import { ToJSONType, FromJSONType } from './persistentStorage';
+
+import contextConstant from '@ohos.app.ability.contextConstant';
+
+'use static';
+
+/**
+ * Function that returns default creator.
+ *
+ * @typedef { function } StorageDefaultCreator<T>
+ * @returns { T } default creator
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare type StorageDefaultCreator<T> = () => T;
+
+/**
+ * Defines Serializable object
+ *
+ * @extends jsonx.JsonElementSerializable, jsonx.JsonElementDeserializable
+ * @interface SerializableObject
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export interface SerializableObject extends jsonx.JsonElementSerializable, jsonx.JsonElementDeserializable {}
+
+/**
+ * Define ConnectOptions class.
+ * @typedef ConnectOptions
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare interface ConnectOptions<T extends object> {
+
+  /**
+   * Define class constructor
+   * @type { Type } type class type of the stored value.
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  type: Type;
+
+  /**
+   * Defines alias name of the key, or the function generating the default value.
+   * @type { ?string }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  key?: string;
+
+  /**
+   * Define the function generating the default value.
+   * @type { ?StorageDefaultCreator<T>}
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  defaultCreator?: StorageDefaultCreator<T>;
+
+  /**
+   * Define encrypted partition for data storage.
+   * if not passed in, the defaule value is El2
+   *
+   * @type { ?contextConstant.AreaMode}
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  areaMode?: contextConstant.AreaMode;
+}
+
+/**
+ * Function that returns reason type when error.
+ *
+ * @typedef { function } PersistenceErrorCallback
+ * @param { string } key persisted key when error
+ * @param { 'quota' | 'serialization' | 'unknown' } reason reason type when error
+ * @param { string } message more message when error
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare type PersistenceErrorCallback = (key: string, reason: 'quota' | 'serialization' | 'unknown', message: string) => void;
+
+/**
+ * PersistenceV2 is for UI state of app-wide access, available on app re-start,
+ * and saves database content in disk.
+ *
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @since 20
+ */
+export declare class PersistenceV2 {
+
+  /**
+   * If used by persistenceV2, module-level storage path, different modules will have their own storage paths.
+   * If the value for the given key is already available, return the value.
+   * If not, add the key with value generated by calling defaultFunc and return it to caller.
+   *
+   * @param { Type } ttype class type of the stored value.
+   * @param { ToJSONType<T> } toJson to Json function.
+   * @param { FromJSONType<T> } fromJson serializable function.
+   * @param { StorageDefaultCreator<T> } [defaultCreator] the function generating the default value
+   * @returns { T | undefined } the value of the existed key or the default value
+   * @static
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  static connect<T extends object>(
+    ttype: Type,
+    toJson: ToJSONType<T>, 
+    fromJson: FromJSONType<T>,
+    defaultCreator?: StorageDefaultCreator<T>
+  ): T | undefined;
+
+  /**
+   * If used by persistenceV2, module-level storage path, different modules will have their own storage paths.
+   * If the value for the given key is already available, return the value.
+   * If not, add the key with value generated by calling defaultFunc and return it to caller.
+   *
+   * @param { Type } ttype class type of the stored value.
+   * @param { string } key - alias name of the key.
+   * @param { ToJSONType<T> } toJson to Json function.
+   * @param { FromJSONType<T> } fromJson serializable function.
+   * @param { StorageDefaultCreator<T> } [defaultCreator] the function generating the default value
+   * @returns { T | undefined } the value of the existed key or the default value
+   * @static
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  static connect<T extends object>(
+    ttype: Type,
+    key: string,
+    toJson: ToJSONType<T>, 
+    fromJson: FromJSONType<T>,
+    defaultCreator?: StorageDefaultCreator<T>
+  ): T | undefined;
+
+  /**
+   * If used by persistenceV2, module-level storage path, different modules will have their own storage paths.
+   * If the value for the given key is already available, return the value.
+   * If not, add the key with value generated by calling defaultFunc and return it to caller.
+   *
+   * @param { Type } ttype class type of the stored value.
+   * @param { StorageDefaultCreator<T> } [defaultCreator] the function generating the default value.
+   * @returns { T | undefined } the value of the existed key or the default value
+   * @static
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  static connect<T extends SerializableObject>(
+    ttype: Type,
+    defaultCreator?: StorageDefaultCreator<T>
+  ): T | undefined;
+
+  /**
+   * If used by persistenceV2, module-level storage path, different modules will have their own storage paths.
+   * If the value for the given key is already available, return the value.
+   * If not, add the key with value generated by calling defaultFunc and return it to caller.
+   *
+   * @param { Type } ttype class type of the stored value.
+   * @param { string } key - alias name of the key.
+   * @param { StorageDefaultCreator<T> } [defaultCreator] the function generating the default value
+   * @returns { T | undefined } the value of the existed key or the default value
+   * @static
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  static connect<T extends SerializableObject>(
+    ttype: Type,
+    key: string,
+    defaultCreator?: StorageDefaultCreator<T>
+  ): T | undefined;
+
+  /**
+   * Application-level storage path, sharing a storage path for all modules under the application.
+   * If the value for the given key is already available, return the value.
+   * If not, add the key with value generated by calling defaultFunc and return it to caller.
+   *
+   * @param { ConnectOptions<T> } connectOptions Application level storage parameters.
+   * @returns { T | undefined } the value of the existed key or the default value
+   * @static
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  static globalConnect<T extends SerializableObject>(connectOptions: ConnectOptions<T>): T | undefined;
+
+  /**
+   * Application-level storage path, sharing a storage path for all modules under the application.
+   * If the value for the given key is already available, return the value.
+   * If not, add the key with value generated by calling defaultFunc and return it to caller.
+   *
+   * @param { ConnectOptions<T> } connectOptions Application level storage parameters.
+   * @param { ToJSONType<T> } toJson to Json function.
+   * @param { FromJSONType<T> } fromJson serializable function.
+   * @returns { T | undefined } the value of the existed key or the default value
+   * @static
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  static globalConnect<T extends object>(connectOptions: ConnectOptions<T>,
+    toJson: ToJSONType<T>, fromJson: FromJSONType<T>): T | undefined;
+
+  /**
+   * Used to manually persist data changes to disks.
+   *
+   * @param { string | Type } keyOrType key or class type need to persist.
+   * @static
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  static save(keyOrType: string | Type): void;
+
+  /**
+   * Be called when persisting has encountered an error.
+   *
+   * @param { PersistenceErrorCallback | undefined } callback called when error
+   * @static
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  static notifyOnError(callback: PersistenceErrorCallback | undefined): void;
+
+  /**
+   * Removes data with the given key or given class type.
+   *
+   * @param { string | Type } keyOrType key or class type removing
+   * @static
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  static remove(keyOrType: string | Type): void;
+
+  /**
+   * Return the array of all keys.
+   *
+   * @returns { Array<string> } the array of all keys
+   * @static
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @since 20
+   */
+  static keys(): Array<string>;
+}
\ No newline at end of file
-- 
Gitee


From 8367f7f81109977a159ed1c499209b3a42dafe3c Mon Sep 17 00:00:00 2001
From: s10021109 <chenbenzhi@huawei.com>
Date: Mon, 8 Sep 2025 14:41:07 +0800
Subject: [PATCH 3/3] =?UTF-8?q?ArkTS1.2=20AppStargeV2=E5=92=8CPersistenceV?=
 =?UTF-8?q?2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: s10021109 <chenbenzhi@huawei.com>
---
 api/@ohos.arkui.stateManagement.d.ets | 11 +----------
 1 file changed, 1 insertion(+), 10 deletions(-)

diff --git a/api/@ohos.arkui.stateManagement.d.ets b/api/@ohos.arkui.stateManagement.d.ets
index 67b9b9fe74..1a579fd671 100644
--- a/api/@ohos.arkui.stateManagement.d.ets
+++ b/api/@ohos.arkui.stateManagement.d.ets
@@ -18,17 +18,9 @@
  * @kit ArkUI
  * @arkts 1.2
  */
-
-export * from './arkui/stateManagement/decorator';
 export * from './arkui/stateManagement/runtime';
-export * from './arkui/stateManagement/storage/appStorage';
 export * from './arkui/stateManagement/storage/appStorageV2';
-export * from './arkui/stateManagement/storage/environment';
-export * from './arkui/stateManagement/storage/localStorage';
 export * from './arkui/stateManagement/storage/persistenceV2';
-export * from './arkui/stateManagement/storage/persistentStorage';
-export * from './arkui/stateManagement/storage/storageProperty';
-export * from './arkui/stateManagement/utils';
 
 export * from './arkui/stateManagement/common';
 
@@ -60,5 +52,4 @@ export * from './arkui/stateManagement/decorators/decoratorWatch';
 
 export * from './arkui/stateManagement/storages/appStorage';
 
-export * from './arkui/stateManagement/storages/localStorage';
-export * from './arkui/stateManagement/remember';
\ No newline at end of file
+export * from './arkui/stateManagement/storages/localStorage';
\ No newline at end of file
-- 
Gitee