chore(qti3): publish parity release

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: chillenious

apps/demo/package.json

@@ -14,8 +14,8 @@
     "test:e2e": "playwright test",
     "test:e2e:ui": "playwright test --ui",
     "test:e2e:headed": "playwright test --headed",
-    "test:a11y": "playwright test tests/playwright/component-fixtures-a11y.pw.ts tests/playwright/assessment-a11y-behavior.pw.ts",
-    "test:a11y:ui": "playwright test tests/playwright/component-fixtures-a11y.pw.ts tests/playwright/assessment-a11y-behavior.pw.ts --ui"
+    "test:a11y": "playwright test tests/playwright/component-fixtures-a11y.pw.ts tests/playwright/assessment-a11y-behavior.pw.ts tests/playwright/qti3-stage5-a11y.pw.ts",
+    "test:a11y:ui": "playwright test tests/playwright/component-fixtures-a11y.pw.ts tests/playwright/assessment-a11y-behavior.pw.ts tests/playwright/qti3-stage5-a11y.pw.ts --ui"
   },
   "dependencies": {
     "@acme/likert-scale-plugin": "workspace:*",

apps/demo/src/lib/a11y/fixtures.ts

@@ -18,7 +18,8 @@ export type A11yFixtureId =
 	| 'assessment-section-menu'
 	| 'assessment-rubric-display'
 	| 'assessment-timer'
-	| 'assessment-shell';
+	| 'assessment-shell'
+	| 'pnp-catalog-stimulus';
 
 export interface A11yFixture {
 	id: A11yFixtureId;
@@ -46,6 +47,7 @@ export const A11Y_FIXTURES: A11yFixture[] = [
 	{ id: 'assessment-rubric-display', title: 'RubricDisplay (assessment-player)' },
 	{ id: 'assessment-timer', title: 'AssessmentTimer (assessment-player)' },
 	{ id: 'assessment-shell', title: 'AssessmentShell (assessment-player)' },
+	{ id: 'pnp-catalog-stimulus', title: 'PNP catalog and shared stimulus runtime' },
 ];
 
 

apps/demo/src/lib/a11y/fixtures/PnpCatalogStimulusFixture.svelte

@@ -0,0 +1,171 @@
+<script lang="ts">
+	// @ts-expect-error - Svelte-check can't resolve workspace subpath exports, but runtime works correctly
+	import { ItemBody } from '@pie-qti/item-player/components';
+	import { Player, type PnpProfile } from '@pie-qti/item-player';
+	import type { InteractionResponseValue } from '@pie-qti/item-player/web-components';
+	import type { ResolvedItemDeliveryContext } from '@pie-qti/ims-cp-core';
+	import { registerDefaultComponents } from '@pie-qti/default-components';
+	import { onMount } from 'svelte';
+
+	type FixtureResponseValue = InteractionResponseValue | null;
+
+	// Clean-room QTI 3 fixture authored for Stage 5 public accessibility evidence.
+	// It exercises shared stimulus, scoped catalog lookup, PNP rebinding, and
+	// answer-key non-disclosure without using official/private conformance assets.
+	const qtiXml = `<qti-assessment-item xmlns="http://www.imsglobal.org/xsd/imsqtiasi_v3p0"
+		identifier="pnp-catalog-stimulus-a11y" title="PNP Catalog Stimulus A11y Fixture"
+		adaptive="false" time-dependent="false">
+		<qti-response-declaration identifier="RESPONSE" cardinality="single" base-type="string">
+			<qti-correct-response>
+				<qti-value>braided delta</qti-value>
+			</qti-correct-response>
+		</qti-response-declaration>
+		<qti-outcome-declaration identifier="SCORE" cardinality="single" base-type="float"/>
+		<qti-assessment-stimulus-ref identifier="passage_1" href="../stimuli/river.xml" title="River passage"/>
+		<qti-item-body>
+			<p class="item-note" data-catalog-idref="item_term">Use the shared passage to answer the question.</p>
+			<p>
+				Name the river feature:
+				<qti-text-entry-interaction response-identifier="RESPONSE" expected-length="16"/>
+			</p>
+		</qti-item-body>
+		<qti-catalog-info>
+			<qti-card identifier="item_term">
+				<qti-card-entry usage="glossary-on-screen">
+					<qti-html-content>Question instructions.</qti-html-content>
+				</qti-card-entry>
+			</qti-card>
+			<qti-card identifier="term_delta">
+				<qti-card-entry usage="glossary-on-screen">
+					<qti-html-content>Item-local fallback definition.</qti-html-content>
+				</qti-card-entry>
+			</qti-card>
+		</qti-catalog-info>
+	</qti-assessment-item>`;
+
+	const deliveryContext: ResolvedItemDeliveryContext = {
+		itemHref: 'items/item.xml',
+		stimuli: {
+			passage_1: {
+				identifier: 'passage_1',
+				href: '../stimuli/river.xml',
+				resolvedHref: 'stimuli/river.xml',
+				title: 'River passage',
+				bodyHtml: `<section aria-label="Shared river passage">
+					<p>
+						A <span class="stimulus-term" data-catalog-idref="term_delta">delta</span>
+						forms where a river drops sediment.
+					</p>
+				</section>`,
+				stylesheets: [],
+				validationMessages: [],
+			},
+		},
+		stylesheets: [
+			{
+				href: 'item.css',
+				xml: '<qti-stylesheet href="item.css"/>',
+				resolvedHref: 'items/item.css',
+				source: 'item',
+				cssText: '.item-note { border-left: 4px solid currentColor; padding-left: 0.5rem; }',
+			},
+			{
+				href: 'stimulus.css',
+				xml: '<qti-stylesheet href="stimulus.css"/>',
+				resolvedHref: 'stimuli/stimulus.css',
+				source: 'stimulus',
+				stimulusIdentifier: 'passage_1',
+				cssText: '.stimulus-term { text-decoration: underline; }',
+			},
+		],
+		catalogSources: [
+			{
+				scope: 'stimulus',
+				baseHref: 'stimuli/river.xml',
+				stimulusIdentifier: 'passage_1',
+				xml: `<qti-catalog-info>
+					<qti-card identifier="term_delta">
+						<qti-card-entry usage="glossary-on-screen">
+							<qti-html-content>Stimulus-scoped delta definition.</qti-html-content>
+						</qti-card-entry>
+						<qti-card-entry usage="tts-pronunciation" xml:lang="en">
+							<qti-html-content>DEL-tuh</qti-html-content>
+						</qti-card-entry>
+					</qti-card>
+				</qti-catalog-info>`,
+			},
+		],
+		validationMessages: [],
+	};
+
+	const initialPnp: PnpProfile = {
+		content: {
+			glossaryOnScreen: true,
+			catalogSupports: { ttsPronunciation: { active: true, languageCode: 'en' } },
+		},
+	};
+
+	let player = $state<Player | null>(null);
+	let responses = $state<Record<string, FixtureResponseValue>>({ RESPONSE: null });
+	let glossaryEnabled = $state(true);
+	let lastCatalogEvent = $state<string>('none');
+	let mounted = $state(false);
+	let fixtureRoot: HTMLDivElement | null = $state(null);
+
+	onMount(() => {
+		const newPlayer = new Player({
+			itemXml: qtiXml,
+			role: 'candidate',
+			pnp: initialPnp,
+			deliveryContext,
+		});
+		registerDefaultComponents(newPlayer.getComponentRegistry());
+		player = newPlayer;
+		mounted = true;
+	});
+
+	function toggleGlossary() {
+		glossaryEnabled = !glossaryEnabled;
+		player?.updatePnp({ content: { glossaryOnScreen: glossaryEnabled } });
+	}
+
+	$effect(() => {
+		if (!fixtureRoot) return;
+		const handler = (event: Event) => handleCatalogLookup(event as CustomEvent);
+		const el = fixtureRoot;
+		el.addEventListener('qti-catalog-lookup', handler);
+		return () => el.removeEventListener('qti-catalog-lookup', handler);
+	});
+
+	function handleCatalogLookup(event: CustomEvent) {
+		const detail = event.detail ?? {};
+		lastCatalogEvent = `${detail.usage ?? 'unknown'}:${detail.html ?? ''}`;
+	}
+</script>
+
+<div bind:this={fixtureRoot} class="space-y-4">
+	<p class="text-sm text-base-content/70">
+		Fixture for shared stimulus rendering, dynamic PNP catalog supports, keyboard focus behavior,
+		host catalog events, and scoped stylesheet isolation.
+	</p>
+
+	<div class="flex flex-wrap gap-2">
+		<button type="button" class="btn btn-sm" onclick={toggleGlossary}>
+			{glossaryEnabled ? 'Disable glossary support' : 'Enable glossary support'}
+		</button>
+		<div role="status" aria-live="polite" data-testid="catalog-event-status">
+			Last catalog event: {lastCatalogEvent}
+		</div>
+	</div>
+
+	{#if mounted && player}
+		<div class="qti-item-player">
+			<ItemBody
+				{player}
+				{responses}
+				disabled={false}
+				onResponseChange={(id: string, value: FixtureResponseValue) => (responses = { ...responses, [id]: value })}
+			/>
+		</div>
+	{/if}
+</div>

apps/demo/src/routes/a11y-components/[fixture]/+page.svelte

@@ -21,6 +21,7 @@
 	import ExtendedTextInteractionFixture from '$lib/a11y/fixtures/ExtendedTextInteractionFixture.svelte';
 	import MediaInteractionFixture from '$lib/a11y/fixtures/MediaInteractionFixture.svelte';
 	import ModalFeedbackFixture from '$lib/a11y/fixtures/ModalFeedbackFixture.svelte';
+	import PnpCatalogStimulusFixture from '$lib/a11y/fixtures/PnpCatalogStimulusFixture.svelte';
 
 	interface Props {
 		data: { fixture: string };
@@ -87,6 +88,8 @@
 				<AssessmentTimerFixture />
 			{:else if fixture === 'assessment-shell'}
 				<AssessmentShellFixture />
+			{:else if fixture === 'pnp-catalog-stimulus'}
+				<PnpCatalogStimulusFixture />
 			{:else}
 				<div class="alert alert-error">
 					Unknown fixture: <code class="font-mono">{data.fixture}</code>

apps/demo/tests/playwright/assessment-a11y-behavior.pw.ts

@@ -62,11 +62,33 @@ test.describe('assessment accessibility behavior', () => {
 
 		await expect(page.getByRole('timer')).toHaveAttribute('aria-label', /remaining/i);
 
-		await page.getByRole('button', { name: /simulate warning/i }).click();
+		const warningButton = page.getByRole('button', { name: /simulate warning/i });
+		await warningButton.focus();
+		await page.keyboard.press('Enter');
 		await expect(page.getByRole('status').filter({ hasText: /time remaining/i })).toBeAttached();
+		await expect(warningButton).toBeFocused();
 
-		await page.getByRole('button', { name: /simulate expiry/i }).click();
+		const expiryButton = page.getByRole('button', { name: /simulate expiry/i });
+		await expiryButton.focus();
+		await page.keyboard.press('Enter');
 		await expect(page.getByRole('alert').filter({ hasText: /time expired/i })).toBeAttached();
+		await expect(expiryButton).toBeFocused();
+	});
+
+	test('timer controls remain reachable in a narrow reflow viewport', async ({ page }) => {
+		await page.setViewportSize({ width: 320, height: 800 });
+		await page.goto('a11y-components/assessment-timer');
+
+		const root = page.locator('[data-testid="a11y-fixture-root"]');
+		await expect(root).toBeVisible();
+		await expect(page.getByRole('timer')).toBeVisible();
+
+		for (const name of [/simulate tick/i, /simulate warning/i, /simulate expiry/i]) {
+			const button = page.getByRole('button', { name });
+			await expect(button).toBeVisible();
+			await button.focus();
+			await expect(button).toBeFocused();
+		}
 	});
 
 	test('composed assessment demo shell has no automated WCAG AA violations', async ({ page }) => {

apps/demo/tests/playwright/qti3-stage5-a11y.pw.ts

@@ -0,0 +1,97 @@
+import AxeBuilder from '@axe-core/playwright';
+import { expect, test } from '@playwright/test';
+
+import { WCAG_AA_TAGS } from './a11y-utils';
+
+// Clean-room browser evidence for QTI 3 PNP/catalog/shared-stimulus behavior.
+// The fixture is repository-authored and intentionally independent of official
+// 1EdTech/private conformance packages.
+test.describe('QTI 3 Stage 5 PNP/catalog/stimulus browser evidence', () => {
+	test('supports keyboard glossary popup behavior without duplicate stimulus content or answer leakage', async ({ page }) => {
+		await page.goto('a11y-components/pnp-catalog-stimulus');
+		const root = page.locator('[data-testid="a11y-fixture-root"]');
+		await expect(root).toBeVisible();
+
+		await expect(root.getByLabel('Shared river passage')).toBeVisible();
+		await expect(root.locator('[data-stimulus-idref="passage_1"]')).toHaveCount(1);
+		await expect(root.locator('[data-stimulus-idref="passage_1"] .stimulus-term')).toHaveCount(1);
+		await expect(root.getByRole('textbox', { name: /text entry response/i })).toBeVisible();
+		await expect(root.getByText(/braided delta|qti-correct-response|correctResponse|Item-local fallback definition/i)).toHaveCount(
+			0
+		);
+
+		const exposure = await root.evaluate((el) => ({
+			text: (el as HTMLElement).innerText,
+			labels: Array.from(el.querySelectorAll<HTMLElement>('[aria-label], [aria-description], [title]')).map((node) =>
+				[node.getAttribute('aria-label'), node.getAttribute('aria-description'), node.getAttribute('title')].join(' ')
+			),
+		}));
+		expect([exposure.text, ...exposure.labels].join(' ')).not.toMatch(
+			/braided delta|qti-correct-response|correctResponse/i
+		);
+
+		const glossaryTrigger = root.getByRole('button', { name: /show definition: delta/i });
+		await expect(glossaryTrigger).toBeVisible();
+		await expect(glossaryTrigger).toHaveAttribute('data-catalog-usage', 'glossary-on-screen');
+		await glossaryTrigger.focus();
+		await expect(glossaryTrigger).toBeFocused();
+
+		await page.keyboard.press('Enter');
+		await expect(root.getByRole('dialog', { name: /delta/i })).toContainText('Stimulus-scoped delta definition');
+
+		await page.keyboard.press('Escape');
+		await expect(root.getByRole('dialog', { name: /delta/i })).toHaveCount(0);
+		await expect(glossaryTrigger).toBeFocused();
+	});
+
+	test('dynamically rebinds PNP catalog UI and emits host-routed support events only on user action', async ({ page }) => {
+		await page.goto('a11y-components/pnp-catalog-stimulus');
+		const root = page.locator('[data-testid="a11y-fixture-root"]');
+		await expect(root).toBeVisible();
+
+		await expect(root.getByTestId('catalog-event-status')).toContainText('none');
+		const pronunciationTrigger = root.getByRole('button', { name: /request pronunciation: delta/i });
+		await expect(pronunciationTrigger).toBeVisible();
+		await pronunciationTrigger.click();
+		await expect(root.getByTestId('catalog-event-status')).toContainText('tts-pronunciation:DEL-tuh');
+		await expect(root.getByTestId('catalog-event-status')).not.toContainText(/braided delta|correctResponse/i);
+
+		await root.getByRole('button', { name: /disable glossary support/i }).click();
+		await expect(root.getByRole('button', { name: /show definition: delta/i })).toHaveCount(0);
+		await expect(root.getByRole('button', { name: /request pronunciation: delta/i })).toBeVisible();
+
+		await root.getByRole('button', { name: /enable glossary support/i }).click();
+		await expect(root.getByRole('button', { name: /show definition: delta/i })).toHaveCount(1);
+	});
+
+	test('keeps resolved styles scoped to the item instance and stimulus wrapper', async ({ page }) => {
+		await page.goto('a11y-components/pnp-catalog-stimulus');
+		const root = page.locator('[data-testid="a11y-fixture-root"]');
+		await expect(root).toBeVisible();
+
+		const itemBody = root.locator('[data-qti-item-body-scope]');
+		await expect(itemBody).toHaveCount(1);
+		const scope = await itemBody.getAttribute('data-qti-item-body-scope');
+		expect(scope).toBeTruthy();
+
+		const styleText = await itemBody.locator('style[data-qti-stylesheets="resolved"]').textContent();
+		expect(styleText).toContain(`[data-qti-item-body-scope="${scope}"] .item-note`);
+		expect(styleText).toContain(`[data-qti-item-body-scope="${scope}"] [data-stimulus-idref="passage_1"] .stimulus-term`);
+		expect(styleText).not.toContain('items/item.css');
+		expect(styleText).not.toContain('stimuli/stimulus.css');
+		expect(styleText).not.toContain('@import');
+		expect(styleText).not.toContain('url(');
+	});
+
+	test('has no automated WCAG AA violations in the composed Stage 5 fixture', async ({ page }) => {
+		await page.goto('a11y-components/pnp-catalog-stimulus');
+		await expect(page.locator('[data-testid="a11y-fixture-root"]')).toBeVisible();
+
+		const results = await new AxeBuilder({ page })
+			.include('[data-testid="a11y-fixture-root"]')
+			.withTags(WCAG_AA_TAGS)
+			.analyze();
+
+		expect(results.violations).toEqual([]);
+	});
+});

apps/docs/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @pie-qti/app-docs
 
+## 0.1.7
+
+### Patch Changes
+
+- Updated dependencies
+  - @pie-qti/assessment-player@0.1.7
+  - @pie-qti/item-player@0.1.7
+
 ## 0.1.6
 
 ### Patch Changes

apps/docs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pie-qti/app-docs",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "PIE-QTI Documentation Site",
   "type": "module",
   "private": true,

apps/transform/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @pie-qti/app-transform
 
+## 0.1.7
+
+### Patch Changes
+
+- Updated dependencies
+  - @pie-qti/assessment-player@0.1.7
+  - @pie-qti/default-components@0.1.7
+  - @pie-qti/demo-vendor-extensions@0.1.7
+  - @pie-qti/i18n@0.1.7
+  - @pie-qti/item-player@0.1.7
+  - @pie-qti/player-elements@0.1.7
+  - @pie-qti/qti-common@0.1.7
+  - @pie-qti/storage@0.1.7
+  - @pie-qti/to-pie@0.1.7
+  - @pie-qti/transform-core@0.1.7
+  - @pie-qti/transform-types@0.1.7
+  - @pie-qti/typeset-katex@0.1.7
+  - @pie-qti/web-component-loaders@0.1.7
+
 ## 0.1.6
 
 ### Patch Changes