@intellectif/lk-react 23.1.0 → 23.1.2

package/dist/components/GapSelect.cjs

@@ -1,21 +1,5 @@
 'use client';
-'use strict';
-
-var chunk7ALBSPYR_cjs = require('../chunk-7ALBSPYR.cjs');
-require('../chunk-KHKH5LCT.cjs');
-require('../chunk-2PNSVBLQ.cjs');
-require('../chunk-J3C72RPK.cjs');
-require('../chunk-LPUWXIPR.cjs');
-require('../chunk-NDBMKGQ5.cjs');
-require('../chunk-XOR4MPEN.cjs');
-require('../chunk-BIGGXHAW.cjs');
-require('../chunk-TUVENMXB.cjs');
-
-
-
-Object.defineProperty(exports, "GapSelect", {
-  enumerable: true,
-  get: function () { return chunk7ALBSPYR_cjs.GapSelect; }
-});
-//# sourceMappingURL=GapSelect.cjs.map
-//# sourceMappingURL=GapSelect.cjs.map
+"use client";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_GapSelect = require("../GapSelect-payTq_Zn.cjs");
+exports.GapSelect = require_GapSelect.GapSelect;

package/dist/components/GapSelect.d.cts

@@ -1,27 +1,2 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { GapSelectData } from '@intellectif/lk-core';
-import { A as ActivityProps } from '../types-CJgZWtl4.cjs';
-import '../ai/LkAiProvider.cjs';
-import 'react';
-import '../machine-CuwKqWXC.cjs';
-
-interface GapSelectProps extends ActivityProps<GapSelectData> {
-    /**
-     * Seeds the per-gap choice shuffle when `data.shuffleChoices` is set. Pass
-     * the attempt id, exactly as on `<MultipleChoice>`: an order nobody can
-     * reproduce cannot be reconciled with the attempt a server recorded. Without
-     * one, a random per-mount seed is used — stable within the mount, and
-     * deliberately not reproducible.
-     */
-    shuffleSeed?: string;
-}
-
-/**
- * Public Gap Select activity: the core wrapped in `ActivityErrorBoundary` so a
- * render failure (including the dev schema-validation throw and the
- * redacted-in-`practice` guard) degrades to an accessible fallback instead of
- * crashing the host.
- */
-declare function GapSelect(props: GapSelectProps): react_jsx_runtime.JSX.Element;
-
-export { GapSelect, type GapSelectProps };
+import { n as GapSelectProps, t as GapSelect } from "../index-BavVW5z5.cjs";
+export { GapSelect, type GapSelectProps };

package/dist/components/GapSelect.d.ts

@@ -1,27 +1,2 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { GapSelectData } from '@intellectif/lk-core';
-import { A as ActivityProps } from '../types-C4IsUQsK.js';
-import '../ai/LkAiProvider.js';
-import 'react';
-import '../machine-CuwKqWXC.js';
-
-interface GapSelectProps extends ActivityProps<GapSelectData> {
-    /**
-     * Seeds the per-gap choice shuffle when `data.shuffleChoices` is set. Pass
-     * the attempt id, exactly as on `<MultipleChoice>`: an order nobody can
-     * reproduce cannot be reconciled with the attempt a server recorded. Without
-     * one, a random per-mount seed is used — stable within the mount, and
-     * deliberately not reproducible.
-     */
-    shuffleSeed?: string;
-}
-
-/**
- * Public Gap Select activity: the core wrapped in `ActivityErrorBoundary` so a
- * render failure (including the dev schema-validation throw and the
- * redacted-in-`practice` guard) degrades to an accessible fallback instead of
- * crashing the host.
- */
-declare function GapSelect(props: GapSelectProps): react_jsx_runtime.JSX.Element;
-
-export { GapSelect, type GapSelectProps };
+import { n as GapSelectProps, t as GapSelect } from "../index-ZVvLHsd3.js";
+export { GapSelect, type GapSelectProps };

package/dist/components/GapSelect.js

@@ -1,12 +1,4 @@
 'use client';
-export { GapSelect } from '../chunk-ABJJ3LII.js';
-import '../chunk-FDQR4GAZ.js';
-import '../chunk-ORT3KLGI.js';
-import '../chunk-7SB2MJA4.js';
-import '../chunk-MXNC5UNO.js';
-import '../chunk-TS7J6DTY.js';
-import '../chunk-6N43WDVG.js';
-import '../chunk-HNLRVRQR.js';
-import '../chunk-ZPI6Q42R.js';
-//# sourceMappingURL=GapSelect.js.map
-//# sourceMappingURL=GapSelect.js.map
+"use client";
+import { t as GapSelect } from "../GapSelect-DUSiaEQH.js";
+export { GapSelect };

package/dist/components/InteractiveVideo.cjs

@@ -1,33 +1,6 @@
 'use client';
-'use strict';
-
-var chunkCWTUWNV3_cjs = require('../chunk-CWTUWNV3.cjs');
-require('../chunk-YY4PFR3Z.cjs');
-require('../chunk-DS6HN3YR.cjs');
-require('../chunk-7ALBSPYR.cjs');
-require('../chunk-NAK55BYU.cjs');
-require('../chunk-KHKH5LCT.cjs');
-require('../chunk-TP5UMRAU.cjs');
-require('../chunk-LBEKRN6Y.cjs');
-require('../chunk-UDCQTOVU.cjs');
-require('../chunk-OD65OZIW.cjs');
-require('../chunk-2PNSVBLQ.cjs');
-require('../chunk-J3C72RPK.cjs');
-require('../chunk-LPUWXIPR.cjs');
-require('../chunk-NDBMKGQ5.cjs');
-require('../chunk-XOR4MPEN.cjs');
-require('../chunk-BIGGXHAW.cjs');
-require('../chunk-TUVENMXB.cjs');
-
-
-
-Object.defineProperty(exports, "InteractiveVideo", {
-  enumerable: true,
-  get: function () { return chunkCWTUWNV3_cjs.InteractiveVideo; }
-});
-Object.defineProperty(exports, "resolveCaptionTracks", {
-  enumerable: true,
-  get: function () { return chunkCWTUWNV3_cjs.resolveCaptionTracks; }
-});
-//# sourceMappingURL=InteractiveVideo.cjs.map
-//# sourceMappingURL=InteractiveVideo.cjs.map
+"use client";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_InteractiveVideo = require("../InteractiveVideo-BguGv-HA.cjs");
+exports.InteractiveVideo = require_InteractiveVideo.InteractiveVideo;
+exports.resolveCaptionTracks = require_InteractiveVideo.resolveCaptionTracks;

package/dist/components/InteractiveVideo.d.cts

@@ -1,291 +1,3 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ItemGroup, MediaProgress, LearnerResponse, ItemOutcome, ActivityResult, InteractionEvent, ResolvedDeliveryPolicy, ResolvedItemScoringPolicy, InteractionKind, SpeechAssessment, MediaTrack, DeliveryPolicy, ItemScoringPolicy, ThemeTokens } from '@intellectif/lk-core';
-import { ReactNode } from 'react';
-import { LearnerAi } from '../ai/LkAiProvider.cjs';
-import { g as RenderableActivity, e as RenderMode, i as SequenceRecordingSlot, h as SequenceRecordingBinding, V as VideoPreferences, a as LkStringsOverride, H as HtmlSanitizer } from '../types-CJgZWtl4.cjs';
-export { C as CaptionSize } from '../types-CJgZWtl4.cjs';
-import '../machine-CuwKqWXC.cjs';
-
-/** An item group whose items may be `redact()` projections: the client's view of an interactive video. */
-type RenderableItemGroup = ItemGroup<RenderableActivity>;
-/** A question's place: its slot, as `<ActivitySequence>` reports it, plus the quiz it sits in. */
-interface InteractiveVideoSlot extends SequenceRecordingSlot {
-    cueId: string;
-}
-/** What `onFinished` reports: every question, and how the learner left it. */
-interface InteractiveVideoSummary {
-    slots: {
-        slotId: string;
-        activityId: string;
-        cueId: string;
-        status: 'answered' | 'skipped' | 'unreached';
-    }[];
-}
-/**
- * One question, as `renderQuestion` is handed it: what to draw, and the six
- * calls through which the video learns what the learner did.
- *
- * The calls are the ones the SDK's own components make, so a question the host
- * draws counts exactly as one the SDK draws — in the step dots, in whether a
- * required quiz lets the learner go on, on the end card and in `onFinished`.
- * Each keeps ONE identity per question for the life of the player, so it is
- * safe in an effect's dependencies, and each does nothing once the player has
- * unmounted.
- */
-interface InteractiveVideoQuestion {
-    /** The question, as the SDK would have rendered it: full data, or a `redact()` projection. */
-    activity: RenderableActivity;
-    /** Where it sits: the same object `onSubmit` and `onActivityComplete` are handed, for the life of the player. */
-    slot: InteractiveVideoSlot;
-    /**
-     * Passed through untouched. The SDK cannot enforce a mode for pixels it does
-     * not draw: in `exam` the host must not reveal correctness, and in `review`
-     * nothing is submittable — `submit`, `complete` and `clear` are ignored there.
-     */
-    renderMode: RenderMode;
-    /**
-     * `true` while this question is the one on screen: its quiz is open and it is
-     * the current step. `false` from the moment it leaves the screen — another
-     * step, the quiz closing, another quiz opening — and `true` again when the
-     * learner comes back.
-     *
-     * WHEN IT TURNS `false`, STOP THE MICROPHONE, ANY TIMER AND ANY SPEECH. The
-     * video pauses the `<audio>` and `<video>` elements inside the question and
-     * stops the recorders the SDK started, but it cannot reach a recorder it did
-     * not create.
-     */
-    active: boolean;
-    locale?: string;
-    /** The answer restored from `responses`. A starting value: read it once, as the SDK's components do. */
-    defaultValue?: LearnerResponse;
-    /** Whether `submittedSlotIds` names this question: it was handed in before this attempt resumed. */
-    defaultSubmitted: boolean;
-    /** Its stored outcome from `outcomes`: review, or the grade of a question graded later. Read live. */
-    outcome?: ItemOutcome;
-    /**
-     * An element inside the player, for popovers and tooltips. Portal into it
-     * rather than into `document.body`: in fullscreen only the player is painted,
-     * and anything outside it silently vanishes. It is drawn above the quiz, is
-     * the same element for the life of the player — one for every question, so
-     * key what you put in it — and is `null` only before the player's first
-     * commit.
-     */
-    portalContainer: HTMLElement | null;
-    /**
-     * The AI ports in force for this video — its `ai` prop, else an
-     * `LkAiProvider` above it — for a host that offers its own explanations or
-     * hints. Absent in `exam`: no question gives AI help there, and the SDK
-     * hands its ports to none.
-     */
-    ai?: LearnerAi;
-    /**
-     * The video's delivery policy, every setting spelled out: what this question
-     * may show. The SDK cannot keep a policy in pixels it does not draw — where
-     * `feedback` or `solutions` is `false`, show no mark and no answer.
-     */
-    delivery: ResolvedDeliveryPolicy;
-    /**
-     * The video's scoring policy, every setting spelled out: how many tries a
-     * question gives, which counts, and what tries and hints cost. The SDK's own
-     * questions apply it; a question you draw scores by it with lk-core's
-     * `scoreTries`, or not at all.
-     */
-    scoring: ResolvedItemScoringPolicy;
-    /**
-     * The learner committed an answer: marks the question answered and forwards
-     * to `onSubmit(response, slot)`. Latest wins: call it again for a new take or
-     * a corrected answer.
-     */
-    submit(response: LearnerResponse): void;
-    /**
-     * The answer has a result: marks the question answered, keeps `score / maxScore`
-     * for the end card when `maxScore > 0`, and forwards to
-     * `onActivityComplete(result, slot)`. Latest wins. Counts as answered on its
-     * own, without a `submit`, and forwards exactly what was called — no
-     * `onSubmit` is invented for it.
-     */
-    complete(result: ActivityResult): void;
-    /**
-     * The learner withdrew the answer — a "Try again". The question is unanswered
-     * again and its score forgotten: its step dot empties, a required quiz holds
-     * the learner again, and `onFinished` would report it `skipped`. Calls no
-     * host callback: the host already knows.
-     */
-    clear(): void;
-    /**
-     * Work is on its way for this question — an upload, an assessment. While any
-     * question is pending, Finish on the end card waits, and a video that ends
-     * does not finish by itself; closing the quiz, paging and seeking do not wait.
-     * Call `setPending(false)` however the work ends, a failure included.
-     */
-    setPending(pending: boolean): void;
-    /** Forwards to `onInteraction`, with this question's `activityId` and the time filled in. */
-    emit(type: InteractionKind, payload?: Record<string, unknown>): void;
-}
-interface InteractiveVideoProps {
-    /** An item group with a video stimulus and a timeline. Redacted projections in exam and review. */
-    group: RenderableItemGroup;
-    /**
-     * `practice` (the default) grades each question and shows its feedback;
-     * `exam` submits without showing correctness — a check-in marked later;
-     * `review` shows how each question was marked.
-     *
-     * `exam` does NOT make the video fit for an official summative exam. The
-     * learner controls the recording — rewinds it, slows it, reads its
-     * transcript — while the questions are open, and nothing here times a
-     * question or holds a single pass. Deliver a paper of record with
-     * `<ActivitySequence>`.
-     */
-    renderMode?: RenderMode;
-    /** Where to resume. Read through `readMediaProgress` and clamped; a required quiz is never skipped by a resume. */
-    progress?: MediaProgress;
-    /** At most every 5 s while playing, and on pause, seek, a quiz opening and the end. */
-    onProgress?: (progress: MediaProgress) => void;
-    /** Answers restored from the host, by slot id: `AttemptState.responses`. Read once, at mount. */
-    responses?: Readonly<Record<string, LearnerResponse>>;
-    /**
-     * Questions the learner had already submitted, from
-     * `AttemptState.submittedSlotIds`: mounted submitted, and counted as
-     * answered, so a resumed video neither reopens a committed answer nor stops
-     * again at a quiz already done. Read once, at mount.
-     */
-    submittedSlotIds?: readonly string[];
-    /** Stored outcomes, by slot id: review, and the grades of questions graded later. */
-    outcomes?: Readonly<Record<string, ItemOutcome>>;
-    onSubmit?: (response: LearnerResponse, slot: InteractiveVideoSlot) => void;
-    onActivityComplete?: (result: ActivityResult, slot: InteractiveVideoSlot) => void;
-    /**
-     * Once per mount: when the learner presses Finish, or the video ends with every
-     * question answered — either way, only once no answer is still on its way.
-     */
-    onFinished?: (summary: InteractiveVideoSummary) => void;
-    onInteraction?: (event: InteractionEvent) => void;
-    /**
-     * Draws a question yourself. Called for each question once its quiz has
-     * opened, and on every render after;
-     * return `undefined` for the SDK's own component, so a host can take over one
-     * activity type and leave the rest. `null` draws nothing, and is kept.
-     *
-     * The video still owns everything around the question: when it opens,
-     * whether it counts as answered, whether a required quiz lets the learner go
-     * on, pausing, resume and the end summary — all through the calls on
-     * {@link InteractiveVideoQuestion}. A question the host draws is never
-     * treated differently from one the SDK draws.
-     *
-     * THE HOST MUST STOP ITS MICROPHONE WHEN `active` TURNS `false`: the SDK stops
-     * only the recorders it created. And the SDK cannot keep a mode for pixels it
-     * does not draw: in `exam` reveal no correctness, and in `review` accept no
-     * answer.
-     *
-     * What you return is keyed by the question's slot and stays mounted for the
-     * life of the player, like the SDK's own questions, and sits inside the same
-     * error boundary: a throw degrades that one question, never the video.
-     */
-    renderQuestion?: (question: InteractiveVideoQuestion) => ReactNode | undefined;
-    /**
-     * Where read-aloud takes are stored and judged. Required for every read-aloud
-     * the SDK draws itself, outside review; a video whose read-alouds are all
-     * drawn by `renderQuestion` needs none.
-     */
-    recordingBinding?: SequenceRecordingBinding;
-    /** Speech assessments by slot id, so `review` shows the marks behind a read-aloud's grade. Read live. */
-    assessments?: Readonly<Record<string, SpeechAssessment>>;
-    /** A self-hosted copy of the read-aloud capture processor, for a strict Content-Security-Policy. */
-    workletUrl?: string;
-    /**
-     * Fetches a caption file with the host's credentials and returns its WebVTT
-     * text. Without it, the player fetches `src` itself — which a `<track>`
-     * could not do for a URL that needs an Authorization header.
-     */
-    captionsLoader?: (track: MediaTrack) => Promise<string>;
-    /**
-     * FORCES preferences: each field given here overrides what the learner chose,
-     * every time the video opens. For a starting point the learner can still
-     * change — a language pair, say — pass `defaultPreferences` instead. Read when
-     * the video opens; the learner's own changes after that hold.
-     */
-    preferences?: Partial<VideoPreferences>;
-    /**
-     * Preferences to start from, below what the learner chose in this browser:
-     * each field applies until the learner changes it. A host that keeps the
-     * learner's choice on their account passes it back here — on a new device
-     * nothing is stored, so the account's choice applies; on the same device the
-     * stored choice is that same choice. Read live: a value that arrives after
-     * the video opens still fills every field nobody chose.
-     */
-    defaultPreferences?: Partial<VideoPreferences>;
-    /**
-     * After each change the learner makes — a menu, a shortcut, the volume, the
-     * speed — with the preferences now in force and the fields that changed.
-     * Never when the video opens, and never for `preferences`. The player still
-     * remembers the change in this browser; this is for a host that keeps it on
-     * the learner's account as well.
-     */
-    onPreferencesChange?: (next: VideoPreferences, change: Partial<VideoPreferences>) => void;
-    /** A short label in the corner, such as a lesson code. */
-    label?: string;
-    /** Seed for the option order of multiple-choice and gap-select questions: the attempt id. */
-    shuffleSeed?: string;
-    locale?: string;
-    strings?: LkStringsOverride;
-    /**
-     * The host's AI ports, for every question the SDK draws: explanations after
-     * grading, hints before submit. The same as `LkAiProvider`, for this one
-     * video. Nothing AI appears in `exam`. See {@link LearnerAi}.
-     */
-    ai?: LearnerAi;
-    /**
-     * What a learner may see around the video's questions — feedback,
-     * solutions, hints, AI help — for every question in it, and on the end card:
-     * with `feedback: false` it counts answers and shows no score. Each setting
-     * only takes away. See `DeliveryPolicy` in lk-core.
-     */
-    delivery?: DeliveryPolicy | null;
-    /**
-     * How the video's questions are scored when a learner can try again or ask
-     * for hints — for every question in it. A later try replaces a question's
-     * grade, as any answer given again does, until the learner finishes: then
-     * every question's tries close. See `ItemScoringPolicy` in lk-core.
-     *
-     * A policy `validateItemScoringPolicy` refuses throws at render.
-     */
-    scoring?: ItemScoringPolicy | null;
-    theme?: Partial<ThemeTokens>;
-    sanitizeHtml?: HtmlSanitizer;
-}
-
-/** The two lines a learner can have: which track each shows, if any. */
-interface CaptionTracks {
-    primary?: MediaTrack;
-    secondary?: MediaTrack;
-}
-/**
- * Which track each caption line shows, from the learner's two choices.
- *
- * The primary line always shows something while there are tracks:
- * 1. the track in `captionLanguage` (case-insensitive);
- * 2. else one of the same primary language — `pt` finds `pt-BR`, `es` finds
- *    `es-419`;
- * 3. else the `default` track;
- * 4. else the first.
- *
- * Where two tracks share a language, the `captions` one wins.
- *
- * The secondary line is stricter: it appears only when `secondaryCaptionLanguage`
- * is set and matches a track in another language, by steps 1 and 2 alone —
- * never the default, never the first. A second line the learner did not choose
- * must never appear.
- */
-declare function resolveCaptionTracks(tracks: readonly MediaTrack[], preferences: Pick<VideoPreferences, 'captionLanguage' | 'secondaryCaptionLanguage'>): CaptionTracks;
-
-/**
- * Public interactive video: the player wrapped in `ActivityErrorBoundary`, so a
- * render failure — the development-time schema check among them — degrades to
- * an accessible fallback instead of taking the host page down.
- *
- * A formative tool, for lessons and practice — not for official summative
- * exams, which `<ActivitySequence>` delivers.
- */
-declare function InteractiveVideo(props: InteractiveVideoProps): react_jsx_runtime.JSX.Element;
-
-export { type CaptionTracks, InteractiveVideo, type InteractiveVideoProps, type InteractiveVideoQuestion, type InteractiveVideoSlot, type InteractiveVideoSummary, type RenderableItemGroup, VideoPreferences, resolveCaptionTracks };
+import { b as CaptionSize, x as VideoPreferences } from "../types-BOQd93x3.cjs";
+import { a as InteractiveVideoQuestion, c as RenderableItemGroup, i as InteractiveVideoProps, n as CaptionTracks, o as InteractiveVideoSlot, r as resolveCaptionTracks, s as InteractiveVideoSummary, t as InteractiveVideo } from "../index-B_SgnjsC.cjs";
+export { type CaptionSize, type CaptionTracks, InteractiveVideo, type InteractiveVideoProps, type InteractiveVideoQuestion, type InteractiveVideoSlot, type InteractiveVideoSummary, type RenderableItemGroup, type VideoPreferences, resolveCaptionTracks };