@dataclouder/ngx-lessons 0.0.33 → 0.0.34

package/lib/components/dc-lessons/dc-lesson-editor/dc-lesson-editor.component.d.ts

@@ -38,13 +38,6 @@ export declare class DCLessonEditorComponent {
      * @param result The configuration data returned from the component builder dialog. Expected format: { obj: LessonComponentConfiguration }
      */
     onComponentAdded(result: ComponentBuildData): void;
-    generateByAI(): Promise<void>;
-    /**
-     * Replaces encoded JSON blocks (~...~) in HTML with their 'settings.text' value.
-     * @param htmlInput The HTML string containing encoded JSON.
-     * @returns The processed HTML string with text replacements.
-     */
-    private _extractTextFromEncodedJson;
     /**
      * Handles the image upload event, updates the lesson signal via the service, and saves.
      * @param event The image upload event data.

package/lib/components/dc-lessons/dc-lesson-metadata-editor/dc-lesson-metadata-editor.component.d.ts

@@ -2,12 +2,12 @@ import { EventEmitter, WritableSignal } from '@angular/core';
 import { ILesson } from '../../lesson-mini-components/components/lessons.clases';
 import * as i0 from "@angular/core";
 export declare class DCLessonMetadataEditorComponent {
+    #private;
     lesson: WritableSignal<ILesson | undefined>;
     isLoadingLesson: WritableSignal<boolean>;
     saveRequest: EventEmitter<void>;
     importNotionRequest: EventEmitter<void>;
     improveNotionRequest: EventEmitter<void>;
-    generateAIRequest: EventEmitter<void>;
     propertyChange: EventEmitter<{
         property: keyof ILesson;
         value: any;
@@ -16,7 +16,23 @@ export declare class DCLessonMetadataEditorComponent {
     emitSaveRequest(): void;
     emitImportNotionRequest(): void;
     emitImproveNotionRequest(): void;
-    emitGenerateAIRequest(): void;
+    /**
+     * Generates lesson content using AI, saving the current state first.
+     * Moved from DCLessonEditorComponent.
+     */
+    generateByAI(): Promise<void>;
+    /**
+     * Replaces encoded JSON blocks (~...~) in HTML with their 'settings.text' value.
+     * Moved from DCLessonEditorComponent.
+     * @param htmlInput The HTML string containing encoded JSON.
+     * @returns The processed HTML string with text replacements.
+     */
+    private _extractTextFromEncodedJson;
+    /**
+     * Calls the LessonUtilsService to generate a description using AI
+     * and updates the lesson signal if successful.
+     */
+    triggerGenerateDescriptionAI(): Promise<void>;
     static ɵfac: i0.ɵɵFactoryDeclaration<DCLessonMetadataEditorComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DCLessonMetadataEditorComponent, "dc-lesson-metadata-editor", never, { "lesson": { "alias": "lesson"; "required": true; }; "isLoadingLesson": { "alias": "isLoadingLesson"; "required": true; }; }, { "saveRequest": "saveRequest"; "importNotionRequest": "importNotionRequest"; "improveNotionRequest": "improveNotionRequest"; "generateAIRequest": "generateAIRequest"; "propertyChange": "propertyChange"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DCLessonMetadataEditorComponent, "dc-lesson-metadata-editor", never, { "lesson": { "alias": "lesson"; "required": true; }; "isLoadingLesson": { "alias": "isLoadingLesson"; "required": true; }; }, { "saveRequest": "saveRequest"; "importNotionRequest": "importNotionRequest"; "improveNotionRequest": "improveNotionRequest"; "propertyChange": "propertyChange"; }, never, never, true, never>;
 }

package/lib/components/dc-lessons/dc-lesson-renderer/dc-lesson-renderer.component.d.ts

@@ -1,7 +1,7 @@
 import { ElementRef } from '@angular/core';
 import { FormGroup, FormControl } from '@angular/forms';
 import { ILesson } from '../../lesson-mini-components/components/lessons.clases';
-import { IAgentCard, IConversationSettings, IMiniAgentCard } from '@dataclouder/ngx-agent-cards';
+import { IAgentCard, IConversationSettings, IMiniAgentCard, SimpleAgentTask } from '@dataclouder/ngx-agent-cards';
 import * as i0 from "@angular/core";
 export declare class DCLessonRendererComponent {
     lessonInput: import("@angular/core").InputSignal<ILesson>;
@@ -13,11 +13,13 @@ export declare class DCLessonRendererComponent {
     private readonly toastrService;
     private readonly lessonService;
     private readonly lessonAIService;
+    private readonly userDataExchange;
     lesson: import("@angular/core").WritableSignal<ILesson>;
     chatVisible: import("@angular/core").WritableSignal<boolean>;
     agentMasterLesson: import("@angular/core").WritableSignal<IAgentCard>;
     evaluatorAgentCard: import("@angular/core").WritableSignal<IMiniAgentCard>;
     conversationSettings: import("@angular/core").WritableSignal<IConversationSettings>;
+    evalAgentTask: import("@angular/core").WritableSignal<SimpleAgentTask>;
     imageCover: import("@angular/core").Signal<string>;
     private components;
     mainForm: FormGroup<{
@@ -34,6 +36,8 @@ export declare class DCLessonRendererComponent {
     private _createComponentReferenceWithJson;
     evaluateForms(): Promise<void>;
     startAI(): Promise<void>;
+    onVisibleChange(isVisible: boolean): void;
+    handleGoalCompleted(event: any): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<DCLessonRendererComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DCLessonRendererComponent, "dc-lesson-renderer", never, { "lessonInput": { "alias": "lessonInput"; "required": false; "isSignal": true; }; "lessonIdInput": { "alias": "lessonIdInput"; "required": false; "isSignal": true; }; "test": { "alias": "test"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }

package/lib/components/dc-lessons/dc-lesson-renderer/eval-agents-skills.d.ts

@@ -0,0 +1 @@
+export declare const EnglishEvaluationSkill = "\nYou are a virtual professor for the Polilan English learning app. Your primary role is to evaluate a student's English conversational performance.\n\nYou will be provided with two pieces of information for each evaluation:\n1.  **The student's English level:** This will be one of \"Beginner\", \"Intermediate\", or \"Advanced\".\n2.  **A conversation transcript:** This will be the dialogue between the Student and an Assistant, with each turn clearly labeled (e.g., \"Student or User: ...\", \"Assistant: ...\").\n\nYour sole task is to evaluate the *Student's* contribution to the conversation. **Do NOT evaluate the Assistant's turns.**\n\nEvaluate the student's performance based on the following aspects, *always keeping the student's provided level in mind*  and adjusting your expectations accordingly specially with beginners give them credits just for trying:\n\n*   **Grammar & Syntax:** Evaluate accuracy and complexity *relative to the expected level*. (Beginners: focus on basic accuracy; Advanced: expect complex structures with high accuracy).\n*   **Vocabulary & Usage:** Evaluate the range and appropriateness of words used *relative to the expected level*. (Beginners: focus on using basic words correctly; Advanced: expect varied and idiomatic language).\n*   **Cohesion & Coherence:** Evaluate how well their turns connect and make sense within the conversation *relative to the expected level*. (Beginners: focus on simple, clear responses; Advanced: expect logical flow and detailed contributions).\n*   **Task Completion/Relevance:** Evaluate how effectively they participate and respond to the conversation's goals or topics *relative to the expected level*.\n\nAssign a rating from 0 to 3 based on how well the student performs *compared to the typical expectations for their provided level*:\n\n*   **0: Bad** - Performance is significantly below what is expected for this level. Many errors impede communication.\n*   **1: Not Bad** - Performance is below expectations for this level, but communication is sometimes possible despite frequent errors.\n*   **2: Good** - Performance meets expectations for this level, demonstrating solid understanding and usage with only occasional minor errors.\n*   **3: Very Good** - Performance exceeds expectations for this level, demonstrating a strong command and potential to progress quickly.\n\nProvide detailed, constructive feedback that explains the rating. Point out specific strengths and areas for improvement based on their performance *at their given level*. Use examples from the dialog if helpful. Maintain a supportive, encouraging, and educational tone appropriate for a virtual professor guiding a student at their specific stage.\n";

package/lib/components/lesson-mini-components/components/lessons.clases.d.ts

@@ -113,6 +113,13 @@ export interface ILesson {
 export interface ILessonWithTaken extends ILesson {
     taken: any;
 }
+export interface ILessonTaken {
+    id: string;
+    score: number;
+    goalCompleted: boolean;
+    status: string;
+    lastAccess: Date;
+}
 export declare abstract class LessonsAbstractService {
     abstract getLessons(paginator?: any): Promise<any>;
     abstract getLesson(id: string): Promise<any>;
@@ -123,6 +130,7 @@ export declare abstract class LessonsAbstractService {
     abstract postGenerateByAI(id: string): Promise<any>;
     abstract extractTextFromHtml(html: string): string;
     abstract postImproveMDWithAI(lessonId: string, markdownText: string): Promise<any>;
+    abstract saveTakenLesson(lesson: ILessonTaken): Promise<any>;
 }
 export declare function provideLessonsService(serviceImplementation: Type<LessonsAbstractService>): Provider[];
 export declare const LangCodeDescription: {

package/lib/services/default-lessons.service.d.ts

@@ -0,0 +1,18 @@
+import { ILesson, ILessonTaken, LessonsAbstractService } from '../components/lesson-mini-components/components/lessons.clases';
+import * as i0 from "@angular/core";
+export declare class DefaultLessonsService implements LessonsAbstractService {
+    saveTakenLesson(lesson: ILessonTaken): Promise<any>;
+    private httpCoreService;
+    private endpoints;
+    getLessons(paginator?: any): Promise<any>;
+    getLesson(id: string): Promise<any>;
+    postLesson(lesson: ILesson): Promise<any>;
+    updateLesson(lesson: ILesson): Promise<any>;
+    deleteLesson(id: string): Promise<any>;
+    generateLesson(lesson: ILesson): Promise<any>;
+    postGenerateByAI(id: string): Promise<any>;
+    postImproveMDWithAI(lessonId: string, markdownText: string): Promise<any>;
+    extractTextFromHtml(html: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DefaultLessonsService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DefaultLessonsService>;
+}

package/lib/services/lesson-utils.service.d.ts

@@ -26,11 +26,23 @@ export declare class LessonUtilsService {
     /**
      * Improves the provided Markdown text using AI and updates the lesson.
      * Assumes the lesson is already saved before calling this.
-     * @param lessonId The ID of the lesson to update.
+     * @param lesson The lesson object containing the prompt and other context.
      * @param markdownText The Markdown text generated from the lesson's HTML content.
-     * @returns The updated lesson object after AI improvement, or null on failure.
+     * @returns The improved Markdown string, or null on failure.
      */
     improveMDWithAI(lesson: ILesson, markdownText: string): Promise<string | null>;
+    /**
+     * Generates a concise description for the lesson using AI based on its content.
+     * @param lesson The lesson object containing the content.
+     * @returns A promise resolving to the generated description string, or null on failure.
+     */
+    generateDescriptionWithAI(lesson: ILesson): Promise<string | null>;
+    /**
+     * Extracts plain text from an HTML string, removing encoded JSON components.
+     * @param htmlInput The HTML string potentially containing encoded JSON (~...~).
+     * @returns The plain text representation.
+     */
+    private _extractTextFromHtml;
     /**
      * Cleans orphaned components from the lesson's dynamicComponents.
      * An orphaned component is one present in dynamicComponents but its ID is not found in the textCoded HTML.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dataclouder/ngx-lessons",
-  "version": "0.0.33",
+  "version": "0.0.34",
   "peerDependencies": {
     "@angular/common": ">=18.0.0",
     "@angular/core": ">=18.0.0",

package/public-api.d.ts

@@ -5,6 +5,7 @@ export * from './lib/components/dc-lessons/lesson-list/dc-lesson-list.component'
 export * from './lib/components/dc-lessons/lesson-form/lesson-form.component';
 export * from './lib/components/dc-lessons/dc-lesson-editor/dc-lesson-editor.component';
 export * from './lib/components/dc-lessons/dc-lesson-card/dc-lesson-card.component';
+export * from './lib/services/default-lessons.service';
 export * from './lib/components/dc-lessons/dc-lesson-renderer/dc-lesson-renderer.component';
 export * from './lib/components/lesson-mini-components/components/ComponentWithForm';
 export * from './lib/components/lesson-mini-components/components/lesson-dynamic.component';