@intellectif/lk-react 23.1.0 → 23.1.2

package/dist/chunk-NDBMKGQ5.cjs

@@ -1,599 +0,0 @@
-'use client';
-'use strict';
-
-var chunkBIGGXHAW_cjs = require('./chunk-BIGGXHAW.cjs');
-var lkCore = require('@intellectif/lk-core');
-var react = require('react');
-var jsxRuntime = require('react/jsx-runtime');
-
-var groups = /* @__PURE__ */ new Map();
-function joinPlaybackGroup(group, element) {
-  let members = groups.get(group);
-  if (members === void 0) {
-    members = /* @__PURE__ */ new Set();
-    groups.set(group, members);
-  }
-  members.add(element);
-  return () => {
-    const current = groups.get(group);
-    if (current === void 0) {
-      return;
-    }
-    current.delete(element);
-    if (current.size === 0) {
-      groups.delete(group);
-    }
-  };
-}
-function pausePlaybackGroupOthers(group, element) {
-  const members = groups.get(group);
-  if (members === void 0) {
-    return;
-  }
-  for (const member of members) {
-    if (member !== element && !member.paused) {
-      member.pause();
-    }
-  }
-}
-function usePlaybackGroup(ref, group) {
-  react.useEffect(() => {
-    const element = ref.current;
-    if (group === void 0 || element === null) {
-      return;
-    }
-    return joinPlaybackGroup(group, element);
-  });
-}
-var RESUME_EPSILON = 0.25;
-var SEEK_EPSILON = 0.35;
-var NO_PROGRESS = 0.25;
-var formatTime = (seconds) => {
-  if (!Number.isFinite(seconds) || seconds < 0) {
-    return "0:00";
-  }
-  const whole = Math.floor(seconds);
-  return `${Math.floor(whole / 60)}:${String(whole % 60).padStart(2, "0")}`;
-};
-function AudioTransport({
-  media,
-  policy,
-  renderMode = "practice",
-  disabled = false,
-  locale,
-  mediaBudget,
-  mediaStrings,
-  strings,
-  onInteraction,
-  playbackGroup
-}) {
-  const elementRef = react.useRef(null);
-  const statusId = react.useId();
-  usePlaybackGroup(elementRef, playbackGroup);
-  const suppliedStrings = mediaBudget?.strings ?? mediaStrings;
-  const fromProvider = chunkBIGGXHAW_cjs.useLkStrings(strings);
-  const s = {
-    ...fromProvider.media,
-    ...mediaStrings,
-    ...mediaBudget?.strings
-  };
-  const enforced = mediaBudget?.enforced ?? renderMode !== "review";
-  const budgeted = enforced && policy.maxPlays !== null && mediaBudget !== void 0;
-  const maxPlays = policy.maxPlays ?? 0;
-  const usedRef = react.useRef(mediaBudget?.entry?.plays ?? 0);
-  const pendingRef = react.useRef(false);
-  const resumeAtRef = react.useRef(null);
-  const highWaterRef = react.useRef(0);
-  const chargeRef = react.useRef(null);
-  const seededRef = react.useRef(false);
-  const lastPositionRef = react.useRef(-1);
-  const selfStartRef = react.useRef(false);
-  const paidRef = react.useRef(false);
-  const [used, setUsed] = react.useState(usedRef.current);
-  const [playing, setPlaying] = react.useState(false);
-  const [pending, setPending] = react.useState(false);
-  const [elapsed, setElapsed] = react.useState(0);
-  const [duration, setDuration] = react.useState(0);
-  const [muted, setMuted] = react.useState(false);
-  const [volume, setVolume] = react.useState(1);
-  const [confirming, setConfirming] = react.useState(false);
-  const [notice, setNotice] = react.useState("");
-  const [noticeNonce, setNoticeNonce] = react.useState(0);
-  const remaining = Math.max(0, maxPlays - used);
-  const announce = react.useCallback((message) => {
-    setNotice(message);
-    setNoticeNonce((n) => n + 1);
-  }, []);
-  const emit = react.useCallback(
-    (type, playsUsed) => {
-      if (!budgeted || mediaBudget === void 0 || onInteraction === void 0) {
-        return;
-      }
-      onInteraction({
-        type,
-        activityId: mediaBudget.activityId ?? mediaBudget.slotId,
-        timestamp: Date.now(),
-        payload: {
-          mediaKey: mediaBudget.key,
-          mediaType: "audio",
-          playsUsed,
-          maxPlays,
-          playsRemaining: Math.max(0, maxPlays - playsUsed)
-        }
-      });
-    },
-    [budgeted, mediaBudget, maxPlays, onInteraction]
-  );
-  const reportPosition = react.useCallback(
-    (seconds) => {
-      mediaBudget?.onPosition?.(mediaBudget.key, seconds);
-    },
-    [mediaBudget]
-  );
-  const isResume = react.useCallback((element) => {
-    const at = resumeAtRef.current;
-    return at !== null && Math.abs(element.currentTime - at) < RESUME_EPSILON;
-  }, []);
-  const buildClaim = react.useCallback(() => {
-    if (mediaBudget === void 0) {
-      return null;
-    }
-    return {
-      key: mediaBudget.key,
-      previousPlaysUsed: usedRef.current,
-      playsUsed: usedRef.current + 1,
-      maxPlays,
-      playsRemaining: Math.max(0, maxPlays - (usedRef.current + 1)),
-      slotId: mediaBudget.slotId,
-      index: mediaBudget.index,
-      ...mediaBudget.activityId !== void 0 ? { activityId: mediaBudget.activityId } : {}
-    };
-  }, [mediaBudget, maxPlays]);
-  const refuse = react.useCallback(() => {
-    announce(s.noPlaysRemaining);
-    emit("media-play-refused", usedRef.current);
-  }, [announce, emit, s.noPlaysRemaining]);
-  const startPlayback = react.useCallback(() => {
-    const element = elementRef.current;
-    if (element === null) {
-      return;
-    }
-    highWaterRef.current = element.currentTime;
-    selfStartRef.current = true;
-    void element.play().catch(() => {
-      selfStartRef.current = false;
-    });
-  }, []);
-  const commit = react.useCallback(
-    (claim) => {
-      const element = elementRef.current;
-      chargeRef.current = { claim, at: element?.currentTime ?? 0 };
-      usedRef.current = claim.playsUsed;
-      setUsed(claim.playsUsed);
-      emit("media-play-consumed", claim.playsUsed);
-    },
-    [emit]
-  );
-  const claimAndStart = react.useCallback(
-    (element, alreadyPlaying) => {
-      if (disabled) {
-        if (alreadyPlaying) {
-          element.pause();
-        }
-        return;
-      }
-      const claim = buildClaim();
-      if (claim === null) {
-        return;
-      }
-      const result = mediaBudget?.onPlayConsumed?.(claim);
-      if (result !== void 0 && typeof result.then === "function") {
-        if (alreadyPlaying) {
-          element.pause();
-        }
-        pendingRef.current = true;
-        setPending(true);
-        void result.then((grant) => {
-          const granted = grant !== void 0 && Number.isInteger(grant.playsUsed) ? grant.playsUsed : claim.playsUsed;
-          if (granted > maxPlays) {
-            usedRef.current = granted;
-            setUsed(granted);
-            refuse();
-            return;
-          }
-          commit({ ...claim, playsUsed: granted });
-          startPlayback();
-        }).catch(() => {
-          announce(s.playFailed);
-          emit("media-play-errored", usedRef.current);
-        }).finally(() => {
-          pendingRef.current = false;
-          setPending(false);
-        });
-        return;
-      }
-      commit(claim);
-      if (alreadyPlaying) {
-        paidRef.current = true;
-      } else {
-        startPlayback();
-      }
-    },
-    [
-      disabled,
-      buildClaim,
-      mediaBudget,
-      maxPlays,
-      commit,
-      startPlayback,
-      refuse,
-      announce,
-      emit,
-      s.playFailed
-    ]
-  );
-  const handleButton = react.useCallback(() => {
-    const element = elementRef.current;
-    if (element === null || pendingRef.current || disabled) {
-      return;
-    }
-    if (!element.paused) {
-      element.pause();
-      return;
-    }
-    if (!budgeted || isResume(element)) {
-      startPlayback();
-      return;
-    }
-    if (remaining === 0) {
-      refuse();
-      return;
-    }
-    if (remaining === 1 && !confirming) {
-      setConfirming(true);
-      return;
-    }
-    setConfirming(false);
-    claimAndStart(element, false);
-  }, [disabled, budgeted, isResume, startPlayback, remaining, refuse, confirming, claimAndStart]);
-  const handleLoadedMetadata = react.useCallback(() => {
-    const element = elementRef.current;
-    if (element === null) {
-      return;
-    }
-    setDuration(Number.isFinite(element.duration) ? element.duration : 0);
-    const at = mediaBudget?.entry?.at;
-    if (!seededRef.current && typeof at === "number" && Number.isFinite(at) && at > 0) {
-      seededRef.current = true;
-      highWaterRef.current = at;
-      resumeAtRef.current = at;
-      element.currentTime = at;
-      setElapsed(at);
-    }
-  }, [mediaBudget]);
-  const handlePlay = react.useCallback(() => {
-    const element = elementRef.current;
-    if (element === null) {
-      return;
-    }
-    if (disabled) {
-      element.pause();
-      return;
-    }
-    if (playbackGroup !== void 0) {
-      pausePlaybackGroupOthers(playbackGroup, element);
-    }
-    if (selfStartRef.current) {
-      selfStartRef.current = false;
-      paidRef.current = true;
-      setPlaying(true);
-      return;
-    }
-    if (pendingRef.current) {
-      setPlaying(true);
-      return;
-    }
-    if (isResume(element)) {
-      paidRef.current = true;
-      setPlaying(true);
-      resumeAtRef.current = null;
-      return;
-    }
-    if (!budgeted) {
-      paidRef.current = true;
-      setPlaying(true);
-      return;
-    }
-    if (remaining === 0) {
-      element.pause();
-      refuse();
-      return;
-    }
-    setPlaying(true);
-    claimAndStart(element, true);
-  }, [disabled, playbackGroup, isResume, budgeted, remaining, refuse, claimAndStart]);
-  const handlePause = react.useCallback(() => {
-    const element = elementRef.current;
-    setPlaying(false);
-    if (element === null) {
-      return;
-    }
-    if (!paidRef.current) {
-      return;
-    }
-    paidRef.current = false;
-    resumeAtRef.current = element.currentTime;
-    reportPosition(element.currentTime);
-  }, [reportPosition]);
-  const handleEnded = react.useCallback(() => {
-    paidRef.current = false;
-    setPlaying(false);
-    resumeAtRef.current = null;
-    highWaterRef.current = 0;
-    chargeRef.current = null;
-    setElapsed(0);
-    reportPosition(0);
-  }, [reportPosition]);
-  const handleTimeUpdate = react.useCallback(() => {
-    const element = elementRef.current;
-    if (element === null) {
-      return;
-    }
-    setElapsed(element.currentTime);
-    highWaterRef.current = Math.max(highWaterRef.current, element.currentTime);
-    const whole = Math.floor(element.currentTime);
-    if (whole !== lastPositionRef.current) {
-      lastPositionRef.current = whole;
-      reportPosition(element.currentTime);
-    }
-  }, [reportPosition]);
-  const handleSeeking = react.useCallback(() => {
-    const element = elementRef.current;
-    if (element === null || policy.seek !== "none") {
-      return;
-    }
-    if (Math.abs(element.currentTime - highWaterRef.current) > SEEK_EPSILON) {
-      element.currentTime = highWaterRef.current;
-      announce(s.seekBlocked);
-    }
-  }, [policy.seek, announce, s.seekBlocked]);
-  const handleRateChange = react.useCallback(() => {
-    const element = elementRef.current;
-    if (element === null || policy.rate !== "fixed" || element.playbackRate === 1) {
-      return;
-    }
-    element.playbackRate = 1;
-    announce(s.rateBlocked);
-  }, [policy.rate, announce, s.rateBlocked]);
-  const handleError = react.useCallback(() => {
-    const charge = chargeRef.current;
-    const element = elementRef.current;
-    const progressed = charge !== null && element !== null && element.currentTime - charge.at >= NO_PROGRESS;
-    if (charge !== null && !progressed) {
-      if (mediaBudget?.onPlayRefunded !== void 0) {
-        usedRef.current = charge.claim.previousPlaysUsed;
-        setUsed(charge.claim.previousPlaysUsed);
-        mediaBudget.onPlayRefunded(charge.claim);
-        emit("media-play-refunded", charge.claim.previousPlaysUsed);
-      } else {
-        emit("media-play-errored", usedRef.current);
-      }
-    }
-    chargeRef.current = null;
-    setPlaying(false);
-    announce(s.playFailed);
-  }, [mediaBudget, emit, announce, s.playFailed]);
-  react.useEffect(() => {
-    const element = elementRef.current;
-    if (element !== null) {
-      element.volume = volume;
-      element.muted = muted;
-    }
-  }, [volume, muted]);
-  const exhausted = budgeted && remaining === 0;
-  const buttonLabel = pending ? s.preparing : playing ? s.pause : s.play;
-  return /* @__PURE__ */ jsxRuntime.jsxs("figure", { className: "lk-media", "data-controls": "minimal", children: [
-    /* @__PURE__ */ jsxRuntime.jsxs(
-      "audio",
-      {
-        ref: elementRef,
-        className: "lk-media-el",
-        preload: "metadata",
-        "aria-label": media.alt || void 0,
-        onLoadedMetadata: handleLoadedMetadata,
-        onPlay: handlePlay,
-        onPause: handlePause,
-        onEnded: handleEnded,
-        onTimeUpdate: handleTimeUpdate,
-        onSeeking: handleSeeking,
-        onRateChange: handleRateChange,
-        onError: handleError,
-        children: [
-          /* @__PURE__ */ jsxRuntime.jsx("source", { src: media.url }),
-          media.captionsUrl ? /* @__PURE__ */ jsxRuntime.jsx("track", { kind: "captions", src: media.captionsUrl, default: true }) : null
-        ]
-      }
-    ),
-    /* @__PURE__ */ jsxRuntime.jsxs(
-      "div",
-      {
-        className: "lk-media-transport",
-        dir: "ltr",
-        ...suppliedStrings !== void 0 && locale !== void 0 ? { lang: locale } : {},
-        children: [
-          /* @__PURE__ */ jsxRuntime.jsx(
-            "button",
-            {
-              type: "button",
-              className: "lk-media-play",
-              onClick: handleButton,
-              "aria-disabled": exhausted || disabled || void 0,
-              "aria-busy": pending || void 0,
-              "aria-label": exhausted ? `${s.play} \u2014 ${s.noPlaysRemaining}` : void 0,
-              "aria-describedby": budgeted ? statusId : void 0,
-              children: buttonLabel
-            }
-          ),
-          /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "lk-media-time", children: [
-            formatTime(elapsed),
-            " / ",
-            formatTime(duration)
-          ] }),
-          policy.seek === "allow" ? /* @__PURE__ */ jsxRuntime.jsx(
-            "input",
-            {
-              type: "range",
-              className: "lk-media-scrub",
-              min: 0,
-              max: duration || 0,
-              step: 0.1,
-              value: Math.min(elapsed, duration || 0),
-              "aria-label": s.seek,
-              "aria-valuetext": s.timeValue(formatTime(elapsed), formatTime(duration)),
-              onChange: (event) => {
-                const element = elementRef.current;
-                if (element !== null) {
-                  element.currentTime = Number(event.target.value);
-                }
-              }
-            }
-          ) : null,
-          /* @__PURE__ */ jsxRuntime.jsx(
-            "button",
-            {
-              type: "button",
-              className: "lk-media-mute",
-              "aria-pressed": muted,
-              onClick: () => setMuted((m) => !m),
-              children: muted ? s.unmute : s.mute
-            }
-          ),
-          /* @__PURE__ */ jsxRuntime.jsx(
-            "input",
-            {
-              type: "range",
-              className: "lk-media-volume",
-              min: 0,
-              max: 1,
-              step: 0.05,
-              value: volume,
-              "aria-label": s.volume,
-              onChange: (event) => setVolume(Number(event.target.value))
-            }
-          ),
-          policy.rate === "allow" ? /* @__PURE__ */ jsxRuntime.jsx(
-            "select",
-            {
-              className: "lk-media-rate",
-              "aria-label": s.speed,
-              defaultValue: "1",
-              onChange: (event) => {
-                const element = elementRef.current;
-                if (element !== null) {
-                  element.playbackRate = Number(event.target.value);
-                }
-              },
-              children: ["0.75", "1", "1.25", "1.5"].map((rate) => /* @__PURE__ */ jsxRuntime.jsxs("option", { value: rate, children: [
-                rate,
-                "\xD7"
-              ] }, rate))
-            }
-          ) : null
-        ]
-      }
-    ),
-    budgeted ? /* @__PURE__ */ jsxRuntime.jsx("p", { className: "lk-media-plays", id: statusId, role: "status", children: remaining > 0 ? s.playsRemaining(remaining, maxPlays) : s.noPlaysRemaining }) : null,
-    /* @__PURE__ */ jsxRuntime.jsx("p", { className: "lk-media-notice", role: "alert", children: notice }, noticeNonce),
-    confirming ? /* @__PURE__ */ jsxRuntime.jsxs("fieldset", { className: "lk-media-confirm", children: [
-      /* @__PURE__ */ jsxRuntime.jsx("legend", { children: s.lastPlayConfirm }),
-      /* @__PURE__ */ jsxRuntime.jsx(
-        "button",
-        {
-          type: "button",
-          className: "lk-media-confirm-start",
-          autoFocus: true,
-          onClick: () => {
-            const element = elementRef.current;
-            setConfirming(false);
-            if (element !== null) {
-              claimAndStart(element, false);
-            }
-          },
-          children: s.lastPlayStart
-        }
-      ),
-      /* @__PURE__ */ jsxRuntime.jsx(
-        "button",
-        {
-          type: "button",
-          className: "lk-media-confirm-cancel",
-          onClick: () => setConfirming(false),
-          children: s.lastPlayCancel
-        }
-      )
-    ] }) : null
-  ] });
-}
-function ActivityMedia(props) {
-  const { media, renderMode = "practice", playbackGroup } = props;
-  const s = chunkBIGGXHAW_cjs.useLkStrings(props.strings);
-  const audioRef = react.useRef(null);
-  usePlaybackGroup(audioRef, media.type === "audio" ? playbackGroup : void 0);
-  if (media.type === "image") {
-    return /* @__PURE__ */ jsxRuntime.jsx("figure", { className: "lk-media", children: /* @__PURE__ */ jsxRuntime.jsx("img", { className: "lk-media-el", src: media.url, alt: media.alt ?? "" }) });
-  }
-  if (media.type === "audio") {
-    const policy = lkCore.resolvePlaybackPolicy(media);
-    if (policy.maxPlays !== null && renderMode === "exam" && props.mediaBudget === void 0) {
-      throw new Error(
-        `ActivityMedia: audio ${JSON.stringify(media.url)} declares maxPlays and is rendered in renderMode "exam" without a \`mediaBudget\` binding. Nothing would persist the count, so a refresh restores the full budget while the page says plays remain. Render it through <ActivitySequence mediaBudget={\u2026}> or pass \`mediaBudget\` yourself.`
-      );
-    }
-    if (policy.controls === "minimal" && renderMode !== "review") {
-      return /* @__PURE__ */ jsxRuntime.jsx(AudioTransport, { ...props, media, policy });
-    }
-    const hints = renderMode === "review" ? [] : policy.nativeControlHints;
-    return /* @__PURE__ */ jsxRuntime.jsx("figure", { className: "lk-media", children: /* @__PURE__ */ jsxRuntime.jsxs(
-      "audio",
-      {
-        ref: audioRef,
-        className: "lk-media-el",
-        controls: true,
-        "aria-label": media.alt || void 0,
-        ...playbackGroup !== void 0 ? {
-          onPlay: (event) => pausePlaybackGroupOthers(playbackGroup, event.currentTarget)
-        } : {},
-        ...hints.length > 0 ? {
-          controlsList: hints.map((hint) => hint === "hide-download" ? "nodownload" : "noplaybackrate").join(" ")
-        } : {},
-        children: [
-          /* @__PURE__ */ jsxRuntime.jsx("source", { src: media.url }),
-          media.captionsUrl ? /* @__PURE__ */ jsxRuntime.jsx("track", { kind: "captions", src: media.captionsUrl, default: true }) : null
-        ]
-      }
-    ) });
-  }
-  if (media.type === "embed") {
-    return /* @__PURE__ */ jsxRuntime.jsx("figure", { className: "lk-media", children: /* @__PURE__ */ jsxRuntime.jsx("div", { className: "lk-media-embed", children: /* @__PURE__ */ jsxRuntime.jsx(
-      "iframe",
-      {
-        className: "lk-media-el",
-        src: media.url,
-        title: media.alt ?? s.embeddedMedia,
-        loading: "lazy",
-        referrerPolicy: "strict-origin-when-cross-origin",
-        sandbox: "allow-scripts allow-same-origin allow-presentation",
-        allow: "accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share",
-        allowFullScreen: true
-      }
-    ) }) });
-  }
-  return /* @__PURE__ */ jsxRuntime.jsx("figure", { className: "lk-media", children: /* @__PURE__ */ jsxRuntime.jsxs("video", { className: "lk-media-el", controls: true, "aria-label": media.alt || void 0, children: [
-    /* @__PURE__ */ jsxRuntime.jsx("source", { src: media.url }),
-    media.captionsUrl ? /* @__PURE__ */ jsxRuntime.jsx("track", { kind: "captions", src: media.captionsUrl, default: true }) : null
-  ] }) });
-}
-
-exports.ActivityMedia = ActivityMedia;
-//# sourceMappingURL=chunk-NDBMKGQ5.cjs.map
-//# sourceMappingURL=chunk-NDBMKGQ5.cjs.map