@blcklab/anyo-player 0.5.0

package/dist/internal/InteractionPresentationController.js

@@ -0,0 +1,208 @@
+const EMPTY_TARGET = {
+    available: false,
+    entityId: null,
+    primitiveId: null,
+    instanceId: null,
+    distance: null,
+    source: null,
+};
+function normalizeInterval(value) {
+    if (value === undefined || !Number.isFinite(value))
+        return 100;
+    return Math.max(32, Math.min(1000, value));
+}
+function normalizeDistance(value) {
+    if (value === undefined || !Number.isFinite(value))
+        return null;
+    return Math.max(0, value);
+}
+function sameTarget(a, b) {
+    return a.available === b.available
+        && a.entityId === b.entityId
+        && a.primitiveId === b.primitiveId
+        && a.instanceId === b.instanceId
+        && a.distance === b.distance
+        && a.source === b.source;
+}
+function distanceBetween(a, b) {
+    const x = (a[0] ?? 0) - (b[0] ?? 0);
+    const y = (a[1] ?? 0) - (b[1] ?? 0);
+    const z = (a[2] ?? 0) - (b[2] ?? 0);
+    return Math.hypot(x, y, z);
+}
+export class InteractionPresentationController {
+    canvas;
+    callbacks;
+    runtime = null;
+    active = false;
+    timer = null;
+    targetValue = { ...EMPTY_TARGET };
+    selection = null;
+    activating = false;
+    disposed = false;
+    enabled;
+    sampleInterval;
+    maxDistance;
+    constructor(canvas, options, callbacks) {
+        this.canvas = canvas;
+        this.callbacks = callbacks;
+        this.enabled = options.enabled !== false;
+        this.sampleInterval = normalizeInterval(options.sampleInterval);
+        this.maxDistance = normalizeDistance(options.maxDistance);
+    }
+    get target() {
+        return { ...this.targetValue };
+    }
+    get running() {
+        return this.active;
+    }
+    bind(world, renderer) {
+        this.runtime = { world, renderer };
+        if (this.active)
+            this.refreshNow();
+    }
+    unbind() {
+        this.stop();
+        this.runtime = null;
+    }
+    start() {
+        if (!this.enabled || this.disposed || this.active)
+            return;
+        this.active = true;
+        this.refreshNow();
+        this.schedule();
+    }
+    stop() {
+        this.active = false;
+        this.activating = false;
+        this.clearTimer();
+        this.setTarget(EMPTY_TARGET, null, null);
+    }
+    refreshNow() {
+        if (this.disposed || !this.active || !this.runtime) {
+            this.setTarget(EMPTY_TARGET, null, null);
+            return this.target;
+        }
+        try {
+            const rect = this.canvas.getBoundingClientRect();
+            const result = this.runtime.renderer.pick(rect.left + rect.width / 2, rect.top + rect.height / 2);
+            this.applyPick(result);
+        }
+        catch (error) {
+            this.callbacks.onError(error);
+            this.setTarget(EMPTY_TARGET, null, null);
+        }
+        return this.target;
+    }
+    async activate() {
+        if (this.disposed || this.activating || !this.runtime || !this.selection || !this.targetValue.available) {
+            return false;
+        }
+        const target = this.target;
+        this.activating = true;
+        this.callbacks.onActivateStart(target);
+        try {
+            const selected = await this.runtime.world.selectPrimitive({ ...this.selection, source: 'crosshair' });
+            this.callbacks.onActivateComplete(target, selected);
+            return selected;
+        }
+        catch (error) {
+            this.callbacks.onError(error);
+            throw error;
+        }
+        finally {
+            this.activating = false;
+        }
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.stop();
+        this.runtime = null;
+    }
+    applyPick(result) {
+        const runtime = this.runtime;
+        if (!runtime || !result) {
+            this.setTarget(EMPTY_TARGET, null, null);
+            return;
+        }
+        const primitive = runtime.world.compiled?.primitiveById.get(result.primitiveId);
+        if (!primitive?.interaction) {
+            this.setTarget(EMPTY_TARGET, null, null);
+            return;
+        }
+        const distance = result.distance
+            ?? distanceBetween(runtime.renderer.camera.getPosition(), primitive.transform.position ?? [0, 0, 0]);
+        const authoredLimit = primitive.interaction.distance;
+        const effectiveLimit = this.maxDistance === null
+            ? authoredLimit
+            : authoredLimit === undefined
+                ? this.maxDistance
+                : Math.min(authoredLimit, this.maxDistance);
+        if (effectiveLimit !== undefined && distance > effectiveLimit) {
+            this.setTarget(EMPTY_TARGET, null, null);
+            return;
+        }
+        const target = {
+            available: true,
+            entityId: primitive.entityId ?? null,
+            primitiveId: primitive.id,
+            instanceId: result.instanceId ?? null,
+            distance,
+            source: 'reticle',
+        };
+        const context = {
+            trigger: 'reticle',
+            ...(primitive.entityId === undefined ? {} : { entityId: primitive.entityId }),
+            primitiveId: primitive.id,
+            ...(result.instanceId === undefined ? {} : { instanceId: result.instanceId }),
+            source: 'crosshair',
+            ...(primitive.data === undefined ? {} : { data: primitive.data }),
+            ...(primitive.interaction.action === undefined ? {} : { action: primitive.interaction.action }),
+            ...(primitive.interaction.event === undefined ? {} : { event: primitive.interaction.event }),
+            ...(primitive.interaction.params === undefined ? {} : { params: primitive.interaction.params }),
+            distance,
+        };
+        const selection = {
+            primitiveId: result.primitiveId,
+            ...(primitive.entityId === undefined ? {} : { entityId: primitive.entityId }),
+            ...(result.instanceId === undefined ? {} : { instanceId: result.instanceId }),
+            ...(result.point === undefined ? {} : { point: result.point }),
+            ...(result.normal === undefined ? {} : { normal: result.normal }),
+            distance,
+            source: 'crosshair',
+        };
+        this.setTarget(target, context, selection);
+    }
+    setTarget(target, context, selection) {
+        this.selection = selection;
+        if (sameTarget(this.targetValue, target))
+            return;
+        this.targetValue = { ...target };
+        this.callbacks.onTargetChange(this.target, context);
+    }
+    schedule() {
+        this.clearTimer();
+        if (!this.active || this.disposed)
+            return;
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            if (!this.active || this.disposed)
+                return;
+            this.refreshNow();
+            this.schedule();
+        }, this.sampleInterval);
+        if (typeof this.timer === 'object' && this.timer !== null && 'unref' in this.timer) {
+            ;
+            this.timer.unref();
+        }
+    }
+    clearTimer() {
+        if (this.timer === null)
+            return;
+        clearTimeout(this.timer);
+        this.timer = null;
+    }
+}
+//# sourceMappingURL=InteractionPresentationController.js.map

package/dist/internal/InteractionPresentationController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InteractionPresentationController.js","sourceRoot":"","sources":["../../src/internal/InteractionPresentationController.ts"],"names":[],"mappings":"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"}

package/dist/internal/MapController.d.ts

@@ -0,0 +1,16 @@
+import type { AnyoPlayerMapTarget } from '../types.js';
+export declare class MapController {
+    private readonly onAttribution;
+    private readonly targets;
+    private readonly attributionSubscriptions;
+    private disposed;
+    constructor(onAttribution: (text: string | null) => void);
+    register(target: AnyoPlayerMapTarget): () => void;
+    setAttribution(text: string | null): void;
+    pause(): void;
+    resume(): void;
+    dispose(): void;
+    get size(): number;
+    private sync;
+}
+//# sourceMappingURL=MapController.d.ts.map

package/dist/internal/MapController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapController.d.ts","sourceRoot":"","sources":["../../src/internal/MapController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtD,qBAAa,aAAa;IAKZ,OAAO,CAAC,QAAQ,CAAC,aAAa;IAJ1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAA6C;IACtF,OAAO,CAAC,QAAQ,CAAQ;gBAEK,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI;IAEzE,QAAQ,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,IAAI;IA2BjD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAKzC,KAAK,IAAI,IAAI;IAKb,MAAM,IAAI,IAAI;IAKd,OAAO,IAAI,IAAI;IAQf,IAAI,IAAI,WAA+B;IAEvC,OAAO,CAAC,IAAI;CAMb"}

package/dist/internal/MapController.js

@@ -0,0 +1,68 @@
+export class MapController {
+    onAttribution;
+    targets = new Set();
+    attributionSubscriptions = new Map();
+    disposed = false;
+    constructor(onAttribution) {
+        this.onAttribution = onAttribution;
+    }
+    register(target) {
+        if (this.disposed)
+            throw new Error('Anyo Player Map lifecycle has been disposed.');
+        if (!target || typeof target !== 'object' || (typeof target.onPause !== 'function'
+            && typeof target.onResume !== 'function'
+            && typeof target.getAttribution !== 'function'
+            && typeof target.onAttributionChange !== 'function'))
+            throw new TypeError('Map targets must implement lifecycle or attribution methods.');
+        this.targets.add(target);
+        if (typeof target.onAttributionChange === 'function') {
+            const unsubscribe = target.onAttributionChange(() => this.sync());
+            if (typeof unsubscribe === 'function')
+                this.attributionSubscriptions.set(target, unsubscribe);
+        }
+        this.sync();
+        let active = true;
+        return () => {
+            if (!active)
+                return;
+            active = false;
+            this.attributionSubscriptions.get(target)?.();
+            this.attributionSubscriptions.delete(target);
+            this.targets.delete(target);
+            this.sync();
+        };
+    }
+    setAttribution(text) {
+        if (this.disposed)
+            return;
+        this.onAttribution(text);
+    }
+    pause() {
+        if (this.disposed)
+            return;
+        for (const target of this.targets)
+            target.onPause?.();
+    }
+    resume() {
+        if (this.disposed)
+            return;
+        for (const target of this.targets)
+            target.onResume?.();
+    }
+    dispose() {
+        this.disposed = true;
+        for (const unsubscribe of this.attributionSubscriptions.values())
+            unsubscribe();
+        this.attributionSubscriptions.clear();
+        this.targets.clear();
+        this.onAttribution(null);
+    }
+    get size() { return this.targets.size; }
+    sync() {
+        const text = [...this.targets]
+            .map(target => target.getAttribution?.())
+            .find((value) => typeof value === 'string' && Boolean(value.trim())) ?? null;
+        this.onAttribution(text);
+    }
+}
+//# sourceMappingURL=MapController.js.map

package/dist/internal/MapController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapController.js","sourceRoot":"","sources":["../../src/internal/MapController.ts"],"names":[],"mappings":"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"}

package/dist/internal/PerformanceController.d.ts

@@ -0,0 +1,94 @@
+import type { RendererAdapter } from '@blcklab/anyo';
+import { type RendererImageQuality, type RendererOptimizationOptions, type RendererPostProcessing, type RendererShadowOptions } from '@blcklab/sekai64/renderer';
+import type { AnyoPlayerDeviceProfile, AnyoPlayerPerformanceChangeEvent, AnyoPlayerPerformanceOptions, AnyoPlayerPerformanceSnapshot, AnyoPlayerQualityPolicy, AnyoPlayerQualityPreferenceSnapshot, AnyoPlayerQualityPreset, AnyoPlayerQualityStorage, AnyoPlayerResolvedQualityPreset, AnyoPlayerRendererOptions } from '../types.js';
+export declare const ANYO_PLAYER_QUALITY_PREFERENCE_FORMAT: "@blcklab/anyo-player/quality-preference";
+export declare const ANYO_PLAYER_QUALITY_PREFERENCE_VERSION: 1;
+export interface PerformanceControllerDependencies {
+    storage?: AnyoPlayerQualityStorage;
+    rendererOptimization?: Partial<RendererOptimizationOptions>;
+}
+export interface NormalizedPerformanceOptions {
+    enabled: boolean;
+    quality: AnyoPlayerQualityPreset;
+    resolvedQuality: AnyoPlayerResolvedQualityPreset;
+    targetFps: number;
+    dynamicResolution: boolean;
+    minimumScale: number;
+    maximumScale: number;
+    telemetryIntervalMs: number;
+    adjustmentIntervalMs: number;
+    sampleWindow: number;
+    inactiveRenderScale: number;
+    policy: Readonly<AnyoPlayerQualityPolicy>;
+    storageKey: string | null;
+    restoreOnLoad: boolean;
+    saveOnChange: boolean;
+}
+export interface QualityRendererSettings {
+    imageQuality: RendererImageQuality;
+    shadows: RendererShadowOptions;
+    postProcessing: RendererPostProcessing;
+    optimization: RendererOptimizationOptions;
+}
+export declare function detectDeviceProfile(): AnyoPlayerDeviceProfile;
+export declare function resolveAutomaticQuality(profile?: AnyoPlayerDeviceProfile): AnyoPlayerResolvedQualityPreset;
+export declare function normalizePerformanceOptions(value: false | AnyoPlayerPerformanceOptions | undefined): NormalizedPerformanceOptions;
+export declare function qualitySettings(preset: AnyoPlayerResolvedQualityPreset, policy?: AnyoPlayerQualityPolicy): QualityRendererSettings;
+export declare function applyQualityToRendererOptions(renderer: AnyoPlayerRendererOptions, performance: false | AnyoPlayerPerformanceOptions | undefined): AnyoPlayerRendererOptions;
+export declare class PerformanceController {
+    private options;
+    private renderer;
+    private timer;
+    private snapshotValue;
+    private lastScaleAdjustment;
+    private readonly fpsSamples;
+    private active;
+    private activeScaleBeforeInactive;
+    private restored;
+    private readonly storage;
+    private readonly onChange;
+    private readonly onQualityApplied;
+    private readonly rendererOptimization;
+    constructor(value: false | AnyoPlayerPerformanceOptions | undefined, callbacks?: {
+        onChange?: (event: AnyoPlayerPerformanceChangeEvent) => void;
+        onQualityApplied?: (quality: AnyoPlayerResolvedQualityPreset, renderScale: number) => void;
+    }, dependencies?: PerformanceControllerDependencies);
+    get enabled(): boolean;
+    get snapshot(): AnyoPlayerPerformanceSnapshot;
+    get quality(): AnyoPlayerQualityPreset;
+    get preference(): AnyoPlayerQualityPreferenceSnapshot;
+    get deviceProfile(): AnyoPlayerDeviceProfile;
+    get storageKey(): string | null;
+    get storageAvailable(): boolean;
+    get restoreOnLoad(): boolean;
+    get saveOnChange(): boolean;
+    get runtimeOptions(): AnyoPlayerPerformanceOptions | false;
+    attach(renderer: RendererAdapter): void;
+    detach(): void;
+    dispose(): void;
+    setQuality(preset: AnyoPlayerQualityPreset): AnyoPlayerPerformanceSnapshot;
+    setTargetFps(targetFps: number): AnyoPlayerPerformanceSnapshot;
+    setDynamicResolution(enabled: boolean): AnyoPlayerPerformanceSnapshot;
+    setActive(active: boolean): void;
+    restoreConfigured(): Promise<{
+        key: string;
+        snapshot: AnyoPlayerQualityPreferenceSnapshot;
+    } | null>;
+    save(key?: string): Promise<{
+        key: string;
+        snapshot: AnyoPlayerQualityPreferenceSnapshot;
+    }>;
+    load(key?: string): Promise<{
+        key: string;
+        snapshot: AnyoPlayerQualityPreferenceSnapshot;
+    } | null>;
+    clear(key?: string): Promise<string>;
+    sample(): AnyoPlayerPerformanceSnapshot;
+    private applyCurrentQuality;
+    private adjustResolution;
+    private restartTimer;
+    private stopTimer;
+    private resolveStorageKey;
+    private requireStorage;
+}
+//# sourceMappingURL=PerformanceController.d.ts.map

package/dist/internal/PerformanceController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerformanceController.d.ts","sourceRoot":"","sources":["../../src/internal/PerformanceController.ts"],"names":[],"mappings":"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"}