@refinedev/core 4.48.0 → 4.49.0

package/src/contexts/notification/types.ts

@@ -0,0 +1,47 @@
+export type SuccessErrorNotification<
+  TData = unknown,
+  TError = unknown,
+  TVariables = unknown,
+> = {
+  /**
+     * Success notification configuration to be displayed when the mutation is successful.
+     * @default '"There was an error creating resource (status code: `statusCode`)" or "Error when updating resource (status code: statusCode)"'
+
+     */
+  successNotification?:
+    | OpenNotificationParams
+    | false
+    | ((
+        data?: TData,
+        values?: TVariables,
+        resource?: string,
+      ) => OpenNotificationParams | false);
+  /**
+   * Error notification configuration to be displayed when the mutation fails.
+   * @default '"There was an error creating resource (status code: `statusCode`)" or "Error when updating resource (status code: statusCode)"'
+   */
+  errorNotification?:
+    | OpenNotificationParams
+    | false
+    | ((
+        error?: TError,
+        values?: TVariables,
+        resource?: string,
+      ) => OpenNotificationParams | false);
+};
+
+export type OpenNotificationParams = {
+  key?: string;
+  message: string;
+  type: "success" | "error" | "progress";
+  description?: string;
+  cancelMutation?: () => void;
+  undoableTimeout?: number;
+};
+
+export interface INotificationContext {
+  open?: (params: OpenNotificationParams) => void;
+  close?: (key: string) => void;
+}
+
+export type NotificationProvider = Required<INotificationContext>;

package/src/contexts/refine/index.tsx

@@ -1,13 +1,15 @@
 import React from "react";
+
 import pluralize from "pluralize";
-import { humanizeString } from "../../definitions/helpers/humanizeString";
 
+import { DefaultLayout } from "@components/layoutWrapper/defaultLayout";
+
+import { humanizeString } from "../../definitions/helpers/humanizeString";
 import {
-  IRefineContextOptions,
   IRefineContext,
+  IRefineContextOptions,
   IRefineContextProvider,
-} from "./IRefineContext";
-import { DefaultLayout } from "@components/layoutWrapper/defaultLayout";
+} from "./types";
 
 import { LoginPage as DefaultLoginPage } from "@components/pages";
 

package/src/contexts/refine/types.ts

@@ -0,0 +1,323 @@
+import React, { ReactNode } from "react";
+
+import { QueryClient, QueryClientConfig } from "@tanstack/react-query";
+
+import { RedirectAction } from "../../hooks/form/types";
+import { UseLoadingOvertimeRefineContext } from "../../hooks/useLoadingOvertime";
+import { AccessControlProvider } from "../accessControl/types";
+import { AuditLogProvider } from "../auditLog/types";
+import { AuthProvider, LegacyAuthProvider } from "../auth/types";
+import { DataProvider, DataProviders, MutationMode } from "../data/types";
+import { I18nProvider } from "../i18n/types";
+import { LiveModeProps, LiveProvider } from "../live/types";
+import { NotificationProvider } from "../notification/types";
+import { ResourceProps } from "../resource/types";
+import { LegacyRouterProvider } from "../router/legacy/types";
+import { RouterProvider } from "../router/types";
+
+export type TitleProps = {
+  collapsed: boolean;
+};
+
+export type LayoutProps = {
+  Sider?: React.FC<{
+    Title?: React.FC<TitleProps>;
+    render?: (props: {
+      items: JSX.Element[];
+      logout: React.ReactNode;
+      dashboard: React.ReactNode;
+      collapsed: boolean;
+    }) => React.ReactNode;
+    meta?: Record<string, unknown>;
+  }>;
+  Header?: React.FC;
+  Title?: React.FC<TitleProps>;
+  Footer?: React.FC;
+  OffLayoutArea?: React.FC;
+  dashboard?: boolean;
+  children?: ReactNode;
+};
+
+export type DashboardPageProps<TCrudData = any> = {
+  initialData?: TCrudData;
+} & Record<any, any>;
+
+export type TextTransformers = {
+  /**
+   * Convert a camelized/dasherized/underscored string into a humanized one
+   * @example
+   * humanize("some_name") => "Some name"
+   */
+  humanize?: (text: string) => string;
+  /**
+   * Pluralize a word
+   * @example
+   * plural('regex') => "regexes"
+   */
+  plural?: (word: string) => string;
+  /**
+   * Singularize a word
+   * @example
+   * singular('singles') => "single"
+   */
+  singular?: (word: string) => string;
+};
+
+export interface IRefineOptions {
+  breadcrumb?: ReactNode;
+  mutationMode?: MutationMode;
+  syncWithLocation?: boolean;
+  warnWhenUnsavedChanges?: boolean;
+  undoableTimeout?: number;
+  liveMode?: LiveModeProps["liveMode"];
+  disableTelemetry?: boolean;
+  redirect?: {
+    afterCreate?: RedirectAction;
+    afterClone?: RedirectAction;
+    afterEdit?: RedirectAction;
+  };
+  reactQuery?: {
+    clientConfig?: QueryClientConfig | InstanceType<typeof QueryClient>;
+    /**
+     * @deprecated `@tanstack/react-query`'s devtools are removed from the core. Please use the `@tanstack/react-query-devtools` package manually in your project. This option will be removed in the next major version and has no effect on the `@tanstack/react-query-devtools` package usage.
+     */
+    devtoolConfig?: any | false;
+  };
+  overtime?: UseLoadingOvertimeRefineContext;
+  textTransformers?: TextTransformers;
+  /**
+   * Disables server-side validation globally for the useForm hook
+   * @default false
+   * @see {@link https://refine.dev/docs/advanced-tutorials/forms/server-side-form-validation/}
+   */
+  disableServerSideValidation?: boolean;
+  /**
+   * The project id of your refine project. Will be set automatically. Don't modify.
+   */
+  projectId?: string;
+  useNewQueryKeys?: boolean;
+}
+
+export interface IRefineContextOptions {
+  breadcrumb?: ReactNode;
+  mutationMode: MutationMode;
+  syncWithLocation: boolean;
+  warnWhenUnsavedChanges: boolean;
+  undoableTimeout: number;
+  liveMode: LiveModeProps["liveMode"];
+  redirect: {
+    afterCreate: RedirectAction;
+    afterClone: RedirectAction;
+    afterEdit: RedirectAction;
+  };
+  overtime: UseLoadingOvertimeRefineContext;
+  textTransformers: Required<TextTransformers>;
+  disableServerSideValidation: boolean;
+  projectId?: string;
+  useNewQueryKeys?: boolean;
+}
+
+export interface IRefineContext {
+  __initialized?: boolean;
+  hasDashboard: boolean;
+  mutationMode: MutationMode;
+  /**
+   * @deprecated Please use `UnsavedChangesNotifier` components from router packages instead.
+   */
+  warnWhenUnsavedChanges: boolean;
+  syncWithLocation: boolean;
+  undoableTimeout: number;
+  catchAll?: React.ReactNode;
+  DashboardPage?: RefineProps["DashboardPage"];
+  LoginPage?: React.FC | false;
+  Title?: React.FC<TitleProps>;
+  Layout: React.FC<LayoutProps>;
+  Sider?: React.FC;
+  Header?: React.FC;
+  Footer?: React.FC;
+  OffLayoutArea?: React.FC;
+  liveMode: LiveModeProps["liveMode"];
+  onLiveEvent?: LiveModeProps["onLiveEvent"];
+  options: IRefineContextOptions;
+}
+
+export interface IRefineContextProvider {
+  __initialized?: boolean;
+  hasDashboard: boolean;
+  mutationMode: MutationMode;
+  warnWhenUnsavedChanges: boolean;
+  syncWithLocation: boolean;
+  undoableTimeout: number;
+  /**
+   * @deprecated Please use the `catchAll` element in your routes instead.
+   */
+  catchAll?: React.ReactNode;
+  /**
+   * @deprecated Please use the `DashboardPage` component in your routes instead.
+   */
+  DashboardPage?: RefineProps["DashboardPage"];
+  /**
+   * @deprecated Please use the `LoginPage` component in your routes instead.
+   */
+  LoginPage?: React.FC | false;
+  /**
+   * @deprecated Please pass the `Title` component to your `Layout` component.
+   */
+  Title?: React.FC<TitleProps>;
+  /**
+   * @deprecated Please use the `Layout` component as a children instead of a prop.
+   */
+  Layout?: React.FC<LayoutProps>;
+  /**
+   * @deprecated Please pass the `Sider` component to your `Layout` component.
+   */
+  Sider?: React.FC;
+  /**
+   * @deprecated Please pass the `Header` component to your `Layout` component.
+   */
+  Header?: React.FC;
+  /**
+   * @deprecated Please pass the `Footer` component to your `Layout` component.
+   */
+  Footer?: React.FC;
+  /**
+   * @deprecated Please use your `OffLayoutArea` component as a children instead of a prop.
+   */
+  OffLayoutArea?: React.FC;
+  liveMode: LiveModeProps["liveMode"];
+  onLiveEvent?: LiveModeProps["onLiveEvent"];
+  options: IRefineContextOptions;
+  children?: ReactNode;
+}
+
+export interface RefineProps {
+  children?: React.ReactNode;
+  /**
+   * `resources` is the predefined interaction points for a refine app. A resource represents an entity in an endpoint in the API.
+   * While this is not a required property, it is used in resource detection and creation of routes for the app.
+   * @type [`ResourceProps[]`](https://refine.dev/docs/api-reference/core/components/refine-config/#resources)
+   */
+  resources?: ResourceProps[];
+  /**
+   * **refine** needs some router functions to create resource pages, handle navigation, etc. This provider allows you to use the router library you want
+   * @type [`IRouterProvider`](https://refine.dev/docs/api-reference/core/providers/router-provider/)
+   * @deprecated This property is deprecated and was the legacy way of routing. Please use `routerProvider` with new router bindings instead.
+   */
+  legacyRouterProvider?: LegacyRouterProvider;
+  /**
+   * Router bindings for **refine**. A simple interface for **refine** to interact with your router in a flexible way.
+   * @type [`RouterProvider`](https://refine.dev/docs/routing/router-provider/)
+   */
+  routerProvider?: RouterProvider;
+  /**
+   * A `dataProvider` is the place where a refine app communicates with an API. Data providers also act as adapters for refine, making it possible for it to consume different API's and data services.
+   * @type [`DataProvider` | `DataProviders`](https://refine.dev/docs/api-reference/core/providers/data-provider/)
+   */
+  dataProvider?: DataProvider | DataProviders;
+  /**
+   * `authProvider` handles authentication logic like login, logout flow and checking user credentials. It is an object with methods that refine uses when necessary.
+   * @type [`AuthProvider`](https://refine.dev/docs/api-reference/core/providers/auth-provider/)
+   */
+  authProvider?: AuthProvider;
+  /**
+   * `legacyAuthProvider` handles authentication logic like login, logout flow and checking user credentials. It is an object with methods that refine uses when necessary.
+   * @type [`AuthProvider`](https://refine.dev/docs/api-reference/core/providers/auth-provider/)
+   * @deprecated `legacyAuthProvider` is deprecated with refine@4, use `authProvider` instead.
+   */
+  legacyAuthProvider?: LegacyAuthProvider;
+  /**
+   * **refine** lets you add Realtime support to your app via `liveProvider`. It can be used to update and show data in Realtime throughout your app.
+   * @type [`LiveProvider`](https://refine.dev/docs/api-reference/core/providers/live-provider/)
+   */
+  liveProvider?: LiveProvider;
+  /**
+   * `notificationProvider` handles notification logics. It is an object with methods that refine uses when necessary.
+   * @type [`NotificationProvider` | `(() => NotificationProvider)`](https://refine.dev/docs/api-reference/core/providers/notification-provider/)
+   */
+  notificationProvider?: NotificationProvider | (() => NotificationProvider);
+  /**
+   * `accessControlProvider` is the entry point for implementing access control for refine apps.
+   * @type [`AccessControlProvider`](https://refine.dev/docs/api-reference/core/providers/accessControl-provider/)
+   */
+  accessControlProvider?: AccessControlProvider;
+  /**
+   * **refine** allows you to track changes in your data and keep track of who made the changes.
+   * @type [`AuditLogProvider`](https://refine.dev/docs/api-reference/core/providers/audit-log-provider#overview)
+   */
+  auditLogProvider?: AuditLogProvider;
+  /**
+   * `i18nProvider` property lets you add i18n support to your app. Making you able to use any i18n framework.
+   * @type [`i18nProvider`](https://refine.dev/docs/api-reference/core/providers/i18n-provider/)
+   */
+  i18nProvider?: I18nProvider;
+  /**
+   * A custom error component.
+   * @type [`ReactNode`](https://refine.dev/docs/api-reference/core/components/refine-config/#catchall)
+   * @deprecated Please use the `catchAll` element in your routes instead.
+   */
+  catchAll?: React.ReactNode;
+  /**
+   * Custom login component can be passed to the `LoginPage` property.
+   * @type [`React.FC`](https://refine.dev/docs/api-reference/core/components/refine-config/#loginpage)
+   * @deprecated Please use the `LoginPage` component in your routes instead.
+   */
+  LoginPage?: React.FC;
+  /**
+   * A custom dashboard page can be passed to the `DashboardPage` prop which is accessible on root route.
+   * @type [`React.FC<DashboardPageProps>`](https://refine.dev/docs/api-reference/core/components/refine-config/#dashboardpage)
+   * @deprecated Please use the `DashboardPage` component in your routes instead.
+   */
+  DashboardPage?: React.FC<DashboardPageProps>;
+  /**
+   * Custom ready page component can be set by passing to `ReadyPage` property.
+   * @type [`React.FC`](https://refine.dev/docs/api-reference/core/components/refine-config/#readypage)
+   * @deprecated This component is only used with the legacy router and will be removed in the future.
+   */
+  ReadyPage?: React.FC;
+  /**
+   * Default layout can be customized by passing the `Layout` property.
+   * @type [`React.FC<LayoutProps>`](https://refine.dev/docs/api-reference/core/components/refine-config/#layout)
+   * @deprecated Please use the `Layout` component as a children instead of a prop.
+   */
+  Layout?: React.FC<LayoutProps>;
+  /**
+   * The default sidebar can be customized by using refine hooks and passing custom components to `Sider` property.
+   * @type [`React.FC`](https://refine.dev/docs/api-reference/core/components/refine-config/#sider)
+   * @deprecated Please pass the `Sider` component to your `Layout` component.
+   */
+  Sider?: React.FC;
+  /**
+   * The default app header can be customized by passing the `Header` property.
+   * @type [`React.FC`](https://refine.dev/docs/api-reference/core/components/refine-config/#header)
+   * @deprecated Please pass the `Header` component to your `Layout` component.
+   */
+  Header?: React.FC;
+  /**
+   *The default app footer can be customized by passing the `Footer` property.
+   * @type [`React.FC`](https://refine.dev/docs/api-reference/core/components/refine-config/#footer)
+   * @deprecated Please pass the `Footer` component to your `Layout` component.
+   */
+  Footer?: React.FC;
+  /**
+   * The component wanted to be placed out of app layout structure can be set by passing to `OffLayoutArea` prop.
+   * @type [`React.FC`](https://refine.dev/docs/api-reference/core/components/refine-config/#offlayoutarea)
+   * @deprecated Please use your `OffLayoutArea` component as a children instead of a prop.
+   */
+  OffLayoutArea?: React.FC;
+  /**
+   * TThe app title can be set by passing the `Title` property.
+   * @type [`React.FC<TitleProps>`](https://refine.dev/docs/api-reference/core/components/refine-config/#title)
+   * @deprecated Please pass the `Title` component to your `Layout` component.
+   */
+  Title?: React.FC<TitleProps>;
+  /**
+   * Callback to handle all live events.
+   * @type [`(event: LiveEvent) => void`](https://refine.dev/docs/api-reference/core/providers/live-provider/#onliveevent)
+   */
+  onLiveEvent?: LiveModeProps["onLiveEvent"];
+  /**
+   * `options` is used to configure the app.
+   * @type [`IRefineOptions`](https://refine.dev/docs/api-reference/core/components/refine-config/#options)
+   * */
+  options?: IRefineOptions;
+}

package/src/contexts/resource/index.tsx

@@ -1,19 +1,9 @@
 import React from "react";
 
-import { IResourceContext } from "./IResourceContext";
-import {
-  IResourceItem,
-  ResourceProps,
-} from "../../interfaces/bindings/resource";
-import { useDeepMemo } from "@hooks/deepMemo";
 import { legacyResourceTransform } from "@definitions/helpers";
+import { useDeepMemo } from "@hooks/deepMemo";
 
-export {
-  IResourceItem,
-  IResourceComponents,
-  IResourceComponentsProps,
-  IResourceContext,
-} from "../../interfaces/bindings/resource";
+import { IResourceContext, IResourceItem, ResourceProps } from "./types";
 
 export const ResourceContext = React.createContext<IResourceContext>({
   resources: [],

package/src/contexts/resource/types.ts

@@ -0,0 +1,205 @@
+import { ComponentType, ReactNode } from "react";
+
+import { UseQueryResult } from "@tanstack/react-query";
+
+import { ILogData } from "../auditLog/types";
+
+/**
+ * Resource route components
+ */
+export type ResourceRouteComponent = ComponentType<
+  IResourceComponentsProps<any, any>
+>;
+
+export type ResourceRoutePath = string;
+
+export type ResourceRouteDefinition = {
+  path: ResourceRoutePath;
+  component: ResourceRouteComponent;
+};
+
+export type ResourceRouteComposition =
+  | ResourceRouteDefinition
+  | ResourceRoutePath
+  | ResourceRouteComponent;
+
+export interface IResourceComponents {
+  list?: ResourceRouteComposition;
+  create?: ResourceRouteComposition;
+  clone?: ResourceRouteComposition;
+  edit?: ResourceRouteComposition;
+  show?: ResourceRouteComposition;
+}
+
+export type AnyString = string & { __ignore?: never };
+
+export type ResourceAuditLogPermissions =
+  | "create"
+  | "update"
+  | "delete"
+  | AnyString;
+
+/** Resource `meta` */
+export interface KnownResourceMeta {
+  /**
+   * This is used when setting the document title, in breadcrumbs and `<Sider />` components.
+   * Therefore it will only work if the related components have implemented the `label` property.
+   */
+  label?: string;
+  /**
+   * Whether to hide the resource from the sidebar or not.
+   * This property is checked by the `<Sider />` components.
+   * Therefore it will only work if the `<Sider />` component has implemented the `hide` property.
+   */
+  hide?: boolean;
+  /**
+   * Dedicated data provider name for the resource.
+   * If not set, the default data provider will be used.
+   * You can use this property to pick a data provider for a resource when you have multiple data providers.
+   */
+  dataProviderName?: string;
+  /**
+   * To nest a resource under another resource, set the parent property to the name of the parent resource.
+   * This will work even if the parent resource is not explicitly defined.
+   */
+  parent?: string;
+  /**
+   * To determine if the resource has ability to delete or not.
+   */
+  canDelete?: boolean;
+  /**
+   * To permit the audit log for actions on the resource.
+   * @default All actions are permitted to be logged.
+   */
+  audit?: ResourceAuditLogPermissions[];
+  /**
+   * To pass `icon` to the resource.
+   */
+  icon?: ReactNode;
+}
+
+export interface DeprecatedOptions {
+  /**
+   * @deprecated Please use `audit` property instead.
+   */
+  auditLog?: {
+    permissions?: ResourceAuditLogPermissions[];
+  };
+  /**
+   * @deprecated Define the route in the resource components instead
+   */
+  route?: string;
+}
+
+export interface ResourceMeta extends KnownResourceMeta {
+  [key: string]: any;
+}
+
+export interface ResourceProps extends IResourceComponents {
+  name: string;
+  /**
+   * This property can be used to identify a resource. In some cases, `name` of the resource might be repeated in different resources.
+   * To avoid conflicts, you pass the `identifier` property to be used as the key of the resource.
+   * @default `name` of the resource
+   */
+  identifier?: string;
+  /**
+   * @deprecated This property is not used anymore.
+   */
+  key?: string;
+  /**
+   * @deprecated Please use the `meta` property instead.
+   */
+  options?: ResourceMeta & DeprecatedOptions;
+  /**
+   * To configure the resource, you can set `meta` properties. You can use `meta` to store any data related to the resource.
+   * There are some known `meta` properties that are used by the core and extension packages.
+   */
+  meta?: ResourceMeta & DeprecatedOptions;
+  /**
+   * @deprecated Please use the `meta.canDelete` property instead.
+   */
+  canDelete?: boolean;
+  /**
+   * @deprecated Please use the `meta.icon` property instead
+   */
+  icon?: ReactNode;
+  /**
+   * @deprecated Please use the `meta.parent` property instead
+   */
+  parentName?: string;
+}
+
+export interface RouteableProperties {
+  /**
+   * @deprecated Please use action props instead.
+   */
+  canCreate?: boolean;
+  /**
+   * @deprecated Please use action props instead.
+   */
+  canEdit?: boolean;
+  /**
+   * @deprecated Please use action props instead.
+   */
+  canShow?: boolean;
+  /**
+   * @deprecated Please use the `meta.canDelete` property instead.
+   */
+  canDelete?: boolean;
+}
+
+export interface IResourceComponentsProps<
+  TCrudData = any,
+  TLogQueryResult = ILogData,
+> extends RouteableProperties {
+  name?: string;
+  initialData?: TCrudData;
+  options?: ResourceMeta & DeprecatedOptions;
+  logQueryResult?: UseQueryResult<TLogQueryResult>;
+}
+
+export interface IResourceItem
+  extends IResourceComponents,
+    RouteableProperties,
+    ResourceProps {
+  /**
+   * @deprecated Please use the `meta.label` property instead.
+   */
+  label?: string;
+  /**
+   * @deprecated Please use action components and `getDefaultActionPath` helper instead.
+   */
+  route?: string;
+}
+
+export interface IResourceContext {
+  resources: IResourceItem[];
+}
+
+export type ResourceBindings = ResourceProps[];
+
+type MetaProps<TExtends = { [key: string]: any }> = ResourceMeta & TExtends;
+
+export interface RouteableProperties {
+  canCreate?: boolean;
+  canEdit?: boolean;
+  canShow?: boolean;
+  canDelete?: boolean;
+  canList?: boolean;
+}
+
+export interface IResourceContext {
+  resources: IResourceItem[];
+}
+
+/* Backward compatible version of 'TreeMenuItem' */
+export type ITreeMenu = IResourceItem & {
+  key?: string;
+  children: ITreeMenu[];
+};
+
+export type IMenuItem = IResourceItem & {
+  key: string;
+  route: string;
+};

package/src/contexts/router/index.tsx

@@ -1,17 +1,18 @@
 import React, { createContext, PropsWithChildren } from "react";
-import { RouterBindings } from "src/interfaces";
+import { RouterProvider } from "./types";
 
-const defaultBindings = {};
+const defaultRouterProvider = {};
 
-export const RouterBindingsContext =
-  createContext<RouterBindings>(defaultBindings);
+export const RouterContext = createContext<RouterProvider>(
+  defaultRouterProvider,
+);
 
-export const RouterBindingsProvider: React.FC<
-  PropsWithChildren<{ router?: RouterBindings }>
+export const RouterContextProvider: React.FC<
+  PropsWithChildren<{ router?: RouterProvider }>
 > = ({ children, router }) => {
   return (
-    <RouterBindingsContext.Provider value={router ?? defaultBindings}>
+    <RouterContext.Provider value={router ?? defaultRouterProvider}>
       {children}
-    </RouterBindingsContext.Provider>
+    </RouterContext.Provider>
   );
 };

package/src/contexts/router/legacy/index.tsx

@@ -0,0 +1,41 @@
+import React, { PropsWithChildren } from "react";
+
+import { ILegacyRouterContext } from "./types";
+
+export const defaultProvider: ILegacyRouterContext = {
+  useHistory: () => false,
+  useLocation: () => false,
+  useParams: () => ({}) as any,
+  Prompt: () => null,
+  Link: () => null,
+};
+
+export const LegacyRouterContext =
+  React.createContext<ILegacyRouterContext>(defaultProvider);
+
+export const LegacyRouterContextProvider: React.FC<
+  PropsWithChildren<Partial<ILegacyRouterContext>>
+> = ({
+  children,
+  useHistory,
+  useLocation,
+  useParams,
+  Prompt,
+  Link,
+  routes,
+}) => {
+  return (
+    <LegacyRouterContext.Provider
+      value={{
+        useHistory: useHistory ?? defaultProvider.useHistory,
+        useLocation: useLocation ?? defaultProvider.useLocation,
+        useParams: useParams ?? defaultProvider.useParams,
+        Prompt: Prompt ?? defaultProvider.Prompt,
+        Link: Link ?? defaultProvider.Link,
+        routes: routes ?? defaultProvider.routes,
+      }}
+    >
+      {children}
+    </LegacyRouterContext.Provider>
+  );
+};