@pie-element/mc-populated-blank 0.2.13 → 0.3.0-next.11

package/README.md

@@ -56,12 +56,14 @@ Notes:
 - **`correctChoiceId`**
 - **`hasAudio`**, **`audioUrl`**, **`audioTranscript`** (`audioUrl` required when `hasAudio=true`)
 - **`autoplayAudioEnabled`**, **`completeAudioEnabled`** (optional integration flags)
-- **`showVisibleTranscript`** (optional): profile-driven default; override when transcript should always show/hide
 - **`layoutLimits`** (optional): numeric visual constraints; defaults are based on current CQT parity behavior and can be overridden per item
 - **`layoutProfilePresets`** (optional): named preset map by `layoutProfile`; use profile as a template and override with `layoutLimits`
 - **`audioButtonSkin`** / **`audioButtonSkinsByLocale`** (optional): override listen-button skin URLs
-- **`uiText`** (optional): override labels/messages (show/hide correct, answer choices, autoplay prompt, transcript label, missing-audio message)
+- **`language`** (optional): the language of the learner-facing strings (`en_US`, `es_ES`, …), which come from `@pie-lib/translator` as in the React elements; `locale` stands in when it is unset
 - **`choiceGroupLabel`** (optional): accessibility label used when no visible prompt is present
+- **`lockChoiceOrder`** (optional): `false` shuffles the choices for a student, as in multiple-choice; `shuffle: true` is the older spelling and counts only when `lockChoiceOrder` is unset
+- **`teacherInstructions`** and **`teacherInstructionsEnabled`** (optional): shown to instructors in view and evaluate mode, and in an instructor's printout; unset `teacherInstructionsEnabled` shows them
+- **`printAnswerKey`** (optional): `false` leaves the answer key out of an instructor's printout; a student's printout never has it
 
 ### `layoutLimits` keys (all optional, positive numbers)
 
@@ -73,8 +75,8 @@ Notes:
 - `horizontalChoiceWidthVw`
 - `horizontalChoiceTileMinHeightRem`
 - `horizontalChoiceContentMinHeightRem`
-- `selectedImageMaxHeightRem`
 - `choiceImageMaxHeightRem`
+- `choiceImageMaxWidthRem` (shared by the choice tile image and the selected-answer image inside the cloze blank, so they always render at the same size)
 - `listenButtonSizePx`
 - `stimulusMinColumnPx`
 - `textMinColumnPx`
@@ -113,9 +115,10 @@ Notes:
 - **Layout limits are model-driven:** delivery reads `model.layoutLimits` (blank widths/underline widths, choice tile sizing, image max heights, listen button size, layout column minimums); defaults are CQT-informed but overrideable.
 - **Responsive parity controls:** `audioInstructionsMaxWidthPx` and `narrowHorizontalChoiceMaxWidthPx` are explicitly configurable to tune desktop vs narrow-width CQT behavior.
 - **Evaluate mode behavior:** when evaluate/correct-answer mode is enabled, delivery can render `correctChoiceId` in the blank/choice state.
-- **Audio error behavior:** no TTS fallback is used; when `hasAudio=true` and no playable `audioUrl` is provided, delivery shows an explicit error message (configurable via `uiText.audioResourceUnavailable`).
+- **Audio error behavior:** no TTS fallback is used; when `hasAudio=true` and no playable `audioUrl` is provided, delivery shows an explicit error message.
 - **Prompt-off accessibility:** when `prompt` is empty, delivery uses `choiceGroupLabel` (or fallback UI text) as the radiogroup accessible name.
-- **Print parity:** print view mirrors prompt/template/choice presentation with the same blank-token contract.
+- **Print parity:** print renders the delivery component as a player shows the printout's `role` in `view` mode, with the choices in authored order; an instructor's key is the correct-response session, filling the blank and checking the key's choice. Teacher instructions print expanded, and audio prints as its URL and transcript in place of a player.
+- **Delivery renders no transcript:** it is an accessibility-catalog alternate, so on `pie-section-player` the assessment toolkit resolves the `transcript` card against the learner's personal needs profile and renders it in a labelled region above this element (PIE-902) — the same path signing takes. `model.audioTranscript` stays on the model for the print view, which has no toolkit, and as the source the Learnosity import writes the card from. A host that wants a transcript delivers the toolkit; there is no element-specific CSS class to apply.
 
 ## Theming hooks (`pie-*` classes)
 
@@ -137,7 +140,7 @@ To avoid runtime dependency on cross-origin Learnosity stylesheet loading, this
 - Variant mapping: `src/delivery/variant-css-map.ts`
 - Applied by `model.customType` (for example `sel_r1-_plusggg`)
 
-Each variant CSS file is intentionally scoped with `.mc-populated-blank-root.variant-*` selectors so styles only apply to this element instance and do not leak into other PIE elements.
+Every selector in a variant CSS file starts at `.mc-populated-blank-root` (`variant-css-scope.test.ts` enforces it), so the styles cannot leak into other PIE elements. At injection each root selector is narrowed to roots whose `data-mpb-css` carries a hash of this build's sheets, so two versions of the element on one page style only their own instances. The sheets go into the document head, or into the shadow root the element renders in.
 
 ### Maintenance workflow
 

package/author.js

@@ -0,0 +1,2 @@
+export { default } from './dist/author/index.js';
+export * from './dist/author/index.js';

package/configure.js

@@ -0,0 +1,2 @@
+export { default } from './dist/author/index.js';
+export * from './dist/author/index.js';

package/dist/author/defaults.d.ts

@@ -0,0 +1,74 @@
+/** The model a new item starts from: a valid question an author edits in place. */
+declare const _default: {
+    model: {
+        prompt: string;
+        template: string;
+        choices: {
+            id: string;
+            labelHtml: string;
+        }[];
+        correctChoiceId: string;
+        promptEnabled: boolean;
+        interactionMode: "populate_blank";
+        layoutProfile: string;
+        choiceLayout: string;
+        layoutProfilePresets: {};
+        layoutLimits: {
+            blankStandaloneWidthRem: number;
+            blankWideWidthRem: number;
+            blankUnderlineWidthPx: number;
+            blankUnderlineWideWidthPx: number;
+            horizontalChoiceWidthPx: number;
+            horizontalChoiceWidthVw: number;
+            horizontalChoiceTileMinHeightRem: number;
+            horizontalChoiceContentMinHeightRem: number;
+            choiceImageMaxHeightRem: number;
+            choiceImageMaxWidthRem: number;
+            listenButtonSizePx: number;
+            stimulusMinColumnPx: number;
+            textMinColumnPx: number;
+            legendMaxChars: number;
+            choiceGroupGapRem: number;
+            choiceRowGapRem: number;
+            toggleButtonGapRem: number;
+            horizontalChoiceRadioTopMarginRem: number;
+            audioBlankTemplateMarginTopRem: number;
+            audioBlankTemplateMarginBottomRem: number;
+            audioInstructionsMaxWidthPx: number;
+            narrowHorizontalChoiceMaxWidthPx: number;
+            stimulusGridColumnGapRem: number;
+            stimulusGridRowGapRem: number;
+            stimulusSentenceMarginTopRem: number;
+            stimulusChoicesMarginTopRem: number;
+            tokenGridColumnGapRem: number;
+            tokenGridRowGapRem: number;
+            tokenTemplateMarginTopRem: number;
+            tokenInlineTokenGapRem: number;
+            tokenChoicesMarginTopRem: number;
+            inlineGridColumnGapRem: number;
+            inlineGridRowGapRem: number;
+            inlineTemplateMarginTopRem: number;
+            inlineChoicesMarginTopRem: number;
+        };
+        audioButtonSkin: null;
+        audioButtonSkinsByLocale: {};
+        sentenceHtml: string;
+        choiceMode: "text";
+        choiceGroupLabel: string;
+        hasAudio: boolean;
+        autoplayAudioEnabled: boolean;
+        completeAudioEnabled: boolean;
+        audioUrl: string;
+        audioTranscript: string;
+        locale: string;
+        teacherInstructions: string;
+        teacherInstructionsEnabled: boolean;
+    };
+    configuration: {
+        prompt: {
+            label: string;
+            settings: boolean;
+        };
+    };
+};
+export default _default;

package/dist/author/index.d.ts

@@ -8,4 +8,3 @@ declare class McPopulatedBlankAuthor extends SvelteElementClass {
     get onChange(): (model: any) => void;
 }
 export default McPopulatedBlankAuthor;
-//# sourceMappingURL=index.d.ts.map