@konitif/viewer-3d 0.284.1

package/dist/renderer/ViewerExperimentCollector.d.ts

@@ -0,0 +1,27 @@
+import type { ViewerMetadata } from './ViewerMetadata.js';
+/** Collector supplied for one viewer protocol adapter. The provider owns
+ * admission, retained observations, summaries and output formats.
+ * Timestamps are milliseconds; no clock or scheduling is owned by this port.
+ */
+export interface ViewerExperimentCollector<Artifact, Snapshot> {
+    start(input: {
+        runId: string;
+        conditionId: string;
+        startedAtMs: number;
+        environment: ViewerMetadata;
+    }): void;
+    markPhase(phaseId: string, observedAtMs: number, provenance?: ViewerMetadata): boolean;
+    record(input: {
+        observedAtMs: number;
+        metrics: Readonly<Record<string, number | null | undefined>>;
+        provenance?: ViewerMetadata;
+    }): boolean;
+    stop(input: {
+        endedAtMs: number;
+        status?: 'completed' | 'invalid';
+        reason?: string | null;
+    }): Artifact;
+    isRecording(): boolean;
+    snapshot(): Snapshot;
+}
+//# sourceMappingURL=ViewerExperimentCollector.d.ts.map

package/dist/renderer/ViewerExperimentCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerExperimentCollector.d.ts","sourceRoot":"","sources":["../../src/renderer/ViewerExperimentCollector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,yBAAyB,CAAC,QAAQ,EAAE,QAAQ;IAC3D,KAAK,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,cAAc,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7G,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;IACvF,MAAM,CAAC,KAAK,EAAE;QACZ,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC;QAC7D,UAAU,CAAC,EAAE,cAAc,CAAC;KAC7B,GAAG,OAAO,CAAC;IACZ,IAAI,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,QAAQ,CAAC;IACvG,WAAW,IAAI,OAAO,CAAC;IACvB,QAAQ,IAAI,QAAQ,CAAC;CACtB"}

package/dist/renderer/ViewerExperimentCollector.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ViewerExperimentCollector.js.map

package/dist/renderer/ViewerExperimentCollector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerExperimentCollector.js","sourceRoot":"","sources":["../../src/renderer/ViewerExperimentCollector.ts"],"names":[],"mappings":""}

package/dist/renderer/ViewerExperimentPort.d.ts

@@ -0,0 +1,19 @@
+import type { ViewerMetadata } from './ViewerMetadata.js';
+/** Caller-provided context; the viewer supplies its current mode and configuration. */
+export interface ViewerExperimentStart {
+    runId: string;
+    startedAtMs: number;
+    environment: ViewerMetadata;
+}
+/** Public experiment control, distinct from the collector's measurement sink.
+ * Artifact and Snapshot belong to the supplied experiment provider. This port
+ * neither interprets their schema nor owns collection, admission or persistence.
+ * Timestamps are milliseconds; provider errors and output references propagate.
+ */
+export interface ViewerExperimentPort<Artifact, Snapshot> {
+    startTemporalProjectionExperiment(input: ViewerExperimentStart): Snapshot;
+    markTemporalProjectionExperimentPhase(phaseId: string, observedAtMs: number, provenance?: ViewerMetadata): boolean;
+    stopTemporalProjectionExperiment(endedAtMs: number): Artifact;
+    getTemporalProjectionExperimentSnapshot(): Snapshot;
+}
+//# sourceMappingURL=ViewerExperimentPort.d.ts.map

package/dist/renderer/ViewerExperimentPort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerExperimentPort.d.ts","sourceRoot":"","sources":["../../src/renderer/ViewerExperimentPort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,uFAAuF;AACvF,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,cAAc,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB,CAAC,QAAQ,EAAE,QAAQ;IACtD,iCAAiC,CAAC,KAAK,EAAE,qBAAqB,GAAG,QAAQ,CAAC;IAC1E,qCAAqC,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;IACnH,gCAAgC,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC9D,uCAAuC,IAAI,QAAQ,CAAC;CACrD"}

package/dist/renderer/ViewerExperimentPort.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ViewerExperimentPort.js.map

package/dist/renderer/ViewerExperimentPort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerExperimentPort.js","sourceRoot":"","sources":["../../src/renderer/ViewerExperimentPort.ts"],"names":[],"mappings":""}

package/dist/renderer/ViewerFrameSignals.d.ts

@@ -0,0 +1,13 @@
+export type ViewerFrameSignalId = 'animation-pose' | 'physics-step' | 'physics-observation' | 'temporal-projection' | 'controls' | 'render' | 'runtime-history' | 'diagnostics';
+export type ViewerFrameSignalCadence = 'raf' | 'fixed' | 'event';
+export interface ViewerFrameSignalDefinition {
+    id: ViewerFrameSignalId;
+    profilerLabel: string;
+    authority: 'session' | 'physics-worker' | 'viewer' | 'user';
+    cadence: ViewerFrameSignalCadence;
+    targetRateHz: number | null;
+    invalidates: readonly ViewerFrameSignalId[];
+}
+export declare const VIEWER_FRAME_SIGNAL_CATALOG: Readonly<Record<ViewerFrameSignalId, ViewerFrameSignalDefinition>>;
+export declare function resolveViewerFrameSignalIntervalMs(signalId: ViewerFrameSignalId, targetRateHz?: number | null): number;
+//# sourceMappingURL=ViewerFrameSignals.d.ts.map

package/dist/renderer/ViewerFrameSignals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerFrameSignals.d.ts","sourceRoot":"","sources":["../../src/renderer/ViewerFrameSignals.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAC3B,gBAAgB,GAChB,cAAc,GACd,qBAAqB,GACrB,qBAAqB,GACrB,UAAU,GACV,QAAQ,GACR,iBAAiB,GACjB,aAAa,CAAC;AAElB,MAAM,MAAM,wBAAwB,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC;AAEjE,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,mBAAmB,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,SAAS,GAAG,gBAAgB,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC5D,OAAO,EAAE,wBAAwB,CAAC;IAClC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAC7C;AAED,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,MAAM,CAAC,mBAAmB,EAAE,2BAA2B,CAAC,CAiE1G,CAAC;AAEF,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,mBAAmB,EAC7B,YAAY,gBAAqD,GAChE,MAAM,CAMR"}

package/dist/renderer/ViewerFrameSignals.js

@@ -0,0 +1,73 @@
+export const VIEWER_FRAME_SIGNAL_CATALOG = {
+    'animation-pose': {
+        id: 'animation-pose',
+        profilerLabel: 'POSE',
+        authority: 'session',
+        cadence: 'raf',
+        targetRateHz: null,
+        invalidates: ['render']
+    },
+    'physics-step': {
+        id: 'physics-step',
+        profilerLabel: 'PHY',
+        authority: 'physics-worker',
+        cadence: 'fixed',
+        targetRateHz: 30,
+        invalidates: ['physics-observation']
+    },
+    'physics-observation': {
+        id: 'physics-observation',
+        profilerLabel: 'OBS',
+        authority: 'physics-worker',
+        cadence: 'event',
+        targetRateHz: null,
+        invalidates: ['temporal-projection', 'runtime-history', 'diagnostics']
+    },
+    'temporal-projection': {
+        id: 'temporal-projection',
+        profilerLabel: 'PRJ',
+        authority: 'viewer',
+        cadence: 'raf',
+        targetRateHz: null,
+        invalidates: ['render']
+    },
+    controls: {
+        id: 'controls',
+        profilerLabel: 'CTRL',
+        authority: 'user',
+        cadence: 'event',
+        targetRateHz: null,
+        invalidates: ['render']
+    },
+    render: {
+        id: 'render',
+        profilerLabel: 'RND',
+        authority: 'viewer',
+        cadence: 'raf',
+        targetRateHz: null,
+        invalidates: []
+    },
+    'runtime-history': {
+        id: 'runtime-history',
+        profilerLabel: 'HIST',
+        authority: 'viewer',
+        cadence: 'fixed',
+        targetRateHz: 30,
+        invalidates: []
+    },
+    diagnostics: {
+        id: 'diagnostics',
+        profilerLabel: 'DIAG',
+        authority: 'viewer',
+        cadence: 'fixed',
+        targetRateHz: 2,
+        invalidates: []
+    }
+};
+export function resolveViewerFrameSignalIntervalMs(signalId, targetRateHz = VIEWER_FRAME_SIGNAL_CATALOG[signalId].targetRateHz) {
+    if (targetRateHz === null || !Number.isFinite(targetRateHz) || targetRateHz <= 0) {
+        return 0;
+    }
+    return 1000 / Math.max(1, Math.min(240, targetRateHz));
+}
+//# sourceMappingURL=ViewerFrameSignals.js.map

package/dist/renderer/ViewerFrameSignals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerFrameSignals.js","sourceRoot":"","sources":["../../src/renderer/ViewerFrameSignals.ts"],"names":[],"mappings":"AAqBA,MAAM,CAAC,MAAM,2BAA2B,GAAuE;IAC7G,gBAAgB,EAAE;QAChB,EAAE,EAAE,gBAAgB;QACpB,aAAa,EAAE,MAAM;QACrB,SAAS,EAAE,SAAS;QACpB,OAAO,EAAE,KAAK;QACd,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,CAAC,QAAQ,CAAC;KACxB;IACD,cAAc,EAAE;QACd,EAAE,EAAE,cAAc;QAClB,aAAa,EAAE,KAAK;QACpB,SAAS,EAAE,gBAAgB;QAC3B,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,EAAE;QAChB,WAAW,EAAE,CAAC,qBAAqB,CAAC;KACrC;IACD,qBAAqB,EAAE;QACrB,EAAE,EAAE,qBAAqB;QACzB,aAAa,EAAE,KAAK;QACpB,SAAS,EAAE,gBAAgB;QAC3B,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,CAAC,qBAAqB,EAAE,iBAAiB,EAAE,aAAa,CAAC;KACvE;IACD,qBAAqB,EAAE;QACrB,EAAE,EAAE,qBAAqB;QACzB,aAAa,EAAE,KAAK;QACpB,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,KAAK;QACd,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,CAAC,QAAQ,CAAC;KACxB;IACD,QAAQ,EAAE;QACR,EAAE,EAAE,UAAU;QACd,aAAa,EAAE,MAAM;QACrB,SAAS,EAAE,MAAM;QACjB,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,CAAC,QAAQ,CAAC;KACxB;IACD,MAAM,EAAE;QACN,EAAE,EAAE,QAAQ;QACZ,aAAa,EAAE,KAAK;QACpB,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,KAAK;QACd,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,EAAE;KAChB;IACD,iBAAiB,EAAE;QACjB,EAAE,EAAE,iBAAiB;QACrB,aAAa,EAAE,MAAM;QACrB,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,EAAE;QAChB,WAAW,EAAE,EAAE;KAChB;IACD,WAAW,EAAE;QACX,EAAE,EAAE,aAAa;QACjB,aAAa,EAAE,MAAM;QACrB,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,EAAE;KAChB;CACF,CAAC;AAEF,MAAM,UAAU,kCAAkC,CAChD,QAA6B,EAC7B,YAAY,GAAG,2BAA2B,CAAC,QAAQ,CAAC,CAAC,YAAY;IAEjE,IAAI,YAAY,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;QACjF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/renderer/ViewerHistoryData.d.ts

@@ -0,0 +1,59 @@
+/** Scene data exchanged by the viewer, not the application's history authority.
+ * Metadata encoding is supplied by the consumer; these contracts perform no validation.
+ */
+export interface ViewerHistoryVector3 {
+    x: number;
+    y: number;
+    z: number;
+}
+export interface ViewerHistoryQuaternion extends ViewerHistoryVector3 {
+    w: number;
+}
+export interface ViewerHistoryTransform<Metadata> {
+    id: string;
+    position: ViewerHistoryVector3;
+    rotation?: ViewerHistoryQuaternion;
+    scale?: ViewerHistoryVector3;
+    sourceId?: string;
+    metadata?: Metadata;
+}
+export interface ViewerHistoryCameraSample {
+    position: ViewerHistoryVector3;
+    target: ViewerHistoryVector3;
+    projection: string;
+}
+export interface ViewerHistoryPhysicsSample<Metadata> {
+    engine: string;
+    enabled: boolean;
+    motorsCoupled?: boolean;
+    bodyCount: number;
+    jointCount: number;
+    centerOfMass?: ViewerHistoryVector3 | null;
+    bodyTransforms?: ViewerHistoryTransform<Metadata>[];
+    jointStates?: Record<string, number>;
+}
+export interface ViewerHistoryPlaybackSample {
+    sourceId?: string;
+    /** Playback cursor in seconds. */
+    currentTime: number;
+    isPlaying: boolean;
+    playbackRate?: number;
+    duration?: number;
+}
+export interface ViewerHistorySceneSample<Metadata> {
+    camera?: ViewerHistoryCameraSample;
+    joints?: Record<string, number>;
+    physics?: ViewerHistoryPhysicsSample<Metadata>;
+    playback?: ViewerHistoryPlaybackSample;
+    metadata?: Metadata;
+}
+export interface ViewerHistorySample<Metadata> {
+    /** Entry identifier assigned by the history owner, not a scene entity identifier. */
+    id: number;
+    timeSeconds: number;
+    /** Recording timestamp in milliseconds, supplied by the history owner. */
+    recordedAt: number;
+    viewer?: ViewerHistorySceneSample<Metadata>;
+    metadata?: Metadata;
+}
+//# sourceMappingURL=ViewerHistoryData.d.ts.map

package/dist/renderer/ViewerHistoryData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerHistoryData.d.ts","sourceRoot":"","sources":["../../src/renderer/ViewerHistoryData.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,sBAAsB,CAAC,QAAQ;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B,CAAC,QAAQ;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC3C,cAAc,CAAC,EAAE,sBAAsB,CAAC,QAAQ,CAAC,EAAE,CAAC;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB,CAAC,QAAQ;IAChD,MAAM,CAAC,EAAE,yBAAyB,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,2BAA2B,CAAC;IACvC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB,CAAC,QAAQ;IAC3C,qFAAqF;IACrF,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB"}

package/dist/renderer/ViewerHistoryData.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ViewerHistoryData.js.map

package/dist/renderer/ViewerHistoryData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerHistoryData.js","sourceRoot":"","sources":["../../src/renderer/ViewerHistoryData.ts"],"names":[],"mappings":""}

package/dist/renderer/ViewerHistoryPort.d.ts

@@ -0,0 +1,15 @@
+/** Borrowed history access. The owner retains replay controls, retention and disposal. */
+export interface ViewerHistoryPort<SampleInput, Snapshot> {
+    isRecording(): boolean;
+    recordSample(sample: SampleInput): void;
+    snapshot(): Snapshot;
+    subscribe(listener: (snapshot: Snapshot) => void): () => void;
+}
+/** Read-side requirements only; the history owner selects the sample and replay cursor. */
+export interface ViewerHistoryObservation<Sample> {
+    readonly replayState: 'live' | 'paused' | 'playing';
+    /** Seconds, or null when the selected sample supplies the cursor. */
+    readonly replayTimeSeconds: number | null;
+    readonly selectedSample: Sample | null;
+}
+//# sourceMappingURL=ViewerHistoryPort.d.ts.map

package/dist/renderer/ViewerHistoryPort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerHistoryPort.d.ts","sourceRoot":"","sources":["../../src/renderer/ViewerHistoryPort.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,MAAM,WAAW,iBAAiB,CAAC,WAAW,EAAE,QAAQ;IACtD,WAAW,IAAI,OAAO,CAAC;IACvB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IACxC,QAAQ,IAAI,QAAQ,CAAC;IACrB,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC/D;AAED,2FAA2F;AAC3F,MAAM,WAAW,wBAAwB,CAAC,MAAM;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IACpD,qEAAqE;IACrE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC"}

package/dist/renderer/ViewerHistoryPort.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ViewerHistoryPort.js.map

package/dist/renderer/ViewerHistoryPort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerHistoryPort.js","sourceRoot":"","sources":["../../src/renderer/ViewerHistoryPort.ts"],"names":[],"mappings":""}

package/dist/renderer/ViewerIncarnationHealth.d.ts

@@ -0,0 +1,14 @@
+export type ViewerIncarnationLossReason = 'destroyed' | 'canvas-detached' | 'context-lost';
+export type ViewerIncarnationHealth = {
+    operational: true;
+    reason: null;
+} | {
+    operational: false;
+    reason: ViewerIncarnationLossReason;
+};
+export declare function resolveViewerIncarnationHealth(input: {
+    destroyed: boolean;
+    canvasAttached: boolean;
+    contextLost: boolean;
+}): ViewerIncarnationHealth;
+//# sourceMappingURL=ViewerIncarnationHealth.d.ts.map

package/dist/renderer/ViewerIncarnationHealth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerIncarnationHealth.d.ts","sourceRoot":"","sources":["../../src/renderer/ViewerIncarnationHealth.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,2BAA2B,GAAG,WAAW,GAAG,iBAAiB,GAAG,cAAc,CAAC;AAE3F,MAAM,MAAM,uBAAuB,GAC/B;IAAE,WAAW,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,IAAI,CAAA;CAAE,GACnC;IAAE,WAAW,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,2BAA2B,CAAA;CAAE,CAAC;AAEhE,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;CACtB,GAAG,uBAAuB,CAc1B"}

package/dist/renderer/ViewerIncarnationHealth.js

@@ -0,0 +1,13 @@
+export function resolveViewerIncarnationHealth(input) {
+    if (input.destroyed) {
+        return { operational: false, reason: 'destroyed' };
+    }
+    if (!input.canvasAttached) {
+        return { operational: false, reason: 'canvas-detached' };
+    }
+    if (input.contextLost) {
+        return { operational: false, reason: 'context-lost' };
+    }
+    return { operational: true, reason: null };
+}
+//# sourceMappingURL=ViewerIncarnationHealth.js.map

package/dist/renderer/ViewerIncarnationHealth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerIncarnationHealth.js","sourceRoot":"","sources":["../../src/renderer/ViewerIncarnationHealth.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,8BAA8B,CAAC,KAI9C;IACC,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACrD,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QAC1B,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC3D,CAAC;IAED,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IACxD,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC7C,CAAC"}

package/dist/renderer/ViewerInputBindings.d.ts

@@ -0,0 +1,19 @@
+import type { InteractionInputBinding, InteractionInputSignal } from '@konitif/tools/input';
+export declare const VIEWER_PROJECTILE_CHARGE_ACTION_ID = "viewer.projectile.charge";
+export declare const VIEWER_PROJECTILE_LAUNCH_ACTION_ID = "viewer.projectile.launch";
+/**
+ * Product-level associations. Viewer3D consumes the action id, never a specific key.
+ * A caller may replace this catalog or apply session/workspace overrides.
+ */
+export declare const DEFAULT_VIEWER_INPUT_BINDINGS: readonly InteractionInputBinding[];
+/** Observed key fields only; event lifecycle and default prevention remain with the host. */
+export interface ViewerKeyboardInput {
+    readonly code: string;
+    readonly ctrlKey: boolean;
+    readonly altKey: boolean;
+    readonly shiftKey: boolean;
+    readonly metaKey: boolean;
+    readonly repeat: boolean;
+}
+export declare function createInteractionKeyboardSignal(event: ViewerKeyboardInput, phase: InteractionInputSignal['phase']): InteractionInputSignal;
+//# sourceMappingURL=ViewerInputBindings.d.ts.map

package/dist/renderer/ViewerInputBindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerInputBindings.d.ts","sourceRoot":"","sources":["../../src/renderer/ViewerInputBindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EAEvB,sBAAsB,EACvB,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,kCAAkC,6BAA6B,CAAC;AAC7E,eAAO,MAAM,kCAAkC,6BAA6B,CAAC;AAE7E;;;GAGG;AACH,eAAO,MAAM,6BAA6B,EAAE,SAAS,uBAAuB,EAkB3E,CAAC;AAEF,6FAA6F;AAC7F,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,sBAAsB,CAAC,OAAO,CAAC,GACrC,sBAAsB,CAaxB"}

package/dist/renderer/ViewerInputBindings.js

@@ -0,0 +1,44 @@
+export const VIEWER_PROJECTILE_CHARGE_ACTION_ID = 'viewer.projectile.charge';
+export const VIEWER_PROJECTILE_LAUNCH_ACTION_ID = 'viewer.projectile.launch';
+/**
+ * Product-level associations. Viewer3D consumes the action id, never a specific key.
+ * A caller may replace this catalog or apply session/workspace overrides.
+ */
+export const DEFAULT_VIEWER_INPUT_BINDINGS = [
+    {
+        id: 'viewer.projectile.launch.keyboard.primary',
+        actionId: VIEWER_PROJECTILE_CHARGE_ACTION_ID,
+        source: 'keyboard',
+        controlId: 'Space',
+        phase: 'press',
+        allowRepeat: true,
+        enabled: true
+    },
+    {
+        id: 'viewer.projectile.launch.keyboard.primary.release',
+        actionId: VIEWER_PROJECTILE_LAUNCH_ACTION_ID,
+        source: 'keyboard',
+        controlId: 'Space',
+        phase: 'release',
+        enabled: true
+    }
+];
+export function createInteractionKeyboardSignal(event, phase) {
+    const modifiers = [];
+    if (event.ctrlKey)
+        modifiers.push('control');
+    if (event.altKey)
+        modifiers.push('alt');
+    if (event.shiftKey)
+        modifiers.push('shift');
+    if (event.metaKey)
+        modifiers.push('meta');
+    return {
+        source: 'keyboard',
+        controlId: event.code,
+        phase,
+        modifiers,
+        repeat: event.repeat
+    };
+}
+//# sourceMappingURL=ViewerInputBindings.js.map

package/dist/renderer/ViewerInputBindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerInputBindings.js","sourceRoot":"","sources":["../../src/renderer/ViewerInputBindings.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,kCAAkC,GAAG,0BAA0B,CAAC;AAC7E,MAAM,CAAC,MAAM,kCAAkC,GAAG,0BAA0B,CAAC;AAE7E;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAuC;IAC/E;QACE,EAAE,EAAE,2CAA2C;QAC/C,QAAQ,EAAE,kCAAkC;QAC5C,MAAM,EAAE,UAAU;QAClB,SAAS,EAAE,OAAO;QAClB,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,IAAI;QACjB,OAAO,EAAE,IAAI;KACd;IACD;QACE,EAAE,EAAE,mDAAmD;QACvD,QAAQ,EAAE,kCAAkC;QAC5C,MAAM,EAAE,UAAU;QAClB,SAAS,EAAE,OAAO;QAClB,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,IAAI;KACd;CACF,CAAC;AAYF,MAAM,UAAU,+BAA+B,CAC7C,KAA0B,EAC1B,KAAsC;IAEtC,MAAM,SAAS,GAA+B,EAAE,CAAC;IACjD,IAAI,KAAK,CAAC,OAAO;QAAE,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7C,IAAI,KAAK,CAAC,MAAM;QAAE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,KAAK,CAAC,QAAQ;QAAE,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,KAAK,CAAC,OAAO;QAAE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO;QACL,MAAM,EAAE,UAAU;QAClB,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,KAAK;QACL,SAAS;QACT,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC;AACJ,CAAC"}

package/dist/renderer/ViewerMetadata.d.ts

@@ -0,0 +1,11 @@
+/** JSON encoding accepted for viewer annotations and provenance, not an admission policy. */
+export type ViewerMetadataValue = string | number | boolean | null | ViewerMetadata | ViewerMetadataValue[];
+export type ViewerMetadata = {
+    [key: string]: ViewerMetadataValue;
+};
+/** Preserve the existing JSON round-trip when copying transform annotations.
+ * This is not a validator or structured clone: native JSON normalization,
+ * toJSON hooks and serialization failures are deliberately unchanged.
+ */
+export declare function copyViewerMetadata<T extends ViewerMetadata>(metadata: T): T;
+//# sourceMappingURL=ViewerMetadata.d.ts.map

package/dist/renderer/ViewerMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerMetadata.d.ts","sourceRoot":"","sources":["../../src/renderer/ViewerMetadata.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,cAAc,GAAG,mBAAmB,EAAE,CAAC;AAC5G,MAAM,MAAM,cAAc,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAA;CAAE,CAAC;AAEpE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,cAAc,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAE3E"}

package/dist/renderer/ViewerMetadata.js

@@ -0,0 +1,8 @@
+/** Preserve the existing JSON round-trip when copying transform annotations.
+ * This is not a validator or structured clone: native JSON normalization,
+ * toJSON hooks and serialization failures are deliberately unchanged.
+ */
+export function copyViewerMetadata(metadata) {
+    return JSON.parse(JSON.stringify(metadata));
+}
+//# sourceMappingURL=ViewerMetadata.js.map

package/dist/renderer/ViewerMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerMetadata.js","sourceRoot":"","sources":["../../src/renderer/ViewerMetadata.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAA2B,QAAW;IACtE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAM,CAAC;AACnD,CAAC"}

package/dist/renderer/ViewerPlaybackCompletionPolicy.d.ts

@@ -0,0 +1,29 @@
+export type ViewerPlaybackCompletionBehavior = 'hold' | 'return-to-default';
+export interface ViewerPlaybackCompletionTransitionInput {
+    isPlaying: boolean;
+    completionReached: boolean;
+    completionBehavior: ViewerPlaybackCompletionBehavior;
+}
+/**
+ * A transport pause freezes the authored pose. Returning to the configured
+ * boundary pose is reserved for an explicitly completed playback.
+ */
+export declare function shouldStartViewerPlaybackCompletionTransition(input: ViewerPlaybackCompletionTransitionInput): boolean;
+export interface ViewerPlaybackPhysicsAdvanceInput {
+    hasPlaybackState: boolean;
+    isPlaying: boolean;
+    bufferedProjectionActive: boolean;
+    completionTransitionActive: boolean;
+    boundaryTransitionActive: boolean;
+}
+/** A buffered projection has already been simulated and must never be stepped twice. */
+export declare function shouldAdvanceViewerPlaybackPhysics(input: ViewerPlaybackPhysicsAdvanceInput): boolean;
+export interface ViewerPlaybackProjectionTimeInput {
+    synchronizedTimeSeconds: number;
+    elapsedSeconds: number;
+    playbackRate: number;
+    authoritativeTimeSeconds?: number | null;
+}
+/** The transport clock wins; local elapsed time is only a degraded fallback. */
+export declare function resolveViewerPlaybackProjectionTime(input: ViewerPlaybackProjectionTimeInput): number;
+//# sourceMappingURL=ViewerPlaybackCompletionPolicy.d.ts.map

package/dist/renderer/ViewerPlaybackCompletionPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerPlaybackCompletionPolicy.d.ts","sourceRoot":"","sources":["../../src/renderer/ViewerPlaybackCompletionPolicy.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gCAAgC,GAAG,MAAM,GAAG,mBAAmB,CAAC;AAE5E,MAAM,WAAW,uCAAuC;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kBAAkB,EAAE,gCAAgC,CAAC;CACtD;AAED;;;GAGG;AACH,wBAAgB,6CAA6C,CAC3D,KAAK,EAAE,uCAAuC,GAC7C,OAAO,CAMT;AAED,MAAM,WAAW,iCAAiC;IAChD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,wBAAwB,EAAE,OAAO,CAAC;IAClC,0BAA0B,EAAE,OAAO,CAAC;IACpC,wBAAwB,EAAE,OAAO,CAAC;CACnC;AAED,wFAAwF;AACxF,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,iCAAiC,GACvC,OAAO,CAUT;AAED,MAAM,WAAW,iCAAiC;IAChD,uBAAuB,EAAE,MAAM,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAED,gFAAgF;AAChF,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,iCAAiC,GACvC,MAAM,CAYR"}

package/dist/renderer/ViewerPlaybackCompletionPolicy.js

@@ -0,0 +1,27 @@
+/**
+ * A transport pause freezes the authored pose. Returning to the configured
+ * boundary pose is reserved for an explicitly completed playback.
+ */
+export function shouldStartViewerPlaybackCompletionTransition(input) {
+    return (!input.isPlaying &&
+        input.completionReached &&
+        input.completionBehavior === 'return-to-default');
+}
+/** A buffered projection has already been simulated and must never be stepped twice. */
+export function shouldAdvanceViewerPlaybackPhysics(input) {
+    if (input.bufferedProjectionActive || input.boundaryTransitionActive) {
+        return false;
+    }
+    return (!input.hasPlaybackState ||
+        input.isPlaying ||
+        input.completionTransitionActive);
+}
+/** The transport clock wins; local elapsed time is only a degraded fallback. */
+export function resolveViewerPlaybackProjectionTime(input) {
+    if (typeof input.authoritativeTimeSeconds === 'number' &&
+        Number.isFinite(input.authoritativeTimeSeconds)) {
+        return Math.max(0, input.authoritativeTimeSeconds);
+    }
+    return Math.max(0, input.synchronizedTimeSeconds + input.elapsedSeconds * input.playbackRate);
+}
+//# sourceMappingURL=ViewerPlaybackCompletionPolicy.js.map

package/dist/renderer/ViewerPlaybackCompletionPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerPlaybackCompletionPolicy.js","sourceRoot":"","sources":["../../src/renderer/ViewerPlaybackCompletionPolicy.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,UAAU,6CAA6C,CAC3D,KAA8C;IAE9C,OAAO,CACL,CAAC,KAAK,CAAC,SAAS;QAChB,KAAK,CAAC,iBAAiB;QACvB,KAAK,CAAC,kBAAkB,KAAK,mBAAmB,CACjD,CAAC;AACJ,CAAC;AAUD,wFAAwF;AACxF,MAAM,UAAU,kCAAkC,CAChD,KAAwC;IAExC,IAAI,KAAK,CAAC,wBAAwB,IAAI,KAAK,CAAC,wBAAwB,EAAE,CAAC;QACrE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,CACL,CAAC,KAAK,CAAC,gBAAgB;QACvB,KAAK,CAAC,SAAS;QACf,KAAK,CAAC,0BAA0B,CACjC,CAAC;AACJ,CAAC;AASD,gFAAgF;AAChF,MAAM,UAAU,mCAAmC,CACjD,KAAwC;IAExC,IACE,OAAO,KAAK,CAAC,wBAAwB,KAAK,QAAQ;QAClD,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAC/C,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CACb,CAAC,EACD,KAAK,CAAC,uBAAuB,GAAG,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,YAAY,CAC1E,CAAC;AACJ,CAAC"}

package/dist/renderer/ViewerProjectileParticleRenderer.d.ts

@@ -0,0 +1,21 @@
+import { InstancedMesh, Vector3 } from 'three';
+export type ViewerProjectileVisualPhase = 'flight' | 'robot-contact' | 'ground-contact' | 'settled' | 'fading';
+export declare class ViewerProjectileParticleRenderer {
+    readonly capacity: number;
+    readonly mesh: InstancedMesh;
+    private readonly active;
+    private readonly phaseColor;
+    private readonly fadeStartedAt;
+    private readonly occupied;
+    private readonly matrix;
+    private readonly euler;
+    private readonly rotation;
+    constructor(capacity: number, radiusMeters: number, fadeDurationSeconds: number);
+    allocate(): number | null;
+    release(slot: number): void;
+    updateTransform(slot: number, position: Vector3, rotationX: number, rotationY: number, scale?: number): void;
+    setPhase(slot: number, phase: ViewerProjectileVisualPhase, nowSeconds: number): void;
+    setTime(nowSeconds: number): void;
+    dispose(): void;
+}
+//# sourceMappingURL=ViewerProjectileParticleRenderer.d.ts.map

package/dist/renderer/ViewerProjectileParticleRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerProjectileParticleRenderer.d.ts","sourceRoot":"","sources":["../../src/renderer/ViewerProjectileParticleRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,aAAa,EAKb,OAAO,EACR,MAAM,OAAO,CAAC;AAEf,MAAM,MAAM,2BAA2B,GACnC,QAAQ,GACR,eAAe,GACf,gBAAgB,GAChB,SAAS,GACT,QAAQ,CAAC;AAab,qBAAa,gCAAgC;IAYzC,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAX3B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAE7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2B;IACtD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2B;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAY;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;gBAGlC,QAAQ,EAAE,MAAM,EACzB,YAAY,EAAE,MAAM,EACpB,mBAAmB,EAAE,MAAM;IA0E7B,QAAQ,IAAI,MAAM,GAAG,IAAI;IAWzB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAS3B,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,IAAI;IAQvG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,2BAA2B,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAQpF,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIjC,OAAO,IAAI,IAAI;CAIhB"}