@pie-players/pie-section-player 0.3.29 → 0.3.31

package/dist/policies/index.d.ts

@@ -1,3 +1,28 @@
-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;
+/**
+ * Whether the section-level element preload pipeline should run. Defaults to
+ * `true` when the policy is unset or partially set so existing hosts are
+ * unaffected. Hosts opt out by passing `policies.preload.enabled === false`,
+ * which short-circuits `warmupSectionElements` in `SectionItemsPane`. Items
+ * still mount and item-players register their own elements on demand.
+ */
+export declare function isPreloadEnabled(policies: SectionPlayerPolicies | null | undefined): boolean;
+/**
+ * Whether the section-player layout elements should attach the
+ * instrumentation event bridge. Defaults to `true` when the policy is unset
+ * or partially set. Hosts opt out by passing
+ * `policies.telemetry.enabled === false`, which skips
+ * `attachInstrumentationEventBridge` setup entirely. Hosts that want a
+ * different shape of opt-out can still supply a custom
+ * `instrumentationProvider`.
+ */
+export declare function isTelemetryEnabled(policies: SectionPlayerPolicies | null | undefined): boolean;
+/**
+ * Resolve the auto-focus strategy from a focus policy input, falling back to
+ * the package default (`"start-of-content"`) when the policy is unset or
+ * leaves `autoFocus` undefined.
+ */
+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;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,qBAAqB,GAAG,IAAI,GAAG,SAAS,GAChD,OAAO,CAET;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,GAAG,SAAS,GAChD,OAAO,CAET;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACvC,MAAM,EAAE,wBAAwB,GAAG,IAAI,GAAG,SAAS,GACjD,8BAA8B,CAGhC"}

package/dist/policies/types.d.ts

@@ -5,8 +5,25 @@ 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;
 };
 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;CAC1C,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.29",
+	"version": "0.3.31",
 	"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"
@@ -76,10 +80,6 @@
 		"./policies": {
 			"types": "./dist/pie-section-player.d.ts",
 			"import": "./dist/pie-section-player.js"
-		},
-		"./utils/player-preload": {
-			"types": "./dist/utils/player-preload.d.ts",
-			"import": "./dist/utils/player-preload.js"
 		}
 	},
 	"files": [
@@ -90,10 +90,11 @@
 		"dev": "vite build --watch",
 		"typecheck": "tsc --noEmit",
 		"check": "svelte-check --tsconfig ./tsconfig.svelte-check.json --compiler-warnings options_missing_custom_element:ignore",
-		"lint": "biome check ."
+		"lint": "biome check .",
+		"test": "bun test '.test.ts'"
 	},
 	"peerDependencies": {
-		"@pie-players/pie-tool-annotation-toolbar": "0.3.29"
+		"@pie-players/pie-tool-annotation-toolbar": "0.3.31"
 	},
 	"peerDependenciesMeta": {
 		"@pie-players/pie-tool-annotation-toolbar": {
@@ -101,25 +102,26 @@
 		}
 	},
 	"dependencies": {
-		"@pie-players/pie-assessment-toolkit": "0.3.29",
-		"@pie-players/pie-item-player": "0.3.29",
-		"@pie-players/pie-context": "0.3.29",
-		"@pie-players/pie-players-shared": "0.3.29",
-		"@pie-players/pie-tool-calculator-desmos": "0.3.29",
-		"@pie-players/pie-tool-text-to-speech": "0.3.29",
-		"@pie-players/pie-tool-tts-inline": "0.3.29",
-		"@pie-players/pie-toolbars": "0.3.29"
+		"@pie-players/pie-assessment-toolkit": "0.3.31",
+		"@pie-players/pie-item-player": "0.3.31",
+		"@pie-players/pie-context": "0.3.31",
+		"@pie-players/pie-players-shared": "0.3.31",
+		"@pie-players/pie-tool-calculator-desmos": "0.3.31",
+		"@pie-players/pie-tool-text-to-speech": "0.3.31",
+		"@pie-players/pie-tool-tts-inline": "0.3.31",
+		"@pie-players/pie-toolbars": "0.3.31"
 	},
 	"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",