@intellectif/lk-react 14.0.0 → 15.0.0

package/dist/{strings--ADnHcaA.d.cts → strings-5588Q4Te.d.cts}

@@ -1,6 +1,35 @@
 import { SpeechAssessment, GradeRecord, ReadAloudData, RecordingRef, LearnerResponse, ActivityData, ActivityResult, ItemOutcome, MediaPlayLedgerEntry, MediaPlayClaim, MediaPlayGrant, InteractionEvent, ThemeTokens, RedactedActivityData, ItemGroup, SequenceEntry, ReadAloudDimension, ReadAloudWordState, Stimulus } from '@intellectif/lk-core';
 import { R as RecordedTake, S as SpeechRecorderError } from './machine-CuwKqWXC.cjs';
 
+/** The size captions are drawn at. */
+type CaptionSize = 'small' | 'medium' | 'large';
+/** What the player remembers between videos, for one browser. */
+interface VideoPreferences {
+    /** One of the speed list. */
+    speed: number;
+    /** 0 to 1. */
+    volume: number;
+    muted: boolean;
+    /** Captions shown. */
+    captions: boolean;
+    /** The caption language chosen, as a track's `srclang`; null for the default track. */
+    captionLanguage: string | null;
+    captionSize: CaptionSize;
+    /** A dark box behind each caption line. Off draws the text with an outline only. */
+    captionBackground: boolean;
+    /** The contents and transcript panel is open. */
+    panel: boolean;
+    /** Single-key shortcuts act while the player has focus (WCAG 2.1.4 lets a learner turn them off). */
+    shortcuts: boolean;
+}
+
+/**
+ * One row of the shortcut list. The list and the key handler read the same
+ * table, so a shortcut can never be documented and not work, or work and not
+ * be documented.
+ */
+type VideoShortcutAction = 'play-pause' | 'jump-10' | 'jump-5' | 'jump-1' | 'frame' | 'speed' | 'percent' | 'start-end' | 'chapter' | 'mute' | 'captions' | 'transcript' | 'picture-in-picture' | 'fullscreen' | 'shortcut-list';
+
 /**
  * What an application's assessor came back with.
  *
@@ -61,6 +90,15 @@ interface ReadAloudProps extends ActivityProps<ReadAloudData> {
     breakThreshold?: number;
     /** The same, for the monotone note. */
     monotoneThreshold?: number;
+    /**
+     * The URL of a self-hosted copy of `CAPTURE_PROCESSOR_SOURCE`, handed to the
+     * recorder, for a Content-Security-Policy whose `script-src` does not allow
+     * `blob:`. Without it the capture module is loaded from a `blob:` URL, and a
+     * policy that refuses one sends every take through the deprecated
+     * main-thread `ScriptProcessorNode` — a take that still records, so nothing
+     * says so. See `useSpeechRecorder`'s option of the same name.
+     */
+    workletUrl?: string;
     /**
      * Never called. A read-aloud answer is a key in your storage, and there is
      * none until the take has been uploaded — so there is no intermediate
@@ -589,6 +627,13 @@ interface LkStrings {
     readAloudRerecord: string;
     /** Accessible name of the player for the take the learner just made. */
     readAloudYourRecording: string;
+    /**
+     * In place of the player for the learner's own take, and of the buttons that
+     * play one word of it, when the page refuses to play it — most often a
+     * Content-Security-Policy whose `media-src` does not allow `blob:`. Said
+     * rather than left as controls that do nothing when pressed.
+     */
+    readAloudPlaybackUnavailable: string;
     /**
      * Live progress while recording. Whole seconds, not a `m:ss` clock: a
      * recording is bounded in seconds by the item, and a translation should not
@@ -670,6 +715,78 @@ interface LkStrings {
     pronunciationMonotone: string;
     /** Names the alphabet the phoneme symbols are written in. */
     pronunciationIpaNote: string;
+    /** Jump buttons, e.g. "Back 10 seconds". */
+    videoBack: (seconds: number) => string;
+    videoForward: (seconds: number) => string;
+    /** The centre button once the video has ended. */
+    videoReplay: string;
+    /** The time readout flips between elapsed and remaining; these name what a press shows next. */
+    videoShowRemaining: string;
+    videoShowElapsed: string;
+    /** The captions button, named by what a press does. */
+    videoCaptionsShow: string;
+    videoCaptionsHide: string;
+    /** In the captions menu when a caption file could not be read. */
+    videoCaptionsFailed: string;
+    /** A speed in the speed menu, e.g. "1.25×". */
+    videoSpeedValue: (rate: number) => string;
+    videoSettings: string;
+    videoCaptionLanguage: string;
+    videoCaptionSize: string;
+    videoCaptionSizeValue: (size: CaptionSize) => string;
+    videoCaptionBackground: string;
+    videoKeyboardShortcuts: string;
+    videoShortcutList: string;
+    /** Closes the shortcut list. */
+    videoClose: string;
+    /** A setting's state in the settings menu. */
+    videoOn: string;
+    videoOff: string;
+    /** What each row of the shortcut list does. */
+    videoShortcut: (action: VideoShortcutAction) => string;
+    /** The button that opens the panel below the video, and its two tabs. */
+    videoPanel: string;
+    videoContents: string;
+    videoTranscript: string;
+    videoTranscriptSearch: string;
+    videoTranscriptNoMatch: string;
+    videoPictureInPicture: string;
+    videoFullscreen: string;
+    videoExitFullscreen: string;
+    /**
+     * Why the video will not play, by `MediaError.code` (1 aborted, 2 network,
+     * 3 decode, 4 source), with 0 for anything else.
+     */
+    videoError: (code: number) => string;
+    videoTryAgain: string;
+    /** A quiz with no title of its own. */
+    videoQuiz: string;
+    /** Where the learner is inside a quiz, e.g. "Question 2 of 5". */
+    videoQuestionProgress: (index: number, total: number) => string;
+    /** A step of the quiz's step indicator, for assistive technology. */
+    videoQuestionStep: (index: number, answered: boolean) => string;
+    videoNextQuestion: string;
+    videoContinue: string;
+    videoSkipQuiz: string;
+    videoRewatch: string;
+    /** Exam mode, once a question is submitted: saved, not graded. */
+    videoAnswerSaved: string;
+    videoRequired: string;
+    /** A quiz's progress in the contents panel and on the end screen. */
+    videoQuizProgress: (answered: number, total: number) => string;
+    /** Announced when a quiz opens. */
+    videoQuizOpened: (time: string, questions: number) => string;
+    /** Announced when a seek stopped at a required quiz. */
+    videoHeldAtQuiz: (time: string) => string;
+    /** Announced when a seek stopped at the furthest point reached. */
+    videoHeldAhead: string;
+    videoEnded: string;
+    /** Practice end screen: questions answered, and the score. */
+    videoEndScore: (answered: number, total: number, percent: number) => string;
+    /** Exam end screen: questions answered, no score. */
+    videoEndAnswered: (answered: number, total: number) => string;
+    videoWatchAgain: string;
+    videoFinish: string;
     /**
      * `<ActivityPreview>`, in place of a draft that still has something missing.
      * Author-facing, not learner-facing — but an editor is translated too.
@@ -728,4 +845,4 @@ declare const DEFAULT_STRINGS: LkStrings;
  */
 declare function mergeStrings(base: LkStrings, override?: LkStringsOverride): LkStrings;
 
-export { type ActivityProps as A, DEFAULT_STRINGS as D, type HtmlSanitizer as H, type LkStrings as L, type MediaBudgetBinding as M, type ReadAloudAssessResult as R, type SequenceMediaBudget as S, type LkStringsOverride as a, type MediaTransportStrings as b, type ReadAloudProps as c, type RecordingBinding as d, type RenderMode as e, type Renderable as f, type RenderableActivity as g, type SequenceRecordingBinding as h, type SequenceRecordingSlot as i, asRenderable as j, asRenderableSequence as k, mergeStrings as m };
+export { type ActivityProps as A, type CaptionSize as C, DEFAULT_STRINGS as D, type HtmlSanitizer as H, type LkStrings as L, type MediaBudgetBinding as M, type ReadAloudAssessResult as R, type SequenceMediaBudget as S, type VideoPreferences as V, type LkStringsOverride as a, type MediaTransportStrings as b, type ReadAloudProps as c, type RecordingBinding as d, type RenderMode as e, type Renderable as f, type RenderableActivity as g, type SequenceRecordingBinding as h, type SequenceRecordingSlot as i, asRenderable as j, asRenderableSequence as k, mergeStrings as m };

package/dist/{strings-CtdSf2St.d.ts → strings-D0IWcsUm.d.ts}

@@ -1,6 +1,35 @@
 import { SpeechAssessment, GradeRecord, ReadAloudData, RecordingRef, LearnerResponse, ActivityData, ActivityResult, ItemOutcome, MediaPlayLedgerEntry, MediaPlayClaim, MediaPlayGrant, InteractionEvent, ThemeTokens, RedactedActivityData, ItemGroup, SequenceEntry, ReadAloudDimension, ReadAloudWordState, Stimulus } from '@intellectif/lk-core';
 import { R as RecordedTake, S as SpeechRecorderError } from './machine-CuwKqWXC.js';
 
+/** The size captions are drawn at. */
+type CaptionSize = 'small' | 'medium' | 'large';
+/** What the player remembers between videos, for one browser. */
+interface VideoPreferences {
+    /** One of the speed list. */
+    speed: number;
+    /** 0 to 1. */
+    volume: number;
+    muted: boolean;
+    /** Captions shown. */
+    captions: boolean;
+    /** The caption language chosen, as a track's `srclang`; null for the default track. */
+    captionLanguage: string | null;
+    captionSize: CaptionSize;
+    /** A dark box behind each caption line. Off draws the text with an outline only. */
+    captionBackground: boolean;
+    /** The contents and transcript panel is open. */
+    panel: boolean;
+    /** Single-key shortcuts act while the player has focus (WCAG 2.1.4 lets a learner turn them off). */
+    shortcuts: boolean;
+}
+
+/**
+ * One row of the shortcut list. The list and the key handler read the same
+ * table, so a shortcut can never be documented and not work, or work and not
+ * be documented.
+ */
+type VideoShortcutAction = 'play-pause' | 'jump-10' | 'jump-5' | 'jump-1' | 'frame' | 'speed' | 'percent' | 'start-end' | 'chapter' | 'mute' | 'captions' | 'transcript' | 'picture-in-picture' | 'fullscreen' | 'shortcut-list';
+
 /**
  * What an application's assessor came back with.
  *
@@ -61,6 +90,15 @@ interface ReadAloudProps extends ActivityProps<ReadAloudData> {
     breakThreshold?: number;
     /** The same, for the monotone note. */
     monotoneThreshold?: number;
+    /**
+     * The URL of a self-hosted copy of `CAPTURE_PROCESSOR_SOURCE`, handed to the
+     * recorder, for a Content-Security-Policy whose `script-src` does not allow
+     * `blob:`. Without it the capture module is loaded from a `blob:` URL, and a
+     * policy that refuses one sends every take through the deprecated
+     * main-thread `ScriptProcessorNode` — a take that still records, so nothing
+     * says so. See `useSpeechRecorder`'s option of the same name.
+     */
+    workletUrl?: string;
     /**
      * Never called. A read-aloud answer is a key in your storage, and there is
      * none until the take has been uploaded — so there is no intermediate
@@ -589,6 +627,13 @@ interface LkStrings {
     readAloudRerecord: string;
     /** Accessible name of the player for the take the learner just made. */
     readAloudYourRecording: string;
+    /**
+     * In place of the player for the learner's own take, and of the buttons that
+     * play one word of it, when the page refuses to play it — most often a
+     * Content-Security-Policy whose `media-src` does not allow `blob:`. Said
+     * rather than left as controls that do nothing when pressed.
+     */
+    readAloudPlaybackUnavailable: string;
     /**
      * Live progress while recording. Whole seconds, not a `m:ss` clock: a
      * recording is bounded in seconds by the item, and a translation should not
@@ -670,6 +715,78 @@ interface LkStrings {
     pronunciationMonotone: string;
     /** Names the alphabet the phoneme symbols are written in. */
     pronunciationIpaNote: string;
+    /** Jump buttons, e.g. "Back 10 seconds". */
+    videoBack: (seconds: number) => string;
+    videoForward: (seconds: number) => string;
+    /** The centre button once the video has ended. */
+    videoReplay: string;
+    /** The time readout flips between elapsed and remaining; these name what a press shows next. */
+    videoShowRemaining: string;
+    videoShowElapsed: string;
+    /** The captions button, named by what a press does. */
+    videoCaptionsShow: string;
+    videoCaptionsHide: string;
+    /** In the captions menu when a caption file could not be read. */
+    videoCaptionsFailed: string;
+    /** A speed in the speed menu, e.g. "1.25×". */
+    videoSpeedValue: (rate: number) => string;
+    videoSettings: string;
+    videoCaptionLanguage: string;
+    videoCaptionSize: string;
+    videoCaptionSizeValue: (size: CaptionSize) => string;
+    videoCaptionBackground: string;
+    videoKeyboardShortcuts: string;
+    videoShortcutList: string;
+    /** Closes the shortcut list. */
+    videoClose: string;
+    /** A setting's state in the settings menu. */
+    videoOn: string;
+    videoOff: string;
+    /** What each row of the shortcut list does. */
+    videoShortcut: (action: VideoShortcutAction) => string;
+    /** The button that opens the panel below the video, and its two tabs. */
+    videoPanel: string;
+    videoContents: string;
+    videoTranscript: string;
+    videoTranscriptSearch: string;
+    videoTranscriptNoMatch: string;
+    videoPictureInPicture: string;
+    videoFullscreen: string;
+    videoExitFullscreen: string;
+    /**
+     * Why the video will not play, by `MediaError.code` (1 aborted, 2 network,
+     * 3 decode, 4 source), with 0 for anything else.
+     */
+    videoError: (code: number) => string;
+    videoTryAgain: string;
+    /** A quiz with no title of its own. */
+    videoQuiz: string;
+    /** Where the learner is inside a quiz, e.g. "Question 2 of 5". */
+    videoQuestionProgress: (index: number, total: number) => string;
+    /** A step of the quiz's step indicator, for assistive technology. */
+    videoQuestionStep: (index: number, answered: boolean) => string;
+    videoNextQuestion: string;
+    videoContinue: string;
+    videoSkipQuiz: string;
+    videoRewatch: string;
+    /** Exam mode, once a question is submitted: saved, not graded. */
+    videoAnswerSaved: string;
+    videoRequired: string;
+    /** A quiz's progress in the contents panel and on the end screen. */
+    videoQuizProgress: (answered: number, total: number) => string;
+    /** Announced when a quiz opens. */
+    videoQuizOpened: (time: string, questions: number) => string;
+    /** Announced when a seek stopped at a required quiz. */
+    videoHeldAtQuiz: (time: string) => string;
+    /** Announced when a seek stopped at the furthest point reached. */
+    videoHeldAhead: string;
+    videoEnded: string;
+    /** Practice end screen: questions answered, and the score. */
+    videoEndScore: (answered: number, total: number, percent: number) => string;
+    /** Exam end screen: questions answered, no score. */
+    videoEndAnswered: (answered: number, total: number) => string;
+    videoWatchAgain: string;
+    videoFinish: string;
     /**
      * `<ActivityPreview>`, in place of a draft that still has something missing.
      * Author-facing, not learner-facing — but an editor is translated too.
@@ -728,4 +845,4 @@ declare const DEFAULT_STRINGS: LkStrings;
  */
 declare function mergeStrings(base: LkStrings, override?: LkStringsOverride): LkStrings;
 
-export { type ActivityProps as A, DEFAULT_STRINGS as D, type HtmlSanitizer as H, type LkStrings as L, type MediaBudgetBinding as M, type ReadAloudAssessResult as R, type SequenceMediaBudget as S, type LkStringsOverride as a, type MediaTransportStrings as b, type ReadAloudProps as c, type RecordingBinding as d, type RenderMode as e, type Renderable as f, type RenderableActivity as g, type SequenceRecordingBinding as h, type SequenceRecordingSlot as i, asRenderable as j, asRenderableSequence as k, mergeStrings as m };
+export { type ActivityProps as A, type CaptionSize as C, DEFAULT_STRINGS as D, type HtmlSanitizer as H, type LkStrings as L, type MediaBudgetBinding as M, type ReadAloudAssessResult as R, type SequenceMediaBudget as S, type VideoPreferences as V, type LkStringsOverride as a, type MediaTransportStrings as b, type ReadAloudProps as c, type RecordingBinding as d, type RenderMode as e, type Renderable as f, type RenderableActivity as g, type SequenceRecordingBinding as h, type SequenceRecordingSlot as i, asRenderable as j, asRenderableSequence as k, mergeStrings as m };

package/dist/theme/ThemeProvider.cjs

@@ -1,29 +1,29 @@
 'use client';
 'use strict';
 
-var chunkD4DQFTA7_cjs = require('../chunk-D4DQFTA7.cjs');
+var chunkUCKA22ZJ_cjs = require('../chunk-UCKA22ZJ.cjs');
 
 
 
 Object.defineProperty(exports, "ThemeProvider", {
   enumerable: true,
-  get: function () { return chunkD4DQFTA7_cjs.ThemeProvider; }
+  get: function () { return chunkUCKA22ZJ_cjs.ThemeProvider; }
 });
 Object.defineProperty(exports, "createTailwindTheme", {
   enumerable: true,
-  get: function () { return chunkD4DQFTA7_cjs.createTailwindTheme; }
+  get: function () { return chunkUCKA22ZJ_cjs.createTailwindTheme; }
 });
 Object.defineProperty(exports, "darkTheme", {
   enumerable: true,
-  get: function () { return chunkD4DQFTA7_cjs.darkTheme; }
+  get: function () { return chunkUCKA22ZJ_cjs.darkTheme; }
 });
 Object.defineProperty(exports, "defaultTheme", {
   enumerable: true,
-  get: function () { return chunkD4DQFTA7_cjs.defaultTheme; }
+  get: function () { return chunkUCKA22ZJ_cjs.defaultTheme; }
 });
 Object.defineProperty(exports, "useTheme", {
   enumerable: true,
-  get: function () { return chunkD4DQFTA7_cjs.useTheme; }
+  get: function () { return chunkUCKA22ZJ_cjs.useTheme; }
 });
 //# sourceMappingURL=ThemeProvider.cjs.map
 //# sourceMappingURL=ThemeProvider.cjs.map

package/dist/theme/ThemeProvider.js

@@ -1,4 +1,4 @@
 'use client';
-export { ThemeProvider, createTailwindTheme, darkTheme, defaultTheme, useTheme } from '../chunk-RXS455MR.js';
+export { ThemeProvider, createTailwindTheme, darkTheme, defaultTheme, useTheme } from '../chunk-EVBYEWHO.js';
 //# sourceMappingURL=ThemeProvider.js.map
 //# sourceMappingURL=ThemeProvider.js.map

package/dist/theme/defaults.css

@@ -22,6 +22,8 @@
   --lk-color-error: #b91c1c;
   --lk-color-warning: #b45309;
   --lk-color-focus-ring: #18181b;
+  /* A video player's accent, drawn on its always-dark chrome. */
+  --lk-color-media-accent: #ffffff;
 
   /* Spacing */
   --lk-spacing-xs: 4px;