@ai-matrx/sharing 0.1.9 → 0.1.10

package/CHANGELOG.md

@@ -1,9 +1,18 @@
 # Changelog
 
+## 0.1.10
+
+- **The access screens' stand-ins announce themselves (2026-10-22, round 3).** Every default of `configureAccessUi` the host did not replace (`Link`, `router`, `searchParam`, `confirm`, `Textarea`, `renderUserIdentity`, `renderEntityRef`, `renderErrorMenu`, and the quiet app features `entityRegistry`, `recordUnavailableCapture`, `settingRequestActions`, `resourceActionRequests`, `presentOrganizationRefusal`, `overlays`' close) now says so: one console notice per field naming `configureAccessUi({ <field> })`, the field in `data-access-ui-ports` on `<html>`, and `data-access-ui-host="unconfigured"` + `data-access-ui-port` on what the default draws (the same pattern as the share sheet). New test seam `resetAccessUiStandInNotices`. Guard: `src/access/react/env.stand-ins.test.tsx`. **Consumer action:** none; a host that sees a notice supplies the named field.
+
 ## 0.1.9
 
-UNVERIFIED: this release has no Unreleased entry and the source comparison could not be made (the caller supplied no source comparison). Whether source changed is unknown; consumer action is unknown.
-Check the package's gitHead on npm against this version's gitHead: `git diff <previous gitHead> <this gitHead> -- apps/shared/sharing/src`.
+SOURCE CHANGED WITH NO RELEASE NOTE. This release shipped source changes that nobody described in an Unreleased entry,
+so they may include breaking API changes. Consumer action is UNKNOWN: read the diff before upgrading.
+Diff: `git diff ed3f4f552d 973cc3e9a3 -- apps/shared/sharing/src`
+
+Changed shipped source files (2):
+- `apps/shared/sharing/src/react/sheet/ShareModal.tsx`
+- `apps/shared/sharing/src/react/sheet/useKeepFocusInDialog.ts`
 
 ## 0.1.8
 

package/dist/access-react.cjs

@@ -62,6 +62,7 @@ __export(react_exports, {
   offerOwnerChoices: () => offerOwnerChoices,
   refreshHiddenByMe: () => refreshHiddenByMe,
   requestCantRemove: () => requestCantRemove,
+  resetAccessUiStandInNotices: () => resetAccessUiStandInNotices,
   useAccessGate: () => useAccessGate,
   useAccessStates: () => useAccessStates,
   useAccessUi: () => useAccessUi,
@@ -84,9 +85,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 = (0, import_react.forwardRef)(
   function DefaultLink2(props, ref) {
-    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("a", { ref, ...props });
+    (0, import_react.useEffect)(() => announceDefault("Link", "links are plain anchors (a full page load, no client navigation)"), []);
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("a", { ref, ...standInAttrs("Link"), ...props });
   }
 );
 var AccessLink = (0, import_react.forwardRef)(
@@ -95,28 +120,35 @@ var AccessLink = (0, import_react.forwardRef)(
     return /* @__PURE__ */ (0, import_jsx_runtime.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__ */ (0, import_jsx_runtime.jsx)(import_design_system.Textarea, { ...props });
+  (0, import_react.useEffect)(() => announceDefault("Textarea", "the message box is the plain design-system textarea (no voice, no agent actions)"), []);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_design_system.Textarea, { ...standInAttrs("Textarea"), ...props });
 }
 function DefaultUserIdentity({ user, size = "md", avatarOnly }) {
+  (0, import_react.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__ */ (0, import_jsx_runtime.jsxs)("span", { className: "inline-flex min-w-0 items-center gap-2", children: [
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { ...standInAttrs("renderUserIdentity"), className: "inline-flex min-w-0 items-center gap-2", children: [
     /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_design_system.Avatar, { className: box, children: [
       user.avatarUrl ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_design_system.AvatarImage, { src: user.avatarUrl, alt: name }) : null,
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_design_system.AvatarFallback, { className: "text-[11px]", children: (0, import_format.getInitials)(user.displayName) })
@@ -125,7 +157,16 @@ function DefaultUserIdentity({ user, size = "md", avatarOnly }) {
   ] });
 }
 function DefaultEntityRef({ name, className }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className, children: name });
+  (0, import_react.useEffect)(() => announceDefault("renderEntityRef", "records are drawn as a plain name (not a door to the record)"), []);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { ...standInAttrs("renderEntityRef"), className, children: name });
+}
+function DefaultErrorMenu() {
+  (0, import_react.useEffect)(() => announceDefault("renderErrorMenu", "errors show no copy / fix-request menu"), []);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { hidden: true, ...standInAttrs("renderErrorMenu") });
+}
+function defaultConfirm(options) {
+  announceDefault("confirm", "confirmations use the kit confirm (the design-system ConfirmDialogHost must be mounted)");
+  return (0, import_confirm_opener.confirm)(options);
 }
 var moduleEnv = {};
 var moduleVersion = 0;
@@ -162,21 +203,33 @@ function resolveAccessUi(base, override) {
     Link: env.Link ?? DefaultLink,
     router: env.router ?? DEFAULT_ROUTER,
     searchParam: env.searchParam ?? defaultSearchParam,
-    confirm: env.confirm ?? import_confirm_opener.confirm,
+    confirm: env.confirm ?? defaultConfirm,
     Textarea: env.Textarea ?? DefaultTextarea,
     renderUserIdentity: env.renderUserIdentity ?? ((p) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(DefaultUserIdentity, { ...p })),
     renderEntityRef: env.renderEntityRef ?? ((p) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(DefaultEntityRef, { ...p })),
-    renderErrorMenu: env.renderErrorMenu ?? (() => null),
+    renderErrorMenu: env.renderErrorMenu ?? (() => /* @__PURE__ */ (0, import_jsx_runtime.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);
@@ -189,12 +242,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;
 }