@ai-matrx/sharing 0.1.3 → 0.1.4

package/CHANGELOG.md

@@ -1,12 +1,15 @@
 # Changelog
 
-## 0.1.3
+## 0.1.4
 
 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`.
 
 ## 0.1.2
 
+- **A share-sheet stand-in announces itself.** The defaults for `csvExportItem`, `jsonExportItem`, `usePageCapture`, `PageCaptureButton`, `ErrorAlchemyMenu`, `EntityDoorControls` and `vaultIdentity` used to be silent nothings. Each now warns once in the console naming the `configureShareSheetUi` field to pass, and a drawn stand-in leaves `data-share-sheet-host="unconfigured"` (+ `data-share-sheet-port`) in the DOM. New export `resetShareSheetStandInNotices` (test seam). **Consumer action:** none; pass the field to silence the notice. Guard: `react/__tests__/a-share-sheet-stand-in-announces-itself.test.tsx`.
+- **`0.1.0` is superseded.** The `0.1.0` skeleton note below ("export nothing yet", "Do not adopt") is history: `/core`, `/react` and `/access/react` all export their API and matrx-frontend runs on them.
+
 - `ShareLinkPanel` options `linkSettings`, `showLinkDetails`, `showOpenLink`, `extraUrls`, `appOrigin`, `onLinksChange`; `shareLinkUrl`/`shareUrlForLink` take an optional origin (the one share-link manager).
 
 - **One ladder implementation.** `normalizePermissionLevel` and `parsePermissionLevel` are now re-exported from `@ai-matrx/data/access` (identical answers for every input; the unrecognised-level log now names `@ai-matrx/data/access` instead of the stale `utils/permissions/levels.ts`). `PERMISSION_LEVEL_RANK` and `permissionLevelRank` stay local: they rank the retired `edit_content` as Edit, which data's do not. Every export unchanged. **Consumer action:** none.
@@ -19,10 +22,10 @@ Check the package's gitHead on npm against this version's gitHead: `git diff <pr
 
 ## 0.1.0
 
-Skeleton release: the name's sections exist (`/core`, `/react`) and export nothing yet. The frozen API lands with its Wave 1 unit (BUILD-BOOK §3.2).
+Skeleton release (superseded; see `0.1.1` and later): the name's sections exist (`/core`, `/react`) and export nothing yet. The frozen API lands with its Wave 1 unit (BUILD-BOOK §3.2).
 
 ### Consumer action
 
-None. Do not adopt until a unit ships the API.
+None at the time; the API has since shipped (adopt the latest).
 
 

package/README.md

@@ -2,12 +2,12 @@
 
 Sharing for every AI Matrx entity: the permission doors, share links, and the share dialog.
 
-**Status:** `/access/react` ships (the access gate screens, moved from `@ai-matrx/data`). `/core` and `/react` are reserved and export nothing yet; their API arrives with the Wave 1 unit of the Office build (`common-docs/projects/office-suite/BUILD-BOOK.md` §3.2).
+**Status:** shipping and adopted by matrx-frontend. `/core` is the data half (`configureSharing`: the permission service, share links, registry, "shown to" reads); `/react` is THE share sheet (`ShareModal`, the link panels, the permission hooks; host UI through `configureShareSheetUi`); `/access/react` is the access gate screens (moved from `@ai-matrx/data`). Versions are cut by the publish lane on every push that changes this folder (`highest served + patch`), so `package.json`'s version is not the release state; `npm view @ai-matrx/sharing version` is.
 
 ## Sections
 
-- `@ai-matrx/sharing/core`
-- `@ai-matrx/sharing/react`
+- `@ai-matrx/sharing/core` - the data half: `configureSharing`, permission service, share links, registry
+- `@ai-matrx/sharing/react` - the share sheet and its hooks; every host-only part has an announcing default
 - `@ai-matrx/sharing/access/react` — `"use client"`: request access, access denied, governed actions, hidden-by-me
 
 ## `@ai-matrx/sharing/access/react` — the access gate screens

package/dist/access-react-cant-remove-dialog.cjs

@@ -22,13 +22,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/access/react/cantRemoveDialog.render.tsx
 var cantRemoveDialog_render_exports = {};
 __export(cantRemoveDialog_render_exports, {
-  default: () => render
+  default: () => CantRemoveDialogRender
 });
 module.exports = __toCommonJS(cantRemoveDialog_render_exports);
 var import_react = require("@ai-matrx/summon/react");
 var import_react2 = require("@ai-matrx/sharing/access/react");
 var import_jsx_runtime = require("react/jsx-runtime");
-function render({ data, close }) {
+function CantRemoveDialogRender({ data, close }) {
   const { request, settle } = (0, import_react.useOverlayRequest)(data, close);
   if (!request) return null;
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(

package/dist/access-react-cant-remove-dialog.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/access/react/cantRemoveDialog.render.tsx"],"sourcesContent":["\"use client\";\n/**\n * The `cantRemoveDialog` overlay's render (`CANT_REMOVE_DIALOG`): answers the pending `requestCantRemove`\n * request with `GovernedActionDialog`. A host registers the overlay id with this module as its render.\n * Imports the package by name so the dialog shares the host's one `configureAccessUi` environment.\n */\nimport { useOverlayRequest, type OverlayRenderProps } from \"@ai-matrx/summon/react\";\nimport { GovernedActionDialog, type CantRemoveOutcome, type CantRemoveRequest } from \"@ai-matrx/sharing/access/react\";\n\nexport default function render({ data, close }: OverlayRenderProps) {\n  const { request, settle } = useOverlayRequest<CantRemoveRequest, CantRemoveOutcome>(data, close);\n  if (!request) return null;\n  return (\n    <GovernedActionDialog\n      key={`${request.token}:${request.id}`}\n      open\n      onOpenChange={(next) => {\n        if (!next) settle(\"closed\");\n      }}\n      resourceType={request.token}\n      resourceId={request.id}\n      itemName={request.itemName}\n      itemLabel={request.itemLabel}\n      action={request.action}\n      href={request.href ?? null}\n      // The hidden-ids store refreshed inside the hide, so every list of this kind re-renders.\n      onHidden={() => settle(\"hidden\")}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,mBAA2D;AAC3D,IAAAA,gBAAqF;AAMjF;AAJW,SAAR,OAAwB,EAAE,MAAM,MAAM,GAAuB;AAClE,QAAM,EAAE,SAAS,OAAO,QAAI,gCAAwD,MAAM,KAAK;AAC/F,MAAI,CAAC,QAAS,QAAO;AACrB,SACE;AAAA,IAAC;AAAA;AAAA,MAEC,MAAI;AAAA,MACJ,cAAc,CAAC,SAAS;AACtB,YAAI,CAAC,KAAM,QAAO,QAAQ;AAAA,MAC5B;AAAA,MACA,cAAc,QAAQ;AAAA,MACtB,YAAY,QAAQ;AAAA,MACpB,UAAU,QAAQ;AAAA,MAClB,WAAW,QAAQ;AAAA,MACnB,QAAQ,QAAQ;AAAA,MAChB,MAAM,QAAQ,QAAQ;AAAA,MAEtB,UAAU,MAAM,OAAO,QAAQ;AAAA;AAAA,IAZ1B,GAAG,QAAQ,KAAK,IAAI,QAAQ,EAAE;AAAA,EAarC;AAEJ;","names":["import_react"]}
+{"version":3,"sources":["../src/access/react/cantRemoveDialog.render.tsx"],"sourcesContent":["\"use client\";\n/**\n * The `cantRemoveDialog` overlay's render (`CANT_REMOVE_DIALOG`): answers the pending `requestCantRemove`\n * request with `GovernedActionDialog`. A host registers the overlay id with this module as its render.\n * Imports the package by name so the dialog shares the host's one `configureAccessUi` environment.\n */\nimport { useOverlayRequest, type OverlayRenderProps } from \"@ai-matrx/summon/react\";\nimport { GovernedActionDialog, type CantRemoveOutcome, type CantRemoveRequest } from \"@ai-matrx/sharing/access/react\";\n\nexport default function CantRemoveDialogRender({ data, close }: OverlayRenderProps) {\n  const { request, settle } = useOverlayRequest<CantRemoveRequest, CantRemoveOutcome>(data, close);\n  if (!request) return null;\n  return (\n    <GovernedActionDialog\n      key={`${request.token}:${request.id}`}\n      open\n      onOpenChange={(next) => {\n        if (!next) settle(\"closed\");\n      }}\n      resourceType={request.token}\n      resourceId={request.id}\n      itemName={request.itemName}\n      itemLabel={request.itemLabel}\n      action={request.action}\n      href={request.href ?? null}\n      // The hidden-ids store refreshed inside the hide, so every list of this kind re-renders.\n      onHidden={() => settle(\"hidden\")}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,mBAA2D;AAC3D,IAAAA,gBAAqF;AAMjF;AAJW,SAAR,uBAAwC,EAAE,MAAM,MAAM,GAAuB;AAClF,QAAM,EAAE,SAAS,OAAO,QAAI,gCAAwD,MAAM,KAAK;AAC/F,MAAI,CAAC,QAAS,QAAO;AACrB,SACE;AAAA,IAAC;AAAA;AAAA,MAEC,MAAI;AAAA,MACJ,cAAc,CAAC,SAAS;AACtB,YAAI,CAAC,KAAM,QAAO,QAAQ;AAAA,MAC5B;AAAA,MACA,cAAc,QAAQ;AAAA,MACtB,YAAY,QAAQ;AAAA,MACpB,UAAU,QAAQ;AAAA,MAClB,WAAW,QAAQ;AAAA,MACnB,QAAQ,QAAQ;AAAA,MAChB,MAAM,QAAQ,QAAQ;AAAA,MAEtB,UAAU,MAAM,OAAO,QAAQ;AAAA;AAAA,IAZ1B,GAAG,QAAQ,KAAK,IAAI,QAAQ,EAAE;AAAA,EAarC;AAEJ;","names":["import_react"]}

package/dist/access-react-cant-remove-dialog.d.cts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { OverlayRenderProps } from '@ai-matrx/summon/react';
 
-declare function render({ data, close }: OverlayRenderProps): react.JSX.Element | null;
+declare function CantRemoveDialogRender({ data, close }: OverlayRenderProps): react.JSX.Element | null;
 
-export { render as default };
+export { CantRemoveDialogRender as default };

package/dist/access-react-cant-remove-dialog.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { OverlayRenderProps } from '@ai-matrx/summon/react';
 
-declare function render({ data, close }: OverlayRenderProps): react.JSX.Element | null;
+declare function CantRemoveDialogRender({ data, close }: OverlayRenderProps): react.JSX.Element | null;
 
-export { render as default };
+export { CantRemoveDialogRender as default };

package/dist/access-react-cant-remove-dialog.js

@@ -5,7 +5,7 @@
 import { useOverlayRequest } from "@ai-matrx/summon/react";
 import { GovernedActionDialog } from "@ai-matrx/sharing/access/react";
 import { jsx } from "react/jsx-runtime";
-function render({ data, close }) {
+function CantRemoveDialogRender({ data, close }) {
   const { request, settle } = useOverlayRequest(data, close);
   if (!request) return null;
   return /* @__PURE__ */ jsx(
@@ -27,6 +27,6 @@ function render({ data, close }) {
   );
 }
 export {
-  render as default
+  CantRemoveDialogRender as default
 };
 //# sourceMappingURL=access-react-cant-remove-dialog.js.map

package/dist/access-react-cant-remove-dialog.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/access/react/cantRemoveDialog.render.tsx"],"sourcesContent":["\"use client\";\n/**\n * The `cantRemoveDialog` overlay's render (`CANT_REMOVE_DIALOG`): answers the pending `requestCantRemove`\n * request with `GovernedActionDialog`. A host registers the overlay id with this module as its render.\n * Imports the package by name so the dialog shares the host's one `configureAccessUi` environment.\n */\nimport { useOverlayRequest, type OverlayRenderProps } from \"@ai-matrx/summon/react\";\nimport { GovernedActionDialog, type CantRemoveOutcome, type CantRemoveRequest } from \"@ai-matrx/sharing/access/react\";\n\nexport default function render({ data, close }: OverlayRenderProps) {\n  const { request, settle } = useOverlayRequest<CantRemoveRequest, CantRemoveOutcome>(data, close);\n  if (!request) return null;\n  return (\n    <GovernedActionDialog\n      key={`${request.token}:${request.id}`}\n      open\n      onOpenChange={(next) => {\n        if (!next) settle(\"closed\");\n      }}\n      resourceType={request.token}\n      resourceId={request.id}\n      itemName={request.itemName}\n      itemLabel={request.itemLabel}\n      action={request.action}\n      href={request.href ?? null}\n      // The hidden-ids store refreshed inside the hide, so every list of this kind re-renders.\n      onHidden={() => settle(\"hidden\")}\n    />\n  );\n}\n"],"mappings":";;;;AAMA,SAAS,yBAAkD;AAC3D,SAAS,4BAA4E;AAMjF;AAJW,SAAR,OAAwB,EAAE,MAAM,MAAM,GAAuB;AAClE,QAAM,EAAE,SAAS,OAAO,IAAI,kBAAwD,MAAM,KAAK;AAC/F,MAAI,CAAC,QAAS,QAAO;AACrB,SACE;AAAA,IAAC;AAAA;AAAA,MAEC,MAAI;AAAA,MACJ,cAAc,CAAC,SAAS;AACtB,YAAI,CAAC,KAAM,QAAO,QAAQ;AAAA,MAC5B;AAAA,MACA,cAAc,QAAQ;AAAA,MACtB,YAAY,QAAQ;AAAA,MACpB,UAAU,QAAQ;AAAA,MAClB,WAAW,QAAQ;AAAA,MACnB,QAAQ,QAAQ;AAAA,MAChB,MAAM,QAAQ,QAAQ;AAAA,MAEtB,UAAU,MAAM,OAAO,QAAQ;AAAA;AAAA,IAZ1B,GAAG,QAAQ,KAAK,IAAI,QAAQ,EAAE;AAAA,EAarC;AAEJ;","names":[]}
+{"version":3,"sources":["../src/access/react/cantRemoveDialog.render.tsx"],"sourcesContent":["\"use client\";\n/**\n * The `cantRemoveDialog` overlay's render (`CANT_REMOVE_DIALOG`): answers the pending `requestCantRemove`\n * request with `GovernedActionDialog`. A host registers the overlay id with this module as its render.\n * Imports the package by name so the dialog shares the host's one `configureAccessUi` environment.\n */\nimport { useOverlayRequest, type OverlayRenderProps } from \"@ai-matrx/summon/react\";\nimport { GovernedActionDialog, type CantRemoveOutcome, type CantRemoveRequest } from \"@ai-matrx/sharing/access/react\";\n\nexport default function CantRemoveDialogRender({ data, close }: OverlayRenderProps) {\n  const { request, settle } = useOverlayRequest<CantRemoveRequest, CantRemoveOutcome>(data, close);\n  if (!request) return null;\n  return (\n    <GovernedActionDialog\n      key={`${request.token}:${request.id}`}\n      open\n      onOpenChange={(next) => {\n        if (!next) settle(\"closed\");\n      }}\n      resourceType={request.token}\n      resourceId={request.id}\n      itemName={request.itemName}\n      itemLabel={request.itemLabel}\n      action={request.action}\n      href={request.href ?? null}\n      // The hidden-ids store refreshed inside the hide, so every list of this kind re-renders.\n      onHidden={() => settle(\"hidden\")}\n    />\n  );\n}\n"],"mappings":";;;;AAMA,SAAS,yBAAkD;AAC3D,SAAS,4BAA4E;AAMjF;AAJW,SAAR,uBAAwC,EAAE,MAAM,MAAM,GAAuB;AAClF,QAAM,EAAE,SAAS,OAAO,IAAI,kBAAwD,MAAM,KAAK;AAC/F,MAAI,CAAC,QAAS,QAAO;AACrB,SACE;AAAA,IAAC;AAAA;AAAA,MAEC,MAAI;AAAA,MACJ,cAAc,CAAC,SAAS;AACtB,YAAI,CAAC,KAAM,QAAO,QAAQ;AAAA,MAC5B;AAAA,MACA,cAAc,QAAQ;AAAA,MACtB,YAAY,QAAQ;AAAA,MACpB,UAAU,QAAQ;AAAA,MAClB,WAAW,QAAQ;AAAA,MACnB,QAAQ,QAAQ;AAAA,MAChB,MAAM,QAAQ,QAAQ;AAAA,MAEtB,UAAU,MAAM,OAAO,QAAQ;AAAA;AAAA,IAZ1B,GAAG,QAAQ,KAAK,IAAI,QAAQ,EAAE;AAAA,EAarC;AAEJ;","names":[]}

package/dist/core.cjs

@@ -4705,8 +4705,26 @@ function DefaultCopyButtons(props) {
     }
   );
 }
+var announced = /* @__PURE__ */ new Set();
+function announceStandIn(port) {
+  if (announced.has(port)) return;
+  announced.add(port);
+  console.warn(
+    `[share] The share sheet is using its built-in stand-in for "${port}": the host did not pass it, so that part of the sheet is absent. Pass it with configureShareSheetUi({ ${port} }).`
+  );
+}
+function StandIn({ port }) {
+  (0, import_react.useEffect)(() => announceStandIn(port), [port]);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { hidden: true, "data-share-sheet-host": "unconfigured", "data-share-sheet-port": port });
+}
 function DefaultErrorMenu(_props) {
-  return null;
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(StandIn, { port: "ErrorAlchemyMenu" });
+}
+function DefaultPageCaptureButton(_props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(StandIn, { port: "PageCaptureButton" });
+}
+function DefaultEntityDoorControls(_props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(StandIn, { port: "EntityDoorControls" });
 }
 function DefaultInfoHint(props) {
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { title: String(props.text ?? ""), "aria-label": String(props.label ?? "More info"), className: "cursor-help text-muted-foreground", children: "\u24D8" });
@@ -4816,14 +4834,23 @@ var DEFAULTS = {
   useUserConnections: useDefaultConnections,
   confirm: (o) => (0, import_confirm_opener.confirm)(o),
   CopyButtons: DefaultCopyButtons,
-  csvExportItem: () => null,
-  jsonExportItem: () => null,
-  usePageCapture: () => void 0,
+  csvExportItem: () => {
+    announceStandIn("csvExportItem");
+    return null;
+  },
+  jsonExportItem: () => {
+    announceStandIn("jsonExportItem");
+    return null;
+  },
+  usePageCapture: () => {
+    announceStandIn("usePageCapture");
+    return void 0;
+  },
   dialogCapture: (input) => input,
-  PageCaptureButton: () => null,
+  PageCaptureButton: DefaultPageCaptureButton,
   ErrorAlchemyMenu: DefaultErrorMenu,
   InfoHint: DefaultInfoHint,
-  EntityDoorControls: () => null,
+  EntityDoorControls: DefaultEntityDoorControls,
   EntityRef: DefaultEntityRef,
   UserAvatarDisplay: DefaultUserAvatar,
   ConnectionsReadNotice: DefaultConnectionsNotice,