@kbss-cvut/s-forms 0.8.1-alpha-c77e08d.0 → 0.8.1-alpha-03fa327.0

package/dist/components/Answer.d.ts

@@ -8,6 +8,8 @@ declare namespace Answer {
         let onCommentChange: PropTypes.Validator<(...args: any[]) => any>;
         let index: PropTypes.Requireable<number>;
         let icons: PropTypes.Requireable<object>;
+        let hintRevealed: PropTypes.Requireable<boolean>;
+        let onHintReveal: PropTypes.Requireable<(...args: any[]) => any>;
     }
 }
 import PropTypes from "prop-types";

package/dist/components/HintIcon.d.ts

@@ -0,0 +1,24 @@
+export default HintIcon;
+declare function HintIcon(props: any): import("react/jsx-runtime").JSX.Element;
+declare namespace HintIcon {
+    namespace propTypes {
+        let text: PropTypes.Requireable<string>;
+        let iconClassContainer: PropTypes.Requireable<string>;
+        let iconClass: PropTypes.Requireable<string>;
+        let overlayPlacement: PropTypes.Requireable<string>;
+        let absolutePosition: PropTypes.Requireable<boolean>;
+        let onHintClick: PropTypes.Requireable<(...args: any[]) => any>;
+        let revealed: PropTypes.Requireable<boolean>;
+    }
+    namespace defaultProps {
+        let iconClassContainer_1: string;
+        export { iconClassContainer_1 as iconClassContainer };
+        let iconClass_1: string;
+        export { iconClass_1 as iconClass };
+        let absolutePosition_1: boolean;
+        export { absolutePosition_1 as absolutePosition };
+        let revealed_1: boolean;
+        export { revealed_1 as revealed };
+    }
+}
+import PropTypes from "prop-types";

package/dist/components/MediaContent.d.ts

@@ -1,5 +1,6 @@
 interface Props {
     question: object;
+    displayAnnotations?: boolean;
 }
-declare const MediaContent: ({ question }: Props) => import("react/jsx-runtime").JSX.Element | null;
+declare const MediaContent: ({ question, displayAnnotations }: Props) => import("react/jsx-runtime").JSX.Element;
 export default MediaContent;

package/dist/components/Question.d.ts

@@ -8,9 +8,11 @@ declare class Question extends React.Component<any, any, any> {
         validator: {};
         expanded: boolean;
         showIcon: boolean;
+        hintRevealed: boolean;
     };
     componentDidMount(): void;
     componentDidUpdate(): null | undefined;
+    handleHintReveal: (state: any) => void;
     handleAnswerChange: (answerIndex: any, change: any) => void;
     handleSubQuestionChange: (subQuestionIndex: any, change: any) => void;
     handleCommentChange: (commentIndex: any, change: any) => void;

package/dist/components/QuestionStatic.d.ts

@@ -1,9 +1,10 @@
 export default class QuestionStatic {
-    static renderIcons(question: any, options: any, onCommentChange: any, showIcon: any, intl: any): import("react/jsx-runtime").JSX.Element;
+    static renderIcons(question: any, options: any, onCommentChange: any, showIcon: any, intl: any, hintRevealed: any, onHintReveal: any): import("react/jsx-runtime").JSX.Element;
     static renderQuestionHelp(question: any, options: any, onCommentChange: any, showIcon: any, intl: any): import("react/jsx-runtime").JSX.Element | null | undefined;
     static renderQuestionComments: (question: any, options: any, onCommentChange: any, showIcon: any, intl: any) => import("react/jsx-runtime").JSX.Element | null | undefined;
     static renderQuestionLink(question: any, options: any, onCommentChange: any, showIcon: any, intl: any): import("react/jsx-runtime").JSX.Element | null | undefined;
-    static getIconComponentFromName(iconName: any, question: any, options: any, onCommentChange: any, showIcon: any, intl: any): import("react/jsx-runtime").JSX.Element | null | undefined;
+    static renderQuestionHint(question: any, options: any, onCommentChange: any, showIcon: any, intl: any, hintRevealed: any, onHintReveal: any): import("react/jsx-runtime").JSX.Element | null | undefined;
+    static getIconComponentFromName(iconName: any, question: any, options: any, onCommentChange: any, showIcon: any, intl: any, hintRevealed: any, onHintReveal: any): import("react/jsx-runtime").JSX.Element | null | undefined;
     static getIconFromIconList: (iconList: any, iconName: any) => any;
-    static getIconComponent(icon: any, question: any, options: any, onCommentChange: any, showIcon: any, intl: any): import("react/jsx-runtime").JSX.Element | null | undefined;
+    static getIconComponent(icon: any, question: any, options: any, onCommentChange: any, showIcon: any, intl: any, hintRevealed: any, onHintReveal: any): import("react/jsx-runtime").JSX.Element | null | undefined;
 }

package/dist/components/answer/select/SelectAnswer.d.ts

@@ -0,0 +1,15 @@
+export default SelectAnswer;
+declare function SelectAnswer(props: any): import("react/jsx-runtime").JSX.Element;
+declare namespace SelectAnswer {
+    namespace propTypes {
+        let question: PropTypes.Validator<object>;
+        let label: PropTypes.Validator<object>;
+        let title: PropTypes.Requireable<string>;
+        let value: PropTypes.Requireable<string>;
+        let onChange: PropTypes.Validator<(...args: any[]) => any>;
+        let validation: PropTypes.Requireable<object>;
+        let hintRevealed: PropTypes.Requireable<boolean>;
+        let onRevealHint: PropTypes.Requireable<(...args: any[]) => any>;
+    }
+}
+import PropTypes from "prop-types";

package/dist/components/answer/select/SelectDefault.d.ts

@@ -0,0 +1,29 @@
+export default SelectDefault;
+declare function SelectDefault({ question, label, title, value, validation, onChange, }: {
+    question: any;
+    label: any;
+    title: any;
+    value: any;
+    validation: any;
+    onChange: any;
+}): React.DetailedReactHTMLElement<{
+    type: string;
+    label: any;
+    value: any;
+    title: any;
+    validation: any;
+    onChange: (e: any) => any;
+    disabled: any;
+}, HTMLElement>;
+declare namespace SelectDefault {
+    namespace propTypes {
+        let question: PropTypes.Validator<object>;
+        let label: PropTypes.Validator<object>;
+        let title: PropTypes.Requireable<string>;
+        let value: PropTypes.Requireable<string>;
+        let onChange: PropTypes.Validator<(...args: any[]) => any>;
+        let validation: PropTypes.Requireable<object>;
+    }
+}
+import React from "react";
+import PropTypes from "prop-types";

package/dist/components/answer/select/SelectFeedbackBadge.d.ts

@@ -0,0 +1,11 @@
+export default SelectFeedbackBadge;
+declare function SelectFeedbackBadge({ status }: {
+    status: any;
+}): import("react/jsx-runtime").JSX.Element | null;
+declare namespace SelectFeedbackBadge {
+    let displayName: string;
+    namespace propTypes {
+        let status: PropTypes.Requireable<string | null>;
+    }
+}
+import PropTypes from "prop-types";

package/dist/components/answer/select/SelectWithFeedback.d.ts

@@ -0,0 +1,22 @@
+export default SelectWithFeedback;
+declare function SelectWithFeedback({ question, label, title, value, validation, onChange, hintRevealed, }: {
+    question: any;
+    label: any;
+    title: any;
+    value: any;
+    validation: any;
+    onChange: any;
+    hintRevealed: any;
+}): import("react/jsx-runtime").JSX.Element;
+declare namespace SelectWithFeedback {
+    namespace propTypes {
+        let question: PropTypes.Validator<object>;
+        let label: PropTypes.Validator<object>;
+        let title: PropTypes.Requireable<string>;
+        let value: PropTypes.Requireable<string>;
+        let onChange: PropTypes.Validator<(...args: any[]) => any>;
+        let validation: PropTypes.Requireable<object>;
+        let hintRevealed: PropTypes.Requireable<boolean>;
+    }
+}
+import PropTypes from "prop-types";

package/dist/components/answer/select/select.feedback.d.ts

@@ -0,0 +1,2 @@
+export function applySelectFeedback(selectEl: any, isCorrect: any): void;
+export function evaluateSelectAnswer(answerValue: any, correctValue: any): "correct" | "incorrect" | null;

package/dist/components/answer/select/select.utils.d.ts

@@ -0,0 +1,3 @@
+export function findOptionById(options: any[] | undefined, id: any): any;
+export function resolveOptionLabel(options: any[] | undefined, id: any): any;
+export function generateSelectOptions(options: any, placeholder?: string): import("react/jsx-runtime").JSX.Element[];

package/dist/components/answer/{TypeaheadAnswer.d.ts → typehead/TypeaheadAnswer.d.ts}

@@ -5,10 +5,10 @@ declare namespace TypeaheadAnswer {
         let question: PropTypes.Validator<object>;
         let answer: PropTypes.Validator<object>;
         let label: PropTypes.Validator<NonNullable<NonNullable<string | object | null | undefined>>>;
-        let title: PropTypes.Requireable<string>;
         let value: PropTypes.Requireable<string>;
         let onChange: PropTypes.Validator<(...args: any[]) => any>;
         let validation: PropTypes.Requireable<object>;
+        let hintRevealed: PropTypes.Requireable<boolean>;
     }
 }
 import PropTypes from "prop-types";

package/dist/components/answer/typehead/TypeaheadWithFeedback.d.ts

@@ -0,0 +1,14 @@
+export default TypeaheadWithFeedback;
+declare function TypeaheadWithFeedback(props: any): import("react/jsx-runtime").JSX.Element;
+declare namespace TypeaheadWithFeedback {
+    namespace propTypes {
+        let question: PropTypes.Validator<object>;
+        let answer: PropTypes.Validator<object>;
+        let label: PropTypes.Validator<NonNullable<NonNullable<string | object | null | undefined>>>;
+        let value: PropTypes.Requireable<string>;
+        let onChange: PropTypes.Validator<(...args: any[]) => any>;
+        let validation: PropTypes.Requireable<object>;
+        let hintRevealed: PropTypes.Validator<boolean>;
+    }
+}
+import PropTypes from "prop-types";

package/dist/components/answer/typehead/TypeheadDefault.d.ts

@@ -0,0 +1,2 @@
+export default TypeaheadDefault;
+declare function TypeaheadDefault(props: any): import("react/jsx-runtime").JSX.Element;

package/dist/components/answer/typehead/typeahead.renderers.d.ts

@@ -0,0 +1,9 @@
+export function buildControlStyle(validation: any, feedback: any): {
+    control: (provided: any) => any;
+};
+export function createOptionRenderer({ hintRevealed, correctValue, currentValue }: {
+    hintRevealed: any;
+    correctValue: any;
+    currentValue: any;
+}): (optionProps: any) => import("react/jsx-runtime").JSX.Element;
+export function valueRendererWithFeedback(feedback: any, children: any): import("react/jsx-runtime").JSX.Element;

package/dist/components/answer/typehead/typeahead.utils.d.ts

@@ -0,0 +1,2 @@
+export function buildOptionsTree(possibleValues: any, intl: any): any[];
+export function evaluateAnswer(answerLabel: any, question: any): "correct" | "incorrect" | null;

package/dist/components/media/MediaAssetViewer.d.ts

@@ -0,0 +1,11 @@
+export default MediaAssetViewer;
+/**
+ * Orchestrates the rendering of media assets based on their type and manages fullscreen state.
+ * Defaults to an iframe viewer for unsupported types.
+ */
+declare function MediaAssetViewer({ src, annotations, allowFullScreen, showAnnotations, }: {
+    src: any;
+    annotations?: any[] | undefined;
+    allowFullScreen: any;
+    showAnnotations?: boolean | undefined;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/media/MediaFullScreenContainer.d.ts

@@ -0,0 +1,6 @@
+export default MediaFullScreenContainer;
+/**
+ * Fullscreen-capable container for media elements.
+ */
+declare const MediaFullScreenContainer: React.ForwardRefExoticComponent<React.RefAttributes<any>>;
+import React from "react";

package/dist/components/media/annotation/AnnotationOverlay.d.ts

@@ -0,0 +1,7 @@
+export default AnnotationOverlay;
+declare function AnnotationOverlay({ annotations, surface, currentTime, showAnnotations, }: {
+    annotations?: any[] | undefined;
+    surface: any;
+    currentTime: any;
+    showAnnotations: any;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/media/annotation/AnnotationRenderer.d.ts

@@ -0,0 +1,23 @@
+export default AnnotationRenderer;
+/**
+ * Renders time-based visual annotations as an SVG overlay on top of a media asset.
+ *
+ * The component is purely presentational and does not manage interaction or state.
+ * It filters annotations by playback time, denormalizes geometry into viewport
+ * pixel space, and delegates rendering to annotation-specific components.
+ *
+ * @component
+ *
+ * @param {number} mediaAssetViewportWidth - Width of the media asset viewport in pixels.
+ * @param {number} mediaAssetViewportHeight - Height of the media asset viewport in pixels.
+ * @param {Array<Object>} annotations - List of annotations using normalized coordinates (0–1).
+ * @param {number|null} playerCurrentTime - Current playback time in seconds; if null, all annotations are rendered.
+ *
+ * @returns {JSX.Element} SVG overlay containing rendered annotations.
+ *
+ * @remarks
+ * - Accepts annotations defined in a normalized coordinate system (0–1)
+ * - Default styles are resolved via Constants to ensure consistency
+ * - Supports polyline and text annotation types
+ */
+declare function AnnotationRenderer({ mediaAssetViewportWidth, mediaAssetViewportHeight, annotations, playerCurrentTime, }: number): JSX.Element;

package/dist/components/media/annotation/PolylineAnnotation.d.ts

@@ -0,0 +1,13 @@
+export default PolylineAnnotation;
+/**
+ * Stateless SVG component responsible for rendering a single polyline annotation.
+ * Receives fully resolved geometry and styling from the parent renderer and
+ * performs no normalization, transformation, or time-based logic.
+ */
+declare function PolylineAnnotation({ points, stroke, strokeWidth, fill, opacity }: {
+    points: any;
+    stroke: any;
+    strokeWidth: any;
+    fill: any;
+    opacity: any;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/media/annotation/TextAnnotation.d.ts

@@ -0,0 +1,17 @@
+export default TextAnnotation;
+/**
+ * Stateless SVG component responsible for rendering a single text annotation.
+ * Receives fully resolved position, styling, and content from the parent renderer.
+ * This component performs no normalization, scaling, or time-based logic.
+ */
+declare function TextAnnotation({ text, fontFamily, fontWeight, opacity, fontSize, x, y, color, lineHeight, }: {
+    text: any;
+    fontFamily?: string | undefined;
+    fontWeight?: number | undefined;
+    opacity?: number | undefined;
+    fontSize: any;
+    x: any;
+    y: any;
+    color?: string | undefined;
+    lineHeight?: number | undefined;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/media/annotation/engine/annotationVisibility.d.ts

@@ -0,0 +1 @@
+export function isAnnotationVisible(annotation: any, currentTime: any): boolean;

package/dist/components/media/annotation/engine/buildRenderModel.d.ts

@@ -0,0 +1 @@
+export function buildRenderModel(annotation: any, width: any, height: any): any;

package/dist/components/media/annotation/engine/useAnnotationsEngine.d.ts

@@ -0,0 +1,6 @@
+export function useAnnotationsEngine({ annotations, width, height, currentTime, }: {
+    annotations?: any[] | undefined;
+    width: any;
+    height: any;
+    currentTime: any;
+}): any[];

package/dist/components/media/hooks/useFullscreen.d.ts

@@ -0,0 +1,4 @@
+export function useFullscreen(ref: any): {
+    isFullscreen: boolean;
+    toggle: () => void;
+};

package/dist/components/media/hooks/useMediaSurface.d.ts

@@ -0,0 +1,4 @@
+export function useMediaSurface({ type, containerRef }: {
+    type: any;
+    containerRef: any;
+}): null;

package/dist/components/media/image/ImageOverlay.d.ts

@@ -0,0 +1,21 @@
+export default ImageOverlay;
+/**
+ * Displays an image in a full-screen modal overlay and renders annotations on top of it.
+ *
+ * The component is responsible only for layout and sizing. Annotation filtering,
+ * geometry handling, and rendering are delegated to AnnotationRenderer.
+ *
+ * @component
+ *
+ * @param {Object} props
+ * @param {string} props.src - Source URL of the image to display.
+ * @param {Array<Object>} props.annotations - List of annotations associated with the image.
+ * @param {Function} props.onClose - Callback invoked when the overlay is dismissed.
+ *
+ * @returns {JSX.Element} Full-screen image overlay with annotations.
+ */
+declare function ImageOverlay({ src, annotations, onClose }: {
+    src: string;
+    annotations: Array<Object>;
+    onClose: Function;
+}): JSX.Element;

package/dist/components/media/image/ImageViewer.d.ts

@@ -0,0 +1,10 @@
+export default ImageViewer;
+/**
+ * Viewer for displaying images with annotations.
+ */
+declare function ImageViewer({ src, annotations, onFullScreen, showAnnotations }: {
+    src: any;
+    annotations: any;
+    onFullScreen: any;
+    showAnnotations: any;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/media/video/VideoJS.d.ts

@@ -0,0 +1,37 @@
+export default VideoJS;
+/**
+ * VideoJS
+ *
+ * React wrapper component for initializing and managing a Video.js player
+ * instance.
+ *
+ * @component
+ *
+ * @param {Object} props
+ * @param {string} props.type - MIME type of the video source (e.g. "application/x-mpegURL").
+ * @param {string} props.src - Source URL of the video stream.
+ * @param {boolean} [props.autoplay=false] - Whether playback should start automatically.
+ * @param {boolean} [props.muted=true] - Whether the video should start muted.
+ * @param {boolean} [props.controls=true] - Whether player controls should be visible.
+ * @param {boolean} [props.allowFullScreen=false] - Enables custom fullscreen handling.
+ * @param {boolean} [props.responsive=true] - Enables responsive resizing.
+ * @param {string} [props.aspectRatio="16:9"] - Aspect ratio used for fluid layout.
+ * @param {Function} [props.onReady] - Callback invoked when the player is ready.
+ * @param {Function} [props.onFullScreen] - Optional callback for custom fullscreen handling.
+ *
+ * @returns {JSX.Element} Video.js player container.
+ *
+ * @see https://videojs.org/guides/react/
+ */
+declare function VideoJS({ type, src, autoplay, muted, controls, allowFullScreen, responsive, aspectRatio, onReady, onFullScreen, }: {
+    type: string;
+    src: string;
+    autoplay?: boolean | undefined;
+    muted?: boolean | undefined;
+    controls?: boolean | undefined;
+    allowFullScreen?: boolean | undefined;
+    responsive?: boolean | undefined;
+    aspectRatio?: string | undefined;
+    onReady?: Function | undefined;
+    onFullScreen?: Function | undefined;
+}): JSX.Element;

package/dist/components/media/video/VideoViewer.d.ts

@@ -0,0 +1,16 @@
+export default VideoViewer;
+/**
+ * Viewer for displaying video with annotations.
+ */
+declare function VideoViewer({ type, src, autoplay, muted, controls, responsive, aspectRatio, annotations, showAnnotations, onFullScreen, }: {
+    type: any;
+    src: any;
+    autoplay?: boolean | undefined;
+    muted?: boolean | undefined;
+    controls?: boolean | undefined;
+    responsive?: boolean | undefined;
+    aspectRatio?: string | undefined;
+    annotations?: any[] | undefined;
+    showAnnotations: any;
+    onFullScreen: any;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/media/video/enhancePlayer.d.ts

@@ -0,0 +1,2 @@
+export default enhancePlayer;
+declare function enhancePlayer(player: any, options: any): void;

package/dist/components/media/video/hooks/enhancePlayer.d.ts

@@ -0,0 +1,2 @@
+export default enhancePlayer;
+declare function enhancePlayer(player: any, options: any): void;

package/dist/components/media/video/hooks/useVideoPlayer.d.ts

@@ -0,0 +1,9 @@
+export function useVideoPlayer({ videoRef, options, onReady, onFullScreen, onTimeUpdate, showAnnotations, annotations, }: {
+    videoRef: any;
+    options: any;
+    onReady: any;
+    onFullScreen: any;
+    onTimeUpdate: any;
+    showAnnotations: any;
+    annotations?: any[] | undefined;
+}): import("react").MutableRefObject<null>;

package/dist/constants/Constants.d.ts

@@ -75,6 +75,7 @@ export default class Constants {
     static HAS_TESTED_FORM: string;
     static HAS_UNIT: string;
     static HAS_VALID_ANSWER: string;
+    static HAS_CORRECT_ANSWER: string;
     static IS_RELEVANT_IF: string;
     static ACCEPTS_VALIDATION_VALUE: string;
     static HAS_VALIDATION_MESSAGE: string;
@@ -86,6 +87,9 @@ export default class Constants {
     static HAS_PRECEDING_QUESTION: string;
     static HAS_PRECEDING_VALUE: string;
     static HAS_MEDIA_CONTENT: string;
+    static ASSET: string;
+    static HAS_SOURCE: string;
+    static HAS_ANNOTATION: string;
     static CONDITION: string;
     static OR_CONDITION: string;
     static HAS_SUB_CONDITION: string;
@@ -114,6 +118,7 @@ export default class Constants {
         QUESTION_COMMENTS: string;
         QUESTION_HELP: string;
         QUESTION_LINK: string;
+        QUESTION_HINT: string;
     };
     static ICON_BEHAVIOR: {
         ENABLE: string;
@@ -125,6 +130,41 @@ export default class Constants {
             id: string;
             behavior: string;
         }[];
+        enableOptionQuestionFeedback: boolean;
+    };
+    static ANNOTATION: {
+        HAS_ANNOTATION_TYPE: string;
+        HAS_START_TIME: string;
+        HAS_END_TIME: string;
+        HAS_GEOMETRY_POINTS: string;
+        HAS_OPACITY: string;
+        HAS_COLOR: string;
+    };
+    static POLYLINE_ANNOTATION: {
+        IMPLICIT_TYPE_LABEL: string;
+        HAS_STROKE_WIDTH: string;
+        HAS_FILL_COLOR: string;
+        DEFAULT_POLYLINE_ANNOTATION_STYLE: {
+            color: string;
+            strokeWidth: number;
+            fillColor: string;
+            opacity: number;
+        };
+    };
+    static TEXT_ANNOTATION: {
+        IMPLICIT_TYPE_LABEL: string;
+        HAS_FONT_SIZE: string;
+        HAS_FONT_WEIGHT: string;
+        HAS_TEXT: string;
+        DEFAULT_TEXT_ANNOTATION_STYLE: {
+            text: string;
+            color: string;
+            fontSizeInNormalizedPx: number;
+            fontWeight: string;
+            fontFamily: string;
+            fontColor: string;
+            opacity: number;
+        };
     };
     static LANG: {
         cs: {