@pie-players/pie-players-shared 0.3.58 → 0.3.59

package/dist/ui/zoom-compensation.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Pure browser-zoom compensation math (framework-agnostic, no Svelte runes).
+ *
+ * Browser zoom is approximated as outerWidth / innerWidth: outerWidth is the
+ * OS window size (zoom-independent) while innerWidth is in CSS pixels (shrinks
+ * as zoom increases). Callers apply the returned factor via CSS `zoom` so an
+ * element that would otherwise keep enlarging past `maxZoom` compounds back
+ * down to the cap.
+ *
+ * This module is tsc-buildable and shipped in `dist`, so it can be consumed by
+ * packages that resolve `@pie-players/pie-players-shared` from its published
+ * build (e.g. the assessment-toolkit CE bundle) as well as by the reactive
+ * Svelte wrapper in `./use-zoom-compensation.svelte.ts`, which packages built
+ * with Vite alias to source.
+ */
+export type ZoomCompensationOptions = {
+    /**
+     * Zoom level (as a ratio, e.g. `2` for 200%) below which the factor is 1.
+     * Above this level the factor shrinks as `maxZoom / zoom`.
+     */
+    maxZoom: number;
+    /** Lower bound on the returned factor. */
+    minCompensation: number;
+};
+/**
+ * Shared zoom-cap settings for the toolbar icon buttons (the TTS play button and
+ * the calculator button) so both compensate identically and can't drift apart.
+ * Grow normally up to 200%, then freeze; the 0.25 floor keeps the cap holding
+ * past 500% browser zoom (see the minCompensation note in
+ * section-player's SectionPlayerTabbedContent).
+ */
+export declare const ICON_BUTTON_ZOOM_OPTIONS: ZoomCompensationOptions;
+/**
+ * Approximate the browser zoom level from an outer/inner width pair. Falls
+ * back to 1 (100%) if the ratio isn't finite or is non-positive (which happens
+ * during SSR, in headless envs, and briefly during resize on some browsers).
+ */
+export declare function approximateZoomFromWidths(outerWidth: number, innerWidth: number): number;
+/**
+ * Pure zoom-compensation math: exactly 1 at zoom <= maxZoom, then shrinks as
+ * `maxZoom / zoom`, floored at `minCompensation` to guard against inflated
+ * ratios from window chrome / side panels making the element unusably small.
+ */
+export declare function computeZoomCompensation(zoom: number, maxZoom: number, minCompensation: number): number;

package/dist/ui/zoom-compensation.js

@@ -0,0 +1,44 @@
+/**
+ * Pure browser-zoom compensation math (framework-agnostic, no Svelte runes).
+ *
+ * Browser zoom is approximated as outerWidth / innerWidth: outerWidth is the
+ * OS window size (zoom-independent) while innerWidth is in CSS pixels (shrinks
+ * as zoom increases). Callers apply the returned factor via CSS `zoom` so an
+ * element that would otherwise keep enlarging past `maxZoom` compounds back
+ * down to the cap.
+ *
+ * This module is tsc-buildable and shipped in `dist`, so it can be consumed by
+ * packages that resolve `@pie-players/pie-players-shared` from its published
+ * build (e.g. the assessment-toolkit CE bundle) as well as by the reactive
+ * Svelte wrapper in `./use-zoom-compensation.svelte.ts`, which packages built
+ * with Vite alias to source.
+ */
+/**
+ * Shared zoom-cap settings for the toolbar icon buttons (the TTS play button and
+ * the calculator button) so both compensate identically and can't drift apart.
+ * Grow normally up to 200%, then freeze; the 0.25 floor keeps the cap holding
+ * past 500% browser zoom (see the minCompensation note in
+ * section-player's SectionPlayerTabbedContent).
+ */
+export const ICON_BUTTON_ZOOM_OPTIONS = {
+    maxZoom: 2,
+    minCompensation: 0.25,
+};
+/**
+ * Approximate the browser zoom level from an outer/inner width pair. Falls
+ * back to 1 (100%) if the ratio isn't finite or is non-positive (which happens
+ * during SSR, in headless envs, and briefly during resize on some browsers).
+ */
+export function approximateZoomFromWidths(outerWidth, innerWidth) {
+    const ratio = outerWidth / innerWidth;
+    return Number.isFinite(ratio) && ratio > 0 ? ratio : 1;
+}
+/**
+ * Pure zoom-compensation math: exactly 1 at zoom <= maxZoom, then shrinks as
+ * `maxZoom / zoom`, floored at `minCompensation` to guard against inflated
+ * ratios from window chrome / side panels making the element unusably small.
+ */
+export function computeZoomCompensation(zoom, maxZoom, minCompensation) {
+    return Math.max(minCompensation, Math.min(1, maxZoom / zoom));
+}
+//# sourceMappingURL=zoom-compensation.js.map

package/dist/ui/zoom-compensation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zoom-compensation.js","sourceRoot":"","sources":["../../src/ui/zoom-compensation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAYH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAA4B;IAChE,OAAO,EAAE,CAAC;IACV,eAAe,EAAE,IAAI;CACrB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACxC,UAAkB,EAClB,UAAkB;IAElB,MAAM,KAAK,GAAG,UAAU,GAAG,UAAU,CAAC;IACtC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACtC,IAAY,EACZ,OAAe,EACf,eAAuB;IAEvB,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;AAC/D,CAAC","sourcesContent":["/**\n * Pure browser-zoom compensation math (framework-agnostic, no Svelte runes).\n *\n * Browser zoom is approximated as outerWidth / innerWidth: outerWidth is the\n * OS window size (zoom-independent) while innerWidth is in CSS pixels (shrinks\n * as zoom increases). Callers apply the returned factor via CSS `zoom` so an\n * element that would otherwise keep enlarging past `maxZoom` compounds back\n * down to the cap.\n *\n * This module is tsc-buildable and shipped in `dist`, so it can be consumed by\n * packages that resolve `@pie-players/pie-players-shared` from its published\n * build (e.g. the assessment-toolkit CE bundle) as well as by the reactive\n * Svelte wrapper in `./use-zoom-compensation.svelte.ts`, which packages built\n * with Vite alias to source.\n */\n\nexport type ZoomCompensationOptions = {\n\t/**\n\t * Zoom level (as a ratio, e.g. `2` for 200%) below which the factor is 1.\n\t * Above this level the factor shrinks as `maxZoom / zoom`.\n\t */\n\tmaxZoom: number;\n\t/** Lower bound on the returned factor. */\n\tminCompensation: number;\n};\n\n/**\n * Shared zoom-cap settings for the toolbar icon buttons (the TTS play button and\n * the calculator button) so both compensate identically and can't drift apart.\n * Grow normally up to 200%, then freeze; the 0.25 floor keeps the cap holding\n * past 500% browser zoom (see the minCompensation note in\n * section-player's SectionPlayerTabbedContent).\n */\nexport const ICON_BUTTON_ZOOM_OPTIONS: ZoomCompensationOptions = {\n\tmaxZoom: 2,\n\tminCompensation: 0.25,\n};\n\n/**\n * Approximate the browser zoom level from an outer/inner width pair. Falls\n * back to 1 (100%) if the ratio isn't finite or is non-positive (which happens\n * during SSR, in headless envs, and briefly during resize on some browsers).\n */\nexport function approximateZoomFromWidths(\n\touterWidth: number,\n\tinnerWidth: number,\n): number {\n\tconst ratio = outerWidth / innerWidth;\n\treturn Number.isFinite(ratio) && ratio > 0 ? ratio : 1;\n}\n\n/**\n * Pure zoom-compensation math: exactly 1 at zoom <= maxZoom, then shrinks as\n * `maxZoom / zoom`, floored at `minCompensation` to guard against inflated\n * ratios from window chrome / side panels making the element unusably small.\n */\nexport function computeZoomCompensation(\n\tzoom: number,\n\tmaxZoom: number,\n\tminCompensation: number,\n): number {\n\treturn Math.max(minCompensation, Math.min(1, maxZoom / zoom));\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pie-players/pie-players-shared",
-	"version": "0.3.58",
+	"version": "0.3.59",
 	"type": "module",
 	"description": "Shared runtime + UI utilities for PIE players",
 	"license": "MIT",
@@ -60,6 +60,10 @@
 		"./nds-icon-button": {
 			"types": "./dist/components/vendor/nds/nds-icon-button.d.ts",
 			"import": "./dist/components/vendor/nds/nds-icon-button.js"
+		},
+		"./ui/zoom-compensation": {
+			"types": "./dist/ui/zoom-compensation.d.ts",
+			"import": "./dist/ui/zoom-compensation.js"
 		}
 	},
 	"files": [