@ethisyscore/plugin-ui 1.53.0 → 1.54.0

package/dist/platform-react/index.d.cts

@@ -5,9 +5,9 @@ import { QueryClient, UseQueryResult, UseQueryOptions, QueryKey } from '@tanstac
 import { PlatformReactPageProps } from '@ethisyscore/components-react';
 import * as _tanstack_query_core from '@tanstack/query-core';
 import { McpTransport, UploadDocumentResult } from '@ethisyscore/extension-runtime/plugin';
-import { k as HostSidebarInput } from '../useHostSidebarActions-CyNYWKiv.cjs';
-export { H as HOST_CHROME_CONTRACT_VERSION, a as HostChromeDiagnostic, b as HostSidebarAction, c as HostSidebarActionDescriptor, d as HostSidebarActionSlot, e as HostSidebarActionVariant, f as HostSidebarActionsApi, g as HostSidebarActionsCapabilities, h as HostSidebarActionsContext, i as HostSidebarActionsPageProps, j as HostSidebarContribution, l as HostSidebarNavItem, S as SIDEBAR_MODE, m as isHostChromeCompatible, r as reportHostChromeDiagnostic, s as setHostChromeDiagnosticSink, u as useHostSidebarActions } from '../useHostSidebarActions-CyNYWKiv.cjs';
-import { g as PluginDetailContext } from '../pageHeaderTypes-PWZpiwp6.cjs';
+import { k as HostSidebarInput, n as HostSidebarHookInput } from '../useHostSidebarActions-Bt2U-EuA.cjs';
+export { H as HOST_CHROME_CONTRACT_VERSION, a as HostChromeDiagnostic, b as HostSidebarAction, c as HostSidebarActionDescriptor, d as HostSidebarActionSlot, e as HostSidebarActionVariant, f as HostSidebarActionsApi, g as HostSidebarActionsCapabilities, h as HostSidebarActionsContext, i as HostSidebarActionsPageProps, j as HostSidebarContribution, o as HostSidebarDerivedInput, l as HostSidebarNavItem, S as SIDEBAR_MODE, m as isHostChromeCompatible, r as reportHostChromeDiagnostic, s as setHostChromeDiagnosticSink, u as useHostSidebarActions } from '../useHostSidebarActions-Bt2U-EuA.cjs';
+import { g as PluginDetailContext, H as HeaderMenuItem } from '../pageHeaderTypes-PWZpiwp6.cjs';
 
 /** A view component resolved from the template manifest. Props are open. */
 type ViewComponent = ComponentType<Record<string, unknown>>;
@@ -1050,6 +1050,16 @@ declare function resolveSurfaceBase(input: {
     base: string;
     groupRoot: string;
 } | null;
+/**
+ * Mirror of the HOST mount's `deriveEntityToken` (PlatformReactSurfaceMount): the
+ * route sub-path relative to the PAGE-surface `basePath` — which is the page
+ * route's STATIC leading segments, so a fully-static page (list routes) yields
+ * `"/"` because there the pathname IS the basePath. The host silently drops a
+ * publish whose `entityToken` doesn't match its own derivation, so this must stay
+ * bit-identical to the host helper. No basePath (legacy host) falls back to the
+ * full pathname, exactly like the host does.
+ */
+declare function deriveHostEntityToken(pathname: string, basePath: string | undefined): string;
 /** Join base + sub (leading slash stripped) + optional ?query/#hash suffix. */
 declare function buildSurfaceUrl(base: string, sub?: string, suffix?: string): string;
 /**
@@ -1114,4 +1124,50 @@ interface ToHostSidebarInputOptions {
  */
 declare function toHostSidebarInput(context: PluginDetailContext | null | undefined, opts: ToHostSidebarInputOptions): HostSidebarInput;
 
-export { type AuthenticatedQueryResult, BaseMcpService, DEFAULT_MAX_UPLOAD_BYTES, type DefinePlatformReactPluginOverlayOptions, type DefinePlatformReactPluginPageOptions, EHX_PLUGIN_ROOT_CLASS, HostSidebarInput, type InsetLease, type ManagedLifecycle, MissingViewFallback, OVERLAY_HOST_CONTRACT_VERSION, type OverlayHostApi, type OverlayHostCapabilities, OverlayHostContext, type PlatformReactOverlayProps, type PluginOverlayDefinerConfig, type PluginPageDefinerConfig, PluginStyleScope, type ReactRouterShimOptions, SurfaceBaseContext, type SurfaceBaseValue, TemplateContext, type TemplateManifest, type ToHostSidebarInputOptions, type ToolInvoker, type UseMcpUploadOptions, type UseMcpUploadResult, type UseMcpUploadTarget, type ViewComponent, buildSurfaceUrl, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, injectPluginStyles, isComponent, normaliseSlug, notViaMcp, resolveSurfaceBase, surfacePathFor, toHostSidebarInput, useAuthenticatedQueries, useAuthenticatedQuery, useManagedLifecycle, useMcpUpload, useOverlayHost, usePluginRealtime, useSurfaceUrl, useToolInvoker, useToolInvokerMap, useView };
+/**
+ * Options for {@link menuConfigToHostSidebarInput}.
+ */
+interface MenuConfigHostSidebarOptions {
+    /** The CURRENT pathname (full host path, e.g. `/extensions/projects/roles`). */
+    pathname: string;
+    /**
+     * Dispatch bridge for `actionId` actions — pass the plugin's
+     * `useTriggerSidebarAction()` (from `@ethisyscore/plugin-ui/components/layout`)
+     * so a sidebar click reaches the same `useSidebarActions` handler the header
+     * uses. (A parameter rather than an internal hook call: the sidebar-action
+     * context must come from the SAME `components/layout` module instance the
+     * plugin's provider uses — the cross-entry singleton pitfall.)
+     */
+    onDispatch: (actionId: string) => void;
+    /**
+     * The plugin's mount base (e.g. `/extensions/projects`), stripped from action
+     * hrefs to make them slug-relative for the host confiner. Defaults to the
+     * `/extensions/<slug>` prefix of `pathname`.
+     */
+    mountBase?: string;
+}
+/**
+ * Map the ACTIVE menu item's `actions` to a `useHostSidebarActions` input — the
+ * runtime analogue of the monolith shell surfacing the active `menuConfig` item's
+ * actions as the sidebar "Quick actions" section. Detail routes are covered by
+ * `toHostSidebarInput` over a `*DetailContext`; THIS covers the menu-item (list)
+ * routes, which otherwise contribute nothing and render an empty Quick Actions
+ * panel (static manifest `NavigationActionItem`s can only navigate — they cannot
+ * cover dialog/`actionId` CTAs at all).
+ *
+ * Typical bridge shape:
+ * ```ts
+ * const input = detailCtx
+ *   ? toHostSidebarInput(detailCtx, { basePath, entityToken, onDispatch })
+ *   : menuConfigToHostSidebarInput(menuConfig, { pathname, onDispatch });
+ * useHostSidebarActions(input);
+ * ```
+ *
+ * The result carries NO `entityToken` — `useHostSidebarActions` derives the
+ * host-mirrored token from the surface base, which is correct by construction.
+ * Routes without a matching menu item (or with no mappable actions) yield
+ * `{mode:"none"}`, preserving the static-manifest fallback.
+ */
+declare function menuConfigToHostSidebarInput(config: HeaderMenuItem[], opts: MenuConfigHostSidebarOptions): HostSidebarHookInput;
+
+export { type AuthenticatedQueryResult, BaseMcpService, DEFAULT_MAX_UPLOAD_BYTES, type DefinePlatformReactPluginOverlayOptions, type DefinePlatformReactPluginPageOptions, EHX_PLUGIN_ROOT_CLASS, HostSidebarHookInput, HostSidebarInput, type InsetLease, type ManagedLifecycle, type MenuConfigHostSidebarOptions, MissingViewFallback, OVERLAY_HOST_CONTRACT_VERSION, type OverlayHostApi, type OverlayHostCapabilities, OverlayHostContext, type PlatformReactOverlayProps, type PluginOverlayDefinerConfig, type PluginPageDefinerConfig, PluginStyleScope, type ReactRouterShimOptions, SurfaceBaseContext, type SurfaceBaseValue, TemplateContext, type TemplateManifest, type ToHostSidebarInputOptions, type ToolInvoker, type UseMcpUploadOptions, type UseMcpUploadResult, type UseMcpUploadTarget, type ViewComponent, buildSurfaceUrl, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, deriveHostEntityToken, injectPluginStyles, isComponent, menuConfigToHostSidebarInput, normaliseSlug, notViaMcp, resolveSurfaceBase, surfacePathFor, toHostSidebarInput, useAuthenticatedQueries, useAuthenticatedQuery, useManagedLifecycle, useMcpUpload, useOverlayHost, usePluginRealtime, useSurfaceUrl, useToolInvoker, useToolInvokerMap, useView };

package/dist/platform-react/index.d.ts

@@ -5,9 +5,9 @@ import { QueryClient, UseQueryResult, UseQueryOptions, QueryKey } from '@tanstac
 import { PlatformReactPageProps } from '@ethisyscore/components-react';
 import * as _tanstack_query_core from '@tanstack/query-core';
 import { McpTransport, UploadDocumentResult } from '@ethisyscore/extension-runtime/plugin';
-import { k as HostSidebarInput } from '../useHostSidebarActions-CyNYWKiv.js';
-export { H as HOST_CHROME_CONTRACT_VERSION, a as HostChromeDiagnostic, b as HostSidebarAction, c as HostSidebarActionDescriptor, d as HostSidebarActionSlot, e as HostSidebarActionVariant, f as HostSidebarActionsApi, g as HostSidebarActionsCapabilities, h as HostSidebarActionsContext, i as HostSidebarActionsPageProps, j as HostSidebarContribution, l as HostSidebarNavItem, S as SIDEBAR_MODE, m as isHostChromeCompatible, r as reportHostChromeDiagnostic, s as setHostChromeDiagnosticSink, u as useHostSidebarActions } from '../useHostSidebarActions-CyNYWKiv.js';
-import { g as PluginDetailContext } from '../pageHeaderTypes-PWZpiwp6.js';
+import { k as HostSidebarInput, n as HostSidebarHookInput } from '../useHostSidebarActions-Bt2U-EuA.js';
+export { H as HOST_CHROME_CONTRACT_VERSION, a as HostChromeDiagnostic, b as HostSidebarAction, c as HostSidebarActionDescriptor, d as HostSidebarActionSlot, e as HostSidebarActionVariant, f as HostSidebarActionsApi, g as HostSidebarActionsCapabilities, h as HostSidebarActionsContext, i as HostSidebarActionsPageProps, j as HostSidebarContribution, o as HostSidebarDerivedInput, l as HostSidebarNavItem, S as SIDEBAR_MODE, m as isHostChromeCompatible, r as reportHostChromeDiagnostic, s as setHostChromeDiagnosticSink, u as useHostSidebarActions } from '../useHostSidebarActions-Bt2U-EuA.js';
+import { g as PluginDetailContext, H as HeaderMenuItem } from '../pageHeaderTypes-PWZpiwp6.js';
 
 /** A view component resolved from the template manifest. Props are open. */
 type ViewComponent = ComponentType<Record<string, unknown>>;
@@ -1050,6 +1050,16 @@ declare function resolveSurfaceBase(input: {
     base: string;
     groupRoot: string;
 } | null;
+/**
+ * Mirror of the HOST mount's `deriveEntityToken` (PlatformReactSurfaceMount): the
+ * route sub-path relative to the PAGE-surface `basePath` — which is the page
+ * route's STATIC leading segments, so a fully-static page (list routes) yields
+ * `"/"` because there the pathname IS the basePath. The host silently drops a
+ * publish whose `entityToken` doesn't match its own derivation, so this must stay
+ * bit-identical to the host helper. No basePath (legacy host) falls back to the
+ * full pathname, exactly like the host does.
+ */
+declare function deriveHostEntityToken(pathname: string, basePath: string | undefined): string;
 /** Join base + sub (leading slash stripped) + optional ?query/#hash suffix. */
 declare function buildSurfaceUrl(base: string, sub?: string, suffix?: string): string;
 /**
@@ -1114,4 +1124,50 @@ interface ToHostSidebarInputOptions {
  */
 declare function toHostSidebarInput(context: PluginDetailContext | null | undefined, opts: ToHostSidebarInputOptions): HostSidebarInput;
 
-export { type AuthenticatedQueryResult, BaseMcpService, DEFAULT_MAX_UPLOAD_BYTES, type DefinePlatformReactPluginOverlayOptions, type DefinePlatformReactPluginPageOptions, EHX_PLUGIN_ROOT_CLASS, HostSidebarInput, type InsetLease, type ManagedLifecycle, MissingViewFallback, OVERLAY_HOST_CONTRACT_VERSION, type OverlayHostApi, type OverlayHostCapabilities, OverlayHostContext, type PlatformReactOverlayProps, type PluginOverlayDefinerConfig, type PluginPageDefinerConfig, PluginStyleScope, type ReactRouterShimOptions, SurfaceBaseContext, type SurfaceBaseValue, TemplateContext, type TemplateManifest, type ToHostSidebarInputOptions, type ToolInvoker, type UseMcpUploadOptions, type UseMcpUploadResult, type UseMcpUploadTarget, type ViewComponent, buildSurfaceUrl, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, injectPluginStyles, isComponent, normaliseSlug, notViaMcp, resolveSurfaceBase, surfacePathFor, toHostSidebarInput, useAuthenticatedQueries, useAuthenticatedQuery, useManagedLifecycle, useMcpUpload, useOverlayHost, usePluginRealtime, useSurfaceUrl, useToolInvoker, useToolInvokerMap, useView };
+/**
+ * Options for {@link menuConfigToHostSidebarInput}.
+ */
+interface MenuConfigHostSidebarOptions {
+    /** The CURRENT pathname (full host path, e.g. `/extensions/projects/roles`). */
+    pathname: string;
+    /**
+     * Dispatch bridge for `actionId` actions — pass the plugin's
+     * `useTriggerSidebarAction()` (from `@ethisyscore/plugin-ui/components/layout`)
+     * so a sidebar click reaches the same `useSidebarActions` handler the header
+     * uses. (A parameter rather than an internal hook call: the sidebar-action
+     * context must come from the SAME `components/layout` module instance the
+     * plugin's provider uses — the cross-entry singleton pitfall.)
+     */
+    onDispatch: (actionId: string) => void;
+    /**
+     * The plugin's mount base (e.g. `/extensions/projects`), stripped from action
+     * hrefs to make them slug-relative for the host confiner. Defaults to the
+     * `/extensions/<slug>` prefix of `pathname`.
+     */
+    mountBase?: string;
+}
+/**
+ * Map the ACTIVE menu item's `actions` to a `useHostSidebarActions` input — the
+ * runtime analogue of the monolith shell surfacing the active `menuConfig` item's
+ * actions as the sidebar "Quick actions" section. Detail routes are covered by
+ * `toHostSidebarInput` over a `*DetailContext`; THIS covers the menu-item (list)
+ * routes, which otherwise contribute nothing and render an empty Quick Actions
+ * panel (static manifest `NavigationActionItem`s can only navigate — they cannot
+ * cover dialog/`actionId` CTAs at all).
+ *
+ * Typical bridge shape:
+ * ```ts
+ * const input = detailCtx
+ *   ? toHostSidebarInput(detailCtx, { basePath, entityToken, onDispatch })
+ *   : menuConfigToHostSidebarInput(menuConfig, { pathname, onDispatch });
+ * useHostSidebarActions(input);
+ * ```
+ *
+ * The result carries NO `entityToken` — `useHostSidebarActions` derives the
+ * host-mirrored token from the surface base, which is correct by construction.
+ * Routes without a matching menu item (or with no mappable actions) yield
+ * `{mode:"none"}`, preserving the static-manifest fallback.
+ */
+declare function menuConfigToHostSidebarInput(config: HeaderMenuItem[], opts: MenuConfigHostSidebarOptions): HostSidebarHookInput;
+
+export { type AuthenticatedQueryResult, BaseMcpService, DEFAULT_MAX_UPLOAD_BYTES, type DefinePlatformReactPluginOverlayOptions, type DefinePlatformReactPluginPageOptions, EHX_PLUGIN_ROOT_CLASS, HostSidebarHookInput, HostSidebarInput, type InsetLease, type ManagedLifecycle, type MenuConfigHostSidebarOptions, MissingViewFallback, OVERLAY_HOST_CONTRACT_VERSION, type OverlayHostApi, type OverlayHostCapabilities, OverlayHostContext, type PlatformReactOverlayProps, type PluginOverlayDefinerConfig, type PluginPageDefinerConfig, PluginStyleScope, type ReactRouterShimOptions, SurfaceBaseContext, type SurfaceBaseValue, TemplateContext, type TemplateManifest, type ToHostSidebarInputOptions, type ToolInvoker, type UseMcpUploadOptions, type UseMcpUploadResult, type UseMcpUploadTarget, type ViewComponent, buildSurfaceUrl, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, deriveHostEntityToken, injectPluginStyles, isComponent, menuConfigToHostSidebarInput, normaliseSlug, notViaMcp, resolveSurfaceBase, surfacePathFor, toHostSidebarInput, useAuthenticatedQueries, useAuthenticatedQuery, useManagedLifecycle, useMcpUpload, useOverlayHost, usePluginRealtime, useSurfaceUrl, useToolInvoker, useToolInvokerMap, useView };

package/dist/platform-react/index.js

@@ -41,6 +41,19 @@ function resolveSurfaceBase(input) {
   }
   return null;
 }
+function deriveHostEntityToken(pathname, basePath) {
+  if (!basePath) {
+    return pathname;
+  }
+  const base = stripTrailingSlash(basePath);
+  if (pathname === base) {
+    return "/";
+  }
+  if (pathname.startsWith(`${base}/`)) {
+    return pathname.slice(base.length);
+  }
+  return pathname;
+}
 function buildSurfaceUrl(base, sub = "", suffix = "") {
   const b = stripTrailingSlash(base);
   const s = sub.replace(/^\/+/, "");
@@ -649,9 +662,17 @@ function reportNoHost(pageId) {
 }
 function useHostSidebarActions(input) {
   const api = useContext(HostSidebarActionsContext);
-  const pageId = useContext(SurfaceBaseContext)?.pageId;
+  const surfaceBase = useContext(SurfaceBaseContext);
+  const pageId = surfaceBase?.pageId;
   const compatible = api && isHostChromeCompatible(api.capabilities?.contractVersion) ? api : null;
-  const actions = input.mode === SIDEBAR_MODE.none ? [] : input.actions;
+  const resolved = input.mode === SIDEBAR_MODE.none ? input : typeof input.entityToken === "string" ? input : "entityToken" in input ? { mode: SIDEBAR_MODE.none } : {
+    ...input,
+    entityToken: deriveHostEntityToken(
+      typeof window !== "undefined" ? window.location.pathname : "",
+      surfaceBase?.basePath
+    )
+  };
+  const actions = resolved.mode === SIDEBAR_MODE.none ? [] : resolved.actions;
   const handlers = useRef(/* @__PURE__ */ new Map());
   handlers.current = new Map(collectDispatchHandlers(actions));
   useEffect(() => {
@@ -667,10 +688,10 @@ function useHostSidebarActions(input) {
       unsub();
     };
   }, [compatible, pageId]);
-  const key = contributionKey(input);
+  const key = contributionKey(resolved);
   useEffect(() => {
     if (!compatible) return;
-    compatible.publish(toContribution(input));
+    compatible.publish(toContribution(resolved));
   }, [compatible, key]);
 }
 
@@ -701,7 +722,7 @@ function slugRelative(href, basePath) {
   return href.startsWith(prefix) ? href.slice(prefix.length) : href;
 }
 function isConfinable(slugRelativeHref) {
-  return slugRelativeHref.length > 0 && !slugRelativeHref.startsWith("/") && !/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(slugRelativeHref) && !slugRelativeHref.includes("#");
+  return slugRelativeHref.length > 0 && !slugRelativeHref.startsWith("/") && !/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(slugRelativeHref) && !slugRelativeHref.includes("#") && !slugRelativeHref.split("?")[0].split("/").some((seg) => seg === "." || seg === "..");
 }
 function toHostActions(actions, opts) {
   const seen = /* @__PURE__ */ new Set();
@@ -748,6 +769,57 @@ function toHostAction(item, opts, seen) {
   return null;
 }
 
-export { BaseMcpService, DEFAULT_MAX_UPLOAD_BYTES, EHX_PLUGIN_ROOT_CLASS, HOST_CHROME_CONTRACT_VERSION, HostSidebarActionsContext, MissingViewFallback, OVERLAY_HOST_CONTRACT_VERSION, OverlayHostContext, PluginStyleScope, SIDEBAR_MODE, SurfaceBaseContext, TemplateContext, buildSurfaceUrl, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, injectPluginStyles, isComponent, isHostChromeCompatible, normaliseSlug, notViaMcp, reportHostChromeDiagnostic, resolveSurfaceBase, setHostChromeDiagnosticSink, surfacePathFor, toHostSidebarInput, useAuthenticatedQueries, useAuthenticatedQuery, useHostSidebarActions, useManagedLifecycle, useMcpUpload, useOverlayHost, usePluginRealtime, useSurfaceUrl, useToolInvoker, useToolInvokerMap, useView };
+// src/platform-react/menuConfigHostSidebar.ts
+function normalise(pathname) {
+  return pathname.length > 1 && pathname.endsWith("/") ? pathname.slice(0, -1) : pathname;
+}
+function findByHref(items, pathname) {
+  for (const item of items) {
+    if (item.href != null && normalise(item.href) === pathname) {
+      return item;
+    }
+    if (item.children) {
+      const nested = findByHref(item.children, pathname);
+      if (nested) {
+        return nested;
+      }
+    }
+  }
+  return null;
+}
+function toItem(a) {
+  return {
+    id: a.id,
+    label: a.label,
+    icon: a.icon,
+    href: a.href,
+    actionId: a.actionId,
+    onClick: a.onClick,
+    variant: a.variant === "danger" ? "danger" : void 0,
+    slot: a.slot,
+    disabled: a.disabled,
+    children: a.children?.map(toItem)
+  };
+}
+function menuConfigToHostSidebarInput(config, opts) {
+  const item = findByHref(config, normalise(opts.pathname));
+  if (!item?.actions?.length) {
+    return { mode: "none" };
+  }
+  const mountBase = opts.mountBase ?? /^\/extensions\/[^/]+/.exec(opts.pathname)?.[0];
+  if (!mountBase) {
+    return { mode: "none" };
+  }
+  const actions = toHostActions(item.actions.map(toItem), {
+    basePath: mountBase,
+    onDispatch: opts.onDispatch
+  });
+  if (actions.length === 0) {
+    return { mode: "none" };
+  }
+  return { mode: "actions", actions };
+}
+
+export { BaseMcpService, DEFAULT_MAX_UPLOAD_BYTES, EHX_PLUGIN_ROOT_CLASS, HOST_CHROME_CONTRACT_VERSION, HostSidebarActionsContext, MissingViewFallback, OVERLAY_HOST_CONTRACT_VERSION, OverlayHostContext, PluginStyleScope, SIDEBAR_MODE, SurfaceBaseContext, TemplateContext, buildSurfaceUrl, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, deriveHostEntityToken, injectPluginStyles, isComponent, isHostChromeCompatible, menuConfigToHostSidebarInput, normaliseSlug, notViaMcp, reportHostChromeDiagnostic, resolveSurfaceBase, setHostChromeDiagnosticSink, surfacePathFor, toHostSidebarInput, useAuthenticatedQueries, useAuthenticatedQuery, useHostSidebarActions, useManagedLifecycle, useMcpUpload, useOverlayHost, usePluginRealtime, useSurfaceUrl, useToolInvoker, useToolInvokerMap, useView };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map