@touchcastllc/napster-companion-api-dev 2.0.0-alpha.3 → 2.0.0-alpha.5

package/lib/types/index.d.ts

@@ -335,7 +335,11 @@ export interface LayoutConfig {
      * - `"inline"`: the avatar renders inside `mountContainer` and fills it. Size
      *   and shape come from how you style that container; `position` is ignored.
      *   When the container has no explicit height, an internal 4:5 ratio is used
-     *   so the avatar is never invisible.
+     *   so the avatar is never invisible. The container's content area must be at
+     *   least 176px wide (132px without screen share) and 80px tall (64px for
+     *   `round`) or the controls clip — the SDK warns in the console when there
+     *   is too little room. See the README, "Inline layout: minimum container
+     *   size".
      */
     type?: "fixed" | "inline";
     /** Position of the avatar on screen. Meaningful only when `type` is

package/lib/utils/containerSizeWatcher.d.ts

@@ -0,0 +1,53 @@
+/**
+ * CA-845 — in inline layout the host sizes the container, so it can be given
+ * less room than the control row needs, and the buttons then clip silently
+ * (WCAG 1.4.10 Reflow needs a stated, testable floor). This watches the
+ * container and warns once when something stops fitting.
+ *
+ * It detects the problem from geometry instead of comparing against a stored
+ * width: the numbers can't drift out of step with the CSS (button size, gaps,
+ * pill padding), and the warning can say exactly how much room is missing.
+ */
+export type FitProblem = {
+    kind: "controls-width";
+    availablePx: number;
+    requiredPx: number;
+} | {
+    kind: "controls-height";
+    availablePx: number;
+    requiredPx: number;
+} | {
+    kind: "entry-text";
+    availablePx: number;
+};
+export interface ContainerSizeWatcher {
+    /** Schedule a measurement now (e.g. controls were just mounted). */
+    check(): void;
+    destroy(): void;
+}
+/**
+ * Measures how the SDK's content sits inside the room the host gave it.
+ *
+ * "Room" is the root's own box, not the container's outer box: the root fills
+ * the container's content area, so the host's border and padding are already
+ * subtracted — which is what the integrator has to account for.
+ *
+ * - `controls-width`: the control row sticks out of its pill. `requiredPx` is
+ *   the available width plus the overflow, i.e. the smallest room the row fits
+ *   in.
+ * - `controls-height`: the pill is cut off by the top or bottom of the room.
+ * - `entry-text`: the entry-point card's text is clipped.
+ *
+ * Returns `[]` before the controls exist.
+ */
+export declare function measureFit(root: HTMLElement): FitProblem[];
+/**
+ * Watches the host container of an inline-layout widget and warns (always —
+ * `critical_warn` ignores debug mode, like other genuine integrator
+ * misconfiguration) when the controls or the start card stop fitting.
+ *
+ * One warning per kind of problem, each time it appears: it re-arms once the
+ * container fits again. Does nothing in fixed layout, where the SDK sizes
+ * itself (240px, wider than any threshold).
+ */
+export declare function createContainerSizeWatcher(root: HTMLElement): ContainerSizeWatcher;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@touchcastllc/napster-companion-api-dev",
-  "version": "2.0.0-alpha.3",
+  "version": "2.0.0-alpha.5",
   "keywords": [
     "napster",
     "companion-api",