@resistdesign/voltra 3.0.0-alpha.46 → 3.0.0-alpha.48

package/api/index.js

@@ -1,6 +1,6 @@
 import { TypeInfoORMUpdateOperators, ITEM_RELATIONSHIP_DAC_RESOURCE_NAME, ComparisonOperators } from '../chunk-RUNXRISF.js';
-import { getNoErrorDescriptor, getErrorDescriptor, ERROR_MESSAGE_CONSTANTS, validateTypeOperationAllowed, getValidityValue, validateTypeInfoValue, validateTypeInfoFieldValue } from '../chunk-YCTVEW2I.js';
-import { mergeStringPaths, getPathString, getPathArray } from '../chunk-WNFRDIBW.js';
+import { getNoErrorDescriptor, getErrorDescriptor, ERROR_MESSAGE_CONSTANTS, validateTypeOperationAllowed, getValidityValue, validateTypeInfoValue, validateTypeInfoFieldValue } from '../chunk-3HVYVX3S.js';
+import { mergeStringPaths, getPathString, getPathArray } from '../chunk-2JDOM6PB.js';
 import '../chunk-I2KLQ2HA.js';
 import { QueryCommand, PutItemCommand, ConditionalCheckFailedException, GetItemCommand, BatchGetItemCommand, BatchWriteItemCommand, DynamoDBClient, UpdateItemCommand, DeleteItemCommand, ScanCommand } from '@aws-sdk/client-dynamodb';
 import { marshall, unmarshall } from '@aws-sdk/util-dynamodb';

package/app/index.js

@@ -1,9 +1,9 @@
-export { createEasyLayout, getEasyLayoutTemplateDetails, getPascalCaseAreaName } from '../chunk-CMH6L5QQ.js';
+export { createEasyLayout, getEasyLayoutTemplateDetails, getPascalCaseAreaName } from '../chunk-BSHQIRBV.js';
 export { computeTrackPixels } from '../chunk-TJFTWPXQ.js';
-export { AutoForm, AutoFormView, Route, RouteContext, RouteContextConsumer, RouteContextProvider, RouteProvider, buildHistoryPath, buildQueryString, buildRoutePath, canUseBrowserHistory, computeAreaBounds, createAutoField, createBrowserRouteAdapter, createFormRenderer, createHistoryBackHandler, createManualRouteAdapter, createMemoryHistory, createNativeRouteAdapter, createRouteAdapterFromHistory, createUniversalAdapter, defaultTranslateValidationErrorCode, getFieldKind, parseHistoryPath, parseTemplate, resolveSuite, useFormEngine, useRouteContext, validateAreas, wrapRouteAdapterWithPathResolver } from '../chunk-44BMFTKD.js';
+export { AutoForm, AutoFormView, Route, RouteContext, RouteContextConsumer, RouteContextProvider, RouteProvider, buildHistoryPath, buildQueryString, buildRoutePath, canUseBrowserHistory, computeAreaBounds, createAutoField, createBrowserRouteAdapter, createFormRenderer, createHistoryBackHandler, createManualRouteAdapter, createMemoryHistory, createNativeRouteAdapter, createRouteAdapterFromHistory, createUniversalAdapter, defaultTranslateValidationErrorCode, getFieldKind, parseHistoryPath, parseTemplate, resolveSuite, useFormEngine, useRouteContext, validateAreas, wrapRouteAdapterWithPathResolver } from '../chunk-K4R2PFNG.js';
 import '../chunk-RUNXRISF.js';
-import '../chunk-YCTVEW2I.js';
-import { mergeStringPaths, PATH_DELIMITER } from '../chunk-WNFRDIBW.js';
+import '../chunk-3HVYVX3S.js';
+import { mergeStringPaths, PATH_DELIMITER } from '../chunk-2JDOM6PB.js';
 import '../chunk-I2KLQ2HA.js';
 import { createContext, useContext, useRef, useMemo, useCallback, useState, useEffect } from 'react';
 import { jsx } from 'react/jsx-runtime';

package/app/utils/Route.d.ts

@@ -84,7 +84,15 @@ export declare const buildQueryString: (query?: RouteQuery) => string;
  */
 export declare const buildRoutePath: (segments: Array<string | number>, query?: RouteQuery) => string;
 /**
- * Access values for the current Route.
+ * Access values for the current `Route`.
+ *
+ * `parentPath` is the consumer-facing route pattern for the currently matched
+ * parent route chain, expressed as plain slash-delimited segments such as
+ * `app/books/:id`.
+ *
+ * `parentPathInternal` carries the same logical route pattern in the
+ * JSON-serialized segment format used by the shared routing internals. Most
+ * consumers should prefer `parentPath`.
  */
 export type RouteContextType = {
     /**
@@ -92,9 +100,17 @@ export type RouteContextType = {
      */
     currentWindowPath: string;
     /**
-     * The parent path for this route level.
+     * Consumer-facing parent route pattern for this route level.
+     *
+     * Example: `app/books/:id`
      */
     parentPath: string;
+    /**
+     * Internal parent route pattern used by routing utilities and matcher logic.
+     *
+     * Example: `"app"/"books"/":id"`
+     */
+    parentPathInternal: string;
     /**
      * Aggregated route params from parent and current routes.
      */
@@ -103,6 +119,11 @@ export type RouteContextType = {
      * Whether this route is the top-level router.
      */
     isTopLevel: boolean;
+    /**
+     * Absolute matched path used as the base for relative navigation at this
+     * route level.
+     */
+    adapterBasePath: string;
     /**
      * Adapter driving route updates.
      */
@@ -116,6 +137,10 @@ export declare const RouteContextProvider: import("react").Provider<RouteContext
 /**
  * Access Route path and parameter information.
  *
+ * Use `parentPath` for app-facing route logic. `parentPathInternal` is exposed
+ * so advanced integrations can align with the internal routing helpers when
+ * needed.
+ *
  * @returns The current route context.
  */
 export declare const useRouteContext: () => RouteContextType;
@@ -128,7 +153,7 @@ export declare const useRouteContext: () => RouteContextType;
  * @param adapter - RouteAdapter to normalize.
  * @returns Adapter with relative-aware `push` and `replace`.
  */
-export declare const wrapRouteAdapterWithPathResolver: (adapter: RouteAdapter) => RouteAdapter;
+export declare const wrapRouteAdapterWithPathResolver: (adapter: RouteAdapter, getBasePath?: () => string) => RouteAdapter;
 /**
  * RouteProvider props.
  */

package/build/index.js

@@ -1,4 +1,4 @@
-import { getPotentialJSONValue, getPathArray } from '../chunk-WNFRDIBW.js';
+import { getPotentialJSONValue, getPathArray } from '../chunk-2JDOM6PB.js';
 import '../chunk-I2KLQ2HA.js';
 import { SyntaxKind, isLiteralTypeNode, isStringLiteral, isNumericLiteral, createSourceFile, ScriptTarget } from 'typescript';
 

package/{chunk-WNFRDIBW.js → chunk-2JDOM6PB.js}

@@ -33,6 +33,23 @@ var mergeStringPaths = (path1, path2, delimiter = PATH_DELIMITER, filterEmptyOut
   useJson,
   uriEncodeParts
 );
+var resolvePath = (currentPath, newPath) => {
+  const newSegments = getPathArray(newPath, PATH_DELIMITER, true);
+  let currentSegments = getPathArray(currentPath, PATH_DELIMITER, true);
+  if (newPath.startsWith("/")) {
+    currentSegments = [];
+  }
+  newSegments.forEach((segment) => {
+    if (segment === "..") {
+      if (currentSegments.length > 0) {
+        currentSegments.pop();
+      }
+    } else if (segment !== ".") {
+      currentSegments.push(segment);
+    }
+  });
+  return "/" + currentSegments.join("/");
+};
 var splitRoutePathParts = (rawPath) => {
   let path = rawPath;
   let hash = "";
@@ -118,4 +135,4 @@ var getParamsAndTestPath = (path, testPath, exact = false) => {
   }
 };
 
-export { PATH_DELIMITER, getParamsAndTestPath, getPathArray, getPathString, getPotentialJSONValue, mergeStringPaths, resolveRouteAdapterPath };
+export { PATH_DELIMITER, getParamsAndTestPath, getPathArray, getPathString, getPotentialJSONValue, mergeStringPaths, resolvePath, resolveRouteAdapterPath };

package/{chunk-YCTVEW2I.js → chunk-3HVYVX3S.js}

@@ -1,4 +1,4 @@
-import { getPathString } from './chunk-WNFRDIBW.js';
+import { getPathString } from './chunk-2JDOM6PB.js';
 
 // src/common/TypeParsing/TypeInfo.ts
 var TypeOperation = /* @__PURE__ */ ((TypeOperation2) => {

package/{chunk-CMH6L5QQ.js → chunk-BSHQIRBV.js}

@@ -1,4 +1,4 @@
-import { parseTemplate, validateAreas } from './chunk-44BMFTKD.js';
+import { parseTemplate, validateAreas } from './chunk-K4R2PFNG.js';
 
 // src/app/utils/EasyLayout.tsx
 var getPascalCaseAreaName = (area) => {

package/{chunk-44BMFTKD.js → chunk-K4R2PFNG.js}

@@ -1,5 +1,5 @@
-import { getErrorDescriptor, getNoErrorDescriptor, validateTypeInfoDataItem, getArrayItemErrorMap, getErrorDescriptors, ERROR_MESSAGE_CONSTANTS } from './chunk-YCTVEW2I.js';
-import { resolveRouteAdapterPath, getPathString, mergeStringPaths, getParamsAndTestPath } from './chunk-WNFRDIBW.js';
+import { getErrorDescriptor, getNoErrorDescriptor, validateTypeInfoDataItem, getArrayItemErrorMap, getErrorDescriptors, ERROR_MESSAGE_CONSTANTS } from './chunk-3HVYVX3S.js';
+import { resolveRouteAdapterPath, getPathString, mergeStringPaths, getParamsAndTestPath, getPathArray, PATH_DELIMITER } from './chunk-2JDOM6PB.js';
 import { createContext, useContext, useMemo, useState, useEffect, useCallback, createElement, useRef } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 
@@ -540,11 +540,20 @@ var buildRoutePath = (segments, query) => {
   const queryString = query ? buildQueryString(query) : "";
   return queryString ? `${basePath}?${queryString}` : basePath;
 };
+var getReadableRoutePath = (path) => getPathString(
+  getPathArray(path, PATH_DELIMITER, true, true, true, false),
+  PATH_DELIMITER,
+  true,
+  false,
+  false
+);
 var RouteContext = createContext({
   currentWindowPath: "",
   parentPath: "",
+  parentPathInternal: "",
   params: {},
-  isTopLevel: true
+  isTopLevel: true,
+  adapterBasePath: "/"
 });
 var {
   /**
@@ -557,27 +566,42 @@ var {
   Consumer: RouteContextConsumer
 } = RouteContext;
 var useRouteContext = () => useContext(RouteContext);
-var wrappedRouteAdapterCache = /* @__PURE__ */ new WeakMap();
-var wrapRouteAdapterWithPathResolver = (adapter) => {
+var wrapRouteAdapterWithPathResolver = (adapter, getBasePath = () => adapter.getPath()) => {
   if (!adapter.push && !adapter.replace) {
     return adapter;
   }
-  const cachedAdapter = wrappedRouteAdapterCache.get(adapter);
-  if (cachedAdapter) {
-    return cachedAdapter;
-  }
   const wrappedAdapter = {
     ...adapter,
     push: adapter.push ? (path, title) => {
-      adapter.push?.(resolveRouteAdapterPath(adapter.getPath(), path), title);
+      adapter.push?.(resolveRouteAdapterPath(getBasePath(), path), title);
     } : void 0,
     replace: adapter.replace ? (path, title) => {
-      adapter.replace?.(resolveRouteAdapterPath(adapter.getPath(), path), title);
+      adapter.replace?.(resolveRouteAdapterPath(getBasePath(), path), title);
     } : void 0
   };
-  wrappedRouteAdapterCache.set(adapter, wrappedAdapter);
   return wrappedAdapter;
 };
+var getAdapterBasePath = (currentPath) => {
+  const normalizedPath = String(currentPath ?? "").trim();
+  if (normalizedPath === "") {
+    return "/";
+  }
+  const [pathOnly] = normalizedPath.split(/[?#]/, 1);
+  return pathOnly || "/";
+};
+var getMatchedRouteBasePath = (currentPath, matchedRoutePath) => {
+  const currentPathSegments = getPathArray(
+    getAdapterBasePath(currentPath),
+    PATH_DELIMITER,
+    true,
+    true,
+    false,
+    false
+  );
+  const matchedRouteSegments = getPathArray(matchedRoutePath);
+  const resolvedSegments = currentPathSegments.slice(0, matchedRouteSegments.length);
+  return resolvedSegments.length > 0 ? `/${resolvedSegments.join(PATH_DELIMITER)}` : "/";
+};
 var getWindow2 = () => {
   if (typeof globalThis === "undefined") {
     return void 0;
@@ -637,6 +661,10 @@ var RouteProvider = ({
   const [currentPath, setCurrentPath] = useState(
     initialPath ?? normalizedAdapter.getPath()
   );
+  const adapterBasePath = useMemo(
+    () => getAdapterBasePath(currentPath),
+    [currentPath]
+  );
   useEffect(() => {
     return normalizedAdapter.subscribe((nextPath) => {
       setCurrentPath(nextPath);
@@ -646,11 +674,13 @@ var RouteProvider = ({
     () => ({
       currentWindowPath: currentPath,
       parentPath: "",
+      parentPathInternal: "",
       params: {},
       isTopLevel: true,
+      adapterBasePath,
       adapter: normalizedAdapter
     }),
-    [currentPath, normalizedAdapter]
+    [currentPath, adapterBasePath, normalizedAdapter]
   );
   return /* @__PURE__ */ jsx(RouteContextProvider, { value: contextValue, children });
 };
@@ -666,7 +696,9 @@ var RouteMatcher = ({
   const {
     currentWindowPath = "",
     parentPath = "",
+    parentPathInternal = "",
     params: parentParams = {},
+    adapterBasePath: inheritedAdapterBasePath = "/",
     adapter
   } = useRouteContext();
   const targetCurrentPath = useMemo(
@@ -685,7 +717,10 @@ var RouteMatcher = ({
   const matchedRoute = useMemo(
     () => {
       for (const routePathConfig of normalizedPaths) {
-        const fullPath = mergeStringPaths(parentPath, routePathConfig.path);
+        const fullPath = mergeStringPaths(
+          parentPathInternal,
+          routePathConfig.path
+        );
         const newParams = getParamsAndTestPath(
           targetCurrentPath,
           fullPath,
@@ -700,7 +735,7 @@ var RouteMatcher = ({
       }
       return null;
     },
-    [targetCurrentPath, parentPath, normalizedPaths]
+    [targetCurrentPath, parentPathInternal, normalizedPaths]
   );
   const params = useMemo(
     () => ({
@@ -709,15 +744,32 @@ var RouteMatcher = ({
     }),
     [parentParams, matchedRoute]
   );
+  const matchedAdapterBasePath = useMemo(
+    () => matchedRoute ? getMatchedRouteBasePath(targetCurrentPath, matchedRoute.fullPath) : inheritedAdapterBasePath,
+    [targetCurrentPath, matchedRoute, inheritedAdapterBasePath]
+  );
+  const scopedAdapter = useMemo(
+    () => adapter ? wrapRouteAdapterWithPathResolver(adapter, () => matchedAdapterBasePath) : adapter,
+    [adapter, matchedAdapterBasePath]
+  );
   const newRouteContext = useMemo(
     () => ({
       currentWindowPath: targetCurrentPath,
-      parentPath: matchedRoute?.fullPath ?? parentPath,
+      parentPath: getReadableRoutePath(matchedRoute?.fullPath ?? parentPathInternal),
+      parentPathInternal: matchedRoute?.fullPath ?? parentPathInternal,
       params,
       isTopLevel: false,
-      adapter
+      adapterBasePath: matchedAdapterBasePath,
+      adapter: scopedAdapter
     }),
-    [targetCurrentPath, matchedRoute, parentPath, params, adapter]
+    [
+      targetCurrentPath,
+      matchedRoute,
+      parentPathInternal,
+      params,
+      matchedAdapterBasePath,
+      scopedAdapter
+    ]
   );
   useEffect(() => {
     if (onParamsChange) {

package/common/index.d.ts

@@ -7,10 +7,12 @@
  * Import from the common subpath only:
  * ```ts
  * import {
+ *   getPathArray,
  *   getPathString,
  *   getSimpleId,
  * } from "@resistdesign/voltra/common";
  *
+ * const segments = getPathArray("/users/42", "/", true, true, false, false);
  * const path = getPathString(["users", 42], "/", true, false);
  * const id = getSimpleId();
  * ```
@@ -28,6 +30,11 @@ export type * from "./HelperTypes";
  * @group Command Line
  */
 export * from "./CommandLine";
+/**
+ * @category common
+ * @group Routing
+ */
+export * from "./Routing";
 /**
  * @category common
  * @group Type Parsing

package/common/index.js

@@ -1,6 +1,6 @@
 export { ComparisonOperators, ITEM_RELATIONSHIP_DAC_RESOURCE_NAME, LogicalOperators, OperationGroup, RelationshipOperation, TypeInfoORMAPIRoutePaths, TypeInfoORMServiceError, TypeInfoORMUpdateOperators } from '../chunk-RUNXRISF.js';
-export { DENIED_TYPE_OPERATIONS, ERROR_MESSAGE_CONSTANTS, INVALID_CUSTOM_TYPE, PRIMITIVE_ERROR_MESSAGE_CONSTANTS, RelationshipValidationType, TYPE_KEYWORD_ERROR_MESSAGE_CONSTANTS, TYPE_KEYWORD_VALIDATORS, TypeOperation, getArrayItemErrorMap, getErrorDescriptor, getErrorDescriptors, getNoErrorDescriptor, getValidityValue, hasValue, isArrayErrorDescriptorCollection, validateArrayOfTypeInfoFieldValues, validateCustomType, validateKeywordType, validateTypeInfoDataItem, validateTypeInfoFieldOperationAllowed, validateTypeInfoFieldValue, validateTypeInfoValue, validateTypeOperationAllowed, validateValueMatchesPattern } from '../chunk-YCTVEW2I.js';
-import '../chunk-WNFRDIBW.js';
+export { DENIED_TYPE_OPERATIONS, ERROR_MESSAGE_CONSTANTS, INVALID_CUSTOM_TYPE, PRIMITIVE_ERROR_MESSAGE_CONSTANTS, RelationshipValidationType, TYPE_KEYWORD_ERROR_MESSAGE_CONSTANTS, TYPE_KEYWORD_VALIDATORS, TypeOperation, getArrayItemErrorMap, getErrorDescriptor, getErrorDescriptors, getNoErrorDescriptor, getValidityValue, hasValue, isArrayErrorDescriptorCollection, validateArrayOfTypeInfoFieldValues, validateCustomType, validateKeywordType, validateTypeInfoDataItem, validateTypeInfoFieldOperationAllowed, validateTypeInfoFieldValue, validateTypeInfoValue, validateTypeOperationAllowed, validateValueMatchesPattern } from '../chunk-3HVYVX3S.js';
+export { PATH_DELIMITER, getParamsAndTestPath, getPathArray, getPathString, getPotentialJSONValue, mergeStringPaths, resolvePath, resolveRouteAdapterPath } from '../chunk-2JDOM6PB.js';
 import '../chunk-I2KLQ2HA.js';
 
 // src/common/CommandLine/collectRequiredEnvironmentVariables.ts

package/native/index.js

@@ -1,7 +1,7 @@
 import { computeTrackPixels } from '../chunk-TJFTWPXQ.js';
-import { createFormRenderer, createHistoryBackHandler, buildHistoryPath, AutoFormView, AutoForm, parseTemplate, validateAreas, computeAreaBounds, parseHistoryPath, createMemoryHistory, createBrowserRouteAdapter, Route, createRouteAdapterFromHistory } from '../chunk-44BMFTKD.js';
-import { ERROR_MESSAGE_CONSTANTS } from '../chunk-YCTVEW2I.js';
-import '../chunk-WNFRDIBW.js';
+import { createFormRenderer, createHistoryBackHandler, buildHistoryPath, AutoFormView, AutoForm, parseTemplate, validateAreas, computeAreaBounds, parseHistoryPath, createMemoryHistory, useRouteContext, createBrowserRouteAdapter, Route, createRouteAdapterFromHistory } from '../chunk-K4R2PFNG.js';
+import { ERROR_MESSAGE_CONSTANTS } from '../chunk-3HVYVX3S.js';
+import '../chunk-2JDOM6PB.js';
 import '../chunk-I2KLQ2HA.js';
 import { createElement, useMemo, useRef } from 'react';
 import { Text, View, Platform, Switch, TextInput, Pressable, BackHandler } from 'react-native';
@@ -675,6 +675,33 @@ var createNativeHistory = (options = {}) => {
   };
 };
 var createNativeBackHandler = (history) => createHistoryBackHandler(history);
+var NavButton = ({
+  path,
+  replace = false,
+  onPress,
+  disabled,
+  children,
+  ...other
+}) => {
+  const { adapter } = useRouteContext();
+  const onPressInternal = (event) => {
+    onPress?.(event);
+    if (disabled || event?.defaultPrevented) {
+      return;
+    }
+    const navigate = replace ? adapter?.replace : adapter?.push;
+    navigate?.(path);
+  };
+  return createElement(
+    Pressable,
+    {
+      ...other,
+      disabled,
+      onPress: onPressInternal
+    },
+    children
+  );
+};
 var createNativeHardwareBackHandler = (adapter) => {
   return () => {
     if (adapter.canGoBack?.()) {
@@ -762,4 +789,4 @@ var Route2 = (props) => {
   ) : /* @__PURE__ */ jsx(Route, { ...routeProps });
 };
 
-export { ArrayContainer, ArrayItemWrapper, AutoField, AutoForm2 as AutoForm, AutoFormView2 as AutoFormView, Button, ErrorMessage, FieldWrapper, NativeEasyLayoutView, Route2 as Route, createNativeBackHandler, createNativeFormRenderer, createNativeHardwareBackHandler, createNativeHistory, createNativeRouteBackIntegration, makeNativeEasyLayout, mapNativeURLToPath, nativeAutoField, nativeSuite, registerNativeHardwareBackHandler, useNativeEasyLayout };
+export { ArrayContainer, ArrayItemWrapper, AutoField, AutoForm2 as AutoForm, AutoFormView2 as AutoFormView, Button, ErrorMessage, FieldWrapper, NativeEasyLayoutView, NavButton, Route2 as Route, createNativeBackHandler, createNativeFormRenderer, createNativeHardwareBackHandler, createNativeHistory, createNativeRouteBackIntegration, makeNativeEasyLayout, mapNativeURLToPath, nativeAutoField, nativeSuite, registerNativeHardwareBackHandler, useNativeEasyLayout };

package/native/utils/NavButton.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @packageDocumentation
+ *
+ * Native intra-application navigation button.
+ */
+import type { FC } from "react";
+import { type PressableProps } from "react-native";
+/**
+ * Props for {@link NavButton}.
+ */
+export type NavButtonProps = PressableProps & {
+    /** Relative or absolute Voltra route path. */
+    path: string;
+    /** Use adapter `replace` instead of `push` when true. */
+    replace?: boolean;
+};
+/**
+ * Render a pressable control that navigates within the current Voltra app.
+ *
+ * Relative paths resolve from the route context where this component renders.
+ *
+ * @param props - Pressable props plus the destination route path.
+ * @returns Pressable element wired to the current route adapter.
+ */
+export declare const NavButton: FC<NavButtonProps>;

package/native/utils/index.d.ts

@@ -13,6 +13,11 @@ export * from "./EasyLayout";
  * @group Layout and Navigation
  */
 export * from "./History";
+/**
+ * @category native
+ * @group Layout and Navigation
+ */
+export * from "./NavButton";
 /**
  * @category native
  * @group Layout and Navigation

package/package.json

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

package/web/index.js

@@ -1,7 +1,7 @@
-import { createEasyLayout } from '../chunk-CMH6L5QQ.js';
-import { createFormRenderer, AutoFormView, AutoForm, createBrowserRouteAdapter, Route } from '../chunk-44BMFTKD.js';
-import { ERROR_MESSAGE_CONSTANTS } from '../chunk-YCTVEW2I.js';
-import '../chunk-WNFRDIBW.js';
+import { createEasyLayout } from '../chunk-BSHQIRBV.js';
+import { createFormRenderer, AutoFormView, AutoForm, useRouteContext, createBrowserRouteAdapter, Route } from '../chunk-K4R2PFNG.js';
+import { ERROR_MESSAGE_CONSTANTS } from '../chunk-3HVYVX3S.js';
+import { resolveRouteAdapterPath } from '../chunk-2JDOM6PB.js';
 import { __export, __reExport } from '../chunk-I2KLQ2HA.js';
 import { createElement, useCallback, useRef } from 'react';
 import * as styledBase from 'styled-components';
@@ -648,6 +648,39 @@ var styledFactory = {
 var getEasyLayout = (extendFrom, areasExtendFrom, options = {}) => {
   return createEasyLayout(styledFactory, extendFrom, areasExtendFrom, options);
 };
+var NavLink = ({
+  path,
+  replace = false,
+  onClick,
+  title,
+  children,
+  ...other
+}) => {
+  const { adapter, adapterBasePath } = useRouteContext();
+  const href = resolveRouteAdapterPath(adapterBasePath, path);
+  const onClickInternal = (event) => {
+    onClick?.(event);
+    if (event.defaultPrevented || event.button !== 0 || event.metaKey || event.altKey || event.ctrlKey || event.shiftKey) {
+      return;
+    }
+    const navigate = replace ? adapter?.replace : adapter?.push;
+    if (!navigate) {
+      return;
+    }
+    event.preventDefault();
+    navigate(path, title);
+  };
+  return createElement(
+    "a",
+    {
+      ...other,
+      href,
+      title,
+      onClick: onClickInternal
+    },
+    children
+  );
+};
 var Route2 = (props) => {
   const hasMatcherProps = typeof props.path !== "undefined" || typeof props.exact !== "undefined" || typeof props.onParamsChange !== "undefined";
   const adapterRef = useRef(null);
@@ -665,4 +698,4 @@ var Route2 = (props) => {
   ) : /* @__PURE__ */ jsx(Route, { ...routeProps });
 };
 
-export { ArrayContainer, ArrayItemWrapper, AutoField, AutoForm2 as AutoForm, AutoFormView2 as AutoFormView, ErrorMessage, FieldWrapper, Route2 as Route, createWebFormRenderer, getEasyLayout, webAutoField, webSuite };
+export { ArrayContainer, ArrayItemWrapper, AutoField, AutoForm2 as AutoForm, AutoFormView2 as AutoFormView, ErrorMessage, FieldWrapper, NavLink, Route2 as Route, createWebFormRenderer, getEasyLayout, webAutoField, webSuite };

package/web/utils/NavLink.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @packageDocumentation
+ *
+ * Web intra-application navigation link.
+ */
+import type { AnchorHTMLAttributes, FC } from "react";
+/**
+ * Props for {@link NavLink}.
+ */
+export type NavLinkProps = Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "href"> & {
+    /** Relative or absolute Voltra route path. */
+    path: string;
+    /** Use adapter `replace` instead of `push` when true. */
+    replace?: boolean;
+};
+/**
+ * Render an anchor-like control that navigates within the current Voltra app.
+ *
+ * Relative paths resolve from the route context where this component renders.
+ *
+ * @param props - Anchor props plus the destination route path.
+ * @returns Anchor element wired to the current route adapter.
+ */
+export declare const NavLink: FC<NavLinkProps>;

package/web/utils/index.d.ts

@@ -4,4 +4,5 @@
  * Web-only utilities.
  */
 export * from "./EasyLayout";
+export * from "./NavLink";
 export * from "./Route";