@vue-skuilder/common-ui 0.1.32-a → 0.1.32-c

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

@@ -3,6 +3,26 @@
  */
 export type StudySessionConfig = {
     likesConfetti: boolean;
+    /**
+     * Default pipeline batch size for new-card planning.
+     *
+     * Controls how many cards the pipeline returns per run (both initial
+     * session setup and auto-replans). Smaller values cause more frequent
+     * replans, keeping plans aligned with rapidly-changing user state —
+     * ideal for newer users who unlock content quickly.
+     *
+     * Explicit `ReplanOptions.limit` on individual replan requests always
+     * takes precedence over this default.
+     *
+     * Default (when omitted): 20
+     */
+    defaultBatchLimit?: number;
+    /**
+     * Optional hints to apply to the very first pipeline run (session init).
+     * Uses the same format as `ReplanOptions.hints` — boost/exclude/require tags.
+     * Applied via `setEphemeralHints()` before `prepareSession()`.
+     */
+    initHints?: Record<string, unknown>;
 };
 /**
  * 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;CACxB,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;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,aAAa,EAAE,OAAO,CAAC;IAEvB;;;;;;;;;;;;OAYG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;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"}

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

@@ -2,7 +2,7 @@ import { defineComponent, PropType } from 'vue';
 import { ViewComponent } from '../composables';
 import { default as CardViewer } from './cardRendering/CardViewer.vue';
 import { CourseElo, ViewData } from '../../../common/dist/index.mjs';
-import { CardHistory, CardRecord, ContentSourceID, CourseRegistrationDoc, DataLayerProvider, HydratedCard, ResponseResult, SessionController, StudyContentSource, StudySessionRecord, UserDBInterface } from '../../../db/dist/index.mjs';
+import { CardHistory, CardRecord, ContentSourceID, CourseRegistrationDoc, DataLayerProvider, HydratedCard, ReplanOptions, ResponseResult, SessionController, StudyContentSource, StudySessionRecord, UserDBInterface } from '../../../db/dist/index.mjs';
 import { StudySessionConfig, CardTransitionPreset, CardTransitionMode } from './StudySession.types';
 interface StudyRefs {
     shadowWrapper: HTMLDivElement;
@@ -75,7 +75,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     sessionContentSources: StudyContentSource[];
     timeRemaining: number;
     replanPending: boolean;
-    replanHints: Record<string, unknown> | null;
+    replanOptions: ReplanOptions | null;
     deferredNextCardAction: string | null;
     intervalHandler: NodeJS.Timeout | null;
     cardType: string;
@@ -98,8 +98,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
      * The replan is deferred — not fired immediately. processResponse()
      * checks this flag after submitResponse() has recorded ELO/tag
      * interactions, ensuring the pipeline sees fully up-to-date state.
+     *
+     * Accepts either a ReplanOptions object (new API) or a bare hints
+     * Record (legacy). SessionController.requestReplan() normalises both.
      */
-    handleReplanRequest(hints?: Record<string, unknown>): void;
+    handleReplanRequest(options?: ReplanOptions): void;
     user_elo(courseID: string): CourseElo;
     handleClassroomMessage(): (v: unknown) => {};
     incrementSessionClock(): void;

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":"AA4EA;AAAA,OA+vBO,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,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;;;iBAG5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;4BACnB,MAAM,GAAG,IAAI;qBACpB,MAAM,CAAC,OAAO,GAAG,IAAI;;;;mBAOjC,kBAAkB;;IA4CjC;;;OAGG;;IAYH;;;;;;;;;;OAUG;gCACyB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;uBAQhC,MAAM,GAAG,SAAS;kCASxB,OAAO;;;;8BA2HM,MAAM,WAAW,MAAM,GAAG,MAAM;0BAI9B,aAAa,KAAK,UAAU;6BA+E/B,cAAc;;qBAsDhB,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;mBAO/C,YAAY,GAAG,IAAI;;;;;;;cAhbvB,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,wBA6eG"}
+{"version":3,"file":"StudySession.vue.d.ts","sourceRoot":"","sources":["../../src/components/StudySession.vue"],"names":[],"mappings":"AAgFA;AAAA,OAyxBO,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;;IA4CjC;;;OAGG;;IAYH;;;;;;;;;;;;;OAaG;kCAC2B,aAAa;uBAUxB,MAAM,GAAG,SAAS;kCASxB,OAAO;;;;8BAyIM,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;;;;;;;cArcvB,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,wBAkgBG"}

package/dist/components/auth/UserRegistration.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UserRegistration.vue.d.ts","sourceRoot":"","sources":["../../../src/components/auth/UserRegistration.vue"],"names":[],"mappings":"AA8EA;AAAA,OAiSO,EAAmB,QAAQ,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,MAAM,EAAO,MAAM,sBAAsB,CAAC;;;cAU3B,QAAQ,CAAC,CAAC,OAAO,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,CAAC;;;;;;;;;;;;;;;;;;UAuBrD,eAAe,GAAG,IAAI;WACO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA0L3B,CAAC;;;;;;;;;;;;wBA+BgE,CAAA;yBAAuB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA/BzF,CAAC;;;;;;;;;;;;wBA+BgE,CAAA;yBAAuB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA/BzF,CAAC;;;;;;;;;;;;wBA+BgE,CAAA;yBAAuB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA/BzF,CAAC;;;;;;;;;;;;wBA+BgE,CAAA;yBAAuB,CAAC;;;;;;;;;;;;;;;;;yBAhN9F,OAAO;;;;;qBASX,MAAM;2BAGA,MAAM;;;;;;;;cA7CT,QAAQ,CAAC,CAAC,OAAO,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,CAAC;;;;;;;AALzE,wBAqMG"}
+{"version":3,"file":"UserRegistration.vue.d.ts","sourceRoot":"","sources":["../../../src/components/auth/UserRegistration.vue"],"names":[],"mappings":"AA8EA;AAAA,OAiSO,EAAmB,QAAQ,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,MAAM,EAAO,MAAM,sBAAsB,CAAC;;;cAU3B,QAAQ,CAAC,CAAC,OAAO,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,CAAC;;;;;;;;;;;;;;;;;;UAuBrD,eAAe,GAAG,IAAI;WACO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA4dyvK,CAAC;;;;;;;;;;;;wBAAm0D,CAAC;yBAAuB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAA71D,CAAC;;;;;;;;;;;;wBAAm0D,CAAC;yBAAuB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAA71D,CAAC;;;;;;;;;;;;wBAAm0D,CAAC;yBAAuB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAA71D,CAAC;;;;;;;;;;;;wBAAm0D,CAAC;yBAAuB,CAAC;;;;;;;;;;;;;;;;;yBAndtnO,OAAO;;;;;qBASX,MAAM;2BAGA,MAAM;;;;;;;;cA7CT,QAAQ,CAAC,CAAC,OAAO,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,CAAC;;;;;;;AALzE,wBAqMG"}

package/dist/stores/useAuthStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAuthStore.d.ts","sourceRoot":"","sources":["../../src/stores/useAuthStore.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGjE,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,eAAe,GAAG,SAAS,CAAC;IACnC,oBAAoB,EAAE;QACpB,IAAI,EAAE,OAAO,CAAC;QACd,QAAQ,EAAE,OAAO,CAAC;QAClB,aAAa,EAAE,OAAO,CAAC;QACvB,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;IACF,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAiB3E;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAgFmub,CAAC;;;;;;;;;;;;oBAAm0D,CAAC;qBAAuB,CAAC;;;;;;;kBA3G/kf,OAAO;sBACH,OAAO;2BACF,OAAO;6BACL,OAAO;;wBAEV,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAsGmub,CAAC;;;;;;;;;;;;oBAAm0D,CAAC;qBAAuB,CAAC;;;;;;;kBA3G/kf,OAAO;sBACH,OAAO;2BACF,OAAO;6BACL,OAAO;;wBAEV,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAsGmub,CAAC;;;;;;;;;;;;oBAAm0D,CAAC;qBAAuB,CAAC;;;;;;;kBA3G/kf,OAAO;sBACH,OAAO;2BACF,OAAO;6BACL,OAAO;;wBAEV,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAsGmub,CAAC;;;;;;;;;;;;oBAAm0D,CAAC;qBAAuB,CAAC;;;;;;;;;yBA1C9jf,OAAO;uBAIT,OAAO;;;;;EAqC/B,CAAC"}
+{"version":3,"file":"useAuthStore.d.ts","sourceRoot":"","sources":["../../src/stores/useAuthStore.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGjE,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,eAAe,GAAG,SAAS,CAAC;IACnC,oBAAoB,EAAE;QACpB,IAAI,EAAE,OAAO,CAAC;QACd,QAAQ,EAAE,OAAO,CAAC;QAClB,aAAa,EAAE,OAAO,CAAC;QACvB,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;IACF,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAiB3E;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAgFukhC,CAAC;;;;;;;;;;;;oBAAm0D,CAAC;qBAAuB,CAAC;;;;;;;kBA3Gn7kC,OAAO;sBACH,OAAO;2BACF,OAAO;6BACL,OAAO;;wBAEV,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAsGukhC,CAAC;;;;;;;;;;;;oBAAm0D,CAAC;qBAAuB,CAAC;;;;;;;kBA3Gn7kC,OAAO;sBACH,OAAO;2BACF,OAAO;6BACL,OAAO;;wBAEV,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAsGukhC,CAAC;;;;;;;;;;;;oBAAm0D,CAAC;qBAAuB,CAAC;;;;;;;kBA3Gn7kC,OAAO;sBACH,OAAO;2BACF,OAAO;6BACL,OAAO;;wBAEV,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAsGukhC,CAAC;;;;;;;;;;;;oBAAm0D,CAAC;qBAAuB,CAAC;;;;;;;;;yBA1Cl6kC,OAAO;uBAIT,OAAO;;;;;EAqC/B,CAAC"}

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.32-a",
+  "version": "0.1.32-c",
   "main": "./dist/common-ui.umd.js",
   "module": "./dist/common-ui.es.js",
   "types": "./dist/index.d.ts",
@@ -33,8 +33,8 @@
     "@highlightjs/vue-plugin": "^2.1.2",
     "@mdi/font": "^7.3.67",
     "@vojtechlanka/vue-tags-input": "^3",
-    "@vue-skuilder/common": "0.1.32-a",
-    "@vue-skuilder/db": "0.1.32-a",
+    "@vue-skuilder/common": "0.1.32-c",
+    "@vue-skuilder/db": "0.1.32-c",
     "highlight.js": "^11.0.1",
     "marked": "^15.0.6",
     "moment": "^2.29.4",

package/src/components/StudySession.types.ts

@@ -3,6 +3,28 @@
  */
 export type StudySessionConfig = {
   likesConfetti: boolean;
+
+  /**
+   * Default pipeline batch size for new-card planning.
+   *
+   * Controls how many cards the pipeline returns per run (both initial
+   * session setup and auto-replans). Smaller values cause more frequent
+   * replans, keeping plans aligned with rapidly-changing user state —
+   * ideal for newer users who unlock content quickly.
+   *
+   * Explicit `ReplanOptions.limit` on individual replan requests always
+   * takes precedence over this default.
+   *
+   * Default (when omitted): 20
+   */
+  defaultBatchLimit?: number;
+
+  /**
+   * Optional hints to apply to the very first pipeline run (session init).
+   * Uses the same format as `ReplanOptions.hints` — boost/exclude/require tags.
+   * Applied via `setEphemeralHints()` before `prepareSession()`.
+   */
+  initHints?: Record<string, unknown>;
 };
 
 /**

package/src/components/StudySession.vue

@@ -11,14 +11,18 @@
 
     <br v-if="!frameless" />
 
-    <div v-if="sessionFinished" class="text-h4">
-      <p>Study session finished! Great job!</p>
-      <p v-if="sessionController">{{ sessionController.report }}</p>
-      <!-- <p>
-        Start <a @click="$emit('session-finished')">another study session</a>, or try
-        <router-link :to="`/edit/${courseID}`">adding some new content</router-link> to challenge yourself and others!
-      </p> -->
-      <heat-map :activity-records-getter="() => user.getActivityRecords()" />
+    <div v-if="sessionFinished">
+      <slot name="session-finished" :session-record="sessionRecord" :report="sessionController?.report">
+        <div class="text-h4">
+          <p>Study session finished! Great job!</p>
+          <p v-if="sessionController">{{ sessionController.report }}</p>
+          <!-- <p>
+            Start <a @click="$emit('session-finished')">another study session</a>, or try
+            <router-link :to="`/edit/${courseID}`">adding some new content</router-link> to challenge yourself and others!
+          </p> -->
+          <heat-map :activity-records-getter="() => user.getActivityRecords()" />
+        </div>
+      </slot>
     </div>
 
     <div v-else ref="shadowWrapper" class="card-transition-container">
@@ -97,6 +101,7 @@ import {
   getStudySource,
   HydratedCard,
   isQuestionRecord,
+  ReplanOptions,
   ResponseResult,
   SessionController,
   StudyContentSource,
@@ -204,7 +209,7 @@ export default defineComponent({
       sessionContentSources: [] as StudyContentSource[],
       timeRemaining: 300, // 5 minutes * 60 seconds
       replanPending: false,
-      replanHints: null as Record<string, unknown> | null,
+      replanOptions: null as ReplanOptions | null,
       deferredNextCardAction: null as string | null,
       intervalHandler: null as NodeJS.Timeout | null,
       cardType: '',
@@ -282,12 +287,17 @@ export default defineComponent({
      * The replan is deferred — not fired immediately. processResponse()
      * checks this flag after submitResponse() has recorded ELO/tag
      * interactions, ensuring the pipeline sees fully up-to-date state.
+     *
+     * Accepts either a ReplanOptions object (new API) or a bare hints
+     * Record (legacy). SessionController.requestReplan() normalises both.
      */
-    handleReplanRequest(hints?: Record<string, unknown>) {
+    handleReplanRequest(options?: ReplanOptions) {
       if (this.sessionController) {
-        console.log(`[StudySession] Replan requested by card view${hints ? ' (with hints)' : ''}, deferring until after response processing`);
+        const label = (options as ReplanOptions)?.label;
+        const tag = label ? ` [${label}]` : '';
+        console.log(`[StudySession] Replan requested by card view${tag}, deferring until after response processing`);
         this.replanPending = true;
-        this.replanHints = hints ?? null;
+        this.replanOptions = (options as ReplanOptions) ?? null;
       }
     },
 
@@ -366,16 +376,30 @@ export default defineComponent({
           // db.setChangeFcn(this.handleClassroomMessage());
         });
 
+        const scOptions = this.sessionConfig?.defaultBatchLimit !== undefined
+          ? { defaultBatchLimit: this.sessionConfig.defaultBatchLimit }
+          : undefined;
+
         this.sessionController = markRaw(
           new SessionController<ViewComponent>(
             this.sessionContentSources,
             60 * this.sessionTimeLimit,
             this.dataLayer,
-            this.getViewComponent
+            this.getViewComponent,
+            undefined, // mixer — use default
+            scOptions
           )
         );
         this.sessionController.sessionRecord = this.sessionRecord;
 
+        // Apply init hints if provided (e.g. post-lesson boost tags)
+        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');
+        }
+
         await this.sessionController.prepareSession();
         this.intervalHandler = setInterval(this.tick, 1000);
 
@@ -482,11 +506,13 @@ export default defineComponent({
 
       // Fire deferred replan if requested — state is now fully recorded
       if (this.replanPending) {
-        const hints = this.replanHints;
-        console.log(`[StudySession] Firing deferred replan (post-submitResponse)${hints ? ' with hints' : ''}`);
+        const opts = this.replanOptions;
+        const label = opts?.label;
+        const tag = label ? ` [${label}]` : '';
+        console.log(`[StudySession] Firing deferred replan (post-submitResponse)${tag}`);
         this.replanPending = false;
-        this.replanHints = null;
-        void this.sessionController!.requestReplan(hints ?? undefined);
+        this.replanOptions = null;
+        void this.sessionController!.requestReplan(opts ?? undefined);
         this.$emit('replan-requested');
       }