@resistdesign/voltra 3.0.0-alpha.25 → 3.0.0-alpha.27

package/README.md

@@ -218,6 +218,14 @@ How it works:
 - Strategy is auto-selected:
   - DOM + History API => browser history strategy.
   - Otherwise => in-memory native strategy.
+- Native strategy automatically wires Android hardware back to route history.
+  - If Voltra can go back (`history.index > 0`), it consumes the event and navigates back.
+  - If Voltra cannot go back, the event is not consumed so OS/native container behavior continues.
+
+Optional back affordances:
+
+- `adapter.back?.()` navigates backward when supported.
+- `adapter.canGoBack?.()` reports whether back navigation is currently possible.
 
 Escape hatches (root-only):
 

package/api/DBX/DBXTypes.d.ts

@@ -1,4 +1,4 @@
-import type { AuthInfo, CORSPatter, RouteAuthConfig, RouteMap } from "../Router/Types";
+import type { AuthInfo, CORSPattern, RouteAuthConfig, RouteMap } from "../Router/Types";
 import type { DataItemDBDriver, DataItemDBDriverConfig, ItemRelationshipDBDriver } from "../ORM/drivers/common/Types";
 import type { TypeInfoDataItem, TypeInfoMap } from "../../common/TypeParsing/TypeInfo";
 import type { TypeInfoORMDACConfig, TypeInfoORMIndexingConfig } from "../ORM/TypeInfoORMService";
@@ -53,7 +53,7 @@ export type DBXRuntimeConfig = {
     /**
      * Allowed origins used to generate CORS headers.
      */
-    allowedOrigins?: CORSPatter[];
+    allowedOrigins?: CORSPattern[];
     /**
      * Optional DAC configuration (excluding accessing role).
      */
@@ -86,7 +86,7 @@ export type DBXRuntime = {
     /**
      * Allowed origins for CORS headers.
      */
-    allowedOrigins: CORSPatter[];
+    allowedOrigins: CORSPattern[];
     /**
      * Driver resolver for item types.
      */

package/api/Indexing/index.d.ts

@@ -28,7 +28,7 @@ export * from "./exact/ExactDdb";
 export * from "./exact/ExactIndex";
 export * from "./exact/ExactS3";
 export * from "./fulltext/FullTextMemoryBackend";
-export { FullTextDdbBackend, FullTextDdbWriter, type BatchGetItemInput, type BatchGetItemOutput, type BatchWriteItemInput, type BatchWriteItemOutput, type FullTextTableNames, type GetItemInput, type GetItemOutput, type KeysAndAttributes, type QueryInput, type QueryOutput, } from "./fulltext/FullTextDdbBackend";
+export { FullTextDdbBackend, FullTextDdbWriter, type FullTextTableNames, } from "./fulltext/FullTextDdbBackend";
 export * from "./fulltext/Schema";
 export * from "./lossy/LossyDdb";
 export * from "./lossy/LossyIndex";

package/api/ORM/drivers/common/index.d.ts

@@ -1,2 +1,12 @@
 export * from "./Types";
 export * from "./SupportedTypeInfoORMDBDrivers";
+/**
+ * @category api
+ * @group Type Dependencies
+ */
+export type { ListItemsConfig, ListItemsResults, } from "../../../../common/SearchTypes";
+/**
+ * @category api
+ * @group Type Dependencies
+ */
+export type { TypeInfoDataItem, TypeInfoPack, } from "../../../../common/TypeParsing/TypeInfo";

package/api/ORM/drivers/index.d.ts

@@ -5,3 +5,18 @@ export * from "./InMemoryItemRelationshipDBDriver";
 export * from "./InMemoryFileItemDBDriver";
 export * from "./IndexingRelationshipDriver";
 export * from "./common";
+/**
+ * @category api
+ * @group Type Dependencies
+ */
+export type { ListRelationshipsConfig, SearchCriteria, } from "../../../common/SearchTypes";
+/**
+ * @category api
+ * @group Type Dependencies
+ */
+export type { TypeInfoMap, } from "../../../common/TypeParsing/TypeInfo";
+/**
+ * @category api
+ * @group Type Dependencies
+ */
+export type { S3SpecificConfig, } from "./S3FileItemDBDriver/ConfigTypes";

package/api/ORM/index.d.ts

@@ -5,3 +5,29 @@ export * from "./drivers";
 export * from "./TypeInfoORMService";
 export * from "./DACUtils";
 export * from "./ORMRouteMap";
+/**
+ * @category api
+ * @group Type Dependencies
+ */
+export type { DeleteRelationshipResults, ORMOperation, RelationshipOperation, TypeInfoORMAPI, TypeInfoORMContext, } from "../../common/TypeInfoORM/Types";
+/**
+ * @category api
+ * @group Type Dependencies
+ */
+export type { LiteralValue, TypeInfo, TypeInfoField, TypeOperation, } from "../../common/TypeParsing/TypeInfo";
+/**
+ * @category api
+ * @group Type Dependencies
+ */
+export type { CustomTypeInfoFieldValidatorMap, TypeInfoValidationResults, } from "../../common/TypeParsing/Validation";
+/**
+ * @category api
+ * @group Type Dependencies
+ */
+export type { BaseDACRole, DACAccessResult, DACConstraint, DACDataItemResourceAccessResultMap, DACRole, } from "../DataAccessControl";
+export { DACConstraintType } from "../DataAccessControl";
+/**
+ * @category api
+ * @group Type Dependencies
+ */
+export type { AuthInfo, NormalizedCloudFunctionEventData, Route, RouteAuthConfig, RouteHandler, RouteMap, } from "../Router/Types";

package/api/Router/CORS.d.ts

@@ -1,4 +1,4 @@
-import { CORSPatter } from "./Types";
+import { CORSPattern } from "./Types";
 /**
  * Check origin equality against an allowed string.
  * @returns True when the origin exactly matches the string.
@@ -37,7 +37,7 @@ origin?: string,
 /**
  * Allowed origin matcher (string equality or regex test).
  */
-corsPattern?: CORSPatter) => boolean;
+corsPattern?: CORSPattern) => boolean;
 /**
  * Resolve the origin if it is allowed by the CORS patterns.
  * @returns The origin if allowed, otherwise an empty string.
@@ -50,7 +50,7 @@ origin?: string,
 /**
  * Allowed origin matchers to check.
  */
-corsPatterns?: CORSPatter[]) => string;
+corsPatterns?: CORSPattern[]) => string;
 /**
  * Build CORS response headers for a given origin and allow list.
  * @returns CORS headers for the response.
@@ -63,4 +63,4 @@ origin?: string,
 /**
  * Allowed origin matchers to check.
  */
-corsPatterns?: CORSPatter[]) => Record<string, string>;
+corsPatterns?: CORSPattern[]) => Record<string, string>;

package/api/Router/Types.d.ts

@@ -1,7 +1,8 @@
 /**
  * A pattern for a CORS origin.
  * */
-export type CORSPatter = string | RegExp;
+export type CORSPattern = string | RegExp;
+export type CORSPatter = CORSPattern;
 /**
  * User authentication information.
  * Typically, from Cognito.
@@ -134,4 +135,4 @@ export type CloudFunctionEventTransformer = (event: any) => NormalizedCloudFunct
  * @param debug When true, log handler inputs and outputs.
  * @returns Cloud function response object.
  */
-export type CloudFunctionEventRouter = (event: any, eventTransformer: CloudFunctionEventTransformer, routeMap: RouteMap, allowedOrigins: CORSPatter[], errorShouldBeExposedToClient?: (error: unknown) => boolean, debug?: boolean) => Promise<CloudFunctionResponse>;
+export type CloudFunctionEventRouter = (event: any, eventTransformer: CloudFunctionEventTransformer, routeMap: RouteMap, allowedOrigins: CORSPattern[], errorShouldBeExposedToClient?: (error: unknown) => boolean, debug?: boolean) => Promise<CloudFunctionResponse>;

package/app/forms/core/index.d.ts

@@ -9,3 +9,8 @@ export * from "./resolveSuite";
 export * from "./createAutoField";
 export * from "./createFormRenderer";
 export * from "./mergeSuites";
+/**
+ * @category app
+ * @group Type Dependencies
+ */
+export type { LiteralValue, TypeInfoDataItem, TypeInfoField, } from "../../../common/TypeParsing/TypeInfo";

package/app/forms/core/types.d.ts

@@ -66,7 +66,7 @@ export type CustomTypeActionPayload = {
 /**
  * Context passed to field renderers.
  */
-export type FieldRenderContext = {
+export type FieldRenderContext<RenderOutput = unknown> = {
     /** Type info describing the field to render. */
     field: TypeInfoField;
     /** Key that identifies the field in the form values. */
@@ -97,11 +97,22 @@ export type FieldRenderContext = {
     onRelationAction?: (payload: RelationActionPayload) => void;
     /** Optional callback for custom type actions. */
     onCustomTypeAction?: (payload: CustomTypeActionPayload) => void;
+    /** Render any field with the same dispatch rules as the parent AutoField call. */
+    renderField: (input: {
+        field: TypeInfoField;
+        fieldKey: string;
+        value: FieldValue | undefined;
+        onChange: (value: FieldValue) => void;
+        error?: string;
+        disabled?: boolean;
+        onRelationAction?: (payload: RelationActionPayload) => void;
+        onCustomTypeAction?: (payload: CustomTypeActionPayload) => void;
+    }) => RenderOutput;
 };
 /**
  * Renderer function for a single field kind.
  */
-export type FieldRenderer<RenderOutput = unknown> = (context: FieldRenderContext) => RenderOutput;
+export type FieldRenderer<RenderOutput = unknown> = (context: FieldRenderContext<RenderOutput>) => RenderOutput;
 /**
  * Optional primitive component contract for suites.
  */

package/app/forms/index.d.ts

@@ -8,3 +8,8 @@ export type { ComponentSuite, FieldKind, FieldRenderContext, FieldRenderer, Fiel
 export { createAutoField, createFormRenderer, getFieldKind, mergeSuites, resolveSuite, withRendererOverride, } from "./core";
 export * from "./Engine";
 export * from "./UI";
+/**
+ * @category app
+ * @group Type Dependencies
+ */
+export type { LiteralValue, TypeInfo, TypeInfoDataItem, TypeInfoField, TypeOperation, } from "../../common/TypeParsing/TypeInfo";

package/app/index.js

@@ -603,6 +603,20 @@ var computeTrackPixels = ({
 };
 
 // src/app/utils/History.ts
+var createHistoryBackHandler = (history) => {
+  return {
+    /**
+     * @returns True when back navigation was handled by history.
+     */
+    handle: () => {
+      if (history.index > 0) {
+        history.back();
+        return true;
+      }
+      return false;
+    }
+  };
+};
 var ensurePrefix = (value, prefix) => value ? value.startsWith(prefix) ? value : `${prefix}${value}` : "";
 var parseHistoryPath = (inputPath) => {
   const raw = String(inputPath ?? "").trim();
@@ -756,7 +770,9 @@ var createRouteAdapterFromHistory = (history) => {
     },
     replace: (path) => {
       history.replace(path, { replaceSearch: true });
-    }
+    },
+    back: history.back,
+    canGoBack: () => history.index > 0
   };
 };
 
@@ -770,6 +786,37 @@ var getWindow = () => {
   }
   return void 0;
 };
+var getRuntimeRequire = () => {
+  const runtimeRequire = globalThis.__voltra_require__;
+  if (typeof runtimeRequire === "function") {
+    return runtimeRequire;
+  }
+  try {
+    return (0, eval)("require");
+  } catch (error) {
+    return void 0;
+  }
+};
+var tryGetReactNativeBackHandler = () => {
+  const runtimeRequire = getRuntimeRequire();
+  if (!runtimeRequire) {
+    return void 0;
+  }
+  try {
+    const reactNativeModule = runtimeRequire("react-native");
+    const platform = reactNativeModule?.Platform;
+    const backHandler = reactNativeModule?.BackHandler;
+    if (platform?.OS !== "android") {
+      return void 0;
+    }
+    if (typeof backHandler?.addEventListener !== "function") {
+      return void 0;
+    }
+    return backHandler;
+  } catch (error) {
+    return void 0;
+  }
+};
 var canUseBrowserHistory = () => {
   const WINDOW = getWindow();
   return Boolean(
@@ -823,7 +870,9 @@ var createBrowserRouteAdapter = () => {
       }
       WINDOW.history.replaceState({}, title, path);
       notify();
-    }
+    },
+    back: () => WINDOW?.history?.back(),
+    canGoBack: () => (WINDOW?.history?.length ?? 0) > 1
   };
 };
 var createNativeRouteAdapter = (initialPath = "/", ingress) => {
@@ -832,7 +881,8 @@ var createNativeRouteAdapter = (initialPath = "/", ingress) => {
   const history = createMemoryHistory(initialPath);
   const adapter = createRouteAdapterFromHistory(history);
   let stopIngress;
-  let started = false;
+  let stopBackHandler;
+  let ingressStarted = false;
   let subscribers = 0;
   const applyPath = (path, mode) => {
     const normalizedPath = parseHistoryPath(path).path;
@@ -846,10 +896,10 @@ var createNativeRouteAdapter = (initialPath = "/", ingress) => {
     history.replace(normalizedPath, { replaceSearch: true });
   };
   const startIngress = async () => {
-    if (started || !ingress) {
+    if (ingressStarted || !ingress) {
       return;
     }
-    started = true;
+    ingressStarted = true;
     const startKey = history.location.key;
     const startIndex = history.index;
     if (ingress.subscribe) {
@@ -870,6 +920,31 @@ var createNativeRouteAdapter = (initialPath = "/", ingress) => {
       }
     }
   };
+  const startBackHandler = () => {
+    if (stopBackHandler) {
+      return;
+    }
+    const reactNativeBackHandler = tryGetReactNativeBackHandler();
+    if (!reactNativeBackHandler) {
+      return;
+    }
+    const historyBackHandler = createHistoryBackHandler(history);
+    const handleHardwareBackPress = () => historyBackHandler.handle();
+    const subscription = reactNativeBackHandler.addEventListener(
+      "hardwareBackPress",
+      handleHardwareBackPress
+    );
+    stopBackHandler = () => {
+      if (typeof subscription?.remove === "function") {
+        subscription.remove();
+        return;
+      }
+      reactNativeBackHandler.removeEventListener?.(
+        "hardwareBackPress",
+        handleHardwareBackPress
+      );
+    };
+  };
   return {
     ...adapter,
     push: (path, title) => {
@@ -888,18 +963,23 @@ var createNativeRouteAdapter = (initialPath = "/", ingress) => {
       subscribers += 1;
       if (subscribers === 1) {
         void startIngress();
+        startBackHandler();
       }
       const unlisten = adapter.subscribe(listener);
       return () => {
         unlisten();
         subscribers = Math.max(0, subscribers - 1);
-        if (subscribers === 0 && stopIngress) {
-          stopIngress();
+        if (subscribers === 0) {
+          stopIngress?.();
           stopIngress = void 0;
-          started = false;
+          ingressStarted = false;
+          stopBackHandler?.();
+          stopBackHandler = void 0;
         }
       };
-    }
+    },
+    back: adapter.back,
+    canGoBack: adapter.canGoBack
   };
 };
 var createUniversalAdapter = (options = {}) => {
@@ -1473,7 +1553,7 @@ var resolveSuite = (overrides, fallback) => {
 
 // src/app/forms/core/createAutoField.ts
 var createAutoField = (suite) => {
-  return (props) => {
+  const renderField = (props) => {
     const { field, fieldKey, value, onChange, error, disabled } = props;
     const { tags } = field;
     const context = {
@@ -1491,11 +1571,13 @@ var createAutoField = (suite) => {
       allowCustomSelection: tags?.allowCustomSelection,
       customType: tags?.customType,
       onRelationAction: props.onRelationAction,
-      onCustomTypeAction: props.onCustomTypeAction
+      onCustomTypeAction: props.onCustomTypeAction,
+      renderField
     };
     const kind = getFieldKind(field);
     return suite.renderers[kind](context);
   };
+  return renderField;
 };
 
 // src/app/forms/core/createFormRenderer.ts
@@ -1733,4 +1815,4 @@ var AutoForm = ({
   );
 };
 
-export { ApplicationStateContext, ApplicationStateProvider, AutoForm, AutoFormView, Route, RouteContext, RouteContextConsumer, RouteContextProvider, RouteProvider, TypeInfoORMClient, buildHistoryPath, buildQueryString, buildRoutePath, canUseBrowserHistory, computeAreaBounds, computeTrackPixels, createAutoField, createBrowserRouteAdapter, createEasyLayout, createFormRenderer, createManualRouteAdapter, createMemoryHistory, createNativeRouteAdapter, createRouteAdapterFromHistory, createUniversalAdapter, getApplicationStateIdentifier, getApplicationStateModified, getApplicationStateValue, getApplicationStateValueStructure, getChangedDependencyIndexes, getEasyLayoutTemplateDetails, getFieldKind, getFullUrl, getPascalCaseAreaName, handleRequest, mergeSuites, parseHistoryPath, parseTemplate, requestHandlerFactory, resolveSuite, sendServiceRequest, setApplicationStateModified, setApplicationStateValue, useApplicationStateLoader, useApplicationStateValue, useApplicationStateValueStructure, useController, useDebugDependencies, useFormEngine, useRouteContext, useTypeInfoORMAPI, validateAreas, withRendererOverride };
+export { ApplicationStateContext, ApplicationStateProvider, AutoForm, AutoFormView, Route, RouteContext, RouteContextConsumer, RouteContextProvider, RouteProvider, TypeInfoORMClient, buildHistoryPath, buildQueryString, buildRoutePath, canUseBrowserHistory, computeAreaBounds, computeTrackPixels, createAutoField, createBrowserRouteAdapter, createEasyLayout, createFormRenderer, createHistoryBackHandler, createManualRouteAdapter, createMemoryHistory, createNativeRouteAdapter, createRouteAdapterFromHistory, createUniversalAdapter, getApplicationStateIdentifier, getApplicationStateModified, getApplicationStateValue, getApplicationStateValueStructure, getChangedDependencyIndexes, getEasyLayoutTemplateDetails, getFieldKind, getFullUrl, getPascalCaseAreaName, handleRequest, mergeSuites, parseHistoryPath, parseTemplate, requestHandlerFactory, resolveSuite, sendServiceRequest, setApplicationStateModified, setApplicationStateValue, tryGetReactNativeBackHandler, useApplicationStateLoader, useApplicationStateValue, useApplicationStateValueStructure, useController, useDebugDependencies, useFormEngine, useRouteContext, useTypeInfoORMAPI, validateAreas, withRendererOverride };

package/app/utils/History.d.ts

@@ -98,6 +98,23 @@ export type HistoryController = {
      */
     listen: (listener: HistoryListener) => () => void;
 };
+/**
+ * Back-navigation consumption helper for shared history controllers.
+ *
+ * Returns `true` only when history consumed the back action.
+ *
+ * Example:
+ * ```ts
+ * const handler = createHistoryBackHandler(history);
+ * const consumed = handler.handle();
+ * ```
+ */
+export declare const createHistoryBackHandler: (history: HistoryController) => {
+    /**
+     * @returns True when back navigation was handled by history.
+     */
+    handle: () => boolean;
+};
 /**
  * Parse a path-like value into normalized path/search/hash parts.
  *

package/app/utils/Route.d.ts

@@ -18,6 +18,10 @@ export type RouteAdapter = {
     push?: (path: string, title?: string) => void;
     /** Optional navigation helper for adapters that can replace state. */
     replace?: (path: string, title?: string) => void;
+    /** Optional navigation helper for adapters that can go backward. */
+    back?: () => void;
+    /** Optional capability check for backward navigation. */
+    canGoBack?: () => boolean;
 };
 /**
  * Supported query value types for route serialization.

package/app/utils/UniversalRouteAdapter.d.ts

@@ -55,6 +55,16 @@ export type UniversalRouteIngress = {
      */
     mapURLToPath?: (url: string) => string;
 };
+type ReactNativeBackHandler = {
+    addEventListener: (eventName: "hardwareBackPress", listener: () => boolean) => {
+        remove?: () => void;
+    } | void;
+    removeEventListener?: (eventName: "hardwareBackPress", listener: () => boolean) => void;
+};
+/**
+ * Safely resolve React Native BackHandler for Android runtimes only.
+ */
+export declare const tryGetReactNativeBackHandler: () => ReactNativeBackHandler | undefined;
 /**
  * Detect whether browser history is available at runtime.
  */
@@ -71,3 +81,4 @@ export declare const createNativeRouteAdapter: (initialPath?: string, ingress?:
  * Create a runtime-selected RouteAdapter for web/native environments.
  */
 export declare const createUniversalAdapter: (options?: CreateUniversalAdapterOptions) => RouteAdapter;
+export {};

package/app/utils/index.d.ts

@@ -22,3 +22,18 @@ export * from "./UniversalRouteAdapter";
 export * from "./Service";
 export * from "./TypeInfoORMAPIUtils";
 export * from "./TypeInfoORMClient";
+/**
+ * @category app
+ * @group Type Dependencies
+ */
+export type { ListItemsConfig, ListItemsResults, ListRelationshipsConfig, } from "../../common/SearchTypes";
+/**
+ * @category app
+ * @group Type Dependencies
+ */
+export type { DeleteRelationshipResults, TypeInfoORMAPIRoutePaths, TypeInfoORMClientAPI, TypeInfoORMServiceError, } from "../../common/TypeInfoORM/Types";
+/**
+ * @category app
+ * @group Type Dependencies
+ */
+export type { TypeInfoDataItem, } from "../../common/TypeParsing/TypeInfo";

package/common/ItemRelationships/index.d.ts

@@ -1 +1,6 @@
 export * from "./ItemRelationshipValidation";
+/**
+ * @category common
+ * @group Type Dependencies
+ */
+export type { TypeInfoValidationResults, } from "../TypeParsing/Validation";

package/common/TypeInfoORM/Types.d.ts

@@ -12,7 +12,7 @@ import { TypeInfoDataItem, TypeOperation } from "../TypeParsing/TypeInfo";
  * */
 export declare const ITEM_RELATIONSHIP_DAC_RESOURCE_NAME = "TYPE_INFO_ORM_ITEM_RELATIONSHIP";
 /**
- * A set of possible operations for a {@link ItemRelationshipInfo}.
+ * A set of possible operations for an item relationship record.
  * */
 export declare enum RelationshipOperation {
     /**

package/common/TypeInfoORM/index.d.ts

@@ -1 +1,11 @@
 export * from "./Types";
+/**
+ * @category common
+ * @group Type Dependencies
+ */
+export type { ListItemsConfig, ListItemsResults, ListRelationshipsConfig, } from "../SearchTypes";
+/**
+ * @category common
+ * @group Type Dependencies
+ */
+export type { TypeInfoDataItem, TypeOperation, } from "../TypeParsing/TypeInfo";

package/native/index.js

@@ -4,35 +4,6 @@ import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 
 // src/native/forms/suite.ts
 
-// src/app/forms/core/getFieldKind.ts
-var hasSelectableValues = (field) => {
-  const possibleValues = field.possibleValues ?? [];
-  return possibleValues.some(
-    (value) => typeof value === "string" || typeof value === "number"
-  );
-};
-var getFieldKind = (field) => {
-  if (field.typeReference) {
-    return field.array ? "relation_array" : "relation_single";
-  }
-  if (field.tags?.customType) {
-    return field.array ? "custom_array" : "custom_single";
-  }
-  if (field.array) {
-    return "array";
-  }
-  if (hasSelectableValues(field)) {
-    return "enum_select";
-  }
-  if (field.type === "boolean") {
-    return "boolean";
-  }
-  if (field.type === "number") {
-    return "number";
-  }
-  return "string";
-};
-
 // src/app/forms/core/resolveSuite.ts
 var fieldKinds = [
   "string",
@@ -69,9 +40,38 @@ var resolveSuite = (overrides, fallback) => {
   };
 };
 
+// src/app/forms/core/getFieldKind.ts
+var hasSelectableValues = (field) => {
+  const possibleValues = field.possibleValues ?? [];
+  return possibleValues.some(
+    (value) => typeof value === "string" || typeof value === "number"
+  );
+};
+var getFieldKind = (field) => {
+  if (field.typeReference) {
+    return field.array ? "relation_array" : "relation_single";
+  }
+  if (field.tags?.customType) {
+    return field.array ? "custom_array" : "custom_single";
+  }
+  if (field.array) {
+    return "array";
+  }
+  if (hasSelectableValues(field)) {
+    return "enum_select";
+  }
+  if (field.type === "boolean") {
+    return "boolean";
+  }
+  if (field.type === "number") {
+    return "number";
+  }
+  return "string";
+};
+
 // src/app/forms/core/createAutoField.ts
 var createAutoField = (suite) => {
-  return (props) => {
+  const renderField = (props) => {
     const { field, fieldKey, value, onChange, error, disabled } = props;
     const { tags } = field;
     const context = {
@@ -89,11 +89,13 @@ var createAutoField = (suite) => {
       allowCustomSelection: tags?.allowCustomSelection,
       customType: tags?.customType,
       onRelationAction: props.onRelationAction,
-      onCustomTypeAction: props.onCustomTypeAction
+      onCustomTypeAction: props.onCustomTypeAction,
+      renderField
     };
     const kind = getFieldKind(field);
     return suite.renderers[kind](context);
   };
+  return renderField;
 };
 
 // src/app/forms/core/createFormRenderer.ts
@@ -301,7 +303,6 @@ var renderCustomArray = (context) => {
     error ? createElement(ErrorMessage, null, error) : null
   );
 };
-var autoFieldRenderer;
 var renderArray = (context) => {
   const { field, fieldKey, label, required, disabled, error } = context;
   const itemField = createArrayItemField(field);
@@ -320,7 +321,7 @@ var renderArray = (context) => {
           createElement(
             View,
             { style: { flex: 1 } },
-            autoFieldRenderer({
+            context.renderField({
               field: itemField,
               fieldKey: `${fieldKey}[${index}]`,
               value: item,
@@ -485,9 +486,9 @@ var nativeSuite = {
     Button: SuiteButton
   }
 };
-var resolvedNativeSuite = resolveSuite(void 0, nativeSuite);
-autoFieldRenderer = createAutoField(resolvedNativeSuite);
-var nativeAutoField = autoFieldRenderer;
+var nativeAutoField = createFormRenderer({
+  fallbackSuite: nativeSuite
+}).AutoField;
 var getDeniedOperation = (deniedOperations, operation) => {
   if (!deniedOperations) {
     return false;
@@ -720,6 +721,20 @@ var AutoForm2 = (props) => {
 };
 
 // src/app/utils/History.ts
+var createHistoryBackHandler = (history) => {
+  return {
+    /**
+     * @returns True when back navigation was handled by history.
+     */
+    handle: () => {
+      if (history.index > 0) {
+        history.back();
+        return true;
+      }
+      return false;
+    }
+  };
+};
 var ensurePrefix = (value, prefix) => value ? value.startsWith(prefix) ? value : `${prefix}${value}` : "";
 var parseHistoryPath = (inputPath) => {
   const raw = String(inputPath ?? "").trim();
@@ -1251,20 +1266,7 @@ var createNativeHistory = (options = {}) => {
     }
   };
 };
-var createNativeBackHandler = (history) => {
-  return {
-    /**
-     * @returns True when back navigation was handled by history.
-     */
-    handle: () => {
-      if (history.index > 0) {
-        history.back();
-        return true;
-      }
-      return false;
-    }
-  };
-};
+var createNativeBackHandler = (history) => createHistoryBackHandler(history);
 
 // src/common/Routing.ts
 var PATH_DELIMITER = "/";
@@ -1355,4 +1357,4 @@ var buildPathFromRouteChain = (routeChain, config, query) => {
   return buildRoutePath(segments, query);
 };
 
-export { ArrayContainer, ArrayItemWrapper, AutoField, AutoForm2 as AutoForm, AutoFormView2 as AutoFormView, Button, ErrorMessage, FieldWrapper, NativeEasyLayoutView, buildHistoryPath, buildPathFromRouteChain, createMemoryHistory, createNativeBackHandler, createNativeFormRenderer, createNativeHistory, createNavigationStateRouteAdapter, makeNativeEasyLayout, mapNativeURLToPath, nativeAutoField, nativeSuite, parseHistoryPath, useNativeEasyLayout };
+export { ArrayContainer, ArrayItemWrapper, AutoField, AutoForm2 as AutoForm, AutoFormView2 as AutoFormView, Button, ErrorMessage, FieldWrapper, NativeEasyLayoutView, buildHistoryPath, buildPathFromRouteChain, createHistoryBackHandler, createMemoryHistory, createNativeBackHandler, createNativeFormRenderer, createNativeHistory, createNavigationStateRouteAdapter, makeNativeEasyLayout, mapNativeURLToPath, nativeAutoField, nativeSuite, parseHistoryPath, useNativeEasyLayout };

package/native/utils/History.d.ts

@@ -95,19 +95,8 @@ export declare const mapNativeURLToPath: (url: string) => string;
  */
 export declare const createNativeHistory: (options?: CreateNativeHistoryOptions) => NativeHistoryController;
 /**
- * Create an Android back-handler helper for native history.
- *
- * Returns `true` only when history consumed the back action.
- *
- * Example:
- * ```ts
- * const handler = createNativeBackHandler(history);
- * const consumed = handler.handle();
- * ```
+ * @deprecated Use {@link createHistoryBackHandler} from `app/utils/History`.
  */
 export declare const createNativeBackHandler: (history: HistoryController) => {
-    /**
-     * @returns True when back navigation was handled by history.
-     */
     handle: () => boolean;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@resistdesign/voltra",
-  "version": "3.0.0-alpha.25",
+  "version": "3.0.0-alpha.27",
   "description": "With our powers combined!",
   "homepage": "https://voltra.app",
   "repository": "git@github.com:resistdesign/voltra.git",

package/web/index.js

@@ -21,35 +21,6 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget);
 
-// src/app/forms/core/getFieldKind.ts
-var hasSelectableValues = (field) => {
-  const possibleValues = field.possibleValues ?? [];
-  return possibleValues.some(
-    (value) => typeof value === "string" || typeof value === "number"
-  );
-};
-var getFieldKind = (field) => {
-  if (field.typeReference) {
-    return field.array ? "relation_array" : "relation_single";
-  }
-  if (field.tags?.customType) {
-    return field.array ? "custom_array" : "custom_single";
-  }
-  if (field.array) {
-    return "array";
-  }
-  if (hasSelectableValues(field)) {
-    return "enum_select";
-  }
-  if (field.type === "boolean") {
-    return "boolean";
-  }
-  if (field.type === "number") {
-    return "number";
-  }
-  return "string";
-};
-
 // src/app/forms/core/resolveSuite.ts
 var fieldKinds = [
   "string",
@@ -86,9 +57,38 @@ var resolveSuite = (overrides, fallback) => {
   };
 };
 
+// src/app/forms/core/getFieldKind.ts
+var hasSelectableValues = (field) => {
+  const possibleValues = field.possibleValues ?? [];
+  return possibleValues.some(
+    (value) => typeof value === "string" || typeof value === "number"
+  );
+};
+var getFieldKind = (field) => {
+  if (field.typeReference) {
+    return field.array ? "relation_array" : "relation_single";
+  }
+  if (field.tags?.customType) {
+    return field.array ? "custom_array" : "custom_single";
+  }
+  if (field.array) {
+    return "array";
+  }
+  if (hasSelectableValues(field)) {
+    return "enum_select";
+  }
+  if (field.type === "boolean") {
+    return "boolean";
+  }
+  if (field.type === "number") {
+    return "number";
+  }
+  return "string";
+};
+
 // src/app/forms/core/createAutoField.ts
 var createAutoField = (suite) => {
-  return (props) => {
+  const renderField = (props) => {
     const { field, fieldKey, value, onChange, error, disabled } = props;
     const { tags } = field;
     const context = {
@@ -106,11 +106,13 @@ var createAutoField = (suite) => {
       allowCustomSelection: tags?.allowCustomSelection,
       customType: tags?.customType,
       onRelationAction: props.onRelationAction,
-      onCustomTypeAction: props.onCustomTypeAction
+      onCustomTypeAction: props.onCustomTypeAction,
+      renderField
     };
     const kind = getFieldKind(field);
     return suite.renderers[kind](context);
   };
+  return renderField;
 };
 
 // src/app/forms/core/createFormRenderer.ts
@@ -348,7 +350,6 @@ var renderCustomArray = (context) => {
     error && /* @__PURE__ */ jsx(ErrorMessage, { children: error })
   ] });
 };
-var autoFieldRenderer;
 var renderArray = (context) => {
   const { field, fieldKey, label, required, disabled, error } = context;
   const id = `field-${fieldKey}`;
@@ -362,7 +363,7 @@ var renderArray = (context) => {
     ] }),
     /* @__PURE__ */ jsxs(ArrayContainer, { children: [
       arrayValue.map((item, index) => /* @__PURE__ */ jsxs(ArrayItemWrapper, { children: [
-        /* @__PURE__ */ jsx("div", { style: { flex: 1 }, children: autoFieldRenderer({
+        /* @__PURE__ */ jsx("div", { style: { flex: 1 }, children: context.renderField({
           field: itemField,
           fieldKey: `${fieldKey}[${index}]`,
           value: item,
@@ -572,9 +573,9 @@ var webSuite = {
     Button: SuiteButton
   }
 };
-var resolvedWebSuite = resolveSuite(void 0, webSuite);
-autoFieldRenderer = createAutoField(resolvedWebSuite);
-var webAutoField = autoFieldRenderer;
+var webAutoField = createFormRenderer({
+  fallbackSuite: webSuite
+}).AutoField;
 var RelationList = styled_default("div")`
   display: flex;
   flex-direction: column;