PulseTrade.Comm.Spa.Dynamic.Renderer 0.1.76

PulseTrade.Comm.Spa.Dynamic.Renderer

基於PulseTrade.Comm.Spa.Dynamic.Contracts的pure WebSharper F# TA workspace renderer。

Responsibility

• owns：DOM/SVG chart layout、bounded local viewport、row visibility、compact query/Add Row UI、typed action callback。
• does not own：PTCS、WebSocket、SQL、market-data provider、credential、ACL或authorization。
• local-only：pan、zoom、row toggle、Reset View。
• remote typed action：Change Query、Add Row、Remove Row、Reset Canvas；每個row以toggle + 固定寬度remove control呈現，remote command in-flight時remove同樣disabled。
• shared research view：同一visible index驅動各row crosshair/cursor values；transport timestamp壓成MM-dd HH:mm，OHLC detail可換行，時間標籤在SVG外以HTML grid呈現，避免mobile非等比縮放文字。
• status：保留freshness、watermark、quality與recoverable last-good error；remote in-flight只禁用remote submit，不凍結local view。cache rehydrate進入PausedForResync時仍允許local pan/zoom/hover/cursor，但不送VisibleRangeChanged或SharedCursorChanged，直到authoritative resync完成。
• query draft：只從TaWorkspaceDocument.DefaultView的query.* metadata初始化；document revision不變的poll不覆蓋使用者輸入，metadata缺失時保持空白，禁止回退到demo symbol/interval/date。
• Apply boundary：instrument/interval/range只更新local draft；選擇interval不送action、不改authoritative query、不重render。按Load / Apply送ChangeTaQuery；accepted後依merged base/reference temporal axis選[FromUtc, ToUtcExclusive) local window，不改authoritative data/revision或清cache。pending期間的新query取代queue中的舊intent，transport仍維持one-in-flight。
• loaded range：shared-axis working set可保留最多4000 positions；overview以bounded bucket呈現全range，左右handle可resize，中段可move，48/200/All可切換。drag只更新draft，pointer release/change才commit一次render，local navigation不送server action；All模式把完整working set壓縮成bounded SVG primitives觀察長趨勢。
• Add/Edit Row：由TaWorkspaceDocument.EditorSchemas生成generic Text/Integer/Decimal/Boolean/Choice/Scale/List/Group表單；同template可建立多個參數實例。帶ptcs.dynamic.editor.binding.v1的row可預填並以stable RowId重新設定；legacy無binding row保持read-only。editor draft不會被poll覆蓋。
• Reset Canvas：送remote typed action恢復mount時initial ordered rows/query；Reset View只恢復local viewport。
• timeline：各trace依timestamp對齊reference timeline；SMA/ADX/MACD warm-up縮短不會用array index錯位或造成sequence failure。
• temporal projection：TemporalPoint明確指定source interval與projection；coarse K棒用CandleSpan跨base slots，coarse line用RepeatAcrossBaseBuckets，只在close後可知的indicator用StepAfterClose，避免look-ahead。
• shared temporal data：temporal-axis.v1提供唯一sparse Position/time authority，temporal-series.v1以Position join。Renderer不依scale推算缺失點；同一K的preview revision原位替換。candlestick可由TaCandleDataRefs指定的O/H/L/C/V五條scalar series合成。
• multi-candle：同一row可同時畫1K/5K等多個candlestick traces；base candle維持實心，coarse candle以trace色outline/dashed wick呈現並保留source interval metadata。
• generic marker：TaTraceKind.Marker以同row的candlestick trace作target；Position是唯一空間authority，EventTime只進tooltip。marker不參與reference timeline、Y autoscale或cursor value；每個visible bucket依stable wire order直接畫前4筆，其餘以keyboard-accessible +N cluster逐筆檢視完整label/tooltip。empty bucket可清除marker。非空Label另以viewport-aware SVG text呈現；相鄰文字區間使用deterministic collision lane，row邊界不足時反向展開。
• overview stripe：TaTraceKind.OverviewStripe以canonical event time定位navigator X；同trace同X合併成單一full-height線與count，同X不同trace依collision group/layer order分固定lane。paths按trace批次，hover lookup bounded；stripe不參與close sampling、Y-domain或K-bar plot pointer ownership。
• row resize：每列separator支援pointer、Arrow 8px、Shift+Arrow 32px、Home／double-click reset。override只以CanvasInstanceId + RowId保存在active renderer；同canvas revision/scenario replacement保留，reload／unmount／canvas identity替換清除。candlestick/composite範圍180..720px，scalar範圍96..480px；marker presence不再改row baseline。
• row-local data window：每列從自身resolved datapoint同時取得timestamp與value；candlestick固定顯示O/H/L/C/V，line/histogram顯示value。shared cursor頂端為兩行yyyy-MM-dd／HH:mm:ss；missing或invalid timestamp明示Unavailable，不借用base row。
• row composition：同一immutable DataRef可同時出現在overlay row與一或多個separate rows；Renderer逐row獨立解析與呈現，不依DataRef合併row。overlay/分列完全由owner提供的Rows/Traces決定。
• cursor/style：K棒、line point與cross-row cursor共用slot-center幾何；indicator line width為1.25，histogram維持1.0。
• event-time interaction：BaseRowId的真實timestamp驅動shared cursor；coarse row只使用finalized containing/as-of point，否則missing。viewport release送半開event-time range，pending期間controls不可重入。
• plot surface theme：consumer以TaPlotSurfacePresentationCodec.apply在DefaultView選Light／Dark；Renderer用同一palette繪製candle、TA、overview、grid、cursor、axis、legend與tooltip。未指定維持Light，不讀browser preference或consumer CSS作authority。
• histogram polarity：consumer以TaHistogramTraceOptionsCodec.apply設定正／負色；Renderer依value符號產生兩個batched paths。未指定則兩色皆沿用TaTraceSpec.Color，不從trace name／label推論MACD或交易語意。

API

TaWorkspaceRenderer.render
    TaWorkspaceRenderer.defaultOptions
    callbacks
    runtimeState

TaWorkspaceRenderer.renderWithProjectionCommit
    TaWorkspaceRenderer.defaultOptions
    callbacks
    (fun committedState -> publishReceipt committedState)
    runtimeState

render維持相容；需要browser completion contract的host使用renderWithProjectionCommit。callback只在current generation的full mount或same-topology visible-row refresh完成，並跨下一個animation-frame boundary後觸發；stale、superseded、current-state mismatch與相同tuple重複候選不觸發。runtimeState是Var<RuntimeState>；host adapter負責strict frame decode/reducer與更新Var。正式runtime從current document讀editor catalog；TaRendererOptions.EditorSchemas只作standalone/test fallback。callbacks.SubmitAction接收含RequestId/revision的DynamicActionRequest並回DynamicActionResult；Add使用ApplyTemplate(None, ...)，Edit使用ApplyTemplate(Some rowId, ...)，不提供arbitrary URL、SQL或raw credential。

Verification

• exact-package model/dependency/source tests：tests/PulseTrade.Comm.Spa.Dynamic.Renderer.Tests。
• exact-package live bundle：tests/PulseTrade.Comm.Spa.Dynamic.Renderer.BrowserDemo。
• desktop/mobile F# Playwright：scripts/verify-ta-generic-marker-playwright.fsx。
• current public release：PulseTrade.Comm.Spa.Dynamic.Renderer 0.1.70，exact依賴Contracts [0.1.28]與FSharp.Core [10.1.400]；0.1.69已作廢。K-bar row的Y-domain只取current viewport projected candles與same-row projected lines，並把自SVG edge起算的上下15 CSS px反算成viewBox/data padding，row resize不放大留白。所有chart row的authored/default plot height封頂250 CSS px，但manual candle/scalar resize仍可到720/480px；reset/reload回capped default。一般line／SMA寬度夾在1–2 CSS px並使用non-scaling-stroke；overview左右可見邊界ta-overview-left/right-handle-visual各為2 CSS px #155f73線，既有ta-overview-left/right-handle維持transparent drag rect。0.1.39曾出現同版號不同bytes，禁止採用。Renderer保留Backtest Presentation UX的same-topology navigator refresh，並以document/data/transport diagnostics區分render原因；chunked transport只在完整candidate commit後進入Renderer。Marker使用bounded SVG overlay、document trace order → bucket order的跨trace deterministic shape lanes、viewport-aware visible label與collision lanes；TriangleUp／TriangleDown方向不受anchor改寫，Outline使用fill="none"且保留完整pointer hit target。marker不進數值圖例、Y-domain或額外time slot；tooltip與shared cursor可在同一pointer interaction共存。row-local cursor timestamp使用SVG外固定32px gutter及固定CSS-pixel兩行tag；row resize只改plot height與tag位置，不縮放tag字型、padding、border或尺寸。line reader採indexed projection；大型candle projection以固定bucket array單次聚合first-open／last-close／high／low／volume，不建立per-slot tuple/groupBy，八種candle paths由single-pass buckets產生；source/Y-domain/cursor語意不變。同topology資料patch會更新shell prepared-data signal及navigator stripe，不重掛chart stack。mousemove經單一requestAnimationFrame直接更新固定crosshair、row timestamp與value DOM；shared cursor覆蓋current row完整SVG高度，不延伸到其他row或SVG外toolbar。

RFC-0028 local candidate為Renderer 0.1.74、Contracts [0.1.29]、Interactive.Client 0.1.65。它包含RFC-0027 typed dark plot／Histogram polarity，並以DefaultView.visibleBars初始化fresh canvas；plot marker只保留glyph/tooltip，每列在cursor gutter與plot間提供固定24px OFI band，最多4筆＋+N。Consumer測試須讀glyph的data-marker-slot後將real pointer移至chart slot；直接hover glyph不是shared-cursor contract。Overview selection為淺灰，visual boundaries為亮綠2 CSS px且不改transparent hit targets。此graph尚待Daedalus真SPAA GREEN，未取代上述public release。

RFC-0017之後，cache rehydrate即使保留current identity/revision，只要validated Data object替換仍會重畫。row legend以rowId + local trace index隔離；All模式保留完整scale/cursor arrays，但以bounded candle/line paths呈現。non-base candle cursor使用一次range projection，不再對每個base timestamp掃描完整source。

RFC-0018之後，accepted ChangeTaQuery在host frames已合併後選local viewport。invalid/no-intersection/stale query保留原window並顯示feedback；local selection不送第二個range action。中間Renderer 0.1.34不可使用，因其callback concurrency與正式client one-in-flight不一致。

RFC-0019/0020之後，每列依自身event-time與plot width產生adaptive axis，crosshair只覆蓋該列plot。loaded coverage可大於visible cap；越過boundary時以VisibleRangeChanged要求document query範圍內的相鄰coverage，merge後依event-time anchor重定位。Renderer prepare與row mount/refresh使用generation-aware frame scheduling；consumer仍負責provider query、source merge與cache authority。