cognikit 0.1.0

package/dist/engines/text/implementation/graders.d.ts

@@ -0,0 +1,69 @@
+import { TextEngineBaseData, TextEngineBlanksData, TextEngineClassificationData } from "../../../types/Text";
+import { GradingResult, GradingState } from "../../../types/Grading";
+/**
+ * User data for base interactions (highlight, DND, transformation)
+ */
+export type TextEngineBaseUserData = {
+    selectedIndices?: number[];
+    placedIndices?: number[];
+    dndPlacements?: Record<number, string>;
+    transformations?: Record<number, string[]>;
+};
+/**
+ * User data for blanks interactions (fill-in-the-blanks)
+ */
+export type TextEngineBlanksUserData = {
+    inputValues: Record<string, any>;
+};
+/**
+ * User data for classification interactions
+ */
+export type TextEngineClassificationUserData = {
+    wordCategories: Record<number, string>;
+};
+export type TextEngineBaseGradingState = Record<number, GradingState>;
+export type TextEngineBlanksGradingState = Record<string, GradingState>;
+export type TextEngineClassificationGradingState = Record<number, GradingState>;
+/**
+ * Grade highlight interaction
+ * User must select all and only the target words
+ */
+export declare function textEngineHighlightGrader(data: TextEngineBaseData, userData: TextEngineBaseUserData): GradingResult;
+/**
+ * Grade DND (drag and drop) interaction
+ * User must place target words in correct positions
+ */
+export declare function textEngineDNDGrader(data: TextEngineBaseData, userData: TextEngineBaseUserData): GradingResult;
+export declare function getDNDGradingState(data: TextEngineBaseData, userData: TextEngineBaseUserData): TextEngineBaseGradingState;
+/**
+ * Grade transformation interaction
+ * User must transform target text correctly
+ * Comparison is case-insensitive and trimmed
+ */
+export declare function textEngineTransformationGrader(data: TextEngineBaseData, userData: TextEngineBaseUserData, expectedTransformations: Record<number, string[]>): GradingResult;
+/**
+ * Generate per-target grading state for transformation interaction
+ */
+export declare function getTransformationGradingState(data: TextEngineBaseData, userData: TextEngineBaseUserData, expectedTransformations: Record<number, string[]>): TextEngineBaseGradingState;
+/**
+ * Generate per-target grading state for highlight interaction
+ */
+export declare function getHighlightGradingState(data: TextEngineBaseData, userData: TextEngineBaseUserData): TextEngineBaseGradingState;
+/**
+ * Grade fill-in-the-blanks interaction
+ * Compares user input values against expected values for each input element
+ */
+export declare function textEngineBlanksGrader(data: TextEngineBlanksData, userData: TextEngineBlanksUserData): GradingResult;
+/**
+ * Generate per-input grading state for blanks interaction
+ */
+export declare function getBlanksGradingState(data: TextEngineBlanksData, userData: TextEngineBlanksUserData): TextEngineBlanksGradingState;
+/**
+ * Grade classification interaction
+ * User must assign each target word to the correct category
+ */
+export declare function textEngineClassificationGrader(data: TextEngineClassificationData, userData: TextEngineClassificationUserData): GradingResult;
+/**
+ * Generate per-word grading state for classification interaction
+ */
+export declare function getClassificationGradingState(data: TextEngineClassificationData, userData: TextEngineClassificationUserData): TextEngineClassificationGradingState;

package/dist/engines/text/implementation/index.d.ts

@@ -0,0 +1,3 @@
+export { textEngineBaseGrammarParser, textEngineBlanksGrammarParser, textEngineClassificationGrammarParser, parseTextEngineSequential } from './parsers';
+export { textEngineBaseDataValidator, textEngineBlanksDataValidator, textEngineClassificationDataValidator, textEngineDataValidator } from './validators';
+export { type TextEngineBaseUserData, type TextEngineBlanksUserData, type TextEngineClassificationUserData, type TextEngineBaseGradingState, type TextEngineBlanksGradingState, type TextEngineClassificationGradingState, textEngineHighlightGrader, textEngineDNDGrader, textEngineTransformationGrader, getHighlightGradingState, getDNDGradingState, getTransformationGradingState, textEngineBlanksGrader, getBlanksGradingState, textEngineClassificationGrader, getClassificationGradingState } from './graders';

package/dist/engines/text/implementation/parsers.d.ts

@@ -0,0 +1,9 @@
+import { TextEngineDataUnion, TextEngineModality, TextEngineBaseData, TextEngineBlanksData, TextEngineClassificationData, TextEngineSequentialInteractionData } from "../../../types/Text";
+import { GrammarParser, GrammarParseResult } from "../../../types/Global";
+export declare const textEngineBaseGrammarParser: GrammarParser<TextEngineBaseData>;
+export declare const textEngineBlanksGrammarParser: GrammarParser<TextEngineBlanksData>;
+export declare const textEngineClassificationGrammarParser: GrammarParser<TextEngineClassificationData>;
+/**
+ * Just a bulk caller to the guys who do the real job.
+ */
+export declare function parseTextEngineSequential<T extends TextEngineDataUnion>(code: string, modality: TextEngineModality): GrammarParseResult<TextEngineSequentialInteractionData>;

package/dist/engines/text/implementation/validators.d.ts

@@ -0,0 +1,41 @@
+import { TextEngineBaseData, TextEngineBlanksData, TextEngineClassificationData, TextEngineDataUnion } from "../../../types/Text";
+import { ValidationResult } from "../../../types/Global";
+/**
+ * Validates TextEngineBaseData for highlight/DND/transformation interactions
+ *
+ * Checks:
+ * - Parts array is not empty
+ * - Targets array is not empty
+ * - Each target has valid words, startPos, endPos
+ * - Target positions are within bounds of parts array
+ * - Target words match parts at specified positions
+ * - Distractors (if present) are non-empty and unique
+ */
+export declare function textEngineBaseDataValidator(data: TextEngineBaseData): ValidationResult;
+/**
+ * Validates TextEngineBlanksData for fill-in-the-blanks interactions
+ *
+ * Checks:
+ * - Parts array is not empty
+ * - Targets array is not empty
+ * - Each target has valid id and expectedValue
+ * - Expected values have proper structure (InputElementData)
+ * - No duplicate target IDs
+ */
+export declare function textEngineBlanksDataValidator(data: TextEngineBlanksData): ValidationResult;
+/**
+ * Validates TextEngineClassificationData
+ *
+ * Checks:
+ * - Parts array is not empty
+ * - Targets array is not empty (at least one category)
+ * - Each category target has valid category name and targets array
+ * - Category names are unique
+ * - Each category has at least one target
+ * - Target positions are valid and within bounds
+ */
+export declare function textEngineClassificationDataValidator(data: TextEngineClassificationData): ValidationResult;
+/**
+ * Unified validator that routes to the appropriate validator based on data type
+ */
+export declare function textEngineDataValidator(data: TextEngineDataUnion): ValidationResult;

package/dist/engines/text/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./implementation";
+export { EduText } from "./script";

package/dist/engines/text/script.d.ts

@@ -0,0 +1,56 @@
+import { TextEngineConfiguration, TextEngineState, TextEngineGradingState } from "../../types/Text";
+type EduTextElement = HTMLElement & {
+    config: TextEngineConfiguration;
+    getValue(): any;
+    getState(): TextEngineState;
+    setState(next: Partial<TextEngineState>): void;
+    reset(): void;
+    setGradingState(state: TextEngineGradingState): void;
+    clearGradingState(): void;
+};
+export declare class EduText extends HTMLElement implements EduTextElement {
+    private _config;
+    private _state;
+    private _mounted;
+    static get observedAttributes(): string[];
+    private $wrapEl;
+    constructor();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    set config(v: TextEngineConfiguration);
+    get config(): TextEngineConfiguration;
+    getValue(): any;
+    getState(): TextEngineState;
+    setState(next: Partial<TextEngineState>): void;
+    reset(): void;
+    setGradingState(state: TextEngineGradingState): void;
+    clearGradingState(): void;
+    attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
+    private upsertHtmlAttribute;
+    private removeHtmlAttribute;
+    private upsertHtmlClass;
+    private removeHtmlClassPrefix;
+    private initState;
+    private render;
+    private renderHighlight;
+    private renderBlanks;
+    private renderClassification;
+    private renderDND;
+    private renderTransformation;
+    private onClick;
+    private onChange;
+    private onInput;
+    private onDragStart;
+    private onDragOver;
+    private onDrop;
+    private _activeCategory;
+    private toggleWordSelection;
+    private setActiveCategory;
+    private assignWordToCategory;
+    private updateInputValue;
+    private updateTransformation;
+    private placeWordInDropzone;
+    private clearDropzone;
+    private emitChange;
+}
+export {};

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./core";
+export * from "./ui";
+export * from "./engines";
+export * from "./interactions";
+export * from "./shell";
+export * from "./shared";