@gooddata/sdk-ui-metric-component 0.0.0-stage → 11.65.0-alpha.4

package/esm/index.js

@@ -0,0 +1,35 @@
+// (C) 2021-2026 GoodData Corporation
+// oxlint-disable no-barrel-files/no-barrel-files
+export { prepareMetricForSaveAs, createDefinitionByMetric, createNewMetricInfo, createEditMetricInfo, createDraftEditMetricInfo, createDraftNewMetricInfo, } from "./MetricComponent/metric/metricHelpers.js";
+export { SaveNameMode, CancelMode } from "./MetricComponent/Content/EditMetricContent.data.js";
+export { emptyMetric, emptyMetricWithId } from "./MetricComponent/metric/emptyMetric.js";
+export { DeleteMetric } from "./MetricComponent/DeleteMetric.js";
+export { EditMetric } from "./MetricComponent/EditMetric.js";
+export { ManageMetric } from "./MetricComponent/ManageMetric.js";
+export { MetricService } from "./MetricComponent/MetricService.js";
+export { ManageMetrics, } from "./MetricComponent/ManageMetrics.js";
+export { MinimizeMetrics } from "./MetricComponent/MinimizedMetrics.js";
+export { MultipleMetricsState } from "./MetricComponent/MultipleMetricsState.js";
+export { MetricInfoKind, CloseAllStatus, } from "./MetricComponent/MetricState/metricState.data.js";
+export { FeaturesAndSettingsContextProvider } from "./MetricComponent/FeaturesAndSettings/index.js";
+export { ConflictContextProvider } from "./MetricComponent/ConflictContext/ConflictContext.js";
+export { SqlEditor } from "./MaqlEditor/sql/SqlEditor.js";
+export { MaqlEditor } from "./MaqlEditor/maql/MaqlEditor.js";
+export { LanguageServiceProvider, } from "./MaqlEditor/languageService/LanguageServiceContext.js";
+export { shimMaqlEditor } from "./MaqlEditor/mock/monaco-shim.js";
+export { IntlWrapper } from "./translations/IntlWrapper.js";
+export { GlobalLoading } from "./shared/GlobalLoading/GlobalLoading.js";
+export { useMetrics } from "./shared/metrics/useMetrics.js";
+export { EventContext, EventContextProvider } from "./shared/eventing/EventContext.js";
+export { Events, EventCategories } from "./shared/eventing/events.js";
+export { contactLink, pricingLink, licenseLink, privacyPolicyLink, supportLink, howToCreateMetricLink, maqlStartingLink, maqlWritingLink, } from "./shared/links.js";
+export { emptyWorkspacePermissions, emptyOrganizationPermissions, } from "./shared/permissions.js";
+export { makeStyles } from "./shared/theme/index.js";
+export { MetricTooltip } from "./shared/MetricTooltip/MetricTooltip.js";
+export { useEvents } from "./shared/eventing/useEvents.js";
+export { useMetricListData, } from "./shared/metrics/useMetricListData.js";
+export { MetricsReloadContextProvider } from "./shared/metrics/MetricsReloadContext.js";
+export { DEFAULT_LANGUAGE, resolveMessages, validateLocaleForMessagesMap, DEFAULT_MESSAGES, } from "./translations/translations.js";
+export { Authentication } from "./shared/authentication/Authentication.js";
+export { initOpenContractExpiredDialog, contractExpiredHandler, } from "./shared/backend/tigerContractExpiredHandler.js";
+export { initOpenNotAuthenticatedOverlay, notAuthenticatedHandler, NotAuthenticatedError, } from "./shared/backend/tigerNotAuthenticatedHandler.js";

package/esm/shared/Form/Form.d.ts

@@ -0,0 +1,25 @@
+import { type ForwardRefExoticComponent, type PropsWithChildren, type ReactNode, type Ref } from "react";
+import { type FormMode } from "./data.js";
+import { type IFormApi } from "./FormApi.js";
+import { type ValidationInfo } from "./hooks/useFormStatusInternal.js";
+export interface IForm<T, S> {
+    data: T;
+    mode?: FormMode;
+    transformer?: (data: T) => T;
+    validator?: (data: T) => ValidationInfo<T, S>;
+    initialFocus?: keyof T;
+    invalidFocus?: (validation: ValidationInfo<T, S>) => keyof T | null;
+    writeable?: boolean;
+    editable?: boolean;
+    locked?: boolean;
+    onSave: (data: T, force?: boolean) => Promise<void>;
+    onSaveAs: (data: T) => Promise<void>;
+    onClose: (data: Partial<T>, valid: boolean) => void;
+    onDirtyChanged?: (state: boolean) => void;
+    onValueChange?: (data: T, valid: boolean) => void;
+    children: ReactNode;
+    ref?: Ref<IFormApi<T> | undefined>;
+}
+export type FormProviderComponent<T, S> = ForwardRefExoticComponent<PropsWithChildren<IForm<T, S>>>;
+export declare const FormProvider: ForwardRefExoticComponent<Omit<IForm<unknown, unknown>, "ref"> & import("react").RefAttributes<IFormApi<unknown> | undefined>>;
+//# sourceMappingURL=Form.d.ts.map

package/esm/shared/Form/Form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Form.d.ts","sourceRoot":"","sources":["../../../src/shared/Form/Form.tsx"],"names":[],"mappings":"AAEA,OAAO,EACH,KAAK,yBAAyB,EAE9B,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,GAAG,EAIX,MAAM,OAAO,CAAC;AAIf,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAW,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAMtD,OAAO,EAAE,KAAK,cAAc,EAAyB,MAAM,kCAAkC,CAAC;AAI9F,MAAM,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE9C,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;IACvB,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,GAAG,IAAI,CAAC;IACpE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACpD,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1C,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAClD,QAAQ,EAAE,SAAS,CAAC;IAEpB,GAAG,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;CACtC;AAED,MAAM,MAAM,qBAAqB,CAAC,CAAC,EAAE,CAAC,IAAI,yBAAyB,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAEpG,eAAO,MAAM,YAAY,gIAuCxB,CAAC"}

package/esm/shared/Form/Form.js

@@ -0,0 +1,48 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// (C) 2022-2026 GoodData Corporation
+import { forwardRef, useEffect, useRef, } from "react";
+import { isEqual } from "lodash-es";
+import { FormApi } from "./FormApi.js";
+import { FormContext } from "./FormContext.js";
+import { useChanged } from "./hooks/useChanged.js";
+import { useDirty } from "./hooks/useDirty.js";
+import { useFormHandlersInternal } from "./hooks/useFormHandlersInternal.js";
+import { useFormState } from "./hooks/useFormState.js";
+import { useFormStatusInternal } from "./hooks/useFormStatusInternal.js";
+import { useMutations } from "./hooks/useMutations.js";
+import { useRealFocus } from "./hooks/useRealFocus.js";
+export const FormProvider = forwardRef(function FormProvider(props, ref) {
+    const { children, data, initialFocus, onDirtyChanged, onValueChange } = props;
+    const [state, setState, getFormState] = useFormState(data, initialFocus);
+    const formHandlers = useFormHandlersInternal(props);
+    const formStatus = useFormStatusInternal(formHandlers, props, state);
+    const { setValues, setChanged, setTouched, setActive, setFocus, setBlur, setSaving } = useMutations(setState);
+    useDirty(formStatus, onDirtyChanged);
+    useRealFocus(formStatus, state, setState);
+    useChanged(formHandlers, formStatus, state, onValueChange);
+    const value = useMemoCompare({
+        ...state,
+        getFormState,
+        formStatus,
+        formHandlers,
+        setValues,
+        setChanged,
+        setTouched,
+        setActive,
+        setFocus,
+        setBlur,
+        setSaving,
+    }, isEqual);
+    return (_jsxs(FormContext.Provider, { value: value, children: [_jsx(FormApi, { ref: ref }), children] }));
+});
+function useMemoCompare(next, compare) {
+    const previousRef = useRef(undefined);
+    const previous = previousRef.current;
+    const isEqual = compare(previous, next);
+    useEffect(() => {
+        if (!isEqual) {
+            previousRef.current = next;
+        }
+    });
+    return isEqual ? previous : next;
+}

package/esm/shared/Form/FormApi.d.ts

@@ -0,0 +1,8 @@
+export interface IFormApi<T> {
+    close: () => void;
+    save: () => Promise<void>;
+    saveAs: () => Promise<void>;
+    saveForce: (data?: Partial<T>) => Promise<void>;
+}
+export declare const FormApi: import("react").ForwardRefExoticComponent<import("react").RefAttributes<IFormApi<unknown> | undefined>>;
+//# sourceMappingURL=FormApi.d.ts.map

package/esm/shared/Form/FormApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormApi.d.ts","sourceRoot":"","sources":["../../../src/shared/Form/FormApi.tsx"],"names":[],"mappings":"AAQA,MAAM,WAAW,QAAQ,CAAC,CAAC;IACvB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAED,eAAO,MAAM,OAAO,yGAelB,CAAC"}

package/esm/shared/Form/FormApi.js

@@ -0,0 +1,14 @@
+// (C) 2022-2026 GoodData Corporation
+import { forwardRef } from "react";
+import { useApi } from "../hooks/useApi.js";
+import { useFormHandlers } from "./useFormHandlers.js";
+export const FormApi = forwardRef(function FormApi(_, ref) {
+    const { onSave, onSaveAs, onClose, onForceSave } = useFormHandlers();
+    useApi(ref, {
+        close: onClose,
+        save: onSave,
+        saveAs: onSaveAs,
+        saveForce: onForceSave,
+    }, [onSave, onSaveAs, onClose, onForceSave]);
+    return null;
+});

package/esm/shared/Form/FormContext.d.ts

@@ -0,0 +1,52 @@
+import { type RefObject } from "react";
+import { type FormHandlers } from "./hooks/useFormHandlersInternal.js";
+import { type FormStatus, type ValidationInfo } from "./hooks/useFormStatusInternal.js";
+export type FormState<T> = {
+    defaultValues: Readonly<T>;
+    currentValues: T;
+    changedValues: {
+        [key in keyof Partial<T>]: boolean;
+    };
+    touchedValues: {
+        [key in keyof Partial<T>]: boolean;
+    };
+    elements: {
+        [key in keyof Partial<T>]: RefObject<HTMLElement | null>;
+    };
+    active: keyof Partial<T> | null;
+    initialFocus: {
+        field: keyof Partial<T> | null;
+        focused: boolean;
+    };
+    isSaving: boolean;
+    submitCount: number;
+};
+export type FormStatusWrapper<T, S> = {
+    formStatus: FormStatus<T, S> | null;
+};
+export type FormHandlersWrapper<T, S> = {
+    formHandlers: FormHandlers<T, S>;
+};
+export type FormMutations<T> = {
+    setValues: (props: Partial<T>) => void;
+    setChanged: (props: {
+        [key in keyof Partial<T>]: boolean;
+    }) => void;
+    setTouched: (props: {
+        [key in keyof Partial<T>]: boolean;
+    }) => void;
+    setActive: (field: keyof Partial<T> | null) => void;
+    setFocus: (field: keyof Partial<T> | null) => void;
+    setBlur: (field: keyof Partial<T> | null) => void;
+    setSaving: (state: boolean) => void;
+};
+export declare const DefaultState: FormState<unknown>;
+export declare const DefaultStatus: FormStatusWrapper<unknown, unknown>;
+export declare const DefaultHandlers: FormHandlersWrapper<unknown, unknown>;
+export type FormContextState<T, S> = FormState<T> & {
+    getFormState: () => FormState<T>;
+} & FormStatusWrapper<T, S> & FormMutations<T> & FormHandlersWrapper<T, S>;
+export declare const FormContext: import("react").Context<FormContextState<unknown, unknown>>;
+export declare function emptyTransformer<T>(data: T): T;
+export declare function emptyValidator<T, S>(): ValidationInfo<T, S>;
+//# sourceMappingURL=FormContext.d.ts.map

package/esm/shared/Form/FormContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormContext.d.ts","sourceRoot":"","sources":["../../../src/shared/Form/FormContext.ts"],"names":[],"mappings":"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"}

package/esm/shared/Form/FormContext.js

@@ -0,0 +1,50 @@
+// (C) 2022-2026 GoodData Corporation
+import { createContext } from "react";
+export const DefaultState = {
+    active: null,
+    initialFocus: { field: null, focused: false },
+    defaultValues: {},
+    currentValues: {},
+    changedValues: {},
+    touchedValues: {},
+    elements: {},
+    isSaving: false,
+    submitCount: 0,
+};
+export const DefaultStatus = {
+    formStatus: null,
+};
+export const DefaultHandlers = {
+    formHandlers: {
+        onClose: () => { },
+        onSave: () => Promise.resolve(),
+        onSaveAs: () => Promise.resolve(),
+        transformer: emptyTransformer,
+        validator: emptyValidator,
+    },
+};
+export const FormContext = createContext({
+    getFormState: () => DefaultState,
+    ...DefaultState,
+    ...DefaultStatus,
+    ...DefaultHandlers,
+    setValues: () => { },
+    setChanged: () => { },
+    setTouched: () => { },
+    setActive: () => { },
+    setFocus: () => { },
+    setBlur: () => { },
+    setSaving: () => { },
+});
+export function emptyTransformer(data) {
+    return data;
+}
+export function emptyValidator() {
+    return {
+        loading: false,
+        errors: [],
+        critical: [],
+        fields: {},
+        specials: {},
+    };
+}

package/esm/shared/Form/data.d.ts

@@ -0,0 +1,5 @@
+export declare enum FormMode {
+    New = "new",
+    Edit = "edit"
+}
+//# sourceMappingURL=data.d.ts.map

package/esm/shared/Form/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../../src/shared/Form/data.ts"],"names":[],"mappings":"AAEA,oBAAY,QAAQ;IAChB,GAAG,QAAQ;IACX,IAAI,SAAS;CAChB"}

package/esm/shared/Form/data.js

@@ -0,0 +1,6 @@
+// (C) 2022-2026 GoodData Corporation
+export var FormMode;
+(function (FormMode) {
+    FormMode["New"] = "new";
+    FormMode["Edit"] = "edit";
+})(FormMode || (FormMode = {}));

package/esm/shared/Form/hooks/useChanged.d.ts

@@ -0,0 +1,5 @@
+import { type FormState } from "../FormContext.js";
+import { type FormHandlers } from "./useFormHandlersInternal.js";
+import { type FormStatus } from "./useFormStatusInternal.js";
+export declare function useChanged<T, S>({ transformer }: FormHandlers<T, S>, { isValid, isLoading }: FormStatus<T, S>, { currentValues }: FormState<T>, onValueChange?: (data: T, valid: boolean) => void): void;
+//# sourceMappingURL=useChanged.d.ts.map

package/esm/shared/Form/hooks/useChanged.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChanged.d.ts","sourceRoot":"","sources":["../../../../src/shared/Form/hooks/useChanged.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,EAC3B,EAAE,WAAW,EAAE,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EACnC,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EACxC,EAAE,aAAa,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,EAC/B,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,GAClD,IAAI,CAWN"}

package/esm/shared/Form/hooks/useChanged.js

@@ -0,0 +1,14 @@
+// (C) 2022-2026 GoodData Corporation
+import { useEffect, useState } from "react";
+import { isChanged } from "../utils.js";
+export function useChanged({ transformer }, { isValid, isLoading }, { currentValues }, onValueChange) {
+    const [data, setData] = useState([currentValues, isValid]);
+    const [previousValues, previousValid] = data;
+    useEffect(() => {
+        const changed = isChanged(previousValues, currentValues, transformer) || previousValid !== isValid;
+        if (onValueChange && changed && !isLoading) {
+            setData([currentValues, isValid]);
+            onValueChange(transformer(currentValues), isValid);
+        }
+    }, [transformer, currentValues, isLoading, isValid, onValueChange, previousValid, previousValues]);
+}

package/esm/shared/Form/hooks/useDirty.d.ts

@@ -0,0 +1,3 @@
+import { type FormStatus } from "./useFormStatusInternal.js";
+export declare function useDirty({ isDirty }: FormStatus<unknown, unknown>, onDirtyChanged?: (state: boolean) => void): void;
+//# sourceMappingURL=useDirty.d.ts.map

package/esm/shared/Form/hooks/useDirty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDirty.d.ts","sourceRoot":"","sources":["../../../../src/shared/Form/hooks/useDirty.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D,wBAAgB,QAAQ,CACpB,EAAE,OAAO,EAAE,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,EACzC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAC1C,IAAI,CAMN"}

package/esm/shared/Form/hooks/useDirty.js

@@ -0,0 +1,9 @@
+// (C) 2022-2026 GoodData Corporation
+import { useEffect } from "react";
+export function useDirty({ isDirty }, onDirtyChanged) {
+    useEffect(() => {
+        if (onDirtyChanged) {
+            onDirtyChanged(isDirty);
+        }
+    }, [onDirtyChanged, isDirty]);
+}

package/esm/shared/Form/hooks/useFormHandlersInternal.d.ts

@@ -0,0 +1,12 @@
+import { type IForm } from "../Form.js";
+import { type ValidationInfo } from "./useFormStatusInternal.js";
+export type FormHandlers<T, S> = {
+    transformer: (data: T) => T;
+    validator: (data: T) => ValidationInfo<T, S>;
+    onSave: (data: T, force?: boolean) => Promise<void>;
+    onSaveAs: (data: T) => Promise<void>;
+    onClose: (data: Partial<T>, valid: boolean) => void;
+    invalidFocus?: (validation: ValidationInfo<T, S>) => keyof T | null;
+};
+export declare function useFormHandlersInternal<T, S>(props: IForm<T, S>): FormHandlers<T, S>;
+//# sourceMappingURL=useFormHandlersInternal.d.ts.map

package/esm/shared/Form/hooks/useFormHandlersInternal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormHandlersInternal.d.ts","sourceRoot":"","sources":["../../../../src/shared/Form/hooks/useFormHandlersInternal.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,CAAC,IAAI;IAC7B,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;IAC5B,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7C,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACpD,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,GAAG,IAAI,CAAC;CACvE,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAEpF"}

package/esm/shared/Form/hooks/useFormHandlersInternal.js

@@ -0,0 +1,16 @@
+// (C) 2022-2026 GoodData Corporation
+import { useMemo } from "react";
+import { emptyTransformer, emptyValidator } from "../FormContext.js";
+export function useFormHandlersInternal(props) {
+    return useFormHandlers(props);
+}
+function useFormHandlers({ onClose, onSaveAs, onSave, transformer = emptyTransformer, validator = emptyValidator, invalidFocus, }) {
+    return useMemo(() => ({
+        onClose,
+        onSaveAs,
+        onSave,
+        invalidFocus,
+        transformer,
+        validator,
+    }), [onClose, onSave, onSaveAs, transformer, validator, invalidFocus]);
+}

package/esm/shared/Form/hooks/useFormState.d.ts

@@ -0,0 +1,4 @@
+import { type Dispatch, type SetStateAction } from "react";
+import { type FormState } from "../FormContext.js";
+export declare function useFormState<T>(data: T, initialFocus?: keyof T): [FormState<T>, Dispatch<SetStateAction<FormState<T>>>, () => FormState<T>];
+//# sourceMappingURL=useFormState.d.ts.map

package/esm/shared/Form/hooks/useFormState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormState.d.ts","sourceRoot":"","sources":["../../../../src/shared/Form/hooks/useFormState.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,cAAc,EAA4C,MAAM,OAAO,CAAC;AAErG,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEjE,wBAAgB,YAAY,CAAC,CAAC,EAC1B,IAAI,EAAE,CAAC,EACP,YAAY,CAAC,EAAE,MAAM,CAAC,GACvB,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC,CAAC,CAkC5E"}

package/esm/shared/Form/hooks/useFormState.js

@@ -0,0 +1,33 @@
+// (C) 2022-2026 GoodData Corporation
+import { useCallback, useEffect, useRef, useState } from "react";
+import { DefaultState } from "../FormContext.js";
+export function useFormState(data, initialFocus) {
+    const [state, setState] = useState({
+        ...DefaultState,
+        defaultValues: { ...data },
+        currentValues: { ...data },
+        initialFocus: {
+            field: initialFocus || null,
+            focused: false,
+        },
+    });
+    const stateRef = useRef(state);
+    useEffect(() => {
+        stateRef.current = state;
+    }, [state]);
+    const getState = useCallback(() => stateRef.current, []);
+    //reset occurred
+    useEffect(() => {
+        setState({
+            ...DefaultState,
+            defaultValues: { ...state.defaultValues },
+            currentValues: { ...data },
+            initialFocus: {
+                field: initialFocus || null,
+                focused: false,
+            },
+        });
+        // oxlint-disable-next-line react-hooks/exhaustive-deps
+    }, [initialFocus, data]);
+    return [state, setState, getState];
+}

package/esm/shared/Form/hooks/useFormStatusInternal.d.ts

@@ -0,0 +1,32 @@
+import { type ValidationError } from "yup";
+import { FormMode } from "../data.js";
+import { type IForm } from "../Form.js";
+import { type FormState } from "../FormContext.js";
+import { type FormHandlers } from "./useFormHandlersInternal.js";
+export type FormStatus<T, S> = {
+    mode: FormMode;
+    isWriteable: boolean;
+    isEditable: boolean;
+    isReadOnly: boolean;
+    isError: boolean;
+    isValid: boolean;
+    validation: ValidationInfo<T, S>;
+    isLocked: boolean;
+    isDirty: boolean;
+    isLoading: boolean;
+    isSaving: boolean;
+    isSaveAsDisabled: boolean;
+    isSaveDisabled: boolean;
+    submitCount: number;
+};
+export type ValidationInfo<T, S> = {
+    loading: boolean;
+    errors: ValidationError[];
+    critical: ValidationError[];
+    fields: {
+        [key in keyof Partial<T>]: string;
+    };
+    specials: S;
+};
+export declare function useFormStatusInternal<T, S>(handlers: FormHandlers<T, S>, props: IForm<T, S>, state: FormState<T>): FormStatus<T, S>;
+//# sourceMappingURL=useFormStatusInternal.d.ts.map

package/esm/shared/Form/hooks/useFormStatusInternal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormStatusInternal.d.ts","sourceRoot":"","sources":["../../../../src/shared/Form/hooks/useFormStatusInternal.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,KAAK,CAAC;AAE3C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,IAAI;IAC3B,IAAI,EAAE,QAAQ,CAAC;IAEf,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IAEpB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEjC,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,CAAC,EAAE,CAAC,IAAI;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,MAAM,EAAE;SAAG,GAAG,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM;KAAE,CAAC;IAC9C,QAAQ,EAAE,CAAC,CAAC;CACf,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,CAAC,EACtC,QAAQ,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EAC5B,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAClB,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GACpB,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAElB"}

package/esm/shared/Form/hooks/useFormStatusInternal.js

@@ -0,0 +1,34 @@
+// (C) 2022-2026 GoodData Corporation
+import { useMemo } from "react";
+import { FormMode } from "../data.js";
+import { isChanged } from "../utils.js";
+export function useFormStatusInternal(handlers, props, state) {
+    return useStatus(handlers, props, state);
+}
+function useStatus({ transformer, validator }, { writeable = true, editable = true, locked = false, mode = FormMode.New }, { defaultValues, currentValues, isSaving, submitCount }) {
+    const isDirty = isChanged(defaultValues, currentValues, transformer);
+    const validation = useMemo(() => validator(currentValues), [currentValues, validator]);
+    const isEditable = !locked && editable;
+    const isReadOnly = !isEditable;
+    const isError = validation.errors.length > 0;
+    const isValid = !isError;
+    const isLoading = isSaving || validation.loading;
+    const isSaveAsDisabled = isError || isLoading;
+    const isSaveDisabled = isSaveAsDisabled || (!isDirty && mode !== FormMode.New);
+    return {
+        mode,
+        isWriteable: writeable,
+        isEditable,
+        isReadOnly,
+        isError,
+        isValid,
+        validation,
+        isLocked: locked,
+        isDirty,
+        isLoading,
+        isSaving,
+        isSaveAsDisabled,
+        isSaveDisabled,
+        submitCount,
+    };
+}

package/esm/shared/Form/hooks/useInvalidFocusField.d.ts

@@ -0,0 +1,3 @@
+import { type ValidationInfo } from "./useFormStatusInternal.js";
+export declare function useInvalidFocusField<T, S>(invalidFocus?: (validation: ValidationInfo<T, S>) => keyof T | null): keyof T | null;
+//# sourceMappingURL=useInvalidFocusField.d.ts.map

package/esm/shared/Form/hooks/useInvalidFocusField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInvalidFocusField.d.ts","sourceRoot":"","sources":["../../../../src/shared/Form/hooks/useInvalidFocusField.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,CAAC,EACrC,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,GAAG,IAAI,GACpE,MAAM,CAAC,GAAG,IAAI,CAKhB"}

package/esm/shared/Form/hooks/useInvalidFocusField.js

@@ -0,0 +1,8 @@
+// (C) 2022-2026 GoodData Corporation
+import { useContext } from "react";
+import { FormContext } from "../FormContext.js";
+export function useInvalidFocusField(invalidFocus) {
+    const { formStatus } = useContext(FormContext);
+    const { validation } = formStatus || {};
+    return invalidFocus && validation ? invalidFocus(validation) : null;
+}

package/esm/shared/Form/hooks/useMutations.d.ts

@@ -0,0 +1,4 @@
+import { type Dispatch, type SetStateAction } from "react";
+import { type FormMutations, type FormState } from "../FormContext.js";
+export declare function useMutations<T>(setState: Dispatch<SetStateAction<FormState<T>>>): FormMutations<T>;
+//# sourceMappingURL=useMutations.d.ts.map

package/esm/shared/Form/hooks/useMutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMutations.d.ts","sourceRoot":"","sources":["../../../../src/shared/Form/hooks/useMutations.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAe,MAAM,OAAO,CAAC;AAExE,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEvE,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CA0HlG"}

package/esm/shared/Form/hooks/useMutations.js

@@ -0,0 +1,97 @@
+// (C) 2022-2026 GoodData Corporation
+import { useCallback } from "react";
+export function useMutations(setState) {
+    const setValues = useCallback((props) => {
+        setState((state) => {
+            return {
+                ...state,
+                currentValues: {
+                    ...state.currentValues,
+                    ...props,
+                },
+            };
+        });
+    }, [setState]);
+    const setChanged = useCallback((props) => {
+        setState((state) => {
+            return {
+                ...state,
+                changedValues: {
+                    ...state.changedValues,
+                    ...props,
+                },
+            };
+        });
+    }, [setState]);
+    const setTouched = useCallback((props) => {
+        setState((state) => {
+            return {
+                ...state,
+                touchedValues: {
+                    ...state.touchedValues,
+                    ...props,
+                },
+            };
+        });
+    }, [setState]);
+    const setActive = useCallback((active) => {
+        setState((state) => {
+            return {
+                ...state,
+                active,
+            };
+        });
+    }, [setState]);
+    const setSaving = useCallback((isSaving) => {
+        setState((state) => {
+            return {
+                ...state,
+                isSaving,
+                ...(isSaving
+                    ? {
+                        submitCount: state.submitCount + 1,
+                    }
+                    : {}),
+            };
+        });
+    }, [setState]);
+    const setFocus = useCallback((field) => {
+        setState((state) => {
+            //same field, do nothing
+            if (state.initialFocus.field === field) {
+                return state;
+            }
+            return {
+                ...state,
+                initialFocus: {
+                    field,
+                    focused: false,
+                },
+            };
+        });
+    }, [setState]);
+    const setBlur = useCallback((field) => {
+        setState((state) => {
+            //same field, do nothing
+            if (state.initialFocus.field !== field) {
+                return state;
+            }
+            return {
+                ...state,
+                initialFocus: {
+                    field: null,
+                    focused: false,
+                },
+            };
+        });
+    }, [setState]);
+    return {
+        setValues,
+        setChanged,
+        setTouched,
+        setActive,
+        setFocus,
+        setBlur,
+        setSaving,
+    };
+}

package/esm/shared/Form/hooks/useRealFocus.d.ts

@@ -0,0 +1,5 @@
+import { type Dispatch, type SetStateAction } from "react";
+import { type FormState } from "../FormContext.js";
+import { type FormStatus } from "./useFormStatusInternal.js";
+export declare function useRealFocus<T>({ isReadOnly }: FormStatus<T, unknown>, state: FormState<T>, setState: Dispatch<SetStateAction<FormState<T>>>): void;
+//# sourceMappingURL=useRealFocus.d.ts.map

package/esm/shared/Form/hooks/useRealFocus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRealFocus.d.ts","sourceRoot":"","sources":["../../../../src/shared/Form/hooks/useRealFocus.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAyB,KAAK,cAAc,EAAqB,MAAM,OAAO,CAAC;AAErG,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D,wBAAgB,YAAY,CAAC,CAAC,EAC1B,EAAE,UAAU,EAAE,EAAE,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC,EACtC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GACjD,IAAI,CAaN"}