@qti-components/portable-custom-interaction 1.2.1-next.1 → 1.3.0

package/dist/interface.d.ts

@@ -9,10 +9,11 @@ export type PciInteractionStatus = 'interacting' | 'suspended' | 'closed' | 'sol
  * Correct response of a response declaration, mirroring `qti-correct-response`.
  *
  * `value` holds the authored `qti-value` content: a single value for `single`
- * cardinality, an array of values for every other cardinality.
+ * cardinality, a field map (`{ time: '4.0', point: '460 245' }`) for `record`
+ * cardinality, and an array of values for every other cardinality.
  */
 export interface PciCorrectResponse {
-    value: string | string[];
+    value: string | string[] | Record<string, string | string[] | null>;
 }
 /**
  * Response declaration passed into the `getInstance` configuration so a PCI can

package/dist/interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"interface.js","sourceRoot":"","sources":["../src/interface.ts"],"names":[],"mappings":"","sourcesContent":["import type { BaseType, Cardinality } from '@qti-components/base';\n\n/**\n * Shared status values for PCI lifecycle callbacks.\n *\n * Matches the status vocabulary used in IMS QTI 3 PCI documentation.\n */\nexport type PciInteractionStatus = 'interacting' | 'suspended' | 'closed' | 'solution' | 'review';\n\n/**\n * Correct response of a response declaration, mirroring `qti-correct-response`.\n *\n * `value` holds the authored `qti-value` content: a single value for `single`\n * cardinality, an array of values for every other cardinality.\n */\nexport interface PciCorrectResponse {\n  value: string | string[];\n}\n\n/**\n * Response declaration passed into the `getInstance` configuration so a PCI can\n * render a correct response itself when the item is in `solution` status.\n *\n * Mirrors `qti-response-declaration` with camelCased names. Every field is\n * optional, a delivery engine passes as much or as little as it has, and\n * `correctResponse` is absent when the response variable has none.\n *\n * `correctResponse` is also withheld while the candidate is still working: it is\n * only sent when `status` is `solution` or `review`, so a PCI never holds the\n * answer key during `interacting`.\n *\n * See https://github.com/1EdTech/qti-project-management/issues/210\n */\nexport interface PciResponseDeclaration {\n  baseType?: BaseType;\n  cardinality?: Cardinality;\n  correctResponse?: PciCorrectResponse;\n}\n\n/**\n * Payload passed to `onready` once a PCI reports it is ready.\n */\nexport interface PciReadyPayload {\n  responseIdentifier: string; // The response identifier of the PCI\n  status: PciInteractionStatus; // Current status\n}\n\n/**\n * Payload that may be passed to `ondone` when PCI finishes candidate interaction.\n */\nexport interface PciDonePayload {\n  responseIdentifier: string; // The response identifier of the PCI\n  status: PciInteractionStatus; // The final status after completion\n  outcome?: unknown; // Optional outcome data (e.g., score, correctness)\n}\n\n/**\n * Configuration object shape exposed to a PCI instance.\n *\n * Notes for authors:\n * - `properties` contains `data-*` attributes from the host element using dataset rules.\n * - `templateVariables`, `contextVariables`, and `boundTo` follow QTI Appendix-C style JSON values.\n * - `onready` must be called by the PCI once it is interactive.\n * - `ondone` is optional and may be used for explicit completion workflows.\n */\nexport interface ConfigProperties<T> {\n  properties: T; // Follows dataset conversion rules (camelCased keys)\n  templateVariables: Record<string, unknown>; // Follows structure in Appendix C\n  contextVariables: Record<string, unknown>; // Follows structure in Appendix C\n  boundTo: unknown; // Follows structure in Appendix C\n  responseIdentifier: string; // Unique within interaction scope\n  responseDeclaration?: PciResponseDeclaration; // Optional; carries correctResponse only when status is solution/review\n\n  onready: (payload: PciReadyPayload) => void; // Callback for when PCI is fully constructed and ready\n  ondone?: (payload: PciDonePayload) => void; // Optional callback when candidate finishes interaction\n\n  status?: PciInteractionStatus; // Optional, defaults to \"interacting\"\n}\n\n/**\n * IMS-style PCI factory and instance contract.\n *\n * A PCI module registers an object with a `typeIdentifier` and a `getInstance(...)` factory method.\n * The returned PCI instance should implement response/state read/write methods.\n */\nexport interface IMSpci<T> {\n  /**\n   * Stable PCI type key, expected to match `custom-interaction-type-identifier`.\n   */\n  typeIdentifier: string;\n\n  /** @access public\n   *  @method getInstance Create a new instance of this portable custom interaction\n   *  Will be called by the qtiCustomInteractionContext\n   *  @param {DOM Element} dom - the DOM Element this PCI is being added to\n   *  @param {Object} configuration - the configuration to apply to this PCI\n   *  @param {String} state - a previous saved state to apply to this instance.\n   *  This must have been obtained from a prior call to getState on an\n   *  instance of this type (same typeIdentifier)\n   */\n  getInstance: (dom: HTMLElement, configuration: Configuration<T>, state: string) => void;\n\n  /** @access public\n   * @method getResponse\n   * @return {Object} - the value to assign to the bound QTI response variable\n   */\n  getResponse: () => QtiVariableJSON | undefined;\n\n  /** @access public\n   * @method setResponse\n   * @param {Object} value - the value to assign to the bound QTI response variable\n   * NOTE: This is not an official QTI method, so no guarantee it is implemented\n   * in all PCIs.\n   */\n  setResponse: (value: QtiVariableJSON) => void;\n\n  /** @access public\n   * @method getState\n   * @return {String} The current state of this PCI. May be passed to\n   * getInstance to later restore this PCI instance.\n   * FIXME: host runtime can round-trip object states via prefixed JSON strings;\n   * this type remains `string` for IMS compatibility.\n   */\n  getState: () => string;\n\n  /** @access public\n   * @method setState\n   * @param {String} value - a state previously obtained from getState\n   * to restore this PCI instance to a prior state.\n   * FIXME: runtime may deserialize prefixed JSON state before applying it.\n   */\n  setState(value: string): unknown;\n\n  /**\n   * Optional teardown callback. If present, host may call before unload/cleanup.\n   */\n  oncompleted?: () => void;\n\n  /**\n   * Non-standard optional destroy hook; included for compatibility with legacy engines.\n   */\n  destroy?: () => void; // Not used in IMS and not in TAO implementation, so not used here (optional)\n}\n\n/**\n * Bridge callback signature used by this codebase for PCI registration.\n *\n * IMPORTANT:\n * - This type is intentionally minimal for existing call sites.\n * - Runtime initialization payload in `qti-portable-custom-interaction.ts` contains\n *   additional fields (`boundTo`, `templateVariables`, `contextVariables`, etc.).\n * FIXME: align this type with runtime payload to remove ambiguity in generated docs.\n */\nexport declare type Configuration<T> = {\n  onready: (pci: IMSpci<ConfigProperties<T>>, state?: string) => void;\n  properties: T;\n  // PK: following this: https://www.imsglobal.org/spec/qti/v3p0/impl#h.1mc9puik2ft6\n  // All below are not used in the IMS Reference implementation, keeping for ref\n  /*    \n  ondone: (pci: IMSPci<T>,response:any,state:string, status?: \"interacting\" | \"closed\" | \"solution\" | \"review\" ) => void;\n  status: string;\n  templateVariables: any;  \n  boundTo: any;\n  contextVariables\n  responseIdentifier\n  */\n};\n\n/**\n * QTI base-type `file` representation.\n */\nexport type QtiFileData = {\n  data: string;\n  mime: string;\n  name?: string;\n};\n\nexport type QtiBaseBoolean = boolean;\nexport type QtiBaseInteger = number;\nexport type QtiBaseFloat = number;\nexport type QtiBaseString = string;\nexport type QtiBasePoint = [number, number];\nexport type QtiBasePair = [string, string];\nexport type QtiBaseDirectedPair = [string, string];\nexport type QtiBaseDuration = string; // ISO 8601 duration format\nexport type QtiBaseFile = QtiFileData;\nexport type QtiBaseUri = string;\nexport type QtiBaseIntOrIdentifier = number | string;\nexport type QtiBaseIdentifier = string;\n\n/**\n * Convenience union for primitive response values used by this implementation.\n */\nexport type ResponseType =\n  | boolean\n  | number\n  | string\n  | QtiBasePair\n  | QtiBasePoint\n  | QtiFileData\n  | Array<boolean | number | string | QtiBasePair | QtiBasePoint | QtiFileData>;\n\n/**\n * A QTI record entry for `record` cardinality values.\n */\nexport type QtiRecordItem = {\n  name: string;\n  base?: QtiBaseTypeJSON | null;\n  list?: QtiListTypeJSON | null;\n};\nexport type ResponseVariableType = QtiVariableJSON;\n\n/**\n * QTI Appendix-C style JSON representation for base cardinality.\n */\nexport type QtiBaseTypeJSON = {\n  boolean?: QtiBaseBoolean;\n  integer?: QtiBaseInteger;\n  float?: QtiBaseFloat;\n  string?: QtiBaseString;\n  point?: QtiBasePoint;\n  pair?: QtiBasePair;\n  directedPair?: QtiBaseDirectedPair;\n  duration?: QtiBaseDuration;\n  file?: QtiBaseFile;\n  uri?: QtiBaseUri;\n  intOrIdentifier?: QtiBaseIntOrIdentifier;\n  identifier?: QtiBaseIdentifier;\n} | null;\n\n/**\n * QTI Appendix-C style JSON representation for list cardinality.\n */\nexport type QtiListTypeJSON = {\n  boolean?: QtiBaseBoolean[];\n  integer?: QtiBaseInteger[];\n  float?: QtiBaseFloat[];\n  string?: QtiBaseString[];\n  point?: QtiBasePoint[];\n  pair?: QtiBasePair[];\n  directedPair?: QtiBaseDirectedPair[];\n  duration?: QtiBaseDuration[];\n  file?: QtiBaseFile[];\n  uri?: QtiBaseUri[];\n  intOrIdentifier?: QtiBaseIntOrIdentifier[];\n  identifier?: QtiBaseIdentifier[];\n} | null;\n\n/**\n * Complete QTI variable JSON envelope used by PCI bridge messaging.\n */\nexport declare type QtiVariableJSON = {\n  base?: QtiBaseTypeJSON;\n  list?: QtiListTypeJSON;\n  record?: QtiRecordItem[] | null;\n};\n\n/**\n * RequireJS module resolution config accepted by helper utilities and stories.\n */\nexport interface ModuleResolutionConfig {\n  waitSeconds?: number;\n  context?: string;\n  catchError?: boolean;\n  paths: {\n    [key: string]: string | string[];\n  };\n  shim?: {\n    [key: string]: {\n      deps?: string[]; // Array of dependencies\n      exports?: string; // The global variable to use as the module's value\n    };\n  };\n}\n"]}
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../src/interface.ts"],"names":[],"mappings":"","sourcesContent":["import type { BaseType, Cardinality } from '@qti-components/base';\n\n/**\n * Shared status values for PCI lifecycle callbacks.\n *\n * Matches the status vocabulary used in IMS QTI 3 PCI documentation.\n */\nexport type PciInteractionStatus = 'interacting' | 'suspended' | 'closed' | 'solution' | 'review';\n\n/**\n * Correct response of a response declaration, mirroring `qti-correct-response`.\n *\n * `value` holds the authored `qti-value` content: a single value for `single`\n * cardinality, a field map (`{ time: '4.0', point: '460 245' }`) for `record`\n * cardinality, and an array of values for every other cardinality.\n */\nexport interface PciCorrectResponse {\n  value: string | string[] | Record<string, string | string[] | null>;\n}\n\n/**\n * Response declaration passed into the `getInstance` configuration so a PCI can\n * render a correct response itself when the item is in `solution` status.\n *\n * Mirrors `qti-response-declaration` with camelCased names. Every field is\n * optional, a delivery engine passes as much or as little as it has, and\n * `correctResponse` is absent when the response variable has none.\n *\n * `correctResponse` is also withheld while the candidate is still working: it is\n * only sent when `status` is `solution` or `review`, so a PCI never holds the\n * answer key during `interacting`.\n *\n * See https://github.com/1EdTech/qti-project-management/issues/210\n */\nexport interface PciResponseDeclaration {\n  baseType?: BaseType;\n  cardinality?: Cardinality;\n  correctResponse?: PciCorrectResponse;\n}\n\n/**\n * Payload passed to `onready` once a PCI reports it is ready.\n */\nexport interface PciReadyPayload {\n  responseIdentifier: string; // The response identifier of the PCI\n  status: PciInteractionStatus; // Current status\n}\n\n/**\n * Payload that may be passed to `ondone` when PCI finishes candidate interaction.\n */\nexport interface PciDonePayload {\n  responseIdentifier: string; // The response identifier of the PCI\n  status: PciInteractionStatus; // The final status after completion\n  outcome?: unknown; // Optional outcome data (e.g., score, correctness)\n}\n\n/**\n * Configuration object shape exposed to a PCI instance.\n *\n * Notes for authors:\n * - `properties` contains `data-*` attributes from the host element using dataset rules.\n * - `templateVariables`, `contextVariables`, and `boundTo` follow QTI Appendix-C style JSON values.\n * - `onready` must be called by the PCI once it is interactive.\n * - `ondone` is optional and may be used for explicit completion workflows.\n */\nexport interface ConfigProperties<T> {\n  properties: T; // Follows dataset conversion rules (camelCased keys)\n  templateVariables: Record<string, unknown>; // Follows structure in Appendix C\n  contextVariables: Record<string, unknown>; // Follows structure in Appendix C\n  boundTo: unknown; // Follows structure in Appendix C\n  responseIdentifier: string; // Unique within interaction scope\n  responseDeclaration?: PciResponseDeclaration; // Optional; carries correctResponse only when status is solution/review\n\n  onready: (payload: PciReadyPayload) => void; // Callback for when PCI is fully constructed and ready\n  ondone?: (payload: PciDonePayload) => void; // Optional callback when candidate finishes interaction\n\n  status?: PciInteractionStatus; // Optional, defaults to \"interacting\"\n}\n\n/**\n * IMS-style PCI factory and instance contract.\n *\n * A PCI module registers an object with a `typeIdentifier` and a `getInstance(...)` factory method.\n * The returned PCI instance should implement response/state read/write methods.\n */\nexport interface IMSpci<T> {\n  /**\n   * Stable PCI type key, expected to match `custom-interaction-type-identifier`.\n   */\n  typeIdentifier: string;\n\n  /** @access public\n   *  @method getInstance Create a new instance of this portable custom interaction\n   *  Will be called by the qtiCustomInteractionContext\n   *  @param {DOM Element} dom - the DOM Element this PCI is being added to\n   *  @param {Object} configuration - the configuration to apply to this PCI\n   *  @param {String} state - a previous saved state to apply to this instance.\n   *  This must have been obtained from a prior call to getState on an\n   *  instance of this type (same typeIdentifier)\n   */\n  getInstance: (dom: HTMLElement, configuration: Configuration<T>, state: string) => void;\n\n  /** @access public\n   * @method getResponse\n   * @return {Object} - the value to assign to the bound QTI response variable\n   */\n  getResponse: () => QtiVariableJSON | undefined;\n\n  /** @access public\n   * @method setResponse\n   * @param {Object} value - the value to assign to the bound QTI response variable\n   * NOTE: This is not an official QTI method, so no guarantee it is implemented\n   * in all PCIs.\n   */\n  setResponse: (value: QtiVariableJSON) => void;\n\n  /** @access public\n   * @method getState\n   * @return {String} The current state of this PCI. May be passed to\n   * getInstance to later restore this PCI instance.\n   * FIXME: host runtime can round-trip object states via prefixed JSON strings;\n   * this type remains `string` for IMS compatibility.\n   */\n  getState: () => string;\n\n  /** @access public\n   * @method setState\n   * @param {String} value - a state previously obtained from getState\n   * to restore this PCI instance to a prior state.\n   * FIXME: runtime may deserialize prefixed JSON state before applying it.\n   */\n  setState(value: string): unknown;\n\n  /**\n   * Optional teardown callback. If present, host may call before unload/cleanup.\n   */\n  oncompleted?: () => void;\n\n  /**\n   * Non-standard optional destroy hook; included for compatibility with legacy engines.\n   */\n  destroy?: () => void; // Not used in IMS and not in TAO implementation, so not used here (optional)\n}\n\n/**\n * Bridge callback signature used by this codebase for PCI registration.\n *\n * IMPORTANT:\n * - This type is intentionally minimal for existing call sites.\n * - Runtime initialization payload in `qti-portable-custom-interaction.ts` contains\n *   additional fields (`boundTo`, `templateVariables`, `contextVariables`, etc.).\n * FIXME: align this type with runtime payload to remove ambiguity in generated docs.\n */\nexport declare type Configuration<T> = {\n  onready: (pci: IMSpci<ConfigProperties<T>>, state?: string) => void;\n  properties: T;\n  // PK: following this: https://www.imsglobal.org/spec/qti/v3p0/impl#h.1mc9puik2ft6\n  // All below are not used in the IMS Reference implementation, keeping for ref\n  /*    \n  ondone: (pci: IMSPci<T>,response:any,state:string, status?: \"interacting\" | \"closed\" | \"solution\" | \"review\" ) => void;\n  status: string;\n  templateVariables: any;  \n  boundTo: any;\n  contextVariables\n  responseIdentifier\n  */\n};\n\n/**\n * QTI base-type `file` representation.\n */\nexport type QtiFileData = {\n  data: string;\n  mime: string;\n  name?: string;\n};\n\nexport type QtiBaseBoolean = boolean;\nexport type QtiBaseInteger = number;\nexport type QtiBaseFloat = number;\nexport type QtiBaseString = string;\nexport type QtiBasePoint = [number, number];\nexport type QtiBasePair = [string, string];\nexport type QtiBaseDirectedPair = [string, string];\nexport type QtiBaseDuration = string; // ISO 8601 duration format\nexport type QtiBaseFile = QtiFileData;\nexport type QtiBaseUri = string;\nexport type QtiBaseIntOrIdentifier = number | string;\nexport type QtiBaseIdentifier = string;\n\n/**\n * Convenience union for primitive response values used by this implementation.\n */\nexport type ResponseType =\n  | boolean\n  | number\n  | string\n  | QtiBasePair\n  | QtiBasePoint\n  | QtiFileData\n  | Array<boolean | number | string | QtiBasePair | QtiBasePoint | QtiFileData>;\n\n/**\n * A QTI record entry for `record` cardinality values.\n */\nexport type QtiRecordItem = {\n  name: string;\n  base?: QtiBaseTypeJSON | null;\n  list?: QtiListTypeJSON | null;\n};\nexport type ResponseVariableType = QtiVariableJSON;\n\n/**\n * QTI Appendix-C style JSON representation for base cardinality.\n */\nexport type QtiBaseTypeJSON = {\n  boolean?: QtiBaseBoolean;\n  integer?: QtiBaseInteger;\n  float?: QtiBaseFloat;\n  string?: QtiBaseString;\n  point?: QtiBasePoint;\n  pair?: QtiBasePair;\n  directedPair?: QtiBaseDirectedPair;\n  duration?: QtiBaseDuration;\n  file?: QtiBaseFile;\n  uri?: QtiBaseUri;\n  intOrIdentifier?: QtiBaseIntOrIdentifier;\n  identifier?: QtiBaseIdentifier;\n} | null;\n\n/**\n * QTI Appendix-C style JSON representation for list cardinality.\n */\nexport type QtiListTypeJSON = {\n  boolean?: QtiBaseBoolean[];\n  integer?: QtiBaseInteger[];\n  float?: QtiBaseFloat[];\n  string?: QtiBaseString[];\n  point?: QtiBasePoint[];\n  pair?: QtiBasePair[];\n  directedPair?: QtiBaseDirectedPair[];\n  duration?: QtiBaseDuration[];\n  file?: QtiBaseFile[];\n  uri?: QtiBaseUri[];\n  intOrIdentifier?: QtiBaseIntOrIdentifier[];\n  identifier?: QtiBaseIdentifier[];\n} | null;\n\n/**\n * Complete QTI variable JSON envelope used by PCI bridge messaging.\n */\nexport declare type QtiVariableJSON = {\n  base?: QtiBaseTypeJSON;\n  list?: QtiListTypeJSON;\n  record?: QtiRecordItem[] | null;\n};\n\n/**\n * RequireJS module resolution config accepted by helper utilities and stories.\n */\nexport interface ModuleResolutionConfig {\n  waitSeconds?: number;\n  context?: string;\n  catchError?: boolean;\n  paths: {\n    [key: string]: string | string[];\n  };\n  shim?: {\n    [key: string]: {\n      deps?: string[]; // Array of dependencies\n      exports?: string; // The global variable to use as the module's value\n    };\n  };\n}\n"]}

package/dist/qti-portable-custom-interaction.d.ts

@@ -1,7 +1,13 @@
 import { Interaction } from '@qti-components/base';
 import type { CSSResultGroup } from 'lit';
-import type { BaseType, Cardinality, ItemContext, QtiContext } from '@qti-components/base';
+import type { BaseType, Cardinality, ItemContext, QtiContext, RecordValue } from '@qti-components/base';
 import type { PciInteractionStatus, PciResponseDeclaration, QtiVariableJSON, ResponseVariableType } from './interface';
+/** Text for an inline `<script>`: a `</script` inside it would end the element early. */
+export declare const inlineScriptText: (text: string) => string;
+/** Text for an inline `<style>`: a `</style` inside it would end the element early. */
+export declare const inlineStyleText: (text: string) => string;
+/** A response value as this interaction holds it: a record response is its field map. */
+type PciResponseValue = string | string[] | RecordValue;
 export declare class QtiPortableCustomInteraction extends Interaction {
     #private;
     protected _iframeLoaded: boolean;
@@ -17,6 +23,7 @@ export declare class QtiPortableCustomInteraction extends Interaction {
     customInteractionTypeIdentifier: string;
     requirePathsJson: string;
     requireShimJson: string;
+    /** A RequireJS to load in the iframe instead of the inlined copy (src/vendor/require-js.ts). */
     requireJsUrl: string;
     baseUrl: string;
     useDefaultPaths: boolean;
@@ -44,10 +51,6 @@ export declare class QtiPortableCustomInteraction extends Interaction {
      * Get direct child elements by tag name
      */
     private getDirectChildrenByTag;
-    /**
-     * Coerce a scalar value to the expected base-type when possible
-     */
-    private coerceBaseValue;
     /**
      * Normalize an input into a list form
      */
@@ -56,14 +59,6 @@ export declare class QtiPortableCustomInteraction extends Interaction {
      * Convert a variable value to QtiVariableJSON
      */
     private variableToQtiVariableJSON;
-    /**
-     * Convert a record object into QtiVariableJSON
-     */
-    private recordToQtiVariableJSON;
-    /**
-     * Build a record entry from an arbitrary value
-     */
-    private recordEntryFromValue;
     /**
      * Extract default QTI_CONTEXT values from qti-context-declaration elements
      */
@@ -83,7 +78,7 @@ export declare class QtiPortableCustomInteraction extends Interaction {
     /**
      * Converts response variables to QtiVariableJSON
      */
-    protected responseVariablesToQtiVariableJSON(input: string | string[], cardinality: Cardinality, baseType: BaseType): QtiVariableJSON;
+    protected responseVariablesToQtiVariableJSON(input: PciResponseValue, cardinality: Cardinality, baseType: BaseType, fieldBaseTypes?: Record<string, BaseType>): QtiVariableJSON;
     validate(): boolean;
     set value(v: string | null);
     get value(): string | null;
@@ -123,3 +118,4 @@ declare global {
         'qti-portable-custom-interaction': QtiPortableCustomInteraction;
     }
 }
+export {};

package/dist/qti-portable-custom-interaction.js

@@ -7,20 +7,31 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { css, html } from 'lit';
 import { property, state } from 'lit/decorators.js';
 import { consume } from '@lit/context';
-import { Interaction, itemContext, qtiContext, removeDoubleSlashes, responseAttributeConverter } from '@qti-components/base';
+import { Interaction, isRecordValue, itemContext, qtiContext, readRecordFieldValues, removeDoubleSlashes, responseAttributeConverter } from '@qti-components/base';
+import nativeCss from '@qti-components/theme/native-css';
 import styles from './qti-portable-custom-interaction.styles';
+import { coerceBaseValue, recordFromQtiVariableJSON, recordResponseToQtiVariableJSON, recordToQtiVariableJSON } from './record-response';
+import requireJsSource from './vendor/require-js';
+/** Text for an inline `<script>`: a `</script` inside it would end the element early. */
+export const inlineScriptText = (text) => text.replace(/<\/(script)/gi, '<\\/$1');
+/** Text for an inline `<style>`: a `</style` inside it would end the element early. */
+export const inlineStyleText = (text) => text.replace(/<\/(style)/gi, '<\\/$1');
 /** Statuses in which the item is showing the correct response, so a PCI may legitimately see it. */
 const STATUSES_SHOWING_CORRECT_RESPONSE = ['solution', 'review'];
 /**
  * Whether a response variable actually declares a correct response.
  *
  * Non-single cardinality yields `[]` for an empty `<qti-correct-response>`, which is "no correct
- * response" and must not be reported as one.
+ * response" and must not be reported as one. A record's correct response is a field map.
  */
 function hasCorrectResponseValue(value) {
     if (value === null || value === undefined)
         return false;
-    return Array.isArray(value) ? value.length > 0 : value !== '';
+    if (Array.isArray(value))
+        return value.length > 0;
+    if (isRecordValue(value))
+        return Object.keys(value).length > 0;
+    return value !== '';
 }
 export class QtiPortableCustomInteraction extends Interaction {
     constructor() {
@@ -31,7 +42,8 @@ export class QtiPortableCustomInteraction extends Interaction {
         this._iframeMessageOrigin = null;
         this.requirePathsJson = '';
         this.requireShimJson = '';
-        this.requireJsUrl = 'https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.6/require.min.js';
+        /** A RequireJS to load in the iframe instead of the inlined copy (src/vendor/require-js.ts). */
+        this.requireJsUrl = '';
         this.baseUrl = '';
         this.useDefaultPaths = false;
         /**
@@ -132,15 +144,19 @@ export class QtiPortableCustomInteraction extends Interaction {
                     // Treat null/undefined or unconvertible responses as "cleared".
                     // The iframe side is responsible for not emitting an initial clear on load.
                     if (converted === null) {
-                        const emptyResponse = this.responseVariable?.cardinality === 'single' ? '' : [];
+                        const cardinality = this.responseVariable?.cardinality;
+                        // A record has no empty literal: a cleared record is NULL.
+                        const emptyResponse = cardinality === 'record' ? null : cardinality === 'single' ? '' : [];
                         this.response = emptyResponse;
                         this.validate();
                         this.saveResponse(emptyResponse, state);
                         break;
                     }
-                    this.response = converted;
+                    // A record response travels as its field map; the shared response types only say string | string[].
+                    const response = converted;
+                    this.response = response;
                     this.validate();
-                    this.saveResponse(converted, state);
+                    this.saveResponse(response, state);
                     break;
                 }
                 case 'error':
@@ -271,9 +287,13 @@ export class QtiPortableCustomInteraction extends Interaction {
         return this.#getRequireShim();
     }
     /**
-     * Converts QtiVariableJSON to a string or string array
+     * Converts QtiVariableJSON to a string, a string array, or for a record its field map
      */
     #convertQtiVariableJSON(input) {
+        if (input && Array.isArray(input.record)) {
+            const record = recordFromQtiVariableJSON(input.record);
+            return Object.keys(record).length ? record : null;
+        }
         for (const topLevelKey in input) {
             // eslint-disable-next-line no-prototype-builtins
             if (input.hasOwnProperty(topLevelKey)) {
@@ -303,44 +323,6 @@ export class QtiPortableCustomInteraction extends Interaction {
         const needle = tagName.toLowerCase();
         return Array.from(this.children).filter(child => child.tagName.toLowerCase() === needle);
     }
-    /**
-     * Coerce a scalar value to the expected base-type when possible
-     */
-    coerceBaseValue(value, baseType) {
-        if (value === null || value === undefined)
-            return value;
-        switch (baseType) {
-            case 'integer': {
-                if (typeof value === 'number')
-                    return value;
-                const parsed = parseInt(String(value), 10);
-                return Number.isNaN(parsed) ? value : parsed;
-            }
-            case 'float':
-            case 'duration': {
-                if (typeof value === 'number')
-                    return value;
-                const parsed = parseFloat(String(value));
-                return Number.isNaN(parsed) ? value : parsed;
-            }
-            case 'boolean': {
-                if (typeof value === 'boolean')
-                    return value;
-                if (typeof value === 'string') {
-                    const lowered = value.toLowerCase();
-                    if (lowered === 'true')
-                        return true;
-                    if (lowered === 'false')
-                        return false;
-                }
-                return value;
-            }
-            case 'string':
-            case 'identifier':
-            default:
-                return String(value);
-        }
-    }
     /**
      * Normalize an input into a list form
      */
@@ -354,63 +336,13 @@ export class QtiPortableCustomInteraction extends Interaction {
      */
     variableToQtiVariableJSON(value, cardinality, baseType) {
         if (cardinality === 'record' || baseType === 'record') {
-            return this.recordToQtiVariableJSON(value);
+            return recordToQtiVariableJSON(value);
         }
         if (cardinality !== 'single') {
-            const listValues = this.normalizeListValue(value).map(v => this.coerceBaseValue(v, baseType));
+            const listValues = this.normalizeListValue(value).map(v => coerceBaseValue(v, baseType));
             return { list: { [baseType]: listValues } };
         }
-        return { base: { [baseType]: this.coerceBaseValue(value, baseType) } };
-    }
-    /**
-     * Convert a record object into QtiVariableJSON
-     */
-    recordToQtiVariableJSON(value) {
-        if (!value || typeof value !== 'object') {
-            return { record: [] };
-        }
-        const recordEntries = [];
-        for (const [name, entryValue] of Object.entries(value)) {
-            recordEntries.push(this.recordEntryFromValue(name, entryValue));
-        }
-        return { record: recordEntries };
-    }
-    /**
-     * Build a record entry from an arbitrary value
-     */
-    recordEntryFromValue(name, entryValue) {
-        if (Array.isArray(entryValue)) {
-            const filtered = entryValue.filter(v => v !== null && v !== undefined);
-            if (filtered.length && filtered.every(v => typeof v === 'boolean')) {
-                return { name, list: { boolean: filtered } };
-            }
-            if (filtered.length && filtered.every(v => typeof v === 'number')) {
-                const numbers = filtered;
-                const isIntegers = numbers.every(n => Number.isInteger(n));
-                return { name, list: { [isIntegers ? 'integer' : 'float']: numbers } };
-            }
-            return { name, list: { string: entryValue.map(v => (v === null || v === undefined ? '' : String(v))) } };
-        }
-        if (typeof entryValue === 'boolean') {
-            return { name, base: { boolean: entryValue } };
-        }
-        if (typeof entryValue === 'number') {
-            if (Number.isInteger(entryValue))
-                return { name, base: { integer: entryValue } };
-            return { name, base: { float: entryValue } };
-        }
-        if (entryValue === null || entryValue === undefined) {
-            return { name, base: { string: '' } };
-        }
-        if (typeof entryValue === 'object') {
-            try {
-                return { name, base: { string: JSON.stringify(entryValue) } };
-            }
-            catch {
-                return { name, base: { string: String(entryValue) } };
-            }
-        }
-        return { name, base: { string: String(entryValue) } };
+        return { base: { [baseType]: coerceBaseValue(value, baseType) } };
     }
     /**
      * Extract default QTI_CONTEXT values from qti-context-declaration elements
@@ -425,15 +357,10 @@ export class QtiPortableCustomInteraction extends Interaction {
             const defaultValueElement = declaration.querySelector('qti-default-value');
             if (!defaultValueElement)
                 return;
-            const valueElements = defaultValueElement.querySelectorAll('qti-value[field-identifier]');
-            valueElements.forEach(valueElement => {
-                const fieldIdentifier = valueElement.getAttribute('field-identifier');
-                if (!fieldIdentifier)
-                    return;
-                const baseType = (valueElement.getAttribute('base-type') || 'string');
-                const textContent = valueElement.textContent?.trim() || '';
-                defaults[fieldIdentifier] = this.coerceBaseValue(textContent, baseType);
-            });
+            const { value, baseTypes } = readRecordFieldValues(defaultValueElement.querySelectorAll('qti-value'));
+            for (const [fieldIdentifier, textContent] of Object.entries(value)) {
+                defaults[fieldIdentifier] = coerceBaseValue(textContent, baseTypes[fieldIdentifier] ?? 'string');
+            }
         });
         return defaults;
     }
@@ -452,7 +379,7 @@ export class QtiPortableCustomInteraction extends Interaction {
             environmentIdentifier: merged.environmentIdentifier ?? '',
             ...merged
         };
-        return this.recordToQtiVariableJSON(normalized);
+        return recordToQtiVariableJSON(normalized);
     }
     /**
      * Collect template variables referenced by qti-template-variable children
@@ -545,7 +472,11 @@ export class QtiPortableCustomInteraction extends Interaction {
     /**
      * Converts response variables to QtiVariableJSON
      */
-    responseVariablesToQtiVariableJSON(input, cardinality, baseType) {
+    responseVariablesToQtiVariableJSON(input, cardinality, baseType, fieldBaseTypes) {
+        if (cardinality === 'record') {
+            // A record declaration has no base-type: the fields carry their own, declared or inferred.
+            return recordResponseToQtiVariableJSON(input, fieldBaseTypes);
+        }
         if (cardinality !== 'single') {
             const list = { list: {} };
             list.list[baseType] = input;
@@ -560,6 +491,9 @@ export class QtiPortableCustomInteraction extends Interaction {
     #hasNonEmptyResponse() {
         if (this.response === null || this.response === undefined)
             return false;
+        if (isRecordValue(this.response)) {
+            return Object.values(this.response).some(v => v !== '' && v !== null && v !== undefined);
+        }
         if (Array.isArray(this.response)) {
             if (this.response.length === 0)
                 return false;
@@ -590,6 +524,8 @@ export class QtiPortableCustomInteraction extends Interaction {
     get value() {
         if (this.#value === null || this.#value === undefined)
             return null;
+        if (isRecordValue(this.#value))
+            return JSON.stringify(this.#value);
         return Array.isArray(this.#value) ? this.#value.join(',') : String(this.#value);
     }
     set boundTo(newValue) {
@@ -606,10 +542,11 @@ export class QtiPortableCustomInteraction extends Interaction {
         const responseVariable = {};
         const variable = this.context?.variables?.find(v => v.identifier === this.responseIdentifier);
         if (variable) {
-            const cardinality = this.context?.variables?.find(v => v.identifier === this.responseIdentifier)?.cardinality || 'single';
-            const baseType = this.context?.variables?.find(v => v.identifier === this.responseIdentifier)?.baseType || 'string';
-            const value = this.context?.variables?.find(v => v.identifier === this.responseIdentifier)?.value || null;
-            const responseVal = this.responseVariablesToQtiVariableJSON(value, cardinality, baseType);
+            const cardinality = variable.cardinality || 'single';
+            const baseType = variable.baseType || 'string';
+            const value = (variable.value || null);
+            const fieldBaseTypes = variable.fieldBaseTypes;
+            const responseVal = this.responseVariablesToQtiVariableJSON(value, cardinality, baseType, fieldBaseTypes);
             responseVariable[this.responseIdentifier] = responseVal;
         }
         return responseVariable;
@@ -825,15 +762,15 @@ export class QtiPortableCustomInteraction extends Interaction {
                 : `${iframeBaseUrl}/`
             : `${window.location.origin}/`;
         const forwardConsole = this.dataset.forwardConsole === 'true';
-        const isLocalhost = window.location.hostname === 'localhost' || window.location.hostname === '127.0.0.1';
-        const defaultComponentsCdnUrl = isLocalhost
-            ? `${window.location.origin}/cdn/index.js`
-            : 'https://unpkg.com/@citolab/qti-components/cdn';
-        const defaultComponentsCssUrl = isLocalhost
-            ? `${window.location.origin}/dist/item.css`
-            : 'https://unpkg.com/@citolab/qti-components@latest/dist/item.css';
-        const componentsCdnUrl = this.dataset.componentsCdnUrl || defaultComponentsCdnUrl;
-        const componentsCssUrl = this.dataset.componentsCssUrl || defaultComponentsCssUrl;
+        // Everything the iframe needs is inline: RequireJS (it loads the PCI module) and the QTI 3 shared vocabulary
+        // (qti-layout-row, qti-well, …) that interaction markup may use, both from this version of qti-components. No
+        // public CDN is involved. The qti-components bundle and the full item.css are not needed to run a PCI (the markup
+        // is plain HTML); a host that wants them in the iframe anyway names its own copy with these attributes.
+        const componentsCdnUrl = this.dataset.componentsCdnUrl;
+        const componentsCssUrl = this.dataset.componentsCssUrl;
+        const requireJsTag = this.requireJsUrl
+            ? `<script src="${this.requireJsUrl}"></script>`
+            : `<script>${inlineScriptText(requireJsSource)}</script>`;
         // Extract just the font-related properties you want to copy
         const fontStyles = `
     font-family: ${parentStyles.getPropertyValue('font-family')};
@@ -842,15 +779,20 @@ export class QtiPortableCustomInteraction extends Interaction {
     font-weight: ${parentStyles.getPropertyValue('font-weight')};
     color: ${parentStyles.getPropertyValue('color')};
   `;
+        // The language of the interaction (the item's xml:lang, or the page's lang), so a PCI that reads
+        // `lang` in its iframe shows its own texts in the item's language.
+        const langHost = this.closest('[lang], [xml\\:lang]');
+        const iframeLang = [langHost?.getAttribute('lang'), langHost?.getAttribute('xml:lang'), document.documentElement.lang]
+            .map(l => (l ?? '').trim())
+            .find(l => /^[A-Za-z]{1,8}(-[A-Za-z0-9]{1,8})*$/.test(l)) ?? 'en';
         return /* html */ `<!DOCTYPE html>
-      <html lang="en">
+      <html lang="${iframeLang}">
         <head>
           <meta charset="utf-8" />
           <title>QTI PCI Container</title>
           <base href="${iframeBaseHref}" />
-          <script type="module">
-            import '${componentsCdnUrl}';
-          </script>
+          ${componentsCdnUrl ? `<script type="module">import '${componentsCdnUrl}';</script>` : ''}
+          <style>${inlineStyleText(nativeCss)}</style>
           <style>
             body, html {
               margin: 0;
@@ -874,8 +816,8 @@ export class QtiPortableCustomInteraction extends Interaction {
               min-height: 50px;
             }
           </style>
-          <link href="${componentsCssUrl}" rel="stylesheet" />
-          <script src="${this.requireJsUrl}"></script>
+          ${componentsCssUrl ? `<link href="${componentsCssUrl}" rel="stylesheet" />` : ''}
+          ${requireJsTag}
           <script>
             const forwardConsole = ${forwardConsole ? 'true' : 'false'};
             if (forwardConsole) {