@ai-matrx/media 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,72 @@
 # @ai-matrx/media
 
+## 0.2.0 — 2026-08-29
+
+**THE SHARE MANDATE row is satisfied (wave M-SHARE, ruling C19).** The
+share-popover BODIES land, additively, through the exact `MediaActionsPort` /
+`SharePopover` contract 0.1.0 reserved for them — no breaking change, no
+change to any existing entry's surface.
+
+- **New entry `@ai-matrx/media/share`** (`"use client"` group):
+  - `MediaSharePopover` — the complete share body, ported from the canonical
+    matrx-frontend share flows (`ImageSharePopover` / `VideoSharePopover` —
+    ONE share mechanism) with the seams inverted:
+    - the public-link path (permanent CDN URL for public files, else
+      reuse-or-mint a no-expiry read-only share link) rides the ONE
+      `MediaClient.shareableUrl` door, asked on click; `null` **fails
+      closed** (law 4) and renders as inline error state;
+    - external refs get the simplified copy-external-link surface
+      (`shareableUrl` prefetched — pure classification there);
+    - "Manage all links" → the `manageLinks` host callback and the access
+      summary → the `AccessSummary` host slot (both iam surfaces are app
+      content per C8; rows/sections hide when unbound);
+    - toasts → the optional `notify` adapter; every failure ALSO renders
+      inline so no outcome is silent without one;
+    - **association affordances** ("Linked to" rows with live titles +
+      detach, "Attach to…" universal search + attach) consume
+      `@ai-matrx/associations` strictly through its public
+      provider/hooks surface, and degrade to ABSENT when no
+      `AssociationsProvider` is mounted.
+  - `createMediaSharePopover(options)` — binds the host-shaped options once
+    and returns a component matching the `SharePopover` slot exactly; the
+    tarball canary compiles that assignment with no cast.
+- **Dependency direction:** `@ai-matrx/associations` is an **OPTIONAL peer**
+  (`>=0.4.0`) carried ONLY by `/share` — a media consumer of `.`, `/core`,
+  or `/react` never installs it (C8). Upgrading associations requires no
+  media release: the popover reaches it through the host-mounted provider.
+- Six new inlined SVG glyphs (lucide v1.22.0: globe, link-2, settings-2,
+  loader-circle, plus, search) per C19 — still no icon library.
+- Gates extended: the five-laws source scan covers the new files
+  automatically; `verify:tarball` now installs the PUBLISHED associations +
+  design-system packages and imports/requires `/share` from the packed
+  artifact, renders it without a provider (degradation proof), and
+  type-checks the no-cast `SharePopover` slot assignment.
+
+**Deliberate divergences from the origin popovers** (seam-forced, not
+defects): the three public-link label states ("Copy" vs "Create + copy",
+CDN-vs-link sublabels) collapse to one label — link inventory lives behind
+the host's `shareableUrl`; the mobile Drawer/desktop Popover split stays with
+the shells/hosts (this is the BODY, positioned by its opener); the
+`ShareLinkDialog` itself remains host content (C8) behind `manageLinks`.
+
+## 0.1.1 — 2026-08-29
+
+Types-only fix; runtime behavior unchanged.
+
+- **Fixed: the `DurableSrc` unique-symbol brand was duplicated in the built
+  declarations.** The dts was built in two passes (mirroring the two-config
+  "use client" banner split), so the root `index.d.ts` declared its own copy
+  of the brand while `/core` and `/react` used a shared-chunk copy — two
+  distinct `unique symbol`s. Result: a `MediaClient` typed via the root entry
+  was nominally incompatible with `/core`'s `MediaProvider`, forcing a
+  documented cast in the host. The dts now builds in ONE pass over all three
+  entries (the JS banner split is unchanged), so the brand is declared once
+  in `index.d.ts` and the other entries' declarations import it.
+- **Canary added:** `verify:tarball` now compiles a consumer against the
+  packed tarball that assigns a root-typed `MediaClient` into
+  `/core`'s `MediaProvider` props with **no cast** — the brand-duplication
+  regression class fails `check:package` from now on.
+
 ## 0.1.0 — 2026-08-29
 
 Initial release (campaign ruling C19). Root types + `/core` headless hooks +

package/README.md

@@ -15,6 +15,7 @@ correct path is the only path the types allow.
 @ai-matrx/media          types only — MediaRef, DurableSrc, MediaClient, host ports
 @ai-matrx/media/core     headless React hooks (platform-free state machines)
 @ai-matrx/media/react    DOM components (Tailwind classes, inlined SVG icons)
+@ai-matrx/media/share    the complete share popover body (optional peer: @ai-matrx/associations)
 ```
 
 ## The rules the types enforce
@@ -86,6 +87,42 @@ without touching this package.
 </MediaProvider>
 ```
 
+### The complete share body (`/share`)
+
+`/share` ships the popover BODY the slot was reserved for — the canonical
+Matrx share experience:
+
+- **Copy public link** — one click asks `MediaClient.shareableUrl(ref)` for
+  the truly-permanent URL (the host's implementation reuses or mints a
+  no-expiry share link, or returns the permanent CDN URL for public files)
+  and copies it. `null` fails closed — never a signed URL.
+- **External refs** get the simplified surface: the safe external URL or a
+  disabled row.
+- **Manage all links** / **who-can-see-this** are host slots
+  (`manageLinks` callback, `AccessSummary` component) — link inventory and
+  reachability live with the host's iam surfaces.
+- **Linked to / Attach to…** — the association affordances, riding
+  `@ai-matrx/associations` through its public hooks. They light up when an
+  `AssociationsProvider` is mounted above and degrade to absent when not.
+
+```tsx
+import { createMediaSharePopover } from "@ai-matrx/media/share";
+
+const SharePopover = createMediaSharePopover({
+  manageLinks: (ctx) => openShareLinkDialog(ctx),   // optional
+  AccessSummary,                                    // optional host panel
+  notify: { success: toast.success, error: toast.error }, // optional
+});
+
+<MediaProvider client={client} ports={{ actions: { SharePopover, download, copy } }}>
+  {/* every toolbar/lightbox now opens the full share experience */}
+</MediaProvider>
+```
+
+Only `/share` carries the `@ai-matrx/associations` peer (optional — install
+it, plus `@ai-matrx/design-system` which its `/react` entry loads, to use
+this entry). The other entries never do.
+
 ## Styling
 
 `/react` uses Tailwind utility classes with semantic tokens (`bg-muted`,
@@ -97,9 +134,9 @@ without touching this package.
 
 ## SSR / RSC
 
-The root entry is server-safe (types + one pure function). `/core` and
-`/react` are client modules (`"use client"` is stamped per entry). Nothing
-touches `window` at import time.
+The root entry is server-safe (types + one pure function). `/core`, `/react`
+and `/share` are client modules (`"use client"` is stamped per entry).
+Nothing touches `window` at import time.
 
 ## License
 

package/dist/core.d.cts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { M as MediaClient, a as MediaHostPorts, b as MediaRefLike, c as MediaResolution, d as MediaUnavailableReason, D as DurableSrc, e as MediaActionContext, f as MediaActionKind, g as MediaSlotComponent, h as MediaSharePopoverProps } from './use-media-upload-VjUhqbyY.cjs';
-export { i as MediaUploadEntry, j as MediaUploadEntryStatus, k as MediaUploadProgress, U as UseMediaUploadResult, u as useMediaUpload } from './use-media-upload-VjUhqbyY.cjs';
+import { MediaClient, MediaHostPorts, MediaRefLike, MediaResolution, MediaUnavailableReason, DurableSrc, MediaActionContext, MediaActionKind, MediaSlotComponent, MediaSharePopoverProps } from './index.cjs';
+export { M as MediaUploadEntry, a as MediaUploadEntryStatus, b as MediaUploadProgress, U as UseMediaUploadResult, u as useMediaUpload } from './use-media-upload-v5Uq9Ruq.cjs';
 
 interface MediaProviderProps {
     client: MediaClient;

package/dist/core.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { M as MediaClient, a as MediaHostPorts, b as MediaRefLike, c as MediaResolution, d as MediaUnavailableReason, D as DurableSrc, e as MediaActionContext, f as MediaActionKind, g as MediaSlotComponent, h as MediaSharePopoverProps } from './use-media-upload-VjUhqbyY.js';
-export { i as MediaUploadEntry, j as MediaUploadEntryStatus, k as MediaUploadProgress, U as UseMediaUploadResult, u as useMediaUpload } from './use-media-upload-VjUhqbyY.js';
+import { MediaClient, MediaHostPorts, MediaRefLike, MediaResolution, MediaUnavailableReason, DurableSrc, MediaActionContext, MediaActionKind, MediaSlotComponent, MediaSharePopoverProps } from './index.js';
+export { M as MediaUploadEntry, a as MediaUploadEntryStatus, b as MediaUploadProgress, U as UseMediaUploadResult, u as useMediaUpload } from './use-media-upload-Dg2HSvTq.js';
 
 interface MediaProviderProps {
     client: MediaClient;

package/dist/react.cjs

@@ -42,16 +42,22 @@ __export(react_exports, {
   FileVideoIcon: () => FileVideoIcon,
   FolderIcon: () => FolderIcon,
   FolderOpenIcon: () => FolderOpenIcon,
+  GlobeIcon: () => GlobeIcon,
   ImageIcon: () => ImageIcon,
   ImageOffIcon: () => ImageOffIcon,
   InlineMediaRef: () => InlineMediaRef,
+  Link2Icon: () => Link2Icon,
   MediaActionToolbar: () => MediaActionToolbar,
   MediaLightbox: () => MediaLightbox,
   MediaThumbnail: () => MediaThumbnail,
   MusicIcon: () => MusicIcon,
   PackageBoxIcon: () => PackageBoxIcon,
   PenToolIcon: () => PenToolIcon,
+  PlusIcon: () => PlusIcon,
+  SearchIcon: () => SearchIcon,
+  Settings2Icon: () => Settings2Icon,
   Share2Icon: () => Share2Icon,
+  SpinnerIcon: () => SpinnerIcon,
   SubtitlesIcon: () => SubtitlesIcon,
   UploadIcon: () => UploadIcon,
   UploadProgressList: () => UploadProgressList,
@@ -308,6 +314,43 @@ function CheckCircle2Icon(props) {
     /* @__PURE__ */ (0, import_jsx_runtime.jsx)("path", { d: "m9 11 3 3L22 4" })
   ] });
 }
+function GlobeIcon(props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("svg", { ...svgProps(props), children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("circle", { cx: "12", cy: "12", r: "10" }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("path", { d: "M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20" }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("path", { d: "M2 12h20" })
+  ] });
+}
+function Link2Icon(props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("svg", { ...svgProps(props), children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("path", { d: "M9 17H7A5 5 0 0 1 7 7h2" }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("path", { d: "M15 7h2a5 5 0 1 1 0 10h-2" }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("line", { x1: "8", x2: "16", y1: "12", y2: "12" })
+  ] });
+}
+function Settings2Icon(props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("svg", { ...svgProps(props), children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("path", { d: "M20 7h-9" }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("path", { d: "M14 17H5" }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("circle", { cx: "17", cy: "17", r: "3" }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("circle", { cx: "7", cy: "7", r: "3" })
+  ] });
+}
+function SpinnerIcon(props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("svg", { ...svgProps(props), children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("path", { d: "M21 12a9 9 0 1 1-6.219-8.56" }) });
+}
+function PlusIcon(props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("svg", { ...svgProps(props), children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("path", { d: "M5 12h14" }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("path", { d: "M12 5v14" })
+  ] });
+}
+function SearchIcon(props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("svg", { ...svgProps(props), children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("circle", { cx: "11", cy: "11", r: "8" }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("path", { d: "m21 21-4.3-4.3" })
+  ] });
+}
 
 // src/core/file-kind.ts
 var ROWS = [