@things-factory/learning 0.0.0-stage → 10.1.261

package/package.json

@@ -1,6 +1,59 @@
 {
   "name": "@things-factory/learning",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "10.1.261",
+  "main": "dist-server/index.js",
+  "browser": "dist-client/index.js",
+  "things-factory": true,
+  "license": "MIT",
+  "author": "heartyoh <heartyoh@hatiolab.com>",
+  "description": "Learning management - courses and their versions, units and questions, enrolments with the time the server counts, quizzes scored by the server, completions with their evidence and certificates (ADR-0194)",
+  "publishConfig": {
+    "access": "public",
+    "@things-factory:registry": "https://registry.npmjs.org"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hatiolab/things-factory.git",
+    "directory": "packages/learning"
+  },
+  "scripts": {
+    "build": "npm run build:server && npm run build:client",
+    "copy:files": "copyfiles -e \"./client/**/*.{ts,js,json}\" -u 1 \"./client/**/*\" dist-client",
+    "build:client": "npm run clean:client && npm run copy:files && npx tsc --p ./client/tsconfig.json",
+    "build:server": "npm run clean:server && npx tsc --p ./server/tsconfig.json",
+    "clean:server": "rm -rf dist-server",
+    "clean:client": "rm -rf dist-client",
+    "clean": "npm run clean:server && npm run clean:client",
+    "test": "npm run build:server && node --test test/*.test.mjs"
+  },
+  "dependencies": {
+    "@material/web": "^2.0.0",
+    "@operato/data-grist": "^10.29.69",
+    "@operato/graphql": "^10.29.69",
+    "@operato/i18n": "^10.0.0",
+    "@operato/input": "^10.29.52",
+    "@operato/layout": "^10.29.49",
+    "@operato/learning": "^10.29.72",
+    "@operato/list-state": "^10.29.39",
+    "@operato/popup": "^10.29.39",
+    "@operato/shell": "^10.29.69",
+    "@operato/styles": "^10.29.1",
+    "@operato/utils": "^10.0.0",
+    "@things-factory/ai-assistant": "^10.1.261",
+    "@things-factory/ai-client-base": "^10.1.261",
+    "@things-factory/announcement": "^10.1.261",
+    "@things-factory/attachment-base": "^10.1.261",
+    "@things-factory/auth-base": "^10.1.261",
+    "@things-factory/env": "^10.1.149",
+    "@things-factory/i18n-base": "^10.1.261",
+    "@things-factory/notification": "^10.1.261",
+    "@things-factory/organization": "^10.1.261",
+    "@things-factory/pdf": "^10.1.261",
+    "@things-factory/shell": "^10.1.261",
+    "@things-factory/worklist": "^10.1.261",
+    "graphql-tag": "^2.12.6",
+    "graphql-upload": "^15.0.2",
+    "lit": "^3.1.2"
+  },
+  "gitHead": "06537757f8708e6a511c6232e8792f18fdd6a986"
+}

package/things-factory.config.js

@@ -0,0 +1,14 @@
+import bootstrap from './dist-client/bootstrap.js'
+import route from './dist-client/route.js'
+
+export default {
+  bootstrap,
+  route,
+  routes: [
+    { tagname: 'my-learning', page: 'my-learning' },
+    { tagname: 'learning-view', page: 'learning-view' },
+    { tagname: 'learning-course-list', page: 'learning-course-list' },
+    { tagname: 'learning-course-editor', page: 'learning-course-editor' },
+    { tagname: 'learning-enrollment-status', page: 'learning-enrollment-status' }
+  ]
+}

package/translations/en.json

@@ -0,0 +1,278 @@
+{
+  "activity.learning-course.guide.0": "It is handed out when a course is assigned - a mandatory training session, onboarding or a manager assigning it.",
+  "activity.learning-course.guide.1": "It opens the course; completing the course ends it.",
+  "activity.learning-course.guide.2": "A to-do past its due date is reminded as every overdue to-do is.",
+  "activity.learning-course.label": "Course learning",
+  "button.learning-acknowledge": "Confirm",
+  "button.learning-assign": "Assign course",
+  "button.learning-cancel-enrollment": "Cancel enrolment",
+  "button.learning-certificate": "Issue certificate",
+  "button.learning-choice-add": "Add choice",
+  "button.learning-choice-remove": "Remove choice",
+  "button.learning-continue": "Continue",
+  "button.learning-course-edit": "Edit course",
+  "button.learning-course-new": "Add course",
+  "button.learning-delete": "Delete",
+  "button.learning-edit": "Edit",
+  "button.learning-move-down": "Move down",
+  "button.learning-move-up": "Move up",
+  "button.learning-open-course": "Open course",
+  "button.learning-question-add": "Add question",
+  "button.learning-quiz-start": "Start quiz",
+  "button.learning-register-pdf": "Issue completion register",
+  "button.learning-remind": "Send completion reminder",
+  "button.learning-review": "Review",
+  "button.learning-start": "Start",
+  "button.learning-unit-add": "Add unit",
+  "button.learning-version-close": "Close version",
+  "button.learning-version-delete": "Delete draft",
+  "button.learning-version-new": "New version",
+  "button.learning-version-publish": "Publish",
+  "error.learning-attempt-limit-invalid": "Enter a whole-number attempt limit of 1 or more.",
+  "error.learning-attempt-sent": "Answers have already been submitted for this attempt.",
+  "error.learning-attempts-used": "All {limit} attempts are used.",
+  "error.learning-audience-invalid": "{target} is not of this domain.",
+  "error.learning-audience-required": "Select who takes the course.",
+  "error.learning-cancel-reason-required": "Enter the reason for cancelling.",
+  "error.learning-content-what": "Specify an enrollment or course version.",
+  "error.learning-course-name-required": "Enter the course name.",
+  "error.learning-course-name-taken": "A course named “{name}” exists.",
+  "error.learning-course-not-published": "A course with no published version cannot be assigned. Publish a version first.",
+  "error.learning-draft-exists": "The course has a draft. Edit it instead.",
+  "error.learning-due-invalid": "Enter the due date in YYYY-MM-DD format.",
+  "error.learning-enrollment-cancelled": "The enrolment is cancelled.",
+  "error.learning-enrollment-completed": "The course is already completed.",
+  "error.learning-enrollment-moved": "The enrolment changed meanwhile. Reload and try again.",
+  "error.learning-learner-unknown": "A learner must be a user of this domain.",
+  "error.learning-link-not-counted": "A link is not counted.",
+  "error.learning-manager-unknown": "The manager must be a user of this domain.",
+  "error.learning-min-time-invalid": "Enter a whole-number minimum learning time of zero or more.",
+  "error.learning-no-acknowledgement": "The course asks for no acknowledgement.",
+  "error.learning-no-quiz": "The course has no quiz.",
+  "error.learning-not-a-department-head": "Only a department head can view where their people stand.",
+  "error.learning-not-completed": "A certificate is issued only for a completed course.",
+  "error.learning-not-found": "The record was not found. Reload and try again.",
+  "error.learning-page-ahead": "You can turn only to the page after the last one read (page {allowed}). Turn the pages in order.",
+  "error.learning-pass-score-invalid": "The pass score is a whole number from 1 to 100.",
+  "error.learning-position-ahead": "You cannot skip beyond the watched position ({allowed} seconds). Continue playing from that position.",
+  "error.learning-question-answer-required": "Mark at least one correct choice.",
+  "error.learning-question-choices-required": "Enter at least two choices. True-or-false questions require exactly two.",
+  "error.learning-question-count-invalid": "Enter a whole-number question count of 1 or more.",
+  "error.learning-question-count-too-many": "The number of questions per attempt exceeds the number of registered questions.",
+  "error.learning-question-draft-invalid": "Each draft question must include question text, at least two choices and a correct answer.",
+  "error.learning-question-kind-invalid": "Select the question type.",
+  "error.learning-question-one-answer": "Select exactly one correct answer for this question type.",
+  "error.learning-question-text-required": "Enter the question.",
+  "error.learning-questions-drafted": "Some questions are AI drafts not reviewed yet. Review and save them before publishing.",
+  "error.learning-questions-required": "A course with a pass score needs at least one question.",
+  "error.learning-quiz-in-progress": "AI guidance on course content is unavailable during a quiz attempt. Submit your answers before asking again.",
+  "error.learning-source-required": "Specify the work item or assignment that requested this enrollment.",
+  "error.learning-unit-body-required": "Enter the text.",
+  "error.learning-unit-duration-invalid": "The video length is not valid.",
+  "error.learning-unit-duration-required": "A video's length is unknown. Attach its file again.",
+  "error.learning-unit-file-not-taken": "Files can only be attached to video or PDF units.",
+  "error.learning-unit-file-required": "A video or a PDF unit has no file.",
+  "error.learning-unit-kind-invalid": "Select the unit type.",
+  "error.learning-unit-min-time-invalid": "Enter a whole-number minimum learning time of at least 1 second.",
+  "error.learning-unit-name-required": "Enter the unit name.",
+  "error.learning-unit-pages-invalid": "The PDF's page count is not valid.",
+  "error.learning-unit-pages-required": "A PDF's page count is unknown. Attach its file again.",
+  "error.learning-unit-url-invalid": "Enter a link starting with http:// or https://.",
+  "error.learning-units-required": "Add at least one unit before publishing.",
+  "error.learning-version-not-draft": "A published or closed version cannot be changed. Start a new version to change it.",
+  "error.learning-version-not-found": "The version was not found.",
+  "error.learning-version-not-published": "Only the published version can be closed.",
+  "field.learning-acknowledgement": "Acknowledgement",
+  "field.learning-assign-audience": "Learners",
+  "field.learning-attempt-limit": "Attempts allowed",
+  "field.learning-cancel-reason": "Reason for cancelling",
+  "field.learning-certificate-no": "Certificate no.",
+  "field.learning-completed-on": "Completed on",
+  "field.learning-course-category": "Category",
+  "field.learning-course-description": "Description",
+  "field.learning-course-manager": "Manager",
+  "field.learning-course-name": "Course",
+  "field.learning-days-left": "Days left",
+  "field.learning-department": "Department",
+  "field.learning-due-on": "Due",
+  "field.learning-learner": "Learner",
+  "field.learning-min-minutes": "Minimum learning time (min)",
+  "field.learning-minutes": "Learning time (min)",
+  "field.learning-pass-score": "Pass score",
+  "field.learning-published-version": "Published version",
+  "field.learning-question-choices": "Choices and answers",
+  "field.learning-question-count": "Questions per attempt",
+  "field.learning-question-explanation": "Explanation",
+  "field.learning-question-kind": "Question type",
+  "field.learning-question-text": "Question",
+  "field.learning-score": "Score",
+  "field.learning-source-kind": "Source of material",
+  "field.learning-source-note": "Provider and terms of use",
+  "field.learning-state": "Status",
+  "field.learning-unit-body": "Text (markdown)",
+  "field.learning-unit-kind": "Unit type",
+  "field.learning-unit-min-seconds": "Minimum time (s)",
+  "field.learning-unit-name": "Unit name",
+  "field.learning-unit-pdf": "PDF file",
+  "field.learning-unit-url": "Link address",
+  "field.learning-unit-video": "Video file",
+  "field.learning-units-done": "Completed units",
+  "field.learning-updated-at": "Updated",
+  "issued-document.learning.certificate": "Certificate",
+  "issued-document.learning.completion-register": "Completion register",
+  "label.learning-choice-correct": "Mark choice {number} as correct",
+  "label.learning-choice-text": "Choice {number}",
+  "label.learning-units": "Units",
+  "label.learning-units-done": "Completed units",
+  "task.learning.managing.description": "Manage courses, versions, units and quiz questions, and assign learners. View enrollment progress and issue completion registers.",
+  "task.learning.managing.name": "Managing courses",
+  "task.learning.taking.description": "Study assigned courses, take quizzes and obtain certificates for completed courses. Department heads can view the completion status of employees in their departments.",
+  "task.learning.taking.name": "Taking courses",
+  "text.learning-acknowledge-label": "I confirm that I have read and understood the above.",
+  "text.learning-acknowledged-on": "Confirmed on {day}.",
+  "text.learning-acknowledgement-hint": "Learners must confirm this text before completing the course. Leave it blank to omit this step.",
+  "text.learning-assign-audience-hint": "Assign the course and create tasks for users currently included in the selected audience. Users already taking this course through an assignment made on this screen are not assigned again.",
+  "text.learning-assigned": "{count} enrolments are assigned.",
+  "text.learning-attempt-limit-hint": "Leave empty for no limit.",
+  "text.learning-attempts-left": "{count} attempts left.",
+  "text.learning-best-score": "Best score: {score}.",
+  "text.learning-cancelled": "The enrolment is cancelled.",
+  "text.learning-category-job": "Job training",
+  "text.learning-category-mandatory": "Mandatory training",
+  "text.learning-category-onboarding": "Onboarding",
+  "text.learning-category-other": "Other",
+  "text.learning-category-product": "Product training",
+  "text.learning-category-rules": "Company rules",
+  "text.learning-choice-count": "{count} choices",
+  "text.learning-completed-detail": "Completed on {day}. Certificate no. {number}.",
+  "text.learning-completed-on": "Completed {day}",
+  "text.learning-course-all": "All courses",
+  "text.learning-due-on": "Due {day}",
+  "text.learning-due-on-hint": "Leave empty to assign without a due date.",
+  "text.learning-learned-minutes": "{minutes} min learned / {required} min required",
+  "text.learning-learners-take": "Learners take version {number}.",
+  "text.learning-link-not-counted": "Time and progress on external sites do not count toward course completion. Use these links as reference material.",
+  "text.learning-managed-by": "Manager: {name}",
+  "text.learning-min-minutes-hint": "The total learning time across all units must meet this minimum. Time is counted while the screen is visible and, for videos, while playback is active.",
+  "text.learning-missing-acknowledgement": "acknowledgement",
+  "text.learning-missing-lead": "Complete the following requirements:",
+  "text.learning-missing-quiz": "passing the quiz",
+  "text.learning-missing-time": "the minimum learning time",
+  "text.learning-missing-units": "every unit",
+  "text.learning-no-course": "There are no courses.",
+  "text.learning-no-course-description": "Select Add course to register a course.",
+  "text.learning-no-enrollment": "No enrollments match the selected conditions.",
+  "text.learning-no-question": "There are no questions.",
+  "text.learning-no-unit": "There are no units.",
+  "text.learning-no-version": "There is no version yet. Start one with “New version”.",
+  "text.learning-not-published": "Not published",
+  "text.learning-nothing-to-take": "No courses are assigned to you.",
+  "text.learning-pass-score-hint": "Out of 100. Leave empty for no quiz.",
+  "text.learning-pick-one": "Select one enrolment.",
+  "text.learning-pick-open": "Select enrollments that have not been completed.",
+  "text.learning-question-count-hint": "Each attempt draws this many questions at random. Leave empty to draw them all.",
+  "text.learning-question-delete-confirm": "Delete this question?",
+  "text.learning-question-drafted": "AI draft · review needed",
+  "text.learning-question-multiple": "Multiple-answer multiple choice",
+  "text.learning-question-multiple-hint": "Mark every correct choice.",
+  "text.learning-question-single": "Single-answer multiple choice",
+  "text.learning-question-single-hint": "Mark the one correct choice.",
+  "text.learning-question-true-false": "True or false",
+  "text.learning-quiz-failed": "You scored {score}, below the pass score.",
+  "text.learning-quiz-off": "No pass score is set. A quiz is not required for completion.",
+  "text.learning-quiz-on": "A score of {pass} or more passes.",
+  "text.learning-quiz-passed": "You passed with {score}.",
+  "text.learning-quiz-rule": "The quiz has {count} questions. A score of {pass} or higher is required to pass.",
+  "text.learning-register-name": "Completion register - {course}",
+  "text.learning-remind-action": "Open the course",
+  "text.learning-remind-body": "Please complete the course “{course}” by {dueOn}.",
+  "text.learning-remind-body-no-due": "Please complete “{course}”.",
+  "text.learning-remind-note": "Sent by the course manager.",
+  "text.learning-remind-subject": "[Course] {course}",
+  "text.learning-reminded": "{count} learners were reminded.",
+  "text.learning-saved-at": "Last saved {time}",
+  "text.learning-source-note-hint": "Record the material provider and usage terms, such as attribution or restrictions on modification.",
+  "text.learning-source-own": "Produced in-house",
+  "text.learning-source-public": "Public body",
+  "text.learning-source-purchased": "Purchased",
+  "text.learning-state-all": "All statuses",
+  "text.learning-state-assigned": "Not started",
+  "text.learning-state-cancelled": "Cancelled",
+  "text.learning-state-completed": "Completed",
+  "text.learning-state-in-progress": "In progress",
+  "text.learning-state-overdue": "Overdue",
+  "text.learning-todo-headline": "To be completed by {dueOn}.",
+  "text.learning-todo-headline-no-due": "Please complete the course.",
+  "text.learning-todo-name": "Take {course}",
+  "text.learning-unit-delete-confirm": "Delete the unit “{name}”? Its file is deleted with it.",
+  "text.learning-unit-done": "done",
+  "text.learning-unit-duration": "{minutes} min {seconds} s long",
+  "text.learning-unit-file-kept": "Current file: {name}",
+  "text.learning-unit-file-none": "No file",
+  "text.learning-unit-link": "Link",
+  "text.learning-unit-link-hint": "Time and progress on external sites do not count toward course completion.",
+  "text.learning-unit-markdown": "Text",
+  "text.learning-unit-markdown-hint": "Keep the text open and visible for the minimum learning time to complete this unit.",
+  "text.learning-unit-min-seconds": "Minimum reading time: {seconds} s",
+  "text.learning-unit-min-seconds-hint": "Leave blank to use a minimum reading time of 60 seconds.",
+  "text.learning-unit-pages": "{pages} pages",
+  "text.learning-unit-pdf": "Document (PDF)",
+  "text.learning-unit-pdf-hint": "The unit is done once every page has been read in order and the minimum time is reached. The page count is read from the file.",
+  "text.learning-unit-video": "Video",
+  "text.learning-unit-video-hint": "Watch the video to the end and meet its required learning time to complete the unit. You cannot skip to an unwatched section.",
+  "text.learning-version-close-confirm": "Closing this version prevents new learners from starting it. Learners who have already started can continue.",
+  "text.learning-version-closed": "Closed",
+  "text.learning-version-closed-note": "Closed on {day}. It cannot be changed.",
+  "text.learning-version-delete-confirm": "Delete the draft with its units, questions and files?",
+  "text.learning-version-draft": "Draft",
+  "text.learning-version-draft-note": "A draft - learners do not see it until it is published.",
+  "text.learning-version-number": "Version {number}",
+  "text.learning-version-publish-confirm": "Published versions cannot be edited. The previously published version will be closed, and learners who have already started it can continue with that version.",
+  "text.learning-version-publish-done": "The version is published.",
+  "text.learning-version-published": "Published",
+  "text.learning-version-published-note": "Published on {day}. It cannot be changed - start a new version to change it.",
+  "title.learning-acknowledgement": "Acknowledgement",
+  "title.learning-assign": "Assign · {course}",
+  "title.learning-certificate": "Certificate",
+  "title.learning-completed": "Completed",
+  "title.learning-course-edit": "Edit course",
+  "title.learning-course-editor": "Course",
+  "title.learning-course-list": "Courses",
+  "title.learning-course-new": "New course",
+  "title.learning-enrollment-status": "Enrolments",
+  "title.learning-learning": "Course",
+  "title.learning-my-learning": "My learning",
+  "title.learning-question-edit": "Edit question",
+  "title.learning-question-new": "New question",
+  "title.learning-questions": "Quiz questions",
+  "title.learning-quiz": "Quiz",
+  "title.learning-to-take": "To take",
+  "title.learning-unit-edit": "Edit unit",
+  "title.learning-unit-new": "New unit",
+  "title.learning-units": "Units",
+  "title.learning-version-settings": "Completion and source",
+  "title.learning-versions": "Versions",
+  "button.learning-ai-material": "Draft with AI from material",
+  "button.learning-ai-generate": "Generate draft",
+  "button.learning-ai-apply": "Add reviewed draft",
+  "button.learning-ai-revise": "Revise request",
+  "field.learning-ai-source": "Source material",
+  "field.learning-ai-captions": "Video captions or transcript",
+  "field.learning-ai-instruction": "Audience, learning goals and requests",
+  "title.learning-ai-material": "Prepare a course draft from material",
+  "title.learning-ai-preview": "Review AI draft",
+  "title.learning-ai-missing": "Items to verify or complete",
+  "text.learning-ai-upload-first": "First add a PDF or video unit and upload its file.",
+  "text.learning-ai-material-help": "Prepare an introduction, objectives, supporting units and a quiz from the source. The original stays; generation does not save or publish.",
+  "text.learning-ai-captions-help": "Provide captions or a transcript, or leave blank to transcribe speech automatically. Automatic transcription sends audio to an external AI service and may incur charges in addition to draft generation. Video visuals are not analyzed. Review and edit the transcript after generation.",
+  "text.learning-ai-working": "Reading the material and preparing a draft.",
+  "text.learning-ai-apply-help": "Adding appends the introduction, supporting units and AI question drafts. Review sources, content, study times and questions before publishing.",
+  "error.learning-ai-material-invalid": "The complete source could not be read. Check the file, pages, captions and limits.",
+  "error.learning-ai-draft-invalid": "The AI draft has incomplete content, answers or references. The course was not changed. Revise the request and retry.",
+  "error.learning-ai-draft-stale": "The course or source changed. Review it and generate a fresh draft.",
+  "error.learning-ai-source-limit": "Source limit exceeded: PDF 50 MB, 80 pages, 12 scanned pages; text 120,000 characters. Split the material; it is never silently truncated.",
+  "error.learning-ai-source-read": "Could not read the source. Check access and the file, then retry.",
+  "error.learning-ai-video-limit": "Automatic transcription supports MP4/WebM up to 60 minutes/250 MB and transcripts up to 120,000 characters. Split the material.",
+  "error.learning-ai-transcription-unavailable": "The current AI agent cannot transcribe speech. Configure an OpenAI default agent or supply captions/transcript.",
+  "error.learning-ai-audio-unreadable": "Could not read speech. Check server ffmpeg, MP4/WebM format and audio track, or supply captions/transcript."
+}