@panelwave/player 1.0.1 → 1.2.0

package/index.d.ts

@@ -1603,6 +1603,31 @@ interface ExtraImage {
 interface Paywall {
     /** Array of paywall rules */
     rules?: PaywallRule[];
+    /**
+     * Display info for the products / subscription tiers the rules reference by
+     * id (format 1.6) — labels, descriptions and prices of the Buy / Subscribe
+     * options (optional)
+     */
+    products?: PaywallProduct[];
+}
+/**
+ * One product or subscription tier from the host's catalogue (format 1.6).
+ * Informational: the rules decide what unlocks what.
+ */
+interface PaywallProduct {
+    /** Id referenced by requiredProductIds / requireEntitlement / subscriptionTiers */
+    id: string;
+    /** Localized product name (optional) */
+    name?: LocalizedString;
+    /** Localized product description (optional) */
+    description?: LocalizedString;
+    /** Display price (optional) */
+    price?: {
+        amount: number;
+        currency: string;
+    };
+    /** One-time purchase or subscription tier (optional, informational) */
+    type?: 'purchase' | 'subscription';
 }
 /**
  * Paywall rule
@@ -1628,7 +1653,7 @@ interface PaywallRule {
     entitlementType?: string;
     /** Tiers that satisfy a subscription rule; empty/absent = any tier (optional) */
     subscriptionTiers?: string[];
-    /** Products that satisfy a purchase rule; empty/absent = any purchase (optional) */
+    /** Products that unlock a purchase rule, any one suffices (format 1.6); absent = requireEntitlement key / any purchase (optional) */
     requiredProductIds?: string[];
     /** Embedded price for display in the paywall overlay (CMS) (optional) */
     price?: {
@@ -1985,6 +2010,26 @@ interface PanelChangeEvent {
     /** Transition used */
     transition?: string;
 }
+/**
+ * Payload of `<pw-player-shell>`'s `(panelChange)` output.
+ *
+ * Panels are keyed by id in `chapter.panels`; the optional `Panel.id` of the
+ * format is not required and is usually absent, so read the id from
+ * `panelId`, not from `panel`.
+ */
+interface PlayerPanelChangeEvent {
+    /** The panel that is now current (the manifest object, variants unresolved). */
+    panel: Panel;
+    /** The chapter the panel belongs to. */
+    chapter: Chapter;
+    /** Id of the current panel: its key in `chapter.panels`. */
+    panelId: string;
+    /**
+     * Id of the panel that was current before this change (it may belong to
+     * the previous chapter). Undefined for the first panel after a (re)load.
+     */
+    previousPanelId?: string;
+}
 /**
  * Decision event payload
  */
@@ -2189,6 +2234,21 @@ interface PaywallGate {
     reason: string;
     /** Preview information (optional) */
     preview?: PreviewInfo;
+    /** Id of the manifest paywall rule that raised the gate (optional) */
+    ruleId?: string;
+    /**
+     * Machine-readable lock reason (optional): `subscription_required`,
+     * `purchase_required`, `age_verification_required` or
+     * `entitlement_required`. The overlay translates it; `reason` stays the
+     * English sentence for hosts.
+     */
+    lockReason?: string;
+    /**
+     * What the reader can buy to pass the gate, derived from the rule
+     * (product ids / subscription tiers, name, price). The built-in overlay
+     * renders them as Buy / Subscribe buttons.
+     */
+    options?: PurchaseInfo[];
 }
 /**
  * Preview information for gated content
@@ -2209,8 +2269,8 @@ interface PurchaseInfo {
     productId: string;
     /** Product name */
     name: string;
-    /** Price with currency */
-    price: {
+    /** Price with currency (optional: not every rule carries one) */
+    price?: {
         amount: number;
         currency: string;
     };
@@ -4154,12 +4214,22 @@ declare class TrackingService {
  *   free preview.
  * - Panel-scoped rules gate exactly their `targetPanelIds` — preview does NOT
  *   override an explicit panel gate.
+ * - Chapter-scoped rules gate only the panels of their chapter(s) (`refId`);
+ *   their free preview counts panels WITHIN that chapter. They take
+ *   precedence over a work gate for those panels.
+ * - Extras-scoped rules never gate panels — they gate the extras block named
+ *   by `refId` (see `isExtraLocked`).
  * - A gated panel unlocks when the gating rule's requirement is satisfied by
  *   the reader's entitlement snapshot.
  */
 
 type EvaluatorEntitlementType = 'free' | 'subscription' | 'purchase' | 'age_gate';
-type EvaluatorScope = 'global' | 'work' | 'chapter' | 'panel';
+/**
+ * `global` is NOT in the schema's scope enum (work | chapter | panel |
+ * extras). It is still accepted as an alias of `work` so old manifests and
+ * CMS-internal rules keep gating; nothing in the player emits it.
+ */
+type EvaluatorScope = 'global' | 'work' | 'chapter' | 'panel' | 'extras';
 /** The rule shape the evaluator needs (a superset of the manifest rule). */
 interface EvaluatorRule {
     id: string;
@@ -4170,12 +4240,28 @@ interface EvaluatorRule {
     subscriptionTiers?: string[];
     /** Products that satisfy a purchase rule; empty/absent = any purchase. */
     requiredProductIds?: string[];
-    /** Minimum age for an age_gate rule (default 18). */
+    /**
+     * Minimum age. For an `age_gate` rule it is the whole requirement (default
+     * 18); on any other rule it is an extra check ON TOP OF the entitlement
+     * (schema `ageGate`): the reader needs both.
+     */
     minimumAge?: number;
     /** Free-preview length for work/global rules (panels in reading order). */
     previewPanelCount?: number;
     /** Panels gated by a panel-scoped rule. */
     targetPanelIds?: string[];
+    /** Chapters (chapter scope) or extras blocks (extras scope) the rule gates — the manifest's `refId`. */
+    targetIds?: string[];
+    /** Reader-facing rule name and description (CMS), for purchase options. */
+    name?: string;
+    description?: string;
+    /** Display price (CMS). */
+    price?: {
+        amount: number;
+        currency: string;
+    };
+    /** The manifest's raw `requireEntitlement` key. */
+    entitlementKey?: string;
 }
 /** What the reader "has" — the shape payments produce and the player consumes. */
 interface EntitlementSnapshot {
@@ -4189,6 +4275,10 @@ interface EntitlementSnapshot {
 interface PanelRef {
     id: string;
     index: number;
+    /** Chapter the panel belongs to (enables chapter-scoped rules). */
+    chapterId?: string;
+    /** Reading-order index within its chapter (chapter-rule preview counting). */
+    chapterIndex?: number;
 }
 type LockReason = 'subscription_required' | 'purchase_required' | 'age_verification_required' | null;
 interface AccessDecision {
@@ -4201,7 +4291,10 @@ interface AccessDecision {
     /** True when access exists only because the panel is inside the free preview. */
     preview: boolean;
 }
-/** Does the reader's snapshot satisfy this rule's requirement? */
+/**
+ * Does the reader's snapshot satisfy this rule's requirement? A rule with a
+ * `minimumAge` needs the age AND its entitlement.
+ */
 declare function satisfiesRule(rule: EvaluatorRule, entitlement: EntitlementSnapshot): boolean;
 /** The active work/global rule (first one wins — mirrors the CMS content map). */
 declare function findWorkGateRule(rules: EvaluatorRule[]): EvaluatorRule | null;
@@ -4209,6 +4302,8 @@ declare function findWorkGateRule(rules: EvaluatorRule[]): EvaluatorRule | null;
  * Evaluate one panel against the rules for a given reader snapshot.
  */
 declare function evaluatePanelAccess(rules: EvaluatorRule[], entitlement: EntitlementSnapshot, panel: PanelRef): AccessDecision;
+/** Is the extras block `extraId` locked by an extras-scoped rule? */
+declare function isExtraLocked(rules: EvaluatorRule[], entitlement: EntitlementSnapshot, extraId: string): boolean;
 /** Evaluate a whole work (panels in reading order). */
 declare function evaluateWorkAccess(rules: EvaluatorRule[], entitlement: EntitlementSnapshot, panels: PanelRef[]): AccessDecision[];
 /** A snapshot with no entitlements — what an anonymous first-time reader has. */
@@ -4222,12 +4317,19 @@ declare const ANONYMOUS_READER: EntitlementSnapshot;
  * `minimumAge` written by the CMS exporter. Prefer the CMS names and fall
  * back to the originals, so a manifest from either era gates identically.
  *
- * A rule with `minimumAge`/`ageGate` but no recognised entitlement type is an
- * age gate — that is the only sane reading of a rule that names an age.
+ * `ageGate` / `minimumAge` is an age check ON TOP OF the entitlement (schema
+ * semantics). Only a rule that declares no entitlement at all but names an
+ * age becomes a pure age gate; a custom marker plus an age stays a purchase
+ * (or subscription) gate that also requires the age.
  */
 declare function fromManifestRule(rule: PaywallRule, index: number): EvaluatorRule;
 /** Normalise every rule in a manifest. Returns [] when the work has no paywall. */
 declare function rulesFromManifest(manifest: PanelWaveManifest | null): EvaluatorRule[];
+/** Chapter id and within-chapter index per panel id (chapter-rule previews). */
+declare function chapterOrderFromManifest(manifest: PanelWaveManifest | null): Map<string, {
+    chapterId: string;
+    chapterIndex: number;
+}>;
 /**
  * Global reading order for preview counting: chapters in array order, and
  * within a chapter the panel declaration order.
@@ -4262,11 +4364,15 @@ declare function toEntitlementStatus(decision: AccessDecision, entitlement: Enti
 declare class PaywallService {
     private rules;
     private readingOrder;
+    private chapterOrder;
     private manifest;
+    private products;
     private snapshotSubject;
     readonly snapshot$: Observable<EntitlementSnapshot>;
     /** Load the rules and reading order from a manifest. Safe to call repeatedly. */
     setManifest(manifest: PanelWaveManifest | null): void;
+    /** `paywall.products` by id (format 1.6); the first entry wins on duplicate ids. */
+    static productsFromManifest(manifest: PanelWaveManifest | null): Map<string, PaywallProduct>;
     /** Replace what the reader owns (after sign-in, or a completed purchase). */
     setSnapshot(snapshot: EntitlementSnapshot | null | undefined): void;
     getSnapshot(): EntitlementSnapshot;
@@ -4282,16 +4388,34 @@ declare class PaywallService {
      * must not be handed out as a free sample.
      */
     evaluate(panelId: string): AccessDecision;
+    /** Is this extras block locked by an extras-scoped rule the reader does not satisfy? */
+    isExtraLocked(extraId: string): boolean;
     /** Convenience: may the reader open this panel? */
     canAccess(panelId: string): boolean;
     /**
      * Describe the gate blocking a panel, or null when it is not gated.
      * The shape is the player's existing `PaywallGate`, so the overlay needs
-     * no changes to render it.
+     * no changes to render it. `locale` picks the language of product names
+     * and descriptions from `paywall.products` (fallback: the work's default
+     * locale).
+     */
+    gateFor(panelId: string, locale?: LocaleCode): PaywallGate | null;
+    /**
+     * What the reader can buy to pass a rule: one option per required product
+     * (purchase) or per subscription tier (subscription). Without explicit
+     * ids, the rule's `requireEntitlement` key names the product, else the
+     * rule id. Age gates and free rules offer nothing to buy.
+     *
+     * Labels (format 1.6): an option whose id has an entry in
+     * `paywall.products` takes that entry's localized name, description and
+     * price. Otherwise it falls back to the rule's name (a single option) or
+     * the bare id (several options), and to the rule's description and price.
      */
-    gateFor(panelId: string): PaywallGate | null;
+    static purchaseOptions(rule: EvaluatorRule, products?: ReadonlyMap<string, PaywallProduct>, locale?: LocaleCode, fallbackLocale?: LocaleCode): PurchaseInfo[];
     /** The rule that gates a panel, for callers that need its price or name. */
     ruleFor(panelId: string): EvaluatorRule | null;
+    /** The work's default locale (product-label fallback). */
+    private get defaultLocale();
     /** Reset to a manifest-less, entitlement-less state. */
     clear(): void;
     /**
@@ -5345,9 +5469,10 @@ declare class PaywallOverlayComponent {
      */
     getMessage(): string;
     /**
-     * Handle purchase option selection
+     * Handle purchase option selection: `purchase` carries the product id,
+     * `action` is 'subscribe' for a subscription option, else 'purchase'.
      */
-    onPurchaseOption(productId: string): void;
+    onPurchaseOption(option: PurchaseInfo): void;
     /**
      * Handle login action
      */
@@ -5444,6 +5569,8 @@ interface AgeVerificationResult {
  * Modal overlay for age verification
  */
 declare class AgeGateComponent {
+    /** Optional: the gate is a public component and works (in English) without ngx-translate. */
+    private readonly translate;
     /**
      * Visibility state
      */
@@ -5490,6 +5617,8 @@ declare class AgeGateComponent {
      * Get warning message
      */
     getWarningMessage(): string;
+    /** Translate an `age_gate.*` UI string (English fallback). */
+    t(key: string, params?: Record<string, unknown>): string;
     /**
      * Handle verification submit
      */
@@ -5506,8 +5635,9 @@ declare class AgeGateComponent {
      * Calculate age from birth date
      */
     private calculateAge;
+    private monthCache?;
     /**
-     * Get month options
+     * Month options, named in the current locale (Intl; cached per locale).
      */
     getMonthOptions(): {
         value: string;
@@ -5537,12 +5667,18 @@ declare class AgeGateComponent {
 interface BranchChoice {
     /** The graph edge this choice traverses. */
     edge: Edge;
-    /** Reader-facing label (edge label → target panel title → "Option N"). */
+    /**
+     * Reader-facing label (edge label → target panel title). Empty: the
+     * chooser shows a translated "Option N".
+     */
     label: string;
     /** Position in the offered list (0-based), stable for tracking. */
     index: number;
 }
 declare class BranchChooserComponent {
+    private readonly translate;
+    /** Translate a `branch_chooser.*` UI string (English fallback). */
+    t(key: string, params?: Record<string, unknown>): string;
     /** Visible state */
     visible: boolean;
     /** Current locale (labels are already resolved by the shell). */
@@ -5582,7 +5718,7 @@ interface EntitlementAdapter {
  * Player Shell Component
  * Main orchestrator for the PanelWave player
  */
-declare class PlayerShellComponent implements OnInit, OnDestroy {
+declare class PlayerShellComponent implements OnInit, OnChanges, OnDestroy {
     /**
      * Manifest to load
      */
@@ -5614,12 +5750,16 @@ declare class PlayerShellComponent implements OnInit, OnDestroy {
     /** Bearer token identifying the reader to `entitlementEndpoint`. */
     readerToken?: string;
     /**
-     * Emitted when a reader acts on the paywall overlay. The host owns
-     * checkout — the player never talks to a payment provider itself.
+     * Emitted when a reader acts on the paywall overlay: `purchase` /
+     * `subscribe` (with the chosen option's `productId` — a product id or a
+     * subscription tier), `login` or `dismiss`. The host owns checkout — the
+     * player never talks to a payment provider itself; call
+     * `refreshEntitlements()` (or pass a new `entitlementSnapshot`) afterwards.
      */
     paywallAction: EventEmitter<{
         action: PaywallAction;
         gate: PaywallGate;
+        productId?: string;
     }>;
     /**
      * Emitted after the reader answers an `age_gate` rule's overlay (verified or
@@ -5711,12 +5851,10 @@ declare class PlayerShellComponent implements OnInit, OnDestroy {
      */
     ready: EventEmitter<void>;
     /**
-     * Panel changed
+     * The current panel changed. Carries the panel's id (`panelId`, its key in
+     * `chapter.panels`) and the id of the panel before it (`previousPanelId`).
      */
-    panelChange: EventEmitter<{
-        panel: Panel;
-        chapter: Chapter;
-    }>;
+    panelChange: EventEmitter<PlayerPanelChangeEvent>;
     /**
      * Chapter changed
      */
@@ -5802,6 +5940,8 @@ declare class PlayerShellComponent implements OnInit, OnDestroy {
      */
     paywallGate: PaywallGate | null;
     paywallVisible: boolean;
+    /** Product id / tier of the overlay option the reader just picked. */
+    paywallProductId?: string;
     /** Adapter built from `entitlementEndpoint`, when the host supplied one. */
     private httpEntitlement?;
     /**
@@ -5969,6 +6109,8 @@ declare class PlayerShellComponent implements OnInit, OnDestroy {
     private analyticsSessionEnded;
     private workCompleteTracked;
     private lastTrackedPanelId?;
+    /** Id of the panel of the last `panelChange` emission (its `previousPanelId` source). */
+    private lastPanelChangeId?;
     /** Bound pagehide handler so add/removeEventListener match. */
     private readonly onPageHide;
     private readonly playerState;
@@ -5978,10 +6120,30 @@ declare class PlayerShellComponent implements OnInit, OnDestroy {
     private readonly translationService;
     private readonly canvasCamera;
     private readonly paywallService;
+    /** ngOnInit ran: later input changes are live updates, not initial values. */
+    private initialized;
+    /** The state subscriptions are set up once per instance, not per (re)load. */
+    private stateSubscribed;
     /**
      * Initialize component
      */
     ngOnInit(): void;
+    /**
+     * Inputs changed after init. The first round (before ngOnInit) is skipped:
+     * ngOnInit reads every input itself, so nothing loads twice.
+     */
+    ngOnChanges(changes: SimpleChanges): void;
+    /**
+     * Reload the work from the current `manifest` / `manifestUrl` inputs
+     * (also the error screen's Retry). Story state of the previous load —
+     * position, variables except persistent ones, open overlays, autoplay —
+     * is reset; the analytics session of the previous work is closed.
+     */
+    reload(): Promise<void>;
+    /** Content locale + GUI language follow `locale`. */
+    private applyLocale;
+    /** Apply a changed `viewModeOverride` to the running view. */
+    private applyViewModeOverride;
     /**
      * Cleanup on destroy
      */
@@ -6041,6 +6203,12 @@ declare class PlayerShellComponent implements OnInit, OnDestroy {
      * one-time `work_complete` signal.
      */
     private trackPanelView;
+    /**
+     * A panel's id: its key in `chapter.panels`. Panels don't reliably carry
+     * their own id (`Panel.id` is optional in the format), so resolve it by
+     * identity, as getCurrentPanelId() does.
+     */
+    private panelIdOf;
     /** An end panel (no outgoing edges) of the manifest's last chapter. */
     private isEndOfWork;
     /**
@@ -6069,8 +6237,11 @@ declare class PlayerShellComponent implements OnInit, OnDestroy {
      * @param transition - Optional transition to render for this panel change
      *   (already resolved against the outputPresets default). Omitted for
      *   non-adjacent jumps (TOC, initial load), which swap instantly.
+     * @param mutations - Variable mutations of the traversed edge. Applied only
+     *   once the navigation is allowed (after the paywall / age gate), so a
+     *   blocked attempt never changes story state.
      */
-    navigateToPanel(chapterId: string, panelId: string, transition?: Transition, cameraMove?: CameraMove): Promise<void>;
+    navigateToPanel(chapterId: string, panelId: string, transition?: Transition, cameraMove?: CameraMove, mutations?: Mutation[]): Promise<void>;
     /**
      * Rebuild the flat variable context handed to the viewport/canvas for
      * hotspot visibleIf evaluation. New object identity per call so OnPush
@@ -6176,6 +6347,8 @@ declare class PlayerShellComponent implements OnInit, OnDestroy {
      * Toolbar event handlers
      */
     onToggleView(): void;
+    /** Land the canvas camera on the current panel (entering canvas view). */
+    private jumpCameraToCurrentPanel;
     /**
      * Tap on a placed panel in canvas view. Traverses the matching out-edge of
      * the current panel when its condition passes (the graph still gates
@@ -6184,6 +6357,12 @@ declare class PlayerShellComponent implements OnInit, OnDestroy {
      * state.
      */
     onCanvasPanelTap(panelId: string): void;
+    /**
+     * The manifest actually loaded — from `manifest` or fetched via
+     * `manifestUrl`. Everything that lists the work (ToC, thumbnails) binds to
+     * this, never to the `manifest` input, which is unset for URL loading.
+     */
+    get loadedManifest(): PanelWaveManifest | undefined;
     /** Balloon defaults for the canvas stage (same source as the viewport). */
     get manifestBalloonConfig(): BalloonConfig | null;
     /** Manifest characters for speech-bubble styling in canvas view. */
@@ -6452,9 +6631,15 @@ declare class PlayerShellComponent implements OnInit, OnDestroy {
     private restoreSocialState;
     /** `bookmarked` is true only while the reader is ON the bookmarked panel. */
     private syncBookmarkFlag;
-    /** More than one edge leaves the current panel — the toolbar shows "Choices". */
+    /**
+     * At least two paths out of the current panel are open right now (edge
+     * conditions evaluated exactly like the chooser does) — the toolbar shows
+     * "Choices". A closed conditional edge does not count.
+     */
     get hasBranchesAhead(): boolean;
-    /** Outgoing edges whose conditions pass right now, with reader-facing labels. */
+    /** Outgoing edges of the current panel whose conditions pass right now. */
+    private openEdges;
+    /** Open outgoing edges with reader-facing labels. */
     private computeBranchChoices;
     private branchLabel;
     private localizedText;
@@ -7185,5 +7370,5 @@ declare class PlayerComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<PlayerComponent, "pw-player", never, {}, {}, never, never, true, never>;
 }
 
-export { ANONYMOUS_READER, ActionModalComponent, AgeGateComponent, AudioEngineService, BranchChooserComponent, CANVAS_PANEL_BUDGET, CanvasCameraService, CanvasStageComponent, ComicBalloon, DEFAULT_BALLOON_CONFIG, DEFAULT_STALL_TIMEOUT_MS, DEFAULT_VIDEO_MUTED, DEFAULT_VIDEO_PLAY_MODE, DEFAULT_VIDEO_START_MODE, EntitlementError, EntitlementService, ExportService, FlowEngineService, HotspotActionService, HotspotsOverlayComponent, HttpEntitlementAdapter, ImageCacheService, ManifestService, MockEntitlementAdapter, NullEntitlementAdapter, PANEL_AUDIO_LEAVE_FADE_MS, PanelAudioService, PaywallOverlayComponent, PaywallService, PlayerComponent, PlayerEvent, PlayerService, PlayerShellComponent, PlayerStateService, PluginHostService, PluginSandboxComponent, PreloadService, PwIconComponent, RESERVED_NAMESPACES, SpeechBubblesComponent, TrackingService, TranslationService, UserGestureService, VISIBILITY_THRESHOLD, VariableStoreService, VideoControllerService, VideoLayerComponent, VideoSequencerService, VisibilityService, applyVariantOverrides, balloonConfigToRenderOptions, balloonConfigToTailOptions, busForRole, createBalloon, evaluatePanelAccess, evaluateWorkAccess, findWorkGateRule, fromManifestRule, mergeBalloonConfig, readingOrderFromManifest, resolveMuted, resolvePanelVariant, resolvePanels, resolvePlayMode, resolveStartMode, resolveVideoConfig, rulesFromManifest, satisfiesRule, selectVariant, toEntitlementStatus };
-export type { AccessDecision, AgeVerificationResult, AssetBase, AssetCatalogItem, AssetCatalogItemAudio, AssetCatalogItemImage, AssetCatalogItemJson, AssetCatalogItemPluginPayload, AssetCatalogItemSubtitle, AssetCatalogItemVector, AssetCatalogItemVideo, AssetCategory, AssetCommon, AssetRef, AssetReference, AssetVariant, Assets, AudioLayer, AudioRole, AudioTrack, AudioVariant, BalloonConfig, BalloonConfigOverride, BalloonOptions, BalloonRenderResult, BalloonType, Bookmark, BoundingBox, BranchChoice, BubbleStyle, BubbleTail, CameraMove, CameraMovePath, CameraState, CameraZoomProfile, CanvasBackground, CanvasCameraPolicy, CanvasDecoration, CanvasFitMode, CanvasFreeRoam, CanvasLayout, CanvasOverviewPolicy, CanvasPlacement, CanvasRevealMode, Chapter, Character$1 as Character, ContentWarning, Creator, DecisionEvent, DeepLinkTarget, DeviceVariables, Edge, EffectiveVideoConfig, EntitlementAdapter$1 as EntitlementAdapter, EntitlementContext, EntitlementErrorCode, EntitlementSnapshot, EntitlementSnapshotResponse, EntitlementStatus, EntitlementVariables, ErrorEvent$1 as ErrorEvent, EvaluatorEntitlementType, EvaluatorRule, EvaluatorScope, ExtraImage, ExtraItem, Extras, FormatView, Graph, HideBorderConfig, Hotspot, HotspotAction, HotspotCircle, HotspotGoToAction, HotspotOpenExtrasAction, HotspotOpenModalAction, HotspotPluginEventAction, HotspotPolygon, HotspotRect, HotspotSetVariablesAction, HotspotShape, HotspotUiEffect, HttpEntitlementAdapterConfig, ImageLayer, ImageVariant, JsonLogic, JsonLogicExpression, JsonValue, JsonVariant, Layer, LayerKind, LayerViewMode, LocaleCode, LocalizedString, LockReason, Meta, Mutation, MutationOperation, NavigationPath, NodeMetadata, NormalizedPoint, NormalizedRect, OutputFormat, OutputPreset, OverlayState, Page, PageLayout, Panel, PanelAudioRole, PanelAudioTrack, PanelChangeEvent, PanelPartial, PanelPlacement, PanelRef, PanelVariant, PanelWaveManifest, PanelwaveHeader, Paywall, PaywallAction, PaywallEvent, PaywallGate$1 as PaywallGate, PaywallRule, PlaybackState, PlayerError, PlayerErrorCode, PlayerEventData, PlayerOptions, PlayerPreferences, PlayerState, PlayerStatistics, PluginInstance$1 as PluginInstance, PluginLayer, PreferenceVariables, PreloadItem, PreloadPriority, PreloadSettings, PreloadStatus$1 as PreloadStatus, PreviewInfo, PurchaseInfo, ReadingProgress, ResolvedPanel, ResolvedPanelAudio, SequenceAudioTrack, SequencedVideo, SequencedVideoInfo, Settings, SpeechBubble, StagePlacement, SubtitleVariant, TailConfig, TailCurve, TailOptions, TextLayer, TextStyle, Tracking, TrackingConfig$1 as TrackingConfig, TrackingEvent, Transform, Transition, TraversalOptions, TraversalResult, UIDefaults, UISettings, UserInfo, UserVariables, VariableChangeEvent, VariableContext, VariableDefinition, VariableMutation, VariableScope, VariableStore, VariableType, VariableValidationResult, Variables, VariantContext, VectorVariant, VideoEvent, VideoLayer, VideoPlayMode, VideoPoster, VideoStartMode, VideoState, VideoStatus, VideoTrackingPayload, VideoTrigger, VideoVariant, ViewMode, ViewportState, VisibilityChange, WorldPoint, WorldRect };
+export { ANONYMOUS_READER, ActionModalComponent, AgeGateComponent, AudioEngineService, BranchChooserComponent, CANVAS_PANEL_BUDGET, CanvasCameraService, CanvasStageComponent, ComicBalloon, DEFAULT_BALLOON_CONFIG, DEFAULT_STALL_TIMEOUT_MS, DEFAULT_VIDEO_MUTED, DEFAULT_VIDEO_PLAY_MODE, DEFAULT_VIDEO_START_MODE, EntitlementError, EntitlementService, ExportService, FlowEngineService, HotspotActionService, HotspotsOverlayComponent, HttpEntitlementAdapter, ImageCacheService, ManifestService, MockEntitlementAdapter, NullEntitlementAdapter, PANEL_AUDIO_LEAVE_FADE_MS, PanelAudioService, PaywallOverlayComponent, PaywallService, PlayerComponent, PlayerEvent, PlayerService, PlayerShellComponent, PlayerStateService, PluginHostService, PluginSandboxComponent, PreloadService, PwIconComponent, RESERVED_NAMESPACES, SpeechBubblesComponent, TrackingService, TranslationService, UserGestureService, VISIBILITY_THRESHOLD, VariableStoreService, VideoControllerService, VideoLayerComponent, VideoSequencerService, VisibilityService, applyVariantOverrides, balloonConfigToRenderOptions, balloonConfigToTailOptions, busForRole, chapterOrderFromManifest, createBalloon, evaluatePanelAccess, evaluateWorkAccess, findWorkGateRule, fromManifestRule, isExtraLocked, mergeBalloonConfig, readingOrderFromManifest, resolveMuted, resolvePanelVariant, resolvePanels, resolvePlayMode, resolveStartMode, resolveVideoConfig, rulesFromManifest, satisfiesRule, selectVariant, toEntitlementStatus };
+export type { AccessDecision, AgeVerificationResult, AssetBase, AssetCatalogItem, AssetCatalogItemAudio, AssetCatalogItemImage, AssetCatalogItemJson, AssetCatalogItemPluginPayload, AssetCatalogItemSubtitle, AssetCatalogItemVector, AssetCatalogItemVideo, AssetCategory, AssetCommon, AssetRef, AssetReference, AssetVariant, Assets, AudioLayer, AudioRole, AudioTrack, AudioVariant, BalloonConfig, BalloonConfigOverride, BalloonOptions, BalloonRenderResult, BalloonType, Bookmark, BoundingBox, BranchChoice, BubbleStyle, BubbleTail, CameraMove, CameraMovePath, CameraState, CameraZoomProfile, CanvasBackground, CanvasCameraPolicy, CanvasDecoration, CanvasFitMode, CanvasFreeRoam, CanvasLayout, CanvasOverviewPolicy, CanvasPlacement, CanvasRevealMode, Chapter, Character$1 as Character, ContentWarning, Creator, DecisionEvent, DeepLinkTarget, DeviceVariables, Edge, EffectiveVideoConfig, EntitlementAdapter$1 as EntitlementAdapter, EntitlementContext, EntitlementErrorCode, EntitlementSnapshot, EntitlementSnapshotResponse, EntitlementStatus, EntitlementVariables, ErrorEvent$1 as ErrorEvent, EvaluatorEntitlementType, EvaluatorRule, EvaluatorScope, ExtraImage, ExtraItem, Extras, FormatView, Graph, HideBorderConfig, Hotspot, HotspotAction, HotspotCircle, HotspotGoToAction, HotspotOpenExtrasAction, HotspotOpenModalAction, HotspotPluginEventAction, HotspotPolygon, HotspotRect, HotspotSetVariablesAction, HotspotShape, HotspotUiEffect, HttpEntitlementAdapterConfig, ImageLayer, ImageVariant, JsonLogic, JsonLogicExpression, JsonValue, JsonVariant, Layer, LayerKind, LayerViewMode, LocaleCode, LocalizedString, LockReason, Meta, Mutation, MutationOperation, NavigationPath, NodeMetadata, NormalizedPoint, NormalizedRect, OutputFormat, OutputPreset, OverlayState, Page, PageLayout, Panel, PanelAudioRole, PanelAudioTrack, PanelChangeEvent, PanelPartial, PanelPlacement, PanelRef, PanelVariant, PanelWaveManifest, PanelwaveHeader, Paywall, PaywallAction, PaywallEvent, PaywallGate$1 as PaywallGate, PaywallProduct, PaywallRule, PlaybackState, PlayerError, PlayerErrorCode, PlayerEventData, PlayerOptions, PlayerPanelChangeEvent, PlayerPreferences, PlayerState, PlayerStatistics, PluginInstance$1 as PluginInstance, PluginLayer, PreferenceVariables, PreloadItem, PreloadPriority, PreloadSettings, PreloadStatus$1 as PreloadStatus, PreviewInfo, PurchaseInfo, ReadingProgress, ResolvedPanel, ResolvedPanelAudio, SequenceAudioTrack, SequencedVideo, SequencedVideoInfo, Settings, SpeechBubble, StagePlacement, SubtitleVariant, TailConfig, TailCurve, TailOptions, TextLayer, TextStyle, Tracking, TrackingConfig$1 as TrackingConfig, TrackingEvent, Transform, Transition, TraversalOptions, TraversalResult, UIDefaults, UISettings, UserInfo, UserVariables, VariableChangeEvent, VariableContext, VariableDefinition, VariableMutation, VariableScope, VariableStore, VariableType, VariableValidationResult, Variables, VariantContext, VectorVariant, VideoEvent, VideoLayer, VideoPlayMode, VideoPoster, VideoStartMode, VideoState, VideoStatus, VideoTrackingPayload, VideoTrigger, VideoVariant, ViewMode, ViewportState, VisibilityChange, WorldPoint, WorldRect };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@panelwave/player",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "description": "Open-source Angular library for PanelWave interactive graphic novels",
   "keywords": [
     "angular",
@@ -19,9 +19,9 @@
     "url": "https://github.com/panelwave/player/issues"
   },
   "peerDependencies": {
-    "@angular/common": "^20.0.0",
-    "@angular/core": "^20.0.0",
-    "@ngx-translate/core": "^17.0.0",
+    "@angular/common": "^20.0.0 || ^21.0.0 || ^22.0.0",
+    "@angular/core": "^20.0.0 || ^21.0.0 || ^22.0.0",
+    "@ngx-translate/core": "^17.0.0 || ^18.0.0",
     "rxjs": "^7.8.0"
   },
   "dependencies": {

package/src/assets/i18n/de.json

@@ -180,7 +180,11 @@
     "sign_in": "Anmelden, um fortzufahren",
     "go_back": "Zurück",
     "maybe_later": "Vielleicht später",
-    "secure_payment": "Sichere Zahlungsabwicklung"
+    "secure_payment": "Sichere Zahlungsabwicklung",
+    "reason_subscription_required": "Dieser Teil der Geschichte ist im Abo enthalten.",
+    "reason_purchase_required": "Dieser Teil der Geschichte ist käuflich erhältlich.",
+    "reason_age_verification_required": "Dieser Inhalt ist altersbeschränkt. Bestätige dein Alter, um fortzufahren.",
+    "reason_entitlement_required": "Für diesen Inhalt ist eine Berechtigung erforderlich."
   },
   "loading": {
     "text": "PanelWave wird geladen..."
@@ -191,5 +195,26 @@
   },
   "common": {
     "esc": "Esc"
+  },
+  "age_gate": {
+    "title": "Altersprüfung erforderlich",
+    "close": "Schließen",
+    "warning": "Dieser Inhalt ist nur für Personen ab {{age}} Jahren freigegeben.",
+    "prompt": "Bitte gib dein Geburtsdatum ein:",
+    "month": "Monat",
+    "day": "Tag",
+    "year": "Jahr",
+    "verify": "Alter bestätigen",
+    "privacy": "Deine Angaben sind privat und werden nicht gespeichert.",
+    "error_incomplete": "Bitte gib dein vollständiges Geburtsdatum ein.",
+    "error_month": "Bitte gib einen gültigen Monat ein (1-12).",
+    "error_day": "Bitte gib einen gültigen Tag ein (1-{{max}}).",
+    "error_year": "Bitte gib ein gültiges Jahr ein (1900-{{max}}).",
+    "error_too_young": "Du musst mindestens {{age}} Jahre alt sein, um diesen Inhalt zu sehen."
+  },
+  "branch_chooser": {
+    "title": "Wähle deinen Weg",
+    "close": "Schließen",
+    "option": "Option {{n}}"
   }
 }

package/src/assets/i18n/en.json

@@ -180,7 +180,11 @@
     "sign_in": "Sign In to Continue",
     "go_back": "Go Back",
     "maybe_later": "Maybe Later",
-    "secure_payment": "Secure payment processing"
+    "secure_payment": "Secure payment processing",
+    "reason_subscription_required": "This part of the story is included with a subscription.",
+    "reason_purchase_required": "This part of the story is available to buy.",
+    "reason_age_verification_required": "This content is age-restricted. Confirm your age to continue.",
+    "reason_entitlement_required": "This content requires an entitlement to access."
   },
   "loading": {
     "text": "Loading PanelWave..."
@@ -191,5 +195,26 @@
   },
   "common": {
     "esc": "Esc"
+  },
+  "age_gate": {
+    "title": "Age Verification Required",
+    "close": "Close",
+    "warning": "This content is restricted to users {{age}} years of age or older.",
+    "prompt": "Please enter your birth date:",
+    "month": "Month",
+    "day": "Day",
+    "year": "Year",
+    "verify": "Verify Age",
+    "privacy": "Your information is private and will not be stored.",
+    "error_incomplete": "Please enter your complete birth date.",
+    "error_month": "Please enter a valid month (1-12).",
+    "error_day": "Please enter a valid day (1-{{max}}).",
+    "error_year": "Please enter a valid year (1900-{{max}}).",
+    "error_too_young": "You must be at least {{age}} years old to access this content."
+  },
+  "branch_chooser": {
+    "title": "Choose your path",
+    "close": "Close",
+    "option": "Option {{n}}"
   }
 }