@intellectif/lk-react 23.1.0 → 23.1.2

package/dist/chunk-LPUWXIPR.cjs

@@ -1,578 +0,0 @@
-'use client';
-'use strict';
-
-var chunkTUVENMXB_cjs = require('./chunk-TUVENMXB.cjs');
-var lkCore = require('@intellectif/lk-core');
-var react = require('react');
-
-var SequenceSlotContext = react.createContext(null);
-var lastTake = 0;
-function mintTake() {
-  lastTake += 1;
-  return lastTake;
-}
-var takes = /* @__PURE__ */ new WeakMap();
-function stampTake(value, take) {
-  takes.set(value, take);
-  return value;
-}
-function takeOf(value) {
-  return typeof value === "object" && value !== null ? takes.get(value) : void 0;
-}
-
-// src/components/_internal.ts
-function isDevelopment() {
-  try {
-    return process.env.NODE_ENV !== "production";
-  } catch {
-    return true;
-  }
-}
-var ANONYMOUS_ACTOR = {
-  objectType: "Agent",
-  account: { homePage: "https://github.com/intellectif/learning-kit", name: "anonymous" }
-};
-function objectIdFor(id) {
-  return `urn:learning-kit:activity:${encodeURIComponent(id)}`;
-}
-function randomSessionId() {
-  const c = globalThis.crypto;
-  if (c?.randomUUID) {
-    return c.randomUUID();
-  }
-  return `s-${Math.random().toString(36).slice(2)}${Math.random().toString(36).slice(2)}`;
-}
-function legacyCorrect(detail) {
-  const { correct } = detail;
-  return typeof correct === "boolean" ? correct : void 0;
-}
-function detailIsRight(detail) {
-  const outcome = detail.outcome;
-  return outcome === void 0 ? legacyCorrect(detail) === true : outcome === "correct";
-}
-
-// src/ai/rules.ts
-var DEFAULT_MAX_HINTS = 3;
-var MAX_HINTS_CEILING = 10;
-function limitOf(asked) {
-  return typeof asked === "number" && Number.isInteger(asked) && asked >= 1 ? Math.min(asked, MAX_HINTS_CEILING) : DEFAULT_MAX_HINTS;
-}
-function hintLimit(ai) {
-  return limitOf(ai?.maxHints);
-}
-function writingFeedbackLimit(ai) {
-  return limitOf(ai?.maxWritingFeedback);
-}
-function writingFeedbackOffered(input) {
-  const { data, renderMode, submitted, disabled } = input;
-  const delivery = input.delivery ?? lkCore.OPEN_DELIVERY_POLICY;
-  return delivery.feedback && delivery.solutions && delivery.ai.explanations && renderMode === "practice" && !submitted && !disabled && data.redacted !== true && lkCore.aiSupports(data.type, "writing-feedback") && lkCore.aiAllowedByContent(data, "writing-feedback");
-}
-function hintOffered(input) {
-  const { data, renderMode, submitted, disabled } = input;
-  const delivery = input.delivery ?? lkCore.OPEN_DELIVERY_POLICY;
-  return delivery.hints && delivery.ai.hints && renderMode === "practice" && !submitted && !disabled && data.redacted !== true && lkCore.aiSupports(data.type, "hint") && lkCore.aiAllowedByContent(data, "hint");
-}
-function explanationOffered(input) {
-  const { data, renderMode, submitted, outcome } = input;
-  const delivery = input.delivery ?? lkCore.OPEN_DELIVERY_POLICY;
-  if (!delivery.feedback || !delivery.solutions || !delivery.ai.explanations) {
-    return false;
-  }
-  const graded = renderMode === "practice" && submitted || renderMode === "review" && outcome?.status === "scored";
-  return graded && lkCore.aiSupports(data.type, "explanation") && lkCore.aiAllowedByContent(data, "explanation");
-}
-function coachingOffered(input) {
-  const { data, renderMode, marked } = input;
-  const delivery = input.delivery ?? lkCore.OPEN_DELIVERY_POLICY;
-  return delivery.feedback && delivery.ai.explanations && renderMode !== "exam" && marked && lkCore.aiSupports(data.type, "pronunciation-coaching") && lkCore.aiAllowedByContent(data, "pronunciation-coaching");
-}
-function callPort(call) {
-  try {
-    return Promise.resolve(call());
-  } catch (error) {
-    return Promise.reject(error);
-  }
-}
-function warnRefused(feature, activityId, reason) {
-  if (isDevelopment()) {
-    console.warn(
-      `learning-kit: the AI ${feature} for "${activityId}" was not shown (${reason}). The learner saw "not available" instead.`
-    );
-  }
-}
-var localeOf = (ai, locale) => {
-  const chosen = ai?.learnerLocale ?? locale;
-  return chosen === void 0 ? {} : { learnerLocale: chosen };
-};
-function explanationKey(renderMode, submitted, response, outcome) {
-  let graded = "";
-  if (outcome !== void 0) {
-    graded = `${outcome.status}:${"score" in outcome ? outcome.score : ""}`;
-  }
-  return `${renderMode}|${submitted}|${graded}|${JSON.stringify(response)}`;
-}
-
-// src/ai/useAiHelp.ts
-function modeInForce(asked, around) {
-  if (around === "exam") {
-    return "exam";
-  }
-  return asked ?? around ?? "practice";
-}
-function shownPayload(result) {
-  return {
-    ...result.provenance !== void 0 ? { provenance: result.provenance } : {},
-    ...result.usage !== void 0 ? { usage: result.usage } : {}
-  };
-}
-function useAiExplanation(input) {
-  const { data, response, submitted, outcome } = input;
-  const around = react.useContext(SequenceSlotContext);
-  const renderMode = modeInForce(input.renderMode, around?.renderMode);
-  const delivery = lkCore.combineDeliveryPolicies(input.delivery, around?.delivery);
-  const ai = chunkTUVENMXB_cjs.useLearnerAi(input.ai);
-  const resetKey = explanationKey(renderMode, submitted, response, outcome);
-  const [state, setState] = react.useState({ key: resetKey, status: "idle" });
-  const run = react.useRef(0);
-  const controller = react.useRef(null);
-  const current = state.key === resetKey ? state : { key: resetKey, status: "idle" };
-  const offered = ai?.explain !== void 0 && explanationOffered({ data, renderMode, submitted, outcome, delivery });
-  const latest = react.useRef({ input, renderMode, ai, resetKey, offered, current });
-  latest.current = { input, renderMode, ai, resetKey, offered, current };
-  react.useEffect(() => {
-    return () => {
-      run.current += 1;
-      controller.current?.abort();
-      controller.current = null;
-    };
-  }, [resetKey]);
-  const ask = react.useCallback(() => {
-    const now = latest.current;
-    const port = now.ai?.explain;
-    if (port === void 0 || !now.offered || now.current.status === "loading") {
-      return;
-    }
-    const key = now.resetKey;
-    const request = lkCore.aiExplanationRequest({
-      data: now.input.data,
-      response: now.input.response,
-      ...now.renderMode === "review" && now.input.outcome !== void 0 ? { outcome: now.input.outcome } : {},
-      ...localeOf(now.ai, now.input.locale)
-    });
-    if (request === null) {
-      setState({ key, status: "unavailable" });
-      return;
-    }
-    run.current += 1;
-    const mine = run.current;
-    controller.current?.abort();
-    const abort = new AbortController();
-    controller.current = abort;
-    setState({ key, status: "loading" });
-    callPort(() => port(request, { signal: abort.signal })).then(
-      (raw) => {
-        if (run.current !== mine) {
-          return;
-        }
-        const checked = lkCore.checkAiExplanation(raw, request);
-        if (!checked.ok) {
-          warnRefused("explanation", now.input.data.id, checked.refusal);
-          setState({ key, status: "unavailable" });
-          latest.current.input.onInteraction?.({
-            type: "ai-help-refused",
-            activityId: now.input.data.id,
-            timestamp: Date.now(),
-            payload: { feature: "explanation", reason: checked.refusal }
-          });
-          return;
-        }
-        setState({ key, status: "shown", result: checked.result });
-        latest.current.input.onInteraction?.({
-          type: "ai-explanation-shown",
-          activityId: now.input.data.id,
-          timestamp: Date.now(),
-          payload: shownPayload(checked.result)
-        });
-      },
-      () => {
-        if (run.current === mine) {
-          setState({ key, status: "unavailable" });
-        }
-      }
-    );
-  }, []);
-  return {
-    offered,
-    status: current.status,
-    explanation: current.status === "shown" ? current.result : null,
-    ask
-  };
-}
-function useAiHints(input) {
-  const { data, submitted } = input;
-  const around = react.useContext(SequenceSlotContext);
-  const renderMode = modeInForce(input.renderMode, around?.renderMode);
-  const delivery = lkCore.combineDeliveryPolicies(input.delivery, around?.delivery);
-  const disabled = input.disabled === true;
-  const ai = chunkTUVENMXB_cjs.useLearnerAi(input.ai);
-  const resetKey = data.id;
-  const [state, setState] = react.useState({ key: resetKey, hints: [], status: "idle" });
-  const run = react.useRef(0);
-  const controller = react.useRef(null);
-  const current = state.key === resetKey ? state : { key: resetKey, hints: [], status: "idle" };
-  const offered = ai?.hint !== void 0 && hintOffered({ data, renderMode, submitted, disabled, delivery });
-  const limit = hintLimit(ai);
-  const latest = react.useRef({ input, renderMode, ai, offered, limit, current });
-  latest.current = { input, renderMode, ai, offered, limit, current };
-  react.useEffect(() => {
-    return () => {
-      run.current += 1;
-      controller.current?.abort();
-      controller.current = null;
-    };
-  }, [resetKey]);
-  react.useEffect(() => {
-    if (!offered) {
-      run.current += 1;
-      controller.current?.abort();
-      controller.current = null;
-      setState(
-        (previous) => previous.status === "loading" ? { ...previous, status: "idle" } : previous
-      );
-    }
-  }, [offered]);
-  const ask = react.useCallback(() => {
-    const now = latest.current;
-    const port = now.ai?.hint;
-    const held = now.current;
-    if (port === void 0 || !now.offered || held.status === "loading" || held.hints.length >= now.limit) {
-      return;
-    }
-    const key = held.key;
-    const request = lkCore.aiHintRequest({
-      data: now.input.data,
-      response: now.input.response,
-      previousHints: held.hints.map((hint) => hint.text),
-      ...localeOf(now.ai, now.input.locale)
-    });
-    if (request === null) {
-      setState({ ...held, status: "unavailable" });
-      return;
-    }
-    run.current += 1;
-    const mine = run.current;
-    controller.current?.abort();
-    const abort = new AbortController();
-    controller.current = abort;
-    setState({ ...held, status: "loading" });
-    callPort(() => port(request, { signal: abort.signal })).then(
-      (raw) => {
-        if (run.current !== mine) {
-          return;
-        }
-        const checked = lkCore.checkAiHint(raw, request);
-        if (!checked.ok) {
-          warnRefused("hint", now.input.data.id, checked.refusal);
-          setState((shown) => ({ ...shown, status: "unavailable" }));
-          latest.current.input.onInteraction?.({
-            type: "ai-help-refused",
-            activityId: now.input.data.id,
-            timestamp: Date.now(),
-            payload: {
-              feature: "hint",
-              reason: checked.refusal,
-              hintNumber: request.hintNumber
-            }
-          });
-          return;
-        }
-        setState((shown) => ({
-          ...shown,
-          hints: shown.key === key ? [...shown.hints, checked.result] : shown.hints,
-          status: "idle"
-        }));
-        latest.current.input.onInteraction?.({
-          type: "ai-hint-shown",
-          activityId: now.input.data.id,
-          timestamp: Date.now(),
-          payload: { hintNumber: request.hintNumber, ...shownPayload(checked.result) }
-        });
-      },
-      () => {
-        if (run.current === mine) {
-          setState((shown) => ({ ...shown, status: "unavailable" }));
-        }
-      }
-    );
-  }, []);
-  return {
-    offered,
-    status: current.status,
-    hints: current.hints,
-    limit,
-    used: current.hints.length,
-    ask
-  };
-}
-var draftOf = (response) => response.type === "written-response" ? response.text : "";
-function useAiWritingFeedback(input) {
-  const { data, submitted, response } = input;
-  const around = react.useContext(SequenceSlotContext);
-  const renderMode = modeInForce(input.renderMode, around?.renderMode);
-  const delivery = lkCore.combineDeliveryPolicies(input.delivery, around?.delivery);
-  const disabled = input.disabled === true;
-  const ai = chunkTUVENMXB_cjs.useLearnerAi(input.ai);
-  const resetKey = data.id;
-  const [state, setState] = react.useState({
-    key: resetKey,
-    shown: [],
-    status: "idle"
-  });
-  const run = react.useRef(0);
-  const controller = react.useRef(null);
-  const current = state.key === resetKey ? state : { key: resetKey, shown: [], status: "idle" };
-  const offered = ai?.writingFeedback !== void 0 && writingFeedbackOffered({ data, renderMode, submitted, disabled, delivery });
-  const limit = writingFeedbackLimit(ai);
-  const latest = react.useRef({ input, ai, offered, limit, current });
-  latest.current = { input, ai, offered, limit, current };
-  react.useEffect(() => {
-    return () => {
-      run.current += 1;
-      controller.current?.abort();
-      controller.current = null;
-    };
-  }, [resetKey]);
-  react.useEffect(() => {
-    if (!offered) {
-      run.current += 1;
-      controller.current?.abort();
-      controller.current = null;
-      setState(
-        (previous) => previous.status === "loading" ? { ...previous, status: "idle" } : previous
-      );
-    }
-  }, [offered]);
-  const ask = react.useCallback(() => {
-    const now = latest.current;
-    const port = now.ai?.writingFeedback;
-    const held = now.current;
-    if (port === void 0 || !now.offered || held.status === "loading" || held.shown.length >= now.limit) {
-      return;
-    }
-    const key = held.key;
-    const about = draftOf(now.input.response);
-    const request = lkCore.aiWritingFeedbackRequest({
-      data: now.input.data,
-      response: now.input.response,
-      previousFeedback: held.shown.map((one) => one.feedback.text),
-      ...localeOf(now.ai, now.input.locale)
-    });
-    if (request === null) {
-      return;
-    }
-    run.current += 1;
-    const mine = run.current;
-    controller.current?.abort();
-    const abort = new AbortController();
-    controller.current = abort;
-    setState({ ...held, status: "loading" });
-    callPort(() => port(request, { signal: abort.signal })).then(
-      (raw) => {
-        if (run.current !== mine) {
-          return;
-        }
-        const checked = lkCore.checkAiWritingFeedback(raw, request);
-        if (!checked.ok) {
-          warnRefused("writing feedback", now.input.data.id, checked.refusal);
-          setState((was) => ({ ...was, status: "unavailable" }));
-          latest.current.input.onInteraction?.({
-            type: "ai-help-refused",
-            activityId: now.input.data.id,
-            timestamp: Date.now(),
-            payload: {
-              feature: "writing-feedback",
-              reason: checked.refusal,
-              draftNumber: request.draftNumber
-            }
-          });
-          return;
-        }
-        const { feedback } = checked;
-        setState((was) => ({
-          ...was,
-          shown: was.key === key ? [...was.shown, { feedback, about }] : was.shown,
-          status: "idle"
-        }));
-        latest.current.input.onInteraction?.({
-          type: "ai-writing-feedback-shown",
-          activityId: now.input.data.id,
-          timestamp: Date.now(),
-          payload: {
-            draftNumber: request.draftNumber,
-            corrections: feedback.corrections.length,
-            ...feedback.indicativeScore !== null ? { indicativeScore: feedback.indicativeScore } : {},
-            ...shownPayload(feedback)
-          }
-        });
-      },
-      () => {
-        if (run.current === mine) {
-          setState((was) => ({ ...was, status: "unavailable" }));
-        }
-      }
-    );
-  }, []);
-  const last = current.shown[current.shown.length - 1];
-  return {
-    offered,
-    status: current.status,
-    feedback: current.shown.map((one) => one.feedback),
-    latest: last?.feedback ?? null,
-    current: last !== void 0 && last.about === draftOf(response),
-    limit,
-    used: current.shown.length,
-    ask
-  };
-}
-function useAiCoaching(input) {
-  const { data, assessment, grade } = input;
-  const around = react.useContext(SequenceSlotContext);
-  const renderMode = modeInForce(input.renderMode, around?.renderMode);
-  const delivery = lkCore.combineDeliveryPolicies(input.delivery, around?.delivery);
-  const ai = chunkTUVENMXB_cjs.useLearnerAi(input.ai);
-  const { learnerLocale } = localeOf(ai, input.locale);
-  const { id, title, referenceText, locale: itemLocale, instructions, ai: permissions } = data;
-  const request = react.useMemo(() => {
-    const item = {
-      type: "read-aloud",
-      id,
-      title,
-      referenceText,
-      locale: itemLocale,
-      instructions,
-      ai: permissions
-    };
-    return lkCore.aiCoachingRequest({
-      data: item,
-      ...assessment !== void 0 && assessment !== null ? { assessment } : {},
-      ...grade !== void 0 && grade !== null ? { grade } : {},
-      ...learnerLocale !== void 0 ? { learnerLocale } : {}
-    });
-  }, [
-    id,
-    title,
-    referenceText,
-    itemLocale,
-    instructions,
-    permissions,
-    assessment,
-    grade,
-    learnerLocale
-  ]);
-  const take = typeof assessment?.recordingKey === "string" ? assessment.recordingKey : null;
-  const resetKey = react.useMemo(
-    () => request === null ? "" : JSON.stringify([take, request]),
-    [take, request]
-  );
-  const [state, setState] = react.useState({ key: resetKey, status: "idle" });
-  const run = react.useRef(0);
-  const controller = react.useRef(null);
-  const current = state.key === resetKey ? state : { key: resetKey, status: "idle" };
-  const offered = ai?.pronunciationCoaching !== void 0 && coachingOffered({
-    data: { type: "read-aloud", id, title, ai: permissions },
-    renderMode,
-    marked: request !== null,
-    delivery
-  });
-  const latest = react.useRef({ input, ai, request, resetKey, offered, current });
-  latest.current = { input, ai, request, resetKey, offered, current };
-  react.useEffect(() => {
-    return () => {
-      run.current += 1;
-      controller.current?.abort();
-      controller.current = null;
-    };
-  }, [resetKey]);
-  react.useEffect(() => {
-    if (!offered) {
-      run.current += 1;
-      controller.current?.abort();
-      controller.current = null;
-      setState(
-        (previous) => previous.status === "loading" ? { key: previous.key, status: "idle" } : previous
-      );
-    }
-  }, [offered]);
-  const ask = react.useCallback(() => {
-    const now = latest.current;
-    const port = now.ai?.pronunciationCoaching;
-    const request2 = now.request;
-    if (port === void 0 || !now.offered || request2 === null || now.current.status === "loading" || now.current.status === "shown") {
-      return;
-    }
-    const key = now.resetKey;
-    const activityId = request2.facts.activityId;
-    run.current += 1;
-    const mine = run.current;
-    controller.current?.abort();
-    const abort = new AbortController();
-    controller.current = abort;
-    setState({ key, status: "loading" });
-    callPort(() => port(request2, { signal: abort.signal })).then(
-      (raw) => {
-        if (run.current !== mine) {
-          return;
-        }
-        const checked = lkCore.checkAiCoaching(raw, request2);
-        if (!checked.ok) {
-          warnRefused("pronunciation coaching", activityId, checked.refusal);
-          setState({ key, status: "unavailable" });
-          latest.current.input.onInteraction?.({
-            type: "ai-help-refused",
-            activityId,
-            timestamp: Date.now(),
-            payload: { feature: "pronunciation-coaching", reason: checked.refusal }
-          });
-          return;
-        }
-        const { coaching } = checked;
-        setState({ key, status: "shown", coaching });
-        latest.current.input.onInteraction?.({
-          type: "ai-coaching-shown",
-          activityId,
-          timestamp: Date.now(),
-          payload: { words: coaching.words.length, ...shownPayload(coaching) }
-        });
-      },
-      () => {
-        if (run.current === mine) {
-          setState({ key, status: "unavailable" });
-        }
-      }
-    );
-  }, []);
-  return {
-    offered,
-    status: offered ? current.status : "idle",
-    coaching: offered && current.status === "shown" ? current.coaching : null,
-    ask
-  };
-}
-
-exports.ANONYMOUS_ACTOR = ANONYMOUS_ACTOR;
-exports.SequenceSlotContext = SequenceSlotContext;
-exports.detailIsRight = detailIsRight;
-exports.isDevelopment = isDevelopment;
-exports.legacyCorrect = legacyCorrect;
-exports.mintTake = mintTake;
-exports.objectIdFor = objectIdFor;
-exports.randomSessionId = randomSessionId;
-exports.stampTake = stampTake;
-exports.takeOf = takeOf;
-exports.useAiCoaching = useAiCoaching;
-exports.useAiExplanation = useAiExplanation;
-exports.useAiHints = useAiHints;
-exports.useAiWritingFeedback = useAiWritingFeedback;
-//# sourceMappingURL=chunk-LPUWXIPR.cjs.map
-//# sourceMappingURL=chunk-LPUWXIPR.cjs.map