@vue-skuilder/common-ui 0.2.2 → 0.2.4

package/dist/components/StudySession.types.d.ts

@@ -1,3 +1,4 @@
+import { ReplanHints, OutcomeObserver } from '../../../db/dist/index.mjs';
 /**
  * Misc. config for a study StudySessionConfig
  */
@@ -29,11 +30,27 @@ export type StudySessionConfig = {
      */
     initialReviewCap?: number;
     /**
-     * Optional hints to apply to the very first pipeline run (session init).
+     * Optional session-durable hints applied from session init onward.
      * Uses the same format as `ReplanOptions.hints` — boost/exclude/require tags.
-     * Applied via `setEphemeralHints()` before `prepareSession()`.
+     *
+     * Routed to `SessionController.setSessionHints()` before `prepareSession()`,
+     * so they are re-merged into every pipeline run for the rest of the session
+     * (initial plan + every replan), not consumed by the first run alone. This
+     * is what a post-lesson concept boost wants: emphasis that outlives the
+     * first queue rebuild rather than being clobbered by the first auto-replan.
+     */
+    initHints?: ReplanHints;
+    /**
+     * Hooks invoked after each question response is processed, for the whole
+     * session. The framework-blessed seam for cross-cutting reactions to
+     * observed performance — e.g. boosting a just-failed concept tag via
+     * session-durable hints, in one place rather than per question view.
+     *
+     * Each observer receives a read-only `SessionOutcome` (record + card tags +
+     * nav result) and a narrow `SessionControls` capability (read/merge/replace
+     * session hints, request a replan). See `OutcomeObserver` in `@vue-skuilder/db`.
      */
-    initHints?: Record<string, unknown>;
+    outcomeObservers?: OutcomeObserver[];
 };
 /**
  * Built-in card transition presets provided by StudySession.

package/dist/components/StudySession.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StudySession.types.d.ts","sourceRoot":"","sources":["../../src/components/StudySession.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,aAAa,EAAE,OAAO,CAAC;IAEvB;;;;;;;;;;;;OAYG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG,YAAY,GAAG,YAAY,CAAC;AAElF,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC"}
+{"version":3,"file":"StudySession.types.d.ts","sourceRoot":"","sources":["../../src/components/StudySession.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,aAAa,EAAE,OAAO,CAAC;IAEvB;;;;;;;;;;;;OAYG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,WAAW,CAAC;IAExB;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;CACtC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG,YAAY,GAAG,YAAY,CAAC;AAElF,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC"}

package/dist/components/StudySession.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StudySession.vue.d.ts","sourceRoot":"","sources":["../../src/components/StudySession.vue"],"names":[],"mappings":"AAiFA;AAAA,OAmzBO,EAAE,eAAe,EAAW,QAAQ,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAM/C,OAAO,UAAU,MAAM,gCAAgC,CAAC;AAGxD,OAAO,EAAE,SAAS,EAAuB,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EACL,WAAW,EACX,UAAU,EAEV,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EAEjB,YAAY,EAEZ,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEpG,UAAU,SAAS;IACjB,aAAa,EAAE,cAAc,CAAC;IAC9B,UAAU,EAAE,YAAY,CAAC,OAAO,UAAU,CAAC,CAAC;CAC7C;AAED,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,GAAG;IACxD,KAAK,EAAE,SAAS,CAAC;CAClB,CAAC;;;;;;;cAqBmB,QAAQ,CAAC,eAAe,EAAE,CAAC;;;;cAI1B,QAAQ,CAAC,eAAe,CAAC;;;;cAIzB,QAAQ,CAAC,iBAAiB,CAAC;;;;cAI3B,QAAQ,CAAC,kBAAkB,CAAC;;;;;;cAI1B,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,aAAa,CAAC;;;;;;;;;;;;cAY7C,QAAQ,CAAC,oBAAoB,GAAG,MAAM,CAAC;;;;cAIvC,QAAQ,CAAC,kBAAkB,CAAC;;;;;UAoB9B,aAAa,GAAG,IAAI;UACtB,QAAQ,EAAE;;;iBAGH;QAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE;;uBAEtB,iBAAiB,CAAC,aAAa,CAAC,GAAG,IAAI;;;mBAG7C,kBAAkB,EAAE;;;;sBAIf,qBAAqB,GAAG,IAAI;2BACzB,kBAAkB,EAAE;;;mBAG1B,aAAa,GAAG,IAAI;4BACX,MAAM,GAAG,IAAI;qBACpB,MAAM,CAAC,OAAO,GAAG,IAAI;;;;mBAOjC,kBAAkB;;IAoDjC;;;OAGG;;IAYH;;;;;;;;;;;;;OAaG;kCAC2B,aAAa;uBAUxB,MAAM,GAAG,SAAS;kCASxB,OAAO;;;;8BA6IM,MAAM,WAAW,MAAM,GAAG,MAAM;0BAI9B,aAAa,KAAK,UAAU;6BAiF/B,cAAc;;qBAsDhB,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;mBAO/C,YAAY,GAAG,IAAI;;;;;;;cAjdvB,QAAQ,CAAC,eAAe,EAAE,CAAC;;;;cAI1B,QAAQ,CAAC,eAAe,CAAC;;;;cAIzB,QAAQ,CAAC,iBAAiB,CAAC;;;;cAI3B,QAAQ,CAAC,kBAAkB,CAAC;;;;;;cAI1B,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,aAAa,CAAC;;;;;;;;;;;;cAY7C,QAAQ,CAAC,oBAAoB,GAAG,MAAM,CAAC;;;;cAIvC,QAAQ,CAAC,kBAAkB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAnDlD,wBA+gBG"}
+{"version":3,"file":"StudySession.vue.d.ts","sourceRoot":"","sources":["../../src/components/StudySession.vue"],"names":[],"mappings":"AAiFA;AAAA,OA6zBO,EAAE,eAAe,EAAW,QAAQ,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAM/C,OAAO,UAAU,MAAM,gCAAgC,CAAC;AAGxD,OAAO,EAAE,SAAS,EAAuB,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EACL,WAAW,EACX,UAAU,EAEV,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EAEjB,YAAY,EAGZ,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEpG,UAAU,SAAS;IACjB,aAAa,EAAE,cAAc,CAAC;IAC9B,UAAU,EAAE,YAAY,CAAC,OAAO,UAAU,CAAC,CAAC;CAC7C;AAED,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,GAAG;IACxD,KAAK,EAAE,SAAS,CAAC;CAClB,CAAC;;;;;;;cAqBmB,QAAQ,CAAC,eAAe,EAAE,CAAC;;;;cAI1B,QAAQ,CAAC,eAAe,CAAC;;;;cAIzB,QAAQ,CAAC,iBAAiB,CAAC;;;;cAI3B,QAAQ,CAAC,kBAAkB,CAAC;;;;;;cAI1B,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,aAAa,CAAC;;;;;;;;;;;;cAY7C,QAAQ,CAAC,oBAAoB,GAAG,MAAM,CAAC;;;;cAIvC,QAAQ,CAAC,kBAAkB,CAAC;;;;;UAoB9B,aAAa,GAAG,IAAI;UACtB,QAAQ,EAAE;;;iBAGH;QAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE;;uBAEtB,iBAAiB,CAAC,aAAa,CAAC,GAAG,IAAI;;;mBAG7C,kBAAkB,EAAE;;;;sBAIf,qBAAqB,GAAG,IAAI;2BACzB,kBAAkB,EAAE;;;mBAG1B,aAAa,GAAG,IAAI;4BACX,MAAM,GAAG,IAAI;qBACpB,MAAM,CAAC,OAAO,GAAG,IAAI;;;;mBAOjC,kBAAkB;;IAoDjC;;;OAGG;;IAYH;;;;;;;;;;;;;OAaG;kCAC2B,aAAa;uBAUxB,MAAM,GAAG,SAAS;kCASxB,OAAO;;;;8BAsJM,MAAM,WAAW,MAAM,GAAG,MAAM;0BAI9B,aAAa,KAAK,UAAU;6BAiF/B,cAAc;;qBAsDhB,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;mBAO/C,YAAY,GAAG,IAAI;;;;;;;cA1dvB,QAAQ,CAAC,eAAe,EAAE,CAAC;;;;cAI1B,QAAQ,CAAC,eAAe,CAAC;;;;cAIzB,QAAQ,CAAC,iBAAiB,CAAC;;;;cAI3B,QAAQ,CAAC,kBAAkB,CAAC;;;;;;cAI1B,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,aAAa,CAAC;;;;;;;;;;;;cAY7C,QAAQ,CAAC,oBAAoB,GAAG,MAAM,CAAC;;;;cAIvC,QAAQ,CAAC,kBAAkB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAnDlD,wBAwhBG"}

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.2.2",
+  "version": "0.2.4",
   "sideEffects": false,
   "main": "./dist/common-ui.umd.js",
   "module": "./dist/common-ui.es.js",
@@ -34,8 +34,8 @@
     "@highlightjs/vue-plugin": "^2.1.2",
     "@mdi/font": "^7.3.67",
     "@vojtechlanka/vue-tags-input": "^3",
-    "@vue-skuilder/common": "0.2.2",
-    "@vue-skuilder/db": "0.2.2",
+    "@vue-skuilder/common": "0.2.4",
+    "@vue-skuilder/db": "0.2.4",
     "highlight.js": "^11.0.1",
     "marked": "^15.0.6",
     "moment": "^2.29.4",
@@ -71,5 +71,5 @@
     "vite-plugin-dts": "^4.5.3",
     "vitest": "^4.1.0"
   },
-  "stableVersion": "0.2.2"
+  "stableVersion": "0.2.4"
 }

package/src/components/StudySession.types.ts

@@ -1,3 +1,5 @@
+import type { ReplanHints, OutcomeObserver } from '@vue-skuilder/db';
+
 /**
  * Misc. config for a study StudySessionConfig
  */
@@ -32,11 +34,28 @@ export type StudySessionConfig = {
   initialReviewCap?: number;
 
   /**
-   * Optional hints to apply to the very first pipeline run (session init).
+   * Optional session-durable hints applied from session init onward.
    * Uses the same format as `ReplanOptions.hints` — boost/exclude/require tags.
-   * Applied via `setEphemeralHints()` before `prepareSession()`.
+   *
+   * Routed to `SessionController.setSessionHints()` before `prepareSession()`,
+   * so they are re-merged into every pipeline run for the rest of the session
+   * (initial plan + every replan), not consumed by the first run alone. This
+   * is what a post-lesson concept boost wants: emphasis that outlives the
+   * first queue rebuild rather than being clobbered by the first auto-replan.
+   */
+  initHints?: ReplanHints;
+
+  /**
+   * Hooks invoked after each question response is processed, for the whole
+   * session. The framework-blessed seam for cross-cutting reactions to
+   * observed performance — e.g. boosting a just-failed concept tag via
+   * session-durable hints, in one place rather than per question view.
+   *
+   * Each observer receives a read-only `SessionOutcome` (record + card tags +
+   * nav result) and a narrow `SessionControls` capability (read/merge/replace
+   * session hints, request a replan). See `OutcomeObserver` in `@vue-skuilder/db`.
    */
-  initHints?: Record<string, unknown>;
+  outcomeObservers?: OutcomeObserver[];
 };
 
 /**

package/src/components/StudySession.vue

@@ -102,6 +102,7 @@ import {
   getStudySource,
   HydratedCard,
   isQuestionRecord,
+  OutcomeObserver,
   ReplanOptions,
   ResponseResult,
   SessionController,
@@ -385,13 +386,20 @@ export default defineComponent({
           // db.setChangeFcn(this.handleClassroomMessage());
         });
 
-        const scOptions: { defaultBatchLimit?: number; initialReviewCap?: number } = {};
+        const scOptions: {
+          defaultBatchLimit?: number;
+          initialReviewCap?: number;
+          outcomeObservers?: OutcomeObserver[];
+        } = {};
         if (this.sessionConfig?.defaultBatchLimit !== undefined) {
           scOptions.defaultBatchLimit = this.sessionConfig.defaultBatchLimit;
         }
         if (this.sessionConfig?.initialReviewCap !== undefined) {
           scOptions.initialReviewCap = this.sessionConfig.initialReviewCap;
         }
+        if (this.sessionConfig?.outcomeObservers?.length) {
+          scOptions.outcomeObservers = this.sessionConfig.outcomeObservers;
+        }
 
         this.sessionController = markRaw(
           new SessionController<ViewComponent>(
@@ -405,12 +413,14 @@ export default defineComponent({
         );
         this.sessionController.sessionRecord = this.sessionRecord;
 
-        // Apply init hints if provided (e.g. post-lesson boost tags)
+        // Apply init hints as SESSION-DURABLE hints (e.g. post-lesson boost
+        // tags). Routed through the controller's session-hints accumulator so
+        // they are re-merged into every pipeline run for the rest of the
+        // session — rather than being consumed by the initial plan alone and
+        // then clobbered by the first (replace-mode) auto-replan.
         if (this.sessionConfig?.initHints) {
-          for (const source of this.sessionContentSources) {
-            source.setEphemeralHints?.(this.sessionConfig.initHints as any);
-          }
-          console.log('[StudySession] Applied init hints to content sources');
+          this.sessionController.setSessionHints(this.sessionConfig.initHints);
+          console.log('[StudySession] Applied init hints as session-durable hints');
         }
 
         await this.sessionController.prepareSession();