@ai-matrx/sharing 0.1.9 → 0.1.11

package/dist/access-react.d.cts

@@ -184,6 +184,8 @@ interface AccessUiEnv {
 }
 /** The documented default for `manualRequestActionKey`. */
 declare const REQUEST_ACCESS_MANUAL_ACTION = "request_access.manual";
+/** Test seam: forget what was announced. */
+declare function resetAccessUiStandInNotices(): void;
 /** The host's `Link`, resolved at render. Components import this as `Link`. */
 declare const AccessLink: react.ForwardRefExoticComponent<AccessUiLinkProps & RefAttributes<HTMLAnchorElement>>;
 /**
@@ -679,4 +681,4 @@ declare function offerOwnerChoices(error: unknown, request: CantRemoveRequest):
  */
 declare function ensureRemovable(request: CantRemoveRequest): Promise<boolean>;
 
-export { ACCESS_REQUESTS_HREF, AccessDenied, type AccessDeniedProps, type AccessDeniedSuggestion, AccessDeniedView, AccessGate, type AccessGateProps, AccessLink, AccessRequestsSurface, type AccessResourceActionRequestAction, type AccessSettingRequestAction, type AccessUi, type AccessUiCurrentUser, type AccessUiEntityInfo, type AccessUiEntityRefProps, type AccessUiEnv, type AccessUiErrorMenuProps, type AccessUiFeedbackInput, type AccessUiLinkProps, AccessUiProvider, type AccessUiRouter, type AccessUiTextareaProps, type AccessUiToast, type AccessUiUserIdentityProps, BlindAccessAsk, CANT_REMOVE_DIALOG, type CantRemoveOutcome, type CantRemoveRequest, ForbiddenSurfaceView, type ForbiddenSurfaceViewProps, GovernedActionDialog, HiddenByMeButton, HiddenFilter, REQUEST_ACCESS_MANUAL_ACTION, RemovalNotYoursError, RequestAccess, RequestAccessPanel, type RequestAccessResult, ResourceActionRequestButtons, ServerReadRecheck, type ServerReadRecheckToken, SettingAccessGate, SettingRequestActionButtons, SlugAccessGate, type SlugAccessGateProps, UnresolvedEntityRef, type UnresolvedEntityRefProps, type UseAccessGateResult, type UseAccessStatesResult, configureAccessUi, ensureRemovable, getAccessUi, isAccessUiConfigured, isRemovalNotYours, offerOwnerChoices, refreshHiddenByMe, requestCantRemove, useAccessGate, useAccessStates, useAccessUi, useHiddenByMe, useHiddenItems, useHideForMe, useRemovalRights, useRequestAccess };
+export { ACCESS_REQUESTS_HREF, AccessDenied, type AccessDeniedProps, type AccessDeniedSuggestion, AccessDeniedView, AccessGate, type AccessGateProps, AccessLink, AccessRequestsSurface, type AccessResourceActionRequestAction, type AccessSettingRequestAction, type AccessUi, type AccessUiCurrentUser, type AccessUiEntityInfo, type AccessUiEntityRefProps, type AccessUiEnv, type AccessUiErrorMenuProps, type AccessUiFeedbackInput, type AccessUiLinkProps, AccessUiProvider, type AccessUiRouter, type AccessUiTextareaProps, type AccessUiToast, type AccessUiUserIdentityProps, BlindAccessAsk, CANT_REMOVE_DIALOG, type CantRemoveOutcome, type CantRemoveRequest, ForbiddenSurfaceView, type ForbiddenSurfaceViewProps, GovernedActionDialog, HiddenByMeButton, HiddenFilter, REQUEST_ACCESS_MANUAL_ACTION, RemovalNotYoursError, RequestAccess, RequestAccessPanel, type RequestAccessResult, ResourceActionRequestButtons, ServerReadRecheck, type ServerReadRecheckToken, SettingAccessGate, SettingRequestActionButtons, SlugAccessGate, type SlugAccessGateProps, UnresolvedEntityRef, type UnresolvedEntityRefProps, type UseAccessGateResult, type UseAccessStatesResult, configureAccessUi, ensureRemovable, getAccessUi, isAccessUiConfigured, isRemovalNotYours, offerOwnerChoices, refreshHiddenByMe, requestCantRemove, resetAccessUiStandInNotices, useAccessGate, useAccessStates, useAccessUi, useHiddenByMe, useHiddenItems, useHideForMe, useRemovalRights, useRequestAccess };

package/dist/access-react.d.ts

@@ -184,6 +184,8 @@ interface AccessUiEnv {
 }
 /** The documented default for `manualRequestActionKey`. */
 declare const REQUEST_ACCESS_MANUAL_ACTION = "request_access.manual";
+/** Test seam: forget what was announced. */
+declare function resetAccessUiStandInNotices(): void;
 /** The host's `Link`, resolved at render. Components import this as `Link`. */
 declare const AccessLink: react.ForwardRefExoticComponent<AccessUiLinkProps & RefAttributes<HTMLAnchorElement>>;
 /**
@@ -679,4 +681,4 @@ declare function offerOwnerChoices(error: unknown, request: CantRemoveRequest):
  */
 declare function ensureRemovable(request: CantRemoveRequest): Promise<boolean>;
 
-export { ACCESS_REQUESTS_HREF, AccessDenied, type AccessDeniedProps, type AccessDeniedSuggestion, AccessDeniedView, AccessGate, type AccessGateProps, AccessLink, AccessRequestsSurface, type AccessResourceActionRequestAction, type AccessSettingRequestAction, type AccessUi, type AccessUiCurrentUser, type AccessUiEntityInfo, type AccessUiEntityRefProps, type AccessUiEnv, type AccessUiErrorMenuProps, type AccessUiFeedbackInput, type AccessUiLinkProps, AccessUiProvider, type AccessUiRouter, type AccessUiTextareaProps, type AccessUiToast, type AccessUiUserIdentityProps, BlindAccessAsk, CANT_REMOVE_DIALOG, type CantRemoveOutcome, type CantRemoveRequest, ForbiddenSurfaceView, type ForbiddenSurfaceViewProps, GovernedActionDialog, HiddenByMeButton, HiddenFilter, REQUEST_ACCESS_MANUAL_ACTION, RemovalNotYoursError, RequestAccess, RequestAccessPanel, type RequestAccessResult, ResourceActionRequestButtons, ServerReadRecheck, type ServerReadRecheckToken, SettingAccessGate, SettingRequestActionButtons, SlugAccessGate, type SlugAccessGateProps, UnresolvedEntityRef, type UnresolvedEntityRefProps, type UseAccessGateResult, type UseAccessStatesResult, configureAccessUi, ensureRemovable, getAccessUi, isAccessUiConfigured, isRemovalNotYours, offerOwnerChoices, refreshHiddenByMe, requestCantRemove, useAccessGate, useAccessStates, useAccessUi, useHiddenByMe, useHiddenItems, useHideForMe, useRemovalRights, useRequestAccess };
+export { ACCESS_REQUESTS_HREF, AccessDenied, type AccessDeniedProps, type AccessDeniedSuggestion, AccessDeniedView, AccessGate, type AccessGateProps, AccessLink, AccessRequestsSurface, type AccessResourceActionRequestAction, type AccessSettingRequestAction, type AccessUi, type AccessUiCurrentUser, type AccessUiEntityInfo, type AccessUiEntityRefProps, type AccessUiEnv, type AccessUiErrorMenuProps, type AccessUiFeedbackInput, type AccessUiLinkProps, AccessUiProvider, type AccessUiRouter, type AccessUiTextareaProps, type AccessUiToast, type AccessUiUserIdentityProps, BlindAccessAsk, CANT_REMOVE_DIALOG, type CantRemoveOutcome, type CantRemoveRequest, ForbiddenSurfaceView, type ForbiddenSurfaceViewProps, GovernedActionDialog, HiddenByMeButton, HiddenFilter, REQUEST_ACCESS_MANUAL_ACTION, RemovalNotYoursError, RequestAccess, RequestAccessPanel, type RequestAccessResult, ResourceActionRequestButtons, ServerReadRecheck, type ServerReadRecheckToken, SettingAccessGate, SettingRequestActionButtons, SlugAccessGate, type SlugAccessGateProps, UnresolvedEntityRef, type UnresolvedEntityRefProps, type UseAccessGateResult, type UseAccessStatesResult, configureAccessUi, ensureRemovable, getAccessUi, isAccessUiConfigured, isRemovalNotYours, offerOwnerChoices, refreshHiddenByMe, requestCantRemove, resetAccessUiStandInNotices, useAccessGate, useAccessStates, useAccessUi, useHiddenByMe, useHiddenItems, useHideForMe, useRemovalRights, useRequestAccess };

package/dist/access-react.js

@@ -5,6 +5,7 @@ import {
   createContext,
   forwardRef,
   useContext,
+  useEffect,
   useMemo
 } from "react";
 import { Avatar, AvatarFallback, AvatarImage, Textarea } from "@ai-matrx/design-system";
@@ -16,9 +17,33 @@ var DEFAULT_NAV_ITEM_CLASSES = {
   selected: "bg-[var(--shell-nav-selected-bg)] text-[var(--shell-nav-selected-text)] shadow-[var(--shell-nav-selected-shadow)] font-semibold",
   unselected: "text-[var(--shell-nav-unselected-text)] hover:text-[var(--shell-nav-text-hover)] hover:bg-[var(--matrx-glass-bg-hover)]"
 };
+var announcedPorts = /* @__PURE__ */ new Set();
+function announceDefault(port, consequence) {
+  if (announcedPorts.has(port)) return;
+  announcedPorts.add(port);
+  if (typeof console !== "undefined") {
+    console.warn(
+      `[@ai-matrx/sharing/access/react] The access screens are using their built-in stand-in for "${port}": ${consequence}. Pass it with configureAccessUi({ ${port} }) once at app boot.`
+    );
+  }
+  if (typeof document !== "undefined") {
+    const root = document.documentElement;
+    const ports = new Set((root.getAttribute("data-access-ui-ports") ?? "").split(",").filter(Boolean));
+    ports.add(port);
+    root.setAttribute("data-access-ui-ports", [...ports].join(","));
+  }
+}
+function resetAccessUiStandInNotices() {
+  announcedPorts.clear();
+  if (typeof document !== "undefined") document.documentElement.removeAttribute("data-access-ui-ports");
+}
+function standInAttrs(port) {
+  return { "data-access-ui-host": "unconfigured", "data-access-ui-port": port };
+}
 var DefaultLink = forwardRef(
   function DefaultLink2(props, ref) {
-    return /* @__PURE__ */ jsx("a", { ref, ...props });
+    useEffect(() => announceDefault("Link", "links are plain anchors (a full page load, no client navigation)"), []);
+    return /* @__PURE__ */ jsx("a", { ref, ...standInAttrs("Link"), ...props });
   }
 );
 var AccessLink = forwardRef(
@@ -27,28 +52,35 @@ var AccessLink = forwardRef(
     return /* @__PURE__ */ jsx(Link, { ref, ...props });
   }
 );
+var ROUTER_CONSEQUENCE = "navigation uses the browser (full page loads; refresh reloads the tab)";
 var DEFAULT_ROUTER = {
   push: (href) => {
+    announceDefault("router", ROUTER_CONSEQUENCE);
     if (typeof window !== "undefined") window.location.assign(href);
   },
   back: () => {
+    announceDefault("router", ROUTER_CONSEQUENCE);
     if (typeof window !== "undefined") window.history.back();
   },
   refresh: () => {
+    announceDefault("router", ROUTER_CONSEQUENCE);
     if (typeof window !== "undefined") window.location.reload();
   }
 };
 function defaultSearchParam(name) {
+  announceDefault("searchParam", "query parameters are read from window.location");
   if (typeof window === "undefined") return null;
   return new URLSearchParams(window.location.search).get(name);
 }
 function DefaultTextarea(props) {
-  return /* @__PURE__ */ jsx(Textarea, { ...props });
+  useEffect(() => announceDefault("Textarea", "the message box is the plain design-system textarea (no voice, no agent actions)"), []);
+  return /* @__PURE__ */ jsx(Textarea, { ...standInAttrs("Textarea"), ...props });
 }
 function DefaultUserIdentity({ user, size = "md", avatarOnly }) {
+  useEffect(() => announceDefault("renderUserIdentity", "people are drawn as an avatar and a name (no profile door)"), []);
   const name = user.displayName ?? "Someone";
   const box = size === "sm" ? "h-7 w-7" : "h-9 w-9";
-  return /* @__PURE__ */ jsxs("span", { className: "inline-flex min-w-0 items-center gap-2", children: [
+  return /* @__PURE__ */ jsxs("span", { ...standInAttrs("renderUserIdentity"), className: "inline-flex min-w-0 items-center gap-2", children: [
     /* @__PURE__ */ jsxs(Avatar, { className: box, children: [
       user.avatarUrl ? /* @__PURE__ */ jsx(AvatarImage, { src: user.avatarUrl, alt: name }) : null,
       /* @__PURE__ */ jsx(AvatarFallback, { className: "text-[11px]", children: getInitials(user.displayName) })
@@ -57,7 +89,16 @@ function DefaultUserIdentity({ user, size = "md", avatarOnly }) {
   ] });
 }
 function DefaultEntityRef({ name, className }) {
-  return /* @__PURE__ */ jsx("span", { className, children: name });
+  useEffect(() => announceDefault("renderEntityRef", "records are drawn as a plain name (not a door to the record)"), []);
+  return /* @__PURE__ */ jsx("span", { ...standInAttrs("renderEntityRef"), className, children: name });
+}
+function DefaultErrorMenu() {
+  useEffect(() => announceDefault("renderErrorMenu", "errors show no copy / fix-request menu"), []);
+  return /* @__PURE__ */ jsx("span", { hidden: true, ...standInAttrs("renderErrorMenu") });
+}
+function defaultConfirm(options) {
+  announceDefault("confirm", "confirmations use the kit confirm (the design-system ConfirmDialogHost must be mounted)");
+  return kitConfirm(options);
 }
 var moduleEnv = {};
 var moduleVersion = 0;
@@ -94,21 +135,33 @@ function resolveAccessUi(base, override) {
     Link: env.Link ?? DefaultLink,
     router: env.router ?? DEFAULT_ROUTER,
     searchParam: env.searchParam ?? defaultSearchParam,
-    confirm: env.confirm ?? kitConfirm,
+    confirm: env.confirm ?? defaultConfirm,
     Textarea: env.Textarea ?? DefaultTextarea,
     renderUserIdentity: env.renderUserIdentity ?? ((p) => /* @__PURE__ */ jsx(DefaultUserIdentity, { ...p })),
     renderEntityRef: env.renderEntityRef ?? ((p) => /* @__PURE__ */ jsx(DefaultEntityRef, { ...p })),
-    renderErrorMenu: env.renderErrorMenu ?? (() => null),
+    renderErrorMenu: env.renderErrorMenu ?? (() => /* @__PURE__ */ jsx(DefaultErrorMenu, {})),
     navItemClasses: env.navItemClasses ?? DEFAULT_NAV_ITEM_CLASSES,
     manualRequestActionKey: env.manualRequestActionKey ?? REQUEST_ACCESS_MANUAL_ACTION,
-    tryGetEntityInfo: (token) => env.entityRegistry?.tryGetEntityInfo(token) ?? null,
+    tryGetEntityInfo: (token) => {
+      if (!env.entityRegistry) announceDefault("entityRegistry", "owners and records render as plain names (no labels or links)");
+      return env.entityRegistry?.tryGetEntityInfo(token) ?? null;
+    },
     restoreFromTrash: async (token, id) => {
       if (!env.trash) throw notConfigured("trash");
       await env.trash.restore(token, id);
     },
-    resolveRecordUnavailableCapture: (error, resolution) => env.recordUnavailableCapture?.resolve(error, resolution),
-    getSettingRequestAction: (key) => env.settingRequestActions?.get(key),
-    getResourceActionRequestAction: (key) => env.resourceActionRequests?.get(key),
+    resolveRecordUnavailableCapture: (error, resolution) => {
+      if (!env.recordUnavailableCapture) announceDefault("recordUnavailableCapture", "a captured unavailable read is not reconciled");
+      env.recordUnavailableCapture?.resolve(error, resolution);
+    },
+    getSettingRequestAction: (key) => {
+      if (!env.settingRequestActions) announceDefault("settingRequestActions", "setting-change requests show without their primary action button");
+      return env.settingRequestActions?.get(key);
+    },
+    getResourceActionRequestAction: (key) => {
+      if (!env.resourceActionRequests) announceDefault("resourceActionRequests", "resource-action requests show without their primary action button");
+      return env.resourceActionRequests?.get(key);
+    },
     createCmsAccessRequest: async (args) => {
       if (!env.cms) throw notConfigured("cms");
       return env.cms.createAccessRequest(args);
@@ -121,12 +174,18 @@ function resolveAccessUi(base, override) {
       if (!env.reportFeedback) throw notConfigured("reportFeedback");
       return env.reportFeedback(input);
     },
-    presentOrganizationRefusal: (error, options) => env.presentOrganizationRefusal?.(error, options) ?? false,
+    presentOrganizationRefusal: (error, options) => {
+      if (!env.presentOrganizationRefusal) announceDefault("presentOrganizationRefusal", "a refusal for a missing organization is shown as a plain error");
+      return env.presentOrganizationRefusal?.(error, options) ?? false;
+    },
     openOverlay: (overlayId, instanceId, data) => {
       if (!env.overlays) throw notConfigured("overlays");
       env.overlays.open(overlayId, instanceId, data);
     },
-    closeOverlay: (overlayId, instanceId) => env.overlays?.close(overlayId, instanceId)
+    closeOverlay: (overlayId, instanceId) => {
+      if (!env.overlays) announceDefault("overlays", "no overlay can be closed (none was ever opened)");
+      env.overlays?.close(overlayId, instanceId);
+    }
   };
   return ui;
 }
@@ -422,7 +481,7 @@ function BlindAccessAsk({
 }
 
 // src/access/react/useAccessGate.ts
-import { useCallback, useEffect, useState as useState3 } from "react";
+import { useCallback, useEffect as useEffect2, useState as useState3 } from "react";
 import { fetchAccessDeniedContext } from "@ai-matrx/data/access";
 import { classifyDataError } from "@ai-matrx/data/access";
 function useAccessGate(token, id, options = {}) {
@@ -431,7 +490,7 @@ function useAccessGate(token, id, options = {}) {
   const enabled = options.enabled !== false && Boolean(token && id);
   const key = enabled ? `${token}:${id}:${nonce}` : null;
   const [resolved, setResolved] = useState3(null);
-  useEffect(() => {
+  useEffect2(() => {
     if (!key || !token || !id) return;
     let active = true;
     const read = classifyDataError(options.readError) === "fault" ? "fault" : "access-question";
@@ -842,7 +901,7 @@ function ServerRefusalCode({
 }
 
 // src/access/react/SlugAccessGate.tsx
-import { useEffect as useEffect2, useState as useState5 } from "react";
+import { useEffect as useEffect3, useState as useState5 } from "react";
 import { ArrowLeft as ArrowLeft2, Link2Off } from "lucide-react";
 import { isUuidShape } from "@ai-matrx/kit/uuid";
 import { Button as Button4 } from "@ai-matrx/design-system/controls";
@@ -862,7 +921,7 @@ function SlugAccessGate({
   const tokenKey = tokens.join("|");
   const [resolved, setResolved] = useState5(null);
   const key = `${tokenKey}::${slug}`;
-  useEffect2(() => {
+  useEffect3(() => {
     let active = true;
     const list = tokenKey ? tokenKey.split("|") : [];
     void (async () => {
@@ -1477,7 +1536,7 @@ function UnresolvedEntityRef({
 }
 
 // src/access/react/ServerReadRecheck.tsx
-import { useEffect as useEffect3, useState as useState10 } from "react";
+import { useEffect as useEffect4, useState as useState10 } from "react";
 import { getClaimsUser } from "@ai-matrx/auth/claims";
 import { getAccessEnv as getAccessEnv2 } from "@ai-matrx/data/access";
 import { decideServerReadRecheck } from "@ai-matrx/data/access";
@@ -1498,7 +1557,7 @@ function ServerReadRecheck({
   const router = useAccessUi().router;
   const key = `${token}:${id}`;
   const [showGate, setShowGate] = useState10(false);
-  useEffect3(() => {
+  useEffect4(() => {
     let active = true;
     void (async () => {
       let signedIn = false;
@@ -1561,7 +1620,7 @@ import {
 } from "@ai-matrx/data/access";
 
 // src/access/react/useHiddenByMe.ts
-import { useEffect as useEffect4, useState as useState11, useSyncExternalStore } from "react";
+import { useEffect as useEffect5, useState as useState11, useSyncExternalStore } from "react";
 import {
   fetchRemovalRights,
   hideForMe,
@@ -1635,7 +1694,7 @@ function useHiddenSlot(token, enabled) {
   );
   const active = enabled && Boolean(token);
   const slot = active ? slotFor(token) : void 0;
-  useEffect4(() => {
+  useEffect5(() => {
     if (!active) return;
     const current = slotFor(token);
     if ((current.items === void 0 || current.failed) && !current.loading) void refreshHiddenByMe(token);
@@ -1657,7 +1716,7 @@ function useRemovalRights(token, id) {
   const [nonce, setNonce] = useState11(0);
   const key = id ? `${token}:${id}:${nonce}` : null;
   const [settled, setSettled] = useState11(null);
-  useEffect4(() => {
+  useEffect5(() => {
     if (!key || !id) return;
     let active = true;
     fetchRemovalRights(token, id).then(
@@ -2335,7 +2394,7 @@ function SettingRequestActionButtons({
 }
 
 // src/access/react/AccessRequestsSurface.tsx
-import { useCallback as useCallback2, useEffect as useEffect5, useState as useState16 } from "react";
+import { useCallback as useCallback2, useEffect as useEffect6, useState as useState16 } from "react";
 import {
   CircleCheck,
   CircleSlash as CircleSlash3,
@@ -2464,7 +2523,7 @@ function AccessRequestsSurface() {
     setError(result.error);
     setRefreshing(false);
   }, []);
-  useEffect5(() => {
+  useEffect6(() => {
     let alive = true;
     void (async () => {
       const result = await fetchBoxes();
@@ -2725,7 +2784,7 @@ function AccessRequestsSurface() {
 }
 
 // src/access/react/useAccessStates.ts
-import { useCallback as useCallback3, useEffect as useEffect6, useMemo as useMemo2, useState as useState17 } from "react";
+import { useCallback as useCallback3, useEffect as useEffect7, useMemo as useMemo2, useState as useState17 } from "react";
 import { fetchAccessDeniedContext as fetchAccessDeniedContext3 } from "@ai-matrx/data/access";
 var CACHE = /* @__PURE__ */ new Map();
 var INFLIGHT = /* @__PURE__ */ new Map();
@@ -2750,7 +2809,7 @@ function useAccessStates(token, ids) {
   const [nonce, setNonce] = useState17(0);
   const [resolved, setResolved] = useState17(() => /* @__PURE__ */ new Map());
   const idKey = useMemo2(() => Array.from(new Set(ids)).sort().join(","), [ids]);
-  useEffect6(() => {
+  useEffect7(() => {
     const wanted2 = idKey ? idKey.split(",") : [];
     if (wanted2.length === 0) return;
     let active = true;
@@ -2864,6 +2923,7 @@ export {
   offerOwnerChoices,
   refreshHiddenByMe,
   requestCantRemove,
+  resetAccessUiStandInNotices,
   useAccessGate,
   useAccessStates,
   useAccessUi,