@uniformdev/project-map 19.62.0 → 19.62.1-alpha.127

package/LICENSE.txt

@@ -1,2 +1,2 @@
-© 2023 Uniform Systems, Inc. All Rights Reserved.
+© 2024 Uniform Systems, Inc. All Rights Reserved.
 See details of Uniform Systems, Inc. Master Subscription Agreement here: https://uniform.dev/eula

package/dist/index.d.mts

@@ -1,4 +1,5 @@
 import { ApiClient } from '@uniformdev/context/api';
+import { RouteGetResponse } from '@uniformdev/canvas';
 
 /**
  * This file was auto-generated by openapi-typescript.
@@ -179,6 +180,15 @@ interface paths {
                     projectMapId?: string;
                     /** The project id that contains the project map tree that this node belongs to */
                     projectId: string;
+                    /**
+                     * The ID of a release to fetch the composition data for.
+                     *
+                     * - When unspecified, composition data is fetched from base.
+                     * - When specified, all content is returned as it would appear in the release if it was released now. This includes both content copied to the release and changed, as well as content that is not part of the release.
+                     *
+                     * Content copied to a release can be differentiated from base content by the `releaseId` property on the content. If the content is not copied to the release, this property will not be defined.
+                     */
+                    releaseId?: string;
                     /** The id of the node to retrieve, cannot have both this parameter and Path */
                     id?: string;
                     /** The path of the root node to retrieve, cannot have both this parameter and Id */
@@ -338,7 +348,7 @@ interface components {
              * @description The id of the projectMap entry
              */
             id: string;
-            /** @description Dot delimited path representing the path to the current node */
+            /** @description Path representing the path to the current node */
             path: string;
             /** @description Ordering of the node, higher numbers go after lower numbers. */
             order?: number;
@@ -349,7 +359,7 @@ interface components {
              * @description The type of the projectMap entry
              * @enum {string}
              */
-            type: "composition" | "redirect" | "placeholder";
+            type: "composition" | "placeholder";
             /**
              * Format: uuid
              * @description The composition id related to the projectMap entry
@@ -359,13 +369,34 @@ interface components {
             description?: string;
             /** @description Parent path of the current node, only included if requested with the expanded flag */
             parentPath?: string;
-            /** @description Last segment of the url, only included if requested with the expanded flag */
+            /** @description Last segment of the url */
             pathSegment?: string;
             /** @description returns true if the node is a leaf node, meaning having no children, only included if requested with the expanded flag */
             isLeaf?: boolean;
             compositionData?: components["schemas"]["ProjectMapNodeCompositionData"];
             sourceRedirects?: components["schemas"]["ProjectMapSourceRedirectData"];
             targetRedirects?: components["schemas"]["ProjectMapTargetRedirectData"];
+            locales?: {
+                [key: string]: components["schemas"]["ProjectMapNodeLocale"];
+            };
+        };
+        ProjectMapNodeLocale: {
+            /** @description Name of node in the locale */
+            name?: string;
+            /** @description Full path to the current node in this locale, only included if requested with the expanded flag */
+            path?: string;
+            /** @description Last segment of the url in this locale */
+            pathSegment: string;
+            /**
+             * @description When false, the node explicitly defines a locale specific path segment.
+             *
+             * When true, an ancestor defines a locale specific path segment,
+             * which makes its descendants resolvable using that segment.
+             * This node does not define a locale specific path segment.
+             *
+             * Only included if requested with the expanded flag. Without the expanded flag, inherited locales are not included in the response.
+             */
+            inherited?: boolean;
         };
         ProjectMapSourceRedirectData: {
             /**
@@ -407,6 +438,8 @@ interface components {
             icon?: string;
             /** @description Friendly name of this Composition's Definition */
             typeName?: string;
+            /** @description List of locales that the composition is available in. If empty, available in all locales. */
+            locales: string[];
         };
         ProjectMapNodeUpdate: {
             /**
@@ -425,7 +458,7 @@ interface components {
              * @description The type of the projectMap entry
              * @enum {string}
              */
-            type: "composition" | "redirect" | "placeholder";
+            type: "composition" | "placeholder";
             /**
              * Format: uuid
              * @description The composition id related to the projectMap entry
@@ -433,6 +466,15 @@ interface components {
             compositionId?: string;
             /** @description Description of the projectMap node */
             description?: string;
+            locales?: {
+                [key: string]: components["schemas"]["ProjectMapNodeLocaleUpdate"];
+            };
+        };
+        ProjectMapNodeLocaleUpdate: {
+            /** @description Name of node in the locale */
+            name?: string;
+            /** @description Locale specific path segment for this node (not a full path) */
+            pathSegment: string;
         };
         ProjectMapNodeData: {
             /** @description While performing a search if a node is a hit, this property will return true.  If it's supporting structure, like a parent of a search hit, it will return false */
@@ -450,7 +492,7 @@ interface components {
             /** @description The name of the query string parameter */
             name: string;
             /** @description The default value of the query string if it is not provided by an incoming route path */
-            value: string;
+            value?: string;
             /** @description Help text for authors who might be setting up a preview value for this query string */
             helpText?: string;
         };
@@ -517,10 +559,12 @@ interface external {
 
 type ProjectMapNodeUpsertRequest = paths['/api/v1/project-map-nodes']['put']['requestBody']['content']['application/json'];
 type ProjectMapNodeUpsertRequestNode = ProjectMapNodeUpsertRequest['nodes'][0]['node'];
+type ProjectMapNodeUpsertRequestNodeLocale = NonNullable<ProjectMapNodeUpsertRequestNode['locales']>[string];
 type ProjectMapNodeDeleteRequest = paths['/api/v1/project-map-nodes']['delete']['requestBody']['content']['application/json'];
 type ProjectMapNodeGetRequest = paths['/api/v1/project-map-nodes']['get']['parameters']['query'];
 type ProjectMapNodeGetResponse = paths['/api/v1/project-map-nodes']['get']['responses']['200']['content']['application/json'];
 type ProjectMapNode = NonNullable<ProjectMapNodeGetResponse['nodes']>[0];
+type ProjectMapNodeLocale = NonNullable<ProjectMapNode['locales']>[string];
 type ProjectMapNodeWithId = ProjectMapNode & Required<Pick<ProjectMapNode, 'id' | 'name'>>;
 type ProjectMapGetRequest = paths$1['/api/v1/project-map']['get']['parameters']['query'];
 type ProjectMapGetResponse = paths$1['/api/v1/project-map']['get']['responses']['200']['content']['application/json'];
@@ -529,7 +573,7 @@ type ProjectMapDeleteRequest = paths$1['/api/v1/project-map']['delete']['request
 type ProjectMapDefinition = ProjectMapGetResponse['projectMaps'][0];
 type ProjectMapDefinitionWithId = ProjectMapDefinition & Required<Pick<ProjectMapDefinition, 'id'>>;
 type ProjectMapUpsertResponse = paths$1['/api/v1/project-map']['put']['responses']['200']['content']['application/json'];
-type NodeType = 'placeholder' | 'composition' | 'redirect';
+type NodeType = ProjectMapNode['type'];
 type ProjectMapNodeWithProjectMapReference = ProjectMapNodeWithId & {
     projectMapId: string;
 };
@@ -621,6 +665,36 @@ declare class UncachedProjectMapClient extends ProjectMapClient {
     constructor(options: Omit<ProjectMapClientOptions, 'bypassCache'>);
 }
 
+type LocalePathNode = Pick<ProjectMapNode, 'path'> & {
+    locales?: Record<string, {
+        path?: string | undefined;
+    }>;
+};
+/**
+ * Given a project map node and a locale, resolves the correct path for the locale
+ * This is computed as follows:
+ * - If the locale is unspecified, then use the fallback path
+ * - If the locale is specified, then use the locale-specific path if it exists, otherwise use the fallback path
+ */
+declare function getNodeLocalePath(node: LocalePathNode, locale: string | undefined): string;
+declare function getNodeLocalePath(node: LocalePathNode | undefined, locale: string | undefined): string | null;
+
+type AlternateLocaleUrls = {
+    [locale: string]: string;
+};
+/**
+ * Gets all possible locale specific URLs for a composition route response
+ *
+ * This is appropriate for generating links to other locale versions of the current composition,
+ * such as for alternate language tags, language switchers, etc.
+ *
+ * The URLs will be:
+ * * Computed based on the attached project map node path
+ * * Not include a base URL from the project map, if one is set
+ * * If a dynamic locale path segment exists, it will be rewritten automatically to the target locale
+ */
+declare function getRouteAlternateLocalesUrls(routeResponse: RouteGetResponse): AlternateLocaleUrls | undefined;
+
 type MatchedRoute = {
     match: true;
     dynamicSegmentCount: number;
@@ -655,4 +729,4 @@ declare class Route {
     static dynamicSegmentPrefix: string;
 }
 
-export { ExpandOptions, MatchedRoute, NodeType, ProjectMapClient, ProjectMapClientOptions, ProjectMapDefinition, ProjectMapDefinitionWithId, ProjectMapDefinitions, ProjectMapDeleteRequest, ProjectMapGetRequest, ProjectMapGetResponse, ProjectMapNode, ProjectMapNodeAllowedQueryString, ProjectMapNodeData, ProjectMapNodeDeleteRequest, ProjectMapNodeGetRequest, ProjectMapNodeGetResponse, ProjectMapNodeUpsertRequest, ProjectMapNodeUpsertRequestNode, ProjectMapNodeWithId, ProjectMapNodeWithProjectMapReference, ProjectMapSubtree, ProjectMapUpsertRequest, ProjectMapUpsertResponse, ROOT_NODE_PATH, Route, UncachedProjectMapClient, UnmatchedRoute };
+export { type AlternateLocaleUrls, type ExpandOptions, type LocalePathNode, type MatchedRoute, type NodeType, ProjectMapClient, type ProjectMapClientOptions, type ProjectMapDefinition, type ProjectMapDefinitionWithId, type ProjectMapDefinitions, type ProjectMapDeleteRequest, type ProjectMapGetRequest, type ProjectMapGetResponse, type ProjectMapNode, type ProjectMapNodeAllowedQueryString, type ProjectMapNodeData, type ProjectMapNodeDeleteRequest, type ProjectMapNodeGetRequest, type ProjectMapNodeGetResponse, type ProjectMapNodeLocale, type ProjectMapNodeUpsertRequest, type ProjectMapNodeUpsertRequestNode, type ProjectMapNodeUpsertRequestNodeLocale, type ProjectMapNodeWithId, type ProjectMapNodeWithProjectMapReference, type ProjectMapSubtree, type ProjectMapUpsertRequest, type ProjectMapUpsertResponse, ROOT_NODE_PATH, Route, UncachedProjectMapClient, type UnmatchedRoute, getNodeLocalePath, getRouteAlternateLocalesUrls };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { ApiClient } from '@uniformdev/context/api';
+import { RouteGetResponse } from '@uniformdev/canvas';
 
 /**
  * This file was auto-generated by openapi-typescript.
@@ -179,6 +180,15 @@ interface paths {
                     projectMapId?: string;
                     /** The project id that contains the project map tree that this node belongs to */
                     projectId: string;
+                    /**
+                     * The ID of a release to fetch the composition data for.
+                     *
+                     * - When unspecified, composition data is fetched from base.
+                     * - When specified, all content is returned as it would appear in the release if it was released now. This includes both content copied to the release and changed, as well as content that is not part of the release.
+                     *
+                     * Content copied to a release can be differentiated from base content by the `releaseId` property on the content. If the content is not copied to the release, this property will not be defined.
+                     */
+                    releaseId?: string;
                     /** The id of the node to retrieve, cannot have both this parameter and Path */
                     id?: string;
                     /** The path of the root node to retrieve, cannot have both this parameter and Id */
@@ -338,7 +348,7 @@ interface components {
              * @description The id of the projectMap entry
              */
             id: string;
-            /** @description Dot delimited path representing the path to the current node */
+            /** @description Path representing the path to the current node */
             path: string;
             /** @description Ordering of the node, higher numbers go after lower numbers. */
             order?: number;
@@ -349,7 +359,7 @@ interface components {
              * @description The type of the projectMap entry
              * @enum {string}
              */
-            type: "composition" | "redirect" | "placeholder";
+            type: "composition" | "placeholder";
             /**
              * Format: uuid
              * @description The composition id related to the projectMap entry
@@ -359,13 +369,34 @@ interface components {
             description?: string;
             /** @description Parent path of the current node, only included if requested with the expanded flag */
             parentPath?: string;
-            /** @description Last segment of the url, only included if requested with the expanded flag */
+            /** @description Last segment of the url */
             pathSegment?: string;
             /** @description returns true if the node is a leaf node, meaning having no children, only included if requested with the expanded flag */
             isLeaf?: boolean;
             compositionData?: components["schemas"]["ProjectMapNodeCompositionData"];
             sourceRedirects?: components["schemas"]["ProjectMapSourceRedirectData"];
             targetRedirects?: components["schemas"]["ProjectMapTargetRedirectData"];
+            locales?: {
+                [key: string]: components["schemas"]["ProjectMapNodeLocale"];
+            };
+        };
+        ProjectMapNodeLocale: {
+            /** @description Name of node in the locale */
+            name?: string;
+            /** @description Full path to the current node in this locale, only included if requested with the expanded flag */
+            path?: string;
+            /** @description Last segment of the url in this locale */
+            pathSegment: string;
+            /**
+             * @description When false, the node explicitly defines a locale specific path segment.
+             *
+             * When true, an ancestor defines a locale specific path segment,
+             * which makes its descendants resolvable using that segment.
+             * This node does not define a locale specific path segment.
+             *
+             * Only included if requested with the expanded flag. Without the expanded flag, inherited locales are not included in the response.
+             */
+            inherited?: boolean;
         };
         ProjectMapSourceRedirectData: {
             /**
@@ -407,6 +438,8 @@ interface components {
             icon?: string;
             /** @description Friendly name of this Composition's Definition */
             typeName?: string;
+            /** @description List of locales that the composition is available in. If empty, available in all locales. */
+            locales: string[];
         };
         ProjectMapNodeUpdate: {
             /**
@@ -425,7 +458,7 @@ interface components {
              * @description The type of the projectMap entry
              * @enum {string}
              */
-            type: "composition" | "redirect" | "placeholder";
+            type: "composition" | "placeholder";
             /**
              * Format: uuid
              * @description The composition id related to the projectMap entry
@@ -433,6 +466,15 @@ interface components {
             compositionId?: string;
             /** @description Description of the projectMap node */
             description?: string;
+            locales?: {
+                [key: string]: components["schemas"]["ProjectMapNodeLocaleUpdate"];
+            };
+        };
+        ProjectMapNodeLocaleUpdate: {
+            /** @description Name of node in the locale */
+            name?: string;
+            /** @description Locale specific path segment for this node (not a full path) */
+            pathSegment: string;
         };
         ProjectMapNodeData: {
             /** @description While performing a search if a node is a hit, this property will return true.  If it's supporting structure, like a parent of a search hit, it will return false */
@@ -450,7 +492,7 @@ interface components {
             /** @description The name of the query string parameter */
             name: string;
             /** @description The default value of the query string if it is not provided by an incoming route path */
-            value: string;
+            value?: string;
             /** @description Help text for authors who might be setting up a preview value for this query string */
             helpText?: string;
         };
@@ -517,10 +559,12 @@ interface external {
 
 type ProjectMapNodeUpsertRequest = paths['/api/v1/project-map-nodes']['put']['requestBody']['content']['application/json'];
 type ProjectMapNodeUpsertRequestNode = ProjectMapNodeUpsertRequest['nodes'][0]['node'];
+type ProjectMapNodeUpsertRequestNodeLocale = NonNullable<ProjectMapNodeUpsertRequestNode['locales']>[string];
 type ProjectMapNodeDeleteRequest = paths['/api/v1/project-map-nodes']['delete']['requestBody']['content']['application/json'];
 type ProjectMapNodeGetRequest = paths['/api/v1/project-map-nodes']['get']['parameters']['query'];
 type ProjectMapNodeGetResponse = paths['/api/v1/project-map-nodes']['get']['responses']['200']['content']['application/json'];
 type ProjectMapNode = NonNullable<ProjectMapNodeGetResponse['nodes']>[0];
+type ProjectMapNodeLocale = NonNullable<ProjectMapNode['locales']>[string];
 type ProjectMapNodeWithId = ProjectMapNode & Required<Pick<ProjectMapNode, 'id' | 'name'>>;
 type ProjectMapGetRequest = paths$1['/api/v1/project-map']['get']['parameters']['query'];
 type ProjectMapGetResponse = paths$1['/api/v1/project-map']['get']['responses']['200']['content']['application/json'];
@@ -529,7 +573,7 @@ type ProjectMapDeleteRequest = paths$1['/api/v1/project-map']['delete']['request
 type ProjectMapDefinition = ProjectMapGetResponse['projectMaps'][0];
 type ProjectMapDefinitionWithId = ProjectMapDefinition & Required<Pick<ProjectMapDefinition, 'id'>>;
 type ProjectMapUpsertResponse = paths$1['/api/v1/project-map']['put']['responses']['200']['content']['application/json'];
-type NodeType = 'placeholder' | 'composition' | 'redirect';
+type NodeType = ProjectMapNode['type'];
 type ProjectMapNodeWithProjectMapReference = ProjectMapNodeWithId & {
     projectMapId: string;
 };
@@ -621,6 +665,36 @@ declare class UncachedProjectMapClient extends ProjectMapClient {
     constructor(options: Omit<ProjectMapClientOptions, 'bypassCache'>);
 }
 
+type LocalePathNode = Pick<ProjectMapNode, 'path'> & {
+    locales?: Record<string, {
+        path?: string | undefined;
+    }>;
+};
+/**
+ * Given a project map node and a locale, resolves the correct path for the locale
+ * This is computed as follows:
+ * - If the locale is unspecified, then use the fallback path
+ * - If the locale is specified, then use the locale-specific path if it exists, otherwise use the fallback path
+ */
+declare function getNodeLocalePath(node: LocalePathNode, locale: string | undefined): string;
+declare function getNodeLocalePath(node: LocalePathNode | undefined, locale: string | undefined): string | null;
+
+type AlternateLocaleUrls = {
+    [locale: string]: string;
+};
+/**
+ * Gets all possible locale specific URLs for a composition route response
+ *
+ * This is appropriate for generating links to other locale versions of the current composition,
+ * such as for alternate language tags, language switchers, etc.
+ *
+ * The URLs will be:
+ * * Computed based on the attached project map node path
+ * * Not include a base URL from the project map, if one is set
+ * * If a dynamic locale path segment exists, it will be rewritten automatically to the target locale
+ */
+declare function getRouteAlternateLocalesUrls(routeResponse: RouteGetResponse): AlternateLocaleUrls | undefined;
+
 type MatchedRoute = {
     match: true;
     dynamicSegmentCount: number;
@@ -655,4 +729,4 @@ declare class Route {
     static dynamicSegmentPrefix: string;
 }
 
-export { ExpandOptions, MatchedRoute, NodeType, ProjectMapClient, ProjectMapClientOptions, ProjectMapDefinition, ProjectMapDefinitionWithId, ProjectMapDefinitions, ProjectMapDeleteRequest, ProjectMapGetRequest, ProjectMapGetResponse, ProjectMapNode, ProjectMapNodeAllowedQueryString, ProjectMapNodeData, ProjectMapNodeDeleteRequest, ProjectMapNodeGetRequest, ProjectMapNodeGetResponse, ProjectMapNodeUpsertRequest, ProjectMapNodeUpsertRequestNode, ProjectMapNodeWithId, ProjectMapNodeWithProjectMapReference, ProjectMapSubtree, ProjectMapUpsertRequest, ProjectMapUpsertResponse, ROOT_NODE_PATH, Route, UncachedProjectMapClient, UnmatchedRoute };
+export { type AlternateLocaleUrls, type ExpandOptions, type LocalePathNode, type MatchedRoute, type NodeType, ProjectMapClient, type ProjectMapClientOptions, type ProjectMapDefinition, type ProjectMapDefinitionWithId, type ProjectMapDefinitions, type ProjectMapDeleteRequest, type ProjectMapGetRequest, type ProjectMapGetResponse, type ProjectMapNode, type ProjectMapNodeAllowedQueryString, type ProjectMapNodeData, type ProjectMapNodeDeleteRequest, type ProjectMapNodeGetRequest, type ProjectMapNodeGetResponse, type ProjectMapNodeLocale, type ProjectMapNodeUpsertRequest, type ProjectMapNodeUpsertRequestNode, type ProjectMapNodeUpsertRequestNodeLocale, type ProjectMapNodeWithId, type ProjectMapNodeWithProjectMapReference, type ProjectMapSubtree, type ProjectMapUpsertRequest, type ProjectMapUpsertResponse, ROOT_NODE_PATH, Route, UncachedProjectMapClient, type UnmatchedRoute, getNodeLocalePath, getRouteAlternateLocalesUrls };

package/dist/index.esm.js

@@ -177,7 +177,8 @@ var ProjectMapClient = class extends ApiClient {
       order: node.order,
       data: node.data,
       compositionId: node.compositionId,
-      description: node.description
+      description: node.description,
+      locales: node.locales
     };
   }
 };
@@ -192,6 +193,14 @@ var cutReferences = (node) => node ? {
   children: void 0
 } : void 0;
 
+// src/util/getNodeLocalePath.ts
+function getNodeLocalePath(node, locale) {
+  var _a, _b;
+  if (!node)
+    return null;
+  return locale ? ((_b = (_a = node.locales) == null ? void 0 : _a[locale]) == null ? void 0 : _b.path) || node.path : node.path;
+}
+
 // src/util/Route.ts
 import { createVariableReference, parseVariableExpression } from "@uniformdev/canvas";
 var _routeInfo, _parseRouteOrPath, parseRouteOrPath_fn, _isDynamicRouteSegment, isDynamicRouteSegment_fn;
@@ -253,13 +262,6 @@ var _Route = class _Route {
       }
       const dynamicSegmentValue = dynamicInputValues[dynamicSegmentName];
       if (!dynamicSegmentValue) {
-        console.log(
-          "Missing dynamic input value for",
-          dynamicSegmentName,
-          "in",
-          this.route,
-          "using literal value"
-        );
         return segment;
       }
       return encodeRouteComponent(dynamicSegmentValue, doNotEscapeVariables);
@@ -290,14 +292,19 @@ parseRouteOrPath_fn = function(path) {
   if (!path.startsWith("/") || path === "") {
     throw new Error(`Path must start with a slash: ${path}`);
   }
-  const pathSegments = path.substring(1).split("/");
-  const [lastSegmentWithoutQuery, queryString] = pathSegments[pathSegments.length - 1].split("?");
-  pathSegments[pathSegments.length - 1] = lastSegmentWithoutQuery;
+  const [pathname, queryString] = path.split("?");
+  const pathSegments = pathname.substring(1).split("/");
+  if (pathSegments[pathSegments.length - 1] === "") {
+    pathSegments.pop();
+  }
   const queryParams = new URLSearchParams(queryString);
   return { segments: pathSegments, queryParams };
 };
 _isDynamicRouteSegment = new WeakSet();
 isDynamicRouteSegment_fn = function(segment) {
+  if (!segment) {
+    return false;
+  }
   return segment.startsWith(_Route.dynamicSegmentPrefix);
 };
 __privateAdd(_Route, _parseRouteOrPath);
@@ -318,9 +325,39 @@ function encodeRouteComponent(value, doNotEscapeVariables) {
   });
   return result.join("");
 }
+
+// src/util/getRouteAlternateLocaleUrls.ts
+function getRouteAlternateLocalesUrls(routeResponse) {
+  var _a;
+  if (routeResponse.type === "notFound" || routeResponse.type === "redirect") {
+    return void 0;
+  }
+  const enabledLocalesOnComposition = routeResponse.compositionApiResponse.composition._locales;
+  if (!enabledLocalesOnComposition) {
+    return void 0;
+  }
+  const projectMapNode = (_a = routeResponse.compositionApiResponse.composition.projectMapNodes) == null ? void 0 : _a[0];
+  if (!projectMapNode) {
+    return void 0;
+  }
+  return enabledLocalesOnComposition.reduce((acc, locale) => {
+    const path = getNodeLocalePath(projectMapNode, locale);
+    const dynamicInputsWithCurrentLocale = {
+      ...routeResponse.dynamicInputs,
+      locale
+    };
+    const alternateLocalePath = new Route(path).expand({
+      dynamicInputValues: dynamicInputsWithCurrentLocale
+    });
+    acc[locale] = alternateLocalePath;
+    return acc;
+  }, {});
+}
 export {
   ProjectMapClient,
   ROOT_NODE_PATH,
   Route,
-  UncachedProjectMapClient
+  UncachedProjectMapClient,
+  getNodeLocalePath,
+  getRouteAlternateLocalesUrls
 };

package/dist/index.js

@@ -45,7 +45,9 @@ __export(src_exports, {
   ProjectMapClient: () => ProjectMapClient,
   ROOT_NODE_PATH: () => ROOT_NODE_PATH,
   Route: () => Route,
-  UncachedProjectMapClient: () => UncachedProjectMapClient
+  UncachedProjectMapClient: () => UncachedProjectMapClient,
+  getNodeLocalePath: () => getNodeLocalePath,
+  getRouteAlternateLocalesUrls: () => getRouteAlternateLocalesUrls
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -205,7 +207,8 @@ var ProjectMapClient = class extends import_api.ApiClient {
       order: node.order,
       data: node.data,
       compositionId: node.compositionId,
-      description: node.description
+      description: node.description,
+      locales: node.locales
     };
   }
 };
@@ -220,6 +223,14 @@ var cutReferences = (node) => node ? {
   children: void 0
 } : void 0;
 
+// src/util/getNodeLocalePath.ts
+function getNodeLocalePath(node, locale) {
+  var _a, _b;
+  if (!node)
+    return null;
+  return locale ? ((_b = (_a = node.locales) == null ? void 0 : _a[locale]) == null ? void 0 : _b.path) || node.path : node.path;
+}
+
 // src/util/Route.ts
 var import_canvas = require("@uniformdev/canvas");
 var _routeInfo, _parseRouteOrPath, parseRouteOrPath_fn, _isDynamicRouteSegment, isDynamicRouteSegment_fn;
@@ -281,13 +292,6 @@ var _Route = class _Route {
       }
       const dynamicSegmentValue = dynamicInputValues[dynamicSegmentName];
       if (!dynamicSegmentValue) {
-        console.log(
-          "Missing dynamic input value for",
-          dynamicSegmentName,
-          "in",
-          this.route,
-          "using literal value"
-        );
         return segment;
       }
       return encodeRouteComponent(dynamicSegmentValue, doNotEscapeVariables);
@@ -318,14 +322,19 @@ parseRouteOrPath_fn = function(path) {
   if (!path.startsWith("/") || path === "") {
     throw new Error(`Path must start with a slash: ${path}`);
   }
-  const pathSegments = path.substring(1).split("/");
-  const [lastSegmentWithoutQuery, queryString] = pathSegments[pathSegments.length - 1].split("?");
-  pathSegments[pathSegments.length - 1] = lastSegmentWithoutQuery;
+  const [pathname, queryString] = path.split("?");
+  const pathSegments = pathname.substring(1).split("/");
+  if (pathSegments[pathSegments.length - 1] === "") {
+    pathSegments.pop();
+  }
   const queryParams = new URLSearchParams(queryString);
   return { segments: pathSegments, queryParams };
 };
 _isDynamicRouteSegment = new WeakSet();
 isDynamicRouteSegment_fn = function(segment) {
+  if (!segment) {
+    return false;
+  }
   return segment.startsWith(_Route.dynamicSegmentPrefix);
 };
 __privateAdd(_Route, _parseRouteOrPath);
@@ -346,10 +355,40 @@ function encodeRouteComponent(value, doNotEscapeVariables) {
   });
   return result.join("");
 }
+
+// src/util/getRouteAlternateLocaleUrls.ts
+function getRouteAlternateLocalesUrls(routeResponse) {
+  var _a;
+  if (routeResponse.type === "notFound" || routeResponse.type === "redirect") {
+    return void 0;
+  }
+  const enabledLocalesOnComposition = routeResponse.compositionApiResponse.composition._locales;
+  if (!enabledLocalesOnComposition) {
+    return void 0;
+  }
+  const projectMapNode = (_a = routeResponse.compositionApiResponse.composition.projectMapNodes) == null ? void 0 : _a[0];
+  if (!projectMapNode) {
+    return void 0;
+  }
+  return enabledLocalesOnComposition.reduce((acc, locale) => {
+    const path = getNodeLocalePath(projectMapNode, locale);
+    const dynamicInputsWithCurrentLocale = {
+      ...routeResponse.dynamicInputs,
+      locale
+    };
+    const alternateLocalePath = new Route(path).expand({
+      dynamicInputValues: dynamicInputsWithCurrentLocale
+    });
+    acc[locale] = alternateLocalePath;
+    return acc;
+  }, {});
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ProjectMapClient,
   ROOT_NODE_PATH,
   Route,
-  UncachedProjectMapClient
+  UncachedProjectMapClient,
+  getNodeLocalePath,
+  getRouteAlternateLocalesUrls
 });

package/dist/index.mjs

@@ -177,7 +177,8 @@ var ProjectMapClient = class extends ApiClient {
       order: node.order,
       data: node.data,
       compositionId: node.compositionId,
-      description: node.description
+      description: node.description,
+      locales: node.locales
     };
   }
 };
@@ -192,6 +193,14 @@ var cutReferences = (node) => node ? {
   children: void 0
 } : void 0;
 
+// src/util/getNodeLocalePath.ts
+function getNodeLocalePath(node, locale) {
+  var _a, _b;
+  if (!node)
+    return null;
+  return locale ? ((_b = (_a = node.locales) == null ? void 0 : _a[locale]) == null ? void 0 : _b.path) || node.path : node.path;
+}
+
 // src/util/Route.ts
 import { createVariableReference, parseVariableExpression } from "@uniformdev/canvas";
 var _routeInfo, _parseRouteOrPath, parseRouteOrPath_fn, _isDynamicRouteSegment, isDynamicRouteSegment_fn;
@@ -253,13 +262,6 @@ var _Route = class _Route {
       }
       const dynamicSegmentValue = dynamicInputValues[dynamicSegmentName];
       if (!dynamicSegmentValue) {
-        console.log(
-          "Missing dynamic input value for",
-          dynamicSegmentName,
-          "in",
-          this.route,
-          "using literal value"
-        );
         return segment;
       }
       return encodeRouteComponent(dynamicSegmentValue, doNotEscapeVariables);
@@ -290,14 +292,19 @@ parseRouteOrPath_fn = function(path) {
   if (!path.startsWith("/") || path === "") {
     throw new Error(`Path must start with a slash: ${path}`);
   }
-  const pathSegments = path.substring(1).split("/");
-  const [lastSegmentWithoutQuery, queryString] = pathSegments[pathSegments.length - 1].split("?");
-  pathSegments[pathSegments.length - 1] = lastSegmentWithoutQuery;
+  const [pathname, queryString] = path.split("?");
+  const pathSegments = pathname.substring(1).split("/");
+  if (pathSegments[pathSegments.length - 1] === "") {
+    pathSegments.pop();
+  }
   const queryParams = new URLSearchParams(queryString);
   return { segments: pathSegments, queryParams };
 };
 _isDynamicRouteSegment = new WeakSet();
 isDynamicRouteSegment_fn = function(segment) {
+  if (!segment) {
+    return false;
+  }
   return segment.startsWith(_Route.dynamicSegmentPrefix);
 };
 __privateAdd(_Route, _parseRouteOrPath);
@@ -318,9 +325,39 @@ function encodeRouteComponent(value, doNotEscapeVariables) {
   });
   return result.join("");
 }
+
+// src/util/getRouteAlternateLocaleUrls.ts
+function getRouteAlternateLocalesUrls(routeResponse) {
+  var _a;
+  if (routeResponse.type === "notFound" || routeResponse.type === "redirect") {
+    return void 0;
+  }
+  const enabledLocalesOnComposition = routeResponse.compositionApiResponse.composition._locales;
+  if (!enabledLocalesOnComposition) {
+    return void 0;
+  }
+  const projectMapNode = (_a = routeResponse.compositionApiResponse.composition.projectMapNodes) == null ? void 0 : _a[0];
+  if (!projectMapNode) {
+    return void 0;
+  }
+  return enabledLocalesOnComposition.reduce((acc, locale) => {
+    const path = getNodeLocalePath(projectMapNode, locale);
+    const dynamicInputsWithCurrentLocale = {
+      ...routeResponse.dynamicInputs,
+      locale
+    };
+    const alternateLocalePath = new Route(path).expand({
+      dynamicInputValues: dynamicInputsWithCurrentLocale
+    });
+    acc[locale] = alternateLocalePath;
+    return acc;
+  }, {});
+}
 export {
   ProjectMapClient,
   ROOT_NODE_PATH,
   Route,
-  UncachedProjectMapClient
+  UncachedProjectMapClient,
+  getNodeLocalePath,
+  getRouteAlternateLocalesUrls
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniformdev/project-map",
-  "version": "19.62.0",
+  "version": "19.62.1-alpha.127+d49e5a0782",
   "description": "Uniform Project Map",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "./dist/index.js",
@@ -33,11 +33,11 @@
     "/dist"
   ],
   "dependencies": {
-    "@uniformdev/canvas": "19.62.0",
-    "@uniformdev/context": "19.62.0"
+    "@uniformdev/canvas": "19.62.1-alpha.127+d49e5a0782",
+    "@uniformdev/context": "19.62.1-alpha.127+d49e5a0782"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "dcaa272276caccfec3318d2a028cf4efa8a569a8"
+  "gitHead": "d49e5a07824d69e5df3a92ff10bc9acd88d0bc22"
 }