pluginruntime

type ActivationPolicy string

type AssetEntry struct {
	Key    string
	Status string
	Bytes  int64
}

type AssetService interface {
	GetAssetSnapshot(QueryBudget) (AssetSnapshot, error)
	RefreshAssets(CommandOptions) error
}

type AssetSnapshot struct {
	Meta    SnapshotMeta
	Entries []AssetEntry
}

type BackendID string

type BootstrapOptions struct {
	Registrations     []PluginRegistration
	Services          []ServiceRegistration
	DisabledPluginIDs []string
}

type CaptureService interface {
	GetCaptureSnapshot(QueryBudget) (CaptureSnapshot, error)
}

type CaptureSnapshot struct {
	Meta     SnapshotMeta
	Sessions []string
}

type CleanupFunc func() error

type CommandOptions struct {
	Reason string
}

type Context interface {
	ResolveService(ServiceKey) (any, bool)
	RegisterContribution(ContributionRegistration) error
	RegisterCleanup(CleanupFunc)
	KernelInfo() KernelInfo
}

type ContributionKind string

type ContributionMetadata struct {
	ID               string
	Kind             ContributionKind
	ExecutionClass   ExecutionClass
	ActivationPolicy ActivationPolicy
	Order            int
}

type ContributionRegistration struct {
	Metadata ContributionMetadata
	Value    any
}

type DOMNodeSnapshot struct {
	ID         string
	Tag        string
	Text       string
	Attributes map[string]string
	Children   []DOMNodeSnapshot
}

type DOMService interface {
	GetDOMSnapshot(QueryBudget) (DOMSnapshot, error)
	HighlightNode(string, CommandOptions) error
	ScrollNodeIntoView(string, CommandOptions) error
}

type DOMSnapshot struct {
	Meta SnapshotMeta
	Root *DOMNodeSnapshot
}

type DevtoolsAction struct {
	Label        string
	MatchCodes   []string
	MatchSources []string
	Run          func(DevtoolsActionContext) error
}

type DevtoolsActionContext struct {
	Issue DevtoolsIssue
}

type DevtoolsActionProvider interface {
	GetDevtoolsActions() ([]DevtoolsAction, error)
}

type DevtoolsActionProviderFunc func() ([]DevtoolsAction, error)

type DevtoolsIssue struct {
	Source   string
	Code     string
	Message  string
	Path     string
	Docs     string
	TopFrame string
}

type DevtoolsSection struct {
	Name    string
	Summary map[string]string
	Lines   []string
}

type DevtoolsSectionProvider interface {
	GetDevtoolsSections() ([]DevtoolsSection, error)
}

type DevtoolsSectionProviderFunc func() ([]DevtoolsSection, error)

type DiagnosticsService interface {
	GetDiagnosticsSnapshot(QueryBudget) (DiagnosticsSnapshot, error)
}

type DiagnosticsSnapshot struct {
	Meta             SnapshotMeta
	Runtime          []RuntimeDiagnostic
	PluginReports    []HealthReport
	PluginEvents     []PluginDiagnostic
	KernelAPIVersion string
}

type EventRecord struct {
	Type       string
	Phase      string
	Target     string
	Current    string
	OccurredAt time.Time
}

type EventService interface {
	GetEventSnapshot(QueryBudget) (EventSnapshot, error)
}

type EventSnapshot struct {
	Meta   SnapshotMeta
	Events []EventRecord
}

type ExecutionClass string

type FetchCacheEntry struct {
	Key             string
	Loading         bool
	Ready           bool
	Stale           bool
	LastError       string
	UpdatedAt       time.Time
	LastLoaded      time.Time
	SubscriberCount int
	OwnerPaths      []string
	ResumePolicy    string
}

type FetchService interface {
	GetFetchSnapshot(QueryBudget) (FetchSnapshot, error)
	ClearFetchEntry(string, CommandOptions) error
	RevalidateFetchEntry(string, CommandOptions) error
}

type FetchSnapshot struct {
	Meta    SnapshotMeta
	Entries []FetchCacheEntry
}

type Handle interface {
	StopPlugin() error
}

type HealthReason string

type HealthReport struct {
	PluginID   string
	State      HealthState
	Reason     HealthReason
	Message    string
	ErrorCount int
	UpdatedAt  time.Time
}

type HealthState string

type Kernel struct {
	// contains filtered or unexported fields
}

type KernelInfo struct {
	APIVersion string
}

type Manifest struct {
	ID               string
	Version          string
	Description      string
	RequiredServices []ServiceKey
	OptionalServices []ServiceKey
	ActivationPolicy ActivationPolicy
}

type Plugin interface {
	Manifest() Manifest
	StartPlugin(Context) (Handle, error)
}

type PluginDiagnostic struct {
	PluginID  string
	Operation string
	Reason    HealthReason
	Message   string
	When      time.Time
	Report    diagnostics.Report
}

type PluginFactory func() Plugin

type PluginManifestOverride struct {
	ID               string
	Version          string
	Description      string
	RequiredServices []ServiceKey
	OptionalServices []ServiceKey
	ActivationPolicy ActivationPolicy
}

type PluginRegistration struct {
	Manifest PluginManifestOverride
	Factory  PluginFactory
}

type QueryBudget struct {
	MaxItems int
}

type RouteLoaderEntry struct {
	Key     string
	Path    string
	Pending bool
	HasData bool
	Error   string
}

type RouteMetadata struct {
	Title        string
	Description  string
	CanonicalURL string
}

type RouteRedirect struct {
	Cause string
	From  string
	To    string
}

type RouteService interface {
	GetRouteSnapshot(QueryBudget) (RouteSnapshot, error)
	NavigateRoute(string, CommandOptions) error
	RevalidateRoute(CommandOptions) error
	RetryRouteLoader(string, CommandOptions) error
}

type RouteSnapshot struct {
	Meta         SnapshotMeta
	Path         string
	Query        map[string][]string
	Params       map[string]string
	Loading      bool
	Stack        []RouteStackEntry
	Loaders      []RouteLoaderEntry
	LastRedirect RouteRedirect
	Metadata     RouteMetadata
}

type RouteStackEntry struct {
	ID             string
	Path           string
	Params         map[string]string
	HasLoader      bool
	HasBeforeEnter bool
	HasBeforeLeave bool
	Metadata       RouteMetadata
}

type Runtime2Diagnostic struct {
	RegionInstanceID string
	Type             string
	Text             string
	TransportTier    string
	ShardID          string
	FallbackDomain   string
	FallbackReason   string
	DowngradePath    string
	DowngradeReason  string
	QueueNs          uint64
	RenderNs         uint64
	SnapshotBytes    uint64
	PatchBytes       uint64
}

type Runtime2MetaService interface {
	GetRuntime2MetaSnapshot(QueryBudget) (Runtime2MetaSnapshot, error)
}

type Runtime2MetaSnapshot struct {
	Meta         SnapshotMeta
	Capabilities map[string]bool
	Regions      []Runtime2RegionSnapshot
	Diagnostics  []Runtime2Diagnostic
}

type Runtime2RegionSnapshot struct {
	RegionInstanceID            string
	RegionMode                  string
	AssignedWorkerShard         string
	RendererID                  string
	Epoch                       uint64
	IsHydrationComplete         bool
	HasHydratedShellAnchor      bool
	HasPostHydrationAttached    bool
	LastSnapshotVersion         uint64
	LastDispatchedVersion       uint64
	LastCommittedVersion        uint64
	TransportTier               string
	HasSnapshotDowngrade        bool
	SnapshotDowngradePath       string
	SnapshotDowngradeReason     string
	HasPatchDowngrade           bool
	PatchDowngradePath          string
	PatchDowngradeReason        string
	DroppedStalePatchCount      uint64
	IgnoredStaleDiagnosticCount uint64
	RepairTriggeredRemountCount uint64
	FallbackReason              string
	DispatchToPatchReadyNs      uint64
	DispatchToCommitNs          uint64
	PatchReadyToCommitNs        uint64
	DiagnosticCount             int
}

type RuntimeBranch struct {
	Name              string
	Kind              string
	Path              string
	RenderDurationNs  int64
	DiffDurationNs    int64
	CommitDurationNs  int64
	EffectDurationNs  int64
	CleanupDurationNs int64
	SelfDurationNs    int64
	SubtreeDurationNs int64
}

type RuntimeComponentRenderTrace struct {
	Name                    string
	Path                    string
	RenderCount             int
	RerenderCount           int
	LastTrigger             string
	LastRenderDurationNs    int64
	TotalRenderDurationNs   int64
	AverageRenderDurationNs int64
	LastRenderedAt          string
	TriggerCounts           map[string]int
}

type RuntimeDiagnostic struct {
	Source         string
	Severity       string
	Classification string
	Code           string
	Docs           string
	Remediation    string
	Recoverable    bool
	TopFrame       string
	Consequence    string
	Message        string
	Count          int
	Path           string
	ComponentStack []string
	Fields         map[string]string
}

type RuntimeFlamegraphFrame struct {
	Name              string
	Kind              string
	Path              string
	Depth             int
	StartNs           int64
	DurationNs        int64
	SelfDurationNs    int64
	RenderDurationNs  int64
	DiffDurationNs    int64
	CommitDurationNs  int64
	EffectDurationNs  int64
	CleanupDurationNs int64
}

type RuntimeHook struct {
	Slot         int
	Kind         string
	Value        string
	Dependencies string
	Status       string
}

type RuntimeHydration struct {
	CorrelationID        string
	StartedAt            string
	FinishedAt           string
	DurationNs           int64
	ExistingDOMNodeCount int
	FallbackCount        int
	MismatchCount        int
	DiscardedNodeCount   int
	Strict               bool
	Failed               bool
	Failure              string
	RecentMessages       []string
}

type RuntimeInspectionService interface {
	GetRuntimeSnapshot(QueryBudget) (RuntimeSnapshot, error)
}

type RuntimeLog struct {
	Domain         string
	Level          string
	Classification string
	Code           string
	Docs           string
	Remediation    string
	Recoverable    bool
	TopFrame       string
	Consequence    string
	Message        string
	Timestamp      string
	CorrelationID  string
	Fields         map[string]string
}

type RuntimeNode struct {
	Name              string
	Path              string
	Kind              string
	Dirty             bool
	NeedsUpdate       bool
	FineGrained       bool
	ReactiveSource    string
	UpdateOrigin      string
	EffectCount       int
	HookCount         int
	Signature         string
	RenderDurationNs  int64
	DiffDurationNs    int64
	CommitDurationNs  int64
	EffectDurationNs  int64
	CleanupDurationNs int64
	SelfDurationNs    int64
	SubtreeDurationNs int64
	Hooks             []RuntimeHook
	Children          []RuntimeNode
}

type RuntimeProfiling struct {
	RenderCalls                      int
	ScheduledRootUpdates             int
	ScheduledFiberMarks              int
	ScheduledGranularMarks           int
	WorkLoopPasses                   int
	ProcessedUnits                   int
	CommitCount                      int
	FineGrainedCommits               int
	FineGrainedDescendantHostCommits int
	FineGrainedDescendantTextCommits int
	EffectExecutions                 int
	CleanupExecutions                int
	LastRenderDurationNs             int64
	LastCommitDurationNs             int64
	LastEffectDurationNs             int64
	LastCleanupDurationNs            int64
	PhaseTotals                      RuntimeProfilingPhaseTotals
	ComponentRenders                 []RuntimeComponentRenderTrace
	RecentEvents                     []RuntimeProfilingEvent
	FlamegraphFrames                 []RuntimeFlamegraphFrame
	Startup                          RuntimeStartupProfiling
	HotBranches                      []RuntimeBranch
}

type RuntimeProfilingEvent struct {
	Domain        string
	Name          string
	Phase         string
	Target        string
	CorrelationID string
	DurationNs    int64
	Timestamp     string
	Fields        map[string]string
}

type RuntimeProfilingPhaseTotals struct {
	RenderDurationNs  int64
	DiffDurationNs    int64
	CommitDurationNs  int64
	EffectDurationNs  int64
	CleanupDurationNs int64
}

type RuntimeRouteStartupBudget struct {
	RouteFamily                       string
	LastRoutePath                     string
	SampleCount                       int
	AverageBootstrapReadDurationNs    int64
	AverageWASMTransferBytes          int64
	AverageWASMDecodedBytes           int64
	AverageBootstrapDecodedBytes      int64
	AverageCacheWarmupDurationNs      int64
	AverageServiceWorkerOverheadNs    int64
	AverageInitialRouteDataBytes      int64
	AverageHydrationDurationNs        int64
	AverageStartupCommitDurationNs    int64
	AverageFirstInteractionDurationNs int64
}

type RuntimeSnapshot struct {
	Meta        SnapshotMeta
	Root        *RuntimeNode
	Stats       RuntimeStats
	Profiling   RuntimeProfiling
	Hydration   RuntimeHydration
	Diagnostics []RuntimeDiagnostic
	Logs        []RuntimeLog
}

type RuntimeStartupProfiling struct {
	Mode                       string
	StartedAt                  string
	BootstrapReadDurationNs    int64
	WASMTransferBytes          int64
	WASMDecodedBytes           int64
	BootstrapDecodedBytes      int64
	CacheWarmupDurationNs      int64
	ServiceWorkerOverheadNs    int64
	InitialRouteDataBytes      int64
	HydrationDurationNs        int64
	StartupCommitDurationNs    int64
	FirstInteractionDurationNs int64
	FirstInteractionCaptured   bool
	FirstInteractionEvent      string
	RouteBudgets               []RuntimeRouteStartupBudget
}

type RuntimeStats struct {
	TotalFibers       int
	DirtyFibers       int
	ComponentFibers   int
	HostFibers        int
	TextFibers        int
	FineGrainedFibers int
	HookEntries       int
	Effects           int
}

type SecurityFinding struct {
	Code     string
	Message  string
	Severity string
}

type SecurityService interface {
	GetSecuritySnapshot(QueryBudget) (SecuritySnapshot, error)
}

type SecuritySnapshot struct {
	Meta     SnapshotMeta
	Findings []SecurityFinding
}

type ServiceKey string

type ServiceRegistration struct {
	Key   ServiceKey
	Value any
}

type SnapshotMeta struct {
	BackendID string
	Truncated bool
}

type StylePatchHandle interface {
	RemoveStylePatch() error
}

type StyleService interface {
	GetStyleSnapshot(QueryBudget) (StyleSnapshot, error)
	ApplyStyleVariables(map[string]string, CommandOptions) (StylePatchHandle, error)
}

type StyleSnapshot struct {
	Meta       SnapshotMeta
	Variables  map[string]string
	Stylesheet []string
}

type SubscriptionHandle struct {
	// contains filtered or unexported fields
}