Expand description
Vue Vet-owned diagnostics, spans, edits, and reactivity fact contracts.
Parser adapters and the reactivity tracer produce these types; rules, reporters, cache, and the CLI consume them. Vize and Oxc AST types never appear in this crate.
Modules: [diagnostics], [facts], [rule], plus identity/edits/source helpers.
Structs§
- Assessment
- Vue Vet-owned migration assessment record (JSON v1 additive).
- Assessment
Check - One named check inside an
Assessment. - Attached
Effect Scope Fact - Proven detached child scope that joins parent pause with valid stop ownership.
- Byte
Range - Cached
Result Demand Fact - Cached memoize / controlled-computed result fails a later native demand.
- Cancelled
Filter Promise Demand Fact - Default-debounce cancellation fulfills the earlier promise with
undefined. - Conditional
Watch Source Fact - Proven array-source watch that keeps an idle computed producer live.
- Custom
RefLost Notification Fact - Closed-local customRef whose primitive slot cannot notify a proven consumer.
- Define
Expose Fact defineExpose({ name })keys in setup.- Derivation
Practice Facts - Closed derivation-practice opportunities collected beside source contracts.
- Detached
Effect Scope Without Stop Fact - Detached
effectScope(true)that created a live watcher and was discarded. - Diagnostic
- Edit
Plan - Evidence
Gap - Counted evidence gap suitable for machine consumers.
- Evidence
Summary - Evidence status and its deterministic gap list.
- Extracted
Reactive Collection Method Fact - Bare call of a method extracted from a proven reactive Map/Set/array.
- Fact
Kinds - Interest set for the single facts pass (oxlint
NODE_TYPESanalogue). - FileId
- Stable workspace-relative identity for one analyzed source file.
- Finding
Explain - Domain payload for explaining one concrete finding.
- Ignorable
Async Ignore Window Fact - Post-await source write after a proven synchronous
ignoreUpdateswindow. - Inactive
Scope Result Fact effectScope().stop()thenscope.runwhose result is used as an object.- Inject
Same Instance Demand Fact - Same-setup
providedoes not supplyinject; the fallback fails a native demand. - Instance
Member Demand Fact - Native member demand through a template-ref instance chain.
- Instance
Path Write Fact - Write through a template-ref instance chain that changes a primitive path.
- Invalid
Custom RefInterface Fact customReffactory missing/noncallablegetorsetplus a demanded.value.- Json
Clone Lossy Type Fact - Default JSON
useClonedoutput is a string, then a Date method is demanded. - Keyed
MapDependency Fact - Reactive
Map.forEachselecting one literal string key inside computed /watchEffect. - Late
Cancellation Guard Fact - A cancellation flag is registered after source-dependent suspension, so an earlier invalidation can still write this run’s result.
- Late
Scope Dispose Fact onScopeDisposeafterawaitin a proven asynceffectScope().runcallback.- Late
Watcher Cleanup Fact onWatcherCleanupafter a proven await or deferred callback.- Lazy
Computed Async Fact - Proven eager
computedAsyncwhose startup work is superseded before first demand. - Line
Index - Precomputed line starts for one source buffer.
- Memo
Blocked RefDemand Fact - Proven after-tick demand of a memo-blocked conditional template ref.
- Missing
ToRefs KeyFact toRefsof a closed reactive object, then a missing key is dereferenced.- Model
Default Fact - Child
defineModeldefault producer. - Model
Demand File Facts - Per-file joined model-demand findings (project → file rules).
- Model
Value Write Fact - Child model assignment that would emit (
model.value = changed). - Module
Id - Stable identity for one JavaScript/TypeScript module surface.
- Mounted
Member Demand Fact - Unguarded native member demand inside a proven
onMountedcallback. - Nested
Watch Without Cleanup Fact - Inner watcher created by a repeating outer callback with a discarded stop handle.
- Notification
Bypass Fact - Ordinary
RefInit Fact - Ordinary
ref/shallowRefinitializer in setup. - Orphaned
Scope Watcher Fact - Watcher created after
awaitinside a proveneffectScope().runcallback whose stop handle is unused. - Physical
Path - Physical filesystem location used only at discovery and I/O boundaries.
- PreFlush
Template RefDemand Fact - Proven pre-flush demand of a still-null conditional template ref.
- Queued
Watch Flush Fact - Proven
flush: 'sync'watch whose sink is only observed afternextTick. - RawProxy
MapKey Fact - Native
Mapstores one of a raw/proxy pair and latergets the other. - Reactive
Binding Fact - Reactive
Dependency Edge - Reactive
Guard Fact - Reactive
Private Field Access Fact - Native private-field access through a Vue reactive proxy receiver.
- Reactive
Read Fact - Reactive
Source View Fact - Reactive
Write Fact - Reactivity
Effect Fact - Legacy projection of effect-family tracking scopes.
- Reactivity
Graph - Reactivity
Lifetime Facts - Domain facts for watcher/effect-scope lifetime contracts.
- Recommendation
- Optional ecosystem API recommendation attached to a finding (JSON v1 additive).
- RefHistory
Snapshot Alias Fact - Identity history snapshot aliased by a later in-place nested write.
- Returned
Watcher Cleanup Fact - A watcher callback that returns a function Vue will not register as cleanup.
- Rule
Context - Rule
Environment - Per-file analysis capabilities derived from the nearest
package.json. - Rule
Explain - Domain payload for explaining one rule. Reporters only render this model.
- Rule
Group Descriptor - Canonical group identity for inventory JSON.
- Rule
Inventory - Versioned inventory document. Independent of project configuration.
- Rule
Inventory Counts - Counts taken from the composed inventory (after optional group filter).
- Rule
Inventory Row - One composed-registry row for
--list-rules. - Rule
Meta - Rule
Registry - Scan
Summary - Scheduling
Practice Facts - Closed scheduling-practice opportunities collected beside source contracts.
- Scope
Explain - Static explanation of what a tracking scope depends on (and what it does not).
- Scope
Explain Dep - One dependency line in a
ScopeExplain. - Script
Binding Fact - Script
Block Facts - Script
Call Fact - Script
Destructure Fact - Script
Facts - Script
Import Fact - Script
Member Write Fact - Script
Operand Fact - Identifier used as an operand where a ref object’s object-identity is almost
certainly a mistake (arithmetic / comparison / unary), not a
.valueread. - SfcFacts
- Shared
Composable First Instance Args Fact - Later shared-state demand that the first initializer cannot satisfy.
- Shared
Default Cross Instance Demand Fact - Joined finding: sibling instance demand after a shared-default write.
- Shared
Object Binding Fact - Module-owned object used as a shared default identity.
- Source
Context - One source buffer with a precomputed
LineIndex. - Source
Contract Facts - Proven Vue API contract sites collected from Oxc semantics.
- Source
Contract Site Fact - One call/argument site with a proven contract failure.
- Source
Span - Byte offset plus derived line/column. Four
usizes; pass by copy. - Stable
Computed Identity Fact - Proven computed identity churn with an established identity consumer.
- Sync
RefOne WayFact - Proven default two-way
syncRefwhose right side is a closed sink. - Template
Allocation Fact - Parent / memo / condition / ref relations for one template element.
- Template
Attribute Fact - Template
Condition Relation - Innermost
v-if/v-else-ifthat allocates this node. - Template
Directive Fact - Template
Element Fact - Template
Expression Fact - One template expression surface that may read script bindings.
- Template
Facts - Template
Memo Relation - Innermost
v-memothat caches this node’s subtree. - Template
Reactive Read Fact - Template
RefDemand Facts - Joined template-ref demand facts for one script block.
- Text
Edit - ToRef
Ignored KeyFact - Proven
toRef(source, key)overload that ignores a static key. - Tracking
Scope Fact - Unsynced
Model Parent Demand Fact - Joined finding: parent demand before the child default initializes it.
- Until
Timeout Unmatched Demand Fact until(ref).toBe(expected, { timeout })fulfills the unmatched source value.- VueVersion
- Watch
Callback Contract Fact - Proven watch-callback contract failure (once/immediate discard or root identity).
- Watch
Cleanup Current Source Fact - Per-run
EventTargetacquisition/release identity mismatch. - Watch
Ignored Option Fact - One ignored
watch/watch*Effectoptions property. - Watch
Replaced Object Source Fact watch(objectMember)plus a later same-identity property replacement.- Watch
Signature Mismatch Fact - One watch-family argument in the wrong slot.
- Workspace
Root - Physical root that defines the namespace for
FileIdvalues.
Enums§
- Cache
Rejection - Why a cache lookup could not reuse persisted work.
- Confidence
- Convertible
- Can this component be converted to Vapor at all?
- Custom
RefCapability - Demanded
customReffactory capability. - Custom
RefLost Notification Reason - Missing
trackin get versus missingtriggerin set. One rule ID. - Edit
Applicability - Edit
Plan Error - Evidence
GapCode - Stable reason code for a bounded evidence gap.
- Evidence
Status - Coverage level for the facts that support a scan result.
- FactRef
- One fact in the single pass over Vue Vet-owned surfaces (not dependency AST).
- Inject
Same Instance Demand Reason - Why a same-instance provide/inject pair fails a later capability demand.
- Late
Cancellation Guard Kind - Why a run-local cancellation guard still leaves an invalidation window.
- Late
Watcher Cleanup Kind - Why
onWatcherCleanuplost the active watcher. - Model
Default Origin - How a
defineModeldefault is produced. - Model
Primitive Kind - Proven primitive kind for a model default or ref initializer.
- Notification
Bypass Kind - OptIn
- Opt-in source of a Vapor migration assessment.
- Primitive
Value Kind - Proven primitive kind retained by a cache entry or later source write.
- Reactive
Binding Kind - Reactive
Dependency Kind - Reactive
Guard Role - Reactive
Read Kind - Reactive
View Kind - RefInit
Kind - Current ordinary-ref initializer kind (not a Vue API result).
- Rule
Group Id - Canonical product groups for inventory and scan selection.
- Scope
Track Reason - Why a scope tracks (or does not track) a dependency — multi-consumer contract.
- Script
Kind - Severity
- Stable
Computed Identity Reason - Why a computed result is a measured identity-stability opportunity.
- ToRef
Ignored KeyReason - Runtime
toRefbranch that discards the key argument. - Tracking
Scope Kind - Verdict
- Assessment check / aggregate verdict.
- Watch
Callback Contract Reason - Why a watch callback is proven useless for later value-dependent work.
- Watch
Cleanup Current Source Kind - Why watcher cleanup targeted the live source instead of the acquired receiver.
- Watch
Ignored Option Reason - Why a watch-family options key is ignored by Vue 3.5.
- Watch
Signature Mismatch Reason - Why a watch-family argument is the wrong slot.
- Watcher
ApiKind - Vue watcher API whose callback/cleanup contract is shared across aliases.
Constants§
- MIGRATION_
CATEGORY - Category for opt-in migration assessment (excluded from score and CI exit).
- PRACTICE_
CATEGORY - Category for ecosystem / best-practice suggestions (excluded from score and CI exit).
- REACTIVITY_
GRAPH_ VERSION - Wire format version for
ReactivityGraph. Bump when consumers must distinguish shape or semantic changes in serialized facts. - RULE_
INVENTORY_ KIND - RULE_
INVENTORY_ SCHEMA_ VERSION
Traits§
- Rule
- Built-in rule contract (oxlint-style pass hooks over stable facts).
Functions§
- content_
digest - Hex-encoded SHA-256 digest of raw bytes.
- density_
score - Maps severity weights to a 0–100 score by finding density, not absolute count.
- diagnostic_
id - Builds the stable, opaque identity used by machine-readable report consumers.
- finding_
id - Stable finding identity using the diagnostic’s normalized
FileId. - qualify_
dependency_ to_ id - Build a span-qualified dependency identity, optionally module-prefixed (graph v8).
- serde_
digest - Hex-encoded SHA-256 digest of a JSON-stable serde serialization.