@ethisyscore/plugin-ui 1.87.0 → 1.88.0

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

@@ -288,6 +288,42 @@ declare function PluginStyleScope({ id, css }: {
     css: string;
 }): null;
 
+/**
+ * Reserved host resource carrying the caller organisation's effective date/time
+ * display formats. The host proxies it (see coreconnect-web
+ * `surfaceMcpTransport.ts`) from the permission-free
+ * `/organisations/current/display-formats` endpoint. The URI string is hardcoded
+ * on both sides of the runtime host↔plugin contract, exactly like
+ * `ethisys:user-permissions`.
+ */
+declare const ORGANISATION_SETTINGS_URI = "ethisys:organisation-settings";
+/**
+ * Reads the caller organisation's effective date/time display formats from the
+ * reserved {@link ORGANISATION_SETTINGS_URI} host resource and stamps them into
+ * the core-utils org-format refs, so THIS plugin bundle's org-aware formatters
+ * (`@ethisyscore/core-utils/date/org-format`) and `DateInput` picker masks render
+ * in the organisation's configured format.
+ *
+ * Each plugin bundle owns its own copy of those module refs, so this must run per
+ * bundle — `definePlatformReactPluginPage` and `definePlatformReactPluginOverlay`
+ * auto-call it once per surface mount, so plugins wire nothing.
+ *
+ * Reactive: the org format arrives asynchronously, after the surface (and its
+ * `DateInput`s) have already rendered on the UK fallback. The module refs are
+ * non-React, so a `useState` bump here re-renders the surface once the formats
+ * resolve, letting already-mounted formatters and picker masks pick them up. The
+ * effect is also keyed on the active organisation id, so switching organisation
+ * without a remount refetches.
+ *
+ * Fails open. It resolves the transport via the OPTIONAL accessor (not
+ * `useMcpResource`, which throws when no provider is present) so a surface that
+ * renders without a host transport — a standalone/mock-mode run or an isolated
+ * unit test — degrades to a no-op and the formatters use the UK fallback, rather
+ * than crashing the page. On a rejected/failed fetch the refs are reset to the UK
+ * fallback rather than left holding a previous organisation's format.
+ */
+declare function useOrgFormatSync(): void;
+
 /**
  * Class on the portal container element rendered at the end of a plugin surface.
  * `plugin-base.css` positions it; the class is exported so a plugin can target it
@@ -1306,4 +1342,4 @@ interface MenuConfigHostSidebarOptions {
  */
 declare function menuConfigToHostSidebarInput(config: HeaderMenuItem[], opts: MenuConfigHostSidebarOptions): HostSidebarHookInput;
 
-export { type AuthenticatedQueryResult, BaseMcpService, DEFAULT_MAX_UPLOAD_BYTES, type DefinePlatformReactPluginOverlayOptions, type DefinePlatformReactPluginPageOptions, EHX_PLUGIN_PORTAL_ATTR, EHX_PLUGIN_PORTAL_CLASS, EHX_PLUGIN_ROOT_CLASS, HostSidebarHookInput, HostSidebarInput, type InsetLease, type ManagedLifecycle, type McpToolArgs, type McpToolContract, type McpToolContracts, type McpToolResult, type MenuConfigHostSidebarOptions, MissingViewFallback, OVERLAY_HOST_CONTRACT_VERSION, type OverlayHostApi, type OverlayHostCapabilities, OverlayHostContext, type PlatformReactOverlayProps, type PluginOverlayDefinerConfig, type PluginPageDefinerConfig, PluginPortalScope, PluginStyleScope, type ReactRouterShimOptions, SurfaceBaseContext, type SurfaceBaseValue, TemplateContext, type TemplateManifest, type ToHostSidebarInputOptions, type ToolInvoker, TypedMcpService, type UseMcpUploadOptions, type UseMcpUploadResult, type UseMcpUploadTarget, type ViewComponent, buildSurfaceUrl, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, deriveHostEntityToken, injectPluginStyles, isComponent, mcpTool, menuConfigToHostSidebarInput, normaliseSlug, notViaMcp, resolveSurfaceBase, surfacePathFor, toHostSidebarInput, useAuthenticatedQueries, useAuthenticatedQuery, useManagedLifecycle, useMcpUpload, useOverlayHost, usePluginRealtime, useSurfaceUrl, useToolInvoker, useToolInvokerMap, useTypedToolInvokerMap, useView };
+export { type AuthenticatedQueryResult, BaseMcpService, DEFAULT_MAX_UPLOAD_BYTES, type DefinePlatformReactPluginOverlayOptions, type DefinePlatformReactPluginPageOptions, EHX_PLUGIN_PORTAL_ATTR, EHX_PLUGIN_PORTAL_CLASS, EHX_PLUGIN_ROOT_CLASS, HostSidebarHookInput, HostSidebarInput, type InsetLease, type ManagedLifecycle, type McpToolArgs, type McpToolContract, type McpToolContracts, type McpToolResult, type MenuConfigHostSidebarOptions, MissingViewFallback, ORGANISATION_SETTINGS_URI, OVERLAY_HOST_CONTRACT_VERSION, type OverlayHostApi, type OverlayHostCapabilities, OverlayHostContext, type PlatformReactOverlayProps, type PluginOverlayDefinerConfig, type PluginPageDefinerConfig, PluginPortalScope, PluginStyleScope, type ReactRouterShimOptions, SurfaceBaseContext, type SurfaceBaseValue, TemplateContext, type TemplateManifest, type ToHostSidebarInputOptions, type ToolInvoker, TypedMcpService, type UseMcpUploadOptions, type UseMcpUploadResult, type UseMcpUploadTarget, type ViewComponent, buildSurfaceUrl, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, deriveHostEntityToken, injectPluginStyles, isComponent, mcpTool, menuConfigToHostSidebarInput, normaliseSlug, notViaMcp, resolveSurfaceBase, surfacePathFor, toHostSidebarInput, useAuthenticatedQueries, useAuthenticatedQuery, useManagedLifecycle, useMcpUpload, useOrgFormatSync, useOverlayHost, usePluginRealtime, useSurfaceUrl, useToolInvoker, useToolInvokerMap, useTypedToolInvokerMap, useView };

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

@@ -288,6 +288,42 @@ declare function PluginStyleScope({ id, css }: {
     css: string;
 }): null;
 
+/**
+ * Reserved host resource carrying the caller organisation's effective date/time
+ * display formats. The host proxies it (see coreconnect-web
+ * `surfaceMcpTransport.ts`) from the permission-free
+ * `/organisations/current/display-formats` endpoint. The URI string is hardcoded
+ * on both sides of the runtime host↔plugin contract, exactly like
+ * `ethisys:user-permissions`.
+ */
+declare const ORGANISATION_SETTINGS_URI = "ethisys:organisation-settings";
+/**
+ * Reads the caller organisation's effective date/time display formats from the
+ * reserved {@link ORGANISATION_SETTINGS_URI} host resource and stamps them into
+ * the core-utils org-format refs, so THIS plugin bundle's org-aware formatters
+ * (`@ethisyscore/core-utils/date/org-format`) and `DateInput` picker masks render
+ * in the organisation's configured format.
+ *
+ * Each plugin bundle owns its own copy of those module refs, so this must run per
+ * bundle — `definePlatformReactPluginPage` and `definePlatformReactPluginOverlay`
+ * auto-call it once per surface mount, so plugins wire nothing.
+ *
+ * Reactive: the org format arrives asynchronously, after the surface (and its
+ * `DateInput`s) have already rendered on the UK fallback. The module refs are
+ * non-React, so a `useState` bump here re-renders the surface once the formats
+ * resolve, letting already-mounted formatters and picker masks pick them up. The
+ * effect is also keyed on the active organisation id, so switching organisation
+ * without a remount refetches.
+ *
+ * Fails open. It resolves the transport via the OPTIONAL accessor (not
+ * `useMcpResource`, which throws when no provider is present) so a surface that
+ * renders without a host transport — a standalone/mock-mode run or an isolated
+ * unit test — degrades to a no-op and the formatters use the UK fallback, rather
+ * than crashing the page. On a rejected/failed fetch the refs are reset to the UK
+ * fallback rather than left holding a previous organisation's format.
+ */
+declare function useOrgFormatSync(): void;
+
 /**
  * Class on the portal container element rendered at the end of a plugin surface.
  * `plugin-base.css` positions it; the class is exported so a plugin can target it
@@ -1306,4 +1342,4 @@ interface MenuConfigHostSidebarOptions {
  */
 declare function menuConfigToHostSidebarInput(config: HeaderMenuItem[], opts: MenuConfigHostSidebarOptions): HostSidebarHookInput;
 
-export { type AuthenticatedQueryResult, BaseMcpService, DEFAULT_MAX_UPLOAD_BYTES, type DefinePlatformReactPluginOverlayOptions, type DefinePlatformReactPluginPageOptions, EHX_PLUGIN_PORTAL_ATTR, EHX_PLUGIN_PORTAL_CLASS, EHX_PLUGIN_ROOT_CLASS, HostSidebarHookInput, HostSidebarInput, type InsetLease, type ManagedLifecycle, type McpToolArgs, type McpToolContract, type McpToolContracts, type McpToolResult, type MenuConfigHostSidebarOptions, MissingViewFallback, OVERLAY_HOST_CONTRACT_VERSION, type OverlayHostApi, type OverlayHostCapabilities, OverlayHostContext, type PlatformReactOverlayProps, type PluginOverlayDefinerConfig, type PluginPageDefinerConfig, PluginPortalScope, PluginStyleScope, type ReactRouterShimOptions, SurfaceBaseContext, type SurfaceBaseValue, TemplateContext, type TemplateManifest, type ToHostSidebarInputOptions, type ToolInvoker, TypedMcpService, type UseMcpUploadOptions, type UseMcpUploadResult, type UseMcpUploadTarget, type ViewComponent, buildSurfaceUrl, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, deriveHostEntityToken, injectPluginStyles, isComponent, mcpTool, menuConfigToHostSidebarInput, normaliseSlug, notViaMcp, resolveSurfaceBase, surfacePathFor, toHostSidebarInput, useAuthenticatedQueries, useAuthenticatedQuery, useManagedLifecycle, useMcpUpload, useOverlayHost, usePluginRealtime, useSurfaceUrl, useToolInvoker, useToolInvokerMap, useTypedToolInvokerMap, useView };
+export { type AuthenticatedQueryResult, BaseMcpService, DEFAULT_MAX_UPLOAD_BYTES, type DefinePlatformReactPluginOverlayOptions, type DefinePlatformReactPluginPageOptions, EHX_PLUGIN_PORTAL_ATTR, EHX_PLUGIN_PORTAL_CLASS, EHX_PLUGIN_ROOT_CLASS, HostSidebarHookInput, HostSidebarInput, type InsetLease, type ManagedLifecycle, type McpToolArgs, type McpToolContract, type McpToolContracts, type McpToolResult, type MenuConfigHostSidebarOptions, MissingViewFallback, ORGANISATION_SETTINGS_URI, OVERLAY_HOST_CONTRACT_VERSION, type OverlayHostApi, type OverlayHostCapabilities, OverlayHostContext, type PlatformReactOverlayProps, type PluginOverlayDefinerConfig, type PluginPageDefinerConfig, PluginPortalScope, PluginStyleScope, type ReactRouterShimOptions, SurfaceBaseContext, type SurfaceBaseValue, TemplateContext, type TemplateManifest, type ToHostSidebarInputOptions, type ToolInvoker, TypedMcpService, type UseMcpUploadOptions, type UseMcpUploadResult, type UseMcpUploadTarget, type ViewComponent, buildSurfaceUrl, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, deriveHostEntityToken, injectPluginStyles, isComponent, mcpTool, menuConfigToHostSidebarInput, normaliseSlug, notViaMcp, resolveSurfaceBase, surfacePathFor, toHostSidebarInput, useAuthenticatedQueries, useAuthenticatedQuery, useManagedLifecycle, useMcpUpload, useOrgFormatSync, useOverlayHost, usePluginRealtime, useSurfaceUrl, useToolInvoker, useToolInvokerMap, useTypedToolInvokerMap, useView };

package/dist/platform-react/index.js

@@ -1,9 +1,10 @@
 import { createContext, useEffect, useContext, useState, useMemo, createElement, useRef, useCallback, useSyncExternalStore } from 'react';
 import { QueryClient, useQuery, useQueries, QueryClientProvider } from '@tanstack/react-query';
 import { definePlatformReactPage, emitNavigation } from '@ethisyscore/components-react';
-import { useHostIdentity, useMcpTool, usePluginRealtimeSource, useExtensionRuntimeTransport } from '@ethisyscore/extension-runtime/plugin';
+import { useHostIdentity, useOptionalExtensionRuntimeTransport, useMcpTool, usePluginRealtimeSource, useExtensionRuntimeTransport } from '@ethisyscore/extension-runtime/plugin';
 import { useTheme, ThemeProvider } from '@mui/material';
 import { jsxs, jsx } from 'react/jsx-runtime';
+import { setOrgFormats } from '@ethisyscore/core-utils/date/org-format';
 
 // src/platform-react/definePlatformReactPluginPage.tsx
 var TemplateContext = createContext(null);
@@ -147,6 +148,28 @@ function PluginPortalScope({ children }) {
     /* @__PURE__ */ jsx("div", { ref: setContainer, className: EHX_PLUGIN_PORTAL_CLASS, ...{ [EHX_PLUGIN_PORTAL_ATTR]: "" } })
   ] });
 }
+var ORGANISATION_SETTINGS_URI = "ethisys:organisation-settings";
+function useOrgFormatSync() {
+  const transport = useOptionalExtensionRuntimeTransport();
+  const organisationId = useHostIdentity()?.organisationId ?? null;
+  const [, bumpVersion] = useState(0);
+  useEffect(() => {
+    setOrgFormats(null, null);
+    bumpVersion((v) => v + 1);
+    if (!transport) return;
+    const controller = new AbortController();
+    transport.getResource(ORGANISATION_SETTINGS_URI, controller.signal).then((result) => {
+      if (controller.signal.aborted) return;
+      setOrgFormats(result.data?.dateFormat ?? null, result.data?.timeFormat ?? null);
+      bumpVersion((v) => v + 1);
+    }).catch(() => {
+      if (controller.signal.aborted) return;
+      setOrgFormats(null, null);
+      bumpVersion((v) => v + 1);
+    });
+    return () => controller.abort();
+  }, [transport, organisationId]);
+}
 
 // src/platform-react/definePlatformReactPluginPage.tsx
 function makeDefaultQueryClient() {
@@ -172,6 +195,7 @@ function definePlatformReactPluginPage(Page, options) {
     wrapPage
   } = options;
   function PluginPage(props) {
+    useOrgFormatSync();
     const page = createElement(Page, props);
     const body = wrapPage ? wrapPage(page) : page;
     const surfaceTree = createElement(
@@ -580,6 +604,7 @@ var defaultQueryClient2 = makeDefaultQueryClient2();
 function definePlatformReactPluginOverlay(Overlay, options) {
   const { rootClassName, styleId, css, manifest = {}, queryClient = defaultQueryClient2, wrapOverlay } = options;
   return function MountedOverlay(props) {
+    useOrgFormatSync();
     const tree = createElement(
       OverlayHostContext.Provider,
       { value: props.overlayHost },
@@ -902,6 +927,6 @@ function menuConfigToHostSidebarInput(config, opts) {
   return { mode: "actions", actions };
 }
 
-export { BaseMcpService, DEFAULT_MAX_UPLOAD_BYTES, EHX_PLUGIN_PORTAL_ATTR, EHX_PLUGIN_PORTAL_CLASS, EHX_PLUGIN_ROOT_CLASS, HOST_CHROME_CONTRACT_VERSION, HostSidebarActionsContext, MissingViewFallback, OVERLAY_HOST_CONTRACT_VERSION, OverlayHostContext, PluginPortalScope, PluginStyleScope, SIDEBAR_MODE, SurfaceBaseContext, TemplateContext, TypedMcpService, buildSurfaceUrl, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, deriveHostEntityToken, injectPluginStyles, isComponent, isHostChromeCompatible, mcpTool, menuConfigToHostSidebarInput, normaliseSlug, notViaMcp, reportHostChromeDiagnostic, resolveSurfaceBase, setHostChromeDiagnosticSink, surfacePathFor, toHostSidebarInput, useAuthenticatedQueries, useAuthenticatedQuery, useHostSidebarActions, useManagedLifecycle, useMcpUpload, useOverlayHost, usePluginRealtime, useSurfaceUrl, useToolInvoker, useToolInvokerMap, useTypedToolInvokerMap, useView };
+export { BaseMcpService, DEFAULT_MAX_UPLOAD_BYTES, EHX_PLUGIN_PORTAL_ATTR, EHX_PLUGIN_PORTAL_CLASS, EHX_PLUGIN_ROOT_CLASS, HOST_CHROME_CONTRACT_VERSION, HostSidebarActionsContext, MissingViewFallback, ORGANISATION_SETTINGS_URI, OVERLAY_HOST_CONTRACT_VERSION, OverlayHostContext, PluginPortalScope, PluginStyleScope, SIDEBAR_MODE, SurfaceBaseContext, TemplateContext, TypedMcpService, buildSurfaceUrl, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, deriveHostEntityToken, injectPluginStyles, isComponent, isHostChromeCompatible, mcpTool, menuConfigToHostSidebarInput, normaliseSlug, notViaMcp, reportHostChromeDiagnostic, resolveSurfaceBase, setHostChromeDiagnosticSink, surfacePathFor, toHostSidebarInput, useAuthenticatedQueries, useAuthenticatedQuery, useHostSidebarActions, useManagedLifecycle, useMcpUpload, useOrgFormatSync, useOverlayHost, usePluginRealtime, useSurfaceUrl, useToolInvoker, useToolInvokerMap, useTypedToolInvokerMap, useView };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map