@citolab/qti-components 7.0.3 → 7.0.4

package/dist/item.css

@@ -3478,76 +3478,8 @@ qti-response-declaration {
   }
 
   qti-slider-interaction {
-    display: block;
-
     --qti-tick-color: rgb(229 231 235 / 100%);
     --qti-tick-width: 1px;
-
-    &::part(slider) {
-      margin-left: 2rem; /* mx-8 */
-      margin-right: 2rem;
-      padding-bottom: 1rem; /* pb-4 */
-      padding-top: 1.25rem; /* pt-5 */
-    }
-
-    --show-bounds: true;
-
-    &::part(bounds) {
-      display: flex;
-      width: 100%;
-      justify-content: space-between;
-      margin-bottom: 0.5rem; /* mb-2 */
-    }
-
-    --show-ticks: true;
-
-    &::part(ticks) {
-      margin-left: 0.125rem; /* mx-0.5 */
-      margin-right: 0.125rem;
-      margin-bottom: 0.25rem; /* mb-1 */
-      height: 0.5rem; /* h-2 */
-      background: linear-gradient(to right, var(--qti-tick-color) var(--qti-tick-width), transparent 1px) repeat-x 0
-        center / calc(calc(100% - var(--qti-tick-width)) / ((var(--max) - var(--min)) / var(--step))) 100%;
-    }
-
-    &::part(rail) {
-      display: flex;
-      align-items: center;
-      box-sizing: border-box;
-      height: 0.375rem; /* h-1.5 */
-      width: 100%;
-      cursor: pointer;
-      border-radius: 9999px; /* rounded-full */
-      border: 1px solid #d1d5db; /* border-gray-300 */
-      background-color: #e5e7eb; /* bg-gray-200 */
-    }
-
-    &::part(knob) {
-      background-color: var(--qti-primary);
-      position: relative;
-      height: 1rem; /* h-4 */
-      width: 1rem; /* w-4 */
-      transform-origin: center;
-      transform: translateX(-50%);
-      cursor: pointer;
-      border-radius: 9999px; /* rounded-full */
-      left: var(--value-percentage);
-    }
-
-    --show-value: true;
-
-    &::part(value) {
-      position: absolute;
-      bottom: 2rem; /* bottom-8 */
-      left: 0.5rem; /* left-2 */
-      transform: translateX(-50%);
-      cursor: pointer;
-      border-radius: 0.25rem; /* rounded */
-      background-color: #f3f4f6; /* bg-gray-100 */
-      padding: 0.25rem 0.5rem; /* px-2 py-1 */
-      text-align: center;
-      color: #6b7280; /* text-gray-500 */
-    }
   }
 
   qti-select-point-interaction {

package/dist/loader/index.d.ts

@@ -1,4 +1,4 @@
-import { e as QtiAssessmentItem } from '../qti-simple-choice-UTrFa_RQ.js';
+import { e as QtiAssessmentItem } from '../qti-simple-choice-D0GiMrqD.js';
 import 'lit-html';
 import 'lit';
 import 'lit-html/directives/ref.js';

package/dist/loader/index.js

@@ -250,6 +250,7 @@ var qtiTransformTest = () => {
       return new Promise((resolve, _) => {
         loadXML(uri).then((xml2) => {
           xmlFragment = xml2;
+          api.path(uri.substring(0, uri.lastIndexOf("/")));
           return resolve(api);
         });
       });
@@ -258,6 +259,10 @@ var qtiTransformTest = () => {
       xmlFragment = parseXML(xmlString);
       return api;
     },
+    path: (location) => {
+      setLocation(xmlFragment, location);
+      return api;
+    },
     fn(fn) {
       fn(xmlFragment);
       return api;

package/dist/loader/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/qti-transformers/qti-transformers.ts","../../src/lib/qti-transformers/qti-transform-item.ts","../../src/lib/qti-transformers/qti-transform-manifest.ts","../../src/lib/qti-transformers/qti-transform-test.ts","../../src/lib/qti-loader/qti-loader.ts"],"sourcesContent":["const xml = String.raw;\n\n/*   <!-- convert CDATA to comments -->\n  <xsl:template match=\"text()[contains(., 'CDATA')]\">\n  <xsl:comment>\n    <xsl:value-of select=\".\"/>\n  </xsl:comment>\n</xsl:template>\n*/\n\n/*\n  <!-- remove xml comments -->\n  <xsl:template match=\"comment()\" />\n  */\n\nconst xmlToHTML = xml`<xsl:stylesheet version=\"1.0\" xmlns:xsl=\"http://www.w3.org/1999/XSL/Transform\">\n<xsl:output method=\"html\" version=\"5.0\" encoding=\"UTF-8\" indent=\"yes\" />\n  <xsl:template match=\"@*|node()\">\n    <xsl:copy>\n      <xsl:apply-templates select=\"@*|node()\"/>\n    </xsl:copy>\n  </xsl:template>\n\n  <!-- remove existing namespaces -->\n  <xsl:template match=\"*\">\n    <!-- remove element prefix -->\n    <xsl:element name=\"{local-name()}\">\n      <!-- process attributes -->\n      <xsl:for-each select=\"@*\">\n        <!-- remove attribute prefix -->\n        <xsl:attribute name=\"{local-name()}\">\n          <xsl:value-of select=\".\"/>\n        </xsl:attribute>\n      </xsl:for-each>\n    <xsl:apply-templates/>\n  </xsl:element>\n</xsl:template>\n</xsl:stylesheet>`;\n\n// Function to extend elements with a specific tag name by adding an extension suffix\nexport function extendElementName(xmlFragment: XMLDocument, tagName: string, extension: string) {\n  xmlFragment.querySelectorAll(tagName).forEach(element => {\n    const newTagName = `${tagName}-${extension}`;\n    const newElement = createElementWithNewTagName(element, newTagName);\n    element.replaceWith(newElement);\n  });\n}\n\n// Function to extend any element with a specific class pattern (e.g., \"extend:suffix\")\nexport function extendElementsWithClass(xmlFragment: XMLDocument, classNamePattern: string) {\n  xmlFragment.querySelectorAll('*').forEach(element => {\n    const classList = element.classList;\n    if (classList) {\n      classList.forEach(className => {\n        if (className.startsWith(`${classNamePattern}:`)) {\n          const suffix = className.slice(`${classNamePattern}:`.length);\n          const newTagName = `${element.nodeName}-${suffix}`;\n          const newElement = createElementWithNewTagName(element, newTagName);\n          element.replaceWith(newElement);\n        }\n      });\n    }\n  });\n}\n\n// Helper function to create a new element with a new tag name and copy attributes and children\nfunction createElementWithNewTagName(element, newTagName) {\n  const newElement = document.createElement(newTagName);\n  // Copy attributes\n  for (const attr of element.attributes) {\n    newElement.setAttribute(attr.name, attr.value);\n  }\n  // Copy child nodes\n  while (element.firstChild) {\n    newElement.appendChild(element.firstChild);\n  }\n  return newElement;\n}\n\nexport function itemsFromTest(xmlFragment: DocumentFragment) {\n  const items: { identifier: string; href: string; category: string }[] = [];\n  xmlFragment.querySelectorAll('qti-assessment-item-ref').forEach(el => {\n    const identifier = el.getAttribute('identifier');\n    const href = el.getAttribute('href');\n    const category = el.getAttribute('category');\n    items.push({ identifier, href, category });\n  });\n  return items;\n}\n\nlet currentRequest: XMLHttpRequest | null = null;\n\nexport function loadXML(url, cancelPreviousRequest = false) {\n  if (cancelPreviousRequest && currentRequest !== null) {\n    currentRequest.abort(); // Abort the ongoing request if there is one\n  }\n\n  return new Promise<XMLDocument | null>((resolve, reject) => {\n    const xhr = new XMLHttpRequest();\n    currentRequest = xhr; // Store the current request\n\n    xhr.open('GET', url, true);\n    xhr.responseType = 'document';\n\n    xhr.onload = () => {\n      if (xhr.status >= 200 && xhr.status < 300) {\n        resolve(xhr.responseXML);\n      } else {\n        reject(xhr.statusText);\n      }\n    };\n\n    xhr.onerror = () => {\n      reject(xhr.statusText);\n    };\n\n    xhr.send();\n  });\n}\n\nexport function parseXML(xmlDocument: string) {\n  const parser = new DOMParser();\n  const xmlFragment = parser.parseFromString(xmlDocument, 'text/xml');\n  return xmlFragment;\n}\n\nexport function toHTML(xmlFragment: Document): DocumentFragment {\n  const processor = new XSLTProcessor();\n  const xsltDocument = new DOMParser().parseFromString(xmlToHTML, 'text/xml');\n  processor.importStylesheet(xsltDocument);\n  const itemHTMLFragment = processor.transformToFragment(xmlFragment, document);\n  return itemHTMLFragment;\n}\n\nexport function setLocation(xmlFragment: DocumentFragment, location: string) {\n  if (!location.endsWith('/')) {\n    location += '/';\n  }\n\n  xmlFragment.querySelectorAll('[src],[href],[primary-path]').forEach(elWithSrc => {\n    let attr: 'src' | 'href' | 'primary-path' | '' = '';\n\n    if (elWithSrc.getAttribute('src')) {\n      attr = 'src';\n    }\n    if (elWithSrc.getAttribute('href')) {\n      attr = 'href';\n    }\n    if (elWithSrc.getAttribute('primary-path')) {\n      attr = 'primary-path';\n    }\n    const attrValue = elWithSrc.getAttribute(attr)?.trim();\n\n    if (!attrValue.startsWith('data:') && !attrValue.startsWith('http')) {\n      const newSrcValue = location + encodeURI(attrValue);\n      elWithSrc.setAttribute(attr, newSrcValue);\n    }\n  });\n}\n\nexport function convertCDATAtoComment(xmlFragment: DocumentFragment) {\n  const cdataElements = xmlFragment.querySelectorAll('qti-custom-operator[class=\"js.org\"] > qti-base-value');\n  cdataElements.forEach(element => {\n    const commentText = document.createComment(element.textContent);\n    element.replaceChild(commentText, element.firstChild);\n  });\n}\n\nexport function stripStyleSheets(xmlFragment: DocumentFragment) {\n  // remove qti-stylesheet tag\n  xmlFragment.querySelectorAll('qti-stylesheet').forEach(stylesheet => stylesheet.remove());\n}\n","/**\n * Browser based QTI-XML to HTML transformer.\n * Returns an object with methods to load, parse, transform and serialize QTI XML items.\n * @returns An object with methods to load, parse, transform and serialize QTI XML items.\n * @example\n * const qtiTransformer = qtiTransformItem();\n * await qtiTransformer.load('path/to/xml/file.xml');\n * qtiTransformer.path('/assessmentItem/itemBody');\n * const html = qtiTransformer.html();\n * const xml = qtiTransformer.xml();\n * const htmldoc = qtiTransformer.htmldoc();\n * const xmldoc = qtiTransformer.xmldoc();\n *\n * qtiTransformItem().parse(storyXML).html()\n */\n\nimport {\n  convertCDATAtoComment,\n  extendElementName,\n  extendElementsWithClass,\n  loadXML,\n  parseXML,\n  setLocation,\n  stripStyleSheets,\n  toHTML\n} from './qti-transformers';\n\nexport type transformItemApi = {\n  load: (uri: string, cancelPreviousRequest?: boolean) => Promise<transformItemApi>;\n  parse: (xmlString: string) => transformItemApi;\n  path: (location: string) => transformItemApi;\n  fn: (fn: (xmlFragment: XMLDocument) => void) => transformItemApi;\n  pciHooks: (uri: string) => transformItemApi;\n  extendElementName: (elementName: string, extend: string) => transformItemApi;\n  extendElementsWithClass: (param?: string) => transformItemApi;\n  customInteraction: (baseRef: string, baseItem: string) => transformItemApi;\n  convertCDATAtoComment: () => transformItemApi;\n  stripStyleSheets: () => transformItemApi;\n  html: () => string;\n  xml: () => string;\n  htmlDoc: () => DocumentFragment;\n  xmlDoc: () => XMLDocument;\n};\n\nexport const qtiTransformItem = () => {\n  let xmlFragment: XMLDocument;\n\n  const api: transformItemApi = {\n    async load(uri: string, cancelPreviousRequest = false): Promise<typeof api> {\n      return new Promise<typeof api>(resolve => {\n        loadXML(uri, cancelPreviousRequest).then(xml => {\n          xmlFragment = xml;\n          // set the base path for images and other resources,\n          // you probably want to set the base path to the document root else you can use the path method to set it\n          api.path(uri.substring(0, uri.lastIndexOf('/')));\n          return resolve(api);\n        });\n      });\n    },\n    parse(xmlString: string): typeof api {\n      xmlFragment = parseXML(xmlString);\n      return api;\n    },\n    path: (location: string): typeof api => {\n      setLocation(xmlFragment, location);\n      return api;\n    },\n    fn(fn: (xmlFragment: XMLDocument) => void): typeof api {\n      fn(xmlFragment);\n      return api;\n    },\n    pciHooks(uri: string): typeof api {\n      const attributes = ['hook', 'module'];\n      const documentPath = uri.substring(0, uri.lastIndexOf('/'));\n      for (const attribute of attributes) {\n        const srcAttributes = xmlFragment.querySelectorAll('[' + attribute + ']');\n        srcAttributes.forEach(node => {\n          const srcValue = node.getAttribute(attribute)!;\n          if (!srcValue.startsWith('data:') && !srcValue.startsWith('http')) {\n            // Just paste the relative path of the src location after the documentrootPath\n            // old pcis can have a .js, new pci's don't\n            node.setAttribute('base-url', uri);\n            node.setAttribute(\n              'module',\n              documentPath + '/' + encodeURI(srcValue + (srcValue.endsWith('.js') ? '' : '.js'))\n            );\n          }\n        });\n      }\n      return api;\n    },\n    extendElementName: (tagName: string, extension: string): typeof api => {\n      extendElementName(xmlFragment, tagName, extension);\n      return api;\n    },\n    extendElementsWithClass: (param: string = 'extend'): typeof api => {\n      extendElementsWithClass(xmlFragment, param);\n      return api;\n    },\n    customInteraction(baseRef: string, baseItem: string): typeof api {\n      const qtiCustomInteraction = xmlFragment.querySelector('qti-custom-interaction');\n      const qtiCustomInteractionObject = qtiCustomInteraction.querySelector('object');\n\n      qtiCustomInteraction.setAttribute('data-base-ref', baseRef);\n      qtiCustomInteraction.setAttribute('data-base-item', baseRef + baseItem);\n      qtiCustomInteraction.setAttribute('data', qtiCustomInteractionObject.getAttribute('data'));\n      qtiCustomInteraction.setAttribute('width', qtiCustomInteractionObject.getAttribute('width'));\n      qtiCustomInteraction.setAttribute('height', qtiCustomInteractionObject.getAttribute('height'));\n\n      qtiCustomInteraction.removeChild(qtiCustomInteractionObject);\n      return api;\n    },\n    convertCDATAtoComment(): typeof api {\n      convertCDATAtoComment(xmlFragment);\n      return api;\n    },\n    stripStyleSheets(): typeof api {\n      stripStyleSheets(xmlFragment);\n      return api;\n    },\n    html() {\n      return new XMLSerializer().serializeToString(toHTML(xmlFragment));\n    },\n    xml(): string {\n      return new XMLSerializer().serializeToString(xmlFragment);\n    },\n    htmlDoc() {\n      return toHTML(xmlFragment);\n    },\n    xmlDoc(): XMLDocument {\n      return xmlFragment; // new XMLSerializer().serializeToString(xmlFragment);\n    }\n  };\n  return api;\n};\n","import { loadXML, parseXML } from './qti-transformers';\n\nexport const qtiTransformManifest = (): {\n  load: (uri: string) => Promise<typeof api>;\n  assessmentTest: () => { href: string; identifier: string };\n} => {\n  let xmlFragment: XMLDocument;\n\n  const api = {\n    async load(uri) {\n      return new Promise<typeof api>(resolve => {\n        loadXML(uri).then(xml => {\n          xmlFragment = xml;\n          return resolve(api);\n        });\n      });\n    },\n    parse(xmlString: string) {\n      xmlFragment = parseXML(xmlString);\n    },\n    assessmentTest() {\n      const el = xmlFragment.querySelector('resource[type=\"imsqti_test_xmlv3p0\"]');\n      return { href: el.getAttribute('href'), identifier: el.getAttribute('identifier') };\n    }\n  };\n  return api;\n};\n","/**\n * Returns an object with methods to load, parse and transform QTI tests.\n * @returns An object with methods to load, parse and transform QTI tests.\n * @example\n * const qtiTransformer = qtiTransformTest();\n * await qtiTransformer.load('https://example.com/test.xml');\n * const items = qtiTransformer.items();\n * const html = qtiTransformer.html();\n * const xml = qtiTransformer.xml();\n */\n\nimport { itemsFromTest, loadXML, parseXML, toHTML } from './qti-transformers';\n\nexport type transformTestApi = {\n  load: (uri: string) => Promise<transformTestApi>;\n  parse: (xmlString: string) => transformTestApi;\n  fn: (fn: (xmlFragment: XMLDocument) => void) => transformTestApi;\n  items: () => { identifier: string; href: string; category: string }[];\n  html: () => string;\n  xml: () => string;\n  htmlDoc: () => DocumentFragment;\n  xmlDoc: () => XMLDocument;\n};\n\nexport const qtiTransformTest = (): transformTestApi => {\n  let xmlFragment: XMLDocument;\n\n  const api: transformTestApi = {\n    async load(uri) {\n      return new Promise<transformTestApi>((resolve, _) => {\n        loadXML(uri).then(xml => {\n          xmlFragment = xml;\n          return resolve(api);\n        });\n      });\n    },\n    parse(xmlString: string) {\n      xmlFragment = parseXML(xmlString);\n      return api;\n    },\n    fn(fn: (xmlFragment: XMLDocument) => void) {\n      fn(xmlFragment);\n      return api;\n    },\n    items() {\n      return itemsFromTest(xmlFragment);\n    },\n    html() {\n      return new XMLSerializer().serializeToString(toHTML(xmlFragment));\n    },\n    xml(): string {\n      return new XMLSerializer().serializeToString(xmlFragment);\n    },\n    htmlDoc() {\n      return toHTML(xmlFragment);\n    },\n    xmlDoc(): XMLDocument {\n      return xmlFragment;\n    }\n  };\n  return api;\n};\n","import { QtiAssessmentItem } from '../qti-components';\nimport { qtiTransformItem, qtiTransformTest } from '../qti-transformers';\nimport { qtiTransformManifest } from '../qti-transformers/qti-transform-manifest';\n\nexport type ManifestInfo = {\n  testIdentifier: string;\n  testHTMLDoc: DocumentFragment;\n  testURI: string;\n  testURL: string;\n  items: {\n    identifier: string;\n    href: string;\n    category: string;\n  }[];\n};\n\n// Utility function to ensure package URIs end with a '/'\n// const normalizeUri = (uri: string) => (uri.endsWith('/') ? uri : `${uri}/`);\n\n// Fetches assessment data from the manifest\nexport const getManifestInfo = async (manifestURL: string): Promise<ManifestInfo> => {\n  const baseURI = manifestURL.substring(0, manifestURL.lastIndexOf('/'));\n\n  const test = await qtiTransformManifest()\n    .load(`${manifestURL}`)\n    .then(api => api.assessmentTest());\n\n  const testHTMLDoc = await qtiTransformTest()\n    .load(`${baseURI}/${test.href}`)\n    .then(api => api.htmlDoc());\n\n  const items = await qtiTransformTest()\n    .load(`${baseURI}/${test.href}`)\n    .then(api => api.items());\n\n  const testURL = `${baseURI}/${test.href}`;\n  const testURI = `${baseURI}/${test.href.substring(0, test.href.lastIndexOf('/'))}`;\n\n  return {\n    testHTMLDoc,\n    testURI,\n    testURL,\n    items,\n    testIdentifier: test.identifier\n  };\n};\n\n// Fetches a single item by URI\nexport const getItemByUri = async (itemUri: string): Promise<QtiAssessmentItem> =>\n  qtiTransformItem()\n    .load(itemUri)\n    .then(api => api.htmlDoc().firstElementChild as QtiAssessmentItem);\n"],"mappings":"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","names":["xml","xml","xml"]}
+{"version":3,"sources":["../../src/lib/qti-transformers/qti-transformers.ts","../../src/lib/qti-transformers/qti-transform-item.ts","../../src/lib/qti-transformers/qti-transform-manifest.ts","../../src/lib/qti-transformers/qti-transform-test.ts","../../src/lib/qti-loader/qti-loader.ts"],"sourcesContent":["const xml = String.raw;\n\n/*   <!-- convert CDATA to comments -->\n  <xsl:template match=\"text()[contains(., 'CDATA')]\">\n  <xsl:comment>\n    <xsl:value-of select=\".\"/>\n  </xsl:comment>\n</xsl:template>\n*/\n\n/*\n  <!-- remove xml comments -->\n  <xsl:template match=\"comment()\" />\n  */\n\nconst xmlToHTML = xml`<xsl:stylesheet version=\"1.0\" xmlns:xsl=\"http://www.w3.org/1999/XSL/Transform\">\n<xsl:output method=\"html\" version=\"5.0\" encoding=\"UTF-8\" indent=\"yes\" />\n  <xsl:template match=\"@*|node()\">\n    <xsl:copy>\n      <xsl:apply-templates select=\"@*|node()\"/>\n    </xsl:copy>\n  </xsl:template>\n\n  <!-- remove existing namespaces -->\n  <xsl:template match=\"*\">\n    <!-- remove element prefix -->\n    <xsl:element name=\"{local-name()}\">\n      <!-- process attributes -->\n      <xsl:for-each select=\"@*\">\n        <!-- remove attribute prefix -->\n        <xsl:attribute name=\"{local-name()}\">\n          <xsl:value-of select=\".\"/>\n        </xsl:attribute>\n      </xsl:for-each>\n    <xsl:apply-templates/>\n  </xsl:element>\n</xsl:template>\n</xsl:stylesheet>`;\n\n// Function to extend elements with a specific tag name by adding an extension suffix\nexport function extendElementName(xmlFragment: XMLDocument, tagName: string, extension: string) {\n  xmlFragment.querySelectorAll(tagName).forEach(element => {\n    const newTagName = `${tagName}-${extension}`;\n    const newElement = createElementWithNewTagName(element, newTagName);\n    element.replaceWith(newElement);\n  });\n}\n\n// Function to extend any element with a specific class pattern (e.g., \"extend:suffix\")\nexport function extendElementsWithClass(xmlFragment: XMLDocument, classNamePattern: string) {\n  xmlFragment.querySelectorAll('*').forEach(element => {\n    const classList = element.classList;\n    if (classList) {\n      classList.forEach(className => {\n        if (className.startsWith(`${classNamePattern}:`)) {\n          const suffix = className.slice(`${classNamePattern}:`.length);\n          const newTagName = `${element.nodeName}-${suffix}`;\n          const newElement = createElementWithNewTagName(element, newTagName);\n          element.replaceWith(newElement);\n        }\n      });\n    }\n  });\n}\n\n// Helper function to create a new element with a new tag name and copy attributes and children\nfunction createElementWithNewTagName(element, newTagName) {\n  const newElement = document.createElement(newTagName);\n  // Copy attributes\n  for (const attr of element.attributes) {\n    newElement.setAttribute(attr.name, attr.value);\n  }\n  // Copy child nodes\n  while (element.firstChild) {\n    newElement.appendChild(element.firstChild);\n  }\n  return newElement;\n}\n\nexport function itemsFromTest(xmlFragment: DocumentFragment) {\n  const items: { identifier: string; href: string; category: string }[] = [];\n  xmlFragment.querySelectorAll('qti-assessment-item-ref').forEach(el => {\n    const identifier = el.getAttribute('identifier');\n    const href = el.getAttribute('href');\n    const category = el.getAttribute('category');\n    items.push({ identifier, href, category });\n  });\n  return items;\n}\n\nlet currentRequest: XMLHttpRequest | null = null;\n\nexport function loadXML(url, cancelPreviousRequest = false) {\n  if (cancelPreviousRequest && currentRequest !== null) {\n    currentRequest.abort(); // Abort the ongoing request if there is one\n  }\n\n  return new Promise<XMLDocument | null>((resolve, reject) => {\n    const xhr = new XMLHttpRequest();\n    currentRequest = xhr; // Store the current request\n\n    xhr.open('GET', url, true);\n    xhr.responseType = 'document';\n\n    xhr.onload = () => {\n      if (xhr.status >= 200 && xhr.status < 300) {\n        resolve(xhr.responseXML);\n      } else {\n        reject(xhr.statusText);\n      }\n    };\n\n    xhr.onerror = () => {\n      reject(xhr.statusText);\n    };\n\n    xhr.send();\n  });\n}\n\nexport function parseXML(xmlDocument: string) {\n  const parser = new DOMParser();\n  const xmlFragment = parser.parseFromString(xmlDocument, 'text/xml');\n  return xmlFragment;\n}\n\nexport function toHTML(xmlFragment: Document): DocumentFragment {\n  const processor = new XSLTProcessor();\n  const xsltDocument = new DOMParser().parseFromString(xmlToHTML, 'text/xml');\n  processor.importStylesheet(xsltDocument);\n  const itemHTMLFragment = processor.transformToFragment(xmlFragment, document);\n  return itemHTMLFragment;\n}\n\nexport function setLocation(xmlFragment: DocumentFragment, location: string) {\n  if (!location.endsWith('/')) {\n    location += '/';\n  }\n\n  xmlFragment.querySelectorAll('[src],[href],[primary-path]').forEach(elWithSrc => {\n    let attr: 'src' | 'href' | 'primary-path' | '' = '';\n\n    if (elWithSrc.getAttribute('src')) {\n      attr = 'src';\n    }\n    if (elWithSrc.getAttribute('href')) {\n      attr = 'href';\n    }\n    if (elWithSrc.getAttribute('primary-path')) {\n      attr = 'primary-path';\n    }\n    const attrValue = elWithSrc.getAttribute(attr)?.trim();\n\n    if (!attrValue.startsWith('data:') && !attrValue.startsWith('http')) {\n      const newSrcValue = location + encodeURI(attrValue);\n      elWithSrc.setAttribute(attr, newSrcValue);\n    }\n  });\n}\n\nexport function convertCDATAtoComment(xmlFragment: DocumentFragment) {\n  const cdataElements = xmlFragment.querySelectorAll('qti-custom-operator[class=\"js.org\"] > qti-base-value');\n  cdataElements.forEach(element => {\n    const commentText = document.createComment(element.textContent);\n    element.replaceChild(commentText, element.firstChild);\n  });\n}\n\nexport function stripStyleSheets(xmlFragment: DocumentFragment) {\n  // remove qti-stylesheet tag\n  xmlFragment.querySelectorAll('qti-stylesheet').forEach(stylesheet => stylesheet.remove());\n}\n","/**\n * Browser based QTI-XML to HTML transformer.\n * Returns an object with methods to load, parse, transform and serialize QTI XML items.\n * @returns An object with methods to load, parse, transform and serialize QTI XML items.\n * @example\n * const qtiTransformer = qtiTransformItem();\n * await qtiTransformer.load('path/to/xml/file.xml');\n * qtiTransformer.path('/assessmentItem/itemBody');\n * const html = qtiTransformer.html();\n * const xml = qtiTransformer.xml();\n * const htmldoc = qtiTransformer.htmldoc();\n * const xmldoc = qtiTransformer.xmldoc();\n *\n * qtiTransformItem().parse(storyXML).html()\n */\n\nimport {\n  convertCDATAtoComment,\n  extendElementName,\n  extendElementsWithClass,\n  loadXML,\n  parseXML,\n  setLocation,\n  stripStyleSheets,\n  toHTML\n} from './qti-transformers';\n\nexport type transformItemApi = {\n  load: (uri: string, cancelPreviousRequest?: boolean) => Promise<transformItemApi>;\n  parse: (xmlString: string) => transformItemApi;\n  path: (location: string) => transformItemApi;\n  fn: (fn: (xmlFragment: XMLDocument) => void) => transformItemApi;\n  pciHooks: (uri: string) => transformItemApi;\n  extendElementName: (elementName: string, extend: string) => transformItemApi;\n  extendElementsWithClass: (param?: string) => transformItemApi;\n  customInteraction: (baseRef: string, baseItem: string) => transformItemApi;\n  convertCDATAtoComment: () => transformItemApi;\n  stripStyleSheets: () => transformItemApi;\n  html: () => string;\n  xml: () => string;\n  htmlDoc: () => DocumentFragment;\n  xmlDoc: () => XMLDocument;\n};\n\nexport const qtiTransformItem = () => {\n  let xmlFragment: XMLDocument;\n\n  const api: transformItemApi = {\n    async load(uri: string, cancelPreviousRequest = false): Promise<typeof api> {\n      return new Promise<typeof api>(resolve => {\n        loadXML(uri, cancelPreviousRequest).then(xml => {\n          xmlFragment = xml;\n          // set the base path for images and other resources,\n          // you probably want to set the base path to the document root else you can use the path method to set it\n          api.path(uri.substring(0, uri.lastIndexOf('/')));\n          return resolve(api);\n        });\n      });\n    },\n    parse(xmlString: string): typeof api {\n      xmlFragment = parseXML(xmlString);\n      return api;\n    },\n    path: (location: string): typeof api => {\n      setLocation(xmlFragment, location);\n      return api;\n    },\n    fn(fn: (xmlFragment: XMLDocument) => void): typeof api {\n      fn(xmlFragment);\n      return api;\n    },\n    pciHooks(uri: string): typeof api {\n      const attributes = ['hook', 'module'];\n      const documentPath = uri.substring(0, uri.lastIndexOf('/'));\n      for (const attribute of attributes) {\n        const srcAttributes = xmlFragment.querySelectorAll('[' + attribute + ']');\n        srcAttributes.forEach(node => {\n          const srcValue = node.getAttribute(attribute)!;\n          if (!srcValue.startsWith('data:') && !srcValue.startsWith('http')) {\n            // Just paste the relative path of the src location after the documentrootPath\n            // old pcis can have a .js, new pci's don't\n            node.setAttribute('base-url', uri);\n            node.setAttribute(\n              'module',\n              documentPath + '/' + encodeURI(srcValue + (srcValue.endsWith('.js') ? '' : '.js'))\n            );\n          }\n        });\n      }\n      return api;\n    },\n    extendElementName: (tagName: string, extension: string): typeof api => {\n      extendElementName(xmlFragment, tagName, extension);\n      return api;\n    },\n    extendElementsWithClass: (param: string = 'extend'): typeof api => {\n      extendElementsWithClass(xmlFragment, param);\n      return api;\n    },\n    customInteraction(baseRef: string, baseItem: string): typeof api {\n      const qtiCustomInteraction = xmlFragment.querySelector('qti-custom-interaction');\n      const qtiCustomInteractionObject = qtiCustomInteraction.querySelector('object');\n\n      qtiCustomInteraction.setAttribute('data-base-ref', baseRef);\n      qtiCustomInteraction.setAttribute('data-base-item', baseRef + baseItem);\n      qtiCustomInteraction.setAttribute('data', qtiCustomInteractionObject.getAttribute('data'));\n      qtiCustomInteraction.setAttribute('width', qtiCustomInteractionObject.getAttribute('width'));\n      qtiCustomInteraction.setAttribute('height', qtiCustomInteractionObject.getAttribute('height'));\n\n      qtiCustomInteraction.removeChild(qtiCustomInteractionObject);\n      return api;\n    },\n    convertCDATAtoComment(): typeof api {\n      convertCDATAtoComment(xmlFragment);\n      return api;\n    },\n    stripStyleSheets(): typeof api {\n      stripStyleSheets(xmlFragment);\n      return api;\n    },\n    html() {\n      return new XMLSerializer().serializeToString(toHTML(xmlFragment));\n    },\n    xml(): string {\n      return new XMLSerializer().serializeToString(xmlFragment);\n    },\n    htmlDoc() {\n      return toHTML(xmlFragment);\n    },\n    xmlDoc(): XMLDocument {\n      return xmlFragment; // new XMLSerializer().serializeToString(xmlFragment);\n    }\n  };\n  return api;\n};\n","import { loadXML, parseXML } from './qti-transformers';\n\nexport const qtiTransformManifest = (): {\n  load: (uri: string) => Promise<typeof api>;\n  assessmentTest: () => { href: string; identifier: string };\n} => {\n  let xmlFragment: XMLDocument;\n\n  const api = {\n    async load(uri) {\n      return new Promise<typeof api>(resolve => {\n        loadXML(uri).then(xml => {\n          xmlFragment = xml;\n          return resolve(api);\n        });\n      });\n    },\n    parse(xmlString: string) {\n      xmlFragment = parseXML(xmlString);\n    },\n    assessmentTest() {\n      const el = xmlFragment.querySelector('resource[type=\"imsqti_test_xmlv3p0\"]');\n      return { href: el.getAttribute('href'), identifier: el.getAttribute('identifier') };\n    }\n  };\n  return api;\n};\n","/**\n * Returns an object with methods to load, parse and transform QTI tests.\n * @returns An object with methods to load, parse and transform QTI tests.\n * @example\n * const qtiTransformer = qtiTransformTest();\n * await qtiTransformer.load('https://example.com/test.xml');\n * const items = qtiTransformer.items();\n * const html = qtiTransformer.html();\n * const xml = qtiTransformer.xml();\n */\n\nimport { itemsFromTest, loadXML, parseXML, setLocation, toHTML } from './qti-transformers';\n\nexport type transformTestApi = {\n  load: (uri: string) => Promise<transformTestApi>;\n  parse: (xmlString: string) => transformTestApi;\n  path: (location: string) => transformTestApi;\n  fn: (fn: (xmlFragment: XMLDocument) => void) => transformTestApi;\n  items: () => { identifier: string; href: string; category: string }[];\n  html: () => string;\n  xml: () => string;\n  htmlDoc: () => DocumentFragment;\n  xmlDoc: () => XMLDocument;\n};\n\nexport const qtiTransformTest = (): transformTestApi => {\n  let xmlFragment: XMLDocument;\n\n  const api: transformTestApi = {\n    async load(uri) {\n      return new Promise<transformTestApi>((resolve, _) => {\n        loadXML(uri).then(xml => {\n          xmlFragment = xml;\n\n          api.path(uri.substring(0, uri.lastIndexOf('/')));\n          return resolve(api);\n        });\n      });\n    },\n    parse(xmlString: string) {\n      xmlFragment = parseXML(xmlString);\n      return api;\n    },\n    path: (location: string): typeof api => {\n      setLocation(xmlFragment, location);\n      return api;\n    },\n    fn(fn: (xmlFragment: XMLDocument) => void) {\n      fn(xmlFragment);\n      return api;\n    },\n    items() {\n      return itemsFromTest(xmlFragment);\n    },\n    html() {\n      return new XMLSerializer().serializeToString(toHTML(xmlFragment));\n    },\n    xml(): string {\n      return new XMLSerializer().serializeToString(xmlFragment);\n    },\n    htmlDoc() {\n      return toHTML(xmlFragment);\n    },\n    xmlDoc(): XMLDocument {\n      return xmlFragment;\n    }\n  };\n  return api;\n};\n","import { QtiAssessmentItem } from '../qti-components';\nimport { qtiTransformItem, qtiTransformTest } from '../qti-transformers';\nimport { qtiTransformManifest } from '../qti-transformers/qti-transform-manifest';\n\nexport type ManifestInfo = {\n  testIdentifier: string;\n  testHTMLDoc: DocumentFragment;\n  testURI: string;\n  testURL: string;\n  items: {\n    identifier: string;\n    href: string;\n    category: string;\n  }[];\n};\n\n// Utility function to ensure package URIs end with a '/'\n// const normalizeUri = (uri: string) => (uri.endsWith('/') ? uri : `${uri}/`);\n\n// Fetches assessment data from the manifest\nexport const getManifestInfo = async (manifestURL: string): Promise<ManifestInfo> => {\n  const baseURI = manifestURL.substring(0, manifestURL.lastIndexOf('/'));\n\n  const test = await qtiTransformManifest()\n    .load(`${manifestURL}`)\n    .then(api => api.assessmentTest());\n\n  const testHTMLDoc = await qtiTransformTest()\n    .load(`${baseURI}/${test.href}`)\n    .then(api => api.htmlDoc());\n\n  const items = await qtiTransformTest()\n    .load(`${baseURI}/${test.href}`)\n    .then(api => api.items());\n\n  const testURL = `${baseURI}/${test.href}`;\n  const testURI = `${baseURI}/${test.href.substring(0, test.href.lastIndexOf('/'))}`;\n\n  return {\n    testHTMLDoc,\n    testURI,\n    testURL,\n    items,\n    testIdentifier: test.identifier\n  };\n};\n\n// Fetches a single item by URI\nexport const getItemByUri = async (itemUri: string): Promise<QtiAssessmentItem> =>\n  qtiTransformItem()\n    .load(itemUri)\n    .then(api => api.htmlDoc().firstElementChild as QtiAssessmentItem);\n"],"mappings":"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","names":["xml","xml","xml"]}

package/dist/qti-components-jsx.d.ts

@@ -501,6 +501,23 @@ export type QtiChoiceInteractionProps = {
   "onqti-interaction-response"?: (e: CustomEvent<CustomEvent>) => void;
 };
 
+export type QtiUploadInteractionProps = {
+  /**  */
+  "response-identifier"?: string;
+  /**  */
+  disabled?: boolean;
+  /**  */
+  readonly?: boolean;
+  /**  */
+  value?: string | string[];
+  /**  */
+  correctResponse?: string | string[];
+  /**  */
+  "onqti-interaction-response"?: (e: CustomEvent<CustomEvent>) => void;
+  /**  */
+  "onqti-register-interaction"?: (e: CustomEvent<CustomEvent>) => void;
+};
+
 export type QtiOutcomeProcessingProps = {};
 
 export type QtiPortableCustomInteractionProps = {
@@ -874,10 +891,6 @@ export type QtiSelectPointInteractionProps = {
 };
 
 export type QtiSliderInteractionProps = {
-  /**  */
-  "step-label"?: boolean;
-  /**  */
-  reverse?: boolean;
   /**  */
   "lower-bound"?: number;
   /**  */
@@ -885,27 +898,9 @@ export type QtiSliderInteractionProps = {
   /**  */
   step?: number;
   /**  */
-  "response-identifier"?: string;
+  value?: string;
   /**  */
-  disabled?: boolean;
-  /**  */
-  readonly?: boolean;
-  /**  */
-  csLive?: CSSStyleDeclaration;
-  /**  */
-  _handleDisabledChange?: string;
-  /**  */
-  _handleReadonlyChange?: string;
-  /**  */
-  value?: string | string[];
-  /**  */
-  response?: string;
-  /**  */
-  correctResponse?: string | string[];
-  /** emitted when the interaction wants to register itself */
-  "onqti-register-interaction"?: (e: CustomEvent<CustomEvent>) => void;
-  /** emitted when the interaction changes */
-  "onqti-interaction-response"?: (e: CustomEvent<CustomEvent>) => void;
+  onchange?: (e: CustomEvent<Event>) => void;
 };
 
 export type QtiCustomOperatorProps = {
@@ -1103,8 +1098,6 @@ export type QtiTestPartProps = {
 };
 
 export type QtiTestProps = {
-  /** the relative location to the QTI assessment.xml file ### Features - **Dynamic Template Loading**: If a `<template>` element is included as a child of `<qti-test>`, its content is dynamically appended to the shadow DOM. */
-  testURL?: string;
   /**  */
   context?: TestContext;
 };
@@ -1178,8 +1171,12 @@ export type TestItemLinkProps = {
 };
 
 export type TestContainerProps = {
-  /**  */
+  /** URL of the item to load */
   "test-url"?: string;
+  /** A parsed HTML document */
+  testDoc?: DocumentFragment;
+  /** The raw XML string */
+  testXML?: string;
 };
 
 export type TestPagingButtonsStampProps = {
@@ -1201,17 +1198,15 @@ export type TestPagingButtonsStampProps = {
   "onqti-request-test-item"?: (e: CustomEvent<CustomEvent>) => void;
 };
 
-export type QtiItemProps = {
-  /**  */
-  identifier?: string | undefined;
-  /**  */
-  href?: string | undefined;
-  /**  */
-  xmlDoc?: DocumentFragment;
-  /**  */
-  assessmentItem?: QtiAssessmentItem | null;
-  /**  */
-  "onqti-item-connected"?: (e: CustomEvent<CustomEvent>) => void;
+export type QtiItemProps = {};
+
+export type ItemContainerProps = {
+  /** URL of the item to load */
+  "item-url"?: string;
+  /** A parsed HTML document */
+  itemDoc?: DocumentFragment;
+  /** The raw XML string */
+  itemXML?: string;
 };
 
 export type CustomElements = {
@@ -1665,6 +1660,17 @@ export type CustomElements = {
    */
   "qti-choice-interaction": Partial<QtiChoiceInteractionProps & BaseProps & BaseEvents>;
 
+  /**
+   *
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **qti-interaction-response**
+   * - **qti-register-interaction**
+   */
+  "qti-upload-interaction": Partial<QtiUploadInteractionProps & BaseProps & BaseEvents>;
+
   /**
    *
    * ---
@@ -1851,30 +1857,12 @@ export type CustomElements = {
   "qti-select-point-interaction": Partial<QtiSelectPointInteractionProps & BaseProps & BaseEvents>;
 
   /**
-   * The SliderInteraction.Type (qti-slider-interaction) presents the candidate with a control for selecting a numerical value between a lower and upper bound.
+   *
    * ---
    *
    *
    * ### **Events:**
-   *  - **qti-register-interaction** - emitted when the interaction wants to register itself
-   * - **qti-interaction-response** - emitted when the interaction changes
-   *
-   * ### **Slots:**
-   *  - _default_ - The default slot where <qti-simple-choice> must be placed.
-   * - **prompt** - slot where the prompt is placed.
-   *
-   * ### **CSS Properties:**
-   *  - **--show-value** - shows the current value while sliding _(default: undefined)_
-   * - **--show-ticks** - shows the ticks according to steps _(default: undefined)_
-   * - **--show-bounds** - shows value for lower and upper boundary _(default: undefined)_
-   *
-   * ### **CSS Parts:**
-   *  - **slider** - -- slider inluding, bounds and ticks and value, use it for paddings and margins
-   * - **bounds** - -- div for bounds, containing two divs for with min, and max bounds value
-   * - **ticks** - -- div for ticks, use lineair gradient and exposed css variables for styling
-   * - **rail** - -- div for rail, style according to needs
-   * - **knob** - -- div, should be relative or absolute
-   * - **value** - -- div, containing value
+   *  - **change**
    */
   "qti-slider-interaction": Partial<QtiSliderInteractionProps & BaseProps & BaseEvents>;
 
@@ -2032,24 +2020,41 @@ export type CustomElements = {
    *
    * ### Example Usage
    *
-   * Minimal markup:
-   * ```html
-   * <qti-test test="./path/to/assessment.xml">
-   *   <test-container></test-container>
-   * </qti-test>
-   * ```
+   * Minimal example including navigation:
    *
-   * With navigation buttons:
    * ```html
-   * <qti-test >
+   * <qti-test>
    *   <test-container test-url="./path/to/assessment.xml"></test-container>
-   *   <div class="flex">
+   *   <nav class="flex">
    *      <test-prev></test-prev>
    *      <test-next></test-next>
-   *   </div>
+   *   </nav>
    * </qti-test>
    * ```
    *
+   * Use the following file structure
+   * A qti-test loads a QTI3.0 assessmenttest.xml file from a package folder.
+   *
+   * ```plaintext
+   * Root/
+   * ├── index.html
+   * └── /assets/api/examples/
+   *     ├── assessmenttest.xml
+   *     └── imsmanifest.xml
+   *
+   * ```
+   *
+   * ### Test components
+   *
+   * Use test components inside the qti-test component for added functionality.
+   * ### Test next
+   * `<test-next> | TestNext`
+   *
+   * ### Test prev
+   *
+   * `<test-prev> | TestPrev`
+   * ### Test components
+   *
    * You can use normal class names to style the elements.
    * And you can use the `test-prev` and `test-next` elements to navigate through the test.
    * ---
@@ -2102,16 +2107,16 @@ export type CustomElements = {
   "test-item-link": Partial<TestItemLinkProps & BaseProps & BaseEvents>;
 
   /**
-   * `<test-container>` is a custom element designed for hosting the qti-assessment-test.
+   * `<test-container>` is a custom element designed for hosting the qti-assessment-item.
    * The `qti-assessment-test` will be placed inside the shadow DOM of this element.
+   * The element loads the item from the provided URL and renders it inside the shadow DOM.
    *
-   * ### Example Usage
-   * The `test-container` element to hosts the visual representation of the items.
-   * You can style the container by adding a class to the element.
+   * ### Styling
+   * Add a class to the element for styling.
    *
    * ```html
-   * <qti-test testurl="./path/to/assessment.xml">
-   *   <test-container class="container bg-white m-2"></test-container>
+   * <qti-test>
+   *   <test-container class="m-4 bg-white" test-url="./path/to/item.xml"></test-container>
    * </qti-test>
    * ```
    * ---
@@ -2131,12 +2136,36 @@ export type CustomElements = {
   "test-paging-buttons-stamp": Partial<TestPagingButtonsStampProps & BaseProps & BaseEvents>;
 
   /**
+   * `<qti-item>` is a custom element designed for rendering a single `qti-assessment-item`.
+   * It can also host some functionalities to interact with the item like scoring, showing feedback, etc.
+   * Placing a mandatory `<item-container>` inside '<qti-item>' will load or parse the item and render it.
+   * See `<item-container>` for more details.
    *
+   * ```html
+   * <qti-item>
+   *   <item-container class="m-4 bg-white" item-url="./path/to/item.xml"></item-container>
+   * </qti-item>
+   * ```
    * ---
    *
-   *
-   * ### **Events:**
-   *  - **qti-item-connected**
    */
   "qti-item": Partial<QtiItemProps & BaseProps & BaseEvents>;
+
+  /**
+   * `<item-container>` is a custom element designed for hosting the qti-assessment-item.
+   * The `qti-assessment-item` will be placed inside the shadow DOM of this element.
+   * The element loads the item from the provided URL and renders it inside the shadow DOM.
+   *
+   * ### Styling
+   * Add a class to the element for styling.
+   *
+   * ```html
+   * <qti-item>
+   *   <item-container class="m-4 bg-white" item-url="./path/to/item.xml"></item-container>
+   * </qti-item>
+   * ```
+   * ---
+   *
+   */
+  "item-container": Partial<ItemContainerProps & BaseProps & BaseEvents>;
 };