Diagnostics Module
Constructors for `ControlDiagnostic` values reported by the controls runtime and validation passes.
Functions and values
| Function or value |
Description
|
Full Usage:
catalogOmission controlId requiredField
Parameters:
string
requiredField : string
Returns: ControlDiagnostic
|
Reports that the catalog entry for `controlId` omits a `requiredField`.
|
Full Usage:
create controlId kind code severity message
Parameters:
ControlId option
kind : ControlKind
code : ControlDiagnosticCode
severity : ControlDiagnosticSeverity
message : string
Returns: ControlDiagnostic
|
Builds a `ControlDiagnostic` from an explicit `code`, `severity`, and `message`, optionally scoped to a `controlId` and `kind`.
|
Full Usage:
customExtension kind extensionName
Parameters:
string
extensionName : string
Returns: ControlDiagnostic
|
Reports that a control `kind` declares a non-standard `extensionName` outside the standard contract.
|
Full Usage:
dependencyLeak packageId dependencyPath
Parameters:
string
dependencyPath : string
Returns: ControlDiagnostic
|
Reports that `packageId` exposes a transitive `dependencyPath` that should not leak across the package boundary.
|
Full Usage:
duplicateAttribute controlId kind name
Parameters:
ControlId option
kind : ControlKind
name : string
Returns: ControlDiagnostic
|
Reports that attribute `name` was supplied more than once on a control of `kind`.
|
Full Usage:
duplicateRuntimeDefinition runtimeName path
Parameters:
string
path : string
Returns: ControlDiagnostic
|
Reports that `runtimeName` is defined more than once, the duplicate residing at `path`.
|
Full Usage:
keyCollision key kind
Parameters:
ControlId
kind : ControlKind
Returns: ControlDiagnostic
|
Reports that the same `key` identifies two sibling controls, a `ControlId` collision.
|
Full Usage:
missingAccessibility controlId kind
Parameters:
ControlId option
kind : ControlKind
Returns: ControlDiagnostic
|
Reports that a control of `kind` lacks the accessibility metadata it requires.
|
Full Usage:
missingRequired controlId kind name
Parameters:
ControlId option
kind : ControlKind
name : string
Returns: ControlDiagnostic
|
Reports that a control of `kind` is missing a required attribute `name`.
|
Full Usage:
missingStandardAttribute kind name
Parameters:
StandardControlKind
name : StandardAttributeName
Returns: ControlDiagnostic
|
Reports that standard control `kind` omits a required standard attribute `name`.
|
Full Usage:
stabilityReport first second
Parameters: Returns: ControlDiagnostic list
Type parameters: 'msg |
Feature 113 (Phase 5) — the stability-diagnostic report (report-only, NOT an enforced gate). Given TWO builds of the SAME logical control (sub)tree (`first`/`second` — the same model run through `View` twice), walk them in parallel and return one `UnstableReuseInput` finding per attribute/event that compared UNEQUAL despite no semantic change: a rebuilt `UntypedValue`, a per-frame event closure (reference-fresh each build), or an unstable key. Each finding names the control (`ControlId` + `ControlKind`) and the offending attribute/event name. An empty list ⇒ the tree's inputs are stable across builds (the case memoization can exploit). Stable structural values (`TextValue`, `StringListValue`, …) and reference-shared event handlers do not flag. Pure, total, deterministic; never compares a function with `=` (uses reference identity for closures).
|
Full Usage:
staleEventTarget controlId eventKind
Parameters:
ControlId
eventKind : string
Returns: ControlDiagnostic
|
Reports that an `eventKind` binding targets a `controlId` that no longer exists in the tree.
|
Full Usage:
stalePackageReference packageId path
Parameters:
string
path : string
Returns: ControlDiagnostic
|
Reports a `packageId` reference at `path` that no longer resolves to a current package.
|
Full Usage:
unsupportedEnvironment kind capability
Parameters:
ControlKind
capability : string
Returns: ControlDiagnostic
|
Reports that a control of `kind` requested a `capability` the host environment does not support.
|
Full Usage:
unsupportedScopeExpansion scopeName owner
Parameters:
string
owner : string
Returns: ControlDiagnostic
|
Reports that `scopeName` owned by `owner` cannot be expanded as requested.
|
Full Usage:
unsupportedStandardAttribute kind name
Parameters:
StandardControlKind
name : StandardAttributeName
Returns: ControlDiagnostic
|
Reports that standard control `kind` does not support the standard attribute `name`.
|
Full Usage:
unsupportedStandardEvent kind eventKind
Parameters:
StandardControlKind
eventKind : StandardEventKind
Returns: ControlDiagnostic
|
Reports that standard control `kind` does not raise the standard event `eventKind`.
|