@plasius/learning 0.6.0 → 0.8.0

package/dist/index.d.cts

@@ -1,5 +1,6 @@
 import { A as AssessmentRubricV1, a as AssessmentCheckResultV1, b as AssessmentResultV1, c as LearningModuleVersionV1, d as LearningPathVersionV1, L as LearningCourseV1, e as LearningValidationIssueV1, M as MissionAuthoringBundleV1, f as MissionAuthoringValidationIssueV1, E as ExternalLearningContentReferenceV1 } from './course-authoring-DImvrK5r.cjs';
 export { g as AssessmentCriterionV1, h as AssessmentDimensionV1, i as AttemptEvidenceV1, B as BadgeDefinitionV1, j as CommercialStateV1, k as CourseMaterialAudienceV1, l as CourseMaterialKindV1, m as CourseMaterialV1, n as CourseMaterialsManifestV1, C as CoursePracticeQuestion, o as EXTERNAL_LEARNING_CONTENT_REFERENCE_VERSION_V1, F as FacilitatorMissionAuthoringV1, G as GuardianAiConsentV1, H as HardwareItemV1, p as HardwareModeV1, q as HardwareRequirementManifestV1, r as HardwareVerificationStatusV1, s as LEARNING_COURSE_LIMITS, t as LEARNING_COURSE_STAGE_ORDER, u as LearnerMissionAuthoringV1, v as LearningCourseDraftV1, w as LearningCourseInputError, x as LearningCourseMissionV1, y as LearningCourseStageV1, z as LearningCourseValidationIssueV1, D as LearningGoalV1, I as LearningProjectFileV1, J as LearningProjectLanguageV1, K as LearningProjectV1, N as LearningSaveSlotIdV1, O as MISSION_AUTHORING_CONTRACT_VERSION_V1, P as MissionAccessibilityAlternativeV1, Q as MissionArtifactKindV1, R as MissionArtifactReferenceV1, S as MissionAuthoringGoalV1, T as MissionBoundedSuggestionV1, U as MissionEvidenceKindV1, V as MissionEvidenceRequirementV1, W as MissionEvidenceRetentionV1, X as MissionFunctionParameterV1, Y as MissionFunctionReferenceV1, Z as MissionHardwareAcquisitionScopeV1, _ as MissionHardwareComponentDisclosureV1, $ as MissionHardwareDisclosureV1, a0 as MissionInteractionModeV1, a1 as MissionInteractionRequirementV1, a2 as MissionPhysicalSafeguardsV1, a3 as MissionReadinessCheckV1, a4 as MissionRewardBindingV1, a5 as MissionSideAdventureV1, a6 as MissionStageCardV1, a7 as MissionStageKindV1, a8 as MissionV1, a9 as ModuleAgentDefinitionV1, aa as ModuleAgentFeedbackV1, ab as ModuleAgentRoleV1, ac as ModuleCategoryV1, ad as ModuleEntitlementV1, ae as ModulePricingV1, af as ModuleReferencePriceV1, ag as PublishedStaticProjectSnapshotV1, ah as ScoreBandV1, ai as parseLearningCourse, aj as parseLearningCourseDraft, ak as parseLearningProject, al as parseLearningSaveSlotId, am as validateLearningCourse } from './course-authoring-DImvrK5r.cjs';
+export { L as LearningCourseSuggestionV1, a as applyLearningCourseSuggestion, p as parseLearningCourseSuggestion } from './course-suggestions-mK2MPB7e.cjs';
 
 /**
  * Calculate a score solely from rubric criteria and objective check results.

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { A as AssessmentRubricV1, a as AssessmentCheckResultV1, b as AssessmentResultV1, c as LearningModuleVersionV1, d as LearningPathVersionV1, L as LearningCourseV1, e as LearningValidationIssueV1, M as MissionAuthoringBundleV1, f as MissionAuthoringValidationIssueV1, E as ExternalLearningContentReferenceV1 } from './course-authoring-DImvrK5r.js';
 export { g as AssessmentCriterionV1, h as AssessmentDimensionV1, i as AttemptEvidenceV1, B as BadgeDefinitionV1, j as CommercialStateV1, k as CourseMaterialAudienceV1, l as CourseMaterialKindV1, m as CourseMaterialV1, n as CourseMaterialsManifestV1, C as CoursePracticeQuestion, o as EXTERNAL_LEARNING_CONTENT_REFERENCE_VERSION_V1, F as FacilitatorMissionAuthoringV1, G as GuardianAiConsentV1, H as HardwareItemV1, p as HardwareModeV1, q as HardwareRequirementManifestV1, r as HardwareVerificationStatusV1, s as LEARNING_COURSE_LIMITS, t as LEARNING_COURSE_STAGE_ORDER, u as LearnerMissionAuthoringV1, v as LearningCourseDraftV1, w as LearningCourseInputError, x as LearningCourseMissionV1, y as LearningCourseStageV1, z as LearningCourseValidationIssueV1, D as LearningGoalV1, I as LearningProjectFileV1, J as LearningProjectLanguageV1, K as LearningProjectV1, N as LearningSaveSlotIdV1, O as MISSION_AUTHORING_CONTRACT_VERSION_V1, P as MissionAccessibilityAlternativeV1, Q as MissionArtifactKindV1, R as MissionArtifactReferenceV1, S as MissionAuthoringGoalV1, T as MissionBoundedSuggestionV1, U as MissionEvidenceKindV1, V as MissionEvidenceRequirementV1, W as MissionEvidenceRetentionV1, X as MissionFunctionParameterV1, Y as MissionFunctionReferenceV1, Z as MissionHardwareAcquisitionScopeV1, _ as MissionHardwareComponentDisclosureV1, $ as MissionHardwareDisclosureV1, a0 as MissionInteractionModeV1, a1 as MissionInteractionRequirementV1, a2 as MissionPhysicalSafeguardsV1, a3 as MissionReadinessCheckV1, a4 as MissionRewardBindingV1, a5 as MissionSideAdventureV1, a6 as MissionStageCardV1, a7 as MissionStageKindV1, a8 as MissionV1, a9 as ModuleAgentDefinitionV1, aa as ModuleAgentFeedbackV1, ab as ModuleAgentRoleV1, ac as ModuleCategoryV1, ad as ModuleEntitlementV1, ae as ModulePricingV1, af as ModuleReferencePriceV1, ag as PublishedStaticProjectSnapshotV1, ah as ScoreBandV1, ai as parseLearningCourse, aj as parseLearningCourseDraft, ak as parseLearningProject, al as parseLearningSaveSlotId, am as validateLearningCourse } from './course-authoring-DImvrK5r.js';
+export { L as LearningCourseSuggestionV1, a as applyLearningCourseSuggestion, p as parseLearningCourseSuggestion } from './course-suggestions-CBs5swU6.js';
 
 /**
  * Calculate a score solely from rubric criteria and objective check results.

package/dist/index.js

@@ -976,6 +976,42 @@ function completeVerifiedLearningActivity(course, progress, proof) {
   return next;
 }
 
+// src/course-suggestions.ts
+var record2 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+var keys2 = (value, expected) => Object.keys(value).length === expected.length && expected.every((key) => Object.hasOwn(value, key));
+var text = (value, maximum) => typeof value === "string" && value.trim().length > 0 && value.length <= maximum && !value.includes("\0");
+function parseLearningCourseSuggestion(course, value) {
+  if (!record2(value) || !keys2(value, ["stageId", "proposal"]) || !text(value.stageId, 128) || !course.missions.some((mission2) => mission2.stages.some((stage) => stage.id === value.stageId)) || !record2(value.proposal)) {
+    throw new Error("Invalid course suggestion.");
+  }
+  const proposal = value.proposal;
+  if (!keys2(proposal, [
+    "id",
+    "source",
+    "intent",
+    "constraints",
+    "permittedArtifactId",
+    "originalSnippet",
+    "replacementSnippet",
+    "explanationPrompt",
+    "aiOptional",
+    "learnerApprovalRequired",
+    "alternatives"
+  ]) || !text(proposal.id, 128) || proposal.source !== "authored-fallback" || !text(proposal.intent, 1e3) || !Array.isArray(proposal.constraints) || proposal.constraints.length < 1 || proposal.constraints.length > 8 || !proposal.constraints.every((constraint) => text(constraint, 400)) || !course.projectFiles.some((file) => file.path === proposal.permittedArtifactId) || !text(proposal.originalSnippet, 8e3) || !text(proposal.replacementSnippet, 8e3) || proposal.originalSnippet === proposal.replacementSnippet || !text(proposal.explanationPrompt, 1e3) || proposal.aiOptional !== false || proposal.learnerApprovalRequired !== true || !Array.isArray(proposal.alternatives) || proposal.alternatives.length !== 2 || proposal.alternatives[0] !== "accept" || proposal.alternatives[1] !== "reject") throw new Error("Invalid course suggestion.");
+  return structuredClone(value);
+}
+function applyLearningCourseSuggestion(course, project, suggestion) {
+  const parsed = parseLearningProject(course, project);
+  const { proposal } = parseLearningCourseSuggestion(course, suggestion);
+  const file = parsed.files.find((candidate) => candidate.path === proposal.permittedArtifactId);
+  const start = file.source.indexOf(proposal.originalSnippet);
+  if (start < 0 || file.source.indexOf(proposal.originalSnippet, start + 1) >= 0) {
+    throw new Error("Suggestion does not match exactly one source location.");
+  }
+  file.source = file.source.slice(0, start) + proposal.replacementSnippet + file.source.slice(start + proposal.originalSnippet.length);
+  return parseLearningProject(course, parsed);
+}
+
 // src/contextual-help.ts
 var CONTEXTUAL_HELP_CONTRACT_VERSION_V1 = "1.0.0";
 var CONTEXTUAL_HELP_KINDS_V1 = Object.freeze([
@@ -1489,6 +1525,7 @@ export {
   VIBE_BUG_DETECTIVE_MISSION_ONE_AUTHORING_V1,
   VIBE_GAME_REMIX_LAB_MISSION_ONE_AUTHORING_V1,
   VIBE_IDEA_STUDIO_MISSION_ONE_AUTHORING_V1,
+  applyLearningCourseSuggestion,
   assertValidCanonicalSpokenHelpDescriptor,
   assertValidContextualHelpIdentifier,
   assertValidContextualVoiceQuestionMetadata,
@@ -1507,6 +1544,7 @@ export {
   parseLearningCourse,
   parseLearningCourseDraft,
   parseLearningCourseProgress,
+  parseLearningCourseSuggestion,
   parseLearningProject,
   parseLearningSaveSlotId,
   recordLearningCourseAssessment,