@spatial-elements/core 1.0.0-beta.7 → 1.0.0-beta.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/catalog/CarouselDeviceCamera.d.ts +8 -0
- package/dist/catalog/CarouselDeviceCamera.d.ts.map +1 -1
- package/dist/catalog/CarouselDeviceCamera.js +15 -1
- package/dist/catalog/CarouselDeviceCamera.js.map +1 -1
- package/dist/catalog/CarouselGlassCompositor.d.ts +8 -2
- package/dist/catalog/CarouselGlassCompositor.d.ts.map +1 -1
- package/dist/catalog/CarouselGlassCompositor.js +69 -12
- package/dist/catalog/CarouselGlassCompositor.js.map +1 -1
- package/dist/catalog/CarouselGround.d.ts +22 -1
- package/dist/catalog/CarouselGround.d.ts.map +1 -1
- package/dist/catalog/CarouselGround.js +185 -24
- package/dist/catalog/CarouselGround.js.map +1 -1
- package/dist/catalog/CatalogDepthBlur.d.ts +20 -1
- package/dist/catalog/CatalogDepthBlur.d.ts.map +1 -1
- package/dist/catalog/CatalogDepthBlur.js +126 -23
- package/dist/catalog/CatalogDepthBlur.js.map +1 -1
- package/dist/catalog/CatalogGeometryFade.d.ts +5 -1
- package/dist/catalog/CatalogGeometryFade.d.ts.map +1 -1
- package/dist/catalog/CatalogGeometryFade.js +39 -7
- package/dist/catalog/CatalogGeometryFade.js.map +1 -1
- package/dist/catalog/CatalogModelOutline.d.ts +3 -1
- package/dist/catalog/CatalogModelOutline.d.ts.map +1 -1
- package/dist/catalog/CatalogModelOutline.js +11 -2
- package/dist/catalog/CatalogModelOutline.js.map +1 -1
- package/dist/catalog/CatalogPreparation.d.ts.map +1 -1
- package/dist/catalog/CatalogPreparation.js +8 -6
- package/dist/catalog/CatalogPreparation.js.map +1 -1
- package/dist/catalog/CatalogSpatialElementLayer.d.ts +129 -3
- package/dist/catalog/CatalogSpatialElementLayer.d.ts.map +1 -1
- package/dist/catalog/CatalogSpatialElementLayer.js +408 -33
- package/dist/catalog/CatalogSpatialElementLayer.js.map +1 -1
- package/dist/catalog/CatalogTransition.d.ts +4 -0
- package/dist/catalog/CatalogTransition.d.ts.map +1 -1
- package/dist/catalog/CatalogTransition.js +91 -22
- package/dist/catalog/CatalogTransition.js.map +1 -1
- package/dist/catalog/CatalogWarmOutputContext.d.ts +39 -0
- package/dist/catalog/CatalogWarmOutputContext.d.ts.map +1 -0
- package/dist/catalog/CatalogWarmOutputContext.js +159 -0
- package/dist/catalog/CatalogWarmOutputContext.js.map +1 -0
- package/dist/catalog/EarlyNavigationCoordinator.d.ts +35 -0
- package/dist/catalog/EarlyNavigationCoordinator.d.ts.map +1 -0
- package/dist/catalog/EarlyNavigationCoordinator.js +103 -0
- package/dist/catalog/EarlyNavigationCoordinator.js.map +1 -0
- package/dist/catalog/NavigationFeedback.d.ts +12 -0
- package/dist/catalog/NavigationFeedback.d.ts.map +1 -0
- package/dist/catalog/NavigationFeedback.js +40 -0
- package/dist/catalog/NavigationFeedback.js.map +1 -0
- package/dist/catalog/PreparationGate.d.ts +4 -0
- package/dist/catalog/PreparationGate.d.ts.map +1 -1
- package/dist/catalog/PreparationGate.js +1 -0
- package/dist/catalog/PreparationGate.js.map +1 -1
- package/dist/catalog/SourceDomClipping.d.ts +8 -0
- package/dist/catalog/SourceDomClipping.d.ts.map +1 -0
- package/dist/catalog/SourceDomClipping.js +74 -0
- package/dist/catalog/SourceDomClipping.js.map +1 -0
- package/dist/catalog/SourceDomMotion.d.ts +28 -0
- package/dist/catalog/SourceDomMotion.d.ts.map +1 -0
- package/dist/catalog/SourceDomMotion.js +111 -0
- package/dist/catalog/SourceDomMotion.js.map +1 -0
- package/dist/catalog/SpatialPageRegistry.d.ts +1 -0
- package/dist/catalog/SpatialPageRegistry.d.ts.map +1 -1
- package/dist/catalog/SpatialPageRegistry.js.map +1 -1
- package/dist/catalog/StagedCatalogTransition.d.ts +74 -0
- package/dist/catalog/StagedCatalogTransition.d.ts.map +1 -0
- package/dist/catalog/StagedCatalogTransition.js +270 -0
- package/dist/catalog/StagedCatalogTransition.js.map +1 -0
- package/dist/catalog/cardProjection.d.ts +31 -0
- package/dist/catalog/cardProjection.d.ts.map +1 -1
- package/dist/catalog/cardProjection.js +63 -4
- package/dist/catalog/cardProjection.js.map +1 -1
- package/dist/catalog/carouselPanelProjection.d.ts.map +1 -1
- package/dist/catalog/carouselPanelProjection.js +48 -11
- package/dist/catalog/carouselPanelProjection.js.map +1 -1
- package/dist/catalog/catalogActivationFocus.d.ts +5 -0
- package/dist/catalog/catalogActivationFocus.d.ts.map +1 -0
- package/dist/catalog/catalogActivationFocus.js +39 -0
- package/dist/catalog/catalogActivationFocus.js.map +1 -0
- package/dist/catalog/catalogJourney.d.ts +2 -0
- package/dist/catalog/catalogJourney.d.ts.map +1 -1
- package/dist/catalog/catalogJourney.js.map +1 -1
- package/dist/catalog/catalogPose.d.ts +18 -0
- package/dist/catalog/catalogPose.d.ts.map +1 -1
- package/dist/catalog/catalogPose.js +26 -5
- package/dist/catalog/catalogPose.js.map +1 -1
- package/dist/catalog/catalogTransitionViewport.d.ts +9 -0
- package/dist/catalog/catalogTransitionViewport.d.ts.map +1 -0
- package/dist/catalog/catalogTransitionViewport.js +13 -0
- package/dist/catalog/catalogTransitionViewport.js.map +1 -0
- package/dist/catalog/catalogViewLink.d.ts +2 -0
- package/dist/catalog/catalogViewLink.d.ts.map +1 -1
- package/dist/catalog/catalogViewLink.js +10 -2
- package/dist/catalog/catalogViewLink.js.map +1 -1
- package/dist/catalog/listDeviceOrientation.d.ts +2 -0
- package/dist/catalog/listDeviceOrientation.d.ts.map +1 -1
- package/dist/catalog/listDeviceOrientation.js +18 -1
- package/dist/catalog/listDeviceOrientation.js.map +1 -1
- package/dist/catalog/stagedDetailGeometry.d.ts +37 -0
- package/dist/catalog/stagedDetailGeometry.d.ts.map +1 -0
- package/dist/catalog/stagedDetailGeometry.js +55 -0
- package/dist/catalog/stagedDetailGeometry.js.map +1 -0
- package/dist/catalog/stagedDockGeometry.d.ts +66 -0
- package/dist/catalog/stagedDockGeometry.d.ts.map +1 -0
- package/dist/catalog/stagedDockGeometry.js +66 -0
- package/dist/catalog/stagedDockGeometry.js.map +1 -0
- package/dist/index.d.ts +2 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/spatial-element/ResponsiveViewportMetrics.d.ts +18 -0
- package/dist/spatial-element/ResponsiveViewportMetrics.d.ts.map +1 -0
- package/dist/spatial-element/ResponsiveViewportMetrics.js +68 -0
- package/dist/spatial-element/ResponsiveViewportMetrics.js.map +1 -0
- package/dist/spatial-element/SectionSurfaceRegistry.d.ts +24 -0
- package/dist/spatial-element/SectionSurfaceRegistry.d.ts.map +1 -0
- package/dist/spatial-element/SectionSurfaceRegistry.js +48 -0
- package/dist/spatial-element/SectionSurfaceRegistry.js.map +1 -0
- package/dist/spatial-element/SpatialElementDockController.d.ts +19 -9
- package/dist/spatial-element/SpatialElementDockController.d.ts.map +1 -1
- package/dist/spatial-element/SpatialElementDockController.js +189 -93
- package/dist/spatial-element/SpatialElementDockController.js.map +1 -1
- package/dist/spatial-element/SpatialElementPaneController.d.ts +67 -0
- package/dist/spatial-element/SpatialElementPaneController.d.ts.map +1 -0
- package/dist/spatial-element/SpatialElementPaneController.js +245 -0
- package/dist/spatial-element/SpatialElementPaneController.js.map +1 -0
- package/dist/spatial-element/activeDetailSection.d.ts +8 -0
- package/dist/spatial-element/activeDetailSection.d.ts.map +1 -0
- package/dist/spatial-element/activeDetailSection.js +19 -0
- package/dist/spatial-element/activeDetailSection.js.map +1 -0
- package/dist/spatial-element/layoutTokens.json +53 -0
- package/dist/spatial-element/responsiveLayout.d.ts +1389 -0
- package/dist/spatial-element/responsiveLayout.d.ts.map +1 -0
- package/dist/spatial-element/responsiveLayout.js +265 -0
- package/dist/spatial-element/responsiveLayout.js.map +1 -0
- package/dist/spatial-element/sectionBackground.d.ts +29 -0
- package/dist/spatial-element/sectionBackground.d.ts.map +1 -0
- package/dist/spatial-element/sectionBackground.js +66 -0
- package/dist/spatial-element/sectionBackground.js.map +1 -0
- package/dist/spatial-element/spatialElement.d.ts +1 -0
- package/dist/spatial-element/spatialElement.d.ts.map +1 -1
- package/dist/spatial-element/spatialElement.js +1 -0
- package/dist/spatial-element/spatialElement.js.map +1 -1
- package/dist/spatial-element/spatialElementDock.d.ts +15 -0
- package/dist/spatial-element/spatialElementDock.d.ts.map +1 -1
- package/dist/spatial-element/spatialElementDock.js +22 -0
- package/dist/spatial-element/spatialElementDock.js.map +1 -1
- package/dist/spatial-element/spatialElementMedia.d.ts +16 -0
- package/dist/spatial-element/spatialElementMedia.d.ts.map +1 -0
- package/dist/spatial-element/spatialElementMedia.js +29 -0
- package/dist/spatial-element/spatialElementMedia.js.map +1 -0
- package/dist/spatial-element/spatialTheme.d.ts +12 -1
- package/dist/spatial-element/spatialTheme.d.ts.map +1 -1
- package/dist/spatial-element/spatialTheme.js +30 -1
- package/dist/spatial-element/spatialTheme.js.map +1 -1
- package/dist/spatial-element/types.d.ts +50 -2
- package/dist/spatial-element/types.d.ts.map +1 -1
- package/dist/spatial-element/types.js.map +1 -1
- package/dist/stage/BackgroundLayerOutput.d.ts +76 -0
- package/dist/stage/BackgroundLayerOutput.d.ts.map +1 -0
- package/dist/stage/BackgroundLayerOutput.js +333 -0
- package/dist/stage/BackgroundLayerOutput.js.map +1 -0
- package/dist/stage/LiquidGlassPanel.d.ts +3 -0
- package/dist/stage/LiquidGlassPanel.d.ts.map +1 -1
- package/dist/stage/LiquidGlassPanel.js +27 -2
- package/dist/stage/LiquidGlassPanel.js.map +1 -1
- package/dist/stage/MinimapController.d.ts.map +1 -1
- package/dist/stage/MinimapController.js +28 -47
- package/dist/stage/MinimapController.js.map +1 -1
- package/dist/stage/PageBindingController.d.ts +4 -0
- package/dist/stage/PageBindingController.d.ts.map +1 -1
- package/dist/stage/PageBindingController.js +12 -4
- package/dist/stage/PageBindingController.js.map +1 -1
- package/dist/stage/PanelPresentationController.d.ts +17 -0
- package/dist/stage/PanelPresentationController.d.ts.map +1 -1
- package/dist/stage/PanelPresentationController.js +69 -13
- package/dist/stage/PanelPresentationController.js.map +1 -1
- package/dist/stage/SpatialElementInteractionController.d.ts +7 -0
- package/dist/stage/SpatialElementInteractionController.d.ts.map +1 -1
- package/dist/stage/SpatialElementInteractionController.js +9 -0
- package/dist/stage/SpatialElementInteractionController.js.map +1 -1
- package/dist/stage/SpatialElementPresentationController.d.ts +14 -2
- package/dist/stage/SpatialElementPresentationController.d.ts.map +1 -1
- package/dist/stage/SpatialElementPresentationController.js +47 -2
- package/dist/stage/SpatialElementPresentationController.js.map +1 -1
- package/dist/stage/SpatialElementRefinement.d.ts +34 -1
- package/dist/stage/SpatialElementRefinement.d.ts.map +1 -1
- package/dist/stage/SpatialElementRefinement.js +175 -37
- package/dist/stage/SpatialElementRefinement.js.map +1 -1
- package/dist/stage/StageExperience.d.ts +167 -5
- package/dist/stage/StageExperience.d.ts.map +1 -1
- package/dist/stage/StageExperience.js +384 -58
- package/dist/stage/StageExperience.js.map +1 -1
- package/dist/stage/StageRenderPipeline.d.ts +76 -1
- package/dist/stage/StageRenderPipeline.d.ts.map +1 -1
- package/dist/stage/StageRenderPipeline.js +421 -46
- package/dist/stage/StageRenderPipeline.js.map +1 -1
- package/dist/stage/VirtualScrollController.d.ts +7 -0
- package/dist/stage/VirtualScrollController.d.ts.map +1 -1
- package/dist/stage/VirtualScrollController.js +57 -4
- package/dist/stage/VirtualScrollController.js.map +1 -1
- package/dist/stage/minimap/MinimapModel.d.ts +2 -1
- package/dist/stage/minimap/MinimapModel.d.ts.map +1 -1
- package/dist/stage/minimap/MinimapModel.js +34 -4
- package/dist/stage/minimap/MinimapModel.js.map +1 -1
- package/dist/stage/minimap/MinimapModelGeometry.d.ts +21 -0
- package/dist/stage/minimap/MinimapModelGeometry.d.ts.map +1 -0
- package/dist/stage/minimap/MinimapModelGeometry.js +68 -0
- package/dist/stage/minimap/MinimapModelGeometry.js.map +1 -0
- package/dist/stage/minimap/MinimapState.d.ts +3 -8
- package/dist/stage/minimap/MinimapState.d.ts.map +1 -1
- package/dist/stage/minimap/MinimapState.js.map +1 -1
- package/dist/stage/panelContext.d.ts +7 -0
- package/dist/stage/panelContext.d.ts.map +1 -1
- package/dist/stage/panelContext.js.map +1 -1
- package/dist/stage/rendererState.d.ts +2 -0
- package/dist/stage/rendererState.d.ts.map +1 -1
- package/dist/stage/rendererState.js +13 -0
- package/dist/stage/rendererState.js.map +1 -1
- package/dist/stage/sceneEndpointEligibility.d.ts +20 -0
- package/dist/stage/sceneEndpointEligibility.d.ts.map +1 -0
- package/dist/stage/sceneEndpointEligibility.js +363 -0
- package/dist/stage/sceneEndpointEligibility.js.map +1 -0
- package/dist/stage/stageDom.d.ts.map +1 -1
- package/dist/stage/stageDom.js +6 -1
- package/dist/stage/stageDom.js.map +1 -1
- package/dist/stage/stageMath.d.ts +3 -3
- package/dist/stage/stageMath.d.ts.map +1 -1
- package/dist/stage/stageMath.js +11 -10
- package/dist/stage/stageMath.js.map +1 -1
- package/dist/stage/stageTypes.d.ts +7 -1
- package/dist/stage/stageTypes.d.ts.map +1 -1
- package/dist/stage/stageTypes.js.map +1 -1
- package/dist/stage/stageVisualTest.d.ts +19 -0
- package/dist/stage/stageVisualTest.d.ts.map +1 -1
- package/dist/stage/stageVisualTest.js.map +1 -1
- package/package.json +1 -1
|
@@ -3,6 +3,19 @@ export declare function getRefinementSize(width: number, height: number): {
|
|
|
3
3
|
width: number;
|
|
4
4
|
height: number;
|
|
5
5
|
};
|
|
6
|
+
export interface SceneEndpointGuard {
|
|
7
|
+
isValid(): boolean;
|
|
8
|
+
dispose(): void;
|
|
9
|
+
}
|
|
10
|
+
export interface SceneEndpointTicket {
|
|
11
|
+
commit(): boolean;
|
|
12
|
+
cancel(): void;
|
|
13
|
+
}
|
|
14
|
+
export interface RefinementRenderOptions {
|
|
15
|
+
/** Hidden preparation/its intervening RAFs borrow pixels without ticking q. */
|
|
16
|
+
advanceClock?: boolean;
|
|
17
|
+
backgroundReveal?: number;
|
|
18
|
+
}
|
|
6
19
|
/** Separate scene captures preserve authored alpha without sorting two translucent element meshes. */
|
|
7
20
|
export declare class SpatialElementRefinement {
|
|
8
21
|
private readonly overlay;
|
|
@@ -15,12 +28,32 @@ export declare class SpatialElementRefinement {
|
|
|
15
28
|
private readonly progress;
|
|
16
29
|
private lastFrame?;
|
|
17
30
|
private linearProgress;
|
|
31
|
+
private writeEpoch;
|
|
32
|
+
private sceneCache?;
|
|
33
|
+
private readonly cacheStats;
|
|
34
|
+
getSceneEndpointStats(): {
|
|
35
|
+
active: boolean;
|
|
36
|
+
pending: boolean;
|
|
37
|
+
preparations: number;
|
|
38
|
+
ready: number;
|
|
39
|
+
hits: number;
|
|
40
|
+
pendingReads: number;
|
|
41
|
+
invalidations: number;
|
|
42
|
+
staleTickets: number;
|
|
43
|
+
};
|
|
18
44
|
complete: boolean;
|
|
19
45
|
frames: number;
|
|
20
46
|
get presentedProgress(): number;
|
|
21
47
|
restart(): void;
|
|
22
48
|
get targetCount(): number;
|
|
23
|
-
|
|
49
|
+
invalidateSceneEndpoints(): void;
|
|
50
|
+
private ensureTargets;
|
|
51
|
+
private createCompositeMaterial;
|
|
52
|
+
private endpointsCurrent;
|
|
53
|
+
/** Call only after all warm live passes. Taking endpoints never advances the refinement clock.
|
|
54
|
+
* The caller fences these submissions and explicitly commits the returned ticket. */
|
|
55
|
+
prepareSceneEndpoints(renderer: THREE.WebGPURenderer, draw: (high: boolean, backgroundReveal: number) => void, guard: SceneEndpointGuard): SceneEndpointTicket | undefined;
|
|
56
|
+
render(renderer: THREE.WebGPURenderer, draw: (high: boolean) => void, reducedMotion: boolean, progress?: number, options?: RefinementRenderOptions): void;
|
|
24
57
|
dispose(): void;
|
|
25
58
|
}
|
|
26
59
|
//# sourceMappingURL=SpatialElementRefinement.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"SpatialElementRefinement.d.ts","sourceRoot":"","sources":["../../src/stage/SpatialElementRefinement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAMtC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;EAM9D;AAED,sGAAsG;AACtG,qBAAa,wBAAwB;IAIxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,gBAAgB;gBAGa,OAAO,UAAQ;IAC5C,OAAO,CAAC,GAAG,CAAC,CAAqB;IACjC,OAAO,CAAC,IAAI,CAAC,CAAqB;IAClC,OAAO,CAAC,QAAQ,CAAC,CAAqB;IACtC,OAAO,CAAC,IAAI,CAAC,CAAiB;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAK;IAC3B,QAAQ,UAAS;IACjB,MAAM,SAAK;IACX,IAAI,iBAAiB,WAEpB;IACD,OAAO;
|
|
1
|
+
{"version":3,"file":"SpatialElementRefinement.d.ts","sourceRoot":"","sources":["../../src/stage/SpatialElementRefinement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAMtC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;EAM9D;AAED,MAAM,WAAW,kBAAkB;IAClC,OAAO,IAAI,OAAO,CAAC;IACnB,OAAO,IAAI,IAAI,CAAC;CAChB;AACD,MAAM,WAAW,mBAAmB;IACnC,MAAM,IAAI,OAAO,CAAC;IAClB,MAAM,IAAI,IAAI,CAAC;CACf;AACD,MAAM,WAAW,uBAAuB;IACvC,+EAA+E;IAC/E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAiBD,sGAAsG;AACtG,qBAAa,wBAAwB;IAIxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,gBAAgB;gBAGa,OAAO,UAAQ;IAC5C,OAAO,CAAC,GAAG,CAAC,CAAqB;IACjC,OAAO,CAAC,IAAI,CAAC,CAAqB;IAClC,OAAO,CAAC,QAAQ,CAAC,CAAqB;IACtC,OAAO,CAAC,IAAI,CAAC,CAAiB;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,UAAU,CAAC,CAAqB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8F;IACzH,qBAAqB;;;;;;;;;;IACrB,QAAQ,UAAS;IACjB,MAAM,SAAK;IACX,IAAI,iBAAiB,WAEpB;IACD,OAAO;IAQP,IAAI,WAAW,WAEd;IAED,wBAAwB;IASxB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,gBAAgB;IAMxB;yFACqF;IACrF,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,KAAK,IAAI,EAAE,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,GAAG,SAAS;IAmD1K,MAAM,CACL,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,EAC7B,aAAa,EAAE,OAAO,EACtB,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,GAAE,uBAA4B;IAkCtC,OAAO;CASP"}
|
|
@@ -14,7 +14,7 @@ export function getRefinementSize(width, height) {
|
|
|
14
14
|
export class SpatialElementRefinement {
|
|
15
15
|
overlay;
|
|
16
16
|
getRenderTargets() {
|
|
17
|
-
return [this.low, this.high].filter((target) => Boolean(target));
|
|
17
|
+
return [this.low, this.high, ...(this.sceneCache?.zero ?? [])].filter((target) => Boolean(target));
|
|
18
18
|
}
|
|
19
19
|
constructor(overlay = false) {
|
|
20
20
|
this.overlay = overlay;
|
|
@@ -26,12 +26,17 @@ export class SpatialElementRefinement {
|
|
|
26
26
|
progress = uniform(0);
|
|
27
27
|
lastFrame;
|
|
28
28
|
linearProgress = 0;
|
|
29
|
+
writeEpoch = 0;
|
|
30
|
+
sceneCache;
|
|
31
|
+
cacheStats = { preparations: 0, ready: 0, hits: 0, pendingReads: 0, invalidations: 0, staleTickets: 0 };
|
|
32
|
+
getSceneEndpointStats() { return { ...this.cacheStats, active: Boolean(this.sceneCache?.ready), pending: Boolean(this.sceneCache && !this.sceneCache.ready) }; }
|
|
29
33
|
complete = false;
|
|
30
34
|
frames = 0;
|
|
31
35
|
get presentedProgress() {
|
|
32
36
|
return this.progress.value;
|
|
33
37
|
}
|
|
34
38
|
restart() {
|
|
39
|
+
this.invalidateSceneEndpoints();
|
|
35
40
|
this.lastFrame = undefined;
|
|
36
41
|
this.linearProgress = 0;
|
|
37
42
|
this.progress.value = 0;
|
|
@@ -39,61 +44,194 @@ export class SpatialElementRefinement {
|
|
|
39
44
|
this.frames = 0;
|
|
40
45
|
}
|
|
41
46
|
get targetCount() {
|
|
42
|
-
return
|
|
47
|
+
return this.getRenderTargets().length;
|
|
43
48
|
}
|
|
44
|
-
|
|
49
|
+
invalidateSceneEndpoints() {
|
|
50
|
+
const cache = this.sceneCache;
|
|
51
|
+
if (!cache)
|
|
52
|
+
return;
|
|
53
|
+
this.sceneCache = undefined;
|
|
54
|
+
this.cacheStats.invalidations++;
|
|
55
|
+
cache.zero.forEach(target => target.dispose());
|
|
56
|
+
cache.material.dispose();
|
|
57
|
+
cache.copyMaterial.dispose();
|
|
58
|
+
cache.guard.dispose();
|
|
59
|
+
}
|
|
60
|
+
ensureTargets(renderer) {
|
|
45
61
|
const destination = renderer.getRenderTarget();
|
|
46
62
|
if (!destination && !this.overlay)
|
|
47
63
|
throw new Error('SpatialElement refinement requires an owned scene capture');
|
|
48
64
|
const size = destination ?? renderer.getDrawingBufferSize(new THREE.Vector2());
|
|
49
|
-
const targetWidth = size.width;
|
|
50
|
-
const targetHeight = size.height;
|
|
51
65
|
if (!this.low || !this.high) {
|
|
52
|
-
this.low =
|
|
53
|
-
destination?.clone() ??
|
|
54
|
-
new THREE.RenderTarget(targetWidth, targetHeight, {
|
|
55
|
-
type: THREE.HalfFloatType,
|
|
56
|
-
samples: 4
|
|
57
|
-
});
|
|
66
|
+
this.low = destination?.clone() ?? new THREE.RenderTarget(size.width, size.height, { type: THREE.HalfFloatType, samples: 4 });
|
|
58
67
|
this.high = this.low.clone();
|
|
59
|
-
this.material =
|
|
60
|
-
this.material.fragmentNode = mix(texture(this.low.texture), texture(this.high.texture), this.progress);
|
|
61
|
-
this.material.depthTest = false;
|
|
62
|
-
this.material.depthWrite = false;
|
|
63
|
-
this.material.blending = this.overlay ? THREE.NormalBlending : THREE.NoBlending;
|
|
64
|
-
this.material.transparent = this.overlay;
|
|
65
|
-
this.material.premultipliedAlpha = this.overlay;
|
|
66
|
-
this.material.toneMapped = false;
|
|
68
|
+
this.material = this.createCompositeMaterial(mix(texture(this.low.texture), texture(this.high.texture), this.progress));
|
|
67
69
|
this.quad = new THREE.QuadMesh(this.material);
|
|
68
70
|
}
|
|
69
|
-
const { width, height } = getRefinementSize(
|
|
70
|
-
this.low.
|
|
71
|
-
|
|
71
|
+
const { width, height } = getRefinementSize(size.width, size.height);
|
|
72
|
+
if (this.low.width !== width || this.low.height !== height || this.high.width !== width || this.high.height !== height) {
|
|
73
|
+
this.invalidateSceneEndpoints();
|
|
74
|
+
this.writeEpoch++;
|
|
75
|
+
this.low.setSize(width, height);
|
|
76
|
+
this.high.setSize(width, height);
|
|
77
|
+
}
|
|
78
|
+
return destination;
|
|
79
|
+
}
|
|
80
|
+
createCompositeMaterial(fragment) {
|
|
81
|
+
const material = new THREE.NodeMaterial();
|
|
82
|
+
material.fragmentNode = fragment;
|
|
83
|
+
material.depthTest = material.depthWrite = false;
|
|
84
|
+
material.blending = this.overlay ? THREE.NormalBlending : THREE.NoBlending;
|
|
85
|
+
material.transparent = material.premultipliedAlpha = this.overlay;
|
|
86
|
+
material.toneMapped = false;
|
|
87
|
+
return material;
|
|
88
|
+
}
|
|
89
|
+
endpointsCurrent(cache) {
|
|
90
|
+
return cache.epoch === this.writeEpoch && cache.destination.width === cache.destinationWidth && cache.destination.height === cache.destinationHeight &&
|
|
91
|
+
this.low?.width === cache.zero[0].width && this.low?.height === cache.zero[0].height &&
|
|
92
|
+
this.high?.width === cache.zero[1].width && this.high?.height === cache.zero[1].height && cache.guard.isValid();
|
|
93
|
+
}
|
|
94
|
+
/** Call only after all warm live passes. Taking endpoints never advances the refinement clock.
|
|
95
|
+
* The caller fences these submissions and explicitly commits the returned ticket. */
|
|
96
|
+
prepareSceneEndpoints(renderer, draw, guard) {
|
|
97
|
+
this.invalidateSceneEndpoints();
|
|
98
|
+
let destination = renderer.getRenderTarget();
|
|
99
|
+
try {
|
|
100
|
+
destination = this.ensureTargets(renderer);
|
|
101
|
+
}
|
|
102
|
+
catch (error) {
|
|
103
|
+
guard.dispose();
|
|
104
|
+
throw error;
|
|
105
|
+
}
|
|
106
|
+
if (!destination || this.low.texture.type !== THREE.HalfFloatType || !guard.isValid()) {
|
|
107
|
+
guard.dispose();
|
|
108
|
+
return;
|
|
109
|
+
}
|
|
110
|
+
const zero = [0, 1].map(() => {
|
|
111
|
+
const target = new THREE.RenderTarget(this.low.width, this.low.height, { type: THREE.HalfFloatType, samples: 0, depthBuffer: false, stencilBuffer: false });
|
|
112
|
+
target.texture.colorSpace = THREE.NoColorSpace;
|
|
113
|
+
target.texture.generateMipmaps = false;
|
|
114
|
+
return target;
|
|
115
|
+
});
|
|
116
|
+
const background = uniform(0), refinement = uniform(0);
|
|
117
|
+
const material = this.createCompositeMaterial(mix(mix(texture(zero[0].texture), texture(this.low.texture), background), mix(texture(zero[1].texture), texture(this.high.texture), background), refinement));
|
|
118
|
+
const source = texture(this.low.texture);
|
|
119
|
+
const copyMaterial = new THREE.NodeMaterial();
|
|
120
|
+
copyMaterial.fragmentNode = source;
|
|
121
|
+
copyMaterial.depthTest = copyMaterial.depthWrite = false;
|
|
122
|
+
copyMaterial.blending = THREE.NoBlending;
|
|
123
|
+
copyMaterial.toneMapped = false;
|
|
124
|
+
const cache = { destination, destinationWidth: destination.width, destinationHeight: destination.height,
|
|
125
|
+
zero, background, refinement, material, quad: new THREE.QuadMesh(material), copyMaterial, copy: new THREE.QuadMesh(copyMaterial), guard, epoch: ++this.writeEpoch, ready: false };
|
|
126
|
+
this.sceneCache = cache;
|
|
127
|
+
try {
|
|
128
|
+
for (const p of [0, 1])
|
|
129
|
+
for (const high of [true, false]) {
|
|
130
|
+
const target = high ? this.high : this.low;
|
|
131
|
+
renderer.setRenderTarget(target);
|
|
132
|
+
draw(high, p);
|
|
133
|
+
if (p === 0) {
|
|
134
|
+
source.value = target.texture;
|
|
135
|
+
renderer.setRenderTarget(zero[high ? 1 : 0]);
|
|
136
|
+
cache.copy.render(renderer);
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
// Warm the exact overlay pipeline without touching the actual q uniform/clock.
|
|
140
|
+
renderer.setRenderTarget(destination);
|
|
141
|
+
background.value = 0.5;
|
|
142
|
+
refinement.value = this.progress.value;
|
|
143
|
+
// Offscreen rendering reads RenderTarget.scissor, not the Canvas scissor.
|
|
144
|
+
// Preserve the real presentation seed: even a hidden overlay can change it for transmission.
|
|
145
|
+
const scissor = destination.scissor.clone(), scissorTest = renderer.getScissorTest(), autoClear = renderer.autoClear;
|
|
146
|
+
try {
|
|
147
|
+
destination.scissor.set(0, 0, 0, 0);
|
|
148
|
+
renderer.setScissorTest(true);
|
|
149
|
+
renderer.autoClear = false;
|
|
150
|
+
cache.quad.render(renderer);
|
|
151
|
+
}
|
|
152
|
+
finally {
|
|
153
|
+
destination.scissor.copy(scissor);
|
|
154
|
+
renderer.setScissorTest(scissorTest);
|
|
155
|
+
renderer.autoClear = autoClear;
|
|
156
|
+
}
|
|
157
|
+
this.cacheStats.preparations++;
|
|
158
|
+
}
|
|
159
|
+
catch (error) {
|
|
160
|
+
this.invalidateSceneEndpoints();
|
|
161
|
+
throw error;
|
|
162
|
+
}
|
|
163
|
+
finally {
|
|
164
|
+
renderer.setRenderTarget(destination);
|
|
165
|
+
}
|
|
166
|
+
return {
|
|
167
|
+
commit: () => {
|
|
168
|
+
if (this.sceneCache !== cache || !this.endpointsCurrent(cache)) {
|
|
169
|
+
this.cacheStats.staleTickets++;
|
|
170
|
+
if (this.sceneCache === cache)
|
|
171
|
+
this.invalidateSceneEndpoints();
|
|
172
|
+
return false;
|
|
173
|
+
}
|
|
174
|
+
if (!cache.ready) {
|
|
175
|
+
cache.ready = true;
|
|
176
|
+
this.cacheStats.ready++;
|
|
177
|
+
}
|
|
178
|
+
return true;
|
|
179
|
+
},
|
|
180
|
+
cancel: () => { if (this.sceneCache === cache)
|
|
181
|
+
this.invalidateSceneEndpoints(); }
|
|
182
|
+
};
|
|
183
|
+
}
|
|
184
|
+
render(renderer, draw, reducedMotion, progress, options = {}) {
|
|
185
|
+
const destination = this.ensureTargets(renderer);
|
|
186
|
+
let cache = this.sceneCache;
|
|
187
|
+
if (cache && (cache.destination !== destination || !this.endpointsCurrent(cache) || !Number.isFinite(options.backgroundReveal) || (!cache.ready && options.advanceClock !== false))) {
|
|
188
|
+
this.invalidateSceneEndpoints();
|
|
189
|
+
cache = undefined;
|
|
190
|
+
}
|
|
72
191
|
try {
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
192
|
+
if (!cache) {
|
|
193
|
+
this.writeEpoch++;
|
|
194
|
+
// Every live write invalidates a fence ticket, even when its scene generation did not change.
|
|
195
|
+
renderer.setRenderTarget(this.high);
|
|
196
|
+
draw(true);
|
|
197
|
+
renderer.setRenderTarget(this.low);
|
|
198
|
+
draw(false);
|
|
199
|
+
}
|
|
200
|
+
if (options.advanceClock !== false) {
|
|
201
|
+
const now = performance.now();
|
|
202
|
+
if (this.lastFrame !== undefined)
|
|
203
|
+
this.linearProgress = Math.min(1, this.linearProgress + Math.min(50, now - this.lastFrame) / ASYNC_REVEAL_DURATION);
|
|
204
|
+
this.progress.value = progress ?? easeInOutSine(this.linearProgress);
|
|
205
|
+
this.lastFrame = now;
|
|
206
|
+
if (reducedMotion)
|
|
207
|
+
this.progress.value = 1;
|
|
208
|
+
}
|
|
85
209
|
renderer.setRenderTarget(destination);
|
|
86
210
|
if (!this.overlay)
|
|
87
211
|
renderer.clear();
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
212
|
+
if (cache) {
|
|
213
|
+
cache.background.value = Math.max(0, Math.min(1, options.backgroundReveal));
|
|
214
|
+
cache.refinement.value = this.progress.value;
|
|
215
|
+
cache.quad.render(renderer);
|
|
216
|
+
if (cache.ready)
|
|
217
|
+
this.cacheStats.hits++;
|
|
218
|
+
else
|
|
219
|
+
this.cacheStats.pendingReads++;
|
|
220
|
+
}
|
|
221
|
+
else
|
|
222
|
+
this.quad.render(renderer);
|
|
223
|
+
if (options.advanceClock !== false) {
|
|
224
|
+
this.frames += 1;
|
|
225
|
+
this.complete = this.progress.value === 1;
|
|
226
|
+
}
|
|
91
227
|
}
|
|
92
228
|
finally {
|
|
93
229
|
renderer.setRenderTarget(destination);
|
|
94
230
|
}
|
|
95
231
|
}
|
|
96
232
|
dispose() {
|
|
233
|
+
this.invalidateSceneEndpoints();
|
|
234
|
+
this.writeEpoch++;
|
|
97
235
|
this.low?.dispose();
|
|
98
236
|
this.high?.dispose();
|
|
99
237
|
this.material?.dispose();
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"SpatialElementRefinement.js","sourceRoot":"","sources":["../../src/stage/SpatialElementRefinement.ts"],"names":[],"mappings":"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","sourcesContent":["import * as THREE from 'three/webgpu';\nimport { mix, texture, uniform } from 'three/tsl';\nimport { easeInOutSine, ASYNC_REVEAL_DURATION } from '../catalog/transitionTiming.js';\n\n// Bound temporary attachments independently of viewport size and device pixel ratio.\nconst MAX_REFINEMENT_PIXELS = 512 * 1024;\nexport function getRefinementSize(width: number, height: number) {\n\tconst scale = Math.min(1, Math.sqrt(MAX_REFINEMENT_PIXELS / (width * height)));\n\treturn {\n\t\twidth: Math.max(1, Math.floor(width * scale)),\n\t\theight: Math.max(1, Math.floor(height * scale))\n\t};\n}\n\n/** Separate scene captures preserve authored alpha without sorting two translucent element meshes. */\nexport class SpatialElementRefinement {\n\tgetRenderTargets() {\n\t\treturn [this.low, this.high].filter((target): target is THREE.RenderTarget => Boolean(target));\n\t}\n\tconstructor(private readonly overlay = false) {}\n\tprivate low?: THREE.RenderTarget;\n\tprivate high?: THREE.RenderTarget;\n\tprivate material?: THREE.NodeMaterial;\n\tprivate quad?: THREE.QuadMesh;\n\tprivate readonly progress = uniform(0);\n\tprivate lastFrame?: number;\n\tprivate linearProgress = 0;\n\tcomplete = false;\n\tframes = 0;\n\tget presentedProgress() {\n\t\treturn this.progress.value;\n\t}\n\trestart() {\n\t\tthis.lastFrame = undefined;\n\t\tthis.linearProgress = 0;\n\t\tthis.progress.value = 0;\n\t\tthis.complete = false;\n\t\tthis.frames = 0;\n\t}\n\tget targetCount() {\n\t\treturn Number(Boolean(this.low)) + Number(Boolean(this.high));\n\t}\n\n\trender(\n\t\trenderer: THREE.WebGPURenderer,\n\t\tdraw: (high: boolean) => void,\n\t\treducedMotion: boolean,\n\t\tprogress?: number\n\t) {\n\t\tconst destination = renderer.getRenderTarget();\n\t\tif (!destination && !this.overlay)\n\t\t\tthrow new Error('SpatialElement refinement requires an owned scene capture');\n\t\tconst size = destination ?? renderer.getDrawingBufferSize(new THREE.Vector2());\n\t\tconst targetWidth = size.width;\n\t\tconst targetHeight = size.height;\n\t\tif (!this.low || !this.high) {\n\t\t\tthis.low =\n\t\t\t\tdestination?.clone() ??\n\t\t\t\tnew THREE.RenderTarget(targetWidth, targetHeight, {\n\t\t\t\t\ttype: THREE.HalfFloatType,\n\t\t\t\t\tsamples: 4\n\t\t\t\t});\n\t\t\tthis.high = this.low.clone();\n\t\t\tthis.material = new THREE.NodeMaterial();\n\t\t\tthis.material.fragmentNode = mix(\n\t\t\t\ttexture(this.low.texture),\n\t\t\t\ttexture(this.high.texture),\n\t\t\t\tthis.progress\n\t\t\t);\n\t\t\tthis.material.depthTest = false;\n\t\t\tthis.material.depthWrite = false;\n\t\t\tthis.material.blending = this.overlay ? THREE.NormalBlending : THREE.NoBlending;\n\t\t\tthis.material.transparent = this.overlay;\n\t\t\tthis.material.premultipliedAlpha = this.overlay;\n\t\t\tthis.material.toneMapped = false;\n\t\t\tthis.quad = new THREE.QuadMesh(this.material);\n\t\t}\n\t\tconst { width, height } = getRefinementSize(targetWidth, targetHeight);\n\t\tthis.low.setSize(width, height);\n\t\tthis.high.setSize(width, height);\n\t\ttry {\n\t\t\t// High first: its first actual render must succeed before it becomes visible.\n\t\t\trenderer.setRenderTarget(this.high);\n\t\t\tdraw(true);\n\t\t\trenderer.setRenderTarget(this.low);\n\t\t\tdraw(false);\n\t\t\tconst now = performance.now();\n\t\t\tif (this.lastFrame !== undefined)\n\t\t\t\tthis.linearProgress = Math.min(\n\t\t\t\t\t1,\n\t\t\t\t\tthis.linearProgress + Math.min(50, now - this.lastFrame) / ASYNC_REVEAL_DURATION\n\t\t\t\t);\n\t\t\tthis.progress.value = progress ?? easeInOutSine(this.linearProgress);\n\t\t\tthis.lastFrame = now;\n\t\t\tif (reducedMotion) this.progress.value = 1;\n\t\t\trenderer.setRenderTarget(destination);\n\t\t\tif (!this.overlay) renderer.clear();\n\t\t\tthis.quad!.render(renderer);\n\t\t\tthis.frames += 1;\n\t\t\tthis.complete = this.progress.value === 1;\n\t\t} finally {\n\t\t\trenderer.setRenderTarget(destination);\n\t\t}\n\t}\n\n\tdispose() {\n\t\tthis.low?.dispose();\n\t\tthis.high?.dispose();\n\t\tthis.material?.dispose();\n\t\tthis.low = this.high = undefined;\n\t\tthis.material = undefined;\n\t\tthis.quad = undefined;\n\t}\n}\n"]}
|
|
1
|
+
{"version":3,"file":"SpatialElementRefinement.js","sourceRoot":"","sources":["../../src/stage/SpatialElementRefinement.ts"],"names":[],"mappings":"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","sourcesContent":["import * as THREE from 'three/webgpu';\nimport { mix, texture, uniform } from 'three/tsl';\nimport { easeInOutSine, ASYNC_REVEAL_DURATION } from '../catalog/transitionTiming.js';\n\n// Bound temporary attachments independently of viewport size and device pixel ratio.\nconst MAX_REFINEMENT_PIXELS = 512 * 1024;\nexport function getRefinementSize(width: number, height: number) {\n\tconst scale = Math.min(1, Math.sqrt(MAX_REFINEMENT_PIXELS / (width * height)));\n\treturn {\n\t\twidth: Math.max(1, Math.floor(width * scale)),\n\t\theight: Math.max(1, Math.floor(height * scale))\n\t};\n}\n\nexport interface SceneEndpointGuard {\n\tisValid(): boolean;\n\tdispose(): void;\n}\nexport interface SceneEndpointTicket {\n\tcommit(): boolean;\n\tcancel(): void;\n}\nexport interface RefinementRenderOptions {\n\t/** Hidden preparation/its intervening RAFs borrow pixels without ticking q. */\n\tadvanceClock?: boolean;\n\tbackgroundReveal?: number;\n}\ninterface SceneEndpointCache {\n\tdestination: THREE.RenderTarget;\n\tdestinationWidth: number;\n\tdestinationHeight: number;\n\tzero: [THREE.RenderTarget, THREE.RenderTarget];\n\tmaterial: THREE.NodeMaterial;\n\tquad: THREE.QuadMesh;\n\tcopyMaterial: THREE.NodeMaterial;\n\tcopy: THREE.QuadMesh;\n\tbackground: { value: number };\n\trefinement: { value: number };\n\tguard: SceneEndpointGuard;\n\tepoch: number;\n\tready: boolean;\n}\n\n/** Separate scene captures preserve authored alpha without sorting two translucent element meshes. */\nexport class SpatialElementRefinement {\n\tgetRenderTargets() {\n\t\treturn [this.low, this.high, ...(this.sceneCache?.zero ?? [])].filter((target): target is THREE.RenderTarget => Boolean(target));\n\t}\n\tconstructor(private readonly overlay = false) {}\n\tprivate low?: THREE.RenderTarget;\n\tprivate high?: THREE.RenderTarget;\n\tprivate material?: THREE.NodeMaterial;\n\tprivate quad?: THREE.QuadMesh;\n\tprivate readonly progress = uniform(0);\n\tprivate lastFrame?: number;\n\tprivate linearProgress = 0;\n\tprivate writeEpoch = 0;\n\tprivate sceneCache?: SceneEndpointCache;\n\tprivate readonly cacheStats = { preparations: 0, ready: 0, hits: 0, pendingReads: 0, invalidations: 0, staleTickets: 0 };\n\tgetSceneEndpointStats() { return { ...this.cacheStats, active: Boolean(this.sceneCache?.ready), pending: Boolean(this.sceneCache && !this.sceneCache.ready) }; }\n\tcomplete = false;\n\tframes = 0;\n\tget presentedProgress() {\n\t\treturn this.progress.value;\n\t}\n\trestart() {\n\t\tthis.invalidateSceneEndpoints();\n\t\tthis.lastFrame = undefined;\n\t\tthis.linearProgress = 0;\n\t\tthis.progress.value = 0;\n\t\tthis.complete = false;\n\t\tthis.frames = 0;\n\t}\n\tget targetCount() {\n\t\treturn this.getRenderTargets().length;\n\t}\n\n\tinvalidateSceneEndpoints() {\n\t\tconst cache = this.sceneCache;\n\t\tif (!cache) return;\n\t\tthis.sceneCache = undefined;\n\t\tthis.cacheStats.invalidations++;\n\t\tcache.zero.forEach(target => target.dispose());\n\t\tcache.material.dispose(); cache.copyMaterial.dispose(); cache.guard.dispose();\n\t}\n\n\tprivate ensureTargets(renderer: THREE.WebGPURenderer) {\n\t\tconst destination = renderer.getRenderTarget();\n\t\tif (!destination && !this.overlay) throw new Error('SpatialElement refinement requires an owned scene capture');\n\t\tconst size = destination ?? renderer.getDrawingBufferSize(new THREE.Vector2());\n\t\tif (!this.low || !this.high) {\n\t\t\tthis.low = destination?.clone() ?? new THREE.RenderTarget(size.width, size.height, { type: THREE.HalfFloatType, samples: 4 });\n\t\t\tthis.high = this.low.clone();\n\t\t\tthis.material = this.createCompositeMaterial(mix(texture(this.low.texture), texture(this.high.texture), this.progress));\n\t\t\tthis.quad = new THREE.QuadMesh(this.material);\n\t\t}\n\t\tconst { width, height } = getRefinementSize(size.width, size.height);\n\t\tif (this.low.width !== width || this.low.height !== height || this.high.width !== width || this.high.height !== height) {\n\t\t\tthis.invalidateSceneEndpoints(); this.writeEpoch++;\n\t\t\tthis.low.setSize(width, height); this.high.setSize(width, height);\n\t\t}\n\t\treturn destination;\n\t}\n\tprivate createCompositeMaterial(fragment: THREE.NodeMaterial['fragmentNode']) {\n\t\tconst material = new THREE.NodeMaterial(); material.fragmentNode = fragment;\n\t\tmaterial.depthTest = material.depthWrite = false;\n\t\tmaterial.blending = this.overlay ? THREE.NormalBlending : THREE.NoBlending;\n\t\tmaterial.transparent = material.premultipliedAlpha = this.overlay;\n\t\tmaterial.toneMapped = false;\n\t\treturn material;\n\t}\n\tprivate endpointsCurrent(cache: SceneEndpointCache) {\n\t\treturn cache.epoch === this.writeEpoch && cache.destination.width === cache.destinationWidth && cache.destination.height === cache.destinationHeight &&\n\t\t\tthis.low?.width === cache.zero[0].width && this.low?.height === cache.zero[0].height &&\n\t\t\tthis.high?.width === cache.zero[1].width && this.high?.height === cache.zero[1].height && cache.guard.isValid();\n\t}\n\n\t/** Call only after all warm live passes. Taking endpoints never advances the refinement clock.\n\t * The caller fences these submissions and explicitly commits the returned ticket. */\n\tprepareSceneEndpoints(renderer: THREE.WebGPURenderer, draw: (high: boolean, backgroundReveal: number) => void, guard: SceneEndpointGuard): SceneEndpointTicket | undefined {\n\t\tthis.invalidateSceneEndpoints();\n\t\tlet destination: THREE.RenderTarget | null = renderer.getRenderTarget();\n\t\ttry { destination = this.ensureTargets(renderer); }\n\t\tcatch (error) { guard.dispose(); throw error; }\n\t\tif (!destination || this.low!.texture.type !== THREE.HalfFloatType || !guard.isValid()) { guard.dispose(); return; }\n\t\tconst zero = [0, 1].map(() => {\n\t\t\tconst target = new THREE.RenderTarget(this.low!.width, this.low!.height, { type: THREE.HalfFloatType, samples: 0, depthBuffer: false, stencilBuffer: false });\n\t\t\ttarget.texture.colorSpace = THREE.NoColorSpace; target.texture.generateMipmaps = false;\n\t\t\treturn target;\n\t\t}) as [THREE.RenderTarget, THREE.RenderTarget];\n\t\tconst background = uniform(0), refinement = uniform(0);\n\t\tconst material = this.createCompositeMaterial(mix(mix(texture(zero[0].texture), texture(this.low!.texture), background), mix(texture(zero[1].texture), texture(this.high!.texture), background), refinement));\n\t\tconst source = texture(this.low!.texture);\n\t\tconst copyMaterial = new THREE.NodeMaterial(); copyMaterial.fragmentNode = source;\n\t\tcopyMaterial.depthTest = copyMaterial.depthWrite = false; copyMaterial.blending = THREE.NoBlending; copyMaterial.toneMapped = false;\n\t\tconst cache: SceneEndpointCache = { destination, destinationWidth: destination.width, destinationHeight: destination.height,\n\t\t\tzero, background, refinement, material, quad: new THREE.QuadMesh(material), copyMaterial, copy: new THREE.QuadMesh(copyMaterial), guard, epoch: ++this.writeEpoch, ready: false };\n\t\tthis.sceneCache = cache;\n\t\ttry {\n\t\t\tfor (const p of [0, 1]) for (const high of [true, false]) {\n\t\t\t\tconst target = high ? this.high! : this.low!;\n\t\t\t\trenderer.setRenderTarget(target); draw(high, p);\n\t\t\t\tif (p === 0) { source.value = target.texture; renderer.setRenderTarget(zero[high ? 1 : 0]); cache.copy.render(renderer); }\n\t\t\t}\n\t\t\t// Warm the exact overlay pipeline without touching the actual q uniform/clock.\n\t\t\trenderer.setRenderTarget(destination); background.value = 0.5; refinement.value = this.progress.value;\n\t\t\t// Offscreen rendering reads RenderTarget.scissor, not the Canvas scissor.\n\t\t\t// Preserve the real presentation seed: even a hidden overlay can change it for transmission.\n\t\t\tconst scissor = destination.scissor.clone(), scissorTest = renderer.getScissorTest(), autoClear = renderer.autoClear;\n\t\t\ttry {\n\t\t\t\tdestination.scissor.set(0, 0, 0, 0); renderer.setScissorTest(true); renderer.autoClear = false;\n\t\t\t\tcache.quad.render(renderer);\n\t\t\t} finally { destination.scissor.copy(scissor); renderer.setScissorTest(scissorTest); renderer.autoClear = autoClear; }\n\t\t\tthis.cacheStats.preparations++;\n\t\t} catch (error) { this.invalidateSceneEndpoints(); throw error; }\n\t\tfinally { renderer.setRenderTarget(destination); }\n\t\treturn {\n\t\t\tcommit: () => {\n\t\t\t\tif (this.sceneCache !== cache || !this.endpointsCurrent(cache)) {\n\t\t\t\t\tthis.cacheStats.staleTickets++;\n\t\t\t\t\tif (this.sceneCache === cache) this.invalidateSceneEndpoints();\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t\tif (!cache.ready) { cache.ready = true; this.cacheStats.ready++; }\n\t\t\t\treturn true;\n\t\t\t},\n\t\t\tcancel: () => { if (this.sceneCache === cache) this.invalidateSceneEndpoints(); }\n\t\t};\n\t}\n\n\trender(\n\t\trenderer: THREE.WebGPURenderer,\n\t\tdraw: (high: boolean) => void,\n\t\treducedMotion: boolean,\n\t\tprogress?: number,\n\t\toptions: RefinementRenderOptions = {}\n\t) {\n\t\tconst destination = this.ensureTargets(renderer);\n\t\tlet cache = this.sceneCache;\n\t\tif (cache && (cache.destination !== destination || !this.endpointsCurrent(cache) || !Number.isFinite(options.backgroundReveal) || (!cache.ready && options.advanceClock !== false))) {\n\t\t\tthis.invalidateSceneEndpoints(); cache = undefined;\n\t\t}\n\t\ttry {\n\t\t\tif (!cache) {\n\t\t\t\tthis.writeEpoch++;\n\t\t\t\t// Every live write invalidates a fence ticket, even when its scene generation did not change.\n\t\t\t\trenderer.setRenderTarget(this.high!); draw(true);\n\t\t\t\trenderer.setRenderTarget(this.low!); draw(false);\n\t\t\t}\n\t\t\tif (options.advanceClock !== false) {\n\t\t\t\tconst now = performance.now();\n\t\t\t\tif (this.lastFrame !== undefined) this.linearProgress = Math.min(1, this.linearProgress + Math.min(50, now - this.lastFrame) / ASYNC_REVEAL_DURATION);\n\t\t\t\tthis.progress.value = progress ?? easeInOutSine(this.linearProgress);\n\t\t\t\tthis.lastFrame = now;\n\t\t\t\tif (reducedMotion) this.progress.value = 1;\n\t\t\t}\n\t\t\trenderer.setRenderTarget(destination);\n\t\t\tif (!this.overlay) renderer.clear();\n\t\t\tif (cache) {\n\t\t\t\tcache.background.value = Math.max(0, Math.min(1, options.backgroundReveal!)); cache.refinement.value = this.progress.value;\n\t\t\t\tcache.quad.render(renderer);\n\t\t\t\tif (cache.ready) this.cacheStats.hits++; else this.cacheStats.pendingReads++;\n\t\t\t} else this.quad!.render(renderer);\n\t\t\tif (options.advanceClock !== false) { this.frames += 1; this.complete = this.progress.value === 1; }\n\t\t} finally {\n\t\t\trenderer.setRenderTarget(destination);\n\t\t}\n\t}\n\n\tdispose() {\n\t\tthis.invalidateSceneEndpoints(); this.writeEpoch++;\n\t\tthis.low?.dispose();\n\t\tthis.high?.dispose();\n\t\tthis.material?.dispose();\n\t\tthis.low = this.high = undefined;\n\t\tthis.material = undefined;\n\t\tthis.quad = undefined;\n\t}\n}\n"]}
|
|
@@ -8,6 +8,9 @@ import { type CatalogTransitionPresentation } from '../catalog/catalogPresentati
|
|
|
8
8
|
import type { SpatialListItem } from '../spatial-element/types.js';
|
|
9
9
|
import type { SpatialElementScene } from '../spatial-element/spatialElementScene.js';
|
|
10
10
|
import { type CssProjectionQuad } from './minimap/MinimapProjection.js';
|
|
11
|
+
import type { LayoutRect } from '../spatial-element/responsiveLayout.js';
|
|
12
|
+
import type { StagedDockTargetOptions } from '../catalog/stagedDockGeometry.js';
|
|
13
|
+
import type { SpatialElementMediaItem } from '../spatial-element/types.js';
|
|
11
14
|
import type { BackgroundSettings, StageExperienceOptions, StageInteractionTheme, StagePanelTarget, StageVisualTestView } from './stageTypes.js';
|
|
12
15
|
export type { BackgroundSettings, StageCameraSettings, StageExperienceOptions, StageInteractionTheme, StageMinimapOptions, StageModelSettings, StagePanelSurface, StagePanelTarget, StageRenderSettings, StageVisualTestView, StageViewportTarget, StageZoomFocusState } from './stageTypes.js';
|
|
13
16
|
/** Shared spatial state for both WebGPU glass and DOM-backed panel surfaces. */
|
|
@@ -52,7 +55,25 @@ export declare class StageExperience {
|
|
|
52
55
|
private catalogLayer?;
|
|
53
56
|
private catalogHandoff;
|
|
54
57
|
private catalogMotionComplete;
|
|
58
|
+
private stagedDetailTarget?;
|
|
59
|
+
private stagedAwaitingFirstFrame;
|
|
60
|
+
private stagedSceneCacheOwner?;
|
|
61
|
+
private stagedRevealPreparing?;
|
|
62
|
+
private releaseStagedSensorHold?;
|
|
63
|
+
/** Use only already submitted source resources during the pre-route movement. */
|
|
64
|
+
beginStagedDetailMotion(source: CatalogGeometryEndpoint, fit: LayoutRect, targetOptions?: StagedDockTargetOptions): boolean;
|
|
65
|
+
setStagedDetailProgress(progress: number): void;
|
|
66
|
+
setStagedDetailPanel(card: HTMLElement, corners: CssProjectionQuad, width: number, height: number): boolean;
|
|
67
|
+
setStagedPanelOpacity(opacity: number): void;
|
|
68
|
+
/** Called only after the final moving frame: route teardown may now replace its source. */
|
|
69
|
+
holdStagedDetail(spatialElementId: string, kind?: 'hero' | 'dock'): boolean;
|
|
70
|
+
private deferredZoomPreparation;
|
|
71
|
+
private deferredScrollWarmup?;
|
|
72
|
+
private zoomPreparationFrame;
|
|
55
73
|
private catalogLayerAnimating;
|
|
74
|
+
private stagedPreparationIdle;
|
|
75
|
+
private stagedPreparationFallback;
|
|
76
|
+
private readonly stagedPreparationAbort;
|
|
56
77
|
private catalogPresentation;
|
|
57
78
|
private pageModelReady;
|
|
58
79
|
private readonly preparationGate;
|
|
@@ -146,6 +167,12 @@ export declare class StageExperience {
|
|
|
146
167
|
private panelMeasurementsDirty;
|
|
147
168
|
private viewportMeasurementDirty;
|
|
148
169
|
private stageViewportVisible;
|
|
170
|
+
private readonly readLayoutMetrics?;
|
|
171
|
+
private detailMedia;
|
|
172
|
+
private get detailMediaActive();
|
|
173
|
+
/** Changing media keeps the model/cache/camera but stops its interaction and sensor clock. */
|
|
174
|
+
setDetailMedia(media: SpatialElementMediaItem['kind']): void;
|
|
175
|
+
private readDetailInteractionLayout;
|
|
149
176
|
private fullscreen;
|
|
150
177
|
setFullscreen(fullscreen: boolean): void;
|
|
151
178
|
private get visiblePanelCount();
|
|
@@ -201,7 +228,15 @@ export declare class StageExperience {
|
|
|
201
228
|
}): void;
|
|
202
229
|
updatePage(options: StageExperienceOptions): Promise<void>;
|
|
203
230
|
setCatalogSpatialElements(brandId: string, items: SpatialListItem[]): Promise<void>;
|
|
231
|
+
/** Finish required DETAIL GPU preparation before its first visible reveal frame.
|
|
232
|
+
* Binding happens with enterOpacity=0, which intentionally skips minimaps and
|
|
233
|
+
* panel blur passes. Borrow fractional/end-point alpha to prepare both real
|
|
234
|
+
* material owners, restore all presentation state synchronously, then fence.
|
|
235
|
+
*/
|
|
236
|
+
prepareStagedReveal(signal?: AbortSignal): Promise<boolean>;
|
|
204
237
|
setCatalogTransitionPresentation(state: CatalogTransitionPresentation): void;
|
|
238
|
+
private scheduleZoomPreparation;
|
|
239
|
+
private scheduleStagedPreparation;
|
|
205
240
|
/** Reports actual applied GPU alpha for browser verification without layout or style reads. */
|
|
206
241
|
getCatalogPresentation(): {
|
|
207
242
|
mode: TransitionMode | null;
|
|
@@ -220,8 +255,8 @@ export declare class StageExperience {
|
|
|
220
255
|
disposed: boolean;
|
|
221
256
|
}[];
|
|
222
257
|
preparation: {
|
|
223
|
-
background: "
|
|
224
|
-
high: "unavailable" | "
|
|
258
|
+
background: "ready" | "loading" | "failed";
|
|
259
|
+
high: "unavailable" | "ready" | "loading" | "failed" | "adopted";
|
|
225
260
|
timings: {
|
|
226
261
|
buildMs: number;
|
|
227
262
|
gpuWarmMs: number;
|
|
@@ -243,6 +278,16 @@ export declare class StageExperience {
|
|
|
243
278
|
y: number;
|
|
244
279
|
} | null;
|
|
245
280
|
representations: {
|
|
281
|
+
sceneEndpointCache: {
|
|
282
|
+
active: boolean;
|
|
283
|
+
pending: boolean;
|
|
284
|
+
preparations: number;
|
|
285
|
+
ready: number;
|
|
286
|
+
hits: number;
|
|
287
|
+
pendingReads: number;
|
|
288
|
+
invalidations: number;
|
|
289
|
+
staleTickets: number;
|
|
290
|
+
}[];
|
|
246
291
|
retainedBlendTargets: number;
|
|
247
292
|
state: "unavailable" | "high" | "loading" | "failed" | "decoded" | "refining";
|
|
248
293
|
hero: string | null;
|
|
@@ -291,7 +336,7 @@ export declare class StageExperience {
|
|
|
291
336
|
y: number;
|
|
292
337
|
} | null;
|
|
293
338
|
/** Lease the last submitted element frame before another page binding can release it. */
|
|
294
|
-
adoptCatalogPresentation(destination: CatalogGeometryDestination): boolean;
|
|
339
|
+
adoptCatalogPresentation(destination: CatalogGeometryDestination, restoreSourceOnCancel?: boolean): boolean;
|
|
295
340
|
/** Transfer already prepared hero resources before releasePage/cancelHighRequest can dispose them. */
|
|
296
341
|
captureHeroPresentation(): boolean;
|
|
297
342
|
getSpatialCapture(): {
|
|
@@ -323,7 +368,7 @@ export declare class StageExperience {
|
|
|
323
368
|
disposed: boolean;
|
|
324
369
|
} | null;
|
|
325
370
|
private captureReturnGeometry;
|
|
326
|
-
getDockProjection(): {
|
|
371
|
+
getDockProjection(allowViewportClipping?: boolean): {
|
|
327
372
|
environmentIntensity: number;
|
|
328
373
|
viewportClip?: {
|
|
329
374
|
left: number;
|
|
@@ -381,6 +426,8 @@ export declare class StageExperience {
|
|
|
381
426
|
width: number;
|
|
382
427
|
height: number;
|
|
383
428
|
} | null;
|
|
429
|
+
/** Returns the bound renderer's projection for query-gated handoff regressions. */
|
|
430
|
+
getVisualTestDetailProjection(kind: 'hero' | 'dock'): THREE.Matrix4Tuple | null;
|
|
384
431
|
/** Returns the main element's projected bounds for query-gated layout regressions. */
|
|
385
432
|
getVisualTestModelRect(): {
|
|
386
433
|
x: number;
|
|
@@ -428,6 +475,14 @@ export declare class StageExperience {
|
|
|
428
475
|
detachedInstances: number;
|
|
429
476
|
visible: number;
|
|
430
477
|
passes: number;
|
|
478
|
+
stagedPreparation: {
|
|
479
|
+
preparing: boolean;
|
|
480
|
+
readyActors: number;
|
|
481
|
+
revision: number;
|
|
482
|
+
warmups: number;
|
|
483
|
+
failures: number;
|
|
484
|
+
sourceFrozen: boolean;
|
|
485
|
+
};
|
|
431
486
|
glass: {
|
|
432
487
|
panels: number;
|
|
433
488
|
targets: number;
|
|
@@ -436,6 +491,10 @@ export declare class StageExperience {
|
|
|
436
491
|
};
|
|
437
492
|
ground: {
|
|
438
493
|
silhouettes: number;
|
|
494
|
+
cacheDraws: number;
|
|
495
|
+
liveDraws: number;
|
|
496
|
+
cachePreparations: number;
|
|
497
|
+
cachedSilhouettes: number;
|
|
439
498
|
};
|
|
440
499
|
depthBlur: {
|
|
441
500
|
passes: number;
|
|
@@ -450,6 +509,7 @@ export declare class StageExperience {
|
|
|
450
509
|
};
|
|
451
510
|
actors: {
|
|
452
511
|
spatialElementId: string;
|
|
512
|
+
stagedReady: boolean;
|
|
453
513
|
projectedCenter: THREE.Vector3Tuple;
|
|
454
514
|
band: "front" | "rear" | undefined;
|
|
455
515
|
clip: {
|
|
@@ -476,6 +536,81 @@ export declare class StageExperience {
|
|
|
476
536
|
};
|
|
477
537
|
}[];
|
|
478
538
|
} | null;
|
|
539
|
+
/** Query-gated snapshot: no new frame state, DOM measurements, scheduling or settling. */
|
|
540
|
+
getVisualTestRenderActivity(): {
|
|
541
|
+
at: number;
|
|
542
|
+
lastFrameAt: number;
|
|
543
|
+
animationActive: boolean;
|
|
544
|
+
catalogAnimating: boolean;
|
|
545
|
+
renderInvalidated: boolean;
|
|
546
|
+
pendingRenderFrame: boolean;
|
|
547
|
+
pendingScrollFrame: boolean;
|
|
548
|
+
scrollActive: boolean;
|
|
549
|
+
stagedAwaitingFirstFrame: boolean;
|
|
550
|
+
transitionActive: boolean;
|
|
551
|
+
preparation: {
|
|
552
|
+
stagedIdlePending: boolean;
|
|
553
|
+
zoomFramePending: boolean;
|
|
554
|
+
zoomDeferred: boolean;
|
|
555
|
+
gate: {
|
|
556
|
+
paused: boolean;
|
|
557
|
+
waiting: number;
|
|
558
|
+
};
|
|
559
|
+
detailGate: {
|
|
560
|
+
paused: boolean;
|
|
561
|
+
waiting: number;
|
|
562
|
+
};
|
|
563
|
+
background: "ready" | "loading" | "failed" | null;
|
|
564
|
+
high: "unavailable" | "ready" | "loading" | "failed" | "adopted" | null;
|
|
565
|
+
assetLoads: number;
|
|
566
|
+
activeInstances: number;
|
|
567
|
+
};
|
|
568
|
+
catalog: {
|
|
569
|
+
camera: {
|
|
570
|
+
pivotReady: boolean;
|
|
571
|
+
pivotSettling: boolean;
|
|
572
|
+
neutral: boolean;
|
|
573
|
+
pivot: THREE.Vector3Tuple;
|
|
574
|
+
angles: THREE.Vector3Tuple;
|
|
575
|
+
};
|
|
576
|
+
pointer: {
|
|
577
|
+
x: number;
|
|
578
|
+
y: number;
|
|
579
|
+
active: boolean;
|
|
580
|
+
pressed: boolean;
|
|
581
|
+
};
|
|
582
|
+
layoutDirty: boolean;
|
|
583
|
+
queueDirty: boolean;
|
|
584
|
+
loadingActors: number;
|
|
585
|
+
preparing: boolean;
|
|
586
|
+
warmups: number;
|
|
587
|
+
selected: string | null;
|
|
588
|
+
actors: {
|
|
589
|
+
spatialElementId: string;
|
|
590
|
+
visible: boolean;
|
|
591
|
+
hover: number;
|
|
592
|
+
rotationX: number;
|
|
593
|
+
rotationY: number;
|
|
594
|
+
lift: number;
|
|
595
|
+
deviceYaw: number;
|
|
596
|
+
devicePitch: number;
|
|
597
|
+
deviceRoll: number;
|
|
598
|
+
materialReady: boolean;
|
|
599
|
+
}[];
|
|
600
|
+
} | null;
|
|
601
|
+
panels: {
|
|
602
|
+
index: number;
|
|
603
|
+
frameId: string;
|
|
604
|
+
visible: boolean;
|
|
605
|
+
pointerLift: number;
|
|
606
|
+
rotation: number[];
|
|
607
|
+
position: THREE.Vector3Tuple;
|
|
608
|
+
scale: THREE.Vector3Tuple;
|
|
609
|
+
domMode: "native" | "spatial";
|
|
610
|
+
nativeRestFrames: number;
|
|
611
|
+
nativeSwitchPending: boolean;
|
|
612
|
+
}[];
|
|
613
|
+
};
|
|
479
614
|
/** Returns render-target lifecycle counters for query-gated performance tests. */
|
|
480
615
|
getVisualTestRenderTargetStats(): {
|
|
481
616
|
pixelRatio: number;
|
|
@@ -493,6 +628,34 @@ export declare class StageExperience {
|
|
|
493
628
|
creations: number;
|
|
494
629
|
resizes: number;
|
|
495
630
|
warmups: number;
|
|
631
|
+
inactiveScrollWarmups: number;
|
|
632
|
+
backgroundOutput: {
|
|
633
|
+
held: boolean;
|
|
634
|
+
targetTextureId: string | null;
|
|
635
|
+
implicitBackgroundTarget: boolean | null;
|
|
636
|
+
catalogProfile: string | null;
|
|
637
|
+
catalogProfileCurrent: boolean;
|
|
638
|
+
mode: "explicit" | "fallback" | "disposed";
|
|
639
|
+
generation: number;
|
|
640
|
+
contentsValid: boolean;
|
|
641
|
+
busy: boolean;
|
|
642
|
+
publications: number;
|
|
643
|
+
borrows: number;
|
|
644
|
+
width: number;
|
|
645
|
+
height: number;
|
|
646
|
+
samples: number;
|
|
647
|
+
requested: boolean;
|
|
648
|
+
initialized: boolean;
|
|
649
|
+
} | {
|
|
650
|
+
held: boolean;
|
|
651
|
+
targetTextureId: string | null;
|
|
652
|
+
implicitBackgroundTarget: boolean | null;
|
|
653
|
+
catalogProfile: string | null;
|
|
654
|
+
catalogProfileCurrent: boolean;
|
|
655
|
+
mode: "legacy";
|
|
656
|
+
requested: boolean;
|
|
657
|
+
initialized: boolean;
|
|
658
|
+
};
|
|
496
659
|
activeScale: number;
|
|
497
660
|
liveTargets: number;
|
|
498
661
|
targets: {
|
|
@@ -590,7 +753,6 @@ export declare class StageExperience {
|
|
|
590
753
|
* materialized by these real offscreen/canvas render passes.
|
|
591
754
|
*/
|
|
592
755
|
private updateViewportFrame;
|
|
593
|
-
private getViewportScale;
|
|
594
756
|
private getSpatialElementCameraFitDistance;
|
|
595
757
|
private rememberFittedViewportMetrics;
|
|
596
758
|
private refitCameraForViewport;
|