@pie-element/mc-populated-blank 0.2.11 → 0.2.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pie-element/mc-populated-blank",
-  "version": "0.2.11",
+  "version": "0.2.12",
   "description": "Multiple-choice option populates an inline blank in a sentence template (Svelte 5 PIE element)",
   "type": "module",
   "main": "./dist/index.js",
@@ -10,34 +10,28 @@
   },
   "exports": {
     ".": {
-      "development": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
     "./delivery": {
-      "development": "./src/delivery/index.ts",
       "types": "./dist/delivery/index.d.ts",
       "default": "./dist/delivery/index.js"
     },
     "./controller": {
-      "development": "./src/controller/index.ts",
       "types": "./dist/controller/index.d.ts",
       "default": "./dist/controller/index.js"
     },
     "./author": {
-      "development": "./src/author/index.ts",
       "types": "./dist/author/index.d.ts",
       "default": "./dist/author/index.js"
     },
     "./print": {
-      "development": "./src/print/index.ts",
       "types": "./dist/print/index.d.ts",
       "default": "./dist/print/index.js"
     }
   },
   "files": [
     "dist",
-    "src",
     "controller.js"
   ],
   "sideEffects": false,
@@ -46,14 +40,9 @@
     "dev": "vite",
     "clean": "rm -rf dist tsconfig.tsbuildinfo"
   },
-  "dependencies": {
-    "@pie-lib/delivery-events-svelte": "0.1.0",
-    "@pie-lib/styling-svelte": "0.1.2"
-  },
-  "peerDependencies": {
-    "svelte": "^5.0.0"
-  },
   "devDependencies": {
+    "@pie-lib/delivery-events-svelte": "0.1.0",
+    "@pie-lib/styling-svelte": "0.1.2",
     "@sveltejs/vite-plugin-svelte": "^7.0.0",
     "svelte": "^5.54.0",
     "typescript": "^5.9.3",

package/dist/controller/index.test.d.ts

@@ -1,63 +0,0 @@
-/**
- * Unit tests for the McPopulatedBlank controller.
- *
- * Cases are grouped by exported function.
- *
- * getCorrectness
- *   G1. No session → unanswered
- *   G2. No choiceId → unanswered
- *   G3. Correct choice selected → correct
- *   G4. Wrong choice selected → incorrect
- *
- * outcome
- *   O1. Empty session → score 0, empty: true
- *   O2. No choiceId → score 0, empty: true
- *   O3. Correct choice → score 1, empty: false
- *   O4. Wrong choice → score 0, empty: false
- *   O5. traceLog includes mode, selected id, correct id, final score
- *
- * model — choice ordering
- *   M1. shuffle=false → original order preserved
- *   M2. shuffle=true, instructor role → original order locked
- *   M3. shuffle=true, lockChoiceOrder=true → original order locked
- *   M4. shuffle=true, stored shuffle in session.data.shuffledValues → restored
- *   M5. shuffle=true, stored shuffle in session.shuffledValues (legacy) → restored
- *   M6. shuffle=true, stored shuffle has unknown ids → extras appended at end
- *   M7. shuffle=true, no stored shuffle → shuffled; updateSession called with new order
- *   M8. shuffle=true, no stored shuffle, no updateSession → shuffled silently (no throw)
- *
- * model — output fields
- *   M9. evaluate mode → correctness, responseCorrect, correctChoiceId present
- *   M10. gather mode → correctness fields absent
- *   M11. instructor + view mode → teacherInstructions included when enabled
- *   M12. student role → teacherInstructions always null
- *   M13. prompt included when promptEnabled=true
- *   M14. prompt null when promptEnabled=false
- *   M15. audioUrl null when hasAudio=false
- *   M16. audioUrl passed through when hasAudio=true
- *   M17. disabled=true in view/evaluate mode, false in gather
- *
- * validate
- *   V1. Valid question → empty errors object
- *   V2. promptEnabled + empty prompt → prompt error
- *   V3. populate_blank with no blank token → template error
- *   V4. populate_blank with two blank tokens → template error
- *   V5. audio_mc_only with a blank token → template error
- *   V6. Unknown interactionMode → interactionMode error
- *   V7. Fewer than two choices → choices error
- *   V8. Choice missing id → choices error
- *   V9. Text mode choice missing labelHtml → choices error
- *   V10. Image mode choice missing imageUrl → choices error
- *   V11. Image mode choice missing imageAlt → choices error
- *   V12. correctChoiceId not in choices → correctChoiceId error
- *   V13. hasAudio=true with no audioUrl → audioUrl error
- *   V14. layoutLimits with a non-positive value → layoutLimits error
- *   V15. layoutLimits with a valid value → no error
- *
- * createCorrectResponseSession
- *   CR1. Instructor + mode≠evaluate → session with correct choiceId
- *   CR2. Student role → null
- *   CR3. Evaluate mode → null
- */
-export {};
-//# sourceMappingURL=index.test.d.ts.map

package/dist/controller/index.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/controller/index.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG"}

package/dist/delivery/AudioPlayer.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=AudioPlayer.test.d.ts.map

package/dist/delivery/AudioPlayer.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AudioPlayer.test.d.ts","sourceRoot":"","sources":["../../src/delivery/AudioPlayer.test.ts"],"names":[],"mappings":""}

package/dist/delivery/ChoiceRow.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=ChoiceRow.test.d.ts.map

package/dist/delivery/ChoiceRow.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ChoiceRow.test.d.ts","sourceRoot":"","sources":["../../src/delivery/ChoiceRow.test.ts"],"names":[],"mappings":""}

package/dist/delivery/ClozeMarker.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=ClozeMarker.test.d.ts.map

package/dist/delivery/ClozeMarker.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ClozeMarker.test.d.ts","sourceRoot":"","sources":["../../src/delivery/ClozeMarker.test.ts"],"names":[],"mappings":""}

package/dist/delivery/McPopulatedBlank.transcript.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=McPopulatedBlank.transcript.test.d.ts.map

package/dist/delivery/McPopulatedBlank.transcript.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"McPopulatedBlank.transcript.test.d.ts","sourceRoot":"","sources":["../../src/delivery/McPopulatedBlank.transcript.test.ts"],"names":[],"mappings":""}

package/dist/delivery/computeAudioMode.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=computeAudioMode.test.d.ts.map

package/dist/delivery/computeAudioMode.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"computeAudioMode.test.d.ts","sourceRoot":"","sources":["../../src/delivery/computeAudioMode.test.ts"],"names":[],"mappings":""}

package/dist/delivery/computeChoiceCorrectness.test.d.ts

@@ -1,19 +0,0 @@
-/**
- * Unit tests for computeChoiceCorrectness.
- *
- * This is the harness for extracting the choiceCorrectnessById state machine
- * from McPopulatedBlank.svelte. The function takes five pure inputs and returns
- * a Map — no component rendering required.
- *
- * Cases:
- *   C1. Not evaluate mode → empty map
- *   C2. Evaluate mode, no correctChoiceId → empty map
- *   C3. Reveal active, student chose correctly → { correctId: 'correct' } only
- *   C4. Reveal active, student chose wrong → { correctId: 'correct' } only (student badge suppressed)
- *   C5. Evaluate, unanswered → { correctId: 'incorrect' }
- *   C6. Evaluate, student chose correctly → { correctId: 'correct' }
- *   C7. Evaluate, student chose wrong → { studentId: 'incorrect', correctId: 'incorrect' }
- *   C8. Empty-string ids treated as "no selection" → C5 path, not C7
- */
-export {};
-//# sourceMappingURL=computeChoiceCorrectness.test.d.ts.map

package/dist/delivery/computeChoiceCorrectness.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"computeChoiceCorrectness.test.d.ts","sourceRoot":"","sources":["../../src/delivery/computeChoiceCorrectness.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/delivery/computeDisplayState.test.d.ts

@@ -1,38 +0,0 @@
-/**
- * Unit tests for computeDisplayState.
- *
- * computeFeatureAudioSkin
- *   A1. No locale, no overrides → default English skin
- *   A2. Spanish locale (es-MX) → built-in es skin
- *   A3. Exact locale match in byLocale → that skin
- *   A4. No exact match, lang prefix match (es) → lang skin
- *   A5. byLocale.default when no locale/lang match → byLocale.default skin
- *   A6. customSingle fallback when byLocale empty → customSingle
- *   A7. byLocale.default wins over customSingle
- *
- * computeDisplayChoiceId
- *   D1. Normal gather: returns selectedId
- *   D2. alwaysShowCorrect=true: returns correctChoiceId regardless
- *   D3. alwaysShowCorrect=true, no correctChoiceId: returns selectedId
- *   D4. evaluate + showCorrectAnswer=true: returns correctChoiceId
- *   D5. evaluate + showCorrectAnswer=false: returns selectedId
- *   D6. Not evaluate + showCorrectAnswer=true: returns selectedId (not overridden outside evaluate)
- *
- * computeResultText
- *   R1. Not evaluate mode → empty string
- *   R2. Evaluate + showCorrectAnswer=true → empty string (suppressed while reveal active)
- *   R3. Evaluate + correct → 'Correct answer selected'
- *   R4. Evaluate + incorrect + has selection → 'Incorrect answer selected'
- *   R5. Evaluate + incorrect + no selection → empty string (unanswered, no message)
- *   R6. Evaluate + unanswered (not correct, not incorrect) → empty string
- *
- * computeLegendText
- *   L1. Plain text prompt under limit → prompt text as-is
- *   L2. HTML prompt → tags stripped
- *   L3. Prompt over legendMaxChars → truncated with ellipsis
- *   L4. Empty prompt → answerChoicesLabel fallback
- *   L5. legendMaxChars < 8 → clamped to 8 before truncation
- *   L6. Whitespace-only prompt (after strip) → fallback
- */
-export {};
-//# sourceMappingURL=computeDisplayState.test.d.ts.map

package/dist/delivery/computeDisplayState.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"computeDisplayState.test.d.ts","sourceRoot":"","sources":["../../src/delivery/computeDisplayState.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG"}

package/dist/delivery/computeLayoutProfile.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=computeLayoutProfile.test.d.ts.map

package/dist/delivery/computeLayoutProfile.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"computeLayoutProfile.test.d.ts","sourceRoot":"","sources":["../../src/delivery/computeLayoutProfile.test.ts"],"names":[],"mappings":""}

package/dist/delivery/computeLayoutStyle.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=computeLayoutStyle.test.d.ts.map

package/dist/delivery/computeLayoutStyle.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"computeLayoutStyle.test.d.ts","sourceRoot":"","sources":["../../src/delivery/computeLayoutStyle.test.ts"],"names":[],"mappings":""}

package/src/author/Author.svelte

@@ -1,41 +0,0 @@
-<svelte:options
-  customElement={{
-    shadow: 'none',
-    props: {
-      model: { type: 'Object' },
-    },
-  }}
-/>
-
-<script lang="ts">
-// Keep the same prop shape expected by the wrapper.
-let { model = $bindable(), onChange }: { model?: any; onChange?: (model: any) => void } = $props();
-</script>
-
-<div class="mc-populated-blank-author-placeholder" role="status" aria-live="polite">
-  <p class="title">Author view placeholder</p>
-  <p class="body">This authoring interface is a placeholder and will be implemented later.</p>
-</div>
-
-<style>
-  .mc-populated-blank-author-placeholder {
-    max-width: 56rem;
-    margin: 24px auto;
-    padding: 20px;
-    border: 1px dashed #cbd5e1;
-    border-radius: 8px;
-    background: #f8fafc;
-    color: #334155;
-  }
-
-  .title {
-    margin: 0 0 8px;
-    font-size: 1rem;
-    font-weight: 600;
-  }
-
-  .body {
-    margin: 0;
-    font-size: 0.9rem;
-  }
-</style>

package/src/author/index.ts

@@ -1,28 +0,0 @@
-import AuthorComponent from './Author.svelte';
-
-const SvelteElementClass = (AuthorComponent as any).element;
-
-class McPopulatedBlankAuthor extends SvelteElementClass {
-  private _model: any = null;
-  private _onChange: ((model: any) => void) | null = null;
-
-  set model(m: any) {
-    this._model = m;
-    super.model = m;
-  }
-
-  get model() {
-    return this._model;
-  }
-
-  set onChange(fn: (model: any) => void) {
-    this._onChange = fn;
-    (this as any).onChange = fn;
-  }
-
-  get onChange() {
-    return this._onChange || (() => {});
-  }
-}
-
-export default McPopulatedBlankAuthor;

package/src/controller/defaults.ts

@@ -1,61 +0,0 @@
-import { DEFAULT_LAYOUT_LIMITS } from '../shared/layoutLimits';
-
-export { DEFAULT_LAYOUT_LIMITS };
-
-/** Token authors must include exactly once in `template` (HTML). */
-export const BLANK_TOKEN = '{{blank}}';
-
-export default {
-  model: {
-    id: '1',
-    element: 'mc-populated-blank',
-    prompt: '<p><strong>Demo prompt</strong></p>',
-    promptEnabled: true,
-    interactionMode: 'populate_blank' as const,
-    layoutProfile: '',
-    choiceLayout: '',
-    layoutProfilePresets: {},
-    layoutLimits: { ...DEFAULT_LAYOUT_LIMITS },
-    audioButtonSkin: null,
-    audioButtonSkinsByLocale: {},
-    uiText: {
-      answerChoices: 'Answer choices',
-      selectedAnswerInSentence: 'blank',
-      showCorrectAnswer: 'Show correct answer',
-      hideCorrectAnswer: 'Hide correct answer',
-      clickToEnableAutoplay: 'Click to enable audio autoplay',
-      audioResourceUnavailable: 'Audio is enabled but no playable audio URL is configured.',
-      transcriptLabel: 'Transcript',
-      listenLabelEn: 'Listen',
-      listenLabelEs: 'Escuchar',
-      listenSilentAlt: 'Repeat instructions',
-      listenPlayingAlt: 'Instructions are playing',
-      listenSilentAltEs: 'Escuchar. Repetir las instrucciones.',
-      listenPlayingAltEs: 'Escuchar. Estas son las instrucciones.',
-    },
-    sentenceHtml: '',
-    template: `<p>The answer is ${BLANK_TOKEN}.</p>`,
-    choiceMode: 'text' as const,
-    choices: [
-      { id: 'c1', labelHtml: '<p>Option A</p>' },
-      { id: 'c2', labelHtml: '<p>Option B</p>' },
-      { id: 'c3', labelHtml: '<p>Option C</p>' },
-    ],
-    correctChoiceId: 'c2',
-    hasAudio: false,
-    autoplayAudioEnabled: false,
-    completeAudioEnabled: false,
-    audioUrl: '',
-    audioTranscript: '',
-    showVisibleTranscript: false,
-    locale: '',
-    teacherInstructions: '',
-    teacherInstructionsEnabled: false,
-  },
-  configuration: {
-    prompt: {
-      label: 'Prompt',
-      settings: true,
-    },
-  },
-};