@ai-matrx/media 0.1.1 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,71 @@
 # @ai-matrx/media
 
+## 0.2.1 — 2026-08-30
+
+Additive only — every default unchanged. Closes the wave-2 gap that kept the
+host's video lightbox host-side: `MediaLightbox` had no video passthrough.
+
+- **`MediaLightbox`** gains `autoPlay`, `playsInline`, `poster`, and
+  `playbackLabel`, forwarded to the underlying `InlineMediaRef`:
+  - `poster` is typed as the branded `DurableSrc` (law 3 — the host
+    resolves/mints it, exactly like the element src; no raw-string lane);
+  - `playbackLabel` sets the label reported to the host's existing
+    `playbackSession` port while the media plays (e.g. "Video
+    (fullscreen)") — playback still rides the ONE port, no new lane.
+- **`InlineMediaRef`** gains the same two new props (`poster` →
+  `<video poster>`; `playbackLabel` → the playback-session registration,
+  defaulting to `alt` then "Media file" as before). `autoPlay`/`playsInline`
+  already existed there.
+
+## 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.

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/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 = [
@@ -895,6 +938,8 @@ function InlineMediaRef({
   playsInline,
   preload,
   controlsList,
+  poster,
+  playbackLabel,
   rounded = "md",
   onClick,
   onError,
@@ -938,7 +983,7 @@ function InlineMediaRef({
     {
       isPlaying: isMediaPlaying,
       source: "file-media",
-      label: alt || "Media file",
+      label: playbackLabel ?? (alt || "Media file"),
       trackKey
     },
     sessionElRef
@@ -1079,6 +1124,7 @@ function InlineMediaRef({
         playsInline,
         preload,
         controlsList,
+        poster,
         onLoadedData: onLoad,
         onError: handleLoadError,
         crossOrigin,
@@ -2037,6 +2083,10 @@ function MediaLightbox({
   fileName,
   alt,
   as,
+  autoPlay,
+  playsInline,
+  poster,
+  playbackLabel,
   actions,
   hideUnavailableActions = false,
   headerExtra,
@@ -2115,7 +2165,11 @@ function MediaLightbox({
                 fit: "contain",
                 rounded: "none",
                 alt: alt ?? fileName ?? "",
-                as
+                as,
+                autoPlay,
+                playsInline,
+                poster,
+                playbackLabel
               }
             ) })
           }