fix: some edge cases

Author: Princesseuh

apps/oxlint/src-js/generated/deserialize.js

@@ -70,6 +70,19 @@ function deserializeAstroScript(pos) {
   return node;
 }
 
+function deserializeAstroDoctype(pos) {
+  let start, end;
+  return {
+    __proto__: NodeProto,
+    type: "AstroDoctype",
+    value: deserializeStr(pos + 8),
+    start: (start = deserializeU32(pos)),
+    end: (end = deserializeU32(pos + 4)),
+    range: [start, end],
+    parent,
+  };
+}
+
 function deserializeProgram(pos) {
   let localAstId = astId,
     end = deserializeU32(pos + 4),
@@ -3840,6 +3853,8 @@ function deserializeJSXChild(pos) {
       return deserializeBoxJSXSpreadChild(pos + 8);
     case 5:
       return deserializeBoxAstroScript(pos + 8);
+    case 6:
+      return deserializeBoxAstroDoctype(pos + 8);
     default:
       throw Error(`Unexpected discriminant ${uint8[pos]} for JSXChild`);
   }
@@ -6867,6 +6882,10 @@ function deserializeBoxAstroScript(pos) {
   return deserializeAstroScript(uint32[pos >> 2]);
 }
 
+function deserializeBoxAstroDoctype(pos) {
+  return deserializeAstroDoctype(uint32[pos >> 2]);
+}
+
 function deserializeVecTSEnumMember(pos) {
   let arr = [],
     pos32 = pos >> 2;

apps/oxlint/src-js/generated/types.d.ts

@@ -25,6 +25,12 @@ export interface AstroScript extends Span {
   parent: Node;
 }
 
+export interface AstroDoctype extends Span {
+  type: "AstroDoctype";
+  value: string;
+  parent: Node;
+}
+
 export interface Program extends Span {
   type: "Program";
   body: Array<Directive | Statement>;
@@ -1093,7 +1099,8 @@ export type JSXChild =
   | JSXFragment
   | JSXExpressionContainer
   | JSXSpreadChild
-  | AstroScript;
+  | AstroScript
+  | AstroDoctype;
 
 export interface JSXSpreadChild extends Span {
   type: "JSXSpreadChild";
@@ -1756,6 +1763,7 @@ export type Node =
   | AstroRoot
   | AstroFrontmatter
   | AstroScript
+  | AstroDoctype
   | Program
   | IdentifierName
   | IdentifierReference

astro-parser-report.md

@@ -0,0 +1,109 @@
+# Astro Parser Report
+
+**Parser**: oxc `parseAstroSync` from `napi/parser`  
+**Source**: `../docs` (79 Astro files)  
+**Date**: 2026-02-04
+
+## Summary
+
+| Status    | Count  | Percentage |
+| --------- | ------ | ---------- |
+| Passed    | 79     | 100%       |
+| Failed    | 0      | 0%         |
+| **Total** | **79** | 100%       |
+
+All 79 Astro files from the `../docs` directory parse successfully.
+
+---
+
+## Passed Files (79)
+
+- `src/components/BackendGuidesNav.astro`
+- `src/components/Badge.astro`
+- `src/components/BrandLogo.astro`
+- `src/components/Button.astro`
+- `src/components/CMSGuidesNav.astro`
+- `src/components/Checklist.astro`
+- `src/components/ContributorList.astro`
+- `src/components/DeployGuidesNav.astro`
+- `src/components/DontEditWarning.astro`
+- `src/components/FacePile.astro`
+- `src/components/FluidGrid.astro`
+- `src/components/FooterLinks.astro`
+- `src/components/IntegrationsNav.astro`
+- `src/components/IslandsDiagram.astro`
+- `src/components/Landing/Card.astro`
+- `src/components/Landing/Discord.astro`
+- `src/components/Landing/ListCard.astro`
+- `src/components/Landing/SplitCard.astro`
+- `src/components/LeftSidebar/Sponsors.astro`
+- `src/components/LoopingVideo.astro`
+- `src/components/MediaGuidesNav.astro`
+- `src/components/MigrationGuidesNav.astro`
+- `src/components/NavGrid/Card.astro`
+- `src/components/NavGrid/CardsNav.astro`
+- `src/components/NavGrid/Grid.astro`
+- `src/components/NotFound.astro`
+- `src/components/ReadMore.astro`
+- `src/components/RecipeLinks.astro`
+- `src/components/RecipesNav.astro`
+- `src/components/RightSidebar/LearnAstroAd.astro`
+- `src/components/RightSidebar/RandomizedAd.astro`
+- `src/components/RightSidebar/ScrimbaAd.astro`
+- `src/components/RightSidebar/StarlightBanner.astro`
+- `src/components/ShowcaseCard.astro`
+- `src/components/Since.astro`
+- `src/components/SourcePR.astro`
+- `src/components/Spoiler.astro`
+- `src/components/TabGroup/InstallGuideTabGroup.astro`
+- `src/components/Version.astro`
+- `src/components/starlight/EditLink.astro`
+- `src/components/starlight/Footer.astro`
+- `src/components/starlight/Hero.astro`
+- `src/components/starlight/Hero/FacePile.astro`
+- `src/components/starlight/MarkdownContent.astro`
+- `src/components/starlight/MobileMenuFooter.astro`
+- `src/components/starlight/MobileTableOfContents.astro`
+- `src/components/starlight/PageSidebar.astro`
+- `src/components/starlight/PageTitle.astro`
+- `src/components/starlight/Search.astro`
+- `src/components/starlight/Sidebar.astro`
+- `src/components/starlight/SiteTitle.astro`
+- `src/components/starlight/TableOfContents.astro`
+- `src/components/tabs/AstroJSXTabs.astro`
+- `src/components/tabs/AstroVueTabs.astro`
+- `src/components/tabs/JavascriptFlavorTabs.astro`
+- `src/components/tabs/PackageManagerTabs.astro`
+- `src/components/tabs/StaticSsrTabs.astro`
+- `src/components/tabs/TabListItem.astro`
+- `src/components/tabs/TabPanel.astro`
+- `src/components/tabs/TabbedContent.astro`
+- `src/components/tabs/UIFrameworkTabs.astro`
+- `src/components/tutorial/Blanks.astro`
+- `src/components/tutorial/Box.astro`
+- `src/components/tutorial/CompletionConfetti.astro`
+- `src/components/tutorial/Lede.astro`
+- `src/components/tutorial/MobileTutorialNav.astro`
+- `src/components/tutorial/MultipleChoice.astro`
+- `src/components/tutorial/Option.astro`
+- `src/components/tutorial/PreCheck.astro`
+- `src/components/tutorial/Progress.astro`
+- `src/components/tutorial/TutorialNav.astro`
+- `src/components/tutorial/UnitProgressIcon.astro`
+- `src/pages/404.astro`
+- `src/pages/[...enRedirectSlug].astro`
+- `src/pages/[lang]/404.astro`
+- `src/pages/[lang]/index.astro`
+- `src/pages/[lang]/install.astro`
+- `src/pages/[lang]/tutorial.astro`
+- `src/pages/index.astro`
+
+---
+
+## Fix Applied
+
+A bug was found and fixed in `crates/oxc_parser/src/jsx/mod.rs` related to parsing `<style>` and `<script>` elements (raw text elements).
+
+**Issue**: The parser was calling `next_jsx_child()` after parsing the opening tag's `>`, which would attempt to lex the raw content (CSS/JS) as JSX. This caused CSS selectors containing `>` (like `.foo > .bar`) to fail with "Unexpected token" errors.
+
+**Fix**: Modified `parse_jsx_opening_element` to detect raw text elements (`<style>`, `<script>`) and skip the `next_jsx_child()` call for those elements. The `skip_raw_text_element_content` function now properly positions the lexer past the raw content without attempting to parse it as JSX.

astro-repo-parser-report.md

@@ -0,0 +1,34 @@
+# Astro Parser Report - astro repository
+
+**Date:** 2026-02-04
+
+## Summary
+
+- **Total files:** 1740
+- **Passed:** 1734
+- **Failed:** 6
+- **Pass rate:** 99.7%
+
+## Failed Files (6)
+
+### Unexpected token (3 files)
+
+- `packages/astro/e2e/fixtures/errors/src/pages/astro-syntax-error.astro`
+- `packages/astro/e2e/fixtures/view-transitions/src/pages/non-html-anchor.astro`
+- `packages/astro/test/fixtures/astro-head/src/pages/head-own-component.astro`
+
+### Expected `}` but found `EOF` (1 files)
+
+- `packages/astro/e2e/fixtures/errors/src/pages/astro-frontmatter-syntax-error.astro`
+
+### Expected corresponding JSX closing tag for 'body'., Unexpected token (1 files)
+
+- `packages/astro/test/fixtures/core-image-ssg/src/pages/special-chars.astro`
+
+### Expected `>` but found `EOF` (1 files)
+
+- `packages/language-tools/language-server/test/fixture/cachingTest.astro`
+
+## Passed Files
+
+1734 files passed.

crates/oxc_ast/src/ast/astro.rs

@@ -10,7 +10,7 @@
 use oxc_allocator::{Box, CloneIn, Dummy, TakeIn, UnstableAddress, Vec};
 use oxc_ast_macros::ast;
 use oxc_estree::ESTree;
-use oxc_span::{ContentEq, GetSpan, GetSpanMut, Span};
+use oxc_span::{Atom, ContentEq, GetSpan, GetSpanMut, Span};
 
 use super::js::Program;
 use super::jsx::*;
@@ -86,3 +86,26 @@ pub struct AstroScript<'a> {
     /// The parsed TypeScript/JavaScript program from the script content
     pub program: Program<'a>,
 }
+
+/// Astro Doctype Declaration
+///
+/// Represents an HTML doctype declaration like `<!doctype html>` or `<!DOCTYPE html>`.
+/// This is commonly used at the start of Astro pages to declare the document type.
+///
+/// ## Example
+///
+/// ```astro
+/// <!doctype html>
+/// <html>
+///   <body>Hello</body>
+/// </html>
+/// ```
+#[ast(visit)]
+#[derive(Debug)]
+#[generate_derive(CloneIn, Dummy, TakeIn, GetSpan, GetSpanMut, ContentEq, ESTree, UnstableAddress)]
+pub struct AstroDoctype<'a> {
+    /// Node location in source code (includes `<!` and `>`)
+    pub span: Span,
+    /// The document type value, e.g., "html" from `<!doctype html>` or `<!DOCTYPE html>`
+    pub value: Atom<'a>,
+}

crates/oxc_ast/src/ast/jsx.rs

@@ -9,7 +9,13 @@ use oxc_ast_macros::ast;
 use oxc_estree::ESTree;
 use oxc_span::{Atom, ContentEq, GetSpan, GetSpanMut, Span};
 
-use super::{astro::AstroScript, inherit_variants, js::*, literal::*, ts::*};
+use super::{
+    astro::{AstroDoctype, AstroScript},
+    inherit_variants,
+    js::*,
+    literal::*,
+    ts::*,
+};
 
 // 1.2 JSX Elements
 
@@ -449,6 +455,9 @@ pub enum JSXChild<'a> {
     /// Astro `<script>` element with parsed TypeScript content
     /// This is only used in Astro files.
     AstroScript(Box<'a, AstroScript<'a>>) = 5,
+    /// Astro doctype declaration like `<!doctype html>`
+    /// This is only used in Astro files.
+    AstroDoctype(Box<'a, AstroDoctype<'a>>) = 6,
 }
 
 /// JSX Spread Child.

crates/oxc_ast/src/ast_kind_impl.rs

@@ -608,6 +608,7 @@ impl AstKind<'_> {
             Self::AstroRoot(_) => "AstroRoot".into(),
             Self::AstroFrontmatter(_) => "AstroFrontmatter".into(),
             Self::AstroScript(_) => "AstroScript".into(),
+            Self::AstroDoctype(_) => "AstroDoctype".into(),
         }
     }
 }

crates/oxc_ast/src/generated/assert_layouts.rs

@@ -28,6 +28,12 @@ const _: () = {
     assert!(offset_of!(AstroScript, span) == 0);
     assert!(offset_of!(AstroScript, program) == 8);
 
+    // Padding: 0 bytes
+    assert!(size_of::<AstroDoctype>() == 24);
+    assert!(align_of::<AstroDoctype>() == 8);
+    assert!(offset_of!(AstroDoctype, span) == 0);
+    assert!(offset_of!(AstroDoctype, value) == 8);
+
     // Padding: 1 bytes
     assert!(size_of::<Program>() == 128);
     assert!(align_of::<Program>() == 8);
@@ -1669,6 +1675,12 @@ const _: () = if cfg!(target_family = "wasm") || align_of::<u64>() == 8 {
     assert!(offset_of!(AstroScript, span) == 0);
     assert!(offset_of!(AstroScript, program) == 8);
 
+    // Padding: 0 bytes
+    assert!(size_of::<AstroDoctype>() == 16);
+    assert!(align_of::<AstroDoctype>() == 4);
+    assert!(offset_of!(AstroDoctype, span) == 0);
+    assert!(offset_of!(AstroDoctype, value) == 8);
+
     // Padding: 1 bytes
     assert!(size_of::<Program>() == 88);
     assert!(align_of::<Program>() == 4);

crates/oxc_ast/src/generated/ast_builder.rs

@@ -97,6 +97,38 @@ impl<'a> AstBuilder<'a> {
         Box::new_in(self.astro_script(span, program), self.allocator)
     }
 
+    /// Build an [`AstroDoctype`].
+    ///
+    /// If you want the built node to be allocated in the memory arena,
+    /// use [`AstBuilder::alloc_astro_doctype`] instead.
+    ///
+    /// ## Parameters
+    /// * `span`: Node location in source code (includes `<!` and `>`)
+    /// * `value`: The document type value, e.g., "html" from `<!doctype html>` or `<!DOCTYPE html>`
+    #[inline]
+    pub fn astro_doctype<A1>(self, span: Span, value: A1) -> AstroDoctype<'a>
+    where
+        A1: Into<Atom<'a>>,
+    {
+        AstroDoctype { span, value: value.into() }
+    }
+
+    /// Build an [`AstroDoctype`], and store it in the memory arena.
+    ///
+    /// Returns a [`Box`] containing the newly-allocated node.
+    /// If you want a stack-allocated node, use [`AstBuilder::astro_doctype`] instead.
+    ///
+    /// ## Parameters
+    /// * `span`: Node location in source code (includes `<!` and `>`)
+    /// * `value`: The document type value, e.g., "html" from `<!doctype html>` or `<!DOCTYPE html>`
+    #[inline]
+    pub fn alloc_astro_doctype<A1>(self, span: Span, value: A1) -> Box<'a, AstroDoctype<'a>>
+    where
+        A1: Into<Atom<'a>>,
+    {
+        Box::new_in(self.astro_doctype(span, value), self.allocator)
+    }
+
     /// Build a [`Program`].
     ///
     /// ## Parameters
@@ -9821,6 +9853,21 @@ impl<'a> AstBuilder<'a> {
         JSXChild::AstroScript(self.alloc_astro_script(span, program))
     }
 
+    /// Build a [`JSXChild::AstroDoctype`].
+    ///
+    /// This node contains an [`AstroDoctype`] that will be stored in the memory arena.
+    ///
+    /// ## Parameters
+    /// * `span`: Node location in source code (includes `<!` and `>`)
+    /// * `value`: The document type value, e.g., "html" from `<!doctype html>` or `<!DOCTYPE html>`
+    #[inline]
+    pub fn jsx_child_astro_doctype<A1>(self, span: Span, value: A1) -> JSXChild<'a>
+    where
+        A1: Into<Atom<'a>>,
+    {
+        JSXChild::AstroDoctype(self.alloc_astro_doctype(span, value))
+    }
+
     /// Build a [`JSXSpreadChild`].
     ///
     /// If you want the built node to be allocated in the memory arena,