@bardway/trpg-pixi 0.0.0-stage → 0.1.0

package/dist/StoryEventCoordinator.d.ts

@@ -0,0 +1,61 @@
+import type { StoryCuePlaybackControls } from './story/StoryContentSurface.js';
+export interface StoryEventCoordinatorScheduler {
+    setTimeout(callback: () => void, delayMs: number): unknown;
+    clearTimeout(handle: unknown): void;
+}
+export interface StoryPresentationPort<TCue> {
+    playCue: (cue: TCue, controls: StoryCuePlaybackControls) => void;
+}
+export interface StoryEventCoordinatorCallbacks<TState, TCue> extends StoryPresentationPort<TCue> {
+    applyState: (state: TState) => void;
+}
+export interface StoryEventCoordinatorOptions<TState, TCue> {
+    createInitialState: () => TState;
+    callbacks: StoryEventCoordinatorCallbacks<TState, TCue>;
+    pendingStateTimeoutMs?: number;
+    dedupeLimit?: number;
+    scheduler?: StoryEventCoordinatorScheduler;
+}
+export interface CoordinatedStoryCue<TState> {
+    eventId: string;
+    targetRevision: number;
+    finalState: TState;
+}
+export declare class StoryEventCoordinator<TState extends {
+    revision: number;
+}, TCue extends CoordinatedStoryCue<TState>> {
+    private readonly options;
+    private readonly callbacks;
+    private readonly pendingStateTimeoutMs;
+    private readonly dedupeLimit;
+    private readonly scheduler;
+    private currentState;
+    private pendingState;
+    private deferredState;
+    private activeBlockingCue;
+    private readonly blockingCueQueue;
+    private readonly activeCueControllers;
+    private readonly seenEventIds;
+    private readonly seenEventOrder;
+    constructor(options: StoryEventCoordinatorOptions<TState, TCue>);
+    replaceSnapshot(state: TState): void;
+    handleState(event: {
+        eventId: string;
+        state: TState;
+    }): void;
+    handleSnapshot(state: TState): void;
+    private handleIncomingState;
+    handleCue(cue: TCue): void;
+    abort(reason?: string): void;
+    reset(reason?: string): void;
+    private handleBlockingCue;
+    private startNextBlockingCue;
+    private schedulePendingState;
+    private applyState;
+    private flushDeferredState;
+    private clearPendingState;
+    private abortActiveCues;
+    private abortCueController;
+    private releaseCueController;
+    private rememberEventId;
+}

package/dist/effects/PixiEffectLayerRegistry.d.ts

@@ -0,0 +1,54 @@
+import type { Container } from 'pixi.js';
+import { PixiEffectScope } from './PixiEffectScope.js';
+import type { PixiContainerConstructor, PixiSceneGraph } from '../PixiSceneGraph.js';
+export type PixiEffectLayerName = 'worldUnderlayFxLayer' | 'worldOverlayFxLayer' | 'cinematicLayer' | 'presentationLayer' | 'screenFxLayer' | 'modalLayer' | 'fieldFxLayer' | 'battlePictureFxLayer' | 'comboFxLayer' | 'globalFxLayer';
+export type PixiEffectLayerOwner = 'battle-world' | 'battle-action' | 'battle-cinematic' | 'scene-transition' | 'story-presentation' | 'story-reveal' | 'story-dice-result' | 'battle-summary' | 'session-field' | 'battle-picture' | 'combo' | 'session-global';
+export interface PixiEffectLayerOwnerByLayer {
+    worldUnderlayFxLayer: 'battle-world' | 'battle-action';
+    worldOverlayFxLayer: 'battle-action';
+    cinematicLayer: 'battle-cinematic';
+    presentationLayer: 'scene-transition';
+    screenFxLayer: 'story-presentation' | 'scene-transition';
+    modalLayer: 'story-reveal' | 'story-dice-result' | 'battle-summary' | 'scene-transition';
+    fieldFxLayer: 'session-field';
+    battlePictureFxLayer: 'battle-picture';
+    comboFxLayer: 'combo';
+    globalFxLayer: 'session-global';
+}
+export type PixiEffectLayerOverrides = {
+    [Layer in PixiEffectLayerName]?: PixiEffectLayerOwnerByLayer[Layer];
+};
+/** A stable renderer-owned branch. Reset releases transient scopes without destroying the branch. */
+export declare class PixiEffectLayerOwnerHandle {
+    readonly owner: PixiEffectLayerOwner;
+    private readonly layers;
+    private readonly scopes;
+    private destroyed;
+    constructor(owner: PixiEffectLayerOwner, layers: ReadonlyMap<PixiEffectLayerName, Container>);
+    getLayer(layer: PixiEffectLayerName): Container;
+    createScope(): PixiEffectScope;
+    reset(): void;
+    destroy(): void;
+}
+/** Owns the fixed child branches inside the renderer's shared physical effect layers. */
+export declare class PixiEffectLayerRegistry {
+    private readonly handles;
+    private destroyed;
+    constructor(scene: PixiSceneGraph, ContainerConstructor: PixiContainerConstructor);
+    get(owner: PixiEffectLayerOwner): PixiEffectLayerOwnerHandle;
+    createSceneView(scene: PixiSceneGraph, overrides: PixiEffectLayerOverrides): PixiSceneGraph;
+    reset(): void;
+    destroy(): void;
+}
+export declare const PIXI_EFFECT_LAYER_OWNER_ORDER: {
+    readonly battlePictureFxLayer: readonly "battle-picture"[];
+    readonly comboFxLayer: readonly "combo"[];
+    readonly fieldFxLayer: readonly "session-field"[];
+    readonly globalFxLayer: readonly "session-global"[];
+    readonly modalLayer: readonly ("scene-transition" | "story-reveal" | "story-dice-result" | "battle-summary")[];
+    readonly cinematicLayer: readonly "battle-cinematic"[];
+    readonly worldUnderlayFxLayer: readonly ("battle-world" | "battle-action")[];
+    readonly worldOverlayFxLayer: readonly "battle-action"[];
+    readonly presentationLayer: readonly "scene-transition"[];
+    readonly screenFxLayer: readonly ("scene-transition" | "story-presentation")[];
+};

package/dist/effects/PixiEffectScope.d.ts

@@ -0,0 +1,20 @@
+import type { Container, Filter, Ticker } from 'pixi.js';
+import type { PixiAnimationActivity } from '../PixiAnimationActivity.js';
+/**
+ * Owns every short-lived resource created by an effect. Releasing a scope is
+ * idempotent so reset, scene changes and context restoration share one path.
+ */
+export declare class PixiEffectScope {
+    private readonly controller;
+    private readonly cleanups;
+    private released;
+    get signal(): AbortSignal;
+    addNode(node: Container): void;
+    addFilter(filter: Filter): void;
+    addTicker(ticker: Ticker, callback: (ticker: Ticker) => void): void;
+    addActivity(activity: PixiAnimationActivity, reason: string): void;
+    defer(cleanup: () => void): void;
+    reset(): void;
+    destroy(): void;
+    release(): void;
+}

package/dist/effects/PixiStableRandom.d.ts

@@ -0,0 +1,2 @@
+export declare const stableUnit: (seed: string, channel?: number) => number;
+export declare const stableRange: (seed: string, min: number, max: number, channel?: number) => number;

package/dist/index.d.ts

@@ -0,0 +1,92 @@
+export * from './PixiAnimationActivity.js';
+export * from './PixiAnimationDirector.js';
+export * from './PixiApplicationFactory.js';
+export * from './PixiAssetManager.js';
+export * from './PixiBattleCinematicSurface.js';
+export * from './PixiBattleFxResources.js';
+export * from './PixiBattleLightningResources.js';
+export * from './PixiBattleMapDissolve.js';
+export * from './PixiBattleSceneTransition.js';
+export * from './PixiBattleTokenLifecycleCoordinator.js';
+export * from './PixiBattleWhipGeometry.js';
+export * from './PixiBattleWhipResources.js';
+export * from './PixiCurrentActorCardGlow.js';
+export * from './PixiCurrentActorHalo.js';
+export * from './PixiDirectionalMotionBlur.js';
+export * from './PixiInvestigatorDossierInsanityFilter.js';
+export * from './PixiLocalGlowMesh.js';
+export * from './PixiMapEdgeShadow.js';
+export * from './PixiMediaBreathRuntime.js';
+export * from './PixiMotion.js';
+export * from './PixiObjectiveBreathingGlow.js';
+export * from './PixiPersistentEffectTransition.js';
+export * from './PixiPreludeStoryTransition.js';
+export * from './PixiRetainedMeterAnimator.js';
+export * from './PixiRuntimeContext.js';
+export * from './PixiSceneGraph.js';
+export * from './PixiStageMetrics.js';
+export * from './PixiStoryArchiveMotion.js';
+export * from './PixiTeamCheckCinematic.js';
+export * from './PixiVideoRuntime.js';
+export * from './PixiViewportController.js';
+export * from './BattlePresentationPoseRegistry.js';
+export * from './BattlePresentationRecipe.js';
+export * from './BattleSequenceScheduler.js';
+export * from './BattleActionPresentationRecipes.js';
+export * from './PixiBattleActionRecipes.js';
+export * from './effects/PixiEffectLayerRegistry.js';
+export * from './effects/PixiEffectScope.js';
+export * from './effects/PixiStableRandom.js';
+export * from './story/StoryTimelineClock.js';
+export * from './story/StoryImageFilter.js';
+export * from './story/StoryVisualMath.js';
+export * from './PixiShaderRuntime.js';
+export * from './PixiStageTheme.js';
+export * from './DisplayEventQueue.js';
+export * from './AnimationMilestones.js';
+export * from './PixiSessionLayout.js';
+export * from './PixiMapWorldUtils.js';
+export * from './PixiTypography.js';
+export * from './ui/PixiStagePrimitives.js';
+export * from './BattleFxLibrary.js';
+export * from './BattlePresentationEngine.js';
+export * from './PixiStageFontLoader.js';
+export * from './PixiDisplayRenderer.js';
+export * from './RetainedStageSurface.js';
+export * from './BattleActionMotionMath.js';
+export * from './PixiBattleVisualLayout.js';
+export * from './PixiBattleEntryTransition.js';
+export * from './PixiStoryCardCut.js';
+export * from './PixiBattleWhipMotion.js';
+export * from './story/PixiStoryPresentationEngine.js';
+export * from './story/StoryContentSurface.js';
+export * from './PixiEffectPlugin.js';
+export * from './SessionSceneRegistry.js';
+export * from './SessionSceneHistory.js';
+export * from './PixiSessionSkin.js';
+export * from './SessionFieldEffectRuntime.js';
+export * from './PixiBattleGrid.js';
+export * from './StoryEventCoordinator.js';
+export * from './PixiTokenWorld.js';
+export * from './PixiMapMediaSurface.js';
+export * from './PixiCombatMotion.js';
+export * from './PixiTokenPersistentStatus.js';
+export * from './PixiEndingSurface.js';
+export * from './PixiPreludeSurface.js';
+export * from './PixiPortraitResourceCard.js';
+export * from './PixiPartyHudSurface.js';
+export * from './PixiStoryWorkspaceSurface.js';
+export * from './PixiStorySurface.js';
+export * from './PixiBattleFieldSurface.js';
+export * from './ResultEffectTuning.js';
+export * from './PixiResultEffectSurface.js';
+export * from './PixiSummaryBoardSurface.js';
+export * from './PixiBattleHudPorts.js';
+export * from './PixiBattleHudSurface.js';
+export * from './PixiScenePresentationDirector.js';
+export * from './PixiSystemHudSurface.js';
+export * from './PixiCameraFocusController.js';
+export * from './PixiProgressCinematic.js';
+export * from './PixiSceneMotionPorts.js';
+export * from './PixiSceneMotion.js';
+export * from './PixiTextTransitionEffect.js';