Merge branch 'main' into improve-effect-reference

Author: kodiakhq[bot]

README.md

@@ -1,4 +1,7 @@
-# Solid Docs
+<p>
+  <img src="https://assets.solidjs.com/banner?project=Solid%20Documentation&type=core" alt="Solid Documentation" />
+</p>
+
 
 Welcome to Solid's documentation!
 

package.json

@@ -31,7 +31,7 @@
 		"glob": "^11.0.3",
 		"gray-matter": "^4.0.3",
 		"postcss": "^8.5.6",
-		"shiki": "^3.13.0",
+		"shiki": "^3.14.0",
 		"sitemap": "^8.0.0",
 		"solid-heroicons": "^3.2.4",
 		"solid-js": "^1.9.9",
@@ -44,15 +44,15 @@
 		"@kobalte/tailwindcss": "^0.9.0",
 		"@orama/crawly": "^0.0.6",
 		"@tailwindcss/typography": "^0.5.19",
-		"@types/node": "^24.7.0",
+		"@types/node": "^24.9.1",
 		"@typescript-eslint/eslint-plugin": "^8.46.1",
-		"@typescript-eslint/parser": "^8.46.1",
+		"@typescript-eslint/parser": "^8.46.2",
 		"autoprefixer": "^10.4.21",
 		"eslint": "^9.37.0",
 		"eslint-plugin-solid": "^0.14.5",
 		"globals": "^16.4.0",
 		"prettier": "3.6.2",
-		"prettier-plugin-tailwindcss": "^0.6.14",
+		"prettier-plugin-tailwindcss": "^0.7.1",
 		"tailwindcss": "^3.4.17",
 		"typescript": "^5.9.3",
 		"typescript-eslint": "^8.46.2",

pnpm-lock.yaml

@@ -1,5 +1,16 @@
 ---
 title: Fine-grained reactivity
+use_cases: >-
+  understanding core reactivity, performance optimization, building reactive
+  systems from scratch, learning framework internals
+tags:
+  - reactivity
+  - signals
+  - effects
+  - performance
+  - fundamentals
+  - reactive-primitives
+version: '1.0'
 ---
 
 Reactivity ensures automatic responses to data changes, eliminating the need for manual updates to the user interface (UI).

src/routes/advanced-concepts/fine-grained-reactivity.mdx

@@ -1,6 +1,17 @@
 ---
 title: Basics
 order: 4
+use_cases: >-
+  always, first component creation, learning component structure, understanding
+  lifecycle, component organization
+tags:
+  - components
+  - jsx
+  - lifecycle
+  - fundamentals
+  - always
+  - component-tree
+version: '1.0'
 ---
 
 Components are the building blocks of Solid applications.

src/routes/concepts/components/basics.mdx

@@ -1,6 +1,17 @@
 ---
 title: Class and style
 order: 2
+use_cases: >-
+  styling components, dynamic styling, theming, conditional css classes, inline
+  styles
+tags:
+  - styling
+  - css
+  - classes
+  - dynamic-styling
+  - theming
+  - conditional-rendering
+version: '1.0'
 ---
 
 Similar to HTML, Solid uses `class` and `style` attributes to style elements via [CSS (Cascading Style Sheets)](https://developer.mozilla.org/en-US/docs/Glossary/CSS).

src/routes/concepts/components/class-style.mdx

@@ -1,6 +1,17 @@
 ---
 title: Event handlers
 order: 3
+use_cases: >-
+  user interactions, click handlers, form events, custom events, event
+  delegation optimization
+tags:
+  - events
+  - user-interaction
+  - forms
+  - event-delegation
+  - performance
+  - handlers
+version: '1.0'
 ---
 
 Event handlers are functions that are called in response to specific events occurring in the browser, such as when a user clicks or taps on an element.

src/routes/concepts/components/event-handlers.mdx

@@ -1,5 +1,16 @@
 ---
 title: Props
+use_cases: >-
+  passing data between components, component communication, reusable components,
+  parent-child data flow
+tags:
+  - props
+  - component-communication
+  - data-flow
+  - reusability
+  - merge-props
+  - split-props
+version: '1.0'
 ---
 
 Props are a way to pass state from a parent component to a child component.

src/routes/concepts/components/props.mdx

@@ -1,6 +1,17 @@
 ---
-title: "Context"
+title: Context
 order: 5
+use_cases: >-
+  avoiding prop drilling, global state, theme management, authentication state,
+  deeply nested components
+tags:
+  - context
+  - global-state
+  - prop-drilling
+  - state-management
+  - provider-pattern
+  - theming
+version: '1.0'
 ---
 
 Context provides a way to pass data through the component tree without having to pass props down manually at every level.

src/routes/concepts/context.mdx

@@ -1,6 +1,17 @@
 ---
-title: "Conditional rendering"
+title: Conditional rendering
 order: 1
+use_cases: >-
+  showing hiding content, loading states, error states, user permissions,
+  dynamic ui
+tags:
+  - conditional-rendering
+  - loading-states
+  - error-handling
+  - dynamic-ui
+  - show
+  - switch-match
+version: '1.0'
 ---
 
 Conditional rendering is the process of displaying different UI elements based on certain conditions.