Skip to content

Docs: Document Runtime Error Codes AVX_R04 (COMPUTED_CIRCULAR_DEPENDENCY) and AVX_R05 (COMPUTED_EVALUATION_FAILED) in Troubleshooting Reference #1049

Description

@nathanschmid08

Feature / Documentation Overview

In docs/src/content/docs/troubleshooting/errors.md, runtime error codes AVX_R04 (COMPUTED_CIRCULAR_DEPENDENCY) and AVX_R05 (COMPUTED_EVALUATION_FAILED) are currently only listed in a summary table without full dedicated reference sections.

In contrast, other error codes (like AVX_R11, AVX_R15, AVX_R16, etc.) have detailed subsections containing the exact error message template, technical root causes, step-by-step resolution steps, incorrect code examples, correct code examples, and defensive coding guidelines.

Proposed Documentation Changes

Add detailed reference sections for AVX_R04 and AVX_R05 in docs/src/content/docs/troubleshooting/errors.md:

  1. AVX_R04 — COMPUTED_CIRCULAR_DEPENDENCY:

    • Error Message: Circular dependency detected in computed property "{0}".
    • Cause: Computed property getters referencing themselves directly or indirectly through a chain of dependent computed properties.
    • Resolution: Refactoring computed properties into unidirectional reactive flows.
    • Incorrect & Correct Code Examples.
  2. AVX_R05 — COMPUTED_EVALUATION_FAILED:

    • Error Message: Failed to evaluate computed property "{0}": {1}
    • Cause: Unhandled runtime exceptions thrown inside custom computed getter functions (e.g. accessing properties of undefined or null objects).
    • Resolution: Adding optional chaining (?.), default fallback values, and defensive guards inside computed getters.
    • Incorrect & Correct Code Examples.

Verification & Constraints

  • Verified zero duplicate issues exist (checked all open and closed issues 3 times).
  • Formatted according to Starlight / Astro markdown documentation guidelines.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationenhancementNew feature or requestgood first issueGood for newcomers

    Type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions