@panelwave/player 1.3.0 → 1.5.0

package/index.d.ts

@@ -401,10 +401,12 @@ interface BalloonConfig {
     balloonType: BalloonType;
     /** 0-1 (0=rectangle, 1=ellipse) */
     cornerRadius: number;
-    /** Pixels */
+    /** Authored width in px — the floor; with textFit 'grow' the body grows for longer text */
     maxWidth: number;
-    /** Pixels */
+    /** Authored height in px — the floor; with textFit 'grow' the body grows for longer text */
     maxHeight: number;
+    /** grow (default): the balloon grows when the text needs more room; fixed: keeps the authored size (schema 1.8.0) */
+    textFit?: 'grow' | 'fixed';
     /** CSS font-family */
     fontFamily: string;
     /** Pixels */
@@ -5340,6 +5342,16 @@ declare function balloonConfigToTailOptions(config: BalloonConfig): {
     curveAmount: number;
 } | null;
 
+/**
+ * How a balloon treats text that needs more room than its authored size
+ * (`maxWidth × maxHeight`, schema 1.8 `BalloonConfig.textFit`):
+ * - `grow` (default): the balloon grows beyond the authored size until the
+ *   text fits — proportionally first (the shape keeps its aspect ratio), then
+ *   in height; see {@link BALLOON_GROWTH_MAX}.
+ * - `fixed`: the balloon keeps its authored size and the text spills over the
+ *   edges (pre-1.8 behaviour); `textOverflows` reports it.
+ */
+type BalloonTextFit = 'grow' | 'fixed';
 interface BalloonPadding {
     top: number;
     right: number;
@@ -5347,8 +5359,12 @@ interface BalloonPadding {
     left: number;
 }
 interface BalloonOptions {
+    /** Authored width in px; 0 = natural width. With textFit 'grow' the body may become wider. */
     maxWidth: number;
+    /** Authored height in px; 0 = natural height. With textFit 'grow' the body may become taller. */
     maxHeight: number;
+    /** What happens when the text needs more room than the authored size (default 'grow'). */
+    textFit: BalloonTextFit;
     padding: BalloonPadding;
     strokeWidth: number;
     strokeColor: string;
@@ -5390,10 +5406,19 @@ interface CutOptions {
     bottom?: boolean;
 }
 interface BalloonRenderResult {
+    /** Rendered body width (the authored width, or more when the balloon grew). */
     width: number;
+    /** Rendered body height (the authored height, or more when the balloon grew). */
     height: number;
+    /** The authored body size the growth started from (maxWidth/maxHeight, or the natural size for 0). */
+    authoredWidth: number;
+    authoredHeight: number;
+    /** True when the body is larger than the authored size because the text needed more room. */
+    grown: boolean;
+    /** Proportional growth factor applied to the authored size (1 when not grown). */
+    growth: number;
     svg: SVGSVGElement;
-    /** True when the text needs more height than a fixed maxHeight allows (it is cut off). */
+    /** True when the text needs more height than the body gives it (textFit 'fixed' only). */
     textOverflows: boolean;
     balloon: ComicBalloon;
     update: (newText?: string, newTailOptions?: TailOptions | null) => BalloonRenderResult;
@@ -7543,6 +7568,14 @@ declare class SpeechBubblesComponent implements OnChanges, AfterViewInit, OnDest
     }>;
     /** Rendered balloon containers, keyed by bubble ID */
     private renderedBalloons;
+    /**
+     * Font specs ("15px 'Ames Italic', sans-serif") whose loading this overlay
+     * already requested. Web fonts load lazily on first use, so the first
+     * render may have measured with a fallback face while document.fonts.ready
+     * had long resolved (no font was in flight yet). Each new spec is loaded
+     * explicitly and the balloons re-render once it arrives.
+     */
+    private fontsRequested;
     /** ResizeObserver for container size tracking */
     private resizeObserver;
     private initialized;
@@ -7573,6 +7606,12 @@ declare class SpeechBubblesComponent implements OnChanges, AfterViewInit, OnDest
      * Render all speech balloons into the DOM
      */
     renderAllBalloons(): void;
+    /**
+     * Request every font spec the balloons use that was not requested before;
+     * re-render once a face that was not yet available arrives, so balloons
+     * measured with a fallback face are laid out again with the real one.
+     */
+    private ensureFontsLoaded;
     /**
      * Handle bubble click (called from template for any fallback interaction)
      */
@@ -7598,6 +7637,11 @@ declare class HotspotsOverlayComponent implements OnChanges {
      * Hotspots of the current panel (manifest shape)
      */
     hotspots: Hotspot[];
+    /**
+     * The panel's speech bubbles: a choice hotspot whose label is already
+     * lettered as a bubble keeps its invisible area under `display: auto`.
+     */
+    bubbles: SpeechBubble[];
     /**
      * Current locale for label resolution
      */
@@ -7687,7 +7731,7 @@ declare class HotspotsOverlayComponent implements OnChanges {
     private centroidOf;
     private clamp01;
     static ɵfac: i0.ɵɵFactoryDeclaration<HotspotsOverlayComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<HotspotsOverlayComponent, "pw-hotspots-overlay", never, { "hotspots": { "alias": "hotspots"; "required": false; }; "locale": { "alias": "locale"; "required": false; }; "containerWidth": { "alias": "containerWidth"; "required": false; }; "containerHeight": { "alias": "containerHeight"; "required": false; }; "context": { "alias": "context"; "required": false; }; "interactive": { "alias": "interactive"; "required": false; }; "showIndicators": { "alias": "showIndicators"; "required": false; }; }, { "hotspotActivate": "hotspotActivate"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<HotspotsOverlayComponent, "pw-hotspots-overlay", never, { "hotspots": { "alias": "hotspots"; "required": false; }; "bubbles": { "alias": "bubbles"; "required": false; }; "locale": { "alias": "locale"; "required": false; }; "containerWidth": { "alias": "containerWidth"; "required": false; }; "containerHeight": { "alias": "containerHeight"; "required": false; }; "context": { "alias": "context"; "required": false; }; "interactive": { "alias": "interactive"; "required": false; }; "showIndicators": { "alias": "showIndicators"; "required": false; }; }, { "hotspotActivate": "hotspotActivate"; }, never, never, true, never>;
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@panelwave/player",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "Open-source Angular library for PanelWave interactive graphic novels",
   "keywords": [
     "angular",

package/src/assets/fonts/balloon/LICENSES.md

@@ -25,9 +25,9 @@ License text: https://openfontlicense.org/open-font-license-official-text/
 
 ## Deliberately NOT included
 
-**Ames Pro** (`amespro-*`, by Blambot Comic Fonts) is a **commercial** font and
+**Ames Pro** (`amespro-*`, by Purastik Graphics) is a **commercial** font and
 is not part of this MIT-licensed package (the files are gitignored). Host
-applications that use it must license it from https://blambot.com and provide
+applications that use it must license it (web-font license) from https://www.fontspring.com/fonts/purastik-graphics/ames-pro and provide
 their own `@font-face` declarations for `'Ames Italic'`, `'Ames Bold Italic'`
 and `'Ames Regular'`. The player's default font stack falls back to Comic Neue
 when Ames is unavailable.

package/src/assets/fonts/balloon/balloon-fonts.css

@@ -4,7 +4,7 @@
  * All families here are open-licensed (SIL OFL 1.1, from Google Fonts) and
  * ship with the @panelwave/player package — see LICENSES.md in this folder.
  *
- * The Ames Pro family (Blambot, commercial) is deliberately NOT included —
+ * The Ames Pro family (Purastik Graphics, commercial) is deliberately NOT included —
  * neither here nor in works exported from the PanelWave CMS. PanelWave's own
  * players (CMS preview, read.panelwave.org) load it under PanelWave's
  * license, which covers PanelWave's domains only. Self-hosting a work whose