@lumeweb/portal-framework-ui 0.0.1 → 0.1.1

package/dist/esm/components/shared/types/form.js

@@ -0,0 +1,47 @@
+//#region src/components/shared/types/form.ts
+/**
+* Enum representing the different types of forms
+*/
+let FormType = /* @__PURE__ */ function(FormType) {
+	/**
+	* Simple form type
+	*/
+	FormType["SIMPLE"] = "simple";
+	/**
+	* Step form type
+	*/
+	FormType["STEP"] = "step";
+	/**
+	* Wizard form type
+	*/
+	FormType["WIZARD"] = "wizard";
+	return FormType;
+}({});
+/**
+* Type guard to check if a form environment is a simple form
+* @param ctx - The form environment to check
+* @returns True if the form environment is a simple form, false otherwise
+*/
+function isSimpleForm(ctx) {
+	return ctx?.type === "simple";
+}
+/**
+* Type guard to check if a form environment is a step form
+* @param ctx - The form environment to check
+* @returns True if the form environment is a step form, false otherwise
+*/
+function isStepForm(ctx) {
+	return ctx?.type === "step";
+}
+/**
+* Type guard to check if a form environment is a wizard form
+* @param ctx - The form environment to check
+* @returns True if the form environment is a wizard form, false otherwise
+*/
+function isWizardForm(ctx) {
+	return ctx?.type === "wizard";
+}
+
+//#endregion
+export { FormType, isSimpleForm, isStepForm, isWizardForm };
+//# sourceMappingURL=form.js.map

package/dist/esm/components/shared/types/form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.js","names":[],"sources":["../../../../../src/components/shared/types/form.ts"],"sourcesContent":["/**\n * Type for the force rerender method that can be called to trigger a component rerender\n */\nexport type ForceRerenderMethod = () => void;\n\n/**\n * Callback function type for receiving the force rerender method\n * This is a \"reverse callback\" where the framework calls this callback with a method\n * that can be stored locally and used to force a rerender when something outside\n * the render loop needs it\n */\nexport type ForceRerenderCallback = (\n  forceRerender: ForceRerenderMethod,\n) => void;\n\n/**\n * Callback function type for receiving environment updates\n * This is a callback that can be called directly with the environment\n * when it needs to be synced\n */\nexport type EnvironmentSyncCallback = (environment: UnifiedEnvironment) => void;\n\n/**\n * Enum representing the different types of forms\n */\nexport enum FormType {\n  /**\n   * Simple form type\n   */\n  SIMPLE = \"simple\",\n  /**\n   * Step form type\n   */\n  STEP = \"step\",\n  /**\n   * Wizard form type\n   */\n  WIZARD = \"wizard\",\n}\n\n/**\n * Union type representing any form environment\n */\nexport type AnyFormEnvironment =\n  | SimpleFormEnvironment\n  | StepFormEnvironment\n  | WizardFormEnvironment;\n\n/**\n * Base interface for form environment\n */\nexport interface FormEnvironment {\n  /**\n   * The type of form\n   */\n  type: FormType;\n}\n\n/**\n * Interface representing a simple form environment\n */\nexport interface SimpleFormEnvironment extends FormEnvironment {\n  /**\n   * Whether the form is currently submitting\n   */\n  isSubmitting?: boolean;\n  /**\n   * React Hook Form methods\n   */\n  methods: any;\n  /**\n   * The type of form (simple)\n   */\n  type: FormType.SIMPLE;\n}\n\n/**\n * Interface representing a step form environment\n */\nexport interface StepFormEnvironment extends FormEnvironment {\n  /**\n   * Whether the form is currently submitting\n   */\n  isSubmitting?: boolean;\n  /**\n   * React Hook Form methods\n   */\n  methods: any;\n  /**\n   * The type of form (step)\n   */\n  type: FormType.STEP;\n}\n\n/**\n * Interface representing a wizard form environment\n */\nexport interface WizardFormEnvironment extends FormEnvironment {\n  /**\n   * Whether the form is currently submitting\n   */\n  isSubmitting: boolean;\n  /**\n   * React Hook Form methods\n   */\n  methods: any;\n  /**\n   * The type of form (wizard)\n   */\n  type: FormType.WIZARD;\n}\n\n/**\n * Type guard to check if a form environment is a simple form\n * @param ctx - The form environment to check\n * @returns True if the form environment is a simple form, false otherwise\n */\nexport function isSimpleForm(\n  ctx: AnyFormEnvironment | undefined,\n): ctx is SimpleFormEnvironment {\n  return ctx?.type === FormType.SIMPLE;\n}\n\n/**\n * Type guard to check if a form environment is a step form\n * @param ctx - The form environment to check\n * @returns True if the form environment is a step form, false otherwise\n */\nexport function isStepForm(\n  ctx: AnyFormEnvironment | undefined,\n): ctx is StepFormEnvironment {\n  return ctx?.type === FormType.STEP;\n}\n\n/**\n * Type guard to check if a form environment is a wizard form\n * @param ctx - The form environment to check\n * @returns True if the form environment is a wizard form, false otherwise\n */\nexport function isWizardForm(\n  ctx: AnyFormEnvironment | undefined,\n): ctx is WizardFormEnvironment {\n  return ctx?.type === FormType.WIZARD;\n}\n"],"mappings":";;;;AAyBA,IAAY,WAAL;;;;AAIL;;;;AAIA;;;;AAIA;;KACD;;;;;;AA+ED,SAAgB,aACd,KAC8B;AAC9B,QAAO,KAAK;;;;;;;AAQd,SAAgB,WACd,KAC4B;AAC5B,QAAO,KAAK;;;;;;;AAQd,SAAgB,aACd,KAC8B;AAC9B,QAAO,KAAK"}

package/dist/esm/components/shared/types/header.d.ts

@@ -0,0 +1,81 @@
+import { ActionItemConfig } from "../../actions/types.js";
+import { AnyContainerEnvironment } from "./container.js";
+import { AllowStepNavigation } from "./navigation.js";
+import { WizardStepDefinition } from "../../form/types.js";
+import { BaseRecord } from "@refinedev/core";
+
+//#region src/components/shared/types/header.d.ts
+declare enum NavigationType {
+  NONE = "none",
+  STEP = "step",
+  WIZARD = "wizard"
+}
+declare enum ProgressStyleType {
+  DOTS = "dots",
+  STEPPER = "stepper",
+  TIMELINE = "timeline"
+}
+type AnyNavigationEnvironment = NoneNavigationEnvironment | StepNavigationEnvironment | WizardNavigationEnvironment;
+interface BaseHeaderProps<T extends BaseRecord = any> {
+  actionButtons?: ActionItemConfig[];
+  className?: string;
+  description?: string;
+  environment: HeaderEnvironment<T>;
+  title?: string;
+}
+interface HeaderContent {
+  actionButtons?: ActionItemConfig[];
+  description?: string;
+  title?: string;
+}
+interface HeaderEnvironment<T extends BaseRecord = any> {
+  container: AnyContainerEnvironment;
+  content: HeaderContent;
+  navigation: AnyNavigationEnvironment;
+}
+interface NavigationEnvironment {
+  current?: number;
+  progressStyle?: ProgressStyleType;
+  showStepDescriptions?: boolean;
+  showStepTitles?: boolean;
+  total?: number;
+  type: NavigationType;
+}
+interface NoneNavigationEnvironment extends NavigationEnvironment {
+  type: NavigationType.NONE;
+}
+interface StepNavigationEnvironment extends NavigationEnvironment {
+  current?: number;
+  total?: number;
+  type: NavigationType.STEP;
+}
+interface WizardNavigationEnvironment extends NavigationEnvironment {
+  allowNavigation?: AllowStepNavigation;
+  current: number;
+  descriptionMaxWidth?: string;
+  disabledSteps?: number[];
+  iconSize?: string;
+  onStepClick?: (stepIndex: number) => void;
+  progressStyle: ProgressStyleType;
+  showStepDescriptions: boolean;
+  showStepTitles: boolean;
+  steps?: WizardStepDefinition[];
+  total: number;
+  type: NavigationType.WIZARD;
+}
+declare function hasNavigation(ctx: HeaderEnvironment): ctx is HeaderEnvironment & {
+  navigation: StepNavigationEnvironment | WizardNavigationEnvironment;
+};
+declare function isNoneNavigation(ctx: AnyNavigationEnvironment): ctx is NoneNavigationEnvironment;
+declare function isStepHeaderEnvironment<T extends BaseRecord = any>(ctx: HeaderEnvironment<T>): ctx is HeaderEnvironment<T> & {
+  navigation: StepNavigationEnvironment;
+};
+declare function isStepNavigation(ctx: AnyNavigationEnvironment): ctx is StepNavigationEnvironment;
+declare function isWizardHeaderEnvironment<T extends BaseRecord = any>(ctx: HeaderEnvironment<T>): ctx is HeaderEnvironment<T> & {
+  navigation: WizardNavigationEnvironment;
+};
+declare function getEffectiveAllowNavigation(wizardEnv: WizardNavigationEnvironment): boolean | (() => boolean);
+declare function isWizardNavigation(ctx: AnyNavigationEnvironment): ctx is WizardNavigationEnvironment;
+//#endregion
+export { AnyNavigationEnvironment, BaseHeaderProps, HeaderContent, HeaderEnvironment, NavigationEnvironment, NavigationType, NoneNavigationEnvironment, ProgressStyleType, StepNavigationEnvironment, WizardNavigationEnvironment, getEffectiveAllowNavigation, hasNavigation, isNoneNavigation, isStepHeaderEnvironment, isStepNavigation, isWizardHeaderEnvironment, isWizardNavigation };
+//# sourceMappingURL=header.d.ts.map

package/dist/esm/components/shared/types/header.js

@@ -0,0 +1,38 @@
+//#region src/components/shared/types/header.ts
+let NavigationType = /* @__PURE__ */ function(NavigationType) {
+	NavigationType["NONE"] = "none";
+	NavigationType["STEP"] = "step";
+	NavigationType["WIZARD"] = "wizard";
+	return NavigationType;
+}({});
+let ProgressStyleType = /* @__PURE__ */ function(ProgressStyleType) {
+	ProgressStyleType["DOTS"] = "dots";
+	ProgressStyleType["STEPPER"] = "stepper";
+	ProgressStyleType["TIMELINE"] = "timeline";
+	return ProgressStyleType;
+}({});
+function hasNavigation(ctx) {
+	return ctx.navigation.type !== "none";
+}
+function isNoneNavigation(ctx) {
+	return ctx.type === "none";
+}
+function isStepHeaderEnvironment(ctx) {
+	return ctx.navigation.type === "step";
+}
+function isStepNavigation(ctx) {
+	return ctx.type === "step";
+}
+function isWizardHeaderEnvironment(ctx) {
+	return ctx.navigation.type === "wizard";
+}
+function getEffectiveAllowNavigation(wizardEnv) {
+	return wizardEnv.allowNavigation ?? true;
+}
+function isWizardNavigation(ctx) {
+	return ctx.type === "wizard";
+}
+
+//#endregion
+export { NavigationType, ProgressStyleType, getEffectiveAllowNavigation, hasNavigation, isNoneNavigation, isStepHeaderEnvironment, isStepNavigation, isWizardHeaderEnvironment, isWizardNavigation };
+//# sourceMappingURL=header.js.map

package/dist/esm/components/shared/types/header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.js","names":[],"sources":["../../../../../src/components/shared/types/header.ts"],"sourcesContent":["import type { BaseRecord } from \"@refinedev/core\";\n\nimport type { WizardStepDefinition } from \"../../form/types\";\n\nimport { ActionItemConfig } from \"../../actions\";\nimport { AnyContainerEnvironment } from \"./container\";\nimport type { AllowStepNavigation } from \"./navigation\";\n\nexport enum NavigationType {\n  NONE = \"none\",\n  STEP = \"step\",\n  WIZARD = \"wizard\",\n}\n\nexport enum ProgressStyleType {\n  DOTS = \"dots\",\n  STEPPER = \"stepper\",\n  TIMELINE = \"timeline\",\n}\n\nexport type AnyNavigationEnvironment =\n  | NoneNavigationEnvironment\n  | StepNavigationEnvironment\n  | WizardNavigationEnvironment;\n\nexport interface BaseHeaderProps<T extends BaseRecord = any> {\n  actionButtons?: ActionItemConfig[];\n  className?: string;\n  description?: string;\n  environment: HeaderEnvironment<T>;\n  title?: string;\n}\n\nexport interface HeaderContent {\n  actionButtons?: ActionItemConfig[];\n  description?: string;\n  title?: string;\n}\n\nexport interface HeaderEnvironment<T extends BaseRecord = any> {\n  container: AnyContainerEnvironment;\n  content: HeaderContent;\n  navigation: AnyNavigationEnvironment;\n}\n\nexport interface NavigationEnvironment {\n  current?: number;\n  progressStyle?: ProgressStyleType;\n  showStepDescriptions?: boolean;\n  showStepTitles?: boolean;\n  total?: number;\n  type: NavigationType;\n}\n\nexport interface NoneNavigationEnvironment extends NavigationEnvironment {\n  type: NavigationType.NONE;\n}\n\nexport interface StepNavigationEnvironment extends NavigationEnvironment {\n  current?: number;\n  total?: number;\n  type: NavigationType.STEP;\n}\n\n// createHeaderContext function is now in context/builders.ts\n\nexport interface WizardNavigationEnvironment extends NavigationEnvironment {\n  allowNavigation?: AllowStepNavigation;\n  current: number;\n  descriptionMaxWidth?: string;\n  disabledSteps?: number[];\n  iconSize?: string;\n  onStepClick?: (stepIndex: number) => void;\n  progressStyle: ProgressStyleType;\n  showStepDescriptions: boolean;\n  showStepTitles: boolean;\n  steps?: WizardStepDefinition[];\n  total: number;\n  type: NavigationType.WIZARD;\n}\n\n// Combined type guards for header environment\nexport function hasNavigation(\n  ctx: HeaderEnvironment,\n): ctx is HeaderEnvironment & {\n  navigation: StepNavigationEnvironment | WizardNavigationEnvironment;\n} {\n  return ctx.navigation.type !== NavigationType.NONE;\n}\n\nexport function isNoneNavigation(\n  ctx: AnyNavigationEnvironment,\n): ctx is NoneNavigationEnvironment {\n  return ctx.type === NavigationType.NONE;\n}\n\nexport function isStepHeaderEnvironment<T extends BaseRecord = any>(\n  ctx: HeaderEnvironment<T>,\n): ctx is HeaderEnvironment<T> & { navigation: StepNavigationEnvironment } {\n  return ctx.navigation.type === NavigationType.STEP;\n}\n\nexport function isStepNavigation(\n  ctx: AnyNavigationEnvironment,\n): ctx is StepNavigationEnvironment {\n  return ctx.type === NavigationType.STEP;\n}\n\nexport function isWizardHeaderEnvironment<T extends BaseRecord = any>(\n  ctx: HeaderEnvironment<T>,\n): ctx is HeaderEnvironment<T> & { navigation: WizardNavigationEnvironment } {\n  return ctx.navigation.type === NavigationType.WIZARD;\n}\n\n// Helper function to determine effective allowNavigation for wizard\nexport function getEffectiveAllowNavigation(\n  wizardEnv: WizardNavigationEnvironment\n): boolean | (() => boolean) {\n  return wizardEnv.allowNavigation ?? true;\n}\n\n// Type guards for navigation environment\nexport function isWizardNavigation(\n  ctx: AnyNavigationEnvironment,\n): ctx is WizardNavigationEnvironment {\n  return ctx.type === NavigationType.WIZARD;\n}\n"],"mappings":";AAQA,IAAY,iBAAL;AACL;AACA;AACA;;KACD;AAED,IAAY,oBAAL;AACL;AACA;AACA;;KACD;AAgED,SAAgB,cACd,KAGA;AACA,QAAO,IAAI,WAAW;;AAGxB,SAAgB,iBACd,KACkC;AAClC,QAAO,IAAI;;AAGb,SAAgB,wBACd,KACyE;AACzE,QAAO,IAAI,WAAW;;AAGxB,SAAgB,iBACd,KACkC;AAClC,QAAO,IAAI;;AAGb,SAAgB,0BACd,KAC2E;AAC3E,QAAO,IAAI,WAAW;;AAIxB,SAAgB,4BACd,WAC2B;AAC3B,QAAO,UAAU,mBAAmB;;AAItC,SAAgB,mBACd,KACoC;AACpC,QAAO,IAAI"}

package/dist/esm/components/shared/types/index.d.ts

@@ -0,0 +1,8 @@
+import { AnyContainerEnvironment, ContainerEnvironment, ContainerType, DialogContainerEnvironment, StandaloneContainerEnvironment, isDialogContainer, isStandaloneContainer } from "./container.js";
+import { AnyFormEnvironment, EnvironmentSyncCallback, ForceRerenderCallback, ForceRerenderMethod, FormEnvironment, FormType, SimpleFormEnvironment, StepFormEnvironment, WizardFormEnvironment, isSimpleForm, isStepForm, isWizardForm } from "./form.js";
+import { StepEnvironment, createStepEnvironment } from "./step.js";
+import { UnifiedEnvironment } from "./environment.js";
+import { AllowStepNavigation } from "./navigation.js";
+import { BaseFooterProps, FooterEnvironment, FormFooterProps, hasStepEnvironment, isDialogFooterEnvironment, isSimpleFooterEnvironment, isStandaloneFooterEnvironment, isStepFooterEnvironment, isWizardFooterEnvironment } from "./footer.js";
+import { AnyNavigationEnvironment, BaseHeaderProps, HeaderContent, HeaderEnvironment, NavigationEnvironment, NavigationType, NoneNavigationEnvironment, ProgressStyleType, StepNavigationEnvironment, WizardNavigationEnvironment, getEffectiveAllowNavigation, hasNavigation, isNoneNavigation, isStepHeaderEnvironment, isStepNavigation, isWizardHeaderEnvironment, isWizardNavigation } from "./header.js";
+export { AllowStepNavigation, AnyContainerEnvironment, AnyFormEnvironment, AnyNavigationEnvironment, BaseFooterProps, BaseHeaderProps, ContainerEnvironment, ContainerType, DialogContainerEnvironment, EnvironmentSyncCallback, FooterEnvironment, ForceRerenderCallback, ForceRerenderMethod, FormEnvironment, FormFooterProps, FormType, HeaderContent, HeaderEnvironment, NavigationEnvironment, NavigationType, NoneNavigationEnvironment, ProgressStyleType, SimpleFormEnvironment, StandaloneContainerEnvironment, StepEnvironment, StepFormEnvironment, StepNavigationEnvironment, UnifiedEnvironment, WizardFormEnvironment, WizardNavigationEnvironment, createStepEnvironment, getEffectiveAllowNavigation, hasNavigation, hasStepEnvironment, isDialogContainer, isDialogFooterEnvironment, isNoneNavigation, isSimpleFooterEnvironment, isSimpleForm, isStandaloneContainer, isStandaloneFooterEnvironment, isStepFooterEnvironment, isStepForm, isStepHeaderEnvironment, isStepNavigation, isWizardFooterEnvironment, isWizardForm, isWizardHeaderEnvironment, isWizardNavigation };

package/dist/esm/components/shared/types/index.js

@@ -0,0 +1,7 @@
+import { ContainerType, isDialogContainer, isStandaloneContainer } from "./container.js";
+import { FormType, isSimpleForm, isStepForm, isWizardForm } from "./form.js";
+import { NavigationType, ProgressStyleType, getEffectiveAllowNavigation, hasNavigation, isNoneNavigation, isStepHeaderEnvironment, isStepNavigation, isWizardHeaderEnvironment, isWizardNavigation } from "./header.js";
+import { hasStepEnvironment, isDialogFooterEnvironment, isSimpleFooterEnvironment, isStandaloneFooterEnvironment, isStepFooterEnvironment, isWizardFooterEnvironment } from "./footer.js";
+import { createStepEnvironment } from "./step.js";
+
+export { ContainerType, FormType, NavigationType, ProgressStyleType, createStepEnvironment, getEffectiveAllowNavigation, hasNavigation, hasStepEnvironment, isDialogContainer, isDialogFooterEnvironment, isNoneNavigation, isSimpleFooterEnvironment, isSimpleForm, isStandaloneContainer, isStandaloneFooterEnvironment, isStepFooterEnvironment, isStepForm, isStepHeaderEnvironment, isStepNavigation, isWizardFooterEnvironment, isWizardForm, isWizardHeaderEnvironment, isWizardNavigation };

package/dist/esm/components/shared/types/navigation.d.ts

@@ -0,0 +1,9 @@
+//#region src/components/shared/types/navigation.d.ts
+/**
+ * Type for controlling step navigation in wizards
+ * Can be a boolean value or a function that returns a boolean
+ */
+type AllowStepNavigation = boolean | (() => boolean);
+//#endregion
+export { AllowStepNavigation };
+//# sourceMappingURL=navigation.d.ts.map

package/dist/esm/components/shared/types/step.d.ts

@@ -0,0 +1,104 @@
+//#region src/components/shared/types/step.d.ts
+/**
+ * Interface representing the environment for a step component
+ */
+interface StepEnvironment {
+  /**
+   * The current step number (1-indexed)
+   */
+  current: number;
+  /**
+   * Whether the current step is the first step
+   */
+  isFirst: boolean;
+  /**
+   * Whether the current step is the last step
+   */
+  isLast: boolean;
+  /**
+   * Callback function to move to the next step
+   * @returns Promise that resolves when the next step operation is complete
+   */
+  onNext?: () => Promise<void>;
+  /**
+   * Callback function to move to the previous step
+   * @returns Promise that resolves when the previous step operation is complete
+   */
+  onPrevious?: () => Promise<void>;
+  /**
+   * Callback function to retry the current step
+   * @returns Promise that resolves when the retry operation is complete
+   */
+  onRetry?: () => Promise<void>;
+  /**
+   * Jump to a specific step by step number
+   * @param step - The step number to jump to (1-indexed)
+   */
+  jumpTo?: (step: number) => void;
+  /**
+   * The total number of steps
+   */
+  total: number;
+  /**
+   * Number of times the current step has been retried
+   */
+  retryCount: number;
+}
+/**
+ * Creates a StepEnvironment object with the provided options
+ * @param options - Configuration options for the step environment
+ * @param options.current - The current step number (1-indexed)
+ * @param options.isFirst - Whether the current step is the first step
+ * @param options.isLast - Whether the current step is the last step
+ * @param options.onNext - Callback function to move to the next step
+ * @param options.onPrevious - Callback function to move to the previous step
+ * @param options.onRetry - Callback function to retry the current step
+ * @param options.jumpTo - Function to jump to a specific step number
+ * @param options.total - The total number of steps
+ * @returns A StepEnvironment object with the specified configuration
+ */
+declare function createStepEnvironment(options: {
+  /**
+   * The current step number (1-indexed)
+   */
+  current: number;
+  /**
+   * Whether the current step is the first step
+   */
+  isFirst: boolean;
+  /**
+   * Whether the current step is the last step
+   */
+  isLast: boolean;
+  /**
+   * Callback function to move to the next step
+   * @returns Promise that resolves when the next step operation is complete
+   */
+  onNext?: () => Promise<void>;
+  /**
+   * Callback function to move to the previous step
+   * @returns Promise that resolves when the previous step operation is complete
+   */
+  onPrevious?: () => Promise<void>;
+  /**
+   * Callback function to retry the current step
+   * @returns Promise that resolves when the retry operation is complete
+   */
+  onRetry?: () => Promise<void>;
+  /**
+   * Jump to a specific step by step number
+   * @param step - The step number to jump to (1-indexed)
+   */
+  jumpTo?: (step: number) => void;
+  /**
+   * The total number of steps
+   */
+  total: number;
+  /**
+   * Number of times the current step has been retried
+   */
+  retryCount: number;
+}): StepEnvironment;
+//#endregion
+export { StepEnvironment, createStepEnvironment };
+//# sourceMappingURL=step.d.ts.map

package/dist/esm/components/shared/types/step.js

@@ -0,0 +1,31 @@
+//#region src/components/shared/types/step.ts
+/**
+* Creates a StepEnvironment object with the provided options
+* @param options - Configuration options for the step environment
+* @param options.current - The current step number (1-indexed)
+* @param options.isFirst - Whether the current step is the first step
+* @param options.isLast - Whether the current step is the last step
+* @param options.onNext - Callback function to move to the next step
+* @param options.onPrevious - Callback function to move to the previous step
+* @param options.onRetry - Callback function to retry the current step
+* @param options.jumpTo - Function to jump to a specific step number
+* @param options.total - The total number of steps
+* @returns A StepEnvironment object with the specified configuration
+*/
+function createStepEnvironment(options) {
+	return {
+		current: options.current,
+		isFirst: options.isFirst,
+		isLast: options.isLast,
+		onNext: options.onNext,
+		onPrevious: options.onPrevious,
+		onRetry: options.onRetry,
+		jumpTo: options.jumpTo,
+		total: options.total,
+		retryCount: options.retryCount
+	};
+}
+
+//#endregion
+export { createStepEnvironment };
+//# sourceMappingURL=step.js.map

package/dist/esm/components/shared/types/step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.js","names":[],"sources":["../../../../../src/components/shared/types/step.ts"],"sourcesContent":["/**\n * Interface representing the environment for a step component\n */\nexport interface StepEnvironment {\n  /**\n   * The current step number (1-indexed)\n   */\n  current: number;\n  \n  /**\n   * Whether the current step is the first step\n   */\n  isFirst: boolean;\n  \n  /**\n   * Whether the current step is the last step\n   */\n  isLast: boolean;\n  \n  /**\n   * Callback function to move to the next step\n   * @returns Promise that resolves when the next step operation is complete\n   */\n  onNext?: () => Promise<void>;\n  \n  /**\n   * Callback function to move to the previous step\n   * @returns Promise that resolves when the previous step operation is complete\n   */\n  onPrevious?: () => Promise<void>;\n  \n  /**\n   * Callback function to retry the current step\n   * @returns Promise that resolves when the retry operation is complete\n   */\n  onRetry?: () => Promise<void>;\n  \n  /**\n   * Jump to a specific step by step number\n   * @param step - The step number to jump to (1-indexed)\n   */\n  jumpTo?: (step: number) => void;\n  \n  /**\n   * The total number of steps\n   */\n  total: number;\n  \n  /**\n   * Number of times the current step has been retried\n   */\n  retryCount: number;\n}\n\n\n\n/**\n * Creates a StepEnvironment object with the provided options\n * @param options - Configuration options for the step environment\n * @param options.current - The current step number (1-indexed)\n * @param options.isFirst - Whether the current step is the first step\n * @param options.isLast - Whether the current step is the last step\n * @param options.onNext - Callback function to move to the next step\n * @param options.onPrevious - Callback function to move to the previous step\n * @param options.onRetry - Callback function to retry the current step\n * @param options.jumpTo - Function to jump to a specific step number\n * @param options.total - The total number of steps\n * @returns A StepEnvironment object with the specified configuration\n */\nexport function createStepEnvironment(options: {\n  /**\n   * The current step number (1-indexed)\n   */\n  current: number;\n  \n  /**\n   * Whether the current step is the first step\n   */\n  isFirst: boolean;\n  \n  /**\n   * Whether the current step is the last step\n   */\n  isLast: boolean;\n  \n  /**\n   * Callback function to move to the next step\n   * @returns Promise that resolves when the next step operation is complete\n   */\n  onNext?: () => Promise<void>;\n  \n  /**\n   * Callback function to move to the previous step\n   * @returns Promise that resolves when the previous step operation is complete\n   */\n  onPrevious?: () => Promise<void>;\n  \n  /**\n   * Callback function to retry the current step\n   * @returns Promise that resolves when the retry operation is complete\n   */\n  onRetry?: () => Promise<void>;\n  \n  /**\n   * Jump to a specific step by step number\n   * @param step - The step number to jump to (1-indexed)\n   */\n  jumpTo?: (step: number) => void;\n  \n  /**\n   * The total number of steps\n   */\n  total: number;\n  \n  /**\n   * Number of times the current step has been retried\n   */\n  retryCount: number;\n}): StepEnvironment {\n  return {\n    current: options.current,\n    isFirst: options.isFirst,\n    isLast: options.isLast,\n    onNext: options.onNext,\n    onPrevious: options.onPrevious,\n    onRetry: options.onRetry,\n    jumpTo: options.jumpTo,\n    total: options.total,\n    retryCount: options.retryCount,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAqEA,SAAgB,sBAAsB,SAiDlB;AAClB,QAAO;EACL,SAAS,QAAQ;EACjB,SAAS,QAAQ;EACjB,QAAQ,QAAQ;EAChB,QAAQ,QAAQ;EAChB,YAAY,QAAQ;EACpB,SAAS,QAAQ;EACjB,QAAQ,QAAQ;EAChB,OAAO,QAAQ;EACf,YAAY,QAAQ;EACrB"}

package/dist/esm/components/shared/utils/createEnvironmentReceiver.d.ts

@@ -0,0 +1,23 @@
+import { EnvironmentSyncCallback } from "../types/form.js";
+import { UnifiedEnvironment } from "../types/environment.js";
+
+//#region src/components/shared/utils/createEnvironmentReceiver.d.ts
+/**
+ * Create an environment receiver for the receiving side
+ *
+ * This helper function creates a simple receiver that can be used
+ * to store and retrieve environment references provided by the framework.
+ * It returns an object with the callback to pass to the framework
+ * and a function to get the current environment.
+ *
+ * @returns An object with:
+ *   - environmentSyncCallback: The callback to pass to the framework config
+ *   - environmentSync: Function to get the current stored environment
+ */
+declare function createEnvironmentReceiver(): {
+  environmentSync: () => UnifiedEnvironment | null;
+  environmentSyncCallback: EnvironmentSyncCallback;
+};
+//#endregion
+export { createEnvironmentReceiver };
+//# sourceMappingURL=createEnvironmentReceiver.d.ts.map

package/dist/esm/components/shared/utils/createEnvironmentReceiver.js

@@ -0,0 +1,30 @@
+//#region src/components/shared/utils/createEnvironmentReceiver.ts
+/**
+* Create an environment receiver for the receiving side
+*
+* This helper function creates a simple receiver that can be used
+* to store and retrieve environment references provided by the framework.
+* It returns an object with the callback to pass to the framework
+* and a function to get the current environment.
+*
+* @returns An object with:
+*   - environmentSyncCallback: The callback to pass to the framework config
+*   - environmentSync: Function to get the current stored environment
+*/
+function createEnvironmentReceiver() {
+	let currentEnvironment = null;
+	const environmentSyncCallback = (environment) => {
+		currentEnvironment = environment;
+	};
+	const environmentSync = () => {
+		return currentEnvironment;
+	};
+	return {
+		environmentSync,
+		environmentSyncCallback
+	};
+}
+
+//#endregion
+export { createEnvironmentReceiver };
+//# sourceMappingURL=createEnvironmentReceiver.js.map

package/dist/esm/components/shared/utils/createEnvironmentReceiver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createEnvironmentReceiver.js","names":[],"sources":["../../../../../src/components/shared/utils/createEnvironmentReceiver.ts"],"sourcesContent":["import type { EnvironmentSyncCallback } from \"../types/form\";\nimport type { UnifiedEnvironment } from \"../types/environment\";\n\n/**\n * Create an environment receiver for the receiving side\n *\n * This helper function creates a simple receiver that can be used\n * to store and retrieve environment references provided by the framework.\n * It returns an object with the callback to pass to the framework\n * and a function to get the current environment.\n *\n * @returns An object with:\n *   - environmentSyncCallback: The callback to pass to the framework config\n *   - environmentSync: Function to get the current stored environment\n */\nexport function createEnvironmentReceiver() {\n  let currentEnvironment: UnifiedEnvironment | null = null;\n\n  const environmentSyncCallback: EnvironmentSyncCallback = (environment) => {\n    // Store the environment directly\n    currentEnvironment = environment;\n  };\n\n  const environmentSync = () => {\n    return currentEnvironment;\n  };\n\n  return {\n    environmentSync,\n    environmentSyncCallback,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAeA,SAAgB,4BAA4B;CAC1C,IAAI,qBAAgD;CAEpD,MAAM,2BAAoD,gBAAgB;AAExE,uBAAqB;;CAGvB,MAAM,wBAAwB;AAC5B,SAAO;;AAGT,QAAO;EACL;EACA;EACD"}

package/dist/esm/components/shared/utils/createForceRerenderReceiver.d.ts

@@ -0,0 +1,22 @@
+import { ForceRerenderCallback } from "../types/form.js";
+
+//#region src/components/shared/utils/createForceRerenderReceiver.d.ts
+/**
+ * Create a force rerender receiver for the receiving side
+ *
+ * This helper function creates a simple receiver that can be used
+ * to store and call a force rerender method provided by the framework.
+ * It returns an object with the callback to pass to the framework
+ * and a function to trigger the rerender.
+ *
+ * @returns An object with:
+ *   - forceRerenderCallback: The callback to pass to the framework config
+ *   - forceRerender: Function to call when you need to force a rerender
+ */
+declare function createForceRerenderReceiver(): {
+  forceRerender: () => void;
+  forceRerenderCallback: ForceRerenderCallback;
+};
+//#endregion
+export { createForceRerenderReceiver };
+//# sourceMappingURL=createForceRerenderReceiver.d.ts.map

package/dist/esm/components/shared/utils/createForceRerenderReceiver.js

@@ -0,0 +1,30 @@
+//#region src/components/shared/utils/createForceRerenderReceiver.ts
+/**
+* Create a force rerender receiver for the receiving side
+*
+* This helper function creates a simple receiver that can be used
+* to store and call a force rerender method provided by the framework.
+* It returns an object with the callback to pass to the framework
+* and a function to trigger the rerender.
+*
+* @returns An object with:
+*   - forceRerenderCallback: The callback to pass to the framework config
+*   - forceRerender: Function to call when you need to force a rerender
+*/
+function createForceRerenderReceiver() {
+	let forceRerenderMethod = null;
+	const forceRerenderCallback = (rerenderMethod) => {
+		forceRerenderMethod = rerenderMethod;
+	};
+	const forceRerender = () => {
+		if (forceRerenderMethod) forceRerenderMethod();
+	};
+	return {
+		forceRerender,
+		forceRerenderCallback
+	};
+}
+
+//#endregion
+export { createForceRerenderReceiver };
+//# sourceMappingURL=createForceRerenderReceiver.js.map

package/dist/esm/components/shared/utils/createForceRerenderReceiver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createForceRerenderReceiver.js","names":[],"sources":["../../../../../src/components/shared/utils/createForceRerenderReceiver.ts"],"sourcesContent":["import type { ForceRerenderCallback, ForceRerenderMethod } from \"../types/form\";\n\n/**\n * Create a force rerender receiver for the receiving side\n *\n * This helper function creates a simple receiver that can be used\n * to store and call a force rerender method provided by the framework.\n * It returns an object with the callback to pass to the framework\n * and a function to trigger the rerender.\n *\n * @returns An object with:\n *   - forceRerenderCallback: The callback to pass to the framework config\n *   - forceRerender: Function to call when you need to force a rerender\n */\nexport function createForceRerenderReceiver() {\n  let forceRerenderMethod: ForceRerenderMethod | null = null;\n\n  const forceRerenderCallback: ForceRerenderCallback = (rerenderMethod) => {\n    forceRerenderMethod = rerenderMethod;\n  };\n\n  const forceRerender = () => {\n    if (forceRerenderMethod) {\n      forceRerenderMethod();\n    }\n  };\n\n  return {\n    forceRerender,\n    forceRerenderCallback,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAcA,SAAgB,8BAA8B;CAC5C,IAAI,sBAAkD;CAEtD,MAAM,yBAAgD,mBAAmB;AACvE,wBAAsB;;CAGxB,MAAM,sBAAsB;AAC1B,MAAI,oBACF,sBAAqB;;AAIzB,QAAO;EACL;EACA;EACD"}

package/dist/esm/components/shared/utils/index.d.ts

@@ -0,0 +1,6 @@
+import { createForceRerenderReceiver } from "./createForceRerenderReceiver.js";
+import { createEnvironmentReceiver } from "./createEnvironmentReceiver.js";
+import { FooterRenderConfig, renderFooter } from "./renderFooter.js";
+import { HeaderRenderConfig, renderHeader } from "./renderHeader.js";
+import { StepState, calculateStepState, createStepClickHandler, createStepKeyHandler, resolveAllowStepNavigation } from "./stepState.js";
+export { FooterRenderConfig, HeaderRenderConfig, StepState, calculateStepState, createEnvironmentReceiver, createForceRerenderReceiver, createStepClickHandler, createStepKeyHandler, renderFooter, renderHeader, resolveAllowStepNavigation };

package/dist/esm/components/shared/utils/index.js

@@ -0,0 +1,7 @@
+import { calculateStepState, createStepClickHandler, createStepKeyHandler, resolveAllowStepNavigation } from "./stepState.js";
+import { createForceRerenderReceiver } from "./createForceRerenderReceiver.js";
+import { createEnvironmentReceiver } from "./createEnvironmentReceiver.js";
+import { renderFooter } from "./renderFooter.js";
+import { renderHeader } from "./renderHeader.js";
+
+export { calculateStepState, createEnvironmentReceiver, createForceRerenderReceiver, createStepClickHandler, createStepKeyHandler, renderFooter, renderHeader, resolveAllowStepNavigation };

package/dist/esm/components/shared/utils/renderFooter.d.ts

@@ -0,0 +1,37 @@
+import { DialogConfig } from "../../dialog/Dialog.types.js";
+import { BaseRecord } from "@refinedev/core";
+import React, { ReactNode } from "react";
+
+//#region src/components/shared/utils/renderFooter.d.ts
+interface FooterRenderConfig<T extends BaseRecord = any> {
+  /** CSS class name for the footer container */
+  className?: string;
+  /** Dialog configuration (required for dialog contexts) */
+  dialogConfig?: DialogConfig<T>;
+  /** Footer configuration - can be false, ReactNode, or function */
+  footer?: ((environment: any) => ReactNode) | false | ReactNode;
+  /** Form methods for form state */
+  formMethods?: any;
+  /** Whether this is rendered in a dialog context */
+  isDialog?: boolean;
+  /** Callback function to handle cancel/close actions */
+  onCancel?: () => void;
+  /** Configuration object for UnifiedFooter */
+  unifiedFooterConfig?: any;
+}
+/**
+ * Shared footer rendering utility that standardizes footer rendering
+ * across dialogs and forms in the portal framework.
+ *
+ * This utility handles:
+ * - Function-based footers with environment context
+ * - Static footer content
+ * - Disabled footers (footer: false)
+ * - Default UnifiedFooter fallback
+ * - Dialog vs standalone contexts
+ * - Wizard/step form detection for dialogs
+ */
+declare function renderFooter<T extends BaseRecord = any>(config: FooterRenderConfig<T>): React.ReactNode;
+//#endregion
+export { FooterRenderConfig, renderFooter };
+//# sourceMappingURL=renderFooter.d.ts.map

package/dist/esm/components/shared/utils/renderFooter.js

@@ -0,0 +1,99 @@
+import { isDialogFooterFunction, isWizardFormConfig } from "../../dialog/Dialog.types.js";
+import { useOptionalStepControlContext } from "../../form/StepControlContext.js";
+import { Environment } from "../environment/builders.js";
+import { UnifiedFooter } from "../UnifiedFooter.js";
+import { DialogFooter } from "@lumeweb/portal-framework-ui-core";
+import React from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/components/shared/utils/renderFooter.tsx
+/**
+* Shared footer rendering utility that standardizes footer rendering
+* across dialogs and forms in the portal framework.
+*
+* This utility handles:
+* - Function-based footers with environment context
+* - Static footer content
+* - Disabled footers (footer: false)
+* - Default UnifiedFooter fallback
+* - Dialog vs standalone contexts
+* - Wizard/step form detection for dialogs
+*/
+function renderFooter(config) {
+	const { className, dialogConfig, footer, formMethods, isDialog = false, onCancel, unifiedFooterConfig } = config;
+	if (footer === false) return null;
+	if (footer && isDialogFooterFunction(footer)) return /* @__PURE__ */ jsx(DialogFooter, {
+		className,
+		children: footer(buildFooterEnvironment({
+			dialogConfig,
+			formMethods,
+			isDialog,
+			onCancel,
+			stepControl: useOptionalStepControlContext()
+		}))
+	});
+	if (footer) return /* @__PURE__ */ jsx(DialogFooter, {
+		className,
+		children: footer
+	});
+	const footerEnvironment = buildFooterEnvironment({
+		dialogConfig,
+		formMethods,
+		isDialog,
+		onCancel,
+		stepControl: useOptionalStepControlContext()
+	});
+	return /* @__PURE__ */ jsx(DialogFooter, {
+		className,
+		children: /* @__PURE__ */ jsx(UnifiedFooter, {
+			config: unifiedFooterConfig || dialogConfig?.formConfig || dialogConfig,
+			environment: footerEnvironment
+		})
+	});
+}
+function buildFooterEnvironment({ dialogConfig, formMethods, isDialog, onCancel, stepControl }) {
+	if (!isDialog || !dialogConfig) return buildStandaloneFooterEnvironment(formMethods, dialogConfig);
+	return buildDialogFooterEnvironment(dialogConfig, formMethods, onCancel, stepControl);
+}
+/**
+* Builds footer environment for standalone contexts
+*/
+function buildStandaloneFooterEnvironment(formMethods, dialogConfig) {
+	const builder = Environment.footer().standalone();
+	if (formMethods && (!dialogConfig || dialogConfig.formConfig)) return builder.simpleForm({
+		isSubmitting: formMethods?.formState?.isSubmitting || false,
+		methods: formMethods
+	}).build();
+	return builder.buildContainerOnly();
+}
+/**
+* Builds footer environment for dialog contexts
+*/
+function buildDialogFooterEnvironment(dialogConfig, formMethods, onCancel, stepControl) {
+	const builder = Environment.footer().dialog({
+		dialogConfig,
+		onClose: onCancel || dialogConfig.onClose
+	});
+	if (dialogConfig.formConfig && isWizardFormConfig(dialogConfig.formConfig) && !!stepControl) return builder.wizardForm({
+		isSubmitting: formMethods?.formState?.isSubmitting || false,
+		methods: formMethods
+	}).step({
+		current: stepControl.currentStep,
+		isFirst: stepControl.isFirstStep,
+		isLast: stepControl.isLastStep,
+		onNext: stepControl.handleNext,
+		onPrevious: stepControl.handlePrevious,
+		onRetry: stepControl.handleRetry,
+		total: stepControl.totalSteps,
+		retryCount: stepControl.retryCount
+	}).build();
+	if (formMethods && dialogConfig.formConfig) return builder.simpleForm({
+		isSubmitting: formMethods?.formState?.isSubmitting || false,
+		methods: formMethods
+	}).build();
+	return builder.buildContainerOnly();
+}
+
+//#endregion
+export { renderFooter };
+//# sourceMappingURL=renderFooter.js.map