PulseTrade.Comm.Spa.Dynamic.Ptcs.Client 0.1.148

PulseTrade.Comm.Spa.Dynamic.Ptcs.Client

Pure WebSharper F# client adapter for the PTCS same-session transient channel.

Boundary

• Connects only to the current origin /sync/ws; callers cannot inject an upstream URL or credential.
• Sends extension-transient frames and consumes ta-browser.v1..v5 payloads；v4 reconstructs legacy TemporalPoint values，v5保留shared axis/position-keyed scalar series與five-component candle refs。
• Projects bounded, non-recursive browser wire data into RuntimeState and renders through PulseTrade.Comm.Spa.Dynamic.Renderer；document editor catalog與row binding option一併投影，任一malformed schema使整份state fail closed。
• Projects server query metadata into TaWorkspaceDocument.DefaultView；browser不再自行發明TXF/5m/date defaults。
• Does not own PTCS authentication, ACL, SQL, market-data access, persistence, or the canonical reducer.

API

TaResearchTransientClient.mountById
    "app"
    "ta-research"
    "workspace-main"
    "canvas-main"

需要由host page控制active/dispose時使用：

let handle =
    TaResearchTransientClient.mountByIdWithOptionsAndDisplayTimeZone
        "app"
        "ta-research"
        "workspace-main"
        "canvas-main"
        TaClientLifecycle.defaults
        displayTimeZone.View

handle.SetActive false
handle.SetActive true
handle.RequestJsonExport()
handle.Dispose()

client lifecycle保證one-in-flight action/poll、timeout/backoff、bounded reconnect、full snapshot resync與terminal dispose。Renderer可在query pending期間只保留最新queued query，但client transport仍一次只送一筆；server-side validation rejection是CommandRejected，不會關閉仍健康的WebSocket。client只使用same-origin WebSocket，不做HTTP polling。

TA durable reply只保存compact layout/query descriptor，不含OHLCV或indicator arrays。RequestJsonExport會要求authoritative full wire，browser下載yyyyMMddHHmmss-<GUID>.json，其中含timeline、OHLCV、indicator series、query/provider metadata與revision。collapsed reply平時仍為zero-resource；明確點下載時使用requestJsonExportOnce建立bounded headless channel，完成後立即dispose。

The PTCS host must register the same extensionId with PulseTrade.Comm.Spa.Dynamic.Ptcs.TaResearchTransientServer.register.

Tagging editor Plug-In

TaggingEditorPlugin is a transport-neutral PTCS Dynamic SDUI editor for a SpaceId + TargetKind + TargetId target. The host supplies a TaggingEditorBinding.Dispatch callback; the Plug-In does not open HTTP or WebSocket connections and does not know LINE, K-bar, indicator, SQL, account, or credential semantics.

let handle = TaggingEditorPlugin.mount host TaggingEditorPlugin.defaultOptions
handle.Open binding

Desktop hosts get independent draggable editor cards. Mobile hosts get a single active bottom sheet with tabs for all open targets. The primary title is always the complete TargetId; ContextLabel is secondary text only.

Each editor card owns exactly one target and displays every ExtraInfo for that target at the same time. An ExtraInfo contains its own tag set, summary, and time-frame list. Each ExtraInfo has independent save/delete actions, and the target header also provides a bounded sequential "save all" action. Adding an ExtraInfo appends another complete editor block; it never replaces the currently visible blocks. The Plug-In has no "save and continue" navigation state.

Current owner candidate is PulseTrade.Comm.Spa.Dynamic.Ptcs.Client 0.1.104, consuming PTCS [0.2.46]、Contracts [0.1.33] and Renderer [0.1.103]。本版帶入navigator live outer SVG event／geometry authority修正；RFC-0032 loaded coverage、cache atomicity、display-time與既有mount APIs不變。Source commit 651ecc5的NuGet.org artifact已驗證；真SPAA consumer通過前不宣稱產品驗收。

Current owner candidate is PulseTrade.Comm.Spa.Dynamic.Ptcs.Client 0.1.121, consuming PTCS [0.2.46]、Contracts [0.1.35] and Renderer [0.1.121]。本版帶入loaded-domain View All；PTCS mount/action API與wire shape不變。Official readback與真SPAA pending。