@pie-players/pie-section-player 0.3.28 → 0.3.30

package/dist/policies/index.d.ts

@@ -1,3 +1,11 @@
-import { SectionPlayerPolicies } from './types.js';
+import { SectionPlayerAutoFocusStrategy, SectionPlayerFocusPolicy, SectionPlayerPolicies } from './types.js';
+export declare const DEFAULT_FOCUS_POLICY: SectionPlayerFocusPolicy;
 export declare const DEFAULT_SECTION_PLAYER_POLICIES: SectionPlayerPolicies;
+/**
+ * Resolve the auto-focus strategy from a focus policy input, honoring the
+ * deprecated `autoFocusFirstItem` boolean when present. Presence is detected
+ * via `"autoFocusFirstItem" in policy` so that explicit `false` wins over the
+ * default, mirroring how callers historically toggled the old flag.
+ */
+export declare function resolveAutoFocusStrategy(policy: SectionPlayerFocusPolicy | null | undefined): SectionPlayerAutoFocusStrategy;
 //# sourceMappingURL=index.d.ts.map

package/dist/policies/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/policies/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,eAAO,MAAM,+BAA+B,EAAE,qBAK7C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/policies/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,8BAA8B,EAC9B,wBAAwB,EACxB,qBAAqB,EACrB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,oBAAoB,EAAE,wBAElC,CAAC;AAEF,eAAO,MAAM,+BAA+B,EAAE,qBAK7C,CAAC;AAIF;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACvC,MAAM,EAAE,wBAAwB,GAAG,IAAI,GAAG,SAAS,GACjD,8BAA8B,CAahC"}

package/dist/policies/types.d.ts

@@ -5,8 +5,30 @@ export type SectionPlayerReadinessPolicy = {
 export type SectionPlayerPreloadPolicy = {
     enabled: boolean;
 };
+/**
+ * Strategy the section player uses to move focus after every navigation event
+ * (Next / Back / navigateTo) and when the host calls `focusStart()` on the
+ * layout element (Skip-to-Main).
+ *
+ * - `"start-of-content"` (default): focus the passage card when present,
+ *   else the first item card. Matches assessment UX where Skip-to-Main and
+ *   navigation land in the same place. Best for one-item-per-page layouts.
+ * - `"current-item"`: focus the newly-active item card (queried as
+ *   `pie-section-player-item-card[is-current]`). Best for stacked/list
+ *   layouts where multiple items are visible at once.
+ * - `"none"`: framework never moves focus on navigation; the host owns it
+ *   entirely. `focusStart()` still moves focus (defaults to
+ *   start-of-content) because hosts only call it when they want focus
+ *   to move.
+ */
+export type SectionPlayerAutoFocusStrategy = "none" | "start-of-content" | "current-item";
 export type SectionPlayerFocusPolicy = {
-    autoFocusFirstItem: boolean;
+    autoFocus: SectionPlayerAutoFocusStrategy;
+    /**
+     * @deprecated Use `autoFocus` instead. `true` maps to `"start-of-content"`,
+     * `false` maps to `"none"`. Scheduled for removal in the next major version.
+     */
+    autoFocusFirstItem?: boolean;
 };
 export type SectionPlayerTelemetryPolicy = {
     enabled: boolean;

package/dist/policies/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/policies/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AAExF,MAAM,MAAM,4BAA4B,GAAG;IAC1C,IAAI,EAAE,aAAa,GAAG,QAAQ,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACxC,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACtC,kBAAkB,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IAC1C,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IACnC,SAAS,EAAE,4BAA4B,CAAC;IACxC,OAAO,EAAE,0BAA0B,CAAC;IACpC,KAAK,EAAE,wBAAwB,CAAC;IAChC,SAAS,EAAE,4BAA4B,CAAC;CACxC,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACtC,iBAAiB,CAAC,MAAM,EAAE,kCAAkC,GAAG,OAAO,CAAC;CACvE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/policies/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AAExF,MAAM,MAAM,4BAA4B,GAAG;IAC1C,IAAI,EAAE,aAAa,GAAG,QAAQ,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACxC,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,8BAA8B,GACvC,MAAM,GACN,kBAAkB,GAClB,cAAc,CAAC;AAElB,MAAM,MAAM,wBAAwB,GAAG;IACtC,SAAS,EAAE,8BAA8B,CAAC;IAC1C;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IAC1C,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IACnC,SAAS,EAAE,4BAA4B,CAAC;IACxC,OAAO,EAAE,0BAA0B,CAAC;IACpC,KAAK,EAAE,wBAAwB,CAAC;IAChC,SAAS,EAAE,4BAA4B,CAAC;CACxC,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACtC,iBAAiB,CAAC,MAAM,EAAE,kCAAkC,GAAG,OAAO,CAAC;CACvE"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pie-players/pie-section-player",
-	"version": "0.3.28",
+	"version": "0.3.30",
 	"type": "module",
 	"description": "Web component for rendering QTI 3.0 assessment sections with passages and items",
 	"license": "MIT",
@@ -29,6 +29,10 @@
 			"types": "./dist/pie-section-player.d.ts",
 			"import": "./dist/pie-section-player.js"
 		},
+		"./components/section-player-tabbed-element": {
+			"types": "./dist/pie-section-player.d.ts",
+			"import": "./dist/pie-section-player.js"
+		},
 		"./components/section-player-shell-element": {
 			"types": "./dist/pie-section-player.d.ts",
 			"import": "./dist/pie-section-player.js"
@@ -69,6 +73,10 @@
 			"types": "./dist/pie-section-player.d.ts",
 			"import": "./dist/pie-section-player.js"
 		},
+		"./contracts/host-hooks": {
+			"types": "./dist/pie-section-player.d.ts",
+			"import": "./dist/pie-section-player.js"
+		},
 		"./policies": {
 			"types": "./dist/pie-section-player.d.ts",
 			"import": "./dist/pie-section-player.js"
@@ -89,7 +97,7 @@
 		"lint": "biome check ."
 	},
 	"peerDependencies": {
-		"@pie-players/pie-tool-annotation-toolbar": "0.3.28"
+		"@pie-players/pie-tool-annotation-toolbar": "0.3.30"
 	},
 	"peerDependenciesMeta": {
 		"@pie-players/pie-tool-annotation-toolbar": {
@@ -97,25 +105,26 @@
 		}
 	},
 	"dependencies": {
-		"@pie-players/pie-assessment-toolkit": "0.3.28",
-		"@pie-players/pie-item-player": "0.3.28",
-		"@pie-players/pie-context": "0.3.28",
-		"@pie-players/pie-players-shared": "0.3.28",
-		"@pie-players/pie-tool-calculator-desmos": "0.3.28",
-		"@pie-players/pie-tool-text-to-speech": "0.3.28",
-		"@pie-players/pie-tool-tts-inline": "0.3.28",
-		"@pie-players/pie-toolbars": "0.3.28"
+		"@pie-players/pie-assessment-toolkit": "0.3.30",
+		"@pie-players/pie-item-player": "0.3.30",
+		"@pie-players/pie-context": "0.3.30",
+		"@pie-players/pie-players-shared": "0.3.30",
+		"@pie-players/pie-tool-calculator-desmos": "0.3.30",
+		"@pie-players/pie-tool-text-to-speech": "0.3.30",
+		"@pie-players/pie-tool-tts-inline": "0.3.30",
+		"@pie-players/pie-toolbars": "0.3.30"
 	},
 	"devDependencies": {
 		"@axe-core/playwright": "^4.11.1",
-		"@biomejs/biome": "^2.3.13",
-		"@playwright/test": "^1.58.2",
+		"@biomejs/biome": "^2.4.12",
+		"@happy-dom/global-registrator": "^20.9.0",
+		"@playwright/test": "^1.59.1",
 		"@sveltejs/vite-plugin-svelte": "^7.0.0",
 		"@types/node": "^25.1.0",
 		"svelte": "^5.54.0",
-		"svelte-check": "^4.4.5",
+		"svelte-check": "^4.4.6",
 		"typescript": "^5.9.3",
-		"vite": "^8.0.1",
+		"vite": "^8.0.10",
 		"vite-plugin-dts": "^4.5.4"
 	},
 	"homepage": "https://github.com/pie-framework/pie-players/tree/master/packages/section-player#readme",